repomeld 3.0.4 → 3.0.5

package/README.md

@@ -1,32 +1,78 @@
 # repomeld 🔥
 
-> Meld your entire repo into a single file — perfect for AI context, code reviews & sharing.
+> Turn your entire codebase into a single AI-ready file — in seconds.
 
 [![npm version](https://badge.fury.io/js/repomeld.svg)](https://www.npmjs.com/package/repomeld)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
+Works with:
+
+| ChatGPT | Claude | Gemini | Cursor | Windsurf |
+|---------|--------|--------|--------|----------|
+| ✅ | ✅ | ✅ | ✅ | ✅ |
+
 ---
 
-> ## 💼 Open to Work
-> **The author is available for freelance & full-time work.**
-> 📧 [susheelhbti@gmail.com](mailto:susheelhbti@gmail.com) — reach out anytime!
+## The Problem
+
+AI tools are powerful — but they struggle with large repositories.
+
+Copying files manually is:
+- **Slow** — jumping between files, copy-pasting one by one
+- **Error-prone** — missing imports, missing context, wrong versions
+- **Incomplete** — AI sees fragments, not the full picture
+
+The result? Vague suggestions. Wrong answers. Wasted time.
 
 ---
 
-## ✨ Features
+## The Solution
 
-- 🚀 **Fast & Efficient** - Async scanning with real-time progress and binary caching
-- 🎨 **Multiple Styles** - Banner, Markdown, or Minimal output
-- 🔍 **Smart Filtering** - Extension, pattern, and size-based filtering
-- 📁 **Gitignore Support** - Respects your .gitignore rules automatically
-- 💾 **Binary Detection** - Intelligent caching for binary file detection
-- 📦 **Single File Output** - Perfect for AI context windows
-- 🔄 **Auto-Numbering** - Never overwrites existing files
-- 💿 **Zip Backup** - Creates auto-numbered backups in `repomeld_zips/` folder
-- 🔔 **Update Notifications** - Non-intrusive version checking
-- 🎯 **Force Include** - Override ignore rules when needed
-- 📊 **Dependency Graph** - Optional Mermaid diagram of file dependencies
-- 🌍 **Cross-Platform** - Works perfectly on Windows, macOS, and Linux
+```bash
+npx repomeld
+```
+
+repomeld scans your entire repository and produces a single, clean, AI-ready document containing:
+
+✅ Project structure  
+✅ All source code  
+✅ Dependencies and config  
+✅ Optional Mermaid dependency diagrams  
+✅ Clean context — nothing AI doesn't need  
+
+One file. Paste it. Ask anything.
+
+---
+
+## Demo
+
+```bash
+npx repomeld --style markdown --output context.md
+```
+
+Upload `context.md` to ChatGPT, Claude, or Gemini and ask:
+
+> *"Review my project and suggest improvements."*
+
+Or drop it into Cursor / Windsurf as project context before starting a session.
+
+---
+
+## Why repomeld Instead of repomix?
+
+Many developers discover this category by searching for repomix. Here's how repomeld compares:
+
+| Feature | repomeld | repomix |
+|---|---|---|
+| Auto-numbered outputs (never overwrites) | ✅ | ❌ |
+| Automatic backup zip creation | ✅ | ❌ |
+| `repoclean` — one-command artifact cleanup | ✅ | ❌ |
+| Mermaid dependency graph | ✅ | ❌ |
+| Force include support | ✅ | ✅ |
+| Multiple output styles (banner/markdown/minimal) | ✅ | ✅ |
+| Gitignore support | ✅ | ✅ |
+| Binary file detection + caching | ✅ | ✅ |
+| Cross-platform (Windows, macOS, Linux) | ✅ | ✅ |
 
 ---
 
@@ -51,7 +97,25 @@ cd your-project
 repomeld
 ```
 
-That's it. repomeld walks your project, respects `.gitignore`, skips binary files, and writes everything into one readable file with optional dependency graphs.
+repomeld walks your project, respects `.gitignore`, skips binary files, and writes everything into one readable file.
+
+---
+
+## ✨ Features
+
+- 🚀 **Fast & Efficient** - Async scanning with real-time progress and binary caching
+- 🎨 **Multiple Styles** - Banner, Markdown, or Minimal output
+- 🔍 **Smart Filtering** - Extension, pattern, and size-based filtering
+- 📁 **Gitignore Support** - Respects your .gitignore rules automatically
+- 💾 **Binary Detection** - Intelligent caching for binary file detection
+- 📦 **Single File Output** - Perfect for AI context windows
+- 🔄 **Auto-Numbering** - Never overwrites existing files
+- 💿 **Zip Backup** - Creates auto-numbered backups in `repomeld_zips/` folder
+- 🔔 **Update Notifications** - Non-intrusive version checking
+- 🎯 **Force Include** - Override ignore rules when needed
+- 📊 **Dependency Graph** - Optional Mermaid diagram of file dependencies
+- 🧹 **repoclean** - One command to delete all repomeld-generated files and zips
+- 🌍 **Cross-Platform** - Works perfectly on Windows, macOS, and Linux
 
 ---
 
@@ -256,7 +320,83 @@ The zip file contains:
 To disable backups: `repomeld --no-backup`
 
 ---
- 
+
+## 🧹 repoclean — Remove All repomeld Artifacts
+
+After several runs, your project root can accumulate output files and zip backups. `repoclean` removes all of them in one command.
+
+```bash
+repoclean
+```
+
+It finds and deletes everything repomeld creates:
+
+| What gets deleted | Examples |
+|---|---|
+| Output text files | `repomeld_output.txt`, `repomeld_output__2.txt`, ... |
+| Custom-named outputs | `repomeld_myproject.txt` |
+| Backup zip folder | `repomeld_zips/` (entire folder) |
+
+### repoclean Options
+
+```
+Usage: repoclean [options]
+
+Options:
+  -V, --version        Show version number
+  -h, --help           Show help
+  --dry-run            Preview what would be deleted — nothing is removed
+  -y, --yes            Skip confirmation prompt (useful for scripts/CI)
+  -d, --dir <path>     Clean a specific directory instead of cwd
+```
+
+### repoclean Examples
+
+```bash
+# Interactive — lists items and asks for confirmation
+repoclean
+
+# Preview only — shows what would be deleted without removing anything
+repoclean --dry-run
+
+# Skip confirmation (for CI or scripts)
+repoclean --yes
+
+# Clean a specific directory
+repoclean --dir /path/to/project
+
+# Preview a different directory
+repoclean --dry-run --dir ../other-project
+```
+
+### Typical repoclean session
+
+```
+╔══════════════════════════════════════════════════════╗
+║ repoclean v3.1.0                                     ║
+║ Remove all repomeld-generated files 🧹               ║
+╠══════════════════════════════════════════════════════╣
+║ 💼 susheelhbti@gmail.com — Open for work             ║
+╚══════════════════════════════════════════════════════╝
+
+ 📂 Target : /your/project
+
+ 🔍 Found 4 item(s) to remove:
+
+   📄 repomeld_output.txt
+   📄 repomeld_output__2.txt
+   📄 repomeld_output__3.txt
+   📁 repomeld_zips\  (entire folder)
+
+ ⚠️  Delete all 4 item(s)? This cannot be undone. [y/N] y
+
+ ✨ repoclean complete!
+ ─────────────────────────────────────────────────
+ ✅ Deleted : 4 item(s)
+ ─────────────────────────────────────────────────
+```
+
+---
 
 ## Performance Optimizations
 
@@ -320,9 +460,13 @@ repomeld --include src --style markdown --output analysis.md
 # Then render the Mermaid graph in the output
 ```
 
----
-
+### 🧹 Clean Up After AI Sessions
+```bash
+# After multiple repomeld runs, tidy up in one shot
+repoclean
+```
 
+---
 
 ## Development
 
@@ -340,14 +484,12 @@ npm start -- --dry-run
 # Link for global testing
 npm link
 repomeld --help
+repoclean --help
 
 # Run tests
 npm test
 ```
 
----
-
-
 ---
 
 ## Contributing
@@ -362,8 +504,6 @@ Contributions are welcome! Please feel free to submit a Pull Request.
 
 ---
 
-
-
 ## License
 
 MIT © [Susheel](mailto:susheelhbti@gmail.com)
@@ -378,11 +518,10 @@ MIT © [Susheel](mailto:susheelhbti@gmail.com)
 
 ---
 
-> ## 💼 Hire the Author
+> ## 💼 Open to Work
 > Built by a developer available for **freelance and full-time opportunities**.
 > Got a project? Let's talk — 📧 **[susheelhbti@gmail.com](mailto:susheelhbti@gmail.com)**
 
 ---
- 
- 
-**Made with ❤️ for developers who need better context for AI tools**
+
+**Made with ❤️ for developers who need better context for AI tools**

package/bin/repoclean.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+
+const path = require("path");
+const readline = require("readline");
+const { program } = require("commander");
+const { findRepomeldArtifacts, deleteArtifacts } = require("../src/core/cleaner");
+const { getVersion } = require("../src/utils/version");
+
+const { version: VERSION } = getVersion();
+
+function printBanner() {
+  console.log(`
+╔══════════════════════════════════════════════════════╗
+║ repoclean v${VERSION}                                ║
+║ Remove all repomeld-generated files 🧹                ║
+╠══════════════════════════════════════════════════════╣
+║ 💼 susheelhbti@gmail.com — Open for work             ║
+╚══════════════════════════════════════════════════════╝`);
+}
+
+async function confirm(question) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim().toLowerCase());
+    });
+  });
+}
+
+program
+  .name("repoclean")
+  .description("Delete all files and folders created by repomeld")
+  .version(VERSION)
+  .option("--dry-run", "Preview what would be deleted without actually deleting")
+  .option("-y, --yes",  "Skip confirmation prompt and delete immediately")
+  .option("-d, --dir <path>", "Target directory to clean (defaults to cwd)")
+  .action(async (options) => {
+    printBanner();
+
+    const cwd = options.dir ? path.resolve(options.dir) : process.cwd();
+    console.log(`\n 📂 Target : ${cwd}\n`);
+
+    let artifacts;
+    try {
+      artifacts = await findRepomeldArtifacts(cwd);
+    } catch (err) {
+      console.error(`\n❌ Error: ${err.message}`);
+      process.exit(1);
+    }
+
+    const total = artifacts.files.length + artifacts.dirs.length;
+
+    if (total === 0) {
+      console.log(" ✅ Nothing to clean — no repomeld artifacts found.\n");
+      return;
+    }
+
+    // Show what was found
+    console.log(` 🔍 Found ${total} item(s) to remove:\n`);
+    for (const f of artifacts.files) {
+      console.log(`   📄 ${path.relative(cwd, f)}`);
+    }
+    for (const d of artifacts.dirs) {
+      console.log(`   📁 ${path.relative(cwd, d)}${path.sep}  (entire folder)`);
+    }
+    console.log();
+
+    if (options.dryRun) {
+      console.log(" 🧪 Dry run — nothing was deleted.\n");
+      return;
+    }
+
+    // Confirm unless --yes supplied
+    if (!options.yes) {
+      const answer = await confirm(` ⚠️  Delete all ${total} item(s)? This cannot be undone. [y/N] `);
+      if (answer !== "y" && answer !== "yes") {
+        console.log("\n 🚫 Aborted. Nothing was deleted.\n");
+        return;
+      }
+    }
+
+    const { deleted, failed } = await deleteArtifacts(artifacts, false);
+
+    console.log(`\n ✨ repoclean complete!`);
+    console.log(` ─────────────────────────────────────────────────`);
+    console.log(` ✅ Deleted : ${deleted.length} item(s)`);
+    if (failed.length) {
+      console.log(` ❌ Failed  : ${failed.length} item(s)`);
+      for (const f of failed) {
+        console.log(`    • ${path.relative(cwd, f.path)} — ${f.reason}`);
+      }
+    }
+    console.log(` ─────────────────────────────────────────────────\n`);
+
+    if (failed.length) process.exit(1);
+  });
+
+program.parse(process.argv);

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "repomeld",
-  "version": "3.0.4",
+  "version": "3.0.5",
   "description": "Meld your entire repo into a single file — perfect for AI context & code reviews",
   "main": "bin/cli.js",
   "bin": {
-    "repomeld": "bin/cli.js"
+    "repomeld": "bin/cli.js",
+    "repoclean": "bin/repoclean.js"
   },
   "scripts": {
     "start": "node bin/cli.js",

package/src/core/cleaner.js

@@ -0,0 +1,82 @@
+const fs = require("fs").promises;
+const fsSync = require("fs");
+const path = require("path");
+
+/**
+ * Finds all repomeld-generated files and folders in cwd.
+ *
+ * repomeld creates:
+ *   - repomeld_output.txt
+ *   - repomeld_output__2.txt, repomeld_output__3.txt, ...  (any custom --output name too)
+ *   - repomeld_zips/  (entire folder)
+ *
+ * The rule: anything whose name starts with "repomeld" (case-insensitive),
+ * which is exactly the same REPOMELD_PATTERN already used in fileScanner.js.
+ */
+const REPOMELD_PATTERN = /^repomeld/i;
+
+async function findRepomeldArtifacts(cwd) {
+  const files = [];
+  const dirs = [];
+
+  let entries;
+  try {
+    entries = await fs.readdir(cwd, { withFileTypes: true });
+  } catch (err) {
+    throw new Error(`Cannot read directory: ${err.message}`);
+  }
+
+  for (const entry of entries) {
+    if (!REPOMELD_PATTERN.test(entry.name)) continue;
+
+    const fullPath = path.join(cwd, entry.name);
+    if (entry.isDirectory()) {
+      dirs.push(fullPath);
+    } else if (entry.isFile()) {
+      files.push(fullPath);
+    }
+  }
+
+  return { files, dirs };
+}
+
+async function deleteArtifacts({ files, dirs }, dryRun) {
+  const deleted = [];
+  const failed = [];
+
+  for (const filePath of files) {
+    if (dryRun) {
+      deleted.push(filePath);
+      continue;
+    }
+    try {
+      await fs.unlink(filePath);
+      deleted.push(filePath);
+    } catch (err) {
+      failed.push({ path: filePath, reason: err.message });
+    }
+  }
+
+  for (const dirPath of dirs) {
+    if (dryRun) {
+      deleted.push(dirPath);
+      continue;
+    }
+    try {
+      await fs.rm(dirPath, { recursive: true, force: true });
+      deleted.push(dirPath);
+    } catch (err) {
+      // fs.rm may not exist on Node 14 — fall back to rmdir recursive
+      try {
+        fsSync.rmdirSync(dirPath, { recursive: true });
+        deleted.push(dirPath);
+      } catch (err2) {
+        failed.push({ path: dirPath, reason: err2.message });
+      }
+    }
+  }
+
+  return { deleted, failed };
+}
+
+module.exports = { findRepomeldArtifacts, deleteArtifacts };