patchwork-os 0.2.0-alpha.0

package/dist/tools/getDocumentSymbols.d.ts

@@ -0,0 +1,74 @@
+import { type ExtensionClient } from "../extensionClient.js";
+export declare function createGetDocumentSymbolsTool(workspace: string, extensionClient?: ExtensionClient): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                filePath: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                symbols: {
+                    type: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            name: {
+                                type: string;
+                            };
+                            kind: {
+                                type: string;
+                            };
+                            line: {
+                                type: string;
+                            };
+                            column: {
+                                type: string;
+                            };
+                            parent: {
+                                type: string[];
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                count: {
+                    type: string;
+                };
+                source: {
+                    type: string;
+                    enum: string[];
+                };
+                note: {
+                    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/getDocumentSymbols.js

@@ -0,0 +1,177 @@
+import fs from "node:fs";
+import { ExtensionTimeoutError, } from "../extensionClient.js";
+import { error, execSafe, languageIdFromPath, requireString, resolveFilePath, successStructured, } from "./utils.js";
+// Language-specific patterns to detect symbol definitions (grep fallback)
+const SYMBOL_PATTERNS = {
+    typescript: String.raw `^\s*(export\s+)?(default\s+)?(abstract\s+)?(class|interface|type|enum|function|async\s+function|const|let|var)\s+\w`,
+    typescriptreact: String.raw `^\s*(export\s+)?(default\s+)?(abstract\s+)?(class|interface|type|enum|function|async\s+function|const|let|var)\s+\w`,
+    javascript: String.raw `^\s*(export\s+)?(default\s+)?(class|function|async\s+function|const|let|var)\s+\w`,
+    javascriptreact: String.raw `^\s*(export\s+)?(default\s+)?(class|function|async\s+function|const|let|var)\s+\w`,
+    python: String.raw `^\s*(class|def|async\s+def)\s+\w`,
+    rust: String.raw `^\s*(pub\s+)?(pub\s*\(.*\)\s+)?(fn|struct|enum|trait|impl|type|mod|const|static)\s+\w`,
+    go: String.raw `^(func|type|var|const)\s+\w`,
+};
+export function createGetDocumentSymbolsTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "getDocumentSymbols",
+            description: "List symbols (fns, classes, interfaces, methods) in a file: names, kinds, lines, parents.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Workspace or absolute path to the file",
+                    },
+                },
+                required: ["filePath"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    symbols: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                name: { type: "string" },
+                                kind: { type: "string" },
+                                line: { type: "integer" },
+                                column: { type: "integer" },
+                                parent: { type: ["string", "null"] },
+                            },
+                            required: ["name", "kind", "line"],
+                        },
+                    },
+                    count: { type: "integer" },
+                    source: {
+                        type: "string",
+                        enum: ["lsp", "grep-fallback", "unavailable"],
+                    },
+                    note: { type: "string" },
+                },
+                required: ["symbols", "count", "source"],
+            },
+        },
+        handler: async (args, signal) => {
+            const rawPath = requireString(args, "filePath");
+            const filePath = resolveFilePath(rawPath, workspace);
+            // Extension path: full LSP document symbols
+            if (extensionClient?.isConnected()) {
+                try {
+                    const result = await extensionClient.getDocumentSymbols(filePath, signal);
+                    if (result !== null && typeof result === "object") {
+                        const r = result;
+                        // Cap symbols array at 500 to avoid bloating context on large bundled files.
+                        const DOCUMENT_SYMBOLS_MAX = 500;
+                        if (Array.isArray(r.symbols) &&
+                            r.symbols.length > DOCUMENT_SYMBOLS_MAX) {
+                            const full = r.symbols;
+                            return successStructured({
+                                ...r,
+                                symbols: full.slice(0, DOCUMENT_SYMBOLS_MAX),
+                                source: "lsp",
+                                truncated: true,
+                                totalCount: full.length,
+                            });
+                        }
+                        return successStructured({ ...r, source: "lsp" });
+                    }
+                    // null means LSP not ready for this file — fall through to grep
+                }
+                catch (err) {
+                    if (err instanceof ExtensionTimeoutError) {
+                        return error("Language server timed out getting document symbols — it may still be indexing. " +
+                            "Wait a few seconds and try again, or use the grep-based fallback by disconnecting the extension.");
+                    }
+                    // other errors (disconnect mid-call) — fall through to grep
+                }
+            }
+            // Grep fallback: regex-based symbol detection
+            const langId = languageIdFromPath(filePath);
+            const pattern = SYMBOL_PATTERNS[langId];
+            if (!pattern) {
+                // No pattern — just return empty with a note
+                return successStructured({
+                    symbols: [],
+                    count: 0,
+                    source: "unavailable",
+                    note: `No symbol patterns available for language '${langId}'. Connect the VS Code extension for LSP-based symbols.`,
+                });
+            }
+            if (!fs.existsSync(filePath)) {
+                return error(`File not found: ${filePath}`);
+            }
+            const rgResult = await execSafe("rg", ["-n", "--no-heading", "-e", pattern, filePath], {
+                cwd: workspace,
+                timeout: 10_000,
+                maxBuffer: 256 * 1024,
+            });
+            if (!rgResult.stdout.trim()) {
+                return successStructured({
+                    symbols: [],
+                    count: 0,
+                    source: "grep-fallback",
+                });
+            }
+            const symbols = [];
+            for (const line of rgResult.stdout.split("\n")) {
+                if (!line)
+                    continue;
+                const m = line.match(/^(\d+):(.*)$/);
+                if (!m)
+                    continue;
+                const lineNum = Number.parseInt(m[1] ?? "0", 10);
+                const text = (m[2] ?? "").trim();
+                // Extract symbol name and kind from the matched line
+                const symMatch = text.match(/(?:export\s+)?(?:default\s+)?(?:abstract\s+)?(?:pub\s+(?:\(.*?\)\s+)?)?(?:async\s+)?(class|interface|type|enum|function|const|let|var|fn|struct|trait|impl|mod|def|type)\s+(\w+)/);
+                if (!symMatch)
+                    continue;
+                const kindRaw = symMatch[1] ?? "";
+                const name = symMatch[2] ?? "";
+                const kind = kindToSymbolKind(kindRaw);
+                symbols.push({ name, kind, line: lineNum, parent: null });
+            }
+            return successStructured({
+                symbols,
+                count: symbols.length,
+                source: "grep-fallback",
+            });
+        },
+    };
+}
+function kindToSymbolKind(raw) {
+    switch (raw) {
+        case "class":
+            return "Class";
+        case "interface":
+            return "Interface";
+        case "type":
+            return "TypeParameter";
+        case "enum":
+            return "Enum";
+        case "function":
+        case "fn":
+        case "def":
+            return "Function";
+        case "const":
+            return "Constant";
+        case "let":
+        case "var":
+            return "Variable";
+        case "struct":
+            return "Struct";
+        case "trait":
+            return "Interface";
+        case "impl":
+            return "Class";
+        case "mod":
+        case "module":
+            return "Module";
+        default:
+            return "Variable";
+    }
+}
+//# sourceMappingURL=getDocumentSymbols.js.map

package/dist/tools/getDocumentSymbols.js.map

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

package/dist/tools/getFileTree.d.ts

@@ -0,0 +1,66 @@
+import type { ProbeResults } from "../probe.js";
+export declare function createGetFileTreeTool(workspace: string, probes: ProbeResults): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                directory: {
+                    type: string;
+                    description: string;
+                };
+                maxDepth: {
+                    type: string;
+                    description: string;
+                    minimum: number;
+                    maximum: number;
+                };
+                includeHidden: {
+                    type: string;
+                    description: string;
+                };
+                maxEntries: {
+                    type: string;
+                    description: string;
+                    minimum: number;
+                    maximum: number;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                entries: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                total: {
+                    type: string;
+                };
+                truncated: {
+                    type: string;
+                };
+                tool: {
+                    type: string;
+                    enum: string[];
+                };
+            };
+            required: string[];
+        };
+    };
+    handler: (args: Record<string, unknown>, signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+            _meta?: Record<string, unknown>;
+        }>;
+        structuredContent: unknown;
+    }>;
+};

package/dist/tools/getFileTree.js

@@ -0,0 +1,131 @@
+import fs from "node:fs";
+import path from "node:path";
+import { execSafe, optionalBool, optionalInt, optionalString, resolveFilePath, successStructuredLarge, } from "./utils.js";
+const IGNORED_DIRS = new Set([
+    "node_modules",
+    ".git",
+    ".jj", // Jujutsu VCS
+    ".sl", // Sapling VCS
+    "dist",
+    "__pycache__",
+    ".next",
+    ".nuxt",
+    "build",
+    "coverage",
+    ".cache",
+]);
+const MAX_ENTRIES = 500;
+const MAX_ENTRIES_HARD_CAP = 2000;
+export function createGetFileTreeTool(workspace, probes) {
+    return {
+        schema: {
+            name: "getFileTree",
+            description: "Workspace file tree. Respects .gitignore. Skips node_modules, .git, dist, build, coverage.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    directory: {
+                        type: "string",
+                        description: "Subdirectory to list (relative to workspace, default: root)",
+                    },
+                    maxDepth: {
+                        type: "integer",
+                        description: "Maximum directory depth (default: 3, max: 10)",
+                        minimum: 1,
+                        maximum: 10,
+                    },
+                    includeHidden: {
+                        type: "boolean",
+                        description: "Include hidden files/dirs (default: false)",
+                    },
+                    maxEntries: {
+                        type: "integer",
+                        description: "Max entries to return (default: 500, max: 2000)",
+                        minimum: 1,
+                        maximum: 2000,
+                    },
+                },
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    entries: { type: "array", items: { type: "string" } },
+                    total: { type: "integer" },
+                    truncated: { type: "boolean" },
+                    tool: { type: "string", enum: ["git", "fd", "fs"] },
+                },
+                required: ["entries", "total", "truncated", "tool"],
+            },
+        },
+        handler: async (args, signal) => {
+            const directory = optionalString(args, "directory", 500);
+            const maxDepth = optionalInt(args, "maxDepth", 1, 10) ?? 3;
+            const includeHidden = optionalBool(args, "includeHidden") ?? false;
+            const effectiveLimit = Math.min(optionalInt(args, "maxEntries", 1, MAX_ENTRIES_HARD_CAP) ?? MAX_ENTRIES, MAX_ENTRIES_HARD_CAP);
+            const targetDir = directory
+                ? resolveFilePath(directory, workspace)
+                : workspace;
+            if (probes.git) {
+                const result = await execSafe("git", ["ls-files", "--cached", "--others", "--exclude-standard"], { cwd: workspace, timeout: 10000, signal });
+                if (result.exitCode === 0) {
+                    let entries = result.stdout.split("\n").filter(Boolean);
+                    // Filter by target directory
+                    if (directory) {
+                        entries = entries.filter((e) => e === directory || e.startsWith(`${directory}/`));
+                    }
+                    if (!includeHidden) {
+                        entries = entries.filter((e) => !e.split("/").some((p) => p.startsWith(".") && p !== "."));
+                    }
+                    // Apply depth limit
+                    const relBase = directory || "";
+                    entries = entries.filter((e) => {
+                        const rel = relBase ? e.slice(relBase.length + 1) : e;
+                        return rel.split("/").length <= maxDepth;
+                    });
+                    entries = entries.slice(0, effectiveLimit);
+                    return successStructuredLarge({
+                        entries,
+                        total: entries.length,
+                        truncated: entries.length >= effectiveLimit,
+                        tool: "git",
+                    });
+                }
+            }
+            // Fallback: async fs.readdir
+            const entries = [];
+            async function walk(dir, depth) {
+                if (depth > maxDepth || entries.length >= effectiveLimit)
+                    return;
+                let items;
+                try {
+                    items = await fs.promises.readdir(dir, { withFileTypes: true });
+                }
+                catch {
+                    return;
+                }
+                for (const item of items) {
+                    if (entries.length >= effectiveLimit)
+                        break;
+                    if (!includeHidden && item.name.startsWith("."))
+                        continue;
+                    if (item.isDirectory() && IGNORED_DIRS.has(item.name))
+                        continue;
+                    const rel = path.relative(workspace, path.join(dir, item.name));
+                    entries.push(item.isDirectory() ? `${rel}/` : rel);
+                    if (item.isDirectory())
+                        await walk(path.join(dir, item.name), depth + 1);
+                }
+            }
+            await walk(targetDir, 1);
+            return successStructuredLarge({
+                entries,
+                total: entries.length,
+                truncated: entries.length >= effectiveLimit,
+                tool: "fs",
+            });
+        },
+    };
+}
+//# sourceMappingURL=getFileTree.js.map

package/dist/tools/getFileTree.js.map

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

package/dist/tools/getGitDiff.d.ts

@@ -0,0 +1,50 @@
+export declare function createGetGitDiffTool(workspace: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            $schema: string;
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                filePath: {
+                    type: string;
+                    description: string;
+                };
+                staged: {
+                    type: string;
+                    description: string;
+                };
+                context: {
+                    type: string;
+                    description: string;
+                };
+            };
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                diff: {
+                    type: string;
+                    description: string;
+                };
+                truncated: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler(args: Record<string, unknown>, signal?: AbortSignal): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+            _meta?: Record<string, unknown>;
+        }>;
+        structuredContent: unknown;
+    }>;
+};

package/dist/tools/getGitDiff.js

@@ -0,0 +1,73 @@
+import { execSafe, optionalBool, optionalInt, optionalString, resolveFilePath, successStructuredLarge, truncateOutput, } from "./utils.js";
+const MAX_DIFF_BYTES = 500 * 1024;
+export function createGetGitDiffTool(workspace) {
+    return {
+        schema: {
+            name: "getGitDiff",
+            description: "Get the git diff output for the workspace or a specific file",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Filter diff to a single file (absolute or workspace-relative)",
+                    },
+                    staged: {
+                        type: "boolean",
+                        description: "Show staged (cached) changes. Default: false",
+                    },
+                    context: {
+                        type: "integer",
+                        description: "Number of context lines around changes. Default: 3",
+                    },
+                },
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    diff: {
+                        type: "string",
+                        description: "Unified diff output",
+                    },
+                    truncated: {
+                        type: "boolean",
+                        description: "True when diff was capped at the size limit",
+                    },
+                },
+                required: ["diff"],
+            },
+        },
+        async handler(args, signal) {
+            const rawPath = optionalString(args, "filePath");
+            const staged = optionalBool(args, "staged") ?? false;
+            const context = optionalInt(args, "context", 0, 100) ?? 3;
+            const filterPath = rawPath
+                ? resolveFilePath(rawPath, workspace)
+                : undefined;
+            const diffArgs = ["diff"];
+            if (staged) {
+                diffArgs.push("--cached");
+            }
+            diffArgs.push(`-U${context}`);
+            if (filterPath) {
+                diffArgs.push("--", filterPath);
+            }
+            const result = await execSafe("git", diffArgs, {
+                cwd: workspace,
+                maxBuffer: MAX_DIFF_BYTES + 64 * 1024,
+                signal,
+            });
+            if (result.exitCode !== 0) {
+                return successStructuredLarge({
+                    error: result.stderr.trim() || "git diff failed",
+                });
+            }
+            const { text, truncated } = truncateOutput(result.stdout, MAX_DIFF_BYTES);
+            return successStructuredLarge({ diff: text, truncated });
+        },
+    };
+}
+//# sourceMappingURL=getGitDiff.js.map

package/dist/tools/getGitDiff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getGitDiff.js","sourceRoot":"","sources":["../../src/tools/getGitDiff.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,MAAM,cAAc,GAAG,GAAG,GAAG,IAAI,CAAC;AAElC,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,YAAY;YAClB,WAAW,EACT,8DAA8D;YAChE,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;YACnC,WAAW,EAAE;gBACX,OAAO,EAAE,yCAAyC;gBAClD,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,KAAK;gBAC3B,UAAU,EAAE;oBACV,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,+DAA+D;qBAClE;oBACD,MAAM,EAAE;wBACN,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,8CAA8C;qBAC5D;oBACD,OAAO,EAAE;wBACP,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,oDAAoD;qBAClE;iBACF;aACF;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,qBAAqB;qBACnC;oBACD,SAAS,EAAE;wBACT,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,6CAA6C;qBAC3D;iBACF;gBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;aACnB;SACF;QAED,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,MAAoB;YAC/D,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,KAAK,CAAC;YACrD,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YAE1D,MAAM,UAAU,GAAG,OAAO;gBACxB,CAAC,CAAC,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC;gBACrC,CAAC,CAAC,SAAS,CAAC;YAEd,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,MAAM,EAAE,CAAC;gBACX,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC5B,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;YAC9B,IAAI,UAAU,EAAE,CAAC;gBACf,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAClC,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE;gBAC7C,GAAG,EAAE,SAAS;gBACd,SAAS,EAAE,cAAc,GAAG,EAAE,GAAG,IAAI;gBACrC,MAAM;aACP,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,sBAAsB,CAAC;oBAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,iBAAiB;iBACjD,CAAC,CAAC;YACL,CAAC;YAED,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;YAC1E,OAAO,sBAAsB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAC3D,CAAC;KACF,CAAC;AACJ,CAAC"}