@rbalchii/anchor-engine 4.7.0

package/engine/dist/config/index.js

@@ -0,0 +1,326 @@
+/**
+ * Configuration Module for Sovereign Context Engine
+ *
+ * This module manages all configuration for the context engine including
+ * paths, model settings, and system parameters.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import yaml from 'js-yaml';
+// For __dirname equivalent in ES modules
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Default configuration
+const DEFAULT_CONFIG = {
+    // Core
+    PORT: 3160,
+    HOST: "0.0.0.0",
+    API_KEY: "ece-secret-key",
+    LOG_LEVEL: "INFO",
+    OVERLAY_PORT: 3002,
+    // LLM Provider
+    LLM_PROVIDER: 'local',
+    REMOTE_LLM_URL: "http://localhost:8000/v1",
+    REMOTE_MODEL_NAME: "default",
+    LLM_MODEL_DIR: "models",
+    // Tuning
+    DEFAULT_SEARCH_CHAR_LIMIT: 524288,
+    SIMILARITY_THRESHOLD: 0.8,
+    TOKEN_LIMIT: 1000000,
+    VECTOR_INGEST_BATCH: 50,
+    // Resource Management
+    GC_COOLDOWN_MS: 30000, // 30 seconds
+    MAX_ATOMS_IN_MEMORY: 2000,
+    MONITORING_INTERVAL_MS: 30000, // 30 seconds
+    // Watcher Settings
+    WATCHER_DEBOUNCE_MS: 2000,
+    WATCHER_STABILITY_THRESHOLD_MS: 2000,
+    WATCHER_EXTRA_PATHS: [],
+    // Context Relevance
+    CONTEXT_RELEVANCE_WEIGHT: 0.7,
+    CONTEXT_RECENCY_WEIGHT: 0.3,
+    // Infrastructure
+    REDIS: {
+        ENABLED: false,
+        URL: "redis://localhost:6379",
+        TTL: 3600
+    },
+    NEO4J: {
+        ENABLED: false,
+        URI: "bolt://localhost:7687",
+        USER: "neo4j",
+        PASS: "password"
+    },
+    // Features
+    FEATURES: {
+        CONTEXT_STORAGE: true,
+        MEMORY_RECALL: true,
+        CODA: true,
+        ARCHIVIST: true,
+        WEAVER: true,
+        MARKOVIAN: true
+    },
+    // Search
+    SEARCH: {
+        strategy: "hybrid",
+        hide_years_in_tags: true,
+        whitelist: [],
+        max_chars_default: 5000, // 5k chars = ~1.25k tokens (mobile-friendly)
+        max_chars_limit: 20000, // 20k chars max limit
+        fts_window_size: 1500,
+        fts_padding: 750
+    },
+    // Models
+    MODELS: {
+        EMBEDDING_DIM: 768,
+        MAIN: {
+            PATH: "glm-edge-1.5b-chat.Q5_K_M.gguf", // Default from user_settings.json
+            CTX_SIZE: 8192, // Default from user_settings.json
+            GPU_LAYERS: 11, // Default from user_settings.json
+            MAX_TOKENS: 1024
+        },
+        ORCHESTRATOR: {
+            PATH: "Qwen3-4B-Function-Calling-Pro.gguf", // Default from user_settings.json
+            CTX_SIZE: 8192,
+            GPU_LAYERS: 0,
+            MAX_TOKENS: 2048
+        },
+        VISION: {
+            PATH: "", // MUST BE SET IN user_settings.json
+            PROJECTOR: "", // MUST BE SET IN user_settings.json
+            CTX_SIZE: 2048,
+            GPU_LAYERS: 11, // Default from user_settings.json
+            MAX_TOKENS: 1024
+        }
+    },
+    // Services
+    SERVICES: {
+        VISION_SERVER_PORT: 8081,
+        CHAT_SERVER_PORT: 8080,
+        TAG_INFECTOR_UNLOAD_TIMEOUT: 300000, // 5 minutes
+        TAG_GLINER_CHECK_INTERVAL: 60000 // 1 minute
+    },
+    // Limits and Thresholds
+    LIMITS: {
+        MAX_FILE_SIZE_BYTES: 10485760, // 10MB
+        MAX_CONTENT_LENGTH_CHARS: 5000,
+        MAX_CHUNK_SIZE_CHARS: 3000,
+        MAX_SUMMARY_LENGTH_CHARS: 2000,
+        DATE_EXTRACTOR_SCAN_LIMIT: 2000
+    },
+    // Database Settings
+    DATABASE: {
+        // Standard 051: Ephemeral Index
+        // Default true: wipe PGlite index on each startup so it rebuilds from mirrored_brain/.
+        // Set false to retain the index across restarts (faster startup, but risks stale/corrupt data).
+        WIPE_ON_STARTUP: true
+    },
+    // Adaptive Concurrency (Standard 132)
+    // Automatically adjusts parallel processing based on available memory
+    ADAPTIVE_CONCURRENCY: {
+        // Memory threshold in MB below which to use sequential processing (default: 2048)
+        SEQUENTIAL_THRESHOLD_MB: parseInt(process.env['ANCHOR_SEQUENTIAL_THRESHOLD_MB'] || '2048', 10),
+        // Memory threshold in MB above which to use full parallel processing (default: 8192)
+        PARALLEL_THRESHOLD_MB: parseInt(process.env['ANCHOR_PARALLEL_THRESHOLD_MB'] || '8192', 10),
+        // Maximum concurrent operations in adaptive mode (default: 5)
+        MAX_CONCURRENCY: parseInt(process.env['ANCHOR_MAX_CONCURRENCY'] || '5', 10),
+        // Batch size for low-memory mode (default: 1)
+        LOW_MEMORY_BATCH_SIZE: parseInt(process.env['ANCHOR_LOW_MEMORY_BATCH_SIZE'] || '1', 10),
+        // Batch size for high-memory mode (default: 20)
+        HIGH_MEMORY_BATCH_SIZE: parseInt(process.env['ANCHOR_HIGH_MEMORY_BATCH_SIZE'] || '20', 10),
+        // Force sequential mode regardless of memory (default: false)
+        FORCE_SEQUENTIAL: process.env['ANCHOR_FORCE_SEQUENTIAL'] === 'true',
+        // Force parallel mode regardless of memory (default: false)
+        FORCE_PARALLEL: process.env['ANCHOR_FORCE_PARALLEL'] === 'true'
+    },
+    // Memory Management (Standard 127/134/135)
+    // Configurable memory thresholds for search throttling and streaming
+    MEMORY: {
+        // Heap pressure threshold for downgrading max-recall to standard (default: 500MB)
+        HEAP_PRESSURE_MB: parseInt(process.env['ANCHOR_HEAP_PRESSURE_MB'] || '500', 10),
+        // Start throttling searches at this heap size (default: 800MB)
+        THROTTLE_START_MB: parseInt(process.env['ANCHOR_THROTTLE_START_MB'] || '800', 10),
+        // Reject searches above this heap size (default: 1200MB)
+        THROTTLE_MAX_MB: parseInt(process.env['ANCHOR_THROTTLE_MAX_MB'] || '1200', 10),
+        // Emergency stop searches at this heap size (default: 1500MB)
+        EMERGENCY_STOP_MB: parseInt(process.env['ANCHOR_EMERGENCY_STOP_MB'] || '1500', 10),
+        // Batch size for streaming search results (default: 20)
+        SEARCH_RESULTS_BATCH_SIZE: parseInt(process.env['ANCHOR_SEARCH_RESULTS_BATCH_SIZE'] || '20', 10),
+        // Enable streaming results for memory efficiency (default: false)
+        ENABLE_STREAMING_RESULTS: process.env['ANCHOR_ENABLE_STREAMING_RESULTS'] === 'true'
+    }
+};
+// Configuration loader
+function loadConfig() {
+    // Determine config file path
+    // Priority: user_settings.json > sovereign.yaml > .env > Defaults
+    let loadedConfig = { ...DEFAULT_CONFIG };
+    // 1. Try Loading sovereign.yaml (Legacy/System Config)
+    const configPath = process.env['SOVEREIGN_CONFIG_PATH'] ||
+        path.join(__dirname, '..', '..', 'sovereign.yaml') ||
+        path.join(__dirname, '..', 'config', 'default.yaml');
+    if (fs.existsSync(configPath)) {
+        try {
+            const configFile = fs.readFileSync(configPath, 'utf8');
+            const parsedConfig = yaml.load(configFile);
+            loadedConfig = { ...loadedConfig, ...parsedConfig };
+        }
+        catch (error) {
+            console.warn(`Failed to load config from ${configPath}:`, error);
+        }
+    }
+    // 2. Try Loading user_settings.json (Highest Priority for User Overrides)
+    // First try the root of the anchor-os project (monorepo setup)
+    const userSettingsPath = path.join(__dirname, '..', '..', '..', 'user_settings.json');
+    if (fs.existsSync(userSettingsPath) && fs.statSync(userSettingsPath).isFile()) {
+        try {
+            const userSettings = JSON.parse(fs.readFileSync(userSettingsPath, 'utf8'));
+            console.log(`[Config] Loaded settings from ${userSettingsPath}`);
+            // Load LLM Settings (Provider + Model paths — single consolidated block)
+            if (userSettings.llm) {
+                // Provider settings
+                if (userSettings.llm.provider)
+                    loadedConfig.LLM_PROVIDER = userSettings.llm.provider;
+                if (userSettings.llm.remote_url)
+                    loadedConfig.REMOTE_LLM_URL = userSettings.llm.remote_url;
+                if (userSettings.llm.remote_model)
+                    loadedConfig.REMOTE_MODEL_NAME = userSettings.llm.remote_model;
+                if (userSettings.llm.model_dir)
+                    loadedConfig.LLM_MODEL_DIR = userSettings.llm.model_dir;
+                // Main model
+                if (userSettings.llm.chat_model)
+                    loadedConfig.MODELS.MAIN.PATH = userSettings.llm.chat_model;
+                if (userSettings.llm.gpu_layers !== undefined)
+                    loadedConfig.MODELS.MAIN.GPU_LAYERS = userSettings.llm.gpu_layers;
+                if (userSettings.llm.ctx_size !== undefined)
+                    loadedConfig.MODELS.MAIN.CTX_SIZE = userSettings.llm.ctx_size;
+                if (userSettings.llm.max_tokens !== undefined)
+                    loadedConfig.MODELS.MAIN.MAX_TOKENS = userSettings.llm.max_tokens;
+                // Orchestrator model
+                if (userSettings.llm.task_model)
+                    loadedConfig.MODELS.ORCHESTRATOR.PATH = userSettings.llm.task_model;
+                if (userSettings.llm.orchestrator_ctx_size !== undefined)
+                    loadedConfig.MODELS.ORCHESTRATOR.CTX_SIZE = userSettings.llm.orchestrator_ctx_size;
+                if (userSettings.llm.orchestrator_gpu_layers !== undefined)
+                    loadedConfig.MODELS.ORCHESTRATOR.GPU_LAYERS = userSettings.llm.orchestrator_gpu_layers;
+                if (userSettings.llm.orchestrator_max_tokens !== undefined)
+                    loadedConfig.MODELS.ORCHESTRATOR.MAX_TOKENS = userSettings.llm.orchestrator_max_tokens;
+                // Vision model
+                if (userSettings.llm.vision_model)
+                    loadedConfig.MODELS.VISION.PATH = userSettings.llm.vision_model;
+                if (userSettings.llm.vision_projector)
+                    loadedConfig.MODELS.VISION.PROJECTOR = userSettings.llm.vision_projector;
+                if (userSettings.llm.vision_ctx_size !== undefined)
+                    loadedConfig.MODELS.VISION.CTX_SIZE = userSettings.llm.vision_ctx_size;
+                if (userSettings.llm.vision_gpu_layers !== undefined)
+                    loadedConfig.MODELS.VISION.GPU_LAYERS = userSettings.llm.vision_gpu_layers;
+                if (userSettings.llm.vision_max_tokens !== undefined)
+                    loadedConfig.MODELS.VISION.MAX_TOKENS = userSettings.llm.vision_max_tokens;
+            }
+            // Load Search Settings (single consolidated block)
+            if (userSettings.search) {
+                if (userSettings.search.strategy)
+                    loadedConfig.SEARCH.strategy = userSettings.search.strategy;
+                if (userSettings.search.hide_years_in_tags !== undefined)
+                    loadedConfig.SEARCH.hide_years_in_tags = userSettings.search.hide_years_in_tags;
+                if (userSettings.search.whitelist)
+                    loadedConfig.SEARCH.whitelist = userSettings.search.whitelist;
+                if (userSettings.search.max_chars_default !== undefined)
+                    loadedConfig.SEARCH.max_chars_default = userSettings.search.max_chars_default;
+                if (userSettings.search.max_chars_limit !== undefined)
+                    loadedConfig.SEARCH.max_chars_limit = userSettings.search.max_chars_limit;
+                if (userSettings.search.fts_window_size !== undefined)
+                    loadedConfig.SEARCH.fts_window_size = userSettings.search.fts_window_size;
+                if (userSettings.search.fts_padding !== undefined)
+                    loadedConfig.SEARCH.fts_padding = userSettings.search.fts_padding;
+            }
+            // Load Server Settings
+            if (userSettings.server) {
+                if (userSettings.server.host)
+                    loadedConfig.HOST = userSettings.server.host;
+                if (userSettings.server.port)
+                    loadedConfig.PORT = userSettings.server.port;
+                if (userSettings.server.api_key !== undefined)
+                    loadedConfig.API_KEY = userSettings.server.api_key;
+            }
+            // Load Resource Management Settings
+            if (userSettings.resource_management) {
+                if (userSettings.resource_management.gc_cooldown_ms !== undefined)
+                    loadedConfig.GC_COOLDOWN_MS = userSettings.resource_management.gc_cooldown_ms;
+                if (userSettings.resource_management.max_atoms_in_memory !== undefined)
+                    loadedConfig.MAX_ATOMS_IN_MEMORY = userSettings.resource_management.max_atoms_in_memory;
+                if (userSettings.resource_management.monitoring_interval_ms !== undefined)
+                    loadedConfig.MONITORING_INTERVAL_MS = userSettings.resource_management.monitoring_interval_ms;
+            }
+            // Load Watcher Settings
+            if (userSettings.watcher) {
+                if (userSettings.watcher.debounce_ms !== undefined)
+                    loadedConfig.WATCHER_DEBOUNCE_MS = userSettings.watcher.debounce_ms;
+                if (userSettings.watcher.stability_threshold_ms !== undefined)
+                    loadedConfig.WATCHER_STABILITY_THRESHOLD_MS = userSettings.watcher.stability_threshold_ms;
+                if (userSettings.watcher.extra_paths)
+                    loadedConfig.WATCHER_EXTRA_PATHS = userSettings.watcher.extra_paths;
+            }
+            // Load Context Relevance Settings
+            if (userSettings.context) {
+                if (userSettings.context.relevance_weight !== undefined)
+                    loadedConfig.CONTEXT_RELEVANCE_WEIGHT = userSettings.context.relevance_weight;
+                if (userSettings.context.recency_weight !== undefined)
+                    loadedConfig.CONTEXT_RECENCY_WEIGHT = userSettings.context.recency_weight;
+            }
+            // Load Service Settings
+            if (userSettings.services) {
+                if (userSettings.services.vision_server_port !== undefined)
+                    loadedConfig.SERVICES.VISION_SERVER_PORT = userSettings.services.vision_server_port;
+                if (userSettings.services.chat_server_port !== undefined)
+                    loadedConfig.SERVICES.CHAT_SERVER_PORT = userSettings.services.chat_server_port;
+                if (userSettings.services.tag_infector_unload_timeout !== undefined)
+                    loadedConfig.SERVICES.TAG_INFECTOR_UNLOAD_TIMEOUT = userSettings.services.tag_infector_unload_timeout;
+                if (userSettings.services.tag_gliner_check_interval !== undefined)
+                    loadedConfig.SERVICES.TAG_GLINER_CHECK_INTERVAL = userSettings.services.tag_gliner_check_interval;
+            }
+            // Load Database Settings
+            if (userSettings.database) {
+                if (userSettings.database.wipe_on_startup !== undefined)
+                    loadedConfig.DATABASE.WIPE_ON_STARTUP = userSettings.database.wipe_on_startup;
+            }
+            // Load Limits and Thresholds
+            if (userSettings.limits) {
+                if (userSettings.limits.max_file_size_bytes !== undefined)
+                    loadedConfig.LIMITS.MAX_FILE_SIZE_BYTES = userSettings.limits.max_file_size_bytes;
+                if (userSettings.limits.max_content_length_chars !== undefined)
+                    loadedConfig.LIMITS.MAX_CONTENT_LENGTH_CHARS = userSettings.limits.max_content_length_chars;
+                if (userSettings.limits.max_chunk_size_chars !== undefined)
+                    loadedConfig.LIMITS.MAX_CHUNK_SIZE_CHARS = userSettings.limits.max_chunk_size_chars;
+                if (userSettings.limits.max_summary_length_chars !== undefined)
+                    loadedConfig.LIMITS.MAX_SUMMARY_LENGTH_CHARS = userSettings.limits.max_summary_length_chars;
+                if (userSettings.limits.date_extractor_scan_limit !== undefined)
+                    loadedConfig.LIMITS.DATE_EXTRACTOR_SCAN_LIMIT = userSettings.limits.date_extractor_scan_limit;
+            }
+            // Load Memory Management Settings (Standard 127/134/135)
+            if (userSettings.memory) {
+                if (userSettings.memory.heap_pressure_mb !== undefined)
+                    loadedConfig.MEMORY.HEAP_PRESSURE_MB = userSettings.memory.heap_pressure_mb;
+                if (userSettings.memory.throttle_start_mb !== undefined)
+                    loadedConfig.MEMORY.THROTTLE_START_MB = userSettings.memory.throttle_start_mb;
+                if (userSettings.memory.throttle_max_mb !== undefined)
+                    loadedConfig.MEMORY.THROTTLE_MAX_MB = userSettings.memory.throttle_max_mb;
+                if (userSettings.memory.emergency_stop_mb !== undefined)
+                    loadedConfig.MEMORY.EMERGENCY_STOP_MB = userSettings.memory.emergency_stop_mb;
+                if (userSettings.memory.search_results_batch_size !== undefined)
+                    loadedConfig.MEMORY.SEARCH_RESULTS_BATCH_SIZE = userSettings.memory.search_results_batch_size;
+                if (userSettings.memory.enable_streaming_results !== undefined)
+                    loadedConfig.MEMORY.ENABLE_STREAMING_RESULTS = userSettings.memory.enable_streaming_results;
+            }
+        }
+        catch (e) {
+            console.error(`[Config] Failed to parse user_settings.json:`, e);
+        }
+    }
+    return loadedConfig;
+}
+// Export configuration
+export const config = loadConfig();
+export default config;
+//# sourceMappingURL=index.js.map

package/engine/dist/config/index.js.map

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

package/engine/dist/config/max-recall-config.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Maximum Recall Configuration for STAR Algorithm
+ *
+ * Optimized for retrieving the maximum relevant context with minimal filtering.
+ * Use this for important sessions where you need comprehensive memory retrieval.
+ *
+ * Key Principles:
+ * - No temporal bias: Old memories weighted equally to new ones
+ * - Deep graph traversal: 3 hops to find indirect associations
+ * - Zero relevance filtering: Let the budget truncate, not the threshold
+ * - High serendipity: Temperature-scaled sampling for surprising connections
+ *
+ * Usage:
+ *   import { MAX_RECALL_CONFIG } from './config/max-recall-config.js';
+ *   const result = await executeSearch(query, buckets, MAX_RECALL_CONFIG.max_chars, ...);
+ */
+export declare const MAX_RECALL_CONFIG: {
+    max_chars_default: number;
+    walker: {
+        planet_budget: number;
+        moon_budget: number;
+        max_hops: number;
+        temporal_decay: number;
+        damping: number;
+        min_relevance: number;
+        temperature: number;
+        gravity_threshold: number;
+        max_per_hop: number;
+        walk_radius: number;
+    };
+    expansion: {
+        use_synonyms: boolean;
+        max_synonyms_per_term: number;
+        use_semantic_expansion: boolean;
+        use_query_splitting: boolean;
+        use_enhanced_tag_walker: boolean;
+    };
+    context: {
+        include_provenance: boolean;
+        include_temporal_weight: boolean;
+        include_simhash_distance: boolean;
+        include_association_path: boolean;
+        deduplicate_by_simhash: boolean;
+        sort_by: "gravity";
+    };
+};
+/**
+ * Quick comparison with default config
+ */
+export declare const DEFAULT_COMPARISON: {
+    parameter: string[];
+    default: number[];
+    maxRecall: number[];
+};
+/**
+ * Get config for specific use case
+ */
+export declare function getRecallConfig(mode: 'maximum' | 'balanced' | 'focused'): {
+    max_chars_default: number;
+    walker: {
+        planet_budget: number;
+        moon_budget: number;
+        max_hops: number;
+        temporal_decay: number;
+        damping: number;
+        min_relevance: number;
+        temperature: number;
+        gravity_threshold: number;
+        max_per_hop: number;
+        walk_radius: number;
+    };
+    expansion: {
+        use_synonyms: boolean;
+        max_synonyms_per_term: number;
+        use_semantic_expansion: boolean;
+        use_query_splitting: boolean;
+        use_enhanced_tag_walker: boolean;
+    };
+    context: {
+        include_provenance: boolean;
+        include_temporal_weight: boolean;
+        include_simhash_distance: boolean;
+        include_association_path: boolean;
+        deduplicate_by_simhash: boolean;
+        sort_by: "gravity";
+    };
+} | {
+    max_chars_default: number;
+    walker: {
+        planet_budget: number;
+        moon_budget: number;
+        max_hops: number;
+        temporal_decay: number;
+        damping: number;
+        min_relevance: number;
+        temperature: number;
+        gravity_threshold: number;
+        max_per_hop: number;
+        walk_radius: number;
+    };
+};
+//# sourceMappingURL=max-recall-config.d.ts.map

package/engine/dist/config/max-recall-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"max-recall-config.d.ts","sourceRoot":"","sources":["../../src/config/max-recall-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoC7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;CAI9B,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyCvE"}

package/engine/dist/config/max-recall-config.js

@@ -0,0 +1,102 @@
+/**
+ * Maximum Recall Configuration for STAR Algorithm
+ *
+ * Optimized for retrieving the maximum relevant context with minimal filtering.
+ * Use this for important sessions where you need comprehensive memory retrieval.
+ *
+ * Key Principles:
+ * - No temporal bias: Old memories weighted equally to new ones
+ * - Deep graph traversal: 3 hops to find indirect associations
+ * - Zero relevance filtering: Let the budget truncate, not the threshold
+ * - High serendipity: Temperature-scaled sampling for surprising connections
+ *
+ * Usage:
+ *   import { MAX_RECALL_CONFIG } from './config/max-recall-config.js';
+ *   const result = await executeSearch(query, buckets, MAX_RECALL_CONFIG.max_chars, ...);
+ */
+export const MAX_RECALL_CONFIG = {
+    // Context Budget (256K chars = ~64K tokens max)
+    max_chars_default: 262144,
+    // Physics Tag-Walker Parameters
+    walker: {
+        planet_budget: 0.7, // 70% direct FTS/SimHash hits
+        moon_budget: 0.3, // 30% graph-discovered associations
+        max_hops: 3, // Walk 3 steps through graph (finds indirect relations)
+        temporal_decay: 0.0, // DISABLED: All memories equally important regardless of age
+        damping: 1.0, // ZERO loss on multi-hop propagation
+        min_relevance: 0.0, // Include everything, let budget truncate naturally
+        temperature: 0.8, // High serendipity (0.0 = deterministic, 1.0 = maximum random)
+        gravity_threshold: 0.0, // No minimum gravity score - include weak connections
+        max_per_hop: 200, // Expand aggressively: 200 nodes per hop
+        walk_radius: 3 // Full 3-hop radial inflation
+    },
+    // Query Expansion
+    expansion: {
+        use_synonyms: true, // Enable synonym ring expansion
+        max_synonyms_per_term: 10, // Get up to 10 synonyms per term
+        use_semantic_expansion: true, // Use @rbalchii/dse semantic expansion
+        use_query_splitting: true, // Split complex queries into molecules
+        use_enhanced_tag_walker: true // Always use enhanced tag-walker
+    },
+    // Context Assembly
+    context: {
+        include_provenance: true, // Include source metadata for each result
+        include_temporal_weight: true, // Show temporal weight (will be 1.0 for all with decay=0)
+        include_simhash_distance: true, // Show content similarity scores
+        include_association_path: true, // Show which tags connected to query
+        deduplicate_by_simhash: true, // Remove near-duplicates (hamming < 5)
+        sort_by: 'gravity' // Sort by gravity score (comprehensive weighting)
+    }
+};
+/**
+ * Quick comparison with default config
+ */
+export const DEFAULT_COMPARISON = {
+    parameter: ['temporal_decay', 'damping', 'max_hops', 'min_relevance', 'temperature', 'max_per_hop'],
+    default: [0.00001, 0.85, 1, 0.3, 0.2, 50],
+    maxRecall: [0.0, 1.0, 3, 0.0, 0.8, 200]
+};
+/**
+ * Get config for specific use case
+ */
+export function getRecallConfig(mode) {
+    if (mode === 'maximum') {
+        return MAX_RECALL_CONFIG;
+    }
+    if (mode === 'focused') {
+        // Focused: Narrow retrieval with high precision
+        return {
+            max_chars_default: 32768, // 32K chars
+            walker: {
+                planet_budget: 0.9,
+                moon_budget: 0.1,
+                max_hops: 1,
+                // λ = 0.00001 h⁻¹ (7.9 year half-life) - matches paper.md line 69
+                temporal_decay: 0.00001,
+                damping: 0.7,
+                min_relevance: 0.5,
+                temperature: 0.1,
+                gravity_threshold: 0.5,
+                max_per_hop: 20,
+                walk_radius: 1
+            }
+        };
+    }
+    // Balanced: Default production config
+    return {
+        max_chars_default: 131072, // 128K chars
+        walker: {
+            planet_budget: 0.7,
+            moon_budget: 0.3,
+            max_hops: 2,
+            temporal_decay: 0.00001,
+            damping: 0.85,
+            min_relevance: 0.1,
+            temperature: 0.2,
+            gravity_threshold: 0.01,
+            max_per_hop: 50,
+            walk_radius: 1
+        }
+    };
+}
+//# sourceMappingURL=max-recall-config.js.map

package/engine/dist/config/max-recall-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"max-recall-config.js","sourceRoot":"","sources":["../../src/config/max-recall-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,gDAAgD;IAChD,iBAAiB,EAAE,MAAM;IAEzB,gCAAgC;IAChC,MAAM,EAAE;QACN,aAAa,EAAE,GAAG,EAAS,8BAA8B;QACzD,WAAW,EAAE,GAAG,EAAW,oCAAoC;QAC/D,QAAQ,EAAE,CAAC,EAAgB,wDAAwD;QACnF,cAAc,EAAE,GAAG,EAAQ,6DAA6D;QACxF,OAAO,EAAE,GAAG,EAAe,qCAAqC;QAChE,aAAa,EAAE,GAAG,EAAS,oDAAoD;QAC/E,WAAW,EAAE,GAAG,EAAW,+DAA+D;QAC1F,iBAAiB,EAAE,GAAG,EAAK,sDAAsD;QACjF,WAAW,EAAE,GAAG,EAAW,yCAAyC;QACpE,WAAW,EAAE,CAAC,CAAa,8BAA8B;KAC1D;IAED,kBAAkB;IAClB,SAAS,EAAE;QACT,YAAY,EAAE,IAAI,EAAqB,gCAAgC;QACvE,qBAAqB,EAAE,EAAE,EAAc,iCAAiC;QACxE,sBAAsB,EAAE,IAAI,EAAW,uCAAuC;QAC9E,mBAAmB,EAAE,IAAI,EAAc,uCAAuC;QAC9E,uBAAuB,EAAE,IAAI,CAAU,iCAAiC;KACzE;IAED,mBAAmB;IACnB,OAAO,EAAE;QACP,kBAAkB,EAAE,IAAI,EAAe,0CAA0C;QACjF,uBAAuB,EAAE,IAAI,EAAU,0DAA0D;QACjG,wBAAwB,EAAE,IAAI,EAAS,iCAAiC;QACxE,wBAAwB,EAAE,IAAI,EAAS,qCAAqC;QAC5E,sBAAsB,EAAE,IAAI,EAAW,uCAAuC;QAC9E,OAAO,EAAE,SAAkB,CAAY,kDAAkD;KAC1F;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,SAAS,EAAE,CAAC,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,CAAC;IACnG,OAAO,EAAI,CAAC,OAAO,EAAM,IAAI,EAAM,CAAC,EAAS,GAAG,EAAa,GAAG,EAAU,EAAE,CAAC;IAC7E,SAAS,EAAE,CAAC,GAAG,EAAS,GAAG,EAAO,CAAC,EAAS,GAAG,EAAa,GAAG,EAAU,GAAG,CAAC;CAC9E,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAwC;IACtE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,gDAAgD;QAChD,OAAO;YACL,iBAAiB,EAAE,KAAK,EAAE,YAAY;YACtC,MAAM,EAAE;gBACN,aAAa,EAAE,GAAG;gBAClB,WAAW,EAAE,GAAG;gBAChB,QAAQ,EAAE,CAAC;gBACX,kEAAkE;gBAClE,cAAc,EAAE,OAAO;gBACvB,OAAO,EAAE,GAAG;gBACZ,aAAa,EAAE,GAAG;gBAClB,WAAW,EAAE,GAAG;gBAChB,iBAAiB,EAAE,GAAG;gBACtB,WAAW,EAAE,EAAE;gBACf,WAAW,EAAE,CAAC;aACf;SACF,CAAC;IACJ,CAAC;IAED,sCAAsC;IACtC,OAAO;QACL,iBAAiB,EAAE,MAAM,EAAE,aAAa;QACxC,MAAM,EAAE;YACN,aAAa,EAAE,GAAG;YAClB,WAAW,EAAE,GAAG;YAChB,QAAQ,EAAE,CAAC;YACX,cAAc,EAAE,OAAO;YACvB,OAAO,EAAE,IAAI;YACb,aAAa,EAAE,GAAG;YAClB,WAAW,EAAE,GAAG;YAChB,iBAAiB,EAAE,IAAI;YACvB,WAAW,EAAE,EAAE;YACf,WAAW,EAAE,CAAC;SACf;KACF,CAAC;AACJ,CAAC"}

package/engine/dist/config/paths.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Path Configuration for Sovereign Context Engine
+ *
+ * Defines all the important paths used by the system.
+ */
+export declare const PROJECT_ROOT: string;
+export declare const CONTEXT_DIR: string;
+export declare const MODELS_DIR: string;
+export declare const DIST_DIR: string;
+export declare const BASE_PATH: string;
+export declare const LOGS_DIR: string;
+export declare const NOTEBOOK_DIR: string;
+export declare const PATHS: {
+    PROJECT_ROOT: string;
+    CONTEXT_DIR: string;
+    MODELS_DIR: string;
+    DIST_DIR: string;
+    BACKUPS_DIR: string;
+    MIRRORED_BRAIN_DIR: string;
+    LOGS_DIR: string;
+    CONFIG_FILE: string;
+    USER_SETTINGS: string;
+    DATABASE_FILE: string;
+    INBOX_DIR: string;
+    EXTERNAL_INBOX_DIR: string;
+    LIBRARIES_DIR: string;
+    MIRRORS_DIR: string;
+    SESSIONS_DIR: string;
+    TEMP_DIR: string;
+    ENGINE_BIN: string;
+    ENGINE_SRC: string;
+    ENGINE_DIST: string;
+    ENGINE_CONTEXT: string;
+    ENGINE_PLUGINS: string;
+    DESKTOP_OVERLAY_SRC: string;
+    DESKTOP_OVERLAY_DIST: string;
+};
+export declare const BACKUPS_DIR: string, MIRRORED_BRAIN_DIR: string, ENGINE_CONTEXT: string, ENGINE_PLUGINS: string, DESKTOP_OVERLAY_SRC: string, DESKTOP_OVERLAY_DIST: string;
+export default PATHS;
+//# sourceMappingURL=paths.d.ts.map

package/engine/dist/config/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,eAAO,MAAM,YAAY,QAAsF,CAAC;AAChH,eAAO,MAAM,WAAW,QAA2F,CAAC;AACpH,eAAO,MAAM,UAAU,QAA+E,CAAC;AACvG,eAAO,MAAM,QAAQ,QAA2E,CAAC;AACjG,eAAO,MAAM,SAAS,QAAe,CAAC;AACtC,eAAO,MAAM,QAAQ,QAAkC,CAAC;AACxD,eAAO,MAAM,YAAY,QAA4D,CAAC;AAGtF,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;CAwBjB,CAAC;AAGF,eAAO,MACL,WAAW,UACX,kBAAkB,UAClB,cAAc,UACd,cAAc,UACd,mBAAmB,UACnB,oBAAoB,QACb,CAAC;AAEV,eAAe,KAAK,CAAC"}

package/engine/dist/config/paths.js

@@ -0,0 +1,49 @@
+/**
+ * Path Configuration for Sovereign Context Engine
+ *
+ * Defines all the important paths used by the system.
+ */
+import * as path from 'path';
+import * as os from 'os';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Define base paths
+// __dirname is engine/src/config, so we need to go up 3 levels to reach project root
+export const PROJECT_ROOT = path.resolve(process.env['PROJECT_ROOT'] || path.join(__dirname, '..', '..', '..'));
+export const CONTEXT_DIR = path.resolve(process.env['CONTEXT_DIR'] || path.join(PROJECT_ROOT, 'engine', 'context'));
+export const MODELS_DIR = path.resolve(process.env['MODELS_DIR'] || path.join(PROJECT_ROOT, 'models'));
+export const DIST_DIR = path.resolve(process.env['DIST_DIR'] || path.join(PROJECT_ROOT, 'dist'));
+export const BASE_PATH = PROJECT_ROOT;
+export const LOGS_DIR = path.join(PROJECT_ROOT, 'logs');
+export const NOTEBOOK_DIR = path.resolve(process.env['NOTEBOOK_DIR'] || PROJECT_ROOT);
+// Define specific paths
+export const PATHS = {
+    PROJECT_ROOT,
+    CONTEXT_DIR,
+    MODELS_DIR,
+    DIST_DIR,
+    BACKUPS_DIR: path.join(PROJECT_ROOT, 'backups'),
+    MIRRORED_BRAIN_DIR: path.join(PROJECT_ROOT, 'mirrored_brain'),
+    LOGS_DIR: path.join(PROJECT_ROOT, 'logs'),
+    CONFIG_FILE: path.join(PROJECT_ROOT, 'sovereign.yaml'),
+    USER_SETTINGS: path.join(PROJECT_ROOT, 'user_settings.json'),
+    DATABASE_FILE: path.join(CONTEXT_DIR, 'context.db'),
+    INBOX_DIR: path.join(PROJECT_ROOT, 'inbox'),
+    EXTERNAL_INBOX_DIR: path.join(PROJECT_ROOT, 'external-inbox'),
+    LIBRARIES_DIR: path.join(CONTEXT_DIR, 'libraries'),
+    MIRRORS_DIR: path.join(CONTEXT_DIR, 'mirrors'),
+    SESSIONS_DIR: path.join(CONTEXT_DIR, 'sessions'),
+    TEMP_DIR: path.join(os.tmpdir(), 'sovereign-context-engine'),
+    ENGINE_BIN: path.join(PROJECT_ROOT, 'engine', 'bin'),
+    ENGINE_SRC: path.join(PROJECT_ROOT, 'engine', 'src'),
+    ENGINE_DIST: path.join(PROJECT_ROOT, 'engine', 'dist'),
+    ENGINE_CONTEXT: path.join(PROJECT_ROOT, 'engine', 'context'),
+    ENGINE_PLUGINS: path.join(PROJECT_ROOT, 'engine', 'plugins'),
+    DESKTOP_OVERLAY_SRC: path.join(PROJECT_ROOT, 'packages', 'desktop-overlay', 'src'),
+    DESKTOP_OVERLAY_DIST: path.join(PROJECT_ROOT, 'packages', 'desktop-overlay', 'dist'),
+};
+// Export individual paths for convenience
+export const { BACKUPS_DIR, MIRRORED_BRAIN_DIR, ENGINE_CONTEXT, ENGINE_PLUGINS, DESKTOP_OVERLAY_SRC, DESKTOP_OVERLAY_DIST, } = PATHS;
+export default PATHS;
+//# sourceMappingURL=paths.js.map