patchwork-os 0.2.0-alpha.0

package/dist/tools/previewEdit.js

@@ -0,0 +1,270 @@
+import fs from "node:fs";
+import { error, optionalBool, optionalInt, optionalString, requireString, resolveFilePath, successStructured, } from "./utils.js";
+/**
+ * Compute a simple unified diff between two arrays of lines.
+ * Returns unified diff lines (with +/- prefixes and @@ headers).
+ */
+export function computeUnifiedDiff(originalLines, newLines, filePath, contextLines = 3) {
+    const ops = [];
+    const m = originalLines.length;
+    const n = newLines.length;
+    // Build LCS table
+    const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+    for (let i = m - 1; i >= 0; i--) {
+        for (let j = n - 1; j >= 0; j--) {
+            if (originalLines[i] === newLines[j]) {
+                dp[i][j] = (dp[i + 1]?.[j + 1] ?? 0) + 1;
+            }
+            else {
+                dp[i][j] = Math.max(dp[i + 1]?.[j] ?? 0, dp[i]?.[j + 1] ?? 0);
+            }
+        }
+    }
+    // Trace back through LCS
+    let i = 0;
+    let j = 0;
+    while (i < m || j < n) {
+        if (i < m && j < n && originalLines[i] === newLines[j]) {
+            ops.push({ type: "equal", line: originalLines[i] });
+            i++;
+            j++;
+        }
+        else if (j < n &&
+            (i >= m || (dp[i + 1]?.[j] ?? 0) <= (dp[i]?.[j + 1] ?? 0))) {
+            ops.push({ type: "insert", line: newLines[j] });
+            j++;
+        }
+        else {
+            ops.push({ type: "delete", line: originalLines[i] });
+            i++;
+        }
+    }
+    // Count changes
+    let linesAdded = 0;
+    let linesRemoved = 0;
+    for (const op of ops) {
+        if (op.type === "insert")
+            linesAdded++;
+        else if (op.type === "delete")
+            linesRemoved++;
+    }
+    if (linesAdded === 0 && linesRemoved === 0) {
+        return { diff: "", linesAdded: 0, linesRemoved: 0 };
+    }
+    // Build unified diff with context
+    const diffLines = [`--- a/${filePath}`, `+++ b/${filePath}`];
+    // Group ops into hunks with context
+    const changeIndices = [];
+    for (let k = 0; k < ops.length; k++) {
+        if (ops[k].type !== "equal")
+            changeIndices.push(k);
+    }
+    const hunks = [];
+    if (changeIndices.length > 0) {
+        let hunkStart = Math.max(0, changeIndices[0] - contextLines);
+        let hunkEnd = Math.min(ops.length - 1, changeIndices[0] + contextLines);
+        for (let k = 1; k < changeIndices.length; k++) {
+            const gapStart = changeIndices[k - 1] + contextLines + 1;
+            const gapEnd = changeIndices[k] - contextLines - 1;
+            if (gapStart <= gapEnd) {
+                hunks.push([hunkStart, hunkEnd]);
+                hunkStart = Math.max(0, changeIndices[k] - contextLines);
+            }
+            hunkEnd = Math.min(ops.length - 1, changeIndices[k] + contextLines);
+        }
+        hunks.push([hunkStart, hunkEnd]);
+    }
+    // Render hunks
+    for (const [hStart, hEnd] of hunks) {
+        const hunkOps = ops.slice(hStart, hEnd + 1);
+        // Compute original and new line numbers
+        let origLine = 1;
+        let newLine = 1;
+        // Count ops before hStart to get starting line numbers
+        for (let k = 0; k < hStart; k++) {
+            const op = ops[k];
+            if (op.type === "equal" || op.type === "delete")
+                origLine++;
+            if (op.type === "equal" || op.type === "insert")
+                newLine++;
+        }
+        const origCount = hunkOps.filter((o) => o.type === "equal" || o.type === "delete").length;
+        const newCount = hunkOps.filter((o) => o.type === "equal" || o.type === "insert").length;
+        diffLines.push(`@@ -${origLine},${origCount} +${newLine},${newCount} @@`);
+        for (const op of hunkOps) {
+            if (op.type === "equal")
+                diffLines.push(` ${op.line}`);
+            else if (op.type === "delete")
+                diffLines.push(`-${op.line}`);
+            else
+                diffLines.push(`+${op.line}`);
+        }
+    }
+    return {
+        diff: diffLines.join("\n"),
+        linesAdded,
+        linesRemoved,
+    };
+}
+/**
+ * Apply a searchReplace operation to content and return the new content.
+ */
+export function applySearchReplace(content, search, replace, useRegex, caseSensitive = true) {
+    if (useRegex) {
+        const flags = caseSensitive ? "g" : "gi";
+        const re = new RegExp(search, flags);
+        return content.replace(re, replace);
+    }
+    // Literal string replace all occurrences
+    const parts = caseSensitive
+        ? content.split(search)
+        : content.split(new RegExp(escapeRegex(search), "gi"));
+    return parts.join(replace);
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Apply a lineRange replacement to content and return the new content.
+ */
+export function applyLineRange(content, startLine, endLine, newContent) {
+    const lines = content.split("\n");
+    const before = lines.slice(0, startLine - 1);
+    const after = lines.slice(endLine);
+    const replacement = newContent.endsWith("\n")
+        ? newContent.slice(0, -1).split("\n")
+        : newContent.split("\n");
+    return [...before, ...replacement, ...after].join("\n");
+}
+export function createPreviewEditTool(workspace) {
+    return {
+        schema: {
+            name: "previewEdit",
+            description: "Preview what editText or searchAndReplace would do as a unified diff, without writing to disk.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                required: ["filePath", "operation"],
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Workspace-relative or absolute path to the file",
+                    },
+                    operation: {
+                        type: "string",
+                        enum: ["lineRange", "searchReplace"],
+                        description: "Type of edit to preview",
+                    },
+                    startLine: {
+                        type: "integer",
+                        description: "Start line (1-based, lineRange only)",
+                    },
+                    endLine: {
+                        type: "integer",
+                        description: "End line inclusive (1-based, lineRange only)",
+                    },
+                    newContent: {
+                        type: "string",
+                        description: "Replacement content for the line range",
+                    },
+                    search: {
+                        type: "string",
+                        description: "Pattern to search for (searchReplace only)",
+                    },
+                    replace: {
+                        type: "string",
+                        description: "Replacement text (searchReplace only)",
+                    },
+                    useRegex: {
+                        type: "boolean",
+                        description: "Treat search as a regex (searchReplace only, default false)",
+                    },
+                    caseSensitive: {
+                        type: "boolean",
+                        description: "Case-sensitive search (searchReplace only, default true)",
+                    },
+                },
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    diff: { type: "string" },
+                    linesAdded: { type: "integer" },
+                    linesRemoved: { type: "integer" },
+                    preview: {
+                        type: "array",
+                        items: { type: "string" },
+                    },
+                    unchanged: { type: "boolean" },
+                },
+                required: ["diff", "linesAdded", "linesRemoved", "preview"],
+            },
+        },
+        handler: async (args, _signal) => {
+            const rawPath = requireString(args, "filePath");
+            const operation = requireString(args, "operation");
+            if (operation !== "lineRange" && operation !== "searchReplace") {
+                return error('operation must be "lineRange" or "searchReplace"');
+            }
+            let resolved;
+            try {
+                resolved = resolveFilePath(rawPath, workspace);
+            }
+            catch (e) {
+                return error(`Invalid path: ${e instanceof Error ? e.message : String(e)}`);
+            }
+            let originalContent;
+            try {
+                originalContent = await fs.promises.readFile(resolved, "utf-8");
+            }
+            catch {
+                return error(`File not found: ${resolved}`);
+            }
+            let newContent;
+            if (operation === "lineRange") {
+                const startLine = optionalInt(args, "startLine", 1) ?? 1;
+                const rawEnd = args.endLine;
+                const totalLines = originalContent.split("\n").length;
+                const endLine = typeof rawEnd === "number" ? rawEnd : totalLines;
+                const replacement = optionalString(args, "newContent") ?? "";
+                if (startLine > endLine) {
+                    return error("startLine must be <= endLine");
+                }
+                if (startLine < 1) {
+                    return error("startLine must be >= 1");
+                }
+                newContent = applyLineRange(originalContent, startLine, endLine, replacement);
+            }
+            else {
+                const search = optionalString(args, "search") ?? "";
+                const replace = optionalString(args, "replace") ?? "";
+                const useRegex = optionalBool(args, "useRegex") ?? false;
+                const caseSensitive = optionalBool(args, "caseSensitive") ?? true;
+                if (!search) {
+                    return error("search must not be empty for searchReplace operation");
+                }
+                try {
+                    newContent = applySearchReplace(originalContent, search, replace, useRegex, caseSensitive);
+                }
+                catch (e) {
+                    return error(`Invalid regex: ${e instanceof Error ? e.message : String(e)}`);
+                }
+            }
+            const originalLines = originalContent.split("\n");
+            const newLines = newContent.split("\n");
+            const relativePath = rawPath.startsWith("/")
+                ? rawPath.slice(workspace.length + 1)
+                : rawPath;
+            const { diff, linesAdded, linesRemoved } = computeUnifiedDiff(originalLines, newLines, relativePath);
+            return successStructured({
+                diff,
+                linesAdded,
+                linesRemoved,
+                preview: newLines,
+                unchanged: linesAdded === 0 && linesRemoved === 0,
+            });
+        },
+    };
+}
+//# sourceMappingURL=previewEdit.js.map

package/dist/tools/previewEdit.js.map

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

package/dist/tools/recentTracesDigest.d.ts

@@ -0,0 +1,35 @@
+import type { ActivityLog } from "../activityLog.js";
+import type { CommitIssueLinkLog } from "../commitIssueLinkLog.js";
+import type { DecisionTraceLog } from "../decisionTraceLog.js";
+import type { RecipeRunLog } from "../runLog.js";
+/**
+ * Cold-start trace digest injected into session instructions.
+ *
+ * Agents reading the instructions see recent cross-session decisions
+ * (approvals / enrichment links / recipe runs) without having to query
+ * ctxQueryTraces first. Strictly read-only, strictly bounded.
+ *
+ * Budget: ≤2 KB total. Top 5 traces, summary + relative time only.
+ * No bodies, no full keys — just enough signal to answer
+ * "has something like this happened recently?"
+ */
+export interface RecentTracesDigestDeps {
+    activityLog?: ActivityLog | null;
+    commitIssueLinkLog?: CommitIssueLinkLog | null;
+    recipeRunLog?: RecipeRunLog | null;
+    decisionTraceLog?: DecisionTraceLog | null;
+}
+interface FormatOptions {
+    windowMs?: number;
+    topN?: number;
+    now?: number;
+}
+/**
+ * Build the digest as an array of lines (including the heading and
+ * indentation). Returns empty array if there's nothing to show.
+ *
+ * The caller decides how to join/embed these — buildInstructions() pushes
+ * them into its `lines` array alongside the other sections.
+ */
+export declare function buildRecentTracesDigest(deps: RecentTracesDigestDeps, options?: FormatOptions): Promise<string[]>;
+export {};

package/dist/tools/recentTracesDigest.js

@@ -0,0 +1,98 @@
+import { createCtxQueryTracesTool } from "./ctxQueryTraces.js";
+const DEFAULT_WINDOW_MS = 12 * 60 * 60 * 1000; // 12 hours
+const DEFAULT_TOP_N = 5;
+const MAX_BYTES = 2_048;
+const MAX_SUMMARY_CHARS = 80;
+const TYPE_ICON = {
+    approval: "•",
+    enrichment: "⇄",
+    recipe_run: "▸",
+    decision: "★",
+};
+function relTime(ms, now) {
+    const diff = Math.max(0, now - ms);
+    const s = Math.floor(diff / 1000);
+    if (s < 60)
+        return `${s}s ago`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}m ago`;
+    const h = Math.floor(m / 60);
+    if (h < 24)
+        return `${h}h ago`;
+    const d = Math.floor(h / 24);
+    return `${d}d ago`;
+}
+function truncate(s, max) {
+    return s.length <= max ? s : `${s.slice(0, max - 1)}…`;
+}
+/**
+ * Render a single digest line. Decision traces carry ref + tags + solution
+ * that matter for agent self-triage, so we surface them explicitly instead
+ * of collapsing into the generic summary. Other trace types use the summary
+ * as-is — they don't share the ref/tag shape.
+ */
+function formatTraceLine(t, now) {
+    const when = relTime(t.ts, now);
+    if (t.traceType === "decision") {
+        const ref = String(t.body.ref ?? t.key);
+        const solution = typeof t.body.solution === "string" ? t.body.solution : t.summary;
+        const tags = Array.isArray(t.body.tags)
+            ? t.body.tags
+                .filter((x) => typeof x === "string")
+                .slice(0, 3)
+            : [];
+        const tagPart = tags.length > 0 ? ` [${tags.join(",")}]` : "";
+        // Budget: ref + tags + " — <when>" are fixed; truncate solution to fit.
+        const prefix = `${ref}${tagPart} `;
+        const suffix = ` — ${when}`;
+        const budget = MAX_SUMMARY_CHARS - prefix.length - suffix.length;
+        const body = budget > 10 ? truncate(solution, budget) : "";
+        return `${prefix}${body}${suffix}`;
+    }
+    return `${truncate(t.summary, MAX_SUMMARY_CHARS)} — ${when}`;
+}
+/**
+ * Build the digest as an array of lines (including the heading and
+ * indentation). Returns empty array if there's nothing to show.
+ *
+ * The caller decides how to join/embed these — buildInstructions() pushes
+ * them into its `lines` array alongside the other sections.
+ */
+export async function buildRecentTracesDigest(deps, options = {}) {
+    const windowMs = options.windowMs ?? DEFAULT_WINDOW_MS;
+    const topN = options.topN ?? DEFAULT_TOP_N;
+    const now = options.now ?? Date.now();
+    // If no sources are available, skip the section entirely.
+    if (!deps.activityLog &&
+        !deps.commitIssueLinkLog &&
+        !deps.recipeRunLog &&
+        !deps.decisionTraceLog) {
+        return [];
+    }
+    const tool = createCtxQueryTracesTool(deps);
+    const result = await tool.handler({
+        since: Math.max(0, now - windowMs),
+        limit: Math.max(topN * 2, 20),
+    });
+    const structured = result
+        .structuredContent;
+    const traces = structured?.traces ?? [];
+    if (traces.length === 0)
+        return [];
+    const top = traces.slice(0, topN);
+    const lines = ["RECENT DECISIONS (last 12h):"];
+    for (const t of top) {
+        const icon = TYPE_ICON[t.traceType] ?? "·";
+        lines.push(`  ${icon} ${formatTraceLine(t, now)}`);
+    }
+    // Hard byte cap — keep dropping oldest entries until under budget.
+    while (lines.join("\n").length > MAX_BYTES && lines.length > 1) {
+        lines.pop();
+    }
+    // If only the heading survived, drop it too (nothing useful to say).
+    if (lines.length <= 1)
+        return [];
+    return lines;
+}
+//# sourceMappingURL=recentTracesDigest.js.map

package/dist/tools/recentTracesDigest.js.map

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

package/dist/tools/refactorAnalyze.d.ts

@@ -0,0 +1,78 @@
+import type { ExtensionClient } from "../extensionClient.js";
+export declare function createRefactorAnalyzeTool(workspace: string, extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        extensionRequired: boolean;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                filePath: {
+                    type: "string";
+                    description: string;
+                };
+                line: {
+                    type: "integer";
+                    description: string;
+                };
+                column: {
+                    type: "integer";
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                canRename: {
+                    type: string;
+                };
+                renameReason: {
+                    anyOf: {
+                        type: string;
+                    }[];
+                };
+                renamePlaceholder: {
+                    anyOf: {
+                        type: string;
+                    }[];
+                };
+                referenceCount: {
+                    type: string;
+                };
+                callerCount: {
+                    type: string;
+                };
+                hasInheritance: {
+                    type: string;
+                };
+                risk: {
+                    type: string;
+                    enum: string[];
+                };
+                summary: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler: (args: Record<string, unknown>, signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};

package/dist/tools/refactorAnalyze.js

@@ -0,0 +1,141 @@
+import { extensionRequired, requireInt, requireString, resolveFilePath, successStructured, } from "./utils.js";
+function computeRisk(referenceCount, callerCount, hasInheritance) {
+    if (referenceCount > 20 || callerCount > 10 || hasInheritance)
+        return "high";
+    if (referenceCount < 5 && callerCount < 3 && !hasInheritance)
+        return "low";
+    return "medium";
+}
+export function createRefactorAnalyzeTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "refactorAnalyze",
+            extensionRequired: true,
+            description: "Refactor impact: rename safety, ref/caller counts, risk level (low/medium/high). Use before renameSymbol.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Workspace or absolute path",
+                    },
+                    line: {
+                        type: "integer",
+                        description: "Line number (1-based)",
+                    },
+                    column: {
+                        type: "integer",
+                        description: "Column (1-based)",
+                    },
+                },
+                required: ["filePath", "line", "column"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    canRename: { type: "boolean" },
+                    renameReason: { anyOf: [{ type: "string" }, { type: "null" }] },
+                    renamePlaceholder: { anyOf: [{ type: "string" }, { type: "null" }] },
+                    referenceCount: { type: "integer" },
+                    callerCount: { type: "integer" },
+                    hasInheritance: { type: "boolean" },
+                    risk: { type: "string", enum: ["low", "medium", "high"] },
+                    summary: { type: "string" },
+                },
+                required: [
+                    "canRename",
+                    "referenceCount",
+                    "callerCount",
+                    "hasInheritance",
+                    "risk",
+                    "summary",
+                ],
+            },
+        },
+        handler: async (args, signal) => {
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("refactorAnalyze", [
+                    "Use findReferences to count references manually",
+                    "Use getCallHierarchy to inspect callers",
+                    "Use getTypeHierarchy to check inheritance",
+                ]);
+            }
+            const filePath = resolveFilePath(requireString(args, "filePath"), workspace);
+            const line = requireInt(args, "line", 1);
+            const column = requireInt(args, "column", 1);
+            const compositeSignal = AbortSignal.any([
+                ...(signal ? [signal] : []),
+                AbortSignal.timeout(15_000),
+            ]);
+            const [prepareResult, referencesResult, callHierarchyResult, typeHierarchyResult,] = await Promise.allSettled([
+                extensionClient.prepareRename(filePath, line, column, compositeSignal),
+                extensionClient.findReferences(filePath, line, column, compositeSignal),
+                extensionClient.getCallHierarchy(filePath, line, column, "incoming", 50, compositeSignal),
+                extensionClient.getTypeHierarchy(filePath, line, column, undefined, undefined, compositeSignal),
+            ]);
+            // Rename safety
+            const prepareData = prepareResult.status === "fulfilled" ? prepareResult.value : null;
+            const canRename = prepareData !== null &&
+                typeof prepareData === "object" &&
+                prepareData.canRename !== false;
+            const renameReason = prepareData !== null &&
+                typeof prepareData === "object" &&
+                "reason" in prepareData
+                ? String(prepareData.reason)
+                : null;
+            const renamePlaceholder = prepareData !== null &&
+                typeof prepareData === "object" &&
+                "placeholder" in prepareData
+                ? String(prepareData.placeholder)
+                : null;
+            // Reference count
+            const referencesData = referencesResult.status === "fulfilled" ? referencesResult.value : null;
+            const referenceCount = referencesData !== null &&
+                typeof referencesData === "object" &&
+                "references" in referencesData
+                ? (referencesData.references?.length ??
+                    0)
+                : 0;
+            // Caller count
+            const callHierarchyData = callHierarchyResult.status === "fulfilled"
+                ? callHierarchyResult.value
+                : null;
+            const callerCount = callHierarchyData !== null &&
+                typeof callHierarchyData === "object" &&
+                "incoming" in callHierarchyData
+                ? (callHierarchyData.incoming
+                    ?.length ?? 0)
+                : 0;
+            // Inheritance
+            const typeHierarchyData = typeHierarchyResult.status === "fulfilled"
+                ? typeHierarchyResult.value
+                : null;
+            const hasInheritance = typeHierarchyData !== null &&
+                typeof typeHierarchyData === "object" &&
+                ("supertypes" in typeHierarchyData ||
+                    "subtypes" in typeHierarchyData);
+            const risk = computeRisk(referenceCount, callerCount, hasInheritance);
+            const parts = [];
+            if (!canRename)
+                parts.push("rename not supported");
+            parts.push(`${referenceCount} reference${referenceCount !== 1 ? "s" : ""}`);
+            parts.push(`${callerCount} caller${callerCount !== 1 ? "s" : ""}`);
+            if (hasInheritance)
+                parts.push("has inheritance relationships");
+            const summary = `Risk: ${risk} — ${parts.join(", ")}.`;
+            return successStructured({
+                canRename,
+                renameReason,
+                renamePlaceholder,
+                referenceCount,
+                callerCount,
+                hasInheritance,
+                risk,
+                summary,
+            });
+        },
+    };
+}
+//# sourceMappingURL=refactorAnalyze.js.map

package/dist/tools/refactorAnalyze.js.map

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