cli-fleet 0.1.0__py3-none-any.whl

cli_fleet/scripts/launch.sh

@@ -0,0 +1,441 @@
+#!/usr/bin/env bash
+# FleetCode — launch.sh
+# Creates N team leads, each in its own terminal window, fully interactive.
+#
+# Usage:
+#   ./launch.sh <config.json>
+#   ./launch.sh <config.json> --background   # use claude -p instead of terminals
+#   ./launch.sh --example                    # print example config
+#
+# Run setup.sh first to enable agent teams and detect your terminal emulator.
+#
+# Each team gets:
+#   - Its own terminal window (gnome-terminal, xfce4-terminal, konsole, kitty, etc.)
+#   - A generated CLAUDE.md with cross-team protocol
+#   - A UserPromptSubmit hook that injects cross-team messages
+#   - An initial prompt sent to claude as first argument
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+META_DIR="${META_TEAM_DIR:-$HOME/.claude/meta-teams}"
+
+print_example() {
+    cat <<'EXAMPLE'
+{
+  "meta_team": "hunt-lz",
+  "project_dir": "/media/phantom-orchestrator/Elements1/Ubuntu/bounty-recon",
+  "teams": [
+    {
+      "name": "team-evm-v1",
+      "role": "Hunt V1 EVM contracts — UltraLightNodeV2, Endpoint V1, FPValidator ($15M cap)",
+      "teammates": 3,
+      "task": "Create an agent team with 3 teammates. Focus on V1 EVM contracts worth $15M each. Run hunt-auto evm on UltraLightNodeV2, Endpoint V1, and FPValidator. Chase every finding. Post bugs to the cross-team mailbox."
+    },
+    {
+      "name": "team-evm-v2",
+      "role": "Hunt V2 EVM contracts — EndpointV2, SendULN302, ReceiveULN302, DVN ($2M cap)",
+      "teammates": 3,
+      "task": "Create an agent team with 3 teammates. Focus on V2 EVM protocol contracts. Run hunt-auto evm on EndpointV2, SendULN302, ReceiveULN302, DVN. Focus on cross-contract interactions."
+    },
+    {
+      "name": "team-crosschain",
+      "role": "Hunt cross-chain exploit chains — EVM↔Solana, EVM↔TON, encoding mismatches ($2M-$15M)",
+      "teammates": 4,
+      "task": "Create an agent team with 4 teammates. Focus ONLY on cross-chain attack vectors: address encoding mismatches, nonce desync, executor gas model differences, composed message multi-hop. Use xchain-abi-check, xchain-fuzz, xchain-tracer."
+    },
+    {
+      "name": "team-non-evm",
+      "role": "Hunt Solana + TON + Aptos contracts ($2M cap)",
+      "teammates": 3,
+      "task": "Create an agent team with 3 teammates. One on Solana (DVN, Endpoint, ULN, OFT), one on TON (Controller, ULNManager, DVNProxy), one on Aptos (Endpoint). Run hunt-auto for each chain."
+    }
+  ]
+}
+EXAMPLE
+}
+
+if [[ "${1:-}" == "--example" ]]; then
+    print_example
+    exit 0
+fi
+
+CONFIG="${1:?Usage: $0 <config.json> [--background] | $0 --example}"
+[[ ! -f "$CONFIG" ]] && echo "Error: config file not found: $CONFIG" && exit 1
+
+MODE="interactive"
+[[ "${2:-}" == "--background" ]] && MODE="background"
+
+# Parse config
+META_TEAM=$(python3 -c "import json; print(json.load(open('$CONFIG'))['meta_team'])")
+PROJECT_DIR=$(python3 -c "import json; print(json.load(open('$CONFIG'))['project_dir'])")
+NUM_TEAMS=$(python3 -c "import json; print(len(json.load(open('$CONFIG'))['teams']))")
+
+echo "=== Multi-Team Launcher ==="
+echo "Meta-team:   $META_TEAM"
+echo "Project dir: $PROJECT_DIR"
+echo "Teams:       $NUM_TEAMS"
+echo "Mode:        $MODE"
+echo ""
+
+# Step 1: Initialize shared state
+source "$SCRIPT_DIR/lib/protocol.sh"
+SHARED_DIR=$(meta_init "$META_TEAM")
+echo "Shared state: $SHARED_DIR"
+mkdir -p "$SHARED_DIR/logs"
+
+# Step 2: Build team roster for CLAUDE.md template
+ROSTER=""
+for i in $(seq 0 $((NUM_TEAMS - 1))); do
+    t_name=$(python3 -c "import json; print(json.load(open('$CONFIG'))['teams'][$i]['name'])")
+    t_role=$(python3 -c "import json; print(json.load(open('$CONFIG'))['teams'][$i]['role'])")
+    ROSTER+="- **${t_name}**: ${t_role}"$'\n'
+done
+
+# Step 3: Create per-team working directories and launch
+PIDS=()
+for i in $(seq 0 $((NUM_TEAMS - 1))); do
+    TEAM_NAME=$(python3 -c "import json; print(json.load(open('$CONFIG'))['teams'][$i]['name'])")
+    TEAM_ROLE=$(python3 -c "import json; print(json.load(open('$CONFIG'))['teams'][$i]['role'])")
+    TEAM_TASK=$(python3 -c "import json; print(json.load(open('$CONFIG'))['teams'][$i]['task'])")
+    TEAM_MATES=$(python3 -c "import json; print(json.load(open('$CONFIG'))['teams'][$i].get('teammates', 3))")
+    TEAM_MODE=$(python3 -c "import json; print(json.load(open('$CONFIG'))['teams'][$i].get('mode', 'standard'))")
+
+    echo ""
+    echo "--- Setting up $TEAM_NAME ---"
+    echo "  Role: $TEAM_ROLE"
+    echo "  Teammates: $TEAM_MATES"
+    echo "  Mode: $TEAM_MODE"
+
+    # Create team workdir
+    TEAM_DIR="$SHARED_DIR/workdirs/$TEAM_NAME"
+    mkdir -p "$TEAM_DIR"
+
+    # Per-team consciousness file for brain-stream mode
+    CONSCIOUSNESS_FILE="$TEAM_DIR/consciousness.md"
+
+    # Select template based on mode
+    if [[ "$TEAM_MODE" == "brain-stream" ]]; then
+        TEMPLATE="$SCRIPT_DIR/templates/brain-stream-lead.md"
+    else
+        TEMPLATE="$SCRIPT_DIR/templates/team-lead.md"
+    fi
+
+    # Generate CLAUDE.md from template
+    TEAM_CLAUDE="$TEAM_DIR/CLAUDE.md"
+    sed \
+        -e "s|{{TEAM_NAME}}|$TEAM_NAME|g" \
+        -e "s|{{META_TEAM}}|$META_TEAM|g" \
+        -e "s|{{ROLE}}|$TEAM_ROLE|g" \
+        -e "s|{{META_DIR}}|$SHARED_DIR|g" \
+        -e "s|{{MULTI_TEAM_DIR}}|$SCRIPT_DIR|g" \
+        -e "s|{{TASK}}|$TEAM_TASK|g" \
+        -e "s|{{CONSCIOUSNESS_FILE}}|$CONSCIOUSNESS_FILE|g" \
+        "$TEMPLATE" > "$TEAM_CLAUDE"
+
+    # Replace roster (multiline — use python)
+    python3 -c "
+content = open('$TEAM_CLAUDE').read()
+content = content.replace('{{TEAM_ROSTER}}', '''$ROSTER''')
+open('$TEAM_CLAUDE', 'w').write(content)
+"
+
+    # Copy project CLAUDE.md so teams get project context
+    if [[ -f "$PROJECT_DIR/CLAUDE.md" ]]; then
+        cp "$PROJECT_DIR/CLAUDE.md" "$TEAM_DIR/PROJECT_CLAUDE.md"
+    fi
+
+    # Initialize workdir as a git repo so claude trusts it without prompting
+    (cd "$TEAM_DIR" && git init -q 2>/dev/null && git commit --allow-empty -m "init" -q 2>/dev/null) || true
+
+    # Create project-level settings.json with hooks based on mode
+    mkdir -p "$TEAM_DIR/.claude"
+
+    # Brain-stream mode gets the consciousness bridge + stall detection
+    # Standard mode gets the regular mailbox + task hooks
+    if [[ "$TEAM_MODE" == "brain-stream" ]]; then
+        cat > "$TEAM_DIR/.claude/settings.json" <<SETTINGS
+{
+  "env": {
+    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
+    "META_TEAM_NAME": "$META_TEAM",
+    "TEAM_NAME": "$TEAM_NAME",
+    "META_TEAM_DIR": "$META_DIR",
+    "CONSCIOUSNESS_FILE": "$CONSCIOUSNESS_FILE"
+  },
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $SCRIPT_DIR/hooks/check-mailbox.sh",
+            "timeout": 5000
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $SCRIPT_DIR/hooks/consciousness-bridge.sh",
+            "timeout": 5000
+          }
+        ]
+      }
+    ],
+    "TeammateIdle": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $SCRIPT_DIR/hooks/stream-stall-check.sh"
+          }
+        ]
+      }
+    ]
+  }
+}
+SETTINGS
+    else
+        cat > "$TEAM_DIR/.claude/settings.json" <<STDSETTINGS
+{
+  "env": {
+    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
+    "META_TEAM_NAME": "$META_TEAM",
+    "TEAM_NAME": "$TEAM_NAME",
+    "META_TEAM_DIR": "$META_DIR"
+  },
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $SCRIPT_DIR/hooks/check-mailbox.sh",
+            "timeout": 5000
+          }
+        ]
+      }
+    ],
+    "TeammateIdle": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $SCRIPT_DIR/hooks/teammate-idle.sh"
+          }
+        ]
+      }
+    ],
+    "TaskCompleted": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $SCRIPT_DIR/hooks/task-completed.sh"
+          }
+        ]
+      }
+    ]
+  }
+}
+STDSETTINGS
+    fi
+
+    # Install subagent definitions so leads can spawn typed teammates
+    mkdir -p "$TEAM_DIR/.claude/agents"
+    for agent_def in "$SCRIPT_DIR"/agents/*.md; do
+        [[ -f "$agent_def" ]] && cp "$agent_def" "$TEAM_DIR/.claude/agents/"
+    done
+
+    # Fill in placeholders in the agent definitions
+    for agent_file in "$TEAM_DIR/.claude/agents/"*.md; do
+        [[ -f "$agent_file" ]] && sed -i \
+            -e "s|{{CONSCIOUSNESS_FILE}}|$CONSCIOUSNESS_FILE|g" \
+            -e "s|{{MULTI_TEAM_DIR}}|$SCRIPT_DIR|g" \
+            -e "s|{{META_TEAM}}|$META_TEAM|g" \
+            -e "s|{{TEAM_NAME}}|$TEAM_NAME|g" \
+            "$agent_file"
+    done
+
+    # Build the initial prompt based on mode
+    if [[ "$TEAM_MODE" == "brain-stream" ]]; then
+        INIT_PROMPT="$TEAM_TASK
+
+THIS IS A BRAIN STREAM. You are the PACEMAKER.
+1. Initialize the consciousness file at: $CONSCIOUSNESS_FILE
+2. Spawn neurons using the brain-neuron agent type
+3. DO NOT create tasks — neurons self-direct
+4. Read your CLAUDE.md for full brain stream protocol
+5. Bridge critical findings to the FleetCode mailbox for other brains
+
+IMPORTANT CONTEXT:
+- You are $TEAM_NAME in the $META_TEAM fleet"
+    else
+        INIT_PROMPT="$TEAM_TASK
+
+IMPORTANT CONTEXT:
+- You are $TEAM_NAME in the $META_TEAM multi-team operation
+- Read your CLAUDE.md for cross-team mailbox protocol
+- Other teams running in parallel: check $SHARED_DIR/registry.json
+- Post all findings to the shared mailbox immediately
+- Check mailbox for messages from other teams after each task"
+    fi
+
+    # Write the prompt to a file so we can pass it cleanly (avoids shell escaping hell)
+    PROMPT_FILE="$SHARED_DIR/logs/${TEAM_NAME}.prompt"
+    echo "$INIT_PROMPT" > "$PROMPT_FILE"
+
+    LOG_FILE="$SHARED_DIR/logs/${TEAM_NAME}.log"
+
+    if [[ "$MODE" == "interactive" ]]; then
+        # Launch in a real terminal window — fully interactive claude session
+        echo "  Opening terminal window for $TEAM_NAME..."
+
+        # Detect terminal emulator
+        TERMINAL=""
+        if [[ -f "$SCRIPT_DIR/.terminal" ]]; then
+            TERMINAL=$(cat "$SCRIPT_DIR/.terminal")
+        fi
+        # Fallback detection if setup.sh wasn't run
+        if [[ -z "$TERMINAL" ]]; then
+            for t in gnome-terminal xfce4-terminal konsole kitty alacritty wezterm xterm; do
+                if command -v "$t" &>/dev/null; then
+                    TERMINAL="$t"
+                    break
+                fi
+            done
+        fi
+        if [[ -z "$TERMINAL" ]]; then
+            echo "  ERROR: No terminal emulator found. Run setup.sh or use --background"
+            exit 1
+        fi
+
+        # Write a launcher script for this team
+        LAUNCHER="$SHARED_DIR/logs/${TEAM_NAME}-launcher.sh"
+        cat > "$LAUNCHER" <<LAUNCH
+#!/usr/bin/env bash
+export META_TEAM_NAME="$META_TEAM"
+export TEAM_NAME="$TEAM_NAME"
+export META_TEAM_DIR="$META_DIR"
+export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS="1"
+cd "$PROJECT_DIR"
+
+# Log PID for tracking
+echo \$\$ > "$SHARED_DIR/logs/${TEAM_NAME}.pid"
+
+# Source protocol for completion message
+source "$SCRIPT_DIR/lib/protocol.sh"
+meta_register_team "$META_TEAM" "$TEAM_NAME" "$TEAM_ROLE" \$\$ "$TEAM_DIR"
+
+# Launch interactive claude from project dir (already trusted — no folder approval needed)
+INIT_MSG=\$(cat "$PROMPT_FILE")
+claude --dangerously-skip-permissions "\$INIT_MSG"
+
+# On exit, notify other teams
+meta_send "$META_TEAM" "$TEAM_NAME" "all" "status" "$TEAM_NAME session ended"
+LAUNCH
+        chmod +x "$LAUNCHER"
+
+        # Open terminal with the launcher — supports multiple emulators
+        case "$TERMINAL" in
+            gnome-terminal)
+                gnome-terminal --title="$TEAM_NAME — $META_TEAM" \
+                    --geometry=120x40 \
+                    -- bash "$LAUNCHER" &
+                ;;
+            xfce4-terminal)
+                xfce4-terminal --title="$TEAM_NAME — $META_TEAM" \
+                    --geometry=120x40 \
+                    -e "bash $LAUNCHER" &
+                ;;
+            konsole)
+                konsole --title "$TEAM_NAME — $META_TEAM" \
+                    -e bash "$LAUNCHER" &
+                ;;
+            kitty)
+                kitty --title "$TEAM_NAME — $META_TEAM" \
+                    bash "$LAUNCHER" &
+                ;;
+            alacritty)
+                alacritty --title "$TEAM_NAME — $META_TEAM" \
+                    -e bash "$LAUNCHER" &
+                ;;
+            wezterm)
+                wezterm start --cwd "$TEAM_DIR" \
+                    -- bash "$LAUNCHER" &
+                ;;
+            xterm)
+                xterm -title "$TEAM_NAME — $META_TEAM" \
+                    -geometry 120x40 \
+                    -e bash "$LAUNCHER" &
+                ;;
+            *)
+                echo "  Unknown terminal: $TERMINAL — falling back to background mode"
+                MODE="background"
+                ;;
+        esac
+
+        if [[ "$MODE" == "interactive" ]]; then
+            TERM_PID=$!
+            PIDS+=("$TERM_PID")
+            echo "  Terminal ($TERMINAL) PID: $TERM_PID"
+        fi
+    fi
+
+    if [[ "$MODE" == "background" ]]; then
+        # Background mode — claude -p, no terminal window
+        echo "  Launching background claude session (log: $LOG_FILE)..."
+
+        (
+            export META_TEAM_NAME="$META_TEAM"
+            export TEAM_NAME="$TEAM_NAME"
+            export META_TEAM_DIR="$META_DIR"
+            export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS="1"
+            cd "$TEAM_DIR"
+
+            source "$SCRIPT_DIR/lib/protocol.sh"
+            meta_register_team "$META_TEAM" "$TEAM_NAME" "$TEAM_ROLE" $$ "$TEAM_DIR"
+
+            claude --dangerously-skip-permissions -p "$(cat "$PROMPT_FILE")" \
+                > "$LOG_FILE" 2>&1
+
+            meta_send "$META_TEAM" "$TEAM_NAME" "all" "status" "$TEAM_NAME completed its task"
+        ) &
+
+        TEAM_PID=$!
+        PIDS+=("$TEAM_PID")
+        echo "  PID: $TEAM_PID"
+    fi
+done
+
+echo ""
+echo "=== All $NUM_TEAMS teams launched ($MODE mode) ==="
+echo ""
+echo "Monitor:"
+echo "  $SCRIPT_DIR/status.sh $META_TEAM"
+echo ""
+echo "Send message to a team:"
+echo "  $SCRIPT_DIR/send.sh $META_TEAM coordinator <team-name|all> <type> \"<content>\""
+echo ""
+if [[ "$MODE" == "background" ]]; then
+    echo "View logs:"
+    echo "  tail -f $SHARED_DIR/logs/*.log"
+    echo ""
+fi
+echo "Cleanup:"
+echo "  $SCRIPT_DIR/cleanup.sh $META_TEAM"
+echo ""
+
+# Save PIDs for cleanup
+printf '%s\n' "${PIDS[@]}" > "$SHARED_DIR/pids.txt"
+
+echo "PIDs saved to $SHARED_DIR/pids.txt"
+
+if [[ "$MODE" == "interactive" ]]; then
+    echo ""
+    echo "Each team is running in its own terminal window."
+    echo "You can type directly into any team's terminal."
+    echo "Teams communicate via: $SHARED_DIR/mailbox/"
+fi

cli_fleet/scripts/lib/protocol.sh

@@ -0,0 +1,250 @@
+#!/usr/bin/env bash
+# Multi-team communication protocol — shared functions
+# All teams use the same message format and directory layout.
+
+META_DIR="${META_TEAM_DIR:-$HOME/.claude/meta-teams}"
+
+# Initialize a meta-team's shared state directory
+meta_init() {
+    local meta_name="$1"
+    local dir="$META_DIR/$meta_name"
+    mkdir -p "$dir"/{mailbox,findings,tasks,status}
+
+    # Registry: tracks all teams
+    if [[ ! -f "$dir/registry.json" ]]; then
+        echo '{"meta_team":"'"$meta_name"'","created":"'"$(date -Iseconds)"'","teams":[]}' | python3 -m json.tool > "$dir/registry.json"
+    fi
+
+    # Cross-team task list
+    if [[ ! -f "$dir/tasks.json" ]]; then
+        echo '{"tasks":[]}' > "$dir/tasks.json"
+    fi
+
+    echo "$dir"
+}
+
+# Register a team in the registry
+meta_register_team() {
+    local meta_name="$1"
+    local team_name="$2"
+    local role="$3"
+    local pid="$4"
+    local workdir="$5"
+    local dir="$META_DIR/$meta_name"
+
+    python3 -c "
+import json, sys
+with open('$dir/registry.json') as f:
+    reg = json.load(f)
+reg['teams'] = [t for t in reg['teams'] if t['name'] != '$team_name']
+reg['teams'].append({
+    'name': '$team_name',
+    'role': '$role',
+    'pid': $pid,
+    'workdir': '$workdir',
+    'status': 'active',
+    'registered': '$(date -Iseconds)'
+})
+with open('$dir/registry.json', 'w') as f:
+    json.dump(reg, f, indent=2)
+"
+}
+
+# Send a message (file-based mailbox)
+meta_send() {
+    local meta_name="$1"
+    local from="$2"
+    local to="$3"       # team name or "all"
+    local msg_type="$4"  # finding|task|question|status|directive
+    local content="$5"
+    local dir="$META_DIR/$meta_name"
+    local ts
+    ts=$(date +%s%N)
+    local msg_file="$dir/mailbox/${ts}-${from}-to-${to}.json"
+
+    python3 -c "
+import json
+msg = {
+    'id': '${ts}',
+    'from': '$from',
+    'to': '$to',
+    'type': '$msg_type',
+    'timestamp': '$(date -Iseconds)',
+    'content': $(python3 -c "import json; print(json.dumps('''$content'''))")
+}
+with open('$msg_file', 'w') as f:
+    json.dump(msg, f, indent=2)
+"
+    echo "$msg_file"
+}
+
+# Read unread messages for a team
+meta_read_messages() {
+    local meta_name="$1"
+    local team_name="$2"
+    local dir="$META_DIR/$meta_name"
+    local cursor_file="$dir/status/${team_name}.cursor"
+    local last_read="0"
+
+    [[ -f "$cursor_file" ]] && last_read=$(cat "$cursor_file")
+
+    local new_msgs=()
+    for msg_file in "$dir/mailbox/"*.json; do
+        [[ ! -f "$msg_file" ]] && continue
+        local basename
+        basename=$(basename "$msg_file")
+        local msg_ts="${basename%%-*}"
+
+        # Skip already-read messages
+        (( msg_ts <= last_read )) && continue
+
+        # Check if message is for us or broadcast
+        local to
+        to=$(python3 -c "import json; print(json.load(open('$msg_file'))['to'])")
+        if [[ "$to" == "$team_name" || "$to" == "all" ]]; then
+            cat "$msg_file"
+            echo "---"
+            new_msgs+=("$msg_ts")
+        fi
+    done
+
+    # Update cursor to latest read
+    if [[ ${#new_msgs[@]} -gt 0 ]]; then
+        printf '%s\n' "${new_msgs[@]}" | sort -n | tail -1 > "$cursor_file"
+    fi
+}
+
+# Post a finding to shared findings directory
+meta_post_finding() {
+    local meta_name="$1"
+    local team_name="$2"
+    local finding_id="$3"
+    local severity="$4"
+    local title="$5"
+    local details="$6"
+    local dir="$META_DIR/$meta_name"
+    local finding_file="$dir/findings/${team_name}-${finding_id}.json"
+
+    python3 -c "
+import json
+finding = {
+    'id': '$finding_id',
+    'team': '$team_name',
+    'severity': '$severity',
+    'title': $(python3 -c "import json; print(json.dumps('''$title'''))"),
+    'details': $(python3 -c "import json; print(json.dumps('''$details'''))"),
+    'timestamp': '$(date -Iseconds)',
+    'status': 'new'
+}
+with open('$finding_file', 'w') as f:
+    json.dump(finding, f, indent=2)
+"
+
+    # Broadcast finding to all teams
+    meta_send "$meta_name" "$team_name" "all" "finding" "New finding: [$severity] $title — see $finding_file"
+}
+
+# Add/update a cross-team task
+meta_add_task() {
+    local meta_name="$1"
+    local task_id="$2"
+    local title="$3"
+    local assigned_to="$4"  # team name or empty
+    local depends_on="$5"   # comma-separated task IDs or empty
+    local dir="$META_DIR/$meta_name"
+
+    python3 -c "
+import json
+with open('$dir/tasks.json') as f:
+    data = json.load(f)
+data['tasks'] = [t for t in data['tasks'] if t['id'] != '$task_id']
+deps = [d.strip() for d in '$depends_on'.split(',') if d.strip()]
+data['tasks'].append({
+    'id': '$task_id',
+    'title': '''$title''',
+    'assigned_to': '$assigned_to' or None,
+    'status': 'pending',
+    'depends_on': deps,
+    'created': '$(date -Iseconds)',
+    'result': None
+})
+with open('$dir/tasks.json', 'w') as f:
+    json.dump(data, f, indent=2)
+"
+}
+
+# Update task status
+meta_update_task() {
+    local meta_name="$1"
+    local task_id="$2"
+    local status="$3"     # pending|in_progress|completed
+    local result="$4"     # optional result text
+    local dir="$META_DIR/$meta_name"
+
+    python3 -c "
+import json
+with open('$dir/tasks.json') as f:
+    data = json.load(f)
+for t in data['tasks']:
+    if t['id'] == '$task_id':
+        t['status'] = '$status'
+        if '''$result''':
+            t['result'] = '''$result'''
+        break
+with open('$dir/tasks.json', 'w') as f:
+    json.dump(data, f, indent=2)
+"
+}
+
+# Get team status summary
+meta_status() {
+    local meta_name="$1"
+    local dir="$META_DIR/$meta_name"
+
+    echo "=== META-TEAM: $meta_name ==="
+    echo ""
+    echo "--- Teams ---"
+    python3 -c "
+import json
+with open('$dir/registry.json') as f:
+    reg = json.load(f)
+for t in reg['teams']:
+    pid_alive = '✓'
+    try:
+        import os
+        os.kill(t['pid'], 0)
+    except:
+        pid_alive = '✗'
+    print(f\"  {t['name']:20s} [{t['status']:8s}] pid={t['pid']} {pid_alive}  role: {t['role']}\")
+"
+    echo ""
+    echo "--- Tasks ---"
+    python3 -c "
+import json
+with open('$dir/tasks.json') as f:
+    data = json.load(f)
+for t in data['tasks']:
+    assigned = t.get('assigned_to') or 'unassigned'
+    print(f\"  [{t['status']:12s}] {t['id']:15s} → {assigned:15s} | {t['title']}\")
+"
+    echo ""
+    echo "--- Findings ---"
+    local count=0
+    for f in "$dir/findings/"*.json; do
+        [[ ! -f "$f" ]] && continue
+        python3 -c "
+import json
+with open('$f') as fh:
+    finding = json.load(fh)
+print(f\"  [{finding['severity']:8s}] {finding['team']:15s} | {finding['title']}\")
+"
+        ((count++))
+    done
+    [[ $count -eq 0 ]] && echo "  (none yet)"
+
+    echo ""
+    echo "--- Mailbox ---"
+    local msg_count
+    msg_count=$(ls "$dir/mailbox/"*.json 2>/dev/null | wc -l)
+    echo "  $msg_count messages total"
+}