patchwork-os 0.2.0-alpha.0

package/dist/tools/getGitHotspots.d.ts

@@ -0,0 +1,88 @@
+export declare function createGetGitHotspotsTool(workspace: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                days: {
+                    type: string;
+                    minimum: number;
+                    maximum: number;
+                    description: string;
+                };
+                limit: {
+                    type: string;
+                    minimum: number;
+                    maximum: number;
+                    description: string;
+                };
+                path: {
+                    type: string;
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                since: {
+                    type: string;
+                    description: string;
+                };
+                days: {
+                    type: string;
+                    description: string;
+                };
+                totalCommitsScanned: {
+                    type: string;
+                    description: string;
+                };
+                hotspots: {
+                    type: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            file: {
+                                type: string;
+                            };
+                            commits: {
+                                type: string;
+                                description: string;
+                            };
+                            rank: {
+                                type: string;
+                                description: string;
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                scopedTo: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    timeoutMs: number;
+    handler(args: Record<string, unknown>, signal?: AbortSignal): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+            _meta?: Record<string, unknown>;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};

package/dist/tools/getGitHotspots.js

@@ -0,0 +1,145 @@
+import { error, execSafe, optionalInt, optionalString, successStructuredLarge, } from "./utils.js";
+export function createGetGitHotspotsTool(workspace) {
+    return {
+        schema: {
+            name: "getGitHotspots",
+            description: "Most frequently changed files in git history. High frequency → active dev or instability.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    days: {
+                        type: "integer",
+                        minimum: 1,
+                        maximum: 365,
+                        description: "Lookback window in days (default: 90)",
+                    },
+                    limit: {
+                        type: "integer",
+                        minimum: 1,
+                        maximum: 100,
+                        description: "Max hotspot files to return (default: 20)",
+                    },
+                    path: {
+                        type: "string",
+                        description: "Subdirectory or glob to scope analysis (e.g. 'src/'). Default: entire repo",
+                    },
+                },
+                additionalProperties: false,
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    since: {
+                        type: "string",
+                        description: "ISO date string — start of the lookback window",
+                    },
+                    days: { type: "integer", description: "Lookback window in days" },
+                    totalCommitsScanned: {
+                        type: "integer",
+                        description: "Total commits in the time window",
+                    },
+                    hotspots: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                file: { type: "string" },
+                                commits: {
+                                    type: "integer",
+                                    description: "Number of commits touching this file",
+                                },
+                                rank: {
+                                    type: "integer",
+                                    description: "1-based rank by commit count",
+                                },
+                            },
+                            required: ["file", "commits", "rank"],
+                        },
+                    },
+                    scopedTo: {
+                        type: "string",
+                        description: "Present when analysis was scoped to a subdirectory",
+                    },
+                },
+                required: ["since", "days", "totalCommitsScanned", "hotspots"],
+            },
+        },
+        timeoutMs: 15_000,
+        async handler(args, signal) {
+            const days = optionalInt(args, "days", 1, 365) ?? 90;
+            const limit = optionalInt(args, "limit", 1, 100) ?? 20;
+            const path = optionalString(args, "path");
+            // 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");
+            }
+            const since = new Date(Date.now() - days * 24 * 60 * 60 * 1000)
+                .toISOString()
+                .slice(0, 10);
+            const gitArgs = [
+                "log",
+                `--since=${since}`,
+                "--name-only",
+                "--pretty=format:",
+                "--no-renames",
+                "--",
+            ];
+            if (path) {
+                gitArgs.push(path);
+            }
+            else {
+                gitArgs.push(".");
+            }
+            const result = await execSafe("git", gitArgs, {
+                cwd: workspace,
+                signal,
+                timeout: 15_000,
+                maxBuffer: 4 * 1024 * 1024,
+            });
+            if (result.timedOut) {
+                return error("git log timed out");
+            }
+            // Count file appearances
+            const counts = new Map();
+            let totalCommits = 0;
+            for (const line of result.stdout.split("\n")) {
+                const trimmed = line.trim();
+                if (!trimmed) {
+                    // blank lines separate commits (after --pretty=format: they count commit boundaries)
+                    continue;
+                }
+                counts.set(trimmed, (counts.get(trimmed) ?? 0) + 1);
+            }
+            // Count total commits by looking at lines that are empty (commit separators) —
+            // actually count via a separate git command for accuracy
+            const commitCountResult = await execSafe("git", ["rev-list", "--count", `--since=${since}`, "HEAD"], { cwd: workspace, signal, timeout: 5_000 });
+            if (!commitCountResult.timedOut && commitCountResult.exitCode === 0) {
+                totalCommits =
+                    Number.parseInt(commitCountResult.stdout.trim(), 10) || 0;
+            }
+            // Sort by commit count descending
+            const sorted = Array.from(counts.entries())
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, limit);
+            const hotspots = sorted.map(([file, commits], i) => ({
+                file,
+                commits,
+                rank: i + 1,
+            }));
+            return successStructuredLarge({
+                since,
+                days,
+                totalCommitsScanned: totalCommits,
+                hotspots,
+                ...(path ? { scopedTo: path } : {}),
+            });
+        },
+    };
+}
+//# sourceMappingURL=getGitHotspots.js.map

package/dist/tools/getGitHotspots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getGitHotspots.js","sourceRoot":"","sources":["../../src/tools/getGitHotspots.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,QAAQ,EACR,WAAW,EACX,cAAc,EACd,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAQpB,MAAM,UAAU,wBAAwB,CAAC,SAAiB;IACxD,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,gBAAgB;YACtB,WAAW,EACT,2FAA2F;YAC7F,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;YACnC,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,IAAI,EAAE;wBACJ,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,GAAG;wBACZ,WAAW,EAAE,uCAAuC;qBACrD;oBACD,KAAK,EAAE;wBACL,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,GAAG;wBACZ,WAAW,EAAE,2CAA2C;qBACzD;oBACD,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,4EAA4E;qBAC/E;iBACF;gBACD,oBAAoB,EAAE,KAAc;aACrC;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,gDAAgD;qBAC9D;oBACD,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,yBAAyB,EAAE;oBACjE,mBAAmB,EAAE;wBACnB,IAAI,EAAE,SAAS;wBACf,WAAW,EAAE,kCAAkC;qBAChD;oBACD,QAAQ,EAAE;wBACR,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,UAAU,EAAE;gCACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gCACxB,OAAO,EAAE;oCACP,IAAI,EAAE,SAAS;oCACf,WAAW,EAAE,sCAAsC;iCACpD;gCACD,IAAI,EAAE;oCACJ,IAAI,EAAE,SAAS;oCACf,WAAW,EAAE,8BAA8B;iCAC5C;6BACF;4BACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC;yBACtC;qBACF;oBACD,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,oDAAoD;qBAClE;iBACF;gBACD,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,UAAU,CAAC;aAC/D;SACF;QACD,SAAS,EAAE,MAAM;QAEjB,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,MAAoB;YAC/D,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;YACrD,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;YACvD,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAE1C,kBAAkB;YAClB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE;gBAC9D,GAAG,EAAE,SAAS;gBACd,MAAM;gBACN,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;YACH,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,KAAK,CAAC,sBAAsB,CAAC,CAAC;YACvC,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;iBAC5D,WAAW,EAAE;iBACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAEhB,MAAM,OAAO,GAAG;gBACd,KAAK;gBACL,WAAW,KAAK,EAAE;gBAClB,aAAa;gBACb,kBAAkB;gBAClB,cAAc;gBACd,IAAI;aACL,CAAC;YACF,IAAI,IAAI,EAAE,CAAC;gBACT,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE;gBAC5C,GAAG,EAAE,SAAS;gBACd,MAAM;gBACN,OAAO,EAAE,MAAM;gBACf,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;aAC3B,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,OAAO,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACpC,CAAC;YAED,yBAAyB;YACzB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;YACzC,IAAI,YAAY,GAAG,CAAC,CAAC;YAErB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,qFAAqF;oBACrF,SAAS;gBACX,CAAC;gBACD,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACtD,CAAC;YAED,+EAA+E;YAC/E,yDAAyD;YACzD,MAAM,iBAAiB,GAAG,MAAM,QAAQ,CACtC,KAAK,EACL,CAAC,UAAU,EAAE,SAAS,EAAE,WAAW,KAAK,EAAE,EAAE,MAAM,CAAC,EACnD,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAC3C,CAAC;YACF,IAAI,CAAC,iBAAiB,CAAC,QAAQ,IAAI,iBAAiB,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBACpE,YAAY;oBACV,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;YAC9D,CAAC;YAED,kCAAkC;YAClC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;iBACxC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;iBAC3B,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAEnB,MAAM,QAAQ,GAAc,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9D,IAAI;gBACJ,OAAO;gBACP,IAAI,EAAE,CAAC,GAAG,CAAC;aACZ,CAAC,CAAC,CAAC;YAEJ,OAAO,sBAAsB,CAAC;gBAC5B,KAAK;gBACL,IAAI;gBACJ,mBAAmB,EAAE,YAAY;gBACjC,QAAQ;gBACR,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/getGitLog.d.ts

@@ -0,0 +1,62 @@
+export declare function createGetGitLogTool(workspace: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            $schema: string;
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                maxEntries: {
+                    type: string;
+                    description: string;
+                };
+                filePath: {
+                    type: string;
+                    description: string;
+                };
+            };
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                entries: {
+                    type: string;
+                    items: {
+                        type: string;
+                        properties: {
+                            hash: {
+                                type: string;
+                            };
+                            author: {
+                                type: string;
+                            };
+                            date: {
+                                type: string;
+                            };
+                            subject: {
+                                type: string;
+                            };
+                        };
+                        required: string[];
+                    };
+                };
+                error: {
+                    type: string;
+                };
+            };
+            required: never[];
+        };
+    };
+    handler(args: Record<string, unknown>, signal?: AbortSignal): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+            _meta?: Record<string, unknown>;
+        }>;
+        structuredContent: unknown;
+    }>;
+};

package/dist/tools/getGitLog.js

@@ -0,0 +1,87 @@
+import { execSafe, optionalInt, optionalString, resolveFilePath, successStructuredLarge, } from "./utils.js";
+export function createGetGitLogTool(workspace) {
+    return {
+        schema: {
+            name: "getGitLog",
+            description: "Get recent git log entries for the workspace or a specific file",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    maxEntries: {
+                        type: "integer",
+                        description: "Max log entries to return (default: 20, max: 100)",
+                    },
+                    filePath: {
+                        type: "string",
+                        description: "Filter log to a single file (absolute or workspace-relative)",
+                    },
+                },
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    entries: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                hash: { type: "string" },
+                                author: { type: "string" },
+                                date: { type: "string" },
+                                subject: { type: "string" },
+                            },
+                            required: ["hash", "author", "date", "subject"],
+                        },
+                    },
+                    error: { type: "string" },
+                },
+                required: [],
+            },
+        },
+        async handler(args, signal) {
+            const maxEntries = optionalInt(args, "maxEntries", 1, 100) ?? 20;
+            const rawPath = optionalString(args, "filePath");
+            const filterPath = rawPath
+                ? resolveFilePath(rawPath, workspace)
+                : undefined;
+            const logArgs = [
+                "log",
+                "--format=%H %ae %aI %s",
+                "--no-merges",
+                `-${maxEntries}`,
+            ];
+            if (filterPath) {
+                logArgs.push("--", filterPath);
+            }
+            const result = await execSafe("git", logArgs, {
+                cwd: workspace,
+                signal,
+            });
+            if (result.exitCode !== 0) {
+                return successStructuredLarge({
+                    error: result.stderr.trim() || "git log failed",
+                });
+            }
+            const entries = [];
+            for (const line of result.stdout.split("\n")) {
+                if (!line)
+                    continue;
+                // Format: <hash> <email> <date> <subject...>
+                const match = line.match(/^(\S+) (\S+) (\S+) (.+)$/);
+                if (match) {
+                    entries.push({
+                        hash: match[1],
+                        author: match[2],
+                        date: match[3],
+                        subject: match[4],
+                    });
+                }
+            }
+            return successStructuredLarge({ entries });
+        },
+    };
+}
+//# sourceMappingURL=getGitLog.js.map

package/dist/tools/getGitLog.js.map

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

package/dist/tools/getGitStatus.d.ts

@@ -0,0 +1,72 @@
+export declare function createGetGitStatusTool(workspace: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            $schema: string;
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                filePath: {
+                    type: string;
+                    description: string;
+                };
+            };
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                available: {
+                    type: string;
+                };
+                branch: {
+                    type: string;
+                };
+                ahead: {
+                    type: string;
+                };
+                behind: {
+                    type: string;
+                };
+                staged: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                unstaged: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                untracked: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                conflicts: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                error: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler(args: Record<string, unknown>, signal?: AbortSignal): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    }>;
+};

package/dist/tools/getGitStatus.js

@@ -0,0 +1,126 @@
+import { execSafe, optionalString, resolveFilePath, successStructured, } from "./utils.js";
+export function createGetGitStatusTool(workspace) {
+    return {
+        schema: {
+            name: "getGitStatus",
+            description: "Git status: branch, staged/unstaged/untracked files, ahead/behind counts.",
+            annotations: { readOnlyHint: true },
+            inputSchema: {
+                $schema: "http://json-schema.org/draft-07/schema#",
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "Filter status to a single file (absolute or workspace-relative)",
+                    },
+                },
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    available: { type: "boolean" },
+                    branch: { type: "string" },
+                    ahead: { type: "integer" },
+                    behind: { type: "integer" },
+                    staged: { type: "array", items: { type: "string" } },
+                    unstaged: { type: "array", items: { type: "string" } },
+                    untracked: { type: "array", items: { type: "string" } },
+                    conflicts: { type: "array", items: { type: "string" } },
+                    error: { type: "string" },
+                },
+                required: ["available"],
+            },
+        },
+        async handler(args, signal) {
+            const rawPath = optionalString(args, "filePath");
+            const filterPath = rawPath
+                ? resolveFilePath(rawPath, workspace)
+                : undefined;
+            // Check if this is a git repo
+            const checkGit = await execSafe("git", ["rev-parse", "--git-dir"], {
+                cwd: workspace,
+                signal,
+            });
+            if (checkGit.exitCode !== 0) {
+                return successStructured({
+                    available: false,
+                    error: "Not a git repository",
+                });
+            }
+            // Get branch name
+            const branchResult = await execSafe("git", ["rev-parse", "--abbrev-ref", "HEAD"], { cwd: workspace, signal });
+            const branch = branchResult.stdout.trim();
+            // Get ahead/behind counts (ignore error if no upstream)
+            let ahead = 0;
+            let behind = 0;
+            const revListResult = await execSafe("git", ["rev-list", "--count", "--left-right", "HEAD...@{u}"], { cwd: workspace, signal });
+            if (revListResult.exitCode === 0) {
+                const parts = revListResult.stdout.trim().split(/\s+/);
+                ahead = Number.parseInt(parts[0] ?? "0", 10);
+                behind = Number.parseInt(parts[1] ?? "0", 10);
+            }
+            // Get file status
+            const statusArgs = ["status", "--porcelain=v1", "-u"];
+            if (filterPath) {
+                statusArgs.push("--", filterPath);
+            }
+            const statusResult = await execSafe("git", statusArgs, {
+                cwd: workspace,
+                signal,
+            });
+            const staged = [];
+            const unstaged = [];
+            const untracked = [];
+            const conflicts = [];
+            for (const line of statusResult.stdout.split("\n")) {
+                if (!line)
+                    continue;
+                const x = line[0] ?? " ";
+                const y = line[1] ?? " ";
+                const file = line.slice(3);
+                // Conflict markers
+                if (x === "U" ||
+                    y === "U" ||
+                    (x === "A" && y === "A") ||
+                    (x === "D" && y === "D")) {
+                    conflicts.push(file);
+                    continue;
+                }
+                if (x === "?" && y === "?") {
+                    untracked.push(file);
+                    continue;
+                }
+                if (x !== " " && x !== "?") {
+                    staged.push(file);
+                }
+                if (y !== " " && y !== "?") {
+                    unstaged.push(file);
+                }
+            }
+            const GIT_STATUS_MAX_FILES = 500;
+            const capList = (arr) => arr.length > GIT_STATUS_MAX_FILES
+                ? { files: arr.slice(0, GIT_STATUS_MAX_FILES), truncated: true }
+                : { files: arr };
+            const sc = capList(staged);
+            const uc = capList(unstaged);
+            const tc = capList(untracked);
+            const cc = capList(conflicts);
+            return successStructured({
+                available: true,
+                branch,
+                ahead,
+                behind,
+                staged: sc.files,
+                unstaged: uc.files,
+                untracked: tc.files,
+                conflicts: cc.files,
+                ...(sc.truncated && { stagedTruncated: true }),
+                ...(uc.truncated && { unstagedTruncated: true }),
+                ...(tc.truncated && { untrackedTruncated: true }),
+                ...(cc.truncated && { conflictsTruncated: true }),
+            });
+        },
+    };
+}
+//# sourceMappingURL=getGitStatus.js.map

package/dist/tools/getGitStatus.js.map

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

package/dist/tools/getImportTree.d.ts

@@ -0,0 +1,73 @@
+export declare function createGetImportTreeTool(workspace: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+        };
+        inputSchema: {
+            $schema: string;
+            type: "object";
+            required: string[];
+            properties: {
+                file: {
+                    type: string;
+                };
+                maxDepth: {
+                    type: string;
+                    minimum: number;
+                    maximum: number;
+                    description: string;
+                };
+                includeExternal: {
+                    type: string;
+                    description: string;
+                };
+            };
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                file: {
+                    type: string;
+                };
+                tree: {
+                    anyOf: {
+                        type: string;
+                    }[];
+                };
+                cycles: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                totalFiles: {
+                    type: string;
+                };
+                maxDepth: {
+                    type: string;
+                };
+                external: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                error: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler(args: Record<string, unknown>, _signal?: AbortSignal, progress?: import("../transport.js").ProgressFn): Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+            _meta?: Record<string, unknown>;
+        }>;
+        structuredContent: unknown;
+    }>;
+};