specrails-desktop 2.55.0 → 2.56.0

package/cli/dist/specrails-desktop.js

@@ -1,1142 +1,76 @@
 #!/usr/bin/env node
 "use strict";
-/**
- * specrails-desktop — specrails CLI bridge
- *
- * Routes commands to the manager when running, or falls back to invoking
- * claude directly when the manager is not reachable.
- *
- * Usage:
- *   specrails-desktop implement #42           → /specrails:implement #42 (via manager or direct)
- *   specrails-desktop "any raw prompt"        → raw prompt (no /specrails: prefix)
- *   specrails-desktop --status                → print manager state
- *   specrails-desktop --jobs                  → print job history table
- *   specrails-desktop --port 5000 <command>   → use port 5000 instead of 4200
- *   specrails-desktop --help                  → print usage and exit 0
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._internal = exports.KNOWN_VERBS = void 0;
-exports.parseArgs = parseArgs;
-exports.getVersion = getVersion;
-exports.detectWebManager = detectWebManager;
-exports.formatDuration = formatDuration;
-exports.formatTokens = formatTokens;
-exports.printSummary = printSummary;
-const http_1 = __importDefault(require("http"));
-const net_1 = __importDefault(require("net"));
-const readline_1 = require("readline");
-const ws_1 = __importDefault(require("ws"));
-const path_1 = __importDefault(require("path"));
-const os_1 = __importDefault(require("os"));
-const win_spawn_1 = require("./win-spawn");
-const fs_1 = __importDefault(require("fs"));
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-const DEFAULT_PORT = 4200;
-const DETECTION_TIMEOUT_MS = 500;
-const HTTP_REQUEST_TIMEOUT_MS = 15_000;
-exports.KNOWN_VERBS = new Set([
-    'implement',
-    'batch-implement',
-    'why',
-    'get-backlog-specs',
-    'auto-propose-backlog-specs',
-    'propose-spec',
-    'refactor-recommender',
-    'health-check',
-    'compat-check',
-    'enrich',
-]);
-const EXIT_PATTERN = /\[process exited with code (\d+)/;
-// ---------------------------------------------------------------------------
-// ANSI helpers
-// ---------------------------------------------------------------------------
-const isTTY = process.stdout.isTTY === true;
-function ansi(code, text) {
-    if (!isTTY)
-        return text;
-    return `\x1b[${code}m${text}\x1b[0m`;
-}
-const dim = (t) => ansi('2', t);
-const red = (t) => ansi('31', t);
-const bold = (t) => ansi('1', t);
-const dimCyan = (t) => ansi('2;36', t);
-function cliPrefix() {
-    return dim('[specrails-desktop]');
-}
-function cliLog(msg) {
-    process.stdout.write(`${cliPrefix()} ${msg}\n`);
-}
-function cliError(msg) {
-    process.stderr.write(`${cliPrefix()} ${red(`error: ${msg}`)}\n`);
-}
-function cliWarn(msg) {
-    process.stderr.write(`${cliPrefix()} ${dim(`warning: ${msg}`)}\n`);
-}
-function parseArgs(argv) {
-    // argv is process.argv.slice(2)
-    let port = DEFAULT_PORT;
-    let projectOverride;
-    const args = [...argv];
-    // Extract --port <n> and --project <name|path> from any position
-    for (let i = 0; i < args.length; i++) {
-        if (args[i] === '--port' && i + 1 < args.length) {
-            const parsed = parseInt(args[i + 1], 10);
-            if (!isNaN(parsed)) {
-                port = parsed;
-            }
-            args.splice(i, 2);
-            i--;
-        }
-        else if (args[i] === '--project' && i + 1 < args.length) {
-            projectOverride = args[i + 1];
-            args.splice(i, 2);
-            i--;
-        }
-    }
-    if (args[0] === '--version' || args[0] === '-v') {
-        return { mode: 'version' };
-    }
-    if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
-        return { mode: 'help' };
-    }
-    if (args[0] === '--status') {
-        return { mode: 'status', port };
-    }
-    if (args[0] === '--jobs') {
-        return { mode: 'jobs', port };
-    }
-    if (args[0] === 'desktop') {
-        return { mode: 'desktop', subArgs: args.slice(1), port };
-    }
-    // Allow server-management subcommands directly without the 'desktop' prefix:
-    //   specrails-desktop start  →  specrails-desktop desktop start
-    //   specrails-desktop stop   →  specrails-desktop desktop stop
-    //   specrails-desktop add    →  specrails-desktop desktop add
-    //   etc.
-    const DESKTOP_SUBCOMMANDS = new Set(['start', 'stop', 'status', 'add', 'remove', 'list']);
-    if (DESKTOP_SUBCOMMANDS.has(args[0])) {
-        return { mode: 'desktop', subArgs: args, port };
-    }
-    const first = args[0];
-    // Slash-prefixed command: pass through unchanged
-    if (first.startsWith('/')) {
-        const resolved = args.join(' ');
-        return { mode: 'raw', resolved, port, projectOverride };
-    }
-    // Known verb: inject /specrails: prefix
-    if (exports.KNOWN_VERBS.has(first)) {
-        const resolved = `/specrails:${args.join(' ')}`;
-        return { mode: 'command', resolved, port, projectOverride };
-    }
-    // Unknown first token: treat as raw prompt
-    const resolved = args.join(' ');
-    return { mode: 'raw', resolved, port, projectOverride };
-}
-function getVersion() {
-    for (const rel of ['../package.json', '../../package.json']) {
-        try {
-            const pkgPath = path_1.default.join(__dirname, rel);
-            const pkg = JSON.parse(fs_1.default.readFileSync(pkgPath, 'utf8'));
-            if (typeof pkg.version === 'string')
-                return pkg.version;
-        }
-        catch {
-            // try next
-        }
-    }
-    return 'unknown';
-}
-function printVersion() {
-    process.stdout.write(`specrails-desktop v${getVersion()}\n`);
-}
-function printHelp() {
-    const version = getVersion();
-    process.stdout.write(`
-${bold(`specrails-desktop v${version}`)} — specrails CLI bridge
-
-${bold('Project Required:')}
-  Every command runs in the context of a project registered for the current
-  directory. Register your project once before running any commands:
-
-    ${dim('# Register your project (run once per project):')}
-    specrails-desktop add .
-
-    ${dim('# Then run commands from that directory:')}
-    specrails-desktop implement #42
-
-${bold('Usage:')}
-  specrails-desktop implement #42                Run a known specrails verb (prepends /specrails:)
-  specrails-desktop batch-implement #40 #41      Batch implementation across issues
-  specrails-desktop why                          Explain recent changes
-  specrails-desktop get-backlog-specs            View prioritized spec backlog
-  specrails-desktop auto-propose-backlog-specs   Generate new spec ideas
-  specrails-desktop propose-spec                 Explore an idea and produce a spec
-  specrails-desktop refactor-recommender        Find refactoring opportunities
-  specrails-desktop health-check                Run codebase health check
-  specrails-desktop compat-check                Check for breaking API changes
-  specrails-desktop "any raw prompt"             Pass a raw prompt directly to claude
-  specrails-desktop --status                     Print manager status and exit
-  specrails-desktop --jobs                       Print recent job history and exit
-  specrails-desktop start|stop|add|remove|list  Manage the server
-  specrails-desktop --project <name|path>        Override project (default: current directory)
-  specrails-desktop --port <n>                   Override default port (${DEFAULT_PORT})
-  specrails-desktop --version, -v               Print version and exit
-  specrails-desktop --help, -h                  Show this help text
-
-${bold('Execution paths:')}
-  Manager running → POST /api/spawn + stream logs via WebSocket
-  Manager not running → spawn claude directly with stream-json output
-`.trimStart());
-}
-function detectWebManager(port) {
-    const baseUrl = `http://127.0.0.1:${port}`;
-    return new Promise((resolve) => {
-        const timer = setTimeout(() => {
-            req.destroy();
-            resolve({ running: false, baseUrl });
-        }, DETECTION_TIMEOUT_MS);
-        const req = http_1.default.get(`${baseUrl}/api/health`, { timeout: DETECTION_TIMEOUT_MS }, (res) => {
-            clearTimeout(timer);
-            res.resume(); // drain the response
-            if (res.statusCode !== undefined && res.statusCode >= 200 && res.statusCode < 300) {
-                resolve({ running: true, baseUrl });
-            }
-            else {
-                resolve({ running: false, baseUrl });
-            }
-        });
-        req.on('error', () => {
-            clearTimeout(timer);
-            resolve({ running: false, baseUrl });
-        });
-        req.on('timeout', () => {
-            req.destroy();
-            clearTimeout(timer);
-            resolve({ running: false, baseUrl });
-        });
-    });
-}
-// ---------------------------------------------------------------------------
-// HTTP helpers
-// ---------------------------------------------------------------------------
-function loadDesktopToken() {
-    const candidates = [
-        path_1.default.join(os_1.default.homedir(), '.specrails', 'desktop.token'),
-        // Legacy fallback: pre-rename installs keep the token at hub.token until the
-        // server migrates it on next startup. Compat only — do not extend.
-        path_1.default.join(os_1.default.homedir(), '.specrails', 'hub.token'),
-    ];
-    for (const tokenPath of candidates) {
-        try {
-            const t = fs_1.default.readFileSync(tokenPath, 'utf-8').trim();
-            if (t.length >= 32)
-                return t;
-        }
-        catch {
-            // try next candidate
-        }
-    }
-    return null;
-}
-function requestTimeoutError(url, timeoutMs) {
-    return new Error(`Request to ${url} timed out after ${timeoutMs}ms`);
-}
-function httpGet(url, timeoutMs = HTTP_REQUEST_TIMEOUT_MS) {
-    return new Promise((resolve, reject) => {
-        const token = loadDesktopToken();
-        const parsed = new URL(url);
-        const headers = {};
-        if (token)
-            headers['Authorization'] = `Bearer ${token}`;
-        const options = {
-            hostname: parsed.hostname,
-            port: parsed.port,
-            path: parsed.pathname + parsed.search,
-            headers,
-        };
-        const req = http_1.default.get(options, (res) => {
-            let body = '';
-            res.on('data', (chunk) => { body += chunk; });
-            res.on('end', () => resolve({ status: res.statusCode ?? 0, body }));
-        });
-        req.setTimeout(timeoutMs, () => {
-            req.destroy(requestTimeoutError(url, timeoutMs));
-        });
-        req.on('error', reject);
-    });
-}
-function httpPost(url, payload, timeoutMs = HTTP_REQUEST_TIMEOUT_MS) {
-    return new Promise((resolve, reject) => {
-        const data = JSON.stringify(payload);
-        const urlObj = new URL(url);
-        const token = loadDesktopToken();
-        const headers = {
-            'Content-Type': 'application/json',
-            'Content-Length': Buffer.byteLength(data),
-        };
-        if (token)
-            headers['Authorization'] = `Bearer ${token}`;
-        const options = {
-            hostname: urlObj.hostname,
-            port: urlObj.port,
-            path: urlObj.pathname,
-            method: 'POST',
-            headers,
-        };
-        const req = http_1.default.request(options, (res) => {
-            let body = '';
-            res.on('data', (chunk) => { body += chunk; });
-            res.on('end', () => resolve({ status: res.statusCode ?? 0, body }));
-        });
-        req.setTimeout(timeoutMs, () => {
-            req.destroy(requestTimeoutError(url, timeoutMs));
-        });
-        req.on('error', reject);
-        req.write(data);
-        req.end();
-    });
-}
-// ---------------------------------------------------------------------------
-// Duration formatting
-// ---------------------------------------------------------------------------
-function formatDuration(ms) {
-    const totalSeconds = Math.floor(ms / 1000);
-    if (totalSeconds < 60) {
-        return `${totalSeconds}s`;
-    }
-    const minutes = Math.floor(totalSeconds / 60);
-    const seconds = totalSeconds % 60;
-    return `${minutes}m ${seconds}s`;
-}
-// ---------------------------------------------------------------------------
-// Token formatting
-// ---------------------------------------------------------------------------
-function formatTokens(n) {
-    return new Intl.NumberFormat('en-US', { useGrouping: true })
-        .format(n)
-        .replace(/,/g, ' ');
-}
-function printSummary(data) {
-    const doneLabel = isTTY ? bold('[specrails-desktop] done') : '[specrails-desktop] done';
-    const durationPart = `duration: ${formatDuration(data.durationMs)}`;
-    const costPart = data.costUsd != null ? `  cost: $${data.costUsd.toFixed(2)}` : '';
-    const tokenPart = data.totalTokens != null ? `  tokens: ${formatTokens(data.totalTokens)}` : '';
-    const exitPart = `  exit: ${data.exitCode}`;
-    process.stdout.write(`${doneLabel}  ${durationPart}${costPart}${tokenPart}${exitPart}\n`);
-}
-async function resolveProjectFromCwd(baseUrl, projectOverride) {
-    try {
-        // --project flag: resolve by path (absolute/relative) or by name
-        if (projectOverride) {
-            // Path vs name: POSIX absolute (`/…`), relative (`./…`), OR a Windows
-            // absolute (`C:\…` / `C:/…`) or any path containing a separator. Without
-            // the drive-letter/backslash cases `--project C:\repo` was mis-read as a
-            // project NAME on Windows and never matched.
-            const isPathLike = path_1.default.isAbsolute(projectOverride) ||
-                projectOverride.startsWith('.') ||
-                /^[A-Za-z]:[\\/]/.test(projectOverride) ||
-                projectOverride.includes('/') ||
-                projectOverride.includes('\\');
-            if (isPathLike) {
-                const res = await httpGet(`${baseUrl}/api/resolve?path=${encodeURIComponent(projectOverride)}`);
-                if (res.status === 200) {
-                    const data = JSON.parse(res.body);
-                    return data.project ?? null;
-                }
-            }
-            else {
-                // Resolve by name: fetch all projects and match. Names are NOT unique
-                // (two repos with the same basename register the same name), so a bare
-                // first-match `find` would silently mis-route. Auto-pick only on a
-                // unique match; on collision, error out listing the candidates.
-                const res = await httpGet(`${baseUrl}/api/projects`);
-                if (res.status === 200) {
-                    const data = JSON.parse(res.body);
-                    const matches = (data.projects ?? []).filter((p) => p.name.toLowerCase() === projectOverride.toLowerCase());
-                    if (matches.length > 1) {
-                        cliError(`--project "${projectOverride}" is ambiguous (${matches.length} projects share this name):`);
-                        for (const m of matches) {
-                            cliError(`  ${m.id}  ${m.path}`);
-                        }
-                        cliError('disambiguate with --project <path> instead of the name');
-                        return null;
-                    }
-                    return matches[0] ?? null;
-                }
-            }
-            return null;
-        }
-        // Default: resolve from CWD
-        const cwd = process.cwd();
-        const res = await httpGet(`${baseUrl}/api/resolve?path=${encodeURIComponent(cwd)}`);
-        if (res.status === 200) {
-            const data = JSON.parse(res.body);
-            return data.project ?? null;
-        }
-    }
-    catch {
-        // Resolve endpoint not available — not in Super mode
-    }
-    return null;
-}
-async function runViaWebManager(command, baseUrl, projectOverride) {
-    // Detect Super mode: check if /api/state is reachable
-    let spawnUrl = `${baseUrl}/api/spawn`;
-    let jobApiBase = `${baseUrl}/api`;
-    try {
-        const superCheck = await httpGet(`${baseUrl}/api/state`);
-        if (superCheck.status === 200) {
-            // Super mode: resolve project from CWD or --project override
-            const project = await resolveProjectFromCwd(baseUrl, projectOverride);
-            if (!project) {
-                const hint = projectOverride
-                    ? `no project found matching: ${projectOverride}`
-                    : `no project registered for the current directory.\n  Run: specrails-desktop add ${process.cwd()}`;
-                cliError(`server is running but ${hint}`);
-                return 1;
-            }
-            spawnUrl = `${baseUrl}/api/projects/${project.id}/spawn`;
-            jobApiBase = `${baseUrl}/api/projects/${project.id}`;
-            cliLog(`project: ${project.name}`);
-        }
-    }
-    catch {
-        // Single-project mode — use default paths
-    }
-    // Spawn the job
-    let spawnRes;
-    try {
-        spawnRes = await httpPost(spawnUrl, { command });
-    }
-    catch (err) {
-        cliError('failed to connect to manager');
-        return 1;
-    }
-    if (spawnRes.status === 409) {
-        cliError('manager is busy (another job is running)');
-        return 1;
-    }
-    if (spawnRes.status >= 400) {
-        let errMsg = `spawn failed with HTTP ${spawnRes.status}`;
-        try {
-            const parsed = JSON.parse(spawnRes.body);
-            if (parsed.error)
-                errMsg = parsed.error;
-        }
-        catch { /* use default */ }
-        cliError(errMsg);
-        return 1;
-    }
-    let processId;
-    try {
-        const parsed = JSON.parse(spawnRes.body);
-        // Server returns jobId; processId is the legacy field name used in LogMessage
-        processId = (parsed.jobId ?? parsed.processId) ?? '';
-        if (!processId)
-            throw new Error('missing jobId');
-    }
-    catch {
-        cliError('invalid response from /api/spawn');
-        return 1;
-    }
-    const startTime = Date.now();
-    // Connect WebSocket and stream logs
-    const wsUrl = baseUrl.replace(/^http/, 'ws');
-    const token = loadDesktopToken();
-    let exitCode = 1;
-    let resolved = false;
-    await new Promise((resolve) => {
-        const ws = new ws_1.default(wsUrl, {
-            headers: token ? { Authorization: `Bearer ${token}` } : undefined,
-        });
-        ws.on('message', (data) => {
-            let msg;
-            try {
-                msg = JSON.parse(data.toString());
-            }
-            catch {
-                return;
-            }
-            if (msg.type === 'init') {
-                // Replay only log lines from our processId
-                const initMsg = msg;
-                for (const logLine of initMsg.logBuffer) {
-                    if (logLine.processId === processId) {
-                        handleLogLine(logLine);
-                    }
-                }
-                return;
-            }
-            if (msg.type === 'log') {
-                const logMsg = msg;
-                if (logMsg.processId !== processId)
-                    return;
-                handleLogLine(logMsg);
-                return;
-            }
-            if (msg.type === 'phase') {
-                const phaseMsg = msg;
-                process.stdout.write(`  ${dimCyan(`→ [${phaseMsg.phase}] ${phaseMsg.state}`)}\n`);
-                return;
-            }
-        });
-        function handleLogLine(logMsg) {
-            if (resolved)
-                return;
-            // Check for exit signal
-            const match = EXIT_PATTERN.exec(logMsg.line);
-            if (match) {
-                exitCode = parseInt(match[1], 10);
-                resolved = true;
-                ws.close();
-                resolve();
-                return;
-            }
-            // Print to appropriate stream, preserving ANSI
-            if (logMsg.source === 'stderr') {
-                process.stderr.write(`${logMsg.line}\n`);
-            }
-            else {
-                process.stdout.write(`${logMsg.line}\n`);
-            }
-        }
-        ws.on('close', () => {
-            if (!resolved) {
-                cliWarn('lost connection to manager');
-                resolved = true;
-                resolve();
-            }
-        });
-        ws.on('error', (err) => {
-            if (!resolved) {
-                cliWarn(`WebSocket error: ${err.message}`);
-                resolved = true;
-                resolve();
-            }
-        });
-    });
-    const durationMs = Date.now() - startTime;
-    // Fetch job metadata for cost/tokens
-    let costUsd;
-    let totalTokens;
-    try {
-        const jobRes = await httpGet(`${jobApiBase}/jobs/${processId}`);
-        if (jobRes.status === 200) {
-            const parsed = JSON.parse(jobRes.body);
-            if (parsed.job) {
-                if (parsed.job.total_cost_usd != null)
-                    costUsd = parsed.job.total_cost_usd;
-                const tokensIn = parsed.job.tokens_in ?? 0;
-                const tokensOut = parsed.job.tokens_out ?? 0;
-                if (parsed.job.tokens_in != null || parsed.job.tokens_out != null) {
-                    totalTokens = tokensIn + tokensOut;
-                }
-                // Prefer server-side duration when available
-                if (parsed.job.duration_ms != null) {
-                    printSummary({ durationMs: parsed.job.duration_ms, costUsd, totalTokens, exitCode });
-                    return exitCode;
-                }
-            }
-        }
-    }
-    catch { /* fall through to duration-only summary */ }
-    printSummary({ durationMs, costUsd, totalTokens, exitCode });
-    return exitCode;
-}
-async function runDirect(command) {
-    const startTime = Date.now();
-    const args = [
-        '--dangerously-skip-permissions',
-        // `-p` takes a SINGLE operand — the whole prompt. Splitting on whitespace
-        // (the old `...command.trim().split(/\s+/)`) shattered multi-word prompts
-        // into stray positionals and lost quoting/whitespace. Pass it intact.
-        '-p',
-        command.trim(),
-        '--output-format', 'stream-json',
-        '--verbose',
-    ];
-    let child;
-    try {
-        // Windows: `claude` is `claude.cmd`; spawnCli routes through cross-spawn so
-        // the shim resolves and multi-line args survive (raw `spawn(shell:false)`
-        // threw ENOENT/EINVAL on Windows even with claude installed).
-        child = (0, win_spawn_1.spawnCli)('claude', args, {
-            env: process.env,
-            shell: false,
-        });
-    }
-    catch (err) {
-        const code = err.code;
-        if (code === 'ENOENT') {
-            cliError('claude binary not found');
-        }
-        else {
-            cliError(`failed to spawn claude: ${err.message}`);
-        }
-        return 1;
-    }
-    let resultData;
-    // Stderr: pass through unchanged
-    child.stderr?.pipe(process.stderr);
-    // Stdout: parse NDJSON line by line
-    const rl = (0, readline_1.createInterface)({ input: child.stdout, crlfDelay: Infinity });
-    rl.on('line', (line) => {
-        if (!line.trim())
-            return;
-        let parsed = null;
-        try {
-            parsed = JSON.parse(line);
-        }
-        catch {
-            // Non-JSON line: print as-is
-            process.stdout.write(`${line}\n`);
-            return;
-        }
-        if (parsed.type === 'assistant') {
-            // Real claude emits assistant text as `type:'assistant'` with
-            // `message.content[]` `{type:'text', text}` blocks (mirror
-            // parseClaudeStreamLine). The legacy `type:'text'`/`content` shape is
-            // kept as a fallback for older/synthetic streams.
-            const msg = parsed.message;
-            const text = (msg?.content ?? [])
-                .filter((b) => b.type === 'text')
-                .map((b) => b.text ?? '')
-                .join('');
-            if (text)
-                process.stdout.write(`${text}\n`);
-        }
-        else if (parsed.type === 'text') {
-            const content = parsed.content ?? '';
-            if (content)
-                process.stdout.write(`${content}\n`);
-        }
-        else if (parsed.type === 'result') {
-            resultData = parsed;
-            // The `result` event also carries the final answer text on `result`.
-            if (resultData.result)
-                process.stdout.write(`${resultData.result}\n`);
-        }
-        // All other types: silently ignore
-    });
-    const exitCode = await new Promise((resolve) => {
-        child.on('close', (code) => {
-            resolve(code ?? 1);
-        });
-        child.on('error', (err) => {
-            if (err.code === 'ENOENT') {
-                cliError('claude binary not found');
-            }
-            else {
-                cliError(`claude process error: ${err.message}`);
-            }
-            resolve(1);
-        });
-    });
-    const durationMs = Date.now() - startTime;
-    let costUsd;
-    let totalTokens;
-    if (resultData) {
-        if (resultData.total_cost_usd != null)
-            costUsd = resultData.total_cost_usd;
-        const usage = resultData.usage;
-        const tokensIn = usage?.input_tokens ?? 0;
-        const tokensOut = usage?.output_tokens ?? 0;
-        if (usage?.input_tokens != null || usage?.output_tokens != null) {
-            totalTokens = tokensIn + tokensOut;
-        }
-    }
-    printSummary({ durationMs, costUsd, totalTokens, exitCode });
-    return exitCode;
-}
-// ---------------------------------------------------------------------------
-// --status handler
-// ---------------------------------------------------------------------------
-async function handleStatus(port) {
-    const baseUrl = `http://127.0.0.1:${port}`;
-    const detection = await detectWebManager(port);
-    if (!detection.running) {
-        process.stdout.write(`manager: not running (${baseUrl})\n`);
-        return 1;
-    }
-    try {
-        const healthRes = await httpGet(`${baseUrl}/api/health`);
-        if (healthRes.status !== 200) {
-            process.stdout.write(`manager: not running (${baseUrl})\n`);
-            return 1;
-        }
-        const health = JSON.parse(healthRes.body);
-        const version = health.version ? `  (v${health.version})` : '';
-        process.stdout.write(`manager: running${version}\n`);
-        process.stdout.write(`mode:        ${health.mode ?? 'unknown'}\n`);
-        if (health.projects !== undefined) {
-            process.stdout.write(`projects:    ${health.projects}\n`);
-        }
-        // Legacy mode: fetch additional per-project details from /api/state
-        if (health.mode !== 'super') {
-            const stateRes = await httpGet(`${baseUrl}/api/state`);
-            if (stateRes.status === 200) {
-                const state = JSON.parse(stateRes.body);
-                process.stdout.write(`project:     ${state.projectName ?? 'unknown'}\n`);
-                process.stdout.write(`busy:        ${state.busy ? 'true' : 'false'}\n`);
-                if (state.phases) {
-                    const phaseStr = Object.entries(state.phases)
-                        .map(([phase, st]) => `${phase}=${st}`)
-                        .join('  ');
-                    process.stdout.write(`phases:      ${phaseStr}\n`);
-                }
-            }
-        }
-        return 0;
-    }
-    catch {
-        process.stdout.write(`manager: not running (${baseUrl})\n`);
-        return 1;
-    }
-}
-function formatJobDuration(ms) {
-    if (ms == null)
-        return '-';
-    return formatDuration(ms);
-}
-function formatJobStarted(isoStr) {
-    try {
-        const d = new Date(isoStr);
-        const year = d.getFullYear();
-        const month = String(d.getMonth() + 1).padStart(2, '0');
-        const day = String(d.getDate()).padStart(2, '0');
-        const hour = String(d.getHours()).padStart(2, '0');
-        const min = String(d.getMinutes()).padStart(2, '0');
-        return `${year}-${month}-${day} ${hour}:${min}`;
-    }
-    catch {
-        return isoStr.slice(0, 16);
-    }
-}
-async function handleJobs(port) {
-    const baseUrl = `http://127.0.0.1:${port}`;
-    const detection = await detectWebManager(port);
-    if (!detection.running) {
-        cliError(`manager is not running (${baseUrl})`);
-        return 1;
-    }
-    let res;
-    try {
-        res = await httpGet(`${baseUrl}/api/jobs`);
-    }
-    catch {
-        cliError('failed to fetch job list');
-        return 1;
-    }
-    if (res.status === 501 || res.status === 404) {
-        cliLog('jobs history requires manager with SQLite persistence (#57)');
-        return 1;
-    }
-    if (res.status !== 200) {
-        cliError(`unexpected response from /api/jobs: HTTP ${res.status}`);
-        return 1;
-    }
-    let data;
-    try {
-        data = JSON.parse(res.body);
-    }
-    catch {
-        cliError('invalid response from /api/jobs');
-        return 1;
-    }
-    if (!data.jobs || data.jobs.length === 0) {
-        cliLog('no jobs recorded yet');
-        return 0;
-    }
-    // Column widths
-    const idW = 8;
-    const cmdW = 30;
-    const startW = 18;
-    const durW = 8;
-    const exitW = 4;
-    const header = [
-        'ID'.padEnd(idW),
-        'COMMAND'.padEnd(cmdW),
-        'STARTED'.padEnd(startW),
-        'DURATION'.padEnd(durW),
-        'EXIT'.padEnd(exitW),
-    ].join('  ');
-    process.stdout.write(`${bold(header)}\n`);
-    for (const job of data.jobs) {
-        const idCell = job.id.slice(0, idW).padEnd(idW);
-        const cmdCell = job.command.slice(0, cmdW).padEnd(cmdW);
-        const startCell = formatJobStarted(job.started_at).padEnd(startW);
-        const durCell = formatJobDuration(job.duration_ms).padEnd(durW);
-        const exitCell = (job.exit_code ?? '-').toString().padEnd(exitW);
-        process.stdout.write(`${idCell}  ${cmdCell}  ${startCell}  ${durCell}  ${exitCell}\n`);
-    }
-    return 0;
-}
-// ---------------------------------------------------------------------------
-// Server-management subcommand group
-// ---------------------------------------------------------------------------
-const DESKTOP_PID_FILE = path_1.default.join(os_1.default.homedir(), '.specrails', 'manager.pid');
-const DESKTOP_LOG_FILE = path_1.default.join(os_1.default.homedir(), '.specrails', 'desktop.log');
-function isPortInUse(port) {
-    return new Promise((resolve) => {
-        const srv = net_1.default.createServer();
-        srv.once('error', (err) => {
-            resolve(err.code === 'EADDRINUSE');
-        });
-        srv.once('listening', () => {
-            srv.close();
-            resolve(false);
-        });
-        srv.listen(port, '127.0.0.1');
-    });
-}
-function readPid() {
-    try {
-        const raw = fs_1.default.readFileSync(DESKTOP_PID_FILE, 'utf-8').trim();
-        const pid = parseInt(raw, 10);
-        return isNaN(pid) ? null : pid;
-    }
-    catch {
-        return null;
-    }
-}
-function isProcessRunning(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function desktopServerPath() {
-    // __dirname differs by runtime:
-    //   compiled (npm install): <root>/cli/dist/  → need ../../server/dist/index.js
-    //   tsx dev:                <root>/cli/        → need ../server/dist/index.js
-    // Try both, compiled path first.
-    const fromDist = path_1.default.resolve(__dirname, '..', '..', 'server', 'dist', 'index.js');
-    const fromSrc = path_1.default.resolve(__dirname, '..', 'server', 'dist', 'index.js');
-    const devTs = path_1.default.resolve(__dirname, '..', 'server', 'index.ts');
-    if (fs_1.default.existsSync(fromDist))
-        return fromDist;
-    if (fs_1.default.existsSync(fromSrc))
-        return fromSrc;
-    if (fs_1.default.existsSync(devTs))
-        return devTs;
-    return fromDist;
-}
-async function desktopStart(port) {
-    const pid = readPid();
-    if (pid !== null && isProcessRunning(pid)) {
-        cliLog(`server already running (pid ${pid}) on port ${port}`);
-        return 0;
-    }
-    // Check if port is already in use by another process
-    const portBusy = await isPortInUse(port);
-    if (portBusy) {
-        cliError(`port ${port} is already in use by another process`);
-        cliError(`if a previous server is stale, run: specrails-desktop stop`);
-        cliError(`or use a different port: specrails-desktop --port <port> start`);
-        return 1;
-    }
-    const serverPath = desktopServerPath();
-    const isTs = serverPath.endsWith('.ts');
-    const args = isTs
-        ? ['tsx', serverPath, '--port', String(port)]
-        : ['node', serverPath, '--port', String(port)];
-    // Ensure log dir exists and open log file for server output
-    try {
-        fs_1.default.mkdirSync(path_1.default.dirname(DESKTOP_LOG_FILE), { recursive: true });
-    }
-    catch { /* ignore */ }
-    let logFd;
-    try {
-        logFd = fs_1.default.openSync(DESKTOP_LOG_FILE, 'a');
-    }
-    catch { /* ignore — fall back to silent */ }
-    const stdio = [
-        'ignore',
-        logFd ?? 'ignore',
-        logFd ?? 'ignore',
-    ];
-    // spawnCli so a dev `tsx`(.cmd) launcher resolves on Windows and the env is
-    // SystemRoot-backfilled; for the packaged `node` path cross-spawn spawns the
-    // .exe directly (no cmd.exe wrapper), keeping `detached` clean.
-    const child = (0, win_spawn_1.spawnCli)(args[0], args.slice(1), {
-        detached: true,
-        stdio,
-        env: { ...process.env },
-    });
-    if (logFd !== undefined) {
-        try {
-            fs_1.default.closeSync(logFd);
-        }
-        catch { /* ignore */ }
-    }
-    child.unref();
-    // Poll until the server is ready (up to 15 seconds, checking every 300ms)
-    const pollTimeoutMs = 15000;
-    const pollIntervalMs = 300;
-    const startPoll = Date.now();
-    while (Date.now() - startPoll < pollTimeoutMs) {
-        await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
-        const detection = await detectWebManager(port);
-        if (detection.running) {
-            cliLog(`server started on http://127.0.0.1:${port}`);
-            return 0;
-        }
-    }
-    cliError(`server failed to start — logs: ${DESKTOP_LOG_FILE}`);
-    return 1;
-}
-async function desktopStop() {
-    const pid = readPid();
-    if (pid === null) {
-        cliLog('server is not running (no pid file)');
-        return 0;
-    }
-    if (!isProcessRunning(pid)) {
-        cliLog('server is not running (stale pid file)');
-        try {
-            fs_1.default.unlinkSync(DESKTOP_PID_FILE);
-        }
-        catch { /* ignore */ }
-        return 0;
-    }
-    try {
-        process.kill(pid, 'SIGTERM');
-        cliLog(`server stopped (pid ${pid})`);
-        return 0;
-    }
-    catch (err) {
-        cliError(`failed to stop server: ${err.message}`);
-        return 1;
-    }
-}
-async function desktopStatus(port) {
-    const pid = readPid();
-    const detection = await detectWebManager(port);
-    if (!detection.running) {
-        process.stdout.write(`server: not running\n`);
-        return 1;
-    }
-    try {
-        const res = await httpGet(`${detection.baseUrl}/api/state`);
-        const state = JSON.parse(res.body);
-        process.stdout.write(`server: running (pid ${pid ?? '?'}) on ${detection.baseUrl}\n`);
-        process.stdout.write(`projects: ${state.projectCount ?? 0}\n`);
-        if (state.projects) {
-            for (const p of state.projects) {
-                process.stdout.write(`  - ${p.name}\n`);
-            }
-        }
-        return 0;
-    }
-    catch {
-        process.stdout.write(`server: running on ${detection.baseUrl}\n`);
-        return 0;
-    }
-}
-async function desktopAdd(projectPath, port) {
-    const detection = await detectWebManager(port);
-    if (!detection.running) {
-        cliError('server is not running. Start it first with: specrails-desktop start');
-        return 1;
-    }
-    try {
-        const res = await httpPost(`${detection.baseUrl}/api/projects`, {
-            path: path_1.default.resolve(projectPath),
-        });
-        if (res.status === 201) {
-            const data = JSON.parse(res.body);
-            cliLog(`added project: ${data.project?.name ?? projectPath}`);
-            return 0;
-        }
-        else if (res.status === 409) {
-            cliLog('project already registered');
-            return 0;
-        }
-        else {
-            let errMsg = `HTTP ${res.status}`;
-            try {
-                errMsg = JSON.parse(res.body).error ?? errMsg;
-            }
-            catch { /* use default */ }
-            cliError(`failed to add project: ${errMsg}`);
-            return 1;
-        }
-    }
-    catch (err) {
-        cliError(`failed to connect to server: ${err.message}`);
-        return 1;
-    }
-}
-async function desktopRemove(projectId, port) {
-    const detection = await detectWebManager(port);
-    if (!detection.running) {
-        cliError('server is not running');
-        return 1;
-    }
-    try {
-        const deleteRes = await new Promise((resolve, reject) => {
-            const urlObj = new URL(`${detection.baseUrl}/api/projects/${projectId}`);
-            const token = loadDesktopToken();
-            const headers = {};
-            if (token)
-                headers['Authorization'] = `Bearer ${token}`;
-            const options = {
-                hostname: urlObj.hostname,
-                port: urlObj.port,
-                path: urlObj.pathname,
-                method: 'DELETE',
-                headers,
-            };
-            const req = http_1.default.request(options, (res) => {
-                let body = '';
-                res.on('data', (chunk) => { body += chunk; });
-                res.on('end', () => resolve({ status: res.statusCode ?? 0, body }));
-            });
-            req.on('error', reject);
-            req.end();
-        });
-        if (deleteRes.status === 200) {
-            cliLog(`project removed`);
-            return 0;
-        }
-        else {
-            cliError(`failed to remove project: HTTP ${deleteRes.status}`);
-            return 1;
-        }
-    }
-    catch (err) {
-        cliError(`failed to connect to server: ${err.message}`);
-        return 1;
-    }
-}
-async function desktopList(port) {
-    const detection = await detectWebManager(port);
-    if (!detection.running) {
-        cliError('server is not running');
-        return 1;
-    }
-    try {
-        const res = await httpGet(`${detection.baseUrl}/api/projects`);
-        const data = JSON.parse(res.body);
-        if (!data.projects || data.projects.length === 0) {
-            cliLog('no projects registered');
-            return 0;
-        }
-        const idW = 36;
-        const nameW = 24;
-        process.stdout.write(`${bold('ID'.padEnd(idW))}  ${bold('NAME'.padEnd(nameW))}  ${bold('PATH')}\n`);
-        for (const p of data.projects) {
-            process.stdout.write(`${p.id.padEnd(idW)}  ${p.name.padEnd(nameW)}  ${p.path}\n`);
-        }
-        return 0;
-    }
-    catch (err) {
-        cliError(`failed to fetch projects: ${err.message}`);
-        return 1;
-    }
-}
-async function handleDesktop(subArgs, port) {
-    const sub = subArgs[0];
-    if (!sub || sub === 'help' || sub === '--help' || sub === '-h') {
-        process.stdout.write(`
-${bold('specrails-desktop')} — server management
-
-${bold('Usage:')}
-  specrails-desktop start                  Start the Specrails server
-  specrails-desktop stop                   Stop the Specrails server
-  specrails-desktop status                 Show server status and registered projects
-  specrails-desktop add <path>             Register a project by path
-  specrails-desktop remove <id>            Unregister a project by ID
-  specrails-desktop list                   List all registered projects
-`.trimStart());
-        return 0;
-    }
-    if (sub === 'start') {
-        return desktopStart(port);
-    }
-    if (sub === 'stop') {
-        return desktopStop();
-    }
-    if (sub === 'status') {
-        return desktopStatus(port);
-    }
-    if (sub === 'add') {
-        const projectPath = subArgs[1];
-        if (!projectPath) {
-            cliError('usage: specrails-desktop add <path>');
-            return 1;
-        }
-        return desktopAdd(projectPath, port);
-    }
-    if (sub === 'remove') {
-        const projectId = subArgs[1];
-        if (!projectId) {
-            cliError('usage: specrails-desktop remove <id>');
-            return 1;
-        }
-        return desktopRemove(projectId, port);
-    }
-    if (sub === 'list') {
-        return desktopList(port);
-    }
-    cliError(`unknown subcommand: ${sub}`);
-    return 1;
-}
+exports._internal = exports.printSummary = exports.formatTokens = exports.formatDuration = exports.detectWebManager = exports.getVersion = exports.parseArgs = exports.KNOWN_VERBS = void 0;
+const args_1 = require("./args");
+const help_1 = require("./help");
+const status_1 = require("./status");
+const desktop_control_1 = require("./desktop-control");
+const output_1 = require("./output");
+const desktop_client_1 = require("./desktop-client");
+const run_command_1 = require("./run-command");
+const format_1 = require("./format");
+var args_2 = require("./args");
+Object.defineProperty(exports, "KNOWN_VERBS", { enumerable: true, get: function () { return args_2.KNOWN_VERBS; } });
+var args_3 = require("./args");
+Object.defineProperty(exports, "parseArgs", { enumerable: true, get: function () { return args_3.parseArgs; } });
+var help_2 = require("./help");
+Object.defineProperty(exports, "getVersion", { enumerable: true, get: function () { return help_2.getVersion; } });
+var desktop_client_2 = require("./desktop-client");
+Object.defineProperty(exports, "detectWebManager", { enumerable: true, get: function () { return desktop_client_2.detectWebManager; } });
+var format_2 = require("./format");
+Object.defineProperty(exports, "formatDuration", { enumerable: true, get: function () { return format_2.formatDuration; } });
+var format_3 = require("./format");
+Object.defineProperty(exports, "formatTokens", { enumerable: true, get: function () { return format_3.formatTokens; } });
+var output_2 = require("./output");
+Object.defineProperty(exports, "printSummary", { enumerable: true, get: function () { return output_2.printSummary; } });
 // ---------------------------------------------------------------------------
 // Main entry point
 // ---------------------------------------------------------------------------
 async function main() {
     const argv = process.argv.slice(2);
-    const parsed = parseArgs(argv);
+    const parsed = (0, args_1.parseArgs)(argv);
     if (parsed.mode === 'version') {
-        printVersion();
+        (0, help_1.printVersion)();
         process.exit(0);
     }
     if (parsed.mode === 'help') {
-        printHelp();
+        (0, help_1.printHelp)();
         process.exit(0);
     }
     if (parsed.mode === 'status') {
-        const code = await handleStatus(parsed.port);
+        const code = await (0, status_1.handleStatus)(parsed.port);
         process.exit(code);
     }
     if (parsed.mode === 'jobs') {
-        const code = await handleJobs(parsed.port);
+        const code = await (0, status_1.handleJobs)(parsed.port);
         process.exit(code);
     }
     if (parsed.mode === 'desktop') {
-        const code = await handleDesktop(parsed.subArgs, parsed.port);
+        const code = await (0, desktop_control_1.handleDesktop)(parsed.subArgs, parsed.port);
         process.exit(code);
     }
     // Command or raw: resolve command string
     const command = parsed.resolved;
     const port = parsed.port;
-    cliLog(`running: ${command}`);
-    const detection = await detectWebManager(port);
+    (0, output_1.cliLog)(`running: ${command}`);
+    const detection = await (0, desktop_client_1.detectWebManager)(port);
     let exitCode;
     const projectOverride = (parsed.mode === 'command' || parsed.mode === 'raw') ? parsed.projectOverride : undefined;
     if (detection.running) {
-        cliLog(`routing via manager at ${detection.baseUrl}`);
-        exitCode = await runViaWebManager(command, detection.baseUrl, projectOverride);
+        (0, output_1.cliLog)(`routing via manager at ${detection.baseUrl}`);
+        exitCode = await (0, run_command_1.runViaWebManager)(command, detection.baseUrl, projectOverride);
     }
     else {
-        cliLog('manager not running — invoking claude directly');
-        exitCode = await runDirect(command);
+        (0, output_1.cliLog)('manager not running — invoking claude directly');
+        exitCode = await (0, run_command_1.runDirect)(command);
     }
     process.exit(exitCode);
 }
 // Only run main() when this file is executed directly (not when imported in tests)
 if (require.main === module) {
     main().catch((err) => {
-        cliError(err.message ?? String(err));
+        (0, output_1.cliError)(err.message ?? String(err));
         process.exit(1);
     });
 }
@@ -1144,9 +78,9 @@ if (require.main === module) {
 // Test-only exports — not part of the public API
 // ---------------------------------------------------------------------------
 exports._internal = {
-    ansi, dim, red, bold, dimCyan, cliPrefix, cliLog, cliError, cliWarn,
-    httpGet, httpPost, formatJobDuration, formatJobStarted, printVersion, printHelp,
-    handleStatus, handleJobs, handleDesktop, desktopStart, desktopStop, desktopStatus, desktopAdd, desktopRemove, desktopList, desktopServerPath,
-    resolveProjectFromCwd, runViaWebManager, runDirect, isPortInUse, readPid, isProcessRunning, main,
-    isTTY, DESKTOP_PID_FILE, DESKTOP_LOG_FILE, EXIT_PATTERN, DEFAULT_PORT, DETECTION_TIMEOUT_MS, HTTP_REQUEST_TIMEOUT_MS,
+    ansi: output_1.ansi, dim: output_1.dim, red: output_1.red, bold: output_1.bold, dimCyan: output_1.dimCyan, cliPrefix: output_1.cliPrefix, cliLog: output_1.cliLog, cliError: output_1.cliError, cliWarn: output_1.cliWarn,
+    httpGet: desktop_client_1.httpGet, httpPost: desktop_client_1.httpPost, formatJobDuration: format_1.formatJobDuration, formatJobStarted: format_1.formatJobStarted, printVersion: help_1.printVersion, printHelp: help_1.printHelp,
+    handleStatus: status_1.handleStatus, handleJobs: status_1.handleJobs, handleDesktop: desktop_control_1.handleDesktop, desktopStart: desktop_control_1.desktopStart, desktopStop: desktop_control_1.desktopStop, desktopStatus: desktop_control_1.desktopStatus, desktopAdd: desktop_control_1.desktopAdd, desktopRemove: desktop_control_1.desktopRemove, desktopList: desktop_control_1.desktopList, desktopServerPath: desktop_control_1.desktopServerPath,
+    resolveProjectFromCwd: run_command_1.resolveProjectFromCwd, runViaWebManager: run_command_1.runViaWebManager, runDirect: run_command_1.runDirect, isPortInUse: desktop_control_1.isPortInUse, readPid: desktop_control_1.readPid, isProcessRunning: desktop_control_1.isProcessRunning, main,
+    isTTY: output_1.isTTY, DESKTOP_PID_FILE: desktop_control_1.DESKTOP_PID_FILE, DESKTOP_LOG_FILE: desktop_control_1.DESKTOP_LOG_FILE, EXIT_PATTERN: run_command_1.EXIT_PATTERN, DEFAULT_PORT: args_1.DEFAULT_PORT, DETECTION_TIMEOUT_MS: desktop_client_1.DETECTION_TIMEOUT_MS, HTTP_REQUEST_TIMEOUT_MS: desktop_client_1.HTTP_REQUEST_TIMEOUT_MS,
 };