maestro-flow 0.1.0

package/dashboard/dist-server/server/routes/board-state.integration.test.js

@@ -0,0 +1,240 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { writeFile, mkdir, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { createBoardRoutes } from './board.js';
+import { createPhaseRoutes } from './phases.js';
+import { StateManager } from '../state/state-manager.js';
+import { DashboardEventBus } from '../state/event-bus.js';
+import { Hono } from 'hono';
+// ---------------------------------------------------------------------------
+// L2 Integration: Board/Phase routes <-> StateManager <-> EventBus <-> FileSystem
+// Tests real cross-module interactions with actual file I/O
+// ---------------------------------------------------------------------------
+let workflowRoot;
+let eventBus;
+let stateManager;
+let app;
+beforeEach(async () => {
+    workflowRoot = join(tmpdir(), `board-int-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`);
+    await mkdir(workflowRoot, { recursive: true });
+    eventBus = new DashboardEventBus();
+    stateManager = new StateManager(workflowRoot, eventBus);
+    app = new Hono();
+    app.route('/', createBoardRoutes(stateManager));
+    app.route('/', createPhaseRoutes(stateManager));
+});
+afterEach(async () => {
+    eventBus.removeAllListeners();
+    await rm(workflowRoot, { recursive: true, force: true });
+});
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+async function writeStateJson(state) {
+    const full = {
+        version: '1.0',
+        project_name: 'test-project',
+        current_milestone: 'M1',
+        current_phase: 1,
+        status: 'executing',
+        phases_summary: { total: 2, completed: 0, in_progress: 1, pending: 1 },
+        last_updated: new Date().toISOString(),
+        accumulated_context: { key_decisions: [], blockers: [], deferred: [] },
+        ...state,
+    };
+    await writeFile(join(workflowRoot, 'state.json'), JSON.stringify(full), 'utf-8');
+}
+async function writePhase(slug, phase) {
+    const phaseDir = join(workflowRoot, 'phases', slug);
+    await mkdir(phaseDir, { recursive: true });
+    await writeFile(join(phaseDir, 'index.json'), JSON.stringify(phase), 'utf-8');
+}
+async function writeTask(slug, taskFile, task) {
+    const taskDir = join(workflowRoot, 'phases', slug, '.task');
+    await mkdir(taskDir, { recursive: true });
+    await writeFile(join(taskDir, taskFile), JSON.stringify(task), 'utf-8');
+}
+// ---------------------------------------------------------------------------
+// Board + StateManager + EventBus integration
+// ---------------------------------------------------------------------------
+describe('Board routes + StateManager + EventBus integration', () => {
+    it('GET /api/board returns empty board before buildInitialState', async () => {
+        const res = await app.request('/api/board');
+        expect(res.status).toBe(200);
+        const body = (await res.json());
+        expect(body.phases).toEqual([]);
+        expect(body.scratch).toEqual([]);
+        expect(body.project.project_name).toBe('');
+    });
+    it('GET /api/board returns populated state after buildInitialState', async () => {
+        await writeStateJson({ project_name: 'my-project', current_phase: 1 });
+        await writePhase('01-setup', {
+            phase: 1,
+            title: 'Setup',
+            status: 'executing',
+            success_criteria: 'Project initialized',
+        });
+        await stateManager.buildInitialState();
+        const res = await app.request('/api/board');
+        expect(res.status).toBe(200);
+        const body = (await res.json());
+        expect(body.project.project_name).toBe('my-project');
+        expect(body.phases).toHaveLength(1);
+        expect(body.phases[0].title).toBe('Setup');
+    });
+    it('buildInitialState emits board:full event via EventBus', async () => {
+        await writeStateJson({});
+        const events = [];
+        eventBus.on('board:full', (e) => events.push(e));
+        await stateManager.buildInitialState();
+        expect(events).toHaveLength(1);
+        expect(events[0].type).toBe('board:full');
+        expect(events[0].data).toBeDefined();
+    });
+    it('GET /api/project returns project state after buildInitialState', async () => {
+        await writeStateJson({ project_name: 'proj-abc', status: 'planning' });
+        await stateManager.buildInitialState();
+        const res = await app.request('/api/project');
+        expect(res.status).toBe(200);
+        const body = (await res.json());
+        expect(body.project_name).toBe('proj-abc');
+        expect(body.status).toBe('planning');
+    });
+    it('multiple phases are sorted by phase number', async () => {
+        await writeStateJson({});
+        await writePhase('03-verify', { phase: 3, title: 'Verify', status: 'pending' });
+        await writePhase('01-setup', { phase: 1, title: 'Setup', status: 'completed' });
+        await writePhase('02-build', { phase: 2, title: 'Build', status: 'executing' });
+        await stateManager.buildInitialState();
+        const res = await app.request('/api/board');
+        const body = (await res.json());
+        expect(body.phases).toHaveLength(3);
+        expect(body.phases[0].phase).toBe(1);
+        expect(body.phases[1].phase).toBe(2);
+        expect(body.phases[2].phase).toBe(3);
+    });
+});
+// ---------------------------------------------------------------------------
+// Phase routes + StateManager integration
+// ---------------------------------------------------------------------------
+describe('Phase routes + StateManager integration', () => {
+    it('GET /api/phases returns all phases from StateManager', async () => {
+        await writeStateJson({});
+        await writePhase('01-init', { phase: 1, title: 'Init', status: 'completed' });
+        await writePhase('02-impl', { phase: 2, title: 'Implement', status: 'executing' });
+        await stateManager.buildInitialState();
+        const res = await app.request('/api/phases');
+        expect(res.status).toBe(200);
+        const body = (await res.json());
+        expect(body).toHaveLength(2);
+        expect(body[0].title).toBe('Init');
+        expect(body[1].title).toBe('Implement');
+    });
+    it('GET /api/phases/:n returns specific phase', async () => {
+        await writeStateJson({});
+        await writePhase('01-init', { phase: 1, title: 'Init', status: 'completed' });
+        await stateManager.buildInitialState();
+        const res = await app.request('/api/phases/1');
+        expect(res.status).toBe(200);
+        const body = (await res.json());
+        expect(body.phase).toBe(1);
+        expect(body.title).toBe('Init');
+    });
+    it('GET /api/phases/:n returns 404 for non-existent phase', async () => {
+        await writeStateJson({});
+        await stateManager.buildInitialState();
+        const res = await app.request('/api/phases/99');
+        expect(res.status).toBe(404);
+    });
+    it('GET /api/phases/:n returns 400 for invalid phase number', async () => {
+        const res = await app.request('/api/phases/abc');
+        expect(res.status).toBe(400);
+        const body = (await res.json());
+        expect(body.error).toContain('Invalid');
+    });
+    it('GET /api/phases/:n/tasks returns tasks for a phase', async () => {
+        await writeStateJson({});
+        await writePhase('01-init', { phase: 1, title: 'Init', status: 'executing' });
+        await writeTask('01-init', 'TASK-001.json', {
+            id: 'TASK-001',
+            title: 'Setup project',
+            status: 'completed',
+        });
+        await writeTask('01-init', 'TASK-002.json', {
+            id: 'TASK-002',
+            title: 'Configure CI',
+            status: 'pending',
+        });
+        await stateManager.buildInitialState();
+        const res = await app.request('/api/phases/1/tasks');
+        expect(res.status).toBe(200);
+        const body = (await res.json());
+        expect(body).toHaveLength(2);
+        const ids = body.map((t) => t.id).sort();
+        expect(ids).toEqual(['TASK-001', 'TASK-002']);
+    });
+});
+// ---------------------------------------------------------------------------
+// StateManager.applyFileChange + EventBus integration
+// ---------------------------------------------------------------------------
+describe('StateManager.applyFileChange + EventBus integration', () => {
+    it('applyFileChange on state.json emits project:updated', async () => {
+        await writeStateJson({ project_name: 'initial' });
+        await stateManager.buildInitialState();
+        const events = [];
+        eventBus.on('project:updated', (e) => events.push(e));
+        // Update state.json on disk
+        await writeStateJson({ project_name: 'updated-project', status: 'verifying' });
+        await stateManager.applyFileChange(join(workflowRoot, 'state.json'));
+        expect(events).toHaveLength(1);
+        expect(events[0].type).toBe('project:updated');
+        // Board route should reflect the update
+        const res = await app.request('/api/project');
+        const body = (await res.json());
+        expect(body.project_name).toBe('updated-project');
+        expect(body.status).toBe('verifying');
+    });
+    it('applyFileChange on phase index.json emits phase:updated', async () => {
+        await writeStateJson({});
+        await writePhase('01-init', { phase: 1, title: 'Init', status: 'pending' });
+        await stateManager.buildInitialState();
+        const events = [];
+        eventBus.on('phase:updated', (e) => events.push(e));
+        // Update phase on disk
+        await writePhase('01-init', { phase: 1, title: 'Init', status: 'executing' });
+        await stateManager.applyFileChange(join(workflowRoot, 'phases', '01-init', 'index.json'));
+        expect(events).toHaveLength(1);
+        expect(events[0].type).toBe('phase:updated');
+        // Board should reflect the updated status
+        const res = await app.request('/api/phases/1');
+        const body = (await res.json());
+        expect(body.status).toBe('executing');
+    });
+    it('applyFileChange on task file emits task:updated', async () => {
+        await writeStateJson({});
+        await writePhase('01-init', { phase: 1, title: 'Init', status: 'executing' });
+        await writeTask('01-init', 'TASK-001.json', { id: 'TASK-001', title: 'Setup', status: 'pending' });
+        await stateManager.buildInitialState();
+        const events = [];
+        eventBus.on('task:updated', (e) => events.push(e));
+        await writeTask('01-init', 'TASK-001.json', { id: 'TASK-001', title: 'Setup', status: 'completed' });
+        await stateManager.applyFileChange(join(workflowRoot, 'phases', '01-init', '.task', 'TASK-001.json'));
+        expect(events).toHaveLength(1);
+        expect(events[0].type).toBe('task:updated');
+    });
+    it('new phase added via applyFileChange appears in board', async () => {
+        await writeStateJson({});
+        await writePhase('01-init', { phase: 1, title: 'Init', status: 'completed' });
+        await stateManager.buildInitialState();
+        // Add a new phase
+        await writePhase('02-build', { phase: 2, title: 'Build', status: 'pending' });
+        await stateManager.applyFileChange(join(workflowRoot, 'phases', '02-build', 'index.json'));
+        const res = await app.request('/api/board');
+        const body = (await res.json());
+        expect(body.phases).toHaveLength(2);
+        expect(body.phases[1].phase).toBe(2);
+        expect(body.phases[1].title).toBe('Build');
+    });
+});
+//# sourceMappingURL=board-state.integration.test.js.map

package/dashboard/dist-server/server/routes/board-state.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-state.integration.test.js","sourceRoot":"","sources":["../../../src/server/routes/board-state.integration.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAM,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,8EAA8E;AAC9E,kFAAkF;AAClF,4DAA4D;AAC5D,8EAA8E;AAE9E,IAAI,YAAoB,CAAC;AACzB,IAAI,QAA2B,CAAC;AAChC,IAAI,YAA0B,CAAC;AAC/B,IAAI,GAAS,CAAC;AAEd,UAAU,CAAC,KAAK,IAAI,EAAE;IACpB,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACnG,MAAM,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/C,QAAQ,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACnC,YAAY,GAAG,IAAI,YAAY,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAExD,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACjB,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC;IAChD,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC;AAClD,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,KAAK,IAAI,EAAE;IACnB,QAAQ,CAAC,kBAAkB,EAAE,CAAC;IAC9B,MAAM,EAAE,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3D,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,KAAK,UAAU,cAAc,CAAC,KAA4B;IACxD,MAAM,IAAI,GAAiB;QACzB,OAAO,EAAE,KAAK;QACd,YAAY,EAAE,cAAc;QAC5B,iBAAiB,EAAE,IAAI;QACvB,aAAa,EAAE,CAAC;QAChB,MAAM,EAAE,WAAW;QACnB,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;QACtE,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACtC,mBAAmB,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACtE,GAAG,KAAK;KACT,CAAC;IACF,MAAM,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AACnF,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,KAAgB;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACpD,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;AAChF,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,QAAgB,EAAE,IAA6B;IACpF,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5D,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AAC1E,CAAC;AAED,8EAA8E;AAC9E,8CAA8C;AAC9C,8EAA8E;AAE9E,QAAQ,CAAC,oDAAoD,EAAE,GAAG,EAAE;IAClE,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAe,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,cAAc,CAAC,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;QACvE,MAAM,UAAU,CAAC,UAAU,EAAE;YAC3B,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,WAAW;YACnB,gBAAgB,EAAE,qBAAqB;SAChB,CAAC,CAAC;QAE3B,MAAM,YAAY,CAAC,iBAAiB,EAAE,CAAC;QAEvC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAe,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,cAAc,CAAC,EAAE,CAAC,CAAC;QAEzB,MAAM,MAAM,GAAe,EAAE,CAAC;QAC9B,QAAQ,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAEjD,MAAM,YAAY,CAAC,iBAAiB,EAAE,CAAC;QAEvC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,cAAc,CAAC,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QACvE,MAAM,YAAY,CAAC,iBAAiB,EAAE,CAAC;QAEvC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAC9C,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAiB,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,cAAc,CAAC,EAAE,CAAC,CAAC;QACzB,MAAM,UAAU,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAe,CAAC,CAAC;QAC7F,MAAM,UAAU,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAe,CAAC,CAAC;QAC7F,MAAM,UAAU,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAe,CAAC,CAAC;QAE7F,MAAM,YAAY,CAAC,iBAAiB,EAAE,CAAC;QAEvC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAe,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,0CAA0C;AAC1C,8EAA8E;AAE9E,QAAQ,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACvD,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,cAAc,CAAC,EAAE,CAAC,CAAC;QACzB,MAAM,UAAU,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAe,CAAC,CAAC;QAC3F,MAAM,UAAU,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAe,CAAC,CAAC;QAChG,MAAM,YAAY,CAAC,iBAAiB,EAAE,CAAC;QAEvC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAgB,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,cAAc,CAAC,EAAE,CAAC,CAAC;QACzB,MAAM,UAAU,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAe,CAAC,CAAC;QAC3F,MAAM,YAAY,CAAC,iBAAiB,EAAE,CAAC;QAEvC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAC/C,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAc,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,cAAc,CAAC,EAAE,CAAC,CAAC;QACzB,MAAM,YAAY,CAAC,iBAAiB,EAAE,CAAC;QAEvC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAChD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACjD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAsB,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,cAAc,CAAC,EAAE,CAAC,CAAC;QACzB,MAAM,UAAU,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAe,CAAC,CAAC;QAC3F,MAAM,SAAS,CAAC,SAAS,EAAE,eAAe,EAAE;YAC1C,EAAE,EAAE,UAAU;YACd,KAAK,EAAE,eAAe;YACtB,MAAM,EAAE,WAAW;SACpB,CAAC,CAAC;QACH,MAAM,SAAS,CAAC,SAAS,EAAE,eAAe,EAAE;YAC1C,EAAE,EAAE,UAAU;YACd,KAAK,EAAE,cAAc;YACrB,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;QACH,MAAM,YAAY,CAAC,iBAAiB,EAAE,CAAC;QAEvC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QACrD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA0B,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,sDAAsD;AACtD,8EAA8E;AAE9E,QAAQ,CAAC,qDAAqD,EAAE,GAAG,EAAE;IACnE,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,cAAc,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;QAClD,MAAM,YAAY,CAAC,iBAAiB,EAAE,CAAC;QAEvC,MAAM,MAAM,GAAe,EAAE,CAAC;QAC9B,QAAQ,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAEtD,4BAA4B;QAC5B,MAAM,cAAc,CAAC,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;QAC/E,MAAM,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC;QAErE,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAE/C,wCAAwC;QACxC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAiB,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,cAAc,CAAC,EAAE,CAAC,CAAC;QACzB,MAAM,UAAU,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAe,CAAC,CAAC;QACzF,MAAM,YAAY,CAAC,iBAAiB,EAAE,CAAC;QAEvC,MAAM,MAAM,GAAe,EAAE,CAAC;QAC9B,QAAQ,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAEpD,uBAAuB;QACvB,MAAM,UAAU,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAe,CAAC,CAAC;QAC3F,MAAM,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;QAE1F,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAE7C,0CAA0C;QAC1C,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAc,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,cAAc,CAAC,EAAE,CAAC,CAAC;QACzB,MAAM,UAAU,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAe,CAAC,CAAC;QAC3F,MAAM,SAAS,CAAC,SAAS,EAAE,eAAe,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACnG,MAAM,YAAY,CAAC,iBAAiB,EAAE,CAAC;QAEvC,MAAM,MAAM,GAAe,EAAE,CAAC;QAC9B,QAAQ,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAEnD,MAAM,SAAS,CAAC,SAAS,EAAE,eAAe,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;QACrG,MAAM,YAAY,CAAC,eAAe,CAChC,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,CAAC,CAClE,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,cAAc,CAAC,EAAE,CAAC,CAAC;QACzB,MAAM,UAAU,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAe,CAAC,CAAC;QAC3F,MAAM,YAAY,CAAC,iBAAiB,EAAE,CAAC;QAEvC,kBAAkB;QAClB,MAAM,UAAU,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAe,CAAC,CAAC;QAC3F,MAAM,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;QAE3F,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAe,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dashboard/dist-server/server/routes/board.d.ts

@@ -0,0 +1,9 @@
+import { Hono } from 'hono';
+import type { StateManager } from '../state/state-manager.js';
+/**
+ * Board and project routes.
+ *
+ * GET /api/board    - full BoardState snapshot
+ * GET /api/project  - project-level state (state.json)
+ */
+export declare function createBoardRoutes(stateManager: StateManager): Hono;

package/dashboard/dist-server/server/routes/board.js

@@ -0,0 +1,18 @@
+import { Hono } from 'hono';
+/**
+ * Board and project routes.
+ *
+ * GET /api/board    - full BoardState snapshot
+ * GET /api/project  - project-level state (state.json)
+ */
+export function createBoardRoutes(stateManager) {
+    const app = new Hono();
+    app.get('/api/board', (c) => {
+        return c.json(stateManager.getBoard());
+    });
+    app.get('/api/project', (c) => {
+        return c.json(stateManager.getProject());
+    });
+    return app;
+}
+//# sourceMappingURL=board.js.map

package/dashboard/dist-server/server/routes/board.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board.js","sourceRoot":"","sources":["../../../src/server/routes/board.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,YAA0B;IAC1D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,GAAG,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE;QAC1B,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE;QAC5B,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dashboard/dist-server/server/routes/cli-history.d.ts

@@ -0,0 +1,8 @@
+import { Hono } from 'hono';
+/**
+ * CLI history routes.
+ *
+ * GET /api/cli-history            - list recent executions (?limit=20)
+ * GET /api/cli-history/:id/entries - load JSONL entries for an execution
+ */
+export declare function createCliHistoryRoutes(): Hono;

package/dashboard/dist-server/server/routes/cli-history.js

@@ -0,0 +1,85 @@
+// ---------------------------------------------------------------------------
+// CLI History REST API routes
+// Lightweight filesystem reader for ~/.maestro/cli-history/ — avoids
+// cross-rootDir import of CliHistoryStore from src/.
+// ---------------------------------------------------------------------------
+import { Hono } from 'hono';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { readFileSync, readdirSync, statSync } from 'node:fs';
+import { CLI_HISTORY_DIR_NAME } from '../../shared/constants.js';
+function getCliHistoryDir() {
+    const maestroHome = process.env.MAESTRO_HOME ?? join(homedir(), '.maestro');
+    return join(maestroHome, CLI_HISTORY_DIR_NAME);
+}
+/**
+ * CLI history routes.
+ *
+ * GET /api/cli-history            - list recent executions (?limit=20)
+ * GET /api/cli-history/:id/entries - load JSONL entries for an execution
+ */
+export function createCliHistoryRoutes() {
+    const app = new Hono();
+    // GET /api/cli-history
+    app.get('/api/cli-history', (c) => {
+        const limitParam = c.req.query('limit');
+        const limit = limitParam ? Math.min(Math.max(parseInt(limitParam, 10) || 20, 1), 100) : 20;
+        const dir = getCliHistoryDir();
+        try {
+            const files = readdirSync(dir)
+                .filter(f => f.endsWith('.meta.json'))
+                .map(f => ({
+                name: f,
+                mtime: statSync(join(dir, f)).mtimeMs,
+            }))
+                .sort((a, b) => b.mtime - a.mtime)
+                .slice(0, limit);
+            const results = [];
+            for (const f of files) {
+                try {
+                    const raw = readFileSync(join(dir, f.name), 'utf-8');
+                    results.push(JSON.parse(raw));
+                }
+                catch {
+                    // skip corrupt meta files
+                }
+            }
+            return c.json(results);
+        }
+        catch {
+            // Directory doesn't exist or unreadable — return empty
+            return c.json([]);
+        }
+    });
+    // GET /api/cli-history/:id/entries
+    app.get('/api/cli-history/:id/entries', (c) => {
+        const id = c.req.param('id');
+        // Whitelist validation: execId format is {prefix}-{HHmmss}-{hex4} or user-provided alphanumeric
+        if (!/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/.test(id)) {
+            return c.json({ error: 'Invalid execution ID' }, 400);
+        }
+        const dir = getCliHistoryDir();
+        const jsonlPath = join(dir, `${id}.jsonl`);
+        try {
+            const raw = readFileSync(jsonlPath, 'utf-8');
+            const entries = [];
+            for (const line of raw.split('\n')) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                try {
+                    entries.push(JSON.parse(trimmed));
+                }
+                catch {
+                    // skip malformed lines
+                }
+            }
+            return c.json(entries);
+        }
+        catch {
+            return c.json({ error: 'Execution not found' }, 404);
+        }
+    });
+    return app;
+}
+//# sourceMappingURL=cli-history.js.map

package/dashboard/dist-server/server/routes/cli-history.js.map

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

package/dashboard/dist-server/server/routes/events.d.ts

@@ -0,0 +1,13 @@
+import { Hono } from 'hono';
+import type { StateManager } from '../state/state-manager.js';
+import type { SSEHub } from '../sse/sse-hub.js';
+/**
+ * SSE events route.
+ *
+ * GET /events - Server-Sent Events stream.
+ *   1. Sends initial board snapshot as "board:full" event.
+ *   2. Forwards all EventBus events in real time.
+ *   3. Heartbeat comments are handled by SSEHub.
+ *   4. Returns 503 when max connections reached.
+ */
+export declare function createEventsRoute(stateManager: StateManager, _eventBus: unknown, sseHub: SSEHub): Hono;

package/dashboard/dist-server/server/routes/events.js

@@ -0,0 +1,52 @@
+import { Hono } from 'hono';
+import { streamSSE } from 'hono/streaming';
+import { SSE_EVENT_TYPES } from '../../shared/constants.js';
+/**
+ * SSE events route.
+ *
+ * GET /events - Server-Sent Events stream.
+ *   1. Sends initial board snapshot as "board:full" event.
+ *   2. Forwards all EventBus events in real time.
+ *   3. Heartbeat comments are handled by SSEHub.
+ *   4. Returns 503 when max connections reached.
+ */
+export function createEventsRoute(stateManager, _eventBus, sseHub) {
+    const app = new Hono();
+    app.get('/events', (c) => {
+        // Reject when at capacity
+        if (!sseHub.canAccept()) {
+            return c.text('Too many SSE connections', 503);
+        }
+        return streamSSE(c, async (stream) => {
+            // Register with SSEHub — bridge raw SSE text to the stream
+            const clientId = sseHub.addClient((chunk) => {
+                void stream.write(chunk);
+            }, () => {
+                void stream.close();
+            });
+            if (clientId === null) {
+                // Race condition: another client connected between canAccept and addClient
+                await stream.writeSSE({
+                    event: 'error',
+                    data: JSON.stringify({ message: 'Too many connections' }),
+                });
+                await stream.close();
+                return;
+            }
+            // Send initial board snapshot and connected ack through SSEHub's formatSSE
+            // to keep a single delivery path for all events
+            const board = stateManager.getBoard();
+            void stream.write(`event: ${SSE_EVENT_TYPES.BOARD_FULL}\ndata: ${JSON.stringify(board)}\n\n`);
+            void stream.write(`event: ${SSE_EVENT_TYPES.CONNECTED}\ndata: ${JSON.stringify({ clientId })}\n\n`);
+            // Block until client disconnects; cleanup SSEHub registration on abort
+            await new Promise((resolve) => {
+                stream.onAbort(() => {
+                    sseHub.removeClient(clientId);
+                    resolve();
+                });
+            });
+        });
+    });
+    return app;
+}
+//# sourceMappingURL=events.js.map

package/dashboard/dist-server/server/routes/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/server/routes/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAI3C,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,YAA0B,EAC1B,SAAkB,EAClB,MAAc;IAEd,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;QACvB,0BAA0B;QAC1B,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC;YACxB,OAAO,CAAC,CAAC,IAAI,CAAC,0BAA0B,EAAE,GAAG,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACnC,2DAA2D;YAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAC/B,CAAC,KAAa,EAAE,EAAE;gBAChB,KAAK,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC,EACD,GAAG,EAAE;gBACH,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;YACtB,CAAC,CACF,CAAC;YAEF,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACtB,2EAA2E;gBAC3E,MAAM,MAAM,CAAC,QAAQ,CAAC;oBACpB,KAAK,EAAE,OAAO;oBACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;iBAC1D,CAAC,CAAC;gBACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;gBACrB,OAAO;YACT,CAAC;YAED,2EAA2E;YAC3E,gDAAgD;YAChD,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;YACtC,KAAK,MAAM,CAAC,KAAK,CAAC,UAAU,eAAe,CAAC,UAAU,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC9F,KAAK,MAAM,CAAC,KAAK,CAAC,UAAU,eAAe,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC;YAEpG,uEAAuE;YACvE,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;oBAClB,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;oBAC9B,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dashboard/dist-server/server/routes/events.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dashboard/dist-server/server/routes/events.test.js

@@ -0,0 +1,127 @@
+import { describe, it, expect, vi } from 'vitest';
+import { Hono } from 'hono';
+import { createEventsRoute } from './events.js';
+function createMockStateManager() {
+    return {
+        getBoard: vi.fn().mockReturnValue({
+            project: { project_name: 'test' },
+            phases: [],
+            scratch: [],
+            lastUpdated: '2026-01-01T00:00:00Z',
+        }),
+    };
+}
+function createMockSSEHub(overrides = {}) {
+    return {
+        canAccept: vi.fn().mockReturnValue(true),
+        addClient: vi.fn().mockReturnValue('sse-1'),
+        removeClient: vi.fn(),
+        getClientCount: vi.fn().mockReturnValue(0),
+        ...overrides,
+    };
+}
+describe('Events Route', () => {
+    function createApp(sseHubOverrides = {}) {
+        const stateManager = createMockStateManager();
+        const sseHub = createMockSSEHub(sseHubOverrides);
+        const routes = createEventsRoute(stateManager, null, sseHub);
+        const app = new Hono();
+        app.route('/', routes);
+        return { app, stateManager, sseHub };
+    }
+    it('returns 503 when max connections reached', async () => {
+        const { app } = createApp({
+            canAccept: vi.fn().mockReturnValue(false),
+        });
+        const res = await app.request('/events');
+        expect(res.status).toBe(503);
+        const text = await res.text();
+        expect(text).toContain('Too many SSE connections');
+    });
+    it('returns 200 with SSE stream when connections available', async () => {
+        const { app } = createApp();
+        // The stream will hang waiting for abort, but we can check the initial response
+        const controller = new AbortController();
+        const resPromise = app.request('/events', { signal: controller.signal });
+        // Give it a moment to start streaming
+        await new Promise((r) => setTimeout(r, 50));
+        controller.abort();
+        try {
+            const res = await resPromise;
+            // Should return 200 for SSE
+            expect(res.status).toBe(200);
+        }
+        catch {
+            // AbortError is expected when we cancel the stream
+        }
+    });
+    it('handles race condition when addClient returns null', async () => {
+        // Simulate: canAccept() returns true but addClient() returns null (race)
+        const { app } = createApp({
+            canAccept: vi.fn().mockReturnValue(true),
+            addClient: vi.fn().mockReturnValue(null),
+        });
+        const controller = new AbortController();
+        const resPromise = app.request('/events', { signal: controller.signal });
+        // Give it time to process
+        await new Promise((r) => setTimeout(r, 100));
+        controller.abort();
+        try {
+            const res = await resPromise;
+            // Should still return 200 (SSE stream was started), but with error event
+            expect(res.status).toBe(200);
+            const text = await res.text();
+            // The error event should have been written to the stream
+            expect(text).toContain('Too many connections');
+        }
+        catch {
+            // AbortError is expected
+        }
+    });
+    it('calls stream.write for initial board snapshot', async () => {
+        const writeSpy = vi.fn();
+        const { app, sseHub } = createApp();
+        const controller = new AbortController();
+        const resPromise = app.request('/events', { signal: controller.signal });
+        await new Promise((r) => setTimeout(r, 50));
+        controller.abort();
+        try {
+            const res = await resPromise;
+            expect(res.status).toBe(200);
+            // sseHub.addClient should have been called
+            expect(sseHub.addClient).toHaveBeenCalled();
+        }
+        catch {
+            // AbortError expected
+        }
+    });
+    it('invokes write and close callbacks registered via addClient', async () => {
+        let capturedWrite;
+        let capturedClose;
+        const { app } = createApp({
+            canAccept: vi.fn().mockReturnValue(true),
+            addClient: vi.fn().mockImplementation((writeFn, closeFn) => {
+                capturedWrite = writeFn;
+                capturedClose = closeFn;
+                return 'sse-cap';
+            }),
+        });
+        const controller = new AbortController();
+        const resPromise = app.request('/events', { signal: controller.signal });
+        // Wait for addClient to be called
+        await new Promise((r) => setTimeout(r, 50));
+        // Exercise the captured callbacks (covers lines 34 and 37)
+        expect(capturedWrite).toBeDefined();
+        expect(capturedClose).toBeDefined();
+        capturedWrite('data: test\n\n');
+        capturedClose();
+        controller.abort();
+        try {
+            await resPromise;
+        }
+        catch {
+            // AbortError expected
+        }
+    });
+});
+//# sourceMappingURL=events.test.js.map

package/dashboard/dist-server/server/routes/events.test.js.map

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

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

@@ -0,0 +1,12 @@
+import { Hono } from 'hono';
+import type { ExecutionScheduler } from '../execution/execution-scheduler.js';
+/**
+ * Execution routes following the Hono factory pattern.
+ *
+ * POST   /api/execution/dispatch       { issueId, executor? }
+ * POST   /api/execution/batch          { issueIds, executor?, maxConcurrency? }
+ * POST   /api/execution/cancel/:id     cancel running/queued issue
+ * GET    /api/execution/status         supervisor status snapshot
+ * PUT    /api/execution/supervisor     { enabled, config? }
+ */
+export declare function createExecutionRoutes(scheduler: ExecutionScheduler): Hono;

package/dashboard/dist-server/server/routes/execution.integration.test.d.ts

@@ -0,0 +1 @@
+export {};