soloforge 1.1.45 → 1.1.47

package/templates/shared//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,54 +0,0 @@
----
-id: ka-pattern-scope_hook
-kind: knowledge
-title: 作用域与密钥拦截
-sync_policy: internal
-status: active
-extra:
-  name: scope_hook
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-engine-runtime
----
-
-## 决策规则
-
-- 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 能力不可跳过，违反即阻断
-- 降级需经 治理运行时 + 人工确认，提供 escape report 证据

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

@@ -1,55 +0,0 @@
----
-id: ka-pattern-scope_lease
-kind: knowledge
-title: 作用域租约
-sync_policy: internal
-status: active
-extra:
-  name: scope_lease
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-engine-runtime
----
-
-## 决策规则
-
-- 写入文件前必须获取作用域租约（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 测试
-- 降级/禁用需经 治理运行时 + 人工确认

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

@@ -1,55 +0,0 @@
----
-id: ka-pattern-conflict_gate
-kind: knowledge
-title: 冲突门禁
-sync_policy: internal
-status: active
-extra:
-  name: conflict_gate
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-engine-runtime
----
-
-## 决策规则
-
-- 写入前执行 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 测试
-- 降级/禁用需经 治理运行时 + 人工确认

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

@@ -1,61 +0,0 @@
----
-id: ka-pattern-decision_gateway
-kind: knowledge
-title: 决策网关
-sync_policy: internal
-status: active
-extra:
-  name: decision_gateway
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-engine-runtime
----
-
-## 决策规则
-
-- 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，低于此值触发头脑风暴流程补充
-
-## 验收项
-
-- [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 测试
-- 降级/禁用需经 治理运行时 + 人工确认

package/templates/shared//345/210/207/347/211/207/350/201/232/345/220/210/346/243/200/346/237/245.md

@@ -1,72 +0,0 @@
----
-id: slice-aggregate-checks
-kind: enforced
-title: 切片聚合检查
-sync_policy: engine_only
-status: active
-checks:
-  - id: SLC-G01
-    executor: file_scope_check
-    rule: 实际变更文件列表与计划的涉及文件列表一致，无计划外变更
-    gate: slice-gate
-    target: self
-    severity: error
-    check_type: deterministic
-    evidence_required:
-      - git diff --name-only 输出
-      - 切片计划涉及文件列表
-      - 对比结果（须一致）
-  - id: SLC-G02
-    executor: test_count_check
-    rule: 新增测试场景 >=9 个，覆盖正常路径 x2、边界条件 x3、错误路径 x2、集成场景 x2
-    gate: slice-gate
-    target: self
-    severity: error
-    check_type: deterministic
-    evidence_required:
-      - 新增测试场景数（须 >=9）
-      - 覆盖维度统计（正常/边界/错误/集成）
-  - id: SLC-G03
-    executor: lazy_pattern_check
-    rule: 所有检查项无 hard_fail 级别问题，代码中无空函数体、空 catch、未实现占位
-    gate: slice-gate
-    target: self
-    severity: error
-    check_type: deterministic
-    evidence_required:
-      - lazy_pattern_detector 输出（hard_fail=0）
-      - hard_fail 列表（须为空）
-  - id: SLC-G05
-    executor: file_evidence
-    rule: Docker 服务部署成功且 HTTP 可访问（真发请求校验 2xx/3xx）
-    gate: operate-gate
-    target: self
-    severity: error
-    check_type: deterministic
-    evidence_required:
-      - docker ps 输出（容器 Running）
-      - HTTP 响应状态码（须 2xx/3xx）
-      - 响应 body 片段（非空）
-  - id: SLC-G06
-    executor: file_evidence
-    rule: 核心业务正常流程在浏览器中可端到端走通，实际请求与 API 规格一致，页面数据与数据库设计一致
-    gate: operate-gate
-    target: self
-    severity: error
-    check_type: deterministic
-    evidence_required:
-      - Playwright 端到端操作截图序列
-      - 浏览器 Network 请求与 API 规格对照
-      - 页面数据展示与数据库字段对照
-gate: shared-gate
-extra:
-  type: constraint
-  scope:
-    - '*'
-  stage: _global
-  owner_mechanism: mc-stage-gate-engine
----
-
-# slice 阶段聚合检查
-
-收容无单一资产归属的 stage 级 check（如编译/测试/部署证据等）。

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

@@ -1,58 +0,0 @@
----
-id: ka-pattern-mutation_audit
-kind: knowledge
-title: 变异审计
-sync_policy: internal
-status: active
-extra:
-  name: mutation_audit
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-engine-runtime
----
-
-## 决策规则
-
-- 变异白名单: 只变异条件分支（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 测试
-- 降级/禁用需经 治理运行时 + 人工确认

package/templates/shared//345/220/216/347/253/257/345/256/236/347/216/260/345/267/245/347/250/213/345/245/221/347/272/246.md

@@ -1,40 +0,0 @@
----
-id: ka-hard-rule-后端实现工程契约规则
-kind: guidance
-title: 后端实现工程契约
-owner_mechanism: mc-backend-implementation-contract
-sync_policy: copy_to_project
-status: active
-extra:
-  name: backend-implementation-contract
-  scope:
-    - backend
-  products:
-    - '*'
-  type: constraint
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  verification_layer: L2
-  stage: _global
-triggers:
-  - 后端实现
-  - API接口
-  - Controller
-  - 数据库迁移
-  - 写操作
-  - 幂等
-  - 服务端开发
----
-
-## 编码前必须确认
-
-- Controller 只接收 DTO、执行校验、调用应用服务并返回统一响应对象。
-- 写操作的事务、一致性、幂等键、并发冲突处理已定义。
-- 权限、租户隔离、敏感字段与审计日志已定义。
-- OpenAPI、请求/响应字段表、数据库 migration 和错误码有权威对齐依据。
-- 验证计划包含成功、失败、重试、越权、重复提交和边界数据。
-
-## 阻断规则
-
-直接暴露实体、写接口无校验、事务内外部调用、高风险写入无幂等或敏感接口无安全审计证据，均不得交付。

package/templates/shared//345/221/275/344/273/244/346/211/247/350/241/214.md

@@ -1,48 +0,0 @@
----
-id: ka-hard-rule-命令执行规则
-kind: guidance
-title: 命令执行
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 命令执行规则
-extra:
-  name: command-execution
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: constraint
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-command-execution
----
-
-# 命令执行规则
-
-## 核心原则
-
-命令执行必须按副作用分级: 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/shared//345/221/275/344/273/244/350/267/257/347/224/261.md

@@ -1,45 +0,0 @@
----
-id: ka-hard-rule-命令路由规则
-kind: guidance
-title: 命令路由
-owner_mechanism: mc-command-router
-sync_policy: copy_to_project
-status: active
-extra:
-  name: command-routing
-  scope:
-    - '*'
-  products:
-    - '*'
-  type: constraint
-  lifecycle_status: active
-  version: 2.0.0
-  last_reviewed: '2026-06-12'
-  verification_layer: L2
-  stage: _global
----
-
-# 命令路由规则
-
-## 核心原则
-
-命令路由是 SoloForge 的入口裁决机制：用户意图文本经 `routeIntent` 映射到 design / build / verify / operate 四个能力域之一，并返回该域要求的首批产物。`routeIntent` 由 sf_task（start 动作）调用。
-
-## 规则
-
-1. **关键词匹配驱动**：`routeIntent` 遍历静态 `ROUTE_TABLE` 匹配意图关键词，不依赖 NLP 分类
-2. **4 能力域裁决**：每次路由必须返回有效的 `domain`（design / build / verify / operate 之一）
-3. **默认降级**：无关键词匹配时默认路由到 design 域（先想清楚再做），不阻断主链路
-4. **首批产物**：路由结果 `required_artifacts` 由对应域契约的 `required` 产物推导
-5. **纯计算**：`routeIntent` 是纯函数，无副作用，不读写任务状态
-
-## 域触发关键词（ROUTE_TABLE）
-
-| 能力域 | 触发关键词 |
-|--------|-----------|
-| design（设计） | 做新系统 / 加新功能 / 设计方案 / 架构 / 需求 / 设计 / 规划 / 分析 |
-| build（构建） | 写代码 / 实现 / 编码 / 改bug / 修bug / 修复 / 开发 / 重构 |
-| verify（验证） | 审查 / 验证 / 测试 / 检查 / 确认 / review / 验收 |
-| operate（运维） | 部署 / 上线 / 发布 / 运维 / 监控 / 扩容 / 回滚 / 线上 |
-
-> 关键词权威来源：`src/core/intent_router.ts` 的 `ROUTE_TABLE`，由 `check:schema-enum` 门禁保证与 `DomainName` 枚举一致。

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

@@ -1,54 +0,0 @@
----
-id: ka-pattern-regression_matrix
-kind: knowledge
-title: 回归矩阵
-sync_policy: internal
-status: active
-extra:
-  name: regression_matrix
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-engine-runtime
----
-
-## 决策规则
-
-- 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 测试
-- 降级/禁用需经 治理运行时 + 人工确认

package/templates/shared//345/244/232/347/247/237/346/210/267.md

@@ -1,49 +0,0 @@
----
-id: ka-domain_knowledge-multi-tenancy
-kind: knowledge
-title: 多租户
-sync_policy: copy_to_project
-status: active
-extra:
-  updated_at: '2026-06-15'
-  name: multi-tenancy
-  scope:
-    - backend
-  products:
-    - saas
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-domain-knowledge
----
-
-## 业务规则
-1. 每个租户的数据完全隔离，租户 A 不能看到租户 B 的任何数据
-2. 所有查询必须自动附加租户过滤条件，不依赖开发人员手动添加
-3. 租户切换需重新认证，不支持跨租户操作
-4. 租户级配置（功能开关、字段自定义）独立管理
-5. 租户间数据必须物理隔离（独立 schema/库）或逻辑隔离（tenant_id 字段 + 全局过滤）
-6. 租户配置（功能开关、参数）必须支持按租户覆盖全局默认值
-7. 新增租户必须自动初始化基础数据（角色、权限、默认菜单）
-
-## 约束条件
-- 数据库层面使用 tenant_id 字段实现行级隔离（共享数据库方案）
-- MyBatis 拦截器自动注入 tenant_id 条件，禁止绕过拦截器直接写 SQL
-- 新建表必须包含 tenant_id 字段并建立索引
-- 超级管理员可跨租户查看数据，但需审计日志记录
-- 租户 ID 必须在所有业务表中存在，且建立索引
-- 跨租户数据查询必须显式声明并经过审批
-- 租户数据删除必须级联清理所有关联数据
-
-## 例外情况
-- 系统级配置表（如地区、行业分类）不需要 tenant_id
-- 数据统计聚合（如系统总用户数）需脱敏处理后统计
-- 系统管理后台（超管）允许跨租户操作
-
-## 关联模式
-参见 auth-permission 模式（权限模型与租户关联）、logging 模式（日志需记录 tenantId）
-- auth-permission
-- data-privacy

package/templates/shared//345/256/241/350/256/241/346/227/245/345/277/227.md

@@ -1,46 +0,0 @@
----
-id: ka-domain_knowledge-audit-logging
-kind: knowledge
-title: 审计日志
-sync_policy: copy_to_project
-status: active
-extra:
-  name: audit-logging
-  scope:
-    - backend
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: knowledge
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-domain-knowledge
----
-
-## 业务规则
-1. 所有关键业务操作（创建、修改、删除、导出、权限变更）必须记录审计日志
-2. 审计日志不可修改和删除（append-only），至少保留 3 年
-3. 每条审计日志必须包含：操作人、操作时间、操作类型、操作对象、变更前后数据
-4. 敏感操作（删除、权限变更、导出）需额外通知管理员
-5. 审计日志查询必须支持按时间范围、操作人、操作类型、目标对象筛选
-6. 审计日志必须记录操作来源（Web/API/定时任务/系统），便于问题追溯
-7. 批量操作必须合并为一条审计记录，包含操作数量和关键参数
-
-## 约束条件
-- 审计日志存储在独立表中（audit_log），不与业务数据混存
-- 通过 AOP 切面自动记录，减少开发人员手动埋点
-- 变更前后数据使用 JSON 格式存储（before/after 字段）
-- 审计日志表不支持 UPDATE 和 DELETE（数据库层权限控制）
-- 审计日志保留期限必须符合合规要求（如 ≥ 180 天）
-
-## 例外情况
-- 查询操作（GET）一般不记录审计日志（除导出操作）
-- 系统内部自动任务的操作记录标注为"系统"操作人
-- 批量操作合并为一条审计记录（含数量信息）
-
-## 关联模式
-参见 logging 模式（日志记录规范）、error-handling 模式（异常处理与审计）
-- logging
-- data-privacy