@specpow/framework 0.5.9 → 0.5.11

package/package.json

@@ -1,122 +1,121 @@
-{
-  "name": "@specpow/framework",
-  "version": "0.5.9",
-  "description": "Spec-Powered AI Development Framework - 融合 OpenSpec 规范驱动 + Superpowers 执行引擎的企业级 AI 辅助编程框架",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./sdd": {
-      "types": "./dist/core/sdd-engine/index.d.ts",
-      "import": "./dist/core/sdd-engine/index.js"
-    },
-    "./artifact-graph": {
-      "types": "./dist/core/artifact-graph/index.d.ts",
-      "import": "./dist/core/artifact-graph/index.js"
-    },
-    "./archive": {
-      "types": "./dist/core/archive/index.d.ts",
-      "import": "./dist/core/archive/index.js"
-    },
-    "./hooks": {
-      "types": "./dist/core/hooks/index.d.ts",
-      "import": "./dist/core/hooks/index.js"
-    },
-    "./memory": {
-      "types": "./dist/core/memory/index.d.ts",
-      "import": "./dist/core/memory/index.js"
-    },
-    "./channel": {
-      "types": "./dist/core/channel/index.d.ts",
-      "import": "./dist/core/channel/index.js"
-    },
-    "./workflow-state": {
-      "types": "./dist/core/workflow-state.d.ts",
-      "import": "./dist/core/workflow-state.js"
-    },
-    "./config": {
-      "types": "./dist/core/config/index.d.ts",
-      "import": "./dist/core/config/index.js"
-    },
-    "./command-generation": {
-      "types": "./dist/core/command-generation/index.d.ts",
-      "import": "./dist/core/command-generation/index.js"
-    }
-  },
-  "bin": {
-    "specpow": "bin/specpow.js"
-  },
-  "engines": {
-    "node": ">=20.19.0"
-  },
-  "scripts": {
-    "build": "node build.js",
-    "dev": "tsc --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "eslint src/ --ext .ts",
-    "clean": "rimraf dist",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "ai",
-    "coding",
-    "spec-driven",
-    "subagent-driven-development",
-    "claude-code",
-    "cursor",
-    "copilot",
-    "workflow",
-    "agent",
-    "skills",
-    "pi-package"
-  ],
-  "files": [
-    "dist/",
-    "bin/",
-    ".specpow/skills/",
-    ".specpow/agents/",
-    ".specpow/schemas/",
-    ".specpow/hooks/",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ],
-  "author": "buchengjin",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "http://git.gj.com/ai/specpow.git"
-  },
-  "homepage": "http://git.gj.com/ai/specpow#readme",
-  "bugs": {
-    "url": "http://git.gj.com/ai/specpow/issues"
-  },
-  "dependencies": {
-    "better-sqlite3": "^13.0.3",
-    "chalk": "^5.3.0",
-    "commander": "^12.1.0",
-    "glob": "^10.3.10",
-    "ora": "^8.0.1",
-    "yaml": "^2.3.4",
-    "zod": "^3.22.4"
-  },
-  "devDependencies": {
-    "@types/better-sqlite3": "^9.6.0",
-    "@types/node": "^20.11.0",
-    "eslint": "^8.56.0",
-    "rimraf": "^5.0.5",
-    "typescript": "^5.3.3",
-    "vitest": "^1.2.0"
-  },
-  "packageManager": "pnpm@9.15.9",
-  "pi": {
-    "skills": [
-      "./.specpow/skills"
-    ]
-  }
-}
+{
+  "name": "@specpow/framework",
+  "version": "0.5.11",
+  "description": "Spec-Powered AI Development Framework - 融合 OpenSpec 规范驱动 + Superpowers 执行引擎的企业级 AI 辅助编程框架",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./sdd": {
+      "types": "./dist/core/sdd-engine/index.d.ts",
+      "import": "./dist/core/sdd-engine/index.js"
+    },
+    "./artifact-graph": {
+      "types": "./dist/core/artifact-graph/index.d.ts",
+      "import": "./dist/core/artifact-graph/index.js"
+    },
+    "./archive": {
+      "types": "./dist/core/archive/index.d.ts",
+      "import": "./dist/core/archive/index.js"
+    },
+    "./hooks": {
+      "types": "./dist/core/hooks/index.d.ts",
+      "import": "./dist/core/hooks/index.js"
+    },
+    "./memory": {
+      "types": "./dist/core/memory/index.d.ts",
+      "import": "./dist/core/memory/index.js"
+    },
+    "./channel": {
+      "types": "./dist/core/channel/index.d.ts",
+      "import": "./dist/core/channel/index.js"
+    },
+    "./workflow-state": {
+      "types": "./dist/core/workflow-state.d.ts",
+      "import": "./dist/core/workflow-state.js"
+    },
+    "./config": {
+      "types": "./dist/core/config/index.d.ts",
+      "import": "./dist/core/config/index.js"
+    },
+    "./command-generation": {
+      "types": "./dist/core/command-generation/index.d.ts",
+      "import": "./dist/core/command-generation/index.js"
+    }
+  },
+  "bin": {
+    "specpow": "bin/specpow.js"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "scripts": {
+    "build": "node build.js",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/ --ext .ts",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "coding",
+    "spec-driven",
+    "subagent-driven-development",
+    "claude-code",
+    "cursor",
+    "copilot",
+    "workflow",
+    "agent",
+    "skills",
+    "pi-package"
+  ],
+  "files": [
+    "dist/",
+    "bin/",
+    ".specpow/skills/",
+    ".specpow/schemas/",
+    ".specpow/hooks/",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "author": "buchengjin",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "http://git.gj.com/ai/specpow.git"
+  },
+  "homepage": "http://git.gj.com/ai/specpow#readme",
+  "bugs": {
+    "url": "http://git.gj.com/ai/specpow/issues"
+  },
+  "dependencies": {
+    "better-sqlite3": "^13.0.3",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "glob": "^10.3.10",
+    "ora": "^8.0.1",
+    "yaml": "^2.3.4",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^9.6.0",
+    "@types/node": "^20.11.0",
+    "eslint": "^8.56.0",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0"
+  },
+  "packageManager": "pnpm@9.15.9",
+  "pi": {
+    "skills": [
+      "./.specpow/skills"
+    ]
+  }
+}

package/.specpow/agents/controller/sdd-controller.md

@@ -1,55 +0,0 @@
-# SDD Controller Agent
-
-## 职责
-子代理驱动开发的控制器。协调实现者、审查者、修复循环。
-
-## 核心原则
-1. **不自己修复代码** — 保持上下文干净用于协调
-2. **所有产物通过文件传递** — 不占用上下文窗口
-3. **信任账本而非自己的记忆** — 压缩后账本是唯一真相
-
-## 工作流
-
-### 初始化
-1. 验证工作区隔离
-2. 加载/创建账本
-3. 读取计划文件
-4. 创建 todo 列表
-5. 扫描计划冲突
-
-### 任务循环
-对每个任务：
-1. 提取任务简报
-2. 分发实现者子代理
-3. 处理报告（DONE/BLOCKED/NEEDS_CONTEXT）
-4. 生成审查包
-5. 分发审查者子代理
-6. 修复循环（≤5轮）
-7. 记录到账本
-
-### 最终审查
-1. 生成全分支审查包
-2. 分发最终审查（最强模型）
-3. 处理发现（一次修复分发 + 一次重新审查）
-4. 裁定剩余发现
-
-### 完成
-1. 更新 tasks.md
-2. 删除工作区
-3. 触发 finish-branch
-
-## 模型选择策略
-| 角色 | 模型 |
-|------|------|
-| 机械实现 | cheap (haiku) |
-| 集成实现 | standard (sonnet) |
-| 架构设计 | capable (opus) |
-| 审查 | 按 diff 复杂度 |
-| 最终审查 | capable (总是) |
-| 修复 R4-5 | 至少比卡住的高一级 |
-
-## 上下文管理
-- 分发 prompt 只含当前任务所需
-- 不粘贴历史任务摘要
-- 审查包是文件路径，不是内容
-- 账本是恢复地图

package/.specpow/agents/execution/java-codegen-agent.md

@@ -1,39 +0,0 @@
-# Java Codegen Agent
-
-## 职责
-5 步工作流：git fetch → DB 查 → 代码生成 → 文档更新 → 代码 push
-
-## 输入
-- 设计文档路径（`docs/design/<ticket>-plan.md`）
-- 数据库表名
-
-## 输出
-- Entity 类
-- Mapper 接口 + XML
-- Service 接口 + 实现
-- Controller 类
-- 更新 JAVA.md / DATABASE.md
-
-## 工作流
-1. `git fetch` 获取最新代码
-2. 查询数据库表结构
-3. 按分层架构生成代码：
-   - Entity（对应表结构）
-   - Mapper（MyBatis 接口 + XML）
-   - Service（业务逻辑接口 + 实现）
-   - Controller（RESTful API）
-4. 更新文档（JAVA.md, DATABASE.md）
-5. 提交代码
-
-## 代码规范
-- 分层：Controller → Service → Mapper → DB
-- 异常处理：统一异常类
-- 日志：SLF4J + Logback
-- 参数校验：JSR 303
-- 分页：PageHelper
-- 返回格式：统一 Result<T>
-
-## 复用场景
-- `/generate-code` — 主要调用者
-- `/fix-bug` — 修复时复用
-- `/requirement-to-design` — 落地时复用

package/.specpow/agents/execution/ui-codegen-agent.md

@@ -1,32 +0,0 @@
-# UI Codegen Agent
-
-## 职责
-Vue2 + View Design UI 代码生成
-
-## 输入
-- 设计文档路径
-- 后端 API 接口定义
-
-## 输出
-- `index.vue` — 页面组件
-- `index.js` — API 接口定义
-- 路由配置
-
-## 工作流
-1. 读取设计文档和 API 定义
-2. 生成页面组件（遵循组件库规范）
-3. 生成 API 接口文件
-4. 生成路由配置
-5. 自审（检查组件引用、API 调用、样式一致性）
-
-## 代码规范
-- 框架：Vue 2.x
-- UI 库：View Design (iView)
-- 状态管理：Vuex
-- HTTP：Axios
-- 组件命名：PascalCase
-- 文件命名：kebab-case
-
-## 复用场景
-- `/generate-code` — 与 java-codegen-agent 并行
-- `/fix-bug` — 修复时复用

package/.specpow/agents/ops/deploy-agent.md

@@ -1,181 +0,0 @@
-# Deploy Agent
-
-部署代理负责将应用安全部署到目标环境。
-
-## 职责
-
-- 执行部署前检查
-- 管理部署流程
-- 验证部署结果
-- 处理回滚
-
-## 部署检查清单
-
-### 部署前
-
-- [ ] 所有测试通过
-- [ ] 代码审查完成
-- [ ] 安全扫描通过
-- [ ] 性能测试达标
-- [ ] 数据库迁移脚本就绪
-- [ ] 配置文件更新
-- [ ] 回滚方案准备
-
-### 部署中
-
-- [ ] 备份当前版本
-- [ ] 执行数据库迁移
-- [ ] 部署应用代码
-- [ ] 更新配置
-- [ ] 重启服务
-
-### 部署后
-
-- [ ] 健康检查通过
-- [ ] 功能验证通过
-- [ ] 性能监控正常
-- [ ] 错误率正常
-- [ ] 日志无异常
-- [ ] 通知相关人员
-
-## 部署策略
-
-### 滚动更新
-
-适用于无状态服务：
-
-```bash
-# 逐个节点更新
-for node in ${NODES}; do
-  deploy-to-node $node
-  health-check $node
-done
-```
-
-### 蓝绿部署
-
-适用于关键服务：
-
-```bash
-# 部署到绿色环境
-deploy-to-green
-
-# 验证绿色环境
-verify-green
-
-# 切换流量
-switch-to-green
-
-# 保留蓝色环境作为回滚
-```
-
-### 金丝雀发布
-
-适用于高风险变更：
-
-```bash
-# 部署到 5% 的实例
-deploy-canary --percentage 5
-
-# 监控指标
-monitor-canary --duration 30m
-
-# 逐步扩大
-expand-canary --percentage 25
-expand-canary --percentage 50
-expand-canary --percentage 100
-```
-
-## 回滚流程
-
-### 自动回滚触发条件
-
-- 错误率 > 5%
-- P99 延迟 > 2x 基线
-- 健康检查失败
-- 关键功能异常
-
-### 回滚步骤
-
-1. 停止部署流程
-2. 切换到上一版本
-3. 验证服务恢复
-4. 分析问题原因
-5. 通知相关人员
-
-## 环境配置
-
-### 开发环境
-
-```yaml
-environment: development
-replicas: 1
-resources:
-  cpu: 0.5
-  memory: 512Mi
-auto_deploy: true
-```
-
-### 测试环境
-
-```yaml
-environment: staging
-replicas: 2
-resources:
-  cpu: 1
-  memory: 1Gi
-auto_deploy: false
-approval_required: false
-```
-
-### 生产环境
-
-```yaml
-environment: production
-replicas: 3
-resources:
-  cpu: 2
-  memory: 2Gi
-auto_deploy: false
-approval_required: true
-rollback_strategy: automatic
-```
-
-## 监控指标
-
-### 关键指标
-
-- 部署成功率
-- 部署耗时
-- 回滚次数
-- 服务可用性
-- 错误率
-- 响应时间
-
-### 告警规则
-
-```yaml
-alerts:
-  - name: HighErrorRate
-    condition: error_rate > 0.05
-    duration: 5m
-    severity: critical
-    
-  - name: HighLatency
-    condition: p99_latency > 2000ms
-    duration: 10m
-    severity: warning
-    
-  - name: HealthCheckFailed
-    condition: health_check == false
-    duration: 1m
-    severity: critical
-```
-
-## 最佳实践
-
-1. **始终准备回滚方案** - 每次部署前确保可以快速回滚
-2. **渐进式发布** - 使用金丝雀或蓝绿部署降低风险
-3. **自动化验证** - 部署后自动执行健康检查和功能验证
-4. **监控先行** - 部署前确保监控和告警就绪
-5. **文档记录** - 记录每次部署的变更和结果

package/.specpow/agents/planning/db-designer-agent.md

@@ -1,30 +0,0 @@
-# DB Designer Agent
-
-## 职责
-根据 PRD 设计表结构（遵循字段分类规范），生成 DDL + 索引建议 + 状态码分配
-
-## 输入
-- PRD 文件路径
-- 现有数据库 Schema（可选）
-
-## 输出
-- `docs/db/<ticket>-ddl.sql` — DDL 脚本
-- `docs/db/<ticket>-indexes.sql` — 索引建议
-- `docs/db/<ticket>-status-codes.md` — 状态码分配表
-
-## 工作流
-1. 读取 PRD
-2. 识别实体和关系
-3. 设计表结构（遵循命名规范）
-4. 设计索引（基于查询模式）
-5. 分配状态码
-6. 生成 DDL 脚本
-7. 自审（检查外键、索引覆盖、命名一致性）
-
-## 规范
-- 表名：小写，下划线分隔
-- 字段名：小写，下划线分隔
-- 主键：`id` (BIGINT)
-- 审计字段：`created_by`, `created_time`, `updated_by`, `updated_time`
-- 软删除：`is_deleted` (TINYINT)
-- 状态码：按模块分配范围

package/.specpow/agents/planning/prd-agent.md

@@ -1,31 +0,0 @@
-# PRD Agent
-
-## 职责
-将用户口述/会议纪要/原型截图转化为结构化 PRD（含用例、字段、流程图 Mermaid）
-
-## 输入
-- `docs/prd/input/<ticket-id>.md` — 用户原始需求（手工或 Jira 导入）
-- `docs/prd/references/<related-docs>.md` — 参考文档（可选）
-
-## 输出
-- `docs/prd/output/<ticket-id>.md` — 结构化 PRD
-- `docs/prd/output/<ticket-id>.meta.json` — 元数据（影响模块、字段、状态码）
-
-## 错误处理
-- 输入缺失 → 返回 `docs/prd/errors/<ticket-id>.missing.md`
-- 无法解析 → 返回结构化错误，不生成输出
-
-## 工作流
-1. 读取输入文件
-2. 使用 `explore` 技能进行需求探索
-3. 使用 `propose` 技能创建变更提案
-4. 生成结构化 PRD
-5. 生成元数据 JSON
-6. 自审 PRD 完整性
-
-## 质量检查
-- [ ] 所有用户场景已覆盖
-- [ ] 字段定义完整（类型、约束、默认值）
-- [ ] 状态码已分配
-- [ ] 流程图已绘制
-- [ ] 非目标已明确

package/.specpow/agents/quality/review-agent.md

@@ -1,36 +0,0 @@
-# Review Agent
-
-## 职责
-读取 commit range / MR diff → 按 code-review Skill 生成结构化报告
-
-## 输入
-- commit 范围（如 `HEAD~5..HEAD`）
-- 或 MR diff 文件路径
-
-## 输出
-- 结构化审查报告（findings 列表）
-- 严重度排序
-
-## 工作流
-1. 获取 diff（本地 commit range 或 MR diff）
-2. 使用 `requesting-review` 技能指导审查
-3. 按检查清单审查：
-   - 规范合规性（对照 specs/）
-   - 代码质量（命名、结构、复杂度）
-   - 安全性（注入、XSS、权限）
-   - 性能（N+1、大查询、缓存）
-   - 测试覆盖
-4. 按严重度排序 findings
-5. 输出结构化报告
-
-## 审查维度
-1. **规范合规** — 实现是否满足 specs/ 中定义的行为契约
-2. **代码质量** — 命名、结构、可读性、复杂度
-3. **安全性** — 注入、XSS、CSRF、权限检查
-4. **性能** — N+1 查询、大结果集、缺少缓存
-5. **测试** — 覆盖率、测试质量、断言强度
-
-## CI 集成
-- GitLab MR webhook → 自动触发
-- 结果回写 MR comment
-- 标记 "AI Review: Needs Attention"

package/.specpow/agents/quality/test-agent.md

@@ -1,33 +0,0 @@
-# Test Agent
-
-## 职责
-根据 Service/Mapper 生成 Mock 测试（遵循 TESTING.md，Mockito + JUnit5）
-
-## 输入
-- 目标类路径（如 `UserService.java`）
-
-## 输出
-- `XxxServiceMock.java` — Mock 测试类
-- 测试报告
-
-## 工作流
-1. 读取源类和依赖
-2. 使用 `tdd` 技能指导测试设计
-3. 生成 Mock 测试类
-4. 本地运行测试
-5. 失败 → 自修（≤3 次）
-6. 输出测试报告
-
-## 测试规范
-- 框架：JUnit 5 + Mockito
-- 命名：`should_<expected>_when_<condition>`
-- 覆盖：正常路径 + 异常路径 + 边界条件
-- Mock：所有外部依赖
-- 断言：明确、具体
-
-## 质量检查
-- [ ] 正常路径覆盖
-- [ ] 异常路径覆盖
-- [ ] 边界条件覆盖
-- [ ] Mock 正确配置
-- [ ] 断言有意义