@nanonets/graft 0.7.1 → 0.8.1

package/dist/graph/build.js

@@ -6,18 +6,29 @@
  *   2. Parse each with tree-sitter and emit one NodeV1 per definition.
  *   3. Write a sorted graph.json.
  * Edges (M2) and LLM summary/crux (M3) layer onto this without changing it.
+ *
+ * Step 2 is memoized per file (`extract-cache.ts`): a file whose bytes haven't
+ * moved replays its last parse instead of re-running tree-sitter, so a rebuild
+ * costs ~the files that changed. Everything after extraction still runs over the
+ * whole node set, so an incremental build's output is byte-identical to a cold
+ * one — the invariant `test/graph-incremental.test.ts` pins down.
  */
 import { readFileSync } from "node:fs";
 import { basename, dirname, relative, resolve, sep } from "node:path";
 import { walkDir } from "../ingest/fs.js";
 import { contextDirFor, ensureGitignored } from "../context/node-file.js";
 import { extractFile, languageOf } from "./extract.js";
+import { contentHash } from "../util/id.js";
+import { emptyExtractCache, readExtractCache, writeExtractCache, } from "./extract-cache.js";
+import { writeFingerprint } from "./fingerprint.js";
+import { listSourceStats } from "./source-files.js";
 import { resolveEdges } from "./resolve.js";
 import { enrichGraph } from "./enrich.js";
 import { readGraph, writeGraph, wiringPath } from "./write.js";
 import { writeCards, writeIndex, writeCovers } from "./cards.js";
 import { writeAskIndex } from "../ask/index-file.js";
 import { discoverScopes, scopeOf } from "./scopes.js";
+export { listSourceFiles } from "./source-files.js";
 /** Minimum non-file node count for a discovered sub-scope to stand on its own
  * (over-split guard 3). A scope with fewer nodes than this is folded into the
  * root scope — node counts aren't known until after the graph is assembled,
@@ -45,10 +56,6 @@ function applyMinSubstanceGuard(scopes, nodes) {
     }
     return kept;
 }
-/** The source files a graph build parses: supported languages, minus the output dir. */
-export function listSourceFiles(root, outDir) {
-    return walkDir(root).filter((f) => !f.startsWith(outDir) && languageOf(f) !== null);
-}
 /** Every Go module in the repo: each `go.mod`'s declared `module` path and the repo
  * directory it lives in (posix, `.` for the root). Found anywhere in the tree, so a
  * monorepo whose module is in a subdir (e.g. `backend/go.mod`) resolves too. Lets edge
@@ -74,36 +81,85 @@ function readGoModules(root) {
 export async function buildGraph(dir, opts = {}) {
     const root = resolve(dir);
     const outDir = contextDirFor(root, opts.contextDir);
-    const files = listSourceFiles(root, outDir);
+    const files = listSourceStats(root, outDir);
     const discoveredScopes = discoverScopes(root);
     const nodes = [];
     const rawEdges = [];
     const sources = new Map();
     const langs = new Set();
     const errors = [];
-    files.forEach((file, i) => {
-        const rel = relative(root, file);
+    // Tier-1 memo: unchanged files replay their last parse. `entries` is rebuilt
+    // from scratch each run and keyed only by files currently on disk, so deletions
+    // fall out of both the cache and the fingerprint with no separate pruning pass.
+    const priorExtract = opts.reuse === false ? emptyExtractCache() : readExtractCache(outDir);
+    const entries = {};
+    let parsed = 0;
+    let reused = 0;
+    files.forEach((f, i) => {
+        const rel = f.rel;
         opts.onProgress?.({ phase: "parse", index: i, total: files.length, file: rel });
-        const lang = languageOf(file);
+        const lang = languageOf(f.abs);
+        const cached = priorExtract.files[rel];
+        // Every file is read and hashed, every build — only the *parse* is memoized.
+        // The tempting optimization is to trust the probe's `(size, mtimeMs)` and skip
+        // the read too, but then `graft build` inherits the probe's blind spot: on a
+        // filesystem with coarse mtime granularity, a same-length edit inside the same
+        // second is invisible, so `graft check` reports drift (it always re-hashes) and
+        // the `graft build` it tells you to run refuses to repair it — forever. A stat
+        // may decide whether a *query* bothers rebuilding; it may not decide what the
+        // rebuild itself looks at. Reading is ~0.05ms/file against the ~4.6ms parse
+        // this still skips.
         let source;
         try {
-            source = readFileSync(file, "utf8");
+            source = readFileSync(f.abs, "utf8");
         }
         catch (err) {
-            errors.push(`${rel}: ${err instanceof Error ? err.message : String(err)}`);
+            const message = `${rel}: ${err instanceof Error ? err.message : String(err)}`;
+            errors.push(message);
+            // Record it anyway (with the stat we do have) so the freshness probe's
+            // fast path doesn't report this file as new on every single query.
+            entries[rel] = { size: f.size, mtimeMs: f.mtimeMs, hash: "", nodes: [], rawEdges: [], error: message };
             return;
         }
+        const hash = contentHash(source);
+        if (cached && hash === cached.hash) {
+            entries[rel] = { ...cached, size: f.size, mtimeMs: f.mtimeMs };
+            sources.set(rel, source);
+            reused++;
+            if (cached.error) {
+                errors.push(cached.error); // this file failed to parse last time too
+                return;
+            }
+            nodes.push(...cached.nodes);
+            rawEdges.push(...cached.rawEdges);
+            langs.add(lang);
+            return;
+        }
+        parsed++;
         try {
             const { nodes: fileNodes, rawEdges: fileEdges } = extractFile(rel, source, lang);
             nodes.push(...fileNodes);
             rawEdges.push(...fileEdges);
             sources.set(rel, source);
             langs.add(lang);
+            entries[rel] = { size: f.size, mtimeMs: f.mtimeMs, hash, nodes: fileNodes, rawEdges: fileEdges };
         }
         catch (err) {
-            errors.push(`${rel}: parse failed — ${err instanceof Error ? err.message : String(err)}`);
+            const message = `${rel}: parse failed — ${err instanceof Error ? err.message : String(err)}`;
+            errors.push(message);
+            entries[rel] = { size: f.size, mtimeMs: f.mtimeMs, hash, nodes: [], rawEdges: [], error: message };
         }
     });
+    // Persist the memo BEFORE enrichment, because `enrichGraph` mutates these very
+    // node objects (summary/crux/summary_state) and the cache must only ever hold
+    // pristine Tier-1 output — otherwise a replayed node would arrive pre-enriched
+    // and a cold build and an incremental build could disagree. The meaning layer
+    // has its own cache (wiring.json itself, keyed on body_hash); this one is
+    // strictly about not re-parsing.
+    writeExtractCache(outDir, {
+        ...emptyExtractCache(),
+        files: entries,
+    });
     const edges = resolveEdges(nodes, rawEdges, { goModules: readGoModules(root) });
     // graph.json is its own Tier-2 cache: fold in the prior meaning layer so an
     // unchanged body is never re-summarized (and a Tier-1-only run never wipes it).
@@ -130,9 +186,6 @@ export async function buildGraph(dir, opts = {}) {
         edges,
     };
     const graphPath = writeGraph(graph, outDir);
-    // The graph is a local, regenerable cache — make sure git ignores it. Runs on
-    // every build (cheap, idempotent), so a fresh clone's first build self-ignores.
-    ensureGitignored(root, outDir);
     // `ask`'s token/IDF sidecar — moves per-query corpus tokenization to build
     // time (~45% of query time on a 32k-node graph, profiled). Lives in the
     // cache dir; `ask` falls back to live tokenization when it's absent/stale.
@@ -150,13 +203,32 @@ export async function buildGraph(dir, opts = {}) {
     catch (err) {
         errors.push(`ask-index: ${err instanceof Error ? err.message : String(err)}`);
     }
+    // The fingerprint claims exactly one thing: "the graph on disk was built from
+    // these source bytes." Nothing about the projections below — which is why it is
+    // safe to write here, and why `graphOnly` builds (the query path, which stops
+    // right after this line) are still recorded as fresh.
+    writeFingerprint(outDir, entries);
     // Tier-2 passive surface: project the nodes into per-file markdown cards, and
     // refresh the INDEX roster. Pure projection — no LLM, no network.
-    const cardStats = writeCards(graph, outDir);
-    writeIndex(outDir, cardStats.files);
-    // Backfill concept nodes with their `covers:` symbol/file:line list (the
-    // OKF↔Wiring link). No-op when there are no concept nodes (a $0 build).
-    writeCovers(graph, outDir);
+    //
+    // Skipped entirely on the query path (`graphOnly`). Retrieval answers from
+    // wiring.json and the ask sidecar; the markdown surface is for humans and for
+    // the agent's own greps, and it is rebuilt by an explicit `graft build` — which
+    // is what the Claude Code `Stop` hook already runs at the end of a turn. Keeping
+    // it off the query path is what makes a refresh cheap, leaves the repo untouched
+    // (`ensureGitignored` writes `.gitignore`, which a read has no business doing),
+    // and means a failure here can never be triggered by a query.
+    let cardStats = { written: 0, pruned: 0, files: [] };
+    if (!opts.graphOnly) {
+        // The graph is a local, regenerable cache — make sure git ignores it. Cheap and
+        // idempotent, so a fresh clone's first build self-ignores.
+        ensureGitignored(root, outDir);
+        cardStats = writeCards(graph, outDir);
+        writeIndex(outDir, cardStats.files);
+        // Backfill concept nodes with their `covers:` symbol/file:line list (the
+        // OKF↔Wiring link). No-op when there are no concept nodes (a $0 build).
+        writeCovers(graph, outDir);
+    }
     const byKind = {};
     for (const n of nodes)
         byKind[n.kind] = (byKind[n.kind] ?? 0) + 1;
@@ -168,6 +240,8 @@ export async function buildGraph(dir, opts = {}) {
         graphPath,
         cards: cardStats.written,
         files: files.length,
+        parsed,
+        reused,
         nodes: nodes.length,
         edges: edges.length,
         byKind,

package/dist/graph/build.js.map

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

package/dist/graph/extract-cache.d.ts

@@ -0,0 +1,96 @@
+import type { RawEdge } from "./extract.js";
+import type { NodeV1 } from "./types.js";
+export interface ExtractEntry {
+    size: number;
+    mtimeMs: number;
+    /** sha256 of the file's bytes — the same value as its `kind:"file"` node's `body_hash`. */
+    hash: string;
+    nodes: NodeV1[];
+    rawEdges: RawEdge[];
+    /** Set when this file couldn't be read or parsed. The entry exists anyway so the
+     * freshness probe doesn't flag the file as new on every query; replaying it
+     * re-reports the same error and contributes no nodes, exactly as a cold build
+     * would. */
+    error?: string;
+}
+export interface ExtractCache {
+    version: number;
+    /** Identity of the extractor that produced these entries. */
+    extractor: string;
+    /** repo-relative source path → its last parse. */
+    files: Record<string, ExtractEntry>;
+}
+/**
+ * Where this graft's memo lives: `<outDir>/.cache/extract.<stamp>.json`.
+ *
+ * The stamp is in the *filename*, not just inside the file, so two grafts working
+ * on one repo keep separate memos instead of evicting each other. That is the
+ * default install, not an exotic case: `graft init` wires the MCP server as
+ * `npx -y @nanonets/graft` (which resolves the latest published version) while the
+ * Claude Code hooks run the locally installed one. The moment those two versions
+ * differ, a single shared file means the prompt hook and every MCP retrieval take
+ * turns rejecting each other's entries and cold-re-parsing the whole repo — the memo
+ * would never help anyone.
+ *
+ * Null stamp → null path → no memo at all. See {@link extractorStamp}.
+ */
+export declare function extractCachePath(outDir: string): string | null;
+/** Keep `.cache/` from growing a file per version forever: after writing, drop all
+ * but the newest `keep` files sharing a prefix. Best-effort and never fatal — this
+ * is a cache directory, and a failure here costs disk, not correctness. */
+export declare function pruneSidecars(cacheDir: string, prefix: string, keep?: number): void;
+/**
+ * Identity of the code that produces the cached parses. Both sidecars key on it,
+ * so *anything* that can change extraction output has to change this string.
+ *
+ * Content-hashed over every sibling module in this directory, plus the package
+ * version. Two earlier instincts are deliberately rejected:
+ *
+ * - **Not a timestamp.** This was `mtime:size` of `extract.js` alone, which is
+ *   wrong in both directions. Too loose: the parse of `db.count()` depends on
+ *   `bindings.ts` deciding that `db` is a `UserRepo` (that answer is stored *in*
+ *   the cached entry, as an edge's `recvType`), and fixing a binding bug leaves
+ *   `extract.js`'s emitted bytes untouched — so any build that skips rewriting
+ *   unchanged output keeps the old stamp and silently replays pre-fix edges. Too
+ *   tight: a rebuild that rewrites identical content moves the mtime and throws
+ *   away the whole memo for nothing.
+ * - **Not a hand-kept list of modules.** A list is correct exactly until someone
+ *   moves parse logic into a module nobody added to it, and the failure is silent.
+ *
+ * Hashing the directory over-invalidates a little — editing any `graph/` module
+ * costs one cold rebuild — which is no more often than a version bump already
+ * costs, and always in the safe direction. The package version is folded in so a
+ * tree-sitter grammar upgrade (which changes parse output without changing any of
+ * graft's own files) invalidates too.
+ *
+ * Measured at ~0.5ms for 21 files / 556KB, paid once per process.
+ *
+ * **Null when no identity can be established at all**, and that is deliberately not
+ * a string. It used to return `"unknown"` on failure — but `"unknown"` was then
+ * *written into the sidecars as a real identity*, and every later run compared equal
+ * to it, so any environment where stamping fails (a `pkg`/`bun-compile` single-file
+ * build, an asar-style read, a directory that can't be listed) permanently lost the
+ * ability to notice an extractor change. A sentinel that doubles as a valid value
+ * silently disables the whole mechanism. Null forces callers to decide instead, and
+ * {@link extractCachePath} decides not to have a memo.
+ */
+export declare function extractorStamp(): string | null;
+/**
+ * Hash every `ext` file in `dir`, plus `version`. Null when the directory holds no
+ * such file. Separated from {@link extractorStamp} so a test can prove the property
+ * that matters: a change to *any* module in the directory moves the stamp, not just
+ * the one the old implementation happened to watch.
+ */
+export declare function stampDir(dir: string, ext: string, version?: string): string | null;
+export declare function emptyExtractCache(): ExtractCache;
+/** The cache for `outDir`, or an empty one when it's absent, unparseable, written by
+ * a different cache version, or when this graft has no identity to key on (then
+ * every build is cold, which is slow but never wrong). The stamp is in the filename,
+ * so the `extractor` field is a second check rather than the only one. */
+export declare function readExtractCache(outDir: string): ExtractCache;
+/** Best-effort write — a full graph is already on disk by the time this runs, so an
+ * unwritable cache dir must never fail the build (it only costs the next build its
+ * reuse). Returns false when nothing was written, including the deliberate case of
+ * having no extractor identity: a parse we can't attribute must never be replayed. */
+export declare function writeExtractCache(outDir: string, cache: ExtractCache): boolean;
+//# sourceMappingURL=extract-cache.d.ts.map

package/dist/graph/extract-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-cache.d.ts","sourceRoot":"","sources":["../../src/graph/extract-cache.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAMzC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,2FAA2F;IAC3F,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB;;;gBAGY;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACrC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG9D;AAED;;2EAE2E;AAC3E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,IAAI,CAa9E;AAQD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAG9C;AAoBD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,SAAK,GAAG,MAAM,GAAG,IAAI,CAU9E;AAYD,wBAAgB,iBAAiB,IAAI,YAAY,CAEhD;AAED;;;0EAG0E;AAC1E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAS7D;AAED;;;sFAGsF;AACtF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAU9E"}

package/dist/graph/extract-cache.js

@@ -0,0 +1,199 @@
+/**
+ * Per-file memo for Tier-1 extraction — `<outDir>/.cache/extract.json`.
+ *
+ * `extractFile` is pure and file-local (`rel`, `source`, `lang` → `{nodes,
+ * rawEdges}`), which is the whole trick: an unchanged file's parse result can be
+ * replayed from disk instead of re-running tree-sitter. That turns
+ * {@link buildGraph} from "always re-parse the repo" (~4.6ms/file) into "re-parse
+ * only what moved", which is what makes a rebuild cheap enough to run *before*
+ * every query (see `graph/refresh.ts`).
+ *
+ * Everything downstream of extraction (edge resolution, enrichment, the graph
+ * write, the ask sidecar, cards) still runs over the whole merged node set, so no
+ * other invariant changes — an incremental build must produce a byte-identical
+ * `wiring.json` to a cold one.
+ *
+ * Crucially the cached nodes keep `body_text`: `writeGraph` strips it before
+ * serializing, so `wiring.json` can never be the reuse source — the ask sidecar
+ * needs a body for every node, including the ones we didn't re-parse.
+ *
+ * Lives under `.cache/` (gitignored, regenerate-anytime) next to `ask-index.json`
+ * and `summaries.json`. Two things invalidate the whole file: a bump of
+ * {@link CACHE_VERSION} for a change of on-disk shape, and a change to the
+ * extraction code itself, caught by content-hashing it — see
+ * {@link extractorStamp}. Neither asks anyone to remember to bump anything.
+ */
+import { readFileSync, readdirSync, rmSync, statSync } from "node:fs";
+import { createHash } from "node:crypto";
+import { fileURLToPath } from "node:url";
+import { dirname, extname, join } from "node:path";
+import { CACHE_DIR } from "../context/node-file.js";
+import { readJson, writeJsonAtomic } from "../util/state.js";
+/** Bump when the on-disk shape below changes. */
+const CACHE_VERSION = 1;
+const EXTRACT_CACHE_PREFIX = "extract";
+/**
+ * Where this graft's memo lives: `<outDir>/.cache/extract.<stamp>.json`.
+ *
+ * The stamp is in the *filename*, not just inside the file, so two grafts working
+ * on one repo keep separate memos instead of evicting each other. That is the
+ * default install, not an exotic case: `graft init` wires the MCP server as
+ * `npx -y @nanonets/graft` (which resolves the latest published version) while the
+ * Claude Code hooks run the locally installed one. The moment those two versions
+ * differ, a single shared file means the prompt hook and every MCP retrieval take
+ * turns rejecting each other's entries and cold-re-parsing the whole repo — the memo
+ * would never help anyone.
+ *
+ * Null stamp → null path → no memo at all. See {@link extractorStamp}.
+ */
+export function extractCachePath(outDir) {
+    const stamp = extractorStamp();
+    return stamp === null ? null : join(outDir, CACHE_DIR, `${EXTRACT_CACHE_PREFIX}.${stamp}.json`);
+}
+/** Keep `.cache/` from growing a file per version forever: after writing, drop all
+ * but the newest `keep` files sharing a prefix. Best-effort and never fatal — this
+ * is a cache directory, and a failure here costs disk, not correctness. */
+export function pruneSidecars(cacheDir, prefix, keep = 2) {
+    try {
+        const mine = readdirSync(cacheDir)
+            .filter((f) => f.startsWith(`${prefix}.`) && f.endsWith(".json"))
+            .map((f) => {
+            const full = join(cacheDir, f);
+            return { full, mtimeMs: statSync(full).mtimeMs };
+        })
+            .sort((a, b) => b.mtimeMs - a.mtimeMs);
+        for (const f of mine.slice(keep))
+            rmSync(f.full, { force: true });
+    }
+    catch {
+        /* nothing here is load-bearing */
+    }
+}
+/** Computed once per process — this can't change under a running process without
+ * the module graph itself being swapped, and a long-lived MCP server holding the
+ * identity of the code it actually loaded is the correct answer anyway.
+ * `undefined` = not computed yet; `null` = computed, and there is no identity. */
+let memoizedStamp;
+/**
+ * Identity of the code that produces the cached parses. Both sidecars key on it,
+ * so *anything* that can change extraction output has to change this string.
+ *
+ * Content-hashed over every sibling module in this directory, plus the package
+ * version. Two earlier instincts are deliberately rejected:
+ *
+ * - **Not a timestamp.** This was `mtime:size` of `extract.js` alone, which is
+ *   wrong in both directions. Too loose: the parse of `db.count()` depends on
+ *   `bindings.ts` deciding that `db` is a `UserRepo` (that answer is stored *in*
+ *   the cached entry, as an edge's `recvType`), and fixing a binding bug leaves
+ *   `extract.js`'s emitted bytes untouched — so any build that skips rewriting
+ *   unchanged output keeps the old stamp and silently replays pre-fix edges. Too
+ *   tight: a rebuild that rewrites identical content moves the mtime and throws
+ *   away the whole memo for nothing.
+ * - **Not a hand-kept list of modules.** A list is correct exactly until someone
+ *   moves parse logic into a module nobody added to it, and the failure is silent.
+ *
+ * Hashing the directory over-invalidates a little — editing any `graph/` module
+ * costs one cold rebuild — which is no more often than a version bump already
+ * costs, and always in the safe direction. The package version is folded in so a
+ * tree-sitter grammar upgrade (which changes parse output without changing any of
+ * graft's own files) invalidates too.
+ *
+ * Measured at ~0.5ms for 21 files / 556KB, paid once per process.
+ *
+ * **Null when no identity can be established at all**, and that is deliberately not
+ * a string. It used to return `"unknown"` on failure — but `"unknown"` was then
+ * *written into the sidecars as a real identity*, and every later run compared equal
+ * to it, so any environment where stamping fails (a `pkg`/`bun-compile` single-file
+ * build, an asar-style read, a directory that can't be listed) permanently lost the
+ * ability to notice an extractor change. A sentinel that doubles as a valid value
+ * silently disables the whole mechanism. Null forces callers to decide instead, and
+ * {@link extractCachePath} decides not to have a memo.
+ */
+export function extractorStamp() {
+    if (memoizedStamp === undefined)
+        memoizedStamp = computeStamp();
+    return memoizedStamp;
+}
+function computeStamp() {
+    try {
+        const self = fileURLToPath(import.meta.url);
+        // `.js` when running from `dist/`, `.ts` under tsx — take the extension from
+        // our own filename rather than guessing which layout we're in.
+        const dir = dirname(self);
+        const hashed = stampDir(dir, extname(self), packageVersion(dir) ?? "");
+        if (hashed)
+            return hashed;
+        // Couldn't read the modules (bundled into one file, say). The version alone is
+        // a weaker identity — it can't see a local edit — but it still turns over on
+        // every upgrade, which is the case that ships broken parses to users.
+        const v = packageVersion(dir);
+        return v ? `v${v}` : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Hash every `ext` file in `dir`, plus `version`. Null when the directory holds no
+ * such file. Separated from {@link extractorStamp} so a test can prove the property
+ * that matters: a change to *any* module in the directory moves the stamp, not just
+ * the one the old implementation happened to watch.
+ */
+export function stampDir(dir, ext, version = "") {
+    const files = readdirSync(dir).filter((f) => f.endsWith(ext)).sort();
+    if (!files.length)
+        return null;
+    const h = createHash("sha256");
+    h.update(version);
+    for (const f of files) {
+        h.update(f); // a rename is a change, even at identical content
+        h.update(readFileSync(join(dir, f)));
+    }
+    return h.digest("hex").slice(0, 16);
+}
+/** graft's own version, or null when it can't be read. */
+function packageVersion(graphDir) {
+    try {
+        const pkg = JSON.parse(readFileSync(join(graphDir, "..", "..", "package.json"), "utf8"));
+        return pkg.version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export function emptyExtractCache() {
+    return { version: CACHE_VERSION, extractor: extractorStamp() ?? "", files: {} };
+}
+/** The cache for `outDir`, or an empty one when it's absent, unparseable, written by
+ * a different cache version, or when this graft has no identity to key on (then
+ * every build is cold, which is slow but never wrong). The stamp is in the filename,
+ * so the `extractor` field is a second check rather than the only one. */
+export function readExtractCache(outDir) {
+    const path = extractCachePath(outDir);
+    const stamp = extractorStamp();
+    if (path === null || stamp === null)
+        return emptyExtractCache();
+    const c = readJson(path);
+    if (!c || c.version !== CACHE_VERSION || c.extractor !== stamp || typeof c.files !== "object") {
+        return emptyExtractCache();
+    }
+    return { version: c.version, extractor: c.extractor, files: c.files ?? {} };
+}
+/** Best-effort write — a full graph is already on disk by the time this runs, so an
+ * unwritable cache dir must never fail the build (it only costs the next build its
+ * reuse). Returns false when nothing was written, including the deliberate case of
+ * having no extractor identity: a parse we can't attribute must never be replayed. */
+export function writeExtractCache(outDir, cache) {
+    const path = extractCachePath(outDir);
+    if (path === null)
+        return false;
+    try {
+        writeJsonAtomic(path, cache, true);
+        pruneSidecars(join(outDir, CACHE_DIR), EXTRACT_CACHE_PREFIX);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=extract-cache.js.map

package/dist/graph/extract-cache.js.map

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

package/dist/graph/fingerprint.d.ts

@@ -0,0 +1,70 @@
+import { type ExtractEntry } from "./extract-cache.js";
+/** `[size, mtimeMs, hash]` — positional to keep the file small. */
+type Print = [number, number, string];
+export interface Fingerprint {
+    version: number;
+    /** The extractor that produced the graph these prints describe — the same stamp
+     * `extract.json` carries. Without it the two sidecars can disagree about whether
+     * the graph is current: an extractor change correctly drops every memo entry,
+     * yet the prints still match the tree byte-for-byte, so the probe would report
+     * clean and queries would keep answering from nodes the old extractor built. */
+    extractor: string;
+    files: Record<string, Print>;
+}
+/** What moved since the last build. Empty in all three arrays = nothing to do. */
+export interface Drift {
+    /** Recorded files whose bytes differ now. */
+    changed: string[];
+    /** Source files with no record — new, or never indexed. */
+    added: string[];
+    /** Recorded files that are gone from disk. */
+    removed: string[];
+}
+/** `<outDir>/.cache/fingerprint.<stamp>.json` — keyed by extractor identity for the
+ * same reason the memo is (see {@link extractCachePath}): two grafts on one repo,
+ * typically an `npx` MCP server and a locally installed hook binary, must not keep
+ * invalidating each other's prints and forcing a cold rebuild on every call. */
+export declare function fingerprintPath(outDir: string): string;
+export declare function readFingerprint(outDir: string): Fingerprint | null;
+/** Project the extraction cache's entries into the probe sidecar. Best-effort:
+ * the graph is already on disk when this runs, so a failed write costs the next
+ * probe its fast path and nothing more. */
+export declare function writeFingerprint(outDir: string, entries: Record<string, ExtractEntry>): boolean;
+/** `GRAFT_REFRESH=hash` — never trust a stat, confirm every file by its bytes. */
+export declare function alwaysHash(): boolean;
+/**
+ * May a recorded `(size, mtimeMs, hash)` be trusted for the file `f` as it is on
+ * disk now, without reading it?
+ *
+ * **The probe's rule only.** `buildGraph` deliberately does not use this: it reads
+ * and hashes every file, every time. A stat may decide whether a query bothers
+ * rebuilding; it may not decide what the rebuild itself looks at — otherwise
+ * `graft check` (which always re-hashes) can report drift that the `graft build` it
+ * recommends then refuses to repair. `GRAFT_REFRESH=hash` is the escape hatch for
+ * the probe's blind spot: a same-length edit inside one mtime tick.
+ *
+ * An empty `hash` means the last build never got the bytes — always re-read.
+ * A *parse* failure keeps its real hash, so it stays on the fast path: re-reading
+ * bytes that failed to parse yesterday just fails to parse again.
+ */
+export declare function statUnchanged(rec: {
+    size: number;
+    mtimeMs: number;
+    hash: string;
+}, f: {
+    size: number;
+    mtimeMs: number;
+}): boolean;
+export declare function isClean(d: Drift): boolean;
+export declare function driftCount(d: Drift): number;
+/**
+ * Diff the working tree against the last build's fingerprint. Returns null when
+ * there is no fingerprint to compare against (never built, or built by a version
+ * that didn't write one) — callers should treat that as "unknown", not "clean".
+ *
+ * `GRAFT_REFRESH=hash` skips the stat fast path and hashes every file, for the
+ * rare tooling that rewrites content while preserving size and mtime.
+ */
+export declare function probeDrift(root: string, outDir: string): Drift | null;
+export {};
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/graph/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../src/graph/fingerprint.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAiC,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AActF,mEAAmE;AACnE,KAAK,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEtC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB;;;;oFAIgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC9B;AAED,kFAAkF;AAClF,MAAM,WAAW,KAAK;IACpB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;gFAGgF;AAChF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAKlE;AAED;;2CAE2C;AAC3C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,OAAO,CAU/F;AAED,kFAAkF;AAClF,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACpD,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnC,OAAO,CAIT;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAEzC;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAE3C;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAqCrE"}