autor3search-typescript 0.1.0

package/dist/cli/cmd-eval.js

@@ -0,0 +1,173 @@
+import { appendFileSync, rmSync, writeFileSync } from 'node:fs';
+import { parseArgs } from 'node:util';
+import { runEval } from '../pipeline/eval.js';
+import { killActiveChildren } from '../runner/exec.js';
+import { runDir } from '../state/home.js';
+import { lockPath } from '../state/lock.js';
+import { inferTagFromBranch } from '../state/runnaming.js';
+import { EXIT_CODES } from '../verdict/verdict.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 function installSigtermHandler(dir) {
+    const onSigterm = () => {
+        killActiveChildren('SIGTERM');
+        try {
+            rmSync(lockPath(dir), { force: true });
+        }
+        catch {
+            /* best effort -- exiting either way */
+        }
+        // 128 + 15 (SIGTERM), the conventional shell exit code for "killed by
+        // this signal" -- distinct from every real verdict's exit code (0-3),
+        // so a caller can tell "abandoned by -force" from any real outcome.
+        process.exit(143);
+    };
+    process.once('SIGTERM', onSigterm);
+    return () => process.off('SIGTERM', onSigterm);
+}
+function fail(message) {
+    process.stderr.write(`error: ${message}\n`);
+    return 2;
+}
+function messageOf(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+function toJson(outcome, exitCode) {
+    return {
+        status: outcome.verdict.status,
+        exit_code: exitCode,
+        score: outcome.verdict.score,
+        reason: outcome.verdict.reason ?? '',
+        corrected_alpha: outcome.verdict.correctedAlpha,
+        warnings: outcome.warnings,
+        stop_requested: outcome.stopRequested,
+        benchmarks: outcome.deltas.map((d) => ({
+            name: d.name,
+            base_ns: d.baseNs,
+            cand_ns: d.candNs,
+            pct_change: d.pctChange,
+            p: d.p,
+            significant: d.significant,
+        })),
+        measure_commit: outcome.measureCommit,
+        frozen_commit: outcome.frozenCommit,
+        experiment: outcome.experiment,
+        failed_gate: outcome.failedGate ?? '',
+        message: outcome.message,
+    };
+}
+function printHuman(outcome, exitCode) {
+    for (const w of outcome.warnings)
+        process.stdout.write(`WARNING: ${w}\n`);
+    const status = outcome.verdict.status.toUpperCase();
+    process.stdout.write(`experiment ${outcome.experiment}: ${status} (exit ${exitCode})\n`);
+    if (outcome.failedGate)
+        process.stdout.write(`  failed_gate: ${outcome.failedGate}\n`);
+    process.stdout.write(`  ${outcome.message}\n`);
+    if (outcome.deltas.length > 0) {
+        process.stdout.write('  benchmarks:\n');
+        for (const d of outcome.deltas) {
+            const sig = d.significant ? 'significant' : 'not significant';
+            process.stdout.write(`    ${d.name}: ${d.baseNs.toFixed(1)}ns -> ${d.candNs.toFixed(1)}ns ` +
+                `(${d.pctChange.toFixed(2)}%, p=${d.p.toExponential(2)}, ${sig})\n`);
+        }
+    }
+    process.stdout.write(`  measure_commit: ${outcome.measureCommit}\n`);
+    process.stdout.write(`  frozen_commit:  ${outcome.frozenCommit}\n`);
+    if (outcome.stopRequested) {
+        process.stdout.write('  a stop has been requested: apply this verdict, then stop looping.\n');
+    }
+}
+/**
+ * `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 async function cmdEval(ctx, argv) {
+    let tag;
+    let json;
+    let desc;
+    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' },
+                json: { type: 'boolean', default: false },
+                desc: { type: 'string', default: '' },
+            },
+            strict: true,
+            allowPositionals: false,
+        });
+        tag = values.tag;
+        json = values.json === true;
+        desc = values.desc ?? '';
+    }
+    catch (e) {
+        return fail(messageOf(e));
+    }
+    let resolvedTag;
+    try {
+        resolvedTag = tag ?? (await inferTagFromBranch(ctx.repoRoot));
+    }
+    catch (e) {
+        return fail(messageOf(e));
+    }
+    // A fresh transcript per invocation -- run.log is this run's own record,
+    // not a growing history. Best effort: a logging failure must never take
+    // down the experiment it is only observing.
+    try {
+        writeFileSync(ctx.logPath, '');
+    }
+    catch {
+        /* best effort */
+    }
+    const log = (chunk) => {
+        try {
+            appendFileSync(ctx.logPath, chunk);
+        }
+        catch {
+            /* best effort -- see above */
+        }
+    };
+    const removeSigtermHandler = installSigtermHandler(runDir(ctx.repoRoot, resolvedTag));
+    let outcome;
+    try {
+        outcome = await runEval({ ctx, tag: resolvedTag, description: desc, log });
+    }
+    catch (e) {
+        return fail(`eval failed before producing a verdict: ${messageOf(e)}`);
+    }
+    finally {
+        removeSigtermHandler();
+    }
+    const exitCode = EXIT_CODES[outcome.verdict.status];
+    if (json) {
+        process.stdout.write(`${JSON.stringify(toJson(outcome, exitCode))}\n`);
+    }
+    else {
+        printHuman(outcome, exitCode);
+    }
+    return exitCode;
+}
+//# sourceMappingURL=cmd-eval.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cmd-eval.js","sourceRoot":"","sources":["../../src/cli/cmd-eval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,OAAO,EAAoB,MAAM,qBAAqB,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAGlD;;;;;;;;;;;GAWG;AACH,4DAA4D;AAC5D,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,MAAM,SAAS,GAAG,GAAS,EAAE;QAC3B,kBAAkB,CAAC,SAAS,CAAC,CAAA;QAC7B,IAAI,CAAC;YACH,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;QACD,sEAAsE;QACtE,sEAAsE;QACtE,oEAAoE;QACpE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACnB,CAAC,CAAA;IACD,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;IAClC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;AAChD,CAAC;AAED,SAAS,IAAI,CAAC,OAAe;IAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,IAAI,CAAC,CAAA;IAC3C,OAAO,CAAC,CAAA;AACV,CAAC;AAED,SAAS,SAAS,CAAC,CAAU;IAC3B,OAAO,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;AACnD,CAAC;AA6BD,SAAS,MAAM,CAAC,OAAoB,EAAE,QAAgB;IACpD,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM;QAC9B,SAAS,EAAE,QAAQ;QACnB,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK;QAC5B,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE;QACpC,eAAe,EAAE,OAAO,CAAC,OAAO,CAAC,cAAc;QAC/C,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,cAAc,EAAE,OAAO,CAAC,aAAa;QACrC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,MAAM;YACjB,OAAO,EAAE,CAAC,CAAC,MAAM;YACjB,UAAU,EAAE,CAAC,CAAC,SAAS;YACvB,CAAC,EAAE,CAAC,CAAC,CAAC;YACN,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC;QACH,cAAc,EAAE,OAAO,CAAC,aAAa;QACrC,aAAa,EAAE,OAAO,CAAC,YAAY;QACnC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,WAAW,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;QACrC,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAA;AACH,CAAC;AAED,SAAS,UAAU,CAAC,OAAoB,EAAE,QAAgB;IACxD,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;IACzE,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAA;IACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,OAAO,CAAC,UAAU,KAAK,MAAM,UAAU,QAAQ,KAAK,CAAC,CAAA;IACxF,IAAI,OAAO,CAAC,UAAU;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,OAAO,CAAC,UAAU,IAAI,CAAC,CAAA;IACtF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,OAAO,IAAI,CAAC,CAAA;IAC9C,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAA;QACvC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,iBAAiB,CAAA;YAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;gBACpE,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CACtE,CAAA;QACH,CAAC;IACH,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,OAAO,CAAC,aAAa,IAAI,CAAC,CAAA;IACpE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,OAAO,CAAC,YAAY,IAAI,CAAC,CAAA;IACnE,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uEAAuE,CAAC,CAAA;IAC/F,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,IAAuB;IAChE,IAAI,GAAuB,CAAA;IAC3B,IAAI,IAAa,CAAA;IACjB,IAAI,IAAY,CAAA;IAChB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACnF,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;YAC3B,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE;gBACP,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACvB,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;gBACzC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE;aACtC;YACD,MAAM,EAAE,IAAI;YACZ,gBAAgB,EAAE,KAAK;SACxB,CAAC,CAAA;QACF,GAAG,GAAG,MAAM,CAAC,GAAG,CAAA;QAChB,IAAI,GAAG,MAAM,CAAC,IAAI,KAAK,IAAI,CAAA;QAC3B,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAA;IAC1B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3B,CAAC;IAED,IAAI,WAAmB,CAAA;IACvB,IAAI,CAAC;QACH,WAAW,GAAG,GAAG,IAAI,CAAC,MAAM,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC/D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3B,CAAC;IAED,yEAAyE;IACzE,wEAAwE;IACxE,4CAA4C;IAC5C,IAAI,CAAC;QACH,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;IACD,MAAM,GAAG,GAAG,CAAC,KAAa,EAAQ,EAAE;QAClC,IAAI,CAAC;YACH,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;IACH,CAAC,CAAA;IAED,MAAM,oBAAoB,GAAG,qBAAqB,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAA;IACrF,IAAI,OAAoB,CAAA;IACxB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAA;IAC5E,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,IAAI,CAAC,2CAA2C,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IACxE,CAAC;YAAS,CAAC;QACT,oBAAoB,EAAE,CAAA;IACxB,CAAC;IAED,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAEnD,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAA;IACxE,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAC/B,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { RunCtx } from './runctx.js';
+/** The `templates/` directory shipped alongside this package. */
+export declare function templatesDir(): string;
+/**
+ * `init`: writes `.autor3search/config.yaml`, `program.md` and appends the
+ * harness's own output paths to `.gitignore`.
+ *
+ * Every refusal below happens before anything is written -- a command that
+ * exits non-zero after writing half its output would be worse than one
+ * that fails cleanly, since a human re-running `init` would then be
+ * "fixing" a partially-initialised repository rather than starting clean.
+ * `init` never commits: `baseline` is what refuses a dirty tree, and that
+ * refusal is what forces a human to review what `init` produced before it
+ * becomes part of the run's frozen state.
+ */
+export declare function cmdInit(ctx: RunCtx, argv: readonly string[]): Promise<number>;

package/dist/cli/cmd-init.js

@@ -0,0 +1,343 @@
+import { access, appendFile, mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseArgs } from 'node:util';
+import { CONFIG_PATH } from '../config/schema.js';
+import { defaultConfig, loadConfig } from '../config/load.js';
+import { classify, walkRepo } from '../discover/files.js';
+import { discoverBenchmarks } from '../discover/benchmarks.js';
+import { currentBranch } from '../gitx/git.js';
+import { detect } from '../pm/detect.js';
+/**
+ * `.autor3search/*` plus a `!.autor3search/config.yaml` negation, NOT a
+ * blanket `.autor3search/` -- everything else under that directory (there is
+ * nothing else there today, but nothing prevents a future addition) stays
+ * gitignored, while `config.yaml` itself must be committed: it is the run
+ * configuration a KEEP has to stay reproducible and auditable against later
+ * (spec section 13), and only its HASH, not merely its presence on disk, is
+ * what the gate chain trusts (see `pipeline/eval.ts` gate 2). The negation
+ * line must stay listed after the pattern it un-ignores -- git applies
+ * `.gitignore` rules in file order.
+ */
+const GITIGNORE_ENTRIES = [
+    '.autor3search/*',
+    '!.autor3search/config.yaml',
+    'results.tsv',
+    'run.log',
+    '*.cpuprofile',
+];
+/** The `templates/` directory shipped alongside this package. */
+export function templatesDir() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    return path.resolve(here, '../../templates');
+}
+async function exists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The command that runs `tsc` through each package manager's own "run a
+ * locally-installed binary" mechanism. `npx tsc` alone would silently
+ * offer to fetch `typescript` from the registry on a repo that doesn't
+ * have it installed yet, which is a materially different (networked,
+ * slow, and non-reproducible) behaviour from every other gate.
+ */
+function typecheckRunner(pm) {
+    switch (pm) {
+        case 'npm':
+            return 'npx';
+        case 'pnpm':
+            return 'pnpm exec';
+        case 'yarn':
+            return 'yarn exec';
+        case 'bun':
+            return 'bunx';
+    }
+}
+/**
+ * `['src/**']` when a `src/` directory exists (the overwhelmingly common
+ * case); otherwise the top-level directories that contain at least one
+ * file `classify` calls ordinary source -- so a repository laid out as
+ * `lib/`, `pkg/`, etc. still gets a scope that actually covers its code,
+ * rather than the `src/**` default that would match nothing in it.
+ */
+async function deriveScope(root) {
+    if (await exists(path.join(root, 'src')))
+        return ['src/**'];
+    const files = await walkRepo(root);
+    const topDirs = new Set();
+    const topLevelSourceFiles = new Set();
+    for (const f of files) {
+        if (classify(f) !== 'source')
+            continue;
+        const slash = f.indexOf('/');
+        if (slash === -1) {
+            topLevelSourceFiles.add(f);
+        }
+        else {
+            topDirs.add(f.slice(0, slash));
+        }
+    }
+    if (topDirs.size > 0) {
+        return [...topDirs].sort().map((d) => `${d}/**`);
+    }
+    // No subdirectory holds source at all -- fall back to naming the
+    // top-level source files themselves, so scope is never empty (which
+    // `loadConfig` refuses outright) for a repository that keeps its code
+    // directly at the root.
+    return [...topLevelSourceFiles].sort();
+}
+async function readPackageScripts(root) {
+    const text = await readFile(path.join(root, 'package.json'), 'utf8');
+    const pkg = JSON.parse(text);
+    return pkg.scripts ?? {};
+}
+function yamlString(s) {
+    return JSON.stringify(s);
+}
+function yamlStringArray(a) {
+    return `[${a.map(yamlString).join(', ')}]`;
+}
+/**
+ * Renders the generated config as YAML, one comment explaining each key
+ * above the key itself. Hand-rolled rather than a generic YAML
+ * stringifier: `yaml`'s writer has no notion of a per-key doc comment, and
+ * the whole point of this file is that a human reads it before committing.
+ */
+function renderConfigYaml(cfg) {
+    const fields = [
+        {
+            key: 'benchmarks',
+            comment: [
+                'Benchmark ids ("<file>:<function>") to measure.',
+                'Empty means "everything discoverBenchmarks finds" -- the default, so a new',
+                'benchmark file is picked up automatically without editing this file.',
+            ],
+            value: yamlStringArray(cfg.benchmarks),
+        },
+        {
+            key: 'scope',
+            comment: [
+                'Glob patterns of files the agent may modify. package.json, tsconfig.json',
+                'and any lockfile are always off-limits, regardless of scope.',
+            ],
+            value: yamlStringArray(cfg.scope),
+        },
+        {
+            key: 'count',
+            comment: [
+                'Measured rounds per side (baseline vs. candidate). Below 4 no result can',
+                'ever reach significance, whatever the effect size.',
+            ],
+            value: String(cfg.count),
+        },
+        { key: 'benchtime', comment: ['Measured window per benchmark per round.'], value: yamlString(cfg.benchtime) },
+        {
+            key: 'warmup',
+            comment: ['Discarded warmup window before each measurement.'],
+            value: yamlString(cfg.warmup),
+        },
+        {
+            key: 'max_regress_pct',
+            comment: [
+                'Largest tolerated regression on any one benchmark, percent. A significant',
+                'regression past this discards the experiment regardless of overall gain.',
+            ],
+            value: String(cfg.maxRegressPct),
+        },
+        {
+            key: 'min_effect_pct',
+            comment: [
+                'Smallest geomean improvement, percent, that a KEEP will accept -- guards',
+                'against keeping a change that is "significant" only because of sample size.',
+            ],
+            value: String(cfg.minEffectPct),
+        },
+        {
+            key: 'timeout',
+            comment: ['Upper bound on each subprocess phase (build, test, typecheck, one measurement round).'],
+            value: yamlString(cfg.timeout),
+        },
+        {
+            key: 'typecheck_command',
+            comment: [
+                'Typecheck gate, run before every measurement. Empty disables the gate --',
+                'see the warning init printed if this repository has no tsconfig.json.',
+            ],
+            value: yamlString(cfg.typecheckCommand),
+        },
+        {
+            key: 'build_command',
+            comment: ['Optional build gate, run before tests. Empty means skip.'],
+            value: yamlString(cfg.buildCommand),
+        },
+        {
+            key: 'test_command',
+            comment: [
+                "Correctness gate: the repository's own test command. An experiment that",
+                'breaks this FAILs before anything is measured.',
+            ],
+            value: yamlString(cfg.testCommand),
+        },
+        {
+            key: 'node_args',
+            comment: ['Extra flags passed to the measurement child process, e.g. ["--expose-gc"].'],
+            value: yamlStringArray(cfg.nodeArgs),
+        },
+        {
+            key: 'unfreeze',
+            comment: [
+                'Test/bench files deliberately exempted from the freeze -- edit these at your',
+                'own risk, since they define what "correct" and "measured" mean.',
+            ],
+            value: yamlStringArray(cfg.unfreeze),
+        },
+    ];
+    return (fields
+        .map((f) => `${f.comment.map((c) => `# ${c}`).join('\n')}\n${f.key}: ${f.value}\n`)
+        .join('\n'));
+}
+function renderProgramMd(template, benchmarkIds, runTag) {
+    const list = benchmarkIds.map((id) => `- \`${id}\``).join('\n');
+    return template.replace('{{BENCHMARKS}}', list).replace(/\{\{RUN_TAG\}\}/g, runTag);
+}
+async function ensureGitignore(root) {
+    const gitignorePath = path.join(root, '.gitignore');
+    let text = '';
+    try {
+        text = await readFile(gitignorePath, 'utf8');
+    }
+    catch (e) {
+        if (e.code !== 'ENOENT')
+            throw e;
+    }
+    const existingLines = new Set(text.split('\n').map((l) => l.trim()));
+    const missing = GITIGNORE_ENTRIES.filter((e) => !existingLines.has(e));
+    if (missing.length === 0)
+        return;
+    const prefix = text.length > 0 && !text.endsWith('\n') ? '\n' : '';
+    await appendFile(gitignorePath, `${prefix}${missing.join('\n')}\n`, 'utf8');
+}
+function fail(message) {
+    process.stderr.write(`error: ${message}\n`);
+    return 2;
+}
+/**
+ * `init`: writes `.autor3search/config.yaml`, `program.md` and appends the
+ * harness's own output paths to `.gitignore`.
+ *
+ * Every refusal below happens before anything is written -- a command that
+ * exits non-zero after writing half its output would be worse than one
+ * that fails cleanly, since a human re-running `init` would then be
+ * "fixing" a partially-initialised repository rather than starting clean.
+ * `init` never commits: `baseline` is what refuses a dirty tree, and that
+ * refusal is what forces a human to review what `init` produced before it
+ * becomes part of the run's frozen state.
+ */
+export async function cmdInit(ctx, argv) {
+    let force;
+    try {
+        const normalized = argv.map((a) => (/^-[A-Za-z][A-Za-z-]+$/.test(a) ? `-${a}` : a));
+        const { values } = parseArgs({
+            args: normalized,
+            options: { force: { type: 'boolean', default: false } },
+            strict: true,
+            allowPositionals: false,
+        });
+        force = values.force === true;
+    }
+    catch (e) {
+        return fail(e.message);
+    }
+    try {
+        // 1. detect the package manager -- surfaces workspace/lockfile refusals
+        // before anything else runs, let alone is written.
+        const detected = await detect(ctx.repoRoot);
+        // 2. discover benchmarks. Nothing is written past this point unless at
+        // least one exists: a tool whose whole purpose is measuring benchmarks
+        // has nothing to do, and no config or program.md to hand an agent, if
+        // there are none.
+        const benchmarks = await discoverBenchmarks(ctx.repoRoot);
+        if (benchmarks.length === 0) {
+            return fail('no benchmarks found: looked for exported `bench*` functions in `*.bench.ts` files ' +
+                'and found none. Without at least one benchmark this tool has nothing to measure ' +
+                'and nothing to optimize -- add a benchmark (e.g. src/foo.bench.ts exporting ' +
+                '`benchFoo()`) and run init again.');
+        }
+        // 3. refuse to clobber an existing config without -force.
+        if ((await exists(ctx.configPath)) && !force) {
+            return fail(`${CONFIG_PATH} already exists; pass -force to overwrite it`);
+        }
+        // 4. derive scope.
+        const scope = await deriveScope(ctx.repoRoot);
+        // 5. derive commands from package.json scripts, using the DETECTED
+        // package manager -- never hardcoding npm, which resolves differently
+        // (or not at all) against a pnpm or yarn lockfile.
+        const scripts = await readPackageScripts(ctx.repoRoot);
+        if (!scripts.test) {
+            return fail('package.json has no "test" script: the correctness gate has nothing to run before ' +
+                'a change is measured. Add a "test" script and run init again.');
+        }
+        // `run` is load-bearing, not decoration: `bun test` is a reserved Bun
+        // subcommand that invokes Bun's own built-in test runner rather than
+        // falling through to the package.json "test" script the way `npm test`,
+        // `pnpm test` and `yarn test` all do. `<pm> run test` invokes the actual
+        // package script uniformly on all four managers, so it is used
+        // everywhere rather than special-casing bun (Ruling 33).
+        const testCommand = `${detected.pm} run test`;
+        const buildCommand = scripts.build ? `${detected.pm} run build` : '';
+        const hasTsconfig = await exists(path.join(ctx.repoRoot, 'tsconfig.json'));
+        const typecheckCommand = hasTsconfig ? `${typecheckRunner(detected.pm)} tsc --noEmit` : '';
+        if (!hasTsconfig) {
+            process.stderr.write('warning: no tsconfig.json found; the typecheck gate is disabled for this run\n');
+        }
+        const cfg = { ...defaultConfig(), scope, testCommand, buildCommand, typecheckCommand };
+        // 6. write .autor3search/config.yaml.
+        await mkdir(path.dirname(ctx.configPath), { recursive: true });
+        await writeFile(ctx.configPath, renderConfigYaml(cfg), 'utf8');
+        // Round-trip guard, immediately after writing: a config init itself
+        // cannot load back is a bug that would otherwise only surface at the
+        // user's first eval. Checked here, before program.md or .gitignore are
+        // touched, so "every refusal happens before anything [else] is written"
+        // stays true even on this defensive path.
+        await loadConfig(ctx.configPath);
+        // 7. copy templates/program.md, substituting the benchmark list and tag.
+        const template = await readFile(path.join(templatesDir(), 'program.md'), 'utf8');
+        let runTag = 'this-branch';
+        try {
+            runTag = await currentBranch(ctx.repoRoot);
+        }
+        catch {
+            // Detached HEAD or some other reason `git rev-parse --abbrev-ref HEAD`
+            // fails -- the placeholder text above is still a readable fallback.
+        }
+        const programMd = renderProgramMd(template, benchmarks.map((b) => b.id), runTag);
+        await writeFile(path.join(ctx.repoRoot, 'program.md'), programMd, 'utf8');
+        // 8. append gitignore entries.
+        await ensureGitignore(ctx.repoRoot);
+        // 9. report what happened and what to do next.
+        process.stdout.write('discovered benchmarks:\n');
+        for (const b of benchmarks)
+            process.stdout.write(`  - ${b.id}\n`);
+        process.stdout.write('\nwrote .autor3search/config.yaml and program.md. Review both, then:\n' +
+            // .autor3search/config.yaml is the one file under .autor3search/
+            // meant to be committed -- it is the run configuration a KEEP must
+            // stay reproducible and auditable against later (spec section 13).
+            // Everything else the harness writes (baselines, locks, stop
+            // requests) lives outside the repository entirely; nothing else
+            // under .autor3search/ exists to commit.
+            '  1. git add .autor3search/config.yaml program.md .gitignore && git commit\n' +
+            '  2. autor3search-typescript baseline\n' +
+            '  3. hand this repository and program.md to your coding agent\n');
+        return 0;
+    }
+    catch (e) {
+        return fail(e.message);
+    }
+}
+//# sourceMappingURL=cmd-init.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cmd-init.js","sourceRoot":"","sources":["../../src/cli/cmd-init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjF,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAe,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAuB,MAAM,iBAAiB,CAAA;AAG7D;;;;;;;;;;GAUG;AACH,MAAM,iBAAiB,GAAG;IACxB,iBAAiB;IACjB,4BAA4B;IAC5B,aAAa;IACb,SAAS;IACT,cAAc;CACf,CAAA;AAED,iEAAiE;AACjE,MAAM,UAAU,YAAY;IAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAA;AAC9C,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,CAAS;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,CAAC,CAAC,CAAA;QACf,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,eAAe,CAAC,EAAkB;IACzC,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,KAAK;YACR,OAAO,KAAK,CAAA;QACd,KAAK,MAAM;YACT,OAAO,WAAW,CAAA;QACpB,KAAK,MAAM;YACT,OAAO,WAAW,CAAA;QACpB,KAAK,KAAK;YACR,OAAO,MAAM,CAAA;IACjB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,WAAW,CAAC,IAAY;IACrC,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IAE3D,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAA;IAClC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAA;IACjC,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAA;IAC7C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ;YAAE,SAAQ;QACtC,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAC5B,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QAC5B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA;QAChC,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAClD,CAAC;IACD,iEAAiE;IACjE,oEAAoE;IACpE,sEAAsE;IACtE,wBAAwB;IACxB,OAAO,CAAC,GAAG,mBAAmB,CAAC,CAAC,IAAI,EAAE,CAAA;AACxC,CAAC;AAOD,KAAK,UAAU,kBAAkB,CAAC,IAAY;IAC5C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAA;IACpE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAyC,CAAA;IACpE,OAAO,GAAG,CAAC,OAAO,IAAI,EAAE,CAAA;AAC1B,CAAC;AASD,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;AAC1B,CAAC;AAED,SAAS,eAAe,CAAC,CAAoB;IAC3C,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAA;AAC5C,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,GAAW;IACnC,MAAM,MAAM,GAAkB;QAC5B;YACE,GAAG,EAAE,YAAY;YACjB,OAAO,EAAE;gBACP,iDAAiD;gBACjD,4EAA4E;gBAC5E,sEAAsE;aACvE;YACD,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC;SACvC;QACD;YACE,GAAG,EAAE,OAAO;YACZ,OAAO,EAAE;gBACP,0EAA0E;gBAC1E,8DAA8D;aAC/D;YACD,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC;SAClC;QACD;YACE,GAAG,EAAE,OAAO;YACZ,OAAO,EAAE;gBACP,0EAA0E;gBAC1E,oDAAoD;aACrD;YACD,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;SACzB;QACD,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,0CAA0C,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE;QAC7G;YACE,GAAG,EAAE,QAAQ;YACb,OAAO,EAAE,CAAC,kDAAkD,CAAC;YAC7D,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC;SAC9B;QACD;YACE,GAAG,EAAE,iBAAiB;YACtB,OAAO,EAAE;gBACP,2EAA2E;gBAC3E,0EAA0E;aAC3E;YACD,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC;SACjC;QACD;YACE,GAAG,EAAE,gBAAgB;YACrB,OAAO,EAAE;gBACP,0EAA0E;gBAC1E,6EAA6E;aAC9E;YACD,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC;SAChC;QACD;YACE,GAAG,EAAE,SAAS;YACd,OAAO,EAAE,CAAC,uFAAuF,CAAC;YAClG,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC;SAC/B;QACD;YACE,GAAG,EAAE,mBAAmB;YACxB,OAAO,EAAE;gBACP,0EAA0E;gBAC1E,uEAAuE;aACxE;YACD,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,gBAAgB,CAAC;SACxC;QACD;YACE,GAAG,EAAE,eAAe;YACpB,OAAO,EAAE,CAAC,0DAA0D,CAAC;YACrE,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC;SACpC;QACD;YACE,GAAG,EAAE,cAAc;YACnB,OAAO,EAAE;gBACP,yEAAyE;gBACzE,gDAAgD;aACjD;YACD,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC;SACnC;QACD;YACE,GAAG,EAAE,WAAW;YAChB,OAAO,EAAE,CAAC,4EAA4E,CAAC;YACvF,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC;SACrC;QACD;YACE,GAAG,EAAE,UAAU;YACf,OAAO,EAAE;gBACP,8EAA8E;gBAC9E,iEAAiE;aAClE;YACD,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC;SACrC;KACF,CAAA;IAED,OAAO,CACL,MAAM;SACH,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC;SAClF,IAAI,CAAC,IAAI,CAAC,CACd,CAAA;AACH,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB,EAAE,YAA+B,EAAE,MAAc;IACxF,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC/D,OAAO,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAA;AACrF,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAY;IACzC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;IACnD,IAAI,IAAI,GAAG,EAAE,CAAA;IACb,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;IAC9C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,CAAC,CAAA;IAC7D,CAAC;IACD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IACpE,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACtE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAM;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAA;IAClE,MAAM,UAAU,CAAC,aAAa,EAAE,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;AAC7E,CAAC;AAED,SAAS,IAAI,CAAC,OAAe;IAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,IAAI,CAAC,CAAA;IAC3C,OAAO,CAAC,CAAA;AACV,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,IAAuB;IAChE,IAAI,KAAc,CAAA;IAClB,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACnF,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;YAC3B,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YACvD,MAAM,EAAE,IAAI;YACZ,gBAAgB,EAAE,KAAK;SACxB,CAAC,CAAA;QACF,KAAK,GAAG,MAAM,CAAC,KAAK,KAAK,IAAI,CAAA;IAC/B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,IAAI,CAAE,CAAW,CAAC,OAAO,CAAC,CAAA;IACnC,CAAC;IAED,IAAI,CAAC;QACH,wEAAwE;QACxE,mDAAmD;QACnD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAE3C,uEAAuE;QACvE,uEAAuE;QACvE,sEAAsE;QACtE,kBAAkB;QAClB,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACzD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,IAAI,CACT,oFAAoF;gBAClF,kFAAkF;gBAClF,8EAA8E;gBAC9E,mCAAmC,CACtC,CAAA;QACH,CAAC;QAED,0DAA0D;QAC1D,IAAI,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAC7C,OAAO,IAAI,CAAC,GAAG,WAAW,8CAA8C,CAAC,CAAA;QAC3E,CAAC;QAED,mBAAmB;QACnB,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAE7C,mEAAmE;QACnE,sEAAsE;QACtE,mDAAmD;QACnD,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACtD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAClB,OAAO,IAAI,CACT,oFAAoF;gBAClF,+DAA+D,CAClE,CAAA;QACH,CAAC;QACD,sEAAsE;QACtE,qEAAqE;QACrE,wEAAwE;QACxE,yEAAyE;QACzE,+DAA+D;QAC/D,yDAAyD;QACzD,MAAM,WAAW,GAAG,GAAG,QAAQ,CAAC,EAAE,WAAW,CAAA;QAC7C,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAA;QACpE,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAA;QAC1E,MAAM,gBAAgB,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAA;QAC1F,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gFAAgF,CACjF,CAAA;QACH,CAAC;QAED,MAAM,GAAG,GAAW,EAAE,GAAG,aAAa,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAA;QAE9F,sCAAsC;QACtC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC9D,MAAM,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAA;QAE9D,oEAAoE;QACpE,qEAAqE;QACrE,uEAAuE;QACvE,wEAAwE;QACxE,0CAA0C;QAC1C,MAAM,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QAEhC,yEAAyE;QACzE,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAA;QAChF,IAAI,MAAM,GAAG,aAAa,CAAA;QAC1B,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,uEAAuE;YACvE,oEAAoE;QACtE,CAAC;QACD,MAAM,SAAS,GAAG,eAAe,CAAC,QAAQ,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAA;QAChF,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,CAAA;QAEzE,+BAA+B;QAC/B,MAAM,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAEnC,+CAA+C;QAC/C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAA;QAChD,KAAK,MAAM,CAAC,IAAI,UAAU;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;QACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,wEAAwE;YACtE,iEAAiE;YACjE,mEAAmE;YACnE,mEAAmE;YACnE,6DAA6D;YAC7D,gEAAgE;YAChE,yCAAyC;YACzC,8EAA8E;YAC9E,yCAAyC;YACzC,iEAAiE,CACpE,CAAA;QACD,OAAO,CAAC,CAAA;IACV,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,IAAI,CAAE,CAAW,CAAC,OAAO,CAAC,CAAA;IACnC,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { RunCtx } from './runctx.js';
+/**
+ * `profile`: runs the declared benchmarks under Node's built-in `--cpu-prof`
+ * sampling profiler and prints where time actually goes.
+ *
+ * Deliberately does not touch `baseline` or the state home at all: this is
+ * reconnaissance a human runs BEFORE starting the loop, to decide whether
+ * the benchmarks even point at the right code, so it must work with only
+ * `.autor3search/config.yaml` in place.
+ */
+export declare function cmdProfile(ctx: RunCtx, argv: readonly string[]): Promise<number>;