@homelab.org/git-ghost 1.0.7

package/.github/workflows/publish.yml

@@ -0,0 +1,36 @@
+name: Publish to npm and GitHub Packages
+
+on:
+  push:
+    tags:
+      - 'v*'  # Se activa cuando pusheas un tag v1.0.2
+
+jobs:
+  publish-npm:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+      - run: npm ci
+      - run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+  publish-github:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://npm.pkg.github.com'
+      - run: npm ci
+      - run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/README.md

@@ -0,0 +1,318 @@
+# 👻 GitGhost
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/MikeDMart/GitGhost/main/assets/logo.png" alt="GitGhost Logo" width="180">
+</p>
+
+<p align="center">
+  <strong>Automatically detect duplicate files, orphaned images, and dead dependencies — then ship a clean PR.</strong>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/version-1.0.0-blue?style=flat-square">
+  <img src="https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen?style=flat-square">
+  <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square">
+  <img src="https://img.shields.io/badge/PRs-welcome-brightgreen?style=flat-square">
+  <img src="https://img.shields.io/npm/dm/@mikedmart93/git-ghost?style=flat-square">
+</p>
+
+---
+
+## What is GitGhost?
+
+GitGhost is a zero-config CLI tool that audits your repository for things that shouldn't be there — duplicate files, images nobody references, and npm packages nobody imports. When it finds them, it opens a Pull Request with everything cleaned up, so your team can review before anything gets deleted for good.
+
+Nothing is permanently removed without your approval. Ghost files move to `.ghost/` for safe recovery. Duplicates stay in place until the PR is merged. Your repo stays clean without the risk.
+
+---
+
+## Features
+
+| | Feature | Description |
+|---|---|---|
+| 🔍 | **Duplicate detection** | Finds files with identical content using MD5 hashing |
+| 🖼️ | **Orphaned images** | Detects images not referenced in any HTML, CSS, or JS file |
+| 📦 | **Dead dependencies** | Identifies npm packages installed but never imported |
+| 🌿 | **Auto branch** | Creates a timestamped cleanup branch automatically |
+| 📬 | **Auto PR** | Opens a Pull Request on GitHub via the `gh` CLI |
+| ♻️ | **Safe restore** | Recovers any file moved to `.ghost/` with one command |
+| 📊 | **History** | Shows a log of every cleanup ever run on the repo |
+| 🚀 | **CI/CD mode** | GitHub Actions integration *(coming soon)* |
+
+---
+
+## Installation
+
+**Via npm (recommended)**
+```bash
+npm install -g @mikedmart93/git-ghost
+```
+
+**Via GitHub**
+```bash
+git clone https://github.com/MikeDMart/GitGhost.git
+cd GitGhost
+npm link
+```
+
+**Without installing**
+```bash
+npx github:MikeDMart/GitGhost audit
+```
+
+**Verify**
+```bash
+git-ghost --version
+# git-ghost v1.0.0
+```
+
+> **Requires** [GitHub CLI (`gh`)](https://cli.github.com/) for the `--pr` flag. Install it and run `gh auth login` once.
+
+---
+
+## Quick Start
+
+```bash
+# Step into your project
+cd /path/to/your/repo
+
+# See what's haunting it (read-only, nothing changes)
+git-ghost audit
+
+# Fix everything and open a PR for review
+git-ghost fix --pr
+```
+
+That's it. Review the PR, restore anything you want back, merge when ready.
+
+---
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `git-ghost audit` | Scan and report — no changes made |
+| `git-ghost fix` | Apply fixes on a new local branch |
+| `git-ghost fix --pr` | Apply fixes and open a GitHub Pull Request |
+| `git-ghost restore <file>` | Recover a file from `.ghost/` |
+| `git-ghost history` | Show all previous cleanup commits |
+| `git-ghost help` | Show usage information |
+
+---
+
+## How it works
+
+### Audit
+
+GitGhost scans your working directory and reports three categories of findings:
+
+**Duplicate files** — reads every `.js`, `.css`, `.html`, `.json`, and `.md` file, hashes the content with MD5, and flags any file whose hash matches another. The first occurrence is kept; duplicates are marked for removal.
+
+**Orphaned images** — finds every `.png`, `.jpg`, `.jpeg`, `.gif`, `.svg`, and `.webp` file, then checks whether its filename or path appears anywhere in your source code. If nothing references it, it's a ghost.
+
+**Dead dependencies** — reads `dependencies` and `devDependencies` from `package.json` and checks whether each package name appears in a `require()` or `import` statement anywhere in your JS/TS files. If it doesn't, it's flagged.
+
+### Fix
+
+When you run `git-ghost fix`:
+
+1. Creates a branch named `fix/git-ghost-<timestamp>`
+2. Moves orphaned images to `.ghost/` (preserving directory structure)
+3. Deletes confirmed duplicate files (keeping the first occurrence)
+4. Commits all changes with a detailed message
+5. Pushes the branch to origin
+6. Optionally opens a Pull Request with a review checklist
+
+Nothing in `.ghost/` is deleted — it's a quarantine folder, not a trash can.
+
+---
+
+## Examples
+
+### Basic audit
+
+```
+$ git-ghost audit
+
+👻 git-ghost audit
+================================
+
+📁 DUPLICATE FILES:
+  📄 styles/main.css
+     identical to: styles/style.css
+  📄 utils/helpers.js
+     identical to: lib/utils.js
+
+🖼️  UNREFERENCED IMAGES:
+  📄 assets/old-logo.png
+  📄 images/backup/banner.jpg
+
+📦 ORPHANED DEPENDENCIES:
+  📦 lodash
+  📦 moment
+
+💡 Tip:
+  Run git-ghost fix --pr to open a PR with all fixes applied
+```
+
+### Automated cleanup with PR
+
+```
+$ git-ghost fix --pr
+
+👻 git-ghost fix
+================================
+
+📊 Running audit...
+
+📋 Fix summary:
+  🗑️  Duplicates:            2
+  👻 Unreferenced images:   2
+  📦 Orphaned dependencies: 2
+
+🌿 Creating branch: fix/git-ghost-1743872154321
+
+🔧 Applying fixes...
+  👻 assets/old-logo.png → .ghost/assets/old-logo.png
+  👻 images/backup/banner.jpg → .ghost/images/backup/banner.jpg
+  🗑️  Removed: styles/main.css
+  🗑️  Removed: utils/helpers.js
+
+📝 Creating commit...
+📤 Pushing branch...
+📬 Pull Request created: https://github.com/username/my-app/pull/123
+
+✅ Branch ready: fix/git-ghost-1743872154321
+```
+
+### Restoring a file
+
+```
+$ git-ghost restore assets/old-logo.png
+
+👻 git-ghost restore
+================================
+
+✅ Restored: assets/old-logo.png
+
+💡 To commit the restoration:
+  git add assets/old-logo.png
+  git commit -m "restore: recover assets/old-logo.png"
+```
+
+### Viewing history
+
+```
+$ git-ghost history
+
+👻 git-ghost history
+================================
+
+📋 Previous cleanups:
+
+4a3c235 2026-04-05 chore: automated cleanup via git-ghost
+2778562 2026-04-05 feat: v1 git-ghost
+3f2a1b4 2026-04-04 chore: remove unused dependency simple-git
+
+👻 Files currently in .ghost/: 21
+💡 To restore: git-ghost restore <file>
+```
+
+---
+
+## Project structure
+
+```
+GitGhost/
+├── bin/
+│   └── git-ghost.js      # CLI entry point
+├── lib/
+│   ├── audit.js          # Scan and report
+│   ├── fix.js            # Apply fixes and create PR
+│   ├── restore.js        # Recover files from .ghost/
+│   ├── history.js        # Show cleanup log
+│   └── utils.js          # File scanning and hashing logic
+├── .gitignore
+├── package.json
+└── README.md
+```
+
+---
+
+## Workflow
+
+```
+your repo
+    │
+    ▼
+git-ghost audit          ← read-only scan, nothing changes
+    │
+    ▼
+git-ghost fix --pr       ← branch created, fixes applied, PR opened
+    │
+    ▼
+review PR on GitHub      ← check what was removed, restore if needed
+    │
+    ▼
+merge                    ← repo is clean
+```
+
+If anything was removed by mistake:
+
+```
+git-ghost restore <file>    ← pulls it back from .ghost/
+git add <file>
+git commit -m "restore: recover <file>"
+```
+
+---
+
+## Tech stack
+
+- **Node.js** — runtime
+- **glob** — recursive file pattern matching
+- **crypto** — MD5 hashing for duplicate detection
+- **child_process** — git and gh CLI integration
+- **fs / path** — file operations and ghost quarantine
+
+---
+
+## Contributing
+
+Contributions are welcome. Here's how:
+
+```bash
+# Fork the repo, then:
+git checkout -b feature/your-feature
+git commit -m 'feat: describe your change'
+git push origin feature/your-feature
+# Open a Pull Request
+```
+
+Found a bug? Open an issue in the [issue tracker](https://github.com/MikeDMart/GitGhost/issues).
+
+---
+
+## Roadmap
+
+- [ ] Support for more file types (PDF, DOC, SVG sprites)
+- [ ] GitHub Actions integration for automated CI runs
+- [ ] HTML audit reports
+- [ ] GitLab and Bitbucket support
+- [ ] Config file (`.ghostrc`) for custom ignore patterns
+
+---
+
+## License
+
+MIT © [MikeDMart](https://github.com/MikeDMart)
+
+---
+
+<p align="center">
+  <a href="https://github.com/MikeDMart/GitGhost">⭐ Star on GitHub</a>
+  &nbsp;·&nbsp;
+  <a href="https://github.com/MikeDMart/GitGhost/issues">🐛 Report a bug</a>
+  &nbsp;·&nbsp;
+  <a href="https://github.com/MikeDMart/GitGhost/issues">💡 Request a feature</a>
+</p>

package/bin/git-ghost.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+
+const { execSync } = require('child_process');
+
+const colors = {
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    gray: '\x1b[90m',
+    reset: '\x1b[0m'
+};
+
+const command = process.argv[2];
+
+if (!command || command === 'help' || command === '--help') {
+    console.log(`
+${colors.blue}git-ghost v1.0.0${colors.reset}
+${colors.gray}Repository cleanup tool${colors.reset}
+
+${colors.yellow}Usage:${colors.reset}
+  git-ghost audit               # Detect issues (read-only, no changes)
+  git-ghost fix                 # Create local branch with fixes
+  git-ghost fix --pr            # Create branch + Pull Request
+  git-ghost restore <file>      # Restore a file from .ghost/
+  git-ghost history             # Show cleanup history
+
+${colors.yellow}Examples:${colors.reset}
+  git-ghost audit
+  git-ghost fix --pr
+  git-ghost restore styles/old.css
+`);
+    process.exit(0);
+}
+
+try {
+    execSync('git rev-parse --git-dir', { stdio: 'ignore' });
+} catch {
+    console.log(`${colors.red}❌ Not inside a Git repository${colors.reset}`);
+    process.exit(1);
+}
+
+switch (command) {
+    case 'audit':
+        require('../lib/audit')();
+        break;
+    case 'fix':
+        const createPR = process.argv.includes('--pr');
+        require('../lib/fix')({ createPR });
+        break;
+    case 'restore':
+        const file = process.argv[3];
+        require('../lib/restore')(file);
+        break;
+    case 'history':
+        require('../lib/history')();
+        break;
+    default:
+        console.log(`${colors.red}❌ Unknown command: ${command}${colors.reset}`);
+        console.log(`Run 'git-ghost help' to see available commands`);
+        process.exit(1);
+}

package/lib/audit.js

@@ -0,0 +1,60 @@
+const utils = require('./utils');
+
+const colors = {
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    gray: '\x1b[90m',
+    reset: '\x1b[0m'
+};
+
+module.exports = async function audit() {
+    console.log(`
+${colors.blue}👻 git-ghost audit${colors.reset}
+${colors.gray}================================${colors.reset}
+`);
+
+    // Duplicate files
+    console.log(`${colors.yellow}📁 DUPLICATE FILES:${colors.reset}`);
+    const duplicates = utils.findDuplicateFiles();
+    if (duplicates.length === 0) {
+        console.log(`  ${colors.green}✅ No duplicates found${colors.reset}`);
+    } else {
+        duplicates.forEach(dup => {
+            console.log(`  ${colors.red}📄${colors.reset} ${dup.file}`);
+            console.log(`     ${colors.gray}identical to: ${dup.duplicateOf}${colors.reset}`);
+        });
+    }
+
+    console.log('');
+
+    // Unreferenced images
+    console.log(`${colors.yellow}🖼️  UNREFERENCED IMAGES:${colors.reset}`);
+    const unusedImages = utils.findUnusedImages();
+    if (unusedImages.length === 0) {
+        console.log(`  ${colors.green}✅ All images are referenced${colors.reset}`);
+    } else {
+        unusedImages.forEach(img => {
+            console.log(`  ${colors.gray}📄${colors.reset} ${img}`);
+        });
+    }
+
+    console.log('');
+
+    // Orphaned dependencies
+    console.log(`${colors.yellow}📦 ORPHANED DEPENDENCIES:${colors.reset}`);
+    const unusedDeps = utils.findUnusedDependencies();
+    if (unusedDeps.length === 0) {
+        console.log(`  ${colors.green}✅ All dependencies are in use${colors.reset}`);
+    } else {
+        unusedDeps.forEach(dep => {
+            console.log(`  ${colors.gray}📦${colors.reset} ${dep}`);
+        });
+    }
+
+    console.log('');
+    console.log(`${colors.blue}💡 Tip:${colors.reset}`);
+    console.log(`  Run ${colors.green}git-ghost fix --pr${colors.reset} to open a PR with all fixes applied`);
+    console.log('');
+};

package/lib/fix.js

@@ -0,0 +1,122 @@
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const utils = require('./utils');
+
+const colors = {
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    red: '\x1b[31m',
+    gray: '\x1b[90m',
+    reset: '\x1b[0m'
+};
+
+const BRANCH_NAME = `fix/git-ghost-${Date.now()}`;
+const GHOST_DIR = '.ghost';
+
+module.exports = async function fix({ createPR = false }) {
+    console.log(`
+${colors.blue}👻 git-ghost fix${colors.reset}
+${colors.gray}================================${colors.reset}
+`);
+
+    console.log(`${colors.yellow}📊 Running audit...${colors.reset}`);
+    const duplicates = utils.findDuplicateFiles();
+    const unusedImages = utils.findUnusedImages();
+    const unusedDeps = utils.findUnusedDependencies();
+
+    if (duplicates.length === 0 && unusedImages.length === 0 && unusedDeps.length === 0) {
+        console.log(`${colors.green}✅ Nothing to fix — repository is clean${colors.reset}`);
+        return;
+    }
+
+    console.log(`\n${colors.yellow}📋 Fix summary:${colors.reset}`);
+    console.log(`  🗑️  Duplicates:            ${duplicates.length}`);
+    console.log(`  👻 Unreferenced images:   ${unusedImages.length}`);
+    console.log(`  📦 Orphaned dependencies: ${unusedDeps.length}`);
+
+    console.log(`\n${colors.yellow}🌿 Creating branch: ${BRANCH_NAME}${colors.reset}`);
+    try {
+        execSync(`git checkout -b ${BRANCH_NAME}`, { stdio: 'ignore' });
+    } catch {
+        console.log(`${colors.red}❌ Could not create branch — make sure you have no uncommitted changes${colors.reset}`);
+        return;
+    }
+
+    console.log(`\n${colors.yellow}🔧 Applying fixes...${colors.reset}`);
+
+    // Move unreferenced images to .ghost/
+    if (unusedImages.length > 0 && !fs.existsSync(GHOST_DIR)) {
+        fs.mkdirSync(GHOST_DIR, { recursive: true });
+    }
+
+    unusedImages.forEach(img => {
+        const ghostPath = path.join(GHOST_DIR, img);
+        fs.mkdirSync(path.dirname(ghostPath), { recursive: true });
+        if (fs.existsSync(img)) {
+            fs.renameSync(img, ghostPath);
+            console.log(`  👻 ${img} → ${ghostPath}`);
+        }
+    });
+
+    // Remove duplicates (keep the first occurrence)
+    const kept = new Set();
+    let deletedCount = 0;
+    duplicates.forEach(dup => {
+        if (!kept.has(dup.duplicateOf)) {
+            kept.add(dup.duplicateOf);
+        } else if (fs.existsSync(dup.file)) {
+            fs.unlinkSync(dup.file);
+            console.log(`  🗑️  Removed: ${dup.file}`);
+            deletedCount++;
+        }
+    });
+
+    if (deletedCount > 0 || unusedImages.length > 0) {
+        console.log(`\n${colors.yellow}📝 Creating commit...${colors.reset}`);
+        execSync(`git add .`, { stdio: 'ignore' });
+        execSync(`git commit -m "chore: automated cleanup via git-ghost
+
+- ${deletedCount} duplicate file(s) removed
+- ${unusedImages.length} unreferenced image(s) moved to .ghost/
+- ${unusedDeps.length} orphaned dependency/dependencies flagged
+
+Run 'git-ghost restore <file>' to recover any moved file"`, { stdio: 'ignore' });
+
+        console.log(`\n${colors.yellow}📤 Pushing branch...${colors.reset}`);
+        execSync(`git push origin ${BRANCH_NAME}`, { stdio: 'ignore' });
+
+        if (createPR) {
+            console.log(`\n${colors.yellow}📬 Creating Pull Request...${colors.reset}`);
+            try {
+                execSync(`gh pr create \
+                    --title "♻️ Automated cleanup via git-ghost" \
+                    --body "This PR was generated automatically by git-ghost.
+
+### Changes
+- Duplicate files removed
+- Unreferenced images moved to \`.ghost/\`
+- Orphaned dependencies flagged
+
+### Review checklist
+- [ ] Verify nothing critical was removed
+- [ ] Restore from \`.ghost/\` if needed (\`git-ghost restore <file>\`)
+- [ ] Approve or close" \
+                    --base main \
+                    --head ${BRANCH_NAME}`, { stdio: 'inherit' });
+            } catch {
+                console.log(`${colors.yellow}⚠️  Could not create PR automatically. Run manually:${colors.reset}`);
+                console.log(`   gh pr create --base main --head ${BRANCH_NAME}`);
+            }
+        } else {
+            console.log(`\n${colors.green}✅ Branch ready: ${BRANCH_NAME}${colors.reset}`);
+            console.log(`${colors.blue}💡 To open a PR manually:${colors.reset}`);
+            console.log(`   gh pr create --base main --head ${BRANCH_NAME}`);
+        }
+    } else {
+        console.log(`${colors.yellow}⚠️  No file changes were made${colors.reset}`);
+    }
+
+    console.log('');
+};

package/lib/history.js

@@ -0,0 +1,43 @@
+const fs = require('fs');
+const { execSync } = require('child_process');
+
+const colors = {
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    red: '\x1b[31m',
+    gray: '\x1b[90m',
+    reset: '\x1b[0m'
+};
+
+module.exports = function history() {
+    console.log(`
+${colors.blue}👻 git-ghost history${colors.reset}
+${colors.gray}================================${colors.reset}
+`);
+
+    try {
+        const commits = execSync(
+            `git log --oneline --grep="git-ghost" --format="%h %ad %s" --date=short`,
+            { encoding: 'utf-8' }
+        );
+
+        if (commits.trim() === '') {
+            console.log(`${colors.yellow}📭 No previous cleanups found${colors.reset}`);
+            console.log(`\n${colors.blue}💡 Run 'git-ghost fix --pr' to create your first cleanup${colors.reset}`);
+        } else {
+            console.log(`${colors.green}📋 Previous cleanups:${colors.reset}\n`);
+            console.log(commits);
+        }
+
+        if (fs.existsSync('.ghost')) {
+            const count = execSync(`find .ghost -type f | wc -l`, { encoding: 'utf-8' }).trim();
+            console.log(`\n${colors.yellow}👻 Files currently in .ghost/: ${count}${colors.reset}`);
+            console.log(`${colors.blue}💡 To restore: git-ghost restore <file>${colors.reset}`);
+        }
+
+        console.log('');
+    } catch {
+        console.log(`${colors.red}❌ Could not retrieve history${colors.reset}`);
+    }
+};

package/lib/restore.js

@@ -0,0 +1,59 @@
+const fs = require('fs');
+const path = require('path');
+
+const colors = {
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    red: '\x1b[31m',
+    gray: '\x1b[90m',
+    reset: '\x1b[0m'
+};
+
+const GHOST_DIR = '.ghost';
+
+module.exports = function restore(file) {
+    console.log(`
+${colors.blue}👻 git-ghost restore${colors.reset}
+${colors.gray}================================${colors.reset}
+`);
+
+    if (!file) {
+        console.log(`${colors.red}❌ Please specify a file to restore${colors.reset}`);
+        console.log(`${colors.yellow}Usage: git-ghost restore <file>${colors.reset}`);
+        console.log(`Example: git-ghost restore styles/old.css`);
+        process.exit(1);
+    }
+
+    const ghostPath = path.join(GHOST_DIR, file);
+
+    if (!fs.existsSync(ghostPath)) {
+        console.log(`${colors.red}❌ File not found in .ghost/: ${file}${colors.reset}`);
+
+        if (fs.existsSync(GHOST_DIR)) {
+            console.log(`\n${colors.yellow}📁 Available files in .ghost/:${colors.reset}`);
+            const listFiles = (dir, prefix = '') => {
+                fs.readdirSync(dir).forEach(item => {
+                    const fullPath = path.join(dir, item);
+                    const rel = path.join(prefix, item);
+                    if (fs.statSync(fullPath).isDirectory()) {
+                        listFiles(fullPath, rel);
+                    } else {
+                        console.log(`  ${colors.gray}📄${colors.reset} ${rel}`);
+                    }
+                });
+            };
+            listFiles(GHOST_DIR);
+        }
+        process.exit(1);
+    }
+
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.renameSync(ghostPath, file);
+
+    console.log(`${colors.green}✅ Restored: ${file}${colors.reset}`);
+    console.log(`\n${colors.blue}💡 To commit the restoration:${colors.reset}`);
+    console.log(`  git add ${file}`);
+    console.log(`  git commit -m "restore: recover ${file}"`);
+    console.log('');
+};

package/lib/utils.js

@@ -0,0 +1,66 @@
+const fs = require('fs');
+const path = require('path');
+const glob = require('glob');
+const crypto = require('crypto');
+
+const IGNORE = ['node_modules/**', '.git/**', '.ghost/**'];
+
+function findDuplicateFiles() {
+    const files = glob.sync('**/*.{js,css,html,json,md}', { ignore: IGNORE });
+
+    const contentMap = new Map();
+    const duplicates = [];
+
+    for (const file of files) {
+        try {
+            const content = fs.readFileSync(file, 'utf-8');
+            const hash = crypto.createHash('md5').update(content).digest('hex');
+
+            if (contentMap.has(hash)) {
+                duplicates.push({ file, duplicateOf: contentMap.get(hash) });
+            } else {
+                contentMap.set(hash, file);
+            }
+        } catch {}
+    }
+
+    return duplicates;
+}
+
+function findUnusedImages() {
+    const images = glob.sync('**/*.{png,jpg,jpeg,gif,svg,webp}', { ignore: IGNORE });
+    const sourceFiles = glob.sync('**/*.{html,css,js,jsx,ts,tsx,json,md}', { ignore: IGNORE });
+
+    return images.filter(img => {
+        const basename = path.basename(img);
+        return !sourceFiles.some(file => {
+            try {
+                const content = fs.readFileSync(file, 'utf-8');
+                return content.includes(basename) || content.includes(img);
+            } catch { return false; }
+        });
+    });
+}
+
+function findUnusedDependencies() {
+    if (!fs.existsSync('package.json')) return [];
+
+    const pkg = JSON.parse(fs.readFileSync('package.json', 'utf-8'));
+    const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+    const sourceFiles = glob.sync('**/*.{js,jsx,ts,tsx}', { ignore: IGNORE });
+
+    return Object.keys(deps).filter(dep =>
+        !sourceFiles.some(file => {
+            try {
+                const content = fs.readFileSync(file, 'utf-8');
+                return (
+                    content.includes(`require('${dep}')`) ||
+                    content.includes(`from '${dep}'`) ||
+                    content.includes(`from "${dep}"`)
+                );
+            } catch { return false; }
+        })
+    );
+}
+
+module.exports = { findDuplicateFiles, findUnusedImages, findUnusedDependencies };

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@homelab.org/git-ghost",
+  "version": "1.0.7",
+  "description": "Detects ghost files, duplicates, and orphaned dependencies — and opens a PR to clean them up",
+  "bin": {
+    "git-ghost": "bin/git-ghost.js"
+  },
+  "keywords": [
+    "git",
+    "cleaner",
+    "pr",
+    "audit",
+    "duplicates",
+    "unused",
+    "dependencies"
+  ],
+  "author": "MikeDMart",
+  "license": "MIT",
+  "dependencies": {
+    "glob": "^10.3.10"
+  },
+  "main": "index.js",
+  "directories": {
+    "lib": "lib"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "type": "commonjs"
+}