Add minimumLinkedIssues input to action

Introduce a new optional input `minimumLinkedIssues` (default 1) to the check-linked-issue action and parse it in the composite script so callers can require more than one linked issue. Update action.yml to declare the input and adjust messaging to show found vs required counts. Update README to document the new input and example usage, and add `issues: read` permission to the recommended permissions block.

Signed-off-by: John McCall <john@overturemaps.org>

Author: lowlydba

.github/actions/check-linked-issue/README.md

@@ -10,7 +10,7 @@ This action queries the GitHub GraphQL API for `closingIssuesReferences` on a
 pull request. It detects issues linked by:
 
 - Body keywords: `Fixes #123`, `Closes #456`, `Resolves owner/repo#789`
-- Manual linking via the GitHub UI sidebar
+- Manual linking via the GitHub UI
 
 If no linked issues are found, the step fails with a message guiding the author
 to link one.
@@ -78,6 +78,8 @@ jobs:
 
       - name: Check for linked issue
         uses: ./.workflows/.github/actions/check-linked-issue
+        with:
+          minimumLinkedIssues: 2  # Require at least 2 linked issues (optional, default is 1)
 
       # ... additional steps in the same job
 ```
@@ -91,16 +93,19 @@ Requires the default `GITHUB_TOKEN` with:
 ```yaml
 permissions:
   contents: read
+  issues: read
   pull-requests: read
 ```
 
-For private repos, these permissions allow the token to read PR metadata and
-query linked issues. Cross-repo issue detection is limited to public repos and
-repos within the same organization that the token has access to.
-
 ### Inputs
 
-This action has no inputs.
+- `minimumLinkedIssues` (optional): Minimum number of linked issues required for the PR. Default is `1`. Set this input to require more than one linked issue:
+
+```yaml
+with:
+  minimumLinkedIssues: 2
+```
+
 
 ### Outputs
 

.github/actions/check-linked-issue/action.yml

@@ -5,6 +5,12 @@ description: >
   closingIssuesReferences. Covers 'Fixes #123', 'Closes owner/repo#456',
   and issues linked manually through the GitHub UI.
 
+inputs:
+  minimumLinkedIssues:
+    description: Minimum number of linked issues required
+    required: false
+    default: 1
+
 runs:
   using: composite
   steps:
@@ -14,7 +20,7 @@ runs:
         script: |
           const prNumber = context.payload.pull_request.number;
           const { owner, repo } = context.repo;
-          const minimumLinkedIssues = 1;
+          const minimumLinkedIssues = parseInt(core.getInput('minimumLinkedIssues')) || 1;
 
           const query = `
             query($owner: String!, $repo: String!, $number: Int!) {
@@ -46,14 +52,14 @@ runs:
 
           if (!issues || issues.length < minimumLinkedIssues) {
             core.setFailed(
-              `❌ This PR does not reference any linked issues, but should have at least ${minimumLinkedIssues}!\n` +
+              `❌ This PR does not reference enough linked issues (found ${issues.length}, required ${minimumLinkedIssues})!\n` +
               "Please link an issue using 'Fixes #123', " +
               "'Closes OvertureMaps/other-repo#123', or the GitHub UI " +
               "(https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/linking-a-pull-request-to-an-issue)\n" +
               "After adding a linked issue, you may need to manually re-run this check from the Checks tab to update the status."
             );
           } else {
-            core.info(`✅ ${issues.length} linked issues found:`);
+            core.info(`✅ ${issues.length} linked issues found out of ${minimumLinkedIssues} required:`);
             issues.forEach(issue => {
               core.info(`  #${issue.number} - ${issue.title} (${issue.state}) ${issue.url}`);
             });