feat: remove legacy ImportManager, standardize getStats() API

- Removed ImportManager class and exports (use brain.import() instead)
- Fixed all documentation: getStatistics() → getStats()
- Updated 41 files across codebase for consistency
- Removed ImportManager section from API docs
- Added v3.30.0 migration guide to CHANGELOG

Co-Authored-By: Claude <noreply@anthropic.com>

examples/tests/focused-validation.js

@@ -57,7 +57,7 @@ try {
   const searchResults = await brain.search('test', { limit: 1 })
   console.log(`✅ [${timeElapsed()}s] Search returned ${searchResults.length} results`)
   
-  const stats = await brain.getStatistics()
+  const stats = brain.getStats()
   console.log(`✅ [${timeElapsed()}s] Statistics: ${stats.nounCount} nouns`)
   
   console.log(`\n🎉 COMPLETE SUCCESS in ${timeElapsed()}s!`)

examples/tests/production-validation.js

@@ -145,7 +145,7 @@ async function runValidation() {
     
     // Test 11: Statistics and monitoring
     const statsStart = performance.now()
-    const stats = await brain.getStatistics()
+    const stats = brain.getStats()
     const statsTime = Math.round(performance.now() - statsStart)
     const hasStats = stats && typeof stats.nounCount === 'number' && stats.nounCount > 0
     addResult('Statistics Collection', hasStats, `${stats.nounCount} nouns tracked`, statsTime)
@@ -184,9 +184,9 @@ async function runValidation() {
     
     // Test 14: Data persistence and retrieval
     const integrityStart = performance.now()
-    const beforeCount = (await brain.getStatistics()).nounCount
+    const beforeCount = (brain.getStats()).nounCount
     const testId = await brain.addNoun('Integrity test data', { critical: true })
-    const afterCount = (await brain.getStatistics()).nounCount
+    const afterCount = (brain.getStats()).nounCount
     const retrieved2 = await brain.getNoun(testId)
     const integrityTime = Math.round(performance.now() - integrityStart)
     const isIntact = afterCount > beforeCount && retrieved2 && retrieved2.metadata && retrieved2.metadata.critical === true

examples/tests/quick-validation.js

@@ -50,7 +50,7 @@ try {
 
   // Test 6: Statistics  
   console.log('\n6️⃣ Statistics...')
-  const stats = await brain.getStatistics()
+  const stats = brain.getStats()
   console.log(`✅ Statistics: ${stats.nounCount} nouns tracked`)
 
   // Test 7: Memory 

examples/tests/test-cli.js

@@ -20,7 +20,7 @@ try {
   console.log('✅ find method:', typeof brain.find === 'function')
   console.log('✅ updateNoun method:', typeof brain.updateNoun === 'function')
   console.log('✅ deleteNoun method:', typeof brain.deleteNoun === 'function')
-  console.log('✅ getStatistics method:', typeof brain.getStatistics === 'function')
+  console.log('✅ getStatistics method:', typeof brain.getStats === 'function')
   
   console.log('\n🎯 CLI API Compatibility: 100% ✅')
   console.log('All required methods exist with correct names')

examples/tests/test-core-direct.js

@@ -90,7 +90,7 @@ async function testBrainyCore() {
     
     // Test 9: Statistics
     console.log('\n📊 Testing Statistics')
-    const stats = await brain.getStatistics()
+    const stats = brain.getStats()
     assert(typeof stats.totalItems === 'number', 'Should provide total items count')
     assert(stats.totalItems >= 3, 'Should count added items')
     console.log(`   Total items: ${stats.totalItems}`)

examples/tests/test-core-functionality.js

@@ -154,7 +154,7 @@ async function runTests() {
 
   // Test 5: Statistics
   await test('getStatistics() should provide stats', async () => {
-    const stats = await brain.getStatistics()
+    const stats = brain.getStats()
     if (typeof stats.totalItems !== 'number' || stats.totalItems <= 0) {
       throw new Error('getStatistics should return valid stats')
     }

examples/tests/test-fast-ai.js

@@ -45,7 +45,7 @@ async function quickTest() {
     }
     
     // Statistics
-    const stats = await brain.getStatistics()
+    const stats = brain.getStats()
     console.log(`✅ Stats: ${stats.totalItems} items, ${stats.dimensions}D`)
     
     console.log('\n🎯 CRITICAL FEATURES VERIFIED:')

examples/tests/test-no-search.js

@@ -50,7 +50,7 @@ async function testNoSearch() {
     console.log(`✅ Found ${verbs.length} verb(s) from TypeScript`)
 
     console.log('\n6. Checking statistics...')
-    const stats = await brain.getStatistics()
+    const stats = brain.getStats()
     console.log(`✅ Stats: ${stats.nounCount} nouns, ${stats.verbCount} verbs`)
 
     console.log('\n7. Memory check...')

examples/tests/test-production-ready.js

@@ -176,7 +176,7 @@ async function testProductionFunctionality() {
     console.log('\n8️⃣ Testing statistics and monitoring...')
     try {
       const stats = await withTimeout(
-        brain.getStatistics(),
+        Promise.resolve(brain.getStats()),
         'Statistics retrieval',
         5000
       )

examples/tests/test-real-ai.js

@@ -68,7 +68,7 @@ async function testAllFeatures() {
     console.log(`   ✅ Found ${tripleResults.length} results with Triple Intelligence`)
     
     console.log('\n7. Testing statistics and health...')
-    const stats = await brain.getStatistics()
+    const stats = brain.getStats()
     console.log(`   ✅ Total items: ${stats.totalItems}`)
     console.log(`   ✅ Dimensions: ${stats.dimensions}`)
     console.log(`   ✅ Index size: ${stats.indexSize}`)

examples/tests/test-statistics.js

@@ -14,7 +14,7 @@ const id1 = await brain.addNoun('Test 1', { name: 'Test 1' })
 const id2 = await brain.addNoun('Test 2', { name: 'Test 2' })
 
 console.log('Getting statistics...')
-const stats = await brain.getStatistics()
+const stats = brain.getStats()
 
 console.log('\nStatistics after adding 2 nouns:')
 console.log('  nounCount:', stats.nounCount)

examples/tests/test-storage-adapters.js

@@ -72,7 +72,7 @@ async function testStorageAdapter(name, config) {
     
     // Test statistics
     console.log('  Testing statistics...')
-    const stats = await brain.getStatistics()
+    const stats = brain.getStats()
     console.log(`  ✅ Stats: ${stats.nounCount} nouns, ${stats.verbCount} verbs`)
     
     // Test delete

examples/tests/test-without-embeddings.js

@@ -125,7 +125,7 @@ async function testCoreFeatures() {
     
     // 10. Test statistics
     console.log('\n11. Testing statistics...')
-    const stats = await brain.getStatistics()
+    const stats = brain.getStats()
     console.log('✅ Stats - Total items:', stats.totalItems)
     console.log('  Dimensions:', stats.dimensions)
     console.log('  Index size:', stats.indexSize)