@soulcraft/brainy 4.0.2 → 4.1.0

package/dist/augmentations/KnowledgeAugmentation.js

@@ -1,251 +0,0 @@
-/**
- * Knowledge Layer Augmentation for VFS
- *
- * Adds intelligent features to VFS without modifying core functionality:
- * - Event recording for all operations
- * - Semantic versioning based on content changes
- * - Entity and concept extraction
- * - Git bridge for import/export
- *
- * This is a TRUE augmentation - VFS works perfectly without it
- */
-import { BaseAugmentation } from './brainyAugmentation.js';
-import { EventRecorder } from '../vfs/EventRecorder.js';
-import { SemanticVersioning } from '../vfs/SemanticVersioning.js';
-import { PersistentEntitySystem } from '../vfs/PersistentEntitySystem.js';
-import { ConceptSystem } from '../vfs/ConceptSystem.js';
-import { GitBridge } from '../vfs/GitBridge.js';
-export class KnowledgeAugmentation extends BaseAugmentation {
-    constructor(config = {}) {
-        super(config);
-        this.name = 'knowledge';
-        this.timing = 'after'; // Process after VFS operations
-        this.metadata = 'none'; // No metadata access needed
-        this.operations = []; // VFS-specific augmentation, no operation interception
-        this.priority = 100; // Run last
-        this.originalMethods = new Map();
-    }
-    async execute(operation, params, next) {
-        // Pass through - this augmentation works at VFS level, not operation level
-        return await next();
-    }
-    async initialize(context) {
-        await this.augment(context.brain);
-    }
-    async augment(brain) {
-        // Only augment if VFS exists
-        const vfs = brain.vfs?.();
-        if (!vfs) {
-            console.warn('KnowledgeAugmentation: VFS not found, skipping');
-            return;
-        }
-        // Initialize Knowledge Layer components
-        this.eventRecorder = new EventRecorder(brain);
-        this.semanticVersioning = new SemanticVersioning(brain);
-        this.entitySystem = new PersistentEntitySystem(brain);
-        this.conceptSystem = new ConceptSystem(brain);
-        this.gitBridge = new GitBridge(vfs, brain);
-        // Wrap VFS methods to add intelligence WITHOUT slowing them down
-        this.wrapMethod(vfs, 'writeFile', async (original, path, data, options) => {
-            // Call original first (stays fast)
-            const result = await original.call(vfs, path, data, options);
-            // Knowledge processing in background (non-blocking)
-            setImmediate(async () => {
-                try {
-                    // Record event
-                    if (this.eventRecorder) {
-                        await this.eventRecorder.recordEvent({
-                            type: 'write',
-                            path,
-                            content: data,
-                            size: data.length,
-                            author: options?.author || 'system'
-                        });
-                    }
-                    // Check for semantic versioning
-                    if (this.semanticVersioning) {
-                        const existingContent = await vfs.readFile(path).catch(() => null);
-                        const shouldVersion = existingContent && this.isSemanticChange(existingContent, data);
-                        if (shouldVersion) {
-                            await this.semanticVersioning.createVersion(path, data, {
-                                message: 'Automatic semantic version'
-                            });
-                        }
-                    }
-                    // Extract concepts
-                    if (this.conceptSystem && options?.extractConcepts !== false) {
-                        await this.conceptSystem.extractAndLinkConcepts(path, data);
-                    }
-                    // Extract entities
-                    if (this.entitySystem && options?.extractEntities !== false) {
-                        await this.entitySystem.extractEntities(data.toString('utf8'), data);
-                    }
-                }
-                catch (error) {
-                    // Knowledge Layer errors should not affect VFS operations
-                    console.debug('KnowledgeLayer background processing error:', error);
-                }
-            });
-            return result;
-        });
-        this.wrapMethod(vfs, 'unlink', async (original, path) => {
-            const result = await original.call(vfs, path);
-            // Record deletion event
-            setImmediate(async () => {
-                if (this.eventRecorder) {
-                    await this.eventRecorder.recordEvent({
-                        type: 'delete',
-                        path,
-                        author: 'system'
-                    });
-                }
-            });
-            return result;
-        });
-        this.wrapMethod(vfs, 'rename', async (original, oldPath, newPath) => {
-            const result = await original.call(vfs, oldPath, newPath);
-            // Record rename event
-            setImmediate(async () => {
-                if (this.eventRecorder) {
-                    await this.eventRecorder.recordEvent({
-                        type: 'rename',
-                        path: oldPath,
-                        metadata: { newPath },
-                        author: 'system'
-                    });
-                }
-            });
-            return result;
-        });
-        // Add Knowledge Layer methods to VFS
-        this.addKnowledgeMethods(vfs);
-        console.log('✨ Knowledge Layer augmentation enabled');
-    }
-    /**
-     * Wrap a VFS method to add Knowledge Layer functionality
-     */
-    wrapMethod(vfs, methodName, wrapper) {
-        const original = vfs[methodName];
-        if (!original)
-            return;
-        // Store original for cleanup
-        this.originalMethods.set(methodName, original);
-        // Replace with wrapped version
-        vfs[methodName] = async (...args) => {
-            return await wrapper(original, ...args);
-        };
-    }
-    /**
-     * Add Knowledge Layer methods to VFS
-     */
-    addKnowledgeMethods(vfs) {
-        // Event history
-        vfs.getHistory = async (path, options) => {
-            if (!this.eventRecorder)
-                throw new Error('Knowledge Layer not initialized');
-            return await this.eventRecorder.getHistory(path, options);
-        };
-        vfs.reconstructAtTime = async (path, timestamp) => {
-            if (!this.eventRecorder)
-                throw new Error('Knowledge Layer not initialized');
-            return await this.eventRecorder.reconstructFileAtTime(path, timestamp);
-        };
-        // Semantic versioning
-        vfs.getVersions = async (path) => {
-            if (!this.semanticVersioning)
-                throw new Error('Knowledge Layer not initialized');
-            return await this.semanticVersioning.getVersions(path);
-        };
-        vfs.restoreVersion = async (path, versionId) => {
-            if (!this.semanticVersioning)
-                throw new Error('Knowledge Layer not initialized');
-            const version = await this.semanticVersioning.getVersion(path, versionId);
-            if (version) {
-                await vfs.writeFile(path, version);
-            }
-        };
-        // Entities
-        vfs.findEntity = async (query) => {
-            if (!this.entitySystem)
-                throw new Error('Knowledge Layer not initialized');
-            return await this.entitySystem.findEntity(query);
-        };
-        vfs.getEntityAppearances = async (entityId) => {
-            if (!this.entitySystem)
-                throw new Error('Knowledge Layer not initialized');
-            return await this.entitySystem.getEvolution(entityId);
-        };
-        // Concepts
-        vfs.getConcepts = async (path) => {
-            if (!this.conceptSystem)
-                throw new Error('Knowledge Layer not initialized');
-            const concepts = await this.conceptSystem.findConcepts({ manifestedIn: path });
-            return concepts;
-        };
-        vfs.getConceptGraph = async (options) => {
-            if (!this.conceptSystem)
-                throw new Error('Knowledge Layer not initialized');
-            return await this.conceptSystem.getConceptGraph(options);
-        };
-        // Git bridge
-        vfs.exportToGit = async (vfsPath, gitPath) => {
-            if (!this.gitBridge)
-                throw new Error('Knowledge Layer not initialized');
-            return await this.gitBridge.exportToGit(vfsPath, gitPath);
-        };
-        vfs.importFromGit = async (gitPath, vfsPath) => {
-            if (!this.gitBridge)
-                throw new Error('Knowledge Layer not initialized');
-            return await this.gitBridge.importFromGit(gitPath, vfsPath);
-        };
-        // Temporal coupling
-        vfs.findTemporalCoupling = async (path, windowMs) => {
-            if (!this.eventRecorder)
-                throw new Error('Knowledge Layer not initialized');
-            return await this.eventRecorder.findTemporalCoupling(path, windowMs);
-        };
-    }
-    isSemanticChange(oldContent, newContent) {
-        // Simple heuristic - significant size change or different content
-        const oldStr = oldContent.toString('utf8');
-        const newStr = newContent.toString('utf8');
-        // Check for significant size change (>10%)
-        const sizeDiff = Math.abs(oldStr.length - newStr.length) / oldStr.length;
-        if (sizeDiff > 0.1)
-            return true;
-        // Check for structural changes (simplified)
-        const oldLines = oldStr.split('\n').filter(l => l.trim());
-        const newLines = newStr.split('\n').filter(l => l.trim());
-        // Different number of non-empty lines
-        return Math.abs(oldLines.length - newLines.length) > 5;
-    }
-    async cleanup(brain) {
-        const vfs = brain.vfs?.();
-        if (!vfs)
-            return;
-        // Restore original methods
-        for (const [methodName, original] of this.originalMethods) {
-            vfs[methodName] = original;
-        }
-        // Remove added methods
-        delete vfs.getHistory;
-        delete vfs.reconstructAtTime;
-        delete vfs.getVersions;
-        delete vfs.restoreVersion;
-        delete vfs.findEntity;
-        delete vfs.getEntityAppearances;
-        delete vfs.getConcepts;
-        delete vfs.getConceptGraph;
-        delete vfs.exportToGit;
-        delete vfs.importFromGit;
-        delete vfs.findTemporalCoupling;
-        // Clean up components
-        this.eventRecorder = undefined;
-        this.semanticVersioning = undefined;
-        this.entitySystem = undefined;
-        this.conceptSystem = undefined;
-        this.gitBridge = undefined;
-        console.log('Knowledge Layer augmentation removed');
-    }
-}
-//# sourceMappingURL=KnowledgeAugmentation.js.map

package/dist/query/typeInference.d.ts

@@ -1,158 +0,0 @@
-/**
- * Type Inference System - Phase 3: Type-First Query Optimization
- *
- * Automatically infers NounTypes from natural language queries using keyword-based
- * heuristics for fast O(1) type detection.
- *
- * Performance Guarantee: < 1ms per query
- * Accuracy Target: > 80%
- *
- * Examples:
- * - "Find engineers in San Francisco" → [Person, Location]
- * - "Show documents about AI" → [Document, Concept]
- * - "List companies in tech sector" → [Organization, Topic]
- */
-import { NounType } from '../types/graphTypes.js';
-/**
- * Result of type inference with confidence score
- */
-export interface TypeInference {
-    type: NounType;
-    confidence: number;
-    matchedKeywords: string[];
-}
-/**
- * Configuration for type inference behavior
- */
-export interface TypeInferenceConfig {
-    /**
-     * Minimum confidence threshold to include a type (default: 0.4)
-     */
-    minConfidence?: number;
-    /**
-     * Maximum number of types to return (default: 5)
-     */
-    maxTypes?: number;
-    /**
-     * Enable debug logging (default: false)
-     */
-    debug?: boolean;
-    /**
-     * Enable vector similarity fallback for unknown words (default: false)
-     * When enabled, queries with low keyword confidence trigger vector-based type inference
-     */
-    enableVectorFallback?: boolean;
-    /**
-     * Minimum confidence threshold to trigger vector fallback (default: 0.7)
-     * If keyword matching produces confidence below this, vector fallback is used
-     */
-    fallbackConfidenceThreshold?: number;
-    /**
-     * Minimum similarity score for vector-based type matches (default: 0.5)
-     */
-    vectorThreshold?: number;
-}
-/**
- * Type Inference System
- *
- * Uses keyword matching for fast type detection from natural language.
- * Designed for billion-scale performance with minimal latency.
- */
-export declare class TypeInferenceSystem {
-    private keywordMap;
-    private phraseMap;
-    private config;
-    private typeEmbeddings;
-    private embedder;
-    constructor(config?: TypeInferenceConfig);
-    /**
-     * Infer noun types from a natural language query (synchronous keyword matching only)
-     * For hybrid mode with vector fallback, use inferTypesAsync()
-     *
-     * @param query - Natural language query string
-     * @returns Array of type inferences sorted by confidence (highest first)
-     */
-    inferTypes(query: string): TypeInference[];
-    /**
-     * Infer noun types with hybrid approach: keyword matching + optional vector fallback
-     * This is the async version that supports vector similarity fallback
-     *
-     * @param query - Natural language query string
-     * @returns Promise resolving to array of type inferences
-     */
-    inferTypesAsync(query: string): Promise<TypeInference[]>;
-    /**
-     * Internal: Keyword-based type inference (synchronous, fast)
-     */
-    private inferTypesViaKeywords;
-    /**
-     * Internal: Hybrid inference with vector fallback (asynchronous)
-     */
-    private inferTypesWithFallback;
-    /**
-     * Match multi-word phrases in query
-     */
-    private matchPhrases;
-    /**
-     * Match individual keywords in query
-     */
-    private matchKeywords;
-    /**
-     * Find closest keyword using edit distance (for typo correction)
-     * Allows edit distance 1-2 depending on word length
-     */
-    private findFuzzyKeywordMatch;
-    /**
-     * Calculate Levenshtein (edit) distance between two strings
-     */
-    private levenshteinDistance;
-    /**
-     * Update type score with new match
-     */
-    private updateTypeScore;
-    /**
-     * Load pre-compiled type embeddings from embeddedTypeEmbeddings.ts
-     */
-    private loadTypeEmbeddings;
-    /**
-     * Lazy-load TransformerEmbedding model (only when vector fallback is triggered)
-     */
-    private loadEmbedder;
-    /**
-     * Calculate cosine similarity between two vectors
-     */
-    private cosineSimilarity;
-    /**
-     * Infer types using vector similarity against pre-compiled type embeddings
-     */
-    private inferTypesViaVectorSimilarity;
-    /**
-     * Merge keyword-based and vector-based results
-     * Prioritizes keyword results (explicit matches) over vector results (semantic matches)
-     */
-    private mergeResults;
-    /**
-     * Build keyword dictionary for single-word matching
-     */
-    private buildKeywordMap;
-    /**
-     * Build phrase dictionary for multi-word matching
-     */
-    private buildPhraseMap;
-    /**
-     * Get statistics about the inference system
-     */
-    getStats(): {
-        keywordCount: number;
-        phraseCount: number;
-        config: Required<TypeInferenceConfig>;
-    };
-}
-/**
- * Get or create the global TypeInferenceSystem instance
- */
-export declare function getTypeInferenceSystem(config?: TypeInferenceConfig): TypeInferenceSystem;
-/**
- * Convenience function to infer types from a query
- */
-export declare function inferTypes(query: string, config?: TypeInferenceConfig): TypeInference[];