sillyspec 3.20.1 → 3.20.3

package/src/stages/doctor.js

@@ -18,10 +18,9 @@ export const definition = {
 for d in .sillyspec .sillyspec/projects .sillyspec/docs .sillyspec/changes .sillyspec/.runtime; do
   [ -d "$d" ] && echo "✅ $d" || echo "❌ $d"
 done
-# 检查 sillyspec.db（SQLite 权威状态源）
-DB_FILE='.sillyspec/.runtime/sillyspec.db'
-[ -f "$DB_FILE" ] && echo "✅ sillyspec.db 存在" || echo "❌ sillyspec.db 不存在"
-sqlite3 "$DB_FILE" "SELECT count(*) FROM project" 2>/dev/null && echo "✅ sillyspec.db 可查询" || echo "⚠️ sillyspec.db 不可查询"
+# 检查 progress.json
+[ -f .sillyspec/.runtime/progress.json ] && echo "✅ progress.json 存在" || echo "❌ progress.json 不存在"
+node -e "JSON.parse(require('fs').readFileSync('.sillyspec/.runtime/progress.json','utf8')); console.log('✅ progress.json 可解析')" 2>/dev/null || echo "⚠️ progress.json 不可解析"
 \`\`\`
 
 ### 2. 项目配置检查
@@ -41,31 +40,40 @@ done
 
 ### 3. 进度数据一致性
 \`\`\`bash
-# 从 sillyspec.db 读取活跃变更并检查目录存在性
-DB_FILE='.sillyspec/.runtime/sillyspec.db'
-if [ ! -f "$DB_FILE" ]; then echo "⚠️ sillyspec.db 不存在"; exit 0; fi
-ACTIVE_CHANGE=$(sqlite3 "$DB_FILE" "SELECT name FROM changes WHERE status='active' ORDER BY last_active DESC LIMIT 1" 2>/dev/null)
-if [ -z "$ACTIVE_CHANGE" ]; then echo "ℹ️ 无当前变更"; exit 0; fi
-echo "当前变更: $ACTIVE_CHANGE"
-DIR=".sillyspec/changes/$ACTIVE_CHANGE"
-[ -d "$DIR" ] && echo "✅ 变更目录存在: $ACTIVE_CHANGE" || echo "❌ 变更目录不存在: $ACTIVE_CHANGE"
-# 检查各阶段状态
-sqlite3 -header -column "$DB_FILE" "SELECT stage, status FROM stages s JOIN changes c ON s.change_id=c.id WHERE c.name='$ACTIVE_CHANGE' ORDER BY s.stage" 2>/dev/null || echo "⚠️ 无法查询阶段数据"
+# 读取 currentChange 并检查目录存在性
+node -e "
+const p = JSON.parse(require('fs').readFileSync('.sillyspec/.runtime/progress.json','utf8'));
+const cc = p.currentChange;
+if (!cc) { console.log('ℹ️ 无当前变更'); process.exit(0); }
+const dir = '.sillyspec/changes/' + cc;
+const exists = require('fs').existsSync(dir);
+console.log(exists ? '✅ currentChange 目录存在: ' + cc : '❌ currentChange 目录不存在: ' + cc);
+// 检查各阶段产出
+const stages = p.stages || {};
+for (const [name, sd] of Object.entries(stages)) {
+  if (sd.status === 'completed' && sd.steps.length > 0) {
+    const hasOutput = sd.steps.some(s => s.output && s.output.trim());
+    console.log('  ' + name + ': ' + (hasOutput ? '✅ 有产出' : '⚠️ 已完成但无产出记录'));
+  }
+}
+" 2>/dev/null || echo "⚠️ 无法读取 progress.json"
 \`\`\`
 
 ### 4. 孤儿文件检查
 \`\`\`bash
-DB_FILE='.sillyspec/.runtime/sillyspec.db'
-if [ ! -f "$DB_FILE" ]; then echo "⚠️ sillyspec.db 不存在"; exit 0; fi
 node -e "
 const fs = require('fs');
 const dir = '.sillyspec/changes';
 if (!fs.existsSync(dir)) { console.log('ℹ️ changes/ 目录不存在'); process.exit(0); }
 const subs = fs.readdirSync(dir).filter(f => fs.statSync(dir+'/'+f).isDirectory());
 if (subs.length === 0) { console.log('ℹ️ 无变更目录'); process.exit(0); }
-const { execSync } = require('child_process');
-let known;
-try { const rows = execSync('sqlite3 -json \".sillyspec/.runtime/sillyspec.db\" \"SELECT name FROM changes WHERE status=\\\"active\\\"\"', {encoding:'utf8'}).trim(); known = new Set(JSON.parse(rows).map(r => r.name)); } catch { known = new Set(); }
+let progress;
+try { progress = JSON.parse(fs.readFileSync('.sillyspec/.runtime/progress.json','utf8')); } catch { console.log('⚠️ 无法读取 progress.json'); subs.forEach(s => console.log('❓ ' + s)); process.exit(0); }
+const known = new Set();
+if (progress.currentChange) known.add(progress.currentChange);
+for (const sd of Object.values(progress.stages || {})) {
+  (sd.steps || []).forEach(s => { if (s.output) known.add(s.output); });
+}
 subs.forEach(s => {
   console.log(known.has(s) ? '✅ ' + s + ' — 已关联' : '⚠️ ' + s + ' — 孤儿目录（可清理）');
 });
@@ -84,54 +92,13 @@ for f in .sillyspec/projects/*.yaml; do
   stack_md="$p/.sillyspec/STACK.md"
   [ -f "$local_yaml" ] && echo "✅ local.yaml ($name)" || echo "⚠️ local.yaml ($name) — 不存在"
   if [ -f "$local_yaml" ]; then
+    grep -q 'build:' "$local_yaml" && echo "  ✅ build 命令已配置" || echo "  ⚠️ 缺少 build 命令"
     grep -q 'test:' "$local_yaml" && echo "  ✅ test 命令已配置" || echo "  ⚠️ 缺少 test 命令"
   fi
   [ -f "$stack_md" ] && echo "✅ STACK.md ($name)" || echo "⚠️ STACK.md ($name) — 不存在"
 done
 \`\`\`
 
-### 6. Worktree 隔离环境检查
-\`\`\`bash
-# 检测当前目录是否在 submodule 中
-SUPERPROJECT=$(git rev-parse --show-superproject-working-tree 2>/dev/null)
-if [ -n "$SUPERPROJECT" ]; then
-  echo "⚠️ 当前目录在 git submodule 内，worktree 隔离不可用"
-else
-  echo "✅ 不在 submodule 中"
-fi
-
-# 检测是否已在 linked worktree 中
-GIT_DIR=$(cd "$(git rev-parse --git-dir)" 2>/dev/null && pwd -P)
-GIT_COMMON=$(cd "$(git rev-parse --git-common-dir)" 2>/dev/null && pwd -P)
-if [ "$GIT_DIR" != "$GIT_COMMON" ] && [ -z "$SUPERPROJECT" ]; then
-  echo "✅ 已在 linked worktree 中"
-else
-  echo "ℹ️ 在主仓库中（非 worktree）"
-fi
-
-# 检查 worktree 存储目录是否被 .gitignore 忽略
-WT_DIR='.sillyspec/.runtime/worktrees'
-if git check-ignore -q "$WT_DIR" 2>/dev/null; then
-  echo "✅ worktree 目录已被 .gitignore 忽略 ($WT_DIR)"
-else
-  echo "❌ worktree 目录未被 .gitignore 忽略 ($WT_DIR) — worktree 创建将被阻断"
-  echo "   修复: 在 .gitignore 中添加 $WT_DIR/"
-fi
-
-# 检查 DB 中的 isolation 状态
-DB_FILE='.sillyspec/.runtime/sillyspec.db'
-if [ -f "$DB_FILE" ]; then
-  echo ""
-  echo "isolation 状态（来自 sillyspec.db）:"
-  sqlite3 -header -column "$DB_FILE" "SELECT name, isolation_status AS status, isolation_mode AS mode, isolation_reason AS reason FROM changes WHERE status='active'" 2>/dev/null || echo "⚠️ 查询 isolation 失败"
-else
-  echo ""
-  echo "ℹ️ sillyspec.db 不存在（尚未初始化）"
-fi
-else
-  echo "ℹ️ gate-status.json 不存在（尚未进入 execute 阶段）"
-fi
-\`\`\`\n
 ### 输出
 汇总所有检查结果，按以下格式：
 \`\`\`
@@ -141,7 +108,16 @@ fi
 
 ### 注意
 - 不要编造路径或结果，严格基于命令输出
-- 如果 .sillyspec/ 不存在，直接输出 ❌ 并跳过后续检查`,
+- 如果 .sillyspec/ 不存在，直接输出 ❌ 并跳过后续检查
+- 额外运行 deriveState 全量校验：
+  \
+\
+\
+  node -e "import('./src/derive.js').then(m => { const pm = require('./progress.js'); const r = m.deriveState('.', {mode:'full',fix:false,progress:pm.read('.')}); console.log(JSON.stringify(r, null, 2)); })" 2>/dev/null || echo "deriveState 不可用"
+  \
+\
+\
+  将 deriveState 的 issues 列表纳入 SillySpec 内部检查结果中`,
       outputHint: 'SillySpec 内部检查结果',
       optional: false
     },
@@ -151,12 +127,12 @@ fi
 
 ### 1. 探测构建工具
 \`\`\`bash
-# 确定项目路径（使用 sillyspec.db 中的项目路径或当前目录）
-PROJECT_DIR=$(sqlite3 -json '.sillyspec/.runtime/sillyspec.db' "SELECT name FROM project WHERE id=1" 2>/dev/null | node -e "const r=JSON.parse(require('fs').readFileSync(0,'utf8'));console.log(r.length>0&&r[0].name?r[0].name:'.')" 2>/dev/null || node -e "
+# 确定项目路径（使用 progress.json 中的项目或当前目录）
+PROJECT_DIR=$(node -e "
 const fs=require('fs');
-try{const files=fs.readdirSync('.sillyspec/projects').filter(f=>f.endsWith('.yaml'));
+try{const p=JSON.parse(fs.readFileSync('.sillyspec/.runtime/progress.json','utf8'));if(p.project){console.log(p.project);process.exit(0)}}catch{}
+const files=fs.readdirSync('.sillyspec/projects').filter(f=>f.endsWith('.yaml'));
 if(files.length>0){const c=fs.readFileSync('.sillyspec/projects/'+files[0],'utf8');const m=c.match(/^path:\\s*(.+)/m);console.log(m?m[1].trim():'.')}else console.log('.')
-}catch{console.log('.')}
 " 2>/dev/null)
 echo "项目目录: $PROJECT_DIR"
 
@@ -279,38 +255,9 @@ timeout 5 which docker 2>/dev/null && echo "✅ Docker 可用" || echo "ℹ️ D
       outputHint: '外部依赖检查结果',
       optional: false
     },
-    {
-      name: '模块文档健康检查',
-      prompt: `检查模块索引和卡片文档的健康状态。
-
-### 操作
-1. 运行 \`sillyspec modules status\` 查看模块索引概览
-2. 读取 \`.sillyspec/docs/<project>/modules/_module-map.yaml\`
-3. 对每个模块，检查：
-   - module_id 是否有对应的卡片文件（modules/<module-id>.md）
-   - 卡片文件是否有有效的 frontmatter（schema_version, doc_type, module_id）
-   - 人工备注标记是否配对（MANUAL_NOTES_START 和 MANUAL_NOTES_END 必须成对出现）
-   - needs_review 为 true 的模块列表
-4. 汇总结果
-
-### 输出格式
-\`\`\`
-📋 模块文档健康检查
-✅ _module-map.yaml — 存在，N 个模块
-⚠️  auth-service — needs_review=true，原因：...
-❌ payment-service — 卡片文件缺失
-✅ 所有模块人工备注标记配对正常
-\`\`\`
-
-### 注意
-- 如果 _module-map.yaml 不存在，输出"模块索引未生成，建议运行 scan"
-`,
-      outputHint: '模块文档健康状态',
-      optional: false
-    },
     {
       name: '汇总报告',
-      prompt: `汇总前四步的所有检查结果，生成最终的自检报告。
+      prompt: `汇总前三步的所有检查结果，生成最终的自检报告。
 
 ### 输出格式
 \`\`\`
@@ -320,7 +267,7 @@ timeout 5 which docker 2>/dev/null && echo "✅ Docker 可用" || echo "ℹ️ D
 ✅ .sillyspec/ 目录结构 — 正常
 ✅ projects/*.yaml — N 个项目已注册
 ⚠️  local.yaml (xxx) — 缺少 test 命令
-❌ sillyspec.db 阶段状态 — brainstorm 标记完成但 design.md 不存在
+❌ progress.json — brainstorm 标记完成但 design.md 不存在
 
 ## 构建环境
 ✅ Node.js v23.4.0 — 可用
@@ -345,9 +292,9 @@ timeout 5 which docker 2>/dev/null && echo "✅ Docker 可用" || echo "ℹ️ D
 **常见问题及修复：**
 - CLI 未安装 → \`npm install -g sillyspec\`
 - 缺少 local.yaml → \`sillyspec init\` 重新生成，或手动创建
-- local.yaml 缺少 test 命令 → 补充对应命令
+- local.yaml 缺少 build/test → 补充对应命令
 - 缺少 STACK.md → \`sillyspec run scan\` 重新扫描
-- sillyspec.db 状态不一致 → \`sillyspec run <阶段> --reset\` 重置对应阶段
+- progress.json 不一致 → \`sillyspec run <阶段> --reset\` 重置对应阶段
 - 孤儿目录 → 确认后 \`rm -rf .sillyspec/changes/<目录名>\`
 - Maven 私服不可达 → 检查 VPN、settings.xml 配置、私服状态
 - Git remote 不可达 → 检查网络、SSH key 或凭证