@cyperx/clawforge 1.2.0

package/bin/stop.sh

@@ -0,0 +1,136 @@
+#!/usr/bin/env bash
+# stop.sh — Stop a running agent
+# Usage: clawforge stop <id> [--yes] [--clean]
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "${SCRIPT_DIR}/../lib/common.sh"
+
+# ── Help ───────────────────────────────────────────────────────────────
+usage() {
+  cat <<EOF
+Usage: clawforge stop <id> [flags]
+
+Stop a running agent. Kills the tmux session and marks task as stopped.
+
+Arguments:
+  <id>        Task short ID (#1), full ID, or sub-agent ID (3.2)
+
+Flags:
+  --yes       Skip confirmation prompt
+  --clean     Also remove the worktree
+  --help      Show this help
+
+Examples:
+  clawforge stop 1
+  clawforge stop 3 --yes --clean
+EOF
+}
+
+# ── Parse args ────────────────────────────────────────────────────────
+TASK_REF="" YES=false CLEAN=false
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --yes)    YES=true; shift ;;
+    --clean)  CLEAN=true; shift ;;
+    --help|-h) usage; exit 0 ;;
+    --*)      log_error "Unknown option: $1"; usage; exit 1 ;;
+    *)
+      if [[ -z "$TASK_REF" ]]; then
+        TASK_REF="$1"
+      else
+        log_error "Unexpected argument: $1"
+        usage
+        exit 1
+      fi
+      shift
+      ;;
+  esac
+done
+
+if [[ -z "$TASK_REF" ]]; then
+  log_error "Task ID is required"
+  usage
+  exit 1
+fi
+
+# ── Resolve task ──────────────────────────────────────────────────────
+TASK_ID=$(resolve_task_id "$TASK_REF")
+if [[ -z "$TASK_ID" ]]; then
+  log_error "Could not resolve task: $TASK_REF"
+  exit 1
+fi
+
+TASK=$(registry_get "$TASK_ID")
+if [[ -z "$TASK" ]]; then
+  log_error "Task not found: $TASK_ID"
+  exit 1
+fi
+
+STATUS=$(echo "$TASK" | jq -r '.status')
+TMUX_SESSION=$(echo "$TASK" | jq -r '.tmuxSession')
+WORKTREE=$(echo "$TASK" | jq -r '.worktree')
+DESCRIPTION=$(echo "$TASK" | jq -r '.description' | head -c 50)
+
+# ── Already stopped? ──────────────────────────────────────────────────
+if [[ "$STATUS" == "stopped" || "$STATUS" == "archived" ]]; then
+  echo "Task $TASK_REF is already $STATUS."
+  exit 0
+fi
+
+# ── Confirm ───────────────────────────────────────────────────────────
+if ! $YES; then
+  echo "Stop task $TASK_REF? [$STATUS] \"$DESCRIPTION\""
+  $CLEAN && echo "  (will also remove worktree: $WORKTREE)"
+  echo -n "  Confirm [y/N]: "
+  read -r confirm
+  if [[ ! "$confirm" =~ ^[yY] ]]; then
+    echo "Cancelled."
+    exit 0
+  fi
+fi
+
+# ── Kill tmux session ─────────────────────────────────────────────────
+if [[ -n "$TMUX_SESSION" ]]; then
+  tmux kill-session -t "$TMUX_SESSION" 2>/dev/null || true
+  log_info "Killed tmux session: $TMUX_SESSION"
+fi
+
+# ── Update registry ───────────────────────────────────────────────────
+NOW=$(epoch_ms)
+registry_update "$TASK_ID" "status" '"stopped"'
+registry_update "$TASK_ID" "completedAt" "$NOW"
+
+# ── Clean worktree if requested ───────────────────────────────────────
+if $CLEAN && [[ -n "$WORKTREE" ]] && [[ -d "$WORKTREE" ]]; then
+  REPO=$(echo "$TASK" | jq -r '.repo')
+  git -C "$REPO" worktree remove "$WORKTREE" --force 2>/dev/null || rm -rf "$WORKTREE"
+  log_info "Removed worktree: $WORKTREE"
+fi
+
+# ── Also stop sub-agents if this is a swarm parent ────────────────────
+MODE=$(echo "$TASK" | jq -r '.mode // ""')
+if [[ "$MODE" == "swarm" ]]; then
+  SUB_IDS=$(jq -r --arg pid "$TASK_ID" '.tasks[] | select(.parent_id == $pid) | .id' "$REGISTRY_FILE" 2>/dev/null || true)
+  if [[ -n "$SUB_IDS" ]]; then
+    while IFS= read -r sub_id; do
+      SUB_TMUX=$(registry_get "$sub_id" | jq -r '.tmuxSession')
+      if [[ -n "$SUB_TMUX" ]]; then
+        tmux kill-session -t "$SUB_TMUX" 2>/dev/null || true
+      fi
+      registry_update "$sub_id" "status" '"stopped"'
+      registry_update "$sub_id" "completedAt" "$NOW"
+      if $CLEAN; then
+        SUB_WT=$(registry_get "$sub_id" | jq -r '.worktree')
+        SUB_REPO=$(registry_get "$sub_id" | jq -r '.repo')
+        if [[ -n "$SUB_WT" ]] && [[ -d "$SUB_WT" ]]; then
+          git -C "$SUB_REPO" worktree remove "$SUB_WT" --force 2>/dev/null || rm -rf "$SUB_WT"
+        fi
+      fi
+      log_info "Stopped sub-agent: $sub_id"
+    done <<< "$SUB_IDS"
+  fi
+fi
+
+echo "Stopped: $TASK_REF ($DESCRIPTION)"

package/bin/summary.sh

@@ -0,0 +1,182 @@
+#!/usr/bin/env bash
+# summary.sh — AI-generated summary of what an agent did
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "${SCRIPT_DIR}/../lib/common.sh"
+
+usage() {
+  cat <<EOF
+Usage: clawforge summary <id> [options]
+
+Generate an AI summary of what an agent did based on git diff and logs.
+
+Arguments:
+  <id>                 Task ID or short ID
+
+Options:
+  --model <model>      Model to use for summary (default: from config)
+  --format <fmt>       Output format: text, markdown, json (default: markdown)
+  --include-diff       Include full diff in output (default: summary only)
+  --save <path>        Save summary to file
+  --help               Show this help
+
+Examples:
+  clawforge summary 1
+  clawforge summary 1 --format json
+  clawforge summary sprint-jwt --save /tmp/summary.md
+EOF
+}
+
+TASK_REF="" MODEL="" FORMAT="markdown" INCLUDE_DIFF=false SAVE_PATH=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --model)        MODEL="$2"; shift 2 ;;
+    --format)       FORMAT="$2"; shift 2 ;;
+    --include-diff) INCLUDE_DIFF=true; shift ;;
+    --save)         SAVE_PATH="$2"; shift 2 ;;
+    --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')
+DESC=$(echo "$TASK_DATA" | jq -r '.description // "—"')
+WORKTREE=$(echo "$TASK_DATA" | jq -r '.worktree // empty')
+BRANCH=$(echo "$TASK_DATA" | jq -r '.branch // empty')
+REPO=$(echo "$TASK_DATA" | jq -r '.repo // empty')
+MODE=$(echo "$TASK_DATA" | jq -r '.mode // "sprint"')
+STATUS=$(echo "$TASK_DATA" | jq -r '.status // "unknown"')
+AGENT=$(echo "$TASK_DATA" | jq -r '.agent // "claude"')
+SHORT_ID=$(echo "$TASK_DATA" | jq -r '.short_id // 0')
+TMUX_SESSION=$(echo "$TASK_DATA" | jq -r '.tmuxSession // empty')
+
+# Resolve model
+if [[ -z "$MODEL" ]]; then
+  MODEL=$(config_get default_model_claude "claude-sonnet-4-5")
+fi
+
+# Gather context: git diff
+GIT_DIR=""
+if [[ -n "$WORKTREE" && -d "$WORKTREE" ]]; then
+  GIT_DIR="$WORKTREE"
+elif [[ -n "$REPO" && -d "$REPO" ]]; then
+  GIT_DIR="$REPO"
+fi
+
+DIFF_TEXT=""
+DIFF_STAT=""
+if [[ -n "$GIT_DIR" ]]; then
+  DEFAULT_BRANCH=$(git -C "$GIT_DIR" symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's|refs/remotes/origin/||' || echo "main")
+  DIFF_STAT=$(git -C "$GIT_DIR" diff --stat "${DEFAULT_BRANCH}...HEAD" 2>/dev/null || git -C "$GIT_DIR" diff --stat 2>/dev/null || true)
+  DIFF_TEXT=$(git -C "$GIT_DIR" diff "${DEFAULT_BRANCH}...HEAD" 2>/dev/null | head -300 || git -C "$GIT_DIR" diff 2>/dev/null | head -300 || true)
+fi
+
+# Gather context: recent tmux output
+TMUX_OUTPUT=""
+if [[ -n "$TMUX_SESSION" ]] && tmux has-session -t "$TMUX_SESSION" 2>/dev/null; then
+  TMUX_OUTPUT=$(tmux capture-pane -t "$TMUX_SESSION" -p -S -30 2>/dev/null || true)
+fi
+
+# Build summary prompt
+SUMMARY_PROMPT="Summarize what this coding agent accomplished. Be concise and specific.
+
+Task: ${DESC}
+Mode: ${MODE}
+Status: ${STATUS}
+Agent: ${AGENT}
+Branch: ${BRANCH}
+
+${DIFF_STAT:+Files changed:
+${DIFF_STAT}
+}
+${DIFF_TEXT:+Diff (first 300 lines):
+\`\`\`diff
+${DIFF_TEXT}
+\`\`\`
+}
+${TMUX_OUTPUT:+Recent agent output:
+\`\`\`
+${TMUX_OUTPUT}
+\`\`\`
+}
+
+Provide:
+1. One-line summary (what was done)
+2. Key changes (bullet points)
+3. Status assessment (complete/partial/blocked)
+4. Any notable decisions or trade-offs"
+
+if [[ "$FORMAT" == "json" ]]; then
+  SUMMARY_PROMPT+="
+
+Output as JSON: {\"oneLiner\": \"...\", \"changes\": [\"...\"], \"status\": \"...\", \"notes\": \"...\"}"
+fi
+
+# Generate summary
+if ! command -v claude &>/dev/null; then
+  log_error "claude CLI not found — needed for summary generation"
+  exit 1
+fi
+
+log_info "Generating summary for #${SHORT_ID} with $MODEL..."
+
+SUMMARY=$(claude --model "$MODEL" -p "$SUMMARY_PROMPT" 2>/dev/null || true)
+
+if [[ -z "$SUMMARY" ]]; then
+  log_error "Summary generation failed"
+  exit 1
+fi
+
+# Output
+OUTPUT=""
+if [[ "$FORMAT" == "markdown" ]]; then
+  OUTPUT="# Summary: #${SHORT_ID} — ${DESC}
+**Mode:** ${MODE} | **Status:** ${STATUS} | **Agent:** ${AGENT}
+**Branch:** ${BRANCH}
+
+${SUMMARY}
+
+---
+*Generated by ClawForge summary (${MODEL})*"
+elif [[ "$FORMAT" == "json" ]]; then
+  OUTPUT="$SUMMARY"
+else
+  OUTPUT="Summary #${SHORT_ID}: ${DESC}
+${SUMMARY}"
+fi
+
+if $INCLUDE_DIFF && [[ -n "$DIFF_STAT" ]]; then
+  OUTPUT+="
+
+## Diff Stats
+\`\`\`
+${DIFF_STAT}
+\`\`\`"
+fi
+
+if [[ -n "$SAVE_PATH" ]]; then
+  echo "$OUTPUT" > "$SAVE_PATH"
+  echo "Summary saved to $SAVE_PATH"
+else
+  echo "$OUTPUT"
+fi