orcastrator 0.2.17 → 0.2.18

package/README.md

@@ -6,7 +6,7 @@
 
 # Orca
 
-Coordinated agent run harness. Breaks down a goal into a task graph, then executes it end-to-end via a persistent [Codex](https://github.com/ratley/codex-client) session with full context across tasks.
+Coordinated agent run harness. Breaks down a task into a task graph, then executes it end-to-end via a persistent [Codex](https://github.com/ratley/codex-client) session with full context across tasks.
 
 ## Install
 
@@ -14,9 +14,9 @@ Coordinated agent run harness. Breaks down a goal into a task graph, then execut
 npm install -g orcastrator
 ```
 
-## Run A Goal
+## Run A Task
 
-Start with a plain-language goal:
+Start with a plain-language task:
 
 ```bash
 orca "add auth to the app"
@@ -45,6 +45,7 @@ After task execution, Orca can run deterministic validation commands, then ask C
   - `report_only`: report findings and stop
   - `fail`: mark run failed when findings exist
 - `review.execution.validator.auto` (default `true`): auto-detect validator commands from `package.json`
+  - Caveat: `ORCA_SKIP_VALIDATORS=1` forces this to `false` at runtime
 - `review.execution.validator.commands` (optional explicit command list)
 - `review.execution.prompt` (optional custom reviewer instruction)
 
@@ -96,7 +97,12 @@ orca pr create --run <run-id>
 orca pr publish --run <run-id>
 orca pr status --run <run-id>
 
-orca pr publish --config ./orca.config.js
+orca pr publish --last
+orca pr publish --config ./orca.config.js   # accepted, currently unused by PR command resolution
+
+# Non-TTY requires explicit run selection
+orca pr publish --run <run-id>
+orca pr publish --last
 ```
 
 ## Config
@@ -104,18 +110,41 @@ orca pr publish --config ./orca.config.js
 Orca auto-discovers config in this order:
 
 1. `~/.orca/config.js`
-2. `./orca.config.js` or `./orca.config.ts`
+2. Project config: `./orca.config.ts` (preferred when both exist) or `./orca.config.js`
 3. `--config <path>` (if passed)
 
 Later entries override earlier ones.
 
 ```ts
 // orca.config.ts
-export default {
+import { defineOrcaConfig } from "orcastrator";
+
+export default defineOrcaConfig({
+  executor: "codex",
+  anthropicApiKey: process.env.ANTHROPIC_API_KEY,
+  openaiApiKey: process.env.OPENAI_API_KEY,
   runsDir: "./.orca/runs",
   sessionLogs: "./session-logs",
-
-  // Function hooks are first-class and strongly typed per hook.
+  skills: ["./.orca/skills"],
+  maxRetries: 1,
+  claude: {
+    model: "claude-sonnet-4-20250514",
+    effort: "medium",
+    useV2Preview: true,
+    maxTurnsPerTask: 12,
+    allowTextJsonFallback: false
+  },
+  codex: {
+    enabled: true,
+    model: "gpt-5.3-codex",
+    effort: "medium",
+    command: "codex",
+    timeoutMs: 300000,
+    multiAgent: false,
+    perCwdExtraUserRoots: [
+      { cwd: process.cwd(), extraUserRoots: ["/tmp/shared-skills"] }
+    ]
+  },
   hooks: {
     onTaskComplete: async (event, context) => {
       console.log(`task done: ${event.taskId} (${event.taskName}) from pid ${context.pid}`);
@@ -124,39 +153,49 @@ export default {
       console.error(event.error);
     }
   },
-
-  // Command hooks remain supported; payload is sent as stdin JSON.
   hookCommands: {
-    onTaskComplete: "node -e 'let s=\"\";process.stdin.on(\"data\",d=>s+=d);process.stdin.on(\"end\",()=>{const p=JSON.parse(s);console.log(`task done: ${p.taskId}`);})'",
+    onTaskComplete: "node ./scripts/on-task-complete.mjs",
     onComplete: "echo run complete",
     onError: "echo run failed"
   },
-  codex: {
-    model: "gpt-5.3-codex",       // override the codex model
-    multiAgent: true,              // enable codex multi-agent (see below)
-    perCwdExtraUserRoots: [        // optional app-server skill roots per cwd (skills/list)
-      { cwd: process.cwd(), extraUserRoots: ["/tmp/shared-skills"] }
-    ]
+  pr: {
+    enabled: true,
+    requireConfirmation: true
   },
   review: {
+    // Deprecated compatibility aliases (prefer review.plan.*):
+    // enabled: true,
+    // onInvalid: "fail",
     plan: {
-      enabled: true,               // default true
-      onInvalid: "fail"           // or "warn_skip"
+      enabled: true,
+      onInvalid: "fail"
     },
     execution: {
-      enabled: true,               // default true
-      maxCycles: 2,                // default 2
-      onFindings: "auto_fix",     // "auto_fix" | "report_only" | "fail"
+      enabled: true,
+      maxCycles: 2,
+      onFindings: "auto_fix",
       validator: {
-        auto: true,                // default true
+        auto: true,
         // commands: ["npm run validate"]
       },
       // prompt: "Prefer minimal safe fixes"
     }
   }
-};
+});
 ```
 
+### Config field reference (OrcaConfig)
+
+Top-level: `executor`, `anthropicApiKey`, `openaiApiKey`, `runsDir`, `sessionLogs`, `skills`, `maxRetries`, `hooks`, `hookCommands`, `pr`, `review`, `claude`, `codex`.
+
+- `pr.enabled`, `pr.requireConfirmation`
+- `maxRetries` is part of `OrcaConfig`; current planner-generated task retries remain fixed in task graph contracts
+- `claude.model`, `claude.effort`, `claude.useV2Preview`, `claude.maxTurnsPerTask`, `claude.allowTextJsonFallback`
+- `codex.enabled`, `codex.model`, `codex.effort`, `codex.command`, `codex.timeoutMs`, `codex.multiAgent`, `codex.perCwdExtraUserRoots`
+- `review.plan.enabled`, `review.plan.onInvalid`
+- `review.execution.enabled`, `review.execution.maxCycles`, `review.execution.onFindings`, `review.execution.validator.auto`, `review.execution.validator.commands`, `review.execution.prompt`
+- Deprecated compatibility aliases: `review.enabled`, `review.onInvalid` (still accepted; prefer `review.plan.*`)
+
 ### Multi-agent mode
 
 Codex supports experimental [multi-agent workflows](https://developers.openai.com/codex/multi-agent) where it can spawn parallel sub-agents for complex tasks.
@@ -184,7 +223,7 @@ Global:
 
 `orca` / `orca run`:
 
-- positional: `[goal]`
+- positional: `[task]`
 - also works: `--task <text>`, `-p, --prompt <text>`
 - `--spec <path>`
 - `--plan <path>`
@@ -205,6 +244,8 @@ Global:
 
 - `--spec <path>`
 - `--config <path>`
+- `--on-milestone <cmd>`
+- `--on-error <cmd>`
 
 `orca status`:
 
@@ -241,10 +282,17 @@ Global:
 
 - `--run <run-id>`
 - `--last`
-- `--config <path>`
+- `--config <path>` (accepted for compatibility; currently unused by PR command run resolution)
 
 `orca pr publish`:
 
+- `--run <run-id>`
+- `--last`
+- `--config <path>` (accepted for compatibility; currently unused by PR command run resolution)
+- If neither `--run` nor `--last` is provided: interactive run picker in TTY; non-TTY requires `--run` or `--last`
+
+`orca skills`:
+
 - `--config <path>`
 
 `orca setup`:
@@ -272,7 +320,7 @@ Hook names:
 - `onInvalidPlan`
 - `onFindings`
 - `onComplete`
-- `onError`
+- `onError` (fires on run failures and hook-dispatch failures)
 
 Run hooks from CLI with `--on-...` flags or from config via `hooks` / `hookCommands`.
 Unknown hook keys in config are rejected at load time with an explicit allowed-hook list.
@@ -283,10 +331,7 @@ Hook contract:
 - Command hooks (`--on-...` and `config.hookCommands`) receive the full event payload as JSON over stdin.
 - Orca no longer injects hook payload via `ORCA_*` env vars.
 
-Migration note:
-- If your hook commands previously read any `ORCA_*` hook env payload (`ORCA_HOOK_PAYLOAD_JSON`, `ORCA_MSG`, `ORCA_RUN_ID`, etc.), switch them to parse stdin JSON instead.
-- Existing CLI hook flags are preserved (`--on-milestone`, `--on-error`, etc.); only payload transport changed.
-- Smoke-test the hook contract (function + command + concurrency): `npm run smoke:hooks`.
+Smoke-test the hook contract (function + command + concurrency): `npm run smoke:hooks`.
 
 ### Run ID Format
 
@@ -310,6 +355,8 @@ During planning, Orca automatically injects project instruction files when prese
 
 Files are discovered from the project root (nearest `.git` from the spec/task context) and injected in that order.
 
+If both filenames resolve to the same underlying file (for example, `CLAUDE.md` symlinked to `AGENTS.md`), Orca injects that content only once and keeps the first entry in order (`AGENTS.md`).
+
 ### Project Skills
 
 Orca auto-loads skills in this precedence order (first matching skill name wins):
@@ -346,7 +393,7 @@ npm install
 Run local development and tests with Bun (faster runtime for this project):
 
 ```bash
-bun run src/cli/index.ts "your goal here"
+bun run src/cli/index.ts "your task here"
 bun test src
 npm run test:postexec-json
 ```
@@ -369,6 +416,46 @@ This runs, in order:
 
 `npm run build` remains `tsc` because the native preview compiler is used here as a fast typecheck gate; production JS emission stays on stable `typescript` for predictable package output.
 
+## GitHub release tracking (tags only)
+
+Orca includes a lightweight GitHub Actions workflow at `.github/workflows/release.yml`:
+
+- Trigger: push a tag matching `v*` (workflow only releases SemVer tags like `v0.4.0` or `v0.4.0-rc.1`)
+- Behavior: create or update the matching GitHub Release
+- Notes: auto-generated by GitHub (`generate_release_notes: true`)
+
+This workflow is for release tracking/changelogs only. It does not publish to npm.
+
+## npm publish automation (GitHub Actions)
+
+Orca includes a publish workflow at `.github/workflows/publish.yml`.
+
+- Primary trigger: push a tag matching `v*` (for example `v1.2.3` or `v1.2.3-rc.1`)
+- Optional fallback: manual `workflow_dispatch`
+- Required secret: `NPM_TOKEN`
+- Behavior: checkout → Node setup (npm registry auth) → safety checks → `npm ci` → `npm run validate` → publish if version is not already on npm
+
+Safety checks enforced before publish:
+
+1. Tag must be SemVer-like (`vX.Y.Z` with optional prerelease/build metadata)
+2. Release commit must be reachable from the repository default branch
+3. `package.json` version must match the tag version (without the leading `v`)
+4. If the version already exists on npm, publish is skipped as a safe no-op
+
+### Safe setup
+
+1. In GitHub, open **Settings → Secrets and variables → Actions** for this repository.
+2. Add a repository secret named `NPM_TOKEN`.
+   - Create this token in npm as a granular automation/publish token scoped only to `orcastrator`.
+3. Use least privilege, avoid reusing broad account tokens, and rotate the token periodically.
+
+### Safe run flow
+
+1. Bump `package.json` to the intended release version.
+2. Create and push a matching tag, for example: `git tag v1.2.3 && git push origin v1.2.3`.
+3. Verify the package on npm after the workflow completes.
+4. If needed, run the same workflow manually from **Actions → npm Publish → Run workflow** as a fallback (use an existing tag so the workflow publishes that exact tagged commit).
+
 ## Package manager + lockfile policy
 
 Orca uses a mixed runtime/tooling model on purpose:

package/dist/agents/claude/session.d.ts

@@ -0,0 +1,10 @@
+import type { OrcaConfig, PlanResult, Task, TaskExecutionResult, TaskGraphReviewResult } from "../../types/index.js";
+export type { PlanResult, TaskExecutionResult };
+export declare function parseTaskArray(raw: string): Task[];
+export declare function parseTaskExecution(raw: string): TaskExecutionResult;
+export declare function parseStructuredPlanPayload(payload: unknown): Task[];
+export declare function parseStructuredTaskExecutionPayload(payload: unknown, rawResponse?: string): TaskExecutionResult;
+export declare function planSpec(spec: string, systemContext: string, config?: OrcaConfig): Promise<PlanResult>;
+export declare function reviewTaskGraph(tasks: Task[], systemContext: string, config?: OrcaConfig): Promise<TaskGraphReviewResult>;
+export declare function executeTask(task: Task, runId: string, config?: OrcaConfig, systemContext?: string): Promise<TaskExecutionResult>;
+//# sourceMappingURL=session.d.ts.map

package/dist/agents/claude/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/agents/claude/session.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,IAAI,EACJ,mBAAmB,EAEnB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAO9B,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,CAAC;AAoOhD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,CAQlD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAYnE;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,EAAE,CAOnE;AAED,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,SAAK,GAAG,mBAAmB,CAW3G;AA4FD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CA4B5G;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,IAAI,EAAE,EACb,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,qBAAqB,CAAC,CAiBhC;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,UAAU,EACnB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,mBAAmB,CAAC,CAwB9B"}

package/dist/agents/codex/index.d.ts

@@ -0,0 +1,3 @@
+export { createCodexSession, planSpec, executeTask, } from "./session.js";
+export type { PlanResult, TaskExecutionResult, } from "./session.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/codex/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/codex/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,QAAQ,EACR,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,UAAU,EACV,mBAAmB,GACpB,MAAM,cAAc,CAAC"}

package/dist/agents/codex/session.d.ts

@@ -0,0 +1,29 @@
+import type { OrcaConfig, PlanResult, Task, TaskExecutionResult, TaskGraphReviewResult } from "../../types/index.js";
+export type { PlanResult, TaskExecutionResult };
+/**
+ * Create a persistent Codex session. The thread persists across calls —
+ * planSpec and executeTask share context within the same session.
+ */
+export interface ConsultationResult {
+    issues: string[];
+    ok: boolean;
+}
+export declare function createCodexSession(cwd: string, config?: OrcaConfig): Promise<{
+    planSpec: (spec: string, systemContext: string) => Promise<PlanResult>;
+    reviewTaskGraph: (tasks: Task[], systemContext: string) => Promise<TaskGraphReviewResult>;
+    executeTask: (task: Task, runId: string, systemContext?: string) => Promise<TaskExecutionResult>;
+    consultTaskGraph: (tasks: Task[]) => Promise<ConsultationResult>;
+    reviewChanges: (threadId?: string) => Promise<string>;
+    runPrompt: (prompt: string) => Promise<string>;
+    disconnect: () => Promise<void>;
+    threadId: string;
+}>;
+/**
+ * Stateless wrappers that match the Claude adapter interface.
+ * Each call creates a new client + thread (no persistence).
+ * Use createCodexSession() for persistent threads.
+ */
+export declare function planSpec(spec: string, systemContext: string, config?: OrcaConfig): Promise<PlanResult>;
+export declare function reviewTaskGraph(tasks: Task[], systemContext: string, config?: OrcaConfig): Promise<TaskGraphReviewResult>;
+export declare function executeTask(task: Task, runId: string, config?: OrcaConfig, systemContext?: string): Promise<TaskExecutionResult>;
+//# sourceMappingURL=session.d.ts.map

package/dist/agents/codex/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/agents/codex/session.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,IAAI,EACJ,mBAAmB,EAEnB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAK9B,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,CAAC;AA8XhD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,EAAE,EAAE,OAAO,CAAC;CACb;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC;IACT,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACvE,eAAe,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC1F,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACjG,gBAAgB,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACjE,aAAa,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAoLD;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,UAAU,CAAC,CAQrB;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,IAAI,EAAE,EACb,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,qBAAqB,CAAC,CAQhC;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,UAAU,EACnB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,mBAAmB,CAAC,CAQ9B"}

package/dist/cli/commands/answer.d.ts

@@ -0,0 +1,7 @@
+import type { Command } from "commander";
+export interface AnswerCommandOptions {
+    run?: string;
+}
+export declare function answerCommandHandler(positionalRunId: string | undefined, answerArg: string | undefined, options: AnswerCommandOptions): Promise<void>;
+export declare function registerAnswerCommand(program: Command): void;
+//# sourceMappingURL=answer.d.ts.map

package/dist/cli/commands/answer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/answer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAgCD,wBAAsB,oBAAoB,CACxC,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAqCf;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAa5D"}

package/dist/cli/commands/cancel.d.ts

@@ -0,0 +1,9 @@
+import type { Command } from "commander";
+export interface CancelCommandOptions {
+    run?: string;
+    last?: boolean;
+    config?: string;
+}
+export declare function cancelCommandHandler(options: CancelCommandOptions): Promise<void>;
+export declare function registerCancelCommand(program: Command): void;
+//# sourceMappingURL=cancel.d.ts.map

package/dist/cli/commands/cancel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/cancel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAmBD,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyDvF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQ5D"}

package/dist/cli/commands/help.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerHelpCommand(program: Command): void;
+//# sourceMappingURL=help.d.ts.map

package/dist/cli/commands/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/help.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsGzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqB1D"}

package/dist/cli/commands/list.d.ts

@@ -0,0 +1,10 @@
+import type { Command } from "commander";
+import type { RunStatus } from "../../types/index.js";
+export interface ListCommandOptions {
+    config?: string;
+}
+export declare function formatRunSummaryTable(runs: RunStatus[]): string;
+export declare function listRuns(): Promise<RunStatus[]>;
+export declare function listCommandHandler(_options: ListCommandOptions): Promise<void>;
+export declare function registerListCommand(program: Command): void;
+//# sourceMappingURL=list.d.ts.map

package/dist/cli/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAiCD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,CAI/D;AAED,wBAAsB,QAAQ,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAGrD;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CASpF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAM1D"}

package/dist/cli/commands/plan.d.ts

@@ -0,0 +1,14 @@
+import type { Command } from "commander";
+export interface PlanCommandOptions {
+    spec: string;
+    config?: string;
+    onMilestone?: string;
+    onError?: string;
+}
+export declare function planCommand(options: {
+    spec: string;
+    config?: string;
+}): Promise<void>;
+export declare function planCommandHandler(options: PlanCommandOptions): Promise<void>;
+export declare function registerPlanCommand(program: Command): void;
+//# sourceMappingURL=plan.d.ts.map

package/dist/cli/commands/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB3F;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKnF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAS1D"}

package/dist/cli/commands/pr/create.d.ts

@@ -0,0 +1,5 @@
+import type { Command } from "commander";
+import { type PrCommandOptions } from "./shared.js";
+export declare function prCreateCommandHandler(options: PrCommandOptions): Promise<void>;
+export declare function registerPrCreateCommand(program: Command): void;
+//# sourceMappingURL=create.d.ts.map

package/dist/cli/commands/pr/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/pr/create.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,EACL,KAAK,gBAAgB,EAOtB,MAAM,aAAa,CAAC;AAUrB,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CrF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQ9D"}

package/dist/cli/commands/pr/draft.d.ts

@@ -0,0 +1,5 @@
+import type { Command } from "commander";
+import { type PrCommandOptions } from "./shared.js";
+export declare function prDraftCommandHandler(options: PrCommandOptions): Promise<void>;
+export declare function registerPrDraftCommand(program: Command): void;
+//# sourceMappingURL=draft.d.ts.map

package/dist/cli/commands/pr/draft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/pr/draft.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,EACL,KAAK,gBAAgB,EAOtB,MAAM,aAAa,CAAC;AAUrB,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CpF;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQ7D"}

package/dist/cli/commands/pr/index.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerPrCommand(program: Command): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/pr/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/pr/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8DxD"}

package/dist/cli/commands/pr/publish.d.ts

@@ -0,0 +1,5 @@
+import type { Command } from "commander";
+import { type PrCommandOptions } from "./shared.js";
+export declare function prPublishCommandHandler(options: PrCommandOptions): Promise<void>;
+export declare function registerPrPublishCommand(program: Command): void;
+//# sourceMappingURL=publish.d.ts.map

package/dist/cli/commands/pr/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/pr/publish.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,EACL,KAAK,gBAAgB,EAKtB,MAAM,aAAa,CAAC;AAErB,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuCtF;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQ/D"}

package/dist/cli/commands/pr/shared.d.ts

@@ -0,0 +1,14 @@
+import { RunStore } from "../../../state/store.js";
+import type { RunStatus } from "../../../types/index.js";
+export interface PrCommandOptions {
+    run?: string;
+    last?: boolean;
+    config?: string;
+}
+export declare function createStore(): RunStore;
+export declare function buildPrTitle(run: RunStatus): string;
+export declare function buildPrBody(run: RunStatus): string;
+export declare function loadRunOrExit(options: PrCommandOptions): Promise<RunStatus | null>;
+export declare function printGhMissingAndExit(): void;
+export declare function resolveRunIdOrExit(options: PrCommandOptions, commandName: "draft" | "create" | "publish" | "status"): Promise<string | null>;
+//# sourceMappingURL=shared.d.ts.map

package/dist/cli/commands/pr/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/pr/shared.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAIzD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAGtC;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAInD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAmBlD;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAiBxF;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,gBAAgB,EACzB,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GACrD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgCxB"}

package/dist/cli/commands/pr/status.d.ts

@@ -0,0 +1,5 @@
+import type { Command } from "commander";
+import { type PrCommandOptions } from "./shared.js";
+export declare function prStatusCommandHandler(options: PrCommandOptions): Promise<void>;
+export declare function registerPrStatusCommand(program: Command): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/cli/commands/pr/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/pr/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,EAAE,KAAK,gBAAgB,EAA4D,MAAM,aAAa,CAAC;AA2B9G,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDrF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQ9D"}

package/dist/cli/commands/pr-finalize.d.ts

@@ -0,0 +1,8 @@
+import type { Command } from "commander";
+export interface PrFinalizeCommandOptions {
+    run: string;
+    config?: string;
+}
+export declare function prFinalizeCommandHandler(_options: PrFinalizeCommandOptions): Promise<void>;
+export declare function registerPrFinalizeCommand(program: Command): void;
+//# sourceMappingURL=pr-finalize.d.ts.map

package/dist/cli/commands/pr-finalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-finalize.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/pr-finalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhG;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAOhE"}

package/dist/cli/commands/resume.d.ts

@@ -0,0 +1,14 @@
+import { type Command } from "commander";
+import { type ClaudeEffort, type CodexEffort } from "../../types/effort.js";
+export interface ResumeCommandOptions {
+    run?: string;
+    last?: boolean;
+    config?: string;
+    codexOnly?: boolean;
+    claudeOnly?: boolean;
+    codexEffort?: CodexEffort;
+    claudeEffort?: ClaudeEffort;
+}
+export declare function resumeCommandHandler(options: ResumeCommandOptions): Promise<void>;
+export declare function registerResumeCommand(program: Command): void;
+//# sourceMappingURL=resume.d.ts.map

package/dist/cli/commands/resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAM/D,OAAO,EAAuC,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGjH,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AA4DD,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuEvF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmB5D"}

package/dist/cli/commands/run-command.test-harness.d.ts

@@ -0,0 +1,18 @@
+import { mock } from "bun:test";
+type RunModule = typeof import("./run.js");
+export type RunCommandTestHarness = {
+    getTempDir: () => string;
+    loadRunModule: () => Promise<{
+        runModule: RunModule;
+        runPlannerMock: ReturnType<typeof mock>;
+        runTaskRunnerMock: ReturnType<typeof mock>;
+        createCodexSessionMock: ReturnType<typeof mock>;
+        ensureCodexMultiAgentMock: ReturnType<typeof mock>;
+        hookDispatchMock: ReturnType<typeof mock>;
+        InvalidPlanErrorCtor: new (stage: "planner" | "review", message: string) => Error;
+    }>;
+    parseRun: (runModule: RunModule, argv: string[]) => Promise<void>;
+};
+export declare function createRunCommandTestHarness(tempPrefix: string): RunCommandTestHarness;
+export {};
+//# sourceMappingURL=run-command.test-harness.d.ts.map

package/dist/cli/commands/run-command.test-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.test-harness.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/run-command.test-harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,IAAI,EAAE,MAAM,UAAU,CAAC;AAMvD,KAAK,SAAS,GAAG,cAAc,UAAU,CAAC,CAAC;AAE3C,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,OAAO,CAAC;QAC3B,SAAS,EAAE,SAAS,CAAC;QACrB,cAAc,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;QACxC,iBAAiB,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;QAC3C,sBAAsB,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;QAChD,yBAAyB,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;QACnD,gBAAgB,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;QAC1C,oBAAoB,EAAE,KAAK,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,OAAO,EAAE,MAAM,KAAK,KAAK,CAAC;KACnF,CAAC,CAAC;IACH,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE,CAAC;AAEF,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,CA0IrF"}

package/dist/cli/commands/run.d.ts

@@ -0,0 +1,24 @@
+import { type Command } from "commander";
+import { type ClaudeEffort, type CodexEffort } from "../../types/effort.js";
+export interface RunCommandOptions {
+    spec?: string;
+    plan?: string;
+    task?: string;
+    prompt?: string;
+    goal?: string;
+    config?: string;
+    codexOnly?: boolean;
+    claudeOnly?: boolean;
+    codexEffort?: CodexEffort;
+    claudeEffort?: ClaudeEffort;
+    onMilestone?: string;
+    onTaskComplete?: string;
+    onTaskFail?: string;
+    onInvalidPlan?: string;
+    onFindings?: string;
+    onComplete?: string;
+    onError?: string;
+}
+export declare function runCommandHandler(options: RunCommandOptions): Promise<void>;
+export declare function registerRunCommand(program: Command): void;
+//# sourceMappingURL=run.d.ts.map

package/dist/cli/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/run.ts"],"names":[],"mappings":"AAQA,OAAO,EAAwB,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAa/D,OAAO,EAAuC,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AA4BjH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA0PD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiRjF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkEzD"}

package/dist/cli/commands/setup.d.ts

@@ -0,0 +1,27 @@
+import type { Command } from "commander";
+export interface SetupCommandOptions {
+    anthropicKey?: string;
+    openaiKey?: string;
+    check?: boolean;
+    global?: boolean;
+    project?: boolean;
+    projectConfigTemplate?: boolean;
+    skipProjectConfig?: boolean;
+}
+type PackageManager = "brew" | "apt" | "winget";
+type ApiKeyConfig = {
+    anthropicApiKey?: string;
+    openaiApiKey?: string;
+};
+type ResolveApiKeyOptions = {
+    openclawConfigPath?: string;
+    homedir?: string;
+};
+export declare function resolveApiKey(flagValue: string | undefined, envVarName: string, openclawConfigPathOrOptions?: string | ResolveApiKeyOptions, maybeOptions?: ResolveApiKeyOptions): string | undefined;
+export declare function detectPackageManager(exists?: (command: string) => boolean): PackageManager | null;
+export declare function buildConfigModule({ anthropicApiKey, openaiApiKey }: ApiKeyConfig): string;
+export declare function buildProjectConfigTemplate(): string;
+export declare function setupCommandHandler(options: SetupCommandOptions): Promise<void>;
+export declare function registerSetupCommand(program: Command): void;
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/cli/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/setup.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,KAAK,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEhD,KAAK,YAAY,GAAG;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AA8DF,KAAK,oBAAoB,GAAG;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,EAAE,MAAM,EAClB,2BAA2B,CAAC,EAAE,MAAM,GAAG,oBAAoB,EAC3D,YAAY,CAAC,EAAE,oBAAoB,GAClC,MAAM,GAAG,SAAS,CA6BpB;AAqJD,wBAAgB,oBAAoB,CAClC,MAAM,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAuB,GACnD,cAAc,GAAG,IAAI,CAcvB;AAED,wBAAgB,iBAAiB,CAAC,EAAE,eAAe,EAAE,YAAY,EAAE,EAAE,YAAY,GAAG,MAAM,CAazF;AAMD,wBAAgB,0BAA0B,IAAI,MAAM,CA6DnD;AAoND,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkJrF;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAc3D"}