git-smart-clean 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 husseinjaafar27
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,142 @@
+# git-smart-clean
+
+🧹 Smart cleanup tool for merged git branches
+
+## Installation
+
+```bash
+npm install -g git-smart-clean
+```
+
+## Usage
+
+### Basic Usage
+
+```bash
+# Interactive mode
+git-smart-clean
+
+# Preview without deleting
+git-smart-clean --dry-run
+
+# Exclude specific branches
+git-smart-clean --exclude "main,develop,staging"
+
+# Only branches older than X days
+git-smart-clean --older-than 90
+```
+
+## Options
+
+```bash
+git-smart-clean [options]
+
+Options:
+  -V, --version              output the version number
+  -d, --dry-run              Preview without deleting
+  --older-than <days>        Only branches older than X days
+  --exclude <branches>       Branches to exclude (default: "main,master,develop")
+  -h, --help                 display help for command
+```
+
+## Features
+
+✅ Interactive branch selection  
+✅ Dry-run mode for safety  
+✅ Shows branch age (committed X ago)  
+✅ Color-coded by age (red/yellow/green)  
+✅ Sorted by age (oldest first)  
+✅ Auto-excludes protected branches  
+✅ Beautiful terminal UI  
+✅ Safe confirmation prompts  
+
+## Examples
+
+```bash
+# Basic cleanup
+git-smart-clean
+
+# Preview first (recommended)
+git-smart-clean --dry-run
+
+# Only very old branches
+git-smart-clean --older-than 180
+
+# Exclude custom branches
+git-smart-clean --exclude "main,staging,production,develop"
+
+# Combine options
+git-smart-clean --older-than 90 --exclude "main,dev" --dry-run
+```
+
+## How It Works
+
+1. **Scans** for merged branches in your current repository
+2. **Excludes** protected branches (main, master, develop, and current branch)
+3. **Shows** branch age based on last commit date
+4. **Color codes** by age:
+   - 🔴 Red: Older than 3 months
+   - 🟡 Yellow: 1-3 months old
+   - 🟢 Green: Less than 1 month
+5. **Lets you select** which branches to delete (all pre-selected)
+6. **Confirms** before deleting
+7. **Deletes** selected branches safely
+
+## Screenshots
+
+### Dry Run Mode
+```
+✔ Found 5 merged branches
+
+🔍 DRY RUN - No branches will be deleted
+
+  • feature/old-authentication              (committed 2 months ago)
+  • bugfix/payment-gateway-fix              (committed 3 weeks ago)
+  • hotfix/urgent-security-patch            (committed 2 days ago)
+
+Would delete 3 branches
+```
+
+### Interactive Mode
+```
+✔ Found 5 merged branches
+
+? Select branches to delete (Space to select, Enter to confirm):
+>(*) feature/old-authentication              (committed 2 months ago)
+ (*) bugfix/payment-gateway-fix              (committed 3 weeks ago)
+ ( ) hotfix/urgent-security-patch            (committed 2 days ago)
+```
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/husseinjaafar27/git-smart-clean.git
+cd git-smart-clean
+
+# Install dependencies
+npm install
+
+# Test locally
+npm link
+git-smart-clean --dry-run
+
+# Run in another repo
+cd ~/some-other-repo
+git-smart-clean
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT © husseinjaafar27
+
+## Support
+
+If you find this tool helpful, please ⭐ star the repo!
+
+Found a bug? [Open an issue](https://github.com/husseinjaafar27/git-smart-clean/issues)
+```

package/bin/cli.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+
+import { program } from 'commander';
+import { cleanBranches } from '../src/index.js';
+
+program
+    .name('git-smart-clean')
+    .description('Smart cleanup tool for merged git branches')
+    .version('1.0.0')
+    .option('-d, --dry-run', 'Preview without deleting')
+    .option('--older-than <days>', 'Only branches older than X days', parseInt)
+    .option('--exclude <branches>', 'Branches to exclude (comma-separated)', 'main,master,develop')
+    .action(async (options) => {
+        try {
+            await cleanBranches(options);
+        } catch (error) {
+            console.error('Error:', error.message);
+            process.exit(1);
+        }
+    });
+
+program.parse();

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "git-smart-clean",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Smart cleanup tool for merged git branches",
+  "main": "src/index.js",
+  "bin": {
+    "git-smart-clean": "./bin/cli.js"
+  },
+  "scripts": {
+    "start": "node bin/cli.js"
+  },
+  "keywords": [
+    "git",
+    "cli",
+    "branches",
+    "cleanup",
+    "developer-tools",
+    "git-branches",
+    "merged-branches",
+    "branch-management",
+    "git-tools"
+  ],
+  "author": "husseinjaafar",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/husseinjaafar27/git-smart-clean.git"
+  },
+  "bugs": {
+    "url": "https://github.com/husseinjaafar27/git-smart-clean/issues"
+  },
+  "homepage": "https://github.com/husseinjaafar27/git-smart-clean#readme",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "commander": "^14.0.3",
+    "inquirer": "^8.2.7",
+    "ora": "^9.3.0",
+    "simple-git": "^3.30.0"
+  },
+  "devDependencies": {
+    "jest": "^30.2.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}

package/src/index.js

@@ -0,0 +1,182 @@
+import simpleGit from 'simple-git';
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import ora from 'ora';
+
+// Helper function to format relative time
+function getRelativeTime(date) {
+    const now = new Date();
+    const diffMs = now - date;
+    const diffSeconds = Math.floor(diffMs / 1000);
+    const diffMinutes = Math.floor(diffSeconds / 60);
+    const diffHours = Math.floor(diffMinutes / 60);
+    const diffDays = Math.floor(diffHours / 24);
+    const diffWeeks = Math.floor(diffDays / 7);
+    const diffMonths = Math.floor(diffDays / 30);
+    const diffYears = Math.floor(diffDays / 365);
+
+    if (diffYears > 0) {
+        return `${diffYears} ${diffYears === 1 ? 'year' : 'years'} ago`;
+    } else if (diffMonths > 0) {
+        return `${diffMonths} ${diffMonths === 1 ? 'month' : 'months'} ago`;
+    } else if (diffWeeks > 0) {
+        return `${diffWeeks} ${diffWeeks === 1 ? 'week' : 'weeks'} ago`;
+    } else if (diffDays > 0) {
+        return `${diffDays} ${diffDays === 1 ? 'day' : 'days'} ago`;
+    } else if (diffHours > 0) {
+        return `${diffHours} ${diffHours === 1 ? 'hour' : 'hours'} ago`;
+    } else if (diffMinutes > 0) {
+        return `${diffMinutes} ${diffMinutes === 1 ? 'minute' : 'minutes'} ago`;
+    } else {
+        return 'just now';
+    }
+}
+
+// Color code based on age
+function getAgeColor(date) {
+    const now = new Date();
+    const diffDays = Math.floor((now - date) / (1000 * 60 * 60 * 24));
+
+    if (diffDays > 90) {
+        return chalk.red;      // Red: older than 3 months
+    } else if (diffDays > 30) {
+        return chalk.yellow;   // Yellow: 1-3 months
+    } else {
+        return chalk.green;    // Green: less than 1 month
+    }
+}
+
+export async function cleanBranches(options) {
+    const spinner = ora('Scanning branches...').start();
+    const git = simpleGit();
+
+    try {
+        // Check if we're in a git repository
+        const isRepo = await git.checkIsRepo();
+        if (!isRepo) {
+            spinner.fail('Not a git repository');
+            process.exit(1);
+        }
+
+        // Get current branch
+        const status = await git.status();
+        const currentBranch = status.current;
+
+        // Get merged branches
+        const branchSummary = await git.branch(['--merged']);
+
+        // Parse exclude list
+        const excludeBranches = options.exclude.split(',').map(b => b.trim());
+        excludeBranches.push(currentBranch);
+
+        // Filter branches
+        let mergedBranches = branchSummary.all.filter(branch => {
+            const cleanBranch = branch.replace('remotes/origin/', '').trim();
+            return !excludeBranches.includes(cleanBranch);
+        });
+
+        if (mergedBranches.length === 0) {
+            spinner.succeed('No merged branches to clean up!');
+            return;
+        }
+
+        // Get last commit date for each branch
+        spinner.text = 'Getting branch information...';
+
+        const branchesWithInfo = await Promise.all(
+            mergedBranches.map(async (branch) => {
+                try {
+                    const log = await git.log([branch, '-1']);
+                    const lastCommitDate = log.latest ? new Date(log.latest.date) : new Date();
+                    const relativeTime = getRelativeTime(lastCommitDate);
+
+                    return {
+                        name: branch,
+                        date: lastCommitDate,
+                        relativeTime: `committed ${relativeTime}`
+                    };
+                } catch (error) {
+                    return {
+                        name: branch,
+                        date: new Date(),
+                        relativeTime: 'unknown'
+                    };
+                }
+            })
+        );
+
+        // Sort by date (oldest first)
+        branchesWithInfo.sort((a, b) => a.date - b.date);
+
+        spinner.succeed(`Found ${chalk.bold(branchesWithInfo.length)} merged branches`);
+
+        // Dry run mode
+        if (options.dryRun) {
+            console.log(chalk.yellow('\n🔍 DRY RUN - No branches will be deleted\n'));
+
+            branchesWithInfo.forEach(b => {
+                const ageColor = getAgeColor(b.date);
+                console.log(`  • ${chalk.gray(b.name.padEnd(40))} ${ageColor(`(${b.relativeTime})`)}`);
+            });
+
+            console.log(chalk.yellow(`\nWould delete ${branchesWithInfo.length} branches`));
+            return;
+        }
+
+        // Interactive selection
+        const { selectedBranches } = await inquirer.prompt([{
+            type: 'checkbox',
+            name: 'selectedBranches',
+            message: 'Select branches to delete (Space to select, Enter to confirm):',
+            choices: branchesWithInfo.map(b => {
+                const ageColor = getAgeColor(b.date);
+                const displayName = `${b.name.padEnd(40)} ${ageColor(`(${b.relativeTime})`)}`;
+
+                return {
+                    name: displayName,
+                    value: b.name,
+                    checked: true
+                };
+            }),
+            pageSize: 15
+        }]);
+
+        if (selectedBranches.length === 0) {
+            console.log(chalk.yellow('No branches selected. Exiting.'));
+            return;
+        }
+
+        // Confirm deletion
+        const { confirm } = await inquirer.prompt([{
+            type: 'confirm',
+            name: 'confirm',
+            message: `Delete ${selectedBranches.length} branches?`,
+            default: false
+        }]);
+
+        if (!confirm) {
+            console.log(chalk.yellow('Cancelled. No branches deleted.'));
+            return;
+        }
+
+        // Delete branches
+        console.log('');
+        const deleteSpinner = ora('Deleting branches...').start();
+
+        for (const branch of selectedBranches) {
+            try {
+                await git.deleteLocalBranch(branch, true);
+                console.log(chalk.green(`  ✓ Deleted ${branch}`));
+            } catch (error) {
+                console.log(chalk.red(`  ✗ Failed to delete ${branch}: ${error.message}`));
+            }
+        }
+
+        deleteSpinner.succeed();
+        console.log(chalk.bold.green(`\n✓ Successfully cleaned up ${selectedBranches.length} branches!\n`));
+
+    } catch (error) {
+        spinner.fail('Error occurred');
+        throw error;
+    }
+}