@hivehub/rulebook 2.1.0 → 3.1.0

package/dist/memory/memory-store.js

@@ -0,0 +1,394 @@
+/**
+ * SQLite Storage Layer using sql.js (WASM)
+ *
+ * Provides CRUD operations for memories and sessions,
+ * with FTS5 full-text search (BM25 ranking).
+ */
+import { join } from 'path';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+const AUTO_SAVE_THRESHOLD = 50;
+export class MemoryStore {
+    db = null;
+    dbPath;
+    writeCount = 0;
+    initialized = false;
+    constructor(dbPath) {
+        this.dbPath = dbPath;
+    }
+    async initialize() {
+        if (this.initialized)
+            return;
+        // Ensure directory exists
+        const dir = join(this.dbPath, '..');
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        // Dynamic import sql.js
+        const initSqlJs = (await import('sql.js')).default;
+        const SQL = await initSqlJs();
+        // Load existing DB or create new
+        if (existsSync(this.dbPath)) {
+            const fileData = readFileSync(this.dbPath);
+            this.db = new SQL.Database(fileData);
+        }
+        else {
+            this.db = new SQL.Database();
+        }
+        this.createSchema();
+        this.initialized = true;
+    }
+    createSchema() {
+        if (!this.db)
+            throw new Error('Database not initialized');
+        this.db.run(`
+      CREATE TABLE IF NOT EXISTS memories (
+        id TEXT PRIMARY KEY,
+        type TEXT NOT NULL,
+        title TEXT NOT NULL,
+        content TEXT NOT NULL,
+        project TEXT NOT NULL DEFAULT '',
+        tags TEXT NOT NULL DEFAULT '[]',
+        session_id TEXT,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL,
+        accessed_at INTEGER NOT NULL
+      )
+    `);
+        this.db.run(`
+      CREATE TABLE IF NOT EXISTS sessions (
+        id TEXT PRIMARY KEY,
+        project TEXT NOT NULL DEFAULT '',
+        status TEXT NOT NULL DEFAULT 'active',
+        started_at INTEGER NOT NULL,
+        ended_at INTEGER,
+        summary TEXT,
+        tool_calls INTEGER NOT NULL DEFAULT 0
+      )
+    `);
+        // FTS5 virtual table for BM25 search
+        // Use external content mode synced with memories table
+        try {
+            this.db.run(`
+        CREATE VIRTUAL TABLE IF NOT EXISTS memory_fts USING fts5(
+          title, content, type,
+          content=memories,
+          content_rowid=rowid
+        )
+      `);
+            // Triggers to sync FTS with memories table
+            this.db.run(`
+        CREATE TRIGGER IF NOT EXISTS memory_fts_ai AFTER INSERT ON memories BEGIN
+          INSERT INTO memory_fts(rowid, title, content, type)
+            VALUES (new.rowid, new.title, new.content, new.type);
+        END
+      `);
+            this.db.run(`
+        CREATE TRIGGER IF NOT EXISTS memory_fts_ad AFTER DELETE ON memories BEGIN
+          INSERT INTO memory_fts(memory_fts, rowid, title, content, type)
+            VALUES ('delete', old.rowid, old.title, old.content, old.type);
+        END
+      `);
+            this.db.run(`
+        CREATE TRIGGER IF NOT EXISTS memory_fts_au AFTER UPDATE ON memories BEGIN
+          INSERT INTO memory_fts(memory_fts, rowid, title, content, type)
+            VALUES ('delete', old.rowid, old.title, old.content, old.type);
+          INSERT INTO memory_fts(rowid, title, content, type)
+            VALUES (new.rowid, new.title, new.content, new.type);
+        END
+      `);
+        }
+        catch {
+            // FTS5 may not be available in some builds; continue without it
+        }
+        // Index for common queries
+        this.db.run('CREATE INDEX IF NOT EXISTS idx_memories_type ON memories(type)');
+        this.db.run('CREATE INDEX IF NOT EXISTS idx_memories_created ON memories(created_at)');
+        this.db.run('CREATE INDEX IF NOT EXISTS idx_memories_accessed ON memories(accessed_at)');
+        this.db.run('CREATE INDEX IF NOT EXISTS idx_memories_session ON memories(session_id)');
+    }
+    trackWrite() {
+        this.writeCount++;
+        if (this.writeCount >= AUTO_SAVE_THRESHOLD) {
+            this.saveToDisk();
+            this.writeCount = 0;
+        }
+    }
+    // --- Memory CRUD ---
+    saveMemory(memory) {
+        if (!this.db)
+            throw new Error('Database not initialized');
+        this.db.run(`INSERT OR REPLACE INTO memories (id, type, title, content, project, tags, session_id, created_at, updated_at, accessed_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+            memory.id,
+            memory.type,
+            memory.title,
+            memory.content,
+            memory.project,
+            JSON.stringify(memory.tags),
+            memory.sessionId ?? null,
+            memory.createdAt,
+            memory.updatedAt,
+            memory.accessedAt,
+        ]);
+        this.trackWrite();
+    }
+    getMemory(id) {
+        if (!this.db)
+            throw new Error('Database not initialized');
+        const result = this.db.exec(`SELECT id, type, title, content, project, tags, session_id, created_at, updated_at, accessed_at
+       FROM memories WHERE id = '${id.replace(/'/g, "''")}'`);
+        if (result.length === 0 || result[0].values.length === 0)
+            return null;
+        const row = result[0].values[0];
+        return this.rowToMemory(row);
+    }
+    deleteMemory(id) {
+        if (!this.db)
+            throw new Error('Database not initialized');
+        this.db.run(`DELETE FROM memories WHERE id = ?`, [id]);
+        this.trackWrite();
+    }
+    listMemories(options) {
+        if (!this.db)
+            throw new Error('Database not initialized');
+        const conditions = [];
+        if (options?.type)
+            conditions.push(`type = '${options.type}'`);
+        if (options?.project)
+            conditions.push(`project = '${options.project.replace(/'/g, "''")}'`);
+        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        const limit = options?.limit ? `LIMIT ${options.limit}` : 'LIMIT 100';
+        const offset = options?.offset ? `OFFSET ${options.offset}` : '';
+        const result = this.db.exec(`SELECT id, type, title, content, project, tags, session_id, created_at, updated_at, accessed_at
+       FROM memories ${where} ORDER BY created_at DESC ${limit} ${offset}`);
+        if (result.length === 0)
+            return [];
+        return result[0].values.map((row) => this.rowToMemory(row));
+    }
+    updateAccessedAt(id) {
+        if (!this.db)
+            throw new Error('Database not initialized');
+        this.db.run(`UPDATE memories SET accessed_at = ? WHERE id = ?`, [
+            Date.now(),
+            id,
+        ]);
+        this.trackWrite();
+    }
+    getMemoryCount() {
+        if (!this.db)
+            throw new Error('Database not initialized');
+        const result = this.db.exec('SELECT COUNT(*) FROM memories');
+        if (result.length === 0)
+            return 0;
+        return Number(result[0].values[0][0]);
+    }
+    // --- BM25 Search ---
+    searchBM25(query, limit = 20, filters) {
+        if (!this.db)
+            throw new Error('Database not initialized');
+        try {
+            // Escape FTS5 special characters
+            const escaped = query.replace(/['"]/g, ' ').trim();
+            if (!escaped)
+                return [];
+            let sql = `
+        SELECT m.id, bm25(memory_fts) as score
+        FROM memory_fts f
+        JOIN memories m ON m.rowid = f.rowid
+        WHERE memory_fts MATCH '${escaped}'
+      `;
+            if (filters?.type) {
+                sql += ` AND m.type = '${filters.type}'`;
+            }
+            if (filters?.project) {
+                sql += ` AND m.project = '${filters.project.replace(/'/g, "''")}'`;
+            }
+            sql += ` ORDER BY score LIMIT ${limit}`;
+            const result = this.db.exec(sql);
+            if (result.length === 0)
+                return [];
+            return result[0].values.map((row) => ({
+                id: row[0],
+                score: Math.abs(row[1]), // BM25 returns negative scores
+            }));
+        }
+        catch {
+            // FTS5 not available or query error; fallback to LIKE
+            return this.searchLike(query, limit, filters);
+        }
+    }
+    searchLike(query, limit, filters) {
+        if (!this.db)
+            return [];
+        const terms = query
+            .toLowerCase()
+            .split(/\W+/)
+            .filter((t) => t.length > 1);
+        if (terms.length === 0)
+            return [];
+        const conditions = terms.map((t) => `(LOWER(title) LIKE '%${t}%' OR LOWER(content) LIKE '%${t}%')`);
+        let sql = `SELECT id FROM memories WHERE ${conditions.join(' OR ')}`;
+        if (filters?.type)
+            sql += ` AND type = '${filters.type}'`;
+        if (filters?.project)
+            sql += ` AND project = '${filters.project.replace(/'/g, "''")}'`;
+        sql += ` LIMIT ${limit}`;
+        const result = this.db.exec(sql);
+        if (result.length === 0)
+            return [];
+        return result[0].values.map((row, i) => ({
+            id: row[0],
+            score: 1 / (i + 1), // Simple rank-based score
+        }));
+    }
+    // --- Sessions ---
+    createSession(session) {
+        if (!this.db)
+            throw new Error('Database not initialized');
+        this.db.run(`INSERT INTO sessions (id, project, status, started_at, ended_at, summary, tool_calls)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`, [
+            session.id,
+            session.project,
+            session.status,
+            session.startedAt,
+            session.endedAt ?? null,
+            session.summary ?? null,
+            session.toolCalls,
+        ]);
+        this.trackWrite();
+    }
+    endSession(id, summary) {
+        if (!this.db)
+            throw new Error('Database not initialized');
+        this.db.run(`UPDATE sessions SET status = 'completed', ended_at = ?, summary = ? WHERE id = ?`, [Date.now(), summary ?? null, id]);
+        this.trackWrite();
+    }
+    getActiveSession() {
+        if (!this.db)
+            throw new Error('Database not initialized');
+        const result = this.db.exec(`SELECT id, project, status, started_at, ended_at, summary, tool_calls
+       FROM sessions WHERE status = 'active' ORDER BY started_at DESC LIMIT 1`);
+        if (result.length === 0 || result[0].values.length === 0)
+            return null;
+        const row = result[0].values[0];
+        return {
+            id: row[0],
+            project: row[1],
+            status: row[2],
+            startedAt: row[3],
+            endedAt: row[4],
+            summary: row[5],
+            toolCalls: row[6],
+        };
+    }
+    getSessionCount() {
+        if (!this.db)
+            throw new Error('Database not initialized');
+        const result = this.db.exec('SELECT COUNT(*) FROM sessions');
+        if (result.length === 0)
+            return 0;
+        return Number(result[0].values[0][0]);
+    }
+    // --- Queries for cache/stats ---
+    getOldestMemoryTimestamp() {
+        if (!this.db)
+            return undefined;
+        const result = this.db.exec('SELECT MIN(created_at) FROM memories');
+        if (result.length === 0 || result[0].values[0][0] === null)
+            return undefined;
+        return Number(result[0].values[0][0]);
+    }
+    getNewestMemoryTimestamp() {
+        if (!this.db)
+            return undefined;
+        const result = this.db.exec('SELECT MAX(created_at) FROM memories');
+        if (result.length === 0 || result[0].values[0][0] === null)
+            return undefined;
+        return Number(result[0].values[0][0]);
+    }
+    getEvictionCandidates(batchSize, activeSessionId) {
+        if (!this.db)
+            return [];
+        let sql = `SELECT id FROM memories WHERE type != 'decision'`;
+        if (activeSessionId) {
+            sql += ` AND (session_id IS NULL OR session_id != '${activeSessionId.replace(/'/g, "''")}')`;
+        }
+        sql += ` ORDER BY accessed_at ASC, created_at ASC LIMIT ${batchSize}`;
+        const result = this.db.exec(sql);
+        if (result.length === 0)
+            return [];
+        return result[0].values.map((row) => ({ id: row[0] }));
+    }
+    /**
+     * Get memories in chronological order around a given memory
+     */
+    getTimelineAround(memoryId, window) {
+        if (!this.db)
+            return [];
+        // Get anchor memory's timestamp
+        const anchorResult = this.db.exec(`SELECT created_at FROM memories WHERE id = '${memoryId.replace(/'/g, "''")}'`);
+        if (anchorResult.length === 0 || anchorResult[0].values.length === 0)
+            return [];
+        const anchorTs = anchorResult[0].values[0][0];
+        // Get before + anchor + after
+        const result = this.db.exec(`SELECT id, title, type, created_at FROM (
+         SELECT id, title, type, created_at FROM memories
+         WHERE created_at <= ${anchorTs}
+         ORDER BY created_at DESC LIMIT ${window + 1}
+       )
+       UNION ALL
+       SELECT id, title, type, created_at FROM (
+         SELECT id, title, type, created_at FROM memories
+         WHERE created_at > ${anchorTs}
+         ORDER BY created_at ASC LIMIT ${window}
+       )
+       ORDER BY created_at ASC`);
+        if (result.length === 0)
+            return [];
+        return result[0].values.map((row) => ({
+            id: row[0],
+            title: row[1],
+            type: row[2],
+            createdAt: row[3],
+        }));
+    }
+    // --- Persistence ---
+    getDbSizeBytes() {
+        if (!this.db)
+            return 0;
+        return this.db.export().byteLength;
+    }
+    saveToDisk() {
+        if (!this.db)
+            return;
+        const dir = join(this.dbPath, '..');
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        const data = this.db.export();
+        writeFileSync(this.dbPath, data);
+    }
+    close() {
+        if (this.db) {
+            this.saveToDisk();
+            this.db.close();
+            this.db = null;
+            this.initialized = false;
+        }
+    }
+    rowToMemory(row) {
+        return {
+            id: row[0],
+            type: row[1],
+            title: row[2],
+            content: row[3],
+            project: row[4],
+            tags: JSON.parse(row[5] || '[]'),
+            sessionId: row[6] || undefined,
+            createdAt: row[7],
+            updatedAt: row[8],
+            accessedAt: row[9],
+        };
+    }
+}
+//# sourceMappingURL=memory-store.js.map

package/dist/memory/memory-store.js.map

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

package/dist/memory/memory-types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Memory System Type Definitions
+ *
+ * Core types for the persistent memory system with BM25 + HNSW hybrid search.
+ */
+export type MemoryType = 'bugfix' | 'feature' | 'refactor' | 'decision' | 'discovery' | 'change' | 'observation';
+export type SearchMode = 'bm25' | 'vector' | 'hybrid';
+export interface Memory {
+    id: string;
+    type: MemoryType;
+    title: string;
+    summary?: string;
+    content: string;
+    project: string;
+    tags: string[];
+    sessionId?: string;
+    createdAt: number;
+    updatedAt: number;
+    accessedAt: number;
+}
+export interface MemorySession {
+    id: string;
+    project: string;
+    status: 'active' | 'completed';
+    startedAt: number;
+    endedAt?: number;
+    summary?: string;
+    toolCalls: number;
+}
+export interface MemorySearchResult {
+    id: string;
+    title: string;
+    type: MemoryType;
+    score: number;
+    matchType: 'bm25' | 'vector' | 'both';
+    createdAt: number;
+}
+export interface MemorySearchOptions {
+    query: string;
+    mode?: SearchMode;
+    type?: MemoryType;
+    limit?: number;
+    project?: string;
+}
+export interface MemoryConfig {
+    enabled?: boolean;
+    dbPath?: string;
+    maxSizeBytes?: number;
+    autoCapture?: boolean;
+    vectorDimensions?: number;
+}
+export interface MemoryStats {
+    dbSizeBytes: number;
+    memoryCount: number;
+    sessionCount: number;
+    oldestMemory?: number;
+    newestMemory?: number;
+    maxSizeBytes: number;
+    usagePercent: number;
+    indexHealth: 'good' | 'degraded' | 'needs-rebuild';
+}
+export interface TimelineEntry {
+    id: string;
+    title: string;
+    type: MemoryType;
+    createdAt: number;
+    position: 'before' | 'anchor' | 'after';
+    distanceFromAnchor: number;
+}
+//# sourceMappingURL=memory-types.d.ts.map

package/dist/memory/memory-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-types.d.ts","sourceRoot":"","sources":["../../src/memory/memory-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,SAAS,GACT,UAAU,GACV,UAAU,GACV,WAAW,GACX,QAAQ,GACR,aAAa,CAAC;AAElB,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEtD,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,UAAU,GAAG,eAAe,CAAC;CACpD;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IACxC,kBAAkB,EAAE,MAAM,CAAC;CAC5B"}

package/dist/memory/memory-types.js

@@ -0,0 +1,7 @@
+/**
+ * Memory System Type Definitions
+ *
+ * Core types for the persistent memory system with BM25 + HNSW hybrid search.
+ */
+export {};
+//# sourceMappingURL=memory-types.js.map

package/dist/memory/memory-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-types.js","sourceRoot":"","sources":["../../src/memory/memory-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/memory/memory-vectorizer.d.ts

@@ -0,0 +1,29 @@
+/**
+ * TF-IDF Vectorizer with Feature Hashing (FNV1a)
+ *
+ * Generates fixed-dimension text embeddings using TF-IDF weighting
+ * with feature hashing (hashing trick). Zero external dependencies.
+ */
+/**
+ * FNV-1a hash function - fast, simple, good distribution
+ */
+export declare function fnv1a(str: string): number;
+/**
+ * Tokenize text: lowercase, split on non-word chars, remove stop words
+ */
+export declare function tokenize(text: string): string[];
+/**
+ * Vectorize text using TF-IDF with feature hashing
+ *
+ * 1. Tokenize and compute term frequencies
+ * 2. Hash each token to a bucket via FNV1a
+ * 3. Apply TF weight (1 + log(tf)) to bucket
+ * 4. L2-normalize the result
+ */
+export declare function vectorize(text: string, dimensions?: number): Float32Array;
+/**
+ * Cosine similarity between two vectors
+ * Returns value between -1 and 1 (1 = identical, 0 = orthogonal)
+ */
+export declare function cosineSimilarity(a: Float32Array, b: Float32Array): number;
+//# sourceMappingURL=memory-vectorizer.d.ts.map

package/dist/memory/memory-vectorizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-vectorizer.d.ts","sourceRoot":"","sources":["../../src/memory/memory-vectorizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH;;GAEG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOzC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAK/C;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAA2B,GACtC,YAAY,CAqCd;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAmBzE"}

package/dist/memory/memory-vectorizer.js

@@ -0,0 +1,104 @@
+/**
+ * TF-IDF Vectorizer with Feature Hashing (FNV1a)
+ *
+ * Generates fixed-dimension text embeddings using TF-IDF weighting
+ * with feature hashing (hashing trick). Zero external dependencies.
+ */
+const DEFAULT_DIMENSIONS = 256;
+const STOP_WORDS = new Set([
+    'a', 'an', 'the', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for',
+    'of', 'with', 'by', 'from', 'is', 'it', 'as', 'be', 'was', 'were',
+    'been', 'are', 'am', 'do', 'does', 'did', 'have', 'has', 'had',
+    'will', 'would', 'could', 'should', 'may', 'might', 'shall', 'can',
+    'not', 'no', 'nor', 'so', 'if', 'then', 'than', 'that', 'this',
+    'these', 'those', 'what', 'which', 'who', 'whom', 'when', 'where',
+    'why', 'how', 'all', 'each', 'every', 'both', 'few', 'more', 'most',
+    'some', 'any', 'such', 'only', 'own', 'same', 'too', 'very',
+    'just', 'about', 'above', 'after', 'again', 'also', 'because',
+    'before', 'between', 'during', 'into', 'out', 'over', 'under',
+    'up', 'down', 'here', 'there', 'other', 'its', 'my', 'your',
+    'his', 'her', 'our', 'their', 'i', 'you', 'he', 'she', 'we', 'they',
+    'me', 'him', 'us', 'them',
+]);
+/**
+ * FNV-1a hash function - fast, simple, good distribution
+ */
+export function fnv1a(str) {
+    let hash = 0x811c9dc5; // FNV offset basis (32-bit)
+    for (let i = 0; i < str.length; i++) {
+        hash ^= str.charCodeAt(i);
+        hash = (hash * 0x01000193) | 0; // FNV prime, force 32-bit
+    }
+    return hash >>> 0; // unsigned
+}
+/**
+ * Tokenize text: lowercase, split on non-word chars, remove stop words
+ */
+export function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/\W+/)
+        .filter((token) => token.length > 1 && !STOP_WORDS.has(token));
+}
+/**
+ * Vectorize text using TF-IDF with feature hashing
+ *
+ * 1. Tokenize and compute term frequencies
+ * 2. Hash each token to a bucket via FNV1a
+ * 3. Apply TF weight (1 + log(tf)) to bucket
+ * 4. L2-normalize the result
+ */
+export function vectorize(text, dimensions = DEFAULT_DIMENSIONS) {
+    const vector = new Float32Array(dimensions);
+    const tokens = tokenize(text);
+    if (tokens.length === 0) {
+        return vector;
+    }
+    // Compute term frequencies
+    const tf = new Map();
+    for (const token of tokens) {
+        tf.set(token, (tf.get(token) || 0) + 1);
+    }
+    // Hash tokens to buckets with TF-IDF weight
+    for (const [token, count] of tf) {
+        const bucket = fnv1a(token) % dimensions;
+        const weight = 1 + Math.log(count); // TF weight: 1 + log(tf)
+        // Use sign hashing to reduce collision bias
+        const sign = fnv1a(token + '_sign') % 2 === 0 ? 1 : -1;
+        vector[bucket] += sign * weight;
+    }
+    // L2 normalize
+    let magnitude = 0;
+    for (let i = 0; i < dimensions; i++) {
+        magnitude += vector[i] * vector[i];
+    }
+    magnitude = Math.sqrt(magnitude);
+    if (magnitude > 0) {
+        for (let i = 0; i < dimensions; i++) {
+            vector[i] /= magnitude;
+        }
+    }
+    return vector;
+}
+/**
+ * Cosine similarity between two vectors
+ * Returns value between -1 and 1 (1 = identical, 0 = orthogonal)
+ */
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error(`Vector dimensions mismatch: ${a.length} vs ${b.length}`);
+    }
+    let dot = 0;
+    let magA = 0;
+    let magB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        magA += a[i] * a[i];
+        magB += b[i] * b[i];
+    }
+    const denominator = Math.sqrt(magA) * Math.sqrt(magB);
+    if (denominator === 0)
+        return 0;
+    return dot / denominator;
+}
+//# sourceMappingURL=memory-vectorizer.js.map

package/dist/memory/memory-vectorizer.js.map

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