maestro-flow 0.1.4 → 0.2.0

package/dashboard/dist-server/dashboard/src/server/routes/docs.d.ts

@@ -0,0 +1,13 @@
+import { Hono } from 'hono';
+import type { DashboardEventBus } from '../state/event-bus.js';
+/**
+ * /api/docs — unified document index backed by DocScanner.
+ *
+ * Reads files under `.workflow/` (specs, phases, project.md, roadmap.md,
+ * memory/) plus virtual docs adapted from JSONL sources (issues, learning).
+ * JSONL rows are read-only reflections; never mutated by this route.
+ *
+ * The scanner is recreated on `workspace:switched` events so subsequent
+ * requests see the new workflow root.
+ */
+export declare function createDocsRoutes(workflowRoot: () => string, eventBus: DashboardEventBus): Hono;

package/dashboard/dist-server/dashboard/src/server/routes/docs.js

@@ -0,0 +1,108 @@
+import { Hono } from 'hono';
+import { DocScanner } from '../docs/doc-scanner.js';
+/**
+ * /api/docs — unified document index backed by DocScanner.
+ *
+ * Reads files under `.workflow/` (specs, phases, project.md, roadmap.md,
+ * memory/) plus virtual docs adapted from JSONL sources (issues, learning).
+ * JSONL rows are read-only reflections; never mutated by this route.
+ *
+ * The scanner is recreated on `workspace:switched` events so subsequent
+ * requests see the new workflow root.
+ */
+export function createDocsRoutes(workflowRoot, eventBus) {
+    const app = new Hono();
+    let scanner = new DocScanner({ workflowRoot: workflowRoot() });
+    eventBus.on('workspace:switched', () => {
+        scanner = new DocScanner({ workflowRoot: workflowRoot() });
+    });
+    eventBus.on('docs:invalidated', (event) => {
+        // Skip re-entrant notify() emissions (those carry no `path`).
+        const data = event.data;
+        if (data && data.path) {
+            scanner.invalidate(data.path);
+        }
+    });
+    // Emit a typed `docs:invalidated` event after the first successful build
+    // so SSE subscribers know a fresh index is available.
+    const notify = async () => {
+        const index = await scanner.get();
+        eventBus.emit('docs:invalidated', { at: index.generatedAt });
+    };
+    app.get('/api/docs', async (c) => {
+        const filters = parseFilters(c.req.query());
+        const group = c.req.query('group') === 'true';
+        if (group) {
+            const groups = await scanner.groups(filters);
+            return c.json({ groups });
+        }
+        const docs = await scanner.query(filters);
+        return c.json({ docs });
+    });
+    app.get('/api/docs/stats', async (c) => {
+        const index = await scanner.get();
+        const totals = {
+            project: 0,
+            roadmap: 0,
+            spec: 0,
+            phase: 0,
+            issue: 0,
+            lesson: 0,
+            memory: 0,
+            note: 0,
+        };
+        const tagCounts = {};
+        for (const d of index.docs) {
+            totals[d.type]++;
+            for (const t of d.tags)
+                tagCounts[t] = (tagCounts[t] ?? 0) + 1;
+        }
+        return c.json({ totals, tagCounts, lastUpdated: index.generatedAt });
+    });
+    app.get('/api/docs/:id/backlinks', async (c) => {
+        const id = c.req.param('id');
+        if (!isValidId(id))
+            return c.json({ error: 'Invalid doc id' }, 400);
+        const index = await scanner.get();
+        const ids = index.backlinks[id] ?? [];
+        const backlinks = ids.map((sourceId) => index.byId[sourceId]).filter(Boolean);
+        return c.json({ backlinks });
+    });
+    app.get('/api/docs/:id', async (c) => {
+        const id = c.req.param('id');
+        if (!isValidId(id))
+            return c.json({ error: 'Invalid doc id' }, 400);
+        const index = await scanner.get();
+        const doc = index.byId[id];
+        if (!doc)
+            return c.json({ error: 'Doc not found' }, 404);
+        return c.json({ doc });
+    });
+    // Fire-and-forget: warm the cache on first mount. Errors surfaced via logs.
+    notify().catch((err) => {
+        // eslint-disable-next-line no-console
+        console.warn('[docs] initial scan failed', err);
+    });
+    return app;
+}
+function parseFilters(q) {
+    const out = {};
+    if (q.type)
+        out.type = q.type;
+    if (q.tag)
+        out.tag = q.tag;
+    if (q.phase !== undefined && q.phase !== '') {
+        const n = Number(q.phase);
+        if (Number.isFinite(n))
+            out.phase = n;
+    }
+    if (q.status)
+        out.status = q.status;
+    if (q.q)
+        out.q = q.q;
+    return out;
+}
+function isValidId(id) {
+    return /^[\w.-]+$/.test(id) && !id.includes('/') && !id.includes('\\');
+}
+//# sourceMappingURL=docs.js.map

package/dashboard/dist-server/dashboard/src/server/routes/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../../../src/server/routes/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC9B,YAA0B,EAC1B,QAA2B;IAE3B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,IAAI,OAAO,GAAG,IAAI,UAAU,CAAC,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;IAE/D,QAAQ,CAAC,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QACrC,OAAO,GAAG,IAAI,UAAU,CAAC,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,EAAE;QACxC,8DAA8D;QAC9D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAqC,CAAC;QACzD,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACtB,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,yEAAyE;IACzE,sDAAsD;IACtD,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE;QACxB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/D,CAAC,CAAC;IAEF,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC/B,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC;QAC9C,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC7C,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5B,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1C,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC;QAClC,MAAM,MAAM,GAA4B;YACtC,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;YACV,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,CAAC;YACT,IAAI,EAAE,CAAC;SACR,CAAC;QACF,MAAM,SAAS,GAA2B,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAC3B,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACjB,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI;gBAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,yBAAyB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC7C,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,GAAG,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9E,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACnC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,GAAG,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3B,IAAI,CAAC,GAAG;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,GAAG,CAAC,CAAC;QACzD,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,4EAA4E;IAC5E,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACrB,sCAAsC;QACtC,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,YAAY,CAAC,CAAyB;IAC7C,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,IAAI,CAAC,CAAC,IAAI;QAAE,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAe,CAAC;IACzC,IAAI,CAAC,CAAC,GAAG;QAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;IAC3B,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;QAC5C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,CAAC,CAAC,MAAM;QAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,MAAmB,CAAC;IACjD,IAAI,CAAC,CAAC,CAAC;QAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACrB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,SAAS,CAAC,EAAU;IAC3B,OAAO,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACzE,CAAC"}

package/dashboard/dist-server/dashboard/src/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/dashboard/src/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/dashboard/src/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/dashboard/src/server/routes/events.test.d.ts

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

package/dashboard/dist-server/dashboard/src/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/dashboard/src/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/dashboard/src/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/dashboard/src/server/routes/execution.integration.test.d.ts

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

package/dashboard/dist-server/dashboard/src/server/routes/execution.integration.test.js

@@ -0,0 +1,280 @@
+import { describe, it, expect, vi } from 'vitest';
+import { Hono } from 'hono';
+import { createExecutionRoutes } from './execution.js';
+function createMockScheduler() {
+    const calls = [];
+    const status = {
+        enabled: false,
+        running: [],
+        queued: [],
+        maxConcurrency: 3,
+    };
+    const scheduler = {
+        executeIssue: vi.fn(async (issueId, executor) => {
+            calls.push({ method: 'executeIssue', args: [issueId, executor] });
+        }),
+        executeBatch: vi.fn(async (ids, executor, max) => {
+            calls.push({ method: 'executeBatch', args: [ids, executor, max] });
+        }),
+        cancelIssue: vi.fn(async (id) => {
+            calls.push({ method: 'cancelIssue', args: [id] });
+        }),
+        getStatus: vi.fn(() => status),
+        updateConfig: vi.fn((config) => {
+            calls.push({ method: 'updateConfig', args: [config] });
+        }),
+        startSupervisor: vi.fn(() => {
+            status.enabled = true;
+            calls.push({ method: 'startSupervisor', args: [] });
+        }),
+        stopSupervisor: vi.fn(() => {
+            status.enabled = false;
+            calls.push({ method: 'stopSupervisor', args: [] });
+        }),
+    };
+    return { scheduler, calls };
+}
+function createApp() {
+    const { scheduler, calls } = createMockScheduler();
+    const routes = createExecutionRoutes(scheduler);
+    const app = new Hono();
+    app.route('/', routes);
+    return { app, scheduler, calls };
+}
+// ---------------------------------------------------------------------------
+// Dispatch routes
+// ---------------------------------------------------------------------------
+describe('Execution routes + Scheduler integration', () => {
+    describe('POST /api/execution/dispatch', () => {
+        it('dispatches single issue to scheduler', async () => {
+            const { app, calls } = createApp();
+            const res = await app.request('/api/execution/dispatch', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ issueId: 'ISS-001' }),
+            });
+            expect(res.status).toBe(200);
+            const body = (await res.json());
+            expect(body.ok).toBe(true);
+            expect(body.issueId).toBe('ISS-001');
+            expect(calls).toHaveLength(1);
+            expect(calls[0].method).toBe('executeIssue');
+            expect(calls[0].args[0]).toBe('ISS-001');
+        });
+        it('dispatches with executor override', async () => {
+            const { app, calls } = createApp();
+            const res = await app.request('/api/execution/dispatch', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ issueId: 'ISS-002', executor: 'gemini' }),
+            });
+            expect(res.status).toBe(200);
+            expect(calls[0].args).toEqual(['ISS-002', 'gemini']);
+        });
+        it('rejects missing issueId', async () => {
+            const { app } = createApp();
+            const res = await app.request('/api/execution/dispatch', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({}),
+            });
+            expect(res.status).toBe(400);
+            const body = (await res.json());
+            expect(body.error).toContain('issueId');
+        });
+        it('rejects invalid executor', async () => {
+            const { app } = createApp();
+            const res = await app.request('/api/execution/dispatch', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ issueId: 'ISS-001', executor: 'invalid-tool' }),
+            });
+            expect(res.status).toBe(400);
+            const body = (await res.json());
+            expect(body.error).toContain('executor');
+        });
+        it('returns 500 when scheduler throws', async () => {
+            const { app, scheduler } = createApp();
+            scheduler.executeIssue.mockRejectedValueOnce(new Error('Issue not found in store'));
+            const res = await app.request('/api/execution/dispatch', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ issueId: 'ISS-missing' }),
+            });
+            expect(res.status).toBe(500);
+            const body = (await res.json());
+            expect(body.error).toBe('Issue not found in store');
+        });
+    });
+    // ---------------------------------------------------------------------------
+    // Batch dispatch
+    // ---------------------------------------------------------------------------
+    describe('POST /api/execution/batch', () => {
+        it('dispatches batch of issues', async () => {
+            const { app, calls } = createApp();
+            const res = await app.request('/api/execution/batch', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ issueIds: ['ISS-001', 'ISS-002', 'ISS-003'] }),
+            });
+            expect(res.status).toBe(200);
+            const body = (await res.json());
+            expect(body.ok).toBe(true);
+            expect(body.count).toBe(3);
+            expect(calls[0].method).toBe('executeBatch');
+            expect(calls[0].args[0]).toEqual(['ISS-001', 'ISS-002', 'ISS-003']);
+        });
+        it('passes executor and maxConcurrency to scheduler', async () => {
+            const { app, calls } = createApp();
+            const res = await app.request('/api/execution/batch', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    issueIds: ['ISS-001'],
+                    executor: 'codex',
+                    maxConcurrency: 5,
+                }),
+            });
+            expect(res.status).toBe(200);
+            expect(calls[0].args).toEqual([['ISS-001'], 'codex', 5]);
+        });
+        it('rejects empty issueIds array', async () => {
+            const { app } = createApp();
+            const res = await app.request('/api/execution/batch', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ issueIds: [] }),
+            });
+            expect(res.status).toBe(400);
+        });
+        it('rejects non-array issueIds', async () => {
+            const { app } = createApp();
+            const res = await app.request('/api/execution/batch', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ issueIds: 'ISS-001' }),
+            });
+            expect(res.status).toBe(400);
+        });
+        it('rejects negative maxConcurrency', async () => {
+            const { app } = createApp();
+            const res = await app.request('/api/execution/batch', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ issueIds: ['ISS-001'], maxConcurrency: -1 }),
+            });
+            expect(res.status).toBe(400);
+        });
+        it('rejects invalid executor in batch', async () => {
+            const { app } = createApp();
+            const res = await app.request('/api/execution/batch', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ issueIds: ['ISS-001'], executor: 'invalid-tool' }),
+            });
+            expect(res.status).toBe(400);
+            const body = (await res.json());
+            expect(body.error).toContain('executor');
+        });
+        it('returns 500 when executeBatch throws', async () => {
+            const { app, scheduler } = createApp();
+            scheduler.executeBatch.mockRejectedValueOnce(new Error('Batch execution failed'));
+            const res = await app.request('/api/execution/batch', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ issueIds: ['ISS-001', 'ISS-002'] }),
+            });
+            expect(res.status).toBe(500);
+            const body = (await res.json());
+            expect(body.error).toBe('Batch execution failed');
+        });
+    });
+    // ---------------------------------------------------------------------------
+    // Cancel + Status
+    // ---------------------------------------------------------------------------
+    describe('POST /api/execution/cancel/:id', () => {
+        it('cancels a running issue', async () => {
+            const { app, calls } = createApp();
+            const res = await app.request('/api/execution/cancel/ISS-001', { method: 'POST' });
+            expect(res.status).toBe(200);
+            const body = (await res.json());
+            expect(body.ok).toBe(true);
+            expect(calls[0].method).toBe('cancelIssue');
+            expect(calls[0].args[0]).toBe('ISS-001');
+        });
+    });
+    describe('GET /api/execution/status', () => {
+        it('returns scheduler status snapshot', async () => {
+            const { app } = createApp();
+            const res = await app.request('/api/execution/status');
+            expect(res.status).toBe(200);
+            const body = (await res.json());
+            expect(body.enabled).toBe(false);
+            expect(body.maxConcurrency).toBe(3);
+        });
+    });
+    // ---------------------------------------------------------------------------
+    // Supervisor control
+    // ---------------------------------------------------------------------------
+    describe('PUT /api/execution/supervisor', () => {
+        it('starts supervisor when enabled=true', async () => {
+            const { app, calls } = createApp();
+            const res = await app.request('/api/execution/supervisor', {
+                method: 'PUT',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ enabled: true }),
+            });
+            expect(res.status).toBe(200);
+            const body = (await res.json());
+            expect(body.ok).toBe(true);
+            expect(calls.some((c) => c.method === 'startSupervisor')).toBe(true);
+        });
+        it('stops supervisor when enabled=false', async () => {
+            const { app, calls } = createApp();
+            const res = await app.request('/api/execution/supervisor', {
+                method: 'PUT',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ enabled: false }),
+            });
+            expect(res.status).toBe(200);
+            expect(calls.some((c) => c.method === 'stopSupervisor')).toBe(true);
+        });
+        it('updates config and starts supervisor in one call', async () => {
+            const { app, calls } = createApp();
+            const res = await app.request('/api/execution/supervisor', {
+                method: 'PUT',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ enabled: true, config: { maxConcurrency: 10 } }),
+            });
+            expect(res.status).toBe(200);
+            expect(calls.some((c) => c.method === 'updateConfig')).toBe(true);
+            expect(calls.some((c) => c.method === 'startSupervisor')).toBe(true);
+        });
+        it('returns 500 when supervisor config throws', async () => {
+            const { app, scheduler } = createApp();
+            scheduler.updateConfig.mockImplementationOnce(() => {
+                throw new Error('Invalid config value');
+            });
+            const res = await app.request('/api/execution/supervisor', {
+                method: 'PUT',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ config: { maxConcurrency: -999 } }),
+            });
+            expect(res.status).toBe(500);
+            const body = (await res.json());
+            expect(body.error).toBe('Invalid config value');
+        });
+    });
+    // --- Cancel error handling ---
+    describe('POST /api/execution/cancel/:id — error paths', () => {
+        it('returns 500 when cancelIssue throws', async () => {
+            const { app, scheduler } = createApp();
+            scheduler.cancelIssue.mockRejectedValueOnce(new Error('Issue not in running or queued state'));
+            const res = await app.request('/api/execution/cancel/ISS-unknown', { method: 'POST' });
+            expect(res.status).toBe(500);
+            const body = (await res.json());
+            expect(body.error).toBe('Issue not in running or queued state');
+        });
+    });
+});
+//# sourceMappingURL=execution.integration.test.js.map