@soulcraft/brainy 0.56.0 → 0.57.0

package/README.md

@@ -63,7 +63,7 @@ Throughput:                        10K+ queries/second
 - **Zero config** - no setup files, no tuning parameters
 
 ### 🧠 Built-in AI Intelligence (FREE)
-- **Neural Import**: AI understands your data structure automatically
+- **Cortex Augmentation**: AI understands your data structure automatically
 - **Entity Detection**: Identifies people, companies, locations
 - **Relationship Mapping**: Discovers connections between entities
 - **Chat Interface**: Talk to your data naturally (v0.56+)
@@ -145,23 +145,23 @@ const custom = new BrainyData({
 
 </details>
 
-## 🎮 Cortex CLI - Command Center for Everything
+## 🎮 Brainy CLI - Command Center for Everything
 
 ```bash
 # Talk to your data
-cortex chat "What patterns do you see?"
+brainy chat "What patterns do you see?"
 
 # AI-powered data import
-cortex neural import data.csv --confidence 0.8
+brainy import data.csv --cortex --confidence 0.8
 
 # Real-time monitoring
-cortex monitor --dashboard
+brainy monitor --dashboard
 
 # Start premium trials
-cortex license trial notion
+brainy license trial notion
 ```
 
-[📖 **Full Cortex Documentation**](/docs/cortex.md)
+[📖 **Full CLI Documentation**](/docs/brainy-cli.md)
 
 ## ⚙️ Configuration (Optional)
 
@@ -193,7 +193,7 @@ Brainy works with **zero configuration**, but you can customize
 - **Asana** ($44/mo) - Project management
 
 ```bash
-cortex license trial notion  # Start free trial
+brainy license trial notion  # Start free trial
 ```
 
 **No vendor lock-in. Your data stays yours.**
@@ -306,7 +306,7 @@ Deploy anywhere: AWS, GCP, Azure, Cloudflare
 - [Quick Start](docs/getting-started/)
 - [API Reference](docs/api-reference/)
 - [Examples](docs/examples/)
-- [Cortex CLI](docs/cortex.md)
+- [Brainy CLI](docs/brainy-cli.md)
 - [Performance Guide](docs/optimization-guides/)
 
 ## ❓ Does Brainy Impact Performance?

package/bin/{cortex.js → brainy.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * Cortex CLI - Beautiful command center for Brainy
+ * Brainy CLI - Beautiful command center for the vector + graph database
  */
 
 // @ts-ignore

package/dist/augmentations/cortexSense.d.ts

@@ -0,0 +1,196 @@
+/**
+ * Cortex SENSE Augmentation - Atomic Age AI-Powered Data Understanding
+ *
+ * 🧠 The cerebral cortex layer for intelligent data processing
+ * ⚛️ Complete with confidence scoring and relationship weight calculation
+ */
+import { ISenseAugmentation, AugmentationResponse } from '../types/augmentations.js';
+import { BrainyData } from '../brainyData.js';
+export interface CortexAnalysisResult {
+    detectedEntities: DetectedEntity[];
+    detectedRelationships: DetectedRelationship[];
+    confidence: number;
+    insights: CortexInsight[];
+}
+export interface DetectedEntity {
+    originalData: any;
+    nounType: string;
+    confidence: number;
+    suggestedId: string;
+    reasoning: string;
+    alternativeTypes: Array<{
+        type: string;
+        confidence: number;
+    }>;
+}
+export interface DetectedRelationship {
+    sourceId: string;
+    targetId: string;
+    verbType: string;
+    confidence: number;
+    weight: number;
+    reasoning: string;
+    context: string;
+    metadata?: Record<string, any>;
+}
+export interface CortexInsight {
+    type: 'hierarchy' | 'cluster' | 'pattern' | 'anomaly' | 'opportunity';
+    description: string;
+    confidence: number;
+    affectedEntities: string[];
+    recommendation?: string;
+}
+export interface CortexSenseConfig {
+    confidenceThreshold: number;
+    enableWeights: boolean;
+    skipDuplicates: boolean;
+    categoryFilter?: string[];
+}
+/**
+ * Neural Import SENSE Augmentation - The Brain's Perceptual System
+ */
+export declare class CortexSenseAugmentation implements ISenseAugmentation {
+    readonly name: string;
+    readonly description: string;
+    enabled: boolean;
+    private brainy;
+    private config;
+    constructor(brainy: BrainyData, config?: Partial<CortexSenseConfig>);
+    initialize(): Promise<void>;
+    shutDown(): Promise<void>;
+    getStatus(): Promise<'active' | 'inactive' | 'error'>;
+    /**
+     * Process raw data into structured nouns and verbs using neural analysis
+     */
+    processRawData(rawData: Buffer | string, dataType: string, options?: Record<string, unknown>): Promise<AugmentationResponse<{
+        nouns: string[];
+        verbs: string[];
+        confidence?: number;
+        insights?: Array<{
+            type: string;
+            description: string;
+            confidence: number;
+        }>;
+        metadata?: Record<string, unknown>;
+    }>>;
+    /**
+     * Listen to real-time data feeds and process them
+     */
+    listenToFeed(feedUrl: string, callback: (data: {
+        nouns: string[];
+        verbs: string[];
+        confidence?: number;
+    }) => void): Promise<void>;
+    /**
+     * Analyze data structure without processing (preview mode)
+     */
+    analyzeStructure(rawData: Buffer | string, dataType: string, options?: Record<string, unknown>): Promise<AugmentationResponse<{
+        entityTypes: Array<{
+            type: string;
+            count: number;
+            confidence: number;
+        }>;
+        relationshipTypes: Array<{
+            type: string;
+            count: number;
+            confidence: number;
+        }>;
+        dataQuality: {
+            completeness: number;
+            consistency: number;
+            accuracy: number;
+        };
+        recommendations: string[];
+    }>>;
+    /**
+     * Validate data compatibility with current knowledge base
+     */
+    validateCompatibility(rawData: Buffer | string, dataType: string): Promise<AugmentationResponse<{
+        compatible: boolean;
+        issues: Array<{
+            type: string;
+            description: string;
+            severity: 'low' | 'medium' | 'high';
+        }>;
+        suggestions: string[];
+    }>>;
+    /**
+     * Get the full neural analysis result (custom method for Cortex integration)
+     */
+    getNeuralAnalysis(rawData: Buffer | string, dataType: string): Promise<CortexAnalysisResult>;
+    /**
+     * Parse raw data based on type
+     */
+    private parseRawData;
+    /**
+     * Basic CSV parser
+     */
+    private parseCSV;
+    /**
+     * Perform neural analysis on parsed data
+     */
+    private performNeuralAnalysis;
+    /**
+     * Neural Entity Detection - The Core AI Engine
+     */
+    private detectEntitiesWithNeuralAnalysis;
+    /**
+     * Calculate entity type confidence using AI
+     */
+    private calculateEntityTypeConfidence;
+    /**
+     * Field-based confidence calculation
+     */
+    private calculateFieldBasedConfidence;
+    /**
+     * Pattern-based confidence calculation
+     */
+    private calculatePatternBasedConfidence;
+    /**
+     * Generate reasoning for entity type selection
+     */
+    private generateEntityReasoning;
+    /**
+     * Neural Relationship Detection
+     */
+    private detectRelationshipsWithNeuralAnalysis;
+    /**
+     * Calculate relationship confidence
+     */
+    private calculateRelationshipConfidence;
+    /**
+     * Calculate relationship weight/strength
+     */
+    private calculateRelationshipWeight;
+    /**
+     * Generate Neural Insights - The Intelligence Layer
+     */
+    private generateCortexInsights;
+    /**
+     * Helper methods for the neural system
+     */
+    private extractMainText;
+    private generateSmartId;
+    private extractRelationshipContext;
+    private calculateTypeCompatibility;
+    private getVerbSpecificity;
+    private getRelevantFields;
+    private getMatchedPatterns;
+    private pruneRelationships;
+    private detectHierarchies;
+    private detectClusters;
+    private detectPatterns;
+    private calculateOverallConfidence;
+    private storeNeuralAnalysis;
+    private getDataTypeFromPath;
+    private generateRelationshipReasoning;
+    private extractRelationshipMetadata;
+    /**
+     * Assess data quality metrics
+     */
+    private assessDataQuality;
+    /**
+     * Generate recommendations based on analysis
+     */
+    private generateRecommendations;
+}