@specpow/framework 0.2.0

package/dist/utils/index.js

@@ -0,0 +1,119 @@
+/**
+ * 通用工具函数
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import chalk from 'chalk';
+/**
+ * 查找项目根目录（包含 package.json 或 .git 的最近父目录）
+ */
+export function findProjectRoot(startDir = process.cwd()) {
+    let dir = path.resolve(startDir);
+    while (true) {
+        if (fs.existsSync(path.join(dir, 'package.json')) || fs.existsSync(path.join(dir, '.git'))) {
+            return dir;
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            throw new Error('无法找到项目根目录（未找到 package.json 或 .git）');
+        }
+        dir = parent;
+    }
+}
+/**
+ * 安全读取 JSON 文件
+ */
+export function readJsonSafe(filePath) {
+    try {
+        if (!fs.existsSync(filePath))
+            return null;
+        return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 确保目录存在
+ */
+export function ensureDir(dirPath) {
+    fs.mkdirSync(dirPath, { recursive: true });
+}
+/**
+ * 复制目录（递归）
+ */
+export function copyDir(src, dest) {
+    ensureDir(dest);
+    const entries = fs.readdirSync(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDir(srcPath, destPath);
+        }
+        else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+/**
+ * 列出目录下所有文件（递归）
+ */
+export function listFilesRecursive(dir, pattern) {
+    const results = [];
+    if (!fs.existsSync(dir))
+        return results;
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...listFilesRecursive(fullPath, pattern));
+        }
+        else if (!pattern || pattern.test(entry.name)) {
+            results.push(fullPath);
+        }
+    }
+    return results;
+}
+/**
+ * 生成变更 ID（基于标题的 slug）
+ */
+export function generateChangeId(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^\w\u4e00-\u9fff\s-]/g, '')
+        .replace(/[\s_]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .substring(0, 50) || `change-${Date.now()}`;
+}
+/**
+ * 格式化时间戳
+ */
+export function formatTimestamp(date = new Date()) {
+    return date.toISOString().replace('T', ' ').substring(0, 19);
+}
+/**
+ * 打印成功消息
+ */
+export function success(msg) {
+    console.log(chalk.green('✓') + ' ' + msg);
+}
+/**
+ * 打印错误消息
+ */
+export function error(msg) {
+    console.log(chalk.red('✗') + ' ' + msg);
+}
+/**
+ * 打印警告消息
+ */
+export function warn(msg) {
+    console.log(chalk.yellow('!') + ' ' + msg);
+}
+/**
+ * 打印信息消息
+ */
+export function info(msg) {
+    console.log(chalk.blue('i') + ' ' + msg);
+}
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"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"}

package/hooks/hooks.json

@@ -0,0 +1,30 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" session-start",
+            "shell": "bash",
+            "async": false
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" workflow-state",
+            "shell": "bash",
+            "async": false
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/run-hook.cmd

@@ -0,0 +1,19 @@
+@echo off
+REM SpecPow Hook Runner for Windows
+REM Usage: run-hook.cmd <hook-name>
+REM
+REM P2-11: 支持 SessionStart 和 WorkflowState 两种 Hook
+
+set HOOK_NAME=%1
+set SCRIPT_DIR=%~dp0
+
+if "%HOOK_NAME%"=="session-start" (
+    bash "%SCRIPT_DIR%session-start"
+) else if "%HOOK_NAME%"=="workflow-state" (
+    REM WorkflowState Hook: 注入当前工作流状态
+    REM 通过 Node.js 调用 TypeScript Hook 模块
+    node -e "import('file:///%SCRIPT_DIR:~0,-1%/../dist/core/hooks/index.js').then(m => m.executeUserPromptSubmit(process.cwd(), '', 'claude').then(c => { if(c) console.log(JSON.stringify({hookSpecificOutput:{hookEventName:'UserPromptSubmit',additionalContext:c}})); else process.exit(0); }))"
+) else (
+    echo Unknown hook: %HOOK_NAME%
+    exit /b 1
+)

package/hooks/session-start

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+# SpecPow Session Start Hook
+# 
+# 在每次会话开始时注入 using-skills 技能内容到 AI 代理上下文
+# 兼容 Claude Code、Cursor、Copilot CLI 等平台
+
+set -euo pipefail
+
+# Determine plugin root directory
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+
+# Read using-skills content
+using_skills_content=$(cat "${PLUGIN_ROOT}/skills/meta-using-skills/SKILL.md" 2>&1 || echo "Error reading using-skills skill")
+
+# Escape string for JSON embedding
+escape_for_json() {
+    local s="$1"
+    s="${s//\\/\\\\}"
+    s="${s//\"/\\\"}"
+    s="${s//$'\n'/\\n}"
+    s="${s//$'\r'/\\r}"
+    s="${s//$'\t'/\\t}"
+    printf '%s' "$s"
+}
+
+using_skills_escaped=$(escape_for_json "$using_skills_content")
+
+# Check for OpenSpec context
+openspec_context=""
+if [ -f "${PLUGIN_ROOT}/../openspec/specs" ] 2>/dev/null || [ -d "${PLUGIN_ROOT}/../openspec/specs" ] 2>/dev/null; then
+  # Detect active changes
+  active_changes=""
+  if [ -d "${PLUGIN_ROOT}/../openspec/changes" ] 2>/dev/null; then
+    changes_count=$(find "${PLUGIN_ROOT}/../openspec/changes" -maxdepth 1 -mindepth 1 -type d ! -name 'archive' 2>/dev/null | wc -l | tr -d ' ')
+    if [ "$changes_count" -gt 0 ] 2>/dev/null; then
+      active_changes_list=$(find "${PLUGIN_ROOT}/../openspec/changes" -maxdepth 1 -mindepth 1 -type d ! -name 'archive' 2>/dev/null | while read d; do basename "$d"; done | tr '\n' ', ' | sed 's/, $//')
+      active_changes="\nActive changes (${changes_count}): ${active_changes_list}\nUse 'specpow status' to inspect."
+    fi
+  fi
+
+  openspec_context="\nOpenSpec structure detected in this project. Follow the spec-driven workflow:\n1. Explore → planning-explore skill\n2. Propose → planning-propose skill\n3. Write Specs/Design/Tasks → planning-write-* skills\n4. Implement → execution-* skills (SDD engine)\n5. Verify → execution-verification-before-completion\n6. Archive → specpow archive\n${active_changes}\n"
+fi
+
+session_context="<EXTREMELY_IMPORTANT>\nYou have specpow — a spec-powered AI development framework. It combines OpenSpec's spec-driven planning with Superpowers' subagent-driven execution.\n\n**Below is the full content of your 'specpow:meta-using-skills' skill - your introduction to using skills. For all other skills, use the 'Skill' tool:**\n\n${using_skills_escaped}\n\n${openspec_context}\n\nAvailable skill categories:\n- Planning: planning-explore, planning-propose, planning-write-plans, planning-write-specs, planning-write-design\n- Execution: planning-apply-change, execution-subagent-driven-dev, execution-tdd, execution-systematic-debugging, execution-parallel-agents\n- Quality: execution-requesting-review, execution-receiving-review, execution-verification-before-completion, planning-verify-change\n- Business: business-java-codegen, business-ui-codegen, business-test-gen, business-code-review, business-db-design, business-prd-writer, business-deploy-check\n\nRemember: Check for relevant skills BEFORE any action.\n</EXTREMELY_IMPORTANT>"
+
+# Output context injection as JSON
+# Cursor hooks expect additional_context (snake_case)
+# Claude Code hooks expect hookSpecificOutput.additionalContext (nested)
+# Copilot CLI (v1.0.11+) and others expect additionalContext (top-level, SDK standard)
+if [ -n "${CURSOR_PLUGIN_ROOT:-}" ]; then
+  # Cursor sets CURSOR_PLUGIN_ROOT (may also set CLAUDE_PLUGIN_ROOT)
+  printf '{\n  "additional_context": "%s"\n}\n' "$session_context" | cat
+elif [ -n "${CLAUDE_PLUGIN_ROOT:-}" ] && [ -z "${COPILOT_CLI:-}" ]; then
+  # Claude Code sets CLAUDE_PLUGIN_ROOT without COPILOT_CLI
+  printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "SessionStart",\n    "additionalContext": "%s"\n  }\n}\n' "$session_context" | cat
+else
+  # Copilot CLI (sets COPILOT_CLI=1) or unknown platform — SDK standard format
+  printf '{\n  "additionalContext": "%s"\n}\n' "$session_context" | cat
+fi
+
+exit 0

package/hooks/workflow-state

@@ -0,0 +1,150 @@
+#!/usr/bin/env bash
+# SpecPow Workflow State Hook
+#
+# 在用户提交提示时注入当前工作流状态
+# 兼容 Claude Code、Cursor、Copilot CLI 等平台
+
+set -euo pipefail
+
+# Determine plugin root directory
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+PROJECT_ROOT="$(cd "${PLUGIN_ROOT}/.." 2>/dev/null && pwd || echo "${PLUGIN_ROOT}")"
+
+# Escape string for JSON embedding
+escape_for_json() {
+    local s="$1"
+    s="${s//\\/\\\\}"
+    s="${s//\"/\\\"}"
+    s="${s//$'\n'/\\n}"
+    s="${s//$'\r'/\\r}"
+    s="${s//$'\t'/\\t}"
+    printf '%s' "$s"
+}
+
+# Detect active change
+detect_active_change() {
+    local changes_dir="${PROJECT_ROOT}/openspec/changes"
+    if [ ! -d "$changes_dir" ]; then
+        echo ""
+        return
+    fi
+
+    # Find first active change (excluding archive)
+    local change_name=""
+    for dir in "$changes_dir"/*/; do
+        local basename=$(basename "$dir")
+        if [ "$basename" != "archive" ] && [ -d "$dir" ]; then
+            change_name="$basename"
+            break
+        fi
+    done
+
+    if [ -z "$change_name" ]; then
+        echo ""
+        return
+    fi
+
+    echo "$change_name"
+}
+
+# Infer workflow stage from change directory contents
+infer_stage() {
+    local change_name="$1"
+    local change_dir="${PROJECT_ROOT}/openspec/changes/${change_name}"
+
+    if [ ! -d "$change_dir" ]; then
+        echo "idle"
+        return
+    fi
+
+    # Check for verify/review files
+    if ls "$change_dir"/*verify* 2>/dev/null | head -1 > /dev/null || \
+       ls "$change_dir"/*review* 2>/dev/null | head -1 > /dev/null; then
+        echo "verify"
+        return
+    fi
+
+    # Check for tasks files
+    if ls "$change_dir"/*tasks* 2>/dev/null | head -1 > /dev/null; then
+        echo "apply"
+        return
+    fi
+
+    # Check for spec/design files
+    if ls "$change_dir"/*spec* 2>/dev/null | head -1 > /dev/null || \
+       ls "$change_dir"/*design* 2>/dev/null | head -1 > /dev/null; then
+        echo "propose"
+        return
+    fi
+
+    echo "explore"
+}
+
+# Main logic
+change_name=$(detect_active_change)
+
+if [ -z "$change_name" ]; then
+    # No active change, no context to inject
+    exit 0
+fi
+
+stage=$(infer_stage "$change_name")
+
+# Build workflow context
+workflow_context="<!-- workflow-state: ${stage} -->\n<!-- active-change: ${change_name} -->"
+
+# Add stage hint
+case "$stage" in
+    explore)
+        workflow_context="${workflow_context}\n🔍 当前阶段: EXPLORE — 使用 planning-explore 技能理解需求"
+        ;;
+    propose)
+        workflow_context="${workflow_context}\n📝 当前阶段: PROPOSE — 使用 planning-propose 创建变更提案"
+        ;;
+    apply)
+        workflow_context="${workflow_context}\n⚙️ 当前阶段: APPLY — 使用 planning-apply-change 执行实现"
+        ;;
+    verify)
+        workflow_context="${workflow_context}\n✅ 当前阶段: VERIFY — 使用 planning-verify-change 验证规范"
+        ;;
+    archive)
+        workflow_context="${workflow_context}\n📦 当前阶段: ARCHIVE — 运行 specpow archive 合并到主规范"
+        ;;
+esac
+
+# Check progress
+change_dir="${PROJECT_ROOT}/openspec/changes/${change_name}"
+progress=""
+if ls "$change_dir"/*proposal* 2>/dev/null | head -1 > /dev/null; then
+    progress="${progress}✓ proposal"
+fi
+if ls "$change_dir"/*spec* 2>/dev/null | head -1 > /dev/null; then
+    [ -n "$progress" ] && progress="${progress}, "
+    progress="${progress}✓ specs"
+fi
+if ls "$change_dir"/*tasks* 2>/dev/null | head -1 > /dev/null; then
+    [ -n "$progress" ] && progress="${progress}, "
+    progress="${progress}✓ tasks"
+fi
+
+if [ -n "$progress" ]; then
+    workflow_context="${workflow_context}\n进度: ${progress}"
+fi
+
+# Escape for JSON
+workflow_context_escaped=$(escape_for_json "$workflow_context")
+
+# Output based on platform
+if [ -n "${CURSOR_PLUGIN_ROOT:-}" ]; then
+    # Cursor format
+    printf '{\n  "additional_context": "%s"\n}\n' "$workflow_context_escaped" | cat
+elif [ -n "${CLAUDE_PLUGIN_ROOT:-}" ] && [ -z "${COPILOT_CLI:-}" ]; then
+    # Claude Code format
+    printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "UserPromptSubmit",\n    "additionalContext": "%s"\n  }\n}\n' "$workflow_context_escaped" | cat
+else
+    # Copilot CLI or unknown platform
+    printf '{\n  "additionalContext": "%s"\n}\n' "$workflow_context_escaped" | cat
+fi
+
+exit 0

package/package.json

@@ -0,0 +1,122 @@
+{
+  "name": "@specpow/framework",
+  "version": "0.2.0",
+  "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/",
+    "skills/",
+    "agents/",
+    "schemas/",
+    "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": [
+      "./skills"
+    ]
+  }
+}

package/schemas/bug-fix/schema.yaml

@@ -0,0 +1,64 @@
+# Bug 修复 Schema
+# 用于快速定位和修复 Bug 的工件流
+
+name: bug-fix
+description: 系统化定位和修复 Bug
+
+apply:
+  requires:
+    - tasks
+
+artifacts:
+  - id: proposal
+    name: Bug 描述
+    description: 描述 Bug 现象和复现步骤
+    requires: []
+    template: templates/proposal.md
+    instruction: |
+      记录 Bug 信息：
+      - Bug 标题
+      - 复现步骤（Step 1, 2, 3...）
+      - 预期行为
+      - 实际行为
+      - 环境信息
+      - 影响范围
+    output: proposal.md
+
+  - id: analysis
+    name: 根因分析
+    description: 分析 Bug 根因
+    requires: [proposal]
+    template: templates/analysis.md
+    instruction: |
+      根因分析（4 阶段）：
+      1. 调查 — 收集日志、堆栈、复现
+      2. 模式分析 — 识别错误模式
+      3. 假设 — 提出根因假设
+      4. 验证 — 验证假设正确性
+    output: analysis.md
+
+  - id: fix-plan
+    name: 修复计划
+    description: 制定修复方案
+    requires: [analysis]
+    template: templates/fix-plan.md
+    instruction: |
+      修复方案：
+      - 修复策略（热修复/正常修复/重构修复）
+      - 修改文件列表
+      - 回归测试计划
+    output: fix-plan.md
+
+  - id: tasks
+    name: 修复任务
+    description: 修复步骤拆分
+    requires: [fix-plan]
+    template: templates/tasks.md
+    instruction: |
+      修复任务拆分：
+      1. 编写失败测试（复现 Bug）
+      2. 修复代码
+      3. 验证测试通过
+      4. 回归测试
+      5. 更新文档
+    output: tasks.md

package/schemas/bug-fix/templates/analysis.md

@@ -0,0 +1,43 @@
+# 根因分析
+
+## 1. 调查
+
+### 错误日志
+```
+（关键错误日志）
+```
+
+### 堆栈跟踪
+```
+（关键堆栈）
+```
+
+### 复现结果
+- 是否可稳定复现: 是/否
+- 复现频率: 
+
+## 2. 模式分析
+
+### 错误模式
+- 错误类型: 
+- 涉及模块: 
+- 最近变更: 
+
+## 3. 假设
+
+### 假设 1: [描述]
+- 证据: 
+- 验证方法: 
+
+### 假设 2: [描述]
+- 证据: 
+- 验证方法: 
+
+## 4. 结论
+
+### 根因
+[确认的根因描述]
+
+### 影响分析
+- 直接影响: 
+- 间接影响: 

package/schemas/bug-fix/templates/fix-plan.md

@@ -0,0 +1,19 @@
+# 修复方案
+
+## 修复策略
+- [ ] 热修复（紧急上线）
+- [ ] 正常修复（下个版本）
+- [ ] 重构修复（技术债务）
+
+## 修改文件
+| 文件 | 修改类型 | 说明 |
+|------|----------|------|
+| | | |
+
+## 修复描述
+
+
+## 回归测试计划
+- [ ] 原 Bug 场景验证
+- [ ] 相关功能回归
+- [ ] 边界条件验证

package/schemas/bug-fix/templates/proposal.md

@@ -0,0 +1,30 @@
+# Bug 描述
+
+## Bug 标题
+{{bugTitle}}
+
+## 复现步骤
+1. 
+2. 
+3. 
+
+## 预期行为
+
+
+## 实际行为
+
+
+## 环境信息
+- 环境: 
+- 版本: 
+- 浏览器/客户端: 
+
+## 影响范围
+- 影响用户: 
+- 影响功能: 
+- 严重程度: Critical / Major / Minor
+
+## 相关日志
+```
+（粘贴错误日志）
+```