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
- Improve GitHub ORG enumeration to extract from Gerrit change
- 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,34 @@ 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
+- Closes PRs when Gerrit **merges** changes (not abandons them)
+
+**Status reporting examples:**
+
+```text
+INFO: No GitHub PR URL found in commit abc123de - skipping
+INFO: GitHub PR #123 is already closed - nothing to do
+SUCCESS: Closed GitHub PR #456
+```
+
 ## Requirements
 
 - Repository contains a `.gitreview` file. If you cannot provide it,

action.yaml

@@ -65,10 +65,18 @@ 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"
   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 +165,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 +208,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 +265,7 @@ 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 }}
         DUPLICATE_TYPES: ${{ inputs.DUPLICATE_TYPES }}
         NORMALISE_COMMIT: ${{ inputs.NORMALISE_COMMIT }}
         G2G_USE_SSH_AGENT: ${{ inputs.G2G_USE_SSH_AGENT }}
@@ -280,8 +297,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

pyproject.toml

@@ -215,9 +215,14 @@ directory = "coverage_html_report"
 minversion = "8.0"
 addopts = "-ra -q --cov=github2gerrit --cov-report=term-missing --cov-report=html"
 testpaths = ["tests"]
+asyncio_mode = "strict"
+asyncio_default_fixture_loop_scope = "function"
 markers = [
     "integration: marks tests as integration tests (deselect with '-m \"not integration\"')",
 ]
+filterwarnings = [
+    "ignore::pytest.PytestConfigWarning:_pytest.config",
+]
 
 [tool.pyright]
 pythonVersion = "3.11"