@tyroneross/navgator 0.2.2 → 0.9.0

package/dist/freshness/scan-lock.js

@@ -0,0 +1,68 @@
+/**
+ * Single-writer scan lock. Under the parallel rally fleet many hooks fire at
+ * once; only one drainer may scan at a time or the graph/ledger corrupts. The
+ * lock is a JSON file holding the owner PID + a heartbeat. A lock is considered
+ * stealable when its heartbeat is older than LOCK_TTL_MS OR its PID is dead, so
+ * a crashed drainer never wedges the system.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { scanLockPath } from './paths.js';
+export const LOCK_TTL_MS = 60_000;
+function pidAlive(pid) {
+    try {
+        process.kill(pid, 0); // signal 0 = existence check, doesn't kill
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function readLock(p) {
+    try {
+        const l = JSON.parse(fs.readFileSync(p, 'utf8'));
+        if (typeof l?.pid === 'number' && typeof l?.heartbeat_at === 'number')
+            return l;
+    }
+    catch {
+        /* missing/corrupt -> treat as free */
+    }
+    return null;
+}
+/** Try to take the lock. Returns true on success, false if a live lock exists. */
+export function acquireLock(root) {
+    const p = scanLockPath(root);
+    fs.mkdirSync(path.dirname(p), { recursive: true });
+    const existing = readLock(p);
+    if (existing) {
+        const fresh = Date.now() - existing.heartbeat_at < LOCK_TTL_MS;
+        if (fresh && pidAlive(existing.pid))
+            return false; // genuinely held
+        // else: stale or dead owner -> steal
+    }
+    fs.writeFileSync(p, JSON.stringify({ pid: process.pid, heartbeat_at: Date.now() }));
+    return true;
+}
+/** Refresh the heartbeat mid-scan (call periodically for long scans). */
+export function touchLock(root) {
+    try {
+        fs.writeFileSync(scanLockPath(root), JSON.stringify({ pid: process.pid, heartbeat_at: Date.now() }));
+    }
+    catch {
+        /* best effort */
+    }
+}
+/** Release the lock if we own it. */
+export function releaseLock(root) {
+    const p = scanLockPath(root);
+    const existing = readLock(p);
+    if (existing && existing.pid === process.pid) {
+        try {
+            fs.rmSync(p, { force: true });
+        }
+        catch {
+            /* best effort */
+        }
+    }
+}
+//# sourceMappingURL=scan-lock.js.map

package/dist/freshness/scan-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-lock.js","sourceRoot":"","sources":["../../src/freshness/scan-lock.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC;AAOlC,SAAS,QAAQ,CAAC,GAAW;IAC3B,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,2CAA2C;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS;IACzB,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAS,CAAC;QACzD,IAAI,OAAO,CAAC,EAAE,GAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,EAAE,YAAY,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC;IAClF,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC7B,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,YAAY,GAAG,WAAW,CAAC;QAC/D,IAAI,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC,CAAC,iBAAiB;QACpE,qCAAqC;IACvC,CAAC;IACD,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,EAAU,CAAC,CAAC,CAAC;IAC5F,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CACd,YAAY,CAAC,IAAI,CAAC,EAClB,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,EAAU,CAAC,CACvE,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;AACH,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,QAAQ,IAAI,QAAQ,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/freshness/stamp.d.ts

@@ -0,0 +1,25 @@
+export interface FreshnessStamp {
+    version: 1;
+    /** epoch ms of the last clean drain (scan completion). */
+    generated_at: number;
+    /** short commit sha the graph was generated against ('' if not a git repo). */
+    commit_sha: string;
+    /** branch name ('' if unknown). */
+    branch: string;
+    /** files changed since generated_at and not yet drained. */
+    dirty_files: string[];
+    dirty_count: number;
+    /** true while a drain is mid-flight. */
+    scan_in_flight: boolean;
+}
+export declare function writeStamp(root: string, stamp: FreshnessStamp): void;
+export declare function readStamp(root: string): FreshnessStamp | null;
+/**
+ * Compute a stamp for the current moment. `inFlight` marks a drain in progress;
+ * `generatedAt` defaults to now (use the scan completion time on a clean drain).
+ */
+export declare function computeStamp(root: string, opts?: {
+    inFlight: boolean;
+    generatedAt?: number;
+}): Promise<FreshnessStamp>;
+//# sourceMappingURL=stamp.d.ts.map

package/dist/freshness/stamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp.d.ts","sourceRoot":"","sources":["../../src/freshness/stamp.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,CAAC;IACX,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAMpE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAU7D;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAwB,GACtE,OAAO,CAAC,cAAc,CAAC,CAYzB"}

package/dist/freshness/stamp.js

@@ -0,0 +1,50 @@
+/**
+ * The freshness stamp: the honesty contract for the architecture view. Every
+ * read can check this to know whether the view is current or how many files
+ * have changed since the last clean drain. Cheaper and more robust than
+ * guaranteeing freshness, especially under N parallel agents.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { getGitInfo } from '../git.js';
+import { stampPath } from './paths.js';
+import { readDirty } from './dirty-ledger.js';
+export function writeStamp(root, stamp) {
+    const p = stampPath(root);
+    fs.mkdirSync(path.dirname(p), { recursive: true });
+    const tmp = `${p}.tmp`;
+    fs.writeFileSync(tmp, JSON.stringify(stamp, null, 2), 'utf8');
+    fs.renameSync(tmp, p);
+}
+export function readStamp(root) {
+    const p = stampPath(root);
+    if (!fs.existsSync(p))
+        return null;
+    try {
+        const parsed = JSON.parse(fs.readFileSync(p, 'utf8'));
+        if (parsed?.version === 1)
+            return parsed;
+    }
+    catch {
+        /* corrupt -> null */
+    }
+    return null;
+}
+/**
+ * Compute a stamp for the current moment. `inFlight` marks a drain in progress;
+ * `generatedAt` defaults to now (use the scan completion time on a clean drain).
+ */
+export async function computeStamp(root, opts = { inFlight: false }) {
+    const git = await getGitInfo(root);
+    const dirty = readDirty(root);
+    return {
+        version: 1,
+        generated_at: opts.generatedAt ?? Date.now(),
+        commit_sha: git?.commit ?? '',
+        branch: git?.branch ?? '',
+        dirty_files: dirty,
+        dirty_count: dirty.length,
+        scan_in_flight: opts.inFlight,
+    };
+}
+//# sourceMappingURL=stamp.js.map

package/dist/freshness/stamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp.js","sourceRoot":"","sources":["../../src/freshness/stamp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAiB9C,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAqB;IAC5D,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC1B,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;IACvB,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC9D,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAmB,CAAC;QACxE,IAAI,MAAM,EAAE,OAAO,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,qBAAqB;IACvB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAY,EACZ,OAAoD,EAAE,QAAQ,EAAE,KAAK,EAAE;IAEvE,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO;QACL,OAAO,EAAE,CAAC;QACV,YAAY,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,EAAE;QAC5C,UAAU,EAAE,GAAG,EAAE,MAAM,IAAI,EAAE;QAC7B,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,EAAE;QACzB,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,MAAM;QACzB,cAAc,EAAE,IAAI,CAAC,QAAQ;KAC9B,CAAC;AACJ,CAAC"}

package/dist/git.d.ts

@@ -0,0 +1,12 @@
+/**
+ * NavGator Git Utilities
+ * Reads branch and commit info for opt-in branch tracking
+ */
+import { GitInfo } from './types.js';
+/**
+ * Get current git branch and commit info.
+ * Returns null if not a git repo or git is unavailable.
+ * Never throws — all failures return null.
+ */
+export declare function getGitInfo(projectRoot: string): Promise<GitInfo | null>;
+//# sourceMappingURL=git.d.ts.map

package/dist/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAiB7E"}

package/dist/git.js

@@ -0,0 +1,42 @@
+/**
+ * NavGator Git Utilities
+ * Reads branch and commit info for opt-in branch tracking
+ */
+import { exec } from 'child_process';
+/**
+ * Get current git branch and commit info.
+ * Returns null if not a git repo or git is unavailable.
+ * Never throws — all failures return null.
+ */
+export async function getGitInfo(projectRoot) {
+    try {
+        const [branch, commitFull] = await Promise.all([
+            execGit('git rev-parse --abbrev-ref HEAD', projectRoot),
+            execGit('git rev-parse HEAD', projectRoot),
+        ]);
+        if (!branch || !commitFull)
+            return null;
+        return {
+            branch: branch.trim(),
+            commit: commitFull.trim().slice(0, 7),
+            commitFull: commitFull.trim(),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function execGit(command, cwd) {
+    return new Promise((resolve) => {
+        const child = exec(command, { cwd, timeout: 3000 }, (error, stdout) => {
+            if (error) {
+                resolve(null);
+                return;
+            }
+            resolve(stdout);
+        });
+        // Safety: kill on timeout (exec timeout should handle this, but belt-and-suspenders)
+        child.on('error', () => resolve(null));
+    });
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAGrC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,WAAmB;IAClD,IAAI,CAAC;QACH,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC7C,OAAO,CAAC,iCAAiC,EAAE,WAAW,CAAC;YACvD,OAAO,CAAC,oBAAoB,EAAE,WAAW,CAAC;SAC3C,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QAExC,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;YACrB,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YACrC,UAAU,EAAE,UAAU,CAAC,IAAI,EAAE;SAC9B,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,OAAe,EAAE,GAAW;IAC3C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YACpE,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,CAAC,IAAI,CAAC,CAAC;gBACd,OAAO;YACT,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,qFAAqF;QACrF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/gitignore-safety.d.ts

@@ -0,0 +1,41 @@
+/**
+ * NavGator Gitignore Safety
+ *
+ * Auto-adds gitignore entries for NavGator's generated architecture output
+ * that contains live-environment metadata. Specifically:
+ *
+ *   - .navgator/architecture/components/COMP_config_*.json
+ *     These are per-env-var component files. NavGator's env scanner uses
+ *     Node's URL class to strip usernames/passwords when parsing connection
+ *     strings, so the files DO NOT contain credentials. However, they do
+ *     contain parsed hostnames and ports (e.g. `db.project-ref.supabase.co`)
+ *     which are identifying infrastructure info that users generally do not
+ *     want in a public git history.
+ *
+ *   - .navgator/architecture/NAVSUMMARY.md
+ *   - .navgator/architecture/NAVSUMMARY_FULL.md
+ *     Summary files that inline the above hostnames.
+ *
+ * This runs at the end of every scan. Idempotent: if the entries are already
+ * present (or a more-general rule like `.navgator/` is present), it's a no-op.
+ *
+ * Philosophy: NavGator's architecture data is regenerated from live env on
+ * every scan, so losing it from git is zero-cost. The first run writes the
+ * gitignore entries; subsequent runs notice they're there and skip.
+ *
+ * Opt-out: set NAVGATOR_SKIP_GITIGNORE_GUARD=1 in the environment, or delete
+ * the managed block and NavGator will not re-add it (the marker comment is
+ * load-bearing).
+ */
+export interface GitignoreGuardResult {
+    action: 'added' | 'already-present' | 'no-gitignore' | 'opt-out';
+    gitignorePath: string;
+}
+/**
+ * Ensure the project's .gitignore has NavGator-managed safety patterns.
+ *
+ * Runs silently unless a change is made. Returns a result object callers
+ * can log if they want to surface the behavior.
+ */
+export declare function ensureSafeGitignore(projectRoot: string): Promise<GitignoreGuardResult>;
+//# sourceMappingURL=gitignore-safety.d.ts.map

package/dist/gitignore-safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore-safety.d.ts","sourceRoot":"","sources":["../src/gitignore-safety.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAqCH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,GAAG,iBAAiB,GAAG,cAAc,GAAG,SAAS,CAAC;IACjE,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA6C5F"}

package/dist/gitignore-safety.js

@@ -0,0 +1,107 @@
+/**
+ * NavGator Gitignore Safety
+ *
+ * Auto-adds gitignore entries for NavGator's generated architecture output
+ * that contains live-environment metadata. Specifically:
+ *
+ *   - .navgator/architecture/components/COMP_config_*.json
+ *     These are per-env-var component files. NavGator's env scanner uses
+ *     Node's URL class to strip usernames/passwords when parsing connection
+ *     strings, so the files DO NOT contain credentials. However, they do
+ *     contain parsed hostnames and ports (e.g. `db.project-ref.supabase.co`)
+ *     which are identifying infrastructure info that users generally do not
+ *     want in a public git history.
+ *
+ *   - .navgator/architecture/NAVSUMMARY.md
+ *   - .navgator/architecture/NAVSUMMARY_FULL.md
+ *     Summary files that inline the above hostnames.
+ *
+ * This runs at the end of every scan. Idempotent: if the entries are already
+ * present (or a more-general rule like `.navgator/` is present), it's a no-op.
+ *
+ * Philosophy: NavGator's architecture data is regenerated from live env on
+ * every scan, so losing it from git is zero-cost. The first run writes the
+ * gitignore entries; subsequent runs notice they're there and skip.
+ *
+ * Opt-out: set NAVGATOR_SKIP_GITIGNORE_GUARD=1 in the environment, or delete
+ * the managed block and NavGator will not re-add it (the marker comment is
+ * load-bearing).
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+const MARKER_START = '# >>> NavGator safety guard (auto-managed)';
+const MARKER_END = '# <<< NavGator safety guard';
+const GUARDED_PATTERNS = [
+    '.navgator/architecture/components/COMP_config_*.json',
+    // R6 consolidated full-shape JSONL files carry the same env-hostname data as
+    // the per-entity COMP_config_*.json files (they inline every component the
+    // scanner produced, including env-parsed hostnames). Guard them so the
+    // previous COMP_config_* rule isn't rendered inert when per-entity files are
+    // off (the R6 default).
+    '.navgator/architecture/components.full.jsonl',
+    '.navgator/architecture/connections.full.jsonl',
+    '.navgator/architecture/NAVSUMMARY.md',
+    '.navgator/architecture/NAVSUMMARY_FULL.md',
+    // Legacy filenames from pre-rename NavGator versions — harmless if not written.
+    '.navgator/architecture/SUMMARY.md',
+    '.navgator/architecture/SUMMARY_FULL.md',
+];
+const BLOCK = [
+    '',
+    MARKER_START,
+    '# These files are regenerated from .env on every NavGator scan and contain',
+    '# parsed hostnames/endpoints from your live environment. Credentials are',
+    '# stripped by NavGator, but hostnames/project refs still leak infra identity.',
+    '# Safe to delete this block if you want the files tracked — NavGator will',
+    '# not re-add it while the markers below are missing.',
+    ...GUARDED_PATTERNS,
+    MARKER_END,
+    '',
+].join('\n');
+/**
+ * Ensure the project's .gitignore has NavGator-managed safety patterns.
+ *
+ * Runs silently unless a change is made. Returns a result object callers
+ * can log if they want to surface the behavior.
+ */
+export async function ensureSafeGitignore(projectRoot) {
+    const gitignorePath = path.join(projectRoot, '.gitignore');
+    // Opt-out via env var
+    if (process.env.NAVGATOR_SKIP_GITIGNORE_GUARD === '1') {
+        return { action: 'opt-out', gitignorePath };
+    }
+    // Nothing to do if .gitignore doesn't exist — don't create one just for this
+    if (!fs.existsSync(gitignorePath)) {
+        return { action: 'no-gitignore', gitignorePath };
+    }
+    let content;
+    try {
+        content = await fs.promises.readFile(gitignorePath, 'utf-8');
+    }
+    catch {
+        return { action: 'no-gitignore', gitignorePath };
+    }
+    // Already has the managed block
+    if (content.includes(MARKER_START)) {
+        return { action: 'already-present', gitignorePath };
+    }
+    // User has a broader rule that covers the guarded patterns → no-op
+    // (Don't add a duplicate block if `.navgator/` or equivalent is already ignored.)
+    const broaderRules = [
+        '.navgator/',
+        '.navgator/architecture/',
+        '.navgator/architecture/components/',
+    ];
+    const lines = content.split('\n').map((l) => l.trim());
+    for (const broader of broaderRules) {
+        if (lines.includes(broader)) {
+            return { action: 'already-present', gitignorePath };
+        }
+    }
+    // Append the managed block
+    const needsTrailingNewline = content.length > 0 && !content.endsWith('\n');
+    const newContent = content + (needsTrailingNewline ? '\n' : '') + BLOCK;
+    await fs.promises.writeFile(gitignorePath, newContent, 'utf-8');
+    return { action: 'added', gitignorePath };
+}
+//# sourceMappingURL=gitignore-safety.js.map

package/dist/gitignore-safety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore-safety.js","sourceRoot":"","sources":["../src/gitignore-safety.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,YAAY,GAAG,4CAA4C,CAAC;AAClE,MAAM,UAAU,GAAG,6BAA6B,CAAC;AAEjD,MAAM,gBAAgB,GAAG;IACvB,sDAAsD;IACtD,6EAA6E;IAC7E,2EAA2E;IAC3E,uEAAuE;IACvE,6EAA6E;IAC7E,wBAAwB;IACxB,8CAA8C;IAC9C,+CAA+C;IAC/C,sCAAsC;IACtC,2CAA2C;IAC3C,gFAAgF;IAChF,mCAAmC;IACnC,wCAAwC;CACzC,CAAC;AAEF,MAAM,KAAK,GAAG;IACZ,EAAE;IACF,YAAY;IACZ,4EAA4E;IAC5E,0EAA0E;IAC1E,+EAA+E;IAC/E,2EAA2E;IAC3E,sDAAsD;IACtD,GAAG,gBAAgB;IACnB,UAAU;IACV,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAOb;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,WAAmB;IAC3D,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAE3D,sBAAsB;IACtB,IAAI,OAAO,CAAC,GAAG,CAAC,6BAA6B,KAAK,GAAG,EAAE,CAAC;QACtD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;IAC9C,CAAC;IAED,6EAA6E;IAC7E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;IACnD,CAAC;IAED,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;IACnD,CAAC;IAED,gCAAgC;IAChC,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,aAAa,EAAE,CAAC;IACtD,CAAC;IAED,mEAAmE;IACnE,kFAAkF;IAClF,MAAM,YAAY,GAAG;QACnB,YAAY;QACZ,yBAAyB;QACzB,oCAAoC;KACrC,CAAC;IACF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,aAAa,EAAE,CAAC;QACtD,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,MAAM,oBAAoB,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,OAAO,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;IACxE,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAEhE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;AAC5C,CAAC"}

package/dist/impact.d.ts

@@ -0,0 +1,20 @@
+/**
+ * NavGator Impact Analysis
+ * Severity-scored impact analysis with transitive dependency tracking
+ */
+import { ArchitectureComponent, ArchitectureConnection, ImpactAnalysis, ImpactSeverity } from './types.js';
+/**
+ * Compute severity level for a component based on its role and dependent count.
+ *
+ * - critical: database/infra layer, or >5 dependents, or role.critical
+ * - high: backend layer, or 3-5 dependents
+ * - medium: 2 dependents
+ * - low: 0-1 dependents
+ */
+export declare function computeSeverity(component: ArchitectureComponent, dependentCount: number): ImpactSeverity;
+/**
+ * Compute full impact analysis for a component.
+ * Includes direct and one-level transitive dependents.
+ */
+export declare function computeImpact(component: ArchitectureComponent, allComponents: ArchitectureComponent[], allConnections: ArchitectureConnection[]): ImpactAnalysis;
+//# sourceMappingURL=impact.d.ts.map

package/dist/impact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact.d.ts","sourceRoot":"","sources":["../src/impact.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,cAAc,EAEf,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,qBAAqB,EAChC,cAAc,EAAE,MAAM,GACrB,cAAc,CAyBhB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,qBAAqB,EAChC,aAAa,EAAE,qBAAqB,EAAE,EACtC,cAAc,EAAE,sBAAsB,EAAE,GACvC,cAAc,CAqEhB"}

package/dist/impact.js

@@ -0,0 +1,89 @@
+/**
+ * NavGator Impact Analysis
+ * Severity-scored impact analysis with transitive dependency tracking
+ */
+/**
+ * Compute severity level for a component based on its role and dependent count.
+ *
+ * - critical: database/infra layer, or >5 dependents, or role.critical
+ * - high: backend layer, or 3-5 dependents
+ * - medium: 2 dependents
+ * - low: 0-1 dependents
+ */
+export function computeSeverity(component, dependentCount) {
+    const layer = component.role.layer;
+    // Critical: infrastructure/database, high fan-in, or explicitly marked critical
+    if (layer === 'database' ||
+        layer === 'infra' ||
+        dependentCount > 5 ||
+        component.role.critical) {
+        return 'critical';
+    }
+    // High: backend services or moderate fan-in
+    if (layer === 'backend' || (dependentCount >= 3 && dependentCount <= 5)) {
+        return 'high';
+    }
+    // Medium: 2 dependents
+    if (dependentCount === 2) {
+        return 'medium';
+    }
+    // Low: 0-1 dependents
+    return 'low';
+}
+/**
+ * Compute full impact analysis for a component.
+ * Includes direct and one-level transitive dependents.
+ */
+export function computeImpact(component, allComponents, allConnections) {
+    // Find direct dependents — connections TO this component (things that use it)
+    const directConnections = allConnections.filter((c) => c.to.component_id === component.component_id);
+    const affected = [];
+    const affectedFiles = new Set();
+    const directComponentIds = new Set();
+    // Direct dependents
+    for (const conn of directConnections) {
+        const dependentComponent = allComponents.find((c) => c.component_id === conn.from.component_id);
+        if (!dependentComponent)
+            continue;
+        directComponentIds.add(dependentComponent.component_id);
+        affected.push({
+            component: dependentComponent,
+            connection: conn,
+            impact_type: 'direct',
+            change_required: `Uses ${component.name} via ${conn.connection_type} at ${conn.code_reference?.file || 'unknown'}`,
+        });
+        if (conn.code_reference?.file) {
+            affectedFiles.add(conn.code_reference.file);
+        }
+    }
+    // Transitive dependents (one level deep)
+    for (const directId of directComponentIds) {
+        const transitiveConnections = allConnections.filter((c) => c.to.component_id === directId && !directComponentIds.has(c.from.component_id) && c.from.component_id !== component.component_id);
+        for (const conn of transitiveConnections) {
+            const transitiveComponent = allComponents.find((c) => c.component_id === conn.from.component_id);
+            if (!transitiveComponent)
+                continue;
+            const directDep = allComponents.find((c) => c.component_id === directId);
+            affected.push({
+                component: transitiveComponent,
+                connection: conn,
+                impact_type: 'transitive',
+                change_required: `Indirectly affected via ${directDep?.name || directId}`,
+            });
+            if (conn.code_reference?.file) {
+                affectedFiles.add(conn.code_reference.file);
+            }
+        }
+    }
+    const severity = computeSeverity(component, directComponentIds.size);
+    const directCount = directComponentIds.size;
+    const transitiveCount = affected.filter((a) => a.impact_type === 'transitive').length;
+    return {
+        component,
+        severity,
+        affected,
+        total_files_affected: affectedFiles.size,
+        summary: `${severity.toUpperCase()}: ${directCount} direct dependent${directCount !== 1 ? 's' : ''}, ${transitiveCount} transitive, ${affectedFiles.size} file${affectedFiles.size !== 1 ? 's' : ''} affected`,
+    };
+}
+//# sourceMappingURL=impact.js.map

package/dist/impact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact.js","sourceRoot":"","sources":["../src/impact.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAgC,EAChC,cAAsB;IAEtB,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;IAEnC,gFAAgF;IAChF,IACE,KAAK,KAAK,UAAU;QACpB,KAAK,KAAK,OAAO;QACjB,cAAc,GAAG,CAAC;QAClB,SAAS,CAAC,IAAI,CAAC,QAAQ,EACvB,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,4CAA4C;IAC5C,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,cAAc,IAAI,CAAC,IAAI,cAAc,IAAI,CAAC,CAAC,EAAE,CAAC;QACxE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,uBAAuB;IACvB,IAAI,cAAc,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,sBAAsB;IACtB,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,SAAgC,EAChC,aAAsC,EACtC,cAAwC;IAExC,8EAA8E;IAC9E,MAAM,iBAAiB,GAAG,cAAc,CAAC,MAAM,CAC7C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,KAAK,SAAS,CAAC,YAAY,CACpD,CAAC;IAEF,MAAM,QAAQ,GAAwB,EAAE,CAAC;IACzC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IACxC,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAU,CAAC;IAE7C,oBAAoB;IACpB,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACrC,MAAM,kBAAkB,GAAG,aAAa,CAAC,IAAI,CAC3C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,IAAI,CAAC,IAAI,CAAC,YAAY,CACjD,CAAC;QACF,IAAI,CAAC,kBAAkB;YAAE,SAAS;QAElC,kBAAkB,CAAC,GAAG,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC;QAExD,QAAQ,CAAC,IAAI,CAAC;YACZ,SAAS,EAAE,kBAAkB;YAC7B,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,QAAQ;YACrB,eAAe,EAAE,QAAQ,SAAS,CAAC,IAAI,QAAQ,IAAI,CAAC,eAAe,OAAO,IAAI,CAAC,cAAc,EAAE,IAAI,IAAI,SAAS,EAAE;SACnH,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;YAC9B,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,KAAK,MAAM,QAAQ,IAAI,kBAAkB,EAAE,CAAC;QAC1C,MAAM,qBAAqB,GAAG,cAAc,CAAC,MAAM,CACjD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,KAAK,QAAQ,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC,YAAY,CACxI,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,qBAAqB,EAAE,CAAC;YACzC,MAAM,mBAAmB,GAAG,aAAa,CAAC,IAAI,CAC5C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,IAAI,CAAC,IAAI,CAAC,YAAY,CACjD,CAAC;YACF,IAAI,CAAC,mBAAmB;gBAAE,SAAS;YAEnC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC;YAEzE,QAAQ,CAAC,IAAI,CAAC;gBACZ,SAAS,EAAE,mBAAmB;gBAC9B,UAAU,EAAE,IAAI;gBAChB,WAAW,EAAE,YAAY;gBACzB,eAAe,EAAE,2BAA2B,SAAS,EAAE,IAAI,IAAI,QAAQ,EAAE;aAC1E,CAAC,CAAC;YAEH,IAAI,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;gBAC9B,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC;IAC5C,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,YAAY,CAAC,CAAC,MAAM,CAAC;IAEtF,OAAO;QACL,SAAS;QACT,QAAQ;QACR,QAAQ;QACR,oBAAoB,EAAE,aAAa,CAAC,IAAI;QACxC,OAAO,EAAE,GAAG,QAAQ,CAAC,WAAW,EAAE,KAAK,WAAW,oBAAoB,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,eAAe,gBAAgB,aAAa,CAAC,IAAI,QAAQ,aAAa,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,WAAW;KAC/M,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -7,10 +7,32 @@
  */
 export { scan, quickScan, getScanStatus, scanPromptsOnly, type ScanOptions } from './scanner.js';
 export { setup, fastSetup, fullSetup, isSetupComplete, formatSetupStatus } from './setup.js';
-export { getConfig, type NavGatorConfig } from './config.js';
+export { getConfig, SCHEMA_VERSION, type NavGatorConfig } from './config.js';
 export { loadIndex, loadAllComponents, loadAllConnections, loadGraph, storeComponent, storeConnection, deleteComponent, } from './storage.js';
 export { generateMermaidDiagram, generateComponentDiagram, generateLayerDiagram, generateSummaryDiagram, wrapInMarkdown, type DiagramOptions, } from './diagram.js';
-export type { ArchitectureComponent, ArchitectureConnection, ConnectionGraph, ArchitectureIndex, ArchitectureLayer, ComponentType, ConnectionType, ScanResult, ScanWarning, } from './types.js';
+export { computeArchitectureDiff, classifySignificance, loadTimeline, saveTimelineEntry, loadLatestSnapshot, buildCurrentSnapshot, formatTimeline, formatDiffSummary, formatDiffForSummary, } from './diff.js';
+export { registerProject, listProjects, formatProjectsList, type ProjectEntry, } from './projects.js';
+export { getGitInfo } from './git.js';
+export { computeImpact, computeSeverity } from './impact.js';
+export { wrapInEnvelope, buildExecutiveSummary } from './agent-output.js';
+export type { ArchitectureComponent, ArchitectureConnection, ConnectionGraph, ArchitectureIndex, ArchitectureLayer, ComponentType, ConnectionType, ScanResult, ScanWarning, Snapshot, SnapshotComponent, SnapshotConnection, DiffResult, DiffSignificance, DiffTrigger, TimelineEntry, Timeline, ComponentChange, ComponentModification, ConnectionChange, GitInfo, ImpactSeverity, ImpactAnalysis, AffectedComponent, AgentEnvelope, ExecutiveSummary, SummaryRisk, SummaryBlocker, SummaryAction, CompactComponent, CompactConnection, } from './types.js';
+export { toCompactComponent, toCompactConnection } from './types.js';
+export { resolveComponent, findCandidates } from './resolve.js';
+export { resolveFileConnections, looksLikeFilePath, formatFileImpact, formatFileConnections } from './file-resolve.js';
+export type { FileConnections } from './file-resolve.js';
+export { scanImports } from './scanners/connections/import-scanner.js';
+export { classifyConnection, classifyAllConnections } from './classify.js';
+export type { SemanticClassification, SemanticInfo } from './classify.js';
+export { traceDataflow, formatTraceOutput } from './trace.js';
+export type { TraceResult, TracePath, TraceStep, TraceOptions } from './trace.js';
+export { checkRules, getBuiltinRules, loadCustomRules, formatRulesOutput } from './rules.js';
+export type { ArchitectureRule, RuleViolation } from './rules.js';
+export { computeCoverage, formatCoverageOutput } from './coverage.js';
+export type { CoverageReport, CoverageGap } from './coverage.js';
+export { extractSubgraph, subgraphToMermaid } from './subgraph.js';
+export type { SubgraphOptions } from './subgraph.js';
+export { detectSandbox, isSandboxMode, getSandboxRestrictions } from './sandbox.js';
+export type { SandboxConfig } from './sandbox.js';
 export { scanPrompts, formatPromptsOutput, formatPromptDetail, convertToArchitecture, } from './scanners/prompts/index.js';
 export type { DetectedPrompt, PromptScanResult, PromptMessage, PromptVariable, PromptCategory, } from './scanners/prompts/types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACjG,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7D,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,EACd,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AAErC,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,cAAc,GACf,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -8,11 +8,41 @@
 // Main exports
 export { scan, quickScan, getScanStatus, scanPromptsOnly } from './scanner.js';
 export { setup, fastSetup, fullSetup, isSetupComplete, formatSetupStatus } from './setup.js';
-export { getConfig } from './config.js';
+export { getConfig, SCHEMA_VERSION } from './config.js';
 // Storage
 export { loadIndex, loadAllComponents, loadAllConnections, loadGraph, storeComponent, storeConnection, deleteComponent, } from './storage.js';
 // Diagram generation
 export { generateMermaidDiagram, generateComponentDiagram, generateLayerDiagram, generateSummaryDiagram, wrapInMarkdown, } from './diagram.js';
+// Diff engine
+export { computeArchitectureDiff, classifySignificance, loadTimeline, saveTimelineEntry, loadLatestSnapshot, buildCurrentSnapshot, formatTimeline, formatDiffSummary, formatDiffForSummary, } from './diff.js';
+// Project registry
+export { registerProject, listProjects, formatProjectsList, } from './projects.js';
+// Git utilities
+export { getGitInfo } from './git.js';
+// Impact analysis
+export { computeImpact, computeSeverity } from './impact.js';
+// Agent output
+export { wrapInEnvelope, buildExecutiveSummary } from './agent-output.js';
+// Compact serialization utilities
+export { toCompactComponent, toCompactConnection } from './types.js';
+// Resolve
+export { resolveComponent, findCandidates } from './resolve.js';
+// File-level resolution
+export { resolveFileConnections, looksLikeFilePath, formatFileImpact, formatFileConnections } from './file-resolve.js';
+// Import scanner
+export { scanImports } from './scanners/connections/import-scanner.js';
+// Classify
+export { classifyConnection, classifyAllConnections } from './classify.js';
+// Trace
+export { traceDataflow, formatTraceOutput } from './trace.js';
+// Rules
+export { checkRules, getBuiltinRules, loadCustomRules, formatRulesOutput } from './rules.js';
+// Coverage
+export { computeCoverage, formatCoverageOutput } from './coverage.js';
+// Subgraph
+export { extractSubgraph, subgraphToMermaid } from './subgraph.js';
+// Sandbox
+export { detectSandbox, isSandboxMode, getSandboxRestrictions } from './sandbox.js';
 // Prompt scanner exports
 export { scanPrompts, formatPromptsOutput, formatPromptDetail, convertToArchitecture, } from './scanners/prompts/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAe;AACf,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAoB,MAAM,cAAc,CAAC;AACjG,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAuB,MAAM,aAAa,CAAC;AAE7D,UAAU;AACV,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,qBAAqB;AACrB,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,GAEf,MAAM,cAAc,CAAC;AAetB,yBAAyB;AACzB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAe;AACf,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAoB,MAAM,cAAc,CAAC;AACjG,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAE,cAAc,EAAuB,MAAM,aAAa,CAAC;AAE7E,UAAU;AACV,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,qBAAqB;AACrB,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,GAEf,MAAM,cAAc,CAAC;AAEtB,cAAc;AACd,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AAEnB,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,kBAAkB,GAEnB,MAAM,eAAe,CAAC;AAEvB,gBAAgB;AAChB,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE7D,eAAe;AACf,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAqC1E,kCAAkC;AAClC,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAErE,UAAU;AACV,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEhE,wBAAwB;AACxB,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAGvH,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAEvE,WAAW;AACX,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAG3E,QAAQ;AACR,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG9D,QAAQ;AACR,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG7F,WAAW;AACX,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAGtE,WAAW;AACX,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGnE,UAAU;AACV,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGpF,yBAAyB;AACzB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC"}