aether-colony 1.1.0

package/.aether/utils/swarm-display.sh

@@ -0,0 +1,268 @@
+#!/bin/bash
+# Real-time swarm activity display
+# Usage: bash swarm-display.sh [swarm_id]
+
+SWARM_ID="${1:-current}"
+DATA_DIR="${DATA_DIR:-.aether/data}"
+DISPLAY_FILE="$DATA_DIR/swarm-display.json"
+
+# ANSI colors (matching caste-colors.js)
+BLUE='\033[34m'
+GREEN='\033[32m'
+YELLOW='\033[33m'
+RED='\033[31m'
+MAGENTA='\033[35m'
+BOLD='\033[1m'
+UNDERLINE='\033[4m'
+DIM='\033[2m'
+RESET='\033[0m'
+
+# Caste colors (must match caste-colors.js)
+get_caste_color() {
+  case "$1" in
+    builder)  echo "$BLUE" ;;
+    watcher)  echo "$GREEN" ;;
+    scout)    echo "$YELLOW" ;;
+    chaos)    echo "$RED" ;;
+    prime)    echo "$MAGENTA" ;;
+    *)        echo "$RESET" ;;
+  esac
+}
+
+# Caste emojis (must match aether-utils.sh)
+get_caste_emoji() {
+  case "$1" in
+    builder)  echo "🔨🐜" ;;
+    watcher)  echo "👁️🐜" ;;
+    scout)    echo "🔍🐜" ;;
+    chaos)    echo "🎲🐜" ;;
+    prime)    echo "👑🐜" ;;
+    *)        echo "🐜" ;;
+  esac
+}
+
+# Animated status phrases
+get_status_phrase() {
+  local caste="$1"
+  local idx=$(($(date +%s) % 4))
+  case "$caste" in
+    builder)
+      phrases=("excavating..." "building..." "forging..." "constructing...")
+      ;;
+    watcher)
+      phrases=("observing..." "monitoring..." "watching..." "tracking...")
+      ;;
+    scout)
+      phrases=("exploring..." "searching..." "investigating..." "probing...")
+      ;;
+    chaos)
+      phrases=("disrupting..." "testing..." "probing..." "stressing...")
+      ;;
+    *)
+      phrases=("working..." "foraging..." "excavating..." "tunneling...")
+      ;;
+  esac
+  echo "${phrases[$idx]}"
+}
+
+# Format tool usage: "📖5 🔍3 ✏️2 ⚡1"
+format_tools() {
+  local read="${1:-0}"
+  local grep="${2:-0}"
+  local edit="${3:-0}"
+  local bash="${4:-0}"
+  local result=""
+  [[ "$read" -gt 0 ]] && result="${result}📖${read} "
+  [[ "$grep" -gt 0 ]] && result="${result}🔍${grep} "
+  [[ "$edit" -gt 0 ]] && result="${result}✏️${edit} "
+  [[ "$bash" -gt 0 ]] && result="${result}⚡${bash}"
+  echo "$result"
+}
+
+# Format duration from seconds
+format_duration() {
+  local seconds="${1:-0}"
+  if [[ "$seconds" -lt 60 ]]; then
+    echo "${seconds}s"
+  else
+    local mins=$((seconds / 60))
+    local secs=$((seconds % 60))
+    echo "${mins}m${secs}s"
+  fi
+}
+
+# Render progress bar
+render_progress_bar() {
+  local percent="${1:-0}"
+  local width="${2:-20}"
+
+  # Clamp percent to 0-100
+  [[ "$percent" -lt 0 ]] && percent=0
+  [[ "$percent" -gt 100 ]] && percent=100
+
+  local filled=$((percent * width / 100))
+  local empty=$((width - filled))
+
+  local bar=""
+  for ((i=0; i<filled; i++)); do bar+="█"; done
+  for ((i=0; i<empty; i++)); do bar+="░"; done
+
+  echo "[$bar] $percent%"
+}
+
+# Get animated spinner
+get_spinner() {
+  local spinners=("⠋" "⠙" "⠹" "⠸" "⠼" "⠴" "⠦" "⠧" "⠇" "⠏")
+  local idx=$(($(date +%s) % 10))
+  echo "${spinners[$idx]}"
+}
+
+# Get excavation phrase based on progress
+get_excavation_phrase() {
+  local caste="$1"
+  local progress="${2:-0}"
+
+  if [[ "$progress" -lt 25 ]]; then
+    echo "🚧 Starting excavation..."
+  elif [[ "$progress" -lt 50 ]]; then
+    echo "⛏️  Digging deeper..."
+  elif [[ "$progress" -lt 75 ]]; then
+    echo "🪨 Moving earth..."
+  elif [[ "$progress" -lt 100 ]]; then
+    echo "🏗️  Almost there..."
+  else
+    echo "✅ Excavation complete!"
+  fi
+}
+
+# Render the swarm display
+render_swarm() {
+  clear
+
+  # Header
+  echo -e "${BOLD}${MAGENTA}"
+  cat << 'EOF'
+       .-.
+      (o o)  AETHER COLONY
+      | O |  Swarm Activity
+       `-`
+EOF
+  echo -e "${RESET}"
+  echo -e "${DIM}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}"
+  echo ""
+
+  if [[ ! -f "$DISPLAY_FILE" ]]; then
+    echo -e "${DIM}Waiting for swarm activity...${RESET}"
+    echo ""
+    echo -e "${DIM}0 foragers excavating...${RESET}"
+    return
+  fi
+
+  # Read swarm data
+  local swarm_data=$(cat "$DISPLAY_FILE" 2>/dev/null)
+  if [[ -z "$swarm_data" ]]; then
+    echo -e "${DIM}No active swarm data${RESET}"
+    return
+  fi
+
+  # Check if we have active ants
+  local total_active=$(echo "$swarm_data" | jq -r '.summary.total_active // 0')
+
+  if [[ "$total_active" -eq 0 ]]; then
+    echo -e "${DIM}No active foragers${RESET}"
+    echo ""
+    echo -e "${DIM}0 foragers excavating...${RESET}"
+    return
+  fi
+
+  # Render each active ant
+  echo "$swarm_data" | jq -r '.active_ants[] |
+    "\(.name)|\(.caste)|\(.status)|\(.task // "")|\(.tools.read // 0)|\(.tools.grep // 0)|\(.tools.edit // 0)|\(.tools.bash // 0)|\(.tokens // 0)|\(.started_at // "")|\(.parent // "Queen")|\(.progress // 0)"' 2>/dev/null | \
+  while IFS='|' read -r name caste status task read_count grep_count edit_count bash_count tokens started_at parent progress; do
+    color=$(get_caste_color "$caste")
+    emoji=$(get_caste_emoji "$caste")
+    phrase=$(get_status_phrase "$caste")
+
+    # Parent ants: bold + underline
+    if [[ "$parent" == "Queen" ]] || [[ "$parent" == "Prime"* ]]; then
+      style="${BOLD}${UNDERLINE}"
+    else
+      style="${BOLD}"
+    fi
+
+    # Format tools
+    tools_str=$(format_tools "$read_count" "$grep_count" "$edit_count" "$bash_count")
+
+    # Calculate elapsed time
+    elapsed_str=""
+    if [[ -n "$started_at" ]]; then
+      started_ts=$(date -j -f "%Y-%m-%dT%H:%M:%SZ" "$started_at" +%s 2>/dev/null || date -d "$started_at" +%s 2>/dev/null || echo "0")
+      now_ts=$(date +%s)
+      elapsed=$((now_ts - started_ts))
+      if [[ $elapsed -gt 0 ]]; then
+        elapsed_str="${DIM}($(format_duration $elapsed))${RESET}"
+      fi
+    fi
+
+    # Trophallaxis (token) indicator
+    token_str=""
+    if [[ "$tokens" -gt 0 ]]; then
+      token_str="${DIM}🍯${tokens}${RESET}"
+    fi
+
+    # Truncate task if too long
+    display_task="$task"
+    [[ ${#display_task} -gt 35 ]] && display_task="${display_task:0:32}..."
+
+    # Output line: "🔨 Builder: excavating... Implement auth 📖5 🔍3 (2m3s) 🍯1250"
+    echo -e "${color}${emoji} ${style}${name}${RESET}${color}: ${phrase}${RESET} ${display_task}"
+    echo -e "   ${tools_str} ${elapsed_str} ${token_str}"
+
+    # Show progress bar if progress > 0
+    if [[ "$progress" -gt 0 ]]; then
+      progress_bar=$(render_progress_bar "$progress" 15)
+      excavation_phrase=$(get_excavation_phrase "$caste" "$progress")
+      echo -e "   ${DIM}${progress_bar}${RESET}"
+      echo -e "   ${DIM}$(get_spinner) ${excavation_phrase}${RESET}"
+    fi
+
+    echo ""
+  done
+
+  # Chamber activity map (VIZ-07)
+  echo -e "${DIM}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}"
+  echo ""
+  echo -e "${BOLD}Chamber Activity:${RESET}"
+
+  # Show active chambers with fire intensity
+  echo "$swarm_data" | jq -r '.chambers | to_entries[] | "\(.key)|\(.value.activity)|\(.value.icon)"' 2>/dev/null | \
+  while IFS='|' read -r chamber activity icon; do
+    if [[ "$activity" -gt 0 ]]; then
+      # Fire intensity based on activity count
+      if [[ "$activity" -ge 5 ]]; then
+        fires="🔥🔥🔥"
+      elif [[ "$activity" -ge 3 ]]; then
+        fires="🔥🔥"
+      else
+        fires="🔥"
+      fi
+      echo -e "  ${icon} ${chamber//_/ } ${fires} (${activity} ants)"
+    fi
+  done
+
+  # Summary line (VIZ-06: ant-themed presentation)
+  echo ""
+  echo -e "${DIM}${total_active} forager$([[ "$total_active" -eq 1 ]] || echo "s") excavating...${RESET}"
+}
+
+# Main loop with file watching
+render_swarm
+
+if command -v fswatch &>/dev/null; then
+  fswatch -o "$DISPLAY_FILE" 2>/dev/null | while read; do render_swarm; done
+elif command -v inotifywait &>/dev/null; then
+  while inotifywait -q -e modify "$DISPLAY_FILE" 2>/dev/null; do render_swarm; done
+else
+  # Fallback: poll every 2 seconds
+  while true; do sleep 2; render_swarm; done
+fi

package/.aether/utils/watch-spawn-tree.sh

@@ -0,0 +1,253 @@
+#!/bin/bash
+# Live spawn tree visualization for tmux watch pane
+# Usage: bash watch-spawn-tree.sh [data_dir]
+
+DATA_DIR="${1:-.aether/data}"
+SPAWN_FILE="$DATA_DIR/spawn-tree.txt"
+VIEW_STATE_FILE="$DATA_DIR/view-state.json"
+
+# ANSI colors
+YELLOW='\033[33m'
+GREEN='\033[32m'
+RED='\033[31m'
+CYAN='\033[36m'
+MAGENTA='\033[35m'
+BOLD='\033[1m'
+DIM='\033[2m'
+RESET='\033[0m'
+
+# Caste emojis
+get_emoji() {
+  case "$1" in
+    builder)   echo "🔨" ;;
+    watcher)   echo "👁️ " ;;
+    scout)     echo "🔍" ;;
+    colonizer) echo "🗺️ " ;;
+    architect) echo "🏛️ " ;;
+    prime)     echo "👑" ;;
+    *)         echo "🐜" ;;
+  esac
+}
+
+# Load view state
+load_view_state() {
+  if [[ -f "$VIEW_STATE_FILE" ]]; then
+    cat "$VIEW_STATE_FILE" 2>/dev/null || echo '{}'
+  else
+    echo '{"tunnel_view":{"expanded":[],"collapsed":["__depth_3_plus__"],"default_expand_depth":2,"show_completed":true}}'
+  fi
+}
+
+# Check if item is expanded
+is_expanded() {
+  local item="$1"
+  local depth="${2:-1}"
+  local view_state=$(load_view_state)
+
+  # Check if explicitly expanded
+  if echo "$view_state" | jq -e ".tunnel_view.expanded | contains([\"$item\"])" >/dev/null 2>&1; then
+    return 0
+  fi
+
+  # Check if depth-based auto-collapse applies
+  local default_depth=$(echo "$view_state" | jq -r '.tunnel_view.default_expand_depth // 2')
+  if [[ "$depth" -gt "$default_depth" ]]; then
+    # Check if __depth_3_plus__ is in collapsed (indicating auto-collapse enabled)
+    if echo "$view_state" | jq -e '.tunnel_view.collapsed | contains(["__depth_3_plus__"])' >/dev/null 2>&1; then
+      return 1  # Collapsed by depth
+    fi
+  fi
+
+  # Check if explicitly collapsed
+  if echo "$view_state" | jq -e ".tunnel_view.collapsed | contains([\"$item\"])" >/dev/null 2>&1; then
+    return 1
+  fi
+
+  return 0  # Default to expanded
+}
+
+# Status colors
+get_status_color() {
+  case "$1" in
+    completed) echo "$GREEN" ;;
+    failed)    echo "$RED" ;;
+    spawned)   echo "$YELLOW" ;;
+    *)         echo "$CYAN" ;;
+  esac
+}
+
+render_tree() {
+  clear
+
+  # Header
+  echo -e "${BOLD}${CYAN}"
+  cat << 'EOF'
+       .-.
+      (o o)  AETHER COLONY
+      | O |  Spawn Tree (Collapsible)
+       `-`
+EOF
+  echo -e "${RESET}"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+
+  # Always show Queen at depth 0
+  echo -e "  ${BOLD}👑 Queen${RESET} ${DIM}(depth 0)${RESET}"
+  echo -e "  ${DIM}│${RESET}"
+
+  if [[ ! -f "$SPAWN_FILE" ]]; then
+    echo -e "  ${DIM}└── (no workers spawned yet)${RESET}"
+    return
+  fi
+
+  # Parse spawn tree file
+  # Format: timestamp|parent_id|child_caste|child_name|task_summary|status
+  declare -A workers
+  declare -A worker_status
+  declare -A worker_task
+  declare -A worker_caste
+  declare -a roots
+
+  while IFS='|' read -r ts parent caste name task status rest; do
+    [[ -z "$name" ]] && continue
+
+    # Check if this is a status update (only 4 fields)
+    if [[ -z "$task" && -n "$caste" ]]; then
+      # This is a status update: ts|name|status|summary
+      worker_status["$parent"]="$caste"
+      continue
+    fi
+
+    workers["$name"]="$parent"
+    worker_caste["$name"]="$caste"
+    worker_task["$name"]="$task"
+    worker_status["$name"]="${status:-spawned}"
+
+    # Track root workers (spawned by Prime or Queen)
+    if [[ "$parent" == "Prime"* || "$parent" == "prime"* || "$parent" == "Queen" ]]; then
+      roots+=("$name")
+    fi
+  done < "$SPAWN_FILE"
+
+  # Render workers in tree structure
+  # Group by parent to show hierarchy
+  printed=()
+
+  # Function to render a worker and its children
+  render_worker() {
+    local name="$1"
+    local indent="$2"
+    local depth="$3"
+    local is_last="$4"
+
+    [[ " ${printed[*]} " =~ " $name " ]] && return
+    printed+=("$name")
+
+    emoji=$(get_emoji "${worker_caste[$name]}")
+    status="${worker_status[$name]}"
+    color=$(get_status_color "$status")
+    task="${worker_task[$name]}"
+
+    # Check if collapsed
+    local collapsed=false
+    local child_count=0
+
+    # Count children
+    for child in "${!workers[@]}"; do
+      if [[ "${workers[$child]}" == "$name" ]]; then
+        child_count=$((child_count + 1))
+      fi
+    done
+
+    # Check collapse state (only if has children)
+    if [[ $child_count -gt 0 ]] && ! is_expanded "$name" "$depth"; then
+      collapsed=true
+    fi
+
+    # Truncate task for display
+    [[ ${#task} -gt 30 ]] && task="${task:0:27}..."
+
+    # Tree connectors
+    if [[ "$is_last" == "true" ]]; then
+      connector="└──"
+    else
+      connector="├──"
+    fi
+
+    # Show expand/collapse indicator
+    local expand_indicator=""
+    if [[ $child_count -gt 0 ]]; then
+      if [[ "$collapsed" == "true" ]]; then
+        expand_indicator="▶ [$child_count hidden] "
+      else
+        expand_indicator="▼ "
+      fi
+    fi
+
+    echo -e "${indent}${DIM}${connector}${RESET} ${emoji} ${color}${name}${RESET}: ${expand_indicator}${task} ${DIM}[depth $depth]${RESET}"
+
+    # Render children if not collapsed
+    if [[ "$collapsed" != "true" ]]; then
+      local children=()
+      for child in "${!workers[@]}"; do
+        if [[ "${workers[$child]}" == "$name" ]]; then
+          children+=("$child")
+        fi
+      done
+
+      local child_count=${#children[@]}
+      local child_idx=0
+      for child in "${children[@]}"; do
+        child_idx=$((child_idx + 1))
+        local child_is_last="false"
+        [[ $child_idx -eq $child_count ]] && child_is_last="true"
+
+        local child_indent="${indent}    "
+        if [[ "$is_last" != "true" ]]; then
+          child_indent="${indent}${DIM}│${RESET}   "
+        fi
+
+        render_worker "$child" "$child_indent" $((depth + 1)) "$child_is_last"
+      done
+    fi
+  }
+
+  # Render root workers (spawned by Queen) at depth 1
+  local root_count=${#roots[@]}
+  local root_idx=0
+  for name in "${roots[@]}"; do
+    root_idx=$((root_idx + 1))
+    local is_last="false"
+    [[ $root_idx -eq $root_count ]] && is_last="true"
+    render_worker "$name" "  " 1 "$is_last"
+  done
+
+  # Summary
+  echo ""
+  echo -e "${DIM}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}"
+  completed=$(grep -c "completed" "$SPAWN_FILE" 2>/dev/null || echo "0")
+  active=$(grep -c "spawned" "$SPAWN_FILE" 2>/dev/null || echo "0")
+  echo -e "Workers: ${GREEN}$completed completed${RESET} | ${YELLOW}$active active${RESET}"
+  echo ""
+  echo -e "${DIM}Controls: e+<name> to expand, c+<name> to collapse${RESET}"
+}
+
+# Initial render
+render_tree
+
+# Watch for changes and re-render
+if command -v fswatch &>/dev/null; then
+  fswatch -o "$SPAWN_FILE" 2>/dev/null | while read; do
+    render_tree
+  done
+elif command -v inotifywait &>/dev/null; then
+  while inotifywait -q -e modify "$SPAWN_FILE" 2>/dev/null; do
+    render_tree
+  done
+else
+  # Fallback: poll every 2 seconds
+  while true; do
+    sleep 2
+    render_tree
+  done
+fi