sillyspec 3.8.5 → 3.8.7

package/.sillyspec/changes/archive/2026-04-08-derive-state/verify-result.md

@@ -1,43 +0,0 @@
-# derive-state 验证报告
-
-author: qinyi
-created_at: 2026-04-08 07:21:00
-
-## 结论：✅ PASS
-
-## 检查结果
-
-### 1. 规范文件加载
-- ✅ design.md
-- ✅ proposal.md
-- ✅ requirements.md
-- ✅ tasks.md
-- ✅ plan.md
-
-### 2. 任务完成度：5/6 (83%)
-- ✅ 实现 derive.js 核心函数
-- ✅ 集成 run.js --done 轻量校验
-- ✅ 集成 doctor.js 全量扫描
-- ✅ 扩展 validate 支持 --deep
-- ✅ CLI parse --deep 参数
-- ⬜ 测试验证（本项目无自动化测试套件，通过手动验证替代）
-
-### 3. 设计一致性
-- ✅ derive.js 纯函数模块，零外部依赖（仅 fs/path）
-- ✅ light/full 模式
-- ✅ fix 参数 + 安全修复策略
-- ✅ run.js --done 轻量校验集成
-- ✅ doctor.js 全量扫描集成
-- ✅ progress.js validate --deep 支持
-- ✅ index.js CLI --deep 参数
-- ✅ 改动文件范围与 design.md 一致
-
-### 4. 测试和质量
-- ✅ derive.js 模块导入正常
-- ✅ sillyspec progress validate --deep 通过
-- ✅ 无 TODO/FIXME/HACK/XXX 技术债务
-- ✅ sillyspec run quick --status 正常
-- ✅ sillyspec run doctor --status 正常
-
-## 下一步
-sillyspec run archive

package/.sillyspec/changes/auto-mode/design.md

@@ -1,50 +0,0 @@
-# auto mode — 设计文档
-
-author: qinyi
-created_at: 2026-04-08 07:28:00
-
-## 背景
-
-当前 sillyspec 的每个阶段（brainstorm → plan → execute → verify）需要用户手动执行 `sillyspec run <stage>` 和 `sillyspec run <stage> --done`。用户希望一个自动模式，从 brainstorm 一路推进到 verify 完成。
-
-## 需求
-
-1. 用户启动一次，AI 自动循环所有阶段和步骤
-2. 步骤内部的用户确认点保留不变
-3. 不修改 CLI 代码，纯 skill 文件实现
-
-## 设计
-
-### 新增文件：`.claude/skills/sillyspec-auto/SKILL.md`
-
-**核心逻辑：**
-
-1. 读 `$ARGUMENTS` 作为用户需求
-2. 阶段循环（brainstorm → plan → execute → verify）
-3. 每个阶段内步骤循环：
-   - `sillyspec run <stage> --input "需求"` → 读 step prompt
-   - 执行 prompt 中的操作
-   - 需要用户确认的步骤 → 暂停等回复
-   - 完成后自动 `sillyspec run <stage> --done --output "摘要"`
-   - 读下一步 prompt，继续
-4. 当前阶段全部完成 → 自动进入下一阶段
-5. verify 完成 → 输出总结，停止
-6. 命令失败 → 暂停，等用户介入
-
-**确认点保留规则：**
-- prompt 中有"请用户选择""等待用户回答""展示给用户"等字样 → 暂停
-- prompt 中有"自审""检查"等纯内部操作 → 自动完成
-
-### 同步到 npm 包
-
-init.js 已有逻辑复制 `sillyspec-*` skills 到项目 `.claude/skills/`，新 skill 自动生效。
-
-## 改动范围
-
-- 新增：`.claude/skills/sillyspec-auto/SKILL.md`（~60 行）
-
-## 不做的事
-
-- 不修改任何 JS 源码
-- 不改变现有阶段流程
-- 不自动 commit 或发布

package/.sillyspec/changes/auto-mode/proposal.md

@@ -1,19 +0,0 @@
-# auto mode — 提案
-
-author: qinyi
-created_at: 2026-04-08 07:29:00
-
-## 动机
-用户希望一次启动就自动完成 brainstorm → plan → execute → verify 全流程，不需要手动输入 `sillyspec run <stage>` 和 `--done`。
-
-## 变更范围
-新增 `.claude/skills/sillyspec-auto/SKILL.md`
-
-## 不在范围内
-- 不修改 JS 源码
-- 不改变阶段流程
-
-## 成功标准
-1. `/sillyspec:auto "需求"` 能自动推进全流程
-2. 步骤内部确认点正常暂停
-3. 异常时暂停等用户介入

package/.sillyspec/changes/auto-mode/requirements.md

@@ -1,21 +0,0 @@
-# auto mode — 需求
-
-author: qinyi
-created_at: 2026-04-08 07:29:00
-
-## 功能需求
-
-### FR1: 阶段自动推进
-- 按 brainstorm → plan → execute → verify 顺序自动执行
-- 当前阶段完成后自动进入下一阶段
-
-### FR2: 步骤自动循环
-- 每个步骤：读 prompt → 执行 → 自动 --done → 读下一步
-- 不需要用户手动触发 --done
-
-### FR3: 确认点保留
-- prompt 中有用户确认要求时暂停等回复
-- 纯内部操作步骤自动完成
-
-### FR4: 异常处理
-- 命令失败时暂停，展示错误，等用户介入

package/.sillyspec/changes/auto-mode/tasks.md

@@ -1,7 +0,0 @@
-# auto mode — 任务
-
-author: qinyi
-created_at: 2026-04-08 07:29:00
-
-- [x] 编写 sillyspec-auto SKILL.md — `.claude/skills/sillyspec-auto/SKILL.md`
-- [x] 同步到 agents skills — `~/.agents/skills/sillyspec-auto/SKILL.md`

package/.sillyspec/changes/brainstorm-archive/2026-04-05-unified-docs-design.md

@@ -1,199 +0,0 @@
-# 统一文档管理 + Dashboard 文档浏览
-
-## 动机
-
-### 现状问题
-1. 文档散落在各子项目的 `.sillyspec/` 里，没有统一视角
-2. Dashboard 只能发现项目，看不到文档内容
-3. 扫描的 `codebase/` 文档只在子项目里，主项目看不到
-4. 归档后文档沉入 `knowledge/`，跨项目复用不方便
-5. 单项目模式和工作区模式两套逻辑，维护成本高
-
-### 目标
-- 文档只写一份，集中管理
-- 默认工作区模式，去掉模式切换
-- Dashboard 支持文档浏览
-- 子项目保持干净（只有源代码）
-
-## 方案
-
-### 核心原则
-- **文档只写一份**，在哪执行就写在哪
-- **默认工作区模式**，每个项目天生就是"主项目"
-- **子项目不生成文档**，文档全部在主项目的 `.sillyspec/docs/<project>/` 下
-
-### 目录结构
-
-```
-my-project/.sillyspec/
-├── STATE.md                        # 主项目状态（含当前操作的项目）
-├── projects/                       # 子项目注册表
-│   ├── my-project.yaml             # 默认注册自己
-│   ├── frontend.yaml               # { name, path, status }
-│   └── backend.yaml
-│
-├── docs/                           # 统一文档中心
-│   └── my-project/                 # 按子项目分目录
-│       ├── scan/                   # scan 产出
-│       │   ├── ARCHITECTURE.md
-│       │   └── CONVENTIONS.md
-│       ├── brainstorm/             # brainstorm 设计文档
-│       │   └── 2026-04-05-user-auth.md
-│       ├── plan/                   # plan 产出
-│       │   └── 2026-04-05-user-auth.md
-│       ├── changes/                # 当前变更（WIP）
-│       │   └── user-auth/
-│       │       ├── design.md
-│       │       └── tasks.md
-│       ├── archive/                # 归档
-│       │   └── 2026-03-20-db-redesign.md
-│       └── quicklog/               # quick 操作记录
-│           └── 2026-04-05-fix-login.md
-│
-├── knowledge/                      # 跨项目共享知识库（不变）
-└── .runtime/
-    └── progress.json               # 运行时数据（含子项目维度）
-```
-
-### 子项目保持干净
-
-```
-frontend/                          # 只有源代码
-├── src/
-├── package.json
-└── .gitignore
-```
-
-子项目不再有 `.sillyspec/` 目录。
-
-## 命令变更
-
-### --project 参数
-
-所有产生文档的命令支持 `--project <name>` 参数：
-
-```bash
-/sillyspec:scan --project frontend
-/sillyspec:brainstorm "用户认证" --project frontend
-/sillyspec:plan --project frontend
-/sillyspec:execute --project frontend
-/sillyspec:archive --project frontend
-/sillyspec:quick --project frontend --change "修复登录bug"
-```
-
-不指定 `--project` 时，默认使用 `STATE.md` 中记录的当前项目。
-
-### 文档输出路径映射
-
-| 命令 | 输出路径 |
-|------|---------|
-| scan | `.sillyspec/docs/<project>/scan/` |
-| brainstorm | `.sillyspec/docs/<project>/brainstorm/<name>.md` |
-| propose | `.sillyspec/docs/<project>/brainstorm/<name>.md` |
-| plan | `.sillyspec/docs/<project>/plan/<name>.md` |
-| execute | `.sillyspec/docs/<project>/changes/<name>/` (WIP) |
-| archive | `.sillyspec/docs/<project>/archive/<name>.md` |
-| quick | `.sillyspec/docs/<project>/quicklog/<name>.md` |
-
-### init 变更
-
-- `sillyspec init` 初始化时，`projects/` 默认注册当前目录自己
-- 去掉 `--workspace` 参数（默认就是工作区模式）
-- 去掉 `--interactive` 参数（默认零交互）
-
-### STATE.md 变更
-
-```markdown
-# 项目状态
-
-## 当前项目
-- 名称：frontend
-- 路径：./frontend
-
-## 当前变更
-- 名称：user-auth
-- 当前阶段：execute ⏳
-- 下一步：执行任务 3/8
-```
-
-### progress.json 变更
-
-增加子项目维度：
-
-```json
-{
-  "_version": 1,
-  "schemaVersion": "1.0",
-  "currentProject": "frontend",
-  "currentStage": "execute",
-  "stages": {
-    "brainstorm": { "status": "completed", "steps": [...] },
-    "plan": { "status": "completed", "steps": [...] },
-    "execute": { "status": "in-progress", "steps": [...] },
-    "verify": { "status": "pending", "steps": [] }
-  }
-}
-```
-
-## Dashboard 文档浏览
-
-### 新增文档 Tab
-
-选中项目后，中间区域顶部增加 Tab 切换：
-
-```
-[ 流水线 ] [ 文档 ]
-```
-
-### 文档 Tab 内容
-
-左侧：文档树（按类型分组）
-
-```
-📋 设计文档
-  📄 用户认证功能设计
-
-📐 实现计划
-  📄 用户认证功能计划
-
-⚙️ 当前变更
-  📄 design.md
-  📄 tasks.md
-
-📦 已归档
-  📄 数据库重设计
-
-🔍 架构文档
-  📄 ARCHITECTURE.md
-  📄 CONVENTIONS.md
-
-⚡ 快速修复
-  📄 修复登录bug
-```
-
-右侧：文档预览（Markdown 渲染）
-
-点击左侧文档，右侧显示内容。
-
-### 后端新增 API
-
-```
-GET /api/projects/:path/docs          # 获取项目文档树
-GET /api/projects/:path/docs/:filePath # 获取文档内容
-```
-
-## 兼容性
-
-- 旧项目 `.sillyspec/codebase/`、`.sillyspec/specs/` 不受影响，只是新文档不再往那写
-- 可加 `sillyspec docs migrate` 命令把旧文档迁移到新结构
-- Dashboard 的项目发现逻辑不变（扫描 `.sillyspec` 目录）
-
-## 验收标准
-
-1. `sillyspec init` 生成 `projects/` 和 `docs/` 结构
-2. `--project` 参数在所有命令中生效
-3. 文档输出到 `.sillyspec/docs/<project>/` 对应子目录
-4. 子项目目录不生成任何 `.sillyspec` 文件
-5. Dashboard 文档 Tab 能展示文档树和预览内容
-6. 旧项目不受影响
-7. `sillyspec docs migrate` 能迁移旧文档

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

@@ -1,206 +0,0 @@
-# SillySpec Dashboard 设计
-
-## 概述
-
-为 SillySpec CLI 工具添加可视化仪表盘（`sillyspec dashboard`），用户通过浏览器直观查看和管理项目进度、阶段流程、任务详情和实时日志。
-
-## 目标用户
-
-SillySpec 全部用户（官方功能，随 npm 包发布）。
-
-## 分期计划
-
-### 一期（MVP）
-
-可视化仪表盘 + CLI 命令执行 + 实时日志流。
-
-### 二期（进阶）
-
-Web Terminal（xterm.js）+ 自定义命令 + AI 交互（视需求而定）。
-
-## 架构
-
-```
-sillyspec dashboard
-        │
-        ▼
-  Node.js HTTP Server (localhost:3456)
-        │
-        ├─ chokidar: watch .sillyspec/ 目录
-        ├─ WebSocket: 实时推送状态变更
-        └─ REST API: 项目列表、状态、日志、CLI 执行
-        │
-        ▼
-  Vue 3 SPA (浏览器)
-```
-
-### 文件结构
-
-```
-sillyspec/packages/dashboard/
-├── server/
-│   ├── index.js          # HTTP + WebSocket 服务启动
-│   ├── watcher.js        # chokidar 文件监听 + 增量解析
-│   └── api.js            # REST 路由
-├── src/
-│   ├── App.vue
-│   ├── components/
-│   │   ├── ProjectList.vue     # 左栏：项目列表
-│   │   ├── PipelineView.vue    # 中栏：阶段 pipeline
-│   │   ├── StepCard.vue        # 步骤卡片（可展开折叠）
-│   │   ├── DetailPanel.vue     # 右栏：详情 + 日志
-│   │   ├── LogStream.vue       # 终端风格日志流
-│   │   ├── CommandPalette.vue  # Cmd+K 命令面板
-│   │   └── StageBadge.vue      # 阶段状态标签
-│   ├── composables/
-│   │   ├── useWebSocket.js     # WebSocket 连接管理
-│   │   └── useKeyboard.js      # 键盘快捷键
-│   └── styles/
-│       └── theme.css           # 深色主题变量
-├── package.json
-└── vite.config.js
-```
-
-## 核心页面设计
-
-### 三栏布局
-
-```
-┌──────────┬─────────────────────────┬──────────────────┐
-│ 项目列表  │    Pipeline 视图（中）    │   详情+日志（右） │
-│ (200px)  │     (flex-1)            │    (320px,可收起) │
-│          │                         │                  │
-│ 📁 proj1 │  ✅ brainstorm           │  Step 3 详情     │
-│ 📁 proj2 │  ⏳ plan ← 当前          │  结论：选择React  │
-│ 📁 proj3 │  ⬜ execute              │  决策：...       │
-│          │  ⬜ verify               │  📋 实时日志     │
-└──────────┴─────────────────────────┴──────────────────┘
-```
-
-### 信息分层（三级密度）
-
-1. **低密度（默认）**：阶段名 + 状态图标
-2. **中密度（hover）**：步骤摘要（1-2 句话）
-3. **高密度（点击）**：右侧面板展开完整详情 + 日志
-
-### 异常高亮
-
-失败/阻塞/超时步骤自动标红，视觉上突出，不需用户手动查找。
-
-## 数据源与同步
-
-### 数据文件
-
-| 文件 | 用途 |
-|---|---|
-| `STATE.md` | 当前阶段、状态、下一步命令 |
-| `.runtime/progress.json` | 步骤进度、摘要、时间戳 |
-| `.runtime/user-inputs.md` | 用户输入记录 |
-| `specs/*.md` | 设计文档 |
-| `changes/*/design.md` | 技术方案 |
-
-### 同步方案
-
-- **启动时**：全量读取 `.sillyspec/` 目录，构建初始状态
-- **运行时**：chokidar watch 文件变化 → 解析 → WebSocket 增量推送
-- **不轮询，不做 diff**，文件变化直接读取推送
-
-### CLI 命令执行（一期）
-
-后端通过 `child_process.spawn` 执行 CLI 命令：
-- "下一步"按钮 → `sillyspec next`
-- 阶段切换按钮 → `sillyspec plan` / `sillyspec execute` 等
-- 执行结果通过 WebSocket 实时推送到前端日志面板
-
-## 交互设计
-
-### 键盘快捷键
-
-| 快捷键 | 功能 |
-|---|---|
-| `j/k` | 上下切换步骤 |
-| `Enter` | 展开详情 |
-| `Escape` | 收起面板 |
-| `/` | 搜索日志 |
-| `Cmd/Ctrl+K` | 命令面板 |
-
-### 命令面板功能
-
-- 搜索项目名
-- 跳转到指定阶段
-- 切换深色/浅色主题
-
-### CLI 命令
-
-```bash
-sillyspec dashboard              # 启动 + 自动开浏览器
-sillyspec dashboard --port 8080  # 自定义端口
-sillyspec dashboard --no-open    # 不自动打开浏览器
-```
-
-## 视觉设计
-
-### 配色
-
-| 用途 | 色值 |
-|---|---|
-| 背景 | `#0D1117` |
-| 主色（进行中） | `#00D4AA` |
-| 阻塞 | `#F59E0B` |
-| 失败 | `#F87171` |
-| 未开始 | `#6B7280` |
-
-### 动效
-
-- 阶段完成：脉冲光效（CSS animation，200ms）
-- 日志新行：淡入
-- hover 过渡：100ms
-- 进度条：弹性缓动
-
-## 技术选型
-
-| 层 | 技术 |
-|---|---|
-| 前端框架 | Vue 3 |
-| 构建工具 | Vite |
-| CSS | Tailwind CSS |
-| 后端 | Node.js 原生 http + ws |
-| 文件监听 | chokidar |
-| 数据库 | 无，纯文件系统 |
-
-## 约束和假设
-
-- 用户本地已有 Node.js（SillySpec 前置依赖）
-- 仪表盘为本地工具，不考虑多用户并发
-- 前端构建产物嵌入 npm 包，无需额外 build
-- 不引入 Express、数据库等重依赖
-
-## 状态历史时间线
-
-Pipeline 视图下方展示时间线，记录每个步骤的：
-- 开始时间 / 结束时间 / 耗时
-- 状态变化（进行中 → 完成/阻塞/失败）
-- 可按时间排序，快速定位耗时最长或异常步骤
-
-数据来源：`progress.json` 中的 `summaries` 和时间戳。
-
-## 不在范围内（一期）
-
-- 用户认证/权限
-- 多人协作
-- 数据持久化（纯文件系统）
-- AI 对话交互（二期）
-- Web Terminal（二期）
-
-## 验收标准
-
-- [ ] `sillyspec dashboard` 一键启动，自动打开浏览器
-- [ ] 三栏布局正确渲染，响应式适配
-- [ ] 文件变化后前端实时更新（<1s 延迟）
-- [ ] 步骤卡片三级信息分层（默认/hover/点击）
-- [ ] 实时日志流正常显示，可搜索可过滤
-- [ ] 键盘快捷键可用（j/k/Enter/Escape/Cmd+K）
-- [ ] 命令面板可搜索项目名和阶段
-- [ ] CLI 命令执行按钮可用，结果实时显示
-- [ ] 异常步骤自动高亮
-- [ ] 深色/浅色主题切换