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:

rUvfccf31d2ee08
diff --git a/.claude/helpers/swarm-hooks.sh b/.claude/helpers/swarm-hooks.sh
new file mode 100755
index 0000000000..96ef1e98a5
--- /dev/null
+++ b/.claude/helpers/swarm-hooks.sh
@@ -0,0 +1,731 @@
+#!/bin/bash
+# Claude Flow V3 - Swarm Communication Hooks
+# Enables agent-to-agent messaging, pattern sharing, consensus, and task handoffs
+#
+# Integration with:
+# - @claude-flow/hooks SwarmCommunication module
+# - agentic-flow@alpha swarm coordination
+# - Local hooks system for real-time agent coordination
+#
+# Key mechanisms:
+# - Exit 0 + stdout = Context added to Claude's view
+# - Exit 2 + stderr = Block with explanation
+# - JSON additionalContext = Swarm coordination messages
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+SWARM_DIR="$PROJECT_ROOT/.claude-flow/swarm"
+MESSAGES_DIR="$SWARM_DIR/messages"
+PATTERNS_DIR="$SWARM_DIR/patterns"
+CONSENSUS_DIR="$SWARM_DIR/consensus"
+HANDOFFS_DIR="$SWARM_DIR/handoffs"
+AGENTS_FILE="$SWARM_DIR/agents.json"
+STATS_FILE="$SWARM_DIR/stats.json"
+
+# Agent identity
+AGENT_ID="${AGENTIC_FLOW_AGENT_ID:-agent_$(date +%s)_$(head -c 4 /dev/urandom | xxd -p)}"
+AGENT_NAME="${AGENTIC_FLOW_AGENT_NAME:-claude-code}"
+
+# Initialize directories
+mkdir -p "$MESSAGES_DIR" "$PATTERNS_DIR" "$CONSENSUS_DIR" "$HANDOFFS_DIR"
+
+# =============================================================================
+# UTILITY FUNCTIONS
+# =============================================================================
+
+init_stats() {
+ if [ ! -f "$STATS_FILE" ]; then
+ cat > "$STATS_FILE" << EOF
+{
+ "messagesSent": 0,
+ "messagesReceived": 0,
+ "patternsBroadcast": 0,
+ "consensusInitiated": 0,
+ "consensusResolved": 0,
+ "handoffsInitiated": 0,
+ "handoffsCompleted": 0,
+ "lastUpdated": "$(date -Iseconds)"
+}
+EOF
+ fi
+}
+
+update_stat() {
+ local key="$1"
+ local increment="${2:-1}"
+ init_stats
+
+ if command -v jq &>/dev/null; then
+ local current=$(jq -r ".$key // 0" "$STATS_FILE")
+ local new=$((current + increment))
+ jq ".$key = $new | .lastUpdated = \"$(date -Iseconds)\"" "$STATS_FILE" > "$STATS_FILE.tmp" && mv "$STATS_FILE.tmp" "$STATS_FILE"
+ fi
+}
+
+register_agent() {
+ init_stats
+ local timestamp=$(date +%s)
+
+ if [ ! -f "$AGENTS_FILE" ]; then
+ echo '{"agents":[]}' > "$AGENTS_FILE"
+ fi
+
+ if command -v jq &>/dev/null; then
+ # Check if agent already exists
+ local exists=$(jq -r ".agents[] | select(.id == \"$AGENT_ID\") | .id" "$AGENTS_FILE" 2>/dev/null || echo "")
+
+ if [ -z "$exists" ]; then
+ jq ".agents += [{\"id\":\"$AGENT_ID\",\"name\":\"$AGENT_NAME\",\"status\":\"active\",\"lastSeen\":$timestamp}]" "$AGENTS_FILE" > "$AGENTS_FILE.tmp" && mv "$AGENTS_FILE.tmp" "$AGENTS_FILE"
+ else
+ # Update lastSeen
+ jq "(.agents[] | select(.id == \"$AGENT_ID\")).lastSeen = $timestamp" "$AGENTS_FILE" > "$AGENTS_FILE.tmp" && mv "$AGENTS_FILE.tmp" "$AGENTS_FILE"
+ fi
+ fi
+}
+
+# =============================================================================
+# AGENT-TO-AGENT MESSAGING
+# =============================================================================
+
+send_message() {
+ local to="${1:-*}"
+ local content="${2:-}"
+ local msg_type="${3:-context}"
+ local priority="${4:-normal}"
+
+ local msg_id="msg_$(date +%s)_$(head -c 4 /dev/urandom | xxd -p)"
+ local timestamp=$(date +%s)
+
+ local msg_file="$MESSAGES_DIR/$msg_id.json"
+ cat > "$msg_file" << EOF
+{
+ "id": "$msg_id",
+ "from": "$AGENT_ID",
+ "fromName": "$AGENT_NAME",
+ "to": "$to",
+ "type": "$msg_type",
+ "content": $(echo "$content" | jq -Rs .),
+ "priority": "$priority",
+ "timestamp": $timestamp,
+ "read": false
+}
+EOF
+
+ update_stat "messagesSent"
+
+ echo "$msg_id"
+ exit 0
+}
+
+get_messages() {
+ local limit="${1:-10}"
+ local msg_type="${2:-}"
+
+ register_agent
+
+ local messages="[]"
+ local count=0
+
+ for msg_file in $(ls -t "$MESSAGES_DIR"/*.json 2>/dev/null | head -n "$limit"); do
+ if [ -f "$msg_file" ]; then
+ local to=$(jq -r '.to' "$msg_file" 2>/dev/null)
+
+ # Check if message is for us or broadcast
+ if [ "$to" = "$AGENT_ID" ] || [ "$to" = "*" ] || [ "$to" = "$AGENT_NAME" ]; then
+ # Filter by type if specified
+ if [ -n "$msg_type" ]; then
+ local mtype=$(jq -r '.type' "$msg_file" 2>/dev/null)
+ if [ "$mtype" != "$msg_type" ]; then
+ continue
+ fi
+ fi
+
+ if command -v jq &>/dev/null; then
+ messages=$(echo "$messages" | jq ". += [$(cat "$msg_file")]")
+ count=$((count + 1))
+
+ # Mark as read
+ jq '.read = true' "$msg_file" > "$msg_file.tmp" && mv "$msg_file.tmp" "$msg_file"
+ fi
+ fi
+ fi
+ done
+
+ update_stat "messagesReceived" "$count"
+
+ if command -v jq &>/dev/null; then
+ echo "$messages" | jq -c "{count: $count, messages: .}"
+ else
+ echo "{\"count\": $count, \"messages\": []}"
+ fi
+
+ exit 0
+}
+
+broadcast_context() {
+ local content="${1:-}"
+ send_message "*" "$content" "context" "normal"
+}
+
+# =============================================================================
+# PATTERN BROADCASTING
+# =============================================================================
+
+broadcast_pattern() {
+ local strategy="${1:-}"
+ local domain="${2:-general}"
+ local quality="${3:-0.7}"
+
+ local bc_id="bc_$(date +%s)_$(head -c 4 /dev/urandom | xxd -p)"
+ local timestamp=$(date +%s)
+
+ local bc_file="$PATTERNS_DIR/$bc_id.json"
+ cat > "$bc_file" << EOF
+{
+ "id": "$bc_id",
+ "sourceAgent": "$AGENT_ID",
+ "sourceAgentName": "$AGENT_NAME",
+ "pattern": {
+ "strategy": $(echo "$strategy" | jq -Rs .),
+ "domain": "$domain",
+ "quality": $quality
+ },
+ "broadcastTime": $timestamp,
+ "acknowledgments": []
+}
+EOF
+
+ update_stat "patternsBroadcast"
+
+ # Also store in learning hooks if available
+ if [ -f "$SCRIPT_DIR/learning-hooks.sh" ]; then
+ "$SCRIPT_DIR/learning-hooks.sh" store "$strategy" "$domain" "$quality" 2>/dev/null || true
+ fi
+
+ cat << EOF
+{"broadcastId":"$bc_id","strategy":$(echo "$strategy" | jq -Rs .),"domain":"$domain","quality":$quality}
+EOF
+
+ exit 0
+}
+
+get_pattern_broadcasts() {
+ local domain="${1:-}"
+ local min_quality="${2:-0}"
+ local limit="${3:-10}"
+
+ local broadcasts="[]"
+ local count=0
+
+ for bc_file in $(ls -t "$PATTERNS_DIR"/*.json 2>/dev/null | head -n "$limit"); do
+ if [ -f "$bc_file" ] && command -v jq &>/dev/null; then
+ local bc_domain=$(jq -r '.pattern.domain' "$bc_file" 2>/dev/null)
+ local bc_quality=$(jq -r '.pattern.quality' "$bc_file" 2>/dev/null)
+
+ # Filter by domain if specified
+ if [ -n "$domain" ] && [ "$bc_domain" != "$domain" ]; then
+ continue
+ fi
+
+ # Filter by quality
+ if [ "$(echo "$bc_quality >= $min_quality" | bc -l 2>/dev/null || echo "1")" = "1" ]; then
+ broadcasts=$(echo "$broadcasts" | jq ". += [$(cat "$bc_file")]")
+ count=$((count + 1))
+ fi
+ fi
+ done
+
+ echo "$broadcasts" | jq -c "{count: $count, broadcasts: .}"
+ exit 0
+}
+
+import_pattern() {
+ local bc_id="$1"
+ local bc_file="$PATTERNS_DIR/$bc_id.json"
+
+ if [ ! -f "$bc_file" ]; then
+ echo '{"imported": false, "error": "Broadcast not found"}'
+ exit 1
+ fi
+
+ # Acknowledge the broadcast
+ if command -v jq &>/dev/null; then
+ jq ".acknowledgments += [\"$AGENT_ID\"]" "$bc_file" > "$bc_file.tmp" && mv "$bc_file.tmp" "$bc_file"
+
+ # Import to local learning
+ local strategy=$(jq -r '.pattern.strategy' "$bc_file")
+ local domain=$(jq -r '.pattern.domain' "$bc_file")
+ local quality=$(jq -r '.pattern.quality' "$bc_file")
+
+ if [ -f "$SCRIPT_DIR/learning-hooks.sh" ]; then
+ "$SCRIPT_DIR/learning-hooks.sh" store "$strategy" "$domain" "$quality" 2>/dev/null || true
+ fi
+
+ echo "{\"imported\": true, \"broadcastId\": \"$bc_id\"}"
+ fi
+
+ exit 0
+}
+
+# =============================================================================
+# CONSENSUS GUIDANCE
+# =============================================================================
+
+initiate_consensus() {
+ local question="${1:-}"
+ local options_str="${2:-}" # comma-separated
+ local timeout="${3:-30000}"
+
+ local cons_id="cons_$(date +%s)_$(head -c 4 /dev/urandom | xxd -p)"
+ local timestamp=$(date +%s)
+ local deadline=$((timestamp + timeout / 1000))
+
+ # Parse options
+ local options_json="[]"
+ IFS=',' read -ra opts <<< "$options_str"
+ for opt in "${opts[@]}"; do
+ opt=$(echo "$opt" | xargs) # trim whitespace
+ if command -v jq &>/dev/null; then
+ options_json=$(echo "$options_json" | jq ". += [\"$opt\"]")
+ fi
+ done
+
+ local cons_file="$CONSENSUS_DIR/$cons_id.json"
+ cat > "$cons_file" << EOF
+{
+ "id": "$cons_id",
+ "initiator": "$AGENT_ID",
+ "initiatorName": "$AGENT_NAME",
+ "question": $(echo "$question" | jq -Rs .),
+ "options": $options_json,
+ "votes": {},
+ "deadline": $deadline,
+ "status": "pending"
+}
+EOF
+
+ update_stat "consensusInitiated"
+
+ # Broadcast consensus request
+ send_message "*" "Consensus request: $question. Options: $options_str. Vote by replying with your choice." "consensus" "high" >/dev/null
+
+ cat << EOF
+{"consensusId":"$cons_id","question":$(echo "$question" | jq -Rs .),"options":$options_json,"deadline":$deadline}
+EOF
+
+ exit 0
+}
+
+vote_consensus() {
+ local cons_id="$1"
+ local vote="$2"
+
+ local cons_file="$CONSENSUS_DIR/$cons_id.json"
+
+ if [ ! -f "$cons_file" ]; then
+ echo '{"accepted": false, "error": "Consensus not found"}'
+ exit 1
+ fi
+
+ if command -v jq &>/dev/null; then
+ local status=$(jq -r '.status' "$cons_file")
+ if [ "$status" != "pending" ]; then
+ echo '{"accepted": false, "error": "Consensus already resolved"}'
+ exit 1
+ fi
+
+ # Check if vote is valid option
+ local valid=$(jq -r ".options | index(\"$vote\") // -1" "$cons_file")
+ if [ "$valid" = "-1" ]; then
+ echo "{\"accepted\": false, \"error\": \"Invalid option: $vote\"}"
+ exit 1
+ fi
+
+ # Record vote
+ jq ".votes[\"$AGENT_ID\"] = \"$vote\"" "$cons_file" > "$cons_file.tmp" && mv "$cons_file.tmp" "$cons_file"
+
+ echo "{\"accepted\": true, \"consensusId\": \"$cons_id\", \"vote\": \"$vote\"}"
+ fi
+
+ exit 0
+}
+
+resolve_consensus() {
+ local cons_id="$1"
+ local cons_file="$CONSENSUS_DIR/$cons_id.json"
+
+ if [ ! -f "$cons_file" ]; then
+ echo '{"resolved": false, "error": "Consensus not found"}'
+ exit 1
+ fi
+
+ if command -v jq &>/dev/null; then
+ # Count votes
+ local result=$(jq -r '
+ .votes | to_entries | group_by(.value) |
+ map({option: .[0].value, count: length}) |
+ sort_by(-.count) | .[0] // {option: "none", count: 0}
+ ' "$cons_file")
+
+ local winner=$(echo "$result" | jq -r '.option')
+ local count=$(echo "$result" | jq -r '.count')
+ local total=$(jq '.votes | length' "$cons_file")
+
+ local confidence=0
+ if [ "$total" -gt 0 ]; then
+ confidence=$(echo "scale=2; $count / $total * 100" | bc 2>/dev/null || echo "0")
+ fi
+
+ # Update status
+ jq ".status = \"resolved\" | .result = {\"winner\": \"$winner\", \"confidence\": $confidence, \"totalVotes\": $total}" "$cons_file" > "$cons_file.tmp" && mv "$cons_file.tmp" "$cons_file"
+
+ update_stat "consensusResolved"
+
+ echo "{\"resolved\": true, \"winner\": \"$winner\", \"confidence\": $confidence, \"totalVotes\": $total}"
+ fi
+
+ exit 0
+}
+
+get_consensus_status() {
+ local cons_id="${1:-}"
+
+ if [ -n "$cons_id" ]; then
+ local cons_file="$CONSENSUS_DIR/$cons_id.json"
+ if [ -f "$cons_file" ]; then
+ cat "$cons_file"
+ else
+ echo '{"error": "Consensus not found"}'
+ exit 1
+ fi
+ else
+ # List pending consensus
+ local pending="[]"
+ for cons_file in "$CONSENSUS_DIR"/*.json; do
+ if [ -f "$cons_file" ] && command -v jq &>/dev/null; then
+ local status=$(jq -r '.status' "$cons_file")
+ if [ "$status" = "pending" ]; then
+ pending=$(echo "$pending" | jq ". += [$(cat "$cons_file")]")
+ fi
+ fi
+ done
+ echo "$pending" | jq -c .
+ fi
+
+ exit 0
+}
+
+# =============================================================================
+# TASK HANDOFF
+# =============================================================================
+
+initiate_handoff() {
+ local to_agent="$1"
+ local description="${2:-}"
+ local context_json="${3:-{}}"
+
+ local ho_id="ho_$(date +%s)_$(head -c 4 /dev/urandom | xxd -p)"
+ local timestamp=$(date +%s)
+
+ # Parse context or use defaults
+ local context=$(echo "$context_json" | jq -c '. + {
+ filesModified: (.filesModified // []),
+ patternsUsed: (.patternsUsed // []),
+ decisions: (.decisions // []),
+ blockers: (.blockers // []),
+ nextSteps: (.nextSteps // [])
+ }' 2>/dev/null || echo '{"filesModified":[],"patternsUsed":[],"decisions":[],"blockers":[],"nextSteps":[]}')
+
+ local ho_file="$HANDOFFS_DIR/$ho_id.json"
+ cat > "$ho_file" << EOF
+{
+ "id": "$ho_id",
+ "fromAgent": "$AGENT_ID",
+ "fromAgentName": "$AGENT_NAME",
+ "toAgent": "$to_agent",
+ "description": $(echo "$description" | jq -Rs .),
+ "context": $context,
+ "status": "pending",
+ "timestamp": $timestamp
+}
+EOF
+
+ update_stat "handoffsInitiated"
+
+ # Send handoff notification
+ send_message "$to_agent" "Task handoff: $description" "handoff" "high" >/dev/null
+
+ cat << EOF
+{"handoffId":"$ho_id","toAgent":"$to_agent","description":$(echo "$description" | jq -Rs .),"status":"pending"}
+EOF
+
+ exit 0
+}
+
+accept_handoff() {
+ local ho_id="$1"
+ local ho_file="$HANDOFFS_DIR/$ho_id.json"
+
+ if [ ! -f "$ho_file" ]; then
+ echo '{"accepted": false, "error": "Handoff not found"}'
+ exit 1
+ fi
+
+ if command -v jq &>/dev/null; then
+ jq ".status = \"accepted\" | .acceptedAt = $(date +%s)" "$ho_file" > "$ho_file.tmp" && mv "$ho_file.tmp" "$ho_file"
+
+ # Generate context for Claude
+ local description=$(jq -r '.description' "$ho_file")
+ local from=$(jq -r '.fromAgentName' "$ho_file")
+ local files=$(jq -r '.context.filesModified | join(", ")' "$ho_file")
+ local patterns=$(jq -r '.context.patternsUsed | join(", ")' "$ho_file")
+ local decisions=$(jq -r '.context.decisions | join("; ")' "$ho_file")
+ local next=$(jq -r '.context.nextSteps | join("; ")' "$ho_file")
+
+ cat << EOF
+## Task Handoff Accepted
+
+**From**: $from
+**Task**: $description
+
+**Files Modified**: $files
+**Patterns Used**: $patterns
+**Decisions Made**: $decisions
+**Next Steps**: $next
+
+This context has been transferred. Continue from where the previous agent left off.
+EOF
+ fi
+
+ exit 0
+}
+
+complete_handoff() {
+ local ho_id="$1"
+ local result_json="${2:-{}}"
+
+ local ho_file="$HANDOFFS_DIR/$ho_id.json"
+
+ if [ ! -f "$ho_file" ]; then
+ echo '{"completed": false, "error": "Handoff not found"}'
+ exit 1
+ fi
+
+ if command -v jq &>/dev/null; then
+ jq ".status = \"completed\" | .completedAt = $(date +%s) | .result = $result_json" "$ho_file" > "$ho_file.tmp" && mv "$ho_file.tmp" "$ho_file"
+
+ update_stat "handoffsCompleted"
+
+ echo "{\"completed\": true, \"handoffId\": \"$ho_id\"}"
+ fi
+
+ exit 0
+}
+
+get_pending_handoffs() {
+ local pending="[]"
+
+ for ho_file in "$HANDOFFS_DIR"/*.json; do
+ if [ -f "$ho_file" ] && command -v jq &>/dev/null; then
+ local to=$(jq -r '.toAgent' "$ho_file")
+ local status=$(jq -r '.status' "$ho_file")
+
+ # Check if handoff is for us and pending
+ if [ "$status" = "pending" ] && ([ "$to" = "$AGENT_ID" ] || [ "$to" = "$AGENT_NAME" ]); then
+ pending=$(echo "$pending" | jq ". += [$(cat "$ho_file")]")
+ fi
+ fi
+ done
+
+ echo "$pending" | jq -c .
+ exit 0
+}
+
+# =============================================================================
+# SWARM STATUS & AGENTS
+# =============================================================================
+
+get_agents() {
+ register_agent
+
+ if [ -f "$AGENTS_FILE" ] && command -v jq &>/dev/null; then
+ cat "$AGENTS_FILE"
+ else
+ echo '{"agents":[]}'
+ fi
+
+ exit 0
+}
+
+get_stats() {
+ init_stats
+
+ if command -v jq &>/dev/null; then
+ jq ". + {agentId: \"$AGENT_ID\", agentName: \"$AGENT_NAME\"}" "$STATS_FILE"
+ else
+ cat "$STATS_FILE"
+ fi
+
+ exit 0
+}
+
+# =============================================================================
+# HOOK INTEGRATION - Output for Claude hooks
+# =============================================================================
+
+pre_task_swarm_context() {
+ local task="${1:-}"
+
+ register_agent
+
+ # Check for pending handoffs
+ local handoffs=$(get_pending_handoffs 2>/dev/null || echo "[]")
+ local handoff_count=$(echo "$handoffs" | jq 'length' 2>/dev/null || echo "0")
+
+ # Check for new messages
+ local messages=$(get_messages 5 2>/dev/null || echo '{"count":0}')
+ local msg_count=$(echo "$messages" | jq '.count' 2>/dev/null || echo "0")
+
+ # Check for pending consensus
+ local consensus=$(get_consensus_status 2>/dev/null || echo "[]")
+ local cons_count=$(echo "$consensus" | jq 'length' 2>/dev/null || echo "0")
+
+ if [ "$handoff_count" -gt 0 ] || [ "$msg_count" -gt 0 ] || [ "$cons_count" -gt 0 ]; then
+ cat << EOF
+{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"allow","additionalContext":"**Swarm Activity**:\n- Pending handoffs: $handoff_count\n- New messages: $msg_count\n- Active consensus: $cons_count\n\nCheck swarm status before proceeding on complex tasks."}}
+EOF
+ fi
+
+ exit 0
+}
+
+post_task_swarm_update() {
+ local task="${1:-}"
+ local success="${2:-true}"
+
+ # Broadcast task completion
+ if [ "$success" = "true" ]; then
+ send_message "*" "Completed: $(echo "$task" | head -c 100)" "result" "low" >/dev/null 2>&1 || true
+ fi
+
+ exit 0
+}
+
+# =============================================================================
+# Main dispatcher
+# =============================================================================
+case "${1:-help}" in
+ # Messaging
+ "send")
+ send_message "${2:-*}" "${3:-}" "${4:-context}" "${5:-normal}"
+ ;;
+ "messages")
+ get_messages "${2:-10}" "${3:-}"
+ ;;
+ "broadcast")
+ broadcast_context "${2:-}"
+ ;;
+
+ # Pattern broadcasting
+ "broadcast-pattern")
+ broadcast_pattern "${2:-}" "${3:-general}" "${4:-0.7}"
+ ;;
+ "patterns")
+ get_pattern_broadcasts "${2:-}" "${3:-0}" "${4:-10}"
+ ;;
+ "import-pattern")
+ import_pattern "${2:-}"
+ ;;
+
+ # Consensus
+ "consensus")
+ initiate_consensus "${2:-}" "${3:-}" "${4:-30000}"
+ ;;
+ "vote")
+ vote_consensus "${2:-}" "${3:-}"
+ ;;
+ "resolve-consensus")
+ resolve_consensus "${2:-}"
+ ;;
+ "consensus-status")
+ get_consensus_status "${2:-}"
+ ;;
+
+ # Task handoff
+ "handoff")
+ initiate_handoff "${2:-}" "${3:-}" "${4:-{}}"
+ ;;
+ "accept-handoff")
+ accept_handoff "${2:-}"
+ ;;
+ "complete-handoff")
+ complete_handoff "${2:-}" "${3:-{}}"
+ ;;
+ "pending-handoffs")
+ get_pending_handoffs
+ ;;
+
+ # Status
+ "agents")
+ get_agents
+ ;;
+ "stats")
+ get_stats
+ ;;
+
+ # Hook integration
+ "pre-task")
+ pre_task_swarm_context "${2:-}"
+ ;;
+ "post-task")
+ post_task_swarm_update "${2:-}" "${3:-true}"
+ ;;
+
+ "help"|"-h"|"--help")
+ cat << 'EOF'
+Claude Flow V3 - Swarm Communication Hooks
+
+Usage: swarm-hooks.sh <command> [args]
+
+Agent Messaging:
+ send <to> <content> [type] [priority] Send message to agent
+ messages [limit] [type] Get messages for this agent
+ broadcast <content> Broadcast to all agents
+
+Pattern Broadcasting:
+ broadcast-pattern <strategy> [domain] [quality] Share pattern with swarm
+ patterns [domain] [min-quality] [limit] List pattern broadcasts
+ import-pattern <broadcast-id> Import broadcast pattern
+
+Consensus:
+ consensus <question> <options> [timeout] Start consensus (options: comma-separated)
+ vote <consensus-id> <vote> Vote on consensus
+ resolve-consensus <consensus-id> Force resolve consensus
+ consensus-status [consensus-id] Get consensus status
+
+Task Handoff:
+ handoff <to-agent> <description> [context-json] Initiate handoff
+ accept-handoff <handoff-id> Accept pending handoff
+ complete-handoff <handoff-id> [result-json] Complete handoff
+ pending-handoffs List pending handoffs
+
+Status:
+ agents List registered agents
+ stats Get swarm statistics
+
+Hook Integration:
+ pre-task <task> Check swarm before task (for hooks)
+ post-task <task> [success] Update swarm after task (for hooks)
+
+Environment:
+ AGENTIC_FLOW_AGENT_ID Agent identifier
+ AGENTIC_FLOW_AGENT_NAME Agent display name
+EOF
+ ;;
+ *)
+ echo "Unknown command: $1" >&2
+ exit 1
+ ;;
+esac
diff --git a/.claude/settings.json b/.claude/settings.json
index b5b9c43702..b9f59b48a2 100644
--- a/.claude/settings.json
+++ b/.claude/settings.json
@@ -17,7 +17,12 @@
"AGENTIC_FLOW_HNSW_ENABLED": "true",
"AGENTIC_FLOW_MOE_ATTENTION": "true",
"AGENTIC_FLOW_MULTI_ALGORITHM_RL": "true",
- "AGENTIC_FLOW_COMPRESSION_ENABLED": "true"
+ "AGENTIC_FLOW_COMPRESSION_ENABLED": "true",
+ "AGENTIC_FLOW_SWARM_COMM_ENABLED": "true",
+ "AGENTIC_FLOW_AGENT_NAME": "claude-code",
+ "AGENTIC_FLOW_PATTERN_BROADCAST_THRESHOLD": "0.7",
+ "AGENTIC_FLOW_CONSENSUS_TIMEOUT": "30000",
+ "AGENTIC_FLOW_AUTO_BROADCAST_PATTERNS": "true"
},
"permissions": {
"allowedTools": [
@@ -89,6 +94,11 @@
"type": "command",
"timeout": 2000,
"command": ".claude/helpers/guidance-hooks.sh route \"$TOOL_INPUT_prompt\""
+ },
+ {
+ "type": "command",
+ "timeout": 3000,
+ "command": ".claude/helpers/swarm-hooks.sh pre-task \"$TOOL_INPUT_prompt\" 2>/dev/null || true"
}
]
}
@@ -142,6 +152,11 @@
"timeout": 3000,
"command": ".claude/helpers/swarm-monitor.sh check 2>/dev/null || true"
},
+ {
+ "type": "command",
+ "timeout": 3000,
+ "command": ".claude/helpers/swarm-hooks.sh post-task \"$TOOL_INPUT_prompt\" true 2>/dev/null || true"
+ },
{
"type": "command",
"timeout": 4000,
@@ -185,6 +200,11 @@
"timeout": 8000,
"command": ".claude/helpers/learning-hooks.sh session-start 2>/dev/null || true"
},
+ {
+ "type": "command",
+ "timeout": 3000,
+ "command": ".claude/helpers/swarm-hooks.sh agents 2>/dev/null || true"
+ },
{
"type": "command",
"timeout": 5000,
@@ -270,6 +290,7 @@
"v3QuickStatus": ".claude/helpers/v3-quick-status.sh",
"v3CheckpointManager": ".claude/helpers/checkpoint-manager.sh",
"v3SwarmMonitor": ".claude/helpers/swarm-monitor.sh",
+ "v3SwarmHooks": ".claude/helpers/swarm-hooks.sh",
"v3Master": ".claude/helpers/v3.sh"
}
},
@@ -282,7 +303,17 @@
"swarm": {
"totalAgents": 15,
"topology": "hierarchical-mesh",
- "coordination": "queen-led"
+ "coordination": "queen-led",
+ "communication": {
+ "enabled": true,
+ "messaging": true,
+ "patternBroadcast": true,
+ "consensus": true,
+ "taskHandoff": true,
+ "autoPatternShare": true,
+ "patternThreshold": 0.7,
+ "consensusTimeout": 30000
+ }
},
"performance": {
"flashAttentionTarget": "2.49x-7.47x",
diff --git a/v3/@claude-flow/cli/README.md b/v3/@claude-flow/cli/README.md
index 3d1a24a0e5..24d858b34f 100644
--- a/v3/@claude-flow/cli/README.md
+++ b/v3/@claude-flow/cli/README.md
@@ -27,7 +27,7 @@ npm install @claude-flow/cli
## Quick Start
```typescript
-import { CommandParser, Output, prompt } from '@claude-flow/cli';
+import { CommandParser, OutputFormatter, text, select, confirm } from '@claude-flow/cli';
// Create a parser instance
const parser = new CommandParser();
@@ -56,9 +56,9 @@ parser.registerCommand({
const result = parser.parse(process.argv.slice(2));
// Output formatting
-const output = new Output();
-output.success('Swarm initialized successfully!');
-output.table([
+const output = new OutputFormatter();
+output.printSuccess('Swarm initialized successfully!');
+output.printTable([
{ agent: 'queen', status: 'running' },
{ agent: 'worker-1', status: 'idle' }
]);
@@ -87,25 +87,33 @@ const commands = parser.getAllCommands(): Command[];
### Output Formatting
```typescript
-import { Output } from '@claude-flow/cli';
+import { OutputFormatter, output } from '@claude-flow/cli';
-const output = new Output({ color: true, format: 'text' });
+// Use the singleton instance
+output.printSuccess('Operation completed');
+output.printError('Something went wrong');
+output.printWarning('Proceed with caution');
+output.printInfo('FYI: This is informational');
-// Message types
-output.success('Operation completed');
-output.error('Something went wrong');
-output.warning('Proceed with caution');
-output.info('FYI: This is informational');
-output.debug('Debug details');
+// Or create a custom formatter
+const formatter = new OutputFormatter({ color: true });
-// Structured output
-output.table(data, columns);
-output.json(object);
-output.list(items);
+// Color methods
+formatter.success('Green text');
+formatter.error('Red text');
+formatter.warning('Yellow text');
+formatter.bold('Bold text');
+formatter.dim('Dimmed text');
-// Progress indication
-output.spinner('Loading...');
-output.progress(current, total);
+// Structured output
+output.printTable(data, columns);
+output.printJson(object);
+output.printList(items);
+
+// Progress indication (via Progress and Spinner classes)
+import { Progress, Spinner } from '@claude-flow/cli';
+const spinner = new Spinner('Loading...');
+const progress = new Progress({ total: 100 });
```
### Interactive Prompts