stack/packages/mosaic/framework/tools/git/issue-reopen.sh

#!/bin/bash
# issue-reopen.sh - Reopen a closed issue on GitHub or Gitea
# Usage: issue-reopen.sh -i <issue_number> [-b <comment>]
# (-c/--comment is a backward-compatible alias for -b/--body; R1/R4 2026-08-28)

set -e

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

# Parse arguments
ISSUE_NUMBER=""
COMMENT=""

# Usage-error contract (R4, 2026-08-28): usage errors print to STDERR and exit 2,
# distinct from provider, credential, and verification failures (exit 1), so a
# caller or stop gate can tell an invocation defect from a delivery blocker.
usage_error() {
    echo "Error: $*" >&2
    echo "Usage: issue-reopen.sh -i <issue_number> [-b <comment>] (see --help)" >&2
    exit 2
}

while [[ $# -gt 0 ]]; do
    case $1 in
        -i|--issue|--number)
            [[ $# -ge 2 && "$2" != - && "$2" != --* && ! "$2" =~ ^-[[:alnum:]] ]] || usage_error "option $1 requires a value (option-like values are rejected; bare - is reserved)"
            ISSUE_NUMBER="$2"
            shift 2
            ;;
        -b|--body|-c|--comment)
            # R1 (2026-08-28): --body is the canonical flag; -c/--comment stays
            # a backward-compatible alias.
            [[ $# -ge 2 && "$2" != - && "$2" != --* && ! "$2" =~ ^-[[:alnum:]] ]] || usage_error "option $1 requires a value (option-like values are rejected; bare - is reserved)"
            COMMENT="$2"
            shift 2
            ;;
        -h|--help)
            echo "Usage: issue-reopen.sh -i <issue_number> [-b <comment>]"
            echo ""
            echo "Options:"
            echo "  -n, --number   Issue number (required; canonical)"
            echo "  -i, --issue    Alias for --number"
            echo "  -b, --body     Comment to add when reopening (optional; canonical)"
            echo "  -c, --comment  Alias for --body"
            echo "  -h, --help     Show this help"
            echo ""
            echo "Exit codes: 0 success; 2 usage error (stderr); 1 provider/credential/verification failure."
            exit 0
            ;;
        *)
            usage_error "unknown option: $1"
            ;;
    esac
done

if [[ -z "$ISSUE_NUMBER" ]]; then
    usage_error "issue number is required (-i/--issue)"
fi

detect_platform >/dev/null
OWNER=$(get_repo_owner)
REPO=$(get_repo_name)

gitea_issue_comment_api() {
    local host token url payload
    host=$(get_remote_host) || return 1
    token=$(get_gitea_token "$host") || return 1
    url="https://${host}/api/v1/repos/${OWNER}/${REPO}/issues/${ISSUE_NUMBER}/comments"
    payload=$(COMMENT="$COMMENT" python3 - <<'PY'
import json
import os

print(json.dumps({"body": os.environ["COMMENT"]}))
PY
)
    curl -fsS -X POST \
        -H "User-Agent: curl/8" \
        -H "Authorization: token ${token}" \
        -H "Content-Type: application/json" \
        -d "$payload" \
        "$url" >/dev/null
}

gitea_issue_reopen_api() {
    local host token url
    host=$(get_remote_host) || return 1
    token=$(get_gitea_token "$host") || return 1
    url="https://${host}/api/v1/repos/${OWNER}/${REPO}/issues/${ISSUE_NUMBER}"
    curl -fsS -X PATCH \
        -H "User-Agent: curl/8" \
        -H "Authorization: token ${token}" \
        -H "Content-Type: application/json" \
        -d '{"state":"open"}' \
        "$url" >/dev/null
}

if [[ "$PLATFORM" == "github" ]]; then
    # R4: normalize provider failures to exit 1 (gh's own usage errors exit 2
    # and would collide with the reserved usage-error status).
    if [[ -n "$COMMENT" ]]; then
        gh_rc=0
        gh issue comment "$ISSUE_NUMBER" --body "$COMMENT" || gh_rc=$?
        if [[ "$gh_rc" -ne 0 ]]; then
            echo "Error: GitHub comment before reopen failed (gh exit $gh_rc)" >&2
            exit 1
        fi
    fi
    gh_rc=0
    gh issue reopen "$ISSUE_NUMBER" || gh_rc=$?
    if [[ "$gh_rc" -ne 0 ]]; then
        echo "Error: GitHub issue reopen failed (gh exit $gh_rc)" >&2
        exit 1
    fi
    echo "Reopened GitHub issue #$ISSUE_NUMBER"
elif [[ "$PLATFORM" == "gitea" ]]; then
    REPO_ARGS=$(get_gitea_repo_args || true)
    if [[ -n "$REPO_ARGS" ]]; then
        if [[ -n "$COMMENT" ]]; then
            prov_rc=0
            tea issue comment "$ISSUE_NUMBER" "$COMMENT" $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; }
        fi
        prov_rc=0
        tea issue reopen "$ISSUE_NUMBER" $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; }
    else
        echo "No tea login configured for $(get_remote_host); using authenticated Gitea API fallback." >&2
        if [[ -n "$COMMENT" ]]; then
            gitea_issue_comment_api
        fi
        gitea_issue_reopen_api
    fi
    echo "Reopened Gitea issue #$ISSUE_NUMBER"
else
    echo "Error: Unknown platform"
    exit 1
fi