@rbalchii/anchor-engine 4.7.0

package/engine/dist/services/search/llm-context-formatter.js

@@ -0,0 +1,394 @@
+/**
+ * LLM-Optimized Context Formatter
+ *
+ * Transforms search results from chronological dump to LLM-first structured format.
+ *
+ * Design Principles:
+ * 1. Structured over narrative - LLMs parse structured data better
+ * 2. Explicit relationships - Don't make the LLM infer connections
+ * 3. Relevance-ranked - Order by importance, not chronology
+ * 4. Token-efficient - Remove noise, keep signal
+ * 5. Entity-rich - Pre-extract people, systems, concepts
+ */
+// ============ Main Formatter Class ============
+export class LLMContextFormatter {
+    FORMAT_VERSION = '1.0.0';
+    /**
+     * Format atoms into LLM-optimized context
+     */
+    format(atoms, query, metadata) {
+        const entities = this.extractEntities(atoms);
+        const themes = this.clusterThemes(atoms);
+        const rankedAtoms = this.rankAndFormatAtoms(atoms, themes);
+        const timeline = this.buildTimeline(atoms);
+        const gaps = this.identifyGaps(atoms, query, entities);
+        return {
+            query,
+            context: {
+                summary: this.generateThemeSummary(atoms, query, entities),
+                entities,
+                themes,
+                timeline
+            },
+            atoms: rankedAtoms,
+            gaps,
+            metadata: {
+                total_atoms_searched: atoms.length,
+                atoms_returned: rankedAtoms.length,
+                search_latency_ms: 0, // Will be set by caller
+                dedup_removed: 0, // Will be set by caller
+                backend: 'pglite', // Will be set by caller
+                format_version: this.FORMAT_VERSION,
+                ...metadata
+            }
+        };
+    }
+    /**
+     * Extract entities from atoms (people, systems, concepts)
+     */
+    extractEntities(atoms) {
+        const entityMap = new Map();
+        // Common entity patterns
+        const personPatterns = [
+            /\b(Rob|Robert|Coda|Dory|Jade)\b/gi,
+            /\b(author|user|partner|collaborator)\b/gi
+        ];
+        const systemPatterns = [
+            /\b(Anchor Engine|ECE|External Context Engine|STAR|PGlite|SQLite)\b/gi,
+            /\b(C\+\+|Node\.js|TypeScript|React)\b/gi
+        ];
+        const conceptPatterns = [
+            /\b(POML|sovereign memory|context inflation|physics walker)\b/gi,
+            /\b(imposter syndrome|career|growth|change)\b/gi
+        ];
+        for (const atom of atoms) {
+            const text = `${atom.content} ${atom.tags?.join(' ') || ''}`.toLowerCase();
+            // Extract people
+            for (const pattern of personPatterns) {
+                pattern.lastIndex = 0;
+                let match;
+                while ((match = pattern.exec(text)) !== null) {
+                    const name = this.capitalize(match[1]);
+                    if (!entityMap.has(name)) {
+                        entityMap.set(name, {
+                            name,
+                            type: 'person',
+                            role: this.inferPersonRole(name, atoms),
+                            mentions: 0,
+                            related_topics: [],
+                            atom_ids: []
+                        });
+                    }
+                    const entity = entityMap.get(name);
+                    entity.mentions++;
+                    entity.atom_ids.push(atom.id);
+                    entity.related_topics = [...new Set([...entity.related_topics, ...this.extractTopics(atom)])];
+                }
+            }
+            // Extract systems/technologies
+            for (const pattern of systemPatterns) {
+                pattern.lastIndex = 0;
+                let match;
+                while ((match = pattern.exec(text)) !== null) {
+                    const name = match[1];
+                    if (!entityMap.has(name)) {
+                        entityMap.set(name, {
+                            name,
+                            type: this.classifySystem(name),
+                            role: 'technology',
+                            mentions: 0,
+                            related_topics: [],
+                            atom_ids: []
+                        });
+                    }
+                    const entity = entityMap.get(name);
+                    entity.mentions++;
+                    entity.atom_ids.push(atom.id);
+                    entity.related_topics = [...new Set([...entity.related_topics, ...this.extractTopics(atom)])];
+                }
+            }
+        }
+        // Sort by mentions and return top entities
+        return Array.from(entityMap.values())
+            .sort((a, b) => b.mentions - a.mentions)
+            .slice(0, 20); // Top 20 entities
+    }
+    /**
+     * Cluster atoms by theme using tag co-occurrence
+     */
+    clusterThemes(atoms) {
+        const tagCooccurrence = new Map();
+        // Build tag co-occurrence matrix
+        for (const atom of atoms) {
+            const tags = atom.tags || [];
+            for (let i = 0; i < tags.length; i++) {
+                for (let j = i + 1; j < tags.length; j++) {
+                    const tag1 = tags[i].toLowerCase();
+                    const tag2 = tags[j].toLowerCase();
+                    if (!tagCooccurrence.has(tag1)) {
+                        tagCooccurrence.set(tag1, new Map());
+                    }
+                    if (!tagCooccurrence.has(tag2)) {
+                        tagCooccurrence.set(tag2, new Map());
+                    }
+                    const map1 = tagCooccurrence.get(tag1);
+                    const map2 = tagCooccurrence.get(tag2);
+                    map1.set(tag2, (map1.get(tag2) || 0) + 1);
+                    map2.set(tag1, (map2.get(tag1) || 0) + 1);
+                }
+            }
+        }
+        // Find theme clusters
+        const themes = [];
+        const usedTags = new Set();
+        // Start with most frequent tags
+        const tagFrequency = new Map();
+        for (const atom of atoms) {
+            for (const tag of atom.tags || []) {
+                tagFrequency.set(tag.toLowerCase(), (tagFrequency.get(tag.toLowerCase()) || 0) + 1);
+            }
+        }
+        const sortedTags = Array.from(tagFrequency.entries())
+            .sort((a, b) => b[1] - a[1])
+            .map(([tag]) => tag);
+        // Create theme clusters
+        for (const seedTag of sortedTags) {
+            if (usedTags.has(seedTag))
+                continue;
+            const cluster = this.buildThemeCluster(seedTag, tagCooccurrence, atoms);
+            if (cluster.atom_ids.length >= 2) { // Only themes with 2+ atoms
+                themes.push(cluster);
+                cluster.keywords.forEach(tag => usedTags.add(tag));
+            }
+        }
+        return themes.slice(0, 10); // Top 10 themes
+    }
+    /**
+     * Build a theme cluster from a seed tag
+     */
+    buildThemeCluster(seedTag, cooccurrence, atoms) {
+        const relatedTags = new Set([seedTag]);
+        const atomIds = new Set();
+        // Find related tags (co-occur >= 2 times)
+        const seedMap = cooccurrence.get(seedTag);
+        if (seedMap) {
+            for (const [tag, count] of seedMap.entries()) {
+                if (count >= 2) {
+                    relatedTags.add(tag);
+                }
+            }
+        }
+        // Find atoms with these tags
+        for (const atom of atoms) {
+            const atomTags = atom.tags?.map(t => t.toLowerCase()) || [];
+            if (atomTags.some(tag => relatedTags.has(tag))) {
+                atomIds.add(atom.id);
+            }
+        }
+        // Generate theme name from tags
+        const themeName = this.generateThemeName(Array.from(relatedTags));
+        return {
+            name: themeName,
+            confidence: Math.min(1.0, atomIds.size / atoms.length),
+            atom_ids: Array.from(atomIds),
+            summary: `Theme: ${themeName} (${atomIds.size} atoms)`,
+            keywords: Array.from(relatedTags).slice(0, 5)
+        };
+    }
+    /**
+     * Rank atoms by relevance and format for LLM
+     */
+    rankAndFormatAtoms(atoms, themes) {
+        return atoms
+            .map(atom => ({
+            id: atom.id,
+            relevance_score: this.calculateRelevance(atom),
+            theme: this.findBestTheme(atom, themes),
+            entities: this.extractAtomEntities(atom),
+            timestamp: String(atom.timestamp || new Date().toISOString()),
+            content: atom.content,
+            source: atom.source || 'unknown',
+            tags: (atom.tags || []).slice(0, 10), // Limit to top 10 most relevant tags per molecule
+            relationships: {
+                responds_to: atom.epochs?.responds_to || [],
+                referenced_by: atom.epochs?.referenced_by || [],
+                related_to: this.findRelatedAtoms(atom, atoms)
+            }
+        }))
+            .sort((a, b) => b.relevance_score - a.relevance_score);
+    }
+    /**
+     * Calculate relevance score for an atom (0-1)
+     */
+    calculateRelevance(atom) {
+        let score = 0.5; // Base score
+        // Boost for tags
+        if (atom.tags && atom.tags.length > 0) {
+            score += Math.min(0.2, atom.tags.length * 0.02);
+        }
+        // Boost for content length (substantive atoms)
+        const contentLength = atom.content?.length || 0;
+        if (contentLength > 100)
+            score += 0.1;
+        if (contentLength > 500)
+            score += 0.1;
+        // Boost for recent timestamps
+        if (atom.timestamp) {
+            const age = Date.now() - new Date(atom.timestamp).getTime();
+            const daysOld = age / (1000 * 60 * 60 * 24);
+            if (daysOld < 30)
+                score += 0.1;
+            else if (daysOld < 90)
+                score += 0.05;
+        }
+        return Math.min(1.0, score);
+    }
+    /**
+     * Build timeline from atoms
+     */
+    buildTimeline(atoms) {
+        const timestamps = atoms
+            .filter(a => a.timestamp)
+            .map(a => new Date(a.timestamp).getTime())
+            .sort((a, b) => a - b);
+        if (timestamps.length === 0) {
+            return {
+                earliest: new Date().toISOString(),
+                latest: new Date().toISOString(),
+                span_days: 0,
+                key_moments: []
+            };
+        }
+        const earliest = new Date(timestamps[0]);
+        const latest = new Date(timestamps[timestamps.length - 1]);
+        const spanDays = Math.ceil((latest.getTime() - earliest.getTime()) / (1000 * 60 * 60 * 24));
+        // Find key moments (high-relevance atoms)
+        const keyMoments = atoms
+            .filter(a => a.timestamp && this.calculateRelevance(a) > 0.7)
+            .slice(0, 5)
+            .map(atom => ({
+            timestamp: atom.timestamp,
+            event: atom.content.substring(0, 100) + '...',
+            atom_id: atom.id
+        }));
+        return {
+            earliest: earliest.toISOString(),
+            latest: latest.toISOString(),
+            span_days: spanDays,
+            key_moments: keyMoments.map(km => ({
+                timestamp: String(km.timestamp),
+                event: km.event,
+                atom_id: km.atom_id
+            }))
+        };
+    }
+    /**
+     * Identify information gaps
+     */
+    identifyGaps(atoms, query, entities) {
+        const gaps = [];
+        // Check if query mentions entities that aren't well-represented
+        const queryLower = query.toLowerCase();
+        for (const entity of entities) {
+            if (queryLower.includes(entity.name.toLowerCase()) && entity.mentions < 3) {
+                gaps.push({
+                    topic: `${entity.name}'s perspective`,
+                    confidence: 0.6,
+                    suggestion: `Limited information about ${entity.name} in the results`
+                });
+            }
+        }
+        // Check for missing time periods
+        if (atoms.length > 0) {
+            const timestamps = atoms.filter(a => a.timestamp).map(a => new Date(a.timestamp).getFullYear());
+            const yearRange = new Set(timestamps);
+            const currentYear = new Date().getFullYear();
+            for (let year = currentYear - 2; year <= currentYear; year++) {
+                if (!yearRange.has(year)) {
+                    gaps.push({
+                        topic: `Information from ${year}`,
+                        confidence: 0.4,
+                        suggestion: `No atoms found from ${year}`
+                    });
+                }
+            }
+        }
+        return gaps;
+    }
+    // ============ Helper Methods ============
+    capitalize(str) {
+        return str.charAt(0).toUpperCase() + str.slice(1);
+    }
+    inferPersonRole(name, atoms) {
+        const nameLower = name.toLowerCase();
+        for (const atom of atoms) {
+            const content = atom.content.toLowerCase();
+            if (content.includes(nameLower)) {
+                if (content.includes('partner') || content.includes('relationship'))
+                    return 'partner';
+                if (content.includes('collaborator') || content.includes('work'))
+                    return 'collaborator';
+                if (content.includes('friend'))
+                    return 'friend';
+            }
+        }
+        return 'person';
+    }
+    classifySystem(name) {
+        const lower = name.toLowerCase();
+        if (lower.includes('engine') || lower.includes('system'))
+            return 'system';
+        if (lower.includes('language') || lower.includes('framework'))
+            return 'technology';
+        if (lower.includes('protocol') || lower.includes('algorithm'))
+            return 'concept';
+        return 'technology';
+    }
+    extractTopics(atom) {
+        return atom.tags?.slice(0, 5) || [];
+    }
+    generateThemeName(tags) {
+        // Capitalize and join tags
+        return tags
+            .slice(0, 3)
+            .map(tag => tag.split('_').map(this.capitalize).join(' '))
+            .join(' & ');
+    }
+    generateThemeSummary(atoms, query, entities) {
+        const sampleContent = atoms.slice(0, 2).map(a => a.content.substring(0, 50)).join('... ');
+        const entityNames = entities.slice(0, 3).map(e => e.name).join(', ');
+        return `Context about ${entityNames || 'the query'}: ${sampleContent}...`;
+    }
+    findBestTheme(atom, themes) {
+        for (const theme of themes) {
+            if (theme.atom_ids.includes(atom.id)) {
+                return theme.name;
+            }
+        }
+        return 'General';
+    }
+    extractAtomEntities(atom) {
+        const entities = [];
+        const text = `${atom.content} ${atom.tags?.join(' ') || ''}`;
+        // Simple entity extraction (can be improved with NER)
+        const personMatches = text.match(/\b(Rob|Coda|Dory|Jade)\b/gi);
+        if (personMatches) {
+            entities.push(...personMatches.map(this.capitalize));
+        }
+        return [...new Set(entities)];
+    }
+    findRelatedAtoms(atom, allAtoms) {
+        // Find atoms with shared tags
+        const atomTags = new Set(atom.tags || []);
+        const related = allAtoms
+            .filter(a => a.id !== atom.id)
+            .filter(a => {
+            const otherTags = new Set(a.tags || []);
+            return [...atomTags].some(tag => otherTags.has(tag));
+        })
+            .slice(0, 3)
+            .map(a => a.id);
+        return related;
+    }
+}
+//# sourceMappingURL=llm-context-formatter.js.map

package/engine/dist/services/search/llm-context-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-context-formatter.js","sourceRoot":"","sources":["../../../src/services/search/llm-context-formatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA4EH,iDAAiD;AAEjD,MAAM,OAAO,mBAAmB;IACb,cAAc,GAAG,OAAO,CAAC;IAE1C;;OAEG;IACH,MAAM,CAAC,KAAqB,EAAE,KAAa,EAAE,QAA0C;QACrF,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAEvD,OAAO;YACL,KAAK;YACL,OAAO,EAAE;gBACP,OAAO,EAAE,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC;gBAC1D,QAAQ;gBACR,MAAM;gBACN,QAAQ;aACT;YACD,KAAK,EAAE,WAAW;YAClB,IAAI;YACJ,QAAQ,EAAE;gBACR,oBAAoB,EAAE,KAAK,CAAC,MAAM;gBAClC,cAAc,EAAE,WAAW,CAAC,MAAM;gBAClC,iBAAiB,EAAE,CAAC,EAAE,wBAAwB;gBAC9C,aAAa,EAAE,CAAC,EAAE,wBAAwB;gBAC1C,OAAO,EAAE,QAAQ,EAAE,wBAAwB;gBAC3C,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,GAAG,QAAQ;aACZ;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,KAAqB;QAC3C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;QAE5C,yBAAyB;QACzB,MAAM,cAAc,GAAG;YACrB,mCAAmC;YACnC,0CAA0C;SAC3C,CAAC;QAEF,MAAM,cAAc,GAAG;YACrB,sEAAsE;YACtE,yCAAyC;SAC1C,CAAC;QAEF,MAAM,eAAe,GAAG;YACtB,gEAAgE;YAChE,gDAAgD;SACjD,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC;YAE3E,iBAAiB;YACjB,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;gBACrC,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC;gBACtB,IAAI,KAAK,CAAC;gBACV,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;oBAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;oBACvC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;wBACzB,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE;4BAClB,IAAI;4BACJ,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC;4BACvC,QAAQ,EAAE,CAAC;4BACX,cAAc,EAAE,EAAE;4BAClB,QAAQ,EAAE,EAAE;yBACb,CAAC,CAAC;oBACL,CAAC;oBACD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;oBACpC,MAAM,CAAC,QAAQ,EAAE,CAAC;oBAClB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBAC9B,MAAM,CAAC,cAAc,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBAChG,CAAC;YACH,CAAC;YAED,+BAA+B;YAC/B,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;gBACrC,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC;gBACtB,IAAI,KAAK,CAAC;gBACV,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;oBAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;oBACtB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;wBACzB,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE;4BAClB,IAAI;4BACJ,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;4BAC/B,IAAI,EAAE,YAAY;4BAClB,QAAQ,EAAE,CAAC;4BACX,cAAc,EAAE,EAAE;4BAClB,QAAQ,EAAE,EAAE;yBACb,CAAC,CAAC;oBACL,CAAC;oBACD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;oBACpC,MAAM,CAAC,QAAQ,EAAE,CAAC;oBAClB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBAC9B,MAAM,CAAC,cAAc,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBAChG,CAAC;YACH,CAAC;QACH,CAAC;QAED,2CAA2C;QAC3C,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;aAClC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;aACvC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,kBAAkB;IACrC,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,KAAqB;QACzC,MAAM,eAAe,GAAG,IAAI,GAAG,EAA+B,CAAC;QAE/D,iCAAiC;QACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACrC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACzC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;oBACnC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;oBAEnC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC/B,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;oBACvC,CAAC;oBACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC/B,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;oBACvC,CAAC;oBAED,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;oBACxC,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;oBAExC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC1C,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;QACH,CAAC;QAED,sBAAsB;QACtB,MAAM,MAAM,GAAY,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QAEnC,gCAAgC;QAChC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;gBAClC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACtF,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;aAClD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;aAC3B,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;QAEvB,wBAAwB;QACxB,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;YACjC,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;gBAAE,SAAS;YAEpC,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;YACxE,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC,4BAA4B;gBAC9D,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB;IAC9C,CAAC;IAED;;OAEG;IACK,iBAAiB,CACvB,OAAe,EACf,YAA8C,EAC9C,KAAqB;QAErB,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAElC,0CAA0C;QAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC7C,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;oBACf,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;QAED,6BAA6B;QAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;YAC5D,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC/C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAED,gCAAgC;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QAElE,OAAO;YACL,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC;YACtD,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;YAC7B,OAAO,EAAE,UAAU,SAAS,KAAK,OAAO,CAAC,IAAI,SAAS;YACtD,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SAC9C,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,KAAqB,EAAE,MAAe;QAC/D,OAAO,KAAK;aACT,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACZ,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,eAAe,EAAE,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC;YAC9C,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC;YACvC,QAAQ,EAAE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC;YACxC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC7D,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS;YAChC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,kDAAkD;YACxF,aAAa,EAAE;gBACb,WAAW,EAAG,IAAI,CAAC,MAAc,EAAE,WAAW,IAAI,EAAE;gBACpD,aAAa,EAAG,IAAI,CAAC,MAAc,EAAE,aAAa,IAAI,EAAE;gBACxD,UAAU,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC;aAC/C;SACF,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,IAAkB;QAC3C,IAAI,KAAK,GAAG,GAAG,CAAC,CAAC,aAAa;QAE9B,iBAAiB;QACjB,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QAClD,CAAC;QAED,+CAA+C;QAC/C,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;QAChD,IAAI,aAAa,GAAG,GAAG;YAAE,KAAK,IAAI,GAAG,CAAC;QACtC,IAAI,aAAa,GAAG,GAAG;YAAE,KAAK,IAAI,GAAG,CAAC;QAEtC,8BAA8B;QAC9B,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;YAC5D,MAAM,OAAO,GAAG,GAAG,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;YAC5C,IAAI,OAAO,GAAG,EAAE;gBAAE,KAAK,IAAI,GAAG,CAAC;iBAC1B,IAAI,OAAO,GAAG,EAAE;gBAAE,KAAK,IAAI,IAAI,CAAC;QACvC,CAAC;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,KAAqB;QACzC,MAAM,UAAU,GAAG,KAAK;aACrB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;aACxB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAU,CAAC,CAAC,OAAO,EAAE,CAAC;aAC1C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAEzB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO;gBACL,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAClC,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAChC,SAAS,EAAE,CAAC;gBACZ,WAAW,EAAE,EAAE;aAChB,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAE5F,0CAA0C;QAC1C,MAAM,UAAU,GAAG,KAAK;aACrB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;aAC5D,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aACX,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACZ,SAAS,EAAE,IAAI,CAAC,SAAU;YAC1B,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK;YAC7C,OAAO,EAAE,IAAI,CAAC,EAAE;SACjB,CAAC,CAAC,CAAC;QAEN,OAAO;YACL,QAAQ,EAAE,QAAQ,CAAC,WAAW,EAAE;YAChC,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE;YAC5B,SAAS,EAAE,QAAQ;YACnB,WAAW,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBACjC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC;gBAC/B,KAAK,EAAE,EAAE,CAAC,KAAK;gBACf,OAAO,EAAE,EAAE,CAAC,OAAO;aACpB,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,KAAqB,EAAE,KAAa,EAAE,QAAkB;QAC3E,MAAM,IAAI,GAAU,EAAE,CAAC;QAEvB,gEAAgE;QAChE,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACvC,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC9B,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,MAAM,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;gBAC1E,IAAI,CAAC,IAAI,CAAC;oBACR,KAAK,EAAE,GAAG,MAAM,CAAC,IAAI,gBAAgB;oBACrC,UAAU,EAAE,GAAG;oBACf,UAAU,EAAE,6BAA6B,MAAM,CAAC,IAAI,iBAAiB;iBACtE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,iCAAiC;QACjC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAU,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YACjG,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;YACtC,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAE7C,KAAK,IAAI,IAAI,GAAG,WAAW,GAAG,CAAC,EAAE,IAAI,IAAI,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC;gBAC7D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACzB,IAAI,CAAC,IAAI,CAAC;wBACR,KAAK,EAAE,oBAAoB,IAAI,EAAE;wBACjC,UAAU,EAAE,GAAG;wBACf,UAAU,EAAE,uBAAuB,IAAI,EAAE;qBAC1C,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2CAA2C;IAEnC,UAAU,CAAC,GAAW;QAC5B,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IAEO,eAAe,CAAC,IAAY,EAAE,KAAqB;QACzD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YAC3C,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBAChC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;oBAAE,OAAO,SAAS,CAAC;gBACtF,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;oBAAE,OAAO,cAAc,CAAC;gBACxF,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;oBAAE,OAAO,QAAQ,CAAC;YAClD,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,cAAc,CAAC,IAAY;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;QAC1E,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;YAAE,OAAO,YAAY,CAAC;QACnF,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;YAAE,OAAO,SAAS,CAAC;QAChF,OAAO,YAAY,CAAC;IACtB,CAAC;IAEO,aAAa,CAAC,IAAkB;QACtC,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACtC,CAAC;IAEO,iBAAiB,CAAC,IAAc;QACtC,2BAA2B;QAC3B,OAAO,IAAI;aACR,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aACX,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;aACzD,IAAI,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAEO,oBAAoB,CAAC,KAAqB,EAAE,KAAa,EAAE,QAAkB;QACnF,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1F,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,OAAO,iBAAiB,WAAW,IAAI,WAAW,KAAK,aAAa,KAAK,CAAC;IAC5E,CAAC;IAEO,aAAa,CAAC,IAAkB,EAAE,MAAe;QACvD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBACrC,OAAO,KAAK,CAAC,IAAI,CAAC;YACpB,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,mBAAmB,CAAC,IAAkB;QAC5C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;QAE7D,sDAAsD;QACtD,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC/D,IAAI,aAAa,EAAE,CAAC;YAClB,QAAQ,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QACvD,CAAC;QAED,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChC,CAAC;IAEO,gBAAgB,CAAC,IAAkB,EAAE,QAAwB;QACnE,8BAA8B;QAC9B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,QAAQ;aACrB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;aAC7B,MAAM,CAAC,CAAC,CAAC,EAAE;YACV,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YACxC,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAElB,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/engine/dist/services/search/physics-tag-walker.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Physics-Based Tag Walker for ECE
+ *
+ * Implements mathematical approach to graph traversal using SQL matrix operations
+ * leveraging the relational nature of PGlite for efficient sparse matrix processing.
+ *
+ * Architecture: Treats the database as a Knowledge Graph.
+ * - Atoms (memories) and Tags (concepts) form a bipartite graph.
+ * - JOIN operations simulate sparse matrix multiplication (M × M^T).
+ * - The Unified Field Equation weights every connection deterministically.
+ *
+ * The "Planets and Moons" Model:
+ * - Planets: Direct search hits (FTS/SimHash) — heavy, explicit anchors.
+ * - Moons:   Physics-discovered associations — orbit via shared tags, time, simhash.
+ * - Serendipity: Weighted reservoir sampling occasionally surfaces faint but relevant signals.
+ */
+import { SearchResult } from './search.js';
+import type { SearchConfig, PhysicsMetadata } from '../../types/context-protocol.js';
+export interface WalkerNode {
+    atomId: string;
+    sharedTags: number;
+    timestamp: number;
+    simhash: bigint;
+    content?: string;
+    source?: string;
+    tags?: string[];
+    provenance?: string;
+    type?: string;
+    frequency?: number;
+    /** Compound document ID for context inflation */
+    compoundId?: string;
+    /** Start byte offset in compound body */
+    startByte?: number;
+    /** End byte offset in compound body */
+    endByte?: number;
+    gravityScore: number;
+    bestAnchorId?: string;
+    /** Graph hop distance from query (0 = direct, 1 = 1-hop, etc.) */
+    hopDistance?: number;
+}
+/** Result from the physics walk with full metadata */
+export interface PhysicsResult {
+    /** The search result with all standard fields */
+    result: SearchResult;
+    /** Physics metadata for the Graph-Context Protocol */
+    physics: PhysicsMetadata;
+}
+export declare class PhysicsTagWalker {
+    private DAMPING_FACTOR;
+    private TIME_DECAY_LAMBDA;
+    private MAX_PER_HOP;
+    private WALK_RADIUS;
+    private GRAVITY_THRESHOLD;
+    private TEMPERATURE;
+    constructor(config?: {
+        damping?: number;
+        temporalDecay?: number;
+        maxPerHop?: number;
+        walkRadius?: number;
+        gravityThreshold?: number;
+        temperature?: number;
+    });
+    /**
+     * Safely parse a simhash string into a BigInt (hex with or without 0x).
+     */
+    private safeParseHex;
+    /**
+     * Performs radial inflation using SQL matrix operations.
+     * This executes the equivalent of: r = (M * M^T) * q
+     *
+     * Now includes the Unified Field Equation directly in the SQL query:
+     * Weight = (SharedTags) * Exp(-Lambda * DeltaT) * (1 - SimHashDist/64)
+     *
+     * Uses instance configuration from constructor for max-recall support.
+     */
+    performRadialInflation(anchorIds: string[], radius?: number, // Uses instance WALK_RADIUS if not provided
+    maxPerHop?: number, // Uses instance MAX_PER_HOP if not provided
+    temperature?: number, // Uses instance TEMPERATURE if not provided
+    gravityThreshold?: number): Promise<PhysicsResult[]>;
+    /**
+     * Gets connected nodes via shared tags using SQL matrix operations w/ Physics equations.
+     *
+     * The SQL performs:
+     * 1. Collect Anchor Stats (ID, Timestamp, SimHash)
+     * 2. Find Shared Tags (Sparse Matrix Multiply)
+     * 3. Calculate Weight:
+     *    W = (SharedTags) * Exp(-lambda * delta_t) * (1 - Hamming/64)
+     * 4. Aggregate: Take the MAX weight overlapping with any anchor.
+     */
+    private getConnectedNodesWeighted;
+    /**
+     * Applies physics weighting seeded from tags directly.
+     */
+    applyPhysicsWeightingFromTags(anchorResults: SearchResult[], threshold?: number, config?: Partial<SearchConfig>): Promise<PhysicsResult[]>;
+    private getConnectedNodesFromTags;
+    /**
+     * Format time drift helper
+     */
+    private formatTimeDrift;
+    /**
+     * Main Entry Point
+     * Applies physics weighting to search results.
+     *
+     * @param anchorResults - Search results to apply physics weighting to
+     * @param threshold - Gravity threshold (default 0.1, lower for high-budget)
+     * @param config - Search configuration
+     * @param maxChars - Optional budget hint for auto-tuning parameters
+     */
+    applyPhysicsWeighting(anchorResults: SearchResult[], threshold?: number, config?: Partial<SearchConfig>, maxChars?: number): Promise<PhysicsResult[]>;
+    /**
+     * Legacy wrapper
+     */
+    applyPhysicsWeightingLegacy(anchorResults: SearchResult[], threshold?: number): Promise<SearchResult[]>;
+}
+//# sourceMappingURL=physics-tag-walker.d.ts.map

package/engine/dist/services/search/physics-tag-walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"physics-tag-walker.d.ts","sourceRoot":"","sources":["../../../src/services/search/physics-tag-walker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,YAAY,EAEZ,eAAe,EAEhB,MAAM,iCAAiC,CAAC;AAqBzC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,MAAM,EAAE,YAAY,CAAC;IACrB,sDAAsD;IACtD,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,qBAAa,gBAAgB;IAG3B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,CAAC,EAAE;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;IAYD;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;;;;;;;OAQG;IACG,sBAAsB,CAC1B,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,CAAC,EAAE,MAAM,EAAS,4CAA4C;IACpE,SAAS,CAAC,EAAE,MAAM,EAAM,4CAA4C;IACpE,WAAW,CAAC,EAAE,MAAM,EAAI,4CAA4C;IACpE,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,aAAa,EAAE,CAAC;IAuG3B;;;;;;;;;OASG;YACW,yBAAyB;IAgSvC;;OAEG;IACG,6BAA6B,CACjC,aAAa,EAAE,YAAY,EAAE,EAC7B,SAAS,GAAE,MAAY,EACvB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC7B,OAAO,CAAC,aAAa,EAAE,CAAC;YAoEb,yBAAyB;IA0DvC;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;;;;;;;OAQG;IACG,qBAAqB,CACzB,aAAa,EAAE,YAAY,EAAE,EAC7B,SAAS,GAAE,MAAY,EACvB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,EAC9B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,EAAE,CAAC;IAyB3B;;OAEG;IACG,2BAA2B,CAC/B,aAAa,EAAE,YAAY,EAAE,EAC7B,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC;CAI3B"}