sillyspec 3.26.4 → 3.26.6

package/src/stages/archive.js

@@ -25,34 +25,20 @@ export const definition = {
     },
     {
       name: 'extract-module-impact',
-      prompt: `按照 \`.sillyspec/workflows/archive-impact.yaml\` 中定义的 \`impact-analyzer\` 角色规则，分析本次变更影响的模块。
-
-### 文件标题规则（sillyhub 平台解析识别用）
-module-impact.md 第一行标题必须用中文：# 模块影响分析（Module Impact）— <变更简述>
+      prompt: `最终确认 changes/<change>/module-impact.md（本次变更的模块影响分析）。该文档由 plan review_plan 步生成首版、execute 各 Wave 更新、verify 核对——本步是归档前最后一次确认（module-impact 已非 archive 生成，改活文档终审）。
 
 ### 操作
-1. 读取 \`.sillyspec/workflows/archive-impact.yaml\`，了解角色定义和检查规则
-2. 读取变更目录下的 proposal.md、design.md、tasks.md
-3. 运行 \`git diff --name-only HEAD~1\`（或 \`git diff --name-only --cached\`）获取真实修改文件列表
-4. 读取 \`.sillyspec/docs/<project>/modules/_module-map.yaml\`
-   - **如果不存在**：提示"建议运行 scan 生成模块映射"，但继续执行。跳到步骤 7 生成只有 unmapped 部分的 module-impact.md
-5. 三重交叉验证：
-   - 声明范围：proposal.md / design.md 中的"变更范围"/"文件变更清单"
-   - 任务范围：tasks.md / plan.md 中的任务文件路径
-   - 真实变更：git diff 文件列表
-   - **以 git diff 为准**（真实 > 声明）
-6. 将 git diff 文件按 \`_module-map.yaml\` 的 paths glob 匹配到模块
-7. 生成模块影响矩阵：
-
-| 模块 | 影响类型 | 相关文件 | 更新内容摘要 | needs_review |
-|------|----------|----------|-------------|-------------|
-
-   影响类型：逻辑变更 / 数据结构变更 / 接口变更 / 调用关系变更 / 配置变更 / 新增
-   needs_review：如果影响无法完全确定，标记为 true
-
-8. 未匹配到任何模块的文件归入"未匹配文件"表格
-9. 生成 \`.sillyspec/changes/<change-name>/module-impact.md\``,
-      outputHint: 'module-impact.md 路径 + 影响摘要',
+1. 读取 changes/<change>/module-impact.md（应已存在；large 变更 plan 阶段产出首版）
+2. 运行 git diff --name-only HEAD~1（或 git diff --name-only --cached）获取真实修改文件列表
+3. 三重核对：module-impact.md 记录的受影响模块/文件 vs 真实 git diff 文件列表 vs .sillyspec/docs/<project>/modules/_module-map.yaml 模块映射（不存在则仅核 unmapped 部分）。以 git diff 为准（真实 > 记录）
+4. 发现不一致（漏标受影响模块 / 影响类型错误 / 实际未触碰的模块被误标）→ 直接修正 module-impact.md，使其与实际变更一致
+5. module-impact.md 第一行标题必须用中文：# 模块影响分析（Module Impact）— <变更简述>
+
+### 降级（module-impact.md 不存在）
+若缺失（如旧变更未经新 plan 流程，或 small 变更从未生成），按原生成逻辑补一份：读 .sillyspec/workflows/archive-impact.yaml 的 impact-analyzer 角色规则 + git diff + _module-map.yaml，生成模块影响矩阵（模块 × 影响类型 × 相关文件 × 更新摘要 × needs_review，未匹配文件归入 unmapped 表）落盘 module-impact.md。
+
+确认完成后，下一步 sync-module-docs 会读 module-impact.md 更新模块卡片文档。`,
+      outputHint: 'module-impact.md 终审结果 + 修正摘要',
       optional: false
     },
     {

package/src/stages/brainstorm-auto.js

@@ -66,6 +66,7 @@ export const definition = {
       maxWaitRounds: 5,
       waitReason: '等待用户回答需求问题',
       waitOptions: ['回答见--answer', '信息够了，进入设计'],
+      waitFreeAnswer: true, // 开放回答型：--answer 内容为自由文本（需求澄清回答），非封闭单选，豁免 enforceWaitChoice
       prompt: `分析需求，必要时追问，然后设计方案。
 
 ### 操作

package/src/stages/brainstorm.js

@@ -79,6 +79,7 @@ export const definition = {
       maxWaitRounds: 8,
       waitReason: '等待用户回答需求问题或澄清',
       waitOptions: ['回答见--answer', '信息够了，进入方案讨论'],
+      waitFreeAnswer: true, // 开放回答型：--answer 内容为自由文本（需求澄清回答），非封闭单选，豁免 enforceWaitChoice
       prompt: `通过对话探索需求细节、分析原型（如有）、判断拆分/批量、并对歧义点做需求澄清 Grill。本步骤合并了原有的对话探索、原型分析、需求范围评估、需求澄清 Grill 四个环节——按下方 A→D 顺序按需执行。提问遵守「一次只问一个」（见 D 节追问策略）：必须问的问题逐个问，能查代码/文档解决的不问；不要把多个歧义打包成一屏清单一次抛给用户（用户记不住、答不全，反而漏掉关键约束）；也不要为凑数把单个问题拖成多轮。
 
 ### A. 原型/设计图分析（如用户提供）

package/src/stages/execute.js

@@ -33,7 +33,11 @@ export function validatePlanForExecute(planContent) {
 
   // 检查 1: 至少有一个 checkbox task
   if (allTasks.length === 0) {
+    // 诊断根因（坑 plan-md-format-contract-hidden）：笼统报"没有找到 checkbox task"逼 agent 试错。
+    // 区分：无 Wave/Tasks 段 / Wave 标题格式不对 / task 用 ### 标题 / checkbox 被非 Wave 标题打断。
+    const diags = diagnoseNoTaskRootCause(planContent)
     errors.push('plan.md 中没有找到 checkbox task（格式: "- [ ] task-XX: 任务名"）')
+    for (const d of diags) errors.push(`  诊断：${d}`)
     return { ok: false, errors, warnings, tasks: allTasks, waves }
   }
 
@@ -357,6 +361,39 @@ Apply Decision + 下一步建议
   }
 ]
 
+/**
+ * 诊断 plan.md 无 checkbox task 的根因（坑 plan-md-format-contract-hidden）。
+ * 纯函数：读 planContent 文本，返回诊断提示数组。validatePlanForExecute 无 task 时追加到报错，
+ * 帮 agent 区分 4 条隐性格式契约（Wave 标题字面 / task checkbox / task-XX 编号 / ### 打断 Wave 段）。
+ * @param {string} planContent
+ * @returns {string[]}
+ */
+function diagnoseNoTaskRootCause(planContent) {
+  const diags = []
+  const hasWaveHeading = /^#+\s*Wave\s+\d+/im.test(planContent)         // "## Wave N"（字面）
+  const hasWaveWord = /^#+\s*(wave\s*\d+|w\d+|波次\s*\d+)/im.test(planContent) // 疑似 Wave 标题（含 W1/Wave1/波次1）
+  const hasCheckboxTask = /^[-*]\s*\[[ x]\]\s*task-\d+/im.test(planContent) // "- [ ] task-XX:" checkbox
+  const hasTaskHeading = /^#+\s*task-\d+/im.test(planContent)            // "### task-XX:" 标题（非 checkbox）
+  const hasTasksSection = /^#+\s*(tasks?|任务)\s*$/im.test(planContent)  // "## Tasks" / "## 任务"
+
+  if (!hasWaveHeading && !hasTasksSection) {
+    if (hasWaveWord) {
+      diags.push('Wave 标题格式不对：必须字面 "## Wave N"（Wave + 空格 + 数字），"## W1" / "## Wave1" / "## 波次1" 都不被识别')
+    } else if (hasCheckboxTask) {
+      diags.push('有 task checkbox 但不在 "## Wave N"（full）或 "## Tasks"（light/none）段内——非任务区的 checkbox 不收')
+    } else {
+      diags.push('plan.md 缺任务区：full 需 "## Wave 1" 标题，light/none 需 "## Tasks" 标题')
+    }
+  }
+  if (hasTaskHeading) {
+    diags.push('task 用了 "### task-XX:" 标题（非 checkbox）：标题会打断 Wave 段导致后续 checkbox 全被跳过，请改用 "- [ ] task-XX: 名称"（英文冒号）')
+  }
+  if (hasWaveHeading && hasCheckboxTask && !hasTaskHeading) {
+    diags.push('有 Wave 段也有 checkbox task 但未收容：checkbox 可能落在非任务区（如 "## 自检" 段）或被 "###" 标题打断，请检查 task 是否紧跟在 "## Wave N" 下')
+  }
+  return diags
+}
+
 /**
  * 从 plan 文件解析 Wave 分组
  */
@@ -868,6 +905,14 @@ task-XX 对应：{SPEC_ROOT}/.runtime/execute-runs/{EXECUTE_RUN_ID}/tasks/task-X
 - \`cannot_verify\` 只在确实无法验证且有待补充证据时使用，且 requiredEvidence 必须非空
 - \`sillyspec run execute --done\` 会校验所有 task 的 review.json，缺失或 fail 会阻断完成
 
+### module-impact.md 更新（主代理在本 Wave 所有 task 完成后汇总）
+本 Wave 内所有 task 子代理完成、review.json 写好后，**由你（主代理/调度者）**汇总本 Wave 的实际代码变更，更新 {SPEC_ROOT}/changes/<change>/module-impact.md（plan 阶段已生成首版）：
+- 基于本 Wave 各 task 的实际 git diff（不是计划）+ {SPEC_ROOT}/docs/<project>/modules/_module-map.yaml 对照
+- 更新受影响模块的影响类型/说明（实际改动可能与 plan 首版预估不同，据实修正）
+- **不由各 task 子代理分别改**（同 Wave 并行子代理改同一文件会互相覆盖）——只由主代理在 Wave 收尾统一更新一次
+- 无 _module-map.yaml 时跳过模块匹配，仅按文件清单更新 unmapped 部分
+这是可选更新（不阻断 execute 完成），但保持 module-impact 与实际变更一致利于 verify 核对与 archive 终审。
+
 ### 完成后
 1. 为每个后端 router task，扫描变更文件提取 API 端点 artifact：
    - 在变更文件中搜索所有 router 注册路径（@router.get/post/put/delete）

package/src/stages/plan.js

@@ -343,9 +343,25 @@ tier: {REVIEW_TIER}（{REVIEW_TIER_REASON}）
 {REVIEW_JSON_CONTRACT}
 4. verdict=fail 时在 reviewerNotes 写明阻断项
 
+### 生成 module-impact.md 首版（scale≠small 时）
+计划审查通过后，顺带生成 module-impact.md 首版（本次变更的模块影响分析，供 execute/verify 阶段更新、archive 阶段终审）。scale=small 不生成（small 走 quick，module-impact 对 quick 无用）。
+
+输入（此时 TaskCard/allowed_paths 尚未生成——在下一步 generate_blueprints，故用以下两项作输入，粒度与 archive 现状一致）：
+- design.md 的「文件变更清单」（本次计划改哪些源码文件）
+- plan.md 的任务列表（每个 task 改的范围）
+
+步骤（复用 archive extract-module-impact 的核心指引，同源——改 archive step2 prompt 时保持一致）：
+1. 读 {SPEC_ROOT}/docs/<project>/modules/_module-map.yaml（模块→文件路径映射）。**不存在 → 降级**：生成只含 unmapped 部分的 module-impact.md + 提示「建议运行 scan 生成模块映射」，不阻断
+2. 对照 design 文件变更清单 + plan 任务列表，逐文件匹配所属模块（命中的归 mapped，未命中的归 unmapped）
+3. 生成模块影响矩阵（模块 × 影响类型[新增/修改/删除/依赖变更] × 说明），落盘 {SPEC_ROOT}/changes/<change>/module-impact.md
+4. 首行标题必须用中文：# 模块影响分析（Module Impact）— <变更简述>
+
+execute/verify 阶段会按实际代码变更更新此文档；archive 阶段会最终确认它。
+
 ### 输出
 - tier=self：审查清单结果（每条状态 + 偏差说明）
-- tier=independent：子代理产出的 review.json 路径 + verdict 摘要`,
+- tier=independent：子代理产出的 review.json 路径 + verdict 摘要
+- scale≠small：附 module-impact.md 路径 + 影响摘要`,
   outputHint: 'plan 审查结果（self=清单 / independent=review.json 路径+verdict）',
   optional: false
 }

package/src/stages/quick.js

@@ -93,6 +93,8 @@ sillyspec run quick --done --change <id> --output "需求：… 根因：… 方
 
 格式：\`path::括注\` 一条，\`||\` 分隔多条（括注可省略只留 \`path\`）。不传则「文件：」行回填审计到的实际改动文件单行（仍可事后手改）。
 
+> ⚠️ --file-notes 只随 step3 --done 同一命令传才生效。CLI 是短进程，run 与 done 是独立进程——step1/step2 的 sillyspec run quick（仅拿提示词）即使带了 --file-notes，也只写进那个短进程的内存、进程结束即丢，不会带到 step3 --done。请在 step3 收尾时连同 --output 一起传。
+
 ### 收尾推荐顺序（模块文档在 --done 前，QUICKLOG 在 --done 后，别记混）
 1. 【--done 前】命中模块 → 改模块文档 → \`git add -- <模块文档>\`（见下方「模块文档同步」）
 2. 【--done】\`sillyspec run quick --done --change <id> --output "四字段" [--file-notes "..."]\`（CLI 自动翻完成 + 勾 task + 落盘 QUICKLOG 标题/文件/正文）

package/src/stages/scan.js

@@ -281,7 +281,7 @@ local.yaml 生成结果（已存在/已生成 + project.type + agent 补充的
 
 ### YAML 格式
 \`\`\`yaml
-schema_version: 1
+schema_version: 2
 project: <project-name>
 source_commit: <git-head-short>
 generated_at: <now-datetime>
@@ -313,7 +313,7 @@ modules:
 
 ### 示例
 \`\`\`yaml
-schema_version: 1
+schema_version: 2
 project: multi-agent-platform
 source_commit: abc1234
 generated_at: 2026-06-02 22:00:00

package/src/stages/verify.js

@@ -197,6 +197,7 @@ export const definition = {
 
 3. 生成 verify-result.md 文件，保存到 \`.sillyspec/changes/<change-name>/verify-result.md\`
 4. 给出结论：PASS / PASS WITH NOTES / FAIL（受风险门控约束）
+5. **核对 module-impact.md**（若 changes/<change>/module-impact.md 存在）：对照本次实际代码变更（git diff）与 module-impact.md 的模块影响矩阵，发现不一致（漏标受影响模块 / 影响类型错误 / 实际未触碰的模块被误标）则在 verify-result.md 标注。module-impact 由 plan 首版生成、execute 各 Wave 更新，verify 是最后一次核对机会（archive 仅终审不再生成）。这是 advisory 核对（不阻断 verify 完成），但 module-impact 与实际严重背离应记为风险。
 
 ### verify-result.md 格式
 \`\`\`markdown

package/src/worktree-apply.js

@@ -414,7 +414,7 @@ export function applyWorktree(changeName, { cwd, checkOnly = false, merge = fals
   if (changedFiles.length === 0) {
     // 没有变更
     if (!checkOnly) {
-      wm.cleanup(changeName);
+      wm.cleanup(changeName, { force: true });
     }
     result.ok = true;
     return result;
@@ -646,7 +646,7 @@ export function applyWorktree(changeName, { cwd, checkOnly = false, merge = fals
 
     // --- 8. 成功后自动 cleanup（失败不影响整体结果） ---
     try {
-      wm.cleanup(changeName);
+      wm.cleanup(changeName, { force: true });
     } catch (cleanupErr) {
       result.warnings = result.warnings || [];
       result.warnings.push(`cleanup 失败（不影响应用结果）: ${cleanupErr.message}`);
@@ -756,7 +756,7 @@ function applyByMerge(result, changeName, projectRoot, wm) {
   result.ok = true;
   try { result.mergeSummary = git(projectRoot, ['log', '--oneline', '-1']); } catch {}
   try {
-    wm.cleanup(changeName);
+    wm.cleanup(changeName, { force: true });
   } catch (cleanupErr) {
     result.warnings = result.warnings || [];
     result.warnings.push(`cleanup 失败（不影响 merge 结果）: ${cleanupErr.message}`);

package/src/worktree.js

@@ -236,6 +236,53 @@ export function copyUntrackedEntry(src, dst) {
   }
 }
 
+/**
+ * execute 阶段级核验（防空跑谎报，D-002@v1 / FR-04/05/06）：聚合 review.changedFiles 的交付文件，
+ * 逐个核验存在于 worktree 分支 tree 或 worktree 工作区。两处皆无 = 声称实现但从未落盘。
+ *
+ * - checked:false：worktreePath 不存在或 branch 不存在（git rev-parse --verify <branch> 失败）
+ *   → 无法核验（worktree 已丢 / 分支已删），调用方保守提示人工确认。
+ * - 逐文件：`git rev-parse --verify --quiet <branch>:<file>` 成功（在分支 tree）或
+ *   existsSync(worktreePath/<file>)（在工作区）→ verified；两处皆无 → missing。
+ *   tree 探测用 rev-parse --verify --quiet 而非 `git cat-file -e`：语义等价（按 branch tree 解析
+ *   blob），但 cat-file 对不存在路径会往 stderr 打 `fatal: path ... does not exist` 噪音
+ *   （git-helper gitQuiet 只吞退出码不吞 stderr），--quiet 完全静默。
+ *
+ * git 调用走项目统一入口 gitQuiet（git-helper.js，数组形式 execFileSync 不经 shell，Windows 安全）。
+ * 宽松非阻断：本函数只返回结果不 warn/exit，由调用方决定（design 为 warn 不 exit）。
+ *
+ * @param {object} p
+ * @param {string} p.worktreePath - worktree 根目录（绝对路径，meta.worktreePath）
+ * @param {string} p.branch - sillyspec/<change> 分支名（核验 tree）
+ * @param {string[]} p.changedFiles - review 声称的交付文件（调用方已过滤主仓 repo、非 .sillyspec）
+ * @returns {{ missing: string[], verified: string[], checked: boolean }}
+ *   checked=false 表示无法核验（worktree/分支不存在），调用方保守提示人工确认。
+ */
+export function findMissingDeliverables({ worktreePath, branch, changedFiles }) {
+  const files = Array.isArray(changedFiles)
+    ? changedFiles.filter(f => typeof f === 'string' && f.trim() !== '')
+    : []
+  // worktree 目录不存在 → 无法核验（目录已丢，如 apply 后 cleanup / 并行 session 清过）
+  if (!worktreePath || !existsSync(worktreePath)) {
+    return { missing: [], verified: [], checked: false }
+  }
+  // branch 不存在（rev-parse --verify 失败）→ 无法核验分支 tree
+  if (!branch || !gitQuiet(worktreePath, ['rev-parse', '--verify', '--quiet', branch])) {
+    return { missing: [], verified: [], checked: false }
+  }
+  const missing = []
+  const verified = []
+  for (const raw of files) {
+    // 统一正斜杠：review.json 可能落 Windows 反斜杠路径，rev-parse tree 路径一律 /
+    const f = raw.replace(/\\/g, '/')
+    const inBranch = gitQuiet(worktreePath, ['rev-parse', '--verify', '--quiet', `${branch}:${f}`]) !== null
+    const inWorktree = existsSync(join(worktreePath, f))
+    if (inBranch || inWorktree) verified.push(raw)
+    else missing.push(raw)
+  }
+  return { missing, verified, checked: true }
+}
+
 export class WorktreeManager {
   constructor({ cwd, worktreeDir } = {}) {
     this.cwd = cwd || process.cwd();
@@ -704,8 +751,9 @@ export class WorktreeManager {
    * 三重清理：git worktree 注册 + worktree 目录 + meta 目录。
    * @param {string} changeName
    * @param {{ force?: boolean, maxRetries?: number }} opts
-   * @returns {{ result: 'cleaned'|'force-cleaned'|'skipped'|'kept'|'partial', mode: string|null, details: string[], residual: string[] }}
-   *   result 取值：cleaned=git remove 成功；force-cleaned=git remove 失败但 fallback 清理完成；
+   * @returns {{ result: 'blocked'|'cleaned'|'force-cleaned'|'skipped'|'kept'|'partial', mode: string|null, details: string[], residual: string[] }}
+   *   result 取值：blocked=有未落主仓交付变更，fail-closed 拒绝清理（需 force 绕过，D-001@v1）；
+   *   cleaned=git remove 成功；force-cleaned=git remove 失败但 fallback 清理完成；
    *   partial=有残留（目录/meta/git 注册未清）；skipped=无需清理；kept=native-worktree 保留。
    *   residual：未清干净的路径/引用列表（空数组表示干净）。
    */
@@ -731,6 +779,21 @@ export class WorktreeManager {
       return { result: 'kept', mode, details: ['native-worktree: 外部隔离环境，跳过清理'], residual: [] };
     }
 
+    // fail-closed 保护（D-001@v1）：junction 解链与 git worktree remove --force 之前，检查未落主仓交付变更。
+    // 清理即蒸发：worktree 有未 commit / 未 apply 到主仓 HEAD 的交付文件，拒绝清理，需显式 --force 绕过。
+    // hasUnappliedChanges 判定 main HEAD（byte-identical），git apply --3way 不 commit → apply 后仍判 true，
+    // 故 apply 后自动 cleanup 与 execute reset 显式传 force:true 绕过（D-006）。in-place / native-worktree
+    // 由 hasUnappliedChanges 内部返回 hasChanges:false，自然跳过保护，零回归。
+    if (!force) {
+      const check = this.hasUnappliedChanges(name);
+      if (check.hasChanges) {
+        console.error(`🚫 worktree cleanup 拒绝：${check.changedFiles.length} 个交付变更未落地主工作区 HEAD，清理会丢失代码。`);
+        for (const f of check.changedFiles) console.error(`   ${f}`);
+        console.error('   请先落地（sillyspec worktree apply <name>）或 commit 到分支，或显式 --force 强制清理。');
+        return { result: 'blocked', mode, details: [...details, 'blocked: uncommitted deliverable changes'], residual: [] };
+      }
+    }
+
     const branch = (meta && meta.branch) || BRANCH_PREFIX + name;
 
     // Windows 保护：先解链接 worktree/node_modules（junction 指向主 checkout），
@@ -1045,6 +1108,9 @@ export class WorktreeManager {
                 const result = this.cleanup(name);
                 if (result.result === 'cleaned' || result.result === 'force-cleaned') {
                   fixed.push(`cleaned stale: ${name}`);
+                } else if (result.result === 'blocked') {
+                  console.error(`🚫 拒绝清理过期 worktree ${name}: 有未落主仓交付变更，请先 sillyspec worktree apply ${name} 或 commit 到分支，再重试 doctor --fix`);
+                  unfixable.push(`cleanup blocked: ${name}（有未落主仓交付变更）`);
                 } else {
                   unfixable.push(`cleanup skipped: ${name}`);
                 }
@@ -1093,7 +1159,10 @@ export class WorktreeManager {
 
     const worktreePath = meta.worktreePath;
     if (!worktreePath || !existsSync(worktreePath)) {
-      return { hasChanges: false, changedFiles: [], reason: 'worktree dir not found' };
+      // 目录不存在：无法判定是否有未落代码——分支可能有已 commit 但未 apply 的交付（execute 批量完成
+      // cleanup 删分支 ref 盲区，memory execute-batch-cleanup-deletes-branch-recovery）。保守保留
+      // （hasChanges:true），防 cleanup 误删分支让 commit 变 dangling。目录真丢时用户 --force 强清。
+      return { hasChanges: true, changedFiles: [], reason: 'worktree dir not found (conservative keep)' };
     }
 
     // in-place 模式没有隔离目录，不算有未 apply 的变更
@@ -1107,16 +1176,22 @@ export class WorktreeManager {
 
     const diffBase = meta.baselineCommit || meta.baseHash;
     if (!diffBase) {
-      return { hasChanges: false, changedFiles: [], reason: 'no diff base' };
+      // 有 meta 但缺 diff 起点：无法判定是否有未落代码，保守保留（防 cleanup 删分支）
+      return { hasChanges: true, changedFiles: [], reason: 'no diff base (conservative keep)' };
     }
 
     const isDeliverable = f => f && !f.startsWith('.sillyspec/') && f !== 'meta.json';
     try {
       // 1) 候选交付变更（worktree 工作区相对 diffBase）。--no-renames：rename 退化成 D+A，两侧文件都进集
-      const tracked = (gitQuiet(worktreePath, ['diff', '--no-renames', '--name-only', diffBase], { timeout: 30000 }) || '')
-        .split('\n').filter(Boolean).filter(isDeliverable);
-      const untracked = (gitQuiet(worktreePath, ['ls-files', '--others', '--exclude-standard'], { timeout: 30000 }) || '')
-        .split('\n').filter(Boolean).filter(isDeliverable);
+      const trackedRaw = gitQuiet(worktreePath, ['diff', '--no-renames', '--name-only', diffBase], { timeout: 30000 });
+      const untrackedRaw = gitQuiet(worktreePath, ['ls-files', '--others', '--exclude-standard'], { timeout: 30000 });
+      // git 检测失败（返回 null，如 worktree .git 半坏/目录部分删除）→ 不能当"无改动"，保守保留。
+      // 只有 git 成功返回空才判"真无改动"（可安全清理）。
+      if (trackedRaw === null || untrackedRaw === null) {
+        return { hasChanges: true, changedFiles: [], reason: `git detection failed (conservative keep): tracked=${trackedRaw === null ? 'null' : 'ok'} untracked=${untrackedRaw === null ? 'null' : 'ok'}` };
+      }
+      const tracked = trackedRaw.split('\n').filter(Boolean).filter(isDeliverable);
+      const untracked = untrackedRaw.split('\n').filter(Boolean).filter(isDeliverable);
 
       if (tracked.length === 0 && untracked.length === 0) {
         return { hasChanges: false, changedFiles: [], reason: 'no changes in worktree' };

package/packages/dashboard/index.html

@@ -1,15 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>SillySpec Dashboard</title>
-  <link rel="preconnect" href="https://fonts.googleapis.com">
-  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=DM+Sans:ital,opsz,wght@0,9..40,300;0,9..40,400;0,9..40,500;0,9..40,600;0,9..40,700&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
-</head>
-<body style="background-color: #0A0A0B; margin: 0;">
-  <div id="app"></div>
-  <script type="module" src="/src/main.js"></script>
-</body>
-</html>