soloforge 1.1.40 → 1.1.43

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

@@ -1,53 +0,0 @@
----
-name: conflict_gate
-scope: ['*']
-products:
-  - '*'
-id: ka-pattern-conflict_gate
-lifecycle_status: active
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["*"]
-owner_mechanism_id: mc-engine-runtime
-triggers: ["写入前检查","冲突检测","CAS 校验","文件冲突"]
----
-
-## 决策规则
-
-- 写入前执行 CAS（Compare-And-Swap）校验：比较文件当前 hash 与预期 hash
-- CAS 不匹配表示文件被外部修改，必须报告冲突
-- 冲突报告包含: file_path、expected_hash、actual_hash、task_id
-- 统一 CAS + Lease 冲突报告，一个接口返回所有冲突信息
-- markConfirmed() 将冲突标记为已确认，允许写入继续
-
-## 验收项
-
-- [AC-01] 文件未被修改时 preWriteGate 返回无冲突
-- [AC-02] 文件被修改后 preWriteGate 返回 CAS 冲突
-- [AC-03] markConfirmed 后冲突状态更新
-- [AC-04] 租约冲突和 CAS 冲突统一报告
-
-## 何时使用
-
-advisory: 冲突检测是建议性的，开发者可选择覆盖
-
-## 是否 hard block
-
-否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
-
-## 证据要求
-
-- CAS 校验测试通过
-- 冲突报告测试通过
--
-
-## 人工确认/降级边界
-
-- 此能力可被开发者决策覆盖
-- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
-- 降级/禁用需经 sf_capability_update + 人工确认

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

@@ -1,59 +0,0 @@
----
-name: decision_gateway
-scope: ['*']
-products:
-  - '*'
-id: ka-pattern-decision_gateway
-lifecycle_status: active
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["*"]
-owner_mechanism_id: mc-engine-runtime
-triggers: ["代码执行","代码生成","自动执行","自动生成","LLM 预算","Token 控制"]
----
-
-## 决策规则
-
-- LLM Gateway Token 全局预算上限 Budget_Total = 100000（advisory，不 hard block）
-- LLM Gateway 单任务预算上限 Task_Budget = 30000（advisory，预算耗尽返回 warning 不阻断）
-- H1 handler 返回 h1_advisory warning，任务仍继续进入 executing
-- 熔断触发比 Circuit_Breaker_Ratio = 0.9，超过即 advisory 告警并建议降级模型
-- 重型操作分级 tier=heavy 自动启动流式心跳（advisory）
-- 心跳间隔 Heartbeat_Interval = 5000 毫秒
-- 控制流操作（classify/scope_resolve/drift_detect 等）走本地，不消耗 Token
-- 决策流操作（intent_refinement/solution_brainstorm/code_generation 等）走 Gateway，消耗 Token
-- AI 操作分级: light（<2000）/ medium（2000-3000）/ heavy（>3000）
-- 信心门限 Confidence_Threshold = 0.95，低于此值走 sf_brainstorm 补充
-
-## 验收项
-
-- [AC-01] Token 消耗监控按 operation_type 追踪
-- [AC-02] 预算超限返回 advisory warning，不阻断任务
-- [AC-03] 熔断后 AI 操作建议降级模型（advisory）
-- [AC-04] 心跳在重型操作期间每 Heartbeat_Interval 毫秒输出进度
-- [AC-05] 每次请求返回 remaining_budget 和 remaining_task_budget
-
-## 何时使用
-
-advisory: 预算耗尽是 warning 不是 hard fail，不应阻断任务
-
-## 是否 hard block
-
-否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
-
-## 证据要求
-
-- H1/H4 handler 测试通过
-- heartbeat 测试通过
--
-
-## 人工确认/降级边界
-
-- 此能力可被开发者决策覆盖
-- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
-- 降级/禁用需经 sf_capability_update + 人工确认

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

@@ -1,55 +0,0 @@
----
-name: scenario-process-rules
-type: pattern
-scope: ['*']
-products:
-  - '*'
-id: cap-kdoc-artifact-process-rules
-lifecycle_status: active
-authority: supporting
-priority: P1
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-stages: ["*"]
-owner_mechanism_id: mc-engine-runtime
-triggers: ["process_rules","操作规则","extract","review","fix","iterate"]
----
-
-# 分场景过程规则
-
-## 概述
-
-为每种产物类型定义按操作类型区分的执行规则。
-四种操作类型：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,56 +0,0 @@
----
-name: mutation_audit
-scope: ['*']
-products:
-  - '*'
-id: ka-pattern-mutation_audit
-lifecycle_status: active
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["*"]
-owner_mechanism_id: mc-engine-runtime
-triggers: ["测试质量","变异测试","测试审计","测试造假检测","覆盖率"]
----
-
-## 决策规则
-
-- 变异白名单: 只变异条件分支（if/else/switch）、比较操作符（===/>/</>=/<=）、逻辑操作符（&&/||）、return 语句、布尔字面量、算术表达式
-- 变异黑名单: console.log、注释、import/export、类型声明、debugger、纯字符串字面量
-- 变异行必须在 lcov 覆盖范围内，未覆盖行的变异无意义，视为审计无效
-- 变异操作符: 逻辑反转（=== → !==）、边界偏移（+1/-1）、布尔翻转（true → false）、返回值篡改
-- 随机抽样: 使用源码哈希作为种子的确定性 PRNG，每源码最多抽样 8 行
-- 精确断言率阈值 Precision_Threshold = 0.5，低于此判定测试"自己证明自己"
-- 覆盖率联动: 传入 lcov 报告后，只变异 DA 行 hit_count > 0 的代码行
-
-## 验收项
-
-- [AC-01] 变异前已读取 lcov 覆盖率报告
-- [AC-02] 所有变异行均在已覆盖行范围内
-- [AC-03] 未覆盖行的变异被自动过滤
-- [AC-04] 变异审计未通过时测试文件打回重写
-- [AC-05] 随机种子基于源码内容哈希，可复现
-
-## 何时使用
-
-advisory: 变异测试是质量建议，非强制要求
-
-## 是否 hard block
-
-否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
-
-## 证据要求
-
-- 变异算子测试通过
-- 评分一致性测试通过
--
-
-## 人工确认/降级边界
-
-- 此能力可被开发者决策覆盖
-- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
-- 降级/禁用需经 sf_capability_update + 人工确认

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

@@ -1,52 +0,0 @@
----
-name: regression_matrix
-scope: ['*']
-products:
-  - '*'
-id: ka-pattern-regression_matrix
-lifecycle_status: active
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["*"]
-owner_mechanism_id: mc-engine-runtime
-triggers: ["回归测试","fixture 项目","兼容性验证","复杂度预算"]
----
-
-## 决策规则
-
-- fixture 项目模版: Spring Boot、React、Go 的标准结构
-- 回归矩阵对 fixture 验证 classify/expand/verify 兼容性
-- 复杂度预算: 每个能力模块有代码行数预算，超出产生 advisory
-- fixture 使用真实 detectFingerprint 进行项目检测
-
-## 验收项
-
-- [AC-01] fixture 项目定义完整
-- [AC-02] 回归矩阵覆盖所有 fixture
-- [AC-03] 复杂度预算超出时产生 advisory
-- [AC-04] 真实 detectFingerprint 通过 fixture 检测
-
-## 何时使用
-
-advisory: 回归矩阵是质量保证工具，复杂度超预算不阻断
-
-## 是否 hard block
-
-否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
-
-## 证据要求
-
-- 回归矩阵测试通过
-- 复杂度预算报告正确
--
-
-## 人工确认/降级边界
-
-- 此能力可被开发者决策覆盖
-- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
-- 降级/禁用需经 sf_capability_update + 人工确认

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

@@ -1,50 +0,0 @@
----
-name: io_lock
-scope: ['*']
-products:
-  - '*'
-id: ka-pattern-io_lock
-lifecycle_status: active
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["*"]
-owner_mechanism_id: mc-engine-runtime
-triggers: ["互斥锁","工作区","并发控制","写入冲突"]
----
-
-## 决策规则
-
-- P0 已移除持久锁 acquire/release，仅保留 isLocked() 查询
-- 锁机制为 advisory check，不强制阻断操作
-- 写入前冲突检测是建议性的，开发者可选择忽略
-
-## 验收项
-
-- [AC-01] isLocked() 查询返回正确状态
-- [AC-02] 写入前冲突检测正常工作
-- [AC-03] 不强制阻断操作
-
-## 何时使用
-
-advisory: 锁机制为 advisory check，不强制阻断
-
-## 是否 hard block
-
-否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
-
-## 证据要求
-
-- isLocked() 查询测试通过
-- 写入前冲突检测测试通过
--
-
-## 人工确认/降级边界
-
-- 此能力可被开发者决策覆盖
-- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
-- 降级/禁用需经 sf_capability_update + 人工确认

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

@@ -1,52 +0,0 @@
----
-name: resume_workspace
-scope: ['*']
-products:
-  - '*'
-id: ka-pattern-resume_workspace
-lifecycle_status: active
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["*"]
-owner_mechanism_id: mc-engine-runtime
-triggers: ["会话恢复","工作区状态","中断恢复","state 目录"]
----
-
-## 决策规则
-
-- scanAndResume() 扫描 state 目录恢复中断任务
-- 恢复是 advisory 级别，新会话可忽略恢复直接新建任务
-- corrupt state 文件降级处理，产生 advisory 报告不阻断
-- 恢复后任务可无缝继续执行
-
-## 验收项
-
-- [AC-01] 中断任务可被恢复
-- [AC-02] corrupt state 不阻断新任务
-- [AC-03] 无活跃任务时不强制恢复
-- [AC-04] 多任务时标记 needs_human_confirm
-
-## 何时使用
-
-advisory: 恢复是最佳实践但非强制，新会话可忽略恢复直接新建任务
-
-## 是否 hard block
-
-否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
-
-## 证据要求
-
-- 中断恢复测试通过
-- corrupt state 处理测试通过
--
-
-## 人工确认/降级边界
-
-- 此能力可被开发者决策覆盖
-- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
-- 降级/禁用需经 sf_capability_update + 人工确认

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

@@ -1,55 +0,0 @@
----
-name: concurrency_lock
-scope: ['*']
-products:
-  - '*'
-id: ka-pattern-concurrency_lock
-lifecycle_status: active
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["*"]
-owner_mechanism_id: mc-engine-runtime
-triggers: ["文件写入","代码修改","重构","全量重构","大规模验证","批量操作"]
----
-
-## 决策规则
-
-- 人类主权高于 AI 推演，AI 不得静默覆盖人类的代码修改
-- 作用域租约（scope lease）为 advisory check，不强制阻断操作
-- 租约查询 isLocked() 供开发者参考，可选择忽略
-- ConflictGate preWriteGate 执行 CAS 校验，冲突为 advisory 报告
-- 标记确认 markConfirmed() 后冲突状态更新，允许写入继续
-- 任务完成或取消时建议释放租约（advisory，不强制）
-- P0 已移除持久锁 acquire/release，仅保留 isLocked() 查询
-
-## 验收项
-
-- [AC-01] 租约 acquire/release 测试通过
-- [AC-02] CAS 冲突检测测试通过
-- [AC-03] 锁机制不强制阻断操作
-- [AC-04] 冲突报告包含完整信息供开发者决策
-
-## 何时使用
-
-advisory: 租约是写入前建议检查，不强制阻断
-
-## 是否 hard block
-
-否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
-
-## 证据要求
-
-- acquire/release 测试通过
-- 过期清理测试通过
--
-
-## 人工确认/降级边界
-
-- 此能力可被开发者决策覆盖
-- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
-- 降级/禁用需经 sf_capability_update + 人工确认

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

@@ -1,65 +0,0 @@
----
-name: developer_constitution
-scope: ['*']
-products:
-  - '*'
-id: ka-pattern-developer_constitution
-lifecycle_status: active
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["*"]
-owner_mechanism_id: mc-engine-runtime
-triggers: ["代码交付","交付","PR","提交","合并","审查确认"]
----
-
-## 决策规则
-
-- 我是唯一的架构主权者，AI 的建议不代表最终正确
-- 严禁静默交付: 所有 GRAY_BOX 和 BLACK_BOX 级代码审查变更禁止跳过人工确认
-- 人工签署格式: [Human-Audit: APPROVED] 或 [Human-Audit: REJECTED]
-- 未获得签署的 GRAY/BLACK 变更不得标记为"验证通过"
-- 系统随机抽检人类审计真实性: 基于任务摘要生成是/否问题
-- 抽检频率: 每 5 次交付至少抽检 1 次
-- 抽检问题格式: "任务 {task_id} 的变更中，{摘要细节} 是否为 [是/否]？"
-- 人类答错时标记该交付为"待重新审计"
-
-## 逻辑奇点警告触发条件
-
-- LLM Gateway 返回 circuit_open = true
-- 单任务 Token 超过阈值，remaining_task_budget <= 0
-- 验证 3 次重试仍失败
-- 变异审计发现测试"自己证明自己"且覆盖率联动显示 0% 覆盖
-- 知识漂移 drift_ratio >= 0.5 且根因分析为 code_degradation
-
-## 验收项
-
-- [AC-01] GRAY/BLACK 变更展示后等待人类签署
-- [AC-02] 未签署的变更无法通过 sf_stage_advance 记录
-- [AC-03] 抽检问题基于实际任务摘要生成
-- [AC-04] 逻辑奇点警告以 ⚠ 符号开头并包含具体触发原因
-- [AC-05] core/ 目录下的规则修改需人工签署双重确认
-
-## 何时使用
-
-advisory: 开发者主权的审查建议不 hard block 交付
-
-## 是否 hard block
-
-否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
-
-## 证据要求
-
-- preDeliveryReview 测试通过
-- veto 逻辑测试通过
--
-
-## 人工确认/降级边界
-
-- 此能力可被开发者决策覆盖
-- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
-- 降级/禁用需经 sf_capability_update + 人工确认

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

@@ -1,51 +0,0 @@
----
-name: secret_scan
-scope: ['*']
-products:
-  - '*'
-id: ka-pattern-secret_scan
-lifecycle_status: active
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["*"]
-owner_mechanism_id: mc-engine-runtime
-triggers: ["密钥检测","敏感信息","gitleaks","安全扫描"]
----
-
-## 决策规则
-
-- detectSecrets() 使用正则匹配 + gitleaks 回退链检测密钥
-- severity=blocked 的密钥（AWS key、API key 等）阻断写入
-- 扫描覆盖写入内容的每一行
-- gitleaks 不可用时回退到内置正则规则
-
-## 验收项
-
-- [AC-01] 已知密钥格式被检测
-- [AC-02] blocked 级别密钥阻断写入
-- [AC-03] gitleaks 回退正常工作
-- [AC-04] 误报率 < 1%
-
-## 何时使用
-
-密钥泄露是最高风险，必须 hard fail
-
-## 是否 hard block
-
-是。此能力为 enforced 状态，违规即 hard fail 阻断流程。
-
-## 证据要求
-
-- golden set 密钥检测通过
-- 误报率测试通过
-- 无已知密钥泄露事件
-
-## 人工确认/降级边界
-
-- enforced 能力不可跳过，违反即阻断
-- 降级需经 sf_capability_update + 人工确认，提供 escape report 证据

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

@@ -1,55 +0,0 @@
----
-name: template-frontmatter-parser
-type: pattern
-scope: ['*']
-products:
-  - '*'
-id: cap-kdoc-template-schema-loader
-lifecycle_status: active
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-stages: ["*"]
-owner_mechanism_id: mc-engine-runtime
-triggers: ["frontmatter","template_schema_loader","模版加载","YAML解析"]
----
-
-# 模版 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,54 +0,0 @@
----
-name: governance_runtime_loop
-scope: ['*']
-products:
-  - '*'
-id: ka-pattern-governance_runtime_loop
-lifecycle_status: active
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["*"]
-owner_mechanism_id: mc-engine-runtime
-triggers: ["治理闭环","抽检","逃逸报告","能力状态","审计"]
----
-
-## 决策规则
-
-- 治理闭环: sample → escape → report → capability_update
-- 抽检使用风险加权抽样，critical 风险 100% 抽中
-- 逃逸报告记录发现的问题，不自动降级
-- 治理报告汇总全局状态，只读不改
-- 能力状态更新必须经 sf_capability_update + 人工确认
-
-## 验收项
-
-- [AC-01] 抽检→逃逸→报告闭环测试通过
-- [AC-02] 无自动降级行为
-- [AC-03] 状态更新需人工确认
-- [AC-04] report 数据与实际 escape 一致
-
-## 何时使用
-
-advisory: 治理闭环只读不改，状态更新必须经 sf_capability_update + 人工确认
-
-## 是否 hard block
-
-否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
-
-## 证据要求
-
-- 抽检→逃逸→报告→显式更新闭环测试通过
-- MCP handler 闭环测试通过
-- 无自动降级行为
--
-
-## 人工确认/降级边界
-
-- 此能力可被开发者决策覆盖
-- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
-- 降级/禁用需经 sf_capability_update + 人工确认