fivocell 4.1.8 → 4.2.0

package/dist/__tests__/agents-md.test.d.ts

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

package/dist/__tests__/agents-md.test.d.ts.map

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

package/dist/__tests__/agents-md.test.js

@@ -0,0 +1,141 @@
+"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 agents_md_1 = require("../core/agents-md");
+describe('agents-md (AGENTS.md + .cursorrules writers)', () => {
+    let tmpDir;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cell-agents-md-'));
+    });
+    afterEach(() => {
+        try {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        }
+        catch { }
+    });
+    describe('templates', () => {
+        it('AGENTS_MD_TEMPLATE declares FIVO Cell rules and the @cell convention', () => {
+            expect(agents_md_1.AGENTS_MD_TEMPLATE).toContain(agents_md_1.CELL_RULES_MARKER);
+            expect(agents_md_1.AGENTS_MD_TEMPLATE).toContain('@cell');
+            expect(agents_md_1.AGENTS_MD_TEMPLATE).toContain('cell_get_context');
+            expect(agents_md_1.AGENTS_MD_TEMPLATE).toContain('cell_session_start');
+            expect(agents_md_1.AGENTS_MD_TEMPLATE).toContain('path.basename(process.cwd())');
+        });
+        it('CURSORRULES_TEMPLATE mentions @cell and cell_get_context', () => {
+            expect(agents_md_1.CURSORRULES_TEMPLATE).toContain(agents_md_1.CELL_RULES_MARKER);
+            expect(agents_md_1.CURSORRULES_TEMPLATE).toContain('@cell');
+            expect(agents_md_1.CURSORRULES_TEMPLATE).toContain('cell_get_context');
+        });
+        it('isCellRulesFile detects the marker in any file content', () => {
+            expect((0, agents_md_1.isCellRulesFile)(agents_md_1.AGENTS_MD_TEMPLATE)).toBe(true);
+            expect((0, agents_md_1.isCellRulesFile)('# User custom rules')).toBe(false);
+            expect((0, agents_md_1.isCellRulesFile)('partial marker mention')).toBe(false);
+            expect((0, agents_md_1.isCellRulesFile)('# fivo-cell:rules:v1\n# body')).toBe(true);
+        });
+    });
+    describe('writeAgentsMd', () => {
+        it('writes AGENTS.md to project root', () => {
+            const result = (0, agents_md_1.writeAgentsMd)(tmpDir);
+            expect(result).toBe('written');
+            const filePath = path.join(tmpDir, agents_md_1.AGENTS_MD_FILENAME);
+            expect(fs.existsSync(filePath)).toBe(true);
+            const content = fs.readFileSync(filePath, 'utf8');
+            expect(content).toBe(agents_md_1.AGENTS_MD_TEMPLATE);
+        });
+        it('does not overwrite existing AGENTS.md (idempotent — respects user edits)', () => {
+            const filePath = path.join(tmpDir, agents_md_1.AGENTS_MD_FILENAME);
+            const custom = '# My custom team rules\nDo not touch this file.\n';
+            fs.writeFileSync(filePath, custom, 'utf8');
+            const result = (0, agents_md_1.writeAgentsMd)(tmpDir);
+            expect(result).toBe('exists');
+            const content = fs.readFileSync(filePath, 'utf8');
+            expect(content).toBe(custom);
+        });
+        it('overwrites existing AGENTS.md when overwrite: true', () => {
+            const filePath = path.join(tmpDir, agents_md_1.AGENTS_MD_FILENAME);
+            fs.writeFileSync(filePath, 'old content', 'utf8');
+            const result = (0, agents_md_1.writeAgentsMd)(tmpDir, { overwrite: true });
+            expect(result).toBe('written');
+            const content = fs.readFileSync(filePath, 'utf8');
+            expect(content).toBe(agents_md_1.AGENTS_MD_TEMPLATE);
+        });
+    });
+    describe('writeCursorRules', () => {
+        it('writes .cursorrules to project root', () => {
+            const result = (0, agents_md_1.writeCursorRules)(tmpDir);
+            expect(result).toBe('written');
+            const filePath = path.join(tmpDir, agents_md_1.CURSORRULES_FILENAME);
+            expect(fs.existsSync(filePath)).toBe(true);
+        });
+        it('does not overwrite existing .cursorrules', () => {
+            const filePath = path.join(tmpDir, agents_md_1.CURSORRULES_FILENAME);
+            fs.writeFileSync(filePath, 'user rules', 'utf8');
+            const result = (0, agents_md_1.writeCursorRules)(tmpDir);
+            expect(result).toBe('exists');
+        });
+    });
+    describe('writeCellRules', () => {
+        it('writes both files on a fresh project', () => {
+            const r = (0, agents_md_1.writeCellRules)(tmpDir);
+            expect(r.agentsMd).toBe('written');
+            expect(r.cursorRules).toBe('written');
+            expect(fs.existsSync(path.join(tmpDir, agents_md_1.AGENTS_MD_FILENAME))).toBe(true);
+            expect(fs.existsSync(path.join(tmpDir, agents_md_1.CURSORRULES_FILENAME))).toBe(true);
+        });
+        it('returns exists for both when both files already present', () => {
+            fs.writeFileSync(path.join(tmpDir, agents_md_1.AGENTS_MD_FILENAME), 'x', 'utf8');
+            fs.writeFileSync(path.join(tmpDir, agents_md_1.CURSORRULES_FILENAME), 'y', 'utf8');
+            const r = (0, agents_md_1.writeCellRules)(tmpDir);
+            expect(r.agentsMd).toBe('exists');
+            expect(r.cursorRules).toBe('exists');
+        });
+        it('skips .cursorrules when cursor: false', () => {
+            const r = (0, agents_md_1.writeCellRules)(tmpDir, { cursor: false });
+            expect(r.agentsMd).toBe('written');
+            expect(r.cursorRules).toBe('skipped');
+            expect(fs.existsSync(path.join(tmpDir, agents_md_1.CURSORRULES_FILENAME))).toBe(false);
+        });
+    });
+    describe('filename constants', () => {
+        it('exports the correct filenames', () => {
+            expect(agents_md_1.AGENTS_MD_FILENAME).toBe('AGENTS.md');
+            expect(agents_md_1.CURSORRULES_FILENAME).toBe('.cursorrules');
+        });
+    });
+});
+//# sourceMappingURL=agents-md.test.js.map

package/dist/__tests__/agents-md.test.js.map

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

package/dist/__tests__/atcell-live-fallback.test.d.ts

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

package/dist/__tests__/atcell-live-fallback.test.d.ts.map

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

package/dist/__tests__/atcell-live-fallback.test.js

@@ -0,0 +1,138 @@
+"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: (..._args) => rows,
+        get: (..._args) => rows[0] || undefined,
+    };
+}
+describe('@cell live_event fallback (regression for v4.1.8 UX bug)', () => {
+    function setupMocks(opts = {}) {
+        const profileTs = opts.profileScannedAt || 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: 'fivo-cell', files_scanned: 100, total_lines: 5000, scanned_at: profileTs }]);
+            }
+            if (s.startsWith('SELECT PATTERN_TYPE, PATTERN_VALUE, CATEGORY, COUNT, TRUST_SCORE FROM CODE_PATTERNS')) {
+                if (s.includes("CATEGORY = 'BLIND_SPOTS'"))
+                    return fakeStmt([]);
+                return fakeStmt([{ pattern_type: 'naming', pattern_value: 'camelCase', category: 'naming', count: 10, trust_score: 90 }]);
+            }
+            if (s.startsWith('SELECT * FROM SCANS')) {
+                return fakeStmt([{ id: 1, project: 'fivo-cell', started_at: new Date().toISOString(), completed_at: new Date().toISOString(), files_scanned: 100 }]);
+            }
+            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(opts.sessionRows || []);
+            }
+            if (s.startsWith('SELECT * FROM LIVE_EVENTS')) {
+                return opts.liveEventRows ? fakeStmt(opts.liveEventRows) : fakeStmt([]);
+            }
+            if (s.includes('SESSION_APPROACHES') && s.includes('GROUP BY'))
+                return fakeStmt([]);
+            if (s.startsWith('SELECT FILE_PATH') && s.includes('SESSION_FILES'))
+                return fakeStmt([]);
+            if (s.startsWith('SELECT * FROM SESSION_QUESTIONS'))
+                return fakeStmt([]);
+            return fakeStmt([]);
+        });
+    }
+    it('sets lastLiveFile when no session exists but live_events has rows', () => {
+        const eventTs = new Date(Date.now() - 60_000).toISOString();
+        setupMocks({
+            sessionRows: [],
+            liveEventRows: [{ id: 1217, project: 'fivo-cell', event_type: 'file_save', file_path: 'src/components/layout/AppLayout.tsx', created_at: eventTs }],
+        });
+        const ctx = (0, prompt_builder_1.buildContext)('fivo-cell', 'claude-code');
+        expect(ctx.lastSession).toBeUndefined();
+        expect(ctx.lastLiveFile).toBeDefined();
+        expect(ctx.lastLiveFile?.filePath).toBe('src/components/layout/AppLayout.tsx');
+        expect(ctx.lastLiveFile?.eventType).toBe('file_save');
+    });
+    it('@cell block shows "Live: saved <path>" when only live_event is present (regression for empty Last Session)', () => {
+        const eventTs = new Date(Date.now() - 30_000).toISOString();
+        setupMocks({
+            sessionRows: [],
+            liveEventRows: [{ id: 50, project: 'fivo-cell', event_type: 'file_save', file_path: 'src/foo.ts', created_at: eventTs }],
+        });
+        const ctx = (0, prompt_builder_1.buildContext)('fivo-cell', 'claude-code');
+        const out = (0, prompt_builder_1.formatContextForTool)(ctx, 'claude-code');
+        expect(out).toContain('Live: saved src/foo.ts');
+        expect(out).not.toContain('(no session yet — first run)');
+        expect(out).toContain('cell session start');
+    });
+    it('@cell block shows "Live: created <path>" for file_create events', () => {
+        const eventTs = new Date().toISOString();
+        setupMocks({
+            sessionRows: [],
+            liveEventRows: [{ id: 51, project: 'fivo-cell', event_type: 'file_create', file_path: 'src/new.ts', created_at: eventTs }],
+        });
+        const ctx = (0, prompt_builder_1.buildContext)('fivo-cell', 'claude-code');
+        const out = (0, prompt_builder_1.formatContextForTool)(ctx, 'claude-code');
+        expect(out).toContain('Live: created src/new.ts');
+    });
+    it('@cell block shows "Live: deleted <path>" for file_delete events', () => {
+        const eventTs = new Date().toISOString();
+        setupMocks({
+            sessionRows: [],
+            liveEventRows: [{ id: 52, project: 'fivo-cell', event_type: 'file_delete', file_path: 'src/old.ts', created_at: eventTs }],
+        });
+        const ctx = (0, prompt_builder_1.buildContext)('fivo-cell', 'claude-code');
+        const out = (0, prompt_builder_1.formatContextForTool)(ctx, 'claude-code');
+        expect(out).toContain('Live: deleted src/old.ts');
+    });
+    it('prefers lastSession over lastLiveFile when both exist (session is richer context)', () => {
+        const eventTs = new Date(Date.now() - 30_000).toISOString();
+        setupMocks({
+            sessionRows: [{
+                    id: 5, tool_name: 'cursor', project: 'fivo-cell',
+                    start_time: new Date(Date.now() - 600_000).toISOString(),
+                    end_time: new Date().toISOString(),
+                    files_touched: '["src/session-tracker.ts"]',
+                    key_decisions: '["Phase 2"]',
+                    context_snapshot: 'Working on session data',
+                }],
+            liveEventRows: [{ id: 100, project: 'fivo-cell', event_type: 'file_save', file_path: 'src/recent.ts', created_at: eventTs }],
+        });
+        const ctx = (0, prompt_builder_1.buildContext)('fivo-cell', 'claude-code');
+        expect(ctx.lastSession).toBeDefined();
+        expect(ctx.lastLiveFile).toBeDefined();
+        const out = (0, prompt_builder_1.formatContextForTool)(ctx, 'claude-code');
+        expect(out).toContain('Tool: cursor');
+        expect(out).toContain('Working on: Working on session data');
+        // Should NOT show the live fallback when a session exists
+        expect(out).not.toContain('Live: saved');
+    });
+    it('shows cold-start message when neither session nor live events exist', () => {
+        setupMocks({ sessionRows: [], liveEventRows: [] });
+        const ctx = (0, prompt_builder_1.buildContext)('unknown-project', 'claude-code');
+        expect(ctx.lastSession).toBeUndefined();
+        expect(ctx.lastLiveFile).toBeUndefined();
+        const out = (0, prompt_builder_1.formatContextForTool)(ctx, 'claude-code');
+        expect(out).toContain('(no session yet — first run)');
+    });
+    it('handles live_events query failure gracefully (returns undefined, does not crash)', () => {
+        setupMocks({ sessionRows: [] });
+        mockDb.prepare.mockImplementation((sql) => {
+            if (sql.trim().toUpperCase().startsWith('SELECT * FROM LIVE_EVENTS')) {
+                throw new Error('table missing');
+            }
+            return fakeStmt([]);
+        });
+        const ctx = (0, prompt_builder_1.buildContext)('fivo-cell', 'claude-code');
+        expect(ctx.lastLiveFile).toBeUndefined();
+    });
+});
+//# sourceMappingURL=atcell-live-fallback.test.js.map

package/dist/__tests__/atcell-live-fallback.test.js.map

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

package/dist/__tests__/watch-cli.test.d.ts

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

package/dist/__tests__/watch-cli.test.d.ts.map

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

package/dist/__tests__/watch-cli.test.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const watch_cli_1 = require("../core/watch-cli");
+describe('watch-cli parser (cell watch events --limit/--type)', () => {
+    describe('parseWatchFlags', () => {
+        it('returns all positional args when no flags present', () => {
+            const r = (0, watch_cli_1.parseWatchFlags)(['fivo-cell', '/path/to/dir']);
+            expect(r.positional).toEqual(['fivo-cell', '/path/to/dir']);
+        });
+        it('strips --limit N flag from positional list', () => {
+            const r = (0, watch_cli_1.parseWatchFlags)(['fivo-cell', '--limit', '10']);
+            expect(r.positional).toEqual(['fivo-cell']);
+        });
+        it('strips --limit=N form', () => {
+            const r = (0, watch_cli_1.parseWatchFlags)(['fivo-cell', '--limit=10']);
+            expect(r.positional).toEqual(['fivo-cell']);
+        });
+        it('strips --type file_save flag', () => {
+            const r = (0, watch_cli_1.parseWatchFlags)(['fivo-cell', '--type', 'file_save']);
+            expect(r.positional).toEqual(['fivo-cell']);
+        });
+        it('strips --type=file_save form', () => {
+            const r = (0, watch_cli_1.parseWatchFlags)(['fivo-cell', '--type=file_save']);
+            expect(r.positional).toEqual(['fivo-cell']);
+        });
+        it('handles flags before and after positional args (regression for v4.1.8 bug where --limit became project name)', () => {
+            const r = (0, watch_cli_1.parseWatchFlags)(['--limit', '3', 'fivo-cell', '--type', 'file_save']);
+            expect(r.positional).toEqual(['fivo-cell']);
+        });
+        it('ignores unknown --flags without breaking (treats them as no-arg switches)', () => {
+            const r = (0, watch_cli_1.parseWatchFlags)(['fivo-cell', '--unknown', 'value', '/dir']);
+            expect(r.positional).toEqual(['fivo-cell', 'value', '/dir']);
+        });
+        it('returns empty list when only flags provided', () => {
+            const r = (0, watch_cli_1.parseWatchFlags)(['--limit', '5', '--type', 'file_save']);
+            expect(r.positional).toEqual([]);
+        });
+        it('handles --limit at end of args (no value)', () => {
+            const r = (0, watch_cli_1.parseWatchFlags)(['fivo-cell', '--limit']);
+            expect(r.positional).toEqual(['fivo-cell']);
+        });
+    });
+    describe('parseWatchLimit', () => {
+        it('returns default when no flag present', () => {
+            expect((0, watch_cli_1.parseWatchLimit)(['fivo-cell'])).toBe(watch_cli_1.DEFAULT_EVENT_LIMIT);
+            expect((0, watch_cli_1.parseWatchLimit)([])).toBe(watch_cli_1.DEFAULT_EVENT_LIMIT);
+        });
+        it('parses --limit N form', () => {
+            expect((0, watch_cli_1.parseWatchLimit)(['fivo-cell', '--limit', '50'])).toBe(50);
+        });
+        it('parses --limit=N form', () => {
+            expect((0, watch_cli_1.parseWatchLimit)(['fivo-cell', '--limit=42'])).toBe(42);
+        });
+        it('clamps absurdly large values to MAX_EVENT_LIMIT', () => {
+            expect((0, watch_cli_1.parseWatchLimit)(['--limit', '99999'])).toBe(watch_cli_1.MAX_EVENT_LIMIT);
+        });
+        it('falls back to default for non-numeric input', () => {
+            expect((0, watch_cli_1.parseWatchLimit)(['--limit', 'abc'])).toBe(watch_cli_1.DEFAULT_EVENT_LIMIT);
+        });
+        it('falls back to default for zero or negative', () => {
+            expect((0, watch_cli_1.parseWatchLimit)(['--limit', '0'])).toBe(watch_cli_1.DEFAULT_EVENT_LIMIT);
+            expect((0, watch_cli_1.parseWatchLimit)(['--limit', '-5'])).toBe(watch_cli_1.DEFAULT_EVENT_LIMIT);
+        });
+        it('uses custom fallback when provided', () => {
+            expect((0, watch_cli_1.parseWatchLimit)([], 100)).toBe(100);
+        });
+    });
+    describe('parseWatchEventType', () => {
+        it('returns undefined when no flag present', () => {
+            expect((0, watch_cli_1.parseWatchEventType)(['fivo-cell'])).toBeUndefined();
+            expect((0, watch_cli_1.parseWatchEventType)([])).toBeUndefined();
+        });
+        it('parses --type T form', () => {
+            expect((0, watch_cli_1.parseWatchEventType)(['--type', 'file_save'])).toBe('file_save');
+        });
+        it('parses --type=T form', () => {
+            expect((0, watch_cli_1.parseWatchEventType)(['--type=file_delete'])).toBe('file_delete');
+        });
+        it('works with positional args before/after', () => {
+            expect((0, watch_cli_1.parseWatchEventType)(['fivo-cell', '--type', 'git_commit'])).toBe('git_commit');
+            expect((0, watch_cli_1.parseWatchEventType)(['--type', 'file_rename', 'fivo-cell'])).toBe('file_rename');
+        });
+    });
+    describe('isValidEventType', () => {
+        it('accepts all known event types', () => {
+            for (const t of ['file_save', 'file_create', 'file_delete', 'file_rename', 'git_commit', 'package_change']) {
+                expect((0, watch_cli_1.isValidEventType)(t)).toBe(true);
+            }
+        });
+        it('rejects unknown types', () => {
+            expect((0, watch_cli_1.isValidEventType)('foo')).toBe(false);
+            expect((0, watch_cli_1.isValidEventType)('FILE_SAVE')).toBe(false);
+            expect((0, watch_cli_1.isValidEventType)(undefined)).toBe(false);
+            expect((0, watch_cli_1.isValidEventType)('')).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=watch-cli.test.js.map

package/dist/__tests__/watch-cli.test.js.map

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

package/dist/cli.js

@@ -300,19 +300,46 @@ function doScan() {
     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('  Scanning codebase + building all layers...\n'));
+    // ─── Flag parsing ─────────────────────────────────────────────────────
+    // --no-rules  → skip writing AGENTS.md and .cursorrules to project root
+    // --force-rules → overwrite existing AGENTS.md/.cursorrules (otherwise keep user edits)
+    const noRules = args.includes('--no-rules');
+    const forceRules = args.includes('--force-rules');
+    const scanPathArg = args.find((a, i) => i >= 1 && !a.startsWith('--')) || project;
+    const scanCwd = path.resolve(scanPathArg);
+    const scanProject = path.basename(scanCwd);
     try {
         const { scanCodebase } = require('./code-scanner');
-        const result = scanCodebase(process.cwd(), project);
+        const result = scanCodebase(scanCwd, scanProject);
         console.log(C.success(`  [1/2] Scanned ${result.filesScanned} files, ${result.totalLines.toLocaleString()} lines`));
         (0, layers_1.populateAllLayers)({
             profile: result.profile,
             patterns: result.patterns,
-            project,
+            project: scanProject,
         });
         console.log(C.success('  [2/2] Populated all layers:'));
         console.log(C.dim('    .cell/personal/  — profile, style, errors, decisions'));
         console.log(C.dim('    .cell/team/      — shared patterns, blind spots'));
         console.log(C.dim('    .cell/community/ — community patterns, trends'));
+        // ─── AI rules files (AGENTS.md, .cursorrules) ─────────────────────────
+        if (!noRules) {
+            const { writeCellRules } = require('./core/agents-md');
+            const rulesResult = writeCellRules(scanCwd, { overwrite: forceRules });
+            const lines = [];
+            if (rulesResult.agentsMd === 'written')
+                lines.push('AGENTS.md');
+            if (rulesResult.cursorRules === 'written')
+                lines.push('.cursorrules');
+            if (lines.length > 0) {
+                console.log(C.success(`  [3/3] Wrote AI rules: ${lines.join(', ')} (idempotent — kept existing files)`));
+            }
+            else {
+                console.log(C.dim('  [3/3] AI rules: AGENTS.md + .cursorrules already present (kept as-is)'));
+            }
+        }
+        else {
+            console.log(C.dim('  [3/3] AI rules: skipped (--no-rules)'));
+        }
         console.log();
         console.log(C.dim('  Run: cell status'));
         console.log();
@@ -988,8 +1015,19 @@ function doWatch() {
     console.log(C.dim('  ─────────────────'));
     console.log();
     const sub = args[1] || 'daemon';
-    const project = args[2] || path.basename(process.cwd());
-    const dir = args[3] || process.cwd();
+    // Parse flags first so positional args don't get eaten by --limit / --type.
+    // Examples supported:
+    //   cell watch events
+    //   cell watch events fivo-cell
+    //   cell watch events fivo-cell --limit 10
+    //   cell watch events fivo-cell --type file_save
+    //   cell watch events --limit 5 --type file_create
+    const watchArgs = args.slice(2);
+    const { positional } = require('./core/watch-cli').parseWatchFlags(watchArgs);
+    const watchLimit = require('./core/watch-cli').parseWatchLimit(watchArgs);
+    const watchEventType = require('./core/watch-cli').parseWatchEventType(watchArgs);
+    const project = positional[0] || path.basename(process.cwd());
+    const dir = positional[1] || process.cwd();
     // If invoked with no subcommand: run as a long-lived watcher daemon (for .bat auto-restart loop)
     if (sub === 'daemon' || sub === '') {
         runWatchDaemon(project, dir);
@@ -1037,14 +1075,22 @@ function doWatch() {
             return;
         }
         if (sub === 'events') {
-            const events = liveWatcher.getLiveEvents(project, 20);
+            const { isValidEventType } = require('./core/watch-cli');
+            const typeFilter = isValidEventType(watchEventType) ? watchEventType : undefined;
+            const events = liveWatcher.getLiveEvents(project, watchLimit, typeFilter);
             if (events.length === 0) {
-                console.log(C.dim(`  No live events for ${project} yet. Start watcher with: cell watch start ${project}`));
+                const hint = typeFilter
+                    ? `No ${typeFilter} events for ${project} in the last ${watchLimit}.`
+                    : `No live events for ${project} yet. Start watcher with: cell watch start ${project}`;
+                console.log(C.dim(`  ${hint}`));
             }
             else {
-                console.log(C.bold(`  Recent events for ${project} (${events.length}):`));
+                const header = typeFilter
+                    ? `Recent ${typeFilter} events for ${project} (${events.length}, limit ${watchLimit}):`
+                    : `Recent events for ${project} (${events.length}, limit ${watchLimit}):`;
+                console.log(C.bold(`  ${header}`));
                 for (const e of events) {
-                    const icon = e.eventType === 'file_save' ? '~' : e.eventType === 'file_create' ? '+' : e.eventType === 'file_delete' ? '-' : '*';
+                    const icon = e.eventType === 'file_save' ? '~' : e.eventType === 'file_create' ? '+' : e.eventType === 'file_delete' ? '-' : e.eventType === 'file_rename' ? '>' : e.eventType === 'git_commit' ? '@' : '*';
                     console.log(`    ${C.dim(icon)} ${C.dim(e.createdAt)} ${e.eventType}: ${C.num(e.filePath)}`);
                 }
             }