sillyspec 3.28.3 → 3.28.5

package/src/worktree-apply.js

@@ -90,6 +90,61 @@ export function filterDeliverableFiles(files) {
  *   excludedCount: number    // EXCLUDE-DIRTY + EXCLUDE-MISMATCH 数
  * }}
  */
+
+/**
+ * EXCLUDE-DIRTY 重叠文件的自动三方合并（坑 apply-dirty-block-no-merge，2026-09-10 驾驭
+ * 小结第六批③，用户实证 daemon.ts 需手工 patch 合并——三仓并发活跃时 cp 清单不可用）。
+ *
+ * 语义：对每个 dirty∩changed 重叠文件做 git merge-file 三方合并——base = apply 锚点
+ * （baseHash）版本、ours = 主仓当前脏版本（并行会话在途）、theirs = worktree 版本（本变更
+ * 交付）。**clean 合并才写回主仓**（两侧改动都保留），该文件视为已应用、由调用方从 patch
+ * 集剔除；冲突文件不写回、维持原拦截 + rescue 出口（绝不留半合并现场）。审计：
+ * mergedDirtyFiles 逐文件留痕 + 每文件一行日志。
+ *
+ * fail-soft：base 版本取不到（文件在锚点不存在 = 全新文件）/ merge-file 不可用 → 计入
+ * conflicts 列表走原拦截路径，不阻断 apply 主流程。
+ *
+ * @param {{ projectRoot: string, worktreePath: string, baseHash: string }} ctx
+ * @param {string[]} overlapFiles 重叠文件（仓库根相对路径）
+ * @returns {{ merged: string[], conflicts: string[] }}
+ */
+export function mergeDirtyOverlapThreeWay({ projectRoot, worktreePath, baseHash }, overlapFiles) {
+  const merged = []
+  const conflicts = []
+  const tmpDir = mkdtempSync(join(tmpdir(), 'sillyspec-3way-'))
+  try {
+    for (const f of overlapFiles) {
+      try {
+        const baseRaw = git(projectRoot, ['show', `${baseHash}:${f}`], { encoding: 'buffer', timeout: 15000 })
+        const wtRaw = readFileSync(join(worktreePath, f))
+        const mainRaw = readFileSync(join(projectRoot, f))
+        const p = (tag) => join(tmpDir, `${tag}-${Math.random().toString(36).slice(2, 8)}`)
+        const baseP = p('base'); const oursP = p('ours'); const theirsP = p('theirs')
+        writeFileSync(baseP, baseRaw); writeFileSync(oursP, mainRaw); writeFileSync(theirsP, wtRaw)
+        // merge-file <current=ours> <base> <other=theirs> -p：stdout=合并结果；exit 0=clean，>0=冲突数
+        let outBuf, code = 0
+        try {
+          outBuf = git(projectRoot, ['merge-file', '-p', oursP, baseP, theirsP], { encoding: 'buffer', timeout: 15000 })
+        } catch (e) {
+          code = (typeof e.status === 'number') ? e.status : -1
+          outBuf = (e.stdout instanceof Buffer) ? e.stdout : Buffer.alloc(0)
+          if (code < 0) { conflicts.push(f); continue } // merge-file 本身不可用 → 原拦截
+        }
+        if (code === 0) {
+          writeFileSync(join(projectRoot, f), outBuf)
+          merged.push(f)
+          console.log(`🔀 EXCLUDE-DIRTY 三方合并成功（clean）: ${f}——主仓在途改动与 worktree 交付均已保留`)
+        } else {
+          conflicts.push(f)
+        }
+      } catch { conflicts.push(f) }
+    }
+  } finally {
+    try { rmSync(tmpDir, { recursive: true, force: true }) } catch {}
+  }
+  return { merged, conflicts }
+}
+
 export function generateRescueCommands({ changedFiles, dirtyFiles, hashMismatchFiles, deletedFiles = [], worktreePath, projectRoot }) {
   // 集合归一：dirtyFiles 接受 Set 或数组（调用方 step4.5/5a 可能传任一形态），其余统一数组→Set
   const dirtySet = dirtyFiles instanceof Set ? dirtyFiles : new Set(dirtyFiles || []);
@@ -217,23 +272,37 @@ function getBlobHashMap(cwd, treeish, files) {
  * 跨仓文件不在主仓 worktree 故永不进 diff）；跨仓 task 走 no-op（D-009），其 allowed_paths 仅
  * 作 Map 切片返回，供上游（assess / 跨仓 review 校验）按 repo 取用。
  *
+ * **specBase 解析（2026-09-08 用户反馈：平台模式 apply allowlist 读本地空目录整批 BLOCKED）**：
+ * 优先级 opts.specBase（调用方传 platformOpts.specRoot）> 平台指针（.sillyspec-platform.json
+ * 静默读，不触发 resolvePlatformSpecDir 的守卫 warn）> 本地 projectRoot/.sillyspec。平台模式下
+ * changes/ 实体在 specRoot，本地目录常为空——旧硬编码 CHANGES_REL 恒读空 → allow 集恒空 →
+ * Gate1 整批误拦（sync.js BUG-01 同族）。
+ *
  * @param {string} projectRoot - 主仓库根
  * @param {string} changeName - 变更名
+ * @param {{ specBase?: string }} [opts] specBase 显式传入（平台模式必传 specRoot）
  * @returns {Map<string, Set<string>>} repoKey → 并集清单 Set（无 design 清单且无 task 卡片时为空 Map）
  */
-export function resolveApplyAllowSet(projectRoot, changeName) {
+export function resolveApplyAllowSet(projectRoot, changeName, opts = {}) {
   const repoMap = new Map();
   const getOrCreate = (key) => {
     if (!repoMap.has(key)) repoMap.set(key, new Set());
     return repoMap.get(key);
   };
-  // design §6 清单归属 main（清单路径相对主仓根；跨仓 task 的 allowed_paths 由 task 卡片 repo 切片）
+  const specBase = opts.specBase || _silentPointerSpecRoot(projectRoot) || join(projectRoot, '.sillyspec');
+  // 变更目录读侧归档回退（坑 apply-archived-evidence-recycled，2026-09-10 驾驭小结第二批①）：
+  // archive 收尾对「未 apply 的 worktree」有意保留并期待归档后补 apply，但归档同时把变更目录
+  // rename 到 changes/archive/<name>/ ——旧读侧只认活跃路径，归档后补 apply 时 design/tasks
+  // 全部失联，allow 集恒空 → Gate1 整批误拦「不在清单」。活跃目录缺 design.md 而（且）归档
+  // 目录在 → 回退读归档版（取证自愈，不改归档回收策略）。
+  const changeDir = resolveActiveOrArchiveChangeDir(specBase, changeName);
+  // design §6 清单归属 main（清单路径相对主仓根；跨仓 task 的 allowed_paths 由 task 卡 repo 切片）
   const mainSet = getOrCreate('main');
   parseFileChangeList(
-    join(projectRoot, CHANGES_REL, changeName, 'design.md'),
+    join(changeDir, 'design.md'),
     { keepSillyspecDocs: true }
   ).forEach(p => mainSet.add(p));
-  const tasksDir = join(projectRoot, CHANGES_REL, changeName, 'tasks');
+  const tasksDir = join(changeDir, 'tasks');
   if (existsSync(tasksDir)) {
     for (const tf of readdirSync(tasksDir).filter(f => /^task-\d+\.md$/.test(f))) {
       const content = readFileSync(join(tasksDir, tf), 'utf8');
@@ -246,6 +315,36 @@ export function resolveApplyAllowSet(projectRoot, changeName) {
   return repoMap;
 }
 
+/**
+ * 变更文档目录读侧解析：活跃 changes/<name> 优先；活跃目录缺 design.md 而归档
+ * changes/archive/<name>/design.md 存在 → 返回归档目录（apply 校验在「归档后补 apply」
+ * 场景仍能取到 design/tasks 取证，坑 apply-archived-evidence-recycled）。两处皆缺返回
+ * 活跃路径原样（调用方 existsSync 自行降级，行为与旧版一致）。行为经 resolveApplyAllowSet
+ * 直测（apply-archive-docs-fallback.test.mjs）覆盖。
+ * @param {string} specBase
+ * @param {string} changeName
+ * @returns {string} 变更目录路径（活跃或归档）
+ */
+function resolveActiveOrArchiveChangeDir(specBase, changeName) {
+  const active = join(specBase, 'changes', changeName);
+  if (existsSync(join(active, 'design.md'))) return active;
+  const archived = join(specBase, 'changes', 'archive', changeName);
+  if (existsSync(join(archived, 'design.md'))) return archived;
+  return active;
+}
+
+// 平台指针静默读（worktree-apply 内部用）：只读 <projectRoot>/.sillyspec-platform.json 的
+// specRoot 字段，不做存在性/自指/temp 守卫、不打 warn——allowlist 只需一个「读得到就用」的
+// 基准目录，坏指针/缺字段落回本地（与 sync-noise.js bindSyncNoiseFromCwd 同款零副作用风格）。
+function _silentPointerSpecRoot(projectRoot) {
+  try {
+    const p = join(projectRoot, '.sillyspec-platform.json');
+    if (!existsSync(p)) return null;
+    const s = JSON.parse(readFileSync(p, 'utf8').replace(/^\uFEFF/, ''));
+    return s && typeof s.specRoot === 'string' && s.specRoot ? s.specRoot : null;
+  } catch { return null; }
+}
+
 /**
  * 收集最新 execute run 各 task review.json 的 changedFiles 声明 → Map<repoKey, string[]>。
  *
@@ -257,14 +356,23 @@ export function resolveApplyAllowSet(projectRoot, changeName) {
  * collectExecuteChangedFiles 一致：change 戳归属 run、.sillyspec//meta.json 过滤、
  * review.repo 切片（跨仓声明不进 main 集）。读不到 run/review → 空 Map（fail-closed 回退旧行为）。
  *
+ * runtimeRoot 解析（2026-09-08 平台模式修复，与 resolveApplyAllowSet 的 specBase 同族）：
+ * 优先级 opts.runtimeRoot（调用方传 resolveRuntimeRoot(platformOpts, specBase) 产物）>
+ * 指针 specRoot/.runtime（静默读）> 本地 projectRoot/.sillyspec/.runtime。平台模式
+ * execute-runs 在平台 runtime root，旧硬编码本地恒空 → 第三源恒缺失。
+ *
  * @param {string} projectRoot - 主仓库根
  * @param {string} changeName - 变更名
+ * @param {{ runtimeRoot?: string }} [opts]
  * @returns {Map<string, string[]>}
  */
-export function collectReviewDeclaredFiles(projectRoot, changeName) {
+export function collectReviewDeclaredFiles(projectRoot, changeName, opts = {}) {
   const byRepo = new Map();
   try {
-    const runtimeRoot = join(projectRoot, '.sillyspec', '.runtime');
+    const ptrSpec = _silentPointerSpecRoot(projectRoot);
+    const runtimeRoot = opts.runtimeRoot
+      || (ptrSpec ? join(ptrSpec, '.runtime') : null)
+      || join(projectRoot, '.sillyspec', '.runtime');
     const runId = resolveLatestExecuteRunIdWithTasks({ runtimeRoot, changeName });
     if (!runId) return byRepo;
     const runTasksDir = join(runtimeRoot, 'execute-runs', runId, 'tasks');
@@ -504,10 +612,11 @@ function applyCrossRepoWorktrees(changeName, projectRoot, ctx, { checkOnly = fal
       continue;
     }
 
-    // 清单校验（per-repo 切片 + review 声明切片并入，与主仓 Gate1/3b 同语义）
-    const allowMap = resolveApplyAllowSet(projectRoot, changeName);
+    // 清单校验（per-repo 切片 + review 声明切片并入，与主仓 Gate1/3b 同语义）。
+    // specBase 显式传（平台模式 changes/ 在 specRoot；本地模式与旧硬编码同值零回归）。
+    const allowMap = resolveApplyAllowSet(projectRoot, changeName, { specBase });
     let allowSet = allowMap.get(repoKey) || new Set();
-    const reviewDeclared = collectReviewDeclaredFiles(projectRoot, changeName).get(repoKey);
+    const reviewDeclared = collectReviewDeclaredFiles(projectRoot, changeName, { runtimeRoot: join(specBase, '.runtime') }).get(repoKey);
     if (reviewDeclared) {
       const merged = new Set([...allowSet]);
       for (const f of reviewDeclared) {
@@ -754,15 +863,21 @@ export function applyWorktree(changeName, { cwd, checkOnly = false, merge = fals
   }
 
   // --- 3. 解析 apply 文件清单（design §6 清单 ∪ plan TaskCard allowed_paths，execute 复盘 c） ---
+  // allowlist 基准目录（2026-09-08 平台模式修复）：ctx.platformOpts.specRoot 优先（execute
+  // ctx 透传），否则 resolveApplyAllowSet 内部静默读平台指针兜底，最后本地——旧硬编码在
+  // 平台模式读本地空 changes/ → allow 集恒空 → Gate1 整批误拦。
+  const allowSpecBase = (ctx && ctx.platformOpts && ctx.platformOpts.specRoot) || undefined;
+  const allowRuntimeRoot = (ctx && ctx.platformOpts && ctx.platformOpts.runtimeRoot)
+    || (allowSpecBase ? join(allowSpecBase, '.runtime') : undefined);
   // resolveApplyAllowSet 返回 Map<repo, Set>（task-05 跨仓切片）；主仓 apply 只消费 main 仓 Set
   // （主仓 worktree diff 只含主仓文件，跨仓文件在跨仓仓不进主仓 worktree diff）。跨仓 allowed_paths
   // 仅作 Map 切片返回供上游用，主流程不消费（跨仓 apply=no-op，D-009）。
-  const allowMap = resolveApplyAllowSet(projectRoot, changeName);
+  const allowMap = resolveApplyAllowSet(projectRoot, changeName, { specBase: allowSpecBase });
   // --- 3b. review.json 声明偏差文件并入（坑 apply-undeclared-deviation-block）---
   // 第三源：reviewer 声明的 changedFiles（已过 Task Review Gate git 证据交叉校验）——执行期
   // 有据越界（facade 转发/名单测试）不再逼回改 design.md。各 repo 切片各自并入；仅靠 review
   // 放行的文件记审计 warning（result.reviewAdmittedFiles），完全越界文件仍拦（Gate1 在扩展后判）。
-  const reviewDeclaredByRepo = collectReviewDeclaredFiles(projectRoot, changeName);
+  const reviewDeclaredByRepo = collectReviewDeclaredFiles(projectRoot, changeName, { runtimeRoot: allowRuntimeRoot });
   const reviewAdmittedFiles = [];
   for (const [repoKey, files] of reviewDeclaredByRepo) {
     const repoSet = allowMap.get(repoKey);
@@ -904,27 +1019,50 @@ export function applyWorktree(changeName, { cwd, checkOnly = false, merge = fals
         )].filter(f => !f.startsWith('.sillyspec/') && f !== 'meta.json');
         const overlapDirty = dirtyFiles.filter(f => changedFiles.includes(f));
         if (overlapDirty.length > 0) {
-          // --skip-overlap（坑 apply-overlap-all-or-nothing，2026-08-23 实证：多 agent 并发仓主仓
-          // 常态有在途变更，overlap 整批拦截使 apply 基本不可用，rescue 手动 cp 又留混合状态）：
-          // 显式 opt-in 剔除重叠文件、应用干净子集。重叠文件留在 worktree——step8 非 force
-          // cleanup 被 hasUnappliedChanges 护栏拦住（主仓工作区逐字节降噪层只剔除已应用文件），
-          // 待主仓干净后重新 apply（此时只剩剩余文件）或人工裁决。
-          if (skipOverlap && !checkOnly) {
-            const skipSet = new Set(overlapDirty);
-            result.skippedOverlapFiles = overlapDirty.slice();
+          // 自动三方合并（坑 apply-dirty-block-no-merge，2026-09-10 驾驭小结第六批③）：先对
+          // 重叠文件尝试 merge-file（base=锚点版 ours=主仓脏版 theirs=worktree 版），clean 合并
+          // 写回主仓、该文件视为已应用（从 patch 集剔除）；仅剩冲突文件才走原拦截+rescue 出口。
+          // checkOnly（assess 只读）不试合并——探查路径零写盘。
+          let conflictDirty = overlapDirty;
+          if (!checkOnly && deliverableBase && worktreePath && worktreePath !== projectRoot) {
+            try {
+              const m3 = mergeDirtyOverlapThreeWay({ projectRoot, worktreePath, baseHash: deliverableBase }, overlapDirty);
+              if (m3.merged.length > 0) {
+                result.mergedDirtyFiles = (result.mergedDirtyFiles || []).concat(m3.merged);
+                const mergedSet = new Set(m3.merged);
+                changedFiles = changedFiles.filter(f => !mergedSet.has(f));
+                result.changedFiles = changedFiles;
+                result.deletedFiles = deletedFiles.filter(f => !mergedSet.has(f));
+                result.hashMismatchFiles = (result.hashMismatchFiles || []).filter(f => !mergedSet.has(f));
+                conflictDirty = m3.conflicts;
+              } else {
+                conflictDirty = m3.conflicts.length > 0 ? m3.conflicts : overlapDirty;
+              }
+            } catch { conflictDirty = overlapDirty; /* 合并链路异常 → 原拦截 */ }
+          }
+          if (conflictDirty.length === 0) {
+            result.warnings = (result.warnings || []).concat([
+              `EXCLUDE-DIRTY 全部经三方合并消解（${overlapDirty.length} 个文件 clean 合并已写回，主仓在途改动与 worktree 交付均保留）——继续正常 apply 剩余文件`
+            ]);
+          } else if (skipOverlap && !checkOnly) {
+            // --skip-overlap（坑 apply-overlap-all-or-nothing，2026-08-23 实证）：剔除仍冲突的
+            // 重叠文件（三方合并已消解的不在此列）、应用干净子集。重叠文件留在 worktree——
+            // step8 非 force cleanup 被 hasUnappliedChanges 护栏拦住，待主仓干净后重新 apply 或人工裁决。
+            const skipSet = new Set(conflictDirty);
+            result.skippedOverlapFiles = conflictDirty.slice();
             changedFiles = changedFiles.filter(f => !skipSet.has(f));
             result.changedFiles = changedFiles;
             result.deletedFiles = deletedFiles.filter(f => !skipSet.has(f));
             result.hashMismatchFiles = (result.hashMismatchFiles || []).filter(f => !skipSet.has(f));
             if (changedFiles.length === 0) {
               result.errors.push(
-                `--skip-overlap：本次 ${overlapDirty.length} 个变更文件全部与主仓未提交改动重叠，无可应用子集：\n  ${overlapDirty.join('\n  ')}\n` +
+                `--skip-overlap：本次 ${conflictDirty.length} 个变更文件与主仓未提交改动重叠且无法自动三方合并，无可应用子集：\n  ${conflictDirty.join('\n  ')}\n` +
                 `请先提交/stash 主仓改动后重试（不带 --skip-overlap），或 sillyspec worktree apply ${changeName} --stash-dirty（工具内置 stash→apply→恢复，保暂存区状态，SHA 兜底可审计）。`
               );
               return result;
             }
             result.warnings = (result.warnings || []).concat([
-              `--skip-overlap：跳过 ${overlapDirty.length} 个与主仓未提交改动重叠的文件（留在 worktree，未应用）：${overlapDirty.join(', ')}——待主仓提交/stash 后重新 apply 只应用剩余文件，或确认放弃后 cleanup --force`
+              `--skip-overlap：跳过 ${conflictDirty.length} 个与主仓未提交改动重叠的文件（留在 worktree，未应用）：${conflictDirty.join(', ')}——待主仓提交/stash 后重新 apply 只应用剩余文件，或确认放弃后 cleanup --force`
             ]);
           } else {
           // 重叠拦截：只有与本次变更同文件的未提交改动才无法安全 apply（列重叠文件，非全部脏文件）
@@ -938,7 +1076,7 @@ export function applyWorktree(changeName, { cwd, checkOnly = false, merge = fals
             projectRoot,
           });
           result.errors.push(
-            `主工作区以下未提交文件与本次 apply 的变更重叠，git apply 无法安全应用：\n  ${overlapDirty.join('\n  ')}\n` +
+            `主工作区以下未提交文件与本次 apply 的变更重叠，自动三方合并后仍冲突，无法安全应用：\n  ${conflictDirty.join('\n  ')}\n` +
             `请先提交或暂存这些改动，再重新 apply：\n  git add -A && git commit -m "..."   或   git stash\n` +
             `或 sillyspec worktree apply ${changeName} --stash-dirty（工具内置 stash→apply→恢复，保暂存区状态，SHA 兜底可审计）\n` +
             `或应用非重叠部分（重叠文件留在 worktree，主仓干净后重新 apply 只补剩余）：\n  sillyspec worktree apply ${changeName} --skip-overlap\n` +
@@ -1693,13 +1831,18 @@ export function assessApplyRisk(changeName, { cwd } = {}) {
 
   // design §6 标记为「顺带修复」的文件（坑 worktree-execute-apply-friction 坑1）：合规修预存债，
   // 不属任何 task 边界，assess 豁免 allowed_paths 严格校验（降级 warning），避免被迫 cherry-pick 绕过。
-  const designPath = join(projectRoot, CHANGES_REL, changeName, 'design.md');
+  // specBase 走指针/本地解析（2026-09-08 平台模式修复，与 resolveApplyAllowSet 同族）。
+  // 归档回退（坑 apply-archived-evidence-recycled）：归档后补 apply 时变更目录已 rename，
+  // design/tasks 从 changes/archive/<name>/ 读（与 resolveApplyAllowSet 同口径）。
+  const assessSpecBase = _silentPointerSpecRoot(projectRoot) || join(projectRoot, '.sillyspec');
+  const assessChangeDir = resolveActiveOrArchiveChangeDir(assessSpecBase, changeName);
+  const designPath = join(assessChangeDir, 'design.md');
   const incidentalSet = new Set(
     parseFileChangeListDetailed(designPath).filter(e => e.incidental).map(e => e.path)
   );
   // review.json 声明偏差文件（坑 apply-undeclared-deviation-block）：与顺带修复同等待遇——
   // reviewer 声明（已过 git 证据校验）的执行期偏差豁免 allowed_paths 严格校验，降 warning 注明来源。
-  const reviewDeclaredSet = new Set(collectReviewDeclaredFiles(projectRoot, changeName).get('main') || []);
+  const reviewDeclaredSet = new Set(collectReviewDeclaredFiles(projectRoot, changeName, { runtimeRoot: join(assessSpecBase, '.runtime') }).get('main') || []);
 
   // 检查 2: 变更在 allowed_paths 内（仅在 TaskCard 存在时）；顺带修复/review 声明文件豁免。
   // 匹配换 pathMatches（与 Gate1/plan-postcheck 同语义容差），消除原字面前缀弱匹配漂移。

package/src/worktree.js

@@ -203,7 +203,11 @@ function printSyncReport(diag, baseHash, changeName) {
 }
 
 function parseJSON(raw) {
-  try { return JSON.parse(raw); } catch { return null; }
+  // BOM 容错（2026-09-08 用户反馈：meta.json 带 UTF-8 BOM 被当损坏 → apply 报
+  // 「meta.json 不存在或已损坏」、幽灵判定误清）：Windows 编辑器（记事本/部分 PowerShell
+  // 重定向）写 JSON 常带 \uFEFF 前缀，JSON.parse 对首字符 BOM 直接抛。剥掉再 parse。
+  const s = typeof raw === 'string' ? raw.replace(/^\uFEFF/, '') : raw
+  try { return JSON.parse(s); } catch { return null; }
 }
 
 /**

package/templates/agents-instruction.md

@@ -21,3 +21,4 @@
 15. **quicklog 结构化落盘**：末步 `--done` 用四参数 `--req/--cause/--solution/--result`（CLI 合成结构化 output 并自动提取标题/四段分行）；文件括注用 `--file-notes "path::注 || path2"`。骨架由 CLI 接管，`--done` 后按需核对即可，勿手拼模板。
 16. **代码可能随时在修改**（多 agent 并行），Edit 前重跑 + 查最新态；破坏性 git op 前先备份。
 17. **不奉承用户**，禁止"你说得对"类话术，直接给结论、依据、方案。
+18. **禁止目录级 git add / git add -A**（多会话共享仓）：.sillyspec/ 等目录里有并行会话的进行中文件与已提交文档，目录级暂存会夹带他者改动甚至误删已提交文件（2026-09-10 实证）。提交一律用显式 pathspec（git add -- 文件1 文件2），提交前 git status 核对暂存面只含本会话文件。