agentic-flow 1.5.12 → 1.6.0

package/dist/reasoningbank/backend-selector.js

@@ -0,0 +1,145 @@
+/**
+ * Backend Selection Helper for ReasoningBank
+ *
+ * Automatically selects the optimal ReasoningBank backend based on runtime environment.
+ *
+ * Usage:
+ * ```typescript
+ * import { createOptimalReasoningBank, getRecommendedBackend } from 'agentic-flow/reasoningbank/backend-selector';
+ *
+ * // Automatic backend selection
+ * const rb = await createOptimalReasoningBank('my-db');
+ *
+ * // Manual check
+ * const backend = getRecommendedBackend();
+ * console.log(`Using ${backend} backend`);
+ * ```
+ */
+/**
+ * Detect runtime environment and recommend optimal backend
+ *
+ * @returns 'nodejs' for Node.js/Deno environments, 'wasm' for browsers
+ */
+export function getRecommendedBackend() {
+    // Check for browser environment
+    if (typeof window !== 'undefined' && typeof document !== 'undefined') {
+        return 'wasm';
+    }
+    // Check for Node.js/Deno
+    if (typeof process !== 'undefined' && process.versions?.node) {
+        return 'nodejs';
+    }
+    // Default to WASM for unknown environments (likely web workers, etc.)
+    return 'wasm';
+}
+/**
+ * Check if IndexedDB is available (browser environment)
+ */
+export function hasIndexedDB() {
+    return typeof indexedDB !== 'undefined';
+}
+/**
+ * Check if SQLite native module is available (Node.js)
+ */
+export function hasSQLite() {
+    try {
+        require.resolve('better-sqlite3');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Create ReasoningBank instance with optimal backend for current environment
+ *
+ * @param dbName - Database name (used differently by each backend)
+ * @param options - Additional configuration options
+ * @returns ReasoningBank instance using optimal backend
+ *
+ * @example
+ * ```typescript
+ * // Node.js: Creates SQLite database at .swarm/my-app.db
+ * const rb = await createOptimalReasoningBank('my-app');
+ *
+ * // Browser: Creates IndexedDB database named 'my-app'
+ * const rb = await createOptimalReasoningBank('my-app');
+ * ```
+ */
+export async function createOptimalReasoningBank(dbName = 'reasoningbank', options = {}) {
+    const backend = options.forceBackend || getRecommendedBackend();
+    if (options.verbose) {
+        console.log(`[ReasoningBank] Environment: ${backend}`);
+        console.log(`[ReasoningBank] Database: ${dbName}`);
+    }
+    if (backend === 'nodejs') {
+        // Import Node.js backend (SQLite)
+        const reasoningBankModule = await import('./index.js');
+        const dbPath = options.dbPath || `.swarm/${dbName}.db`;
+        if (options.verbose) {
+            console.log(`[ReasoningBank] Using Node.js backend with SQLite`);
+            console.log(`[ReasoningBank] Database path: ${dbPath}`);
+        }
+        // The Node.js backend uses the db module and core algorithms
+        // Initialize the database
+        await reasoningBankModule.initialize();
+        // Note: The Node.js backend has a different API than WASM
+        // It uses the functions from db/queries.ts and core algorithms
+        // We return the full module for direct access to all functions
+        return reasoningBankModule;
+    }
+    else {
+        // Import WASM backend (IndexedDB in browser, Memory in Node.js)
+        const { createReasoningBank } = await import('./wasm-adapter.js');
+        if (options.verbose) {
+            const storageType = hasIndexedDB() ? 'IndexedDB (persistent)' : 'Memory (ephemeral)';
+            console.log(`[ReasoningBank] Using WASM backend with ${storageType}`);
+            console.log(`[ReasoningBank] Database name: ${dbName}`);
+        }
+        return await createReasoningBank(dbName);
+    }
+}
+/**
+ * Get backend information and capabilities
+ */
+export function getBackendInfo() {
+    const backend = getRecommendedBackend();
+    return {
+        backend,
+        environment: typeof window !== 'undefined' ? 'browser' : 'nodejs',
+        features: {
+            persistent: backend === 'nodejs' || hasIndexedDB(),
+            sqlite: backend === 'nodejs' && hasSQLite(),
+            indexeddb: backend === 'wasm' && hasIndexedDB(),
+            wasm: backend === 'wasm',
+        },
+        storage: backend === 'nodejs'
+            ? 'SQLite (disk)'
+            : hasIndexedDB()
+                ? 'IndexedDB (browser)'
+                : 'Memory (ephemeral)',
+    };
+}
+/**
+ * Validate environment and warn about limitations
+ */
+export function validateEnvironment() {
+    const backend = getRecommendedBackend();
+    const warnings = [];
+    let valid = true;
+    if (backend === 'nodejs' && !hasSQLite()) {
+        warnings.push('better-sqlite3 not found - database operations will fail');
+        valid = false;
+    }
+    if (backend === 'wasm' && typeof window !== 'undefined' && !hasIndexedDB()) {
+        warnings.push('IndexedDB not available - using ephemeral memory storage');
+        warnings.push('Data will be lost when page/process exits');
+    }
+    if (backend === 'wasm' && typeof window === 'undefined') {
+        warnings.push('WASM in Node.js uses in-memory storage (ephemeral)');
+        warnings.push('Consider using Node.js backend for persistence');
+    }
+    return { valid, warnings, backend };
+}
+// Export validation helper for use in initialization
+export { validateEnvironment as checkEnvironment };

package/dist/reasoningbank/index.js

@@ -4,6 +4,10 @@
  * Main entry point and public API
  *
  * Paper: https://arxiv.org/html/2509.25140v1
+ *
+ * This is the Node.js backend using SQLite for persistent storage.
+ * For browser environments, use './wasm-adapter.js' instead.
+ * For automatic backend selection, use './backend-selector.js'.
  */
 // Core algorithms
 export { retrieveMemories, formatMemoriesForPrompt } from './core/retrieve.js';

package/dist/transport/quic.js

@@ -408,3 +408,46 @@ export class QuicConnectionPool {
         this.connections.clear();
     }
 }
+export class QuicTransport {
+    client;
+    config;
+    constructor(config = {}) {
+        this.config = config;
+        this.client = new QuicClient({
+            serverHost: config.host || 'localhost',
+            serverPort: config.port || 4433,
+            maxConcurrentStreams: config.maxConcurrentStreams || 100,
+            certPath: config.certPath,
+            keyPath: config.keyPath
+        });
+    }
+    /**
+     * Connect to QUIC server
+     */
+    async connect() {
+        await this.client.initialize();
+        await this.client.connect();
+    }
+    /**
+     * Send data over QUIC
+     */
+    async send(data) {
+        // Convert data to bytes and send
+        const jsonStr = JSON.stringify(data);
+        const bytes = new TextEncoder().encode(jsonStr);
+        // Implementation will use QUIC client to send
+        logger.debug('Sending data via QUIC', { bytes: bytes.length });
+    }
+    /**
+     * Close connection
+     */
+    async close() {
+        await this.client.shutdown();
+    }
+    /**
+     * Get connection statistics
+     */
+    getStats() {
+        return this.client.getStats();
+    }
+}

package/dist/utils/cli.js

@@ -14,6 +14,11 @@ export function parseArgs() {
         options.mode = 'claude-code';
         return options;
     }
+    // Check for quic command
+    if (args[0] === 'quic') {
+        options.mode = 'quic';
+        return options;
+    }
     // Check for MCP command
     if (args[0] === 'mcp') {
         const mcpSubcommand = args[1];

package/docs/.claude-flow/metrics/performance.json

@@ -1,9 +1,87 @@
 {
-  "startTime": 1759768557067,
+  "startTime": 1760479381385,
+  "sessionId": "session-1760479381385",
+  "lastActivity": 1760479381385,
+  "sessionDuration": 0,
   "totalTasks": 1,
   "successfulTasks": 1,
   "failedTasks": 0,
   "totalAgents": 0,
   "activeAgents": 0,
-  "neuralEvents": 0
+  "neuralEvents": 0,
+  "memoryMode": {
+    "reasoningbankOperations": 0,
+    "basicOperations": 0,
+    "autoModeSelections": 0,
+    "modeOverrides": 0,
+    "currentMode": "auto"
+  },
+  "operations": {
+    "store": {
+      "count": 0,
+      "totalDuration": 0,
+      "errors": 0
+    },
+    "retrieve": {
+      "count": 0,
+      "totalDuration": 0,
+      "errors": 0
+    },
+    "query": {
+      "count": 0,
+      "totalDuration": 0,
+      "errors": 0
+    },
+    "list": {
+      "count": 0,
+      "totalDuration": 0,
+      "errors": 0
+    },
+    "delete": {
+      "count": 0,
+      "totalDuration": 0,
+      "errors": 0
+    },
+    "search": {
+      "count": 0,
+      "totalDuration": 0,
+      "errors": 0
+    },
+    "init": {
+      "count": 0,
+      "totalDuration": 0,
+      "errors": 0
+    }
+  },
+  "performance": {
+    "avgOperationDuration": 0,
+    "minOperationDuration": null,
+    "maxOperationDuration": null,
+    "slowOperations": 0,
+    "fastOperations": 0,
+    "totalOperationTime": 0
+  },
+  "storage": {
+    "totalEntries": 0,
+    "reasoningbankEntries": 0,
+    "basicEntries": 0,
+    "databaseSize": 0,
+    "lastBackup": null,
+    "growthRate": 0
+  },
+  "errors": {
+    "total": 0,
+    "byType": {},
+    "byOperation": {},
+    "recent": []
+  },
+  "reasoningbank": {
+    "semanticSearches": 0,
+    "sqlFallbacks": 0,
+    "embeddingGenerated": 0,
+    "consolidations": 0,
+    "avgQueryTime": 0,
+    "cacheHits": 0,
+    "cacheMisses": 0
+  }
 }

package/docs/.claude-flow/metrics/task-metrics.json

@@ -1,10 +1,10 @@
 [
   {
-    "id": "cmd-hooks-1759768557202",
+    "id": "cmd-hooks-1760479381514",
     "type": "hooks",
     "success": true,
-    "duration": 9.268956000000003,
-    "timestamp": 1759768557212,
+    "duration": 1759.4118409999999,
+    "timestamp": 1760479383273,
     "metadata": {}
   }
 ]

package/docs/INDEX.md

@@ -7,8 +7,8 @@ Complete documentation for the Agentic Flow multi-agent orchestration system.
 ### 🚀 Start Here
 - **[README](../README.md)** - Project overview and getting started
 - **[CLAUDE.md](CLAUDE.md)** - Claude Code configuration and SPARC methodology
-- **[PACKAGE_STRUCTURE.md](PACKAGE_STRUCTURE.md)** - Package organization and structure
-- **[STANDALONE_PROXY_GUIDE.md](STANDALONE_PROXY_GUIDE.md)** - Standalone proxy server setup
+- **[PACKAGE_STRUCTURE.md](architecture/PACKAGE_STRUCTURE.md)** - Package organization and structure
+- **[STANDALONE_PROXY_GUIDE.md](guides/STANDALONE_PROXY_GUIDE.md)** - Standalone proxy server setup
 
 ---
 
@@ -55,7 +55,7 @@ Multi-model router configuration and usage.
 - [Top 20 Models Matrix](router/TOP20_MODELS_MATRIX.md) - Model comparison guide
 
 ### ✅ [Testing & Validation](testing/)
-Current test results, validation reports, and quality assurance.
+Current test results and development testing documentation.
 
 - [Testing Overview](testing/README.md) - Current testing documentation
 - [Agent System Validation](testing/AGENT-SYSTEM-VALIDATION.md) - Multi-agent testing
@@ -63,6 +63,8 @@ Current test results, validation reports, and quality assurance.
 - [Regression Test Results](testing/REGRESSION-TEST-RESULTS.md) - Regression testing
 - [Streaming & MCP Validation](testing/STREAMING-AND-MCP-VALIDATION.md) - Integration tests
 
+For production validation reports, see [Validation Reports](validation-reports/)
+
 ### 🔍 [MCP Validation](mcp-validation/)
 Model Context Protocol implementation and validation.
 
@@ -71,13 +73,47 @@ Model Context Protocol implementation and validation.
 - [CLI Validation Report](mcp-validation/MCP-CLI-VALIDATION-REPORT.md) - CLI tool testing
 - [Strange Loops Test](mcp-validation/strange-loops-test.md) - Advanced patterns
 
-### 📦 [Releases](releases/)
+### 📦 [Version Releases](version-releases/)
 Version-specific release notes and publishing documentation.
 
-- [Release Overview](releases/README.md) - Release documentation index
-- [v1.2.0 Release](releases/RELEASE-v1.2.0.md) - Latest stable release
-- [v1.2.0 Publishing Guide](releases/NPM-PUBLISH-GUIDE-v1.2.0.md) - Publishing process
-- [v1.2.1 Hotfix](releases/HOTFIX-v1.2.1.md) - Critical fixes
+- [Release Overview](version-releases/README.md) - Release documentation index
+- [v1.5.11 Publication Report](version-releases/PUBLICATION_REPORT_v1.5.11.md) - Latest release
+- [v1.5.9 Release Summary](version-releases/v1.5.9-RELEASE-SUMMARY.md) - Previous release
+- [v1.5.9 Docker Verification](version-releases/v1.5.9-DOCKER-VERIFICATION.md) - Docker validation
+
+### 🧠 [ReasoningBank](reasoningbank/)
+Cognitive memory system with pattern recognition and adaptive learning.
+
+- [ReasoningBank Overview](reasoningbank/README.md) - Feature documentation index
+- [Architecture](reasoningbank/REASONINGBANK_ARCHITECTURE.md) - System architecture
+- [Backends](reasoningbank/REASONINGBANK_BACKENDS.md) - Storage backend options
+- [Validation](reasoningbank/REASONINGBANK_VALIDATION.md) - Testing and validation
+- [Benchmarks](reasoningbank/REASONINGBANK-BENCHMARK-RESULTS.md) - Performance metrics
+
+### ✅ [Validation Reports](validation-reports/)
+Comprehensive testing, benchmarking, and quality assurance reports.
+
+- [Validation Overview](validation-reports/README.md) - Testing documentation index
+- [Performance Benchmarks](validation-reports/BENCHMARK_AND_OPTIMIZATION_REPORT.md) - Optimization analysis
+- [Docker Validation](validation-reports/DOCKER_VALIDATION_RESULTS.md) - Container testing
+- [Regression Tests](validation-reports/NO_REGRESSIONS_CONFIRMED.md) - Stability verification
+- [Alpha Validation](validation-reports/V2.7.0-ALPHA.10_FINAL_VALIDATION.md) - Release validation
+
+### 🔌 [Integration Documentation](integration-docs/)
+System integrations, implementations, and compatibility reports.
+
+- [Integration Overview](integration-docs/README.md) - Integration documentation index
+- [Agent Booster](integration-docs/AGENT-BOOSTER-INTEGRATION.md) - Ultra-fast code editing
+- [Claude Flow](integration-docs/CLAUDE-FLOW-INTEGRATION-ANALYSIS.md) - Orchestration integration
+- [WASM Integration](integration-docs/WASM_INTEGRATION_COMPLETE.md) - WebAssembly support
+- [CLI Tools](integration-docs/CLI-INTEGRATION-COMPLETE.md) - Command-line integration
+
+### 🔬 [Quantum Research](quantum-research/)
+Quantum computing research, literature reviews, and experimental plans.
+
+- [Quantum Overview](quantum-research/README.md) - Research documentation index
+- [Literature Review](quantum-research/QUANTUM_RESEARCH_LITERATURE_REVIEW.md) - Comprehensive research
+- [Observer-Agnostic Experiment](../examples/Observer-Agnostic%20Measurement%20and%20No-Retrocausal%20Marginals%20Theorem/) - Quantum measurement testing
 
 ### 🗄️ [Validation Archive](validation/)
 Historical validation reports and test archives.
@@ -220,10 +256,20 @@ Historical reports, completed implementations, and superseded guides are in the
 ---
 
 **Documentation Status**: ✅ Reorganized and up-to-date
-**Last Updated**: October 6, 2025
+**Last Updated**: October 14, 2025
 
 ## 📋 Recent Documentation Updates
 
+**v2.7.0 Reorganization (Oct 14, 2025)**:
+- Created `reasoningbank/` for all ReasoningBank feature documentation
+- Created `validation-reports/` for production testing and validation
+- Created `integration-docs/` for system integration documentation
+- Created `quantum-research/` for quantum computing research
+- Created `version-releases/` for release notes and changelogs
+- Added comprehensive README files to all new categories
+- Consolidated loose files into organized subdirectories
+- Improved navigation and discoverability
+
 **v2.0 Reorganization (Oct 6, 2025)**:
 - Created dedicated `releases/` directory for version-specific documentation
 - Consolidated testing reports into `testing/` directory