sillyspec 3.9.0 → 3.10.0

package/src/stages/status.js

@@ -0,0 +1,65 @@
+export const definition = {
+  name: 'status',
+  title: '状态查看',
+  description: '查看项目进度和状态',
+  auxiliary: true,
+  steps: [
+    {
+      name: '项目基础信息',
+      prompt: `收集项目基础信息。
+
+### 操作
+1. \`cat .sillyspec/PROJECT.md 2>/dev/null || echo "未初始化"\`
+2. 获取 project 名
+3. \`ls .sillyspec/docs/<project>/scan/ 2>/dev/null | head -10\`
+4. \`cat .sillyspec/REQUIREMENTS.md 2>/dev/null | head -20\`
+5. \`cat .sillyspec/ROADMAP.md 2>/dev/null\`
+
+### 输出
+项目基础信息摘要`,
+      outputHint: '项目基础信息',
+      optional: false
+    },
+    {
+      name: '变更状态',
+      prompt: `检查进行中的变更和归档历史。
+
+### 操作
+1. \`ls .sillyspec/changes/ 2>/dev/null | grep -v archive\`
+2. 对每个进行中的变更：检查 proposal.md ✅/❌、design.md ✅/❌、requirements.md ✅/❌、tasks.md — X/Y 完成
+3. \`ls .sillyspec/changes/archive/ 2>/dev/null | wc -l\`
+4. \`cat .sillyspec/HANDOFF.json 2>/dev/null\`
+
+### 输出
+变更状态列表`,
+      outputHint: '变更状态',
+      optional: false
+    },
+    {
+      name: '输出状态报告',
+      prompt: `生成完整状态报告。
+
+### 输出格式：
+\`\`\`
+📊 SillySpec 状态
+
+📋 项目：xxx（已初始化 / 未初始化）
+📂 代码库：已扫描（7 份文档）/ 未扫描
+
+🔄 进行中：N 个变更
+  - [change-1] Phase 3 (Execute) — tasks 5/8
+
+✅ 已归档：N 个变更
+📝 设计文档：N 份
+📝 实现计划：N 份
+
+💡 下一步：/sillyspec:continue
+\`\`\`
+
+### 注意
+- 不修改任何文件`,
+      outputHint: '状态报告',
+      optional: false
+    }
+  ]
+}

package/src/stages/verify.js

@@ -0,0 +1,135 @@
+export const definition = {
+  name: 'verify',
+  title: '验证确认',
+  description: '对照规范检查 + 测试套件',
+  steps: [
+    {
+      name: '状态检查',
+      prompt: `检查当前状态，确认可以执行 verify。
+
+### 操作
+1. 运行 \`sillyspec progress show\`
+2. 确认 currentStage 为 "verify"
+
+### 输出
+当前状态摘要`,
+      outputHint: '状态摘要',
+      optional: false
+    },
+    {
+      name: '加载规范并锚定',
+      prompt: `加载规范文件并确认。
+
+### 操作
+1. 读取 proposal.md、design.md、tasks.md、requirements.md
+2. 加载项目信息：\`cat .sillyspec/projects/*.yaml 2>/dev/null\`
+3. 加载本地配置：\`cat .sillyspec/local.yaml 2>/dev/null\`（构建命令、测试命令、lint 命令等）
+4. 加载代码规范：\`cat .sillyspec/docs/<project>/scan/CONVENTIONS.md 2>/dev/null\`
+5. 标注每个文件的存在/不存在状态
+
+### 输出
+文件加载确认清单`,
+      outputHint: '文件确认清单',
+      optional: false
+    },
+    {
+      name: '逐项检查任务',
+      prompt: `对照 tasks.md 检查每个任务完成状态。
+
+### 操作
+对每个 checkbox：
+1. 检查相关文件是否存在
+2. 检查代码是否实现了描述的功能
+3. 标记：✅ 已完成 / ❌ 未完成 / ⚠️ 部分完成
+
+### 批量模式验证指引
+如果 tasks.md 中有批量特征（引擎/模板/配置/批量生成），采用分层验证：
+- **L1 自动化（100%）**：运行验证脚本（如有），检查所有实例的文件存在、格式正确、Schema 校验通过
+- **L2 AI 抽查（5-10 个）**：选择最复杂的 3 个 + 最简单的 2 个 + 有特殊逻辑的，检查业务逻辑正确性
+- **L3 模式性 bug 检测**：L2 发现 bug → 判断是否为系统性问题 → 系统性 bug 则回退修复引擎并重新生成所有实例
+
+### 输出
+任务完成度列表 + 完成率
+
+### 注意
+- 不修改任何代码，只做检查和报告`,
+      outputHint: '任务完成度报告',
+      optional: false
+    },
+    {
+      name: '对照设计检查',
+      prompt: `对照 design.md 检查实现一致性。**design.md 是唯一 truth source，不符合 design.md 的实现 = Bug。**
+
+### 操作
+1. 架构决策是否遵循
+2. 文件变更清单是否一致
+3. 数据模型是否符合
+4. API 设计是否符合
+5. **Reverse Sync 检查**：如果发现实现合理但 design.md 未覆盖，先更新 design.md 补充遗漏
+
+### 输出
+一致性检查结果`,
+      outputHint: '设计一致性报告',
+      optional: false
+    },
+    {
+      name: '任务蓝图验收',
+      prompt: `检查每个 task-N.md 的验收标准是否全部满足。
+
+### 操作
+1. 检查变更目录下 tasks/ 是否存在
+2. 如果存在：
+   - 逐个读取 tasks/task-NN.md
+   - 检查每个文件的「验收标准」checkbox 是否全部勾选
+   - 未勾选的项列为不通过
+3. 如果不存在：跳过此步骤
+
+### 输出
+验收结果：通过/不通过 + 未通过的项`,
+      outputHint: '验收结果',
+      optional: false
+    },
+    {
+      name: '运行测试和质量扫描',
+      prompt: `运行测试和代码质量扫描。
+
+### 操作
+1. 读取 \`.sillyspec/local.yaml\` 获取构建和测试命令
+2. 如果 local.yaml 有 test 命令，使用它（仅测试变更涉及的模块，非全量）
+3. 如果 local.yaml 无 test 命令，根据项目类型选择：
+   - Maven：\`mvn test -pl <变更模块> -am\`（仅编译变更模块及其依赖）
+   - Gradle：\`./gradlew :<模块>:test\`
+   - npm/pnpm：\`pnpm test --filter=<包名>\` 或 \`npm test -- --testPathPattern=<相关文件>\`
+   - Python：\`pytest <变更模块路径>/\`
+4. 记录通过/失败数量，分析失败原因
+5. 搜索技术债务：grep TODO/FIXME/HACK/XXX（仅限变更文件）
+6. 如果 local.yaml 有 lint 命令，运行 lint 检查
+
+### 注意
+- 不要全量编译/测试整个项目，只测变更涉及的模块
+- 如果变更模块不确定，优先使用 local.yaml 中的命令
+
+### 输出
+测试结果 + 技术债务标记`,
+      outputHint: '测试结果 + 技术债务',
+      optional: false
+    },
+    {
+      name: '输出验证报告',
+      prompt: `生成完整验证报告。
+
+### 操作
+1. 汇总以上所有检查结果
+2. 给出结论：PASS / PASS WITH NOTES / FAIL
+
+### 输出
+验证报告 markdown + 下一步命令
+
+### 注意
+- PASS → 下一步 archive
+- FAIL → 修复后重新 verify`,
+      outputHint: '验证报告',
+      optional: false
+    }
+  ]
+}

package/.sillyspec/changes/dashboard/design.md

@@ -1,219 +0,0 @@
-# SillySpec Dashboard — 技术方案
-
-## 架构决策
-
-| 决策 | 选择 | 理由 |
-|---|---|---|
-| 前端框架 | Vue 3 + Vite | 轻量、打包快、SillySpec 用户已有 Node.js |
-| CSS | Tailwind CSS | 原子化、深色主题变量管理方便 |
-| 后端 | Node.js 原生 http + ws | 不引入 Express，零重依赖 |
-| 文件监听 | chokidar | 跨平台、成熟稳定 |
-| 数据库 | 无 | 纯文件系统，与 SillySpec 哲学一致 |
-| 包结构 | SillySpec 子包 packages/dashboard | 独立 package.json，可单独开发 |
-
-## 文件变更清单
-
-### 新增文件
-
-| 文件 | 说明 |
-|---|---|
-| `packages/dashboard/package.json` | 子包配置，依赖 vue/vite/tailwind/chokidar/ws |
-| `packages/dashboard/vite.config.js` | Vite 构建配置，构建产物输出到 dist/ |
-| `packages/dashboard/server/index.js` | HTTP + WebSocket 服务启动入口 |
-| `packages/dashboard/server/watcher.js` | chokidar 监听 .sillyspec/，解析文件变化，emit 事件 |
-| `packages/dashboard/server/api.js` | REST 路由：GET /api/projects, GET /api/project/:name/status |
-| `packages/dashboard/server/executor.js` | CLI 命令执行器（child_process.spawn + stdout 流式推送） |
-| `packages/dashboard/src/main.js` | Vue 应用入口 |
-| `packages/dashboard/src/App.vue` | 根组件，三栏布局 |
-| `packages/dashboard/src/components/ProjectList.vue` | 左栏项目列表 |
-| `packages/dashboard/src/components/PipelineView.vue` | 中栏阶段 pipeline + 时间线 |
-| `packages/dashboard/src/components/StepCard.vue` | 步骤卡片（三级信息密度） |
-| `packages/dashboard/src/components/DetailPanel.vue` | 右栏详情 + 日志 |
-| `packages/dashboard/src/components/LogStream.vue` | 终端风格日志流（等宽字体、语法高亮、搜索过滤） |
-| `packages/dashboard/src/components/CommandPalette.vue` | Cmd+K 命令面板 |
-| `packages/dashboard/src/components/StageBadge.vue` | 阶段状态标签组件 |
-| `packages/dashboard/src/components/ActionBar.vue` | CLI 操作按钮（下一步、阶段切换） |
-| `packages/dashboard/src/composables/useWebSocket.js` | WebSocket 连接管理（自动重连、心跳） |
-| `packages/dashboard/src/composables/useKeyboard.js` | 全局键盘快捷键 |
-| `packages/dashboard/src/styles/theme.css` | CSS 变量（配色、间距、动效） |
-| `packages/dashboard/index.html` | Vite HTML 入口 |
-| `packages/dashboard/tailwind.config.js` | Tailwind 配置（自定义颜色） |
-
-### 修改文件
-
-| 文件 | 变更 |
-|---|---|
-| `src/index.js` | 新增 `dashboard` 命令分支 |
-| `package.json` | workspace 引用 packages/dashboard |
-
-## 数据模型
-
-### 前端状态（composable/store）
-
-```javascript
-{
-  projects: [
-    {
-      name: 'my-project',
-      path: '/Users/x/my-project',
-      currentStage: 'plan',
-      stages: {
-        brainstorm: { status: 'completed', steps: 10, completedSteps: 10, duration: '25min' },
-        plan: { status: 'in-progress', steps: 5, completedSteps: 2, duration: '8min' },
-        execute: { status: 'pending', steps: 0, completedSteps: 0 },
-        verify: { status: 'pending', steps: 0, completedSteps: 0 }
-      },
-      lastActive: '2026-04-05T14:30:00Z'
-    }
-  ],
-  activeProject: 'my-project',  // 当前选中
-  activeStep: 3,                // 当前选中步骤
-  logs: [],                     // 实时日志行
-  isPanelOpen: true             // 右侧面板是否展开
-}
-```
-
-### WebSocket 消息协议
-
-```javascript
-// 服务端 → 客户端
-{ type: 'project:updated', project: { name, stages, currentStage } }
-{ type: 'step:updated', project: 'name', step: { id, status, summary } }
-{ type: 'log:append', project: 'name', lines: ['> analyzing...', '> done ✅'] }
-{ type: 'cli:output', project: 'name', data: 'stdout/stderr 流' }
-{ type: 'cli:complete', project: 'name', exitCode: 0 }
-
-// 客户端 → 服务端
-{ type: 'cli:execute', project: 'name', command: 'sillyspec next' }
-{ type: 'project:select', name: 'my-project' }
-```
-
-### REST API
-
-```
-GET /api/projects           → 项目列表（扫描用户目录下的 .sillyspec/）
-GET /api/project/:name      → 项目完整状态（STATE.md + progress.json 合并）
-GET /api/project/:name/logs → 最近日志（user-inputs.md）
-```
-
-## 关键组件实现
-
-### StepCard.vue — 三级信息密度
-
-```vue
-<template>
-  <div class="step-card" :class="[statusClass]" 
-       @mouseenter="hovered = true" @mouseleave="hovered = false"
-       @click="select">
-    <!-- 低密度：始终显示 -->
-    <div class="step-header">
-      <span class="step-icon">{{ icon }}</span>
-      <span class="step-title">{{ step.title }}</span>
-    </div>
-    
-    <!-- 中密度：hover 显示 -->
-    <transition name="fade">
-      <div v-if="hovered && step.summary?.conclusion" class="step-summary">
-        {{ step.summary.conclusion }}
-      </div>
-    </transition>
-    
-    <!-- 高密度：点击后在右侧 DetailPanel 展示 -->
-  </div>
-</template>
-```
-
-### LogStream.vue — 终端风格日志
-
-- 等宽字体（JetBrains Mono / monospace）
-- 新行淡入动画（CSS transition opacity）
-- 搜索过滤：顶部搜索框，实时过滤匹配行
-- 自动滚动到底部，用户上翻时暂停自动滚动
-- ANSI 颜色码支持（使用 ansi-to-html）
-
-### CommandPalette.vue
-
-- `Cmd/Ctrl+K` 打开，`Escape` 关闭
-- 模糊搜索项目名、阶段名
-- 选中后跳转视图
-- 参考 shadcn/ui 的 Command 组件风格
-
-## CLI 集成
-
-### src/index.js 新增命令
-
-```javascript
-// 在现有 commander 配置中新增
-program
-  .command('dashboard')
-  .description('启动可视化仪表盘')
-  .option('--port <number>', '端口号', 3456)
-  .option('--no-open', '不自动打开浏览器')
-  .action(async (options) => {
-    const { startServer } = await import('../packages/dashboard/server/index.js');
-    await startServer(options);
-  });
-```
-
-### server/index.js 启动流程
-
-```javascript
-async function startServer({ port = 3456, open = true }) {
-  // 1. 启动 HTTP 服务，serve 前端静态文件
-  const server = http.createServer(handler);
-  
-  // 2. 挂载 WebSocket
-  const wss = new WebSocketServer({ server });
-  
-  // 3. 启动文件监听
-  const watcher = new ProjectWatcher();
-  watcher.on('change', (event) => wss.broadcast(event));
-  
-  // 4. 启动服务
-  server.listen(port, () => {
-    console.log(`🚀 SillySpec Dashboard: http://localhost:${port}`);
-    if (open) openBrowser(`http://localhost:${port}`);
-  });
-}
-```
-
-## 项目发现机制
-
-扫描用户常用项目目录，查找包含 `.sillyspec/` 的目录：
-
-```javascript
-// 优先级：
-// 1. 当前工作目录
-// 2. HOME 目录下第一层子目录
-// 3. 用户可通过设置文件配置额外路径 ~/.sillyspec/dashboard.json
-```
-
-## 构建与发布
-
-### 开发模式
-
-```bash
-cd packages/dashboard
-npm run dev  # Vite dev server + 后端热重载
-```
-
-### 生产构建
-
-```bash
-cd packages/dashboard
-npm run build  # Vite 构建 → dist/
-```
-
-前端构建产物（dist/）嵌入 npm 包，`sillyspec dashboard` 启动时 serve 静态文件。
-
-### 发布
-
-作为 SillySpec 的子包，跟随主包版本一起发布。不需要独立版本号。
-
-## 代码风格参照
-
-- Vue 3 Composition API（`<script setup>`）
-- Tailwind CSS utility-first
-- 组件命名：PascalCase
-- composable 命名：use 前缀
-- 不使用 Vuex/Pinia，composable 管理状态即可（项目规模不需要）