fivocell 4.2.4 → 4.3.1

package/dist/cli.js

@@ -45,6 +45,7 @@ const figlet_1 = __importDefault(require("figlet"));
 const gradient_string_1 = __importDefault(require("gradient-string"));
 const database_1 = require("./core/database");
 const layers_1 = require("./layers");
+const cli_repl_1 = require("./cli-repl");
 (0, database_1.initializeDatabase)();
 const C = {
     primary: chalk_1.default.hex('#FF6B35'),
@@ -99,6 +100,13 @@ switch (cmd) {
     case 'stop':
         doStop();
         break;
+    case 'setup':
+        doSetup().catch((e) => {
+            const msg = e instanceof Error ? e.message : String(e);
+            console.log(C.warn('  Setup crashed: ' + msg));
+            process.exit(1);
+        });
+        break;
     case 'scan':
         doScan();
         break;
@@ -132,13 +140,24 @@ switch (cmd) {
     case 'mcp-config':
         doMcpConfig();
         break;
+    case 'repl':
+    case '-i':
+    case '--interactive':
+        doRepl();
+        break;
     case 'help':
     case '--help':
     case '-h':
         doHelp();
         break;
     default:
-        doStatus();
+        // If no command and TTY → open interactive REPL; else show status (safe default for scripts/automation)
+        if (!cmd && process.stdin.isTTY) {
+            doRepl();
+        }
+        else {
+            doStatus();
+        }
         break;
 }
 // ─── cell start ─────────────────────────────────────────────────────────────
@@ -152,6 +171,37 @@ function doStart() {
         firstRunGreeting();
     }
     catch { }
+    // 1. Check if daemon is already running (cheap /health probe) — if so,
+    //    skip restart and just print status. This makes `cell start` re-run safe.
+    const http = require('http');
+    const probeReq = http.request({
+        hostname: '127.0.0.1', port: 9876, path: '/health', method: 'GET', timeout: 1000,
+    }, (res) => {
+        if (res.statusCode === 200) {
+            let data = '';
+            res.on('data', (chunk) => { data += chunk ? chunk.toString() : ''; });
+            res.on('end', () => {
+                let up = 0;
+                try {
+                    up = JSON.parse(data).uptimeSeconds || 0;
+                }
+                catch { }
+                const upH = Math.floor(up / 3600);
+                const upM = Math.floor((up % 3600) / 60);
+                const upStr = upH > 0 ? `${upH}h ${upM}m` : upM > 0 ? `${upM}m` : `${up}s`;
+                console.log(C.success(`  Daemon: already running on port 9876 (uptime ${upStr})`));
+                printProjectStatusAndExit();
+            });
+        }
+        else {
+            startDaemon();
+        }
+    });
+    probeReq.on('error', () => { startDaemon(); });
+    probeReq.on('timeout', () => { probeReq.destroy(); startDaemon(); });
+    probeReq.end();
+}
+function startDaemon() {
     // 1. Kill any stale daemon (clean restart)
     try {
         const { stopDaemon } = require('./daemon/lifecycle');
@@ -196,64 +246,45 @@ function doStart() {
         console.log(C.dim('  Daemon + MCP: http://localhost:9876'));
         console.log(C.dim('  MCP endpoint: POST http://localhost:9876/mcp'));
         console.log();
-        // 3. Auto-detect project + offer to start watcher (so @cell live events
-        //    work immediately without a manual `cell watch start`).
-        try {
-            const projectName = path.basename(process.cwd());
-            const httpMod = require('http');
-            const body = JSON.stringify({
-                method: 'tools/call',
-                params: { name: 'cell_watch_status', arguments: { project: projectName } },
-            });
-            const req = httpMod.request({
-                hostname: '127.0.0.1', port: 9876, path: '/mcp', method: 'POST',
-                headers: { 'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(body) },
-            }, (res) => {
-                let data = '';
-                res.on('data', (c) => { data += c || ''; });
-                res.on('end', () => {
-                    try {
-                        const parsed = JSON.parse(data);
-                        const status = parsed?.result?.status;
-                        if (status && status.active) {
-                            console.log(C.success(`  Watcher: ${projectName} LIVE (${status.eventCount} events so far)`));
-                        }
-                        else {
-                            console.log(C.dim(`  Watcher: ${projectName} not active`));
-                            console.log(C.primary(`  Tip: run \`cell watch start ${projectName}\` to track file saves for @cell`));
-                        }
-                    }
-                    catch { /* ignore */ }
-                    console.log();
-                    console.log(C.dim('  Next: cell scan  (scan codebase + build layers)'));
-                    console.log(C.dim('  Then: cell status'));
-                    console.log();
-                    process.exit(0);
-                });
-            });
-            req.on('error', () => {
-                console.log(C.dim('  Next: cell scan  (scan codebase + build layers)'));
-                console.log(C.dim('  Then: cell status'));
-                console.log();
-                process.exit(0);
-            });
-            req.setTimeout(3000, () => { req.destroy(); process.exit(0); });
-            req.write(body);
-            req.end();
-            return;
+        // Give the daemon a moment to bind to the port, then print project status.
+        setTimeout(() => { printProjectStatusAndExit(); }, 500);
+    }
+    catch (e) {
+        console.log(C.warn('  Start failed: ' + String(e)));
+        process.exit(1);
+    }
+}
+function printProjectStatusAndExit() {
+    try {
+        const { detectProject, checkScanState, checkWatchState, checkMcpState, isDaemonRunning } = require('./core/setup');
+        const httpMod = require('http');
+        const project = detectProject(process.cwd());
+        const scan = checkScanState(process.cwd());
+        const watch = checkWatchState(project.name);
+        const mcp = checkMcpState(os.homedir());
+        console.log();
+        console.log(C.bold('  Project:'), C.num(project.name), C.dim(`(${project.source})`));
+        console.log();
+        console.log(`    ${scan.done ? C.success('OK') : C.dim('--')}  scan:   ${scan.reason}`);
+        console.log(`    ${watch.done ? C.success('OK') : C.dim('--')}  watch:  ${watch.reason}`);
+        console.log(`    ${mcp.done === mcp.total ? C.success('OK') : C.dim('--')}  mcp:    ${mcp.done}/${mcp.total} IDEs wired${mcp.needsWrite.length > 0 ? C.warn(' (need: ' + mcp.needsWrite.join(', ') + ')') : ''}`);
+        console.log();
+        const allReady = scan.done && watch.done && mcp.done === mcp.total;
+        if (allReady) {
+            console.log(C.dim('  Cell is fully ready. Use @cell in your AI chat.'));
         }
-        catch {
-            // fall through
+        else {
+            console.log(C.primary('  Run: cell setup  (one-time, idempotent) to finish setup'));
         }
+        console.log();
+        process.exit(0);
+    }
+    catch {
         console.log(C.dim('  Next: cell scan  (scan codebase + build layers)'));
         console.log(C.dim('  Then: cell status'));
         console.log();
         process.exit(0);
     }
-    catch (e) {
-        console.log(C.warn('  Start failed: ' + String(e)));
-        process.exit(1);
-    }
 }
 // ─── cell stop ──────────────────────────────────────────────────────────────
 function doStop() {
@@ -401,6 +432,129 @@ function doScan() {
         console.log();
     }
 }
+// ─── cell setup (idempotent one-time project setup) ─────────────────────────
+/**
+ * One-command setup for a new project. Runs scan + watcher + MCP config
+ * with full idempotency — safe to re-run any number of times. Skips steps
+ * that are already done and only does the missing pieces.
+ *
+ * Flags:
+ *   --project <name>  Override project name (default: package.json name or folder basename)
+ *   --no-rules        Skip writing AGENTS.md / .cursorrules
+ *   --force-rules     Overwrite existing AGENTS.md / .cursorrules
+ *   --skip-scan       Don't run scan
+ *   --skip-watch      Don't start watcher
+ *   --skip-mcp        Don't write MCP configs
+ *   --dir <path>      Watch dir (default: cwd)
+ *   --dry-run         Print what would happen, don't change anything
+ */
+async function doSetup() {
+    const banner = figlet_1.default.textSync('CELL', { font: 'ANSI Shadow', horizontalLayout: 'fitted' });
+    console.log((0, gradient_string_1.default)(['#FF6B35', '#FFAB91'])(banner));
+    console.log(C.dim('  Setting up project (idempotent)...\n'));
+    // ─── Flag parsing ─────────────────────────────────────────────────────
+    const noRules = args.includes('--no-rules');
+    const forceRules = args.includes('--force-rules');
+    const skipScan = args.includes('--skip-scan');
+    const skipWatch = args.includes('--skip-watch');
+    const skipMcp = args.includes('--skip-mcp');
+    const dryRun = args.includes('--dry-run');
+    const projectIdx = args.indexOf('--project');
+    const projectName = projectIdx > 0 ? args[projectIdx + 1] : undefined;
+    const dirIdx = args.indexOf('--dir');
+    const dir = dirIdx > 0 ? args[dirIdx + 1] : undefined;
+    try {
+        const { runSetup, detectProject, checkScanState, checkWatchState, checkMcpState, isDaemonRunning, } = require('./core/setup');
+        const cwd = process.cwd();
+        const project = detectProject(cwd, projectName);
+        console.log(C.bold(`  Project: ${C.num(project.name)}`));
+        console.log(C.dim(`  Source:  ${project.source}${project.packageJsonPath ? ' (' + project.packageJsonPath + ')' : ''}`));
+        console.log(C.dim(`  Cwd:     ${cwd}`));
+        if (dryRun)
+            console.log(C.warn('  Mode:    DRY RUN (no changes will be made)'));
+        console.log();
+        // ─── Daemon check ────────────────────────────────────────────────────
+        const daemonUp = await isDaemonRunning();
+        if (daemonUp) {
+            console.log(C.success('  [daemon] running on http://localhost:9876'));
+        }
+        else {
+            console.log(C.warn('  [daemon] not running — watcher will be skipped'));
+            console.log(C.dim('           run `cell start` to bring it up, then re-run `cell setup`'));
+        }
+        console.log();
+        // ─── Pre-flight state report ────────────────────────────────────────
+        if (!dryRun) {
+            const scan = checkScanState(cwd);
+            const watch = daemonUp ? checkWatchState(project.name) : { done: false, reason: 'daemon not running' };
+            const mcp = checkMcpState(os.homedir());
+            console.log(C.bold('  Pre-flight:'));
+            console.log(`    scan:   ${scan.done ? C.success('done') : C.dim('missing')} (${scan.reason})`);
+            console.log(`    watch:  ${watch.done ? C.success('active') : C.dim('inactive')} (${watch.reason})`);
+            console.log(`    mcp:    ${mcp.done}/${mcp.total} IDEs wired${mcp.needsWrite.length > 0 ? C.warn(' (need: ' + mcp.needsWrite.join(', ') + ')') : ''}`);
+            console.log();
+            const allDone = scan.done && watch.done && mcp.done === mcp.total;
+            if (allDone) {
+                console.log(C.success('  Already fully set up — nothing to do.'));
+                console.log(C.dim('  Tip: re-run anytime; it is safe and idempotent.'));
+                console.log();
+                return;
+            }
+        }
+        // ─── Run setup ───────────────────────────────────────────────────────
+        const start = Date.now();
+        const result = await runSetup({
+            cwd,
+            homedir: os.homedir(),
+            noRules,
+            forceRules,
+            projectName,
+            skipScan,
+            skipWatch: skipWatch || !daemonUp,
+            skipMcp,
+            dir,
+            dryRun,
+        });
+        const ms = Date.now() - start;
+        // ─── Result summary ─────────────────────────────────────────────────
+        console.log(C.bold('  Result:'));
+        console.log(`    ${result.scan.done ? C.success('OK') : C.warn('FAIL')}  scan:   ${result.scan.reason}`);
+        console.log(`    ${result.watch.done ? C.success('OK') : C.warn('FAIL')}  watch:  ${result.watch.reason}`);
+        const mcpOk = result.mcp.done === result.mcp.total;
+        console.log(`    ${mcpOk ? C.success('OK') : C.warn('PARTIAL')}  mcp:    ${result.mcp.done}/${result.mcp.total} IDEs wired${result.mcp.written.length > 0 ? ' (' + result.mcp.written.length + ' just written)' : ''}`);
+        console.log();
+        if (result.warnings.length > 0) {
+            console.log(C.warn('  Warnings:'));
+            for (const w of result.warnings)
+                console.log(C.warn(`    ! ${w}`));
+            console.log();
+        }
+        if (result.errors.length > 0) {
+            console.log(C.warn('  Errors:'));
+            for (const e of result.errors)
+                console.log(C.warn(`    x ${e}`));
+            console.log();
+        }
+        // ─── Final verdict ──────────────────────────────────────────────────
+        const allGood = result.scan.done && result.watch.done && mcpOk && result.errors.length === 0;
+        if (allGood) {
+            console.log(C.success(`  Setup complete in ${ms}ms. Cell is ready.`));
+        }
+        else {
+            console.log(C.warn(`  Setup finished in ${ms}ms with warnings (see above).`));
+        }
+        console.log();
+        console.log(C.dim('  Run: cell status     Check what Cell knows about you'));
+        console.log(C.dim('  Run: cell context   Inject @cell block into your AI prompt'));
+        console.log();
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        console.log(C.warn('  Setup failed: ' + msg));
+        console.log();
+    }
+    process.exit(0);
+}
 // ─── cell status ────────────────────────────────────────────────────────────
 function semiLabel(s) {
     if (s === 'with semicolons' || s === 'always')
@@ -1362,14 +1516,154 @@ function doMcpConfig() {
     console.log(C.dim('  Make sure `cell start` is running for tools to connect.'));
     console.log();
 }
+// ─── cell repl (interactive mode with tab completion) ────────────────────────
+/**
+ * Interactive REPL — opened by `cell` (no args) in a TTY, or by `cell repl`.
+ * User types a command (with or without leading `/`), press Enter to run.
+ * Type `/` then Tab to see all commands. Type `exit`/`quit` to leave.
+ *
+ * Tab completion: when the input starts with `/`, returns matching commands.
+ * Otherwise no completion (user is typing a command name without prefix).
+ */
+function showReplHelp() {
+    console.log();
+    console.log(C.bold('  Commands:'));
+    console.log(C.dim('  ────────'));
+    for (const [name, desc] of cli_repl_1.REPL_COMMANDS) {
+        const padded = name.padEnd(14);
+        console.log(`    ${C.primary('/' + padded)} ${C.dim(desc)}`);
+    }
+    console.log();
+    console.log(C.dim('  Type a command and press Enter. Use /<TAB> to filter.'));
+    console.log(C.dim('  Tab completion works after `/` — try typing `/s` then Tab.'));
+    console.log();
+}
+function doRepl() {
+    // Only run if stdin is a TTY. If piped (e.g. `echo help | cell`), fall back to status.
+    if (!process.stdin.isTTY) {
+        doStatus();
+        return;
+    }
+    const readline = require('readline');
+    const { spawn } = require('child_process');
+    const pathMod = require('path');
+    // Show banner
+    console.log();
+    const banner = figlet_1.default.textSync('CELL', { font: 'ANSI Shadow', horizontalLayout: 'fitted' });
+    console.log((0, gradient_string_1.default)(['#FF6B35', '#FFAB91'])(banner));
+    console.log(C.dim('  Interactive REPL — type a command, / for list, exit to quit'));
+    console.log();
+    // First-run greeting
+    try {
+        const { firstRunGreeting } = require('./first-run');
+        firstRunGreeting();
+    }
+    catch { }
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        prompt: C.primary('cell> '),
+        completer: cli_repl_1.replCompleter,
+        terminal: true,
+    });
+    // Track command history
+    const historyFile = pathMod.join(os.homedir(), '.fivo', 'cell', 'repl_history');
+    try {
+        const fsMod = require('fs');
+        if (fsMod.existsSync(historyFile)) {
+            const lines = fsMod.readFileSync(historyFile, 'utf8').split('\n').filter(Boolean);
+            // readline.history is an array; pushing to it adds to up-arrow memory
+            for (const l of lines)
+                rl.history.push(l);
+        }
+    }
+    catch { }
+    const persistHistory = () => {
+        try {
+            const fsMod = require('fs');
+            const pathMod2 = require('path');
+            fsMod.mkdirSync(pathMod2.dirname(historyFile), { recursive: true });
+            // Keep last 100 commands
+            const recent = rl.history.slice(-100);
+            fsMod.writeFileSync(historyFile, recent.join('\n') + '\n', 'utf8');
+        }
+        catch { }
+    };
+    rl.prompt();
+    rl.on('line', (line) => {
+        const trimmed = line.trim();
+        if (!trimmed) {
+            rl.prompt();
+            return;
+        }
+        // Handle exit
+        if (trimmed === 'exit' || trimmed === 'quit' || trimmed === 'q') {
+            persistHistory();
+            console.log(C.dim('  Bye!'));
+            rl.close();
+            return;
+        }
+        // Strip leading `/` if present
+        const cmd = (0, cli_repl_1.stripSlash)(trimmed);
+        // In-REPL help (no spawn overhead)
+        if (cmd === 'help' || cmd === '?') {
+            showReplHelp();
+            rl.prompt();
+            return;
+        }
+        // In-REPL version (avoid child spawn for trivial info)
+        if (cmd === 'version' || cmd === '--version' || cmd === '-v') {
+            try {
+                const pkg = require('../package.json');
+                console.log(`${C.primary('cell')} v${C.num(pkg.version)}`);
+            }
+            catch { }
+            rl.prompt();
+            return;
+        }
+        // Validate the command is known (so typos get a hint instead of a silent no-op)
+        const firstToken = cmd.split(/\s+/)[0];
+        if (!(0, cli_repl_1.isKnownCommand)(firstToken)) {
+            console.log(C.warn(`  Unknown command: ${firstToken}`));
+            console.log(C.dim('  Type `help` for the list, or `/` then Tab.'));
+            console.log();
+            rl.prompt();
+            return;
+        }
+        // Spawn cell <cmd> as child process (shares stdio so output is real-time)
+        const cellPath = pathMod.join(__dirname, 'cli.js');
+        const childArgs = cmd.split(/\s+/);
+        const child = spawn(process.execPath, [cellPath, ...childArgs], {
+            stdio: 'inherit',
+        });
+        child.on('exit', (code) => {
+            if (code !== 0 && code !== null) {
+                console.log(C.dim(`  (exit ${code})`));
+            }
+            console.log();
+            rl.prompt();
+        });
+        child.on('error', (err) => {
+            console.log(C.warn(`  Failed to run command: ${err.message}`));
+            console.log();
+            rl.prompt();
+        });
+    });
+    rl.on('close', () => {
+        persistHistory();
+        console.log();
+        process.exit(0);
+    });
+}
 // ─── cell help ──────────────────────────────────────────────────────────────
 function doHelp() {
     console.log();
     console.log(C.bold('  Cell Commands'));
     console.log(C.dim('  ─────────────'));
     console.log();
-    console.log(`  ${C.primary('cell start')}       Start daemon + MCP (port 9876)`);
+    console.log(`  ${C.primary('cell start')}       Start daemon + MCP (port 9876) — re-run safe`);
     console.log(`  ${C.primary('cell stop')}        Stop daemon`);
+    console.log(`  ${C.primary('cell setup')}       One-time project setup: scan + watcher + MCP (idempotent)`);
     console.log(`  ${C.primary('cell --version')}   Print version + daemon status`);
     console.log(`  ${C.primary('cell mcp-config')}  Auto-register cell MCP in Cursor/Antigravity/Codex/OpenCode`);
     console.log(`  ${C.primary('cell scan')}        Scan codebase + build layers`);
@@ -1385,6 +1679,7 @@ function doHelp() {
     console.log(`  ${C.primary('cell watch daemon [proj] [dir]')}  Run as long-lived watcher (for .bat)`);
     console.log(`  ${C.primary('cell blindspots [dir] [maxFiles]')}  Scan for blind spots (15+ types)`);
     console.log(`  ${C.primary('cell context [project] [tool]')}  Inject @cell context block`);
+    console.log(`  ${C.primary('cell repl')}        Interactive REPL with / completion (or just run \`cell\` in a TTY)`);
     console.log(`  ${C.primary('cell help')}        Show this help`);
     console.log();
     console.log(C.dim('  Install: npm i -g fivocell'));