chore: recovery checkpoint - v3.0 API successfully recovered

CRITICAL CHECKPOINT - DO NOT PUSH TO GITHUB

Recovery Status:
- Successfully recovered brainy.ts from compiled JavaScript
- All core v3.0 API methods functional (add, get, update, delete, relate, find, etc.)
- Neural subsystem intact (562KB embedded patterns, NLP working)
- Augmentation pipeline operational (20+ augmentations)
- HNSW clustering system complete
- Triple Intelligence compiled (needs constructor fix)
- Test suite validates functionality

Changes preserved:
- 898 files with changes from last 3 days
- 144,475 insertions
- All augmentation improvements
- All test coverage enhancements
- Complete v3.0 feature set

This is a LOCAL checkpoint only - contains recovered work after corruption incident.
Created backup in .backups/brainy-full-20250910-151314.tar.gz

Branch: recovery-checkpoint-20250910-151433
Date: Wed Sep 10 03:18:04 PM PDT 2025

.recovery-workspace/dist-backup-20250910-141917/utils/cacheAutoConfig.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Intelligent cache auto-configuration system
+ * Adapts cache settings based on environment, usage patterns, and storage type
+ */
+import { SearchCacheConfig } from './searchCache.js';
+import { BrainyConfig } from '../brainy.js';
+export interface CacheUsageStats {
+    totalQueries: number;
+    repeatQueries: number;
+    avgQueryTime: number;
+    memoryPressure: number;
+    storageType: 'memory' | 'opfs' | 's3' | 'filesystem';
+    isDistributed: boolean;
+    changeFrequency: number;
+    readWriteRatio: number;
+}
+export interface AutoConfigResult {
+    cacheConfig: SearchCacheConfig;
+    realtimeConfig: NonNullable<BrainyConfig['realtimeUpdates']>;
+    reasoning: string[];
+}
+export declare class CacheAutoConfigurator {
+    private stats;
+    private configHistory;
+    private lastOptimization;
+    /**
+     * Auto-detect optimal cache configuration based on current conditions
+     */
+    autoDetectOptimalConfig(storageConfig?: BrainyConfig['storage'], currentStats?: Partial<CacheUsageStats>): AutoConfigResult;
+    /**
+     * Dynamically adjust configuration based on runtime performance
+     */
+    adaptConfiguration(currentConfig: SearchCacheConfig, performanceMetrics: {
+        hitRate: number;
+        avgResponseTime: number;
+        memoryUsage: number;
+        externalChangesDetected: number;
+        timeSinceLastChange: number;
+    }): AutoConfigResult | null;
+    /**
+     * Get recommended configuration for specific use case
+     */
+    getRecommendedConfig(useCase: 'high-consistency' | 'balanced' | 'performance-first'): AutoConfigResult;
+    /**
+     * Learn from usage patterns and improve recommendations
+     */
+    learnFromUsage(usageData: {
+        queryPatterns: string[];
+        responseTime: number;
+        cacheHits: number;
+        totalQueries: number;
+        dataChanges: number;
+        timeWindow: number;
+    }): void;
+    private detectEnvironment;
+    private generateOptimalConfig;
+    private calculateRealtimeConfig;
+    private detectMemoryConstraints;
+    /**
+     * Get human-readable explanation of current configuration
+     */
+    getConfigExplanation(config: AutoConfigResult): string;
+}