openspec-mcp 0.3.4 → 0.3.6

package/dist/server/tools/revision.js

@@ -0,0 +1,130 @@
+/**
+ * Revision Tools
+ * 设计变更记录工具
+ */
+import { z } from 'zod';
+export function registerRevisionTools(server, manager) {
+    /**
+     * 记录设计变更
+     * AI 在修复 bug 或调整设计时应调用此工具
+     */
+    server.registerTool('openspec_record_revision', {
+        description: 'Record a design revision when fixing bugs or adjusting design that deviates from the original proposal/design. Call this when your changes affect the documented design.',
+        inputSchema: {
+            changeId: z.string().describe('Change ID'),
+            description: z.string().describe('Description of the design change (e.g., "Simplified approval states from 6 to 5")'),
+            reason: z.string().optional().describe('Reason for the change (e.g., "UI was too complex")'),
+        },
+    }, async ({ changeId, description, reason }) => {
+        try {
+            const revision = await manager.recordRevision(changeId, description, { reason });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ Revision recorded for "${changeId}"\n\n**ID**: ${revision.id}\n**Description**: ${revision.description}\n**Reason**: ${revision.reason || '-'}\n**Time**: ${revision.createdAt}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    /**
+     * 列出设计变更
+     */
+    server.registerTool('openspec_list_revisions', {
+        description: 'List all recorded design revisions for a change',
+        inputSchema: {
+            changeId: z.string().describe('Change ID'),
+        },
+    }, async ({ changeId }) => {
+        try {
+            const revisions = await manager.listRevisions(changeId);
+            if (revisions.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `No revisions recorded for "${changeId}".`,
+                        },
+                    ],
+                };
+            }
+            let output = `## Revisions for "${changeId}"\n\n`;
+            output += `Total: ${revisions.length}\n\n`;
+            output += '| Date | Description | Reason |\n';
+            output += '|------|-------------|--------|\n';
+            for (const rev of revisions) {
+                const date = rev.createdAt.slice(0, 10);
+                output += `| ${date} | ${rev.description} | ${rev.reason || '-'} |\n`;
+            }
+            return {
+                content: [{ type: 'text', text: output }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    /**
+     * 同步变更到文档
+     */
+    server.registerTool('openspec_sync_revisions', {
+        description: 'Sync recorded revisions to design.md or proposal.md before archiving',
+        inputSchema: {
+            changeId: z.string().describe('Change ID'),
+        },
+    }, async ({ changeId }) => {
+        try {
+            const result = await manager.syncToDocument(changeId);
+            if (result.count === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `No revisions to sync for "${changeId}".`,
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `✅ Synced ${result.count} revision(s) to ${result.targetFile}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=revision.js.map

package/dist/server/tools/revision.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openspec-mcp",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "MCP server for OpenSpec - spec-driven development with real-time dashboard and approval workflow",
   "type": "module",
   "main": "dist/index.js",