patchwork-os 0.2.0-alpha.0

package/dist/tools/batchLsp.js

@@ -0,0 +1,328 @@
+import { traverse } from "../fp/async.js";
+import { extensionRequired, resolveFilePath, successStructured, } from "./utils.js";
+const MAX_BATCH = 10;
+function parseBatchItems(raw, workspace, toolName) {
+    if (!Array.isArray(raw))
+        throw new Error("items must be an array");
+    if (raw.length === 0)
+        throw new Error("items must not be empty");
+    if (raw.length > MAX_BATCH)
+        throw new Error(`items exceeds maximum of ${MAX_BATCH}`);
+    return raw.map((item, idx) => {
+        if (typeof item !== "object" || item === null)
+            throw new Error(`${toolName}: items[${idx}] must be an object`);
+        const obj = item;
+        if (typeof obj.filePath !== "string")
+            throw new Error(`${toolName}: items[${idx}].filePath must be a string`);
+        if (typeof obj.line !== "number" ||
+            !Number.isInteger(obj.line) ||
+            obj.line < 1)
+            throw new Error(`${toolName}: items[${idx}].line must be a positive integer`);
+        if (typeof obj.column !== "number" ||
+            !Number.isInteger(obj.column) ||
+            obj.column < 1)
+            throw new Error(`${toolName}: items[${idx}].column must be a positive integer`);
+        return {
+            filePath: resolveFilePath(obj.filePath, workspace),
+            line: obj.line,
+            column: obj.column,
+        };
+    });
+}
+// ── batchGetHover ─────────────────────────────────────────────────────────────
+function applyBatchLspVerbosity(result, verbosity) {
+    if (verbosity !== "minimal" ||
+        typeof result !== "object" ||
+        result === null) {
+        return result;
+    }
+    const r = result;
+    if (!Array.isArray(r.contents))
+        return result;
+    return { ...r, contents: r.contents.slice(0, 1) };
+}
+export function createBatchGetHoverTool(workspace, extensionClient, lspVerbosity = "normal") {
+    return {
+        schema: {
+            name: "batchGetHover",
+            extensionRequired: true,
+            description: "Hover info (type signatures, docs) for up to 10 positions. Prefer over repeated getHover.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    items: {
+                        type: "array",
+                        description: "List of positions to hover (max 10)",
+                        maxItems: MAX_BATCH,
+                        items: {
+                            type: "object",
+                            properties: {
+                                filePath: {
+                                    type: "string",
+                                    description: "Workspace or absolute path",
+                                },
+                                line: {
+                                    type: "integer",
+                                    description: "Line number (1-based)",
+                                    minimum: 1,
+                                },
+                                column: {
+                                    type: "integer",
+                                    description: "Column (1-based)",
+                                    minimum: 1,
+                                },
+                            },
+                            required: ["filePath", "line", "column"],
+                            additionalProperties: false,
+                        },
+                    },
+                },
+                required: ["items"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    results: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                filePath: { type: "string" },
+                                line: { type: "integer" },
+                                column: { type: "integer" },
+                                result: {},
+                                error: { type: "string" },
+                            },
+                            required: ["filePath", "line", "column"],
+                        },
+                    },
+                    count: { type: "integer" },
+                },
+                required: ["results", "count"],
+            },
+        },
+        handler: async (args, signal) => {
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("batchGetHover");
+            }
+            const items = parseBatchItems(args.items, workspace, "batchGetHover");
+            const compositeSignal = AbortSignal.any([
+                ...(signal ? [signal] : []),
+                AbortSignal.timeout(15_000),
+            ]);
+            const traversed = await traverse(items, (item) => extensionClient.getHover(item.filePath, item.line, item.column, compositeSignal));
+            const results = items.map((item, i) => {
+                const r = traversed[i];
+                if (r?.ok) {
+                    return {
+                        filePath: item.filePath,
+                        line: item.line,
+                        column: item.column,
+                        result: applyBatchLspVerbosity(r.value ?? null, lspVerbosity),
+                    };
+                }
+                return {
+                    filePath: item.filePath,
+                    line: item.line,
+                    column: item.column,
+                    result: null,
+                    error: r?.error ?? "Unknown error",
+                };
+            });
+            return successStructured({ results, count: results.length });
+        },
+    };
+}
+// ── batchFindImplementations ──────────────────────────────────────────────────
+export function createBatchFindImplementationsTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "batchFindImplementations",
+            extensionRequired: true,
+            description: "Find implementations for up to 10 symbols. Prefer over repeated findImplementations.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    items: {
+                        type: "array",
+                        description: "List of positions to look up (max 10)",
+                        maxItems: MAX_BATCH,
+                        items: {
+                            type: "object",
+                            properties: {
+                                filePath: {
+                                    type: "string",
+                                    description: "Workspace or absolute path",
+                                },
+                                line: {
+                                    type: "integer",
+                                    description: "Line number (1-based)",
+                                    minimum: 1,
+                                },
+                                column: {
+                                    type: "integer",
+                                    description: "Column (1-based)",
+                                    minimum: 1,
+                                },
+                            },
+                            required: ["filePath", "line", "column"],
+                            additionalProperties: false,
+                        },
+                    },
+                },
+                required: ["items"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    results: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                filePath: { type: "string" },
+                                line: { type: "integer" },
+                                column: { type: "integer" },
+                                result: {},
+                                error: { type: "string" },
+                            },
+                            required: ["filePath", "line", "column"],
+                        },
+                    },
+                    count: { type: "integer" },
+                },
+                required: ["results", "count"],
+            },
+        },
+        handler: async (args, signal) => {
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("batchFindImplementations");
+            }
+            const items = parseBatchItems(args.items, workspace, "batchFindImplementations");
+            const compositeSignal = AbortSignal.any([
+                ...(signal ? [signal] : []),
+                AbortSignal.timeout(15_000),
+            ]);
+            const traversed = await traverse(items, (item) => extensionClient.findImplementations(item.filePath, item.line, item.column, compositeSignal));
+            const results = items.map((item, i) => {
+                const r = traversed[i];
+                if (r?.ok) {
+                    return {
+                        filePath: item.filePath,
+                        line: item.line,
+                        column: item.column,
+                        result: r.value ?? null,
+                    };
+                }
+                return {
+                    filePath: item.filePath,
+                    line: item.line,
+                    column: item.column,
+                    result: null,
+                    error: r?.error ?? "Unknown error",
+                };
+            });
+            return successStructured({ results, count: results.length });
+        },
+    };
+}
+// ── batchGoToDefinition ───────────────────────────────────────────────────────
+export function createBatchGoToDefinitionTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "batchGoToDefinition",
+            extensionRequired: true,
+            description: "Go to definition for up to 10 symbols. Prefer over repeated goToDefinition.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    items: {
+                        type: "array",
+                        description: "List of positions to look up (max 10)",
+                        maxItems: MAX_BATCH,
+                        items: {
+                            type: "object",
+                            properties: {
+                                filePath: {
+                                    type: "string",
+                                    description: "Workspace or absolute path",
+                                },
+                                line: {
+                                    type: "integer",
+                                    description: "Line number (1-based)",
+                                    minimum: 1,
+                                },
+                                column: {
+                                    type: "integer",
+                                    description: "Column (1-based)",
+                                    minimum: 1,
+                                },
+                            },
+                            required: ["filePath", "line", "column"],
+                            additionalProperties: false,
+                        },
+                    },
+                },
+                required: ["items"],
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    results: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                filePath: { type: "string" },
+                                line: { type: "integer" },
+                                column: { type: "integer" },
+                                result: {},
+                                error: { type: "string" },
+                            },
+                            required: ["filePath", "line", "column"],
+                        },
+                    },
+                    count: { type: "integer" },
+                },
+                required: ["results", "count"],
+            },
+        },
+        handler: async (args, signal) => {
+            if (!extensionClient.isConnected()) {
+                return extensionRequired("batchGoToDefinition");
+            }
+            const items = parseBatchItems(args.items, workspace, "batchGoToDefinition");
+            const compositeSignal = AbortSignal.any([
+                ...(signal ? [signal] : []),
+                AbortSignal.timeout(15_000),
+            ]);
+            const traversed = await traverse(items, (item) => extensionClient.goToDefinition(item.filePath, item.line, item.column, compositeSignal));
+            const results = items.map((item, i) => {
+                const r = traversed[i];
+                if (r?.ok) {
+                    return {
+                        filePath: item.filePath,
+                        line: item.line,
+                        column: item.column,
+                        result: r.value ?? null,
+                    };
+                }
+                return {
+                    filePath: item.filePath,
+                    line: item.line,
+                    column: item.column,
+                    result: null,
+                    error: r?.error ?? "Unknown error",
+                };
+            });
+            return successStructured({ results, count: results.length });
+        },
+    };
+}
+//# sourceMappingURL=batchLsp.js.map

package/dist/tools/batchLsp.js.map

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

package/dist/tools/blame-utils.d.ts

@@ -0,0 +1,30 @@
+export interface BlameEntry {
+    commitHash: string;
+    cachedAt: number;
+}
+export interface BlameCacheOptions {
+    /** Cache TTL in ms. Default 30s. */
+    ttlMs?: number;
+    /** Git blame subprocess timeout in ms. Default 2s. */
+    timeoutMs?: number;
+    /** FIFO cache size cap. Default 1000. */
+    maxSize?: number;
+    /** Test hook — default Date.now. */
+    now?: () => number;
+}
+/**
+ * Factory for a per-instance git-blame resolver with LRU cache, subprocess
+ * timeout, and stale-file guard. Used by watchDiagnostics (enriches
+ * diagnostics with introducing commit) and enrichStackTrace (maps stack
+ * frames to commits).
+ *
+ * Returns `undefined` for untracked files, deleted files, blame misses, and
+ * the all-zeros "uncommitted" sentinel — callers treat those as "unknown"
+ * rather than error.
+ */
+export declare function createBlameResolver(workspace: string, options?: BlameCacheOptions): {
+    getIntroducedByCommit: (file: string, line: number) => Promise<string | undefined>;
+    cacheSize: () => number;
+    clearCache: () => void;
+};
+export type BlameResolver = ReturnType<typeof createBlameResolver>;

package/dist/tools/blame-utils.js

@@ -0,0 +1,60 @@
+import { execFile } from "node:child_process";
+import { existsSync } from "node:fs";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+const DEFAULT_TTL_MS = 30_000;
+const DEFAULT_TIMEOUT_MS = 2_000;
+const DEFAULT_CACHE_MAX = 1_000;
+/**
+ * Factory for a per-instance git-blame resolver with LRU cache, subprocess
+ * timeout, and stale-file guard. Used by watchDiagnostics (enriches
+ * diagnostics with introducing commit) and enrichStackTrace (maps stack
+ * frames to commits).
+ *
+ * Returns `undefined` for untracked files, deleted files, blame misses, and
+ * the all-zeros "uncommitted" sentinel — callers treat those as "unknown"
+ * rather than error.
+ */
+export function createBlameResolver(workspace, options = {}) {
+    const ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const maxSize = options.maxSize ?? DEFAULT_CACHE_MAX;
+    const now = options.now ?? Date.now;
+    const cache = new Map();
+    function evict() {
+        if (cache.size <= maxSize)
+            return;
+        const firstKey = cache.keys().next().value;
+        if (firstKey !== undefined)
+            cache.delete(firstKey);
+    }
+    async function getIntroducedByCommit(file, line) {
+        const key = `${file}:${line}`;
+        const cached = cache.get(key);
+        if (cached && now() - cached.cachedAt < ttlMs) {
+            return cached.commitHash;
+        }
+        // Skip subprocess for files that no longer exist on disk.
+        if (!existsSync(file))
+            return undefined;
+        try {
+            const { stdout } = await execFileAsync("git", ["blame", "-L", `${line},${line}`, "--porcelain", "--", file], { cwd: workspace, timeout: timeoutMs });
+            const hash = stdout.slice(0, 40).trim();
+            if (/^[0-9a-f]{40}$/.test(hash) && !hash.startsWith("0000000")) {
+                cache.set(key, { commitHash: hash, cachedAt: now() });
+                evict();
+                return hash;
+            }
+        }
+        catch {
+            // git not available, file not tracked, timeout — silently omit
+        }
+        return undefined;
+    }
+    return {
+        getIntroducedByCommit,
+        cacheSize: () => cache.size,
+        clearCache: () => cache.clear(),
+    };
+}
+//# sourceMappingURL=blame-utils.js.map

package/dist/tools/blame-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blame-utils.js","sourceRoot":"","sources":["../../src/tools/blame-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,cAAc,GAAG,MAAM,CAAC;AAC9B,MAAM,kBAAkB,GAAG,KAAK,CAAC;AACjC,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAkBhC;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAAiB,EACjB,UAA6B,EAAE;IAE/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,cAAc,CAAC;IAC9C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,iBAAiB,CAAC;IACrD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACpC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAE5C,SAAS,KAAK;QACZ,IAAI,KAAK,CAAC,IAAI,IAAI,OAAO;YAAE,OAAO;QAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QAC3C,IAAI,QAAQ,KAAK,SAAS;YAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,UAAU,qBAAqB,CAClC,IAAY,EACZ,IAAY;QAEZ,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,CAAC,QAAQ,GAAG,KAAK,EAAE,CAAC;YAC9C,OAAO,MAAM,CAAC,UAAU,CAAC;QAC3B,CAAC;QACD,0DAA0D;QAC1D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CACpC,KAAK,EACL,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,IAAI,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,EAC7D,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CACvC,CAAC;YACF,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACxC,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC/D,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;gBACtD,KAAK,EAAE,CAAC;gBACR,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+DAA+D;QACjE,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,qBAAqB;QACrB,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI;QAC3B,UAAU,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE;KAChC,CAAC;AACJ,CAAC"}

package/dist/tools/bridgeDoctor.d.ts

@@ -0,0 +1,78 @@
+import type { Config } from "../config.js";
+import type { ExtensionClient } from "../extensionClient.js";
+import type { ProbeResults } from "../probe.js";
+/** Minimal interface to read stats from AutomationHooks without importing the whole class. */
+interface AutomationHooksLike {
+    getStats(): {
+        hooksEnabled: number;
+        lastFiredAt: string | null;
+        skipCountsByHookAndReason?: Record<string, Record<string, number>>;
+    };
+}
+export type CheckStatus = "ok" | "warn" | "error" | "skip";
+export interface CheckResult {
+    name: string;
+    status: CheckStatus;
+    detail?: string;
+    suggestion?: string;
+}
+export declare function createBridgeDoctorTool(workspace: string, extensionClient: ExtensionClient, probes: ProbeResults, port: number, config: Config, automationHooks?: AutomationHooksLike): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        cache_control: {
+            type: "ephemeral";
+        };
+        inputSchema: {
+            type: "object";
+            properties: {};
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                overallHealth: {
+                    type: string;
+                    enum: string[];
+                };
+                checks: {
+                    type: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            name: {
+                                type: string;
+                            };
+                            status: {
+                                type: string;
+                                enum: string[];
+                            };
+                            detail: {
+                                type: string;
+                            };
+                            suggestion: {
+                                type: string;
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                summary: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler: (_args: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    }>;
+};
+export {};