#!/usr/bin/env bash
# check-release-pr-scope.test.sh — Tests for release PR metadata drift checks.

set -euo pipefail

SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
HELPER="$SCRIPT_DIR/check-release-pr-scope.sh"

PASS=0
FAIL=0
WORK=$(mktemp -d)
trap 'rm -rf "$WORK"' EXIT

assert_exit() {
  local name="$1" expected="$2" actual="$3"
  if [ "$expected" = "$actual" ]; then
    echo "  ✓ $name"
    PASS=$((PASS + 1))
  else
    echo "  ✗ $name"
    echo "    Expected exit: $expected"
    echo "    Actual exit:   $actual"
    FAIL=$((FAIL + 1))
  fi
}

assert_grep() {
  local name="$1" pattern="$2" file="$3"
  if grep -Eq "$pattern" "$file"; then
    echo "  ✓ $name"
    PASS=$((PASS + 1))
  else
    echo "  ✗ $name"
    echo "    Missing pattern: $pattern"
    FAIL=$((FAIL + 1))
  fi
}

make_fixture() {
  local dir="$1" subject="$2"
  rm -rf "$dir"
  mkdir -p "$dir/scripts" "$dir/compliance/pending-releases" "$dir/compliance/standalone-housekeeping"
  cp "$SCRIPT_DIR/derive-release-version.sh" "$dir/scripts/derive-release-version.sh"
  cp "$SCRIPT_DIR/extract-release-metadata.sh" "$dir/scripts/extract-release-metadata.sh"
  cp "$SCRIPT_DIR/standalone-housekeeping-release.sh" "$dir/scripts/standalone-housekeeping-release.sh"
  cp "$HELPER" "$dir/scripts/check-release-pr-scope.sh"
  chmod +x "$dir/scripts/"*.sh
  (
    cd "$dir"
    git init -q
    git config user.email test@example.com
    git config user.name tester
    git commit --allow-empty -q -m "$subject"
  )
}

run_check() {
  local dir="$1" out="$2"
  shift 2
  (
    cd "$dir"
    "$@" bash scripts/check-release-pr-scope.sh
  ) >"$out" 2>&1
}

echo "=== check-release-pr-scope.sh tests ==="
echo ""

echo "--- Test 1: matching REQ scope passes ---"
make_fixture "$WORK/test1" "[REQ-093] feat: ship release"
cat > "$WORK/test1/compliance/pending-releases/RELEASE-TICKET-REQ-093.md" <<'EOF'
# Release Ticket — REQ-093

**Requirement:** REQ-093 — Example release

## Summary
Normal tracked release.
EOF
OUT="$WORK/test1.out"
if run_check "$WORK/test1" "$OUT" env PR_TITLE="Release: REQ-093" PR_BODY=$'## Release\n- Release: REQ-093\n'; then
  CODE=0
else
  CODE=$?
fi
assert_exit "matching REQ scope passes" 0 "$CODE"
assert_grep "success message emitted" 'Release Scope Integrity verified for REQ-093' "$OUT"
echo ""

echo "--- Test 2: stale REQ scope fails ---"
make_fixture "$WORK/test2" "[REQ-093] feat: ship release"
OUT="$WORK/test2.out"
if run_check "$WORK/test2" "$OUT" env PR_TITLE="Release: REQ-092" PR_BODY=$'## Release\n- Release: REQ-092\n'; then
  CODE=0
else
  CODE=$?
fi
assert_exit "stale REQ scope fails" 1 "$CODE"
assert_grep "declared scope printed" 'Declared PR scope: REQ-092' "$OUT"
assert_grep "derived scope printed" 'Derived effective scope: REQ-093' "$OUT"
echo ""

echo "--- Test 3: bundled release must mention bundled marker ---"
make_fixture "$WORK/test3" "[REQ-093] feat: bundled release"
cat > "$WORK/test3/compliance/pending-releases/RELEASE-TICKET-REQ-093.md" <<'EOF'
# Release Ticket — REQ-093

**Requirement:** REQ-093 — Example release

## Summary
Tracked release summary.
EOF
cat > "$WORK/test3/compliance/pending-releases/BUNDLED-CHANGES-REQ-093.md" <<'EOF'
# Bundled Changes — REQ-093
EOF
OUT="$WORK/test3.out"
if run_check "$WORK/test3" "$OUT" env PR_TITLE="Release: REQ-093" PR_BODY=$'## Release\n- Release: REQ-093\n'; then
  CODE=0
else
  CODE=$?
fi
assert_exit "missing bundled marker fails" 1 "$CODE"
assert_grep "bundled mismatch printed" 'bundled release context marker' "$OUT"
echo ""

echo "--- Test 4: hotfix branches skip scope integrity ---"
make_fixture "$WORK/test4" "[REQ-093] feat: ship release"
OUT="$WORK/test4.out"
if run_check "$WORK/test4" "$OUT" env HEAD_REF="hotfix/urgent-fix" PR_TITLE="fix: urgent prod bug" PR_BODY="HOTFIX"; then
  CODE=0
else
  CODE=$?
fi
assert_exit "hotfix branch skips" 0 "$CODE"
assert_grep "hotfix skip message" 'Hotfix PR detected' "$OUT"
echo ""

echo "--- Test 5: develop-to-main promotion may use exactly one pending ticket ---"
make_fixture "$WORK/test5" "chore: integration head without commit tag"
cat > "$WORK/test5/compliance/pending-releases/RELEASE-TICKET-REQ-094.md" <<'EOF'
# Release Ticket — REQ-094
EOF
OUT="$WORK/test5.out"
if run_check "$WORK/test5" "$OUT" env HEAD_REF="develop" BASE_REF="main" PR_TITLE="Release: REQ-094" PR_BODY=$'## Release\n- Release: REQ-094\n'; then
  CODE=0
else
  CODE=$?
fi
assert_exit "develop-to-main single pending ticket passes" 0 "$CODE"
assert_grep "pending ticket promotion resolves REQ" 'Release Scope Integrity verified for REQ-094' "$OUT"
echo ""

echo "--- Test 6: non-promotion context cannot use pending ticket fallback ---"
make_fixture "$WORK/test6" "chore: integration head without commit tag"
cat > "$WORK/test6/compliance/pending-releases/RELEASE-TICKET-REQ-094.md" <<'EOF'
# Release Ticket — REQ-094
EOF
OUT="$WORK/test6.out"
if run_check "$WORK/test6" "$OUT" env HEAD_REF="feature/demo" BASE_REF="develop" PR_TITLE="Release: REQ-094" PR_BODY=$'## Release\n- Release: REQ-094\n'; then
  CODE=0
else
  CODE=$?
fi
assert_exit "non-promotion single pending ticket fails" 1 "$CODE"
assert_grep "non-promotion derives bare date" 'Derived effective scope: v[0-9]{4}\.[0-9]{2}\.[0-9]{2}' "$OUT"
echo ""

echo "--- Test 7: develop-to-main with ambiguous pending tickets fails closed ---"
make_fixture "$WORK/test7" "chore: integration head without commit tag"
cat > "$WORK/test7/compliance/pending-releases/RELEASE-TICKET-REQ-094.md" <<'EOF'
# Release Ticket — REQ-094
EOF
cat > "$WORK/test7/compliance/pending-releases/RELEASE-TICKET-REQ-095.md" <<'EOF'
# Release Ticket — REQ-095
EOF
OUT="$WORK/test7.out"
if run_check "$WORK/test7" "$OUT" env HEAD_REF="develop" BASE_REF="main" PR_TITLE="Release: REQ-094" PR_BODY=$'## Release\n- Release: REQ-094\n'; then
  CODE=0
else
  CODE=$?
fi
assert_exit "ambiguous pending tickets fail" 1 "$CODE"
assert_grep "ambiguous promotion falls back to bare date" 'Derived effective scope: v[0-9]{4}\.[0-9]{2}\.[0-9]{2}' "$OUT"
echo ""

echo "--- Test 8: bare-date releases require an explicit standalone declaration ---"
make_fixture "$WORK/test8" "chore: standalone housekeeping release"
BARE_DATE_VERSION="v$(date -u +%Y.%m.%d)"
cat > "$WORK/test8/compliance/standalone-housekeeping/STANDALONE-HOUSEKEEPING-${BARE_DATE_VERSION}.json" <<EOF
{
  "schemaVersion": 1,
  "version": "${BARE_DATE_VERSION}",
  "releaseMode": "standalone_housekeeping",
  "reason": "Urgent operational change cannot wait for the next tracked requirement release."
}
EOF
OUT="$WORK/test8.out"
if run_check "$WORK/test8" "$OUT" env PR_TITLE="Standalone housekeeping promotion: ${BARE_DATE_VERSION}" PR_BODY=$"## Release\n- Release: ${BARE_DATE_VERSION}\n"; then
  CODE=0
else
  CODE=$?
fi
assert_exit "declared standalone housekeeping release passes" 0 "$CODE"
assert_grep "standalone validation is emitted" 'Standalone housekeeping declaration is valid' "$OUT"
echo ""

echo "--- Test 9: bare-date releases without the exception marker fail ---"
make_fixture "$WORK/test9" "chore: standalone housekeeping release"
cat > "$WORK/test9/compliance/standalone-housekeeping/STANDALONE-HOUSEKEEPING-${BARE_DATE_VERSION}.json" <<EOF
{
  "schemaVersion": 1,
  "version": "${BARE_DATE_VERSION}",
  "releaseMode": "standalone_housekeeping",
  "reason": "Urgent operational change cannot wait for the next tracked requirement release."
}
EOF
OUT="$WORK/test9.out"
if run_check "$WORK/test9" "$OUT" env PR_TITLE="Release: ${BARE_DATE_VERSION}" PR_BODY=$"## Release\n- Release: ${BARE_DATE_VERSION}\n"; then
  CODE=0
else
  CODE=$?
fi
assert_exit "bare-date release without exception marker fails" 1 "$CODE"
assert_grep "exception marker failure is clear" 'explicit standalone housekeeping exception' "$OUT"
echo ""

echo "--- Test 10: Markdown standalone scope wins over historical REQ prose ---"
make_fixture "$WORK/test10" "chore: standalone housekeeping release"
cat > "$WORK/test10/compliance/standalone-housekeeping/STANDALONE-HOUSEKEEPING-${BARE_DATE_VERSION}.json" <<EOF
{
  "schemaVersion": 1,
  "version": "${BARE_DATE_VERSION}",
  "releaseMode": "standalone_housekeeping",
  "reason": "Reviewed operational change cannot wait for the next tracked requirement release."
}
EOF
OUT="$WORK/test10.out"
if run_check "$WORK/test10" "$OUT" env PR_TITLE="Standalone housekeeping promotion: ${BARE_DATE_VERSION}" PR_BODY=$"## Scope\n- Release: \`${BARE_DATE_VERSION}\`\n- Historical context: REQ-094 close-out recovery.\n"; then
  CODE=0
else
  CODE=$?
fi
assert_exit "Markdown standalone scope wins over historical REQ prose" 0 "$CODE"
assert_grep "Markdown standalone scope is verified" "Release Scope Integrity verified for ${BARE_DATE_VERSION}" "$OUT"
echo ""

echo "--- Test 11: Markdown tracked scope passes ---"
make_fixture "$WORK/test11" "[REQ-093] feat: ship release"
OUT="$WORK/test11.out"
if run_check "$WORK/test11" "$OUT" env PR_TITLE="release: REQ-093" PR_BODY=$'## Scope\n- Release: `REQ-093`\n'; then
  CODE=0
else
  CODE=$?
fi
assert_exit "Markdown tracked scope passes" 0 "$CODE"
assert_grep "Markdown tracked scope is verified" 'Release Scope Integrity verified for REQ-093' "$OUT"
echo ""

echo "--- Test 12: malformed explicit scope fails without falling back ---"
make_fixture "$WORK/test12" "[REQ-093] feat: ship release"
OUT="$WORK/test12.out"
if run_check "$WORK/test12" "$OUT" env PR_TITLE="prepare release" PR_BODY=$'## Scope\n- Release: `not-a-release`\n- Historical context: REQ-093\n'; then
  CODE=0
else
  CODE=$?
fi
assert_exit "malformed explicit scope fails" 1 "$CODE"
assert_grep "malformed explicit scope has clear error" 'do not declare a release scope' "$OUT"
echo ""

echo "=== check-release-pr-scope.test.sh: $PASS passed, $FAIL failed ==="
[ "$FAIL" -eq 0 ]