maestro-flow 0.1.0

package/dashboard/dist-server/shared/team-types.js

@@ -0,0 +1,54 @@
+// ---------------------------------------------------------------------------
+// Team Session Types — shared between server and client
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// Skill prefix → label mapping
+// ---------------------------------------------------------------------------
+export const SKILL_PREFIX_MAP = {
+    'TC-': 'Coordinate',
+    'TLV4-': 'Lifecycle',
+    'QA-': 'QA',
+    'RV-': 'Review',
+    'TST-': 'Testing',
+    'TFD-': 'Frontend Debug',
+    'TPO-': 'Perf Opt',
+    'TTD-': 'Tech Debt',
+    'TPX-': 'Plan & Execute',
+    'TBS-': 'Brainstorm',
+    'TRD-': 'Roadmap Dev',
+    'TIS-': 'Issue',
+    'TID-': 'Iter Dev',
+    'TUA-': 'Ultra Analyze',
+    'TUX-': 'UX Improve',
+    'TUI-': 'UI Design',
+    'TAO-': 'Arch Opt',
+};
+export function inferSkill(sessionId) {
+    for (const [prefix, label] of Object.entries(SKILL_PREFIX_MAP)) {
+        if (sessionId.startsWith(prefix))
+            return label;
+    }
+    return 'Team';
+}
+// ---------------------------------------------------------------------------
+// Status colors for team sessions
+// ---------------------------------------------------------------------------
+export const TEAM_STATUS_COLORS = {
+    active: '#B89540',
+    completed: '#5A9E78',
+    failed: '#C46555',
+    archived: '#A09D97',
+};
+export const PIPELINE_STATUS_COLORS = {
+    done: '#5A9E78',
+    in_progress: '#B89540',
+    pending: '#A09D97',
+    skipped: '#D1CEC8',
+};
+export const ROLE_STATUS_COLORS = {
+    done: '#5A9E78',
+    active: '#B89540',
+    pending: '#A09D97',
+    injected: '#8B6BBF',
+};
+//# sourceMappingURL=team-types.js.map

package/dashboard/dist-server/shared/team-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-types.js","sourceRoot":"","sources":["../../src/shared/team-types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wDAAwD;AACxD,8EAA8E;AA4D9E,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,KAAK,EAAE,YAAY;IACnB,OAAO,EAAE,WAAW;IACpB,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,gBAAgB;IACxB,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,gBAAgB;IACxB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,aAAa;IACrB,MAAM,EAAE,OAAO;IACf,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,UAAU;CACV,CAAC;AAEX,MAAM,UAAU,UAAU,CAAC,SAAiB;IAC1C,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC/D,IAAI,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E,MAAM,CAAC,MAAM,kBAAkB,GAAiD;IAC9E,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,SAAS;IACpB,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,SAAS;CACX,CAAC;AAEX,MAAM,CAAC,MAAM,sBAAsB,GAA2C;IAC5E,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,SAAS;IACtB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACV,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAuC;IACpE,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,SAAS;CACX,CAAC"}

package/dashboard/dist-server/shared/types.d.ts

@@ -0,0 +1,219 @@
+export type PhaseStatus = 'pending' | 'exploring' | 'planning' | 'executing' | 'verifying' | 'testing' | 'completed' | 'blocked';
+export type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'failed';
+export type TaskType = 'feature' | 'fix' | 'refactor' | 'test' | 'docs';
+export type ProjectStatus = 'planning' | 'executing' | 'verifying' | 'idle';
+import type { LinearIssue } from './linear-types.js';
+import type { Issue } from './issue-types.js';
+export type SelectedKanbanItem = {
+    type: 'phase';
+    phaseId: number;
+} | {
+    type: 'linearIssue';
+    issue: LinearIssue;
+} | {
+    type: 'issue';
+    issue: Issue;
+} | {
+    type: 'task';
+    task: TaskCard;
+    phaseId: number;
+};
+export type { AgentProcess, NormalizedEntry, ApprovalRequest, AgentStatusPayload, AgentStoppedPayload } from './agent-types.js';
+import type { AgentProcess, NormalizedEntry, ApprovalRequest, AgentStatusPayload, AgentStoppedPayload, AgentTurnCompletedPayload } from './agent-types.js';
+import type { SupervisorStatus } from './execution-types.js';
+import type { LearningStats } from './learning-types.js';
+import type { CommanderState, Decision, CommanderConfig, AssessMetrics } from './commander-types.js';
+import type { ExecutionStartedPayload, ExecutionCompletedPayload, ExecutionFailedPayload } from './ws-protocol.js';
+import type { CoordinateStatusPayload, CoordinateStepPayload, CoordinateAnalysisPayload, CoordinateClarificationPayload } from './coordinate-types.js';
+import type { RequirementProgressPayload, RequirementExpandedPayload, RequirementCommittedPayload, RequirementErrorPayload } from './requirement-types.js';
+import type { ScheduledTask } from './schedule-types.js';
+import type { ExtensionInfo } from './extension-types.js';
+export type SSEEventType = 'board:full' | 'phase:updated' | 'task:updated' | 'scratch:updated' | 'project:updated' | 'watcher:error' | 'heartbeat' | 'connected' | 'agent:spawned' | 'agent:entry' | 'agent:approval' | 'agent:status' | 'agent:stopped' | 'agent:turnCompleted' | 'execution:started' | 'execution:completed' | 'execution:failed' | 'execution:scheduler_status' | 'supervisor:status' | 'supervisor:learning_update' | 'supervisor:schedule_triggered' | 'supervisor:schedule_update' | 'supervisor:extension_loaded' | 'supervisor:extension_error' | 'commander:status' | 'commander:tick' | 'commander:decision' | 'commander:config' | 'commander:assess_metrics' | 'commander:error' | 'coordinate:status' | 'coordinate:analyze_metrics' | 'coordinate:step' | 'coordinate:analysis' | 'coordinate:clarification_needed' | 'coordinate:error' | 'requirement:expanded' | 'requirement:refined' | 'requirement:committed' | 'requirement:progress' | 'workspace:switched';
+/** Mirrors state.json — top-level project state */
+export interface ProjectState {
+    version: string;
+    project_name: string;
+    current_milestone: string;
+    current_phase: number;
+    status: ProjectStatus;
+    phases_summary: {
+        total: number;
+        completed: number;
+        in_progress: number;
+        pending: number;
+    };
+    last_updated: string;
+    accumulated_context: {
+        key_decisions: string[];
+        blockers: string[];
+        deferred: string[];
+    };
+}
+/** Mirrors index.json — one phase in the lifecycle pipeline */
+export interface PhaseCard {
+    phase: number;
+    slug: string;
+    title: string;
+    status: PhaseStatus;
+    created_at: string;
+    updated_at: string;
+    goal: string;
+    success_criteria: string[];
+    requirements: string[];
+    spec_ref: string | null;
+    plan: {
+        task_ids: string[];
+        task_count: number;
+        complexity: string | null;
+        waves: (string[] | {
+            wave: number;
+            tasks: string[];
+        })[];
+    };
+    execution: {
+        method: string;
+        started_at: string | null;
+        completed_at: string | null;
+        tasks_completed: number;
+        tasks_total: number;
+        current_wave: number;
+        commits: (string | {
+            hash: string;
+            task: string;
+            message: string;
+        })[];
+    };
+    verification: {
+        status: string;
+        verified_at: string | null;
+        must_haves: string[];
+        gaps: (string | {
+            id?: string;
+            severity?: string;
+            description?: string;
+        })[];
+    };
+    validation: {
+        status: string;
+        test_coverage: number | {
+            statements: number;
+            branches: number;
+            functions: number;
+            lines: number;
+        } | null;
+        gaps: (string | {
+            requirement?: string;
+            status?: string;
+            description?: string;
+        })[];
+    };
+    uat: {
+        status: string;
+        test_count: number;
+        passed: number;
+        gaps: (string | {
+            description?: string;
+        })[];
+    };
+    reflection: {
+        rounds: number;
+        strategy_adjustments: string[];
+    };
+}
+/** Mirrors TASK-*.json — a task within a phase */
+export interface TaskCard {
+    id: string;
+    title: string;
+    description: string;
+    type: TaskType;
+    priority: string;
+    effort: string;
+    action: string;
+    scope: string;
+    focus_paths: string[];
+    depends_on: string[];
+    parallel_group: string | null;
+    convergence: {
+        criteria: string[];
+        verification: string;
+        definition_of_done: string;
+    };
+    files: Array<{
+        path: string;
+        action: string;
+        target: string;
+        change: string;
+    }>;
+    implementation: string[];
+    test: {
+        commands: string[];
+        unit: string[];
+        integration: string[];
+        success_metrics: string[];
+    };
+    reference: {
+        pattern: string;
+        files: string[];
+        examples: string | null;
+    };
+    rationale: {
+        chosen_approach: string;
+        decision_factors: string[];
+        tradeoffs: string | null;
+    };
+    risks: string[];
+    code_skeleton: string | null;
+    doc_context: {
+        affected_features: string[];
+        affected_components: string[];
+        affected_requirements: string[];
+        adr_ids: string[];
+    };
+    meta: {
+        status: TaskStatus;
+        estimated_time: string | null;
+        risk: string;
+        autonomous: boolean;
+        checkpoint: boolean;
+        wave: number;
+        execution_group: string | null;
+        executor: string;
+    };
+}
+/** Non-phase scratch tasks (from scratch-index.json) */
+export interface ScratchCard {
+    id: string;
+    title: string;
+    status: TaskStatus;
+    type: TaskType;
+    created_at: string;
+    updated_at: string;
+    description: string;
+    files: string[];
+}
+/** Full board state — assembled by the server from .workflow/ files */
+export interface BoardState {
+    project: ProjectState;
+    phases: PhaseCard[];
+    scratch: ScratchCard[];
+    lastUpdated: string;
+}
+/** SSE event envelope */
+export interface SSEEvent {
+    type: SSEEventType;
+    data: BoardState | PhaseCard | TaskCard | ScratchCard | ProjectState | AgentProcess | NormalizedEntry | ApprovalRequest | AgentStatusPayload | AgentStoppedPayload | AgentTurnCompletedPayload | ExecutionStartedPayload | ExecutionCompletedPayload | ExecutionFailedPayload | SupervisorStatus | CommanderState | Decision | CommanderConfig | AssessMetrics | CoordinateStatusPayload | CoordinateStepPayload | CoordinateAnalysisPayload | CoordinateClarificationPayload | RequirementProgressPayload | RequirementExpandedPayload | RequirementCommittedPayload | RequirementErrorPayload | LearningStats | {
+        taskId: string;
+        taskName: string;
+        taskType: string;
+    } | {
+        tasks: ScheduledTask[];
+    } | {
+        extensions: ExtensionInfo[];
+    } | {
+        name: string;
+        error: string;
+    } | {
+        workspace: string;
+    } | string | null;
+    timestamp: string;
+}

package/dashboard/dist-server/shared/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dashboard/dist-server/shared/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":""}

package/dashboard/dist-server/shared/utils.d.ts

@@ -0,0 +1,2 @@
+/** Convert OS-specific path separators to forward slashes */
+export declare function toForwardSlash(p: string): string;

package/dashboard/dist-server/shared/utils.js

@@ -0,0 +1,6 @@
+import { sep, posix } from 'node:path';
+/** Convert OS-specific path separators to forward slashes */
+export function toForwardSlash(p) {
+    return p.split(sep).join(posix.sep);
+}
+//# sourceMappingURL=utils.js.map

package/dashboard/dist-server/shared/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEvC,6DAA6D;AAC7D,MAAM,UAAU,cAAc,CAAC,CAAS;IACtC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC"}

package/dashboard/dist-server/shared/utils.test.d.ts

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

package/dashboard/dist-server/shared/utils.test.js

@@ -0,0 +1,22 @@
+import { describe, it, expect } from 'vitest';
+import { toForwardSlash } from './utils.js';
+describe('toForwardSlash', () => {
+    it('converts backslashes to forward slashes', () => {
+        expect(toForwardSlash('a\\b\\c')).toBe('a/b/c');
+    });
+    it('leaves forward slashes unchanged', () => {
+        expect(toForwardSlash('a/b/c')).toBe('a/b/c');
+    });
+    it('handles empty string', () => {
+        expect(toForwardSlash('')).toBe('');
+    });
+    it('handles single segment (no separators)', () => {
+        expect(toForwardSlash('file.ts')).toBe('file.ts');
+    });
+    it('handles Windows absolute paths', () => {
+        const result = toForwardSlash('C:\\Users\\dyw\\project');
+        expect(result).toContain('/');
+        expect(result).not.toContain('\\');
+    });
+});
+//# sourceMappingURL=utils.test.js.map

package/dashboard/dist-server/shared/utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.test.js","sourceRoot":"","sources":["../../src/shared/utils.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,cAAc,CAAC,yBAAyB,CAAC,CAAC;QACzD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dashboard/dist-server/shared/wave-types.d.ts

@@ -0,0 +1,41 @@
+/** A single subtask decomposed from an issue */
+export interface WaveTask {
+    id: string;
+    title: string;
+    description: string;
+    /** IDs of tasks this depends on (must complete before this runs) */
+    deps: string[];
+    /** IDs of tasks whose results should be injected as context */
+    contextFrom: string[];
+    /** Computed wave number (0-based), set by topological sort */
+    wave: number;
+    /** Current execution status */
+    status: 'pending' | 'running' | 'completed' | 'failed';
+    /** Result summary after completion */
+    findings?: string;
+    /** Files modified by this task */
+    filesModified?: string[];
+    /** Error message if failed */
+    error?: string;
+}
+/** Wave execution session state */
+export interface WaveSession {
+    issueId: string;
+    processId: string;
+    status: 'decomposing' | 'executing' | 'completed' | 'failed';
+    tasks: WaveTask[];
+    totalWaves: number;
+    currentWave: number;
+    startedAt: string;
+    completedAt?: string;
+}
+/** Structured output from the decomposition Agent SDK query */
+export interface DecompositionResult {
+    tasks: Array<{
+        id: string;
+        title: string;
+        description: string;
+        deps: string[];
+        contextFrom: string[];
+    }>;
+}

package/dashboard/dist-server/shared/wave-types.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Wave execution types — CSV-wave-inspired parallel task execution
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=wave-types.js.map

package/dashboard/dist-server/shared/wave-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wave-types.js","sourceRoot":"","sources":["../../src/shared/wave-types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,mEAAmE;AACnE,8EAA8E"}

package/dashboard/dist-server/shared/ws-protocol.d.ts

@@ -0,0 +1,154 @@
+import type { AgentConfig, AgentProcess, AgentType, NormalizedEntry, ApprovalRequest, AgentStatusPayload, AgentStoppedPayload } from './agent-types.js';
+import type { CommanderConfig } from './commander-types.js';
+import type { SupervisorConfig } from './execution-types.js';
+import type { ExpansionDepth } from './requirement-types.js';
+/** All WebSocket event type discriminators */
+export type WsEventType = 'agent:spawned' | 'agent:entry' | 'agent:approval' | 'agent:status' | 'agent:stopped' | 'agent:turnCompleted' | 'agent:thought' | 'agent:streaming' | 'execution:started' | 'execution:completed' | 'execution:failed' | 'execution:scheduler_status' | 'supervisor:status' | 'supervisor:learning_update' | 'supervisor:schedule_triggered' | 'supervisor:schedule_update' | 'supervisor:extension_loaded' | 'supervisor:extension_error' | 'commander:status' | 'commander:tick' | 'commander:decision' | 'commander:config' | 'commander:assess_metrics' | 'commander:error' | 'coordinate:status' | 'coordinate:analyze_metrics' | 'coordinate:step' | 'coordinate:analysis' | 'coordinate:clarification_needed' | 'coordinate:error' | 'requirement:expanded' | 'requirement:refined' | 'requirement:committed' | 'requirement:progress' | 'board:full' | 'phase:updated' | 'task:updated' | 'scratch:updated' | 'project:updated' | 'watcher:error' | 'workspace:switched' | 'heartbeat' | 'connected';
+/** Envelope for all server-to-client WebSocket messages */
+export interface WsServerMessage<T = unknown> {
+    type: WsEventType;
+    data: T;
+    timestamp: string;
+}
+export type WsAgentSpawnedMessage = WsServerMessage<AgentProcess>;
+export type WsAgentEntryMessage = WsServerMessage<NormalizedEntry>;
+export type WsAgentApprovalMessage = WsServerMessage<ApprovalRequest>;
+export type WsAgentStatusMessage = WsServerMessage<AgentStatusPayload>;
+export type WsAgentStoppedMessage = WsServerMessage<AgentStoppedPayload>;
+/** Discriminated union of all client-to-server WS actions */
+export type WsClientMessage = WsClientSpawnMessage | WsClientStopMessage | WsClientMessageMessage | WsClientApproveMessage | WsClientCliBridgeSpawnMessage | WsClientCliBridgeEntryMessage | WsClientCliBridgeStoppedMessage | WsClientExecuteIssueMessage | WsClientExecuteBatchMessage | WsClientAnalyzeIssueMessage | WsClientPlanIssueMessage | WsClientSupervisorToggleMessage | WsClientCommanderStartMessage | WsClientCommanderStopMessage | WsClientCommanderPauseMessage | WsClientCommanderConfigMessage | WsClientWaveExecuteMessage | WsClientCoordinateStartMessage | WsClientCoordinateStopMessage | WsClientCoordinateResumeMessage | WsClientCoordinateClarifyMessage | WsClientIssuePipelineMessage | WsClientRequirementExpandMessage | WsClientRequirementRefineMessage | WsClientRequirementCommitMessage;
+export interface WsClientSpawnMessage {
+    action: 'spawn';
+    config: AgentConfig;
+}
+export interface WsClientStopMessage {
+    action: 'stop';
+    processId: string;
+}
+export interface WsClientMessageMessage {
+    action: 'message';
+    processId: string;
+    content: string;
+}
+export interface WsClientApproveMessage {
+    action: 'approve';
+    processId: string;
+    requestId: string;
+    allow: boolean;
+}
+export interface WsClientCliBridgeSpawnMessage {
+    action: 'cli:spawned';
+    process: AgentProcess;
+}
+export interface WsClientCliBridgeEntryMessage {
+    action: 'cli:entry';
+    entry: NormalizedEntry;
+}
+export interface WsClientCliBridgeStoppedMessage {
+    action: 'cli:stopped';
+    processId: string;
+}
+export interface WsClientExecuteIssueMessage {
+    action: 'execute:issue';
+    issueId: string;
+    executor?: AgentType;
+}
+export interface WsClientExecuteBatchMessage {
+    action: 'execute:batch';
+    issueIds: string[];
+    executor?: AgentType;
+    maxConcurrency?: number;
+}
+export interface WsClientAnalyzeIssueMessage {
+    action: 'issue:analyze';
+    issueId: string;
+    tool?: string;
+    depth?: string;
+}
+export interface WsClientPlanIssueMessage {
+    action: 'issue:plan';
+    issueId: string;
+    tool?: string;
+}
+export interface WsClientIssuePipelineMessage {
+    action: 'issue:pipeline';
+    issueId: string;
+    tool?: string;
+}
+export interface WsClientSupervisorToggleMessage {
+    action: 'supervisor:toggle';
+    enabled: boolean;
+    config?: Partial<SupervisorConfig>;
+}
+export interface WsClientCommanderStartMessage {
+    action: 'commander:start';
+}
+export interface WsClientCommanderStopMessage {
+    action: 'commander:stop';
+}
+export interface WsClientCommanderPauseMessage {
+    action: 'commander:pause';
+}
+export interface WsClientCommanderConfigMessage {
+    action: 'commander:config';
+    config: Partial<CommanderConfig>;
+}
+export interface WsClientWaveExecuteMessage {
+    action: 'execute:wave';
+    issueId: string;
+}
+export interface WsClientCoordinateStartMessage {
+    action: 'coordinate:start';
+    intent: string;
+    tool?: string;
+    autoMode?: boolean;
+}
+export interface WsClientCoordinateStopMessage {
+    action: 'coordinate:stop';
+}
+export interface WsClientCoordinateResumeMessage {
+    action: 'coordinate:resume';
+    sessionId?: string;
+}
+export interface WsClientCoordinateClarifyMessage {
+    action: 'coordinate:clarify';
+    sessionId: string;
+    response: string;
+}
+export interface WsClientRequirementExpandMessage {
+    action: 'requirement:expand';
+    text: string;
+    depth?: ExpansionDepth;
+    method?: 'sdk' | 'cli';
+}
+export interface WsClientRequirementRefineMessage {
+    action: 'requirement:refine';
+    requirementId: string;
+    feedback: string;
+}
+export interface WsClientRequirementCommitMessage {
+    action: 'requirement:commit';
+    requirementId: string;
+    mode: 'issues' | 'coordinate';
+}
+export interface ExecutionStartedPayload {
+    issueId: string;
+    processId: string;
+    executor: AgentType;
+    /** Optional: updated issue for incremental client-side update */
+    issue?: import('./issue-types.js').Issue;
+}
+export interface ExecutionCompletedPayload {
+    issueId: string;
+    processId: string;
+    /** Optional: updated issue for incremental client-side update */
+    issue?: import('./issue-types.js').Issue;
+}
+export interface ExecutionFailedPayload {
+    issueId: string;
+    processId: string;
+    error: string;
+    /** Optional: updated issue for incremental client-side update */
+    issue?: import('./issue-types.js').Issue;
+}
+export declare const WS_ENDPOINT = "/ws";

package/dashboard/dist-server/shared/ws-protocol.js

@@ -0,0 +1,8 @@
+// ---------------------------------------------------------------------------
+// WebSocket protocol types — server/client message contracts
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// WS endpoint
+// ---------------------------------------------------------------------------
+export const WS_ENDPOINT = '/ws';
+//# sourceMappingURL=ws-protocol.js.map

package/dashboard/dist-server/shared/ws-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-protocol.js","sourceRoot":"","sources":["../../src/shared/ws-protocol.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6DAA6D;AAC7D,8EAA8E;AA+S9E,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC"}

package/dashboard/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "maestro-dashboard",
+  "version": "0.1.0",
+  "description": "Linear-style kanban board dashboard for Maestro",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "dev": "concurrently \"vite\" \"tsx --watch src/server/index.ts\"",
+    "build": "vite build && tsc -p tsconfig.node.json",
+    "preview": "vite preview",
+    "server": "tsx src/server/index.ts",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.node.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.77",
+    "@hono/node-server": "^1.14.0",
+    "@radix-ui/react-collapsible": "^1.1.12",
+    "@radix-ui/react-dialog": "^1.1.15",
+    "@radix-ui/react-scroll-area": "^1.2.10",
+    "@radix-ui/react-select": "^2.2.6",
+    "@radix-ui/react-slot": "^1.2.4",
+    "@radix-ui/react-tabs": "^1.1.13",
+    "chokidar": "^4.0.0",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "framer-motion": "^12.36.0",
+    "hono": "^4.7.0",
+    "lucide-react": "^0.577.0",
+    "maestro-flow": "file:..",
+    "node-cron": "^4.2.1",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-markdown": "^9.0.0",
+    "react-router-dom": "^6.30.3",
+    "react-virtuoso": "^4.18.3",
+    "remark-gfm": "^4.0.0",
+    "tailwind-merge": "^3.5.0",
+    "ws": "^8.19.0",
+    "zustand": "^5.0.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/vite": "^4.1.0",
+    "@types/node": "^22.10.0",
+    "@types/node-cron": "^3.0.11",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@types/ws": "^8.18.1",
+    "@vitejs/plugin-react": "^4.3.0",
+    "@vitest/coverage-v8": "^4.1.0",
+    "concurrently": "^9.1.0",
+    "tailwindcss": "^4.1.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vite": "^6.0.0",
+    "vitest": "^4.1.0"
+  }
+}

package/dist/agents/cli-agent-runner.d.ts

@@ -0,0 +1,20 @@
+export interface CliRunOptions {
+    prompt: string;
+    tool: string;
+    mode: 'analysis' | 'write';
+    model?: string;
+    workDir: string;
+    rule?: string;
+    execId?: string;
+    resume?: string;
+    includeDirs?: string[];
+}
+export declare class CliAgentRunner {
+    /** Resolve dashboard WS URL from env → config → default port 3001 */
+    private static getDashboardWsUrl;
+    /**
+     * Run a CLI agent to completion and return its exit code (0 = success).
+     */
+    run(options: CliRunOptions): Promise<number>;
+}
+//# sourceMappingURL=cli-agent-runner.d.ts.map

package/dist/agents/cli-agent-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-agent-runner.d.ts","sourceRoot":"","sources":["../../src/agents/cli-agent-runner.ts"],"names":[],"mappings":"AA6EA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAoKD,qBAAa,cAAc;IACzB,qEAAqE;IACrE,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAoBhC;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;CA4GnD"}