sillyspec 3.20.5 → 3.20.7

package/src/stage-contract.js

@@ -144,8 +144,14 @@ function readIfExists(file) {
 }
 
 function warnMissingIds(warnings, ids, targetContent, targetName, sourceName) {
+  // 剥版本后缀（@vN）按基号词边界匹配：target 里写裸号 D-001 即视为引用了 D-001@V1
+  // 的当前版本（prompt 常裸号引用，旧版字面 includes("D-001@V1") 会批量误报）。
+  // 大小写不敏感：target 整体大写后比对。
+  const targetUpper = targetContent.toUpperCase()
   for (const id of ids) {
-    if (!targetContent.toUpperCase().includes(id)) {
+    const base = id.replace(/@V\d+$/, '')
+    const re = new RegExp(`\\b${base}\\b`)
+    if (!re.test(targetUpper)) {
       warnings.push(`${targetName} 未引用 ${sourceName} 中的 ${id}`)
     }
   }
@@ -281,9 +287,9 @@ function validateBrainstormOutputs(cwd, changeName, context = {}) {
       const design = readIfExists(join(changeDir, 'design.md'))
       const requirements = readIfExists(join(changeDir, 'requirements.md'))
       const tasks = readIfExists(join(changeDir, 'tasks.md'))
+      // decision 的天然引用落点是 design.md；requirements（需求按 FR 组织）与
+      // tasks（骨架，待 plan 展开）不强求逐条引用每个架构决策，否则批量误报。
       warnMissingIds(warnings, decisionIds, design, 'design.md', 'decisions.md')
-      warnMissingIds(warnings, decisionIds, requirements, 'requirements.md', 'decisions.md')
-      warnMissingIds(warnings, decisionIds, tasks, 'tasks.md', 'decisions.md')
     }
   }
 
@@ -385,10 +391,11 @@ function validateVerifyOutputs(cwd, changeName, context = {}) {
     return { ok: false, errors, warnings }
   }
 
-  // verify 阶段应该产出 verify-result.md（或类似报告）
+  // verify 阶段必须产出 verify-result.md —— 不存在则不能完成。
+  // 历史教训：AI 可能跳过报告直接 --done，导致"假完成"。此处提级为 error 强制阻断。
   const verifyResult = join(changeDir, 'verify-result.md')
   if (!existsSync(verifyResult)) {
-    warnings.push('verify-result.md 不存在（verify 阶段建议产出验证报告）')
+    errors.push(`verify-result.md 不存在 — verify 阶段必须产出验证报告才能完成（${verifyResult}）`)
   }
 
   // 确保核心规范文件仍然存在
@@ -409,6 +416,17 @@ function validateVerifyOutputs(cwd, changeName, context = {}) {
     const decisionIds = extractCurrentDecisionIds(decisions)
     warnMissingIds(warnings, decisionIds, verify, 'verify-result.md', 'decisions.md')
 
+    // ── FAIL 结论门控（适用于所有变更，不限风险等级）──
+    // verify-result.md 结论为 FAIL 时，verify 阶段不能 completed。
+    // 历史教训：CLI 曾不校验结论，AI 写 FAIL 后 verify 仍被标记完成并提示"验证通过可以归档"。
+    const conclusionLine = verify.match(/^##\s*结论\s*\n\s*(PASS(?:\s+WITH\s+NOTES)?|FAIL)/im)
+    const conclusionStr = conclusionLine ? conclusionLine[1].toUpperCase().replace(/\s+/g, ' ') : ''
+    if (conclusionStr === 'FAIL') {
+      errors.push('verify-result.md 结论为 FAIL — 验证未通过，不能标记 verify 完成；请修复后重新运行验证')
+    } else if (!conclusionStr) {
+      warnings.push('verify-result.md 未识别到「## 结论」章节（应为 PASS / PASS WITH NOTES / FAIL）')
+    }
+
     // ── P0: Change Risk Gate — 核心功能缺少真实集成验证时 FAIL ──
     const changeRiskProfile = detectChangeRisk({
       designContent: readIfExists(join(changeDir, 'design.md')),

package/src/stages/quick.js

@@ -9,12 +9,12 @@ export const definition = {
       prompt: `解析任务参数，加载项目上下文。
 
 ### 操作
-1. 检查是否携带 \`--change <变更名>\`，确定记录方式
+1. 检查关联变更（\`<linked-changes>\`，逗号分隔的变更名列表；显示「（无）」= 不关联变更），确定记录方式
 2. 理解任务：模糊则问一个问题确认
 3. 加载项目信息：\`cat .sillyspec/projects/*.yaml 2>/dev/null\`（了解项目结构和技术栈）
 4. 加载上下文：\`cat .sillyspec/docs/<project>/scan/CONVENTIONS.md 2>/dev/null\`
 5. 加载本地配置：\`cat .sillyspec/local.yaml 2>/dev/null\`（构建命令、测试命令、环境变量等）
-6. 如有 \`--change\`，加载设计文档：\`cat .sillyspec/changes/<change-name>/design.md 2>/dev/null\`（理解设计意图）
+6. 若有关联变更，加载每个变更的设计文档：\`cat .sillyspec/changes/<c>/design.md 2>/dev/null\`（理解设计意图）
 7. 如有需要，查询知识库：\`cat .sillyspec/knowledge/INDEX.md 2>/dev/null\`
 
 ### 模块文档加载
@@ -24,11 +24,14 @@ export const definition = {
 
 ### 创建任务记录（⛔ 此步骤不能跳过，没有 quicklog 记录 = 未完成）
 理解完任务后，**必须**立即创建记录文件，再输出任何其他内容：
+
+**A. 始终创建 QUICKLOG（无论是否关联变更）**
 1. 使用预注入的 git 用户名：\`<git-user>\`
-2. 无 \`--change\`：创建 .sillyspec/quicklog/QUICKLOG-\`<git-user>\`.md\`（已存在则追加），写入：
+2. 创建/追加 \`.sillyspec/quicklog/QUICKLOG-\`<git-user>\`.md\`，写入：
    \`\`\`
    ## ql-<YYYYMMDD>-<NNN>-<XXXX> | <now-datetime> | <一句话任务描述>
    状态：进行中
+   关联变更：<linked-changes>
    文件：<预估要改的文件>
    \`\`\`
    - ID 格式：\`ql-YYYYMMDD-NNN-XXXX\`
@@ -36,9 +39,16 @@ export const definition = {
    - 追加前扫描文件中已有的 \`ql-<当天日期>-\` 前缀的最大序号，+1 作为新序号
    - 每天从 001 开始，跨日重新计数
    - 此 ID 可被 design.md / plan.md / archive / module 变更索引引用
-3. 有 \`--change\`：在 \`.sillyspec/changes/<change-name>/tasks.md\` 追加未勾选的 task
 
-这样 Gate 检测到 .sillyspec/\` 下有变更，就不会拦截后续的代码修改。
+**B. 若关联变更（\`<linked-changes>\` 不为「（无）」）**
+3. 解析 \`<linked-changes>\`（逗号分隔的变更名列表，可能有多个 = 一次 quick 同时归属多个变更）
+4. 对**每个**变更 \`<c>\`：在 \`.sillyspec/changes/<c>/tasks.md\` 追加一条未勾选 task：
+   \`- [ ] <ql-ID> <一句话任务描述>\`（复用步骤 A 生成的同一个 ql-ID）
+   - 若 \`changes/<c>/\` 目录或 tasks.md 不存在，先 \`mkdir -p .sillyspec/changes/<c>\` 再创建 tasks.md
+   - 同一个 ql-ID 出现在 QUICKLOG 和所有关联变更的 tasks.md 中，便于交叉引用
+   - \`<linked-changes>\` 为「（无）」时跳过本步，仅保留 QUICKLOG
+
+这样 Gate 检测到 \`.sillyspec/\` 下有变更，就不会拦截后续的代码修改。
 
 ### 输出
 quicklog 已创建（必须放在输出的第一行确认）+ 任务理解 + 上下文摘要
@@ -72,27 +82,27 @@ quicklog 已创建（必须放在输出的第一行确认）+ 任务理解 + 上
       prompt: `Git 暂存并更新任务记录。
 
 ### 操作
-1. 查看 \`git status --porcelain\`，确认只包含本次 quick 相关文件
-2. 使用 \`git add -- <file...>\` 暂存本次 quick 实际修改的文件（不要 commit，由用户通过统一提交工具处理）
-   - 禁止使用 \`git add -A\`
-   - 不要暂存 quick 开始前就已存在的无关改动
-3. 更新 Step 1 创建的记录：
-   - 无 \`--change\`：找到对应 ql-ID 的条目，将「状态：进行中」改为「状态：已完成」，补充实际改动文件和结果摘要
-   - 有 \`--change\`：勾选 tasks.md 中对应的 task checkbox
-4. QUICKLOG 轮转：超过 500 行则重命名为 \`QUICKLOG-<USER>-YYYY-MM-DD.md\`（日期取最后一条记录的日期）。新文件从空开始，ql-ID 需扫描同目录所有 QUICKLOG 文件中当天最大序号 +1
-5. 如果发现项目特有的坑，追加到 \`.sillyspec/knowledge/uncategorized.md\`
-6. 任务比预期复杂 → 建议用完整流程
-
-### 模块文档同步
-7. 读取 \`.sillyspec/docs/<project>/modules/_module-map.yaml\`（不存在则跳过以下步骤）
-8. 对比本次修改的文件（\`git diff --name-only HEAD\`）与模块映射
-9. 如果命中模块 → 直接同步模块文档：
-   - 读取对应的 \`.sillyspec/docs/<project>/modules/<module>.md\`（如不存在则新建）
-   - 根据本次改动内容更新模块文档（正文描述当前状态，底部变更索引追加本次 ql-ID）
-   - 变更索引格式：\`- ql-YYYYMMDD-NNN-XXXX | <一句话描述>\`
-   - 写入模块文档
-   - 使用 \`git add -- <module-doc>\` 暂存更新的模块文件
-10. 未命中任何模块 → 跳过，不做额外操作
+1. 查看 \`git status --porcelain\`，确认只包含本次 quick 相关文件
+2. 使用 \`git add -- <file...>\` 暂存本次 quick 实际修改的文件（不要 commit，由用户通过统一提交工具处理）
+   - 禁止使用 \`git add -A\`
+   - 不要暂存 quick 开始前就已存在的无关改动
+3. 更新 Step 1 创建的记录：
+   - QUICKLOG：找到对应 ql-ID 的条目，将「状态：进行中」改为「状态：已完成」，补充实际改动文件和结果摘要（**始终做**，无论是否关联变更）
+   - 关联变更：对 Step 1 在每个 \`changes/<c>/tasks.md\` 写入的 ql-ID task，将其 checkbox 由 \`- [ ]\` 勾选为 \`- [x]\`；若 Step 1 未写入（用户事后才决定关联），则按 Step 1 的格式补写并直接勾选
+4. QUICKLOG 轮转：超过 500 行则重命名为 \`QUICKLOG-<USER>-YYYY-MM-DD.md\`（日期取最后一条记录的日期）。新文件从空开始，ql-ID 需扫描同目录所有 QUICKLOG 文件中当天最大序号 +1
+5. 如果发现项目特有的坑，追加到 \`.sillyspec/knowledge/uncategorized.md\`
+6. 任务比预期复杂 → 建议用完整流程
+
+### 模块文档同步
+7. 读取 \`.sillyspec/docs/<project>/modules/_module-map.yaml\`（不存在则跳过以下步骤）
+8. 对比本次修改的文件（\`git diff --name-only HEAD\`）与模块映射
+9. 如果命中模块 → 直接同步模块文档：
+   - 读取对应的 \`.sillyspec/docs/<project>/modules/<module>.md\`（如不存在则新建）
+   - 根据本次改动内容更新模块文档（正文描述当前状态，底部变更索引追加本次 ql-ID）
+   - 变更索引格式：\`- ql-YYYYMMDD-NNN-XXXX | <一句话描述>\`
+   - 写入模块文档
+   - 使用 \`git add -- <module-doc>\` 暂存更新的模块文件
+10. 未命中任何模块 → 跳过，不做额外操作
 
 ### 输出
 暂存确认 + 记录路径 + 模块文档同步结果（如有）`,

package/src/sync.js

@@ -10,6 +10,17 @@
 
 import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync } from 'fs';
 import { join } from 'path';
+import { resolvePlatformSpecDir } from './progress.js';
+
+// sync 是 best-effort（网络失败只 warn）：平台指针失效时不抛，跳过平台、回退本地。
+function safePlatformSpecDir(cwd) {
+  try {
+    return resolvePlatformSpecDir(cwd);
+  } catch (e) {
+    console.warn(`[sync] 平台指针不可用，跳过平台同步：${String(e.message).split('\n')[0]}`);
+    return undefined;
+  }
+}
 
 const LOCAL_YAML = '.sillyspec/local.yaml';
 const CHANGES_DIR = '.sillyspec/changes';
@@ -200,7 +211,7 @@ export class SyncManager {
     let progressData;
     try {
       const { ProgressManager } = await import('./progress.js');
-      const pm = new ProgressManager();
+      const pm = new ProgressManager({ specDir: safePlatformSpecDir(this.cwd) });
       progressData = await pm.read(this.cwd, changeName);
     } catch (err) {
       console.warn(`[sync] 读取 progress 失败 (${changeName}): ${err.message}`);
@@ -225,7 +236,7 @@ export class SyncManager {
     // 更新 platform_last_sync
     try {
       const { ProgressManager } = await import('./progress.js');
-      const pm = new ProgressManager();
+      const pm = new ProgressManager({ specDir: safePlatformSpecDir(this.cwd) });
       await pm._updatePlatformLastSync(this.cwd, changeName);
     } catch (err) {
       console.warn(`[sync] 更新 platform_last_sync 失败: ${err.message}`);
@@ -326,7 +337,7 @@ export class SyncManager {
     // 更新本地 approvals 表
     try {
       const { ProgressManager } = await import('./progress.js');
-      const pm = new ProgressManager();
+      const pm = new ProgressManager({ specDir: safePlatformSpecDir(this.cwd) });
       await pm._updateApprovalStatus(this.cwd, changeName, result.status, result.reason);
     } catch (err) {
       console.warn(`[sync] 更新本地审批状态失败: ${err.message}`);

package/src/worktree.js

@@ -73,6 +73,17 @@ function parseJSON(raw) {
   try { return JSON.parse(raw); } catch { return null; }
 }
 
+/**
+ * 跨平台同步等待（cleanup 重试退避用）
+ * 不依赖外部 sleep 命令——Windows cmd.exe 无 sleep；当 Git for Windows 未把 usr/bin 加入
+ * PATH 时，execSync('sleep 0.5') 会抛错并从 catch 块冒泡，直接中断整个 cleanup()。
+ * 改用 busy-wait 规避，保证 retry 之间真有间隔且不依赖环境。
+ */
+function sleepMs(ms) {
+  const end = Date.now() + ms;
+  while (Date.now() < end) { /* spin */ }
+}
+
 function computeBaselineHash(cwd) {
   // 排除 .sillyspec/ 元数据目录，避免 brainstorm/plan 阶段修改的蓝图文件污染 baseline
   const exclude = '-- . ":(exclude).sillyspec/"';
@@ -198,7 +209,7 @@ export class WorktreeManager {
     if (isolation.inSubmodule) {
       throw new Error(
         '当前目录在 git submodule 内，SillySpec worktree 不支持在 submodule 中创建。' +
-        '\n请在主仓库中执行，或使用 --no-worktree 跳过隔离。'
+        '\n请在主仓库根目录执行 execute。'
       );
     }
     if (isolation.inWorktree) {
@@ -237,6 +248,10 @@ export class WorktreeManager {
       if (!this.getMeta(name)) {
         console.log(`⚠️  检测到幽灵 worktree 目录（无 meta.json），自动清理...`);
         try { rmSync(worktreePath, { recursive: true, force: true }); } catch {}
+        // 同步清理 git worktree 注册 + 残留分支，否则目录虽删但 git 内部状态未清，
+        // 后续 git worktree add 会因「worktree 已注册」或「分支已存在」失败
+        try { gitQuiet(this.cwd, 'worktree prune'); } catch {}
+        try { gitQuiet(this.cwd, `branch -D ${branch}`); } catch {}
       } else {
         throw new Error(`worktree already exists: ${name}. Run cleanup first.`);
       }
@@ -269,7 +284,7 @@ export class WorktreeManager {
     } catch (e) {
       const check = isGitWorktreeSupported(this.cwd);
       if (!check.supported) {
-        throw new Error(`git worktree add 失败: ${e.stderr || e.message}\n\n${check.reason ? `原因: ${check.reason}` : ''}\n建议: 使用 --no-worktree 标志跳过隔离，或升级 git 到 >= 2.15`);
+        throw new Error(`git worktree add 失败: ${e.stderr || e.message}\n\n${check.reason ? `原因: ${check.reason}` : ''}\n建议: 升级 git 到 >= 2.15；或运行 \`sillyspec worktree doctor --fix\` 检查 worktree 状态。`);
       }
       // sandbox/permission fallback: 降级为 in-place + baseline protection
       console.log(`⚠️  git worktree add 失败（可能是沙箱权限限制），降级为 in-place 模式 + baseline protection`);
@@ -546,7 +561,10 @@ export class WorktreeManager {
    * 三重清理：git worktree 注册 + worktree 目录 + meta 目录。
    * @param {string} changeName
    * @param {{ force?: boolean, maxRetries?: number }} opts
-   * @returns {{ result: 'cleaned'|'force-cleaned'|'skipped'|'kept', mode: string|null, details: string[] }}
+   * @returns {{ result: 'cleaned'|'force-cleaned'|'skipped'|'kept'|'partial', mode: string|null, details: string[], residual: string[] }}
+   *   result 取值：cleaned=git remove 成功；force-cleaned=git remove 失败但 fallback 清理完成；
+   *   partial=有残留（目录/meta/git 注册未清）；skipped=无需清理；kept=native-worktree 保留。
+   *   residual：未清干净的路径/引用列表（空数组表示干净）。
    */
   cleanup(changeName, { force = false, maxRetries = 3 } = {}) {
     const name = validateChangeName(changeName);
@@ -561,22 +579,20 @@ export class WorktreeManager {
     }
 
     const mode = meta?.mode || 'worktree';
+    // in-place 模式：worktreePath === 主工作区，绝对禁止删除目录本身，但 meta 目录仍应清理
+    // （否则永久残留）。native-worktree：外部隔离环境，整体跳过。
+    const isInPlace = mode === 'in-place-fallback';
 
-    // 安全检查：只有 SillySpec 创建的 worktree 才允许删除
-    if (!force) {
-      if (mode === 'native-worktree') {
-        return { result: 'kept', mode, details: ['native-worktree: 外部隔离环境，跳过清理'] };
-      }
-      if (mode === 'in-place-fallback') {
-        return { result: 'skipped', mode, details: ['in-place-fallback: 无隔离目录，跳过清理'] };
-      }
+    // 安全检查：native-worktree 是外部隔离环境，非 force 不碰
+    if (!force && mode === 'native-worktree') {
+      return { result: 'kept', mode, details: ['native-worktree: 外部隔离环境，跳过清理'], residual: [] };
     }
 
     const branch = (meta && meta.branch) || BRANCH_PREFIX + name;
 
-    // 1. git worktree remove（带 retry）
+    // 1. git worktree remove（带 retry）—— in-place 跳过：无 git worktree 注册，且 worktreePath 即主工作区
     let gitRemoveOk = false;
-    if (existsSync(worktreePath)) {
+    if (!isInPlace && existsSync(worktreePath)) {
       for (let attempt = 1; attempt <= maxRetries; attempt++) {
         try {
           git(this.cwd, `worktree remove ${worktreePath} --force`);
@@ -586,15 +602,15 @@ export class WorktreeManager {
         } catch (e) {
           details.push(`git worktree remove attempt ${attempt}/${maxRetries} failed: ${e.message}`);
           if (attempt < maxRetries) {
-            // 短暂等待后重试
-            execSync('sleep 0.5', { stdio: 'pipe' });
+            // 短暂等待后重试（跨平台 busy-wait，见 sleepMs）
+            sleepMs(500);
           }
         }
       }
     }
 
-    // 2. fallback: 确保 worktree 目录已删除
-    if (existsSync(worktreePath)) {
+    // 2. fallback: 确保 worktree 目录已删除（in-place 跳过——worktreePath 是主工作区）
+    if (!isInPlace && existsSync(worktreePath)) {
       try {
         rmSync(worktreePath, { recursive: true, force: true });
         details.push('worktree directory force-removed (fallback)');
@@ -618,7 +634,7 @@ export class WorktreeManager {
       // 分支可能已被删除，幂等跳过
     }
 
-    // 5. 清除 meta 目录
+    // 5. 清除 meta 目录（in-place 模式也执行——这是 in-place meta 残留的修复点）
     if (existsSync(metaDir)) {
       try {
         rmSync(metaDir, { recursive: true, force: true });
@@ -628,18 +644,27 @@ export class WorktreeManager {
       }
     }
 
-    // 6. 最终验证：确认三重清理完成
+    // 6. 最终验证：确认清理完成（in-place 模式 worktreePath=主工作区，不纳入残留检查）
     const residual = [];
-    if (existsSync(worktreePath)) residual.push(`worktree dir: ${worktreePath}`);
+    if (!isInPlace && existsSync(worktreePath)) residual.push(`worktree dir: ${worktreePath}`);
     if (existsSync(metaDir)) residual.push(`meta dir: ${metaDir}`);
-    if (gitQuiet(this.cwd, `worktree list`)?.includes(worktreePath)) {
+    if (!isInPlace && gitQuiet(this.cwd, `worktree list`)?.includes(worktreePath)) {
       residual.push('git worktree list still references this worktree');
     }
     if (residual.length > 0) {
       details.push(`⚠️ 残留: ${residual.join('; ')}`);
     }
 
-    return { result: gitRemoveOk ? 'cleaned' : 'force-cleaned', mode, details };
+    // result：有残留→partial；in-place（无隔离目录可删，只清了 meta）→cleaned；否则按 git remove 成败
+    let result;
+    if (residual.length > 0) {
+      result = 'partial';
+    } else if (isInPlace) {
+      result = 'cleaned';
+    } else {
+      result = gitRemoveOk ? 'cleaned' : 'force-cleaned';
+    }
+    return { result, mode, details, residual };
   }
 
   /**
@@ -680,8 +705,10 @@ export class WorktreeManager {
       for (const entry of entries) {
         const lines = entry.split('\n');
         const wtPath = lines.find(l => l.startsWith('worktree '))?.replace('worktree ', '');
+        // git 2.20+ porcelain 在目录缺失时输出 `missing` 行；作为 existsSync 的权威交叉验证
+        const missing = lines.some(l => l === 'missing');
         if (wtPath && wtPath !== this.cwd) { // 排除主工作区
-          gitWorktreeList.push({ path: wtPath, raw: entry });
+          gitWorktreeList.push({ path: wtPath, missing, raw: entry });
         }
       }
     } catch {
@@ -693,12 +720,25 @@ export class WorktreeManager {
     const metaNames = new Set(metaEntries.map(m => m.changeName));
 
     // 3. 检查 git worktree list 中的孤儿条目
+    // ⚠️ 只在 git 自己标记 missing 时自动 prune。目录不可见但 git 未标记 missing 的
+    // 情况（平台模式/容器路径不一致、符号链接、Windows 路径格式、旧 git 无 missing 标记）
+    // 只告警不自动 prune —— existsSync 在这些场景会误判，自动 prune 会杀死实际在用的
+    // worktree（sillyspec-worktree-platform-mode-bug）。git 内部状态是 worktree 生命周期的
+    // 权威来源，用它做 prune 前提可杜绝误杀。
     for (const wt of gitWorktreeList) {
       if (!existsSync(wt.path)) {
         const name = this._pathToChangeName(wt.path);
-        issues.push({ type: 'orphan-git-entry', name: name || wt.path, detail: `git worktree 引用存在但目录不存在: ${wt.path}`, fixable: true });
-        if (fix) {
-          try { gitQuiet(this.cwd, 'worktree prune'); fixed.push(`pruned orphan: ${wt.path}`); } catch { unfixable.push(`prune failed for: ${wt.path}`); }
+        if (wt.missing === true) {
+          // git 明确标记目录缺失（git 2.20+）→ 真 orphan，prune 安全
+          issues.push({ type: 'orphan-git-entry', name: name || wt.path, detail: `git worktree 标记 missing: ${wt.path}`, fixable: true });
+          if (fix) {
+            try { gitQuiet(this.cwd, 'worktree prune'); fixed.push(`pruned orphan: ${wt.path}`); } catch { unfixable.push(`prune failed for: ${wt.path}`); }
+          }
+        } else {
+          // 目录不可见但 git 未标记 missing → 可能 existsSync 误判，保守不自动 prune
+          issues.push({ type: 'orphan-git-entry', name: name || wt.path,
+            detail: `git worktree 引用 ${wt.path} 目录不可见但 git 未标记 missing——可能路径/权限导致误判，未自动 prune（避免误杀在用的 worktree）。确认废弃后手动: git worktree prune`,
+            fixable: false });
         }
       }
     }
@@ -761,9 +801,10 @@ export class WorktreeManager {
         if (meta && meta.createdAt) {
           const ageMs = Date.now() - new Date(meta.createdAt).getTime();
           const ageHours = ageMs / (1000 * 60 * 60);
+          const staleFixable = meta.mode !== 'native-worktree';
           if (ageHours > staleHours) {
-            issues.push({ type: 'stale', name, detail: `worktree 已存在 ${Math.round(ageHours)} 小时（超过 ${staleHours}h 阈值）`, fixable: true });
-            if (fix && meta.mode !== 'native-worktree') {
+            issues.push({ type: 'stale', name, detail: `worktree 已存在 ${Math.round(ageHours)} 小时（超过 ${staleHours}h 阈值）${staleFixable ? '' : '（native-worktree 外部环境，不可自动清理）'}`, fixable: staleFixable });
+            if (fix && staleFixable) {
               try {
                 const result = this.cleanup(name);
                 if (result.result === 'cleaned' || result.result === 'force-cleaned') {

package/test/decision-ref-version.mjs

@@ -0,0 +1,85 @@
+/**
+ * 回归：decision 引用校验不应因「版本号有无 / 大小写」误报
+ *
+ * 现象：prompt 让用 D-xxx@v1，但 design/requirements 里常裸号引用 D-xxx。
+ *       旧校验器用 targetContent.includes("D-xxx@V1") 字面匹配 → 批量误报。
+ *       另：强制 decision 在 design+requirements+tasks 三处都引用，tasks 骨架不自然。
+ *
+ * 修 A：warnMissingIds 剥 @vN 后缀，按基号词边界匹配（裸号 D-001 视为引用 D-001@V1）。
+ * 修 B：brainstorm 阶段不再强制 requirements.md / tasks.md 引用每个 decision（decision 天然落点在 design）。
+ */
+import { runValidators } from '../src/stage-contract.js'
+import { mkdirSync, writeFileSync, rmSync } from 'fs'
+import { join } from 'path'
+import os from 'os'
+
+let failed = 0
+const fail = m => { failed++; console.log(`  ❌ FAIL: ${m}`) }
+const pass = m => console.log(`  ✅ PASS: ${m}`)
+
+function setup() {
+  const tmp = join(os.tmpdir(), `ss-ref-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`)
+  const cd = join(tmp, '.sillyspec', 'changes', 'tc')
+  mkdirSync(cd, { recursive: true })
+  return { tmp, cd }
+}
+
+console.log('=== decision 引用校验：版本号 / 裸号 / 三文件放宽 ===\n')
+
+{
+  const { tmp, cd } = setup()
+  // decisions：小写 @v1（测大小写不敏感）+ 一条 supersede 链
+  writeFileSync(join(cd, 'decisions.md'), [
+    '# Decisions', '',
+    '## D-001@v1: 决策一', 'status: accepted', 'priority: P2', '',
+    '## D-002@v1: 决策二', 'status: accepted', 'priority: P2', '',
+    '## D-003@v1: 旧', 'status: superseded', 'supersedes: ', '',
+    '## D-003@v2: 新', 'status: accepted', 'supersedes: D-003@v1', '',
+  ].join('\n'))
+  // design：裸号引用 D-001（小写原文）；不引用 D-002（真实缺口）；D-003@v2 裸号 D-003
+  writeFileSync(join(cd, 'design.md'), [
+    '# Design', '',
+    '## 文件变更清单', '- src/a.js 覆盖 D-001', '- src/b.py 涉及 D-003', '',
+    '## 风险登记', '- 风险', '',
+    '## 自审', '- 已审', '',
+  ].join('\n'))
+  writeFileSync(join(cd, 'proposal.md'), '# P\n\n## 不在范围内\n- x\n')
+  writeFileSync(join(cd, 'requirements.md'), '# Req\n\n- FR-01: 功能\n')
+  // tasks：骨架，不引用任何 decision
+  writeFileSync(join(cd, 'tasks.md'), '# Tasks\n\n## W1\n- [ ] （待 plan 展开）\n')
+
+  const r = runValidators('brainstorm', tmp, 'tc', {})
+  const ref = r.warnings.filter(w => w.includes('未引用'))
+  console.log('  产出未引用警告：')
+  for (const w of ref) console.log(`     - ${w}`)
+
+  // 修 A：裸号 D-001（小写）应被识别，design 不报 D-001
+  if (ref.some(w => w.includes('design.md') && w.includes('D-001'))) {
+    fail('design 裸号 D-001（小写）仍被报 —— 修A 未生效（版本号/大小写）')
+  } else pass('design 裸号 D-001 被识别（修A：剥版本号 + 大小写不敏感）')
+
+  // 修 A：D-003 裸号应匹配 active 的 D-003@V2（V1 被 supersede 排除）
+  if (ref.some(w => w.includes('design.md') && w.includes('D-003'))) {
+    fail('design 裸号 D-003 未匹配到 active D-003@V2')
+  } else pass('design 裸号 D-003 匹配 active D-003@V2（supersede 链正确）')
+
+  // 真实缺口保留：design 确实没引用 D-002
+  if (ref.some(w => w.includes('design.md') && w.includes('D-002'))) {
+    pass('design 未引用 D-002 正确报警（真实缺口保留）')
+  } else fail('design D-002 缺口未报警 —— 校验器被改得过松')
+
+  // 修 B：requirements / tasks 不再被强制引用每个 decision
+  if (ref.some(w => w.includes('requirements.md'))) {
+    fail('requirements 仍被强制引用 decision —— 修B 未生效')
+  } else pass('requirements 不再强制引用 decision（修B）')
+  if (ref.some(w => w.includes('tasks.md'))) {
+    fail('tasks 骨架仍被强制引用 decision —— 修B 未生效')
+  } else pass('tasks 骨架不再强制引用 decision（修B）')
+
+  rmSync(tmp, { recursive: true, force: true })
+}
+
+console.log('\n' + '='.repeat(50))
+console.log(failed === 0 ? '✅ 全部通过' : `❌ 失败 ${failed}`)
+console.log('='.repeat(50))
+if (failed > 0) process.exit(1)

package/test/platform-scan-p0.test.mjs

@@ -140,21 +140,32 @@ function assert(label, condition, detail) {
 
 // ── 测试 6：quick step 1 prompt 强制要求 quicklog ──
 {
-  const { definition } = await import('../src/stages/quick.js')
-  const step1Prompt = definition.steps[0].prompt
-  const step3Prompt = definition.steps[2].prompt
+  const { definition } = await import('../src/stages/quick.js')
+  const step1Prompt = definition.steps[0].prompt
+  const step3Prompt = definition.steps[2].prompt
 
   assert('quick step 1 包含 ⛔ 标记', step1Prompt.includes('⛔'))
   assert('quick step 1 包含「不能跳过」', step1Prompt.includes('不能跳过'))
-  assert('quick step 1 包含 quicklog 未创建 warning', step1Prompt.includes('quicklog 未创建'))
-  assert('quick step 1 输出要求 quicklog 第一行', step1Prompt.includes('第一行确认'))
-  assert('quick step 3 禁止 git add -A', step3Prompt.includes('禁止使用 `git add -A`'))
-  assert('quick step 3 使用 scoped git add', step3Prompt.includes('git add -- <file...>'))
+  assert('quick step 1 包含 quicklog 未创建 warning', step1Prompt.includes('quicklog 未创建'))
+  assert('quick step 1 输出要求 quicklog 第一行', step1Prompt.includes('第一行确认'))
+  assert('quick step 3 禁止 git add -A', step3Prompt.includes('禁止使用 `git add -A`'))
+  assert('quick step 3 使用 scoped git add', step3Prompt.includes('git add -- <file...>'))
+
+  // 新语义：QUICKLOG 始终记录 + 多变更关联
+  assert('quick step 1 含 <linked-changes> 占位符', step1Prompt.includes('<linked-changes>'))
+  assert('quick step 1 含「关联变更」措辞', step1Prompt.includes('关联变更'))
+  assert('quick step 1 QUICKLOG 始终创建', step1Prompt.includes('始终创建 QUICKLOG'))
+  assert('quick step 3 QUICKLOG 始终更新', step3Prompt.includes('始终做'))
 
   // run.js 审计包含 quicklog 检查
   const runSrc = await readFile(join(__dirname, '..', 'src', 'run.js'), 'utf8')
   assert('quick 审计检查 quicklog 目录存在', runSrc.includes('quicklog 目录不存在'))
   assert('quick 审计检查 quicklog 为空', runSrc.includes('quicklog 目录为空'))
+
+  // run.js 多变更交互入口 + 推荐打分
+  assert('run.js 含 resolveQuickLinkedChanges 交互入口', runSrc.includes('resolveQuickLinkedChanges'))
+  assert('run.js 含 recommendChanges 推荐打分', runSrc.includes('recommendChanges'))
+  assert('run.js 含 <linked-changes> 占位符注入', runSrc.includes('<linked-changes>'))
 }
 
 // ── 结果 ──