@aid-framework/cli 0.0.0-stage → 0.1.39

package/dist/args.d.ts

@@ -0,0 +1,37 @@
+/**
+ * A hand-written parser for the flag grammar this CLI actually has.
+ *
+ * The whole grammar is a command, positional arguments, and
+ * `--flag` / `--flag=value` / `--flag value` options, with `--` ending option parsing.
+ * A CLI framework brings a plugin system, a config loader and a help renderer to that,
+ * which is more code than the grammar and more surface than the design asks for.
+ *
+ * The parser is pure: it reports a message and lets the caller decide the exit code.
+ */
+export interface FlagSpec {
+    readonly name: string;
+    /** A `value` flag consumes the next argument; a `boolean` flag never does. */
+    readonly kind: 'boolean' | 'value';
+    /** The placeholder shown in help, for a `value` flag. */
+    readonly value?: string;
+    readonly summary: string;
+}
+export declare function booleanFlag(name: string, summary: string): FlagSpec;
+export declare function valueFlag(name: string, value: string, summary: string): FlagSpec;
+/** Every command answers `--json` with one JSON document and `-h`/`--help` with usage. */
+export declare const JSON_FLAG: FlagSpec;
+export interface ParsedArguments {
+    readonly positionals: readonly string[];
+    readonly values: ReadonlyMap<string, string>;
+    readonly booleans: ReadonlySet<string>;
+    readonly help: boolean;
+}
+export type ParseOutcome = {
+    readonly ok: true;
+    readonly args: ParsedArguments;
+} | {
+    readonly ok: false;
+    readonly message: string;
+};
+export declare function parseArguments(argv: readonly string[], flags: readonly FlagSpec[]): ParseOutcome;
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IACnC,yDAAyD;IACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAEnE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAEhF;AAED,0FAA0F;AAC1F,eAAO,MAAM,SAAS,UAA2D,CAAC;AAIlF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,YAAY,CA0DhG"}

package/dist/args.js

@@ -0,0 +1,74 @@
+/**
+ * A hand-written parser for the flag grammar this CLI actually has.
+ *
+ * The whole grammar is a command, positional arguments, and
+ * `--flag` / `--flag=value` / `--flag value` options, with `--` ending option parsing.
+ * A CLI framework brings a plugin system, a config loader and a help renderer to that,
+ * which is more code than the grammar and more surface than the design asks for.
+ *
+ * The parser is pure: it reports a message and lets the caller decide the exit code.
+ */
+export function booleanFlag(name, summary) {
+    return { name, kind: 'boolean', summary };
+}
+export function valueFlag(name, value, summary) {
+    return { name, kind: 'value', value, summary };
+}
+/** Every command answers `--json` with one JSON document and `-h`/`--help` with usage. */
+export const JSON_FLAG = booleanFlag('json', 'print one JSON document on stdout');
+const HELP_FLAG = booleanFlag('help', "print this command's usage");
+export function parseArguments(argv, flags) {
+    const known = new Map();
+    for (const flag of flags)
+        known.set(flag.name, flag);
+    known.set(HELP_FLAG.name, HELP_FLAG);
+    const positionals = [];
+    const values = new Map();
+    const booleans = new Set();
+    let optionsEnded = false;
+    for (let index = 0; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (token === undefined)
+            break;
+        if (optionsEnded || !token.startsWith('-')) {
+            positionals.push(token);
+            continue;
+        }
+        if (token === '--') {
+            optionsEnded = true;
+            continue;
+        }
+        if (token === '-h') {
+            booleans.add(HELP_FLAG.name);
+            continue;
+        }
+        if (!token.startsWith('--')) {
+            return { ok: false, message: `unknown option \`${token}\`` };
+        }
+        const equals = token.indexOf('=');
+        const name = equals === -1 ? token.slice(2) : token.slice(2, equals);
+        const spec = known.get(name);
+        if (spec === undefined) {
+            return { ok: false, message: `unknown option \`--${name}\`` };
+        }
+        if (spec.kind === 'boolean') {
+            if (equals !== -1) {
+                return { ok: false, message: `\`--${name}\` does not take a value` };
+            }
+            booleans.add(name);
+            continue;
+        }
+        if (equals !== -1) {
+            values.set(name, token.slice(equals + 1));
+            continue;
+        }
+        const next = argv[index + 1];
+        if (next === undefined) {
+            return { ok: false, message: `\`--${name}\` needs a value` };
+        }
+        index += 1;
+        values.set(name, next);
+    }
+    return { ok: true, args: { positionals, values, booleans, help: booleans.has('help') } };
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * The `aid` executable: the only file in this package that touches `process`.
+ *
+ * Everything it does is three lines of I/O wiring, because everything else lives behind
+ * `run(argv, context)`. Keeping the process bindings in one place is what makes the rest
+ * of the CLI testable, and the `import.meta.url` guard below is what makes importing this
+ * module a no-op: a test can import `main.js` and call `run` without the import itself
+ * deciding to read `process.argv` and start working.
+ *
+ * The exit status is set through `process.exitCode` rather than `process.exit()`. Nothing
+ * here is holding a handle open, so the process ends when the event loop drains, and
+ * `process.exit()` before that is how a CLI truncates its own stdout on a pipe.
+ */
+/** The real entry point: the process streams, the process environment, real children. */
+export declare function main(argv?: readonly string[]): number;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AAOH,yFAAyF;AACzF,wBAAgB,IAAI,CAAC,IAAI,GAAE,SAAS,MAAM,EAA0B,GAAG,MAAM,CAE5E"}

package/dist/cli.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+/**
+ * The `aid` executable: the only file in this package that touches `process`.
+ *
+ * Everything it does is three lines of I/O wiring, because everything else lives behind
+ * `run(argv, context)`. Keeping the process bindings in one place is what makes the rest
+ * of the CLI testable, and the `import.meta.url` guard below is what makes importing this
+ * module a no-op: a test can import `main.js` and call `run` without the import itself
+ * deciding to read `process.argv` and start working.
+ *
+ * The exit status is set through `process.exitCode` rather than `process.exit()`. Nothing
+ * here is holding a handle open, so the process ends when the event loop drains, and
+ * `process.exit()` before that is how a CLI truncates its own stdout on a pipe.
+ */
+import { pathToFileURL } from 'node:url';
+import { createContext } from './context.js';
+import { run } from './main.js';
+/** The real entry point: the process streams, the process environment, real children. */
+export function main(argv = process.argv.slice(2)) {
+    return run(argv, createContext());
+}
+const entry = process.argv[1];
+if (entry !== undefined && import.meta.url === pathToFileURL(entry).href) {
+    process.exitCode = main();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC,yFAAyF;AACzF,MAAM,UAAU,IAAI,CAAC,IAAI,GAAsB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAClE,OAAO,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC9B,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACzE,OAAO,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC;AAC5B,CAAC"}

package/dist/commands/eval.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `aid eval` — run the eval gate, or record the baseline it measures against.
+ *
+ * **What this shells out to, and why.**
+ *
+ * The assignment sketched `uv run python -m aid_runtime.evals ...`, but that module is not
+ * runnable: there is no `__main__.py`, no console script, and no `argparse` anywhere under
+ * `runtimes/python/src/aid_runtime/evals/`. The command it names does not exist.
+ *
+ * What does exist, one per eval, is the module the generator emits:
+ * `app/generated/evals/<id>.py`, with a `main()` that prints `result.summary()` and exits
+ * non-zero when the gate fails. That module is the intended surface -- it is generated code
+ * the spec already declares, and it is what the committed `app/evals/*.baseline.json` was
+ * produced by. So `aid eval` runs `python -m app.generated.evals.<id>` from the project
+ * root, which is also what a person would type by hand.
+ *
+ * The alternative was adding an entry point to `runtimes/`, and that was rejected: the
+ * runtime is a landed layer whose published surface other layers depend on, and the
+ * assignment says not to modify it. A missing runtime entry point is this layer's problem
+ * to route around, not a reason to change a shipped one.
+ *
+ * **`--baseline` delegates the sampling.** The gate is statistical (`maxRegression` against
+ * a stored distribution), so a baseline from a single run is noise shaped like a fact. The
+ * generated module's `run()` already samples the dataset `SAMPLES` times -- the N the spec
+ * declares -- so recording a baseline calls that, then the runtime's own documented recipe
+ * (`EvalBaseline.from_run(await run(), model=...).to_json()`, which is literally the string
+ * in the generated `load_baseline`'s error message). Re-sampling here would invent a second
+ * N and let the CLI and the module disagree about how many runs a baseline means.
+ *
+ * That recipe is the one place in the CLI that writes Python. It is a script piped to the
+ * interpreter over stdin rather than an API call because the runtime has no such entry
+ * point, and it is deliberately short: anything longer would be this layer reimplementing
+ * the runtime's measurement.
+ */
+import type { CliContext } from '../context.js';
+import type { CommandOutcome } from '../output.js';
+export interface EvalOptions {
+    readonly spec: string | undefined;
+    readonly target: string | undefined;
+    readonly suite: string | undefined;
+    readonly baseline: boolean;
+}
+export declare function evaluate(context: CliContext, options: EvalOptions): CommandOutcome;
+//# sourceMappingURL=eval.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"eval.d.ts","sourceRoot":"","sources":["../../src/commands/eval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAOnD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AA6DD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,GAAG,cAAc,CA0LlF"}

package/dist/commands/eval.js

@@ -0,0 +1,257 @@
+/**
+ * `aid eval` — run the eval gate, or record the baseline it measures against.
+ *
+ * **What this shells out to, and why.**
+ *
+ * The assignment sketched `uv run python -m aid_runtime.evals ...`, but that module is not
+ * runnable: there is no `__main__.py`, no console script, and no `argparse` anywhere under
+ * `runtimes/python/src/aid_runtime/evals/`. The command it names does not exist.
+ *
+ * What does exist, one per eval, is the module the generator emits:
+ * `app/generated/evals/<id>.py`, with a `main()` that prints `result.summary()` and exits
+ * non-zero when the gate fails. That module is the intended surface -- it is generated code
+ * the spec already declares, and it is what the committed `app/evals/*.baseline.json` was
+ * produced by. So `aid eval` runs `python -m app.generated.evals.<id>` from the project
+ * root, which is also what a person would type by hand.
+ *
+ * The alternative was adding an entry point to `runtimes/`, and that was rejected: the
+ * runtime is a landed layer whose published surface other layers depend on, and the
+ * assignment says not to modify it. A missing runtime entry point is this layer's problem
+ * to route around, not a reason to change a shipped one.
+ *
+ * **`--baseline` delegates the sampling.** The gate is statistical (`maxRegression` against
+ * a stored distribution), so a baseline from a single run is noise shaped like a fact. The
+ * generated module's `run()` already samples the dataset `SAMPLES` times -- the N the spec
+ * declares -- so recording a baseline calls that, then the runtime's own documented recipe
+ * (`EvalBaseline.from_run(await run(), model=...).to_json()`, which is literally the string
+ * in the generated `load_baseline`'s error message). Re-sampling here would invent a second
+ * N and let the CLI and the module disagree about how many runs a baseline means.
+ *
+ * That recipe is the one place in the CLI that writes Python. It is a script piped to the
+ * interpreter over stdin rather than an API call because the runtime has no such entry
+ * point, and it is deliberately short: anything longer would be this layer reimplementing
+ * the runtime's measurement.
+ */
+import { existsSync } from 'node:fs';
+import { sortDiagnostics } from '@aid-framework/spec';
+import { CLI_DIAGNOSTIC_CODES, cliError, cliWarning } from '../diagnostics.js';
+import { EXIT_FAILURE, EXIT_OK, EXIT_USAGE } from '../exit.js';
+import { outcome } from '../output.js';
+import { absolutePath } from '../paths.js';
+import { lowerSpec, readSpec } from '../pipeline.js';
+import { discoverInterpreter, INTERPRETERS, interpreterCommand, invoke } from '../python.js';
+import { resolveTarget, unknownTargetDiagnostic } from '../targets.js';
+/** Eval ids the spec declares, or the diagnostics that stopped it from declaring any. */
+function declaredSuites(text, specPath) {
+    const lowered = lowerSpec(text, specPath);
+    if (!lowered.ok)
+        return { ok: false, diagnostics: lowered.diagnostics };
+    const ir = lowered.ir;
+    return {
+        ok: true,
+        ids: ir.evals.map((entry) => entry.id),
+        warnings: lowered.diagnostics,
+    };
+}
+/**
+ * The baseline recorder, run as `python -`. `python` puts the current directory on
+ * `sys.path`, so `import app.generated.evals.<id>` resolves against the project root and
+ * each module's own `BASELINE_PATH` decides where its baseline goes -- the same path
+ * `load_baseline()` reads back, because it is the same constant.
+ */
+function baselineScript(modules) {
+    return [
+        'import asyncio',
+        'import importlib',
+        'import pathlib',
+        '',
+        'from aid_runtime.evals import EvalBaseline',
+        '',
+        `MODULES = ${JSON.stringify(modules)}`,
+        '',
+        'for name in MODULES:',
+        '    module = importlib.import_module(name)',
+        '    # run() already samples the dataset SAMPLES times, the N the spec declares.',
+        '    baseline = EvalBaseline.from_run(',
+        '        asyncio.run(module.run()),',
+        '        model=module.MODEL,',
+        "        note='recorded by `aid eval --baseline`',",
+        '    )',
+        '    path = pathlib.Path(module.BASELINE_PATH)',
+        '    path.parent.mkdir(parents=True, exist_ok=True)',
+        '    path.write_text(baseline.to_json(), encoding="utf-8")',
+        '    print(f"wrote {path}")',
+        '',
+    ].join('\n');
+}
+export function evaluate(context, options) {
+    const command = 'eval';
+    const target = resolveTarget(options.target);
+    if (target === undefined) {
+        return outcome({
+            command,
+            exitCode: EXIT_USAGE,
+            diagnostics: [unknownTargetDiagnostic(options.target ?? '')],
+        });
+    }
+    const specPath = options.spec ?? target.specPath;
+    const fields = { target: target.name, spec: specPath, suite: options.suite ?? null };
+    const read = readSpec(context, specPath);
+    if (!read.ok) {
+        return outcome({ command, exitCode: EXIT_FAILURE, fields, diagnostics: read.diagnostics });
+    }
+    const declared = declaredSuites(read.text, specPath);
+    if (!declared.ok) {
+        return outcome({ command, exitCode: EXIT_FAILURE, fields, diagnostics: declared.diagnostics });
+    }
+    // `--suite` is checked against the ids the spec declares, not against filenames on
+    // disk: the set of evals is a property of the spec, so a typo is a usage error and
+    // should say which ids exist.
+    if (options.suite !== undefined && !declared.ids.includes(options.suite)) {
+        return outcome({
+            command,
+            exitCode: EXIT_USAGE,
+            fields,
+            diagnostics: [
+                cliError({
+                    code: CLI_DIAGNOSTIC_CODES.suiteNotFound,
+                    message: `No eval named "${options.suite}" in ${specPath}.`,
+                    path: [specPath],
+                    hint: declared.ids.length > 0
+                        ? `Declared evals: ${declared.ids.join(', ')}.`
+                        : 'The spec declares no evals.',
+                }),
+            ],
+        });
+    }
+    const suites = options.suite === undefined ? declared.ids : [options.suite];
+    const missing = suites.filter((id) => !existsSync(absolutePath(context.cwd, target.evalModuleFile(id))));
+    if (missing.length > 0) {
+        return outcome({
+            command,
+            exitCode: EXIT_FAILURE,
+            fields: { ...fields, suites },
+            diagnostics: [
+                cliError({
+                    code: CLI_DIAGNOSTIC_CODES.evalModulesMissing,
+                    message: `No generated eval module for ${missing.map((id) => `"${id}"`).join(', ')}.`,
+                    path: missing.map((id) => target.evalModuleFile(id)),
+                    hint: 'Run `aid gen`: the evals that run are the modules the generator emits.',
+                }),
+            ],
+        });
+    }
+    if (target.runner !== 'python') {
+        return outcome({
+            command,
+            // Exit 2, not 1: this command has no runner for this target, so no eval ran and
+            // nothing about the project was judged. `1` would read as "the evals failed".
+            exitCode: EXIT_USAGE,
+            fields: { ...fields, suites },
+            diagnostics: [
+                cliError({
+                    code: CLI_DIAGNOSTIC_CODES.runnerUnsupported,
+                    message: `\`aid eval\` runs generated Python modules, and ${target.name} emits TypeScript.`,
+                    hint: 'The emitted eval module exports `sample()` and `evaluate(run, baseline)`; run it with Node.',
+                }),
+            ],
+        });
+    }
+    const interpreter = discoverInterpreter(context);
+    if (interpreter === undefined) {
+        return outcome({
+            command,
+            // Exit 2, not 1: nothing about the project was judged. The gate has no verdict when
+            // the thing that would run it cannot start, and `1` would read as "the evals failed".
+            exitCode: EXIT_USAGE,
+            fields: { ...fields, suites },
+            diagnostics: [
+                cliError({
+                    code: CLI_DIAGNOSTIC_CODES.pythonMissing,
+                    message: `No interpreter could import aid_runtime (tried ${INTERPRETERS.join(', ')}).`,
+                    hint: 'Install the runtime into the interpreter you run with, or run the generated eval modules yourself.',
+                }),
+            ],
+        });
+    }
+    const modules = suites.map((id) => target.evalModule(id));
+    const base = interpreterCommand(interpreter);
+    const common = { ...fields, suites, interpreter };
+    if (options.baseline) {
+        const recorded = invoke(context, [...base, '-'], baselineScript(modules));
+        if (recorded === undefined || recorded.status !== 0) {
+            return outcome({
+                command,
+                exitCode: EXIT_FAILURE,
+                fields: common,
+                diagnostics: [
+                    cliError({
+                        code: CLI_DIAGNOSTIC_CODES.runnerFailed,
+                        message: `Could not record a baseline with ${interpreter}.`,
+                        hint: 'Recording a baseline runs the evals, so it needs whatever they need; see the output for why they did not run.',
+                    }),
+                ],
+                text: recorded?.stdout.trimEnd() ?? '',
+                stderr: recorded?.stderr ?? '',
+            });
+        }
+        return outcome({
+            command,
+            exitCode: EXIT_OK,
+            fields: common,
+            text: recorded.stdout.trimEnd(),
+            stderr: recorded.stderr,
+        });
+    }
+    const results = [];
+    const output = [];
+    const spoken = [];
+    const diagnostics = [...declared.warnings];
+    for (const [index, module] of modules.entries()) {
+        const run = invoke(context, [...base, '-m', module]);
+        if (run === undefined) {
+            return outcome({
+                command,
+                exitCode: EXIT_USAGE,
+                fields: common,
+                diagnostics: [
+                    cliError({
+                        code: CLI_DIAGNOSTIC_CODES.runnerFailed,
+                        message: `Could not start ${interpreter} to run "${module}".`,
+                    }),
+                ],
+            });
+        }
+        const suite = suites[index] ?? module;
+        results.push({ suite, module, status: run.status ?? EXIT_FAILURE });
+        if (run.stdout.trim() !== '')
+            output.push(run.stdout.trimEnd());
+        // The generated `main()` prints its summary to stdout and exits non-zero on a
+        // regression; anything on stderr is the eval reporting something that did not fit in
+        // a metric. It is surfaced rather than swallowed, because a gate that hides what it
+        // could not measure is a gate that passes for the wrong reason -- and it is surfaced
+        // on stderr, including under `--json`, because that is where the process that wrote it
+        // wrote it, and `--json` replaces stdout with a document rather than with nothing.
+        if (run.stderr.trim() !== '') {
+            spoken.push(run.stderr.trimEnd());
+            diagnostics.push(cliWarning({
+                code: CLI_DIAGNOSTIC_CODES.runnerWarned,
+                message: `"${suite}" wrote to stderr.`,
+            }));
+        }
+    }
+    // A non-zero exit from a generated module *is* the gate's verdict, so it propagates
+    // rather than being reinterpreted here. The CLI reports the gate; it has no opinion
+    // about the numbers, and forming one would be the second implementation of the gate
+    // that this layer exists to avoid.
+    const failed = results.some((result) => result.status !== 0);
+    return outcome({
+        command,
+        exitCode: failed ? EXIT_FAILURE : EXIT_OK,
+        fields: { ...common, results },
+        diagnostics: sortDiagnostics(diagnostics),
+        text: output.join('\n'),
+        stderr: spoken.join('\n'),
+    });
+}
+//# sourceMappingURL=eval.js.map

package/dist/commands/eval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval.js","sourceRoot":"","sources":["../../src/commands/eval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAItD,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE/D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AASvE,yFAAyF;AACzF,SAAS,cAAc,CACrB,IAAY,EACZ,QAAgB;IAQhB,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;IACxE,MAAM,EAAE,GAAO,OAAO,CAAC,EAAE,CAAC;IAC1B,OAAO;QACL,EAAE,EAAE,IAAI;QACR,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QACtC,QAAQ,EAAE,OAAO,CAAC,WAAW;KAC9B,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,OAA0B;IAChD,OAAO;QACL,gBAAgB;QAChB,kBAAkB;QAClB,gBAAgB;QAChB,EAAE;QACF,4CAA4C;QAC5C,EAAE;QACF,aAAa,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE;QACtC,EAAE;QACF,sBAAsB;QACtB,4CAA4C;QAC5C,iFAAiF;QACjF,uCAAuC;QACvC,oCAAoC;QACpC,6BAA6B;QAC7B,mDAAmD;QACnD,OAAO;QACP,+CAA+C;QAC/C,oDAAoD;QACpD,2DAA2D;QAC3D,4BAA4B;QAC5B,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAQD,MAAM,UAAU,QAAQ,CAAC,OAAmB,EAAE,OAAoB;IAChE,MAAM,OAAO,GAAG,MAAM,CAAC;IACvB,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC;YACb,OAAO;YACP,QAAQ,EAAE,UAAU;YACpB,WAAW,EAAE,CAAC,uBAAuB,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC;IACjD,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;IAErF,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,OAAO,OAAO,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACrD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,OAAO,OAAO,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACjG,CAAC;IAED,mFAAmF;IACnF,mFAAmF;IACnF,8BAA8B;IAC9B,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzE,OAAO,OAAO,CAAC;YACb,OAAO;YACP,QAAQ,EAAE,UAAU;YACpB,MAAM;YACN,WAAW,EAAE;gBACX,QAAQ,CAAC;oBACP,IAAI,EAAE,oBAAoB,CAAC,aAAa;oBACxC,OAAO,EAAE,kBAAkB,OAAO,CAAC,KAAK,QAAQ,QAAQ,GAAG;oBAC3D,IAAI,EAAE,CAAC,QAAQ,CAAC;oBAChB,IAAI,EACF,QAAQ,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC;wBACrB,CAAC,CAAC,mBAAmB,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;wBAC/C,CAAC,CAAC,6BAA6B;iBACpC,CAAC;aACH;SACF,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAC3B,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,CAC1E,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,OAAO,CAAC;YACb,OAAO;YACP,QAAQ,EAAE,YAAY;YACtB,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE;YAC7B,WAAW,EAAE;gBACX,QAAQ,CAAC;oBACP,IAAI,EAAE,oBAAoB,CAAC,kBAAkB;oBAC7C,OAAO,EAAE,gCAAgC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;oBACrF,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;oBACpD,IAAI,EAAE,wEAAwE;iBAC/E,CAAC;aACH;SACF,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC;YACb,OAAO;YACP,gFAAgF;YAChF,8EAA8E;YAC9E,QAAQ,EAAE,UAAU;YACpB,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE;YAC7B,WAAW,EAAE;gBACX,QAAQ,CAAC;oBACP,IAAI,EAAE,oBAAoB,CAAC,iBAAiB;oBAC5C,OAAO,EAAE,mDAAmD,MAAM,CAAC,IAAI,oBAAoB;oBAC3F,IAAI,EAAE,6FAA6F;iBACpG,CAAC;aACH;SACF,CAAC,CAAC;IACL,CAAC;IAED,MAAM,WAAW,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC;YACb,OAAO;YACP,oFAAoF;YACpF,sFAAsF;YACtF,QAAQ,EAAE,UAAU;YACpB,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE;YAC7B,WAAW,EAAE;gBACX,QAAQ,CAAC;oBACP,IAAI,EAAE,oBAAoB,CAAC,aAAa;oBACxC,OAAO,EAAE,kDAAkD,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;oBACtF,IAAI,EAAE,oGAAoG;iBAC3G,CAAC;aACH;SACF,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAElD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1E,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,OAAO,OAAO,CAAC;gBACb,OAAO;gBACP,QAAQ,EAAE,YAAY;gBACtB,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE;oBACX,QAAQ,CAAC;wBACP,IAAI,EAAE,oBAAoB,CAAC,YAAY;wBACvC,OAAO,EAAE,oCAAoC,WAAW,GAAG;wBAC3D,IAAI,EAAE,+GAA+G;qBACtH,CAAC;iBACH;gBACD,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE;gBACtC,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,EAAE;aAC/B,CAAC,CAAC;QACL,CAAC;QACD,OAAO,OAAO,CAAC;YACb,OAAO;YACP,QAAQ,EAAE,OAAO;YACjB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE;YAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM;SACxB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAoB,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAE5D,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAChD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QACrD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,OAAO,OAAO,CAAC;gBACb,OAAO;gBACP,QAAQ,EAAE,UAAU;gBACpB,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE;oBACX,QAAQ,CAAC;wBACP,IAAI,EAAE,oBAAoB,CAAC,YAAY;wBACvC,OAAO,EAAE,mBAAmB,WAAW,YAAY,MAAM,IAAI;qBAC9D,CAAC;iBACH;aACF,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC,CAAC;QACpE,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAChE,8EAA8E;QAC9E,qFAAqF;QACrF,oFAAoF;QACpF,qFAAqF;QACrF,uFAAuF;QACvF,mFAAmF;QACnF,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAClC,WAAW,CAAC,IAAI,CACd,UAAU,CAAC;gBACT,IAAI,EAAE,oBAAoB,CAAC,YAAY;gBACvC,OAAO,EAAE,IAAI,KAAK,oBAAoB;aACvC,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC;IAED,oFAAoF;IACpF,oFAAoF;IACpF,oFAAoF;IACpF,mCAAmC;IACnC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;IAE7D,OAAO,OAAO,CAAC;QACb,OAAO;QACP,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO;QACzC,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE;QAC9B,WAAW,EAAE,eAAe,CAAC,WAAW,CAAC;QACzC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;KAC1B,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/gen.d.ts

@@ -0,0 +1,42 @@
+/**
+ * `aid gen` — compile the spec and reconcile the tree with it.
+ *
+ * Every decision about *what* changes belongs to `@aid-framework/generator-sdk`: `planRegeneration`
+ * decides the actions, `regenerate` applies them, and the drift rule that refuses to
+ * overwrite an edited generated file is the SDK's. The CLI decides four things and
+ * nothing else: which target, which spec, whether to write, and what the run's exit code
+ * means. In particular it does not re-derive ownership, re-hash a file, or re-implement
+ * drift -- two implementations of that rule would eventually disagree, and the one that
+ * disagreed would be the one holding a developer's edits.
+ *
+ * One deliberate divergence from `generate-example.mjs`, noted because it is a choice: the
+ * manifest is written even when the run reports drift. `regenerate` records the *previous*
+ * hash for a file it refused to overwrite, so a run that refuses an edit and a run that
+ * discards one cannot disagree about what is on the tree; skipping the manifest write
+ * instead leaves files that this run did create unrecorded, and the next run then reports
+ * those as drift even though the generator was the one that wrote them.
+ */
+import type { RegenerationReport } from '@aid-framework/generator-sdk';
+import type { CliContext } from '../context.js';
+import type { CliDiagnostic } from '../diagnostics.js';
+import type { CommandOutcome } from '../output.js';
+import type { Target } from '../targets.js';
+export interface GenerateOptions {
+    readonly spec: string | undefined;
+    readonly target: string | undefined;
+    readonly dryRun: boolean;
+    readonly force: boolean;
+}
+/** A spec that compiled and a plan that was reconciled, or the reason it was not. */
+export interface GenerateSuccess {
+    readonly target: Target;
+    readonly specPath: string;
+    readonly report: RegenerationReport;
+    readonly warnings: readonly CliDiagnostic[];
+    readonly dryRun: boolean;
+    readonly force: boolean;
+    readonly manifestWritten: boolean;
+}
+/** The public entry point, and the one `aid init --gen` folds into its own report. */
+export declare function generate(context: CliContext, options: GenerateOptions): CommandOutcome;
+//# sourceMappingURL=gen.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gen.d.ts","sourceRoot":"","sources":["../../src/commands/gen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAYvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAG5C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAwED,sFAAsF;AACtF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,GAAG,cAAc,CAEtF"}