@rbalchii/anchor-engine 4.7.0

package/engine/dist/services/search/graph-context-serializer.js

@@ -0,0 +1,435 @@
+/**
+ * Graph-Context Serializer
+ *
+ * Transforms the Physics Engine output into a dense, token-efficient format
+ * that the Local LLM can read as structured context.
+ *
+ * Design Goal: HIGH SIGNAL-TO-TOKEN RATIO.
+ * The LLM doesn't need pretty UI — it needs dense, structured signal.
+ * Every byte must carry meaning.
+ *
+ * Two output modes:
+ * 1. serializeForLLM()  — Produces the compact [CONTEXT_GRAPH] text block.
+ *                         This is what gets injected into the LLM's prompt.
+ * 2. serializeToJSON()  — Produces the full ContextPackage JSON.
+ *                         Used for debugging, API responses, and UI rendering.
+ */
+// =============================================================================
+// INTENT DETECTION — Lightweight, no LLM needed
+// =============================================================================
+const EMOTIONAL_SIGNALS = ['feel', 'feeling', 'tired', 'frustrated', 'happy', 'sad', 'angry', 'anxious', 'stressed', 'burned', 'burnout', 'overwhelmed', 'excited', 'hopeful', 'lost', 'stuck'];
+const TEMPORAL_SIGNALS = ['when', 'recently', 'lately', 'last', 'yesterday', 'today', 'this week', 'this month', 'ago', 'since', 'between', 'before', 'after'];
+const RELATIONAL_SIGNALS = ['and', 'with', 'told', 'said', 'met', 'called', 'texted', 'about', 'between'];
+const CREATIVE_SIGNALS = ['idea', 'brainstorm', 'imagine', 'what if', 'could we', 'design', 'build', 'create', 'invent', 'explore'];
+/**
+ * Detect the likely intent of a query without using the LLM.
+ */
+export function detectIntent(query) {
+    const q = query.toLowerCase();
+    const scores = {
+        emotional: 0,
+        temporal: 0,
+        relational: 0,
+        creative: 0,
+        factual: 0,
+    };
+    EMOTIONAL_SIGNALS.forEach(s => { if (q.includes(s))
+        scores.emotional += 2; });
+    TEMPORAL_SIGNALS.forEach(s => { if (q.includes(s))
+        scores.temporal += 2; });
+    RELATIONAL_SIGNALS.forEach(s => { if (q.includes(s))
+        scores.relational += 1; });
+    CREATIVE_SIGNALS.forEach(s => { if (q.includes(s))
+        scores.creative += 2; });
+    // Default to factual
+    scores.factual = 1;
+    // Return highest scoring intent
+    const sorted = Object.entries(scores).sort((a, b) => b[1] - a[1]);
+    return sorted[0][0];
+}
+// =============================================================================
+// CONTENT SANITIZATION — Strip inline tags from molecule content
+// =============================================================================
+/**
+ * Remove hashtag tokens from content so they don't pollute LLM context.
+ * Tags are stored separately in result.tags and used for graph traversal;
+ * they add noise when embedded literally in the text window.
+ *
+ * Strips:
+ *   - Quoted tag lists:  "\"#Tag1\" - \"#Tag2\""  or  '"#Tag1" - "#Tag2"'
+ *   - Plain hashtags:    #Tag, ##Tag
+ *   - Separator runs left behind: " - " chains at start/end
+ */
+function stripInlineTags(content) {
+    if (!content)
+        return content;
+    let s = content.replace(/\\?"#[^"\\]+\\?"/g, '');
+    s = s.replace(/##?[A-Za-z0-9_]+/g, '');
+    // Only strip " - " list separators (space-hyphen-space), not bare hyphens
+    // in kebab-case identifiers like p-6, text-xl, font-bold, etc.
+    s = s.replace(/[ \t]+-[ \t]+/g, ' ').trim();
+    return s;
+}
+/**
+ * Convert a SearchResult + PhysicsMetadata into a MemoryNode.
+ */
+function toMemoryNode(result, physics) {
+    return {
+        id: result.id,
+        content: stripInlineTags(result.content || ''),
+        source: result.source || '',
+        type: result.type || 'thought',
+        tags: result.tags || [],
+        provenance: result.provenance || 'internal',
+        timestamp: result.timestamp,
+        physics,
+    };
+}
+/**
+ * Convert direct search results (anchors/planets) into MemoryNodes.
+ * These get 'direct_fts' connection type and a normalized gravity score.
+ */
+function anchorsToMemoryNodes(anchors) {
+    if (anchors.length === 0)
+        return [];
+    // Normalize scores relative to the best anchor
+    const maxScore = Math.max(...anchors.map(a => a.score || 1));
+    const now = Date.now();
+    return anchors.map(anchor => {
+        const normalizedScore = maxScore > 0 ? (anchor.score || 0) / maxScore : 0;
+        const timeDeltaMs = Math.abs(now - anchor.timestamp);
+        const frequency = anchor.frequency || 1;
+        const physics = {
+            gravity_score: normalizedScore,
+            time_drift: formatTimeDrift(timeDeltaMs),
+            is_recurring: frequency > 1,
+            frequency,
+            connection_type: 'direct_fts',
+            link_reason: 'direct search match',
+        };
+        return toMemoryNode(anchor, physics);
+    });
+}
+/**
+ * Convert PhysicsResult[] (walker output) into MemoryNodes.
+ */
+function walkerToMemoryNodes(walkerResults) {
+    return walkerResults.map(pr => toMemoryNode(pr.result, pr.physics));
+}
+// =============================================================================
+// TIME FORMATTING
+// =============================================================================
+function formatTimeDrift(deltaMs) {
+    const hours = deltaMs / (1000 * 60 * 60);
+    if (hours < 1)
+        return `${Math.round(deltaMs / (1000 * 60))}m ago`;
+    if (hours < 24)
+        return `${Math.round(hours)}h ago`;
+    const days = hours / 24;
+    if (days < 30)
+        return `${Math.round(days)}d ago`;
+    const months = days / 30;
+    if (months < 12)
+        return `${Math.round(months)}mo ago`;
+    return `${(months / 12).toFixed(1)}y ago`;
+}
+// =============================================================================
+// LLM TEXT SERIALIZER — Hierarchical Source-Grouped Format v2
+// =============================================================================
+const CHARS_PER_TOKEN = 4;
+/**
+ * Group nodes by their source file/origin.
+ * Returns groups sorted by max gravity score descending.
+ */
+function groupNodesBySource(nodes) {
+    const map = new Map();
+    for (const node of nodes) {
+        const key = node.source || '(unknown)';
+        const bucket = map.get(key);
+        if (bucket) {
+            bucket.push(node);
+        }
+        else {
+            map.set(key, [node]);
+        }
+    }
+    const groups = [];
+    for (const [source, groupNodes] of map) {
+        const taxonomy = hoistCommonTags(groupNodes);
+        const maxScore = Math.max(...groupNodes.map(n => n.physics.gravity_score));
+        groups.push({ source, nodes: groupNodes, maxScore, taxonomy });
+    }
+    // Best sources first
+    groups.sort((a, b) => b.maxScore - a.maxScore);
+    return groups;
+}
+/**
+ * Hoist tags that appear in >= 50% of nodes to a shared group taxonomy.
+ * Returns tags sorted by frequency descending.
+ */
+function hoistCommonTags(nodes) {
+    if (nodes.length === 0)
+        return [];
+    const freq = new Map();
+    for (const node of nodes) {
+        const seen = new Set();
+        for (const tag of (node.tags || [])) {
+            const normalized = tag.startsWith('#') ? tag : `#${tag}`;
+            if (!seen.has(normalized)) {
+                seen.add(normalized);
+                freq.set(normalized, (freq.get(normalized) ?? 0) + 1);
+            }
+        }
+    }
+    const threshold = Math.max(1, nodes.length * 0.5);
+    return Array.from(freq.entries())
+        .filter(([, count]) => count >= threshold)
+        .sort((a, b) => b[1] - a[1])
+        .map(([tag]) => tag);
+}
+/**
+ * Return tags on a node that are NOT already in the group taxonomy.
+ */
+function uniqueNodeTags(node, taxonomySet) {
+    return (node.tags || [])
+        .map(t => t.startsWith('#') ? t : `#${t}`)
+        .filter(t => !taxonomySet.has(t));
+}
+/**
+ * Infer a short location label for a node (state-anchor marker or timestamp).
+ */
+function inferNodeLocation(node) {
+    if (node.id.startsWith('virtual_mem_'))
+        return '[state-anchor]';
+    if (node.timestamp && node.timestamp > 1_000_000_000) {
+        const d = new Date(node.timestamp < 1e12 ? node.timestamp * 1000 : node.timestamp);
+        return `[${d.toISOString().replace('T', ' ').substring(0, 16)}]`;
+    }
+    return '';
+}
+/**
+ * Serialize a ContextPackage into the compact [CONTEXT_GRAPH] text block.
+ *
+ * v2 Format — Hierarchical Source Grouping with Taxonomy Hoisting:
+ *
+ *   [CONTEXT_GRAPH_START]
+ *   user: @name | state: current_state | intent: factual | terms: t1, t2
+ *
+ *   // DIRECT HITS
+ *   [SRC: path/to/file.ext | max: 1.00 | N nodes]
+ *   taxonomy: #tag1, #tag2, #tag3, ...   ← declared ONCE per source
+ *     [N:id] (freq:N) [loc] "content"
+ *     [N:id] (freq:N) [loc] "content" | +tags: #unique1
+ *
+ *   // ASSOCIATED MEMORIES
+ *   [SRC: path/to/other.ext | max: 0.82 | N nodes]
+ *   taxonomy: #sharedA, #sharedB
+ *     [N:id] [W:0.82|WALK] [loc] "content" -> [N:anchor] (reason)
+ *
+ *   [CONTEXT_GRAPH_END]
+ *
+ * Token savings: ~600 tokens/node eliminated by hoisting shared tags once per source.
+ */
+export function serializeForLLM(pkg, charBudget) {
+    const budget = charBudget || Infinity;
+    let output = '';
+    let currentChars = 0;
+    const add = (s) => { output += s; currentChars += s.length; };
+    const overBudget = () => currentChars >= budget * 0.95;
+    // Single-line dense header
+    add(`[CONTEXT_GRAPH_START]\nuser: @${pkg.userContext.name} | state: ${pkg.userContext.current_state}\nintent: ${pkg.query.intent} | terms: ${pkg.query.keyTerms.join(', ')}\n\n`);
+    // ── DIRECT HITS (Planets) ────────────────────────────────────────────────
+    if (pkg.anchors.length > 0) {
+        add('// DIRECT HITS\n');
+        const anchorGroups = groupNodesBySource(pkg.anchors);
+        const maxAtomChars = budget > 200_000
+            ? Math.min(8000, Math.floor(budget * 0.7 / pkg.anchors.length))
+            : (budget > 50_000 ? 2500 : 500);
+        for (const group of anchorGroups) {
+            if (overBudget())
+                break;
+            const taxonomySet = new Set(group.taxonomy);
+            const sourceLabel = group.source.length > 60 ? '...' + group.source.slice(-57) : group.source;
+            add(`[SRC: ${sourceLabel} | max: ${group.maxScore.toFixed(2)} | ${group.nodes.length} node${group.nodes.length !== 1 ? 's' : ''}]\n`);
+            if (group.taxonomy.length > 0) {
+                // All hoisted tags on one compact line — no per-node repetition
+                add(`taxonomy: ${group.taxonomy.slice(0, 60).join(', ')}\n`);
+            }
+            for (const node of group.nodes) {
+                if (overBudget())
+                    break;
+                const loc = inferNodeLocation(node);
+                const truncated = truncateContent(node.content, Math.min(maxAtomChars, budget - currentChars - 200));
+                const uniq = uniqueNodeTags(node, taxonomySet);
+                const uniqStr = uniq.length > 0 ? ` | +tags: ${uniq.slice(0, 10).join(', ')}` : '';
+                add(`  [N:${shortId(node.id)}] (freq:${node.physics.frequency})${loc ? ` ${loc}` : ''} "${truncated}"${uniqStr}\n`);
+            }
+            add('\n');
+        }
+    }
+    // ── ASSOCIATED MEMORIES (Moons) ──────────────────────────────────────────
+    if (pkg.associations.length > 0) {
+        add('// ASSOCIATED MEMORIES\n');
+        const assocGroups = groupNodesBySource(pkg.associations);
+        const maxAssocChars = budget > 200_000
+            ? Math.min(5000, Math.floor(budget * 0.25 / pkg.associations.length))
+            : (budget > 50_000 ? 1500 : 400);
+        for (const group of assocGroups) {
+            if (overBudget())
+                break;
+            const taxonomySet = new Set(group.taxonomy);
+            const sourceLabel = group.source.length > 60 ? '...' + group.source.slice(-57) : group.source;
+            add(`[SRC: ${sourceLabel} | max: ${group.maxScore.toFixed(2)} | ${group.nodes.length} node${group.nodes.length !== 1 ? 's' : ''}]\n`);
+            if (group.taxonomy.length > 0) {
+                add(`taxonomy: ${group.taxonomy.slice(0, 60).join(', ')}\n`);
+            }
+            for (const node of group.nodes) {
+                if (overBudget())
+                    break;
+                const loc = inferNodeLocation(node);
+                const truncated = truncateContent(node.content, Math.min(maxAssocChars, budget - currentChars - 200));
+                const typeLabel = connectionTypeLabel(node.physics.connection_type);
+                const anchorRef = node.physics.source_anchor_id ? shortId(node.physics.source_anchor_id) : '?';
+                const reason = node.physics.link_reason || node.physics.connection_type;
+                const uniq = uniqueNodeTags(node, taxonomySet);
+                const uniqStr = uniq.length > 0 ? ` | +tags: ${uniq.slice(0, 5).join(', ')}` : '';
+                add(`  [N:${shortId(node.id)}] [W:${node.physics.gravity_score.toFixed(2)}|${typeLabel}]${loc ? ` ${loc}` : ''} "${truncated}" -> [N:${anchorRef}] (${reason})${uniqStr}\n`);
+            }
+            add('\n');
+        }
+    }
+    add('[CONTEXT_GRAPH_END]\n');
+    return output;
+}
+/**
+ * Truncate content to a character limit, cutting at the nearest sentence boundary.
+ */
+function truncateContent(content, maxChars) {
+    if (!content)
+        return '';
+    if (content.length <= maxChars)
+        return content.replace(/\n/g, ' ').trim();
+    const truncated = content.substring(0, maxChars);
+    // Find last sentence boundary
+    const lastDot = truncated.lastIndexOf('.');
+    const lastBang = truncated.lastIndexOf('!');
+    const lastQ = truncated.lastIndexOf('?');
+    const bestCut = Math.max(lastDot, lastBang, lastQ);
+    if (bestCut > maxChars * 0.5) {
+        return truncated.substring(0, bestCut + 1).replace(/\n/g, ' ').trim();
+    }
+    // Try to cut at the last space to avoid cutting mid-word
+    const lastSpace = truncated.lastIndexOf(' ');
+    const cutIndex = lastSpace > maxChars * 0.5 ? lastSpace : maxChars;
+    return truncated.substring(0, cutIndex).replace(/\n/g, ' ').trim() + '...';
+}
+/**
+ * Shorten a UUID to its first 8 chars for token efficiency.
+ */
+function shortId(id) {
+    if (!id)
+        return '?';
+    // If it's a UUID, take first 8 chars
+    if (id.length > 12)
+        return id.substring(0, 8);
+    return id;
+}
+/**
+ * Map ConnectionType to a short label for the serialized format.
+ */
+function connectionTypeLabel(type) {
+    switch (type) {
+        case 'direct_fts': return 'FTS';
+        case 'direct_simhash': return 'SIM';
+        case 'tag_walk_neighbor': return 'WALK';
+        case 'temporal_neighbor': return 'TIME';
+        case 'serendipity': return 'LUCK';
+        case 'engram_hit': return 'ENGR';
+        case 'walk_fallback': return 'FALL';
+        default: return 'UNK';
+    }
+}
+/**
+ * Assemble the full ContextPackage from search results.
+ * This is the main entry point for the serializer.
+ */
+export function assembleContextPackage(opts) {
+    const now = Date.now();
+    const intent = detectIntent(opts.query);
+    const queryContext = {
+        text: opts.query,
+        timestamp: now,
+        intent,
+        keyTerms: opts.keyTerms,
+        scopeTags: opts.scopeTags || [],
+    };
+    // Convert anchors to MemoryNodes
+    const anchorNodes = anchorsToMemoryNodes(opts.anchors);
+    // Convert walker results to MemoryNodes
+    let associationNodes;
+    if (opts.walkerResults && opts.walkerResults.length > 0) {
+        associationNodes = walkerToMemoryNodes(opts.walkerResults);
+    }
+    else if (opts.legacyWalkerResults && opts.legacyWalkerResults.length > 0) {
+        // Backward compat: convert legacy SearchResult[] to MemoryNodes with inferred physics
+        associationNodes = opts.legacyWalkerResults.map(r => {
+            const timeDeltaMs = Math.abs(now - r.timestamp);
+            const frequency = r.frequency || 1;
+            const physics = {
+                gravity_score: r.score || 0,
+                time_drift: formatTimeDrift(timeDeltaMs),
+                is_recurring: frequency > 1,
+                frequency,
+                connection_type: 'walk_fallback',
+                link_reason: 'traditional walk',
+            };
+            return toMemoryNode(r, physics);
+        });
+    }
+    else {
+        associationNodes = [];
+    }
+    // Compute aggregate statistics
+    const allNodes = [...anchorNodes, ...associationNodes];
+    const totalNodes = allNodes.length;
+    const avgGravity = totalNodes > 0
+        ? allNodes.reduce((sum, n) => sum + n.physics.gravity_score, 0) / totalNodes
+        : 0;
+    const recurringThemes = allNodes.filter(n => n.physics.is_recurring).length;
+    const totalChars = allNodes.reduce((sum, n) => sum + n.content.length, 0);
+    const estimatedTokens = Math.ceil(totalChars / CHARS_PER_TOKEN);
+    const budgetUtilization = opts.charBudget
+        ? Math.min(100, (totalChars / opts.charBudget) * 100)
+        : 0;
+    return {
+        userContext: opts.user,
+        query: queryContext,
+        anchors: anchorNodes,
+        associations: associationNodes,
+        graphStats: {
+            totalNodes,
+            budgetUtilization,
+            avgGravity,
+            recurringThemes,
+            estimatedTokens,
+        },
+    };
+}
+/**
+ * One-shot convenience: assemble + serialize for LLM consumption.
+ * Returns the compact text block ready to inject into a prompt.
+ */
+export function assembleAndSerialize(opts) {
+    const pkg = assembleContextPackage(opts);
+    // Debug logging for large budgets
+    if (opts.charBudget && opts.charBudget > 100000) {
+        const totalContentChars = pkg.anchors.reduce((sum, n) => sum + n.content.length, 0) +
+            pkg.associations.reduce((sum, n) => sum + n.content.length, 0);
+        console.log(`[Serializer] Budget: ${opts.charBudget}, Anchors: ${pkg.anchors.length}, Associations: ${pkg.associations.length}, Total content: ${totalContentChars} chars`);
+        if (pkg.anchors.length > 0) {
+            console.log(`[Serializer] Avg anchor content: ${Math.round(totalContentChars / pkg.anchors.length)} chars`);
+        }
+    }
+    return serializeForLLM(pkg, opts.charBudget);
+}
+//# sourceMappingURL=graph-context-serializer.js.map

package/engine/dist/services/search/graph-context-serializer.js.map

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

package/engine/dist/services/search/llm-context-formatter.d.ts

@@ -0,0 +1,122 @@
+/**
+ * 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
+ */
+import { SearchResult } from './search-utils.js';
+export interface Entity {
+    name: string;
+    type: 'person' | 'system' | 'concept' | 'organization' | 'technology';
+    role: string;
+    mentions: number;
+    related_topics: string[];
+    atom_ids: string[];
+}
+export interface Theme {
+    name: string;
+    confidence: number;
+    atom_ids: string[];
+    summary: string;
+    keywords: string[];
+}
+export interface RankedAtom {
+    id: string;
+    relevance_score: number;
+    theme: string;
+    entities: string[];
+    timestamp: string;
+    content: string;
+    source: string;
+    tags: string[];
+    relationships: {
+        responds_to?: string[];
+        referenced_by?: string[];
+        related_to?: string[];
+    };
+}
+export interface Gap {
+    topic: string;
+    confidence: number;
+    suggestion: string;
+}
+export interface Timeline {
+    earliest: string;
+    latest: string;
+    span_days: number;
+    key_moments: Array<{
+        timestamp: string;
+        event: string;
+        atom_id: string;
+    }>;
+}
+export interface LLMContext {
+    query: string;
+    context: {
+        summary: string;
+        entities: Entity[];
+        themes: Theme[];
+        timeline: Timeline;
+    };
+    atoms: RankedAtom[];
+    gaps: Gap[];
+    metadata: {
+        total_atoms_searched: number;
+        atoms_returned: number;
+        search_latency_ms: number;
+        dedup_removed: number;
+        backend: string;
+        format_version: string;
+    };
+}
+export declare class LLMContextFormatter {
+    private readonly FORMAT_VERSION;
+    /**
+     * Format atoms into LLM-optimized context
+     */
+    format(atoms: SearchResult[], query: string, metadata?: Partial<LLMContext['metadata']>): LLMContext;
+    /**
+     * Extract entities from atoms (people, systems, concepts)
+     */
+    private extractEntities;
+    /**
+     * Cluster atoms by theme using tag co-occurrence
+     */
+    private clusterThemes;
+    /**
+     * Build a theme cluster from a seed tag
+     */
+    private buildThemeCluster;
+    /**
+     * Rank atoms by relevance and format for LLM
+     */
+    private rankAndFormatAtoms;
+    /**
+     * Calculate relevance score for an atom (0-1)
+     */
+    private calculateRelevance;
+    /**
+     * Build timeline from atoms
+     */
+    private buildTimeline;
+    /**
+     * Identify information gaps
+     */
+    private identifyGaps;
+    private capitalize;
+    private inferPersonRole;
+    private classifySystem;
+    private extractTopics;
+    private generateThemeName;
+    private generateThemeSummary;
+    private findBestTheme;
+    private extractAtomEntities;
+    private findRelatedAtoms;
+}
+//# sourceMappingURL=llm-context-formatter.d.ts.map

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

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