🧠 Brainy 2.0.0 - Zero-Configuration AI Database with Triple Intelligence™

MAJOR RELEASE: Complete evolution of Brainy with groundbreaking features and performance.

🎯 KEY FEATURES:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Triple Intelligence™ Engine
  - Unified Vector + Metadata + Graph search
  - O(log n) performance on all operations
  - 3ms average search latency at any scale

 API Consolidation
  - 15+ search methods → 2 clean APIs
  - search() for vector similarity
  - find() for natural language queries

 Natural Language Processing
  - 220+ pre-computed NLP patterns
  - Instant context understanding
  - "Show me recent React components with tests"

 Zero Configuration
  - Works instantly, no setup required
  - Built-in embedding models (no API keys)
  - Smart defaults for everything
  - Automatic optimization

 Enterprise Features (Free for Everyone)
  - Scales to 10M+ items
  - Write-Ahead Logging (WAL) for durability
  - Distributed architecture with sharding
  - Read/write separation
  - Connection pooling & request deduplication
  - Built-in monitoring & health checks

 Universal Compatibility
  - Node.js, Browser, Edge Workers
  - 4 Storage Adapters (Memory, FileSystem, OPFS, S3)
  - TypeScript with full type safety
  - Worker-based embeddings

📦 WHAT'S INCLUDED:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Core AI Database with HNSW indexing
• 19 Production-ready augmentations
• Universal Memory Manager
• Complete CLI with all commands
• Brain Cloud integration (soulcraft.com)
• Comprehensive documentation
• 52 test files with 400+ tests
• Migration guide from 1.x

📊 PERFORMANCE:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Initialize: 450ms (24MB memory)
• Search: 3ms average (up to 10M items)
• Metadata Filter: 0.8ms (O(log n))
• Bulk Import: 2.3s per 1000 items
• Production Scale: 5.8ms at 10M items

🔧 TECHNICAL IMPROVEMENTS:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• TypeScript compilation: 153 errors → 0
• Memory usage: 200MB → 24MB baseline
• Circular dependencies resolved
• Worker thread communication fixed
• Storage adapter consistency
• Request coalescing for 3x performance

🛠️ CLI FEATURES:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• brainy add - Smart data ingestion
• brainy find - Natural language search
• brainy search - Vector similarity
• brainy chat - AI conversation mode
• brainy cloud - Brain Cloud integration
• brainy augment - Manage extensions
• 100% API compatibility

📚 DOCUMENTATION:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Professional README with examples
• Quick Start guide (5 minutes)
• Enterprise Features guide
• Migration guide from 1.x
• API reference
• Architecture documentation

🌟 USE CASES:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• AI memory layer for chatbots
• Semantic document search
• Code intelligence platforms
• Knowledge management systems
• Real-time recommendation engines
• Customer support automation

MIT License - Enterprise features included free for everyone.
No premium tiers, no paywalls, no limits.

Built with ❤️ by the Brainy community.
Visit https://soulcraft.com for Brain Cloud integration.
This commit is contained in:
David Snelling 2025-08-26 12:32:21 -07:00
commit 292a9f9c42
304 changed files with 179345 additions and 0 deletions

View file

@ -0,0 +1,20 @@
#!/bin/bash
# Fix all .clear() calls to .clearAll({ force: true }) in tests
echo "🔧 Fixing clear() calls in test files..."
# Find and replace in all test files
for file in tests/*.test.ts; do
if grep -q "\.clear()" "$file"; then
echo " Fixing: $file"
# Replace various patterns
sed -i 's/\.clear()/\.clearAll({ force: true })/g' "$file"
sed -i 's/\.clearAll({ force: true }) \/\/ Clear any existing data/\.clearAll({ force: true }) \/\/ Clear any existing data/g' "$file"
fi
done
echo "✅ Fixed all clear() calls to clearAll({ force: true })"
echo ""
echo "Files modified:"
grep -l "clearAll({ force: true })" tests/*.test.ts | sed 's/^/ - /'

97
tests/scripts/run-all-tests.sh Executable file
View file

@ -0,0 +1,97 @@
#!/bin/bash
# Run all Brainy tests sequentially with memory management
# This prevents memory exhaustion from parallel test execution
echo "🧠 Running Brainy 2.0 Complete Test Suite"
echo "========================================"
echo "Memory: 16GB allocated per test batch"
echo ""
# Set Node options for all tests
export NODE_OPTIONS='--max-old-space-size=16384'
export BRAINY_MODELS_PATH=./models
export BRAINY_ALLOW_REMOTE_MODELS=false
# Counter for tracking results
PASSED=0
FAILED=0
SKIPPED=0
TOTAL=0
# Run tests in batches to prevent memory exhaustion
echo "📦 Batch 1: Core Tests"
echo "----------------------"
npm test -- --run tests/core.test.ts 2>&1 | tee batch1.log | grep -E "✓|×|↓" | tail -20
echo ""
echo "📦 Batch 2: Triple Intelligence & Neural"
echo "----------------------------------------"
npm test -- --run tests/triple-intelligence.test.ts tests/neural-api.test.ts 2>&1 | tee batch2.log | grep -E "✓|×|↓" | tail -20
echo ""
echo "📦 Batch 3: Metadata & Performance"
echo "-----------------------------------"
npm test -- --run tests/metadata-*.test.ts 2>&1 | tee batch3.log | grep -E "✓|×|↓" | tail -20
echo ""
echo "📦 Batch 4: Storage & Database"
echo "-------------------------------"
npm test -- --run tests/database-operations.test.ts tests/storage-adapter-coverage.test.ts 2>&1 | tee batch4.log | grep -E "✓|×|↓" | tail -20
echo ""
echo "📦 Batch 5: Augmentations"
echo "-------------------------"
npm test -- --run tests/augmentations-*.test.ts 2>&1 | tee batch5.log | grep -E "✓|×|↓" | tail -20
echo ""
echo "📦 Batch 6: API & Consistency"
echo "-----------------------------"
npm test -- --run tests/consistent-api.test.ts tests/unified-api.test.ts 2>&1 | tee batch6.log | grep -E "✓|×|↓" | tail -20
echo ""
echo "📦 Batch 7: Environment & Edge Cases"
echo "-------------------------------------"
npm test -- --run tests/environment.*.test.ts tests/edge-cases.test.ts 2>&1 | tee batch7.log | grep -E "✓|×|↓" | tail -20
echo ""
echo "📦 Batch 8: Find & NLP"
echo "----------------------"
npm test -- --run tests/find-comprehensive.test.ts tests/nlp-patterns-comprehensive.test.ts 2>&1 | tee batch8.log | grep -E "✓|×|↓" | tail -20
echo ""
echo "📦 Batch 9: Regression & Validation"
echo "------------------------------------"
npm test -- --run tests/regression.test.ts tests/release-*.test.ts 2>&1 | tee batch9.log | grep -E "✓|×|↓" | tail -20
echo ""
echo "📦 Batch 10: Other Tests"
echo "------------------------"
npm test -- --run tests/distributed*.test.ts tests/cli.test.ts tests/brainy-chat.test.ts tests/pagination.test.ts tests/vector-operations.test.ts tests/error-handling.test.ts tests/specialized-scenarios.test.ts tests/multi-environment.test.ts tests/statistics.test.ts tests/type-utils.test.ts 2>&1 | tee batch10.log | grep -E "✓|×|↓" | tail -20
echo ""
# Aggregate results
echo ""
echo "=========================================="
echo "🎯 FINAL TEST RESULTS"
echo "=========================================="
# Count passed/failed from all logs
PASSED=$(cat batch*.log 2>/dev/null | grep -c "✓" || echo 0)
FAILED=$(cat batch*.log 2>/dev/null | grep -c "×" || echo 0)
SKIPPED=$(cat batch*.log 2>/dev/null | grep -c "↓" || echo 0)
TOTAL=$((PASSED + FAILED + SKIPPED))
echo "✅ Passed: $PASSED"
echo "❌ Failed: $FAILED"
echo "⏭️ Skipped: $SKIPPED"
echo "📊 Total: $TOTAL"
echo ""
if [ $FAILED -eq 0 ]; then
echo "🎉 SUCCESS! All tests passed!"
exit 0
else
echo "⚠️ Some tests failed. Check individual batch logs for details."
exit 1
fi

111
tests/scripts/run-tests-safe.sh Executable file
View file

@ -0,0 +1,111 @@
#!/bin/bash
# Safe test runner with memory management
# Runs tests in groups to avoid OOM errors
echo "🧠 Brainy Test Runner - Memory Safe Mode"
echo "========================================="
# Set environment variables
export BRAINY_MODELS_PATH=./models
export BRAINY_ALLOW_REMOTE_MODELS=false
export NODE_OPTIONS="--max-old-space-size=2048"
# Track results
TOTAL_PASSED=0
TOTAL_FAILED=0
FAILED_TESTS=""
# Function to run a test group
run_test_group() {
local group_name=$1
local test_pattern=$2
echo ""
echo "📊 Running: $group_name"
echo "----------------------------------------"
# Run tests and capture output
if npx vitest run $test_pattern --reporter=verbose 2>&1 | tee test-output.tmp | grep -E "(Test Files|Tests)" | tail -2; then
# Extract pass/fail counts
local result=$(tail -2 test-output.tmp | grep -E "(passed|failed)")
echo "$result"
# Parse results (basic parsing, might need adjustment)
if echo "$result" | grep -q "failed"; then
FAILED_TESTS="$FAILED_TESTS\n - $group_name"
((TOTAL_FAILED++))
else
((TOTAL_PASSED++))
fi
else
echo " ❌ Test group failed to run"
FAILED_TESTS="$FAILED_TESTS\n - $group_name (crashed)"
((TOTAL_FAILED++))
fi
# Clean up temp file
rm -f test-output.tmp
# Force garbage collection pause
sleep 2
}
# Run test groups
echo "🚀 Starting test execution..."
# Group 1: Core functionality
run_test_group "Core API Tests" "tests/core.test.ts tests/consistent-api.test.ts tests/unified-api.test.ts"
# Group 2: Intelligent features
run_test_group "Intelligent Features" "tests/intelligent-verb-scoring.test.ts tests/neural-import.test.ts tests/neural-clustering.test.ts"
# Group 3: Augmentations
run_test_group "Augmentations" "tests/augmentations-*.test.ts"
# Group 4: Storage
run_test_group "Storage Adapters" "tests/storage-adapter-coverage.test.ts tests/opfs-storage.test.ts"
# Group 5: Vector operations
run_test_group "Vector Operations" "tests/vector-operations.test.ts tests/dimension-standardization.test.ts"
# Group 6: Triple Intelligence
run_test_group "Triple Intelligence" "tests/triple-intelligence.test.ts tests/metadata-filter.test.ts"
# Group 7: Performance (lighter tests)
run_test_group "Performance Tests" "tests/performance.test.ts tests/pagination.test.ts"
# Group 8: Edge cases
run_test_group "Edge Cases & Error Handling" "tests/edge-cases.test.ts tests/error-handling.test.ts"
# Group 9: Zero config
run_test_group "Zero Config" "tests/zero-config-models.test.ts tests/auto-configuration.test.ts"
# Group 10: Model loading
run_test_group "Model Loading" "tests/model-loading.test.ts"
# Summary
echo ""
echo "========================================="
echo "📈 TEST SUMMARY"
echo "========================================="
echo "✅ Passed: $TOTAL_PASSED test groups"
echo "❌ Failed: $TOTAL_FAILED test groups"
if [ ! -z "$FAILED_TESTS" ]; then
echo ""
echo "Failed groups:"
echo -e "$FAILED_TESTS"
fi
echo ""
echo "========================================="
# Exit with appropriate code
if [ $TOTAL_FAILED -gt 0 ]; then
echo "❌ Tests failed. Please fix before release."
exit 1
else
echo "✅ All test groups passed!"
exit 0
fi

View file

@ -0,0 +1,73 @@
#!/bin/bash
# Comprehensive test runner with proper memory management
# Runs ALL tests with adequate memory allocation
echo "🧠 Brainy 2.0 Complete Test Suite with Memory Management"
echo "========================================================="
echo ""
# Set environment for ALL tests
export NODE_OPTIONS='--max-old-space-size=16384'
export BRAINY_MODELS_PATH=./models
export BRAINY_ALLOW_REMOTE_MODELS=false
# Use our memory-optimized vitest config
export VITEST_CONFIG=./vitest.config.memory.ts
echo "📊 Configuration:"
echo " - Node heap: 16GB"
echo " - Models: Local only"
echo " - Tests: Sequential execution"
echo " - Timeout: 2 minutes per test"
echo ""
# Build first
echo "🔨 Building TypeScript..."
npm run build
if [ $? -ne 0 ]; then
echo "❌ Build failed! Fix TypeScript errors first."
exit 1
fi
echo "✅ Build successful"
echo ""
# Run all tests with memory config
echo "🧪 Running all tests..."
npm test -- --config ./vitest.config.memory.ts --reporter=verbose 2>&1 | tee full-test-output.log
# Extract summary
echo ""
echo "=========================================="
echo "📊 Test Summary"
echo "=========================================="
# Count results
PASSED=$(grep -c "✓" full-test-output.log 2>/dev/null || echo 0)
FAILED=$(grep -c "×" full-test-output.log 2>/dev/null || echo 0)
SKIPPED=$(grep -c "↓" full-test-output.log 2>/dev/null || echo 0)
echo "✅ Passed: $PASSED"
echo "❌ Failed: $FAILED"
echo "⏭️ Skipped: $SKIPPED"
echo "📊 Total: $((PASSED + FAILED + SKIPPED))"
echo ""
if [ $FAILED -eq 0 ]; then
echo "🎉 SUCCESS! All tests passed!"
echo ""
echo "Ready for release:"
echo " npm version patch"
echo " npm publish"
exit 0
else
echo "⚠️ $FAILED tests failed."
echo ""
echo "Common issues:"
echo "1. Out of memory → Increase NODE_OPTIONS"
echo "2. Timeout → Tests need more than 2 minutes"
echo "3. clearAll → Must use { force: true }"
echo ""
echo "Check full-test-output.log for details."
exit 1
fi