maestro-flow 0.1.4 → 0.2.0

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

@@ -0,0 +1,39 @@
+import type { CoordinateSession } from '../../shared/coordinate-types.js';
+import type { DashboardEventBus } from '../state/event-bus.js';
+import type { AgentManager } from '../agents/agent-manager.js';
+import type { StateManager } from '../state/state-manager.js';
+export interface CoordinateStartOpts {
+    tool?: string;
+    autoMode?: boolean;
+    chainName?: string;
+    phase?: string;
+}
+export declare class WorkflowCoordinator {
+    private readonly eventBus;
+    private readonly agentManager;
+    private readonly stateManager;
+    private readonly workflowRoot;
+    private session;
+    private readonly qualityReviewer;
+    private readonly factory;
+    private graphWalker;
+    private graphWalkerInitPromise;
+    constructor(eventBus: DashboardEventBus, agentManager: AgentManager, stateManager: StateManager, workflowRoot: string);
+    private getGraphWalker;
+    start(intent: string, opts?: CoordinateStartOpts): Promise<CoordinateSession>;
+    stop(): Promise<void>;
+    resume(sessionId?: string): Promise<CoordinateSession | null>;
+    clarify(_sessionId: string, _response: string): Promise<void>;
+    getSession(): CoordinateSession | null;
+    destroy(): void;
+    private startViaGraphWalker;
+    private runGraphWalker;
+    /** Convert WalkerState history -> CoordinateSession steps */
+    private syncWalkerToSession;
+    private stopViaGraphWalker;
+    private resumeViaGraphWalker;
+    private get sessionDir();
+    private persistState;
+    private loadState;
+    private emitStatus;
+}

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

@@ -0,0 +1,250 @@
+// ---------------------------------------------------------------------------
+// WorkflowCoordinator -- multi-agent orchestration via GraphWalker
+// ---------------------------------------------------------------------------
+import { randomUUID } from 'node:crypto';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { QualityReviewerAgent } from './agents/quality-reviewer-agent.js';
+import { GraphWalkerFactory } from './graph-walker-factory.js';
+import { WalkerEventBridge } from './walker-event-bridge.js';
+import { DashboardStepAnalyzer } from './dashboard-step-analyzer.js';
+// ---------------------------------------------------------------------------
+// WorkflowCoordinator
+// ---------------------------------------------------------------------------
+export class WorkflowCoordinator {
+    eventBus;
+    agentManager;
+    stateManager;
+    workflowRoot;
+    session = null;
+    qualityReviewer;
+    // GraphWalker factory and lazily initialized components
+    factory;
+    graphWalker = null;
+    graphWalkerInitPromise = null;
+    constructor(eventBus, agentManager, stateManager, workflowRoot) {
+        this.eventBus = eventBus;
+        this.agentManager = agentManager;
+        this.stateManager = stateManager;
+        this.workflowRoot = workflowRoot;
+        this.factory = new GraphWalkerFactory();
+        this.qualityReviewer = new QualityReviewerAgent();
+    }
+    // Lazy initialization — only created on first use
+    async getGraphWalker() {
+        if (this.graphWalker)
+            return this.graphWalker;
+        if (!this.graphWalkerInitPromise) {
+            const sessionDir = join(this.workflowRoot, '.workflow', '.maestro-coordinate');
+            this.graphWalkerInitPromise = this.factory.create({
+                agentManager: this.agentManager,
+                eventBus: this.eventBus,
+                workDir: this.workflowRoot,
+                emitter: new WalkerEventBridge('coordinate', this.eventBus),
+                analyzer: new DashboardStepAnalyzer(this.qualityReviewer),
+                sessionDir,
+            });
+        }
+        this.graphWalker = await this.graphWalkerInitPromise;
+        return this.graphWalker;
+    }
+    // -------------------------------------------------------------------------
+    // Public API
+    // -------------------------------------------------------------------------
+    async start(intent, opts) {
+        if (this.session?.status === 'running') {
+            throw new Error('A coordinate session is already running. Stop it first or wait for completion.');
+        }
+        return this.startViaGraphWalker(intent, opts);
+    }
+    async stop() {
+        if (this.graphWalker) {
+            await this.stopViaGraphWalker();
+            return;
+        }
+        if (!this.session)
+            return;
+        this.session.status = 'failed';
+        this.emitStatus();
+        await this.persistState();
+    }
+    async resume(sessionId) {
+        return this.resumeViaGraphWalker(sessionId);
+    }
+    async clarify(_sessionId, _response) {
+        // Clarification is handled via gate:waiting → WalkerEventBridge in graph walker path.
+        // This stub preserves the API for routes/WS handlers that still reference it.
+    }
+    getSession() {
+        return this.session ? { ...this.session, steps: this.session.steps.map(s => ({ ...s })) } : null;
+    }
+    destroy() {
+        // No-op — graph walker manages its own lifecycle
+    }
+    // -------------------------------------------------------------------------
+    // GraphWalker bridge methods
+    // -------------------------------------------------------------------------
+    async startViaGraphWalker(intent, opts) {
+        const gw = await this.getGraphWalker();
+        const graphId = opts?.chainName
+            ? opts.chainName
+            : gw.router.resolve(intent);
+        const sessionId = `coord-${Date.now().toString(36)}-${randomUUID().slice(0, 8)}`;
+        this.session = {
+            sessionId,
+            status: 'running',
+            intent,
+            chainName: graphId,
+            tool: opts?.tool ?? 'claude',
+            autoMode: opts?.autoMode ?? false,
+            currentStep: 0,
+            steps: [],
+            avgQuality: null,
+        };
+        this.emitStatus();
+        await this.persistState();
+        // Run walker in background — session returned immediately, UI gets step events via emitter
+        void this.runGraphWalker(gw, graphId, intent, opts);
+        return this.session;
+    }
+    async runGraphWalker(gw, graphId, intent, opts) {
+        try {
+            const walkerState = await gw.walker.start(graphId, intent, {
+                tool: opts?.tool ?? 'claude',
+                autoMode: opts?.autoMode ?? false,
+                workflowRoot: this.workflowRoot,
+                inputs: {
+                    phase: opts?.phase ?? '',
+                    description: intent,
+                },
+            });
+            if (!this.session)
+                return;
+            // Sync final WalkerState -> CoordinateSession
+            this.syncWalkerToSession(walkerState);
+            this.emitStatus();
+            await this.persistState();
+        }
+        catch (err) {
+            if (!this.session)
+                return;
+            const message = err instanceof Error ? err.message : String(err);
+            this.session.status = 'failed';
+            this.eventBus.emit('coordinate:error', {
+                error: message,
+                context: 'graph_walker',
+                step: this.session.currentStep,
+                timestamp: Date.now(),
+            });
+            this.emitStatus();
+            await this.persistState();
+        }
+    }
+    /** Convert WalkerState history -> CoordinateSession steps */
+    syncWalkerToSession(walkerState) {
+        if (!this.session)
+            return;
+        this.session.steps = walkerState.history
+            .filter(h => h.node_type === 'command')
+            .map((h, i) => ({
+            index: i,
+            cmd: h.node_id,
+            args: '',
+            status: h.outcome === 'success' ? 'completed'
+                : h.outcome === 'failure' ? 'failed'
+                    : 'skipped',
+            processId: h.exec_id ?? null,
+            analysis: null,
+            summary: h.summary ?? null,
+            qualityScore: h.quality_score ?? null,
+            startedAt: h.entered_at,
+            completedAt: h.exited_at,
+        }));
+        this.session.status = walkerState.status === 'completed' ? 'completed'
+            : walkerState.status === 'failed' ? 'failed'
+                : 'paused';
+    }
+    async stopViaGraphWalker() {
+        const gw = await this.getGraphWalker();
+        await gw.walker.stop();
+        if (this.session) {
+            this.session.status = 'failed';
+            this.emitStatus();
+            await this.persistState();
+        }
+    }
+    async resumeViaGraphWalker(sessionId) {
+        const gw = await this.getGraphWalker();
+        try {
+            // Resume runs the walker to completion — returns final state
+            const walkerState = await gw.walker.resume(sessionId);
+            this.session = {
+                sessionId: walkerState.session_id,
+                status: 'running',
+                intent: walkerState.intent,
+                chainName: walkerState.graph_id,
+                tool: walkerState.tool,
+                autoMode: walkerState.auto_mode,
+                currentStep: 0,
+                steps: [],
+                avgQuality: null,
+            };
+            this.syncWalkerToSession(walkerState);
+            this.emitStatus();
+            await this.persistState();
+            return this.session;
+        }
+        catch {
+            return null;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // State persistence
+    // -------------------------------------------------------------------------
+    get sessionDir() {
+        if (!this.session)
+            throw new Error('No active session');
+        return join(this.workflowRoot, '.workflow', '.maestro-coordinate', this.session.sessionId);
+    }
+    async persistState() {
+        if (!this.session)
+            return;
+        try {
+            const dir = this.sessionDir;
+            await mkdir(dir, { recursive: true });
+            await writeFile(join(dir, 'state.json'), JSON.stringify(this.session, null, 2), 'utf-8');
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`[WorkflowCoordinator] Failed to persist state: ${message}`);
+        }
+    }
+    async loadState(sessionId) {
+        try {
+            let stateDir;
+            if (sessionId) {
+                stateDir = join(this.workflowRoot, '.workflow', '.maestro-coordinate', sessionId);
+            }
+            else if (this.session) {
+                stateDir = this.sessionDir;
+            }
+            else {
+                return null;
+            }
+            const raw = await readFile(join(stateDir, 'state.json'), 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Event emission
+    // -------------------------------------------------------------------------
+    emitStatus() {
+        if (!this.session)
+            return;
+        this.eventBus.emit('coordinate:status', { session: this.session });
+    }
+}
+//# sourceMappingURL=workflow-coordinator.js.map

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

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

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

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

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

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

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

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

package/dashboard/dist-server/dashboard/src/server/docs/doc-scanner.d.ts

@@ -0,0 +1,31 @@
+import type { DocEntry, DocFilters, DocIndex, DocType } from './doc-types.js';
+export interface DocScannerConfig {
+    workflowRoot: string;
+}
+/**
+ * DocScanner: single source of truth for the unified document index.
+ *
+ * Responsibilities:
+ *   1. Walk `.workflow/` for known doc sources.
+ *   2. Parse frontmatter + infer missing fields.
+ *   3. Adapt JSONL rows as virtual docs.
+ *   4. Build backlinks from `related: [[id]]` frontmatter.
+ *   5. Cache result, rebuild on invalidate with single-flight guard.
+ */
+export declare class DocScanner {
+    private readonly workflowRoot;
+    private cache;
+    private inflight;
+    constructor(config: DocScannerConfig);
+    get(): Promise<DocIndex>;
+    rebuild(): Promise<DocIndex>;
+    invalidate(_changedAbsPath?: string): void;
+    query(filters: DocFilters): Promise<DocEntry[]>;
+    groups(filters?: DocFilters): Promise<Record<DocType, DocEntry[]>>;
+    private scanFiles;
+    private scanVirtual;
+    private parseDocFile;
+    private buildBacklinks;
+    private isInsideRoot;
+}
+export declare function filterDocs(docs: DocEntry[], filters: DocFilters): DocEntry[];