Skip to content

armgit / ruflo

Public Imported from GitHub
0

🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated

checkpoint: File edit:

rUv3079a73a45a4
diff --git a/.claude/helpers/learning-hooks.sh b/.claude/helpers/learning-hooks.sh
new file mode 100755
index 0000000000..4b65022091
--- /dev/null
+++ b/.claude/helpers/learning-hooks.sh
@@ -0,0 +1,329 @@
+#!/bin/bash
+# Claude Flow V3 - Learning Hooks
+# Integrates learning-service.mjs with session lifecycle
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+LEARNING_SERVICE="$SCRIPT_DIR/learning-service.mjs"
+LEARNING_DIR="$PROJECT_ROOT/.claude-flow/learning"
+METRICS_DIR="$PROJECT_ROOT/.claude-flow/metrics"
+
+# Ensure directories exist
+mkdir -p "$LEARNING_DIR" "$METRICS_DIR"
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+RED='\033[0;31m'
+DIM='\033[2m'
+RESET='\033[0m'
+
+log() { echo -e "${CYAN}[Learning] $1${RESET}"; }
+success() { echo -e "${GREEN}[Learning] βœ“ $1${RESET}"; }
+warn() { echo -e "${YELLOW}[Learning] ⚠ $1${RESET}"; }
+error() { echo -e "${RED}[Learning] βœ— $1${RESET}"; }
+
+# Generate session ID
+generate_session_id() {
+ echo "session_$(date +%Y%m%d_%H%M%S)_$$"
+}
+
+# =============================================================================
+# Session Start Hook
+# =============================================================================
+session_start() {
+ local session_id="${1:-$(generate_session_id)}"
+
+ log "Initializing learning service for session: $session_id"
+
+ # Check if better-sqlite3 is available
+ if ! npm list better-sqlite3 --prefix "$PROJECT_ROOT" >/dev/null 2>&1; then
+ log "Installing better-sqlite3..."
+ npm install --prefix "$PROJECT_ROOT" better-sqlite3 --save-dev --silent 2>/dev/null || true
+ fi
+
+ # Initialize learning service
+ local init_result
+ init_result=$(node "$LEARNING_SERVICE" init "$session_id" 2>&1)
+
+ if [ $? -eq 0 ]; then
+ # Parse and display stats
+ local short_term=$(echo "$init_result" | grep -o '"shortTermPatterns":[0-9]*' | cut -d: -f2)
+ local long_term=$(echo "$init_result" | grep -o '"longTermPatterns":[0-9]*' | cut -d: -f2)
+
+ success "Learning service initialized"
+ echo -e " ${DIM}β”œβ”€ Short-term patterns: ${short_term:-0}${RESET}"
+ echo -e " ${DIM}β”œβ”€ Long-term patterns: ${long_term:-0}${RESET}"
+ echo -e " ${DIM}└─ Session ID: $session_id${RESET}"
+
+ # Store session ID for later hooks
+ echo "$session_id" > "$LEARNING_DIR/current-session-id"
+
+ # Update metrics
+ cat > "$METRICS_DIR/learning-status.json" << EOF
+{
+ "sessionId": "$session_id",
+ "initialized": true,
+ "shortTermPatterns": ${short_term:-0},
+ "longTermPatterns": ${long_term:-0},
+ "hnswEnabled": true,
+ "timestamp": "$(date -Iseconds)"
+}
+EOF
+
+ return 0
+ else
+ warn "Learning service initialization failed (non-critical)"
+ echo "$init_result" | head -5
+ return 1
+ fi
+}
+
+# =============================================================================
+# Session End Hook
+# =============================================================================
+session_end() {
+ log "Consolidating learning data..."
+
+ # Get session ID
+ local session_id=""
+ if [ -f "$LEARNING_DIR/current-session-id" ]; then
+ session_id=$(cat "$LEARNING_DIR/current-session-id")
+ fi
+
+ # Export session data
+ local export_result
+ export_result=$(node "$LEARNING_SERVICE" export 2>&1)
+
+ if [ $? -eq 0 ]; then
+ # Save export
+ echo "$export_result" > "$LEARNING_DIR/session-export-$(date +%Y%m%d_%H%M%S).json"
+
+ local patterns=$(echo "$export_result" | grep -o '"patterns":[0-9]*' | cut -d: -f2)
+ log "Session exported: $patterns patterns"
+ fi
+
+ # Run consolidation
+ local consolidate_result
+ consolidate_result=$(node "$LEARNING_SERVICE" consolidate 2>&1)
+
+ if [ $? -eq 0 ]; then
+ local removed=$(echo "$consolidate_result" | grep -o '"duplicatesRemoved":[0-9]*' | cut -d: -f2)
+ local pruned=$(echo "$consolidate_result" | grep -o '"patternsProned":[0-9]*' | cut -d: -f2)
+ local duration=$(echo "$consolidate_result" | grep -o '"durationMs":[0-9]*' | cut -d: -f2)
+
+ success "Consolidation complete"
+ echo -e " ${DIM}β”œβ”€ Duplicates removed: ${removed:-0}${RESET}"
+ echo -e " ${DIM}β”œβ”€ Patterns pruned: ${pruned:-0}${RESET}"
+ echo -e " ${DIM}└─ Duration: ${duration:-0}ms${RESET}"
+ else
+ warn "Consolidation failed (non-critical)"
+ fi
+
+ # Get final stats
+ local stats_result
+ stats_result=$(node "$LEARNING_SERVICE" stats 2>&1)
+
+ if [ $? -eq 0 ]; then
+ echo "$stats_result" > "$METRICS_DIR/learning-final-stats.json"
+
+ local total_short=$(echo "$stats_result" | grep -o '"shortTermPatterns":[0-9]*' | cut -d: -f2)
+ local total_long=$(echo "$stats_result" | grep -o '"longTermPatterns":[0-9]*' | cut -d: -f2)
+ local avg_search=$(echo "$stats_result" | grep -o '"avgSearchTimeMs":[0-9.]*' | cut -d: -f2)
+
+ log "Final stats:"
+ echo -e " ${DIM}β”œβ”€ Short-term: ${total_short:-0}${RESET}"
+ echo -e " ${DIM}β”œβ”€ Long-term: ${total_long:-0}${RESET}"
+ echo -e " ${DIM}└─ Avg search: ${avg_search:-0}ms${RESET}"
+ fi
+
+ # Clean up session file
+ rm -f "$LEARNING_DIR/current-session-id"
+
+ return 0
+}
+
+# =============================================================================
+# Store Pattern (called by post-edit hooks)
+# =============================================================================
+store_pattern() {
+ local strategy="$1"
+ local domain="${2:-general}"
+ local quality="${3:-0.7}"
+
+ if [ -z "$strategy" ]; then
+ error "No strategy provided"
+ return 1
+ fi
+
+ # Escape quotes in strategy
+ local escaped_strategy="${strategy//\"/\\\"}"
+
+ local result
+ result=$(node "$LEARNING_SERVICE" store "$escaped_strategy" "$domain" 2>&1)
+
+ if [ $? -eq 0 ]; then
+ local action=$(echo "$result" | grep -o '"action":"[^"]*"' | cut -d'"' -f4)
+ local id=$(echo "$result" | grep -o '"id":"[^"]*"' | cut -d'"' -f4)
+
+ if [ "$action" = "created" ]; then
+ success "Pattern stored: $id"
+ else
+ log "Pattern updated: $id"
+ fi
+ return 0
+ else
+ warn "Pattern storage failed"
+ return 1
+ fi
+}
+
+# =============================================================================
+# Search Patterns (called by pre-edit hooks)
+# =============================================================================
+search_patterns() {
+ local query="$1"
+ local k="${2:-3}"
+
+ if [ -z "$query" ]; then
+ error "No query provided"
+ return 1
+ fi
+
+ # Escape quotes
+ local escaped_query="${query//\"/\\\"}"
+
+ local result
+ result=$(node "$LEARNING_SERVICE" search "$escaped_query" "$k" 2>&1)
+
+ if [ $? -eq 0 ]; then
+ local patterns=$(echo "$result" | grep -o '"patterns":\[' | wc -l)
+ local search_time=$(echo "$result" | grep -o '"searchTimeMs":[0-9.]*' | cut -d: -f2)
+
+ echo "$result"
+
+ if [ -n "$search_time" ]; then
+ log "Search completed in ${search_time}ms"
+ fi
+ return 0
+ else
+ warn "Pattern search failed"
+ return 1
+ fi
+}
+
+# =============================================================================
+# Record Pattern Usage (for promotion tracking)
+# =============================================================================
+record_usage() {
+ local pattern_id="$1"
+ local success="${2:-true}"
+
+ if [ -z "$pattern_id" ]; then
+ return 1
+ fi
+
+ # This would call into the learning service to record usage
+ # For now, log it
+ log "Recording usage: $pattern_id (success=$success)"
+}
+
+# =============================================================================
+# Run Benchmark
+# =============================================================================
+run_benchmark() {
+ log "Running HNSW benchmark..."
+
+ local result
+ result=$(node "$LEARNING_SERVICE" benchmark 2>&1)
+
+ if [ $? -eq 0 ]; then
+ local avg_search=$(echo "$result" | grep -o '"avgSearchMs":"[^"]*"' | cut -d'"' -f4)
+ local p95_search=$(echo "$result" | grep -o '"p95SearchMs":"[^"]*"' | cut -d'"' -f4)
+ local improvement=$(echo "$result" | grep -o '"searchImprovementEstimate":"[^"]*"' | cut -d'"' -f4)
+
+ success "HNSW Benchmark Complete"
+ echo -e " ${DIM}β”œβ”€ Avg search: ${avg_search}ms${RESET}"
+ echo -e " ${DIM}β”œβ”€ P95 search: ${p95_search}ms${RESET}"
+ echo -e " ${DIM}└─ Estimated improvement: ${improvement}${RESET}"
+
+ echo "$result"
+ return 0
+ else
+ error "Benchmark failed"
+ echo "$result"
+ return 1
+ fi
+}
+
+# =============================================================================
+# Get Stats
+# =============================================================================
+get_stats() {
+ local result
+ result=$(node "$LEARNING_SERVICE" stats 2>&1)
+
+ if [ $? -eq 0 ]; then
+ echo "$result"
+ return 0
+ else
+ error "Failed to get stats"
+ return 1
+ fi
+}
+
+# =============================================================================
+# Main
+# =============================================================================
+case "${1:-help}" in
+ "session-start"|"start")
+ session_start "$2"
+ ;;
+ "session-end"|"end")
+ session_end
+ ;;
+ "store")
+ store_pattern "$2" "$3" "$4"
+ ;;
+ "search")
+ search_patterns "$2" "$3"
+ ;;
+ "record-usage"|"usage")
+ record_usage "$2" "$3"
+ ;;
+ "benchmark")
+ run_benchmark
+ ;;
+ "stats")
+ get_stats
+ ;;
+ "help"|"-h"|"--help")
+ cat << 'EOF'
+Claude Flow V3 Learning Hooks
+
+Usage: learning-hooks.sh <command> [args]
+
+Commands:
+ session-start [id] Initialize learning for new session
+ session-end Consolidate and export session data
+ store <strategy> Store a new pattern
+ search <query> [k] Search for similar patterns
+ record-usage <id> Record pattern usage
+ benchmark Run HNSW performance benchmark
+ stats Get learning statistics
+ help Show this help
+
+Examples:
+ ./learning-hooks.sh session-start
+ ./learning-hooks.sh store "Fix authentication bug" code
+ ./learning-hooks.sh search "authentication error" 5
+ ./learning-hooks.sh session-end
+EOF
+ ;;
+ *)
+ error "Unknown command: $1"
+ echo "Use 'learning-hooks.sh help' for usage"
+ exit 1
+ ;;
+esac
diff --git a/.claude/helpers/learning-service.mjs b/.claude/helpers/learning-service.mjs
old mode 100644
new mode 100755
diff --git a/.claude/settings.json b/.claude/settings.json
index fc2c5aeba2..a3d85c992e 100644
--- a/.claude/settings.json
+++ b/.claude/settings.json
@@ -175,6 +175,11 @@
"timeout": 3000,
"command": ".claude/helpers/daemon-manager.sh start 3 5 2>/dev/null || true"
},
+ {
+ "type": "command",
+ "timeout": 8000,
+ "command": ".claude/helpers/learning-hooks.sh session-start 2>/dev/null || true"
+ },
{
"type": "command",
"timeout": 5000,
@@ -186,6 +191,11 @@
"SessionEnd": [
{
"hooks": [
+ {
+ "type": "command",
+ "timeout": 10000,
+ "command": ".claude/helpers/learning-hooks.sh session-end 2>/dev/null || true"
+ },
{
"type": "command",
"timeout": 8000,