Packages reference
@snevins/orchard-cli
@snevins/orchard-cli provides the Incur-backed orchard binary for repo-local workflow generation, preview, and execution. It requires Node 22 or newer.
| Command | Purpose |
|---|---|
orchard init | Write repo-local .orchard/config.json. |
orchard doctor --json | Read-only readiness report for tooling (Node/pnpm, optional harness CLIs) and repo config. Returns structured ok: false diagnostics instead of throwing for not-ready states. There is no database, schema, or queue check. |
orchard generate | Generate, validate, type-check, and save a TypeScript workflow artifact. |
orchard preview | Preview saved artifact metadata without importing or executing source. |
orchard run | Run a saved artifact in-process with createLocalRuntime(). Nothing is persisted; the run ends with the process. |
orchard feedback | Open a prefilled GitHub issue for a bug, suggestion, or feature request. |
Generated workflow validation includes fast AST-based source contract checks before the TypeScript dry run. Those checks enforce the loader export shape, canonical Orchard primitive imports, no top-level side effects, strict Zod object schemas, caller-supplied run inputs instead of baked scenario values, generated-artifact-contract queue usage, stable step ids, and TOON-friendly handoff patterns. See Generate a workflow with the CLI for the authoring checklist.
Incur-provided integrations are part of the CLI surface: orchard --llms, orchard skills add, orchard mcp add, orchard --mcp, and shell completions. Generated Incur Skills and MCP tools are intentionally scoped to orchard generate and orchard run. Removed surfaces stay removed: orchard pglite, orchard resume, orchard-mcp, orchard setup, orchard doctor --fix, orchard monitor, and worker/poll concurrency tuning flags — this build has no worker pool to tune.
@snevins/orchard-core
@snevins/orchard-core contains public workflow primitives, harness factories, and the in-process runtime used by generated artifacts and the CLI.
| Export subpath | Purpose |
|---|---|
@snevins/orchard-core | Public primitives, workflow helpers, and createLocalRuntime. |
@snevins/orchard-core/harness | Cursor, Codex, Claude, and Devin harness factories. |
@snevins/orchard-core/primitives | Shared queue and primitive types. |
@snevins/orchard-core/workflow | Workflow authoring helpers. |
@snevins/orchard-core/local-runtime | createLocalRuntime(), Orchard's in-process task runtime. |
Project-local setup/status/run UX lives in @snevins/orchard-cli. There is no external tooling for state inspection or control: a run's only observable record is its own process output while it runs.