@specpow/framework 0.2.0

package/dist/commands/workflow/index.js

@@ -0,0 +1,435 @@
+import * as fs from 'fs/promises';
+import { existsSync, readFileSync, readdirSync, mkdirSync, writeFileSync, unlinkSync } from 'fs';
+import { execFileSync } from 'child_process';
+import * as path from 'path';
+import * as yaml from 'yaml';
+import chalk from 'chalk';
+import { tmpdir } from 'os';
+/**
+ * 运行工作流
+ */
+export async function runWorkflow(options) {
+    const projectRoot = process.cwd();
+    const workflowsDir = path.join(projectRoot, 'workflows');
+    // 列出可用工作流
+    if (options.list) {
+        await listWorkflows(workflowsDir);
+        return;
+    }
+    if (!options.workflow) {
+        console.error(chalk.red('错误: 请指定工作流名称 (--workflow <name>)'));
+        process.exit(1);
+    }
+    // 加载工作流定义
+    const workflowFile = path.join(workflowsDir, `${options.workflow}.yaml`);
+    let workflowContent;
+    try {
+        workflowContent = await fs.readFile(workflowFile, 'utf-8');
+    }
+    catch (error) {
+        console.error(chalk.red(`错误: 找不到工作流 "${options.workflow}"`));
+        process.exit(1);
+    }
+    const workflow = yaml.parse(workflowContent);
+    console.log(chalk.blue(`\n🚀 启动工作流: ${workflow.name}`));
+    console.log(chalk.gray(`   ${workflow.description}\n`));
+    // 确定要执行的阶段
+    let phasesToRun = workflow.phases;
+    if (options.fromPhase) {
+        const startIndex = phasesToRun.findIndex(p => p.name === options.fromPhase);
+        if (startIndex === -1) {
+            console.error(chalk.red(`错误: 找不到阶段 "${options.fromPhase}"`));
+            process.exit(1);
+        }
+        phasesToRun = phasesToRun.slice(startIndex);
+    }
+    if (options.skipPhase && options.skipPhase.length > 0) {
+        phasesToRun = phasesToRun.filter(p => !options.skipPhase.includes(p.name));
+    }
+    // 验证技能是否存在
+    const skillMap = discoverSkills(path.join(projectRoot, 'skills'));
+    // 执行阶段
+    for (let i = 0; i < phasesToRun.length; i++) {
+        const phase = phasesToRun[i];
+        const phaseNum = i + 1;
+        console.log(chalk.cyan(`\n${'='.repeat(60)}`));
+        console.log(chalk.cyan(`阶段 ${phaseNum}/${phasesToRun.length}: ${phase.name}`));
+        console.log(chalk.cyan(`${'='.repeat(60)}`));
+        console.log(chalk.gray(`${phase.description}\n`));
+        if (options.dryRun) {
+            console.log(chalk.yellow('[预览模式] 将执行以下技能:'));
+            phase.skills.forEach(skill => {
+                const found = skillMap.has(skill);
+                console.log(chalk.yellow(`  ${found ? '✓' : '✗'} ${skill}${found ? '' : ' (未找到)'}`));
+            });
+            continue;
+        }
+        // 执行技能
+        for (const skill of phase.skills) {
+            console.log(chalk.white(`\n▶ 执行技能: ${skill}`));
+            const result = await executeSkill(skill, skillMap, projectRoot, options.change);
+            if (result.status === 'executed') {
+                console.log(chalk.green(`  ✓ ${result.message}`));
+            }
+            else if (result.status === 'not_found') {
+                console.log(chalk.yellow(`  ⚠ ${result.message}`));
+            }
+            else {
+                console.log(chalk.red(`  ✗ ${result.message}`));
+                // 技能执行失败 — 可选是否中止工作流
+                if (result.status === 'failed') {
+                    console.log(chalk.yellow(`  跳过失败技能，继续下一项...`));
+                }
+            }
+        }
+        // 检查门禁
+        if (phase.gates && phase.gates.length > 0) {
+            console.log(chalk.gray(`\n🔒 检查门禁: ${phase.gates.join(', ')}`));
+            const gateResults = await checkGates(phase.gates, projectRoot, options.change);
+            let allPassed = true;
+            for (const gateResult of gateResults) {
+                if (gateResult.passed) {
+                    console.log(chalk.green(`  ✓ ${gateResult.gate}: ${gateResult.message}`));
+                }
+                else {
+                    console.log(chalk.red(`  ✗ ${gateResult.gate}: ${gateResult.message}`));
+                    allPassed = false;
+                }
+            }
+            if (!allPassed) {
+                console.log(chalk.red(`\n✗ 门禁未通过，工作流中止`));
+                process.exit(1);
+            }
+        }
+        console.log(chalk.green(`✓ 阶段 ${phase.name} 完成`));
+    }
+    console.log(chalk.green.bold(`\n✨ 工作流完成!\n`));
+}
+// ============================================================
+// 技能发现与执行
+// ============================================================
+/**
+ * 发现所有可用技能
+ *
+ * 扫描 skills/ 目录，建立技能名 → 技能文件的映射
+ */
+function discoverSkills(skillsDir) {
+    const skillMap = new Map();
+    if (!existsSync(skillsDir)) {
+        return skillMap;
+    }
+    try {
+        const entries = readdirSync(skillsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const skillDir = path.join(skillsDir, entry.name);
+            const skillFile = path.join(skillDir, 'SKILL.md');
+            if (existsSync(skillFile)) {
+                // 目录名即为技能名
+                skillMap.set(entry.name, skillFile);
+            }
+        }
+    }
+    catch {
+        // 技能目录读取失败
+    }
+    return skillMap;
+}
+/**
+ * 执行单个技能
+ *
+ * 加载 SKILL.md 内容，构建 prompt，通过 AI 后端（claude CLI）实际执行。
+ * 执行完成后将输出记录到工作流日志。
+ */
+async function executeSkill(skillName, skillMap, projectRoot, changeName) {
+    // 在 skillMap 中查找
+    const skillPath = skillMap.get(skillName);
+    if (!skillPath) {
+        return {
+            status: 'not_found',
+            message: `技能 "${skillName}" 未在 skills/ 目录中找到`,
+        };
+    }
+    // 加载技能文件
+    let skillContent;
+    try {
+        skillContent = readFileSync(skillPath, 'utf-8');
+    }
+    catch (err) {
+        return {
+            status: 'failed',
+            message: `加载技能文件失败: ${err.message}`,
+        };
+    }
+    const description = extractSkillDescription(skillContent);
+    // ── 构建 prompt ──
+    const promptParts = [
+        `# 工作流技能执行: ${skillName}`,
+        ``,
+        `## 项目上下文`,
+        `- 项目根目录: ${projectRoot}`,
+        `- 当前变更: ${changeName || 'N/A'}`,
+        `- 执行时间: ${new Date().toISOString()}`,
+        ``,
+        `## 技能指令`,
+        ``,
+        `请严格按照以下技能文件的内容执行任务。`,
+        `技能文件路径: ${skillPath}`,
+        ``,
+        `---`,
+        ``,
+        skillContent,
+    ];
+    if (changeName) {
+        promptParts.push(``, `---`, ``, `## 变更上下文`, `当前变更目录: openspec/changes/${changeName}/`, `请在执行时参考该目录下的 proposal.md、specs/、design.md、tasks.md 文件。`);
+    }
+    const promptContent = promptParts.join('\n');
+    // ── 执行 ──
+    try {
+        // 读取配置的 AI 工具
+        const configPath = path.join(projectRoot, '.specpow', 'config.json');
+        let aiTool = 'claude'; // 默认值
+        if (existsSync(configPath)) {
+            try {
+                const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+                aiTool = config.aiTool || 'claude';
+            }
+            catch {
+                // 配置读取失败，使用默认值
+            }
+        }
+        // 写入临时 prompt 文件
+        const promptFile = path.join(tmpdir(), `specpow-skill-${skillName}-${Date.now()}.md`);
+        writeFileSync(promptFile, promptContent, 'utf-8');
+        let output;
+        try {
+            // 根据 AI 工具选择不同的命令和参数
+            const cmd = aiTool;
+            const args = aiTool === 'claude'
+                ? ['--print', '--file', promptFile]
+                : ['--file', promptFile]; // 其他工具的参数格式
+            output = execFileSync(cmd, args, {
+                cwd: projectRoot,
+                encoding: 'utf-8',
+                timeout: 600_000, // 10 分钟超时
+                maxBuffer: 10 * 1024 * 1024,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+        }
+        finally {
+            // 清理临时文件
+            try {
+                unlinkSync(promptFile);
+            }
+            catch { /* ignore */ }
+        }
+        // 记录执行结果到日志
+        const logDir = path.join(projectRoot, '.specpow', 'workflow-logs');
+        if (!existsSync(logDir)) {
+            mkdirSync(logDir, { recursive: true });
+        }
+        const logEntry = [
+            `---`,
+            `技能: ${skillName}`,
+            `时间: ${new Date().toISOString()}`,
+            `变更: ${changeName || 'N/A'}`,
+            `描述: ${description}`,
+            `状态: executed`,
+            `---`,
+            ``,
+            `## 技能内容`,
+            ``,
+            skillContent.substring(0, 5000),
+            ``,
+            `## 执行输出`,
+            ``,
+            output.substring(0, 10000),
+        ].join('\n');
+        const logFile = path.join(logDir, `${Date.now()}-${skillName}.md`);
+        await fs.writeFile(logFile, logEntry, 'utf-8');
+        return {
+            status: 'executed',
+            message: `${skillName} — ${description}（已执行）`,
+        };
+    }
+    catch (err) {
+        // 执行失败也记录日志
+        const logDir = path.join(projectRoot, '.specpow', 'workflow-logs');
+        if (!existsSync(logDir)) {
+            mkdirSync(logDir, { recursive: true });
+        }
+        const logEntry = [
+            `---`,
+            `技能: ${skillName}`,
+            `时间: ${new Date().toISOString()}`,
+            `变更: ${changeName || 'N/A'}`,
+            `描述: ${description}`,
+            `状态: failed`,
+            `错误: ${err.message}`,
+            `---`,
+        ].join('\n');
+        const logFile = path.join(logDir, `${Date.now()}-${skillName}-error.md`);
+        await fs.writeFile(logFile, logEntry, 'utf-8');
+        return {
+            status: 'failed',
+            message: `执行技能 "${skillName}" 失败: ${err.message}`,
+        };
+    }
+}
+/**
+ * 从 SKILL.md 中提取描述
+ */
+function extractSkillDescription(content) {
+    // 查找第一行非空文本作为描述
+    const lines = content.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed && !trimmed.startsWith('#') && !trimmed.startsWith('-') && trimmed.length > 10) {
+            return trimmed.substring(0, 100);
+        }
+    }
+    return '技能描述未找到';
+}
+// ============================================================
+// 门禁检查
+// ============================================================
+/**
+ * 执行门禁检查
+ *
+ * 支持以下门禁类型：
+ * - spec-complete: 确保 specs 目录存在且非空
+ * - design-approved: 确保 design.md 存在
+ * - tasks-existent: 确保 tasks.md 存在且包含任务
+ * - lint-pass: 确保 linter 无错误
+ * - test-pass: 确保测试通过
+ * - review-complete: 确保所有审查已通过
+ */
+async function checkGates(gates, projectRoot, changeName) {
+    const results = [];
+    const changeDir = changeName
+        ? path.join(projectRoot, 'openspec', 'changes', changeName)
+        : null;
+    for (const gate of gates) {
+        const result = await checkSingleGate(gate, projectRoot, changeDir);
+        results.push(result);
+    }
+    return results;
+}
+/**
+ * 检查单个门禁
+ */
+async function checkSingleGate(gate, projectRoot, changeDir) {
+    switch (gate) {
+        case 'spec-complete': {
+            if (!changeDir) {
+                return { gate, passed: false, message: '未指定变更名称' };
+            }
+            const specsDir = path.join(changeDir, 'specs');
+            if (!existsSync(specsDir)) {
+                return { gate, passed: false, message: 'specs/ 目录不存在' };
+            }
+            const specFiles = readdirSync(specsDir).filter(f => f.endsWith('.md'));
+            if (specFiles.length === 0) {
+                return { gate, passed: false, message: 'specs/ 目录为空' };
+            }
+            return { gate, passed: true, message: `${specFiles.length} 个规范文件` };
+        }
+        case 'design-approved': {
+            if (!changeDir) {
+                return { gate, passed: false, message: '未指定变更名称' };
+            }
+            const designFile = path.join(changeDir, 'design.md');
+            if (!existsSync(designFile)) {
+                return { gate, passed: false, message: 'design.md 不存在' };
+            }
+            const designContent = readFileSync(designFile, 'utf-8');
+            if (designContent.trim().length < 50) {
+                return { gate, passed: false, message: 'design.md 内容过短' };
+            }
+            return { gate, passed: true, message: 'design.md 已就绪' };
+        }
+        case 'tasks-existent': {
+            if (!changeDir) {
+                return { gate, passed: false, message: '未指定变更名称' };
+            }
+            const tasksFile = path.join(changeDir, 'tasks.md');
+            if (!existsSync(tasksFile)) {
+                return { gate, passed: false, message: 'tasks.md 不存在' };
+            }
+            const tasksContent = readFileSync(tasksFile, 'utf-8');
+            const hasTasks = /- \[ \] \*\*Task \d+\*\*/.test(tasksContent);
+            if (!hasTasks) {
+                return { gate, passed: false, message: 'tasks.md 中没有待执行的任务' };
+            }
+            return { gate, passed: true, message: 'tasks.md 已就绪' };
+        }
+        case 'lint-pass': {
+            try {
+                execFileSync('npm', ['run', 'lint', '--', '--max-warnings', '0'], {
+                    cwd: projectRoot,
+                    timeout: 60000,
+                    stdio: 'pipe',
+                });
+                return { gate, passed: true, message: 'Lint 通过' };
+            }
+            catch {
+                return { gate, passed: false, message: 'Lint 失败或有警告' };
+            }
+        }
+        case 'test-pass': {
+            try {
+                execFileSync('npm', ['test', '--', '--run'], {
+                    cwd: projectRoot,
+                    timeout: 120000,
+                    stdio: 'pipe',
+                });
+                return { gate, passed: true, message: '测试通过' };
+            }
+            catch {
+                return { gate, passed: false, message: '测试失败' };
+            }
+        }
+        case 'review-complete': {
+            if (!changeDir) {
+                return { gate, passed: false, message: '未指定变更名称' };
+            }
+            const sddDir = path.join(projectRoot, '.specpow', 'sdd');
+            // 检查是否有已完成的审查记录
+            if (!existsSync(sddDir)) {
+                return { gate, passed: false, message: '无 SDD 工作目录，审查未进行' };
+            }
+            // 检查最终审查报告是否存在
+            const reviewReportPath = path.join(sddDir, 'reviews', 'final-review.md');
+            if (!existsSync(reviewReportPath)) {
+                return { gate, passed: false, message: '审查未完成：缺少 final-review.md 报告' };
+            }
+            return { gate, passed: true, message: '审查已完成' };
+        }
+        default:
+            return { gate, passed: false, message: `门禁 "${gate}" 未定义，无法验证（请检查 workflows/ 中的门禁配置）` };
+    }
+}
+// ============================================================
+// 工作流列表
+// ============================================================
+async function listWorkflows(workflowsDir) {
+    try {
+        const files = await fs.readdir(workflowsDir);
+        const yamlFiles = files.filter(f => f.endsWith('.yaml'));
+        console.log(chalk.blue('\n可用工作流:\n'));
+        for (const file of yamlFiles) {
+            const content = await fs.readFile(path.join(workflowsDir, file), 'utf-8');
+            const workflow = yaml.parse(content);
+            console.log(chalk.cyan(`  ${workflow.name}`));
+            console.log(chalk.gray(`    ${workflow.description}`));
+            console.log(chalk.gray(`    阶段: ${workflow.phases.map(p => p.name).join(' → ')}`));
+            console.log();
+        }
+    }
+    catch (error) {
+        console.error(chalk.red(`Error: Cannot read workflows directory: ${error.message}`));
+        console.error(chalk.yellow(`Please ensure workflows directory exists at: ${workflowsDir}`));
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/workflow/index.js.map

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

package/dist/core/agent-contract.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Agent Contract — 统一的 JSON 输出格式
+ *
+ * 移植自 OpenSpec 的 agent-contract 模式，为 AI 代理提供结构化输出
+ *
+ * 所有命令支持 --json 选项时，输出格式为：
+ * {
+ *   status: 'success' | 'error' | 'blocked',
+ *   data?: any,
+ *   diagnostics?: Array<{ severity, code, message, fix? }>,
+ *   nextSteps?: string[]
+ * }
+ */
+export type AgentStatus = 'success' | 'error' | 'blocked' | 'warning';
+export type DiagnosticSeverity = 'info' | 'warning' | 'error' | 'critical';
+export interface Diagnostic {
+    /** 严重程度 */
+    severity: DiagnosticSeverity;
+    /** 诊断代码（如 CONFIG_MISSING, SCHEMA_INVALID） */
+    code: string;
+    /** 人类可读的消息 */
+    message: string;
+    /** 修复建议 */
+    fix?: string;
+}
+export interface AgentResponse<T = any> {
+    /** 操作状态 */
+    status: AgentStatus;
+    /** 响应数据（命令特定） */
+    data?: T;
+    /** 诊断信息（警告、错误、建议） */
+    diagnostics?: Diagnostic[];
+    /** 建议的下一步操作 */
+    nextSteps?: string[];
+}
+/**
+ * status 命令的 data 结构
+ */
+export interface StatusData {
+    change: string;
+    artifacts: Array<{
+        name: string;
+        status: 'complete' | 'incomplete' | 'missing';
+        path: string;
+    }>;
+    tasks: {
+        total: number;
+        complete: number;
+        blocked: number;
+        pending: number;
+    };
+    specs: {
+        added: number;
+        modified: number;
+        removed: number;
+    };
+}
+/**
+ * apply 命令的 data 结构
+ */
+export interface ApplyData {
+    change: string;
+    execution: {
+        mode: 'serial' | 'parallel';
+        completedTasks: number;
+        totalTasks: number;
+        blockedTasks: number;
+        parkedFindings: number;
+    };
+    conflicts?: string[];
+    mergeFailures?: string[];
+}
+/**
+ * propose 命令的 data 结构
+ */
+export interface ProposeData {
+    change: string;
+    artifacts: Array<{
+        name: string;
+        path: string;
+        created: boolean;
+    }>;
+    schema: string;
+}
+/**
+ * archive 命令的 data 结构
+ */
+export interface ArchiveData {
+    change: string;
+    archivedAs: string;
+    path: string;
+    specsUpdated: number;
+    totals: {
+        added: number;
+        modified: number;
+        removed: number;
+        total: number;
+    };
+    warnings: string[];
+}
+/**
+ * schemas 命令的 data 结构
+ */
+export interface SchemasData {
+    schemas: Array<{
+        id: string;
+        name: string;
+        artifactCount: number;
+        valid: boolean;
+        source: 'project' | 'user' | 'builtin';
+    }>;
+}
+/**
+ * 创建成功的响应
+ */
+export declare function successResponse<T>(data: T, diagnostics?: Diagnostic[]): AgentResponse<T>;
+/**
+ * 创建错误的响应
+ */
+export declare function errorResponse(message: string, code: string, fix?: string): AgentResponse;
+/**
+ * 创建阻塞的响应
+ */
+export declare function blockedResponse(message: string, nextSteps: string[]): AgentResponse;
+/**
+ * 创建警告的响应
+ */
+export declare function warningResponse<T>(data: T, warnings: Diagnostic[]): AgentResponse<T>;
+/**
+ * 输出 JSON 响应（用于 --json 模式）
+ */
+export declare function outputJson(response: AgentResponse): void;
+//# sourceMappingURL=agent-contract.d.ts.map

package/dist/core/agent-contract.d.ts.map

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

package/dist/core/agent-contract.js

@@ -0,0 +1,71 @@
+/**
+ * Agent Contract — 统一的 JSON 输出格式
+ *
+ * 移植自 OpenSpec 的 agent-contract 模式，为 AI 代理提供结构化输出
+ *
+ * 所有命令支持 --json 选项时，输出格式为：
+ * {
+ *   status: 'success' | 'error' | 'blocked',
+ *   data?: any,
+ *   diagnostics?: Array<{ severity, code, message, fix? }>,
+ *   nextSteps?: string[]
+ * }
+ */
+// ============================================================
+// 辅助函数
+// ============================================================
+/**
+ * 创建成功的响应
+ */
+export function successResponse(data, diagnostics) {
+    return {
+        status: 'success',
+        data,
+        diagnostics,
+    };
+}
+/**
+ * 创建错误的响应
+ */
+export function errorResponse(message, code, fix) {
+    return {
+        status: 'error',
+        diagnostics: [{
+                severity: 'error',
+                code,
+                message,
+                fix,
+            }],
+    };
+}
+/**
+ * 创建阻塞的响应
+ */
+export function blockedResponse(message, nextSteps) {
+    return {
+        status: 'blocked',
+        diagnostics: [{
+                severity: 'warning',
+                code: 'BLOCKED',
+                message,
+            }],
+        nextSteps,
+    };
+}
+/**
+ * 创建警告的响应
+ */
+export function warningResponse(data, warnings) {
+    return {
+        status: 'warning',
+        data,
+        diagnostics: warnings,
+    };
+}
+/**
+ * 输出 JSON 响应（用于 --json 模式）
+ */
+export function outputJson(response) {
+    console.log(JSON.stringify(response, null, 2));
+}
+//# sourceMappingURL=agent-contract.js.map

package/dist/core/agent-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-contract.js","sourceRoot":"","sources":["../../src/core/agent-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAsHH,+DAA+D;AAC/D,OAAO;AACP,+DAA+D;AAE/D;;GAEG;AACH,MAAM,UAAU,eAAe,CAAI,IAAO,EAAE,WAA0B;IACpE,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,IAAI;QACJ,WAAW;KACZ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,IAAY,EAAE,GAAY;IACvE,OAAO;QACL,MAAM,EAAE,OAAO;QACf,WAAW,EAAE,CAAC;gBACZ,QAAQ,EAAE,OAAO;gBACjB,IAAI;gBACJ,OAAO;gBACP,GAAG;aACJ,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,SAAmB;IAClE,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,CAAC;gBACZ,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,SAAS;gBACf,OAAO;aACR,CAAC;QACF,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAI,IAAO,EAAE,QAAsB;IAChE,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,IAAI;QACJ,WAAW,EAAE,QAAQ;KACtB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,QAAuB;IAChD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC"}