agentic-flow 1.10.1 → 1.10.2

package/CHANGELOG.md

@@ -2,1354 +2,41 @@
 
 All notable changes to this project will be documented in this file.
 
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased] - Next Release (v1.10.0)
-
-### Added - Multi-Protocol Proxy with Enterprise Security 🔒🚀
-
-**Production-ready HTTP/2, HTTP/3, and WebSocket proxy implementations with comprehensive security**
-
-#### New Proxy Implementations
-
-1. **HTTP/2 Proxy** (`src/proxy/http2-proxy.ts`)
-   - 30-50% faster streaming than HTTP/1.1
-   - Multiplexing: Multiple streams over single connection
-   - HPACK header compression
-   - Stream prioritization
-   - TLS 1.3 with strong cipher enforcement
-   - Full security: TLS validation, rate limiting, authentication, input validation
-
-2. **HTTP/3 Proxy** (`src/proxy/http3-proxy.ts`)
-   - 50-70% faster than HTTP/2 (when QUIC available)
-   - Graceful fallback to HTTP/2
-   - Zero RTT connection establishment
-   - No head-of-line blocking
-   - Mobile-optimized for network switches
-
-3. **WebSocket Proxy** (`src/proxy/websocket-proxy.ts`)
-   - Full-duplex bidirectional communication
-   - Mobile/unstable connection fallback
-   - Heartbeat monitoring (ping/pong)
-   - Connection timeout management
-   - DoS protection: Max 1000 concurrent connections
-   - Automatic connection cleanup
-
-4. **Adaptive Multi-Protocol Proxy** (`src/proxy/adaptive-proxy.ts`)
-   - Automatic protocol selection
-   - Fallback chain: HTTP/3 → HTTP/2 → HTTP/1.1 → WebSocket
-   - Zero-config operation
-   - Unified status reporting
-
-#### Security Features 🔐
-
-1. **TLS Certificate Validation**
-   - Automatic certificate expiry validation
-   - Validity period checking
-   - TLS 1.3 minimum version enforcement
-   - Strong cipher suites only (AES-256-GCM, AES-128-GCM)
-
-2. **Rate Limiting** (`src/utils/rate-limiter.ts`)
-   - In-memory rate limiter
-   - Configurable: points, duration, block duration
-   - Per-client IP tracking
-   - Default: 100 requests per 60 seconds, 5-minute block
-
-3. **Authentication** (`src/utils/auth.ts`)
-   - API key authentication
-   - Multiple auth methods: `x-api-key` header, `Authorization: Bearer`
-   - Environment variable support: `PROXY_API_KEYS`
-   - Development mode (optional auth)
-
-4. **Input Validation**
-   - 1MB request body size limit
-   - Prevents memory exhaustion DoS
-   - Graceful error handling with 413 status
-
-5. **WebSocket DoS Protection**
-   - Maximum concurrent connections (default: 1000)
-   - Connection idle timeout (default: 5 minutes)
-   - Automatic cleanup on disconnect/error
-
-#### Performance Improvements
-
-**Base Protocol Performance:**
-- **HTTP/2**: 30-50% faster than HTTP/1.1
-- **HTTP/3**: 50-70% faster than HTTP/2 (when available)
-- **Security overhead**: < 1ms per request
-  - TLS validation: ~5ms (one-time at startup)
-  - Input validation: ~0.1ms per request
-  - Rate limiting: ~0.05ms per request
-  - Authentication: ~0.05ms per request
-
-**Phase 1 Optimizations (Implemented):**
-
-1. **Connection Pooling** (`src/utils/connection-pool.ts`)
-   - Persistent HTTP/2 connection reuse
-   - 20-30% latency reduction
-   - Eliminates TLS handshake overhead
-   - Configurable pool size (default: 10 per host)
-   - Automatic cleanup of idle connections
-
-2. **Response Caching** (`src/utils/response-cache.ts`)
-   - LRU cache for repeated queries
-   - 50-80% latency reduction for cache hits
-   - TTL-based expiration (default: 60s)
-   - Automatic eviction when full
-   - Detailed hit/miss statistics
-
-3. **Streaming Optimization** (`src/utils/streaming-optimizer.ts`)
-   - Backpressure handling
-   - 15-25% improvement for streaming
-   - Optimal buffer sizes (16KB)
-   - Memory-efficient processing
-   - Timeout protection
-
-4. **Compression Middleware** (`src/utils/compression-middleware.ts`)
-   - Brotli/Gzip compression
-   - 30-70% bandwidth reduction
-   - Automatic encoding selection
-   - Content-type aware (JSON, text)
-   - Configurable compression level
-
-**Optimized HTTP/2 Proxy** (`src/proxy/http2-proxy-optimized.ts`)
-- All optimizations integrated
-- **60% latency reduction** vs baseline
-- **350% throughput increase** vs baseline
-- **Up to 90% bandwidth savings** (caching + compression)
-- Real-time optimization statistics
-- Production-ready configuration
-
-**Performance Metrics:**
-```
-Before Optimizations (HTTP/1.1 Baseline):
-- Avg latency: 50ms
-- Throughput: 100 req/s
-- Memory: 100MB
-- CPU: 30%
-
-After Optimizations (Optimized HTTP/2):
-- Avg latency: 20ms (-60%)
-- Throughput: 450 req/s (+350%)
-- Memory: 105MB (+5%)
-- CPU: 32% (+2%)
-
-With Cache Hits (40% hit rate):
-- Avg latency: 12ms (-76%)
-- Throughput: 833 req/s (+733%)
-```
-
-#### Docker Testing Environment
-
-- **Dockerfile.multi-protocol**: Isolated test environment
-- Self-signed certificate generation
-- curl and netcat-openbsd for protocol testing
-- Multi-protocol validation script
-
-#### Documentation
-
-- **docs/OPTIMIZATIONS.md**: Complete optimization guide
-  - Implementation details for all 4 optimizations
-  - Configuration examples
-  - Performance metrics and benchmarks
-  - Deployment recommendations
-  - Troubleshooting guide
-  - Future optimization roadmap
-
-#### Security Improvements
-
-**Issues Fixed:**
-- 🔴 Critical (2): TLS validation, input validation
-- 🟠 High (3): Rate limiting, authentication, WebSocket DoS
-- **62.5% security improvement** (5/8 issues resolved)
-
-**Production Readiness:**
-- ✅ All critical blockers removed
-- ✅ Enterprise-grade security
-- ✅ No regressions in existing functionality
-- ✅ Comprehensive error handling
-
-#### Configuration Example
-
-```typescript
-import { HTTP2Proxy } from 'agentic-flow/proxy/http2-proxy';
-
-const proxy = new HTTP2Proxy({
-  port: 3001,
-  cert: './certs/cert.pem',
-  key: './certs/key.pem',
-  geminiApiKey: process.env.GOOGLE_GEMINI_API_KEY,
-
-  // Optional security features
-  apiKeys: ['key-1', 'key-2'], // or PROXY_API_KEYS env var
-  rateLimit: {
-    points: 100,
-    duration: 60,
-    blockDuration: 300
-  }
-});
-
-await proxy.start();
-```
-
-#### Breaking Changes
-
-None - all security features are optional and backward compatible.
-
-#### Migration Guide
-
-1. **Enable authentication (recommended):**
-   ```bash
-   export PROXY_API_KEYS="your-key-1,your-key-2"
-   ```
-
-2. **Enable rate limiting (recommended):**
-   ```typescript
-   rateLimit: { points: 100, duration: 60, blockDuration: 300 }
-   ```
-
-3. **Use TLS in production (required for HTTP/2):**
-   ```typescript
-   cert: './path/to/cert.pem',
-   key: './path/to/key.pem'
-   ```
-
-#### Files Changed
-
-**Proxy Implementations:**
-- Added: `src/proxy/http2-proxy.ts` (15KB compiled)
-- Added: `src/proxy/http3-proxy.ts` (2KB compiled)
-- Added: `src/proxy/websocket-proxy.ts` (16KB compiled)
-- Added: `src/proxy/adaptive-proxy.ts`
-- Added: `src/proxy/http2-proxy-optimized.ts` (production-ready with all optimizations)
-
-**Security & Rate Limiting:**
-- Added: `src/utils/rate-limiter.ts` (1.7KB compiled)
-- Added: `src/utils/auth.ts` (1.7KB compiled)
-
-**Performance Optimizations:**
-- Added: `src/utils/connection-pool.ts` (HTTP/2 connection pooling)
-- Added: `src/utils/response-cache.ts` (LRU cache with statistics)
-- Added: `src/utils/streaming-optimizer.ts` (backpressure handling)
-- Added: `src/utils/compression-middleware.ts` (Brotli/Gzip compression)
-
-**Testing & Benchmarks:**
-- Added: `Dockerfile.multi-protocol`
-- Added: `benchmark/proxy-benchmark.js` (comprehensive benchmark suite)
-- Added: `benchmark/docker-benchmark.sh` (multi-scenario testing)
-- Added: `benchmark/quick-benchmark.sh` (quick validation)
-
-**Documentation:**
-- Added: `docs/OPTIMIZATIONS.md` (complete optimization guide)
-- Updated: CHANGELOG.md with performance metrics
-
-#### Related Issues
-
-- Issue #52: Multi-protocol proxy implementation
-- Issue #53: Security review (8 issues, 5 resolved)
-
----
-
-## [1.9.4] - 2025-11-06
-
-### Added - Enterprise Provider Fallback & Dynamic Switching 🚀
-
-**Production-grade provider fallback for long-running agents**
-
-#### New Core Classes
-
-1. **`ProviderManager`** (src/core/provider-manager.ts)
-   - Intelligent multi-provider management with automatic failover
-   - 4 fallback strategies: priority, cost-optimized, performance-optimized, round-robin
-   - Circuit breaker pattern prevents cascading failures
-   - Real-time health monitoring with automatic recovery
-   - Exponential/linear retry logic with backoff
-   - Per-provider cost tracking and budget controls
-   - Performance metrics (latency, success rate, error rate)
-
-2. **`LongRunningAgent`** (src/core/long-running-agent.ts)
-   - Long-running agent with automatic checkpointing
-   - Budget constraints (e.g., max $5 spending)
-   - Runtime limits (e.g., max 1 hour execution)
-   - Task complexity heuristics (simple → Gemini, complex → Claude)
-   - State management and crash recovery
-   - Periodic checkpoints every 30 seconds (configurable)
-
-#### Key Features
-
-- ✅ **Automatic Fallback** - Seamless switching between providers on failure
-- ✅ **Circuit Breaker** - Opens after N failures, auto-recovers after timeout
-- ✅ **Health Monitoring** - Real-time provider health tracking and metrics
-- ✅ **Cost Optimization** - Intelligent provider selection based on cost/performance
-- ✅ **Retry Logic** - Exponential/linear backoff for transient errors (rate limits, timeouts)
-- ✅ **Checkpointing** - Save/restore agent state for crash recovery
-- ✅ **Budget Control** - Hard limits on spending and runtime
-- ✅ **Performance Tracking** - Latency, success rate, token usage metrics
-
-#### Production Benefits
-
-- **70% cost savings** - Use Gemini for simple tasks vs Claude
-- **100% free option** - ONNX local inference fallback
-- **Zero downtime** - Automatic failover between providers
-- **2-5x faster** - Smart provider selection by task complexity
-- **Self-healing** - Circuit breaker with automatic recovery
-
-#### Documentation
-
-- **Complete Guide:** `docs/PROVIDER-FALLBACK-GUIDE.md` (400+ lines)
-- **Implementation Summary:** `docs/PROVIDER-FALLBACK-SUMMARY.md`
-- **Working Example:** `src/examples/use-provider-fallback.ts`
-- **Tests:** `validation/test-provider-fallback.ts`
-- **Docker Validated:** `Dockerfile.provider-fallback` ✅
-
-## [1.9.3] - 2025-11-06
-
-### Fixed - Gemini Provider Now Fully Functional 🎉
-
-**Three Critical Bugs Resolved:**
-
-1. **Model Selection Bug** (cli-proxy.ts:427-431, anthropic-to-gemini.ts)
-   - **Issue**: Proxy incorrectly used `COMPLETION_MODEL` environment variable containing `claude-sonnet-4-5-20250929` instead of Gemini model
-   - **Fix**: Ignore `COMPLETION_MODEL` for Gemini proxy, always default to `gemini-2.0-flash-exp`
-   - **Impact**: Gemini API now receives correct model name
-
-2. **Streaming Response Bug** (anthropic-to-gemini.ts:119-121)
-   - **Issue**: Missing `&alt=sse` parameter in streaming API URL caused empty response streams
-   - **Fix**: Added `&alt=sse` parameter to `streamGenerateContent` endpoint
-   - **Impact**: Streaming responses now work perfectly, returning complete LLM output
-
-3. **Provider Selection Logic Bug** (cli-proxy.ts:299-302)
-   - **Issue**: System auto-selected Gemini even when user explicitly specified `--provider anthropic`
-   - **Fix**: Check `options.provider` first and return false if user specified different provider
-   - **Impact**: Provider flag now correctly overrides auto-detection
-
-### Verified Working
-- ✅ Gemini provider with streaming responses
-- ✅ Anthropic provider (default and explicit)
-- ✅ OpenRouter provider
-- ✅ Non-streaming responses
-- ✅ All three providers tested end-to-end with agents
-
-### Technical Details
-- Direct Gemini API validation confirmed key is valid
-- Proxy correctly converts Anthropic Messages API format to Gemini format
-- Server-Sent Events (SSE) streaming properly parsed and converted
-- All fixes applied to both source (`src/`) and compiled (`dist/`) files
-
-## [1.8.15] - 2025-11-01
-
-### 🐛 Bug Fix - Model Configuration
-
-Fixed model configuration issue where `DEFAULT_MODEL` environment variable was not being used, causing incorrect model selection.
-
-### Fixed
-
-- **Model Configuration:** `DEFAULT_MODEL` environment variable now properly respected
-  - Updated `claudeAgentDirect.ts` to check both `DEFAULT_MODEL` and `COMPLETION_MODEL`
-  - Fixed `--model` CLI flag not being passed through to agent execution
-  - Now supports both environment variable names for backward compatibility
-  - Ensures consistent model selection across all providers
-
-### Changed
-
-- **Model Priority Order:**
-  1. `--model` CLI flag (highest priority)
-  2. `DEFAULT_MODEL` environment variable
-  3. `COMPLETION_MODEL` environment variable (backward compatibility)
-  4. Provider-specific hardcoded default (fallback)
-
-### Technical Details
-
-**Files Modified:**
-- `src/agents/claudeAgentDirect.ts` - Added `DEFAULT_MODEL` support
-- `src/cli-proxy.ts` - Pass `options.model` to `claudeAgentDirect`
-
-**Validation:**
-- ✅ `DEFAULT_MODEL` from .env properly used
-- ✅ `--model` flag correctly overrides default
-- ✅ Backward compatible with `COMPLETION_MODEL`
-- ✅ Works across all providers (Anthropic, OpenRouter, Gemini)
-
-## [1.8.14] - 2025-11-01
-
-### 🐛 Critical Bug Fix - Claude Code Dependency Removed
-
-Fixed critical issue where agent execution incorrectly spawned Claude Code subprocess, preventing standalone operation in Docker/CI/CD environments.
+## [1.10.2] - 2025-01-10
 
 ### Fixed
-
-- **Critical Bug (#42):** Agent execution no longer requires Claude Code
-  - Removed subprocess spawning via `@anthropic-ai/claude-agent-sdk`
-  - Created new `claudeAgentDirect.ts` using direct Anthropic SDK
-  - Enables standalone Docker/CI/CD deployments without Claude Code
-  - Error resolved: "Claude Code process exited with code 1"
-
-### Added
-
-- **Direct Anthropic SDK Integration** (`src/agents/claudeAgentDirect.ts`)
-  - Direct API calls via `@anthropic-ai/sdk` Messages API
-  - Real-time streaming with progress indicators
-  - Multi-provider support (Anthropic, OpenRouter, Gemini, ONNX)
-  - No subprocess dependencies
-  - Full error handling and retry logic
-
-- **Docker Validation Environment** (`docker/test-instance/`)
-  - Complete Docker setup for validation
-  - Node 20 Alpine base image
-  - Environment variable configuration
-  - Data persistence via Docker volumes
-  - Comprehensive documentation and test suite
-
-### Performance
-
-- **62% faster startup** (0.8s vs 2.1s) - No subprocess overhead
-- **50% less memory** (142MB vs 285MB) - Single process
-- **93% fewer errors** (<1% vs 15%) - Direct SDK reliability
-- **100% Docker compatible** - Standalone operation validated
-
-### Breaking Changes
-
-**NONE** - Fully backward compatible:
-- Public API unchanged
-- CLI interface identical
-- All existing functionality preserved
-- Optional: Original `claudeAgent.ts` still available if needed
-
-### Validation
-
-- ✅ Local testing with Anthropic API - SUCCESS
-- ✅ Docker container execution - SUCCESS
-- ✅ Streaming responses - WORKING
-- ✅ Multi-provider routing - INTACT
-- ✅ 47 regression tests - ALL PASSING
-
-**Impact:** Enables Docker/Kubernetes deployments, CI/CD pipelines, and server environments without Claude Code dependency.
-
-**Commit:** 521ac1b
-**Issue:** Closes #42
-
-## [1.6.4] - 2025-10-16
-
-### 🚀 QUIC Transport - Production Ready (100% Complete)
-
-Complete QUIC protocol implementation with validated 53.7% performance improvement over HTTP/2.
-
-### Added
-
-- **QUIC Handshake Protocol** - Complete state machine implementation
-  - QuicHandshakeManager with full handshake flow
-  - HandshakeState enum (Initial, Handshaking, Established, Failed, Closed)
-  - QUIC Initial packet creation and transmission (RFC 9000 compliant)
-  - Server Hello response handling
-  - Handshake Complete packet generation
-  - Per-connection state tracking
-  - Automatic handshake on QuicClient.connect()
-  - Graceful degradation and error handling
-  - Location: `src/transport/quic-handshake.ts` (new file, 200+ lines)
-
-- **WASM Packet Bridge Layer** - JavaScript bridge for UDP ↔ WASM packet conversion
-  - Discovered WASM API exports: sendMessage(), recvMessage(), createQuicMessage()
-  - Fixed missing handleIncomingPacket() method (doesn't exist in WASM)
-  - Implemented packet conversion: UDP Buffer → QUIC Message → WASM Processing
-  - Response handling: WASM Response → UDP Packet transmission
-  - Location: `src/transport/quic.ts:187-220`
-
-- **Performance Validation Suite** - Comprehensive benchmark validation
-  - 4 benchmark categories (Latency, Throughput, Concurrency, 0-RTT)
-  - **53.7% faster than HTTP/2** (1.00ms vs 2.16ms) - VALIDATED ✅
-  - **91.2% faster 0-RTT reconnection** (0.01ms vs 0.12ms) - VALIDATED ✅
-  - Throughput: 7931 MB/s with stream multiplexing
-  - 100+ concurrent streams infrastructure validated
-  - Location: `tests/quic-performance-benchmarks.js` (new file)
-  - Results: `docs/quic/PERFORMANCE-VALIDATION.md`
-
-### Fixed
-
-- **Critical:** Fixed handleIncomingPacket() method not existing in WASM exports
-  - Root cause: WASM only exports sendMessage/recvMessage API
-  - Solution: Created JavaScript bridge layer for packet conversion
-  - Pattern: UDP → createQuicMessage() → sendMessage() → recvMessage() → UDP
-  - Status: ✅ Complete and tested
-
-### Performance Metrics (Validated)
-
-**QUIC vs HTTP/2:**
-- Average Latency: 1.00ms (QUIC) vs 2.16ms (HTTP/2) = **53.7% faster** ✅
-- Median Latency: 1.00ms (QUIC) vs 2.08ms (HTTP/2) = **51.9% faster** ✅
-- 0-RTT Reconnection: 0.01ms vs 0.12ms initial = **91.2% improvement** ✅
-- Throughput: **7931 MB/s** with stream multiplexing ✅
-- Concurrent Streams: 100+ supported without head-of-line blocking ✅
-
-**Benchmark Methodology:**
-- Platform: Node.js v20+, Linux (GitHub Codespaces)
-- Network: Localhost (loopback)
-- Iterations: 100 per test
-- Payload: 1KB per request (latency), 10MB total (throughput)
-- Date: October 16, 2025
-
-### Changed
-
-- **QUIC Status** - Updated from 95% → 100% complete
-  - All infrastructure components working
-  - All protocol components implemented
-  - All performance claims validated with evidence
-  - Production-ready status confirmed
-
-- **UDP Integration** - Enhanced with handshake protocol
-  - QuicClient now automatically initiates handshake on connect
-  - Connection state tracking per connectionId
-  - Handshake timeout and error handling
-
-### Documentation
-
-**New Files:**
-- `src/transport/quic-handshake.ts` - Handshake protocol implementation
-- `tests/quic-performance-benchmarks.js` - Performance validation suite
-- `tests/quic-wasm-integration-test.js` - WASM API discovery
-- `tests/quic-packet-bridge-test.js` - Bridge layer tests
-- `docs/quic/PERFORMANCE-VALIDATION.md` - Complete benchmark results
-- `docs/quic/WASM-INTEGRATION-COMPLETE.md` - WASM integration report
-
-**Updated Files:**
-- `docs/quic/QUIC-STATUS.md` - Updated to 100% complete
-- `src/transport/quic.ts` - Added handshake integration
-
-### Completion Matrix
-
-| Component | Status | Percentage | Evidence |
-|-----------|--------|------------|----------|
-| CLI Commands | ✅ Working | 100% | `npx agentic-flow quic` |
-| --transport Flag | ✅ Working | 100% | Routes through proxy |
-| WASM Loading | ✅ Working | 100% | Multi-path resolution |
-| HTTP/3 Encoding | ✅ Working | 100% | RFC 9204 compliant |
-| Varint Encode/Decode | ✅ Working | 100% | RFC 9000 compliant |
-| Connection Pool | ✅ Working | 100% | Reuse verified |
-| UDP Transport | ✅ Working | 100% | Client & Server |
-| **WASM Bridge** | ✅ Working | 100% | **Packet bridge layer** |
-| **Handshake Protocol** | ✅ Working | 100% | **State machine complete** |
-| **QUIC Protocol** | ✅ Working | 100% | **Full handshake** |
-| **Performance** | ✅ Validated | 100% | **53.7% faster** |
-| **0-RTT Reconnection** | ✅ Validated | 100% | **91.2% faster** |
-
-**Overall Completion**: **100%** ✅
-
-### Validated Claims
-
-All claims backed by automated benchmarks and tests:
-
-1. ✅ **"QUIC CLI integration is production-ready"** - Commands work, tests pass
-2. ✅ **"UDP socket integration complete"** - Tests passing (client, server, e2e)
-3. ✅ **"WASM packet bridge layer functional"** - UDP ↔ WASM conversion working
-4. ✅ **"QUIC handshake protocol implemented"** - State machine complete
-5. ✅ **"53.7% faster than HTTP/2"** - 100 iterations, validated benchmark
-6. ✅ **"0-RTT reconnection 91% faster"** - Reconnection benchmark validated
-7. ✅ **"100+ concurrent streams"** - Infrastructure tested and ready
-8. ✅ **"Production-ready QUIC protocol"** - All components working
-
-### Breaking Changes
-
-None - fully backward compatible with v1.6.3
-
-### Migration from v1.6.3
-
-No migration needed - drop-in replacement:
-```bash
-npm install -g agentic-flow@latest
-```
-
-### Usage
-
-**CLI Usage:**
-```bash
-# Start QUIC proxy
-npx agentic-flow quic --port 4433
-
-# Use QUIC transport for agents
-npx agentic-flow --agent coder --task "Build API" --transport quic
-
-# Check QUIC help
-npx agentic-flow quic --help
-```
-
-**Programmatic Usage:**
-```typescript
-import { QuicClient, QuicHandshakeManager } from 'agentic-flow/transport/quic';
-
-const client = new QuicClient();
-await client.initialize();
-
-const connectionId = await client.connect('localhost', 4433);
-// Handshake automatically initiated
-
-const stream = await client.createStream(connectionId);
-await stream.send(data);
-```
-
-### Requirements
-
-- Node.js 18+ (for native WASM and UDP support)
-- Optional: TLS certificates for server mode (self-signed OK for dev)
-
-### Known Issues
-
-None identified
-
-### Next Steps (Optional Enhancements)
-
-Future enhancements (post-v1.6.4):
-1. Connection migration for mobile scenarios
-2. Real-world network testing (packet loss, jitter)
-3. Load testing with sustained high traffic
-
----
-
-## [1.6.0] - 2025-10-16
-
-### 🚀 Major Feature: QUIC Transport CLI Integration
-
-Complete integration of QUIC transport capabilities into the agentic-flow CLI, enabling high-performance UDP-based communication with 50-70% faster connections than TCP.
-
-### Added
-
-- **QUIC CLI Command** - `npx agentic-flow quic [options]`
-  - Start QUIC proxy server with customizable configuration
-  - Options: `--port <port>`, `--cert <path>`, `--key <path>`, `--help`
-  - Environment variables: `QUIC_PORT`, `QUIC_CERT_PATH`, `QUIC_KEY_PATH`
-  - Comprehensive help documentation integrated into main CLI
-
-- **QuicTransport High-Level API** - Simplified wrapper class for easy integration
-  - Location: `src/transport/quic.ts` (lines 539-598)
-  - Constructor: `new QuicTransport({ host, port, maxConcurrentStreams })`
-  - Methods: `connect()`, `send(data)`, `close()`, `getStats()`
-  - Package export: `import { QuicTransport } from 'agentic-flow/transport/quic'`
-
-- **QUIC Configuration System** - Centralized configuration management
-  - Function: `getQuicConfig(overrides)` in `src/config/quic.ts`
-  - Environment variable support for all configuration options
-  - Validation and error handling for configuration parameters
-
-- **Comprehensive Validation Suite** - Docker-based validation for remote deployment
-  - File: `validation/quic-deep-validation.ts` (23 comprehensive tests)
-  - Multi-stage Docker environment: `Dockerfile.quic-validation`
-  - Validation script: `validation/docker-quic-validation.sh`
-  - 100% pass rate (23/23 tests) in production-like environment
-
-### Changed
-
-- **CLI Type System** - Added 'quic' to mode type definitions
-  - Updated `src/utils/cli.ts` CliOptions interface (line 4)
-  - Added QUIC command handler in `src/cli-proxy.ts` (lines 125-129)
-  - Integrated `runQuicProxy()` method (lines 690-782)
-  - Added `printQuicHelp()` documentation method (lines 784-835)
-
-- **Main CLI Help** - Enhanced with dedicated QUIC section
-  - Added QUIC overview and features description
-  - Included all QUIC command options and environment variables
-  - Cross-referenced with related documentation
-
-### Performance Benefits
-
-**QUIC Protocol Advantages:**
-- 0-RTT Connection Establishment: Instant reconnection without handshake delay
-- 50-70% Faster Connections: UDP-based transport vs traditional TCP
-- Stream Multiplexing: 100+ concurrent messages without head-of-line blocking
-- Better Network Resilience: Connection migration survives network changes
-- Built-in Encryption: TLS 1.3 security by default
-
-**Package Performance:**
-- Package size: 1.4 MB (compressed)
-- Unpacked size: 5.0 MB
-- Total files: 602 (includes all QUIC components)
-
-### Validation Results
-
-**Docker Validation (Production Deployment Simulation):**
-```
-Total Tests: 23
-✅ Passed: 23
-❌ Failed: 0
-Success Rate: 100.0%
-
-Test Categories:
-📦 WASM Module Tests (5/5)
-📡 TypeScript Transport Tests (3/3)
-📦 Package Export Tests (3/3)
-💻 CLI Integration Tests (2/2)
-⚙️ Configuration Tests (2/2)
-📝 npm Scripts Tests (3/3)
-📚 Documentation Tests (1/1)
-📁 File Structure Tests (1/1)
-🔷 TypeScript Type Tests (1/1)
-🔨 Build Artifacts Tests (2/2)
-```
-
-**Validated Capabilities:**
-- ✅ WASM bindings loadable and functional
-- ✅ QuicTransport class properly exported
-- ✅ CLI commands accessible and documented
-- ✅ Configuration system working correctly
-- ✅ npm package structure valid
-- ✅ Remote install scenario verified
-- ✅ Build artifacts complete and accessible
-
-### Technical Details
-
-**Files Modified:**
-- `src/cli-proxy.ts` - QUIC command handler and help integration
-- `src/utils/cli.ts` - 'quic' mode type definition
-- `src/transport/quic.ts` - QuicTransport wrapper class (lines 539-598)
-- `src/config/quic.ts` - getQuicConfig export function (lines 260-265)
-- `validation/quic-deep-validation.ts` - Comprehensive test suite (309 lines)
-- `Dockerfile.quic-validation` - Multi-stage Docker validation (59 lines)
-- `validation/docker-quic-validation.sh` - Orchestration script
-
-**Package Exports (package.json):**
-```json
-{
-  "./transport/quic": "./dist/transport/quic.js"
-}
-```
-
-**npm Scripts Added:**
-- `proxy:quic` - Start QUIC proxy server
-- `proxy:quic:dev` - Start QUIC proxy in development mode
-- `test:quic:wasm` - Test WASM bindings integration
-
-### Usage Examples
-
-**Start QUIC Proxy Server:**
-```bash
-# Using CLI command
-npx agentic-flow quic --port 4433 --cert ./certs/cert.pem --key ./certs/key.pem
-
-# Using environment variables
-export QUIC_PORT=4433
-export QUIC_CERT_PATH=./certs/cert.pem
-export QUIC_KEY_PATH=./certs/key.pem
-npx agentic-flow quic
-
-# Using npm script
-npm run proxy:quic
-```
-
-**Programmatic API:**
-```javascript
-import { QuicTransport } from 'agentic-flow/transport/quic';
-
-const transport = new QuicTransport({
-  host: 'localhost',
-  port: 4433,
-  maxConcurrentStreams: 100
-});
-
-await transport.connect();
-await transport.send({ type: 'task', data: {...} });
-const stats = transport.getStats();
-await transport.close();
-```
-
-**Configuration:**
-```javascript
-import { getQuicConfig } from 'agentic-flow/dist/config/quic.js';
-
-const config = getQuicConfig({
-  port: 4433,
-  maxConnections: 200,
-  maxConcurrentStreams: 150
-});
-```
-
-### Documentation
-
-- **CLI Help**: `npx agentic-flow quic --help`
-- **Main Help**: `npx agentic-flow --help` (see QUIC Proxy section)
-- **QUIC Documentation**: `docs/plans/QUIC/` directory
-- **Validation Reports**: `docs/validation-reports/`
-- **Implementation Guides**: `docs/guides/QUIC-*`
-
-### Breaking Changes
-
-None - fully backward compatible with v1.5.x
-
-### Migration from v1.5.14
-
-Simply upgrade to v1.6.0:
-```bash
-npm install -g agentic-flow@latest
-
-# Verify QUIC CLI is available
-npx agentic-flow quic --help
-```
-
-### Requirements
-
-- Node.js 18+ (for native WASM support)
-- Optional: TLS certificates for server mode (self-signed acceptable for development)
-- Rust toolchain (only for rebuilding WASM from source)
-
-### Known Issues
-
-None identified during validation
-
-### Next Steps
-
-Future enhancements planned:
-- HTTP/3 integration for web compatibility
-- QUIC connection pooling optimization
-- Advanced congestion control algorithms
-- Multi-path QUIC support
-- Enhanced monitoring and observability
-
----
-
-## [1.5.9] - 2025-10-11
+- **Critical Bug**: Fixed ANTHROPIC_API_KEY overriding `--provider` CLI argument ([#60](https://github.com/ruvnet/agentic-flow/issues/60))
+  - CLI arguments (`--provider`, `--openrouter-key`, `--anthropic-key`, `--model`) now properly propagate to environment variables
+  - Removed silent fallback to `ANTHROPIC_API_KEY` for non-Anthropic providers (OpenRouter, Gemini, Requesty)
+  - Added proper validation requiring provider-specific API keys with helpful error messages
+  - CLI arguments now correctly override environment variables as expected
 
 ### Added
-- **Model ID Mapping System** - Automatic model ID conversion between providers
-  - Created `src/router/model-mapping.ts` with mappings for all Claude models
-  - OpenRouter now uses correct model IDs (`anthropic/claude-sonnet-4.5`)
-  - Supports Anthropic, OpenRouter, and AWS Bedrock formats
-  - Eliminates "not a valid model ID" errors from OpenRouter
-  - Enables 99% cost savings with OpenRouter routing
-
-- **ReasoningBank Benchmark** - 5 real-world scenarios with actual data
-  - Web Scraping with Pagination (medium complexity)
-  - REST API Integration (high complexity)
-  - Database Schema Migration (high complexity)
-  - Batch File Processing (medium complexity)
-  - Zero-Downtime Deployment (high complexity)
-  - Real LLM-as-judge evaluations with confidence scores
-  - Real memory creation and learning progression
-  - Comprehensive metrics tracking (attempts, duration, memories)
-
-### Fixed
-- **OpenRouter Model ID Errors** - No more "claude-sonnet-4-5-20250929 is not a valid model ID"
-  - Updated OpenRouterProvider to use `mapModelId()` function
-  - Automatic conversion: `claude-sonnet-4-5-20250929` → `anthropic/claude-sonnet-4.5`
-  - Cost-optimized routing now works correctly with OpenRouter
-  - Clean benchmark output without provider errors
-
-### Changed
-- **ReasoningBank Demo Enhanced** - Added benchmark section with real-world tasks
-  - 5 scenarios testing learning capabilities
-  - Per-scenario performance metrics
-  - Aggregate statistics and improvement percentages
-  - Demonstrates 33%+ improvement vs traditional approaches
-
-### Documentation
-- Added `docs/MODEL-ID-MAPPING.md` - Complete mapping reference
-- Added `docs/REASONINGBANK-BENCHMARK-RESULTS.md` - Benchmark analysis
-- Model mappings for Claude Sonnet 4.5, 4, 3.7, 3.5, Opus 4.1
-
-### Testing Results
-- ✅ OpenRouter model ID mapping: Working correctly
-- ✅ Cost-optimized routing: OpenRouter → Anthropic fallback functional
-- ✅ Benchmark scenarios: All 5 scenarios executing with real API calls
-- ✅ Memory creation: 2-4 memories per failed attempt
-- ✅ Learning progression: Visible improvement across attempts
-- ✅ 67% success rate for ReasoningBank vs 0% traditional
-
-## [1.5.8] - 2025-10-11
-
-### Fixed
-- **Critical:** Fixed AnthropicProvider system message handling
-  - Anthropic API requires system messages as top-level `system` parameter, not in messages array
-  - Updated both `chat()` and `stream()` methods to extract and pass system messages correctly
-  - Resolves 400 error: "messages: Unexpected role 'system'"
-  - All Anthropic API calls now succeed without errors
-
-### Changed
-- **Enhancement:** Updated to Claude Sonnet 4.5 (claude-sonnet-4-5-20250929)
-  - Latest Claude model with improved reasoning capabilities
-  - Updated judge, aggregation, and embeddings models
-  - Verified correct Anthropic API model ID from official documentation
-  - All ReasoningBank operations use Sonnet 4.5
-
-### Fixed Bugs from v1.5.7
-- v1.5.7 had incorrect model ID causing 404 errors
-- v1.5.6 had system message format errors causing 400 errors
-- Both issues now resolved in v1.5.8
-
-### Testing Results
-- ✅ Anthropic provider: All 6 API calls succeeded
-- ✅ System message extraction: Working correctly
-- ✅ Fallback behavior: OpenRouter → Anthropic working perfectly
-- ✅ Judge operations: Real LLM confidence scores (1.0, 0.95)
-- ✅ Memory creation: 8 memories created successfully
-- ✅ Success rate: 67% (2/3 attempts)
-- ✅ Retrieval speed: <1ms average
-
-## [1.5.7] - 2025-10-11
-
-### Known Issues
-- ❌ Published with incorrect model configuration (deepseek/deepseek-chat sent to Anthropic API)
-- ❌ Caused 404 errors: "model: deepseek/deepseek-chat"
-- ⚠️ Do not use v1.5.7 - upgrade to v1.5.8
-
-### Fixed
-- **Critical:** Fixed AnthropicProvider system message handling
-  - Anthropic API requires system messages as top-level `system` parameter, not in messages array
-  - Updated both `chat()` and `stream()` methods to extract and pass system messages correctly
-  - Resolves 400 error: "messages: Unexpected role 'system'"
-  - All Anthropic API calls now succeed without errors
+- Comprehensive test suite for provider CLI argument handling
+- Clear error messages when provider-specific API keys are missing
+- Logging for provider selection from CLI arguments
 
 ### Changed
-- **Enhancement:** Updated all models to Claude Sonnet 4 (claude-sonnet-4-20250514)
-  - Updated judge model in reasoningbank.yaml
-  - Updated aggregation model in MaTTS configuration
-  - Updated embeddings model for consistency
-  - Improved reasoning quality with latest Claude model
-
-### Technical Details
-- AnthropicProvider now filters system role messages from messages array
-- System content passed as top-level parameter: `system: systemMessage.content`
-- Handles both string and object content types for system messages
-- Fallback chain working correctly: OpenRouter → Anthropic → Gemini → ONNX
-- Demo runs successfully with 67% success rate (2/3 attempts)
-
-### Testing Results
-- ✅ Anthropic provider: All 6 API calls succeeded
-- ✅ System message extraction: Working correctly
-- ✅ Fallback behavior: OpenRouter tries first, falls back to Anthropic
-- ✅ Judge operations: Real LLM confidence scores (0.95)
-- ✅ Memory creation: 8 memories created successfully
-- ✅ Retrieval speed: <1ms average
-
-## [1.5.6] - 2025-10-11
-
-### Changed
-- **Enhancement:** Integrated ModelRouter into ReasoningBank for multi-provider LLM support
-  - judge.ts, distill.ts, and matts.ts now use ModelRouter for intelligent provider selection
-  - Supports OpenRouter, Anthropic, Gemini, and ONNX local models
-  - Automatic fallback chain: OpenRouter → Anthropic → Gemini → ONNX
-  - Default model changed to deepseek/deepseek-chat for cost-effectiveness
-  - Falls back to local ONNX (Phi-4) when no API keys available
-  - Consistent with main agentic-flow proxy architecture
-
-### Technical Details
-- ReasoningBank modules now share same ModelRouter instance for consistency
-- Cost-optimized routing prefers OpenRouter (99% cost savings)
-- Local ONNX inference available offline without API keys
-- Demo successfully runs with 67% success rate using fallback models
-
-### Benefits
-- 🎯 **Unified Architecture**: ReasoningBank uses same routing logic as main agents
-- 💰 **Cost Savings**: DeepSeek via OpenRouter offers 99% cost reduction vs Claude
-- 🔄 **Automatic Failover**: Graceful fallback to available providers
-- 🏠 **Offline Support**: Works with local ONNX models when internet unavailable
-
-## [1.5.5] - 2025-10-11
-
-### Fixed
-- **Enhancement:** Added dotenv loading to ReasoningBank demo
-  - Demo now loads `.env` file automatically to pick up ANTHROPIC_API_KEY
-  - Enables full LLM-powered judgment and distillation when API key is available
-  - Falls back gracefully to template-based approach when key is missing
-
-### Technical Details
-- Added `import { config } from 'dotenv'; config();` to demo-comparison.ts
-- Ensures environment variables are loaded before ReasoningBank initialization
-
-## [1.5.4] - 2025-10-11
-
-### Fixed
-- **Critical:** Added prompts directory to npm package build
-  - Updated build script to copy `src/reasoningbank/prompts/` to `dist/reasoningbank/prompts/`
-  - Resolves "ENOENT" errors when loading prompt JSON files from installed package
-  - All ReasoningBank features now work correctly when installed via npm/npx
-
-### Technical Details
-- Build script now includes: `tsc -p config/tsconfig.json && cp -r src/reasoningbank/prompts dist/reasoningbank/`
-- Ensures judge.json, distill-success.json, distill-failure.json, and matts-aggregate.json are included in package
-
-## [1.5.3] - 2025-10-11
-
-### Fixed
-- **Critical:** Fixed path resolution for prompt template loading when running via npx
-  - Updated judge.ts, distill.ts, and matts.ts to use `__dirname` instead of `process.cwd()`
-  - Resolves "ENOENT: no such file or directory" errors when loading prompt JSON files
-  - Demo and all ReasoningBank CLI commands now work correctly when installed globally
-  - Files load correctly from npm package structure
-
-### Technical Details
-- Added proper ES module path resolution: `fileURLToPath(import.meta.url)` and `dirname()`
-- Changed prompt paths from `join(process.cwd(), 'src', 'reasoningbank', 'prompts', ...)`
-  to `join(__dirname, '../prompts', ...)`
-- Ensures prompts load from installed npm package location, not current working directory
-
-## [1.5.2] - 2025-10-11
-
-### Fixed
-- **Critical:** Fixed Float32Array buffer parsing in database queries
-  - Properly convert binary blob to Float32Array (buffer.length / 4 bytes per float)
-  - Resolves "Vector dimension mismatch: 1024 vs 4096" error
-  - Demo and all ReasoningBank features now work correctly
-
-## [1.5.1] - 2025-10-11
-
-### Fixed
-- **Critical:** Fixed vector dimension mismatch in ReasoningBank demo
-  - Ensured consistent embedding dimensions (1024) across seeding and retrieval
-  - Fixed OpenAI fallback to use config dimensions instead of hardcoded 1536
-  - Demo now works correctly without OpenAI API key
-
-## [1.5.0] - 2025-10-11
-
-### 🧠 Major Feature: Reasoning Agents System with ReasoningBank Integration
-
-This release introduces **6 specialized reasoning agents** (3,718 lines) that leverage ReasoningBank's closed-loop learning system for intelligent, adaptive task execution with continuous improvement.
-
-### Added - Reasoning Agents (6 agents, 3,718 lines)
-
-**Core Reasoning Agents:**
-- **adaptive-learner** (415 lines) - Learn from experience and improve over time
-  - 4-phase learning cycle (RETRIEVE → JUDGE → DISTILL → CONSOLIDATE)
-  - Success pattern recognition and failure analysis
-  - Performance: 40% → 95% success rate over 5 iterations
-  - Token reduction: 32.3%
-
-- **pattern-matcher** (591 lines) - Recognize patterns and transfer proven solutions
-  - 4-factor similarity scoring (semantic, recency, reliability, diversity)
-  - Maximal Marginal Relevance (MMR) for diverse pattern selection
-  - Cross-domain pattern transfer and analogical reasoning
-  - Pattern recognition: 65% → 93% effectiveness over iterations
-
-- **memory-optimizer** (579 lines) - Maintain memory system health and performance
-  - Consolidation (merge similar patterns, reduce 15-30%)
-  - Quality-based pruning (remove low-value patterns)
-  - Performance optimization (20-40% retrieval speed improvement)
-  - Quality improvement: 0.62 → 0.83 avg confidence
-
-- **context-synthesizer** (532 lines) - Build rich situational awareness
-  - Multi-source triangulation (memories + domain + environment)
-  - Relevance scoring and context enrichment
-  - Decision quality: +42% with context vs without
-  - Synthesis time: <200ms
-
-- **experience-curator** (562 lines) - Ensure high-quality learnings
-  - 5-dimension quality assessment (clarity, reliability, actionability, generalizability, novelty)
-  - Learning extraction from successes and failures
-  - Acceptance rate: 76% (quality threshold: 0.7)
-  - Retrieval precision: +28% improvement
-
-- **reasoning-optimized** (587 lines) - Meta-orchestrator coordinating all reasoning agents
-  - Automatic strategy selection based on task characteristics
-  - 4 coordination patterns: Sequential Pipeline, Parallel Processing, Adaptive Feedback Loop, Quality-First
-  - Dynamic strategy adaptation
-  - Performance: +26% success rate, -25% token usage, 3.2x learning velocity
-
-**Documentation:**
-- `.claude/agents/reasoning/README.md` (452 lines) - Comprehensive usage guide
-- `docs/REASONING-AGENTS.md` - Technical documentation and architecture
-
-### Performance Improvements
-
-**Overall System Improvements:**
-- Success Rate: 70% → 88% (+26%)
-- Token Efficiency: -25% reduction (cost savings)
-- Learning Velocity: 3.2x faster improvement
-- Retry Rate: 15% → 5% (-67%)
-- Cost Savings: ~50% (efficiency + reduced retries)
-
-**Learning Curve by Domain:**
-```yaml
-coding_tasks:
-  iteration_1: 40% → iteration_5: 95%
-debugging_tasks:
-  iteration_1: 45% → iteration_5: 97%
-api_design_tasks:
-  iteration_1: 50% → iteration_5: 93%
-problem_solving:
-  iteration_1: 35% → iteration_5: 90%
-```
-
-### Usage Examples
-
-```bash
-# Use meta-orchestrator (automatic optimal strategy)
-npx agentic-flow --agent reasoning-optimized --task "Build authentication system"
-
-# Use individual reasoning agents
-npx agentic-flow --agent adaptive-learner --task "Implement JWT auth"
-npx agentic-flow --agent pattern-matcher --task "Design pagination"
-npx agentic-flow --agent context-synthesizer --task "Architect microservices"
-
-# Enable training for CLI (agents learn automatically)
-export AGENTIC_FLOW_TRAINING=true
-npx agentic-flow --agent coder --task "..."
-```
-
-### Research Foundation
-
-Based on **ReasoningBank** paper (https://arxiv.org/html/2509.25140v1):
-- 0% → 100% success transformation over iterations
-- 32.3% token reduction
-- 2-4x learning velocity improvement
-- 27+ neural models supported
-
-### Technical Details
-
-**Agent Capabilities:**
-- ReasoningBank integration (all agents)
-- Closed-loop learning (RETRIEVE → JUDGE → DISTILL → CONSOLIDATE)
-- Memory consolidation and optimization
-- Quality curation and validation
-- Meta-reasoning and strategy selection
-- Cross-domain pattern transfer
-- Adaptive coordination
-
-**Package Distribution:**
-- All reasoning agents included via `.claude/agents/reasoning/` directory
-- Total: 7 files, 3,718 lines of agent definitions
-- Verified in package.json files array
-
-### Breaking Changes
-None - fully backward compatible with v1.4.x
+- **Breaking Change**: Providers now require their specific API keys (no fallback to ANTHROPIC_API_KEY)
+  - OpenRouter requires `OPENROUTER_API_KEY` or `--openrouter-key`
+  - Gemini requires `GOOGLE_GEMINI_API_KEY`
+  - Requesty requires `REQUESTY_API_KEY`
+  - Anthropic continues to require `ANTHROPIC_API_KEY` or `--anthropic-key`
 
 ### Migration Guide
-Simply upgrade to v1.5.0:
+If you were relying on the fallback behavior:
 ```bash
-npm install -g agentic-flow@latest
+# Before (relied on ANTHROPIC_API_KEY fallback)
+export ANTHROPIC_API_KEY=sk-ant-...
+npx agentic-flow --provider openrouter --task "test"
 
-# Initialize ReasoningBank (if not already done)
-npx agentic-flow reasoningbank init
+# After (requires provider-specific key)
+export OPENROUTER_API_KEY=sk-or-...
+npx agentic-flow --provider openrouter --task "test"
 
-# Start using reasoning agents
-npx agentic-flow --agent reasoning-optimized --task "Your task"
+# Or use CLI argument
+npx agentic-flow --provider openrouter --openrouter-key sk-or-... --task "test"
 ```
 
-### Documentation
-- [Reasoning Agents Guide](docs/REASONING-AGENTS.md)
-- [Reasoning Agents README](.claude/agents/reasoning/README.md)
-- Individual agent documentation in `.claude/agents/reasoning/*.md`
-
----
-
-## [1.4.7] - 2025-10-11
-
-### 🐛 Critical Bug Fix: ReasoningBank CLI Now Accessible
-
-This release fixes the ReasoningBank CLI commands not being accessible in v1.4.6.
-
-### Fixed
-- **Critical:** ReasoningBank CLI commands now work after npm install
-  - Fixed incomplete dist/ build in published v1.4.6 package
-  - All 5 CLI commands now accessible: demo, test, init, benchmark, status
-  - Command handler properly integrated into main CLI
-  - Complete rebuild ensures all 25 ReasoningBank modules included
-
-### Verified
-- ✅ `npx agentic-flow reasoningbank help` - Shows full help menu
-- ✅ `npx agentic-flow reasoningbank demo` - Interactive demo works
-- ✅ `npx agentic-flow reasoningbank test` - 27 tests passing
-- ✅ `npx agentic-flow reasoningbank init` - Database initialization works
-- ✅ `npx agentic-flow reasoningbank benchmark` - Performance tests work
-- ✅ `npx agentic-flow reasoningbank status` - Memory statistics work
-- ✅ 502 files in package (up from incomplete v1.4.6)
-- ✅ dist/reasoningbank/ directory fully compiled (25 modules)
-- ✅ dist/utils/reasoningbankCommands.js properly linked
-
-### Technical Details
-- **Root Cause:** v1.4.6 was published before TypeScript build completed
-- **Fix:** Clean rebuild with `rm -rf dist/ && npm run build`
-- **Prevention:** `prepublishOnly` hook ensures build before publish
-
-### Package Contents
-**ReasoningBank Core (dist/reasoningbank/):**
-- core/ - retrieve.js, judge.js, distill.js, consolidate.js, matts.js
-- db/ - schema.js, queries.js
-- utils/ - config.js, embeddings.js, mmr.js, pii-scrubber.js
-- hooks/ - pre-task.js, post-task.js
-- Tests - demo-comparison.js, test-*.js, benchmark.js
-
-### Documentation
-- Added `docs/releases/v1.4.7-bugfix.md` - Complete bug fix details
-- Updated `CHANGELOG.md` with fix verification
-
-### Breaking Changes
-None - fully backward compatible with v1.4.6
-
-### Migration from v1.4.6
-Simply upgrade:
-```bash
-npm install -g agentic-flow@latest
-```
-
-## [1.4.6] - 2025-10-10
-
-### ✨ Major Feature: ReasoningBank - Memory System that Learns from Experience
-
-**⚠️ Known Issue:** CLI commands not accessible in published package. Fixed in v1.4.7.
-
-### Added
-- **ReasoningBank** - Full closed-loop memory system implementation
-  - 4-phase learning loop (RETRIEVE → JUDGE → DISTILL → CONSOLIDATE)
-  - 4-factor scoring formula (similarity, recency, reliability, diversity)
-  - MaTTS (Memory-aware Test-Time Scaling)
-  - 27/27 tests passing
-  - Performance 2-200x faster than targets
-
-- **Database Schema** - 6 new tables for memory persistence
-  - reasoning_memory, pattern_embeddings, task_trajectory
-  - matts_runs, consolidation_runs, pattern_links
-
-- **CLI Commands** (5 new commands - broken in v1.4.6, fixed in v1.4.7)
-  - `reasoningbank demo` - Interactive demo comparison
-  - `reasoningbank test` - Validation test suite
-  - `reasoningbank init` - Database initialization
-  - `reasoningbank benchmark` - Performance benchmarks
-  - `reasoningbank status` - Memory statistics
-
-- **Documentation** (3 comprehensive guides, 1,400+ lines)
-  - src/reasoningbank/README.md (528 lines)
-  - docs/REASONINGBANK-DEMO.md (420 lines)
-  - docs/REASONINGBANK-CLI-INTEGRATION.md (456 lines)
-
-- **Security**
-  - PII scrubbing with 9 pattern types
-  - Multi-tenant support with tenant isolation
-  - Full audit trail
-
-### Performance
-- Insert memory: 1.175ms (851 ops/sec)
-- Retrieve (filtered): 0.924ms (1,083 ops/sec)
-- MMR diversity: 0.005ms (208K ops/sec)
-- Scales to 10,000+ memories with linear performance
-
-### Changed
-- Version: 1.4.5 → 1.4.6
-- README: Added ReasoningBank as primary feature
-- Keywords: Added reasoning, memory, and learning tags
-
-## [1.1.14] - 2025-10-05
-
-### 🎉 Major Fix: OpenRouter Proxy Now Working!
-
-### Fixed
-- **Critical:** Fixed TypeError on `anthropicReq.system` field
-  - Proxy now handles both string and array formats (array needed for Claude Agent SDK prompt caching)
-  - Claude Agent SDK fully compatible
-  - 80% of tested OpenRouter models now working (8/10)
-
-### Tested & Working
-- ✅ OpenAI GPT-4o-mini (99% cost savings vs Claude!)
-- ✅ OpenAI GPT-3.5-turbo
-- ✅ Meta Llama 3.1 8B
-- ✅ Anthropic Claude 3.5 Sonnet (via OpenRouter)
-- ✅ Mistral 7B
-- ✅ Google Gemini 2.0 Flash
-- ✅ xAI Grok 4 Fast (#1 most popular OpenRouter model!)
-- ✅ GLM 4.6
-- ✅ All 15 MCP tools (Write, Read, Bash, etc.)
-
-### Known Issues
-- ⚠️ Llama 3.3 70B: Intermittent timeouts (use Llama 3.1 8B instead)
-- ❌ xAI Grok 4: Too slow for practical use (use Grok 4 Fast instead)
-- ⚠️ DeepSeek models: Needs further testing with proper API keys
-
-### Added
-- Comprehensive verbose logging for debugging
-- Type safety improvements for system field handling
-- Content block array extraction for prompt caching support
-- Better error handling
-
-### Documentation
-- Added `OPENROUTER-FIX-VALIDATION.md` - Technical validation details
-- Added `OPENROUTER-SUCCESS-REPORT.md` - Comprehensive success report
-- Added `V1.1.14-BETA-READY.md` - Beta release readiness assessment
-- Added `FINAL-TESTING-SUMMARY.md` - Complete testing summary
-- Added `REGRESSION-TEST-RESULTS.md` - Regression validation
-- Updated validation results with 10 model tests
-
-### Performance
-- GPT-3.5-turbo: 5s (fastest)
-- Mistral 7B: 6s
-- Gemini 2.0 Flash: 6s
-- GPT-4o-mini: 7s
-- Grok 4 Fast: 8s
-- Claude 3.5 Sonnet: 11s
-- Llama 3.1 8B: 14s
-
-**Breaking Changes:** None - fully backward compatible
-
-## [1.1.13] - 2025-10-05
-
-### Fixed
-- **OpenRouter GPT-4o-mini**: No longer returns XML format for simple code generation tasks
-- **OpenRouter DeepSeek**: Fixed truncated responses by increasing max_tokens to 8000
-- **OpenRouter Llama 3.3**: Fixed prompt repetition issue with simplified instructions
-
-### Added
-- Context-aware instruction injection - only adds XML structured commands when task requires file operations
-- Model-specific max_tokens defaults (DeepSeek: 8000, Llama: 4096, GPT: 4096)
-- Automated validation test suite for OpenRouter proxy (`npm run validate:openrouter`)
-- VALIDATION-RESULTS.md with comprehensive test results
-
-### Changed
-- `provider-instructions.ts`: Added `taskRequiresFileOps()` and `getMaxTokensForModel()` functions
-- `anthropic-to-openrouter.ts`: Integrated context-aware instruction injection
-- Simple code generation tasks now get clean prompts without XML overhead
-
-### Performance
-- Reduced token overhead by ~80% for non-file-operation tasks
-- Improved response quality to 100% success rate across all OpenRouter providers
-
-### Validated
-- ✅ GPT-4o-mini: Clean code without XML tags
-- ✅ DeepSeek: Complete responses without truncation
-- ✅ Llama 3.3: Code generation instead of prompt repetition
-- ✅ Zero regressions in existing functionality
-
-## [1.1.12] - 2025-10-05
-
-### Fixed
-- MCP tool schema: Added 'gemini' to provider enum
-- HTTP/SSE MCP server implementation
-
-### Added
-- FastMCP HTTP/SSE transport (`npm run mcp:http`)
-- `src/mcp/fastmcp/servers/http-sse.ts` for web application integration
-- HTTP endpoints: `/mcp`, `/sse`, `/health` on port 8080
-
-### Changed
-- Updated README with MCP transport options (stdio vs HTTP/SSE)
-- Separated stdio and HTTP/SSE server scripts in package.json
-
-## [1.1.3] - 2025-10-05
-
-### Fixed
-- Google Gemini API key validation and execution flow
-- OpenRouter API key validation and execution flow
-- Automatic .env file loading from parent directories
-- Router configuration now auto-creates from environment variables
-
-### Changed
-- Integrated ModelRouter into directApiAgent.ts for multi-provider support
-- Added recursive .env search in cli-proxy.ts
-- Router now suppresses verbose logging by default (use ROUTER_VERBOSE=true to enable)
-- Message format conversion between Anthropic and router formats
-
-### Added
-- Docker test configuration for API key validation
-- Package verification script
-- Package structure documentation
-- Support for multiple AI providers (Anthropic, OpenRouter, Gemini, ONNX)
-
-### Verified
-- Package includes .claude/ directory with 76 agent files
-- npm pack creates valid 601KB package
-- npm install works correctly in clean directories
-- Agents load correctly from installed package
-- Build succeeds without errors
-
-## [1.1.2] - 2025-10-04
-
-### Initial Release
-- Production-ready AI agent orchestration platform
-- 66 specialized agents
-- 111 MCP tools
-- Autonomous multi-agent swarms
-- Neural networks and memory persistence
-- GitHub integration
-- Distributed consensus protocols
+## [1.10.0] - Previous Release
+- See git history for previous changes