soloforge 1.1.40 → 1.1.43

package/templates/gates/shared/gate-/351/234/200/346/261/202/345/210/206/346/236/220.yaml

@@ -1,164 +0,0 @@
-# 需求分析门禁配置
-# 对照方案 §六 改进 G-01 — 15 项检查 + PROMOTE/HOLD/ROLLBACK 决策模型
-# AI Agent 门禁原则：独立验证 > AI 自查；确定性检查优先；探索覆盖度可度量
-
-stage: "需求分析"
-description: "需求分析产物完备性校验"
-
-decision_model:
-  PROMOTE: "所有 error 项通过（证据完备），warning 项通过或标注已知取舍"
-  HOLD: "error 项全部通过但 warning 项未处理（需用户确认是否接受）"
-  ROLLBACK: "任何 error 项失败或证据缺失"
-
-checks:
-  # ===== 原型说明模版（4 项）=====
-
-  - name: "原型源码包存在"
-    category: "input_check"
-    severity: "error"
-    check_type: "deterministic"
-    required_artifact: "原型源码包"
-    rule: "原型源码包必须存在且可读取"
-    evidence_required:
-      - "已读取的源码文件路径列表"
-
-  - name: "原型说明结构完备"
-    category: "output_check"
-    severity: "error"
-    check_type: "deterministic"
-    required_artifact: "原型说明模版"
-    rule: "原型说明模版必须完整覆盖 10 个章节（含新增第 10 章无障碍），不得有空章节"
-    evidence_required:
-      - "章节标题完整列表"
-      - "章节数计数结果（必须 = 10）"
-
-  - name: "无禁止空洞"
-    category: "quality_check"
-    severity: "error"
-    check_type: "deterministic"
-    required_artifact: "原型说明模版"
-    rule: "所有章节无空标题、无 TODO 占位、无 `-` 单独占位"
-    evidence_required:
-      - "空标题检测结果（须为 0 处）"
-
-  - name: "证据标记覆盖"
-    category: "evidence_check"
-    severity: "warning"
-    check_type: "deterministic"
-    required_artifact: "原型说明模版"
-    rule: "内容使用统一标记体系 [SRC]/[LOG]/[CFG]/[REF]/[DES]/[INF]，标记引用的文件路径必须存在"
-    evidence_required:
-      - "标记正则匹配结果"
-      - "标记引用文件路径存在性校验结果"
-
-  # ===== 需求分析模版（4 项）=====
-
-  - name: "需求分析结构完备"
-    category: "output_check"
-    severity: "error"
-    check_type: "deterministic"
-    required_artifact: "需求分析模版"
-    rule: "需求分析模版必须完整覆盖 10 个章节（含新增第 8 章 NFR、第 9 章角色、第 10 章外部接口）"
-    evidence_required:
-      - "章节标题完整列表"
-      - "章节数计数结果（必须 = 10）"
-
-  - name: "非功能需求量化"
-    category: "quality_check"
-    severity: "error"
-    check_type: "semantic"
-    required_artifact: "需求分析模版"
-    rule: "第 8 章每条 NFR 必须包含量化验收指标（数字或百分比），禁止'高性能''安全'等模糊表述"
-    evidence_required:
-      - "NFR 表中「验收指标」列非空且含数字或百分比的工具校验结果"
-      - "模糊表述关键词扫描结果（须为 0 处）"
-
-  - name: "用户角色一致性"
-    category: "quality_check"
-    severity: "error"
-    check_type: "semantic"
-    required_artifact: "需求分析模版"
-    rule: "第 6 章菜单权限和第 2 章功能点引用的角色在第 9 章有定义，三处角色名称一致"
-    evidence_required:
-      - "三处角色名称交叉引用校验结果"
-      - "未定义角色列表（须为空）"
-
-  - name: "外部接口声明"
-    category: "completeness_check"
-    severity: "warning"
-    check_type: "deterministic"
-    required_artifact: "需求分析模版"
-    rule: "第 10 章无空洞或显式标注'无外部依赖'"
-    evidence_required:
-      - "章节内容非空检测结果"
-
-  # ===== 追踪矩阵（3 项）=====
-
-  - name: "追踪矩阵结构完备"
-    category: "output_check"
-    severity: "error"
-    check_type: "deterministic"
-    required_artifact: "需求原型设计实现追踪矩阵模版"
-    rule: "追踪矩阵模版必须完整覆盖 6 个章节"
-    evidence_required:
-      - "章节标题完整列表"
-      - "章节数计数结果（必须 = 6）"
-
-  - name: "覆盖分析完整"
-    category: "quality_check"
-    severity: "warning"
-    check_type: "semantic"
-    required_artifact: "需求原型设计实现追踪矩阵模版"
-    rule: "第 6 章正向覆盖无'未覆盖'行，或'已排除'行有排除原因"
-    evidence_required:
-      - "覆盖状态列值枚举校验结果"
-      - "已排除行原因列非空校验结果"
-
-  - name: "验证方法声明"
-    category: "quality_check"
-    severity: "warning"
-    check_type: "deterministic"
-    required_artifact: "需求原型设计实现追踪矩阵模版"
-    rule: "总矩阵每行必须有验证方法（Test/Demonstration/Analysis/Inspection）"
-    evidence_required:
-      - "验证方法列非空检测结果"
-
-  # ===== 引擎机制集成（2 项）=====
-
-  - name: "未确认项分级完备"
-    category: "quality_check"
-    severity: "warning"
-    check_type: "deterministic"
-    required_artifact: "需求分析模版"
-    rule: "第 4 章所有未确认项使用四级分级 {blocking, material, minor, non_blocking}，无二分法值"
-    evidence_required:
-      - "分级列值枚举校验结果"
-
-  - name: "阻塞级收敛完成"
-    category: "evidence_check"
-    severity: "error"
-    check_type: "semantic"
-    required_artifact: "需求分析模版"
-    rule: "blocking 级未确认项附带候选方案和用户确认结果"
-    evidence_required:
-      - "blocking 行的候选方案列非空校验结果"
-      - "blocking 行的用户确认结果列非空校验结果"
-
-  # ===== AI Agent 专项（2 项）=====
-
-  - name: "输入产物探索完整"
-    category: "input_check"
-    severity: "error"
-    check_type: "semantic"
-    rule: "Agent 必须引用所有输入产物（需求来源材料、原型源码包、现有系统源码），引用证据包含具体文件路径，不得泛化引用"
-    evidence_required:
-      - "已读取的所有输入文件路径列表"
-      - "各输入产物类型覆盖确认（需求/原型/源码）"
-
-  - name: "确定性检查通过率"
-    category: "meta_check"
-    severity: "error"
-    check_type: "deterministic"
-    rule: "所有确定性检查项（章节数/空标题/标记存在性/列非空）须 100% 通过"
-    evidence_required:
-      - "确定性检查项工具执行结果汇总表（检查项/结果/证据）"

package/templates/internal/patterns/Diff/345/275/222/345/261/236/350/277/275/350/270/252.md

@@ -1,53 +0,0 @@
----
-name: diff_ownership
-scope: ['*']
-products:
-  - '*'
-id: ka-pattern-diff_ownership
-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: ["Diff 归属","变更追踪","CAS 校验","代码变更"]
----
-
-## 决策规则
-
-- diff_ownership 追踪代码变更归属：owned / inherited / external
-- CAS 校验确保 diff 与源文件一致
-- scope 目录展开排除外部目录的 diff
-- experimental: 只做状态模型和 CAS 校验，不替换现有写入流程
-
-## 验收项
-
-- [AC-01] Diff 归属分类正确
-- [AC-02] CAS 校验通过
-- [AC-03] scope 排除外部 diff
-- [AC-04] 冲突检测正常
-
-## 何时使用
-
-experimental: 只做状态模型和 CAS 校验，不替换现有写入流程，不新增 hard block
-
-## 是否 hard block
-
-否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
-
-## 证据要求
-
-- Diff 归属分类测试通过
-- CAS 校验生命周期测试通过
-- 冲突检测测试通过
--
-
-## 人工确认/降级边界
-
-- 此能力可被开发者决策覆盖
-- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
-- 降级/禁用需经 sf_capability_update + 人工确认

package/templates/internal/patterns/Hook/345/261/202/344/272/247/347/211/251/347/273/223/346/236/204/346/240/241/351/252/214.md

@@ -1,55 +0,0 @@
----
-name: hook-product-structure-validation
-type: pattern
-scope: ['*']
-products:
-  - '*'
-id: cap-kdoc-write-artifact-validator
-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: ["L4校验","产物结构","check_write","check_bash","artifact_validator"]
----
-
-# Hook 层产物结构校验
-
-## 概述
-
-在 check_write 和 check_bash 的写入钩子中增加 L4 产物结构校验。
-当写入已知产物类型的 .md 文件时，自动校验结构完整性。
-
-## 何时使用
-
-- 当 AI 通过 write 工具或 bash 命令写入 .md 产物文件时自动触发
-- 当需要验证产物文档是否满足 Schema 定义的结构约束时
-
-## 是否 hard block
-
-advisory — L4 校验初始为 advisory（warning 为主），不 hard block 正常写入流程。
-仅当严重缺失（≥ 3 个问题 + ≥ 2 个章节缺失）时才 blocked。
-后续根据误报率数据决定是否升级为 enforced。
-
-## 证据要求
-
-- 路径推断（ARTIFACT_ALIASES + .soloforge/output/）测试通过
-- 内容校验（完整内容 pass / 部分缺失 warning / 严重缺失 blocked）测试通过
-- 非 .md 文件和短内容直接跳过
-
-## 人工确认/降级边界
-
-- L4 校验不阻断首次产物生成（首次可能为草稿）
-- blocked 时人工可确认跳过
-- 无法推断产物类型的文件自动 pass
-
-## 校验流程
-
-1. 从文件路径推断产物类型
-2. 从 Schema 注册中心获取结构定义
-3. 校验必填章节和表格
-4. 根据缺失程度判定：pass / warning / blocked

package/templates/internal/patterns/Java/350/264/250/351/207/217/351/227/250/347/246/201.md

@@ -1,52 +0,0 @@
----
-name: java_quality_guard
-scope: ['*']
-products:
-  - '*'
-id: ka-pattern-java_quality_guard
-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: ["Java 代码质量","代码审查","质量门禁","空catch","raw type"]
----
-
-## 决策规则
-
-- hard gate: 空 catch、raw type（ArrayList 无泛型）、System.out、Thread.sleep
-- advisory: 方法长度 >80 行、缺少 @Override
-- 项目规则通过 loadProjectRules 加载，可覆盖内置规则
-- 规则 ID 格式: JAVA-C###（hard gate）、JAVA-Q###（advisory）
-
-## 验收项
-
-- [AC-01] 空 catch 被检测
-- [AC-02] raw type 被检测
-- [AC-03] 项目规则覆盖内置规则
-- [AC-04] advisory 规则不阻断
-
-## 何时使用
-
-advisory: Java 质量门禁中只有 hard gate 阻断，其余为建议
-
-## 是否 hard block
-
-否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
-
-## 证据要求
-
-- hard gate 测试通过
-- 项目规则覆盖测试通过
--
-
-## 人工确认/降级边界
-
-- 此能力可被开发者决策覆盖
-- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
-- 降级/禁用需经 sf_capability_update + 人工确认

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

@@ -1,52 +0,0 @@
----
-name: llm_gateway
-scope: ['*']
-products:
-  - '*'
-id: ka-pattern-llm_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: ["Token 预算","LLM 调用","成本控制","降级"]
----
-
-## 决策规则
-
-- H1 handler 返回 h1_advisory warning，任务仍继续进入 executing
-- 预算耗尽是 warning 不是 hard fail，不应阻断任务
-- heartbeat 机制定期检查预算使用率
-- 预算耗尽时建议降级到更便宜的模型（advisory 报告）
-
-## 验收项
-
-- [AC-01] H1 handler 返回 advisory 不阻断
-- [AC-02] heartbeat 正常触发
-- [AC-03] 预算超限产生 warning
-- [AC-04] 预算使用率可观测
-
-## 何时使用
-
-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//344/272/247/347/211/251Schema/346/263/250/345/206/214/344/270/255/345/277/203.md

@@ -1,55 +0,0 @@
----
-name: product-schema-registry
-type: pattern
-scope: ['*']
-products:
-  - '*'
-id: cap-kdoc-artifact-schema-registry
-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: ["artifact_schema","产物结构","Schema注册","artifact_contract"]
----
-
-# 产物 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,53 +0,0 @@
----
-name: task_context_lifecycle
-scope: ['*']
-products:
-  - '*'
-id: ka-pattern-task_context_lifecycle
-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: ["任务创建","状态转移","生命周期","任务管理"]
----
-
-## 决策规则
-
-- 任务状态机强制执行 VALID_TRANSITIONS，非法转移抛出错误
-- 合法状态: classifying → planning → expanding → executing → verifying → learning → delivering → completed
-- 可从 executing/verifying/learning 回到 classifying（重新分类）
-- 可从任何非 terminal 状态进入 failed/cancelled
-- 所有 handler 依赖此状态机约束，违反即 hard fail
-
-## 验收项
-
-- [AC-01] 合法状态转移成功执行
-- [AC-02] 非法状态转移抛出错误
-- [AC-03] handler 生命周期测试覆盖所有转移路径
-- [AC-04] 并发场景下无竞态条件
-
-## 何时使用
-
-核心状态机，所有 handler 依赖此约束
-
-## 是否 hard block
-
-是。此能力为 enforced 状态，违规即 hard fail 阻断流程。
-
-## 证据要求
-
-- 全量状态转移测试通过
-- handler 生命周期测试通过
-- 无已知逃逸缺陷
--
-
-## 人工确认/降级边界
-
-- enforced 能力不可跳过，违反即阻断
-- 降级需经 sf_capability_update + 人工确认，提供 escape report 证据

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

@@ -1,53 +0,0 @@
----
-name: job_manager
-scope: ['*']
-products:
-  - '*'
-id: ka-pattern-job_manager
-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: ["任务管理","checkpoint","heartbeat","恢复","认知锚点"]
----
-
-## 决策规则
-
-- JobManager 管理 任务生命周期: 创建、更新 checkpoint、heartbeat、恢复、取消
-- CognitiveAnchor 记录阶段、摘要、关键决策、待办事项
-- resumeFromCheckpoint 从最近 checkpoint 恢复任务
-- listActiveJobs 列出活跃任务，过滤过期任务
-- checkpoint 用于中断恢复和进度追踪
-
-## 验收项
-
-- [AC-01] 任务创建返回有效 ID
-- [AC-02] checkpoint 更新正确
-- [AC-03] 过期任务被过滤
-- [AC-04] 恢复从 checkpoint 继续
-
-## 何时使用
-
-advisory: 任务管理是辅助工具，不强制要求使用
-
-## 是否 hard block
-
-否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
-
-## 证据要求
-
-- checkpoint 更新测试通过
-- 恢复测试通过
--
-
-## 人工确认/降级边界
-
-- 此能力可被开发者决策覆盖
-- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
-- 降级/禁用需经 sf_capability_update + 人工确认

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,52 +0,0 @@
----
-name: scope_hook
-scope: ['*']
-products:
-  - '*'
-id: ka-pattern-scope_hook
-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: ["文件范围","路径校验","越权检测","symlink 解析"]
----
-
-## 决策规则
-
-- checkScope() 校验文件路径是否在 allowed_paths 范围内
-- symlink 解析后校验真实路径，防止路径穿越
-- 路径匹配使用规范化比较，支持通配符
-- 越权访问为 enforced 级别，违规即 hard fail
-
-## 验收项
-
-- [AC-01] 合法路径通过校验
-- [AC-02] symlink 路径穿越被拦截
-- [AC-03] 越权路径产生 hard fail
-- [AC-04] 通配符匹配正确
-
-## 何时使用
-
-文件范围和安全是强制门禁
-
-## 是否 hard block
-
-是。此能力为 enforced 状态，违规即 hard fail 阻断流程。
-
-## 证据要求
-
-- 路径匹配 + symlink 测试通过
-- 密钥扫描 golden set 通过
-- 无已知越权逃逸
--
-
-## 人工确认/降级边界
-
-- enforced 能力不可跳过，违反即阻断
-- 降级需经 sf_capability_update + 人工确认，提供 escape report 证据

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

@@ -1,53 +0,0 @@
----
-name: scope_lease
-scope: ['*']
-products:
-  - '*'
-id: ka-pattern-scope_lease
-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: ["文件写入","作用域控制","租约","并发写入","文件锁定"]
----
-
-## 决策规则
-
-- 写入文件前必须获取作用域租约（scope lease），同一文件不可被多个任务同时持有
-- 租约包含: task_id、allowed_paths、acquired_at、expires_at
-- 租约超时后自动失效，其他任务可重新获取
-- 任务完成或取消时必须释放租约
-- 租约查询 isLocked() 为 advisory check，不阻断流程
-
-## 验收项
-
-- [AC-01] acquire 返回有效租约，release 后 isLocked 返回 false
-- [AC-02] 同一文件不可被两个任务同时租约
-- [AC-03] 过期租约自动清理
-- [AC-04] clear() 清理所有租约
-
-## 何时使用
-
-advisory: 租约是写入前建议检查，不强制阻断
-
-## 是否 hard block
-
-否。此能力为 advisory 状态，违规仅产生 advisory 警告，不阻断流程。
-
-## 证据要求
-
-- acquire/release 测试通过
-- 过期清理测试通过
--
-
-## 人工确认/降级边界
-
-- 此能力可被开发者决策覆盖
-- 升级到 enforced 需满足 promotion_conditions 并通过 lifecycle_test_files 测试
-- 降级/禁用需经 sf_capability_update + 人工确认