specmem-hardwicksoftware 3.5.99

package/dist/memorization/codeMemorizer.js

@@ -0,0 +1,357 @@
+/**
+ * codeMemorizer.ts - Main Auto-Memorization System for AI-Generated Code
+ *
+ * yooo this is THE BRAIN that remembers everything the assistant writes
+ * no more massive explores - the system will KNOW what it wrote and WHY
+ *
+ * fr fr when AI writes code, this system:
+ * 1. Captures the code that was written
+ * 2. Stores it with rich metadata
+ * 3. Tracks WHY it was written
+ * 4. Links to related files
+ * 5. Makes it all searchable
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { logger } from '../utils/logger.js';
+import { getLanguageDetector } from '../codebase/languageDetection.js';
+/**
+ * CodeMemorizer - THE BRAIN that remembers AI-generated code
+ *
+ * nah bruh the assistant never forgets what it wrote now
+ * this is the core system for auto-memorization
+ */
+export class CodeMemorizer {
+    pool;
+    embeddingProvider;
+    // stats tracking - gotta know how much the assistant remembers
+    stats = {
+        codesMemorized: 0,
+        totalCharacters: 0,
+        uniqueFiles: new Set(),
+        operationCounts: {
+            write: 0,
+            edit: 0,
+            notebook_edit: 0,
+            create: 0,
+            update: 0,
+            delete: 0
+        },
+        errors: 0,
+        lastMemorizedAt: null
+    };
+    constructor(pool, embeddingProvider) {
+        this.pool = pool;
+        this.embeddingProvider = embeddingProvider;
+    }
+    /**
+     * rememberWhatIJustWrote - THE MAIN METHOD
+     *
+     * yooo the assistant just wrote some fire code lets memorize it
+     * this is what gets called after using Write, Edit, or NotebookEdit
+     */
+    async rememberWhatIJustWrote(params) {
+        const startTime = Date.now();
+        const id = uuidv4();
+        logger.info({
+            filePath: params.filePath,
+            codeLength: params.codeWritten.length,
+            purpose: params.purpose.slice(0, 100)
+        }, 'memorizing code that was just written');
+        try {
+            // extract filename from path
+            const fileName = params.filePath.split('/').pop() || params.filePath;
+            // detect programming language
+            const languageDetector = getLanguageDetector();
+            const languageInfo = languageDetector.detect(params.filePath);
+            const language = languageInfo?.id || 'unknown';
+            // determine operation type
+            const operationType = params.operationType || 'write';
+            // get version number for this file
+            const version = await this.getNextVersion(params.filePath);
+            // generate embedding for semantic search
+            // this is the SECRET SAUCE for finding code later
+            const embeddingText = `${params.purpose}\n\n${params.codeWritten}`;
+            const embedding = await this.cookTheEmbeddings(embeddingText);
+            // prepare tags
+            const tags = [
+                ...(params.tags || []),
+                'assistant-written',
+                'auto-memorized',
+                `lang:${language}`,
+                `op:${operationType}`
+            ];
+            // prepare metadata
+            const metadata = {
+                ...params.metadata,
+                memorizedAt: new Date().toISOString(),
+                codeLength: params.codeWritten.length,
+                languageInfo,
+                source: 'code-memorizer'
+            };
+            // YEET IT INTO THE DATABASE
+            await this.yeetCodeIntoDb({
+                id,
+                filePath: params.filePath,
+                fileName,
+                codeContent: params.codeWritten,
+                purpose: params.purpose,
+                conversationContext: params.conversationContext,
+                operationType,
+                language,
+                relatedFiles: params.relatedFiles || [],
+                parentCodeId: params.parentCodeId,
+                tags,
+                metadata,
+                embedding,
+                version
+            });
+            // update stats
+            this.stats.codesMemorized++;
+            this.stats.totalCharacters += params.codeWritten.length;
+            this.stats.uniqueFiles.add(params.filePath);
+            this.stats.operationCounts[operationType]++;
+            this.stats.lastMemorizedAt = new Date();
+            const duration = Date.now() - startTime;
+            logger.info({
+                codeId: id,
+                filePath: params.filePath,
+                version,
+                duration
+            }, 'code memorized successfully - will remember this');
+            return {
+                success: true,
+                codeId: id,
+                version,
+                message: `memorized code at ${params.filePath} (v${version}) - took ${duration}ms`
+            };
+        }
+        catch (error) {
+            this.stats.errors++;
+            logger.error({ error, params }, 'failed to memorize code - this is NOT it');
+            return {
+                success: false,
+                message: error instanceof Error ? error.message : 'memorization failed for unknown reason'
+            };
+        }
+    }
+    /**
+     * yeetCodeIntoDb - insert the code into database
+     *
+     * fr fr this is where the magic happens
+     */
+    async yeetCodeIntoDb(params) {
+        const client = await this.pool.connect();
+        try {
+            await client.query(`INSERT INTO claude_code_history (
+          id, file_path, file_name, code_content, purpose,
+          conversation_context, operation_type, language,
+          related_files, parent_code_id, tags, metadata,
+          embedding, version
+        ) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14)`, [
+                params.id,
+                params.filePath,
+                params.fileName,
+                params.codeContent,
+                params.purpose,
+                params.conversationContext || null,
+                params.operationType,
+                params.language,
+                params.relatedFiles,
+                params.parentCodeId || null,
+                params.tags,
+                params.metadata,
+                params.embedding && params.embedding.length > 0
+                    ? `[${params.embedding.join(',')}]`
+                    : null,
+                params.version
+            ]);
+        }
+        finally {
+            client.release();
+        }
+    }
+    /**
+     * getNextVersion - get the next version number for a file
+     *
+     * tracking versions so we can see code evolution
+     */
+    async getNextVersion(filePath) {
+        const client = await this.pool.connect();
+        try {
+            const result = await client.query(`SELECT MAX(version) as max_version
+         FROM claude_code_history
+         WHERE file_path = $1`, [filePath]);
+            const currentMax = result.rows[0]?.max_version ?? 0;
+            return currentMax + 1;
+        }
+        finally {
+            client.release();
+        }
+    }
+    /**
+     * cookTheEmbeddings - generate embeddings for semantic search
+     *
+     * this is where we turn code + purpose into searchable vectors
+     */
+    async cookTheEmbeddings(text) {
+        try {
+            return await this.embeddingProvider.generateEmbedding(text);
+        }
+        catch (error) {
+            logger.warn({ error }, 'embedding generation failed - storing without vector');
+            return [];
+        }
+    }
+    /**
+     * getCodeByFilePath - get all code entries for a file
+     *
+     * lets see what was written for this file
+     */
+    async getCodeByFilePath(filePath, options = {}) {
+        const client = await this.pool.connect();
+        try {
+            let query = `
+        SELECT
+          id, file_path, file_name, code_content, code_hash,
+          purpose, conversation_context, operation_type, language,
+          related_files, related_memory_ids, parent_code_id,
+          tags, metadata, embedding, created_at, updated_at, version
+        FROM claude_code_history
+        WHERE file_path = $1
+      `;
+            if (!options.includeAllVersions) {
+                query += ` AND version = (
+          SELECT MAX(version)
+          FROM claude_code_history
+          WHERE file_path = $1
+        )`;
+            }
+            query += ` ORDER BY version DESC LIMIT $2`;
+            const result = await client.query(query, [
+                filePath,
+                options.limit || 10
+            ]);
+            return result.rows.map(this.mapRowToEntry);
+        }
+        finally {
+            client.release();
+        }
+    }
+    /**
+     * getRecentCode - get recently memorized code
+     *
+     * fr fr what was written recently?
+     */
+    async getRecentCode(options = {}) {
+        const client = await this.pool.connect();
+        try {
+            let query = `
+        SELECT
+          id, file_path, file_name, code_content, code_hash,
+          purpose, conversation_context, operation_type, language,
+          related_files, related_memory_ids, parent_code_id,
+          tags, metadata, embedding, created_at, updated_at, version
+        FROM claude_code_history
+        WHERE 1=1
+      `;
+            const params = [];
+            let paramIndex = 1;
+            if (options.operationType) {
+                query += ` AND operation_type = $${paramIndex++}`;
+                params.push(options.operationType);
+            }
+            if (options.language) {
+                query += ` AND language = $${paramIndex++}`;
+                params.push(options.language);
+            }
+            query += ` ORDER BY created_at DESC LIMIT $${paramIndex}`;
+            params.push(options.limit || 20);
+            const result = await client.query(query, params);
+            return result.rows.map(this.mapRowToEntry);
+        }
+        finally {
+            client.release();
+        }
+    }
+    /**
+     * getCodeHistory - get version history for a file
+     *
+     * see how the code evolved over time
+     */
+    async getCodeHistory(filePath) {
+        return this.getCodeByFilePath(filePath, {
+            includeAllVersions: true,
+            limit: 100
+        });
+    }
+    /**
+     * mapRowToEntry - convert database row to typed entry
+     */
+    mapRowToEntry(row) {
+        return {
+            id: row.id,
+            filePath: row.file_path,
+            fileName: row.file_name,
+            codeContent: row.code_content,
+            codeHash: row.code_hash,
+            purpose: row.purpose,
+            conversationContext: row.conversation_context ?? undefined,
+            operationType: row.operation_type,
+            language: row.language,
+            relatedFiles: row.related_files || [],
+            relatedMemoryIds: row.related_memory_ids || [],
+            parentCodeId: row.parent_code_id ?? undefined,
+            tags: row.tags || [],
+            metadata: row.metadata || {},
+            embedding: row.embedding ?? undefined,
+            createdAt: new Date(row.created_at),
+            updatedAt: new Date(row.updated_at),
+            version: row.version
+        };
+    }
+    /**
+     * getStats - return memorization statistics
+     *
+     * how much does the system remember?
+     */
+    getStats() {
+        return {
+            ...this.stats,
+            uniqueFilesCount: this.stats.uniqueFiles.size
+        };
+    }
+    /**
+     * linkToMemory - link code to a regular memory
+     *
+     * connecting code to memories for cross-referencing
+     */
+    async linkToMemory(codeId, memoryId) {
+        const client = await this.pool.connect();
+        try {
+            await client.query(`UPDATE claude_code_history
+         SET related_memory_ids = array_append(related_memory_ids, $2)
+         WHERE id = $1
+           AND NOT ($2 = ANY(related_memory_ids))`, [codeId, memoryId]);
+        }
+        finally {
+            client.release();
+        }
+    }
+}
+/**
+ * Export singleton creator
+ */
+let _memorizer = null;
+export function getCodeMemorizer(pool, embeddingProvider) {
+    if (!_memorizer && pool && embeddingProvider) {
+        _memorizer = new CodeMemorizer(pool, embeddingProvider);
+    }
+    if (!_memorizer) {
+        throw new Error('CodeMemorizer not initialized - provide pool and embedding provider');
+    }
+    return _memorizer;
+}
+export function resetCodeMemorizer() {
+    _memorizer = null;
+}
+//# sourceMappingURL=codeMemorizer.js.map

package/dist/memorization/codeMemorizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeMemorizer.js","sourceRoot":"","sources":["../../src/memorization/codeMemorizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAGpC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAoGvE;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IAChB,IAAI,CAAU;IACd,iBAAiB,CAAoB;IAE7C,+DAA+D;IACvD,KAAK,GAAG;QACd,cAAc,EAAE,CAAC;QACjB,eAAe,EAAE,CAAC;QAClB,WAAW,EAAE,IAAI,GAAG,EAAU;QAC9B,eAAe,EAAE;YACf,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,CAAC;YACP,aAAa,EAAE,CAAC;YAChB,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,CAAC;SACV;QACD,MAAM,EAAE,CAAC;QACT,eAAe,EAAE,IAAmB;KACrC,CAAC;IAEF,YAAY,IAAa,EAAE,iBAAoC;QAC7D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,sBAAsB,CAAC,MAA0B;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QAEpB,MAAM,CAAC,IAAI,CAAC;YACV,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM;YACrC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;SACtC,EAAE,uCAAuC,CAAC,CAAC;QAE5C,IAAI,CAAC;YACH,6BAA6B;YAC7B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC;YAErE,8BAA8B;YAC9B,MAAM,gBAAgB,GAAG,mBAAmB,EAAE,CAAC;YAC/C,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9D,MAAM,QAAQ,GAAG,YAAY,EAAE,EAAE,IAAI,SAAS,CAAC;YAE/C,2BAA2B;YAC3B,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,OAAO,CAAC;YAEtD,mCAAmC;YACnC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAE3D,yCAAyC;YACzC,kDAAkD;YAClD,MAAM,aAAa,GAAG,GAAG,MAAM,CAAC,OAAO,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC;YACnE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;YAE9D,eAAe;YACf,MAAM,IAAI,GAAG;gBACX,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;gBACtB,mBAAmB;gBACnB,gBAAgB;gBAChB,QAAQ,QAAQ,EAAE;gBAClB,MAAM,aAAa,EAAE;aACtB,CAAC;YAEF,mBAAmB;YACnB,MAAM,QAAQ,GAAG;gBACf,GAAG,MAAM,CAAC,QAAQ;gBAClB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACrC,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM;gBACrC,YAAY;gBACZ,MAAM,EAAE,gBAAgB;aACzB,CAAC;YAEF,4BAA4B;YAC5B,MAAM,IAAI,CAAC,cAAc,CAAC;gBACxB,EAAE;gBACF,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,QAAQ;gBACR,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;gBAC/C,aAAa;gBACb,QAAQ;gBACR,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE;gBACvC,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,IAAI;gBACJ,QAAQ;gBACR,SAAS;gBACT,OAAO;aACR,CAAC,CAAC;YAEH,eAAe;YACf,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,eAAe,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC;YACxD,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,aAAa,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,IAAI,IAAI,EAAE,CAAC;YAExC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC;gBACV,MAAM,EAAE,EAAE;gBACV,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,OAAO;gBACP,QAAQ;aACT,EAAE,kDAAkD,CAAC,CAAC;YAEvD,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,EAAE;gBACV,OAAO;gBACP,OAAO,EAAE,qBAAqB,MAAM,CAAC,QAAQ,MAAM,OAAO,YAAY,QAAQ,IAAI;aACnF,CAAC;QAEJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,0CAA0C,CAAC,CAAC;YAE5E,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wCAAwC;aAC3F,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,cAAc,CAAC,MAe5B;QACC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAEzC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,CAChB;;;;;+EAKuE,EACvE;gBACE,MAAM,CAAC,EAAE;gBACT,MAAM,CAAC,QAAQ;gBACf,MAAM,CAAC,QAAQ;gBACf,MAAM,CAAC,WAAW;gBAClB,MAAM,CAAC,OAAO;gBACd,MAAM,CAAC,mBAAmB,IAAI,IAAI;gBAClC,MAAM,CAAC,aAAa;gBACpB,MAAM,CAAC,QAAQ;gBACf,MAAM,CAAC,YAAY;gBACnB,MAAM,CAAC,YAAY,IAAI,IAAI;gBAC3B,MAAM,CAAC,IAAI;gBACX,MAAM,CAAC,QAAQ;gBACf,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;oBAC7C,CAAC,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;oBACnC,CAAC,CAAC,IAAI;gBACR,MAAM,CAAC,OAAO;aACf,CACF,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,cAAc,CAAC,QAAgB;QAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAEzC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAC/B;;8BAEsB,EACtB,CAAC,QAAQ,CAAC,CACX,CAAC;YAEF,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,IAAI,CAAC,CAAC;YACpD,OAAO,UAAU,GAAG,CAAC,CAAC;QACxB,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,iBAAiB,CAAC,IAAY;QAC1C,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,sDAAsD,CAAC,CAAC;YAC/E,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,iBAAiB,CACrB,QAAgB,EAChB,UAA4D,EAAE;QAE9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAEzC,IAAI,CAAC;YACH,IAAI,KAAK,GAAG;;;;;;;;OAQX,CAAC;YAEF,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;gBAChC,KAAK,IAAI;;;;UAIP,CAAC;YACL,CAAC;YAED,KAAK,IAAI,iCAAiC,CAAC;YAE3C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAiB,KAAK,EAAE;gBACvD,QAAQ;gBACR,OAAO,CAAC,KAAK,IAAI,EAAE;aACpB,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC7C,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,UAIhB,EAAE;QACJ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAEzC,IAAI,CAAC;YACH,IAAI,KAAK,GAAG;;;;;;;;OAQX,CAAC;YAEF,MAAM,MAAM,GAAe,EAAE,CAAC;YAC9B,IAAI,UAAU,GAAG,CAAC,CAAC;YAEnB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;gBAC1B,KAAK,IAAI,0BAA0B,UAAU,EAAE,EAAE,CAAC;gBAClD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YACrC,CAAC;YAED,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACrB,KAAK,IAAI,oBAAoB,UAAU,EAAE,EAAE,CAAC;gBAC5C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAChC,CAAC;YAED,KAAK,IAAI,oCAAoC,UAAU,EAAE,CAAC;YAC1D,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAEjC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAiB,KAAK,EAAE,MAAM,CAAC,CAAC;YAEjE,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC7C,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,QAAgB;QACnC,OAAO,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE;YACtC,kBAAkB,EAAE,IAAI;YACxB,KAAK,EAAE,GAAG;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,GAAmB;QACvC,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,WAAW,EAAE,GAAG,CAAC,YAAY;YAC7B,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,mBAAmB,EAAE,GAAG,CAAC,oBAAoB,IAAI,SAAS;YAC1D,aAAa,EAAE,GAAG,CAAC,cAAc;YACjC,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,YAAY,EAAE,GAAG,CAAC,aAAa,IAAI,EAAE;YACrC,gBAAgB,EAAE,GAAG,CAAC,kBAAkB,IAAI,EAAE;YAC9C,YAAY,EAAE,GAAG,CAAC,cAAc,IAAI,SAAS;YAC7C,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE;YACpB,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE;YAC5B,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,SAAS;YACrC,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;YACnC,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;YACnC,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACN,OAAO;YACL,GAAG,IAAI,CAAC,KAAK;YACb,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI;SAC9C,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,QAAgB;QACjD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAEzC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,CAChB;;;kDAG0C,EAC1C,CAAC,MAAM,EAAE,QAAQ,CAAC,CACnB,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,IAAI,UAAU,GAAyB,IAAI,CAAC;AAE5C,MAAM,UAAU,gBAAgB,CAC9B,IAAc,EACd,iBAAqC;IAErC,IAAI,CAAC,UAAU,IAAI,IAAI,IAAI,iBAAiB,EAAE,CAAC;QAC7C,UAAU,GAAG,IAAI,aAAa,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC"}

package/dist/memorization/codeRecall.d.ts

@@ -0,0 +1,156 @@
+/**
+ * codeRecall.ts - Recall AI-Generated Code from Memory
+ *
+ * nah bruh no more massive explores needed fr
+ * the system can now recall exactly what was written and WHY
+ *
+ * Features:
+ * - Semantic search for stored code
+ * - Search by purpose, file path, language
+ * - Get full version history
+ * - Find related code automatically
+ */
+import pg from 'pg';
+import { EmbeddingProvider } from '../tools/index.js';
+import { StoredCodeEntry, OperationType } from './codeMemorizer.js';
+/**
+ * Search options for finding code
+ */
+export interface CodeSearchOptions {
+    limit?: number;
+    threshold?: number;
+    operationType?: OperationType;
+    language?: string;
+    tags?: string[];
+    dateRange?: {
+        start?: Date;
+        end?: Date;
+    };
+    includeRelated?: boolean;
+    latestVersionOnly?: boolean;
+}
+/**
+ * Search result with similarity score
+ */
+export interface CodeSearchResult {
+    code: StoredCodeEntry;
+    similarity: number;
+    highlights?: string[];
+}
+/**
+ * Code timeline entry
+ */
+export interface CodeTimelineEntry {
+    code: StoredCodeEntry;
+    prevVersion?: string;
+    nextVersion?: string;
+}
+/**
+ * CodeRecall - THE BRAIN for remembering what was written
+ *
+ * fr fr never need massive explores again
+ * semantic search + filtering = finding code FAST
+ */
+export declare class CodeRecall {
+    private pool;
+    private embeddingProvider;
+    private stats;
+    constructor(pool: pg.Pool, embeddingProvider: EmbeddingProvider);
+    /**
+     * whatDidIWriteFor - THE MAIN SEARCH METHOD
+     *
+     * nah bruh no more explores needed fr
+     * semantic search for stored code
+     */
+    whatDidIWriteFor(query: string, options?: CodeSearchOptions): Promise<CodeSearchResult[]>;
+    /**
+     * allTheCodeIWrote - list all code  wrote
+     *
+     * skids cant find this code but  can lmao
+     */
+    allTheCodeIWrote(options?: {
+        limit?: number;
+        offset?: number;
+        operationType?: OperationType;
+        language?: string;
+        orderBy?: 'created' | 'updated' | 'file_path' | 'version';
+        orderDirection?: 'asc' | 'desc';
+    }): Promise<StoredCodeEntry[]>;
+    /**
+     * whyDidIWriteThis - get the context for why code was written
+     *
+     * fr fr helps  understand its own decisions
+     */
+    whyDidIWriteThis(codeId: string): Promise<{
+        code: StoredCodeEntry;
+        purpose: string;
+        context?: string;
+        relatedCode: StoredCodeEntry[];
+        previousVersions: StoredCodeEntry[];
+    } | null>;
+    /**
+     * getCodeHistory - get full version history for a file
+     *
+     * see how 's code evolved over time
+     */
+    getCodeHistory(filePath: string): Promise<CodeTimelineEntry[]>;
+    /**
+     * searchByFilePath - search by file path pattern
+     *
+     * find code by file path without semantic search
+     */
+    searchByFilePath(pathPattern: string, options?: {
+        limit?: number;
+        latestOnly?: boolean;
+    }): Promise<StoredCodeEntry[]>;
+    /**
+     * searchByPurpose - text search on purpose field
+     *
+     * find code by what it was meant to do
+     */
+    searchByPurpose(purposeQuery: string, options?: {
+        limit?: number;
+    }): Promise<StoredCodeEntry[]>;
+    /**
+     * findRelatedCode - find code related to a specific entry
+     *
+     * what else did  write around the same time?
+     */
+    findRelatedCode(codeId: string, options?: {
+        limit?: number;
+        windowMinutes?: number;
+    }): Promise<StoredCodeEntry[]>;
+    /**
+     * getCodeStats - get statistics about 's code
+     */
+    getCodeStats(): Promise<{
+        totalEntries: number;
+        uniqueFiles: number;
+        byOperation: Record<OperationType, number>;
+        byLanguage: Record<string, number>;
+        totalCharacters: number;
+        avgCodeLength: number;
+        oldestCode: Date | null;
+        newestCode: Date | null;
+    }>;
+    /**
+     * mapRowToEntry - convert database row to typed entry
+     */
+    private mapRowToEntry;
+    /**
+     * extractHighlights - extract matching snippets from code
+     */
+    private extractHighlights;
+    /**
+     * getStats - get recall statistics
+     */
+    getStats(): {
+        searches: number;
+        recalls: number;
+        cacheHits: number;
+        cacheMisses: number;
+    };
+}
+export declare function getCodeRecall(pool?: pg.Pool, embeddingProvider?: EmbeddingProvider): CodeRecall;
+export declare function resetCodeRecall(): void;
+//# sourceMappingURL=codeRecall.d.ts.map

package/dist/memorization/codeRecall.d.ts.map

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