feat: add clean-branch script to automatically remove stale git branches

Author: mkzopio

package.json

@@ -42,7 +42,8 @@
     "clean": "git clean -xdf node_modules",
     "clean-cache": "node scripts/clean-with-deps.js clean-cache",
     "clean-hard": "node scripts/clean-hard.js --no-install",
-    "clean-reinstall": "node scripts/clean-hard.js && node scripts/link-vercel.js",
+    "clean-reinstall": "node scripts/clean-hard.js && node scripts/clean-branch.js && node scripts/link-vercel.js",
+    "clean-branch": "node scripts/clean-branch.js",
     "dedupe": "pnpm dedupe",
     "prepare": "husky",
     "// Compliance": "",

scripts/clean-branch.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+/**
+ * SPDX-License-Identifier: MIT
+ */
+
+const { execSync } = require("child_process");
+
+try {
+  console.log("🔄 Fetching and pruning remote branches...");
+  execSync("git fetch -p", { stdio: "inherit" });
+
+  console.log("🔍 Checking for gone branches...");
+  const output = execSync("git branch -vv", { encoding: "utf8" });
+
+  const goneBranches = output
+    .split("\n")
+    .filter((line) => line.includes(": gone]"))
+    .map((line) => line.trim().split(" ")[0]);
+
+  if (goneBranches.length === 0) {
+    console.log("✅ No gone branches found.");
+    process.exit(0);
+  }
+
+  goneBranches.forEach((branch) => {
+    console.log(`🗑️ Deleting local branch: ${branch}`);
+    execSync(`git branch -D ${branch}`, { stdio: "inherit" });
+  });
+
+  console.log("✅ Cleanup complete.");
+} catch (error) {
+  console.error("❌ Error during cleanup:", error.message);
+  process.exit(1);
+}