@sparkleideas/agentic-flow 2.0.2-alpha-patch.1

package/agentic-flow/scripts/claude-flow.ps1

@@ -0,0 +1,24 @@
+#!/usr/bin/env pwsh
+# Claude Flow CLI for PowerShell
+# AI-Driven Development Toolkit
+
+param(
+    [Parameter(ValueFromRemainingArguments=$true)]
+    [string[]]$Arguments
+)
+
+# Check if Node.js is installed
+if (-not (Get-Command node -ErrorAction SilentlyContinue)) {
+    Write-Error "Node.js is not installed or not in PATH"
+    Write-Error "Please install Node.js from https://nodejs.org/"
+    exit 1
+}
+
+# Get the script directory
+$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+
+# Run Claude Flow CLI
+& node "$scriptDir\claude-flow" @Arguments
+
+# Forward the exit code
+exit $LASTEXITCODE

package/agentic-flow/scripts/postinstall.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+/**
+ * Postinstall script for @sparkleideas/agentic-flow
+ *
+ * - Patches AgentDB v1.3.9 import resolution issues
+ * - Handles Windows native module failures gracefully
+ * - This runs after npm install, npm install -g, and npx
+ */
+
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const isWindows = process.platform === 'win32';
+
+function findAgentDBPath() {
+  const possiblePaths = [
+    // npm install (local)
+    join(__dirname, '..', 'node_modules', '@sparkleideas/agentdb'),
+    // npm install -g
+    join(__dirname, '..', '..', '@sparkleideas/agentdb'),
+    // npx (parent directory)
+    join(__dirname, '..', '..', '..', '@sparkleideas/agentdb')
+  ];
+
+  for (const path of possiblePaths) {
+    if (existsSync(join(path, 'package.json'))) {
+      try {
+        const pkg = JSON.parse(readFileSync(join(path, 'package.json'), 'utf8'));
+        if (pkg.name === '@sparkleideas/agentdb') {
+          return path;
+        }
+      } catch {}
+    }
+  }
+
+  return null;
+}
+
+function applyPatch() {
+  console.log('[@sparkleideas/agentic-flow] Checking AgentDB installation...');
+
+  const agentdbPath = findAgentDBPath();
+  if (!agentdbPath) {
+    console.log('[@sparkleideas/agentic-flow] ⚠️  AgentDB not found - skipping patch');
+    return;
+  }
+
+  const controllerIndexPath = join(agentdbPath, 'dist', 'controllers', 'index.js');
+  if (!existsSync(controllerIndexPath)) {
+    console.log('[@sparkleideas/agentic-flow] ⚠️  AgentDB controllers not found');
+    return;
+  }
+
+  let content = readFileSync(controllerIndexPath, 'utf8');
+
+  // Check if already patched
+  if (content.includes("from './ReflexionMemory.js'")) {
+    console.log('[@sparkleideas/agentic-flow] ✅ AgentDB already patched');
+    return;
+  }
+
+  // Apply patches
+  const patches = [
+    { from: "from './ReflexionMemory'", to: "from './ReflexionMemory.js'" },
+    { from: "from './SkillLibrary'", to: "from './SkillLibrary.js'" },
+    { from: "from './EmbeddingService'", to: "from './EmbeddingService.js'" },
+    { from: "from './CausalMemoryGraph'", to: "from './CausalMemoryGraph.js'" },
+    { from: "from './CausalRecall'", to: "from './CausalRecall.js'" },
+    { from: "from './NightlyLearner'", to: "from './NightlyLearner.js'" }
+  ];
+
+  let modified = false;
+  for (const patch of patches) {
+    if (content.includes(patch.from) && !content.includes(patch.to)) {
+      content = content.replace(new RegExp(patch.from, 'g'), patch.to);
+      modified = true;
+    }
+  }
+
+  if (modified) {
+    try {
+      writeFileSync(controllerIndexPath, content, 'utf8');
+      console.log('[@sparkleideas/agentic-flow] ✅ AgentDB imports patched successfully');
+      console.log('[@sparkleideas/agentic-flow]    Fixed ESM import resolution for v1.3.9');
+    } catch (error) {
+      console.log('[@sparkleideas/agentic-flow] ⚠️  Could not write patch (read-only)');
+      console.log('[@sparkleideas/agentic-flow]    This is OK for npx - runtime patch will handle it');
+    }
+  }
+}
+
+function checkNativeModules() {
+  let hasBetterSqlite3 = false;
+  let hasSqlJs = false;
+  let hasSharp = false;
+
+  try {
+    require.resolve('better-sqlite3');
+    hasBetterSqlite3 = true;
+  } catch {}
+
+  try {
+    require.resolve('sql.js');
+    hasSqlJs = true;
+  } catch {}
+
+  try {
+    require.resolve('sharp');
+    hasSharp = true;
+  } catch {}
+
+  console.log('[@sparkleideas/agentic-flow] Native module status:');
+  console.log(`[@sparkleideas/agentic-flow]   better-sqlite3: ${hasBetterSqlite3 ? '✅' : '❌ (using sql.js fallback)'}`);
+  console.log(`[@sparkleideas/agentic-flow]   sql.js:         ${hasSqlJs ? '✅' : '❌'}`);
+  console.log(`[@sparkleideas/agentic-flow]   sharp:          ${hasSharp ? '✅' : '⚠️ (optional, image processing)'}`);
+
+  if (isWindows && !hasBetterSqlite3) {
+    console.log('[@sparkleideas/agentic-flow] ℹ️  Windows detected - using sql.js instead of better-sqlite3');
+    console.log('[@sparkleideas/agentic-flow]    This is normal and fully supported');
+  }
+
+  if (!hasBetterSqlite3 && !hasSqlJs) {
+    console.log('[@sparkleideas/agentic-flow] ⚠️  No SQLite implementation available');
+    console.log('[@sparkleideas/agentic-flow]    Some features may be limited');
+  }
+}
+
+try {
+  applyPatch();
+  checkNativeModules();
+  console.log('[@sparkleideas/agentic-flow] ✅ Postinstall complete');
+} catch (error) {
+  console.log('[@sparkleideas/agentic-flow] ⚠️  Postinstall had issues:', error.message);
+  console.log('[@sparkleideas/agentic-flow]    This is usually OK - runtime will handle fallbacks');
+}

package/agentic-flow/scripts/run-validation.sh

@@ -0,0 +1,165 @@
+#!/bin/bash
+# Comprehensive Validation Script for v1.7.0
+# Runs Docker-based validation and generates report
+
+set -e
+
+echo "================================================================"
+echo "AGENTIC-FLOW v1.7.0 - DOCKER VALIDATION"
+echo "================================================================"
+echo "Started: $(date)"
+echo "================================================================"
+echo ""
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Create results directory
+mkdir -p validation-results
+mkdir -p benchmark-results
+
+# Function to print colored messages
+print_status() {
+    echo -e "${GREEN}✓${NC} $1"
+}
+
+print_error() {
+    echo -e "${RED}✗${NC} $1"
+}
+
+print_warning() {
+    echo -e "${YELLOW}⚠${NC} $1"
+}
+
+# Step 1: Clean previous runs
+echo "Step 1: Cleaning previous validation runs..."
+docker-compose -f docker-compose.validation.yml down -v 2>/dev/null || true
+rm -rf validation-results/* benchmark-results/*
+print_status "Cleaned previous runs"
+echo ""
+
+# Step 2: Build validation image
+echo "Step 2: Building validation Docker image..."
+if docker-compose -f docker-compose.validation.yml build validation; then
+    print_status "Validation image built successfully"
+else
+    print_error "Failed to build validation image"
+    exit 1
+fi
+echo ""
+
+# Step 3: Run validation suite
+echo "Step 3: Running comprehensive validation suite..."
+echo "  This will test:"
+echo "    - Backwards compatibility"
+echo "    - New HybridReasoningBank capabilities"
+echo "    - SharedMemoryPool performance"
+echo "    - AdvancedMemorySystem features"
+echo "    - Memory profiling"
+echo "    - Regression detection"
+echo ""
+
+if docker-compose -f docker-compose.validation.yml run --rm validation; then
+    print_status "Validation suite PASSED"
+    VALIDATION_STATUS=0
+else
+    print_error "Validation suite FAILED"
+    VALIDATION_STATUS=1
+fi
+echo ""
+
+# Step 4: Copy results from container
+echo "Step 4: Extracting validation results..."
+docker cp agentic-flow-validation:/app/validation-results.json validation-results/ 2>/dev/null || true
+if [ -f "validation-results/validation-results.json" ]; then
+    print_status "Results extracted successfully"
+else
+    print_warning "Could not extract results file"
+fi
+echo ""
+
+# Step 5: Display results summary
+echo "Step 5: Validation Results Summary"
+echo "================================================================"
+if [ -f "validation-results/validation-results.json" ]; then
+    # Extract key metrics using jq if available
+    if command -v jq &> /dev/null; then
+        TOTAL=$(jq '.summary.total' validation-results/validation-results.json)
+        PASSED=$(jq '.summary.passed' validation-results/validation-results.json)
+        FAILED=$(jq '.summary.failed' validation-results/validation-results.json)
+        PASS_RATE=$(jq '.summary.passRate' validation-results/validation-results.json)
+
+        echo "Total Tests: $TOTAL"
+        echo "Passed: $PASSED"
+        echo "Failed: $FAILED"
+        echo "Pass Rate: $PASS_RATE%"
+        echo ""
+
+        if [ "$FAILED" -gt 0 ]; then
+            echo "Failed Tests:"
+            jq -r '.results[] | select(.status == "FAIL") | "  - \(.test): \(.error)"' validation-results/validation-results.json
+            echo ""
+        fi
+    else
+        cat validation-results/validation-results.json
+    fi
+else
+    print_warning "No results file found - check Docker logs"
+fi
+echo "================================================================"
+echo ""
+
+# Step 6: Run regression tests (optional - if validation passed)
+if [ $VALIDATION_STATUS -eq 0 ]; then
+    echo "Step 6: Running regression tests..."
+    if docker-compose -f docker-compose.validation.yml run --rm regression 2>/dev/null; then
+        print_status "Regression tests PASSED"
+    else
+        print_warning "Some regression tests failed (check logs)"
+    fi
+    echo ""
+fi
+
+# Step 7: Run performance benchmarks (optional)
+echo "Step 7: Running performance benchmarks..."
+echo "  (This may take several minutes)"
+if docker-compose -f docker-compose.validation.yml run --rm benchmark 2>/dev/null; then
+    print_status "Benchmarks completed"
+else
+    print_warning "Benchmarks incomplete (check logs)"
+fi
+echo ""
+
+# Step 8: Cleanup
+echo "Step 8: Cleaning up Docker resources..."
+docker-compose -f docker-compose.validation.yml down -v
+print_status "Cleanup complete"
+echo ""
+
+# Final Summary
+echo "================================================================"
+echo "VALIDATION COMPLETE"
+echo "================================================================"
+echo "Completed: $(date)"
+echo ""
+
+if [ $VALIDATION_STATUS -eq 0 ]; then
+    echo -e "${GREEN}✓✓✓ ALL VALIDATIONS PASSED ✓✓✓${NC}"
+    echo ""
+    echo "Next steps:"
+    echo "  1. Review results in validation-results/"
+    echo "  2. Check benchmark-results/ for performance metrics"
+    echo "  3. Proceed with release"
+    exit 0
+else
+    echo -e "${RED}✗✗✗ VALIDATION FAILED ✗✗✗${NC}"
+    echo ""
+    echo "Action required:"
+    echo "  1. Review failed tests in validation-results/"
+    echo "  2. Check Docker logs: docker-compose -f docker-compose.validation.yml logs"
+    echo "  3. Fix issues before release"
+    exit 1
+fi

package/agentic-flow/scripts/test-agentdb.sh

@@ -0,0 +1,153 @@
+#!/bin/bash
+# AgentDB CLI Quick Test Script
+
+set -e
+
+echo "🧪 AgentDB CLI Testing Script"
+echo "=============================="
+echo ""
+
+# Set test database path
+export AGENTDB_PATH="./test-agentdb.db"
+
+# Clean up old test database
+if [ -f "$AGENTDB_PATH" ]; then
+  echo "🗑️  Removing old test database..."
+  rm "$AGENTDB_PATH"
+fi
+
+echo "📍 Current directory: $(pwd)"
+echo "💾 Database path: $AGENTDB_PATH"
+echo ""
+
+# Test 1: Help command
+echo "1️⃣  Testing help command..."
+echo ""
+node dist/agentdb/cli/agentdb-cli.js --help | head -20
+echo ""
+echo "✅ Help command works!"
+echo ""
+
+# Test 2: Store a successful episode
+echo "2️⃣  Storing a successful episode..."
+node dist/agentdb/cli/agentdb-cli.js reflexion store \
+  "test-session-1" \
+  "implement_authentication" \
+  0.95 \
+  true \
+  "Successfully implemented OAuth2 with JWT tokens" \
+  "User login requirement" \
+  "Working auth system with refresh tokens" \
+  1200 \
+  5000
+echo ""
+
+# Test 3: Store a failed episode
+echo "3️⃣  Storing a failed episode..."
+node dist/agentdb/cli/agentdb-cli.js reflexion store \
+  "test-session-1" \
+  "implement_authentication" \
+  0.35 \
+  false \
+  "Forgot to validate token expiration" \
+  "User login requirement" \
+  "Insecure auth system" \
+  800 \
+  3000
+echo ""
+
+# Test 4: Retrieve episodes
+echo "4️⃣  Retrieving episodes..."
+node dist/agentdb/cli/agentdb-cli.js reflexion retrieve \
+  "authentication" \
+  5 \
+  0.3
+echo ""
+
+# Test 5: Get critique summary
+echo "5️⃣  Getting critique summary (failures only)..."
+node dist/agentdb/cli/agentdb-cli.js reflexion critique-summary \
+  "authentication" \
+  true
+echo ""
+
+# Test 6: Create a skill
+echo "6️⃣  Creating a skill..."
+node dist/agentdb/cli/agentdb-cli.js skill create \
+  "jwt_authentication" \
+  "Generate and validate JWT tokens for user authentication" \
+  "function generateJWT(payload, secret) { return jwt.sign(payload, secret, { expiresIn: '1h' }); }"
+echo ""
+
+# Test 7: Search skills
+echo "7️⃣  Searching for skills..."
+node dist/agentdb/cli/agentdb-cli.js skill search \
+  "authentication" \
+  5
+echo ""
+
+# Test 8: Add a causal edge
+echo "8️⃣  Adding a causal edge..."
+node dist/agentdb/cli/agentdb-cli.js causal add-edge \
+  "add_unit_tests" \
+  "code_quality_score" \
+  0.25 \
+  0.95 \
+  100
+echo ""
+
+# Test 9: Create an experiment
+echo "9️⃣  Creating an A/B experiment..."
+node dist/agentdb/cli/agentdb-cli.js causal experiment create \
+  "test-coverage-vs-bugs" \
+  "test_coverage" \
+  "bug_rate"
+echo ""
+
+# Test 10: Add experiment observations
+echo "🔟 Adding experiment observations..."
+echo "   - Treatment group (high test coverage)..."
+node dist/agentdb/cli/agentdb-cli.js causal experiment add-observation \
+  1 \
+  true \
+  0.15 \
+  '{"coverage": 0.85, "lines": 5000}'
+echo "   - Control group (low test coverage)..."
+node dist/agentdb/cli/agentdb-cli.js causal experiment add-observation \
+  1 \
+  false \
+  0.35 \
+  '{"coverage": 0.45, "lines": 5000}'
+echo ""
+
+# Test 11: Calculate experiment uplift
+echo "1️⃣1️⃣  Calculating experiment uplift..."
+node dist/agentdb/cli/agentdb-cli.js causal experiment calculate 1
+echo ""
+
+# Test 12: Query causal edges
+echo "1️⃣2️⃣  Querying causal edges..."
+node dist/agentdb/cli/agentdb-cli.js causal query \
+  "" \
+  "" \
+  0.5 \
+  0.1 \
+  10
+echo ""
+
+# Test 13: Database stats
+echo "1️⃣3️⃣  Getting database statistics..."
+node dist/agentdb/cli/agentdb-cli.js db stats
+echo ""
+
+# Summary
+echo "=============================="
+echo "✅ All 13 tests completed successfully!"
+echo ""
+echo "📊 Test database created at: $AGENTDB_PATH"
+echo "📁 Size: $(du -h "$AGENTDB_PATH" | cut -f1)"
+echo ""
+echo "🔍 You can now explore the database or run individual commands:"
+echo "   node dist/agentdb/cli/agentdb-cli.js --help"
+echo "   AGENTDB_PATH=$AGENTDB_PATH node dist/agentdb/cli/agentdb-cli.js reflexion retrieve authentication 5"
+echo ""

package/agentic-flow/scripts/test-all-commands.sh

@@ -0,0 +1,46 @@
+#!/bin/bash
+# Comprehensive CLI command validation script
+
+set -e
+
+echo "🧪 Testing agentic-flow CLI commands..."
+echo "========================================"
+echo ""
+
+# Test 1: Help command
+echo "1️⃣  Testing --help..."
+agentic-flow --help > /dev/null 2>&1 && echo "✅ --help works" || echo "❌ --help failed"
+echo ""
+
+# Test 2: List agents
+echo "2️⃣  Testing --list..."
+agentic-flow --list > /dev/null 2>&1 && echo "✅ --list works" || echo "❌ --list failed"
+echo ""
+
+# Test 3: MCP commands
+echo "3️⃣  Testing MCP commands..."
+
+echo "   Testing: mcp --help"
+agentic-flow mcp --help > /dev/null 2>&1 && echo "   ✅ mcp --help works" || echo "   ❌ mcp --help failed"
+
+echo ""
+
+# Test 4: Version check
+echo "4️⃣  Testing version display..."
+agentic-flow --help | grep -q "v1.0" && echo "✅ Version displayed" || echo "❌ Version not displayed"
+echo ""
+
+# Test 5: Agent execution (should fail gracefully without API key)
+echo "5️⃣  Testing agent execution without API key..."
+output=$(agentic-flow --agent coder --task "test" 2>&1 || true)
+if echo "$output" | grep -q "ANTHROPIC_API_KEY"; then
+    echo "✅ Agent execution shows proper API key error"
+elif echo "$output" | grep -q "Error"; then
+    echo "⚠️  Agent execution shows error (expected without API key)"
+else
+    echo "❌ Unexpected agent execution behavior"
+fi
+echo ""
+
+echo "========================================"
+echo "✅ All basic CLI commands validated!"

package/agentic-flow/scripts/test-claude-flow-sdk.sh

@@ -0,0 +1,46 @@
+#!/bin/bash
+# Test script for FastMCP claude-flow-sdk server (6 tools)
+set -e
+
+echo "🧪 Testing FastMCP claude-flow-sdk Server (6 tools)..."
+echo ""
+
+# Build first
+echo "📦 Building project..."
+npm run build
+echo ""
+
+# Test 1: memory_store
+echo "🧪 Test 1: memory_store"
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"memory_store","arguments":{"key":"sdk-test","value":"fastmcp-value","namespace":"sdk-test"}}}' | node dist/mcp/fastmcp/servers/claude-flow-sdk.js 2>/dev/null || true
+echo ""
+
+# Test 2: memory_retrieve
+echo "🧪 Test 2: memory_retrieve"
+echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"memory_retrieve","arguments":{"key":"sdk-test","namespace":"sdk-test"}}}' | node dist/mcp/fastmcp/servers/claude-flow-sdk.js 2>/dev/null || true
+echo ""
+
+# Test 3: memory_search
+echo "🧪 Test 3: memory_search"
+echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"memory_search","arguments":{"pattern":"sdk-*","limit":5}}}' | node dist/mcp/fastmcp/servers/claude-flow-sdk.js 2>/dev/null || true
+echo ""
+
+# Test 4: swarm_init
+echo "🧪 Test 4: swarm_init"
+echo '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"swarm_init","arguments":{"topology":"mesh","maxAgents":5}}}' | node dist/mcp/fastmcp/servers/claude-flow-sdk.js 2>/dev/null || true
+echo ""
+
+# Test 5: agent_spawn
+echo "🧪 Test 5: agent_spawn"
+echo '{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"agent_spawn","arguments":{"type":"researcher"}}}' | node dist/mcp/fastmcp/servers/claude-flow-sdk.js 2>/dev/null || true
+echo ""
+
+# Test 6: task_orchestrate
+echo "🧪 Test 6: task_orchestrate"
+echo '{"jsonrpc":"2.0","id":6,"method":"tools/call","params":{"name":"task_orchestrate","arguments":{"task":"Test task orchestration","strategy":"parallel"}}}' | node dist/mcp/fastmcp/servers/claude-flow-sdk.js 2>/dev/null || true
+echo ""
+
+echo "✅ claude-flow-sdk server tests completed!"
+echo ""
+echo "📋 To use with Claude Code, add to MCP config:"
+echo '{"mcpServers":{"claude-flow-sdk-fastmcp":{"command":"node","args":["dist/mcp/fastmcp/servers/claude-flow-sdk.js"]}}}'