sillyspec 3.33.0 → 3.33.1

package/.claude/skills/sillyspec-flow/SKILL.md

@@ -16,7 +16,7 @@ description: 轻量变更（默认快道）——需求明确的小/中改动两
 ### ① flow start（立项 + 锁基线）
 
 ```bash
-sillyspec flow start --change <变更名> --input "<一句中文概括（首行即变更标题）；随后动机与背景
+sillyspec flow start --change <变更名> --input "<一句 10-30 字中文概括（首行即变更标题，硬区间 10-30 必须、建议 ~20 字）；随后动机与背景
 
 成功标准：
 - <可验证标准>"

package/.github/workflows/ci.yml

@@ -20,7 +20,8 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with:
-          node-version: '22'
+          node-version: '24'
+        # mock.module 内置模块 named exports 枚举在 node 22 不全（appendFileSync 等缺失实证 38859877373）——统一 24 与本地开发环一致
       - name: lint（check-syntax 全文件）
         run: npm run lint --silent
 
@@ -32,12 +33,18 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with:
-          node-version: '22'
+          node-version: '24'
+        # mock.module 内置模块 named exports 枚举在 node 22 不全（appendFileSync 等缺失实证 38859877373）——统一 24 与本地开发环一致
       # 依赖必须装：测试框架零三方（node:sqlite/test 内置）但被测 CLI 本体 import 7 个
       # 运行时依赖（js-yaml/chalk/@inquirer/prompts 等，src 下 10+ 文件）——CI 首跑
       # （121a33ee）无 install 步实证两 job 全灭（Cannot find package 'js-yaml'）
       - name: install（npm ci 锁定 package-lock）
         run: npm ci --no-audit --no-fund
+      - name: 诊断：node/dash 可用性（run-tests 子进程 shell 语义面）
+        run: |
+          which node
+          node -e "0" && echo "sh 直跑 node -e OK"
+          /bin/sh -c 'node -e "0"' && echo "sh -c 内嵌引号 OK"
       - name: test（run-tests 并发池 + TEMP/HOME 套件隔离）
         run: npm test --silent
 
@@ -48,7 +55,8 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with:
-          node-version: '22'
+          node-version: '24'
+        # mock.module 内置模块 named exports 枚举在 node 22 不全（appendFileSync 等缺失实证 38859877373）——统一 24 与本地开发环一致
       # docs-check.js 同样 import js-yaml——无 install 首跑 7s 即灭（同 test job 根因）
       - name: install（npm ci 锁定 package-lock）
         run: npm ci --no-audit --no-fund

package/AGENTS.md

@@ -16,7 +16,7 @@
 `--input` 过门格式（轻量道首次调用即过，勿靠报错学；引号内换行合法，下例可照抄）：
 
 ```bash
-sillyspec flow start --change <YYYY-MM-DD-名> --input "<一句中文概括（首行即变更标题）；随后动机与背景
+sillyspec flow start --change <YYYY-MM-DD-名> --input "<一句 10-30 字中文概括（首行即变更标题，必须落在 10-30 字硬区间、建议 ~20 字——不合区间 flow start 拒启）；随后动机与背景
 
 成功标准：
 - <可验证标准>"

package/assets/command-cards/flow.md

@@ -11,7 +11,7 @@ description: 轻量变更（默认快道）：需求明确的小/中改动两步
 ```bash
 export SILLYSPEC_SESSION_ID=<agent名+任务名>   # 每条命令都带（shell 状态不持久；多会话并行的所有权判定依赖它）
 # ① 立项 + 锁基线（--input 引号内换行合法，可照抄；缺「成功标准」条目会被清晰度门拦下）：
-sillyspec flow start --change <变更名> --input "<一句中文概括（首行即变更标题）；随后动机与背景
+sillyspec flow start --change <变更名> --input "<一句 10-30 字中文概括（首行即变更标题，硬区间 10-30 必须、建议 ~20 字）；随后动机与背景
 
 成功标准：
 - <可验证标准>"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "3.33.0",
+  "version": "3.33.1",
   "description": "SillySpec CLI — 流程状态机，让 AI 严格按步骤来",
   "icon": "logo.jpg",
   "homepage": "https://sillyspec.ppdmq.top/",

package/src/archive-delta.js

@@ -29,6 +29,7 @@
  * endpoint-extractor，被依赖者均不反向 import 本模块。
  */
 import { existsSync, readFileSync, readdirSync, writeFileSync, mkdirSync } from 'node:fs'
+import { runtimeStatePath } from './runtime-paths.js'
 import { basename, dirname, join } from 'node:path'
 import { parseDecisionDomains, loadModuleMap, deriveActualModules } from './design-facts.js'
 import { parseModuleMapSimple } from './modules.js'
@@ -153,7 +154,7 @@ export function collectDeltaSources({ changeDir, specRoot, project, runtimeRoot,
   // 兜底（Gap-2/D-003）：全无 reconcile → apply-pathspec-<change>.txt 逐行路径作交付清单
   let deliverables = []
   if (!reconcile && runtimeRoot && change) {
-    const text = readTextSafe(join(runtimeRoot, `apply-pathspec-${change}.txt`))
+    const text = readTextSafe(runtimeStatePath(runtimeRoot, `apply-pathspec-${change}.txt`))
     if (text !== null) {
       deliverables = text.split(/\r?\n/).map(s => s.trim()).filter(Boolean)
     }
@@ -454,8 +455,8 @@ export function writeLastDeltaSidecar(runtimeRoot, summary) {
       updatedAt: new Date().toISOString(),
     }
     mkdirSync(runtimeRoot, { recursive: true })
-    writeFileSync(join(runtimeRoot, 'last-delta.json'), JSON.stringify(payload, null, 2) + '\n')
-    return { ok: true, path: join(runtimeRoot, 'last-delta.json') }
+    writeFileSync(runtimeStatePath(runtimeRoot, 'last-delta.json'), JSON.stringify(payload, null, 2) + '\n')
+    return { ok: true, path: runtimeStatePath(runtimeRoot, 'last-delta.json') }
   } catch (e) {
     console.error(`[sillyspec] last-delta sidecar 写入失败（advisory 将缺席，不阻断 delta 生成）：${e && e.message ? e.message : e}`)
     return { ok: false, reason: e && e.message ? e.message : String(e) }

package/src/change-delete.js

@@ -12,7 +12,7 @@
  *     不因删变更丢用户唯一副本的代码；顺带清 execute/stage-review runId marker
  *     + 该变更的 runtime 取证（pruneArchivedChangeRuntime））
  *   - git：safeGit add -A 暂存目录删除（best-effort，对齐 archive CLI 下沉 git add）
- *   - 平台：triggerSync 推终态（sync.js 对 status='deleted' 上行墓碑，平台收敛软删）
+ *   - 平台：triggerSyncTerminalStrict 推终态（sync.js 对 status='deleted' 上行墓碑，平台收敛软删；文件树推送失败显性化）
  *
  * 两段式安全（对齐 --cleanup-remnant / --cleanup-ghosts / --align-execute-progress 家族）：
  * 默认 dry-run 只报告将发生什么，--confirm 才执行。
@@ -23,7 +23,7 @@
 import { existsSync, readdirSync, rmSync, statSync } from 'fs';
 import { join, relative } from 'path';
 import { safeGit } from './git-helper.js';
-import { assertSafeChangeName, triggerSync } from './run/shared.js';
+import { assertSafeChangeName, triggerSyncTerminalStrict } from './run/shared.js';
 import { archiveWorktreeCleanup } from './run/complete-handlers.js';
 
 function countFiles(dir) {
@@ -156,10 +156,11 @@ export async function deleteChange({ cwd, specDir = null, changeName, confirm =
       safeGit(cwd, ['add', '-A', '--', relDir]);
     }
   } catch { /* 非 git 仓等场景：删除在 git status 可见，暂存非必需 */ }
-  // 5. 平台终态/墓碑上行（triggerSync 内建 8s 熔断 + 未连接静默；change-delete 是终态
-  //    一次性命令，await 保证墓碑发出后再退出，输出顺序确定）
+  // 5. 平台终态/墓碑上行（终态强校验：内联有界同步，文件树推送失败显性化——🚨 告警 +
+  //    自救命令 + exit 1；未连接静默。change-delete 是终态一次性命令，await 保证墓碑
+  //    发出后再退出，输出顺序确定）
   try {
-    await triggerSync(cwd, changeName, { specRoot: specBase });
+    await triggerSyncTerminalStrict(cwd, changeName, { specRoot: specBase });
   } catch (e) {
     warnings.push(`平台终态同步失败（不阻断删除，下次常规同步重试）：${e.message}`);
   }

package/src/contract-matrix.js

@@ -9,6 +9,7 @@
  */
 
 import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync } from 'fs'
+import { runtimeStatePath } from './runtime-paths.js'
 import { join, resolve, basename, dirname, relative, isAbsolute } from 'path'
 import { gitQuiet } from './git-helper.js'
 import { splitOwnVsForeignDiffFiles } from './foreign-declared.js'
@@ -440,7 +441,7 @@ function _resolveDiffFilesForParity(specBase, scanRoot, changeName, runtimeRoot)
     // 主仓 diff 空（apply 后已 commit / cleanup 完毕）→ apply-pathspec 兜底：apply 成功时落盘的
     // 本变更精确文件清单（与 gates 归因提示②同源）。仍拿不到才回 null（调用方退全仓）。
     try {
-      const pathspecFile = join(runtimeRoot || join(specBase, '.runtime'), `apply-pathspec-${changeName}.txt`)
+      const pathspecFile = runtimeStatePath(runtimeRoot || join(specBase, '.runtime'), `apply-pathspec-${changeName}.txt`)
       if (existsSync(pathspecFile)) {
         const fromPathspec = readFileSync(pathspecFile, 'utf8').split('\n').map(l => l.trim()).filter(Boolean)
         if (fromPathspec.length > 0) {

package/src/cross-placement.js

@@ -48,9 +48,13 @@ export function crossWorktreePath(specBase, changeName, repoKey, placementRoot =
  * @param {string} mainRoot 主仓根（相对路径解析基准）
  * @returns {string} 绝对落位根
  */
+// Windows 盘符形态判定（坑跨平台 CI：POSIX isAbsolute('C:/x')=false → 带引号的盘符路径
+// 被相对主仓根拼接成 test/C:/quoted 伪路径）。跨仓落位本就面向 Windows 盘符场景设计，
+// 语义上盘符路径恒绝对（与 win32 path.isAbsolute 同判，跨平台自洽）。
+const WIN_DRIVE_ABS_RE = /^[A-Za-z]:[/\\]/;
 export function resolvePlacementRoot(raw, mainRoot) {
   const trimmed = String(raw || '').trim().replace(/^['"]|['"]$/g, '');
-  if (isAbsolute(trimmed)) return resolvePath(trimmed);
+  if (isAbsolute(trimmed) || WIN_DRIVE_ABS_RE.test(trimmed)) return resolvePath(trimmed);
   return resolvePath(mainRoot, trimmed);
 }
 

package/src/db.js

@@ -1,4 +1,5 @@
 import { openDatabase, applyPragmas, runTransaction } from './db-engine.js';
+import { runtimeTempPath } from './runtime-paths.js'
 import { copyFileSync, existsSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'fs';
 import { dirname } from 'path';
 
@@ -102,7 +103,8 @@ export class DB {
    * 全新 node:sqlite 项目不产生主 .bak）。
    */
   _openWithFallback() {
-    const bakPath = `${this.dbPath}.bak`;
+    // .bak 2026-10-18 布局分层后归 temp/；根路径保留兜底（未迁移旧仓/混版本窗口）
+    const bakPath = existsSync(`${this.dbPath}.bak`) ? `${this.dbPath}.bak` : runtimeTempPath(dirname(this.dbPath), 'sillyspec.db.bak');
     // readValid: null=文件不存在；'empty'=存在但 0 字节；'ok'=有内容
     const readValid = (p) => {
       if (!existsSync(p)) return null;
@@ -156,7 +158,11 @@ export class DB {
         // 覆盖前救援快照（2026-08-21 审查 BUG-7）：主库有内容但打不开（"损坏"）时，其中可能
         // 含比 .bak 更新的数据——静默覆盖即静默丢。best-effort 留一份 .corrupt-<ts> 副本供人工恢复。
         if (primaryRaw === 'ok') {
-          try { copyFileSync(this.dbPath, `${this.dbPath}.corrupt-${Date.now()}`); } catch { /* 救援失败不阻断恢复 */ }
+          try {
+          const corruptPath = runtimeTempPath(dirname(this.dbPath), `sillyspec.db.corrupt-${Date.now()}`);
+          try { mkdirSync(dirname(corruptPath), { recursive: true }); } catch { /* fail-open */ }
+          copyFileSync(this.dbPath, corruptPath);
+        } catch { /* 救援失败不阻断恢复 */ }
         }
         // node:sqlite 绑定路径，无 _save：把 .bak 内容 copy 回主库，统一用 dbPath。
         // 体检 BUG-18：主库可能正被其他进程（daemon/另一 CLI）打开——Windows 覆盖他人

package/src/deleted-ledger.js

@@ -14,12 +14,13 @@
  * 坏行容错：单行 JSON 解析失败跳过该行（外部编辑/半写截断不拖垮读取）。
  */
 import { appendFileSync, existsSync, readFileSync } from 'node:fs'
+import { runtimeStatePath } from './runtime-paths.js'
 import { join } from 'node:path'
 
 const LEDGER_FILENAME = 'deleted-changes.jsonl'
 
 function ledgerPath(specDir) {
-  return join(specDir, '.runtime', LEDGER_FILENAME)
+  return runtimeStatePath(join(specDir, '.runtime'), LEDGER_FILENAME)
 }
 
 /**

package/src/doctor-diagnostics.js

@@ -23,6 +23,7 @@
  * writer 落盘到 <authoritySpecDir>/.runtime/。
  */
 import { openDatabase, pluckGet, pluckAll } from './db-engine.js';
+import { runtimeTempPath } from './runtime-paths.js'
 import { safeGit } from './git-helper.js';
 import { createHash } from 'crypto';
 import { existsSync, statSync, readFileSync, readdirSync, mkdirSync, writeFileSync, unlinkSync, rmSync } from 'fs';
@@ -1109,12 +1110,15 @@ export function detectSelfMaintenanceTax(cwd, authoritySpecDir) {
     const warnings = [];
 
     // ① 活跃非零 tally 列示（events:{type:{count,lastAt}}，X-10 结构）
+    // 2026-10-18 布局分层：tally 落 state/；根目录扫描保留旧布局兜底（入口迁移收敛后恒空）
     try {
-      for (const f of readdirSync(runtimeRoot)) {
+      const tallyDirs = [join(runtimeRoot, 'state'), runtimeRoot]
+      for (const tallyDir of tallyDirs) {
+      for (const f of (() => { try { return readdirSync(tallyDir) } catch { return [] } })()) {
         const m = f.match(/^friction-tally-(.+)\.json$/);
         if (!m) continue;
         let tally = null;
-        try { tally = JSON.parse(readFileSync(join(runtimeRoot, f), 'utf8')); } catch { continue; }
+        try { tally = JSON.parse(readFileSync(join(tallyDir, f), 'utf8')); } catch { continue; }
         const events = tally && typeof tally === 'object' && tally.events && typeof tally.events === 'object' && !Array.isArray(tally.events) ? tally.events : {};
         const segs = [];
         let total = 0;
@@ -1131,6 +1135,7 @@ export function detectSelfMaintenanceTax(cwd, authoritySpecDir) {
         findings.push(`活跃摩擦：${m[1]}（${segs.join('、')}${lastAt ? `，最近 ${lastAt}` : ''}）`);
         if (total >= TAX_HEAVY_TOTAL) warnings.push(`税重——评估该机制群简化/退役（对照其 decisions 退役判据）：${m[1]}（活跃 total ${total}）`);
       }
+      }
     } catch { /* runtimeRoot 不可读 → 无活跃数据，不误报 */ }
 
     // ② 台账聚合（近 90 天 top5 + 累计总量）；④ 缺失渲染提示不告警
@@ -1748,7 +1753,7 @@ export function writeDoctorDiagnosis(json, specDir) {
   try {
     const runtimeDir = join(specDir, '.runtime');
     mkdirSync(runtimeDir, { recursive: true });
-    const outPath = join(runtimeDir, 'doctor-diagnosis.json');
+    const outPath = runtimeTempPath(runtimeDir, 'doctor-diagnosis.json');
     writeFileSync(outPath, JSON.stringify(json, null, 2) + '\n');
     return outPath;
   } catch (e) {

package/src/flow-draft.js

@@ -23,6 +23,7 @@ import { wrapSection, verifyMarkers, reanchorText, bodyHash, parseMarkerBlocks }
 // 占位句常量真同源（2026-10-03-fr-skeleton-gate 评审 P3 清偿）：起草端 Then 兜底与骨架判据
 // （fr-index.isThinSkeletonBodies）共用同一字面量——两处独立字符串会被评审实证为「镜像非同源」。
 import { SKELETON_THEN_PLACEHOLDER } from './fr-index.js'
+import { runtimeStatePath } from './runtime-paths.js'
 
 /** 读文件并归一化 CRLF→LF（2026-09-25-feedback-fixes④：Python/编辑器写盘 CRLF 会破坏 
  锚定的槽位识别 regex）。 */
@@ -88,7 +89,7 @@ const QUESTION_REPAIR_SIM_THRESHOLD = 0.5
 
 /** sidecar 台账路径（.runtime 下，verify-draft sidecar 同族；命名空间=文件:段键）。 */
 export function draftLedgerPath(runtimeRoot, changeName) {
-  return join(runtimeRoot, `draft-ledger-${changeName}.json`)
+  return runtimeStatePath(runtimeRoot, `draft-ledger-${changeName}.json`)
 }
 
 const AGENT_SLOT = (n, hint) => `<!--AGENT:槽${n} ${hint}——例外裁决书写面（机器段之外合法） -->`

package/src/flow.js

@@ -26,12 +26,13 @@
  * 幂等循 task-done 先例：子步各查自身完成标记，中断半态重入断点续，中段失败精确报告。
  */
 import { existsSync, readFileSync, writeFileSync, readdirSync, appendFileSync, renameSync, statSync } from 'node:fs'
+import { runtimeStatePath, runtimeTempPath } from './runtime-paths.js'
 import { join, relative, dirname } from 'node:path'
 import { DatabaseSync } from 'node:sqlite'
 import yaml from 'js-yaml'
 import { git, gitQuiet } from './git-helper.js'
 import { writeAtomicSync } from './fs-atomic.js'
-import { resolveRuntimeRoot, triggerSync, assertDatedChangeName } from './run/shared.js'
+import { resolveRuntimeRoot, triggerSync, triggerSyncTerminalStrict, assertDatedChangeName } from './run/shared.js'
 import { detectUiTouch, buildUiGuidanceLines, runUiVisualProbe, readUiVisualGate, UI_EVIDENCE_FILENAME } from './ui-visual.js'
 import { runHunkAttributionGate, readHunkGate, renderHunkAttributionLines } from './hunk-attribution.js'
 // 2026-10-13-thin-sync-stage：FLOW_STATE_FILE/readFlowState 单一源上移叶子模块 flow-state.js
@@ -686,18 +687,24 @@ export async function cmdFlowStart({ change, input, title: titleFlag = null, thi
         try {
           const { spawnWatcher } = await import('./watcher.js')
           const w = await spawnWatcher(cwd, change, { specBase })
-          if (w.status === 'spawned') console.log(`🔄 [watcher] 观测旁路已拉起：事件流 .sillyspec/.runtime/watcher-events-${change}.jsonl（恒带 provisional:true）`)
+          if (w.status === 'spawned') console.log(`🔄 [watcher] 观测旁路已拉起：事件流 .sillyspec/.runtime/state/watcher-events-${change}.jsonl（恒带 provisional:true）`)
         } catch { /* 观测旁路 best-effort */ }
-        // adopt 标题（用户需求 2026-09-29）：头脑风暴 proposal 的 H1 是人写语义标题，
-        // deriveTitleFromLinkedChange 提取；--title 优先；兜底变更名。adopt 路径此前完全不
-        // 注册 changes 行——initChange 补插（幂等），既有行 title 空时回填。
+        // adopt 标题（2026-09-29；2026-10-16-short-change-title 提炼；2026-10-16-title-range-gate
+        // 硬区间 10-30）：头脑风暴 proposal H1 人写语义标题（纯模板 H1 回退动机首句）→ --title
+        // 优先（合区间校验，超界 exit 2）→ --input 首行提炼 → 兜底变更名。收编是既成事实的
+        // 延续面，非 flag 的超界不硬断（收编半态不可恢复）打 ⚠️ 强提示。
         try {
-          const { deriveTitleFromLinkedChange, deriveChangeTitle } = await import('./quicklog.js')
-          const adoptTitle = titleFlag || deriveTitleFromLinkedChange(specBase, change) || deriveChangeTitle(input) || change
+          const { deriveTitleFromLinkedChange, deriveShortChangeTitle, isValidChangeTitle, shortTitleRejectMessage, shortTitleRangeWarnLine } = await import('./quicklog.js')
+          if (titleFlag && !isValidChangeTitle(titleFlag)) {
+            console.error(shortTitleRejectMessage(titleFlag))
+            process.exit(2)
+          }
+          const adoptTitle = titleFlag || deriveTitleFromLinkedChange(specBase, change) || deriveShortChangeTitle(input) || change
           pm.initChange(cwd, change, { title: adoptTitle })
           const _arow = pm._ensureDB(cwd).getDb().prepare('SELECT title FROM changes WHERE name = ?').get(change)
           if (_arow && !_arow.title) pm.updateChangeMeta(cwd, change, { title: adoptTitle })
           console.log(`🏷️ 变更标题：${adoptTitle}（收编自头脑风暴产物；重入 --title 可改）`)
+          if (!isValidChangeTitle(adoptTitle)) console.log(shortTitleRangeWarnLine(adoptTitle))
         } catch { /* adopt 标题 best-effort */ }
         const materials = materialPaths(specBase, change, changeDir)
         const artifacts = changeArtifactPaths(changeDir)
@@ -719,7 +726,7 @@ export async function cmdFlowStart({ change, input, title: titleFlag = null, thi
           `② 执行走任务循环：对 tasks.md 每个 pending 行——展示「Working on task N/M: <任务>」→ 做 → 测试绿后当场勾一格（\`- [ ]\`→\`- [x]\`：sillyspec task tick --change ${change} --task task-NN 或直接 Edit）→ 下一行；全勾后 flow done（收口硬门拒单拍多格勾选）。design/decisions 是本变更的承诺锚（flow done 豁免 design 四节槽，以其为准）。`,
           `requirements 测试绑定槽（收编追加）每条 FR 至少一行作答；写码前后顺手填。`,
           `✅ 任务面归你（工作分解契约）：tasks.md 是你的工作队列（机器种子可增删改，保持 \`- [ ] task-NN:\` 行形态）——CLI 以 checkbox 为进度状态机（task tick/flow status 实时读它），TodoWrite 类工具不替代；`,
-          `   勾选是收口证据面（逐格核提交 token/review.json）：做一件 → 勾一格（task tick 即时回显进度与下一任务）→ 继续下一条，勿攒一把勾；`,
+          `   勾选是收口证据面（逐格核提交 token/review.json）：做一件 → 勾一格（task tick 即时回显进度与下一任务）→ 继续下一条，勿攒一把勾；勾选修改与任务交付同一提交入库（pathspec 带上本变更 tasks.md——task tick 回显给现成命令）；`,
           `   任务拟法：收口/推送/发布类动作不单列 task（协议自身承担，成功标准照写 requirements）；确需单列的，勾选前先有消息预埋 task-NN token 的交付提交（回执类证据写进提交消息）。`,
           `   flow status --change ${change} 为自愿查看/恢复面（非协议必需，D-007 中间零必需交互；恢复时给下一任务指针与进度）。`,
           `⚠️ 交付纪律：收口前交付代码显式 pathspec 提交——冻结件范围=baseline..HEAD，未提交不进审计件。`,
@@ -780,17 +787,24 @@ export async function cmdFlowStart({ change, input, title: titleFlag = null, thi
       writeFlowState(changeDir, { autopilot: true })
       console.log(`🤖 已声明 autopilot：spec 断点人审豁免（用户显式声明留痕）`)
     }
-    // 变更标题补写（用户需求 2026-09-29：title=中文概括 ≤50 字，建议 ~20 字）——存量在途
-    // 变更 title 空/缺失时的回填通道：显式 --title 恒生效（重入改标题）；否则从 --input 首
-    // 行推导、仅当库内 title 为空才写（不覆盖已有语义标题）。best-effort 不阻断恢复简报。
+    // 变更标题补写（2026-09-29 title=中文概括；2026-10-16-short-change-title 提炼 ≤30；
+    // 2026-10-16-title-range-gate 硬区间 10-30）——存量在途变更 title 空/缺失时的回填通道：
+    // 显式 --title 恒生效（重入改标题）且必须合区间（超界 exit 2，参数面最易修正）；提炼补写
+    // 仅当库内 title 为空才写（首写者胜），超界不阻断（resume 不可断）打 ⚠️ 强提示。
     try {
-      const { deriveChangeTitle } = await import('./quicklog.js')
+      const { deriveShortChangeTitleEx, isValidChangeTitle, shortTitleRejectMessage, shortTitleRangeWarnLine, SHORT_TITLE_HARDCUT_HINT } = await import('./quicklog.js')
+      if (titleFlag && !isValidChangeTitle(titleFlag)) {
+        console.error(shortTitleRejectMessage(titleFlag))
+        process.exit(2)
+      }
       const _row = pm._ensureDB(cwd).getDb().prepare('SELECT title FROM changes WHERE name = ?').get(change)
       const _cur = _row ? (_row.title || '') : ''
-      const _derived = titleFlag || deriveChangeTitle(input)
-      if (_derived && (titleFlag || !_cur)) {
-        pm.updateChangeMeta(cwd, change, { title: _derived })
-        console.log(`🏷️ 变更标题${titleFlag ? '已更新' : '已补写'}：${_derived}（面板显示用；建议 ~20 字中文概括，重入 --title 可改）`)
+      const _derived = titleFlag ? { title: titleFlag, hardCut: false } : deriveShortChangeTitleEx(input)
+      if (_derived && _derived.title && (titleFlag || !_cur)) {
+        pm.updateChangeMeta(cwd, change, { title: _derived.title })
+        console.log(`🏷️ 变更标题${titleFlag ? '已更新' : '已补写'}：${_derived.title}（面板显示用；须 10-30 字、建议 ~20 字，重入 --title 可改）`)
+        if (_derived.hardCut) console.log(SHORT_TITLE_HARDCUT_HINT)
+        if (!titleFlag && !isValidChangeTitle(_derived.title)) console.log(shortTitleRangeWarnLine(_derived.title))
       }
     } catch { /* 标题补写 best-effort */ }
     // 知识注入（2026-09-25-thin-fr-inject-parity）：resume 路径域路由走基线以来文件面——
@@ -893,16 +907,29 @@ export async function cmdFlowStart({ change, input, title: titleFlag = null, thi
   // 形态信号：清晰度门管「需求说不清楚」（预段收编），升厚只留用户决策（--upgrade-thick 同意门）
   // 与运行时证据（实测失败升档/edit_ratio/评审——风险面在收口时点按承诺词/diff 原语/盲维判定）。
 
-  // 变更标题（用户需求 2026-09-29：title=中文概括 ≤50 字、建议 ~20 字，agent 总结）：
-  // --title 显式指定优先；否则 --input 首行推导（agent 在 input 首行写一句中文概括即为标题）；
-  // 两者皆缺用变更名兜底（可辨识但不达意——横幅提示下次带 --title）。
-  let changeTitle = null
+  // 变更标题硬区间门（2026-10-16-title-range-gate：10-30 字必须、建议 ~20、强制 agent 命名；
+  // 提炼口径见 2026-10-16-short-change-title）：--title 显式 > --input 首行提炼 > 变更名兜底。
+  // agent 命名时刻强制：不在区间/无 --input 兜底 → 拒绝启动（exit 2，在任何状态写入前——
+  // 零半态）；平台 writer 预建空目录（自动派发，无 agent 对话面）豁免硬门仅 ⚠️ 留痕。
+  let _st = null
+  let _rejectMsg = null
   try {
-    const { deriveChangeTitle } = await import('./quicklog.js')
-    changeTitle = titleFlag || deriveChangeTitle(input) || change
-  } catch { changeTitle = titleFlag || change }
+    const _q = await import('./quicklog.js')
+    _st = _q.resolveStartTitle({ titleFlag, input, change, enforce: !proceedFreshEmptyDir })
+    if (!_st.ok) _rejectMsg = _q.shortTitleRejectMessage(_st.kind === 'fallback' ? _st.rejectedTitle : _st.title)
+  } catch { /* quicklog 不可用（实践不可达）：降级保持旧行为兜底 */ _st = { title: titleFlag || change, ok: true, kind: titleFlag ? 'flag' : 'fallback', hardCut: false } }
+  if (_rejectMsg) {
+    console.error(_rejectMsg)
+    process.exit(2)
+  }
+  const changeTitle = _st.title
   pm.initChange(cwd, change, { title: changeTitle })
-  console.log(`🏷️ 变更标题：${changeTitle}${changeTitle === change ? '（变更名兜底——下次带 --title "<≤20 字中文概括>" 更达意）' : '（面板显示用；建议 ~20 字中文概括，重入 flow start --title 可改）'}`)
+  console.log(`🏷️ 变更标题：${changeTitle}（面板显示用；须 10-30 字、建议 ~20 字，重入 flow start --title 可改）`)
+  try {
+    const { isValidChangeTitle, shortTitleRangeWarnLine, SHORT_TITLE_HARDCUT_HINT } = await import('./quicklog.js')
+    if (_st.hardCut) console.log(SHORT_TITLE_HARDCUT_HINT)
+    if (proceedFreshEmptyDir && !isValidChangeTitle(changeTitle)) console.log(shortTitleRangeWarnLine(changeTitle))
+  } catch { /* 提示行 best-effort */ }
   try {
     const { resolveSessionIdentity } = await import('./progress.js')
     const { session } = resolveSessionIdentity({ flagSession: null, cwd })
@@ -915,7 +942,7 @@ export async function cmdFlowStart({ change, input, title: titleFlag = null, thi
   try {
     const { spawnWatcher } = await import('./watcher.js')
     const r = await spawnWatcher(cwd, change, { specBase })
-    if (r.status === 'spawned') console.log(`🔄 [watcher] 观测旁路已拉起：事件流 .sillyspec/.runtime/watcher-events-${change}.jsonl（恒带 provisional:true）`)
+    if (r.status === 'spawned') console.log(`🔄 [watcher] 观测旁路已拉起：事件流 .sillyspec/.runtime/state/watcher-events-${change}.jsonl（恒带 provisional:true）`)
   } catch { /* 观测旁路 best-effort，绝不阻断协议面 */ }
 
   const head = gitQuiet(cwd, ['rev-parse', 'HEAD'])
@@ -1112,13 +1139,13 @@ export async function cmdFlowStart({ change, input, title: titleFlag = null, thi
     `   也有 1/4 抽查采样。要强制/豁免可重启时带 --review / --no-review${reviewForce === true ? '（本变更已声明 --review）' : reviewForce === false ? '（本变更已声明 --no-review）' : ''}。`,
     `⚠️ 交付纪律：收口前先把交付代码用显式 pathspec 提交（git add -- <文件> && git commit）——`,
     `   patch 冻结件范围=baseline..HEAD 提交面，未提交的代码不进审计件（R16 评审 P2 实证）；`,
-    `   tasks.md 一并显式 pathspec 提交（勾选证据进 git 历史，勿 untracked 直至归档——R19 实证）。`,
+    `   tasks.md 一并显式 pathspec 提交（勾选证据进 git 历史，勿 untracked 直至归档——R19 实证；task tick 回显会给现成命令）。`,
     `✅ 任务面归你（工作分解契约，2026-10-07-thin-tasks-v3）：tasks.md 是你的工作队列——机器种子按真实实现路径改写`,
     `   （每行=可独立完成并当场验证的一步：做什么+怎么验证；增删改随意，保持 \`- [ ] task-NN:\` 行形态）；`,
     `   执行循环：对每个未勾行 Working on task N/M → 做一件 → 测试绿后当场勾这一格 → 下一行——CLI 以 checkbox 为进度状态机`,
     `   （sillyspec task tick --change ${change} --task task-NN 即时回显进度 N/M 与下一任务指针，flow status 同源；或直接 Edit 翻格 \`- [ ]\`→\`- [x]\`），watcher 实时上平台。`,
     `   ⚠️ harness 的 TodoWrite 类工具是会话内便利面，不替代 tasks.md——平台进度/收口证据只读它（0/12 事故实证：todo 全 completed 而 tasks.md 0 勾）；`,
-    `   勾选是收口证据面：每格勾选要有对应提交（消息带 task-NN——逐个列出或 /、，连写如 task-01/02/03，「task-01..task-05」区间写法不认）或 review.json，全勾但零证据会被拒收；勿攒一把勾（收口硬门拒单拍多格）；`,
+    `   勾选是收口证据面：每格勾选要有对应提交（消息带 task-NN——逐个列出或 /、，连写如 task-01/02/03，「task-01..task-05」区间写法不认；pathspec 带上本变更 tasks.md——勾选修改与任务交付同一提交入库，task tick 回显会给现成命令）或 review.json，全勾但零证据会被拒收；勿攒一把勾（收口硬门拒单拍多格）；`,
     // 任务拟法指引（2026-10-12-closeout-task-guidance，三次「哨兵抓收口型任务零证据」复盘）：
     // 成功标准≠工作分解——收口/推送/发布是协议自身承担的动作；单列则证据（token 提交）必须先于勾选存在。
     `   任务拟法：收口/推送/发布类动作不单列 task（提交、归档、推送是 flow start→done 协议自身承担的动作——成功标准照写 requirements，勿逐字搬进任务清单）；确需单列的收口/操作型任务，勾选前先做消息预埋 task-NN token 的交付提交——回执类证据（push/publish 回执、构建日志路径）写进提交消息，勿依赖勾选后补；`,
@@ -1177,7 +1204,7 @@ function printRecoveryBriefing({ cwd, specBase, change, changeDir, runtimeRoot,
     ? (gitQuiet(cwd, ['rev-list', '--count', `${st.baseline_commit}..HEAD`]) || '0').toString().trim()
     : '?'
   const dirty = changedFilesSinceBaseline(cwd, st.baseline_commit).length
-  const hasLedger = existsSync(join(runtimeRoot, `verify-quality-scan-${change}.json`))
+  const hasLedger = existsSync(runtimeStatePath(runtimeRoot, `verify-quality-scan-${change}.json`))
   console.log([
     `🔁 flow start 恢复简报（重入）: ${change}（tier=${st.tier}${st.legacy_fallback ? '，legacy_fallback=true 混跑回退中' : ''}）`,
     `══════════════════════════════════════════════════════`,
@@ -1265,7 +1292,7 @@ export async function cmdFlowDone({ change, cwd, specBase, runtimeRootOpt = null
   // 不许在失败面丢失；成功收口走函数末尾同款记录，失败面只多不少）
   const appendTelemetry = (review) => {
     try {
-      appendFileSync(join(runtimeRoot, 'flow-telemetry.jsonl'), JSON.stringify({
+      appendFileSync(runtimeTempPath(runtimeRoot, 'flow-telemetry.jsonl'), JSON.stringify({
         ts: new Date().toISOString(), change, protocolCalls: 2,
         draftAmendments: st.edit_ratio != null ? 1 : 0, editRatio: st.edit_ratio ?? null,
         routeHint: st.route_hint ?? null, tier: st.tier, upgraded: st.upgrade_reason ?? null,
@@ -1369,6 +1396,22 @@ export async function cmdFlowDone({ change, cwd, specBase, runtimeRootOpt = null
     let _sentinelNonMirrorTasks = null // 镜像豁免面外的任务数（null=哨兵未跑；0=纯镜像任务面——节奏 advisory 静默）
     let _sentinelEvidenceComplete = false // 哨兵证据完备（status=complete——每格已勾任务均有 token/review.json）：单拍降级判据（2026-10-13-batchtick-evidence-domain-hint）
     let _autopilotTicked = 0 // 机器代勾格数（>0 时勾选节奏门降 advisory——代勾是单拍多格机械写，非 agent 纪律面）
+    // 勾选观测共享采集（2026-10-17-tick-timing-source）：watcher 事件流 + task-ticks.jsonl 侧车
+    // 一次读取——时点判定与勾选节奏门同源消费（此前节奏门单独读，现两门一份数据；检测逻辑
+    // 与优先序不变：事件流先判、空结果回退侧车突发）。侧车=CLI tick 逐格毫秒时戳事实源（随
+    // 归档进 git、不受观测盲窗影响）。任一源缺失按空（fail-open），绝不阻断收口。
+    const _tickObs = await (async () => {
+      try {
+        const { readWatcherEvents } = await import('./watcher.js')
+        const { detectBatchCheckCadence, detectTickBurst } = await import('./sentinel-assertions.js')
+        const stream = readWatcherEvents({ runtimeRoot, change })
+        let ticks = []
+        try { ticks = (await import('./timeline.js')).parseTickLog(readFileSync(join(changeDir, 'task-ticks.jsonl'), 'utf8')) } catch { /* 侧车缺失/不可读按空（fail-open） */ }
+        let batch = stream.exists ? detectBatchCheckCadence(stream.events) : null
+        if (!batch) batch = detectTickBurst(ticks)
+        return { stream, ticks, batch }
+      } catch { return { stream: { exists: false, events: [] }, ticks: [], batch: null } }
+    })()
     // 证据面=整条提交消息（2026-09-25-thin-done-gate-calibration 坑2：%s 只取标题行，正文里的
     // token 被判零证据，与文案「提交带 task-NN」口径漂移）——%B%x1e 按提交切记录，advisory 的
     // 提交计数不因多行正文失真。
@@ -1436,20 +1479,31 @@ export async function cmdFlowDone({ change, cwd, specBase, runtimeRootOpt = null
         if (sent.status === 'complete') {
           _sentinelEvidenceComplete = true
           console.log(`🛡️ 哨兵：全勾 ${sent.checked}/${sent.claimTotal} 证据齐（提交 token/review.json）`)
-          // 勾选时点判定（2026-09-26-tick-loop-nudge，R19 行为发现）：tasks.md 的 git 首次提交
-          // == 收口窗口最后提交（一把勾模式）→ 放行但打行为提醒（不阻断——token 证据已验，
-          // 这是提醒边干边勾纪律，非假勾）。tasks.md 全程 untracked（未随交付提交）时同款提醒。
-          // 首提锚定（2026-10-07-tick-timing-first-commit）：--reverse 全 history 首行=首次提交——
-          // 旧实现 -n 1 取最近一次提交，每任务随交付提交 tasks.md 的渐进形态（首提早于 HEAD）
-          // 被误报一把勾（完整实测实证：历史 0→1→2 渐进勾选仍出警告）。
+          // 勾选时点判定（2026-10-17-tick-timing-source 换源）：判据从「tasks.md git 首次提交
+          // == 收口最后提交」整体退役——git 历史形态被官方允许的 reset --soft 压扁无声摧毁
+          // （tick-timing-squash-blindspot 坑：并行会话压扁归档把边干边勾的渐进历史抹平，警告
+          // 照出，结构性误报；且 tasks.md 不进交付 pathspec 的纪律下「untracked 直至归档」恒
+          // 复现）。换源=task-ticks.jsonl 侧车墙钟时戳（detectTickTiming 纯函数：跨度超 120s
+          // =边干边勾确认；挤 ≤120s 短窗且变更存活 ≥10×跨度=末尾集中勾选）——墙钟时戳是文件
+          // 事实，压扁/rebase 不可改写，与「审计真相锚 change.patch sha256、不依赖 git 形态」
+          // 口径对齐。节奏门已检出单拍跳/突发时让位（防双重警告——其判定覆盖同一批格子）；
+          // 无侧车观测输出一行 task tick 教学（不再作结构性警告）；advisory 不阻断语义不变。
           try {
-            const _firstRaw = gitQuiet(cwd, ['log', '--reverse', '--format=%h', '--', tasksPath])
-            const tasksIn = _firstRaw ? (String(_firstRaw).split(/\r?\n/).map((x) => x.trim()).filter(Boolean)[0] || null) : null
-            const lastIn = gitQuiet(cwd, ['log', '--format=%h', '-n', '1'])
-            if (!tasksIn) {
-              console.warn(`⚠️ 勾选时点：tasks.md 未随交付提交（untracked 直至归档）——勾选证据链靠归档兜底，git 历史不可回溯；下次收口前 tasks.md 一并显式 pathspec 提交`)
-            } else if (String(tasksIn).trim() === String(lastIn).trim()) {
-              console.warn(`⚠️ 勾选时点：tasks.md 的首次 git 提交 == 收口最后提交（一把勾模式）——token 证据齐放行，但边干边勾是进度锚（OS Guardrails 同款纪律），下次完成单元即勾`)
+            if (_tickObs.batch) {
+              /* 节奏门将报单拍多格/突发——时点判定让位 */
+            } else {
+              const _baseRaw = st && st.baseline_commit ? gitQuiet(cwd, ['show', '-s', '--format=%ct', String(st.baseline_commit)]) : null
+              const _baseTs = Number(String(_baseRaw ?? '').trim())
+              const { detectTickTiming } = await import('./sentinel-assertions.js')
+              const t = detectTickTiming({ ticks: _tickObs.ticks, lifespanMs: Number.isFinite(_baseTs) && _baseTs > 0 ? Date.now() - _baseTs * 1000 : NaN })
+              if (t.status === 'concentrated') {
+                console.warn(`⚠️ 勾选时点：${t.count} 格勾选时戳集中在 ${Math.max(1, Math.round(t.spanMs / 1000))}s 短窗内（末尾集中勾选形态）——token 证据齐放行，但边干边勾是进度锚，下次完成单元即勾（task tick 回显含现成提交命令）`)
+              } else if (t.status === 'spread') {
+                console.log(`✅ 勾选时点：${t.count} 格勾选时戳跨度 ${Math.max(1, Math.round(t.spanMs / 60000))} 分钟——边干边勾确认（判据=task-ticks 侧车墙钟时戳，不受 git 压扁影响）`)
+              } else if (t.status === 'no-ticks') {
+                console.log(`ℹ️ 勾选时点：无 tick 时戳观测（未走 task tick）——下次勾选建议 sillyspec task tick --change ${change} --task task-NN（即时回显进度与现成提交命令）`)
+              }
+              /* 'single'/'no-anchor' 静默：单格无节奏可言；缺存活锚 fail-open 不判 */
             }
           } catch { /* 时点判定 fail-soft */ }
         }
@@ -1459,7 +1513,7 @@ export async function cmdFlowDone({ change, cwd, specBase, runtimeRootOpt = null
         // 任务面与实际不符可先改写 tasks.md（工作分解归 agent）再逐格勾。token 代勾（governance-
         // autopilot）已在上方先跑：有证据未勾的格子已代勾，此处拒的纯属零证据未完成面。
         if (sent.claimTotal > 0 && sent.checked < sent.claimTotal) {
-          console.error(`🚫 任务未全勾（${sent.checked}/${sent.claimTotal}）——tasks.md 是完成状态机：完成一件勾一格（每格勾选需对应提交带 task-NN token 或 review.json），全勾后重跑 flow done`)
+          console.error(`🚫 任务未全勾（${sent.checked}/${sent.claimTotal}）——tasks.md 是完成状态机：完成一件勾一格（每格勾选需对应提交带 task-NN token 或 review.json；提交 pathspec 带上本变更 tasks.md——勾选修改与任务交付同一提交入库），全勾后重跑 flow done`)
           console.error('   任务面与实际实现路径不符时，先改写 tasks.md（工作分解归你，增删改随意）再逐格勾；查下一任务：sillyspec task tick --change ' + `${change}` + ' --task task-NN（回显进度与指针）')
           appendTelemetry({ sentinel: 'incomplete-tasks', checked: sent.checked, total: sent.claimTotal })
           reportMidFail('ledger')
@@ -1477,19 +1531,12 @@ export async function cmdFlowDone({ change, cwd, specBase, runtimeRootOpt = null
     // 侧车突发回退（2026-10-14-tick-burst-sidecar-gate）：CLI 收口端快连点对事件流不可见（单格
     // 精确跳），空结果时回退 task-ticks.jsonl 毫秒时戳判突发——CLI 与直接 Edit 两条路径同判。
     try {
-      const { readWatcherEvents } = await import('./watcher.js')
-      const { detectBatchCheckCadence, detectTickBurst, resolveBatchTickAction } = await import('./sentinel-assertions.js')
-      const stream = readWatcherEvents({ runtimeRoot, change })
-      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） */ }
-      }
+      const { resolveBatchTickAction } = await import('./sentinel-assertions.js')
+      // 观测消费共享采集（2026-10-17-tick-timing-source）：事件流/侧车/突发判定已在前文哨兵段
+      // 前置采集为 _tickObs（时点判定与节奏门同源一份数据；读取仅前移，检测逻辑与优先序不变
+      // ——事件流先判、空结果回退侧车突发，侧车缺失按空 fail-open）。
+      const stream = _tickObs.stream
+      const batch = _tickObs.batch
       if (batch) {
         // 代勾计数取「本拍实时代勾 ∨ 持久化代勾」较大者（二轮 P2-B：重入漂移防护）；决策纯函数
         // 单源（resolveBatchTickAction）四态与豁免优先序见其 JSDoc——代勾须解释整跳才降级
@@ -2449,7 +2496,7 @@ export async function cmdFlowDone({ change, cwd, specBase, runtimeRootOpt = null
   // ⑥ events：事件收口（watcher 观测旁路 best-effort 读回，非真相源）
   if (st.substeps?.events === 'done') { skip('events') } else {
     try {
-      const eventsPath = join(runtimeRoot, `watcher-events-${change}.jsonl`)
+      const eventsPath = runtimeStatePath(runtimeRoot, `watcher-events-${change}.jsonl`)
       if (existsSync(eventsPath)) {
         const n = readFileSync(eventsPath, 'utf8').split('\n').filter(Boolean).length
         console.log(`📊 watcher 事件收口：${n} 条 provisional 事件在案（.runtime 留档，平台展示面）`)
@@ -2483,8 +2530,10 @@ export async function cmdFlowDone({ change, cwd, specBase, runtimeRootOpt = null
       console.log(`   注：knowledge「最近确认」hash 为溯源快照，压扁后成孤儿引用属预期（非活引用）。`)
     }
   } catch { /* 指引 best-effort */ }
-  // 平台同步（同 flow start 尾部接线——归档后的 docs/knowledge/FR 面随本轮回推平台）
-  try { await triggerSync(cwd, change) } catch { /* 同步绝不阻断协议面 */ }
+  // 平台同步（同 flow start 尾部接线——归档后的 docs/knowledge/FR 面随本轮回推平台）。
+  // 终态强校验（2026-10-17-archive-half-state-location-stuck-active）：flow done 到此 =
+  // 变更已归档，文件树推送失败不再静默半态（🚨 告警 + 自救命令 + exit 1）
+  try { await triggerSyncTerminalStrict(cwd, change) } catch { /* 同步绝不阻断协议面 */ }
   return { change, substeps: doneList }
 }
 
@@ -2663,7 +2712,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 "<一句 10-30 字中文概括（首行即变更标题，硬区间 10-30 必须、建议 ~20 字）；随后动机与背景')
         console.error('')
         console.error('   成功标准：')
         console.error('   - <可验证标准>"')
@@ -2892,9 +2941,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 "<一句 10-30 字中文概括（首行即变更标题，硬区间 10-30 必须、建议 ~20 字）＋动机与背景详述＋独立一行『成功标准：』＋每行一条『- 可验证标准』>" [--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 "<一句 10-30 字中文概括（首行即变更标题，硬区间 10-30 必须、建议 ~20 字）；随后动机与背景')
   console.error('')
   console.error('      成功标准：')
   console.error('      - <可验证标准>"')