soloforge 1.1.46 → 1.1.47

package/templates/build//350/264/250/351/207/217/345/256/241/346/237/245.md

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

package/templates/build//350/277/201/347/247/273/346/265/201/346/260/264/347/272/277.md

@@ -1,52 +0,0 @@
----
-id: ka-procedure-迁移流水线
-kind: guidance
-title: 迁移流水线
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 技术迁移
-  - 框架升级
-  - 技术栈迁移
-  - 版本升级
-  - 迁移
-  - migration
-  - 系统迁移
-  - 组件替换
-extra:
-  name: migration-pipeline
-  type: procedure
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  domain:
-    - build
-    - verify
-  verification_layer: L2
-  stage: build
----
-
-# 技术迁移管线
-
-## 第1步：迁移评估
-评估迁移范围和影响（模块数、代码量、依赖链）。评估迁移路径（渐进式/一次性）。评估兼容性风险（API 变更、行为差异、性能差异）。制定回滚方案。
-模版：迁移评估.md
-产出保存到：docs/architecture/08-迁移方案.md
-工具：sf_analyze
-
-## 第2步：方案设计
-制定分阶段迁移计划（每阶段可独立验证和回滚）。识别兼容层需求（适配器/Shim/Feature Flag）。定义每个阶段的完成标准和验证方式。
-产出保存到：docs/architecture/08-迁移方案.md
-
-## 第3步：渐进迁移
-按计划逐步迁移，每阶段完成后全量测试。保持双写/双读过渡期（如需要）。记录每阶段发现的行为差异和兼容性问题。
-工具：sf_work action=act, sf_gate
-
-## 第4步：清理验证
-移除兼容层和废弃代码。全量功能验证。性能对比确认无退化。更新文档和依赖配置。
-工具：sf_work action=verify, sf_gate

package/templates/build//351/200/232/347/224/250/350/264/250/351/207/217.md

@@ -1,176 +0,0 @@
----
-id: ka-artifact_template-general-quality
-kind: artifact
-title: 通用质量
-sync_policy: copy_to_project
-status: active
-extra:
-  name: general-quality
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.3.0
-  last_reviewed: '2026-06-07'
-  type: artifact
-  domain: build
-  stage: build
-  owner_mechanism: mc-standard-asset-contract
----
-
-## 验收项
-
-- id: AC-01
-  name: "无 SQL 字符串拼接"
-  severity: warning
-  check_type: deterministic
-  pattern: "grep -E '(SELECT|INSERT|UPDATE|DELETE).*(\\+|\\$\\{|%s)' {file}"
-  description: 使用参数化查询或 ORM，禁止字符串拼接 SQL
-
-- id: AC-02
-  name: "无 eval/Function 动态代码执行"
-  severity: warning
-  check_type: deterministic
-  pattern: "grep -c '\\beval\\s*(\\|new Function\\s*(' {file}"
-  description: 禁止使用 eval 和 new Function，防止代码注入
-
-- id: AC-03
-  name: "前端无 innerHTML 赋值（防 XSS）"
-  severity: warning
-  check_type: deterministic
-  pattern: "grep -c '\\.innerHTML\\s*=' {file}"
-  description: 使用 textContent 或框架安全的渲染方式
-
-- id: AC-04
-  name: "无循环内数据库调用（防 N+1）"
-  severity: warning
-  check_type: deterministic
-  pattern: "grep -B3 '\\.save\\|\\.insert\\|\\.update\\|\\.query\\|\\.select' {file} | grep -c 'for\\|while'"
-  description: 循环体内禁止数据库操作，应使用批量操作
-
-- id: AC-05
-  name: "无硬编码的敏感信息"
-  severity: error
-  check_type: deterministic
-  pattern: "grep -ic 'password\\s*=\\s*[\"\\x27]\\|secret\\s*=\\s*[\"\\x27]\\|token\\s*=\\s*[\"\\x27]' {file}"
-  description: 密码/密钥/token 禁止硬编码，必须使用环境变量或密钥管理服务
-
-- id: AC-06
-  name: "文件不超过 500 行"
-  severity: warning
-  check_type: deterministic
-  pattern: "wc -l {file}"
-  description: 超过 500 行的文件应拆分为更小的模块
-
-- id: AC-07
-  name: "无未处理的待办/修复占位标记"
-  severity: warning
-  check_type: deterministic
-  pattern: "grep -c 'T[O]DO\\|F[I]XME\\|H[A]CK\\|X\\{3\\}' {file}"
-  description: TODO/FIXME/HACK/XXX 必须关联 issue 编号或记录为技术债务
-
-- id: AC-08
-  name: "编译无错误和警告"
-  severity: warning
-  check_type: deterministic
-  pattern: "npm run build 2>&1 | grep -c 'error\\|warning'"
-  description: 构建必须零错误零警告
-
-- id: AC-09
-  name: "单元测试覆盖核心逻辑"
-  severity: warning
-  check_type: deterministic
-  pattern: "ls *Test.java *Test.tsx *.test.ts *.spec.ts {dir} 2>/dev/null | wc -l"
-  description: 核心逻辑必须有对应测试文件
-
-- id: AC-10
-  name: "接口变更同步更新了文档或契约定义"
-  severity: warning
-  check_type: deterministic
-  pattern: "grep -c 'swagger\\|openapi\\|ApiOperation\\|@Api' {file}"
-  description: 接口变更必须同步更新 Swagger/OpenAPI 文档
-
-- id: AC-11
-  name: "单元测试覆盖率达标"
-  severity: warning
-  check_type: deterministic
-  pattern: "grep -r 'coverage\\|覆盖率' {dir} | head -3"
-  description: 核心逻辑覆盖率≥80%
-
-- id: AC-12
-  name: "集成测试覆盖关键业务路径"
-  severity: warning
-  check_type: deterministic
-  pattern: "ls *IT.java *IT.test.ts *e2e* {dir} 2>/dev/null | wc -l"
-  description: 关键业务路径必须有集成测试
-
-- id: AC-13
-  name: "配置了监控告警"
-  severity: info
-  check_type: deterministic
-  pattern: "grep -c 'alert\\|告警\\|metrics\\|SLO\\|SLA' {file}"
-  description: 错误率、响应时间等关键指标须配置告警
-
-- id: AC-14
-  name: "有回滚方案和验证清单"
-  severity: warning
-  check_type: deterministic
-  pattern: "grep -c 'rollback\\|回滚\\|revert' {file}"
-  description: 变更必须有回滚方案
-
-- id: AC-15
-  name: "技术文档已更新"
-  severity: info
-  check_type: deterministic
-  pattern: "git diff --name-only {base}..HEAD | grep -c 'README\\|CHANGELOG\\|doc'"
-  description: 接口文档、架构文档须同步更新
-
-- id: AC-16
-  name: "性能满足 SLA 要求"
-  severity: info
-  check_type: deterministic
-  pattern: "grep -c 'performance\\|SLA\\|P99\\|latency\\|benchmark' {file}"
-  description: P99 响应时间、吞吐量须满足 SLA
-
-- id: AC-17
-  name: "日志包含 traceId 支持链路追踪"
-  severity: warning
-  check_type: deterministic
-  pattern: "grep -c 'traceId\\|trace_id\\|TraceId\\|MDC\\|correlationId' {file}"
-  description: 日志必须包含 traceId 支持全链路追踪
-
-- id: AC-18
-  name: "交付物末尾已签署终局宣言"
-  severity: warning
-  check_type: deterministic
-  pattern: "grep -c 'SoloForge Audit: PASS' {file}"
-  description: 掘地三尺契约——终局宣言签署
-
-- id: AC-19
-  name: "验收项覆盖边界场景"
-  severity: warning
-  check_type: semantic
-  pattern: "三重否定推演——空值/极端值/异常输入，非仅 happy path"
-  description: 验收项必须覆盖空值、极端值、异常输入，不得仅验证 happy path
-
-- id: AC-20
-  name: "外部调用包含超时/异常/降级场景"
-  severity: warning
-  check_type: semantic
-  pattern: "链路否定——涉及外部调用时验收项包含超时/异常格式/降级场景"
-  description: 涉及外部调用的验收项必须包含超时、异常格式、降级场景
-
-- id: AC-21
-  name: "测试断言精确度达标"
-  severity: warning
-  check_type: semantic
-  pattern: "变异防造假——精确断言率 >= 50%，无自己证明自己问题"
-  description: 测试断言精确断言率≥50%，禁止"自己证明自己"的弱断言
-
-## 高级验证（可选）
-
-- **变异测试**：核心逻辑≥3 变异体，杀死率≥80%
-- **属性测试**：关键算法≥100 随机用例
-- **安全审查**：输入校验覆盖 CWE-20

package/templates/build//351/207/215/346/236/204/346/226/271/346/241/210.md

@@ -1,61 +0,0 @@
----
-id: ka-artifact_template-重构方案模版
-kind: artifact
-title: 重构方案
-sync_policy: copy_to_project
-status: active
-extra:
-  name: refactoring-plan
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: artifact
-  domain: build
-  stage: build
-  owner_mechanism: mc-generic-artifact
----
-
-# 重构方案文档
-
-## 1. 重构动机
-- 当前问题（坏味道描述 + 量化数据）：
-- 不重构的长期风险：
-
-## 2. 重构目标
-- 目标状态描述：
-- 可衡量的改善指标（圈复杂度/行数/类数）：
-
-## 3. Before/After 对比
-### Before（当前结构）
-- 类/方法职责描述
-- 调用关系图
-- 关键度量（行数、分支数）
-
-### After（重构后结构）
-- 类/方法职责描述
-- 调用关系图
-- 关键度量（预期行数、分支数）
-
-## 4. 实施步骤
-| 步骤 | 变更内容 | 可独立验证 | 回滚方式 |
-|------|---------|-----------|---------|
-| 1 | | | |
-| 2 | | | |
-
-## 5. 风险评估
-- 影响范围（受影响的接口/模块/测试）：
-- 行为等价性保障（如何确认不改变外部行为）：
-- 回滚策略：
-
-## 6. 质量保障检查
-- [ ] 重构是否保持功能等价（有测试用例保障）
-- [ ] 是否分阶段执行（可增量发布，每阶段独立验证）
-- [ ] 是否有回滚方案（每阶段独立可回滚）
-- [ ] 重构是否清理了遗留的待办占位和临时代码
-- [ ] 重构后性能是否有回归测试（基准对比）
-- [ ] 是否更新了相关文档和注释

package/templates/build//351/207/215/346/236/204/346/265/201/346/260/264/347/272/277.md

@@ -1,53 +0,0 @@
----
-id: ka-procedure-重构流水线
-kind: guidance
-title: 重构流水线
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 代码重构
-  - 模块拆分
-  - 模式优化
-  - 提取公共方法
-  - 重构
-  - refactor
-  - 代码改善
-  - 结构优化
-extra:
-  name: refactor-pipeline
-  type: procedure
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  domain:
-    - build
-    - verify
-  verification_layer: L2
-  stage: build
-  owner_mechanism: mc-task-context-lifecycle
----
-
-# 重构管线
-
-## 第1步：现状分析
-识别当前代码的坏味道和重构目标。量化现状（圈复杂度、方法行数、类职责数）。确定重构类型（提取方法/提取类/内联/重命名/搬移/模式替换）。
-模版：重构方案.md
-产出保存到：docs/review/\*\*/*审查*.md
-工具：sf_analyze
-
-## 第2步：方案设计
-定义重构目标和 Before/After 对比。评估影响范围（哪些模块/接口/测试受影响）。识别风险点（破坏性变更风险等级、回归风险）。制定分步执行计划（每步可独立验证）。
-产出保存到：docs/architecture/01-架构设计文档.md
-
-## 第3步：分步实施
-按计划逐步执行重构，每步完成后运行测试确认无回归。禁止一次改多步再验证。保持测试始终可通过（绿色），如需修改测试先确认测试本身正确。
-工具：sf_work action=act
-
-## 第4步：验证验收
-执行全量构建和测试。代码审查重点关注：行为等价性（重构不改变外部行为）、接口兼容性、性能影响。学习记录（重构模式、发现的设计问题）。
-工具：sf_work action=verify, sf_gate

package/templates/build//351/230/262/345/276/241/346/200/247/347/274/226/347/240/201.md

@@ -1,94 +0,0 @@
----
-id: 防御性编码
-kind: guidance
-title: 防御性编码
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 防御性编码
-  - 降级策略
-  - 重试超时
-  - 事务保护
-  - 异常处理
-  - defensive coding
-extra:
-  name: defensive-coding
-  type: constraint
-  scope:
-    - '*'
-  domain: build
-  lifecycle_status: active
-  version: 1.2.0
-  last_reviewed: '2026-06-04'
-  products:
-    - '*'
-  verification_layer: L2
-  stage: build
-  owner_mechanism: mc-existing-system-review
----
-
-# 防御性编码规则
-
-## DEF-OLD-01: 接口降级策略
-  id: DEF-OLD-01
-  name: 接口降级策略
-  severity: error
-  check_type: deterministic
-  check_hint: 老系统接口调用必须有降级/兜底策略
-  description: 必须对老系统接口调用添加降级策略：返回兜底数据或走老逻辑。降级方案须在代码中有明确注释说明触发条件和兜底行为。
-
-## DEF-OLD-02: 重试与超时
-  id: DEF-OLD-02
-  name: 重试与超时
-  severity: error
-  check_type: deterministic
-  check_hint: 重试次数≤3，超时时间必须明确设置
-  description: 老系统接口调用必须有重试策略：最多 3 次，指数退避。超时设置必须明确（不得使用无限超时或默认超时）。
-
-## DEF-EXT-01: try-catch 包裹
-  id: DEF-EXT-01
-  name: try-catch 包裹
-  severity: error
-  check_type: deterministic
-  check_hint: 所有外部服务调用必须有 try-catch 包裹
-  description: 所有外部服务调用（HTTP/RPC/MQ/SDK）必须有 try-catch 包裹，不得将外部异常直接传播到业务逻辑层。
-
-## DEF-EXT-02: 降级方案
-  id: DEF-EXT-02
-  name: 降级方案
-  severity: warning
-  check_type: semantic
-  check_hint: 不可控的外部依赖必须有降级方案
-  description: 不可控的外部依赖（第三方 API、共享服务）必须有降级方案：返回缓存数据、走备用通道、或标记为降级状态。
-
-## DEF-DATA-01: 事务保护
-  id: DEF-DATA-01
-  name: 事务保护
-  severity: error
-  check_type: deterministic
-  check_hint: 写操作必须使用事务
-  description: 涉及多表写入、状态变更、金额操作等写操作必须使用事务保护。事务边界须明确，不得跨 HTTP 调用。
-
-## DEF-DATA-02: 分批处理
-  id: DEF-DATA-02
-  name: 分批处理
-  severity: warning
-  check_type: semantic
-  check_hint: 批量操作必须有分页/分批处理
-  description: 批量操作（批量导入、批量更新、批量删除）必须有分页/分批处理机制，避免单次操作数据量过大导致内存溢出或锁等待。
-
-## DEF-ERR-01: 禁止空 catch
-  id: DEF-ERR-01
-  name: 禁止空 catch
-  severity: error
-  check_type: deterministic
-  check_hint: grep -E 'catch\s*\([^)]*\)\s*\{\s*\}' 匹配 0
-  description: 不允许空 catch 块。catch 块中必须至少包含日志记录或明确的忽略注释。
-
-## DEF-ERR-02: 错误传播
-  id: DEF-ERR-02
-  name: 错误传播
-  severity: error
-  check_type: semantic
-  check_hint: 非预期错误必须向上传播，不得吞异常
-  description: 错误日志必须包含上下文信息（traceId、请求参数、操作类型）。非预期错误必须向上传播，不得在中间层吞异常后返回默认值。

package/templates/build//351/233/206/346/210/220/351/252/214/350/257/201.md

@@ -1,67 +0,0 @@
----
-id: ka-procedure-集成验证流程
-kind: guidance
-title: 集成验证
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 集成测试
-  - 集成验证
-  - E2E测试
-  - 端到端验证
-  - 联调测试
-  - integration test
-  - E2E
-extra:
-  name: integration-verification
-  type: procedure
-  scope:
-    - backend
-    - frontend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.2.0
-  last_reviewed: '2026-06-04'
-  domain:
-    - build
-    - verify
-  verification_layer: L2
-  stage: build
-  owner_mechanism: mc-verifier
----
-
-## 适用场景
-跨 API、页面交互和业务流的增量集成测试，要求真实运行时证据。适用于部署后的端到端验证。
-
-## 步骤
-1. 分析变更影响：哪些接口、页面、DDL、菜单受影响
-2. 发现服务依赖和启动顺序
-3. 构建部署最新代码，验证构建产物新鲜度
-4. 收集运行时证据：API 动态验证、页面快照、控制台、网络请求
-4a. Evidence 级别分类：
-      - E0（不可接受）：dry-run/静态分析/AI 摘要/无运行时证据
-      - E1（最低要求）：API 响应日志/测试输出报告/控制台日志
-      - E2（推荐）：端到端浏览器验证截图 + API 响应 + 数据库状态验证
-      端到端核心业务流程验证（步骤 5）必须达到 E2 级别。
-      API 动态验证（步骤 4）至少达到 E1 级别。
-5. 端到端流程验证：从浏览器页面出发，不绕过前端直接调后端
-6. DDL 迁移必须在浏览器/API 测试前应用到运行数据库
-7. 发现缺陷时：先诊断再修复，修复后重新构建再验证
-8. 构建覆盖矩阵：接口 × 页面交互 × 业务流三维覆盖
-9. 产出偏差报告：每个缺口映射到返回阶段
-
-## 检查点
-- [ ] 变更影响分析仅覆盖本次变更范围
-- [ ] 构建产物新鲜度已验证
-- [ ] API 动态验证和浏览器运行时验证均完成
-- [ ] 端到端流程从浏览器页面出发完成
-- [ ] 菜单变更验证了角色可见性、路由可达、API 可调
-- [ ] 覆盖矩阵达标，偏差报告指定返回阶段
-
-## 注意事项
-- 禁止绕过前端直接调后端 API 做业务流测试
-- 禁止用 SQL 直接写业务测试数据（使用页面操作或业务 API）
-- 禁止在过期构建上测试（新鲜度检查失败必须重新构建）
-- 禁止硬编码测试凭据
-- 禁止接受 dry-run/静态分析/AI 摘要作为通过证据