agenticreplay 0.1.0 → 0.1.2

package/packages/cli/dist/commands/doctor.js

@@ -0,0 +1,402 @@
+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 '@agenticreplay/adapters';
+import { listRuns, agenticreplayDir } from '@agenticreplay/core';
+import { runGit } from '@agenticreplay/fs-capture';
+import { installShellShim, readShellFrames } from '@agenticreplay/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 = 24;
+const LOW_DISK_BYTES = 512 * 1024 * 1024;
+const BIG_STORE_BYTES = 1024 * 1024 * 1024;
+/**
+ * `agenticreplay doctor` — will recording actually work here?
+ *
+ * AgenticReplay 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 — agenticreplay 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 agenticreplay on node ${MIN_NODE_MAJOR} or newer`,
+        };
+    }
+    if (major < MIN_NODE_MAJOR) {
+        return {
+            name,
+            status: 'fail',
+            detail: `${version} — agenticreplay needs node ${MIN_NODE_MAJOR} or newer`,
+            fix: `install node ${MIN_NODE_MAJOR}+ (nvm install ${MIN_NODE_MAJOR}) and run agenticreplay 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(), 'agenticreplay-doctor-shim-'));
+    try {
+        // `framesPath` explicitly, so the frames land inside the directory this function already
+        // removes in its `finally`. Left to the default they would go to a transport of their own, which
+        // doctor has no teardown for — a check that leaks is a check nobody wants to run.
+        const shim = await installShellShim({
+            runDir: dir,
+            framesPath: join(dir, 'shell-frames.jsonl'),
+        });
+        // 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.
+        //
+        // Through the command processor on Windows, because that is the only way to reach the shim
+        // there. PATH cannot hold an extensionless script, so the shim is `sh.cmd` — and
+        // `execFile('sh', …)` goes to CreateProcess, which looks for `sh` and `sh.exe` and never
+        // `sh.cmd`. This check therefore walked past the shim to whichever `sh.exe` was further down
+        // PATH, found no frames, and told every Windows user that a working capture layer records
+        // nothing — advising them to turn it off with `--no-shell`. Naming `sh.cmd` directly is not
+        // the fix: node has refused to spawn a `.cmd` without a shell since CVE-2024-27980. The
+        // command processor is what resolves PATHEXT, so it is what has to do the resolving.
+        const env = { ...process.env, PATH: `${shim.dir}${delimiter}${process.env.PATH ?? ''}` };
+        const { stdout } = process.platform === 'win32'
+            ? await execFileAsync(process.env.ComSpec ?? 'cmd.exe', ['/d', '/s', '/c', 'sh', '-c', 'printf ok'], { env })
+            : await execFileAsync('sh', ['-c', 'printf ok'], { env });
+        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',
+            };
+        }
+        // WINDOWS: THE COMMAND PROCESSOR REACHES THE SHIM, AND AN AGENT STARTING ITS OWN SHELL DOES NOT.
+        //
+        // The probe above goes through cmd.exe because nothing else resolves PATHEXT, which makes it
+        // the one launch path certain to find `sh.cmd` — a probe that could only ever say yes. An agent
+        // that spawns `sh` or `bash` by name goes to CreateProcess, finds the real `sh.exe`, and is
+        // never seen: driven through `agenticreplay record`, `child_process.spawn('bash')` ran its commands and
+        // the trace held none of them, while this line said "captured a test command". record.ts
+        // already says as much of Claude Code, as `shell.ineffective`; this check did not.
+        //
+        // So both questions are asked, and the answer says which is true. A partial answer is a
+        // warning, not a failure — and not the advice to switch the layer off that this check gave
+        // before it learned to use cmd.exe, because a shell started through cmd or PowerShell IS
+        // captured.
+        if (process.platform === 'win32') {
+            await execFileAsync('sh', ['-c', 'printf ok'], { env }).catch(() => undefined);
+            if ((await readShellFrames(shim.framesPath)).length === frames.length) {
+                return {
+                    name,
+                    status: 'warn',
+                    detail: `${shim.shimmed.join(', ')} — captures a shell started through cmd.exe or PowerShell, not one an agent starts itself`,
+                    fix: 'Windows runs a .cmd only through a shell, so an agent that spawns sh or bash directly ' +
+                        '(Claude Code does) is not captured; agenticreplay record flags each such run as ' +
+                        'shell.ineffective — record those with --no-shell',
+                };
+            }
+        }
+        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. `.agenticreplay` 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 = '.agenticreplay writable';
+    const target = agenticreplayDir(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}; agenticreplay keeps every recorded run in it`,
+            },
+            probeDir: cwd,
+        };
+    }
+    const probeDir = info === null ? cwd : target;
+    const probe = join(probeDir, `.agenticreplay-doctor-${randomBytes(4).toString('hex')}.tmp`);
+    try {
+        await writeFile(probe, 'agenticreplay 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 agenticreplay from a directory you own`,
+            },
+            probeDir,
+        };
+    }
+    return {
+        check: {
+            name,
+            status: 'ok',
+            detail: info === null
+                ? `${probeDir} is writable (.agenticreplay 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: agenticreplay 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: 'agenticreplay 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 .agenticreplay lives`,
+                fix: 'free some space — one recorded run can reach tens of megabytes: agenticreplay 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: 'agenticreplay 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/packages/cli/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/packages/cli/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;
+/**
+ * `agenticreplay 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 `agenticreplay doctor`. */
+export declare function runDirBytes(dir: string): Promise<number>;
+export declare function formatBytes(bytes: number): string;
+//# sourceMappingURL=gc.d.ts.map

package/packages/cli/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,4FAA4F;AAC5F,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAY9D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUjD"}