🧠 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:
commit
9c87982a7d
301 changed files with 178087 additions and 0 deletions
179
src/errors/brainyError.ts
Normal file
179
src/errors/brainyError.ts
Normal file
|
|
@ -0,0 +1,179 @@
|
|||
/**
|
||||
* Custom error types for Brainy operations
|
||||
* Provides better error classification and handling
|
||||
*/
|
||||
|
||||
export type BrainyErrorType = 'TIMEOUT' | 'NETWORK' | 'STORAGE' | 'NOT_FOUND' | 'RETRY_EXHAUSTED'
|
||||
|
||||
/**
|
||||
* Custom error class for Brainy operations
|
||||
* Provides error type classification and retry information
|
||||
*/
|
||||
export class BrainyError extends Error {
|
||||
public readonly type: BrainyErrorType
|
||||
public readonly retryable: boolean
|
||||
public readonly originalError?: Error
|
||||
public readonly attemptNumber?: number
|
||||
public readonly maxRetries?: number
|
||||
|
||||
constructor(
|
||||
message: string,
|
||||
type: BrainyErrorType,
|
||||
retryable: boolean = false,
|
||||
originalError?: Error,
|
||||
attemptNumber?: number,
|
||||
maxRetries?: number
|
||||
) {
|
||||
super(message)
|
||||
this.name = 'BrainyError'
|
||||
this.type = type
|
||||
this.retryable = retryable
|
||||
this.originalError = originalError
|
||||
this.attemptNumber = attemptNumber
|
||||
this.maxRetries = maxRetries
|
||||
|
||||
// Maintain proper stack trace for where our error was thrown (only available on V8)
|
||||
if (Error.captureStackTrace) {
|
||||
Error.captureStackTrace(this, BrainyError)
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a timeout error
|
||||
*/
|
||||
static timeout(operation: string, timeoutMs: number, originalError?: Error): BrainyError {
|
||||
return new BrainyError(
|
||||
`Operation '${operation}' timed out after ${timeoutMs}ms`,
|
||||
'TIMEOUT',
|
||||
true,
|
||||
originalError
|
||||
)
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a network error
|
||||
*/
|
||||
static network(message: string, originalError?: Error): BrainyError {
|
||||
return new BrainyError(
|
||||
`Network error: ${message}`,
|
||||
'NETWORK',
|
||||
true,
|
||||
originalError
|
||||
)
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a storage error
|
||||
*/
|
||||
static storage(message: string, originalError?: Error): BrainyError {
|
||||
return new BrainyError(
|
||||
`Storage error: ${message}`,
|
||||
'STORAGE',
|
||||
true,
|
||||
originalError
|
||||
)
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a not found error
|
||||
*/
|
||||
static notFound(resource: string): BrainyError {
|
||||
return new BrainyError(
|
||||
`Resource not found: ${resource}`,
|
||||
'NOT_FOUND',
|
||||
false
|
||||
)
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a retry exhausted error
|
||||
*/
|
||||
static retryExhausted(operation: string, maxRetries: number, lastError?: Error): BrainyError {
|
||||
return new BrainyError(
|
||||
`Operation '${operation}' failed after ${maxRetries} retry attempts`,
|
||||
'RETRY_EXHAUSTED',
|
||||
false,
|
||||
lastError,
|
||||
maxRetries,
|
||||
maxRetries
|
||||
)
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if an error is retryable
|
||||
*/
|
||||
static isRetryable(error: Error): boolean {
|
||||
if (error instanceof BrainyError) {
|
||||
return error.retryable
|
||||
}
|
||||
|
||||
// Check for common retryable error patterns
|
||||
const message = error.message.toLowerCase()
|
||||
const name = error.name.toLowerCase()
|
||||
|
||||
// Network-related errors that are typically retryable
|
||||
if (
|
||||
message.includes('timeout') ||
|
||||
message.includes('network') ||
|
||||
message.includes('connection') ||
|
||||
message.includes('econnreset') ||
|
||||
message.includes('enotfound') ||
|
||||
message.includes('etimedout') ||
|
||||
name.includes('timeout')
|
||||
) {
|
||||
return true
|
||||
}
|
||||
|
||||
// AWS SDK specific retryable errors
|
||||
if (
|
||||
message.includes('throttling') ||
|
||||
message.includes('rate limit') ||
|
||||
message.includes('service unavailable') ||
|
||||
message.includes('internal server error') ||
|
||||
message.includes('bad gateway') ||
|
||||
message.includes('gateway timeout')
|
||||
) {
|
||||
return true
|
||||
}
|
||||
|
||||
return false
|
||||
}
|
||||
|
||||
/**
|
||||
* Convert a generic error to a BrainyError with appropriate classification
|
||||
*/
|
||||
static fromError(error: Error, operation?: string): BrainyError {
|
||||
if (error instanceof BrainyError) {
|
||||
return error
|
||||
}
|
||||
|
||||
const message = error.message.toLowerCase()
|
||||
const name = error.name.toLowerCase()
|
||||
|
||||
// Classify the error based on common patterns
|
||||
if (message.includes('timeout') || name.includes('timeout')) {
|
||||
return BrainyError.timeout(operation || 'unknown', 0, error)
|
||||
}
|
||||
|
||||
if (
|
||||
message.includes('network') ||
|
||||
message.includes('connection') ||
|
||||
message.includes('econnreset') ||
|
||||
message.includes('enotfound') ||
|
||||
message.includes('etimedout')
|
||||
) {
|
||||
return BrainyError.network(error.message, error)
|
||||
}
|
||||
|
||||
if (
|
||||
message.includes('nosuchkey') ||
|
||||
message.includes('not found') ||
|
||||
message.includes('does not exist')
|
||||
) {
|
||||
return BrainyError.notFound(operation || 'resource')
|
||||
}
|
||||
|
||||
// Default to storage error for unclassified errors
|
||||
return BrainyError.storage(error.message, error)
|
||||
}
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue