@aid-framework/cli 0.1.59 → 0.1.61

package/dist/commands/cost.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `aid cost` — a cost and latency report read from the local trace sink.
+ *
+ * The numbers already exist. `runtimes/{python,typescript}` write one JSONL span per line
+ * whenever `AID_TRACE_DIR` is set, and those spans carry the GenAI token attributes and
+ * the priced `aid.cost.usd` the gateway computed. This command adds no pricing rule and
+ * no estimate: it reads what the runtime recorded and aggregates it. The build-time
+ * estimate is the IR's cost gate, and a second pricing implementation here would be a
+ * second answer to "what does this cost".
+ *
+ * Exit codes follow the CLI's taxonomy rather than "did the bill look big":
+ *
+ * - `2` when there is nowhere to read from (no directory, or one that does not exist), or
+ *   when `--since` is not a date. The invocation or the environment is wrong, so no
+ *   judgement about the project has been made.
+ * - `1` only when a trace file exists and could not be read. The report still prints what
+ *   was readable, because a partial report is more useful than none.
+ * - `0` otherwise, including for an empty directory: a report of zero spans is true, and
+ *   the warning on stderr says why it is zero.
+ */
+import type { CliContext } from '../context.js';
+import type { CommandOutcome } from '../output.js';
+export interface CostOptions {
+    /** The directory to read; defaults to `$AID_TRACE_DIR`. */
+    readonly dir: string | undefined;
+    readonly since: string | undefined;
+}
+export declare function cost(context: CliContext, options: CostOptions): CommandOutcome;
+//# sourceMappingURL=cost.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cost.d.ts","sourceRoot":"","sources":["../../src/commands/cost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAQnD,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAyDD,wBAAgB,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,GAAG,cAAc,CA4I9E"}

package/dist/commands/cost.js

@@ -0,0 +1,205 @@
+/**
+ * `aid cost` — a cost and latency report read from the local trace sink.
+ *
+ * The numbers already exist. `runtimes/{python,typescript}` write one JSONL span per line
+ * whenever `AID_TRACE_DIR` is set, and those spans carry the GenAI token attributes and
+ * the priced `aid.cost.usd` the gateway computed. This command adds no pricing rule and
+ * no estimate: it reads what the runtime recorded and aggregates it. The build-time
+ * estimate is the IR's cost gate, and a second pricing implementation here would be a
+ * second answer to "what does this cost".
+ *
+ * Exit codes follow the CLI's taxonomy rather than "did the bill look big":
+ *
+ * - `2` when there is nowhere to read from (no directory, or one that does not exist), or
+ *   when `--since` is not a date. The invocation or the environment is wrong, so no
+ *   judgement about the project has been made.
+ * - `1` only when a trace file exists and could not be read. The report still prints what
+ *   was readable, because a partial report is more useful than none.
+ * - `0` otherwise, including for an empty directory: a report of zero spans is true, and
+ *   the warning on stderr says why it is zero.
+ */
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { isAbsolute, join, relative, resolve, sep } from 'node:path';
+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 { parseSince, parseTraceLines, summariseSpans } from '../trace.js';
+/** The variable the runtimes read. Named here, not imported, because it is a runtime knob. */
+const TRACE_DIR_ENV = 'AID_TRACE_DIR';
+function displayPath(cwd, absolute) {
+    const path = relative(cwd, absolute);
+    if (path === '')
+        return '.';
+    if (path.startsWith('..') || isAbsolute(path))
+        return absolute;
+    return path.split(sep).join('/');
+}
+function group(value) {
+    return String(Math.trunc(value)).replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+}
+function usd(value) {
+    return `$${value.toFixed(6)}`;
+}
+function modelLines(models) {
+    if (models.length === 0)
+        return [];
+    const width = Math.max(...models.map((model) => model.model.length));
+    const lines = ['by model:'];
+    for (const model of models) {
+        const unpriced = model.unpricedCalls === 0 ? '' : `  (${model.unpricedCalls} unpriced)`;
+        lines.push([
+            `  ${model.model.padEnd(width)}`,
+            `${String(model.calls).padStart(4)} calls`,
+            `${group(model.inputTokens).padStart(9)} in`,
+            `${group(model.outputTokens).padStart(9)} out`,
+            usd(model.costUsd).padStart(14),
+            unpriced,
+        ].join('  '));
+    }
+    return lines;
+}
+function reportLines(summary, dir, since) {
+    const scope = since === undefined ? '' : ` since ${since}`;
+    const lines = [
+        `dir: ${dir}`,
+        `spans: ${group(summary.spans)} in ${group(summary.traces)} trace(s)${scope}`,
+        summary.unpricedSpans === 0
+            ? `cost: ${usd(summary.costUsd)}`
+            : `cost: ${usd(summary.costUsd)} (${summary.unpricedSpans} unpriced span(s) not included)`,
+        `tokens: ${group(summary.inputTokens)} input, ${group(summary.outputTokens)} output`,
+    ];
+    if (summary.latency !== undefined) {
+        lines.push(`latency: p50 ${group(summary.latency.p50)}ms, p95 ${group(summary.latency.p95)}ms over ${group(summary.latency.samples)} model call(s)`);
+    }
+    if (summary.errors > 0)
+        lines.push(`errors: ${group(summary.errors)} span(s)`);
+    lines.push(...modelLines(summary.models));
+    return lines;
+}
+export function cost(context, options) {
+    const command = 'cost';
+    const configured = options.dir ?? context.env[TRACE_DIR_ENV]?.trim();
+    if (configured === undefined || configured === '') {
+        return outcome({
+            command,
+            exitCode: EXIT_USAGE,
+            diagnostics: [
+                cliError({
+                    code: CLI_DIAGNOSTIC_CODES.traceDirMissing,
+                    message: `no trace directory: \`aid cost\` needs one to read.`,
+                    hint: `Pass it as \`aid ${command} <dir>\`, or set ${TRACE_DIR_ENV} to the directory the runtime writes to.`,
+                }),
+            ],
+            text: `aid: no trace directory. Pass one, or set ${TRACE_DIR_ENV}.\n`,
+        });
+    }
+    let since;
+    if (options.since !== undefined) {
+        since = parseSince(options.since);
+        if (since === undefined) {
+            return outcome({
+                command,
+                exitCode: EXIT_USAGE,
+                diagnostics: [
+                    cliError({
+                        code: CLI_DIAGNOSTIC_CODES.traceSinceInvalid,
+                        message: `--since "${options.since}" is not a date.`,
+                        hint: 'Use YYYY-MM-DD (UTC midnight) or an ISO 8601 instant with an offset, such as 2026-10-01T12:00:00Z.',
+                    }),
+                ],
+                text: `aid: --since "${options.since}" is not a date.\n`,
+            });
+        }
+    }
+    const absolute = resolve(context.cwd, configured);
+    const shown = displayPath(context.cwd, absolute);
+    const diagnostics = [];
+    let isDirectory = false;
+    try {
+        isDirectory = statSync(absolute).isDirectory();
+    }
+    catch {
+        isDirectory = false;
+    }
+    if (!isDirectory) {
+        return outcome({
+            command,
+            exitCode: EXIT_USAGE,
+            diagnostics: [
+                cliError({
+                    code: CLI_DIAGNOSTIC_CODES.traceDirNotFound,
+                    message: `"${shown}" is not a directory.`,
+                    hint: `Point \`aid ${command}\` at the directory ${TRACE_DIR_ENV} names, or unset it to be told which is missing.`,
+                }),
+            ],
+            text: `aid: "${shown}" is not a directory.\n`,
+        });
+    }
+    const names = readdirSync(absolute, { withFileTypes: true })
+        .filter((entry) => entry.isFile() && entry.name.endsWith('.jsonl'))
+        .map((entry) => entry.name)
+        .sort();
+    let skipped = 0;
+    const all = [];
+    let unreadable = 0;
+    for (const name of names) {
+        let text;
+        try {
+            text = readFileSync(join(absolute, name), 'utf8');
+        }
+        catch {
+            // Counted, not thrown: one unreadable file should not hide the spans in the rest.
+            unreadable += 1;
+            continue;
+        }
+        const parsed = parseTraceLines(text);
+        all.push(...parsed.spans);
+        skipped += parsed.skipped;
+    }
+    if (unreadable > 0) {
+        diagnostics.push(cliError({
+            code: CLI_DIAGNOSTIC_CODES.traceUnreadable,
+            message: `could not read ${unreadable} trace file(s) in "${shown}": the report covers only the files that were readable.`,
+            hint: 'Check the file permissions, or move the unreadable file out of the directory.',
+        }));
+    }
+    if (skipped > 0) {
+        diagnostics.push(cliWarning({
+            code: CLI_DIAGNOSTIC_CODES.traceMalformed,
+            message: `skipped ${skipped} line(s) in "${shown}" that are not complete span records.`,
+            hint: 'A trace file is appended to while it is read, so a truncated last line is normal; a large count is not.',
+        }));
+    }
+    if (names.length === 0) {
+        diagnostics.push(cliWarning({
+            code: CLI_DIAGNOSTIC_CODES.traceEmpty,
+            message: `no trace files in "${shown}".`,
+            hint: `The runtime writes one when ${TRACE_DIR_ENV} is set and a model call runs; check that this is the directory it names.`,
+        }));
+    }
+    const summary = summariseSpans(all, since === undefined ? {} : { since });
+    const exitCode = unreadable > 0 ? EXIT_FAILURE : EXIT_OK;
+    return outcome({
+        command,
+        exitCode,
+        fields: {
+            dir: shown,
+            ...(since === undefined ? {} : { since }),
+            files: names.length,
+            spans: summary.spans,
+            traces: summary.traces,
+            errors: summary.errors,
+            inputTokens: summary.inputTokens,
+            outputTokens: summary.outputTokens,
+            costUsd: summary.costUsd,
+            unpricedSpans: summary.unpricedSpans,
+            ...(summary.latency === undefined
+                ? {}
+                : { latencyMs: { p50: summary.latency.p50, p95: summary.latency.p95 } }),
+            models: summary.models,
+        },
+        diagnostics,
+        text: reportLines(summary, shown, since).join('\n'),
+    });
+}
+//# sourceMappingURL=cost.js.map

package/dist/commands/cost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.js","sourceRoot":"","sources":["../../src/commands/cost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAIrE,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;AAEvC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE1E,8FAA8F;AAC9F,MAAM,aAAa,GAAG,eAAe,CAAC;AAQtC,SAAS,WAAW,CAAC,GAAW,EAAE,QAAgB;IAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACrC,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC/D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,KAAK,CAAC,KAAa;IAC1B,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,GAAG,CAAC,KAAa;IACxB,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAChC,CAAC;AAED,SAAS,UAAU,CAAC,MAA6B;IAC/C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,CAAC,WAAW,CAAC,CAAC;IAC5B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,KAAK,CAAC,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,aAAa,YAAY,CAAC;QACxF,KAAK,CAAC,IAAI,CACR;YACE,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;YAChC,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;YAC1C,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK;YAC5C,GAAG,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM;YAC9C,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,QAAQ;SACT,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,OAAoB,EAAE,GAAW,EAAE,KAAyB;IAC/E,MAAM,KAAK,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,EAAE,CAAC;IAC3D,MAAM,KAAK,GAAG;QACZ,QAAQ,GAAG,EAAE;QACb,UAAU,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,KAAK,EAAE;QAC7E,OAAO,CAAC,aAAa,KAAK,CAAC;YACzB,CAAC,CAAC,SAAS,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YACjC,CAAC,CAAC,SAAS,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,aAAa,iCAAiC;QAC5F,WAAW,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,WAAW,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS;KACrF,CAAC;IACF,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CACR,gBAAgB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CACzI,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC/E,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAmB,EAAE,OAAoB;IAC5D,MAAM,OAAO,GAAG,MAAM,CAAC;IAEvB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC;IACrE,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;QAClD,OAAO,OAAO,CAAC;YACb,OAAO;YACP,QAAQ,EAAE,UAAU;YACpB,WAAW,EAAE;gBACX,QAAQ,CAAC;oBACP,IAAI,EAAE,oBAAoB,CAAC,eAAe;oBAC1C,OAAO,EAAE,qDAAqD;oBAC9D,IAAI,EAAE,oBAAoB,OAAO,oBAAoB,aAAa,0CAA0C;iBAC7G,CAAC;aACH;YACD,IAAI,EAAE,6CAA6C,aAAa,KAAK;SACtE,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAyB,CAAC;IAC9B,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,OAAO,CAAC;gBACb,OAAO;gBACP,QAAQ,EAAE,UAAU;gBACpB,WAAW,EAAE;oBACX,QAAQ,CAAC;wBACP,IAAI,EAAE,oBAAoB,CAAC,iBAAiB;wBAC5C,OAAO,EAAE,YAAY,OAAO,CAAC,KAAK,kBAAkB;wBACpD,IAAI,EAAE,oGAAoG;qBAC3G,CAAC;iBACH;gBACD,IAAI,EAAE,iBAAiB,OAAO,CAAC,KAAK,oBAAoB;aACzD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,WAAW,GAAoB,EAAE,CAAC;IACxC,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,CAAC;QACH,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,WAAW,GAAG,KAAK,CAAC;IACtB,CAAC;IACD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,OAAO,CAAC;YACb,OAAO;YACP,QAAQ,EAAE,UAAU;YACpB,WAAW,EAAE;gBACX,QAAQ,CAAC;oBACP,IAAI,EAAE,oBAAoB,CAAC,gBAAgB;oBAC3C,OAAO,EAAE,IAAI,KAAK,uBAAuB;oBACzC,IAAI,EAAE,eAAe,OAAO,uBAAuB,aAAa,kDAAkD;iBACnH,CAAC;aACH;YACD,IAAI,EAAE,SAAS,KAAK,yBAAyB;SAC9C,CAAC,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACzD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;SAClE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;SAC1B,IAAI,EAAE,CAAC;IAEV,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,kFAAkF;YAClF,UAAU,IAAI,CAAC,CAAC;YAChB,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACrC,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC;IAC5B,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnB,WAAW,CAAC,IAAI,CACd,QAAQ,CAAC;YACP,IAAI,EAAE,oBAAoB,CAAC,eAAe;YAC1C,OAAO,EAAE,kBAAkB,UAAU,sBAAsB,KAAK,yDAAyD;YACzH,IAAI,EAAE,+EAA+E;SACtF,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,WAAW,CAAC,IAAI,CACd,UAAU,CAAC;YACT,IAAI,EAAE,oBAAoB,CAAC,cAAc;YACzC,OAAO,EAAE,WAAW,OAAO,gBAAgB,KAAK,uCAAuC;YACvF,IAAI,EAAE,yGAAyG;SAChH,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,WAAW,CAAC,IAAI,CACd,UAAU,CAAC;YACT,IAAI,EAAE,oBAAoB,CAAC,UAAU;YACrC,OAAO,EAAE,sBAAsB,KAAK,IAAI;YACxC,IAAI,EAAE,+BAA+B,aAAa,2EAA2E;SAC9H,CAAC,CACH,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC;IAEzD,OAAO,OAAO,CAAC;QACb,OAAO;QACP,QAAQ;QACR,MAAM,EAAE;YACN,GAAG,EAAE,KAAK;YACV,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;YACzC,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS;gBAC/B,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;YAC1E,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB;QACD,WAAW;QACX,IAAI,EAAE,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;KACpD,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/dev.d.ts

@@ -0,0 +1,53 @@
+/**
+ * `aid dev` -- compile the spec, reconcile the tree, and run the application.
+ *
+ * **Why generation is part of it.** The command's whole promise is "the spec you just
+ * edited is the thing serving requests", and a `dev` that started a server against a tree
+ * compiled from an older spec would answer from code the developer is no longer looking
+ * at. So it runs the same generator the `gen` command does, and if generation fails it
+ * does not start the server: a tree that could not be reconciled is not a tree to serve.
+ *
+ * **Why it starts the target's own server instead of one of its own.** The Python target
+ * emits routers; the application owns `app/main.py` and decides what to mount and how to
+ * run it (the generator says so in its own comments). A dev server implemented here would
+ * be a second, competing way to run the same app, and it would drift. So this command
+ * spawns the module the application already declares, which is also what a person types by
+ * hand: `python -m uvicorn app.main:app`. `-m uvicorn` rather than the `uvicorn` binary,
+ * because the probe that proved the interpreter can import the runtime also proves it can
+ * import uvicorn; a `uvicorn` script on `PATH` proves neither.
+ *
+ * **Why a target may refuse.** `ts-vercel` is a deployment target: it emits route handlers
+ * that Next mounts, and ships no server of its own to start. Inventing one here would be
+ * exactly the competing dev server the previous paragraph rules out. The registry declares
+ * that per target, so this command refuses with a reason rather than guessing.
+ *
+ * **Why the start banner is printed by the command.** Every other command returns text and
+ * lets the dispatcher print it. This one hands the terminal to a child for an unbounded
+ * time, so a banner returned after the server exits would arrive after the log it was
+ * meant to introduce. The banner and the generation summary are therefore written as they
+ * happen, and the returned text is only the farewell.
+ *
+ * **Why there is no `--json`.** A JSON document is a verdict about a finished run. `dev`
+ * produces a running process and a stream of server output, so the honest answers are "a
+ * document that lies about when the run ended" or "a document interrupted by logs". It
+ * refuses `--json` as a usage error instead of emitting something that cannot be parsed.
+ *
+ * **What is not watched.** uvicorn's `--reload` reloads on changes to the code it imported,
+ * and that is left on by default. The *spec* is not watched: regenerating it needs the
+ * generator to run again, and doing that from a synchronous command would mean the
+ * dispatcher grew an event loop for one command. Restart `aid dev` after editing the spec;
+ * the generation step makes that restart cheap and the tree correct either way.
+ */
+import type { CliContext } from '../context.js';
+import type { CommandOutcome } from '../output.js';
+export interface DevOptions {
+    readonly spec: string | undefined;
+    readonly target: string | undefined;
+    readonly port: string | undefined;
+    /** Skip regeneration and serve the tree as it is. */
+    readonly noGen: boolean;
+    /** Turn off uvicorn's own reloader. */
+    readonly noReload: boolean;
+}
+export declare function dev(context: CliContext, options: DevOptions): CommandOutcome;
+//# sourceMappingURL=dev.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAOnD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAaD,wBAAgB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,GAAG,cAAc,CA6L5E"}

package/dist/commands/dev.js

@@ -0,0 +1,235 @@
+/**
+ * `aid dev` -- compile the spec, reconcile the tree, and run the application.
+ *
+ * **Why generation is part of it.** The command's whole promise is "the spec you just
+ * edited is the thing serving requests", and a `dev` that started a server against a tree
+ * compiled from an older spec would answer from code the developer is no longer looking
+ * at. So it runs the same generator the `gen` command does, and if generation fails it
+ * does not start the server: a tree that could not be reconciled is not a tree to serve.
+ *
+ * **Why it starts the target's own server instead of one of its own.** The Python target
+ * emits routers; the application owns `app/main.py` and decides what to mount and how to
+ * run it (the generator says so in its own comments). A dev server implemented here would
+ * be a second, competing way to run the same app, and it would drift. So this command
+ * spawns the module the application already declares, which is also what a person types by
+ * hand: `python -m uvicorn app.main:app`. `-m uvicorn` rather than the `uvicorn` binary,
+ * because the probe that proved the interpreter can import the runtime also proves it can
+ * import uvicorn; a `uvicorn` script on `PATH` proves neither.
+ *
+ * **Why a target may refuse.** `ts-vercel` is a deployment target: it emits route handlers
+ * that Next mounts, and ships no server of its own to start. Inventing one here would be
+ * exactly the competing dev server the previous paragraph rules out. The registry declares
+ * that per target, so this command refuses with a reason rather than guessing.
+ *
+ * **Why the start banner is printed by the command.** Every other command returns text and
+ * lets the dispatcher print it. This one hands the terminal to a child for an unbounded
+ * time, so a banner returned after the server exits would arrive after the log it was
+ * meant to introduce. The banner and the generation summary are therefore written as they
+ * happen, and the returned text is only the farewell.
+ *
+ * **Why there is no `--json`.** A JSON document is a verdict about a finished run. `dev`
+ * produces a running process and a stream of server output, so the honest answers are "a
+ * document that lies about when the run ended" or "a document interrupted by logs". It
+ * refuses `--json` as a usage error instead of emitting something that cannot be parsed.
+ *
+ * **What is not watched.** uvicorn's `--reload` reloads on changes to the code it imported,
+ * and that is left on by default. The *spec* is not watched: regenerating it needs the
+ * generator to run again, and doing that from a synchronous command would mean the
+ * dispatcher grew an event loop for one command. Restart `aid dev` after editing the spec;
+ * the generation step makes that restart cheap and the tree correct either way.
+ */
+import { existsSync } from 'node:fs';
+import { sortDiagnostics } from '@aid-framework/spec';
+import { CLI_DIAGNOSTIC_CODES, cliError } from '../diagnostics.js';
+import { EXIT_FAILURE, EXIT_OK, EXIT_USAGE } from '../exit.js';
+import { outcome } from '../output.js';
+import { absolutePath } from '../paths.js';
+import { DEV_PROBE, discoverInterpreter, INTERPRETERS, interpreterCommand } from '../python.js';
+import { resolveTarget, unknownTargetDiagnostic } from '../targets.js';
+import { generate } from './gen.js';
+/** uvicorn's own default, so `aid dev` and `uvicorn app.main:app` agree. */
+const DEFAULT_PORT = 8000;
+/** The port, or `undefined` when the flag could not have meant one. */
+function parsePort(raw) {
+    if (raw === undefined)
+        return DEFAULT_PORT;
+    if (!/^\d+$/.test(raw))
+        return undefined;
+    const port = Number(raw);
+    return port >= 1 && port <= 65_535 ? port : undefined;
+}
+export function dev(context, options) {
+    const command = 'dev';
+    const target = resolveTarget(options.target);
+    if (target === undefined) {
+        return outcome({
+            command,
+            exitCode: EXIT_USAGE,
+            diagnostics: [unknownTargetDiagnostic(options.target ?? '')],
+        });
+    }
+    // Before the project is touched: a port that is not a port is a mistake in the
+    // invocation, and reporting a spec problem instead would bury the actual mistake.
+    const port = parsePort(options.port);
+    if (port === undefined) {
+        return outcome({
+            command,
+            exitCode: EXIT_USAGE,
+            diagnostics: [
+                cliError({
+                    code: CLI_DIAGNOSTIC_CODES.devPortInvalid,
+                    message: `\`--port\` needs an integer between 1 and 65535, got "${options.port}".`,
+                }),
+            ],
+        });
+    }
+    const specPath = options.spec ?? target.specPath;
+    const fields = { target: target.name, spec: specPath, port };
+    const surface = target.dev;
+    if (surface.kind === 'none') {
+        return outcome({
+            command,
+            // Exit 2, not 1: no server was started and no project was judged, so nothing here
+            // is a verdict about the tree.
+            exitCode: EXIT_USAGE,
+            fields,
+            diagnostics: [
+                cliError({
+                    code: CLI_DIAGNOSTIC_CODES.runnerUnsupported,
+                    message: `\`aid dev\` cannot start ${target.name}: ${surface.reason}.`,
+                    hint: 'Run the application with the server its platform provides; `aid gen` still compiles and reconciles the tree.',
+                }),
+            ],
+        });
+    }
+    const diagnostics = [];
+    if (!options.noGen) {
+        const generated = generate(context, {
+            spec: options.spec,
+            target: options.target,
+            dryRun: false,
+            force: false,
+            check: false,
+        });
+        if (generated.exitCode !== EXIT_OK) {
+            // The generator's own summary and diagnostics are the answer: it is the same
+            // failure `aid gen` would have reported, and renaming it here would hide that.
+            return outcome({
+                command,
+                exitCode: generated.exitCode,
+                fields,
+                diagnostics: generated.diagnostics,
+                text: generated.text,
+            });
+        }
+        if (generated.text !== '')
+            context.stdout(`${generated.text}\n`);
+        diagnostics.push(...generated.diagnostics);
+    }
+    // The entry point is the application's own file, not a generated one, so its absence
+    // means the project was never set up rather than never regenerated. Named explicitly
+    // because "app/main.py is missing" is the one thing the reader needs to know.
+    const entry = absolutePath(context.cwd, surface.entry);
+    if (!existsSync(entry)) {
+        return outcome({
+            command,
+            exitCode: EXIT_FAILURE,
+            fields,
+            diagnostics: [
+                cliError({
+                    code: CLI_DIAGNOSTIC_CODES.devEntryMissing,
+                    message: `No ASGI entry point at ${surface.entry}.`,
+                    path: [surface.entry],
+                    hint: 'Run `aid init` for a starter entry point, or run `aid dev` from the directory that contains the generated app.',
+                }),
+            ],
+        });
+    }
+    const interpreter = discoverInterpreter(context, DEV_PROBE);
+    if (interpreter === undefined) {
+        return outcome({
+            command,
+            // Exit 2: the project was not judged, because nothing could start it.
+            exitCode: EXIT_USAGE,
+            fields,
+            diagnostics: [
+                cliError({
+                    code: CLI_DIAGNOSTIC_CODES.devUvicornMissing,
+                    message: `No interpreter can import both aid_runtime and uvicorn (tried ${INTERPRETERS.join(', ')}).`,
+                    hint: 'Install the runtime and uvicorn into the interpreter you run with, or run `python -m uvicorn` yourself.',
+                }),
+            ],
+        });
+    }
+    const argv = [
+        ...interpreterCommand(interpreter),
+        '-m',
+        'uvicorn',
+        surface.module,
+        '--host',
+        '127.0.0.1',
+        '--port',
+        String(port),
+        ...(options.noReload ? [] : ['--reload']),
+    ];
+    // Bound to loopback on purpose: a dev server is for the machine it runs on, and a
+    // `0.0.0.0` default quietly exposes a half-built app to the network.
+    context.stdout([
+        `${target.name}: serving ${surface.module} on http://127.0.0.1:${port}${options.noReload ? '' : ' (reload on)'}`,
+        `  ${argv.join(' ')}`,
+        'Press Ctrl-C to stop.',
+        '',
+    ].join('\n'));
+    const run = context.spawn(argv[0] ?? interpreter, argv.slice(1), {
+        cwd: context.cwd,
+        stdio: 'inherit',
+        env: context.env,
+    });
+    if (run.error !== undefined) {
+        return outcome({
+            command,
+            exitCode: EXIT_USAGE,
+            fields: { ...fields, interpreter },
+            diagnostics: [
+                cliError({
+                    code: CLI_DIAGNOSTIC_CODES.runnerFailed,
+                    message: `Could not start ${interpreter} to run "${surface.module}": ${run.error.message}`,
+                }),
+            ],
+        });
+    }
+    // A null status means the child was ended by a signal, which for a foreground server is
+    // how Ctrl-C arrives. Reporting that as a failure would make stopping the dev server
+    // look like the server broke.
+    if (run.status === null) {
+        return outcome({
+            command,
+            exitCode: EXIT_OK,
+            fields: { ...fields, interpreter, stopped: true },
+            diagnostics: sortDiagnostics(diagnostics),
+            text: 'server stopped.',
+        });
+    }
+    if (run.status !== 0) {
+        return outcome({
+            command,
+            exitCode: EXIT_FAILURE,
+            fields: { ...fields, interpreter, status: run.status },
+            diagnostics: sortDiagnostics([
+                ...diagnostics,
+                cliError({
+                    code: CLI_DIAGNOSTIC_CODES.runnerFailed,
+                    message: `The server exited with status ${run.status}.`,
+                }),
+            ]),
+        });
+    }
+    return outcome({
+        command,
+        exitCode: EXIT_OK,
+        fields: { ...fields, interpreter },
+        diagnostics: sortDiagnostics(diagnostics),
+        text: 'server stopped.',
+    });
+}
+//# sourceMappingURL=dev.js.map

package/dist/commands/dev.js.map

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

package/dist/diagnostics.d.ts

@@ -48,6 +48,15 @@ export declare const CLI_DIAGNOSTIC_CODES: {
     readonly infraDriftDetected: 'cli/infra-drift-detected';
     readonly infraConfirmProdRequired: 'cli/infra-confirm-prod-required';
     readonly ejectUnmanagedPath: 'cli/eject-unmanaged-path';
+    readonly traceDirMissing: 'cli/trace-dir-missing';
+    readonly traceDirNotFound: 'cli/trace-dir-not-found';
+    readonly traceSinceInvalid: 'cli/trace-since-invalid';
+    readonly traceUnreadable: 'cli/trace-unreadable';
+    readonly traceMalformed: 'cli/trace-malformed';
+    readonly traceEmpty: 'cli/trace-empty';
+    readonly devPortInvalid: 'cli/dev-port-invalid';
+    readonly devEntryMissing: 'cli/dev-entry-missing';
+    readonly devUvicornMissing: 'cli/dev-uvicorn-missing';
 };
 export type CliDiagnosticCode = (typeof CLI_DIAGNOSTIC_CODES)[keyof typeof CLI_DIAGNOSTIC_CODES];
 export interface CliDiagnosticInit {

package/dist/diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,gEAAgE;AAChE,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;AAE/C,eAAO,MAAM,oBAAoB;aAC/B,cAAc,EAAE,qBAAqB;aACrC,aAAa,EAAE,oBAAoB;aACnC,mBAAmB,EAAE,2BAA2B;aAChD,aAAa,EAAE,oBAAoB;aACnC,aAAa,EAAE,qBAAqB;aACpC,kBAAkB,EAAE,0BAA0B;aAC9C,iBAAiB,EAAE,wBAAwB;aAC3C,iBAAiB,EAAE,wBAAwB;aAC3C,iBAAiB,EAAE,yBAAyB;aAC5C,oBAAoB,EAAE,4BAA4B;aAClD,iBAAiB,EAAE,wBAAwB;aAC3C,YAAY,EAAE,mBAAmB;aACjC,YAAY,EAAE,mBAAmB;aAGjC,eAAe,EAAE,sBAAsB;aACvC,kBAAkB,EAAE,yBAAyB;aAC7C,eAAe,EAAE,sBAAsB;aACvC,YAAY,EAAE,mBAAmB;aACjC,eAAe,EAAE,sBAAsB;aACvC,aAAa,EAAE,oBAAoB;aAGnC,uBAAuB,EAAE,+BAA+B;aACxD,sBAAsB,EAAE,8BAA8B;aACtD,eAAe,EAAE,uBAAuB;aACxC,sBAAsB,EAAE,8BAA8B;aACtD,iBAAiB,EAAE,yBAAyB;aAC5C,mBAAmB,EAAE,4BAA4B;aACjD,gBAAgB,EAAE,wBAAwB;aAC1C,eAAe,EAAE,uBAAuB;aACxC,eAAe,EAAE,uBAAuB;aACxC,cAAc,EAAE,sBAAsB;aACtC,kBAAkB,EAAE,0BAA0B;aAC9C,wBAAwB,EAAE,iCAAiC;aAI3D,kBAAkB,EAAE,0BAA0B;CACtC,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AAEjG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAO/D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAOjE"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,gEAAgE;AAChE,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;AAE/C,eAAO,MAAM,oBAAoB;aAC/B,cAAc,EAAE,qBAAqB;aACrC,aAAa,EAAE,oBAAoB;aACnC,mBAAmB,EAAE,2BAA2B;aAChD,aAAa,EAAE,oBAAoB;aACnC,aAAa,EAAE,qBAAqB;aACpC,kBAAkB,EAAE,0BAA0B;aAC9C,iBAAiB,EAAE,wBAAwB;aAC3C,iBAAiB,EAAE,wBAAwB;aAC3C,iBAAiB,EAAE,yBAAyB;aAC5C,oBAAoB,EAAE,4BAA4B;aAClD,iBAAiB,EAAE,wBAAwB;aAC3C,YAAY,EAAE,mBAAmB;aACjC,YAAY,EAAE,mBAAmB;aAGjC,eAAe,EAAE,sBAAsB;aACvC,kBAAkB,EAAE,yBAAyB;aAC7C,eAAe,EAAE,sBAAsB;aACvC,YAAY,EAAE,mBAAmB;aACjC,eAAe,EAAE,sBAAsB;aACvC,aAAa,EAAE,oBAAoB;aAGnC,uBAAuB,EAAE,+BAA+B;aACxD,sBAAsB,EAAE,8BAA8B;aACtD,eAAe,EAAE,uBAAuB;aACxC,sBAAsB,EAAE,8BAA8B;aACtD,iBAAiB,EAAE,yBAAyB;aAC5C,mBAAmB,EAAE,4BAA4B;aACjD,gBAAgB,EAAE,wBAAwB;aAC1C,eAAe,EAAE,uBAAuB;aACxC,eAAe,EAAE,uBAAuB;aACxC,cAAc,EAAE,sBAAsB;aACtC,kBAAkB,EAAE,0BAA0B;aAC9C,wBAAwB,EAAE,iCAAiC;aAI3D,kBAAkB,EAAE,0BAA0B;aAI9C,eAAe,EAAE,uBAAuB;aACxC,gBAAgB,EAAE,yBAAyB;aAC3C,iBAAiB,EAAE,yBAAyB;aAC5C,eAAe,EAAE,sBAAsB;aACvC,cAAc,EAAE,qBAAqB;aACrC,UAAU,EAAE,iBAAiB;aAI7B,cAAc,EAAE,sBAAsB;aACtC,eAAe,EAAE,uBAAuB;aACxC,iBAAiB,EAAE,yBAAyB;CACpC,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AAEjG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAO/D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAOjE"}

package/dist/diagnostics.js

@@ -53,6 +53,21 @@ export const CLI_DIAGNOSTIC_CODES = {
     // with a `generator/` code, so a reader can tell "you named the wrong tree" from
     // "this file cannot be ejected".
     ejectUnmanagedPath: 'cli/eject-unmanaged-path',
+    // `aid cost` reads the runtime's local trace sink. The first two mean there is
+    // nothing to read (exit 2); the last three describe a report that is incomplete or
+    // empty, which is a fact about the traces rather than about the invocation.
+    traceDirMissing: 'cli/trace-dir-missing',
+    traceDirNotFound: 'cli/trace-dir-not-found',
+    traceSinceInvalid: 'cli/trace-since-invalid',
+    traceUnreadable: 'cli/trace-unreadable',
+    traceMalformed: 'cli/trace-malformed',
+    traceEmpty: 'cli/trace-empty',
+    // `aid dev` starts the application's own server, so every failure here is about the
+    // environment it needs or the address it was given -- not about the spec, which `gen`
+    // has already validated by the time any of these can fire.
+    devPortInvalid: 'cli/dev-port-invalid',
+    devEntryMissing: 'cli/dev-entry-missing',
+    devUvicornMissing: 'cli/dev-uvicorn-missing',
 };
 export function cliError(init) {
     return errorDiagnostic({

package/dist/diagnostics.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAKzE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,cAAc,EAAE,qBAAqB;IACrC,aAAa,EAAE,oBAAoB;IACnC,mBAAmB,EAAE,2BAA2B;IAChD,aAAa,EAAE,oBAAoB;IACnC,aAAa,EAAE,qBAAqB;IACpC,kBAAkB,EAAE,0BAA0B;IAC9C,iBAAiB,EAAE,wBAAwB;IAC3C,iBAAiB,EAAE,wBAAwB;IAC3C,iBAAiB,EAAE,yBAAyB;IAC5C,oBAAoB,EAAE,4BAA4B;IAClD,iBAAiB,EAAE,wBAAwB;IAC3C,YAAY,EAAE,mBAAmB;IACjC,YAAY,EAAE,mBAAmB;IACjC,kFAAkF;IAClF,8EAA8E;IAC9E,eAAe,EAAE,sBAAsB;IACvC,kBAAkB,EAAE,yBAAyB;IAC7C,eAAe,EAAE,sBAAsB;IACvC,YAAY,EAAE,mBAAmB;IACjC,eAAe,EAAE,sBAAsB;IACvC,aAAa,EAAE,oBAAoB;IACnC,sFAAsF;IACtF,wFAAwF;IACxF,uBAAuB,EAAE,+BAA+B;IACxD,sBAAsB,EAAE,8BAA8B;IACtD,eAAe,EAAE,uBAAuB;IACxC,sBAAsB,EAAE,8BAA8B;IACtD,iBAAiB,EAAE,yBAAyB;IAC5C,mBAAmB,EAAE,4BAA4B;IACjD,gBAAgB,EAAE,wBAAwB;IAC1C,eAAe,EAAE,uBAAuB;IACxC,eAAe,EAAE,uBAAuB;IACxC,cAAc,EAAE,sBAAsB;IACtC,kBAAkB,EAAE,0BAA0B;IAC9C,wBAAwB,EAAE,iCAAiC;IAC3D,qFAAqF;IACrF,iFAAiF;IACjF,iCAAiC;IACjC,kBAAkB,EAAE,0BAA0B;CACtC,CAAC;AAWX,MAAM,UAAU,QAAQ,CAAC,IAAuB;IAC9C,OAAO,eAAe,CAAC;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;QACrB,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;KACxD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAuB;IAChD,OAAO,iBAAiB,CAAC;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;QACrB,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;KACxD,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAKzE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,cAAc,EAAE,qBAAqB;IACrC,aAAa,EAAE,oBAAoB;IACnC,mBAAmB,EAAE,2BAA2B;IAChD,aAAa,EAAE,oBAAoB;IACnC,aAAa,EAAE,qBAAqB;IACpC,kBAAkB,EAAE,0BAA0B;IAC9C,iBAAiB,EAAE,wBAAwB;IAC3C,iBAAiB,EAAE,wBAAwB;IAC3C,iBAAiB,EAAE,yBAAyB;IAC5C,oBAAoB,EAAE,4BAA4B;IAClD,iBAAiB,EAAE,wBAAwB;IAC3C,YAAY,EAAE,mBAAmB;IACjC,YAAY,EAAE,mBAAmB;IACjC,kFAAkF;IAClF,8EAA8E;IAC9E,eAAe,EAAE,sBAAsB;IACvC,kBAAkB,EAAE,yBAAyB;IAC7C,eAAe,EAAE,sBAAsB;IACvC,YAAY,EAAE,mBAAmB;IACjC,eAAe,EAAE,sBAAsB;IACvC,aAAa,EAAE,oBAAoB;IACnC,sFAAsF;IACtF,wFAAwF;IACxF,uBAAuB,EAAE,+BAA+B;IACxD,sBAAsB,EAAE,8BAA8B;IACtD,eAAe,EAAE,uBAAuB;IACxC,sBAAsB,EAAE,8BAA8B;IACtD,iBAAiB,EAAE,yBAAyB;IAC5C,mBAAmB,EAAE,4BAA4B;IACjD,gBAAgB,EAAE,wBAAwB;IAC1C,eAAe,EAAE,uBAAuB;IACxC,eAAe,EAAE,uBAAuB;IACxC,cAAc,EAAE,sBAAsB;IACtC,kBAAkB,EAAE,0BAA0B;IAC9C,wBAAwB,EAAE,iCAAiC;IAC3D,qFAAqF;IACrF,iFAAiF;IACjF,iCAAiC;IACjC,kBAAkB,EAAE,0BAA0B;IAC9C,+EAA+E;IAC/E,mFAAmF;IACnF,4EAA4E;IAC5E,eAAe,EAAE,uBAAuB;IACxC,gBAAgB,EAAE,yBAAyB;IAC3C,iBAAiB,EAAE,yBAAyB;IAC5C,eAAe,EAAE,sBAAsB;IACvC,cAAc,EAAE,qBAAqB;IACrC,UAAU,EAAE,iBAAiB;IAC7B,oFAAoF;IACpF,sFAAsF;IACtF,2DAA2D;IAC3D,cAAc,EAAE,sBAAsB;IACtC,eAAe,EAAE,uBAAuB;IACxC,iBAAiB,EAAE,yBAAyB;CACpC,CAAC;AAWX,MAAM,UAAU,QAAQ,CAAC,IAAuB;IAC9C,OAAO,eAAe,CAAC;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;QACrB,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;KACxD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAuB;IAChD,OAAO,iBAAiB,CAAC;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;QACrB,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;KACxD,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * `@aid-framework/cli` - the `aid` command: init, validate, gen, ingest, eval and doctor.
+ * `@aid-framework/cli` - the `aid` command: init, validate, gen, dev, ingest, eval, cost, doctor, eject and infra.
  *
  * The CLI is glue. Every judgement it reports -- whether a spec parses, what the IR is,
  * what a target can emit, which generated file was hand-edited, whether an eval regressed
@@ -12,6 +12,10 @@
  */
 export type { FlagSpec, ParsedArguments, ParseOutcome } from './args.js';
 export { booleanFlag, JSON_FLAG, parseArguments, valueFlag } from './args.js';
+export type { CostOptions } from './commands/cost.js';
+export { cost } from './commands/cost.js';
+export type { DevOptions } from './commands/dev.js';
+export { dev } from './commands/dev.js';
 export type { DoctorOptions } from './commands/doctor.js';
 export { doctor } from './commands/doctor.js';
 export type { EvalOptions } from './commands/eval.js';
@@ -42,9 +46,11 @@ export { emit, outcome } from './output.js';
 export { absolutePath, parentPath } from './paths.js';
 export type { Compiled, CompileOutcome, Failed, Lowered, LowerOutcome, ManifestOutcome, ReadManifest, ReadSpec, } from './pipeline.js';
 export { compile, lowerSpec, provenanceFor, readManifest, readSpec } from './pipeline.js';
-export { discoverInterpreter, INTERPRETERS, interpreterCommand, invoke } from './python.js';
-export type { Target } from './targets.js';
+export { DEV_PROBE, discoverInterpreter, INTERPRETERS, interpreterCommand, invoke, } from './python.js';
+export type { Target, TargetDev } from './targets.js';
 export { DEFAULT_SPEC_PATH, DEFAULT_TARGET, resolveTarget, TARGETS, targetCapabilities, targetNames, unknownTargetDiagnostic, } from './targets.js';
+export type { CostSummary, Latency, ModelSpend, ParsedTrace, TraceSpan } from './trace.js';
+export { parseSince, parseTraceLines, summariseSpans } from './trace.js';
 export type { CommandSpec } from './usage.js';
 export { commandUsage, globalUsage } from './usage.js';
 //# sourceMappingURL=index.d.ts.map