soloforge 1.1.38 → 1.1.42

package/templates/internal/rules//350/267/250/345/271/263/345/217/260/350/267/257/345/276/204/345/256/211/345/205/250/350/247/204/345/210/231.md

@@ -6,17 +6,10 @@ products:
   - '*'
 id: ka-hard-rule-跨平台路径安全规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-platform-compatibility
-primary_triggers:
-  - 路径操作
-  - 文件引用
-secondary_triggers: []
-negative_triggers: []
 priority: P1
-specificity: 4
 consumes:
   - ka-hard-rule-核心工程执行原则
 hard_blocks:

package/templates/internal/rules//350/276/223/345/205/245/346/235/220/346/226/231/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -5,16 +5,10 @@ scope:
 products:
   - '*'
 id: ka-hard-rule-输入材料契约规则
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-input-material-contract
-primary_triggers:
-  - 输入材料契约规则
-secondary_triggers: []
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - mc-input-material-contract
 hard_blocks:
@@ -27,8 +21,8 @@ required_evidence:
 version: 1.1.0
 last_reviewed: '2026-06-01'
 type: governance_rule
-when: 输入材料契约规则
 stages: ["*"]
+triggers: ["输入材料契约规则"]
 ---
 
 # 输入材料契约规则

package/templates/internal/rules//351/200/232/347/224/250/345/206/263/347/255/226/347/240/224/350/256/250/350/247/204/345/210/231.md

@@ -6,25 +6,10 @@ products:
   - '*'
 id: ka-hard-rule-通用决策研讨规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-decision-workshop
-primary_triggers:
-  - 决策研讨
-  - 技术选型
-  - 数据迁移
-  - 安全策略
-secondary_triggers:
-  - 架构设计
-  - 部署
-  - 重构
-  - 第三方集成
-negative_triggers:
-  - 简单说明
-  - 低风险改字
 priority: P0
-specificity: 5
 consumes:
   - decision_workshop
   - architecture_decision_workshop

package/templates/internal/rules//351/205/215/347/275/256/344/274/230/345/205/210/347/272/247/350/247/204/345/210/231.md

@@ -5,60 +5,64 @@ scope:
 products:
   - '*'
 id: ka-hard-rule-配置优先级规则
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-config-precedence
-primary_triggers:
-  - 配置优先级规则
-secondary_triggers: []
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
-  - mc-zero-config-init
+  - mc-config-precedence
 hard_blocks:
   - 配置冲突未裁决
   - 优先级颠倒
 fallback: manual_required
-required_evidence:
-  - config_resolution_report
-version: 1.1.0
-last_reviewed: '2026-06-01'
+version: 2.0.0
+last_reviewed: '2026-06-03'
 type: governance_rule
-when: 配置优先级规则
 stages: ["*"]
+triggers: ["配置优先级规则"]
 ---
 
 # 配置优先级规则
 
 ## 核心约束
 
-1. 配置来源优先级（从高到低）:
-   - `user_task` — 任务级用户声明
-   - `cli_flag` — CLI 参数
-   - `mcp_param` — MCP 工具参数
-   - `confirmed_config` — .soloforge/config.yaml（经 config confirm 确认）
-   - `project_policy` — 项目策略
-   - `fingerprint` — 自动检测
-   - `blueprint` — 空项目蓝图
-   - `product_profile` — 产品模版
-   - `knowledge_default` — 知识库默认
-   - `global_default` — 全局默认
-2. 高优先级覆盖低优先级，但低优先级可作为 fallback。
-3. 字段级覆盖：单个字段可独立覆盖，不需要整配置替换。
-4. 覆盖必须产生 `ConfigEvidenceEntry`，记录来源、时间戳、变更详情。
-5. stale 配置（源文件已变更但 evidence 未更新）必须产生 warning。
+1. 配置解析采用三层合并（`resolveConfig`），优先级从高到低：
+   - **探测层**：从项目文件（`package.json`、`pom.xml`、`go.mod` 等）实时推导
+   - **intent 层**：用户在 `.soloforge/intent.yaml` 中显式声明的偏好
+   - **框架约定层**：框架 profile 中的默认值（scope、build_commands 等）
+   - **全局默认层**：`unknown` / 空字符串 / 空数组
+
+2. 可探测字段优先级链（`??` nullish coalescing）：
+   - `tech_stack`：`fingerprint.backend` ?? `intent.tech_stack.backend` ?? `{ lang: "unknown", framework: "unknown" }`
+   - `build_commands`：项目 `scripts` > 框架约定 > `intent.overrides.build_commands` > 空
+   - `scope`：`intent.overrides.scope` > 框架约定 `defaultScope` > `["src/"]`
+
+3. 不可探测字段优先级链：
+   - `product_profile`：`intent.product_profile` ?? `"default"`
+   - `delivery`：`intent.delivery` ?? `{ auto_push: false, auto_pr: false }`
+
+4. 字段缺失 ≠ 空值：intent.yaml 不存在时 `loadIntent` 返回 `{}`，resolver 用 `??` 填充默认值。
+
+5. 探测结果与 intent 声明冲突时，探测胜出。冲突通过 `detectConflicts()` 标记，建议用户移除冗余声明或使用 `overrides` 确认覆盖。
+
+## 阻断行为
+
+- `tech_stack` 全 `unknown` → 阻断（missing: tech_stack）
+- `build_commands` 全空 → 阻断（missing: build_commands）
+- `scope = []` → 不阻断（blacklist mode）
+- `product_profile = "default"` → 不阻断
+- `delivery` 全 `false` → 不阻断
 
 ## 适用场景
 
-- 项目初始化 (`sf_init`)
-- 配置解析 (`cmdConfigResolve`)
-- 配置确认 (`cmdConfigConfirm`)
-- 运行时配置读取
+- 项目初始化（`soloforge init`）
+- 配置查看（`soloforge config show`）
+- 配置写入（`soloforge config set` / `sf_config_update`）
+- 配置检查（`soloforge config check`）
+- 运行时配置读取（`resolveProjectConfig`）
 
 ## 违规处理
 
-- 未注册的配置来源 → hard_fail，阻断使用
-- stale 配置未标记 → advisory，标记需要重新确认
-- 覆盖无 evidence → hard_fail，阻断覆盖
+- intent.yaml 声明与探测结果冲突 → warning，建议移除冗余声明或使用 overrides
+- 可探测字段在 intent.yaml 中直接声明 → 允许（标记为过渡性，脚手架完成后可删除）
+- 写入非法字段（`_` 前缀内部字段）→ hard_fail，阻断写入

package/templates/internal/rules//351/205/215/347/275/256/350/220/275/347/233/230/350/276/271/347/225/214/350/247/204/345/210/231.md

@@ -6,29 +6,19 @@ products:
   - '*'
 id: ka-hard-rule-配置落盘边界规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-config-write-boundary
-primary_triggers:
-  - init
-  - sync-templates
-  - 配置落盘
-secondary_triggers:
-  - config.yaml
-  - .soloforge
-negative_triggers:
-  - 只读验证
 priority: P1
-specificity: 4
 consumes:
   - config_write_boundary
+  - mc-config-resolver
 hard_blocks:
   - runtime_inference_persisted
   - existing_project_write_without_confirm
 fallback: manual_required
 required_evidence:
-  - config_write_decision
+  - config_resolution_report
 version: 1.1.0
 last_reviewed: '2026-06-01'
 stages: ["*"]
@@ -36,11 +26,12 @@ stages: ["*"]
 
 # 配置落盘边界规则
 
-运行时推断、已有项目探测和空项目蓝图必须区分处理。
+运行时推断、已有项目探测和空项目蓝图必须区分处理。配置解析采用三层合并（探测 > intent.yaml > 框架约定 > 默认），只有用户显式声明的不可探测偏好才写入 intent.yaml。
 
 ## 硬规则
 
-- 运行时推断结果不得自动写入项目配置。
+- 运行时推断结果（探测的技术栈、构建命令等）不得自动写入 intent.yaml。
+- intent.yaml 只存储用户通过 `soloforge config set` 或 `sf_config_update` 显式写入的字段。
 - 已有项目写入 `.soloforge/`、`.mcp.json`、`CLAUDE.md` 或 adapter 配置时必须有用户确认。
 - 空项目初始化可以创建 SoloForge 管理文件。
 - 同步模版不得覆盖用户已修改资产。

package/templates/internal/rules//351/230/262/345/255/244/345/262/233/345/256/236/347/216/260/350/247/204/345/210/231.md

@@ -5,16 +5,10 @@ scope:
 products:
   - '*'
 id: ka-hard-rule-防孤岛实现规则
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-main-path-integration
-primary_triggers:
-  - 防孤岛实现规则
-secondary_triggers: []
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - mc-workflow-contract
 hard_blocks:
@@ -27,8 +21,8 @@ required_evidence:
 version: 1.1.0
 last_reviewed: '2026-06-01'
 type: governance_rule
-when: 防孤岛实现规则
 stages: ["*"]
+triggers: ["防孤岛实现规则"]
 ---
 
 # 防孤岛实现规则

package/templates/internal/rules//351/233/266/351/205/215/347/275/256/345/210/235/345/247/213/345/214/226/350/247/204/345/210/231.md

@@ -1,61 +1,58 @@
 ---
-name: zero-config-initialization
+name: project-config-resolution
 scope:
   - '*'
 products:
   - '*'
-id: ka-hard-rule-零配置初始化规则
-asset_kind: governance_rule
+id: ka-hard-rule-项目配置解析规则
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-zero-config-init
-primary_triggers:
-  - 零配置初始化规则
-secondary_triggers: []
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - mc-zero-config-init
 hard_blocks:
   - 配置推断错误
-  - fingerprint不匹配
+  - fingerprint 不匹配
 fallback: manual_required
-required_evidence:
-  - config_draft
-  - fingerprint_evidence
-version: 1.1.0
-last_reviewed: '2026-06-01'
+version: 2.0.0
+last_reviewed: '2026-06-03'
 type: governance_rule
-when: 零配置初始化规则
 stages: ["*"]
+triggers: ["项目配置解析规则"]
 ---
 
-# 零配置初始化规则
+# 项目配置解析规则
 
 ## 核心约束
 
-1. **运行时推断 vs 确认配置 vs 蓝图**: `soloforge init` 必须区分三种配置来源
-   - 运行时推断: 从已有项目结构探测（package.json、tsconfig.json 等）
-   - 确认配置: 用户显式提供的 .soloforge/config.yaml
-   - 空项目蓝图: 全新项目的默认模版
+1. **三层配置解析**: `resolveConfig` 合并三个配置层：
+   - **探测层**（`detectFingerprint`）：从项目文件实时推导技术栈、构建命令、scope
+   - **intent 层**（`loadIntent`）：用户在 `.soloforge/intent.yaml` 中的显式声明
+   - **框架约定层**：框架 profile 提供的默认值
+   - 探测层优先于 intent 层（探测 > intent > 约定 > 默认）
 
-2. **禁止自动落盘**: 推断结果不得自动写入项目配置文件
-   - 必须先展示推断结果，经用户确认后才可落盘
-   - `--dry-run` 模式必须可用
+2. **禁止自动落盘**: `resolveConfig` 的结果不自动写入 intent.yaml
+   - 技术栈、构建命令等可探测字段由项目文件推导，无需存储
+   - 只有用户通过 `sf_config_update` 或 `soloforge config set` 显式写入的字段才存储到 intent.yaml
+   - `--dry-run` 模式始终可用
 
-3. **探测优先级**: 运行时探测按以下顺序匹配
-   - 已有 .soloforge/config.yaml → 使用确认配置
-   - 项目根目录 package.json → 推断 Node.js 项目
-   - 项目根目录 go.mod → 推断 Go 项目
-   - 无匹配 → 使用空项目蓝图
+3. **配置来源**:
+   - 已有 `.soloforge/intent.yaml` → 合并 intent 声明 + 项目文件探测
+   - 仅有 `config.yaml`（旧格式）→ 自动迁移为 intent.yaml（`migrateFromV1`）
+   - 两者都不存在 → 纯探测模式（从项目文件推导全部配置）
 
-4. **配置字段覆盖**: 运行时推断不得覆盖确认配置
-   - 确认配置是事实来源
-   - 推断值仅作为建议展示
+4. **字段缺失语义**: intent.yaml 中缺失的字段 = "未声明"，使用探测或默认值填充
+   - 不缺失 ≠ 空值，`loadIntent` 不存在时返回 `{}`，resolver 用 `??` 处理
+
+5. **配置完整性检查**: `checkConfigReadiness` 阻断场景：
+   - `tech_stack` 全 `unknown` → 阻断
+   - `build_commands` 全空 → 阻断
+   - `scope` / `product_profile` / `delivery` / `repos` → 不阻断
 
 ## 验证要点
 
-- `init` 不创建未确认的配置文件
-- 推断结果与实际项目类型一致
-- 空项目使用默认蓝图而非猜测配置
+- `init` 不创建用户未确认的配置文件
+- 探测结果与实际项目类型一致（内容验证，非文件存在性检查）
+- 空项目使用纯探测模式而非猜测配置
+- 配置冲突（intent 与探测矛盾）通过 `detectConflicts` 正确标记

package/templates/internal/rules//351/252/214/346/224/266/346/250/241/347/211/210/350/276/223/345/207/272/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -6,23 +6,10 @@ products:
   - '*'
 id: ka-hard-rule-验收模版输出契约规则
 type: governance_rule
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-standard-asset-contract
-primary_triggers:
-  - 验收模版
-  - 标准输出
-  - 设计产物
-secondary_triggers:
-  - API接口规格
-  - 数据库设计
-  - 架构设计
-negative_triggers:
-  - 普通解释
-  - 简单 bugfix
 priority: P0
-specificity: 5
 consumes:
   - standard_asset_contract
   - design_artifact_pack

package/templates/internal/rules//351/252/214/350/257/201/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -5,16 +5,10 @@ scope:
 products:
   - '*'
 id: ka-hard-rule-验证契约规则
-asset_kind: governance_rule
 lifecycle_status: active
 authority: canonical
 owner_mechanism_id: mc-verifier
-primary_triggers:
-  - 验证契约规则
-secondary_triggers: []
-negative_triggers: []
 priority: P0
-specificity: 5
 consumes:
   - mc-task-context-lifecycle
 hard_blocks:
@@ -27,8 +21,8 @@ required_evidence:
 version: 1.1.0
 last_reviewed: '2026-06-01'
 type: governance_rule
-when: 验证契约规则
 stages: ["*"]
+triggers: ["验证契约规则"]
 ---
 
 # 验证契约规则

package/templates/patterns/API/350/256/276/350/256/241/350/247/204/350/214/203.md

@@ -1,35 +1,21 @@
 ---
 name: api-design
-when: 'API设计, 接口设计, 新建接口, 接口定义, RESTful, API规范, 接口契约, 请求参数, 响应格式'
 scope:
   - backend
 products:
   - '*'
 id: ka-pattern-api-design
-asset_kind: pattern
 lifecycle_status: active
 owner_mechanism_id: mc-backend-pattern
 authority: supporting
-primary_triggers:
-  - API设计
-  - 接口设计
-  - 新建接口
-  - 接口定义
-  - RESTful
-  - API规范
-  - 接口契约
-  - 请求参数
-  - 响应格式
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits: []
-secondary_triggers: []
-negative_triggers: []
 type: pattern
 stages: ["编码与单元测试", "架构设计"]
+triggers: ["API设计","接口设计","新建接口","接口定义","RESTful","API规范","接口契约","请求参数","响应格式"]
 ---
 
 ## 决策规则

package/templates/patterns/Docker/351/203/250/347/275/262/350/247/204/350/214/203.md

@@ -1,34 +1,22 @@
 ---
 name: docker-deployment
-when: 'Docker部署, 容器部署, Dockerfile, docker-compose, 镜像构建, 容器化, 部署发布'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-pattern-docker-deployment
-asset_kind: pattern
 lifecycle_status: active
 owner_mechanism_id: mc-general-pattern
 authority: supporting
-primary_triggers:
-  - Docker部署
-  - 容器部署
-  - Dockerfile
-  - docker-compose
-  - 镜像构建
-  - 容器化
-  - 部署发布
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits: []
-secondary_triggers: []
-negative_triggers: []
 type: pattern
 stages: ["联调验证"]
+triggers: ["Docker部署","容器部署","Dockerfile","docker-compose","镜像构建","容器化","部署发布"]
 ---
 
 ## 决策规则

package/templates/patterns/Git/346/223/215/344/275/234/350/247/204/350/214/203.md

@@ -1,38 +1,22 @@
 ---
 name: gitops
-when: 'Git操作, 提交, commit, 分支, merge, 回滚, git, 代码提交, 版本控制, 代码合并, 冲突解决'
 scope:
   - backend
   - frontend
 products:
   - '*'
 id: ka-pattern-gitops
-asset_kind: pattern
 lifecycle_status: active
 owner_mechanism_id: mc-general-pattern
 authority: supporting
-primary_triggers:
-  - Git操作
-  - 提交
-  - commit
-  - 分支
-  - merge
-  - 回滚
-  - git
-  - 代码提交
-  - 版本控制
-  - 代码合并
-  - 冲突解决
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits: []
-secondary_triggers: []
-negative_triggers: []
 type: pattern
 stages: ["编码与单元测试", "联调验证"]
+triggers: ["Git操作","提交","commit","分支","merge","回滚","git","代码提交","版本控制","代码合并","冲突解决"]
 ---
 
 ## 决策规则

package/templates/patterns/N/345/212/2401/346/237/245/350/257/242/350/247/204/350/214/203.md

@@ -1,36 +1,21 @@
 ---
 name: n-plus-one-query
-when: 'N+1查询, 慢查询, 性能问题, 批量查询, 循环查询, SQL优化, 查询优化, JOIN, 延迟加载, eager loading'
 scope:
   - backend
 products:
   - '*'
 id: ka-pattern-n-plus-one-query
-asset_kind: pattern
 lifecycle_status: active
 owner_mechanism_id: mc-backend-pattern
 authority: supporting
-primary_triggers:
-  - N+1查询
-  - 慢查询
-  - 性能问题
-  - 批量查询
-  - 循环查询
-  - SQL优化
-  - 查询优化
-  - JOIN
-  - 延迟加载
-  - eager loading
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits: []
-secondary_triggers: []
-negative_triggers: []
 type: pattern
 stages: ["编码与单元测试", "架构设计"]
+triggers: ["N+1查询","慢查询","性能问题","批量查询","循环查询","SQL优化","查询优化","JOIN","延迟加载","eager loading"]
 ---
 
 ## 决策规则

package/templates/patterns/React/345/210/227/350/241/250/350/241/250/346/240/274/350/247/204/350/214/203.md

@@ -1,35 +1,21 @@
 ---
 name: react-list-table
-when: '列表页, 表格, 数据展示, antd Table, 数据列表, 查询列表, 搜索列表, 分页列表, 列表查询'
 scope:
   - frontend
 products:
   - '*'
 id: ka-pattern-react-list-table
-asset_kind: pattern
 lifecycle_status: active
 owner_mechanism_id: mc-frontend-pattern
 authority: supporting
-primary_triggers:
-  - 列表页
-  - 表格
-  - 数据展示
-  - antd Table
-  - 数据列表
-  - 查询列表
-  - 搜索列表
-  - 分页列表
-  - 列表查询
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits: []
-secondary_triggers: []
-negative_triggers: []
 type: pattern
 stages: ["联调验证"]
+triggers: ["列表页","表格","数据展示","antd Table","数据列表","查询列表","搜索列表","分页列表","列表查询"]
 ---
 
 ## 决策规则

package/templates/patterns/React/346/216/245/345/217/243/351/233/206/346/210/220/350/247/204/350/214/203.md

@@ -1,36 +1,21 @@
 ---
 name: react-api-integration
-when: '前端API调用, 接口对接, HTTP请求, axios, fetch, 数据请求, 接口联调, 后端对接, API集成, 请求封装'
 scope:
   - frontend
 products:
   - '*'
 id: ka-pattern-react-api-integration
-asset_kind: pattern
 lifecycle_status: active
 owner_mechanism_id: mc-frontend-pattern
 authority: supporting
-primary_triggers:
-  - 前端API调用
-  - 接口对接
-  - HTTP请求
-  - axios
-  - fetch
-  - 数据请求
-  - 接口联调
-  - 后端对接
-  - API集成
-  - 请求封装
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits: []
-secondary_triggers: []
-negative_triggers: []
 type: pattern
 stages: ["编码与单元测试"]
+triggers: ["前端API调用","接口对接","HTTP请求","axios","fetch","数据请求","接口联调","后端对接","API集成","请求封装"]
 ---
 
 ## 决策规则

package/templates/patterns/React/347/212/266/346/200/201/347/256/241/347/220/206/350/247/204/350/214/203.md

@@ -1,36 +1,21 @@
 ---
 name: react-state-management
-when: '状态管理, 全局状态, useState, useContext, 状态共享, 跨组件通信, 全局数据, store, Context, 状态同步'
 scope:
   - frontend
 products:
   - '*'
 id: ka-pattern-react-state-management
-asset_kind: pattern
 lifecycle_status: active
 owner_mechanism_id: mc-frontend-pattern
 authority: supporting
-primary_triggers:
-  - 状态管理
-  - 全局状态
-  - useState
-  - useContext
-  - 状态共享
-  - 跨组件通信
-  - 全局数据
-  - store
-  - Context
-  - 状态同步
 priority: P2
-specificity: 3
 version: 1.1.0
 last_reviewed: '2026-06-01'
 consumes: []
 emits: []
-secondary_triggers: []
-negative_triggers: []
 type: pattern
 stages: ["联调验证"]
+triggers: ["状态管理","全局状态","useState","useContext","状态共享","跨组件通信","全局数据","store","Context","状态同步"]
 ---
 
 ## 决策规则