π 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
TypeScript agentic-aiagentic-frameworkagentic-workflowagentsai-agentsai-assistantai-skillsautonomous-agentsclaudecodexdsh-pluginharnessmcp-servermulti-agentmulti-agent-systemsnpmskillsswarmswarm-intelligencetypescript
checkpoint: File edit:
rUv3079a73a45a4
diff --git a/.claude/helpers/learning-hooks.sh b/.claude/helpers/learning-hooks.shnew file mode 100755index 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+ ;;+esacdiff --git a/.claude/helpers/learning-service.mjs b/.claude/helpers/learning-service.mjsold mode 100644new mode 100755diff --git a/.claude/settings.json b/.claude/settings.jsonindex 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,