@jterrats/open-orchestra 0.4.2-beta.2 → 0.5.0

package/docs/runtime-adapters.md

@@ -7,7 +7,7 @@ payload support, and usage guidance in one place.
 ## Adapter Catalog
 
 ```bash
-node bin/orchestra.js runtime adapters --json
+orchestra runtime adapters --json
 ```
 
 Current targets:
@@ -25,21 +25,21 @@ Current targets:
 Default project init keeps the current compact bootstrap behavior:
 
 ```bash
-node bin/orchestra.js init
+orchestra init
 ```
 
 Generate only selected runtime files:
 
 ```bash
-node bin/orchestra.js init --target claude,cursor,windsurf
+orchestra init --target claude,cursor,windsurf
 ```
 
 Advisory mode creates workflow state without root instruction files unless a
 target is explicit:
 
 ```bash
-node bin/orchestra.js init --advisory
-node bin/orchestra.js init --advisory --target claude
+orchestra init --advisory
+orchestra init --advisory --target claude
 ```
 
 It also writes portable planning artifacts under
@@ -50,7 +50,7 @@ Unsafe roots are blocked before writes. Unknown non-temp directories require an
 explicit confirmation:
 
 ```bash
-node bin/orchestra.js init --confirm-unknown
+orchestra init --confirm-unknown
 ```
 
 ## Runtime Loop
@@ -58,13 +58,14 @@ node bin/orchestra.js init --confirm-unknown
 After init, any runtime should use the same local control-plane loop:
 
 ```bash
-node bin/orchestra.js health --json
-node bin/orchestra.js task list --json
-node bin/orchestra.js context --task STORY-001 --json
-node bin/orchestra.js delegation decide --task STORY-001 --json
-node bin/orchestra.js skills render --target codex --task STORY-001
-node bin/orchestra.js protocol render --target codex --task STORY-001
-node bin/orchestra.js workflow render --target codex --task STORY-001
+orchestra health --json
+orchestra task list --json
+orchestra context --task STORY-001 --json
+orchestra delegation decide --task STORY-001 --json
+orchestra memory hook --point before_plan --task STORY-001 --json
+orchestra skills render --target codex --task STORY-001
+orchestra protocol render --target codex --task STORY-001
+orchestra workflow render --target codex --task STORY-001
 ```
 
 Change `--target` to the runtime that is executing the work. The workflow state,
@@ -76,7 +77,7 @@ The local web console exposes workspace classification and supported runtime
 targets through:
 
 ```bash
-node bin/orchestra.js web
+orchestra web
 ```
 
 The API contracts are:

package/docs/runtime-llm-flow.md

@@ -15,21 +15,22 @@ that phase and records phase artifacts plus model provenance.
 Use this sequence for a new project or a new task:
 
 ```bash
-node bin/orchestra.js init
-node bin/orchestra.js health --json
-node bin/orchestra.js task add --id STORY-001 --title "Short title" --owner developer --goal "Outcome"
-node bin/orchestra.js context --task STORY-001 --json
-node bin/orchestra.js delegation decide --task STORY-001 --json
-node bin/orchestra.js plan --task STORY-001 --json
-node bin/orchestra.js skills plan --task STORY-001 --json
-node bin/orchestra.js skills render --target codex --task STORY-001
-node bin/orchestra.js protocol render --target codex --task STORY-001
-node bin/orchestra.js workflow render --target codex --task STORY-001
-node bin/orchestra.js commands manifest --json
-node bin/orchestra.js runtime bootstrap --target codex
-node bin/orchestra.js evidence add --task STORY-001 --role developer --type command --summary "npm run precommit passed" --command "npm run precommit" --exit-code 0
-node bin/orchestra.js gate --gate architecture --task STORY-001
-node bin/orchestra.js summary --json
+orchestra init
+orchestra health --json
+orchestra task add --id STORY-001 --title "Short title" --owner developer --goal "Outcome"
+orchestra context --task STORY-001 --json
+orchestra delegation decide --task STORY-001 --json
+orchestra plan --task STORY-001 --json
+orchestra memory hook --point before_plan --task STORY-001 --json
+orchestra skills plan --task STORY-001 --json
+orchestra skills render --target codex --task STORY-001
+orchestra protocol render --target codex --task STORY-001
+orchestra workflow render --target codex --task STORY-001
+orchestra commands manifest --json
+orchestra runtime bootstrap --target codex
+orchestra evidence add --task STORY-001 --role developer --type command --summary "npm run precommit passed" --command "npm run precommit" --exit-code 0
+orchestra gate --gate architecture --task STORY-001
+orchestra summary --json
 ```
 
 Use `--target claude`, `--target cursor`, `--target codex`, `--target vscode`,
@@ -44,8 +45,8 @@ always-loaded context.
 Use explicit init targets when a project should generate runtime-specific files:
 
 ```bash
-node bin/orchestra.js runtime adapters --json
-node bin/orchestra.js init --target claude,cursor,windsurf
+orchestra runtime adapters --json
+orchestra init --target claude,cursor,windsurf
 ```
 
 ## Parent Agent Prompts
@@ -96,13 +97,13 @@ native provider adapter. Use `anthropic` to route phases to Claude models
 through the Anthropic Messages API.
 
 ```bash
-node bin/orchestra.js model providers --json
-node bin/orchestra.js model set-role --role qa --provider fake --model fake-model
-OPENAI_API_KEY=... node bin/orchestra.js model set-role --role architect --provider openai --model gpt-5.2
-ANTHROPIC_API_KEY=... node bin/orchestra.js model set-role --role qa --provider anthropic --model claude-sonnet-4-20250514
-node bin/orchestra.js model provenance list --json
-node bin/orchestra.js budget check --json
-node bin/orchestra.js workflow run --task STORY-001 --gates phase
+orchestra model providers --json
+orchestra model set-role --role qa --provider fake --model fake-model
+OPENAI_API_KEY=... orchestra model set-role --role architect --provider openai --model gpt-5.2
+ANTHROPIC_API_KEY=... orchestra model set-role --role qa --provider anthropic --model claude-sonnet-4-20250514
+orchestra model provenance list --json
+orchestra budget check --json
+orchestra workflow run --task STORY-001 --gates phase
 ```
 
 The OpenAI adapter reads `OPENAI_API_KEY` from the environment and optionally
@@ -128,10 +129,10 @@ the work and does not want Orchestra to call OpenAI, Anthropic, or another
 vendor API directly:
 
 ```bash
-node bin/orchestra.js runtime adapters --json
-node bin/orchestra.js runtime brief --task STORY-001 --runtime claude-cli
-node bin/orchestra.js runtime delegate-plan --task STORY-001 --runtime claude-cli --roles architect,developer,qa
-node bin/orchestra.js runtime handoff --task STORY-001 --runtime claude-cli --artifact .agent-workflow/runs/STORY-001-runtime-claude-cli-delegation.md
+orchestra runtime adapters --json
+orchestra runtime brief --task STORY-001 --runtime claude-cli
+orchestra runtime delegate-plan --task STORY-001 --runtime claude-cli --roles architect,developer,qa
+orchestra runtime handoff --task STORY-001 --runtime claude-cli --artifact .agent-workflow/runs/STORY-001-runtime-claude-cli-delegation.md
 ```
 
 Runtime briefs and delegation packets are written under `.agent-workflow/runs/`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jterrats/open-orchestra",
-  "version": "0.4.2-beta.2",
+  "version": "0.5.0",
   "type": "module",
   "bin": {
     "orchestra": "bin/orchestra.js"
@@ -10,10 +10,11 @@
     "typecheck": "tsc --noEmit",
     "test": "npm run build && node --test test/**/*.js extensions/**/*.test.cjs",
     "test:e2e": "npm run build && playwright test",
+    "test:e2e:init": "node --test e2e/init-onboarding.test.js",
     "lint": "eslint . && prettier --check \"{bin,e2e,scripts,test,src}/**/*.js\" \"extensions/**/*.{cjs,json,md}\" \"src/**/*.ts\" \"*.{js,json}\"",
     "format": "prettier --write \"{bin,e2e,scripts,test,src}/**/*.js\" \"extensions/**/*.{cjs,json,md}\" \"src/**/*.ts\" \"*.{js,json}\"",
     "secret-scan": "node scripts/secret-scan.js",
-    "validate:workflow": "sh -c 'test ! -d .agent-workflow || (npm run build && node bin/orchestra.js validate)'",
+    "validate:workflow": "node scripts/validate-workflow.js",
     "precommit": "npm run lint && npm run typecheck && npm run secret-scan && npm test && npm run validate:workflow",
     "prepack": "npm run build",
     "hooks:install": "git config core.hooksPath .githooks",