patchwork-os 0.2.0-alpha.0

package/dist/tools/getOpenEditors.js

@@ -0,0 +1,126 @@
+import fs from "node:fs";
+import path from "node:path";
+import { ExtensionTimeoutError, } from "../extensionClient.js";
+import { languageIdFromPath, resolveFilePath, successStructured, } from "./utils.js";
+export function createGetOpenEditorsTool(openedFiles, extensionClient, workspace) {
+    return {
+        schema: {
+            name: "getOpenEditors",
+            description: "Open files/tabs with isDirty, isActive when ext connected. Fallback: session-opened files only.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    tabs: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                uri: { type: "string" },
+                                fileName: { type: "string" },
+                                label: { type: "string" },
+                                languageId: { type: "string" },
+                                isActive: { type: "boolean" },
+                                isDirty: { type: "boolean" },
+                                lineCount: { type: "integer" },
+                            },
+                            required: [
+                                "uri",
+                                "fileName",
+                                "label",
+                                "languageId",
+                                "isActive",
+                                "isDirty",
+                            ],
+                        },
+                    },
+                    source: { type: "string", enum: ["vscode", "local-tracking"] },
+                },
+                required: ["tabs", "source"],
+            },
+        },
+        async handler() {
+            // Use extension for real tab state when available
+            if (extensionClient?.isConnected()) {
+                try {
+                    const result = await extensionClient.getOpenFiles();
+                    if (result !== null && Array.isArray(result)) {
+                        // result is TabInfo[] — enrich with languageId and lineCount from disk (async)
+                        const tabs = await Promise.all(result.map(async (tab) => {
+                            let lineCount;
+                            try {
+                                const stat = await fs.promises.stat(tab.filePath);
+                                lineCount = Math.max(1, Math.ceil(stat.size / 40));
+                            }
+                            catch {
+                                lineCount = undefined;
+                            }
+                            return {
+                                uri: `file://${tab.filePath}`,
+                                isActive: tab.isActive,
+                                isDirty: tab.isDirty,
+                                label: path.basename(tab.filePath),
+                                fileName: tab.filePath,
+                                languageId: tab.languageId ?? languageIdFromPath(tab.filePath),
+                                lineCount,
+                                source: "vscode",
+                            };
+                        }));
+                        return successStructured({ tabs, source: "vscode" });
+                    }
+                }
+                catch (err) {
+                    if (!(err instanceof ExtensionTimeoutError))
+                        throw err;
+                    // Timeout — fall through to local tracking fallback
+                }
+            }
+            // Fallback: files tracked locally via openFile calls
+            const tabs = [];
+            const toEvict = [];
+            for (const filePath of openedFiles) {
+                if (workspace) {
+                    try {
+                        resolveFilePath(filePath, workspace);
+                    }
+                    catch {
+                        toEvict.push(filePath);
+                        continue;
+                    }
+                }
+                try {
+                    const stat = await fs.promises.stat(filePath);
+                    const estimatedLines = Math.max(1, Math.ceil(stat.size / 40));
+                    tabs.push({
+                        uri: `file://${filePath}`,
+                        isActive: false,
+                        isPinned: false,
+                        isPreview: false,
+                        isDirty: false,
+                        label: path.basename(filePath),
+                        groupIndex: 0,
+                        viewColumn: 1,
+                        isGroupActive: false,
+                        fileName: filePath,
+                        languageId: languageIdFromPath(filePath),
+                        lineCount: estimatedLines,
+                        isUntitled: false,
+                    });
+                }
+                catch {
+                    // file may have been deleted
+                    toEvict.push(filePath);
+                }
+            }
+            for (const p of toEvict)
+                openedFiles.delete(p);
+            return successStructured({ tabs, source: "local-tracking" });
+        },
+    };
+}
+//# sourceMappingURL=getOpenEditors.js.map

package/dist/tools/getOpenEditors.js.map

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

package/dist/tools/getPRTemplate.d.ts

@@ -0,0 +1,68 @@
+export declare function createGetPRTemplateTool(workspace: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                base: {
+                    type: string;
+                    description: string;
+                };
+                style: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                body: {
+                    type: string;
+                };
+                commits: {
+                    type: string;
+                };
+                issueRefs: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                filesChanged: {
+                    type: string;
+                };
+                base: {
+                    type: string;
+                };
+                style: {
+                    type: string;
+                };
+                note: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    timeoutMs: number;
+    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/getPRTemplate.js

@@ -0,0 +1,187 @@
+import { runGitStdout } from "./git-utils.js";
+import { extractIssueRefs } from "./issueRefs.js";
+import { error, execSafe, optionalString, successStructured } from "./utils.js";
+function runGit(args, cwd, signal, timeout = 10_000) {
+    return runGitStdout(args, cwd, { signal, timeout });
+}
+async function detectBaseBranch(workspace, signal) {
+    // Try to find main or master
+    const branches = await runGit(["branch", "-r", "--format=%(refname:short)"], workspace, signal);
+    for (const line of branches.split("\n")) {
+        const b = line.trim();
+        if (b === "origin/main" || b === "origin/master") {
+            return b.replace("origin/", "");
+        }
+    }
+    // Fall back to checking local branches
+    const local = await runGit(["branch", "--format=%(refname:short)"], workspace, signal);
+    for (const line of local.split("\n")) {
+        const b = line.trim();
+        if (b === "main" || b === "master")
+            return b;
+    }
+    return "main";
+}
+function formatBullet(commits, stats, issueRefs) {
+    const lines = ["## Changes", ""];
+    for (const line of commits) {
+        if (line.trim())
+            lines.push(`- ${line.trim()}`);
+    }
+    lines.push("", "## Files changed", "", stats.trim());
+    if (issueRefs.length > 0) {
+        lines.push("", `Closes ${issueRefs.join(", ")}`);
+    }
+    return lines.join("\n");
+}
+function formatProse(commits, stats, issueRefs) {
+    const summary = commits.length === 1
+        ? (commits[0]?.trim() ?? "")
+        : `This PR includes ${commits.length} commits: ${commits.map((c) => c.trim()).join("; ")}.`;
+    const lines = [summary, "", stats.trim()];
+    if (issueRefs.length > 0) {
+        lines.push("", `Closes ${issueRefs.join(", ")}`);
+    }
+    return lines.join("\n");
+}
+function formatConventional(commits, stats, issueRefs) {
+    const grouped = {};
+    for (const commit of commits) {
+        const match = commit.trim().match(/^(\w+)(?:\(.+?\))?!?:\s+(.+)/);
+        if (match) {
+            const type = match[1] ?? "other";
+            const msg = match[2] ?? commit.trim();
+            (grouped[type] ??= []).push(msg);
+        }
+        else {
+            (grouped.other ??= []).push(commit.trim());
+        }
+    }
+    const lines = [];
+    for (const [type, msgs] of Object.entries(grouped)) {
+        lines.push(`### ${type}`);
+        for (const m of msgs)
+            lines.push(`- ${m}`);
+        lines.push("");
+    }
+    lines.push("## Files changed", "", stats.trim());
+    if (issueRefs.length > 0) {
+        lines.push("", `Closes ${issueRefs.join(", ")}`);
+    }
+    return lines.join("\n");
+}
+export function createGetPRTemplateTool(workspace) {
+    return {
+        schema: {
+            name: "getPRTemplate",
+            description: "PR description from commits and diff stats vs base branch. Returns markdown → pass to githubCreatePR.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    base: {
+                        type: "string",
+                        description: "Base branch (default: auto-detect main/master)",
+                    },
+                    style: {
+                        type: "string",
+                        enum: ["bullet", "prose", "conventional"],
+                        description: "bullet (default), prose (paragraph), or conventional (grouped by commit type)",
+                    },
+                },
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    body: { type: "string" },
+                    commits: { type: "number" },
+                    issueRefs: { type: "array", items: { type: "string" } },
+                    filesChanged: { type: "number" },
+                    base: { type: "string" },
+                    style: { type: "string" },
+                    note: { type: "string" },
+                },
+                required: ["body", "commits", "issueRefs", "filesChanged", "base"],
+            },
+        },
+        timeoutMs: 15_000,
+        async handler(args, signal) {
+            const styleRaw = optionalString(args, "style") ?? "bullet";
+            const style = ["bullet", "prose", "conventional"].includes(styleRaw)
+                ? styleRaw
+                : "bullet";
+            // Verify git repo
+            const check = await execSafe("git", ["rev-parse", "--git-dir"], {
+                cwd: workspace,
+                signal,
+                timeout: 5_000,
+            });
+            if (check.exitCode !== 0) {
+                return error("Not a git repository");
+            }
+            let base = optionalString(args, "base");
+            if (!base) {
+                try {
+                    base = await detectBaseBranch(workspace, signal);
+                }
+                catch {
+                    base = "main";
+                }
+            }
+            let commits;
+            let stats;
+            let filesChanged = 0;
+            try {
+                const logOut = await runGit(["log", `${base}..HEAD`, "--oneline", "--no-merges"], workspace, signal);
+                commits = logOut
+                    .split("\n")
+                    .map((l) => l.replace(/^[a-f0-9]+ /, "").trim())
+                    .filter(Boolean);
+                const statOut = await runGit(["diff", `${base}..HEAD`, "--stat", "--no-color"], workspace, signal);
+                stats = statOut.trim();
+                // Extract file count from last stats line: "N files changed, ..."
+                const lastLine = stats.split("\n").pop() ?? "";
+                const fileMatch = lastLine.match(/(\d+)\s+file/);
+                if (fileMatch)
+                    filesChanged = Number.parseInt(fileMatch[1] ?? "0", 10);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return error(`Failed to get git history: ${msg}. Ensure branch '${base}' exists.`);
+            }
+            if (commits.length === 0) {
+                return successStructured({
+                    body: "",
+                    commits: 0,
+                    issueRefs: [],
+                    filesChanged: 0,
+                    base,
+                    note: `No commits found between ${base} and HEAD`,
+                });
+            }
+            const allText = commits.join("\n");
+            const issueRefs = extractIssueRefs(allText);
+            let body;
+            switch (style) {
+                case "prose":
+                    body = formatProse(commits, stats, issueRefs);
+                    break;
+                case "conventional":
+                    body = formatConventional(commits, stats, issueRefs);
+                    break;
+                default:
+                    body = formatBullet(commits, stats, issueRefs);
+            }
+            return successStructured({
+                body,
+                commits: commits.length,
+                issueRefs,
+                filesChanged,
+                base,
+                style,
+            });
+        },
+    };
+}
+//# sourceMappingURL=getPRTemplate.js.map

package/dist/tools/getPRTemplate.js.map

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

package/dist/tools/getProjectContext.d.ts

@@ -0,0 +1,114 @@
+import type { ExtensionClient } from "../extensionClient.js";
+import type { ProbeResults } from "../probe.js";
+/**
+ * getProjectContext — cached session-start context brief.
+ *
+ * Returns a lightweight summary of the project (active file, errors, recent
+ * commits, top modules) that Claude can inject at session start to skip
+ * codebase re-exploration. Brief is cached for 24 hours (configurable) and
+ * can be force-invalidated with force=true.
+ */
+export declare function createGetProjectContextTool(workspace: string, extensionClient: ExtensionClient, probes: ProbeResults, opts?: {
+    onCacheUpdated?: (generatedAt: string) => void;
+}): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        cache_control: {
+            type: "ephemeral";
+        };
+        inputSchema: {
+            type: "object";
+            additionalProperties: false;
+            properties: {
+                maxAgeMs: {
+                    type: "integer";
+                    description: string;
+                    minimum: number;
+                };
+                force: {
+                    type: "boolean";
+                    description: string;
+                };
+                sections: {
+                    type: "array";
+                    description: string;
+                    items: {
+                        type: "string";
+                        enum: readonly ["files", "errors", "git", "modules", "all"];
+                    };
+                };
+            };
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                workspace: {
+                    type: string;
+                };
+                generatedAt: {
+                    type: string;
+                };
+                fromCache: {
+                    type: string;
+                };
+                brief: {
+                    type: string;
+                    properties: {
+                        activeFile: {
+                            type: string[];
+                        };
+                        recentErrors: {
+                            type: string;
+                        };
+                        recentCommits: {
+                            type: string;
+                        };
+                        topModules: {
+                            type: string;
+                        };
+                        openFiles: {
+                            type: string;
+                        };
+                        diagnosticSummary: {
+                            type: string;
+                        };
+                    };
+                    required: string[];
+                };
+                memoryGraphQueries: {
+                    type: string;
+                };
+                suggestedPrompt: {
+                    type: string;
+                };
+                hint: {
+                    type: string;
+                };
+                topModulesSource: {
+                    type: string;
+                    enum: string[];
+                };
+                ctagsStatus: {
+                    type: string;
+                    enum: string[];
+                };
+            };
+            required: string[];
+        };
+    };
+    handler: (params: {
+        maxAgeMs?: number;
+        force?: boolean;
+        sections?: string[];
+    }) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    }>;
+};