soloforge 1.3.0 → 1.3.1

package/templates/knowledge/acceptance_templates//346/225/260/346/215/256/345/272/223/350/256/276/350/256/241/346/226/207/346/241/243/346/250/241/347/211/210.md

@@ -0,0 +1,59 @@
+---
+name: 数据库设计文档模版
+id: ka-artifact_template-database-design
+asset_kind: artifact_template
+lifecycle_status: active
+authority: supporting
+scope:
+  - backend
+products:
+  - '*'
+routes:
+  - artifact_generation
+primary_triggers:
+  - 数据库设计文档
+priority: P1
+specificity: 4
+version: 1.0.0
+last_reviewed: '2026-05-25'
+owner_mechanism_id: mc-design-artifact-pack
+consumes:
+  - docs/architecture/00-架构决策记录.md
+  - docs/architecture/01-架构设计文档.md
+emits:
+  - docs/architecture/02-数据库设计文档.md
+  - db/migrations
+  - db/schema
+required_evidence:
+  - executable_sql_or_migration
+  - api_database_traceability
+type: acceptance_template
+status: active
+---
+
+# 数据库设计文档
+
+## 1. 目标数据库与权威 SQL
+
+| 项目 | 内容 |
+|------|------|
+| 数据库及版本 | |
+| SQL/migration 权威路径 | |
+| 执行验证命令及结果 | |
+
+## 2. 实体与关系
+
+## 3. 表字段与敏感级别
+
+| 表 | 字段 | 类型 | 可空 | 默认值 | 业务含义 | 敏感级别 | 生命周期 |
+|----|------|------|------|--------|----------|----------|----------|
+
+## 4. 约束、索引与查询场景
+
+## 5. 租户、安全、审计与数据生命周期
+
+## 6. Migration、回滚、备份恢复
+
+## 7. API/DTO 至字段追踪矩阵
+
+## 8. 真实验证证据与未决项

package/templates/knowledge/acceptance_templates//346/236/266/346/236/204/350/256/276/350/256/241/346/250/241/347/211/210.md

@@ -32,35 +32,55 @@ status: active
 
 # 架构设计文档
 
-## 1. 需求概要
+## 1. 决策记录、范围与证据
+- 架构决策记录引用：`docs/architecture/00-架构决策记录.md`
+- 用户确认引用：
+- 输入证据引用：
+
+## 2. 六类架构决策状态总表
+
+| 架构域 | 状态 | 结论 | decision_id | user_confirmation_ref | 影响产物 |
+|--------|------|------|-------------|-----------------------|----------|
+
+## 3. 需求概要
 - 业务背景：
 - 核心需求：
 - 非功能需求（性能/安全/可用性）：
 
-## 2. 模块划分
+## 4. 模块划分
 - 模块清单与职责边界
 - 模块间依赖关系图
 - 核心接口契约（模块间调用方式）
 
-## 3. 数据流向
+## 5. 业务流程、数据流向与关键 Mermaid 时序图
 - 主流程数据流向图
 - 关键数据结构定义
 - 数据存储方案（数据库/缓存/文件）
 
-## 4. 技术选型与依据
+## 6. 前端、后端、安全与基础设施架构
+
+## 7. 技术选型与依据
 | 技术决策 | 候选方案 | 最终选择 | 选择理由 | 放弃方案原因 |
 |---------|---------|---------|---------|------------|
 |         |         |         |         |            |
 
-## 5. 状态机定义
+## 8. 数据库与 API 专项产物引用
+- 数据库设计：`docs/architecture/02-数据库设计文档.md`
+- API 规格：`docs/architecture/03-API接口规格文档.md`
+- OpenAPI：`docs/api/openapi.yaml`
+- SQL/migration：
+
+## 9. 状态机定义
 - 核心业务状态流转
 - 触发条件、守卫条件、失败/回滚动作
 
-## 6. 风险点与应对
+## 10. 非功能需求、验证策略、风险与回滚
 | 风险 | 影响 | 概率 | 应对方案 |
 |------|------|------|---------|
 |      |      |      |         |
 
-## 7. 扩展点
+## 11. 未决项、延期影响和变更追踪
+
+## 12. 扩展点
 - 已识别的未来扩展方向
 - 预留的扩展机制（接口/配置/插件）

package/templates/knowledge/acceptance_templates//350/256/276/350/256/241/344/270/200/350/207/264/346/200/247/351/252/214/346/224/266/346/212/245/345/221/212/346/250/241/347/211/210.md

@@ -0,0 +1,47 @@
+---
+name: 设计一致性验收报告模版
+id: ka-artifact_template-design-consistency-report
+asset_kind: artifact_template
+lifecycle_status: active
+authority: supporting
+scope:
+  - all
+products:
+  - '*'
+routes:
+  - artifact_generation
+primary_triggers:
+  - 设计一致性验收报告
+priority: P1
+specificity: 4
+version: 1.0.0
+last_reviewed: '2026-05-25'
+owner_mechanism_id: mc-design-artifact-pack
+consumes:
+  - docs/architecture/00-架构决策记录.md
+  - docs/architecture/01-架构设计文档.md
+  - docs/architecture/02-数据库设计文档.md
+  - docs/architecture/03-API接口规格文档.md
+  - docs/api/openapi.yaml
+emits:
+  - docs/architecture/99-设计一致性验收报告.md
+required_evidence:
+  - design_artifact_pack_verification
+  - cross_document_consistency
+type: acceptance_template
+status: active
+---
+
+# 设计一致性验收报告
+
+## 产物清单与 Hash
+
+## 用户确认与决策引用
+
+## SQL / OpenAPI / 文档验证结果
+
+## 跨产物追踪与冲突处理
+
+## Implementation Readiness 结论
+
+## 残余风险与返工要求

package/templates/knowledge/procedures//346/236/266/346/236/204/345/206/263/347/255/226/347/240/224/350/256/250/345/267/245/344/275/234/346/265/201.md

@@ -0,0 +1,51 @@
+---
+name: architecture-decision-workshop
+type: procedure
+when: '架构设计, 技术架构, 系统设计, 平台建设, 服务拆分'
+scope:
+  - backend
+  - frontend
+  - infrastructure
+products:
+  - '*'
+owner_mechanism_id: mc-architecture-decision-workshop
+id: ka-procedure-architecture-decision-workshop
+asset_kind: procedure
+lifecycle_status: active
+authority: canonical
+routes:
+  - artifact_generation
+primary_triggers:
+  - 架构决策研讨
+priority: P0
+specificity: 5
+version: 1.0.0
+last_reviewed: '2026-05-25'
+required_evidence:
+  - architecture_decision_workshop
+  - user_confirmation_ref
+consumes:
+  - user_intent
+  - project_context_detection
+  - existing_system_analysis
+emits:
+  - architecture_decision_workshop
+  - docs/architecture/00-架构决策记录.md
+status: active
+---
+
+# 架构决策研讨工作流
+
+## 顺序
+
+1. 判断项目为现有系统、新系统、空项目或重构升级。
+2. 现有系统先获取现状与差距证据；空项目先确认业务目标和约束。
+3. 默认按业务流程、数据、安全、后端、前端、基础设施逐域讨论。
+4. 每域提供方案、推荐、风险与需要确认的问题；确认后记录 decision ref。
+5. 全部必要域确认后生成 `docs/architecture/00-架构决策记录.md`。
+6. 仅以该决策记录驱动正式架构设计与设计产物包。
+
+## 失败处理
+
+- 缺证据、缺确认或决策返工时，停止生成正式文档并说明下一项待决事项。
+- 不得用模板默认值或模型偏好替代项目事实与用户决定。

package/templates/knowledge/procedures//346/236/266/346/236/204/350/256/276/350/256/241/345/267/245/344/275/234/346/265/201.md

@@ -10,6 +10,8 @@ products:
   - '*'
 owner_mechanism_id: mc-architecture-design
 consumed_contracts:
+  - architecture_decision_workshop_contract
+  - design_artifact_pack_contract
   - architecture_design_contract_entry
   - technology_decision_contract
   - brainstorm_contract
@@ -24,6 +26,8 @@ required_sections:
   - Mermaid 图要求
   - 架构设计审查
 hard_rules:
+  - 正式架构设计前必须完成六类架构决策研讨并引用用户确认的决策记录
+  - 架构设计必须进入包含数据库、API、OpenAPI/SQL 和一致性报告的设计产物包复验流程
   - 输出目录名必须给推荐并进入用户确认；未确认时不得 delivered
   - 后端必须默认优先 Java，除非存在项目证据或用户确认 override
   - 前端必须默认优先最新稳定 Vue 生态 + TypeScript，除非存在项目证据或用户确认 override
@@ -69,27 +73,32 @@ status: active
 
 ## 步骤
 1. **输入集确认**: 识别所有 task-* 目录下的原型说明及需求文档，确认覆盖所有端
-2. **输出目录决策**: 给出推荐目录名，等待用户确认
-3. **技术栈策略**:
+2. **架构决策研讨**: 逐域闭合业务流程、数据、安全、后端、前端和基础设施决策，生成 `00-架构决策记录.md`
+3. **输出目录决策**: 给出推荐目录名，等待用户确认
+4. **技术栈策略**:
    - 后端默认 Java 优先（项目证据或用户确认可 override）
    - 前端默认最新稳定 Vue 生态 + TypeScript（语言、构建工具、路由、状态管理、接口类型、测试、lint/format）
    - 项目已有技术栈优先于 SoloForge 默认
-4. **前端仓库策略**: 不同前端端默认不同仓库；合并仓库需用户确认
-5. **不确定项决策**: 每个不确定项包含推荐、理由、备选、风险和用户确认问题
-6. **架构级不确定项**: 接入 Brainstorm → Decision Sovereignty → User Confirmation
-7. **Mermaid 图**: 关键业务流程、登录鉴权、跨端协作、前后端交互、异步任务必须有 sequenceDiagram
-8. **架构设计审查**: reviewArchitectureDesign 验证所有硬规则通过
+5. **前端仓库策略**: 不同前端端默认不同仓库；合并仓库需用户确认
+6. **不确定项决策**: 每个不确定项包含推荐、理由、备选、风险和用户确认问题
+7. **架构级不确定项**: 接入 Brainstorm → Decision Sovereignty → User Confirmation
+8. **设计产物包**: 架构、数据库、API、OpenAPI/SQL 和一致性报告按权威来源联动生成/升级
+9. **Mermaid 图**: 关键业务流程、登录鉴权、跨端协作、前后端交互、异步任务必须有 sequenceDiagram
+10. **架构设计审查**: reviewArchitectureDesign 与 DesignArtifactPack 真实复验通过
 
 ## 检查点
 - [ ] 所有 task-* 输入已识别并覆盖
+- [ ] 六类架构决策均已确认并记录 decision refs
 - [ ] 输出目录已用户确认
 - [ ] 技术栈有项目证据或用户确认支撑
 - [ ] 不确定项全部有推荐和用户确认问题
 - [ ] Mermaid sequenceDiagram 覆盖关键流程
 - [ ] reviewArchitectureDesign passed
+- [ ] 设计产物包进入 implementation_ready
 
 ## 禁止退化
 - 未确认目录不得 delivered
 - 缺少 Mermaid 图不得 completed
+- 六类决策未确认或设计产物包未复验不得 completed
 - 架构级决策无 human gate 不得 approved
 - 模板章节缺失不得 completed

package/templates/knowledge/procedures//350/256/276/350/256/241/344/272/247/347/211/251/347/224/237/346/210/220/344/270/216/345/244/215/351/252/214/345/267/245/344/275/234/346/265/201.md

@@ -0,0 +1,45 @@
+---
+name: design-artifact-pack-workflow
+type: procedure
+when: '架构设计文档, 数据库设计文档, API接口规格文档, 设计文档升级'
+scope:
+  - backend
+  - frontend
+  - infrastructure
+products:
+  - '*'
+owner_mechanism_id: mc-design-artifact-pack
+id: ka-procedure-design-artifact-pack
+asset_kind: procedure
+lifecycle_status: active
+authority: canonical
+routes:
+  - artifact_generation
+primary_triggers:
+  - 设计产物包
+priority: P0
+specificity: 5
+version: 1.0.0
+last_reviewed: '2026-05-25'
+required_evidence:
+  - design_artifact_pack
+  - consistency_verification
+consumes:
+  - architecture_decision_workshop
+  - docs/architecture/00-架构决策记录.md
+  - existing_design_artifacts
+emits:
+  - design_artifact_pack
+  - docs/architecture/99-设计一致性验收报告.md
+  - implementation_ready
+status: active
+---
+
+# 设计产物生成与复验工作流
+
+1. 消费已经用户确认的架构决策记录。
+2. 新项目生成架构、数据库、API、OpenAPI、SQL/migration 及一致性报告。
+3. 现有文档先标记为需要复验，输出差距和待确认变化，不静默覆盖。
+4. 用户确认后归档旧版本并写入修订产物。
+5. 读取真实文件验证 API 字段、SQL 可执行性和跨文档追踪一致性。
+6. 全部通过后才标记为 `implementation_ready`，供后续编码和交付消费。

package/templates/knowledge/rules//345/267/245/344/275/234/346/265/201/346/250/241/346/235/277/345/214/205/350/247/204/345/210/231.md

@@ -21,6 +21,16 @@ priority: P1
 specificity: 4
 consumes:
   - ka-hard-rule-核心工程执行原则
+hard_blocks:
+  - 模板消费卡在中间状态
+  - 消费证据缺失
+  - 未注册直接注入
+fallback: manual_required
+required_evidence:
+  - template_pipeline_status
+  - consumption_trace_log
+version: 1.0.0
+last_reviewed: '2026-05-24'
 ---
 
 # 工作流模板包规则

package/templates/knowledge/rules//346/211/251/345/261/225/347/224/237/345/221/275/345/221/250/346/234/237/350/247/204/345/210/231.md

@@ -21,6 +21,16 @@ priority: P1
 specificity: 4
 consumes:
   - ka-hard-rule-核心工程执行原则
+hard_blocks:
+  - 第三方扩展自称 enforced
+  - 高风险权限未审批
+  - 生命周期跳跃转移
+fallback: manual_required
+required_evidence:
+  - extension_manifest
+  - permission_approval_record
+version: 1.0.0
+last_reviewed: '2026-05-24'
 ---
 
 # 扩展生命周期规则

package/templates/knowledge/rules//346/226/275/345/267/245/346/214/207/344/273/244/345/245/221/347/272/246/350/247/204/345/210/231.md

@@ -1,10 +1,39 @@
 ---
-id: 施工指令契约规则
+name: 施工指令契约规则
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-hard-rule-施工指令契约规则
 asset_kind: hard_rule
-owner_mechanism_id: mc-instruction-contract
 lifecycle_status: active
-consumption_mode: required
-language_policy: zh_first
+authority: canonical
+owner_mechanism_id: mc-instruction-contract
+routes:
+  - code_execution
+  - multi_stage_plan
+primary_triggers:
+  - 代码修改
+  - 文件创建
+  - 重构操作
+secondary_triggers: []
+negative_triggers: []
+priority: P0
+specificity: 5
+consumes:
+  - ka-hard-rule-核心工程执行原则
+hard_blocks:
+  - 无施工指令直接编码
+  - 空目标/空范围/空验收标准
+  - 缺失字段不澄清直接执行
+  - 只改测试/文档/registry 自证
+fallback: manual_required
+required_evidence:
+  - instruction_contract
+  - user_confirmation
+  - scope_boundary_check
+version: 1.0.0
+last_reviewed: '2026-05-24'
 ---
 
 # 施工指令契约规则

package/templates/knowledge/rules//346/236/266/346/236/204/345/206/263/347/255/226/347/240/224/350/256/250/350/247/204/345/210/231.md

@@ -0,0 +1,49 @@
+---
+name: 架构决策研讨规则
+id: ka-rule-architecture-decision-workshop
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+scope:
+  - all
+products:
+  - '*'
+routes:
+  - artifact_generation
+primary_triggers:
+  - 架构设计
+  - 系统设计
+  - 技术架构
+priority: P0
+specificity: 5
+version: 1.0.0
+last_reviewed: '2026-05-25'
+owner_mechanism_id: mc-architecture-decision-workshop
+hard_blocks:
+  - 必要架构决策域未确认时生成正式架构设计文档
+  - 现有系统无现状与差距证据时声称架构完成
+required_evidence:
+  - architecture_decision_workshop
+  - user_confirmation_ref
+consumes:
+  - user_intent
+  - project_context_detection
+  - existing_system_analysis
+fallback: manual_required
+type: rule
+status: active
+---
+
+# 架构决策研讨规则
+
+## 硬底线
+
+- 正式架构文档生成前必须覆盖业务流程、数据架构、安全架构、后端架构、前端架构、基础设施六类决策域。
+- 每个必要域必须记录事实和约束、候选方案、推荐理由、风险和用户确认引用。
+- 现有系统必须先引用现状分析和差距分析证据；空项目必须先确认目标、端范围和非功能约束。
+- 任一必要域为未开始、讨论中、待确认或返工状态时，只能输出讨论清单或明确的不可执行草案。
+- 决策变化必须将受影响设计产物标记为需要重新验证。
+
+## 低风险边界
+
+普通缺陷修复、样式或文案调整、只读解释不触发完整六域研讨；涉及契约、数据、安全、部署或重大模块边界变化时重新触发。

package/templates/knowledge/rules//350/256/276/350/256/241/344/272/247/347/211/251/345/214/205/350/247/204/345/210/231.md

@@ -0,0 +1,55 @@
+---
+name: 设计产物包规则
+id: ka-rule-design-artifact-pack
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+scope:
+  - all
+products:
+  - '*'
+routes:
+  - artifact_generation
+  - code_change
+primary_triggers:
+  - 架构设计文档
+  - 数据库设计文档
+  - API接口规格文档
+priority: P0
+specificity: 5
+version: 1.0.0
+last_reviewed: '2026-05-25'
+owner_mechanism_id: mc-design-artifact-pack
+hard_blocks:
+  - 未经复验的设计文档支撑编码或交付
+  - API 缺字段级契约
+  - 数据库 SQL 不可执行
+  - 跨设计产物关键冲突
+required_evidence:
+  - design_artifact_pack
+  - consistency_verification
+consumes:
+  - architecture_decision_workshop
+  - docs/architecture/00-架构决策记录.md
+  - docs/architecture/01-架构设计文档.md
+fallback: manual_required
+type: rule
+status: active
+---
+
+# 设计产物包规则
+
+## 权威资产
+
+- 决策和确认以 `00-架构决策记录.md` 为准。
+- 总体架构以 `01-架构设计文档.md` 为准。
+- 数据库物理结构以真实 SQL/migration 为准，`02-数据库设计文档.md` 解释和追踪。
+- API 路径和字段 schema 以 `docs/api/openapi.yaml` 为准，`03-API接口规格文档.md` 补充业务语义。
+- `99-设计一致性验收报告.md` 只记录真实验证结果。
+
+## 硬底线
+
+- 每个 endpoint 必须具备请求和响应字段级说明，JSON 示例不能替代字段表。
+- SQL、OpenAPI、架构、数据库和 API 文档出现关键漂移时必须阻断。
+- 旧文档在新标准下必须先审计；未经确认和复验不得继续作为编码依据。
+- 升级必须默认 dry-run，确认写入时归档原文件和 hash。

package/templates/knowledge/rules//350/257/201/346/215/256/351/251/261/345/212/250/344/270/216/345/217/215/345/271/273/350/247/211/350/247/204/345/210/231.md

@@ -0,0 +1,75 @@
+---
+name: 证据驱动与反幻觉规则
+scope:
+  - '*'
+products:
+  - '*'
+id: ka-hard-rule-证据驱动与反幻觉规则
+asset_kind: hard_rule
+lifecycle_status: active
+authority: canonical
+owner_mechanism_id: mc-evidence-grounding
+routes:
+  - code_execution
+  - multi_stage_plan
+primary_triggers:
+  - 事实声称
+  - 项目事实
+  - 验证结果
+  - 发布结论
+secondary_triggers:
+  - 知识注入
+  - 方案生成
+negative_triggers: []
+priority: P0
+specificity: 5
+consumes:
+  - ka-hard-rule-核心工程执行原则
+  - ka-hard-rule-施工指令契约规则
+hard_blocks:
+  - 无证据声称项目事实
+  - 把推测当事实
+  - 把验证计划当验证结果
+  - generated_inference 单独支撑事实
+  - forbidden evidence 被注入
+  - tests/scenario/gate 自证
+fallback: manual_required
+required_evidence:
+  - evidence_matrix
+  - fact_claim_verification
+  - unsupported_claim_gate_result
+version: 1.0.0
+last_reviewed: '2026-05-24'
+---
+
+# 证据驱动与反幻觉规则
+
+## 硬规则
+
+1. **没证据，不得当事实** — 任何项目事实、技术栈、测试、发布状态的声明必须有可追溯证据
+2. **没检索，不得做高风险判断** — 架构、编码、发布、迁移任务必须先检索项目证据
+3. **有冲突，不得直接拍板** — 证据冲突时必须列出冲突、给出推荐、请求用户确认
+4. **有不确定，必须说清** — 不确定项必须明确标注并给出推荐方案
+5. **验证计划不是验证结果** — `validation_plan` 不得冒充 `validation_result`
+6. **模型推理不是事实证据** — `generated_inference` 不得单独支撑项目事实结论
+7. **测试/gate/scenario 不是主链路落地** — 只被测试文件调用不是真实消费证据
+8. **禁止源永远不得注入** — `forbidden` 权限的证据不得出现在 prompt 或 citation 中
+9. **过期证据不得用于高风险** — `stale` / `deprecated` 证据不得作为高风险任务唯一依据
+10. **失败必须修复复验** — 证据不足时不得假完成，必须修复并复验
+
+## 风险分级
+
+- **critical**: 发布门禁、生产环境、安全相关 → 任何证据缺失必须阻断
+- **high**: 架构、编码、迁移、验证 → 事实声明必须有权威证据
+- **medium**: 普通功能开发 → 关键声明需要证据
+- **low**: 通用问答、低风险操作 → 可标注为通用建议
+
+## 检查项
+
+- [ ] 关键事实声明有 evidence_refs
+- [ ] 无证据的声明已标注不确定
+- [ ] 冲突证据已列出并裁决
+- [ ] forbidden 证据未被注入
+- [ ] 高风险声明未用 stale/deprecated 证据
+- [ ] 验证结论基于真实执行结果
+- [ ] 生成的推理未单独支撑事实

package/templates/knowledge/rules//350/267/250/345/271/263/345/217/260/350/267/257/345/276/204/345/256/211/345/205/250/350/247/204/345/210/231.md

@@ -21,6 +21,16 @@ priority: P1
 specificity: 4
 consumes:
   - ka-hard-rule-核心工程执行原则
+hard_blocks:
+  - 路径逃逸 scope 边界
+  - 符号链接指向 scope 外
+  - 大小写冲突未处理
+fallback: manual_required
+required_evidence:
+  - path_normalization_result
+  - scope_boundary_check
+version: 1.0.0
+last_reviewed: '2026-05-24'
 ---
 
 # 跨平台路径安全规则