sillyspec 3.29.5 → 3.30.0

package/src/command-cards.js

@@ -9,7 +9,8 @@ import { createHash } from 'crypto'
 import { writeAtomicSync } from './fs-atomic.js'
 
 export const COMMAND_CARD_TARGETS = { zcode: '.zcode/commands/sillyspec', claude: '.claude/commands/sillyspec' }
-export const COMMAND_CARD_NAMES = ['run-brainstorm', 'run-plan', 'run-execute', 'run-verify', 'run-archive', 'run-quick', 'status']
+// flow=轻量变更默认道入口卡（2026-09-25-quick-channel-retire 配套：quick 退役后快道首次有卡）
+export const COMMAND_CARD_NAMES = ['flow', 'run-brainstorm', 'run-plan', 'run-execute', 'run-verify', 'run-archive', 'run-quick', 'status']
 
 const ANCHOR_TAIL_RE = /\n?<!-- sillyspec-card: v(\S+) sha256=([0-9a-f]{64}) -->\s*$/
 const sha256 = (s) => createHash('sha256').update(s, 'utf8').digest('hex')

package/src/commit-guard.js

@@ -85,6 +85,8 @@ function main() {
       // stderr 必须管道化：execFileSync 默认把子进程 stderr 透传给父进程——非 git 目录下
       // git 落 --no-index 模式报 unknown option 的 usage 长文会漏进守卫 stderr（噪声）。
       stdio: ['ignore', 'pipe', 'pipe'],
+      windowsHide: true,
+    stdio: ['ignore', 'pipe', 'pipe'],
     })
       .split(/\r?\n/)
       .map((s) => s.trim())

package/src/config-schema.js

@@ -68,8 +68,10 @@ export const LOCAL_YAML_SCHEMA = {
       note: 'detect 核验 package.json(或对应构建文件) scripts 存在性后才写对应键；缺失则不写。agent 可改。',
       keys: [
         { path: 'commands.build', type: 'string', optional: true, status: 'live', readers: ['detectLocalYaml (src/local-detect.js)', 'validateCommands (src/scan-postcheck.js)'], desc: '构建命令。', example: 'npm run build' },
-        { path: 'commands.test', type: 'string', optional: true, status: 'live', readers: ['extractTestCommand (src/verify-postcheck.js)', 'runQuickTestLintGate (src/run/quick-audit.js)', 'validateCommands (src/scan-postcheck.js)'], desc: '测试命令——verify 阶段 CLI 亲自执行此命令与 verify-result.md 对账，实测失败即阻断；quick --done 触及 src/test 时同款实测（P0-2 门禁）。', example: 'npm test' },
+        { path: 'commands.test', type: 'string', optional: true, status: 'deprecated', readers: ['extractTestCommand (src/verify-postcheck.js)', 'validateCommands (src/scan-postcheck.js)'], desc: '【2026-09-26-dynamic-test-inference 退役为全量逃生阀】仅显式 test_strategy: full 时生效——测试面缺省按变更动态推断（本变更测试 ∪ FR 关联回归 ∪ import 依赖，runner 自项目结构推断），不再依赖此配置；未配置且显式 full 时按 package.json scripts.test / pyproject 结构推断全量命令。', example: 'npm test' },
         { path: 'commands.lint', type: 'string', optional: true, status: 'live', readers: ['detectLocalYaml (src/local-detect.js)', 'runQuickTestLintGate (src/run/quick-audit.js)', 'validateCommands (src/scan-postcheck.js)'], desc: 'lint 命令——quick --done 触及 src/test 时 CLI 亲自执行（P0-2 门禁，失败阻断完成）。', example: 'npm run lint' },
+        { path: 'commands.test_timeout_sec', type: 'number', optional: true, status: 'live', readers: ['resolveTestTimeoutMs (src/verify-postcheck.js)'], desc: 'commands.test 超时秒数（R9 实证 2026-09-23：全量套件实测可达 27min，固定 600s 帽必杀）——优先级 local.yaml 本键 > env SILLYSPEC_TEST_TIMEOUT_MS > 缺省 600。慢仓在此提帽，防真慢套件被当超时失败。', example: '2400' },
+        { path: 'commands.lint_timeout_sec', type: 'number', optional: true, status: 'live', readers: ['runVerifyLintCheck (src/verify-postcheck.js)'], desc: 'commands.lint 超时秒数——优先级 显式调用参 > 本键 > env SILLYSPEC_LINT_TIMEOUT_MS > 缺省 180（快照内 junction I/O 慢，快照路径调用侧显式传 300）。', example: '600' },
         { path: 'commands.smoke', type: 'string', optional: true, status: 'live', readers: ['executeVerifyQualityScan (src/run/verify-quality-scan.js)'], desc: '接口冒烟命令——verify 阶段 CLI 亲跑（脚本自理服务生命周期：后台起服+轮询就绪+finally 杀），300s 超时帽，失败/超时只记失败态不阻断本步、触发 PASS 封顶（D-002）；指纹含此键，未变不重跑。', example: 'node scripts/smoke.mjs' },
         { path: 'commands.install', type: 'string', optional: true, status: 'live', readers: ['extractInstallCommand (src/worktree-deps.js)'], desc: '依赖安装命令（worktree 依赖 provisioning 用）。', example: 'npm install' },
       ],
@@ -110,7 +112,7 @@ export const LOCAL_YAML_SCHEMA = {
       note: 'test_strategy: module 时，按 git diff 命中的模块子集收窄测试。只支持 inline flow 形态（extractModules 不解析嵌套展开式）。',
       keys: [
         { path: 'modules.<name>.path', type: 'string', optional: true, status: 'live', readers: ['extractModules (src/verify-postcheck.js)', 'parseLocalYamlModules (src/plan-postcheck.js)', 'extractModulePaths (src/worktree-deps.js)'], desc: '子模块目录路径（相对仓库根）。', example: 'frontend/' },
-        { path: 'modules.<name>.test', type: 'string', optional: true, status: 'live', readers: ['extractModules (src/verify-postcheck.js)'], desc: '该子模块的测试命令。', example: 'cd frontend && pnpm test' },
+        { path: 'modules.<name>.test', type: 'string', optional: true, status: 'deprecated', readers: ['extractModules (src/verify-postcheck.js，退役提示用）'], desc: '【2026-09-26-dynamic-test-inference 退役，不再消费】测试面按变更动态推断、runner 自项目结构（pyproject/uv.lock/package.json 就近祖先）推断。模块级 flaky 处置迁 known_failures。块在场时 CLI 打印退役指引。', example: 'cd frontend && pnpm test' },
       ],
     },
     {
@@ -118,7 +120,7 @@ export const LOCAL_YAML_SCHEMA = {
       title: '测试策略',
       note: 'verify 阶段 CLI 对账的收窄策略（D-005@v2：skip 接线兑现 + evidence-auto 新增，full/module 语义不变）。',
       keys: [
-        { path: 'test_strategy', type: 'enum', values: ['full', 'module', 'skip', 'evidence-auto'], optional: true, status: 'live', readers: ['extractTestStrategy (src/verify-postcheck.js)', 'resolveTestStrategy (src/verify-postcheck.js)'], desc: 'full=全量 commands.test；module=按 git diff 命中 modules 子集收窄（需配 modules）；skip=真跳过测试（不回退全量，verify 输出显式标注留审计痕迹，R-07）；evidence-auto=按变更目录 module-impact.md 影响类型推荐检查组合（行为→module 聚焦测试、文档/prompt→docs-check、门禁契约→gate；缺失/不可解析降级 module 并注记）。缺省：配了 modules: 块 → module（v3.29.3 起缺省收窄，ql-20260920-010）；未配 modules → 全量。', example: 'full' },
+        { path: 'test_strategy', type: 'enum', values: ['full', 'module', 'skip', 'evidence-auto'], optional: true, status: 'live', readers: ['extractTestStrategy (src/verify-postcheck.js)', 'resolveTestStrategy (src/verify-postcheck.js)'], desc: '【2026-09-26-dynamic-test-inference 起】full=全量（commands.test 在场生效，否则结构推断）；module=已退役折算动态子集（超集覆盖：变更文件面收窄 + FR 关联回归 + import 依赖）；skip=真跳过（R-07 不变）；evidence-auto=按 module-impact.md 推荐（行为→动态子集、文档/门禁→skip）。缺省=动态子集：三源并集非空实测、空则不硬跑全量（防超时/预存失败面）。', example: 'full' },
       ],
     },
     {
@@ -127,6 +129,8 @@ export const LOCAL_YAML_SCHEMA = {
       note: '变更前就失败的测试行，豁免后不计入 verify 阻断。支持块列表或 inline 数组。务必定期复核，避免误豁免本变更引入的真实失败。',
       keys: [
         { path: 'known_failures', type: 'array', optional: true, status: 'live', readers: ['extractKnownFailures (src/verify-postcheck.js)'], desc: '失败行模式列表（匹配测试输出失败行）。', example: 'tests/some-old-test' },
+        { path: 'ui_visual_gate', type: 'string', optional: true, status: 'live', readers: ['runUiVisualProbe (src/ui-visual.js)'], desc: '【2026-09-27-ui-visual-guidance】UI 视觉证据分级门档位：warn（默认，缺 visual-evidence.md 仅警告）/ error（缺证据即阻断）/ off（探针整体关闭，含降级硬规则）。视觉降级无用户裁决留痕时无论档位恒阻断。', example: 'warn' },
+        { path: 'hunk_gate', type: 'string', optional: true, status: 'live', readers: ['runHunkAttributionGate (src/hunk-attribution.js)'], desc: '【2026-09-27-hunk-attribution-gate】提交面行级归属门档位：warn（默认，未归因文件/跨变更竞争/在途残留仅警告）/ error（未归因与跨变更竞争任一在场阻断收口；在途残留恒仅警告——并发 WIP 弱信号不硬拦）/ off（关闭）。', example: 'warn' },
       ],
     },
     {
@@ -151,6 +155,9 @@ export const LOCAL_YAML_SCHEMA = {
       note: 'gitignore 生成物（如构建期产出的 src/build-id.ts）不在 git 树也不进 untracked overlay（ls-files --others --exclude-standard 尊重 .gitignore），worktree 缺失致构建炸 Failed to load url——create 期按本清单从主仓复制供给（2026-09-15-worktree-dual-truth-gates 坑③，D-003@v1）。块列表或 inline flow 数组均可解析。',
       keys: [
         { path: 'worktree.supplyFiles', type: 'array', optional: true, status: 'live', readers: ['readSupplyFilesConfig + _supplyGeneratedFiles (src/worktree.js — create step 5.9 供给步)'], desc: '随 worktree create 从主仓复制的生成物清单：精确路径或 glob（* 单层 / ** 多层），相对仓根。展开上限 200 文件超出截断警告；实供清单记 meta.supplyFiles；缺省 [] = 供给步空转零行为变化。', example: 'src/build-id.ts' },
+        { path: 'worktree.policy.adopt_branch', type: 'boolean', optional: true, status: 'live', readers: ['readWorktreePolicy (src/worktree-policy.js) → WorktreeManager.create 分支冲突守卫 (src/worktree.js)'], desc: '分支已存在冲突的选择记忆：true = 自动收编既有分支（等效常备 --adopt-branch，meta 记 adoptViaPolicy 留痕）。缺省 false = 既有三选一 fail-closed 菜单。显式 flag 优先于 policy。', example: 'true' },
+        { path: 'worktree.policy.apply_overlap', type: 'enum', values: ['manual', 'force', 'skip'], optional: true, status: 'live', readers: ['readWorktreePolicy (src/worktree-policy.js) → applyWorktree guard 相交拦截 (src/worktree-apply.js)'], desc: 'apply 与活跃 quick 会话在途声明相交时的处置记忆：manual（缺省）= 既有 fail-closed 报错；force = 放行并留痕（overlapForced.via 记 policy 来源）；skip = 无人值守软跳过（同 autoApply 路径）。--force 显式 flag 优先。', example: 'manual' },
+        { path: 'worktree.policy.stash_dirty', type: 'boolean', optional: true, status: 'live', readers: ['readWorktreePolicy (src/worktree-policy.js) → applyWorktree 4.4 stash 段 (src/worktree-apply.js)'], desc: '主仓在途改动自动 stash 的选择记忆：true = 等效常备 --stash-dirty（stash SHA 显著打印 + 失败绝不 drop）。缺省 false = 显式 flag opt-in。', example: 'false' },
       ],
     },
     {
@@ -162,6 +169,25 @@ export const LOCAL_YAML_SCHEMA = {
         { path: 'gate_snapshot.commands', type: 'array', optional: true, status: 'live', readers: ['parseGateSnapshotCommands + runGateSnapshotCommands (src/run/gate-snapshot.js — createGateSnapshot 环境预检后 copy 面前)'], desc: '门禁隔离快照的命令面（元素 string）：快照构建期在环境目录链接后、copy 面前于快照根逐条执行（cwd=快照根、300s/条超时帽、非零退出/超时只 warn 继续——fail-open 不作废快照），产出「本仓应然态」生成物，收口主仓生成物缺失/过期（fresh clone 未跑 postinstall / build-id 类产物）时快照内全量 lint/test 必挂的坑（D-002@v2，2026-09-17-feedback-hardening FR-01）。⚠️ 环境目录（node_modules/venv）是活链接，命令写它们会穿透主仓——只放生成物命令（npm run gen:build-id 类），不放 install/build 全家桶。未配置 = 全段空转零行为。', example: 'npm run gen:build-id' },
       ],
     },
+    {
+      id: 'flow',
+      title: '2-调用轻量协议（R7 切片二）',
+      note: 'flow start/done 协议形状开关与路由参数。design 措辞 flow: thin|legacy 落地为单键 flow.mode（YAML 单键形态，语义一致）。',
+      keys: [
+        { path: 'flow.mode', type: 'enum', values: ['thin', 'legacy'], optional: true, status: 'live', readers: ['readFlowConfig (src/flow.js)'], desc: '2-调用轻量协议开关：thin（缺省——2026-09-25-thin-default-flip 翻转，入口归一：常规变更默认轻量跑道，需求不清晰 CLI 拦下指路头脑风暴预段，实测失败自动升厚）= flow start/done 轻量跑道；legacy = 显式回旧道（run <stage> 全族行为逐字不动，flow start 拒跑并指路）。切回一行 yaml。', example: 'thin' },
+        { path: 'flow.edit_ratio_threshold', type: 'number', optional: true, status: 'live', readers: ['readFlowConfig (src/flow.js)'], desc: '机器稿改写比例路由阈值（amend 通道计算的行级 editRatio 超阈 → 厚档提示 route_hint）。缺省 0.5。', example: '0.5' },
+        { path: 'flow.edit_ratio_enforcement', type: 'enum', values: ['advisory', 'block'], optional: true, status: 'live', readers: ['readFlowConfig (src/flow.js)'], desc: 'editRatio 超阈的执行档：advisory（缺省——测绿可轻量档过，只提示+遥测）| block（超阈阻断 flow done）。用户裁定 advisory 定案，dogfood 后可按遥测翻 block。', example: 'advisory' },
+      ],
+    },
+    {
+      id: 'stage',
+      title: '阶段说明书下发与会话墙',
+      note: 'run <stage> 渲染与阶段边界行为开关。burst 管「一次下发多少说明书」；wall 管「阶段边界要不要强制换会话」（瘦会话模式强制力）。',
+      keys: [
+        { path: 'stage.burst', type: 'boolean', optional: true, status: 'live', readers: ['readStageBurst (src/run/shared.js)'], desc: 'burst 模式：一次渲染阶段内全部剩余步骤说明书、一次 --done 收口（CLI 内部循环逐步推进）。R13 对撞实测：CLI 往返锐减（×19→×4）但 token 反创系列新高（单次载荷变肥 + 逐轮全量回放）——只减往返不减 token，非默认推荐（体验项）。env SILLYSPEC_STAGE_BURST=0/1 强制。', example: 'false' },
+        { path: 'stage.wall', type: 'enum', values: ['advisory', 'hard'], optional: true, status: 'live', readers: ['readStageWall (src/run/shared.js) + runStage 入口墙 (src/run/stage.js)'], desc: '阶段边界会话墙：advisory（缺省）= 阶段完成时提示可 handoff 换会话，不阻断；hard = 同一会话（SILLYSPEC_SESSION_ID 相同）刚收口前驱阶段后硬续墙后阶段（execute/verify）→ run <stage> 拒启动（exit 1），指引 sillyspec handoff 生成交接块换新会话续跑；--same-session 显式逃生口（应急/平台编排）。墙后阶段 = execute/verify（上下文最贵两段：R15 实测 execute 均轮 263K，断崖拆会话后回落 120-170K）。stage-session ledger 缺失/会话标识不可判定 → 放行（fail-open，与账本 best-effort 一致）。', example: 'hard' },
+      ],
+    },
     {
       id: 'auto_mode',
       title: '变更规模自动分类',
@@ -334,6 +360,8 @@ commands:
   lint: npm run lint
   # smoke: node scripts/smoke.mjs   # verify 冒烟命令（可选；脚本自理服务生命周期，失败只封顶 PASS 不阻断）
   # install: npm install   # worktree 依赖安装命令
+  # test_timeout_sec: 2400   # commands.test 超时秒数（慢仓提帽；缺省 600，env SILLYSPEC_TEST_TIMEOUT_MS 同效）
+  # lint_timeout_sec: 600    # commands.lint 超时秒数（缺省 180）
 
 # ── SillyHub MCP 客户端凭据（派发到 worker 用）──
 # agent 手填，或 sillyspec platform connect 在 mcp 段缺失时同源自动填。
@@ -355,17 +383,41 @@ dispatch:
   # poll_interval_ms: 15000   # ⚠ 路径A 预留·未落地，配了暂不生效
   # worker_timeout_ms: 60000  # ⚠ 路径A 预留·未落地，配了暂不生效
 
-# ── monorepo 子模块映射（test_strategy: module 时按 git diff 命中模块收窄测试）──
-# 只支持 inline flow 形态（嵌套展开式解析不出）：
-modules:
-  frontend: { path: "frontend/", test: "cd frontend && pnpm test" }
-  backend: { path: "backend/", test: "cd backend && npm test" }
+# ── 2-调用轻量协议（R7 切片二；缺省 thin 即轻量跑道，无需配置）──
+# flow:
+#   mode: thin               # thin=flow start/done 轻量跑道（协议必需交互=2）| legacy=既有 run <stage> 全族（回滚一行）
+#   edit_ratio_threshold: 0.5   # 机器稿改写比例路由阈值（超阈提示厚档；缺省 0.5）
+#   edit_ratio_enforcement: advisory   # advisory=测绿可轻量过只提示（缺省）| block=超阈阻断
+
+# ── 阶段说明书下发与会话墙（R16 减负批次）──
+# stage:
+#   # burst: true   # 一次下发全阶段说明书（R13 实测：往返↓ token↑，体验项非默认）
+#   # wall: hard    # 阶段边界会话墙（hard=同会话硬续 execute/verify 拒启动，指引 handoff；缺省 advisory 提示不阻断）
+
+# ── worktree 守卫选择记忆（R16 减负批次；显式 flag > policy > fail-closed 缺省）──
+# worktree:
+#   policy:
+#     # adopt_branch: true    # 分支已存在冲突自动收编（等效常备 --adopt-branch）
+#     # apply_overlap: manual # manual=fail-closed（缺省）| force=放行留痕 | skip=软跳过
+#     # stash_dirty: false    # true=主仓在途改动自动 stash（等效常备 --stash-dirty）
 
-# ── 测试策略（verify 实测收窄；full/module 语义不变，skip/evidence-auto 为 2026-08-23 新增）──
-# full=全量 commands.test | module=按命中模块收窄（需配 modules）
+# ── 测试策略（2026-09-26-dynamic-test-inference 起）──
+# 缺省=动态子集：本变更测试 ∪ FR 关联回归（active FR 覆盖面∩触碰文件→绑定 tests）∪ import 依赖，
+#   runner 自项目结构推断（pyproject/uv.lock/package.json 就近祖先）——modules.*.test 与 commands.test
+#   均不再需要（后者仅显式 full 时作全量逃生阀）。三源空（doc-only）不硬跑全量。
+# full=全量（commands.test 在场生效，否则按 package.json scripts.test / pyproject 推断）
 # skip=真跳过测试（不回退全量，verify 输出显式标注留审计痕迹）
-# evidence-auto=按变更 module-impact.md 影响面推荐检查组合（行为→module 聚焦测试、文档→docs-check、门禁→gate；缺失降级 module）
-test_strategy: full
+# evidence-auto=按变更 module-impact.md 影响面推荐（行为→动态子集、文档→docs-check、门禁→gate）
+# test_strategy: full   # 缺省注释态=动态子集（评审 P3-5 清偿：复制即全量道的自相矛盾陷阱——缺省注释才与上方「缺省=动态子集」一致）；确要全量再解注释
+
+# ── 证据门档位（2026-09-27-ui-visual-guidance / 2026-09-27-hunk-attribution-gate；注释态=缺省档位生效）──
+# ui_visual_gate: warn   # UI 视觉证据分级门：warn（缺省，缺 visual-evidence.md 仅警告）| error（缺证据即阻断）| off（探针整体关闭；视觉降级无用户裁决留痕时无论档位恒阻断）
+# hunk_gate: warn        # 提交面行级归属门：warn（缺省）| error（未归因文件/跨变更竞争任一在场阻断收口；在途残留恒仅警告——并发 WIP 弱信号不硬拦）| off（关闭）
+
+# ── monorepo 子模块路径映射（.path 仍被 plan/worktree-deps 消费；.test 已退役勿再配）──
+modules:
+  frontend: { path: "frontend/" }
+  backend: { path: "backend/" }
 
 # ── 决策库 behind 复核阈值（docs-check 决策规则：源码在「最近确认」后前进超阈值 → 待复核提示；缺省 10）──
 decisions:

package/src/db.js

@@ -7,7 +7,7 @@ import { dirname } from 'path';
 // 每次 new ProgressManager 都过 init，靠版本戳跳过建表省开销）。
 // node:sqlite（DatabaseSync）是原生 SQLite 引擎，打开即持久化（不像 sql.js 纯内存需整库 export 落盘），
 // _createSchema 内 DDL 直接落盘，无需额外 _save。
-const DB_SCHEMA_VERSION = 6;
+const DB_SCHEMA_VERSION = 8;
 
 // SQLITE_BUSY 应用层有限重试（R-08 / NFR-03）：WAL 单写者模型，并发写第二者在
 // busy_timeout=5000（init PRAGMA）后抛 SQLITE_BUSY。busy_timeout 已在引擎层处理大部分等待；
@@ -252,7 +252,7 @@ export class DB {
       CREATE TABLE IF NOT EXISTS project (
         id INTEGER PRIMARY KEY DEFAULT 1,
         name TEXT NOT NULL,
-        schema_version INTEGER DEFAULT 6,
+        schema_version INTEGER DEFAULT 8,
         created_at TEXT NOT NULL,
         updated_at TEXT NOT NULL
       )
@@ -263,7 +263,7 @@ export class DB {
       CREATE TABLE IF NOT EXISTS changes (
         id INTEGER PRIMARY KEY AUTOINCREMENT,
         name TEXT UNIQUE NOT NULL,
-        current_stage TEXT DEFAULT 'scan',
+        current_stage TEXT DEFAULT 'brainstorm',
         status TEXT DEFAULT 'active',
         no_worktree INTEGER DEFAULT 0,
         created_at TEXT NOT NULL,
@@ -285,6 +285,8 @@ export class DB {
         status TEXT DEFAULT 'pending',
         started_at TEXT,
         completed_at TEXT,
+        authority TEXT NOT NULL DEFAULT 'cli',
+        preview_evidence TEXT,
         UNIQUE(change_id, stage)
       )
     `);
@@ -298,7 +300,8 @@ export class DB {
         status TEXT DEFAULT 'pending',
         output TEXT,
         completed_at TEXT,
-        ordering INTEGER NOT NULL DEFAULT 0
+        ordering INTEGER NOT NULL DEFAULT 0,
+        authority TEXT NOT NULL DEFAULT 'cli'
       )
     `);
 
@@ -335,6 +338,13 @@ export class DB {
     this.db.exec('CREATE INDEX IF NOT EXISTS idx_stages_change ON stages(change_id)');
     this.db.exec('CREATE INDEX IF NOT EXISTS idx_steps_stage ON steps(stage_id)');
 
+    // Migration: authority 双轨列（watcher 预览账本，幂等——ADD COLUMN NOT NULL DEFAULT 存量即盖章）
+    this._migrateAddColumn('stages', 'authority', "TEXT NOT NULL DEFAULT 'cli'");
+    this._migrateAddColumn('stages', 'preview_evidence', 'TEXT');
+    this._migrateAddColumn('steps', 'authority', "TEXT NOT NULL DEFAULT 'cli'");
+    // 预览账本（2026-09-23-watcher-preview-progress）：authority 探测与 GC 走此复合索引
+    this.db.exec('CREATE INDEX IF NOT EXISTS idx_stages_authority ON stages(change_id, stage, authority)');
+
     // Migration: add isolation columns to changes table (idempotent)
     this._migrateAddColumn('changes', 'isolation_status', 'TEXT');
     this._migrateAddColumn('changes', 'isolation_mode', 'TEXT');
@@ -378,6 +388,27 @@ export class DB {
     // change-registry 首建/claimChangeOwner（task-02 接线会话标识）；消费方=assertChangeOwnership
     // （task-02）+ serializeForSync 平台同步投影。幂等 ALTER（列存在跳过，v5 先例同款）。
     this._migrateAddColumn('changes', 'owner_session', 'TEXT');
+
+    // v8（2026-09-27-change-birth-stage-brainstorm）：出生阶段 'scan'→'brainstorm' 的存量数据迁移。
+    // 旧版 changes 行出生 current_stage='scan'（db.js DDL 默认值 + progress.js 两处 INSERT），
+    // thin/quick 等不进主流程的变更全生命周期显示「🔍 代码扫描」误导（scan 是 auxiliary，
+    // shared.js MAIN_FLOW_ORDER 从不含它）。只改写「出生默认未被真跑过」的行：active 且
+    // （stages.scan='pending' 或根本没有 stages.scan 行——registerChange 出生的行不带 stages 行，
+    // 评审 P3-2 缺口）——setStage('scan') 置 in-progress，真在跑/已跑完 scan 的行不受影响。
+    // 同步刷 last_local_modified_ts（与 pm._touchLocalModified 同语义）：否则平台 pull 见本地
+    // 无脏度会静默 import，把平台的旧 'scan' 导回来（platform-sync-pull 冲突保留本地现状）。
+    // 幂等：改写后条件不再命中，重跑零效果。strftime 对齐 toISOString 形态（T 分隔 + ms + Z）。
+    this.db.exec(`
+      UPDATE changes
+      SET current_stage = 'brainstorm',
+          last_local_modified_ts = strftime('%Y-%m-%dT%H:%M:%fZ', 'now')
+      WHERE current_stage = 'scan'
+        AND status = 'active'
+        AND (
+          id IN (SELECT change_id FROM stages WHERE stage = 'scan' AND status = 'pending')
+          OR NOT EXISTS (SELECT 1 FROM stages WHERE change_id = changes.id AND stage = 'scan')
+        )
+    `);
   }
 
   /**

package/src/decision-distill.js

@@ -186,8 +186,11 @@ function normalizeModules(moduleIndex) {
   return moduleIndex.modules ? moduleIndex.modules : moduleIndex
 }
 
-/** _module-map.yaml 子集解析（仅模块 id → paths/core_files；不复用 modules.js 以保零依赖纯函数） */
-function parseModulePathsSubset(content) {
+/** _module-map.yaml 子集解析（仅模块 id → paths/core_files/doc；不复用 modules.js 以保零依赖纯函数）。
+ *  2026-09-23 资产三小件③：增 doc 标量捕获（`    doc: modules/<id>.md`——模块卡路径，归档文档
+ *  认领 advisory 消费）+ 导出（complete-handlers 复用同解析源，跨项目扫描需项目归属故不走
+ *  discoverModuleIndex 的合并口径）。既有消费方只读 paths/core_files，增字段零行为差。 */
+export function parseModulePathsSubset(content) {
   const modules = {}
   let cur = null
   let key = null
@@ -202,6 +205,8 @@ function parseModulePathsSubset(content) {
     }
     const block = line.match(/^    (paths|core_files):$/)
     if (block) { key = block[1]; modules[cur][key] = modules[cur][key] || []; continue }
+    const doc = line.match(/^    doc: (.+)$/)
+    if (doc) { modules[cur].doc = doc[1].trim().replace(/^['"]|['"]$/g, ''); key = null; continue }
     const item = line.match(/^      - (.+)$/)
     if (item && key) modules[cur][key].push(item[1].trim().replace(/^['"]|['"]$/g, ''))
   }
@@ -224,10 +229,11 @@ export function discoverModuleIndex(knowledgeRoot) {
       if (!existsSync(mapPath)) continue
       const sub = parseModulePathsSubset(readFileSync(mapPath, 'utf8'))
       for (const [id, m] of Object.entries(sub)) {
-        if (!merged[id]) merged[id] = { paths: m.paths || [], core_files: m.core_files || [] }
+        if (!merged[id]) merged[id] = { paths: m.paths || [], core_files: m.core_files || [], ...(m.doc ? { doc: m.doc } : {}) }
         else {
           merged[id].paths = [...new Set([...(merged[id].paths || []), ...(m.paths || [])])]
           merged[id].core_files = [...new Set([...(merged[id].core_files || []), ...(m.core_files || [])])]
+          if (!merged[id].doc && m.doc) merged[id].doc = m.doc
         }
       }
     }

package/src/docs-check.js

@@ -60,7 +60,7 @@ function _rdExists(absPath) {
 export function createHeadReader(projectRoot, ref = 'HEAD') {
   const root = pathResolve(projectRoot)
   const git = (args) => execFileSync('git', ['-C', root, ...args], {
-    encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'],
+    encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true,
   })
   let toplevel
   try { toplevel = git(['rev-parse', '--show-toplevel']).trim() } catch { return null }

package/src/doctor-diagnostics.js

@@ -31,6 +31,7 @@ import { gitQuiet } from './git-helper.js'
 import jsYaml from 'js-yaml';
 import { pruneTimestampedEntries } from './runtime-hygiene.js';
 import { CHECK_SEVERITY } from './constants.js';
+import { readGateSnapshotLedger, selectStaleSnapshots } from './run/gate-snapshot-ledger.js'
 import { checkPlatformManaged, isSelfReferentialSpecRoot, PLATFORM_MANAGED_FILENAME, QUICK_SID_RE, resolveRuntimeRoot } from './run/shared.js';
 import { readFrictionLedger } from './friction-ledger.js';
 // FR 索引消费（2026-09-18-fr-index-l1 L1，D-007）：D14 第四检查——epoch 后归档的索引在场+取代完整。
@@ -1430,6 +1431,34 @@ export function renderDoctorSummary(diagnostics) {
 import * as _wtm from './worktree.js'
 function require_wtm() { return _wtm }
 
+/**
+ * 门禁快照泄漏探测（task-04，2026-09-24-gate-snapshot-lifecycle / FR-03 / D-007@v1）：
+ * 账本内「守卫通过 ∧ 超 TTL（env/24h 单源）∧ pid 明确死」的条目即失活残留——门禁快照
+ * （%TEMP%/sillyspec-gate-*）在进程被杀/Windows 删除失败时必然泄漏且此前零可见面。
+ * 只读：只报不修（零修复），warning 级不阻断（doctor --json 的 overall_status 与退出码
+ * 沿用现行全局口径）。runtimeRoot 缺失/账本损坏→ok（fail-open 零误报）。
+ */
+export function detectGateSnapshotLeak({ runtimeRoot = null, now = Date.now(), staleHours, isProcessAlive } = {}) {
+  if (!runtimeRoot) {
+    return { name: 'gate_snapshot_leak', label: '门禁快照泄漏', pass: true, severity: null, findings: [], safe_actions: [] }
+  }
+  let leaked = []
+  try {
+    const { stale } = selectStaleSnapshots(readGateSnapshotLedger(runtimeRoot), { now, staleHours, isProcessAlive })
+    leaked = stale.map((e) => ({ root: e.snapshotRoot, ageHours: Math.max(0, Math.round((now - e.createdAt) / 3600000)) }))
+  } catch { leaked = [] }
+  return {
+    name: 'gate_snapshot_leak',
+    label: '门禁快照泄漏',
+    pass: leaked.length === 0,
+    severity: leaked.length > 0 ? CHECK_SEVERITY.WARNING : null,
+    findings: leaked.length > 0
+      ? leaked.map((x) => `残留快照 ${x.root}（账龄约 ${x.ageHours}h，超 TTL 且登记进程已失活——下个门禁建快照时自动回收，也可 rm -rf 后 git worktree prune）`)
+      : [],
+    safe_actions: [],
+  }
+}
+
 export async function runDoctorDiagnostics({ cwd }) {
   const pointer = resolvePointer(cwd);
   const multiDb = detectMultiDb(cwd, pointer);
@@ -1464,7 +1493,20 @@ export async function runDoctorDiagnostics({ cwd }) {
   // task-06（2026-09-18-ceremony-risk-pricing / FR-04 / R-04）：影子对照——轻/重 catch 差异报告 +
   // 转正判据计数（纯增量挂载，只读不阻断；无影子数据跳过不误报）
   const ceremonyShadow = detectCeremonyShadowComparison(cwd, authoritySpecDir)
-  const dimensions = [multiDb, pointerHealth, changesSplit, changeDb, executeMismatch, docBloat, repoNativeChain, lifecycleDoc, worktreeHealth, buildEnv, mcpEndpoints, applyManifestDrift, selfMaintenanceTax, archiveIntegrity, ceremonyShadow];
+  // task-04（2026-09-24-gate-snapshot-lifecycle / FR-03 / D-007@v1）：门禁快照泄漏
+  // （%TEMP%/sillyspec-gate-* 崩溃残留——warning 级只读可见面；阈值与 create 前扫共用
+  // env SILLYSPEC_GATE_SNAPSHOT_STALE_HOURS/24h 单源，顶层 doctor 无 --stale-hours 参数面）。
+  // runtimeRoot 与 quick/verify 落账本处同源：平台指针 runtimeRoot 优先（否则 specBase/.runtime），
+  // 否则平台模式下账本写别处、doctor 恒读空（独立审查 P1-3）
+  let gateLeakRuntimeRoot = null
+  try {
+    gateLeakRuntimeRoot = resolveRuntimeRoot(
+      { runtimeRoot: pointer.present && pointer.runtimeRoot && existsSync(pointer.runtimeRoot) ? pointer.runtimeRoot : null },
+      authoritySpecDir || join(cwd, '.sillyspec'),
+    )
+  } catch { gateLeakRuntimeRoot = null }
+  const gateSnapshotLeak = detectGateSnapshotLeak({ runtimeRoot: gateLeakRuntimeRoot })
+  const dimensions = [multiDb, pointerHealth, changesSplit, changeDb, executeMismatch, docBloat, repoNativeChain, lifecycleDoc, worktreeHealth, buildEnv, mcpEndpoints, applyManifestDrift, selfMaintenanceTax, archiveIntegrity, ceremonyShadow, gateSnapshotLeak];
 
   return {
     dimensions,
@@ -1697,7 +1739,7 @@ export async function dumpDb({ dbPath, cwd }) {
     const schemaVersion = sv.length ? sv[0].schema_version : null;
     const changes = rows('SELECT name, current_stage, status, created_at, last_active FROM changes ORDER BY last_active DESC')
       .map((r) => ({ name: r.name, current_stage: r.current_stage, status: r.status, created_at: r.created_at, last_active: r.last_active }));
-    const stages = rows('SELECT c.name, s.stage, s.status, s.started_at, s.completed_at FROM stages s JOIN changes c ON s.change_id = c.id ORDER BY c.name, s.stage')
+    const stages = rows(`SELECT c.name, s.stage, s.status, s.started_at, s.completed_at FROM stages s JOIN changes c ON s.change_id = c.id WHERE (s.authority = 'cli' OR s.authority IS NULL) ORDER BY c.name, s.stage`)
       .map((r) => ({ change: r.name, stage: r.stage, status: r.status, started_at: r.started_at, completed_at: r.completed_at }));
     return writeDump({ ok: true, meta, schema_version: schemaVersion, changes, stages }, authoritySpecDir);
   } catch (e) {