trail-code 0.0.0-stage → 0.28.0-semantic.3

package/dist/graph/build.js

@@ -0,0 +1,386 @@
+/**
+ * `graph` — build `.context/graph.json` from a code repository.
+ *
+ * M1 pipeline (Tier-1 only, deterministic, no LLM):
+ *   1. Walk the repo for TS/Python source files.
+ *   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, resolve } from "node:path";
+import { walkDir } from "../ingest/fs.js";
+import { contextDirFor, ensureGitignored, ensureSearchable } from "../context/node-file.js";
+import { extractFile, languageLabelOf, languageOf } from "./extract.js";
+import { extractGeneric, fallbackLangOf, genericLangOf, warmGenericGrammars } from "./generic.js";
+import { containerLangOf, extractContainer, warmContainerGrammars } from "./container.js";
+import { extractMd, isMdFile } from "./markdown.js";
+import { depthReady, missingDepthPackages, warmDepthGrammars } from "./depth-parser.js";
+import { contentHash } from "../util/id.js";
+import { relPosix } from "../util/paths.js";
+import { readSourceFile } from "../util/source.js";
+import { readFollowNestedRepos, readFollowSubmodules, readIncludeDirs } from "../util/state.js";
+import { emptyExtractCache, readExtractCache, writeExtractCache, } from "./extract-cache.js";
+import { writeFingerprint } from "./fingerprint.js";
+import { seedGraph } from "./seed.js";
+import { filterByOnlyDirs, 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";
+export function tierOf(path) {
+    const depth = languageOf(path);
+    if (depth) {
+        return depthReady(depth)
+            ? { lang: depth, container: null, generic: null, fellBack: null }
+            : { lang: null, container: null, generic: fallbackLangOf(depth), fellBack: depth };
+    }
+    const container = containerLangOf(path);
+    if (container)
+        return { lang: null, container, generic: null, fellBack: null };
+    return { lang: null, container: null, generic: genericLangOf(path), fellBack: null };
+}
+/** Load every WASM grammar these files need, before a synchronous parse loop can
+ * call `extractFile`/`extractGeneric`/`extractContainer`: the depth tier's first
+ * (a container's embedded language included), then the breadth tier's, the
+ * containers', and the stand-ins for depth languages whose grammar didn't load. */
+export async function warmGrammarsFor(paths) {
+    const list = [...paths];
+    const depth = new Set();
+    for (const path of list) {
+        const lang = languageOf(path) ?? containerLangOf(path)?.inner;
+        if (lang)
+            depth.add(lang);
+    }
+    await warmDepthGrammars(depth);
+    const generic = new Set();
+    const containers = new Set();
+    for (const path of list) {
+        const t = tierOf(path);
+        if (t.generic)
+            generic.add(t.generic.name);
+        if (t.container) {
+            containers.add(t.container.name);
+            if (!depthReady(t.container.inner))
+                generic.add(fallbackLangOf(t.container.inner).name);
+        }
+    }
+    await warmGenericGrammars(generic);
+    await warmContainerGrammars(containers);
+}
+/** 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,
+ * so this runs here rather than in `discoverScopes`. */
+const MIN_SCOPE_NODES = 5;
+/** Guard 5: merge scopes with too few non-file nodes into the root scope, then
+ * re-apply the canonical single-scope collapse (rule 6) if only root is left. */
+function applyMinSubstanceGuard(scopes, nodes) {
+    if (scopes.length <= 1)
+        return scopes;
+    const counts = new Map();
+    for (const scope of scopes)
+        counts.set(scope.prefix, 0);
+    for (const node of nodes) {
+        if (node.kind === "file")
+            continue;
+        const scope = scopeOf(node.path, scopes);
+        counts.set(scope.prefix, (counts.get(scope.prefix) ?? 0) + 1);
+    }
+    const kept = scopes.filter((s) => s.prefix === "" || (counts.get(s.prefix) ?? 0) >= MIN_SCOPE_NODES);
+    if (kept.length === 0)
+        return [{ prefix: "", label: "", markers: [] }];
+    if (kept.length === 1 && kept[0].prefix === "") {
+        return [{ prefix: "", label: "", markers: kept[0].markers }];
+    }
+    return kept;
+}
+/** 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
+ * resolution map Go import paths to in-repo files.
+ *
+ * `repoFiles` is buildGraph's single enumeration, which already carries root's
+ * persisted `--include-dir` override — so a `go.mod` living under an included
+ * dir (e.g. `build/go.mod`) is found here exactly when its `.go` files are
+ * indexed, and its intra-module imports resolve. */
+function readGoModules(root, repoFiles) {
+    const mods = [];
+    for (const f of repoFiles) {
+        if (basename(f) !== "go.mod")
+            continue;
+        try {
+            const m = readFileSync(f, "utf8").match(/^\s*module\s+(\S+)/m);
+            if (!m)
+                continue;
+            const rel = relPosix(root, dirname(f));
+            mods.push({ module: m[1], dir: rel === "" ? "." : rel });
+        }
+        catch {
+            /* unreadable go.mod — skip this module */
+        }
+    }
+    return mods;
+}
+export async function buildGraph(dir, opts = {}) {
+    const root = resolve(dir);
+    const outDir = contextDirFor(root, opts.contextDir);
+    // Enumerate once: source extraction, scope discovery, and Go module
+    // resolution must agree on the same Git-ignore-aware working-tree view —
+    // including the repo's persisted directory and submodule choices.
+    const walked = walkDir(root, readIncludeDirs(root), {
+        followSubmodules: readFollowSubmodules(root),
+        followNestedRepos: readFollowNestedRepos(root),
+    });
+    const onlyDirs = opts.onlyDirs && opts.onlyDirs.length > 0 ? new Set(opts.onlyDirs) : undefined;
+    const repoFiles = filterByOnlyDirs(walked, root, onlyDirs);
+    const files = listSourceStats(root, outDir, repoFiles);
+    const discoveredScopes = discoverScopes(root, repoFiles);
+    const nodes = [];
+    const rawEdges = [];
+    const sources = new Map();
+    /** Display labels, not grammars — `.mjs` is parsed as typescript but reported as
+     * javascript, or the banner claims a repo's JavaScript went unindexed. */
+    const langs = new Set();
+    const errors = [];
+    // In a git worktree there is nothing to reuse *yet* — `graft/` is gitignored, so
+    // git never checked it out — but the parent checkout's graph is one directory away.
+    // Copy it in before reading the priors below and this build is incremental and
+    // keeps its paid-for summaries, instead of being a cold parse of the whole repo.
+    // No-ops everywhere else, including on an explicit cold build (`reuse: false`).
+    const seed = opts.reuse === false ? { seeded: false } : seedGraph(root, { contextDir: opts.contextDir });
+    // 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;
+    // Every tier's grammars are WASM and load asynchronously, so warm the ones this
+    // repo needs ONCE here (buildGraph is async) before the synchronous parse loop
+    // below can call extractFile/extractGeneric/extractContainer. A depth grammar
+    // that can't load gets its breadth stand-in warmed instead.
+    await warmGrammarsFor(files.map((f) => f.abs));
+    /** Languages whose files went to a stand-in: grammars for the fix, labels for people. */
+    const fellBack = new Set();
+    const fellBackLabels = new Set();
+    files.forEach((f, i) => {
+        const rel = f.rel;
+        opts.onProgress?.({ phase: "parse", index: i, total: files.length, file: rel });
+        const { lang, container, generic, fellBack: standIn } = tierOf(f.abs);
+        const label = isMdFile(f.abs) ? "markdown" : languageLabelOf(f.abs) ?? container?.name ?? generic?.name ?? "unknown";
+        // A .vue file's embedded script falls back the same way its language does.
+        const inner = container && !depthReady(container.inner) ? container.inner : null;
+        if (standIn) {
+            fellBack.add(standIn);
+            fellBackLabels.add(label);
+        }
+        if (inner) {
+            fellBack.add(inner);
+            fellBackLabels.add(inner);
+        }
+        // Which stand-in parsed this file, if one did. A cached parse is replayed only
+        // when the same parser would produce it now: otherwise a file parsed by the
+        // stand-in would keep its basic parse after a reinstall restored the native
+        // grammar, for as long as its bytes didn't change.
+        const via = standIn ? generic.name : inner ? fallbackLangOf(inner).name : undefined;
+        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 = readSourceFile(f.abs);
+        }
+        catch (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;
+        }
+        if (source === null) {
+            // Unsupported encoding (UTF-16BE) — a skip, never an error: recorded with
+            // an empty entry so the freshness probe doesn't treat it as new every run.
+            entries[rel] = { size: f.size, mtimeMs: f.mtimeMs, hash: "", nodes: [], rawEdges: [] };
+            return;
+        }
+        const hash = contentHash(source);
+        if (cached && hash === cached.hash && cached.via === via) {
+            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(label);
+            return;
+        }
+        parsed++;
+        try {
+            const mdNodes = isMdFile(f.abs) ? extractMd(f.abs, rel) : null;
+            const { nodes: fileNodes, rawEdges: fileEdges } = mdNodes
+                ? { nodes: mdNodes, rawEdges: [] }
+                : lang
+                    ? extractFile(rel, source, lang)
+                    : container
+                        ? extractContainer(rel, source, container)
+                        : extractGeneric(rel, source, generic.name);
+            nodes.push(...fileNodes);
+            rawEdges.push(...fileEdges);
+            sources.set(rel, source);
+            langs.add(label);
+            entries[rel] = { size: f.size, mtimeMs: f.mtimeMs, hash, nodes: fileNodes, rawEdges: fileEdges, ...(via ? { via } : {}) };
+        }
+        catch (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, ...(via ? { via } : {}) };
+        }
+    });
+    // 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, repoFiles) });
+    // Guard 5 (minimum-substance): node counts aren't known until nodes are
+    // assembled, so the merge-tiny-scopes-into-root guard runs here.
+    const scopes = applyMinSubstanceGuard(discoveredScopes, nodes);
+    // Assemble the graph BEFORE the meaning pass, so the crux pass can checkpoint it to
+    // disk periodically (#128): crux/summary mutate node objects in place and never
+    // change the node/edge SET, so `meta` stays valid; the opt-in LSP pass below is the
+    // only thing that adds edges, and it runs before the final write.
+    const graph = {
+        meta: {
+            version: 1,
+            nodeCount: nodes.length,
+            edgeCount: edges.length,
+            languages: [...langs].sort(),
+            scopes,
+        },
+        nodes,
+        edges,
+    };
+    // 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).
+    // Read BEFORE the first checkpoint can overwrite wiring.json.
+    const prior = readGraph(wiringPath(outDir));
+    const priorById = new Map((prior?.nodes ?? []).map((n) => [n.id, n]));
+    const meaning = await enrichGraph(nodes, priorById, sources, {
+        summarizer: opts.summarizer,
+        concurrency: opts.concurrency,
+        onProgress: ({ index, total, node }) => opts.onProgress?.({ phase: "enrich", index, total, file: node }),
+        // Periodic durability flush of partial crux; the next run folds it back in by
+        // body_hash, so an interrupted --deep run never repays the crux it computed.
+        checkpoint: () => writeGraph(graph, outDir),
+    });
+    errors.push(...meaning.errors);
+    // Opt-in compiler-grade enrichment (adds lsp_resolved call edges in place).
+    // Runs on the assembled graph so callee positions map back to nodes; never
+    // touches the extraction cache (Tier-1 stays pristine, cold==incremental).
+    if (opts.lsp) {
+        const { enrichWithLsp } = await import("./lsp/enrich.js");
+        const r = await enrichWithLsp(graph, root);
+        graph.meta.edgeCount = graph.edges.length;
+        opts.onProgress?.({ phase: "enrich", index: r.added, total: r.queried, file: `lsp:${r.server ?? "none"}` });
+    }
+    const graphPath = writeGraph(graph, 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.
+    // Best-effort: wiring.json is already on disk at this point, so a sidecar
+    // write failure (e.g. an unwritable cache dir) must not abort cards/index/
+    // covers below — record it and keep going, same as other recoverable errors.
+    //
+    // MUST pass the in-memory `graph` here, never a re-read of wiringPath(outDir):
+    // `writeGraph` strips `body_text` from what it serializes (dead weight once
+    // this sidecar exists), so the nodes on disk no longer carry it — only this
+    // in-memory object, still holding what `extractFile` populated, does.
+    try {
+        writeAskIndex(outDir, graph);
+    }
+    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, opts.onlyDirs);
+    // Tier-2 passive surface: project the nodes into per-file markdown cards, and
+    // refresh the INDEX roster. Pure projection — no LLM, no network.
+    //
+    // 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);
+        // …and that gitignoring it doesn't hide the cards from search: ripgrep honours
+        // .gitignore, so without this the cards can never be grepped, which is the one
+        // way an agent was supposed to stumble onto them.
+        ensureSearchable(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;
+    const byRelation = {};
+    for (const e of edges)
+        byRelation[e.relation] = (byRelation[e.relation] ?? 0) + 1;
+    return {
+        contextDir: outDir,
+        graphPath,
+        cards: cardStats.written,
+        files: files.length,
+        parsed,
+        reused,
+        seededFrom: seed.from,
+        nodes: nodes.length,
+        edges: edges.length,
+        byKind,
+        byRelation,
+        languages: [...langs].sort(),
+        ...(fellBack.size > 0
+            ? { nativeFallback: { languages: [...fellBackLabels].sort(), packages: missingDepthPackages(fellBack) } }
+            : {}),
+        meaning,
+        errors,
+    };
+}
+//# sourceMappingURL=build.js.map

package/dist/graph/build.js.map

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

package/dist/graph/cards.d.ts

@@ -0,0 +1,46 @@
+import type { GraphV1 } from "./types.js";
+export interface CardFileInfo {
+    /** Card path relative to the context dir, e.g. "src/ai/providers.md". */
+    card: string;
+    /** Source path the card mirrors, e.g. "src/ai/providers.ts". */
+    path: string;
+    symbols: number;
+}
+export interface CardStats {
+    written: number;
+    pruned: number;
+    files: CardFileInfo[];
+}
+/**
+ * Write one wiring card per source file into `outDir`, mirroring the source tree,
+ * and prune cards whose source no longer exists. Returns what changed.
+ */
+export declare function writeCards(graph: GraphV1, outDir: string): CardStats;
+/**
+ * Write `graft/INDEX.md` — the roster an agent `cat`s to orient. Lists the concept
+ * nodes on disk and the per-file cards. Deterministic order; no timestamps.
+ */
+export declare function writeIndex(outDir: string, files: CardFileInfo[]): void;
+/** One symbol a concept node covers: its name, kind, and `path:span` pointer. */
+export interface CoverRef {
+    symbol: string;
+    kind: string;
+    /** `src/ai/providers.ts:L28-L35` — same vocabulary `graft ask` returns. */
+    at: string;
+}
+/**
+ * Backfill each concept node's frontmatter with a `covers:` list — the symbols
+ * (and their exact `file:line`) it spans, read from the wiring graph. This is the
+ * explicit OKF↔Wiring link: it doubles as grep bait (a `grep <symbol>` lands on
+ * the prose node, not just its card) and lets an agent read the span straight
+ * from the node without ever opening `wiring.json`.
+ *
+ * A surgical frontmatter patch: the generated body and every other key are
+ * preserved verbatim; only `covers` is added/replaced. Concept nodes are the
+ * top-level `.md` files that carry a `slug` (cards live in subdirs, or at the
+ * top level without a slug when they mirror a root source; INDEX.md is skipped).
+ * On a $0 structure-only build there are no concept nodes, so this is a no-op.
+ * Returns the number of nodes enriched.
+ */
+export declare function writeCovers(graph: GraphV1, outDir: string): number;
+//# sourceMappingURL=cards.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cards.d.ts","sourceRoot":"","sources":["../../src/graph/cards.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,OAAO,EAAU,MAAM,YAAY,CAAC;AAgBlD,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AA6HD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAgCpE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,IAAI,CA0CtE;AAED,iFAAiF;AACjF,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAuClE"}