soloforge 1.3.3 → 1.3.5

package/README.md

@@ -8,6 +8,15 @@ AI 编程助手的项目工作流配置器。SoloForge 帮你把 Claude Code、C
 - 你希望每个项目都有稳定的 AI 工作流规则，而不是每次从零解释。
 - 你希望 AI 修改代码前先理解项目边界，生成产物时不要误改源码。
 - 你希望配置可以自动推断，但不要在低置信度时乱写项目配置。
+- 你希望 AI 写业务代码时能遵守必要注释、结构化日志、敏感信息脱敏和交付复验要求。
+
+## 核心能力
+
+- **下一步导航**: `soloforge next` 会根据当前阶段、阻断项和已有证据提示下一步，而不是只报告状态。
+- **设计产物包审计**: 架构、数据库、API、OpenAPI、SQL/migration 和一致性报告按统一合同审计，避免文档之间漂移。
+- **工程实现契约**: 编码阶段会约束 OOD/SOLID、Controller/Handler/Router 入参出参、参数校验、事务、幂等、权限、日志和错误处理等实现细节。
+- **注释与日志治理**: 后端写操作、前端关键交互、状态变更、支付/权限/安全路径、异常处理和迁移脚本需要可定位日志、埋点/错误上报或必要注释；敏感信息不得进入日志。
+- **长期机制化门禁**: SoloForge 自身发布前会检查机制消费链路、知识治理、配置落盘边界、日志治理和诊断码集中注册，防止只靠文档或测试自证。
 
 ## 最短成功路径
 
@@ -61,7 +70,7 @@ soloforge init --adapter all         # 同时生成所有适配器配置
 
 | 位置 | 用途 |
 |------|------|
-| `.soloforge/knowledge/` | 项目知识模板和规则 |
+| `.soloforge/knowledge/` | 项目知识模板和规则；内置同步资产受 manifest/hash 保护，用户自定义规则会被审计为 hard rule、injectable 或 index_only |
 | `.soloforge/config.yaml` | 可选项目配置，仅在高置信度或手动确认后生成 |
 | `~/.soloforge/patterns/` | 全局默认模板（所有项目共享），init 时自动同步、已有文件不覆盖 |
 | `.claude/settings.json` / `CLAUDE.md` / `.mcp.json` | Claude Code 配置 |
@@ -79,6 +88,7 @@ soloforge next              # 查看当前阶段、阻断项和下一步可执
 soloforge stage             # 查看项目阶段与当前任务阶段
 soloforge config resolve    # 查看配置解析结果和来源
 soloforge config explain    # 解释某项配置为什么是当前值
+soloforge audit-project-knowledge # 审计项目自定义知识规则是否可被稳定消费
 soloforge version           # 查看版本
 ```
 
@@ -121,6 +131,10 @@ soloforge migrate --apply --confirm     # 执行项目迁移
 - 你手动修改过的模板和适配器文件（如 `CLAUDE.md`）不会被静默覆盖——SoloForge 会检测文件是否被用户修改，修改过的文件在同步时自动跳过并报告。
 - 核心知识模板受保护，即使 apply 也不会被自动同步覆盖。
 - dry-run 中的“应用安全: 需确认”表示发现用户已有文件或需要人工确认；这不是命令失败，只有加 `--apply --confirm` 才会写入。
+- 用户自己新增到 `.soloforge/knowledge/**` 的规则不会被当成普通静态文件。带有 `asset_kind: hard_rule`、`routes`、`primary_triggers` 或 `enforcement.level` 的项目规则会进入审计和任务选择；缺少触发条件的 hard rule 会被 `audit-project-knowledge` 标为阻断。
+- 项目规则进入 `sf_expand` 时会按 intent、route、技术栈和触发词筛选，不会整库塞进 prompt；`sf_review`、`sf_verify`、`sf_deliver` 会在项目规则不可消费或冲突时阻断。
+- 项目规则可用 `conflict_group` + `rule_value` 或 `conflicts_with` 声明互斥口径，例如 API 响应格式、分页格式、日志字段、数据库命名和权限模型。冲突不会由 AI 直接拍板，必须先由用户确认。
+- 知识资产与项目规则消费体系受 20 项防回归矩阵约束：模板卫生、脚手架质量、项目知识承载、选择注入、冲突确认、`next` 消费、同步保护、技术栈过滤、设计产物消费、消费 trace 和用户可见解释都必须有真实入口和 release gate。
 
 **典型升级流程：**
 
@@ -157,8 +171,8 @@ soloforge migrate --apply --confirm     # 确认后迁移
 - **存量设计复验** — 升级 SoloForge 后，已有架构/数据库/API 文档不会被默认信任。运行 `soloforge audit-design-artifacts` 可得到差距报告；需要升级时先 dry-run，再经 `--apply --confirm` 归档旧文件并写入升级契约，修订后的文档必须重新复验。
 - **下一步导航** — 不确定接下来该做什么时，运行 `soloforge next`，或向 AI 直接说“下一步/继续/现在能写代码吗”。SoloForge 会依据配置、设计验收、当前任务、修复指令和验证证据输出阶段、阻断原因与工作包；陈旧任务不会被静默绕过。
 - **OOD 与 SOLID 编码约束** — 复杂业务、领域服务、策略和重构类实现会先要求对象职责、接口与依赖方向摘要；代码审查可识别职责膨胀、直接依赖基础设施、宽接口和替换违约。文案或简单配置修改不会被强行复杂化。
-- **后端实现工程约束** — 实现后端接口前会要求 DTO/校验、响应与分页、事务与幂等、安全审计、OpenAPI/数据库对齐和测试证据；实体泄漏、写接口无校验、事务内外调、关键写入无幂等或敏感接口无安全证据会阻断交付。
-- **日志清晰** — 用户可见输出中文优先；JSON 模式（`--json`）输出保持纯 JSON，不混入内部日志。
+- **后端实现工程约束** — 实现后端接口前会要求 DTO/校验、响应与分页、事务与幂等、安全审计、OpenAPI/数据库对齐和测试证据；Spring Boot Entity 默认保持 `@Getter`/`@Setter`，DTO/VO/Request/Response 默认使用 `@Data`；实体泄漏、写接口无校验、事务内外调、关键写入无幂等或敏感接口无安全证据会阻断交付。
+- **日志与注释清晰** — 用户可见输出中文优先；JSON 模式（`--json`）输出保持纯 JSON，不混入内部日志。用户项目业务日志和注释也必须中文；后端类需要说明类作用的 Javadoc，方法需要说明方法、入参和出参，关键业务行需要中文行注释。
 - 写代码类任务会更明确 scope、验收项和验证命令。
 - 生成文档、提取说明、分析日志等产物型任务会默认输出到 `.soloforge/output/`，不会默认修改 `src/`。
 - 遇到缺少路径、源码包、日志等必需输入时，会先澄清，而不是猜着执行。
@@ -183,6 +197,8 @@ SoloForge 对验证和交付有严格的分层设计：
 - **可修复失败有预算**：重试次数有上限，超预算后停止并升级。
 - **范围不足不越权**：如果失败是因为 scope 不够，SoloForge 会请求扩大范围，不会静默越权写入。
 - **错误信息已脱敏**：失败报告中的敏感信息（密钥、密码、原始输出）会自动脱敏，只保留摘要和哈希。
+- **项目知识可审计**：项目自定义规则必须能说明适用路由、触发词和技术栈。能执行的规则会被选中或注入；只适合作为背景资料的规则会标为 `index_only`，不得冒充已执行约束。`soloforge next` 会显示下一步会参考哪些项目规则，`audit-project-knowledge` 会显示冲突、身份、可消费性和修复建议。
+- **历史问题机制化**：新反馈不会只按表面文件或单个场景处理。SoloForge 的发布门禁要求历史问题先归入长期机制族，并具备第一性原理不变量、生产入口、用户项目路径、must-fail 和 must-pass。
 
 ### 安全护栏
 

package/dist/adapters/claude_code/server.js

@@ -32,7 +32,7 @@ export async function startServer(deps) {
             await transport.close?.();
         }
         catch (e) {
-            console.debug("[soloForge]", e);
+            debug("server", "关闭资源失败", e);
         }
         process.exit(0);
     };

package/dist/adapters/claude_code/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/adapters/claude_code/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI3C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC7D,MAAM,UAAU,GAAW,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,uBAAuB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AAmBxH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAgB;IAC9C,KAAK,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;IACxC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAErD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,UAAU;KACpB,CAAC,CAAC;IAEH,MAAM,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;IAErE,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,IAAI,YAAY;YAAE,OAAO;QACzB,YAAY,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC;YACH,IAAI,cAAc;gBAAE,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC;YACjD,MAAM,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,QAAQ,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,sCAAsC;IACtC,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE;QACtC,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QACtC,yBAAyB;QACzB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IACH,4BAA4B;IAC5B,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;QAC1C,YAAY,CAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;QACnD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/adapters/claude_code/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI3C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC7D,MAAM,UAAU,GAAW,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,uBAAuB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AAmBxH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAgB;IAC9C,KAAK,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;IACxC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAErD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,UAAU;KACpB,CAAC,CAAC;IAEH,MAAM,aAAa,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;IAErE,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,IAAI,YAAY;YAAE,OAAO;QACzB,YAAY,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC;YACH,IAAI,cAAc;gBAAE,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC;YACjD,MAAM,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,QAAQ,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,sCAAsC;IACtC,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE;QACtC,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QACtC,yBAAyB;QACzB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IACH,4BAA4B;IAC5B,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;QAC1C,YAAY,CAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;QACnD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/adapters/claude_code/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude_code/tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/adapters/claude_code/tools.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAkB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAE9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAG9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,OAAO,EAOL,KAAK,UAAU,EAKhB,MAAM,mDAAmD,CAAC;AAiF3D;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc;IACd,cAAc,EAAE,qBAAqB,CAAC;IACtC,eAAe;IACf,WAAW,EAAE,kBAAkB,CAAC;IAChC,yDAAyD;IACzD,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAkKD;;;;;;;;;;;GAWG;AACH;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAW3F;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAAC,MAAM,EAAE;IACzD,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,GAAG,CAAC;CACtB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAwCzH;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAWlE;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAmBzE;AAED;;;GAGG;AACH,wBAAsB,qCAAqC,CAAC,MAAM,EAAE;IAClE,GAAG,EAAE,WAAW,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,gDAAgD,EAAE,0BAA0B,CAAC;CACtG,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAmB/F;AAED;;;GAGG;AACH,wBAAsB,+BAA+B,CAAC,MAAM,EAAE;IAC5D,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAgBjF;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAwBtF;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAwCrF;AAYD,yDAAyD;AACzD,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAc5F;AAED,+CAA+C;AAC/C,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAYzF;AAED,sDAAsD;AACtD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAYxF;AAED,wCAAwC;AACxC,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAYnF;AAED;;;;GAIG;AACH,wBAAsB,4BAA4B,CAAC,MAAM,EAAE;IACzD,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzC,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAAC,0BAA0B,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCxH;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,EAAE;IACtD,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzC,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,0BAA0B,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAuBrH;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzC,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,0BAA0B,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgB9G;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzC,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,0BAA0B,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBhH;AAED;GACG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,EAAE;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB,EAAE,OAAO,CAAC;IACnC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,oBAAoB,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA+BxK;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,YAAY,EAAE,OAAO,CAAC;IACtB,yBAAyB,EAAE,OAAO,CAAC;IACnC,YAAY,EAAE,OAAO,CAAC;IACtB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAepE;AAED;;GAEG;AACH,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,oBAAoB,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA8B9I;AAED;;GAEG;AACH,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,WAAW,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,oBAAoB,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA8B9I;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,EAAE;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,YAAY,EAAE,OAAO,CAAC;IACtB,mBAAmB,EAAE,OAAO,CAAC;CAC9B,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAepE;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sBAAsB,EAAE,OAAO,CAAC;IAChC,sBAAsB,EAAE,OAAO,CAAC;IAChC,wBAAwB,EAAE,OAAO,CAAC;IAClC,sBAAsB,EAAE,OAAO,CAAC;CACjC,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA0BpD;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAq+GzF"}

package/dist/adapters/claude_code/tools.js

@@ -6,6 +6,7 @@ import crypto from "node:crypto";
 import { verifyArtifact } from "../../engine/artifact_contract_registry.js";
 import { verifyRouteDecisionContract } from "../../engine/route_decision_contract_verifier.js";
 import { findToolInvocationContractByName, createToolTrace, validateToolInvocation, hasWriteSideEffect, } from "../../engine/tool_invocation_contract_registry.js";
+import { TOOL_DIAGNOSTIC_CODES } from "../../engine/diagnostic_registry.js";
 function createLazy(loader) {
     let mod = { loaded: null, promise: null };
     return () => {
@@ -38,7 +39,6 @@ const lazyDebugger = createLazy(() => import("../../engine/debugger.js"));
 const lazyObservability = createLazy(() => import("../../engine/observability.js"));
 const lazyGovernance = createLazy(() => import("../../engine/governance_report.js"));
 const lazyMigration = createLazy(() => import("../../engine/migration_guard.js"));
-const lazyPlanGate = createLazy(() => import("../../engine/plan_proposal_gate.js"));
 const lazyTestGen = createLazy(() => import("../../engine/test_generator.js"));
 const lazyTestQuality = createLazy(() => import("../../engine/test_quality.js"));
 const lazyDepScan = createLazy(() => import("../../engine/dependency_scanner.js"));
@@ -59,7 +59,6 @@ const lazyCapState = createLazy(() => import("../../engine/capability_state_stor
 const lazyMainPath = createLazy(() => import("../../engine/main_path_integration_contract.js"));
 const lazyDualLayer = createLazy(() => import("../../engine/dual_layer_mechanism_registry.js"));
 const lazyInputMaterial = createLazy(() => import("../../engine/input_material_contract_registry.js"));
-const lazyConfigCmd = createLazy(() => import("../../bin/config_commands.js"));
 const lazyConfigPrecedence = createLazy(() => import("../../engine/config_precedence_contract.js"));
 const lazyEnforcementGuard = createLazy(() => import("../../engine/enforcement_guard.js"));
 const lazyWorkspaceLease = createLazy(() => import("../../engine/workspace_lease.js"));
@@ -67,8 +66,6 @@ const lazyDeliveryReadiness = createLazy(() => import("../../engine/delivery_rea
 const lazyVerificationContract = createLazy(() => import("../../engine/verification_contract.js"));
 const lazyFailureReport = createLazy(() => import("../../engine/failure_report.js"));
 const lazyDegradation = createLazy(() => import("../../engine/degradation.js"));
-const lazyRetentionPolicy = createLazy(() => import("../../engine/retention_policy.js"));
-const lazyDiagnosticRegistry = createLazy(() => import("../../engine/diagnostic_registry.js"));
 const lazyArchitectureDesign = createLazy(() => import("../../engine/architecture_design_contract.js"));
 const lazyExistingSystemAnalysis = createLazy(() => import("../../engine/existing_system_analysis.js"));
 const lazyCodingReadiness = createLazy(() => import("../../engine/coding_readiness_gate.js"));
@@ -81,11 +78,11 @@ const lazyBrainstormContract = createLazy(() => import("../../engine/brainstorm_
 const lazyArchitectureWorkshop = createLazy(() => import("../../engine/architecture_decision_workshop.js"));
 const lazyDesignArtifactPack = createLazy(() => import("../../engine/design_artifact_pack.js"));
 const lazyStandardAssetContract = createLazy(() => import("../../engine/standard_asset_contract.js"));
-const lazyTemplateVisibility = createLazy(() => import("../../engine/template_asset_visibility.js"));
 const lazyDecisionWorkshop = createLazy(() => import("../../engine/decision_workshop.js"));
 const lazyNavigation = createLazy(() => import("../../engine/next_action_planner.js"));
 const lazyOodSolid = createLazy(() => import("../../engine/ood_solid_contract.js"));
 const lazyBackendImplementation = createLazy(() => import("../../engine/backend_implementation_contract.js"));
+const lazyCodeObservability = createLazy(() => import("../../engine/code_maintainability_observability_contract.js"));
 // ── Zod Schema 定义 ──
 const ClassifySchema = {
     intent: z.string().describe("开发者意图描述"),
@@ -100,6 +97,7 @@ const ExpandSchema = {
     design_artifact_pack: z.unknown().optional().describe("设计产物包路径映射或已复验状态"),
     ood_solid_summary: z.unknown().optional().describe("复杂编码任务的 OOD/SOLID 设计摘要"),
     backend_implementation_work_package: z.unknown().optional().describe("后端接口实现的工程工作包"),
+    code_observability_work_package: z.unknown().optional().describe("代码可维护性与可观测性工作包"),
 };
 const VerifySchema = {
     task_id: z.string().describe("任务 ID"),
@@ -240,7 +238,7 @@ export function checkWriteToolPlanGate(params) {
     if (!params.ctx || !params.ctx.plan_proposal_gate) {
         return {
             allowed: false,
-            diagnostic_code: "SF-PLAN-5001",
+            diagnostic_code: TOOL_DIAGNOSTIC_CODES.planGate,
             violation_type: "guard_blocked",
             reason: `工具 ${params.toolName} 执行前缺少 Plan Proposal Gate`,
         };
@@ -787,7 +785,7 @@ export async function assessCepForRepairReverify(params) {
  */
 export async function assessCepForUserFeedback(params) {
     const cepModule = await import("../../engine/core_experience_principle.js");
-    return cepModule.evaluateUserVisibleOutput({
+    const cep = cepModule.evaluateUserVisibleOutput({
         has_conclusion_first: params.has_conclusion_first,
         has_clear_summary: params.has_clear_summary,
         has_actionable_next_step: params.has_actionable_next_step,
@@ -795,6 +793,22 @@ export async function assessCepForUserFeedback(params) {
         hides_critical_failure: params.hides_critical_failure,
         chinese_semantic_first: params.chinese_semantic_first,
     });
+    const logGov = await import("../../engine/log_governance.js");
+    const logReport = logGov.evaluateFeedbackOutputQuality({
+        output: [
+            params.has_conclusion_first ? "结论优先" : "缺少结论",
+            params.has_clear_summary ? "摘要清晰" : "摘要不足",
+            params.has_actionable_next_step ? "下一步明确" : "下一步缺失",
+        ].join("；"),
+        critical_failure_hidden: params.hides_critical_failure,
+    });
+    return {
+        passed: cep.passed && logReport.passed,
+        issues_zh: [
+            ...cep.issues_zh,
+            ...logReport.findings.map((f) => f.message_zh),
+        ],
+    };
 }
 /**
  * 注册所有 MCP 工具到服务器实例。
@@ -982,7 +996,7 @@ export async function registerTools(server, deps) {
                         content: [{ type: "text", text: JSON.stringify({
                                     error: planViolation.reason,
                                     violation: planViolation,
-                                    diagnostic_code: pgResult.diagnostic_code ?? "SF-PLAN-5001",
+                                    diagnostic_code: pgResult.diagnostic_code ?? TOOL_DIAGNOSTIC_CODES.planGate,
                                     recovery: planViolation.recovery,
                                 }) }],
                         isError: true,
@@ -1008,7 +1022,7 @@ export async function registerTools(server, deps) {
                         content: [{ type: "text", text: JSON.stringify({
                                     error: planViolation.reason,
                                     violation: planViolation,
-                                    diagnostic_code: "SF-PLAN-5001",
+                                    diagnostic_code: TOOL_DIAGNOSTIC_CODES.planGate,
                                     recovery: planViolation.recovery,
                                 }) }],
                         isError: true,
@@ -1037,7 +1051,7 @@ export async function registerTools(server, deps) {
                         content: [{ type: "text", text: JSON.stringify({
                                     error: instrViolation.reason,
                                     violation: instrViolation,
-                                    diagnostic_code: instrResult.diagnostic_code ?? "SF-INSTR-5801",
+                                    diagnostic_code: instrResult.diagnostic_code ?? TOOL_DIAGNOSTIC_CODES.instructionContract,
                                     recovery: instrViolation.recovery,
                                 }) }],
                         isError: true,
@@ -1073,6 +1087,43 @@ export async function registerTools(server, deps) {
                     };
                 }
             }
+            // 用户项目知识门禁: review/verify/deliver 不能绕过不可消费的项目 hard rule。
+            if (["sf_review", "sf_verify", "sf_deliver"].includes(name)) {
+                const { auditProjectKnowledge } = await import("../../engine/project_knowledge_contract.js");
+                const pkReport = auditProjectKnowledge(projectPath, config);
+                if (pkReport.hard_fail_count > 0) {
+                    const pkFindings = pkReport.assets.flatMap((asset) => asset.findings
+                        .filter((finding) => finding.severity === "hard_fail")
+                        .map((finding) => `${asset.rel_path}: [${finding.code}] ${finding.message_zh}`));
+                    const pkViolation = {
+                        invocation_id: invocationId,
+                        tool_name: name,
+                        violation_type: "guard_blocked",
+                        severity: "hard_fail",
+                        reason: `用户项目知识存在 ${pkReport.hard_fail_count} 个不可消费阻断项`,
+                        recovery: "运行 soloforge audit-project-knowledge，修复 hard rule 的 routes、primary_triggers 或身份冲突后重试",
+                    };
+                    const pkTrace = createToolTrace({
+                        tool_name: name, invocation_id: invocationId, task_id: taskId,
+                        actual_side_effects: effectiveSideEffects,
+                        next_allowed_tools: ["sf_expand", "sf_status"],
+                        forbidden_tools: ["sf_review", "sf_verify", "sf_deliver"],
+                        authorization, bypass,
+                    });
+                    if (taskId && ctx)
+                        await taskContext.setToolTrace(taskId, pkTrace, [pkViolation]);
+                    return {
+                        content: [{ type: "text", text: JSON.stringify({
+                                    error: pkViolation.reason,
+                                    violation: pkViolation,
+                                    diagnostic_code: TOOL_DIAGNOSTIC_CODES.projectKnowledgeBlocked,
+                                    findings: pkFindings,
+                                    recovery: pkViolation.recovery,
+                                }) }],
+                        isError: true,
+                    };
+                }
+            }
             // 合同验证
             const lastTrace = ctx?.last_tool_trace;
             // 为动态工具构建有效的合同覆盖（如 sf_status cancel）
@@ -1330,8 +1381,11 @@ export async function registerTools(server, deps) {
         if (args.backend_implementation_work_package) {
             ctx.backend_implementation_work_package = args.backend_implementation_work_package;
         }
+        if (args.code_observability_work_package) {
+            ctx.code_observability_work_package = args.code_observability_work_package;
+        }
         if (args.architecture_decision_workshop || args.decision_workshop || args.design_artifact_pack
-            || args.ood_solid_summary || args.backend_implementation_work_package) {
+            || args.ood_solid_summary || args.backend_implementation_work_package || args.code_observability_work_package) {
             await taskContext.save(ctx);
         }
         // 状态守卫：classifying/expanding/clarifying → expanding
@@ -1690,7 +1744,7 @@ export async function registerTools(server, deps) {
                 };
             }
         }
-        // 问题四十一(brainstorm): 脑暴契约 gate — 不确定项缺方案探索时 blocked
+        // 问题四十二(brainstorm): 脑暴契约 gate — 不确定项缺方案探索时 blocked
         {
             const brainstormGate = await checkBrainstormGate({ ctx, route: expansionRoute });
             if (!brainstormGate.allowed) {
@@ -1704,8 +1758,11 @@ export async function registerTools(server, deps) {
                 };
             }
         }
-        // 问题六十六: 复杂业务编码必须先具备对象职责、接口和依赖方向摘要。
+        // 问题六十六/六十七/六十八: 编码前工程约束必须聚合返回。
+        // 不能让 OOD 或后端工程门禁抢先返回，遮蔽用户项目的注释/日志契约。
         {
+            const preImplementationBlocks = [];
+            const preImplementationPayload = {};
             const oodModule = await lazyOodSolid();
             const oodGate = oodModule.evaluateOodDesignGate({
                 task_id: args.task_id,
@@ -1715,22 +1772,14 @@ export async function registerTools(server, deps) {
             });
             if (oodGate.applicable) {
                 ctx.ood_solid_summary = oodGate.required_summary;
-                await taskContext.save(ctx);
+                preImplementationPayload.ood_solid_summary = oodGate.required_summary;
             }
             if (!oodGate.allowed) {
-                return {
-                    result: {
-                        error: oodGate.reason_zh,
-                        status: "awaiting_ood_design",
-                        diagnostic_code: "SF-OOD-6601",
-                        ood_solid_summary: oodGate.required_summary,
-                        recovery: "请确认对象职责、接口边界、依赖方向、变化点和 SOLID 风险后重新调用 sf_expand",
-                    },
-                };
+                preImplementationBlocks.push({
+                    code: TOOL_DIAGNOSTIC_CODES.oodMissingSummary,
+                    reason_zh: oodGate.reason_zh,
+                });
             }
-        }
-        // 问题六十七: 后端接口编码必须先确认工程边界与验收证据。
-        {
             const backendModule = await lazyBackendImplementation();
             const backendGate = backendModule.evaluateBackendImplementationGate({
                 task_id: args.task_id,
@@ -1740,16 +1789,46 @@ export async function registerTools(server, deps) {
             });
             if (backendGate.applicable) {
                 ctx.backend_implementation_work_package = backendGate.work_package;
-                await taskContext.save(ctx);
+                preImplementationPayload.backend_implementation_work_package = backendGate.work_package;
             }
             if (!backendGate.allowed) {
+                preImplementationBlocks.push({
+                    code: TOOL_DIAGNOSTIC_CODES.backendMissingSummary,
+                    reason_zh: backendGate.reason_zh,
+                });
+            }
+            if (ctx.classification.task_type !== "scaffold") {
+                const obsModule = await lazyCodeObservability();
+                const obsGate = obsModule.evaluateCodeObservabilityGate({
+                    task_id: args.task_id,
+                    intent: ctx.intent,
+                    route: expansionRoute,
+                    changed_files: ctx.execution?.changed_files,
+                    work_package: ctx.code_observability_work_package,
+                });
+                if (obsGate.applicable) {
+                    ctx.code_observability_work_package = obsGate.work_package;
+                    preImplementationPayload.code_observability_work_package = obsGate.work_package;
+                }
+                if (!obsGate.allowed) {
+                    preImplementationBlocks.push({
+                        code: TOOL_DIAGNOSTIC_CODES.codeObservabilityWorkPackage,
+                        reason_zh: obsGate.reason_zh,
+                    });
+                }
+            }
+            if (Object.keys(preImplementationPayload).length > 0) {
+                await taskContext.save(ctx);
+            }
+            if (preImplementationBlocks.length > 0) {
                 return {
                     result: {
-                        error: backendGate.reason_zh,
-                        status: "awaiting_backend_contract",
-                        diagnostic_code: "SF-BACKEND-6701",
-                        backend_implementation_work_package: backendGate.work_package,
-                        recovery: "请补齐 DTO/校验、事务一致性、安全审计、契约对齐与测试证据后重新调用 sf_expand",
+                        error: "编码前工程契约未全部确认，不得开始实现",
+                        status: "awaiting_implementation_contracts",
+                        diagnostic_codes: preImplementationBlocks.map((b) => b.code),
+                        blocking_findings: preImplementationBlocks,
+                        ...preImplementationPayload,
+                        recovery: "请同时确认 OOD/SOLID、后端工程边界、代码注释与日志契约后重新调用 sf_expand",
                     },
                 };
             }
@@ -1986,7 +2065,7 @@ export async function registerTools(server, deps) {
                     result: {
                         error: oodGate.reason_zh,
                         status: "blocked",
-                        diagnostic_code: "SF-OOD-6601",
+                        diagnostic_code: TOOL_DIAGNOSTIC_CODES.oodMissingSummary,
                         ood_solid_summary: oodGate.required_summary,
                         recovery: "完成 OOD/SOLID 摘要后重新执行 sf_expand 与 sf_verify",
                     },
@@ -2005,7 +2084,7 @@ export async function registerTools(server, deps) {
                     result: {
                         error: backendGate.reason_zh,
                         status: "blocked",
-                        diagnostic_code: "SF-BACKEND-6701",
+                        diagnostic_code: TOOL_DIAGNOSTIC_CODES.backendMissingSummary,
                         backend_implementation_work_package: backendGate.work_package,
                         recovery: "完成后端工程工作包后重新执行 sf_expand 与 sf_verify",
                     },
@@ -2038,7 +2117,7 @@ export async function registerTools(server, deps) {
                     result: {
                         error: "OOD/SOLID 代码复验发现阻断项，需修复后重验",
                         status: "blocked",
-                        diagnostic_code: "SF-OOD-6602",
+                        diagnostic_code: TOOL_DIAGNOSTIC_CODES.oodDeliveryBlock,
                         ood_solid_findings: solidFindings,
                     },
                 };
@@ -2048,11 +2127,30 @@ export async function registerTools(server, deps) {
                     result: {
                         error: "后端实现工程复验发现阻断项，需修复后重验",
                         status: "blocked",
-                        diagnostic_code: "SF-BACKEND-6702",
+                        diagnostic_code: TOOL_DIAGNOSTIC_CODES.backendDeliveryBlock,
                         backend_implementation_findings: backendFindings,
                     },
                 };
             }
+            // 问题六十八: 代码可维护性与可观测性契约
+            const codeObsModule = await lazyCodeObservability();
+            const obsFindings = codeObsModule.verifyChangedFilesObservability({
+                changed_files: implementationFiles,
+                file_contents: implementationContents,
+                intent: ctx.intent,
+            });
+            ctx.code_observability_findings = obsFindings;
+            await taskContext.save(ctx);
+            if (codeObsModule.hasBlockingObservabilityFindings(obsFindings)) {
+                return {
+                    result: {
+                        error: "代码可维护性/可观测性复验发现阻断项，需修复后重验",
+                        status: "blocked",
+                        diagnostic_code: TOOL_DIAGNOSTIC_CODES.codeObservabilityFinding,
+                        code_observability_findings: obsFindings,
+                    },
+                };
+            }
         }
         // 问题六十二: 设计产物验证必须读取用户项目真实文件，不接受占位合同自证通过。
         const verifyWorkflowIntent = ctx.route_decision?.workflow_intent ?? ctx.classification?.route_decision?.workflow_intent;
@@ -2143,7 +2241,7 @@ export async function registerTools(server, deps) {
                         result: {
                             error: `文件 ${changedFile} 模板契约验证未通过，进入修复重验闭环`,
                             status: "blocked",
-                            diagnostic_code: "SF-CONTRACT-0003",
+                            diagnostic_code: TOOL_DIAGNOSTIC_CODES.contractDraft,
                             template_contract_id: perFileContract.asset_id,
                             missing_fields: contractResult.missing_fields,
                             messages: contractResult.messages,
@@ -2434,8 +2532,8 @@ export async function registerTools(server, deps) {
         if (args.plan_id !== currentPlan.plan_id) {
             return {
                 result: {
-                    error: `plan_id 不匹配: 请求 "${args.plan_id}"，当前任务计划 "${currentPlan.plan_id}" [SF-VERIFY-5002]`,
-                    diagnostic_code: "SF-VERIFY-5002",
+                    error: `plan_id 不匹配: 请求 "${args.plan_id}"，当前任务计划 "${currentPlan.plan_id}" [${TOOL_DIAGNOSTIC_CODES.verifyPlanMismatch}]`,
+                    diagnostic_code: TOOL_DIAGNOSTIC_CODES.verifyPlanMismatch,
                 },
             };
         }
@@ -2842,11 +2940,18 @@ export async function registerTools(server, deps) {
             || ctx.backend_implementation_work_package
             ? backendModule.reviewBackendImplementationFiles(contractContents)
             : [];
-        if (solidFindings.length > 0 || backendFindings.length > 0) {
+        // 问题六十八: 代码可维护性与可观测性审查
+        const obsModule = await lazyCodeObservability();
+        const obsFindings = obsModule.requiresCodeObservabilityContract(ctx.intent, ctx.expansion?.workflow_trace?.route, args.changed_files)
+            || ctx.code_observability_work_package
+            ? obsModule.reviewCodeObservability(contractContents)
+            : [];
+        if (solidFindings.length > 0 || backendFindings.length > 0 || obsFindings.length > 0) {
             const updatedCtx = await taskContext.load(args.task_id);
             if (updatedCtx) {
                 updatedCtx.ood_solid_findings = solidFindings;
                 updatedCtx.backend_implementation_findings = backendFindings;
+                updatedCtx.code_observability_findings = obsFindings;
                 await taskContext.save(updatedCtx);
             }
         }
@@ -2860,7 +2965,9 @@ export async function registerTools(server, deps) {
             reviewExtras.ood_solid_findings = solidFindings;
         if (backendFindings.length > 0)
             reviewExtras.backend_implementation_findings = backendFindings;
-        if (oodModule.hasBlockingSolidFindings(solidFindings) || backendModule.hasBlockingBackendFindings(backendFindings)) {
+        if (obsFindings.length > 0)
+            reviewExtras.code_observability_findings = obsFindings;
+        if (oodModule.hasBlockingSolidFindings(solidFindings) || backendModule.hasBlockingBackendFindings(backendFindings) || obsModule.hasBlockingObservabilityFindings(obsFindings)) {
             reviewExtras.delivery_blocked = true;
             reviewExtras.diagnostic_code = "SF-IMPLEMENTATION-CONTRACT-REVIEW-BLOCKED";
         }
@@ -3008,7 +3115,7 @@ export async function registerTools(server, deps) {
             return {
                 result: {
                     error: "存在未清零的模板契约修复指令，需完成修复重验后才能交付",
-                    diagnostic_code: "SF-CONTRACT-0003",
+                    diagnostic_code: TOOL_DIAGNOSTIC_CODES.contractDraft,
                     repair_directive: ctx.repair_reverify_directive,
                     recovery: "修复文档缺口后重新执行 sf_verify，验证通过后 repair_reverify_directive 自动清零",
                     recovery_next_tools: ["sf_learn", "sf_verify", "sf_status"],
@@ -3022,7 +3129,7 @@ export async function registerTools(server, deps) {
             return {
                 result: {
                     error: "OOD/SOLID 契约仍存在硬失败，不得交付",
-                    diagnostic_code: "SF-OOD-6602",
+                    diagnostic_code: TOOL_DIAGNOSTIC_CODES.oodDeliveryBlock,
                     findings: ctx.ood_solid_findings,
                     recovery: "按 finding 修复职责或依赖边界，并重新执行 sf_review 与 sf_verify",
                 },
@@ -3033,12 +3140,25 @@ export async function registerTools(server, deps) {
             return {
                 result: {
                     error: "后端实现工程契约仍存在硬失败，不得交付",
-                    diagnostic_code: "SF-BACKEND-6702",
+                    diagnostic_code: TOOL_DIAGNOSTIC_CODES.backendDeliveryBlock,
                     findings: ctx.backend_implementation_findings,
                     recovery: "按 finding 修复后端边界、安全或一致性问题，并重新执行 sf_review 与 sf_verify",
                 },
             };
         }
+        // 问题六十八: 代码可维护性与可观测性 P0 阻断交付。
+        const obsModule = await lazyCodeObservability();
+        const obsDeliveryBlock = obsModule.evaluateDeliveryBlock(ctx.code_observability_findings ?? []);
+        if (obsDeliveryBlock.blocked) {
+            return {
+                result: {
+                    error: `代码可维护性/可观测性存在阻断: ${obsDeliveryBlock.reason_zh}`,
+                    diagnostic_code: TOOL_DIAGNOSTIC_CODES.codeObservabilityFinding,
+                    findings: obsDeliveryBlock.blocking_findings,
+                    recovery: "按 finding 修复敏感信息泄漏、缺失日志或吞异常问题，并重新执行 sf_review 与 sf_verify",
+                },
+            };
+        }
         // 产物状态门控: deliver 需要产物状态为 accepted 且有证据
         if (ctx.artifact_output) {
             const status = ctx.artifact_output.status;