@flyingrobots/graft 0.6.1 → 0.7.0

package/dist/warp/open.js

@@ -2,66 +2,41 @@
  * 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 RawWarpApp, { GitGraphAdapter } from "@git-stunts/git-warp";
+import WarpApp, { GitGraphAdapter } from "@git-stunts/git-warp";
 import GitPlumbing from "@git-stunts/plumbing";
 import { DEFAULT_WARP_WRITER_ID } from "./writer-id.js";
 export const GRAPH_NAME = "graft-ast";
-function toRawLens(lens) {
-    return {
-        match: typeof lens.match === "string" ? lens.match : [...lens.match],
-        ...(lens.expose !== undefined ? { expose: [...lens.expose] } : {}),
-        ...(lens.redact !== undefined ? { redact: [...lens.redact] } : {}),
-    };
-}
-function toRawObserverOptions(options) {
-    if (options === undefined) {
-        return undefined;
-    }
-    if (options.source === undefined) {
-        return {};
-    }
-    return {
-        source: {
-            kind: options.source.kind,
-            ceiling: options.source.ceiling,
-        },
-    };
-}
-function wrapWarpApp(app) {
-    return {
-        async hasNode(nodeId) {
-            const observer = await app.observer({ match: nodeId });
-            const nodes = await observer.getNodes();
-            return nodes.includes(nodeId);
-        },
-        observer(lens, options) {
-            return app.observer(toRawLens(lens), toRawObserverOptions(options));
-        },
-        patch(build) {
-            return app.patch((patch) => build(patch));
-        },
-        async materialize() {
-            await app.core().materialize();
-        },
-        async materializeReceipts() {
-            const { receipts } = await app.core().materialize({ receipts: true });
-            return receipts;
-        },
-    };
+export const DEFAULT_WARP_CHECKPOINT_EVERY = 128;
+const WARP_GIT_MAX_BUFFER_BYTES = 128 * 1024 * 1024;
+function raiseWarpGitBufferLimit(plumbing) {
+    const execute = plumbing.execute.bind(plumbing);
+    plumbing.execute = ((options) => execute({
+        ...options,
+        maxBytes: options.maxBytes ?? WARP_GIT_MAX_BUFFER_BYTES,
+    }));
+    const executeStream = plumbing.executeStream.bind(plumbing);
+    plumbing.executeStream = (async (options) => {
+        const stream = await executeStream(options);
+        const collect = stream.collect.bind(stream);
+        stream.collect = (opts = {}) => collect({
+            ...opts,
+            maxBytes: opts.maxBytes ?? WARP_GIT_MAX_BUFFER_BYTES,
+        });
+        return stream;
+    });
+    return plumbing;
 }
 export async function openWarp(options) {
-    // createDefault() wires the ShellRunnerFactory (required port)
-    const plumbing = GitPlumbing.createDefault({ cwd: options.cwd });
+    const plumbing = raiseWarpGitBufferLimit(GitPlumbing.createDefault({ cwd: options.cwd }));
     const persistence = new GitGraphAdapter({ plumbing });
-    const app = await RawWarpApp.open({
+    return WarpApp.open({
         persistence,
         graphName: GRAPH_NAME,
         writerId: options.writerId ?? DEFAULT_WARP_WRITER_ID,
+        checkpointPolicy: { every: options.checkpointEvery ?? DEFAULT_WARP_CHECKPOINT_EVERY },
         onDeleteWithData: "cascade",
     });
-    return wrapWarpApp(app);
 }
 //# sourceMappingURL=open.js.map

package/dist/warp/open.js.map

@@ -1 +1 @@
-{"version":3,"file":"open.js","sourceRoot":"","sources":["../../src/warp/open.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"open.js","sourceRoot":"","sources":["../../src/warp/open.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,OAAO,EAAE,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,WAAW,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,CAAC,MAAM,UAAU,GAAG,WAAW,CAAC;AACtC,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAC;AACjD,MAAM,yBAAyB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAepD,SAAS,uBAAuB,CAAC,QAAqB;IACpD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChD,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC,OAA0B,EAAE,EAAE,CAAC,OAAO,CAAC;QAC1D,GAAG,OAAO;QACV,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,yBAAyB;KACxD,CAAC,CAA2B,CAAC;IAE9B,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5D,QAAQ,CAAC,aAAa,GAAG,CAAC,KAAK,EAAE,OAAsF,EAAE,EAAE;QACzH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,GAAG,CAAC,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC;YACtC,GAAG,IAAI;YACP,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,yBAAyB;SACrD,CAAC,CAAC;QACH,OAAO,MAAuB,CAAC;IACjC,CAAC,CAAiC,CAAC;IAEnC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAwB;IACrD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC1F,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEtD,OAAO,OAAO,CAAC,IAAI,CAAC;QAClB,WAAW;QACX,SAAS,EAAE,UAAU;QACrB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,sBAAsB;QACpD,gBAAgB,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,eAAe,IAAI,6BAA6B,EAAE;QACrF,gBAAgB,EAAE,SAAS;KAC5B,CAAC,CAAC;AACL,CAAC"}

package/dist/warp/outline-diff-trailer.d.ts

@@ -0,0 +1,26 @@
+/** A single symbol change to include in the trailer. */
+export interface SymbolDiffEntry {
+    readonly name: string;
+    readonly kind: string;
+    readonly changeKind: "added" | "removed" | "changed";
+}
+/** Options for trailer formatting. */
+export interface TrailerOptions {
+    /** Maximum entries before truncation. Default: 20. */
+    readonly maxEntries?: number;
+}
+/**
+ * Format a list of symbol changes as a Git commit trailer.
+ *
+ * Format: `Structural-Diff: added fn:X; removed class:Y; changed fn:Z`
+ *
+ * Returns empty string if there are no changes.
+ */
+export declare function formatStructuralDiffTrailer(entries: readonly SymbolDiffEntry[], options?: TrailerOptions): string;
+/**
+ * Parse a Structural-Diff trailer back into structured entries.
+ *
+ * Skips malformed entries gracefully.
+ */
+export declare function parseStructuralDiffTrailer(text: string): SymbolDiffEntry[];
+//# sourceMappingURL=outline-diff-trailer.d.ts.map

package/dist/warp/outline-diff-trailer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outline-diff-trailer.d.ts","sourceRoot":"","sources":["../../src/warp/outline-diff-trailer.ts"],"names":[],"mappings":"AAIA,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;CACtD;AAED,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAiBD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,OAAO,CAAC,EAAE,cAAc,GACvB,MAAM,CAgBR;AAUD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CA0B1E"}

package/dist/warp/outline-diff-trailer.js

@@ -0,0 +1,68 @@
+// ---------------------------------------------------------------------------
+// Outline Diff Commit Trailer — structural summary in git commit messages
+// ---------------------------------------------------------------------------
+/** Short kind abbreviations for the trailer format. */
+const KIND_ABBREV = {
+    function: "fn",
+    class: "class",
+    interface: "iface",
+    type: "type",
+    variable: "var",
+    method: "method",
+    property: "prop",
+};
+function abbrevKind(kind) {
+    return KIND_ABBREV[kind] ?? kind;
+}
+/**
+ * Format a list of symbol changes as a Git commit trailer.
+ *
+ * Format: `Structural-Diff: added fn:X; removed class:Y; changed fn:Z`
+ *
+ * Returns empty string if there are no changes.
+ */
+export function formatStructuralDiffTrailer(entries, options) {
+    if (entries.length === 0)
+        return "";
+    const max = options?.maxEntries ?? 20;
+    const display = entries.slice(0, max);
+    const parts = display.map((e) => `${e.changeKind} ${abbrevKind(e.kind)}:${e.name}`);
+    let trailer = `Structural-Diff: ${parts.join("; ")}`;
+    if (entries.length > max) {
+        trailer += `; ... (${String(entries.length)} total)`;
+    }
+    return trailer;
+}
+// ---------------------------------------------------------------------------
+// Parser
+// ---------------------------------------------------------------------------
+const TRAILER_PREFIX = "Structural-Diff:";
+const ENTRY_RE = /^(added|removed|changed)\s+(\w+):(\w+)$/;
+/**
+ * Parse a Structural-Diff trailer back into structured entries.
+ *
+ * Skips malformed entries gracefully.
+ */
+export function parseStructuralDiffTrailer(text) {
+    const idx = text.indexOf(TRAILER_PREFIX);
+    if (idx === -1)
+        return [];
+    const body = text.slice(idx + TRAILER_PREFIX.length).trim();
+    const parts = body.split(";").map((p) => p.trim());
+    const results = [];
+    for (const part of parts) {
+        if (part.startsWith("..."))
+            continue;
+        const match = ENTRY_RE.exec(part);
+        if (match === null)
+            continue;
+        const changeKind = match[1];
+        const abbrev = match[2] ?? "unknown";
+        const name = match[3] ?? "unknown";
+        // Reverse the abbreviation
+        const kind = Object.entries(KIND_ABBREV).find(([, v]) => v === abbrev)?.[0] ?? abbrev;
+        results.push({ name, kind, changeKind });
+    }
+    return results;
+}
+//# sourceMappingURL=outline-diff-trailer.js.map

package/dist/warp/outline-diff-trailer.js.map

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

package/dist/warp/refactor-difficulty.d.ts

@@ -0,0 +1,38 @@
+import type { WarpContext } from "./context.js";
+export type RefactorDifficultyRisk = "low" | "medium" | "high";
+export type RefactorDifficultyRecommendation = "refactor_freely" | "refactor_with_tests" | "plan_before_refactor";
+export interface RefactorDifficultyOptions {
+    readonly symbol: string;
+    readonly path?: string | undefined;
+    readonly limit?: number | undefined;
+}
+export interface RefactorDifficultyAxis {
+    readonly score: number;
+}
+export interface RefactorDifficultyCurvature extends RefactorDifficultyAxis {
+    readonly changeCount: number;
+    readonly signatureChangeCount: number;
+}
+export interface RefactorDifficultyFriction extends RefactorDifficultyAxis {
+    readonly referenceCount: number;
+    readonly referencingFiles: readonly string[];
+}
+export interface RefactorDifficultyEntry {
+    readonly symbol: string;
+    readonly filePath: string;
+    readonly kind: string;
+    readonly score: number;
+    readonly risk: RefactorDifficultyRisk;
+    readonly recommendation: RefactorDifficultyRecommendation;
+    readonly curvature: RefactorDifficultyCurvature;
+    readonly friction: RefactorDifficultyFriction;
+}
+export interface RefactorDifficultyResult {
+    readonly symbol: string;
+    readonly path?: string | undefined;
+    readonly entries: readonly RefactorDifficultyEntry[];
+    readonly total: number;
+    readonly summary: string;
+}
+export declare function refactorDifficultyFromGraph(ctx: WarpContext, options: RefactorDifficultyOptions): Promise<RefactorDifficultyResult>;
+//# sourceMappingURL=refactor-difficulty.d.ts.map

package/dist/warp/refactor-difficulty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refactor-difficulty.d.ts","sourceRoot":"","sources":["../../src/warp/refactor-difficulty.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAOhD,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE/D,MAAM,MAAM,gCAAgC,GACxC,iBAAiB,GACjB,qBAAqB,GACrB,sBAAsB,CAAC;AAE3B,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,2BAA4B,SAAQ,sBAAsB;IACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,0BAA2B,SAAQ,sBAAsB;IACxE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,gCAAgC,CAAC;IAC1D,QAAQ,CAAC,SAAS,EAAE,2BAA2B,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAC;CAC/C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AASD,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CA0BnC"}

package/dist/warp/refactor-difficulty.js

@@ -0,0 +1,169 @@
+// ---------------------------------------------------------------------------
+// Refactor Difficulty — curvature x friction over WARP facts
+// ---------------------------------------------------------------------------
+import { observeGraph } from "./context.js";
+import { symbolTimeline } from "./symbol-timeline.js";
+import { countSymbolReferencesFromGraph } from "./warp-reference-count.js";
+const CHANGE_EDGE_LABELS = ["adds", "changes", "removes"];
+export async function refactorDifficultyFromGraph(ctx, options) {
+    const symbol = options.symbol.trim();
+    if (symbol.length === 0) {
+        throw new Error("refactorDifficultyFromGraph: symbol must be non-empty");
+    }
+    const pathFilter = normalizeOptionalPath(options.path);
+    const limit = options.limit ?? 20;
+    const candidates = await findSymbolCandidates(ctx, symbol, pathFilter);
+    const entries = await Promise.all(candidates.map((candidate) => scoreCandidate(ctx, candidate)));
+    const sorted = entries.sort(compareDifficultyEntries).slice(0, limit);
+    const top = sorted[0];
+    const summary = top === undefined
+        ? `No indexed symbols matched ${symbol}.`
+        : `${String(entries.length)} symbol matches. Highest difficulty: ${top.symbol} in ${top.filePath} (${String(top.score)}).`;
+    return {
+        symbol,
+        ...(pathFilter !== undefined ? { path: pathFilter } : {}),
+        entries: sorted,
+        total: entries.length,
+        summary,
+    };
+}
+async function findSymbolCandidates(ctx, symbol, pathFilter) {
+    const obs = await observeGraph(ctx, {
+        match: "sym:*",
+        expose: ["name", "kind", "filePath"],
+    });
+    const result = await obs.query()
+        .match("sym:*")
+        .where((node) => {
+        const parsed = parseSymId(node.id);
+        if (parsed === null)
+            return false;
+        if (!matchesPathFilter(parsed.filePath, pathFilter))
+            return false;
+        const propName = typeof node.props["name"] === "string" ? node.props["name"] : "";
+        return parsed.symbol === symbol || propName === symbol;
+    })
+        .select(["id", "props"])
+        .run();
+    const candidates = [];
+    for (const node of result.nodes) {
+        if (node.id === undefined)
+            continue;
+        const parsed = parseSymId(node.id);
+        if (parsed === null)
+            continue;
+        candidates.push({
+            id: node.id,
+            symbol: parsed.symbol,
+            filePath: parsed.filePath,
+            kind: typeof node.props?.["kind"] === "string" ? node.props["kind"] : "unknown",
+        });
+    }
+    return candidates;
+}
+async function scoreCandidate(ctx, candidate) {
+    const [changeCount, timeline, references] = await Promise.all([
+        countSymbolTouches(ctx, candidate.id),
+        symbolTimeline(ctx, candidate.symbol, candidate.filePath),
+        countSymbolReferencesFromGraph(ctx, candidate.symbol, candidate.filePath),
+    ]);
+    const signatureChangeCount = countSignatureChanges(timeline.versions);
+    const curvatureScore = changeCount + signatureChangeCount;
+    const frictionScore = references.referenceCount;
+    const score = curvatureScore * frictionScore;
+    return {
+        symbol: candidate.symbol,
+        filePath: candidate.filePath,
+        kind: candidate.kind,
+        score,
+        risk: riskForScore(score),
+        recommendation: recommendationForScore(score),
+        curvature: {
+            changeCount,
+            signatureChangeCount,
+            score: curvatureScore,
+        },
+        friction: {
+            referenceCount: references.referenceCount,
+            referencingFiles: references.referencingFiles,
+            score: frictionScore,
+        },
+    };
+}
+async function countSymbolTouches(ctx, symId) {
+    const obs = await observeGraph(ctx, {
+        match: ["commit:*", "sym:*"],
+        expose: ["tick"],
+    });
+    const counts = await Promise.all(CHANGE_EDGE_LABELS.map(async (label) => {
+        const result = await obs.query()
+            .match("commit:*")
+            .where((node) => node.edgesOut.some((edge) => edge.label === label && edge.to === symId))
+            .aggregate({ count: true })
+            .run();
+        return result.count ?? 0;
+    }));
+    return counts.reduce((sum, count) => sum + count, 0);
+}
+function countSignatureChanges(versions) {
+    let lastSignature;
+    let changes = 0;
+    for (const version of versions) {
+        if (version.signature === undefined)
+            continue;
+        if (lastSignature === undefined) {
+            lastSignature = version.signature;
+            continue;
+        }
+        if (version.signature !== lastSignature) {
+            changes++;
+            lastSignature = version.signature;
+        }
+    }
+    return changes;
+}
+function riskForScore(score) {
+    if (score >= 12)
+        return "high";
+    if (score >= 4)
+        return "medium";
+    return "low";
+}
+function recommendationForScore(score) {
+    if (score >= 12)
+        return "plan_before_refactor";
+    if (score >= 4)
+        return "refactor_with_tests";
+    return "refactor_freely";
+}
+function compareDifficultyEntries(left, right) {
+    return right.score - left.score ||
+        right.curvature.score - left.curvature.score ||
+        right.friction.score - left.friction.score ||
+        left.filePath.localeCompare(right.filePath) ||
+        left.symbol.localeCompare(right.symbol);
+}
+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 normalizeOptionalPath(path) {
+    if (path === undefined)
+        return undefined;
+    const trimmed = path.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function matchesPathFilter(filePath, pathFilter) {
+    return pathFilter === undefined ||
+        filePath === pathFilter ||
+        filePath.startsWith(`${pathFilter}/`);
+}
+//# sourceMappingURL=refactor-difficulty.js.map

package/dist/warp/refactor-difficulty.js.map

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

package/dist/warp/references.d.ts

@@ -0,0 +1,22 @@
+import type { WarpContext } from "./context.js";
+export interface SymbolReference {
+    readonly filePath: string;
+    readonly importedName: string;
+    readonly localName: string;
+}
+/**
+ * Find all files that reference a symbol, by querying the WARP graph's
+ * cross-file import resolution edges.
+ *
+ * Uses traverse.bfs for edge discovery (substrate-side) and QueryBuilder
+ * for batch prop reads. No getEdges() — never assumes all edges fit in
+ * memory.
+ *
+ * For named symbols: finds import_specifier/export_specifier nodes that
+ * have a `references` edge pointing at `sym:<filePath>:<symbolName>`.
+ *
+ * For namespace imports ("*"): finds namespace_import nodes that have a
+ * `references` edge pointing at `file:<filePath>`.
+ */
+export declare function referencesForSymbol(ctx: WarpContext, symbolName: string, filePath: string): Promise<SymbolReference[]>;
+//# sourceMappingURL=references.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../src/warp/references.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,WAAW,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,EAAE,CAAC,CA4C5B"}

package/dist/warp/references.js

@@ -0,0 +1,57 @@
+// ---------------------------------------------------------------------------
+// Symbol reference queries — find what depends on a symbol via the WARP graph
+// ---------------------------------------------------------------------------
+import { observeGraph } from "./context.js";
+/**
+ * Find all files that reference a symbol, by querying the WARP graph's
+ * cross-file import resolution edges.
+ *
+ * Uses traverse.bfs for edge discovery (substrate-side) and QueryBuilder
+ * for batch prop reads. No getEdges() — never assumes all edges fit in
+ * memory.
+ *
+ * For named symbols: finds import_specifier/export_specifier nodes that
+ * have a `references` edge pointing at `sym:<filePath>:<symbolName>`.
+ *
+ * For namespace imports ("*"): finds namespace_import nodes that have a
+ * `references` edge pointing at `file:<filePath>`.
+ */
+export async function referencesForSymbol(ctx, symbolName, filePath) {
+    const obs = await observeGraph(ctx, { match: ["ast:*", "file:*", "sym:*"] });
+    // Determine the target node ID
+    const targetId = symbolName === "*"
+        ? `file:${filePath}`
+        : `sym:${filePath}:${symbolName}`;
+    // Guard: target must exist for traverse to work.
+    const targetExists = await obs.hasNode(targetId);
+    if (!targetExists)
+        return [];
+    // Traverse: find AST nodes with incoming `references` edges to the target.
+    const referrerIds = await obs.traverse.bfs(targetId, {
+        dir: "in",
+        labelFilter: "references",
+        maxDepth: 1,
+    });
+    const astReferrerIds = referrerIds.filter((id) => id.startsWith("ast:"));
+    if (astReferrerIds.length === 0)
+        return [];
+    // Batch prop read for all referencing nodes.
+    const propsResult = await obs.query()
+        .match(astReferrerIds)
+        .select(["id", "props"])
+        .run();
+    const results = [];
+    for (const node of propsResult.nodes) {
+        if (node.id === undefined)
+            continue;
+        const props = node.props ?? {};
+        const importedName = typeof props["importedName"] === "string" ? props["importedName"] : symbolName;
+        const localName = typeof props["localName"] === "string" ? props["localName"] : importedName;
+        const nodeFilePath = typeof props["filePath"] === "string" ? props["filePath"] : null;
+        if (nodeFilePath !== null) {
+            results.push({ filePath: nodeFilePath, importedName, localName });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=references.js.map

package/dist/warp/references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../../src/warp/references.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E;AAI9E,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAQ5C;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAgB,EAChB,UAAkB,EAClB,QAAgB;IAEhB,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAE7E,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,UAAU,KAAK,GAAG;QACjC,CAAC,CAAC,QAAQ,QAAQ,EAAE;QACpB,CAAC,CAAC,OAAO,QAAQ,IAAI,UAAU,EAAE,CAAC;IAEpC,iDAAiD;IACjD,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,CAAC,YAAY;QAAE,OAAO,EAAE,CAAC;IAE7B,2EAA2E;IAC3E,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE;QACnD,GAAG,EAAE,IAAI;QACT,WAAW,EAAE,YAAY;QACzB,QAAQ,EAAE,CAAC;KACZ,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACzE,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE3C,6CAA6C;IAC7C,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE;SAClC,KAAK,CAAC,cAAc,CAAC;SACrB,MAAM,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;SACvB,GAAG,EAAmB,CAAC;IAE1B,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,EAAE,KAAK,SAAS;YAAE,SAAS;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAE/B,MAAM,YAAY,GAAG,OAAO,KAAK,CAAC,cAAc,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;QACpG,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;QAC7F,MAAM,YAAY,GAAG,OAAO,KAAK,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAEtF,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/warp/stale-docs.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Stale Docs Checker — cross-references doc symbol mentions against
+ * the WARP graph to detect documentation that may be outdated.
+ *
+ * Walks markdown for backtick-quoted identifiers and code block
+ * contents. For each referenced symbol, queries the WARP graph to
+ * determine whether the symbol changed after the doc was last modified.
+ *
+ * Also detects version number drift between package.json and CHANGELOG.
+ */
+import type { WarpContext } from "./context.js";
+/** A symbol in a doc that is stale relative to the WARP graph. */
+export interface StaleSymbolEntry {
+    readonly symbol: string;
+    readonly changeKind: "changed" | "removed";
+    readonly lastChangeSha: string;
+}
+/** Result of checking a single doc for staleness. */
+export interface StaleDocReport {
+    readonly docPath: string;
+    /** Symbols referenced in the doc that changed after the doc was last modified. */
+    readonly staleSymbols: readonly StaleSymbolEntry[];
+    /** Symbols referenced in the doc that do not exist in the WARP graph. */
+    readonly unknownSymbols: readonly string[];
+}
+/** Result of checking version drift between package.json and CHANGELOG. */
+export interface VersionDriftReport {
+    readonly drifted: boolean;
+    readonly packageVersion: string;
+    readonly changelogVersion: string | null;
+}
+/**
+ * Extract symbol name references from markdown content.
+ *
+ * Sources:
+ * 1. Backtick-quoted identifiers (single backtick, must be valid JS/TS identifier)
+ * 2. Declaration identifiers inside fenced code blocks
+ *
+ * Returns a deduplicated array of symbol names.
+ */
+export declare function extractDocSymbolReferences(markdown: string): string[];
+/**
+ * Check a markdown document for stale symbol references.
+ *
+ * @param ctx - WARP context
+ * @param docPath - relative path of the doc (for the report)
+ * @param docCommitSha - SHA of the commit when the doc was last modified
+ * @param docContent - raw markdown content of the doc
+ */
+export declare function checkStaleDocs(ctx: WarpContext, docPath: string, docCommitSha: string, docContent: string): Promise<StaleDocReport>;
+/**
+ * Check whether the latest version in a CHANGELOG matches
+ * the version in package.json.
+ */
+export declare function checkVersionDrift(packageVersion: string, changelogContent: string): VersionDriftReport;
+//# sourceMappingURL=stale-docs.d.ts.map

package/dist/warp/stale-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-docs.d.ts","sourceRoot":"","sources":["../../src/warp/stale-docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAShD,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,YAAY,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnD,yEAAyE;IACzE,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,2EAA2E;AAC3E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AA8BD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAkCrE;AAmBD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,CAAC,CAsCzB;AASD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,MAAM,GACvB,kBAAkB,CASpB"}