@mneme-ai/core 2.24.0 → 2.26.0

package/dist/codegraph/builder.d.ts

@@ -0,0 +1,27 @@
+/**
+ * v2.25.0 — LIVING SOUL CODEGRAPH builder.
+ *
+ * Walks the repo (respecting .gitignore via the existing chunker pattern)
+ * and extracts:
+ *   - file nodes
+ *   - exported symbols (function / class / const / type / interface)
+ *   - import edges (file → file or file → external dep)
+ *   - export edges (file → symbol)
+ *
+ * Uses lightweight regex parsing — fast (~10ms per file) + zero TypeScript
+ * compiler dependency. Tradeoff: misses dynamic imports, computed names,
+ * and complex re-exports. v2.25.x can swap in a real AST parser.
+ *
+ * Why regex-not-AST: Mneme's positioning is anti-LLM-lock-in; we ship
+ * primitives that work offline + cross-platform + with zero peer deps.
+ * A regex parser ships now; AST upgrade is opt-in.
+ */
+import type { CodeGraph, BuildOptions } from "./types.js";
+/**
+ * Build a LIVING SOUL codegraph for a repo. Pure-IO (no spawn), runs
+ * sequentially. For 1000-file TS repo, expected ~2-4 seconds cold.
+ */
+export declare function buildGraph(repoRoot: string, opts?: BuildOptions): CodeGraph;
+/** Convenience: derive a stable HMAC signature for a full graph snapshot. */
+export declare function graphSignature(graph: CodeGraph): string;
+//# sourceMappingURL=builder.d.ts.map

package/dist/codegraph/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/codegraph/builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,OAAO,KAAK,EACV,SAAS,EAAsB,YAAY,EAC5C,MAAM,YAAY,CAAC;AA2IpB;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,SAAS,CA8I/E;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAQvD"}

package/dist/codegraph/builder.js

@@ -0,0 +1,309 @@
+/**
+ * v2.25.0 — LIVING SOUL CODEGRAPH builder.
+ *
+ * Walks the repo (respecting .gitignore via the existing chunker pattern)
+ * and extracts:
+ *   - file nodes
+ *   - exported symbols (function / class / const / type / interface)
+ *   - import edges (file → file or file → external dep)
+ *   - export edges (file → symbol)
+ *
+ * Uses lightweight regex parsing — fast (~10ms per file) + zero TypeScript
+ * compiler dependency. Tradeoff: misses dynamic imports, computed names,
+ * and complex re-exports. v2.25.x can swap in a real AST parser.
+ *
+ * Why regex-not-AST: Mneme's positioning is anti-LLM-lock-in; we ship
+ * primitives that work offline + cross-platform + with zero peer deps.
+ * A regex parser ships now; AST upgrade is opt-in.
+ */
+import { existsSync, readdirSync, statSync, readFileSync } from "node:fs";
+import { createHash, createHmac } from "node:crypto";
+import { join, relative, resolve, dirname, extname, sep, posix } from "node:path";
+import { canon } from "./types.js";
+import { chainEdges } from "./store.js";
+import { merkleRoot } from "./merkle.js";
+const HMAC_KEY = process.env["MNEME_CODEGRAPH_KEY"] ?? "mneme-codegraph-v1";
+const DEFAULT_EXCLUDE = new Set([
+    "node_modules", ".git", "dist", "build", ".next", ".turbo",
+    ".cache", "coverage", ".mneme", ".vscode", ".idea", "out",
+]);
+const TS_JS_EXT = new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
+/** Stable id helpers. */
+function shortHash(s) {
+    return createHash("sha256").update(s).digest("hex").slice(0, 12);
+}
+function nodeId(kind, path, symbol) {
+    const key = `${kind}|${path}|${symbol ?? ""}`;
+    return `${kind}:${shortHash(key)}`;
+}
+function edgeId(srcId, dstId, kind) {
+    return shortHash(`${srcId}>${dstId}>${kind}`);
+}
+function toPosix(p) {
+    return p.split(sep).join("/");
+}
+function* walk(dir, repoRoot, opts) {
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return;
+    }
+    for (const name of entries) {
+        if (opts.exclude.has(name))
+            continue;
+        if (name.startsWith(".") && opts.exclude.has(name))
+            continue;
+        const full = join(dir, name);
+        let stat;
+        try {
+            stat = statSync(full);
+        }
+        catch {
+            continue;
+        }
+        if (stat.isDirectory()) {
+            yield* walk(full, repoRoot, opts);
+        }
+        else if (stat.isFile()) {
+            if (stat.size > opts.maxBytes)
+                continue;
+            const rel = toPosix(relative(repoRoot, full));
+            const ext = extname(name).toLowerCase();
+            if (!TS_JS_EXT.has(ext))
+                continue;
+            yield rel;
+        }
+    }
+}
+// ─── regex parsers ─────────────────────────────────────────────────
+// import { X, Y } from "./foo"
+// import X from "./foo"
+// import * as X from "./foo"
+// import "./foo"
+const IMPORT_RE = /import(?:\s+(?:\*\s+as\s+\w+|\{[^}]*\}|\w+)(?:\s*,\s*(?:\*\s+as\s+\w+|\{[^}]*\}|\w+))*\s+from)?\s*['"]([^'"]+)['"]/g;
+const DYN_IMPORT_RE = /\bimport\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
+const REQUIRE_RE = /\brequire\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
+// Exported declarations
+const EXPORT_FN_RE = /^export\s+(?:async\s+)?function\s+(\w+)/gm;
+const EXPORT_CLASS_RE = /^export\s+(?:abstract\s+)?class\s+(\w+)/gm;
+const EXPORT_CONST_RE = /^export\s+(?:const|let|var)\s+(\w+)/gm;
+const EXPORT_TYPE_RE = /^export\s+type\s+(\w+)/gm;
+const EXPORT_INTERFACE_RE = /^export\s+interface\s+(\w+)/gm;
+const EXPORT_DEFAULT_RE = /^export\s+default\s+(?:async\s+function\s+(\w+)?|class\s+(\w+)?|(\w+))/gm;
+// re-exports: `export { X } from "./foo"`
+const EXPORT_REEXPORT_RE = /^export\s+(?:\{[^}]*\}|\*\s+(?:as\s+\w+\s+)?)\s+from\s+['"]([^'"]+)['"]/gm;
+function parseFile(content) {
+    const imports = new Set();
+    for (const re of [IMPORT_RE, DYN_IMPORT_RE, REQUIRE_RE, EXPORT_REEXPORT_RE]) {
+        re.lastIndex = 0;
+        let m;
+        while ((m = re.exec(content)) !== null) {
+            const spec = m[1];
+            if (spec)
+                imports.add(spec);
+        }
+    }
+    const exports = [];
+    const collect = (re, kind) => {
+        re.lastIndex = 0;
+        let m;
+        while ((m = re.exec(content)) !== null) {
+            const idx = m.index;
+            const line = content.slice(0, idx).split("\n").length;
+            // EXPORT_DEFAULT_RE has 3 capture groups; pick the first non-null
+            const sym = m[1] ?? m[2] ?? m[3];
+            if (sym)
+                exports.push({ kind, symbol: sym, line });
+        }
+    };
+    collect(EXPORT_FN_RE, "function");
+    collect(EXPORT_CLASS_RE, "class");
+    collect(EXPORT_CONST_RE, "constant");
+    collect(EXPORT_TYPE_RE, "type");
+    collect(EXPORT_INTERFACE_RE, "interface");
+    collect(EXPORT_DEFAULT_RE, "function"); // default export — best-effort
+    return { imports: [...imports], exports };
+}
+/** Resolve a relative import spec to a repo-relative path (best-effort). */
+function resolveImport(fromFile, spec, knownFiles) {
+    if (!spec.startsWith("."))
+        return null; // external
+    const fromDir = dirname(fromFile);
+    const baseAbs = posix.normalize(posix.join(fromDir, spec));
+    // Try common extensions
+    const candidates = [
+        baseAbs,
+        baseAbs + ".ts", baseAbs + ".tsx", baseAbs + ".js", baseAbs + ".jsx",
+        baseAbs + ".mjs", baseAbs + ".cjs",
+        posix.join(baseAbs, "index.ts"), posix.join(baseAbs, "index.tsx"),
+        posix.join(baseAbs, "index.js"), posix.join(baseAbs, "index.jsx"),
+        // .js → .ts (TypeScript NodeNext: import "./foo.js" actually means foo.ts)
+        baseAbs.endsWith(".js") ? baseAbs.replace(/\.js$/, ".ts") : "",
+        baseAbs.endsWith(".js") ? baseAbs.replace(/\.js$/, ".tsx") : "",
+        baseAbs.endsWith(".jsx") ? baseAbs.replace(/\.jsx$/, ".tsx") : "",
+    ].filter(Boolean);
+    for (const c of candidates) {
+        if (knownFiles.has(c))
+            return c;
+    }
+    return null;
+}
+/**
+ * Build a LIVING SOUL codegraph for a repo. Pure-IO (no spawn), runs
+ * sequentially. For 1000-file TS repo, expected ~2-4 seconds cold.
+ */
+export function buildGraph(repoRoot, opts = {}) {
+    const exclude = new Set(opts.exclude ?? [...DEFAULT_EXCLUDE]);
+    const maxBytes = opts.maxBytes ?? 500_000;
+    const touchedBy = opts.touchedBy ?? "mneme-daemon";
+    // Walk to discover files first (so we can resolve relative imports).
+    const files = [];
+    for (const rel of walk(repoRoot, repoRoot, { exclude, maxBytes, include: opts.include })) {
+        files.push(rel);
+    }
+    const knownFiles = new Set(files);
+    const nodes = new Map();
+    const edges = new Map();
+    const builtAt = new Date().toISOString();
+    // Detect current commit (best-effort).
+    let commit = "WORKING-TREE";
+    try {
+        const headPath = resolve(repoRoot, ".git", "HEAD");
+        if (existsSync(headPath)) {
+            const head = readFileSync(headPath, "utf8").trim();
+            if (head.startsWith("ref: ")) {
+                const ref = head.slice(5);
+                const refPath = resolve(repoRoot, ".git", ref);
+                if (existsSync(refPath))
+                    commit = readFileSync(refPath, "utf8").trim();
+            }
+            else {
+                commit = head;
+            }
+        }
+    }
+    catch { /* best-effort */ }
+    for (const rel of files) {
+        const fileNode = {
+            id: nodeId("file", rel),
+            kind: "file",
+            path: rel,
+            lang: extname(rel).slice(1),
+        };
+        nodes.set(fileNode.id, fileNode);
+        let content;
+        try {
+            content = readFileSync(resolve(repoRoot, rel), "utf8");
+        }
+        catch {
+            continue;
+        }
+        const { imports, exports } = parseFile(content);
+        // Exported symbol nodes + export edges
+        for (const ex of exports) {
+            const symNode = {
+                id: nodeId(ex.kind, rel, ex.symbol),
+                kind: ex.kind,
+                path: rel,
+                symbol: ex.symbol,
+                line: ex.line,
+                lang: extname(rel).slice(1),
+            };
+            nodes.set(symNode.id, symNode);
+            const e = {
+                id: edgeId(fileNode.id, symNode.id, "exports"),
+                src: fileNode.id,
+                dst: symNode.id,
+                kind: "exports",
+                confidence: 1,
+                lastSeen: builtAt,
+                touchedBy,
+                firstSeenCommit: commit,
+                hmac: "", // filled below by chainEdges
+            };
+            edges.set(e.id, e);
+        }
+        // Import edges
+        for (const spec of imports) {
+            const resolved = resolveImport(rel, spec, knownFiles);
+            let dstId;
+            if (resolved) {
+                dstId = nodeId("file", resolved);
+                // Resolved file node may not exist if it was a duplicate; ensure it.
+                if (!nodes.has(dstId)) {
+                    nodes.set(dstId, {
+                        id: dstId,
+                        kind: "file",
+                        path: resolved,
+                        lang: extname(resolved).slice(1),
+                    });
+                }
+            }
+            else {
+                // external dep → "external" node
+                dstId = nodeId("external", spec);
+                if (!nodes.has(dstId)) {
+                    nodes.set(dstId, {
+                        id: dstId,
+                        kind: "external",
+                        path: spec,
+                    });
+                }
+            }
+            const e = {
+                id: edgeId(fileNode.id, dstId, "imports"),
+                src: fileNode.id,
+                dst: dstId,
+                kind: "imports",
+                confidence: resolved ? 1 : 0.7,
+                lastSeen: builtAt,
+                touchedBy,
+                firstSeenCommit: commit,
+                hmac: "",
+            };
+            edges.set(e.id, e);
+        }
+    }
+    // Chain edges in canonical (id-sorted) order so the hmac sequence is
+    // deterministic across machines.
+    const sortedEdges = [...edges.values()].sort((a, b) => a.id.localeCompare(b.id));
+    chainEdges(sortedEdges);
+    // Rewrite back to the map with chained edges (preserving the order).
+    edges.clear();
+    for (const e of sortedEdges)
+        edges.set(e.id, e);
+    // Merkle root over chained edges.
+    const root = merkleRoot(sortedEdges);
+    // Stats
+    const byKind = {};
+    for (const n of nodes.values())
+        byKind[n.kind] = (byKind[n.kind] ?? 0) + 1;
+    for (const e of edges.values())
+        byKind[`edge:${e.kind}`] = (byKind[`edge:${e.kind}`] ?? 0) + 1;
+    return {
+        repoRoot,
+        commit,
+        builtAt,
+        nodes,
+        edges,
+        merkleRoot: root,
+        stats: {
+            nodes: nodes.size,
+            edges: edges.size,
+            byKind,
+        },
+    };
+}
+/** Convenience: derive a stable HMAC signature for a full graph snapshot. */
+export function graphSignature(graph) {
+    const payload = {
+        commit: graph.commit,
+        merkleRoot: graph.merkleRoot,
+        nodeCount: graph.nodes.size,
+        edgeCount: graph.edges.size,
+    };
+    return createHmac("sha256", HMAC_KEY).update(canon(payload)).digest("hex").slice(0, 32);
+}
+//# sourceMappingURL=builder.js.map

package/dist/codegraph/builder.js.map

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

package/dist/codegraph/codegraph.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=codegraph.test.d.ts.map

package/dist/codegraph/codegraph.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegraph.test.d.ts","sourceRoot":"","sources":["../../src/codegraph/codegraph.test.ts"],"names":[],"mappings":""}

package/dist/codegraph/codegraph.test.js

@@ -0,0 +1,179 @@
+// v2.25.0 — LIVING SOUL CODEGRAPH unit tests.
+import { describe, it, expect, beforeEach } from "vitest";
+import { mkdtempSync, writeFileSync, mkdirSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { buildGraph, graphSignature, verifyChain, chainEdges, merkleRoot, leafHash, __EMPTY_ROOT_SENTINEL, query, neighbours, markVaccineWarning, detectDrift, edgesTouchedBy, writeSnapshot, readSnapshot, } from "./index.js";
+function mkTinyRepo() {
+    const dir = mkdtempSync(join(tmpdir(), "mneme-codegraph-test-"));
+    // src/a.ts: imports ./b + ./external
+    // src/b.ts: exports function foo
+    // src/c.ts: imports ./b, calls foo (we won't extract call edges in v2.25.0; just imports)
+    mkdirSync(join(dir, "src"), { recursive: true });
+    writeFileSync(join(dir, "src", "a.ts"), `import { foo } from "./b.js";\nimport pkg from "some-external";\nexport function alpha() { return foo(); }\n`);
+    writeFileSync(join(dir, "src", "b.ts"), `export function foo() { return 1; }\nexport const X = 42;\nexport interface Bar { y: number }\n`);
+    writeFileSync(join(dir, "src", "c.ts"), `import { foo } from "./b.js";\nexport class Cee {}\n`);
+    return dir;
+}
+describe("codegraph — builder", () => {
+    let repo;
+    beforeEach(() => { repo = mkTinyRepo(); });
+    it("builds the graph with expected node + edge counts", () => {
+        const g = buildGraph(repo);
+        // 3 file nodes + 1 external + symbols (alpha / foo / X / Bar / Cee = 5)
+        expect(g.nodes.size).toBeGreaterThanOrEqual(8);
+        // imports: a→b, a→external, c→b = 3 ; exports: alpha + foo + X + Bar + Cee = 5
+        expect(g.edges.size).toBeGreaterThanOrEqual(8);
+        expect(g.merkleRoot).toMatch(/^[0-9a-f]{64}$/);
+        expect(g.merkleRoot).not.toBe(__EMPTY_ROOT_SENTINEL);
+    });
+    it("merkle root is deterministic across rebuilds", () => {
+        const a = buildGraph(repo);
+        const b = buildGraph(repo);
+        expect(a.merkleRoot).toBe(b.merkleRoot);
+    });
+    it("graphSignature is stable across rebuilds (same commit + edge set)", () => {
+        const a = buildGraph(repo);
+        const b = buildGraph(repo);
+        expect(graphSignature(a)).toBe(graphSignature(b));
+    });
+    it("file edges reach the right symbols", () => {
+        const g = buildGraph(repo);
+        const exportEdges = [...g.edges.values()].filter((e) => e.kind === "exports");
+        const symbols = exportEdges.map((e) => g.nodes.get(e.dst)?.symbol).filter(Boolean);
+        expect(symbols).toEqual(expect.arrayContaining(["foo", "alpha", "X", "Bar", "Cee"]));
+    });
+});
+describe("codegraph — HMAC chain", () => {
+    it("verifyChain accepts a freshly-chained edge list", () => {
+        const repo = mkTinyRepo();
+        const g = buildGraph(repo);
+        const edges = [...g.edges.values()].sort((a, b) => a.id.localeCompare(b.id));
+        const r = verifyChain(edges);
+        expect(r.ok).toBe(true);
+    });
+    it("verifyChain detects a tampered edge", () => {
+        const repo = mkTinyRepo();
+        const g = buildGraph(repo);
+        const edges = [...g.edges.values()].sort((a, b) => a.id.localeCompare(b.id));
+        // tamper: change confidence on the middle edge but DON'T re-chain
+        const mid = Math.floor(edges.length / 2);
+        edges[mid].confidence = 0.0001;
+        const r = verifyChain(edges);
+        expect(r.ok).toBe(false);
+    });
+    it("verifyChain detects an inserted edge", () => {
+        const repo = mkTinyRepo();
+        const g = buildGraph(repo);
+        const edges = [...g.edges.values()].sort((a, b) => a.id.localeCompare(b.id));
+        const fake = {
+            id: "fake",
+            src: "x",
+            dst: "y",
+            kind: "imports",
+            confidence: 1,
+            lastSeen: new Date().toISOString(),
+            hmac: "deadbeef",
+        };
+        edges.splice(1, 0, fake);
+        const r = verifyChain(edges);
+        expect(r.ok).toBe(false);
+    });
+});
+describe("codegraph — Merkle", () => {
+    it("empty edge list returns the sentinel", () => {
+        expect(merkleRoot([])).toBe(__EMPTY_ROOT_SENTINEL);
+    });
+    it("single edge yields a stable leaf hash", () => {
+        const e = {
+            id: "abc",
+            src: "x",
+            dst: "y",
+            kind: "imports",
+            confidence: 1,
+            lastSeen: "2026-05-22T00:00:00.000Z",
+            hmac: "ignored-for-leaf",
+        };
+        const leaf = leafHash(e);
+        expect(leaf).toMatch(/^[0-9a-f]{64}$/);
+        // root over 1 edge = the leaf hash itself
+        expect(merkleRoot([e])).toBe(leaf);
+    });
+    it("changing any edge field changes the root", () => {
+        const repo = mkTinyRepo();
+        const g1 = buildGraph(repo);
+        const edges1 = [...g1.edges.values()].sort((a, b) => a.id.localeCompare(b.id));
+        const edges2 = JSON.parse(JSON.stringify(edges1));
+        edges2[0].kind = "calls"; // mutate
+        chainEdges(edges2); // re-chain
+        expect(merkleRoot(edges1)).not.toBe(merkleRoot(edges2));
+    });
+});
+describe("codegraph — query", () => {
+    it("filters nodes by kind", () => {
+        const repo = mkTinyRepo();
+        const g = buildGraph(repo);
+        const r = query(g, { kind: "function" });
+        expect(r.nodes.every((n) => n.kind === "function")).toBe(true);
+        expect(r.nodes.length).toBeGreaterThan(0);
+    });
+    it("filters edges by warningsOnly", () => {
+        const repo = mkTinyRepo();
+        const g = buildGraph(repo);
+        const first = [...g.edges.values()][0];
+        markVaccineWarning(g, first.id, "hallucinated by AI X");
+        const r = query(g, { warningsOnly: true });
+        expect(r.edges.length).toBe(1);
+        expect(r.edges[0].vaccineWarning).toBe(true);
+    });
+    it("neighbours returns incoming + outgoing", () => {
+        const repo = mkTinyRepo();
+        const g = buildGraph(repo);
+        const fileB = [...g.nodes.values()].find((n) => n.kind === "file" && n.path.endsWith("b.ts"));
+        const nb = neighbours(g, fileB.id);
+        expect(nb.node?.id).toBe(fileB.id);
+        // b.ts has 2 incoming imports (from a + c) and 3 outgoing exports (foo, X, Bar)
+        expect(nb.incoming.length).toBeGreaterThanOrEqual(2);
+        expect(nb.outgoing.length).toBeGreaterThanOrEqual(3);
+    });
+});
+describe("codegraph — drift", () => {
+    it("reports zero drift on a freshly-built graph", () => {
+        const repo = mkTinyRepo();
+        const g = buildGraph(repo);
+        const d = detectDrift(g);
+        expect(d.events.length).toBe(0);
+        expect(d.brokenEdges).toBe(0);
+    });
+    it("detects drift when a file is deleted", () => {
+        const repo = mkTinyRepo();
+        const g = buildGraph(repo);
+        rmSync(join(repo, "src", "b.ts"));
+        const d = detectDrift(g);
+        expect(d.events.length).toBeGreaterThan(0);
+        expect(d.brokenEdges).toBeGreaterThan(0);
+        // The b.ts deletion breaks: a → b imports, c → b imports, and exports edges from b
+        expect(d.missingFiles).toBeGreaterThanOrEqual(1);
+    });
+    it("edgesTouchedBy returns edges that involve the changed paths", () => {
+        const repo = mkTinyRepo();
+        const g = buildGraph(repo);
+        const touched = edgesTouchedBy(g, ["src/b.ts"]);
+        // src/b.ts is imported by a + c, AND has 3 export edges → ≥ 5 edges
+        expect(touched.length).toBeGreaterThanOrEqual(5);
+    });
+});
+describe("codegraph — snapshot round-trip", () => {
+    it("writes and reads back the same graph", () => {
+        const repo = mkTinyRepo();
+        const g = buildGraph(repo);
+        writeSnapshot(repo, g);
+        const re = readSnapshot(repo);
+        expect(re).not.toBeNull();
+        expect(re.merkleRoot).toBe(g.merkleRoot);
+        expect(re.nodes.size).toBe(g.nodes.size);
+        expect(re.edges.size).toBe(g.edges.size);
+        expect(re.commit).toBe(g.commit);
+    });
+});
+//# sourceMappingURL=codegraph.test.js.map

package/dist/codegraph/codegraph.test.js.map

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

package/dist/codegraph/drift.d.ts

@@ -0,0 +1,27 @@
+/**
+ * v2.25.0 — Drift sentinel for LIVING SOUL codegraph.
+ *
+ * Compares the persisted snapshot against the current working tree and
+ * emits one DriftEvent per broken edge:
+ *   - file deleted (src or dst missing)
+ *   - file renamed (symbol moved to another path)
+ *   - edge stale (file mtime > builtAt by > N hours)
+ *
+ * Pure-IO; no daemon required. The daemon can call this on every tick
+ * + fan-out severity ≥ "high" events to the notifier so the user gets
+ * a heads-up before the AI starts editing the wrong file.
+ */
+import type { CodeGraph, DriftEvent, CodeEdge } from "./types.js";
+export interface DriftSummary {
+    events: DriftEvent[];
+    brokenEdges: number;
+    staleEdges: number;
+    missingFiles: number;
+}
+/** Scan the graph against the current working tree. */
+export declare function detectDrift(graph: CodeGraph, opts?: {
+    record?: boolean;
+}): DriftSummary;
+/** Filter edges that would BREAK if a file is renamed/deleted. */
+export declare function edgesTouchedBy(graph: CodeGraph, paths: string[]): CodeEdge[];
+//# sourceMappingURL=drift.d.ts.map

package/dist/codegraph/drift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift.d.ts","sourceRoot":"","sources":["../../src/codegraph/drift.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAKlE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,YAAY,CAkF3F;AAED,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,CAU5E"}