sillyspec 3.33.0 → 3.33.2

package/src/quicklog.js

@@ -118,18 +118,74 @@ export function sanitizeDesc(description) {
   return s.length > 120 ? s.slice(0, 120) + '…' : s
 }
 
+// ── 短标题提炼（2026-10-16-short-change-title，变更中心标题治理·工具侧）──
+
+// 提炼参数：目标 20 字 / 上限 30 字 / 截点下限 6 字（更短的截点宁可不切——残词标题比
+// 硬切长句更难读，如「修复，…」切出「修复」）。平台侧回填脚本须与此处口径对齐。
+const SHORT_TITLE_DEFAULTS = Object.freeze({ target: 20, max: 30, floor: 6 })
+// 全角/语义截点：无条件可切。ASCII 标点仅在后随空白/CJK/串尾时才算截点（防 3.5 / 1,000 /
+// e.g. 误切——小数点后随数字是最常见误切源，rpc-budget 标题实证）。
+const SHORT_TITLE_CJK_CUT = new Set([...'。！？；：、，…—～·'])
+const SHORT_TITLE_ASCII_CUT = new Set([...'.,;:!?'])
+const SHORT_TITLE_CJK_RE = /[\u3400-\u4dbf\u4e00-\u9fff]/
+// 截断后尾部清理：剥句读尾标点（引号括号不入此集——「xxx」收尾是平衡结构不能剥）；
+// 再剥截点切进引号体时留下的悬空开口引号/括号。
+const SHORT_TITLE_TRAIL_RE = /[\s。．.!！?？；;：:，,、…—~～·]+$/u
+const SHORT_TITLE_DANGLING_RE = /[「『（《"']+$/u
+
 /**
- * 变更标题推导（用户需求 2026-09-29：changes.title 应为中文描述，≤50 字、建议 ~20 字）。
- * 取 --input 首个非空行（「成功标准：」引导行即止——那是验收面不是标题素材），剥
- * 「需求：/动机：」类标签前缀，空白折叠单行，超长截断加 …；空输入返回 ''（调用方兜底
- * change 名）。agent 在 --input 首行写一句中文概括即成标题（flow start 横幅有指引），
- * --title 显式覆盖一切推导。
+ * 短标题提炼（2026-10-16-short-change-title）。病根：deriveChangeTitle 旧口径对超长首行
+ * 50 字硬切加 …（残句难读），纯靠 agent 自觉写短首行（本地 20 条实证 7 条变更名兜底 +
+ * 8 条硬切残句）。提炼口径：超 max 长句在自然标点处截断——截点取「距 target 最近、
+ * 落在 [floor, max] 区间」者（同距取更短），截后剥尾部标点；无可用截点才硬切
+ * slice(0,max)+'…' 并标 hardCut=true（调用方可据此打 --title 软提示）。
+ * 返回 { title, hardCut }；空输入 { title:'', hardCut:false }。
+ */
+export function distillShortTitleEx(raw, opts = {}) {
+  const { target, max, floor } = { ...SHORT_TITLE_DEFAULTS, ...opts }
+  const s = String(raw || '').replace(/\s+/g, ' ').trim()
+  if (!s) return { title: '', hardCut: false }
+  if (s.length <= max) {
+    return { title: s.replace(SHORT_TITLE_TRAIL_RE, ''), hardCut: false }
+  }
+  // 截点收集：候选标题=标点前缀（去重后按距 target 最近择优）
+  const seen = new Set()
+  const cands = []
+  for (let i = 0; i < s.length; i++) {
+    const ch = s[i]
+    let cut = SHORT_TITLE_CJK_CUT.has(ch)
+    if (!cut && SHORT_TITLE_ASCII_CUT.has(ch)) {
+      const nx = s[i + 1]
+      cut = nx === undefined || /\s/.test(nx) || SHORT_TITLE_CJK_RE.test(nx)
+    }
+    if (!cut) continue
+    const t = s.slice(0, i).replace(SHORT_TITLE_TRAIL_RE, '').replace(SHORT_TITLE_DANGLING_RE, '').trim()
+    if (t && !seen.has(t)) { seen.add(t); cands.push(t) }
+  }
+  const valid = cands.filter((t) => t.length >= floor && t.length <= max)
+  if (valid.length > 0) {
+    valid.sort((a, b) => (Math.abs(a.length - target) - Math.abs(b.length - target)) || (a.length - b.length))
+    return { title: valid[0], hardCut: false }
+  }
+  return { title: s.slice(0, max) + '…', hardCut: true }
+}
+
+/** distillShortTitleEx 的字符串简版（不需要 hardCut 观测的调用方）。 */
+export function distillShortTitle(raw, opts) {
+  return distillShortTitleEx(raw, opts).title
+}
+
+/**
+ * 变更标题首行提取（不截断）：取 --input 首个非空行（「成功标准：」引导行即止——那是验收
+ * 面不是标题素材），剥「需求：/动机：」类标签前缀，空白折叠单行。截断口径由此分治：
+ * deriveChangeTitle（≤50 硬切，模块摘要用）与 deriveShortChangeTitle（≤30 提炼，标题面用）
+ * 共享本提取，两个口径互不牵连。空输入返回 ''（调用方兜底变更名）。
  * 段头行防御（2026-10-15-title-label-skip）：过门格式示例曾被读成段头形态——agent 把
  * 「动机与背景：」独立成行照抄，白名单无复合词致整行成标题（进度库 6 变更实证）。两道
  * 防御：白名单补复合词（动机与背景/背景与动机）；任意短段头行（≤12 字非冒号内容+行尾
  * 冒号，如「变更背景：」「详细说明：」）整行跳过取次非空行——冒号后无内容不成标题。
  */
-export function deriveChangeTitle(input, max = 50) {
+function deriveChangeTitleRaw(input) {
   for (const l of String(input || '').replace(/\r\n/g, '\n').split('\n')) {
     const t = l.trim()
     if (!t) continue
@@ -137,12 +193,105 @@ export function deriveChangeTitle(input, max = 50) {
     if (/^[^:：]{1,12}[:：]$/.test(t)) continue
     const stripped = t.replace(/^(?:需求|动机|背景|任务|标题|动机与背景|背景与动机)\s*[:：]\s*/, '').trim()
     if (!stripped) continue
-    const one = stripped.replace(/\s+/g, ' ')
-    return one.length > max ? one.slice(0, max) + '…' : one
+    return stripped.replace(/\s+/g, ' ')
   }
   return ''
 }
 
+/**
+ * 变更标题推导（用户需求 2026-09-29：changes.title 应为中文描述，≤50 字、建议 ~20 字）。
+ * --title 显式覆盖一切推导。agent 在 --input 首行写一句中文概括即成标题（flow start 横幅
+ * 有指引）。**2026-10-16-short-change-title 起标题面改走 deriveShortChangeTitle 提炼口径
+ * （目标 20/上限 30，50 字硬切残句实证淘汰）**；本函数 ≤50 硬切口径保持不变——
+ * motiveFromInput 模块变更索引摘要与其同源（flow-parity），勿在此改截断行为。
+ */
+export function deriveChangeTitle(input, max = 50) {
+  const one = deriveChangeTitleRaw(input)
+  if (!one) return ''
+  return one.length > max ? one.slice(0, max) + '…' : one
+}
+
+/**
+ * 变更标题推导·提炼口径（2026-10-16-short-change-title）：deriveChangeTitleRaw 提取首行后
+ * 过 distillShortTitle——目标 20 字上限 30 字、自然标点截断、无截点才硬切。changes.title
+ * 落库面统一入口（flow start/resume/adopt、run initChange）；--title 显式值由调用方直传，
+ * 不经本函数（用户原话不做二次加工）。
+ */
+export function deriveShortChangeTitleEx(input, opts) {
+  const raw = deriveChangeTitleRaw(input)
+  if (!raw) return { title: '', hardCut: false }
+  return distillShortTitleEx(raw, opts)
+}
+
+export function deriveShortChangeTitle(input, opts) {
+  return deriveShortChangeTitleEx(input, opts).title
+}
+
+// ── 标题硬区间门（2026-10-16-title-range-gate，用户硬性要求：10-30 字必须、建议 ~20、可强制命名）──
+
+/** 标题是否落在硬区间（去首尾空白后按字符数计 10..30）。变更名兜底/短句/超长均 false。 */
+export function isValidChangeTitle(title) {
+  const n = [...String(title || '').trim()].length
+  return n >= 10 && n <= 30
+}
+
+/**
+ * fresh 启动标题解析：--title 显式 > --input 首行提炼 > 变更名兜底。
+ * enforce=true（agent 命名时刻，flow start fresh 非平台 writer）：不在区间/兜底 → ok=false，
+ * 调用方必须在任何状态写入前拒绝启动（强制 agent 命名）。
+ * enforce=false（平台 writer 预建空目录自动派发，无 agent 对话面可强制）：恒 ok=true，
+ * 超界/兜底由调用方 ⚠️ 留痕（best-effort 标题优于阻断派发）。
+ */
+export function resolveStartTitle({ titleFlag, input, change, enforce = true }) {
+  if (titleFlag) {
+    return { title: titleFlag, ok: !enforce || isValidChangeTitle(titleFlag), kind: 'flag', hardCut: false }
+  }
+  const derived = deriveShortChangeTitleEx(input)
+  // enforce 下 hardCut（30 字+… 残句）与超区间同样拒绝：残句正是「让人认不出变更做什么」
+  // 的形态，CLI 提炼救不了就让 agent 自己命名（补标点/写短句/--title 三选一）。
+  // enforce=false（平台豁免）任何非空提炼值照用，超界/残句由调用方 ⚠️ 留痕。
+  if (derived.title && (!enforce || (!derived.hardCut && isValidChangeTitle(derived.title)))) {
+    return { title: derived.title, ok: true, kind: 'derived', hardCut: false }
+  }
+  return {
+    title: change,
+    ok: !enforce,
+    kind: 'fallback',
+    hardCut: Boolean(derived && derived.hardCut),
+    rejectedTitle: (derived && derived.title) || null,
+  }
+}
+
+/** hardCut 软提示（fresh/resume 共用单源）。文案口径=「6..30 字内无可用截点」——hardCut 判定
+ * 是候选截点经 [floor,max] 过滤后为空（标点存在但全在区间外也硬切），禁用「无自然断点」旧
+ * 措辞（2026-10-16-short-change-title 评审 P3 清偿）。 */
+export const SHORT_TITLE_HARDCUT_HINT = '💡 标题超 30 字且 6..30 字内无可用自然标点截点，已硬切——重入 flow start --title "<10-30 字中文概括>" 可给更短标题（不阻断）'
+
+/** 超界不阻断面的强提示行（adopt 收编/resume 补写/平台 writer 豁免共用单源）。 */
+export function shortTitleRangeWarnLine(title) {
+  const n = [...String(title || '').trim()].length
+  return `⚠️ 标题「${title}」${n} 字不在 10-30 硬区间（建议 ~20 字）——重入 flow start --title "<10-30 字中文概括>" 可改（不阻断）`
+}
+
+/** 硬门拒绝报错（flow start fresh exit 2 用）。状态/原因/修复一次给全（cli-copy-selfsufficient）。 */
+export function shortTitleRejectMessage(title) {
+  const fix = [
+    '   ① 重跑时把 --input 首行写成一句 10-30 字中文概括（首行即变更标题）',
+    '   ② 或追加参数 --title "<10-30 字中文概括>"',
+  ]
+  if (title == null || title === '') {
+    return [
+      '❌ 变更标题未命名——flow start 全新启动必须带 10-30 字标题（必须，建议 ~20 字）：标题是变更中心展示面，须让人一眼认出本变更做什么。两条修复：',
+      ...fix,
+    ].join('\n')
+  }
+  const n = [...String(title).trim()].length
+  return [
+    `❌ 变更标题必须为 10-30 字（当前：${JSON.stringify(title)}，${n} 字；必须，建议 ~20 字）——标题是变更中心展示面，须让人一眼认出本变更做什么。两条修复：`,
+    ...fix,
+  ].join('\n')
+}
+
 
 // ── 平台推送（best-effort，2026-08-16-change-center-quick-tab task-06 / D-003）──
 
@@ -337,6 +486,10 @@ function sanitizeQuicklogUser(user) {
 // 从关联变更的 proposal/design 提取首个 # 标题（去「提案书（Proposal）— / 设计文档（Design）—」固定前缀）。
 // 让 quick --linked-changes 启动时（用户常不带 --input）也能拿到语义标题，而非 (quick 任务) 占位。
 // 读不到任何标题返回 ''（调用方再回退占位符，保持向后兼容）。
+// 2026-10-16-short-change-title：① 返回前过提炼封顶 ≤30 字（超长 dash-desc 不直落标题）；
+// ② 两文档皆无语义标题（纯模板 H1，brainstorm 模板正文即「# 提案书（Proposal）」形态）时
+// 回退读 proposal「## 动机」节首行过提炼——动机首句本是一句概括素材，旧口径放弃致标题
+// 恒变更名兜底（平台变更中心 7/20 实证）。无动机节/无内容行仍返回 ''（空串不刷新契约不变）。
 export function deriveTitleFromLinkedChange(specBase, change) {
   if (!change) return ''
   for (const f of ['proposal.md', 'design.md']) {
@@ -355,7 +508,39 @@ export function deriveTitleFromLinkedChange(specBase, change) {
     if (!raw) continue
     const dash = raw.match(/[—-]\s*(.+)$/)
     const title = dash ? dash[1].trim() : raw
-    if (title) return title
+    if (title) return distillShortTitle(title)
+  }
+  const motive = extractMotivationFirstLine(specBase, change)
+  return motive ? distillShortTitle(motive) : ''
+}
+
+// proposal「## 动机」节首个内容行（动机回退素材，2026-10-16-short-change-title）。
+// 节标题形态对齐 stage-templates（## 动机）与 flow-draft SECTION_HEAD_RE：2-6 级标题行含
+// 「动机」即命中（H1 本身是标题不参与）。内容行跳过空行/表格分隔行/HTML 注释（AGENT 槽）/
+// 模板占位行（「为什么做、解决什么核心问题」），剥 markdown bullet 与「任务原话转写：」
+// 前缀（flow-draft 机器稿动机段固定前缀，剥后即 input 首行，与 deriveShortChangeTitle 同源）。
+// 读不到文件/无节/无合格内容行返回 ''。
+function extractMotivationFirstLine(specBase, change) {
+  let content
+  try { content = readFileSync(join(specBase, 'changes', change, 'proposal.md'), 'utf8') } catch { return '' }
+  let inMotivation = false
+  for (const line of String(content).replace(/\r\n/g, '\n').split('\n')) {
+    const t = line.trim()
+    if (/^#{2,6}\s/.test(t)) {
+      if (inMotivation) return '' // 动机节内直到下一节标题都无合格内容行
+      inMotivation = /^#{2,6}\s*(?:\d+(?:[.、)]\s*)?)?[^\n]*动机/.test(t)
+      continue
+    }
+    if (!inMotivation || !t) continue
+    if (/^[\s|:-]+$/.test(t)) continue // 表格分隔/装饰行
+    if (/^<!--/.test(t)) continue // AGENT 槽等 HTML 注释
+    const stripped = t
+      .replace(/^(?:[-*+]|\d+[.、)])\s+/, '')
+      .replace(/^>\s*/, '')
+      .replace(/^任务原话转写[:：]\s*/, '')
+      .trim()
+    if (!stripped || stripped === '（未提供 --input）' || stripped === '为什么做、解决什么核心问题') continue
+    return stripped
   }
   return ''
 }

package/src/review-dispatch.js

@@ -18,6 +18,7 @@
  */
 
 import { existsSync, readFileSync, writeFileSync, mkdirSync, rmSync } from 'node:fs'
+import { runtimeStatePath } from './runtime-paths.js'
 import { join, dirname } from 'node:path'
 import jsYaml from 'js-yaml'
 import { writeAtomicSync } from './fs-atomic.js'
@@ -41,7 +42,7 @@ const DISPATCH_STATES = ['dispatching', 'in-flight', 'completed', 'failed', 'aba
 
 /** 在途记录路径：{SPEC_ROOT}/.runtime/review-dispatch-<change>.json */
 function dispatchRecordPath(specBase, changeName) {
-  return join(specBase, '.runtime', `review-dispatch-${changeName}.json`)
+  return runtimeStatePath(join(specBase, '.runtime'), `review-dispatch-${changeName}.json`)
 }
 
 /** 读在途记录（无/坏 → null，fail-open 调用方按无在途处理）。 */
@@ -459,7 +460,7 @@ function appendShadowLedgerSkip(runtimeRoot, skip) {
  */
 function readCeremonyTierForShadow(runtimeRoot, changeName) {
   try {
-    const p = join(runtimeRoot, `ceremony-tier-${changeName}.json`)
+    const p = runtimeStatePath(runtimeRoot, `ceremony-tier-${changeName}.json`)
     if (!existsSync(p)) return null
     const doc = JSON.parse(readFileSync(p, 'utf8'))
     if (!doc || typeof doc !== 'object' || Array.isArray(doc)) return null
@@ -480,7 +481,7 @@ function generateShadowReviewRunId() {
 //    stage-review.js:751 的主线在途提示内联读的也是主线文件名，不会被影子记录污染）──
 
 function shadowRecordPath(specBase, changeName) {
-  return join(specBase, '.runtime', `review-dispatch-shadow-${changeName}.json`)
+  return runtimeStatePath(join(specBase, '.runtime'), `review-dispatch-shadow-${changeName}.json`)
 }
 
 function readShadowRecord(specBase, changeName) {

package/src/review-tier.js

@@ -35,6 +35,7 @@
  */
 
 import { parseFileChangeList } from './change-list.js'
+import { runtimeStatePath } from './runtime-paths.js'
 import { computeCeremonyTier, CEREMONY_TIERS } from './ceremony-tier.js'
 import { readCeremonyPricingConfig } from './ceremony-config.js'
 import { resolveChangeRisk, extractExplicitRiskLevel } from './change-risk-profile.js'
@@ -151,7 +152,7 @@ export function classifyReviewTier({ planLevel, designPath, riskDetection, frict
   if (designPath) {
     try {
       const changeDir = dirname(designPath)
-      const tierPath = join(dirname(dirname(changeDir)), '.runtime', `ceremony-tier-${basename(changeDir)}.json`)
+      const tierPath = runtimeStatePath(join(dirname(dirname(changeDir)), '.runtime'), `ceremony-tier-${basename(changeDir)}.json`)
       if (existsSync(tierPath)) {
         const tf = JSON.parse(readFileSync(tierPath, 'utf8'))
         if (tf && CEREMONY_TIERS.includes(tf.tier)) tierFileTier = tf.tier

package/src/route-hindsight.js

@@ -37,6 +37,7 @@ import { createHash } from 'node:crypto'
 import { join, basename, dirname } from 'node:path'
 import { writeAtomicSync } from './fs-atomic.js'
 import { computeEditRatio } from './flow-draft.js'
+import { runtimeStatePath } from './runtime-paths.js'
 
 /** 超阈判定常量（可调；口径：比例两路为严格大于——恰等于阈值不算超，保守防误标 R-01；
  * 计数两路为大于等于——2 维/2 次即系统性信号）。 */
@@ -107,7 +108,7 @@ function num(v) {
 export function snapshotBaseline({ specBase, change, changeDir }) {
   try {
     const runtimeRoot = join(specBase, '.runtime')
-    const p = join(runtimeRoot, `${BASELINE_PREFIX}${change}.json`)
+    const p = runtimeStatePath(runtimeRoot, `${BASELINE_PREFIX}${change}.json`)
     if (existsSync(p)) return { captured: false, reason: 'already-exists（首写者胜）' }
     const payload = {
       schemaVersion: 1,
@@ -130,7 +131,7 @@ export function snapshotBaseline({ specBase, change, changeDir }) {
  */
 export function baselineSha256({ specBase, change }) {
   try {
-    const p = join(specBase, '.runtime', `${BASELINE_PREFIX}${change}.json`)
+    const p = runtimeStatePath(join(specBase, '.runtime'), `${BASELINE_PREFIX}${change}.json`)
     if (!existsSync(p)) return null
     return createHash('sha256').update(readTextSafe(p)).digest('hex')
   } catch {
@@ -161,7 +162,7 @@ export function computeHindsightMetrics({ changeDir, reviewJson, flowState }) {
   // ① 首版快照 → 终稿行级改写比
   let designRewriteRatio = 0
   let tasksRewriteRatio = 0
-  const baselineRaw = readTextSafe(join(specBase, '.runtime', `${BASELINE_PREFIX}${change}.json`))
+  const baselineRaw = readTextSafe(runtimeStatePath(join(specBase, '.runtime'), `${BASELINE_PREFIX}${change}.json`))
   let baseline = null
   if (baselineRaw != null) { try { const j = JSON.parse(baselineRaw); baseline = j && typeof j === 'object' ? j : null } catch { baseline = null } }
   if (baseline) {

package/src/run/bg-sync.js

@@ -36,12 +36,18 @@
  * 刻意不赌）；父进程内 shared.js 已加载，动态 import 走缓存无额外成本。
  */
 import { spawn } from 'child_process';
+import { runtimeTempPath } from '../runtime-paths.js'
 import { closeSync, existsSync, mkdirSync, openSync, readFileSync, renameSync, statSync, unlinkSync, writeFileSync } from 'fs';
 import { join } from 'path';
 
 export const BG_LOCK_FILENAME = 'spec-sync-bg.lock';
 export const BG_LOG_FILENAME = 'spec-sync-bg.log';
 
+/** 后台同步日志路径（2026-10-18 布局分层：可随时删除的产物归 temp/）。 */
+export function bgSyncLogPath(runtimeRoot) {
+  return runtimeTempPath(runtimeRoot, BG_LOG_FILENAME);
+}
+
 // 后台轮参数：单轮预算下限（与 env SILLYSPEC_SYNC_TIMEOUT_MS 取 max）、轮数与总预算帽
 // （防慢平台下无限续轮）；锁时效（pid 活性之外的第二道判死——pid 复用假活兜底，
 // 子进程自身总预算 ~2.5min + 收尾余量远小于该值，超时必是异常残留）。
@@ -108,7 +114,7 @@ export function isBgSyncLockLive(lock, now = Date.now()) {
 /** 子进程起步截尾日志（>1MB 保后 512KB，从整行边界起）。失败只影响日志体积。 */
 function truncateLogIfNeeded(runtimeRoot) {
   try {
-    const p = join(runtimeRoot, BG_LOG_FILENAME);
+    const p = bgSyncLogPath(runtimeRoot);
     if (statSync(p).size <= LOG_TRUNCATE_THRESHOLD) return;
     const buf = readFileSync(p);
     const keep = buf.subarray(Math.max(0, buf.length - LOG_TRUNCATE_KEEP));
@@ -143,15 +149,16 @@ export async function spawnBackgroundSync(cwd, changeName, platformOpts = {}, op
     // 单飞合并：活后台轮在跑，把「还有新状态要同步」并入其下一轮。置位失败（并发写锁）
     // 只损失合并信号——后台轮收尾锁自清，下一条命令重新 spawn，收敛不丢。
     try { writeBgSyncLock(runtimeRoot, { ...lock, rerunQueued: true }); } catch { /* 见上 */ }
-    return { status: 'coalesced', logPath: join(runtimeRoot, BG_LOG_FILENAME) };
+    return { status: 'coalesced', logPath: bgSyncLogPath(runtimeRoot) };
   }
 
   // 日志 fd：子进程 stdout/stderr 直接 append 进日志文件（跨平台 fd 继承）；开不了退 ignore
-  const logPath = join(runtimeRoot, BG_LOG_FILENAME);
+  const logPath = bgSyncLogPath(runtimeRoot);
   let stdio = ['ignore', 'ignore', 'ignore'];
   let logFd = null;
   try {
     mkdirSync(runtimeRoot, { recursive: true });
+    mkdirSync(join(runtimeRoot, 'temp'), { recursive: true }); // temp/ 可被整体删除，写前重建
     logFd = openSync(logPath, 'a');
     stdio = ['ignore', logFd, logFd];
   } catch {

package/src/run/command.js

@@ -20,6 +20,7 @@
  *     './run/stage.js' → './shared.js' 等同级
  */
 import { basename, join, resolve, dirname } from 'node:path'
+import { runtimeStatePath } from '../runtime-paths.js'
 import { existsSync, readdirSync, mkdirSync, writeFileSync, readFileSync, rmSync, unlinkSync, statSync } from 'node:fs'
 import { randomBytes, randomUUID } from 'node:crypto'
 import { fileURLToPath } from 'node:url'
@@ -29,7 +30,7 @@ import { resolveQuickLinkedChanges } from './quick-audit.js'
 import { outputStep, collectStageWaitHistory } from './prompt.js'
 import { completeStep, completeStepBurst, skipStep, waitStep, continueStep, synthesizeStepOutput } from './complete.js'
 import { runStage } from './stage.js'
-import { sanitizeDesc, deriveChangeTitle } from '../quicklog.js'
+import { sanitizeDesc, deriveShortChangeTitle } from '../quicklog.js'
 import { ProgressManager, resolveSessionIdentity } from '../progress.js'
 import { validateChangeExists, checkTransition } from '../stage-contract.js'
 import { READONLY_AUXILIARY_STAGES } from '../constants.js'
@@ -232,7 +233,7 @@ export async function ensureStageSteps(progress, stageName, cwd, specDir = null)
 function emitReadonlyEmptyGuide() {
   console.log('ℹ️ 未找到进度数据（只读查询不建变更）')
   console.log('   → 可开始轻量变更（--input 引号内换行合法，下例可照抄）：')
-  console.log('     sillyspec flow start --change <YYYY-MM-DD-名> --input "<一句中文概括（首行即变更标题）；随后动机与背景')
+  console.log('     sillyspec flow start --change <YYYY-MM-DD-名> --input "<一句 10-30 字中文概括（首行即变更标题，硬区间 10-30 必须、建议 ~20 字）；随后动机与背景')
   console.log('')
   console.log('     成功标准：')
   console.log('     - <可验证标准>"')
@@ -858,7 +859,7 @@ export async function runCommand(args, cwd, specDir = null, opts = {}) {
             quickFallbackUsed = true
           } else {
             console.log('   本仓无近期 quick 会话记录（current marker 与 quick-sessions 均空）——新工作请走轻量变更（--input 引号内换行合法，可照抄）：')
-            console.log('   sillyspec flow start --change <YYYY-MM-DD-名> --input "<一句中文概括（首行即变更标题）；随后动机与背景')
+            console.log('   sillyspec flow start --change <YYYY-MM-DD-名> --input "<一句 10-30 字中文概括（首行即变更标题，硬区间 10-30 必须、建议 ~20 字）；随后动机与背景')
             console.log('')
             console.log('   成功标准：')
             console.log('   - <可验证标准>"')
@@ -1301,11 +1302,12 @@ export async function runCommand(args, cwd, specDir = null, opts = {}) {
           }
         }
       } catch { /* 守卫异常不拦正常注册（fail-open）*/ }
-      // 创建时即写 title（与 name/KEY 同时落 db）：--input 首行推导 deriveChangeTitle（≤50 字，
-      // 用户需求 2026-09-29）优先，长输入兜底 sanitizeDesc 压行，无则用 name 兜底。
+      // 创建时即写 title（与 name/KEY 同时落 db）：--input 首行过提炼 deriveShortChangeTitle
+      // （目标 20/上限 30 自然标点截断；2026-10-16-short-change-title，50 字硬切残句淘汰）
+      // 优先，长输入兜底 sanitizeDesc 压行，无则用 name 兜底。
       // proposal 还没写、无权威标题来源，这是临时值；brainstorm/plan 完成 proposal/design 落盘后由
       // complete.js 通用完成路径 deriveTitleFromLinkedChange 刷新为真实 # 标题（与 quick 启动 title 同源）。
-      progress = pm.initChange(cwd, autoChange, { title: inputText ? (deriveChangeTitle(inputText) || sanitizeDesc(inputText)) : autoChange })
+      progress = pm.initChange(cwd, autoChange, { title: inputText ? (deriveShortChangeTitle(inputText) || sanitizeDesc(inputText)) : autoChange })
     } else if (isAuxiliary) {
       let autoName = changeName || resolveChangeNameAuto(cwd, specRoot) || 'default'
       // archive 特例：归档后变更从活跃列表排除（listChanges WHERE status='active'），
@@ -1332,7 +1334,7 @@ export async function runCommand(args, cwd, specDir = null, opts = {}) {
       changeName = autoName
       if (!progress) {
         // auxiliary 创建也写 title（--input 优先 / name 兜底），同上完整流程语义。
-        progress = pm.initChange(cwd, autoName, { title: inputText ? (deriveChangeTitle(inputText) || sanitizeDesc(inputText)) : autoName })
+        progress = pm.initChange(cwd, autoName, { title: inputText ? (deriveShortChangeTitle(inputText) || sanitizeDesc(inputText)) : autoName })
         // initChange 可能因 project 表为空返回 null
         if (!progress) {
           progress = { currentStage: stageName, stages: {}, lastActive: new Date().toLocaleString('zh-CN', { hour12: false }), project: '' }
@@ -1354,7 +1356,7 @@ export async function runCommand(args, cwd, specDir = null, opts = {}) {
         // initChangeIfNoActive 单语句原子抢占，败者走同一引导。
         const date = new Date().toISOString().slice(0, 10)
         const autoName = `${date}-new-change-${randomBytes(4).toString('hex')}`
-        const claim = pm.initChangeIfNoActive(cwd, autoName, { title: inputText ? (deriveChangeTitle(inputText) || sanitizeDesc(inputText)) : autoName })
+        const claim = pm.initChangeIfNoActive(cwd, autoName, { title: inputText ? (deriveShortChangeTitle(inputText) || sanitizeDesc(inputText)) : autoName })
         if (!claim.created) {
           const activeChanges = claim.activeChanges || []
           console.error(`❌ 已存在 ${activeChanges.length} 个活跃变更，run brainstorm 无 --change 不会自动创建新变更。`)
@@ -1377,7 +1379,7 @@ export async function runCommand(args, cwd, specDir = null, opts = {}) {
         // 正是并发双建的温床）——1 活跃现与多活跃同走 exit 2 引导。
         const date = new Date().toISOString().slice(0, 10)
         const autoName = `${date}-new-change-${randomBytes(4).toString('hex')}`
-        const claim = pm.initChangeIfNoActive(cwd, autoName, { title: inputText ? (deriveChangeTitle(inputText) || sanitizeDesc(inputText)) : autoName })
+        const claim = pm.initChangeIfNoActive(cwd, autoName, { title: inputText ? (deriveShortChangeTitle(inputText) || sanitizeDesc(inputText)) : autoName })
         if (!claim.created) {
           const activeCount = claim.activeChanges || []
           console.error(`❌ 已存在 ${activeCount.length} 个活跃变更，run auto 无法自动定位目标。`)
@@ -1452,7 +1454,7 @@ export async function runCommand(args, cwd, specDir = null, opts = {}) {
             if (!flags.includes('--upgrade-thick')) {
               console.error(`⛔ 本变更在轻量跑道上（flow-state 在场）——升厚走完整流程需用户同意，agent 不得自行转道：`)
               console.error(`   · 征得用户同意后带 --upgrade-thick 重跑本命令（落痕留档，首次转厚即转）`)
-              console.error(`   · 用户未确认或选择轻量跑 → 继续轻量变更：直接干活，收口 sillyspec flow done --change ${effectiveChange}`)
+              console.error(`   · 用户未确认或选择轻量跑 → 继续轻量变更：先答 spec 面并过批准再干活（未批准先 flow approve），收口 sillyspec flow done --change ${effectiveChange}`)
               process.exit(2)
             }
             writeFlowState(changeDir, { legacy_fallback: true, upgraded_by_consent: new Date().toISOString() })
@@ -2076,7 +2078,7 @@ async function runAutoMode(pm, progress, cwd, flags, changeName, platformOpts =
     if (classification.mode === 'quick') {
       console.log(`📊 auto 模式分类：${classification.reason} 判为小变更`)
       console.log(`   小变更请走轻量变更（quick 通道已退役，v3.30.0 起拒绝新会话；--input 引号内换行合法，可照抄）：`)
-      console.log('   sillyspec flow start --change <YYYY-MM-DD-名> --input "<一句中文概括（首行即变更标题）；随后动机与背景')
+      console.log('   sillyspec flow start --change <YYYY-MM-DD-名> --input "<一句 10-30 字中文概括（首行即变更标题，硬区间 10-30 必须、建议 ~20 字）；随后动机与背景')
       console.log('')
       console.log('   成功标准：')
       console.log('   - <可验证标准>"')
@@ -2382,7 +2384,7 @@ function printAutoCompletionSummary(pm, cwd, changeName, flowStages, specBase) {
     // last-delta 模块清单（sidecar 缺失跳过）
     try {
       const runtimeRoot = join((specBase || join(cwd, '.sillyspec')), '.runtime')
-      const sidecarPath = join(runtimeRoot, 'last-delta.json')
+      const sidecarPath = runtimeStatePath(runtimeRoot, 'last-delta.json')
       if (existsSync(sidecarPath)) {
         const sidecar = JSON.parse(readFileSync(sidecarPath, 'utf8'))
         if (Array.isArray(sidecar.affectedModules) && sidecar.affectedModules.length > 0) {

package/src/run/complete-handlers.js

@@ -30,6 +30,7 @@
  * （非被外层吞）；process.exit 不可被 try 捕获 → 搬迁行为完全等价。
  */
 import { basename, dirname, join, resolve, relative, isAbsolute } from 'node:path'
+import { runtimeStatePath, runtimeStateFileNames } from '../runtime-paths.js'
 import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync, unlinkSync, rmSync, renameSync } from 'node:fs'
 import { createHash } from 'node:crypto'
 import { renameSyncRetry, writeAtomicSync } from '../fs-atomic.js'
@@ -161,8 +162,9 @@ function ownerFromReviewedFiles(reviewedFiles) {
  * 归档 / change-delete 无 delta 同样可删。
  *
  * 归属 fail-closed（禁 mtime 猜、禁后缀匹配）：
- *   apply-pathspec-<change>.txt 精确文件名
- *   prompt-inject-<change>.json 精确文件名（2026-09-18-preflight-slimming：注入分叉账本回收登记）
+ *   state/ 全家族散文件 + 根目录同名兜底（runtime-paths.js runtimeStateFileNames 唯一清单：
+ *   draft-ledger / watcher 三件套 / test 台账 / ceremony 档位 / 冲突标记 / marker 等，
+ *   含 apply-pathspec-<change>.txt、prompt-inject-<change>.json 两个历史登记家族）
  *   execute-runs/<runId>/ 仅当 `change` 戳全等（无戳旧 run 留下，不按覆盖度启发式删）
  *   stage-reviews/<dir>/ 仅当 review.json reviewedFiles 首段 === changeName
  *   verify-runs/<ts>/ 仅当目录内 JSON 的 change 字段集合 size=1 且等于本变更
@@ -193,33 +195,26 @@ export function pruneArchivedChangeRuntime(runtimeRoot, changeName) {
     } catch { /* 单份失败不连坐，下次归档/删变更再收 */ }
   }
 
+  // 2026-10-18 布局分层：per-change 散文件全部落 state/，回收名单从三家族扩到全家族
+  // （runtime-paths.js STATE_FAMILIES 唯一清单源，禁 glob 的精确名形态不变）。
+  // 每个精确名试双路径：state/（新布局）+ 根目录（未迁移旧仓/混版本迟到文件兜底——
+  // 迁移幂等收敛后根路径命中恒为零）。friction-tally 删前残余滚台账语义保留（见函数头）。
   try {
-    const pathspec = join(runtimeRoot, `apply-pathspec-${changeName}.txt`)
-    if (existsSync(pathspec)) gone(pathspec)
-  } catch {}
-
-  // prompt-inject 账本（2026-09-18-preflight-slimming Phase 2 / D-002，Grill 评审 fail②）：
-  // .runtime/prompt-inject-<change>.json 是 change 级派生文件（阶段感知注入分叉的账本），
-  // 变更归档/删除后无读者——不登记回收则按变更数累积孤儿。精确文件名，对齐上方
-  // apply-pathspec / 下方 friction-tally 同款形态（禁 glob/后缀匹配）。
-  try {
-    const ledger = join(runtimeRoot, `prompt-inject-${changeName}.json`)
-    if (existsSync(ledger)) gone(ledger)
-  } catch {}
-
-  // friction tally（friction-signal-hint FR-05）：摩擦计数随变更终态一并回收——真实变更的
-  // friction-tally-<change>.json 落 runtimeRoot，变更归档/删除后无读者，残留即孤儿文件。
-  // 删前残余先滚台账（tax-governance FR-02 兜底滚动点，见函数头注释）。
-  try {
-    const fp = join(runtimeRoot, `friction-tally-${changeName}.json`)
-    if (existsSync(fp)) {
-      const merged = mergeFrictionEntrySync(runtimeRoot, {
-        change: changeName,
-        counts: residualFrictionCounts(fp),
-        archivedAt: new Date().toISOString(),
-      })
-      ledgerAppend = !!(merged && merged.ok && !merged.skipped)
-      gone(fp)
+    for (const name of runtimeStateFileNames(changeName)) {
+      for (const p of [runtimeStatePath(runtimeRoot, name), join(runtimeRoot, name)]) {
+        try {
+          if (!existsSync(p)) continue
+          if (name === `friction-tally-${changeName}.json`) {
+            const merged = mergeFrictionEntrySync(runtimeRoot, {
+              change: changeName,
+              counts: residualFrictionCounts(p),
+              archivedAt: new Date().toISOString(),
+            })
+            ledgerAppend = !!(merged && merged.ok && !merged.skipped)
+          }
+          gone(p)
+        } catch { /* 单路径失败不连坐 */ }
+      }
     }
   } catch {}
 
@@ -320,15 +315,22 @@ export async function archiveWorktreeCleanup(cwd, archiveChangeName, specBase, p
       // 手工短名变更（如 login）时误删自动日期前缀变更（2026-08-01-login 天然以 '-login' 结尾）
       // 的 marker。stage 集合与写入侧 stageReviewMarkerPath 的调用方一致。
       const REVIEW_STAGES = ['brainstorm', 'plan', 'execute', 'verify', 'archive']
-      const markers = readdirSync(runtimeRoot).filter((f) =>
-        f === `current-execute-run-id-${archiveChangeName}` ||
-        REVIEW_STAGES.some(st => f === `current-stage-review-run-id-${st}-${archiveChangeName}`),
-      )
-      for (const m of markers) {
-        try { unlinkSync(join(runtimeRoot, m)) } catch {}
+      // 2026-10-18 布局分层后 marker 落 state/；根目录扫描保留为旧布局兜底（迁移幂等收敛）
+      const markerDirs = [join(runtimeRoot, 'state'), runtimeRoot]
+      let markerCleaned = 0
+      for (const markerDir of markerDirs) {
+        let names = []
+        try { names = readdirSync(markerDir) } catch { continue }
+        const markers = names.filter((f) =>
+          f === `current-execute-run-id-${archiveChangeName}` ||
+          REVIEW_STAGES.some(st => f === `current-stage-review-run-id-${st}-${archiveChangeName}`),
+        )
+        for (const m of markers) {
+          try { unlinkSync(join(markerDir, m)); markerCleaned++ } catch {}
+        }
       }
-      if (markers.length > 0) {
-        console.log(`🧹 归档清理 ${markers.length} 个 runId marker（execute/stage-review）`)
+      if (markerCleaned > 0) {
+        console.log(`🧹 归档清理 ${markerCleaned} 个 runId marker（execute/stage-review）`)
       }
       // 取证回收必须在下方 worktree 块的 `if (!meta) return` 之前：无 meta 早退是常态
       // （apply 已 cleanup），漏接就会让 execute-runs/verify-runs 继续按变更数累积。
@@ -2803,7 +2805,8 @@ export async function handleExecuteWorktreeCleanup({ stageName, changeName, cwd
               try {
                 const runtimeDir = join(cwd, '.sillyspec', '.runtime');
                 mkdirSync(runtimeDir, { recursive: true });
-                writeFileSync(join(runtimeDir, `execute-cleanup-${changeName}.json`), JSON.stringify({
+                try { mkdirSync(join(runtimeDir, 'state'), { recursive: true }); } catch { /* 回执 fail-open */ }
+                writeFileSync(runtimeStatePath(runtimeDir, `execute-cleanup-${changeName}.json`), JSON.stringify({
                   change: changeName, cleanedAt: new Date().toISOString(),
                   reason: 'execute-completed-no-unapplied-changes',
                 }, null, 2) + '\n', 'utf8');