sillyspec 3.27.2 → 3.27.5

package/src/run/prompt.js

@@ -23,6 +23,7 @@ import { existsSync, readFileSync, mkdirSync, writeFileSync } from 'node:fs'
 import { stageRegistry } from '../stages/index.js'
 import { resolvePromptIncludes, resolveRuntimeRoot, safeGit, WAIT_MARKER_RE, QUICK_SID_RE } from './shared.js'
 import { renderStageContract } from '../stage-contract-spec.js'
+import { nowWallClock } from '../datetime.js'
 import { parseModuleMapSimple } from '../modules.js'
 import { REVIEW_SCHEMA_VERSION, isValidExecuteRunId } from '../task-review.js'
 
@@ -228,16 +229,18 @@ export async function outputStep(stageName, stepIndex, steps, cwd, changeName, d
       promptText = promptText.replace(/<git-user>/g, 'unknown')
     }
   }
-  // 替换时间戳占位符
+  // 替换时间戳占位符（本地墙钟统一走 nowWallClock——坑 taskcard-created-at-utc：人读字段用
+  // UTC 会偏一个时区，子代理手工改）
   const now = new Date()
-  const nowDatetime = now.getFullYear() + '-' + String(now.getMonth()+1).padStart(2,'0') + '-' + String(now.getDate()).padStart(2,'0') + ' ' + String(now.getHours()).padStart(2,'0') + ':' + String(now.getMinutes()).padStart(2,'0') + ':' + String(now.getSeconds()).padStart(2,'0')
+  const nowDatetime = nowWallClock(now)
   const nowTimestamp = now.getFullYear() + String(now.getMonth()+1).padStart(2,'0') + String(now.getDate()).padStart(2,'0') + '-' + String(now.getHours()).padStart(2,'0') + String(now.getMinutes()).padStart(2,'0') + String(now.getSeconds()).padStart(2,'0')
   const nowDate = now.getFullYear() + '-' + String(now.getMonth()+1).padStart(2,'0') + '-' + String(now.getDate()).padStart(2,'0')
   promptText = promptText.replace(/<now-datetime>/g, nowDatetime)
   promptText = promptText.replace(/<now-timestamp>/g, nowTimestamp)
   promptText = promptText.replace(/<now-date>/g, nowDate)
-  // <now-iso-datetime>（scan frontmatter updated_at 用；与 scan-fix-headers 同款秒级格式）
-  promptText = promptText.replace(/<now-iso-datetime>/g, now.toISOString().slice(0, 19).replace('T', ' '))
+  // <now-iso-datetime>（scan frontmatter updated_at 用；与 scan-fix-headers 同款秒级格式）。
+  // 占位符名带 iso 是历史遗留——值已统一为本地墙钟（同 <now-datetime>），改名会破坏 stages 引用。
+  promptText = promptText.replace(/<now-iso-datetime>/g, nowWallClock(now))
   // <git-head-short>（scan frontmatter source_commit 用；CLI 代查，agent 勿自跑 rev-parse）
   if (promptText.includes('<git-head-short>')) {
     let headShort = 'unknown'
@@ -423,6 +426,42 @@ export async function outputStep(stageName, stepIndex, steps, cwd, changeName, d
     }
   }
 
+  // 决策防复潮注入（W1.1 第 3 点，task-04，FR-05）：brainstorm「加载项目上下文」Step2 的
+  // {DECISION_HITS} → matchKnowledge decisionHits——命中 rejected 条目时渲染「否决决策提示」段
+  // （ID/标题/否决理由/复潮条件），无命中替换为空串零输出（不留残留占位符）；注入结果同步落
+  // runtime JSON（与 KNOWLEDGE_HIT_REPORT 的 json 落盘同口径）。advisory 展示，不改变步骤流程；
+  // 全降级不抛（异常 → 单行说明）。
+  if (stageName === 'brainstorm' && promptText.includes('{DECISION_HITS}')) {
+    try {
+      const { matchKnowledge } = await import('../knowledge-match.js')
+      const decSpecBase = resolvePromptSpecBase(platformOpts, cwd)
+      const decKnowledgeDir = join(decSpecBase, 'knowledge')
+      // taskContext：changeName（brainstorm Step2 时 tasks.md 尚未生成，变更名是唯一稳定任务
+      // 语料；与 execute 分支的 changeName 基底同口径）
+      const decResult = matchKnowledge(decKnowledgeDir, changeName || '')
+      const rejectedHits = (decResult.decisionHits || []).filter(h => h.status === 'rejected')
+      let decInjected = ''
+      if (rejectedHits.length > 0) {
+        const lines = [
+          '⚠️ 否决决策提示（历史已否决，防复潮）——下列决策此前已被否决。看到否决理由后，除非复潮条件明确满足，不要在本次方案中重新提出；若认为复潮条件已满足，须在本变更 decisions.md 记录新版本条目（D-xxx@vN+1）说明依据：'
+        ]
+        for (const h of rejectedHits) {
+          lines.push(`- ${h.id} ${h.title}（${h.file}）`)
+          lines.push(`  - 否决理由：${h.reason || '（未记录）'}`)
+          lines.push(`  - 复潮条件：${h.revisitWhen || '（未记录）'}`)
+        }
+        decInjected = '\n\n' + lines.join('\n')
+      }
+      promptText = promptText.replace(/\{DECISION_HITS\}/g, decInjected)
+      // 注入结果同步落 runtime JSON（与既有 KNOWLEDGE_HIT_REPORT 落盘口径一致）
+      const decRuntimeDir = join(decSpecBase, '.runtime')
+      mkdirSync(decRuntimeDir, { recursive: true })
+      writeFileSync(join(decRuntimeDir, 'decision-hits.json'), JSON.stringify({ matched: decResult.matched, decisionHits: decResult.decisionHits || [] }, null, 2) + '\n')
+    } catch (e) {
+      promptText = promptText.replace(/\{DECISION_HITS\}/g, `[decisions] 决策命中检测异常（${e.message}），跳过`)
+    }
+  }
+
   // Knowledge hit report: execute 阶段注入匹配结果
   if (stageName === 'execute' && promptText.includes('{KNOWLEDGE_HIT_REPORT}')) {
     try {
@@ -458,53 +497,29 @@ export async function outputStep(stageName, stepIndex, steps, cwd, changeName, d
   // docs-debt 模块文档欠账事实注入（2026-08-15 docs-debt-inject D-006，债单第六节"CLI 算事实"）：
   // Wave prompt {DOCS_DEBT} → computeDocsDebt（git diff × module-map）facts；空 facts 替换为空串
   // （无债零输出，无残留占位符）。changedFiles 口径（D-001/FR-007）：worktree 根
-  // （meta.json 所在）git status --porcelain + diff baselineCommit..HEAD 并集；无 worktree
-  // （in-place/非 execute worktree 场景）退 cwd。全降级不抛（异常 → 单行说明）。
+  // （meta.json 所在）git status --porcelain + diff baselineCommit..HEAD 并集——公共实现已抽至
+  // docs-debt.collectExecuteChangedFiles（execute.js Wave 步渲染点同源复用，勿双写）。
+  // 全降级不抛（异常 → 单行说明）。
   if (stageName === 'execute' && promptText.includes('{DOCS_DEBT}')) {
     try {
-      const { computeDocsDebt } = await import('../docs-debt.js')
       const debtSpecBase = resolvePromptSpecBase(platformOpts, cwd)
       const debtProjectName = dbProjectName || basename(cwd)
-      // worktree 根解析：changeName → <specBase>/.runtime/worktrees/<changeName>/ 存在即锚
-      let debtProjectRoot = cwd
-      const wtRoot = join(debtSpecBase, '.runtime', 'worktrees', changeName || '')
-      if (changeName && existsSync(wtRoot)) {
-        debtProjectRoot = wtRoot
-      }
-      // changedFiles：已提交（baseline..HEAD）∪ 未提交（status porcelain，非未跟踪）
-      const changed = new Set()
-      const { safeGit } = await import('../git-helper.js')
-      const statusRes = safeGit(debtProjectRoot, ['status', '--porcelain'], { trim: false })
-      if (!statusRes.error && statusRes.value) {
-        for (const line of statusRes.value.split('\n')) {
-          if (!line.trim()) continue
-          // "XY path" / rename "R  old -> new" 取 new
-          const pathPart = line.slice(3).split('->').pop().trim().replace(/"/g, '')
-          if (pathPart && !pathPart.startsWith('.sillyspec/')) changed.add(pathPart.replace(/\\/g, '/'))
-        }
-      }
-      const { readFileSync: rf } = await import('node:fs')
-      const metaPath = join(wtRoot, 'meta.json')
-      if (changeName && existsSync(metaPath)) {
-        try {
-          const meta = JSON.parse(rf(metaPath, 'utf8'))
-          if (meta.baselineCommit) {
-            const diffRes = safeGit(debtProjectRoot, ['diff', '--name-only', `${meta.baselineCommit}..HEAD`], { trim: false })
-            if (!diffRes.error && diffRes.value) {
-              for (const f of diffRes.value.split('\n')) {
-                if (f.trim() && !f.trim().startsWith('.sillyspec/')) changed.add(f.trim().replace(/\\/g, '/'))
-              }
-            }
-          }
-        } catch { /* meta 读失败只用未提交集 */ }
-      }
+      const { collectExecuteChangedFiles, computeDocsDebt, computeDecisionTouches, renderDecisionTouchFacts } = await import('../docs-debt.js')
+      const { root: debtProjectRoot, changedFiles } = collectExecuteChangedFiles({ specBase: debtSpecBase, changeName, cwd })
       const result = computeDocsDebt({
         projectRoot: debtProjectRoot,
         specBase: debtSpecBase,
         projectName: debtProjectName,
-        changedFiles: [...changed],
+        changedFiles,
       })
-      promptText = promptText.replace(/\{DOCS_DEBT\}/g, result.facts)
+      // 决策锚点触碰事实（2026-08-24-decision-touch-cli-drift task-01，W-A 次渲染点）：重入/reset
+      // 场景 changedFiles 非空时呈现。advisory 追加渲染分支——既有 docs-debt facts 逐字不变，
+      // 无触碰 render 返回 ''（零输出）；主渲染点在 execute.js buildWavePrompt（同源 facts 计算）。
+      let debtTouchFacts = ''
+      try {
+        debtTouchFacts = renderDecisionTouchFacts(computeDecisionTouches(changedFiles, join(debtSpecBase, 'knowledge')).touches)
+      } catch { /* 触碰计算降级为空——不影响欠账 facts 注入 */ }
+      promptText = promptText.replace(/\{DOCS_DEBT\}/g, [result.facts, debtTouchFacts].filter(Boolean).join('\n'))
     } catch (e) {
       promptText = promptText.replace(/\{DOCS_DEBT\}/g, `[docs-debt] 欠账计算异常（${e.message}），跳过`)
     }
@@ -677,6 +692,33 @@ export async function outputStep(stageName, stepIndex, steps, cwd, changeName, d
     promptText = promptText.split('{WORKTREE_BASELINE_INFO}').join(baselineInfo)
   }
 
+  // verify「运行测试和质量扫描」evidence-auto 推荐注入（task-12，FR-11 / D-005@v2）：
+  // verify-postcheck 在 --done 事后解析 evidence-auto，agent 写 verify-result.md 时看不到
+  // 推荐组合、无从否决——故在 prompt 时点经 {EVIDENCE_AUTO_RECOMMENDATION} 把 task-11
+  // resolveTestStrategy 的 evidence_auto_recommendation.summary 渲染进 step prompt（含推荐
+  // 理由、降级注记与「可在 verify-result.md 否决并改跑全量」路径），供用户否决（FR-11）。
+  // 仅 test_strategy=evidence-auto 且 recommendation 非空时渲染；full/module/skip/未配置
+  // （recommendation=null）替换为空串零输出。fail-soft：读取/解析异常降级单行说明不抛，
+  // 绝不阻断 verify prompt 输出（对齐上方 {WORKTREE_BASELINE_INFO} 注入先例）。
+  if (stageName === 'verify' && promptText.includes('{EVIDENCE_AUTO_RECOMMENDATION}')) {
+    let eaInjected = ''
+    try {
+      const { resolveTestStrategy } = await import('../verify-postcheck.js')
+      const eaSpecBase = resolvePromptSpecBase(platformOpts, cwd)
+      // 信任边界：local.yaml 只读 specBase（平台 specRoot / 漂移锚定主仓 / cwd 本地），与
+      // runVerifyTestCheck 的 specBase 来源同口径，不读 agent 可写的 worktree 副本。
+      const eaYamlPath = join(eaSpecBase, 'local.yaml')
+      const eaYamlText = existsSync(eaYamlPath) ? readFileSync(eaYamlPath, 'utf8') : null
+      const eaChangeDir = changeName ? join(eaSpecBase, 'changes', changeName) : null
+      const resolution = resolveTestStrategy({ yamlText: eaYamlText, changeDir: eaChangeDir })
+      const rec = resolution.evidence_auto_recommendation
+      if (rec && rec.summary) eaInjected = rec.summary
+    } catch (e) {
+      eaInjected = `（evidence-auto 推荐注入失败：${e.message}——请读 .sillyspec/local.yaml 确认 test_strategy；--done 时 CLI 仍会按 resolveTestStrategy 实测对账，推荐不可用时可显式设 test_strategy: full/module）`
+    }
+    promptText = promptText.split('{EVIDENCE_AUTO_RECOMMENDATION}').join(eaInjected)
+  }
+
   // 注入模块上下文（brainstorm/plan/execute 阶段，基于 Module Context Index）
   if (['brainstorm', 'plan', 'execute'].includes(stageName) && projectName) {
     const effectiveSpecBase = resolvePromptSpecBase(platformOpts, cwd)

package/src/run/quick-audit.js

@@ -68,6 +68,17 @@ export function printQuickAuditReview(review) {
     console.warn(`   它们归关联变更自己的流程管；若确系本会话需要改，用 --files 显式声明归属。`)
   }
 
+  // 他者会话声明豁免提示（坑 foreign-session-declared-false-block，独立于三态都打——放行可见
+  // 可审计，不静默，与上块同哲学）：多 agent 并发时并行 quick 会话 --files 已声明的文件在本会话
+  // 窗口内出现——不属本会话，已退栈归该会话审计，本会话无需 --force-baseline。
+  if (Array.isArray(review.foreignSessionDeclared) && review.foreignSessionDeclared.length > 0) {
+    console.warn(`
+🔗 ${review.foreignSessionDeclared.length} 个文件已由其他 active quick 会话声明——已剔除出本会话审计，归该会话边界管：`)
+    for (const x of review.foreignSessionDeclared) console.warn(`   - ${x.file} ← ${(x.sessions || []).join(', ')}`)
+    console.warn(`   并发下无需 --force-baseline：这些文件不属本会话。若确系本会话改动，恢复会话时 --files 追加声明归属（sillyspec run quick --files <file> --change <本会话ID>）；`)
+    console.warn(`   他者会话若为崩溃残留（超 7 天未收尾），sillyspec run quick --cancel --change <他者会话ID> 清理后声明即失效。`)
+  }
+
   // D-8 文档欠账显性化（advisory，独立于 status 三态都打）：改了源码没动文档 → 一行欠账标记。
   // 不阻断、不解锁、纯显性化——累积欠账可事后审计 QUICKLOG reasons 追溯。
   if (review.docSyncHint && review.docSyncHint.touchedSource > 0 && review.docSyncHint.docFiles.length === 0) {

package/src/run/shared.js

@@ -11,7 +11,7 @@
  *     本模块仅 re-export，run/ 层现有调用方路径与行为不变。
  */
 import { basename, join, resolve, dirname, sep } from 'node:path'
-import { existsSync, readdirSync, readFileSync, statSync, mkdirSync, writeFileSync, appendFileSync } from 'node:fs'
+import { existsSync, readdirSync, readFileSync, statSync, mkdirSync, writeFileSync, appendFileSync, realpathSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
 import os from 'node:os'
 
@@ -329,6 +329,55 @@ export function resolveQuickSessionsDir(platformOpts, localSpecBase) {
   return join(resolveRuntimeRoot(platformOpts, localSpecBase), 'quick-sessions')
 }
 
+// 他者会话声明豁免的僵尸阈值：超龄会话的声明不再作为豁免依据。与 doctor 幽灵清理
+// GHOST_EMPTY_DIR_STALE_MS 同口径（7 天）——正常并发会话间隔在分钟/小时级，7 天未收尾的
+// 会话按僵尸处理，防崩溃残留的 guard 永久「认领」文件侵蚀危险门。
+const FOREIGN_SESSION_STALE_MS = 7 * 24 * 60 * 60 * 1000
+
+/**
+ * 枚举其他 active quick 会话的显式文件声明（坑 foreign-session-declared-false-block）。
+ *
+ * 多 agent 并发时，并行 quick 会话在**本会话启动后**改的文件不在本会话 baseline →
+ * auditQuickCompletion 把它算进本会话窗口 → 命中危险清单（src/run/、package.json 等）或
+ * .sillyspec/ 判定即 blocked，只能 --force-baseline 无差别逃生。豁免口径 = 他者会话的
+ * **显式声明**（guard.allowedFiles，--files 传入）——他者的 baselineFiles 是「启动时已脏」
+ * 快照而非所有权声明，不作豁免依据（否则任何预存脏文件都能被洗白）。
+ *
+ * fail-open：目录不存在/损坏 guard.json/超龄僵尸/任何异常 → 跳过或整体返回 []，
+ * 采集失败回到无豁免现状（不放大豁免面）。
+ *
+ * @param {object} [platformOpts] 平台选项（resolveQuickSessionsDir 同参）
+ * @param {string} localSpecBase 本地 specBase（resolveQuickSessionsDir 同参）
+ * @param {string} currentSessionId 当前会话 sessionId（quick-<hex8>），枚举时排除
+ * @param {number} [nowMs] 当前时间戳（可注入，测试用）
+ * @returns {Array<{sessionId: string, files: string[]}>} 其他 active 会话的声明清单
+ */
+export function collectOtherQuickSessionDeclarations(platformOpts, localSpecBase, currentSessionId, nowMs = Date.now()) {
+  const out = []
+  try {
+    const sessionsDir = resolveQuickSessionsDir(platformOpts, localSpecBase)
+    let sessionDirs = []
+    try {
+      sessionDirs = readdirSync(sessionsDir, { withFileTypes: true }).filter(e => e.isDirectory()).map(e => e.name)
+    } catch { return out } // 目录不存在/不可读 → 无他者会话
+    for (const sessionName of sessionDirs) {
+      if (sessionName === currentSessionId) continue
+      const guardFile = join(sessionsDir, sessionName, 'guard.json')
+      let guard = null
+      try { guard = JSON.parse(readFileSync(guardFile, 'utf8')) } catch { continue } // 损坏/缺失跳过
+      // 僵尸防御：超龄会话（崩溃残留，--done/--cancel 都不会再走）的声明不再认领文件
+      if (guard.startedAt) {
+        const startedAtMs = Date.parse(guard.startedAt)
+        if (Number.isFinite(startedAtMs) && nowMs - startedAtMs > FOREIGN_SESSION_STALE_MS) continue
+      }
+      const files = (Array.isArray(guard.allowedFiles) ? guard.allowedFiles : []).filter(f => typeof f === 'string' && f)
+      if (files.length === 0) continue
+      out.push({ sessionId: guard.sessionId || sessionName, files })
+    }
+  } catch { /* fail-open：整体异常返回已采集部分 */ }
+  return out
+}
+
 /**
  * 平台指针三写（单一数据源，runCommand scan 与 cmdInit 平台模式共用）。
  *
@@ -355,6 +404,15 @@ export const PLATFORM_MANAGED_FILENAME = '.sillyspec-platform-managed'
 
 export function writePlatformPointer(cwd, platformOpts, extra = {}) {
   if (!platformOpts || (!platformOpts.specRoot && !platformOpts.runtimeRoot)) return false
+  // 自指写入拦截（FR-4，变更 2026-08-23-repo-native-spec-backfill）：specRoot 经 realpath
+  // 解析回本地 .sillyspec（repo-native junction 回环）时拒绝三写（主文件/指针/声明全不落盘）。
+  // 单点收口同时覆盖 runCommand 与 cmdInit(writeInitPlatformPointer) 两调用方——旧模板
+  // scan flag / init 平台模式显式传自指 specRoot 也不再重新投毒。runtimeRoot-only 组合
+  // 无 specRoot 可判（isSelfReferentialSpecRoot 对 null 恒 false），原语义不变。
+  if (isSelfReferentialSpecRoot(cwd, platformOpts.specRoot)) {
+    console.warn(`⚠️ 检测到自指平台指针（repo-native junction 回环，specRoot 指回本地 .sillyspec），已跳过指针写入并按本地模式运行: ${platformOpts.specRoot}`)
+    return false
+  }
   // HUB-05：合并保留既有生命周期字段。scan 完成时指针被写入 status/completedAt/scanStatus
   //（complete-handlers），但下一次任何平台模式 run（含只读 --status）都会重写指针——
   // 恢复链只回填 specRoot 等四字段，不保留 status → 指针永远回 active、isPointerStale
@@ -427,6 +485,48 @@ export function checkPlatformManaged(cwd) {
   }
 }
 
+/**
+ * 自指 specRoot 判定（repo-native junction 回环检测，变更 2026-08-23-repo-native-spec-backfill）。
+ *
+ * daemon repo-native 工作区把缓存目录（--spec-root 入参，~/.sillyhub/daemon/specs/{ws}）以
+ * junction/symlink 指回源项目 <cwd>/.sillyspec——该 specRoot 经 realpath 解析后与本地
+ * .sillyspec 同物理目录，属"自指回环"：不应让 CLI 进入平台模式（内置 sync / auto-pull
+ * 按本地模式语义运行，断链修复见 design.md Phase 2）。
+ *
+ * 双方 fs.realpathSync（native，junction/symlink 跨平台穿透）后严格相等 → true；
+ * specRoot 空 / 任一路径不存在 / realpath 抛错 → false（按外部目录处理，保守不干预）。
+ * 约束：cwd 必须为项目根（与指针查找 join(cwd,'.sillyspec-platform.json') 同基准）。
+ *
+ * @param {string} cwd - 项目根
+ * @param {string|null} [specRoot] - 平台 specRoot（可 null/undefined/空串）
+ * @returns {boolean} 是否自指回环
+ */
+export function isSelfReferentialSpecRoot(cwd, specRoot) {
+  if (!specRoot || typeof specRoot !== 'string') return false
+  try {
+    return realpathSync(specRoot) === realpathSync(join(cwd, '.sillyspec'))
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 平台模式判定单一数据源（自指免疫，变更 2026-08-23-repo-native-spec-backfill）。
+ *
+ * 语义：(specRoot || runtimeRoot) 存在且非自指 → 平台模式；自指回环（repo-native
+ * junction）按本地模式处理。本模块内平台模式门禁统一经本函数，裸表达式仅此一处
+ * （grep 验证：triggerSync/triggerPull/triggerPullActiveChange/checkApproval 四处收敛）。
+ * runtimeRoot 落在 specRoot 内，自指判定以 specRoot 为准即可覆盖；runtimeRoot-only
+ * 组合无 specRoot 可判，不触发自指豁免（保持平台模式）。
+ *
+ * @param {object} [platformOpts] - { specRoot?, runtimeRoot?, ... }（可 null/undefined）
+ * @param {string} cwd - 项目根（isSelfReferentialSpecRoot 同基准）
+ * @returns {boolean}
+ */
+export function isPlatformMode(platformOpts, cwd) {
+  return Boolean((platformOpts?.specRoot || platformOpts?.runtimeRoot) && !isSelfReferentialSpecRoot(cwd, platformOpts?.specRoot))
+}
+
 /**
  * 统一查找变更目录（与 progress.js 的变更检测逻辑一致）。
  */
@@ -483,8 +583,8 @@ async function raceWithAbort(op, timeoutMs = SYNC_TOTAL_TIMEOUT_MS) {
 export const QUICK_SID_RE = /^quick-[0-9a-f]{8}$/
 
 export async function triggerSync(cwd, changeName, platformOpts = {}, opts = {}) {
-  // 平台模式（SillyHub）走自己的回传链路，不走 CLI 内置 sync
-  if (platformOpts?.specRoot || platformOpts?.runtimeRoot) return
+  // 平台模式（SillyHub）走自己的回传链路，不走 CLI 内置 sync；自指回环（repo-native junction）按本地模式处理
+  if (isPlatformMode(platformOpts, cwd)) return
   try {
     // ql-20260818-011：quick 会话按设计无实体变更目录（progress.js initChange 同款
     // 跳过建目录），progress/四件套上行对它是孤儿数据；但 spec 树增量（QUICKLOG/
@@ -556,8 +656,8 @@ function _stampAutoPull(cwd) {
  * @param {object} [platformOpts] - 平台模式 opts（specRoot/runtimeRoot 存在则跳过，走平台自有链路）
  */
 export async function triggerPull(cwd, changeName, platformOpts = {}, opts = {}) {
-  // 平台模式（SillyHub）走自己的链路，跳过
-  if (platformOpts?.specRoot || platformOpts?.runtimeRoot) return
+  // 平台模式（SillyHub）走自己的链路，跳过；自指回环（repo-native junction）按本地模式处理
+  if (isPlatformMode(platformOpts, cwd)) return
   try {
     const syncMod = await import('../sync.js')
     const sm = new syncMod.SyncManager(cwd)
@@ -579,7 +679,8 @@ export async function triggerPull(cwd, changeName, platformOpts = {}, opts = {})
  * 供 index.js 在 stage 命令（run/--done/archive）与 approve 决策点注入一行调用。
  */
 export async function triggerPullActiveChange(cwd, platformOpts = {}) {
-  if (platformOpts?.specRoot || platformOpts?.runtimeRoot) return
+  // 平台模式走自己的链路，跳过；自指回环（repo-native junction）按本地模式处理
+  if (isPlatformMode(platformOpts, cwd)) return
   // 先检查是否连接平台：未连接直接 return，避免 _ensureDB 在无 local.yaml 的 cwd 创建空 DB 污染
   let sm = null
   try {
@@ -645,8 +746,8 @@ export function warnApprovalUnknown(cwd, changeName, reason) {
  * 平台模式走自己的链路，跳过；否则 await import sync.js。
  * @returns {{ status: string, reason?: string } | null}
  */export async function checkApproval(cwd, changeName, platformOpts = {}) {
-  // 平台模式不需要 CLI 内置审批检查
-  if (platformOpts?.specRoot || platformOpts?.runtimeRoot) return null
+  // 平台模式不需要 CLI 内置审批检查；自指回环（repo-native junction）按本地模式处理
+  if (isPlatformMode(platformOpts, cwd)) return null
   try {
     // shared.js 在 src/run/，sync.js 在 src/ → 退一层
     const syncMod = await import('../sync.js')
@@ -708,7 +809,7 @@ export function isQuickMetadata(p, linkedChanges = []) {
 
 /**
  * quick 完成审计：对比 baseline 与实际变更。
- * @returns {{ status: 'safe'|'warning'|'blocked', reasons: string[], changedFiles: string[], newFiles: string[], deletedFiles: string[], baselineHit: string[], stagedTotal: number, attributedFiles: string[], undeclaredFiles: string[] }}
+ * @returns {{ status: 'safe'|'warning'|'blocked', reasons: string[], changedFiles: string[], newFiles: string[], deletedFiles: string[], baselineHit: string[], stagedTotal: number, attributedFiles: string[], undeclaredFiles: string[], foreignSessionDeclared: Array<{file: string, sessions: string[]}> }}
  */
 /**
  * D-8 O-1 模块归属（2026-08-15 docs-signals-o12）：quick 欠账 hint 从"改了 N 文件"升级为
@@ -818,7 +919,7 @@ export async function auditQuickCompletion(cwd, guard, options = {}) {
   // stagedTotal：当前所有非 quick 元数据的未提交条目（含前序 baseline 残留）。
   // 与 changedFiles（扣 baseline 后的本轮新增）区分，供审计文案同时展示「本轮新增 vs 累计暂存」，
   // 避免叠加 quick 会话时把前序会话未提交文件误读为「本会话只动了 N 个」。
-  const result = { status: 'safe', reasons: [], changedFiles: [], newFiles: [], deletedFiles: [], baselineHit: [], stagedTotal: 0, attributedFiles: [], undeclaredFiles: [] }
+  const result = { status: 'safe', reasons: [], changedFiles: [], newFiles: [], deletedFiles: [], baselineHit: [], stagedTotal: 0, attributedFiles: [], undeclaredFiles: [], foreignSessionDeclared: [] }
 
   try {
     // safeGit 带 -c safe.directory，避免 linked worktree/容器异 uid/挂载点下裸 `git status` 抛错被
@@ -851,6 +952,38 @@ export async function auditQuickCompletion(cwd, guard, options = {}) {
       const f = normalizeGitPath(p)
       return baselineExact.has(f) || baselineDirs.some(d => f.startsWith(d))
     }
+    // 他者 active 会话声明索引（坑 foreign-session-declared-false-block，2026-08-23 实证：多 agent
+    // 并发时并行会话窗口内改的文件——尤其命中危险清单的（daemon/router.py 之于本仓是 src/run/*、
+    // package.json）或 .sillyspec/ 下的——不在本会话 baseline，被算进本会话窗口直接 blocked，
+    // 只能 --force-baseline 无差别逃生）。声明即归属的他向版本：他者会话显式声明（--files）的文件
+    // 退栈归该会话审计。本会话也声明同一文件（--files 重叠）时不退栈——同文件并发归本会话审计
+    // （sameFileHits advisory 管辖）。豁免面 = 他者显式声明，不含他者 baseline 快照（那是「启动时
+    // 已脏」非所有权声明，当豁免依据会洗白任何预存脏文件）。
+    const ownDeclaredNorm = new Set((allowedFiles || []).map(f => normalizeGitPath(f)))
+    const foreignDeclaredIndex = new Map()
+    for (const s of Array.isArray(guard.otherSessionsDeclared) ? guard.otherSessionsDeclared : []) {
+      if (!s || typeof s !== 'object') continue
+      for (const f of Array.isArray(s.files) ? s.files : []) {
+        const nf = normalizeGitPath(f)
+        if (!nf || ownDeclaredNorm.has(nf)) continue
+        if (!foreignDeclaredIndex.has(nf)) foreignDeclaredIndex.set(nf, [])
+        if (!foreignDeclaredIndex.get(nf).includes(s.sessionId)) foreignDeclaredIndex.get(nf).push(s.sessionId)
+      }
+    }
+    const findForeignDeclaredOwner = (p) => {
+      const f = normalizeGitPath(p)
+      if (f.endsWith('/')) {
+        // 折叠目录 token（porcelain 把全新未跟踪目录折成 `dir/`）：目录下任一文件被他者声明 →
+        // 整目录归他者；但本会话在同目录下有声明时不退栈——目录内混有双方文件，留给各门判定
+        // （fail-closed：宁可误拦不可漏放，误拦有 --files 追加声明的明确出口）。
+        if ([...ownDeclaredNorm].some(x => x.startsWith(f))) return null
+        for (const [nf, owners] of foreignDeclaredIndex) {
+          if (nf.startsWith(f)) return owners
+        }
+        return null
+      }
+      return foreignDeclaredIndex.get(f) || null
+    }
     const DANGEROUS_PATTERNS = [
       'package.json',
       'package-lock.json',
@@ -891,6 +1024,15 @@ export async function auditQuickCompletion(cwd, guard, options = {}) {
       // 预存脏文件：step1 baseline 已记录，非本次 quick 产生，跳过审计（含折叠目录前缀匹配）
       if (isBaselineFile(file)) continue
 
+      // 他者 active 会话已声明 → 完全退栈归该会话审计（危险/删除/新增/越界/baseline 全部门跳过），
+      // 收进 foreignSessionDeclared 供 printQuickAuditReview 软警告——放行可见可审计不静默
+      // （与 linkedChangeLeftovers 同哲学）。stagedTotal 已在上方计数，累计暂存口径不受退栈影响。
+      const foreignOwners = findForeignDeclaredOwner(file)
+      if (foreignOwners) {
+        result.foreignSessionDeclared.push({ file, sessions: foreignOwners })
+        continue
+      }
+
       result.changedFiles.push(file)
       if (rawStatus[0] === 'D' || rawStatus[1] === 'D') result.deletedFiles.push(file)
       if (status === '??') result.newFiles.push(file)

package/src/run.js

@@ -15,8 +15,8 @@
  */
 // W6 Step8c: 主命令分发（runCommand）+ auto 模式 + ensureStageSteps 搬至 ./run/command.js
 export { runCommand, ensureStageSteps } from './run/command.js'
-// barrel re-export: parsePorcelainPath + auditQuickCompletion + isQuickMetadata 被 test 直接 import（契约保留）
-export { parsePorcelainPath, auditQuickCompletion, isQuickMetadata } from './run/shared.js'
+// barrel re-export: parsePorcelainPath + auditQuickCompletion + isQuickMetadata + collectOtherQuickSessionDeclarations 被 test 直接 import（契约保留）
+export { parsePorcelainPath, auditQuickCompletion, isQuickMetadata, collectOtherQuickSessionDeclarations } from './run/shared.js'
 // barrel re-export: applyRootPlaceholders 被 test/prompt-placeholders.test.mjs 直接 import（契约保留）
 export { applyRootPlaceholders } from './run/prompt.js'
 // barrel re-export: sanitizeProjectName + validateParsedProjects 被 test 直接 import（随 handleScan 搬走，契约保留）

package/src/scan-postcheck.js

@@ -10,6 +10,7 @@ import { join, basename } from 'path'
 import { SCAN_STATUS, CHECK_SEVERITY, SCAN_REQUIRED_DOCS, SCAN_REQUIRED_DOCS_QUICK } from './constants.js'
 import { validateScriptCommands } from './stages/cmd-existence.js'
 import { git } from './git-helper.js'
+import { nowWallClock } from './datetime.js'
 
 const REQUIRED_SCAN_DOCS = SCAN_REQUIRED_DOCS
 
@@ -394,7 +395,7 @@ export function fixScanDocHeaders({ cwd, specDir = null, project = null }) {
   try {
     author = git(cwd, ['config', 'user.name']) || 'unknown'
   } catch { /* git 不可用 → unknown */ }
-  const now = new Date().toISOString().slice(0, 19).replace('T', ' ')
+  const now = nowWallClock()
 
   const fixed = []
   const skipped = []
@@ -410,26 +411,13 @@ export function fixScanDocHeaders({ cwd, specDir = null, project = null }) {
       } catch {
         continue
       }
-      const header = content.slice(0, 512)
-      const hasAuthor = /author\s*:/.test(header)
-      const hasCreated = /created_at\s*:/.test(header)
-      if (hasAuthor && hasCreated) {
+      const r = backfillFrontmatter(content, { author, createdAt: now })
+      if (!r.changed) {
         skipped.push(filePath)
         continue
       }
-      const inserts = []
-      if (!hasAuthor) inserts.push(`author: ${author}`)
-      if (!hasCreated) inserts.push(`created_at: ${now}`)
-      let newContent
-      if (content.startsWith('---\n') || content.startsWith('---\r\n')) {
-        // 有 frontmatter：插到开标签后（CRLF 归一写回，与其它 CLI 写入口径一致）
-        const normalized = content.replace(/\r\n?/g, '\n')
-        newContent = normalized.replace(/^---\n/, `---\n${inserts.join('\n')}\n`)
-      } else {
-        newContent = `---\n${inserts.join('\n')}\n---\n\n` + content
-      }
       try {
-        writeFileSync(filePath, newContent)
+        writeFileSync(filePath, r.content)
         fixed.push(filePath)
       } catch { /* 只读文件等写失败 → 跳过不抛 */ }
     }
@@ -437,6 +425,31 @@ export function fixScanDocHeaders({ cwd, specDir = null, project = null }) {
   return { fixed, skipped }
 }
 
+/**
+ * 通用 frontmatter 补齐（纯函数）：首 512 字节缺 author:/created_at: 时补缺失键。
+ * 有 frontmatter（--- 开头）→ 插到开标签后（CRLF 归一 LF 写回）；无 → 头部整块前置。
+ * fixScanDocHeaders 与 decisions.md 自动补（stage-contract.js ensureDecisionDocHeader）共用，
+ * 单一实现杜绝两处行尾/插入位置漂移。
+ * @param {string} content
+ * @param {{ author: string, createdAt: string }} p
+ * @returns {{ changed: boolean, content: string }}
+ */
+export function backfillFrontmatter(content, { author, createdAt }) {
+  const header = String(content || '').slice(0, 512)
+  const hasAuthor = /author\s*:/.test(header)
+  const hasCreated = /created_at\s*:/.test(header)
+  if (hasAuthor && hasCreated) return { changed: false, content }
+  const inserts = []
+  if (!hasAuthor) inserts.push(`author: ${author}`)
+  if (!hasCreated) inserts.push(`created_at: ${createdAt}`)
+  if (content.startsWith('---\n') || content.startsWith('---\r\n')) {
+    // 有 frontmatter：插到开标签后（CRLF 归一写回，与其它 CLI 写入口径一致）
+    const normalized = content.replace(/\r\n?/g, '\n')
+    return { changed: true, content: normalized.replace(/^---\n/, `---\n${inserts.join('\n')}\n`) }
+  }
+  return { changed: true, content: `---\n${inserts.join('\n')}\n---\n\n` + content.replace(/\r\n?/g, '\n') }
+}
+
 /**
  * source_root 污染一键修复（2026-08-21 agent-手工产出审计第四批 C-3）。
  *

package/src/stage-contract-spec.js

@@ -403,8 +403,9 @@ const PLAN_RULES = [
       messageVerify: '${id}: 缺少 verify 字段',
       messageConstraints: '${id}: 缺少 constraints 字段',
       messageDependsOnMissing: '${id}: depends_on 引用了不存在的 ${dep}',
+      messagePlaceholder: '${id}: task 卡仍是未填充的生成骨架（${fields} 里的占位符未替换）——占位符视同缺字段。用 Edit 填充 tasks/${id}.md 后重跑（勿删字段勿留 FR-XX/src/example/file.ts/具体步骤 等占位值）',
     },
-    spec: 'task 卡片完整 TaskCard schema(可行性,只认 frontmatter 字段,均 error):YAML frontmatter 必备;frontmatter 需 id、title;allowed_paths 非空;frontmatter 需 goal、implementation、acceptance、verify、constraints 五字段;depends_on 引用的 task 必须存在。',
+    spec: 'task 卡片完整 TaskCard schema(可行性,只认 frontmatter 字段,均 error):YAML frontmatter 必备;frontmatter 需 id、title;allowed_paths 非空;frontmatter 需 goal、implementation、acceptance、verify、constraints 五字段;depends_on 引用的 task 必须存在;骨架占位符(FR-XX/D-XXX/src/example/file.ts/一句话说明这个 task/具体步骤 1/可验证的验收条件 1/边界约束 1)未替换视同缺字段。',
     failMessage: '${id}: task 卡片 frontmatter 缺少必要字段(id/title/allowed_paths/goal/implementation/acceptance/verify/constraints)',
   },
 ]