agentic-flow 1.9.0 → 1.9.2

package/agentic-flow/RELEASE_NOTES_v1.7.0.md

@@ -1,297 +0,0 @@
-# agentic-flow v1.7.0 - AgentDB Integration & Memory Optimization
-
-**Release Date**: 2025-01-24
-**Status**: ✅ Ready for Release
-**Backwards Compatibility**: 100% Compatible
-
----
-
-## 🎉 What's New
-
-### Major Features
-
-#### 1. AgentDB Integration (Issue #34)
-- ✅ **Proper Dependency**: Integrated AgentDB v1.3.9 as npm dependency
-- ✅ **29 MCP Tools**: Full Claude Desktop support via Model Context Protocol
-- ✅ **Code Reduction**: Removed 400KB of duplicated embedded code
-- ✅ **Automatic Updates**: Get AgentDB improvements automatically
-
-#### 2. Hybrid ReasoningBank
-- ✅ **10x Faster**: WASM-accelerated similarity computation
-- ✅ **Persistent Storage**: SQLite backend with frontier memory features
-- ✅ **Smart Backend Selection**: Automatic WASM/TypeScript switching
-- ✅ **Query Caching**: 90%+ hit rate on repeated queries
-
-#### 3. Advanced Memory System
-- ✅ **Auto-Consolidation**: Patterns automatically promoted to skills
-- ✅ **Episodic Replay**: Learn from past failures
-- ✅ **Causal Analysis**: "What-if" reasoning with evidence
-- ✅ **Skill Composition**: Combine learned skills intelligently
-
-#### 4. Shared Memory Pool
-- ✅ **56% Memory Reduction**: 800MB → 350MB for 4 agents
-- ✅ **Single Connection**: All agents share one SQLite connection
-- ✅ **Single Model**: One embedding model (vs ~150MB per agent)
-- ✅ **LRU Caching**: 10K embedding cache + 1K query cache
-
----
-
-## 📊 Performance Improvements
-
-### Before vs After Benchmarks
-
-| Metric | v1.6.4 | v1.7.0 | Improvement |
-|--------|--------|--------|-------------|
-| **Bundle Size** | 5.2MB | 4.8MB | **-400KB (-7.7%)** |
-| **Memory (4 agents)** | ~800MB | ~350MB | **-450MB (-56%)** |
-| **Vector Search** | 580ms | 5ms | **116x faster** |
-| **Batch Insert (1K)** | 14.1s | 100ms | **141x faster** |
-| **Cold Start** | 3.5s | 1.2s | **-2.3s (-65%)** |
-| **Pattern Retrieval** | N/A | 8ms | **150x faster** |
-
-### Real-World Impact
-
-**Scenario**: 4 concurrent agents running 1000 tasks each
-
-- **Before v1.7.0**:
-  - Memory: 800MB
-  - Search: 580ms × 4000 = 38 minutes
-  - Total Time: ~40 minutes
-
-- **After v1.7.0**:
-  - Memory: 350MB (saves ~450MB)
-  - Search: 5ms × 4000 = 20 seconds
-  - Total Time: ~25 seconds
-  - **Result**: 96x faster, 56% less memory
-
----
-
-## ✅ Backwards Compatibility
-
-### Zero Breaking Changes
-
-**All existing code works without modification:**
-
-```typescript
-// ✅ Old imports still work
-import { ReflexionMemory } from 'agentic-flow/agentdb';
-import { ReasoningBankEngine } from 'agentic-flow/reasoningbank';
-
-// ✅ All CLI commands work
-npx agentic-flow --agent coder --task "test"
-npx agentic-flow reasoningbank store "task" "success" 0.95
-npx agentic-flow agentdb init ./test.db
-
-// ✅ All MCP tools work
-npx agentic-flow mcp start
-
-// ✅ All API methods unchanged
-const rb = new ReasoningBankEngine();
-await rb.storePattern({ /* ... */ });
-```
-
-### What You Get Automatically
-
-Just upgrade and enjoy:
-- 116x faster search
-- 56% less memory
-- 400KB smaller bundle
-- 29 new MCP tools
-- All performance optimizations
-
----
-
-## 🚀 New Features (Optional)
-
-### 1. Hybrid ReasoningBank
-
-**Recommended for new code:**
-
-```typescript
-import { HybridReasoningBank } from 'agentic-flow/reasoningbank';
-
-const rb = new HybridReasoningBank({ preferWasm: true });
-
-// Store patterns
-await rb.storePattern({
-  sessionId: 'session-1',
-  task: 'implement authentication',
-  success: true,
-  reward: 0.95,
-  critique: 'Good error handling'
-});
-
-// Retrieve with caching
-const patterns = await rb.retrievePatterns('authentication', {
-  k: 5,
-  minSimilarity: 0.7,
-  onlySuccesses: true
-});
-
-// Learn strategies
-const strategy = await rb.learnStrategy('API optimization');
-console.log(strategy.recommendation);
-// "Strong evidence for success (10 similar patterns, +12.5% uplift)"
-```
-
-### 2. Advanced Memory System
-
-```typescript
-import { AdvancedMemorySystem } from 'agentic-flow/reasoningbank';
-
-const memory = new AdvancedMemorySystem();
-
-// Auto-consolidate successful patterns
-const { skillsCreated } = await memory.autoConsolidate({
-  minUses: 3,
-  minSuccessRate: 0.7,
-  lookbackDays: 7
-});
-console.log(`Created ${skillsCreated} skills`);
-
-// Learn from failures
-const failures = await memory.replayFailures('database query', 5);
-failures.forEach(f => {
-  console.log('What went wrong:', f.whatWentWrong);
-  console.log('How to fix:', f.howToFix);
-});
-
-// Causal "what-if" analysis
-const insight = await memory.whatIfAnalysis('add caching');
-console.log(insight.recommendation); // 'DO_IT', 'AVOID', or 'NEUTRAL'
-console.log(`Expected uplift: ${insight.avgUplift * 100}%`);
-
-// Skill composition
-const composition = await memory.composeSkills('API development', 5);
-console.log(composition.compositionPlan); // 'auth → validation → caching'
-console.log(`Success rate: ${composition.expectedSuccessRate * 100}%`);
-```
-
-### 3. Shared Memory Pool
-
-**For multi-agent systems:**
-
-```typescript
-import { SharedMemoryPool } from 'agentic-flow/memory';
-
-// All agents share same resources
-const pool = SharedMemoryPool.getInstance();
-const db = pool.getDatabase();  // Single SQLite connection
-const embedder = pool.getEmbedder();  // Single embedding model
-
-// Get statistics
-const stats = pool.getStats();
-console.log(stats);
-/*
-{
-  database: { size: 45MB, tables: 12 },
-  cache: { queryCacheSize: 856, embeddingCacheSize: 9234 },
-  memory: { heapUsed: 142MB, external: 38MB }
-}
-*/
-```
-
----
-
-## 📚 Migration Guide
-
-### Quick Start (Most Users)
-
-Just upgrade - everything works!
-
-```bash
-npm install agentic-flow@^1.7.0
-```
-
-### Advanced Users
-
-See [MIGRATION_v1.7.0.md](./MIGRATION_v1.7.0.md) for:
-- New API examples
-- Performance tuning tips
-- Tree-shaking optimizations
-- Custom configurations
-
----
-
-## 🐛 Bug Fixes
-
-- Fixed memory leaks in multi-agent scenarios
-- Improved embedding cache hit rate
-- Optimized database connection pooling
-- Resolved SQLite lock contention issues
-
----
-
-## 📦 Installation
-
-```bash
-# NPM
-npm install agentic-flow@^1.7.0
-
-# Yarn
-yarn add agentic-flow@^1.7.0
-
-# PNPM
-pnpm add agentic-flow@^1.7.0
-```
-
----
-
-## 🧪 Testing
-
-### Backwards Compatibility Tests
-
-```bash
-# Run full test suite
-npm test
-
-# Run backwards compatibility tests only
-npx vitest tests/backwards-compatibility.test.ts
-```
-
-### Performance Benchmarks
-
-```bash
-# Memory benchmark
-npm run bench:memory -- --agents 4
-
-# Search benchmark
-npm run bench:search -- --vectors 100000
-
-# Batch operations benchmark
-npm run bench:batch -- --count 1000
-```
-
----
-
-## 📖 Documentation
-
-- **Integration Plan**: [docs/AGENTDB_INTEGRATION_PLAN.md](./docs/AGENTDB_INTEGRATION_PLAN.md)
-- **Migration Guide**: [MIGRATION_v1.7.0.md](./MIGRATION_v1.7.0.md)
-- **Changelog**: [CHANGELOG.md](./CHANGELOG.md)
-- **GitHub Issue**: https://github.com/ruvnet/agentic-flow/issues/34
-
----
-
-## 🤝 Contributing
-
-See [GitHub Issue #34](https://github.com/ruvnet/agentic-flow/issues/34) for implementation details.
-
----
-
-## 🙏 Acknowledgments
-
-- **AgentDB**: https://agentdb.ruv.io - Frontier memory for AI agents
-- **Contributors**: @ruvnet
-
----
-
-## 📞 Support
-
-- **Issues**: https://github.com/ruvnet/agentic-flow/issues
-- **Tag**: `v1.7.0` for release-specific issues
-- **Docs**: https://github.com/ruvnet/agentic-flow#readme
-
----
-
-**Enjoy 116x faster performance with 100% backwards compatibility!** 🚀

package/agentic-flow/RELEASE_v1.7.1.md

@@ -1,327 +0,0 @@
-# agentic-flow v1.7.1 Release Notes
-
-**Release Date**: October 24, 2025
-**Status**: Full Implementation with Advanced Features
-
-## 🎯 Overview
-
-Version 1.7.1 delivers the **complete implementation** of advanced ReasoningBank features that were simplified in v1.7.0. This release includes full CausalRecall integration, NightlyLearner auto-consolidation, and comprehensive causal reasoning capabilities.
-
-## 🚀 New Features
-
-### 1. **Full CausalRecall Integration**
-
-HybridReasoningBank now uses utility-based reranking for intelligent pattern retrieval:
-
-```typescript
-// Utility formula: U = α·similarity + β·uplift − γ·latency
-// Default weights: α=0.6, β=0.3, γ=0.1
-
-import { HybridReasoningBank } from 'agentic-flow/reasoningbank';
-
-const rb = new HybridReasoningBank({ preferWasm: true });
-
-// Store patterns with causal tracking
-await rb.storePattern({
-  sessionId: 'session-1',
-  task: 'API optimization',
-  input: 'Slow endpoint',
-  output: 'Cached with Redis',
-  critique: 'Significant performance improvement',
-  success: true,
-  reward: 0.95,
-  latencyMs: 120,
-  tokensUsed: 1500
-});
-
-// Retrieve with causal ranking
-const patterns = await rb.retrievePatterns('optimize API', {
-  k: 5,
-  minReward: 0.8,
-  onlySuccesses: true
-});
-
-// Each pattern includes:
-// - similarity: Vector similarity score
-// - uplift: Causal improvement measure
-// - utilityScore: Combined ranking metric
-```
-
-### 2. **Causal Memory Graph**
-
-Automatic tracking of causal relationships between actions and outcomes:
-
-```typescript
-// Causal edges are automatically recorded for successful patterns
-// Tracks: p(y|do(x)) intervention-based causality
-
-await rb.storePattern({
-  sessionId: 'session-2',
-  task: 'Add caching',
-  success: true,
-  reward: 0.92
-  // ➜ Creates causal edge linking action → outcome
-});
-```
-
-### 3. **Strategy Learning with Task Statistics**
-
-Learn optimal strategies from historical patterns with statistical confidence:
-
-```typescript
-const strategy = await rb.learnStrategy('Error handling');
-
-console.log(strategy);
-// {
-//   patterns: [...],  // Successful historical patterns
-//   causality: {
-//     action: 'Error handling',
-//     avgReward: 0.88,
-//     avgUplift: 0.15,      // +15% improvement trend
-//     confidence: 0.82,      // High statistical confidence
-//     evidenceCount: 12,     // 12 historical attempts
-//     recommendation: 'DO_IT'
-//   },
-//   confidence: 0.85,
-//   recommendation: 'Strong evidence for success (12 patterns, +15.0% uplift)'
-// }
-```
-
-### 4. **Auto-Consolidation with NightlyLearner**
-
-Automatic discovery of causal patterns and skill consolidation:
-
-```typescript
-import { AdvancedMemorySystem } from 'agentic-flow/reasoningbank';
-
-const memory = new AdvancedMemorySystem();
-
-// Run automated learning cycle
-const result = await memory.autoConsolidate({
-  minUses: 3,
-  minSuccessRate: 0.7,
-  lookbackDays: 30
-});
-
-console.log(result);
-// {
-//   skillsCreated: 5,
-//   causalEdgesCreated: 12,
-//   patternsAnalyzed: 45,
-//   executionTimeMs: 1250,
-//   recommendations: [
-//     'High-performing pattern detected: API caching (92% success rate)',
-//     'Causal relationship confirmed: caching → latency reduction',
-//     '5 new skills consolidated from frequent patterns'
-//   ]
-// }
-```
-
-### 5. **Episodic Replay - Learning from Failures**
-
-Analyze past failures to generate actionable recommendations:
-
-```typescript
-const failures = await memory.replayFailures('database migration', 5);
-
-failures.forEach(failure => {
-  console.log('Critique:', failure.critique);
-  console.log('What went wrong:', failure.whatWentWrong);
-  // ['Low success rate observed', 'High latency detected']
-
-  console.log('How to fix:', failure.howToFix);
-  // ['Review similar successful patterns', 'Optimize for lower latency']
-
-  console.log('Similar failures:', failure.similarFailures);
-  // 3
-});
-```
-
-### 6. **What-If Causal Analysis**
-
-Predict outcomes before taking actions:
-
-```typescript
-const analysis = await memory.whatIfAnalysis('Enable caching');
-
-console.log(analysis);
-// {
-//   action: 'Enable caching',
-//   avgReward: 0.93,
-//   avgUplift: 0.22,             // +22% expected improvement
-//   confidence: 0.88,
-//   evidenceCount: 8,
-//   recommendation: 'DO_IT',
-//   expectedImpact: 'Highly beneficial: Expected +22.0% improvement'
-// }
-```
-
-### 7. **Skill Composition**
-
-Automatically compose multiple learned skills for complex tasks:
-
-```typescript
-const composition = await memory.composeSkills('Build scalable API', 5);
-
-console.log(composition);
-// {
-//   availableSkills: [
-//     { name: 'api_caching', successRate: 0.95, uses: 12 },
-//     { name: 'rate_limiting', successRate: 0.88, uses: 8 },
-//     { name: 'auth_flow', successRate: 0.92, uses: 10 }
-//   ],
-//   compositionPlan: 'api_caching → rate_limiting → auth_flow',
-//   expectedSuccessRate: 0.91
-// }
-```
-
-## 📊 Performance Improvements
-
-- **116x faster** vector search with WASM acceleration (vs TypeScript fallback)
-- **56% memory reduction** with SharedMemoryPool singleton pattern
-- **Intelligent caching** with 60-second TTL for frequent queries
-- **Lazy WASM loading** with graceful fallback to TypeScript
-
-## 🔧 Technical Implementation
-
-### API Alignment
-
-All implementations now use **agentdb v1.3.9 API** correctly:
-
-- ✅ `ReflexionMemory.getTaskStats()` for strategy learning
-- ✅ `CausalRecall.recall()` with utility-based reranking
-- ✅ `CausalMemoryGraph.addCausalEdge()` for causal tracking
-- ✅ `NightlyLearner.run()` for automated discovery
-- ✅ Direct imports from `agentdb/controllers/*` (with patch)
-
-### Breaking Changes from v1.7.0
-
-**None** - v1.7.1 is fully backwards compatible with v1.7.0. All simplified implementations have been replaced with full versions while maintaining the same API surface.
-
-### Module Structure
-
-```
-src/reasoningbank/
-├── HybridBackend.ts          # Full CausalRecall integration
-├── AdvancedMemory.ts         # NightlyLearner + high-level ops
-├── backend-selector.ts        # Automatic backend selection
-├── agentdb-adapter.ts         # AgentDB integration layer
-└── index.ts                   # Public exports
-```
-
-## 🐛 Known Issues & Workarounds
-
-### AgentDB Import Resolution
-
-**Issue**: agentdb v1.3.9 has missing `.js` extensions in `controllers/index.js`
-
-**Workaround**: Apply patch automatically during `npm install`:
-
-```bash
-# Post-install patch applied via patches/agentdb-fix-imports.patch
-# Adds .js extensions to:
-# - export { ReflexionMemory } from './ReflexionMemory.js';
-# - export { SkillLibrary } from './SkillLibrary.js';
-# - export { EmbeddingService } from './EmbeddingService.js';
-```
-
-**Status**: Reported to agentdb maintainers. Patch is non-invasive and safe.
-
-## 📚 Migration Guide
-
-### From v1.7.0 to v1.7.1
-
-**No code changes required!** v1.7.1 replaces simplified implementations with full versions while maintaining the exact same API.
-
-### Example: Strategy Learning
-
-```typescript
-// v1.7.0 (simplified)
-const strategy = await rb.learnStrategy('task');
-// { patterns: [...], causality: {...}, confidence: 0.6, recommendation: '...' }
-
-// v1.7.1 (full implementation)
-const strategy = await rb.learnStrategy('task');
-// Same API! But now includes:
-// - Real causal analysis from ReflexionMemory.getTaskStats()
-// - Improvement trends and confidence scores
-// - Evidence-based recommendations
-```
-
-### Example: Auto-Consolidation
-
-```typescript
-// v1.7.0 (basic consolidation)
-const result = await rb.autoConsolidate(3, 0.7, 30);
-// { skillsCreated: X }
-
-// v1.7.1 (with NightlyLearner)
-const result = await memory.autoConsolidate({ minUses: 3, minSuccessRate: 0.7 });
-// {
-//   skillsCreated: X,
-//   causalEdgesCreated: Y,        // NEW: Causal discovery
-//   patternsAnalyzed: Z,           // NEW: Pattern analysis
-//   executionTimeMs: T,
-//   recommendations: [...]         // NEW: Actionable insights
-// }
-```
-
-## 🧪 Testing
-
-Comprehensive test suite added in `tests/reasoningbank/`:
-
-- `integration.test.ts` - 20 integration tests covering all features
-- `hybrid-backend.test.ts` - Unit tests for HybridReasoningBank (vitest-ready)
-- `advanced-memory.test.ts` - Unit tests for AdvancedMemorySystem (vitest-ready)
-
-```bash
-# Run tests
-npm test
-
-# Run specific test suite
-npx vitest run tests/reasoningbank/integration.test.ts
-```
-
-## 📖 Documentation
-
-- [HybridBackend API](./src/reasoningbank/HybridBackend.ts) - Full source with JSDoc
-- [AdvancedMemory API](./src/reasoningbank/AdvancedMemory.ts) - Full source with JSDoc
-- [TESTING.md](./TESTING.md) - Test results and validation
-- [CHANGELOG.md](./CHANGELOG.md) - Detailed version history
-
-## 🔮 Future Enhancements (v1.8.0)
-
-- **WASM SIMD Optimization**: Full Rust implementation with SIMD acceleration
-- **Distributed Causal Discovery**: Multi-node causal inference
-- **Explainable Recall**: Provenance certificates with Merkle proofs
-- **Streaming Patterns**: Real-time pattern updates and notifications
-- **Cross-Session Learning**: Persistent learning across multiple sessions
-
-## 🙏 Credits
-
-- **AgentDB v1.3.9**: Frontier memory systems integration
-- **ReasoningBank**: Self-learning AI with experience replay
-- **agentic-flow community**: Testing and feedback
-
-## 📦 Installation
-
-```bash
-npm install agentic-flow@1.7.1
-# or
-npm install agentic-flow@latest
-
-# Post-install: agentdb patch applied automatically
-```
-
-## 🔗 Resources
-
-- **GitHub**: https://github.com/ruvnet/agentic-flow
-- **npm**: https://www.npmjs.com/package/agentic-flow
-- **AgentDB**: https://www.npmjs.com/package/agentdb
-- **Issues**: https://github.com/ruvnet/agentic-flow/issues
-
----
-
-**Status**: ✅ Production Ready
-**Compatibility**: Node.js 18+, TypeScript 5+
-**License**: MIT