sillyspec 3.26.7 → 3.26.9

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

@@ -33,8 +33,7 @@ sillyspec run archive --reopen --from-step N   # 重新打开已完成阶段修
 | `--change <名>` | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
 | `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
 | `--non-interactive` | CI/脚本下禁用交互式 prompt |
-| `--skip-approval` | 跳过审批/校验门控（需明确意图） |
-| `--json` | 输出 JSON（程序化读取） |
+| `--skip-approval` | 跳过阶段转换/审批检查（不能跳产物校验 gate——review.json/文档产物硬校验仍在） |
 
 ## archive 特有
 

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

@@ -41,8 +41,7 @@ sillyspec run brainstorm --done --answer "..." --output "..."    # 一步完成
 | `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
 | `--non-interactive` | CI/脚本下禁用交互式 prompt |
 | `--interactive` | 强制交互（即便 stdin 非 TTY） |
-| `--skip-approval` | 跳过审批/校验门控（需明确意图） |
-| `--json` | 输出 JSON（程序化读取） |
+| `--skip-approval` | 跳过阶段转换/审批检查（不能跳产物校验 gate——review.json/文档产物硬校验仍在） |
 
 ## brainstorm 特有：requiresWait 步骤
 

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

@@ -63,6 +63,8 @@ sillyspec runtime list                                              # 枚举 .si
 > `--cleanup-remnant` 清理 init/平台切换残留的 0 字节空 db（占位但无数据）。默认 dry-run 只报告，`--confirm` 才删。绝不删有内容的 db。
 >
 > `runtime list` 是只读枚举：列出 `.sillyspec/.runtime/` 下的 db、doctor-diagnosis.json、workflow-runs/、user-inputs.md 等产物及用途。多会话/压缩后想知道「我手上有哪些证据文件」时用。加 `--json` 程序化读取。
+>
+> `doctor --json` 的 pointer_health 维度含 `pointer_missing_but_managed` 信号：项目根存在平台接管声明（`.sillyspec-platform-managed`）但恢复指针缺失——此状态下裸调命令会 fail-closed 拒绝静默落本地。恢复路径见信号文案：重跑平台 scan 重建指针 / `sillyspec platform disconnect` 彻底脱离 / 显式 `--spec-dir` 临时指定。
 
 ## 铁律
 

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

@@ -33,8 +33,7 @@ sillyspec run execute --reopen --from-step N   # 重新打开已完成阶段修
 | `--change <名>` | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
 | `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
 | `--non-interactive` | CI/脚本下禁用交互式 prompt |
-| `--skip-approval` | 跳过审批/校验门控（需明确意图） |
-| `--json` | 输出 JSON（程序化读取） |
+| `--skip-approval` | 跳过阶段转换/审批检查（不能跳产物校验 gate——review.json/文档产物硬校验仍在） |
 
 ## execute 特有：Worktree 隔离
 
@@ -56,6 +55,14 @@ sillyspec worktree doctor --fix --change <变更名>
 
 `linked / installed / n/a` 放行；`missing / stale / failed / unknown` 阻断。Wave 内所有 task 声明 `no_deps_verify: true` 时可 opt-out。
 
+### 符号影响面报告（「加载上下文」步硬门）
+
+execute 前缀步「加载上下文」的 `--done` 会硬校验符号影响面报告：
+
+- 路径：`{SPEC_ROOT}/changes/<变更名>/symbol-impact.md`（步骤 prompt 中会输出具体路径）。
+- 要求：plan.md 中**每个 task-XX 都要有一行结论**——涉及签名级变更（构造函数参数/接口/DTO/方法签名增删改）就列变更类型 + 受影响调用点 + 是否在任务范围内；无签名级变更也要显式写「无签名级变更」。
+- 文件缺失或未覆盖全部 task → `--done` 被阻断（进度不推进），补全后重跑即可。
+
 ### Task Review Gate
 
 execute 完成时，每个 task 必须有 `review.json` 且 verdict 通过，否则阻断完成。**例外**：task 在 `tasks/task-XX.md` frontmatter 声明 `low_risk: true`（type-only / 机械迁移等低逻辑风险）时，缺 review.json 只发 warning 不阻断。`cannot_verify` 的 task 会写入 `verify-required-evidence.json`，由 verify 阶段消费。
@@ -109,6 +116,7 @@ execute 还有**第二道**独立的 stage 级审查：除逐 task review.json
 
 - `docHash` = `sha256(主审查文档内容)`（hex）—— execute 主审查文档是 `design.md`，即 `reviewedFiles[0]`。CLI 会重算 sha256 比对，不符判伪造（fail-closed）；找不到主文档也 fail。**改 design.md 后须重算 docHash 再写**，可用 `sillyspec run execute --done` 触发的 prompt 注入版契约（运行时注入的 schema 表 + JSON 示例 + docHash 算法）逐字改值。
 - `tier=independent` 时必须由独立 QA 子代理产出该 review.json（独立上下文，不共享实现者分析）；`tier=self`（变更 ≤3 文件）降级为当前 agent 自审。
+- **审查范围分级**（tier=independent 时省重复消耗）：Task Review Gate 已产出 review.json 且 specVerdict/qualityVerdict 双 pass 的 task，QA 子代理只抽查（读 1-2 个核心 diff 文件抽验 reviewerNotes 与实际改动相符）；fail/cannot_verify/缺失的 task 全量重审。三项始终必查：跨 task 交界、design.md 整体对照、组装行为（全量测试/构建/启动）——task review 只看单 task diff，覆盖不到这三项。
 - 该 acceptance review 同时覆盖"代码审查"视角，后续代码审查步骤仅需轻量复审。
 
 > 运行时 CLI 会把精确 schema 表 + 完整 JSON 示例 + docHash 算法注入到该步 prompt。本段为常驻摘要；以你实际收到的注入版契约为权威逐字模板。

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

@@ -30,7 +30,6 @@ sillyspec run explore --status                     # 查看阶段状态
 |---|---|
 | `--change <名>` | 指定变更名（多活跃变更时） |
 | `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
-| `--json` | 输出 JSON（程序化读取） |
 
 ## 这是什么模式
 

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

@@ -37,8 +37,7 @@ sillyspec run plan --done --answer "..." --output "..."    # 一步完成 wait+d
 | `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
 | `--non-interactive` | CI/脚本下禁用交互式 prompt |
 | `--interactive` | 强制交互（即便 stdin 非 TTY） |
-| `--skip-approval` | 跳过审批/校验门控（需明确意图） |
-| `--json` | 输出 JSON（程序化读取） |
+| `--skip-approval` | 跳过阶段转换/审批检查（不能跳产物校验 gate——review.json/文档产物硬校验仍在） |
 
 ## plan 特有
 

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

@@ -52,8 +52,7 @@ sillyspec run quick --done --change quick-<hash> --output "…"  # 完成该会
 | `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
 | `--non-interactive` | CI/脚本下禁用交互式 prompt |
 | `--interactive` | 强制交互（即便 stdin 非 TTY） |
-| `--skip-approval` | 跳过审批/校验门控（需明确意图） |
-| `--json` | 输出 JSON（程序化读取） |
+| `--skip-approval` | 跳过阶段转换/审批检查（不能跳产物校验 gate——review.json/文档产物硬校验仍在） |
 
 ## quick 特有参数
 

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

@@ -31,8 +31,7 @@ sillyspec run scan --reset                     # 重置阶段（从头开始）
 |---|---|
 | `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
 | `--non-interactive` | CI/脚本下禁用交互式 prompt |
-| `--skip-approval` | 跳过审批/校验门控 |
-| `--json` | 输出 JSON（程序化读取） |
+| `--skip-approval` | 跳过阶段转换/审批检查（不能跳产物校验 gate——review.json/文档产物硬校验仍在） |
 
 ## scan 特有参数
 
@@ -42,6 +41,7 @@ sillyspec run scan --reset                     # 重置阶段（从头开始）
 | `--standard` | 强制 standard profile（压缩步骤，最多 1 子代理） |
 | `--deep` | 强制 deep profile（完整流程，不按规模裁剪） |
 | `--force-rescan` | 覆盖已有 scan 文档的保护（默认覆盖需 source_commit/updated_at 匹配） |
+| `--diff` | 增量漂移清单：`sillyspec scan diff`（或 `--diff` flag）算 source_commit..HEAD 的 A/D/M/R 四分类漂移，按 module-map paths 归模块，agent 据此定点补文档而非全量重扫（2026-08-16） |
 
 ### scanProfile（显式选择优先，否则按规模自动裁剪）
 

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

@@ -35,7 +35,6 @@ sillyspec run status --status                  # 查看阶段状态
 |---|---|
 | `--change <名>` | 指定变更名（多变更时查看指定变更详情） |
 | `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
-| `--json` | 输出 JSON（程序化读取） |
 
 ## 配套的只读查询命令（不经 run）
 

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

@@ -34,8 +34,7 @@ sillyspec run verify --reopen --from-step N    # 重新打开已完成阶段修
 | `--change <名>` | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
 | `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
 | `--non-interactive` | CI/脚本下禁用交互式 prompt |
-| `--skip-approval` | 跳过审批/校验门控（需明确意图） |
-| `--json` | 输出 JSON（程序化读取） |
+| `--skip-approval` | 跳过阶段转换/审批检查（不能跳产物校验 gate——review.json/文档产物硬校验仍在） |
 
 ## verify 特有：完成门控（重要）
 

package/.husky/pre-push

@@ -1,5 +1,5 @@
 #!/bin/sh
-echo "🔧 pre-push: running lint + test..."
+echo "🔧 pre-push: running lint + test + docs gate..."
 npm run lint --silent 2>&1
 if [ $? -ne 0 ]; then
   echo "❌ pre-push: lint failed, aborting push"
@@ -10,4 +10,11 @@ if [ $? -ne 0 ]; then
   echo "❌ pre-push: test failed, aborting push"
   exit 1
 fi
-echo "✅ pre-push: lint + test passed"
+# docs gate ratchet（doc-consistency-debt 第七节）：docs check 失效数 ≤ 基线放行。
+# 基线 .sillyspec/docs-check-baseline 缺失/损坏时 fail-closed exit 2 拦截。
+node bin/sillyspec.js docs gate 2>&1
+if [ $? -ne 0 ]; then
+  echo "❌ pre-push: docs gate failed, aborting push"
+  exit 1
+fi
+echo "✅ pre-push: lint + test + docs gate passed"

package/README.md

@@ -29,7 +29,7 @@ SillySpec 把一个变更的完整生命周期固化为一组**强制阶段**—
 
 ## 快速开始
 
-需要 Node.js >= 18，一条命令完成初始化：
+需要 Node.js >= 22.13，一条命令完成初始化：
 
 ```bash
 npx sillyspec init
@@ -50,18 +50,16 @@ npx sillyspec init
 
 ```bash
 npx sillyspec init --tool claude      # 指定工具
-npx sillyspec init --workspace        # 多项目工作区模式
 npx sillyspec init --dir /path/to/x   # 指定项目目录
 npx sillyspec init --interactive      # 完整引导
 ```
 
-> 💡 启动 AI 时推荐使用跳过权限模式（如 `claude --dangerously-skip-permissions`）。SillySpec 会频繁执行 git、文件读写、校验脚本等操作，逐个批准会打断节奏——这也是 GSD / OpenSpec 的预期使用方式。
 
 ## 平台支持
 
 SillySpec 进度库使用 SQLite 持久化（基于 Node.js 内置的 `node:sqlite` 模块，纯 JS 无原生编译依赖）。
 
-- **Node.js 版本要求 >= 22.11.0**：`node:sqlite` 自 v22.11.0 起免 `--experimental-sqlite` flag 直接可用。支持 Linux x64、macOS x64 / arm64、Windows x64 等所有 Node.js 官方支持平台。
+- **Node.js 版本要求 >= 22.13.0**：`node:sqlite` 自 v22.13.0 起免 `--experimental-sqlite` flag 直接可用。支持 Linux x64、macOS x64 / arm64、Windows x64 等所有 Node.js 官方支持平台。
 - **零编译安装**：不依赖任何原生绑定 / node-gyp / C++ 工具链，npm install 即装即用，无平台编译失败风险。
 
 ## 从哪里开始
@@ -101,7 +99,7 @@ SillySpec 进度库使用 SQLite 持久化（基于 Node.js 内置的 `node:sqli
 | `/sillyspec:brainstorm` | 需求探索 + 规范生成：产出 design.md + tasks.md |
 | `/sillyspec:plan` | 实现计划：文件路径 + 任务描述 + Wave 拓扑分组 |
 | `/sillyspec:execute` | TDD 执行：子代理并行 + worktree 隔离 |
-| `/sillyspec:verify` | 验证：对照规范 + 测试套件 + 代码审查 + E2E |
+| `/sillyspec:verify` | 验证：对照规范 + 测试套件 + 代码审查 |
 | `/sillyspec:archive` | 归档：规范沉淀到 knowledge/ |
 | `/sillyspec:auto` | 全自动推进全部阶段 |
 
@@ -142,7 +140,7 @@ sillyspec doctor                 全量自检 + 修复进度
 - **拓扑排序 Wave** — plan 阶段按蓝图依赖关系自动重排 Wave 分组
 - **进度持久化** — SQLite（sql.js WASM）持久化，支持断点恢复
 - **模块文档** — 模块级知识库，AI 执行时按需加载相关上下文
-- **E2E 验证** — 内置 E2E 测试流程，支持 Playwright / 浏览器 MCP，跨会话自动修复
+- **浏览器自动化** — 可选 MCP（Playwright / Chrome DevTools），供集成/E2E 冒烟验证
 - **平台同步** — 可选对接 SillyHub，文档同步 + 团队审批
 
 ## 可靠性保障
@@ -152,7 +150,6 @@ SillySpec 不只是 prompt，还有硬校验兜底：
 - **锚定确认** — 各阶段执行前必须逐个确认读过规范文件
 - **Hard Gate 自检** — 关键命令生成文件后强制自检格式，不通过则修正
 - **postcheck 识别偷懒** — 自动识别占位符、fallback、未分析等 AI 偷懒模式
-- **校验脚本** — shell 脚本自动化验证 AI 输出（validate-proposal/plan/scan/all）
 - **归档确认** — archive 操作前展示内容等待用户确认
 
 ## 防幻觉机制
@@ -162,14 +159,13 @@ SillySpec 不只是 prompt，还有硬校验兜底：
 | scan | 强制扫描代码库结构 / 约定 / 集成 / 测试 / 债务，生成 7 份文档 |
 | brainstorm | 必须读 ARCHITECTURE.md 数据模型，支持原型图分析 |
 | execute | 写代码前强制读现有源码，禁止编造方法调用 |
-| 全流程 | postcheck + 校验脚本兜底 |
+| 全流程 | postcheck + 硬门兜底 |
 
 ## MCP 增强
 
 通过 `sillyspec setup` 一键安装 MCP 工具，增强 AI 能力：
 
 - **Context7** — 查询最新库文档和 API 参考
-- **grep.app** — 搜索开源代码实现
 - **Chrome DevTools** — 浏览器自动化，支持 E2E 验证
 
 ## 目录结构

package/bin/sillyspec.js

@@ -1,2 +1,2 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 import '../src/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "3.26.7",
+  "version": "3.26.9",
   "description": "SillySpec CLI — 流程状态机，让 AI 严格按步骤来",
   "icon": "logo.jpg",
   "homepage": "https://sillyspec.ppdmq.top/",
@@ -13,7 +13,7 @@
     "sillyspec": "bin/sillyspec.js"
   },
   "engines": {
-    "node": ">=22.11.0"
+    "node": ">=22.13.0"
   },
   "keywords": [
     "sillyspec",

package/packages/dashboard/server/index.js

@@ -564,14 +564,10 @@ function startServer({ port = 3456, open: openBrowser = true } = {}) {
     })
   })
 
-  try {
-    startWatcher((projects) => {
-      broadcast({ type: 'projects:updated', data: projects })
-    })
-  } catch (err) {
-    console.error('Failed to start file watcher:', err)
-  }
-
+  // listen 前置：Windows 下 startWatcher 的初始全盘同步扫描（homedir/Temp/桌面 depth 2 +
+  // 每项目多次 execSync('git')）实测 150s+，若排在其后则服务永不响应（假死）。
+  // 先绑定端口（listen 回调立即可达），扫描用 setImmediate 延后到事件循环——端口立即响应，
+  // 初始 projects 数据由扫描完成后 broadcast 补发。
   server.listen(port, '127.0.0.1', () => {
     console.log(`Dashboard server running on http://127.0.0.1:${port}`)
     if (openBrowser) {
@@ -579,6 +575,16 @@ function startServer({ port = 3456, open: openBrowser = true } = {}) {
     }
   })
 
+  setImmediate(() => {
+    try {
+      startWatcher((projects) => {
+        broadcast({ type: 'projects:updated', data: projects })
+      })
+    } catch (err) {
+      console.error('Failed to start file watcher:', err)
+    }
+  })
+
   const shutdown = () => {
     stopWatcher()
     activeProcesses.forEach(kill => kill())

package/src/change-risk-profile.js

@@ -2,56 +2,13 @@
  * change-risk-profile.js — 变更风险分级检测
  *
  * 根据变更涉及的文件类型、关键词、git diff、brainstorm 产物，
- * 自动判定 P0/P1/P2 风险等级，产出结构化 risk-profile.json。
- *
- * P0 = 阻塞确认（必须用户确认）
- * P1 = 自动推进但记录
- * P2 = 自动通过
+ * 判定 5 级风险（doc-only / unit-sufficient / contract-required /
+ * integration-critical / deployment-critical），产出门控验证需求。
  */
 
-// ============ P0 触发规则 ============
-
-const P0_FILE_PATTERNS = [
-  { id: 'R-002', pattern: /(?:^|\/)(?:migrations?|migration)\/(?:.+)/i, desc: '数据库 migration' },
-  { id: 'R-002', pattern: /(?:^|\/)schema\.(?:sql|prisma|ts|js)$/i, desc: '数据库 schema' },
-  { id: 'R-003', pattern: /(?:^|\/)(?:auth|permission|role|login|token)\b/i, desc: '鉴权/权限' },
-  { id: 'R-004', pattern: /(?:^|\/)(?:payment|billing|stripe|paypal)\b/i, desc: '支付/资金' },
-  { id: 'R-005', pattern: /\.(?:env|env\.\w+)$/, desc: '环境配置' },
-  { id: 'R-005', pattern: /(?:^|\/)(?:Dockerfile|docker-compose\.\w+)$/i, desc: '部署配置' },
-  { id: 'R-005', pattern: /(?:^|\/)config\.(?:yaml|yml|json|toml)$/i, desc: '生产配置' },
-]
-
-const P0_CONTENT_PATTERNS = [
-  { id: 'R-001', pattern: /\b(?:DROP\s+TABLE|TRUNCATE\s+TABLE|DELETE\s+FROM\s+\w+\s+(?!WHERE\s+.+\s+LIMIT))/i, desc: '删除数据' },
-  { id: 'R-002', pattern: /\b(?:CREATE\s+TABLE|ALTER\s+TABLE|ADD\s+COLUMN|DROP\s+COLUMN|CREATE\s+INDEX)/i, desc: '数据库 migration' },
-]
-
-// ============ P1 触发规则 ============
-
-const P1_FILE_PATTERNS = [
-  { id: 'R-101', pattern: /(?:^|\/)(?:routes|controllers?|handlers?)\//i, desc: 'API 层' },
-  { id: 'R-102', pattern: /(?:^|\/)(?:models|entities)\//i, desc: '数据模型层' },
-  { id: 'R-104', pattern: /(?:^|\/)(?:services)\//i, desc: '业务逻辑层（跨模块）' },
-  { id: 'R-106', pattern: /(?:^|\/)index\.(?:ts|js)$/i, desc: 're-export 入口' },
-]
-
-const P1_CONTENT_PATTERNS = [
-  { id: 'R-101', pattern: /\b(?:daemon|backend|grpc|websocket|cross.?process|ipc|message.?queue)\b/i, desc: '跨进程通信' },
-  { id: 'R-101', pattern: /\b(?:session|lease|agent.?run|lifecycle|state.?transition|claim|heartbeat)\b/i, desc: '状态机/生命周期' },
-  { id: 'R-102', pattern: /\b(?:api|client|contract|dto)\b/i, desc: 'API contract' },
-  { id: 'R-105', pattern: /(?:^|\/)(?:workflow|daemon|session|lifecycle|state-machine)\b/i, desc: '核心模块' },
-]
-
-// ============ P0/P1 命中文件名关键词（用于 git diff 检测） ============
-
-const PROTECTED_FILE_NAMES = [
-  '.env', 'package.json', 'tsconfig.json', 'vite.config.ts', 'vite.config.js',
-  'prisma/schema.prisma', 'docker-compose.yml', 'docker-compose.yaml',
-]
-
 // ============ 向后兼容：旧的 INTEGRATION_CRITICAL_PATTERNS ============
 
-export const INTEGRATION_CRITICAL_PATTERNS = [
+const INTEGRATION_CRITICAL_PATTERNS = [
   /\bdaemon\b/i,
   /\bbackend\b/i,
   /\bclient.*api\b/i,
@@ -78,7 +35,7 @@ export const INTEGRATION_CRITICAL_PATTERNS = [
   /\bdocker.?compose\b/i,
 ]
 
-export const INTEGRATION_FILE_PATTERNS = [
+const INTEGRATION_FILE_PATTERNS = [
   /daemon/i,
   /session.?manager/i,
   /agent.?run/i,
@@ -114,165 +71,6 @@ export function isEndToEndTaskText(text = '') {
   return END_TO_END_TASK_KEYWORDS.some(re => re.test(text))
 }
 
-// ============ 核心检测函数 ============
-
-/**
- * 三级风险检测：P0 / P1 / P2
- * @param {object} opts
- * @param {string} [opts.designContent] - design.md 内容
- * @param {string} [opts.planContent] - plan.md 内容
- * @param {string[]} [opts.changedFiles] - 变更文件列表
- * @param {string} [opts.diffContent] - git diff 内容（可选，用于更精确检测）
- * @param {object} [opts.nextAction] - next-action.json 解析后的对象（可选）
- * @param {string[]} [opts.protectedFiles] - 项目自定义 protected files 列表
- * @returns {RiskProfile}
- *
- * @typedef {object} RiskProfile
- * @property {string} level - 'P0' | 'P1' | 'P2'
- * @property {string[]} triggers - 触发的规则 ID 列表
- * @property {object[]} assessedFrom - 评估依据
- * @property {string[]} applyBlockers - apply 阻塞原因
- * @property {boolean} canAutoApply - 是否可自动 apply
- * @property {string} applyReason - apply 决策原因
- */
-export function detectRiskProfile({ designContent = '', planContent = '', changedFiles = [], diffContent = '', nextAction = null, protectedFiles = [] } = {}) {
-  const triggers = []
-  const assessedFrom = []
-
-  const combined = [designContent, planContent].join('\n')
-
-  // ── P0 检测（最高优先级）──
-
-  // 基于文件路径
-  for (const rule of P0_FILE_PATTERNS) {
-    for (const file of changedFiles) {
-      if (rule.pattern.test(file)) {
-        rule.pattern.lastIndex = 0
-        if (!triggers.includes(rule.id)) {
-          triggers.push(rule.id)
-          assessedFrom.push({ source: 'file_path', pattern: rule.desc, matchedFiles: [file] })
-        }
-      }
-    }
-  }
-
-  // 基于 diff 内容（P0 关键词）
-  const diffText = diffContent || combined
-  for (const rule of P0_CONTENT_PATTERNS) {
-    if (rule.pattern.test(diffText)) {
-      rule.pattern.lastIndex = 0
-      if (!triggers.includes(rule.id)) {
-        triggers.push(rule.id)
-        assessedFrom.push({ source: 'content', pattern: rule.desc })
-      }
-    }
-  }
-
-  // protected files
-  for (const file of changedFiles) {
-    if (PROTECTED_FILE_NAMES.some(p => file === p || file.endsWith('/' + p))) {
-      const id = 'R-005'
-      if (!triggers.includes(id)) {
-        triggers.push(id)
-        assessedFrom.push({ source: 'protected_file', pattern: file })
-      }
-    }
-    // 用户自定义 protected files
-    if (protectedFiles.includes(file)) {
-      const id = 'R-005'
-      if (!triggers.includes(id)) {
-        triggers.push(id)
-        assessedFrom.push({ source: 'protected_file', pattern: file })
-      }
-    }
-  }
-
-  // next-action.json 有 blocking questions
-  if (nextAction && nextAction.has_blocking_questions === true) {
-    const id = 'R-009'
-    if (!triggers.includes(id)) {
-      triggers.push(id)
-      assessedFrom.push({ source: 'brainstorm', pattern: 'has_blocking_questions === true' })
-    }
-  }
-
-  // ── P1 检测（只在无 P0 时检测）──
-  if (!triggers.some(t => t.startsWith('R-00'))) {
-    // 基于文件路径
-    for (const rule of P1_FILE_PATTERNS) {
-      for (const file of changedFiles) {
-        if (rule.pattern.test(file)) {
-          rule.pattern.lastIndex = 0
-          if (!triggers.includes(rule.id)) {
-            triggers.push(rule.id)
-            assessedFrom.push({ source: 'file_path', pattern: rule.desc, matchedFiles: [file] })
-          }
-        }
-      }
-    }
-
-    // 基于内容关键词
-    for (const rule of P1_CONTENT_PATTERNS) {
-      if (rule.pattern.test(combined)) {
-        rule.pattern.lastIndex = 0
-        if (!triggers.includes(rule.id)) {
-          triggers.push(rule.id)
-          assessedFrom.push({ source: 'content', pattern: rule.desc })
-        }
-      }
-    }
-
-    // 跨模块检测（> 3 个文件的变更）
-    if (changedFiles.length > 10) {
-      const id = 'R-101'
-      if (!triggers.includes(id)) {
-        triggers.push(id)
-        assessedFrom.push({ source: 'file_count', pattern: `${changedFiles.length} files changed` })
-      }
-    }
-
-    // next-action.json 有 NEEDS_REVIEW 决策
-    if (nextAction && Array.isArray(nextAction.auto_decisions)) {
-      for (const d of nextAction.auto_decisions) {
-        if (d.status === 'NEEDS_REVIEW') {
-          const id = 'R-102'
-          if (!triggers.includes(id)) {
-            triggers.push(id)
-            assessedFrom.push({ source: 'brainstorm', pattern: `NEEDS_REVIEW: ${d.decision}` })
-          }
-        }
-      }
-    }
-  }
-
-  // ── 判定等级 ──
-  let level = 'P2'
-  if (triggers.some(t => t.match(/^R-0\d+$/))) {
-    level = 'P0'
-  } else if (triggers.some(t => t.match(/^R-1\d+$/))) {
-    level = 'P1'
-  }
-
-  // ── apply 决策 ──
-  const applyBlockers = []
-  if (level === 'P0') {
-    applyBlockers.push('风险等级 P0：需要用户确认后才能 apply')
-  }
-
-  const canAutoApply = level !== 'P0' && applyBlockers.length === 0
-  const applyReason = canAutoApply
-    ? `风险等级 ${level}，无 P0 触发，无 protected files 修改`
-    : applyBlockers.join('; ')
-
-  return { level, triggers, assessedFrom, applyBlockers, canAutoApply, applyReason }
-}
-
-// ============ 向后兼容 ============
-
-/**
- * 旧的 detectChangeRisk 接口保持向后兼容
- * @returns {{ level: string, triggers: string[], requiredVerification: string[] }}
- */
 // ============ 门控可执行化（A：报错说人话） ============
 //
 // 历史教训：integration-critical / deployment-critical 门控只报「缺少真实集成证据 / 需要真实
@@ -320,7 +118,7 @@ export const RISK_LEVEL_CAUSES = {
 }
 
 /** design.md frontmatter 可显式声明的合法 risk_level 值（与 detectChangeRisk 判级结果同集合） */
-export const RISK_LEVELS = ['doc-only', 'unit-sufficient', 'contract-required', 'integration-critical', 'deployment-critical']
+const RISK_LEVELS = ['doc-only', 'unit-sufficient', 'contract-required', 'integration-critical', 'deployment-critical']
 
 /**
  * 从 design.md 顶部 frontmatter 提取显式 risk_level 声明。