agentic-flow 1.4.6 → 1.4.8

package/CHANGELOG.md

@@ -5,6 +5,102 @@ 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).
 
+## [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!

package/dist/cli-proxy.js

@@ -30,6 +30,7 @@ import { logger } from "./utils/logger.js";
 import { parseArgs } from "./utils/cli.js";
 import { getAgent, listAgents } from "./utils/agentLoader.js";
 import { claudeAgent } from "./agents/claudeAgent.js";
+import { handleReasoningBankCommand } from "./utils/reasoningbankCommands.js";
 import { handleConfigCommand } from "./cli/config-wizard.js";
 import { handleAgentCommand } from "./cli/agent-manager.js";
 import { ModelOptimizer } from "./utils/modelOptimizer.js";
@@ -53,7 +54,7 @@ class AgenticFlowCLI {
             process.exit(0);
         }
         // If no mode and no agent specified, show help
-        if (!options.agent && options.mode !== 'list' && !['config', 'agent-manager', 'mcp-manager', 'proxy', 'claude-code', 'mcp'].includes(options.mode)) {
+        if (!options.agent && options.mode !== 'list' && !['config', 'agent-manager', 'mcp-manager', 'proxy', 'claude-code', 'mcp', 'reasoningbank'].includes(options.mode)) {
             this.printHelp();
             process.exit(0);
         }
@@ -132,6 +133,12 @@ class AgenticFlowCLI {
             process.on('SIGTERM', () => proc.kill('SIGTERM'));
             return;
         }
+        if (options.mode === 'reasoningbank') {
+            // Handle ReasoningBank commands
+            const subcommand = process.argv[3] || 'help';
+            await handleReasoningBankCommand(subcommand);
+            process.exit(0);
+        }
         // Apply model optimization if requested
         if (options.optimize && options.agent && options.task) {
             const recommendation = ModelOptimizer.optimize({

package/dist/reasoningbank/core/database.js

@@ -0,0 +1,250 @@
+/**
+ * SQLite Database Layer for ReasoningBank
+ * Handles memory storage, retrieval, and consolidation
+ */
+import Database from 'better-sqlite3';
+import { ulid } from 'ulid';
+export class ReasoningBankDB {
+    db;
+    constructor(dbPath) {
+        this.db = new Database(dbPath);
+        this.db.pragma('journal_mode = WAL'); // Enable Write-Ahead Logging for concurrency
+        this.initSchema();
+    }
+    initSchema() {
+        // Main memory table
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS reasoning_memory (
+        id TEXT PRIMARY KEY,
+        title TEXT NOT NULL,
+        description TEXT NOT NULL,
+        content TEXT NOT NULL,
+        confidence REAL DEFAULT 0.5,
+        usage_count INTEGER DEFAULT 0,
+        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+        pattern_data JSON NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_memory_confidence ON reasoning_memory(confidence);
+      CREATE INDEX IF NOT EXISTS idx_memory_created_at ON reasoning_memory(created_at);
+      CREATE INDEX IF NOT EXISTS idx_memory_domain ON reasoning_memory(json_extract(pattern_data, '$.domain'));
+    `);
+        // Pattern embeddings table
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS pattern_embeddings (
+        pattern_id TEXT PRIMARY KEY,
+        embedding BLOB NOT NULL,
+        FOREIGN KEY (pattern_id) REFERENCES reasoning_memory(id) ON DELETE CASCADE
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_embeddings_pattern ON pattern_embeddings(pattern_id);
+    `);
+        // Task trajectory table
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS task_trajectory (
+        id TEXT PRIMARY KEY,
+        task_id TEXT NOT NULL,
+        trajectory TEXT NOT NULL,
+        verdict TEXT NOT NULL CHECK(verdict IN ('Success', 'Failure')),
+        confidence REAL NOT NULL,
+        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_trajectory_task ON task_trajectory(task_id);
+      CREATE INDEX IF NOT EXISTS idx_trajectory_verdict ON task_trajectory(verdict);
+    `);
+        // MaTTS runs table
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS matts_runs (
+        id TEXT PRIMARY KEY,
+        task_id TEXT NOT NULL,
+        run_index INTEGER NOT NULL,
+        result TEXT NOT NULL,
+        verdict TEXT NOT NULL CHECK(verdict IN ('Success', 'Failure')),
+        confidence REAL NOT NULL,
+        created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_matts_task ON matts_runs(task_id);
+    `);
+    }
+    // Memory operations
+    insertMemory(memory) {
+        const id = ulid();
+        const stmt = this.db.prepare(`
+      INSERT INTO reasoning_memory (id, title, description, content, confidence, usage_count, pattern_data)
+      VALUES (?, ?, ?, ?, ?, ?, json(?))
+    `);
+        stmt.run(id, memory.title, memory.description, memory.content, memory.confidence, memory.usage_count, JSON.stringify(memory.pattern_data));
+        return id;
+    }
+    getMemory(id) {
+        const stmt = this.db.prepare(`
+      SELECT id, title, description, content, confidence, usage_count,
+             datetime(created_at) as created_at, pattern_data
+      FROM reasoning_memory
+      WHERE id = ?
+    `);
+        const row = stmt.get(id);
+        if (!row)
+            return null;
+        return {
+            ...row,
+            pattern_data: JSON.parse(row.pattern_data)
+        };
+    }
+    getAllMemories() {
+        const stmt = this.db.prepare(`
+      SELECT id, title, description, content, confidence, usage_count,
+             datetime(created_at) as created_at, pattern_data
+      FROM reasoning_memory
+      ORDER BY created_at DESC
+    `);
+        const rows = stmt.all();
+        return rows.map(row => ({
+            ...row,
+            pattern_data: JSON.parse(row.pattern_data)
+        }));
+    }
+    updateMemoryUsage(id) {
+        const stmt = this.db.prepare(`
+      UPDATE reasoning_memory
+      SET usage_count = usage_count + 1
+      WHERE id = ?
+    `);
+        stmt.run(id);
+    }
+    updateMemoryConfidence(id, confidence) {
+        const stmt = this.db.prepare(`
+      UPDATE reasoning_memory
+      SET confidence = ?
+      WHERE id = ?
+    `);
+        stmt.run(confidence, id);
+    }
+    deleteMemory(id) {
+        const stmt = this.db.prepare('DELETE FROM reasoning_memory WHERE id = ?');
+        stmt.run(id);
+    }
+    // Embedding operations
+    insertEmbedding(patternId, embedding) {
+        const buffer = Buffer.from(new Float64Array(embedding).buffer);
+        const stmt = this.db.prepare(`
+      INSERT OR REPLACE INTO pattern_embeddings (pattern_id, embedding)
+      VALUES (?, ?)
+    `);
+        stmt.run(patternId, buffer);
+    }
+    getEmbedding(patternId) {
+        const stmt = this.db.prepare('SELECT embedding FROM pattern_embeddings WHERE pattern_id = ?');
+        const row = stmt.get(patternId);
+        if (!row)
+            return null;
+        const buffer = row.embedding;
+        return Array.from(new Float64Array(buffer.buffer, buffer.byteOffset, buffer.byteLength / 8));
+    }
+    getAllEmbeddings() {
+        const stmt = this.db.prepare('SELECT pattern_id, embedding FROM pattern_embeddings');
+        const rows = stmt.all();
+        const embeddings = new Map();
+        for (const row of rows) {
+            const buffer = row.embedding;
+            const embedding = Array.from(new Float64Array(buffer.buffer, buffer.byteOffset, buffer.byteLength / 8));
+            embeddings.set(row.pattern_id, embedding);
+        }
+        return embeddings;
+    }
+    // Trajectory operations
+    insertTrajectory(trajectory) {
+        const id = ulid();
+        const stmt = this.db.prepare(`
+      INSERT INTO task_trajectory (id, task_id, trajectory, verdict, confidence)
+      VALUES (?, ?, ?, ?, ?)
+    `);
+        stmt.run(id, trajectory.task_id, trajectory.trajectory, trajectory.verdict, trajectory.confidence);
+        return id;
+    }
+    getTrajectories(taskId) {
+        const stmt = this.db.prepare(`
+      SELECT id, task_id, trajectory, verdict, confidence, datetime(created_at) as created_at
+      FROM task_trajectory
+      WHERE task_id = ?
+      ORDER BY created_at DESC
+    `);
+        return stmt.all(taskId);
+    }
+    // MaTTS operations
+    insertMattsRun(run) {
+        const id = ulid();
+        const stmt = this.db.prepare(`
+      INSERT INTO matts_runs (id, task_id, run_index, result, verdict, confidence)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `);
+        stmt.run(id, run.task_id, run.run_index, run.result, run.verdict, run.confidence);
+        return id;
+    }
+    getMattsRuns(taskId) {
+        const stmt = this.db.prepare(`
+      SELECT id, task_id, run_index, result, verdict, confidence, datetime(created_at) as created_at
+      FROM matts_runs
+      WHERE task_id = ?
+      ORDER BY run_index ASC
+    `);
+        return stmt.all(taskId);
+    }
+    // Statistics
+    getStats() {
+        const memoryStats = this.db.prepare(`
+      SELECT COUNT(*) as total, AVG(confidence) as avg_conf, SUM(usage_count) as total_usage
+      FROM reasoning_memory
+    `).get();
+        const trajectoryStats = this.db.prepare(`
+      SELECT
+        SUM(CASE WHEN verdict = 'Success' THEN 1 ELSE 0 END) as successes,
+        COUNT(*) as total
+      FROM task_trajectory
+    `).get();
+        return {
+            totalMemories: memoryStats.total || 0,
+            avgConfidence: memoryStats.avg_conf || 0,
+            totalUsage: memoryStats.total_usage || 0,
+            successRate: trajectoryStats.total > 0
+                ? trajectoryStats.successes / trajectoryStats.total
+                : 0
+        };
+    }
+    // Consolidation helpers
+    findDuplicates(threshold = 0.95) {
+        // Returns pairs of memory IDs that are likely duplicates
+        const memories = this.getAllMemories();
+        const embeddings = this.getAllEmbeddings();
+        const duplicates = [];
+        for (let i = 0; i < memories.length; i++) {
+            for (let j = i + 1; j < memories.length; j++) {
+                const emb1 = embeddings.get(memories[i].id);
+                const emb2 = embeddings.get(memories[j].id);
+                if (emb1 && emb2) {
+                    const similarity = this.cosineSimilarity(emb1, emb2);
+                    if (similarity >= threshold) {
+                        duplicates.push([memories[i].id, memories[j].id]);
+                    }
+                }
+            }
+        }
+        return duplicates;
+    }
+    cosineSimilarity(a, b) {
+        let dotProduct = 0;
+        let normA = 0;
+        let normB = 0;
+        for (let i = 0; i < a.length; i++) {
+            dotProduct += a[i] * b[i];
+            normA += a[i] * a[i];
+            normB += b[i] * b[i];
+        }
+        return dotProduct / (Math.sqrt(normA) * Math.sqrt(normB));
+    }
+    close() {
+        this.db.close();
+    }
+}