@luckychen1993/pm-mcp 0.1.2 → 0.1.4

package/README.md

@@ -25,6 +25,7 @@ AI 编码项目的典型失控（本工具逐一给出机制）：
 | 调试过程随会话消失 | `log_debug` 调试知识账（症状/根因/修法/验证） |
 | 长任务崩溃、上下文丢失 | 任务步骤清单 + `checkpoint` 断点存档，新会话从恢复点续做 |
 | 团队协作与知识传递 | Git 项目中共享 `.pm/` + 会话署名 + `onboard` 入职简报工作流 |
+| 多 Agent 重复读写 | 实际重叠的同参读跨进程合并；写工具支持业务幂等键、瞬时自动去重与故障不确定态 fail-closed |
 | token 猛烧 | 三段式定位 + 读类工具输出硬预算 + 文件用途索引 |
 | 法律知识产权 | `audit_license` 依赖许可证/copyleft 冲突 + 来源登记（provenance） |
 | 测试投机（删测试、skip 凑绿） | 禁用/蒸发/空测试检测 + 功能测试背书占比 + done 必附验证 |
@@ -52,7 +53,7 @@ npx -y @luckychen1993/pm-mcp@latest setup --dry-run
 Codex 的本地客户端共享同一份 MCP 配置。复制执行：
 
 ```bash
-codex mcp add pm-mcp -- npx -y @luckychen1993/pm-mcp@0.1.2
+codex mcp add pm-mcp -- npx -y @luckychen1993/pm-mcp@0.1.4
 ```
 
 重启客户端后可用 `codex mcp list` 检查。该命令遵循 [OpenAI 官方 MCP CLI 格式](https://learn.chatgpt.com/docs/extend/mcp?surface=cli)。
@@ -60,7 +61,7 @@ codex mcp add pm-mcp -- npx -y @luckychen1993/pm-mcp@0.1.2
 #### Claude Code
 
 ```bash
-claude mcp add pm-mcp --scope user -- npx -y @luckychen1993/pm-mcp@0.1.2
+claude mcp add pm-mcp --scope user -- npx -y @luckychen1993/pm-mcp@0.1.4
 ```
 
 #### ZCode、Cursor、VS Code（Windows 备用脚本）
@@ -68,7 +69,7 @@ claude mcp add pm-mcp --scope user -- npx -y @luckychen1993/pm-mcp@0.1.2
 将 `<client>` 替换为 `zcode`、`cursor` 或 `vscode`，整行复制到 PowerShell：
 
 ```powershell
-$u='https://raw.githubusercontent.com/happy520ai/pm-mcp/v0.1.2/install.ps1'; $f=Join-Path $env:TEMP 'install-pm-mcp.ps1'; Invoke-WebRequest $u -OutFile $f; & $f -Client <client>
+$u='https://raw.githubusercontent.com/happy520ai/pm-mcp/v0.1.4/install.ps1'; $f=Join-Path $env:TEMP 'install-pm-mcp.ps1'; Invoke-WebRequest $u -OutFile $f; & $f -Client <client>
 ```
 
 脚本只写对应客户端的 MCP 配置；已有 JSON 配置会先生成带时间戳的备份。建议执行前先打开 [`install.ps1`](install.ps1) 审阅。ZCode 默认写入 `$ZCODE_HOME/cli/config.json` 或 `~/.zcode/cli/config.json`，Cursor 默认写入 `~/.cursor/mcp.json`；也可用 `-ConfigPath` 指定路径。
@@ -80,7 +81,7 @@ $u='https://raw.githubusercontent.com/happy520ai/pm-mcp/v0.1.2/install.ps1'; $f=
   "mcpServers": {
     "pm-mcp": {
       "command": "npx",
-      "args": ["-y", "@luckychen1993/pm-mcp@0.1.2"],
+      "args": ["-y", "@luckychen1993/pm-mcp@0.1.4"],
       "env": {}
     }
   }
@@ -153,6 +154,10 @@ snapshot_codebase + audit_structure 对账；audit_security 安全体检；audit
 
 Resources：`pm://dashboard`、`pm://roadmap`、`pm://tasks`、`pm://changelog`、`pm://architecture`、`pm://portfolio`、`pm://acceptance`。
 
+所有写工具都接受可选 `idempotency_key`。同一业务的多个 Agent 应传同一个稳定键（例如 `T-123:add-login-task`）：同键同参数只执行一次并复用首次结果，同键不同参数直接拒绝。即使没有显式键，完全相同的并发写也会在短窗口内自动合并；完全相同的并行读会等待首个执行者并复用结果。
+
+并发保证有明确边界：正常运行的同键写只落一次，follower 最多等待 3 秒复用首次结果；仍未完成时以 MCP error 返回 pending，不把占位冒充成功。若进程在业务写入后、幂等完成记录前被强杀，pm-mcp 会把该键标为 `uncertain` 并禁止自动重放。它提供的是 **at-most-once + 不确定时 fail-closed**，不是跨多个 JSON 文件的事务型 exactly-once；核对目标账本后才能决定是否换新键。v0.1.3 的标准全局幂等记录会在首次复用时迁移到项目运行态，旧文件保留以便回滚。读合并只覆盖业务处理实际重叠的在途请求，完成结果不会继续缓存，避免外部代码刚变化却返回旧内容。每个项目由 SQLite 生命周期选举一个 watcher leader，其余进程低频待命；leader 被强杀后由一个 standby 接管。结构、安全、许可证与快照等权威审计强制重读内容，不把 `fs.watch` 或 mtime/size 缓存的最终一致性冒充强一致性。
+
 ## 数据模型（被管理项目内的 `.pm/`；JSON/Markdown 账本可 git diff，`index.db` 是忽略并可重建的缓存）
 
 ```
@@ -175,7 +180,7 @@ PROJECT.md        # 仓库根，自动生成的仪表盘（勿手改）
 changelog.md      # 自动生成
 ```
 
-全局注册表：`~/.pm-mcp/registry.json`。
+全局注册表：`~/.pm-mcp/registry.json`。跨进程读合并、写幂等、恢复锁与 watcher 选举运行态位于被管理项目的 `.pm/.runtime/`，由 `.pm/.gitignore` 排除；因此路径别名、不同客户端或不同 `PM_MCP_HOME` 仍共享同一协调域，但运行态不会进入 Git。
 
 ## 跨文件、跨模块、跨语言治理
 
@@ -252,6 +257,7 @@ npm run benchmark:volume -- --size-gib 20 --file-bytes 1048576 --full-audit --te
 - **许可证审计**覆盖直接+传递 Node 依赖（npm 嵌套与 pnpm 布局）；语言单元虽可跨生态发现，但许可证深度仍不是所有生态的通用供应链图，也不替代法务意见。
 - **测试背书占比**是代理指标（功能是否挂了真实存在的测试文件），不是行覆盖率。
 - **token 消耗**本身是客户端的账，工具用「足迹/产出比」做空转代理指标。
+- 幂等层能避免重复计算、重复落账并缩短重复调用输出，但无法返还模型在发起 MCP 调用前已经消耗的推理 token；客户端/Agent 编排仍应避免无意义扇出。
 - 结构/安全扫描忽略内置目录（node_modules/.git/dist/build/venv 等）与常见二进制/锁文件，尚不通用解析 `.gitignore`；`search_code` 的 rg 后端会解析。目录深度上限 64 层（超限计数上报，不静默）。
 - **仓库提供 fail-closed 巡检命令**；定时器、托管 CI 与会话 hooks 属部署层，必须在相应环境单独配置和监控。
 - 语义层面无法强制的（笔记内容是否属实、AI 是否真跑了测试）依赖 git 对账与审计交叉验证，不承诺语义级防伪。

package/dist/acceptance-tools.js

@@ -7,7 +7,7 @@ import { acceptanceBaselineFingerprint, evaluateAcceptance } from "./acceptance-
 import { writeAcceptanceReport } from "./acceptance-report.js";
 import { requireInitialized } from "./paths.js";
 import { loadJson, saveJson, withLedgerLock } from "./store.js";
-import { tool } from "./tool-base.js";
+import { toolI, toolR } from "./tool-base.js";
 import { refreshDerived } from "./dashboard.js";
 const IdSchema = z.string().trim().min(1).max(120).regex(/^[A-Za-z0-9][A-Za-z0-9._:-]*$/);
 const SemVerSchema = z.string().regex(/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/);
@@ -269,11 +269,11 @@ export function evaluateAcceptanceFile(root, input) {
     return { report, ...files };
 }
 export function registerAcceptanceTools(server, root) {
-    tool(server, "list_acceptance_baselines", "列出版本化验收基线、审批状态、当前 fingerprint 和规模。", {}, () => {
+    toolR(server, root, "list_acceptance_baselines", "列出版本化验收基线、审批状态、当前 fingerprint 和规模。", {}, () => {
         requireInitialized(root);
         return JSON.stringify(listAcceptanceBaselines(root), null, 2);
     });
-    tool(server, "get_acceptance_baseline", "读取一个验收基线；默认返回摘要，full=true 返回严格 JSON。", {
+    toolR(server, root, "get_acceptance_baseline", "读取一个验收基线；默认返回摘要，full=true 返回严格 JSON。", {
         baseline_id: IdSchema,
         baseline_version: SemVerSchema,
         full: z.boolean().optional(),
@@ -284,14 +284,14 @@ export function registerAcceptanceTools(server, root) {
             return JSON.stringify(baseline, null, 2);
         return JSON.stringify(listAcceptanceBaselines(root).find((item) => item.id === args.baseline_id && item.version === args.baseline_version), null, 2);
     });
-    tool(server, "save_acceptance_baseline_draft", "从项目内 .pm/acceptance 下的严格 JSON 保存 draft 基线；批准后的同版本不可覆盖。", {
+    toolI(server, root, "save_acceptance_baseline_draft", "从项目内 .pm/acceptance 下的严格 JSON 保存 draft 基线；批准后的同版本不可覆盖。", {
         baseline_file: JsonPathSchema,
     }, (args) => {
         requireInitialized(root);
         const baseline = saveDraftAcceptanceBaselineFile(root, args.baseline_file);
         return `✅ draft ${baseline.baseline_id}@${baseline.baseline_version} 已保存；fingerprint=${acceptanceBaselineFingerprint(baseline)}`;
     });
-    tool(server, "approve_acceptance_baseline", "按当前 SHA-256 fingerprint 原子批准基线；fingerprint 变化即拒绝，批准后修改必须升版。", {
+    toolI(server, root, "approve_acceptance_baseline", "按当前 SHA-256 fingerprint 原子批准基线；fingerprint 变化即拒绝，批准后修改必须升版。", {
         baseline_id: IdSchema,
         baseline_version: SemVerSchema,
         expected_fingerprint_sha256: Sha256Schema,
@@ -303,7 +303,7 @@ export function registerAcceptanceTools(server, root) {
         const approved = approveAcceptanceBaseline(root, args);
         return `✅ baseline ${approved.baseline_id}@${approved.baseline_version} 已批准；approved fingerprint=${acceptanceBaselineFingerprint(approved)}`;
     });
-    tool(server, "evaluate_acceptance", "读取项目内 .pm/acceptance evaluation JSON，逐项复算证据 SHA-256，再生成不可手填、不可覆盖的正式报告。", {
+    toolI(server, root, "evaluate_acceptance", "读取项目内 .pm/acceptance evaluation JSON，逐项复算证据 SHA-256，再生成不可手填、不可覆盖的正式报告。", {
         baseline_id: IdSchema,
         baseline_version: SemVerSchema,
         evaluation_file: JsonPathSchema,

package/dist/audit-tools.js

@@ -5,26 +5,27 @@ import { refreshDerived } from "./dashboard.js";
 import { auditLicense } from "./license.js";
 import { isInitialized, requireInitialized } from "./paths.js";
 import { listRegistry } from "./registry.js";
-import { auditSecurity, listFindings, resolveFinding } from "./security.js";
-import { budgetLines, tool, toolW } from "./tool-base.js";
+import { auditSecurity, listFindings, prepareSecurityAudit, resolveFinding } from "./security.js";
+import { budgetLines, toolR, toolW } from "./tool-base.js";
+import { walkRefresh } from "./index-store.js";
 export function registerAuditTools(server, root) {
     toolW(server, root, "snapshot_codebase", "给代码结构拍快照（文件数/行数/目录分布/测试数/skip 标记/依赖清单）。之后 audit_structure 会与上次快照 diff。建议每个会话或每个里程碑结束时拍一次。", {}, () => {
         requireInitialized(root);
         const { snapshot, summary } = snapshotCodebase(root);
         refreshDerived(root);
         return [...summary, `下次 audit_structure 将以此为基线（${snapshot.file}）。`].join("\n");
-    });
-    tool(server, "audit_structure", "八项结构对账（定期做）：①增长与新增依赖 ②漂移对账（功能↔文件，防幻觉）③债务与重构配额 ④churn 热点 ⑤复杂度预算 ⑥索引覆盖率 ⑦足迹/产出 ⑧测试健康（禁用/蒸发/空测试/背书占比）。", {}, () => {
+    }, () => { requireInitialized(root); walkRefresh(root, { forceContent: true }); });
+    toolR(server, root, "audit_structure", "八项结构对账（定期做）：①增长与新增依赖 ②漂移对账（功能↔文件，防幻觉）③债务与重构配额 ④churn 热点 ⑤复杂度预算 ⑥索引覆盖率 ⑦足迹/产出 ⑧测试健康（禁用/蒸发/空测试/背书占比）。", {}, () => {
         requireInitialized(root);
-        return auditStructure(root, budgetLines(root));
+        return auditStructure(root, budgetLines(root), true);
     });
-    toolW(server, root, "audit_security", "安全体检（只扫描本地、不联网，结果写入安全台账）：密钥泄露 / 危险模式（eval、SQL 拼接、禁用证书校验等）/ 依赖风险。修复后重扫自动关闭；接受风险必须留理由。", {}, () => {
+    toolW(server, root, "audit_security", "安全体检（只扫描本地、不联网，结果写入安全台账）：密钥泄露 / 危险模式（eval、SQL 拼接、禁用证书校验等）/ 依赖风险。修复后重扫自动关闭；接受风险必须留理由。", {}, (_args, prepared) => {
         requireInitialized(root);
-        const report = auditSecurity(root);
+        const report = auditSecurity(root, prepared);
         refreshDerived(root);
         return report.text.join("\n");
-    });
-    tool(server, "list_findings", "查看安全台账（可按状态过滤）。", { status: z.enum(["open", "fixed", "accepted"]).optional() }, (args) => {
+    }, () => { requireInitialized(root); return prepareSecurityAudit(root); });
+    toolR(server, root, "list_findings", "查看安全台账（可按状态过滤）。", { status: z.enum(["open", "fixed", "accepted"]).optional() }, (args) => {
         requireInitialized(root);
         const list = listFindings(root, args.status);
         if (list.length === 0)
@@ -42,13 +43,13 @@ export function registerAuditTools(server, root) {
         refreshDerived(root);
         return `✅ ${f.id} 已置为 ${f.status}${f.note ? `（${f.note}）` : ""}。`;
     });
-    tool(server, "audit_license", "许可证审计（法律账）：依赖许可证清单与 copyleft 冲突、源码中的 GPL 家族许可证头、LICENSE 文件检查、来源登记清单。离线启发式，不替代法务。", {}, () => {
+    toolR(server, root, "audit_license", "许可证审计（法律账）：依赖许可证清单与 copyleft 冲突、源码中的 GPL 家族许可证头、LICENSE 文件检查、来源登记清单。离线启发式，不替代法务。", {}, () => {
         requireInitialized(root);
-        return auditLicense(root, budgetLines(root));
+        return auditLicense(root, budgetLines(root), true);
     });
 }
-export function registerRegistryTools(server) {
-    tool(server, "list_projects", "列出本机所有被 pm-mcp 管理的项目（全局注册表）。", {}, () => {
+export function registerRegistryTools(server, root) {
+    toolR(server, root, "list_projects", "列出本机所有被 pm-mcp 管理的项目（全局注册表）。", {}, () => {
         const list = listRegistry();
         if (list.length === 0)
             return "（注册表为空。在任何项目里 init_project 后会自动登记。）";

package/dist/audit.js

@@ -5,7 +5,7 @@ import { loadFeatures, loadFileNotes, loadProject, loadRoadmap, loadSessions, lo
 import { decisionsDir, pmPath, snapshotsDir } from "./paths.js";
 import { normSep, foldLines } from "./budget.js";
 import { readDirectDeps } from "./scan.js";
-import { aggregates, ensureFresh, getIndex, getMeta } from "./index-store.js";
+import { aggregates, ensureFresh, freshness, getIndex, getMeta, walkRefresh } from "./index-store.js";
 import { quotaWarnings, milestoneStats } from "./roadmap.js";
 import { blastRadiusWarning, churnStats, debtAging, footprint } from "./health.js";
 import { now } from "./types.js";
@@ -21,8 +21,11 @@ export function annotatedCount(root, db) {
     }
     return n;
 }
-export function snapshotCodebase(root) {
-    ensureFresh(root);
+export function snapshotCodebase(root, forceFresh = false, indexPrepared = false) {
+    if (forceFresh)
+        walkRefresh(root, { forceContent: true });
+    else if (!indexPrepared)
+        ensureFresh(root);
     const db = getIndex(root);
     const agg = aggregates(db);
     const annotated = annotatedCount(root, db);
@@ -165,13 +168,15 @@ export function gitAudit(root) {
     return out;
 }
 /** 完整结构对账：九项报告 */
-export function auditStructure(root, maxLines = 150) {
+export function auditStructure(root, maxLines = 150, forceFresh = false, indexPrepared = false) {
     const project = loadProject(root);
     const { features } = loadFeatures(root);
     const { tasks } = loadTasks(root);
     const { milestones } = loadRoadmap(root);
     const { sessions } = loadSessions(root);
-    const fresh = ensureFresh(root);
+    const fresh = forceFresh
+        ? { used: "walk", freshness: (walkRefresh(root, { forceContent: true }), freshness(root)) }
+        : indexPrepared ? { used: "walk", freshness: freshness(root) } : ensureFresh(root);
     const db = getIndex(root);
     const agg = aggregates(db);
     const deps = readDirectDeps(root).deps;

package/dist/governance-tools.js

@@ -1,6 +1,6 @@
 import path from "node:path";
 import { z } from "zod";
-import { budgetLines, tool, toolW } from "./tool-base.js";
+import { budgetLines, toolI, toolR, toolW } from "./tool-base.js";
 import { foldLines } from "./budget.js";
 import { refreshDerived } from "./dashboard.js";
 import { requireInitialized } from "./paths.js";
@@ -64,13 +64,13 @@ function qualityLines(commands) {
     return commands.map((command, index) => `${index + 1}. [${command.kind}] (${command.cwd}) ${command.command} ${command.args.join(" ")}`);
 }
 export function registerGovernanceTools(server, root) {
-    tool(server, "init_governance", "为旧项目初始化 .pm/governance.json；新项目 init_project 已自动创建。", {}, () => {
+    toolI(server, root, "init_governance", "为旧项目初始化 .pm/governance.json；新项目 init_project 已自动创建。", {}, () => {
         requireInitialized(root);
         const governance = initGovernance(root, {});
         refreshDerived(root);
         return `✅ 治理模型已初始化（schema v${governance.schema_version}）。下一步用 upsert_module 声明模块、owner 与语言。`;
     });
-    tool(server, "get_governance", "查看结构化模块、owner、公开接口、仓库依赖与强制策略。", {}, () => {
+    toolR(server, root, "get_governance", "查看结构化模块、owner、公开接口、仓库依赖与强制策略。", {}, () => {
         requireInitialized(root);
         return compactGovernance(loadGovernance(root));
     });
@@ -140,7 +140,7 @@ export function registerGovernanceTools(server, root) {
         refreshDerived(root);
         return `✅ 治理策略已更新：coverage>=${governance.policies.minimum_coverage_pct}% · semantic>=${governance.policies.minimum_semantic_assurance} · regex-fallback=${governance.policies.fail_on_semantic_fallback ? "forbidden" : "allowed"}`;
     });
-    tool(server, "discover_languages", "递归发现 Node/Python/Go/Rust/JVM/.NET 单元及其受控质量命令，不执行命令。", {}, () => {
+    toolR(server, root, "discover_languages", "递归发现 Node/Python/Go/Rust/JVM/.NET 单元及其受控质量命令，不执行命令。", {}, () => {
         requireInitialized(root);
         const units = discoverProjectUnits(root);
         const coverage = assessQualityCoverage(units);
@@ -151,15 +151,15 @@ export function registerGovernanceTools(server, root) {
             lines.push(`- 🚩 无质量命令: ${coverage.withoutCommands.join(", ")}`);
         return foldLines(lines, { maxLines: budgetLines(root), hint: "按模块拆分治理 root" });
     });
-    tool(server, "audit_governance", "审计跨文件/模块/语言语义覆盖、owner、公开接口、依赖边界、循环、unresolved 与质量矩阵覆盖。", {}, () => {
+    toolR(server, root, "audit_governance", "审计跨文件/模块/语言语义覆盖、owner、公开接口、依赖边界、循环、unresolved 与质量矩阵覆盖。", {}, () => {
         requireInitialized(root);
         return auditGovernance(root, budgetLines(root)).report;
     });
-    tool(server, "list_semantic_evidence", "列出已登记的语言原生 AST、编译器或运行时语义证据；损坏文档会使整次读取失败。", {}, () => {
+    toolR(server, root, "list_semantic_evidence", "列出已登记的语言原生 AST、编译器或运行时语义证据；损坏文档会使整次读取失败。", {}, () => {
         requireInitialized(root);
         return JSON.stringify(listSemanticEvidence(root), null, 2);
     });
-    tool(server, "save_semantic_evidence", "保存一份绑定源码 SHA-256 的语言原生 AST/编译器/运行时证据；过期摘要在治理审计中严格失败。", {
+    toolI(server, root, "save_semantic_evidence", "保存一份绑定源码 SHA-256 的语言原生 AST/编译器/运行时证据；过期摘要在治理审计中严格失败。", {
         id: z.string().trim().min(1).max(128),
         document: SemanticEvidenceDocumentSchema,
     }, (args) => {
@@ -167,7 +167,7 @@ export function registerGovernanceTools(server, root) {
         const saved = saveSemanticEvidence(root, args.id, args.document);
         return `✅ semantic evidence ${args.id} 已保存：${saved.file} · ${saved.analyzer.id} · ${saved.analyzer.assurance} · ${saved.status}`;
     });
-    tool(server, "impact_analysis", "从变更文件沿 file/module 反向依赖闭包计算受影响文件与模块。", {
+    toolR(server, root, "impact_analysis", "从变更文件沿 file/module 反向依赖闭包计算受影响文件与模块。", {
         files: z.array(z.string().min(1)).min(1).max(100),
     }, (args) => {
         requireInitialized(root);
@@ -180,7 +180,7 @@ export function registerGovernanceTools(server, root) {
             ...(impact.unknownChangedFiles.length ? [`⚠️ 未进入语义图: ${impact.unknownChangedFiles.join(", ")}`] : []),
         ], { maxLines: budgetLines(root), hint: "缩小 files 输入或按模块运行" });
     });
-    tool(server, "plan_quality_matrix", "生成跨语言真实质量命令计划；只规划，不启动进程。", {
+    toolR(server, root, "plan_quality_matrix", "生成跨语言真实质量命令计划；只规划，不启动进程。", {
         unit: z.string().optional(),
         kinds: z.array(z.enum(["test", "build", "lint", "typecheck", "coverage", "security"])).optional(),
     }, (args) => {
@@ -192,7 +192,7 @@ export function registerGovernanceTools(server, root) {
             ...(plan.coverage.withoutCommands.length ? [`🚩 无命令单元: ${plan.coverage.withoutCommands.join(", ")}`] : []),
         ], { maxLines: budgetLines(root), hint: "用 unit/kinds 过滤；真实执行需 run_quality_matrix confirm_execute=true" });
     });
-    tool(server, "run_quality_matrix", "显式执行跨语言质量矩阵。只运行受支持适配器生成的 argv，shell=false；缺工具/超时/非零均失败。", {
+    toolI(server, root, "run_quality_matrix", "显式执行跨语言质量矩阵。只运行受支持适配器生成的 argv，shell=false；缺工具/超时/非零均失败。", {
         confirm_execute: z.literal(true).describe("必须显式为 true；该操作会运行目标项目构建/测试命令"),
         unit: z.string().optional(),
         kinds: z.array(z.enum(["test", "build", "lint", "typecheck", "coverage", "security"])).optional(),
@@ -219,7 +219,7 @@ export function registerGovernanceTools(server, root) {
             lines.push(`- [${item.status}] ${item.command.kind} ${item.command.cwd} (${item.durationMs}ms${item.exitCode === null ? "" : `, exit ${item.exitCode}`})`);
         return foldLines(lines, { maxLines: budgetLines(root), hint: "查看 .pm/quality-runs 结构化摘要（不落原始输出）" });
     });
-    tool(server, "get_portfolio", "聚合当前项目或全局注册项目的阶段、里程碑、债务、安全、语言、跨仓依赖/版本/cycle；加载失败不能假绿。", {
+    toolR(server, root, "get_portfolio", "聚合当前项目或全局注册项目的阶段、里程碑、债务、安全、语言、跨仓依赖/版本/cycle；加载失败不能假绿。", {
         current_only: z.boolean().optional(),
     }, (args) => {
         requireInitialized(root);