maestro-flow 0.1.4 → 0.2.1

package/dashboard/dist-server/src/server/coordinator/dashboard-executor.js

@@ -0,0 +1,98 @@
+// ---------------------------------------------------------------------------
+// DashboardExecutor — CommandExecutor implementation for the Dashboard.
+// Bridges the Graph Coordinator's ExecuteRequest/ExecuteResult interface
+// to the Dashboard's AgentManager spawn/stop lifecycle.
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// DashboardExecutor
+// ---------------------------------------------------------------------------
+export class DashboardExecutor {
+    agentManager;
+    eventBus;
+    activeProcessId = null;
+    constructor(agentManager, eventBus) {
+        this.agentManager = agentManager;
+        this.eventBus = eventBus;
+    }
+    async execute(request) {
+        const startTime = Date.now();
+        try {
+            const agentType = request.agent_type;
+            const proc = await this.agentManager.spawn(agentType, {
+                type: agentType,
+                prompt: request.prompt,
+                workDir: request.work_dir,
+                approvalMode: request.approval_mode,
+            });
+            this.activeProcessId = proc.id;
+            // Wait for the agent to stop (completed or errored)
+            const reason = await this.waitForStopped(proc.id, request.timeout_ms);
+            this.activeProcessId = null;
+            const output = this.collectOutput(proc.id);
+            const durationMs = Date.now() - startTime;
+            return {
+                success: !reason?.startsWith('error'),
+                raw_output: output,
+                exec_id: proc.id,
+                duration_ms: durationMs,
+                process_id: proc.id,
+            };
+        }
+        catch (err) {
+            this.activeProcessId = null;
+            return {
+                success: false,
+                raw_output: err instanceof Error ? err.message : String(err),
+                exec_id: '',
+                duration_ms: Date.now() - startTime,
+            };
+        }
+    }
+    async abort() {
+        if (!this.activeProcessId)
+            return;
+        try {
+            await this.agentManager.stop(this.activeProcessId);
+        }
+        catch { /* Agent may have already stopped */ }
+        this.activeProcessId = null;
+    }
+    // -------------------------------------------------------------------------
+    // Internals
+    // -------------------------------------------------------------------------
+    waitForStopped(processId, timeoutMs) {
+        return new Promise((resolve, reject) => {
+            let timer = null;
+            const handler = (event) => {
+                const payload = event.data;
+                if (payload.processId !== processId)
+                    return;
+                cleanup();
+                resolve(payload.reason);
+            };
+            const cleanup = () => {
+                this.eventBus.off('agent:stopped', handler);
+                if (timer)
+                    clearTimeout(timer);
+            };
+            this.eventBus.on('agent:stopped', handler);
+            timer = setTimeout(() => {
+                cleanup();
+                reject(new Error(`Agent timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+        });
+    }
+    collectOutput(processId) {
+        const entries = this.agentManager.getEntries(processId);
+        const parts = [];
+        for (const entry of entries) {
+            if (entry.type === 'assistant_message') {
+                const msg = entry;
+                parts.push(msg.content ?? msg.message ?? '');
+            }
+        }
+        const joined = parts.join('\n');
+        return joined.length > 50_000 ? joined.slice(-50_000) : joined;
+    }
+}
+//# sourceMappingURL=dashboard-executor.js.map

package/dashboard/dist-server/src/server/coordinator/dashboard-executor.js.map

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

package/dashboard/dist-server/src/server/coordinator/dashboard-step-analyzer.d.ts

@@ -0,0 +1,7 @@
+import type { CommandNode, WalkerContext, AssembleRequest, AnalysisResult, StepAnalyzer } from '../../../../src/coordinator/graph-types.js';
+import type { QualityReviewerAgent } from './agents/quality-reviewer-agent.js';
+export declare class DashboardStepAnalyzer implements StepAnalyzer {
+    private readonly qualityReviewer;
+    constructor(qualityReviewer: QualityReviewerAgent);
+    analyze(node: CommandNode, rawOutput: string, _ctx: WalkerContext, _prevCmd?: AssembleRequest['previous_command']): Promise<AnalysisResult>;
+}

package/dashboard/dist-server/src/server/coordinator/dashboard-step-analyzer.js

@@ -0,0 +1,34 @@
+// ---------------------------------------------------------------------------
+// DashboardStepAnalyzer -- thin adapter: StepAnalyzer → QualityReviewerAgent
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// DashboardStepAnalyzer
+// ---------------------------------------------------------------------------
+export class DashboardStepAnalyzer {
+    qualityReviewer;
+    constructor(qualityReviewer) {
+        this.qualityReviewer = qualityReviewer;
+    }
+    async analyze(node, rawOutput, _ctx, _prevCmd) {
+        // Convert CommandNode → CoordinateStep for QualityReviewerAgent
+        const step = {
+            index: 0,
+            cmd: node.cmd,
+            args: node.args ?? '',
+            status: 'completed',
+            processId: null,
+            analysis: null,
+            summary: null,
+        };
+        const analysis = await this.qualityReviewer.review(step, rawOutput);
+        // Convert StepAnalysis (camelCase) → AnalysisResult (snake_case)
+        return {
+            quality_score: analysis.qualityScore,
+            issues: analysis.issues,
+            next_step_hints: {
+                prompt_additions: analysis.nextStepHints || undefined,
+            },
+        };
+    }
+}
+//# sourceMappingURL=dashboard-step-analyzer.js.map

package/dashboard/dist-server/src/server/coordinator/dashboard-step-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-step-analyzer.js","sourceRoot":"","sources":["../../../../src/server/coordinator/dashboard-step-analyzer.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6EAA6E;AAC7E,8EAA8E;AAM9E,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,MAAM,OAAO,qBAAqB;IACH;IAA7B,YAA6B,eAAqC;QAArC,oBAAe,GAAf,eAAe,CAAsB;IAAG,CAAC;IAEtE,KAAK,CAAC,OAAO,CACX,IAAiB,EACjB,SAAiB,EACjB,IAAmB,EACnB,QAA8C;QAE9C,gEAAgE;QAChE,MAAM,IAAI,GAAmB;YAC3B,KAAK,EAAE,CAAC;YACR,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;YACrB,MAAM,EAAE,WAAW;YACnB,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,IAAI;SACd,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAEpE,iEAAiE;QACjE,OAAO;YACL,aAAa,EAAE,QAAQ,CAAC,YAAY;YACpC,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,eAAe,EAAE;gBACf,gBAAgB,EAAE,QAAQ,CAAC,aAAa,IAAI,SAAS;aACtD;SACF,CAAC;IACJ,CAAC;CACF"}

package/dashboard/dist-server/src/server/coordinator/graph-walker-factory.d.ts

@@ -0,0 +1,22 @@
+import type { WalkerEventEmitter, StepAnalyzer } from '../../../../src/coordinator/graph-types.js';
+import type { AgentManager } from '../agents/agent-manager.js';
+import type { DashboardEventBus } from '../state/event-bus.js';
+export interface GraphWalkerCreateConfig {
+    agentManager: AgentManager;
+    eventBus: DashboardEventBus;
+    workDir: string;
+    emitter: WalkerEventEmitter;
+    analyzer: StepAnalyzer | null;
+    sessionDir: string;
+}
+export declare class GraphWalkerFactory {
+    private infraPromise;
+    /** Cache ALL dynamic imports in a single promise on first access */
+    private ensureInfra;
+    /** Create a fully-wired GraphWalker + IntentRouter + DashboardExecutor */
+    create(config: GraphWalkerCreateConfig): Promise<{
+        walker: InstanceType<any>;
+        router: InstanceType<any>;
+        executor: InstanceType<any>;
+    }>;
+}

package/dashboard/dist-server/src/server/coordinator/graph-walker-factory.js

@@ -0,0 +1,53 @@
+// ---------------------------------------------------------------------------
+// GraphWalkerFactory -- cached dynamic imports + create(config) for GraphWalker
+// ---------------------------------------------------------------------------
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+// ---------------------------------------------------------------------------
+// GraphWalkerFactory
+// ---------------------------------------------------------------------------
+export class GraphWalkerFactory {
+    infraPromise = null;
+    /** Cache ALL dynamic imports in a single promise on first access */
+    ensureInfra() {
+        if (!this.infraPromise) {
+            this.infraPromise = Promise.all([
+                import('../../../../src/coordinator/graph-walker.js'),
+                import('../../../../src/coordinator/graph-loader.js'),
+                import('../../../../src/coordinator/expr-evaluator.js'),
+                import('../../../../src/coordinator/output-parser.js'),
+                import('../../../../src/coordinator/prompt-assembler.js'),
+                import('./dashboard-executor.js'),
+                import('../../../../src/coordinator/intent-router.js'),
+                import('node:os'),
+            ]).then(([gw, gl, ee, op, pa, de, ir, os]) => ({
+                GraphWalker: gw.GraphWalker,
+                GraphLoader: gl.GraphLoader,
+                DefaultExprEvaluator: ee.DefaultExprEvaluator,
+                DefaultOutputParser: op.DefaultOutputParser,
+                DefaultPromptAssembler: pa.DefaultPromptAssembler,
+                DashboardExecutor: de.DashboardExecutor,
+                IntentRouter: ir.IntentRouter,
+                homedir: os.homedir,
+            }));
+        }
+        return this.infraPromise;
+    }
+    /** Create a fully-wired GraphWalker + IntentRouter + DashboardExecutor */
+    async create(config) {
+        const infra = await this.ensureInfra();
+        const globalChainsRoot = resolve(infra.homedir(), '.maestro', 'chains');
+        const localChainsRoot = resolve(config.workDir, 'chains');
+        const chainsRoot = existsSync(localChainsRoot) ? localChainsRoot : globalChainsRoot;
+        const templateDir = resolve(infra.homedir(), '.maestro', 'templates', 'cli', 'prompts');
+        const loader = new infra.GraphLoader(chainsRoot);
+        const executor = new infra.DashboardExecutor(config.agentManager, config.eventBus);
+        const assembler = new infra.DefaultPromptAssembler(config.workDir, templateDir);
+        const evaluator = new infra.DefaultExprEvaluator();
+        const parser = new infra.DefaultOutputParser();
+        const router = new infra.IntentRouter(loader, chainsRoot);
+        const walker = new infra.GraphWalker(loader, assembler, executor, config.analyzer, parser, evaluator, config.emitter, config.sessionDir);
+        return { walker, router, executor };
+    }
+}
+//# sourceMappingURL=graph-walker-factory.js.map

package/dashboard/dist-server/src/server/coordinator/graph-walker-factory.js.map

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

package/dashboard/dist-server/src/server/coordinator/prompts/index.d.ts

@@ -0,0 +1,18 @@
+/** Configure the user-customizable prompts directory */
+export declare function setPromptsDir(workflowRoot: string): void;
+/** Clear cached prompts (useful after user edits override files) */
+export declare function clearPromptCache(): void;
+/**
+ * Load a prompt template by name.
+ * Checks {workflowRoot}/coordinator/prompts/{name}.md first,
+ * then falls back to the built-in default.
+ */
+export declare function loadPrompt(name: string): Promise<string>;
+/**
+ * List available prompt names from both user and built-in directories.
+ * Returns deduplicated names (without .md extension).
+ */
+export declare function listPrompts(): Promise<{
+    name: string;
+    source: 'user' | 'builtin';
+}[]>;

package/dashboard/dist-server/src/server/coordinator/prompts/index.js

@@ -0,0 +1,82 @@
+// ---------------------------------------------------------------------------
+// Prompt loader — manages built-in + user-customized prompt templates
+//
+// Directory structure:
+//   Built-in (fallback):  <compiled>/coordinator/prompts/{name}.md
+//   User override:        {workflowRoot}/coordinator/prompts/{name}.md
+//
+// Resolution: user override → built-in default
+// Cache is per-process; restart dashboard to pick up changes.
+// ---------------------------------------------------------------------------
+import { readFile, readdir } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const cache = new Map();
+let _userPromptsDir = null;
+/** Configure the user-customizable prompts directory */
+export function setPromptsDir(workflowRoot) {
+    _userPromptsDir = join(workflowRoot, 'coordinator', 'prompts');
+}
+/** Clear cached prompts (useful after user edits override files) */
+export function clearPromptCache() {
+    cache.clear();
+}
+/**
+ * Load a prompt template by name.
+ * Checks {workflowRoot}/coordinator/prompts/{name}.md first,
+ * then falls back to the built-in default.
+ */
+export async function loadPrompt(name) {
+    if (cache.has(name))
+        return cache.get(name);
+    // Try user override
+    if (_userPromptsDir) {
+        try {
+            const content = await readFile(join(_userPromptsDir, `${name}.md`), 'utf-8');
+            cache.set(name, content);
+            return content;
+        }
+        catch {
+            // Not found — fall through to built-in
+        }
+    }
+    // Built-in default
+    const content = await readFile(join(__dirname, `${name}.md`), 'utf-8');
+    cache.set(name, content);
+    return content;
+}
+/**
+ * List available prompt names from both user and built-in directories.
+ * Returns deduplicated names (without .md extension).
+ */
+export async function listPrompts() {
+    const results = new Map();
+    // User prompts first (higher priority)
+    if (_userPromptsDir) {
+        try {
+            const files = await readdir(_userPromptsDir);
+            for (const f of files) {
+                if (f.endsWith('.md'))
+                    results.set(f.replace(/\.md$/, ''), 'user');
+            }
+        }
+        catch {
+            // Directory doesn't exist
+        }
+    }
+    // Built-in prompts (only add if not already overridden)
+    try {
+        const files = await readdir(__dirname);
+        for (const f of files) {
+            if (f.endsWith('.md') && !results.has(f.replace(/\.md$/, ''))) {
+                results.set(f.replace(/\.md$/, ''), 'builtin');
+            }
+        }
+    }
+    catch {
+        // Should not happen
+    }
+    return Array.from(results.entries()).map(([name, source]) => ({ name, source }));
+}
+//# sourceMappingURL=index.js.map

package/dashboard/dist-server/src/server/coordinator/prompts/index.js.map

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

package/dashboard/dist-server/src/server/coordinator/tools/workflow-mcp-server.d.ts

@@ -0,0 +1,3 @@
+import type { McpSdkServerConfigWithInstance } from '@anthropic-ai/claude-agent-sdk';
+import type { StateManager } from '../../state/state-manager.js';
+export declare function createWorkflowMcpServer(stateManager: StateManager, workflowRoot: string): McpSdkServerConfigWithInstance;

package/dashboard/dist-server/src/server/coordinator/tools/workflow-mcp-server.js

@@ -0,0 +1,109 @@
+// ---------------------------------------------------------------------------
+// Workflow MCP Server — SDK in-process MCP server for workflow state access
+// ---------------------------------------------------------------------------
+// Provides get_project_state, get_phase_state, check_artifacts, list_phase_tasks
+// tools to Agent SDK queries (injected via options.mcpServers).
+// ---------------------------------------------------------------------------
+import { join } from 'node:path';
+import { readdir, stat } from 'node:fs/promises';
+import { z } from 'zod';
+import { tool, createSdkMcpServer } from '@anthropic-ai/claude-agent-sdk';
+// ---------------------------------------------------------------------------
+// Tool definitions
+// ---------------------------------------------------------------------------
+function buildTools(stateManager, workflowRoot) {
+    const getProjectStateTool = tool('get_project_state', 'Get project-level state including current phase, status, phases summary, and accumulated context.', {}, async () => {
+        const project = stateManager.getProject();
+        return { content: [{ type: 'text', text: JSON.stringify(project, null, 2) }] };
+    });
+    const getPhaseStateTool = tool('get_phase_state', 'Get detailed state for a specific phase including status, plan, execution progress, verification, and validation.', { phase: z.number().describe('Phase number (e.g. 1, 2, 3)') }, async (args) => {
+        const phase = stateManager.getPhase(args.phase);
+        if (!phase) {
+            return { content: [{ type: 'text', text: JSON.stringify({ error: `Phase ${args.phase} not found` }) }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(phase, null, 2) }] };
+    });
+    const checkArtifactsTool = tool('check_artifacts', 'Check which workflow artifacts exist in a phase directory (brainstorm.md, analysis.md, context.md, plan-overview.json, tasks, verification, uat).', { phase: z.number().describe('Phase number to check artifacts for') }, async (args) => {
+        const phaseDir = await findPhaseDir(workflowRoot, args.phase);
+        if (!phaseDir) {
+            return { content: [{ type: 'text', text: JSON.stringify({ error: `Phase ${args.phase} directory not found` }) }], isError: true };
+        }
+        const artifacts = {
+            brainstorm: false,
+            analysis: false,
+            context: false,
+            plan: false,
+            verification: false,
+            uat: false,
+        };
+        const checks = [
+            ['brainstorm', 'brainstorm.md'],
+            ['analysis', 'analysis.md'],
+            ['context', 'context.md'],
+            ['plan', 'plan-overview.json'],
+        ];
+        for (const [key, file] of checks) {
+            artifacts[key] = await fileExists(join(phaseDir, file));
+        }
+        // Check for task files
+        const taskDir = join(phaseDir, '.task');
+        if (await fileExists(taskDir)) {
+            try {
+                const files = await readdir(taskDir);
+                artifacts.plan = artifacts.plan || files.some(f => f.startsWith('TASK-') && f.endsWith('.json'));
+            }
+            catch { /* ignore */ }
+        }
+        // Check verification and uat from phase state
+        const phase = stateManager.getPhase(args.phase);
+        if (phase) {
+            artifacts.verification = phase.verification?.status === 'passed' || phase.verification?.status === 'failed';
+            artifacts.uat = phase.uat?.status === 'passed' || phase.uat?.status === 'failed';
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(artifacts, null, 2) }] };
+    });
+    const listPhaseTasksTool = tool('list_phase_tasks', 'List task summaries for a given phase including id, title, status, and convergence criteria.', { phase: z.number().describe('Phase number to list tasks for') }, async (args) => {
+        const tasks = await stateManager.getTasks(args.phase);
+        const summaries = tasks.map(t => ({
+            id: t.id,
+            title: t.title,
+            type: t.type,
+            convergence: t.convergence,
+        }));
+        return { content: [{ type: 'text', text: JSON.stringify(summaries, null, 2) }] };
+    });
+    return [getProjectStateTool, getPhaseStateTool, checkArtifactsTool, listPhaseTasksTool];
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+async function fileExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function findPhaseDir(workflowRoot, phaseNum) {
+    try {
+        const entries = await readdir(workflowRoot);
+        const prefix = `phase-${String(phaseNum).padStart(2, '0')}`;
+        const match = entries.find(e => e.startsWith(prefix));
+        return match ? join(workflowRoot, match) : null;
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+export function createWorkflowMcpServer(stateManager, workflowRoot) {
+    return createSdkMcpServer({
+        name: 'workflow-state',
+        tools: buildTools(stateManager, workflowRoot),
+    });
+}
+//# sourceMappingURL=workflow-mcp-server.js.map

package/dashboard/dist-server/src/server/coordinator/tools/workflow-mcp-server.js.map

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

package/dashboard/dist-server/src/server/coordinator/types.d.ts

@@ -0,0 +1,51 @@
+export interface WorkflowArtifacts {
+    brainstorm: boolean;
+    analysis: boolean;
+    context: boolean;
+    plan: boolean;
+    verification: boolean;
+    uat: boolean;
+}
+export interface WorkflowSnapshot {
+    initialized: boolean;
+    currentPhase: number;
+    phaseStatus: string;
+    artifacts: WorkflowArtifacts;
+    execution: {
+        tasksCompleted: number;
+        tasksTotal: number;
+    };
+    verification: string;
+    uat: string;
+    phasesTotal: number;
+    phasesCompleted: number;
+    hasBlockers: boolean;
+    accumulatedContext: string[];
+    progressSummary: string;
+    suggestedNextAction: string;
+    readiness: 'ready' | 'blocked' | 'needs_input' | 'unknown';
+}
+export interface ClassifiedIntent {
+    taskType: string;
+    confidence: number;
+    chainName: string;
+    steps: Array<{
+        cmd: string;
+        args: string;
+    }>;
+    reasoning: string;
+    clarificationNeeded: boolean;
+    clarificationQuestion: string | null;
+}
+export interface StepAnalysis {
+    qualityScore: number;
+    executionAssessment: string;
+    issues: string[];
+    nextStepHints: string;
+    stepSummary: string;
+}
+export type CoordinateProgressListener = (event: {
+    phase: string;
+    message: string;
+    data?: unknown;
+}) => void;

package/dashboard/dist-server/src/server/coordinator/types.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Multi-Agent Workflow Coordinator — type definitions
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=types.js.map

package/dashboard/dist-server/src/server/coordinator/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/server/coordinator/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,sDAAsD;AACtD,8EAA8E"}

package/dashboard/dist-server/src/server/coordinator/walker-event-bridge.d.ts

@@ -0,0 +1,9 @@
+import type { CoordinateEvent, WalkerEventEmitter } from '../../../../src/coordinator/graph-types.js';
+import type { DashboardEventBus } from '../state/event-bus.js';
+export declare class WalkerEventBridge implements WalkerEventEmitter {
+    private readonly mode;
+    private readonly eventBus;
+    private readonly sessionId?;
+    constructor(mode: 'coordinate' | 'execution', eventBus: DashboardEventBus, sessionId?: string | undefined);
+    emit(event: CoordinateEvent): void;
+}

package/dashboard/dist-server/src/server/coordinator/walker-event-bridge.js

@@ -0,0 +1,61 @@
+// ---------------------------------------------------------------------------
+// WalkerEventBridge -- bridges GraphWalker events to DashboardEventBus
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// WalkerEventBridge
+// ---------------------------------------------------------------------------
+export class WalkerEventBridge {
+    mode;
+    eventBus;
+    sessionId;
+    constructor(mode, eventBus, sessionId) {
+        this.mode = mode;
+        this.eventBus = eventBus;
+        this.sessionId = sessionId;
+    }
+    emit(event) {
+        // 1. Forward raw walker events to dashboard event bus
+        this.eventBus.emit(event.type, event);
+        // 2. Translate walker:command → coordinate:step
+        if (event.type === 'walker:command') {
+            const status = event.status;
+            if (this.mode === 'coordinate') {
+                // Coordinate mode: emit for ALL statuses (spawned/completed/failed)
+                this.eventBus.emit('coordinate:step', {
+                    sessionId: event.session_id,
+                    step: {
+                        cmd: event.cmd ?? event.node_id,
+                        status: status === 'completed' ? 'completed'
+                            : status === 'failed' ? 'failed'
+                                : 'running',
+                        summary: event.summary ?? null,
+                        qualityScore: event.quality_score ?? null,
+                    },
+                });
+            }
+            else {
+                // Execution mode: emit ONLY for completed/failed (NOT spawned)
+                if (status === 'completed' || status === 'failed') {
+                    const sid = this.sessionId ?? event.session_id;
+                    this.eventBus.emit('coordinate:step', {
+                        sessionId: sid,
+                        step: {
+                            cmd: event.cmd ?? event.node_id,
+                            status: status === 'completed' ? 'completed' : 'failed',
+                            summary: event.summary ?? null,
+                            qualityScore: null,
+                        },
+                    });
+                }
+            }
+        }
+        // 3. Map gate:waiting → coordinate:clarification_needed
+        if (event.type === 'walker:gate_waiting') {
+            this.eventBus.emit('coordinate:clarification_needed', {
+                sessionId: event.session_id ?? this.sessionId ?? '',
+                question: event.wait_message ?? 'Gate condition not met. Waiting for input.',
+            });
+        }
+    }
+}
+//# sourceMappingURL=walker-event-bridge.js.map

package/dashboard/dist-server/src/server/coordinator/walker-event-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walker-event-bridge.js","sourceRoot":"","sources":["../../../../src/server/coordinator/walker-event-bridge.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,uEAAuE;AACvE,8EAA8E;AAK9E,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,MAAM,OAAO,iBAAiB;IAET;IACA;IACA;IAHnB,YACmB,IAAgC,EAChC,QAA2B,EAC3B,SAAkB;QAFlB,SAAI,GAAJ,IAAI,CAA4B;QAChC,aAAQ,GAAR,QAAQ,CAAmB;QAC3B,cAAS,GAAT,SAAS,CAAS;IAClC,CAAC;IAEJ,IAAI,CAAC,KAAsB;QACzB,sDAAsD;QACtD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAW,EAAE,KAAK,CAAC,CAAC;QAE7C,gDAAgD;QAChD,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAE5B,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC/B,oEAAoE;gBACpE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAwB,EAAE;oBAC3C,SAAS,EAAE,KAAK,CAAC,UAAU;oBAC3B,IAAI,EAAE;wBACJ,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO;wBAC/B,MAAM,EAAE,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW;4BAC1C,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ;gCAChC,CAAC,CAAC,SAAS;wBACb,OAAO,EAAG,KAAa,CAAC,OAAO,IAAI,IAAI;wBACvC,YAAY,EAAG,KAAa,CAAC,aAAa,IAAI,IAAI;qBACnD;iBACF,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,+DAA+D;gBAC/D,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;oBAClD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,UAAU,CAAC;oBAC/C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAwB,EAAE;wBAC3C,SAAS,EAAE,GAAG;wBACd,IAAI,EAAE;4BACJ,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO;4BAC/B,MAAM,EAAE,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ;4BACvD,OAAO,EAAG,KAAa,CAAC,OAAO,IAAI,IAAI;4BACvC,YAAY,EAAE,IAAI;yBACnB;qBACF,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,wDAAwD;QACxD,IAAK,KAAa,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;YAClD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,iCAAiC,EAAE;gBACpD,SAAS,EAAG,KAAa,CAAC,UAAU,IAAI,IAAI,CAAC,SAAS,IAAI,EAAE;gBAC5D,QAAQ,EAAG,KAAa,CAAC,YAAY,IAAI,4CAA4C;aACtF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}