@hongmaple0820/scale-engine 0.21.2 → 0.23.0

package/dist/workflow/TaskLevelDetector.d.ts

@@ -0,0 +1,41 @@
+export type TaskLevel = 'S' | 'M' | 'L' | 'CRITICAL';
+export interface TaskLevelSignals {
+    fileCount: number;
+    lineDelta: number;
+    crossModule: boolean;
+    criticalFileHits: string[];
+    descriptionKeywords: string[];
+    topDirs: string[];
+}
+export interface TaskLevelResult {
+    level: TaskLevel;
+    confidence: number;
+    reasons: string[];
+    signals: TaskLevelSignals;
+}
+export declare class TaskLevelDetector {
+    /**
+     * 从 git diff 采集信号并判定等级
+     */
+    detectFromGitDiff(cwd?: string): Promise<TaskLevelResult>;
+    /**
+     * 从任务描述 + 文件列表判定等级
+     */
+    detectFromDescription(description: string, files?: string[]): TaskLevelResult;
+    /**
+     * 综合判定任务等级
+     */
+    classify(signals: TaskLevelSignals): TaskLevelResult;
+    /**
+     * 从 git diff 采集信号
+     */
+    private collectGitSignals;
+    /**
+     * 从描述 + 文件列表采集信号
+     */
+    private collectDescriptionSignals;
+    /**
+     * 构建信号对象
+     */
+    private buildSignals;
+}

package/dist/workflow/TaskLevelDetector.js

@@ -0,0 +1,219 @@
+// SCALE Engine — Task Level Detector
+// 自动推断任务等级 (S/M/L/CRITICAL)，基于代码变更规模 + 项目结构复杂度
+import { execSync } from 'node:child_process';
+const CRITICAL_KEYWORDS = ['migration', 'migrate', 'auth', 'payment', 'pay', 'security', 'secret', 'credential', 'drop', 'alter', 'truncate', 'production', 'prod'];
+const L_KEYWORDS = ['refactor', 'redesign', 'restructure', 'rewrite', 'architecture', 'schema', 'database', 'infrastructure'];
+const S_KEYWORDS = ['typo', 'comment', 'readme', 'doc', 'format', 'whitespace', 'rename', 'lint'];
+const CRITICAL_FILES = [
+    /migration/i, /schema/i, /\.env/, /docker-compose/i, /Dockerfile/i,
+    /auth/i, /payment/i, /security/i, /credential/i,
+    /package\.json$/, /pom\.xml$/, /build\.gradle$/,
+];
+export class TaskLevelDetector {
+    /**
+     * 从 git diff 采集信号并判定等级
+     */
+    async detectFromGitDiff(cwd) {
+        const signals = await this.collectGitSignals(cwd);
+        return this.classify(signals);
+    }
+    /**
+     * 从任务描述 + 文件列表判定等级
+     */
+    detectFromDescription(description, files = []) {
+        const signals = this.collectDescriptionSignals(description, files);
+        return this.classify(signals);
+    }
+    /**
+     * 综合判定任务等级
+     */
+    classify(signals) {
+        const reasons = [];
+        let score = 0;
+        // CRITICAL: 关键词命中
+        if (signals.descriptionKeywords.some(kw => CRITICAL_KEYWORDS.includes(kw))) {
+            score += 100;
+            reasons.push('CRITICAL keyword detected in description');
+        }
+        // CRITICAL: 关键文件命中
+        if (signals.criticalFileHits.length > 0) {
+            score += 80;
+            reasons.push(`Critical files touched: ${signals.criticalFileHits.join(', ')}`);
+        }
+        // 文件数量评分
+        if (signals.fileCount > 20) {
+            score += 40;
+            reasons.push(`High file count: ${signals.fileCount}`);
+        }
+        else if (signals.fileCount > 10) {
+            score += 20;
+            reasons.push(`Medium file count: ${signals.fileCount}`);
+        }
+        else if (signals.fileCount <= 5) {
+            score -= 10;
+            reasons.push(`Low file count: ${signals.fileCount}`);
+        }
+        // 行数评分
+        if (signals.lineDelta > 500) {
+            score += 40;
+            reasons.push(`Large change: ${signals.lineDelta} lines`);
+        }
+        else if (signals.lineDelta > 100) {
+            score += 20;
+            reasons.push(`Medium change: ${signals.lineDelta} lines`);
+        }
+        else if (signals.lineDelta <= 50) {
+            score -= 10;
+            reasons.push(`Small change: ${signals.lineDelta} lines`);
+        }
+        // 跨模块评分
+        if (signals.crossModule) {
+            score += 30;
+            reasons.push(`Cross-module change: ${signals.topDirs.join(', ')}`);
+        }
+        // L 关键词
+        if (signals.descriptionKeywords.some(kw => L_KEYWORDS.includes(kw))) {
+            score += 25;
+            reasons.push('L-level keyword detected');
+        }
+        // S 关键词（降级）
+        if (signals.descriptionKeywords.some(kw => S_KEYWORDS.includes(kw))) {
+            score -= 20;
+            reasons.push('S-level keyword detected');
+        }
+        // 判定等级
+        let level;
+        let confidence;
+        if (score >= 80) {
+            level = 'CRITICAL';
+            confidence = Math.min(1, 0.7 + (score - 80) / 100);
+        }
+        else if (score >= 40) {
+            level = 'L';
+            confidence = Math.min(1, 0.6 + (score - 40) / 100);
+        }
+        else if (score >= 0) {
+            level = 'M';
+            confidence = Math.min(1, 0.5 + score / 80);
+        }
+        else {
+            level = 'S';
+            confidence = Math.min(1, 0.6 + Math.abs(score) / 40);
+        }
+        return { level, confidence: Math.round(confidence * 100) / 100, reasons, signals };
+    }
+    /**
+     * 从 git diff 采集信号
+     */
+    async collectGitSignals(cwd) {
+        const workingDir = cwd ?? process.cwd();
+        let fileCount = 0;
+        let lineDelta = 0;
+        const changedFiles = [];
+        try {
+            // 获取 staged + unstaged 变更
+            const diffStat = execSync('git diff --stat HEAD --no-color 2>/dev/null || git diff --stat --no-color 2>/dev/null', {
+                cwd: workingDir,
+                encoding: 'utf-8',
+                timeout: 5000,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            }).trim();
+            if (diffStat) {
+                const lines = diffStat.split('\n').filter(l => l.trim() && !l.includes('files changed'));
+                fileCount = lines.length;
+                for (const line of lines) {
+                    // 解析: " src/foo.ts | 10 +++---"
+                    const fileMatch = line.match(/^\s*(.+?)\s*\|/);
+                    if (fileMatch)
+                        changedFiles.push(fileMatch[1].trim());
+                    // 解析行数变化
+                    const insertMatch = line.match(/(\d+)\s+insertion/);
+                    const deleteMatch = line.match(/(\d+)\s+deletion/);
+                    if (insertMatch)
+                        lineDelta += parseInt(insertMatch[1], 10);
+                    if (deleteMatch)
+                        lineDelta += parseInt(deleteMatch[1], 10);
+                }
+            }
+        }
+        catch (error) {
+            void error;
+            // git diff 失败（可能不在 git 仓库中）
+        }
+        // 如果没有 git diff 信息，尝试获取最近 commit 的变更
+        if (fileCount === 0) {
+            try {
+                const lastCommit = execSync('git diff --stat HEAD~1..HEAD --no-color 2>/dev/null', {
+                    cwd: workingDir,
+                    encoding: 'utf-8',
+                    timeout: 5000,
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                }).trim();
+                if (lastCommit) {
+                    const lines = lastCommit.split('\n').filter(l => l.trim() && !l.includes('files changed'));
+                    fileCount = lines.length;
+                    for (const line of lines) {
+                        const fileMatch = line.match(/^\s*(.+?)\s*\|/);
+                        if (fileMatch)
+                            changedFiles.push(fileMatch[1].trim());
+                        const insertMatch = line.match(/(\d+)\s+insertion/);
+                        const deleteMatch = line.match(/(\d+)\s+deletion/);
+                        if (insertMatch)
+                            lineDelta += parseInt(insertMatch[1], 10);
+                        if (deleteMatch)
+                            lineDelta += parseInt(deleteMatch[1], 10);
+                    }
+                }
+            }
+            catch (error) {
+                void error;
+                // 忽略
+            }
+        }
+        return this.buildSignals(fileCount, lineDelta, changedFiles, '');
+    }
+    /**
+     * 从描述 + 文件列表采集信号
+     */
+    collectDescriptionSignals(description, files) {
+        const lineDelta = 0;
+        return this.buildSignals(files.length, lineDelta, files, description);
+    }
+    /**
+     * 构建信号对象
+     */
+    buildSignals(fileCount, lineDelta, changedFiles, description) {
+        // 跨模块检测：变更文件是否跨越 ≥2 个顶层目录
+        const topDirs = new Set();
+        for (const file of changedFiles) {
+            const parts = file.replace(/\\/g, '/').split('/');
+            if (parts.length > 1) {
+                topDirs.add(parts[0]);
+            }
+        }
+        const crossModule = topDirs.size >= 2;
+        // 关键文件命中
+        const criticalFileHits = [];
+        for (const file of changedFiles) {
+            for (const pattern of CRITICAL_FILES) {
+                if (pattern.test(file)) {
+                    criticalFileHits.push(file);
+                    break;
+                }
+            }
+        }
+        // 描述关键词提取
+        const descriptionKeywords = description.toLowerCase()
+            .split(/[\s,;.!?]+/)
+            .filter(w => w.length > 2);
+        return {
+            fileCount,
+            lineDelta,
+            crossModule,
+            criticalFileHits,
+            descriptionKeywords,
+            topDirs: Array.from(topDirs),
+        };
+    }
+}
+//# sourceMappingURL=TaskLevelDetector.js.map

package/dist/workflow/TaskLevelDetector.js.map

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

package/dist/workflow/WorkflowOrchestrator.d.ts

@@ -0,0 +1,59 @@
+import { type TaskLevel } from './TaskLevelDetector.js';
+export type PhaseName = 'define' | 'plan' | 'build' | 'verify' | 'review' | 'ship';
+export interface RunOptions {
+    title: string;
+    description?: string;
+    successCriteria?: string[];
+    level?: TaskLevel;
+    skipPhases?: PhaseName[];
+    stopOnFailure?: boolean;
+    autoCommit?: boolean;
+    scaleDir?: string;
+    projectDir?: string;
+}
+export interface PhaseResult {
+    phase: PhaseName;
+    success: boolean;
+    duration: number;
+    artifactId?: string;
+    error?: string;
+    details?: Record<string, unknown>;
+}
+export interface TokenUsage {
+    totalEstimated: number;
+    byPhase: Record<string, number>;
+}
+export interface RunResult {
+    success: boolean;
+    phases: PhaseResult[];
+    artifacts: {
+        needId?: string;
+        specId?: string;
+        planId?: string;
+        taskId?: string;
+    };
+    tokenUsage: TokenUsage;
+    duration: number;
+}
+export declare class WorkflowOrchestrator {
+    private eventBus;
+    private store;
+    private fsm;
+    private workflowEngine;
+    private scaleDir;
+    private projectDir;
+    constructor(opts?: {
+        scaleDir?: string;
+        projectDir?: string;
+    });
+    run(options: RunOptions): Promise<RunResult>;
+    private executeDefine;
+    private executePlan;
+    private executeBuild;
+    private executeVerify;
+    private executeReview;
+    private executeShip;
+    private buildResult;
+    /** Close database connections */
+    close(): void;
+}

package/dist/workflow/WorkflowOrchestrator.js

@@ -0,0 +1,326 @@
+// SCALE Engine — Workflow Orchestrator
+// Chains define → plan → build → verify → review → ship automatically
+import { EventBus } from '../core/eventBus.js';
+import { SQLiteArtifactStore } from '../artifact/sqliteStore.js';
+import { FSM } from '../artifact/fsm.js';
+import { registerAllFSMs } from '../artifact/fsmDefinitions.js';
+import { CapabilityRegistry } from '../capabilities/CapabilityRegistry.js';
+import { SkillRegistry } from '../skills/SkillRegistry.js';
+import { registerCoreSkills } from '../skills/coreSkills.js';
+import { registerExternalSkills } from '../skills/ExternalSkills.js';
+import { WorkflowEngine } from './WorkflowEngine.js';
+import { TaskLevelDetector } from './TaskLevelDetector.js';
+import { existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { estimateTokens } from '../context/ContextBudget.js';
+export class WorkflowOrchestrator {
+    constructor(opts = {}) {
+        this.scaleDir = opts.scaleDir ?? '.scale';
+        this.projectDir = opts.projectDir ?? process.cwd();
+        if (!existsSync(this.scaleDir))
+            mkdirSync(this.scaleDir, { recursive: true });
+        this.eventBus = new EventBus({ eventsDir: join(this.scaleDir, 'events') });
+        this.store = new SQLiteArtifactStore(this.eventBus, {
+            dbPath: join(this.scaleDir, 'scale.db'),
+            artifactsDir: join(this.scaleDir, 'artifacts'),
+        });
+        this.fsm = new FSM(this.store, this.eventBus);
+        registerAllFSMs(this.fsm);
+        const capabilityRegistry = new CapabilityRegistry(this.eventBus);
+        const skillRegistry = new SkillRegistry(this.eventBus);
+        registerCoreSkills(skillRegistry);
+        registerExternalSkills(skillRegistry, this.eventBus);
+        this.workflowEngine = new WorkflowEngine({
+            eventBus: this.eventBus,
+            capabilityRegistry,
+            skillRegistry,
+            scaleDir: this.scaleDir,
+        });
+    }
+    async run(options) {
+        const startTime = Date.now();
+        const phases = [];
+        const artifacts = {};
+        const tokenByPhase = {};
+        const skipSet = new Set(options.skipPhases ?? []);
+        const stopOnFailure = options.stopOnFailure !== false;
+        const execute = async (name, fn) => {
+            if (skipSet.has(name)) {
+                phases.push({ phase: name, success: true, duration: 0 });
+                return true;
+            }
+            const phaseStart = Date.now();
+            try {
+                const result = await fn();
+                const detailStr = JSON.stringify(result.details ?? {});
+                tokenByPhase[name] = (tokenByPhase[name] ?? 0) + estimateTokens(detailStr);
+                phases.push({ phase: name, success: true, duration: Date.now() - phaseStart, ...result });
+                return true;
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                phases.push({ phase: name, success: false, duration: Date.now() - phaseStart, error: message });
+                if (stopOnFailure)
+                    return false;
+                return true;
+            }
+        };
+        // Phase 1: DEFINE
+        const defineOk = await execute('define', async () => {
+            const result = await this.executeDefine(options);
+            artifacts.needId = result.needId;
+            artifacts.specId = result.specId;
+            return { artifactId: result.specId, details: result };
+        });
+        if (!defineOk)
+            return this.buildResult(false, phases, artifacts, tokenByPhase, startTime);
+        // Phase 2: PLAN
+        const planOk = await execute('plan', async () => {
+            const result = await this.executePlan(artifacts.specId, options);
+            artifacts.planId = result.planId;
+            return { artifactId: result.planId, details: result };
+        });
+        if (!planOk)
+            return this.buildResult(false, phases, artifacts, tokenByPhase, startTime);
+        // Phase 3: BUILD
+        const buildOk = await execute('build', async () => {
+            const result = await this.executeBuild(artifacts.planId, options);
+            artifacts.taskId = result.taskId;
+            return { artifactId: result.taskId, details: result };
+        });
+        if (!buildOk)
+            return this.buildResult(false, phases, artifacts, tokenByPhase, startTime);
+        // Phase 4: VERIFY
+        const verifyOk = await execute('verify', async () => {
+            const result = await this.executeVerify(artifacts.taskId);
+            return { details: result };
+        });
+        if (!verifyOk)
+            return this.buildResult(false, phases, artifacts, tokenByPhase, startTime);
+        // Phase 5: REVIEW
+        const reviewOk = await execute('review', async () => {
+            const result = await this.executeReview(artifacts.taskId);
+            return { details: result };
+        });
+        if (!reviewOk)
+            return this.buildResult(false, phases, artifacts, tokenByPhase, startTime);
+        // Phase 6: SHIP
+        await execute('ship', async () => {
+            const result = await this.executeShip(artifacts.taskId, options);
+            return { details: result };
+        });
+        return this.buildResult(phases.every(p => p.success), phases, artifacts, tokenByPhase, startTime);
+    }
+    async executeDefine(options) {
+        const desc = options.description ?? options.title;
+        const successCriteria = options.successCriteria ?? ['Feature works as described', 'No regression'];
+        // Run ambiguity analysis (warning only, don't block orchestrator)
+        const ambiguityResult = this.workflowEngine.getAmbiguityScorer().analyzeRequirement(desc);
+        // Create Need
+        const need = await this.store.create({
+            type: 'Need',
+            title: options.title,
+            payload: { rawText: desc },
+            initialStatus: 'DRAFT',
+            createdBy: { kind: 'human', userId: 'orchestrator' },
+        });
+        // Create Spec
+        const specPayload = {
+            what: desc,
+            successCriteria,
+            outOfScope: [],
+            edgeCases: [],
+            northStar: 'Deliver user value',
+            ambiguityScore: ambiguityResult.totalScore,
+        };
+        const spec = await this.store.create({
+            type: 'Spec',
+            title: options.title,
+            payload: specPayload,
+            parents: [need.id],
+            initialStatus: 'DRAFT',
+            createdBy: { kind: 'human', userId: 'orchestrator' },
+        });
+        // FSM transitions (approve may fail on high ambiguity - that's OK for orchestrator)
+        await this.fsm.transition(spec.id, 'refine', { actor: { kind: 'system', component: 'orchestrator' } });
+        const approveResult = await this.fsm.transition(spec.id, 'approve', { actor: { kind: 'system', component: 'orchestrator' } });
+        if (!approveResult.success) {
+            // Spec stays in REVIEWING — not fatal for orchestrator flow
+        }
+        return { needId: need.id, specId: spec.id, ambiguityScore: ambiguityResult.totalScore };
+    }
+    async executePlan(specId, options) {
+        const spec = await this.store.get(specId);
+        if (!spec || spec.type !== 'Spec')
+            throw new Error(`Spec not found: ${specId}`);
+        const specDesc = spec.payload.what;
+        const consensusResult = await this.workflowEngine.plan(specDesc, {
+            persistArtifact: false,
+            runGate: false,
+        });
+        const rollbackStrategy = consensusResult.preMortem.mitigations.join('\n') || 'Revert git commits';
+        const planPayload = {
+            approach: consensusResult.viableOptions.find(o => o.selected)?.description ?? 'Standard implementation',
+            techChoices: [],
+            modules: [],
+            rollbackStrategy,
+            estimatedComplexity: 5,
+        };
+        const plan = await this.store.create({
+            type: 'Plan',
+            title: `Plan for ${spec.title}`,
+            payload: planPayload,
+            parents: [specId],
+            initialStatus: 'DRAFT',
+            createdBy: { kind: 'human', userId: 'orchestrator' },
+        });
+        await this.fsm.transition(plan.id, 'review', { actor: { kind: 'system', component: 'orchestrator' } });
+        return { planId: plan.id };
+    }
+    async executeBuild(planId, options) {
+        const plan = await this.store.get(planId);
+        if (!plan || plan.type !== 'Plan')
+            throw new Error(`Plan not found: ${planId}`);
+        // Auto-detect level if not specified
+        let level;
+        if (options.level) {
+            level = options.level;
+        }
+        else {
+            const detector = new TaskLevelDetector();
+            const detection = await detector.detectFromGitDiff(this.projectDir);
+            level = detection.level;
+        }
+        const taskPayload = {
+            description: options.description ?? `Implement ${plan.title}`,
+            workflowLevel: level,
+            servicesTouched: [],
+            filesInvolved: [],
+            dependsOn: [],
+            requiredRole: 'implementer',
+            requiredCapabilities: ['code-generation', 'file-editing'],
+            buildStatus: 'pending',
+            lintStatus: 'pending',
+            agentBrief: {
+                category: 'enhancement',
+                summary: options.description ?? `Implement ${plan.title}`,
+                currentBehavior: 'Feature not yet implemented',
+                desiredBehavior: `Implement: ${plan.title}`,
+                keyInterfaces: [],
+                acceptanceCriteria: [],
+                outOfScope: [],
+            },
+        };
+        const task = await this.store.create({
+            type: 'Task',
+            title: `Task for ${plan.title}`,
+            payload: taskPayload,
+            parents: [planId],
+            initialStatus: 'PENDING',
+            createdBy: { kind: 'human', userId: 'orchestrator' },
+        });
+        // FSM transitions
+        await this.fsm.transition(task.id, 'schedule', { actor: { kind: 'system', component: 'orchestrator' } });
+        await this.fsm.transition(task.id, 'start', { actor: { kind: 'human', userId: 'orchestrator' } });
+        // Update Plan status
+        const canImplement = await this.fsm.canTransition(planId, 'implement');
+        if (canImplement.allowed) {
+            await this.fsm.transition(planId, 'implement', { actor: { kind: 'system', component: 'orchestrator' } });
+        }
+        return { taskId: task.id, level };
+    }
+    async executeVerify(taskId) {
+        const task = await this.store.get(taskId);
+        if (!task || task.type !== 'Task')
+            throw new Error(`Task not found: ${taskId}`);
+        // Run verification gates
+        const gateResults = await this.workflowEngine.verify({
+            cwd: this.projectDir,
+        });
+        const passed = gateResults.every(r => r.passed);
+        // Update task payload
+        const payload = task.payload;
+        const buildPassed = gateResults.filter(r => r.gate === 'G0').every(r => r.passed);
+        const lintPassed = gateResults.filter(r => r.gate === 'G4').every(r => r.passed);
+        const testPassed = gateResults.filter(r => r.gate === 'G5').every(r => r.passed);
+        const updatedPayload = {
+            ...payload,
+            buildStatus: buildPassed ? 'success' : 'failed',
+            lintStatus: lintPassed ? 'success' : 'failed',
+            testPassed,
+            verifiedAt: Date.now(),
+        };
+        await this.store.update(taskId, { payload: updatedPayload });
+        return { passed, gateCount: gateResults.length };
+    }
+    async executeReview(taskId) {
+        const task = await this.store.get(taskId);
+        if (!task || task.type !== 'Task')
+            throw new Error(`Task not found: ${taskId}`);
+        // Run Karpathy check
+        const karpathyResult = this.workflowEngine.checkKarpathy({
+            hypothesesListed: true,
+            hasExtraFeatures: false,
+            changesTraceable: true,
+            hasVerifiableGoal: true,
+        });
+        const passed = karpathyResult.every(check => check.passed);
+        // Update task payload
+        const payload = task.payload;
+        const updatedPayload = {
+            ...payload,
+            reviewPassed: passed,
+            reviewedAt: Date.now(),
+        };
+        await this.store.update(taskId, { payload: updatedPayload });
+        return { passed, criticalCount: passed ? 0 : 1 };
+    }
+    async executeShip(taskId, options) {
+        const task = await this.store.get(taskId);
+        if (!task || task.type !== 'Task')
+            throw new Error(`Task not found: ${taskId}`);
+        const payload = task.payload;
+        // Verify prerequisites
+        if (payload.buildStatus !== 'success')
+            throw new Error('Build not passed');
+        if (!payload.testPassed)
+            throw new Error('Tests not passed');
+        if (!payload.reviewPassed)
+            throw new Error('Review not passed');
+        // Complete FSM transition
+        if (task.status !== 'COMPLETED') {
+            const canComplete = await this.fsm.canTransition(taskId, 'complete');
+            if (canComplete.allowed) {
+                await this.fsm.transition(taskId, 'complete', { actor: { kind: 'human', userId: 'orchestrator' } });
+            }
+        }
+        // Complete parent plan
+        if (task.parents.length > 0) {
+            try {
+                await this.fsm.transition(task.parents[0], 'complete', {
+                    actor: { kind: 'system', component: 'orchestrator' },
+                });
+            }
+            catch (error) {
+                const parentPlanWarning = error instanceof Error ? error.message : String(error);
+                void parentPlanWarning;
+            }
+        }
+        return { committed: options.autoCommit !== false };
+    }
+    buildResult(success, phases, artifacts, tokenByPhase, startTime) {
+        const totalEstimated = Object.values(tokenByPhase).reduce((s, v) => s + v, 0);
+        return {
+            success,
+            phases,
+            artifacts,
+            tokenUsage: { totalEstimated, byPhase: { ...tokenByPhase } },
+            duration: Date.now() - startTime,
+        };
+    }
+    /** Close database connections */
+    close() {
+        this.store.close?.();
+    }
+}
+//# sourceMappingURL=WorkflowOrchestrator.js.map