github2gerrit 0.1.9__tar.gz → 0.1.11__tar.gz

{github2gerrit-0.1.9 → github2gerrit-0.1.11}/.pre-commit-config.yaml

@@ -58,7 +58,7 @@ repos:
         types: [yaml]
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: 54a455f7ce629598b7535ff828fd5fb796f4b83f  # frozen: v0.12.9
+    rev: f298305809c552671cc47e0fec0ba43e96c146a2  # frozen: v0.13.2
     hooks:
       - id: ruff
         files: ^(src|scripts|tests)/.+\.py$
@@ -67,9 +67,10 @@ repos:
         files: ^(src|scripts|tests)/.+\.py$
 
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: 412de98d50e846f31ea6f4b0ad036f2c24a7a024  # frozen: v1.17.1
+    rev: 9f70dc58c23dfcca1b97af99eaeee3140a807c7e  # frozen: v1.18.2
     hooks:
       - id: mypy
+        files: ^src/.+\.py$
         additional_dependencies:
           - types-PyYAML
           - types-requests
@@ -101,7 +102,7 @@ repos:
         exclude: "GERRIT_URL_CENTRALIZATION.md"
 
   - repo: https://github.com/fsfe/reuse-tool
-    rev: 60dfc6b2ad9e1f3eabfbcf3a0dc202ee89dc5a00 # frozen: v5.0.2
+    rev: 8b8bbd873b2af6b2a2521ab2b1ff07b2ab624840  # frozen: v5.1.1
     hooks:
       - id: reuse
 
@@ -119,7 +120,7 @@ repos:
       - id: codespell
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 9b9df9f1d3bd9a5e7a52d8f61a3be3e29e73d127  # frozen: 0.33.3
+    rev: 83987cd6ad8943c7f029b500b14aaf82c00a01fa  # frozen: 0.34.0
     hooks:
       - id: check-github-actions
       - id: check-github-workflows

github2gerrit-0.1.11/LICENSE

@@ -0,0 +1 @@
+LICENSES/Apache-2.0.txt

{github2gerrit-0.1.9/src/github2gerrit.egg-info → github2gerrit-0.1.11}/PKG-INFO

@@ -1,13 +1,14 @@
 Metadata-Version: 2.4
 Name: github2gerrit
-Version: 0.1.9
+Version: 0.1.11
 Summary: Submit a GitHub pull request to a Gerrit repository.
-Author-email: Matthew Watkins <mwatkins@linuxfoundation.org>
-License-Expression: Apache-2.0
 Project-URL: Homepage, https://github.com/lfreleng-actions/github2gerrit
 Project-URL: Repository, https://github.com/lfreleng-actions/github2gerrit
 Project-URL: Issues, https://github.com/lfreleng-actions/github2gerrit/issues
-Keywords: github,gerrit,ci,actions,typer,cli
+Author-email: Matthew Watkins <mwatkins@linuxfoundation.org>
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: actions,ci,cli,gerrit,github,typer
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -20,23 +21,23 @@ Classifier: Topic :: Software Development :: Build Tools
 Classifier: Topic :: Software Development :: Version Control
 Classifier: Typing :: Typed
 Requires-Python: <3.14,>=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: typer>=0.12.5
-Requires-Dist: PyGithub>=2.3.0
-Requires-Dist: pygerrit2>=2.0.0
 Requires-Dist: git-review>=2.3.1
-Requires-Dist: PyYAML>=6.0.1
+Requires-Dist: pygerrit2>=2.0.0
+Requires-Dist: pygithub>=2.3.0
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.12.5
 Provides-Extra: dev
-Requires-Dist: pytest>=8.3.2; extra == "dev"
-Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
-Requires-Dist: coverage[toml]>=7.6.1; extra == "dev"
-Requires-Dist: ruff>=0.6.3; extra == "dev"
-Requires-Dist: mypy>=1.11.2; extra == "dev"
-Requires-Dist: pytest-mock>=3.14.0; extra == "dev"
-Requires-Dist: types-requests>=2.31.0; extra == "dev"
-Requires-Dist: types-click>=7.1.8; extra == "dev"
-Dynamic: license-file
+Requires-Dist: coverage[toml]>=7.6.1; extra == 'dev'
+Requires-Dist: mypy>=1.11.2; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest-mock>=3.14.0; extra == 'dev'
+Requires-Dist: pytest>=8.3.2; extra == 'dev'
+Requires-Dist: responses>=0.25.0; extra == 'dev'
+Requires-Dist: ruff>=0.6.3; extra == 'dev'
+Requires-Dist: types-click>=7.1.8; extra == 'dev'
+Requires-Dist: types-requests>=2.31.0; extra == 'dev'
+Description-Content-Type: text/markdown
 
 <!--
 SPDX-License-Identifier: Apache-2.0
@@ -140,6 +141,27 @@ with:
 When allowed, duplicates generate warnings but processing continues.
 The tool exits with code 3 when it detects duplicates and they are not allowed.
 
+### Configuring duplicate detection scope
+
+By default, the duplicate detector considers changes with status `open` when searching for potential duplicates.
+You can customize which Gerrit change states to check using `--duplicate-types` or setting `DUPLICATE_TYPES`:
+
+```bash
+# CLI usage - check against open and merged changes
+github2gerrit --duplicate-types=open,merged https://github.com/org/repo
+
+# Environment variable
+DUPLICATE_TYPES=open,merged,abandoned github2gerrit https://github.com/org/repo
+
+# GitHub Actions
+uses: onap/github2gerrit@main
+with:
+  DUPLICATE_TYPES: 'open,merged'
+```
+
+Valid change states include `open`, `merged`, and `abandoned`. This setting determines which existing changes
+to check when evaluating whether a new change would be a duplicate.
+
 ## Commit Message Normalization
 
 The tool includes intelligent commit message normalization that automatically
@@ -309,6 +331,8 @@ jobs:
           ORGANIZATION: ${{ github.repository_owner }}
           REVIEWERS_EMAIL: ""
           ISSUE_ID: ""  # Optional: adds 'Issue-ID: ...' trailer to the commit message
+          # ISSUE_ID_LOOKUP: ${{ vars.ISSUE_ID_LOOKUP }}  # Optional: enable JSON lookup
+          # ISSUE_ID_LOOKUP_JSON: ${{ vars.ISSUE_ID_LOOKUP_JSON }}  # Optional: JSON lookup table
 ```
 
 The action reads `.gitreview`. If `.gitreview` is absent, you must
@@ -368,6 +392,7 @@ Key options include:
 - `--use-pr-as-commit`: Use PR title/body as commit message (`USE_PR_AS_COMMIT`)
 - `--issue-id`: Add an Issue-ID trailer (e.g., "Issue-ID: ABC-123") to the commit message (`ISSUE_ID`)
 - `--preserve-github-prs`: Don't close GitHub PRs after submission (`PRESERVE_GITHUB_PRS`)
+- `--duplicate-types`: Configure which Gerrit change states to check for duplicates (`DUPLICATE_TYPES`)
 
 For a complete list of all available options, see the [Inputs](#inputs) section.
 
@@ -403,13 +428,15 @@ Common issues and solutions:
 
 2. **SSH Permission Denied**:
    - Ensure `GERRIT_SSH_PRIVKEY_G2G` and `GERRIT_KNOWN_HOSTS` are properly set
-   - If you see "Permissions 0644 for 'gerrit_key' are too open", the action will automatically try SSH agent
-     authentication
+   - If you see "Permissions 0644 for 'gerrit_key' are too open", the action will automatically
+     try SSH agent authentication
    - For persistent file permission issues, ensure `G2G_USE_SSH_AGENT=true` (default)
 
 3. **Branch Not Found**: Check that the target branch exists in both GitHub and Gerrit
 4. **Change-Id Issues**: Enable debug logging to see Change-Id generation and validation
-5. **Gerrit API Errors**: Verify Gerrit server connectivity and project permissions
+5. **Account Not Found Errors**: If you see "Account '<Email@Domain.com>' not found",
+   ensure your Gerrit account email matches your git config email (case-sensitive).
+6. **Gerrit API Errors**: Verify Gerrit server connectivity and project permissions
 
 > **Note**: The tool displays configuration errors cleanly without Python tracebacks.
 > If you see a traceback in the output, please report it as a bug.
@@ -592,8 +619,10 @@ alignment between action inputs, environment variables, and CLI flags:
 | `ALLOW_DUPLICATES` | `ALLOW_DUPLICATES` | `--allow-duplicates` | No | `"false"` | Allow submitting duplicate changes without error |
 | `CI_TESTING` | `CI_TESTING` | `--ci-testing` | No | `"false"` | Enable CI testing mode (overrides .gitreview) |
 | `ISSUE_ID` | `ISSUE_ID` | `--issue-id` | No | `""` | Issue ID to include (e.g., ABC-123) |
+| `ISSUE_ID_LOOKUP` | N/A | N/A | No | `"false"` | Enable Issue ID lookup via JSON table |
+| `ISSUE_ID_LOOKUP_JSON` | N/A | N/A | No | `"{}"` | JSON mapping of GitHub actors to Issue IDs |
 | `G2G_USE_SSH_AGENT` | `G2G_USE_SSH_AGENT` | N/A | No | `"true"` | Use SSH agent for authentication |
-| `DUPLICATES` | `DUPLICATES` | `--duplicates` | No | `"open"` | Comma-separated Gerrit statuses for duplicate detection |
+| `DUPLICATE_TYPES` | `DUPLICATE_TYPES` | `--duplicate-types` | No | `"open"` | Comma-separated Gerrit change states to check for duplicate detection |
 | `GERRIT_SERVER` | `GERRIT_SERVER` | `--gerrit-server` | No² | `""` | Gerrit server hostname (auto-derived if enabled) |
 | `GERRIT_SERVER_PORT` | `GERRIT_SERVER_PORT` | `--gerrit-server-port` | No | `"29418"` | Gerrit SSH port |
 | `GERRIT_PROJECT` | `GERRIT_PROJECT` | `--gerrit-project` | No² | `""` | Gerrit project name |
@@ -604,7 +633,7 @@ alignment between action inputs, environment variables, and CLI flags:
 
 **Notes:**
 
-1. Auto-derived when `G2G_ENABLE_DERIVATION=true` (default: false in GitHub Actions, true in CLI)
+1. Auto-derived when `G2G_ENABLE_DERIVATION=true` (default: true in all contexts)
 2. Optional if `.gitreview` file exists in repository
 
 ### Internal Environment Variables
@@ -614,7 +643,7 @@ The following environment variables control internal behavior but are not action
 | Environment Variable | Description | Default |
 |---------------------|-------------|---------|
 | `G2G_LOG_LEVEL` | Logging level (DEBUG, INFO, WARNING, ERROR) | `"INFO"` |
-| `G2G_ENABLE_DERIVATION` | Enable auto-derivation of Gerrit parameters | `"false"` (GitHub Actions), `"true"` (CLI) |
+| `G2G_ENABLE_DERIVATION` | Enable auto-derivation of Gerrit parameters | `"true"` |
 | `G2G_CONFIG_PATH` | Path to organization configuration file | `~/.config/github2gerrit/config.ini` |
 | `G2G_AUTO_SAVE_CONFIG` | Auto-save derived parameters to config | `"false"` (GitHub Actions), `"true"` (CLI) |
 | `G2G_TARGET_URL` | Internal flag for direct URL mode | Set automatically |
@@ -680,6 +709,51 @@ variable.
 **Note**: Unknown configuration keys will generate warnings to help catch typos
 and missing functionality.
 
+### Issue ID Lookup
+
+> **Migration Note**: If you were using repository variables `ISSUE_ID_LOOKUP`
+> and `ISSUE_ID_LOOKUP_JSON` directly, you now need to pass them as inputs to
+> the action. See the example below.
+
+The action supports automatic Issue ID resolution via JSON lookup when no
+explicit `ISSUE_ID` exists:
+
+```yaml
+- uses: lfreleng-actions/github2gerrit-action@v1
+  with:
+    GERRIT_SSH_PRIVKEY_G2G: ${{ secrets.GERRIT_SSH_PRIVKEY_G2G }}
+    # Enable Issue ID lookup (pass repository variables as inputs)
+    ISSUE_ID_LOOKUP: ${{ vars.ISSUE_ID_LOOKUP }}
+    ISSUE_ID_LOOKUP_JSON: ${{ vars.ISSUE_ID_LOOKUP_JSON }}
+    # ... other inputs
+```
+
+**Setup Requirements:**
+
+1. Set repository variables:
+   - `ISSUE_ID_LOOKUP`: `"true"` (enables lookup feature)
+   - `ISSUE_ID_LOOKUP_JSON`: JSON mapping of GitHub usernames to Issue IDs
+
+2. **Example JSON format:**
+
+   ```json
+   {
+     "dependabot[bot]": "AUTO-123",
+     "renovate[bot]": "AUTO-456",
+     "alice": "PROJ-789",
+     "bob": "PROJ-101"
+   }
+   ```
+
+**Lookup Logic:**
+
+1. If `ISSUE_ID` input exists → use it directly
+2. If `ISSUE_ID` is empty AND `ISSUE_ID_LOOKUP=true` → lookup using `github.actor`
+3. If lookup fails → no Issue ID gets added (silent fallback)
+
+This feature helps organizations automatically tag commits with
+project-specific Issue IDs based on who creates the pull request.
+
 ## Behavior details
 
 - Branch resolution

github2gerrit-0.1.9/PKG-INFO → github2gerrit-0.1.11/README.md

@@ -1,43 +1,3 @@
-Metadata-Version: 2.4
-Name: github2gerrit
-Version: 0.1.9
-Summary: Submit a GitHub pull request to a Gerrit repository.
-Author-email: Matthew Watkins <mwatkins@linuxfoundation.org>
-License-Expression: Apache-2.0
-Project-URL: Homepage, https://github.com/lfreleng-actions/github2gerrit
-Project-URL: Repository, https://github.com/lfreleng-actions/github2gerrit
-Project-URL: Issues, https://github.com/lfreleng-actions/github2gerrit/issues
-Keywords: github,gerrit,ci,actions,typer,cli
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Software Development :: Build Tools
-Classifier: Topic :: Software Development :: Version Control
-Classifier: Typing :: Typed
-Requires-Python: <3.14,>=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: typer>=0.12.5
-Requires-Dist: PyGithub>=2.3.0
-Requires-Dist: pygerrit2>=2.0.0
-Requires-Dist: git-review>=2.3.1
-Requires-Dist: PyYAML>=6.0.1
-Provides-Extra: dev
-Requires-Dist: pytest>=8.3.2; extra == "dev"
-Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
-Requires-Dist: coverage[toml]>=7.6.1; extra == "dev"
-Requires-Dist: ruff>=0.6.3; extra == "dev"
-Requires-Dist: mypy>=1.11.2; extra == "dev"
-Requires-Dist: pytest-mock>=3.14.0; extra == "dev"
-Requires-Dist: types-requests>=2.31.0; extra == "dev"
-Requires-Dist: types-click>=7.1.8; extra == "dev"
-Dynamic: license-file
-
 <!--
 SPDX-License-Identifier: Apache-2.0
 SPDX-FileCopyrightText: 2025 The Linux Foundation
@@ -140,6 +100,27 @@ with:
 When allowed, duplicates generate warnings but processing continues.
 The tool exits with code 3 when it detects duplicates and they are not allowed.
 
+### Configuring duplicate detection scope
+
+By default, the duplicate detector considers changes with status `open` when searching for potential duplicates.
+You can customize which Gerrit change states to check using `--duplicate-types` or setting `DUPLICATE_TYPES`:
+
+```bash
+# CLI usage - check against open and merged changes
+github2gerrit --duplicate-types=open,merged https://github.com/org/repo
+
+# Environment variable
+DUPLICATE_TYPES=open,merged,abandoned github2gerrit https://github.com/org/repo
+
+# GitHub Actions
+uses: onap/github2gerrit@main
+with:
+  DUPLICATE_TYPES: 'open,merged'
+```
+
+Valid change states include `open`, `merged`, and `abandoned`. This setting determines which existing changes
+to check when evaluating whether a new change would be a duplicate.
+
 ## Commit Message Normalization
 
 The tool includes intelligent commit message normalization that automatically
@@ -309,6 +290,8 @@ jobs:
           ORGANIZATION: ${{ github.repository_owner }}
           REVIEWERS_EMAIL: ""
           ISSUE_ID: ""  # Optional: adds 'Issue-ID: ...' trailer to the commit message
+          # ISSUE_ID_LOOKUP: ${{ vars.ISSUE_ID_LOOKUP }}  # Optional: enable JSON lookup
+          # ISSUE_ID_LOOKUP_JSON: ${{ vars.ISSUE_ID_LOOKUP_JSON }}  # Optional: JSON lookup table
 ```
 
 The action reads `.gitreview`. If `.gitreview` is absent, you must
@@ -368,6 +351,7 @@ Key options include:
 - `--use-pr-as-commit`: Use PR title/body as commit message (`USE_PR_AS_COMMIT`)
 - `--issue-id`: Add an Issue-ID trailer (e.g., "Issue-ID: ABC-123") to the commit message (`ISSUE_ID`)
 - `--preserve-github-prs`: Don't close GitHub PRs after submission (`PRESERVE_GITHUB_PRS`)
+- `--duplicate-types`: Configure which Gerrit change states to check for duplicates (`DUPLICATE_TYPES`)
 
 For a complete list of all available options, see the [Inputs](#inputs) section.
 
@@ -403,13 +387,15 @@ Common issues and solutions:
 
 2. **SSH Permission Denied**:
    - Ensure `GERRIT_SSH_PRIVKEY_G2G` and `GERRIT_KNOWN_HOSTS` are properly set
-   - If you see "Permissions 0644 for 'gerrit_key' are too open", the action will automatically try SSH agent
-     authentication
+   - If you see "Permissions 0644 for 'gerrit_key' are too open", the action will automatically
+     try SSH agent authentication
    - For persistent file permission issues, ensure `G2G_USE_SSH_AGENT=true` (default)
 
 3. **Branch Not Found**: Check that the target branch exists in both GitHub and Gerrit
 4. **Change-Id Issues**: Enable debug logging to see Change-Id generation and validation
-5. **Gerrit API Errors**: Verify Gerrit server connectivity and project permissions
+5. **Account Not Found Errors**: If you see "Account '<Email@Domain.com>' not found",
+   ensure your Gerrit account email matches your git config email (case-sensitive).
+6. **Gerrit API Errors**: Verify Gerrit server connectivity and project permissions
 
 > **Note**: The tool displays configuration errors cleanly without Python tracebacks.
 > If you see a traceback in the output, please report it as a bug.
@@ -592,8 +578,10 @@ alignment between action inputs, environment variables, and CLI flags:
 | `ALLOW_DUPLICATES` | `ALLOW_DUPLICATES` | `--allow-duplicates` | No | `"false"` | Allow submitting duplicate changes without error |
 | `CI_TESTING` | `CI_TESTING` | `--ci-testing` | No | `"false"` | Enable CI testing mode (overrides .gitreview) |
 | `ISSUE_ID` | `ISSUE_ID` | `--issue-id` | No | `""` | Issue ID to include (e.g., ABC-123) |
+| `ISSUE_ID_LOOKUP` | N/A | N/A | No | `"false"` | Enable Issue ID lookup via JSON table |
+| `ISSUE_ID_LOOKUP_JSON` | N/A | N/A | No | `"{}"` | JSON mapping of GitHub actors to Issue IDs |
 | `G2G_USE_SSH_AGENT` | `G2G_USE_SSH_AGENT` | N/A | No | `"true"` | Use SSH agent for authentication |
-| `DUPLICATES` | `DUPLICATES` | `--duplicates` | No | `"open"` | Comma-separated Gerrit statuses for duplicate detection |
+| `DUPLICATE_TYPES` | `DUPLICATE_TYPES` | `--duplicate-types` | No | `"open"` | Comma-separated Gerrit change states to check for duplicate detection |
 | `GERRIT_SERVER` | `GERRIT_SERVER` | `--gerrit-server` | No² | `""` | Gerrit server hostname (auto-derived if enabled) |
 | `GERRIT_SERVER_PORT` | `GERRIT_SERVER_PORT` | `--gerrit-server-port` | No | `"29418"` | Gerrit SSH port |
 | `GERRIT_PROJECT` | `GERRIT_PROJECT` | `--gerrit-project` | No² | `""` | Gerrit project name |
@@ -604,7 +592,7 @@ alignment between action inputs, environment variables, and CLI flags:
 
 **Notes:**
 
-1. Auto-derived when `G2G_ENABLE_DERIVATION=true` (default: false in GitHub Actions, true in CLI)
+1. Auto-derived when `G2G_ENABLE_DERIVATION=true` (default: true in all contexts)
 2. Optional if `.gitreview` file exists in repository
 
 ### Internal Environment Variables
@@ -614,7 +602,7 @@ The following environment variables control internal behavior but are not action
 | Environment Variable | Description | Default |
 |---------------------|-------------|---------|
 | `G2G_LOG_LEVEL` | Logging level (DEBUG, INFO, WARNING, ERROR) | `"INFO"` |
-| `G2G_ENABLE_DERIVATION` | Enable auto-derivation of Gerrit parameters | `"false"` (GitHub Actions), `"true"` (CLI) |
+| `G2G_ENABLE_DERIVATION` | Enable auto-derivation of Gerrit parameters | `"true"` |
 | `G2G_CONFIG_PATH` | Path to organization configuration file | `~/.config/github2gerrit/config.ini` |
 | `G2G_AUTO_SAVE_CONFIG` | Auto-save derived parameters to config | `"false"` (GitHub Actions), `"true"` (CLI) |
 | `G2G_TARGET_URL` | Internal flag for direct URL mode | Set automatically |
@@ -680,6 +668,51 @@ variable.
 **Note**: Unknown configuration keys will generate warnings to help catch typos
 and missing functionality.
 
+### Issue ID Lookup
+
+> **Migration Note**: If you were using repository variables `ISSUE_ID_LOOKUP`
+> and `ISSUE_ID_LOOKUP_JSON` directly, you now need to pass them as inputs to
+> the action. See the example below.
+
+The action supports automatic Issue ID resolution via JSON lookup when no
+explicit `ISSUE_ID` exists:
+
+```yaml
+- uses: lfreleng-actions/github2gerrit-action@v1
+  with:
+    GERRIT_SSH_PRIVKEY_G2G: ${{ secrets.GERRIT_SSH_PRIVKEY_G2G }}
+    # Enable Issue ID lookup (pass repository variables as inputs)
+    ISSUE_ID_LOOKUP: ${{ vars.ISSUE_ID_LOOKUP }}
+    ISSUE_ID_LOOKUP_JSON: ${{ vars.ISSUE_ID_LOOKUP_JSON }}
+    # ... other inputs
+```
+
+**Setup Requirements:**
+
+1. Set repository variables:
+   - `ISSUE_ID_LOOKUP`: `"true"` (enables lookup feature)
+   - `ISSUE_ID_LOOKUP_JSON`: JSON mapping of GitHub usernames to Issue IDs
+
+2. **Example JSON format:**
+
+   ```json
+   {
+     "dependabot[bot]": "AUTO-123",
+     "renovate[bot]": "AUTO-456",
+     "alice": "PROJ-789",
+     "bob": "PROJ-101"
+   }
+   ```
+
+**Lookup Logic:**
+
+1. If `ISSUE_ID` input exists → use it directly
+2. If `ISSUE_ID` is empty AND `ISSUE_ID_LOOKUP=true` → lookup using `github.actor`
+3. If lookup fails → no Issue ID gets added (silent fallback)
+
+This feature helps organizations automatically tag commits with
+project-specific Issue IDs based on who creates the pull request.
+
 ## Behavior details
 
 - Branch resolution