autor3search-typescript 0.1.0

package/dist/benchrun/invoke.js

@@ -0,0 +1,152 @@
+/**
+ * Spawns the measurement child (child.ts / child.js) for one benchmark in
+ * one directory, and turns its outcome into a `BenchResult` that never
+ * throws for a benchmark-level failure -- a timeout, a crash, or a child
+ * that writes nothing is reported as `ok: false` with a diagnosis, because
+ * the pipeline treats that as a CRASH verdict for the benchmark rather than
+ * a harness bug.
+ */
+import { existsSync } from 'node:fs';
+import { mkdtemp, readFile, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { createRequire } from 'node:module';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { parseBenchResult } from '../benchproto/types.js';
+import { run, tail } from '../runner/exec.js';
+const require = createRequire(import.meta.url);
+const HERE = path.dirname(fileURLToPath(import.meta.url));
+/**
+ * Picks the measurement child from a directory, preferring the built
+ * `child.js` and falling back to the source `child.ts`.
+ *
+ * Under a real install (`dist/`), only `child.js` exists next to this
+ * module -- that is the branch that actually runs for an installed user.
+ * Under Vitest, `import.meta.url` resolves to `src/benchrun/invoke.ts`,
+ * where only `child.ts` exists -- there is no build step before the test
+ * run. Either way the spawn below runs through the tsx loader, so a `.ts`
+ * path works identically to a `.js` one; this just picks whichever file is
+ * actually on disk.
+ *
+ * Pulled apart from `resolveChild` (a thin wrapper below) so both branches
+ * can be exercised directly with an injected existence check, since only
+ * one of the two ever exists in any single checkout.
+ */
+export function pickChildPath(dir, exists) {
+    const asJs = path.join(dir, 'child.js');
+    if (exists(asJs))
+        return asJs;
+    return path.join(dir, 'child.ts');
+}
+function resolveChild() {
+    return pickChildPath(HERE, existsSync);
+}
+export const CHILD = resolveChild();
+/**
+ * The tsx ESM loader, resolved from OUR dependencies.
+ *
+ * The measured repository does not depend on us, so resolving this relative
+ * to the measured directory would work in our own fixtures and fail on
+ * every real user's repository. Resolving it here, from this module's own
+ * `import.meta.url`, always finds it in *our* node_modules regardless of
+ * what (if anything) the measured directory contains.
+ */
+function tsxLoaderUrl() {
+    return pathToFileURL(require.resolve('tsx/esm')).href;
+}
+/**
+ * Arbitrary throw values (a non-`Error`, or a `JSON.parse` `SyntaxError`)
+ * both need a printable message; this mirrors the same helper in child.ts.
+ */
+function messageOf(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+/**
+ * Reads and parses the child's `--out` file, turning every failure mode
+ * into `{ ok: false }` instead of a rejection: a missing file (the child
+ * died before writing at all) and a present-but-malformed one (the file
+ * exists but doesn't parse, or doesn't have the right shape).
+ *
+ * The malformed case is not exotic: our own timeout path kills the child's
+ * process group with SIGKILL, which can land mid-`writeFile`, leaving a
+ * truncated-but-readable JSON document on disk. `readFile` succeeds on
+ * that; only `JSON.parse`/`parseBenchResult` would have caught it, and
+ * uncaught, that throw would have propagated out of `runChild` as a
+ * rejected promise -- exactly the "harness bug" failure mode `runChild`
+ * exists to avoid for a benchmark-level failure.
+ *
+ * Exported for testing: it lets a test write deliberately truncated JSON
+ * to a real, controlled `--out` path and assert `ok: false` directly,
+ * without needing to race a real subprocess's SIGKILL against its own
+ * `writeFile` to reproduce the truncation.
+ */
+export async function readChildResult(outFile, id, r, timeoutMs) {
+    let text;
+    try {
+        text = await readFile(outFile, 'utf8');
+    }
+    catch {
+        // The child died before writing. Its own stderr is the useful diagnosis.
+        const why = r.timedOut ? `timed out after ${timeoutMs}ms` : `exit ${r.exitCode}`;
+        return { ok: false, id, error: `benchmark child ${why}: ${tail(r.stderr, 20)}` };
+    }
+    try {
+        return parseBenchResult(text);
+    }
+    catch (e) {
+        return { ok: false, id, error: `malformed benchmark result: ${messageOf(e)}` };
+    }
+}
+/**
+ * Runs one benchmark, once, in a fresh child process.
+ *
+ * Never rejects for a benchmark-level failure: a timeout, a crash, or a
+ * child that exits without writing --out all come back as `{ ok: false }`
+ * with a diagnosis built from the child's own stderr, so a caller can
+ * record a CRASH verdict instead of aborting the whole run.
+ */
+export async function runChild(o) {
+    const dir = await mkdtemp(path.join(tmpdir(), 'ars-out-'));
+    const outFile = path.join(dir, 'result.json');
+    try {
+        const args = [
+            ...o.nodeArgs,
+            '--import',
+            tsxLoaderUrl(),
+            CHILD,
+            '--file',
+            o.benchFileAbs,
+            '--fn',
+            o.fn,
+            '--id',
+            o.id,
+            '--benchtime-ms',
+            String(o.benchtimeMs),
+            '--warmup-ms',
+            String(o.warmupMs),
+            '--out',
+            outFile,
+        ];
+        const r = await run(process.execPath, args, {
+            cwd: o.cwd,
+            timeoutMs: o.timeoutMs,
+            ...(o.log ? { log: o.log } : {}),
+        });
+        return await readChildResult(outFile, o.id, r, o.timeoutMs);
+    }
+    finally {
+        // A failure here (permissions, an EBUSY-like transient on some
+        // platform) must never replace a result the try block already
+        // produced -- losing a computed measurement is strictly worse than
+        // leaking a temp directory, so the cleanup failure is swallowed rather
+        // than left to propagate out of `finally` and clobber the return value
+        // (or the rejection) above.
+        try {
+            await rm(dir, { recursive: true, force: true });
+        }
+        catch {
+            /* leak the directory rather than discard the result */
+        }
+    }
+}
+//# sourceMappingURL=invoke.js.map

package/dist/benchrun/invoke.js.map

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

package/dist/cli/cmd-baseline.d.ts

@@ -0,0 +1,15 @@
+import type { RunCtx } from './runctx.js';
+/**
+ * `baseline`: freezes the tests and benchmarks, creates the run branch,
+ * pins a detached worktree at HEAD, installs into it, and PROVES the
+ * declared benchmarks actually run there before declaring success.
+ *
+ * Every refusal below (bad flags, an unclean tree, a reused tag, a
+ * benchmark declared in config that no longer exists) happens before the
+ * run branch is created and before anything is written to the state
+ * directory. Everything after `createBranch` is a mutation, and any
+ * failure there is unwound: the worktree is removed, the run directory is
+ * deleted, and -- per Ruling 3 -- so is the branch, so a retry with the
+ * same tag never needs `-force`.
+ */
+export declare function cmdBaseline(ctx: RunCtx, argv: readonly string[]): Promise<number>;

package/dist/cli/cmd-baseline.js

@@ -0,0 +1,292 @@
+import { access, readFile, rm } from 'node:fs/promises';
+import path from 'node:path';
+import { parseArgs } from 'node:util';
+import { runChild } from '../benchrun/invoke.js';
+import { loadConfig, parseDuration } from '../config/load.js';
+import { CONFIG_PATH } from '../config/schema.js';
+import { discoverBenchmarks } from '../discover/benchmarks.js';
+import { freezableFiles } from '../discover/files.js';
+import { snapshot } from '../freeze/freeze.js';
+import { hashString } from '../freeze/manifest.js';
+import { addWorktree, branchExists, changedFiles, createBranch, currentBranch, deleteBranch, headCommit, removeWorktree, } from '../gitx/git.js';
+import { detect } from '../pm/detect.js';
+import { ok, run, runShell, tail } from '../runner/exec.js';
+import { writeBaseline } from '../state/baseline.js';
+import { runDir } from '../state/home.js';
+import { BRANCH_PREFIX, FROZEN_DIRNAME, WORKTREE_DIRNAME } from '../state/runnaming.js';
+const CHECKOUT_TIMEOUT_MS = 60_000;
+/**
+ * Duration of the smoke measurement run in the worktree. This is
+ * deliberately tiny: the point of this run is to prove each benchmark
+ * imports and executes without throwing, not to produce a usable
+ * measurement -- that is what `eval` (task 19) actually measures, against
+ * the config's own `benchtime`.
+ */
+const SMOKE_BENCHTIME_MS = 20;
+const SMOKE_WARMUP_MS = 0;
+function fail(message) {
+    process.stderr.write(`error: ${message}\n`);
+    return 2;
+}
+function messageOf(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+async function exists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Checks out `ref` in the main repository (not a worktree). None of the
+ * already-built `gitx` helpers do this directly: `createBranch` always
+ * creates a new branch, and `repointWorktree` operates on a worktree's own
+ * checkout, not the main repo's. This is only ever used to move the main
+ * repo's checkout OFF the run branch before that branch is deleted --
+ * `git branch -D` refuses to delete the branch currently checked out.
+ */
+async function checkoutRef(root, ref) {
+    const r = await run('git', ['checkout', '-q', ref], { cwd: root, timeoutMs: CHECKOUT_TIMEOUT_MS });
+    if (!ok(r)) {
+        throw new Error(`git checkout ${ref} failed in ${root} (exit ${r.exitCode}): ${r.stderr.trim()}`);
+    }
+}
+/** Declared benchmark ids that are not among the discovered benchmarks. */
+function missingDeclared(declared, discovered) {
+    const found = new Set(discovered.map((b) => b.id));
+    return declared.filter((id) => !found.has(id));
+}
+/**
+ * `baseline`: freezes the tests and benchmarks, creates the run branch,
+ * pins a detached worktree at HEAD, installs into it, and PROVES the
+ * declared benchmarks actually run there before declaring success.
+ *
+ * Every refusal below (bad flags, an unclean tree, a reused tag, a
+ * benchmark declared in config that no longer exists) happens before the
+ * run branch is created and before anything is written to the state
+ * directory. Everything after `createBranch` is a mutation, and any
+ * failure there is unwound: the worktree is removed, the run directory is
+ * deleted, and -- per Ruling 3 -- so is the branch, so a retry with the
+ * same tag never needs `-force`.
+ */
+export async function cmdBaseline(ctx, argv) {
+    let tag;
+    let force;
+    try {
+        const normalized = argv.map((a) => (/^-[A-Za-z][A-Za-z-]+$/.test(a) ? `-${a}` : a));
+        const { values } = parseArgs({
+            args: normalized,
+            options: {
+                tag: { type: 'string' },
+                force: { type: 'boolean', default: false },
+            },
+            strict: true,
+            allowPositionals: false,
+        });
+        if (typeof values.tag !== 'string' || values.tag === '') {
+            return fail('-tag <tag> is required, e.g. -tag sep6');
+        }
+        tag = values.tag;
+        force = values.force === true;
+    }
+    catch (e) {
+        return fail(messageOf(e));
+    }
+    try {
+        // Validates the tag (it becomes a directory name) before anything else
+        // runs -- an invalid tag must be refused before any git or filesystem
+        // mutation, not discovered midway through one.
+        const dir = runDir(ctx.repoRoot, tag);
+        const branchName = `${BRANCH_PREFIX}${tag}`;
+        const detected = await detect(ctx.repoRoot);
+        const config = await loadConfig(ctx.configPath);
+        // Deliberately `changedFiles(repoRoot, HEAD)` rather than `isClean`
+        // (`git status --porcelain`): `isClean` trusts whatever `.gitignore` is
+        // on disk, including one the agent just wrote -- the same blind spot
+        // fixed in `pipeline/eval.ts` gate 8, and for the identical reason. A
+        // baseline pinned while an agent-hidden, uncommitted file sits on disk
+        // is exactly as unreproducible as one pinned with any other uncommitted
+        // change; `changedFiles` (Priority 2's ignore-immune enumeration) is
+        // what actually proves nothing on disk differs from HEAD.
+        const headBeforeBaseline = await headCommit(ctx.repoRoot);
+        if ((await changedFiles(ctx.repoRoot, headBeforeBaseline)).length > 0) {
+            return fail('the working tree is not clean (uncommitted changes or untracked files). A baseline ' +
+                'pinned to what is on disk rather than what is committed could not be reproduced by ' +
+                'anyone else, including a retry on this same machine after those files are gone. ' +
+                'Commit or stash your changes and try again.');
+        }
+        if (await exists(dir)) {
+            if (!force) {
+                return fail(`a baseline for tag ${JSON.stringify(tag)} already exists at ${dir}; pass -force to replace it`);
+            }
+            // With -force, tear down whatever the earlier run left behind before
+            // anything new is created: removeWorktree first, or git keeps a
+            // stale worktree registration and addWorktree below fails.
+            const worktreeDir = path.join(dir, WORKTREE_DIRNAME);
+            if (await exists(worktreeDir)) {
+                try {
+                    await removeWorktree(ctx.repoRoot, worktreeDir);
+                }
+                catch {
+                    // Not a registered worktree (e.g. a previous attempt failed
+                    // before addWorktree ran) -- the rm below still removes it from
+                    // disk either way.
+                }
+            }
+            await rm(dir, { recursive: true, force: true });
+        }
+        const discovered = await discoverBenchmarks(ctx.repoRoot);
+        const declared = config.benchmarks;
+        let benchmarks;
+        if (declared.length > 0) {
+            const missing = missingDeclared(declared, discovered);
+            if (missing.length > 0) {
+                return fail(`config declares benchmark(s) that no longer exist: ${missing.join(', ')}. Update ` +
+                    `${CONFIG_PATH} or restore the missing benchmark(s).`);
+            }
+            const byId = new Map(discovered.map((b) => [b.id, b]));
+            benchmarks = declared.map((id) => byId.get(id));
+        }
+        else {
+            benchmarks = discovered;
+        }
+        if (benchmarks.length === 0) {
+            return fail('no benchmarks found: there is nothing for this baseline to measure');
+        }
+        // Everything above is a pure refusal: nothing has been created or
+        // written, in git or on disk, past this point.
+        const originalBranch = await currentBranch(ctx.repoRoot);
+        const originalCommit = await headCommit(ctx.repoRoot);
+        const fallbackRef = originalBranch === 'HEAD' ? originalCommit : originalBranch;
+        // A branch of this name can already exist here for two different
+        // reasons, which need two different responses:
+        //
+        // - The repo is ALREADY checked out on it: this is a `-force` re-run
+        //   of a tag whose previous baseline succeeded (a successful run never
+        //   switches away from the branch it creates). There is nothing to
+        //   recreate -- proceed with the existing checkout, at whatever commit
+        //   it is already on.
+        // - It exists but is checked out nowhere here (a stale branch left
+        //   over some other way): safe to delete outright, with no need to
+        //   check out away from it first, and recreate fresh below.
+        //
+        // `createdBranch` records whether THIS invocation is the one that
+        // created the branch -- only then does the unwind below delete it
+        // (Ruling 3): a branch this invocation merely reused on `-force` was
+        // not this run's to destroy on failure.
+        let createdBranch = false;
+        if (await branchExists(ctx.repoRoot, branchName)) {
+            if (originalBranch !== branchName) {
+                await deleteBranch(ctx.repoRoot, branchName);
+                await createBranch(ctx.repoRoot, branchName);
+                createdBranch = true;
+            }
+        }
+        else {
+            await createBranch(ctx.repoRoot, branchName);
+            createdBranch = true;
+        }
+        const worktreeDir = path.join(dir, WORKTREE_DIRNAME);
+        const frozenDir = path.join(dir, FROZEN_DIRNAME);
+        let worktreeAdded = false;
+        try {
+            const head = await headCommit(ctx.repoRoot);
+            // `config.unfreeze` names test/bench files deliberately exempted from
+            // the freeze (see `renderConfigYaml`'s own comment on the key, and
+            // spec section 6) -- they must never be snapshotted or hashed into the
+            // manifest in the first place, or gate 3's restore would overwrite the
+            // agent's edits to them on every eval regardless of this config.
+            const unfreeze = new Set(config.unfreeze);
+            const freezable = (await freezableFiles(ctx.repoRoot)).filter((f) => !unfreeze.has(f));
+            const manifest = await snapshot(ctx.repoRoot, freezable, frozenDir);
+            await addWorktree(ctx.repoRoot, worktreeDir, head);
+            worktreeAdded = true;
+            const timeoutMs = parseDuration(config.timeout);
+            const install = await runShell(detected.installCommand, { cwd: worktreeDir, timeoutMs });
+            if (!ok(install)) {
+                throw new Error(`installing dependencies in the worktree failed (${detected.installCommand}, exit ` +
+                    `${install.exitCode}): ${tail(install.stderr || install.stdout, 40)}`);
+            }
+            // The smoke run: prove every declared benchmark actually runs in the
+            // worktree before this baseline is declared successful. Without
+            // this, a benchmark that cannot execute would produce a "successful"
+            // baseline and fail mysteriously at the user's first `eval`.
+            for (const b of benchmarks) {
+                const result = await runChild({
+                    cwd: worktreeDir,
+                    benchFileAbs: path.join(worktreeDir, b.file),
+                    fn: b.fn,
+                    id: b.id,
+                    benchtimeMs: SMOKE_BENCHTIME_MS,
+                    warmupMs: SMOKE_WARMUP_MS,
+                    timeoutMs,
+                    nodeArgs: config.nodeArgs,
+                });
+                if (!result.ok) {
+                    throw new Error(`smoke run of ${b.id} failed: ${result.error}`);
+                }
+            }
+            const configText = await readFile(ctx.configPath, 'utf8');
+            const lockfileText = await readFile(path.join(ctx.repoRoot, detected.lockfile), 'utf8');
+            const record = {
+                tag,
+                // frozenCommit and measureCommit both start at HEAD, identically --
+                // measureCommit is the only one of the two that ever advances
+                // (after a KEEP), and frozenCommit must never move once set.
+                frozenCommit: head,
+                measureCommit: head,
+                configHash: hashString(configText),
+                lockfileHash: hashString(lockfileText),
+                lockfileName: detected.lockfile,
+                benchmarks: benchmarks.map((b) => b.id),
+                manifest,
+                createdAt: new Date().toISOString(),
+            };
+            await writeBaseline(dir, record);
+            process.stdout.write(`baseline ${JSON.stringify(tag)} created at ${head.slice(0, 7)}\n`);
+            process.stdout.write(`  branch:   ${branchName}\n`);
+            process.stdout.write(`  worktree: ${worktreeDir}\n`);
+            process.stdout.write(`  state:    ${dir}\n`);
+            process.stdout.write('  benchmarks smoke-tested:\n');
+            for (const b of benchmarks)
+                process.stdout.write(`    - ${b.id}\n`);
+            return 0;
+        }
+        catch (e) {
+            const reason = messageOf(e);
+            if (worktreeAdded) {
+                try {
+                    await removeWorktree(ctx.repoRoot, worktreeDir);
+                }
+                catch {
+                    // Best effort -- the directory removal below still gets rid of
+                    // it on disk even if git's own bookkeeping is left stale.
+                }
+            }
+            await rm(dir, { recursive: true, force: true });
+            try {
+                // Only ever delete a branch THIS invocation created (Ruling 3) --
+                // one it merely reused under `-force` was not this run's to
+                // destroy on failure.
+                if (createdBranch) {
+                    if ((await currentBranch(ctx.repoRoot)) === branchName) {
+                        await checkoutRef(ctx.repoRoot, fallbackRef);
+                    }
+                    await deleteBranch(ctx.repoRoot, branchName);
+                }
+            }
+            catch (unwindErr) {
+                return fail(`${reason}\n(cleanup also failed to delete branch ${branchName}: ` +
+                    `${messageOf(unwindErr)}; remove it manually with "git branch -D ${branchName}" before retrying)`);
+            }
+            return fail(reason);
+        }
+    }
+    catch (e) {
+        return fail(messageOf(e));
+    }
+}
+//# sourceMappingURL=cmd-baseline.js.map

package/dist/cli/cmd-baseline.js.map

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

package/dist/cli/cmd-doctor.d.ts

@@ -0,0 +1,11 @@
+import type { RunCtx } from './runctx.js';
+/**
+ * Reports whether this machine can measure reliably: informational only.
+ *
+ * `doctor` deliberately always returns 0, regardless of how many checks
+ * fail. Every other command's exit code carries a verdict the harness or
+ * a script may act on; this one does not -- it exists to be run before
+ * trusting an overnight run's numbers, and a diagnostic that blocks the
+ * next step is a diagnostic people stop running.
+ */
+export declare function cmdDoctor(_ctx: RunCtx, _argv: string[]): Promise<number>;

package/dist/cli/cmd-doctor.js

@@ -0,0 +1,26 @@
+import { runChecks } from '../doctor/doctor.js';
+/**
+ * Reports whether this machine can measure reliably: informational only.
+ *
+ * `doctor` deliberately always returns 0, regardless of how many checks
+ * fail. Every other command's exit code carries a verdict the harness or
+ * a script may act on; this one does not -- it exists to be run before
+ * trusting an overnight run's numbers, and a diagnostic that blocks the
+ * next step is a diagnostic people stop running.
+ */
+export async function cmdDoctor(_ctx, _argv) {
+    const checks = await runChecks();
+    process.stdout.write('autor3search-typescript doctor -- can this machine measure reliably?\n\n');
+    for (const c of checks) {
+        const mark = c.ok ? 'OK  ' : 'WARN';
+        process.stdout.write(`[${mark}] ${c.name}: ${c.detail}\n`);
+    }
+    const warnings = checks.filter((c) => !c.ok).length;
+    process.stdout.write('\n');
+    process.stdout.write(warnings === 0
+        ? 'No issues found.\n'
+        : `${warnings} check(s) flagged above -- address what you can before an overnight run.\n`);
+    process.stdout.write('This command is informational only and always exits 0.\n');
+    return 0;
+}
+//# sourceMappingURL=cmd-doctor.js.map

package/dist/cli/cmd-doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmd-doctor.js","sourceRoot":"","sources":["../../src/cli/cmd-doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAG/C;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,KAAe;IAC3D,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAA;IAEhC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0EAA0E,CAAC,CAAA;IAChG,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAA;QACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAA;IAC5D,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAA;IACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,QAAQ,KAAK,CAAC;QACZ,CAAC,CAAC,oBAAoB;QACtB,CAAC,CAAC,GAAG,QAAQ,4EAA4E,CAC5F,CAAA;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAA;IAEhF,OAAO,CAAC,CAAA;AACV,CAAC"}

package/dist/cli/cmd-eval.d.ts

@@ -0,0 +1,30 @@
+import type { RunCtx } from './runctx.js';
+/**
+ * SIGTERM's default disposition kills node immediately -- once ANY listener
+ * is added, Node stops doing that for us, so this handler must actually
+ * terminate the process itself once it's done cleaning up.
+ *
+ * Both steps below are what `stop -force` (spec section 2 item 4) needs and
+ * does not otherwise get for free: `eval.ts` spawns every measurement child
+ * `detached: true` (its own process-group leader), so it is not reaped
+ * merely by `eval` itself dying; and the eval lock is a file this process
+ * would otherwise never release, since `acquireEvalLock`'s `finally` in
+ * `runEval` never runs if the process exits out from under it instead.
+ */
+/** Exported for testing: see `cmd-eval.sigterm.test.ts`. */
+export declare function installSigtermHandler(dir: string): () => void;
+/**
+ * `eval`: runs one experiment through the gate chain (`pipeline/eval.ts`)
+ * and reports the verdict. The exit code IS the signal an unattended agent
+ * loop acts on -- 0 KEEP, 1 DISCARD, 2 FAIL, 3 CRASH -- so every path here
+ * that can be reached after a real attempt returns whatever `EXIT_CODES`
+ * says for that outcome; only a usage error (bad flags, no resolvable tag)
+ * returns 2 without ever having attempted an experiment.
+ *
+ * Under `--json`, exactly one JSON object is printed to stdout and nothing
+ * else: subprocess transcripts go to `run.log`, and every warning is folded
+ * into the object's own `warnings` array rather than printed as a separate
+ * line. Human output prints those same warnings as `WARNING:` lines above
+ * the verdict instead.
+ */
+export declare function cmdEval(ctx: RunCtx, argv: readonly string[]): Promise<number>;