soloforge 1.1.33 → 1.1.34

package/templates/internal/patterns/LLM/351/242/204/347/256/227/347/275/221/345/205/263.md

@@ -1,8 +1,7 @@
 ---
 name: llm_gateway
 when: 'Token 预算, LLM 调用, 成本控制, 降级'
-scope:
-  - shared
+scope: ['*']
 products:
   - '*'
 id: ka-pattern-llm_gateway
@@ -18,14 +17,15 @@ primary_triggers:
   - 降级
 priority: P2
 specificity: 3
-version: 1.0.0
-last_reviewed: '2026-05-22'
+version: 1.1.0
+last_reviewed: '2026-06-01'
 consumes: []
 emits: []
 secondary_triggers: []
 negative_triggers: []
 type: pattern
-status: active
+stages: ["*"]
+owner_mechanism_id: mc-engine-runtime
 ---
 
 ## 决策规则

package/templates/internal/patterns//344/272/247/347/211/251Schema/346/263/250/345/206/214/344/270/255/345/277/203.md

@@ -0,0 +1,61 @@
+---
+name: product-schema-registry
+type: pattern
+when: 'artifact_schema, 产物结构, Schema注册, artifact_contract'
+scope: ['*']
+products:
+  - '*'
+id: cap-kdoc-artifact-schema-registry
+asset_kind: pattern
+lifecycle_status: active
+authority: supporting
+routes:
+  - '*'
+priority: P1
+specificity: 2
+version: 1.1.0
+last_reviewed: '2026-06-01'
+consumes: []
+emits: []
+secondary_triggers: []
+negative_triggers: []
+stages: ["*"]
+owner_mechanism_id: mc-engine-runtime
+---
+
+# 产物 Schema 注册中心
+
+## 概述
+
+产物 Schema 注册中心集中管理所有 19 种 ArtifactKind 的结构定义。
+每种产物类型定义了必填章节、必填表格、必填字段、必填附属产物和禁止空白。
+
+## 何时使用
+
+- 当 AI 需要生成或修改已知类型的产物文档时，从注册中心获取结构约束
+- 当 check_write/check_bash 的 L4 校验需要校验产物结构完整性时
+- 当知识注入边界的 Schema 独立通道需要格式化结构文本时
+
+## 是否 hard block
+
+enforced — 产物 Schema 是三分离架构的核心组件。
+缺失 Schema 时 AI 输出无结构约束，产物质量不可控。
+但 Schema 本身不 hard block 管线执行，而是以 warning/blocked 形式在 L4 层告警。
+
+## 证据要求
+
+- 19 种 ArtifactKind 全量注册测试通过
+- P0 类型（prototype_spec, design_doc, api_spec, verification_report）章节覆盖完整
+- Schema 文本能通过 formatSchemaForPrompt 正确格式化
+
+## 人工确认/降级边界
+
+- Schema 注册中心异常时降级为无结构约束模式（degraded）
+- 新增产物类型需人工确认 Schema 定义后再注册
+- 模版 frontmatter 中的 Schema 可覆盖注册中心硬编码值，但需 review
+
+## 使用方式
+
+- `getArtifactSchema(kind)` — 查询指定产物类型的 Schema
+- `hasArtifactSchema(kind)` — 检查是否已注册
+- `formatSchemaForPrompt(schema)` — 格式化为 prompt 注入文本

package/templates/internal/patterns//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.md

@@ -1,8 +1,7 @@
 ---
 name: task_context_lifecycle
 when: '任务创建, 状态转移, 生命周期, 任务管理'
-scope:
-  - shared
+scope: ['*']
 products:
   - '*'
 id: ka-pattern-task_context_lifecycle
@@ -18,14 +17,15 @@ primary_triggers:
   - 任务管理
 priority: P2
 specificity: 3
-version: 1.0.0
-last_reviewed: '2026-05-22'
+version: 1.1.0
+last_reviewed: '2026-06-01'
 consumes: []
 emits: []
 secondary_triggers: []
 negative_triggers: []
 type: pattern
-status: active
+stages: ["*"]
+owner_mechanism_id: mc-engine-runtime
 ---
 
 ## 决策规则

package/templates/internal/patterns//344/273/273/345/212/241/347/256/241/347/220/206/345/231/250.md

@@ -1,8 +1,7 @@
 ---
 name: job_manager
 when: '任务管理, checkpoint, heartbeat, 恢复, 认知锚点'
-scope:
-  - shared
+scope: ['*']
 products:
   - '*'
 id: ka-pattern-job_manager
@@ -19,14 +18,15 @@ primary_triggers:
   - 认知锚点
 priority: P2
 specificity: 3
-version: 1.0.0
-last_reviewed: '2026-05-22'
+version: 1.1.0
+last_reviewed: '2026-06-01'
 consumes: []
 emits: []
 secondary_triggers: []
 negative_triggers: []
 type: pattern
-status: active
+stages: ["*"]
+owner_mechanism_id: mc-engine-runtime
 ---
 
 ## 决策规则

package/templates/internal/patterns//344/275/234/347/224/250/345/237/237/344/270/216/345/257/206/351/222/245/346/213/246/346/210/252.md

@@ -1,8 +1,7 @@
 ---
 name: scope_hook
 when: '文件范围, 路径校验, 越权检测, symlink 解析'
-scope:
-  - shared
+scope: ['*']
 products:
   - '*'
 id: ka-pattern-scope_hook
@@ -18,14 +17,15 @@ primary_triggers:
   - symlink 解析
 priority: P2
 specificity: 3
-version: 1.0.0
-last_reviewed: '2026-05-22'
+version: 1.1.0
+last_reviewed: '2026-06-01'
 consumes: []
 emits: []
 secondary_triggers: []
 negative_triggers: []
 type: pattern
-status: active
+stages: ["*"]
+owner_mechanism_id: mc-engine-runtime
 ---
 
 ## 决策规则

package/templates/internal/patterns//344/275/234/347/224/250/345/237/237/347/247/237/347/272/246.md

@@ -1,8 +1,7 @@
 ---
 name: scope_lease
 when: '文件写入, 作用域控制, 租约, 并发写入, 文件锁定'
-scope:
-  - shared
+scope: ['*']
 products:
   - '*'
 id: ka-pattern-scope_lease
@@ -19,14 +18,15 @@ primary_triggers:
   - 文件锁定
 priority: P2
 specificity: 3
-version: 1.0.0
-last_reviewed: '2026-05-22'
+version: 1.1.0
+last_reviewed: '2026-06-01'
 consumes: []
 emits: []
 secondary_triggers: []
 negative_triggers: []
 type: pattern
-status: active
+stages: ["*"]
+owner_mechanism_id: mc-engine-runtime
 ---
 
 ## 决策规则

package/templates/internal/patterns//345/206/262/347/252/201/351/227/250/347/246/201.md

@@ -1,8 +1,7 @@
 ---
 name: conflict_gate
 when: '写入前检查, 冲突检测, CAS 校验, 文件冲突'
-scope:
-  - shared
+scope: ['*']
 products:
   - '*'
 id: ka-pattern-conflict_gate
@@ -18,14 +17,15 @@ primary_triggers:
   - 文件冲突
 priority: P2
 specificity: 3
-version: 1.0.0
-last_reviewed: '2026-05-22'
+version: 1.1.0
+last_reviewed: '2026-06-01'
 consumes: []
 emits: []
 secondary_triggers: []
 negative_triggers: []
 type: pattern
-status: active
+stages: ["*"]
+owner_mechanism_id: mc-engine-runtime
 ---
 
 ## 决策规则

package/templates/internal/patterns//345/206/263/347/255/226/347/275/221/345/205/263.md

@@ -1,8 +1,7 @@
 ---
 name: decision_gateway
 when: '代码执行, 代码生成, 自动执行, 自动生成, LLM 预算, Token 控制'
-scope:
-  - shared
+scope: ['*']
 products:
   - '*'
 id: ka-pattern-decision_gateway
@@ -20,14 +19,15 @@ primary_triggers:
   - Token 控制
 priority: P2
 specificity: 3
-version: 1.0.0
-last_reviewed: '2026-05-22'
+version: 1.1.0
+last_reviewed: '2026-06-01'
 consumes: []
 emits: []
 secondary_triggers: []
 negative_triggers: []
 type: pattern
-status: active
+stages: ["*"]
+owner_mechanism_id: mc-engine-runtime
 ---
 
 ## 决策规则

package/templates/internal/patterns//345/210/206/345/234/272/346/231/257/350/277/207/347/250/213/350/247/204/345/210/231.md

@@ -0,0 +1,61 @@
+---
+name: scenario-process-rules
+type: pattern
+when: 'process_rules, 操作规则, extract, review, fix, iterate'
+scope: ['*']
+products:
+  - '*'
+id: cap-kdoc-artifact-process-rules
+asset_kind: pattern
+lifecycle_status: active
+authority: supporting
+routes:
+  - '*'
+priority: P1
+specificity: 2
+version: 1.1.0
+last_reviewed: '2026-06-01'
+consumes: []
+emits: []
+secondary_triggers: []
+negative_triggers: []
+stages: ["*"]
+owner_mechanism_id: mc-engine-runtime
+---
+
+# 分场景过程规则
+
+## 概述
+
+为每种产物类型定义按操作类型区分的执行规则。
+四种操作类型：extract（提取）、review（审查）、fix（修复）、iterate（迭代）。
+
+## 何时使用
+
+- 当 AI 执行产物相关操作时，根据 OperationType 选择对应规则注入 prompt
+- 当知识注入边界的 Schema 独立通道需要过程规则文本时
+- 当审查/修复操作需要场景化约束时
+
+## 是否 hard block
+
+enforced — 过程规则按操作类型选择注入内容，是 Schema 独立注入通道的必要组件。
+缺少过程规则时 AI 不知道在当前操作类型下应遵循什么约束。
+但不 hard block 管线执行，而是以 advisory 形式在 prompt 中提供指导。
+
+## 证据要求
+
+- P0 类型（prototype_spec, design_doc, api_spec, verification_report）有自定义规则
+- 通用规则 fallback 适用于所有其他产物类型
+- 不同操作类型返回不同的规则文本
+
+## 人工确认/降级边界
+
+- 通用规则适用于所有未定义自定义规则的产物类型（降级）
+- 新增产物类型需人工确认是否需要自定义规则
+- 规则文本过长时可裁剪，不影响管线执行
+
+## 使用方式
+
+- `getProcessRules(kind)` — 获取完整规则集
+- `getOperationRules(kind, opType)` — 获取指定操作类型的规则
+- `formatProcessRulesForPrompt(ruleSet, opType)` — 格式化为 prompt 注入文本

package/templates/internal/patterns//345/217/230/345/274/202/345/256/241/350/256/241.md

@@ -1,8 +1,7 @@
 ---
 name: mutation_audit
 when: '测试质量, 变异测试, 测试审计, 测试造假检测, 覆盖率'
-scope:
-  - shared
+scope: ['*']
 products:
   - '*'
 id: ka-pattern-mutation_audit
@@ -19,14 +18,15 @@ primary_triggers:
   - 覆盖率
 priority: P2
 specificity: 3
-version: 1.0.0
-last_reviewed: '2026-05-22'
+version: 1.1.0
+last_reviewed: '2026-06-01'
 consumes: []
 emits: []
 secondary_triggers: []
 negative_triggers: []
 type: pattern
-status: active
+stages: ["*"]
+owner_mechanism_id: mc-engine-runtime
 ---
 
 ## 决策规则

package/templates/internal/patterns//345/233/236/345/275/222/347/237/251/351/230/265.md

@@ -1,8 +1,7 @@
 ---
 name: regression_matrix
 when: '回归测试, fixture 项目, 兼容性验证, 复杂度预算'
-scope:
-  - shared
+scope: ['*']
 products:
   - '*'
 id: ka-pattern-regression_matrix
@@ -18,19 +17,20 @@ primary_triggers:
   - 复杂度预算
 priority: P2
 specificity: 3
-version: 1.0.0
-last_reviewed: '2026-05-22'
+version: 1.1.0
+last_reviewed: '2026-06-01'
 consumes: []
 emits: []
 secondary_triggers: []
 negative_triggers: []
 type: pattern
-status: active
+stages: ["*"]
+owner_mechanism_id: mc-engine-runtime
 ---
 
 ## 决策规则
 
-- fixture 项目模板: Spring Boot、React、Go 的标准结构
+- fixture 项目模版: Spring Boot、React、Go 的标准结构
 - 回归矩阵对 fixture 验证 classify/expand/verify 兼容性
 - 复杂度预算: 每个能力模块有代码行数预算，超出产生 advisory
 - fixture 使用真实 detectFingerprint 进行项目检测

package/templates/internal/patterns//345/267/245/344/275/234/345/214/272/344/272/222/346/226/245/351/224/201.md

@@ -1,8 +1,7 @@
 ---
 name: io_lock
 when: '互斥锁, 工作区, 并发控制, 写入冲突'
-scope:
-  - shared
+scope: ['*']
 products:
   - '*'
 id: ka-pattern-io_lock
@@ -18,14 +17,15 @@ primary_triggers:
   - 写入冲突
 priority: P2
 specificity: 3
-version: 1.0.0
-last_reviewed: '2026-05-22'
+version: 1.1.0
+last_reviewed: '2026-06-01'
 consumes: []
 emits: []
 secondary_triggers: []
 negative_triggers: []
 type: pattern
-status: active
+stages: ["*"]
+owner_mechanism_id: mc-engine-runtime
 ---
 
 ## 决策规则

package/templates/internal/patterns//345/267/245/344/275/234/345/214/272/345/224/244/351/206/222.md

@@ -1,8 +1,7 @@
 ---
 name: resume_workspace
 when: '会话恢复, 工作区状态, 中断恢复, state 目录'
-scope:
-  - shared
+scope: ['*']
 products:
   - '*'
 id: ka-pattern-resume_workspace
@@ -18,14 +17,15 @@ primary_triggers:
   - state 目录
 priority: P2
 specificity: 3
-version: 1.0.0
-last_reviewed: '2026-05-22'
+version: 1.1.0
+last_reviewed: '2026-06-01'
 consumes: []
 emits: []
 secondary_triggers: []
 negative_triggers: []
 type: pattern
-status: active
+stages: ["*"]
+owner_mechanism_id: mc-engine-runtime
 ---
 
 ## 决策规则

package/templates/internal/patterns//345/271/266/345/217/221/351/224/201.md

@@ -1,8 +1,7 @@
 ---
 name: concurrency_lock
 when: '文件写入, 代码修改, 重构, 全量重构, 大规模验证, 批量操作'
-scope:
-  - shared
+scope: ['*']
 products:
   - '*'
 id: ka-pattern-concurrency_lock
@@ -20,14 +19,15 @@ primary_triggers:
   - 批量操作
 priority: P2
 specificity: 3
-version: 1.0.0
-last_reviewed: '2026-05-22'
+version: 1.1.0
+last_reviewed: '2026-06-01'
 consumes: []
 emits: []
 secondary_triggers: []
 negative_triggers: []
 type: pattern
-status: active
+stages: ["*"]
+owner_mechanism_id: mc-engine-runtime
 ---
 
 ## 决策规则

package/templates/internal/patterns//345/274/200/345/217/221/350/200/205/345/256/252/346/263/225.md

@@ -1,8 +1,7 @@
 ---
 name: developer_constitution
 when: '代码交付, 交付, PR, 提交, 合并, 审查确认'
-scope:
-  - shared
+scope: ['*']
 products:
   - '*'
 id: ka-pattern-developer_constitution
@@ -20,14 +19,15 @@ primary_triggers:
   - 审查确认
 priority: P2
 specificity: 3
-version: 1.0.0
-last_reviewed: '2026-05-22'
+version: 1.1.0
+last_reviewed: '2026-06-01'
 consumes: []
 emits: []
 secondary_triggers: []
 negative_triggers: []
 type: pattern
-status: active
+stages: ["*"]
+owner_mechanism_id: mc-engine-runtime
 ---
 
 ## 决策规则

package/templates/internal/patterns//346/225/217/346/204/237/344/277/241/346/201/257/346/211/253/346/217/217.md

@@ -1,8 +1,7 @@
 ---
 name: secret_scan
 when: '密钥检测, 敏感信息, gitleaks, 安全扫描'
-scope:
-  - shared
+scope: ['*']
 products:
   - '*'
 id: ka-pattern-secret_scan
@@ -18,14 +17,15 @@ primary_triggers:
   - 安全扫描
 priority: P2
 specificity: 3
-version: 1.0.0
-last_reviewed: '2026-05-22'
+version: 1.1.0
+last_reviewed: '2026-06-01'
 consumes: []
 emits: []
 secondary_triggers: []
 negative_triggers: []
 type: pattern
-status: active
+stages: ["*"]
+owner_mechanism_id: mc-engine-runtime
 ---
 
 ## 决策规则

package/templates/internal/patterns//346/250/241/347/211/210Frontmatter/350/247/243/346/236/220.md

@@ -0,0 +1,61 @@
+---
+name: template-frontmatter-parser
+type: pattern
+when: 'frontmatter, template_schema_loader, 模版加载, YAML解析'
+scope: ['*']
+products:
+  - '*'
+id: cap-kdoc-template-schema-loader
+asset_kind: pattern
+lifecycle_status: active
+authority: supporting
+routes:
+  - '*'
+priority: P2
+specificity: 2
+version: 1.1.0
+last_reviewed: '2026-06-01'
+consumes: []
+emits: []
+secondary_triggers: []
+negative_triggers: []
+stages: ["*"]
+owner_mechanism_id: mc-engine-runtime
+---
+
+# 模版 Frontmatter 解析加载器
+
+## 概述
+
+从模版文件的 YAML frontmatter 中解析 artifact_schema 和 process_rules 定义。
+支持运行时重载（开发时修改模版立即生效）。
+
+## 何时使用
+
+- 开发时修改模版 frontmatter 中的 Schema/ProcessRules 定义后立即生效
+- 运行时从模版文件动态加载结构约束
+- 当需要覆盖注册中心中的硬编码 Schema 时
+
+## 是否 hard block
+
+advisory — 模版 frontmatter 是开发态便利功能，不 hard block 管线执行。
+无 frontmatter 的模版使用注册中心默认值，不阻断。
+解析失败时 fallback 到注册中心，不阻断流程。
+
+## 证据要求
+
+- 4 个 P0 模版 frontmatter 解析测试通过
+- 批量加载返回正确的模版数量
+- 转换函数能正确生成 registry 兼容的 ArtifactSchema
+
+## 人工确认/降级边界
+
+- 解析失败不阻断，自动 fallback 到注册中心
+- frontmatter 中的 Schema 定义覆盖注册中心硬编码值时需 review
+- 不影响已有模版的无 frontmatter 兼容性
+
+## 使用方式
+
+- `parseTemplateFile(path)` — 完整文件解析
+- `loadTemplateSchemas(dir)` — 批量加载目录下所有模版
+- `toArtifactSchema(parsed)` — 转换为 registry 兼容格式

package/templates/internal/patterns//346/262/273/347/220/206/350/277/220/350/241/214/346/227/266/345/276/252/347/216/257.md

@@ -1,8 +1,7 @@
 ---
 name: governance_runtime_loop
 when: '治理闭环, 抽检, 逃逸报告, 能力状态, 审计'
-scope:
-  - shared
+scope: ['*']
 products:
   - '*'
 id: ka-pattern-governance_runtime_loop
@@ -19,14 +18,15 @@ primary_triggers:
   - 审计
 priority: P2
 specificity: 3
-version: 1.0.0
-last_reviewed: '2026-05-22'
+version: 1.1.0
+last_reviewed: '2026-06-01'
 consumes: []
 emits: []
 secondary_triggers: []
 negative_triggers: []
 type: pattern
-status: active
+stages: ["*"]
+owner_mechanism_id: mc-engine-runtime
 ---
 
 ## 决策规则

package/templates/internal/patterns//346/265/201/345/274/217/345/277/203/350/267/263.md

@@ -1,8 +1,7 @@
 ---
 name: streaming_protocol
 when: '长时间推演, 重型操作, 心跳, 超时, 连接断开'
-scope:
-  - shared
+scope: ['*']
 products:
   - '*'
 id: ka-pattern-streaming_protocol
@@ -19,14 +18,15 @@ primary_triggers:
   - 连接断开
 priority: P2
 specificity: 3
-version: 1.0.0
-last_reviewed: '2026-05-22'
+version: 1.1.0
+last_reviewed: '2026-06-01'
 consumes: []
 emits: []
 secondary_triggers: []
 negative_triggers: []
 type: pattern
-status: active
+stages: ["*"]
+owner_mechanism_id: mc-engine-runtime
 ---
 
 ## 决策规则