@cyperx/clawforge 1.2.0

package/bin/merge-helper.sh

@@ -0,0 +1,174 @@
+#!/usr/bin/env bash
+# merge-helper.sh — Module 7: PR merge helper with safety checks
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "${SCRIPT_DIR}/../lib/common.sh"
+
+# ── Help ───────────────────────────────────────────────────────────────
+usage() {
+  cat <<EOF
+Usage: merge-helper.sh --repo <path> --pr <number> [options]
+
+Options:
+  --repo <path>     Path to the git repository (required)
+  --pr <number>     PR number (required)
+  --auto            Auto-merge if CI passing and reviews approved
+  --squash          Use squash merge
+  --task-id <id>    Task ID to update in registry
+  --dry-run         Show what would happen without executing
+  --help            Show this help
+EOF
+}
+
+# ── Parse args ─────────────────────────────────────────────────────────
+REPO="" PR_NUMBER="" AUTO=false SQUASH=false TASK_ID="" DRY_RUN=false
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --repo)     REPO="$2"; shift 2 ;;
+    --pr)       PR_NUMBER="$2"; shift 2 ;;
+    --auto)     AUTO=true; shift ;;
+    --squash)   SQUASH=true; shift ;;
+    --task-id)  TASK_ID="$2"; shift 2 ;;
+    --dry-run)  DRY_RUN=true; shift ;;
+    --help|-h)  usage; exit 0 ;;
+    *)          log_error "Unknown option: $1"; usage; exit 1 ;;
+  esac
+done
+
+[[ -z "$REPO" ]]      && { log_error "--repo is required"; usage; exit 1; }
+[[ -z "$PR_NUMBER" ]] && { log_error "--pr is required"; usage; exit 1; }
+
+REPO_ABS=$(cd "$REPO" && pwd)
+
+# ── Resolve task ID from registry if not given ────────────────────────
+if [[ -z "$TASK_ID" ]]; then
+  _ensure_registry
+  TASK_ID=$(jq -r --argjson pr "$PR_NUMBER" '.tasks[] | select(.pr == $pr) | .id' "$REGISTRY_FILE" 2>/dev/null || true)
+fi
+
+# ── Fetch PR info ────────────────────────────────────────────────────
+log_info "Fetching PR #${PR_NUMBER} info..."
+PR_INFO=$(gh pr view "$PR_NUMBER" --repo "$REPO_ABS" --json title,body,state,mergeable,reviewDecision,statusCheckRollup,additions,deletions,changedFiles 2>/dev/null || echo '{}')
+
+PR_TITLE=$(echo "$PR_INFO" | jq -r '.title // "unknown"')
+PR_STATE=$(echo "$PR_INFO" | jq -r '.state // "unknown"')
+PR_MERGEABLE=$(echo "$PR_INFO" | jq -r '.mergeable // "unknown"')
+PR_REVIEW=$(echo "$PR_INFO" | jq -r '.reviewDecision // "none"')
+ADDITIONS=$(echo "$PR_INFO" | jq -r '.additions // 0')
+DELETIONS=$(echo "$PR_INFO" | jq -r '.deletions // 0')
+CHANGED=$(echo "$PR_INFO" | jq -r '.changedFiles // 0')
+
+# Check CI status
+CI_STATUS="unknown"
+CI_CHECKS=$(echo "$PR_INFO" | jq '.statusCheckRollup // []')
+if [[ "$CI_CHECKS" != "null" && "$CI_CHECKS" != "[]" ]]; then
+  FAILING=$(echo "$CI_CHECKS" | jq '[.[] | select(.conclusion != "SUCCESS" and .conclusion != null)] | length')
+  PENDING=$(echo "$CI_CHECKS" | jq '[.[] | select(.conclusion == null)] | length')
+  if [[ "$FAILING" -gt 0 ]]; then
+    CI_STATUS="failing"
+  elif [[ "$PENDING" -gt 0 ]]; then
+    CI_STATUS="pending"
+  else
+    CI_STATUS="passing"
+  fi
+else
+  CI_STATUS="no-checks"
+fi
+
+# ── Summary ──────────────────────────────────────────────────────────
+echo "=== PR #${PR_NUMBER} Summary ==="
+echo "Title:     $PR_TITLE"
+echo "State:     $PR_STATE"
+echo "Mergeable: $PR_MERGEABLE"
+echo "Reviews:   $PR_REVIEW"
+echo "CI:        $CI_STATUS"
+echo "Diff:      +${ADDITIONS} -${DELETIONS} (${CHANGED} files)"
+echo ""
+
+# ── Merge decision ───────────────────────────────────────────────────
+MERGE_CMD="gh pr merge $PR_NUMBER --repo $REPO_ABS"
+if $SQUASH; then
+  MERGE_CMD+=" --squash"
+else
+  MERGE_CMD+=" --merge"
+fi
+MERGE_CMD+=" --delete-branch"
+
+CAN_AUTO=true
+REASONS=()
+
+if [[ "$PR_STATE" != "OPEN" ]]; then
+  CAN_AUTO=false
+  REASONS+=("PR is not open (state: $PR_STATE)")
+fi
+
+if [[ "$CI_STATUS" == "failing" ]]; then
+  CAN_AUTO=false
+  REASONS+=("CI checks are failing")
+elif [[ "$CI_STATUS" == "pending" ]]; then
+  CAN_AUTO=false
+  REASONS+=("CI checks still pending")
+fi
+
+if [[ "$PR_REVIEW" != "APPROVED" ]]; then
+  CAN_AUTO=false
+  REASONS+=("Not all reviews approved (status: $PR_REVIEW)")
+fi
+
+if [[ "$PR_MERGEABLE" == "CONFLICTING" ]]; then
+  CAN_AUTO=false
+  REASONS+=("PR has merge conflicts")
+fi
+
+if $AUTO; then
+  if $CAN_AUTO; then
+    log_info "All checks pass, proceeding with auto-merge"
+    if $DRY_RUN; then
+      echo "[dry-run] Would execute: $MERGE_CMD"
+    else
+      eval "$MERGE_CMD" || { log_error "Merge failed"; exit 1; }
+      log_info "PR #${PR_NUMBER} merged successfully"
+
+      # Update registry
+      if [[ -n "$TASK_ID" ]]; then
+        registry_update "$TASK_ID" "status" '"done"'
+        registry_update "$TASK_ID" "completedAt" "$(epoch_ms)"
+        log_info "Registry updated: $TASK_ID → done"
+      fi
+
+      # Trigger cleanup
+      CLEAN_SCRIPT="${SCRIPT_DIR}/clean.sh"
+      if [[ -n "$TASK_ID" && -x "$CLEAN_SCRIPT" ]]; then
+        log_info "Triggering cleanup for task $TASK_ID"
+        "$CLEAN_SCRIPT" --task-id "$TASK_ID" 2>/dev/null || log_warn "Cleanup had issues"
+      fi
+
+      # Trigger notification
+      NOTIFY_SCRIPT="${SCRIPT_DIR}/notify.sh"
+      if [[ -x "$NOTIFY_SCRIPT" ]]; then
+        "$NOTIFY_SCRIPT" --type task-done --task-id "${TASK_ID:-}" --description "$PR_TITLE" 2>/dev/null || log_warn "Notification had issues"
+      fi
+    fi
+  else
+    log_warn "Cannot auto-merge:"
+    for reason in "${REASONS[@]}"; do
+      echo "  • $reason"
+    done
+    exit 1
+  fi
+else
+  if $CAN_AUTO; then
+    echo "Ready to merge. Run:"
+    echo "  $MERGE_CMD"
+  else
+    echo "Not ready to merge:"
+    for reason in "${REASONS[@]}"; do
+      echo "  • $reason"
+    done
+    echo ""
+    echo "Manual merge command (when ready):"
+    echo "  $MERGE_CMD"
+  fi
+fi

package/bin/multi-review.sh

@@ -0,0 +1,215 @@
+#!/usr/bin/env bash
+# multi-review.sh — Run a PR through multiple models and compare feedback
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "${SCRIPT_DIR}/../lib/common.sh"
+
+usage() {
+  cat <<EOF
+Usage: clawforge multi-review --pr <number> [options]
+
+Run a PR through multiple AI models and compare their review feedback.
+
+Options:
+  --pr <number>        PR number (required)
+  --repo <path>        Repository path (default: auto-detect)
+  --models <list>      Comma-separated model list (default: from config review_models)
+  --output <dir>       Save individual reviews to directory
+  --diff-only          Show only where models disagree
+  --json               Output as JSON
+  --dry-run            Show what would run
+  --help               Show this help
+
+Examples:
+  clawforge multi-review --pr 42
+  clawforge multi-review --pr 42 --models "claude-sonnet-4-5,gpt-5.2-codex,claude-opus-4"
+  clawforge multi-review --pr 42 --output /tmp/reviews --diff-only
+EOF
+}
+
+PR="" REPO="" MODELS="" OUTPUT_DIR="" DIFF_ONLY=false JSON_OUTPUT=false DRY_RUN=false
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --pr)        PR="$2"; shift 2 ;;
+    --repo)      REPO="$2"; shift 2 ;;
+    --models)    MODELS="$2"; shift 2 ;;
+    --output)    OUTPUT_DIR="$2"; shift 2 ;;
+    --diff-only) DIFF_ONLY=true; shift ;;
+    --json)      JSON_OUTPUT=true; shift ;;
+    --dry-run)   DRY_RUN=true; shift ;;
+    --help|-h)   usage; exit 0 ;;
+    --*)         log_error "Unknown option: $1"; usage; exit 1 ;;
+    *)           shift ;;
+  esac
+done
+
+[[ -z "$PR" ]] && { log_error "--pr required"; usage; exit 1; }
+
+# Resolve repo
+if [[ -z "$REPO" ]]; then
+  REPO=$(detect_repo) || { log_error "No repo found"; exit 1; }
+fi
+REPO_ABS=$(cd "$REPO" && pwd)
+
+# Resolve models
+if [[ -z "$MODELS" ]]; then
+  MODELS=$(config_get review_models "claude-sonnet-4-5,gpt-5.2-codex")
+fi
+IFS=',' read -ra MODEL_LIST <<< "$MODELS"
+MODEL_COUNT=${#MODEL_LIST[@]}
+
+log_info "Multi-model review: PR #${PR} with ${MODEL_COUNT} models"
+
+# Get PR diff
+PR_DIFF=$(gh pr diff "$PR" --repo "$REPO_ABS" 2>/dev/null || true)
+if [[ -z "$PR_DIFF" ]]; then
+  log_error "Could not fetch diff for PR #${PR}"
+  exit 1
+fi
+
+PR_TITLE=$(gh pr view "$PR" --repo "$REPO_ABS" --json title -q '.title' 2>/dev/null || echo "PR #${PR}")
+PR_BODY=$(gh pr view "$PR" --repo "$REPO_ABS" --json body -q '.body' 2>/dev/null || echo "")
+
+# Build review prompt
+REVIEW_PROMPT="Review this pull request. Focus on:
+1. Bugs or logic errors
+2. Security issues
+3. Performance concerns
+4. Code style and best practices
+5. Missing edge cases or tests
+
+PR: ${PR_TITLE}
+${PR_BODY:+Description: ${PR_BODY}}
+
+Diff:
+\`\`\`diff
+$(echo "$PR_DIFF" | head -500)
+\`\`\`
+
+Provide a structured review with severity levels (critical/warning/info) for each finding."
+
+# Dry run
+if $DRY_RUN; then
+  echo "=== Multi-Review Dry Run ==="
+  echo "  PR:     #${PR} — ${PR_TITLE}"
+  echo "  Repo:   $REPO_ABS"
+  echo "  Models: ${MODELS}"
+  echo "  Count:  $MODEL_COUNT"
+  [[ -n "$OUTPUT_DIR" ]] && echo "  Output: $OUTPUT_DIR"
+  echo ""
+  echo "Would run review with each model in parallel."
+  exit 0
+fi
+
+# Create output dir
+REVIEW_DIR="${OUTPUT_DIR:-$(mktemp -d)}"
+mkdir -p "$REVIEW_DIR"
+
+# Run reviews in parallel
+PIDS=()
+for model in "${MODEL_LIST[@]}"; do
+  model=$(echo "$model" | xargs)  # trim whitespace
+  SAFE_MODEL=$(echo "$model" | tr '/' '-' | tr '.' '-')
+  OUT_FILE="${REVIEW_DIR}/review-${SAFE_MODEL}.md"
+
+  log_info "Starting review with $model..."
+
+  (
+    if command -v claude &>/dev/null; then
+      claude --model "$model" -p "$REVIEW_PROMPT" > "$OUT_FILE" 2>/dev/null
+    else
+      echo "Model $model: claude CLI not available" > "$OUT_FILE"
+    fi
+  ) &
+  PIDS+=($!)
+done
+
+# Wait for all reviews
+FAILED=0
+for i in "${!PIDS[@]}"; do
+  if ! wait "${PIDS[$i]}" 2>/dev/null; then
+    FAILED=$((FAILED + 1))
+    log_warn "Review with ${MODEL_LIST[$i]} failed"
+  fi
+done
+
+log_info "All reviews complete ($((MODEL_COUNT - FAILED))/$MODEL_COUNT succeeded)"
+
+# Collect results
+REVIEWS=()
+for model in "${MODEL_LIST[@]}"; do
+  model=$(echo "$model" | xargs)
+  SAFE_MODEL=$(echo "$model" | tr '/' '-' | tr '.' '-')
+  OUT_FILE="${REVIEW_DIR}/review-${SAFE_MODEL}.md"
+  if [[ -f "$OUT_FILE" ]]; then
+    REVIEWS+=("$OUT_FILE")
+  fi
+done
+
+# Generate comparison
+if [[ ${#REVIEWS[@]} -gt 1 ]]; then
+  COMPARE_FILE="${REVIEW_DIR}/comparison.md"
+
+  {
+    echo "# Multi-Model Review Comparison"
+    echo "PR #${PR}: ${PR_TITLE}"
+    echo "Models: ${MODELS}"
+    echo "Date: $(date)"
+    echo ""
+
+    for model in "${MODEL_LIST[@]}"; do
+      model=$(echo "$model" | xargs)
+      SAFE_MODEL=$(echo "$model" | tr '/' '-' | tr '.' '-')
+      OUT_FILE="${REVIEW_DIR}/review-${SAFE_MODEL}.md"
+      if [[ -f "$OUT_FILE" ]]; then
+        echo "---"
+        echo "## ${model}"
+        echo ""
+        cat "$OUT_FILE"
+        echo ""
+      fi
+    done
+
+    echo "---"
+    echo "## Summary"
+    echo ""
+    echo "| Model | Findings |"
+    echo "|-------|----------|"
+    for model in "${MODEL_LIST[@]}"; do
+      model=$(echo "$model" | xargs)
+      SAFE_MODEL=$(echo "$model" | tr '/' '-' | tr '.' '-')
+      OUT_FILE="${REVIEW_DIR}/review-${SAFE_MODEL}.md"
+      if [[ -f "$OUT_FILE" ]]; then
+        FINDING_COUNT=$(grep -ciE "critical|warning|bug|issue|error|concern" "$OUT_FILE" 2>/dev/null || echo "0")
+        echo "| $model | ~${FINDING_COUNT} findings |"
+      fi
+    done
+  } > "$COMPARE_FILE"
+fi
+
+# Output
+if $JSON_OUTPUT; then
+  jq -n \
+    --arg pr "$PR" \
+    --arg title "$PR_TITLE" \
+    --arg models "$MODELS" \
+    --argjson count "$MODEL_COUNT" \
+    --argjson failed "$FAILED" \
+    --arg dir "$REVIEW_DIR" \
+    '{pr:$pr, title:$title, models:$models, modelCount:$count, failed:$failed, outputDir:$dir}'
+else
+  echo ""
+  echo "  Multi-Model Review: PR #${PR}"
+  echo "  Models: ${MODELS}"
+  echo "  Results: $((MODEL_COUNT - FAILED))/$MODEL_COUNT succeeded"
+  echo ""
+  echo "  Reviews saved to: $REVIEW_DIR"
+  [[ -f "${REVIEW_DIR}/comparison.md" ]] && echo "  Comparison: ${REVIEW_DIR}/comparison.md"
+  echo ""
+
+  if ! $DIFF_ONLY && [[ -f "${REVIEW_DIR}/comparison.md" ]]; then
+    cat "${REVIEW_DIR}/comparison.md"
+  fi
+fi

package/bin/notify.sh

@@ -0,0 +1,93 @@
+#!/usr/bin/env bash
+# notify.sh — Module 6: Send Discord notifications via openclaw
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "${SCRIPT_DIR}/../lib/common.sh"
+
+# ── Help ───────────────────────────────────────────────────────────────
+usage() {
+  cat <<EOF
+Usage: notify.sh [options]
+
+Options:
+  --channel <id>      Discord channel target (default: from config)
+  --message <text>    Raw message text
+  --type <type>       Notification type: task-started, pr-ready, task-failed, task-done
+  --task-id <id>      Task ID to look up details from registry
+  --description <d>   Description (used with --type if no --task-id)
+  --pr <number>       PR number (used with pr-ready type)
+  --retry <n/m>       Retry count (used with task-failed type)
+  --dry-run           Show command without executing
+  --help              Show this help
+EOF
+}
+
+# ── Parse args ─────────────────────────────────────────────────────────
+CHANNEL="" MESSAGE="" TYPE="" TASK_ID="" DESCRIPTION="" PR_NUM="" RETRY="" DRY_RUN=false
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --channel)     CHANNEL="$2"; shift 2 ;;
+    --message)     MESSAGE="$2"; shift 2 ;;
+    --type)        TYPE="$2"; shift 2 ;;
+    --task-id)     TASK_ID="$2"; shift 2 ;;
+    --description) DESCRIPTION="$2"; shift 2 ;;
+    --pr)          PR_NUM="$2"; shift 2 ;;
+    --retry)       RETRY="$2"; shift 2 ;;
+    --dry-run)     DRY_RUN=true; shift ;;
+    --help|-h)     usage; exit 0 ;;
+    *)             log_error "Unknown option: $1"; usage; exit 1 ;;
+  esac
+done
+
+# ── Resolve channel ──────────────────────────────────────────────────
+if [[ -z "$CHANNEL" ]]; then
+  CHANNEL=$(config_get "notify.defaultChannel" "channel:1476433491452498000")
+fi
+
+# ── Resolve task details from registry ────────────────────────────────
+if [[ -n "$TASK_ID" ]]; then
+  TASK_DATA=$(registry_get "$TASK_ID")
+  if [[ -n "$TASK_DATA" ]]; then
+    [[ -z "$DESCRIPTION" ]] && DESCRIPTION=$(echo "$TASK_DATA" | jq -r '.description // ""')
+    [[ -z "$PR_NUM" ]] && PR_NUM=$(echo "$TASK_DATA" | jq -r '.pr // empty' 2>/dev/null || true)
+  else
+    log_warn "Task '$TASK_ID' not found in registry"
+  fi
+fi
+
+# ── Build message from type ──────────────────────────────────────────
+if [[ -n "$TYPE" && -z "$MESSAGE" ]]; then
+  DESC="${DESCRIPTION:-unknown task}"
+  case "$TYPE" in
+    task-started)  MESSAGE="🔧 Agent spawned for: ${DESC}" ;;
+    pr-ready)      MESSAGE="✅ PR #${PR_NUM:-?} ready for review: ${DESC}" ;;
+    task-failed)   MESSAGE="❌ Task failed: ${DESC} (retry ${RETRY:-?/?})" ;;
+    task-done)     MESSAGE="🎉 Task complete: ${DESC}" ;;
+    *)             log_error "Unknown notification type: $TYPE"; exit 1 ;;
+  esac
+fi
+
+if [[ -z "$MESSAGE" ]]; then
+  log_error "No message to send. Use --message or --type"
+  usage
+  exit 1
+fi
+
+# ── Send ─────────────────────────────────────────────────────────────
+CMD="openclaw message send --channel discord --target ${CHANNEL} --message \"${MESSAGE}\""
+
+if $DRY_RUN; then
+  echo "[dry-run] Would execute:"
+  echo "  $CMD"
+  exit 0
+fi
+
+log_info "Sending notification to $CHANNEL"
+openclaw message send --channel discord --target "$CHANNEL" --message "$MESSAGE" 2>/dev/null || {
+  log_error "Failed to send notification"
+  log_error "Command was: $CMD"
+  exit 1
+}
+log_info "Notification sent"

package/bin/on-complete.sh

@@ -0,0 +1,149 @@
+#!/usr/bin/env bash
+# on-complete.sh — Fire completion hooks when a task finishes
+# Called by watch daemon or manually after task reaches done/failed/timeout
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "${SCRIPT_DIR}/../lib/common.sh"
+
+usage() {
+  cat <<EOF
+Usage: clawforge on-complete <id> [options]
+
+Fire completion hooks for a finished task. Typically called by watch --daemon.
+
+Arguments:
+  <id>              Task ID or short ID
+
+Options:
+  --dry-run         Show what would fire without executing
+  --help            Show this help
+
+Hooks fired:
+  1. OpenClaw event notification (if --notify was set on spawn)
+  2. Webhook POST (if --webhook was set on spawn)
+  3. Auto-clean (if --auto-clean was set on spawn)
+  4. Completion log entry
+EOF
+}
+
+TASK_REF="" DRY_RUN=false
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --dry-run)    DRY_RUN=true; shift ;;
+    --help|-h)    usage; exit 0 ;;
+    --*)          log_error "Unknown option: $1"; usage; exit 1 ;;
+    *)            TASK_REF="$1"; shift ;;
+  esac
+done
+
+[[ -z "$TASK_REF" ]] && { log_error "Task ID required"; usage; exit 1; }
+
+_ensure_registry
+
+# Resolve task
+TASK_DATA=""
+if [[ "$TASK_REF" =~ ^[0-9]+$ ]]; then
+  TASK_DATA=$(jq -r --argjson sid "$TASK_REF" '.tasks[] | select(.short_id == $sid)' "$REGISTRY_FILE" 2>/dev/null || true)
+fi
+if [[ -z "$TASK_DATA" ]]; then
+  TASK_DATA=$(registry_get "$TASK_REF" 2>/dev/null || true)
+fi
+if [[ -z "$TASK_DATA" ]]; then
+  log_error "Task '$TASK_REF' not found"
+  exit 1
+fi
+
+TASK_ID=$(echo "$TASK_DATA" | jq -r '.id')
+STATUS=$(echo "$TASK_DATA" | jq -r '.status')
+DESC=$(echo "$TASK_DATA" | jq -r '.description // "—"')
+MODE=$(echo "$TASK_DATA" | jq -r '.mode // "—"')
+SHORT_ID=$(echo "$TASK_DATA" | jq -r '.short_id // 0')
+WEBHOOK=$(echo "$TASK_DATA" | jq -r '.webhook // empty')
+NOTIFY=$(echo "$TASK_DATA" | jq -r '.notify // false')
+AUTO_CLEAN=$(echo "$TASK_DATA" | jq -r '.auto_clean // false')
+REPO=$(echo "$TASK_DATA" | jq -r '.repo // ""')
+
+# Check task is actually complete
+case "$STATUS" in
+  done|failed|timeout|cancelled) ;;
+  *)
+    log_warn "Task #${SHORT_ID} status is '$STATUS' — not a terminal state. Skipping hooks."
+    exit 0
+    ;;
+esac
+
+# Check if hooks already fired
+HOOKS_FIRED=$(echo "$TASK_DATA" | jq -r '.hooks_fired // false')
+if [[ "$HOOKS_FIRED" == "true" ]]; then
+  log_info "Hooks already fired for #${SHORT_ID}. Skipping."
+  exit 0
+fi
+
+log_info "Firing completion hooks for #${SHORT_ID} ($STATUS)"
+
+# 1. OpenClaw notification
+if [[ "$NOTIFY" == "true" ]]; then
+  EMOJI="✅"
+  [[ "$STATUS" == "failed" ]] && EMOJI="❌"
+  [[ "$STATUS" == "timeout" ]] && EMOJI="⏰"
+  [[ "$STATUS" == "cancelled" ]] && EMOJI="🚫"
+  MSG="${EMOJI} ClawForge: ${MODE} #${SHORT_ID} ${STATUS} — ${DESC}"
+  if $DRY_RUN; then
+    echo "[dry-run] Would send OpenClaw event: $MSG"
+  else
+    openclaw system event --text "$MSG" --mode now 2>/dev/null || log_warn "OpenClaw notify failed"
+    log_info "Sent OpenClaw event"
+  fi
+fi
+
+# 2. Webhook POST
+if [[ -n "$WEBHOOK" ]]; then
+  PAYLOAD=$(jq -cn \
+    --arg taskId "$TASK_ID" \
+    --argjson shortId "$SHORT_ID" \
+    --arg mode "$MODE" \
+    --arg status "$STATUS" \
+    --arg description "$DESC" \
+    --arg repo "$REPO" \
+    '{event:"task_complete", taskId:$taskId, shortId:$shortId, mode:$mode, status:$status, description:$description, repo:$repo}')
+  if $DRY_RUN; then
+    echo "[dry-run] Would POST to $WEBHOOK"
+    echo "  Payload: $PAYLOAD"
+  else
+    curl -s -X POST -H "Content-Type: application/json" -d "$PAYLOAD" "$WEBHOOK" >/dev/null 2>&1 || log_warn "Webhook POST failed"
+    log_info "Sent webhook to $WEBHOOK"
+  fi
+fi
+
+# 3. Auto-clean
+if [[ "$AUTO_CLEAN" == "true" ]]; then
+  if $DRY_RUN; then
+    echo "[dry-run] Would auto-clean task #${SHORT_ID}"
+  else
+    "${SCRIPT_DIR}/clean.sh" --task-id "$TASK_ID" 2>/dev/null || log_warn "Auto-clean failed"
+    log_info "Auto-cleaned task #${SHORT_ID}"
+  fi
+fi
+
+# 4. Mark hooks as fired
+if ! $DRY_RUN; then
+  registry_update "$TASK_ID" "hooks_fired" 'true' 2>/dev/null || true
+fi
+
+# 5. Log completion
+COMPLETION_LOG="${CLAWFORGE_DIR}/registry/completions.jsonl"
+if ! $DRY_RUN; then
+  ENTRY=$(jq -cn \
+    --arg id "$TASK_ID" \
+    --argjson sid "$SHORT_ID" \
+    --arg mode "$MODE" \
+    --arg status "$STATUS" \
+    --arg desc "$DESC" \
+    --argjson ts "$(epoch_ms)" \
+    '{timestamp:$ts, taskId:$id, shortId:$sid, mode:$mode, status:$status, description:$desc}')
+  echo "$ENTRY" >> "$COMPLETION_LOG"
+fi
+
+echo "Hooks fired for #${SHORT_ID} ($STATUS)"