soloforge 1.3.0 → 1.3.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "soloforge",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "AI-driven development workflow system - one person does the work of a five-person team",
   "type": "module",
   "main": "dist/index.js",
@@ -13,7 +13,7 @@
   ],
   "scripts": {
     "clean": "rm -rf dist",
-    "build": "npm run clean && tsc",
+    "build": "npm run clean && tsc && chmod +x dist/bin/soloforge.js",
     "dev": "tsc --watch",
     "test": "vitest run --reporter=verbose",
     "test:watch": "vitest",
@@ -28,7 +28,8 @@
     "validate-batch3": "node -e \"import('./scripts/validate_batch_historical_notice.mjs').then(m=>m.printHistoricalNotice(3))\" && vitest run tests/engine/knowledge_scenario_matrix.test.ts --reporter=verbose && node scripts/validate_batch3_gate.mjs",
     "validate-batch4": "node -e \"import('./scripts/validate_batch_historical_notice.mjs').then(m=>m.printHistoricalNotice(4))\" && vitest run tests/engine/extension_scenario_matrix.test.ts --reporter=verbose && node scripts/validate_batch4_gate.mjs",
     "validate-batch5": "node -e \"import('./scripts/validate_batch_historical_notice.mjs').then(m=>m.printHistoricalNotice(5))\" && vitest run tests/engine/release_gate_scenario_matrix.test.ts --reporter=verbose && node scripts/validate_batch5_gate.mjs",
-    "validate-release": "npm run build && node scripts/validate_release_gate.mjs"
+    "validate-release": "npm run build && node scripts/validate_release_gate.mjs",
+    "audit-deps": "node scripts/audit_dependencies.mjs"
   },
   "keywords": [
     "mcp",
@@ -62,4 +63,4 @@
     "typescript": "^5.7.0",
     "vitest": "^3.1.0"
   }
-}
+}

package/templates/knowledge/acceptance_templates/API/346/216/245/345/217/243/350/247/204/346/240/274/346/226/207/346/241/243/346/250/241/347/211/210.md

@@ -0,0 +1,74 @@
+---
+name: API接口规格文档模版
+id: ka-artifact_template-api-specification
+asset_kind: artifact_template
+lifecycle_status: active
+authority: supporting
+scope:
+  - backend
+  - frontend
+products:
+  - '*'
+routes:
+  - artifact_generation
+primary_triggers:
+  - API接口规格文档
+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
+emits:
+  - docs/architecture/03-API接口规格文档.md
+  - docs/api/openapi.yaml
+required_evidence:
+  - endpoint_field_tables
+  - openapi_operation_coverage
+type: acceptance_template
+status: active
+---
+
+# API 接口规格文档
+
+OpenAPI 权威路径: `docs/api/openapi.yaml`
+
+## Endpoint: `METHOD /api/v1/resource`
+
+### 基本信息
+
+| endpoint_id | 用途 | 调用端 | 权限 | 幂等 | 限流 | 副作用 |
+|-------------|------|--------|------|------|------|--------|
+
+### 请求 Header 字段
+
+| 字段路径 | 类型 | 必填 | 格式/约束 | 数据映射 | 说明 | 示例 |
+|----------|------|------|-----------|----------|------|------|
+
+### 请求 Path / Query 字段
+
+| 字段路径 | 类型 | 必填 | 默认值 | 格式/约束 | 说明 | 示例 |
+|----------|------|------|--------|-----------|------|------|
+
+### 请求体字段
+
+| 字段路径 | 类型 | 必填 | 可空 | 枚举/格式/校验 | 数据映射 | 说明 | 示例 |
+|----------|------|------|------|----------------|----------|------|------|
+
+### 响应体字段
+
+| 字段路径 | 类型 | 必有 | 可空 | 枚举/格式 | 数据来源 | 说明 | 示例 |
+|----------|------|------|------|-----------|----------|------|------|
+
+### 错误与副作用
+
+| 业务码 | HTTP 状态 | 触发条件 | 用户提示 | 可重试 | 状态/数据副作用 |
+|--------|-----------|----------|----------|--------|-----------------|
+
+### 验收场景
+
+| 场景 | 输入 | 预期响应 | 数据/状态变化 | 验证证据 |
+|------|------|----------|---------------|----------|

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//346/240/207/345/207/206/350/265/204/344/272/247/350/246/206/347/233/226/350/247/204/345/210/231.md

@@ -0,0 +1,29 @@
+# 标准资产覆盖规则
+
+## 覆盖范围
+
+所有 `templates/**` 下的资产类型必须被审计覆盖：
+
+- 验收模板 (acceptance_templates)
+- 规则 (rules)
+- 流程 (procedures)
+- 检查清单 (checklists)
+- 审查规则 (review_rules)
+- 模式 (patterns)
+- 脚手架 (scaffolds)
+- Adapter 工作流 (adapter_workflow)
+
+## 覆盖检查要求
+
+每个资产必须具备：
+
+1. **标准承载路径** — 资产存放在正确的类型目录中
+2. **复验路径** — 可通过 sf_verify、template_mechanism_auditor 或 validate-release 复验
+3. **主链路消费者** — 被实际工具（sf_expand、sf_verify、sf_deliver 等）消费
+
+## 门禁规则
+
+- P0 资产缺少标准承载路径时 hard_fail
+- P0 资产未在 Consumable Asset Registry 注册时 hard_fail
+- P0 资产缺少 owner_mechanism_id 时 hard_fail
+- `mc-design-artifact-pack` 仅作为首批 P0 子机制保留

package/templates/knowledge/rules//346/250/241/346/235/277/350/265/204/344/272/247/345/217/257/350/247/201/346/200/247/350/247/204/345/210/231.md

@@ -0,0 +1,27 @@
+# 模板资产可见性规则
+
+## 适用范围
+
+所有 `templates/**` 资产的同步、索引、注入和消费入口。
+
+## 可见性分类
+
+| 可见性 | 说明 |
+|--------|------|
+| user_project | 用户项目知识，可同步到 `.soloforge/knowledge` |
+| soloforge_internal | SoloForge 内部治理，不进入用户项目 |
+| adapter_runtime_only | 仅 adapter 运行时消费，不进入用户知识库 |
+| scaffold_only | 仅脚手架机制消费，不进入知识索引 |
+| global_pattern | 全局工程模式，进入 `~/.soloforge/patterns` |
+
+## 硬规则
+
+- 内部资产不得同步到用户项目。
+- 不同技术栈的审查规则不得互相注入。
+- 脚手架模板只由脚手架机制消费。
+- 全局 patterns 只能作为 `template_guidance`，不得支撑项目事实。
+- 用户可见资产不得包含内部施工术语。
+
+## 术语污染扫描
+
+用户可见资产禁止出现: Batch、validate-release、SoloForge Audit: PASS、Mechanism Contract Registry 等内部术语。