@specpow/framework 0.2.0

package/dist/commands/execute.js

@@ -0,0 +1,120 @@
+/**
+ * execute 命令 — 直接执行任务（跳过规范流程）
+ *
+ * 用于快速执行单个任务，不经过完整的 propose → apply 流程
+ * 适用于：紧急修复、小改动、实验性修改
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { SDDController } from '../core/sdd-engine/controller.js';
+import { ParallelDispatcher, buildParallelLayers } from '../core/sdd-engine/parallel-dispatcher.js';
+import { parseTasksFromContent, toPlanTasks } from '../core/parsers/index.js';
+/**
+ * 直接执行任务
+ */
+export async function executeTask(projectRoot, options) {
+    console.log(`\n🚀 直接执行任务: ${options.task}\n`);
+    const workspaceDir = path.join(projectRoot, '.specpow', 'sdd', 'direct-execute');
+    const planFile = path.join(workspaceDir, 'plan.md');
+    // 构建 SDD 配置 — 与 types.ts 的 SDDConfig 接口对齐
+    const config = {
+        maxFixRounds: 3,
+        workspaceDir,
+        planFile,
+        implementerModel: options.model || 'sonnet',
+        reviewerModel: options.model || 'sonnet',
+        finalReviewModel: options.model || 'opus',
+        specConstraints: options.task,
+    };
+    if (options.dryRun) {
+        console.log('📋 [Dry Run] SDD 配置:');
+        console.log(JSON.stringify(config, null, 2));
+        return;
+    }
+    // 初始化 SDD 控制器（单参数构造函数）
+    const controller = new SDDController(config);
+    try {
+        await controller.initialize();
+        // 构建 PlanTask 数组
+        const tasks = [{
+                number: 1,
+                title: options.task,
+                description: options.task,
+                files: options.files || [],
+            }];
+        // executePlan(PlanTask[], projectContext)
+        await controller.executePlan(tasks, projectRoot);
+        console.log('\n✅ 任务执行完成\n');
+    }
+    catch (err) {
+        console.error(`\n❌ 执行失败: ${err.message}\n`);
+        throw err;
+    }
+}
+/**
+ * CLI 入口：执行 SDD
+ */
+export async function executeSDD(planFile, options) {
+    console.log(`\n🚀 执行 SDD 计划: ${planFile}\n`);
+    const projectRoot = process.cwd();
+    // 读取计划文件
+    if (!fs.existsSync(planFile)) {
+        console.error(`❌ 计划文件不存在: ${planFile}`);
+        process.exit(1);
+    }
+    const planContent = fs.readFileSync(planFile, 'utf-8');
+    const workspaceDir = path.join(projectRoot, '.specpow', 'sdd', path.basename(planFile, '.md'));
+    const config = {
+        maxFixRounds: parseInt(options.maxFixRounds || '5'),
+        workspaceDir,
+        planFile,
+        implementerModel: options.model || 'sonnet',
+        reviewerModel: options.model || 'sonnet',
+        finalReviewModel: options.model || 'opus',
+        specConstraints: planContent,
+    };
+    console.log(`✓ 配置: maxFixRounds=${config.maxFixRounds}, model=${config.implementerModel}`);
+    console.log(`✓ 计划文件: ${planFile}`);
+    console.log(`✓ 工作区: ${workspaceDir}`);
+    // 解析计划中的任务
+    const parsedTasks = parseTasksFromContent(planContent);
+    const tasks = toPlanTasks(parsedTasks);
+    if (tasks.length === 0) {
+        console.warn(`⚠ 未从计划文件中解析到任务`);
+        return;
+    }
+    console.log(`✓ 解析到 ${tasks.length} 个任务\n`);
+    // 并行模式
+    if (options.parallel) {
+        console.log('⚡ 并行执行模式\n');
+        const layers = buildParallelLayers(tasks);
+        console.log(`  📊 依赖分析: ${tasks.length} 个任务 → ${layers.length} 层`);
+        for (let i = 0; i < layers.length; i++) {
+            console.log(`    第 ${i + 1} 层: ${layers[i].map(t => `T${t.number}`).join(', ')}`);
+        }
+        console.log('');
+        const dispatcher = new ParallelDispatcher(config);
+        const result = await dispatcher.dispatchAll(tasks, projectRoot);
+        console.log('\n📊 并行执行结果');
+        console.log(`  完成: ${result.results.filter(r => r.outcome === 'complete').length}/${tasks.length}`);
+        console.log(`  阻塞: ${result.results.filter(r => r.outcome === 'blocked').length}`);
+        if (result.conflicts.length > 0) {
+            console.log(`  ⚠ 冲突文件: ${result.conflicts.join(', ')}`);
+        }
+        if (result.mergeFailures.length > 0) {
+            console.log(`  ✗ 合并失败: ${result.mergeFailures.join(', ')}`);
+        }
+        console.log(`  状态: ${result.success ? '成功' : '部分失败'}\n`);
+        return;
+    }
+    // 串行模式
+    const controller = new SDDController(config);
+    await controller.initialize();
+    const result = await controller.executePlan(tasks, projectRoot);
+    console.log('\n📊 执行结果');
+    console.log(`  完成: ${result.completedTasks}/${result.totalTasks}`);
+    console.log(`  阻塞: ${result.blockedTasks}`);
+    console.log(`  停放发现: ${result.parkedFindings}`);
+    console.log(`  状态: ${result.success ? '成功' : '部分失败'}\n`);
+}
+//# sourceMappingURL=execute.js.map

package/dist/commands/execute.js.map

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

package/dist/commands/explore.d.ts

@@ -0,0 +1,71 @@
+/**
+ * explore 命令 — 苏格拉底式需求探索与上下文发现
+ *
+ * P1-8: 重写为交互式对话模式
+ *
+ * 核心原则：
+ * 1. 好奇而非指令性 — 问自然涌现的问题
+ * 2. 开放线索而非审讯 — 展示多个方向
+ * 3. 视觉化 — 大量使用 ASCII 图表
+ * 4. 自适应 — 跟随有趣的线索，必要时转向
+ * 5. 不实现 — 只读代码，不写代码
+ * 6. 不急于结论 — 耐心等待洞察结晶
+ *
+ * 当洞察结晶时，提供无缝过渡到 propose 流程
+ */
+export interface ExploreContext {
+    projectRoot: string;
+    existingSpecs: string[];
+    fileStructure: string[];
+    dependencies: Map<string, string[]>;
+    domainKeywords: string[];
+}
+export interface ExploreResult {
+    context: ExploreContext;
+    questions: ClarifyingQuestion[];
+    candidateApproaches: CandidateApproach[];
+    explorationDoc: string;
+    readyForPropose: boolean;
+}
+export interface ClarifyingQuestion {
+    id: string;
+    category: 'scope' | 'constraint' | 'impact' | 'priority' | 'timeline';
+    question: string;
+    rationale: string;
+    followUp?: string;
+}
+export interface CandidateApproach {
+    id: string;
+    name: string;
+    description: string;
+    pros: string[];
+    cons: string[];
+    estimatedEffort: 'S' | 'M' | 'L' | 'XL';
+    riskLevel: 'low' | 'medium' | 'high';
+    affectedModules: string[];
+}
+/**
+ * 探索项目上下文
+ * 扫描项目结构、已有规范、依赖关系
+ */
+export declare function discoverProjectContext(projectRoot: string): Promise<ExploreContext>;
+/**
+ * 生成澄清问题列表
+ * 基于项目上下文，按苏格拉底式提问法生成问题
+ */
+export declare function generateClarifyingQuestions(context: ExploreContext, userInput: string): ClarifyingQuestion[];
+/**
+ * 生成候选方案
+ * 基于上下文和用户输入，提出 2-3 个候选方案
+ */
+export declare function generateCandidateApproaches(context: ExploreContext, answers: Map<string, string>): CandidateApproach[];
+/**
+ * 生成探索文档
+ * 将探索结果整理为结构化文档
+ */
+export declare function generateExplorationDoc(context: ExploreContext, questions: ClarifyingQuestion[], approaches: CandidateApproach[], selectedApproach: string): string;
+/**
+ * P1-8: 交互式苏格拉底式探索
+ */
+export declare function exploreTopic(topic: string): Promise<void>;
+//# sourceMappingURL=explore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explore.d.ts","sourceRoot":"","sources":["../../src/commands/explore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACpC,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,mBAAmB,EAAE,iBAAiB,EAAE,CAAC;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,eAAe,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;IACxC,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAyBzF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,GAChB,kBAAkB,EAAE,CAkDtB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,iBAAiB,EAAE,CA0ErB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,kBAAkB,EAAE,EAC/B,UAAU,EAAE,iBAAiB,EAAE,EAC/B,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAmDR;AAmOD;;GAEG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8F/D"}