nushell-plugins/nu_plugin_orchestrator/quick-reference.md

Orchestrator Plugin Quick Reference\n\nVersion: 0.1.0\nBinary: target/release/nu_plugin_orchestrator (7.6M)\n\n---\n\n## Installation\n\nbash\nplugin add target/release/nu_plugin_orchestrator\nplugin list | where name == nu_plugin_orchestrator\n\n\n---\n\n## Commands\n\n### 1. Status Check\n\nnushell\norch status # Default data dir\norch status --data-dir /custom/path # Custom location\norch status | to json # JSON output\n\n\nReturns: {running, tasks_pending, tasks_running, tasks_completed, last_check, data_dir}\n\n---\n\n### 2. Workflow Validation\n\nnushell\norch validate workflow.k # Basic validation\norch validate workflow.k --strict # Strict mode (checks required fields)\n\n\nReturns: {valid, errors, warnings}\n\n---\n\n### 3. Task Queue\n\nnushell\norch tasks # All tasks\norch tasks --status pending # Filter by status\norch tasks --limit 10 # Limit results\norch tasks --status running --limit 5 # Combined filters\n\n\nReturns: [{id, status, priority, created_at, workflow_id}]\n\n---\n\n## Common Patterns\n\n### Check if Orchestrator Running\n\nnushell\nif (orch status | get running) { "✓ Running" } else { "✗ Stopped" }\n\n\n### Validate Before Submit\n\nnushell\nlet valid = (orch validate workflow.k | get valid)\nif $valid { "✓ Valid" } else { "✗ Invalid" }\n\n\n### Count Tasks by Status\n\nnushell\norch tasks | group-by status | each { |k,v| {status: $k, count: ($v | length)} }\n\n\n### Find High Priority Tasks\n\nnushell\norch tasks | where priority > 7 | select id priority\n\n\n---\n\n## Environment\n\nbash\nexport ORCHESTRATOR_DATA_DIR=/custom/path/to/data\n\n\n---\n\n## Data Structure\n\nplaintext\nprovisioning/platform/orchestrator/data/\n├── status.json # {running, tasks_*, last_check}\n└── tasks/\n ├── task-001.json # {id, status, created_at, priority, workflow_id}\n └── ...\n\n\n---\n\n## Performance\n\n| Operation | Latency | Notes |\n|-----------|---------|-------|\n| orch status | ~1ms | Single file read |\n| orch tasks | ~10ms | 1000 tasks |\n| orch validate | ~50-100ms | KCL subprocess |\n\n5-10x faster than HTTP for read operations\n\n---\n\n## See Also\n\n- Usage Examples: USAGE_EXAMPLES.md\n- Implementation: IMPLEMENTATION_SUMMARY.md\n- Architecture: /.claude/features/orchestrator-architecture.md