@cyperx/clawforge 1.2.0

package/bin/check-agents.sh

@@ -0,0 +1,343 @@
+#!/usr/bin/env bash
+# check-agents.sh — Module 4: Health check all running agents
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "${SCRIPT_DIR}/../lib/common.sh"
+
+# ── Help ───────────────────────────────────────────────────────────────
+PID_FILE="${CLAWFORGE_DIR}/watch.pid"
+
+usage() {
+  cat <<EOF
+Usage: check-agents.sh [options]
+
+Options:
+  --json       Output as JSON
+  --dry-run    Don't auto-respawn or update registry
+  --daemon     Run continuously in background (interval: 5 min)
+  --interval N Daemon check interval in seconds (default: 300)
+  --stop       Stop the running daemon
+  --help       Show this help
+EOF
+}
+
+JSON_OUTPUT=false
+DRY_RUN=false
+DAEMON=false
+DAEMON_INTERVAL=300
+STOP_DAEMON=false
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --json)       JSON_OUTPUT=true; shift ;;
+    --dry-run)    DRY_RUN=true; shift ;;
+    --daemon)     DAEMON=true; shift ;;
+    --interval)   DAEMON_INTERVAL="$2"; shift 2 ;;
+    --stop)       STOP_DAEMON=true; shift ;;
+    --help|-h)    usage; exit 0 ;;
+    *)            log_error "Unknown option: $1"; usage; exit 1 ;;
+  esac
+done
+
+# ── Stop daemon ───────────────────────────────────────────────────────
+if $STOP_DAEMON; then
+  if [[ -f "$PID_FILE" ]]; then
+    PID=$(cat "$PID_FILE")
+    if kill -0 "$PID" 2>/dev/null; then
+      kill "$PID"
+      rm -f "$PID_FILE"
+      echo "Daemon stopped (PID: $PID)"
+    else
+      rm -f "$PID_FILE"
+      echo "Daemon was not running (stale PID file removed)"
+    fi
+  else
+    echo "No daemon running."
+  fi
+  exit 0
+fi
+
+# ── CI auto-feedback loop ────────────────────────────────────────────
+_ci_feedback() {
+  local id="$1" repo="$2" pr="$3" tmux_session="$4" branch="$5"
+  local ci_retries ci_limit
+
+  ci_retries=$(registry_get "$id" | jq -r '.ci_retries // 0')
+  # Use per-task max_ci_retries if set, otherwise fall back to config
+  ci_limit=$(registry_get "$id" | jq -r '.max_ci_retries // empty' 2>/dev/null || true)
+  [[ -z "$ci_limit" ]] && ci_limit=$(config_get ci_retry_limit 2)
+
+  if [[ "$ci_retries" -ge "$ci_limit" ]]; then
+    log_warn "CI retry limit reached for $id ($ci_retries/$ci_limit)"
+    return 0
+  fi
+
+  # Fetch failed CI log
+  local ci_log
+  ci_log=$(gh run list --repo "$repo" --branch "$branch" --status failure --limit 1 --json databaseId -q '.[0].databaseId' 2>/dev/null || true)
+  if [[ -z "$ci_log" ]]; then
+    return 0
+  fi
+
+  local error_output
+  error_output=$(gh run view "$ci_log" --repo "$repo" --log-failed 2>/dev/null | tail -50 || true)
+  if [[ -z "$error_output" ]]; then
+    return 0
+  fi
+
+  # Auto-steer the agent
+  local steer_msg="CI failed on your PR. Here is the error output:
+
+${error_output}
+
+Fix the issues and push again."
+
+  if tmux has-session -t "$tmux_session" 2>/dev/null; then
+    if [[ ${#steer_msg} -gt 200 ]]; then
+      local tmpfile
+      tmpfile=$(mktemp)
+      echo "$steer_msg" > "$tmpfile"
+      tmux load-buffer "$tmpfile"
+      tmux paste-buffer -t "$tmux_session"
+      tmux send-keys -t "$tmux_session" Enter
+      rm -f "$tmpfile"
+    else
+      tmux send-keys -t "$tmux_session" "$steer_msg" Enter
+    fi
+
+    # Increment ci_retries
+    local new_retries=$((ci_retries + 1))
+    registry_update "$id" "ci_retries" "$new_retries"
+    log_info "CI feedback sent to $id (retry $new_retries/$ci_limit)"
+
+    # Notify
+    "${SCRIPT_DIR}/notify.sh" --type task-failed --description "CI failed for $id (auto-retry $new_retries)" --dry-run 2>/dev/null || true
+  fi
+}
+
+_ensure_registry
+
+# ── Check each task ───────────────────────────────────────────────────
+TASKS=$(jq -c '.tasks[]' "$REGISTRY_FILE" 2>/dev/null || true)
+if [[ -z "$TASKS" ]]; then
+  if $JSON_OUTPUT; then
+    echo '{"tasks":[],"summary":"No active tasks"}'
+  else
+    echo "No active tasks in registry."
+  fi
+  exit 0
+fi
+
+RESULTS="[]"
+
+while IFS= read -r task; do
+  id=$(echo "$task" | jq -r '.id')
+  tmux_session=$(echo "$task" | jq -r '.tmuxSession')
+  branch=$(echo "$task" | jq -r '.branch')
+  repo=$(echo "$task" | jq -r '.repo')
+  status=$(echo "$task" | jq -r '.status')
+  retries=$(echo "$task" | jq -r '.retries')
+  max_retries=$(echo "$task" | jq -r '.maxRetries')
+
+  new_status="$status"
+  pr_number=""
+  ci_status=""
+
+  # Skip completed tasks
+  if [[ "$status" == "done" ]]; then
+    RESULTS=$(echo "$RESULTS" | jq --argjson t "$task" '. += [$t]')
+    continue
+  fi
+
+  # 1. Check tmux session
+  tmux_alive=false
+  if tmux has-session -t "$tmux_session" 2>/dev/null; then
+    tmux_alive=true
+  fi
+
+  # 2. Check for PR
+  if [[ -d "$repo" ]]; then
+    pr_info=$(gh pr list --repo "$repo" --head "$branch" --json number,state 2>/dev/null || echo "[]")
+    pr_number=$(echo "$pr_info" | jq -r '.[0].number // empty' 2>/dev/null || true)
+  fi
+
+  # 3. Determine status
+  if [[ -n "$pr_number" ]]; then
+    new_status="pr-created"
+    if ! $DRY_RUN; then
+      registry_update "$id" "pr" "$pr_number"
+    fi
+
+    # Check CI
+    ci_result=$(gh pr checks "$pr_number" --repo "$repo" 2>/dev/null || true)
+    if echo "$ci_result" | grep -q "pass"; then
+      if ! echo "$ci_result" | grep -qE "fail|pending"; then
+        new_status="ci-passing"
+      fi
+    fi
+
+    # CI auto-feedback loop: if CI failed and agent is alive, steer with error context
+    if echo "$ci_result" | grep -q "fail" && $tmux_alive && ! $DRY_RUN; then
+      _ci_feedback "$id" "$repo" "$pr_number" "$tmux_session" "$branch"
+    fi
+  elif ! $tmux_alive; then
+    # tmux dead + no PR = failed
+    new_status="failed"
+    if ! $DRY_RUN && [[ "$retries" -lt "$max_retries" ]]; then
+      log_warn "Task $id failed, respawning (retry $((retries + 1))/$max_retries)..."
+      new_retries=$((retries + 1))
+      registry_update "$id" "retries" "$new_retries"
+      registry_update "$id" "status" '"spawned"'
+
+      # Respawn
+      worktree=$(echo "$task" | jq -r '.worktree')
+      agent=$(echo "$task" | jq -r '.agent')
+      model=$(echo "$task" | jq -r '.model')
+      desc=$(echo "$task" | jq -r '.description')
+
+      FULL_PROMPT="$desc
+
+When complete:
+1. Commit your changes with a descriptive message
+2. Push the branch: git push origin $branch
+3. Create a PR: gh pr create --fill --base main"
+
+      if [[ "$agent" == "claude" ]]; then
+        AGENT_CMD="claude --model ${model} --dangerously-skip-permissions -p \"$(echo "$FULL_PROMPT" | sed 's/"/\\"/g')\""
+      else
+        AGENT_CMD="codex --model ${model} --dangerously-bypass-approvals-and-sandbox \"$(echo "$FULL_PROMPT" | sed 's/"/\\"/g')\""
+      fi
+
+      tmux kill-session -t "$tmux_session" 2>/dev/null || true
+      tmux new-session -d -s "$tmux_session" -c "$worktree" "$AGENT_CMD"
+      new_status="running"
+      log_info "Respawned task $id"
+    elif ! $DRY_RUN && [[ "$retries" -ge "$max_retries" ]]; then
+      log_error "Task $id failed after $max_retries retries"
+      registry_update "$id" "note" '"Max retries exceeded"'
+    fi
+  elif $tmux_alive; then
+    if [[ "$status" == "spawned" ]]; then
+      new_status="running"
+    fi
+  fi
+
+  # Update status
+  if [[ "$new_status" != "$status" ]] && ! $DRY_RUN; then
+    registry_update "$id" "status" "\"$new_status\""
+    if [[ "$new_status" == "done" || "$new_status" == "failed" || "$new_status" == "timeout" || "$new_status" == "cancelled" ]]; then
+      registry_update "$id" "completedAt" "$(epoch_ms)"
+      "${SCRIPT_DIR}/on-complete.sh" "$id" 2>/dev/null &
+      log_info "Fired on-complete for $id ($new_status)"
+    fi
+  fi
+
+  # Build result entry
+  result=$(echo "$task" | jq \
+    --arg ns "$new_status" \
+    --arg ta "$tmux_alive" \
+    --arg pr "${pr_number:-null}" \
+    '. + {currentStatus: $ns, tmuxAlive: ($ta == "true"), detectedPR: (if $pr == "null" then null else ($pr | tonumber) end)}')
+
+  RESULTS=$(echo "$RESULTS" | jq --argjson r "$result" '. += [$r]')
+done <<< "$TASKS"
+
+# ── Output ─────────────────────────────────────────────────────────────
+# ── Output ─────────────────────────────────────────────────────────────
+_output_results() {
+  if $JSON_OUTPUT; then
+    echo "$RESULTS" | jq '{tasks: ., summary: {total: length, running: [.[] | select(.currentStatus == "running")] | length, failed: [.[] | select(.currentStatus == "failed")] | length, done: [.[] | select(.currentStatus == "done")] | length}}'
+  else
+    echo "=== Agent Status Check ==="
+    echo ""
+    echo "$RESULTS" | jq -r '.[] | "  [\(.currentStatus)] \(.id) — \(.agent)/\(.model) (tmux: \(.tmuxAlive), PR: \(.detectedPR // "none"))"'
+    echo ""
+    total=$(echo "$RESULTS" | jq 'length')
+    running=$(echo "$RESULTS" | jq '[.[] | select(.currentStatus == "running")] | length')
+    echo "Total: $total | Running: $running"
+  fi
+}
+
+_output_results
+
+# ── Daemon mode ───────────────────────────────────────────────────────
+if $DAEMON; then
+  # Write PID file
+  echo $$ > "$PID_FILE"
+  log_info "Watch daemon started (PID: $$, interval: ${DAEMON_INTERVAL}s)"
+  log_info "PID file: $PID_FILE"
+  log_info "Stop with: clawforge watch --stop"
+
+  _daemon_cleanup() {
+    rm -f "$PID_FILE"
+    log_info "Watch daemon stopped"
+  }
+  trap _daemon_cleanup EXIT INT TERM
+
+  while true; do
+    sleep "$DAEMON_INTERVAL"
+
+    # Re-run the check (re-read tasks from registry)
+    TASKS=$(jq -c '.tasks[]' "$REGISTRY_FILE" 2>/dev/null || true)
+    if [[ -z "$TASKS" ]]; then
+      log_debug "Daemon: no active tasks"
+      continue
+    fi
+
+    RESULTS="[]"
+    while IFS= read -r task; do
+      id=$(echo "$task" | jq -r '.id')
+      tmux_session=$(echo "$task" | jq -r '.tmuxSession')
+      branch=$(echo "$task" | jq -r '.branch')
+      repo=$(echo "$task" | jq -r '.repo')
+      status=$(echo "$task" | jq -r '.status')
+
+      if [[ "$status" == "done" || "$status" == "stopped" || "$status" == "archived" ]]; then
+        continue
+      fi
+
+      new_status="$status"
+      tmux_alive=false
+      tmux has-session -t "$tmux_session" 2>/dev/null && tmux_alive=true
+
+      pr_number=""
+      if [[ -d "$repo" ]]; then
+        pr_info=$(gh pr list --repo "$repo" --head "$branch" --json number,state 2>/dev/null || echo "[]")
+        pr_number=$(echo "$pr_info" | jq -r '.[0].number // empty' 2>/dev/null || true)
+      fi
+
+      if [[ -n "$pr_number" ]]; then
+        if [[ "$status" != "pr-created" && "$status" != "ci-passing" && "$status" != "reviewing" ]]; then
+          new_status="pr-created"
+          registry_update "$id" "pr" "$pr_number"
+          "${SCRIPT_DIR}/notify.sh" --type pr-ready --description "$(echo "$task" | jq -r '.description')" --pr "$pr_number" 2>/dev/null || true
+        fi
+
+        ci_result=$(gh pr checks "$pr_number" --repo "$repo" 2>/dev/null || true)
+        if echo "$ci_result" | grep -q "pass" && ! echo "$ci_result" | grep -qE "fail|pending"; then
+          new_status="ci-passing"
+        elif echo "$ci_result" | grep -q "fail" && $tmux_alive; then
+          _ci_feedback "$id" "$repo" "$pr_number" "$tmux_session" "$branch"
+        fi
+      elif ! $tmux_alive && [[ "$status" == "running" || "$status" == "spawned" ]]; then
+        new_status="failed"
+        "${SCRIPT_DIR}/notify.sh" --type task-failed --description "$(echo "$task" | jq -r '.description')" 2>/dev/null || true
+      fi
+
+      if [[ "$new_status" != "$status" ]]; then
+        registry_update "$id" "status" "\"$new_status\""
+        log_info "Daemon: $id status changed: $status → $new_status"
+
+        # Fire completion hooks on terminal states
+        case "$new_status" in
+          done|failed|timeout|cancelled)
+            registry_update "$id" "completedAt" "$(epoch_ms)"
+            "${SCRIPT_DIR}/on-complete.sh" "$id" 2>/dev/null &
+            log_info "Daemon: fired on-complete for $id ($new_status)"
+            ;;
+        esac
+      fi
+    done <<< "$TASKS"
+  done
+fi

package/bin/clawforge

@@ -0,0 +1,257 @@
+#!/usr/bin/env bash
+# clawforge — Unified CLI for agent swarm workflow
+# Routes subcommands to individual module scripts.
+set -euo pipefail
+
+# Resolve symlinks to find the real install location
+SOURCE="${BASH_SOURCE[0]}"
+while [[ -L "$SOURCE" ]]; do
+  DIR="$(cd "$(dirname "$SOURCE")" && pwd)"
+  SOURCE="$(readlink "$SOURCE")"
+  [[ "$SOURCE" != /* ]] && SOURCE="$DIR/$SOURCE"
+done
+CLAWFORGE_DIR="$(cd "$(dirname "$SOURCE")/.." && pwd)"
+BIN_DIR="${CLAWFORGE_DIR}/bin"
+
+# ── Global flags ───────────────────────────────────────────────────────
+PASSTHROUGH_ARGS=()
+for arg in "$@"; do
+  if [[ "$arg" == "--verbose" ]]; then
+    export CLAWFORGE_DEBUG=1
+  else
+    PASSTHROUGH_ARGS+=("$arg")
+  fi
+done
+set -- "${PASSTHROUGH_ARGS[@]+"${PASSTHROUGH_ARGS[@]}"}"
+
+# ── Version ────────────────────────────────────────────────────────────
+show_version() {
+  local ver
+  ver=$(cat "${CLAWFORGE_DIR}/VERSION" 2>/dev/null || echo "unknown")
+  echo "clawforge v${ver}"
+}
+
+# ── Help ───────────────────────────────────────────────────────────────
+show_help() {
+  local show_all=false
+  [[ "${1:-}" == "--all" ]] && show_all=true
+
+  cat <<EOF
+$(show_version)
+Multi-mode coding workflow CLI — from quick patches to parallel agent orchestration.
+
+Usage: clawforge <command> [options]
+
+Workflow Modes:
+  sprint      Single agent, full dev cycle (the workhorse)
+  review      Quality gate on an existing PR (analysis only)
+  swarm       Parallel multi-agent orchestration
+
+Management:
+  status      Show all tracked tasks with short IDs
+  resume      Resume a failed/timeout task from where it left off
+  diff        Show git diff for a task without attaching
+  pr          Create a PR from a task branch
+  attach      Attach to a running agent's tmux session
+  steer       Send course correction to a running agent
+  stop        Stop a running agent
+  watch       Monitor agent health (supports --daemon)
+  dashboard   Live TUI dashboard with vim keybindings
+
+Observability (v0.5):
+  cost        Token/cost tracking and budget management
+  conflicts   Swarm conflict detection and resolution
+  templates   Task template management
+
+Fleet Ops (v0.6):
+  memory      Per-repo agent memory (show, add, search, forget, clear)
+  init        Scan project and generate initial memory entries
+  history     Show completed task history
+
+Reliability (v0.7):
+  doctor      Diagnose orphaned sessions, dangling worktrees, stale tasks
+
+Observability (v0.9):
+  logs        Capture agent output from tmux (without attaching)
+  on-complete Fire completion hooks for finished tasks
+
+Power Features (v1.2):
+  config      Manage user configuration (~/.clawforge/config.json)
+  multi-review Run PR through multiple models and compare feedback
+  summary     AI-generated summary of what an agent did
+  parse-cost  Parse real cost/token data from agent output
+
+Evaluation (v0.6.2):
+  eval        Run-eval logging and weekly summaries
+
+Lifecycle:
+  clean       Clean up completed tasks
+  learn       Record learnings from completed tasks
+EOF
+
+  if $show_all; then
+    cat <<EOF
+
+Direct Module Access:
+  scope       Assemble a prompt with context (Module 1)
+  spawn       Create worktree + launch coding agent (Module 2)
+  notify      Send Discord notification (Module 6)
+  merge       Merge helper with safety checks (Module 7)
+  run         Scope + spawn in one step (legacy shortcut)
+EOF
+  fi
+
+  cat <<EOF
+
+Meta:
+  help        Show this help (use --all for direct module commands)
+  version     Show version
+
+Global flags:
+  --verbose   Enable debug logging
+
+Examples:
+  clawforge sprint "Add JWT authentication middleware"
+  clawforge sprint "Fix typo in readme" --quick
+  clawforge sprint --template refactor "Refactor auth module"
+  clawforge review --pr 42
+  clawforge swarm "Migrate all tests from jest to vitest"
+  clawforge swarm --template migration "Migrate to TypeScript" --ci-loop
+  clawforge swarm --repos ~/api,~/web,~/shared "Upgrade auth library"
+  clawforge sprint --routing auto "Refactor auth service"
+  clawforge steer 1 "Use bcrypt instead of md5"
+  clawforge dashboard
+  clawforge cost --summary
+  clawforge memory show
+  clawforge memory add "Always run tests first"
+  clawforge init
+  clawforge history --repo api
+  clawforge eval log --command sprint --mode quick --repo api --status ok --duration-ms 420000
+  clawforge eval weekly
+  clawforge templates
+EOF
+}
+
+# ── Dashboard (v0.5: routes to TUI, legacy fallback kept as show_dashboard_legacy) ─
+
+# ── Run shortcut (scope + spawn) ──────────────────────────────────────
+run_combined() {
+  # Parse --repo, --branch, --task from args, pass rest to spawn
+  local repo="" branch="" task=""
+  local extra_args=()
+
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --repo)     repo="$2"; shift 2 ;;
+      --branch)   branch="$2"; shift 2 ;;
+      --task)     task="$2"; shift 2 ;;
+      *)          extra_args+=("$1"); shift ;;
+    esac
+  done
+
+  if [[ -z "$repo" || -z "$branch" || -z "$task" ]]; then
+    echo "Usage: clawforge run --repo <path> --branch <name> --task \"description\"" >&2
+    echo "All three flags are required." >&2
+    exit 1
+  fi
+
+  echo "── Step 1: Scope ─────────────────────────────────────────────"
+  local prompt
+  prompt=$("${BIN_DIR}/scope-task.sh" --task "$task" "${extra_args[@]+"${extra_args[@]}"}" 2>/dev/null || echo "$task")
+
+  echo "── Step 2: Spawn ─────────────────────────────────────────────"
+  "${BIN_DIR}/spawn-agent.sh" --repo "$repo" --branch "$branch" --task "$prompt" "${extra_args[@]+"${extra_args[@]}"}"
+}
+
+# ── Status (pretty wrapper around registry) ────────────────────────────
+show_status() {
+  source "${CLAWFORGE_DIR}/lib/common.sh"
+  local tasks
+  tasks=$(registry_list "$@" 2>/dev/null || echo "[]")
+  local count
+  count=$(echo "$tasks" | jq 'length' 2>/dev/null || echo 0)
+
+  if [[ "$count" == "0" ]]; then
+    echo "No active tasks."
+    return 0
+  fi
+
+  # Enhanced status with short IDs and mode column
+  echo "$tasks" | jq -r '.[] |
+    def sid: if .short_id then "#\(.short_id)" else .id end;
+    def mode: .mode // "—";
+    def elapsed:
+      (now * 1000 - (.startedAt // 0)) / 60000 | floor | tostring + "m ago";
+    def extra:
+      if .mode == "swarm" and .sub_task_count then " (\(.sub_task_count) agents)" else "" end;
+    "  \(sid)  \(mode)  \(.status // "?")  \(.repo // "" | split("/") | last)  \"\(.description // "")[0:50]\"\(extra)"
+  ' 2>/dev/null || \
+  echo "$tasks" | jq -r '.[] | "[\(.status // "?")] \(.id)  \(.agent // "")/\(.model // "")  \(.task // .description // "")[0:60]"' 2>/dev/null || echo "$tasks"
+}
+
+# ── Route subcommand ───────────────────────────────────────────────────
+COMMAND="${1:-help}"
+shift 2>/dev/null || true
+
+case "$COMMAND" in
+  # Workflow modes (v0.4)
+  sprint)     exec "${BIN_DIR}/sprint.sh" "$@" ;;
+  review)     exec "${BIN_DIR}/review-mode.sh" "$@" ;;
+  swarm)      exec "${BIN_DIR}/swarm.sh" "$@" ;;
+
+  # Management commands (v0.4)
+  steer)      exec "${BIN_DIR}/steer.sh" "$@" ;;
+  attach)     exec "${BIN_DIR}/attach.sh" "$@" ;;
+  stop)       exec "${BIN_DIR}/stop.sh" "$@" ;;
+
+  # Existing commands
+  status)     show_status "$@" ;;
+  watch)      exec "${BIN_DIR}/check-agents.sh" "$@" ;;
+  dashboard)
+    # Prefer Go TUI binary if available, fallback to dashboard.sh
+    if [[ -x "${BIN_DIR}/clawforge-dashboard" ]]; then
+      exec "${BIN_DIR}/clawforge-dashboard" "$@"
+    else
+      exec "${BIN_DIR}/dashboard.sh" "$@"
+    fi
+    ;;
+  clean)      exec "${BIN_DIR}/clean.sh" "$@" ;;
+  learn)      exec "${BIN_DIR}/learn.sh" "$@" ;;
+
+  # v0.5 observability + intelligence
+  cost)       exec "${BIN_DIR}/cost.sh" "$@" ;;
+  conflicts)  exec "${BIN_DIR}/conflicts.sh" "$@" ;;
+  templates)  exec "${BIN_DIR}/templates.sh" "$@" ;;
+
+  # v0.6 fleet operations
+  memory)     exec "${BIN_DIR}/memory.sh" "$@" ;;
+  init)       exec "${BIN_DIR}/init.sh" "$@" ;;
+  history)    exec "${BIN_DIR}/history.sh" "$@" ;;
+  eval)       exec "${BIN_DIR}/eval.sh" "$@" ;;
+doctor)     exec "${BIN_DIR}/doctor.sh" "$@" ;;
+  resume)     exec "${BIN_DIR}/resume.sh" "$@" ;;
+  diff)       exec "${BIN_DIR}/diff.sh" "$@" ;;
+  pr)         exec "${BIN_DIR}/pr.sh" "$@" ;;
+  config)     exec "${BIN_DIR}/config.sh" "$@" ;;
+  multi-review) exec "${BIN_DIR}/multi-review.sh" "$@" ;;
+  summary)    exec "${BIN_DIR}/summary.sh" "$@" ;;
+  parse-cost) exec "${BIN_DIR}/parse-cost.sh" "$@" ;;
+  logs)       exec "${BIN_DIR}/logs.sh" "$@" ;;
+  on-complete) exec "${BIN_DIR}/on-complete.sh" "$@" ;;
+
+  # Direct module access (hidden from main help)
+  scope)      exec "${BIN_DIR}/scope-task.sh" "$@" ;;
+  spawn)      exec "${BIN_DIR}/spawn-agent.sh" "$@" ;;
+  notify)     exec "${BIN_DIR}/notify.sh" "$@" ;;
+  merge)      exec "${BIN_DIR}/merge-helper.sh" "$@" ;;
+  run)        run_combined "$@" ;;
+
+  # Meta
+  version|-v|--version) show_version ;;
+  help|-h|--help)       show_help "$@" ;;
+  *)
+    echo "Unknown command: $COMMAND" >&2
+    echo "Run 'clawforge help' for usage." >&2
+    exit 1
+    ;;
+esac