soloforge 1.1.46 → 1.1.48

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

@@ -1,54 +0,0 @@
----
-id: ka-pattern-resume_workspace
-kind: knowledge
-title: 工作区唤醒
-sync_policy: internal
-status: active
-extra:
-  name: resume_workspace
-  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
----
-
-## 决策规则
-
-- 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 测试
-- 降级/禁用需经 治理运行时 + 人工确认

package/templates/shared//345/267/245/344/275/234/346/265/201/345/245/221/347/272/246.md

@@ -1,42 +0,0 @@
----
-id: ka-hard-rule-工作流契约规则
-kind: guidance
-title: 工作流契约
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 工作流契约规则
-extra:
-  name: workflow-contract
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: constraint
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-workflow-contract
----
-
-# 工作流契约规则
-
-## 核心原则
-
-每个工作流必须声明所需机制、知识注入要求和权限边界。工作流契约确保编排路径可验证。
-
-## 规则
-
-1. **机制声明**: 每个工作流必须声明 required_mechanisms
-3. **权限一致性**: read-only 工作流不可产生 mutation
-4. **入口回归**: 每个路由必须有对应的工作流
-5. **范围回归**: 工作流 scope 必须覆盖所有产出文件
-
-## 验收标准
-
-- [ ] 每个工作流有 required_mechanisms 列表
-- [ ] 知识注入机制被所有工作流引用
-- [ ] read-only 工作流无 mutation 产出
-- [ ] validateWorkflowContracts() 返回 0 hard_fail

package/templates/shared//345/267/245/344/275/234/346/265/201/345/274/225/346/223/216.md

@@ -1,50 +0,0 @@
----
-id: ka-domain_knowledge-workflow-engine
-kind: knowledge
-title: 工作流引擎
-sync_policy: copy_to_project
-status: active
-extra:
-  name: workflow-engine
-  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
----
-
-## 业务规则
-- 每个审批节点必须定义：审批人/角色、超时时间、超时自动动作（自动通过/自动驳回/升级）
-- 审批状态流转必须完整：待提交→审批中→通过/驳回/撤回/终止，禁止出现不可解释的中间状态
-- 并行审批（会签）必须定义：全部通过/一票通过/一票否决/比例通过策略
-- 驳回必须明确回到哪个节点：发起人/上一节点/指定节点
-- 审批记录必须完整保留：谁在什么时间审批了什么结果、意见是什么
-- 审批权限必须校验：只有指定的审批人可以审批，禁止越权操作
-- 工作流定义必须支持版本管理，修改后不影响已发起的流程实例
-- 流程节点必须支持超时处理（自动流转/催办/升级），防止流程卡住
-- 流程回退必须回到指定节点而非直接退回起始节点
-
-## 约束条件
-- 审批流定义与业务逻辑解耦，禁止在业务代码中硬编码审批步骤
-- 审批超时提醒必须有通知机制（站内信/邮件/钉钉）
-- 审批历史数据禁止物理删除，只能归档
-- 审批中的业务数据禁止修改（如需修改须先撤回再提交）
-- 流程变量大小必须限制（如单个变量 ≤ 4KB），防止流程引擎性能问题
-- 流程发起人必须有权限校验，不是所有用户都能发起所有流程
-
-## 例外情况
-- 紧急审批可设置简化流程（减少审批节点），但必须有事后补审机制
-- 系统管理员可查看所有审批记录，但不可代为审批
-- 紧急流程可以跳过非必要审批节点（需配置紧急通道权限）
-
-## 关联模式
-- [[state-transition]] 状态机流转
-- [[auth-permission]] 审批权限控制
-- state-flow
-- auth-permission

package/templates/shared//345/267/245/344/275/234/346/265/201/346/250/241/347/211/210/345/214/205.md

@@ -1,34 +0,0 @@
----
-id: ka-hard-rule-工作流模版包规则
-kind: guidance
-title: 工作流模版包
-owner_mechanism: mc-workflow-template-pack
-sync_policy: internal
-status: active
-extra:
-  name: workflow-template-pack
-  scope:
-    - '*'
-  products:
-    - '*'
-  type: constraint
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  verification_layer: L2
-  stage: _global
----
-
-# 工作流模版包规则
-
-## 硬规则
-
-1. **模版消费 pipeline 必须完整** — missing → file_created → indexed → registered → injected → consumed → verified
-2. **不可停在中间状态** — 模版消费不可卡在 registered 而不 injected
-3. **消费证据必须记录** — 每次状态推进都需要证据
-
-## 检查项
-
-- [ ] 模版消费 pipeline 完整
-- [ ] 无中间状态停滞
-- [ ] 消费证据已记录

package/templates/shared//345/267/245/345/205/267/350/260/203/347/224/250.md

@@ -1,48 +0,0 @@
----
-id: ka-hard-rule-工具调用规则
-kind: guidance
-title: 工具调用
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 工具调用规则
-extra:
-  name: tool-invocation
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: constraint
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-tool-invocation-contract
----
-
-# 工具调用规则
-
-## 核心原则
-
-MCP 工具调用必须遵守契约约束: 工具链顺序、权限等级、禁止转换。
-
-## 工具分类
-
-1. **strict_controlled**: 严格管控工具，需要前置审批
-2. **read_only_bypass**: 只读工具，可自由调用
-3. **normal_controlled**: 常规管控工具，需遵守转换规则
-
-## 规则
-
-1. 每个工具必须声明 default_next_tools 和 forbidden_next_tools
-2. forbidden_next_tools 中的转换必须被阻断
-3. strict_controlled 工具不可跳过审批流程
-4. 工具调用链必须可追踪 (tool_trace)
-
-## 验收标准
-
-- [ ] 所有 MCP 工具在 Tool Invocation Contract Registry 中已注册
-- [ ] forbidden_next_tools 转换被正确阻断
-- [ ] validateToolInvocation() 返回 0 hard_fail
-- [ ] tool_trace 包含完整调用链

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

@@ -1,57 +0,0 @@
----
-id: ka-pattern-concurrency_lock
-kind: knowledge
-title: 并发锁
-sync_policy: internal
-status: active
-extra:
-  name: concurrency_lock
-  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
----
-
-## 决策规则
-
-- 人类主权高于 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 测试
-- 降级/禁用需经 治理运行时 + 人工确认

package/templates/shared//346/211/247/350/241/214/345/256/210/345/215/253/350/257/204/344/274/260.md

@@ -1,47 +0,0 @@
----
-id: ka-hard-rule-执行守卫评估规则
-kind: guidance
-title: 执行守卫评估
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 执行守卫评估规则
-extra:
-  name: execution-guard-assessment
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: constraint
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-guard-evaluation
----
-
-# 执行守卫评估规则
-
-## 核心原则
-
-执行守卫评估是 SoloForge 验证阶段的关键机制。它在 sf_gate 时评估各契约守卫的执行状态，确保验证计划覆盖所有必要的检查。
-
-## 规则
-
-1. **守卫覆盖**: 验证计划必须覆盖所有相关契约的守卫（隐私、命令、scope、artifact）
-2. **评估集成**: 守卫评估集成在各契约的验证逻辑内，不独立执行
-3. **结果传导**: 守卫评估失败必须传导到 VerificationResult，影响最终状态判定
-4. **降级安全**: 守卫评估不可用时，验证应降级为 advisory 而非跳过
-
-## 失败模式
-
-- 验证计划缺少隐私守卫 → 应在 generateVerifyCommands 中补充
-- 守卫评估结果被忽略 → 应传导到 sf_work action=verify 状态判定
-- 守卫降级未通知用户 → 应通过 user_feedback 通知
-
-## 验收标准
-
-- [ ] generateVerifyCommands 包含隐私和命令守卫评估
-- [ ] 守卫评估失败时 core_principles.overall_passed 为 false
-- [ ] sf_work action=verify 正确处理守卫评估失败的状态转移

package/templates/shared//346/211/251/345/261/225/347/224/237/345/221/275/345/221/250/346/234/237.md

@@ -1,34 +0,0 @@
----
-id: ka-hard-rule-扩展生命周期规则
-kind: guidance
-title: 扩展生命周期
-owner_mechanism: mc-extension-contract
-sync_policy: internal
-status: active
-extra:
-  name: extended-lifecycle
-  scope:
-    - '*'
-  products:
-    - '*'
-  type: constraint
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  verification_layer: L2
-  stage: _global
----
-
-# 扩展生命周期规则
-
-## 硬规则
-
-1. **第三方扩展不可自称 enforced** — 只有内置机制可以是 enforced 状态
-2. **高风险权限必须审批** — 文件写入、命令执行等权限需显式授权
-3. **生命周期转移必须合法** — registered → active → disabled → removed，不可跳跃
-
-## 检查项
-
-- [ ] 扩展 manifest 格式正确
-- [ ] 权限声明完整
-- [ ] 生命周期转移合法

package/templates/shared//346/212/200/346/234/257/345/206/263/347/255/226/344/270/273/346/235/203.md

@@ -1,50 +0,0 @@
----
-id: ka-hard-rule-技术决策主权规则
-kind: guidance
-title: 技术决策主权
-owner_mechanism: mc-decision-sovereignty
-sync_policy: copy_to_project
-status: active
-extra:
-  name: technology-decision-sovereignty
-  scope:
-    - '*'
-  products:
-    - '*'
-  type: constraint
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  verification_layer: L2
-  stage: _global
-triggers:
-  - 技术选型
-  - 架构变更
-  - 数据模型
-  - 外部依赖
-  - 引入依赖
-  - 技术决策
----
-
-# 技术决策主权规则
-
-## hard_rules
-
-- 不确定项必须给出推荐（recommendation）、理由（reasoning）、备选（alternatives）、风险（risks），并进入用户确认或计划闭环。
-- 决策状态流：proposed → recommended → confirmed / rejected / deferred。只有 `confirmed` 状态允许执行。
-- 高影响决策（架构变更、数据模型修改、外部依赖引入）必须经过 human gate 确认，不得自动执行。
-- 推荐状态（recommended）不得直接执行，必须转为 confirmed（含人类签署证据）后方可实施。
-- 用户项目中技术选型、目录确认、架构不确定项、风险动作都必须可消费该机制规则。
-
-## not_done_if_missing
-
-- 高风险无 human gate 自动执行 → hard fail。
-- heuristic 单独支撑高影响决策 → hard fail。
-- 不确定项只报告不给推荐和理由 → hard fail。
-- 推荐状态绕过确认直接执行 → hard fail。
-
-## verification_evidence
-
-- `TechnologyDecisionContract` 包含 decision_scope、recommendation、reasoning、alternatives、risks 字段。
-- `validateTechnologyDecision()` 检查 human gate 对高影响决策的必需性。
-- `diagnostic_codes`: no-human-gate, executing-recommended, missing-recommendation。

package/templates/shared//346/212/245/350/241/250/347/273/237/350/256/241.md

@@ -1,50 +0,0 @@
----
-id: ka-domain_knowledge-report-statistics
-kind: knowledge
-title: 报表统计
-sync_policy: copy_to_project
-status: active
-extra:
-  name: report-statistics
-  scope:
-    - backend
-    - frontend
-  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
----
-
-## 业务规则
-- 统计数据必须注明统计口径（时间范围、数据来源、计算规则、排除条件）
-- 统计维度变更必须记录历史，保证趋势数据的可比性
-- 实时看板数据必须定义刷新频率和数据延迟容忍度
-- 导出报表必须包含：生成时间、数据截止时间、统计口径说明
-- 敏感数据统计（金额、人数）必须有权限控制，禁止无权限查看汇总数据
-- 报表查询必须支持时间范围筛选，默认查询最近 30 天
-- 大数据量报表必须使用异步生成 + 下载方式，禁止同步等待
-- 报表数据必须与业务数据来源一致，禁止报表查询绕过业务逻辑直接读库
-
-## 约束条件
-- 统计查询禁止直接查询业务主表，必须使用汇总表或物化视图
-- 大时间范围统计必须支持分页或分段加载，禁止一次返回全量
-- 图表颜色方案必须统一，禁止同一报表使用不一致的配色
-- 统计接口响应时间目标 < 3 秒，超过时必须使用预计算/缓存
-- 报表生成时间超过 30 秒必须改为异步模式
-- 报表缓存必须设置过期时间，避免展示过期数据
-
-## 例外情况
-- 管理层汇总看板可使用 T+1 数据（次日更新）
-- 临时统计需求可走 SQL 直查，但须标注"非正式统计"
-- 实时看板类报表允许少量延迟（秒级），不要求强一致性
-
-## 关联模式
-- [[caching]] 统计数据缓存
-- [[n-plus-one-query]] 统计查询优化
-- caching
-- async-export

package/templates/shared//346/224/257/344/273/230.md

@@ -1,51 +0,0 @@
----
-id: ka-domain_knowledge-payment-rules
-kind: knowledge
-title: 支付
-sync_policy: copy_to_project
-status: active
-extra:
-  name: payment-rules
-  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
----
-
-## 业务规则
-- 支付操作必须幂等：同一笔订单不可重复扣款，支付回调必须做幂等校验（支付流水号唯一约束）
-- 支付状态必须明确：待支付→支付中→支付成功→支付失败→已关闭，不可跳跃
-- 金额计算禁止使用浮点数，必须使用 BigDecimal 或整数分（1 元 = 100 分）
-- 退款金额不得超过实付金额，部分退款累计不得超过实付金额
-- 支付超时未支付订单必须自动关闭（建议 30 分钟），释放库存等占用资源
-- 对账机制：每日定时与第三方支付平台对账，差异记录必须有告警和人工处理流程
-- 支付金额必须校验精度（使用 BigDecimal，禁止 float/double），防止精度丢失
-- 支付状态必须通过主动查询支付网关确认，不能只依赖回调通知
-- 退款必须支持部分退款和全额退款，退款总额不能超过支付总额
-
-## 约束条件
-- 支付密钥必须加密存储，禁止明文配置
-- 支付回调接口必须验证签名，禁止无签名校验直接处理
-- 支付流水表独立于业务表，禁止与订单表耦合
-- 支付敏感操作必须有审计日志（操作人、时间、金额、状态变更）
-- 支付操作必须记录完整流水（请求、响应、回调），便于对账和纠纷处理
-- 支付超时时间必须与支付网关一致（如 30 分钟），超时自动关闭订单
-- 同一笔支付必须防止重复扣款（幂等性），使用支付流水号去重
-
-## 例外情况
-- 测试环境使用沙箱支付，禁止真实交易
-- 充值卡/优惠券抵扣不走第三方支付，但走相同的金额计算和审计规则
-- 银行卡支付按 T+1 到账处理，必须通过异步回调或对账任务确认最终状态
-
-## 关联模式
-- [[concurrency-control]] 并发扣款控制
-- [[transaction-pattern]] 支付事务保障
-- crud-operation
-- concurrency

package/templates/shared//346/225/217/346/204/237/344/277/241/346/201/257/345/244/204/347/220/206.md

@@ -1,77 +0,0 @@
----
-id: ka-hard-rule-敏感信息处理规则
-kind: guidance
-title: 敏感信息处理
-sync_policy: copy_to_project
-status: active
-triggers:
-  - 敏感信息
-  - 密钥
-  - 密码
-  - token
-  - 脱敏
-  - 凭证
-  - 数据安全
-extra:
-  name: sensitive-information-handling
-  scope:
-    - '*'
-  products:
-    - '*'
-  lifecycle_status: active
-  version: 1.1.0
-  last_reviewed: '2026-06-01'
-  type: constraint
-  verification_layer: L2
-  stage: _global
-  owner_mechanism: mc-privacy-boundary
----
-
-# 敏感信息处理规则
-
-## 核心原则
-
-敏感信息 (密钥、token、PII) 不可泄露到外部材料、prompt 或日志中。
-
-## 规则
-
-1. .env 文件中的值不可作为知识注入 prompt
-2. token/secret 必须在写入前被 detectSecrets 扫描
-3. severity=blocked 的发现必须阻断写入
-4. 外部材料摄取必须经过脱敏处理
-5. DataAccessGrant 必须明确声明数据访问权限
-
-## 验收标准
-
-- [ ] detectSecrets 扫描所有写入内容
-- [ ] severity=blocked 的发现阻断写入流程
-- [ ] RedactionRecord 记录所有脱敏操作
-- [ ] DataAccessGrant 覆盖所有数据访问
-
-## 日志脱敏规则
-
-以下字段必须脱敏或禁止输出到任何日志通道：
-
-### P0 阻断（发现即 hard_fail）
-- password / passwd / pwd：禁止明文输出
-- token / api_key / access_key / secret_key / private_key：禁止明文输出
-- cookie / session_id / set_cookie：禁止输出完整值
-- 身份证号：禁止输出 15/18 位全量
-- 手机号：禁止输出 11 位全量
-- 银行卡号：禁止输出全量
-- 健康隐私信息（病历、诊断、处方）
-
-### 脱敏要求
-- 手机号：仅显示前 3 后 4（如 `138****5678`）
-- 身份证：仅显示前 3 后 4（如 `310***********1234`）
-- 银行卡：仅显示后 4 位（如 `****5678`）
-- token/密钥：仅显示前 4 位或哈希值
-
-### 检查范围
-- 用户项目代码中的日志输出语句
-- 不检查测试文件中的 fixture 或 mock
-- 不检查 SoloForge 自身日志（已有独立治理）
-
-### 误判防范
-- 变量名含 password 但实际是布尔标志（如 requires_password）不误判
-- 仅检查实际输出到日志的值，不检查声明和赋值

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

@@ -1,53 +0,0 @@
----
-id: ka-pattern-secret_scan
-kind: knowledge
-title: 敏感信息扫描
-sync_policy: internal
-status: active
-extra:
-  name: secret_scan
-  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
----
-
-## 决策规则
-
-- 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 能力不可跳过，违反即阻断
-- 降级需经 治理运行时 + 人工确认，提供 escape report 证据