orcareplay 0.1.0

package/dist/exchange-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange-events.js","sourceRoot":"","sources":["../src/exchange-events.ts"],"names":[],"mappings":"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"}

package/dist/flags.d.ts

@@ -0,0 +1,10 @@
+import type { ParsedArgs } from './args.js';
+/**
+ * Reject a flag this command does not have.
+ *
+ * Throws rather than warns. A flag is an instruction, and carrying on having ignored one produces
+ * a run that did something other than what was asked while reporting success — which is the
+ * failure this whole tool exists to make visible.
+ */
+export declare function assertKnownFlags(args: ParsedArgs): void;
+//# sourceMappingURL=flags.d.ts.map

package/dist/flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../src/flags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAkE5C;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAevD"}

package/dist/flags.js

@@ -0,0 +1,83 @@
+/**
+ * Which flags each command accepts.
+ *
+ * The parser takes any flag it is given, which is right for parsing and wrong for a CLI: a
+ * mistyped or invented flag was accepted in silence and simply had no effect, so a run that did
+ * something other than what was asked reported success.
+ *
+ * Every entry below is a flag the code actually reads — collected from the `args.bool/str/num/list`
+ * calls in each command and in the helpers it shares — not from what the documentation describes.
+ * Building it the other way round is how a flag that never existed came to be recommended in the
+ * first place, and a list that allows more than the code understands would rebuild exactly that.
+ */
+const GLOBAL = ['ci', 'json', 'verbose', 'color', 'help', 'version', 'h'];
+/** Read by `config.ts` for any command that can reach a provider. */
+const UPSTREAM = ['upstream-anthropic', 'upstream-openai'];
+/** Read by `tls-capture.ts`, which record, replay and compare all set up. */
+const TLS = ['tls-intercept', 'tls-hosts'];
+const BY_COMMAND = {
+    record: ['fs', 'shell', 'mcp-config', ...TLS, ...UPSTREAM],
+    replay: [
+        'from',
+        'model',
+        'fs',
+        'in-place',
+        'worktree',
+        'loose',
+        'trace',
+        'port',
+        'ui',
+        'mcp-config',
+        ...TLS,
+        ...UPSTREAM,
+    ],
+    compare: ['from', 'models', 'verify', 'share', 'loose', ...TLS, ...UPSTREAM],
+    show: [],
+    checkpoints: [],
+    export: ['o', 'out'],
+    ui: ['port'],
+    scrub: ['match', 'matches', 'dry-run', 'drop-fs'],
+    list: [],
+    gc: ['older-than', 'keep', 'dry-run'],
+    doctor: [],
+    setup: ['gateway', 'key', 'key-env', 'models'],
+    models: [],
+    mcp: [],
+    help: [],
+};
+/** The closest known flag, for a name that is probably a typo rather than an invention. */
+function nearest(name, known) {
+    let best;
+    for (const candidate of known) {
+        // Prefix and containment both catch the realistic slips: `--worktre`, `--model-s`.
+        const prefix = candidate.startsWith(name) || name.startsWith(candidate) ? 2 : 0;
+        const contains = candidate.includes(name) || name.includes(candidate) ? 1 : 0;
+        const score = Math.max(prefix, contains);
+        if (score > 0 && (best === undefined || score > best.score))
+            best = { name: candidate, score };
+    }
+    return best?.name;
+}
+/**
+ * Reject a flag this command does not have.
+ *
+ * Throws rather than warns. A flag is an instruction, and carrying on having ignored one produces
+ * a run that did something other than what was asked while reporting success — which is the
+ * failure this whole tool exists to make visible.
+ */
+export function assertKnownFlags(args) {
+    const allowed = BY_COMMAND[args.command];
+    // An unknown command is reported by the dispatcher, which can say more about it than this can.
+    if (allowed === undefined)
+        return;
+    const known = [...allowed, ...GLOBAL];
+    const unknown = Object.keys(args.flags).filter((name) => !known.includes(name));
+    if (unknown.length === 0)
+        return;
+    const [first] = unknown;
+    const suggestion = nearest(first, known);
+    throw new Error(`unknown flag --${first} for "orca ${args.command}"` +
+        (suggestion === undefined ? '' : `\n  did you mean --${suggestion}?`) +
+        `\n  flags for this command: ${allowed.length === 0 ? '(none)' : allowed.map((f) => `--${f}`).join(' ')}`);
+}
+//# sourceMappingURL=flags.js.map

package/dist/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../src/flags.ts"],"names":[],"mappings":"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"}

package/dist/fs-events.d.ts

@@ -0,0 +1,19 @@
+import type { TraceWriter } from '@orcareplay/core';
+import type { FsCapture } from '@orcareplay/fs-capture';
+import type { Output } from './out.js';
+/**
+ * Snapshot the workspace and write what changed.
+ *
+ * Shared by `orca record` and by a fork, which had none of this: a fork ran a live agent in a
+ * worktree and recorded only the conversation, so its trace carried no `fs.snapshot` at all — and a
+ * checkpoint is *derived* from a snapshot (spec §3). A run with no checkpoints cannot be forked, so
+ * you could not fork a fork, and `orca compare last` straight after a fork failed with "this run
+ * has no checkpoints" because `last` had resolved to the fork.
+ *
+ * Degrade, never abort: losing a snapshot costs one checkpoint, whereas throwing here would cost
+ * the user the run they were in the middle of.
+ */
+export declare function appendSnapshot(fs: FsCapture, writer: TraceWriter, out: Output, turn: number, options?: {
+    initial?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=fs-events.d.ts.map

package/dist/fs-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-events.d.ts","sourceRoot":"","sources":["../src/fs-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,SAAS,EACb,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,OAAO,CAAC,IAAI,CAAC,CAuCf"}

package/dist/fs-events.js

@@ -0,0 +1,53 @@
+import { snapshotWithRetry } from './snapshot.js';
+/**
+ * Snapshot the workspace and write what changed.
+ *
+ * Shared by `orca record` and by a fork, which had none of this: a fork ran a live agent in a
+ * worktree and recorded only the conversation, so its trace carried no `fs.snapshot` at all — and a
+ * checkpoint is *derived* from a snapshot (spec §3). A run with no checkpoints cannot be forked, so
+ * you could not fork a fork, and `orca compare last` straight after a fork failed with "this run
+ * has no checkpoints" because `last` had resolved to the fork.
+ *
+ * Degrade, never abort: losing a snapshot costs one checkpoint, whereas throwing here would cost
+ * the user the run they were in the middle of.
+ */
+export async function appendSnapshot(fs, writer, out, turn, options = {}) {
+    const outcome = await snapshotWithRetry(fs, turn);
+    if (!outcome.ok || !outcome.snapshot) {
+        out.warn('fs.snapshot_failed', { turn, attempts: outcome.attempts, error: outcome.error });
+        await writer.append({
+            type: 'note',
+            actor: 'orca',
+            turn,
+            attrs: { rule: 'fs_snapshot_skipped', attempts: outcome.attempts, error: outcome.error },
+        });
+        return;
+    }
+    const snap = outcome.snapshot;
+    await writer.append({
+        type: 'fs.snapshot',
+        actor: 'orca',
+        turn,
+        attrs: {
+            tree: snap.tree,
+            changes: snap.changes.length,
+            ...(options.initial === true ? { initial: true } : {}),
+        },
+    });
+    for (const change of snap.changes) {
+        await writer.append({
+            type: 'fs.change',
+            actor: 'orca',
+            turn,
+            attrs: {
+                path: change.path,
+                status: change.status,
+                insertions: change.insertions,
+                deletions: change.deletions,
+                // Only when true, so a trace is not littered with a false on every unremarkable change.
+                ...(change.eolOnly === true ? { eol_only: true } : {}),
+            },
+        });
+    }
+}
+//# sourceMappingURL=fs-events.js.map

package/dist/fs-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-events.js","sourceRoot":"","sources":["../src/fs-events.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAa,EACb,MAAmB,EACnB,GAAW,EACX,IAAY,EACZ,UAAiC,EAAE;IAEnC,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrC,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3F,MAAM,MAAM,CAAC,MAAM,CAAC;YAClB,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,MAAM;YACb,IAAI;YACJ,KAAK,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE;SACzF,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC9B,MAAM,MAAM,CAAC,MAAM,CAAC;QAClB,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,MAAM;QACb,IAAI;QACJ,KAAK,EAAE;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YAC5B,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvD;KACF,CAAC,CAAC;IACH,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,MAAM,MAAM,CAAC,MAAM,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,MAAM;YACb,IAAI;YACJ,KAAK,EAAE;gBACL,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,wFAAwF;gBACxF,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvD;SACF,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export * from './api.js';
+export * from './args.js';
+export * from './out.js';
+export * from './main.js';
+export * from './exchange-events.js';
+export * from './mcp.js';
+export * from './serial.js';
+export * from './snapshot.js';
+export * from './share-card.js';
+export * from './commands/record.js';
+export * from './commands/replay.js';
+export * from './commands/compare.js';
+export * from './commands/inspect.js';
+export * from './commands/scrub.js';
+export * from './commands/gc.js';
+export * from './commands/doctor.js';
+export * from './version.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+export * from './api.js';
+export * from './args.js';
+export * from './out.js';
+export * from './main.js';
+export * from './exchange-events.js';
+export * from './mcp.js';
+export * from './serial.js';
+export * from './snapshot.js';
+export * from './share-card.js';
+export * from './commands/record.js';
+export * from './commands/replay.js';
+export * from './commands/compare.js';
+export * from './commands/inspect.js';
+export * from './commands/scrub.js';
+export * from './commands/gc.js';
+export * from './commands/doctor.js';
+export * from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+export declare function main(argv: string[], cwd?: string): Promise<number>;
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAwGA,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,SAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkG/E"}

package/dist/main.js

@@ -0,0 +1,282 @@
+import { assertKnownFlags } from './flags.js';
+import { parseArgs } from './args.js';
+import { Orca } from './api.js';
+import { serveMcp } from './mcp-server.js';
+import { Output } from './out.js';
+import { recordCommand } from './commands/record.js';
+import { replayCommand } from './commands/replay.js';
+import { checkpointsCommand, graphCommand, exportCommand, listCommand, showCommand, uiCommand, } from './commands/inspect.js';
+import { compareCommand } from './commands/compare.js';
+import { scrubCommand } from './commands/scrub.js';
+import { gcCommand } from './commands/gc.js';
+import { doctorCommand } from './commands/doctor.js';
+import { modelsCommand, setupCommand } from './commands/setup.js';
+import { ORCA_VERSION } from './version.js';
+const HELP = `orca ${ORCA_VERSION} — record, replay and fork debugger for AI agents
+
+  orca record <agent>            run an agent and capture everything
+  orca replay [run]              reproduce a run exactly, network off
+        --ui                     open the timeline when it finishes
+  orca replay [run] --from N     fork from a checkpoint and continue live
+        --model <id>             continue on a different model
+  orca compare [run] --models a,b,c
+                                 fork the same checkpoint onto several models
+        --from N                 checkpoint to fork every model from
+        --verify <cmd>           run this in each fork; its exit code is the verdict
+        --share [f.svg|png]      write the verdict table as a shareable card
+  orca show [run]                the timeline, in the terminal
+  orca checkpoints [run]         where you can fork from
+  orca graph [run]               what caused what — recorded edges and derived ones
+        --to N                   just the chain that produced event N
+  orca export [run] -o file.html a single self-contained file you can attach
+        --card [f.svg|png|gif]   one causal chain as a picture, ready to paste
+        --graph-card [f.svg|png] the whole run as a graph, with the chain lit
+        --to N                   which event the card is about (default: the failure)
+  orca scrub [run] --match X     remove something from a recorded trace
+        --dry-run                say what would go, and write nothing
+        --drop-fs                delete the filesystem snapshots, which cannot be scrubbed
+  orca ui [run]                  serve the viewer locally
+  orca list                      runs recorded here
+  orca gc --older-than 7d        reclaim space, forks' scratch worktrees included
+                                 --keep N, --dry-run
+  orca doctor                    check this machine can record at all
+  orca setup                     point orca at a gateway once, to compare many models
+                                 defaults to OrcaRouter; --gateway for any other
+        --gateway <url>          origin that serves the model APIs
+        --key <k> | --key-env V  store the key, or read it from an environment variable
+        --models a,b,c           default model list, so compare needs no flags
+  orca models                    what the configured gateway serves, and what it costs
+
+  [run] is a run id, or "last" (the default).
+
+Flags
+  --loose        on replay, continue live past an unmatched request
+  --in-place     replay against this directory as it stands, restoring nothing
+  --worktree     replay in a scratch copy; never touches your files
+  --no-trace     do not record the exact replay itself as a run of its own
+  --no-fs        skip filesystem capture
+  --no-shell     skip shell capture (PATH shim in front of sh/bash)
+  --mcp-config <path>  instrument MCP servers from this config
+  --ci           machine-readable output, no progress
+  --verbose      more detail
+  --no-color     also honours NO_COLOR
+  --port <n>     port for --ui and orca ui (default: any free port)
+
+A harness that reads no base-URL variable cannot be captured that way at all — a Codex CLI signed
+in with a ChatGPT subscription is the case. For that, and only for that:
+
+  --tls-intercept              decrypt HTTPS for the hosts below, for this run only
+  --tls-hosts a,b,c            which hosts to decrypt (default: model API hosts)
+                               everything else is tunnelled unread; "*" is refused
+
+  It mints a certificate authority in the run directory, trusts it to the agent through that
+  child's environment alone, and deletes it when the run ends. It installs nothing, anywhere.
+  If a machine is already behind a TLS-inspecting proxy, name its root in ORCA_TLS_UPSTREAM_CA.
+
+Sending traffic somewhere other than the vendor — a gateway, a proxy, a local model — is what
+these two are for. They apply to record, replay, fork and compare alike:
+
+  --upstream-anthropic <url>   origin for /v1/messages       (env ORCA_UPSTREAM_ANTHROPIC)
+  --upstream-openai <url>      origin for /chat/completions  (env ORCA_UPSTREAM_OPENAI)
+
+Everything after -- goes to the agent:
+  orca record claude -- -p "fix the failing test"
+
+For a script, an agent, or CI — every command below also answers as data:
+
+  --json         one JSON document on stdout, diagnostics on stderr
+                 list · show · events · checkpoints · graph · record · replay · compare
+                 · doctor
+
+  orca mcp       serve orca to an agent over MCP on stdio, so it can read its own runs:
+                 {"command": "orca", "args": ["mcp"]}
+
+Docs: https://github.com/Continuum-AI-Corp/OrcaReplay
+`;
+export async function main(argv, cwd = process.cwd()) {
+    const args = parseArgs(argv);
+    if (args.bool('json'))
+        return jsonMain(args, cwd);
+    // Under `orca mcp`, stdout is the JSON-RPC transport. A single info line on it corrupts the
+    // stream and the client drops the session with no useful error.
+    const toStderr = args.command === 'mcp';
+    const out = new Output({
+        write: (s) => void (toStderr ? process.stderr : process.stdout).write(s),
+        isTTY: Boolean(process.stdout.isTTY),
+        env: process.env,
+        verbose: args.bool('verbose'),
+        ci: args.bool('ci') || process.env.CI === 'true',
+        // `--no-color` parses to `color: false`. The `true` fallback is what separates that from an
+        // unset flag — `bool('color')` alone returns false for both, which would disable colour for
+        // everyone.
+        ...(args.bool('color', true) ? {} : { color: false }),
+    });
+    if (args.bool('version') || args.command === 'version') {
+        out.plain(ORCA_VERSION);
+        return 0;
+    }
+    if (args.command === 'help' || args.bool('help') || args.bool('h')) {
+        out.plain(HELP);
+        return 0;
+    }
+    try {
+        // Before anything runs: a flag the command does not have is an instruction that would be
+        // silently ignored, and a run that quietly did something else is the failure orca exists to
+        // surface. Inside the try so it is reported the same way every other failure is.
+        assertKnownFlags(args);
+        switch (args.command) {
+            case 'record':
+                return (await recordCommand(args, out, cwd)).exitCode;
+            case 'replay':
+                return (await replayCommand(args, out, cwd)).exitCode;
+            case 'compare':
+                await compareCommand(args, out, cwd);
+                return 0;
+            case 'show':
+                await showCommand(args, out, cwd);
+                return 0;
+            case 'checkpoints':
+                await checkpointsCommand(args, out, cwd);
+                return 0;
+            case 'graph':
+                await graphCommand(args, out, cwd);
+                return 0;
+            case 'export':
+                await exportCommand(args, out, cwd);
+                return 0;
+            case 'ui':
+                await uiCommand(args, out, cwd);
+                return 0;
+            case 'scrub':
+                await scrubCommand(args, out, cwd);
+                return 0;
+            case 'list':
+                await listCommand(args, out, cwd);
+                return 0;
+            case 'gc':
+                await gcCommand(args, out, cwd);
+                return 0;
+            case 'doctor':
+                // A failed check is the whole point of running this in CI, so it has to be visible in $?.
+                return (await doctorCommand(args, out, cwd)).ok ? 0 : 1;
+            case 'setup':
+                await setupCommand(args, out);
+                return 0;
+            case 'models':
+                await modelsCommand(args, out);
+                return 0;
+            case 'mcp':
+                // stdout is the transport here, so nothing else may touch it: `out` already writes to
+                // stderr under this command, and the server owns the stream until stdin closes.
+                await serveMcp({ orca: new Orca({ cwd }), input: process.stdin, output: process.stdout });
+                return 0;
+            default:
+                out.failure({
+                    event: 'unknown_command',
+                    what: `there is no "${args.command}" command`,
+                    next: 'orca help',
+                });
+                return 2;
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const [first, ...rest] = message.split('\n');
+        out.failure({
+            event: `${args.command}.failed`,
+            what: first ?? message,
+            why: rest.join('\n').trim() || undefined,
+        });
+        if (out.isVerbose && err instanceof Error && err.stack)
+            out.plain(err.stack);
+        return 1;
+    }
+}
+/**
+ * `--json`: one JSON document on stdout, diagnostics on stderr.
+ *
+ * The split is the whole design. A caller wants the answer, so stdout is one document rather than
+ * a stream of log objects — `orca show last --json | jq .events` works with nothing in front of
+ * it. And a run that warns must not corrupt that document, so every `info`/`warn` line goes to
+ * stderr, where a human still reads it and a parser never sees it.
+ *
+ * Failures come back as JSON too. An agent that only handles the happy path is an agent that
+ * hangs on the first bad run, so an error is a document with an `error` key and a non-zero exit,
+ * never prose.
+ */
+async function jsonMain(args, cwd) {
+    const out = new Output({
+        // Diagnostics only. Nothing here may reach stdout.
+        write: (s) => void process.stderr.write(s),
+        env: process.env,
+        verbose: args.bool('verbose'),
+        ci: true,
+        color: false,
+    });
+    const emit = (doc) => void process.stdout.write(`${JSON.stringify(doc)}\n`);
+    try {
+        const orca = new Orca({ cwd });
+        const selector = args.positionals[0] ?? 'last';
+        switch (args.command) {
+            case 'list':
+                emit(await orca.list());
+                return 0;
+            case 'show':
+                emit(await orca.show(selector));
+                return 0;
+            case 'events':
+                emit(await orca.events(selector));
+                return 0;
+            case 'checkpoints':
+                emit(await orca.checkpoints(selector));
+                return 0;
+            case 'graph':
+                emit(await orca.graph(selector, {
+                    ...(args.num('to') === undefined ? {} : { to: args.num('to') }),
+                }));
+                return 0;
+            case 'record': {
+                const result = await recordCommand(args, out, cwd);
+                emit(result);
+                return result.exitCode;
+            }
+            case 'replay': {
+                const result = await replayCommand(args, out, cwd);
+                emit(result);
+                return result.exitCode;
+            }
+            case 'compare':
+                emit(await compareCommand(args, out, cwd));
+                return 0;
+            case 'doctor': {
+                const result = await doctorCommand(args, out, cwd);
+                emit(result);
+                return result.ok ? 0 : 1;
+            }
+            default:
+                emit({
+                    error: {
+                        message: `--json does not cover '${args.command}'`,
+                        // Naming what it does cover beats making someone try them one at a time.
+                        supported: [
+                            'list',
+                            'show',
+                            'events',
+                            'checkpoints',
+                            'graph',
+                            'record',
+                            'replay',
+                            'compare',
+                            'doctor',
+                        ],
+                    },
+                });
+                return 2;
+        }
+    }
+    catch (err) {
+        emit({ error: { message: err instanceof Error ? err.message : String(err) } });
+        return 1;
+    }
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAmB,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,SAAS,GACV,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,IAAI,GAAG,QAAQ,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgFhC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAc,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAC5D,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAClD,4FAA4F;IAC5F,gEAAgE;IAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC;IACxC,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC;QACrB,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACxE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QACpC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;QAC7B,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM;QAChD,4FAA4F;QAC5F,4FAA4F;QAC5F,YAAY;QACZ,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;KACtD,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACvD,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACxB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC;QACH,yFAAyF;QACzF,4FAA4F;QAC5F,iFAAiF;QACjF,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAEvB,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;YACrB,KAAK,QAAQ;gBACX,OAAO,CAAC,MAAM,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;YACxD,KAAK,QAAQ;gBACX,OAAO,CAAC,MAAM,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;YACxD,KAAK,SAAS;gBACZ,MAAM,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBACrC,OAAO,CAAC,CAAC;YACX,KAAK,MAAM;gBACT,MAAM,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBAClC,OAAO,CAAC,CAAC;YACX,KAAK,aAAa;gBAChB,MAAM,kBAAkB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBACzC,OAAO,CAAC,CAAC;YACX,KAAK,OAAO;gBACV,MAAM,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBACnC,OAAO,CAAC,CAAC;YACX,KAAK,QAAQ;gBACX,MAAM,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBACpC,OAAO,CAAC,CAAC;YACX,KAAK,IAAI;gBACP,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBAChC,OAAO,CAAC,CAAC;YACX,KAAK,OAAO;gBACV,MAAM,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBACnC,OAAO,CAAC,CAAC;YACX,KAAK,MAAM;gBACT,MAAM,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBAClC,OAAO,CAAC,CAAC;YACX,KAAK,IAAI;gBACP,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBAChC,OAAO,CAAC,CAAC;YACX,KAAK,QAAQ;gBACX,0FAA0F;gBAC1F,OAAO,CAAC,MAAM,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1D,KAAK,OAAO;gBACV,MAAM,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC9B,OAAO,CAAC,CAAC;YACX,KAAK,QAAQ;gBACX,MAAM,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC/B,OAAO,CAAC,CAAC;YACX,KAAK,KAAK;gBACR,sFAAsF;gBACtF,gFAAgF;gBAChF,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC1F,OAAO,CAAC,CAAC;YACX;gBACE,GAAG,CAAC,OAAO,CAAC;oBACV,KAAK,EAAE,iBAAiB;oBACxB,IAAI,EAAE,gBAAgB,IAAI,CAAC,OAAO,WAAW;oBAC7C,IAAI,EAAE,WAAW;iBAClB,CAAC,CAAC;gBACH,OAAO,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,GAAG,CAAC,OAAO,CAAC;YACV,KAAK,EAAE,GAAG,IAAI,CAAC,OAAO,SAAS;YAC/B,IAAI,EAAE,KAAK,IAAI,OAAO;YACtB,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS;SACzC,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,KAAK;YAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC7E,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,KAAK,UAAU,QAAQ,CAAC,IAAgB,EAAE,GAAW;IACnD,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC;QACrB,mDAAmD;QACnD,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1C,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;QAC7B,EAAE,EAAE,IAAI;QACR,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,CAAC,GAAY,EAAQ,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAE3F,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;QAC/C,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;YACrB,KAAK,MAAM;gBACT,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACxB,OAAO,CAAC,CAAC;YACX,KAAK,MAAM;gBACT,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAChC,OAAO,CAAC,CAAC;YACX,KAAK,QAAQ;gBACX,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAClC,OAAO,CAAC,CAAC;YACX,KAAK,aAAa;gBAChB,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACvC,OAAO,CAAC,CAAC;YACX,KAAK,OAAO;gBACV,IAAI,CACF,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE;oBACzB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAE,EAAE,CAAC;iBACjE,CAAC,CACH,CAAC;gBACF,OAAO,CAAC,CAAC;YACX,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBACnD,IAAI,CAAC,MAAM,CAAC,CAAC;gBACb,OAAO,MAAM,CAAC,QAAQ,CAAC;YACzB,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBACnD,IAAI,CAAC,MAAM,CAAC,CAAC;gBACb,OAAO,MAAM,CAAC,QAAQ,CAAC;YACzB,CAAC;YACD,KAAK,SAAS;gBACZ,IAAI,CAAC,MAAM,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;gBAC3C,OAAO,CAAC,CAAC;YACX,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBACnD,IAAI,CAAC,MAAM,CAAC,CAAC;gBACb,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3B,CAAC;YACD;gBACE,IAAI,CAAC;oBACH,KAAK,EAAE;wBACL,OAAO,EAAE,0BAA0B,IAAI,CAAC,OAAO,GAAG;wBAClD,yEAAyE;wBACzE,SAAS,EAAE;4BACT,MAAM;4BACN,MAAM;4BACN,QAAQ;4BACR,aAAa;4BACb,OAAO;4BACP,QAAQ;4BACR,QAAQ;4BACR,SAAS;4BACT,QAAQ;yBACT;qBACF;iBACF,CAAC,CAAC;gBACH,OAAO,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/E,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/mcp-server.d.ts

@@ -0,0 +1,44 @@
+import type { Readable, Writable } from 'node:stream';
+import { Orca } from './api.js';
+export interface McpTool {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export declare const MCP_TOOLS: McpTool[];
+type JsonRpcId = string | number;
+interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: JsonRpcId;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+    };
+}
+/**
+ * Handle one message.
+ *
+ * Returns `undefined` for a notification, which by definition has no id to answer — replying to
+ * one is a protocol error that some clients treat as fatal.
+ */
+export declare function handleMcpMessage(orca: Orca, message: unknown): Promise<JsonRpcResponse | undefined>;
+export interface ServeMcpOptions {
+    orca: Orca;
+    input: Readable;
+    output: Writable;
+}
+/**
+ * Serve MCP over a stream pair until the input ends.
+ *
+ * Messages are handled one at a time. Concurrency would buy nothing — every tool here is either a
+ * file read or a subprocess that owns the working tree — and it would let two replays fight over
+ * the same checkout.
+ */
+export declare function serveMcp({ orca, input, output }: ServeMcpOptions): Promise<void>;
+export {};
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAyBhC,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAYD,eAAO,MAAM,SAAS,EAAE,OAAO,EAsF9B,CAAC;AAEF,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AASjC,UAAU,eAAe;IACvB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAiBD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CA4BtC;AA2ED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAWtF"}