soloforge 1.1.37 → 1.1.40

package/templates/rules/shared//350/264/250/351/207/217/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -1,99 +1,102 @@
 ---
 name: quality-rules
 type: review_rule
-when: '代码审查, review, 质量检查, 代码质量'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-review-rule-质量审查规则
-asset_kind: review_rule
 lifecycle_status: active
 owner_mechanism_id: mc-generic-review
 authority: supporting
-routes:
-  - code_change
-primary_triggers:
-  - 质量审查规则
-secondary_triggers: []
-negative_triggers: []
 priority: P1
-specificity: 5
-version: 1.1.0
-last_reviewed: '2026-06-01'
+version: 1.2.0
+last_reviewed: '2026-06-04'
 stages: ["编码与单元测试"]
+triggers: ["代码审查","review","质量检查","代码质量"]
 ---
 
 ## QUA-01: 生产代码包含 console.log 调试输出
 pattern: /console\.log\s*\(/
 severity: warning
+check_type: deterministic
 scope: "!test"
 description: 生产代码禁止保留 console.log，应使用正式日志框架并按级别输出
 
 ## QUA-02: TypeScript 使用 any 类型
 pattern: /:\s*any\b|as\s+any\b|<any>/
 severity: info
+check_type: deterministic
 scope: frontend
 description: 禁止使用 any 类型，应定义具体的 TypeScript 接口
 
 ## QUA-03: 魔法数字未定义为常量
 pattern: /(?:if|while|return)\s*\(.*[^\w>!=]\d{2,}[^\w.]/
 severity: info
+check_type: deterministic
 scope: [backend, frontend]
 description: 代码中的数字常量应提取为命名常量，提高可读性和可维护性
 
 ## QUA-04: 硬编码的 URL 或 IP 地址
 pattern: /https?:\/\/(?:localhost|127\.0\.0\.1|192\.168|10\.\d+\.\d+)\b/
 severity: warning
+check_type: deterministic
 scope: [backend, frontend]
 description: 服务地址禁止硬编码，必须使用环境变量或配置文件管理
 
 ## QUA-05: catch 块吞掉异常不处理
 pattern: /catch\s*\([^)]*\)\s*\{\s*\}/
-severity: critical
+severity: error
+check_type: deterministic
 scope: [backend, frontend]
 description: 空的 catch 块会隐藏错误，至少需要记录日志或明确注释忽略原因
 
 ## QUA-06: 注释掉的代码块（超过 3 行）
 pattern: /^\s*\/\/\s*(?:import|export|const|let|var|function|class|public|private)\b/
 severity: info
+check_type: deterministic
 scope: [backend, frontend]
 description: 注释掉的代码应删除，需要时从版本控制中恢复
 
 ## QUA-07: System.out.println 替代日志框架
 pattern: /System\.out\.print/
 severity: warning
+check_type: deterministic
 scope: backend
 description: 禁止使用 System.out.println，必须使用 SLF4J/Log4j 等日志框架
 
 ## QUA-08: 空 catch 块中无日志记录
 pattern: /catch\s*\([^)]*\)\s*\{[^}]*\}/
 severity: warning
+check_type: deterministic
 scope: [backend, frontend]
 description: catch 块中必须至少包含日志记录，不允许静默忽略异常
 
 ## QUA-09: 待办/修复占位注释未跟踪
 pattern: /(?:T[O]DO|F[I]XME|H[A]CK|X{3})\s*[:\(]/
 severity: info
+check_type: deterministic
 scope: [backend, frontend]
 description: 待办/修复占位注释必须关联 issue 编号，禁止无跟踪的技术债标记
 
 ## QUA-10: 单元测试缺少断言
 pattern: /@Test[\s\S]*?(?:expect|assert|verify|should)/
 severity: warning
+check_type: deterministic
 scope: [backend, frontend]
 description: 测试方法必须包含至少一个断言，空测试等于没有测试
 
 ## QUA-11: 过深的嵌套层级
-pattern: //
+pattern: nesting_depth
 severity: info
+check_type: programmatic
 scope: [backend, frontend]
-check: nesting_depth
 description: 代码嵌套层级超过 4 层时应重构（卫语句、提前返回、策略模式）
 
 ## QUA-12: 未处理可空返回值
 pattern: /\.get\(\s*\)\s*\.|\.findFirst\(\s*\)\s*\./
 severity: warning
+check_type: deterministic
 scope: backend
 description: Optional/List.get() 返回值必须判空，禁止直接链式调用导致 NPE

package/templates/rules/shared//350/277/275/350/270/252/347/237/251/351/230/265ID/350/247/204/345/210/231.md

@@ -0,0 +1,48 @@
+---
+name: traceability-id-rules
+type: review_rule
+scope: ['*']
+products: ['*']
+lifecycle_status: active
+owner_mechanism_id: mc-design-artifact-pack
+authority: supporting
+stages: ["架构设计", "详细设计", "任务规划"]
+triggers: ["追踪矩阵","ID规则","REQ","ARCH","DD","SLICE","AC"]
+---
+
+# 追踪矩阵 ID 规则
+
+## ID 命名规则
+
+| ID 前缀 | 实体类型 | 产出阶段 | 格式示例 |
+|---------|---------|---------|---------|
+| REQ- | 需求 | 需求分析 | REQ-01 |
+| PROTO- | 原型说明 | 需求分析 | PROTO-01 |
+| ARCH- | 架构决策 | 架构设计 | ARCH-01 |
+| DD-T | 数据库设计 | 详细设计 | DD-T01 |
+| DD-A | API 设计 | 详细设计 | DD-A01 |
+| PHASE- | 实现阶段 | 任务规划 | PHASE-01 |
+| SLICE- | 实现切片 | 任务规划 | SLICE-01 |
+| AC- | 验收标准 | 任务规划 | AC-01 |
+| ADR- | 架构决策记录 | 架构设计 | ADR-01 |
+| MOD- | 模块 | 架构设计 | MOD-01 |
+| RISK- | 风险 | 架构设计 | RISK-01 |
+| NFR- | 非功能需求 | 架构设计 | NFR-01 |
+
+## ID 引用链约束
+
+1. 架构设计必须引用 `REQ-*` 或 `PROTO-*`
+2. 详细设计必须引用 `ARCH-*` 并声明 `DD-*`
+3. 数据库设计声明 `DD-T*`，API 规格声明 `DD-A*`
+4. 切片计划必须引用 `DD-*` 或 `ARCH-*`，并声明 `SLICE-*` 和 `AC-*`
+5. 编码任务上下文必须包含 `PHASE-*`、`SLICE-*`、`DD-*`、`AC-*`
+6. ID 编号不得重复，不得跳号（删除除外）
+7. 架构设计追踪矩阵须包含 ADR-REF 列，每行需求关联对应 ADR-ID
+8. 架构设计追踪矩阵须包含 MOD 列，标注对应架构模块
+9. 子产物（数据库变更方案/接口对接方案）引用的表名/接口名须在主产物中存在
+
+## 校验时机
+
+- 架构设计完成后：验证 ARCH-* 全部引用上游 REQ-*/PROTO-*
+- 详细设计完成后：验证 DD-* 全部引用上游 ARCH-*
+- 任务规划完成后：验证 SLICE-*/AC-* 全部引用上游 DD-*

package/templates/rules/shared//350/277/275/350/270/252/347/237/251/351/230/265/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -0,0 +1,51 @@
+---
+name: traceability-matrix-review
+type: review_rule
+scope: ['*']
+products:
+  - '*'
+id: ka-review-rule-追踪矩阵审查规则
+lifecycle_status: active
+authority: supporting
+priority: P1
+stages: ["架构设计", "详细设计"]
+owner_mechanism_id: mc-design-artifact-pack
+triggers: ["追踪矩阵审查","覆盖分析","traceability review"]
+---
+
+# 追踪矩阵审查规则
+
+## TRACE-01: 全链路闭合
+
+pattern: 每条需求行从需求到验收各 ID 列无空洞
+severity: error
+scope: ['*']
+description: 总矩阵中每行需求的"原型 ID""架构 ID""详细设计 ID""切片 ID""验收 ID"列不得为空（"已排除"行除外）。
+
+## TRACE-02: 覆盖完整
+
+pattern: 每条需求 ID 必须在总矩阵中出现至少一次
+severity: error
+scope: ['*']
+description: 第 6.1 正向覆盖中，所有"完全覆盖"行必须有设计承接 + 切片 + 验收三列非空；"已排除"行必须注明排除原因。
+
+## TRACE-03: 反向清洁
+
+pattern: 反向覆盖无"金镀"行
+severity: warning
+scope: ['*']
+description: 第 6.2 反向覆盖检查中，状态为"金镀"的行必须标注处理方式（补充上游需求或删除下游项）。
+
+## TRACE-04: ID 规则一致
+
+pattern: 所有 ID 符合追踪矩阵ID规则的命名规范
+severity: error
+scope: ['*']
+description: 需求 ID 格式 REQ-NNN、原型 ID 格式 PROTO-NNN、架构 ID 格式 ARCH-NNN、详细设计 ID 格式 DD-NNN、验收 ID 格式 AC-NNN，不得有格式错误或重复。
+
+## TRACE-05: 变更同步
+
+pattern: 变更记录与总矩阵状态一致
+severity: warning
+scope: ['*']
+description: 第 5 章变更记录中每条变更对应的"影响 ID"必须在总矩阵中存在，且总矩阵中该行的状态与变更处理结论一致。

package/templates/rules/shared//351/234/200/346/261/202/350/264/250/351/207/217/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -1,29 +1,20 @@
 ---
 name: requirement-quality-review
 type: review_rule
-when: '需求分析, 需求审查, requirement review'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-review-rule-需求质量审查规则
-asset_kind: review_rule
 lifecycle_status: active
 authority: supporting
-routes: ['code_change', 'planning']
-primary_triggers:
-  - 需求质量审查规则
-secondary_triggers:
-  - 需求审查
-  - 需求质量
-negative_triggers: []
 priority: P1
-specificity: 5
-version: 1.1.0
-last_reviewed: '2026-06-01'
-stages: ["编码与单元测试", "联调验证"]
-owner_mechanism_id: mc-intent-router
+version: 1.2.0
+last_reviewed: '2026-06-04'
+stages: ["需求分析"]
+owner_mechanism_id: mc-command-router
+triggers: ["需求分析","需求审查","requirement review"]
 ---
 
 # 需求质量审查规则
@@ -40,7 +31,10 @@ description: 每个需求点必须至少有一条可验证的验收标准，避
 pattern: 需求分析必须覆盖功能需求、非功能需求和约束条件
 severity: warning
 scope: [backend, frontend]
-description: 需求文档必须明确区分功能需求（做什么）、非功能需求（性能、安全、可用性等）和约束条件（技术栈、时间、资源等）
+description: 需求文档必须明确区分功能需求（做什么）、非功能需求（性能、安全、可用性等）和约束条件（技术栈、时间、资源等）。
+  非功能需求必须包含量化验收指标：性能需求必须有响应时间/并发数指标；安全需求必须有加密标准/认证方式；
+  可用性需求必须有可用率百分比；兼容性需求必须有具体浏览器/设备版本。
+  禁止出现"高性能""安全""稳定"等无量化指标的表述。
 
 ## REQ-03: 需求无歧义表达
 
@@ -62,3 +56,25 @@ pattern: 每个功能需求必须包含触发条件、处理逻辑和预期结
 severity: warning
 scope: [backend, frontend]
 description: 缺少触发条件、处理逻辑或预期结果的需求必须标注为"待补充"，不得留空
+
+## REQ-06: 用户角色一致性
+
+pattern: 菜单权限和功能点引用的角色必须在用户角色章节中有定义
+severity: error
+scope: [backend, frontend]
+description: 第 6 章菜单权限的每个角色名称必须在第 9 章用户角色中存在对应条目；
+  第 2 章功能点的"关联角色"引用同样必须在第 9 章有定义。发现未定义角色引用应立即阻断。
+
+## REQ-07: 需求单一性
+
+pattern: 每条功能点必须只描述一个用户操作或一个业务规则
+severity: warning
+scope: [backend, frontend]
+description: 禁止一条功能点包含多个"当...时"条件分支或多个"和"连接的独立操作。复合需求应拆分为多条，用前置依赖字段关联。
+
+## REQ-08: 需求可追溯
+
+pattern: 每条功能点必须有唯一编号且被追踪矩阵引用
+severity: warning
+scope: [backend, frontend]
+description: 功能点编号格式为 REQ-NNN，且该编号必须在追踪矩阵总矩阵的"需求 ID"列中出现。发现未被追踪矩阵引用的功能点应标注为"待追溯"。

package/templates/rules/shared//351/252/214/346/224/266/346/240/207/345/207/206/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -1,30 +1,20 @@
 ---
 name: acceptance-criteria-review
 type: review_rule
-when: '本地验收, 验收标准, acceptance review'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-review-rule-验收标准审查规则
-asset_kind: review_rule
 lifecycle_status: active
 owner_mechanism_id: mc-local-acceptance
 authority: supporting
-routes:
-  - code_change
-primary_triggers:
-  - 验收标准审查规则
-secondary_triggers:
-  - 验收审查
-  - 验收标准
-negative_triggers: []
 priority: P1
-specificity: 5
-version: 1.1.0
-last_reviewed: '2026-06-01'
+version: 1.3.0
+last_reviewed: '2026-06-04'
 stages: ["编码与单元测试", "联调验证"]
+triggers: ["本地验收","验收标准","acceptance review"]
 ---
 
 # 验收标准审查规则
@@ -32,27 +22,35 @@ stages: ["编码与单元测试", "联调验证"]
 ## ACC-01: 验收场景覆盖三路径
 
 pattern: 验收场景必须覆盖正常路径、边界条件和异常路径
-severity: warning
+severity: error
+check_type: semantic
+evidence_required: ["测试计划中 P0 条目的覆盖策略分布"]
 scope: [backend, frontend]
 description: 验收测试至少包含：正常业务流程（happy path）、边界值输入（最大/最小/空值）、异常处理（错误输入、网络超时、权限不足）
 
 ## ACC-02: 验收证据含截图或日志
 
 pattern: 每个验收场景必须有执行证据
-severity: warning
+severity: error
+check_type: deterministic
+evidence_required: ["每个 P0 测试条目的 evidence 文件路径"]
 scope: [backend, frontend]
 description: 验收证据可以是：UI 截图、API 响应日志、测试输出报告；纯文字描述不构成有效证据
 
 ## ACC-03: 用户确认记录
 
 pattern: 验收结果必须经用户确认
-severity: warning
+severity: error
+check_type: deterministic
+evidence_required: ["sf_accept 返回的用户确认记录"]
 scope: [backend, frontend]
 description: sf_accept 返回的验收结果必须有用户确认的记录；AI 不得自行标记验收通过
 
 ## ACC-04: 回归验证
 
 pattern: 验收必须包含回归验证
-severity: warning
+severity: error
+check_type: deterministic
+evidence_required: ["回归测试执行结果"]
 scope: [backend, frontend]
 description: 变更代码的验收必须运行全量回归测试，确认变更未破坏已有功能

package/templates//346/250/241/347/211/210/350/264/241/347/214/256/346/214/207/345/215/227.md

@@ -1,16 +1,13 @@
 ---
 name: template-contribution-guide
 type: governance_rule
-asset_kind: governance_rule
 owner_mechanism_id: mc-standard-asset-contract
 authority: supporting
-specificity: 5
 lifecycle_status: active
-routes: ['*']
 scope:
   - '*'
-when: '新增模版文件、模版贡献、模版资产维护'
 stages: ["*"]
+triggers: ["新增模版文件、模版贡献、模版资产维护"]
 ---
 
 # 新增模版文件检查清单
@@ -53,9 +50,7 @@ stages: ["*"]
 ---
 name: "文件中文名（kebab-case 或中文）"
 type: "见上表 9 种合法值"
-asset_kind: "与 type 兼容的注册侧分类"
-routes:
-  - "IntentRoute 值或 *"
+# asset_kind 已废弃，统一使用 type
 scope:
   - "backend / frontend / infrastructure / *"
 stages:
@@ -70,21 +65,26 @@ owner_mechanism_id: "mc-xxx-yyy"
 
 | 字段 | 合法值 | 说明 |
 |------|--------|------|
+| `triggers` | 字符串数组 | 触发关键词数组，用于辅助匹配（替代旧 `when` + `primary_triggers`） |
 | `system_scope` | `shared` / `existing-system` / `new-system` | 默认 `shared` |
-| `specificity` | 2-5 整数 | 优先级权重，默认 3 |
 | `authority` | `canonical` / `supporting` | 仅 `internal/rules/` 和 `rules/shared/` 允许 `canonical` |
-| `when` | 自然语言触发描述 | 描述什么场景下注入 |
-| `primary_triggers` | 关键词列表 | 用于关键词匹配 |
 | `consumes` | mechanism_id 列表 | 此资产依赖哪些机制产出 |
 | `consumed_by` | mechanism_id 列表 | 此资产被哪些机制消费 |
 | `emits` | 产物标识列表 | 此资产产出什么 |
 | `required_evidence` | 证据标识列表 | 执行此资产需要什么证据 |
 | `products` | `*` 或产品类型 | 当前全部 `*` |
+| `companion_rules` | `[规则文件名:usage]` 格式 | 四层伴生规则，usage ∈ {execute, review, check}，仅 artifact 模版 |
+| `companion_gates` | gate YAML 文件名数组 | 四层伴生门禁，仅 artifact 模版 |
+| `requires_context` | 上下文视图名数组 | 触发上下文引擎调用，仅 artifact 模版 |
 
 ### 禁止字段
 
 | 字段 | 处理 |
 |------|------|
+| `when` | 已废弃，统一用 `triggers` |
+| `primary_triggers` | 已废弃，统一用 `triggers` |
+| `specificity` | 已删除 |
+| `asset_kind` | 已废弃，统一用 `type` |
 | `status` | 已废弃，统一用 `lifecycle_status` |
 | `migration_note` | 已废弃，运行时无意义 |
 
@@ -113,7 +113,7 @@ owner_mechanism_id: "mc-xxx-yyy"
 
 同主题文件遵循五层纵深模型：
 
-```
+```text
 规则(governance_rule) → 流程(procedure) → 产出(artifact_template)
 规范(pattern) → 审查(review_rule)
 ```

package/dist/engine/config/config_auto_repair.d.ts

@@ -1,30 +0,0 @@
-export type ConfigRepairIssueKind = "schema_type" | "evidence_missing" | "evidence_stale" | "evidence_mismatch";
-export interface ConfigRepairIssue {
-    kind: ConfigRepairIssueKind;
-    field_path: string;
-    message_zh: string;
-    before?: unknown;
-    after?: unknown;
-}
-export interface ConfigRepairAnalysis {
-    project_path: string;
-    config_path: string;
-    evidence_path: string;
-    config_exists: boolean;
-    parse_error: string | null;
-    issues: ConfigRepairIssue[];
-    normalized_config: Record<string, unknown> | null;
-    needs_repair: boolean;
-    auto_resolvable: boolean;
-}
-export interface ConfigRepairResult extends ConfigRepairAnalysis {
-    dry_run: boolean;
-    changed: boolean;
-    backup_paths: string[];
-}
-export { hashValue as _hashValue } from "./config_precedence_contract/evidence.js";
-export declare function analyzeConfigRepair(projectPath: string): ConfigRepairAnalysis;
-export declare function repairProjectConfig(projectPath: string, options?: {
-    dry_run?: boolean;
-}): ConfigRepairResult;
-//# sourceMappingURL=config_auto_repair.d.ts.map

package/dist/engine/config/config_auto_repair.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config_auto_repair.d.ts","sourceRoot":"","sources":["../../../src/engine/config/config_auto_repair.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;AAEhH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAClD,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAsGD,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAoFnF,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,oBAAoB,CAoD7E;AAWD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,kBAAkB,CAiBhH"}