@soulcraft/brainy 0.51.1 → 0.52.0

package/dist/augmentations/intelligentVerbScoring.js

@@ -0,0 +1,377 @@
+import { cosineDistance } from '../utils/distance.js';
+/**
+ * Default configuration for the Intelligent Verb Scoring augmentation
+ */
+export const DEFAULT_VERB_SCORING_CONFIG = {
+    enableSemanticScoring: true,
+    enableFrequencyAmplification: true,
+    enableTemporalDecay: true,
+    temporalDecayRate: 0.01, // 1% decay per day
+    minWeight: 0.1,
+    maxWeight: 1.0,
+    baseConfidence: 0.5,
+    learningRate: 0.1
+};
+/**
+ * Intelligent Verb Scoring Cognition Augmentation
+ *
+ * Automatically generates intelligent weight and confidence scores for verb relationships
+ * using semantic analysis, frequency patterns, and temporal factors.
+ */
+export class IntelligentVerbScoring {
+    constructor(config = {}) {
+        this.name = 'intelligent-verb-scoring';
+        this.description = 'Automatically generates intelligent weight and confidence scores for verb relationships';
+        this.enabled = false; // Off by default as requested
+        this.relationshipStats = new Map();
+        this.isInitialized = false;
+        this.config = { ...DEFAULT_VERB_SCORING_CONFIG, ...config };
+    }
+    async initialize() {
+        if (this.isInitialized)
+            return;
+        this.isInitialized = true;
+    }
+    async shutDown() {
+        this.relationshipStats.clear();
+        this.isInitialized = false;
+    }
+    async getStatus() {
+        return this.enabled && this.isInitialized ? 'active' : 'inactive';
+    }
+    /**
+     * Set reference to the BrainyData instance for accessing graph data
+     */
+    setBrainyInstance(instance) {
+        this.brainyInstance = instance;
+    }
+    /**
+     * Main reasoning method for generating intelligent verb scores
+     */
+    reason(query, context) {
+        if (!this.enabled) {
+            return {
+                success: false,
+                data: { inference: 'Augmentation is disabled', confidence: 0 },
+                error: 'Intelligent verb scoring is disabled'
+            };
+        }
+        return {
+            success: true,
+            data: {
+                inference: 'Intelligent verb scoring active',
+                confidence: 1.0
+            }
+        };
+    }
+    infer(dataSubset) {
+        return {
+            success: true,
+            data: dataSubset
+        };
+    }
+    executeLogic(ruleId, input) {
+        return {
+            success: true,
+            data: true
+        };
+    }
+    /**
+     * Generate intelligent weight and confidence scores for a verb relationship
+     *
+     * @param sourceId - ID of the source entity
+     * @param targetId - ID of the target entity
+     * @param verbType - Type of the relationship
+     * @param existingWeight - Existing weight if any
+     * @param metadata - Additional metadata about the relationship
+     * @returns Computed weight and confidence scores
+     */
+    async computeVerbScores(sourceId, targetId, verbType, existingWeight, metadata) {
+        if (!this.enabled || !this.brainyInstance) {
+            return {
+                weight: existingWeight ?? 0.5,
+                confidence: this.config.baseConfidence,
+                reasoning: ['Intelligent scoring disabled']
+            };
+        }
+        const reasoning = [];
+        let weight = existingWeight ?? 0.5;
+        let confidence = this.config.baseConfidence;
+        try {
+            // Get relationship key for statistics
+            const relationKey = `${sourceId}-${verbType}-${targetId}`;
+            // Update relationship statistics
+            this.updateRelationshipStats(relationKey, weight, metadata);
+            // Apply semantic scoring if enabled
+            if (this.config.enableSemanticScoring) {
+                const semanticScore = await this.calculateSemanticScore(sourceId, targetId);
+                if (semanticScore !== null) {
+                    weight = this.blendScores(weight, semanticScore, 0.3);
+                    confidence = Math.min(confidence + semanticScore * 0.2, 1.0);
+                    reasoning.push(`Semantic similarity: ${semanticScore.toFixed(3)}`);
+                }
+            }
+            // Apply frequency amplification if enabled
+            if (this.config.enableFrequencyAmplification) {
+                const frequencyBoost = this.calculateFrequencyBoost(relationKey);
+                weight = this.blendScores(weight, frequencyBoost, 0.2);
+                if (frequencyBoost > 0.5) {
+                    confidence = Math.min(confidence + 0.1, 1.0);
+                    reasoning.push(`Frequency boost: ${frequencyBoost.toFixed(3)}`);
+                }
+            }
+            // Apply temporal decay if enabled
+            if (this.config.enableTemporalDecay) {
+                const temporalFactor = this.calculateTemporalFactor(relationKey);
+                weight *= temporalFactor;
+                reasoning.push(`Temporal factor: ${temporalFactor.toFixed(3)}`);
+            }
+            // Apply learning adjustments
+            const learningAdjustment = this.calculateLearningAdjustment(relationKey);
+            weight = this.blendScores(weight, learningAdjustment, this.config.learningRate);
+            // Clamp values to configured bounds
+            weight = Math.max(this.config.minWeight, Math.min(this.config.maxWeight, weight));
+            confidence = Math.max(0, Math.min(1, confidence));
+            reasoning.push(`Final weight: ${weight.toFixed(3)}, confidence: ${confidence.toFixed(3)}`);
+            return { weight, confidence, reasoning };
+        }
+        catch (error) {
+            console.warn('Error computing verb scores:', error);
+            return {
+                weight: existingWeight ?? 0.5,
+                confidence: this.config.baseConfidence,
+                reasoning: [`Error in scoring: ${error}`]
+            };
+        }
+    }
+    /**
+     * Calculate semantic similarity between two entities using their embeddings
+     */
+    async calculateSemanticScore(sourceId, targetId) {
+        try {
+            if (!this.brainyInstance?.storage)
+                return null;
+            // Get noun embeddings from storage
+            const sourceNoun = await this.brainyInstance.storage.getNoun(sourceId);
+            const targetNoun = await this.brainyInstance.storage.getNoun(targetId);
+            if (!sourceNoun?.vector || !targetNoun?.vector)
+                return null;
+            // Calculate cosine similarity (1 - distance)
+            const distance = cosineDistance(sourceNoun.vector, targetNoun.vector);
+            return Math.max(0, 1 - distance);
+        }
+        catch (error) {
+            console.warn('Error calculating semantic score:', error);
+            return null;
+        }
+    }
+    /**
+     * Calculate frequency-based boost for repeated relationships
+     */
+    calculateFrequencyBoost(relationKey) {
+        const stats = this.relationshipStats.get(relationKey);
+        if (!stats || stats.count <= 1)
+            return 0.5;
+        // Logarithmic scaling: more occurrences = higher weight, but with diminishing returns
+        const boost = Math.log(stats.count + 1) / Math.log(10); // Log base 10
+        return Math.min(boost, 1.0);
+    }
+    /**
+     * Calculate temporal decay factor based on recency
+     */
+    calculateTemporalFactor(relationKey) {
+        const stats = this.relationshipStats.get(relationKey);
+        if (!stats)
+            return 1.0;
+        const daysSinceLastSeen = (Date.now() - stats.lastSeen.getTime()) / (1000 * 60 * 60 * 24);
+        const decayFactor = Math.exp(-this.config.temporalDecayRate * daysSinceLastSeen);
+        return Math.max(0.1, decayFactor); // Minimum 10% of original weight
+    }
+    /**
+     * Calculate learning-based adjustment using historical patterns
+     */
+    calculateLearningAdjustment(relationKey) {
+        const stats = this.relationshipStats.get(relationKey);
+        if (!stats || stats.count <= 1)
+            return 0.5;
+        // Use moving average of weights as learned baseline
+        return Math.max(0, Math.min(1, stats.averageWeight));
+    }
+    /**
+     * Update relationship statistics for learning
+     */
+    updateRelationshipStats(relationKey, weight, metadata) {
+        const now = new Date();
+        const existing = this.relationshipStats.get(relationKey);
+        if (existing) {
+            // Update existing stats
+            existing.count++;
+            existing.totalWeight += weight;
+            existing.averageWeight = existing.totalWeight / existing.count;
+            existing.lastSeen = now;
+        }
+        else {
+            // Create new stats entry
+            this.relationshipStats.set(relationKey, {
+                count: 1,
+                totalWeight: weight,
+                averageWeight: weight,
+                lastSeen: now,
+                firstSeen: now
+            });
+        }
+    }
+    /**
+     * Blend two scores using a weighted average
+     */
+    blendScores(score1, score2, weight2) {
+        const weight1 = 1 - weight2;
+        return score1 * weight1 + score2 * weight2;
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(newConfig) {
+        this.config = { ...this.config, ...newConfig };
+    }
+    /**
+     * Get relationship statistics (for debugging/monitoring)
+     */
+    getRelationshipStats() {
+        return new Map(this.relationshipStats);
+    }
+    /**
+     * Clear relationship statistics
+     */
+    clearStats() {
+        this.relationshipStats.clear();
+    }
+    /**
+     * Provide feedback to improve future scoring
+     * This allows the system to learn from user corrections or validation
+     *
+     * @param sourceId - Source entity ID
+     * @param targetId - Target entity ID
+     * @param verbType - Relationship type
+     * @param feedbackWeight - The corrected/validated weight (0-1)
+     * @param feedbackConfidence - The corrected/validated confidence (0-1)
+     * @param feedbackType - Type of feedback ('correction', 'validation', 'enhancement')
+     */
+    async provideFeedback(sourceId, targetId, verbType, feedbackWeight, feedbackConfidence, feedbackType = 'correction') {
+        if (!this.enabled)
+            return;
+        const relationKey = `${sourceId}-${verbType}-${targetId}`;
+        const existing = this.relationshipStats.get(relationKey);
+        if (existing) {
+            // Apply feedback with learning rate
+            const newWeight = existing.averageWeight * (1 - this.config.learningRate) +
+                feedbackWeight * this.config.learningRate;
+            // Update the running average with feedback
+            existing.totalWeight = (existing.totalWeight * existing.count + feedbackWeight) / (existing.count + 1);
+            existing.averageWeight = existing.totalWeight / existing.count;
+            existing.count += 1;
+            existing.lastSeen = new Date();
+            if (this.brainyInstance?.loggingConfig?.verbose) {
+                console.log(`Feedback applied for ${relationKey}: ${feedbackType}, ` +
+                    `old weight: ${existing.averageWeight.toFixed(3)}, ` +
+                    `feedback: ${feedbackWeight.toFixed(3)}, ` +
+                    `new weight: ${newWeight.toFixed(3)}`);
+            }
+        }
+        else {
+            // Create new entry with feedback as initial data
+            this.relationshipStats.set(relationKey, {
+                count: 1,
+                totalWeight: feedbackWeight,
+                averageWeight: feedbackWeight,
+                lastSeen: new Date(),
+                firstSeen: new Date()
+            });
+        }
+    }
+    /**
+     * Get learning statistics for monitoring and debugging
+     */
+    getLearningStats() {
+        const relationships = Array.from(this.relationshipStats.entries());
+        const totalRelationships = relationships.length;
+        const feedbackCount = relationships.reduce((sum, [, stats]) => sum + stats.count, 0);
+        // Calculate average confidence (approximated from weight patterns)
+        const averageWeight = relationships.reduce((sum, [, stats]) => sum + stats.averageWeight, 0) / totalRelationships || 0;
+        const averageConfidence = Math.min(averageWeight + 0.2, 1.0); // Heuristic: confidence typically higher than weight
+        // Get top relationships by count
+        const topRelationships = relationships
+            .map(([key, stats]) => ({
+            relationship: key,
+            count: stats.count,
+            averageWeight: stats.averageWeight
+        }))
+            .sort((a, b) => b.count - a.count)
+            .slice(0, 10);
+        return {
+            totalRelationships,
+            averageConfidence,
+            feedbackCount,
+            topRelationships
+        };
+    }
+    /**
+     * Export learning data for backup or analysis
+     */
+    exportLearningData() {
+        const data = {
+            config: this.config,
+            stats: Array.from(this.relationshipStats.entries()).map(([key, stats]) => ({
+                relationship: key,
+                ...stats,
+                firstSeen: stats.firstSeen.toISOString(),
+                lastSeen: stats.lastSeen.toISOString()
+            })),
+            exportedAt: new Date().toISOString(),
+            version: '1.0'
+        };
+        return JSON.stringify(data, null, 2);
+    }
+    /**
+     * Import learning data from backup
+     */
+    importLearningData(jsonData) {
+        try {
+            const data = JSON.parse(jsonData);
+            if (data.version !== '1.0') {
+                console.warn('Learning data version mismatch, importing anyway');
+            }
+            // Update configuration if provided
+            if (data.config) {
+                this.config = { ...this.config, ...data.config };
+            }
+            // Import relationship statistics
+            if (data.stats && Array.isArray(data.stats)) {
+                for (const stat of data.stats) {
+                    if (stat.relationship) {
+                        this.relationshipStats.set(stat.relationship, {
+                            count: stat.count || 1,
+                            totalWeight: stat.totalWeight || stat.averageWeight || 0.5,
+                            averageWeight: stat.averageWeight || 0.5,
+                            firstSeen: new Date(stat.firstSeen || Date.now()),
+                            lastSeen: new Date(stat.lastSeen || Date.now()),
+                            semanticSimilarity: stat.semanticSimilarity
+                        });
+                    }
+                }
+            }
+            console.log(`Imported learning data: ${this.relationshipStats.size} relationships`);
+        }
+        catch (error) {
+            console.error('Failed to import learning data:', error);
+            throw new Error(`Failed to import learning data: ${error}`);
+        }
+    }
+}
+//# sourceMappingURL=intelligentVerbScoring.js.map

package/dist/augmentations/intelligentVerbScoring.js.map

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

package/dist/brainyData.d.ts

@@ -288,6 +288,58 @@ export interface BrainyDataConfig {
             prefetchStrategy?: 'conservative' | 'moderate' | 'aggressive';
         };
     };
+    /**
+     * Intelligent verb scoring configuration
+     * Automatically generates weight and confidence scores for verb relationships
+     * Off by default - enable by setting enabled: true
+     */
+    intelligentVerbScoring?: {
+        /**
+         * Whether to enable intelligent verb scoring
+         * Default: false (off by default)
+         */
+        enabled?: boolean;
+        /**
+         * Enable semantic proximity scoring based on entity embeddings
+         * Default: true
+         */
+        enableSemanticScoring?: boolean;
+        /**
+         * Enable frequency-based weight amplification
+         * Default: true
+         */
+        enableFrequencyAmplification?: boolean;
+        /**
+         * Enable temporal decay for weights
+         * Default: true
+         */
+        enableTemporalDecay?: boolean;
+        /**
+         * Decay rate per day for temporal scoring (0-1)
+         * Default: 0.01 (1% decay per day)
+         */
+        temporalDecayRate?: number;
+        /**
+         * Minimum weight threshold
+         * Default: 0.1
+         */
+        minWeight?: number;
+        /**
+         * Maximum weight threshold
+         * Default: 1.0
+         */
+        maxWeight?: number;
+        /**
+         * Base confidence score for new relationships
+         * Default: 0.5
+         */
+        baseConfidence?: number;
+        /**
+         * Learning rate for adaptive scoring (0-1)
+         * Default: 0.1
+         */
+        learningRate?: number;
+    };
 }
 export declare class BrainyData<T = any> implements BrainyDataInterface<T> {
     index: HNSWIndex | HNSWIndexOptimized;
@@ -321,6 +373,7 @@ export declare class BrainyData<T = any> implements BrainyDataInterface<T> {
     private remoteServerConfig;
     private serverSearchConduit;
     private serverConnection;
+    private intelligentVerbScoring;
     private distributedConfig;
     private configManager;
     private partitioner;
@@ -406,6 +459,30 @@ export declare class BrainyData<T = any> implements BrainyDataInterface<T> {
      * Apply changes using full scan method (fallback for storage adapters without change log support)
      */
     private applyChangesFromFullScan;
+    /**
+     * Provide feedback to the intelligent verb scoring system for learning
+     * This allows the system to learn from user corrections or validation
+     *
+     * @param sourceId - Source entity ID
+     * @param targetId - Target entity ID
+     * @param verbType - Relationship type
+     * @param feedbackWeight - The corrected/validated weight (0-1)
+     * @param feedbackConfidence - The corrected/validated confidence (0-1)
+     * @param feedbackType - Type of feedback ('correction', 'validation', 'enhancement')
+     */
+    provideFeedbackForVerbScoring(sourceId: string, targetId: string, verbType: string, feedbackWeight: number, feedbackConfidence?: number, feedbackType?: 'correction' | 'validation' | 'enhancement'): Promise<void>;
+    /**
+     * Get learning statistics from the intelligent verb scoring system
+     */
+    getVerbScoringStats(): any;
+    /**
+     * Export learning data from the intelligent verb scoring system
+     */
+    exportVerbScoringLearningData(): string | null;
+    /**
+     * Import learning data into the intelligent verb scoring system
+     */
+    importVerbScoringLearningData(jsonData: string): void;
     /**
      * Get the current augmentation name if available
      * This is used to auto-detect the service performing data operations

package/dist/brainyData.js

@@ -12,6 +12,7 @@ import { matchesMetadataFilter } from './utils/metadataFilter.js';
 import { MetadataIndexManager } from './utils/metadataIndex.js';
 import { NounType, VerbType } from './types/graphTypes.js';
 import { createServerSearchAugmentations } from './augmentations/serverSearchAugmentations.js';
+import { IntelligentVerbScoring } from './augmentations/intelligentVerbScoring.js';
 import { augmentationPipeline } from './augmentationPipeline.js';
 import { prepareJsonForVectorization, extractFieldFromJson } from './utils/jsonProcessing.js';
 import { DistributedConfigManager, HashPartitioner, OperationalModeFactory, DomainDetector, HealthMonitor } from './distributed/index.js';
@@ -69,6 +70,7 @@ export class BrainyData {
         this.remoteServerConfig = null;
         this.serverSearchConduit = null;
         this.serverConnection = null;
+        this.intelligentVerbScoring = null;
         // Distributed mode properties
         this.distributedConfig = null;
         this.configManager = null;
@@ -198,6 +200,11 @@ export class BrainyData {
         }
         // Initialize search cache with final configuration
         this.searchCache = new SearchCache(finalSearchCacheConfig);
+        // Initialize intelligent verb scoring if enabled
+        if (config.intelligentVerbScoring?.enabled) {
+            this.intelligentVerbScoring = new IntelligentVerbScoring(config.intelligentVerbScoring);
+            this.intelligentVerbScoring.enabled = true;
+        }
     }
     /**
      * Check if the database is in read-only mode and throw an error if it is
@@ -542,6 +549,48 @@ export class BrainyData {
             throw error;
         }
     }
+    /**
+     * Provide feedback to the intelligent verb scoring system for learning
+     * This allows the system to learn from user corrections or validation
+     *
+     * @param sourceId - Source entity ID
+     * @param targetId - Target entity ID
+     * @param verbType - Relationship type
+     * @param feedbackWeight - The corrected/validated weight (0-1)
+     * @param feedbackConfidence - The corrected/validated confidence (0-1)
+     * @param feedbackType - Type of feedback ('correction', 'validation', 'enhancement')
+     */
+    async provideFeedbackForVerbScoring(sourceId, targetId, verbType, feedbackWeight, feedbackConfidence, feedbackType = 'correction') {
+        if (this.intelligentVerbScoring?.enabled) {
+            await this.intelligentVerbScoring.provideFeedback(sourceId, targetId, verbType, feedbackWeight, feedbackConfidence, feedbackType);
+        }
+    }
+    /**
+     * Get learning statistics from the intelligent verb scoring system
+     */
+    getVerbScoringStats() {
+        if (this.intelligentVerbScoring?.enabled) {
+            return this.intelligentVerbScoring.getLearningStats();
+        }
+        return null;
+    }
+    /**
+     * Export learning data from the intelligent verb scoring system
+     */
+    exportVerbScoringLearningData() {
+        if (this.intelligentVerbScoring?.enabled) {
+            return this.intelligentVerbScoring.exportLearningData();
+        }
+        return null;
+    }
+    /**
+     * Import learning data into the intelligent verb scoring system
+     */
+    importVerbScoringLearningData(jsonData) {
+        if (this.intelligentVerbScoring?.enabled) {
+            this.intelligentVerbScoring.importLearningData(jsonData);
+        }
+    }
     /**
      * Get the current augmentation name if available
      * This is used to auto-detect the service performing data operations
@@ -765,6 +814,13 @@ export class BrainyData {
                     }
                 }
             }
+            // Initialize intelligent verb scoring augmentation if enabled
+            if (this.intelligentVerbScoring) {
+                await this.intelligentVerbScoring.initialize();
+                this.intelligentVerbScoring.setBrainyInstance(this);
+                // Register with augmentation pipeline
+                augmentationPipeline.register(this.intelligentVerbScoring);
+            }
             this.isInitialized = true;
             this.isInitializing = false;
             // Start real-time updates if enabled
@@ -2540,6 +2596,28 @@ export class BrainyData {
                 vector: verbVector,
                 connections: new Map()
             };
+            // Apply intelligent verb scoring if enabled and weight/confidence not provided
+            let finalWeight = options.weight;
+            let finalConfidence;
+            let scoringReasoning = [];
+            if (this.intelligentVerbScoring?.enabled && (!options.weight || options.weight === 0.5)) {
+                try {
+                    const scores = await this.intelligentVerbScoring.computeVerbScores(sourceId, targetId, verbType, options.weight, options.metadata);
+                    finalWeight = scores.weight;
+                    finalConfidence = scores.confidence;
+                    scoringReasoning = scores.reasoning;
+                    if (this.loggingConfig?.verbose && scoringReasoning.length > 0) {
+                        console.log(`Intelligent verb scoring for ${sourceId}-${verbType}-${targetId}:`, scoringReasoning);
+                    }
+                }
+                catch (error) {
+                    if (this.loggingConfig?.verbose) {
+                        console.warn('Error in intelligent verb scoring:', error);
+                    }
+                    // Fall back to original weight
+                    finalWeight = options.weight;
+                }
+            }
             // Create complete verb metadata separately
             const verbMetadata = {
                 sourceId: sourceId,
@@ -2548,7 +2626,12 @@ export class BrainyData {
                 target: targetId,
                 verb: verbType,
                 type: verbType, // Set the type property to match the verb type
-                weight: options.weight,
+                weight: finalWeight,
+                confidence: finalConfidence, // Add confidence to metadata
+                intelligentScoring: scoringReasoning.length > 0 ? {
+                    reasoning: scoringReasoning,
+                    computedAt: new Date().toISOString()
+                } : undefined,
                 createdAt: timestamp,
                 updatedAt: timestamp,
                 createdBy: getAugmentationVersion(service),