#!/usr/bin/env bash
# review-checklist: render a reviewer checklist for an auto-tmux report pack.
set -euo pipefail

usage() {
  cat <<'EOF'
review-checklist: render a reviewer checklist for an auto-tmux report pack

Usage:
  review-checklist.sh --pack DIR [--out FILE] [--strict]

Defaults:
  --out stdout

This script is read-only for the report pack. It writes only when --out is set.
Use --strict to fail when required files are missing.
EOF
}

die() {
  printf 'error: %s\n' "$*" >&2
  exit 1
}

pack_dir=""
out_file=""
strict="0"
missing_count=0
required_files=(index.md manifest.json board.md deps.md timeline.md blockers.md results.md results.jsonl assign.md export/manifest.json)

while [[ $# -gt 0 ]]; do
  case "$1" in
    --pack)
      pack_dir="${2:-}"
      shift 2
      ;;
    --out)
      out_file="${2:-}"
      shift 2
      ;;
    --strict)
      strict="1"
      shift
      ;;
    -h|--help)
      usage
      exit 0
      ;;
    *)
      die "unknown option: $1"
      ;;
  esac
done

[[ -n "$pack_dir" ]] || die "missing --pack"
[[ -d "$pack_dir" ]] || die "pack dir not found: $pack_dir"

exists_mark() {
  local path="$1"
  if [[ -e "$pack_dir/$path" ]]; then
    printf 'x'
  else
    printf ' '
  fi
}

count_missing() {
  local file
  missing_count=0
  for file in "${required_files[@]}"; do
    [[ -e "$pack_dir/$file" ]] || missing_count=$((missing_count + 1))
  done
}

render_checklist() {
  printf '# auto-tmux Report Review Checklist\n\n'
  printf -- '- pack_dir: `%s`\n' "$pack_dir"
  printf -- '- created_at: `%s`\n\n' "$(date -Is)"

  printf '## Required Files\n\n'
  local file
  for file in "${required_files[@]}"; do
    printf -- '- [%s] `%s`\n' "$(exists_mark "$file")" "$file"
  done

  printf '\n## Strict Summary\n\n'
  printf -- '- missing_required_files: `%s`\n' "$missing_count"

  printf '\n## Review Gates\n\n'
  printf -- '- [ ] `manifest.json` type is `auto-tmux-swarm-report-pack`.\n'
  printf -- '- [ ] `results.md` clearly lists DONE/FAIL/BLOCKED worker outcomes.\n'
  printf -- '- [ ] `blockers.md` has no unresolved blocker that prevents handoff.\n'
  printf -- '- [ ] `assign.md` does not imply an unclaimed task was silently executed.\n'
  printf -- '- [ ] Attachments, if present, are explicit evidence directories and do not contain secrets.\n'
  printf -- '- [ ] Reviewer can reproduce the key conclusion from files in this pack only.\n'

  printf '\n## Suggested Commands\n\n'
  printf '```bash\n'
  printf 'skills/auto-tmux/scripts/check-jsonl.sh %q --require-key type --require-key id --require-key status\n' "$pack_dir/results.jsonl"
  printf 'grep -F "\"type\": \"auto-tmux-swarm-report-pack\"" %q\n' "$pack_dir/manifest.json"
  printf '```\n'
}

count_missing

if [[ -n "$out_file" ]]; then
  mkdir -p "$(dirname "$out_file")"
  render_checklist > "$out_file"
  printf 'review checklist written: %s\n' "$out_file"
else
  render_checklist
fi

if [[ "$strict" == "1" && "$missing_count" -gt 0 ]]; then
  die "strict review failed: missing required files=$missing_count"
fi