Jesús Pérez d9ef2f0d5b
Some checks failed
Build and Test / Validate Setup (push) Has been cancelled
Build and Test / Build (darwin-amd64) (push) Has been cancelled
Build and Test / Build (darwin-arm64) (push) Has been cancelled
Build and Test / Build (linux-amd64) (push) Has been cancelled
Build and Test / Build (windows-amd64) (push) Has been cancelled
Build and Test / Build (linux-arm64) (push) Has been cancelled
Build and Test / Security Audit (push) Has been cancelled
Build and Test / Package Results (push) Has been cancelled
Build and Test / Quality Gate (push) Has been cancelled
Nightly Build / Check for Changes (push) Has been cancelled
Nightly Build / Validate Setup (push) Has been cancelled
Nightly Build / Nightly Build (darwin-amd64) (push) Has been cancelled
Nightly Build / Nightly Build (darwin-arm64) (push) Has been cancelled
Nightly Build / Nightly Build (linux-amd64) (push) Has been cancelled
Nightly Build / Nightly Build (windows-amd64) (push) Has been cancelled
Nightly Build / Nightly Build (linux-arm64) (push) Has been cancelled
Nightly Build / Create Nightly Pre-release (push) Has been cancelled
Nightly Build / Notify Build Status (push) Has been cancelled
Nightly Build / Nightly Maintenance (push) Has been cancelled
chore: update all plugins to Nushell 0.111.0
- Bump all 18 plugins from 0.110.0 to 0.111.0
  - Update rust-toolchain.toml channel to 1.93.1 (nu 0.111.0 requires ≥1.91.1)

  Fixes:
  - interprocess pin =2.2.x → ^2.3.1 in nu_plugin_mcp, nu_plugin_nats, nu_plugin_typedialog
    (required by nu-plugin-core 0.111.0)
  - nu_plugin_typedialog: BackendType::Web initializer — add open_browser: false field
  - nu_plugin_auth: implement missing user_info_to_value helper referenced in tests

  Scripts:
  - update_all_plugins.nu: fix [package].version update on minor bumps; add [dev-dependencies]
    pass; add nu-plugin-test-support to managed crates
  - download_nushell.nu: rustup override unset before rm -rf on nushell dir replace;
    fix unclosed ) in string interpolation
2026-03-11 03:22:42 +00:00

1 line
2.5 KiB
Markdown

# Orchestrator Plugin Quick Reference\n\n**Version**: 0.1.0\n**Binary**: `target/release/nu_plugin_orchestrator` (7.6M)\n\n---\n\n## Installation\n\n```bash\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\n```nushell\norch status # Default data dir\norch status --data-dir /custom/path # Custom location\norch status | to json # JSON output\n```\n\n**Returns**: `{running, tasks_pending, tasks_running, tasks_completed, last_check, data_dir}`\n\n---\n\n### 2. Workflow Validation\n\n```nushell\norch validate workflow.k # Basic validation\norch validate workflow.k --strict # Strict mode (checks required fields)\n```\n\n**Returns**: `{valid, errors, warnings}`\n\n---\n\n### 3. Task Queue\n\n```nushell\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\n**Returns**: `[{id, status, priority, created_at, workflow_id}]`\n\n---\n\n## Common Patterns\n\n### Check if Orchestrator Running\n\n```nushell\nif (orch status | get running) { "✓ Running" } else { "✗ Stopped" }\n```\n\n### Validate Before Submit\n\n```nushell\nlet valid = (orch validate workflow.k | get valid)\nif $valid { "✓ Valid" } else { "✗ Invalid" }\n```\n\n### Count Tasks by Status\n\n```nushell\norch tasks | group-by status | each { |k,v| {status: $k, count: ($v | length)} }\n```\n\n### Find High Priority Tasks\n\n```nushell\norch tasks | where priority > 7 | select id priority\n```\n\n---\n\n## Environment\n\n```bash\nexport ORCHESTRATOR_DATA_DIR=/custom/path/to/data\n```\n\n---\n\n## Data Structure\n\n```plaintext\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\n**5-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`