maestro-flow 0.1.0

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

@@ -0,0 +1,177 @@
+import { describe, it, expect, vi } from 'vitest';
+import { Hono } from 'hono';
+import { createCommanderRoutes } from './commander-routes.js';
+import { DEFAULT_COMMANDER_CONFIG } from '../../shared/commander-types.js';
+// ---------------------------------------------------------------------------
+// Mock CommanderAgent
+// ---------------------------------------------------------------------------
+function createMockCommanderAgent() {
+    const state = {
+        status: 'idle',
+        lastTickAt: '',
+        lastDecision: null,
+        activeWorkers: 0,
+        sessionId: 'test-session',
+        tickCount: 0,
+    };
+    return {
+        start: vi.fn().mockResolvedValue(undefined),
+        stop: vi.fn(),
+        pause: vi.fn(),
+        resume: vi.fn(),
+        getState: vi.fn().mockReturnValue(state),
+        getConfig: vi.fn().mockReturnValue({ ...DEFAULT_COMMANDER_CONFIG }),
+        updateConfig: vi.fn(),
+    };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('Commander Routes', () => {
+    function createApp() {
+        const agent = createMockCommanderAgent();
+        const routes = createCommanderRoutes(agent);
+        const app = new Hono();
+        app.route('/', routes);
+        return { app, agent };
+    }
+    // --- test_commander_routes_start ---
+    describe('POST /api/commander/start', () => {
+        it('calls commanderAgent.start() and returns state', async () => {
+            const { app, agent } = createApp();
+            const res = await app.request('/api/commander/start', { method: 'POST' });
+            const body = await res.json();
+            expect(res.status).toBe(200);
+            expect(body.ok).toBe(true);
+            expect(body.state).toBeDefined();
+            expect(agent.start).toHaveBeenCalledOnce();
+        });
+        it('returns 500 on start failure', async () => {
+            const { app, agent } = createApp();
+            agent.start.mockRejectedValueOnce(new Error('Config load failed'));
+            const res = await app.request('/api/commander/start', { method: 'POST' });
+            const body = await res.json();
+            expect(res.status).toBe(500);
+            expect(body.error).toBe('Config load failed');
+        });
+    });
+    // --- POST /api/commander/stop ---
+    describe('POST /api/commander/stop', () => {
+        it('calls commanderAgent.stop() and returns ok', async () => {
+            const { app, agent } = createApp();
+            const res = await app.request('/api/commander/stop', { method: 'POST' });
+            const body = await res.json();
+            expect(res.status).toBe(200);
+            expect(body.ok).toBe(true);
+            expect(agent.stop).toHaveBeenCalledOnce();
+        });
+    });
+    // --- POST /api/commander/pause ---
+    describe('POST /api/commander/pause', () => {
+        it('calls pause when not paused', async () => {
+            const { app, agent } = createApp();
+            const res = await app.request('/api/commander/pause', { method: 'POST' });
+            const body = await res.json();
+            expect(res.status).toBe(200);
+            expect(body.ok).toBe(true);
+            expect(agent.pause).toHaveBeenCalledOnce();
+        });
+        it('calls resume when paused', async () => {
+            const { app, agent } = createApp();
+            agent.getState.mockReturnValueOnce({
+                status: 'paused',
+                lastTickAt: '',
+                lastDecision: null,
+                activeWorkers: 0,
+                sessionId: 'test',
+                tickCount: 0,
+            });
+            const res = await app.request('/api/commander/pause', { method: 'POST' });
+            const body = await res.json();
+            expect(res.status).toBe(200);
+            expect(agent.resume).toHaveBeenCalledOnce();
+        });
+    });
+    // --- test_commander_routes_status ---
+    describe('GET /api/commander/status', () => {
+        it('returns current state', async () => {
+            const { app } = createApp();
+            const res = await app.request('/api/commander/status');
+            const body = await res.json();
+            expect(res.status).toBe(200);
+            expect(body.status).toBe('idle');
+            expect(body.sessionId).toBe('test-session');
+            expect(body.tickCount).toBe(0);
+        });
+    });
+    // --- test_commander_routes_config_update ---
+    describe('PUT /api/commander/config', () => {
+        it('updates config and returns updated config', async () => {
+            const { app, agent } = createApp();
+            const res = await app.request('/api/commander/config', {
+                method: 'PUT',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ maxConcurrentWorkers: 5 }),
+            });
+            const body = await res.json();
+            expect(res.status).toBe(200);
+            expect(body.ok).toBe(true);
+            expect(body.config).toBeDefined();
+            expect(agent.updateConfig).toHaveBeenCalledWith({ maxConcurrentWorkers: 5 });
+        });
+        it('returns 500 on invalid body', async () => {
+            const { app } = createApp();
+            const res = await app.request('/api/commander/config', {
+                method: 'PUT',
+                headers: { 'Content-Type': 'application/json' },
+                body: 'invalid json{{{',
+            });
+            expect(res.status).toBe(500);
+        });
+    });
+    // --- POST /api/commander/stop error handling ---
+    describe('POST /api/commander/stop — error paths', () => {
+        it('returns 500 when stop throws', async () => {
+            const { app, agent } = createApp();
+            agent.stop.mockImplementationOnce(() => {
+                throw new Error('Timer cleanup failed');
+            });
+            const res = await app.request('/api/commander/stop', { method: 'POST' });
+            const body = await res.json();
+            expect(res.status).toBe(500);
+            expect(body.error).toBe('Timer cleanup failed');
+        });
+    });
+    // --- POST /api/commander/pause error handling ---
+    describe('POST /api/commander/pause — error paths', () => {
+        it('returns 500 when pause throws', async () => {
+            const { app, agent } = createApp();
+            agent.pause.mockImplementationOnce(() => {
+                throw new Error('Cannot pause in current state');
+            });
+            const res = await app.request('/api/commander/pause', { method: 'POST' });
+            const body = await res.json();
+            expect(res.status).toBe(500);
+            expect(body.error).toBe('Cannot pause in current state');
+        });
+        it('returns 500 when resume throws', async () => {
+            const { app, agent } = createApp();
+            agent.getState.mockReturnValueOnce({
+                status: 'paused',
+                lastTickAt: '',
+                lastDecision: null,
+                activeWorkers: 0,
+                sessionId: 'test',
+                tickCount: 0,
+            });
+            agent.resume.mockImplementationOnce(() => {
+                throw new Error('Resume failed');
+            });
+            const res = await app.request('/api/commander/pause', { method: 'POST' });
+            const body = await res.json();
+            expect(res.status).toBe(500);
+            expect(body.error).toBe('Resume failed');
+        });
+    });
+});
+//# sourceMappingURL=commander-routes.test.js.map

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

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

package/dashboard/dist-server/server/config.d.ts

@@ -0,0 +1,28 @@
+import type { AgentType } from '../shared/agent-types.js';
+export interface DashboardConfig {
+    port: number;
+    host: string;
+    debounce_ms: number;
+    polling_fallback: boolean;
+    heartbeat_interval_ms: number;
+    max_connections: number;
+    workflow_root: string;
+}
+/**
+ * Load dashboard configuration from .workflow/config.json `dashboard` section.
+ * Falls back to defaults when file is missing or section is absent.
+ */
+export declare function loadConfig(cwd?: string): Promise<DashboardConfig>;
+export interface SavedAgentSettings {
+    model?: string;
+    approvalMode?: 'suggest' | 'auto';
+    baseUrl?: string;
+    apiKey?: string;
+    settingsFile?: string;
+    envFile?: string;
+}
+/**
+ * Load saved agent settings from `.workflow/config.json` → `settings.agents[type]`.
+ * Returns undefined if file is missing or agent type has no saved settings.
+ */
+export declare function loadDashboardAgentSettings(workflowRoot: string, agentType: AgentType): Promise<SavedAgentSettings | undefined>;

package/dashboard/dist-server/server/config.js

@@ -0,0 +1,67 @@
+import { readFile } from 'node:fs/promises';
+import { resolve, join } from 'node:path';
+const DEFAULT_CONFIG = {
+    port: 3001,
+    host: '127.0.0.1',
+    debounce_ms: 150,
+    polling_fallback: false,
+    heartbeat_interval_ms: 30_000,
+    max_connections: 10,
+    // The dashboard lives in dashboard/ so the project .workflow is one level up.
+    // Override via WORKFLOW_ROOT env var or dashboard.workflow_root in config.json.
+    workflow_root: '../.workflow',
+};
+/**
+ * Load dashboard configuration from .workflow/config.json `dashboard` section.
+ * Falls back to defaults when file is missing or section is absent.
+ */
+export async function loadConfig(cwd = process.cwd()) {
+    const configPath = resolve(cwd, '.workflow', 'config.json');
+    try {
+        const raw = await readFile(configPath, 'utf-8');
+        const json = JSON.parse(raw);
+        const section = (json['dashboard'] ?? {});
+        return applyEnvOverrides({ ...DEFAULT_CONFIG, ...section });
+    }
+    catch {
+        // Config file missing or unreadable — use defaults
+        return applyEnvOverrides({ ...DEFAULT_CONFIG });
+    }
+}
+/**
+ * Load saved agent settings from `.workflow/config.json` → `settings.agents[type]`.
+ * Returns undefined if file is missing or agent type has no saved settings.
+ */
+export async function loadDashboardAgentSettings(workflowRoot, agentType) {
+    const configPath = join(workflowRoot, 'config.json');
+    try {
+        const raw = await readFile(configPath, 'utf-8');
+        const json = JSON.parse(raw);
+        const settings = json['settings'];
+        if (!settings)
+            return undefined;
+        const agents = settings['agents'];
+        if (!agents)
+            return undefined;
+        return agents[agentType] ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Environment variable overrides for CLI integration (e.g. `maestro view --port`). */
+function applyEnvOverrides(config) {
+    if (process.env.PORT) {
+        const p = parseInt(process.env.PORT, 10);
+        if (!isNaN(p))
+            config.port = p;
+    }
+    if (process.env.HOST) {
+        config.host = process.env.HOST;
+    }
+    if (process.env.WORKFLOW_ROOT) {
+        config.workflow_root = process.env.WORKFLOW_ROOT;
+    }
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dashboard/dist-server/server/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/server/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAiB1C,MAAM,cAAc,GAAoB;IACtC,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,GAAG;IAChB,gBAAgB,EAAE,KAAK;IACvB,qBAAqB,EAAE,MAAM;IAC7B,eAAe,EAAE,EAAE;IACnB,8EAA8E;IAC9E,gFAAgF;IAChF,aAAa,EAAE,cAAc;CAC9B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC1D,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;IAE5D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;QACxD,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAA6B,CAAC;QAEtE,OAAO,iBAAiB,CAAC,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,mDAAmD;QACnD,OAAO,iBAAiB,CAAC,EAAE,GAAG,cAAc,EAAE,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AAeD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,YAAoB,EACpB,SAAoB;IAEpB,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;QACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAwC,CAAC;QACzE,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAmD,CAAC;QACpF,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,uFAAuF;AACvF,SAAS,iBAAiB,CAAC,MAAuB;IAChD,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;IACjC,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;QAC9B,MAAM,CAAC,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dashboard/dist-server/server/coordinator/agents/intent-classifier-agent.d.ts

@@ -0,0 +1,5 @@
+import type { ClassifiedIntent, WorkflowSnapshot } from '../types.js';
+export declare class IntentClassifierAgent {
+    classify(intent: string, snapshot: WorkflowSnapshot): Promise<ClassifiedIntent>;
+    private fallbackClassify;
+}

package/dashboard/dist-server/server/coordinator/agents/intent-classifier-agent.js

@@ -0,0 +1,97 @@
+// ---------------------------------------------------------------------------
+// IntentClassifierAgent — LLM-based intent classification with regex fallback
+// ---------------------------------------------------------------------------
+import { query } from '@anthropic-ai/claude-agent-sdk';
+import { CHAIN_MAP, TASK_TO_CHAIN, detectTaskType } from '../chain-map.js';
+import { loadPrompt } from '../prompts/index.js';
+// ---------------------------------------------------------------------------
+// JSON extraction helper
+// ---------------------------------------------------------------------------
+function extractJson(text) {
+    const fenced = text.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/i);
+    if (fenced)
+        return fenced[1].trim();
+    const first = text.indexOf('{');
+    const last = text.lastIndexOf('}');
+    if (first !== -1 && last > first)
+        return text.slice(first, last + 1);
+    const trimmed = text.trim();
+    if (trimmed.startsWith('{'))
+        return trimmed;
+    return null;
+}
+// ---------------------------------------------------------------------------
+// IntentClassifierAgent
+// ---------------------------------------------------------------------------
+export class IntentClassifierAgent {
+    async classify(intent, snapshot) {
+        try {
+            const systemPrompt = await loadPrompt('intent-classifier');
+            const chainNames = Object.keys(CHAIN_MAP).join(', ');
+            const userPrompt = `Classify this intent and select the best command chain.
+
+Intent: "${intent}"
+
+Current State:
+${JSON.stringify(snapshot, null, 2)}
+
+Available chain names: ${chainNames}`;
+            let resultText = '';
+            for await (const message of query({
+                prompt: userPrompt,
+                options: {
+                    systemPrompt,
+                    tools: [],
+                    allowedTools: [],
+                    permissionMode: 'dontAsk',
+                    maxTurns: 3,
+                    persistSession: false,
+                },
+            })) {
+                const msg = message;
+                if (msg.type === 'result' && msg.subtype === 'success') {
+                    resultText = message.result;
+                }
+            }
+            if (!resultText) {
+                return this.fallbackClassify(intent);
+            }
+            const jsonStr = extractJson(resultText);
+            if (!jsonStr) {
+                return this.fallbackClassify(intent);
+            }
+            const parsed = JSON.parse(jsonStr);
+            // Validate chainName exists
+            if (!CHAIN_MAP[parsed.chainName]) {
+                console.warn(`[IntentClassifierAgent] Invalid chainName "${parsed.chainName}", falling back`);
+                return this.fallbackClassify(intent);
+            }
+            // Ensure steps match chain map
+            parsed.steps = CHAIN_MAP[parsed.chainName].map(def => ({
+                cmd: def.cmd,
+                args: def.args ?? '',
+            }));
+            return parsed;
+        }
+        catch (err) {
+            console.error('[IntentClassifierAgent] Classification failed:', err instanceof Error ? err.message : String(err));
+            return this.fallbackClassify(intent);
+        }
+    }
+    fallbackClassify(intent) {
+        const taskType = detectTaskType(intent);
+        const chainName = TASK_TO_CHAIN[taskType] ?? taskType;
+        const chain = CHAIN_MAP[chainName] ?? CHAIN_MAP['quick'];
+        const resolvedChainName = CHAIN_MAP[chainName] ? chainName : 'quick';
+        return {
+            taskType,
+            confidence: 0.6,
+            chainName: resolvedChainName,
+            steps: chain.map(def => ({ cmd: def.cmd, args: def.args ?? '' })),
+            reasoning: `Regex fallback: matched pattern "${taskType}"`,
+            clarificationNeeded: false,
+            clarificationQuestion: null,
+        };
+    }
+}
+//# sourceMappingURL=intent-classifier-agent.js.map

package/dashboard/dist-server/server/coordinator/agents/intent-classifier-agent.js.map

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

package/dashboard/dist-server/server/coordinator/agents/quality-reviewer-agent.d.ts

@@ -0,0 +1,5 @@
+import type { CoordinateStep } from '../../../shared/coordinate-types.js';
+import type { StepAnalysis } from '../types.js';
+export declare class QualityReviewerAgent {
+    review(step: CoordinateStep, output: string): Promise<StepAnalysis>;
+}

package/dashboard/dist-server/server/coordinator/agents/quality-reviewer-agent.js

@@ -0,0 +1,86 @@
+// ---------------------------------------------------------------------------
+// QualityReviewerAgent — evaluates step output quality with LLM
+// ---------------------------------------------------------------------------
+import { query } from '@anthropic-ai/claude-agent-sdk';
+import { loadPrompt } from '../prompts/index.js';
+// ---------------------------------------------------------------------------
+// JSON extraction helper
+// ---------------------------------------------------------------------------
+function extractJson(text) {
+    const fenced = text.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/i);
+    if (fenced)
+        return fenced[1].trim();
+    const first = text.indexOf('{');
+    const last = text.lastIndexOf('}');
+    if (first !== -1 && last > first)
+        return text.slice(first, last + 1);
+    const trimmed = text.trim();
+    if (trimmed.startsWith('{'))
+        return trimmed;
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Default analysis for fallback
+// ---------------------------------------------------------------------------
+const DEFAULT_ANALYSIS = {
+    qualityScore: 50,
+    executionAssessment: 'Unable to analyze step output',
+    issues: [],
+    nextStepHints: '',
+    stepSummary: 'Step completed',
+};
+// ---------------------------------------------------------------------------
+// QualityReviewerAgent
+// ---------------------------------------------------------------------------
+export class QualityReviewerAgent {
+    async review(step, output) {
+        try {
+            const systemPrompt = await loadPrompt('quality-reviewer');
+            // Truncate output to last 200 lines
+            const lines = output.split('\n');
+            const truncated = lines.length > 200
+                ? `[...truncated ${lines.length - 200} lines...]\n${lines.slice(-200).join('\n')}`
+                : output;
+            const userPrompt = `Evaluate this completed workflow step:
+
+Step ${step.index + 1}: ${step.cmd} ${step.args}
+Status: ${step.status}
+
+Output:
+${truncated}`;
+            let resultText = '';
+            for await (const message of query({
+                prompt: userPrompt,
+                options: {
+                    systemPrompt,
+                    tools: [],
+                    allowedTools: [],
+                    permissionMode: 'dontAsk',
+                    maxTurns: 3,
+                    persistSession: false,
+                },
+            })) {
+                const msg = message;
+                if (msg.type === 'result' && msg.subtype === 'success') {
+                    resultText = message.result;
+                }
+            }
+            if (!resultText) {
+                return { ...DEFAULT_ANALYSIS };
+            }
+            const jsonStr = extractJson(resultText);
+            if (!jsonStr) {
+                return { ...DEFAULT_ANALYSIS };
+            }
+            const parsed = JSON.parse(jsonStr);
+            // Clamp quality score
+            parsed.qualityScore = Math.max(0, Math.min(100, Math.round(parsed.qualityScore)));
+            return parsed;
+        }
+        catch (err) {
+            console.error('[QualityReviewerAgent] Review failed:', err instanceof Error ? err.message : String(err));
+            return { ...DEFAULT_ANALYSIS };
+        }
+    }
+}
+//# sourceMappingURL=quality-reviewer-agent.js.map

package/dashboard/dist-server/server/coordinator/agents/quality-reviewer-agent.js.map

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

package/dashboard/dist-server/server/coordinator/agents/state-analyzer-agent.d.ts

@@ -0,0 +1,10 @@
+import type { StateManager } from '../../state/state-manager.js';
+import type { DashboardEventBus } from '../../state/event-bus.js';
+import type { WorkflowSnapshot } from '../types.js';
+export declare class StateAnalyzerAgent {
+    private readonly stateManager;
+    private readonly eventBus?;
+    private readonly mcpServer;
+    constructor(stateManager: StateManager, workflowRoot: string, eventBus?: DashboardEventBus | undefined);
+    analyze(): Promise<WorkflowSnapshot>;
+}

package/dashboard/dist-server/server/coordinator/agents/state-analyzer-agent.js

@@ -0,0 +1,112 @@
+// ---------------------------------------------------------------------------
+// StateAnalyzerAgent — uses SDK query() with MCP tools to analyze workflow state
+// ---------------------------------------------------------------------------
+import { query } from '@anthropic-ai/claude-agent-sdk';
+import { loadPrompt } from '../prompts/index.js';
+import { createWorkflowMcpServer } from '../tools/workflow-mcp-server.js';
+// ---------------------------------------------------------------------------
+// JSON extraction helper (same pattern as requirement-expander.ts)
+// ---------------------------------------------------------------------------
+function extractJson(text) {
+    const fenced = text.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/i);
+    if (fenced)
+        return fenced[1].trim();
+    const first = text.indexOf('{');
+    const last = text.lastIndexOf('}');
+    if (first !== -1 && last > first)
+        return text.slice(first, last + 1);
+    const trimmed = text.trim();
+    if (trimmed.startsWith('{'))
+        return trimmed;
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Default snapshot for when analysis fails
+// ---------------------------------------------------------------------------
+const DEFAULT_SNAPSHOT = {
+    initialized: false,
+    currentPhase: 0,
+    phaseStatus: 'pending',
+    artifacts: { brainstorm: false, analysis: false, context: false, plan: false, verification: false, uat: false },
+    execution: { tasksCompleted: 0, tasksTotal: 0 },
+    verification: 'not_started',
+    uat: 'not_started',
+    phasesTotal: 0,
+    phasesCompleted: 0,
+    hasBlockers: false,
+    accumulatedContext: [],
+    progressSummary: 'Unable to analyze workflow state',
+    suggestedNextAction: 'init',
+    readiness: 'unknown',
+};
+// ---------------------------------------------------------------------------
+// StateAnalyzerAgent
+// ---------------------------------------------------------------------------
+export class StateAnalyzerAgent {
+    stateManager;
+    eventBus;
+    mcpServer;
+    constructor(stateManager, workflowRoot, eventBus) {
+        this.stateManager = stateManager;
+        this.eventBus = eventBus;
+        this.mcpServer = createWorkflowMcpServer(stateManager, workflowRoot);
+    }
+    async analyze() {
+        try {
+            const systemPrompt = await loadPrompt('state-analyzer');
+            const project = this.stateManager.getProject();
+            const userPrompt = `Analyze the current workflow state. Project: ${project.project_name || 'unknown'}, current phase: ${project.current_phase ?? 'none'}, status: ${project.status || 'unknown'}. Use the MCP tools to gather detailed state information.`;
+            let resultText = '';
+            let inputTokens = 0;
+            let outputTokens = 0;
+            const start = Date.now();
+            for await (const message of query({
+                prompt: userPrompt,
+                options: {
+                    systemPrompt,
+                    tools: [],
+                    allowedTools: [],
+                    permissionMode: 'dontAsk',
+                    mcpServers: { 'workflow-state': this.mcpServer },
+                    maxTurns: 5,
+                    persistSession: false,
+                },
+            })) {
+                const msg = message;
+                if (msg.type === 'result' && msg.subtype === 'success') {
+                    resultText = message.result;
+                    // Extract token usage from SDK response if available
+                    const usage = message.usage;
+                    if (usage) {
+                        inputTokens = usage.input_tokens ?? 0;
+                        outputTokens = usage.output_tokens ?? 0;
+                    }
+                }
+            }
+            const latencyMs = Date.now() - start;
+            // Emit SDK token/latency metrics
+            if (this.eventBus) {
+                this.eventBus.emit('coordinate:analyze_metrics', {
+                    input_tokens: inputTokens,
+                    output_tokens: outputTokens,
+                    latency_ms: latencyMs,
+                });
+            }
+            if (!resultText) {
+                console.warn('[StateAnalyzerAgent] Empty result, returning default snapshot');
+                return { ...DEFAULT_SNAPSHOT };
+            }
+            const jsonStr = extractJson(resultText);
+            if (!jsonStr) {
+                console.warn('[StateAnalyzerAgent] Could not extract JSON from result');
+                return { ...DEFAULT_SNAPSHOT };
+            }
+            return JSON.parse(jsonStr);
+        }
+        catch (err) {
+            console.error('[StateAnalyzerAgent] Analysis failed:', err instanceof Error ? err.message : String(err));
+            return { ...DEFAULT_SNAPSHOT };
+        }
+    }
+}
+//# sourceMappingURL=state-analyzer-agent.js.map

package/dashboard/dist-server/server/coordinator/agents/state-analyzer-agent.js.map

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