#!/bin/bash
# milestone-close.sh - Close a milestone on GitHub or Gitea
# Usage: milestone-close.sh -t <title>

set -e

SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
source "$SCRIPT_DIR/detect-platform.sh"

# Parse arguments
# Usage-error contract (R4, 2026-08-28): usage errors print to STDERR and exit 2,
# distinct from provider, credential, and verification failures (exit 1).
usage_error() {
    echo "Error: $*" >&2
    echo "Usage: milestone-close.sh -t <title> (see --help)" >&2
    exit 2
}

TITLE=""

while [[ $# -gt 0 ]]; do
    case $1 in
        -t|--title)
            [[ $# -ge 2 && "$2" != - && "$2" != --* && ! "$2" =~ ^-[[:alnum:]] ]] || usage_error "option $1 requires a value (option-like values are rejected; bare - is reserved)"
            TITLE="$2"
            shift 2
            ;;
        -h|--help)
            echo "Usage: milestone-close.sh -t <title>"
            echo ""
            echo "Options:"
            echo "  -t, --title   Milestone title (required)"
            echo "  -h, --help    Show this help"
            exit 0
            ;;
        *)
            usage_error "unknown option: $1"
            ;;
    esac
done

if [[ -z "$TITLE" ]]; then
    usage_error "Milestone title is required"
fi

detect_platform >/dev/null

if [[ "$PLATFORM" == "github" ]]; then
    prov_rc=0
    gh api -X PATCH "/repos/{owner}/{repo}/milestones/$(gh api "/repos/{owner}/{repo}/milestones" --jq ".[] | select(.title==\"$TITLE\") | .number")" -f state=closed || prov_rc=$?
    [[ "$prov_rc" -eq 0 ]] || { echo "Error: provider command failed (exit ${prov_rc}; provider failure, not a usage error)" >&2; exit 1; }
    echo "Closed GitHub milestone: $TITLE"
elif [[ "$PLATFORM" == "gitea" ]]; then
    REPO_ARGS=$(get_gitea_repo_args) || {
        echo "Error: Could not resolve Gitea repo/login for remote host" >&2
        exit 1
    }
    prov_rc=0
    tea milestone close "$TITLE" $REPO_ARGS || prov_rc=$?
    [[ "$prov_rc" -eq 0 ]] || { echo "Error: provider command failed (exit ${prov_rc}; provider failure, not a usage error)" >&2; exit 1; }
    echo "Closed Gitea milestone: $TITLE"
else
    echo "Error: Unknown platform"
    exit 1
fi