@specpow/framework 0.2.0

package/dist/core/parsers/index.js

@@ -0,0 +1,367 @@
+/**
+ * 解析器模块 — 工件内容解析
+ *
+ * 职责：
+ *   1. 解析 tasks.md 提取任务列表（支持 YAML frontmatter + Markdown checkbox）
+ *   2. 解析 spec.md 提取 Delta 需求
+ *   3. 解析 proposal.md 提取元数据
+ *   4. 解析 design.md 提取架构决策
+ */
+import { parse as parseYaml } from 'yaml';
+/**
+ * 从 tasks.md 内容解析任务列表（统一入口）
+ *
+ * 解析策略：
+ * 1. 优先检测 YAML frontmatter（--- 分隔的结构化数据块）
+ * 2. 回退到 Markdown checkbox 逐行解析
+ *
+ * YAML frontmatter 格式示例：
+ * ```yaml
+ * ---
+ * tasks:
+ *   - number: 1
+ *     title: 创建用户模型
+ *     files:
+ *       - src/models/user.ts
+ *     description: 实现用户数据模型
+ *     verification: 单元测试通过
+ *     dependsOn: []
+ *     estimatedEffort: S
+ * ---
+ * ```
+ */
+export function parseTasksFromContent(content) {
+    const frontmatter = extractFrontmatter(content);
+    if (frontmatter) {
+        const tasks = parseFrontmatterTasks(frontmatter);
+        if (tasks.length > 0)
+            return tasks;
+    }
+    return parseMarkdownTasks(content);
+}
+/**
+ * 将 ParsedTask[] 转换为 SDD 控制器所需的 PlanTask 格式
+ */
+export function toPlanTasks(tasks) {
+    return tasks
+        .filter(t => !t.completed)
+        .map((t, i) => ({
+        number: extractTaskNumber(t.id, i + 1),
+        title: t.title,
+        description: t.description,
+        files: t.files,
+    }));
+}
+/**
+ * 从任务 ID 中提取数字编号
+ * 例如: "Task-001" → 1, "Task-5" → 5, 无法解析时返回 fallback
+ */
+function extractTaskNumber(id, fallback) {
+    const match = id.match(/(\d+)/);
+    return match ? parseInt(match[1]) : fallback;
+}
+// ─── YAML Frontmatter 解析 ─────────────────────────────────
+/**
+ * 提取 YAML frontmatter（--- 分隔符之间的内容）
+ */
+function extractFrontmatter(content) {
+    const trimmed = content.trimStart();
+    if (!trimmed.startsWith('---'))
+        return null;
+    const endIndex = trimmed.indexOf('---', 3);
+    if (endIndex === -1)
+        return null;
+    return trimmed.substring(3, endIndex).trim();
+}
+/**
+ * 从 YAML frontmatter 解析任务列表
+ */
+function parseFrontmatterTasks(yamlContent) {
+    try {
+        const data = parseYaml(yamlContent);
+        if (!data || !Array.isArray(data.tasks))
+            return [];
+        return data.tasks.map((task, index) => ({
+            id: task.id || task.number ? `Task-${String(task.number ?? index + 1).padStart(3, '0')}` : `Task-${String(index + 1).padStart(3, '0')}`,
+            title: task.title || '',
+            description: task.description || '',
+            files: Array.isArray(task.files) ? task.files : [],
+            dependsOn: Array.isArray(task.dependsOn) ? task.dependsOn : [],
+            verification: task.verification || '',
+            estimatedEffort: (['S', 'M', 'L'].includes(task.estimatedEffort) ? task.estimatedEffort : 'M'),
+            completed: task.completed === true,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+// ─── Markdown Checkbox 解析 ────────────────────────────────
+/**
+ * 从 Markdown checkbox 格式解析任务列表
+ *
+ * 支持多种任务标题格式：
+ * - `- [ ] **Task 1**: 标题` (apply 命令格式)
+ * - `- [ ] Task-001: 标题` (核心解析器格式)
+ * - `- [ ] 标题` (简单格式)
+ */
+function parseMarkdownTasks(content) {
+    const tasks = [];
+    const lines = content.split('\n');
+    let currentTask = null;
+    let inCodeBlock = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // 跳过代码块
+        if (line.trim().startsWith('```')) {
+            inCodeBlock = !inCodeBlock;
+            continue;
+        }
+        if (inCodeBlock)
+            continue;
+        // 匹配任务行: - [ ] 或 - [x]
+        const taskMatch = line.match(/^-\s+\[([ x])\]\s+(.+)$/i);
+        if (taskMatch) {
+            // 保存上一个任务
+            if (currentTask && currentTask.id) {
+                tasks.push(finalizeTask(currentTask));
+            }
+            const completed = taskMatch[1].toLowerCase() === 'x';
+            const rawTitle = taskMatch[2].trim();
+            // 尝试多种 ID 提取模式
+            let id = `Task-${String(tasks.length + 1).padStart(3, '0')}`;
+            let title = rawTitle;
+            // 模式 1: **Task N**: title (apply 命令格式)
+            const boldMatch = rawTitle.match(/^\*\*Task\s+(\d+)\*\*\s*[:：]\s*(.*)/);
+            if (boldMatch) {
+                id = `Task-${String(parseInt(boldMatch[1])).padStart(3, '0')}`;
+                title = boldMatch[2].trim() || rawTitle;
+            }
+            else {
+                // 模式 2: Task-NNN: title (核心解析器格式)
+                const idMatch = rawTitle.match(/^(Task-\d+)[\s:：]*(.*)/);
+                if (idMatch) {
+                    id = idMatch[1];
+                    title = idMatch[2] || rawTitle;
+                }
+            }
+            currentTask = {
+                id,
+                title,
+                description: title,
+                files: [],
+                dependsOn: [],
+                verification: '',
+                estimatedEffort: 'M',
+                completed,
+            };
+            continue;
+        }
+        // 解析任务属性
+        if (currentTask) {
+            // 文件路径提取
+            const fileMatch = line.match(/(?:文件|files?|路径|path)\s*[:：]\s*`?([^\n,，]+(?:[,，]\s*`?[^\n]+)*)/i);
+            if (fileMatch) {
+                const files = fileMatch[1]
+                    .split(/[,，]/)
+                    .map(f => f.trim().replace(/`/g, ''))
+                    .filter(f => f.length > 0);
+                currentTask.files = [...(currentTask.files || []), ...files];
+                continue;
+            }
+            // 依赖关系
+            const depMatch = line.match(/(?:依赖|depends?)[\s:：]*(.+)/i);
+            if (depMatch) {
+                const deps = depMatch[1].split(/[,，]/).map(d => d.trim());
+                currentTask.dependsOn = deps;
+                continue;
+            }
+            // 验证步骤
+            const verifyMatch = line.match(/(?:验证|verify|verification)\s*[:：]\s*(.+)/i);
+            if (verifyMatch) {
+                currentTask.verification = verifyMatch[1].trim();
+                continue;
+            }
+            // 工作量评估
+            const effortMatch = line.match(/(?:工作量|effort|size)\s*[:：]\s*([SML])/i);
+            if (effortMatch) {
+                currentTask.estimatedEffort = effortMatch[1].toUpperCase();
+                continue;
+            }
+            // 累积描述（跳过空行和标题行）
+            if (line.trim() && !line.startsWith('#')) {
+                currentTask.description += (currentTask.description ? '\n' : '') + line.trim();
+            }
+        }
+    }
+    // 保存最后一个任务
+    if (currentTask && currentTask.id) {
+        tasks.push(finalizeTask(currentTask));
+    }
+    return tasks;
+}
+function finalizeTask(partial) {
+    return {
+        id: partial.id || 'unknown',
+        title: partial.title || '',
+        description: partial.description || '',
+        files: partial.files || [],
+        dependsOn: partial.dependsOn || [],
+        verification: partial.verification || '',
+        estimatedEffort: partial.estimatedEffort || 'M',
+        completed: partial.completed || false,
+    };
+}
+/**
+ * 解析 tasks.md 文件，提取结构化任务列表
+ * @deprecated 使用 parseTasksFromContent() 替代，支持 YAML frontmatter
+ */
+export function parseTasksFile(content) {
+    return parseMarkdownTasks(content);
+}
+/**
+ * 解析 spec.md 文件，提取 Delta 需求
+ */
+export function parseSpecFile(content) {
+    const requirements = [];
+    const lines = content.split('\n');
+    let currentType = null;
+    let currentReq = null;
+    let currentCriterion = null;
+    for (const line of lines) {
+        // 检测 Delta 类型标题
+        const typeMatch = line.match(/^###?\s+(ADDED|MODIFIED|REMOVED|RENAMED)\s+(.+)/i);
+        if (typeMatch) {
+            // 保存上一个需求
+            if (currentReq) {
+                if (currentCriterion) {
+                    currentReq.acceptanceCriteria = currentReq.acceptanceCriteria || [];
+                    currentReq.acceptanceCriteria.push(finalizeCriterion(currentCriterion));
+                }
+                requirements.push(finalizeRequirement(currentReq));
+            }
+            currentType = typeMatch[1].toUpperCase();
+            const title = typeMatch[2].trim();
+            const idMatch = title.match(/^([A-Z]+-\d+)[\s:：]*(.*)/);
+            currentReq = {
+                type: currentType,
+                id: idMatch ? idMatch[1] : `REQ-${String(requirements.length + 1).padStart(3, '0')}`,
+                title: idMatch ? idMatch[2] || title : title,
+                description: '',
+                acceptanceCriteria: [],
+            };
+            currentCriterion = null;
+            continue;
+        }
+        if (!currentReq)
+            continue;
+        // 解析验收标准
+        const givenMatch = line.match(/(?:\*\*)?Given(?:\*\*)?\s+(.+)/i);
+        if (givenMatch) {
+            if (currentCriterion) {
+                currentReq.acceptanceCriteria = currentReq.acceptanceCriteria || [];
+                currentReq.acceptanceCriteria.push(finalizeCriterion(currentCriterion));
+            }
+            currentCriterion = { given: givenMatch[1].trim() };
+            continue;
+        }
+        const whenMatch = line.match(/(?:\*\*)?When(?:\*\*)?\s+(.+)/i);
+        if (whenMatch) {
+            if (currentCriterion)
+                currentCriterion.when = whenMatch[1].trim();
+            continue;
+        }
+        const thenMatch = line.match(/(?:\*\*)?Then(?:\*\*)?\s+(.+)/i);
+        if (thenMatch) {
+            if (currentCriterion)
+                currentCriterion.then = thenMatch[1].trim();
+            continue;
+        }
+        // 累积描述
+        if (line.trim() && !line.startsWith('#')) {
+            currentReq.description += (currentReq.description ? '\n' : '') + line.trim();
+        }
+    }
+    // 保存最后一个
+    if (currentReq) {
+        if (currentCriterion) {
+            currentReq.acceptanceCriteria = currentReq.acceptanceCriteria || [];
+            currentReq.acceptanceCriteria.push(finalizeCriterion(currentCriterion));
+        }
+        requirements.push(finalizeRequirement(currentReq));
+    }
+    return requirements;
+}
+function finalizeCriterion(partial) {
+    return {
+        given: partial.given || '',
+        when: partial.when || '',
+        then: partial.then || '',
+    };
+}
+function finalizeRequirement(partial) {
+    return {
+        type: partial.type || 'ADDED',
+        id: partial.id || 'unknown',
+        title: partial.title || '',
+        description: partial.description || '',
+        acceptanceCriteria: partial.acceptanceCriteria || [],
+    };
+}
+/**
+ * 解析 proposal.md 文件
+ */
+export function parseProposal(content) {
+    const proposal = {
+        title: '',
+        motivation: '',
+        goals: [],
+        successCriteria: [],
+        scope: { in: [], out: [] },
+        risks: [],
+    };
+    const lines = content.split('\n');
+    let currentSection = '';
+    for (const line of lines) {
+        // 标题
+        if (line.startsWith('# ')) {
+            proposal.title = line.replace(/^#\s+/, '').trim();
+            continue;
+        }
+        // 检测段落
+        if (line.startsWith('## ')) {
+            currentSection = line.replace(/^##\s+/, '').trim().toLowerCase();
+            continue;
+        }
+        // 列表项
+        if (line.match(/^-\s+/)) {
+            const item = line.replace(/^-\s+/, '').trim();
+            switch (currentSection) {
+                case '目标':
+                case 'goals':
+                    proposal.goals.push(item);
+                    break;
+                case '成功标准':
+                case 'success criteria':
+                    proposal.successCriteria.push(item);
+                    break;
+                case '影响范围':
+                case 'scope':
+                    if (/^(包含|in[\s:：])/i.test(item)) {
+                        proposal.scope.in.push(item.replace(/^(包含|in)\s*[:：]?\s*/i, ''));
+                    }
+                    else if (/^(不包含|out[\s:：])/i.test(item)) {
+                        proposal.scope.out.push(item.replace(/^(不包含|out)\s*[:：]?\s*/i, ''));
+                    }
+                    break;
+            }
+            continue;
+        }
+        // 累积动机
+        if (currentSection === '动机' || currentSection === 'motivation') {
+            proposal.motivation += (proposal.motivation ? '\n' : '') + line.trim();
+        }
+    }
+    return proposal;
+}
+//# sourceMappingURL=index.js.map

package/dist/core/parsers/index.js.map

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

package/dist/core/sdd-engine/ai-caller.d.ts

@@ -0,0 +1,118 @@
+/**
+ * AI 调用抽象层
+ *
+ * 统一的子代理分发接口，遵循 Superpowers 的核心原则：
+ * 1. 每个子代理使用全新上下文（不继承主会话历史）
+ * 2. 产物通过文件传递（不占用上下文窗口）
+ * 3. 支持多种 AI 后端：Claude Code、Cursor、自定义 CLI
+ *
+ * 子代理通信协议：
+ *   Controller → writes brief file → AI reads brief → AI writes report → Controller reads report
+ *
+ * 模型选择策略（5级层次）：
+ *   cheap → standard → capable
+ *   修复轮次 4-5 自动升级到更强模型
+ */
+import type { TaskBrief, TaskReport, ReviewResult, Finding } from './types.js';
+/**
+ * AI 后端适配器接口
+ * 不同 AI 工具实现此接口来适配具体的调用方式
+ */
+export interface AIBackend {
+    /** 后端名称 */
+    readonly name: string;
+    /** 调用 AI 执行任务，将输出写入 outputPath */
+    execute(promptFile: string, model?: string, outputPath?: string, cwd?: string): Promise<string>;
+    /** 检查后端是否可用 */
+    isAvailable(): boolean;
+}
+/**
+ * 子代理分发选项
+ */
+export interface DispatchOptions {
+    /** 任务简报 */
+    brief: TaskBrief;
+    /** 任务限定 */
+    taskConstraint: string;
+    /** 使用的模型（可选，不指定则自动选择） */
+    model?: string;
+    /** 超时时间（毫秒） */
+    timeout?: number;
+}
+export declare class AICaller {
+    private backends;
+    private workspaceDir;
+    constructor(workspaceDir: string, preferredBackend?: string, options?: {
+        timeout?: number;
+    });
+    /**
+     * 获取可用后端
+     */
+    private getAvailableBackend;
+    /**
+     * 写入分发 prompt 到文件
+     */
+    private writePromptFile;
+    /**
+     * 构建实现者 prompt
+     *
+     * 遵循 Superpowers 的子代理分发设计：
+     * - 只告诉代理去哪里读简报（不粘贴任务描述）
+     * - 传递全局约束和接口约定
+     * - 要求将报告写入指定文件
+     */
+    buildImplementerPrompt(brief: TaskBrief, projectContext: string, specConstraints: string): string;
+    /**
+     * 构建审查者 prompt
+     *
+     * 两阶段审查门（来自 Superpowers）：
+     * 1. 规格合规：实现是否覆盖所有需求
+     * 2. 代码质量：实现质量评估
+     */
+    buildReviewerPrompt(brief: TaskBrief, reviewPackagePath: string): string;
+    /**
+     * 构建重新审查 prompt
+     *
+     * 范围限定的重新审查——只审查修复 diff
+     */
+    buildReReviewerPrompt(brief: TaskBrief, reviewPackagePath: string, openFindings: Finding[]): string;
+    /**
+     * 分发实现者子代理
+     *
+     * 1. 写入实现者 prompt 到文件
+     * 2. 调用 AI 后端执行
+     * 3. 读取报告文件
+     * 4. 解析返回 TaskReport
+     */
+    dispatchImplementer(brief: TaskBrief, projectContext: string, specConstraints: string, model?: string): Promise<TaskReport>;
+    /**
+     * 分发审查者子代理
+     */
+    dispatchReviewer(brief: TaskBrief, _projectContext: string, _specConstraints: string, baseCommit?: string, headCommit?: string): Promise<ReviewResult>;
+    /**
+     * 分发重新审查者子代理（范围限定）
+     */
+    dispatchReReviewer(brief: TaskBrief, openFindings: Finding[], baseCommit?: string, headCommit?: string): Promise<ReviewResult>;
+    /**
+     * 格式化简报文件内容
+     */
+    private formatBriefFile;
+    /**
+     * 解析任务报告
+     */
+    private parseTaskReport;
+    /**
+     * 解析审查结果
+     */
+    private parseReviewResult;
+    /**
+     * 状态映射
+     */
+    private mapStatus;
+    /**
+     * 从文本中提取 commit SHA
+     * 使用 word boundary 避免误匹配非 SHA 的十六进制字符串
+     */
+    private extractCommits;
+}
+//# sourceMappingURL=ai-caller.d.ts.map

package/dist/core/sdd-engine/ai-caller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-caller.d.ts","sourceRoot":"","sources":["../../../src/core/sdd-engine/ai-caller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAM/E;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW;IACX,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChG,eAAe;IACf,WAAW,IAAI,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAsKD,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,YAAY,CAAS;gBAEjB,YAAY,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAkB3F;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;;;;;;OAOG;IACH,sBAAsB,CAAC,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM;IAsDjG;;;;;;OAMG;IACH,mBAAmB,CACjB,KAAK,EAAE,SAAS,EAChB,iBAAiB,EAAE,MAAM,GACxB,MAAM;IAsDT;;;;OAIG;IACH,qBAAqB,CACnB,KAAK,EAAE,SAAS,EAChB,iBAAiB,EAAE,MAAM,EACzB,YAAY,EAAE,OAAO,EAAE,GACtB,MAAM;IAkBT;;;;;;;OAOG;IACG,mBAAmB,CACvB,KAAK,EAAE,SAAS,EAChB,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,CAAC;IAqCtB;;OAEG;IACG,gBAAgB,CACpB,KAAK,EAAE,SAAS,EAChB,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,MAAM,EACxB,UAAU,GAAE,MAAiB,EAC7B,UAAU,GAAE,MAAe,GAC1B,OAAO,CAAC,YAAY,CAAC;IA+BxB;;OAEG;IACG,kBAAkB,CACtB,KAAK,EAAE,SAAS,EAChB,YAAY,EAAE,OAAO,EAAE,EACvB,UAAU,GAAE,MAAiB,EAC7B,UAAU,GAAE,MAAe,GAC1B,OAAO,CAAC,YAAY,CAAC;IA0BxB;;OAEG;IACH,OAAO,CAAC,eAAe;IA4BvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAmEvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2DzB;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;;OAGG;IACH,OAAO,CAAC,cAAc;CAMvB"}