sillyspec 3.25.9 → 3.26.0

package/src/init.js

@@ -4,6 +4,10 @@ import { fileURLToPath } from 'url';
 import { checkbox, confirm, input } from '@inquirer/prompts';
 import { ProgressManager } from './progress.js';
 import chalk from 'chalk';
+import { getVersion } from './version.js';
+// 向后兼容：getVersion 已抽到轻量 version.js（避免 index.js 为 --version 静态加载 init.js 的 inquirer 税），
+// 此处 re-export 保持 init.js 既有导出 API 不破坏（如 test/init-claude-injection.test.mjs）。
+export { getVersion };
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -12,7 +16,7 @@ const __dirname = dirname(__filename);
 // 平台模式（specRoot 指向外部）下，源码目录的 .sillyspec/.runtime/ 是旧残留，
 // 应让 specRoot 成为唯一运行时根。但若源码目录的 .sillyspec/ 本身就是该项目
 // 的 specDir（含真实资产），其 .runtime/ 里的 worktrees/、sillyspec.db、
-// global.json、gate-status.json 是真实工作状态，整删会摧毁 worktree meta、
+// global.json 是真实工作状态，整删会摧毁 worktree meta、
 // 导致 depsStatus 恒为 unknown、branch already exists 死循环。
 // 详见 docs/sillyspec/runtime-cleanup-destroys-worktree-meta.md
 //
@@ -21,7 +25,6 @@ const RUNTIME_KEEP = new Set([
   'worktrees',          // worktree 目录 + meta.json（worktree.js:17）
   'sillyspec.db',       // SQLite 进度库（权威状态源，progress.js:7）
   'global.json',        // 项目名/活跃变更缓存（progress.js:8）
-  'gate-status.json',   // worktree-guard 门禁状态（progress.js:9）
   'contract-artifacts', // execute endpoint 契约（verify 阶段读取）
   'execute-runs',       // task review 结果（task-review.js）
 ]);
@@ -209,7 +212,7 @@ function isTTY() {
 
 // ── 核心安装逻辑 ──
 
-async function doInstall(projectDir, tools, subprojects = [], specDir = null) {
+function doInstall(projectDir, tools, subprojects = [], specDir = null) {
   // specDir: 规范目录（默认 projectDir/.sillyspec）
   // projectDir: 源码项目根目录（用于工具检测、指令注入、.gitignore）
   const spec = specDir || join(projectDir, '.sillyspec');
@@ -308,7 +311,7 @@ async function doInstall(projectDir, tools, subprojects = [], specDir = null) {
 
   // 初始化 SQLite 数据库
   const pm = new ProgressManager({ specDir: spec });
-  await pm.init(projectDir);
+  pm.init(projectDir);
 
   // .gitignore 只在 specDir 在项目内时才修改
   const isExternalSpec = specDir && resolve(spec) !== resolve(projectDir, '.sillyspec');
@@ -389,16 +392,6 @@ function showSummary(version, tools, specDir) {
   console.log('');
 }
 
-// ── 读取版本号 ──
-
-export function getVersion() {
-  try {
-    const pkg = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'utf8'));
-    return pkg.version;
-  } catch {
-    return '?.?.?';
-  }
-}
 
 // ── 主命令 ──
 

package/src/local-detect.js

@@ -1,110 +1,120 @@
-/**
- * Local Detect — 纯 fs 项目类型嗅探
- *
- * 把"生成本地配置"里的项目类型判定从 scan（半小时 + 大量 token）抽出来，
- * 变成纯 fs 同步读几秒可完成的独立探测。create/gate 只需 project.type +
- * commands，不该被迫跑完整 scan。
- *
- * 纯函数：不 spawn 任何子进程、不调用任何 AI/LLM、不消耗 token。
- * 不写 local.yaml 到磁盘——只返回数据结构，落盘由调用方（CLI 路由 / scan.js）负责。
- * 不引 yaml 依赖。
- */
-
-import { existsSync, readFileSync } from 'fs'
-import { join } from 'path'
-
-/**
- * 从 Makefile 文本提取 test 目标的命令（轻量正则，与 verify-postcheck 同风格）。
- * 支持两种常见写法：
- *   - 同行命令：`test: pytest`            → 'pytest'
- *   - tab 续行：`test:\n\tpytest\n`        → 'pytest'（命令在下一 tab 开头行）
- * 边界：
- *   - 纯空目标（`test:` 无同行命令、无 tab 续行）→ 回退 'make test'
- *   - 命令行内 `#` 注释截断；取第一个非空命令行
- * @param {string} makefileText
- * @returns {string}
- */
-function parseMakefileTestCommand(makefileText) {
-  if (!makefileText) return 'make test'
-  // 定位 `test:` 行；捕获 `:` 后同行内容（同行命令或空）
-  const head = makefileText.match(/^test:\s*([^\n#]*?)\s*(?:#.*)?$/m)
-  if (!head) return 'make test'
-  const inline = (head[1] || '').trim()
-  if (inline) return inline
-  // 同行为空 → 找该行之后第一个 tab 续行命令（`\tcmd` 或 `    cmd`）
-  const after = makefileText.slice(head.index + head[0].length)
-  const cont = after.match(/^[ \t]+([^\n#]+?)\s*(?:#.*)?$/m)
-  if (cont && cont[1]) return cont[1].trim()
-  return 'make test'
-}
-
-/**
- * 嗅探 workdir 的项目类型与默认 commands（纯 fs，零 AI / 零 token）。
- *
- * 嗅探规则（按顺序，命中即返回）：
- *   - package.json → nodejs（npm run build / npm test / npm run lint）
- *   - pom.xml → maven（mvn compile / mvn test / mvn checkstyle:check）
- *   - build.gradle → gradle（./gradlew build / test / check）
- *   - Makefile → make（test 命令从 test: 目标解析；build/lint 无则不写）
- *   - 都没有 → generic（commands 为空对象）
- *
- * @param {string} workdir - 项目根目录
- * @returns {{
- *   project: { type: 'nodejs'|'maven'|'gradle'|'make'|'generic' },
- *   commands: { build?: string, test?: string, lint?: string }
- * }}
- */
-export function detectLocalYaml(workdir) {
-  // 1. nodejs
-  if (existsSync(join(workdir, 'package.json'))) {
-    return {
-      project: { type: 'nodejs' },
-      commands: {
-        build: 'npm run build',
-        test: 'npm test',
-        lint: 'npm run lint',
-      },
-    }
-  }
-
-  // 2. maven
-  if (existsSync(join(workdir, 'pom.xml'))) {
-    return {
-      project: { type: 'maven' },
-      commands: {
-        build: 'mvn compile',
-        test: 'mvn test',
-        lint: 'mvn checkstyle:check',
-      },
-    }
-  }
-
-  // 3. gradle
-  if (existsSync(join(workdir, 'build.gradle'))) {
-    return {
-      project: { type: 'gradle' },
-      commands: {
-        build: './gradlew build',
-        test: './gradlew test',
-        lint: './gradlew check',
-      },
-    }
-  }
-
-  // 4. make（test 命令从 Makefile 解析；build/lint 无则省略）
-  const makefilePath = join(workdir, 'Makefile')
-  if (existsSync(makefilePath)) {
-    const makefileText = readFileSync(makefilePath, 'utf8')
-    const test = parseMakefileTestCommand(makefileText)
-    return {
-      project: { type: 'make' },
-      commands: { test },
-    }
-  }
-
-  // 5. generic
-  return {
-    project: { type: 'generic' },
-    commands: {},
-  }
-}
+/**
+ * Local Detect — 纯 fs 项目类型嗅探
+ *
+ * 把"生成本地配置"里的项目类型判定从 scan（半小时 + 大量 token）抽出来，
+ * 变成纯 fs 同步读几秒可完成的独立探测。create/gate 只需 project.type +
+ * commands，不该被迫跑完整 scan。
+ *
+ * 纯函数：不 spawn 任何子进程、不调用任何 AI/LLM、不消耗 token。
+ * 不写 local.yaml 到磁盘——只返回数据结构，落盘由调用方（CLI 路由 / scan.js）负责。
+ * 不引 yaml 依赖。
+ */
+
+import { existsSync, readFileSync } from 'fs'
+import { join } from 'path'
+
+/**
+ * 从 Makefile 文本提取 test 目标的命令（轻量正则，与 verify-postcheck 同风格）。
+ * 支持两种常见写法：
+ *   - 同行命令：`test: pytest`            → 'pytest'
+ *   - tab 续行：`test:\n\tpytest\n`        → 'pytest'（命令在下一 tab 开头行）
+ * 边界：
+ *   - 纯空目标（`test:` 无同行命令、无 tab 续行）→ 回退 'make test'
+ *   - 命令行内 `#` 注释截断；取第一个非空命令行
+ * @param {string} makefileText
+ * @returns {string}
+ */
+function parseMakefileTestCommand(makefileText) {
+  if (!makefileText) return 'make test'
+  // 定位 `test:` 行；捕获 `:` 后同行内容（同行命令或空）
+  const head = makefileText.match(/^test:\s*([^\n#]*?)\s*(?:#.*)?$/m)
+  if (!head) return 'make test'
+  const inline = (head[1] || '').trim()
+  if (inline) return inline
+  // 同行为空 → 找该行之后第一个 tab 续行命令（`\tcmd` 或 `    cmd`）
+  const after = makefileText.slice(head.index + head[0].length)
+  const cont = after.match(/^[ \t]+([^\n#]+?)\s*(?:#.*)?$/m)
+  if (cont && cont[1]) return cont[1].trim()
+  return 'make test'
+}
+
+/**
+ * 嗅探 workdir 的项目类型与默认 commands（纯 fs，零 AI / 零 token）。
+ *
+ * 嗅探规则（按顺序，命中即返回）：
+ *   - package.json → nodejs（核验 scripts.{build,test,lint} 存在才写对应键；缺失不写）
+ *   - pom.xml → maven（mvn compile / mvn test / mvn checkstyle:check）
+ *   - build.gradle → gradle（gradlew 存在用 ./gradlew 否则 gradle；build / test / check）
+ *   - Makefile → make（test 命令从 test: 目标解析；build/lint 无则不写）
+ *   - 都没有 → generic（commands 为空对象）
+ *
+ * @param {string} workdir - 项目根目录
+ * @returns {{
+ *   project: { type: 'nodejs'|'maven'|'gradle'|'make'|'generic' },
+ *   commands: { build?: string, test?: string, lint?: string }
+ * }}
+ */
+export function detectLocalYaml(workdir) {
+  // 1. nodejs
+  if (existsSync(join(workdir, 'package.json'))) {
+    const pkgPath = join(workdir, 'package.json')
+    const raw = readFileSync(pkgPath, 'utf8')
+    let pkg
+    try {
+      pkg = JSON.parse(raw)
+    } catch (e) {
+      throw new Error('package.json 解析失败：' + pkgPath)
+    }
+    const scripts = (pkg && pkg.scripts) || {}
+    const commands = {}
+    if (scripts.build) commands.build = 'npm run build'
+    if (scripts.test) commands.test = 'npm test'
+    if (scripts.lint) commands.lint = 'npm run lint'
+    return {
+      project: { type: 'nodejs' },
+      commands,
+    }
+  }
+
+  // 2. maven
+  if (existsSync(join(workdir, 'pom.xml'))) {
+    return {
+      project: { type: 'maven' },
+      commands: {
+        build: 'mvn compile',
+        test: 'mvn test',
+        lint: 'mvn checkstyle:check',
+      },
+    }
+  }
+
+  // 3. gradle
+  if (existsSync(join(workdir, 'build.gradle'))) {
+    const gradlePrefix = existsSync(join(workdir, 'gradlew')) ? './gradlew' : 'gradle'
+    return {
+      project: { type: 'gradle' },
+      commands: {
+        build: `${gradlePrefix} build`,
+        test: `${gradlePrefix} test`,
+        lint: `${gradlePrefix} check`,
+      },
+    }
+  }
+
+  // 4. make（test 命令从 Makefile 解析；build/lint 无则省略）
+  const makefilePath = join(workdir, 'Makefile')
+  if (existsSync(makefilePath)) {
+    const makefileText = readFileSync(makefilePath, 'utf8')
+    const test = parseMakefileTestCommand(makefileText)
+    return {
+      project: { type: 'make' },
+      commands: { test },
+    }
+  }
+
+  // 5. generic
+  return {
+    project: { type: 'generic' },
+    commands: {},
+  }
+}

package/src/machine-interface.js

@@ -7,7 +7,7 @@
  * 设计原则（见 change 2026-07-09-machine-interface-v1 design.md §2/§3）：
  *   - 方案 B：独立模块单点封装，不污染既有 run/progress 输出
  *   - 只聚合不新增校验：复用 stage-contract / task-review / verify-postcheck 既有策略引擎
- *   - 只读语义边界（D-002@v1）：只调 ProgressManager 读路径，不写 sillyspec.db / gate-status.json
+ *   - 只读语义边界（D-002@v1）：只调 ProgressManager 读路径，不写 sillyspec.db
  *   - stdout 纯 JSON（D-005@v1）：--json 模式下由 CLI 层（src/index.js 的 withJsonOutput）
  *     在调用 runGate/runDerive 期间劫持 console.log 到 stderr，防被调模块污染机器输出
  *   - 退出码 0/1/2 三段语义（D-004@v1）：0=通过，1=事实阻断，2=无法核验
@@ -18,8 +18,9 @@
 import { existsSync, readFileSync } from 'fs';
 import { join } from 'path';
 import { ProgressManager, resolveSpecDir } from './progress.js';
+import { resolveRuntimeRoot } from './run/shared.js';
 import { runValidators, checkTransition, checkExecuteCodeEvidence } from './stage-contract.js';
-import { validateTaskReviews } from './task-review.js';
+import { validateTaskReviews, resolveLatestExecuteRunId } from './task-review.js';
 import { runVerifyTestCheck } from './verify-postcheck.js';
 
 // ============ 退出码常量（D-004@v1）============
@@ -101,16 +102,35 @@ export function buildEnvelope({
  * @param {object} opts
  * @param {string} opts.cwd - 项目根目录
  * @param {string} [opts.specBase] - .sillyspec（或平台 specRoot）目录；默认 resolveSpecDir(cwd)
- * @param {string} [opts.runtimeRoot] - .runtime 目录；默认 join(specBase, '.runtime')
+ * @param {string} [opts.runtimeRoot] - .runtime 目录；默认 resolveRuntimeRoot 三级优先级解析
+ * @param {string} [opts.specDriftAnchor] - drift 场景主仓 specBase 锚点（坑 execute-runs-isolation）。
+ *   drift 守卫命中时由调用方传入，task-reviews 的 execute-run-id marker 落点经
+ *   resolveRuntimeRoot 锚主仓 .runtime，不读 worktree 副本（与 contract-matrix 调用方同语义）。
  * @returns {Promise<{ envelope: object, exitCode: number }>}
  */
-export async function runGate(stage, changeName, { cwd, specBase, runtimeRoot } = {}) {
+export async function runGate(stage, changeName, { cwd, specBase, runtimeRoot, specDriftAnchor } = {}) {
   const specRoot = specBase || resolveSpecDir(cwd);
   const pm = new ProgressManager();
 
   try {
+    // ── 只读契约守卫（D-002@v1）：db 不存在时 fail-closed 返回 exit 2，不触发建库落盘 ──
+    // pm.read → _ensureDB → db.init() 在 db 不存在/schema 戳落后时会 _createSchema + _save 落盘
+    // （db.js:init），这会让一个声明只读的查询命令在 spec 目录凭空建 sillyspec.db，违反只读契约。
+    // db 还没建 = 该变更从未跑过流程，无从核验 → 显式返回「无法核验」而非建库。
+    const dbPath = join(resolveSpecDir(cwd), '.runtime', 'sillyspec.db');
+    if (!existsSync(dbPath)) {
+      const envelope = buildEnvelope({
+        command: 'gate',
+        stage,
+        change: changeName,
+        ok: false,
+        errors: [`无法核验：进度库不存在（${dbPath}）——变更 ${changeName} 尚未运行过任何阶段，只读 gate 不会为其建库`],
+      });
+      return { envelope, exitCode: EXIT_UNKNOWN };
+    }
+
     // ── 读进度：变更不存在 → exit 2（D-004@v1）──
-    const progress = await pm.read(cwd, changeName);
+    const progress = pm.read(cwd, changeName);
     if (!progress) {
       const envelope = buildEnvelope({
         command: 'gate',
@@ -181,13 +201,14 @@ export async function runGate(stage, changeName, { cwd, specBase, runtimeRoot }
         }
       }
 
-      const rtRoot = runtimeRoot || join(specRoot, '.runtime');
-      const runIdFile = join(rtRoot, `current-execute-run-id-${changeName}`);
+      // drift 场景经 resolveRuntimeRoot 三级优先级解析（runtimeRoot > specDriftAnchor > 本地兜底），
+      // 锚主仓 .runtime，不读 worktree 副本（坑 execute-runs-isolation，与 contract-matrix 调用方同语义）
+      const rtRoot = resolveRuntimeRoot({ runtimeRoot, specDriftAnchor }, specRoot);
+      // marker 缺失/为空时先扫描 execute-runs/ 找回真实 runId（与 gates.js #6 同源），
+      // 避免拿 '' 进 validateTaskReviews 拼出 execute-runs//tasks/... 产出全量误导 errors。
       let executeRunId = '';
       try {
-        if (existsSync(runIdFile)) {
-          executeRunId = readFileSync(runIdFile, 'utf8').trim();
-        }
+        executeRunId = resolveLatestExecuteRunId({ runtimeRoot: rtRoot, changeName }) || '';
       } catch {
         executeRunId = '';
       }
@@ -300,7 +321,7 @@ export const FACETS = ['execute-evidence', 'verify-test', 'task-reviews', 'artif
  * 与 gate 的差异：gate 聚合某阶段所有 check 的综合结论；derive 只返回单一 facet 的结构化 data，
  * daemon 用来做细粒度事实采集（如轮询 execute-evidence 判断代码是否变更）。
  *
- * 只读语义边界同 gate（D-002@v1）：仅调 ProgressManager.read，不写 sillyspec.db / gate-status.json。
+ * 只读语义边界同 gate（D-002@v1）：仅调 ProgressManager.read，不写 sillyspec.db。
  * 唯一例外是 verify-test 会真实执行测试并落盘 test-result.json（产物取证，非状态写入，design §3.3）。
  *
  * 退出码语义（D-004@v1）：0=事实通过，1=事实性阻断，2=无法核验（用法错/变更不存在/内部异常）。
@@ -310,10 +331,12 @@ export const FACETS = ['execute-evidence', 'verify-test', 'task-reviews', 'artif
  * @param {object} opts
  * @param {string} opts.cwd - 项目根目录
  * @param {string} [opts.specBase] - .sillyspec（或平台 specRoot）目录；默认 resolveSpecDir(cwd)
- * @param {string} [opts.runtimeRoot] - .runtime 目录；默认 join(specBase, '.runtime')
+ * @param {string} [opts.runtimeRoot] - .runtime 目录；默认 resolveRuntimeRoot 三级优先级解析
+ * @param {string} [opts.specDriftAnchor] - drift 场景主仓 specBase 锚点（坑 execute-runs-isolation），
+ *   task-reviews facet 的 execute-run-id marker 落点经 resolveRuntimeRoot 锚主仓 .runtime，不读副本。
  * @returns {Promise<{ envelope: object, exitCode: number }>}
  */
-export async function runDerive(facet, changeName, { cwd, specBase, runtimeRoot } = {}) {
+export async function runDerive(facet, changeName, { cwd, specBase, runtimeRoot, specDriftAnchor } = {}) {
   // ── 非法 facet：用法错 → exit 2（D-004@v1）──
   if (!FACETS.includes(facet)) {
     const envelope = buildEnvelope({
@@ -330,8 +353,21 @@ export async function runDerive(facet, changeName, { cwd, specBase, runtimeRoot
   const pm = new ProgressManager();
 
   try {
+    // ── 只读契约守卫（D-002@v1，同 runGate）：db 不存在时 fail-closed 返回 exit 2，不建库落盘 ──
+    const dbPath = join(resolveSpecDir(cwd), '.runtime', 'sillyspec.db');
+    if (!existsSync(dbPath)) {
+      const envelope = buildEnvelope({
+        command: 'derive',
+        facet,
+        change: changeName,
+        ok: false,
+        errors: [`无法核验：进度库不存在（${dbPath}）——变更 ${changeName} 尚未运行过任何阶段，只读 derive 不会为其建库`],
+      });
+      return { envelope, exitCode: EXIT_UNKNOWN };
+    }
+
     // ── 读进度：变更不存在 → exit 2 ──
-    const progress = await pm.read(cwd, changeName);
+    const progress = pm.read(cwd, changeName);
     if (!progress) {
       const envelope = buildEnvelope({
         command: 'derive',
@@ -399,13 +435,12 @@ export async function runDerive(facet, changeName, { cwd, specBase, runtimeRoot
           }
         }
 
-        const rtRoot = runtimeRoot || join(specRoot, '.runtime');
-        const runIdFile = join(rtRoot, `current-execute-run-id-${changeName}`);
+        // drift 场景经 resolveRuntimeRoot 三级优先级解析（同 runGate execute 段），锚主仓 .runtime 不读副本
+        const rtRoot = resolveRuntimeRoot({ runtimeRoot, specDriftAnchor }, specRoot);
+        // marker 缺失/为空时先扫描 execute-runs/ 找回真实 runId（同 runGate execute 段），避免拿 '' 误导校验
         let executeRunId = '';
         try {
-          if (existsSync(runIdFile)) {
-            executeRunId = readFileSync(runIdFile, 'utf8').trim();
-          }
+          executeRunId = resolveLatestExecuteRunId({ runtimeRoot: rtRoot, changeName }) || '';
         } catch {
           executeRunId = '';
         }

package/src/migrate.js

@@ -1,4 +1,4 @@
-import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync, renameSync, copyFileSync } from 'fs';
+import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync, renameSync, copyFileSync, statSync, cpSync } from 'fs';
 import { basename, join, resolve } from 'path';
 import chalk from 'chalk';
 
@@ -60,9 +60,19 @@ export function migrateDocs(projectDir) {
       const src = join(archiveDir, entry);
       const dest = join(targetDir, entry);
       if (!existsSync(dest)) {
-        copyFileSync(src, dest);
-        console.log(chalk.green('  ✅') + ` archive/${entry}`);
-        migrated++;
+        // 归档变更本身是目录（含 design.md 等），copyFileSync 对目录源抛 EISDIR；
+        // 按类型分发：目录用 cpSync 递归、文件用 copyFileSync，单条失败 try/catch 不中断整体迁移
+        try {
+          if (statSync(src).isDirectory()) {
+            cpSync(src, dest, { recursive: true });
+          } else {
+            copyFileSync(src, dest);
+          }
+          console.log(chalk.green('  ✅') + ` archive/${entry}`);
+          migrated++;
+        } catch (err) {
+          console.log(chalk.yellow('  ⚠️') + ` archive/${entry} 迁移失败: ${err.message}`);
+        }
       } else {
         console.log(chalk.yellow('  ⏭️') + ` archive/${entry} (已存在)`);
       }

package/src/modules.js

@@ -60,7 +60,7 @@ function parseModuleCardFrontmatter(content) {
  *   - verify_commands: 验证命令（build/test/lint）
  *   - related_docs: 关联文档路径
  */
-export async function rebuildModuleMap(cwd) {
+export async function rebuildModuleMap(cwd, { force = false } = {}) {
   const mapPath = findModuleMapPath(cwd);
   if (!mapPath) {
     console.error('❌ 未找到 .sillyspec/docs/<project>/modules/ 目录');
@@ -162,6 +162,13 @@ export async function rebuildModuleMap(cwd) {
     yaml += `\n`;
   }
 
+  // 破坏性保护（multi-agent-platform 坑 modules-rebuild-destructive）：默认 dry-run 只预览不写，--force 才覆盖。
+  if (!force && existingMap) {
+    console.log('⚠️  rebuild 默认不写入（破坏性保护）：该命令会覆盖 _module-map.yaml，清空 tags/entrypoints/main_symbols/depends_on/used_by 等手动维护字段');
+    console.log('    本次为预览，未写入磁盘。确认覆盖请运行：sillyspec modules rebuild --force');
+    return { dryRun: true, path: mapPath }
+  }
+
   writeFileSync(mapPath, yaml, 'utf8');
   console.log(`✅ _module-map.yaml 已重建：${mapPath}`);
   console.log(`   模块数量：${allModuleIds.size}`);
@@ -170,6 +177,7 @@ export async function rebuildModuleMap(cwd) {
   }
   console.log(`\n⚠️  注意：rebuild 只重建骨架。tags/entrypoints/main_symbols/depends_on/used_by 需要重新运行 scan 或手动补充。`);
   console.log(`ℹ️  schema 已升级到 v2，支持 role/core_files/test_files/entrypoints/depends_on/risk_level/verify_commands 等字段。`);
+  return { dryRun: false, path: mapPath, modules: allModuleIds.size }
 }
 
 /**
@@ -278,7 +286,10 @@ export async function generateDependenciesMd(cwd) {
   console.log(`✅ dependencies.md 已生成`);
 }
 
-function parseModuleMapSimple(content) {
+// _module-map.yaml 简单 YAML 解析（模块上下文索引）。canonical 单一真相源——run/prompt.js
+// 的 loadModuleContextIndex 与本文件 generateDependenciesMd 共用此函数（合并历史两份分叉副本，
+// 2026-08-07；字段集取并集：core_files/test_files/related_docs/verify_commands + role/risk_level）。
+export function parseModuleMapSimple(content) {
   const modules = {};
   let currentModule = null;
   let currentKey = null;
@@ -299,7 +310,7 @@ function parseModuleMapSimple(content) {
     if (!currentModule) continue;
 
     // Array field like depends_on:\n  - xxx
-    const arrayFieldMatch = line.match(/^    (depends_on|used_by|paths|tags|aliases|entrypoints|main_symbols|review_reasons):$/);
+    const arrayFieldMatch = line.match(/^    (depends_on|used_by|paths|tags|aliases|entrypoints|main_symbols|review_reasons|core_files|test_files|related_docs|verify_commands):$/);
     if (arrayFieldMatch) {
       if (currentArray && currentKey) modules[currentModule][currentKey] = currentArray;
       currentKey = arrayFieldMatch[1];
@@ -308,7 +319,7 @@ function parseModuleMapSimple(content) {
     }
 
     // Inline array like tags: [a, b]
-    const inlineArrayMatch = line.match(/^    (depends_on|used_by|paths|tags|aliases|entrypoints|main_symbols|review_reasons): \[(.*)\]$/);
+    const inlineArrayMatch = line.match(/^    (depends_on|used_by|paths|tags|aliases|entrypoints|main_symbols|review_reasons|core_files|test_files|related_docs|verify_commands): \[(.*)\]$/);
     if (inlineArrayMatch) {
       if (currentArray && currentKey) modules[currentModule][currentKey] = currentArray;
       const vals = inlineArrayMatch[2].split(',').map(v => v.trim()).filter(Boolean);
@@ -319,7 +330,7 @@ function parseModuleMapSimple(content) {
     }
 
     // Scalar field
-    const scalarMatch = line.match(/^    (status|doc|needs_review): (.+)$/);
+    const scalarMatch = line.match(/^    (status|doc|needs_review|role|risk_level): (.+)$/);
     if (scalarMatch) {
       if (currentArray && currentKey) { modules[currentModule][currentKey] = currentArray; currentArray = null; currentKey = null; }
       modules[currentModule][scalarMatch[1]] = scalarMatch[2];