feat: increase maximum concurrent issue assignments to 3 and update validation logic

Author: JhaSourav07

.github/scripts/issue-management/assign-handler.js

@@ -1,4 +1,4 @@
-async function findExistingAssignment(github, owner, repo, username, currentIssueNumber) {
+async function findExistingAssignments(github, owner, repo, username, currentIssueNumber) {
   const { data: issues } = await github.rest.issues.listForRepo({
     owner,
     repo,
@@ -7,13 +7,11 @@ async function findExistingAssignment(github, owner, repo, username, currentIssu
     per_page: 100,
   });
 
-  const assignedIssues = issues.filter(
-    (issue) => !issue.pull_request && issue.number !== currentIssueNumber
-  );
-
-  return assignedIssues.length > 0 ? assignedIssues[0] : null;
+  return issues.filter((issue) => !issue.pull_request && issue.number !== currentIssueNumber);
 }
 
+const MAX_ASSIGNED_ISSUES = 3;
+
 async function handleAssign({ github, context, username, hasWriteAccess }) {
   const { owner, repo } = context.repo;
   const issueNumber = context.payload.issue.number;
@@ -77,13 +75,16 @@ async function handleAssign({ github, context, username, hasWriteAccess }) {
     return;
   }
 
-  const existingIssue = await findExistingAssignment(github, owner, repo, username, issueNumber);
-  if (existingIssue) {
+  const existingIssues = await findExistingAssignments(github, owner, repo, username, issueNumber);
+  if (existingIssues.length >= MAX_ASSIGNED_ISSUES) {
+    const issueList = existingIssues
+      .map((i) => `> 📋 [#${i.number} — ${i.title}](${i.html_url})`)
+      .join('\n');
     await github.rest.issues.createComment({
       owner,
       repo,
       issue_number: issueNumber,
-      body: `❌ @${username} already has an active assigned issue.\nPlease complete or unassign the current issue first.\n\n> 📋 Active issue: [#${existingIssue.number} — ${existingIssue.title}](${existingIssue.html_url})`,
+      body: `❌ @${username} already has **${existingIssues.length}/${MAX_ASSIGNED_ISSUES}** active assigned issues (the maximum allowed).\nPlease complete or unassign one of their current issues first.\n\n${issueList}`,
     });
     return;
   }

.github/scripts/issue-management/claim-handler.js

@@ -1,4 +1,4 @@
-async function findExistingAssignment(github, owner, repo, username, currentIssueNumber) {
+async function findExistingAssignments(github, owner, repo, username, currentIssueNumber) {
   const { data: issues } = await github.rest.issues.listForRepo({
     owner,
     repo,
@@ -7,13 +7,11 @@ async function findExistingAssignment(github, owner, repo, username, currentIssu
     per_page: 100,
   });
 
-  const assignedIssues = issues.filter(
-    (issue) => !issue.pull_request && issue.number !== currentIssueNumber
-  );
-
-  return assignedIssues.length > 0 ? assignedIssues[0] : null;
+  return issues.filter((issue) => !issue.pull_request && issue.number !== currentIssueNumber);
 }
 
+const MAX_ASSIGNED_ISSUES = 3;
+
 async function handleClaim({ github, context }) {
   const { owner, repo } = context.repo;
   const issueNumber = context.payload.issue.number;
@@ -64,13 +62,16 @@ async function handleClaim({ github, context }) {
     return;
   }
 
-  const existingIssue = await findExistingAssignment(github, owner, repo, commenter, issueNumber);
-  if (existingIssue) {
+  const existingIssues = await findExistingAssignments(github, owner, repo, commenter, issueNumber);
+  if (existingIssues.length >= MAX_ASSIGNED_ISSUES) {
+    const issueList = existingIssues
+      .map((i) => `> 📋 [#${i.number} — ${i.title}](${i.html_url})`)
+      .join('\n');
     await github.rest.issues.createComment({
       owner,
       repo,
       issue_number: issueNumber,
-      body: `❌ You already have an active assigned issue.\nPlease complete or unassign your current issue first.\n\n> 📋 Active issue: [#${existingIssue.number} — ${existingIssue.title}](${existingIssue.html_url})`,
+      body: `❌ You already have **${existingIssues.length}/${MAX_ASSIGNED_ISSUES}** active assigned issues (the maximum allowed).\nPlease complete or unassign one of your current issues before claiming another.\n\n${issueList}`,
     });
     return;
   }

CONTRIBUTING.md

@@ -153,7 +153,7 @@ The accuracy engine lives in `utils/time.ts` and `lib/calculate.ts`.
 CommitPulse uses a custom, lightweight **GitHub Actions** automation system to manage issues fairly. This ensures that everyone (especially during events like **GSSoC**) gets a chance to contribute and prevents "issue hoarding".
 
 > [!IMPORTANT]
-> **The Golden Rule:** You can only be assigned to **ONE** open issue at a time. Finish it or unassign yourself before claiming another.
+> **The Golden Rule:** You can be assigned to a maximum of **3** open issues at a time. Complete or unassign yourself from one before claiming more.
 
 ### 📋 Structured Issue Templates
 
@@ -205,7 +205,7 @@ To keep the project moving, assignments are not permanent.
 If the bot rejects your command, check these common scenarios:
 
 - **"Commands cannot be used on closed issues"**: You cannot claim, assign, or unassign on closed issues. Find an open one!
-- **"You already have an active assigned issue"**: You must finish your current task. If you're stuck, ask a maintainer to `/unassign` you from the old one.
+- **"You already have X/3 active assigned issues"**: You have reached the maximum of 3 concurrent assignments. Finish one of your current tasks before claiming a new issue. If you're stuck, ask a maintainer to `/unassign` you from one.
 - **"This issue is already assigned to @username"**: Be faster next time! Look for issues without assignees.
 - **"Only the author of this issue can claim it"**: You tried to `/claim` an issue you did not create. You can only claim issues that you authored.
 - **"The following label(s) do not exist"**: You can only add existing repo labels. The bot will reply with a list of valid labels you can use.