docz-cli 0.2.2 → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kris
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -112,6 +112,25 @@ docz-cli log 研发:docs/guide.md         # File history
 docz-cli trash 研发                      # View trash
 ```
 
+### Pipes
+
+`cat` outputs to stdout, `write ... -` reads from stdin. Combine with any Unix tool:
+
+```bash
+# Search content
+docz-cli cat 研发:docs/guide.md | grep "部署"
+
+# Extract CSV columns
+docz-cli cat 研发:data.csv | cut -d',' -f1,3 | head -10
+
+# Read → transform → write back
+docz-cli cat 吴鹏飞:config.md | sed 's/old/new/g' | docz-cli write 吴鹏飞:config.md -
+
+# Local command output → DocSync
+echo "# Generated at $(date)" | docz-cli write 吴鹏飞:notes/auto.md -
+cat local-file.md | docz-cli write 吴鹏飞:docs/remote.md -
+```
+
 ## MCP Server
 
 Built-in MCP server for AI agent integration (Claude Code, Cursor, etc.).
@@ -123,7 +142,7 @@ Add to your MCP settings:
 ```json
 {
   "mcpServers": {
-    "docsync": {
+    "docz-mcp": {
       "command": "npx",
       "args": ["-y", "docz-cli", "mcp"],
       "env": {
@@ -138,13 +157,13 @@ Add to your MCP settings:
 
 | Tool | Description |
 |------|-------------|
-| `docsync_list_spaces` | List all accessible spaces |
-| `docsync_list_files` | List files in a directory |
-| `docsync_read_file` | Read file content |
-| `docsync_upload_file` | Upload/create a file |
-| `docsync_mkdir` | Create a folder |
-| `docsync_delete` | Delete file/folder |
-| `docsync_file_history` | View change history |
+| `docz_list_spaces` | List all accessible spaces |
+| `docz_list_files` | List files in a directory |
+| `docz_read_file` | Read file content |
+| `docz_upload_file` | Upload/create a file |
+| `docz_mkdir` | Create a folder |
+| `docz_delete` | Delete file/folder |
+| `docz_file_history` | View change history |
 
 ## AI Agent Skill
 

package/dist/index.js

@@ -215,7 +215,7 @@ var program = new Command();
 program.name("docz").description("DocSync CLI \u2014 read and write company documents").version("0.1.1");
 registerCommands(program);
 program.command("mcp").description("Start MCP stdio server for AI agent integration").action(async () => {
-  const { startMcpServer } = await import("./mcp-EJZJGAX6.js");
+  const { startMcpServer } = await import("./mcp-LTB2ZUCO.js");
   await startMcpServer();
 });
 program.parse();

package/dist/{mcp-EJZJGAX6.js → mcp-LTB2ZUCO.js}

@@ -46,18 +46,18 @@ function fail(err) {
 }
 async function startMcpServer() {
   const server = new Server(
-    { name: "docsync", version: "0.1.0" },
+    { name: "docz-mcp", version: "0.5.0" },
     { capabilities: { tools: {} } }
   );
   server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
       {
-        name: "docsync_list_spaces",
+        name: "docz_list_spaces",
         description: "\u5217\u51FA\u6240\u6709\u53EF\u8BBF\u95EE\u7684 DocSync Space\uFF08\u4E2A\u4EBA\u7A7A\u95F4\u548C\u56E2\u961F\u7A7A\u95F4\uFF09",
         inputSchema: { type: "object", properties: {} }
       },
       {
-        name: "docsync_list_files",
+        name: "docz_list_files",
         description: "\u5217\u51FA DocSync Space \u4E2D\u6307\u5B9A\u76EE\u5F55\u7684\u6587\u4EF6\u548C\u6587\u4EF6\u5939",
         inputSchema: {
           type: "object",
@@ -76,7 +76,7 @@ async function startMcpServer() {
         }
       },
       {
-        name: "docsync_read_file",
+        name: "docz_read_file",
         description: "\u8BFB\u53D6 DocSync \u6587\u4EF6\u5185\u5BB9\uFF08Markdown\u3001CSV\u3001HTML \u7B49\u6587\u672C\u6587\u4EF6\uFF09",
         inputSchema: {
           type: "object",
@@ -91,7 +91,7 @@ async function startMcpServer() {
         }
       },
       {
-        name: "docsync_upload_file",
+        name: "docz_upload_file",
         description: "\u4E0A\u4F20/\u521B\u5EFA\u6587\u4EF6\u5230 DocSync Space",
         inputSchema: {
           type: "object",
@@ -114,7 +114,7 @@ async function startMcpServer() {
         }
       },
       {
-        name: "docsync_mkdir",
+        name: "docz_mkdir",
         description: "\u5728 DocSync Space \u4E2D\u521B\u5EFA\u6587\u4EF6\u5939",
         inputSchema: {
           type: "object",
@@ -132,7 +132,7 @@ async function startMcpServer() {
         }
       },
       {
-        name: "docsync_delete",
+        name: "docz_delete",
         description: "\u5220\u9664\u6587\u4EF6\u6216\u6587\u4EF6\u5939\uFF08\u8FDB\u5165\u56DE\u6536\u7AD9\uFF0C30 \u5929\u5185\u53EF\u6062\u590D\uFF09",
         inputSchema: {
           type: "object",
@@ -147,7 +147,7 @@ async function startMcpServer() {
         }
       },
       {
-        name: "docsync_file_history",
+        name: "docz_file_history",
         description: "\u67E5\u770B\u6587\u4EF6\u7684\u53D8\u66F4\u5386\u53F2\uFF08\u57FA\u4E8E Git \u7248\u672C\u63A7\u5236\uFF09",
         inputSchema: {
           type: "object",
@@ -168,14 +168,14 @@ async function startMcpServer() {
     try {
       const client = getClient();
       switch (request.params.name) {
-        case "docsync_list_spaces": {
+        case "docz_list_spaces": {
           const spaces = await client.listSpaces();
           const lines = spaces.map(
             (s) => `${s.name} (${s.is_private ? "\u79C1\u6709" : "\u56E2\u961F"}, ${s.member_count} \u4EBA) id=${s.id}`
           );
           return ok(lines.join("\n"));
         }
-        case "docsync_list_files": {
+        case "docz_list_files": {
           const sid = await resolveSpaceId(client, String(args.space));
           const entries = await client.ls(sid, String(args.path ?? ""));
           if (entries.length === 0) return ok("\uFF08\u7A7A\u76EE\u5F55\uFF09");
@@ -186,12 +186,12 @@ async function startMcpServer() {
           });
           return ok(lines.join("\n"));
         }
-        case "docsync_read_file": {
+        case "docz_read_file": {
           const sid = await resolveSpaceId(client, String(args.space));
           const content = await client.cat(sid, String(args.path));
           return ok(content);
         }
-        case "docsync_upload_file": {
+        case "docz_upload_file": {
           const sid = await resolveSpaceId(client, String(args.space));
           const result = await client.upload(
             sid,
@@ -201,17 +201,17 @@ async function startMcpServer() {
           );
           return ok(`\u5DF2\u4E0A\u4F20: ${result.path}`);
         }
-        case "docsync_mkdir": {
+        case "docz_mkdir": {
           const sid = await resolveSpaceId(client, String(args.space));
           await client.mkdir(sid, String(args.path));
           return ok(`\u5DF2\u521B\u5EFA: ${args.path}`);
         }
-        case "docsync_delete": {
+        case "docz_delete": {
           const sid = await resolveSpaceId(client, String(args.space));
           await client.rm(sid, String(args.path));
           return ok(`\u5DF2\u5220\u9664: ${args.path}\uFF0830 \u5929\u5185\u53EF\u4ECE\u56DE\u6536\u7AD9\u6062\u590D\uFF09`);
         }
-        case "docsync_file_history": {
+        case "docz_file_history": {
           const sid = await resolveSpaceId(client, String(args.space));
           const logs = await client.log(
             sid,
@@ -236,4 +236,4 @@ async function startMcpServer() {
 export {
   startMcpServer
 };
-//# sourceMappingURL=mcp-EJZJGAX6.js.map
+//# sourceMappingURL=mcp-LTB2ZUCO.js.map

package/dist/mcp-LTB2ZUCO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp.ts"],"sourcesContent":["/**\n * DocSync MCP Server (stdio transport)\n *\n * Usage:\n *   docz mcp\n *\n * 环境变量：\n *   DOCSYNC_API_TOKEN — 必须\n *   DOCSYNC_BASE_URL  — 可选，默认 https://docz.zhenguanyu.com\n */\n\nimport { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport {\n  CallToolRequestSchema,\n  ListToolsRequestSchema,\n} from '@modelcontextprotocol/sdk/types.js';\nimport { DocSyncClient } from './client.js';\nimport { getBaseUrl, getToken } from './config.js';\n\nfunction getClient(): DocSyncClient {\n  const token = getToken();\n  if (!token) {\n    throw new Error(\n      'DOCSYNC_API_TOKEN not set. Run `docz login --token <token>` or set the env var.'\n    );\n  }\n  return new DocSyncClient(getBaseUrl(), token);\n}\n\nasync function resolveSpaceId(\n  client: DocSyncClient,\n  nameOrId: string\n): Promise<string> {\n  const space = await client.resolveSpace(nameOrId);\n  return space.id;\n}\n\nfunction formatSize(bytes: number): string {\n  if (bytes < 1024) return `${bytes} B`;\n  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;\n  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;\n}\n\nfunction ok(text: string) {\n  return { content: [{ type: 'text' as const, text }] };\n}\n\nfunction fail(err: unknown) {\n  return {\n    content: [\n      {\n        type: 'text' as const,\n        text: `Error: ${err instanceof Error ? err.message : String(err)}`,\n      },\n    ],\n    isError: true,\n  };\n}\n\nexport async function startMcpServer(): Promise<void> {\n  const server = new Server(\n    { name: 'docz-mcp', version: '0.5.0' },\n    { capabilities: { tools: {} } }\n  );\n\n  server.setRequestHandler(ListToolsRequestSchema, async () => ({\n    tools: [\n      {\n        name: 'docz_list_spaces',\n        description: '列出所有可访问的 DocSync Space（个人空间和团队空间）',\n        inputSchema: { type: 'object' as const, properties: {} },\n      },\n      {\n        name: 'docz_list_files',\n        description: '列出 DocSync Space 中指定目录的文件和文件夹',\n        inputSchema: {\n          type: 'object' as const,\n          properties: {\n            space: {\n              type: 'string',\n              description: 'Space 名称或 ID',\n            },\n            path: {\n              type: 'string',\n              description: '目录路径，空字符串表示根目录',\n              default: '',\n            },\n          },\n          required: ['space'],\n        },\n      },\n      {\n        name: 'docz_read_file',\n        description: '读取 DocSync 文件内容（Markdown、CSV、HTML 等文本文件）',\n        inputSchema: {\n          type: 'object' as const,\n          properties: {\n            space: {\n              type: 'string',\n              description: 'Space 名称或 ID',\n            },\n            path: { type: 'string', description: '文件路径' },\n          },\n          required: ['space', 'path'],\n        },\n      },\n      {\n        name: 'docz_upload_file',\n        description: '上传/创建文件到 DocSync Space',\n        inputSchema: {\n          type: 'object' as const,\n          properties: {\n            space: {\n              type: 'string',\n              description: 'Space 名称或 ID',\n            },\n            path: {\n              type: 'string',\n              description: '目标目录路径（如 reports）',\n            },\n            filename: {\n              type: 'string',\n              description: '文件名（如 summary.md）',\n            },\n            content: { type: 'string', description: '文件内容' },\n          },\n          required: ['space', 'filename', 'content'],\n        },\n      },\n      {\n        name: 'docz_mkdir',\n        description: '在 DocSync Space 中创建文件夹',\n        inputSchema: {\n          type: 'object' as const,\n          properties: {\n            space: {\n              type: 'string',\n              description: 'Space 名称或 ID',\n            },\n            path: {\n              type: 'string',\n              description: '要创建的文件夹路径',\n            },\n          },\n          required: ['space', 'path'],\n        },\n      },\n      {\n        name: 'docz_delete',\n        description: '删除文件或文件夹（进入回收站，30 天内可恢复）',\n        inputSchema: {\n          type: 'object' as const,\n          properties: {\n            space: {\n              type: 'string',\n              description: 'Space 名称或 ID',\n            },\n            path: { type: 'string', description: '要删除的路径' },\n          },\n          required: ['space', 'path'],\n        },\n      },\n      {\n        name: 'docz_file_history',\n        description: '查看文件的变更历史（基于 Git 版本控制）',\n        inputSchema: {\n          type: 'object' as const,\n          properties: {\n            space: {\n              type: 'string',\n              description: 'Space 名称或 ID',\n            },\n            path: { type: 'string', description: '文件路径' },\n          },\n          required: ['space'],\n        },\n      },\n    ],\n  }));\n\n  server.setRequestHandler(CallToolRequestSchema, async (request) => {\n    const args = (request.params.arguments ?? {}) as Record<string, unknown>;\n\n    try {\n      const client = getClient();\n\n      switch (request.params.name) {\n        case 'docz_list_spaces': {\n          const spaces = await client.listSpaces();\n          const lines = spaces.map(\n            (s) =>\n              `${s.name} (${s.is_private ? '私有' : '团队'}, ${s.member_count} 人) id=${s.id}`\n          );\n          return ok(lines.join('\\n'));\n        }\n\n        case 'docz_list_files': {\n          const sid = await resolveSpaceId(client, String(args.space));\n          const entries = await client.ls(sid, String(args.path ?? ''));\n          if (entries.length === 0) return ok('（空目录）');\n          const lines = entries.map((e) => {\n            const icon = e.type === 'tree' ? '📁' : '📄';\n            const size = e.type === 'blob' ? ` (${formatSize(e.size)})` : '';\n            return `${icon} ${e.name}${size}`;\n          });\n          return ok(lines.join('\\n'));\n        }\n\n        case 'docz_read_file': {\n          const sid = await resolveSpaceId(client, String(args.space));\n          const content = await client.cat(sid, String(args.path));\n          return ok(content);\n        }\n\n        case 'docz_upload_file': {\n          const sid = await resolveSpaceId(client, String(args.space));\n          const result = await client.upload(\n            sid,\n            String(args.path ?? ''),\n            String(args.filename),\n            String(args.content)\n          );\n          return ok(`已上传: ${result.path}`);\n        }\n\n        case 'docz_mkdir': {\n          const sid = await resolveSpaceId(client, String(args.space));\n          await client.mkdir(sid, String(args.path));\n          return ok(`已创建: ${args.path}`);\n        }\n\n        case 'docz_delete': {\n          const sid = await resolveSpaceId(client, String(args.space));\n          await client.rm(sid, String(args.path));\n          return ok(`已删除: ${args.path}（30 天内可从回收站恢复）`);\n        }\n\n        case 'docz_file_history': {\n          const sid = await resolveSpaceId(client, String(args.space));\n          const logs = await client.log(\n            sid,\n            args.path ? String(args.path) : undefined\n          );\n          if (logs.length === 0) return ok('没有变更历史。');\n          const lines = logs.map(\n            (l) => `${l.hash.substring(0, 7)}  ${l.date}  ${l.message}`\n          );\n          return ok(lines.join('\\n'));\n        }\n\n        default:\n          return fail(`Unknown tool: ${request.params.name}`);\n      }\n    } catch (err) {\n      return fail(err);\n    }\n  });\n\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docz-cli",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "DocSync CLI — read and write company documents",
   "type": "module",
   "main": "./dist/index.js",

package/dist/mcp-EJZJGAX6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/mcp.ts"],"sourcesContent":["/**\n * DocSync MCP Server (stdio transport)\n *\n * Usage:\n *   docz mcp\n *\n * 环境变量：\n *   DOCSYNC_API_TOKEN — 必须\n *   DOCSYNC_BASE_URL  — 可选，默认 https://docz.zhenguanyu.com\n */\n\nimport { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport {\n  CallToolRequestSchema,\n  ListToolsRequestSchema,\n} from '@modelcontextprotocol/sdk/types.js';\nimport { DocSyncClient } from './client.js';\nimport { getBaseUrl, getToken } from './config.js';\n\nfunction getClient(): DocSyncClient {\n  const token = getToken();\n  if (!token) {\n    throw new Error(\n      'DOCSYNC_API_TOKEN not set. Run `docz login --token <token>` or set the env var.'\n    );\n  }\n  return new DocSyncClient(getBaseUrl(), token);\n}\n\nasync function resolveSpaceId(\n  client: DocSyncClient,\n  nameOrId: string\n): Promise<string> {\n  const space = await client.resolveSpace(nameOrId);\n  return space.id;\n}\n\nfunction formatSize(bytes: number): string {\n  if (bytes < 1024) return `${bytes} B`;\n  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;\n  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;\n}\n\nfunction ok(text: string) {\n  return { content: [{ type: 'text' as const, text }] };\n}\n\nfunction fail(err: unknown) {\n  return {\n    content: [\n      {\n        type: 'text' as const,\n        text: `Error: ${err instanceof Error ? err.message : String(err)}`,\n      },\n    ],\n    isError: true,\n  };\n}\n\nexport async function startMcpServer(): Promise<void> {\n  const server = new Server(\n    { name: 'docsync', version: '0.1.0' },\n    { capabilities: { tools: {} } }\n  );\n\n  server.setRequestHandler(ListToolsRequestSchema, async () => ({\n    tools: [\n      {\n        name: 'docsync_list_spaces',\n        description: '列出所有可访问的 DocSync Space（个人空间和团队空间）',\n        inputSchema: { type: 'object' as const, properties: {} },\n      },\n      {\n        name: 'docsync_list_files',\n        description: '列出 DocSync Space 中指定目录的文件和文件夹',\n        inputSchema: {\n          type: 'object' as const,\n          properties: {\n            space: {\n              type: 'string',\n              description: 'Space 名称或 ID',\n            },\n            path: {\n              type: 'string',\n              description: '目录路径，空字符串表示根目录',\n              default: '',\n            },\n          },\n          required: ['space'],\n        },\n      },\n      {\n        name: 'docsync_read_file',\n        description: '读取 DocSync 文件内容（Markdown、CSV、HTML 等文本文件）',\n        inputSchema: {\n          type: 'object' as const,\n          properties: {\n            space: {\n              type: 'string',\n              description: 'Space 名称或 ID',\n            },\n            path: { type: 'string', description: '文件路径' },\n          },\n          required: ['space', 'path'],\n        },\n      },\n      {\n        name: 'docsync_upload_file',\n        description: '上传/创建文件到 DocSync Space',\n        inputSchema: {\n          type: 'object' as const,\n          properties: {\n            space: {\n              type: 'string',\n              description: 'Space 名称或 ID',\n            },\n            path: {\n              type: 'string',\n              description: '目标目录路径（如 reports）',\n            },\n            filename: {\n              type: 'string',\n              description: '文件名（如 summary.md）',\n            },\n            content: { type: 'string', description: '文件内容' },\n          },\n          required: ['space', 'filename', 'content'],\n        },\n      },\n      {\n        name: 'docsync_mkdir',\n        description: '在 DocSync Space 中创建文件夹',\n        inputSchema: {\n          type: 'object' as const,\n          properties: {\n            space: {\n              type: 'string',\n              description: 'Space 名称或 ID',\n            },\n            path: {\n              type: 'string',\n              description: '要创建的文件夹路径',\n            },\n          },\n          required: ['space', 'path'],\n        },\n      },\n      {\n        name: 'docsync_delete',\n        description: '删除文件或文件夹（进入回收站，30 天内可恢复）',\n        inputSchema: {\n          type: 'object' as const,\n          properties: {\n            space: {\n              type: 'string',\n              description: 'Space 名称或 ID',\n            },\n            path: { type: 'string', description: '要删除的路径' },\n          },\n          required: ['space', 'path'],\n        },\n      },\n      {\n        name: 'docsync_file_history',\n        description: '查看文件的变更历史（基于 Git 版本控制）',\n        inputSchema: {\n          type: 'object' as const,\n          properties: {\n            space: {\n              type: 'string',\n              description: 'Space 名称或 ID',\n            },\n            path: { type: 'string', description: '文件路径' },\n          },\n          required: ['space'],\n        },\n      },\n    ],\n  }));\n\n  server.setRequestHandler(CallToolRequestSchema, async (request) => {\n    const args = (request.params.arguments ?? {}) as Record<string, unknown>;\n\n    try {\n      const client = getClient();\n\n      switch (request.params.name) {\n        case 'docsync_list_spaces': {\n          const spaces = await client.listSpaces();\n          const lines = spaces.map(\n            (s) =>\n              `${s.name} (${s.is_private ? '私有' : '团队'}, ${s.member_count} 人) id=${s.id}`\n          );\n          return ok(lines.join('\\n'));\n        }\n\n        case 'docsync_list_files': {\n          const sid = await resolveSpaceId(client, String(args.space));\n          const entries = await client.ls(sid, String(args.path ?? ''));\n          if (entries.length === 0) return ok('（空目录）');\n          const lines = entries.map((e) => {\n            const icon = e.type === 'tree' ? '📁' : '📄';\n            const size = e.type === 'blob' ? ` (${formatSize(e.size)})` : '';\n            return `${icon} ${e.name}${size}`;\n          });\n          return ok(lines.join('\\n'));\n        }\n\n        case 'docsync_read_file': {\n          const sid = await resolveSpaceId(client, String(args.space));\n          const content = await client.cat(sid, String(args.path));\n          return ok(content);\n        }\n\n        case 'docsync_upload_file': {\n          const sid = await resolveSpaceId(client, String(args.space));\n          const result = await client.upload(\n            sid,\n            String(args.path ?? ''),\n            String(args.filename),\n            String(args.content)\n          );\n          return ok(`已上传: ${result.path}`);\n        }\n\n        case 'docsync_mkdir': {\n          const sid = await resolveSpaceId(client, String(args.space));\n          await client.mkdir(sid, String(args.path));\n          return ok(`已创建: ${args.path}`);\n        }\n\n        case 'docsync_delete': {\n          const sid = await resolveSpaceId(client, String(args.space));\n          await client.rm(sid, String(args.path));\n          return ok(`已删除: ${args.path}（30 天内可从回收站恢复）`);\n        }\n\n        case 'docsync_file_history': {\n          const sid = await resolveSpaceId(client, String(args.space));\n          const logs = await client.log(\n            sid,\n            args.path ? String(args.path) : undefined\n          );\n          if (logs.length === 0) return ok('没有变更历史。');\n          const lines = logs.map(\n            (l) => `${l.hash.substring(0, 7)}  ${l.date}  ${l.message}`\n          );\n          return ok(lines.join('\\n'));\n        }\n\n        default:\n          return fail(`Unknown tool: ${request.params.name}`);\n      }\n    } catch (err) {\n      return fail(err);\n    }\n  });\n\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n}\n"],"mappings":"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","names":[]}