soloforge 1.2.19 → 1.3.0

package/templates/knowledge/rules//345/221/275/344/273/244/346/211/247/350/241/214/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-command-execution
+routes:
+  - 命令执行规则
+primary_triggers:
+  - 命令执行规则
+secondary_triggers: []
+negative_triggers: []
+priority: P0
+specificity: 5
+consumes:
+  - mc-tool-invocation-contract
+hard_blocks:
+  - destructive命令无确认
+  - 命令越权
+fallback: manual_required
+required_evidence:
+  - command_classification
+  - execution_result
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+type: hard_rule
+when: 命令执行规则
+status: active
+---
+
 # 命令执行规则
 
 ## 核心原则

package/templates/knowledge/rules//345/267/245/344/275/234/346/265/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-workflow-contract
+routes:
+  - 工作流契约规则
+primary_triggers:
+  - 工作流契约规则
+secondary_triggers: []
+negative_triggers: []
+priority: P0
+specificity: 5
+consumes:
+  - mc-intent-router
+hard_blocks:
+  - workflow未注册
+  - mutation不匹配
+fallback: manual_required
+required_evidence:
+  - workflow_id
+  - required_mechanisms
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+type: hard_rule
+when: 工作流契约规则
+status: active
+---
+
 # 工作流契约规则
 
 ## 核心原则

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

@@ -0,0 +1,38 @@
+---
+name: 工作流模板包规则
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-hard-rule-工作流模板包规则
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+owner_mechanism_id: mc-workflow-template-pack
+routes:
+  - code_execution
+  - multi_stage_plan
+primary_triggers:
+  - 模板消费
+  - 工作流模板
+secondary_triggers: []
+negative_triggers: []
+priority: P1
+specificity: 4
+consumes:
+  - ka-hard-rule-核心工程执行原则
+---
+
+# 工作流模板包规则
+
+## 硬规则
+
+1. **模板消费 pipeline 必须完整** — missing → file_created → indexed → registered → injected → consumed → verified
+2. **不可停在中间状态** — 模板消费不可卡在 registered 而不 injected
+3. **消费证据必须记录** — 每次状态推进都需要证据
+
+## 检查项
+
+- [ ] 模板消费 pipeline 完整
+- [ ] 无中间状态停滞
+- [ ] 消费证据已记录

package/templates/knowledge/rules//345/267/245/345/205/267/350/260/203/347/224/250/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-tool-invocation-contract
+routes:
+  - 工具调用规则
+primary_triggers:
+  - 工具调用规则
+secondary_triggers: []
+negative_triggers: []
+priority: P0
+specificity: 5
+consumes:
+  - mc-workflow-contract
+hard_blocks:
+  - forbidden_next_tool
+  - strict_controlled未审批
+fallback: manual_required
+required_evidence:
+  - tool_trace
+  - invocation_violations
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+type: hard_rule
+when: 工具调用规则
+status: active
+---
+
 # 工具调用规则
 
 ## 核心原则

package/templates/knowledge/rules//346/204/217/345/233/276/350/267/257/347/224/261/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-intent-router
+routes:
+  - 意图路由规则
+primary_triggers:
+  - 意图路由规则
+secondary_triggers: []
+negative_triggers: []
+priority: P0
+specificity: 5
+consumes:
+  - mc-classifier
+hard_blocks:
+  - 路由未裁决
+  - degraded未记录
+fallback: manual_required
+required_evidence:
+  - route_decision
+  - execution_shape
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+type: hard_rule
+when: 意图路由规则
+status: active
+---
+
 # 意图路由规则
 
 ## 核心原则

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

@@ -1,3 +1,39 @@
+---
+name: 执行守卫评估规则
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-hard-rule-执行守卫评估规则
+asset_kind: hard_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:
+  - 非法状态转换
+  - failed→done
+fallback: manual_required
+required_evidence:
+  - guard_evaluation
+  - diagnostic_codes
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+type: hard_rule
+when: 执行守卫评估规则
+status: active
+---
+
 # 执行守卫评估规则
 
 ## 核心原则

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

@@ -0,0 +1,38 @@
+---
+name: 扩展生命周期规则
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-hard-rule-扩展生命周期规则
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+owner_mechanism_id: mc-extension-contract
+routes:
+  - code_execution
+  - multi_stage_plan
+primary_triggers:
+  - 扩展注册
+  - 权限申请
+secondary_triggers: []
+negative_triggers: []
+priority: P1
+specificity: 4
+consumes:
+  - ka-hard-rule-核心工程执行原则
+---
+
+# 扩展生命周期规则
+
+## 硬规则
+
+1. **第三方扩展不可自称 enforced** — 只有内置机制可以是 enforced 状态
+2. **高风险权限必须审批** — 文件写入、命令执行等权限需显式授权
+3. **生命周期转移必须合法** — registered → active → disabled → removed，不可跳跃
+
+## 检查项
+
+- [ ] 扩展 manifest 格式正确
+- [ ] 权限声明完整
+- [ ] 生命周期转移合法

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

@@ -0,0 +1,64 @@
+---
+name: 技术决策主权规则
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-hard-rule-技术决策主权规则
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+owner_mechanism_id: mc-decision-sovereignty
+asset_role: required
+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:
+  - 高影响决策无 human gate 自动执行
+  - 推荐状态（recommended）允许直接执行
+  - 不确定项只报告不给推荐和理由
+fallback: manual_required
+required_evidence:
+  - decision_contract
+  - human_confirmation
+version: 1.0.0
+last_reviewed: '2026-05-23'
+---
+
+# 技术决策主权规则
+
+## hard_rules
+
+- 不确定项必须给出推荐（recommendation）、理由（reasoning）、备选（alternatives）、风险（risks），并进入用户确认或计划闭环。
+- 决策状态流：proposed → recommended → confirmed / rejected / deferred。只有 `confirmed` 状态允许执行。
+- 高影响决策（架构变更、数据模型修改、外部依赖引入）必须经过 human gate 确认，不得自动执行。
+- 推荐状态（recommended）不得直接执行，必须转为 confirmed（含人类签署证据）后方可实施。
+- 用户项目中技术选型、目录确认、架构不确定项、风险动作都必须可消费该机制规则。
+
+## not_done_if_missing
+
+- 高风险无 human gate 自动执行 → hard fail。
+- heuristic 单独支撑高影响决策 → hard fail。
+- 不确定项只报告不给推荐和理由 → hard fail。
+- 推荐状态绕过确认直接执行 → hard fail。
+
+## verification_evidence
+
+- `TechnologyDecisionContract` 包含 decision_scope、recommendation、reasoning、alternatives、risks 字段。
+- `validateTechnologyDecision()` 检查 human gate 对高影响决策的必需性。
+- `diagnostic_codes`: no-human-gate, executing-recommended, missing-recommendation。

package/templates/knowledge/rules//346/225/217/346/204/237/344/277/241/346/201/257/345/244/204/347/220/206/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-privacy-boundary
+routes:
+  - 敏感信息处理规则
+primary_triggers:
+  - 敏感信息处理规则
+secondary_triggers: []
+negative_triggers: []
+priority: P0
+specificity: 5
+consumes:
+  - mc-intent-router
+hard_blocks:
+  - secret泄露
+  - PII未脱敏
+fallback: manual_required
+required_evidence:
+  - redaction_records
+  - privacy_findings
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+type: hard_rule
+when: 敏感信息处理规则
+status: active
+---
+
 # 敏感信息处理规则
 
 ## 核心原则

package/templates/knowledge/rules//346/226/275/345/267/245/346/214/207/344/273/244/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -0,0 +1,49 @@
+---
+id: 施工指令契约规则
+asset_kind: hard_rule
+owner_mechanism_id: mc-instruction-contract
+lifecycle_status: active
+consumption_mode: required
+language_policy: zh_first
+---
+
+# 施工指令契约规则
+
+## 硬规则
+
+### HR-1: 任何实现/编码/写文件前必须有施工指令
+
+AI 在执行任何代码修改、文件创建、重构操作前，必须先确认存在施工指令。
+
+施工指令必须包含以下字段（全部必填，不可为空）：
+
+| 字段 | 说明 | 示例 |
+|------|------|------|
+| 目标 | 本次施工要达成什么 | "为用户登录功能添加 JWT 认证" |
+| 范围 | 涉及哪些文件/模块 | `["src/auth/jwt.ts", "src/middleware/auth.ts"]` |
+| 非目标 | 明确不做什么 | "不改动现有 session 机制" |
+| 落点 | 产出物放在哪里 | "src/auth/jwt.ts" |
+| 验收标准 | 怎样算完成 | "单元测试通过，token 过期能正确拒绝" |
+| 禁止绕过项 | 不可跳过的检查 | "不可跳过测试、不可跳过 review" |
+
+### HR-2: 缺失字段时必须先澄清
+
+如果施工指令缺少任何必填字段，AI 必须：
+1. 向用户指出缺失的字段
+2. 提供推荐值和理由
+3. 等待用户确认后再继续
+
+**禁止**：猜测缺失字段、使用空值或占位符填充、跳过澄清直接编码。
+
+### HR-3: 施工指令不可假通过
+
+以下情况不得判定为通过：
+- 空目标/空范围/空验收标准
+- 非目标写"无"但不提供理由
+- 落点不明确（如"某个目录"）
+- 禁止绕过项列表为空
+
+### HR-4: 用户项目同样适用
+
+通过 sync-templates 注入到用户项目后，本规则在用户项目开发中同样生效。
+用户使用 SoloForge 时，AI 工具在执行写操作前会自动检查施工指令。

package/templates/knowledge/rules//346/240/270/345/277/203/344/275/223/351/252/214/345/216/237/345/210/231.md

@@ -0,0 +1,50 @@
+---
+name: core-experience-principle
+when: '新增机制, 新增模板, 新增 workflow, 发布门禁'
+scope:
+  - governance
+  - experience
+  - delivery
+products:
+  - '*'
+owner_mechanism_id: mc-core-experience-principle
+id: ka-hard-rule-core-experience-principle
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+routes:
+  - all
+primary_triggers:
+  - 机制强
+  - 路径短
+  - 规则硬
+  - 体验轻
+consumes:
+  - mc-plan-proposal-gate
+priority: P0
+specificity: 8
+version: 1.0.0
+last_reviewed: '2026-05-22'
+hard_blocks:
+  - 机制未接主线
+  - 用户路径过长
+  - 假完成
+required_evidence:
+  - CoreExperiencePrincipleEvaluation
+fallback: manual_required
+type: hard_rule
+status: active
+---
+
+## 核心体验原则
+
+### 四条原则
+1. **机制强，路径短** — 机制必须接入真实主链路，用户入口尽量短
+2. **规则硬，体验轻** — 关键失败硬阻断，低风险任务轻量
+3. **证据足，不啰嗦** — 证据可审查，输出清晰简洁
+4. **能自动修复，不假装完成** — 失败进入 repair_reverify 或 manual_required
+
+### 禁止
+- 机制只存在于文档，不接主链路
+- 硬规则降级为 warning 后继续
+- 验证失败后标记 completed/delivered

package/templates/knowledge/rules//346/240/270/345/277/203/345/267/245/347/250/213/346/211/247/350/241/214/345/216/237/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-core-engineering-principles
+routes:
+  - 核心工程执行原则
+primary_triggers:
+  - 核心工程执行原则
+secondary_triggers: []
+negative_triggers: []
+priority: P0
+specificity: 5
+consumes:
+  - mc-all-mechanisms
+hard_blocks:
+  - 中文策略违反
+  - 非必要英文
+fallback: manual_required
+required_evidence:
+  - core_principles_report
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+type: hard_rule
+when: 核心工程执行原则
+status: active
+---
+
 # 核心工程执行原则
 
 > 适用: 所有 code_execution / multi_stage_plan / single_artifact 路由。

package/templates/knowledge/rules//346/263/250/345/206/214/350/241/250/345/237/272/347/241/200/350/256/276/346/226/275/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-registry-infrastructure
+routes:
+  - 注册表基础设施规则
+primary_triggers:
+  - 注册表基础设施规则
+secondary_triggers: []
+negative_triggers: []
+priority: P0
+specificity: 5
+consumes:
+  - mc-all-mechanisms
+hard_blocks:
+  - contract未登记
+  - policy无映射
+fallback: manual_required
+required_evidence:
+  - contract_registry
+  - mechanism_layer_map
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+type: hard_rule
+when: 注册表基础设施规则
+status: active
+---
+
 # 注册表基础设施规则
 
 ## 核心原则

package/templates/knowledge/rules//346/274/224/350/277/233/345/233/236/345/275/222/350/247/204/345/210/231.md

@@ -0,0 +1,51 @@
+---
+name: 演进回归规则
+type: rule
+when: '新增问题, 演进门控, 回归检查, evolution, regression, duplicate'
+scope:
+  - governance
+products:
+  - '*'
+id: ka-hard-rule-演进回归规则
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+owner_mechanism_id: mc-evolution-regression
+routes:
+  - 新增问题
+  - 演进门控
+  - 回归检查
+  - evolution
+  - regression
+primary_triggers:
+  - 新增问题
+  - 演进门控
+  - 回归检查
+  - evolution
+  - regression
+  - duplicate
+secondary_triggers: []
+negative_triggers: []
+priority: P0
+specificity: 5
+consumes:
+  - mc-all-mechanisms
+hard_blocks:
+  - 重复问题
+  - pending通过
+fallback: manual_required
+required_evidence:
+  - evolution_gate_result
+  - regression_check
+version: 1.0.0
+last_reviewed: '2026-05-22'
+migration_note: 知识资产标准化迁移
+status: active
+---
+
+## 演进回归规则
+
+1. 新增问题必须通过演进门控
+2. 重复问题必须被检测
+3. pending 状态不得通过
+4. 演进影响必须评估现有 batch 和模板

package/templates/knowledge/rules//346/274/224/350/277/233/345/233/236/345/275/222/351/227/250/346/216/247/350/247/204/345/210/231.md

@@ -0,0 +1,74 @@
+---
+name: 演进回归门控规则
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-hard-rule-演进回归门控规则
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+owner_mechanism_id: mc-evolution-regression
+asset_role: required
+consumed_by:
+  - mc-evolution-regression
+  - consumable_asset_registry
+  - knowledge_injection
+routes:
+  - 演进回归门控规则
+primary_triggers:
+  - 演进回归门控规则
+secondary_triggers:
+  - 演进回归
+  - evolution regression
+  - 新增问题
+  - 新增 Batch
+  - 模板补齐
+negative_triggers: []
+priority: P2
+specificity: 5
+consumes:
+  - mc-evolution-regression
+hard_blocks:
+  - 重复问题未检测
+  - pending 状态通过
+  - 新 Batch 未继承回归门禁
+  - 模板层需更新但未更新
+fallback: manual_required
+required_evidence:
+  - evolution_gate_result
+  - duplicate_check_result
+  - batch_regression_report
+version: 1.0.0
+last_reviewed: '2026-05-23'
+---
+
+# 演进回归门控规则
+
+## hard_rules
+
+- 新增问题 / 新增 Batch / 新机制 / 新模板 / 新测试必须经过回归门控，不得打穿既有体系。
+- 必须包含以下检查项：
+  1. 跨 Batch 总回归门：新变更不得破坏已验收的 Batch 门禁。
+  2. 模板补齐检查：新机制必须有 required 模板资产。
+  3. 机制归属检查：新模板必须归属到正确机制。
+  4. 发布门禁更新：新问题/Batch 必须更新发布门禁配置。
+  5. 旧问题反向影响检查：新变更不得使已关闭问题重新失效。
+- 重复问题必须被 DuplicateIssueCheck 检测并阻断。
+- pending 状态的问题/机制不得通过门禁。
+
+## not_done_if_missing
+
+- 新问题未经 DuplicateIssueCheck → hard fail。
+- 新 Batch 未继承 Batch1-4 全部回归门禁 → hard fail。
+- 模板层需更新但未更新 → hard fail。
+- 新增机制无 required 模板资产 → hard fail。
+- 发布门禁配置未更新 → hard fail。
+
+## verification_evidence
+
+- `EvolutionGateResult` 包含 passed/failed 状态和检查项列表。
+- `DuplicateCheckResult` 包含重复检测结果。
+- `performEvolutionGate()` 执行全部五项检查。
+- `checkDuplicateIssue()` 检测重复问题。
+- `diagnostic_codes`: duplicate-issue, pending-gate, missing-template, batch-regression-failed。