soloforge 1.1.37 → 1.1.40

package/templates/internal/patterns//350/257/255/344/271/211/350/257/201/346/215/256.md

@@ -1,31 +1,20 @@
 ---
 name: semantic_evidence
-when: '代码交付, 需求覆盖, 验证证据, 语义分析'
 scope: ['*']
 products:
   - '*'
 id: ka-pattern-semantic_evidence
-asset_kind: pattern
 lifecycle_status: active
 authority: supporting
-routes:
-  - '*'
-primary_triggers:
-  - 代码交付
-  - 需求覆盖
-  - 验证证据
-  - 语义分析
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits: []
-secondary_triggers: []
-negative_triggers: []
 type: pattern
 stages: ["*"]
 owner_mechanism_id: mc-engine-runtime
+triggers: ["代码交付","需求覆盖","验证证据","语义分析"]
 ---
 
 ## 决策规则

package/templates/internal/patterns//350/277/220/350/241/214/345/256/211/345/205/250/345/214/205.md

@@ -1,32 +1,20 @@
 ---
 name: runtime_safety
-when: '运行安全, 证据链, 命令分级, 供应链, 迁移回滚'
 scope: ['*']
 products:
   - '*'
 id: ka-pattern-runtime_safety
-asset_kind: pattern
 lifecycle_status: active
 authority: supporting
-routes:
-  - '*'
-primary_triggers:
-  - 运行安全
-  - 证据链
-  - 命令分级
-  - 供应链
-  - 迁移回滚
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits: []
-secondary_triggers: []
-negative_triggers: []
 type: pattern
 stages: ["*"]
 owner_mechanism_id: mc-engine-runtime
+triggers: ["运行安全","证据链","命令分级","供应链","迁移回滚"]
 ---
 
 ## 决策规则

package/templates/internal/patterns//351/252/214/350/257/201/345/221/275/344/273/244/347/224/237/346/210/220.md

@@ -1,38 +1,28 @@
 ---
 name: verify_command_generation
-when: '验证, 编译, 测试命令, 项目类型检测'
 scope: ['*']
 products:
   - '*'
 id: ka-pattern-verify_command_generation
-asset_kind: pattern
 lifecycle_status: active
 authority: supporting
-routes:
-  - '*'
-primary_triggers:
-  - 验证
-  - 编译
-  - 测试命令
-  - 项目类型检测
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits: []
-secondary_triggers: []
-negative_triggers: []
 type: pattern
 stages: ["*"]
 owner_mechanism_id: mc-engine-runtime
+triggers: ["验证","编译","测试命令","项目类型检测"]
 ---
 
 ## 决策规则
 
 - generateVerifyCommands 根据项目类型生成编译和测试命令
-- 三个分支: config（有 sf.yaml）、doc-only（无代码项目）、repo（标准项目）
-- repo 分支通过 detectFingerprint 识别技术栈
+- 三个分支: config（有 intent.yaml）、doc-only（无代码项目）、repo（标准项目）
+- repo 分支通过 resolveConfig 推导技术栈和构建命令
+- config 分支使用 intent.yaml 中的 overrides.build_commands 覆盖框架约定
 - 生成的命令必须可执行，且覆盖编译 + 测试两个阶段
 - 边界项目（无 package.json）必须有 fallback 处理
 

package/templates/internal/rules/OOD/344/270/216SOLID/350/256/276/350/256/241/350/247/204/345/210/231.md

@@ -7,26 +7,13 @@ products:
   - '*'
 id: ka-hard-rule-OOD与SOLID设计规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-ood-solid-contract
 asset_role: required
 consumed_by:
   - mc-ood-solid-contract
-routes: ['code_change', 'artifact_generation']
-primary_triggers:
-  - 面向对象设计
-  - SOLID
-secondary_triggers:
-  - 领域服务
-  - 重构
-  - 策略
-negative_triggers:
-  - 文案
-  - 样式
 priority: P1
-specificity: 5
 consumes:
   - mc-coding-readiness
 hard_blocks:

package/templates/internal/rules//344/272/247/347/211/251/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -5,17 +5,10 @@ scope:
 products:
   - '*'
 id: ka-hard-rule-产物契约规则
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-artifact-contract
-routes: ['*']
-primary_triggers:
-  - 产物契约规则
-secondary_triggers: []
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - mc-workflow-contract
 hard_blocks:
@@ -28,8 +21,8 @@ required_evidence:
 version: 1.1.0
 last_reviewed: '2026-06-01'
 type: governance_rule
-when: 产物契约规则
 stages: ["*"]
+triggers: ["产物契约规则"]
 ---
 
 # 产物契约规则
@@ -40,7 +33,7 @@ stages: ["*"]
 2. 产物生命周期：draft → verified → accepted。跳过阶段必须显式声明 `skip_verification`。
 3. `overwrite_policy` 仅允许 `fail_if_exists` 或 `versioned`。禁止 `force_overwrite`。
 4. 产物路径必须在 `declared_scope` 内。scope 外产物触发 hard_fail。
-5. 所有产物变更必须通过 `sf_verify` 验证后才能推进状态。
+5. 所有产物变更必须通过 `sf_gate_check` 验证后才能推进状态。
 
 ## 适用场景
 

package/templates/internal/rules//344/273/243/347/240/201/346/263/250/351/207/212/344/270/216/346/227/245/345/277/227/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -6,36 +6,10 @@ products:
   - '*'
 id: ka-hard-rule-代码注释与日志契约规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-code-maintainability-observability-contract
-routes: ['code_change', 'artifact_generation', 'operation']
-primary_triggers:
-  - 业务编码
-  - 接口实现
-  - 状态流转
-  - 支付
-  - 权限
-  - 迁移脚本
-  - 数据修复
-secondary_triggers:
-  - Service
-  - Controller
-  - UseCase
-  - Handler
-  - Router
-  - Form
-  - Store
-  - 异常处理
-negative_triggers:
-  - 文案
-  - 样式
-  - getter
-  - setter
-  - fixture
 priority: P0
-specificity: 5
 consumes:
   - mc-coding-readiness
 hard_blocks:
@@ -89,7 +63,7 @@ stages: ["*"]
 
 ## 日志契约
 
-### 必须有日志
+### 日志中必须有
 - 用户登录、登出、认证失败
 - 权限拒绝、越权访问
 - 创建、修改、删除关键业务对象
@@ -102,7 +76,7 @@ stages: ["*"]
 - 降级、兜底、补偿逻辑
 - 前端关键交互：表单提交、状态变更、权限动作、支付/敏感操作、上传导入、API 调用失败
 
-### 日志必须具备
+### 日志必须具备的要素
 - 中文事件名或中文动作说明
 - 事件名或动作名
 - 业务对象 ID
@@ -112,7 +86,7 @@ stages: ["*"]
 - 关键状态变化前后值
 - 合理日志级别
 
-### 必须禁止
+### 日志中必须禁止
 - 裸 console.log（生产代码）
 - 生产代码遗留调试日志
 - catch 后无日志直接吞异常

package/templates/internal/rules//344/273/273/345/212/241/344/270/212/344/270/213/346/226/207/347/224/237/345/221/275/345/221/250/346/234/237/350/247/204/345/210/231.md

@@ -6,7 +6,6 @@ products:
   - '*'
 id: ka-hard-rule-任务上下文生命周期规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-task-context-lifecycle
@@ -15,16 +14,7 @@ consumed_by:
   - mc-task-context-lifecycle
   - consumable_asset_registry
   - knowledge_injection
-routes: ['*']
-primary_triggers:
-  - 任务上下文生命周期规则
-secondary_triggers:
-  - TaskContext
-  - 任务上下文
-  - task_context
-negative_triggers: []
 priority: P1
-specificity: 5
 consumes:
   - mc-task-context-lifecycle
 hard_blocks:

package/templates/internal/rules//345/220/216/347/253/257/345/256/236/347/216/260/345/267/245/347/250/213/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -6,26 +6,13 @@ products:
   - '*'
 id: ka-hard-rule-后端实现工程契约规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-backend-implementation-contract
 asset_role: required
 consumed_by:
   - mc-backend-implementation-contract
-routes: ['code_change', 'artifact_generation']
-primary_triggers:
-  - 后端实现
-  - 接口实现
-secondary_triggers:
-  - Controller
-  - DTO
-  - 事务
-  - 幂等
-negative_triggers:
-  - 文案
 priority: P1
-specificity: 5
 consumes:
   - mc-coding-readiness
 hard_blocks:

package/templates/internal/rules//345/221/275/344/273/244/346/211/247/350/241/214/350/247/204/345/210/231.md

@@ -5,17 +5,10 @@ scope:
 products:
   - '*'
 id: ka-hard-rule-命令执行规则
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-command-execution
-routes: ['*']
-primary_triggers:
-  - 命令执行规则
-secondary_triggers: []
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - mc-tool-invocation-contract
 hard_blocks:
@@ -28,8 +21,8 @@ required_evidence:
 version: 1.1.0
 last_reviewed: '2026-06-01'
 type: governance_rule
-when: 命令执行规则
 stages: ["*"]
+triggers: ["命令执行规则"]
 ---
 
 # 命令执行规则

package/templates/internal/rules//345/221/275/344/273/244/350/267/257/347/224/261/350/247/204/345/210/231.md

@@ -0,0 +1,30 @@
+---
+name: command-routing
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-hard-rule-命令路由规则
+type: governance_rule
+lifecycle_status: active
+authority: canonical
+owner_mechanism_id: mc-command-router
+priority: P0
+stages: ["*"]
+version: 1.0.0
+last_reviewed: '2026-06-02'
+---
+
+# 命令路由规则
+
+## 核心原则
+
+命令路由是 SoloForge 的入口裁决机制，替代已废弃的意图路由。所有用户命令必须通过状态机驱动的命令路由裁决，确定命令类型和对应的执行路径。
+
+## 规则
+
+1. **状态机驱动**: 命令路由由管线状态机驱动，不依赖 NLP 分类
+2. **命令类型裁决**: 每个命令必须裁决出有效的 command_state 和 execution_shape
+3. **降级处理**: 路由失败时默认降级为 code_execution，标记 degraded
+4. **只读保护**: 只读命令不允许 mutation
+5. **快捷路径**: direct_answer 和 single_artifact 有独立的快捷路径

package/templates/internal/rules//345/267/245/344/275/234/346/265/201/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -5,17 +5,10 @@ scope:
 products:
   - '*'
 id: ka-hard-rule-工作流契约规则
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-workflow-contract
-routes: ['*']
-primary_triggers:
-  - 工作流契约规则
-secondary_triggers: []
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - mc-workflow-contract
 hard_blocks:
@@ -28,8 +21,8 @@ required_evidence:
 version: 1.1.0
 last_reviewed: '2026-06-01'
 type: governance_rule
-when: 工作流契约规则
 stages: ["*"]
+triggers: ["工作流契约规则"]
 ---
 
 # 工作流契约规则

package/templates/internal/rules//345/267/245/344/275/234/346/265/201/345/257/274/350/210/252/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -6,7 +6,6 @@ products:
   - '*'
 id: ka-hard-rule-工作流导航契约规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-workflow-navigation-contract
@@ -15,18 +14,7 @@ consumed_by:
   - mc-workflow-navigation-contract
   - consumable_asset_registry
   - knowledge_injection
-routes: ['operation', 'artifact_generation']
-primary_triggers:
-  - 工作流导航契约规则
-secondary_triggers:
-  - 下一步
-  - 继续
-  - 现在能写代码吗
-  - 导航
-  - navigation
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - mc-workflow-navigation-contract
 hard_blocks:
@@ -66,15 +54,16 @@ AI 不得只说“需要确认”。必须说明哪些是必须确认、哪些
    - 阻断：sf_execute
    - 必须先通过设计审计复验
 
-2. **配置未确认 → 区分自动修复与业务确认**
-   - 条件：项目阶段为 configuration_pending
-   - 阻断：除 sf_init、config_confirm 外的所有动作
-   - version 数字/字符串、scope 字符串/数组、config.evidence.json 缺失/过期/不匹配属于自动修复项，必须提示 soloforge config repair
-   - 产品类型、技术栈选择、仓库边界、业务范围等语义口径才进入 config confirm 或用户确认
+2. **配置不完整 → 补充不可探测字段**
+   - 条件：resolveConfig 返回 missing 字段（tech_stack 或 build_commands）
+   - 阻断：除 sf_init、sf_config_update、config set 外的所有动作
+   - 技术栈和构建命令由项目文件探测自动推导，无需手动配置
+   - 产品类型、交付设置等不可探测字段通过 `soloforge config set` 或 `sf_config_update` 补充
+   - 配置冲突（intent 声明与探测结果矛盾）通过 `soloforge config check` 识别
 
 3. **决策未确认 → 禁止定稿架构/详细设计/代码**
    - 条件：架构决策研讨中存在未确认域
-   - 阻断：sf_execute、sf_expand
+   - 阻断：sf_execute、sf_stage_execute
    - 必须先完成决策研讨并获取用户确认
 
 4. **无开发切片计划 → 禁止大范围编码**
@@ -84,17 +73,17 @@ AI 不得只说“需要确认”。必须说明哪些是必须确认、哪些
 
 5. **修复重验指令未清零 → 禁止交付**
    - 条件：repair_reverify_directive.blocked = true
-   - 阻断：sf_deliver
+   - 阻断：sf_stage_advance
    - 必须先完成修复和复验
 
 6. **测试失败 → 禁止交付**
    - 条件：verification_result.status = failed
-   - 阻断：sf_deliver
+   - 阻断：sf_stage_advance
    - 必须先修复测试
 
 7. **本地验收缺失 → 禁止交付结论**
    - 条件：delivery_ready 但无 local_acceptance_evidence
-   - 阻断：sf_deliver
+   - 阻断：sf_stage_advance
    - 必须先完成本地验收
 
 ## 陈旧任务处理协议
@@ -116,8 +105,8 @@ AI 不得只说“需要确认”。必须说明哪些是必须确认、哪些
 - 不得建议“先用 Bash 直接修改业务代码”。
 - 不得建议手动删除或清理 `.soloforge/state`。
 - 不得把“先实现后补验证”作为恢复路径。
-- 必须按工具返回的 `recovery_command`、`soloforge next`、`sf_expand`、`sf_verify` 或经用户确认的 `sf_status action=archive_stale confirm=true` 恢复。
-- 只有 `soloforge next` 或 `sf_status` 明确判定 current-task 陈旧时才允许归档；归档后仍必须重新 `sf_classify -> sf_expand` 建立受控任务，不能直接写代码。
+- 必须按工具返回的 `recovery_command`、`soloforge next`、`sf_stage_execute`、`sf_gate_check` 或经用户确认的 `sf_status action=archive_stale confirm=true` 恢复。
+- 只有 `soloforge next` 或 `sf_status` 明确判定 current-task 陈旧时才允许归档；归档后仍必须重新 `sf_command -> sf_stage_execute` 建立受控任务，不能直接写代码。
 
 ## Override 协议
 
@@ -135,8 +124,8 @@ AI 不得只说“需要确认”。必须说明哪些是必须确认、哪些
 
 `confirmation_decisions` 必须包含：
 
-- `must_confirm`
-- `should_confirm`
-- `auto_resolvable`
+- `must_confirm`：必须用户确认的事项（业务口径、架构决策等）
+- `should_confirm`：建议确认但不阻断
+- `auto_resolvable`：可通过命令或自动推导解决
 - `blocked_reason`
 - `recommended_action`

package/templates/internal/rules//345/267/245/344/275/234/346/265/201/346/250/241/347/211/210/345/214/205/350/247/204/345/210/231.md

@@ -6,18 +6,10 @@ products:
   - '*'
 id: ka-hard-rule-工作流模版包规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-workflow-template-pack
-routes: ['*']
-primary_triggers:
-  - 模版消费
-  - 工作流模版
-secondary_triggers: []
-negative_triggers: []
 priority: P1
-specificity: 4
 consumes:
   - ka-hard-rule-核心工程执行原则
 hard_blocks:

package/templates/internal/rules//345/267/245/345/205/267/350/260/203/347/224/250/350/247/204/345/210/231.md

@@ -5,17 +5,10 @@ scope:
 products:
   - '*'
 id: ka-hard-rule-工具调用规则
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-tool-invocation-contract
-routes: ['*']
-primary_triggers:
-  - 工具调用规则
-secondary_triggers: []
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - mc-workflow-contract
 hard_blocks:
@@ -28,8 +21,8 @@ required_evidence:
 version: 1.1.0
 last_reviewed: '2026-06-01'
 type: governance_rule
-when: 工具调用规则
 stages: ["*"]
+triggers: ["工具调用规则"]
 ---
 
 # 工具调用规则

package/templates/internal/rules//346/204/217/345/233/276/350/267/257/347/224/261/350/247/204/345/210/231.md

@@ -1,21 +1,16 @@
 ---
+deprecated: true
+deprecated_note: 此模版已由 mc-command-router (命令路由) 替代。保留仅为向后兼容。
 name: intent-routing
 scope:
   - '*'
 products:
   - '*'
 id: ka-hard-rule-意图路由规则
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
-owner_mechanism_id: mc-intent-router
-routes: ['*']
-primary_triggers:
-  - 意图路由规则
-secondary_triggers: []
-negative_triggers: []
+owner_mechanism_id: mc-command-router
 priority: P0
-specificity: 5
 consumes:
   - mc-classifier
 hard_blocks:
@@ -28,15 +23,15 @@ required_evidence:
 version: 1.1.0
 last_reviewed: '2026-06-01'
 type: governance_rule
-when: 意图路由规则
 stages: ["*"]
+triggers: ["意图路由规则"]
 ---
 
 # 意图路由规则
 
 ## 核心原则
 
-意图路由是 SoloForge 的入口裁决机制。所有用户意图必须先经过 intent_router 裁决，再进入后续流程。
+意图路由是 SoloForge 的入口裁决机制。所有用户意图必须先经过 command_router 裁决，再进入后续流程。
 
 ## 规则
 

package/templates/internal/rules//346/211/247/350/241/214/345/256/210/345/215/253/350/257/204/344/274/260/350/247/204/345/210/231.md

@@ -5,17 +5,10 @@ scope:
 products:
   - '*'
 id: ka-hard-rule-执行守卫评估规则
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-guard-evaluation
-routes: ['*']
-primary_triggers:
-  - 执行守卫评估规则
-secondary_triggers: []
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - mc-task-context-lifecycle
 hard_blocks:
@@ -28,15 +21,15 @@ required_evidence:
 version: 1.1.0
 last_reviewed: '2026-06-01'
 type: governance_rule
-when: 执行守卫评估规则
 stages: ["*"]
+triggers: ["执行守卫评估规则"]
 ---
 
 # 执行守卫评估规则
 
 ## 核心原则
 
-执行守卫评估是 SoloForge 验证阶段的关键机制。它在 sf_verify 时评估各契约守卫的执行状态，确保验证计划覆盖所有必要的检查。
+执行守卫评估是 SoloForge 验证阶段的关键机制。它在 sf_gate_check 时评估各契约守卫的执行状态，确保验证计划覆盖所有必要的检查。
 
 ## 规则
 
@@ -48,11 +41,11 @@ stages: ["*"]
 ## 失败模式
 
 - 验证计划缺少隐私守卫 → 应在 generateVerifyCommands 中补充
-- 守卫评估结果被忽略 → 应传导到 sf_learn 状态判定
+- 守卫评估结果被忽略 → 应传导到 sf_stage_advance 状态判定
 - 守卫降级未通知用户 → 应通过 user_feedback 通知
 
 ## 验收标准
 
 - [ ] generateVerifyCommands 包含隐私和命令守卫评估
 - [ ] 守卫评估失败时 core_principles.overall_passed 为 false
-- [ ] sf_learn 正确处理守卫评估失败的状态转移
+- [ ] sf_stage_advance 正确处理守卫评估失败的状态转移

package/templates/internal/rules//346/211/251/345/261/225/347/224/237/345/221/275/345/221/250/346/234/237/350/247/204/345/210/231.md

@@ -6,18 +6,10 @@ products:
   - '*'
 id: ka-hard-rule-扩展生命周期规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-extension-contract
-routes: ['*']
-primary_triggers:
-  - 扩展注册
-  - 权限申请
-secondary_triggers: []
-negative_triggers: []
 priority: P1
-specificity: 4
 consumes:
   - ka-hard-rule-核心工程执行原则
 hard_blocks:

package/templates/internal/rules//346/212/200/346/234/257/345/206/263/347/255/226/344/270/273/346/235/203/350/247/204/345/210/231.md

@@ -6,7 +6,6 @@ products:
   - '*'
 id: ka-hard-rule-技术决策主权规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-decision-sovereignty
@@ -15,17 +14,7 @@ consumed_by:
   - mc-decision-sovereignty
   - consumable_asset_registry
   - workflow_template
-routes: ['*']
-primary_triggers:
-  - 技术决策主权规则
-secondary_triggers:
-  - 技术选型
-  - 目录确认
-  - 架构不确定项
-  - 风险动作
-negative_triggers: []
 priority: P1
-specificity: 5
 consumes:
   - mc-decision-sovereignty
 hard_blocks: