maestro-flow 0.1.0

package/dist/commands/view.js

@@ -0,0 +1,337 @@
+// ---------------------------------------------------------------------------
+// `maestro view` — launch the dashboard kanban board
+//
+// If the server is already running, opens browser (reports current workspace).
+// If not, spawns the dashboard server and opens browser.
+// ---------------------------------------------------------------------------
+import { resolve, join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { spawn, execSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_PORT = 3001;
+const HEALTH_TIMEOUT_MS = 1000;
+const STARTUP_POLL_MS = 500;
+const STARTUP_MAX_WAIT_MS = 15_000;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function getDashboardDir() {
+    return resolve(fileURLToPath(import.meta.url), '..', '..', '..', 'dashboard');
+}
+async function checkHealth(host, port) {
+    // Always probe localhost — even if binding 0.0.0.0, localhost will respond
+    const probeHost = (host === '0.0.0.0' || host === '::') ? '127.0.0.1' : host;
+    try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), HEALTH_TIMEOUT_MS);
+        const res = await fetch(`http://${probeHost}:${port}/api/health`, {
+            signal: controller.signal,
+        });
+        clearTimeout(timeoutId);
+        if (res.ok) {
+            return await res.json();
+        }
+        return { status: 'up' };
+    }
+    catch {
+        return null;
+    }
+}
+function openBrowser(url) {
+    try {
+        if (process.platform === 'win32') {
+            execSync(`start "" "${url}"`, { stdio: 'ignore' });
+        }
+        else if (process.platform === 'darwin') {
+            execSync(`open "${url}"`, { stdio: 'ignore' });
+        }
+        else {
+            execSync(`xdg-open "${url}"`, { stdio: 'ignore' });
+        }
+    }
+    catch {
+        console.error(`  Could not open browser. Open manually: ${url}`);
+    }
+}
+async function waitForServer(host, port) {
+    const start = Date.now();
+    while (Date.now() - start < STARTUP_MAX_WAIT_MS) {
+        if (await checkHealth(host, port))
+            return true;
+        await new Promise(r => setTimeout(r, STARTUP_POLL_MS));
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Command registration
+// ---------------------------------------------------------------------------
+export function registerViewCommand(program) {
+    program
+        .command('view')
+        .description('Launch the maestro dashboard kanban board')
+        .option('-p, --port <port>', 'Dashboard port', String(DEFAULT_PORT))
+        .option('--host <host>', 'Bind host', '127.0.0.1')
+        .option('--path <dir>', 'Path to maestro workspace root containing .workflow/ (hot-switches running server without restart)')
+        .option('--no-browser', 'Do not open browser')
+        .option('--tui', 'Launch terminal UI instead of browser')
+        .option('--dev', 'Use Vite dev server with HMR (hot reload)')
+        .action(async (opts) => {
+        const port = parseInt(opts.port, 10) || DEFAULT_PORT;
+        const host = opts.host;
+        const browserHost = (host === '0.0.0.0' || host === '::') ? 'localhost' : host;
+        const workDir = resolve(opts.path ?? process.cwd());
+        const workflowRoot = join(workDir, '.workflow');
+        const dashboardDir = getDashboardDir();
+        console.error('');
+        console.error('  Maestro Dashboard');
+        console.error('');
+        // ------------------------------------------------------------------
+        // TUI mode: launch terminal UI
+        // ------------------------------------------------------------------
+        if (opts.tui) {
+            // Ensure dashboard server is running
+            const health = await checkHealth(host, port);
+            if (!health) {
+                // Spawn server using same logic as production mode
+                const serverEntry = join(dashboardDir, 'dist-server', 'server', 'index.js');
+                const hasBuild = existsSync(serverEntry)
+                    && existsSync(join(dashboardDir, 'dist', 'index.html'));
+                const env = {
+                    ...process.env,
+                    PORT: String(port),
+                    HOST: host,
+                    WORKFLOW_ROOT: workflowRoot,
+                };
+                if (!hasBuild) {
+                    const tsEntry = join(dashboardDir, 'src', 'server', 'index.ts');
+                    if (!existsSync(tsEntry)) {
+                        console.error(`  Error: Dashboard server not found at ${dashboardDir}`);
+                        console.error('  Run `cd dashboard && npm run build` first.');
+                        process.exit(1);
+                    }
+                    console.error(`  Starting dashboard server on port ${port}...`);
+                    const child = spawn('npx', ['tsx', tsEntry], {
+                        cwd: dashboardDir,
+                        env,
+                        stdio: ['ignore', 'pipe', 'pipe'],
+                        detached: true,
+                        shell: true,
+                        windowsHide: true,
+                    });
+                    child.stderr?.on('data', (d) => process.stderr.write(d));
+                    child.stdout?.on('data', (d) => process.stderr.write(d));
+                    child.unref();
+                }
+                else {
+                    console.error(`  Starting dashboard server on port ${port}...`);
+                    const child = spawn(process.execPath, [serverEntry], {
+                        cwd: dashboardDir,
+                        env,
+                        stdio: ['ignore', 'pipe', 'pipe'],
+                        detached: true,
+                    });
+                    child.stderr?.on('data', (d) => process.stderr.write(d));
+                    child.stdout?.on('data', (d) => process.stderr.write(d));
+                    child.unref();
+                }
+                const ready = await waitForServer(host, port);
+                if (!ready) {
+                    console.error('  Warning: Server did not respond in time.');
+                }
+            }
+            else {
+                console.error(`  Server already running on port ${port}`);
+            }
+            // Launch TUI process
+            const tuiEntry = join(dashboardDir, 'tui', 'dist', 'index.js');
+            if (!existsSync(tuiEntry)) {
+                console.error(`  Error: TUI build not found at ${tuiEntry}`);
+                console.error('  Run `cd dashboard/tui && npm run build` first.');
+                process.exit(1);
+            }
+            console.error(`  Launching TUI...`);
+            console.error('');
+            const tuiChild = spawn(process.execPath, [tuiEntry], {
+                cwd: dashboardDir,
+                env: {
+                    ...process.env,
+                    PORT: String(port),
+                    HOST: host,
+                    WORKFLOW_ROOT: workflowRoot,
+                },
+                stdio: 'inherit',
+            });
+            tuiChild.on('exit', (code) => {
+                process.exit(code ?? 0);
+            });
+            return;
+        }
+        // ------------------------------------------------------------------
+        // Dev mode: use `npm run dev` (Vite HMR + tsx --watch backend)
+        // ------------------------------------------------------------------
+        if (opts.dev) {
+            // Check if already running
+            const health = await checkHealth(host, port);
+            if (health) {
+                console.error(`  Server already running on port ${port}`);
+                if (opts.browser)
+                    openBrowser(`http://${browserHost}:${port}`);
+                console.error('');
+                return;
+            }
+            console.error(`  Starting dashboard (dev + HMR) ...`);
+            console.error(`  Backend: port ${port}`);
+            console.error(`  Workspace: ${workflowRoot}`);
+            console.error('');
+            const env = {
+                ...process.env,
+                PORT: String(port),
+                HOST: host,
+                WORKFLOW_ROOT: workflowRoot,
+            };
+            // Spawn: concurrently runs Vite dev server + tsx backend
+            const child = spawn('npm', ['run', 'dev'], {
+                cwd: dashboardDir,
+                env,
+                stdio: ['ignore', 'pipe', 'pipe'],
+                shell: true,
+                windowsHide: true,
+            });
+            // Parse Vite's actual port from output (e.g. "Local:   http://localhost:5174/")
+            let vitePort = null;
+            const vitePortRe = /Local:\s+http:\/\/localhost:(\d+)/;
+            const handleOutput = (d) => {
+                const text = d.toString();
+                process.stderr.write(d);
+                if (!vitePort) {
+                    const match = text.match(vitePortRe);
+                    if (match) {
+                        vitePort = parseInt(match[1], 10);
+                    }
+                }
+            };
+            child.stdout?.on('data', handleOutput);
+            child.stderr?.on('data', handleOutput);
+            // Wait for backend to be ready
+            const ready = await waitForServer(host, port);
+            if (!ready) {
+                console.error('  Warning: Backend server did not respond in time.');
+            }
+            const url = vitePort
+                ? `http://${browserHost}:${vitePort}`
+                : `http://${browserHost}:${port}`;
+            if (opts.browser) {
+                console.error(`  Opening ${url}`);
+                openBrowser(url);
+            }
+            console.error(`  Dashboard (dev) running at ${url}`);
+            console.error(`  HMR enabled — changes auto-reload in browser`);
+            console.error('');
+            // Keep the process alive (don't unref in dev mode)
+            process.on('SIGINT', () => {
+                child.kill('SIGTERM');
+                process.exit(0);
+            });
+            return;
+        }
+        // ------------------------------------------------------------------
+        // Production mode (existing behavior)
+        // ------------------------------------------------------------------
+        const url = `http://${browserHost}:${port}`;
+        // Check if server is already running
+        const health = await checkHealth(host, port);
+        if (health) {
+            console.error(`  Server already running on port ${port}`);
+            if (health.workspace) {
+                console.error(`  Workspace: ${health.workspace}`);
+            }
+            const currentWorkspace = health.workspace ?? '';
+            const normalizedCurrent = currentWorkspace.replace(/[\\/]+$/, '').toLowerCase();
+            const normalizedRequested = workDir.replace(/[\\/]+$/, '').toLowerCase();
+            if (normalizedCurrent !== normalizedRequested && existsSync(workflowRoot)) {
+                // Hot-switch workspace via API
+                try {
+                    const res = await fetch(`http://${host}:${port}/api/workspace`, {
+                        method: 'POST',
+                        headers: { 'Content-Type': 'application/json' },
+                        body: JSON.stringify({ path: workDir }),
+                    });
+                    if (!res.ok) {
+                        const text = await res.text().catch(() => res.statusText);
+                        console.error(`  Error: Failed to switch workspace — ${text}`);
+                        process.exit(1);
+                    }
+                    console.error(`  Workspace switched to ${workDir}`);
+                }
+                catch (err) {
+                    console.error(`  Error: Failed to switch workspace — ${err.message}`);
+                    process.exit(1);
+                }
+            }
+            if (opts.browser) {
+                console.error(`  Opening ${url}`);
+                openBrowser(url);
+            }
+            console.error('');
+            return;
+        }
+        // Spawn dashboard server
+        const serverEntry = join(dashboardDir, 'dist-server', 'server', 'index.js');
+        const hasBuild = existsSync(serverEntry)
+            && existsSync(join(dashboardDir, 'dist', 'index.html'));
+        const env = {
+            ...process.env,
+            PORT: String(port),
+            HOST: host,
+            WORKFLOW_ROOT: workflowRoot,
+        };
+        if (!hasBuild) {
+            const tsEntry = join(dashboardDir, 'src', 'server', 'index.ts');
+            if (!existsSync(tsEntry)) {
+                console.error(`  Error: Dashboard not found at ${dashboardDir}`);
+                console.error('  Run `cd dashboard && npm run build` first.');
+                process.exit(1);
+            }
+            console.error(`  Starting dashboard (dev) on port ${port}...`);
+            console.error(`  Workspace: ${workflowRoot}`);
+            const child = spawn('npx', ['tsx', tsEntry], {
+                cwd: dashboardDir,
+                env,
+                stdio: ['ignore', 'pipe', 'pipe'],
+                detached: true,
+                shell: true,
+                windowsHide: true,
+            });
+            child.stderr?.on('data', (d) => process.stderr.write(d));
+            child.stdout?.on('data', (d) => process.stderr.write(d));
+            child.unref();
+        }
+        else {
+            console.error(`  Starting dashboard on port ${port}...`);
+            console.error(`  Workspace: ${workflowRoot}`);
+            const child = spawn(process.execPath, [serverEntry], {
+                cwd: dashboardDir,
+                env,
+                stdio: ['ignore', 'pipe', 'pipe'],
+                detached: true,
+            });
+            child.stderr?.on('data', (d) => process.stderr.write(d));
+            child.stdout?.on('data', (d) => process.stderr.write(d));
+            child.unref();
+        }
+        const ready = await waitForServer(host, port);
+        if (!ready) {
+            console.error('  Warning: Server did not respond in time.');
+        }
+        if (opts.browser) {
+            console.error(`  Opening ${url}`);
+            openBrowser(url);
+        }
+        console.error(`  Dashboard running at ${url}`);
+        console.error('');
+    });
+}
+//# sourceMappingURL=view.js.map

package/dist/commands/view.js.map

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

package/dist/config/cli-tools-config.d.ts

@@ -0,0 +1,26 @@
+export interface ToolEntry {
+    enabled: boolean;
+    primaryModel: string;
+    secondaryModel?: string;
+    tags: string[];
+    type: string;
+}
+export interface CliToolsConfig {
+    version: string;
+    tools: Record<string, ToolEntry>;
+}
+/**
+ * Load CLI tools configuration from ~/.maestro/cli-tools.json.
+ * Returns a default empty config if the file does not exist or is invalid.
+ */
+export declare function loadCliToolsConfig(): Promise<CliToolsConfig>;
+export interface SelectedTool {
+    name: string;
+    entry: ToolEntry;
+}
+/**
+ * Select a tool by explicit name or fall back to the first enabled tool.
+ * Returns undefined when no tool can be resolved.
+ */
+export declare function selectTool(name: string | undefined, config: CliToolsConfig): SelectedTool | undefined;
+//# sourceMappingURL=cli-tools-config.d.ts.map

package/dist/config/cli-tools-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-tools-config.d.ts","sourceRoot":"","sources":["../../src/config/cli-tools-config.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClC;AAeD;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,cAAc,CAAC,CAQlE;AAMD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,MAAM,EAAE,cAAc,GACrB,YAAY,GAAG,SAAS,CAc1B"}

package/dist/config/cli-tools-config.js

@@ -0,0 +1,49 @@
+// ---------------------------------------------------------------------------
+// CLI Tools configuration loader
+// Reads ~/.maestro/cli-tools.json for tool selection and model routing.
+// ---------------------------------------------------------------------------
+import { readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+const DEFAULT_CONFIG = {
+    version: '1.0.0',
+    tools: {},
+};
+// ---------------------------------------------------------------------------
+// Loader
+// ---------------------------------------------------------------------------
+/**
+ * Load CLI tools configuration from ~/.maestro/cli-tools.json.
+ * Returns a default empty config if the file does not exist or is invalid.
+ */
+export async function loadCliToolsConfig() {
+    const configPath = join(homedir(), '.maestro', 'cli-tools.json');
+    try {
+        const raw = await readFile(configPath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return DEFAULT_CONFIG;
+    }
+}
+/**
+ * Select a tool by explicit name or fall back to the first enabled tool.
+ * Returns undefined when no tool can be resolved.
+ */
+export function selectTool(name, config) {
+    // Exact match by name
+    if (name && config.tools[name]?.enabled) {
+        return { name, entry: config.tools[name] };
+    }
+    // Fallback: first enabled tool in config order
+    for (const [toolName, entry] of Object.entries(config.tools)) {
+        if (entry.enabled) {
+            return { name: toolName, entry };
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=cli-tools-config.js.map

package/dist/config/cli-tools-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-tools-config.js","sourceRoot":"","sources":["../../src/config/cli-tools-config.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,iCAAiC;AACjC,wEAAwE;AACxE,8EAA8E;AAE9E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAmBjC,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,MAAM,cAAc,GAAmB;IACrC,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,EAAE;CACV,CAAC;AAEF,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC;IACjE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,cAAc,CAAC;IACxB,CAAC;AACH,CAAC;AAWD;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,IAAwB,EACxB,MAAsB;IAEtB,sBAAsB;IACtB,IAAI,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;QACxC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;IAC7C,CAAC;IAED,+CAA+C;IAC/C,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/config/cli-tools-config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli-tools-config.test.d.ts.map

package/dist/config/cli-tools-config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-tools-config.test.d.ts","sourceRoot":"","sources":["../../src/config/cli-tools-config.test.ts"],"names":[],"mappings":""}

package/dist/config/cli-tools-config.test.js

@@ -0,0 +1,59 @@
+import { describe, it, expect } from 'vitest';
+import { selectTool } from './cli-tools-config.js';
+function makeEntry(overrides = {}) {
+    return {
+        enabled: true,
+        primaryModel: 'test-model',
+        tags: [],
+        type: 'builtin',
+        ...overrides,
+    };
+}
+function makeConfig(tools = {}) {
+    return { version: '1.0.0', tools };
+}
+describe('selectTool', () => {
+    it('selects by exact name when enabled', () => {
+        const config = makeConfig({
+            gemini: makeEntry(),
+            qwen: makeEntry(),
+        });
+        const result = selectTool('gemini', config);
+        expect(result).toBeDefined();
+        expect(result.name).toBe('gemini');
+    });
+    it('returns undefined when named tool is disabled', () => {
+        const config = makeConfig({
+            gemini: makeEntry({ enabled: false }),
+        });
+        expect(selectTool('gemini', config)).toBeUndefined();
+    });
+    it('falls back to first enabled tool when name is undefined', () => {
+        const config = makeConfig({
+            disabled: makeEntry({ enabled: false }),
+            fallback: makeEntry({ enabled: true }),
+        });
+        const result = selectTool(undefined, config);
+        expect(result).toBeDefined();
+        expect(result.name).toBe('fallback');
+    });
+    it('returns undefined when no tools are enabled', () => {
+        const config = makeConfig({
+            a: makeEntry({ enabled: false }),
+            b: makeEntry({ enabled: false }),
+        });
+        expect(selectTool(undefined, config)).toBeUndefined();
+    });
+    it('returns undefined for empty tools config', () => {
+        expect(selectTool(undefined, makeConfig())).toBeUndefined();
+    });
+    it('falls back when named tool does not exist', () => {
+        const config = makeConfig({
+            existing: makeEntry(),
+        });
+        const result = selectTool('missing', config);
+        expect(result).toBeDefined();
+        expect(result.name).toBe('existing');
+    });
+});
+//# sourceMappingURL=cli-tools-config.test.js.map

package/dist/config/cli-tools-config.test.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,4 @@
+import type { MaestroConfig } from '../types/index.js';
+export declare function loadConfig(): MaestroConfig;
+export declare function saveConfig(config: MaestroConfig): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAgBvD,wBAAgB,UAAU,IAAI,aAAa,CAM1C;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAGtD"}

package/dist/config/index.js

@@ -0,0 +1,27 @@
+import { readFileSync, existsSync, writeFileSync } from 'node:fs';
+import { paths } from './paths.js';
+const DEFAULT_CONFIG = {
+    version: '0.1.0',
+    extensions: [],
+    mcp: {
+        port: 3600,
+        host: 'localhost',
+        enabledTools: ['all'],
+    },
+    workflows: {
+        templatesDir: 'templates',
+        workflowsDir: 'workflows',
+    },
+};
+export function loadConfig() {
+    if (!existsSync(paths.config)) {
+        return { ...DEFAULT_CONFIG };
+    }
+    const raw = readFileSync(paths.config, 'utf-8');
+    return { ...DEFAULT_CONFIG, ...JSON.parse(raw) };
+}
+export function saveConfig(config) {
+    paths.ensure(paths.home);
+    writeFileSync(paths.config, JSON.stringify(config, null, 2));
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,MAAM,cAAc,GAAkB;IACpC,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,EAAE;IACd,GAAG,EAAE;QACH,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,WAAW;QACjB,YAAY,EAAE,CAAC,KAAK,CAAC;KACtB;IACD,SAAS,EAAE;QACT,YAAY,EAAE,WAAW;QACzB,YAAY,EAAE,WAAW;KAC1B;CACF,CAAC;AAEF,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/B,CAAC;IACD,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAqB;IAC9C,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzB,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/dist/config/paths.d.ts

@@ -0,0 +1,15 @@
+export declare const paths: {
+    readonly home: string;
+    readonly config: string;
+    readonly extensions: string;
+    readonly data: string;
+    readonly logs: string;
+    readonly cliHistory: string;
+    readonly project: (root: string) => {
+        root: string;
+        workflow: string;
+        templates: string;
+    };
+    readonly ensure: (...dirs: string[]) => void;
+};
+//# sourceMappingURL=paths.d.ts.map

package/dist/config/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,KAAK;;;;;;;6BAQF,MAAM;;;;;+BAQJ,MAAM,EAAE;CAOhB,CAAC"}

package/dist/config/paths.js

@@ -0,0 +1,27 @@
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { existsSync, mkdirSync } from 'node:fs';
+const MAESTRO_HOME = process.env.MAESTRO_HOME ?? join(homedir(), '.maestro');
+export const paths = {
+    home: MAESTRO_HOME,
+    config: join(MAESTRO_HOME, 'config.json'),
+    extensions: join(MAESTRO_HOME, 'extensions'),
+    data: join(MAESTRO_HOME, 'data'),
+    logs: join(MAESTRO_HOME, 'logs'),
+    cliHistory: join(MAESTRO_HOME, 'cli-history'),
+    project(root) {
+        return {
+            root: resolve(root),
+            workflow: join(root, '.workflow'),
+            templates: join(root, 'templates'),
+        };
+    },
+    ensure(...dirs) {
+        for (const dir of dirs) {
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+        }
+    },
+};
+//# sourceMappingURL=paths.js.map

package/dist/config/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEhD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC;IACzC,UAAU,EAAE,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC;IAC5C,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC;IAChC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC;IAChC,UAAU,EAAE,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC;IAE7C,OAAO,CAAC,IAAY;QAClB,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC;YACnB,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;YACjC,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;SACnC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,GAAG,IAAc;QACtB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;CACO,CAAC"}

package/dist/config/template-discovery.d.ts

@@ -0,0 +1,32 @@
+export interface TemplateMeta {
+    name: string;
+    category: string;
+    path: string;
+}
+export declare function getPromptsDir(): string;
+export declare function getProtocolsDir(): string;
+/**
+ * Scan the prompts directory and build an in-memory index of templates.
+ * Results are cached — call with forceRescan=true to invalidate.
+ */
+export declare function scanTemplates(forceRescan?: boolean): Promise<Map<string, TemplateMeta>>;
+/**
+ * Find a template by full name or short name (without category prefix).
+ * Returns the TemplateMeta or undefined.
+ */
+export declare function findTemplate(nameOrShort: string): Promise<TemplateMeta | undefined>;
+/**
+ * Load a template file content by name (full or short).
+ * Returns the file content or null if not found.
+ */
+export declare function loadTemplate(nameOrShort: string): Promise<string | null>;
+/**
+ * Load a mode-specific protocol file.
+ * Returns the protocol content or null if not found.
+ */
+export declare function loadProtocol(mode: 'analysis' | 'write'): Promise<string | null>;
+/**
+ * List all available template names grouped by category.
+ */
+export declare function listTemplates(): Promise<Record<string, string[]>>;
+//# sourceMappingURL=template-discovery.d.ts.map

package/dist/config/template-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-discovery.d.ts","sourceRoot":"","sources":["../../src/config/template-discovery.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AA2BD,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAMD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,WAAW,UAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CA0B3F;AAMD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAiBzF;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS9E;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOrF;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAYvE"}