maestro-flow 0.1.4 → 0.2.1

package/dashboard/dist-server/src/server/ws/handlers/supervisor-handler.d.ts

@@ -0,0 +1,12 @@
+import { WebSocket } from 'ws';
+import type { WsHandler } from '../ws-handler.js';
+import type { WsEventType } from '../../../shared/ws-protocol.js';
+import type { SelfLearningService } from '../../supervisor/self-learning-service.js';
+import type { TaskSchedulerService } from '../../supervisor/task-scheduler-service.js';
+export declare class SupervisorWsHandler implements WsHandler {
+    private readonly learningService;
+    private readonly schedulerService;
+    readonly actions: readonly ["supervisor:learning", "supervisor:schedule"];
+    constructor(learningService: SelfLearningService, schedulerService: TaskSchedulerService);
+    handle(action: string, data: unknown, ws: WebSocket, _broadcast: (type: WsEventType, data: unknown) => void): Promise<void>;
+}

package/dashboard/dist-server/src/server/ws/handlers/supervisor-handler.js

@@ -0,0 +1,35 @@
+import { WebSocket } from 'ws';
+// ---------------------------------------------------------------------------
+// SupervisorWsHandler -- real-time supervisor data queries
+//   supervisor:learning  -> returns current learning stats
+//   supervisor:schedule  -> returns current scheduled tasks
+// ---------------------------------------------------------------------------
+export class SupervisorWsHandler {
+    learningService;
+    schedulerService;
+    actions = [
+        'supervisor:learning',
+        'supervisor:schedule',
+    ];
+    constructor(learningService, schedulerService) {
+        this.learningService = learningService;
+        this.schedulerService = schedulerService;
+    }
+    async handle(action, data, ws, _broadcast) {
+        if (ws.readyState !== WebSocket.OPEN)
+            return;
+        switch (action) {
+            case 'supervisor:learning': {
+                const stats = this.learningService.getStats();
+                ws.send(JSON.stringify({ type: 'supervisor:learning_update', data: stats }));
+                break;
+            }
+            case 'supervisor:schedule': {
+                const tasks = this.schedulerService.listTasks();
+                ws.send(JSON.stringify({ type: 'supervisor:schedule_update', data: { tasks } }));
+                break;
+            }
+        }
+    }
+}
+//# sourceMappingURL=supervisor-handler.js.map

package/dashboard/dist-server/src/server/ws/handlers/supervisor-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-handler.js","sourceRoot":"","sources":["../../../../../src/server/ws/handlers/supervisor-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAO/B,8EAA8E;AAC9E,2DAA2D;AAC3D,2DAA2D;AAC3D,4DAA4D;AAC5D,8EAA8E;AAE9E,MAAM,OAAO,mBAAmB;IAOX;IACA;IAPV,OAAO,GAAG;QACjB,qBAAqB;QACrB,qBAAqB;KACb,CAAC;IAEX,YACmB,eAAoC,EACpC,gBAAsC;QADtC,oBAAe,GAAf,eAAe,CAAqB;QACpC,qBAAgB,GAAhB,gBAAgB,CAAsB;IACtD,CAAC;IAEJ,KAAK,CAAC,MAAM,CACV,MAAc,EACd,IAAa,EACb,EAAa,EACb,UAAsD;QAEtD,IAAI,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;YAAE,OAAO;QAE7C,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,qBAAqB,CAAC,CAAC,CAAC;gBAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC;gBAC9C,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,4BAA4B,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC7E,MAAM;YACR,CAAC;YAED,KAAK,qBAAqB,CAAC,CAAC,CAAC;gBAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC;gBAChD,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,4BAA4B,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;gBACjF,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dashboard/dist-server/src/server/ws/handlers/supervisor-handler.test.d.ts

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

package/dashboard/dist-server/src/server/ws/handlers/supervisor-handler.test.js

@@ -0,0 +1,127 @@
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { SupervisorWsHandler } from './supervisor-handler.js';
+// ---------------------------------------------------------------------------
+// Mock WebSocket
+// ---------------------------------------------------------------------------
+class MockWebSocket {
+    readyState = 1; // WebSocket.OPEN
+    sent = [];
+    send(data) { this.sent.push(data); }
+}
+// ---------------------------------------------------------------------------
+// Mock services
+// ---------------------------------------------------------------------------
+class MockLearningService {
+    getStats() {
+        return {
+            totalCommands: 10,
+            uniquePatterns: 3,
+            topPatterns: [],
+            suggestions: [],
+            knowledgeBaseSize: 5,
+        };
+    }
+}
+class MockSchedulerService {
+    listTasks() {
+        return [
+            {
+                id: 'task-1',
+                name: 'Health Check',
+                cronExpression: '0 * * * *',
+                taskType: 'health-check',
+                config: {},
+                enabled: true,
+                lastRun: null,
+                nextRun: null,
+                history: [],
+            },
+        ];
+    }
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('SupervisorWsHandler', () => {
+    let handler;
+    let ws;
+    let broadcast;
+    beforeEach(() => {
+        handler = new SupervisorWsHandler(new MockLearningService(), new MockSchedulerService());
+        ws = new MockWebSocket();
+        broadcast = vi.fn();
+    });
+    describe('actions', () => {
+        it('declares supervisor:learning and supervisor:schedule actions', () => {
+            expect(handler.actions).toContain('supervisor:learning');
+            expect(handler.actions).toContain('supervisor:schedule');
+        });
+    });
+    describe('supervisor:learning', () => {
+        it('sends learning stats to websocket', async () => {
+            await handler.handle('supervisor:learning', undefined, ws, broadcast);
+            expect(ws.sent).toHaveLength(1);
+            const msg = JSON.parse(ws.sent[0]);
+            expect(msg.type).toBe('supervisor:learning_update');
+            expect(msg.data.totalCommands).toBe(10);
+            expect(msg.data.uniquePatterns).toBe(3);
+            expect(msg.data.knowledgeBaseSize).toBe(5);
+        });
+        it('does not call broadcast', async () => {
+            await handler.handle('supervisor:learning', undefined, ws, broadcast);
+            expect(broadcast).not.toHaveBeenCalled();
+        });
+    });
+    describe('supervisor:schedule', () => {
+        it('sends schedule data to websocket', async () => {
+            await handler.handle('supervisor:schedule', undefined, ws, broadcast);
+            expect(ws.sent).toHaveLength(1);
+            const msg = JSON.parse(ws.sent[0]);
+            expect(msg.type).toBe('supervisor:schedule_update');
+            expect(msg.data.tasks).toHaveLength(1);
+            expect(msg.data.tasks[0].name).toBe('Health Check');
+        });
+    });
+    describe('closed websocket', () => {
+        it('does not send when readyState is not OPEN', async () => {
+            ws.readyState = 3; // CLOSED
+            await handler.handle('supervisor:learning', undefined, ws, broadcast);
+            expect(ws.sent).toHaveLength(0);
+        });
+    });
+    describe('unknown action', () => {
+        it('does not send anything for unhandled actions', async () => {
+            await handler.handle('unknown:action', undefined, ws, broadcast);
+            expect(ws.sent).toHaveLength(0);
+        });
+    });
+    // -------------------------------------------------------------------------
+    // P1: Data format completeness
+    // -------------------------------------------------------------------------
+    describe('data format completeness', () => {
+        it('supervisor:learning response has all LearningStats fields', async () => {
+            await handler.handle('supervisor:learning', undefined, ws, broadcast);
+            const msg = JSON.parse(ws.sent[0]);
+            const data = msg.data;
+            expect(data).toHaveProperty('totalCommands');
+            expect(data).toHaveProperty('uniquePatterns');
+            expect(data).toHaveProperty('topPatterns');
+            expect(data).toHaveProperty('suggestions');
+            expect(data).toHaveProperty('knowledgeBaseSize');
+        });
+        it('supervisor:schedule response has tasks array with correct shape', async () => {
+            await handler.handle('supervisor:schedule', undefined, ws, broadcast);
+            const msg = JSON.parse(ws.sent[0]);
+            expect(msg.data).toHaveProperty('tasks');
+            expect(Array.isArray(msg.data.tasks)).toBe(true);
+            const task = msg.data.tasks[0];
+            expect(task).toHaveProperty('id');
+            expect(task).toHaveProperty('name');
+            expect(task).toHaveProperty('cronExpression');
+            expect(task).toHaveProperty('taskType');
+            expect(task).toHaveProperty('enabled');
+            expect(task).toHaveProperty('history');
+        });
+    });
+});
+//# sourceMappingURL=supervisor-handler.test.js.map

package/dashboard/dist-server/src/server/ws/handlers/supervisor-handler.test.js.map

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

package/dashboard/dist-server/src/server/ws/ws-handler.d.ts

@@ -0,0 +1,8 @@
+import type { WebSocket } from 'ws';
+import type { WsEventType } from '../../shared/ws-protocol.js';
+export interface WsHandler {
+    /** Actions this handler responds to */
+    readonly actions: readonly string[];
+    /** Handle a client message */
+    handle(action: string, data: unknown, ws: WebSocket, broadcast: (type: WsEventType, data: unknown) => void): Promise<void>;
+}

package/dashboard/dist-server/src/server/ws/ws-handler.js

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

package/dashboard/dist-server/src/server/ws/ws-handler.js.map

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

package/dashboard/dist-server/src/server/ws/ws-manager.d.ts

@@ -0,0 +1,33 @@
+import type { IncomingMessage } from 'node:http';
+import type { Duplex } from 'node:stream';
+import type { WsEventType } from '../../shared/ws-protocol.js';
+import type { DashboardEventBus } from '../state/event-bus.js';
+import type { WsHandler } from './ws-handler.js';
+export declare class WebSocketManager {
+    private readonly eventBus;
+    private readonly wss;
+    private readonly clients;
+    private readonly eventListener;
+    private readonly routingTable;
+    constructor(eventBus: DashboardEventBus, handlers: WsHandler[]);
+    /**
+     * Handle HTTP upgrade request — call from server 'upgrade' event.
+     */
+    handleUpgrade(request: IncomingMessage, socket: Duplex, head: Buffer): void;
+    /**
+     * Broadcast a typed message to all connected WS clients.
+     */
+    broadcast(type: WsEventType, data: unknown): void;
+    /**
+     * Send an error response back to the originating client.
+     */
+    private sendError;
+    /**
+     * Dispatch client messages — lookup handler from routing table and delegate.
+     */
+    private handleClientMessage;
+    /** Return the number of connected clients */
+    getClientCount(): number;
+    /** Close all clients, unsubscribe from EventBus, close WebSocketServer */
+    destroy(): void;
+}

package/dashboard/dist-server/src/server/ws/ws-manager.js

@@ -0,0 +1,124 @@
+import { WebSocketServer, WebSocket } from 'ws';
+// ---------------------------------------------------------------------------
+// WebSocketManager — manages WS clients, bridges EventBus to WS broadcast
+// ---------------------------------------------------------------------------
+export class WebSocketManager {
+    eventBus;
+    wss;
+    clients = new Set();
+    eventListener;
+    routingTable = new Map();
+    constructor(eventBus, handlers) {
+        this.eventBus = eventBus;
+        // Build routing table from handlers
+        for (const handler of handlers) {
+            for (const action of handler.actions) {
+                this.routingTable.set(action, handler);
+            }
+        }
+        this.wss = new WebSocketServer({ noServer: true });
+        // Subscribe to all EventBus events and broadcast as WsServerMessage
+        this.eventListener = (event) => {
+            this.broadcast(event.type, event.data);
+        };
+        this.eventBus.onAny(this.eventListener);
+        // Handle new connections
+        this.wss.on('connection', (ws) => {
+            this.clients.add(ws);
+            // Send initial connected message
+            const connectedMsg = {
+                type: 'connected',
+                data: null,
+                timestamp: new Date().toISOString(),
+            };
+            ws.send(JSON.stringify(connectedMsg));
+            // Handle incoming messages from client
+            ws.on('message', (raw) => {
+                try {
+                    const text = raw.toString();
+                    const msg = JSON.parse(text);
+                    this.handleClientMessage(ws, msg);
+                }
+                catch {
+                    console.warn('[WS] Failed to parse client message');
+                }
+            });
+            // Clean up on close
+            ws.on('close', () => {
+                this.clients.delete(ws);
+            });
+            ws.on('error', () => {
+                this.clients.delete(ws);
+            });
+        });
+    }
+    /**
+     * Handle HTTP upgrade request — call from server 'upgrade' event.
+     */
+    handleUpgrade(request, socket, head) {
+        this.wss.handleUpgrade(request, socket, head, (ws) => {
+            this.wss.emit('connection', ws, request);
+        });
+    }
+    /**
+     * Broadcast a typed message to all connected WS clients.
+     */
+    broadcast(type, data) {
+        if (this.clients.size === 0)
+            return;
+        const msg = {
+            type,
+            data,
+            timestamp: new Date().toISOString(),
+        };
+        const payload = JSON.stringify(msg);
+        for (const client of this.clients) {
+            if (client.readyState === WebSocket.OPEN) {
+                client.send(payload);
+            }
+        }
+    }
+    /**
+     * Send an error response back to the originating client.
+     */
+    sendError(ws, action, error) {
+        if (ws.readyState !== WebSocket.OPEN)
+            return;
+        const msg = {
+            type: 'agent:status',
+            data: { action, error },
+            timestamp: new Date().toISOString(),
+        };
+        ws.send(JSON.stringify(msg));
+    }
+    /**
+     * Dispatch client messages — lookup handler from routing table and delegate.
+     */
+    handleClientMessage(ws, msg) {
+        const handler = this.routingTable.get(msg.action);
+        if (!handler) {
+            console.log(`[WS] Unknown client action: ${msg.action}`);
+            return;
+        }
+        handler
+            .handle(msg.action, msg, ws, (type, data) => this.broadcast(type, data))
+            .catch((err) => {
+            const message = err instanceof Error ? err.message : String(err);
+            this.sendError(ws, msg.action, message);
+        });
+    }
+    /** Return the number of connected clients */
+    getClientCount() {
+        return this.clients.size;
+    }
+    /** Close all clients, unsubscribe from EventBus, close WebSocketServer */
+    destroy() {
+        this.eventBus.offAny(this.eventListener);
+        for (const client of this.clients) {
+            client.close();
+        }
+        this.clients.clear();
+        this.wss.close();
+    }
+}
+//# sourceMappingURL=ws-manager.js.map

package/dashboard/dist-server/src/server/ws/ws-manager.js.map

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

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

@@ -0,0 +1 @@
+export * from '../../../shared/agent-types.js';

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

@@ -0,0 +1,2 @@
+export * from '../../../shared/agent-types.js';
+//# sourceMappingURL=agent-types.js.map

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

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

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

@@ -0,0 +1,42 @@
+export interface CollabMember {
+    uid: string;
+    name: string;
+    email: string;
+    status: 'online' | 'offline' | 'away';
+    currentPhase?: string;
+    currentTask?: string;
+    lastSeen: string;
+    joinedAt: string;
+    role: string;
+    host: string;
+}
+export interface CollabActivityEntry {
+    ts: string;
+    user: string;
+    host: string;
+    action: string;
+    phase_id?: string;
+    task_id?: string;
+    target?: string;
+}
+export interface CollabPresence {
+    uid: string;
+    name: string;
+    status: 'online' | 'offline' | 'away';
+    lastSeen: string;
+}
+export interface CollabAggregatedActivity {
+    phase: string;
+    task: string;
+    count: number;
+    members: string[];
+    risk: 'none' | 'low' | 'medium' | 'high';
+}
+export interface CollabPreflightResult {
+    exists: boolean;
+    memberCount: number;
+    hasActivity: boolean;
+}
+export declare const COLLAB_STATUS_COLORS: Record<'online' | 'offline' | 'away', string>;
+/** Color per activity action type — shared across components */
+export declare const COLLAB_ACTION_COLORS: Record<string, string>;

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

@@ -0,0 +1,19 @@
+// ---------------------------------------------------------------------------
+// Collab Types — shared between server and client for human collaboration
+// ---------------------------------------------------------------------------
+export const COLLAB_STATUS_COLORS = {
+    online: '#22c55e',
+    offline: '#9ca3af',
+    away: '#eab308',
+};
+/** Color per activity action type — shared across components */
+export const COLLAB_ACTION_COLORS = {
+    join: '#22c55e',
+    phase_change: '#a78bfa',
+    task_update: '#34d399',
+    message: '#60a5fa',
+    discussion: '#60a5fa',
+    report: '#f59e0b',
+    sync: '#06b6d4',
+};
+//# sourceMappingURL=collab-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collab-types.js","sourceRoot":"","sources":["../../../src/shared/collab-types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,0EAA0E;AAC1E,8EAA8E;AA8C9E,MAAM,CAAC,MAAM,oBAAoB,GAAkD;IACjF,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,SAAS;CACP,CAAC;AAEX,gEAAgE;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAA2B;IAC1D,IAAI,EAAE,SAAS;IACf,YAAY,EAAE,SAAS;IACvB,WAAW,EAAE,SAAS;IACtB,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,SAAS;IACrB,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,SAAS;CACP,CAAC"}

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

@@ -0,0 +1,86 @@
+import type { AgentType } from './agent-types.js';
+import type { WorkspacePolicy } from './execution-types.js';
+export interface CommanderSafetyConfig {
+    /** Event debounce interval (ms) */
+    eventDebounceMs: number;
+    /** Auto-pause after N consecutive failures */
+    circuitBreakerThreshold: number;
+    /** Max ticks per hour (prevent runaway loops) */
+    maxTicksPerHour: number;
+    /** Max token budget per hour */
+    maxTokensPerHour: number;
+    /** File globs that Commander must not operate on */
+    protectedPaths: string[];
+}
+export interface CommanderConfig {
+    /** Tick interval (ms). Lower = more aggressive */
+    pollIntervalMs: number;
+    /** Maximum concurrent worker agents */
+    maxConcurrentWorkers: number;
+    /** Worker timeout (ms), marks stalled after this */
+    stallTimeoutMs: number;
+    /** Max retries per issue */
+    maxRetries: number;
+    /** Retry backoff interval (ms) */
+    retryBackoffMs: number;
+    /** Model used for assessment queries */
+    decisionModel: 'haiku' | 'sonnet' | 'opus';
+    /** Max exploration turns for assessment */
+    assessMaxTurns: number;
+    /** Auto-approve risk threshold: low=only low risk, medium=incl medium, high=fully auto */
+    autoApproveThreshold: 'low' | 'medium' | 'high';
+    /** Default executor agent type */
+    defaultExecutor: AgentType;
+    safety: CommanderSafetyConfig;
+    workspace: WorkspacePolicy;
+    /** Preset environment profile, overrides specific fields */
+    profile: 'development' | 'staging' | 'production' | 'custom';
+}
+export interface CommanderState {
+    status: 'idle' | 'thinking' | 'dispatching' | 'paused';
+    lastTickAt: string;
+    lastDecision: Decision | null;
+    activeWorkers: number;
+    sessionId: string;
+    tickCount: number;
+}
+export interface PriorityAction {
+    type: 'execute_issue' | 'analyze_issue' | 'plan_issue' | 'create_issue' | 'advance_phase' | 'flag_blocker';
+    /** Target identifier (ISS-xxx or phase-slug) */
+    target: string;
+    reason: string;
+    risk: 'low' | 'medium' | 'high';
+    /** Executor agent type identifier */
+    executor: string;
+}
+export interface Assessment {
+    priority_actions: PriorityAction[];
+    observations: string[];
+    risks: string[];
+}
+export interface DecisionMetrics {
+    assessDurationMs: number;
+    decideDurationMs: number;
+    totalDurationMs: number;
+}
+export interface AssessMetrics {
+    input_tokens: number;
+    output_tokens: number;
+    latency_ms: number;
+}
+export interface Decision {
+    id: string;
+    timestamp: string;
+    /** What triggered this decision (scheduled_tick, issue:created, etc.) */
+    trigger: string;
+    assessment: Assessment;
+    /** Actions approved by threshold + capacity filter */
+    actions: PriorityAction[];
+    /** Actions blocked by capacity or threshold */
+    deferred: PriorityAction[];
+    /** Timing metrics for observability */
+    metrics?: DecisionMetrics;
+    /** Agent SDK token/latency metrics from the assess() call */
+    assessMetrics?: AssessMetrics;
+}
+export declare const DEFAULT_COMMANDER_CONFIG: CommanderConfig;

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

@@ -0,0 +1,37 @@
+// ---------------------------------------------------------------------------
+// Commander Agent types — config, state, assessment, and decision interfaces
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// Default configuration
+// ---------------------------------------------------------------------------
+export const DEFAULT_COMMANDER_CONFIG = {
+    // Core Loop
+    pollIntervalMs: 30_000,
+    maxConcurrentWorkers: 3,
+    stallTimeoutMs: 300_000,
+    maxRetries: 2,
+    retryBackoffMs: 60_000,
+    // Decision
+    decisionModel: 'sonnet',
+    assessMaxTurns: 5,
+    autoApproveThreshold: 'low',
+    defaultExecutor: 'claude-code',
+    // Safety
+    safety: {
+        eventDebounceMs: 5_000,
+        circuitBreakerThreshold: 3,
+        maxTicksPerHour: 120,
+        maxTokensPerHour: 500_000,
+        protectedPaths: ['.env', '.env.*', '*.key', '*.pem', 'credentials.*'],
+    },
+    // Workspace
+    workspace: {
+        enabled: false,
+        useWorktree: true,
+        autoCleanup: true,
+        strict: false,
+    },
+    // Profile
+    profile: 'development',
+};
+//# sourceMappingURL=commander-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commander-types.js","sourceRoot":"","sources":["../../../src/shared/commander-types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6EAA6E;AAC7E,8EAA8E;AAyH9E,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,wBAAwB,GAAoB;IACvD,YAAY;IACZ,cAAc,EAAE,MAAM;IACtB,oBAAoB,EAAE,CAAC;IACvB,cAAc,EAAE,OAAO;IACvB,UAAU,EAAE,CAAC;IACb,cAAc,EAAE,MAAM;IAEtB,WAAW;IACX,aAAa,EAAE,QAAQ;IACvB,cAAc,EAAE,CAAC;IACjB,oBAAoB,EAAE,KAAK;IAC3B,eAAe,EAAE,aAAa;IAE9B,SAAS;IACT,MAAM,EAAE;QACN,eAAe,EAAE,KAAK;QACtB,uBAAuB,EAAE,CAAC;QAC1B,eAAe,EAAE,GAAG;QACpB,gBAAgB,EAAE,OAAO;QACzB,cAAc,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,CAAC;KACtE;IAED,YAAY;IACZ,SAAS,EAAE;QACT,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,KAAK;KACd;IAED,UAAU;IACV,OAAO,EAAE,aAAa;CACvB,CAAC"}