@tachu/extensions 1.0.0-alpha.3 → 1.0.0-alpha.4

package/dist/tools/git-status/executor.d.ts

@@ -0,0 +1,25 @@
+import type { ToolExecutor } from "../shared";
+interface GitStatusInput {
+    cwd?: string;
+}
+interface GitFileEntry {
+    path: string;
+    originalPath?: string;
+    status: string;
+}
+interface GitStatusOutput {
+    branch: string;
+    upstream?: string;
+    ahead: number;
+    behind: number;
+    staged: GitFileEntry[];
+    unstaged: GitFileEntry[];
+    untracked: string[];
+    isClean: boolean;
+    detachedHead: boolean;
+}
+export declare const gitStatusExecutor: ToolExecutor<GitStatusInput, GitStatusOutput | {
+    error: string;
+}>;
+export {};
+//# sourceMappingURL=executor.d.ts.map

package/dist/tools/git-status/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/tools/git-status/executor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAI9C,UAAU,cAAc;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,eAAe;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;CACvB;AA0FD,eAAO,MAAM,iBAAiB,EAAE,YAAY,CAAC,cAAc,EAAE,eAAe,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CA4B7F,CAAC"}

package/dist/tools/git-status/executor.js

@@ -0,0 +1,120 @@
+import { resolve } from "node:path";
+import { assertNotAborted, resolveSandboxPolicy } from "../shared";
+import { resolveAllowedPath } from "../../common/path";
+const parsePortcelainV2 = (stdout) => {
+    const lines = stdout.split("\n");
+    let branch = "";
+    let upstream;
+    let ahead = 0;
+    let behind = 0;
+    let detachedHead = false;
+    const staged = [];
+    const unstaged = [];
+    const untracked = [];
+    for (const line of lines) {
+        if (line.startsWith("# branch.head ")) {
+            const head = line.slice("# branch.head ".length);
+            if (head === "(detached)") {
+                detachedHead = true;
+                branch = "HEAD";
+            }
+            else {
+                branch = head;
+            }
+        }
+        else if (line.startsWith("# branch.upstream ")) {
+            upstream = line.slice("# branch.upstream ".length);
+        }
+        else if (line.startsWith("# branch.ab ")) {
+            const ab = line.slice("# branch.ab ".length);
+            const match = ab.match(/\+(\d+)\s+-(\d+)/);
+            if (match) {
+                ahead = parseInt(match[1], 10);
+                behind = parseInt(match[2], 10);
+            }
+        }
+        else if (line.startsWith("1 ")) {
+            // ordinary changed entries: "1 XY sub mH mI mW hH hI path"
+            const parts = line.split(" ");
+            const xy = parts[1];
+            const filePath = parts.slice(8).join(" ");
+            const stagedStatus = xy[0];
+            const unstagedStatus = xy[1];
+            if (stagedStatus !== "." && stagedStatus !== " ") {
+                staged.push({ path: filePath, status: stagedStatus });
+            }
+            if (unstagedStatus !== "." && unstagedStatus !== " ") {
+                unstaged.push({ path: filePath, status: unstagedStatus });
+            }
+        }
+        else if (line.startsWith("2 ")) {
+            // renamed/copied entries: "2 XY sub mH mI mW hH hI X score origPath\tpath"
+            const parts = line.split(" ");
+            const xy = parts[1];
+            const stagedStatus = xy[0];
+            const unstagedStatus = xy[1];
+            // paths are at the end after a tab
+            const pathPart = parts.slice(9).join(" ");
+            const tabIdx = pathPart.indexOf("\t");
+            let filePath;
+            let originalPath;
+            if (tabIdx >= 0) {
+                originalPath = pathPart.slice(0, tabIdx);
+                filePath = pathPart.slice(tabIdx + 1);
+            }
+            else {
+                filePath = pathPart;
+            }
+            if (stagedStatus !== "." && stagedStatus !== " ") {
+                const entry = { path: filePath, status: stagedStatus };
+                if (originalPath)
+                    entry.originalPath = originalPath;
+                staged.push(entry);
+            }
+            if (unstagedStatus !== "." && unstagedStatus !== " ") {
+                unstaged.push({ path: filePath, status: unstagedStatus });
+            }
+        }
+        else if (line.startsWith("? ")) {
+            untracked.push(line.slice(2));
+        }
+    }
+    const isClean = staged.length === 0 && unstaged.length === 0 && untracked.length === 0;
+    const result = {
+        branch,
+        ahead,
+        behind,
+        staged,
+        unstaged,
+        untracked,
+        isClean,
+        detachedHead,
+    };
+    if (upstream !== undefined)
+        result.upstream = upstream;
+    return result;
+};
+export const gitStatusExecutor = async (input, context) => {
+    assertNotAborted(context.abortSignal);
+    const policy = resolveSandboxPolicy(context);
+    const cwd = input.cwd
+        ? resolveAllowedPath(input.cwd, policy)
+        : resolve(context.workspaceRoot);
+    const proc = Bun.spawn({
+        cmd: ["git", "status", "--porcelain=v2", "--branch"],
+        cwd,
+        stdout: "pipe",
+        stderr: "pipe",
+    });
+    const [stdout, stderr, exitCode] = await Promise.all([
+        new Response(proc.stdout).text(),
+        new Response(proc.stderr).text(),
+        proc.exited,
+    ]);
+    assertNotAborted(context.abortSignal);
+    if (exitCode !== 0) {
+        return { error: stderr || `git status exited with code ${exitCode}` };
+    }
+    return parsePortcelainV2(stdout);
+};
+//# sourceMappingURL=executor.js.map

package/dist/tools/git-status/executor.js.map

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

package/dist/tools/glob/executor.d.ts

@@ -0,0 +1,18 @@
+import type { ToolExecutor } from "../shared";
+interface GlobInput {
+    pattern: string;
+    cwd?: string;
+    ignore?: string[];
+    maxResults?: number;
+}
+interface GlobOutput {
+    files: string[];
+    truncated: boolean;
+    matchCount: number;
+}
+/**
+ * Glob 文件搜索 Tool 执行器。
+ */
+export declare const globExecutor: ToolExecutor<GlobInput, GlobOutput>;
+export {};
+//# sourceMappingURL=executor.d.ts.map

package/dist/tools/glob/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/tools/glob/executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAM9C,UAAU,SAAS;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAWD;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,YAAY,CAAC,SAAS,EAAE,UAAU,CAuC5D,CAAC"}

package/dist/tools/glob/executor.js

@@ -0,0 +1,47 @@
+import { resolve } from "node:path";
+import { resolveAllowedPath, toWorkspaceRelativePath } from "../../common/path";
+import { assertNotAborted, resolveSandboxPolicy } from "../shared";
+const DEFAULT_IGNORE = ["**/node_modules/**", "**/.git/**"];
+const DEFAULT_MAX_RESULTS = 1000;
+const matchesIgnore = (relPath, ignorePatterns) => {
+    for (const pattern of ignorePatterns) {
+        if (new Bun.Glob(pattern).match(relPath)) {
+            return true;
+        }
+    }
+    return false;
+};
+/**
+ * Glob 文件搜索 Tool 执行器。
+ */
+export const globExecutor = async (input, context) => {
+    assertNotAborted(context.abortSignal);
+    const policy = resolveSandboxPolicy(context);
+    const resolvedCwd = input.cwd !== undefined
+        ? resolveAllowedPath(input.cwd, policy)
+        : context.workspaceRoot;
+    const ignore = input.ignore !== undefined ? input.ignore : DEFAULT_IGNORE;
+    const maxResults = input.maxResults !== undefined ? input.maxResults : DEFAULT_MAX_RESULTS;
+    const files = [];
+    let truncated = false;
+    for await (const relPath of new Bun.Glob(input.pattern).scan({ cwd: resolvedCwd, onlyFiles: true })) {
+        if (matchesIgnore(relPath, ignore)) {
+            continue;
+        }
+        const absPath = resolve(resolvedCwd, relPath);
+        // Sandbox check: silently skip out-of-bounds paths
+        try {
+            resolveAllowedPath(absPath, policy);
+        }
+        catch {
+            continue;
+        }
+        if (files.length >= maxResults) {
+            truncated = true;
+            break;
+        }
+        files.push(toWorkspaceRelativePath(context.workspaceRoot, absPath));
+    }
+    return { files, truncated, matchCount: files.length };
+};
+//# sourceMappingURL=executor.js.map

package/dist/tools/glob/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../src/tools/glob/executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEhF,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEnE,MAAM,cAAc,GAAG,CAAC,oBAAoB,EAAE,YAAY,CAAC,CAAC;AAC5D,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAejC,MAAM,aAAa,GAAG,CAAC,OAAe,EAAE,cAAwB,EAAW,EAAE;IAC3E,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAwC,KAAK,EACpE,KAAK,EACL,OAAO,EACP,EAAE;IACF,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,KAAK,SAAS;QACzC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC;QACvC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IAE1B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC;IAC1E,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC;IAE3F,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,IAAI,KAAK,EAAE,MAAM,OAAO,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACpG,IAAI,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;YACnC,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAE9C,mDAAmD;QACnD,IAAI,CAAC;YACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;YAC/B,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM;QACR,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;AACxD,CAAC,CAAC"}

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAW7C;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,cAAc,EAqQ3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAUtD,CAAC;AAEF,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AA0B7C;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,cAAc,EA0kB3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CA2BtD,CAAC;AAEF,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC"}

package/dist/tools/index.js

@@ -7,6 +7,21 @@ import { runShellExecutor } from "./run-shell/executor";
 import { applyPatchExecutor } from "./apply-patch/executor";
 import { executeWebFetch } from "./web-fetch";
 import { executeWebSearch } from "./web-search";
+// 新增工具 — S1 工具层核心
+import { editFileExecutor } from "./edit-file/executor";
+import { multiEditExecutor } from "./multi-edit/executor";
+import { globExecutor } from "./glob/executor";
+import { todoWriteExecutor } from "./todo-write/executor";
+import { todoReadExecutor } from "./todo-read/executor";
+// 新增工具 — S2 Git + 测试诊断
+import { gitStatusExecutor } from "./git-status/executor";
+import { gitDiffExecutor } from "./git-diff/executor";
+import { gitLogExecutor } from "./git-log/executor";
+import { gitBlameExecutor } from "./git-blame/executor";
+import { gitShowExecutor } from "./git-show/executor";
+import { gitBranchExecutor } from "./git-branch/executor";
+import { runTypecheckExecutor } from "./run-typecheck/executor";
+import { runTestsExecutor } from "./run-tests/executor";
 /**
  * 内置工具描述符列表。
  */
@@ -14,7 +29,7 @@ export const toolDescriptors = [
     {
         kind: "tool",
         name: "read-file",
-        description: "读取工作区内的文件内容",
+        description: "读取工作区内的文件内容。支持 offset/limit 分段读取、withLineNumbers 行号注入（默认开启）。",
         sideEffect: "readonly",
         idempotent: true,
         requiresApproval: false,
@@ -24,12 +39,20 @@ export const toolDescriptors = [
             properties: {
                 path: { type: "string" },
                 encoding: { type: "string", enum: ["utf-8", "base64"] },
+                offset: { type: "number", description: "起始行（1-based），默认 1" },
+                limit: { type: "number", description: "最多读多少行，默认全文" },
+                withLineNumbers: { type: "boolean", description: "是否在每行前插入行号前缀（默认 true）" },
             },
             required: ["path"],
         },
         outputSchema: {
             type: "object",
-            properties: { content: { type: "string" }, bytes: { type: "number" } },
+            properties: {
+                content: { type: "string" },
+                bytes: { type: "number" },
+                totalLines: { type: "number" },
+                hasMore: { type: "boolean" },
+            },
         },
         execute: "read-file",
     },
@@ -246,7 +269,7 @@ export const toolDescriptors = [
     {
         kind: "tool",
         name: "apply-patch",
-        description: "应用 unified diff 补丁并支持失败回滚",
+        description: "应用 unified diff 补丁并支持失败回滚。支持上下文行宽容匹配（trim + ±3 行偏移）。",
         sideEffect: "write",
         idempotent: false,
         requiresApproval: true,
@@ -268,11 +291,329 @@ export const toolDescriptors = [
         },
         execute: "apply-patch",
     },
+    // ─── S1：编辑工具 ──────────────────────────────────────────────────────────
+    {
+        kind: "tool",
+        name: "edit-file",
+        description: "在文件中替换精确字符串片段。oldString 必须在文件中唯一（或配合 replaceAll）。改前会校验唯一性，失败时返回 matchCount 方便 LLM 调整上下文。fuzzy 默认 true，允许行首尾空白差异。",
+        sideEffect: "write",
+        idempotent: false,
+        requiresApproval: true,
+        timeout: 10000,
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: { type: "string" },
+                oldString: { type: "string", description: "要被替换的精确原始内容（含缩进/换行）" },
+                newString: { type: "string", description: "替换后的新内容" },
+                replaceAll: { type: "boolean", description: "true 时替换所有匹配，不做唯一性校验" },
+                fuzzy: { type: "boolean", description: "允许 oldString 行首尾空白差异（默认 true）" },
+            },
+            required: ["path", "oldString", "newString"],
+        },
+        outputSchema: {
+            type: "object",
+            properties: {
+                replaced: { type: "number" },
+                matchCount: { type: "number" },
+            },
+        },
+        execute: "edit-file",
+    },
+    {
+        kind: "tool",
+        name: "multi-edit",
+        description: "在同一文件中原子地应用多处字符串替换。任一替换失败则全部回滚，不写磁盘。",
+        sideEffect: "write",
+        idempotent: false,
+        requiresApproval: true,
+        timeout: 15000,
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: { type: "string" },
+                edits: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            oldString: { type: "string" },
+                            newString: { type: "string" },
+                            replaceAll: { type: "boolean" },
+                        },
+                        required: ["oldString", "newString"],
+                    },
+                },
+                fuzzy: { type: "boolean" },
+            },
+            required: ["path", "edits"],
+        },
+        outputSchema: {
+            type: "object",
+            properties: {
+                applied: { type: "number" },
+                total: { type: "number" },
+                results: { type: "array" },
+            },
+        },
+        execute: "multi-edit",
+    },
+    {
+        kind: "tool",
+        name: "glob",
+        description: "按 glob 模式查找工作区内的文件路径。只返回路径，不读文件内容。适合探索项目结构、定位特定类型文件。例：pattern=\"**/*.test.ts\"",
+        sideEffect: "readonly",
+        idempotent: true,
+        requiresApproval: false,
+        timeout: 15000,
+        inputSchema: {
+            type: "object",
+            properties: {
+                pattern: { type: "string", description: "glob 模式，如 **/*.ts" },
+                cwd: { type: "string", description: "搜索根（默认 workspaceRoot）" },
+                ignore: { type: "array", items: { type: "string" }, description: "排除 pattern（默认排除 node_modules/.git）" },
+                maxResults: { type: "number", description: "默认 1000" },
+            },
+            required: ["pattern"],
+        },
+        outputSchema: {
+            type: "object",
+            properties: {
+                files: { type: "array", items: { type: "string" } },
+                truncated: { type: "boolean" },
+                matchCount: { type: "number" },
+            },
+        },
+        execute: "glob",
+    },
+    {
+        kind: "tool",
+        name: "todo-write",
+        description: "创建或更新会话任务清单（持久化到磁盘）。merge=true 时按 id 合并，false 时全量覆盖。用于追踪复杂多步任务的进度。",
+        sideEffect: "write",
+        idempotent: false,
+        requiresApproval: false,
+        timeout: 5000,
+        inputSchema: {
+            type: "object",
+            properties: {
+                todos: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string" },
+                            content: { type: "string" },
+                            status: { type: "string", enum: ["pending", "in_progress", "completed", "cancelled"] },
+                        },
+                        required: ["id", "content", "status"],
+                    },
+                },
+                merge: { type: "boolean", description: "默认 true；false 时全量覆盖" },
+            },
+            required: ["todos"],
+        },
+        outputSchema: {
+            type: "object",
+            properties: { total: { type: "number" }, written: { type: "number" } },
+        },
+        execute: "todo-write",
+    },
+    {
+        kind: "tool",
+        name: "todo-read",
+        description: "读取当前会话的任务清单。返回全部或按状态过滤的任务列表。",
+        sideEffect: "readonly",
+        idempotent: true,
+        requiresApproval: false,
+        timeout: 3000,
+        inputSchema: {
+            type: "object",
+            properties: {
+                status: {
+                    type: "string",
+                    enum: ["pending", "in_progress", "completed", "cancelled", "all"],
+                    description: "过滤状态，默认 all",
+                },
+            },
+        },
+        outputSchema: {
+            type: "object",
+            properties: {
+                todos: { type: "array" },
+                total: { type: "number" },
+            },
+        },
+        execute: "todo-read",
+    },
+    // ─── S2：Git 工具组 ─────────────────────────────────────────────────────────
+    {
+        kind: "tool",
+        name: "git-status",
+        description: "获取 git 工作区状态：当前分支、ahead/behind、staged/unstaged/untracked 文件列表。",
+        sideEffect: "readonly",
+        idempotent: true,
+        requiresApproval: false,
+        timeout: 10000,
+        inputSchema: {
+            type: "object",
+            properties: { cwd: { type: "string" } },
+        },
+        outputSchema: { type: "object" },
+        execute: "git-status",
+    },
+    {
+        kind: "tool",
+        name: "git-diff",
+        description: "获取 git diff，支持 staged（暂存区）、ref 范围、指定文件。返回结构化 FileDiff 列表。",
+        sideEffect: "readonly",
+        idempotent: true,
+        requiresApproval: false,
+        timeout: 15000,
+        inputSchema: {
+            type: "object",
+            properties: {
+                cwd: { type: "string" },
+                path: { type: "string", description: "限定文件路径" },
+                staged: { type: "boolean", description: "true 时等价于 git diff --staged" },
+                ref: { type: "string", description: "如 HEAD~1, abc123..def456" },
+                context: { type: "number", description: "context lines，默认 3" },
+                maxBytes: { type: "number", description: "输出字节上限，默认 32768" },
+            },
+        },
+        outputSchema: { type: "object" },
+        execute: "git-diff",
+    },
+    {
+        kind: "tool",
+        name: "git-log",
+        description: "获取 git 提交历史。支持 limit/since/until/author/path 过滤，返回结构化 commit 列表。",
+        sideEffect: "readonly",
+        idempotent: true,
+        requiresApproval: false,
+        timeout: 10000,
+        inputSchema: {
+            type: "object",
+            properties: {
+                cwd: { type: "string" },
+                limit: { type: "number", description: "默认 20，上限 100" },
+                since: { type: "string", description: "如 '2 weeks ago', '2026-01-01'" },
+                until: { type: "string" },
+                author: { type: "string" },
+                path: { type: "string", description: "只看影响此路径的 commits" },
+                ref: { type: "string", description: "起点 ref，默认 HEAD" },
+                oneline: { type: "boolean", description: "只返回 hash + subject" },
+            },
+        },
+        outputSchema: { type: "object" },
+        execute: "git-log",
+    },
+    {
+        kind: "tool",
+        name: "git-blame",
+        description: "查看文件每行的最后修改者和 commit。支持行范围过滤。",
+        sideEffect: "readonly",
+        idempotent: true,
+        requiresApproval: false,
+        timeout: 15000,
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: { type: "string" },
+                cwd: { type: "string" },
+                startLine: { type: "number", description: "1-based，默认 1" },
+                endLine: { type: "number", description: "1-based，默认文件尾" },
+            },
+            required: ["path"],
+        },
+        outputSchema: { type: "object" },
+        execute: "git-blame",
+    },
+    {
+        kind: "tool",
+        name: "git-show",
+        description: "查看单个 git commit 的元信息和 diff。",
+        sideEffect: "readonly",
+        idempotent: true,
+        requiresApproval: false,
+        timeout: 10000,
+        inputSchema: {
+            type: "object",
+            properties: {
+                ref: { type: "string", description: "commit hash, tag, HEAD~1 等" },
+                cwd: { type: "string" },
+                maxBytes: { type: "number", description: "diff 输出上限，默认 32768" },
+            },
+            required: ["ref"],
+        },
+        outputSchema: { type: "object" },
+        execute: "git-show",
+    },
+    {
+        kind: "tool",
+        name: "git-branch",
+        description: "列出本地（或含远端）分支，包含 current、upstream、ahead/behind 信息。",
+        sideEffect: "readonly",
+        idempotent: true,
+        requiresApproval: false,
+        timeout: 10000,
+        inputSchema: {
+            type: "object",
+            properties: {
+                cwd: { type: "string" },
+                all: { type: "boolean", description: "true 时含远端分支，默认 false" },
+            },
+        },
+        outputSchema: { type: "object" },
+        execute: "git-branch",
+    },
+    // ─── S2：测试诊断 ──────────────────────────────────────────────────────────
+    {
+        kind: "tool",
+        name: "run-typecheck",
+        description: "对工作区运行 TypeScript 类型检查（tsc --noEmit 或 package.json 的 typecheck script）。返回结构化错误列表，适合改完代码后验证是否引入类型错误。",
+        sideEffect: "readonly",
+        idempotent: true,
+        requiresApproval: false,
+        timeout: 120000,
+        inputSchema: {
+            type: "object",
+            properties: {
+                cwd: { type: "string" },
+                tsconfig: { type: "string", description: "tsconfig 路径，默认自动查找" },
+                maxErrors: { type: "number", description: "返回错误条数上限，默认 50" },
+            },
+        },
+        outputSchema: { type: "object" },
+        execute: "run-typecheck",
+    },
+    {
+        kind: "tool",
+        name: "run-tests",
+        description: "运行工作区的测试套件（bun test 或 package.json test script）。返回结构化通过/失败/跳过数和失败用例详情。",
+        sideEffect: "readonly",
+        idempotent: true,
+        requiresApproval: false,
+        timeout: 180000,
+        inputSchema: {
+            type: "object",
+            properties: {
+                cwd: { type: "string" },
+                filter: { type: "string", description: "测试名过滤" },
+                file: { type: "string", description: "只跑指定文件" },
+                maxFailures: { type: "number", description: "失败用例返回上限，默认 20" },
+                timeout: { type: "number", description: "进程超时 ms，默认 60000" },
+            },
+        },
+        outputSchema: { type: "object" },
+        execute: "run-tests",
+    },
 ];
 /**
  * 工具执行函数注册表。
  */
 export const toolExecutors = {
+    // 原有工具
     "read-file": readFileExecutor,
     "write-file": writeFileExecutor,
     "list-dir": listDirExecutor,
@@ -282,5 +623,21 @@ export const toolExecutors = {
     "web-search": executeWebSearch,
     "run-shell": runShellExecutor,
     "apply-patch": applyPatchExecutor,
+    // S1：编辑工具
+    "edit-file": editFileExecutor,
+    "multi-edit": multiEditExecutor,
+    "glob": globExecutor,
+    "todo-write": todoWriteExecutor,
+    "todo-read": todoReadExecutor,
+    // S2：Git 工具组
+    "git-status": gitStatusExecutor,
+    "git-diff": gitDiffExecutor,
+    "git-log": gitLogExecutor,
+    "git-blame": gitBlameExecutor,
+    "git-show": gitShowExecutor,
+    "git-branch": gitBranchExecutor,
+    // S2：测试诊断
+    "run-typecheck": runTypecheckExecutor,
+    "run-tests": runTestsExecutor,
 };
 //# sourceMappingURL=index.js.map