@xenos1996/usa 2.4.0 → 2.6.0

package/dist/engine/test-evidence.js

@@ -0,0 +1,154 @@
+/**
+ * Deterministic test-evidence analyzers (testing-assurance evidence slice).
+ *
+ * DOCTRINE (ADR-0032): these are pure deterministic heuristics that count
+ * observable signals in file paths and file contents. Interpretation stays
+ * agent-side. Nothing here asserts quality, coverage semantics, or assurance —
+ * a count of patterns is presence evidence only, never a verdict.
+ *
+ * The module performs no I/O: callers supply paths, contents, inventories,
+ * and timestamps explicitly. It changes no scores and wires into no report.
+ */
+/**
+ * Default pattern table (documented contract):
+ *
+ * - unit:        `__tests__`, `*.unit.*`, `*.spec.*`, `test_*`
+ * - integration: `*integration*`, `*contract*`, `*pact*`
+ * - system:      `*system*`, `*acceptance*`
+ * - e2e:         `*e2e*`, `*end-to-end*`, `*.e2e.*`
+ * - else:        `unknown`
+ */
+export const DEFAULT_PATTERNS = {
+    unit: ['__tests__', '*.unit.*', '*.spec.*', 'test_*'],
+    integration: ['*integration*', '*contract*', '*pact*'],
+    system: ['*system*', '*acceptance*'],
+    e2e: ['*e2e*', '*end-to-end*', '*.e2e.*'],
+};
+/**
+ * Match precedence, narrowest scope first. A path matching several levels
+ * (e.g. `e2e/login.spec.ts`) is classified by the earliest level here.
+ * This is an arbitrary tie-break, documented so it cannot surprise.
+ */
+const LEVEL_PRECEDENCE = [
+    'e2e',
+    'system',
+    'integration',
+    'unit',
+];
+/** Escape a literal so it can be embedded in a RegExp source. */
+function escapeRegExp(literal) {
+    return literal.replace(/[.+?^${}()|[\]\\]/g, '\\$&');
+}
+/** Convert a `*`-glob to an unanchored, case-insensitive RegExp (substring match). */
+function globToRegExp(glob) {
+    return new RegExp(glob.split('*').map(escapeRegExp).join('.*'), 'i');
+}
+/**
+ * Classify a test file path into a level. Returns `unknown` when no
+ * pattern matches. Counts as a naming signal only — it says nothing about
+ * what the file actually exercises.
+ */
+export function classifyTestFile(filePath, patterns) {
+    const table = {
+        ...DEFAULT_PATTERNS,
+        ...patterns,
+    };
+    for (const level of LEVEL_PRECEDENCE) {
+        if (table[level].some((glob) => globToRegExp(glob).test(filePath))) {
+            return level;
+        }
+    }
+    return 'unknown';
+}
+/** Count files per level. The result always carries all five keys. */
+export function inventoryTests(files, patterns) {
+    const inventory = {
+        unit: 0,
+        integration: 0,
+        system: 0,
+        e2e: 0,
+        unknown: 0,
+    };
+    for (const file of files) {
+        inventory[classifyTestFile(file, patterns)] += 1;
+    }
+    return inventory;
+}
+/**
+ * Signal patterns (documented contract — each counts literal occurrences):
+ *
+ * - failureAssertions: `toThrow|assert\.throws|rejects|assert\.rejects`
+ * - mockUsages:        `jest\.mock|vi\.mock|sinon|mockReturnValue|mockResolvedValue|Mock`
+ * - focusedMarkers:    `describe\.only|it\.only|test\.only|fit\(|fdescribe\(`
+ * - skippedMarkers:    `describe\.skip|it\.skip|test\.skip|xit\(|xdescribe\(`
+ *
+ * A high mock count does not prove over-mocking; a focused marker is an
+ * isolation signal, not a failure. Interpretation stays agent-side.
+ */
+const SIGNAL_PATTERNS = {
+    failureAssertions: /toThrow|assert\.throws|rejects|assert\.rejects/g,
+    mockUsages: /jest\.mock|vi\.mock|sinon|mockReturnValue|mockResolvedValue|Mock/g,
+    focusedMarkers: /describe\.only|it\.only|test\.only|fit\(|fdescribe\(/g,
+    skippedMarkers: /describe\.skip|it\.skip|test\.skip|xit\(|xdescribe\(/g,
+};
+/** Count global regex matches (0 when there are none). */
+function countMatches(content, pattern) {
+    const matches = content.match(pattern);
+    return matches === null ? 0 : matches.length;
+}
+/** Count assertion/marker signals in file content. Pure string scan. */
+export function assertionSignals(content) {
+    return {
+        failureAssertions: countMatches(content, SIGNAL_PATTERNS.failureAssertions),
+        mockUsages: countMatches(content, SIGNAL_PATTERNS.mockUsages),
+        focusedMarkers: countMatches(content, SIGNAL_PATTERNS.focusedMarkers),
+        skippedMarkers: countMatches(content, SIGNAL_PATTERNS.skippedMarkers),
+    };
+}
+/**
+ * Share of the inventory held by system+e2e above which the shape is
+ * labelled `top-heavy`. Strictly greater-than: exactly 30% is not top-heavy.
+ */
+export const TOP_HEAVY_SHARE = 0.3;
+/**
+ * Label the shape of a level inventory. THE PYRAMID IS A HEURISTIC, NOT A
+ * LAW: these labels describe count proportions only and assert nothing about
+ * whether the suite is adequate, fast, or trustworthy.
+ *
+ * Documented rules: all counts zero → `untested`; system+e2e share strictly
+ * above TOP_HEAVY_SHARE → `top-heavy`; no integration tests while unit tests
+ * exist → `no-middle`; otherwise → `balanced` (no flag). `unknown` files
+ * count toward the total but toward no level. Rule order is part of the
+ * contract: `untested` beats `top-heavy` beats `no-middle` beats `balanced`.
+ */
+export function pyramidAssessment(inventory) {
+    const total = inventory.unit + inventory.integration + inventory.system + inventory.e2e + inventory.unknown;
+    if (total === 0) {
+        return { shape: 'untested', flag: 'untested' };
+    }
+    if ((inventory.e2e + inventory.system) / total > TOP_HEAVY_SHARE) {
+        return { shape: 'top-heavy', flag: 'top-heavy' };
+    }
+    if (inventory.integration === 0 && inventory.unit > 0) {
+        return { shape: 'no-middle', flag: 'no-middle' };
+    }
+    return { shape: 'balanced' };
+}
+/** Milliseconds in a day; the unit of `ageDays`. */
+export const MS_PER_DAY = 86_400_000;
+/**
+ * Compare an evidence-artifact timestamp against HEAD time, purely on the
+ * explicit arguments (no clock reads). `ageDays` is fractional and may be
+ * negative. `stale` is true when the artifact predates HEAD. Non-finite
+ * inputs are a time paradox and fail closed: `stale` true, `ageDays` NaN.
+ * Staleness is a timestamp ordering only — it says nothing about whether
+ * the artifact's claims still hold.
+ */
+export function freshnessCheck(artifactMtimeMs, headTimeMs) {
+    if (!Number.isFinite(artifactMtimeMs) || !Number.isFinite(headTimeMs)) {
+        return { stale: true, ageDays: NaN };
+    }
+    const ageDays = (artifactMtimeMs - headTimeMs) / MS_PER_DAY;
+    return { stale: ageDays < 0, ageDays };
+}
+//# sourceMappingURL=test-evidence.js.map

package/dist/engine/test-evidence.js.map

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

package/dist/index.d.ts

@@ -14,6 +14,13 @@ export { buildSuppressionIndex, applySuppressions, unusedSuppressions, describeS
 export { automatabilityOf, ruleAutomatability, parseCatalogue, validateCatalogue, validateAutomatability, } from './engine/automatability.js';
 export { buildReviewIndex, attachReviews, resolveActiveReviews, unusedReviews, describeReview, reviewAgeDays, reviewOverdueDays, isReviewStale, type ReviewIndex, type ReviewEntry, } from './engine/review.js';
 export { loadCatalogues, catalogueOf, catalogueCoverage, type Catalogue, type CatalogueCoverage, } from './engine/catalogues.js';
+export { loadCategories, categoryCoverage, type CategoryDef, type CategoryCoverage, type CategoryId, } from './engine/categories.js';
+export { complete, listModels, loadProviderConfig, PROVIDER_PRESETS } from './agent/providers.js';
+export type { ChatMessage, ChatRequest, ChatResult, ProviderPreset, ProviderOverrides, ResolvedConfig, ModelInfo, } from './agent/types.js';
+export { initialSession, advance, renderTranscript } from './live/session.js';
+export { runLiveSession, DETERMINISTIC_SKIP_PREFIX, type LiveSessionOptions, } from './live/runner.js';
+export type { SessionState, SessionPhase, TranscriptEntry, TranscriptKind } from './live/types.js';
+export { classifyTestFile, inventoryTests, assertionSignals, pyramidAssessment, freshnessCheck, DEFAULT_PATTERNS, TOP_HEAVY_SHARE, MS_PER_DAY, type TestLevel, type LevelPatterns, type AssertionSignals, type PyramidAssessment, type FreshnessResult, } from './engine/test-evidence.js';
 export { renderMarkdown, parseTrailer, trailer } from './report/markdown.js';
 export { renderJson, toJsonReport, JSON_SCHEMA, type JsonReport, type JsonFinding, } from './report/json.js';
 export { renderSarif, toSarif, SARIF_VERSION, type SarifLog } from './report/sarif.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -14,6 +14,11 @@ export { buildSuppressionIndex, applySuppressions, unusedSuppressions, describeS
 export { automatabilityOf, ruleAutomatability, parseCatalogue, validateCatalogue, validateAutomatability, } from './engine/automatability.js';
 export { buildReviewIndex, attachReviews, resolveActiveReviews, unusedReviews, describeReview, reviewAgeDays, reviewOverdueDays, isReviewStale, } from './engine/review.js';
 export { loadCatalogues, catalogueOf, catalogueCoverage, } from './engine/catalogues.js';
+export { loadCategories, categoryCoverage, } from './engine/categories.js';
+export { complete, listModels, loadProviderConfig, PROVIDER_PRESETS } from './agent/providers.js';
+export { initialSession, advance, renderTranscript } from './live/session.js';
+export { runLiveSession, DETERMINISTIC_SKIP_PREFIX, } from './live/runner.js';
+export { classifyTestFile, inventoryTests, assertionSignals, pyramidAssessment, freshnessCheck, DEFAULT_PATTERNS, TOP_HEAVY_SHARE, MS_PER_DAY, } from './engine/test-evidence.js';
 export { renderMarkdown, parseTrailer, trailer } from './report/markdown.js';
 export { renderJson, toJsonReport, JSON_SCHEMA, } from './report/json.js';
 export { renderSarif, toSarif, SARIF_VERSION } from './report/sarif.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC9F,OAAO,EACL,aAAa,EACb,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,GAIb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,aAAa,GAGd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,WAAW,EACX,iBAAiB,GAGlB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EACL,UAAU,EACV,YAAY,EACZ,WAAW,GAGZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAiB,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtE,2EAA2E;AAC3E,2BAA2B;AAC3B,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/live/runner.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Live session runner — drives the deterministic phases with optional LLM
+ * turns behind an injectable `ChatFn`.
+ *
+ * Doctrine: the engine verifies, the model only proposes. Without a
+ * configured provider (`chat` undefined) every model turn prints a loud skip
+ * line and the session continues deterministically — conversation is lost,
+ * correctness never is. A throwing `chat` degrades the same way (loud line,
+ * deterministic continuation), never a crash.
+ *
+ * Read-only seam: foundation builders and `runAudit` are imported, never
+ * modified. Types for the LLM call come from `src/agent` only.
+ */
+import type { ChatRequest } from '../agent/types.js';
+import type { AskFn, ChatFn, PrintFn } from './types.js';
+export type { AskFn, ChatFn, PrintFn } from './types.js';
+export type { ChatRequest };
+/** Loud marker printed whenever a model turn is skipped (deterministic-only). */
+export declare const DETERMINISTIC_SKIP_PREFIX = "LLM skipped (deterministic-only mode)";
+export interface LiveSessionOptions {
+    dir: string;
+    ask: AskFn;
+    print: PrintFn;
+    chat?: ChatFn;
+    transcriptPath?: string;
+    provider?: string;
+    model?: string;
+}
+/**
+ * Runs foundation → audit → triage → report → done.
+ * Exit codes mirror the CLI gate convention: 0 done, 2 broken input.
+ */
+export declare function runLiveSession(opts: LiveSessionOptions): Promise<number>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/live/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/live/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAYrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAiC,MAAM,YAAY,CAAC;AAExF,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B,iFAAiF;AACjF,eAAO,MAAM,yBAAyB,0CAA0C,CAAC;AAEjF,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,KAAK,CAAC;IACX,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAaD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqB9E"}

package/dist/live/runner.js

@@ -0,0 +1,220 @@
+/**
+ * Live session runner — drives the deterministic phases with optional LLM
+ * turns behind an injectable `ChatFn`.
+ *
+ * Doctrine: the engine verifies, the model only proposes. Without a
+ * configured provider (`chat` undefined) every model turn prints a loud skip
+ * line and the session continues deterministically — conversation is lost,
+ * correctness never is. A throwing `chat` degrades the same way (loud line,
+ * deterministic continuation), never a crash.
+ *
+ * Read-only seam: foundation builders and `runAudit` are imported, never
+ * modified. Types for the LLM call come from `src/agent` only.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { runAudit } from '../engine/audit.js';
+import { renderMarkdown } from '../report/markdown.js';
+import { INTERVIEW_QUESTIONS, applyInterviewAnswer, formatQuestionPrompt, } from '../foundation/interview.js';
+import { defaultFoundation } from '../foundation/types.js';
+import { sanitizeIntent } from '../foundation/loader.js';
+import { advance, initialSession, renderTranscript } from './session.js';
+/** Loud marker printed whenever a model turn is skipped (deterministic-only). */
+export const DETERMINISTIC_SKIP_PREFIX = 'LLM skipped (deterministic-only mode)';
+const SYSTEM_PROMPT = 'You are the USA live audit assistant. Propose, never decide.';
+/** Triage walks at most this many UNKNOWN findings; the rest stay queued. */
+const TRIAGE_CAP = 50;
+/**
+ * Runs foundation → audit → triage → report → done.
+ * Exit codes mirror the CLI gate convention: 0 done, 2 broken input.
+ */
+export async function runLiveSession(opts) {
+    const dir = path.resolve(opts.dir);
+    if (!isUsableDir(dir)) {
+        opts.print(`live: target not found or not a directory: ${opts.dir}`);
+        return 2;
+    }
+    const ctx = { state: initialSession() };
+    let code = 0;
+    try {
+        await runFoundationStep(opts, ctx);
+        await runAuditStep(opts, ctx);
+        await runTriageStep(opts, ctx);
+        await runReportStep(opts, ctx);
+        ctx.state = advance(ctx.state, 'done');
+        opts.print('Live session complete.');
+    }
+    catch (err) {
+        opts.print(`live: ${err.message}`);
+        code = 2;
+    }
+    if (opts.transcriptPath)
+        code = writeTranscript(opts, ctx, code);
+    return code;
+}
+function isUsableDir(dir) {
+    try {
+        return fs.statSync(dir).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/** Transcript is the artifact: always written at the end when requested. */
+function writeTranscript(opts, ctx, code) {
+    try {
+        const file = path.resolve(opts.transcriptPath);
+        fs.mkdirSync(path.dirname(file), { recursive: true });
+        fs.writeFileSync(file, renderTranscript(ctx.state), 'utf8');
+        opts.print(`Transcript written to ${opts.transcriptPath}.`);
+        return code;
+    }
+    catch (err) {
+        opts.print(`live: cannot write transcript: ${err.message}`);
+        return 2;
+    }
+}
+function appendTool(ctx, text) {
+    const entry = { phase: ctx.state.phase, kind: 'tool', text };
+    ctx.state = { ...ctx.state, transcript: [...ctx.state.transcript, entry] };
+}
+/* --------------------------------------------------------------- model -- */
+async function modelTurn(opts, ctx, tag, user) {
+    if (!opts.chat) {
+        const line = `${DETERMINISTIC_SKIP_PREFIX}: no provider configured — ` +
+            `continuing without model input (${tag}).`;
+        opts.print(line);
+        appendTool(ctx, line);
+        return;
+    }
+    const req = {
+        provider: opts.provider ?? 'usa-live',
+        model: opts.model ?? 'usa-live',
+        messages: [
+            { role: 'system', content: SYSTEM_PROMPT },
+            { role: 'user', content: user },
+        ],
+    };
+    try {
+        const res = await opts.chat(req);
+        opts.print(res.text);
+        const entry = { phase: ctx.state.phase, kind: 'model', text: res.text };
+        ctx.state = { ...ctx.state, transcript: [...ctx.state.transcript, entry] };
+    }
+    catch (err) {
+        const line = `LLM unavailable (${err.message}) — continuing deterministically (${tag}).`;
+        opts.print(line);
+        appendTool(ctx, line);
+    }
+}
+/* ---------------------------------------------------------- foundation -- */
+async function runFoundationStep(opts, ctx) {
+    ctx.state = advance(ctx.state, 'foundation');
+    opts.print('Foundation: capturing project intent (empty answers keep defaults).');
+    let config = defaultFoundation(path.basename(path.resolve(opts.dir)) || 'project');
+    for (const question of INTERVIEW_QUESTIONS) {
+        const raw = await opts.ask(formatQuestionPrompt(question, config));
+        if (raw === null) {
+            opts.print('(EOF — keeping defaults for the remaining questions.)');
+            break;
+        }
+        config = await applyWithRetries(opts, question, config, raw);
+    }
+    const facts = intentFacts(config);
+    ctx.state = { ...ctx.state, facts: [...ctx.state.facts, ...facts] };
+    const summary = `Foundation captured: ${facts.length > 0 ? facts.join(', ') : '(no usable intents)'}.`;
+    opts.print(summary);
+    appendTool(ctx, summary);
+    await modelTurn(opts, ctx, 'foundation', `[foundation] facts: ${facts.join(', ') || '(none)'}.`);
+}
+/** Intent entries that sanitize become `intent:<value>` facts; the rest assert nothing. */
+function intentFacts(config) {
+    const facts = [];
+    for (const intent of config.project.intents) {
+        const flag = sanitizeIntent(intent);
+        if (flag !== undefined)
+            facts.push(flag);
+    }
+    return facts;
+}
+/** Invalid answers re-prompt (bounded); then the default stands, loudly. */
+async function applyWithRetries(opts, question, config, firstRaw) {
+    let raw = firstRaw;
+    for (let attempt = 0; attempt < 3; attempt++) {
+        try {
+            return applyInterviewAnswer(config, question.id, raw);
+        }
+        catch (err) {
+            opts.print(err.message);
+        }
+        const retry = await opts.ask(formatQuestionPrompt(question, config));
+        if (retry === null)
+            return config;
+        raw = retry;
+    }
+    opts.print(`Keeping the default for ${question.id} after repeated invalid answers.`);
+    return config;
+}
+/* --------------------------------------------------------------- audit -- */
+async function runAuditStep(opts, ctx) {
+    ctx.state = advance(ctx.state, 'audit');
+    const { report, warnings, profile } = runAudit({ target: path.resolve(opts.dir) });
+    for (const warning of warnings)
+        opts.print(`warning: ${warning}`);
+    ctx.report = report;
+    ctx.profile = profile;
+    const summary = auditSummary(report);
+    opts.print(summary);
+    appendTool(ctx, summary);
+    await modelTurn(opts, ctx, 'audit', `[audit] ${summary}`);
+}
+function auditSummary(report) {
+    const unknown = report.score.counts.UNKNOWN ?? 0;
+    return (`Audit: ${report.score.overall}/100 — ${report.findings.length} finding(s), ` +
+        `${unknown} to review (${report.score.automationCoverage}% verified automatically).`);
+}
+/* -------------------------------------------------------------- triage -- */
+async function runTriageStep(opts, ctx) {
+    ctx.state = advance(ctx.state, 'next');
+    const report = ctx.report;
+    const unknowns = report.findings.filter((f) => f.status === 'UNKNOWN');
+    const capped = unknowns.slice(0, TRIAGE_CAP);
+    let recorded = 0;
+    for (const finding of capped) {
+        const raw = await opts.ask(`Evidence for ${finding.ruleId} (${finding.title}) — file:line or empty to skip: `);
+        const answer = (raw ?? '').trim();
+        if (answer === '')
+            continue;
+        recorded++;
+        const entry = {
+            phase: ctx.state.phase,
+            kind: 'decision',
+            text: `${finding.ruleId}: ${answer}`,
+        };
+        ctx.state = {
+            ...ctx.state,
+            transcript: [...ctx.state.transcript, entry],
+            facts: [...ctx.state.facts, `${finding.ruleId}@${answer}`],
+        };
+    }
+    if (unknowns.length > capped.length) {
+        appendTool(ctx, `${unknowns.length - capped.length} finding(s) left queued (triage cap ${TRIAGE_CAP}).`);
+    }
+    const summary = `Triage: ${recorded} evidence note(s) recorded over ${capped.length} finding(s) walked.`;
+    opts.print(summary);
+    appendTool(ctx, summary);
+    await modelTurn(opts, ctx, 'triage', `[triage] recorded ${recorded} evidence note(s).`);
+}
+/* -------------------------------------------------------------- report -- */
+async function runReportStep(opts, ctx) {
+    ctx.state = advance(ctx.state, 'next');
+    const report = ctx.report;
+    const profile = ctx.profile;
+    const markdown = renderMarkdown(report, profile);
+    const summary = `Report rendered (${markdown.length} chars): ` +
+        `${report.score.overall}/100, ${report.findings.length} finding(s).`;
+    opts.print(summary);
+    appendTool(ctx, summary);
+    await modelTurn(opts, ctx, 'report', `[report] score ${report.score.overall}/100.`);
+}
+//# sourceMappingURL=runner.js.map

package/dist/live/runner.js.map

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

package/dist/live/session.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Live session state machine — pure reducer plus deterministic rendering.
+ *
+ * The reducer never throws on user text: unknown input keeps the phase and
+ * appends a help line. Phase movement happens only on explicit commands
+ * (`foundation`, `audit`, `next`, `done`). Rendering carries no timestamps.
+ */
+import type { SessionState } from './types.js';
+/** Commands the reducer understands (matched case-insensitively, trimmed). */
+export declare const LIVE_COMMANDS: readonly ["foundation", "audit", "next", "done"];
+export declare const LIVE_HELP: string;
+/** Fresh session: idle, silent, no facts. */
+export declare function initialSession(): SessionState;
+/**
+ * Advances the session on one line of user input. Pure: returns a new state,
+ * never mutates, never throws — even non-string input degrades to a help
+ * line in the current phase.
+ */
+export declare function advance(state: SessionState, input: unknown): SessionState;
+/**
+ * Renders the transcript as Markdown. Deterministic: phase names, kinds, and
+ * texts only — no timestamps, no dates, no durations.
+ */
+export declare function renderTranscript(state: SessionState): string;
+//# sourceMappingURL=session.d.ts.map

package/dist/live/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/live/session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAgB,YAAY,EAAmB,MAAM,YAAY,CAAC;AAE9E,8EAA8E;AAC9E,eAAO,MAAM,aAAa,kDAAmD,CAAC;AAW9E,eAAO,MAAM,SAAS,QAE2C,CAAC;AAElE,6CAA6C;AAC7C,wBAAgB,cAAc,IAAI,YAAY,CAE7C;AAkBD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY,CA6BzE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAiB5D"}

package/dist/live/session.js

@@ -0,0 +1,100 @@
+/**
+ * Live session state machine — pure reducer plus deterministic rendering.
+ *
+ * The reducer never throws on user text: unknown input keeps the phase and
+ * appends a help line. Phase movement happens only on explicit commands
+ * (`foundation`, `audit`, `next`, `done`). Rendering carries no timestamps.
+ */
+/** Commands the reducer understands (matched case-insensitively, trimmed). */
+export const LIVE_COMMANDS = ['foundation', 'audit', 'next', 'done'];
+/** One-step walk for `next`, from every non-terminal phase. */
+const NEXT_PHASE = {
+    idle: 'foundation',
+    foundation: 'audit',
+    audit: 'triage',
+    triage: 'report',
+    report: 'done',
+};
+export const LIVE_HELP = 'Commands: foundation | audit | next | done — ' +
+    'any other text is recorded and the session stays where it is.';
+/** Fresh session: idle, silent, no facts. */
+export function initialSession() {
+    return { phase: 'idle', transcript: [], facts: [] };
+}
+function toolEntry(phase, text) {
+    return { phase, kind: 'tool', text };
+}
+function userEntry(phase, text) {
+    return { phase, kind: 'user', text };
+}
+function move(state, phase, note) {
+    return {
+        phase,
+        transcript: [...state.transcript, toolEntry(state.phase, note)],
+        facts: [...state.facts],
+    };
+}
+/**
+ * Advances the session on one line of user input. Pure: returns a new state,
+ * never mutates, never throws — even non-string input degrades to a help
+ * line in the current phase.
+ */
+export function advance(state, input) {
+    try {
+        const raw = typeof input === 'string' ? input : String(input ?? '');
+        const cmd = raw.trim().toLowerCase();
+        const seen = {
+            phase: state.phase,
+            transcript: [...state.transcript, userEntry(state.phase, raw)],
+            facts: [...state.facts],
+        };
+        if (cmd === 'done')
+            return move(seen, 'done', 'Session complete.');
+        if (cmd === 'foundation')
+            return move(seen, 'foundation', 'Entering foundation.');
+        if (cmd === 'audit')
+            return move(seen, 'audit', 'Entering audit.');
+        if (cmd === 'next') {
+            const next = NEXT_PHASE[seen.phase];
+            if (next === undefined)
+                return move(seen, 'done', 'Session complete.');
+            return move(seen, next, `Entering ${next}.`);
+        }
+        return {
+            phase: seen.phase,
+            transcript: [...seen.transcript, toolEntry(seen.phase, LIVE_HELP)],
+            facts: seen.facts,
+        };
+    }
+    catch {
+        return {
+            phase: state.phase,
+            transcript: [...state.transcript, toolEntry(state.phase, LIVE_HELP)],
+            facts: [...state.facts],
+        };
+    }
+}
+/**
+ * Renders the transcript as Markdown. Deterministic: phase names, kinds, and
+ * texts only — no timestamps, no dates, no durations.
+ */
+export function renderTranscript(state) {
+    const out = [];
+    out.push('# Live session transcript');
+    out.push('');
+    out.push(`Phase: ${state.phase}`);
+    out.push(`Facts: ${state.facts.length > 0 ? state.facts.join(', ') : '(none)'}`);
+    out.push('');
+    out.push('## Transcript');
+    out.push('');
+    if (state.transcript.length === 0)
+        out.push('(empty)');
+    for (const entry of state.transcript) {
+        out.push(`### ${entry.phase} · ${entry.kind}`);
+        out.push('');
+        out.push(entry.text === '' ? '(empty)' : entry.text);
+        out.push('');
+    }
+    return out.join('\n');
+}
+//# sourceMappingURL=session.js.map

package/dist/live/session.js.map

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