patchwork-os 0.2.0-alpha.0

package/dist/tools/contextBundle.js

@@ -0,0 +1,218 @@
+import { readNote } from "./handoffNote.js";
+import { execSafe, successStructured } from "./utils.js";
+/**
+ * contextBundle — composite tool that collects the most useful IDE context
+ * in a single call, eliminating multiple cold-start round-trips.
+ *
+ * All sub-calls run in parallel via Promise.allSettled; individual failures
+ * are silently omitted so partial results are still useful.
+ */
+export function createContextBundleTool(workspace, extensionClient) {
+    return {
+        schema: {
+            name: "contextBundle",
+            description: "Collect IDE context in one call: active file, diagnostics, diff, editors, handoff note, git status.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    includeDiff: {
+                        type: "boolean",
+                        description: "Include recent git diff (staged + unstaged). Default: true",
+                    },
+                    includeHandoffNote: {
+                        type: "boolean",
+                        description: "Include the workspace handoff note. Default: true",
+                    },
+                    summarize: {
+                        type: "boolean",
+                        description: "Summarize output for token efficiency: top-5 diagnostics, 20-line active file window, 100-line diff cap, diagnosticSummary string. Default: false",
+                    },
+                },
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    activeFile: { type: "string" },
+                    activeFileContent: { type: "string" },
+                    diagnostics: { type: "array" },
+                    diff: { type: "string" },
+                    openEditors: { type: "array" },
+                    handoffNote: { type: "string" },
+                    gitStatus: { type: "object" },
+                    bundledAt: { type: "number" },
+                    diagnosticSummary: { type: "string" },
+                },
+                required: ["bundledAt"],
+            },
+        },
+        async handler(args, signal) {
+            const includeDiff = args.includeDiff !== false;
+            const includeHandoffNote = args.includeHandoffNote !== false;
+            const summarize = args.summarize === true;
+            const connected = extensionClient.isConnected();
+            // Run all sub-calls in parallel; failures become undefined
+            const [diagnosticsResult, openEditorsResult, activeFileContentResult, gitStatusResult, gitDiffResult, handoffNoteResult,] = await Promise.allSettled([
+                connected ? extensionClient.getDiagnostics() : Promise.resolve(null),
+                connected ? extensionClient.getOpenFiles() : Promise.resolve(null),
+                connected && extensionClient.latestActiveFile
+                    ? extensionClient.getFileContent(extensionClient.latestActiveFile)
+                    : Promise.resolve(null),
+                execSafe("git", ["status", "--porcelain=v1", "--branch"], {
+                    cwd: workspace,
+                    signal,
+                }),
+                includeDiff
+                    ? execSafe("git", ["diff", "HEAD", "--stat", "--", "."], {
+                        cwd: workspace,
+                        signal,
+                    })
+                    : Promise.resolve(null),
+                includeHandoffNote ? readNote(workspace) : Promise.resolve(null),
+            ]);
+            const bundle = {
+                bundledAt: Date.now(),
+            };
+            // Active file (from live extension state)
+            if (extensionClient.latestActiveFile) {
+                bundle.activeFile = extensionClient.latestActiveFile;
+                // Workspace-relative path for downstream tools
+                if (extensionClient.latestActiveFile.startsWith(`${workspace}/`)) {
+                    bundle.activeFileRelativePath =
+                        extensionClient.latestActiveFile.slice(workspace.length + 1);
+                }
+            }
+            // Active file content — getFileContent returns { content, languageId, isDirty, ... }
+            if (activeFileContentResult.status === "fulfilled" &&
+                activeFileContentResult.value !== null &&
+                typeof activeFileContentResult.value === "object") {
+                const fc = activeFileContentResult.value;
+                if (typeof fc.content === "string") {
+                    const content = fc.content;
+                    if (summarize) {
+                        // 20-line window: around first error if any, else first 20 lines
+                        const lines = content.split("\n");
+                        const diags = diagnosticsResult.status === "fulfilled" &&
+                            Array.isArray(diagnosticsResult.value)
+                            ? diagnosticsResult.value
+                            : [];
+                        const activeFile = extensionClient.latestActiveFile ?? "";
+                        const firstError = diags.find((d) => d.severity === "error" &&
+                            typeof d.line === "number" &&
+                            (String(d.file ?? "").endsWith(activeFile.split("/").pop() ?? "") ||
+                                d.file === activeFile));
+                        const errorLine = firstError && typeof firstError.line === "number"
+                            ? firstError.line - 1
+                            : 0;
+                        const start = Math.max(0, errorLine - 5);
+                        const end = Math.min(lines.length, start + 20);
+                        bundle.activeFileContent = lines.slice(start, end).join("\n");
+                    }
+                    else {
+                        // Truncate to 16KB to keep context manageable
+                        bundle.activeFileContent =
+                            content.length > 16384
+                                ? content.slice(0, 16384) +
+                                    "\n[file truncated at 16KB — use getBufferContent for full content]"
+                                : content;
+                    }
+                }
+                if (typeof fc.languageId === "string") {
+                    bundle.activeFileLanguageId = fc.languageId;
+                }
+                if (typeof fc.isDirty === "boolean") {
+                    bundle.activeFileIsDirty = fc.isDirty;
+                }
+            }
+            // Diagnostics — capped to avoid dwarfing the 16KB active-file budget
+            const CONTEXT_BUNDLE_MAX_DIAGNOSTICS = summarize ? 5 : 50;
+            const SEVERITY_RANK = {
+                error: 3,
+                warning: 2,
+                information: 1,
+                hint: 0,
+            };
+            if (diagnosticsResult.status === "fulfilled" &&
+                Array.isArray(diagnosticsResult.value)) {
+                const diags = diagnosticsResult.value;
+                const diagsUnknown = diags;
+                if (summarize) {
+                    // Sort errors first, then warnings, then rest; keep top-5
+                    diagsUnknown.sort((a, b) => {
+                        const ra = SEVERITY_RANK[a.severity] ?? 0;
+                        const rb = SEVERITY_RANK[b.severity] ?? 0;
+                        return rb - ra;
+                    });
+                }
+                bundle.diagnostics = diagsUnknown.slice(0, CONTEXT_BUNDLE_MAX_DIAGNOSTICS);
+                if (diagsUnknown.length > CONTEXT_BUNDLE_MAX_DIAGNOSTICS) {
+                    bundle.diagnosticsTruncated = true;
+                    bundle.diagnosticsTotalCount = diagsUnknown.length;
+                }
+                if (summarize) {
+                    // Build diagnosticSummary: "3 TypeScript errors in auth.ts, 2 warnings in utils.ts"
+                    const countsByFileSeverity = new Map();
+                    for (const d of diagsUnknown) {
+                        const rec = d;
+                        const sev = String(rec.severity ?? "error");
+                        const file = String(rec.file ?? "unknown");
+                        const baseName = file.split("/").pop() ?? file;
+                        const key = `${sev}:${baseName}`;
+                        countsByFileSeverity.set(key, (countsByFileSeverity.get(key) ?? 0) + 1);
+                    }
+                    const parts = [];
+                    for (const [key, count] of countsByFileSeverity) {
+                        const [sev, fileName] = key.split(":");
+                        parts.push(`${count} ${sev}${count !== 1 ? "s" : ""} in ${fileName}`);
+                    }
+                    bundle.diagnosticSummary =
+                        parts.length > 0 ? parts.join(", ") : "No diagnostics";
+                }
+            }
+            // Open editors
+            if (openEditorsResult.status === "fulfilled" &&
+                Array.isArray(openEditorsResult.value)) {
+                bundle.openEditors = openEditorsResult.value;
+            }
+            // Git status
+            if (gitStatusResult.status === "fulfilled" &&
+                gitStatusResult.value !== null &&
+                gitStatusResult.value.exitCode === 0) {
+                bundle.gitStatus = { raw: gitStatusResult.value.stdout.trim() };
+            }
+            // Git diff summary
+            if (includeDiff &&
+                gitDiffResult.status === "fulfilled" &&
+                gitDiffResult.value !== null &&
+                gitDiffResult.value
+                    .exitCode === 0) {
+                const diffOut = gitDiffResult.value.stdout.trim();
+                if (diffOut) {
+                    if (summarize) {
+                        const diffLines = diffOut.split("\n");
+                        if (diffLines.length > 100) {
+                            bundle.diff =
+                                diffLines.slice(0, 100).join("\n") +
+                                    `\n[diff truncated — ${diffLines.length - 100} lines omitted]`;
+                        }
+                        else {
+                            bundle.diff = diffOut;
+                        }
+                    }
+                    else {
+                        bundle.diff = diffOut;
+                    }
+                }
+            }
+            // Handoff note
+            if (includeHandoffNote &&
+                handoffNoteResult.status === "fulfilled" &&
+                handoffNoteResult.value !== null) {
+                bundle.handoffNote = handoffNoteResult.value.note;
+            }
+            return successStructured(bundle);
+        },
+    };
+}
+//# sourceMappingURL=contextBundle.js.map

package/dist/tools/contextBundle.js.map

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

package/dist/tools/createIssueFromAIComment.d.ts

@@ -0,0 +1,75 @@
+import type { AIComment } from "../extensionClient.js";
+export declare function createCreateIssueFromAICommentTool(workspace: string, latestAIComments: Map<string, AIComment[]>): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            required: string[];
+            properties: {
+                file: {
+                    type: string;
+                    description: string;
+                };
+                line: {
+                    type: string;
+                    minimum: number;
+                    description: string;
+                };
+                title: {
+                    type: string;
+                    description: string;
+                };
+                labels: {
+                    type: string;
+                    description: string;
+                };
+                assignee: {
+                    type: string;
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                url: {
+                    type: string;
+                };
+                number: {
+                    type: string[];
+                };
+                title: {
+                    type: string;
+                };
+                commentFile: {
+                    type: string;
+                };
+                commentLine: {
+                    type: string;
+                };
+                severity: {
+                    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/createIssueFromAIComment.js

@@ -0,0 +1,119 @@
+import path from "node:path";
+import { GH_NOT_AUTHED, GH_NOT_FOUND, isNotAuthed, isNotFound, } from "./github/shared.js";
+import { error, execSafe, optionalString, requireInt, requireString, successStructured, } from "./utils.js";
+export function createCreateIssueFromAICommentTool(workspace, latestAIComments) {
+    return {
+        schema: {
+            name: "createGithubIssueFromAIComment",
+            description: "Create GitHub issue from AI comment. Call getAIComments first to populate cache.",
+            annotations: { destructiveHint: true },
+            inputSchema: {
+                type: "object",
+                required: ["file", "line"],
+                properties: {
+                    file: {
+                        type: "string",
+                        description: "File containing the AI comment",
+                    },
+                    line: {
+                        type: "integer",
+                        minimum: 1,
+                        description: "Line number of the AI comment",
+                    },
+                    title: {
+                        type: "string",
+                        description: "Issue title (default: derived from comment)",
+                    },
+                    labels: {
+                        type: "string",
+                        description: "Comma-separated labels (e.g. 'bug,ai-comment')",
+                    },
+                    assignee: {
+                        type: "string",
+                        description: "GitHub username to assign",
+                    },
+                },
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    url: { type: "string" },
+                    number: { type: ["integer", "null"] },
+                    title: { type: "string" },
+                    commentFile: { type: "string" },
+                    commentLine: { type: "integer" },
+                    severity: { type: "string" },
+                },
+                required: ["url", "title", "commentFile", "commentLine"],
+            },
+        },
+        handler: async (args, signal) => {
+            const file = requireString(args, "file");
+            const line = requireInt(args, "line", 1);
+            const titleArg = optionalString(args, "title", 256);
+            const labels = optionalString(args, "labels", 512);
+            const assignee = optionalString(args, "assignee", 256);
+            // Look up comment in cache
+            const commentsForFile = latestAIComments.get(file);
+            const comment = commentsForFile?.find((c) => c.line === line);
+            if (!comment) {
+                return error(`No AI comment found at ${file}:${line}. Run getAIComments first.`);
+            }
+            // Derive title
+            let title;
+            if (titleArg) {
+                title = titleArg;
+            }
+            else {
+                const rawText = comment.comment ?? "";
+                // Strip leading "AI:" prefix if present
+                const stripped = rawText.replace(/^AI:\s*/i, "").trim();
+                title = stripped.length > 72 ? stripped.slice(0, 72) : stripped;
+            }
+            // Compute relative path
+            let relPath;
+            try {
+                relPath = path.relative(workspace, file);
+            }
+            catch {
+                relPath = path.basename(file);
+            }
+            // Build body
+            const body = `**AI Comment** found in \`${relPath}\` at line ${line}\n\n> ${comment.comment}\n\n**Severity:** ${comment.severity ?? "task"}\n\n---\n*Created from AI comment via Claude IDE Bridge*`;
+            // Build gh args
+            const ghArgs = ["issue", "create", "--title", title, "--body", body];
+            if (labels)
+                ghArgs.push("--label", labels);
+            if (assignee)
+                ghArgs.push("--assignee", assignee);
+            const result = await execSafe("gh", ghArgs, {
+                cwd: workspace,
+                signal,
+                timeout: 15_000,
+            });
+            if (result.exitCode !== 0) {
+                const msg = result.stderr.trim() || result.stdout.trim();
+                if (isNotFound(msg))
+                    return error(GH_NOT_FOUND);
+                if (isNotAuthed(msg))
+                    return error(`${GH_NOT_AUTHED}\n${msg}`);
+                return error(`gh issue create failed: ${msg}`);
+            }
+            const url = result.stdout.trim();
+            const numberMatch = url.match(/\/issues\/(\d+)/);
+            const number = numberMatch
+                ? Number.parseInt(numberMatch[1] ?? "0", 10)
+                : null;
+            return successStructured({
+                url,
+                number,
+                title,
+                commentFile: file,
+                commentLine: line,
+                severity: comment.severity ?? "task",
+            });
+        },
+    };
+}
+//# sourceMappingURL=createIssueFromAIComment.js.map

package/dist/tools/createIssueFromAIComment.js.map

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

package/dist/tools/ctxGetTaskContext.d.ts

@@ -0,0 +1,103 @@
+import type { CommitIssueLinkLog } from "../commitIssueLinkLog.js";
+/**
+ * Unified task-context resolver advertised in the MCP handshake as
+ * `ctxGetTaskContext(ref)`. Detects the ref type (`#42` / `GH-42` → issue,
+ * `PR-42` / `pull/42` → PR, 7+ hex → commit) and composes existing tools
+ * to return one structured view:
+ *
+ *   {
+ *     ref, refType,
+ *     issue?: { number, title, state, url, body?, labels?, assignees? },
+ *     pullRequest?: { number, title, state, url, body? },
+ *     commit?: { sha, author, date, subject, body, files? },
+ *     linkedCommits?: [{ sha, subject, linkType, resolved }],
+ *     related?: { recent: [{ref, subject, sha}] }
+ *   }
+ *
+ * Fail-soft: missing `gh`, non-git workspace, unresolved ref → flagged in
+ * output, never thrown. Agents can reason over a partial context.
+ */
+export interface CtxTaskContextDeps {
+    workspace: string;
+    commitIssueLinkLog?: CommitIssueLinkLog | null;
+}
+export type RefType = "issue" | "pull_request" | "commit" | "unknown";
+export declare function createCtxGetTaskContextTool(deps: CtxTaskContextDeps): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            required: string[];
+            properties: {
+                ref: {
+                    type: string;
+                    description: string;
+                };
+                maxLinkedCommits: {
+                    type: string;
+                    minimum: number;
+                    maximum: number;
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: "object";
+            properties: {
+                ref: {
+                    type: string;
+                };
+                refType: {
+                    type: string;
+                    enum: string[];
+                };
+                issue: {
+                    type: string[];
+                };
+                pullRequest: {
+                    type: string[];
+                };
+                commit: {
+                    type: string[];
+                };
+                linkedCommits: {
+                    type: string;
+                };
+                sources: {
+                    type: string;
+                    properties: {
+                        gh: {
+                            type: string;
+                        };
+                        git: {
+                            type: string;
+                        };
+                        linkLog: {
+                            type: string;
+                        };
+                    };
+                };
+                warnings: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+            };
+            required: string[];
+        };
+    };
+    timeoutMs: number;
+    handler(args: Record<string, unknown>, signal?: AbortSignal): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    }>;
+};