@hivehub/rulebook 4.3.1 → 5.0.0

package/dist/core/indexer/background-indexer.js

@@ -1,5 +1,6 @@
-import { existsSync, statSync, watch } from 'fs';
-import { extname, join, resolve } from 'path';
+import { existsSync, statSync } from 'fs';
+import { extname, resolve } from 'path';
+import chokidar from 'chokidar';
 import { CodeParser } from './file-parser.js';
 export class BackgroundIndexer {
     memoryManager;
@@ -9,7 +10,7 @@ export class BackgroundIndexer {
     isProcessing = false;
     processQueue = new Set();
     debounceTimer = null;
-    watchControllers = new Set();
+    watcher = null;
     // Stats
     processedCount = 0;
     errorCount = 0;
@@ -36,26 +37,36 @@ export class BackgroundIndexer {
         if (!this.config.enabled)
             return;
         console.error(`[BackgroundIndexer] Starting watcher on: ${this.projectRoot}`);
-        // Very naive watcher for V1 (Node.js native Recursive FS Watcher when available, otherwise basic)
-        // Production ready app should probably use `chokidar` here, but sticking to native limits deps
-        try {
-            const watcher = watch(this.projectRoot, { recursive: true }, (_, filename) => {
-                if (!filename)
-                    return;
-                this.handleFileChange(filename);
-            });
-            watcher.on('error', (error) => {
-                console.error('[BackgroundIndexer] Watcher error:', error);
-            });
-            this.watchControllers.add(watcher);
-        }
-        catch (e) {
-            console.warn(`[BackgroundIndexer] Recursive FS watch failed. Falling back to targeted watching may be required. Error: ${e}`);
-        }
+        // Use chokidar for reliable cross-platform file watching with proper ignore support.
+        // Unlike fs.watch({ recursive: true }), chokidar filters at the OS watcher level,
+        // preventing node_modules events from ever reaching the event loop.
+        const ignoredGlobs = this.config.ignorePatterns.map(p => `**/${p}/**`);
+        // Also ignore binary/asset files at the watcher level
+        ignoredGlobs.push('**/*.png', '**/*.jpg', '**/*.jpeg', '**/*.gif', '**/*.svg', '**/*.ico', '**/*.mp3', '**/*.mp4', '**/*.pdf', '**/*.lock', '**/*.sqlite', '**/*.sqlite-wal', '**/*.sqlite-shm', '**/*.sqlite-journal', '**/*.db', '**/*.db-wal', '**/*.db-shm', '**/*.db-journal');
+        this.watcher = chokidar.watch(this.projectRoot, {
+            ignored: ignoredGlobs,
+            persistent: true,
+            ignoreInitial: true,
+            depth: 8,
+            // Reduce CPU usage: aggregate events over 500ms
+            awaitWriteFinish: {
+                stabilityThreshold: 500,
+                pollInterval: 100,
+            },
+        });
+        this.watcher
+            .on('change', (filePath) => this.handleFileChange(filePath))
+            .on('add', (filePath) => this.handleFileChange(filePath))
+            .on('unlink', (filePath) => this.handleFileChange(filePath))
+            .on('error', (error) => {
+            console.error('[BackgroundIndexer] Watcher error:', error);
+        });
     }
     stop() {
-        this.watchControllers.forEach((w) => w.close());
-        this.watchControllers.clear();
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+        }
         if (this.debounceTimer)
             clearTimeout(this.debounceTimer);
         console.error('[BackgroundIndexer] Stopped');
@@ -68,46 +79,21 @@ export class BackgroundIndexer {
             isProcessing: this.isProcessing,
         };
     }
-    isIgnored(filePath) {
-        // Basic ignore check
-        const normalizedPath = filePath.replace(/\\/g, '/');
-        for (const pattern of this.config.ignorePatterns) {
-            if (normalizedPath.includes(`/${pattern}/`) ||
-                normalizedPath.startsWith(`${pattern}/`) ||
-                normalizedPath.includes(`\\${pattern}\\`)) {
-                return true;
-            }
-        }
-        // Ignore non-code files or assets
+    isCodeFile(filePath) {
         const ext = extname(filePath).toLowerCase();
-        const ignoredExts = [
-            '.png',
-            '.jpg',
-            '.jpeg',
-            '.gif',
-            '.svg',
-            '.ico',
-            '.mp3',
-            '.mp4',
-            '.sqlite',
-            '.sqlite-wal',
-            '.sqlite-shm',
-            '.sqlite-journal',
-            '.db',
-            '.db-wal',
-            '.db-shm',
-            '.db-journal',
-            '.pdf',
-            '.lock',
+        const codeExts = [
+            '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+            '.py', '.rs', '.go', '.java', '.kt', '.scala',
+            '.cs', '.cpp', '.cc', '.c', '.h', '.hpp',
+            '.swift', '.rb', '.php', '.ex', '.erl', '.zig',
+            '.sol', '.dart', '.lua', '.hs', '.r', '.R',
+            '.sh', '.bash', '.zsh', '.yaml', '.yml', '.json',
+            '.toml', '.md', '.mdx',
         ];
-        if (ignoredExts.includes(ext)) {
-            return true;
-        }
-        return false;
+        return codeExts.includes(ext);
     }
-    handleFileChange(filename) {
-        const fullPath = join(this.projectRoot, filename);
-        if (this.isIgnored(filename))
+    handleFileChange(fullPath) {
+        if (!this.isCodeFile(fullPath))
             return;
         this.processQueue.add(fullPath);
         // Debounce the queue processor
@@ -117,35 +103,23 @@ export class BackgroundIndexer {
             this.processNextBatch();
         }, this.config.debounceMs);
     }
+    // Max time for a single file to be indexed before we skip it
+    static PER_FILE_TIMEOUT_MS = 5000;
+    // Max batch size to prevent long blocking runs
+    static MAX_BATCH_SIZE = 20;
     async processNextBatch() {
         if (this.isProcessing || this.processQueue.size === 0)
             return;
         this.isProcessing = true;
-        const batch = Array.from(this.processQueue);
-        this.processQueue.clear();
-        console.error(`[BackgroundIndexer] Processing batch of ${batch.length} files...`);
+        // Cap batch size to prevent the indexer from monopolizing the event loop
+        const allQueued = Array.from(this.processQueue);
+        const batch = allQueued.slice(0, BackgroundIndexer.MAX_BATCH_SIZE);
+        for (const f of batch)
+            this.processQueue.delete(f);
+        console.error(`[BackgroundIndexer] Processing batch of ${batch.length} files (${this.processQueue.size} remaining)...`);
         for (const filePath of batch) {
             try {
-                if (!existsSync(filePath)) {
-                    // File was deleted
-                    await this.memoryManager.deleteCodeNodesByFile(filePath);
-                    continue;
-                }
-                const stats = statSync(filePath);
-                if (!stats.isFile())
-                    continue;
-                // Parse
-                const { nodes, edges } = this.parser.parseFile(filePath);
-                // 1. Flush old Nodes/Edges for this file (Cascade handles Edges)
-                await this.memoryManager.deleteCodeNodesByFile(filePath);
-                // 2. Insert new Nodes
-                for (const node of nodes) {
-                    await this.memoryManager.saveCodeNode(node);
-                }
-                // 3. Insert new Edges
-                for (const edge of edges) {
-                    await this.memoryManager.saveCodeEdge(edge);
-                }
+                await this.processFile(filePath);
                 this.processedCount++;
             }
             catch (e) {
@@ -154,10 +128,52 @@ export class BackgroundIndexer {
             }
         }
         this.isProcessing = false;
-        // If more accumulated while processing, trigger again
+        // If more accumulated while processing, schedule next batch directly
         if (this.processQueue.size > 0) {
-            this.handleFileChange('__trigger_batch__');
+            this.debounceTimer = setTimeout(() => {
+                this.processNextBatch();
+            }, 100);
         }
     }
+    /**
+     * Process a single file with a timeout guard.
+     * If processing takes longer than PER_FILE_TIMEOUT_MS, skip it.
+     */
+    processFile(filePath) {
+        const work = async () => {
+            if (!existsSync(filePath)) {
+                // File was deleted
+                await this.memoryManager.deleteCodeNodesByFile(filePath);
+                return;
+            }
+            const stats = statSync(filePath);
+            if (!stats.isFile())
+                return;
+            // Parse
+            const { nodes, edges } = this.parser.parseFile(filePath);
+            // 1. Flush old Nodes/Edges for this file (Cascade handles Edges)
+            await this.memoryManager.deleteCodeNodesByFile(filePath);
+            // 2. Insert new Nodes
+            for (const node of nodes) {
+                await this.memoryManager.saveCodeNode(node);
+            }
+            // 3. Insert new Edges
+            for (const edge of edges) {
+                await this.memoryManager.saveCodeEdge(edge);
+            }
+        };
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error(`Indexing timed out after ${BackgroundIndexer.PER_FILE_TIMEOUT_MS}ms`));
+            }, BackgroundIndexer.PER_FILE_TIMEOUT_MS);
+            work().then(() => {
+                clearTimeout(timer);
+                resolve();
+            }, (err) => {
+                clearTimeout(timer);
+                reject(err);
+            });
+        });
+    }
 }
 //# sourceMappingURL=background-indexer.js.map

package/dist/core/indexer/background-indexer.js.map

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

package/dist/core/knowledge-manager.d.ts

@@ -0,0 +1,24 @@
+import type { KnowledgeEntry, KnowledgeType, KnowledgeCategory } from '../types.js';
+export declare class KnowledgeManager {
+    private knowledgePath;
+    constructor(projectRoot: string, rulebookDir?: string);
+    private ensureDir;
+    add(type: KnowledgeType, title: string, options: {
+        category: KnowledgeCategory;
+        description: string;
+        example?: string;
+        whenToUse?: string;
+        whenNotToUse?: string;
+        tags?: string[];
+        source?: KnowledgeEntry['source'];
+    }): Promise<KnowledgeEntry>;
+    list(type?: KnowledgeType, category?: KnowledgeCategory): Promise<KnowledgeEntry[]>;
+    show(id: string): Promise<{
+        entry: KnowledgeEntry;
+        content: string;
+    } | null>;
+    remove(id: string): Promise<boolean>;
+    getForGenerator(): Promise<string>;
+    private renderMarkdown;
+}
+//# sourceMappingURL=knowledge-manager.d.ts.map

package/dist/core/knowledge-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-manager.d.ts","sourceRoot":"","sources":["../../src/core/knowledge-manager.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAiBpF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,aAAa,CAAS;gBAElB,WAAW,EAAE,MAAM,EAAE,WAAW,GAAE,MAAoB;IAIlE,OAAO,CAAC,SAAS;IAoBX,GAAG,CACP,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QACP,QAAQ,EAAE,iBAAiB,CAAC;QAC5B,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,MAAM,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;KACnC,GACA,OAAO,CAAC,cAAc,CAAC;IA6BpB,IAAI,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAyBnF,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,cAAc,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAiB5E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAepC,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IA+BxC,OAAO,CAAC,cAAc;CAwBvB"}

package/dist/core/knowledge-manager.js

@@ -0,0 +1,173 @@
+import { existsSync, mkdirSync, readdirSync, rmSync } from 'fs';
+import { join } from 'path';
+import { readFile as readFileUtil, writeFile as writeFileUtil, } from '../utils/file-system.js';
+const KNOWLEDGE_DIR = 'knowledge';
+const PATTERNS_DIR = 'patterns';
+const ANTI_PATTERNS_DIR = 'anti-patterns';
+function slugify(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+function subdir(type) {
+    return type === 'pattern' ? PATTERNS_DIR : ANTI_PATTERNS_DIR;
+}
+export class KnowledgeManager {
+    knowledgePath;
+    constructor(projectRoot, rulebookDir = '.rulebook') {
+        this.knowledgePath = join(projectRoot, rulebookDir, KNOWLEDGE_DIR);
+    }
+    ensureDir(type) {
+        if (!existsSync(this.knowledgePath)) {
+            mkdirSync(this.knowledgePath, { recursive: true });
+        }
+        if (type) {
+            const dir = join(this.knowledgePath, subdir(type));
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+        }
+        else {
+            // Ensure both
+            for (const d of [PATTERNS_DIR, ANTI_PATTERNS_DIR]) {
+                const dir = join(this.knowledgePath, d);
+                if (!existsSync(dir)) {
+                    mkdirSync(dir, { recursive: true });
+                }
+            }
+        }
+    }
+    async add(type, title, options) {
+        this.ensureDir(type);
+        const id = slugify(title);
+        const dir = join(this.knowledgePath, subdir(type));
+        const entry = {
+            id,
+            type,
+            title,
+            category: options.category,
+            description: options.description,
+            example: options.example,
+            whenToUse: options.whenToUse,
+            whenNotToUse: options.whenNotToUse,
+            createdAt: new Date().toISOString(),
+            tags: options.tags ?? [],
+            source: options.source ?? 'manual',
+        };
+        // Write markdown
+        const md = this.renderMarkdown(entry);
+        await writeFileUtil(join(dir, `${id}.md`), md);
+        // Write metadata
+        await writeFileUtil(join(dir, `${id}.metadata.json`), JSON.stringify(entry, null, 2));
+        return entry;
+    }
+    async list(type, category) {
+        this.ensureDir();
+        const types = type ? [type] : ['pattern', 'anti-pattern'];
+        const entries = [];
+        for (const t of types) {
+            const dir = join(this.knowledgePath, subdir(t));
+            if (!existsSync(dir))
+                continue;
+            const files = readdirSync(dir).filter((f) => f.endsWith('.metadata.json'));
+            for (const file of files) {
+                const raw = await readFileUtil(join(dir, file));
+                if (!raw)
+                    continue;
+                try {
+                    const meta = JSON.parse(raw);
+                    if (category && meta.category !== category)
+                        continue;
+                    entries.push(meta);
+                }
+                catch {
+                    // skip malformed
+                }
+            }
+        }
+        return entries.sort((a, b) => a.title.localeCompare(b.title));
+    }
+    async show(id) {
+        this.ensureDir();
+        // Search both dirs
+        for (const t of ['pattern', 'anti-pattern']) {
+            const dir = join(this.knowledgePath, subdir(t));
+            if (!existsSync(dir))
+                continue;
+            const metaPath = join(dir, `${id}.metadata.json`);
+            if (!existsSync(metaPath))
+                continue;
+            const raw = await readFileUtil(metaPath);
+            if (!raw)
+                continue;
+            const entry = JSON.parse(raw);
+            const content = (await readFileUtil(join(dir, `${id}.md`))) ?? '';
+            return { entry, content };
+        }
+        return null;
+    }
+    async remove(id) {
+        this.ensureDir();
+        for (const t of ['pattern', 'anti-pattern']) {
+            const dir = join(this.knowledgePath, subdir(t));
+            if (!existsSync(dir))
+                continue;
+            const metaPath = join(dir, `${id}.metadata.json`);
+            if (!existsSync(metaPath))
+                continue;
+            const mdPath = join(dir, `${id}.md`);
+            if (existsSync(mdPath))
+                rmSync(mdPath);
+            rmSync(metaPath);
+            return true;
+        }
+        return false;
+    }
+    async getForGenerator() {
+        const patterns = await this.list('pattern');
+        const antiPatterns = await this.list('anti-pattern');
+        if (patterns.length === 0 && antiPatterns.length === 0)
+            return '';
+        const lines = ['## Project Knowledge', ''];
+        if (patterns.length > 0) {
+            lines.push('### Patterns', '', 'The following patterns are enforced in this project:', '');
+            for (const p of patterns) {
+                lines.push(`- **${p.title}** → [spec](/.rulebook/knowledge/patterns/${p.id}.md)`);
+            }
+            lines.push('');
+        }
+        if (antiPatterns.length > 0) {
+            lines.push('### Anti-Patterns to Avoid', '');
+            for (const a of antiPatterns) {
+                lines.push(`- **${a.title}** → [details](/.rulebook/knowledge/anti-patterns/${a.id}.md)`);
+            }
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    renderMarkdown(e) {
+        const lines = [
+            `# ${e.title}`,
+            '',
+            `**Category**: ${e.category}`,
+            `**Tags**: ${e.tags.join(', ') || 'none'}`,
+            '',
+            '## Description',
+            '',
+            e.description,
+        ];
+        if (e.example) {
+            lines.push('', '## Example', '', e.example);
+        }
+        if (e.whenToUse) {
+            lines.push('', '## When to Use', '', e.whenToUse);
+        }
+        if (e.whenNotToUse) {
+            lines.push('', '## When NOT to Use', '', e.whenNotToUse);
+        }
+        lines.push('');
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=knowledge-manager.js.map

package/dist/core/knowledge-manager.js.map

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

package/dist/core/learn-manager.d.ts

@@ -0,0 +1,29 @@
+import type { Learning, KnowledgeCategory } from '../types.js';
+export declare class LearnManager {
+    private learningsPath;
+    private ralphHistoryPath;
+    private decisionManager;
+    private knowledgeManager;
+    constructor(projectRoot: string, rulebookDir?: string);
+    private ensureDir;
+    capture(title: string, content: string, options?: {
+        source?: Learning['source'];
+        relatedTask?: string;
+        relatedDecision?: number;
+        tags?: string[];
+    }): Promise<Learning>;
+    fromRalph(): Promise<Learning[]>;
+    list(limit?: number): Promise<Learning[]>;
+    show(id: string): Promise<{
+        learning: Learning;
+        content: string;
+    } | null>;
+    promote(id: string, target: 'knowledge' | 'decision', options?: {
+        title?: string;
+        category?: KnowledgeCategory;
+    }): Promise<{
+        type: 'knowledge' | 'decision';
+        id: string;
+    } | null>;
+}
+//# sourceMappingURL=learn-manager.d.ts.map

package/dist/core/learn-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learn-manager.d.ts","sourceRoot":"","sources":["../../src/core/learn-manager.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAa/D,qBAAa,YAAY;IACvB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,gBAAgB,CAAmB;gBAE/B,WAAW,EAAE,MAAM,EAAE,WAAW,GAAE,MAAoB;IAQlE,OAAO,CAAC,SAAS;IAMX,OAAO,CACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACZ,GACL,OAAO,CAAC,QAAQ,CAAC;IA0Cd,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAyChC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAoBzC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAazE,OAAO,CACX,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,WAAW,GAAG,UAAU,EAChC,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,iBAAiB,CAAC;KACzB,GACL,OAAO,CAAC;QAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAkClE"}