openspec-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 OpenSpec MCP contributors
+
+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

@@ -0,0 +1,205 @@
+# OpenSpec MCP
+
+[![npm version](https://img.shields.io/npm/v/openspec-mcp)](https://www.npmjs.com/package/openspec-mcp)
+
+MCP (Model Context Protocol) server for [OpenSpec](https://github.com/Fission-AI/OpenSpec) - spec-driven development with real-time dashboard and approval workflow.
+
+## Features
+
+- **MCP Tools**: Full OpenSpec CLI functionality exposed as MCP tools
+- **Task Tracking**: Parse tasks.md and track progress in real-time
+- **Approval Workflow**: Request, approve, and reject change proposals
+- **Web Dashboard**: Visual management interface with real-time updates
+
+## Quick Start
+
+### 1. Add to your MCP configuration
+
+**Claude Code CLI (recommended - uses current directory):**
+```bash
+claude mcp add openspec -- npx openspec-mcp
+```
+
+**Claude Code CLI with Dashboard:**
+```bash
+claude mcp add openspec -- npx openspec-mcp --with-dashboard
+```
+
+**Claude Code CLI with specific project path:**
+```bash
+claude mcp add openspec -- npx openspec-mcp /path/to/your/project
+```
+
+**Claude Desktop / Cursor / Other:**
+```json
+{
+  "mcpServers": {
+    "openspec": {
+      "command": "npx",
+      "args": ["-y", "openspec-mcp"]
+    }
+  }
+}
+```
+
+**With Dashboard:**
+```json
+{
+  "mcpServers": {
+    "openspec": {
+      "command": "npx",
+      "args": ["-y", "openspec-mcp", "--with-dashboard"]
+    }
+  }
+}
+```
+
+### 2. Use in conversation
+
+```
+# List all changes
+"List all openspec changes"
+
+# Show change details
+"Show me the add-user-auth change"
+
+# Update task status
+"Mark task 1.1 as done in add-user-auth"
+
+# Request approval
+"Request approval for add-user-auth from @reviewer"
+```
+
+## Available Tools
+
+### Guides
+| Tool | Description |
+|------|-------------|
+| `openspec_get_instructions` | Get AGENTS.md usage guide |
+| `openspec_get_project_context` | Get project.md context |
+
+### Management
+| Tool | Description |
+|------|-------------|
+| `openspec_list_changes` | List all change proposals |
+| `openspec_list_specs` | List all specifications |
+| `openspec_show_change` | Show change details |
+| `openspec_show_spec` | Show spec details |
+
+### Validation
+| Tool | Description |
+|------|-------------|
+| `openspec_validate_change` | Validate a change |
+| `openspec_validate_spec` | Validate a spec |
+| `openspec_validate_all` | Batch validation |
+
+### Archive
+| Tool | Description |
+|------|-------------|
+| `openspec_archive_change` | Archive completed change |
+
+### Tasks
+| Tool | Description |
+|------|-------------|
+| `openspec_get_tasks` | Get tasks and progress |
+| `openspec_update_task` | Update task status |
+| `openspec_get_progress_summary` | Get all changes progress |
+
+### Approval
+| Tool | Description |
+|------|-------------|
+| `openspec_get_approval_status` | Get approval status |
+| `openspec_request_approval` | Request approval |
+| `openspec_approve_change` | Approve a change |
+| `openspec_reject_change` | Reject a change |
+| `openspec_list_pending_approvals` | List pending approvals |
+
+## Approval Workflow
+
+```
+draft -> pending_approval -> approved -> implementing -> completed -> archived
+                         -> rejected -> draft (revise and resubmit)
+```
+
+Approval records are stored in `openspec/approvals/<change-id>.json`.
+
+## CLI Options
+
+```bash
+openspec-mcp [path] [options]
+
+Arguments:
+  path                    Project directory path (default: current directory)
+
+Options:
+  --dashboard             Start web dashboard only (HTTP mode)
+  --with-dashboard        Start MCP server with web dashboard
+  -p, --port <number>     Dashboard port (default: 3000)
+  -V, --version           Output version number
+  -h, --help              Display help
+```
+
+### Examples
+
+```bash
+# MCP server only (uses current directory)
+openspec-mcp
+
+# MCP server with specific project
+openspec-mcp /path/to/project
+
+# Dashboard only
+openspec-mcp --dashboard
+
+# MCP server + Dashboard
+openspec-mcp --with-dashboard
+
+# Dashboard on custom port
+openspec-mcp --dashboard --port 8080
+```
+
+## Web Dashboard
+
+The dashboard provides a visual interface for managing changes, tracking tasks, and handling approvals.
+
+### Dashboard Pages
+
+| Route | Description |
+|-------|-------------|
+| `/` | Overview with stats and recent changes |
+| `/changes` | List all changes with progress |
+| `/changes/:id` | Change detail with task management |
+| `/specs` | Browse specifications |
+| `/approvals` | Approval queue management |
+
+### Features
+
+- **Real-time Updates**: WebSocket connection for live progress updates
+- **Task Management**: Toggle task status directly from the UI
+- **Approval Actions**: Approve/reject changes with comments
+- **Progress Visualization**: Progress bars and status badges
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Development mode
+npm run dev
+
+# Run tests
+npm test
+```
+
+## Requirements
+
+- Node.js >= 20.0.0
+- OpenSpec CLI (`npm install -g @fission-ai/openspec`)
+
+## License
+
+MIT

package/README.zh.md

@@ -0,0 +1,205 @@
+# OpenSpec MCP
+
+[![npm version](https://img.shields.io/npm/v/openspec-mcp)](https://www.npmjs.com/package/openspec-mcp)
+
+[OpenSpec](https://github.com/Fission-AI/OpenSpec) 的 MCP (Model Context Protocol) 服务器 - 规格驱动开发，支持实时仪表板和审批流程。
+
+## 功能特性
+
+- **MCP 工具**: 将 OpenSpec CLI 完整功能暴露为 MCP 工具
+- **任务追踪**: 解析 tasks.md 并实时追踪进度
+- **审批流程**: 请求、批准和拒绝变更提案
+- **Web 仪表板**: 可视化管理界面
+
+## 快速开始
+
+### 1. 添加到 MCP 配置
+
+**Claude Code CLI（推荐，使用当前目录）:**
+```bash
+claude mcp add openspec -- npx openspec-mcp
+```
+
+**Claude Code CLI 带仪表板:**
+```bash
+claude mcp add openspec -- npx openspec-mcp --with-dashboard
+```
+
+**Claude Code CLI 指定项目路径:**
+```bash
+claude mcp add openspec -- npx openspec-mcp /path/to/your/project
+```
+
+**Claude Desktop / Cursor / 其他:**
+```json
+{
+  "mcpServers": {
+    "openspec": {
+      "command": "npx",
+      "args": ["-y", "openspec-mcp"]
+    }
+  }
+}
+```
+
+**带仪表板:**
+```json
+{
+  "mcpServers": {
+    "openspec": {
+      "command": "npx",
+      "args": ["-y", "openspec-mcp", "--with-dashboard"]
+    }
+  }
+}
+```
+
+### 2. 在对话中使用
+
+```
+# 列出所有变更
+"列出所有 openspec 变更"
+
+# 显示变更详情
+"显示 add-user-auth 变更详情"
+
+# 更新任务状态
+"将 add-user-auth 中的任务 1.1 标记为完成"
+
+# 请求审批
+"向 @reviewer 请求审批 add-user-auth"
+```
+
+## 可用工具
+
+### 指南类 (Guides)
+| 工具 | 描述 |
+|------|------|
+| `openspec_get_instructions` | 获取 AGENTS.md 使用指南 |
+| `openspec_get_project_context` | 获取 project.md 项目上下文 |
+
+### 管理类 (Management)
+| 工具 | 描述 |
+|------|------|
+| `openspec_list_changes` | 列出所有变更提案 |
+| `openspec_list_specs` | 列出所有规格 |
+| `openspec_show_change` | 显示变更详情 |
+| `openspec_show_spec` | 显示规格详情 |
+
+### 验证类 (Validation)
+| 工具 | 描述 |
+|------|------|
+| `openspec_validate_change` | 验证单个变更 |
+| `openspec_validate_spec` | 验证单个规格 |
+| `openspec_validate_all` | 批量验证 |
+
+### 归档类 (Archive)
+| 工具 | 描述 |
+|------|------|
+| `openspec_archive_change` | 归档已完成变更 |
+
+### 任务类 (Tasks)
+| 工具 | 描述 |
+|------|------|
+| `openspec_get_tasks` | 获取任务列表和进度 |
+| `openspec_update_task` | 更新任务状态 |
+| `openspec_get_progress_summary` | 获取所有变更进度汇总 |
+
+### 审批类 (Approval)
+| 工具 | 描述 |
+|------|------|
+| `openspec_get_approval_status` | 获取审批状态 |
+| `openspec_request_approval` | 请求审批 |
+| `openspec_approve_change` | 批准变更 |
+| `openspec_reject_change` | 拒绝变更 |
+| `openspec_list_pending_approvals` | 列出待审批项 |
+
+## 审批流程
+
+```
+draft -> pending_approval -> approved -> implementing -> completed -> archived
+                         -> rejected -> draft (修改后重新提交)
+```
+
+审批记录存储在 `openspec/approvals/<change-id>.json`。
+
+## CLI 选项
+
+```bash
+openspec-mcp [path] [options]
+
+参数:
+  path                    项目目录路径（默认：当前目录）
+
+选项:
+  --dashboard             仅启动 Web 仪表板（HTTP 模式）
+  --with-dashboard        启动 MCP 服务器并同时启动仪表板
+  -p, --port <number>     仪表板端口（默认：3000）
+  -V, --version           显示版本号
+  -h, --help              显示帮助
+```
+
+### 示例
+
+```bash
+# 仅 MCP 服务器（使用当前目录）
+openspec-mcp
+
+# MCP 服务器指定项目
+openspec-mcp /path/to/project
+
+# 仅仪表板
+openspec-mcp --dashboard
+
+# MCP 服务器 + 仪表板
+openspec-mcp --with-dashboard
+
+# 自定义端口启动仪表板
+openspec-mcp --dashboard --port 8080
+```
+
+## Web 仪表板
+
+仪表板提供可视化界面，用于管理变更、追踪任务和处理审批。
+
+### 仪表板页面
+
+| 路由 | 描述 |
+|------|------|
+| `/` | 概览统计和最近变更 |
+| `/changes` | 变更列表及进度 |
+| `/changes/:id` | 变更详情和任务管理 |
+| `/specs` | 浏览规格文档 |
+| `/approvals` | 审批队列管理 |
+
+### 功能亮点
+
+- **实时更新**: WebSocket 连接实现实时进度更新
+- **任务管理**: 直接在 UI 中切换任务状态
+- **审批操作**: 带备注的批准/拒绝操作
+- **进度可视化**: 进度条和状态徽章
+
+## 开发
+
+```bash
+# 安装依赖
+npm install
+
+# 构建
+npm run build
+
+# 开发模式
+npm run dev
+
+# 运行测试
+npm test
+```
+
+## 系统要求
+
+- Node.js >= 20.0.0
+- OpenSpec CLI (`npm install -g @fission-ai/openspec`)
+
+## 许可证
+
+MIT

package/dist/api/routes/approvals.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Approvals REST API 路由
+ */
+import type { FastifyInstance } from 'fastify';
+import type { ApiContext } from '../server.js';
+export declare function registerApprovalsRoutes(fastify: FastifyInstance, ctx: ApiContext): void;
+//# sourceMappingURL=approvals.d.ts.map

package/dist/api/routes/approvals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../../../src/api/routes/approvals.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAoHvF"}

package/dist/api/routes/approvals.js

@@ -0,0 +1,99 @@
+/**
+ * Approvals REST API 路由
+ */
+export function registerApprovalsRoutes(fastify, ctx) {
+    const { approvalManager } = ctx;
+    /**
+     * GET /api/approvals - 列出所有审批记录
+     */
+    fastify.get('/approvals', async () => {
+        const approvals = await approvalManager.listApprovals();
+        return { approvals };
+    });
+    /**
+     * GET /api/approvals/pending - 列出待审批记录
+     */
+    fastify.get('/approvals/pending', async () => {
+        const approvals = await approvalManager.listPendingApprovals();
+        return { approvals };
+    });
+    /**
+     * GET /api/approvals/:changeId - 获取审批状态
+     */
+    fastify.get('/approvals/:changeId', async (request, reply) => {
+        const { changeId } = request.params;
+        const record = await approvalManager.getApprovalStatus(changeId);
+        if (!record) {
+            return reply.status(404).send({ error: 'Approval record not found' });
+        }
+        return { approval: record };
+    });
+    /**
+     * POST /api/approvals/:changeId/request - 请求审批
+     */
+    fastify.post('/approvals/:changeId/request', async (request, reply) => {
+        const { changeId } = request.params;
+        const { requestedBy, reviewers } = request.body;
+        if (!requestedBy) {
+            return reply.status(400).send({ error: 'requestedBy is required' });
+        }
+        try {
+            const record = await approvalManager.requestApproval(changeId, requestedBy, reviewers);
+            ctx.broadcast('approval:requested', { changeId, record });
+            return { approval: record };
+        }
+        catch (error) {
+            return reply.status(400).send({ error: error.message });
+        }
+    });
+    /**
+     * POST /api/approvals/:changeId/approve - 审批通过
+     */
+    fastify.post('/approvals/:changeId/approve', async (request, reply) => {
+        const { changeId } = request.params;
+        const { approver, comment } = request.body;
+        if (!approver) {
+            return reply.status(400).send({ error: 'approver is required' });
+        }
+        try {
+            const record = await approvalManager.approve(changeId, approver, comment);
+            ctx.broadcast('approval:approved', { changeId, record });
+            return { approval: record };
+        }
+        catch (error) {
+            return reply.status(400).send({ error: error.message });
+        }
+    });
+    /**
+     * POST /api/approvals/:changeId/reject - 审批拒绝
+     */
+    fastify.post('/approvals/:changeId/reject', async (request, reply) => {
+        const { changeId } = request.params;
+        const { rejector, reason } = request.body;
+        if (!rejector || !reason) {
+            return reply.status(400).send({ error: 'rejector and reason are required' });
+        }
+        try {
+            const record = await approvalManager.reject(changeId, rejector, reason);
+            ctx.broadcast('approval:rejected', { changeId, record });
+            return { approval: record };
+        }
+        catch (error) {
+            return reply.status(400).send({ error: error.message });
+        }
+    });
+    /**
+     * DELETE /api/approvals/:changeId - 删除审批记录
+     */
+    fastify.delete('/approvals/:changeId', async (request, reply) => {
+        const { changeId } = request.params;
+        const deleted = await approvalManager.deleteApproval(changeId);
+        if (deleted) {
+            return { success: true };
+        }
+        else {
+            return reply.status(404).send({ error: 'Approval record not found' });
+        }
+    });
+}
+//# sourceMappingURL=approvals.js.map

package/dist/api/routes/approvals.js.map

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

package/dist/api/routes/changes.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Changes REST API 路由
+ */
+import type { FastifyInstance } from 'fastify';
+import type { ApiContext } from '../server.js';
+export declare function registerChangesRoutes(fastify: FastifyInstance, ctx: ApiContext): void;
+//# sourceMappingURL=changes.d.ts.map

package/dist/api/routes/changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes.d.ts","sourceRoot":"","sources":["../../../src/api/routes/changes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CA0DrF"}

package/dist/api/routes/changes.js

@@ -0,0 +1,55 @@
+/**
+ * Changes REST API 路由
+ */
+export function registerChangesRoutes(fastify, ctx) {
+    const { cli } = ctx;
+    /**
+     * GET /api/changes - 列出所有变更
+     */
+    fastify.get('/changes', async (request, reply) => {
+        const { includeArchived } = request.query;
+        const changes = await cli.listChanges({
+            includeArchived: includeArchived === 'true',
+        });
+        return { changes };
+    });
+    /**
+     * GET /api/changes/:id - 获取变更详情
+     */
+    fastify.get('/changes/:id', async (request, reply) => {
+        const { id } = request.params;
+        const change = await cli.showChange(id);
+        if (!change) {
+            return reply.status(404).send({ error: 'Change not found' });
+        }
+        return { change };
+    });
+    /**
+     * POST /api/changes/:id/validate - 验证变更
+     */
+    fastify.post('/changes/:id/validate', async (request, reply) => {
+        const { id } = request.params;
+        const body = (request.body || {});
+        const { strict } = body;
+        const result = await cli.validateChange(id, { strict });
+        return result;
+    });
+    /**
+     * POST /api/changes/:id/archive - 归档变更
+     */
+    fastify.post('/changes/:id/archive', async (request, reply) => {
+        const { id } = request.params;
+        const body = (request.body || {});
+        const { skipSpecs } = body;
+        const result = await cli.archiveChange(id, { skipSpecs });
+        if (result.success) {
+            // 广播归档事件
+            ctx.broadcast('change:archived', { changeId: id, archivedPath: result.archivedPath });
+            return result;
+        }
+        else {
+            return reply.status(400).send(result);
+        }
+    });
+}
+//# sourceMappingURL=changes.js.map

package/dist/api/routes/changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes.js","sourceRoot":"","sources":["../../../src/api/routes/changes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,UAAU,qBAAqB,CAAC,OAAwB,EAAE,GAAe;IAC7E,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAC/C,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,KAAqC,CAAC;QAC1E,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC;YACpC,eAAe,EAAE,eAAe,KAAK,MAAM;SAC5C,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH;;OAEG;IACH,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACnD,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAwB,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAExC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC,CAAC,CAAC;IAEH;;OAEG;IACH,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAC7D,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAwB,CAAC;QAChD,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAyB,CAAC;QAC1D,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAExB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACxD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH;;OAEG;IACH,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAC5D,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAwB,CAAC;QAChD,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;QAC7D,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAE3B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAE1D,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,SAAS;YACT,GAAG,CAAC,SAAS,CAAC,iBAAiB,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;YACtF,OAAO,MAAM,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/api/routes/specs.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Specs REST API 路由
+ */
+import type { FastifyInstance } from 'fastify';
+import type { ApiContext } from '../server.js';
+export declare function registerSpecsRoutes(fastify: FastifyInstance, ctx: ApiContext): void;
+//# sourceMappingURL=specs.d.ts.map

package/dist/api/routes/specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../../src/api/routes/specs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAmCnF"}

package/dist/api/routes/specs.js

@@ -0,0 +1,34 @@
+/**
+ * Specs REST API 路由
+ */
+export function registerSpecsRoutes(fastify, ctx) {
+    const { cli } = ctx;
+    /**
+     * GET /api/specs - 列出所有规格
+     */
+    fastify.get('/specs', async () => {
+        const specs = await cli.listSpecs();
+        return { specs };
+    });
+    /**
+     * GET /api/specs/:id - 获取规格详情
+     */
+    fastify.get('/specs/:id', async (request, reply) => {
+        const { id } = request.params;
+        const spec = await cli.showSpec(id);
+        if (!spec) {
+            return reply.status(404).send({ error: 'Spec not found' });
+        }
+        return { spec };
+    });
+    /**
+     * POST /api/specs/:id/validate - 验证规格
+     */
+    fastify.post('/specs/:id/validate', async (request) => {
+        const { id } = request.params;
+        const { strict } = request.body;
+        const result = await cli.validateSpec(id, { strict });
+        return result;
+    });
+}
+//# sourceMappingURL=specs.js.map

package/dist/api/routes/specs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs.js","sourceRoot":"","sources":["../../../src/api/routes/specs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,UAAU,mBAAmB,CAAC,OAAwB,EAAE,GAAe;IAC3E,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC/B,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS,EAAE,CAAC;QACpC,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH;;OAEG;IACH,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACjD,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAwB,CAAC;QAChD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAEpC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH;;OAEG;IACH,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACpD,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAwB,CAAC;QAChD,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAA4B,CAAC;QAExD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/api/routes/tasks.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tasks REST API 路由
+ */
+import type { FastifyInstance } from 'fastify';
+import type { ApiContext } from '../server.js';
+export declare function registerTasksRoutes(fastify: FastifyInstance, ctx: ApiContext): void;
+//# sourceMappingURL=tasks.d.ts.map

package/dist/api/routes/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../src/api/routes/tasks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAiEnF"}