@soulcraft/brainy 3.29.0 → 3.30.0

package/CHANGELOG.md

@@ -2,6 +2,55 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [3.30.0](https://github.com/soulcraftlabs/brainy/compare/v3.29.1...v3.30.0) (2025-10-09)
+
+- feat: remove legacy ImportManager, standardize getStats() API (58daf09)
+
+
+### [3.30.0] - BREAKING CHANGES - API Cleanup (2025-10-09)
+
+#### ⚠️ BREAKING CHANGES
+
+**1. Removed ImportManager**
+- The legacy `ImportManager` and `createImportManager` exports have been removed
+- Use `brain.import()` instead (available since v3.28.0 - newer, simpler, better)
+
+**Migration:**
+```typescript
+// ❌ OLD (removed):
+import { createImportManager } from '@soulcraft/brainy'
+const importer = createImportManager(brain)
+await importer.init()
+const result = await importer.import(data)
+
+// ✅ NEW (use this):
+const result = await brain.import(data, options)
+// Same functionality, simpler API, available on all Brainy instances!
+```
+
+**2. Documentation Fix: getStats() Not getStatistics()**
+- Corrected all documentation to use `brain.getStats()` (the actual method)
+- ⚠️ `brain.getStatistics()` **never existed** - this was a documentation error
+- No code changes needed - just documentation corrections
+- Note: `history.getStatistics()` still exists and is correct (different API)
+
+**Why These Changes:**
+- Eliminates API confusion reported by Soulcraft Studio team
+- Single, consistent import API - no more dual systems
+- Accurate documentation matching actual implementation
+- Cleaner, simpler developer experience
+
+**Impact:** LOW - Most users already using `brain.import()` (the newer API)
+
+---
+
+### [3.29.1](https://github.com/soulcraftlabs/brainy/compare/v3.29.0...v3.29.1) (2025-10-09)
+
+
+### 🐛 Bug Fixes
+
+* pass entire storage config to createStorage (gcsNativeStorage now detected) ([7a58dd7](https://github.com/soulcraftlabs/brainy/commit/7a58dd774d956cb3b548064724f9f86c0754f82e))
+
 ## [3.29.0](https://github.com/soulcraftlabs/brainy/compare/v3.28.0...v3.29.0) (2025-10-09)
 
 

package/bin/brainy-interactive.js

@@ -444,7 +444,7 @@ async function showStatistics(brain) {
   const spinner = ora('Gathering statistics...').start()
   
   try {
-    const stats = await brain.getStatistics()
+    const stats = brain.getStats()
     spinner.succeed('Statistics loaded')
     
     console.log(boxen(

package/dist/augmentations/apiServerAugmentation.js

@@ -216,7 +216,7 @@ export class APIServerAugmentation extends BaseAugmentation {
         // Statistics endpoint
         app.get('/api/stats', async (_req, res) => {
             try {
-                const stats = await this.context.brain.getStatistics();
+                const stats = this.context.brain.getStats();
                 res.json({ success: true, stats });
             }
             catch (error) {

package/dist/brainy.js

@@ -2227,10 +2227,9 @@ export class Brainy {
      * Setup storage
      */
     async setupStorage() {
-        const storage = await createStorage({
-            type: this.config.storage?.type || 'auto',
-            ...this.config.storage?.options
-        });
+        // Pass the entire storage config object to createStorage
+        // This ensures all storage-specific configs (gcsNativeStorage, s3Storage, etc.) are passed through
+        const storage = await createStorage(this.config.storage);
         return storage;
     }
     /**

package/dist/index.d.ts

@@ -15,8 +15,6 @@ export { PresetName, ModelPrecision, StorageOption, FeatureSet, DistributedRole,
 export { Cortex, cortex } from './cortex.js';
 export { NeuralImport } from './cortex/neuralImport.js';
 export type { NeuralAnalysisResult, DetectedEntity, DetectedRelationship, NeuralInsight, NeuralImportOptions } from './cortex/neuralImport.js';
-export { ImportManager, createImportManager } from './importManager.js';
-export type { ImportOptions, ImportResult } from './importManager.js';
 import { euclideanDistance, cosineDistance, manhattanDistance, dotProductDistance } from './utils/index.js';
 export { euclideanDistance, cosineDistance, manhattanDistance, dotProductDistance };
 export { getBrainyVersion } from './utils/version.js';

package/dist/index.js

@@ -31,8 +31,7 @@ getPreset, isValidPreset, getPresetsByCategory, getAllPresetNames, getPresetDesc
 export { Cortex, cortex } from './cortex.js';
 // Export Neural Import (AI data understanding)
 export { NeuralImport } from './cortex/neuralImport.js';
-// Export Import Manager (comprehensive data import)
-export { ImportManager, createImportManager } from './importManager.js';
+// Import Manager removed - use brain.import() instead (available on all Brainy instances)
 // Augmentation types are already exported later in the file
 // Export distance functions for convenience
 import { euclideanDistance, cosineDistance, manhattanDistance, dotProductDistance } from './utils/index.js';

package/dist/neural/neuralAPI.js

@@ -125,8 +125,8 @@ export class NeuralAPI {
      */
     async outliers(threshold = 0.3) {
         // Get all items
-        const stats = await this.brain.getStatistics();
-        const totalItems = stats.nounCount;
+        const stats = this.brain.getStats();
+        const totalItems = stats.entities.total;
         if (totalItems === 0)
             return [];
         // For large datasets, use sampling
@@ -325,8 +325,8 @@ export class NeuralAPI {
     // Enterprise clustering implementations
     async getOptimalClusteringLevel() {
         // Analyze dataset size and return optimal HNSW level
-        const stats = await this.brain.getStatistics();
-        const itemCount = stats.nounCount;
+        const stats = this.brain.getStats();
+        const itemCount = stats.entities.total;
         if (itemCount < 1000)
             return 0;
         if (itemCount < 10000)
@@ -338,8 +338,8 @@ export class NeuralAPI {
     async getHNSWLevelNodes(level) {
         // Get nodes from specific HNSW level
         // For now, use search to get a representative sample
-        const stats = await this.brain.getStatistics();
-        const sampleSize = Math.min(100, Math.floor(stats.nounCount / (level + 1)));
+        const stats = this.brain.getStats();
+        const sampleSize = Math.min(100, Math.floor(stats.entities.total / (level + 1)));
         // Use search with a general query to get representative items
         const queryVector = await this.brain.embed('data information content');
         const allItems = await this.brain.search(queryVector, sampleSize * 2);
@@ -352,8 +352,8 @@ export class NeuralAPI {
     }
     async getSample(size, strategy) {
         // Use search to get a sample of items
-        const stats = await this.brain.getStatistics();
-        const maxSize = Math.min(size * 3, stats.nounCount); // Get more than needed for sampling
+        const stats = this.brain.getStats();
+        const maxSize = Math.min(size * 3, stats.entities.total); // Get more than needed for sampling
         const queryVector = await this.brain.embed('sample data content');
         const allItems = await this.brain.search(queryVector, maxSize);
         switch (strategy) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "3.29.0",
+  "version": "3.30.0",
   "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",