@rbalchii/anchor-engine 4.7.0

package/engine/dist/services/search/query-parser.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Query Parser Module — "The Ears"
+ *
+ * NLP parsing, temporal extraction, query decomposition, and semantic expansion.
+ * Extracted from search.ts to isolate natural language understanding
+ * from the physics-based search core.
+ */
+import { expandTerms as semanticExpand, isExpansionReady } from '@rbalchii/dse';
+declare const nlp: import("wink-nlp").WinkMethods;
+export { nlp, isExpansionReady, semanticExpand };
+/**
+ * Fetch top tags from the system to ground the LLM's query expansion
+ */
+export declare function getGlobalTags(limit?: number): Promise<string[]>;
+/**
+ * Deterministic Query Expansion (No LLM)
+ * Scans the user query for known tags from the master list.
+ */
+export declare function expandQuery(originalQuery: string): Promise<string[]>;
+/**
+ * Helper to sanitize queries for FTS engine
+ */
+export declare function sanitizeFtsQuery(query: string): string;
+/**
+ * Expand camelCase and PascalCase identifiers into additional search terms.
+ * e.g. "findAnchors" → ["findAnchors", "find", "Anchors", "anchors"]
+ * Returned terms are de-duped and lowercased for FTS.
+ */
+export declare function expandCamelCase(terms: string[]): string[];
+/**
+ * Helper: Extract Temporal Context
+ * Detects "last X months/years", year ranges, and returns a list of relevant year tags.
+ */
+export declare function extractTemporalContext(query: string): string[];
+/**
+ * Natural Language Parser (Standard 070 - Enhanced)
+ * Uses NLP to extract "Meaningful Tags" including Temporal Context.
+ * Enhanced to handle conversational queries of any size.
+ */
+export declare function parseNaturalLanguage(query: string): string;
+/**
+ * Extract key terms from conversational queries
+ * Identifies important nouns, proper nouns, adjectives, and verbs while preserving context
+ */
+export declare function extractKeyTermsFromConversation(conversation: string): string[];
+/**
+ * Split a query into sentence-like chunks (molecules)
+ */
+export declare function splitQueryIntoMolecules(query: string): string[];
+export declare function parseQuery(query: string): {
+    phrases: string[];
+    temporal: string[];
+    buckets: string[];
+    keywords: string[];
+};
+/**
+ * Conversational Query Expansion (Standard 086)
+ * Expands natural language queries into semantic equivalents
+ */
+export declare function expandConversationalQuery(query: string): string[];
+/**
+ * Get related tags for a given query to provide semantic serendipity
+ * This function finds tags that are semantically related to the query terms
+ */
+export declare function getRelatedTagsForQuery(query: string, maxTags?: number): Promise<string[]>;
+//# sourceMappingURL=query-parser.d.ts.map

package/engine/dist/services/search/query-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-parser.d.ts","sourceRoot":"","sources":["../../../src/services/search/query-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,WAAW,IAAI,cAAc,EAAmB,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAMjG,QAAA,MAAM,GAAG,gCAAc,CAAC;AAMxB,OAAO,EAAE,GAAG,EAAE,gBAAgB,EAAE,cAAc,EAAE,CAAC;AAEjD;;GAEG;AACH,wBAAsB,aAAa,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoBzE;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAqB1E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAezD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAoD9D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAsC1D;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAgC9E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAmC/D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;CAAE,CAgB3H;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BjE;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA6ClG"}

package/engine/dist/services/search/query-parser.js

@@ -0,0 +1,346 @@
+/**
+ * Query Parser Module — "The Ears"
+ *
+ * NLP parsing, temporal extraction, query decomposition, and semantic expansion.
+ * Extracted from search.ts to isolate natural language understanding
+ * from the physics-based search core.
+ */
+import { db } from '../../core/db.js';
+import { config } from '../../config/index.js';
+import { expandTerms as semanticExpand, loadSynonymRing, isExpansionReady } from '@rbalchii/dse';
+import wink from 'wink-nlp';
+import model from 'wink-eng-lite-web-model';
+import { getMasterTags } from '../tags/discovery.js';
+// Initialize NLP (Fast CPU-based)
+const nlp = wink(model);
+// Initialize Semantic Expansion (Synonym Ring)
+loadSynonymRing();
+// Re-export NLP instance and expansion readiness for use by search orchestrator
+export { nlp, isExpansionReady, semanticExpand };
+/**
+ * Fetch top tags from the system to ground the LLM's query expansion
+ */
+export async function getGlobalTags(limit = 50) {
+    try {
+        // Fetch unique tags from the tags table
+        const query = `
+        SELECT DISTINCT unnest(tags) as tag
+        FROM atoms
+        WHERE tags IS NOT NULL
+        LIMIT $1
+    `;
+        const result = await db.run(query, [limit * 10]); // Get more than needed for filtering
+        if (!result.rows)
+            return [];
+        const uniqueTags = result.rows
+            .map((r) => r.tag)
+            .filter((t) => typeof t === 'string' && t.length > 0);
+        return [...new Set(uniqueTags)].slice(0, limit);
+    }
+    catch (e) {
+        console.error('[Search] Failed to fetch global tags:', e);
+        return [];
+    }
+}
+/**
+ * Deterministic Query Expansion (No LLM)
+ * Scans the user query for known tags from the master list.
+ */
+export async function expandQuery(originalQuery) {
+    try {
+        const globalTags = getMasterTags(); // This is synchronous file read
+        const queryLower = originalQuery.toLowerCase();
+        // Find tags specifically mentioned in the query or that substring match
+        // Simple heuristic: if query contains the tag, we boost it.
+        const foundTags = globalTags.filter(tag => {
+            const tagLower = tag.toLowerCase();
+            // Check for boundary matches or direct inclusion
+            return queryLower.includes(tagLower);
+        });
+        if (foundTags.length > 0) {
+            console.log(`[Search] Deterministically matched tags: ${foundTags.join(', ')}`);
+        }
+        return foundTags;
+    }
+    catch (e) {
+        console.error('[Search] Expansion failed:', e);
+        return [];
+    }
+}
+/**
+ * Helper to sanitize queries for FTS engine
+ */
+export function sanitizeFtsQuery(query) {
+    return query
+        .replace(/[^a-zA-Z0-9\s]/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .toLowerCase();
+}
+/**
+ * Expand camelCase and PascalCase identifiers into additional search terms.
+ * e.g. "findAnchors" → ["findAnchors", "find", "Anchors", "anchors"]
+ * Returned terms are de-duped and lowercased for FTS.
+ */
+export function expandCamelCase(terms) {
+    const expanded = new Set();
+    for (const term of terms) {
+        expanded.add(term.toLowerCase());
+        // Split on camelCase/PascalCase boundaries
+        const parts = term
+            .replace(/([a-z])([A-Z])/g, '$1 $2') // camelCase → camel Case
+            .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2') // acronym run: ABCDef → ABC Def
+            .split(/\s+/)
+            .filter(p => p.length > 1);
+        for (const p of parts) {
+            expanded.add(p.toLowerCase());
+        }
+    }
+    return Array.from(expanded);
+}
+/**
+ * Helper: Extract Temporal Context
+ * Detects "last X months/years", year ranges, and returns a list of relevant year tags.
+ */
+export function extractTemporalContext(query) {
+    const now = new Date();
+    const currentYear = now.getFullYear();
+    const tags = new Set();
+    const MAX_TEMPORAL_AMOUNT = 100;
+    // Regex for "last X months/years"
+    const match = query.match(/last\s+(\d+)\s+(months?|years?|days?)/i);
+    if (match) {
+        let amount = parseInt(match[1]);
+        const unit = match[2].toLowerCase();
+        // Security: Cap the amount to prevent loop exhaustion DoS
+        if (amount > MAX_TEMPORAL_AMOUNT) {
+            amount = MAX_TEMPORAL_AMOUNT;
+        }
+        tags.add(currentYear.toString()); // Always include current year
+        if (unit.startsWith('year')) {
+            for (let i = 1; i <= amount; i++) {
+                tags.add((currentYear - i).toString());
+            }
+        }
+        else if (unit.startsWith('month')) {
+            // If subtracting months goes back to prev year
+            const pastDate = new Date(now);
+            pastDate.setMonth(now.getMonth() - amount);
+            const pastYear = pastDate.getFullYear();
+            if (pastYear < currentYear) {
+                for (let y = pastYear; y < currentYear; y++)
+                    tags.add(y.toString());
+            }
+        }
+    }
+    // Detect year ranges like "from 2025 to 2026" or "between 2024 and 2025"
+    const rangeMatch = query.match(/\b(from|between)\s+(\d{4})\s+(to|and)\s+(\d{4})\b/i);
+    if (rangeMatch) {
+        const startYear = parseInt(rangeMatch[2]);
+        const endYear = parseInt(rangeMatch[4]);
+        // Add all years in the range
+        for (let year = Math.min(startYear, endYear); year <= Math.max(startYear, endYear); year++) {
+            tags.add(year.toString());
+        }
+    }
+    // Also detect explicit years (2020-2030)
+    const yearMatch = query.match(/\b(202[0-9]|203[0-9])\b/g);
+    if (yearMatch) {
+        yearMatch.forEach(y => tags.add(y));
+    }
+    return Array.from(tags);
+}
+/**
+ * Natural Language Parser (Standard 070 - Enhanced)
+ * Uses NLP to extract "Meaningful Tags" including Temporal Context.
+ * Enhanced to handle conversational queries of any size.
+ */
+export function parseNaturalLanguage(query) {
+    // 1. Extract Temporal Context
+    const timeTags = extractTemporalContext(query);
+    // 2. Handle conversational queries by extracting key entities and concepts
+    // For very long queries, we want to identify the most important terms
+    const queryLength = query.trim().split(/\s+/).length;
+    let tokens = [];
+    if (queryLength > 10) {
+        // For longer conversational queries, use more sophisticated extraction
+        tokens = extractKeyTermsFromConversation(query);
+    }
+    else {
+        // For shorter queries, use the original approach
+        const doc = nlp.readDoc(query);
+        tokens = doc.tokens().filter((t) => {
+            const tag = t.out(nlp.its.pos);
+            const text = t.out().toLowerCase();
+            // Whitelist specific domain words that might get misclassified or filtered
+            // Uses Config-based whitelist or falls back to defaults
+            const whitelist = config.SEARCH?.whitelist || ['burnout', 'career', 'decision', 'pattern', 'impact'];
+            if (whitelist.some((w) => text.includes(w)))
+                return true;
+            return tag === 'NOUN' || tag === 'PROPN' || tag === 'ADJ' || tag === 'VERB';
+        }).out(nlp.its.text);
+    }
+    // Combine with temporal tags
+    const uniqueTokens = new Set([...tokens, ...timeTags]);
+    if (uniqueTokens.size > 0) {
+        return Array.from(uniqueTokens).join(' ').toLowerCase();
+    }
+    return sanitizeFtsQuery(query);
+}
+/**
+ * Extract key terms from conversational queries
+ * Identifies important nouns, proper nouns, adjectives, and verbs while preserving context
+ */
+export function extractKeyTermsFromConversation(conversation) {
+    const doc = nlp.readDoc(conversation);
+    // Extract named entities (people, places, organizations)
+    const entities = doc.entities().out(nlp.its.normal);
+    // Extract important tokens (nouns, proper nouns, adjectives, verbs)
+    const importantTokens = doc.tokens().filter((t) => {
+        const tag = t.out(nlp.its.pos);
+        const text = t.out().toLowerCase();
+        // Include named entities
+        if (entities.includes(text))
+            return true;
+        // Include important POS tags
+        return tag === 'NOUN' || tag === 'PROPN' || tag === 'ADJ' || tag === 'VERB';
+    }).out(nlp.its.normal);
+    // Combine and deduplicate
+    const allTerms = [...new Set([...entities, ...importantTokens])];
+    // Filter out common stop words that might have slipped through
+    const stopWords = new Set([
+        'the', 'a', 'an', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for',
+        'of', 'with', 'by', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+        'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
+        'should', 'may', 'might', 'must', 'can', 'shall', 'this', 'that', 'these', 'those',
+        'i', 'you', 'he', 'she', 'it', 'we', 'they', 'me', 'him', 'her', 'us', 'them',
+        'what', 'which', 'who', 'when', 'where', 'why', 'how', 'whose', 'whom'
+    ]);
+    return allTerms.filter(term => !stopWords.has(term.toLowerCase()) && term.length > 2);
+}
+/**
+ * Split a query into sentence-like chunks (molecules)
+ */
+export function splitQueryIntoMolecules(query) {
+    // First, clean the query of any extraneous characters or formatting
+    let cleanQuery = query.trim();
+    // Remove common prefixes/suffixes that might interfere with sentence detection
+    cleanQuery = cleanQuery.replace(/^[#\-\*\s]+|[#\-\*\s]+$/g, '').trim();
+    // Split by sentence endings first (periods, exclamation marks, question marks)
+    let sentences = cleanQuery.split(/(?<=[.!?])\s+/);
+    // If no sentence endings found, try to split by commas or other separators
+    if (sentences.length <= 1) {
+        sentences = cleanQuery.split(/(?<=[,;:])\s+/);
+    }
+    // If still no good splits, split by word count (about 10-15 words per chunk)
+    if (sentences.length <= 1) {
+        const words = cleanQuery.split(/\s+/);
+        const chunks = [];
+        const chunkSize = 15; // About 15 words per "molecule"
+        for (let i = 0; i < words.length; i += chunkSize) {
+            const chunk = words.slice(i, i + chunkSize).join(' ');
+            if (chunk.trim()) {
+                chunks.push(chunk);
+            }
+        }
+        return chunks.length > 0 ? chunks : [cleanQuery];
+    }
+    // Clean up the sentences
+    return sentences
+        .map(s => s.trim())
+        .filter(s => s.length > 0);
+}
+export function parseQuery(query) {
+    const result = { phrases: [], temporal: [], buckets: [], keywords: [] };
+    const phraseRegex = /"([^"]+)"/g;
+    let phraseMatch;
+    while ((phraseMatch = phraseRegex.exec(query)) !== null)
+        result.phrases.push(phraseMatch[1]);
+    let remainingQuery = query.replace(/"[^"]+"/g, '');
+    const temporalRegex = /@(\w+)/g;
+    let temporalMatch;
+    while ((temporalMatch = temporalRegex.exec(remainingQuery)) !== null)
+        result.temporal.push(temporalMatch[1]);
+    remainingQuery = remainingQuery.replace(/@\w+/g, '');
+    const bucketRegex = /#(\w+)/g;
+    let bucketMatch;
+    while ((bucketMatch = bucketRegex.exec(remainingQuery)) !== null)
+        result.buckets.push(bucketMatch[1]);
+    remainingQuery = remainingQuery.replace(/#\w+/g, '');
+    result.keywords = remainingQuery.split(/\s+/).filter(kw => kw.length > 0);
+    return result;
+}
+/**
+ * Conversational Query Expansion (Standard 086)
+ * Expands natural language queries into semantic equivalents
+ */
+export function expandConversationalQuery(query) {
+    const expansions = [];
+    // Common conversational patterns
+    const patterns = [
+        { pattern: /what is the (latest|current|recent) (.+)/i, replacement: "$2" },
+        { pattern: /tell me about (.+)/i, replacement: "$1" },
+        { pattern: /how is (.+) doing/i, replacement: "$1" },
+        { pattern: /what's happening with (.+)/i, replacement: "$1" },
+        { pattern: /what do you know about (.+)/i, replacement: "$1" },
+        { pattern: /explain (.+)/i, replacement: "$1" },
+        { pattern: /describe (.+)/i, replacement: "$1" },
+        { pattern: /summarize (.+)/i, replacement: "$1" }
+    ];
+    for (const p of patterns) {
+        const match = query.match(p.pattern);
+        if (match) {
+            const expanded = query.replace(p.pattern, p.replacement).trim();
+            if (expanded && !expansions.includes(expanded)) {
+                expansions.push(expanded);
+            }
+        }
+    }
+    return expansions;
+}
+/**
+ * Get related tags for a given query to provide semantic serendipity
+ * This function finds tags that are semantically related to the query terms
+ */
+export async function getRelatedTagsForQuery(query, maxTags = 5) {
+    try {
+        // Get all tags from the system
+        const allTags = await getGlobalTags(100); // Get top 100 tags
+        // Get the query terms to match against
+        const queryTerms = query.toLowerCase().split(/\s+/).filter(term => term.length > 0);
+        // If no query terms, return empty array
+        if (queryTerms.length === 0) {
+            return [];
+        }
+        // Find tags that are related to the query terms
+        const relatedTags = [];
+        for (const tag of allTags) {
+            if (typeof tag !== 'string')
+                continue;
+            const tagLower = tag.toLowerCase();
+            let score = 0;
+            // Increase score if tag contains or is similar to query terms
+            for (const term of queryTerms) {
+                if (tagLower.includes(term) || term.includes(tagLower)) {
+                    score += 10; // Direct match gets high score
+                }
+                else if (tagLower.startsWith(term) || tagLower.endsWith(term)) {
+                    score += 5; // Partial match gets medium score
+                }
+                // Additional heuristics could be added here
+            }
+            if (score > 0) {
+                relatedTags.push({ tag, score });
+            }
+        }
+        // Sort by score and return top tags
+        relatedTags.sort((a, b) => b.score - a.score);
+        return relatedTags.slice(0, maxTags).map(item => item.tag);
+    }
+    catch (error) {
+        console.error('[Search] Error getting related tags:', error);
+        // Return empty array if there's an error
+        return [];
+    }
+}
+//# sourceMappingURL=query-parser.js.map

package/engine/dist/services/search/query-parser.js.map

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

package/engine/dist/services/search/search-utils.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Search Utilities Module — "The Tools"
+ *
+ * Types, interfaces, Hamming distance calculation, result formatting,
+ * and display helpers used across the search subsystem.
+ * Extracted from search.ts for clean separation of concerns.
+ */
+import { SemanticCategory } from '../../types/taxonomy.js';
+/**
+ * Coalesced Snippet - Merged atoms from same file within proximity threshold
+ */
+export interface CoalescedSnippet {
+    source: string;
+    compoundId: string;
+    startByte: number;
+    endByte: number;
+    timestamp: number;
+    content: string;
+    sourceAtoms: SearchResult[];
+    relevanceScore: number;
+    provenance: string;
+    tags: string[];
+}
+export interface SearchResult {
+    id: string;
+    content: string;
+    source: string;
+    timestamp: number;
+    buckets: string[];
+    tags: string[];
+    epochs: string;
+    provenance: string;
+    score: number;
+    sequence?: number;
+    molecular_signature?: string;
+    frequency?: number;
+    temporal_state?: {
+        first_seen: number;
+        last_seen: number;
+        occurrence_count: number;
+        timestamps: number[];
+    };
+    compound_id?: string;
+    start_byte?: number;
+    end_byte?: number;
+    type?: string;
+    numeric_value?: number;
+    numeric_unit?: string;
+    is_inflated?: boolean;
+    semanticCategories?: SemanticCategory[];
+    relatedEntities?: string[];
+    temporal_weight?: number;
+    decay_factor?: number;
+    simhash_distance?: number;
+    structural_similarity?: number;
+    association_path?: string[];
+    retrieved_at?: number;
+}
+/**
+ * Helper: Calculate Hamming Distance between two hex strings
+ * Uses the native module or fallback if available
+ */
+export declare function getHammingDistance(hashA: string, hashB: string): number;
+/**
+ * Helper: safely extract array from possibly undefined input
+ */
+export declare function getItems(input: string[] | undefined): string[];
+/**
+ * Coalesce atoms by proximity - merges nearby atoms from same source file
+ * into coherent snippets for better LLM consumption
+ *
+ * @param results - Search results to coalesce
+ * @param proximityThreshold - Bytes within which to merge atoms (default 500)
+ * @returns Coalesced snippets with expanded content
+ */
+export declare function coalesceByProximity(results: SearchResult[], proximityThreshold?: number, maxSnippets?: number): Promise<CoalescedSnippet[]>;
+/**
+ * Format search results within character budget
+ * Uses molecular coordinates (start_byte/end_byte) for precise content slicing
+ *
+ * Features:
+ * - Coalesces nearby atoms into coherent snippets (500-1000 chars)
+ * - Adds metadata headers with file, range, timestamp, atom count
+ * - Sorts chronologically for causal narrative
+ * - Wraps in XML with relevance scores for LLM prioritization
+ */
+export declare function formatResults(results: SearchResult[], maxChars: number, options?: {
+    enableCoalescing?: boolean;
+    proximityThreshold?: number;
+}): Promise<{
+    context: string;
+    results: SearchResult[];
+    toAgentString: () => string;
+    metadata?: any;
+}>;
+/**
+ * Helper to filter tags for display (User Request: Hide Year Numbers)
+ */
+export declare function filterDisplayTags(tags: string[]): string[];
+//# sourceMappingURL=search-utils.d.ts.map

package/engine/dist/services/search/search-utils.d.ts.map

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