soloforge 1.4.16 → 2.0.0

package/templates/knowledge/review_rules//350/264/250/351/207/217/345/256/241/346/237/245/350/247/204/345/210/231.md

@@ -1,101 +0,0 @@
----
-name: quality-rules
-type: review_rule
-when: '代码审查, review, 质量检查, 代码质量'
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-review-rule-质量审查规则
-asset_kind: review_rule
-lifecycle_status: active
-authority: supporting
-routes:
-  - code_change
-primary_triggers:
-  - 质量审查规则
-secondary_triggers: []
-negative_triggers: []
-priority: P1
-specificity: 5
-required_evidence:
-  - execution_evidence
-version: 1.0.0
-last_reviewed: '2026-05-22'
-migration_note: 知识资产标准化迁移
-status: active
----
-
-## QUA-01: 生产代码包含 console.log 调试输出
-pattern: /console\.log\s*\(/
-severity: warning
-scope: "!test"
-description: 生产代码禁止保留 console.log，应使用正式日志框架并按级别输出
-
-## QUA-02: TypeScript 使用 any 类型
-pattern: /:\s*any\b|as\s+any\b|<any>/
-severity: info
-scope: frontend
-description: 禁止使用 any 类型，应定义具体的 TypeScript 接口
-
-## QUA-03: 魔法数字未定义为常量
-pattern: /(?:if|while|return)\s*\(.*[^\w>!=]\d{2,}[^\w.]/
-severity: info
-scope: [backend, frontend]
-description: 代码中的数字常量应提取为命名常量，提高可读性和可维护性
-
-## QUA-04: 硬编码的 URL 或 IP 地址
-pattern: /https?:\/\/(?:localhost|127\.0\.0\.1|192\.168|10\.\d+\.\d+)\b/
-severity: warning
-scope: [backend, frontend]
-description: 服务地址禁止硬编码，必须使用环境变量或配置文件管理
-
-## QUA-05: catch 块吞掉异常不处理
-pattern: /catch\s*\([^)]*\)\s*\{\s*\}/
-severity: critical
-scope: [backend, frontend]
-description: 空的 catch 块会隐藏错误，至少需要记录日志或明确注释忽略原因
-
-## QUA-06: 注释掉的代码块（超过 3 行）
-pattern: /^\s*\/\/\s*(?:import|export|const|let|var|function|class|public|private)\b/
-severity: info
-scope: [backend, frontend]
-description: 注释掉的代码应删除，需要时从版本控制中恢复
-
-## QUA-07: System.out.println 替代日志框架
-pattern: /System\.out\.print/
-severity: warning
-scope: backend
-description: 禁止使用 System.out.println，必须使用 SLF4J/Log4j 等日志框架
-
-## QUA-08: 空 catch 块中无日志记录
-pattern: /catch\s*\([^)]*\)\s*\{[^}]*\}/
-severity: warning
-scope: [backend, frontend]
-description: catch 块中必须至少包含日志记录，不允许静默忽略异常
-
-## QUA-09: 待办/修复占位注释未跟踪
-pattern: /(?:T[O]DO|F[I]XME|H[A]CK|X{3})\s*[:\(]/
-severity: info
-scope: [backend, frontend]
-description: 待办/修复占位注释必须关联 issue 编号，禁止无跟踪的技术债标记
-
-## QUA-10: 单元测试缺少断言
-pattern: /@Test[\s\S]*?(?:expect|assert|verify|should)/
-severity: warning
-scope: [backend, frontend]
-description: 测试方法必须包含至少一个断言，空测试等于没有测试
-
-## QUA-11: 过深的嵌套层级
-pattern: //
-severity: info
-scope: [backend, frontend]
-check: nesting_depth
-description: 代码嵌套层级超过 4 层时应重构（卫语句、提前返回、策略模式）
-
-## QUA-12: 未处理可空返回值
-pattern: /\.get\(\s*\)\s*\.|\.findFirst\(\s*\)\s*\./
-severity: warning
-scope: backend
-description: Optional/List.get() 返回值必须判空，禁止直接链式调用导致 NPE

package/templates/knowledge/rules/OOD/344/270/216SOLID/350/256/276/350/256/241/350/247/204/345/210/231.md

@@ -1,62 +0,0 @@
----
-name: OOD与SOLID设计规则
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-hard-rule-OOD与SOLID设计规则
-asset_kind: hard_rule
-lifecycle_status: active
-authority: canonical
-owner_mechanism_id: mc-ood-solid-contract
-asset_role: required
-consumed_by:
-  - mc-ood-solid-contract
-routes:
-  - code_change
-  - artifact_generation
-  - multi_stage_plan
-primary_triggers:
-  - 面向对象设计
-  - SOLID
-secondary_triggers:
-  - 领域服务
-  - 重构
-  - 策略
-negative_triggers:
-  - 文案
-  - 样式
-priority: P1
-specificity: 5
-consumes:
-  - mc-coding-readiness
-hard_blocks:
-  - ood_summary_missing
-  - solid_hard_fail_unresolved
-fallback: manual_required
-required_evidence:
-  - ood_design_summary
-  - code_review_findings
-version: 1.0.0
-last_reviewed: '2026-05-26'
-status: active
----
-
-## 编码前门禁
-
-复杂业务逻辑、领域模型、服务边界、策略或重构任务在编码前必须给出：
-
-- 对象及单一职责。
-- 对外接口与依赖方向。
-- 可变化点与扩展方式。
-- SRP、OCP、LSP、ISP、DIP 风险及验证方式。
-
-## 代码审查门禁
-
-- Controller 不承担业务计算或持久化职责。
-- 应用/领域服务依赖抽象端口，不直接构造基础设施依赖。
-- 子类型不能拒绝父契约操作，接口不能迫使实现提供无效操作。
-- 同一类型或状态的多处分支应判断是否需要策略扩展点。
-
-硬失败未清零时，不得交付。简单文案或样式修改不强行引入对象设计。

package/templates/knowledge/rules//344/272/247/347/211/251/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -1,57 +0,0 @@
----
-name: 产物契约规则
-scope:
-  - '*'
-products:
-  - '*'
-id: ka-hard-rule-产物契约规则
-asset_kind: hard_rule
-lifecycle_status: active
-authority: canonical
-owner_mechanism_id: mc-artifact-contract
-routes:
-  - 产物契约规则
-primary_triggers:
-  - 产物契约规则
-secondary_triggers: []
-negative_triggers: []
-priority: P0
-specificity: 5
-consumes:
-  - mc-workflow-contract
-hard_blocks:
-  - 产物scope外
-  - force_overwrite
-fallback: manual_required
-required_evidence:
-  - output_artifact
-  - artifact_status
-version: 1.0.0
-last_reviewed: '2026-05-22'
-migration_note: 知识资产标准化迁移
-type: hard_rule
-when: 产物契约规则
-status: active
----
-
-# 产物契约规则
-
-## 核心约束
-
-1. 产物必须通过 `artifact_contract_registry` 注册，包含 kind、format、path、overwrite_policy。
-2. 产物生命周期：draft → verified → accepted。跳过阶段必须显式声明 `skip_verification`。
-3. `overwrite_policy` 仅允许 `fail_if_exists` 或 `versioned`。禁止 `force_overwrite`。
-4. 产物路径必须在 `declared_scope` 内。scope 外产物触发 hard_fail。
-5. 所有产物变更必须通过 `sf_verify` 验证后才能推进状态。
-
-## 适用场景
-
-- 单产物生成 (`single_artifact`)
-- 多阶段计划产物交付 (`multi_stage_plan`)
-- 代码执行产物 (`code_execution`)
-
-## 违规处理
-
-- 未注册产物 → hard_fail，阻断交付
-- scope 外产物 → hard_fail，阻断写入
-- 跳过验证且无声明 → advisory，标记降级

package/templates/knowledge/rules//344/273/243/347/240/201/346/263/250/351/207/212/344/270/216/346/227/245/345/277/227/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -1,150 +0,0 @@
----
-name: 代码注释与日志契约规则
-scope:
-  - '*'
-products:
-  - '*'
-id: ka-hard-rule-代码注释与日志契约规则
-asset_kind: hard_rule
-lifecycle_status: active
-authority: canonical
-owner_mechanism_id: mc-code-maintainability-observability-contract
-routes:
-  - code_change
-  - artifact_generation
-  - operation
-  - multi_stage_plan
-primary_triggers:
-  - 业务编码
-  - 接口实现
-  - 状态流转
-  - 支付
-  - 权限
-  - 迁移脚本
-  - 数据修复
-secondary_triggers:
-  - Service
-  - Controller
-  - UseCase
-  - Handler
-  - Router
-  - Form
-  - Store
-  - 异常处理
-negative_triggers:
-  - 文案
-  - 样式
-  - getter
-  - setter
-  - fixture
-priority: P0
-specificity: 5
-consumes:
-  - mc-coding-readiness
-hard_blocks:
-  - code_observability_work_package_missing
-  - sensitive_log_leak
-  - catch_swallow
-  - missing_log_critical
-  - missing_comment_complex_unresolved
-  - missing_class_doc
-  - missing_method_doc
-  - missing_important_line_comment
-  - non_chinese_log
-  - non_chinese_comment
-fallback: manual_required
-required_evidence:
-  - code_observability_work_package
-  - review_findings
-  - verification_result
-version: 1.0.0
-last_reviewed: '2026-05-26'
----
-
-## 注释契约
-
-### 中文 Javadoc 必须具备
-- Java/Kotlin 后端类、接口、枚举、记录必须有中文文档注释，说明类型职责、业务边界和使用场景。
-- 后端每个业务方法必须有中文文档注释，说明方法作用；有入参时说明参数语义；有返回值时说明返回对象或结果含义。
-- Controller、Service、UseCase、DomainService、Repository、Mapper、DTO、VO、Request、Response、Entity 等均适用。
-- 关键业务行必须有中文行注释，尤其是事务双写、状态流转、级联删除、账号联动、外部调用、审计写入、补偿和回滚边界。
-- 允许保留英文代码标识符，但业务说明、风险说明、参数说明、返回说明必须中文表达。
-
-### 必须有注释
-- 业务规则不直观时
-- 领域不变量（如"一个用户同一时间只能有一个有效业务办理"）
-- 金额、账单、折扣、支付、退款、核验逻辑
-- 状态流转逻辑（如 pending → paid → refunded）
-- 幂等、分布式锁、事务、并发控制
-- 权限、安全、审计判断
-- 外部系统兼容、历史包袱、第三方接口限制
-- 复杂 SQL、复杂查询条件、非显而易见算法
-- 前端复杂交互规则：权限控制、状态流转、表单联动、乐观更新/回滚、支付与敏感操作
-
-### 必须禁止
-- 每行废话注释
-- 复述代码字面含义的注释
-- 注释与代码行为不一致
-- 注释承诺了代码没有做到的安全性、幂等性或事务性
-- 用户项目业务注释全英文
-- 只写 `{@inheritDoc}` 但没有说明本实现的业务边界、入参和出参
-
-## 日志契约
-
-### 必须有日志
-- 用户登录、登出、认证失败
-- 权限拒绝、越权访问
-- 创建、修改、删除关键业务对象
-- 状态变更、金额变更、支付、退款、折扣、核验
-- 合同、业务办理、账单、证照、人员角色变更
-- 外部 API 调用失败、超时、重试
-- 异步任务开始、成功、失败、重试、跳过
-- 数据修复、批处理、迁移脚本
-- 捕获异常后继续执行
-- 降级、兜底、补偿逻辑
-- 前端关键交互：表单提交、状态变更、权限动作、支付/敏感操作、上传导入、API 调用失败
-
-### 日志必须具备
-- 中文事件名或中文动作说明
-- 事件名或动作名
-- 业务对象 ID
-- 操作人或系统来源
-- traceId / correlationId（如果项目已有）
-- 失败原因
-- 关键状态变化前后值
-- 合理日志级别
-
-### 必须禁止
-- 裸 console.log（生产代码）
-- 生产代码遗留调试日志
-- catch 后无日志直接吞异常
-- 只打印 "error"、"failed" 这类不可定位日志
-- 用户项目业务日志全英文
-- 打印 password、token、secret、cookie、身份证全量、手机号全量、银行卡全量、健康隐私
-- 高频循环里刷屏日志
-- 日志拼接大对象导致性能或隐私问题
-
-## 项目 logger 识别
-- Java/Spring: Slf4j + LoggerFactory
-- Node/Express/NestJS: pino, winston, NestJS Logger, 项目封装 logger
-- Python/FastAPI、Go handler、.NET、Ruby 等后端: 使用项目现有 logger 或先建立 logger 包装
-- NestJS: Logger
-- React/Vue/Svelte 等前端: 项目封装 logger、埋点或错误上报，生产环境禁止裸 console
-- 如果项目没有 logger，要求先建立项目 logger 包装
-
-## 跨技术栈适用范围
-- 后端不限定 Spring：Controller、Service、UseCase、Handler、Router、Resolver、ViewSet、Repository、Mapper 等写操作都适用。
-- 前端不限定框架：React、Vue、Svelte、移动端页面和状态 store 的业务提交、状态变更、权限动作和 API 失败都适用。
-- Entity、Request、Response、VO、DTO、Schema、Serializer、Model 等用户项目契约类的业务字段需要中文含义说明或 Schema 注解。
-- Java Entity 使用 Getter/Setter 分层访问策略；DTO、VO、Request、Response 使用 Data 风格承载边界数据，不得混用导致领域模型语义被抹平。
-
-## 严重度
-- P0 阻断: 敏感信息泄漏、catch 吞异常、支付/金额/权限变更无日志
-- P1 阻断: 状态流转无日志、复杂规则无注释、后端类/方法中文 Javadoc 缺失、关键行中文注释缺失、中文日志缺失、外部调用无日志、裸 console.log
-- P2 警告: 日志级别不合理、上下文字段不足
-- P3 建议: 普通可读性优化
-
-## 低风险跳过
-- 纯样式、文案、简单 getter/setter、简单类型定义、测试 fixture
-- 低风险只读查询且已有统一 access log
-- 简单配置修改、一次性本地实验代码

package/templates/knowledge/rules//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/350/247/204/345/210/231.md

@@ -1,65 +0,0 @@
----
-name: 任务上下文生命周期规则
-scope:
-  - '*'
-products:
-  - '*'
-id: ka-hard-rule-任务上下文生命周期规则
-asset_kind: hard_rule
-lifecycle_status: active
-authority: canonical
-owner_mechanism_id: mc-task-context-lifecycle
-asset_role: required
-consumed_by:
-  - mc-task-context-lifecycle
-  - consumable_asset_registry
-  - knowledge_injection
-routes:
-  - 任务上下文生命周期规则
-primary_triggers:
-  - 任务上下文生命周期规则
-secondary_triggers:
-  - TaskContext
-  - 任务上下文
-  - task_context
-negative_triggers: []
-priority: P1
-specificity: 5
-consumes:
-  - mc-task-context-lifecycle
-hard_blocks:
-  - TaskContext 混入推理过程
-  - TaskContext 包含 stdout/stderr 原文
-  - TaskContext 包含 secret
-  - 无效状态转换
-fallback: manual_required
-required_evidence:
-  - status_transition_log
-  - fact_accumulation_report
-version: 1.0.0
-last_reviewed: '2026-05-23'
----
-
-# 任务上下文生命周期规则
-
-## hard_rules
-
-- TaskContext 只保存可恢复工程事实（facts、refs、status、evidence id），禁止存储推理过程、chain-of-thought、原始 stdout/stderr 和 Batch 临时字段。
-- 状态转换必须经过 transition gate 验证：created → in_progress → verifying → delivering → completed | failed | degraded。
-- `verify()` 后的 TaskContext 必须 freeze，后续修改必须走 `repair_reverify` 路径。
-- `TaskContextSnapshot` 必须在每次状态转换时生成，用于审计和回滚。
-- 敏感信息（secret、token、credential）禁止写入 TaskContext，必须使用 SecretReference 间接引用。
-- `cleanup()` 不得删除被 evidence 引用的 TaskContext 条目。
-
-## not_done_if_missing
-
-- TaskContext 混入 chain-of-thought 或 secret → hard fail。
-- 无效状态转换（如 created → completed）→ hard fail。
-- cleanup 删除被引用的 evidence → hard fail。
-- TaskContext 不可恢复（进程重启后丢失关键事实）→ degraded。
-
-## verification_evidence
-
-- `tests/engine/task_context.test.ts` 覆盖状态转换、字段过滤、snapshot 生成。
-- `status_transition_gate` 运行时检查阻断无效转换。
-- `diagnostic_codes`: invalid-transition, forbidden-field, evidence-deleted。

package/templates/knowledge/rules//345/220/216/347/253/257/345/256/236/347/216/260/345/267/245/347/250/213/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -1,55 +0,0 @@
----
-name: 后端实现工程契约规则
-scope:
-  - backend
-products:
-  - '*'
-id: ka-hard-rule-后端实现工程契约规则
-asset_kind: hard_rule
-lifecycle_status: active
-authority: canonical
-owner_mechanism_id: mc-backend-implementation-contract
-asset_role: required
-consumed_by:
-  - mc-backend-implementation-contract
-routes:
-  - code_change
-  - artifact_generation
-  - multi_stage_plan
-primary_triggers:
-  - 后端实现
-  - 接口实现
-secondary_triggers:
-  - Controller
-  - DTO
-  - 事务
-  - 幂等
-negative_triggers:
-  - 文案
-priority: P1
-specificity: 5
-consumes:
-  - mc-coding-readiness
-hard_blocks:
-  - backend_work_package_missing
-  - backend_hard_fail_unresolved
-fallback: manual_required
-required_evidence:
-  - backend_work_package
-  - verification_result
-version: 1.0.0
-last_reviewed: '2026-05-26'
-status: active
----
-
-## 编码前必须确认
-
-- Controller 只接收 DTO、执行校验、调用应用服务并返回统一响应对象。
-- 写操作的事务、一致性、幂等键、并发冲突处理已定义。
-- 权限、租户隔离、敏感字段与审计日志已定义。
-- OpenAPI、请求/响应字段表、数据库 migration 和错误码有权威对齐依据。
-- 验证计划包含成功、失败、重试、越权、重复提交和边界数据。
-
-## 阻断规则
-
-直接暴露实体、写接口无校验、事务内外部调用、高风险写入无幂等或敏感接口无安全审计证据，均不得交付。

package/templates/knowledge/rules//345/221/275/344/273/244/346/211/247/350/241/214/350/247/204/345/210/231.md

@@ -1,61 +0,0 @@
----
-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
----
-
-# 命令执行规则
-
-## 核心原则
-
-命令执行必须按副作用分级: destructive 命令需人工确认，read-only 命令可自动执行。
-
-## 命令分级
-
-1. **destructive**: 不可逆操作 (drop table, force push)，需人工确认
-2. **mutating**: 可逆修改 (build, test)，可自动执行但需记录
-3. **read_only**: 只读操作 (ls, cat)，可自由执行
-
-## 规则
-
-1. 每个命令必须通过 classifyCommand 分级
-2. destructive 命令不可自动执行
-3. 所有命令执行结果必须记录证据
-4. 命令执行链必须可追踪
-
-## 验收标准
-
-- [ ] classifyCommand 覆盖所有已知命令模式
-- [ ] destructive 命令被正确分级和阻断
-- [ ] CommandExecutionResult 包含完整证据
-- [ ] 命令执行链记录在 task_context 中

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,56 +0,0 @@
----
-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
----
-
-# 工作流契约规则
-
-## 核心原则
-
-每个工作流必须声明所需机制、知识注入要求和权限边界。工作流契约确保编排路径可验证。
-
-## 规则
-
-1. **机制声明**: 每个工作流必须声明 required_mechanisms
-2. **知识注入**: 每个工作流必须引用 mc-knowledge-injection-boundary
-3. **权限一致性**: read-only 工作流不可产生 mutation
-4. **入口回归**: 每个路由必须有对应的工作流
-5. **范围回归**: 工作流 scope 必须覆盖所有产出文件
-
-## 验收标准
-
-- [ ] 每个工作流有 required_mechanisms 列表
-- [ ] 知识注入机制被所有工作流引用
-- [ ] read-only 工作流无 mutation 产出
-- [ ] validateWorkflowContracts() 返回 0 hard_fail