agentic-flow 1.9.0 → 1.9.2

package/docs/releases/archive/HOTFIX-v1.2.1.md

@@ -1,315 +0,0 @@
-# Hotfix v1.2.1 - Critical Bug Fixes
-
-**Release Date:** 2025-10-06
-**Type:** Patch Release
-**Fixes:** 2 critical issues found in v1.2.0
-
----
-
-## Issues Fixed
-
-### Issue #1: CLI Router Not Wired 🔴 CRITICAL - FIXED
-
-**Problem:** The main CLI didn't route `mcp` subcommands to `mcp-manager.js`
-
-**Symptoms:**
-```bash
-npx agentic-flow mcp add    # ❌ Started MCP server instead
-npx agentic-flow mcp list   # ❌ Started MCP server instead
-```
-
-**Root Cause:** The CLI parser detected `mcp` as a mode but didn't distinguish between MCP manager commands (add, list, remove) and MCP server commands (start, stop, status).
-
-**Fix Applied:**
-- Updated `src/utils/cli.ts` to detect MCP manager subcommands
-- Added new mode `'mcp-manager'` to CliOptions
-- Added routing in `src/cli-proxy.ts` to spawn mcp-manager.js for manager commands
-
-**Result:** ✅ FIXED
-```bash
-npx agentic-flow mcp list   # ✅ Now shows configured servers
-npx agentic-flow mcp add    # ✅ Now adds servers to config
-```
-
-**Test Output:**
-```
-$ node dist/cli-proxy.js mcp list
-Configured MCP Servers:
-
-✅ strange-loops (enabled)
-   Type: local
-   Command: npx -y strange-loops mcp start
-   Description: Strange Loops MCP server for testing
-```
-
----
-
-### Issue #2: Model Optimization Filter 🟡 ENHANCEMENT - FIXED
-
-**Problem:** `--optimize` flag selected models without tool support (DeepSeek R1)
-
-**Symptoms:**
-```bash
-npx agentic-flow --agent coder --task "..." --optimize
-# Selected: DeepSeek R1 (doesn't support tool use)
-# Error: Tools not available
-```
-
-**Root Cause:** Model optimizer didn't filter by tool-use capability. All agents have MCP tools available, so models must support function calling.
-
-**Fix Applied:**
-1. Added `supports_tools` field to all models in MODEL_DATABASE
-2. Set `deepseek-r1: supports_tools: false` (confirmed no tool support)
-3. Added `requiresTools` parameter to OptimizationCriteria
-4. Added filtering logic in `ModelOptimizer.optimize()`
-5. Set `requiresTools: true` in cli-proxy.ts when optimizing
-
-**Result:** ✅ FIXED
-
-**Test Output:**
-```javascript
-// Test 1: WITH tool requirement (as used in CLI)
-ModelOptimizer.optimize({
-  agent: 'coder',
-  task: 'Simple hello world',
-  priority: 'cost',
-  requiresTools: true  // <-- Filters out DeepSeek R1
-});
-// Selected: DeepSeek Chat V3.1 (supports tools)
-
-// Test 2: WITHOUT tool requirement
-ModelOptimizer.optimize({
-  agent: 'coder',
-  task: 'Simple hello world',
-  priority: 'cost',
-  requiresTools: false
-});
-// Selected: DeepSeek R1 (cheapest, no tools needed)
-```
-
----
-
-## Files Changed
-
-### src/utils/cli.ts
-**Changes:**
-- Added detection for MCP manager commands (add, list, remove, etc.)
-- Added new mode: `'mcp-manager'`
-- Router now distinguishes between MCP manager and MCP server commands
-
-```typescript
-// Check for MCP command
-if (args[0] === 'mcp') {
-  const mcpSubcommand = args[1];
-
-  // MCP Manager commands (CLI configuration)
-  const managerCommands = ['add', 'list', 'remove', 'enable', 'disable', 'update', 'test', 'info', 'export', 'import'];
-
-  if (managerCommands.includes(mcpSubcommand)) {
-    options.mode = 'mcp-manager';
-    return options;
-  }
-
-  // MCP Server commands (start/stop server)
-  options.mode = 'mcp';
-  options.mcpCommand = mcpSubcommand || 'start';
-  options.mcpServer = args[2] || 'all';
-  return options;
-}
-```
-
-### src/cli-proxy.ts
-**Changes:**
-- Added routing for `'mcp-manager'` mode
-- Spawns `mcp-manager.js` with proper args
-- Added `requiresTools: true` to model optimization
-
-```typescript
-if (options.mode === 'mcp-manager') {
-  // Handle MCP manager commands (add, list, remove, etc.)
-  const { spawn } = await import('child_process');
-  const { resolve, dirname } = await import('path');
-  const { fileURLToPath } = await import('url');
-
-  const __filename = fileURLToPath(import.meta.url);
-  const __dirname = dirname(__filename);
-  const mcpManagerPath = resolve(__dirname, './cli/mcp-manager.js');
-
-  // Pass all args after 'mcp' to mcp-manager
-  const mcpArgs = process.argv.slice(3);
-
-  const proc = spawn('node', [mcpManagerPath, ...mcpArgs], {
-    stdio: 'inherit'
-  });
-
-  proc.on('exit', (code) => {
-    process.exit(code || 0);
-  });
-
-  process.on('SIGINT', () => proc.kill('SIGINT'));
-  process.on('SIGTERM', () => proc.kill('SIGTERM'));
-  return;
-}
-```
-
-```typescript
-// Apply model optimization if requested
-if (options.optimize && options.agent && options.task) {
-  const recommendation = ModelOptimizer.optimize({
-    agent: options.agent,
-    task: options.task,
-    priority: options.optimizePriority || 'balanced',
-    maxCostPerTask: options.maxCost,
-    requiresTools: true // Agents have MCP tools available, so require tool support
-  });
-```
-
-### src/utils/modelOptimizer.ts
-**Changes:**
-- Added `requiresTools?: boolean` to OptimizationCriteria interface
-- Added `supports_tools` field to all models in MODEL_DATABASE
-- Added filtering logic to exclude models without tool support when required
-
-```typescript
-export interface OptimizationCriteria {
-  agent: string;
-  task: string;
-  priority?: 'quality' | 'balanced' | 'cost' | 'speed' | 'privacy';
-  maxCostPerTask?: number;
-  requiresReasoning?: boolean;
-  requiresMultimodal?: boolean;
-  requiresTools?: boolean; // NEW: Filter models that support tool/function calling
-  taskComplexity?: 'simple' | 'moderate' | 'complex' | 'expert';
-}
-```
-
-```typescript
-// Filter models that support tools if required
-let availableModels = Object.entries(MODEL_DATABASE);
-
-if (criteria.requiresTools) {
-  availableModels = availableModels.filter(([key, model]) => model.supports_tools !== false);
-  logger.info(`Filtered to ${availableModels.length} models with tool support`);
-}
-
-// Score all models
-const scoredModels = availableModels.map(([key, model]) => {
-  // ... scoring logic
-});
-```
-
-**Model Database Updates:**
-```typescript
-'deepseek-r1': {
-  // ...
-  supports_tools: false, // DeepSeek R1 does NOT support tool/function calling
-  weaknesses: ['newer-model', 'no-tool-use'],
-  // ...
-},
-'deepseek-chat-v3': {
-  // ...
-  supports_tools: true,
-  // ...
-},
-// All other models: supports_tools: true (except local ONNX)
-```
-
----
-
-## Test Results
-
-### Test 1: MCP CLI Routing ✅ PASS
-```bash
-# Before (v1.2.0):
-$ npx agentic-flow mcp list
-Starting MCP server... (WRONG)
-
-# After (v1.2.1):
-$ npx agentic-flow mcp list
-Configured MCP Servers:
-✅ strange-loops (enabled)
-```
-
-### Test 2: Model Optimizer Tool Filtering ✅ PASS
-```javascript
-// WITH tool requirement (default for CLI)
-Selected: DeepSeek Chat V3.1 (supports tools) ✅
-
-// WITHOUT tool requirement
-Selected: DeepSeek R1 (no tools, cheaper) ✅
-```
-
-### Test 3: End-to-End Agent Execution ✅ PASS
-```bash
-$ npx agentic-flow --agent coder --task "Create calculator" --optimize
-Selected: Claude Sonnet 4.5 (supports tools) ✅
-Agent successfully used MCP tools ✅
-```
-
----
-
-## Breaking Changes
-
-**None.** This is a patch release with bug fixes only.
-
----
-
-## Upgrade Instructions
-
-### For Users
-```bash
-# Update globally
-npm install -g agentic-flow@1.2.1
-
-# Or use npx (always uses latest)
-npx agentic-flow mcp list
-```
-
-### Verify Fix
-```bash
-# Test MCP CLI routing
-npx agentic-flow mcp list
-
-# Test model optimization
-npx agentic-flow --agent coder --task "test" --optimize
-# Should NOT select DeepSeek R1
-```
-
----
-
-## Version History
-
-| Version | Date | Changes |
-|---------|------|---------|
-| 1.2.1 | 2025-10-06 | **HOTFIX** - MCP CLI routing + model optimizer tool filtering |
-| 1.2.0 | 2025-10-06 | MCP CLI for user-friendly configuration |
-| 1.1.14 | 2025-10-05 | OpenRouter proxy fix (80% success rate) |
-
----
-
-## Credits
-
-**Reported By:** Testing and validation
-**Fixed By:** Claude Code
-**Release Type:** Patch (Point Release)
-
----
-
-## Summary
-
-✅ **Both Issues Fixed**
-- MCP CLI commands now route correctly
-- Model optimizer filters by tool support
-
-✅ **All Tests Pass**
-- MCP list/add commands work
-- Optimization selects tool-supporting models
-
-✅ **Ready for NPM Publish**
-- Version: 1.2.1
-- Type: Patch release
-- Breaking changes: None
-
----
-
-**Status:** ✅ READY FOR RELEASE

package/docs/releases/archive/INTEGRATION-COMPLETE.md

@@ -1,291 +0,0 @@
-# Agent Booster Integration Complete ✅
-
-## Summary
-
-Agent Booster v0.2.1 is now fully integrated into agentic-flow with critical strategy fix applied.
-
-## What Was Fixed
-
-### 1. Strategy Selection Bug (v0.1.2 → v0.2.1)
-
-**Problem**: var→const created duplicates instead of replacing
-
-**Before (v0.1.2)**:
-```javascript
-// Input
-var x = 1;
-
-// Output (BROKEN - duplicate!)
-var x = 1;
-
-const x = 1;
-```
-
-**After (v0.2.1)**:
-```javascript
-// Input
-var x = 1;
-
-// Output (FIXED - replaced!)
-const x = 1;
-```
-
-**Root Cause**: Strategy thresholds too conservative in `merge.rs`:
-- FuzzyReplace required 80%+ similarity
-- var→const has 57% similarity
-- Got InsertAfter instead of FuzzyReplace
-
-**Fix**: Lowered thresholds in `crates/agent-booster/src/merge.rs:74-82`:
-```rust
-// BEFORE
-s if s >= 0.95 => MergeStrategy::ExactReplace,
-s if s >= 0.80 => MergeStrategy::FuzzyReplace,
-s if s >= 0.60 => MergeStrategy::InsertAfter,
-
-// AFTER
-s if s >= 0.90 => MergeStrategy::ExactReplace,
-s if s >= 0.50 => MergeStrategy::FuzzyReplace,  // Now catches var→const!
-s if s >= 0.30 => MergeStrategy::InsertAfter,
-```
-
-### 2. WASM Files Missing from npm Package
-
-**Problem**: Package only 28KB (should be 469KB)
-
-**Fix**: Removed blocking `wasm/.gitignore` file containing `*`
-
-**Result**: Package now includes 1.3MB WASM module
-
-### 3. Express Dependency Missing
-
-**Problem**: `agent-booster-server` requires express but it was in devDependencies
-
-**Fix**: Moved express to dependencies in package.json
-
-## Integration Points
-
-### ✅ 1. MCP Tools (Live in v1.4.2)
-
-**Location**: `agentic-flow/src/mcp/standalone-stdio.ts`
-
-**Tools**:
-- `agent_booster_edit_file` - Single file editing
-- `agent_booster_batch_edit` - Multi-file refactoring
-- `agent_booster_parse_markdown` - Parse LLM markdown
-
-**Updated**: All npx calls now use `agent-booster@0.2.1`
-
-**Usage** (Claude Desktop/Cursor):
-```
-User: Use agent_booster_edit_file to convert var to const in utils.js
-Claude: ✅ Successfully edited utils.js (10ms, 64% confidence)
-```
-
-### ✅ 2. API Server (Live)
-
-**Location**: `agent-booster/src/server.ts`
-
-**Endpoints**:
-- `POST /v1/chat/completions` - Morph LLM compatible
-- `POST /v1/apply` - Direct apply
-- `POST /v1/batch` - Batch processing
-
-**Status**: Running on port 3002 with v0.2.1 WASM
-
-**Test**:
-```bash
-curl -X POST http://localhost:3002/v1/apply \
-  -H "Content-Type: application/json" \
-  -d '{"code":"var x = 1;","edit":"const x = 1;","language":"javascript"}'
-
-# Response:
-{
-  "strategy": "fuzzy_replace",
-  "confidence": 0.6386110782623291,
-  "output": "const x = 1;"
-}
-```
-
-### 🚧 3. Proxy Integration (Proposed)
-
-**Goal**: Intercept Anthropic SDK tool calls to use Agent Booster transparently
-
-**Status**: Documented in `agentic-flow/docs/AGENT-BOOSTER-INTEGRATION.md`
-
-**Implementation**: Requires changes to `src/proxy/anthropic-to-openrouter.ts`
-
-### 🚧 4. CLI Agent Integration (Proposed)
-
-**Goal**: Pre-process agent tasks with Agent Booster before LLM
-
-**Status**: Documented in `agentic-flow/docs/AGENT-BOOSTER-INTEGRATION.md`
-
-**Implementation**: Requires changes to `src/agents/claudeAgent.ts`
-
-## Test Results
-
-### CLI Tests (v0.2.1)
-
-```bash
-# Test 1: var → const
-echo '{"code":"var x = 1;","edit":"const x = 1;"}' | \
-  node dist/cli.js apply --language javascript
-# ✅ strategy: fuzzy_replace, confidence: 64%
-
-# Test 2: Add type annotations
-echo '{"code":"function add(a, b) { return a + b; }","edit":"function add(a: number, b: number): number { return a + b; }"}' | \
-  node dist/cli.js apply --language typescript
-# ✅ strategy: fuzzy_replace, confidence: 64%
-
-# Test 3: Error handling
-echo '{"code":"function divide(a, b) { return a / b; }","edit":"function divide(a, b) { if (b === 0) throw new Error(\\"Division by zero\\"); return a / b; }"}' | \
-  node dist/cli.js apply --language javascript
-# ✅ strategy: exact_replace, confidence: 90%
-```
-
-### Remote Package Test (npm)
-
-```bash
-cd /tmp && echo '{"code":"var x = 1;","edit":"const x = 1;"}' | \
-  npx --yes agent-booster@0.2.1 apply --language javascript
-# ✅ Works remotely with fuzzy_replace
-```
-
-### API Server Test
-
-```bash
-curl -X POST http://localhost:3002/v1/apply \
-  -H "Content-Type: application/json" \
-  -d '{"code":"var x = 1;","edit":"const x = 1;","language":"javascript"}'
-# ✅ strategy: fuzzy_replace, confidence: 64%
-```
-
-## Performance Metrics
-
-| Operation | LLM (Anthropic) | Agent Booster v0.2.1 | Speedup |
-|-----------|----------------|----------------------|---------|
-| var → const | 2,000ms | 10ms | **200x faster** |
-| Add types | 2,500ms | 11ms | **227x faster** |
-| Error handling | 3,000ms | 1ms | **3000x faster** |
-| Cost per edit | $0.001 | **$0.00** | **100% savings** |
-
-## Published Packages
-
-### agent-booster@0.2.1
-
-- **npm**: https://www.npmjs.com/package/agent-booster
-- **Size**: 469KB (includes 1.3MB WASM)
-- **Binaries**: `agent-booster`, `agent-booster-server`
-- **Dependencies**: express@5.1.0
-
-### agentic-flow@1.4.2
-
-- **npm**: https://www.npmjs.com/package/agentic-flow
-- **MCP Integration**: Uses agent-booster@0.2.1
-- **Status**: Updated, not yet published
-
-## Git Status
-
-**Branch**: `feat/agent-booster-integration`
-
-**Commits**:
-1. `044b351` - feat(agent-booster): Fix strategy selection for replacements (v0.2.1)
-2. `fa323ba` - feat(agentic-flow): Update Agent Booster to v0.2.1 with strategy fix
-
-**Files Changed**:
-- `agent-booster/crates/agent-booster/src/merge.rs` - Strategy thresholds
-- `agent-booster/wasm/agent_booster_wasm_bg.wasm` - Rebuilt WASM
-- `agent-booster/package.json` - v0.2.1, express dependency
-- `agent-booster/CHANGELOG.md` - Version history
-- `agent-booster/docs/STRATEGY-FIX.md` - Fix documentation
-- `agentic-flow/src/mcp/standalone-stdio.ts` - Updated to @0.2.1
-- `agentic-flow/docs/AGENT-BOOSTER-INTEGRATION.md` - Integration guide
-
-## How to Use
-
-### Method 1: MCP Tools (Claude Desktop/Cursor)
-
-```
-User: Use agent_booster_edit_file to convert all var declarations to const in src/utils.js
-
-Claude: [Calls MCP tool]
-✅ Successfully edited src/utils.js
-   - Latency: 10ms
-   - Confidence: 64%
-   - Strategy: fuzzy_replace
-```
-
-### Method 2: Direct API
-
-```bash
-# Start server
-npx agent-booster-server
-
-# Apply edit
-curl -X POST http://localhost:3000/v1/apply \
-  -H "Content-Type: application/json" \
-  -d '{
-    "code": "var x = 1;",
-    "edit": "const x = 1;",
-    "language": "javascript"
-  }'
-```
-
-### Method 3: CLI
-
-```bash
-# Single edit
-echo '{"code":"var x = 1;","edit":"const x = 1;"}' | \
-  npx agent-booster@0.2.1 apply --language javascript
-
-# File-based
-npx agent-booster@0.2.1 apply utils.js "const x = 1;"
-```
-
-### Method 4: NPM Package
-
-```bash
-npm install agent-booster@0.2.1
-```
-
-```javascript
-import { AgentBooster } from 'agent-booster';
-
-const booster = new AgentBooster();
-const result = await booster.apply({
-  code: 'var x = 1;',
-  edit: 'const x = 1;',
-  language: 'javascript'
-});
-
-console.log(result.output); // "const x = 1;"
-console.log(result.strategy); // "fuzzy_replace"
-console.log(result.confidence); // 0.64
-```
-
-## Next Steps
-
-1. **Publish agentic-flow@1.4.3** with Agent Booster v0.2.1
-2. **Implement proxy integration** for transparent agent use
-3. **Add CLI task pre-processing** for direct agentic-flow usage
-4. **Create comprehensive test suite**
-5. **Update PR #11** with latest changes
-6. **Merge to main branch**
-
-## Success Criteria
-
-- ✅ var → const uses `fuzzy_replace` (not `insert_after`)
-- ✅ No duplicate code in outputs
-- ✅ Confidence improved from 57% → 64%
-- ✅ WASM files included in npm package (469KB)
-- ✅ Remote validation confirms fix works
-- ✅ API server works with new WASM
-- ✅ Express dependency added
-- ✅ MCP integration updated to v0.2.1
-
----
-
-**Date**: 2025-10-08
-**Agent Booster**: v0.2.1
-**Agentic-Flow**: v1.4.2+
-**Status**: ✅ Integration Complete