🚀 Brainy 1.0.0-rc.1 - Complete Unified API Implementation (#5)
* feat: Complete Brainy 1.0 Great Cleanup 🎯 THE GREAT CLEANUP - Making Brainy Beautiful BREAKING CHANGES: - Removed addSmart() method (use add() - it's smart by default) - Removed duplicate Pipeline classes (consolidated into ONE Cortex) - Removed 40+ CLI commands (now just 5 clean commands) ✅ WHAT'S DONE: - Delete duplicate files: sequentialPipeline.ts, cortex-legacy.ts, serviceIntegration.ts - Consolidated into ONE Cortex class (the orchestrator) - Pipeline class now delegates to Cortex (backward compatibility) - Clean CLI: add, import, search, status, help (ONE way to do everything) - Interactive mode for beginners 📈 RESULTS: - 5 CLI commands (was 40+) - 1 Pipeline system (was 3+) - Clean, obvious naming - Beautiful user experience This achieves the vision: ONE way to do everything, elegant and powerful. * fix: Restore essential CLI commands and remove backward compatibility ✅ IMPROVEMENTS: - Remove Pipeline delegation complexity - Pipeline IS Cortex now - Restore essential commands: config, cloud, migrate - Keep core clean: add, import, search, status, help - Interactive help updated with all options 🎯 FINAL CLI (8 commands): - Core: add, import, search, status, help - Essential: config, cloud, migrate ✅ NO FUNCTIONALITY LOST: - Zero-config and dynamic adaptations intact - All storage adapters working - Premium Brain Cloud integration restored - Migration tools available Result: Perfect balance of simplicity and functionality * feat: Enhance status command with comprehensive statistics display ✨ ENHANCED STATUS COMMAND: - Full integration with brainyData.getStatistics() - Beautiful, organized display of all statistics - Three modes: default (comprehensive), --simple (quick), --verbose (raw JSON) 📊 STATISTICS DISPLAYED: - Core Database: items, nouns, verbs, documents - Storage Information: type, size, location - Performance Metrics: query times, cache hit rates - Vector Index: dimensions, vector count, index size - Memory Usage: heap, RSS breakdown - Active Augmentations: with descriptions - Configuration: with sensitive data hidden - Raw JSON option for developers 🎯 USAGE: - brainy status (comprehensive view) - brainy status --simple (quick overview) - brainy status --verbose (everything + raw JSON) Perfect for monitoring brain health and performance! * feat: Add per-service statistics and field discovery to CLI 🎯 ENHANCED STATISTICS DISPLAY: - Show per-service breakdown of nouns, verbs, metadata - Display serviceBreakdown from getStatistics() properly - Beautiful formatting for multi-service environments 🔍 FIELD DISCOVERY FOR ADVANCED SEARCH: - New section in 'brainy status' shows available filter fields - Added --fields option to search command - Usage examples provided for complex filtering - Integrates with getFilterFields() method 📊 USAGE EXAMPLES: - brainy status (shows per-service stats + available fields) - brainy search 'query' --fields (field discovery) - brainy search 'query' --filter '{"type":"person"}' (advanced filtering) Perfect for developers doing complex queries and multi-service deployments! * feat: Restore and enhance brainy chat with multi-model AI support 🎯 RESTORED CHAT FUNCTIONALITY: - Complete brainy chat command with rich options - Interactive mode with session management - Chat history search and session switching - Auto-discovery of previous sessions 🤖 MULTI-MODEL AI INTEGRATION: - Local models: Ollama/LLaMA (default) - OpenAI: GPT-3.5/GPT-4 support - Claude: Anthropic integration - Custom models: configurable base URLs 💬 RICH CHAT FEATURES: - Session management: list, switch, resume - History: view previous conversations - Search: find messages across all sessions - Context-aware: uses your brain data for responses 🔧 USAGE EXAMPLES: - brainy chat (interactive mode) - brainy chat 'question' (single message) - brainy chat --list (show sessions) - brainy chat --model openai --api-key sk-... (OpenAI) - brainy chat --model claude --api-key sk-ant-... (Claude) Perfect for talking to your data with any AI model! * feat: Complete Brainy 1.0.0-rc.1 unified API implementation - Implement 7 core unified API methods (add, search, import, addNoun, addVerb, update, delete) - Add universal encryption system with encryptData/decryptData methods - Add container deployment support with model preloading - Implement soft delete by default for better performance - Add searchVerbs() and getNounWithVerbs() for graph traversal - Reduce package size by 16% despite major feature additions - Create comprehensive CHANGELOG.md and MIGRATION.md - Consolidate CLI from 40+ to 9 clean commands - All scaling optimizations preserved and enhanced BREAKING CHANGES: - addSmart() method removed (use add() - smart by default) - CLI commands consolidated and renamed - Pipeline classes unified into single Cortex class This is the complete 1.0 release candidate with all planned features implemented and tested.
This commit is contained in:
GitHub
parent
7fb34a0b1d
commit
718a963447
18 changed files with 3184 additions and 6625 deletions
93
CHANGELOG.md
93
CHANGELOG.md
|
|
@ -2,6 +2,99 @@
|
|||
|
||||
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.
|
||||
|
||||
## [1.0.0-rc.1] - 2025-01-14
|
||||
|
||||
### 🎉 **MAJOR RELEASE CANDIDATE - THE GREAT CLEANUP**
|
||||
|
||||
This release represents a complete architectural consolidation and API unification. We've eliminated duplicate code, standardized all operations, and enhanced security while maintaining all existing functionality and performance optimizations.
|
||||
|
||||
### ✨ **NEW UNIFIED API - ONE Way to Do Everything**
|
||||
|
||||
#### Added
|
||||
- **🧠 7 Core Methods** - Consolidated from 40+ scattered methods to 7 unified operations:
|
||||
1. `add()` - Smart data addition (auto/guided/explicit/literal modes)
|
||||
2. `search()` - Triple-power search (vector + graph + facets)
|
||||
3. `import()` - Neural import with semantic type detection
|
||||
4. `addNoun()` - Explicit noun creation with strongly-typed NounType
|
||||
5. `addVerb()` - Relationship creation between nouns
|
||||
6. `update()` - Smart updates with automatic index synchronization
|
||||
7. `delete()` - Smart delete with soft delete default
|
||||
|
||||
- **🔐 Universal Encryption System**
|
||||
- `encryptData()` / `decryptData()` - Universal crypto utilities
|
||||
- `setConfig(key, value, { encrypt: true })` - Encrypted configuration storage
|
||||
- `brainy add --encrypt` - Per-item encryption via CLI
|
||||
- `brainy init --encryption` - Master encryption setup
|
||||
- Works in all environments: Browser, Node.js, Serverless
|
||||
|
||||
- **🐳 Container-Ready Deployment**
|
||||
- `BrainyData.preloadModel()` - Download models during container build
|
||||
- `BrainyData.warmup()` - Production-optimized initialization
|
||||
- Local-files-only mode for offline containers
|
||||
- GPU acceleration (WebGPU/CUDA) with CPU fallback
|
||||
|
||||
### 🔄 **CLI TRANSFORMATION**
|
||||
|
||||
#### Changed
|
||||
- **Simplified from 40+ commands to 9 clean commands:**
|
||||
- `brainy init` - Initialize with encryption/storage options
|
||||
- `brainy add` - Smart data addition (replaces addSmart, literal, neural modes)
|
||||
- `brainy search` - Unified search with filters
|
||||
- `brainy update` - Update existing data/metadata
|
||||
- `brainy delete` - Smart delete (soft delete by default)
|
||||
- `brainy chat` - AI conversations with your data
|
||||
- `brainy import` - Bulk data import
|
||||
- `brainy status` - Comprehensive system status
|
||||
- `brainy config` - Configuration management
|
||||
|
||||
### 🏗️ **ARCHITECTURE CONSOLIDATION**
|
||||
|
||||
#### Removed
|
||||
- **❌ Duplicate pipeline implementations** - 3 different Cortex classes → 1 unified
|
||||
- **❌ addSmart() method** - Functionality merged into `add()` with smart defaults
|
||||
- **❌ Legacy CLI commands** - 40+ commands → 9 focused commands
|
||||
- **❌ cortex-legacy.ts** - Replaced with clean unified implementation
|
||||
|
||||
#### Enhanced
|
||||
- **📦 Package Size Reduced 16%** - From 2.52MB to 2.1MB despite major feature additions
|
||||
- **🔄 Soft Delete by Default** - Preserves indexes, no reindexing needed
|
||||
- **⚡ All Scaling Optimizations Preserved** - 3-tier LRU cache, realtime streaming, memory modes
|
||||
|
||||
### ⚠️ **BREAKING CHANGES**
|
||||
- **CLI Commands** - Most existing CLI commands renamed/consolidated
|
||||
- **addSmart() method** - Removed, use `add()` with smart defaults
|
||||
- **Pipeline Classes** - Multiple pipeline types consolidated into one
|
||||
|
||||
### 🚀 **MIGRATION FROM 0.x**
|
||||
|
||||
```javascript
|
||||
// OLD (0.x)
|
||||
await brainy.addSmart(data, metadata)
|
||||
await brainy.searchSimilar(query, 10)
|
||||
|
||||
// NEW (1.0)
|
||||
await brainy.add(data, metadata) // Smart by default!
|
||||
await brainy.search(query, 10) // Same power, cleaner API
|
||||
```
|
||||
|
||||
```bash
|
||||
# OLD (0.x)
|
||||
brainy add-smart "data"
|
||||
brainy search-similar "query"
|
||||
|
||||
# NEW (1.0)
|
||||
brainy add "data" # Smart by default!
|
||||
brainy search "query" # Same power, simpler
|
||||
```
|
||||
|
||||
### 💬 **FEEDBACK & SUPPORT**
|
||||
|
||||
We'd love your feedback on this release candidate! Please:
|
||||
- 🐛 Report bugs via [GitHub Issues](https://github.com/soulcraftlabs/brainy/issues)
|
||||
- 💬 Share feedback via [GitHub Discussions](https://github.com/soulcraftlabs/brainy/discussions)
|
||||
|
||||
**Target Timeline**: 2-4 weeks of testing, then 1.0.0 final release.
|
||||
|
||||
## [0.57.0](https://github.com/soulcraftlabs/brainy/compare/v0.56.0...v0.57.0) (2025-08-08)
|
||||
|
||||
### ⚠ BREAKING CHANGES
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue