phaibel 4.0.7

package/dist/dobbie.txt

@@ -0,0 +1,55 @@
+                                               .......                                              
+                                            .:------::::...                                         
+                                          .-==------::::::..                                        
+                                       ..:==---------::::--:...                                     
+                               ....::::-=+++====-----====-------:.....                              
+                              .-=+***++=++++***++=:=+***=+====****+=-..                             
+                            .:=+===++***++++*#*++-::-+*+-===+##*+==++=:.                            
+                           .:==++++++****+++++==+=::::----===*#*+*+++++:.                           
+                          ..--===++++++*+++===++++==-==--===+**++++-::=-.                           
+                                .:==++++++===++++++++========--=-:........                          
+                                   ..::..:==+++++==+--=+==:......                                   
+                                      .. ..-=+++*****+++=:.                                         
+                                           ..-=========-....                                        
+                                            ..+*++++++==:.....                                      
+                                        .....=*+++++++==-=+:....                                    
+                                       .:::---=+======-:::-:.::..                                   
+                                       -=-:---======---::::...:....                                 
+                                    ..-==::::::--==---::...:.:--:..                                 
+                                    .:==-::::::::::::..:-=-:::-=-:.                                 
+                                    .-==:::::::::::::-=#%%*-::==--..                                
+                                   ..==+:::::::::::-+%@@%+*#*-++=-:..                               
+                                   .:=-=:::::::::-*%@@@%*+=--:-==--..                               
+                                   .=--=:::::::::-#%@@@*=--:---:-=-:..                              
+                                  .----=--::::::-::=%%%*+=====-:--==:.                              
+                                  :=---+---::-::--:--==+====--===----.                              
+                                  -==--==------::------=%@@@%#+=====-..                             
+                                  :===---::-----------=*#%%%%%*..---:.                              
+                                  ..:-==---::::-===========--=-......                               
+                                    ..:-===-------======---=++-......                               
+                                      .:-==--===========-=+*+-:......                               
+                                      .-::::--====-====+*+==--:......                               
+                                      .-----:::--===-=****+=::.......                               
+                                      .:--::::::-----------:::...                                   
+                                      ..::::::---------::::::...                                    
+                                       ..::::::---:..:======-.                                      
+                                        ..::::::::....-==--=-.                                      
+                                        ..:::::-:.....:==----...                                    
+                                         .-==--=:.    .==----...                                    
+                                         .-====-..    .===-=-...                                    
+                                         .-====-..   .-=====..                                      
+                                         .:=====..   :=====:....                                    
+                                         .:=====:.   -==---...                                      
+                                         .:-=--=:.   :==---....                                     
+                                         .:==-=-..   :==---...                                      
+                                         .:====:..   .====-...                                      
+                                          :====:.   ..-===:...                                      
+                                         .:====...   .:==-:...                                      
+                                        ..-====:.... .:==--...                                      
+                                        .-=====:......-===-::..                                     
+                                      .:==---==:.... .====-:::...                                   
+                                    .:-=-----==:.... .=====-::::::...                               
+                                  ..-====-----:..... .:-===--:-----:..                              
+                                  .=======---:......   ..:-=---=--==:.                              
+                                   .:====----.......      .-==--=--:..                              
+                                    .....::..               ..::......                              

package/dist/entities/embedding-index.d.ts

@@ -0,0 +1,26 @@
+import type { IndexNode } from './entity-index.js';
+import type { EntityIndex } from './entity-index.js';
+import type { EntityTypeName } from './entity.js';
+export interface EmbeddingSearchResult {
+    key: string;
+    similarity: number;
+}
+export interface SyncResult {
+    added: number;
+    updated: number;
+    removed: number;
+}
+export declare class EmbeddingIndex {
+    private store;
+    private dirty;
+    private _loaded;
+    get isLoaded(): boolean;
+    load(): Promise<void>;
+    save(): Promise<void>;
+    sync(entityIndex: EntityIndex): Promise<SyncResult>;
+    upsert(key: string, node: Pick<IndexNode, 'title' | 'tags' | 'summary'>): Promise<void>;
+    remove(key: string): void;
+    search(query: string, topK?: number, entityType?: EntityTypeName): Promise<EmbeddingSearchResult[]>;
+}
+export declare function getEmbeddingIndex(): EmbeddingIndex;
+//# sourceMappingURL=embedding-index.d.ts.map

package/dist/entities/embedding-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-index.d.ts","sourceRoot":"","sources":["../../src/entities/embedding-index.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAmBlD,MAAM,WAAW,qBAAqB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACnB;AAuCD,qBAAa,cAAc;IACvB,OAAO,CAAC,KAAK,CAKX;IACF,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAS;IAExB,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrB,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IA0DnD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB7F,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IASnB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAI,EAAE,UAAU,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;CA2BvG;AAQD,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD"}

package/dist/entities/embedding-index.js

@@ -0,0 +1,200 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// EMBEDDING INDEX
+// Semantic search layer for entities using OpenAI embeddings.
+// Vectors persist to ~/.phaibel/embeddings.json and load into memory on startup.
+// ─────────────────────────────────────────────────────────────────────────────
+import { promises as fs } from 'fs';
+import path from 'path';
+import { getEmbeddings } from '../llm/router.js';
+import { debug } from '../utils/debug.js';
+import { getEmbeddingsPath } from '../paths.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// HELPERS
+// ─────────────────────────────────────────────────────────────────────────────
+const MODEL = 'text-embedding-3-small';
+const DIMENSIONS = 256;
+const BATCH_SIZE = 100;
+const SIMILARITY_THRESHOLD = 0.5;
+function cosineSimilarity(a, b) {
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+function buildEmbeddingText(node) {
+    const parts = [node.title];
+    if (node.tags.length > 0) {
+        parts.push(`tags: ${node.tags.join(', ')}`);
+    }
+    if (node.summary) {
+        parts.push(node.summary);
+    }
+    return parts.join(' | ');
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// EMBEDDING INDEX
+// ─────────────────────────────────────────────────────────────────────────────
+export class EmbeddingIndex {
+    store = {
+        version: 1,
+        model: MODEL,
+        dimensions: DIMENSIONS,
+        entries: {},
+    };
+    dirty = false;
+    _loaded = false;
+    get isLoaded() {
+        return this._loaded;
+    }
+    async load() {
+        try {
+            const embeddingsPath = await getEmbeddingsPath();
+            const raw = await fs.readFile(embeddingsPath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            // If model or dimensions changed, purge and re-embed on next sync
+            if (parsed.model !== MODEL || parsed.dimensions !== DIMENSIONS) {
+                debug('embeddings', `Model/dimensions changed (${parsed.model}/${parsed.dimensions} → ${MODEL}/${DIMENSIONS}), purging`);
+                this.store = { version: 1, model: MODEL, dimensions: DIMENSIONS, entries: {} };
+                this.dirty = true;
+            }
+            else {
+                this.store = parsed;
+            }
+        }
+        catch {
+            // File doesn't exist or is corrupted — start fresh
+            debug('embeddings', 'No embeddings.json found, starting fresh');
+        }
+        this._loaded = true;
+    }
+    async save() {
+        if (!this.dirty)
+            return;
+        const embeddingsPath = await getEmbeddingsPath();
+        await fs.mkdir(path.dirname(embeddingsPath), { recursive: true });
+        await fs.writeFile(embeddingsPath, JSON.stringify(this.store));
+        this.dirty = false;
+    }
+    async sync(entityIndex) {
+        const nodes = entityIndex.getNodes();
+        const result = { added: 0, updated: 0, removed: 0 };
+        // Build set of current keys
+        const currentKeys = new Set();
+        const toEmbed = [];
+        for (const node of nodes) {
+            const key = `${node.type}:${node.id}`;
+            currentKeys.add(key);
+            const text = buildEmbeddingText(node);
+            const existing = this.store.entries[key];
+            if (!existing || existing.text !== text) {
+                toEmbed.push({ key, text });
+            }
+        }
+        // Remove stale entries
+        for (const key of Object.keys(this.store.entries)) {
+            if (!currentKeys.has(key)) {
+                delete this.store.entries[key];
+                result.removed++;
+                this.dirty = true;
+            }
+        }
+        // Batch embed new/changed entries
+        for (let i = 0; i < toEmbed.length; i += BATCH_SIZE) {
+            const batch = toEmbed.slice(i, i + BATCH_SIZE);
+            const texts = batch.map(b => b.text);
+            try {
+                const vectors = await getEmbeddings(texts, DIMENSIONS);
+                const now = new Date().toISOString();
+                for (let j = 0; j < batch.length; j++) {
+                    const isNew = !this.store.entries[batch[j].key];
+                    this.store.entries[batch[j].key] = {
+                        text: batch[j].text,
+                        vector: vectors[j],
+                        updatedAt: now,
+                    };
+                    if (isNew)
+                        result.added++;
+                    else
+                        result.updated++;
+                }
+                this.dirty = true;
+            }
+            catch (err) {
+                debug('embeddings', `Batch embed failed: ${err}`);
+                throw err;
+            }
+        }
+        await this.save();
+        return result;
+    }
+    async upsert(key, node) {
+        const text = buildEmbeddingText(node);
+        const existing = this.store.entries[key];
+        // Skip if text hasn't changed
+        if (existing?.text === text)
+            return;
+        try {
+            const [vector] = await getEmbeddings([text], DIMENSIONS);
+            this.store.entries[key] = {
+                text,
+                vector,
+                updatedAt: new Date().toISOString(),
+            };
+            this.dirty = true;
+            await this.save();
+        }
+        catch (err) {
+            debug('embeddings', `Failed to embed ${key}: ${err}`);
+        }
+    }
+    remove(key) {
+        if (this.store.entries[key]) {
+            delete this.store.entries[key];
+            this.dirty = true;
+            // Save asynchronously — fire and forget
+            this.save().catch(err => debug('embeddings', `Failed to save after remove: ${err}`));
+        }
+    }
+    async search(query, topK = 5, entityType) {
+        const entries = Object.entries(this.store.entries);
+        if (entries.length === 0)
+            return [];
+        let queryVector;
+        try {
+            [queryVector] = await getEmbeddings([query], DIMENSIONS);
+        }
+        catch (err) {
+            debug('embeddings', `Failed to embed query: ${err}`);
+            return [];
+        }
+        const results = [];
+        for (const [key, entry] of entries) {
+            // Filter by entity type if specified
+            if (entityType && !key.startsWith(`${entityType}:`))
+                continue;
+            const similarity = cosineSimilarity(queryVector, entry.vector);
+            if (similarity >= SIMILARITY_THRESHOLD) {
+                results.push({ key, similarity });
+            }
+        }
+        results.sort((a, b) => b.similarity - a.similarity);
+        return results.slice(0, topK);
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// SINGLETON
+// ─────────────────────────────────────────────────────────────────────────────
+let _embeddingIndex = null;
+export function getEmbeddingIndex() {
+    if (!_embeddingIndex) {
+        _embeddingIndex = new EmbeddingIndex();
+    }
+    return _embeddingIndex;
+}
+//# sourceMappingURL=embedding-index.js.map

package/dist/entities/embedding-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-index.js","sourceRoot":"","sources":["../../src/entities/embedding-index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,kBAAkB;AAClB,8DAA8D;AAC9D,iFAAiF;AACjF,gFAAgF;AAEhF,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAiChD,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,MAAM,KAAK,GAAG,wBAAwB,CAAC;AACvC,MAAM,UAAU,GAAG,GAAG,CAAC;AACvB,MAAM,UAAU,GAAG,GAAG,CAAC;AACvB,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC,SAAS,gBAAgB,CAAC,CAAW,EAAE,CAAW;IAC9C,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC;AACzC,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAmD;IAC3E,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,MAAM,OAAO,cAAc;IACf,KAAK,GAAmB;QAC5B,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,KAAK;QACZ,UAAU,EAAE,UAAU;QACtB,OAAO,EAAE,EAAE;KACd,CAAC;IACM,KAAK,GAAG,KAAK,CAAC;IACd,OAAO,GAAG,KAAK,CAAC;IAExB,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,IAAI;QACN,IAAI,CAAC;YACD,MAAM,cAAc,GAAG,MAAM,iBAAiB,EAAE,CAAC;YACjD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;YAEjD,kEAAkE;YAClE,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,IAAI,MAAM,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBAC7D,KAAK,CAAC,YAAY,EAAE,6BAA6B,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,UAAU,MAAM,KAAK,IAAI,UAAU,YAAY,CAAC,CAAC;gBACzH,IAAI,CAAC,KAAK,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;gBAC/E,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;YACxB,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACL,mDAAmD;YACnD,KAAK,CAAC,YAAY,EAAE,0CAA0C,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,IAAI;QACN,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QACxB,MAAM,cAAc,GAAG,MAAM,iBAAiB,EAAE,CAAC;QACjD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,MAAM,EAAE,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/D,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,WAAwB;QAC/B,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC;QACrC,MAAM,MAAM,GAAe,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QAEhE,4BAA4B;QAC5B,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;QACtC,MAAM,OAAO,GAAoC,EAAE,CAAC;QAEpD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACtC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACrB,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACzC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACtC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;YAChC,CAAC;QACL,CAAC;QAED,uBAAuB;QACvB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC/B,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YACtB,CAAC;QACL,CAAC;QAED,kCAAkC;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC;YAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAErC,IAAI,CAAC;gBACD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;gBACvD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBAErC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACpC,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;oBAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG;wBAC/B,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;wBACnB,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;wBAClB,SAAS,EAAE,GAAG;qBACjB,CAAC;oBACF,IAAI,KAAK;wBAAE,MAAM,CAAC,KAAK,EAAE,CAAC;;wBACrB,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC1B,CAAC;gBACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YACtB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,KAAK,CAAC,YAAY,EAAE,uBAAuB,GAAG,EAAE,CAAC,CAAC;gBAClD,MAAM,GAAG,CAAC;YACd,CAAC;QACL,CAAC;QAED,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW,EAAE,IAAmD;QACzE,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEzC,8BAA8B;QAC9B,IAAI,QAAQ,EAAE,IAAI,KAAK,IAAI;YAAE,OAAO;QAEpC,IAAI,CAAC;YACD,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;YACzD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG;gBACtB,IAAI;gBACJ,MAAM;gBACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC;YACF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,KAAK,CAAC,YAAY,EAAE,mBAAmB,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC;QAC1D,CAAC;IACL,CAAC;IAED,MAAM,CAAC,GAAW;QACd,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,wCAAwC;YACxC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,gCAAgC,GAAG,EAAE,CAAC,CAAC,CAAC;QACzF,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,IAAI,GAAG,CAAC,EAAE,UAA2B;QAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEpC,IAAI,WAAqB,CAAC;QAC1B,IAAI,CAAC;YACD,CAAC,WAAW,CAAC,GAAG,MAAM,aAAa,CAAC,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,KAAK,CAAC,YAAY,EAAE,0BAA0B,GAAG,EAAE,CAAC,CAAC;YACrD,OAAO,EAAE,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAA4B,EAAE,CAAC;QAE5C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;YACjC,qCAAqC;YACrC,IAAI,UAAU,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,CAAC;gBAAE,SAAS;YAE9D,MAAM,UAAU,GAAG,gBAAgB,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YAC/D,IAAI,UAAU,IAAI,oBAAoB,EAAE,CAAC;gBACrC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;YACtC,CAAC;QACL,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;QACpD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;CACJ;AAED,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,IAAI,eAAe,GAA0B,IAAI,CAAC;AAElD,MAAM,UAAU,iBAAiB;IAC7B,IAAI,CAAC,eAAe,EAAE,CAAC;QACnB,eAAe,GAAG,IAAI,cAAc,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO,eAAe,CAAC;AAC3B,CAAC"}

package/dist/entities/entity-index.d.ts

@@ -0,0 +1,74 @@
+import { type EntityTypeName } from './entity.js';
+export interface IndexNode {
+    id: string;
+    type: EntityTypeName;
+    title: string;
+    filepath: string;
+    tags: string[];
+    summary: string;
+}
+export interface IndexSearchResult {
+    node: IndexNode;
+    score: number;
+}
+export interface IndexEdge {
+    source: string;
+    target: string;
+    edgeType: 'mention' | 'reference' | 'link';
+    label?: string;
+}
+export interface IndexStats {
+    nodeCount: number;
+    edgeCount: number;
+    byType: Record<string, number>;
+    builtAt: string;
+}
+export declare class EntityIndex {
+    private nodes;
+    private edges;
+    private _builtAt;
+    private static key;
+    /**
+     * Scan all entity directories, build node map and edge list.
+     */
+    build(): Promise<void>;
+    /**
+     * Clear and rebuild the index.
+     */
+    rebuild(): Promise<void>;
+    get isBuilt(): boolean;
+    /**
+     * Add or update a single node and re-scan its content for edges.
+     * Avoids a full rebuild when a single entity is created or modified.
+     */
+    addOrUpdate(type: EntityTypeName, id: string, title: string, filepath: string, tags?: string[], summary?: string): Promise<void>;
+    /**
+     * Remove a node and all its inbound/outbound edges.
+     */
+    remove(type: EntityTypeName, id: string): void;
+    /**
+     * Search nodes by query against title, tags, and summary.
+     * Tokenizes query; scoring: title=3, tag=2, summary=1 per token.
+     * All tokens must match at least one field.
+     */
+    search(query: string, entityType?: EntityTypeName): IndexSearchResult[];
+    /**
+     * Find a single node by exact or partial title match.
+     * Exact match on id or title (case-insensitive), fallback to partial.
+     */
+    findByTitle(entityType: EntityTypeName, titleOrId: string): IndexNode | null;
+    getNode(key: string): IndexNode | undefined;
+    getNodes(type?: EntityTypeName): IndexNode[];
+    getEdgesFrom(key: string): IndexEdge[];
+    getEdgesTo(key: string): IndexEdge[];
+    getNeighbors(key: string): {
+        node: IndexNode;
+        direction: 'out' | 'in';
+        edgeType: string;
+        label?: string;
+    }[];
+    getAllEdges(): IndexEdge[];
+    getStats(): IndexStats;
+}
+export declare function getEntityIndex(): EntityIndex;
+//# sourceMappingURL=entity-index.d.ts.map

package/dist/entities/entity-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-index.d.ts","sourceRoot":"","sources":["../../src/entities/entity-index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAe,KAAK,cAAc,EAAmB,MAAM,aAAa,CAAC;AAShF,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;CACnB;AAwBD,qBAAa,WAAW;IACpB,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,QAAQ,CAAqB;IAIrC,OAAO,CAAC,MAAM,CAAC,GAAG;IAMlB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+G5B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAS9B,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;OAGG;IACG,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CtI;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAS9C;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,cAAc,GAAG,iBAAiB,EAAE;IA0DvE;;;OAGG;IACH,WAAW,CAAC,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IA0B5E,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI3C,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,SAAS,EAAE;IAK5C,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE;IAItC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE;IAIpC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,SAAS,EAAE,KAAK,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE;IAwB3G,WAAW,IAAI,SAAS,EAAE;IAI1B,QAAQ,IAAI,UAAU;CAYzB;AAQD,wBAAgB,cAAc,IAAI,WAAW,CAK5C"}