orcareplay 0.1.0

package/dist/commands/compare.js

@@ -0,0 +1,182 @@
+import { TraceReader, deriveCheckpoints, resolveRunSelector } from '@orcareplay/core';
+import { priceFor } from '@orcareplay/providers';
+import { parseArgs } from '../args.js';
+import { writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { renderCompareCard } from '../share-card.js';
+import { cardTarget, svgToPng } from '../rasterize.js';
+import { replayCommand } from './replay.js';
+import { readConfig } from '../config.js';
+/** Run the verdict command inside the fork's worktree. Shell so `npm test -- auth` just works. */
+async function runVerify(command, cwd) {
+    const { spawn } = await import('node:child_process');
+    return new Promise((resolve) => {
+        const child = spawn(command, { cwd, shell: true, stdio: 'ignore' });
+        // A verify command that cannot even start is a failed verdict, not a crashed comparison.
+        child.on('error', () => resolve(127));
+        child.on('close', (code) => resolve(code ?? 1));
+    });
+}
+/** Each fork is a fresh argv, so upstream overrides have to be forwarded explicitly. */
+function upstreamFlags(args) {
+    const out = [];
+    const a = args.str('upstream-anthropic');
+    const o = args.str('upstream-openai');
+    if (a)
+        out.push('--upstream-anthropic', a);
+    if (o)
+        out.push('--upstream-openai', o);
+    return out;
+}
+/**
+ * `orca compare <run> --models a,b,c`
+ *
+ * N forks from one checkpoint. The comparison only means anything because every branch starts
+ * from an identical filesystem tree and conversation prefix — the model is the only variable, so
+ * the difference in outcome is attributable to it rather than to drift.
+ */
+export async function compareCommand(args, out, cwd = process.cwd()) {
+    // Fall back to what `orca setup` recorded, so the common case needs no flags at all. An explicit
+    // --models still wins: the config is a default, not a policy.
+    const models = args.list('models').length > 0 ? args.list('models') : ((await readConfig()).models ?? []);
+    if (models.length === 0) {
+        throw new Error('compare needs models to compare\n' +
+            // Not two example ids: they are gateway-specific — OrcaRouter namespaces by provider,
+            // a direct provider does not — so a copyable pair here fails against half of them.
+            '  orca models to see what your gateway serves, then: orca compare last --models a,b\n' +
+            '  or run orca setup once — it stores a gateway (OrcaRouter by default) and a model list');
+    }
+    const selector = args.positionals[0] ?? 'last';
+    const runDir = (await resolveRunSelector(cwd, selector)).dir;
+    const reader = await TraceReader.open(runDir);
+    const events = await reader.events();
+    const checkpoints = deriveCheckpoints(events);
+    if (checkpoints.length === 0) {
+        throw new Error('this run has no checkpoints, so there is nothing to fork from');
+    }
+    const from = args.num('from') ?? checkpoints[checkpoints.length - 1].seq;
+    const runId = reader.manifest().run_id;
+    out.phase('compare', { run: runId, from, models: models.join(',') });
+    const rows = [];
+    // Sequential rather than parallel: each fork spawns a real agent against a real worktree, and
+    // running four of those concurrently on one machine measures the machine, not the models.
+    for (const model of models) {
+        const startedAt = Date.now();
+        try {
+            const forkArgs = parseArgs([
+                'replay',
+                // The concrete run id, never the caller's selector. "last" is re-resolved on every fork,
+                // so after the first branch it would point at the child we just created — which has no
+                // checkpoints — and every later model would fail for a reason that is not about the model.
+                runId,
+                '--from',
+                String(from),
+                '--model',
+                model,
+                ...(args.bool('loose') ? ['--loose'] : []),
+                // Every fork this makes runs a live agent, so interception has to reach them: accepting
+                // the flag here and dropping it before the fork is exactly the silent-no-op the flag was
+                // fixed for one layer up.
+                ...(args.bool('tls-intercept') ? ['--tls-intercept'] : []),
+                // Same reasoning, and the same silent-no-op if dropped: every fork launches a live agent,
+                // and under --json orca's stdout is the result document. A fork that inherits it prints
+                // the agent's output into the middle of the JSON.
+                ...(args.bool('json') ? ['--json'] : []),
+                ...args.list('tls-hosts').flatMap((h) => ['--tls-hosts', h]),
+                ...upstreamFlags(args),
+            ]);
+            const result = await replayCommand(forkArgs, out, cwd);
+            // The agent exiting 0 only means it did not crash. "Did the task actually get done" needs
+            // a command that answers it — otherwise the verdict column is a number nobody should act on.
+            const verify = args.str('verify');
+            const verifyExitCode = verify && result.worktree ? await runVerify(verify, result.worktree) : undefined;
+            const failed = verifyExitCode === undefined ? result.exitCode !== 0 : verifyExitCode !== 0;
+            const usage = result.forkRunId
+                ? await usageOf(cwd, result.forkRunId)
+                : { input: 0, output: 0 };
+            const money = priceFor({ input_tokens: usage.input, output_tokens: usage.output }, model);
+            rows.push({
+                model,
+                verdict: failed ? 'fail' : 'pass',
+                verifyExitCode,
+                exitCode: result.exitCode,
+                divergences: result.divergences,
+                inputTokens: usage.input,
+                outputTokens: usage.output,
+                cost: money ? money.amount : null,
+                wallMs: Date.now() - startedAt,
+                forkRunId: result.forkRunId,
+            });
+        }
+        catch (err) {
+            rows.push({
+                model,
+                verdict: 'fail',
+                exitCode: -1,
+                divergences: 0,
+                inputTokens: 0,
+                outputTokens: 0,
+                cost: null,
+                wallMs: Date.now() - startedAt,
+                error: err instanceof Error ? err.message.split('\n')[0] : String(err),
+            });
+        }
+    }
+    out.plain('');
+    out.table(['MODEL', 'VERDICT', 'TOKENS', 'COST', 'WALL', 'RUN'], rows.map((r) => [
+        r.model,
+        r.verdict,
+        `${r.inputTokens}/${r.outputTokens}`,
+        // An unknown model prices as a dash, never as $0.00 — a confidently wrong cost is worse
+        // than an absent one when it lands in a table someone decides from. And a real cost too
+        // small for four decimals still gets shown: "cheaper" is the whole reason for this column.
+        formatCost(r.cost),
+        `${(r.wallMs / 1000).toFixed(1)}s`,
+        r.forkRunId ?? r.error ?? '',
+    ]));
+    if (args.has('share')) {
+        const picked = cardTarget(args.str('share') ?? 'compare.svg', '--share');
+        if (picked.format === 'gif') {
+            throw new Error('--share draws one table, so it has no animation. Use .svg or .png.');
+        }
+        const target = resolve(cwd, picked.path);
+        const svg = renderCompareCard(rows, {
+            runId,
+            forkPoint: from,
+            verify: args.str('verify'),
+        });
+        const body = picked.format === 'png' ? await svgToPng(svg) : svg;
+        await writeFile(target, body, { mode: 0o644 });
+        out.phase('shared', {
+            path: target,
+            bytes: typeof body === 'string' ? Buffer.byteLength(body) : body.length,
+            format: picked.format,
+        });
+    }
+    return rows;
+}
+/** Dash for unknown. Otherwise enough precision that a genuinely cheap model does not read $0. */
+export function formatCost(amount) {
+    if (amount === null)
+        return '—';
+    if (amount === 0)
+        return '$0';
+    if (amount < 0.0001)
+        return `$${amount.toExponential(2)}`;
+    if (amount < 0.01)
+        return `$${amount.toFixed(6)}`;
+    return `$${amount.toFixed(4)}`;
+}
+async function usageOf(cwd, runId) {
+    const reader = await TraceReader.open((await resolveRunSelector(cwd, runId)).dir);
+    let input = 0;
+    let output = 0;
+    for (const e of await reader.events()) {
+        if (e.type !== 'model.response')
+            continue;
+        input += Number(e.attrs?.input_tokens ?? 0);
+        output += Number(e.attrs?.output_tokens ?? 0);
+    }
+    return { input, output };
+}
+//# sourceMappingURL=compare.js.map

package/dist/commands/compare.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,24 @@
+import type { ParsedArgs } from '../args.js';
+import type { Output } from '../out.js';
+export interface DoctorCheck {
+    name: string;
+    status: 'ok' | 'warn' | 'fail';
+    detail: string;
+    /** What to do about it. Mandatory in spirit for anything that is not ok. */
+    fix?: string;
+}
+export interface DoctorResult {
+    checks: DoctorCheck[];
+    ok: boolean;
+}
+/**
+ * `orca doctor` — will recording actually work here?
+ *
+ * Orca instruments an agent by putting environment variables in front of someone else's process
+ * and shelling out to git. When that goes wrong the symptom appears inside the agent, minutes
+ * later, as something that looks like the agent's fault. Every check here is one of those failure
+ * modes, answered before the user spends an hour on it — so each is exercised for real (a port is
+ * actually bound, a file is actually written) rather than inferred.
+ */
+export declare function doctorCommand(args: ParsedArgs, out: Output, cwd?: string): Promise<DoctorResult>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAMxC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,EAAE,EAAE,OAAO,CAAC;CACb;AAMD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,MAAM,EACX,GAAG,SAAgB,GAClB,OAAO,CAAC,YAAY,CAAC,CAuCvB"}

package/dist/commands/doctor.js

@@ -0,0 +1,358 @@
+import { execFile } from 'node:child_process';
+import { randomBytes } from 'node:crypto';
+import { mkdtemp, rm, stat, unlink, writeFile } from 'node:fs/promises';
+// Namespaced as well as named, because `statfs` is not present on every supported node build and
+// a missing named import from a builtin is a load-time error for the whole CLI.
+import * as fsPromises from 'node:fs/promises';
+import { createServer } from 'node:net';
+import { tmpdir } from 'node:os';
+import { delimiter, dirname, join } from 'node:path';
+import { promisify } from 'node:util';
+import { defaultAdapters } from '@orcareplay/adapters';
+import { listRuns, orcaDir } from '@orcareplay/core';
+import { runGit } from '@orcareplay/fs-capture';
+import { installShellShim, readShellFrames } from '@orcareplay/shell-shim';
+import { RENDER_DEPS, missingRenderDeps } from '../rasterize.js';
+import { formatBytes, runDirBytes } from './gc.js';
+import { shimIsRunnable } from '../mcp.js';
+const execFileAsync = promisify(execFile);
+const MIN_NODE_MAJOR = 20;
+const LOW_DISK_BYTES = 512 * 1024 * 1024;
+const BIG_STORE_BYTES = 1024 * 1024 * 1024;
+/**
+ * `orca doctor` — will recording actually work here?
+ *
+ * Orca instruments an agent by putting environment variables in front of someone else's process
+ * and shelling out to git. When that goes wrong the symptom appears inside the agent, minutes
+ * later, as something that looks like the agent's fault. Every check here is one of those failure
+ * modes, answered before the user spends an hour on it — so each is exercised for real (a port is
+ * actually bound, a file is actually written) rather than inferred.
+ */
+export async function doctorCommand(args, out, cwd = process.cwd()) {
+    const git = await checkGit();
+    const writable = await checkWritable(cwd);
+    const checks = [
+        checkNode(),
+        git.check,
+        await checkWorkspace(cwd, git.available),
+        writable.check,
+        await checkAgents(cwd),
+        await checkPort(),
+        await checkShellShim(),
+        await checkMcpShim(),
+        await checkRasteriser(),
+        await checkDisk(writable.probeDir),
+        await checkRuns(cwd),
+    ];
+    const failed = checks.filter((c) => c.status === 'fail');
+    const warned = checks.filter((c) => c.status === 'warn');
+    const ok = failed.length === 0;
+    out.table(['CHECK', 'STATUS', 'DETAIL'], checks.map((c) => [c.name, c.status, c.detail]));
+    const trouble = [...failed, ...warned];
+    out.plain('');
+    if (trouble.length === 0) {
+        out.plain('  all clear — orca record <agent> should work here');
+    }
+    else {
+        for (const check of trouble) {
+            out.plain(`  ${check.status} ${check.name}: ${check.fix ?? check.detail}`);
+        }
+    }
+    out.phase('doctor', { ok, checks: checks.length, failed: failed.length, warned: warned.length });
+    return { checks, ok };
+}
+function checkNode() {
+    const name = 'node version';
+    // Read at call time, never cached: the running version is the thing under test.
+    const version = process.version;
+    const major = Number(/^v?(\d+)/.exec(version)?.[1] ?? Number.NaN);
+    if (Number.isNaN(major)) {
+        return {
+            name,
+            status: 'warn',
+            detail: `cannot read a major version from ${version}`,
+            fix: `run orca on node ${MIN_NODE_MAJOR} or newer`,
+        };
+    }
+    if (major < MIN_NODE_MAJOR) {
+        return {
+            name,
+            status: 'fail',
+            detail: `${version} — orca needs node ${MIN_NODE_MAJOR} or newer`,
+            fix: `install node ${MIN_NODE_MAJOR}+ (nvm install ${MIN_NODE_MAJOR}) and run orca doctor again`,
+        };
+    }
+    return { name, status: 'ok', detail: version };
+}
+/**
+ * Two capture layers that fail quietly.
+ *
+ * Both are shims — a PATH entry in front of `sh`/`bash`, and a rewritten MCP config launching a
+ * JSON-RPC tee. When either cannot start, nothing goes wrong that anybody sees: the agent runs
+ * perfectly, the run succeeds, and the trace is missing a layer, which you discover only when you
+ * go looking for an exit code or a tool call that was never recorded. That is exactly the class of
+ * failure `doctor` exists to move forward in time, so both are exercised for real rather than
+ * inferred from a file existing.
+ */
+async function checkShellShim() {
+    const name = 'shell shim';
+    const dir = await mkdtemp(join(tmpdir(), 'orca-doctor-shim-'));
+    try {
+        const shim = await installShellShim({ runDir: dir });
+        // Run something through it, rather than trusting that writing the scripts was enough: the
+        // failure this catches is the compiled runner being absent from an installed package.
+        const { stdout } = await execFileAsync('sh', ['-c', 'printf ok'], {
+            env: { ...process.env, PATH: `${shim.dir}${delimiter}${process.env.PATH ?? ''}` },
+        });
+        if (stdout.trim() !== 'ok') {
+            return {
+                name,
+                status: 'warn',
+                detail: `the shim ran but returned ${JSON.stringify(stdout)}`,
+                fix: 'record with --no-shell; exit codes and timing will be missing from the trace',
+            };
+        }
+        const frames = await readShellFrames(shim.framesPath);
+        if (frames.length === 0) {
+            return {
+                name,
+                status: 'warn',
+                detail: 'commands pass through but nothing is captured',
+                fix: 'record with --no-shell rather than trusting a layer that records nothing',
+            };
+        }
+        return { name, status: 'ok', detail: `${shim.shimmed.join(', ')} — captured a test command` };
+    }
+    catch (err) {
+        return {
+            name,
+            status: 'warn',
+            detail: String(err instanceof Error ? err.message : err).split('\n')[0] ?? 'unavailable',
+            fix: 'run `npm run build` if working from source, or record with --no-shell',
+        };
+    }
+    finally {
+        await rm(dir, { recursive: true, force: true });
+    }
+}
+async function checkMcpShim() {
+    const name = 'mcp shim';
+    const runnable = await shimIsRunnable();
+    return runnable
+        ? { name, status: 'ok', detail: 'runnable — pass --mcp-config <path> to use it' }
+        : {
+            name,
+            status: 'warn',
+            detail: 'the shim entry point cannot be launched',
+            fix: 'run `npm run build` if working from source; MCP calls will not be captured without it',
+        };
+}
+/** Through fs-capture's own runner, so this tests the git invocation recording will really make. */
+/**
+ * Whether a card can be written as a PNG or a GIF.
+ *
+ * Never a failure. The raster toolchain is optional by design — `docs/media/README.md` keeps it
+ * out of `package.json` so `npm ci` stays lean — and recording, replaying and SVG cards all work
+ * without it. Reporting it is how someone finds out before they need it rather than at the moment
+ * they ask for a `.png`.
+ */
+async function checkRasteriser() {
+    const name = 'card rasteriser';
+    const missing = await missingRenderDeps();
+    return missing.length === 0
+        ? { name, status: 'ok', detail: 'installed — cards can be written as .svg, .png or .gif' }
+        : {
+            name,
+            status: 'ok',
+            detail: 'not installed — cards can be written as .svg',
+            fix: `npm i --no-save ${RENDER_DEPS.join(' ')} to also write .png and .gif`,
+        };
+}
+async function checkGit() {
+    const name = 'git';
+    const res = await runGit(['--version']);
+    if (res.code === 0 && res.stdout.startsWith('git version')) {
+        return { check: { name, status: 'ok', detail: res.stdout.trim() }, available: true };
+    }
+    return {
+        check: {
+            name,
+            status: 'warn',
+            detail: 'not runnable here — filesystem capture and forked worktrees will be off',
+            fix: 'install git to get fs snapshots and checkpoints; otherwise record with --no-fs',
+        },
+        available: false,
+    };
+}
+async function checkWorkspace(cwd, gitAvailable) {
+    const name = 'git workspace';
+    const fix = 'git init here, or record from your project root — fs diffs are far more useful in a repo';
+    if (gitAvailable) {
+        const res = await runGit(['rev-parse', '--show-toplevel'], { cwd });
+        if (res.code === 0 && res.stdout.trim() !== '') {
+            return { name, status: 'ok', detail: res.stdout.trim() };
+        }
+        return { name, status: 'warn', detail: `${cwd} is not inside a git repo`, fix };
+    }
+    // Without git, answer the question from the filesystem rather than declining to answer it.
+    const root = await findRepoRoot(cwd);
+    return root === undefined
+        ? { name, status: 'warn', detail: `${cwd} is not inside a git repo`, fix }
+        : { name, status: 'ok', detail: `${root} (found by .git; git itself is not runnable)` };
+}
+/**
+ * Writes a real file and removes it. `.orca` is created lazily by `record`, so when it does not
+ * exist yet the directory that will have to hold it is what gets probed — and nothing is created.
+ */
+async function checkWritable(cwd) {
+    const name = '.orca writable';
+    const target = orcaDir(cwd);
+    const info = await stat(target).catch(() => null);
+    if (info !== null && !info.isDirectory()) {
+        return {
+            check: {
+                name,
+                status: 'fail',
+                detail: `${target} exists but is not a directory`,
+                fix: `move or remove ${target}; orca keeps every recorded run in it`,
+            },
+            probeDir: cwd,
+        };
+    }
+    const probeDir = info === null ? cwd : target;
+    const probe = join(probeDir, `.orca-doctor-${randomBytes(4).toString('hex')}.tmp`);
+    try {
+        await writeFile(probe, 'orca doctor', { mode: 0o600 });
+        await unlink(probe);
+    }
+    catch (err) {
+        return {
+            check: {
+                name,
+                status: 'fail',
+                detail: `cannot write and clean up a file in ${probeDir}: ${messageOf(err)}`,
+                fix: `make ${probeDir} writable, or run orca from a directory you own`,
+            },
+            probeDir,
+        };
+    }
+    return {
+        check: {
+            name,
+            status: 'ok',
+            detail: info === null ? `${probeDir} is writable (.orca not created yet)` : `${target} is writable`,
+        },
+        probeDir,
+    };
+}
+async function checkAgents(cwd) {
+    const name = 'agents detected';
+    const registry = defaultAdapters();
+    const found = [];
+    for (const id of registry.ids()) {
+        try {
+            if (await registry.get(id).detect(cwd))
+                found.push(id);
+        }
+        catch {
+            // A detector that throws is a "no"; it must never take the diagnosis down with it.
+        }
+    }
+    if (found.length === 0) {
+        return {
+            name,
+            status: 'warn',
+            detail: 'none of the known agents were found on PATH or in this workspace',
+            fix: 'name the agent explicitly, or record any OpenAI-compatible one: orca record generic-openai -- <command>',
+        };
+    }
+    return { name, status: 'ok', detail: found.join(', ') };
+}
+async function checkPort() {
+    const name = 'proxy port';
+    try {
+        const port = await bindEphemeral();
+        return { name, status: 'ok', detail: `bound 127.0.0.1:${port}, then released it` };
+    }
+    catch (err) {
+        return {
+            name,
+            status: 'fail',
+            detail: `cannot bind a loopback port: ${messageOf(err)}`,
+            fix: 'orca records by proxying model traffic through 127.0.0.1 — allow loopback listeners (sandbox or firewall policy) before recording',
+        };
+    }
+}
+function bindEphemeral() {
+    return new Promise((resolve, reject) => {
+        const server = createServer();
+        server.once('error', reject);
+        server.listen(0, '127.0.0.1', () => {
+            const address = server.address();
+            const port = typeof address === 'object' && address !== null ? address.port : 0;
+            server.close(() => {
+                if (port > 0)
+                    resolve(port);
+                else
+                    reject(new Error('listening socket reported no port'));
+            });
+        });
+    });
+}
+async function checkDisk(probeDir) {
+    const name = 'disk space';
+    if (typeof fsPromises.statfs !== 'function') {
+        return { name, status: 'ok', detail: 'skipped — statfs is unavailable on this node build' };
+    }
+    try {
+        const fs = await fsPromises.statfs(probeDir);
+        const free = Number(fs.bavail) * Number(fs.bsize);
+        if (free < LOW_DISK_BYTES) {
+            return {
+                name,
+                status: 'warn',
+                detail: `${formatBytes(free)} free where .orca lives`,
+                fix: 'free some space — one recorded run can reach tens of megabytes: orca gc --older-than 7d',
+            };
+        }
+        return { name, status: 'ok', detail: `${formatBytes(free)} free` };
+    }
+    catch (err) {
+        return { name, status: 'ok', detail: `skipped — statfs failed: ${messageOf(err)}` };
+    }
+}
+async function checkRuns(cwd) {
+    const name = 'existing runs';
+    const runs = await listRuns(cwd);
+    if (runs.length === 0)
+        return { name, status: 'ok', detail: 'none recorded here yet' };
+    let bytes = 0;
+    for (const run of runs)
+        bytes += await runDirBytes(run.dir);
+    const detail = `${runs.length} run${runs.length === 1 ? '' : 's'}, ${formatBytes(bytes)}`;
+    if (bytes > BIG_STORE_BYTES) {
+        return {
+            name,
+            status: 'warn',
+            detail,
+            fix: 'orca gc --keep 20 --dry-run shows what could be reclaimed',
+        };
+    }
+    return { name, status: 'ok', detail };
+}
+async function findRepoRoot(from) {
+    let dir = from;
+    for (;;) {
+        const found = await stat(join(dir, '.git')).then(() => true, () => false);
+        if (found)
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+function messageOf(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/gc.d.ts

@@ -0,0 +1,24 @@
+import type { ParsedArgs } from '../args.js';
+import type { Output } from '../out.js';
+export interface GcResult {
+    runsRemoved: number;
+    /** Scratch fork worktrees reclaimed alongside their runs. */
+    worktreesRemoved: number;
+    blobsRemoved: number;
+    bytesReclaimed: number;
+}
+/** Milliseconds for `7d`, `24h`, `30m`; null for anything it will not guess at. */
+export declare function parseDuration(text: string): number | null;
+/**
+ * `orca gc` — reclaim the space a trace store grows into.
+ *
+ * A run is append-only and content-addressed, so nothing inside one grows unboundedly. What grows
+ * is the number of runs, and the blobs left behind when a run died between writing a payload and
+ * writing the event that referenced it. Removing runs is therefore opt-in: with no retention flag
+ * this only sweeps that debris and reports what it would take if asked.
+ */
+export declare function gcCommand(args: ParsedArgs, out: Output, cwd?: string): Promise<GcResult>;
+/** Every byte of file content under a run directory. Shared with `orca doctor`. */
+export declare function runDirBytes(dir: string): Promise<number>;
+export declare function formatBytes(bytes: number): string;
+//# sourceMappingURL=gc.d.ts.map

package/dist/commands/gc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gc.d.ts","sourceRoot":"","sources":["../../src/commands/gc.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAcD,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMzD;AAuBD;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,MAAM,EACX,GAAG,SAAgB,GAClB,OAAO,CAAC,QAAQ,CAAC,CAyHnB;AA0JD,mFAAmF;AACnF,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAY9D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUjD"}