@cyperx/clawforge 1.2.0

package/bin/review-mode.sh

@@ -0,0 +1,163 @@
+#!/usr/bin/env bash
+# review-mode.sh — Review mode: quality gate on an existing PR
+# Usage: clawforge review [repo] --pr <num> [flags]
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "${SCRIPT_DIR}/../lib/common.sh"
+
+# ── Help ───────────────────────────────────────────────────────────────
+usage() {
+  cat <<EOF
+Usage: clawforge review [repo] --pr <num> [flags]
+
+Quality gate on an existing PR. No agent spawned — analysis only.
+
+Arguments:
+  [repo]               Path to git repository (default: auto-detect from cwd)
+
+Flags:
+  --pr <num>           PR number to review (required)
+  --fix                Escalate: spawn agent to fix issues found
+  --reviewers <list>   Comma-separated reviewer models (default: claude,gemini)
+  --dry-run            Show review without posting comments
+  --help               Show this help
+
+Examples:
+  clawforge review --pr 42
+  clawforge review ~/github/api --pr 42 --fix
+  clawforge review --pr 42 --reviewers claude,gemini,codex
+EOF
+}
+
+# ── Parse args ────────────────────────────────────────────────────────
+REPO="" PR="" FIX=false REVIEWERS="" DRY_RUN=false
+POSITIONAL=()
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --pr)         PR="$2"; shift 2 ;;
+    --fix)        FIX=true; shift ;;
+    --reviewers)  REVIEWERS="$2"; shift 2 ;;
+    --dry-run)    DRY_RUN=true; shift ;;
+    --help|-h)    usage; exit 0 ;;
+    --*)          log_error "Unknown option: $1"; usage; exit 1 ;;
+    *)            POSITIONAL+=("$1"); shift ;;
+  esac
+done
+
+# Positional: optional repo
+if [[ ${#POSITIONAL[@]} -gt 0 ]]; then
+  REPO="${POSITIONAL[0]}"
+fi
+
+# ── Validate ──────────────────────────────────────────────────────────
+[[ -z "$PR" ]] && { log_error "--pr is required"; usage; exit 1; }
+
+# ── Resolve repo ──────────────────────────────────────────────────────
+if [[ -z "$REPO" ]]; then
+  REPO=$(detect_repo) || { log_error "No --repo and no git repo found from cwd"; exit 1; }
+fi
+REPO_ABS=$(cd "$REPO" && pwd)
+
+# ── Resolve reviewers ────────────────────────────────────────────────
+if [[ -z "$REVIEWERS" ]]; then
+  REVIEWERS=$(config_get reviewers "claude,gemini" | jq -r 'if type == "array" then join(",") else . end' 2>/dev/null || echo "claude,gemini")
+fi
+
+# ── Assign short ID ──────────────────────────────────────────────────
+SHORT_ID=$(_next_short_id)
+
+# ── Register in registry ─────────────────────────────────────────────
+NOW=$(epoch_ms)
+TASK_JSON=$(jq -n \
+  --arg id "review-pr-${PR}" \
+  --argjson sid "$SHORT_ID" \
+  --arg desc "Review PR #${PR}" \
+  --arg repo "$REPO_ABS" \
+  --argjson pr "$PR" \
+  --argjson started "$NOW" \
+  '{
+    id: $id,
+    short_id: $sid,
+    mode: "review",
+    tmuxSession: "",
+    agent: "multi",
+    model: "multi",
+    description: $desc,
+    repo: $repo,
+    worktree: "",
+    branch: "",
+    startedAt: $started,
+    status: "reviewing",
+    retries: 0,
+    maxRetries: 0,
+    pr: $pr,
+    checks: {},
+    completedAt: null,
+    note: null,
+    files_touched: [],
+    ci_retries: 0
+  }')
+registry_add "$TASK_JSON"
+
+log_info "Review mode: PR #$PR in $REPO_ABS"
+log_info "Reviewers: $REVIEWERS"
+log_info "Short ID: #$SHORT_ID"
+
+# ── Run review ────────────────────────────────────────────────────────
+REVIEW_ARGS=(--repo "$REPO_ABS" --pr "$PR" --reviewers "$REVIEWERS")
+$DRY_RUN && REVIEW_ARGS+=(--dry-run)
+
+echo ""
+echo "  #${SHORT_ID}  review  reviewing  $(basename "$REPO_ABS")  \"Review PR #${PR}\""
+echo ""
+
+REVIEW_OUTPUT=$("${SCRIPT_DIR}/review-pr.sh" "${REVIEW_ARGS[@]}" 2>/dev/null || echo "[]")
+
+# Store review results
+registry_update "review-pr-${PR}" "checks" "$REVIEW_OUTPUT" 2>/dev/null || true
+
+# ── Fix mode: spawn agent to fix issues ───────────────────────────────
+if $FIX && ! $DRY_RUN; then
+  log_info "Fix mode: spawning agent to fix issues found in PR #$PR..."
+
+  # Get PR branch HEAD
+  PR_BRANCH=$(gh pr view "$PR" --repo "$REPO_ABS" --json headRefName -q '.headRefName' 2>/dev/null || echo "")
+  if [[ -z "$PR_BRANCH" ]]; then
+    log_error "Could not determine PR branch for --fix"
+    exit 1
+  fi
+
+  # Build fix prompt from review output
+  FIX_PROMPT="Fix the issues found in PR #${PR} code review:
+
+${REVIEW_OUTPUT}
+
+When complete:
+1. Commit your fixes
+2. Push to the same branch: git push origin ${PR_BRANCH}"
+
+  FIX_BRANCH="$PR_BRANCH"
+  RESOLVED_AGENT=$(detect_agent "")
+
+  "${SCRIPT_DIR}/spawn-agent.sh" \
+    --repo "$REPO_ABS" \
+    --branch "$FIX_BRANCH" \
+    --task "$FIX_PROMPT" \
+    --agent "$RESOLVED_AGENT" 2>/dev/null || true
+
+  echo "  Agent spawned to fix issues on branch: $FIX_BRANCH"
+  echo "  Attach: clawforge attach $SHORT_ID"
+fi
+
+# ── Mark complete ─────────────────────────────────────────────────────
+if ! $FIX; then
+  NOW=$(epoch_ms)
+  registry_update "review-pr-${PR}" "status" '"done"'
+  registry_update "review-pr-${PR}" "completedAt" "$NOW"
+fi
+
+echo ""
+echo "  Review complete. Results stored in registry."
+echo "$REVIEW_OUTPUT"

package/bin/review-pr.sh

@@ -0,0 +1,145 @@
+#!/usr/bin/env bash
+# review-pr.sh — Module 5: Multi-model code review
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "${SCRIPT_DIR}/../lib/common.sh"
+
+# ── Help ───────────────────────────────────────────────────────────────
+usage() {
+  cat <<EOF
+Usage: review-pr.sh --repo <path> --pr <number> [options]
+
+Options:
+  --repo <path>           Path to the git repository (required)
+  --pr <number>           PR number to review (required)
+  --reviewers <list>      Comma-separated reviewer models (default: claude)
+  --dry-run               Show what would happen without executing
+  --help                  Show this help
+EOF
+}
+
+REPO="" PR_NUMBER="" REVIEWERS="" DRY_RUN=false
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --repo)       REPO="$2"; shift 2 ;;
+    --pr)         PR_NUMBER="$2"; shift 2 ;;
+    --reviewers)  REVIEWERS="$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)
+
+# Default reviewers from config
+if [[ -z "$REVIEWERS" ]]; then
+  REVIEWERS=$(config_get reviewers "claude" | jq -r 'if type == "array" then join(",") else . end' 2>/dev/null || echo "claude")
+fi
+
+REVIEW_PROMPT=$(config_get review_prompt "Review this pull request for:
+1. Bugs and logic errors
+2. Edge cases and error handling
+3. Security issues
+4. Performance concerns
+5. Code quality and conventions
+
+Respond with: APPROVE, REQUEST_CHANGES, or COMMENT. Then list findings.")
+
+log_info "Reviewing PR #${PR_NUMBER} in ${REPO_ABS}"
+log_info "Reviewers: ${REVIEWERS}"
+
+# ── Get PR diff ───────────────────────────────────────────────────────
+if $DRY_RUN; then
+  log_info "[dry-run] Would fetch diff for PR #${PR_NUMBER}"
+  DIFF="[dry-run: diff would be fetched here]"
+else
+  DIFF=$(gh pr diff "$PR_NUMBER" --repo "$REPO_ABS" 2>/dev/null || true)
+  if [[ -z "$DIFF" ]]; then
+    log_error "Could not get diff for PR #${PR_NUMBER}"
+    exit 1
+  fi
+fi
+
+# ── Get PR info ───────────────────────────────────────────────────────
+PR_TITLE=""
+PR_BODY=""
+if ! $DRY_RUN; then
+  PR_INFO=$(gh pr view "$PR_NUMBER" --repo "$REPO_ABS" --json title,body 2>/dev/null || echo '{}')
+  PR_TITLE=$(echo "$PR_INFO" | jq -r '.title // ""')
+  PR_BODY=$(echo "$PR_INFO" | jq -r '.body // ""')
+fi
+
+# ── Review with each model ────────────────────────────────────────────
+IFS=',' read -ra REVIEWER_LIST <<< "$REVIEWERS"
+REVIEWS="[]"
+
+for reviewer in "${REVIEWER_LIST[@]}"; do
+  reviewer=$(echo "$reviewer" | xargs)  # trim whitespace
+  log_info "Getting review from: $reviewer"
+
+  FULL_REVIEW_PROMPT="${REVIEW_PROMPT}
+
+PR Title: ${PR_TITLE}
+PR Description: ${PR_BODY}
+
+Diff:
+${DIFF}"
+
+  if $DRY_RUN; then
+    log_info "[dry-run] Would send diff to $reviewer for review"
+    log_info "[dry-run] Prompt starts with: $(echo "$REVIEW_PROMPT" | head -3)"
+    REVIEW_RESULT="[dry-run] Review from $reviewer would appear here"
+  else
+    # Use claude for all reviews (with model flag for different models)
+    case "$reviewer" in
+      claude)
+        REVIEW_RESULT=$(claude --model claude-sonnet-4-5 --dangerously-skip-permissions -p "$FULL_REVIEW_PROMPT" 2>/dev/null || echo "Review failed for $reviewer")
+        ;;
+      codex)
+        REVIEW_RESULT=$(codex --model gpt-5.3-codex -q "$FULL_REVIEW_PROMPT" 2>/dev/null || echo "Review failed for $reviewer")
+        ;;
+      gemini)
+        REVIEW_RESULT=$(claude --model gemini-2.5-pro -p "$FULL_REVIEW_PROMPT" 2>/dev/null || echo "Review failed for $reviewer")
+        ;;
+      *)
+        REVIEW_RESULT=$(claude --model "$reviewer" --dangerously-skip-permissions -p "$FULL_REVIEW_PROMPT" 2>/dev/null || echo "Review failed for $reviewer")
+        ;;
+    esac
+  fi
+
+  # Store review
+  review_entry=$(jq -n --arg r "$reviewer" --arg body "$REVIEW_RESULT" '{reviewer: $r, review: $body}')
+  REVIEWS=$(echo "$REVIEWS" | jq --argjson entry "$review_entry" '. += [$entry]')
+
+  # Post review comment
+  if ! $DRY_RUN; then
+    COMMENT_BODY="## 🤖 Review by \`${reviewer}\`
+
+${REVIEW_RESULT}"
+    gh pr review "$PR_NUMBER" --repo "$REPO_ABS" --comment --body "$COMMENT_BODY" 2>/dev/null || \
+      log_warn "Failed to post review comment for $reviewer"
+    log_info "Posted review from $reviewer"
+  fi
+done
+
+# ── Update registry ───────────────────────────────────────────────────
+# Find task by PR number and update
+if ! $DRY_RUN; then
+  _ensure_registry
+  TASK_ID=$(jq -r --argjson pr "$PR_NUMBER" '.tasks[] | select(.pr == $pr) | .id' "$REGISTRY_FILE" 2>/dev/null || true)
+  if [[ -n "$TASK_ID" ]]; then
+    CHECKS_JSON=$(echo "$REVIEWS" | jq 'reduce .[] as $r ({}; .[$r.reviewer] = ($r.review | split("\n")[0]))')
+    registry_update "$TASK_ID" "checks" "$CHECKS_JSON"
+    registry_update "$TASK_ID" "status" '"reviewing"'
+    log_info "Updated registry for task $TASK_ID"
+  fi
+fi
+
+# ── Output ─────────────────────────────────────────────────────────────
+echo "$REVIEWS" | jq '.'

package/bin/routing.sh

@@ -0,0 +1,88 @@
+#!/usr/bin/env bash
+# routing.sh — Model routing: pick the right model for each phase
+# Usage: source bin/routing.sh; load_routing "auto"; get_model_for_phase "scope"
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "${SCRIPT_DIR}/../lib/common.sh"
+
+# ── Routing config ────────────────────────────────────────────────────
+ROUTING_DEFAULTS="${CLAWFORGE_DIR}/config/routing-defaults.json"
+ROUTING_USER="${HOME}/.clawforge/routing.json"
+
+# Internal state — set by load_routing
+_ROUTING_STRATEGY=""
+_ROUTING_CONFIG=""
+
+# ── Model aliases ─────────────────────────────────────────────────────
+_resolve_model_alias() {
+  local alias="$1"
+  case "$alias" in
+    haiku)   echo "claude-haiku-4-5" ;;
+    sonnet)  echo "claude-sonnet-4-5" ;;
+    opus)    echo "claude-opus-4-6" ;;
+    *)       echo "$alias" ;;  # pass through full model IDs
+  esac
+}
+
+# ── load_routing(strategy) ────────────────────────────────────────────
+# strategy: auto | cheap | quality | "" (disabled)
+load_routing() {
+  local strategy="${1:-}"
+  _ROUTING_STRATEGY="$strategy"
+
+  case "$strategy" in
+    auto)
+      # User config > defaults
+      if [[ -f "$ROUTING_USER" ]]; then
+        _ROUTING_CONFIG=$(cat "$ROUTING_USER")
+        log_debug "Routing: loaded user config from $ROUTING_USER"
+      elif [[ -f "$ROUTING_DEFAULTS" ]]; then
+        _ROUTING_CONFIG=$(cat "$ROUTING_DEFAULTS")
+        log_debug "Routing: loaded defaults from $ROUTING_DEFAULTS"
+      else
+        log_warn "Routing: no config found, falling back to agent defaults"
+        _ROUTING_STRATEGY=""
+      fi
+      ;;
+    cheap)
+      _ROUTING_CONFIG='{"scope":"haiku","implement":"haiku","review":"haiku","ci-fix":"haiku"}'
+      log_debug "Routing: cheap mode — haiku for all phases"
+      ;;
+    quality)
+      _ROUTING_CONFIG='{"scope":"opus","implement":"opus","review":"opus","ci-fix":"opus"}'
+      log_debug "Routing: quality mode — opus for all phases"
+      ;;
+    "")
+      _ROUTING_CONFIG=""
+      ;;
+    *)
+      log_error "Unknown routing strategy: $strategy (expected: auto, cheap, quality)"
+      return 1
+      ;;
+  esac
+}
+
+# ── get_model_for_phase(phase) ────────────────────────────────────────
+# phase: scope | implement | review | ci-fix
+# Returns: full model ID string, or empty if no routing active
+get_model_for_phase() {
+  local phase="$1"
+
+  # No routing loaded — return empty (caller uses its own default)
+  if [[ -z "$_ROUTING_STRATEGY" || -z "$_ROUTING_CONFIG" ]]; then
+    echo ""
+    return
+  fi
+
+  local alias
+  alias=$(echo "$_ROUTING_CONFIG" | jq -r --arg p "$phase" '.[$p] // empty' 2>/dev/null)
+
+  if [[ -z "$alias" ]]; then
+    log_debug "Routing: no mapping for phase '$phase', using default"
+    echo ""
+    return
+  fi
+
+  _resolve_model_alias "$alias"
+}

package/bin/scope-task.sh

@@ -0,0 +1,169 @@
+#!/usr/bin/env bash
+# scope-task.sh — Module 1: Assemble a comprehensive prompt from task + context
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "${SCRIPT_DIR}/../lib/common.sh"
+
+# ── Help ───────────────────────────────────────────────────────────────
+usage() {
+  cat <<EOF
+Usage: scope-task.sh --task <description> [options]
+
+Options:
+  --task <description>   Task description (required)
+  --vault-query <search> Search Obsidian vault for relevant context
+  --prd <path>           Path to PRD or spec file
+  --context <file>       Additional context file (repeatable)
+  --template <name>      Prompt template name (default: default)
+  --output prompt|json   Output format (default: prompt)
+  --dry-run              Show what would be included without assembling
+  --help                 Show this help
+EOF
+}
+
+# ── Parse args ─────────────────────────────────────────────────────────
+TASK="" VAULT_QUERY="" PRD="" OUTPUT="prompt" TEMPLATE="default" DRY_RUN=false
+CONTEXT_FILES=()
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --task)        TASK="$2"; shift 2 ;;
+    --vault-query) VAULT_QUERY="$2"; shift 2 ;;
+    --prd)         PRD="$2"; shift 2 ;;
+    --context)     CONTEXT_FILES+=("$2"); shift 2 ;;
+    --template)    TEMPLATE="$2"; shift 2 ;;
+    --output)      OUTPUT="$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 "$TASK" ]] && { log_error "--task is required"; usage; exit 1; }
+
+# ── Resolve paths ─────────────────────────────────────────────────────
+VAULT_PATH=$(config_get vault_path "/Users/cyperx/Library/Mobile Documents/iCloud~md~obsidian/Documents/cyperx")
+VAULT_MAX_LINES=$(config_get vault_max_lines 2000)
+TEMPLATE_DIR="${CLAWFORGE_DIR}/config/prompt-templates"
+TEMPLATE_FILE="${TEMPLATE_DIR}/${TEMPLATE}.md"
+
+if [[ ! -f "$TEMPLATE_FILE" ]]; then
+  log_warn "Template '${TEMPLATE}' not found, using inline default"
+  TEMPLATE_FILE=""
+fi
+
+# ── Vault search ──────────────────────────────────────────────────────
+VAULT_CONTEXT=""
+if [[ -n "$VAULT_QUERY" ]]; then
+  log_info "Searching vault for: $VAULT_QUERY"
+  if [[ -d "$VAULT_PATH" ]] && command -v rg &>/dev/null; then
+    VAULT_RESULTS=$(rg -l --type md -i "$VAULT_QUERY" "$VAULT_PATH" 2>/dev/null | head -10 || true)
+    if [[ -n "$VAULT_RESULTS" ]]; then
+      VAULT_CONTEXT="## Vault Context (matching: ${VAULT_QUERY})"$'\n\n'
+      while IFS= read -r file; do
+        fname=$(basename "$file")
+        VAULT_CONTEXT+="### ${fname}"$'\n'
+        VAULT_CONTEXT+=$(head -100 "$file")$'\n\n'
+      done <<< "$VAULT_RESULTS"
+      # Truncate
+      line_count=$(echo "$VAULT_CONTEXT" | wc -l)
+      if [[ "$line_count" -gt "$VAULT_MAX_LINES" ]]; then
+        VAULT_CONTEXT=$(echo "$VAULT_CONTEXT" | head -"$VAULT_MAX_LINES")
+        VAULT_CONTEXT+=$'\n[...truncated to '"$VAULT_MAX_LINES"' lines]'
+        log_info "Vault context truncated to $VAULT_MAX_LINES lines"
+      fi
+      log_info "Found $(echo "$VAULT_RESULTS" | wc -l | tr -d ' ') matching files"
+    else
+      log_info "No vault matches for: $VAULT_QUERY"
+    fi
+  elif [[ ! -d "$VAULT_PATH" ]]; then
+    log_warn "Vault path not found: $VAULT_PATH"
+  elif ! command -v rg &>/dev/null; then
+    log_warn "ripgrep (rg) not found, skipping vault search"
+  fi
+fi
+
+# ── PRD content ───────────────────────────────────────────────────────
+PRD_CONTENT=""
+if [[ -n "$PRD" ]]; then
+  if [[ -f "$PRD" ]]; then
+    PRD_CONTENT="## PRD / Specification"$'\n\n'
+    PRD_CONTENT+=$(cat "$PRD")
+    log_info "Included PRD: $PRD"
+  else
+    log_error "PRD file not found: $PRD"
+    exit 1
+  fi
+fi
+
+# ── Extra context ─────────────────────────────────────────────────────
+EXTRA_CONTEXT=""
+if [[ ${#CONTEXT_FILES[@]} -gt 0 ]]; then
+  EXTRA_CONTEXT="## Additional Context"$'\n\n'
+  for ctx_file in "${CONTEXT_FILES[@]}"; do
+    if [[ -f "$ctx_file" ]]; then
+      fname=$(basename "$ctx_file")
+      EXTRA_CONTEXT+="### ${fname}"$'\n'
+      EXTRA_CONTEXT+=$(cat "$ctx_file")$'\n\n'
+      log_info "Included context: $ctx_file"
+    else
+      log_warn "Context file not found: $ctx_file"
+    fi
+  done
+fi
+
+# ── Dry run ───────────────────────────────────────────────────────────
+if $DRY_RUN; then
+  echo "=== Scope Dry Run ==="
+  echo "Task: $TASK"
+  echo "Template: ${TEMPLATE_FILE:-inline}"
+  echo "Vault query: ${VAULT_QUERY:-none}"
+  echo "Vault matches: $(echo "$VAULT_CONTEXT" | grep -c '^### ' 2>/dev/null || echo 0)"
+  echo "PRD: ${PRD:-none}"
+  echo "Context files: ${#CONTEXT_FILES[@]}"
+  [[ -n "$VAULT_CONTEXT" ]] && echo "Vault context lines: $(echo "$VAULT_CONTEXT" | wc -l | tr -d ' ')"
+  [[ -n "$PRD_CONTENT" ]] && echo "PRD lines: $(echo "$PRD_CONTENT" | wc -l | tr -d ' ')"
+  exit 0
+fi
+
+# ── Assemble prompt ──────────────────────────────────────────────────
+if [[ -n "$TEMPLATE_FILE" ]]; then
+  PROMPT=$(cat "$TEMPLATE_FILE")
+  PROMPT="${PROMPT//\{\{TASK_DESCRIPTION\}\}/$TASK}"
+  PROMPT="${PROMPT//\{\{VAULT_CONTEXT\}\}/$VAULT_CONTEXT}"
+  PROMPT="${PROMPT//\{\{PRD_CONTENT\}\}/$PRD_CONTENT}"
+  PROMPT="${PROMPT//\{\{EXTRA_CONTEXT\}\}/$EXTRA_CONTEXT}"
+else
+  PROMPT="# Task"$'\n\n'"$TASK"$'\n\n'
+  [[ -n "$VAULT_CONTEXT" ]] && PROMPT+="$VAULT_CONTEXT"$'\n\n'
+  [[ -n "$PRD_CONTENT" ]]   && PROMPT+="$PRD_CONTENT"$'\n\n'
+  [[ -n "$EXTRA_CONTEXT" ]] && PROMPT+="$EXTRA_CONTEXT"$'\n\n'
+  PROMPT+="# Instructions"$'\n\n'
+  PROMPT+="- Follow existing code conventions and style"$'\n'
+  PROMPT+="- Create small, atomic commits with imperative messages"$'\n'
+  PROMPT+="- When complete, push the branch and create a PR against main"
+fi
+
+# ── Output ────────────────────────────────────────────────────────────
+if [[ "$OUTPUT" == "json" ]]; then
+  jq -n \
+    --arg task "$TASK" \
+    --arg vault_query "${VAULT_QUERY:-}" \
+    --arg prd "${PRD:-}" \
+    --arg template "$TEMPLATE" \
+    --arg prompt "$PROMPT" \
+    --argjson context_count "${#CONTEXT_FILES[@]}" \
+    --argjson timestamp "$(epoch_ms)" \
+    '{
+      timestamp: $timestamp,
+      task: $task,
+      vaultQuery: (if $vault_query == "" then null else $vault_query end),
+      prd: (if $prd == "" then null else $prd end),
+      template: $template,
+      contextFiles: $context_count,
+      prompt: $prompt
+    }'
+else
+  echo "$PROMPT"
+fi