@xenos1996/usa 2.15.0 → 2.16.0

package/dist/cli-session.d.ts

@@ -0,0 +1,18 @@
+import { type Args } from './cli-args.js';
+/** Conversational commands: foundation init/show, live sessions, model listing. */
+export declare function cmdFoundation(args: Args): number;
+/**
+ * `usa live`: conversational audit session (foundation → audit → triage →
+ * report). The default chat is the agent layer's `complete()`; without a
+ * configured provider the session runs deterministically (loud skips, no
+ * model calls). Async only because the LLM transport is async — every
+ * deterministic step stays synchronous underneath.
+ */
+export declare function cmdLive(args: Args): Promise<number>;
+/**
+ * `usa models`: what the provider actually serves, so a model id can be
+ * checked before a session burns calls on a 404. Read-only and side-effect
+ * free beyond one GET.
+ */
+export declare function cmdModels(args: Args): Promise<number>;
+//# sourceMappingURL=cli-session.d.ts.map

package/dist/cli-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-session.d.ts","sourceRoot":"","sources":["../src/cli-session.ts"],"names":[],"mappings":"AAIA,OAAO,EAA2B,KAAK,IAAI,EAAE,MAAM,eAAe,CAAC;AAEnE,mFAAmF;AAGnF,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAiBhD;AAID;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BzD;AA0DD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB3D"}

package/dist/cli-session.js

@@ -0,0 +1,136 @@
+import { createStdinAsk, runFoundationInit, runFoundationShow } from './foundation/interview.js';
+import { checkModelAdvertised, runLiveSession } from './live/runner.js';
+import { complete, listModels, loadProviderConfig } from './agent/index.js';
+import { LIVE_HELP_TEXT, MODELS_HELP_TEXT } from './cli-help.js';
+import { bool, dryRunWrites, str } from './cli-args.js';
+/** Conversational commands: foundation init/show, live sessions, model listing. */
+/* ------------------------------------------------------------ foundation -- */
+export function cmdFoundation(args) {
+    const sub = args._[1];
+    const dir = str(args, 'dir') ?? args._[2] ?? '.';
+    if (sub === 'init') {
+        return runFoundationInit({
+            dir,
+            nonInteractive: bool(args, 'non-interactive'),
+            dryRun: bool(args, 'dry-run'),
+        });
+    }
+    if (sub === 'show' || sub === undefined) {
+        return runFoundationShow({ dir });
+    }
+    console.error('Usage: usa foundation <init|show> [path] [--dir <path>] [--non-interactive] [--dry-run]');
+    return 2;
+}
+/* ------------------------------------------------------------------ live -- */
+/**
+ * `usa live`: conversational audit session (foundation → audit → triage →
+ * report). The default chat is the agent layer's `complete()`; without a
+ * configured provider the session runs deterministically (loud skips, no
+ * model calls). Async only because the LLM transport is async — every
+ * deterministic step stays synchronous underneath.
+ */
+export async function cmdLive(args) {
+    if (bool(args, 'help')) {
+        console.log(LIVE_HELP_TEXT);
+        return 0;
+    }
+    const dir = args._[1] ?? '.';
+    const providerId = str(args, 'provider') ?? process.env['USA_PROVIDER'] ?? process.env['USA_LIVE_PROVIDER'];
+    const modelOpt = str(args, 'model') ?? process.env['USA_MODEL'];
+    const transcriptPath = str(args, 'transcript');
+    const triageLimit = parseTriageLimit(str(args, 'triage-limit'));
+    if (triageLimit === null) {
+        console.error('--triage-limit must be a positive number');
+        return 2;
+    }
+    // CLI-003: preview before any provider call or prompting.
+    if (!dryRunWrites(args, transcriptPath ? [transcriptPath] : []))
+        return 0;
+    const chat = await resolveLiveChatOrAnnounce(providerId, modelOpt);
+    return runLiveSession({
+        dir,
+        ask: createStdinAsk(),
+        print: (line) => console.log(line),
+        chat,
+        transcriptPath,
+        provider: providerId,
+        model: modelOpt,
+        triageLimit: triageLimit ?? undefined,
+    });
+}
+/**
+ * Resolve the session chat, announcing deterministic-only mode when no
+ * provider is configured. The pre-flight warns once up front about
+ * unadvertised model ids (the classic mid-session 404); the call itself
+ * stays authoritative.
+ */
+async function resolveLiveChatOrAnnounce(providerId, modelOpt) {
+    if (providerId)
+        return resolveLiveChat(providerId, modelOpt);
+    console.log('live: no provider configured (set --provider or USA_PROVIDER) — deterministic-only mode.');
+    return undefined;
+}
+/**
+ * Resolve the session chat, or undefined for deterministic-only mode. The
+ * pre-flight warns once up front about unadvertised model ids (the classic
+ * mid-session 404); the call itself stays authoritative.
+ */
+async function resolveLiveChat(providerId, modelOpt) {
+    try {
+        const cfg = loadProviderConfig(providerId, modelOpt === undefined ? undefined : { model: modelOpt });
+        const provider = providerId;
+        const model = modelOpt;
+        const admonition = await checkModelAdvertised(providerId, cfg.model, listModels);
+        if (admonition)
+            console.error(admonition);
+        return (req) => complete({ ...req, provider, ...(model === undefined ? {} : { model }) });
+    }
+    catch {
+        // Deliberately a STATIC message: provider failures name key material
+        // (env vars, endpoints) and even the provider id is env-derived, so a
+        // transcript-adjacent CLI interpolates nothing here — neither the
+        // error nor the id. The user just typed it; they know which one failed.
+        console.error('live: LLM provider unavailable (check its API key) — continuing in deterministic-only mode.');
+        return undefined;
+    }
+}
+/** Positive integer, or null when the flag value is unusable. */
+function parseTriageLimit(raw) {
+    if (raw === undefined)
+        return undefined;
+    const n = Number(raw);
+    if (!Number.isInteger(n) || n < 1)
+        return null;
+    return n;
+}
+/**
+ * `usa models`: what the provider actually serves, so a model id can be
+ * checked before a session burns calls on a 404. Read-only and side-effect
+ * free beyond one GET.
+ */
+export async function cmdModels(args) {
+    if (bool(args, 'help')) {
+        console.log(MODELS_HELP_TEXT);
+        return 0;
+    }
+    const providerId = str(args, 'provider') ?? process.env['USA_PROVIDER'];
+    if (!providerId) {
+        console.error('Usage: usa models --provider <id> (or set USA_PROVIDER)');
+        return 2;
+    }
+    let names;
+    try {
+        // Validates the key and resolves static defaults first — same fail-closed
+        // contract as the session; the static message policy applies here too.
+        loadProviderConfig(providerId);
+        names = (await listModels(providerId)).map((m) => m.name);
+    }
+    catch {
+        console.error('live: LLM provider unavailable (check its API key).');
+        return 2;
+    }
+    for (const name of names)
+        console.log(name);
+    return 0;
+}
+//# sourceMappingURL=cli-session.js.map

package/dist/cli-session.js.map

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

package/dist/cli.d.ts

@@ -1,5 +1,5 @@
-#!/usr/bin/env node
 export declare function main(argv: string[]): number | Promise<number>;
+/** Resolves the report format from an explicit flag, else the --out suffix. */
 declare function isEntryPoint(argv1?: string | undefined, thisUrl?: string): boolean;
 export { isEntryPoint };
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AA4JA,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B7D;AAukCD,iBAAS,YAAY,CACnB,KAAK,GAAE,MAAM,GAAG,SAA2B,EAC3C,OAAO,GAAE,MAAwB,GAChC,OAAO,CAOT;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAiDA,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B7D;AAID,+EAA+E;AAE/E,iBAAS,YAAY,CACnB,KAAK,GAAE,MAAM,GAAG,SAA2B,EAC3C,OAAO,GAAE,MAAwB,GAChC,OAAO,CAOT;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}