maestro-flow 0.1.0

package/dashboard/dist-server/server/coordinator/workflow-coordinator.test.js

@@ -0,0 +1,247 @@
+import { describe, it, expect, vi, afterEach } from 'vitest';
+vi.mock('node:fs/promises', async (importOriginal) => {
+    const orig = await importOriginal();
+    return {
+        ...orig,
+        readFile: vi.fn().mockRejectedValue(new Error('ENOENT')),
+        writeFile: vi.fn().mockResolvedValue(undefined),
+        mkdir: vi.fn().mockResolvedValue(undefined),
+        readdir: vi.fn().mockResolvedValue([]),
+    };
+});
+vi.mock('./agents/quality-reviewer-agent.js', () => {
+    const QualityReviewerAgent = vi.fn(function () {
+        this.review = vi.fn().mockResolvedValue({
+            qualityScore: 85,
+            executionAssessment: 'Good',
+            issues: [],
+            nextStepHints: '',
+            stepSummary: 'Step completed successfully',
+        });
+    });
+    return { QualityReviewerAgent };
+});
+// ---------------------------------------------------------------------------
+// Mock GraphWalkerFactory to avoid real graph walker initialization
+// ---------------------------------------------------------------------------
+const completedWalkerState = {
+    status: 'completed',
+    history: [
+        {
+            node_id: 'maestro-execute',
+            node_type: 'command',
+            entered_at: '2025-01-01T00:00:00Z',
+            exited_at: '2025-01-01T00:01:00Z',
+            outcome: 'success',
+            exec_id: 'proc-1',
+            summary: 'Executed successfully',
+            quality_score: 90,
+        },
+    ],
+};
+// Default: never-resolving promise so session stays 'running' during tests.
+// Tests that need completion call mockWalkerStart.mockResolvedValueOnce(completedWalkerState).
+const mockWalkerStart = vi.fn().mockReturnValue(new Promise(() => { }));
+const mockWalkerStop = vi.fn().mockResolvedValue(undefined);
+const mockWalkerResume = vi.fn().mockResolvedValue({
+    session_id: 'coord-resumed',
+    status: 'completed',
+    intent: 'resume intent',
+    graph_id: 'execute',
+    tool: 'claude',
+    auto_mode: false,
+    history: [],
+});
+const mockRouterResolve = vi.fn().mockReturnValue('execute');
+vi.mock('./graph-walker-factory.js', () => {
+    const GraphWalkerFactory = vi.fn(function () {
+        this.create = vi.fn().mockResolvedValue({
+            walker: {
+                start: mockWalkerStart,
+                stop: mockWalkerStop,
+                resume: mockWalkerResume,
+            },
+            router: {
+                resolve: mockRouterResolve,
+            },
+        });
+    });
+    return { GraphWalkerFactory };
+});
+vi.mock('./walker-event-bridge.js', () => {
+    const WalkerEventBridge = vi.fn();
+    return { WalkerEventBridge };
+});
+vi.mock('./dashboard-step-analyzer.js', () => {
+    const DashboardStepAnalyzer = vi.fn();
+    return { DashboardStepAnalyzer };
+});
+import { WorkflowCoordinator } from './workflow-coordinator.js';
+// ---------------------------------------------------------------------------
+// Mock factories
+// ---------------------------------------------------------------------------
+function createMockEventBus() {
+    return {
+        emit: vi.fn(),
+        on: vi.fn(),
+        off: vi.fn(),
+    };
+}
+function createMockAgentManager() {
+    return {
+        spawn: vi.fn().mockResolvedValue({
+            id: 'mock-proc-1',
+            type: 'claude-code',
+            status: 'running',
+            config: { type: 'claude-code', prompt: 'test', workDir: '/tmp' },
+            startedAt: new Date().toISOString(),
+        }),
+        stop: vi.fn().mockResolvedValue(undefined),
+        getEntries: vi.fn().mockReturnValue([]),
+    };
+}
+function createMockStateManager() {
+    return {
+        getProject: vi.fn().mockReturnValue({
+            project_name: 'test-project',
+            status: 'active',
+            current_milestone: 'v1',
+            current_phase: null,
+            accumulated_context: { blockers: [] },
+        }),
+        getPhase: vi.fn().mockReturnValue(undefined),
+        getBoard: vi.fn().mockReturnValue({}),
+    };
+}
+function createCoordinator() {
+    const eventBus = createMockEventBus();
+    const agentManager = createMockAgentManager();
+    const stateManager = createMockStateManager();
+    const coordinator = new WorkflowCoordinator(eventBus, agentManager, stateManager, '/tmp/test-workflow');
+    return { coordinator, eventBus, agentManager, stateManager };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('WorkflowCoordinator', () => {
+    afterEach(() => {
+        vi.clearAllMocks();
+    });
+    // --- getSession ---
+    describe('getSession', () => {
+        it('returns null when no session is active', () => {
+            const { coordinator } = createCoordinator();
+            expect(coordinator.getSession()).toBeNull();
+        });
+    });
+    // --- start ---
+    describe('start', () => {
+        it('creates a session via graph walker', async () => {
+            const { coordinator } = createCoordinator();
+            const session = await coordinator.start('implement the feature');
+            expect(session).toBeDefined();
+            expect(session.sessionId).toMatch(/^coord-/);
+            expect(session.intent).toBe('implement the feature');
+            expect(session.tool).toBe('claude');
+            expect(session.status).toBe('running');
+        });
+        it('uses router to resolve graph id from intent', async () => {
+            const { coordinator } = createCoordinator();
+            await coordinator.start('implement the feature');
+            expect(mockRouterResolve).toHaveBeenCalledWith('implement the feature');
+        });
+        it('uses explicit chainName when provided', async () => {
+            const { coordinator } = createCoordinator();
+            const session = await coordinator.start('do something', { chainName: 'execute-verify' });
+            expect(session.chainName).toBe('execute-verify');
+            // Router should not be called when chainName is explicit
+            expect(mockRouterResolve).not.toHaveBeenCalled();
+        });
+        it('uses specified tool', async () => {
+            const { coordinator } = createCoordinator();
+            const session = await coordinator.start('execute', { tool: 'gemini' });
+            expect(session.tool).toBe('gemini');
+        });
+        it('throws if session is already running', async () => {
+            const { coordinator } = createCoordinator();
+            await coordinator.start('first task');
+            await expect(coordinator.start('second task')).rejects.toThrow('A coordinate session is already running');
+        });
+        it('emits coordinate:status events', async () => {
+            const { coordinator, eventBus } = createCoordinator();
+            mockWalkerStart.mockResolvedValueOnce(completedWalkerState);
+            await coordinator.start('execute the plan');
+            await new Promise(r => setTimeout(r, 10));
+            expect(eventBus.emit).toHaveBeenCalledWith('coordinate:status', expect.any(Object));
+        });
+        it('starts graph walker with correct options', async () => {
+            const { coordinator } = createCoordinator();
+            mockWalkerStart.mockReturnValueOnce(new Promise(() => { }));
+            await coordinator.start('execute the plan', {
+                tool: 'gemini',
+                autoMode: true,
+                phase: 'phase-1',
+            });
+            // Allow async walker to start
+            await new Promise(r => setTimeout(r, 50));
+            expect(mockWalkerStart).toHaveBeenCalledWith('execute', 'execute the plan', expect.objectContaining({
+                tool: 'gemini',
+                autoMode: true,
+                inputs: { phase: 'phase-1', description: 'execute the plan' },
+            }));
+        });
+    });
+    // --- stop ---
+    describe('stop', () => {
+        it('does nothing when no session exists', async () => {
+            const { coordinator } = createCoordinator();
+            await coordinator.stop(); // should not throw
+        });
+        it('stops graph walker and sets session to failed', async () => {
+            const { coordinator } = createCoordinator();
+            mockWalkerStart.mockReturnValueOnce(new Promise(() => { }));
+            await coordinator.start('execute the plan');
+            await coordinator.stop();
+            const session = coordinator.getSession();
+            expect(session?.status).toBe('failed');
+            expect(mockWalkerStop).toHaveBeenCalled();
+        });
+    });
+    // --- resume ---
+    describe('resume', () => {
+        it('resumes via graph walker', async () => {
+            const { coordinator } = createCoordinator();
+            const session = await coordinator.resume('some-session-id');
+            expect(session).toBeDefined();
+            expect(mockWalkerResume).toHaveBeenCalledWith('some-session-id');
+        });
+        it('returns null when walker resume fails', async () => {
+            mockWalkerResume.mockRejectedValueOnce(new Error('no session'));
+            const { coordinator } = createCoordinator();
+            const result = await coordinator.resume('nonexistent');
+            expect(result).toBeNull();
+        });
+    });
+    // --- getSession returns copy ---
+    describe('getSession returns a copy', () => {
+        it('returns independent copy of session', async () => {
+            const { coordinator } = createCoordinator();
+            mockWalkerStart.mockResolvedValueOnce(completedWalkerState);
+            await coordinator.start('execute the plan');
+            await new Promise(r => setTimeout(r, 10));
+            const s1 = coordinator.getSession();
+            const s2 = coordinator.getSession();
+            expect(s1).toEqual(s2);
+            expect(s1).not.toBe(s2);
+            expect(s1?.steps).not.toBe(s2?.steps);
+        });
+    });
+    // --- destroy ---
+    describe('destroy', () => {
+        it('does not throw', () => {
+            const { coordinator } = createCoordinator();
+            coordinator.destroy(); // no-op, should not throw
+        });
+    });
+});
+//# sourceMappingURL=workflow-coordinator.test.js.map

package/dashboard/dist-server/server/coordinator/workflow-coordinator.test.js.map

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

package/dashboard/dist-server/server/execution/dispatch-strategy.d.ts

@@ -0,0 +1,33 @@
+import type { Issue } from '../../shared/issue-types.js';
+import type { ExecutionSlot, SchedulerConfig } from '../../shared/execution-types.js';
+import type { LearningSuggestion } from '../../shared/learning-types.js';
+export interface DispatchContext {
+    /** All issues from JSONL */
+    issues: Issue[];
+    /** Currently running slots */
+    runningSlots: ReadonlyMap<string, ExecutionSlot>;
+    /** Issues already claimed/queued */
+    claimed: ReadonlySet<string>;
+    /** Current scheduler config */
+    config: SchedulerConfig;
+    /** Available capacity (maxConcurrent - running) */
+    availableSlots: number;
+    /** Optional: learning suggestions from SelfLearningService */
+    learningSuggestions?: LearningSuggestion[];
+}
+export interface DispatchDecision {
+    issueId: string;
+    /** Optional: override executor for this issue */
+    executor?: string;
+    /** Optional: override prompt mode */
+    promptMode?: string;
+    /** Reason for selection (for logging) */
+    reason?: string;
+    /** Optional: 'dispatch' (default) auto-executes, 'suggest' is recommendation only */
+    mode?: 'dispatch' | 'suggest';
+}
+export interface DispatchStrategy {
+    readonly name: string;
+    /** Select issues to dispatch given current context. Return empty array to skip. */
+    selectIssues(context: DispatchContext): Promise<DispatchDecision[]>;
+}

package/dashboard/dist-server/server/execution/dispatch-strategy.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// DispatchStrategy — pluggable interface for issue selection in tick loop
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=dispatch-strategy.js.map

package/dashboard/dist-server/server/execution/dispatch-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-strategy.js","sourceRoot":"","sources":["../../../src/server/execution/dispatch-strategy.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,0EAA0E;AAC1E,8EAA8E"}

package/dashboard/dist-server/server/execution/execution-journal.d.ts

@@ -0,0 +1,16 @@
+import type { JournalEvent, RecoveryAction } from '../../shared/journal-types.js';
+export declare class ExecutionJournal {
+    private readonly journalPath;
+    private readonly maxSizeBytes;
+    constructor(workflowRoot: string, maxSizeBytes?: number);
+    /** Append a single event atomically (single-line JSON + appendFile) */
+    append(event: JournalEvent): Promise<void>;
+    /** Read all events from the journal */
+    readAll(): Promise<JournalEvent[]>;
+    /** Get events for a specific issue */
+    getEventsForIssue(issueId: string): Promise<JournalEvent[]>;
+    /** Analyze journal and determine recovery actions for interrupted executions */
+    recover(): Promise<RecoveryAction[]>;
+    /** Rotate journal when it exceeds maxSizeBytes */
+    rotate(): Promise<void>;
+}

package/dashboard/dist-server/server/execution/execution-journal.js

@@ -0,0 +1,100 @@
+// ---------------------------------------------------------------------------
+// ExecutionJournal — append-only JSONL event log for crash recovery
+// ---------------------------------------------------------------------------
+import { appendFile, readFile, rename, mkdir, stat } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+export class ExecutionJournal {
+    journalPath;
+    maxSizeBytes;
+    constructor(workflowRoot, maxSizeBytes = 10 * 1024 * 1024) {
+        this.journalPath = join(workflowRoot, 'execution', 'journal.jsonl');
+        this.maxSizeBytes = maxSizeBytes;
+    }
+    /** Append a single event atomically (single-line JSON + appendFile) */
+    async append(event) {
+        await mkdir(dirname(this.journalPath), { recursive: true });
+        const record = { ...event, timestamp: event.timestamp || new Date().toISOString() };
+        const line = JSON.stringify(record) + '\n';
+        await appendFile(this.journalPath, line, 'utf-8');
+    }
+    /** Read all events from the journal */
+    async readAll() {
+        let raw;
+        try {
+            raw = await readFile(this.journalPath, 'utf-8');
+        }
+        catch {
+            return [];
+        }
+        const events = [];
+        for (const line of raw.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                events.push(JSON.parse(trimmed));
+            }
+            catch {
+                // Skip malformed lines — journal must be resilient to partial writes
+            }
+        }
+        return events;
+    }
+    /** Get events for a specific issue */
+    async getEventsForIssue(issueId) {
+        const all = await this.readAll();
+        return all.filter((e) => e.issueId === issueId);
+    }
+    /** Analyze journal and determine recovery actions for interrupted executions */
+    async recover() {
+        const events = await this.readAll();
+        const actions = [];
+        // Group by issueId
+        const byIssue = new Map();
+        for (const event of events) {
+            const list = byIssue.get(event.issueId) || [];
+            list.push(event);
+            byIssue.set(event.issueId, list);
+        }
+        for (const [issueId, issueEvents] of byIssue) {
+            const sorted = issueEvents.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+            const last = sorted[sorted.length - 1];
+            if (last.type === 'issue:dispatched') {
+                // Dispatched but no completion/failure — server crashed during execution
+                actions.push({
+                    issueId,
+                    action: 'retry',
+                    reason: 'Dispatched but no completion event — server crashed',
+                });
+            }
+            else if (last.type === 'wave:started' || last.type === 'wave:task_completed') {
+                // Wave in progress — find completed tasks for resume
+                const completedTaskIds = sorted
+                    .filter((e) => e.type === 'wave:task_completed')
+                    .map((e) => e.taskId);
+                actions.push({
+                    issueId,
+                    action: 'resume-wave',
+                    reason: `Wave interrupted with ${completedTaskIds.length} completed tasks`,
+                    completedTaskIds,
+                });
+            }
+            // issue:completed or issue:failed — terminal states, no action needed
+        }
+        return actions;
+    }
+    /** Rotate journal when it exceeds maxSizeBytes */
+    async rotate() {
+        try {
+            const info = await stat(this.journalPath);
+            if (info.size > this.maxSizeBytes) {
+                const archivePath = this.journalPath.replace('.jsonl', `-${Date.now()}.jsonl`);
+                await rename(this.journalPath, archivePath);
+            }
+        }
+        catch {
+            // File doesn't exist yet — nothing to rotate
+        }
+    }
+}
+//# sourceMappingURL=execution-journal.js.map

package/dashboard/dist-server/server/execution/execution-journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-journal.js","sourceRoot":"","sources":["../../../src/server/execution/execution-journal.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,oEAAoE;AACpE,8EAA8E;AAE9E,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAO1C,MAAM,OAAO,gBAAgB;IACV,WAAW,CAAS;IACpB,YAAY,CAAS;IAEtC,YAAY,YAAoB,EAAE,YAAY,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI;QAC/D,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;QACpE,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,MAAM,CAAC,KAAmB;QAC9B,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QACpF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;QAC3C,MAAM,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,OAAO;QACX,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,MAAM,GAAmB,EAAE,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,IAAI,CAAC;gBACH,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAiB,CAAC,CAAC;YACnD,CAAC;YAAC,MAAM,CAAC;gBACP,qEAAqE;YACvE,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,iBAAiB,CAAC,OAAe;QACrC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACjC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,gFAAgF;IAChF,KAAK,CAAC,OAAO;QACX,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,OAAO,GAAqB,EAAE,CAAC;QAErC,mBAAmB;QACnB,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;QAClD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAC9C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,KAAK,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,OAAO,EAAE,CAAC;YAC7C,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;YAClF,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAEvC,IAAI,IAAI,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBACrC,yEAAyE;gBACzE,OAAO,CAAC,IAAI,CAAC;oBACX,OAAO;oBACP,MAAM,EAAE,OAAO;oBACf,MAAM,EAAE,qDAAqD;iBAC9D,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,IAAI,IAAI,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;gBAC/E,qDAAqD;gBACrD,MAAM,gBAAgB,GAAG,MAAM;qBAC5B,MAAM,CAAC,CAAC,CAAC,EAA+B,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,qBAAqB,CAAC;qBAC5E,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;gBACxB,OAAO,CAAC,IAAI,CAAC;oBACX,OAAO;oBACP,MAAM,EAAE,aAAa;oBACrB,MAAM,EAAE,yBAAyB,gBAAgB,CAAC,MAAM,kBAAkB;oBAC1E,gBAAgB;iBACjB,CAAC,CAAC;YACL,CAAC;YACD,sEAAsE;QACxE,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,kDAAkD;IAClD,KAAK,CAAC,MAAM;QACV,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC1C,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;gBAC/E,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;QAC/C,CAAC;IACH,CAAC;CACF"}

package/dashboard/dist-server/server/execution/execution-scheduler.d.ts

@@ -0,0 +1,126 @@
+import type { AgentType } from '../../shared/agent-types.js';
+import type { ExecutionSlot, SchedulerConfig, SchedulerStatus } from '../../shared/execution-types.js';
+import type { AgentManager } from '../agents/agent-manager.js';
+import type { DashboardEventBus } from '../state/event-bus.js';
+import { PromptRegistry } from '../prompt/prompt-registry.js';
+import type { ExecutionJournal } from './execution-journal.js';
+import type { DispatchStrategy } from './dispatch-strategy.js';
+import type { SelfLearningService } from '../supervisor/self-learning-service.js';
+export declare class ExecutionScheduler {
+    private readonly agentManager;
+    private readonly eventBus;
+    private readonly jsonlPath;
+    private readonly journal?;
+    private readonly runningSlots;
+    private readonly queue;
+    private readonly retryQueue;
+    private readonly claimed;
+    private config;
+    private readonly workspaceManager;
+    private readonly promptRegistry;
+    private tickTimer;
+    private lastTickAt;
+    private stats;
+    private tokenUsage;
+    private readonly strategies;
+    private activeStrategy;
+    private selfLearningService?;
+    private isDispatching;
+    isCommanderActive: boolean;
+    private readonly factory;
+    constructor(agentManager: AgentManager, eventBus: DashboardEventBus, jsonlPath: string, config?: Partial<SchedulerConfig>, promptRegistry?: PromptRegistry, journal?: ExecutionJournal | undefined, selfLearningService?: SelfLearningService);
+    /** Dispatch a single issue for execution */
+    executeIssue(issueId: string, executor?: AgentType): Promise<void>;
+    /** Enqueue multiple issues for batch execution */
+    executeBatch(issueIds: string[], executor?: AgentType, maxConcurrency?: number): Promise<void>;
+    /** Cancel a running or queued issue */
+    cancelIssue(issueId: string): Promise<void>;
+    /** Start the automatic dispatch tick loop */
+    enableAutoDispatch(): void;
+    /** @deprecated Use enableAutoDispatch() */
+    startSupervisor(): void;
+    /** Stop automatic dispatch */
+    disableAutoDispatch(): void;
+    /** @deprecated Use disableAutoDispatch() */
+    stopSupervisor(): void;
+    /** Update scheduler config */
+    updateConfig(partial: Partial<SchedulerConfig>): void;
+    /** Get a snapshot of current scheduler state */
+    getStatus(): SchedulerStatus;
+    /** Get config */
+    getConfig(): SchedulerConfig;
+    /** Get the execution slot for a given issue */
+    getSlotForIssue(issueId: string): ExecutionSlot | undefined;
+    /** Register a dispatch strategy (overwrites if name already exists). */
+    registerStrategy(strategy: DispatchStrategy): void;
+    /** Switch the active dispatch strategy by name. Throws if not registered. */
+    setStrategy(name: string): void;
+    /** Get the name of the active dispatch strategy. */
+    getActiveStrategyName(): string;
+    /** Acquire a slot for external use (e.g., WaveExecutor subtasks). Returns false if no capacity. */
+    acquireSlot(issueId: string, processId: string, executor: AgentType): boolean;
+    /** Release a slot after external use */
+    releaseSlot(processId: string): void;
+    /** Wait for a slot to become available, with timeout. Resolves true if acquired, false on timeout. */
+    waitForSlot(issueId: string, processId: string, executor: AgentType, timeoutMs?: number): Promise<boolean>;
+    /** Clean shutdown */
+    destroy(): Promise<void>;
+    /** Atomically claim an issue. Returns true if successfully claimed. */
+    private claim;
+    /** Recover in-memory state from persisted JSONL on startup */
+    private recoverState;
+    private dispatch;
+    /**
+     * Chain-based dispatch — routes issue execution through a GraphWalker chain.
+     * The chain (e.g., 'issue-lifecycle') defines the multi-step execution flow.
+     */
+    private dispatchViaChain;
+    private buildPrompt;
+    /** Inline fallback — preserves original logic for backward compatibility */
+    private buildPromptFallback;
+    /** Simple variable substitution for custom prompt templates */
+    private applyTemplate;
+    private subscribeToAgentEvents;
+    private handleAgentStopped;
+    /**
+     * Handle turn/completed notification from a codex-server agent.
+     * The process is still alive — attempt continuation or complete.
+     */
+    private handleTurnCompleted;
+    private handleCompletion;
+    /** Extract structured result from agent entry history */
+    private extractResult;
+    private handleFailure;
+    /**
+     * Attempt to continue a codex-server agent for another turn.
+     * Returns true if continuation was initiated; false if normal completion should proceed.
+     */
+    private attemptContinuation;
+    /** Build a continuation prompt for multi-turn execution */
+    private buildContinuationPrompt;
+    private tick;
+    /** Delegate issue selection to the active strategy and execute returned decisions. */
+    private dispatchViaStrategy;
+    /**
+     * Reconcile running slots against persisted issue state.
+     * If an issue was externally resolved or closed, stop its agent.
+     */
+    private reconcileRunningIssues;
+    private detectStalls;
+    private processRetries;
+    /** @deprecated Superseded by PriorityStrategy via dispatchViaStrategy(). Kept for reference. */
+    private autoDispatchByPriority;
+    /**
+     * @deprecated Superseded by SmartStrategy via dispatchViaStrategy(). Kept for reference.
+     *
+     * Smart strategy: priority + executor affinity + failure avoidance.
+     * - Prioritize issues matching idle executor types (spread load across agents)
+     * - Deprioritize issue types that have recently failed
+     */
+    private autoDispatchSmart;
+    private dispatchNext;
+    private findIssue;
+    /** Atomically update multiple fields on an issue in a single read-modify-write */
+    private updateIssueFields;
+    private emitStatus;
+}