patchwork-os 0.2.0-alpha.0

package/dist/tools/fixAllLintErrors.d.ts

@@ -0,0 +1,66 @@
+import { type ExtensionClient } from "../extensionClient.js";
+import type { ProbeResults } from "../probe.js";
+export declare function createFixAllLintErrorsTool(workspace: string, probes: ProbeResults, extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+            idempotentHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                filePath: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                fixed: {
+                    type: string;
+                };
+                source: {
+                    type: string;
+                };
+                changes: {
+                    type: string;
+                };
+                fixerUsed: {
+                    type: string;
+                };
+                linesBeforeCount: {
+                    type: string;
+                };
+                linesAfterCount: {
+                    type: string;
+                };
+                stdout: {
+                    type: string;
+                };
+                stderr: {
+                    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/fixAllLintErrors.js

@@ -0,0 +1,128 @@
+import fs from "node:fs";
+import path from "node:path";
+import { ExtensionTimeoutError, } from "../extensionClient.js";
+import { error, execSafe, requireString, resolveFilePath, successStructured, } from "./utils.js";
+const JS_FIXERS = [
+    { cmd: "eslint", args: (f) => ["--fix", f], probe: "eslint" },
+    { cmd: "biome", args: (f) => ["check", "--write", f], probe: "biome" },
+];
+const PY_FIXERS = [
+    { cmd: "ruff", args: (f) => ["check", "--fix", f], probe: "ruff" },
+];
+const EXT_FIXERS = {
+    ".ts": JS_FIXERS,
+    ".tsx": JS_FIXERS,
+    ".js": JS_FIXERS,
+    ".jsx": JS_FIXERS,
+    ".py": PY_FIXERS,
+};
+export function createFixAllLintErrorsTool(workspace, probes, extensionClient) {
+    return {
+        schema: {
+            name: "fixAllLintErrors",
+            description: "Auto-fix lint errors. VS Code source.fixAll when connected, falls back to eslint/biome/ruff.",
+            annotations: { destructiveHint: true, idempotentHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "File to fix (relative or absolute path)",
+                    },
+                },
+                required: ["filePath"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    fixed: { type: "boolean" },
+                    source: { type: "string" },
+                    changes: { type: "string" },
+                    fixerUsed: { type: "string" },
+                    linesBeforeCount: { type: "integer" },
+                    linesAfterCount: { type: "integer" },
+                    stdout: { type: "string" },
+                    stderr: { type: "string" },
+                },
+                required: ["fixed"],
+            },
+        },
+        handler: async (args, signal) => {
+            const rawPath = requireString(args, "filePath");
+            const resolved = resolveFilePath(rawPath, workspace, { write: true });
+            let contentBefore;
+            try {
+                contentBefore = fs.readFileSync(resolved, "utf-8");
+            }
+            catch {
+                return error({ error: `File not found: ${rawPath}` });
+            }
+            // Try extension first
+            if (extensionClient.isConnected()) {
+                try {
+                    const result = await extensionClient.fixAllLintErrors(resolved);
+                    if (result !== null) {
+                        const contentAfter = fs.readFileSync(resolved, "utf-8");
+                        return successStructured({
+                            fixed: true,
+                            source: "extension",
+                            changes: contentBefore === contentAfter ? "none" : "modified",
+                            linesBeforeCount: contentBefore.split("\n").length,
+                            linesAfterCount: contentAfter.split("\n").length,
+                        });
+                    }
+                }
+                catch (err) {
+                    if (!(err instanceof ExtensionTimeoutError))
+                        throw err;
+                    // Timeout — fall through to CLI fallback
+                }
+            }
+            // CLI fallback
+            const ext = path.extname(resolved).toLowerCase();
+            const candidates = EXT_FIXERS[ext];
+            if (!candidates || candidates.length === 0) {
+                return error({
+                    fixed: false,
+                    source: "cli",
+                    error: `No lint fixer configured for extension "${ext}"`,
+                });
+            }
+            const fixer = candidates.find((f) => probes[f.probe]);
+            if (!fixer) {
+                const names = candidates.map((f) => f.cmd).join(", ");
+                return error({
+                    fixed: false,
+                    source: "cli",
+                    error: `No available lint fixer found. Tried: ${names}`,
+                });
+            }
+            const result = await execSafe(fixer.cmd, fixer.args(resolved), {
+                cwd: workspace,
+                timeout: 30_000,
+                signal,
+            });
+            if (result.exitCode !== 0) {
+                return error({
+                    fixed: false,
+                    source: "cli",
+                    fixerUsed: fixer.cmd,
+                    error: result.stderr,
+                });
+            }
+            const contentAfter = fs.readFileSync(resolved, "utf-8");
+            return successStructured({
+                fixed: true,
+                source: "cli",
+                fixerUsed: fixer.cmd,
+                changes: contentBefore === contentAfter ? "none" : "modified",
+                linesBeforeCount: contentBefore.split("\n").length,
+                linesAfterCount: contentAfter.split("\n").length,
+                stdout: result.stdout,
+                stderr: result.stderr,
+            });
+        },
+    };
+}
+//# sourceMappingURL=fixAllLintErrors.js.map

package/dist/tools/fixAllLintErrors.js.map

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

package/dist/tools/foldingRanges.d.ts

@@ -0,0 +1,50 @@
+import type { ExtensionClient } from "../extensionClient.js";
+export declare function createFoldingRangesTool(workspace: string, extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        extensionRequired: boolean;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                filePath: {
+                    type: "string";
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                ranges: {
+                    type: "array";
+                    items: {
+                        type: "object";
+                    };
+                };
+                count: {
+                    type: "number";
+                };
+            };
+            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/foldingRanges.js

@@ -0,0 +1,51 @@
+import { lspColdStartError, lspWithRetry } from "./lsp.js";
+import { extensionRequired, requireString, resolveFilePath, successStructured, } from "./utils.js";
+export function createFoldingRangesTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "foldingRanges",
+            extensionRequired: true,
+            description: "Foldable regions in a file (functions, classes, imports, comments). Returns {startLine, endLine, kind}.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Workspace or absolute file path",
+                    },
+                },
+                required: ["filePath"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    ranges: {
+                        type: "array",
+                        items: { type: "object" },
+                    },
+                    count: { type: "number" },
+                },
+                required: ["ranges", "count"],
+            },
+        },
+        handler: async (args, signal) => {
+            const filePath = resolveFilePath(requireString(args, "filePath"), workspace);
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("foldingRanges (LSP folding regions)", [
+                    "Use getDocumentSymbols to get the structural outline of the file",
+                ]);
+            }
+            const result = await lspWithRetry(() => extensionClient.foldingRanges(filePath, signal), signal);
+            if (result === "timeout")
+                return lspColdStartError();
+            if (result === null) {
+                return successStructured({ ranges: [], count: 0 });
+            }
+            const data = result;
+            return successStructured({ ...data, count: data.ranges.length });
+        },
+    };
+}
+//# sourceMappingURL=foldingRanges.js.map

package/dist/tools/foldingRanges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foldingRanges.js","sourceRoot":"","sources":["../../src/tools/foldingRanges.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,MAAM,UAAU,uBAAuB,CACrC,SAAiB,EACjB,eAAgC;IAEhC,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,eAAe;YACrB,iBAAiB,EAAE,IAAI;YACvB,WAAW,EACT,yGAAyG;YAC3G,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;YACnC,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAiB;wBACvB,WAAW,EAAE,iCAAiC;qBAC/C;iBACF;gBACD,QAAQ,EAAE,CAAC,UAAU,CAAC;gBACtB,oBAAoB,EAAE,KAAc;aACrC;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,MAAM,EAAE;wBACN,IAAI,EAAE,OAAgB;wBACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;qBACnC;oBACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;iBACnC;gBACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;aAC9B;SACF;QACD,OAAO,EAAE,KAAK,EAAE,IAA6B,EAAE,MAAoB,EAAE,EAAE;YACrE,MAAM,QAAQ,GAAG,eAAe,CAC9B,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,EAC/B,SAAS,CACV,CAAC;YACF,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC;gBACnC,OAAO,iBAAiB,CAAC,qCAAqC,EAAE;oBAC9D,kEAAkE;iBACnE,CAAC,CAAC;YACL,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B,GAAG,EAAE,CAAC,eAAe,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,EACrD,MAAM,CACP,CAAC;YACF,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,iBAAiB,EAAE,CAAC;YACrD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,OAAO,iBAAiB,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YACrD,CAAC;YACD,MAAM,IAAI,GAAG,MAA+B,CAAC;YAC7C,OAAO,iBAAiB,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACnE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/formatAndSave.d.ts

@@ -0,0 +1,57 @@
+import type { ProgressFn } from "../transport.js";
+import type { createFormatDocumentTool } from "./formatDocument.js";
+import type { createSaveDocumentTool } from "./saveDocument.js";
+type FormatDocumentTool = ReturnType<typeof createFormatDocumentTool>;
+type SaveDocumentTool = ReturnType<typeof createSaveDocumentTool>;
+export declare function createFormatAndSaveTool(deps: {
+    formatDocument: FormatDocumentTool;
+    saveDocument: SaveDocumentTool;
+}): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+            idempotentHint: boolean;
+        };
+        inputSchema: {
+            $schema: string;
+            type: "object";
+            additionalProperties: false;
+            required: string[];
+            properties: {
+                filePath: {
+                    type: "string";
+                    description: string;
+                };
+            };
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                formatted: {
+                    type: string;
+                };
+                changes: {
+                    type: string;
+                };
+                saved: {
+                    type: string;
+                };
+                source: {
+                    type: string;
+                };
+                message: {
+                    type: string;
+                };
+            };
+        };
+    };
+    handler(args: Record<string, unknown>, signal?: AbortSignal, progress?: ProgressFn): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+};
+export {};

package/dist/tools/formatAndSave.js

@@ -0,0 +1,87 @@
+/**
+ * formatAndSave — composite tool that runs formatDocument and saveDocument
+ * in one call. Eliminates the race window between formatting a buffer and
+ * persisting it, and cuts the common "format then save" workflow from two
+ * tool calls to one.
+ *
+ * Implementation notes (from v2.25.25 session plan):
+ * - formatDocument returns `error({...})` on many failure paths
+ *   (file-not-found, unsupported extension, non-zero exit). Guard against
+ *   result.isError BEFORE reading structuredContent, otherwise we crash.
+ * - saveDocument may also error. Propagate in the same way.
+ * - Both tools take { filePath } as their first arg in identical shape.
+ * - This is a composite factory: it takes the already-constructed
+ *   formatDocument + saveDocument tool instances so their handlers (and
+ *   therefore their fallback logic) are reused as-is, not duplicated.
+ */
+import { err, okS, toCallToolResult } from "../fp/result.js";
+import { requireString } from "./utils.js";
+export function createFormatAndSaveTool(deps) {
+    return {
+        schema: {
+            name: "formatAndSave",
+            description: "Format a file and save it in one call (formatDocument + saveDocument). Formatter errors propagate; save is not attempted on format failure.",
+            annotations: { destructiveHint: true, idempotentHint: true },
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                additionalProperties: false,
+                required: ["filePath"],
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Path to the file (absolute or workspace-relative)",
+                    },
+                },
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    formatted: { type: "boolean" },
+                    changes: { type: "string" },
+                    saved: { type: "boolean" },
+                    source: { type: "string" },
+                    message: { type: "string" },
+                },
+            },
+        },
+        async handler(args, signal, progress) {
+            const filePath = requireString(args, "filePath");
+            // Step 1: format — reuse the existing tool's handler so all of its
+            // extension/CLI fallback logic is preserved.
+            const fmt = await deps.formatDocument.handler({ filePath }, signal, progress);
+            if ("isError" in fmt && fmt.isError)
+                return fmt;
+            const fmtData = fmt
+                .structuredContent;
+            if (!fmtData || typeof fmtData !== "object") {
+                return toCallToolResult(err("unknown", "formatDocument returned unexpected shape (no structuredContent)"));
+            }
+            // Step 2: save — reuse the existing tool's handler.
+            const save = await deps.saveDocument.handler({ filePath });
+            if ("isError" in save && save.isError)
+                return save;
+            const saveData = save
+                .structuredContent;
+            if (!saveData || typeof saveData !== "object") {
+                return toCallToolResult(err("unknown", "saveDocument returned unexpected shape (no structuredContent)"));
+            }
+            return toCallToolResult(okS({
+                formatted: fmtData.formatted ?? false,
+                changes: fmtData.changes ?? "unknown",
+                saved: saveData.saved ?? false,
+                source: saveData.source ?? fmtData.source ?? "unknown",
+                ...(typeof fmtData.linesBeforeCount === "number" && {
+                    linesBeforeCount: fmtData.linesBeforeCount,
+                }),
+                ...(typeof fmtData.linesAfterCount === "number" && {
+                    linesAfterCount: fmtData.linesAfterCount,
+                }),
+                ...(typeof saveData.message === "string" && {
+                    message: saveData.message,
+                }),
+            }));
+        },
+    };
+}
+//# sourceMappingURL=formatAndSave.js.map

package/dist/tools/formatAndSave.js.map

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

package/dist/tools/formatDocument.d.ts

@@ -0,0 +1,61 @@
+import { type ExtensionClient } from "../extensionClient.js";
+import type { ProbeResults } from "../probe.js";
+import type { ProgressFn } from "../transport.js";
+export declare function createFormatDocumentTool(workspace: string, probes: ProbeResults, extensionClient: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+            idempotentHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                filePath: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                formatted: {
+                    type: string;
+                };
+                source: {
+                    type: string;
+                };
+                changes: {
+                    type: string;
+                };
+                formatterUsed: {
+                    type: string;
+                };
+                linesBeforeCount: {
+                    type: string;
+                };
+                linesAfterCount: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler: (args: Record<string, unknown>, signal?: AbortSignal, progress?: ProgressFn) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};

package/dist/tools/formatDocument.js

@@ -0,0 +1,144 @@
+import fs from "node:fs";
+import path from "node:path";
+import { ExtensionTimeoutError, } from "../extensionClient.js";
+import { error, execSafe, requireString, resolveFilePath, successStructured, } from "./utils.js";
+const JS_FORMATTERS = [
+    { cmd: "prettier", args: (f) => ["--write", f], probe: "prettier" },
+    { cmd: "biome", args: (f) => ["format", "--write", f], probe: "biome" },
+];
+const PY_FORMATTERS = [
+    { cmd: "black", args: (f) => [f], probe: "black" },
+    { cmd: "ruff", args: (f) => ["format", f], probe: "ruff" },
+];
+const GO_FORMATTERS = [
+    { cmd: "gofmt", args: (f) => ["-w", f], probe: "gofmt" },
+];
+const RS_FORMATTERS = [
+    { cmd: "rustfmt", args: (f) => [f], probe: "rustfmt" },
+];
+const EXT_FORMATTERS = {
+    ".ts": JS_FORMATTERS,
+    ".tsx": JS_FORMATTERS,
+    ".js": JS_FORMATTERS,
+    ".jsx": JS_FORMATTERS,
+    ".py": PY_FORMATTERS,
+    ".go": GO_FORMATTERS,
+    ".rs": RS_FORMATTERS,
+};
+export function createFormatDocumentTool(workspace, probes, extensionClient) {
+    return {
+        schema: {
+            name: "formatDocument",
+            description: "Format file via VS Code formatter or CLI fallback (prettier/biome/black/gofmt/rustfmt).",
+            annotations: { destructiveHint: true, idempotentHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "File to format (relative or absolute path)",
+                    },
+                },
+                required: ["filePath"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    formatted: { type: "boolean" },
+                    source: { type: "string" },
+                    changes: { type: "string" },
+                    formatterUsed: { type: "string" },
+                    linesBeforeCount: { type: "integer" },
+                    linesAfterCount: { type: "integer" },
+                },
+                required: ["formatted"],
+            },
+        },
+        handler: async (args, signal, progress) => {
+            progress?.(0, 100);
+            const rawPath = requireString(args, "filePath");
+            const resolved = resolveFilePath(rawPath, workspace, { write: true });
+            // Read file content before formatting
+            let contentBefore;
+            try {
+                contentBefore = fs.readFileSync(resolved, "utf-8");
+            }
+            catch {
+                return error({ error: `File not found: ${rawPath}` });
+            }
+            // Try extension first
+            if (extensionClient.isConnected()) {
+                try {
+                    const result = await extensionClient.formatDocument(resolved);
+                    if (result !== null) {
+                        // Read file content after formatting
+                        const contentAfter = fs.readFileSync(resolved, "utf-8");
+                        if (contentBefore === contentAfter) {
+                            return successStructured({
+                                formatted: true,
+                                source: "extension",
+                                changes: "none",
+                            });
+                        }
+                        return successStructured({
+                            formatted: true,
+                            source: "extension",
+                            changes: "modified",
+                            linesBeforeCount: contentBefore.split("\n").length,
+                            linesAfterCount: contentAfter.split("\n").length,
+                        });
+                    }
+                }
+                catch (err) {
+                    if (!(err instanceof ExtensionTimeoutError))
+                        throw err;
+                    // Timeout — fall through to CLI fallback
+                }
+            }
+            // CLI fallback
+            const ext = path.extname(resolved).toLowerCase();
+            const candidates = EXT_FORMATTERS[ext];
+            if (!candidates || candidates.length === 0) {
+                return error({
+                    formatted: false,
+                    source: "cli",
+                    error: `No formatter configured for extension "${ext}"`,
+                });
+            }
+            const formatter = candidates.find((f) => probes[f.probe]);
+            if (!formatter) {
+                const names = candidates.map((f) => f.cmd).join(", ");
+                return error({
+                    formatted: false,
+                    source: "cli",
+                    error: `No available formatter found. Tried: ${names}`,
+                });
+            }
+            const result = await execSafe(formatter.cmd, formatter.args(resolved), {
+                cwd: workspace,
+                timeout: 30_000,
+                signal,
+            });
+            if (result.exitCode !== 0) {
+                return error({
+                    formatted: false,
+                    source: "cli",
+                    formatterUsed: formatter.cmd,
+                    error: result.stderr,
+                });
+            }
+            const contentAfter = fs.readFileSync(resolved, "utf-8");
+            progress?.(100, 100);
+            return successStructured({
+                formatted: true,
+                source: "cli",
+                formatterUsed: formatter.cmd,
+                changes: contentBefore === contentAfter ? "none" : "modified",
+                linesBeforeCount: contentBefore.split("\n").length,
+                linesAfterCount: contentAfter.split("\n").length,
+            });
+        },
+    };
+}
+//# sourceMappingURL=formatDocument.js.map