Merge branch 'main' into fix/debounce-preview-requests-clean

Author: chavanGaneshDatta

.env.local.example

@@ -47,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>

.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;

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

@@ -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/conflict-notifier.yml

@@ -79,35 +79,8 @@ jobs:
                     issue_number: pr.number,
                     labels: [label],
                   });
-                }
-
-                // Check existing comments to enforce a 24-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 TWENTY_FOUR_HOURS_MS = 24 * 60 * 60 * 1000;
-                  if (nowTime - lastCommentTime >= TWENTY_FOUR_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,

.github/workflows/pr-issue-check.yml

@@ -182,7 +182,7 @@ jobs:
             2. **Wait for confirmation** — The bot will confirm your assignment with a ✅ reply.
             3. **Then open your PR** — Link the issue with \`Fixes #${issueNumber}\` in your description.
 
-            > 💡 You can be assigned to up to **3** open issues at a time. Check your current assignments before claiming a new one.
+            > 💡 You can be assigned to up to **5** open issues at a time. Check your current assignments before claiming a new one.
 
             We look forward to your contribution once you're assigned! 🚀`,
                     });

CONTRIBUTING.md

@@ -401,7 +401,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 be assigned to a maximum of **3** open issues at a time. Complete or unassign yourself from one before claiming more.
+> **The Golden Rule:** You can be assigned to a maximum of **5** open issues at a time. Complete or unassign yourself from one before claiming more.
 
 ### 📋 Structured Issue Templates
 
@@ -454,7 +454,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 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, use the `/unclaim` command to unassign yourself from an issue, or ask a maintainer to `/unassign` you.
+- **"You already have X/5 active assigned issues"**: You have reached the maximum of 5 concurrent assignments. Finish one of your current tasks before claiming a new issue. If you're stuck, use the `/unclaim` command to unassign yourself from an issue, or ask a maintainer to `/unassign` you.
 - **"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 (unless the issue was authored by `jhasourav07`, which anyone can claim).
 - **"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.

THEMES.md

@@ -1,4 +1,4 @@
-# 🎨 CommitPulse Themes
+# CommitPulse Themes
 
 All 20 available themes for your CommitPulse badge. Use the `?theme=<slug>` query parameter to apply a theme.
 
@@ -37,7 +37,7 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ## Preview Gallery
 
-### 🌑 Dark (default)
+### Dark (default)
 
 ![dark](https://commitpulse.vercel.app/api/streak?user=jhasourav07&theme=dark)
 
@@ -49,7 +49,7 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ---
 
-### ☀️ Light
+### Light
 
 ![light](https://commitpulse.vercel.app/api/streak?user=jhasourav07&theme=light)
 
@@ -61,7 +61,7 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ---
 
-### ⚡ Neon
+### Neon
 
 ![neon](https://commitpulse.vercel.app/api/streak?user=jhasourav07&theme=neon)
 
@@ -73,7 +73,7 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ---
 
-### 🐙 GitHub
+### GitHub
 
 ![github](https://commitpulse.vercel.app/api/streak?user=jhasourav07&theme=github)
 
@@ -85,7 +85,7 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ---
 
-### 🧛 Dracula
+### Dracula
 
 ![dracula](https://commitpulse.vercel.app/api/streak?user=jhasourav07&theme=dracula)
 
@@ -97,7 +97,7 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ---
 
-### 🌊 Ocean
+### Ocean
 
 ![ocean](https://commitpulse.vercel.app/api/streak?user=jhasourav07&theme=ocean)
 
@@ -109,7 +109,7 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ---
 
-### 🌅 Sunset
+### Sunset
 
 ![sunset](https://commitpulse.vercel.app/api/streak?user=jhasourav07&theme=sunset)
 
@@ -121,7 +121,7 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ---
 
-### 🌲 Forest
+### Forest
 
 ![forest](https://commitpulse.vercel.app/api/streak?user=jhasourav07&theme=forest)
 
@@ -133,7 +133,7 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ---
 
-### 🌸 Rose
+### Rose
 
 ![rose](https://commitpulse.vercel.app/api/streak?user=jhasourav07&theme=rose)
 
@@ -145,7 +145,7 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ---
 
-### ❄️ Nord
+### Nord
 
 ![nord](https://commitpulse.vercel.app/api/streak?user=jhasourav07&theme=nord)
 
@@ -157,7 +157,7 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ---
 
-### 🎵 Synthwave
+### Synthwave
 
 ![synthwave](https://commitpulse.vercel.app/api/streak?user=jhasourav07&theme=synthwave)
 
@@ -169,7 +169,7 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ---
 
-### 🪵 Gruvbox
+### Gruvbox
 
 ![gruvbox](https://commitpulse.vercel.app/api/streak?user=jhasourav07&theme=gruvbox)
 
@@ -181,7 +181,7 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ---
 
-### 🔮 Aurora Cyberpunk
+### Aurora Cyberpunk
 
 ![aurora_cyberpunk](https://commitpulse.vercel.app/api/streak?user=jhasourav07&theme=aurora_cyberpunk)
 
@@ -193,7 +193,7 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ---
 
-### 🔦 High Contrast
+### High Contrast
 
 ![highcontrast](https://commitpulse.vercel.app/api/streak?user=jhasourav07&theme=highcontrast)
 
@@ -205,7 +205,7 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ---
 
-### 🐱 Catppuccin Latte
+### Catppuccin Latte
 
 ![catppuccin_latte](https://commitpulse.vercel.app/api/streak?user=jhasourav07&theme=catppuccin_latte)
 
@@ -217,7 +217,7 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ---
 
-### 🌞 Solarized Light
+### Solarized Light
 
 ![solarized_light](https://commitpulse.vercel.app/api/streak?user=jhasourav07&theme=solarized_light)
 
@@ -229,7 +229,7 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ---
 
-### 🌻 Gruvbox Light
+### Gruvbox Light
 
 ![gruvbox_light](https://commitpulse.vercel.app/api/streak?user=jhasourav07&theme=gruvbox_light)
 
@@ -241,7 +241,7 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ---
 
-### 🏔️ Nord Light
+### Nord Light
 
 ![nord_light](https://commitpulse.vercel.app/api/streak?user=jhasourav07&theme=nord_light)
 
@@ -253,7 +253,7 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ---
 
-### 💠 Cyber Pulse
+### Cyber Pulse
 
 ![cyber-pulse](https://commitpulse.vercel.app/api/streak?user=jhasourav07&theme=cyber-pulse)
 
@@ -265,7 +265,7 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ---
 
-### 🪨 Obsidian
+### Obsidian
 
 ![obsidian](https://commitpulse.vercel.app/api/streak?user=jhasourav07&theme=obsidian)
 
@@ -277,22 +277,22 @@ https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=<slug>
 
 ---
 
-## 🎛️ Custom Theme
+## Custom Theme
 
-Not finding what you want? Build your own using raw color parameters — all values are hex codes **without** the `#` prefix:
+Not finding what you want? Build your own using raw color parameters - all values are hex codes **without** the `#` prefix:
 
 ```
 https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&bg=1a1b27&text=a9b1d6&accent=7aa2f7
 ```
 
 ---
 
-## 🔄 Auto Theme
+## Auto Theme
 
-Automatically switches between light and dark based on the viewer's OS setting — no hex values needed:
+Automatically switches between light and dark based on the viewer's OS setting - no hex values needed:
 
 ```
 https://commitpulse.vercel.app/api/streak?user=YOUR_USERNAME&theme=auto
 ```
 
-> 💡 **Tip:** You can combine `theme=` with individual overrides. For example, `theme=dracula&accent=ff79c6` applies the Dracula theme but swaps only the accent color.
+> **Tip:** You can combine `theme=` with individual overrides. For example, `theme=dracula&accent=ff79c6` applies the Dracula theme but swaps only the accent color.