Feat: Enhance pull request close/reconciliation handling

- Add GitHub PR close handling after Gerrit change is merged
- Add CLI ability to accept Gerrit change as input, close PRs
- New --force flag will close GitHub PRs for Abandoned changes
- Add code to extract GitHub ORG from Gerrit change content
- Only display relevant output in GitHub2Gerrit Configuration
- Bypass uvx when testing/developing against branches in forks
- Improve isolation to address failing pre-commit pytest hook

Signed-off-by: Matthew Watkins <mwatkins@linuxfoundation.org>

Author: ModeSevenIndustrialSolutions

README.md

@@ -34,6 +34,52 @@ Gerrit `Change-Id` trailers to create or update changes.
 - Comment on the GitHub PR with the Gerrit change URL(s).
 - Optionally close the PR (mirrors the shell action policy).
 
+## Close Merged PRs Feature
+
+GitHub2Gerrit now includes **automatic PR closure** when Gerrit merges changes
+and syncs them back to GitHub. This completes the lifecycle for automation PRs
+(like Dependabot).
+
+**How it works:**
+
+1. A bot (e.g., Dependabot) creates a GitHub PR
+2. GitHub2Gerrit converts it to a Gerrit change with tracking information
+3. When the Gerrit change is **merged** and synced to GitHub, the original PR is automatically closed
+
+**Key characteristics:**
+
+- **Enabled by default** via `CLOSE_MERGED_PRS=true`
+- **Non-fatal operation** - the tool logs missing or already-closed PRs as
+  info, not errors
+- Works on `push` events when Gerrit syncs changes to GitHub mirrors
+- **Safety checks**: When a Gerrit change URL is available, the tool verifies
+  that the change has MERGED status (not ABANDONED) before closing the PR
+- **Force option**: Use `--force` to close PRs regardless of Gerrit change status
+
+**Gerrit change status handling:**
+
+| Scenario | Default Behavior | With `--force` |
+|----------|------------------|----------------|
+| Change has MERGED status | ✅ Closes PR | ✅ Closes PR |
+| Change has ABANDONED status | ❌ Refuses to close PR | ✅ Closes PR anyway |
+| Change is NEW/OPEN | ⚠️ Closes PR with a warning | ✅ Closes PR |
+| Status UNKNOWN | ⚠️ Closes PR with a warning | ✅ Closes PR |
+
+**Status reporting examples:**
+
+```text
+No GitHub PR URL found in commit abc123de - skipping
+GitHub PR #42 is already closed - nothing to do
+Gerrit change confirmed as MERGED
+SUCCESS: Closed GitHub PR #42
+```
+
+**Safety example (refused closure):**
+
+```text
+ERROR: Gerrit change has ABANDONED status, not closing GitHub PR. Use --force to close anyway.
+```
+
 ## Requirements
 
 - Repository contains a `.gitreview` file. If you cannot provide it,

action.yaml

@@ -65,10 +65,22 @@ inputs:
     description: "Enable CI testing mode; overrides .gitreview, creates orphan commits"
     required: false
     default: "false"
+  CLOSE_MERGED_PRS:
+    description: "Close GitHub PRs when corresponding Gerrit changes are merged"
+    required: false
+    default: "true"
+  FORCE:
+    description: "Force PR closure regardless of Gerrit change status (abandoned, etc)"
+    required: false
+    default: "false"
   ISSUE_ID:
     description: "Issue ID to include (e.g., ABC-123)"
     required: false
     default: ""
+  USE_LOCAL_ACTION:
+    description: "Use local action code instead of PyPI (for testing branches/forks)"
+    required: false
+    default: "false"
   G2G_USE_SSH_AGENT:
     description: "Use SSH agent for authentication instead of file-based keys (recommended)"
     required: false
@@ -157,7 +169,8 @@ runs:
         set -euo pipefail
         uv --version
         # Install locally for self-testing, use uvx for external repos
-        if [[ "${{ github.repository }}" =~ lfreleng-actions/github2gerrit-action ]]; then
+        if [[ "${{ inputs.USE_LOCAL_ACTION }}" == "true" ]] || \
+           [[ "${{ github.repository }}" =~ lfreleng-actions/github2gerrit-action ]]; then
           echo "Installing with: uv pip install --system ${{ github.action_path }}"
           uv pip install --system ${{ github.action_path }}
         else
@@ -199,6 +212,13 @@ runs:
       run: |
         # Extract PR number, validate context
         set -euo pipefail
+
+        # Push events don't need PR_NUMBER (used for closing merged PRs)
+        if [[ "${{ github.event_name }}" == "push" ]]; then
+          echo "Push event detected - will process merged commits for PR closure"
+          exit 0
+        fi
+
         # Honor PR_NUMBER or SYNC_ALL_OPEN_PRS set by workflow_dispatch
         if [[ "${{ github.event_name }}" == "workflow_dispatch" ]]; then
           if [[ -n "${SYNC_ALL_OPEN_PRS:-}" ]]; then
@@ -249,6 +269,8 @@ runs:
         ISSUE_ID: ${{ inputs.ISSUE_ID }}
         ISSUE_ID_LOOKUP_JSON: ${{ inputs.ISSUE_ID_LOOKUP_JSON }}
         CI_TESTING: ${{ inputs.CI_TESTING }}
+        CLOSE_MERGED_PRS: ${{ inputs.CLOSE_MERGED_PRS }}
+        FORCE: ${{ inputs.FORCE }}
         DUPLICATE_TYPES: ${{ inputs.DUPLICATE_TYPES }}
         NORMALISE_COMMIT: ${{ inputs.NORMALISE_COMMIT }}
         G2G_USE_SSH_AGENT: ${{ inputs.G2G_USE_SSH_AGENT }}
@@ -280,8 +302,9 @@ runs:
       run: |
         # Run github2gerrit Python CLI
         set -euo pipefail
-        # Use different invocation methods based on repository
-        if [[ "${{ github.repository }}" =~ lfreleng-actions/github2gerrit-action ]]; then
+        # Use different invocation methods based on repository or USE_LOCAL_ACTION flag
+        if [[ "${{ inputs.USE_LOCAL_ACTION }}" == "true" ]] || \
+           [[ "${{ github.repository }}" =~ lfreleng-actions/github2gerrit-action ]]; then
           echo "Running:python -m github2gerrit.cli"
           python -m github2gerrit.cli
         else