@flyingrobots/graft 0.6.1 → 0.7.1

package/dist/operations/session-filtration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-filtration.d.ts","sourceRoot":"","sources":["../../src/operations/session-filtration.ts"],"names":[],"mappings":"AAIA,8CAA8C;AAC9C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,kCAAkC;AAClC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,mBAAmB,EAAE,SAAS,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAQrE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,CAuB7E"}

package/dist/operations/session-filtration.js

@@ -0,0 +1,48 @@
+// ---------------------------------------------------------------------------
+// Session Filtration — accumulation-aware projection escalation
+// ---------------------------------------------------------------------------
+const ESCALATION_THRESHOLD = 0.5;
+/**
+ * Compute the filtration level for the current session.
+ *
+ * Ranges from 0 (fresh session) to 1 (fully saturated). Based on
+ * the fraction of files observed and the number of re-reads.
+ * As filtration grows, graft escalates detail — an agent that has
+ * already explored the codebase should get richer projections.
+ */
+export function computeFiltrationLevel(input) {
+    const { observedFiles, totalFiles, reReadCount } = input;
+    if (totalFiles === 0)
+        return 0;
+    const coverageFraction = observedFiles / totalFiles;
+    const reReadBoost = Math.min(reReadCount / 20, 0.3);
+    return Math.min(coverageFraction + reReadBoost, 1);
+}
+/**
+ * Determine whether to escalate projection detail for a re-read.
+ *
+ * Monotone accumulation: as filtration grows, graft escalates.
+ * An agent that outlined a directory and is now re-reading a file
+ * in that directory should get content instead of another outline.
+ */
+export function shouldEscalateDetail(input) {
+    const { filtrationLevel, previousProjection, readCount } = input;
+    // Never escalate on first read
+    if (readCount <= 1) {
+        return { escalate: false, suggestedProjection: previousProjection };
+    }
+    // Already at content — nothing to escalate to
+    if (previousProjection === "content") {
+        return { escalate: false, suggestedProjection: "content" };
+    }
+    // Escalate when filtration is high enough and this is a re-read
+    if (filtrationLevel >= ESCALATION_THRESHOLD) {
+        return {
+            escalate: true,
+            suggestedProjection: "content",
+            reason: `Filtration level ${String(Math.round(filtrationLevel * 100))}% — escalating from outline to content for re-read.`,
+        };
+    }
+    return { escalate: false, suggestedProjection: previousProjection };
+}
+//# sourceMappingURL=session-filtration.js.map

package/dist/operations/session-filtration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-filtration.js","sourceRoot":"","sources":["../../src/operations/session-filtration.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gEAAgE;AAChE,8EAA8E;AAuB9E,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAsB;IAC3D,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IACzD,IAAI,UAAU,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAE/B,MAAM,gBAAgB,GAAG,aAAa,GAAG,UAAU,CAAC;IACpD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;IAEpD,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAsB;IACzD,MAAM,EAAE,eAAe,EAAE,kBAAkB,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAEjE,+BAA+B;IAC/B,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACnB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;IACtE,CAAC;IAED,8CAA8C;IAC9C,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,CAAC;IAC7D,CAAC;IAED,gEAAgE;IAChE,IAAI,eAAe,IAAI,oBAAoB,EAAE,CAAC;QAC5C,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,mBAAmB,EAAE,SAAS;YAC9B,MAAM,EAAE,oBAAoB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC,qDAAqD;SAC3H,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;AACtE,CAAC"}

package/dist/operations/session-replay.d.ts

@@ -0,0 +1,17 @@
+/** A single tool call extracted from NDJSON receipts. */
+export interface ReplayEntry {
+    readonly tool: string;
+    readonly path?: string;
+    readonly symbol?: string;
+    readonly ts: string;
+    readonly sessionId: string;
+}
+/**
+ * Parse NDJSON receipt lines into replay entries for a given session.
+ */
+export declare function parseReceiptsForReplay(ndjson: string, sessionId: string): ReplayEntry[];
+/**
+ * Render replay entries as a Markdown summary.
+ */
+export declare function renderReplayMarkdown(entries: readonly ReplayEntry[]): string;
+//# sourceMappingURL=session-replay.d.ts.map

package/dist/operations/session-replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-replay.d.ts","sourceRoot":"","sources":["../../src/operations/session-replay.ts"],"names":[],"mappings":"AAIA,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CA2BvF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAwB5E"}

package/dist/operations/session-replay.js

@@ -0,0 +1,59 @@
+// ---------------------------------------------------------------------------
+// Structural Session Replay — render a session as a structural walkthrough
+// ---------------------------------------------------------------------------
+/**
+ * Parse NDJSON receipt lines into replay entries for a given session.
+ */
+export function parseReceiptsForReplay(ndjson, sessionId) {
+    const entries = [];
+    for (const line of ndjson.split("\n")) {
+        const trimmed = line.trim();
+        if (trimmed.length === 0)
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch {
+            continue;
+        }
+        if (parsed["sessionId"] !== sessionId)
+            continue;
+        if (typeof parsed["tool"] !== "string")
+            continue;
+        entries.push({
+            tool: parsed["tool"],
+            ...(typeof parsed["path"] === "string" ? { path: parsed["path"] } : {}),
+            ...(typeof parsed["symbol"] === "string" ? { symbol: parsed["symbol"] } : {}),
+            ts: typeof parsed["ts"] === "string" ? parsed["ts"] : "",
+            sessionId,
+        });
+    }
+    return entries;
+}
+/**
+ * Render replay entries as a Markdown summary.
+ */
+export function renderReplayMarkdown(entries) {
+    if (entries.length === 0) {
+        return "# Session Replay\n\nNo activity recorded for this session.\n";
+    }
+    const lines = [
+        "# Session Replay",
+        "",
+        `**${String(entries.length)} tool calls**`,
+        "",
+        "| # | Tool | Target | Time |",
+        "|---|------|--------|------|",
+    ];
+    for (let i = 0; i < entries.length; i++) {
+        const e = entries[i] ?? { tool: "", ts: "", sessionId: "" };
+        const target = e.symbol !== undefined
+            ? `${e.path ?? ""}:${e.symbol}`
+            : (e.path ?? "—");
+        lines.push(`| ${String(i + 1)} | ${e.tool} | ${target} | ${e.ts} |`);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+//# sourceMappingURL=session-replay.js.map

package/dist/operations/session-replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-replay.js","sourceRoot":"","sources":["../../src/operations/session-replay.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,2EAA2E;AAC3E,8EAA8E;AAW9E;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAc,EAAE,SAAiB;IACtE,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEnC,IAAI,MAA+B,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,SAAS;YAAE,SAAS;QAChD,IAAI,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ;YAAE,SAAS;QAEjD,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YACpB,GAAG,CAAC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,GAAG,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7E,EAAE,EAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;YACxD,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA+B;IAClE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,8DAA8D,CAAC;IACxE,CAAC;IAED,MAAM,KAAK,GAAa;QACtB,kBAAkB;QAClB,EAAE;QACF,KAAK,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe;QAC1C,EAAE;QACF,8BAA8B;QAC9B,8BAA8B;KAC/B,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QAC5D,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,KAAK,SAAS;YACnC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC,MAAM,EAAE;YAC/B,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/operations/sludge-detector.d.ts

@@ -0,0 +1,45 @@
+import type { FileSystem } from "../ports/filesystem.js";
+import type { GitClient } from "../ports/git.js";
+export type SludgeSignalKind = "phantom_shape" | "cast_density" | "homeless_constructor" | "free_function_data_behavior" | "god_file";
+export type SludgeSeverity = "low" | "medium" | "high";
+export interface SludgeSignal {
+    readonly kind: SludgeSignalKind;
+    readonly severity: SludgeSeverity;
+    readonly message: string;
+    readonly line?: number;
+    readonly symbol?: string;
+    readonly evidence: string;
+}
+export interface SludgeMetrics {
+    readonly typedefCount: number;
+    readonly typeCastCount: number;
+    readonly classCount: number;
+    readonly functionCount: number;
+    readonly symbolCount: number;
+    readonly homelessConstructorCount: number;
+    readonly freeFunctionDataBehaviorCount: number;
+}
+export interface SludgeFileReport {
+    readonly path: string;
+    readonly score: number;
+    readonly metrics: SludgeMetrics;
+    readonly signals: readonly SludgeSignal[];
+}
+export interface SludgeReport {
+    readonly scannedFiles: number;
+    readonly filesWithSignals: number;
+    readonly totalSignals: number;
+    readonly score: number;
+    readonly files: readonly SludgeFileReport[];
+    readonly summary: string;
+}
+export interface DetectSludgeOptions {
+    readonly cwd: string;
+    readonly fs: FileSystem;
+    readonly git: GitClient;
+    readonly resolvePath: (filePath: string) => string;
+    readonly path?: string;
+}
+export declare function analyzeSludgeFile(filePath: string, source: string): SludgeFileReport | null;
+export declare function detectSludge(options: DetectSludgeOptions): Promise<SludgeReport>;
+//# sourceMappingURL=sludge-detector.d.ts.map

package/dist/operations/sludge-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sludge-detector.d.ts","sourceRoot":"","sources":["../../src/operations/sludge-detector.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GACxB,eAAe,GACf,cAAc,GACd,sBAAsB,GACtB,6BAA6B,GAC7B,UAAU,CAAC;AAEf,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEvD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,6BAA6B,EAAE,MAAM,CAAC;CAChD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAiKD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAmG3F;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAmCtF"}

package/dist/operations/sludge-detector.js

@@ -0,0 +1,278 @@
+import { detectLang } from "../parser/lang.js";
+import { extractOutlineForFile } from "../parser/outline.js";
+import { parseStructuredTreeForFile } from "../parser/runtime.js";
+const CONSTRUCTOR_PREFIXES = ["build", "create", "make", "assemble"];
+function walk(node, visit) {
+    visit(node);
+    for (const child of node.namedChildren) {
+        walk(child, visit);
+    }
+}
+function countOutlineEntries(entries, predicate) {
+    let count = 0;
+    for (const entry of entries) {
+        if (predicate(entry))
+            count++;
+        if (entry.children !== undefined) {
+            count += countOutlineEntries(entry.children, predicate);
+        }
+    }
+    return count;
+}
+function collectTypeNames(entries) {
+    const names = new Set();
+    for (const entry of entries) {
+        if (entry.kind === "class" || entry.kind === "interface" || entry.kind === "type") {
+            names.add(entry.name);
+        }
+        if (entry.children !== undefined) {
+            for (const childName of collectTypeNames(entry.children)) {
+                names.add(childName);
+            }
+        }
+    }
+    return names;
+}
+function startsWithConstructorPrefix(name) {
+    const lower = name.toLowerCase();
+    return CONSTRUCTOR_PREFIXES.some((prefix) => lower.startsWith(prefix) && lower.length > prefix.length);
+}
+function isPlainObjectExpression(node) {
+    if (node === null)
+        return false;
+    if (node.type === "object")
+        return true;
+    if (node.type !== "parenthesized_expression")
+        return false;
+    return node.namedChildren.some((child) => child.type === "object");
+}
+function returnsPlainObject(node) {
+    const body = node.childForFieldName("body");
+    if (isPlainObjectExpression(body))
+        return true;
+    let found = false;
+    const searchRoot = body ?? node;
+    walk(searchRoot, (child) => {
+        if (found || child.type !== "return_statement")
+            return;
+        found = isPlainObjectExpression(child.namedChildren[0] ?? null);
+    });
+    return found;
+}
+function normalizedTypeName(typeAnnotation) {
+    if (typeAnnotation === null)
+        return null;
+    let text = typeAnnotation.text.trim();
+    if (text.startsWith(":")) {
+        text = text.slice(1).trim();
+    }
+    let end = text.length;
+    for (let index = 0; index < text.length; index++) {
+        const char = text[index];
+        if (char === "<" || char === " " || char === "|" || char === "&" || char === "[" || char === ".") {
+            end = index;
+            break;
+        }
+    }
+    const name = text.slice(0, end).trim();
+    return name.length > 0 ? name : null;
+}
+function firstParameterType(functionNode) {
+    const parameters = functionNode.childForFieldName("parameters");
+    const firstParameter = parameters?.namedChildren[0];
+    if (firstParameter === undefined)
+        return null;
+    return normalizedTypeName(firstParameter.childForFieldName("type"));
+}
+function functionFact(name, node) {
+    return {
+        name,
+        line: node.startPosition.row + 1,
+        firstParameterType: firstParameterType(node),
+        returnsPlainObject: returnsPlainObject(node),
+    };
+}
+function declarationFunctionFacts(node) {
+    if (node.type === "function_declaration" || node.type === "generator_function_declaration") {
+        const name = node.childForFieldName("name")?.text;
+        return name !== undefined ? [functionFact(name, node)] : [];
+    }
+    if (node.type !== "lexical_declaration")
+        return [];
+    const facts = [];
+    for (const declarator of node.namedChildren) {
+        if (declarator.type !== "variable_declarator")
+            continue;
+        const name = declarator.childForFieldName("name")?.text;
+        const value = declarator.childForFieldName("value");
+        if (name === undefined || value === null)
+            continue;
+        if (value.type === "arrow_function" || value.type === "function") {
+            facts.push(functionFact(name, value));
+        }
+    }
+    return facts;
+}
+function topLevelFunctionFacts(root) {
+    const facts = [];
+    for (const child of root.namedChildren) {
+        if (child.type === "export_statement") {
+            for (const exportedChild of child.namedChildren) {
+                facts.push(...declarationFunctionFacts(exportedChild));
+            }
+            continue;
+        }
+        facts.push(...declarationFunctionFacts(child));
+    }
+    return facts;
+}
+function severityScore(severity) {
+    if (severity === "high")
+        return 3;
+    if (severity === "medium")
+        return 2;
+    return 1;
+}
+function containsTypeTag(comment) {
+    return comment.includes("@type ") || comment.includes("@type{") || comment.includes("@type\t");
+}
+function buildSummary(report) {
+    if (report.scannedFiles === 0) {
+        return "No supported source files scanned.";
+    }
+    if (report.totalSignals === 0) {
+        return `No sludge signals found across ${String(report.scannedFiles)} files.`;
+    }
+    return `${String(report.totalSignals)} sludge signals across ${String(report.filesWithSignals)} of ${String(report.scannedFiles)} scanned files.`;
+}
+export function analyzeSludgeFile(filePath, source) {
+    if (detectLang(filePath) === null)
+        return null;
+    const outline = extractOutlineForFile(filePath, source);
+    const parsed = parseStructuredTreeForFile(filePath, source);
+    if (outline === null || parsed === null)
+        return null;
+    try {
+        let typedefCount = 0;
+        let typeCastCount = 0;
+        for (const child of parsed.root.children) {
+            walk(child, (node) => {
+                if (node.type !== "comment")
+                    return;
+                if (node.text.includes("@typedef"))
+                    typedefCount++;
+                if (containsTypeTag(node.text))
+                    typeCastCount++;
+            });
+        }
+        const typeNames = collectTypeNames(outline.entries);
+        const classCount = countOutlineEntries(outline.entries, (entry) => entry.kind === "class");
+        const functionCount = countOutlineEntries(outline.entries, (entry) => entry.kind === "function");
+        const symbolCount = countOutlineEntries(outline.entries, () => true);
+        const functions = topLevelFunctionFacts(parsed.root);
+        const signals = [];
+        if (typedefCount > 0 && typedefCount >= classCount) {
+            const severity = typedefCount >= 3 && classCount === 0 ? "high" : "medium";
+            signals.push({
+                kind: "phantom_shape",
+                severity,
+                message: "JSDoc typedefs outnumber class declarations.",
+                evidence: `${String(typedefCount)} typedefs, ${String(classCount)} classes`,
+            });
+        }
+        if (typeCastCount >= 3) {
+            signals.push({
+                kind: "cast_density",
+                severity: typeCastCount >= 6 ? "high" : "medium",
+                message: "Dense JSDoc type casts suggest the type system is being hand-held.",
+                evidence: `${String(typeCastCount)} @type comments`,
+            });
+        }
+        let homelessConstructorCount = 0;
+        let freeFunctionDataBehaviorCount = 0;
+        for (const fact of functions) {
+            if (startsWithConstructorPrefix(fact.name) && fact.returnsPlainObject) {
+                homelessConstructorCount++;
+                signals.push({
+                    kind: "homeless_constructor",
+                    severity: "medium",
+                    message: "Factory-like free function returns a plain object instead of owning behavior on a type.",
+                    line: fact.line,
+                    symbol: fact.name,
+                    evidence: "returns object literal",
+                });
+            }
+            if (fact.firstParameterType !== null && typeNames.has(fact.firstParameterType)) {
+                freeFunctionDataBehaviorCount++;
+                signals.push({
+                    kind: "free_function_data_behavior",
+                    severity: "low",
+                    message: "Free function takes a project type as its first parameter.",
+                    line: fact.line,
+                    symbol: fact.name,
+                    evidence: `first parameter type ${fact.firstParameterType}`,
+                });
+            }
+        }
+        if (symbolCount > 30) {
+            signals.push({
+                kind: "god_file",
+                severity: symbolCount > 60 ? "high" : "medium",
+                message: "Single file exposes a large number of structural symbols.",
+                evidence: `${String(symbolCount)} outline entries`,
+            });
+        }
+        const score = signals.reduce((sum, signal) => sum + severityScore(signal.severity), 0);
+        return {
+            path: filePath,
+            score,
+            metrics: {
+                typedefCount,
+                typeCastCount,
+                classCount,
+                functionCount,
+                symbolCount,
+                homelessConstructorCount,
+                freeFunctionDataBehaviorCount,
+            },
+            signals,
+        };
+    }
+    finally {
+        parsed.delete();
+    }
+}
+export async function detectSludge(options) {
+    const args = ["ls-files"];
+    if (options.path !== undefined) {
+        args.push("--", options.path);
+    }
+    const result = await options.git.run({ cwd: options.cwd, args });
+    const candidatePaths = result.status === 0
+        ? result.stdout.split("\n").map((line) => line.trim()).filter((line) => line.length > 0)
+        : [];
+    const supportedPaths = candidatePaths.filter((filePath) => detectLang(filePath) !== null);
+    const files = [];
+    for (const filePath of supportedPaths) {
+        const source = await options.fs.readFile(options.resolvePath(filePath), "utf-8").catch(() => null);
+        if (source === null)
+            continue;
+        const report = analyzeSludgeFile(filePath, source);
+        if (report !== null && report.signals.length > 0) {
+            files.push(report);
+        }
+    }
+    files.sort((left, right) => right.score - left.score || left.path.localeCompare(right.path));
+    const withoutSummary = {
+        scannedFiles: supportedPaths.length,
+        filesWithSignals: files.length,
+        totalSignals: files.reduce((sum, file) => sum + file.signals.length, 0),
+        score: files.reduce((sum, file) => sum + file.score, 0),
+        files,
+    };
+    return {
+        ...withoutSummary,
+        summary: buildSummary(withoutSummary),
+    };
+}
+//# sourceMappingURL=sludge-detector.js.map

package/dist/operations/sludge-detector.js.map

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

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

@@ -0,0 +1,67 @@
+import type { JsonObject } from "../contracts/json-object.js";
+export interface CommitInfo {
+    readonly sha: string;
+    readonly author: string;
+    readonly date: string;
+    readonly message: string;
+}
+export interface LastSignatureChange extends CommitInfo {
+    readonly previousSignature?: string | undefined;
+}
+export interface BlameHistoryEntry {
+    readonly sha: string;
+    readonly changeKind: string;
+    readonly date: string;
+    readonly author: string;
+    readonly signature?: string | undefined;
+}
+export interface StructuralBlameResult {
+    readonly symbol: string;
+    readonly filePath?: string | undefined;
+    readonly currentSignature?: string | undefined;
+    readonly kind: string;
+    readonly exported: boolean;
+    readonly created?: CommitInfo | undefined;
+    readonly lastSignatureChange?: LastSignatureChange | undefined;
+    readonly changeCount: number;
+    readonly referenceCount: number;
+    readonly referencingFiles: readonly string[];
+    readonly history: readonly BlameHistoryEntry[];
+}
+/** A single commit entry from the WARP symbol history. */
+export interface SymbolCommitInput {
+    readonly sha: string;
+    readonly changeKind: string;
+    readonly signature?: string | undefined;
+}
+/** Git metadata for a commit. */
+export interface CommitMetaInput {
+    readonly author: string;
+    readonly date: string;
+    readonly message: string;
+}
+/** Symbol metadata from the most recent commit's WARP observation. */
+export interface SymbolMetaInput {
+    readonly kind: string;
+    readonly exported: boolean;
+}
+export interface StructuralBlameInput {
+    readonly symbolName: string;
+    readonly filePath?: string | undefined;
+    /** The symbol's commit history from WARP. */
+    readonly commits: readonly SymbolCommitInput[];
+    /** Git metadata keyed by commit SHA. */
+    readonly commitMeta: ReadonlyMap<string, CommitMetaInput>;
+    /** Symbol kind/exported from the latest WARP observation. */
+    readonly symbolMeta?: SymbolMetaInput | undefined;
+    /** Reference count from the reference-counting query. */
+    readonly referenceCount: number;
+    /** Files referencing this symbol. */
+    readonly referencingFiles: readonly string[];
+}
+export declare function structuralBlame(input: StructuralBlameInput): StructuralBlameResult;
+/**
+ * Convert a StructuralBlameResult to a plain JsonObject for MCP responses.
+ */
+export declare function structuralBlameToJson(result: StructuralBlameResult): JsonObject;
+//# sourceMappingURL=structural-blame.d.ts.map

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

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