@tyroneross/navgator 0.2.2 → 0.10.0

package/dist/classify.js

@@ -0,0 +1,124 @@
+/**
+ * NavGator Semantic Connection Classification
+ * Classifies connections as production, admin, analytics, test, dev-only, migration, or unknown
+ */
+/**
+ * Classify a connection based on file path patterns of source and target components.
+ */
+export function classifyConnection(conn, fromComponent, toComponent) {
+    // Collect all relevant file paths
+    const paths = [
+        conn.code_reference?.file,
+        conn.from.location?.file,
+        conn.to.location?.file,
+        ...(fromComponent.source.config_files || []),
+    ].filter(Boolean);
+    // Check each classification pattern against all paths
+    for (const p of paths) {
+        const lower = p.toLowerCase();
+        // Test patterns (highest priority — test files shouldn't be treated as production)
+        if (isTestPath(lower)) {
+            return { classification: 'test', confidence: 0.9 };
+        }
+        // Migration patterns
+        if (isMigrationPath(lower)) {
+            return { classification: 'migration', confidence: 0.9 };
+        }
+        // Dev-only patterns
+        if (isDevPath(lower)) {
+            return { classification: 'dev-only', confidence: 0.9 };
+        }
+        // Admin patterns
+        if (isAdminPath(lower)) {
+            return { classification: 'admin', confidence: 0.9 };
+        }
+        // Analytics patterns
+        if (isAnalyticsPath(lower)) {
+            return { classification: 'analytics', confidence: 0.9 };
+        }
+    }
+    // Component name heuristic
+    const fromName = fromComponent.name.toLowerCase();
+    const toName = toComponent.name.toLowerCase();
+    if (fromName.includes('test') || toName.includes('test')) {
+        return { classification: 'test', confidence: 0.7 };
+    }
+    if (fromName.includes('admin') || toName.includes('admin')) {
+        return { classification: 'admin', confidence: 0.7 };
+    }
+    if (fromName.includes('analytics') || fromName.includes('metric') || toName.includes('analytics') || toName.includes('metric')) {
+        return { classification: 'analytics', confidence: 0.7 };
+    }
+    // Final file path check — catches scripts/ when component names didn't trigger above
+    const connFile = conn.code_reference?.file?.toLowerCase() || '';
+    const fromFile = conn.from.location?.file?.toLowerCase() || '';
+    if (/(^scripts\/|\/scripts\/)/.test(connFile) || /(^scripts\/|\/scripts\/)/.test(fromFile)) {
+        return { classification: 'dev-only', confidence: 0.9 };
+    }
+    if (isTestPath(connFile) || isTestPath(fromFile)) {
+        return { classification: 'test', confidence: 0.8 };
+    }
+    // Default: production
+    return { classification: 'production', confidence: 0.4 };
+}
+/**
+ * Classify all connections in a batch
+ */
+export function classifyAllConnections(connections, components) {
+    const componentMap = new Map(components.map(c => [c.component_id, c]));
+    const result = new Map();
+    for (const conn of connections) {
+        const from = componentMap.get(conn.from.component_id);
+        const to = componentMap.get(conn.to.component_id);
+        if (from && to) {
+            result.set(conn.connection_id, classifyConnection(conn, from, to));
+        }
+        else {
+            // Components not resolved (FILE: prefix IDs) — classify by file paths only
+            const filePaths = [
+                conn.code_reference?.file,
+                conn.from.location?.file,
+                conn.to.location?.file,
+            ].filter(Boolean);
+            let classified = false;
+            for (const p of filePaths) {
+                const lower = p.toLowerCase();
+                if (isTestPath(lower)) {
+                    result.set(conn.connection_id, { classification: 'test', confidence: 0.8 });
+                    classified = true;
+                    break;
+                }
+                if (isDevPath(lower)) {
+                    result.set(conn.connection_id, { classification: 'dev-only', confidence: 0.8 });
+                    classified = true;
+                    break;
+                }
+                if (isMigrationPath(lower)) {
+                    result.set(conn.connection_id, { classification: 'migration', confidence: 0.8 });
+                    classified = true;
+                    break;
+                }
+            }
+            if (!classified) {
+                result.set(conn.connection_id, { classification: 'production', confidence: 0.4 });
+            }
+        }
+    }
+    return result;
+}
+function isTestPath(p) {
+    return /(__tests__|\.test\.|\.spec\.|\/tests?\/|\/testing\/)/.test(p);
+}
+function isMigrationPath(p) {
+    return /(\/migrations?\/|\/migrate|\.migration\.|\/seeds?\/)/.test(p);
+}
+function isDevPath(p) {
+    return /(^scripts\/|\/scripts\/|\/dev\/|\.dev\.|webpack\.config|vite\.config|rollup\.config|jest\.config|eslint|prettier|\.storybook)/.test(p);
+}
+function isAdminPath(p) {
+    return /(\/admin\/|\/dashboard\/|\/internal\/|\/backoffice\/)/.test(p);
+}
+function isAnalyticsPath(p) {
+    return /(\/analytics\/|\/tracking\/|\/telemetry\/|\/metrics\/|\/monitoring\/)/.test(p);
+}
+//# sourceMappingURL=classify.js.map

package/dist/classify.js.map

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

package/dist/cli/commands/arch-diff.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `navgator arch-diff [--base <ref>] [--record] [--json] [--agent]` —
+ * pre-merge architecture diff (Living Architecture slice 4).
+ *
+ * Shows how the current branch's architecture differs from the canonical
+ * (default-branch) baseline — or a named `--base` ref — BEFORE merging, so a
+ * reviewer sees topology drift up front rather than discovering it after the
+ * merge lands. Read-only unless `--record` is passed.
+ *
+ * Registration is C8's (docs/plans/2026-08-03-portfolio-remote-gitaware.md):
+ * this module only exports `registerArchDiffCommand`.
+ */
+import { Command } from 'commander';
+export declare function registerArchDiffCommand(program: Command): void;
+//# sourceMappingURL=arch-diff.d.ts.map

package/dist/cli/commands/arch-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arch-diff.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/arch-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+DpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiD9D"}

package/dist/cli/commands/arch-diff.js

@@ -0,0 +1,132 @@
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import { wrapInEnvelope } from '../../agent-output.js';
+import { pruneBranchSnapshots, writeSnapshotForCurrentRef } from '../../git-aware/canonical.js';
+import { premergeDiff } from '../../git-aware/premerge-diff.js';
+import { EXIT_CODES } from '../exit-codes.js';
+const execFileAsync = promisify(execFile);
+const GIT_TIMEOUT_MS = 3000;
+/**
+ * f9: live refs to protect from `pruneBranchSnapshots` — local branches plus
+ * any branch checked out in a linked worktree (a worktree's branch can be
+ * "current" for that worktree without appearing as the repo's HEAD, so it
+ * must never be pruned out from under it). Best-effort: a non-git directory
+ * or a git binary that fails degrades to an empty list rather than throwing,
+ * matching the fail-degrade pattern the rest of this module and
+ * `src/git-aware/refs.ts` already use — an empty list means "prune
+ * everything under branches/", which is the safe read for "not a git repo."
+ */
+async function listLiveRefs(root) {
+    const refs = new Set();
+    try {
+        const { stdout } = await execFileAsync('git', ['branch', '--format=%(refname:short)'], { cwd: root, timeout: GIT_TIMEOUT_MS });
+        for (const line of stdout.split('\n')) {
+            const trimmed = line.trim();
+            if (trimmed)
+                refs.add(trimmed);
+        }
+    }
+    catch {
+        // Non-git directory, or git unavailable — fall through to worktree check.
+    }
+    try {
+        const { stdout } = await execFileAsync('git', ['worktree', 'list', '--porcelain'], { cwd: root, timeout: GIT_TIMEOUT_MS });
+        for (const line of stdout.split('\n')) {
+            const match = line.match(/^branch refs\/heads\/(.+)$/);
+            if (match && match[1])
+                refs.add(match[1]);
+        }
+    }
+    catch {
+        // Best-effort — no worktrees to add.
+    }
+    return Array.from(refs);
+}
+export function registerArchDiffCommand(program) {
+    program
+        .command('arch-diff')
+        .description('Pre-merge architecture diff: current branch vs. canonical (or a named --base ref)')
+        .option('--base <ref>', 'Diff against this ref\'s recorded snapshot instead of the canonical baseline')
+        .option('--record', 'Also write the current ref\'s snapshot before diffing (canonical if on the default branch, else branches/<slug>)')
+        .option('--prune', 'Remove branch-delta snapshots (branches/<slug>/) for refs that no longer exist as a local branch or worktree, before diffing')
+        .option('--json', 'Output as JSON')
+        .option('--agent', 'Output wrapped in agent envelope (implies --json)')
+        .action(async (options) => {
+        try {
+            const root = process.cwd();
+            const isAgent = !!options.agent;
+            const isJson = !!options.json || isAgent;
+            let pruned;
+            if (options.prune) {
+                const liveRefs = await listLiveRefs(root);
+                pruned = await pruneBranchSnapshots(root, liveRefs);
+            }
+            let recorded;
+            if (options.record) {
+                recorded = await writeSnapshotForCurrentRef(root);
+            }
+            const result = await premergeDiff(root, { base: options.base });
+            const data = { ...result, recorded: recorded ?? null, pruned: pruned ?? null };
+            if (isAgent) {
+                console.log(wrapInEnvelope('arch-diff', data));
+            }
+            else if (isJson) {
+                console.log(JSON.stringify(data, null, 2));
+            }
+            else {
+                printHuman(data);
+            }
+            // House convention (mirrors scan-remote): NO_DATA signals "ran
+            // fine, nothing to report yet" — never a crash, but never silently
+            // SUCCESS as though the diff itself succeeded.
+            if (!result.available) {
+                process.exitCode = EXIT_CODES.NO_DATA;
+            }
+        }
+        catch (error) {
+            console.error('arch-diff failed:', error instanceof Error ? error.message : String(error));
+            process.exitCode = EXIT_CODES.OPERATIONAL;
+        }
+    });
+}
+function printHuman(data) {
+    console.log('NavGator Pre-Merge Architecture Diff');
+    console.log('='.repeat(60));
+    if (data.pruned) {
+        console.log(data.pruned.removed.length > 0
+            ? `Pruned ${data.pruned.removed.length} stale branch snapshot(s): ${data.pruned.removed.join(', ')}`
+            : 'Pruned 0 stale branch snapshots (nothing to remove)');
+    }
+    if (data.recorded) {
+        console.log(`Recorded snapshot for "${data.recorded.ref ?? '(unknown)'}" -> ${data.recorded.path} (${data.recorded.isDefault ? 'canonical' : 'branch'})`);
+    }
+    console.log(`Base: ${data.base}`);
+    console.log(`Head: ${data.head ?? '(unresolved)'}`);
+    console.log('');
+    if (!data.available) {
+        console.log(`No diff available: ${data.reason}`);
+        return;
+    }
+    const diff = data.diff;
+    const sig = data.significance;
+    console.log(`Significance: ${sig.significance} (${sig.triggers.join(', ') || 'none'})`);
+    console.log(`Total changes: ${diff.stats.total_changes}`);
+    console.log('');
+    console.log(`Components added (${diff.components.added.length}):`);
+    for (const c of diff.components.added)
+        console.log(`  + ${c.name} (${c.type}, ${c.layer})`);
+    console.log(`Components removed (${diff.components.removed.length}):`);
+    for (const c of diff.components.removed)
+        console.log(`  - ${c.name} (${c.type}, ${c.layer})`);
+    console.log(`Components modified (${diff.components.modified.length}):`);
+    for (const c of diff.components.modified)
+        console.log(`  ~ ${c.name}: ${c.changes.join('; ')}`);
+    console.log('');
+    console.log(`Connections added (${diff.connections.added.length}):`);
+    for (const c of diff.connections.added)
+        console.log(`  + ${c.from_name} -> ${c.to_name} (${c.type})`);
+    console.log(`Connections removed (${diff.connections.removed.length}):`);
+    for (const c of diff.connections.removed)
+        console.log(`  - ${c.from_name} -> ${c.to_name} (${c.type})`);
+}
+//# sourceMappingURL=arch-diff.js.map

package/dist/cli/commands/arch-diff.js.map

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

package/dist/cli/commands/arch-index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `navgator arch-index [--write] [--check] [--json] [--agent]` — generate the
+ * committed, version-controlled architecture index.
+ *
+ * Unlike every other NavGator command, this one does NOT read
+ * `.navgator/architecture/`. That store is a per-clone cache: gitignored,
+ * timestamped, machine-specific. This command scans the tree directly so it
+ * produces the same bytes on a developer laptop and on a clean CI checkout,
+ * which is what makes `--check` a usable merge gate.
+ *
+ * Outputs (both committed):
+ *   ARCHITECTURE.md              — answer-first entry point for a cold agent
+ *   docs/architecture/index.json — machine-readable, per-file blast radius
+ *
+ * Exit codes follow src/cli/exit-codes.ts. `--check` exits NO_DATA (2) when
+ * the committed copy is stale, which is a "regenerate and commit" signal, not
+ * an internal error.
+ */
+import { Command } from 'commander';
+export declare function registerArchIndexCommand(program: Command): void;
+//# sourceMappingURL=arch-index.d.ts.map

package/dist/cli/commands/arch-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arch-index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/arch-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+F/D"}

package/dist/cli/commands/arch-index.js

@@ -0,0 +1,96 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { ARCHITECTURE_INDEX_PATH, ARCHITECTURE_MD_PATH, buildArchitectureIndex, stableStringify, writeArchitectureIndex, } from '../../architecture-index.js';
+import { wrapInEnvelope } from '../../agent-output.js';
+import { EXIT_CODES } from '../exit-codes.js';
+export function registerArchIndexCommand(program) {
+    program
+        .command('arch-index')
+        .description('Generate the committed architecture index (ARCHITECTURE.md + docs/architecture/index.json)')
+        .option('--write', 'Write the artifacts to disk')
+        .option('--check', 'Exit 2 if the committed artifacts are stale (CI gate)')
+        .option('--json', 'Output as JSON')
+        .option('--agent', 'Output wrapped in agent envelope (implies --json)')
+        .action(async (options) => {
+        try {
+            if (options.write && options.check) {
+                console.error('--write and --check are mutually exclusive.');
+                process.exitCode = EXIT_CODES.USAGE;
+                return;
+            }
+            const root = process.cwd();
+            if (options.write) {
+                const { changed, index } = await writeArchitectureIndex(root);
+                const payload = {
+                    changed,
+                    coverage: index.coverage.status,
+                    analyzed_files: index.coverage.analyzed_files,
+                    internal_edges: index.coverage.internal_edges,
+                    modules: index.modules.length,
+                    uncurated_modules: index.modules.filter(m => !m.curated).length,
+                    violated_boundaries: index.boundaries.filter(b => b.status === 'violated').length,
+                };
+                if (options.agent) {
+                    console.log(wrapInEnvelope('arch-index', payload));
+                    return;
+                }
+                if (options.json) {
+                    console.log(JSON.stringify(payload, null, 2));
+                    return;
+                }
+                console.log(changed.length === 0
+                    ? 'Architecture index already up to date.'
+                    : `Architecture index updated: ${changed.join(', ')}`);
+                console.log(`  coverage=${payload.coverage} files=${payload.analyzed_files} ` +
+                    `edges=${payload.internal_edges} modules=${payload.modules} ` +
+                    `uncurated=${payload.uncurated_modules} boundary-violations=${payload.violated_boundaries}`);
+                return;
+            }
+            const { index, markdown } = await buildArchitectureIndex(root);
+            if (options.check) {
+                const stale = [];
+                const expected = [
+                    [ARCHITECTURE_MD_PATH, markdown],
+                    [ARCHITECTURE_INDEX_PATH, stableStringify(index)],
+                ];
+                for (const [relative, content] of expected) {
+                    const absolute = path.join(root, relative);
+                    const actual = fs.existsSync(absolute) ? fs.readFileSync(absolute, 'utf-8') : null;
+                    if (actual !== content)
+                        stale.push(relative);
+                }
+                const payload = { stale, up_to_date: stale.length === 0 };
+                if (options.agent) {
+                    console.log(wrapInEnvelope('arch-index', payload));
+                }
+                else if (options.json) {
+                    console.log(JSON.stringify(payload, null, 2));
+                }
+                else if (stale.length === 0) {
+                    console.log('Architecture index is up to date.');
+                }
+                else {
+                    console.error(`Architecture index is stale: ${stale.join(', ')}\n` +
+                        'Run `npm run architecture` and commit the result.');
+                }
+                if (stale.length > 0)
+                    process.exitCode = EXIT_CODES.NO_DATA;
+                return;
+            }
+            if (options.agent) {
+                console.log(wrapInEnvelope('arch-index', index));
+                return;
+            }
+            if (options.json) {
+                console.log(stableStringify(index).trimEnd());
+                return;
+            }
+            console.log(markdown);
+        }
+        catch (error) {
+            console.error(`arch-index failed: ${error instanceof Error ? error.message : String(error)}`);
+            process.exitCode = EXIT_CODES.OPERATIONAL;
+        }
+    });
+}
+//# sourceMappingURL=arch-index.js.map

package/dist/cli/commands/arch-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arch-index.js","sourceRoot":"","sources":["../../../src/cli/commands/arch-index.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,EACf,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAS9C,MAAM,UAAU,wBAAwB,CAAC,OAAgB;IACvD,OAAO;SACJ,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,4FAA4F,CAAC;SACzG,MAAM,CAAC,SAAS,EAAE,6BAA6B,CAAC;SAChD,MAAM,CAAC,SAAS,EAAE,uDAAuD,CAAC;SAC1E,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,SAAS,EAAE,mDAAmD,CAAC;SACtE,MAAM,CAAC,KAAK,EAAE,OAAyB,EAAE,EAAE;QAC1C,IAAI,CAAC;YACH,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBACnC,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;gBAC7D,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC;gBACpC,OAAO;YACT,CAAC;YAED,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;YAE3B,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBAClB,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,CAAC;gBAC9D,MAAM,OAAO,GAAG;oBACd,OAAO;oBACP,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM;oBAC/B,cAAc,EAAE,KAAK,CAAC,QAAQ,CAAC,cAAc;oBAC7C,cAAc,EAAE,KAAK,CAAC,QAAQ,CAAC,cAAc;oBAC7C,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM;oBAC7B,iBAAiB,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM;oBAC/D,mBAAmB,EAAE,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,MAAM;iBAClF,CAAC;gBACF,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;oBAClB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;oBACnD,OAAO;gBACT,CAAC;gBACD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;oBACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;oBAC9C,OAAO;gBACT,CAAC;gBACD,OAAO,CAAC,GAAG,CACT,OAAO,CAAC,MAAM,KAAK,CAAC;oBAClB,CAAC,CAAC,wCAAwC;oBAC1C,CAAC,CAAC,+BAA+B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxD,CAAC;gBACF,OAAO,CAAC,GAAG,CACT,cAAc,OAAO,CAAC,QAAQ,UAAU,OAAO,CAAC,cAAc,GAAG;oBACjE,SAAS,OAAO,CAAC,cAAc,YAAY,OAAO,CAAC,OAAO,GAAG;oBAC7D,aAAa,OAAO,CAAC,iBAAiB,wBAAwB,OAAO,CAAC,mBAAmB,EAAE,CAC5F,CAAC;gBACF,OAAO;YACT,CAAC;YAED,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,CAAC;YAE/D,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBAClB,MAAM,KAAK,GAAa,EAAE,CAAC;gBAC3B,MAAM,QAAQ,GAA4B;oBACxC,CAAC,oBAAoB,EAAE,QAAQ,CAAC;oBAChC,CAAC,uBAAuB,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;iBAClD,CAAC;gBACF,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,QAAQ,EAAE,CAAC;oBAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;oBAC3C,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;oBACnF,IAAI,MAAM,KAAK,OAAO;wBAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC/C,CAAC;gBAED,MAAM,OAAO,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1D,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;oBAClB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;gBACrD,CAAC;qBAAM,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;oBACxB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBAChD,CAAC;qBAAM,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC9B,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;gBACnD,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,KAAK,CACX,gCAAgC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;wBACpD,mDAAmD,CACpD,CAAC;gBACJ,CAAC;gBACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;oBAAE,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC;gBAC5D,OAAO;YACT,CAAC;YAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBAClB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC;gBACjD,OAAO;YACT,CAAC;YACD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACjB,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC9C,OAAO;YACT,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,sBAAsB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC9F,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,WAAW,CAAC;QAC5C,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/audit-report.d.ts

@@ -0,0 +1,50 @@
+/**
+ * `navgator audit-report` — Run 4 (2026-09-05).
+ *
+ * Reads the stored audit history (timeline entries carrying `audit`), the
+ * per-stratum control-chart state on index.json, and prints:
+ *   - the last N audits (plan, distinct facts sampled, defects, rate + 95% CI, verdict)
+ *   - the c=0 screen with its producer's-risk caveat
+ *   - the census (exact unresolved-endpoint count, by type and top dir)
+ *   - oracle precision/recall with intervals (stored from the last scan, or
+ *     recomputed live with --oracles / --scip)
+ *   - chart state per stratum (phase, centre, limits, last points, signals)
+ *   - optional --self-test: plants K defects per class into an in-memory
+ *     clone of the graph and reports per-class instrument recall.
+ *
+ * Output: --md (default) or --json. Read-only except for the SCIP indexer's
+ * temp file when --scip is passed.
+ */
+import { Command } from 'commander';
+import type { AuditOracleResult, AuditReport, EwmaStateSnapshot, ProportionInterval } from '../../types.js';
+import { type SelfTestReport } from '../../audit/self-test.js';
+interface AuditReportData {
+    navgator_version: string;
+    project_root: string;
+    generated_at: number;
+    audit_history_count: number;
+    pending_drift_breach: boolean;
+    audits: Array<{
+        timestamp: number;
+        scan_type?: string;
+        plan: string;
+        n: number;
+        sampled: number;
+        defects: number;
+        defect_rate: number;
+        ci: ProportionInterval;
+        verdict: string;
+        drift_breach: boolean;
+        navgator_version?: string;
+        screen?: AuditReport['screen'];
+        sprt?: AuditReport['sprt'];
+    }>;
+    latest: AuditReport | null;
+    charts: Record<string, EwmaStateSnapshot>;
+    live_oracles?: AuditOracleResult[];
+    self_test?: SelfTestReport;
+}
+export declare function registerAuditReportCommand(program: Command): void;
+export declare function renderMarkdown(d: AuditReportData): string;
+export {};
+//# sourceMappingURL=audit-report.d.ts.map

package/dist/cli/commands/audit-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-report.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/audit-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,OAAO,KAAK,EAAqB,iBAAiB,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAE/H,OAAO,EAAe,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAmB5E,UAAU,eAAe;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,MAAM,EAAE,KAAK,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,CAAC,EAAE,MAAM,CAAC;QACV,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,EAAE,EAAE,kBAAkB,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,OAAO,CAAC;QACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC/B,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;KAC5B,CAAC,CAAC;IACH,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC1C,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACnC,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqGjE;AAoBD,wBAAgB,cAAc,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAyLzD"}