@specpow/framework 0.2.2 → 0.4.0

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

@@ -1,62 +0,0 @@
-/**
- * 任务分发器
- *
- * 负责将任务分发给子代理实现者
- * 核心原则：
- * - 每个任务分发一个全新的子代理（上下文隔离）
- * - 分发 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;
-    /**
-     * 提取全局约束
-     *
-     * 从项目根目录的约束文件中读取全局编码规范，
-     * 这些约束会注入到每个子代理的 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

@@ -1 +0,0 @@
-{"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;;;;;;;;;;OAUG;IACH,OAAO,CAAC,wBAAwB;CAsEjC"}

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

@@ -1,133 +0,0 @@
-/**
- * 任务分发器
- *
- * 负责将任务分发给子代理实现者
- * 核心原则：
- * - 每个任务分发一个全新的子代理（上下文隔离）
- * - 分发 prompt 只包含当前任务所需的信息
- * - 不传递历史任务的累积摘要
- *
- * @deprecated 此模块为遗留代码，当前未被任何 CLI 命令使用。
- * 功能已由 SDDController 通过 AICaller 实现。
- * 建议在未来版本中移除此文件，或将其集成到 CLI 命令中。
- */
-import { existsSync, readFileSync } from 'fs';
-import { join } from 'path';
-export class TaskDispatcher {
-    config;
-    constructor(config) {
-        this.config = config;
-    }
-    /**
-     * 构建实现者分发 prompt
-     *
-     * 关键设计：
-     * - 简报路径是需求的唯一来源
-     * - 不粘贴历史任务摘要
-     * - 只传递接口信息和全局约束
-     */
-    buildImplementerPrompt(brief, projectContext, priorInterfaces, specConstraints) {
-        return {
-            taskContext: `Project: ${projectContext}. Task ${brief.taskNumber}: ${brief.title}`,
-            briefPath: brief.briefPath,
-            reportPath: brief.reportPath,
-            interfaces: priorInterfaces,
-            resolutions: '',
-            specConstraints,
-            globalConstraints: this.extractGlobalConstraints(),
-        };
-    }
-    /**
-     * 构建修复轮次的分发 prompt
-     *
-     * Rounds 1-3: 恢复原始实现者（上下文完整）
-     * Rounds 4-5: 分发全新实现者，使用更强模型
-     */
-    buildFixPrompt(brief, reportPath, openFindings, round, useFreshAgent) {
-        const framing = useFreshAgent
-            ? `A prior implementer attempted this task ${round - 1} time(s); you own it now. Read the report file for what was tried.`
-            : `Fix round ${round}/5. Address the following open findings.`;
-        return {
-            taskContext: `${framing} Task ${brief.taskNumber}: ${brief.title}`,
-            briefPath: brief.briefPath,
-            reportPath,
-            interfaces: '',
-            resolutions: '',
-            specConstraints: this.config.specConstraints,
-            globalConstraints: `Open findings to address:\n${openFindings.map((f, i) => `${i + 1}. ${f}`).join('\n')}`,
-        };
-    }
-    /**
-     * 判断是否应该使用全新实现者
-     * Rounds 1-3: 恢复原始实现者
-     * Rounds 4-5: 全新实现者 + 更强模型
-     */
-    shouldUseFreshAgent(round) {
-        return round >= 4;
-    }
-    /**
-     * 提取全局约束
-     *
-     * 从项目根目录的约束文件中读取全局编码规范，
-     * 这些约束会注入到每个子代理的 prompt 中。
-     *
-     * 约束来源优先级：
-     * 1. .specpow/config.json 中的 globalConstraints 字段
-     * 2. CLAUDE.md / AGENTS.md / GEMINI.md 中的编码规范
-     * 3. 默认约束
-     */
-    extractGlobalConstraints() {
-        const projectRoot = process.cwd();
-        const constraints = [];
-        // 1. 尝试读取 .specpow/config.json
-        const configPath = join(projectRoot, '.specpow', 'config.json');
-        if (existsSync(configPath)) {
-            try {
-                const config = JSON.parse(readFileSync(configPath, 'utf-8'));
-                if (config.globalConstraints) {
-                    constraints.push(config.globalConstraints);
-                }
-            }
-            catch {
-                // 配置解析失败，跳过
-            }
-        }
-        // 2. 尝试读取编码规范文件
-        const specFiles = ['CLAUDE.md', 'AGENTS.md', 'GEMINI.md'];
-        for (const file of specFiles) {
-            const path = join(projectRoot, file);
-            if (existsSync(path)) {
-                try {
-                    const content = readFileSync(path, 'utf-8');
-                    // 提取编码规范相关的内容（常见模式）
-                    const patterns = [
-                        /(?:coding (?:standard|convention|style|guideline))[:\s]*([^\n]+)/gi,
-                        /(?:代码(?:规范|风格|标准))[:\s]*([^\n]+)/gi,
-                        /(?:naming (?:convention|pattern))[:\s]*([^\n]+)/gi,
-                        /(?:禁止|禁止使用|不允许)[^\n]+/gi,
-                    ];
-                    for (const pattern of patterns) {
-                        const matches = content.matchAll(pattern);
-                        for (const match of matches) {
-                            constraints.push(match[0].trim());
-                        }
-                    }
-                    // 限制从每个文件提取的约束数量
-                    if (constraints.length > 20)
-                        break;
-                }
-                catch {
-                    // 读取失败，跳过
-                }
-            }
-        }
-        // 3. 默认约束
-        if (constraints.length === 0) {
-            constraints.push('Follow existing code style and patterns in the project', 'Keep changes minimal and focused on the task', 'Prefer composition over inheritance', 'Handle errors explicitly');
-        }
-        // 4. TDD 铁律 — 始终注入（来自 execution-tdd 技能）
-        constraints.push('', '## TDD 铁律：没有失败测试就不写产品代码', '遵循 RED-GREEN-REFACTOR 循环：', '1. RED: 先写一个描述期望行为的失败测试', '2. GREEN: 写最少的代码让测试通过（YAGNI）', '3. REFACTOR: 在测试保护下清理代码');
-        return constraints.join('\n');
-    }
-}
-//# sourceMappingURL=dispatcher.js.map

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

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