Merge branch 'main' into test/svg-constants-integrity

Author: amna-sehgal

.env.local.example

@@ -20,8 +20,7 @@
 #   Generate new token (classic)
 #   Required scope: read:user
 # ------------------------------------------------------------
-GITHUB_TOKEN=ghp_your_personal_access_token_here
-
+GITHUB_TOKEN=
 
 # ------------------------------------------------------------
 # REQUIRED — Public site URL
@@ -48,3 +47,19 @@ NEXT_PUBLIC_SITE_URL=http://localhost:3000
 #   4. Replace <password> with your DB user's password
 # ------------------------------------------------------------
 # MONGODB_URI=mongodb+srv://<username>:<password>@cluster.mongodb.net/commitpulse?retryWrites=true&w=majority
+
+# ------------------------------------------------------------
+# OPTIONAL — Upstash Redis / Vercel KV (Distributed Rate Limiting)
+# ------------------------------------------------------------
+# Enables distributed rate limiting across all serverless instances.
+# Without these, rate limiting is per-instance (each Vercel function
+# gets its own counter), which allows N× the intended limit under load.
+#
+# How to get one (free):
+#   1. Create a free Upstash Redis database at https://console.upstash.com
+#   2. Copy the REST API URL and token
+#   3. If using Vercel KV, link it to your project in the Vercel dashboard
+#      — it sets KV_REST_API_URL and KV_REST_API_TOKEN automatically.
+# ------------------------------------------------------------
+# KV_REST_API_URL=https://<your-db>.upstash.io
+# KV_REST_API_TOKEN=<your-token>

.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

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

@@ -10,7 +10,7 @@ async function findExistingAssignments(github, owner, repo, username, currentIss
   return issues.filter((issue) => !issue.pull_request && issue.number !== currentIssueNumber);
 }
 
-const MAX_ASSIGNED_ISSUES = 3;
+const MAX_ASSIGNED_ISSUES = 5;
 
 async function handleAssign({ github, context, username, hasWriteAccess }) {
   const { owner, repo } = context.repo;

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

@@ -10,7 +10,7 @@ async function findExistingAssignments(github, owner, repo, username, currentIss
   return issues.filter((issue) => !issue.pull_request && issue.number !== currentIssueNumber);
 }
 
-const MAX_ASSIGNED_ISSUES = 3;
+const MAX_ASSIGNED_ISSUES = 5;
 
 async function handleClaim({ github, context }) {
   const { owner, repo } = context.repo;
@@ -30,9 +30,10 @@ async function handleClaim({ github, context }) {
 
   const issueAuthor = context.payload.issue.user.login;
 
-  const isAuthorJhasourav07 = issueAuthor.toLowerCase() === 'jhasourav07';
+  const MAINTAINERS = ['jhasourav07', 'aamod007', 'souravjhahind'];
+  const isOpenedByMaintainer = MAINTAINERS.includes(issueAuthor.toLowerCase());
 
-  if (!isAuthorJhasourav07 && commenter.toLowerCase() !== issueAuthor.toLowerCase()) {
+  if (!isOpenedByMaintainer && commenter.toLowerCase() !== issueAuthor.toLowerCase()) {
     await github.rest.issues.createComment({
       owner,
       repo,
@@ -73,7 +74,7 @@ async function handleClaim({ github, context }) {
       owner,
       repo,
       issue_number: issueNumber,
-      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}`,
+      body: `❌ You already have **${existingIssues.length}/${MAX_ASSIGNED_ISSUES}** active assigned issues (the maximum allowed).\nPlease complete or \`/unclaim\` one of your current issues before claiming another.\n\n${issueList}`,
     });
     return;
   }

.github/scripts/issue-management/main.js

@@ -4,6 +4,7 @@ const { handleAssign } = require('./assign-handler');
 const { handleUnassign } = require('./unassign-handler');
 const { handleAddLabel } = require('./addlabel-handler');
 const { handleClaim } = require('./claim-handler');
+const { handleUnclaim } = require('./unclaim-handler');
 
 module.exports = async ({ github, context, core }) => {
   const commentBody = context.payload.comment?.body;
@@ -48,6 +49,9 @@ module.exports = async ({ github, context, core }) => {
       case 'claim':
         await handleClaim({ github, context });
         break;
+      case 'unclaim':
+        await handleUnclaim({ github, context });
+        break;
       case 'ping':
         await github.rest.issues.createComment({
           owner,

.github/scripts/issue-management/parse-command.js

@@ -15,6 +15,9 @@ function parseCommand(commentBody) {
     const claimMatch = line.match(/^\/claim\s*$/i);
     if (claimMatch) return { command: 'claim' };
 
+    const unclaimMatch = line.match(/^\/unclaim\s*$/i);
+    if (unclaimMatch) return { command: 'unclaim' };
+
     const pingMatch = line.match(/^\/ping\s*$/i);
     if (pingMatch) return { command: 'ping' };
 

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

@@ -0,0 +1,44 @@
+async function handleUnclaim({ github, context }) {
+  const { owner, repo } = context.repo;
+  const issueNumber = context.payload.issue.number;
+  const commenter = context.payload.comment.user.login;
+  const issueState = context.payload.issue.state;
+
+  if (issueState === 'closed') {
+    await github.rest.issues.createComment({
+      owner,
+      repo,
+      issue_number: issueNumber,
+      body: `❌ Commands cannot be used on closed issues.`,
+    });
+    return;
+  }
+
+  const currentAssignees = context.payload.issue.assignees.map((a) => a.login.toLowerCase());
+
+  if (!currentAssignees.includes(commenter.toLowerCase())) {
+    await github.rest.issues.createComment({
+      owner,
+      repo,
+      issue_number: issueNumber,
+      body: `ℹ️ @${commenter}, you are not currently assigned to this issue, so there's nothing to unclaim.`,
+    });
+    return;
+  }
+
+  await github.rest.issues.removeAssignees({
+    owner,
+    repo,
+    issue_number: issueNumber,
+    assignees: [commenter],
+  });
+
+  await github.rest.issues.createComment({
+    owner,
+    repo,
+    issue_number: issueNumber,
+    body: `✅ Successfully unclaimed this issue for @${commenter}.\n\n> 🔓 The issue is now open for others to claim.`,
+  });
+}
+
+module.exports = { handleUnclaim };

.github/workflows/assign-request-reminder.yml

@@ -42,7 +42,7 @@ jobs:
         contains(github.event.comment.body, 'can i be assigned') ||
         contains(github.event.comment.body, 'assign me to this') ||
         contains(github.event.comment.body, 'assign me this') ||
-        contains(github.event.comment.body, 'i will work on this') ||
+        contains(github.event.comment.body, 'work on this') ||
         contains(github.event.comment.body, 'i''ll work on this') ||
         contains(github.event.comment.body, 'ill work on this') ||
         contains(github.event.comment.body, 'i can work on this') ||
@@ -93,7 +93,7 @@ jobs:
               ``,
               `## 📋 A Few Things to Know`,
               ``,
-              `- You can hold a **maximum of 3 open issues** at a time.`,
+              `- You can hold a **maximum of 5 open issues** at a time.`,
               `- If there's **no activity for 3 days**, the assignment will automatically expire so others can pick it up.`,
               `- Make sure to read our **[CONTRIBUTING.md](https://github.com/${owner}/${repo}/blob/main/CONTRIBUTING.md)** before you start — it covers code style, commit conventions, and the PR checklist.`,
               ``,

.github/workflows/ci.yml

@@ -5,6 +5,7 @@ on:
     branches: [main, dev]
   pull_request:
     branches: [main, dev]
+  merge_group: # Run CI on the merged commit before it lands on main
 
 jobs:
   quality:

.github/workflows/conflict-notifier.yml

@@ -2,7 +2,12 @@ name: Merge Conflict Notifier
 
 on:
   schedule:
-    - cron: '*/5 * * * *'
+    - cron: '*/30 * * * *' # Hourly/half-hourly fallback
+  push:
+    branches:
+      - main
+  pull_request_target:
+    types: [synchronize, reopened, edited]
   workflow_dispatch:
 
 permissions:
@@ -74,35 +79,8 @@ jobs:
                     issue_number: pr.number,
                     labels: [label],
                   });
-                }
-
-                // Check existing comments to enforce a 2-hour notification gap
-                const { data: comments } = await github.rest.issues.listComments({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  issue_number: pr.number,
-                  per_page: 100,
-                });
-
-                const conflictComments = comments.filter(c =>
-                  c.user?.login === 'github-actions[bot]' &&
-                  c.body?.includes('merge conflicts with the main branch')
-                );
-
-                let shouldComment = false;
-                if (conflictComments.length === 0) {
-                  shouldComment = true;
-                } else {
-                  const lastComment = conflictComments[conflictComments.length - 1];
-                  const lastCommentTime = new Date(lastComment.created_at).getTime();
-                  const nowTime = new Date().getTime();
-                  const TWO_HOURS_MS = 2 * 60 * 60 * 1000;
-                  if (nowTime - lastCommentTime >= TWO_HOURS_MS) {
-                    shouldComment = true;
-                  }
-                }
 
-                if (shouldComment) {
+                  // Post notification comment ONLY ONCE (when the label is first applied)
                   await github.rest.issues.createComment({
                     owner: context.repo.owner,
                     repo: context.repo.repo,