soloforge 1.1.38 → 1.1.40

package/README.md

@@ -55,17 +55,19 @@ soloforge init --interactive
 所有命令默认作用于当前目录。推荐先 `cd` 到项目根目录再执行。
 
 ```bash
-soloforge init --auto --dry-run      # 只预览，不写入 config.yaml
-soloforge init --auto                # 高置信度时生成项目配置和适配器文件
-soloforge init                       # 生成目录、知识模板和适配器文件，不写 config.yaml
+soloforge init --auto --dry-run      # 只预览，不写入 intent.yaml
+soloforge init --auto                # 高置信度时生成 intent.yaml 和适配器文件
+soloforge init                       # 生成目录、知识模板和适配器文件，不写 intent.yaml
 soloforge init --interactive         # 手动确认项目配置
-soloforge init --adapter claude      # 只生成 Claude Code 配置
+soloforge init --adapter claude-code # 只生成 Claude Code 配置
 soloforge init --adapter codex       # 只生成 Codex App 配置
 soloforge init --adapter trae        # 只生成 Trae IDE 配置
 soloforge init --adapter all         # 同时生成所有适配器配置
+soloforge init --blueprint "描述"     # 从自然语言蓝图初始化项目
+soloforge init --system-type 新系统   # 指定系统类型（新系统 / 老系统）
 ```
 
-`config.yaml` 是可选文件。没有它时，SoloForge 会根据 `package.json`、`pom.xml`、`go.mod` 等文件在运行时推断项目类型；只有高置信度或你手动确认时，才会把配置写入 `.soloforge/config.yaml`。
+SoloForge 使用三层配置解析：从 `package.json`、`pom.xml`、`go.mod` 等项目文件自动探测技术栈和构建命令；用户偏好（如产品类型、交付设置）存储在可选的 `.soloforge/intent.yaml` 中。探测结果优先于 intent 声明——大多数项目无需手动配置。
 
 配置里的 scope、仓库路径和产物路径都按项目相对路径理解和存储，适配 Windows、macOS、Linux 时不要手写宿主机绝对路径。
 
@@ -75,7 +77,7 @@ soloforge init --adapter all         # 同时生成所有适配器配置
 |------|------|
 | `.soloforge/knowledge/` | 公司全局知识库：项目规则和模板；内置同步资产受 manifest/hash 保护，用户自定义规则会被审计为 hard rule、injectable 或 index_only |
 | `.soloforge/templates/` | 管线阶段模板：artifacts（输出模板）、rules（规则）、gates（门禁配置），按系统类型同步，用户修改过的文件不会被覆盖 |
-| `.soloforge/config.yaml` | 可选项目配置，仅在高置信度或手动确认后生成 |
+| `.soloforge/intent.yaml` | 可选用户偏好配置（产品类型、交付设置等不可探测字段） |
 | `~/.soloforge/patterns/` | 全局默认模板（所有项目共享），init 时自动同步、已有文件不覆盖 |
 | `.claude/settings.json` / `CLAUDE.md` / `.mcp.json` | Claude Code 配置 |
 | `.codex/config.toml` / `.codex/hooks.json` / `AGENTS.md` | Codex App 配置 |
@@ -98,7 +100,7 @@ SoloForge 在执行任务时会自动从 `.soloforge/knowledge/` 读取匹配的
 ```markdown
 ---
 name: 支付规则
-when: "支付, 结算, 退款, payment, refund"
+triggers: ["支付", "结算", "退款", "payment", "refund"]
 scope: [backend]
 products: ["*"]
 ---
@@ -123,6 +125,10 @@ products: ["*"]
   checklists/            → 自定义验收清单
   acceptance_templates/  → 自定义产物模板
   review_rules/          → 自定义审查规则
+  patterns/              → 可复用模式（含 core/ 和 temp/ 子目录）
+  profiles/              → 产品线配置文件
+  rules/                 → 阶段规则（shared / new-system / existing-system）
+  artifacts/             → 产物模板（shared / new-system / existing-system）
   drafts/                → sf_knowledge_add 的默认输出位置
 ```
 
@@ -133,26 +139,29 @@ products: ["*"]
 | 字段 | 必填 | 默认值 | 说明 |
 |---|---|---|---|
 | `name` | 否 | 文件名 | 注入 prompt 时显示的标题 |
-| `when` | **是** | `""` | 触发关键词，逗号分隔。AI 任务意图匹配到这些词时才会选中这条知识 |
+| `triggers` | **是** | `[]` | 触发关键词字符串数组。AI 任务意图匹配到这些词时才会选中这条知识 |
 | `scope` | 否 | `["shared"]` | 作用域：`backend`、`frontend`、`shared`。`shared` 匹配所有 |
 | `products` | 否 | `["*"]` | 适用产品线，`*` 匹配所有 |
 | `stages` | 否 | `["*"]` | 适用阶段（`需求分析`、`编码与单元测试` 等），`*` 匹配所有 |
 | `status` | 否 | `"active"` | 只有不填或 `active` 才会被使用 |
 | `type` | 否 | 从目录名推断 | 用于分类过滤 |
+| `tech_stack` | 否 | `[]` | 技术栈过滤，如 `["typescript", "react"]` |
+| `confidence` | 否 | — | 置信度评分 |
+| `id` | 否 | 自动生成 | 唯一标识 |
 
 ### SoloForge 如何使用你的知识
 
 1. **索引** — 运行任务时，SoloForge 扫描 `.soloforge/knowledge/` 下所有 `.md` 文件
-2. **匹配** — 根据任务的意图关键词和 `when` 字段做匹配
+2. **匹配** — 根据任务的意图关键词和 `triggers` 数组元素做匹配
 3. **注入** — 匹配到的文件正文写入 AI prompt 的 `## 适用知识` 段落
 
-知识注入有预算上限（默认 5 条），按优先级排序。你的项目知识优先级低于 SoloForge 内置核心规则，但高于全局 patterns。
+知识注入有预算上限（默认 15 条，索引查询默认返回 5 条），按优先级排序。你的项目知识优先级低于 SoloForge 内置核心规则，但高于全局 patterns。
 
 ### 注意事项
 
 - **不要和内置模板同名** — 比如 `.soloforge/knowledge/procedures/功能开发流程.md` 会被当作"被篡改的内置文件"而拒绝。用不同的文件名。
 - **已有文件不会被覆盖** — `sync-templates` 不会删除或覆盖你在 `.soloforge/knowledge/` 里创建的任何文件。
-- **`when` 决定命中率** — 不填 `when` 或写得太窄，知识文件不会被选中。写宽一些（包括中英文同义词）效果更好。
+- **`triggers` 决定命中率** — 不填 `triggers` 或写得太窄，知识文件不会被选中。写宽一些（包括中英文同义词）效果更好。
 - **正文要精简** — 注入 prompt 有长度限制，正文控制在关键规则和约束，不要放长篇背景描述。
 
 ## 更新与旧项目同步
@@ -195,30 +204,42 @@ soloforge upgrade-design-artifacts --apply --confirm
 
 ## 日常命令
 
+大部分命令支持 `--json` 输出 JSON 格式，方便工具集成。
+
 ```bash
-soloforge validate          # 检查项目配置和知识文件
-soloforge validate-knowledge # 验证知识规则完整性和消费链路
-soloforge validate-foundation # 验证基础场景矩阵
-soloforge validate-new-issue # 验证新 issue 注册和消费
-soloforge status            # 查看当前项目状态和配置来源
-soloforge next              # 查看当前阶段、阻断项和下一步可执行工作包
-soloforge stage             # 查看项目阶段与当前任务阶段
-soloforge config resolve    # 查看配置解析结果和来源
-soloforge config explain    # 解释某项配置为什么是当前值
-soloforge config repair     # 自动修复配置机械类型错误并重签 evidence
-soloforge audit-project-knowledge # 审计项目自定义知识规则是否可被稳定消费
-soloforge audit-template-visibility # 审计内部治理资产的可见性隔离
-soloforge doctor            # 诊断 MCP 控制面、适配器 hook、状态可信和恢复路径
-soloforge version           # 查看版本
+soloforge validate [--json]           # 检查项目配置和知识文件
+soloforge validate-knowledge [--json] # 验证知识规则完整性和消费链路
+soloforge validate-foundation [--json] # 验证基础场景矩阵
+soloforge validate-new-issue --title="问题标题" [--json] # 验证新 issue 注册和消费
+soloforge validate-mechanisms         # 验证双层机制模型完整性
+soloforge status                      # 查看当前项目状态和配置来源
+soloforge next [--json] [--write-snapshot] # 查看当前阶段、阻断项和下一步可执行工作包
+soloforge stage [--explain]           # 查看项目阶段与当前任务阶段
+soloforge config show                 # 查看配置解析结果（探测 + intent + 约定合并）
+soloforge config explain <field>      # 解释某项配置为什么是当前值
+soloforge config set <field> <value>  # 写入 intent.yaml 字段（产品类型、交付设置等）
+soloforge config export               # 导出 intent.yaml 原始内容
+soloforge config unset <field>        # 删除 intent.yaml 字段
+soloforge config check                # 运行探测 + 验证 + 冲突检测
+soloforge audit-project-knowledge [--json] # 审计项目自定义知识规则是否可被稳定消费
+soloforge audit-template-visibility [--json] # 审计内部治理资产的可见性隔离
+soloforge doctor [--json]             # 诊断 MCP 控制面、适配器 hook、状态可信和恢复路径
+soloforge analyze --view <视图名> --targets [...] [--json]  # 按需调用上下文引擎
+soloforge modify <产物路径> [--stdin|--file <path>] [--json]  # 脱离管线修改产物
+soloforge review <产物路径> [--json]  # 脱离管线审查产物
+soloforge version                     # 查看版本
 ```
 
+多个命令支持 `--project-path <path>` 指定项目路径（非当前目录时使用）。
+
 ### 状态清理与审计
 
 ```bash
 soloforge cleanup --dry-run            # 预览可清理的状态文件
-soloforge cleanup --apply              # 执行清理（默认 dry-run，需显式 --apply）
-soloforge audit-template-mechanisms    # 审计知识资产 schema 完整性
-soloforge audit-design-artifacts       # 审计架构/数据库/API 设计产物包
+soloforge cleanup --apply [--stale]    # 执行清理（默认 dry-run，需显式 --apply）
+soloforge cleanup --json               # JSON 格式输出
+soloforge audit-template-mechanisms [--json]    # 审计知识资产 schema 完整性
+soloforge audit-design-artifacts [--json]       # 审计架构/数据库/API 设计产物包
 soloforge upgrade-design-artifacts     # 预览设计产物升级计划（dry-run）
 soloforge upgrade-design-artifacts --apply --confirm  # 确认后归档旧设计产物并写入升级契约
 ```
@@ -251,10 +272,10 @@ soloforge migrate --apply --confirm     # 执行项目迁移
 - 你手动修改过的模板和适配器文件（如 `CLAUDE.md`）不会被静默覆盖——SoloForge 会检测文件是否被用户修改，修改过的文件在同步时自动跳过并报告。
 - 核心知识模板受保护，即使 apply 也不会被自动同步覆盖。
 - dry-run 中的“应用安全: 需确认”表示发现用户已有文件或需要人工确认；这不是命令失败，只有加 `--apply --confirm` 才会写入。
-- 用户自己新增到 `.soloforge/knowledge/**` 的规则不会被当成普通静态文件。带有 `asset_kind: hard_rule`、`stages`、`primary_triggers` 或 `enforcement.level` 的项目规则会进入审计和任务选择；缺少触发条件的 hard rule 会被 `audit-project-knowledge` 标为阻断。
+- 用户自己新增到 `.soloforge/knowledge/**` 的规则不会被当成普通静态文件。带有 `type: hard_rule`、`stages`、`triggers` 或 `enforcement.level` 的项目规则会进入审计和任务选择；缺少触发条件的 hard rule 会被 `audit-project-knowledge` 标为阻断。
 - 项目规则在阶段执行时（`sf_stage_execute`）按 intent、stage、技术栈和触发词筛选，不会整库塞进 prompt；`sf_code_review`、`sf_gate_check`、`sf_stage_advance` 会在项目规则不可消费或冲突时阻断。
 - 项目规则可用 `conflict_group` + `rule_value` 或 `conflicts_with` 声明互斥口径，例如 API 响应格式、分页格式、日志字段、数据库命名和权限模型。冲突不会由 AI 直接拍板，必须先由用户确认。
-- 知识资产与项目规则消费体系受 19 项防回归矩阵约束：模板卫生、脚手架质量、项目知识承载、选择注入、冲突确认、`next` 消费、同步保护、技术栈过滤、设计产物消费、消费 trace 和用户可见解释都必须有真实入口和 release gate。
+- 知识资产与项目规则消费体系受发布门禁矩阵约束：模板卫生、脚手架质量、项目知识承载、选择注入、冲突确认、`next` 消费、同步保护、技术栈过滤、设计产物消费、消费 trace 和用户可见解释都必须有真实入口和 release gate。
 
 **典型升级流程：**
 
@@ -369,9 +390,9 @@ soloforge init
 
 ## 常见问题
 
-### `soloforge init --auto` 没有生成 config.yaml
+### `soloforge init --auto` 没有生成 intent.yaml
 
-这是正常行为。SoloForge 只有在项目指纹足够明确时才会自动写配置。你可以继续使用运行时推断，也可以执行 `soloforge init --interactive` 手动确认。
+这是正常行为。SoloForge 只有在项目指纹足够明确时才会自动写 intent.yaml。大多数项目通过文件探测即可获得完整配置；你也可以执行 `soloforge init --interactive` 手动确认偏好设置。
 
 ### AI 工具没有调用 SoloForge
 
@@ -397,17 +418,17 @@ soloforge doctor
 
 先按 `doctor` 输出的恢复命令处理。旧项目需要补齐新增模板或适配器文件时，使用 `sync-templates` / `sync-adapters`；新项目首次接入时才运行 `soloforge init`。
 
-如果 `status` 提示 `version` 数字/字符串、`scope` 字符串/数组或 `config.evidence.json` 过期，这属于机械配置问题，不需要逐字段人工确认：
+如果 `status` 提示配置不完整（缺少 tech_stack 或 build_commands），可以通过配置命令补充：
 
 ```bash
-soloforge config repair --dry-run
-soloforge config repair
+soloforge config check         # 检查配置完整性和冲突
+soloforge config set <field>   # 写入缺失的 intent.yaml 字段
 soloforge validate
 soloforge status
 soloforge next
 ```
 
-`config repair` 会先备份旧配置，再修复可安全归一化的 YAML 类型并重签 evidence。业务口径变更仍由 `config confirm` 或人工决策处理。
+`config set` 通过 AI 对话或 MCP 工具 `sf_config_update` 写入 intent.yaml 中的用户偏好字段（如 product_profile、delivery）。技术栈和构建命令由项目文件自动探测，无需手动配置。
 
 ### 想清理项目中的 SoloForge 文件
 
@@ -461,7 +482,7 @@ npm test
 # 3. 中文注释防回归
 npm run check:comments
 
-# 4. 发布门禁（文本输出，11 项 PASS / 0 hard_fail）
+# 4. 发布门禁（文本输出，14 项 PASS / 0 hard_fail）
 npm run validate-release
 
 # 5. 发布门禁（JSON 输出，必须 passed=true、hard_fail_count=0）
@@ -480,26 +501,29 @@ node "$REPO_DIR/dist/bin/soloforge.js" status
 cd "$REPO_DIR"
 ```
 
-当前代码质量基线：tsc 零错误 | 221 测试文件 / 4799 测试全部通过 | eslint 零警告 | 覆盖率 87/81/90/87（branches/functions/lines/statements）| 零循环依赖 | 中文注释零回归 | `noUnusedLocals` + `noUnusedParameters` 已启用。
+当前代码质量基线：tsc 零错误 | 293 测试文件 / 5305 测试全部通过 | eslint 零警告 | 零循环依赖 | 中文注释零回归 | `noUnusedLocals` + `noUnusedParameters` 已启用。
 
 <details>
 <summary>内部说明：validate-release 门禁检查项</summary>
 
-`npm run validate-release` 检查以下 11 项门禁：
+`npm run validate-release` 检查以下 14 项门禁：
 
 1. dist 旧产物风险检查
-2. TypeScript 编译检查
-3. P0/P1 知识资产 schema
-4. 主链路真实消费
-5. 依赖漏洞扫描
-6. npm pack 产物验证
-7. MCP 控制面可信与受控生成链路
-8. 工作流导航契约行为
-9. 关键问题消费验证
-10. 模板卫生与项目知识消费
+2. npm pack 产物验证
+3. 依赖漏洞扫描
+4. MCP 控制面可信与受控生成链路
+5. 关键问题消费验证
+6. 主链路真实消费
+7. P0/P1 知识资产 schema
+8. 模板卫生与项目知识消费
+9. 工作流导航契约行为
+10. TypeScript 编译检查
 11. 发布问题场景矩阵
+12. 代码质量门禁
+13. 架构边界回归
+14. 模板消费覆盖率
 
-全部 11 项 PASS / 0 hard_fail 才能发布。
+全部 14 项 PASS / 0 hard_fail 才能发布。
 
 </details>
 

package/dist/adapters/shared/workflow_template.js

@@ -13,7 +13,7 @@ import { getWorkflowRuleMechanismIds as _getWorkflowRuleMechanismIds } from "../
 // 从 engine 层 re-export 以保持向后兼容
 export { generateWorkflowRules, getWorkflowRuleMechanismIds, EMBEDDED_CHECKSUM } from "../../engine/templates/workflow_rule_generator.js";
 /** 当前嵌入的权威规则校验和 — 由 `npm run update-workflow-checksum` 更新。 */
-const EMBEDDED_CHECKSUM = "d035c5dddc88fdd5";
+const EMBEDDED_CHECKSUM = "4bdfdba3de678fbf";
 /**
  * 计算所有权威规则资产的第一行非注释内容组合的 SHA256 校验和。
  * 权威规则内容变化时校验和必然变化。

package/dist/bin/commands/analyze.d.ts

@@ -0,0 +1,7 @@
+/**
+ * soloforge analyze --view <视图名> --targets [...] [--json]
+ *
+ * 按需调用上下文引擎指定视图，返回分析结果。
+ */
+export declare function cmdAnalyze(): Promise<void>;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/bin/commands/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/analyze.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAiDhD"}

package/dist/bin/commands/analyze.js

@@ -0,0 +1,52 @@
+import { debug, userInfo, userError } from "../../engine/core/logger.js";
+import { resolveProjectPath, args } from "../args.js";
+/**
+ * soloforge analyze --view <视图名> --targets [...] [--json]
+ *
+ * 按需调用上下文引擎指定视图，返回分析结果。
+ */
+export async function cmdAnalyze() {
+    debug("CLI", "执行 cmdAnalyze");
+    const projectPath = resolveProjectPath();
+    // 解析参数
+    const isJson = args.includes("--json");
+    const viewIdx = args.indexOf("--view");
+    const viewName = viewIdx >= 0 ? args[viewIdx + 1] : undefined;
+    if (!viewName) {
+        userError("用法: soloforge analyze --view <视图名> [--targets a.ts b.ts] [--json]");
+        userError("可用视图: file_impact, reference_trace, dependency_graph, change_impact, coverage_gap, knowledge_ref");
+        process.exit(1);
+    }
+    // 解析 targets
+    let targets = [];
+    const targetsIdx = args.indexOf("--targets");
+    if (targetsIdx >= 0) {
+        targets = args.slice(targetsIdx + 1).filter((a) => !a.startsWith("--"));
+    }
+    try {
+        // 引导上下文引擎（注册视图）
+        const { bootstrapContextEngine } = await import("../../engine/context_engine/bootstrap.js");
+        bootstrapContextEngine();
+        const { dispatchView, listRegisteredViews } = await import("../../engine/context_engine/view_registry.js");
+        const available = listRegisteredViews();
+        if (!available.includes(viewName)) {
+            userError(`视图 "${viewName}" 不存在。可用视图: ${available.join(", ")}`);
+            process.exit(1);
+        }
+        const result = await dispatchView(viewName, projectPath, { targets });
+        if (isJson) {
+            process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+        }
+        else {
+            userInfo(`视图: ${result.view}`);
+            userInfo(`摘要: ${result.summary}`);
+            userInfo(`证据数: ${result.evidence.length}`);
+            userInfo(`数据: ${JSON.stringify(result.data, null, 2).slice(0, 500)}...`);
+        }
+    }
+    catch (err) {
+        userError(`分析失败: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=analyze.js.map

package/dist/bin/commands/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../../src/bin/commands/analyze.ts"],"names":[],"mappings":"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"}

package/dist/bin/commands/audit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/audit.ts"],"names":[],"mappings":"AAOA,wBAAsB,0BAA0B,kBAsJ/C;AAED,wBAAsB,uBAAuB,kBAyB5C;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,kBA8D9C;AAED,wBAAsB,oBAAoB,kBA8FzC;AAED,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC,CAmEhE;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAkD9D"}
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/audit.ts"],"names":[],"mappings":"AAOA,wBAAsB,0BAA0B,kBA2K/C;AAED,wBAAsB,uBAAuB,kBAyB5C;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,kBA8D9C;AAED,wBAAsB,oBAAoB,kBA8FzC;AAED,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC,CAmEhE;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAkD9D"}

package/dist/bin/commands/audit.js

@@ -15,85 +15,85 @@ export async function cmdAuditTemplateMechanisms() {
     try {
         const { auditTemplateMechanisms } = await import("../../engine/templates/template_mechanism_auditor.js");
         const report = auditTemplateMechanisms(projectPath);
-        if (asJson) {
-            userInfo(JSON.stringify(report, null, 2));
-            if (report.hard_fail_count > 0) {
-                process.exit(1);
-            }
-            return;
-        }
-        // 人类可读输出
-        userInfo(`模板-机制审计报告 (${report.generated_at})`);
-        userInfo(`  模板文件: ${report.total_template_files}`);
-        userInfo(`  注册资产: ${report.total_registered_assets}`);
-        userInfo(`  机制总数: ${report.total_mechanisms}`);
-        userInfo("");
-        if (report.unmapped_template_assets.length > 0) {
-            userInfo(`⚠️  未注册模板 (${report.unmapped_template_assets.length}):`);
-            for (const u of report.unmapped_template_assets) {
-                userInfo(`  - ${u.path}`);
-            }
-        }
-        if (report.unconsumed_template_assets.length > 0) {
-            userInfo(`⚠️  未消费资产 (${report.unconsumed_template_assets.length}):`);
-            for (const u of report.unconsumed_template_assets) {
-                userInfo(`  - ${u.path} (mode=${u.consumption_mode})`);
+        // 收集所有审计阶段的 hard_fail 计数，避免提前退出导致后续审计阶段被跳过
+        let totalHardFailCount = report.hard_fail_count;
+        let totalAdvisoryCount = report.advisory_count;
+        // 阶段 1: 模板机制审计 — 人类可读输出（JSON 模式延迟到最后统一输出）
+        if (!asJson) {
+            userInfo(`模板-机制审计报告 (${report.generated_at})`);
+            userInfo(`  模板文件: ${report.total_template_files}`);
+            userInfo(`  注册资产: ${report.total_registered_assets}`);
+            userInfo(`  机制总数: ${report.total_mechanisms}`);
+            userInfo("");
+            if (report.unmapped_template_assets.length > 0) {
+                userInfo(`⚠️  未注册模板 (${report.unmapped_template_assets.length}):`);
+                for (const u of report.unmapped_template_assets) {
+                    userInfo(`  - ${u.path}`);
+                }
             }
-        }
-        if (report.code_only_mechanisms.length > 0) {
-            userInfo(`⚠️  仅代码机制 (无模板层):`);
-            for (const m of report.code_only_mechanisms) {
-                userInfo(`  - ${m.mechanism_id} (${m.priority}, ${m.status})`);
+            if (report.unconsumed_template_assets.length > 0) {
+                userInfo(`⚠️  未消费资产 (${report.unconsumed_template_assets.length}):`);
+                for (const u of report.unconsumed_template_assets) {
+                    userInfo(`  - ${u.path} (mode=${u.consumption_mode})`);
+                }
             }
-        }
-        if (report.template_only_mechanisms.length > 0) {
-            userInfo(`⚠️  仅模板机制 (无代码层):`);
-            for (const m of report.template_only_mechanisms) {
-                userInfo(`  - ${m.mechanism_id} (${m.priority}, ${m.status})`);
+            if (report.code_only_mechanisms.length > 0) {
+                userInfo(`⚠️  仅代码机制 (无模板层):`);
+                for (const m of report.code_only_mechanisms) {
+                    userInfo(`  - ${m.mechanism_id} (${m.priority}, ${m.status})`);
+                }
             }
-        }
-        if (report.required_assets_without_enforcer.length > 0) {
-            userInfo(`❌ Required 资产无 enforcer (${report.required_assets_without_enforcer.length}):`);
-            for (const r of report.required_assets_without_enforcer) {
-                userInfo(`  - ${r.path} (mechanism=${r.owner_mechanism_id})`);
+            if (report.template_only_mechanisms.length > 0) {
+                userInfo(`⚠️  仅模板机制 (无代码层):`);
+                for (const m of report.template_only_mechanisms) {
+                    userInfo(`  - ${m.mechanism_id} (${m.priority}, ${m.status})`);
+                }
             }
-        }
-        if (report.overpromised_adapter_rules.length > 0) {
-            userInfo(`❌ 适配器过度承诺 (${report.overpromised_adapter_rules.length}):`);
-            for (const o of report.overpromised_adapter_rules) {
-                userInfo(`  - ${o.source_file}: ${o.promised_mechanism_id} (${o.promise_keywords.join(",")})`);
+            if (report.required_assets_without_enforcer.length > 0) {
+                userInfo(`❌ Required 资产无 enforcer (${report.required_assets_without_enforcer.length}):`);
+                for (const r of report.required_assets_without_enforcer) {
+                    userInfo(`  - ${r.path} (mechanism=${r.owner_mechanism_id})`);
+                }
             }
-        }
-        if (report.deprecated_assets_injected.length > 0) {
-            userInfo(`⚠️  Deprecated 资产仍被注入:`);
-            for (const d of report.deprecated_assets_injected) {
-                userInfo(`  - ${d.path}`);
+            if (report.overpromised_adapter_rules.length > 0) {
+                userInfo(`❌ 适配器过度承诺 (${report.overpromised_adapter_rules.length}):`);
+                for (const o of report.overpromised_adapter_rules) {
+                    userInfo(`  - ${o.source_file}: ${o.promised_mechanism_id} (${o.promise_keywords.join(",")})`);
+                }
             }
-        }
-        if (report.template_mechanism_drift.length > 0) {
-            const driftHard = report.template_mechanism_drift.filter((f) => f.severity === "hard_fail");
-            const driftAdvisory = report.template_mechanism_drift.filter((f) => f.severity === "advisory");
-            if (driftAdvisory.length > 0) {
-                userInfo(`⚠️  漂移 advisory (${driftAdvisory.length}):`);
-                for (const f of driftAdvisory) {
-                    userInfo(`  - [${f.finding_type}] ${f.mechanism_id}: ${f.message}`);
+            if (report.deprecated_assets_injected.length > 0) {
+                userInfo(`⚠️  Deprecated 资产仍被注入:`);
+                for (const d of report.deprecated_assets_injected) {
+                    userInfo(`  - ${d.path}`);
                 }
             }
-            if (driftHard.length > 0) {
-                userInfo(`❌ 漂移 hard_fail (${driftHard.length}):`);
-                for (const f of driftHard) {
-                    userInfo(`  - [${f.finding_type}] ${f.mechanism_id}: ${f.message}`);
+            if (report.template_mechanism_drift.length > 0) {
+                const driftHard = report.template_mechanism_drift.filter((f) => f.severity === "hard_fail");
+                const driftAdvisory = report.template_mechanism_drift.filter((f) => f.severity === "advisory");
+                if (driftAdvisory.length > 0) {
+                    userInfo(`⚠️  漂移 advisory (${driftAdvisory.length}):`);
+                    for (const f of driftAdvisory) {
+                        userInfo(`  - [${f.finding_type}] ${f.mechanism_id}: ${f.message}`);
+                    }
+                }
+                if (driftHard.length > 0) {
+                    userInfo(`❌ 漂移 hard_fail (${driftHard.length}):`);
+                    for (const f of driftHard) {
+                        userInfo(`  - [${f.finding_type}] ${f.mechanism_id}: ${f.message}`);
+                    }
                 }
             }
+            userInfo("");
+            if (report.hard_fail_count > 0) {
+                userInfo(`❌ 审计失败: ${report.hard_fail_count} hard_fail, ${report.advisory_count} advisory`);
+            }
+            else {
+                userInfo(`✅ 审计通过: 0 hard_fail, ${report.advisory_count} advisory`);
+            }
         }
-        userInfo("");
-        if (report.hard_fail_count > 0) {
-            userInfo(`❌ 审计失败: ${report.hard_fail_count} hard_fail, ${report.advisory_count} advisory`);
-        }
-        else {
-            userInfo(`✅ 审计通过: 0 hard_fail, ${report.advisory_count} advisory`);
-        }
-        // problem-57: 知识资产 schema 审计
+        // 阶段 2: 知识资产 schema 审计
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let kaReport = null;
         try {
             const { auditKnowledgeAssets, parseAssetFile } = await import("../../engine/knowledge/knowledge_asset_audit.js");
             const knowledgeDirs = [
@@ -115,27 +115,48 @@ export async function cmdAuditTemplateMechanisms() {
                 }
             }
             if (assets.length > 0) {
-                const kaReport = auditKnowledgeAssets(assets);
-                userInfo("");
-                userInfo("知识资产审计:");
-                userInfo(`  资产数: ${kaReport.total_assets}`);
-                userInfo(`  通过: ${kaReport.passed ? "✓" : "✗"}`);
-                userInfo(`  hard_fail: ${kaReport.hard_fail_count}, warning: ${kaReport.warning_count}`);
-                for (const f of kaReport.findings) {
-                    const icon = f.severity === "hard_fail" ? "❌" : "⚠️";
-                    userInfo(`    ${icon} ${f.asset_id ?? f.file_path}: ${f.detail} (${f.kind})`);
-                }
-                if (kaReport.hard_fail_count > 0) {
-                    userInfo(`❌ 知识资产审计有 ${kaReport.hard_fail_count} hard_fail`);
-                    process.exit(1);
+                kaReport = auditKnowledgeAssets(assets);
+                totalHardFailCount += kaReport.hard_fail_count;
+                totalAdvisoryCount += kaReport.warning_count;
+                if (!asJson) {
+                    userInfo("");
+                    userInfo("知识资产审计:");
+                    userInfo(`  资产数: ${kaReport.total_assets}`);
+                    userInfo(`  通过: ${kaReport.passed ? "✓" : "✗"}`);
+                    userInfo(`  hard_fail: ${kaReport.hard_fail_count}, warning: ${kaReport.warning_count}`);
+                    for (const f of kaReport.findings) {
+                        const icon = f.severity === "hard_fail" ? "❌" : "⚠️";
+                        userInfo(`    ${icon} ${f.asset_id ?? f.file_path}: ${f.detail} (${f.kind})`);
+                    }
                 }
             }
         }
         catch (e) {
             userError(`❌ 知识资产审计异常: ${errorMessage(e)}`);
-            process.exit(1);
+            totalHardFailCount += 1;
+        }
+        // 所有审计阶段完成后统一输出汇总并决定退出码
+        if (asJson) {
+            userInfo(JSON.stringify({
+                ...report,
+                knowledge_asset_audit: kaReport,
+                total_hard_fail_count: totalHardFailCount,
+                total_advisory_count: totalAdvisoryCount,
+            }, null, 2));
+        }
+        else {
+            userInfo("");
+            if (kaReport && kaReport.hard_fail_count > 0) {
+                userInfo(`❌ 知识资产审计有 ${kaReport.hard_fail_count} hard_fail`);
+            }
+            if (totalHardFailCount > 0) {
+                userInfo(`❌ 审计总失败: ${totalHardFailCount} hard_fail, ${totalAdvisoryCount} advisory`);
+            }
+            else {
+                userInfo(`✅ 全部审计通过: 0 hard_fail, ${totalAdvisoryCount} advisory`);
+            }
         }
-        if (report.hard_fail_count > 0) {
+        if (totalHardFailCount > 0) {
             process.exit(1);
         }
     }