@aid-framework/cli 0.0.0-stage → 0.1.39

package/dist/commands/gen.js

@@ -0,0 +1,138 @@
+/**
+ * `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 { createNodeSink, formatRegenerationSummary, hasDrift, planRegeneration, regenerate, rejectionPath, serializeAidManifest, } from '@aid-framework/generator-sdk';
+import { hasErrors, sortDiagnostics } from '@aid-framework/spec';
+import { EXIT_FAILURE, EXIT_OK, EXIT_USAGE } from '../exit.js';
+import { outcome } from '../output.js';
+import { compile, provenanceFor, readManifest, readSpec } from '../pipeline.js';
+import { resolveTarget, unknownTargetDiagnostic } from '../targets.js';
+function lines(label, paths) {
+    if (paths.length === 0)
+        return [];
+    return [label, ...paths.map((path) => `  ${path}`)];
+}
+function render(context, options) {
+    const command = 'gen';
+    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 };
+    const read = readSpec(context, specPath);
+    if (!read.ok) {
+        return outcome({ command, exitCode: EXIT_FAILURE, fields, diagnostics: read.diagnostics });
+    }
+    const compiled = compile(read.text, specPath, target);
+    if (!compiled.ok) {
+        return outcome({ command, exitCode: EXIT_FAILURE, fields, diagnostics: compiled.diagnostics });
+    }
+    const sink = createNodeSink(context.cwd);
+    const manifest = readManifest(sink, target);
+    if (!manifest.ok) {
+        return outcome({ command, exitCode: EXIT_FAILURE, fields, diagnostics: manifest.diagnostics });
+    }
+    const reconciliation = { sink, manifest: manifest.manifest, force: options.force };
+    if (options.dryRun) {
+        // A dry run takes the branch in which no write call exists at all, rather than the
+        // branch that writes and is then trusted not to. `planRegeneration` is the SDK's
+        // planner without its writer, so "writes nothing" is a property of the code path
+        // and not a promise in a comment.
+        return summarize({
+            target,
+            specPath,
+            report: planRegeneration(compiled.plan, reconciliation),
+            warnings: compiled.diagnostics,
+            dryRun: true,
+            force: options.force,
+            manifestWritten: false,
+        });
+    }
+    const applied = regenerate(compiled.plan, {
+        ...reconciliation,
+        provenance: provenanceFor(target, compiled.ir),
+    });
+    sink.write(target.manifestPath, serializeAidManifest(applied.manifest));
+    return summarize({
+        target,
+        specPath,
+        report: applied.report,
+        warnings: compiled.diagnostics,
+        dryRun: false,
+        force: options.force,
+        manifestWritten: true,
+    });
+}
+/** The public entry point, and the one `aid init --gen` folds into its own report. */
+export function generate(context, options) {
+    return render(context, options);
+}
+function summarize(success) {
+    const { report, target, specPath, warnings, dryRun, force, manifestWritten } = success;
+    const diagnostics = sortDiagnostics([...warnings, ...report.diagnostics]);
+    // Two ways to fail, and neither is redundant. `hasErrors` is the SDK's verdict on the
+    // run; `hasDrift` is checked alongside it rather than instead of it because drift is
+    // reported as an error today, and a gate that would stop failing if that changed is not
+    // a gate -- and drift is the one failure that silently destroys a developer's edits.
+    // `--force` is the caller answering it, so a run that discarded the edits did what it
+    // was told and exits 0; only an unforced run leaves drift outstanding.
+    const failed = hasErrors(diagnostics) || (!force && hasDrift(report));
+    const text = [
+        `${target.name}: ${dryRun ? 'dry run, ' : ''}${formatRegenerationSummary(report)}`,
+    ];
+    text.push(...lines('created:', report.created));
+    text.push(...lines('updated:', report.updated));
+    if (report.drifted.length > 0) {
+        text.push(dryRun ? 'would refuse to overwrite:' : 'refused to overwrite, the new content is beside it:');
+        for (const drift of report.drifted) {
+            text.push(`  ${drift.path}  ->  ${rejectionPath(drift.path)}`);
+        }
+    }
+    text.push(...lines('no longer generated:', report.stale));
+    return outcome({
+        command: 'gen',
+        exitCode: failed ? EXIT_FAILURE : EXIT_OK,
+        diagnostics,
+        text: text.join('\n'),
+        fields: {
+            target: target.name,
+            spec: specPath,
+            dryRun,
+            manifest: { path: target.manifestPath, written: manifestWritten },
+            changes: {
+                created: report.created,
+                updated: report.updated,
+                unchanged: report.unchanged,
+                kept: report.kept,
+                // Paths, like every sibling here: the report answers "which files", and the
+                // rejected content is on disk at the deterministic `rejectionPath` the human
+                // summary prints. Mixing record objects into one entry and strings into the rest
+                // makes the one shape a consumer has to special-case the one about conflicts.
+                conflicts: report.drifted.map((file) => file.path),
+                stale: report.stale,
+                pruned: report.pruned,
+            },
+        },
+    });
+}
+//# sourceMappingURL=gen.js.map

package/dist/commands/gen.js.map

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

package/dist/commands/ingest.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `aid ingest` -- run the generated ingest entry point for a retriever's corpus.
+ *
+ * **What this shells out to, and why.** Indexing is a batch job, not a request, so the
+ * generator emits one runnable module per declared retriever at
+ * `app/generated/retrieval/ingest/<id>.py`, with a `main()` that chunks, embeds and writes
+ * the corpus. That module is the interface: it already knows the chunking and the store the
+ * spec declared, and re-deriving either here would be a second implementation of the
+ * runtime's rules. So the command runs `python -m app.generated.retrieval.ingest.<id>` from
+ * the project root, which is also what a person would type by hand.
+ *
+ * **The flag shape is a usage error, not a project verdict.** `--retriever` and `--all` are
+ * the two ways to say what to ingest; passing both, or neither, is a mistake in the
+ * invocation and exits 2 before the spec is even read. An id the spec does not declare is
+ * the same kind of mistake, and its message names the ids that do exist -- a typo should
+ * not require opening the spec.
+ *
+ * **A missing module is a failure, not a usage error.** `--retriever handbook` in a project
+ * that has never been generated is a well-formed command that cannot do its job; it exits 1
+ * and points at `aid gen`. Exit 2 would tell a script that it passed the wrong arguments,
+ * which is false and hides the one action that fixes it.
+ *
+ * **`--dry-run` is forwarded, not implemented here.** The generated module already grows
+ * its own `--dry-run`, which applies the chunker and reports the counts a real run would
+ * write without opening a store or calling an embedder. Answering the same question in
+ * the CLI would mean re-chunking the corpus, and a second dry run that drifted from the
+ * one the module performs is worse than no dry run at all.
+ *
+ * **Idempotence is the runtime's, not a rescan this command performs.** A chunk id is a
+ * content hash, and the store upserts on it, so a second run over unchanged documents
+ * replaces rather than appends. The CLI adds no diffing of its own: it would have to
+ * reimplement the chunker to know what changed.
+ */
+import type { CliContext } from '../context.js';
+import type { CommandOutcome } from '../output.js';
+export interface IngestOptions {
+    readonly spec: string | undefined;
+    readonly target: string | undefined;
+    readonly retriever: string | undefined;
+    readonly all: boolean;
+    readonly dryRun: boolean;
+}
+export declare function ingest(context: CliContext, options: IngestOptions): CommandOutcome;
+//# sourceMappingURL=ingest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/commands/ingest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAOnD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AA+CD,wBAAgB,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,aAAa,GAAG,cAAc,CAiLlF"}

package/dist/commands/ingest.js

@@ -0,0 +1,238 @@
+/**
+ * `aid ingest` -- run the generated ingest entry point for a retriever's corpus.
+ *
+ * **What this shells out to, and why.** Indexing is a batch job, not a request, so the
+ * generator emits one runnable module per declared retriever at
+ * `app/generated/retrieval/ingest/<id>.py`, with a `main()` that chunks, embeds and writes
+ * the corpus. That module is the interface: it already knows the chunking and the store the
+ * spec declared, and re-deriving either here would be a second implementation of the
+ * runtime's rules. So the command runs `python -m app.generated.retrieval.ingest.<id>` from
+ * the project root, which is also what a person would type by hand.
+ *
+ * **The flag shape is a usage error, not a project verdict.** `--retriever` and `--all` are
+ * the two ways to say what to ingest; passing both, or neither, is a mistake in the
+ * invocation and exits 2 before the spec is even read. An id the spec does not declare is
+ * the same kind of mistake, and its message names the ids that do exist -- a typo should
+ * not require opening the spec.
+ *
+ * **A missing module is a failure, not a usage error.** `--retriever handbook` in a project
+ * that has never been generated is a well-formed command that cannot do its job; it exits 1
+ * and points at `aid gen`. Exit 2 would tell a script that it passed the wrong arguments,
+ * which is false and hides the one action that fixes it.
+ *
+ * **`--dry-run` is forwarded, not implemented here.** The generated module already grows
+ * its own `--dry-run`, which applies the chunker and reports the counts a real run would
+ * write without opening a store or calling an embedder. Answering the same question in
+ * the CLI would mean re-chunking the corpus, and a second dry run that drifted from the
+ * one the module performs is worse than no dry run at all.
+ *
+ * **Idempotence is the runtime's, not a rescan this command performs.** A chunk id is a
+ * content hash, and the store upserts on it, so a second run over unchanged documents
+ * replaces rather than appends. The CLI adds no diffing of its own: it would have to
+ * reimplement the chunker to know what changed.
+ */
+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';
+/** `Declared retrievers: a, b.`, or the truth when there are none. */
+function declaredHint(ids) {
+    return ids.length > 0
+        ? `Declared retrievers: ${ids.join(', ')}.`
+        : 'The spec declares no retrievers.';
+}
+/**
+ * The human rendering. One retriever prints the module's own report; several get a heading
+ * each, because two unlabelled "wrote N chunks" lines cannot be told apart.
+ */
+function render(results, stdout) {
+    const blocks = results.map((result, index) => {
+        const body = stdout[index]?.trimEnd() ?? '';
+        if (results.length === 1)
+            return body;
+        return [`==> ${result.retriever}`, body].filter((line) => line !== '').join('\n');
+    });
+    return blocks.filter((block) => block !== '').join('\n');
+}
+/** The `--retriever`/`--all` shape, which is decided without reading the project. */
+function checkFlagShape(options) {
+    if (options.retriever !== undefined && options.all) {
+        return cliError({
+            code: CLI_DIAGNOSTIC_CODES.retrieverConflict,
+            message: '`--retriever` and `--all` say two different things; pass one of them.',
+            hint: 'Use `--retriever <id>` for one retriever, or `--all` for every retriever the spec declares.',
+        });
+    }
+    if (options.retriever === undefined && !options.all) {
+        return cliError({
+            code: CLI_DIAGNOSTIC_CODES.retrieverRequired,
+            message: '`aid ingest` needs `--retriever <id>` or `--all`.',
+            hint: 'Use `--all` to ingest every retriever the spec declares.',
+        });
+    }
+    return undefined;
+}
+export function ingest(context, options) {
+    const command = 'ingest';
+    const target = resolveTarget(options.target);
+    if (target === undefined) {
+        return outcome({
+            command,
+            exitCode: EXIT_USAGE,
+            diagnostics: [unknownTargetDiagnostic(options.target ?? '')],
+        });
+    }
+    // The flag shape is judged before the project is touched: an invocation that asks two
+    // contradictory things is wrong whether or not the spec happens to be readable, and
+    // reporting a spec problem instead would bury the actual mistake.
+    const malformed = checkFlagShape(options);
+    if (malformed !== undefined) {
+        return outcome({ command, exitCode: EXIT_USAGE, diagnostics: [malformed] });
+    }
+    const specPath = options.spec ?? target.specPath;
+    const fields = { target: target.name, spec: specPath };
+    const read = readSpec(context, specPath);
+    if (!read.ok) {
+        return outcome({ command, exitCode: EXIT_FAILURE, fields, diagnostics: read.diagnostics });
+    }
+    const lowered = lowerSpec(read.text, specPath);
+    if (!lowered.ok) {
+        return outcome({ command, exitCode: EXIT_FAILURE, fields, diagnostics: lowered.diagnostics });
+    }
+    const declared = lowered.ir.retrievers.map((entry) => entry.id);
+    if (options.retriever !== undefined && !declared.includes(options.retriever)) {
+        return outcome({
+            command,
+            exitCode: EXIT_USAGE,
+            fields: { ...fields, retrievers: declared },
+            diagnostics: [
+                cliError({
+                    code: CLI_DIAGNOSTIC_CODES.retrieverNotFound,
+                    message: `No retriever named "${options.retriever}" in ${specPath}.`,
+                    path: [specPath],
+                    hint: declaredHint(declared),
+                }),
+            ],
+        });
+    }
+    // `--all` over a project that declares none is a well-formed request with nothing to do.
+    // It is not an error: a generated app with no retrieval is a legitimate app, and making
+    // its CI fail would force a `--retriever` that does not exist.
+    const selected = options.all || options.retriever === undefined ? declared : [options.retriever];
+    const scoped = { ...fields, retrievers: selected };
+    if (selected.length === 0) {
+        return outcome({
+            command,
+            exitCode: EXIT_OK,
+            fields: { ...scoped, results: [] },
+            diagnostics: sortDiagnostics(lowered.diagnostics),
+            text: 'No retrievers are declared; nothing to ingest.',
+        });
+    }
+    // A declared retriever whose module is absent is a project that has not been generated,
+    // not a misuse of the command. Checked before discovery so the message is about the
+    // missing artefact rather than about the interpreter that would have run it.
+    const missing = selected.filter((id) => !existsSync(absolutePath(context.cwd, target.retrievalIngestModuleFile(id))));
+    if (missing.length > 0) {
+        return outcome({
+            command,
+            exitCode: EXIT_FAILURE,
+            fields: scoped,
+            diagnostics: [
+                cliError({
+                    code: CLI_DIAGNOSTIC_CODES.ingestModulesMissing,
+                    message: `No generated ingest module for ${missing.map((id) => `"${id}"`).join(', ')}.`,
+                    path: missing.map((id) => target.retrievalIngestModuleFile(id)),
+                    hint: 'Run `aid gen`: the ingest entry points 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 nothing was
+            // ingested and the corpus was not judged.
+            exitCode: EXIT_USAGE,
+            fields: scoped,
+            diagnostics: [
+                cliError({
+                    code: CLI_DIAGNOSTIC_CODES.runnerUnsupported,
+                    message: `\`aid ingest\` runs generated Python modules, and ${target.name} emits TypeScript.`,
+                    hint: 'The emitted ingest module exports `ingest()`; run it with Node.',
+                }),
+            ],
+        });
+    }
+    const interpreter = discoverInterpreter(context);
+    if (interpreter === undefined) {
+        return outcome({
+            command,
+            // Exit 2, not 1: nothing about the project was judged. Ingest has no verdict when the
+            // thing that would run it cannot start, and `1` would read as "the corpus was wrong".
+            exitCode: EXIT_USAGE,
+            fields: scoped,
+            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 ingest modules yourself.',
+                }),
+            ],
+        });
+    }
+    const base = interpreterCommand(interpreter);
+    const results = [];
+    const stdout = [];
+    const spoken = [];
+    const diagnostics = [...lowered.diagnostics];
+    for (const id of selected) {
+        const module = target.retrievalIngestModule(id);
+        // Appended after the module name so it lands as an argument to the module, which owns
+        // what a dry run means -- see the header note.
+        const run = invoke(context, [...base, '-m', module, ...(options.dryRun ? ['--dry-run'] : [])]);
+        if (run === undefined) {
+            return outcome({
+                command,
+                exitCode: EXIT_USAGE,
+                fields: { ...scoped, interpreter },
+                diagnostics: [
+                    cliError({
+                        code: CLI_DIAGNOSTIC_CODES.runnerFailed,
+                        message: `Could not start ${interpreter} to run "${module}".`,
+                    }),
+                ],
+            });
+        }
+        results.push({ retriever: id, module, status: run.status ?? EXIT_FAILURE });
+        stdout.push(run.stdout);
+        // The module reports what it could not ingest on stderr. It is surfaced rather than
+        // swallowed, and on the CLI's stderr even under `--json`, because that is where the
+        // process that wrote it wrote it.
+        if (run.stderr.trim() !== '') {
+            spoken.push(run.stderr.trimEnd());
+            diagnostics.push(cliWarning({
+                code: CLI_DIAGNOSTIC_CODES.runnerWarned,
+                message: `"${id}" wrote to stderr.`,
+            }));
+        }
+    }
+    // A non-zero exit from a generated module is that module's verdict, so it propagates.
+    // Every selected retriever still runs: one corpus that could not be built should not
+    // hide the state of the others.
+    const failed = results.some((result) => result.status !== 0);
+    return outcome({
+        command,
+        exitCode: failed ? EXIT_FAILURE : EXIT_OK,
+        fields: { ...scoped, interpreter, results },
+        diagnostics: sortDiagnostics(diagnostics),
+        text: render(results, stdout),
+        stderr: spoken.join('\n'),
+    });
+}
+//# sourceMappingURL=ingest.js.map

package/dist/commands/ingest.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `aid init` — scaffold a project: a starter spec and a README.
+ *
+ * It does not generate. `aid gen` generates, and `--gen` is the convenience for the one
+ * thing a person types next; keeping the two apart is what makes "scaffold" and "compile"
+ * separately testable and separately re-runnable.
+ *
+ * Two deliberate refusals, because scaffolding is the command most likely to be pointed at
+ * a directory that already has something in it:
+ *
+ * - An existing spec is not overwritten without `--force`. That file is the project's
+ *   source of truth; replacing it silently is the worst thing this command could do.
+ * - An existing README is left exactly as it is, and reported as skipped -- under `--force`
+ *   too. A README is the file a directory is most likely to already have, its contents are
+ *   the author's, and `--force` here is usually aimed at the spec.
+ *
+ * `--from <spec>` imports a spec rather than copying one: the imported text has to lower to
+ * an IR and pass the gates before anything is written, so `aid init --from` cannot produce a
+ * project that `aid validate` immediately rejects.
+ */
+import type { CliContext } from '../context.js';
+import type { CommandOutcome } from '../output.js';
+export interface InitOptions {
+    readonly dir: string | undefined;
+    readonly from: string | undefined;
+    readonly target: string | undefined;
+    readonly force: boolean;
+    readonly gen: boolean;
+}
+/**
+ * A `project.name` from a directory name. The spec's pattern is `^[a-z][a-z0-9-]{0,63}$`,
+ * and a directory called `My App` or `2024-prototype` is not a reason to fail `aid init`
+ * with a schema error about a field the caller never wrote.
+ */
+export declare function projectNameFor(directory: string): string;
+export declare function starterSpec(target: string, projectName: string): string;
+export declare function init(context: CliContext, options: InitOptions): CommandOutcome;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAQnD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB;AA0BD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAYvE;AA+CD,wBAAgB,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,GAAG,cAAc,CA8F9E"}