@soulcraft/brainy 3.2.0 → 3.3.1

package/README.md

@@ -315,10 +315,10 @@ const results = await brain.find({
 
 ```javascript
 // Create entities (nouns)
-const id = await brain.addNoun(data, nounType, metadata)
+const id = await brain.add(data, { nounType: nounType, ...metadata })
 
 // Create relationships (verbs)
-const verbId = await brain.addVerb(sourceId, targetId, "relationType", {
+const verbId = await brain.relate(sourceId, targetId, "relationType", {
     strength: 0.9,
     bidirectional: false
 })
@@ -377,7 +377,8 @@ const ingestionNode = new Brainy({
 
 // Process Bluesky firehose
 blueskyStream.on('post', async (post) => {
-    await ingestionNode.addNoun(post, 'social-post', {
+    await ingestionNode.add(post, {
+        nounType: 'social-post',
         platform: 'bluesky',
         author: post.author,
         timestamp: post.createdAt
@@ -415,27 +416,30 @@ const trending = await searchNode.find('trending AI topics', {
 
 ```javascript
 // Store documentation with rich relationships
-const apiGuide = await brain.addNoun("REST API Guide", 'document', {
+const apiGuide = await brain.add("REST API Guide", {
+    nounType: 'document',
     title: "API Guide",
     category: "documentation",
     version: "2.0"
 })
 
-const author = await brain.addNoun("Jane Developer", 'person', {
+const author = await brain.add("Jane Developer", {
+    nounType: 'person',
     type: "person",
     role: "tech-lead"
 })
 
-const project = await brain.addNoun("E-commerce Platform", 'project', {
+const project = await brain.add("E-commerce Platform", {
+    nounType: 'project',
     type: "project",
     status: "active"
 })
 
 // Create knowledge graph
-await brain.addVerb(author, apiGuide, "authored", {
+await brain.relate(author, apiGuide, "authored", {
     date: "2024-03-15"
 })
-await brain.addVerb(apiGuide, project, "documents", {
+await brain.relate(apiGuide, project, "documents", {
     coverage: "complete"
 })
 
@@ -457,25 +461,28 @@ const similar = await brain.search(existingContent, {
 
 ```javascript
 // Store conversation with relationships
-const userId = await brain.addNoun("User 123", 'user', {
+const userId = await brain.add("User 123", {
+    nounType: 'user',
     type: "user",
     tier: "premium"
 })
 
-const messageId = await brain.addNoun(userMessage, 'message', {
+const messageId = await brain.add(userMessage, {
+    nounType: 'message',
     type: "message",
     timestamp: Date.now(),
     session: "abc"
 })
 
-const topicId = await brain.addNoun("Product Support", 'topic', {
+const topicId = await brain.add("Product Support", {
+    nounType: 'topic',
     type: "topic",
     category: "support"
 })
 
 // Link conversation elements
-await brain.addVerb(userId, messageId, "sent")
-await brain.addVerb(messageId, topicId, "about")
+await brain.relate(userId, messageId, "sent")
+await brain.relate(messageId, topicId, "about")
 
 // Retrieve context with relationships
 const context = await brain.find({
@@ -595,7 +602,7 @@ for (const cluster of feedbackClusters) {
 }
 
 // Find related documents
-const docId = await brain.addNoun("Machine learning guide", 'document')
+const docId = await brain.add("Machine learning guide", { nounType: 'document' })
 const similar = await neural.neighbors(docId, 5)
 // Returns 5 most similar documents
 

package/dist/augmentations/cacheAugmentation.d.ts

@@ -16,6 +16,7 @@ export interface CacheConfig {
     ttl?: number;
     enabled?: boolean;
     invalidateOnWrite?: boolean;
+    silent?: boolean;
 }
 /**
  * CacheAugmentation - Makes search caching optional and pluggable

package/dist/augmentations/cacheAugmentation.js

@@ -65,6 +65,11 @@ export class CacheAugmentation extends BaseAugmentation {
                         type: 'boolean',
                         default: true,
                         description: 'Automatically invalidate cache on data modifications'
+                    },
+                    silent: {
+                        type: 'boolean',
+                        default: false,
+                        description: 'Suppress all console output'
                     }
                 },
                 additionalProperties: false

package/dist/augmentations/display/types.d.ts

@@ -18,6 +18,8 @@ export interface DisplayConfig {
     batchSize: number;
     /** Minimum confidence threshold for AI type detection */
     confidenceThreshold: number;
+    /** Silent mode - suppress all console output */
+    silent?: boolean;
     /** Custom field mappings (userField -> displayField) */
     customFieldMappings: Record<string, string>;
     /** Type-specific priority fields for intelligent detection */

package/dist/augmentations/metricsAugmentation.d.ts

@@ -24,6 +24,7 @@ export interface MetricsConfig {
     trackStorageSizes?: boolean;
     persistMetrics?: boolean;
     metricsInterval?: number;
+    silent?: boolean;
 }
 /**
  * MetricsAugmentation - Makes metrics collection optional and pluggable

package/dist/augmentations/universalDisplayAugmentation.js

@@ -234,6 +234,10 @@ export class UniversalDisplayAugmentation extends BaseAugmentation {
      */
     createExploreMethod(entity) {
         return async () => {
+            // Respect silent mode
+            if (this.config.silent) {
+                return;
+            }
             console.log(`\n📋 Entity Exploration: ${entity.id || 'unknown'}`);
             console.log('━'.repeat(50));
             // Show user data

package/dist/brainy.d.ts

@@ -22,6 +22,7 @@ export declare class Brainy<T = any> {
     private distance;
     private augmentationRegistry;
     private config;
+    private originalConsole?;
     private _neural?;
     private _nlp?;
     private _tripleIntelligence?;

package/dist/brainy.js

@@ -63,7 +63,20 @@ export class Brainy {
         }
         // Configure logging based on config options
         if (this.config.silent) {
-            configureLogger({ level: -1 }); // Suppress all logs
+            // Store original console methods for restoration
+            this.originalConsole = {
+                log: console.log,
+                info: console.info,
+                warn: console.warn,
+                error: console.error
+            };
+            // Override all console methods to completely silence output
+            console.log = () => { };
+            console.info = () => { };
+            console.warn = () => { };
+            console.error = () => { };
+            // Also configure logger for silent mode
+            configureLogger({ level: LogLevel.SILENT }); // Suppress all logs
         }
         else if (this.config.verbose) {
             configureLogger({ level: LogLevel.DEBUG }); // Enable verbose logging
@@ -1408,8 +1421,18 @@ export class Brainy {
      */
     setupAugmentations() {
         const registry = new AugmentationRegistry();
-        // Register default augmentations
-        const defaults = createDefaultAugmentations(this.config.augmentations);
+        // Register default augmentations with silent mode support
+        const augmentationConfig = {
+            ...this.config.augmentations,
+            // Pass silent mode to all augmentations
+            ...(this.config.silent && {
+                cache: this.config.augmentations?.cache !== false ? { ...this.config.augmentations?.cache, silent: true } : false,
+                metrics: this.config.augmentations?.metrics !== false ? { ...this.config.augmentations?.metrics, silent: true } : false,
+                display: this.config.augmentations?.display !== false ? { ...this.config.augmentations?.display, silent: true } : false,
+                monitoring: this.config.augmentations?.monitoring !== false ? { ...this.config.augmentations?.monitoring, silent: true } : false
+            })
+        };
+        const defaults = createDefaultAugmentations(augmentationConfig);
         for (const aug of defaults) {
             registry.register(aug);
         }
@@ -1488,6 +1511,14 @@ export class Brainy {
                 await aug.shutdown();
             }
         }
+        // Restore console methods if silent mode was enabled
+        if (this.config.silent && this.originalConsole) {
+            console.log = this.originalConsole.log;
+            console.info = this.originalConsole.info;
+            console.warn = this.originalConsole.warn;
+            console.error = this.originalConsole.error;
+            this.originalConsole = undefined;
+        }
         // Storage doesn't have close in current interface
         // We'll just mark as not initialized
         this.initialized = false;

package/dist/brainyData.d.ts

@@ -1468,6 +1468,7 @@ export declare class BrainyData<T = any> implements BrainyDataInterface<T> {
      * @returns Created noun ID
      */
     /**
+     * @deprecated Use add() instead - it's smart by default now
      * Add a noun to the database with required type
      * Clean 2.0 API - primary method for adding data
      *
@@ -1484,6 +1485,7 @@ export declare class BrainyData<T = any> implements BrainyDataInterface<T> {
         process?: 'auto' | 'literal' | 'neural';
     }): Promise<string>;
     /**
+     * @deprecated Use relate() instead
      * Add Verb - Unified relationship creation between nouns
      * Creates typed relationships with proper vector embeddings from metadata
      * @param sourceId Source noun ID

package/dist/types/brainyDataInterface.d.ts

@@ -16,6 +16,7 @@ export interface BrainyInterface<T = unknown> {
      */
     getNoun(id: string): Promise<unknown>;
     /**
+     * @deprecated Use add() instead - it's smart by default now
      * Add a noun (entity with vector and metadata) to the database
      * @param data Text string or vector representation (will auto-embed strings)
      * @param nounType Required noun type (one of 31 types)
@@ -31,6 +32,7 @@ export interface BrainyInterface<T = unknown> {
      */
     searchText(text: string, limit?: number): Promise<unknown[]>;
     /**
+     * @deprecated Use relate() instead
      * Create a relationship (verb) between two entities
      * @param sourceId The ID of the source entity
      * @param targetId The ID of the target entity

package/dist/utils/logger.d.ts

@@ -4,6 +4,7 @@
  * Automatically reduces logging in production environments to minimize costs
  */
 export declare enum LogLevel {
+    SILENT = -1,// New: Completely silent mode
     ERROR = 0,
     WARN = 1,
     INFO = 2,

package/dist/utils/logger.js

@@ -6,6 +6,7 @@
 import { isProductionEnvironment, getLogLevel } from './environment.js';
 export var LogLevel;
 (function (LogLevel) {
+    LogLevel[LogLevel["SILENT"] = -1] = "SILENT";
     LogLevel[LogLevel["ERROR"] = 0] = "ERROR";
     LogLevel[LogLevel["WARN"] = 1] = "WARN";
     LogLevel[LogLevel["INFO"] = 2] = "INFO";
@@ -45,7 +46,7 @@ class Logger {
         // Convert environment log level to Logger LogLevel
         switch (envLogLevel) {
             case 'silent':
-                this.config.level = -1; // Below ERROR to silence all logs
+                this.config.level = LogLevel.SILENT;
                 break;
             case 'error':
                 this.config.level = LogLevel.ERROR;
@@ -81,6 +82,10 @@ class Logger {
         this.config = { ...this.config, ...config };
     }
     shouldLog(level, module) {
+        // Silent mode - never log anything
+        if (this.config.level === LogLevel.SILENT) {
+            return false;
+        }
         // Check module-specific level first
         if (this.config.modules && this.config.modules[module] !== undefined) {
             return level <= this.config.modules[module];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "3.2.0",
+  "version": "3.3.1",
   "description": "Universal Knowledge Protocol™ - World's first Triple Intelligence database unifying vector, graph, and document search in one API. 31 nouns × 40 verbs for infinite expressiveness.",
   "main": "dist/index.js",
   "module": "dist/index.js",