@flyingrobots/graft 0.6.0 → 0.7.0

package/dist/warp/symbol-timeline.js

@@ -0,0 +1,127 @@
+/**
+ * WARP Symbol Timeline — ordered history of a symbol across commits.
+ *
+ * Reads WARP provenance for symbol ids and reconstructs versions from
+ * patches that touched the symbol. Callers that need removed-symbol
+ * history must pass filePath so the symbol id is explicit.
+ */
+import { observeGraph } from "./context.js";
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function filePathFromSymId(symId) {
+    const withoutPrefix = symId.slice("sym:".length);
+    const lastColon = withoutPrefix.lastIndexOf(":");
+    if (lastColon === -1) {
+        return withoutPrefix;
+    }
+    return withoutPrefix.slice(0, lastColon);
+}
+const EDGE_CHANGE_KIND = new Map([
+    ["adds", "added"],
+    ["changes", "changed"],
+    ["removes", "removed"],
+]);
+function symIdFor(filePath, symbolName) {
+    return `sym:${filePath}:${symbolName}`;
+}
+function patchOps(patch) {
+    return Array.isArray(patch.ops) ? patch.ops : [];
+}
+function touchFromPatch(symId, patch) {
+    const ops = patchOps(patch);
+    for (const op of ops) {
+        if (op.type !== "EdgeAdd")
+            continue;
+        if (typeof op.from !== "string" || !op.from.startsWith("commit:"))
+            continue;
+        if (op.to !== symId || typeof op.label !== "string")
+            continue;
+        const changeKind = EDGE_CHANGE_KIND.get(op.label);
+        if (changeKind === undefined)
+            continue;
+        return {
+            sha: op.from.slice("commit:".length),
+            tick: patch.lamport,
+            changeKind,
+        };
+    }
+    return null;
+}
+async function readSymbolPropsAtTick(ctx, symId, tick) {
+    const worldline = await ctx.app.worldline().seek({
+        source: { kind: "live", ceiling: tick },
+    });
+    return worldline.getNodeProps(symId);
+}
+async function versionFromPatch(ctx, symId, patch) {
+    const touch = touchFromPatch(symId, patch);
+    if (touch === null) {
+        return null;
+    }
+    const props = touch.changeKind === "removed"
+        ? null
+        : await readSymbolPropsAtTick(ctx, symId, touch.tick);
+    const signature = props?.["signature"];
+    const startLine = props?.["startLine"];
+    const endLine = props?.["endLine"];
+    return {
+        sha: touch.sha,
+        tick: touch.tick,
+        changeKind: touch.changeKind,
+        present: touch.changeKind !== "removed",
+        signature: typeof signature === "string" ? signature : undefined,
+        startLine: typeof startLine === "number" ? startLine : undefined,
+        endLine: typeof endLine === "number" ? endLine : undefined,
+        filePath: filePathFromSymId(symId),
+    };
+}
+async function liveSymbolIds(ctx, symbolName, filePath) {
+    if (filePath !== undefined) {
+        return [symIdFor(filePath, symbolName)];
+    }
+    const obs = await observeGraph(ctx, { match: `sym:*:${symbolName}`, expose: [] });
+    return obs.getNodes();
+}
+async function readTimelineVersions(ctx, symbolName, filePath) {
+    const core = ctx.app.core();
+    const symIds = await liveSymbolIds(ctx, symbolName, filePath);
+    if (symIds.length === 0)
+        return [];
+    const versions = [];
+    const seen = new Set();
+    for (const symId of symIds) {
+        const patchShas = await core.patchesFor(symId);
+        const patches = await Promise.all(patchShas.map(async (sha) => core.loadPatchBySha(sha)));
+        for (const patch of patches) {
+            const version = await versionFromPatch(ctx, symId, patch);
+            if (version === null)
+                continue;
+            const key = `${String(version.tick)}:${version.sha}:${symId}:${version.changeKind}`;
+            if (seen.has(key))
+                continue;
+            versions.push(version);
+            seen.add(key);
+        }
+    }
+    versions.sort((a, b) => a.tick - b.tick || a.filePath.localeCompare(b.filePath));
+    return versions;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Build an ordered timeline of every version of a symbol across commits.
+ *
+ * For each commit that touched the symbol (adds, changes, removes), the
+ * returned array includes the commit SHA, tick, change kind, presence
+ * flag, signature, and line range. Entries are sorted by tick ascending.
+ */
+export async function symbolTimeline(ctx, symbolName, filePath) {
+    return {
+        symbol: symbolName,
+        filePath,
+        versions: await readTimelineVersions(ctx, symbolName, filePath),
+    };
+}
+//# sourceMappingURL=symbol-timeline.js.map

package/dist/warp/symbol-timeline.js.map

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

package/dist/warp/traverse-hydrate.d.ts

@@ -0,0 +1,23 @@
+import type { Observer } from "@git-stunts/git-warp";
+/** A hydrated node with its ID and properties. */
+export interface HydratedNode {
+    readonly id: string;
+    readonly props: Readonly<Record<string, unknown>>;
+}
+/** Traversal options matching observer.traverse.bfs. */
+export interface TraverseOptions {
+    readonly dir: "out" | "in";
+    readonly labelFilter?: string;
+    readonly maxDepth?: number;
+}
+/**
+ * BFS traversal followed by batch property hydration.
+ *
+ * Combines two common operations into one call:
+ * 1. `observer.traverse.bfs()` for topology discovery
+ * 2. `observer.query().match(ids).select(["id", "props"]).run()` for batch hydration
+ *
+ * Returns hydrated nodes with both IDs and properties.
+ */
+export declare function traverseAndHydrate(observer: Observer, startId: string, options: TraverseOptions): Promise<readonly HydratedNode[]>;
+//# sourceMappingURL=traverse-hydrate.d.ts.map

package/dist/warp/traverse-hydrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverse-hydrate.d.ts","sourceRoot":"","sources":["../../src/warp/traverse-hydrate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,sBAAsB,CAAC;AAEpE,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACnD;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CA4BlC"}

package/dist/warp/traverse-hydrate.js

@@ -0,0 +1,39 @@
+// ---------------------------------------------------------------------------
+// Traverse + Query Batch Hydration Helper
+// ---------------------------------------------------------------------------
+/**
+ * BFS traversal followed by batch property hydration.
+ *
+ * Combines two common operations into one call:
+ * 1. `observer.traverse.bfs()` for topology discovery
+ * 2. `observer.query().match(ids).select(["id", "props"]).run()` for batch hydration
+ *
+ * Returns hydrated nodes with both IDs and properties.
+ */
+export async function traverseAndHydrate(observer, startId, options) {
+    let ids;
+    try {
+        const bfsOptions = { dir: options.dir };
+        if (options.labelFilter !== undefined)
+            bfsOptions.labelFilter = options.labelFilter;
+        if (options.maxDepth !== undefined)
+            bfsOptions.maxDepth = options.maxDepth;
+        ids = await observer.traverse.bfs(startId, bfsOptions);
+    }
+    catch {
+        return [];
+    }
+    if (ids.length === 0)
+        return [];
+    const result = await observer.query()
+        .match(ids)
+        .select(["id", "props"])
+        .run();
+    return result.nodes
+        .filter((n) => n.id !== undefined)
+        .map((n) => ({
+        id: n.id,
+        props: n.props ?? {},
+    }));
+}
+//# sourceMappingURL=traverse-hydrate.js.map

package/dist/warp/traverse-hydrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverse-hydrate.js","sourceRoot":"","sources":["../../src/warp/traverse-hydrate.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,0CAA0C;AAC1C,8EAA8E;AAiB9E;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAkB,EAClB,OAAe,EACf,OAAwB;IAExB,IAAI,GAAa,CAAC;IAClB,IAAI,CAAC;QACH,MAAM,UAAU,GAIZ,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;YAAE,UAAU,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACpF,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;YAAE,UAAU,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAC3E,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE;SAClC,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;SACvB,GAAG,EAAmB,CAAC;IAE1B,OAAO,MAAM,CAAC,KAAK;SAChB,MAAM,CAAC,CAAC,CAAC,EAAwD,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC;SACvF,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;KACrB,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/warp/warp-reference-count.d.ts

@@ -0,0 +1,19 @@
+import type { WarpContext } from "./context.js";
+export interface ReferenceCountResult {
+    readonly symbol: string;
+    readonly referenceCount: number;
+    readonly referencingFiles: readonly string[];
+}
+/**
+ * Count how many files reference a symbol via WARP graph edges.
+ *
+ * Uses `referencesForSymbol` which traverses incoming `references`
+ * edges from import/export specifier AST nodes to the target sym node.
+ * Uses actual imports, not text matches, and does not spawn subprocesses.
+ *
+ * @param ctx - WARP context
+ * @param symbolName - The symbol to count references for
+ * @param filePath - The file where the symbol is defined (required for sym node ID)
+ */
+export declare function countSymbolReferencesFromGraph(ctx: WarpContext, symbolName: string, filePath?: string): Promise<ReferenceCountResult>;
+//# sourceMappingURL=warp-reference-count.d.ts.map

package/dist/warp/warp-reference-count.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warp-reference-count.d.ts","sourceRoot":"","sources":["../../src/warp/warp-reference-count.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,8BAA8B,CAClD,GAAG,EAAE,WAAW,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,CAAC,CAkB/B"}

package/dist/warp/warp-reference-count.js

@@ -0,0 +1,32 @@
+// ---------------------------------------------------------------------------
+// WARP-based symbol reference counting
+// ---------------------------------------------------------------------------
+import { referencesForSymbol } from "./references.js";
+/**
+ * Count how many files reference a symbol via WARP graph edges.
+ *
+ * Uses `referencesForSymbol` which traverses incoming `references`
+ * edges from import/export specifier AST nodes to the target sym node.
+ * Uses actual imports, not text matches, and does not spawn subprocesses.
+ *
+ * @param ctx - WARP context
+ * @param symbolName - The symbol to count references for
+ * @param filePath - The file where the symbol is defined (required for sym node ID)
+ */
+export async function countSymbolReferencesFromGraph(ctx, symbolName, filePath) {
+    if (filePath === undefined) {
+        // Without filePath we can't construct the sym node ID.
+        // Return empty — caller should provide filePath for accurate results.
+        return { symbol: symbolName, referenceCount: 0, referencingFiles: [] };
+    }
+    const refs = await referencesForSymbol(ctx, symbolName, filePath);
+    // Deduplicate by file path (multiple imports from the same file
+    // count as one referencing file).
+    const uniqueFiles = [...new Set(refs.map((r) => r.filePath))];
+    return {
+        symbol: symbolName,
+        referenceCount: uniqueFiles.length,
+        referencingFiles: uniqueFiles,
+    };
+}
+//# sourceMappingURL=warp-reference-count.js.map

package/dist/warp/warp-reference-count.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warp-reference-count.js","sourceRoot":"","sources":["../../src/warp/warp-reference-count.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,uCAAuC;AACvC,8EAA8E;AAG9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAQtD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,GAAgB,EAChB,UAAkB,EAClB,QAAiB;IAEjB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,uDAAuD;QACvD,sEAAsE;QACtE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC;IACzE,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAElE,gEAAgE;IAChE,kCAAkC;IAClC,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE9D,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,cAAc,EAAE,WAAW,CAAC,MAAM;QAClC,gBAAgB,EAAE,WAAW;KAC9B,CAAC;AACJ,CAAC"}

package/dist/warp/warp-structural-blame.d.ts

@@ -0,0 +1,20 @@
+import type { WarpContext } from "./context.js";
+import { type SymbolVersion } from "./symbol-timeline.js";
+/** Blame result for a single symbol. */
+export interface WarpBlameResult {
+    readonly symbol: string;
+    readonly filePath: string;
+    readonly history: readonly SymbolVersion[];
+    readonly changeCount: number;
+    readonly createdInCommit: string | undefined;
+    readonly lastSignatureChange: string | undefined;
+    readonly referenceCount: number;
+}
+/**
+ * Compute structural blame for a symbol entirely from the WARP graph.
+ *
+ * Uses symbolTimeline for history, countSymbolReferencesFromGraph for
+ * reference counting. Zero git subprocess calls.
+ */
+export declare function structuralBlameFromGraph(ctx: WarpContext, symbolName: string, filePath: string): Promise<WarpBlameResult>;
+//# sourceMappingURL=warp-structural-blame.d.ts.map

package/dist/warp/warp-structural-blame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warp-structural-blame.d.ts","sourceRoot":"","sources":["../../src/warp/warp-structural-blame.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1E,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,WAAW,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,CAAC,CAmC1B"}

package/dist/warp/warp-structural-blame.js

@@ -0,0 +1,43 @@
+// ---------------------------------------------------------------------------
+// WARP-based Structural Blame — replaces git-dependent blame pipeline
+// ---------------------------------------------------------------------------
+import { symbolTimeline } from "./symbol-timeline.js";
+import { countSymbolReferencesFromGraph } from "./warp-reference-count.js";
+/**
+ * Compute structural blame for a symbol entirely from the WARP graph.
+ *
+ * Uses symbolTimeline for history, countSymbolReferencesFromGraph for
+ * reference counting. Zero git subprocess calls.
+ */
+export async function structuralBlameFromGraph(ctx, symbolName, filePath) {
+    // Get full timeline from WARP
+    const timeline = await symbolTimeline(ctx, symbolName, filePath);
+    if (timeline.versions.length === 0) {
+        return {
+            symbol: symbolName,
+            filePath,
+            history: [],
+            changeCount: 0,
+            createdInCommit: undefined,
+            lastSignatureChange: undefined,
+            referenceCount: 0,
+        };
+    }
+    // Find creation commit (first "added" entry)
+    const created = timeline.versions.find((v) => v.changeKind === "added");
+    // Find last signature change (last "changed" entry)
+    const changes = timeline.versions.filter((v) => v.changeKind === "changed");
+    const lastChange = changes.length > 0 ? changes[changes.length - 1] : undefined;
+    // Count references from WARP graph
+    const refs = await countSymbolReferencesFromGraph(ctx, symbolName, filePath);
+    return {
+        symbol: symbolName,
+        filePath,
+        history: timeline.versions,
+        changeCount: timeline.versions.length,
+        createdInCommit: created?.sha,
+        lastSignatureChange: lastChange?.sha,
+        referenceCount: refs.referenceCount,
+    };
+}
+//# sourceMappingURL=warp-structural-blame.js.map

package/dist/warp/warp-structural-blame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warp-structural-blame.js","sourceRoot":"","sources":["../../src/warp/warp-structural-blame.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,sEAAsE;AACtE,8EAA8E;AAG9E,OAAO,EAAE,cAAc,EAAsB,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAa3E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,GAAgB,EAChB,UAAkB,EAClB,QAAgB;IAEhB,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAEjE,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,QAAQ;YACR,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,CAAC;YACd,eAAe,EAAE,SAAS;YAC1B,mBAAmB,EAAE,SAAS;YAC9B,cAAc,EAAE,CAAC;SAClB,CAAC;IACJ,CAAC;IAED,6CAA6C;IAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC;IAExE,oDAAoD;IACpD,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC;IAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEhF,mCAAmC;IACnC,MAAM,IAAI,GAAG,MAAM,8BAA8B,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAE7E,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,QAAQ;QACR,OAAO,EAAE,QAAQ,CAAC,QAAQ;QAC1B,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM;QACrC,eAAe,EAAE,OAAO,EAAE,GAAG;QAC7B,mBAAmB,EAAE,UAAU,EAAE,GAAG;QACpC,cAAc,EAAE,IAAI,CAAC,cAAc;KACpC,CAAC;AACJ,CAAC"}

package/dist/warp/warp-structural-churn.d.ts

@@ -0,0 +1,30 @@
+import type { WarpContext } from "./context.js";
+export interface ChurnEntry {
+    readonly symbol: string;
+    readonly filePath: string;
+    readonly kind: string;
+    readonly changeCount: number;
+    readonly lastChangedSha: string;
+    readonly lastChangedDate: string;
+}
+export interface StructuralChurnResult {
+    readonly entries: readonly ChurnEntry[];
+    readonly totalSymbols: number;
+    readonly totalCommitsAnalyzed: number;
+    readonly summary: string;
+}
+/** Options for WARP-based churn analysis. */
+export interface WarpChurnOptions {
+    readonly limit?: number;
+    readonly path?: string;
+}
+/**
+ * Compute structural churn entirely from the WARP graph.
+ *
+ * The count itself is computed with QueryBuilder.aggregate() over
+ * commit nodes whose outgoing structural-change edges touch each symbol.
+ * This keeps commit enumeration and per-symbol count accumulation inside
+ * WARP instead of walking every commit in this operation.
+ */
+export declare function structuralChurnFromGraph(ctx: WarpContext, options?: WarpChurnOptions): Promise<StructuralChurnResult>;
+//# sourceMappingURL=warp-structural-churn.d.ts.map

package/dist/warp/warp-structural-churn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warp-structural-churn.d.ts","sourceRoot":"","sources":["../../src/warp/warp-structural-churn.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAiBD;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,WAAW,EAChB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,qBAAqB,CAAC,CA+ChC"}

package/dist/warp/warp-structural-churn.js

@@ -0,0 +1,213 @@
+// ---------------------------------------------------------------------------
+// WARP-based Structural Churn — aggregate-backed graph query
+// ---------------------------------------------------------------------------
+import { observeGraph } from "./context.js";
+const CHANGE_EDGE_LABELS = ["adds", "changes", "removes"];
+/**
+ * Compute structural churn entirely from the WARP graph.
+ *
+ * The count itself is computed with QueryBuilder.aggregate() over
+ * commit nodes whose outgoing structural-change edges touch each symbol.
+ * This keeps commit enumeration and per-symbol count accumulation inside
+ * WARP instead of walking every commit in this operation.
+ */
+export async function structuralChurnFromGraph(ctx, options) {
+    const limit = options?.limit ?? 20;
+    const pathFilter = options?.path;
+    const obs = await observeGraph(ctx, {
+        match: ["commit:*", "sym:*"],
+        expose: ["sha", "tick", "name", "kind"],
+    });
+    const totalCommitsAnalyzed = await countCommits(obs);
+    if (totalCommitsAnalyzed === 0) {
+        return { entries: [], totalSymbols: 0, totalCommitsAnalyzed: 0, summary: "No indexed commits." };
+    }
+    const discovery = await discoverChurnCandidates(ctx, obs, pathFilter);
+    const scored = await Promise.all(discovery.candidates.map(async (candidate) => {
+        const touch = await aggregateTouchesForSymbol(obs, candidate.id, discovery.receipts);
+        if (touch.changeCount === 0 || touch.lastChangedTick === null)
+            return null;
+        return {
+            symbol: candidate.symbol,
+            filePath: candidate.filePath,
+            kind: candidate.kind,
+            changeCount: touch.changeCount,
+            lastChangedSha: await shaForTick(obs, touch.lastChangedTick),
+            lastChangedDate: "",
+        };
+    }));
+    const sorted = scored
+        .filter((entry) => entry !== null)
+        .sort((a, b) => b.changeCount - a.changeCount);
+    const entries = sorted.slice(0, limit);
+    const top = entries[0];
+    const topName = top?.symbol ?? "none";
+    const topCount = top?.changeCount ?? 0;
+    const summary = entries.length === 0
+        ? "No structural changes found."
+        : `${String(sorted.length)} symbols across ${String(totalCommitsAnalyzed)} commits. Hottest: ${topName} (${String(topCount)} changes).`;
+    return {
+        entries,
+        totalSymbols: sorted.length,
+        totalCommitsAnalyzed,
+        summary,
+    };
+}
+async function countCommits(obs) {
+    const result = await obs.query()
+        .match("commit:*")
+        .aggregate({ count: true })
+        .run();
+    return result.count ?? 0;
+}
+async function discoverChurnCandidates(ctx, obs, pathFilter) {
+    const candidates = [];
+    const current = await obs.query()
+        .match("sym:*")
+        .select(["id", "props"])
+        .run();
+    for (const node of current.nodes) {
+        if (node.id === undefined)
+            continue;
+        const parsed = parseSymId(node.id);
+        if (parsed === null)
+            continue;
+        if (!matchesPathFilter(parsed.filePath, pathFilter))
+            continue;
+        candidates.push({
+            id: node.id,
+            symbol: parsed.symbol,
+            filePath: parsed.filePath,
+            kind: typeof node.props?.["kind"] === "string" ? node.props["kind"] : "unknown",
+        });
+    }
+    const { receipts } = await ctx.app.core().materialize({ receipts: true });
+    for (const symId of removedSymIds(receipts)) {
+        if (candidates.some((candidate) => candidate.id === symId))
+            continue;
+        const parsed = parseSymId(symId);
+        if (parsed === null)
+            continue;
+        if (!matchesPathFilter(parsed.filePath, pathFilter))
+            continue;
+        candidates.push({
+            id: symId,
+            symbol: parsed.symbol,
+            filePath: parsed.filePath,
+            kind: await removedSymbolKind(ctx, symId, receipts),
+        });
+    }
+    return { candidates, receipts };
+}
+function removedSymIds(receipts) {
+    const ids = [];
+    for (const receipt of receipts) {
+        for (const op of receipt.ops) {
+            if (op.op !== "NodeTombstone" || op.result !== "applied" || !op.target.startsWith("sym:"))
+                continue;
+            if (!ids.includes(op.target)) {
+                ids.push(op.target);
+            }
+        }
+    }
+    return ids;
+}
+async function removedSymbolKind(ctx, symId, receipts) {
+    const removalTicks = receipts
+        .filter((receipt) => receipt.ops.some((op) => op.op === "NodeTombstone" &&
+        op.result === "applied" &&
+        op.target === symId))
+        .map((receipt) => receipt.lamport)
+        .sort((a, b) => b - a);
+    const lastRemovalTick = removalTicks[0];
+    if (lastRemovalTick === undefined || lastRemovalTick <= 1)
+        return "unknown";
+    const beforeRemoval = await observeGraph(ctx, { match: symId, expose: ["kind"] }, { source: { kind: "live", ceiling: lastRemovalTick - 1 } });
+    const props = await beforeRemoval.getNodeProps(symId);
+    return typeof props?.["kind"] === "string" ? props["kind"] : "unknown";
+}
+async function aggregateTouchesForSymbol(obs, symId, receipts) {
+    const aggregates = await Promise.all(CHANGE_EDGE_LABELS.map((label) => aggregateTouchesForLabel(obs, symId, label)));
+    const changeCount = aggregates.reduce((sum, result) => sum + result.count, 0);
+    const lastChangedTick = aggregates.reduce((latest, result) => {
+        if (result.maxTick === null)
+            return latest;
+        if (latest === null || result.maxTick > latest)
+            return result.maxTick;
+        return latest;
+    }, null);
+    if (changeCount > 0) {
+        return { changeCount, lastChangedTick };
+    }
+    // QueryBuilder starts from live node sets; a tombstoned sym can be
+    // discovered from tick receipts but cannot be matched as a live node.
+    // Use the receipt edge-add outcomes as the WARP-native fallback for
+    // symbols whose final state is removed.
+    return receiptTouchesForSymbol(symId, receipts);
+}
+async function aggregateTouchesForLabel(obs, symId, label) {
+    const result = await obs.query()
+        .match("commit:*")
+        .where((node) => node.edgesOut.some((edge) => edge.label === label && edge.to === symId))
+        .aggregate({ count: true, max: "tick" })
+        .run();
+    return {
+        count: result.count ?? 0,
+        maxTick: typeof result.max === "number" && result.max > 0 ? result.max : null,
+    };
+}
+async function shaForTick(obs, tick) {
+    const result = await obs.query()
+        .match("commit:*")
+        .where({ tick })
+        .select(["id", "props"])
+        .run();
+    const commit = result.nodes[0];
+    if (commit === undefined)
+        return "";
+    return typeof commit.props?.["sha"] === "string"
+        ? commit.props["sha"]
+        : commit.id?.slice("commit:".length) ?? "";
+}
+function parseSymId(symId) {
+    if (!symId.startsWith("sym:"))
+        return null;
+    const withoutPrefix = symId.slice("sym:".length);
+    const lastColon = withoutPrefix.lastIndexOf(":");
+    if (lastColon === -1)
+        return null;
+    return {
+        filePath: withoutPrefix.slice(0, lastColon),
+        symbol: withoutPrefix.slice(lastColon + 1),
+    };
+}
+function matchesPathFilter(filePath, pathFilter) {
+    return pathFilter === undefined || filePath.startsWith(pathFilter);
+}
+function receiptTouchesForSymbol(symId, receipts) {
+    let changeCount = 0;
+    let lastChangedTick = null;
+    for (const receipt of receipts) {
+        for (const op of receipt.ops) {
+            if (op.op !== "EdgeAdd" || op.result !== "applied")
+                continue;
+            if (!isChangeEdgeToSymbol(op.target, symId))
+                continue;
+            changeCount++;
+            if (lastChangedTick === null || receipt.lamport > lastChangedTick) {
+                lastChangedTick = receipt.lamport;
+            }
+        }
+    }
+    return { changeCount, lastChangedTick };
+}
+function isChangeEdgeToSymbol(edgeKey, symId) {
+    const [from, to, label] = edgeKey.split("\0");
+    return from?.startsWith("commit:") === true &&
+        to === symId &&
+        isChangeEdgeLabel(label);
+}
+function isChangeEdgeLabel(label) {
+    return CHANGE_EDGE_LABELS.some((candidate) => candidate === label);
+}
+//# sourceMappingURL=warp-structural-churn.js.map

package/dist/warp/warp-structural-churn.js.map

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

package/dist/warp/warp-structural-log.d.ts

@@ -0,0 +1,35 @@
+import type { WarpContext } from "./context.js";
+/** A symbol that was added, removed, or changed in a commit. */
+export interface StructuralLogSymbolChange {
+    readonly name: string;
+    readonly kind: string;
+    readonly signature?: string | undefined;
+    readonly exported: boolean;
+    readonly filePath: string;
+}
+export interface StructuralLogEntry {
+    readonly sha: string;
+    readonly message: string;
+    readonly author: string;
+    readonly date: string;
+    readonly symbols: {
+        readonly added: readonly StructuralLogSymbolChange[];
+        readonly removed: readonly StructuralLogSymbolChange[];
+        readonly changed: readonly StructuralLogSymbolChange[];
+    };
+    readonly summary: string;
+}
+/** Options for WARP-based structural log. */
+export interface WarpLogOptions {
+    readonly limit?: number;
+    readonly path?: string;
+}
+/**
+ * Produce a structural log entirely from the WARP graph.
+ *
+ * Walks commit nodes in reverse tick order (most recent first),
+ * traverses outgoing adds/changes/removes edges per commit to
+ * collect symbol changes. Zero git subprocess calls.
+ */
+export declare function structuralLogFromGraph(ctx: WarpContext, options?: WarpLogOptions): Promise<readonly StructuralLogEntry[]>;
+//# sourceMappingURL=warp-structural-log.d.ts.map

package/dist/warp/warp-structural-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warp-structural-log.d.ts","sourceRoot":"","sources":["../../src/warp/warp-structural-log.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,gEAAgE;AAChE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,KAAK,EAAE,SAAS,yBAAyB,EAAE,CAAC;QACrD,QAAQ,CAAC,OAAO,EAAE,SAAS,yBAAyB,EAAE,CAAC;QACvD,QAAQ,CAAC,OAAO,EAAE,SAAS,yBAAyB,EAAE,CAAC;KACxD,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,WAAW,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAsGxC"}