#!/usr/bin/env bash
# run-phase.sh — run every remaining task of one phase to completion.
#
# Each task runs in its own pi process (fresh context) with the
# .agents/validate.sh gate after every task; the phase ends with its
# 00_phase.md final pass.
#
# Usage:
#   run-phase.sh              # next phase with pending work, to completion
#   run-phase.sh 03_api       # a specific phase (warns if out of order)
#   run-phase.sh 03_api.md    # a legacy single-file phase
#
# Env: see SKILL.md (MAX_FIX_ATTEMPTS, PHASE_MODEL, PHASE_THINKING,
#      PHASE_COMMIT, PI_TRUST, FRESH_FIX).
set -uo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
source "$SCRIPT_DIR/lib.sh"

# Make interruptions visible: state stays in .agents/phases/todo, and the
# failed executor's session is still resumable on the next run.
trap 'echo; echo "✗ ERROR: interrupted (SIGINT) — ${phase:-this phase} is left in $PHASE_TODO/; re-run to continue" >&2; exit 130' INT
trap 'echo; echo "✗ ERROR: interrupted (SIGTERM) — ${phase:-this phase} is left in $PHASE_TODO/; re-run to continue" >&2; exit 143' TERM

cd "$(find_root)" || die "no .agents/phases/todo found in this or parent directories (run /to-phase or /audit-create first)"

phase="${1:-}"
if [[ -n "$phase" ]]; then
  phase="${phase%/}"; phase="${phase%.md}"; phase="${phase%%/*}"
  [[ -d "$PHASE_TODO/$phase" || -f "$PHASE_TODO/$phase.md" ]] || die "$phase not found in $PHASE_TODO/"
  first="$(next_unit)"
  if [[ -n "$first" && "${first%%/*}" != "$phase" ]]; then
    warn "dependency order: $first is pending before $phase — running out of order"
  fi
else
  unit="$(next_unit)"
  [[ -n "$unit" ]] || { echo "✓ no pending tasks in $PHASE_TODO/ — project complete."; exit 0; }
  phase="$(unit_phase "$unit")"
fi

build_pi_args
failed=0
while unit="$(phase_next_unit "$phase")"; do
  [[ -n "$unit" ]] || break
  execute_unit "$unit" || { failed=1; break; }
done
if (( failed )); then
  echo "✗ ERROR: phase $phase FAILED — see error above" >&2
  echo "  reports: $(unit_report_dir "$unit")/$(unit_base "$unit").a*.{md,err,validate}" >&2
  echo "  resume:  re-run this script — the failed executor session is resumed automatically" >&2
  exit 1
fi
echo "✓ phase $phase complete"
exit 0