sillyspec 3.32.9 → 3.33.0

package/src/docs-check.js

@@ -1038,12 +1038,20 @@ export function readDecisionRulesConfig(projectRoot) {
   }
 }
 
-/** 豁免键匹配（本变更范围先支持键匹配，非子串）：规则级 `decisions.<id>.<kind>` 精确命中，
- *  或条目级 `decisions.<id>` 伞形命中（一条豁免该决策全部规则）。无 decisions. 前缀的键不参与。 */
-function isDecisionExempt(knownFailures, entryId, kind) {
-  const ruleKey = `decisions.${entryId}.${kind}`
-  const entryKey = `decisions.${entryId}`
-  return knownFailures.some(k => k === ruleKey || k === entryKey)
+/** 豁免键匹配（键匹配非子串）：域限定键 `decisions.<域>/<id>.<kind>`（规则级精确）与
+ *  `decisions.<域>/<id>`（条目级伞形）——2026-10-14-decision-id-p2-hardening：裸键无域限定，
+ *  一条 decisions.<id> 可静默豁免全库同号条目（D-001@v1 ×296 潜伏面），域限定键收窄命中面；
+ *  裸键 `decisions.<id>[.<kind>]` 保留兼容（消费仓既有配置不失效）。id 与 originId（原编号，
+ *  2026-10-14-decision-legacy-renumber）双匹配——存量迁移后旧号键继续命中。
+ *  无 decisions. 前缀的键不参与。导出（测试面先例 anchorFilePath）。 */
+export function isDecisionExempt(knownFailures, entryId, kind, domain = null, originId = null) {
+  const ids = originId ? [entryId, originId] : [entryId]
+  const keys = []
+  for (const id of ids) {
+    keys.push(`decisions.${id}.${kind}`, `decisions.${id}`)
+    if (domain) keys.push(`decisions.${domain}/${id}.${kind}`, `decisions.${domain}/${id}`)
+  }
+  return knownFailures.some(k => keys.includes(k))
 }
 
 /**
@@ -1051,25 +1059,32 @@ function isDecisionExempt(knownFailures, entryId, kind) {
  * 的写入契约对偶：producer=decision-distill → consumer=本规则族；字段行非列表项，顶层
  * 「状态：/锚点：/最近确认：」标签精确匹配，防误吞正文）。旧格式字段缺失容错为 null。
  * @param {string} md 域文件全文
- * @returns {Array<{ id: string, title: string, status: string|null, anchor: string|null, lastConfirmed: string|null }>}
+ * @returns {Array<{ id: string, title: string, status: string|null, anchor: string|null, lastConfirmed: string|null, change: string|null }>}
  */
 export function parseDecisionEntries(md) {
   const entries = []
   let cur = null
   const flush = () => { if (cur) entries.push(cur) }
   for (const line of String(md || '').replace(/\r\n?/g, '\n').split('\n')) {
-    const h = line.match(/^##\s+(D-\d+)(?:@v(\d+))?\s*(.*)$/)
+    const h = line.match(/^##\s+(D-(?:[A-Za-z0-9_\-\u4e00-\u9fff]+-)?\d+)(?:@v(\d+))?\s*(.*)$/)
     if (h) {
       flush()
       const version = h[2] ? parseInt(h[2], 10) : 1
-      cur = { id: `${h[1]}@v${version}`, title: h[3].trim(), status: null, anchor: null, lastConfirmed: null }
+      cur = { id: `${h[1]}@v${version}`, title: h[3].trim(), status: null, anchor: null, lastConfirmed: null, change: null, originId: null }
       continue
     }
     if (!cur) continue
-    const f = line.match(/^(状态|锚点|最近确认)\s*[：:]\s*(.*)$/)
+    // 变更/来源/原编号：标签读入（变更：2026-10-14-supersedes-mislink-and-change-display 加法字段——
+    // docs-debt 触碰事实行渲染变更名限定词消歧需读入；来源：2026-10-14-decision-id-p2-hardening legacy
+    // 兜底——变更行无条件覆盖在前、来源仅补缺；原编号：2026-10-14-decision-legacy-renumber——存量迁移
+    // 后条目 id 为全局号，消费仓旧豁免键（decisions.D-002@vN）经原编号继续命中；旧条目缺行容错 null）
+    const f = line.match(/^(状态|锚点|最近确认|变更|来源|原编号)\s*[：:]\s*(.*)$/)
     if (!f) continue
     if (f[1] === '状态') cur.status = f[2].trim().split(/[\s（(]/)[0] || null
     else if (f[1] === '锚点') cur.anchor = f[2].trim()
+    else if (f[1] === '变更') cur.change = f[2].trim() || null
+    else if (f[1] === '来源') cur.change = cur.change || (f[2].trim() || null)
+    else if (f[1] === '原编号') cur.originId = f[2].trim() || null
     else cur.lastConfirmed = f[2].trim()
   }
   flush()
@@ -1148,8 +1163,8 @@ export async function runDecisionRules(opts) {
   let implementedTotal = 0
   const treeCache = new Map() // resolveCandidates 全树扫描复用（同 docs check 主链路口径）
 
-  const emit = (id, domain, file, kind, extra, message) => {
-    if (isDecisionExempt(failures, id, kind)) {
+  const emit = (id, domain, file, kind, extra, message, originId = null) => {
+    if (isDecisionExempt(failures, id, kind, domain, originId)) {
       exempted.push({ key: `decisions.${id}.${kind}`, id, kind })
       return
     }
@@ -1169,10 +1184,10 @@ export async function runDecisionRules(opts) {
       // 规则 1：锚点存在性（未记录 → 补录提示；路径不存在 → 失效提示）
       if (!anchorPath) {
         emit(e.id, domain, rel, 'anchor', { anchor: e.anchor || null },
-          `「${e.id}」锚点未记录（${rel}）——旧格式条目，补「锚点：src/…」后可机械校验（advisory）`)
+          `「${e.id}」锚点未记录（${rel}）——旧格式条目，补「锚点：src/…」后可机械校验（advisory）`, e.originId)
       } else if (resolveCandidates(projectRoot, anchorPath, treeCache).length === 0) {
         emit(e.id, domain, rel, 'anchor', { anchor: e.anchor },
-          `「${e.id}」锚点文件不存在：${anchorPath}（${rel}）——决策落点已漂移，人工复核（advisory）`)
+          `「${e.id}」锚点文件不存在：${anchorPath}（${rel}）——决策落点已漂移，人工复核（advisory）`, e.originId)
       }
       // 规则 2：behind 复核（「最近确认」后锚定模块源码前进数超阈值 → 决策待复核；
       // 「最近确认」未记录/域无源码集（无 map 无锚点）→ 无法计算，静默跳过——advisory 不产噪声）
@@ -1185,7 +1200,7 @@ export async function runDecisionRules(opts) {
       const { behind } = computeModuleBehind(domain, e.lastConfirmed, { projectRoot, srcPaths })
       if (behind !== null && behind > threshold) {
         emit(e.id, domain, rel, 'behind', { behind, threshold },
-          `「${e.id}」决策待复核：锚定模块 ${domain} 在最近确认 ${e.lastConfirmed} 后源码已前进 ${behind} commit，超阈值 ${threshold}（${rel}）——复核后更新「最近确认」`)
+          `「${e.id}」决策待复核：锚定模块 ${domain} 在最近确认 ${e.lastConfirmed} 后源码已前进 ${behind} commit，超阈值 ${threshold}（${rel}）——复核后更新「最近确认」`, e.originId)
       }
     }
   }

package/src/docs-debt.js

@@ -13,8 +13,9 @@
 import { existsSync, readFileSync, readdirSync, realpathSync } from 'node:fs'
 import { join, relative } from 'node:path'
 import { safeGit } from './git-helper.js'
-import { parseModuleMapSimple } from './modules.js'
+import { modulePathMatches, parseModuleMapSimple } from './modules.js'
 import { runDocsCheck, readDocsCheckConfig, parseDecisionEntries, anchorFilePath } from './docs-check.js'
+import { decisionChangeQualifier } from './knowledge-match.js'
 
 /** safeGit 超时（大仓 git log 慢时降级该模块，不挂起 Wave 渲染） */
 const GIT_TIMEOUT_MS = 5000
@@ -54,9 +55,9 @@ export function matchFilesToModules(changedFiles, moduleIndex, opts = {}) {
 
   for (const f of changedFiles) {
     let matched = null
-    // 一级：paths/core_files 前缀或字面量命中
+    // 一级：paths/core_files 前缀或字面量命中（含 glob 形态——modulePathMatches 统一入口）
     for (const [id, ps] of modulePaths) {
-      if (ps.some(p => p === f || f.startsWith(p.replace(/\/$/, '') + '/') || p.startsWith(f.split('/')[0] + '/') && p === f)) {
+      if (ps.some((p) => modulePathMatches(f, p))) {
         matched = id; break
       }
     }
@@ -323,7 +324,7 @@ export function computeDecisionTouches(changedFiles, knowledgeRoot) {
       for (const c of changed) {
         // 前缀匹配粒度 = 文件或其子路径（R-03：锚点是文件级非目录级，防同前缀不同文件误报）
         if (c === anchorPath || c.startsWith(anchorPath + '/')) {
-          touches.push({ id: e.id, title: e.title, anchorFile: anchorPath, touchedFile: c, file })
+          touches.push({ id: e.id, title: e.title, anchorFile: anchorPath, touchedFile: c, file, change: e.change || '' })
         }
       }
     }
@@ -344,7 +345,7 @@ export function renderDecisionTouchFacts(touches) {
   const shown = touches.slice(0, DECISION_TOUCH_RENDER_LIMIT)
   const lines = [`[decision-touch] 本次变更触碰 ${touches.length} 条决策锚点（改动可能使该决策需复核）：`]
   for (const t of shown) {
-    lines.push(`  - ${t.id}（${t.title || '无标题'}，锚点 ${t.anchorFile}）← 触碰文件 ${t.touchedFile}（${t.file}）`)
+    lines.push(`  - ${t.id}（${t.title || '无标题'}，锚点 ${t.anchorFile}）← 触碰文件 ${t.touchedFile}（${t.file}｜${decisionChangeQualifier(t.change)}）`)
   }
   if (touches.length > DECISION_TOUCH_RENDER_LIMIT) {
     lines.push(`  …另有 ${touches.length - DECISION_TOUCH_RENDER_LIMIT} 条`)

package/src/doctor-diagnostics.js

@@ -946,7 +946,9 @@ function detectDecisionDrift(cwd) {
     let count = 0
     for (const f of readdirSync(decDir)) {
       if (!f.endsWith('.md')) continue
-      count += (readFileSync(join(decDir, f), 'utf8').match(/^## D-\d+@\d+/gm) || []).length
+      // 双形态计数（2026-10-14-decision-global-id-epoch）：局部 D-011@v1 与全局 D-<域>-042@v1；
+      // 旧正则 @\d+ 漏 @v 前缀恒零——随本单修正
+      count += (readFileSync(join(decDir, f), 'utf8').match(/^## D-(?:[A-Za-z0-9_\-\u4e00-\u9fff]+-)?\d+@v\d+/gm) || []).length
     }
     return { ...base, findings: [`decisions 库 ${count} 条（behind 精确复核在 verify evidence-auto 与 docs-check 决策规则族）`], pass: true, severity: CHECK_SEVERITY.PASSED }
   } catch (e) {

package/src/flow-parity.js

@@ -19,18 +19,21 @@
  *    命中模块变更索引机械回写（sidecar 优先、幂等）、start 注入面欠账事实行（提示前移）。
  */
 import { existsSync, readFileSync, writeFileSync, readdirSync } from 'node:fs'
+import { modulePathMatches } from './modules.js'
 import { join, relative } from 'node:path'
 import { createHash } from 'node:crypto'
 import { execFileSync } from 'node:child_process'
 import { splitOwnVsForeignDiffFiles, commitAttributionForChange, isForeignByCommit, parseChangeNamesFromSubject } from './foreign-declared.js'
 import { collectModuleMaps, normalizeMapPath } from './module-resolve.js'
 import { computeDocsDebt } from './docs-debt.js'
+import { anchorBackfillCandidate } from './decision-distill.js'
 import { writeAtomicSync } from './fs-atomic.js'
 import { normalizePath } from './change-list.js'
 import { readV2SectionAnswer } from './flow-review.js'
 import { DESIGN_QUESTIONS } from './flow-draft.js'
 import { pathMatches } from './change-list.js'
 import { classifyToolScaffold, filterDeliverableFiles } from './worktree-apply.js'
+import { deriveChangeTitle } from './quicklog.js'
 
 /**
  * 模块文档对账（advisory）+ 结构化落盘面（2026-09-27-thin-module-scope-persist）。
@@ -71,7 +74,7 @@ export function reconcileModuleDocs({ cwd, specBase, ownFiles, committedRaw }) {
         .map((pp) => (map.prefix + normalizeMapPath(pp)).replace(/\/+$/, ''))
         .filter(Boolean)
       if (effs.length === 0) continue
-      const hitFiles = deliverables.filter((f) => effs.some((e) => f === e || f.startsWith(e + '/')))
+      const hitFiles = deliverables.filter((f) => effs.some((e) => modulePathMatches(f, e)))
       if (hitFiles.length === 0) continue
       hits++
       const docRel = entry.doc ? `docs/${map.project}/${String(entry.doc).replace(/^\/+/, '')}` : null
@@ -92,7 +95,7 @@ export function reconcileModuleDocs({ cwd, specBase, ownFiles, committedRaw }) {
       for (const pp of entry.paths || []) allPaths.push((map.prefix + normalizeMapPath(pp)).replace(/\/+$/, ''))
     }
   }
-  const isCovered = (f) => allPaths.some((pp) => pp && (f === pp || f.startsWith(pp + '/')))
+  const isCovered = (f) => allPaths.some((pp) => pp && modulePathMatches(f, pp))
   const uncoveredMap = new Map()
   for (const f of deliverables) {
     if (isCovered(f)) continue
@@ -133,6 +136,19 @@ export function evaluateModuleGate({ moduleScope, ignore } = {}) {
   return { block: maps.length > 0 && dirs.length > 0, dirs, maps }
 }
 
+/**
+ * ⑥-0 motiveFromInput：模块变更索引摘要提取（2026-10-15-title-label-skip）。与变更标题
+ * 同源走 deriveChangeTitle——此前 flow.js 裸取 --input 首行，「动机与背景：」段头行整行
+ * 入摘要（stages.changelog 实证）。段头行跳过/标签剥离随 deriveChangeTitle 单源；提取为
+ * 空回退变更名（可辨识不达意优于空串；appendChangeIndexEntries 侧另有 '轻量变更' 二级兜底）。
+ * @returns {string} 摘要（≤50 字）
+ */
+export function motiveFromInput(input, change = '') {
+  let derived = ''
+  try { derived = deriveChangeTitle(input) } catch { derived = '' }
+  return derived || String(change || '')
+}
+
 /**
  * ⑥ appendChangeIndexEntries：命中模块变更索引机械回写（二档）。零语义判断——日期/变更名/
  * 动机首行全是已知量，与 decision-distill 降 noAI 同性质。目标判定遵守 split-changelog 契约
@@ -302,6 +318,11 @@ export function harvestSlot4Decision({ changeDir, change }) {
     answer = readV2SectionAnswer(dText, risksSec.heading, DESIGN_QUESTIONS)
   }
   if (!answer || /^不适用/.test(answer)) return { harvested: false, reason: '槽4 空/不适用' }
+  // 锚点自动回填（2026-10-15-decision-anchor-backfill 收割端）：风险段作答文本恰含一个
+  // 路径 token → 写入 - 锚点：行（源 decisions.md 是真相源，蒸馏自然带上、人可改）；
+  // 0/多候选不写（蒸馏端渲染时还会再兜底一次同款判定）。单一源 anchorBackfillCandidate。
+  const anchorCand = anchorBackfillCandidate(answer)
+  const anchorLine = anchorCand ? [`- 锚点：${anchorCand}`] : []
   const text = [
     '---',
     `author: flow-machine-draft`,
@@ -309,9 +330,12 @@ export function harvestSlot4Decision({ changeDir, change }) {
     '---',
     `# 决策记录（Decisions）— ${change}`,
     '',
-    `## D-001@v1: 风险与死路（design 槽4 收割）`,
+    // 标题自解释（2026-10-15-harvest-title-clarify）：读者面是 decisions 文档与 knowledge，
+    // 机制出处（槽4 收割）由 frontmatter author: flow-machine-draft 承载，标题只说内容与性质。
+    `## D-001@v1: 设计期风险与放弃方案（底稿）`,
     `- 类型：process`,
     `- 状态：confirmed`,
+    ...anchorLine,
     // 类型/状态字段（2026-09-26-slot4-distill-fix）：蒸馏链入选要 status∈{confirmed|accepted|rejected}
     // 且 type∈七类白名单，字段解析只认 `- 字段：值` 列表行形态——此前收割条目零字段致永不入选，
     // 「随蒸馏链进 knowledge」断链（thin-agent-tasks 教训留档归档而 knowledge 零落地的实证）。
@@ -326,7 +350,7 @@ export function harvestSlot4Decision({ changeDir, change }) {
   return { harvested: true }
 }
 
-export default { reconcileModuleDocs, renderVerifyReceipt, harvestSlot4Decision, collectFreezeFiles, backfillGateSummary }
+export default { reconcileModuleDocs, renderVerifyReceipt, harvestSlot4Decision, collectFreezeFiles, backfillGateSummary, motiveFromInput }
 
 /**
  * patch 冻结面的提交面过滤（2026-09-27-tool-debt-cleanup 抽出为纯函数供单测锁定）：

package/src/flow.js

@@ -224,6 +224,23 @@ export async function extractRoutingInputPaths(cwd, specBase, input) {
   })
 }
 
+/**
+ * 轻量道知识注入查询串瘦身（2026-10-15-thin-query-slim）：--input 的「成功标准：」段是验收
+ * 判据语料（文件路径/测试名/断言词——对知识匹配是纯噪音，且路径词会过触路由关键词把命中面
+ * 撑爆：本仓实证整段 input 匹配出 76 条目、58 个 fr 域文件全命中）。查询只取动机段——
+ * 「成功标准：」标记前正文；标记缺席=无标准段，全文照旧（兼容旧形态）；标记前为空白则退全 input。
+ * @param {string} change 变更名（查询首行，既有口径）
+ * @param {string} input --input 全文
+ * @returns {string} 瘦身后的查询串
+ */
+export function thinKnowledgeQuery(change, input) {
+  const raw = String(input || '')
+  const markerIdx = raw.search(/成功标准[:：]/)
+  const motivation = markerIdx >= 0 ? raw.slice(0, markerIdx) : raw
+  const body = motivation.trim() || raw.trim()
+  return `${change || ''}\n${body}`
+}
+
 /**
  * 轻量道知识注入段（2026-09-25-thin-fr-inject-parity）：默认快道读取面对齐——
  * {FR_INDEX_DIGEST}/{DECISION_HITS}/execute 知识命中报告此前只在 run 族装配，轻量道 fresh
@@ -295,10 +312,11 @@ export async function flowKnowledgeDigest({ specBase, change, changeDir, input,
       }
     }
     const { matchKnowledgeHybrid } = await import('./knowledge-vector.js')
-    const { deathPathNote } = await import('./knowledge-match.js')
+    const { deathPathNote, decisionChangeQualifier } = await import('./knowledge-match.js')
     // scope 遍历召回（2026-10-08-knowledge-graph，FR-04）：touched=机器算的图查询键
     // （filesOverride ∪ design 交付表——上方既有变量），词面三层零命中时沿强边保底防复潮
-    const km = await matchKnowledgeHybrid(knowledgeRoot, `${change}\n${input || ''}`, { cwd: dirname(specBase), scopeFiles: touched })
+    const kmQuery = thinKnowledgeQuery(change, input)
+    const km = await matchKnowledgeHybrid(knowledgeRoot, kmQuery, { cwd: dirname(specBase), scopeFiles: touched })
     // 防复潮面 = 死路注记 ∪ 有主题重叠的 rejected（2026-09-28-knowledge-inject-ranking 起 rejected∪死路；
     // 2026-09-28-knowledge-gate-denoise 收紧：score 零的 rejected 与查询零主题重叠——空标题条目靠状态
     // 蹭进回显是行为实测三例的噪音源，不再注入）
@@ -306,20 +324,51 @@ export async function flowKnowledgeDigest({ specBase, change, changeDir, input,
     summary.rejectedDecisions = rejected.length
     summary.knowledgeEntries = km.matched ? (km.entries || []).length : 0
     if (rejected.length > 0) {
-      lines.push(`   ⚠️ 否决决策/死路注记（历史已否决或已记死路，防复潮——除非复潮条件满足勿重提，复潮须在本变更 decisions.md 记新版本）：`)
+      lines.push(`   ⚠️ 否决决策/死路注记（历史已否决或已记死路，防复潮——除非复潮条件满足勿重提，复潮须在本变更 decisions.md 记新版本；跨变更引用带变更名 变更名#D-xxx@vN）：`)
       for (const h of rejected.slice(0, 5)) {
         const note = h.status === 'rejected' ? (h.reason || '（未记录）') : `死路——${deathPathNote(h.reason)}`
-        lines.push(`   - ${h.id} ${h.title}（${h.file}）${h.status === 'rejected' ? '否决理由' : '⚰️'}：${note}`)
+        lines.push(`   - ${h.id} ${h.title}（${h.file}｜${decisionChangeQualifier(h.change)}）${h.status === 'rejected' ? '否决理由' : '⚰️'}：${note}`)
       }
     }
     if (km.matched && (km.entries || []).length > 0) {
       const src = km.entries.slice(0, 3).map((e) => (e.anchor ? `${e.file}#${e.anchor}` : e.file)).join('；')
       lines.push(`   📚 知识命中（INDEX 关键词，按需 Read）：${src}`)
     }
+    // 遥测导线（2026-10-15-thin-inject-telemetry）：轻量道注入此前不落 hits.jsonl——thin 常态化后
+    // inject 事件流断流（本仓 10-09 后归零实证），knowledge stats 从未命中判定被盲区污染。
+    // 分级字段（A2-lite）：injectedFiles=正文实际注入（thin 面恒空——只出按需 Read 行）、
+    // mentionedFiles=显式展示给 agent 的锚点（📚 行 top-3）。既有 matchedFiles 口径不变
+    // （knowledge-stats 消费面零回归）。仅命中面非空才落盘；fail-soft（R-04）不阻断注入。
+    const thinMatchedFiles = km.matched ? (km.entries || []).map((e) => (e.anchor ? `${e.file}#${e.anchor}` : e.file)) : []
+    if (thinMatchedFiles.length > 0 || rejected.length > 0) {
+      try {
+        const { appendKnowledgeHit } = await import('./knowledge-hits.js')
+        appendKnowledgeHit(join(specBase, '.runtime'), {
+          type: 'inject',
+          change,
+          query: kmQuery,
+          matchedFiles: thinMatchedFiles,
+          injectedFiles: [],
+          mentionedFiles: thinMatchedFiles.slice(0, 3),
+          rejectedCount: rejected.length,
+          source: 'thin-start',
+        })
+      } catch { /* 遥测 fail-soft（R-04）：hits 落盘失败不影响注入本体 */ }
+    }
     if (domains.length === 0 && rejected.length === 0 && !km.matched) {
       lines.length = 0
       lines.push(`🧠 知识注入（轻量道读取面）：语料未命中知识库（无触达域依据、无否决命中、INDEX 无对齐条目）——可自行查 knowledge/INDEX.md。`)
     }
+    // 向量开关发现性提示（2026-10-15-vector-switch-discoverability）：零命中=正需要语义召回
+    // 而未获得的时刻——平台已连接但开关未开（缺省关）时给一行可执行提示；有命中/未连接/
+    // 已开启零新增（vectorSwitchHint 单源，同款提示也挂 knowledge search hint 键）。
+    if (!km.matched && rejected.length === 0) {
+      try {
+        const { vectorSwitchHint } = await import('./knowledge-vector.js')
+        const hint = vectorSwitchHint(dirname(specBase))
+        if (hint) lines.push(`   ${hint}`)
+      } catch { /* 提示 fail-open */ }
+    }
     // 模块卡欠账提示前移（2026-10-12-thin-module-gate-and-feed 三档）：触碰命中模块 behind>0
     // 才出事实行——动手前看到「你要动的卡已落后」比收口时警告有效；computeDocsDebt（厚道
     // execute {DOCS_DEBT}）同源，空债/无图零输出，异常走外层 catch fail-open 不阻断 start。
@@ -1089,7 +1138,7 @@ export async function cmdFlowStart({ change, input, title: titleFlag = null, thi
     `   ②③断点 agent 自主跳过。`,
     `   随时可查进度：sillyspec flow status --change ${change}`,
     ...(detectUiTouch(input)
-      ? [...buildUiGuidanceLines(), '']
+      ? [...buildUiGuidanceLines(specBase), '']
       : []),
     ``,
     `【协议调用 2/2（干完后）】sillyspec flow done --change ${change}`,
@@ -1425,11 +1474,22 @@ export async function cmdFlowDone({ change, cwd, specBase, runtimeRootOpt = null
     // 采样去重（2026-10-07-thin-tasks-v3）：task tick 直写的精确事件（source:'task-tick'）为
     // 权威口径，watcher 3s 采样合并跳被去重——CLI 快速连续 tick 不再误伤；观测旁路缺席
     // （无流/读失败）→ 跳过（fail-open，watcher 非真相源）；--allow-batch-tick 显式旁路留痕。
+    // 侧车突发回退（2026-10-14-tick-burst-sidecar-gate）：CLI 收口端快连点对事件流不可见（单格
+    // 精确跳），空结果时回退 task-ticks.jsonl 毫秒时戳判突发——CLI 与直接 Edit 两条路径同判。
     try {
       const { readWatcherEvents } = await import('./watcher.js')
-      const { detectBatchCheckCadence, resolveBatchTickAction } = await import('./sentinel-assertions.js')
+      const { detectBatchCheckCadence, detectTickBurst, resolveBatchTickAction } = await import('./sentinel-assertions.js')
       const stream = readWatcherEvents({ runtimeRoot, change })
-      const batch = stream.exists ? detectBatchCheckCadence(stream.events) : null
+      let batch = stream.exists ? detectBatchCheckCadence(stream.events) : null
+      if (!batch) {
+        // 侧车突发回退（2026-10-14-tick-burst-sidecar-gate）：事件流空结果时读 change 目录
+        // task-ticks.jsonl（CLI tick 毫秒时戳事实源，随归档进 git、不受观测盲窗影响）判快连点；
+        // 事件流结果优先不双重报告；侧车缺失/坏文件按无证据静默（fail-open）。
+        try {
+          const { parseTickLog } = await import('./timeline.js')
+          batch = detectTickBurst(parseTickLog(readFileSync(join(changeDir, 'task-ticks.jsonl'), 'utf8')))
+        } catch { /* 侧车缺失/不可读 → 无侧车证据（fail-open） */ }
+      }
       if (batch) {
         // 代勾计数取「本拍实时代勾 ∨ 持久化代勾」较大者（二轮 P2-B：重入漂移防护）；决策纯函数
         // 单源（resolveBatchTickAction）四态与豁免优先序见其 JSDoc——代勾须解释整跳才降级
@@ -1454,7 +1514,8 @@ export async function cmdFlowDone({ change, cwd, specBase, runtimeRootOpt = null
             console.warn(`⚠️ 勾选节奏：单拍多格勾选（${batch.detail}，${at}）——${why}，降级提醒不拒`)
           }
         } else if (v.action === 'reject') {
-          console.error(`🚫 单拍勾选拒收：事件流观测到一拍勾选 ${batch.detail}（${at}）——勾选纪律要求逐格（做一件→勾一格→下一个），勾选任务 ${_sentinelNonMirrorTasks} 格`)
+          const _via = batch.source === 'tick-burst' ? '侧车时戳观测到' : '事件流观测到'
+          console.error(`🚫 单拍勾选拒收：${_via}一拍勾选 ${batch.detail}（${at}）——勾选纪律要求逐格（做一件→勾一格→下一个），勾选任务 ${_sentinelNonMirrorTasks} 格`)
           console.error('   出口：①节奏违例已既成——认知后重跑带 --allow-batch-tick 显式留痕过门（平台时间线可见旁路）；②疑观测误判→sillyspec doctor 核对事件流')
           appendTelemetry({ sentinel: 'batch-tick', jump: batch.detail })
           reportMidFail('ledger')
@@ -2272,8 +2333,10 @@ export async function cmdFlowDone({ change, cwd, specBase, runtimeRootOpt = null
     // 回读块保证在场（patch 本轮算出或 change-patch.json 回读）。
     try {
       if (moduleScope && Array.isArray(moduleScope.modules) && moduleScope.modules.length > 0) {
-        const { appendChangeIndexEntries } = await import('./flow-parity.js')
-        const motive = String(st.input || '').split('\n').map((s) => s.trim()).find(Boolean) || ''
+        const { appendChangeIndexEntries, motiveFromInput } = await import('./flow-parity.js')
+        // 摘要与变更标题同源（2026-10-15-title-label-skip）：段头行（动机与背景：等）跳过取次行，
+        // 空提取回退变更名——此前裸取首行致「动机与背景：」整行入摘要（stages.changelog 实证）。
+        const motive = motiveFromInput(st.input, change)
         const wr = appendChangeIndexEntries({ specBase, modules: moduleScope.modules, change, summary: motive, date: new Date().toISOString().slice(0, 10) })
         changelogAppended = wr.appended
         if (wr.appended.length > 0) console.log(`📖 模块变更索引回写：${wr.appended.length} 个目标（${wr.appended.join('、')}）——sidecar 优先/卡内节次之，随归档窄化入暂存`)
@@ -2600,7 +2663,7 @@ export async function cmdFlow(args, cwd, specDir = null, opts = {}) {
         console.error(`❌ ${e.message}`)
         // 可照抄实例（2026-10-05-input-teach-copyable）：引号内换行合法，行级 trim 容忍缩进
         console.error('   重试（--input 引号内换行合法，可照抄）：')
-        console.error('   sillyspec flow start --change <YYYY-MM-DD-简短描述> --input "<动机与背景>')
+        console.error('   sillyspec flow start --change <YYYY-MM-DD-简短描述> --input "<一句中文概括（首行即变更标题）；随后动机与背景')
         console.error('')
         console.error('   成功标准：')
         console.error('   - <可验证标准>"')
@@ -2829,9 +2892,9 @@ export async function cmdFlow(args, cwd, specDir = null, opts = {}) {
     console.log(`✅ flow amend-draft 留痕重锚：${r.reanchored.join('、')}——ledger amendment 审计在案；editRatio=${maxRatio}（段级最大；基准=首版原文，AGENT 槽不计入）`)
     return r
   }
-  console.error('用法: sillyspec flow start --change <名> --input "<动机与背景＋独立一行『成功标准：』＋每行一条『- 可验证标准』>" [--thick|--with-tasks] [--no-prestage（hindsight 标记在场时声明需求已含决策，留痕放行）] | sillyspec flow done --change <名> | sillyspec flow status --change <名> [--json] | sillyspec flow diff --change <名> [--json]（只读文件统计）')
+  console.error('用法: sillyspec flow start --change <名> --input "<一句中文概括（首行即变更标题）＋动机与背景详述＋独立一行『成功标准：』＋每行一条『- 可验证标准』>" [--thick|--with-tasks] [--no-prestage（hindsight 标记在场时声明需求已含决策，留痕放行）] | sillyspec flow done --change <名> | sillyspec flow status --change <名> [--json] | sillyspec flow diff --change <名> [--json]（只读文件统计）')
   console.error('      --input 可照抄形态（引号内换行合法）：')
-  console.error('      sillyspec flow start --change <名> --input "<动机与背景>')
+  console.error('      sillyspec flow start --change <名> --input "<一句中文概括（首行即变更标题）；随后动机与背景')
   console.error('')
   console.error('      成功标准：')
   console.error('      - <可验证标准>"')