@specpow/framework 0.2.0

package/dist/commands/apply.js

@@ -0,0 +1,195 @@
+/**
+ * apply 命令 - 执行变更实现
+ *
+ * 融合 OpenSpec apply + Superpowers SDD 引擎
+ */
+import chalk from 'chalk';
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { SDDController } from '../core/sdd-engine/controller.js';
+import { ParallelDispatcher, buildParallelLayers } from '../core/sdd-engine/parallel-dispatcher.js';
+import { createTemplateEngine } from '../core/templates/index.js';
+import { parseTasksFromContent, toPlanTasks } from '../core/parsers/index.js';
+import { GlobalConfigManager } from '../core/config/global-config.js';
+import { successResponse, outputJson } from '../core/agent-contract.js';
+export async function applyChange(options) {
+    const projectRoot = process.cwd();
+    const changesDir = join(projectRoot, 'openspec', 'changes');
+    // 确定要应用的变更
+    let changeName = options.change;
+    if (!changeName) {
+        // 自动选择唯一的活跃变更
+        const { readdirSync } = await import('fs');
+        if (!existsSync(changesDir)) {
+            console.log(chalk.red('没有找到变更。使用 "specpow propose <name>" 创建。'));
+            return;
+        }
+        const changes = readdirSync(changesDir, { withFileTypes: true })
+            .filter(d => d.isDirectory())
+            .map(d => d.name);
+        if (changes.length === 0) {
+            console.log(chalk.red('没有找到活跃变更。'));
+            return;
+        }
+        if (changes.length === 1) {
+            changeName = changes[0];
+        }
+        else {
+            console.log(chalk.yellow('多个活跃变更，请指定：'));
+            for (const c of changes) {
+                console.log(`  - ${c}`);
+            }
+            console.log(`\n使用: specpow apply --change <name>`);
+            return;
+        }
+    }
+    const changeDir = join(changesDir, changeName);
+    if (!existsSync(changeDir)) {
+        console.log(chalk.red(`变更 "${changeName}" 不存在。`));
+        return;
+    }
+    console.log(chalk.cyan(`\n⚡ 应用变更: ${chalk.bold(changeName)}\n`));
+    // 读取上下文文件
+    const contextFiles = {};
+    const files = {
+        proposal: join(changeDir, 'proposal.md'),
+        design: join(changeDir, 'design.md'),
+        tasks: join(changeDir, 'tasks.md'),
+    };
+    for (const [key, path] of Object.entries(files)) {
+        if (existsSync(path)) {
+            contextFiles[key] = readFileSync(path, 'utf-8');
+            console.log(chalk.green(`  ✓ 读取: ${key}`));
+        }
+    }
+    // 检查 specs 目录
+    const specsDir = join(changeDir, 'specs');
+    if (existsSync(specsDir)) {
+        const { readdirSync } = await import('fs');
+        const specFiles = readdirSync(specsDir, { recursive: true })
+            .filter(f => f.endsWith('.md'));
+        for (const sf of specFiles) {
+            contextFiles[`specs/${sf}`] = readFileSync(join(specsDir, sf), 'utf-8');
+        }
+        console.log(chalk.green(`  ✓ 读取: specs (${specFiles.length} 个文件)`));
+    }
+    if (!contextFiles.tasks) {
+        console.log(chalk.red('\n  ✗ tasks.md 不存在。请先创建任务列表。'));
+        return;
+    }
+    // 解析任务
+    const parsedTasks = parseTasksFromContent(contextFiles.tasks);
+    const tasks = toPlanTasks(parsedTasks);
+    console.log(`\n  找到 ${chalk.bold(tasks.length)} 个任务\n`);
+    // 使用模板引擎为每个任务生成增强指令
+    const templateEngine = createTemplateEngine(projectRoot, 'spec-driven');
+    for (const task of tasks) {
+        const instruction = templateEngine.generateInstruction('task-default.md', {
+            changeId: changeName,
+            changeTitle: contextFiles.proposal ? contextFiles.proposal.split('\n')[0] : changeName,
+            projectRoot,
+            schemaId: 'spec-driven',
+            timestamp: new Date().toISOString(),
+            task_title: task.title,
+            task_description: task.description,
+        });
+        if (instruction) {
+            task.description = instruction;
+        }
+    }
+    if (tasks.length === 0) {
+        console.log(chalk.yellow('  没有待处理的任务。'));
+        return;
+    }
+    // 初始化 SDD 引擎
+    const workspaceDir = join(projectRoot, '.specpow', 'sdd', changeName);
+    // 从 config.json 读取模型配置
+    const configManager = new GlobalConfigManager(projectRoot);
+    const sddConfig = configManager.get('sdd');
+    // 收集所有 specs 文件内容作为规范约束
+    const allSpecsContent = Object.entries(contextFiles)
+        .filter(([key]) => key.startsWith('specs/'))
+        .map(([, content]) => content)
+        .join('\n---\n');
+    const config = {
+        maxFixRounds: sddConfig?.maxFixRounds || 5,
+        workspaceDir,
+        planFile: files.tasks,
+        implementerModel: sddConfig?.implementerModel || 'sonnet',
+        reviewerModel: sddConfig?.reviewerModel || 'sonnet',
+        finalReviewModel: sddConfig?.finalReviewModel || 'opus',
+        specConstraints: allSpecsContent || '',
+        modelConfig: {
+            cheap: sddConfig?.models?.cheap || 'haiku',
+            standard: sddConfig?.models?.standard || 'sonnet',
+            capable: sddConfig?.models?.capable || 'opus',
+        },
+    };
+    // 并行模式
+    if (options.parallel) {
+        console.log(chalk.cyan('  启动并行执行模式...\n'));
+        console.log(`  工作区: ${chalk.dim(workspaceDir)}`);
+        console.log(`  最大修复轮次: ${config.maxFixRounds}`);
+        console.log('');
+        // 依赖分析
+        const layers = buildParallelLayers(tasks);
+        console.log(chalk.dim(`  📊 依赖分析: ${tasks.length} 个任务 → ${layers.length} 层`));
+        for (let i = 0; i < layers.length; i++) {
+            console.log(chalk.dim(`    第 ${i + 1} 层: ${layers[i].map(t => `T${t.number}`).join(', ')}`));
+        }
+        console.log('');
+        const dispatcher = new ParallelDispatcher(config);
+        const parallelResult = await dispatcher.dispatchAll(tasks, projectRoot);
+        // JSON 输出
+        if (options.json) {
+            const data = {
+                change: changeName,
+                execution: {
+                    mode: 'parallel',
+                    completedTasks: parallelResult.results.filter(r => r.outcome === 'complete').length,
+                    totalTasks: tasks.length,
+                    blockedTasks: parallelResult.results.filter(r => r.outcome === 'blocked').length,
+                    parkedFindings: 0,
+                },
+                conflicts: parallelResult.conflicts.length > 0 ? parallelResult.conflicts : undefined,
+                mergeFailures: parallelResult.mergeFailures.length > 0 ? parallelResult.mergeFailures.map(String) : undefined,
+            };
+            outputJson(successResponse(data));
+            return;
+        }
+        // 人类可读输出
+        console.log(chalk.cyan('\n📊 并行执行结果\n'));
+        console.log(`  完成: ${parallelResult.results.filter(r => r.outcome === 'complete').length}/${tasks.length}`);
+        console.log(`  阻塞: ${parallelResult.results.filter(r => r.outcome === 'blocked').length}`);
+        if (parallelResult.conflicts.length > 0) {
+            console.log(chalk.yellow(`\n  ⚠ 冲突文件:`));
+            for (const c of parallelResult.conflicts) {
+                console.log(chalk.yellow(`    - ${c}`));
+            }
+        }
+        if (parallelResult.mergeFailures.length > 0) {
+            console.log(chalk.red(`\n  ✗ 合并失败任务: ${parallelResult.mergeFailures.join(', ')}`));
+        }
+        console.log(`  状态: ${parallelResult.success ? chalk.green('成功') : chalk.red('部分失败')}`);
+        console.log('');
+        return;
+    }
+    // 串行模式
+    const controller = new SDDController(config);
+    console.log(chalk.cyan('  启动 SDD 引擎...\n'));
+    console.log(`  工作区: ${chalk.dim(workspaceDir)}`);
+    console.log(`  最大修复轮次: ${config.maxFixRounds}`);
+    console.log(`  实现者模型: ${config.implementerModel}`);
+    console.log(`  审查者模型: ${config.reviewerModel}`);
+    console.log('');
+    // 执行
+    const result = await controller.executePlan(tasks, projectRoot);
+    // 输出结果
+    console.log(chalk.cyan('\n📊 执行结果\n'));
+    console.log(`  完成: ${result.completedTasks}/${result.totalTasks}`);
+    console.log(`  阻塞: ${result.blockedTasks}`);
+    console.log(`  停放发现: ${result.parkedFindings}`);
+    console.log(`  状态: ${result.success ? chalk.green('成功') : chalk.red('部分失败')}`);
+    console.log('');
+}
+//# sourceMappingURL=apply.js.map

package/dist/commands/apply.js.map

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

package/dist/commands/archive.d.ts

@@ -0,0 +1,30 @@
+/**
+ * archive 命令 — 变更归档
+ *
+ * 委托给 core/archive/engine.ts 的事务性 ArchiveEngine
+ * 保持向后兼容的导出接口（archiveChange）
+ *
+ * ArchiveEngine 提供：
+ * - 三态决策：write / retire / skip
+ * - 并发安全的指纹验证机制
+ * - 预览-验证-写入-移动-回滚多阶段流程
+ * - 支持批量归档和并行处理
+ */
+export interface ArchiveOptions {
+    change?: string;
+    force?: boolean;
+    json?: boolean;
+}
+export interface ArchiveResult {
+    success: boolean;
+    mergedFiles: string[];
+    conflicts: string[];
+    deletedFiles: string[];
+    archivePath: string;
+}
+/**
+ * CLI 入口：归档变更
+ * 委托给 ArchiveEngine 执行事务性归档
+ */
+export declare function archiveChange(options: ArchiveOptions): Promise<ArchiveResult>;
+//# sourceMappingURL=archive.d.ts.map

package/dist/commands/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/commands/archive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAmGnF"}

package/dist/commands/archive.js

@@ -0,0 +1,141 @@
+/**
+ * archive 命令 — 变更归档
+ *
+ * 委托给 core/archive/engine.ts 的事务性 ArchiveEngine
+ * 保持向后兼容的导出接口（archiveChange）
+ *
+ * ArchiveEngine 提供：
+ * - 三态决策：write / retire / skip
+ * - 并发安全的指纹验证机制
+ * - 预览-验证-写入-移动-回滚多阶段流程
+ * - 支持批量归档和并行处理
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import chalk from 'chalk';
+import { ArchiveEngine } from '../core/archive/engine.js';
+import { successResponse, errorResponse, outputJson } from '../core/agent-contract.js';
+/**
+ * CLI 入口：归档变更
+ * 委托给 ArchiveEngine 执行事务性归档
+ */
+export async function archiveChange(options) {
+    const projectRoot = process.cwd();
+    const changeId = options.change || 'default';
+    console.log(chalk.cyan(`\n📦 归档变更: ${chalk.bold(changeId)}\n`));
+    const engine = new ArchiveEngine(projectRoot);
+    try {
+        const engineResult = await engine.archive(changeId, {
+            yes: true,
+            force: options.force,
+        });
+        // 从归档目录中收集实际合并的文件路径
+        const archiveSpecsDir = path.join(engineResult.path, 'specs');
+        const mergedFiles = [];
+        if (fs.existsSync(archiveSpecsDir)) {
+            const walkForMd = (dir) => {
+                const entries = fs.readdirSync(dir, { withFileTypes: true });
+                const files = [];
+                for (const entry of entries) {
+                    const full = path.join(dir, entry.name);
+                    if (entry.isDirectory())
+                        files.push(...walkForMd(full));
+                    else if (entry.name.endsWith('.md'))
+                        files.push(path.relative(archiveSpecsDir, full));
+                }
+                return files;
+            };
+            mergedFiles.push(...walkForMd(archiveSpecsDir));
+        }
+        // 如果归档目录没有 specs，从变更目录读取
+        const result = {
+            success: true,
+            mergedFiles: mergedFiles.length > 0 ? mergedFiles : Array.from({ length: engineResult.specsUpdated }, (_, i) => `spec-${i + 1}`),
+            conflicts: engineResult.warnings.filter(w => w.toLowerCase().includes('conflict') || w.toLowerCase().includes('冲突')),
+            deletedFiles: [],
+            archivePath: engineResult.path,
+        };
+        const totalMerged = engineResult.totals.added + engineResult.totals.modified + engineResult.totals.removed;
+        // JSON 输出
+        if (options.json) {
+            const data = {
+                change: changeId,
+                archivedAs: engineResult.archivedAs,
+                path: engineResult.path,
+                specsUpdated: engineResult.specsUpdated,
+                totals: engineResult.totals,
+                warnings: engineResult.warnings,
+            };
+            outputJson(successResponse(data));
+            return result; // 返回 result 以满足函数签名
+        }
+        // 输出结果
+        console.log(chalk.dim('  合并 delta 规范到主规范...'));
+        if (engineResult.totals.added > 0) {
+            console.log(chalk.green(`    ✓ 新增: ${engineResult.totals.added} 个规范`));
+        }
+        if (engineResult.totals.modified > 0) {
+            console.log(chalk.green(`    ✓ 修改: ${engineResult.totals.modified} 个规范`));
+        }
+        if (engineResult.totals.removed > 0) {
+            console.log(chalk.green(`    ✓ 退休: ${engineResult.totals.removed} 个规范`));
+        }
+        console.log(chalk.green(`    ✓ 归档至: ${path.relative(projectRoot, engineResult.path)}`));
+        // 归档 proposal/design 到知识库
+        const changeDir = path.join(projectRoot, 'openspec', 'changes', 'archive', engineResult.archivedAs);
+        archiveDesignDocs(projectRoot, changeId, changeDir);
+        // 输出结果
+        console.log('');
+        console.log(chalk.cyan('📊 归档结果'));
+        console.log(`  合并文件: ${totalMerged}`);
+        console.log(`  冲突: ${result.conflicts.length}`);
+        console.log(`  归档路径: ${path.relative(projectRoot, engineResult.path)}`);
+        console.log(`  状态: ${chalk.green('成功')}`);
+        console.log('');
+        return result;
+    }
+    catch (err) {
+        if (options.json) {
+            outputJson(errorResponse(err.message, 'ARCHIVE_FAILED', '检查变更是否存在或目录权限'));
+        }
+        else {
+            console.log(chalk.red(`\n❌ 归档失败: ${err.message}\n`));
+        }
+        return {
+            success: false,
+            mergedFiles: [],
+            conflicts: [err.message],
+            deletedFiles: [],
+            archivePath: '',
+        };
+    }
+}
+/**
+ * 归档 proposal/design 文档到知识库
+ */
+function archiveDesignDocs(projectRoot, changeId, archiveDir) {
+    const docsToArchive = [
+        { file: 'proposal.md', docType: 'proposals' },
+        { file: 'design.md', docType: 'design-decisions' },
+    ];
+    for (const { file, docType } of docsToArchive) {
+        const filePath = path.join(archiveDir, file);
+        if (!fs.existsSync(filePath))
+            continue;
+        const archivePath = path.join(projectRoot, 'openspec', 'docs', `${docType}-archive.md`);
+        const dir = path.dirname(archivePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const header = `\n\n---\n## ${changeId} — ${new Date().toISOString()}\n`;
+        const toAppend = header + content;
+        if (fs.existsSync(archivePath)) {
+            fs.appendFileSync(archivePath, toAppend, 'utf-8');
+        }
+        else {
+            fs.writeFileSync(archivePath, `# ${docType} 归档\n${toAppend}`, 'utf-8');
+        }
+    }
+}
+//# sourceMappingURL=archive.js.map

package/dist/commands/archive.js.map

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

package/dist/commands/channel.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Channel CLI 命令组
+ *
+ * 提供多代理协作 Channel 的 CLI 入口：
+ * - start/stop 管理 Channel 生命周期
+ * - status 查看运行状态
+ * - workers 管理 Worker 代理
+ * - send 发送消息
+ * - tasks 管理任务
+ *
+ * 状态持久化到 .specpow/channel/state.json
+ */
+interface ChannelStartOptions {
+    maxAgents?: string;
+    json?: boolean;
+}
+interface ChannelStatusOptions {
+    json?: boolean;
+}
+interface ChannelWorkersOptions {
+    json?: boolean;
+}
+interface ChannelSendOptions {
+    type?: string;
+    priority?: string;
+    json?: boolean;
+}
+interface ChannelTasksOptions {
+    json?: boolean;
+}
+interface ChannelStopOptions {
+    json?: boolean;
+}
+interface ChannelWorkersAddOptions {
+    role?: string;
+    json?: boolean;
+}
+interface ChannelTasksCreateOptions {
+    assignee: string;
+    description: string;
+    json?: boolean;
+}
+interface ChannelTasksUpdateOptions {
+    status: string;
+    result?: string;
+    json?: boolean;
+}
+export declare function channelStart(name: string, options: ChannelStartOptions): Promise<void>;
+export declare function channelStatus(options: ChannelStatusOptions): Promise<void>;
+export declare function channelWorkers(options: ChannelWorkersOptions): Promise<void>;
+export declare function channelWorkersAdd(id: string, name: string, options: ChannelWorkersAddOptions): Promise<void>;
+export declare function channelWorkersRemove(id: string, options: {
+    json?: boolean;
+}): Promise<void>;
+export declare function channelSend(target: string, message: string, options: ChannelSendOptions): Promise<void>;
+export declare function channelTasks(options: ChannelTasksOptions): Promise<void>;
+export declare function channelTasksCreate(options: ChannelTasksCreateOptions): Promise<void>;
+export declare function channelTasksUpdate(taskId: string, options: ChannelTasksUpdateOptions): Promise<void>;
+export declare function channelStop(options: ChannelStopOptions): Promise<void>;
+export {};
+//# sourceMappingURL=channel.d.ts.map

package/dist/commands/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../src/commands/channel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAqFH,UAAU,mBAAmB;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,oBAAoB;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,qBAAqB;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,kBAAkB;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,mBAAmB;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,kBAAkB;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,wBAAwB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,yBAAyB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,yBAAyB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAID,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoD5F;AAID,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqEhF;AAID,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwClF;AAID,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqElH;AAID,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCjG;AAID,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoE7G;AAID,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8D9E;AAID,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgE1F;AAID,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsE1G;AAID,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2C5E"}