patchwork-os 0.2.0-alpha.0

package/dist/tools/fileWatcher.js

@@ -0,0 +1,121 @@
+import { ExtensionTimeoutError, } from "../extensionClient.js";
+import { error, requireString, successStructured } from "./utils.js";
+export function createWatchFilesTool(extensionClient) {
+    return {
+        schema: {
+            name: "watchFiles",
+            description: "Watch glob pattern for file changes (created/modified/deleted). Use unwatchFiles to stop.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    id: {
+                        type: "string",
+                        description: "Unique ID for this watcher (used to unwatch later)",
+                    },
+                    pattern: {
+                        type: "string",
+                        description: "Glob pattern to watch (e.g., '**/*.ts', 'src/**/*.{js,jsx}')",
+                    },
+                },
+                required: ["id", "pattern"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    watching: { type: "boolean" },
+                    id: { type: "string" },
+                    pattern: { type: "string" },
+                    available: { type: "boolean" },
+                    error: { type: "string" },
+                },
+                required: [],
+            },
+        },
+        handler: async (args) => {
+            if (!extensionClient.isConnected()) {
+                return successStructured({
+                    available: false,
+                    error: "VS Code extension not connected — file watching requires the extension",
+                });
+            }
+            const id = requireString(args, "id", 100);
+            const pattern = requireString(args, "pattern", 500);
+            if (/[\x00-\x1f]/.test(id) || /[\x00-\x1f]/.test(pattern)) {
+                return error("id and pattern must not contain control characters");
+            }
+            // Reject patterns that could escape the workspace
+            if (pattern.startsWith("/") ||
+                pattern.startsWith("\\") ||
+                pattern.includes("..")) {
+                return error("pattern must be relative to the workspace (no absolute paths or '..')");
+            }
+            try {
+                const result = await extensionClient.watchFiles(id, pattern);
+                if (result === null) {
+                    return error("Failed to register file watcher");
+                }
+                return successStructured(result);
+            }
+            catch (err) {
+                if (err instanceof ExtensionTimeoutError) {
+                    return error("Extension timed out — file watching may be unavailable");
+                }
+                throw err;
+            }
+        },
+    };
+}
+export function createUnwatchFilesTool(extensionClient) {
+    return {
+        schema: {
+            name: "unwatchFiles",
+            description: "Stop watching files for a previously registered watcher by ID.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    id: {
+                        type: "string",
+                        description: "ID of the watcher to remove",
+                    },
+                },
+                required: ["id"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    unwatched: { type: "boolean" },
+                    id: { type: "string" },
+                    available: { type: "boolean" },
+                    error: { type: "string" },
+                },
+                required: [],
+            },
+        },
+        handler: async (args) => {
+            if (!extensionClient.isConnected()) {
+                return successStructured({
+                    available: false,
+                    error: "VS Code extension not connected — file watching requires the extension",
+                });
+            }
+            const id = requireString(args, "id", 100);
+            try {
+                const result = await extensionClient.unwatchFiles(id);
+                if (result === null) {
+                    return error("Failed to unregister file watcher");
+                }
+                return successStructured(result);
+            }
+            catch (err) {
+                if (err instanceof ExtensionTimeoutError) {
+                    return error("Extension timed out — file watching may be unavailable");
+                }
+                throw err;
+            }
+        },
+    };
+}
+//# sourceMappingURL=fileWatcher.js.map

package/dist/tools/fileWatcher.js.map

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

package/dist/tools/findFiles.d.ts

@@ -0,0 +1,65 @@
+import type { ProbeResults } from "../probe.js";
+export declare function createFindFilesTool(workspace: string, probes: ProbeResults): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                pattern: {
+                    type: string;
+                    description: string;
+                };
+                directory: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                files: {
+                    type: "array";
+                    items: {
+                        type: "string";
+                    };
+                };
+                count: {
+                    type: "integer";
+                };
+                totalMatches: {
+                    type: "integer";
+                };
+                tool: {
+                    type: "string";
+                };
+                truncated: {
+                    type: "boolean";
+                };
+                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/findFiles.js

@@ -0,0 +1,142 @@
+import { error, execSafe, makeRelative, optionalString, requireString, resolveFilePath, successStructured, } from "./utils.js";
+export function createFindFilesTool(workspace, probes) {
+    return {
+        schema: {
+            name: "findFiles",
+            description: "Find files by name/glob pattern in the workspace. Respects .gitignore.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    pattern: {
+                        type: "string",
+                        description: "Glob pattern (e.g. '*.config.ts', 'README*')",
+                    },
+                    directory: {
+                        type: "string",
+                        description: "Subdirectory to search in (relative to workspace)",
+                    },
+                },
+                required: ["pattern"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    files: { type: "array", items: { type: "string" } },
+                    count: { type: "integer" },
+                    totalMatches: { type: "integer" },
+                    tool: { type: "string" },
+                    truncated: { type: "boolean" },
+                    note: { type: "string" },
+                },
+                required: ["files", "count", "tool"],
+            },
+        },
+        handler: async (args, signal) => {
+            const pattern = requireString(args, "pattern", 200);
+            const directory = optionalString(args, "directory", 500);
+            const searchDir = directory
+                ? resolveFilePath(directory, workspace)
+                : workspace;
+            if (probes.fd) {
+                const fdArgs = ["--glob", pattern, "--max-results", "100", searchDir];
+                const result = await execSafe("fd", fdArgs, {
+                    timeout: 10000,
+                    signal,
+                });
+                const files = result.stdout
+                    .split("\n")
+                    .filter(Boolean)
+                    .map((f) => makeRelative(f, workspace));
+                const truncated = files.length === 100;
+                return successStructured({
+                    files,
+                    count: files.length,
+                    tool: "fd",
+                    ...(truncated
+                        ? {
+                            truncated: true,
+                            note: "Result limit reached — narrow pattern or use directory",
+                        }
+                        : {}),
+                });
+            }
+            if (probes.git) {
+                const result = await execSafe("git", ["ls-files", "--cached", "--others", "--exclude-standard"], { cwd: workspace, timeout: 10000, signal });
+                const allFiles = result.stdout.split("\n").filter(Boolean);
+                // Convert glob to regex — escape metacharacters before glob substitution
+                const regexPattern = pattern
+                    .replace(/\*\*/g, "\0GLOBSTAR\0")
+                    .replace(/\*/g, "\0STAR\0")
+                    .replace(/\?/g, "\0Q\0")
+                    .replace(/[.*+^${}()|[\]\\]/g, "\\$&")
+                    .replace(/\0GLOBSTAR\0/g, ".*")
+                    .replace(/\0STAR\0/g, "[^/]*")
+                    .replace(/\0Q\0/g, "[^/]");
+                const regex = new RegExp(`(^|/)${regexPattern}$`, "i");
+                const allMatches = allFiles.filter((f) => regex.test(f));
+                const files = allMatches.slice(0, 100);
+                return successStructured({
+                    files,
+                    count: files.length,
+                    totalMatches: allMatches.length,
+                    tool: "git-ls-files",
+                    ...(files.length < allMatches.length
+                        ? {
+                            truncated: true,
+                            note: "Result limit reached — narrow pattern or use directory",
+                        }
+                        : {}),
+                });
+            }
+            // Fallback: find
+            // Guard: a pattern starting with `-` would be interpreted by `find` as a
+            // primary or option (e.g. `-maxdepth 0`, `-exec …`) rather than a name pattern.
+            if (pattern.startsWith("-")) {
+                return error(`Pattern must not start with "-" (would be interpreted as a find option)`);
+            }
+            const findArgs = [
+                searchDir,
+                "-maxdepth",
+                "10",
+                "-name",
+                pattern,
+                "-not",
+                "-path",
+                "*/node_modules/*",
+                "-not",
+                "-path",
+                "*/.git/*",
+                "-not",
+                "-path",
+                "*/.jj/*",
+                "-not",
+                "-path",
+                "*/.sl/*",
+            ];
+            const result = await execSafe("find", findArgs, {
+                timeout: 10000,
+                signal,
+            });
+            const files = result.stdout
+                .split("\n")
+                .filter(Boolean)
+                .map((f) => makeRelative(f, workspace))
+                .slice(0, 100);
+            const truncated = files.length === 100;
+            return successStructured({
+                files,
+                count: files.length,
+                tool: "find",
+                ...(truncated
+                    ? {
+                        truncated: true,
+                        note: "Result limit reached — narrow pattern or use directory",
+                    }
+                    : {}),
+            });
+        },
+    };
+}
+//# sourceMappingURL=findFiles.js.map

package/dist/tools/findFiles.js.map

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

package/dist/tools/findRelatedTests.d.ts

@@ -0,0 +1,83 @@
+import type { ProbeResults } from "../probe.js";
+/**
+ * findRelatedTests — semantic test discovery composite tool.
+ *
+ * Given a source file, finds test files that reference it via:
+ * 1. Name-pattern matching (*.test.ts, *.spec.ts adjacent to the file)
+ * 2. ripgrep content search — test files that import or require the source file
+ *
+ * Optionally cross-references coverage data to show which lines are uncovered.
+ * Returns ranked list of test files with import evidence and coverage summary.
+ */
+export declare function createFindRelatedTestsTool(workspace: string, probes: ProbeResults): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                filePath: {
+                    type: "string";
+                    description: string;
+                };
+                includeCoverage: {
+                    type: "boolean";
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                sourceFile: {
+                    type: string;
+                };
+                testFiles: {
+                    type: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            file: {
+                                type: string;
+                            };
+                            matchReason: {
+                                type: string;
+                            };
+                            importLine: {
+                                type: string;
+                            };
+                            coveragePct: {
+                                anyOf: {
+                                    type: string;
+                                }[];
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                totalFound: {
+                    type: string;
+                };
+                coverageAvailable: {
+                    type: string;
+                };
+                memoryGraphHint: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler: (args: Record<string, unknown>, signal?: AbortSignal) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    }>;
+};

package/dist/tools/findRelatedTests.js

@@ -0,0 +1,196 @@
+import path from "node:path";
+import { execSafe, makeRelative, optionalBool, requireString, resolveFilePath, successStructured, } from "./utils.js";
+/**
+ * findRelatedTests — semantic test discovery composite tool.
+ *
+ * Given a source file, finds test files that reference it via:
+ * 1. Name-pattern matching (*.test.ts, *.spec.ts adjacent to the file)
+ * 2. ripgrep content search — test files that import or require the source file
+ *
+ * Optionally cross-references coverage data to show which lines are uncovered.
+ * Returns ranked list of test files with import evidence and coverage summary.
+ */
+export function createFindRelatedTestsTool(workspace, probes) {
+    return {
+        schema: {
+            name: "findRelatedTests",
+            description: "Find test files that cover a source file via import search + name patterns. " +
+                "Optionally includes coverage pct per test file.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Source file to find tests for (absolute or workspace-relative)",
+                    },
+                    includeCoverage: {
+                        type: "boolean",
+                        description: "Cross-reference coverage report if available (default: false)",
+                    },
+                },
+                required: ["filePath"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    sourceFile: { type: "string" },
+                    testFiles: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                file: { type: "string" },
+                                matchReason: { type: "string" },
+                                importLine: { type: "string" },
+                                coveragePct: { anyOf: [{ type: "number" }, { type: "null" }] },
+                            },
+                            required: ["file", "matchReason"],
+                        },
+                    },
+                    totalFound: { type: "integer" },
+                    coverageAvailable: { type: "boolean" },
+                    memoryGraphHint: { type: "string" },
+                },
+                required: [
+                    "sourceFile",
+                    "testFiles",
+                    "totalFound",
+                    "coverageAvailable",
+                ],
+            },
+        },
+        handler: async (args, signal) => {
+            const rawPath = requireString(args, "filePath");
+            const filePath = resolveFilePath(rawPath, workspace);
+            const relSource = makeRelative(filePath, workspace);
+            const includeCoverage = optionalBool(args, "includeCoverage") ?? false;
+            const baseName = path.basename(filePath, path.extname(filePath));
+            const dir = path.dirname(filePath);
+            const relDir = makeRelative(dir, workspace);
+            const testFiles = new Map();
+            // Step 1 — name-pattern search: look for <name>.test.* and <name>.spec.*
+            const namePatterns = [
+                `${baseName}.test.*`,
+                `${baseName}.spec.*`,
+                `${baseName}-test.*`,
+                `${baseName}_test.*`,
+            ];
+            for (const pattern of namePatterns) {
+                const result = probes.rg
+                    ? await execSafe("rg", ["--files", "--glob", pattern, workspace], {
+                        cwd: workspace,
+                        signal,
+                        timeout: 5_000,
+                        maxBuffer: 512 * 1024,
+                    })
+                    : await execSafe("find", [workspace, "-name", pattern], {
+                        cwd: workspace,
+                        signal,
+                        timeout: 5_000,
+                        maxBuffer: 512 * 1024,
+                    });
+                if (result.exitCode === 0) {
+                    for (const line of result.stdout.split("\n")) {
+                        const f = line.trim();
+                        if (f && !testFiles.has(f)) {
+                            testFiles.set(f, { matchReason: "name-pattern" });
+                        }
+                    }
+                }
+            }
+            // Step 2 — import search via rg: find test files that import the source
+            if (probes.rg) {
+                // Search for imports of the source file by relative path or bare module name
+                const importPatterns = [
+                    `from ['"].*${baseName}['"]`,
+                    `require\\(['"].*${baseName}['"]\\)`,
+                    relDir !== "." ? relSource.replace(/\\/g, "/") : baseName,
+                ];
+                for (const pattern of importPatterns) {
+                    const rgResult = await execSafe("rg", [
+                        "--glob",
+                        "*.test.*",
+                        "--glob",
+                        "*.spec.*",
+                        "--with-filename",
+                        "--line-number",
+                        "-e",
+                        pattern,
+                        workspace,
+                    ], { cwd: workspace, signal, timeout: 8_000, maxBuffer: 1024 * 1024 });
+                    if (rgResult.exitCode === 0) {
+                        for (const line of rgResult.stdout.split("\n")) {
+                            const match = line.match(/^(.+?):(\d+):(.+)$/);
+                            if (match) {
+                                const [, file, , importLine] = match;
+                                if (file && !testFiles.has(file)) {
+                                    testFiles.set(file, {
+                                        matchReason: "import-reference",
+                                        importLine: importLine?.trim().slice(0, 120),
+                                    });
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+            // Step 3 — optionally load coverage data
+            let coverageByFile = null;
+            if (includeCoverage) {
+                const { promises: fs } = await import("node:fs");
+                const candidates = [
+                    path.join(workspace, "coverage", "coverage-summary.json"),
+                    path.join(workspace, "coverage", "lcov.info"),
+                ];
+                for (const candidate of candidates) {
+                    try {
+                        const content = await fs.readFile(candidate, "utf-8");
+                        coverageByFile = new Map();
+                        if (candidate.endsWith(".json")) {
+                            const json = JSON.parse(content);
+                            for (const [key, val] of Object.entries(json)) {
+                                if (key !== "total")
+                                    coverageByFile.set(key, val.lines?.pct ?? 0);
+                            }
+                        }
+                        break;
+                    }
+                    catch {
+                        // try next candidate
+                    }
+                }
+            }
+            // Build result list
+            const results = Array.from(testFiles.entries())
+                .slice(0, 30)
+                .map(([file, meta]) => {
+                const relFile = makeRelative(file, workspace);
+                const coveragePct = coverageByFile?.get(file) ?? coverageByFile?.get(relFile) ?? null;
+                return {
+                    file: relFile,
+                    matchReason: meta.matchReason,
+                    ...(meta.importLine ? { importLine: meta.importLine } : {}),
+                    ...(includeCoverage ? { coveragePct } : {}),
+                };
+            })
+                // name-pattern matches first, then import-reference
+                .sort((a, b) => a.matchReason === "name-pattern"
+                ? -1
+                : b.matchReason === "name-pattern"
+                    ? 1
+                    : 0);
+            return successStructured({
+                sourceFile: relSource,
+                testFiles: results,
+                totalFound: results.length,
+                coverageAvailable: coverageByFile !== null,
+                memoryGraphHint: `For deeper semantic test discovery, query codebase-memory: ` +
+                    `mcp__codebase-memory__search_graph with pattern "${baseName}" ` +
+                    `to find test nodes linked via CALLS or IMPORTS edges.`,
+            });
+        },
+    };
+}
+//# sourceMappingURL=findRelatedTests.js.map

package/dist/tools/findRelatedTests.js.map

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