@flyingrobots/graft 0.6.1 → 0.7.0

package/dist/operations/export-surface-diff.js

@@ -0,0 +1,298 @@
+// ---------------------------------------------------------------------------
+// Export surface diff — what changed in the public API between two refs?
+// ---------------------------------------------------------------------------
+import { getChangedFiles, getFileAtRef } from "../git/diff.js";
+import { detectLang } from "../parser/lang.js";
+import { extractOutline } from "../parser/outline.js";
+import { toJsonObject } from "./result-dto.js";
+// ---- Internal helpers -----------------------------------------------------
+function exportKey(entry) {
+    return `${entry.kind}:${entry.name}`;
+}
+function extractExportedEntries(content, filePath) {
+    if (content === null)
+        return new Map();
+    const lang = detectLang(filePath);
+    if (lang === null)
+        return new Map();
+    const outline = extractOutline(content, lang);
+    const result = new Map();
+    for (const entry of outline.entries) {
+        if (entry.exported) {
+            result.set(exportKey(entry), entry);
+        }
+    }
+    return result;
+}
+function normalizeSignaturePart(value) {
+    return value.replace(/\s+/g, " ").trim();
+}
+function findMatchingParen(signature, openIndex) {
+    let depth = 0;
+    for (let index = openIndex; index < signature.length; index += 1) {
+        const char = signature[index];
+        if (char === "(") {
+            depth += 1;
+        }
+        else if (char === ")") {
+            depth -= 1;
+            if (depth === 0) {
+                return index;
+            }
+        }
+    }
+    return -1;
+}
+function splitTopLevelCommaList(value) {
+    const parts = [];
+    let start = 0;
+    let angle = 0;
+    let brace = 0;
+    let bracket = 0;
+    let paren = 0;
+    for (let index = 0; index < value.length; index += 1) {
+        const char = value[index];
+        if (char === "<")
+            angle += 1;
+        else if (char === ">" && angle > 0)
+            angle -= 1;
+        else if (char === "{")
+            brace += 1;
+        else if (char === "}" && brace > 0)
+            brace -= 1;
+        else if (char === "[")
+            bracket += 1;
+        else if (char === "]" && bracket > 0)
+            bracket -= 1;
+        else if (char === "(")
+            paren += 1;
+        else if (char === ")" && paren > 0)
+            paren -= 1;
+        else if (char === "," && angle === 0 && brace === 0 && bracket === 0 && paren === 0) {
+            const part = value.slice(start, index).trim();
+            if (part.length > 0)
+                parts.push(part);
+            start = index + 1;
+        }
+    }
+    const tail = value.slice(start).trim();
+    if (tail.length > 0)
+        parts.push(tail);
+    return parts;
+}
+function findTopLevelColon(value) {
+    let angle = 0;
+    let brace = 0;
+    let bracket = 0;
+    let paren = 0;
+    for (let index = 0; index < value.length; index += 1) {
+        const char = value[index];
+        if (char === "<")
+            angle += 1;
+        else if (char === ">" && angle > 0)
+            angle -= 1;
+        else if (char === "{")
+            brace += 1;
+        else if (char === "}" && brace > 0)
+            brace -= 1;
+        else if (char === "[")
+            bracket += 1;
+        else if (char === "]" && bracket > 0)
+            bracket -= 1;
+        else if (char === "(")
+            paren += 1;
+        else if (char === ")" && paren > 0)
+            paren -= 1;
+        else if (char === ":" && angle === 0 && brace === 0 && bracket === 0 && paren === 0) {
+            return index;
+        }
+    }
+    return -1;
+}
+function findTopLevelEquals(value) {
+    let angle = 0;
+    let brace = 0;
+    let bracket = 0;
+    let paren = 0;
+    for (let index = 0; index < value.length; index += 1) {
+        const char = value[index];
+        if (char === "<")
+            angle += 1;
+        else if (char === ">" && angle > 0)
+            angle -= 1;
+        else if (char === "{")
+            brace += 1;
+        else if (char === "}" && brace > 0)
+            brace -= 1;
+        else if (char === "[")
+            bracket += 1;
+        else if (char === "]" && bracket > 0)
+            bracket -= 1;
+        else if (char === "(")
+            paren += 1;
+        else if (char === ")" && paren > 0)
+            paren -= 1;
+        else if (char === "=" && angle === 0 && brace === 0 && bracket === 0 && paren === 0) {
+            return index;
+        }
+    }
+    return -1;
+}
+function parseParameter(rawParameter) {
+    const equalsIndex = findTopLevelEquals(rawParameter);
+    const declaration = equalsIndex === -1 ? rawParameter : rawParameter.slice(0, equalsIndex);
+    const normalized = normalizeSignaturePart(declaration);
+    const required = !/^\s*\.\.\./.test(declaration)
+        && !/^[^:=]+?\?\s*:/.test(declaration)
+        && equalsIndex === -1;
+    const colonIndex = findTopLevelColon(declaration);
+    const type = colonIndex === -1
+        ? normalized
+        : normalizeSignaturePart(declaration.slice(colonIndex + 1));
+    return { type, required };
+}
+function parseSignature(signature) {
+    if (signature === undefined) {
+        return null;
+    }
+    const openIndex = signature.indexOf("(");
+    if (openIndex === -1) {
+        return null;
+    }
+    const closeIndex = findMatchingParen(signature, openIndex);
+    if (closeIndex === -1) {
+        return null;
+    }
+    const parameterText = signature.slice(openIndex + 1, closeIndex).trim();
+    const parameters = parameterText.length === 0
+        ? []
+        : splitTopLevelCommaList(parameterText).map(parseParameter);
+    const trailing = signature.slice(closeIndex + 1).trim();
+    const returnType = trailing.startsWith(":")
+        ? normalizeSignaturePart(trailing.slice(1))
+        : "";
+    return { parameters, returnType };
+}
+function classifySignatureImpact(change) {
+    const previous = parseSignature(change.previousSignature);
+    const next = parseSignature(change.signature);
+    if (previous === null || next === null) {
+        return "major";
+    }
+    if (previous.returnType !== next.returnType) {
+        return "major";
+    }
+    for (let index = 0; index < previous.parameters.length; index += 1) {
+        const previousParam = previous.parameters[index];
+        const nextParam = next.parameters[index];
+        if (previousParam === undefined || nextParam === undefined) {
+            return "major";
+        }
+        if (previousParam.type !== nextParam.type) {
+            return "major";
+        }
+        if (!previousParam.required && nextParam.required) {
+            return "major";
+        }
+    }
+    const addedParameters = next.parameters.slice(previous.parameters.length);
+    if (addedParameters.some((parameter) => parameter.required)) {
+        return "major";
+    }
+    if (addedParameters.length > 0) {
+        return "minor";
+    }
+    return "patch";
+}
+function deriveSemverImpact(added, removed, changed) {
+    if (removed.length > 0)
+        return "major";
+    if (changed.some((change) => classifySignatureImpact(change) === "major"))
+        return "major";
+    if (added.length > 0)
+        return "minor";
+    if (changed.some((change) => classifySignatureImpact(change) === "minor"))
+        return "minor";
+    if (changed.length > 0)
+        return "patch";
+    return "none";
+}
+function buildSummary(added, removed, changed, semverImpact) {
+    const total = added.length + removed.length + changed.length;
+    if (total === 0)
+        return "No exported API changes.";
+    const parts = [];
+    if (added.length > 0)
+        parts.push(`+${String(added.length)} added`);
+    if (removed.length > 0)
+        parts.push(`-${String(removed.length)} removed`);
+    if (changed.length > 0)
+        parts.push(`~${String(changed.length)} changed`);
+    return `${parts.join(", ")} exported symbols. Semver impact: ${semverImpact}.`;
+}
+// ---- Public API -----------------------------------------------------------
+/**
+ * Compute the export surface diff between two git refs.
+ *
+ * Extracts outlines at both refs, filters to exported symbols, and
+ * classifies additions, removals, and signature changes. Derives
+ * the semver impact from the change set.
+ */
+export async function exportSurfaceDiff(opts) {
+    const { cwd, git } = opts;
+    const base = opts.base ?? "HEAD~1";
+    const head = opts.head ?? "HEAD";
+    const changedFiles = await getChangedFiles({ cwd, git, base, head });
+    const added = [];
+    const removed = [];
+    const changed = [];
+    for (const filePath of changedFiles) {
+        const baseContent = await getFileAtRef(base, filePath, { cwd, git });
+        const headContent = await getFileAtRef(head, filePath, { cwd, git });
+        const baseExports = extractExportedEntries(baseContent, filePath);
+        const headExports = extractExportedEntries(headContent, filePath);
+        // Detect added and changed exports
+        for (const [key, headEntry] of headExports) {
+            const baseEntry = baseExports.get(key);
+            if (baseEntry === undefined) {
+                added.push({
+                    symbol: headEntry.name,
+                    filePath,
+                    kind: headEntry.kind,
+                    changeType: "added",
+                    signature: headEntry.signature,
+                });
+            }
+            else if (headEntry.signature !== baseEntry.signature) {
+                changed.push({
+                    symbol: headEntry.name,
+                    filePath,
+                    kind: headEntry.kind,
+                    changeType: "signature_changed",
+                    signature: headEntry.signature,
+                    previousSignature: baseEntry.signature,
+                });
+            }
+        }
+        // Detect removed exports
+        for (const [key, baseEntry] of baseExports) {
+            if (!headExports.has(key)) {
+                removed.push({
+                    symbol: baseEntry.name,
+                    filePath,
+                    kind: baseEntry.kind,
+                    changeType: "removed",
+                    signature: baseEntry.signature,
+                });
+            }
+        }
+    }
+    const semverImpact = deriveSemverImpact(added, removed, changed);
+    const summary = buildSummary(added, removed, changed, semverImpact);
+    return { base, head, added, removed, changed, semverImpact, summary };
+}
+/** Serialize an ExportSurfaceDiffResult for MCP / CLI output. */
+export function exportSurfaceDiffToJson(result) {
+    return toJsonObject(result);
+}
+//# sourceMappingURL=export-surface-diff.js.map

package/dist/operations/export-surface-diff.js.map

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

package/dist/operations/footprint-parallelism.d.ts

@@ -0,0 +1,25 @@
+/** The structural footprint of a tool call. */
+export interface ToolFootprint {
+    readonly tool: string;
+    readonly files: readonly string[];
+    readonly symbols: readonly string[];
+}
+/**
+ * Compute the structural footprint of a tool call.
+ *
+ * Files and symbols that the call reads or writes. Two calls with
+ * non-overlapping footprints can run concurrently.
+ */
+export declare function computeFootprint(tool: string, args: Readonly<Record<string, unknown>>): ToolFootprint;
+/**
+ * Partition footprints into parallel groups.
+ *
+ * Each group contains footprints that can run concurrently (no
+ * overlaps within the group). Groups are ordered — group N+1
+ * runs after group N.
+ *
+ * Uses greedy graph coloring: for each footprint, place it in the
+ * first group that has no conflicts.
+ */
+export declare function findParallelGroups(footprints: readonly ToolFootprint[]): ToolFootprint[][];
+//# sourceMappingURL=footprint-parallelism.d.ts.map

package/dist/operations/footprint-parallelism.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"footprint-parallelism.d.ts","sourceRoot":"","sources":["../../src/operations/footprint-parallelism.ts"],"names":[],"mappings":"AAIA,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAUD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACtC,aAAa,CAqBf;AAeD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,SAAS,aAAa,EAAE,GACnC,aAAa,EAAE,EAAE,CAqBnB"}

package/dist/operations/footprint-parallelism.js

@@ -0,0 +1,79 @@
+// ---------------------------------------------------------------------------
+// Footprint Parallelism — discover concurrent-safe tool calls
+// ---------------------------------------------------------------------------
+/** Tools that have no structural footprint (diagnostics, status). */
+const ZERO_FOOTPRINT_TOOLS = new Set([
+    "daemon_status",
+    "daemon_monitors",
+    "causal_status",
+    "knowledge_map",
+]);
+/**
+ * Compute the structural footprint of a tool call.
+ *
+ * Files and symbols that the call reads or writes. Two calls with
+ * non-overlapping footprints can run concurrently.
+ */
+export function computeFootprint(tool, args) {
+    if (ZERO_FOOTPRINT_TOOLS.has(tool)) {
+        return { tool, files: [], symbols: [] };
+    }
+    const files = [];
+    const symbols = [];
+    // Extract path from common arg patterns
+    const pathArg = args["path"];
+    if (typeof pathArg === "string") {
+        files.push(pathArg);
+    }
+    // Extract symbol from common arg patterns
+    const symbolArg = args["symbol"] ?? args["name"];
+    if (typeof symbolArg === "string") {
+        symbols.push(symbolArg);
+    }
+    return { tool, files, symbols };
+}
+/**
+ * Check if two footprints overlap (share files or symbols).
+ */
+function overlaps(a, b) {
+    for (const file of a.files) {
+        if (b.files.includes(file))
+            return true;
+    }
+    for (const sym of a.symbols) {
+        if (b.symbols.includes(sym))
+            return true;
+    }
+    return false;
+}
+/**
+ * Partition footprints into parallel groups.
+ *
+ * Each group contains footprints that can run concurrently (no
+ * overlaps within the group). Groups are ordered — group N+1
+ * runs after group N.
+ *
+ * Uses greedy graph coloring: for each footprint, place it in the
+ * first group that has no conflicts.
+ */
+export function findParallelGroups(footprints) {
+    if (footprints.length === 0)
+        return [];
+    const groups = [];
+    for (const fp of footprints) {
+        let placed = false;
+        for (const group of groups) {
+            const conflicts = group.some((existing) => overlaps(existing, fp));
+            if (!conflicts) {
+                group.push(fp);
+                placed = true;
+                break;
+            }
+        }
+        if (!placed) {
+            groups.push([fp]);
+        }
+    }
+    return groups;
+}
+//# sourceMappingURL=footprint-parallelism.js.map

package/dist/operations/footprint-parallelism.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"footprint-parallelism.js","sourceRoot":"","sources":["../../src/operations/footprint-parallelism.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8DAA8D;AAC9D,8EAA8E;AAS9E,qEAAqE;AACrE,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,eAAe;IACf,iBAAiB;IACjB,eAAe;IACf,eAAe;CAChB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,IAAuC;IAEvC,IAAI,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,wCAAwC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IAED,0CAA0C;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ,CAAC,CAAgB,EAAE,CAAgB;IAClD,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IAC1C,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;IAC3C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAoC;IAEpC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEvC,MAAM,MAAM,GAAsB,EAAE,CAAC;IAErC,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;QAC5B,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;YACnE,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,MAAM,GAAG,IAAI,CAAC;gBACd,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/operations/graft-diff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graft-diff.d.ts","sourceRoot":"","sources":["../../src/operations/graft-diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD,OAAO,EAAgB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AAYD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,gBAAgB,EAAE,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,UAAU,CAAC;IACf,GAAG,EAAE,SAAS,CAAC;IACf,sBAAsB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IACrD,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,YAAY,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,gBAAgB,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;CACtH;AA4BD;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAkFhF"}
+{"version":3,"file":"graft-diff.d.ts","sourceRoot":"","sources":["../../src/operations/graft-diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD,OAAO,EAAgB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE9D,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AAYD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,gBAAgB,EAAE,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,UAAU,CAAC;IACf,GAAG,EAAE,SAAS,CAAC;IACf,sBAAsB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IACrD,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,YAAY,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,gBAAgB,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;CACtH;AA4BD;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAyFhF"}

package/dist/operations/graft-diff.js

@@ -1,4 +1,4 @@
-import { getChangedFiles, getFileAtRef } from "../git/diff.js";
+import { getChangedFilesWithStatus, getFileAtRef } from "../git/diff.js";
 import { detectLang } from "../parser/lang.js";
 import { extractOutline } from "../parser/outline.js";
 import { diffOutlines, OutlineDiff } from "../parser/diff.js";
@@ -40,7 +40,7 @@ export async function graftDiff(opts) {
     const base = opts.base ?? "HEAD";
     const headLabel = opts.head ?? "working tree";
     const cwd = opts.cwd;
-    let changedFiles = await getChangedFiles({
+    let changedEntries = await getChangedFilesWithStatus({
         cwd,
         git: opts.git,
         base,
@@ -48,13 +48,16 @@ export async function graftDiff(opts) {
     });
     // Filter by path if provided
     if (opts.path !== undefined) {
-        changedFiles = changedFiles.filter((f) => f === opts.path);
+        changedEntries = changedEntries.filter((f) => f.path === opts.path);
     }
     const files = [];
     const refused = [];
-    for (const filePath of changedFiles) {
+    for (const entry of changedEntries) {
+        const filePath = entry.path;
+        // For renames, read base content from the old path
+        const basePath = entry.oldPath ?? filePath;
         // Get content at base (null = file absent at ref)
-        const baseContent = await getFileAtRef(base, filePath, { cwd, git: opts.git });
+        const baseContent = await getFileAtRef(base, basePath, { cwd, git: opts.git });
         // Get content at head (null = file absent at ref/worktree)
         let headContent;
         if (opts.head !== undefined) {
@@ -68,9 +71,13 @@ export async function graftDiff(opts) {
                 headContent = null;
             }
         }
-        // Determine status
+        // Determine status — trust git's rename detection for renames,
+        // fall back to content-based detection for other statuses
         let status;
-        if (baseContent === null && headContent === null) {
+        if (entry.status === "renamed") {
+            status = "modified";
+        }
+        else if (baseContent === null && headContent === null) {
             // Both absent — file listed in diff but unreadable at both refs. Skip.
             continue;
         }

package/dist/operations/graft-diff.js.map

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

package/dist/operations/horizon-of-readability.d.ts

@@ -0,0 +1,23 @@
+/** Input metrics for horizon detection. */
+export interface HorizonInput {
+    readonly contentLines: number;
+    readonly contentBytes: number;
+    readonly outlineLines: number;
+    readonly outlineBytes: number;
+}
+/** Result of horizon detection. */
+export interface HorizonResult {
+    readonly horizonReached: boolean;
+    readonly compressionRatio: number;
+    readonly recommendation: "outline" | "content";
+    readonly message?: string;
+}
+/**
+ * Detect whether the readability horizon has been reached.
+ *
+ * When the outline is nearly as large as the content (compression
+ * ratio > threshold), the file is irreducibly complex for the
+ * outline representation. Return full content instead.
+ */
+export declare function detectReadabilityHorizon(input: HorizonInput): HorizonResult;
+//# sourceMappingURL=horizon-of-readability.d.ts.map

package/dist/operations/horizon-of-readability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"horizon-of-readability.d.ts","sourceRoot":"","sources":["../../src/operations/horizon-of-readability.ts"],"names":[],"mappings":"AAIA,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,mCAAmC;AACnC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAKD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CA6B3E"}

package/dist/operations/horizon-of-readability.js

@@ -0,0 +1,39 @@
+// ---------------------------------------------------------------------------
+// Horizon of Readability — detect when projection can't reduce further
+// ---------------------------------------------------------------------------
+/** Compression ratio threshold above which outline provides negligible savings. */
+const HORIZON_THRESHOLD = 0.7;
+/**
+ * Detect whether the readability horizon has been reached.
+ *
+ * When the outline is nearly as large as the content (compression
+ * ratio > threshold), the file is irreducibly complex for the
+ * outline representation. Return full content instead.
+ */
+export function detectReadabilityHorizon(input) {
+    const { contentBytes, outlineBytes } = input;
+    // Zero-size files are at the horizon (nothing to simplify)
+    if (contentBytes === 0) {
+        return {
+            horizonReached: true,
+            compressionRatio: 1,
+            recommendation: "content",
+            message: "Empty file — full content provided.",
+        };
+    }
+    const compressionRatio = outlineBytes / contentBytes;
+    if (compressionRatio >= HORIZON_THRESHOLD) {
+        return {
+            horizonReached: true,
+            compressionRatio,
+            recommendation: "content",
+            message: `Outline is ${String(Math.round(compressionRatio * 100))}% of content — cannot simplify further. Full content provided.`,
+        };
+    }
+    return {
+        horizonReached: false,
+        compressionRatio,
+        recommendation: "outline",
+    };
+}
+//# sourceMappingURL=horizon-of-readability.js.map

package/dist/operations/horizon-of-readability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"horizon-of-readability.js","sourceRoot":"","sources":["../../src/operations/horizon-of-readability.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,uEAAuE;AACvE,8EAA8E;AAkB9E,mFAAmF;AACnF,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAmB;IAC1D,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;IAE7C,2DAA2D;IAC3D,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,cAAc,EAAE,IAAI;YACpB,gBAAgB,EAAE,CAAC;YACnB,cAAc,EAAE,SAAS;YACzB,OAAO,EAAE,qCAAqC;SAC/C,CAAC;IACJ,CAAC;IAED,MAAM,gBAAgB,GAAG,YAAY,GAAG,YAAY,CAAC;IAErD,IAAI,gBAAgB,IAAI,iBAAiB,EAAE,CAAC;QAC1C,OAAO;YACL,cAAc,EAAE,IAAI;YACpB,gBAAgB;YAChB,cAAc,EAAE,SAAS;YACzB,OAAO,EAAE,cAAc,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,GAAG,CAAC,CAAC,gEAAgE;SAClI,CAAC;IACJ,CAAC;IAED,OAAO;QACL,cAAc,EAAE,KAAK;QACrB,gBAAgB;QAChB,cAAc,EAAE,SAAS;KAC1B,CAAC;AACJ,CAAC"}

package/dist/operations/import-reference-impact.d.ts

@@ -0,0 +1,13 @@
+import type { GitClient } from "../ports/git.js";
+import type { PathOps } from "../ports/paths.js";
+import type { ReferenceCountResult } from "./structural-review.js";
+export interface ImportReferenceImpactOptions {
+    readonly cwd: string;
+    readonly git: GitClient;
+    readonly pathOps: PathOps;
+    readonly symbolName: string;
+    readonly filePath: string;
+    readonly ref: string;
+}
+export declare function countNamedImportReferencesAtRef(opts: ImportReferenceImpactOptions): Promise<ReferenceCountResult>;
+//# sourceMappingURL=import-reference-impact.d.ts.map

package/dist/operations/import-reference-impact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-reference-impact.d.ts","sourceRoot":"","sources":["../../src/operations/import-reference-impact.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAKnE,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAgGD,wBAAsB,+BAA+B,CACnD,IAAI,EAAE,4BAA4B,GACjC,OAAO,CAAC,oBAAoB,CAAC,CA4B/B"}