fivocell 4.2.3 → 4.3.0

package/dist/__tests__/antigravity-rich-format.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=antigravity-rich-format.test.d.ts.map

package/dist/__tests__/antigravity-rich-format.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"antigravity-rich-format.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/antigravity-rich-format.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/antigravity-rich-format.test.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const prompt_builder_1 = require("../core/prompt-builder");
+const mockDb = {
+    prepare: jest.fn(),
+};
+jest.mock('../core/database', () => ({
+    getDb: () => mockDb,
+}));
+function fakeStmt(rows) {
+    return { all: () => rows, get: () => rows[0] || undefined };
+}
+describe('formatForAntigravity rich output (v4.2.4)', () => {
+    function setupMocks(opts = {}) {
+        const ts = new Date().toISOString();
+        mockDb.prepare.mockReset();
+        mockDb.prepare.mockImplementation((sql) => {
+            const s = sql.trim().toUpperCase();
+            if (s.startsWith('SELECT * FROM DEVELOPER_PROFILES')) {
+                return fakeStmt([{ id: 1, project: 'Uos', files_scanned: 100, total_lines: 50000, scanned_at: ts }]);
+            }
+            if (s.startsWith('SELECT * FROM SCANS')) {
+                return fakeStmt([{ id: 1, project: 'Uos', started_at: ts, completed_at: ts, files_scanned: 100 }]);
+            }
+            if (s.startsWith('SELECT PATTERN_TYPE, PATTERN_VALUE, CATEGORY, COUNT, TRUST_SCORE FROM CODE_PATTERNS')) {
+                if (s.includes("CATEGORY = 'BLIND_SPOTS'") || s.includes("CATEGORY = 'BLIND_SPOTS'")) {
+                    return fakeStmt(opts.blindSpots || []);
+                }
+                return fakeStmt([{ pattern_type: 'naming', pattern_value: 'camelCase', category: 'naming', count: 10, trust_score: 90 }]);
+            }
+            // Production readBlindSpots query (no CATEGORY column in SELECT)
+            if (s.startsWith("SELECT PATTERN_TYPE, PATTERN_VALUE, COUNT, TRUST_SCORE FROM CODE_PATTERNS") || s.includes("FROM CODE_PATTERNS WHERE CATEGORY = 'BLIND_SPOTS'")) {
+                return fakeStmt(opts.blindSpots || []);
+            }
+            if (s.startsWith('SELECT * FROM ERROR_LOG'))
+                return fakeStmt([]);
+            if (s.startsWith('SELECT PATTERN_VALUE FROM CODE_PATTERNS'))
+                return fakeStmt([]);
+            if (s.startsWith('SELECT * FROM SESSIONS'))
+                return fakeStmt([]);
+            if (s.startsWith('SELECT * FROM LIVE_EVENTS'))
+                return fakeStmt(opts.liveEvents || []);
+            if (s.includes('SESSION_APPROACHES') && s.includes('GROUP BY'))
+                return fakeStmt([]);
+            if (s.startsWith('SELECT FILE_PATH') && s.includes('SESSION_FILES')) {
+                return fakeStmt(opts.mostTouched || []);
+            }
+            if (s.startsWith('SELECT * FROM SESSION_QUESTIONS'))
+                return fakeStmt([]);
+            return fakeStmt([]);
+        });
+    }
+    it('includes blind_spots in YAML when present', () => {
+        setupMocks({
+            blindSpots: [
+                { pattern_type: 'async_without_trycatch', pattern_value: '81/191', count: 81, trust_score: 95 },
+                { pattern_type: 'missing_return_types', pattern_value: '176', count: 176, trust_score: 90 },
+            ],
+        });
+        const ctx = (0, prompt_builder_1.buildContext)('Uos', 'antigravity');
+        const out = (0, prompt_builder_1.formatContextForTool)(ctx, 'antigravity', 'Uos');
+        expect(out).toContain('blind_spots:');
+        expect(out).toContain('[81x');
+    });
+    it('includes last_live_file fallback when no session exists', () => {
+        const eventTs = new Date(Date.now() - 60_000).toISOString();
+        setupMocks({
+            liveEvents: [{ id: 1, project: 'Uos', event_type: 'file_save', file_path: 'src/Zavi.tsx', created_at: eventTs }],
+        });
+        const ctx = (0, prompt_builder_1.buildContext)('Uos', 'antigravity');
+        const out = (0, prompt_builder_1.formatContextForTool)(ctx, 'antigravity', 'Uos');
+        expect(out).toContain('last_live_file:');
+        expect(out).toContain('file_save');
+        expect(out).toContain('src/Zavi.tsx');
+        expect(out).toContain('no session open');
+    });
+    it('includes hot_files section when session_files data exists', () => {
+        setupMocks({
+            mostTouched: [
+                { file_path: 'src/App.tsx', total_touches: 10, session_count: 3, last_touched: new Date().toISOString() },
+                { file_path: 'server/index.ts', total_touches: 8, session_count: 2, last_touched: new Date().toISOString() },
+            ],
+        });
+        const ctx = (0, prompt_builder_1.buildContext)('Uos', 'antigravity');
+        const out = (0, prompt_builder_1.formatContextForTool)(ctx, 'antigravity', 'Uos');
+        expect(out).toContain('hot_files:');
+        expect(out).toContain('src/App.tsx');
+        expect(out).toContain('touches: 10');
+    });
+    it('includes style summary line', () => {
+        setupMocks();
+        const ctx = (0, prompt_builder_1.buildContext)('Uos', 'antigravity');
+        const out = (0, prompt_builder_1.formatContextForTool)(ctx, 'antigravity', 'Uos');
+        expect(out).toMatch(/style: "/);
+    });
+    it('routes opencode tool name to formatForAntigravity (rich YAML)', () => {
+        setupMocks();
+        const ctx = (0, prompt_builder_1.buildContext)('Uos', 'opencode');
+        const out = (0, prompt_builder_1.formatContextForTool)(ctx, 'opencode', 'Uos');
+        expect(out).toContain('## Cell Context — Structured');
+        expect(out).toContain('project: Uos');
+    });
+    it('routes gemini tool name to formatForAntigravity', () => {
+        setupMocks();
+        const ctx = (0, prompt_builder_1.buildContext)('Uos', 'gemini');
+        const out = (0, prompt_builder_1.formatContextForTool)(ctx, 'gemini', 'Uos');
+        expect(out).toContain('## Cell Context — Structured');
+    });
+});
+//# sourceMappingURL=antigravity-rich-format.test.js.map

package/dist/__tests__/antigravity-rich-format.test.js.map

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

package/dist/__tests__/setup.test.d.ts

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

package/dist/__tests__/setup.test.d.ts.map

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

package/dist/__tests__/setup.test.js

@@ -0,0 +1,186 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const setup_1 = require("../core/setup");
+describe('setup (idempotency checks)', () => {
+    let tmpDir;
+    let homedir;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cell-setup-'));
+        homedir = fs.mkdtempSync(path.join(os.tmpdir(), 'cell-setup-home-'));
+    });
+    afterEach(() => {
+        try {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        }
+        catch { }
+        try {
+            fs.rmSync(homedir, { recursive: true, force: true });
+        }
+        catch { }
+    });
+    describe('detectProject', () => {
+        it('uses package.json name when present', () => {
+            const pkg = { name: 'my-cool-app', version: '1.0.0' };
+            fs.writeFileSync(path.join(tmpDir, 'package.json'), JSON.stringify(pkg), 'utf8');
+            const result = (0, setup_1.detectProject)(tmpDir);
+            expect(result.name).toBe('my-cool-app');
+            expect(result.source).toBe('package.json');
+            expect(result.packageJsonPath).toBe(path.join(tmpDir, 'package.json'));
+        });
+        it('falls back to folder basename when no package.json', () => {
+            const subdir = path.join(tmpDir, 'no-pkg-here');
+            fs.mkdirSync(subdir);
+            const result = (0, setup_1.detectProject)(subdir);
+            expect(result.name).toBe('no-pkg-here');
+            expect(result.source).toBe('folder-basename');
+        });
+        it('uses override when provided', () => {
+            fs.writeFileSync(path.join(tmpDir, 'package.json'), JSON.stringify({ name: 'real-name' }), 'utf8');
+            const result = (0, setup_1.detectProject)(tmpDir, 'override-name');
+            expect(result.name).toBe('override-name');
+            expect(result.source).toBe('override');
+        });
+        it('ignores malformed package.json', () => {
+            fs.writeFileSync(path.join(tmpDir, 'package.json'), '{ not valid json', 'utf8');
+            const result = (0, setup_1.detectProject)(tmpDir);
+            expect(result.source).toBe('folder-basename');
+        });
+        it('ignores package.json without a name field', () => {
+            fs.writeFileSync(path.join(tmpDir, 'package.json'), JSON.stringify({ version: '1.0.0' }), 'utf8');
+            const result = (0, setup_1.detectProject)(tmpDir);
+            expect(result.source).toBe('folder-basename');
+        });
+    });
+    describe('checkScanState', () => {
+        it('returns done=true when .cell/personal/ has files', () => {
+            const personalDir = path.join(tmpDir, '.cell', 'personal');
+            fs.mkdirSync(personalDir, { recursive: true });
+            fs.writeFileSync(path.join(personalDir, 'profile.json'), '{}', 'utf8');
+            const state = (0, setup_1.checkScanState)(tmpDir);
+            expect(state.done).toBe(true);
+            expect(state.reason).toContain('1 files');
+            expect(state.personalDir).toBe(personalDir);
+            expect(state.scannedAt).toBeTruthy();
+        });
+        it('returns done=true when AGENTS.md exists (even with no .cell/personal)', () => {
+            fs.writeFileSync(path.join(tmpDir, 'AGENTS.md'), '# user content', 'utf8');
+            const state = (0, setup_1.checkScanState)(tmpDir);
+            expect(state.done).toBe(true);
+            expect(state.reason).toContain('AGENTS.md');
+        });
+        it('returns done=false when neither exists', () => {
+            const state = (0, setup_1.checkScanState)(tmpDir);
+            expect(state.done).toBe(false);
+            expect(state.reason).toContain('no ');
+        });
+        it('returns done=false when .cell/personal exists but is empty', () => {
+            fs.mkdirSync(path.join(tmpDir, '.cell', 'personal'), { recursive: true });
+            const state = (0, setup_1.checkScanState)(tmpDir);
+            expect(state.done).toBe(false);
+        });
+    });
+    describe('checkMcpState', () => {
+        it('reports all IDEs as needsWrite when no config files exist', () => {
+            // homedir is empty -> none of the IDE config paths exist
+            const state = (0, setup_1.checkMcpState)(homedir);
+            expect(state.total).toBeGreaterThan(0);
+            expect(state.done).toBe(0);
+            expect(state.skipped).toBe(0);
+            expect(state.needsWrite.length).toBe(state.total);
+            expect(state.needsWrite).toContain('Cursor');
+        });
+        it('reports done=N when N IDE config files have fivo-cell wired', () => {
+            // Write a Cursor config with fivo-cell already wired
+            const cursorDir = path.join(homedir, '.cursor');
+            fs.mkdirSync(cursorDir, { recursive: true });
+            fs.writeFileSync(path.join(cursorDir, 'mcp.json'), JSON.stringify({ mcpServers: { 'fivo-cell': { url: 'http://localhost:9876/mcp' } } }), 'utf8');
+            const state = (0, setup_1.checkMcpState)(homedir);
+            expect(state.done).toBe(1);
+            expect(state.needsWrite).not.toContain('Cursor');
+            // Other IDEs should still need write
+            expect(state.needsWrite.length).toBe(state.total - 1);
+        });
+        it('counts skipped when config file has parse errors', () => {
+            const cursorDir = path.join(homedir, '.cursor');
+            fs.mkdirSync(cursorDir, { recursive: true });
+            fs.writeFileSync(path.join(cursorDir, 'mcp.json'), '{ not valid json', 'utf8');
+            const state = (0, setup_1.checkMcpState)(homedir);
+            expect(state.skipped).toBe(1);
+            expect(state.done).toBe(0);
+        });
+    });
+    describe('isDaemonRunning', () => {
+        it('returns false when nothing is listening on a random port', async () => {
+            // Use a random high port that nothing should be on
+            const result = await (0, setup_1.isDaemonRunning)(19878, 500);
+            expect(result).toBe(false);
+        });
+        it('returns true when an HTTP server responds on the port', async () => {
+            const http = require('http');
+            const server = http.createServer((_req, res) => {
+                res.statusCode = 200;
+                res.end('OK');
+            });
+            await new Promise((resolve) => server.listen(19876, '127.0.0.1', resolve));
+            try {
+                const result = await (0, setup_1.isDaemonRunning)(19876, 1000);
+                expect(result).toBe(true);
+            }
+            finally {
+                await new Promise((resolve) => server.close(() => resolve()));
+            }
+        });
+        it('returns false when server returns non-200', async () => {
+            const http = require('http');
+            const server = http.createServer((_req, res) => {
+                res.statusCode = 500;
+                res.end('error');
+            });
+            await new Promise((resolve) => server.listen(19877, '127.0.0.1', resolve));
+            try {
+                const result = await (0, setup_1.isDaemonRunning)(19877, 1000);
+                expect(result).toBe(false);
+            }
+            finally {
+                await new Promise((resolve) => server.close(() => resolve()));
+            }
+        });
+    });
+});
+//# sourceMappingURL=setup.test.js.map

package/dist/__tests__/setup.test.js.map

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

package/dist/cli.js

@@ -99,6 +99,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;
@@ -152,6 +159,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 +234,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 +420,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')
@@ -1368,8 +1510,9 @@ function doHelp() {
     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`);