maestro-flow 0.1.4 → 0.2.0

package/dist/src/commands/spec.js

@@ -0,0 +1,147 @@
+/**
+ * Spec Command — CLI endpoint for project spec management
+ *
+ * Subcommands: load, list, init, status
+ */
+export function registerSpecCommand(program) {
+    const spec = program
+        .command('spec')
+        .description('Project spec management (init, load, list, status)');
+    // ── load ──────────────────────────────────────────────────────────────
+    spec
+        .command('load')
+        .description('Load specs matching category')
+        .option('--category <stage>', 'Filter by category: general|planning|execution|debug|test|review|validation')
+        .option('--stdin', 'Read input from stdin (Hook mode)')
+        .option('--json', 'Output as JSON')
+        .action(async (opts) => {
+        const { loadSpecs } = await import('../tools/spec-loader.js');
+        let projectPath = process.cwd();
+        if (opts.stdin) {
+            try {
+                const raw = await readStdin();
+                if (raw) {
+                    const stdinData = JSON.parse(raw);
+                    if (stdinData?.cwd && typeof stdinData.cwd === 'string') {
+                        projectPath = stdinData.cwd;
+                    }
+                }
+            }
+            catch {
+                process.stdout.write(JSON.stringify({ continue: true }));
+                process.exit(0);
+            }
+        }
+        const result = loadSpecs(projectPath, opts.category);
+        if (opts.stdin) {
+            if (result.content) {
+                const wrapped = `<project-specs>\n${result.content}\n</project-specs>`;
+                process.stdout.write(JSON.stringify({ continue: true, systemMessage: wrapped }));
+            }
+            else {
+                process.stdout.write(JSON.stringify({ continue: true }));
+            }
+            process.exit(0);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify({
+                specs: result.matchedSpecs,
+                totalLoaded: result.totalLoaded,
+                content: result.content,
+            }, null, 2));
+        }
+        else {
+            console.log(result.content || '(No specs found)');
+        }
+    });
+    // ── list ──────────────────────────────────────────────────────────────
+    spec
+        .command('list')
+        .alias('ls')
+        .description('List spec files in .workflow/specs/')
+        .action(async () => {
+        const { existsSync, readdirSync } = await import('node:fs');
+        const { join } = await import('node:path');
+        const specsDir = join(process.cwd(), '.workflow', 'specs');
+        if (!existsSync(specsDir)) {
+            console.log('No specs directory. Run "maestro spec init" to create.');
+            return;
+        }
+        const files = readdirSync(specsDir).filter(f => f.endsWith('.md'));
+        if (files.length === 0) {
+            console.log('No spec files found.');
+            return;
+        }
+        console.log(`Specs (${files.length} files)\n`);
+        for (const file of files) {
+            console.log(`  ${file}`);
+        }
+    });
+    // ── init ──────────────────────────────────────────────────────────────
+    spec
+        .command('init')
+        .description('Initialize spec system with seed documents')
+        .action(async () => {
+        const { initSpecSystem } = await import('../tools/spec-init.js');
+        console.log('Initializing spec system...');
+        const result = initSpecSystem(process.cwd());
+        if (result.directories.length > 0) {
+            console.log('\nDirectories created:');
+            for (const dir of result.directories)
+                console.log(`  + ${dir}`);
+        }
+        if (result.created.length > 0) {
+            console.log('\nSeed files created:');
+            for (const file of result.created)
+                console.log(`  + ${file}`);
+        }
+        if (result.skipped.length > 0) {
+            console.log('\nSkipped (already exist):');
+            for (const file of result.skipped)
+                console.log(`  - ${file}`);
+        }
+        if (result.directories.length === 0 && result.created.length === 0) {
+            console.log('\nSpec system already initialized. No changes made.');
+        }
+    });
+    // ── status ────────────────────────────────────────────────────────────
+    spec
+        .command('status')
+        .description('Show spec system status')
+        .action(async () => {
+        const { existsSync, readdirSync, readFileSync } = await import('node:fs');
+        const { join } = await import('node:path');
+        const specsDir = join(process.cwd(), '.workflow', 'specs');
+        const dirExists = existsSync(specsDir);
+        if (!dirExists) {
+            console.log('Spec directory: missing');
+            console.log('Run "maestro spec init" to initialize.');
+            return;
+        }
+        const files = readdirSync(specsDir).filter(f => f.endsWith('.md'));
+        console.log('Spec System Status\n');
+        console.log(`  Directory: OK`);
+        console.log(`  Files: ${files.length}\n`);
+        for (const file of files) {
+            const size = readFileSync(join(specsDir, file), 'utf-8').length;
+            console.log(`    ${file}  (${size} chars)`);
+        }
+    });
+}
+// ── Helpers ─────────────────────────────────────────────────────────────
+async function readStdin() {
+    return new Promise((resolve) => {
+        let data = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('readable', () => {
+            let chunk;
+            while ((chunk = process.stdin.read()) !== null) {
+                data += chunk;
+            }
+        });
+        process.stdin.on('end', () => resolve(data));
+        if (process.stdin.isTTY)
+            resolve('');
+    });
+}
+//# sourceMappingURL=spec.js.map

package/dist/src/commands/spec.js.map

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

package/dist/src/commands/stop.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerStopCommand(program: Command): void;
+//# sourceMappingURL=stop.d.ts.map

package/dist/src/commands/stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../../src/commands/stop.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsIzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiF1D"}

package/dist/src/commands/stop.js

@@ -0,0 +1,218 @@
+// ---------------------------------------------------------------------------
+// `maestro stop` — stop the running maestro dashboard server
+//
+// Strategy (3-stage):
+//   1. Try graceful shutdown via POST /api/shutdown
+//   2. Find process by port via netstat and kill it
+//   3. Force kill fallback (--force or when graceful fails)
+// ---------------------------------------------------------------------------
+import { exec } from 'node:child_process';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_PORT = 3001;
+const HEALTH_TIMEOUT_MS = 2000;
+const SHUTDOWN_TIMEOUT_MS = 5000;
+const POST_SHUTDOWN_WAIT_MS = 500;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function execAsync(cmd) {
+    return new Promise((resolve, reject) => {
+        exec(cmd, { timeout: 10_000 }, (err, stdout, stderr) => {
+            if (err)
+                reject(err);
+            else
+                resolve({ stdout, stderr });
+        });
+    });
+}
+/**
+ * Check if the dashboard server is running on the given port.
+ */
+async function checkHealth(port) {
+    try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), HEALTH_TIMEOUT_MS);
+        const res = await fetch(`http://127.0.0.1:${port}/api/health`, {
+            signal: controller.signal,
+        });
+        clearTimeout(timeoutId);
+        if (res.ok) {
+            return await res.json();
+        }
+        return { status: 'up' };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Request graceful shutdown via the API endpoint.
+ * Returns true if the server acknowledged and stopped.
+ */
+async function requestApiShutdown(port) {
+    try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), SHUTDOWN_TIMEOUT_MS);
+        const res = await fetch(`http://127.0.0.1:${port}/api/shutdown`, {
+            method: 'POST',
+            signal: controller.signal,
+        });
+        clearTimeout(timeoutId);
+        if (!res.ok)
+            return false;
+        // Wait for the process to actually exit
+        await new Promise(r => setTimeout(r, POST_SHUTDOWN_WAIT_MS));
+        // Verify it's gone
+        const check = await checkHealth(port);
+        return check === null; // null = no response = stopped
+    }
+    catch {
+        // Connection refused or aborted = server already stopped
+        return true;
+    }
+}
+/**
+ * Find the PID listening on the given port using platform-specific commands.
+ */
+async function findProcessOnPort(port) {
+    try {
+        if (process.platform === 'win32') {
+            const { stdout } = await execAsync(`netstat -ano | findstr :${port}`);
+            for (const line of stdout.split('\n')) {
+                const parts = line.trim().split(/\s+/);
+                // Format: TCP  0.0.0.0:3001  0.0.0.0:0  LISTENING  12345
+                if (parts.length >= 5 && parts[3] === 'LISTENING') {
+                    const localAddr = parts[1] ?? '';
+                    if (localAddr.endsWith(`:${port}`)) {
+                        const pid = parts[4];
+                        if (pid && /^[1-9]\d*$/.test(pid))
+                            return pid;
+                    }
+                }
+            }
+        }
+        else {
+            // Unix/macOS: lsof
+            const { stdout } = await execAsync(`lsof -i :${port} -t -sTCP:LISTEN`);
+            const pid = stdout.trim().split('\n')[0]?.trim();
+            if (pid && /^[1-9]\d*$/.test(pid))
+                return pid;
+        }
+    }
+    catch {
+        // Command failed — no process found
+    }
+    return null;
+}
+/**
+ * Kill a process by PID using platform-specific commands.
+ */
+async function killProcess(pid, force) {
+    try {
+        if (process.platform === 'win32') {
+            const flags = force ? '/T /F' : '/T';
+            await execAsync(`taskkill /PID ${pid} ${flags}`);
+        }
+        else {
+            const signal = force ? 'KILL' : 'TERM';
+            await execAsync(`kill -${signal} ${pid}`);
+        }
+        return true;
+    }
+    catch {
+        // Fallback for Windows: PowerShell
+        if (process.platform === 'win32') {
+            try {
+                await execAsync(`powershell -Command "Stop-Process -Id ${pid} -Force"`);
+                return true;
+            }
+            catch {
+                // give up
+            }
+        }
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Command registration
+// ---------------------------------------------------------------------------
+export function registerStopCommand(program) {
+    program
+        .command('stop')
+        .description('Stop the running maestro dashboard server')
+        .option('-p, --port <port>', 'Server port', String(DEFAULT_PORT))
+        .option('-f, --force', 'Force kill the process')
+        .action(async (opts) => {
+        const port = parseInt(opts.port, 10) || DEFAULT_PORT;
+        const force = opts.force ?? false;
+        console.error('');
+        console.error('  Maestro Stop');
+        console.error('');
+        // --- Stage 1: Check if server is running ---
+        const health = await checkHealth(port);
+        if (!health) {
+            // Not running — try to find a process on the port anyway
+            const pid = await findProcessOnPort(port);
+            if (pid) {
+                console.error(`  No server response on port ${port}, but found PID ${pid}.`);
+                if (force) {
+                    console.error(`  Force killing PID ${pid}...`);
+                    const killed = await killProcess(pid, true);
+                    console.error(killed ? '  Process killed.' : '  Failed to kill process.');
+                }
+                else {
+                    console.error('  Use --force to kill it.');
+                }
+            }
+            else {
+                console.error(`  No server running on port ${port}.`);
+            }
+            console.error('');
+            return;
+        }
+        console.error(`  Server running on port ${port}`);
+        if (health.workspace) {
+            console.error(`  Workspace: ${health.workspace}`);
+        }
+        // --- Stage 2: Try graceful API shutdown ---
+        if (!force) {
+            console.error('  Requesting graceful shutdown...');
+            const stopped = await requestApiShutdown(port);
+            if (stopped) {
+                console.error('  Server stopped.');
+                console.error('');
+                return;
+            }
+            console.error('  Graceful shutdown did not complete, falling back to process kill...');
+        }
+        // --- Stage 3: Kill process by port ---
+        const pid = await findProcessOnPort(port);
+        if (!pid) {
+            // Check again — server might have stopped between stages
+            const recheck = await checkHealth(port);
+            if (!recheck) {
+                console.error('  Server stopped.');
+                console.error('');
+                return;
+            }
+            console.error('  Could not find server PID. Try manually stopping the process.');
+            console.error('');
+            return;
+        }
+        console.error(`  Killing PID ${pid}...`);
+        const killed = await killProcess(pid, true);
+        if (killed) {
+            // Verify
+            await new Promise(r => setTimeout(r, 500));
+            const recheck = await checkHealth(port);
+            console.error(recheck ? '  Warning: Server may still be running.' : '  Server stopped.');
+        }
+        else {
+            console.error('  Failed to kill process. Try stopping it manually.');
+        }
+        console.error('');
+    });
+}
+//# sourceMappingURL=stop.js.map

package/dist/src/commands/stop.js.map

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

package/dist/src/commands/team.d.ts

@@ -0,0 +1,37 @@
+import type { Command } from 'commander';
+import { type MemberRecord } from '../tools/team-members.js';
+import { type ActivityEvent } from '../tools/team-activity.js';
+export interface PreflightResult {
+    exitCode: 0 | 1 | 2;
+    warnings: string[];
+    conflicts: Array<{
+        user: string;
+        host: string;
+        action: string;
+        ts: string;
+        relative: string;
+    }>;
+}
+/**
+ * Pure preflight logic, exported for tests.
+ *
+ * Algorithm:
+ *   1. If no self → exit 0 (team mode off is a safe no-op).
+ *   2. Fetch recent activity (30 min window, clock tolerance handled by the
+ *      team-activity module).
+ *   3. Filter: same phase, different user.
+ *   4. Deduplicate by `user@host` keeping the most recent event.
+ *   5. Emit one warning line per unique teammate.
+ *
+ * `force` affects ONLY the exit code — warnings are still returned verbatim
+ * so callers can print them to stderr before continuing.
+ */
+export declare function runPreflight(phase: number, opts: {
+    force?: boolean;
+}, deps?: {
+    getSelf?: () => MemberRecord | null;
+    getActivity?: (mins: number) => ActivityEvent[];
+    now?: () => number;
+}): PreflightResult;
+export declare function registerTeamCommand(program: Command): void;
+//# sourceMappingURL=team.d.ts.map

package/dist/src/commands/team.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team.d.ts","sourceRoot":"","sources":["../../../src/commands/team.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,2BAA2B,CAAC;AAuVnC,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,EACzB,IAAI,CAAC,EAAE;IACL,OAAO,CAAC,EAAE,MAAM,YAAY,GAAG,IAAI,CAAC;IACpC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,EAAE,CAAC;IAChD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB,GACA,eAAe,CAwDjB;AA+CD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgD1D"}