Back to Ruflo

ReasoningBank Integration Status (v2.7.0-alpha)

v2/docs/integrations/reasoningbank/REASONINGBANK-INTEGRATION-STATUS.md

3.6.306.1 KB
Original Source

ReasoningBank Integration Status (v2.7.0-alpha)

Current Status: ⚠️ Partially Implemented

✅ What Works

  1. Initialization: memory init --reasoningbank

    • Creates .swarm/memory.db database
    • Initializes schema with migrations
    • Fully functional
  2. Status Check: memory status --reasoningbank

    • Shows database statistics
    • Displays memory counts
    • Fully functional
  3. Mode Detection: memory detect

    • Detects available memory modes
    • Shows configuration
    • Fully functional

❌ What Doesn't Work (v2.7.0)

Direct CLI Memory Operations:

  • memory store key "value" --reasoningbank
  • memory query "search" --reasoningbank

Root Cause: Agentic-flow's ReasoningBank doesn't expose store/query as CLI commands. It's designed to be used by agents during task execution, not as a standalone memory store.

How ReasoningBank Actually Works

ReasoningBank is an agent-centric memory system:

bash
# ✅ CORRECT: Use via agent execution
npx agentic-flow --agent coder --task "Build REST API using best practices"

# During execution, the agent:
# 1. Retrieves relevant memories from ReasoningBank
# 2. Uses them to inform its work
# 3. Stores new learnings back to ReasoningBank
# 4. Updates confidence scores based on success/failure
bash
# ❌ INCORRECT: Direct CLI memory operations
npx claude-flow memory store pattern "..." --reasoningbank
# This doesn't work because ReasoningBank has no store/query CLI commands

Working Solutions (v2.7.0)

Solution 1: Use Basic Memory Mode (Default)

bash
# Standard key-value memory (always works)
claude-flow memory store api_pattern "Use environment variables for config"
claude-flow memory query "API"
claude-flow memory stats

Solution 2: Use ReasoningBank via Agents

bash
# Initialize ReasoningBank
claude-flow memory init --reasoningbank

# Use agentic-flow agents (they'll use ReasoningBank automatically)
npx agentic-flow --agent coder --task "Implement user authentication"

# The agent will:
# - Query ReasoningBank for relevant patterns
# - Learn from past successes/failures
# - Store new learnings automatically

Solution 3: Use ReasoningBank Tools Directly

bash
# View available tools
npx agentic-flow reasoningbank --help

# Available commands:
npx agentic-flow reasoningbank demo          # Interactive demo
npx agentic-flow reasoningbank test          # Validation tests
npx agentic-flow reasoningbank status        # Statistics
npx agentic-flow reasoningbank benchmark     # Performance tests
npx agentic-flow reasoningbank consolidate   # Memory cleanup
npx agentic-flow reasoningbank list          # List memories

Planned for v2.7.1

Full CLI Integration:

  • Implement direct store/query operations
  • Bridge claude-flow memory commands to ReasoningBank SDK
  • Add migration tool: memory migrate --to reasoningbank

Implementation Plan:

  1. Import agentic-flow's ReasoningBank SDK directly
  2. Wrap SDK methods in claude-flow memory commands
  3. Provide seamless experience for both modes

Current Workaround

If you initialized ReasoningBank and want to use its learning capabilities:

bash
# 1. Initialize (one-time)
claude-flow memory init --reasoningbank

# 2. Use basic memory for manual storage
claude-flow memory store api_best_practice "Always validate input"

# 3. Use agentic-flow agents for AI-powered learning
npx agentic-flow --agent coder --task "Build secure API endpoints"

# The agent will:
# - Access ReasoningBank automatically
# - Learn from your basic memory entries
# - Store new learnings with confidence scores

Architecture

┌─────────────────────────────────────┐
│      claude-flow memory             │
├─────────────────────────────────────┤
│                                     │
│  Basic Mode (default)               │
│  ├─ store/query/stats ✅            │
│  ├─ JSON file storage               │
│  └─ Fast, simple KV store           │
│                                     │
│  ReasoningBank Mode                 │
│  ├─ init ✅                          │
│  ├─ status ✅                        │
│  ├─ detect ✅                        │
│  ├─ store ❌ (v2.7.1)               │
│  └─ query ❌ (v2.7.1)               │
│                                     │
└─────────────────────────────────────┘
           │
           ├─ Used by ─┐
           │           │
           ▼           ▼
┌────────────────┐  ┌────────────────────┐
│ Basic Memory   │  │  agentic-flow      │
│ (JSON file)    │  │  agents            │
└────────────────┘  │                    │
                    │ ├─ coder           │
                    │ ├─ researcher      │
                    │ ├─ reviewer        │
                    │ └─ etc.            │
                    │                    │
                    │ Uses ReasoningBank │
                    │ automatically ✅    │
                    └────────────────────┘

Summary

v2.7.0-alpha Status:

  • ✅ ReasoningBank initialization works
  • ✅ Status and monitoring work
  • ❌ Direct store/query CLI not implemented
  • ✅ Agent-based usage fully functional

Recommended Approach:

  1. Use basic mode for manual memory operations
  2. Use agentic-flow agents for AI-powered learning with ReasoningBank
  3. Wait for v2.7.1 for full CLI integration

Not a Bug: This is an architectural limitation, not a bug. ReasoningBank was designed for agent use, and v2.7.0 exposes that functionality correctly through agentic-flow agents.

The v2.7.1 release will add convenience CLI wrappers for direct memory operations.