soloforge 1.2.20 → 1.3.1

package/templates/knowledge/rules//347/254/254/344/270/200/346/200/247/345/216/237/347/220/206/346/216/250/347/220/206/350/247/204/345/210/231.md

@@ -0,0 +1,73 @@
+---
+name: 第一性原理推理规则
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-hard-rule-第一性原理推理规则
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+owner_mechanism_id: mc-first-principles
+asset_role: required
+consumed_by:
+  - mc-first-principles
+  - consumable_asset_registry
+  - knowledge_injection
+routes:
+  - 第一性原理推理规则
+primary_triggers:
+  - 第一性原理推理规则
+secondary_triggers:
+  - first principles
+  - 第一性原理
+  - fundamental need
+  - 推理框架
+negative_triggers: []
+priority: P1
+specificity: 5
+consumes:
+  - mc-first-principles
+hard_blocks:
+  - 缺少 fundamental_need
+  - 高影响变更未推理
+  - 关键词替代语义判断
+  - 模板存在触发自动执行
+fallback: manual_required
+required_evidence:
+  - first_principles_frame
+  - reasoning_chain
+version: 1.0.0
+last_reviewed: '2026-05-23'
+---
+
+# 第一性原理推理规则
+
+## hard_rules
+
+- 高影响变更必须经过第一性原理推理，推理框架必须包含七个要素：
+  1. 原始目标（fundamental_need）：用户真正想要什么
+  2. 不可变事实（immutable_facts）：不能改变的约束和前提
+  3. 可变假设（mutable_assumptions）：可以挑战和修改的假设
+  4. 约束边界（constraint_boundary）：方案的可行范围
+  5. 推导链（reasoning_chain）：从事实到结论的逻辑推导
+  6. 反例检查（counter_example_check）：方案在什么条件下会失效
+  7. 最小充分方案（minimum_sufficient_solution）：满足目标的最小方案
+- 不得用关键词匹配替代语义判断，必须理解问题的本质。
+- 模板存在不得触发自动执行，必须有推理过程支撑。
+- 修复不得只补表面，必须找到根因。
+
+## not_done_if_missing
+
+- 缺少 fundamental_need → hard fail。
+- 高影响变更未推理 → hard fail。
+- 关键词替代语义判断 → hard fail。
+- 模板存在触发自动执行 → hard fail。
+- 修复只补表面 → hard fail。
+
+## verification_evidence
+
+- `FirstPrinciplesFrame` 包含 fundamental_need、immutable_facts、mutable_assumptions、constraint_boundary、reasoning_chain、counter_example_check、minimum_sufficient_solution 七个字段。
+- `performFirstPrinciplesCheck()` 验证框架完整性。
+- `validateFirstPrinciplesForHighImpact()` 对高影响变更强制推理。
+- `diagnostic_codes`: missing-fundamental-need, high-impact-unframed, keyword-substitution, template-auto-execute。

package/templates/knowledge/rules//347/273/206/350/212/202/347/272/252/345/276/213/350/247/204/345/210/231.md

@@ -0,0 +1,67 @@
+---
+name: 细节纪律规则
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-hard-rule-细节纪律规则
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+owner_mechanism_id: mc-detail-discipline
+asset_role: required
+consumed_by:
+  - mc-detail-discipline
+  - consumable_asset_registry
+  - knowledge_injection
+routes:
+  - 细节纪律规则
+primary_triggers:
+  - 细节纪律规则
+secondary_triggers:
+  - 细节检查
+  - detail discipline
+  - 方案细节
+  - 实施细节
+negative_triggers: []
+priority: P1
+specificity: 5
+consumes:
+  - mc-detail-discipline
+hard_blocks:
+  - 缺失关键维度细节
+  - blocking 检查未接入交付 gate
+  - 细节只有口号无可验证字段
+fallback: manual_required
+required_evidence:
+  - detail_check_report
+  - dimension_coverage
+version: 1.0.0
+last_reviewed: '2026-05-23'
+---
+
+# 细节纪律规则
+
+## hard_rules
+
+- 方案细节、实施细节、验收细节、边界例外、反回归检查五个维度必须逐一检查，不得遗漏。
+- 细节必须包含可验证字段或清单（verification checklist），不得只有口号式描述。
+- 阻塞性检查（blocking check）必须接入交付 gate，不得游离在交付流程之外。
+- 设计有方向无边界 → hard fail，必须补齐边界约束。
+- 实施只有快乐路径 → hard fail，必须覆盖失败路径和降级路径。
+- 覆盖/迁移操作无备份回滚 → hard fail。
+
+## not_done_if_missing
+
+- 设计有方向无边界 → hard fail。
+- 实施只有快乐路径 → hard fail。
+- 覆盖/迁移无备份回滚 → hard fail。
+- blocking 检查未接入交付 gate → hard fail。
+- 细节维度缺失（5 个维度任缺 1 个）→ hard fail。
+
+## verification_evidence
+
+- `DetailDisciplineCheck` 包含 dimensions 覆盖报告（方案细节/实施细节/验收细节/边界例外/反回归）。
+- `performDetailCheck()` 返回各维度 pass/fail 状态。
+- `checkDetailGateIntegration()` 验证 blocking 检查已接入交付 gate。
+- `diagnostic_codes`: missing-dimension, gate-not-integrated, no-verification-field。

package/templates/knowledge/rules//350/204/221/346/232/264/344/270/216/346/226/271/346/241/210/346/216/242/347/264/242/350/247/204/345/210/231.md

@@ -0,0 +1,66 @@
+---
+name: 脑暴与方案探索规则
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-hard-rule-脑暴与方案探索规则
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+owner_mechanism_id: mc-brainstorm-contract
+asset_role: required
+consumed_by:
+  - mc-brainstorm-contract
+  - consumable_asset_registry
+  - knowledge_injection
+routes:
+  - 脑暴与方案探索规则
+primary_triggers:
+  - 脑暴与方案探索规则
+secondary_triggers:
+  - brainstorm
+  - 方案探索
+  - 不确定项收敛
+  - option exploration
+negative_triggers: []
+priority: P1
+specificity: 5
+consumes:
+  - mc-brainstorm-contract
+hard_blocks:
+  - 脑暴无候选方案
+  - 脑暴绕过决策主权
+  - 不确定项只报告不收敛
+fallback: manual_required
+required_evidence:
+  - brainstorm_session
+  - option_count
+  - convergence_decision
+version: 1.0.0
+last_reviewed: '2026-05-23'
+---
+
+# 脑暴与方案探索规则
+
+## hard_rules
+
+- 不确定项不能只报告，必须给出至少 2 个候选方案并附推荐理由后进入用户确认闭环。
+- 脑暴阶段必须区分四种状态：brainstorm（探索中）→ proposal（有候选）→ decision（选定方案）→ confirmed_decision（用户确认）。
+- 高影响变更不得只有单一无解释路径，必须经过多选项探索。
+- 脑暴推荐不得绕过决策主权机制（mc-decision-sovereignty），推荐结果必须进入 decision 状态确认。
+- 脑暴阶段不得自动执行任何方案，必须等 confirmed_decision 状态。
+
+## not_done_if_missing
+
+- 高影响变更只有单一无解释路径 → hard fail。
+- 脑暴无候选方案直接跳过 → hard fail。
+- 脑暴推荐绕过人工门禁 → hard fail。
+- 不确定项只报告不收敛 → hard fail。
+
+## verification_evidence
+
+- `BrainstormSession` 包含 options 数组（至少 2 项）、recommendation、reasoning 字段。
+- `validateBrainstormSession()` 检查候选数量和收敛状态。
+- `canBrainstormAutoExecute()` 始终返回 false（脑暴不可自动执行）。
+- `diagnostic_codes`: empty-session, auto-execute-blocked, single-option-no-explanation。

package/templates/knowledge/rules//350/256/241/345/210/222/345/211/215/347/275/256/351/227/250/350/247/204/345/210/231.md

@@ -0,0 +1,59 @@
+---
+name: plan-proposal-first-gate
+when: '代码修改, 文件编辑, 架构设计, 迁移, 删除, 高风险操作, code_change, file_edit, migration, delete'
+scope:
+  - governance
+  - execution
+  - planning
+products:
+  - '*'
+owner_mechanism_id: mc-plan-proposal-gate
+id: ka-hard-rule-plan-proposal-gate
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+routes:
+  - code_change
+  - operation
+  - analysis
+  - review
+primary_triggers:
+  - 修改代码
+  - 写文件
+  - 构建
+  - Docker
+  - 迁移
+  - 发布
+  - 删除
+consumes:
+  - mc-intent-router
+  - mc-task-context-lifecycle
+priority: P0
+specificity: 9
+version: 1.0.0
+last_reviewed: '2026-05-22'
+hard_blocks:
+  - 缺计划写入
+  - 高风险无确认
+required_evidence:
+  - plan_proposal_evidence
+fallback: manual_required
+type: hard_rule
+status: active
+---
+
+## 计划前置门规则
+
+### 核心原则
+先说明计划，再执行动作。任务越复杂、风险越高，计划越完整。
+
+### 执行前必须
+1. 给出与任务风险匹配的计划或方案
+2. 高风险动作必须用户确认
+3. 计划必须记录验证方式和风险
+
+### 禁止
+- 无计划直接写文件、改代码、构建、Docker、迁移、发布
+- none_with_reason 用于写入或高风险任务
+- 执行动作超出已确认计划 scope
+- review 上下文擅自修复

package/templates/knowledge/rules//350/256/276/350/256/241/344/272/247/347/211/251/345/214/205/350/247/204/345/210/231.md

@@ -0,0 +1,55 @@
+---
+name: 设计产物包规则
+id: ka-rule-design-artifact-pack
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+scope:
+  - all
+products:
+  - '*'
+routes:
+  - artifact_generation
+  - code_change
+primary_triggers:
+  - 架构设计文档
+  - 数据库设计文档
+  - API接口规格文档
+priority: P0
+specificity: 5
+version: 1.0.0
+last_reviewed: '2026-05-25'
+owner_mechanism_id: mc-design-artifact-pack
+hard_blocks:
+  - 未经复验的设计文档支撑编码或交付
+  - API 缺字段级契约
+  - 数据库 SQL 不可执行
+  - 跨设计产物关键冲突
+required_evidence:
+  - design_artifact_pack
+  - consistency_verification
+consumes:
+  - architecture_decision_workshop
+  - docs/architecture/00-架构决策记录.md
+  - docs/architecture/01-架构设计文档.md
+fallback: manual_required
+type: rule
+status: active
+---
+
+# 设计产物包规则
+
+## 权威资产
+
+- 决策和确认以 `00-架构决策记录.md` 为准。
+- 总体架构以 `01-架构设计文档.md` 为准。
+- 数据库物理结构以真实 SQL/migration 为准，`02-数据库设计文档.md` 解释和追踪。
+- API 路径和字段 schema 以 `docs/api/openapi.yaml` 为准，`03-API接口规格文档.md` 补充业务语义。
+- `99-设计一致性验收报告.md` 只记录真实验证结果。
+
+## 硬底线
+
+- 每个 endpoint 必须具备请求和响应字段级说明，JSON 示例不能替代字段表。
+- SQL、OpenAPI、架构、数据库和 API 文档出现关键漂移时必须阻断。
+- 旧文档在新标准下必须先审计；未经确认和复验不得继续作为编码依据。
+- 升级必须默认 dry-run，确认写入时归档原文件和 hash。

package/templates/knowledge/rules//350/257/201/346/215/256/351/251/261/345/212/250/344/270/216/345/217/215/345/271/273/350/247/211/350/247/204/345/210/231.md

@@ -0,0 +1,75 @@
+---
+name: 证据驱动与反幻觉规则
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-hard-rule-证据驱动与反幻觉规则
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+owner_mechanism_id: mc-evidence-grounding
+routes:
+  - code_execution
+  - multi_stage_plan
+primary_triggers:
+  - 事实声称
+  - 项目事实
+  - 验证结果
+  - 发布结论
+secondary_triggers:
+  - 知识注入
+  - 方案生成
+negative_triggers: []
+priority: P0
+specificity: 5
+consumes:
+  - ka-hard-rule-核心工程执行原则
+  - ka-hard-rule-施工指令契约规则
+hard_blocks:
+  - 无证据声称项目事实
+  - 把推测当事实
+  - 把验证计划当验证结果
+  - generated_inference 单独支撑事实
+  - forbidden evidence 被注入
+  - tests/scenario/gate 自证
+fallback: manual_required
+required_evidence:
+  - evidence_matrix
+  - fact_claim_verification
+  - unsupported_claim_gate_result
+version: 1.0.0
+last_reviewed: '2026-05-24'
+---
+
+# 证据驱动与反幻觉规则
+
+## 硬规则
+
+1. **没证据，不得当事实** — 任何项目事实、技术栈、测试、发布状态的声明必须有可追溯证据
+2. **没检索，不得做高风险判断** — 架构、编码、发布、迁移任务必须先检索项目证据
+3. **有冲突，不得直接拍板** — 证据冲突时必须列出冲突、给出推荐、请求用户确认
+4. **有不确定，必须说清** — 不确定项必须明确标注并给出推荐方案
+5. **验证计划不是验证结果** — `validation_plan` 不得冒充 `validation_result`
+6. **模型推理不是事实证据** — `generated_inference` 不得单独支撑项目事实结论
+7. **测试/gate/scenario 不是主链路落地** — 只被测试文件调用不是真实消费证据
+8. **禁止源永远不得注入** — `forbidden` 权限的证据不得出现在 prompt 或 citation 中
+9. **过期证据不得用于高风险** — `stale` / `deprecated` 证据不得作为高风险任务唯一依据
+10. **失败必须修复复验** — 证据不足时不得假完成，必须修复并复验
+
+## 风险分级
+
+- **critical**: 发布门禁、生产环境、安全相关 → 任何证据缺失必须阻断
+- **high**: 架构、编码、迁移、验证 → 事实声明必须有权威证据
+- **medium**: 普通功能开发 → 关键声明需要证据
+- **low**: 通用问答、低风险操作 → 可标注为通用建议
+
+## 检查项
+
+- [ ] 关键事实声明有 evidence_refs
+- [ ] 无证据的声明已标注不确定
+- [ ] 冲突证据已列出并裁决
+- [ ] forbidden 证据未被注入
+- [ ] 高风险声明未用 stale/deprecated 证据
+- [ ] 验证结论基于真实执行结果
+- [ ] 生成的推理未单独支撑事实

package/templates/knowledge/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

@@ -0,0 +1,48 @@
+---
+name: 跨平台路径安全规则
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-hard-rule-跨平台路径安全规则
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+owner_mechanism_id: mc-platform-compatibility
+routes:
+  - code_execution
+  - multi_stage_plan
+primary_triggers:
+  - 路径操作
+  - 文件引用
+secondary_triggers: []
+negative_triggers: []
+priority: P1
+specificity: 4
+consumes:
+  - ka-hard-rule-核心工程执行原则
+hard_blocks:
+  - 路径逃逸 scope 边界
+  - 符号链接指向 scope 外
+  - 大小写冲突未处理
+fallback: manual_required
+required_evidence:
+  - path_normalization_result
+  - scope_boundary_check
+version: 1.0.0
+last_reviewed: '2026-05-24'
+---
+
+# 跨平台路径安全规则
+
+## 硬规则
+
+1. **路径必须规范化** — 使用 normalizePathRef 消除平台差异
+2. **路径逃逸必须检测** — 符号链接、../ 等不可逃出 scope 边界
+3. **大小写冲突必须处理** — macOS 不敏感文件系统需特殊处理
+
+## 检查项
+
+- [ ] 路径经过规范化处理
+- [ ] scope 边界未突破
+- [ ] 符号链接指向合法

package/templates/knowledge/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

@@ -1,3 +1,39 @@
+---
+name: 输入材料契约规则
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-hard-rule-输入材料契约规则
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+owner_mechanism_id: mc-input-material-contract
+routes:
+  - 输入材料契约规则
+primary_triggers:
+  - 输入材料契约规则
+secondary_triggers: []
+negative_triggers: []
+priority: P0
+specificity: 5
+consumes:
+  - mc-intent-router
+hard_blocks:
+  - 材料禁止路径
+  - 材料未确认
+fallback: manual_required
+required_evidence:
+  - ingestion_evidences
+  - input_materials
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+type: hard_rule
+when: 输入材料契约规则
+status: active
+---
+
 # 输入材料契约规则
 
 ## 核心约束

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

@@ -1,3 +1,38 @@
+---
+name: 配置优先级规则
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-hard-rule-配置优先级规则
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+owner_mechanism_id: mc-config-precedence
+routes:
+  - 配置优先级规则
+primary_triggers:
+  - 配置优先级规则
+secondary_triggers: []
+negative_triggers: []
+priority: P0
+specificity: 5
+consumes:
+  - mc-zero-config-init
+hard_blocks:
+  - 配置冲突未裁决
+  - 优先级颠倒
+fallback: manual_required
+required_evidence:
+  - config_resolution_report
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+type: hard_rule
+when: 配置优先级规则
+status: active
+---
+
 # 配置优先级规则
 
 ## 核心约束

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

@@ -1,3 +1,39 @@
+---
+name: 防孤岛实现规则
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-hard-rule-防孤岛实现规则
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+owner_mechanism_id: mc-main-path-integration
+routes:
+  - 防孤岛实现规则
+primary_triggers:
+  - 防孤岛实现规则
+secondary_triggers: []
+negative_triggers: []
+priority: P0
+specificity: 5
+consumes:
+  - mc-workflow-contract
+hard_blocks:
+  - 模块无entry_trace
+  - orphan_module
+fallback: manual_required
+required_evidence:
+  - main_path_integration
+  - orphan_scan
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+type: hard_rule
+when: 防孤岛实现规则
+status: active
+---
+
 # 防孤岛实现规则
 
 ## 核心原则

package/templates/knowledge/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,3 +1,39 @@
+---
+name: 零配置初始化规则
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-hard-rule-零配置初始化规则
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+owner_mechanism_id: mc-zero-config-init
+routes:
+  - 零配置初始化规则
+primary_triggers:
+  - 零配置初始化规则
+secondary_triggers: []
+negative_triggers: []
+priority: P0
+specificity: 5
+consumes:
+  - mc-intent-router
+hard_blocks:
+  - 配置推断错误
+  - fingerprint不匹配
+fallback: manual_required
+required_evidence:
+  - config_draft
+  - fingerprint_evidence
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+type: hard_rule
+when: 零配置初始化规则
+status: active
+---
+
 # 零配置初始化规则
 
 ## 核心约束

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

@@ -1,3 +1,39 @@
+---
+name: 验证契约规则
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-hard-rule-验证契约规则
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+owner_mechanism_id: mc-verifier
+routes:
+  - 验证契约规则
+primary_triggers:
+  - 验证契约规则
+secondary_triggers: []
+negative_triggers: []
+priority: P0
+specificity: 5
+consumes:
+  - mc-task-context-lifecycle
+hard_blocks:
+  - 验证未通过
+  - 证据缺失
+fallback: manual_required
+required_evidence:
+  - verification_evidence
+  - test_results
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+type: hard_rule
+when: 验证契约规则
+status: active
+---
+
 # 验证契约规则
 
 ## 核心原则

package/templates/knowledge/templates//345/256/241/346/237/245/346/221/230/350/246/201.md

@@ -1,14 +1,33 @@
 ---
 name: 审查摘要
+when: '代码审查, 审查汇报, 信任分级, 抽检, 审查结果'
+scope:
+  - shared
+products:
+  - '*'
+id: ka-artifact_template-审查摘要
+asset_kind: artifact_template
+lifecycle_status: active
+authority: supporting
+routes:
+  - '*'
+primary_triggers:
+  - 代码审查
+  - 审查汇报
+  - 信任分级
+  - 抽检
+  - 审查结果
+priority: P2
+specificity: 3
+version: 1.0.0
+last_reviewed: '2026-05-22'
+consumes: []
+emits:
+  - acceptance_report
+secondary_triggers: []
+negative_triggers: []
 type: acceptance_template
-when: "代码审查, 审查汇报, 信任分级, 抽检, 审查结果"
-scope: [shared]
-products: ["*"]
 status: active
-confidence: 1.0
-created_at: 2026-05-17
-updated_at: 2026-05-17
-usage_count: 0
 ---
 
 ## 摘要格式规范