@flyingrobots/graft 0.6.1 → 0.7.0

package/dist/warp/dead-symbols.js

@@ -0,0 +1,127 @@
+/**
+ * Dead Symbol Detection — find symbols removed and never re-added.
+ *
+ * A symbol is "dead" when it existed at one tick but is absent at a
+ * later tick and never reappears. This identifies cleanup candidates,
+ * tracks deprecations, and measures API surface shrinkage.
+ *
+ * Uses the WARP graph's temporal observer to compare symbol snapshots
+ * across ticks. Walks commits in tick order, detects removals by
+ * diff, then filters out any symbol that reappears later.
+ */
+import { observeGraph } from "./context.js";
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/** Extract the file path from a sym node id like "sym:path/to/file.ts:symbolName". */
+function filePathFromSymId(symId) {
+    const withoutPrefix = symId.slice("sym:".length);
+    const lastColon = withoutPrefix.lastIndexOf(":");
+    if (lastColon === -1) {
+        return withoutPrefix;
+    }
+    return withoutPrefix.slice(0, lastColon);
+}
+const SYM_LENS = {
+    match: "sym:*",
+    expose: ["name", "kind", "signature", "exported"],
+};
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Find symbols that were removed and never re-added.
+ *
+ * For each commit in tick order, compares the sym-node set at the previous
+ * indexed commit tick vs this commit's tick to find removals (present before,
+ * absent after). A single Git commit can span multiple WARP Lamport ticks
+ * because lazy indexing writes one bounded patch per file.
+ */
+export async function findDeadSymbols(ctx, options) {
+    // Discover all commit nodes and read their ticks.
+    const commitLens = {
+        match: "commit:*",
+        expose: ["sha", "tick"],
+    };
+    const commitObs = await observeGraph(ctx, commitLens);
+    const commitNodeIds = await commitObs.getNodes();
+    const commits = [];
+    for (const id of commitNodeIds) {
+        const props = await commitObs.getNodeProps(id);
+        const tick = typeof props?.["tick"] === "number" ? props["tick"] : null;
+        if (tick === null)
+            continue;
+        const sha = typeof props?.["sha"] === "string"
+            ? props["sha"]
+            : id.slice("commit:".length);
+        commits.push({ id, sha, tick });
+    }
+    // Sort by tick ascending.
+    commits.sort((a, b) => a.tick - b.tick);
+    if (commits.length === 0)
+        return [];
+    // Apply maxCommits limit — scope to the last N commits.
+    const limit = options?.maxCommits;
+    const scopedCommits = limit !== undefined && limit > 0
+        ? commits.slice(-limit)
+        : commits;
+    // For each scoped commit, detect removals by diffing sym nodes at the
+    // previous indexed commit boundary vs this commit's boundary. Per-file lazy
+    // index patches inside the same Git commit are deliberately treated as one
+    // commit window.
+    // Track removed symbols with the pre-removal boundary needed to recover props.
+    // If a symbol reappears at a later tick, remove it from the map.
+    const removals = new Map();
+    for (const commit of scopedCommits) {
+        const commitIndex = commits.indexOf(commit);
+        const previousCommit = commitIndex > 0 ? commits[commitIndex - 1] : undefined;
+        const beforeTick = commitIndex > 0
+            ? previousCommit?.tick ?? 0
+            : 0;
+        const [beforeObs, afterObs] = await Promise.all([
+            observeGraph(ctx, SYM_LENS, { source: { kind: "live", ceiling: beforeTick } }),
+            observeGraph(ctx, SYM_LENS, { source: { kind: "live", ceiling: commit.tick } }),
+        ]);
+        const [beforeNodes, afterNodes] = await Promise.all([
+            beforeObs.getNodes(),
+            afterObs.getNodes(),
+        ]);
+        const afterSet = new Set(afterNodes);
+        const beforeSet = new Set(beforeNodes);
+        // Symbols present before but absent after = removed in this commit.
+        for (const symId of beforeNodes) {
+            if (!afterSet.has(symId)) {
+                removals.set(symId, { sha: commit.sha, tick: commit.tick, beforeTick });
+            }
+        }
+        // Symbols absent before but present after = re-added in this commit.
+        for (const symId of afterNodes) {
+            if (!beforeSet.has(symId) && removals.has(symId)) {
+                removals.delete(symId);
+            }
+        }
+    }
+    if (removals.size === 0)
+        return [];
+    // Read props for dead symbols from a ceiling just before removal.
+    const dead = [];
+    for (const [symId, removal] of removals) {
+        const beforeObs = await observeGraph(ctx, SYM_LENS, {
+            source: { kind: "live", ceiling: removal.beforeTick },
+        });
+        const props = await beforeObs.getNodeProps(symId);
+        const name = typeof props?.["name"] === "string" ? props["name"] : symId;
+        const kind = typeof props?.["kind"] === "string" ? props["kind"] : "unknown";
+        const exported = typeof props?.["exported"] === "boolean" ? props["exported"] : false;
+        const filePath = filePathFromSymId(symId);
+        dead.push({
+            name,
+            kind,
+            filePath,
+            exported,
+            removedInCommit: removal.sha,
+        });
+    }
+    return dead;
+}
+//# sourceMappingURL=dead-symbols.js.map

package/dist/warp/dead-symbols.js.map

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

package/dist/warp/drift-sentinel.d.ts

@@ -0,0 +1,30 @@
+import type { WarpContext } from "./context.js";
+import { type StaleDocReport } from "./stale-docs.js";
+import type { GitClient } from "../ports/git.js";
+/** Options for the drift sentinel scan. */
+export interface DriftSentinelOptions {
+    readonly cwd: string;
+    readonly git: GitClient;
+    /** Glob pattern for markdown files to check. Defaults to all tracked .md files. */
+    readonly pattern?: string;
+}
+/** Full drift report across all scanned doc files. */
+export interface DriftSentinelReport {
+    /** True if no stale or unknown symbols were found in any doc. */
+    readonly passed: boolean;
+    /** Per-file results. */
+    readonly results: readonly StaleDocReport[];
+    /** Total stale symbol count across all files. */
+    readonly totalStale: number;
+    /** Total unknown symbol count across all files. */
+    readonly totalUnknown: number;
+}
+/**
+ * Scan all markdown files in the repo for stale symbol references.
+ *
+ * For each tracked `.md` file, runs `checkStaleDocs` against the WARP
+ * graph. Returns a structured report with pass/fail verdict suitable
+ * for pre-commit hook exit codes.
+ */
+export declare function runDriftSentinel(ctx: WarpContext, options: DriftSentinelOptions): Promise<DriftSentinelReport>;
+//# sourceMappingURL=drift-sentinel.d.ts.map

package/dist/warp/drift-sentinel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-sentinel.d.ts","sourceRoot":"","sources":["../../src/warp/drift-sentinel.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,2CAA2C;AAC3C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,mFAAmF;IACnF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,sDAAsD;AACtD,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,wBAAwB;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IAC5C,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mDAAmD;IACnD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CA6D9B"}

package/dist/warp/drift-sentinel.js

@@ -0,0 +1,65 @@
+// ---------------------------------------------------------------------------
+// Drift Sentinel — scan all markdown files for stale symbol references
+// ---------------------------------------------------------------------------
+import { checkStaleDocs } from "./stale-docs.js";
+import picomatch from "picomatch";
+/**
+ * Scan all markdown files in the repo for stale symbol references.
+ *
+ * For each tracked `.md` file, runs `checkStaleDocs` against the WARP
+ * graph. Returns a structured report with pass/fail verdict suitable
+ * for pre-commit hook exit codes.
+ */
+export async function runDriftSentinel(ctx, options) {
+    const { cwd, git } = options;
+    // List all tracked markdown files
+    const lsResult = await git.run({
+        cwd,
+        args: ["ls-files", "--cached", "*.md", "**/*.md"],
+    });
+    if (lsResult.error !== undefined || lsResult.status !== 0) {
+        return { passed: true, results: [], totalStale: 0, totalUnknown: 0 };
+    }
+    const pattern = options.pattern?.trim();
+    const matchesPattern = pattern !== undefined && pattern.length > 0
+        ? picomatch(pattern)
+        : null;
+    const mdFiles = lsResult.stdout
+        .split("\n")
+        .map((f) => f.trim())
+        .filter((f) => f.length > 0 && f.endsWith(".md"))
+        .filter((f) => matchesPattern === null || matchesPattern(f));
+    if (mdFiles.length === 0) {
+        return { passed: true, results: [], totalStale: 0, totalUnknown: 0 };
+    }
+    // For each markdown file, get its last-modified commit SHA and content
+    const results = [];
+    for (const mdFile of mdFiles) {
+        // Get the commit SHA that last modified this file
+        const logResult = await git.run({
+            cwd,
+            args: ["log", "-1", "--format=%H", "--", mdFile],
+        });
+        const docCommitSha = logResult.stdout.trim();
+        if (docCommitSha.length === 0)
+            continue;
+        // Read file content
+        const showResult = await git.run({
+            cwd,
+            args: ["show", `HEAD:${mdFile}`],
+        });
+        const docContent = showResult.stdout;
+        if (docContent.length === 0)
+            continue;
+        const report = await checkStaleDocs(ctx, mdFile, docCommitSha, docContent);
+        // Only include files that have symbol references
+        if (report.staleSymbols.length > 0 || report.unknownSymbols.length > 0) {
+            results.push(report);
+        }
+    }
+    const totalStale = results.reduce((sum, r) => sum + r.staleSymbols.length, 0);
+    const totalUnknown = results.reduce((sum, r) => sum + r.unknownSymbols.length, 0);
+    const passed = totalStale === 0 && totalUnknown === 0;
+    return { passed, results, totalStale, totalUnknown };
+}
+//# sourceMappingURL=drift-sentinel.js.map

package/dist/warp/drift-sentinel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-sentinel.js","sourceRoot":"","sources":["../../src/warp/drift-sentinel.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,uEAAuE;AACvE,8EAA8E;AAG9E,OAAO,EAAE,cAAc,EAAuB,MAAM,iBAAiB,CAAC;AAEtE,OAAO,SAAS,MAAM,WAAW,CAAC;AAsBlC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAgB,EAChB,OAA6B;IAE7B,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IAE7B,kCAAkC;IAClC,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC;QAC7B,GAAG;QACH,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC;KAClD,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1D,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IACvE,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IACxC,MAAM,cAAc,GAAG,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAChE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC;QACpB,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM;SAC5B,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SAChD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,KAAK,IAAI,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IACvE,CAAC;IAED,uEAAuE;IACvE,MAAM,OAAO,GAAqB,EAAE,CAAC;IAErC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,kDAAkD;QAClD,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC;YAC9B,GAAG;YACH,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC;SACjD,CAAC,CAAC;QACH,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC7C,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAExC,oBAAoB;QACpB,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC;YAC/B,GAAG;YACH,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,MAAM,EAAE,CAAC;SACjC,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC;QACrC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEtC,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;QAE3E,iDAAiD;QACjD,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9E,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAClF,MAAM,MAAM,GAAG,UAAU,KAAK,CAAC,IAAI,YAAY,KAAK,CAAC,CAAC;IAEtD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;AACvD,CAAC"}

package/dist/warp/index-head.d.ts

@@ -0,0 +1,32 @@
+import type { GitClient } from "../ports/git.js";
+import type { PathOps } from "../ports/paths.js";
+import type { WarpContext } from "./context.js";
+export declare const DEFAULT_INDEX_MAX_FILES_PER_CALL = 64;
+export declare const DEFAULT_INDEX_MAX_PATCH_JSON_BYTES: number;
+export interface IndexHeadOptions {
+    readonly cwd: string;
+    readonly git: GitClient;
+    readonly pathOps: PathOps;
+    readonly ctx: WarpContext;
+    readonly paths?: readonly string[] | undefined;
+    readonly maxFilesPerCall?: number | undefined;
+    readonly maxPatchJsonBytes?: number | undefined;
+}
+export interface IndexHeadResult {
+    readonly ok: true;
+    readonly filesIndexed: number;
+    readonly nodesEmitted: number;
+}
+/**
+ * Index the current HEAD by writing one bounded patch per file.
+ *
+ * Full tree-sitter syntax is attached as file-node blob content. The graph
+ * itself only stores compact query facts: files, symbols, import/reference
+ * anchors, directories, and commit-to-symbol touch edges.
+ *
+ * Emits a `commit:{sha}` node with edges to sym nodes labelled
+ * "adds", "changes", or "removes" so structural queries can detect
+ * what changed between ticks.
+ */
+export declare function indexHead(opts: IndexHeadOptions): Promise<IndexHeadResult>;
+//# sourceMappingURL=index-head.d.ts.map

package/dist/warp/index-head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-head.d.ts","sourceRoot":"","sources":["../../src/warp/index-head.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAWhD,eAAO,MAAM,gCAAgC,KAAK,CAAC;AACnD,eAAO,MAAM,kCAAkC,QAAkB,CAAC;AA6ElE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjD;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AASD;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAyChF"}

package/dist/warp/index-head.js

@@ -0,0 +1,245 @@
+// ---------------------------------------------------------------------------
+// Index HEAD — emit compact structural facts into WARP.
+//
+// Also emits a commit node and commit→sym edges (adds/changes/removes)
+// so the structural query layer can detect what changed between ticks.
+// ---------------------------------------------------------------------------
+import { Buffer } from "node:buffer";
+import { patchGraph, observeGraph, materializeGraph } from "./context.js";
+import { detectLang } from "../parser/lang.js";
+import { parseStructuredTree } from "../parser/runtime.js";
+import { extractOutlineForFile } from "../parser/outline.js";
+import { attachAstSnapshot, emitAstNodes } from "./ast-emitter.js";
+import { resolveImportEdges } from "./ast-import-resolver.js";
+import { getCommitMeta } from "./commit-meta.js";
+export const DEFAULT_INDEX_MAX_FILES_PER_CALL = 64;
+export const DEFAULT_INDEX_MAX_PATCH_JSON_BYTES = 2 * 1024 * 1024;
+// ---------------------------------------------------------------------------
+// Sym-node emission from outline entries (richer than the AST-only walker:
+// includes signatures for change detection).
+// ---------------------------------------------------------------------------
+function emitOutlineSyms(patch, filePath, entries, jumpLookup, parentPath = "") {
+    const emitted = new Set();
+    const fileId = `file:${filePath}`;
+    for (const entry of entries) {
+        const symbolPath = parentPath.length > 0 ? `${parentPath}.${entry.name}` : entry.name;
+        const symId = `sym:${filePath}:${symbolPath}`;
+        emitted.add(symId);
+        patch.addNode(symId);
+        patch.setProperty(symId, "name", entry.name);
+        patch.setProperty(symId, "kind", entry.kind);
+        patch.setProperty(symId, "exported", entry.exported);
+        patch.setProperty(symId, "filePath", filePath);
+        if (entry.signature !== undefined) {
+            patch.setProperty(symId, "signature", entry.signature);
+        }
+        const jump = jumpLookup.get(entry.name);
+        if (jump !== undefined) {
+            patch.setProperty(symId, "startLine", jump.start);
+            patch.setProperty(symId, "endLine", jump.end);
+        }
+        patch.addEdge(fileId, symId, "contains");
+        if (entry.children !== undefined && entry.children.length > 0) {
+            for (const childId of emitOutlineSyms(patch, filePath, entry.children, jumpLookup, symbolPath)) {
+                emitted.add(childId);
+            }
+        }
+    }
+    return emitted;
+}
+// ---------------------------------------------------------------------------
+// Directory chain emission (inlined from indexer-graph.ts to avoid dep on
+// the legacy indexer module).
+// ---------------------------------------------------------------------------
+function emitDirectoryChain(patch, filePath) {
+    const parts = filePath.split("/");
+    if (parts.length <= 1)
+        return;
+    let current = "";
+    for (let index = 0; index < parts.length - 1; index++) {
+        const parent = current;
+        const part = parts[index] ?? "";
+        current = current.length > 0 ? `${current}/${part}` : part;
+        const dirId = `dir:${current}`;
+        patch.addNode(dirId);
+        patch.setProperty(dirId, "path", current);
+        if (parent.length > 0) {
+            patch.addEdge(`dir:${parent}`, dirId, "contains");
+        }
+    }
+    patch.addEdge(`dir:${current}`, `file:${filePath}`, "contains");
+}
+/**
+ * Index the current HEAD by writing one bounded patch per file.
+ *
+ * Full tree-sitter syntax is attached as file-node blob content. The graph
+ * itself only stores compact query facts: files, symbols, import/reference
+ * anchors, directories, and commit-to-symbol touch edges.
+ *
+ * Emits a `commit:{sha}` node with edges to sym nodes labelled
+ * "adds", "changes", or "removes" so structural queries can detect
+ * what changed between ticks.
+ */
+export async function indexHead(opts) {
+    const { cwd, git, pathOps, ctx } = opts;
+    const maxFilesPerCall = opts.maxFilesPerCall ?? DEFAULT_INDEX_MAX_FILES_PER_CALL;
+    const maxPatchJsonBytes = opts.maxPatchJsonBytes ?? DEFAULT_INDEX_MAX_PATCH_JSON_BYTES;
+    const headResult = await git.run({ args: ["rev-parse", "HEAD"], cwd });
+    if (headResult.status !== 0) {
+        throw new Error(`git rev-parse HEAD failed: ${headResult.stderr}`);
+    }
+    const headSha = headResult.stdout.trim();
+    const commitMeta = await getCommitMeta(git, headSha, cwd);
+    const allFiles = await listTrackedFiles(cwd, git);
+    const knownFiles = new Set(allFiles);
+    const parseableFiles = selectParseableFiles(allFiles, opts.paths);
+    if (parseableFiles.length > maxFilesPerCall) {
+        throw new Error(`indexHead refused to index ${String(parseableFiles.length)} files in one call. ` +
+            `Lazy indexing policy allows at most ${String(maxFilesPerCall)} files; ` +
+            `pass explicit paths or index on read.`);
+    }
+    let filesIndexed = 0;
+    for (const filePath of parseableFiles) {
+        const indexed = await indexHeadFile({
+            cwd,
+            git,
+            pathOps,
+            ctx,
+            headSha,
+            commitMeta,
+            knownFiles,
+            filePath,
+            maxPatchJsonBytes,
+        });
+        if (indexed)
+            filesIndexed++;
+    }
+    return { ok: true, filesIndexed, nodesEmitted: filesIndexed };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function collectSymIds(target, filePath, entries, parentPath = "") {
+    for (const entry of entries) {
+        const symbolPath = parentPath.length > 0 ? `${parentPath}.${entry.name}` : entry.name;
+        target.set(`sym:${filePath}:${symbolPath}`, entry.signature);
+        if (entry.children !== undefined && entry.children.length > 0) {
+            collectSymIds(target, filePath, entry.children, symbolPath);
+        }
+    }
+}
+async function listTrackedFiles(cwd, git) {
+    const result = await git.run({ args: ["ls-files"], cwd });
+    if (result.status !== 0) {
+        throw new Error(`git ls-files failed: ${result.stderr}`);
+    }
+    return result.stdout.trim().split("\n").filter((filePath) => filePath.length > 0);
+}
+function selectParseableFiles(allFiles, requestedPaths) {
+    const tracked = new Set(allFiles);
+    const candidates = requestedPaths !== undefined && requestedPaths.length > 0
+        ? requestedPaths.map((filePath) => filePath.trim()).filter((filePath) => filePath.length > 0 && tracked.has(filePath))
+        : allFiles;
+    return candidates.filter((filePath) => detectLang(filePath) !== null);
+}
+async function readPriorSymsForFile(ctx, filePath) {
+    const priorSyms = new Map();
+    const priorObs = await observeGraph(ctx, { match: `sym:${filePath}:*`, expose: ["signature"] });
+    const priorNodes = await priorObs.getNodes();
+    for (const nodeId of priorNodes) {
+        const props = await priorObs.getNodeProps(nodeId);
+        const sig = typeof props?.["signature"] === "string" ? props["signature"] : undefined;
+        priorSyms.set(nodeId, sig);
+    }
+    return priorSyms;
+}
+async function readPriorAstAnchorsForFile(ctx, filePath) {
+    const obs = await observeGraph(ctx, { match: `ast:${filePath}:*`, expose: [] });
+    return obs.getNodes();
+}
+function patchJsonByteLength(patch) {
+    return Buffer.byteLength(JSON.stringify(patch.build()), "utf8");
+}
+function assertPatchWithinBudget(patch, filePath, maxPatchJsonBytes) {
+    const bytes = patchJsonByteLength(patch);
+    if (bytes > maxPatchJsonBytes) {
+        throw new Error(`indexHead refused to write ${filePath}: estimated patch payload ${String(bytes)} bytes ` +
+            `exceeds ${String(maxPatchJsonBytes)} bytes. Index smaller slices or attach bulky data as blobs.`);
+    }
+}
+async function indexHeadFile(input) {
+    const { cwd, git, pathOps, ctx, headSha, commitMeta, knownFiles, filePath, maxPatchJsonBytes } = input;
+    const lang = detectLang(filePath);
+    if (lang === null)
+        return false;
+    const contentResult = await git.run({ args: ["show", `HEAD:${filePath}`], cwd });
+    if (contentResult.status !== 0)
+        return false;
+    const tree = parseStructuredTree(lang, contentResult.stdout);
+    try {
+        const outlineResult = extractOutlineForFile(filePath, contentResult.stdout);
+        const outline = outlineResult?.entries ?? [];
+        const jumpLookup = new Map();
+        for (const jt of outlineResult?.jumpTable ?? []) {
+            jumpLookup.set(jt.symbol, { start: jt.start, end: jt.end });
+        }
+        const currentSyms = new Map();
+        collectSymIds(currentSyms, filePath, outline);
+        let priorSyms = new Map();
+        let priorAstAnchors = [];
+        try {
+            await materializeGraph(ctx);
+            priorSyms = await readPriorSymsForFile(ctx, filePath);
+            priorAstAnchors = await readPriorAstAnchorsForFile(ctx, filePath);
+        }
+        catch {
+            // No prior state: first lazy index writes adds only.
+        }
+        await patchGraph(ctx, async (patch) => {
+            const tick = patch.build().lamport;
+            const commitId = `commit:${headSha}`;
+            const fileId = `file:${filePath}`;
+            patch.addNode(commitId);
+            patch.setProperty(commitId, "sha", headSha);
+            patch.setProperty(commitId, "tick", tick);
+            patch.setProperty(commitId, "message", commitMeta.message);
+            patch.setProperty(commitId, "author", commitMeta.author);
+            patch.setProperty(commitId, "email", commitMeta.email);
+            patch.setProperty(commitId, "date", commitMeta.timestamp);
+            patch.setProperty(commitId, "timestamp", commitMeta.timestamp);
+            patch.addNode(fileId);
+            patch.setProperty(fileId, "path", filePath);
+            patch.setProperty(fileId, "lang", lang);
+            patch.setProperty(fileId, "indexedCommit", headSha);
+            patch.addEdge(commitId, fileId, "touches");
+            emitDirectoryChain(patch, filePath);
+            for (const anchorId of priorAstAnchors) {
+                patch.removeNode(anchorId);
+            }
+            emitOutlineSyms(patch, filePath, outline, jumpLookup);
+            emitAstNodes(patch, filePath, tree.root);
+            resolveImportEdges(patch, filePath, tree.root, pathOps, knownFiles);
+            await attachAstSnapshot(patch, filePath, tree.root);
+            for (const [symId, sig] of currentSyms) {
+                if (!priorSyms.has(symId)) {
+                    patch.addEdge(commitId, symId, "adds");
+                }
+                else if (priorSyms.get(symId) !== sig) {
+                    patch.addEdge(commitId, symId, "changes");
+                }
+            }
+            for (const symId of priorSyms.keys()) {
+                if (!currentSyms.has(symId)) {
+                    patch.addEdge(commitId, symId, "removes");
+                    patch.removeNode(symId);
+                }
+            }
+            assertPatchWithinBudget(patch, filePath, maxPatchJsonBytes);
+        });
+        return true;
+    }
+    finally {
+        tree.delete();
+    }
+}
+//# sourceMappingURL=index-head.js.map

package/dist/warp/index-head.js.map

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

package/dist/warp/observers.d.ts

@@ -5,12 +5,12 @@
  * walks the graph directly, maintains shadow state, or implements
  * traversal algorithms.
  *
- * Each function returns an observer with a focused lens. The lens
- * determines the aperture — what the observer can see.
+ * Each function returns a lens or an observer with a focused lens.
+ * The lens determines the aperture — what the observer can see.
  */
-import type { WarpHandle, WarpObserver, WarpObserverLens } from "../ports/warp.js";
-/** Lens config for creating focused observers. */
-export type Lens = WarpObserverLens;
+import type { Lens, Observer } from "@git-stunts/git-warp";
+import type { WarpContext } from "./context.js";
+export type { Lens };
 /**
  * Observe all symbols in a specific file.
  * Aperture: sym:<path>:*
@@ -50,5 +50,5 @@ export declare function commitsLens(): Lens;
  * Create an observer on the current frontier with a given lens.
  * Observers are static snapshots — create a new one after writes.
  */
-export declare function observe(warp: WarpHandle, lens: Lens): Promise<WarpObserver>;
+export declare function observe(ctx: WarpContext, lens: Lens): Promise<Observer>;
 //# sourceMappingURL=observers.d.ts.map

package/dist/warp/observers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observers.d.ts","sourceRoot":"","sources":["../../src/warp/observers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEnF,kDAAkD;AAClD,MAAM,MAAM,IAAI,GAAG,gBAAgB,CAAC;AAEpC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAKtD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAKrC;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAKnC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAKzD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAKnD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAKxD;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAKlC;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAE3E"}
+{"version":3,"file":"observers.d.ts","sourceRoot":"","sources":["../../src/warp/observers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,YAAY,EAAE,IAAI,EAAE,CAAC;AAErB;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAKtD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAKrC;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAKnC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAKzD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAKnD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAKxD;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAKlC;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEvE"}

package/dist/warp/observers.js

@@ -5,9 +5,10 @@
  * walks the graph directly, maintains shadow state, or implements
  * traversal algorithms.
  *
- * Each function returns an observer with a focused lens. The lens
- * determines the aperture — what the observer can see.
+ * Each function returns a lens or an observer with a focused lens.
+ * The lens determines the aperture — what the observer can see.
  */
+import { observeGraph } from "./context.js";
 /**
  * Observe all symbols in a specific file.
  * Aperture: sym:<path>:*
@@ -82,7 +83,7 @@ export function commitsLens() {
  * Create an observer on the current frontier with a given lens.
  * Observers are static snapshots — create a new one after writes.
  */
-export function observe(warp, lens) {
-    return warp.observer(lens);
+export function observe(ctx, lens) {
+    return observeGraph(ctx, lens);
 }
 //# sourceMappingURL=observers.js.map

package/dist/warp/observers.js.map

@@ -1 +1 @@
-{"version":3,"file":"observers.js","sourceRoot":"","sources":["../../src/warp/observers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO;QACL,KAAK,EAAE,OAAO,QAAQ,IAAI;QAC1B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,CAAC;KACtG,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,CAAC;KACtG,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,OAAO;QACL,KAAK,EAAE,SAAS,UAAU,EAAE;QAC5B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,CAAC;KACtG,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO;QACL,KAAK,EAAE,OAAO,OAAO,GAAG;QACxB,MAAM,EAAE,CAAC,MAAM,CAAC;KACjB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,OAAO;QACL,KAAK,EAAE,QAAQ,OAAO,IAAI;QAC1B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC;KACnE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAgB,EAAE,IAAU;IAClD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"observers.js","sourceRoot":"","sources":["../../src/warp/observers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO;QACL,KAAK,EAAE,OAAO,QAAQ,IAAI;QAC1B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,CAAC;KACtG,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,CAAC;KACtG,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,OAAO;QACL,KAAK,EAAE,SAAS,UAAU,EAAE;QAC5B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,CAAC;KACtG,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO;QACL,KAAK,EAAE,OAAO,OAAO,GAAG;QACxB,MAAM,EAAE,CAAC,MAAM,CAAC;KACjB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,OAAO;QACL,KAAK,EAAE,QAAQ,OAAO,IAAI;QAC1B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC;KACnE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,GAAgB,EAAE,IAAU;IAClD,OAAO,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/dist/warp/open.d.ts

@@ -2,14 +2,15 @@
  * WARP graph initialization — opens the graft-ast graph backed by
  * the repo's own .git directory.
  *
- * Single entry point. Returns a WARP port handle ready for patch
- * writes and observer reads.
+ * Sole construction adapter. After this, git-warp types flow directly.
  */
-import type { WarpHandle } from "../ports/warp.js";
+import WarpApp from "@git-stunts/git-warp";
 export declare const GRAPH_NAME = "graft-ast";
+export declare const DEFAULT_WARP_CHECKPOINT_EVERY = 128;
 export interface OpenWarpOptions {
     readonly cwd: string;
     readonly writerId?: string;
+    readonly checkpointEvery?: number;
 }
-export declare function openWarp(options: OpenWarpOptions): Promise<WarpHandle>;
+export declare function openWarp(options: OpenWarpOptions): Promise<WarpApp>;
 //# sourceMappingURL=open.d.ts.map

package/dist/warp/open.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../src/warp/open.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,UAAU,EAMX,MAAM,kBAAkB,CAAC;AAG1B,eAAO,MAAM,UAAU,cAAc,CAAC;AAEtC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAsDD,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAa5E"}
+{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../src/warp/open.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,OAA4B,MAAM,sBAAsB,CAAC;AAIhE,eAAO,MAAM,UAAU,cAAc,CAAC;AACtC,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAqCjD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAWzE"}