@specpow/framework 0.2.0

package/dist/core/sdd-engine/controller.d.ts

@@ -0,0 +1,107 @@
+/**
+ * SDD 控制器
+ *
+ * 核心协调器，编排整个子代理驱动开发流程：
+ *
+ * 1. 设置：工作区、账本、读取计划
+ * 2. 对每个任务：
+ *    a. 提取任务简报
+ *    b. 分发实现者子代理
+ *    c. 处理报告
+ *    d. 生成审查包 → 分发审查子代理
+ *    e. 修复循环（≤5轮）
+ *    f. 记录到账本
+ * 3. 全分支最终审查
+ * 4. 清理工作区
+ *
+ * 关键原则：
+ * - 控制器不自己修复代码（保持上下文干净）
+ * - 所有产物通过文件传递（不占用上下文窗口）
+ * - 信任账本而非自己的记忆
+ */
+import type { SDDConfig } from './types.js';
+export interface PlanTask {
+    number: number;
+    title: string;
+    description: string;
+    files: string[];
+}
+export interface SDDResult {
+    success: boolean;
+    completedTasks: number;
+    totalTasks: number;
+    blockedTasks: number;
+    parkedFindings: number;
+}
+export declare class SDDController {
+    private config;
+    private ledger;
+    private reviewLoop;
+    private modelSelector;
+    private aiCaller;
+    private inGitRepo;
+    constructor(config: SDDConfig);
+    /**
+     * 初始化 - 设置工作区和账本
+     * 注意：当前实现为纯同步操作，保留 async 签名以便未来扩展（如远程账本加载）
+     */
+    initialize(): void;
+    /**
+     * 执行计划
+     *
+     * 主循环：逐个任务执行，每个任务经过 实现→审查→修复 循环
+     */
+    executePlan(tasks: PlanTask[], projectContext: string): Promise<SDDResult>;
+    /**
+     * 执行单个任务
+     */
+    private executeTask;
+    /**
+     * 创建任务简报
+     */
+    private createBrief;
+    /**
+     * 分发实现者子代理
+     *
+     * 遵循 Superpowers 原则：
+     * - 全新上下文，不继承主会话历史
+     * - 通过文件传递任务简报和实现报告
+     * - 模型选择基于任务复杂度
+     */
+    private dispatchImplementer;
+    /**
+     * 分发审查者子代理
+     *
+     * 两阶段审查门（来自 Superpowers）：
+     * 1. 规格合规裁决
+     * 2. 代码质量裁决
+     */
+    private dispatchReviewer;
+    /**
+     * 分发重新审查者子代理（范围限定）
+     *
+     * 仅审查修复 diff，不重新审查整个任务
+     */
+    private dispatchReReviewer;
+    /**
+     * 获取 HEAD commit SHA
+     */
+    private getHeadCommit;
+    /**
+     * 生成审查包文件
+     *
+     * 使用 git diff 生成 Markdown 格式的审查包，
+     * 审查者子代理读取文件而非接收上下文注入的 diff。
+     */
+    private generateReviewPackage;
+    /**
+     * 运行项目测试 — TDD 门控
+     *
+     * 智能检测并运行项目测试：
+     * 1. 优先使用 package.json 中的 test script（支持 npm/yarn/pnpm）
+     * 2. 自动检测常见测试框架（vitest, jest, mocha, ava, tape, pytest 等）
+     * 3. 如果项目没有测试框架或测试目录，返回 true（不阻塞流程）
+     */
+    private runTests;
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/core/sdd-engine/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../src/core/sdd-engine/controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAUH,OAAO,KAAK,EAAE,SAAS,EAAgD,MAAM,YAAY,CAAC;AAE1F,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,SAAS,CAAU;gBAEf,MAAM,EAAE,SAAS;IAqB7B;;;OAGG;IACH,UAAU,IAAI,IAAI;IAQlB;;;;OAIG;IACG,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAwChF;;OAEG;YACW,WAAW;IA4GzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAkBnB;;;;;;;OAOG;YACW,mBAAmB;IAajC;;;;;;OAMG;YACW,gBAAgB;IAW9B;;;;OAIG;YACW,kBAAkB;IAWhC;;OAEG;YACW,aAAa;IAQ3B;;;;;OAKG;YACW,qBAAqB;IAoBnC;;;;;;;OAOG;YACW,QAAQ;CA8EvB"}

package/dist/core/sdd-engine/controller.js

@@ -0,0 +1,357 @@
+/**
+ * SDD 控制器
+ *
+ * 核心协调器，编排整个子代理驱动开发流程：
+ *
+ * 1. 设置：工作区、账本、读取计划
+ * 2. 对每个任务：
+ *    a. 提取任务简报
+ *    b. 分发实现者子代理
+ *    c. 处理报告
+ *    d. 生成审查包 → 分发审查子代理
+ *    e. 修复循环（≤5轮）
+ *    f. 记录到账本
+ * 3. 全分支最终审查
+ * 4. 清理工作区
+ *
+ * 关键原则：
+ * - 控制器不自己修复代码（保持上下文干净）
+ * - 所有产物通过文件传递（不占用上下文窗口）
+ * - 信任账本而非自己的记忆
+ */
+import { Ledger } from './ledger.js';
+import { ReviewLoop } from './review-loop.js';
+import { ModelSelector } from './model-selector.js';
+import { AICaller } from './ai-caller.js';
+import { getHeadCommit, generateReviewPackage, isGitRepo } from './git-ops.js';
+import { execFileSync } from 'child_process';
+import { existsSync, writeFileSync, readFileSync } from 'fs';
+import { join } from 'path';
+export class SDDController {
+    config;
+    ledger;
+    reviewLoop;
+    modelSelector;
+    aiCaller;
+    inGitRepo;
+    constructor(config) {
+        this.config = config;
+        this.ledger = new Ledger(config.workspaceDir, config.planFile, config.maxFixRounds);
+        this.reviewLoop = new ReviewLoop(config.maxFixRounds);
+        // Build ModelConfig: per-role overrides take precedence over tier defaults
+        const tierDefaults = {
+            cheap: 'haiku',
+            standard: 'sonnet',
+            capable: 'opus',
+        };
+        this.modelSelector = new ModelSelector({
+            cheap: config.modelConfig?.cheap || tierDefaults.cheap,
+            standard: config.modelConfig?.standard || tierDefaults.standard,
+            capable: config.modelConfig?.capable || tierDefaults.capable,
+        });
+        this.aiCaller = new AICaller(config.workspaceDir);
+        this.inGitRepo = isGitRepo();
+    }
+    /**
+     * 初始化 - 设置工作区和账本
+     * 注意：当前实现为纯同步操作，保留 async 签名以便未来扩展（如远程账本加载）
+     */
+    initialize() {
+        // 尝试加载已有账本（支持断点续跑）
+        const canResume = this.ledger.load();
+        if (!canResume) {
+            this.ledger.initialize();
+        }
+    }
+    /**
+     * 执行计划
+     *
+     * 主循环：逐个任务执行，每个任务经过 实现→审查→修复 循环
+     */
+    async executePlan(tasks, projectContext) {
+        await this.initialize();
+        let completed = 0;
+        let blocked = 0;
+        let parkedTotal = 0;
+        for (const task of tasks) {
+            // 跳过已完成的任务（断点续跑）
+            if (this.ledger.isTaskComplete(task.number)) {
+                completed++;
+                continue;
+            }
+            const result = await this.executeTask(task, projectContext);
+            switch (result.outcome) {
+                case 'complete':
+                    completed++;
+                    break;
+                case 'blocked':
+                    blocked++;
+                    this.ledger.recordBlocked(task.number, result.reason || 'Unknown');
+                    break;
+                case 'adjudicated':
+                    completed++;
+                    parkedTotal += result.parkedCount || 0;
+                    break;
+            }
+        }
+        return {
+            success: blocked === 0,
+            completedTasks: completed,
+            totalTasks: tasks.length,
+            blockedTasks: blocked,
+            parkedFindings: parkedTotal,
+        };
+    }
+    /**
+     * 执行单个任务
+     */
+    async executeTask(task, projectContext) {
+        // 1. 构建任务简报
+        const brief = this.createBrief(task);
+        // 2. 记录 BASE commit
+        const baseCommit = await this.getHeadCommit();
+        // 3. 选择实现者模型（基于任务复杂度）
+        const model = this.modelSelector.selectImplementerModel(task.files.length, !!this.config.specConstraints, false);
+        // 4. 调用实现者子代理
+        const report = await this.dispatchImplementer(brief, projectContext, model);
+        // 5. 处理报告
+        if (report.status === 'blocked') {
+            return { outcome: 'blocked', reason: report.concerns };
+        }
+        // 6. 生成审查包并分发审查者
+        const headCommit = await this.getHeadCommit();
+        await this.generateReviewPackage(baseCommit, headCommit);
+        const review = await this.dispatchReviewer(brief, projectContext);
+        // 7. TDD 门控：检测测试是否通过
+        const testsPassed = await this.runTests();
+        // 8. 审查循环
+        let currentRound = 0;
+        let decision = this.reviewLoop.analyzeReview(review, currentRound, testsPassed);
+        while (decision.type === 'fix') {
+            currentRound++;
+            if (currentRound > this.config.maxFixRounds) {
+                // 断路器触发：将 decision 转为 adjudicate，避免 break 后落入 Unknown decision type
+                decision = { type: 'adjudicate', findings: decision.findings };
+                break;
+            }
+            // 修复轮次 4-5 升级模型
+            const fixModel = currentRound >= 4
+                ? this.modelSelector.getEscalatedModel(model)
+                : model;
+            // 分发实现者修复 — 使用独立的 reportPath 避免覆盖原始实现报告
+            const fixBrief = {
+                ...brief,
+                reportPath: `${brief.reportPath}.fix-${currentRound}`,
+            };
+            const fixBase = await this.getHeadCommit();
+            await this.dispatchImplementer(fixBrief, projectContext, fixModel);
+            const fixHead = await this.getHeadCommit();
+            // 记录修复轮次到账本
+            const fixRecord = this.reviewLoop.createFixRecord(currentRound, 0, // addressed 由审查结果确定
+            decision.findings.length, decision.findings.map(f => f.description), `${fixBase.slice(0, 7)}..${fixHead.slice(0, 7)}`);
+            this.ledger.recordFixRound(task.number, fixRecord);
+            // 范围限定的重新审查
+            await this.generateReviewPackage(fixBase, fixHead);
+            const reReview = await this.dispatchReReviewer(fixBrief, decision.findings);
+            // 修复轮次也检查测试
+            const fixTestsPassed = await this.runTests();
+            decision = this.reviewLoop.analyzeReview(reReview, currentRound, fixTestsPassed);
+        }
+        // 9. 处理最终结果
+        if (decision.type === 'pass') {
+            const commits = `${baseCommit.slice(0, 7)}..${(await this.getHeadCommit()).slice(0, 7)}`;
+            this.ledger.recordComplete(task.number, commits, true);
+            return { outcome: 'complete' };
+        }
+        if (decision.type === 'blocked') {
+            return { outcome: 'blocked', reason: decision.reason };
+        }
+        if (decision.type === 'adjudicate') {
+            let parkedCount = 0;
+            for (const finding of decision.findings) {
+                const ruling = this.reviewLoop.adjudicateFinding(finding, '');
+                if (ruling.action === 'park') {
+                    this.ledger.recordParkedFinding(task.number, finding, ruling.ruling);
+                    parkedCount++;
+                }
+                else {
+                    return { outcome: 'blocked', reason: ruling.ruling };
+                }
+            }
+            const commits = `${baseCommit.slice(0, 7)}..${(await this.getHeadCommit()).slice(0, 7)}`;
+            this.ledger.recordComplete(task.number, commits, false);
+            return { outcome: 'adjudicated', parkedCount };
+        }
+        return { outcome: 'blocked', reason: 'Unknown decision type' };
+    }
+    /**
+     * 创建任务简报
+     */
+    createBrief(task) {
+        const briefPath = `${this.config.workspaceDir}/task-${task.number}-brief.md`;
+        const reportPath = `${this.config.workspaceDir}/task-${task.number}-report.md`;
+        return {
+            taskNumber: task.number,
+            title: task.title,
+            description: task.description,
+            files: task.files,
+            briefPath,
+            reportPath,
+        };
+    }
+    // ============================================================
+    // AI 子代理分发 — 委托给 AICaller
+    // ============================================================
+    /**
+     * 分发实现者子代理
+     *
+     * 遵循 Superpowers 原则：
+     * - 全新上下文，不继承主会话历史
+     * - 通过文件传递任务简报和实现报告
+     * - 模型选择基于任务复杂度
+     */
+    async dispatchImplementer(brief, projectContext, model) {
+        return this.aiCaller.dispatchImplementer(brief, projectContext, this.config.specConstraints, model);
+    }
+    /**
+     * 分发审查者子代理
+     *
+     * 两阶段审查门（来自 Superpowers）：
+     * 1. 规格合规裁决
+     * 2. 代码质量裁决
+     */
+    async dispatchReviewer(brief, projectContext) {
+        return this.aiCaller.dispatchReviewer(brief, projectContext, this.config.specConstraints);
+    }
+    /**
+     * 分发重新审查者子代理（范围限定）
+     *
+     * 仅审查修复 diff，不重新审查整个任务
+     */
+    async dispatchReReviewer(brief, openFindings) {
+        return this.aiCaller.dispatchReReviewer(brief, openFindings);
+    }
+    // ============================================================
+    // Git 操作 — 委托给 git-ops 模块
+    // ============================================================
+    /**
+     * 获取 HEAD commit SHA
+     */
+    async getHeadCommit() {
+        if (!this.inGitRepo) {
+            // 非 Git 环境返回占位 SHA
+            return `nosha-${Date.now().toString(36)}`;
+        }
+        return getHeadCommit();
+    }
+    /**
+     * 生成审查包文件
+     *
+     * 使用 git diff 生成 Markdown 格式的审查包，
+     * 审查者子代理读取文件而非接收上下文注入的 diff。
+     */
+    async generateReviewPackage(base, head) {
+        if (!this.inGitRepo || base === head || base.startsWith('nosha-')) {
+            // 非 Git 环境：创建空审查包文件（确保文件存在供下游读取）
+            const emptyPath = `${this.config.workspaceDir}/review-empty-${Date.now().toString(36)}.md`;
+            writeFileSync(emptyPath, [
+                '# 审查包',
+                '',
+                '> 非 Git 环境 — 无 diff 可用',
+                '',
+                '## 审查清单',
+                '',
+                '- [ ] 手动验证实现是否满足任务简报要求',
+                '- [ ] 代码质量检查',
+                '- [ ] 测试覆盖检查',
+            ].join('\n'), 'utf-8');
+            return emptyPath;
+        }
+        return generateReviewPackage(base, head, '', this.config.workspaceDir);
+    }
+    /**
+     * 运行项目测试 — TDD 门控
+     *
+     * 智能检测并运行项目测试：
+     * 1. 优先使用 package.json 中的 test script（支持 npm/yarn/pnpm）
+     * 2. 自动检测常见测试框架（vitest, jest, mocha, ava, tape, pytest 等）
+     * 3. 如果项目没有测试框架或测试目录，返回 true（不阻塞流程）
+     */
+    async runTests() {
+        // 策略 1: 检测 package.json 中的 test script
+        const packageJsonPath = join(process.cwd(), 'package.json');
+        if (existsSync(packageJsonPath)) {
+            try {
+                const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+                if (packageJson.scripts?.test) {
+                    // 检测包管理器
+                    const hasYarnLock = existsSync(join(process.cwd(), 'yarn.lock'));
+                    const hasPnpmLock = existsSync(join(process.cwd(), 'pnpm-lock.yaml'));
+                    let cmd;
+                    let args;
+                    if (hasYarnLock) {
+                        cmd = 'yarn';
+                        args = ['test', '--silent'];
+                    }
+                    else if (hasPnpmLock) {
+                        cmd = 'pnpm';
+                        args = ['test', '--silent'];
+                    }
+                    else {
+                        cmd = 'npm';
+                        args = ['test', '--silent'];
+                    }
+                    try {
+                        execFileSync(cmd, args, {
+                            encoding: 'utf-8',
+                            stdio: ['pipe', 'pipe', 'pipe'],
+                            timeout: 120_000,
+                            cwd: process.cwd(),
+                        });
+                        return true;
+                    }
+                    catch {
+                        // test script 存在但测试失败
+                        return false;
+                    }
+                }
+            }
+            catch {
+                // package.json 解析失败，继续其他策略
+            }
+        }
+        // 策略 2: 自动检测常见测试框架
+        const testFrameworks = [
+            { cmd: 'npx', args: ['vitest', 'run', '--reporter=json'] },
+            { cmd: 'npx', args: ['jest', '--json', '--passWithNoTests'] },
+            { cmd: 'npx', args: ['mocha', '--reporter', 'json'] },
+            { cmd: 'npx', args: ['ava', '--tap'] },
+            { cmd: 'npx', args: ['tape', '**/*.test.js'] },
+            { cmd: 'python3', args: ['-m', 'pytest', '-q'] },
+            { cmd: 'python', args: ['-m', 'pytest', '-q'] },
+        ];
+        for (const framework of testFrameworks) {
+            try {
+                execFileSync(framework.cmd, framework.args, {
+                    encoding: 'utf-8',
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                    timeout: 120_000,
+                    cwd: process.cwd(),
+                });
+                return true;
+            }
+            catch {
+                // 该框架不存在或测试失败，继续尝试下一个
+            }
+        }
+        // 策略 3: 检查是否有测试目录
+        const testDirs = ['test', 'tests', '__tests__', 'src/test', 'src/__tests__'];
+        const hasTestDir = testDirs.some(d => existsSync(d));
+        if (!hasTestDir) {
+            return true; // 无测试目录 — TDD 门控不适用
+        }
+        // 有测试目录但测试失败
+        return false;
+    }
+}
+//# sourceMappingURL=controller.js.map

package/dist/core/sdd-engine/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../../src/core/sdd-engine/controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAkB5B,MAAM,OAAO,aAAa;IAChB,MAAM,CAAY;IAClB,MAAM,CAAS;IACf,UAAU,CAAa;IACvB,aAAa,CAAgB;IAC7B,QAAQ,CAAW;IACnB,SAAS,CAAU;IAE3B,YAAY,MAAiB;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QACpF,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAEtD,2EAA2E;QAC3E,MAAM,YAAY,GAA2B;YAC3C,KAAK,EAAE,OAAO;YACd,QAAQ,EAAE,QAAQ;YAClB,OAAO,EAAE,MAAM;SAChB,CAAC;QACF,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC;YACrC,KAAK,EAAE,MAAM,CAAC,WAAW,EAAE,KAAK,IAAI,YAAY,CAAC,KAAK;YACtD,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,QAAQ,IAAI,YAAY,CAAC,QAAQ;YAC/D,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,IAAI,YAAY,CAAC,OAAO;SAC7D,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAClD,IAAI,CAAC,SAAS,GAAG,SAAS,EAAE,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,mBAAmB;QACnB,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW,CAAC,KAAiB,EAAE,cAAsB;QACzD,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAExB,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,iBAAiB;YACjB,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5C,SAAS,EAAE,CAAC;gBACZ,SAAS;YACX,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YAE5D,QAAQ,MAAM,CAAC,OAAO,EAAE,CAAC;gBACvB,KAAK,UAAU;oBACb,SAAS,EAAE,CAAC;oBACZ,MAAM;gBACR,KAAK,SAAS;oBACZ,OAAO,EAAE,CAAC;oBACV,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC;oBACnE,MAAM;gBACR,KAAK,aAAa;oBAChB,SAAS,EAAE,CAAC;oBACZ,WAAW,IAAI,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC;oBACvC,MAAM;YACV,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,OAAO,KAAK,CAAC;YACtB,cAAc,EAAE,SAAS;YACzB,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,YAAY,EAAE,OAAO;YACrB,cAAc,EAAE,WAAW;SAC5B,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,WAAW,CACvB,IAAc,EACd,cAAsB;QAEtB,YAAY;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAErC,oBAAoB;QACpB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAE9C,sBAAsB;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,sBAAsB,CACrD,IAAI,CAAC,KAAK,CAAC,MAAM,EACjB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,EAC7B,KAAK,CACN,CAAC;QAEF,cAAc;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC;QAE5E,UAAU;QACV,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QACzD,CAAC;QAED,iBAAiB;QACjB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC9C,MAAM,IAAI,CAAC,qBAAqB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;QAElE,qBAAqB;QACrB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QAE1C,UAAU;QACV,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;QAEhF,OAAO,QAAQ,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YAC/B,YAAY,EAAE,CAAC;YACf,IAAI,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;gBAC5C,oEAAoE;gBACpE,QAAQ,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBAC/D,MAAM;YACR,CAAC;YAED,gBAAgB;YAChB,MAAM,QAAQ,GAAG,YAAY,IAAI,CAAC;gBAChC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,iBAAiB,CAAC,KAAK,CAAC;gBAC7C,CAAC,CAAC,KAAK,CAAC;YAEV,wCAAwC;YACxC,MAAM,QAAQ,GAAc;gBAC1B,GAAG,KAAK;gBACR,UAAU,EAAE,GAAG,KAAK,CAAC,UAAU,QAAQ,YAAY,EAAE;aACtD,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAC3C,MAAM,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;YACnE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAE3C,YAAY;YACZ,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,eAAe,CAC/C,YAAY,EACZ,CAAC,EAAE,oBAAoB;YACvB,QAAQ,CAAC,QAAQ,CAAC,MAAM,EACxB,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,EACzC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CACjD,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAEnD,YAAY;YACZ,MAAM,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACnD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAE5E,YAAY;YACZ,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7C,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;QACnF,CAAC;QAED,YAAY;QACZ,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACzF,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;YACvD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;QACjC,CAAC;QAED,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;QACzD,CAAC;QAED,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACnC,IAAI,WAAW,GAAG,CAAC,CAAC;YACpB,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACxC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAC9D,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;oBAC7B,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;oBACrE,WAAW,EAAE,CAAC;gBAChB,CAAC;qBAAM,CAAC;oBACN,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;gBACvD,CAAC;YACH,CAAC;YACD,MAAM,OAAO,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACzF,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YACxD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;QACjD,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;IACjE,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,IAAc;QAChC,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,SAAS,IAAI,CAAC,MAAM,WAAW,CAAC;QAC7E,MAAM,UAAU,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,SAAS,IAAI,CAAC,MAAM,YAAY,CAAC;QAE/E,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,MAAM;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS;YACT,UAAU;SACX,CAAC;IACJ,CAAC;IAED,+DAA+D;IAC/D,0BAA0B;IAC1B,+DAA+D;IAE/D;;;;;;;OAOG;IACK,KAAK,CAAC,mBAAmB,CAC/B,KAAgB,EAChB,cAAsB,EACtB,KAAa;QAEb,OAAO,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CACtC,KAAK,EACL,cAAc,EACd,IAAI,CAAC,MAAM,CAAC,eAAe,EAC3B,KAAK,CACN,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,gBAAgB,CAC5B,KAAgB,EAChB,cAAsB;QAEtB,OAAO,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CACnC,KAAK,EACL,cAAc,EACd,IAAI,CAAC,MAAM,CAAC,eAAe,CAC5B,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,kBAAkB,CAC9B,KAAgB,EAChB,YAAuB;QAEvB,OAAO,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAC/D,CAAC;IAED,+DAA+D;IAC/D,0BAA0B;IAC1B,+DAA+D;IAE/D;;OAEG;IACK,KAAK,CAAC,aAAa;QACzB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,mBAAmB;YACnB,OAAO,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5C,CAAC;QACD,OAAO,aAAa,EAAE,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,qBAAqB,CAAC,IAAY,EAAE,IAAY;QAC5D,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClE,iCAAiC;YACjC,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,iBAAiB,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC;YAC3F,aAAa,CAAC,SAAS,EAAE;gBACvB,OAAO;gBACP,EAAE;gBACF,wBAAwB;gBACxB,EAAE;gBACF,SAAS;gBACT,EAAE;gBACF,wBAAwB;gBACxB,cAAc;gBACd,cAAc;aACf,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;OAOG;IACK,KAAK,CAAC,QAAQ;QACpB,uCAAuC;QACvC,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;QAC5D,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;gBACvE,IAAI,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;oBAC9B,SAAS;oBACT,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC;oBACjE,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;oBAEtE,IAAI,GAAW,CAAC;oBAChB,IAAI,IAAc,CAAC;oBAEnB,IAAI,WAAW,EAAE,CAAC;wBAChB,GAAG,GAAG,MAAM,CAAC;wBACb,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;oBAC9B,CAAC;yBAAM,IAAI,WAAW,EAAE,CAAC;wBACvB,GAAG,GAAG,MAAM,CAAC;wBACb,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;oBAC9B,CAAC;yBAAM,CAAC;wBACN,GAAG,GAAG,KAAK,CAAC;wBACZ,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;oBAC9B,CAAC;oBAED,IAAI,CAAC;wBACH,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE;4BACtB,QAAQ,EAAE,OAAO;4BACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;4BAC/B,OAAO,EAAE,OAAO;4BAChB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;yBACnB,CAAC,CAAC;wBACH,OAAO,IAAI,CAAC;oBACd,CAAC;oBAAC,MAAM,CAAC;wBACP,sBAAsB;wBACtB,OAAO,KAAK,CAAC;oBACf,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,2BAA2B;YAC7B,CAAC;QACH,CAAC;QAED,mBAAmB;QACnB,MAAM,cAAc,GAAG;YACrB,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,iBAAiB,CAAC,EAAE;YAC1D,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,mBAAmB,CAAC,EAAE;YAC7D,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE;YACrD,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE;YACtC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE;YAC9C,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE;YAChD,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE;SAChD,CAAC;QAEF,KAAK,MAAM,SAAS,IAAI,cAAc,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,YAAY,CAAC,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,EAAE;oBAC1C,QAAQ,EAAE,OAAO;oBACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;oBAC/B,OAAO,EAAE,OAAO;oBAChB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;iBACnB,CAAC,CAAC;gBACH,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,sBAAsB;YACxB,CAAC;QACH,CAAC;QAED,kBAAkB;QAClB,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;QAC7E,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,CAAC,oBAAoB;QACnC,CAAC;QAED,aAAa;QACb,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/core/sdd-engine/dispatcher.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 任务分发器
+ *
+ * 负责将任务分发给子代理实现者
+ * 核心原则：
+ * - 每个任务分发一个全新的子代理（上下文隔离）
+ * - 分发 prompt 只包含当前任务所需的信息
+ * - 不传递历史任务的累积摘要
+ *
+ * @deprecated 此模块为遗留代码，当前未被任何 CLI 命令使用。
+ * 功能已由 SDDController 通过 AICaller 实现。
+ * 建议在未来版本中移除此文件，或将其集成到 CLI 命令中。
+ */
+import type { TaskBrief, SDDConfig } from './types.js';
+export interface DispatchPrompt {
+    taskContext: string;
+    briefPath: string;
+    reportPath: string;
+    interfaces: string;
+    resolutions: string;
+    specConstraints: string;
+    globalConstraints: string;
+}
+export declare class TaskDispatcher {
+    private config;
+    constructor(config: SDDConfig);
+    /**
+     * 构建实现者分发 prompt
+     *
+     * 关键设计：
+     * - 简报路径是需求的唯一来源
+     * - 不粘贴历史任务摘要
+     * - 只传递接口信息和全局约束
+     */
+    buildImplementerPrompt(brief: TaskBrief, projectContext: string, priorInterfaces: string, specConstraints: string): DispatchPrompt;
+    /**
+     * 构建修复轮次的分发 prompt
+     *
+     * Rounds 1-3: 恢复原始实现者（上下文完整）
+     * Rounds 4-5: 分发全新实现者，使用更强模型
+     */
+    buildFixPrompt(brief: TaskBrief, reportPath: string, openFindings: string[], round: number, useFreshAgent: boolean): DispatchPrompt;
+    /**
+     * 判断是否应该使用全新实现者
+     * Rounds 1-3: 恢复原始实现者
+     * Rounds 4-5: 全新实现者 + 更强模型
+     */
+    shouldUseFreshAgent(round: number): boolean;
+    /**
+     * 获取修复轮次的模型级别
+     *
+     * @deprecated 此方法引用已废弃的配置字段，不再使用。
+     * 模型选择逻辑已移至 ModelSelector 类。
+     */
+    getFixRoundModel(round: number): string;
+    /**
+     * 提取全局约束
+     *
+     * 从项目根目录的约束文件中读取全局编码规范，
+     * 这些约束会注入到每个子代理的 prompt 中。
+     *
+     * 约束来源优先级：
+     * 1. .specpow/config.json 中的 globalConstraints 字段
+     * 2. CLAUDE.md / AGENTS.md / GEMINI.md 中的编码规范
+     * 3. 默认约束
+     */
+    private extractGlobalConstraints;
+}
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/core/sdd-engine/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../../src/core/sdd-engine/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAY;gBAEd,MAAM,EAAE,SAAS;IAI7B;;;;;;;OAOG;IACH,sBAAsB,CACpB,KAAK,EAAE,SAAS,EAChB,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,GACtB,cAAc;IAYjB;;;;;OAKG;IACH,cAAc,CACZ,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EAAE,EACtB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,OAAO,GACrB,cAAc;IAgBjB;;;;OAIG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI3C;;;;;OAKG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAQvC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,wBAAwB;CAsEjC"}