repomeld 2.0.4 → 3.0.0

package/README.md

@@ -2,6 +2,9 @@
 
 > Meld your entire repo into a single file — perfect for AI context, code reviews & sharing.
 
+[![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)
+
 ---
 
 > ## 💼 Open to Work
@@ -10,12 +13,35 @@
 
 ---
 
+## ✨ 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
+- 🌍 **Cross-Platform** - Works perfectly on Windows, macOS, and Linux
+
+---
+
 ## Install
 
 ```bash
 npm install -g repomeld
 ```
 
+Or use without installing:
+
+```bash
+npx repomeld
+```
+
 ---
 
 ## Quick Start
@@ -25,7 +51,7 @@ cd your-project
 repomeld
 ```
 
-That's it. repomeld walks your project, skips noise (node_modules, lock files, build folders, etc.) and writes everything into one readable file.
+That's it. repomeld walks your project, respects `.gitignore`, skips binary files, and writes everything into one readable file with optional dependency graphs.
 
 ---
 
@@ -37,9 +63,13 @@ Every time you run repomeld it creates a **new numbered file** so previous runs
 repomeld_output.txt       ← first run
 repomeld_output__2.txt    ← second run
 repomeld_output__3.txt    ← third run
+repomeld_zips/            ← backup folder
+  ├── repomeld_output.zip
+  ├── repomeld_output__2.zip
+  └── repomeld_output__3.zip
 ```
 
-All previous output files are also **automatically excluded** from the next run's content — so you'll never get repomeld's own output included inside itself.
+All previous output files and zips are **automatically excluded** from the next run — so you'll never get repomeld's own output included inside itself.
 
 ---
 
@@ -76,6 +106,8 @@ Filtering:
   --max-size <kb>               Skip files larger than N kilobytes
                                 Default: 500
 
+  --no-gitignore                Ignore .gitignore file (include everything)
+
 Formatting:
   -s, --style <style>           Header style for each file block:
                                   banner   — clear dividers with file info  (default)
@@ -92,6 +124,8 @@ Advanced:
   --lines-before <n>            Skip the first N lines of every file
   --lines-after <n>             Skip the last N lines of every file
   --dry-run                     Preview which files would be included — nothing is written
+  --no-backup                   Skip creating backup zip file
+  --no-update-check             Skip checking for updates
 ```
 
 ---
@@ -120,6 +154,9 @@ repomeld --dry-run
 # Ignore extra folders on top of defaults
 repomeld --ignore coverage logs tmp
 
+# Respect gitignore (default) or ignore it
+repomeld --no-gitignore  # include everything
+
 # Only small files — skip anything over 100 KB
 repomeld --max-size 100
 
@@ -131,6 +168,9 @@ repomeld --no-toc --no-meta
 
 # Combine filters
 repomeld --ext php --include Controllers --exclude test --style markdown
+
+# Skip backup creation
+repomeld --no-backup
 ```
 
 ---
@@ -147,68 +187,207 @@ repomeld automatically skips these so your output stays clean:
 | Lock files      | `package-lock.json`, `yarn.lock`, `pnpm-lock.yaml` |
 | Build output    | `dist/`, `build/`, `.next/`, `.nuxt/`, `.cache/`   |
 | OS files        | `.DS_Store`                                         |
-| Project meta    | `package.json`, `README.md`                         |
 | repomeld output | `repomeld_output.txt` and all `repomeld_output__N.txt` files |
 
-You can add your own permanent ignore rules via a `repomeld.ignore.json` file (see below).
+**Note:** `package.json` and `README.md` are **NOT** ignored by default — they contain important context for AI tools and code reviews.
 
 ---
 
-## Custom Ignore File
+## Custom Ignore Rules
 
-Create a `repomeld.ignore.json` in your project root:
+### Method 1: repomeld.ignore.json
+
+Create a `repomeld.ignore.json` in your project root for comprehensive ignore patterns:
 
 ```json
 {
+  "_comment": "repomeld.ignore.json — auto-ignored files and folders",
   "ignore": [
     "coverage",
     "logs",
     "tmp",
-    "*.min.js"
+    "*.min.js",
+    "**/generated/**",
+    "vendor/**/bootstrap*",
+    "**/jquery*",
+    "**/fontawesome*"
   ]
 }
 ```
 
 These are merged with the defaults every time repomeld runs.
 
+### Method 2: .gitignore
+
+repomeld automatically respects your `.gitignore` file. Use `--no-gitignore` to override.
+
+### Method 3: CLI --ignore
+
+Override on the command line:
+
+```bash
+repomeld --ignore temp logs "*.tmp"
+```
+
+---
+
+## Backup Zip Files
+
+When repomeld runs, it automatically creates a backup zip file in the `repomeld_zips/` folder:
+
+```
+repomeld_output.txt
+repomeld_zips/
+  └── repomeld_output.zip          ← contains all included files + output
+
+repomeld_output__2.txt
+repomeld_zips/
+  └── repomeld_output__2.zip       ← corresponding backup
+
+repomeld_output__3.txt
+repomeld_zips/
+  └── repomeld_output__3.zip       ← and so on...
+```
+
+The zip file contains:
+- All source files included in the run (preserving folder structure)
+- The repomeld output file itself
+
+To disable backups: `repomeld --no-backup`
+
+---
+ 
+
+## Performance Optimizations
+
+repomeld is optimized for large codebases:
+
+- **Async file scanning** - Non-blocking operations
+- **Binary caching** - Extension-based detection cache
+- **Real-time progress** - Shows ETA and completion percentage
+- **Memory efficient** - Processes files in streams
+- **Smart filtering** - Early filtering to reduce processing
+- **Handles 50,000+ files** - Tested on large monorepos
+
+Example output:
+```
+🔍 Scanning files...
+✅ Found 2453 files in 1.2s
+
+📝 Processing 2453 files...
+
+  Processing: 1245/2453 files (50.7%) | 2.3s elapsed
+  Processing: ✅ Completed 2453/2453 files in 4.7s
+```
+
+**Memory warning** for extremely large repos (>20,000 files):
+```
+⚠️ Large repository detected (~25347 files). Memory usage may be high.
+```
+
 ---
 
-## Output Format
+## Use Cases
 
-Each run produces a file like this:
+### 🤖 AI Context Preparation
+```bash
+repomeld --ext js ts jsx py --style markdown --max-size 200
+```
 
+### 📋 Code Review
+```bash
+repomeld --include src/ --exclude test --style minimal --no-meta
 ```
-# Generated by repomeld v1.0.0
-# Date     : 2025-04-20T10:00:00.000Z
-# Source   : /your/project
-# Files    : 12
-# Lines    : 847
 
-TABLE OF CONTENTS
-════════════════════════════════════════════════════════════
-    1. src/index.js
-    2. src/utils.js
-    3. src/config.js
-   ...
-════════════════════════════════════════════════════════════
+### 💾 Full Project Backup
+```bash
+repomeld --force-include . --max-size 10000 --no-toc --no-meta
+```
 
-────────────────────────────────────────────────────────────
-  FILE: src/index.js  [120 lines | 3.2 KB | javascript]
-────────────────────────────────────────────────────────────
+### 📚 Documentation Generation
+```bash
+repomeld --ext md --include docs --style markdown --output documentation.md
+```
 
-... file contents ...
+### 🔍 Debug Specific Feature
+```bash
+repomeld --include feature-name --ext js css --output feature-context.txt
+```
+
+### 🗺️ Dependency Analysis
+```bash
+repomeld --include src --style markdown --output analysis.md
+# Then render the Mermaid graph in the output
 ```
 
-With `--style markdown` each file becomes a fenced code block — paste directly into Claude, ChatGPT, or any AI tool.
+---
+
+
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/susheel/repomeld.git
+cd repomeld
+
+# Install dependencies
+npm install
+
+# Run locally
+npm start -- --dry-run
+
+# Link for global testing
+npm link
+repomeld --help
+
+# Run tests
+npm test
+```
 
 ---
 
+
+---
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing`)
+5. Open a Pull Request
+
+---
+
+
+
 ## License
 
-MIT
+MIT © [Susheel](mailto:susheelhbti@gmail.com)
+
+---
+
+## Support & Contact
+
+- 🐛 **Issues**: [GitHub Issues](https://github.com/susheel/repomeld/issues)
+- 📧 **Email**: [susheelhbti@gmail.com](mailto:susheelhbti@gmail.com)
+- 💼 **Hire Me**: Available for freelance and full-time opportunities
 
 ---
 
 > ## 💼 Hire the Author
 > Built by a developer available for **freelance and full-time opportunities**.
 > Got a project? Let's talk — 📧 **[susheelhbti@gmail.com](mailto:susheelhbti@gmail.com)**
+
+---
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=susheel/repomeld&type=Date)](https://star-history.com/#susheel/repomeld&Date)
+
+---
+
+**Made with ❤️ for developers who need better context for AI tools**

package/bin/cli.js

@@ -1,382 +1,38 @@
 #!/usr/bin/env node
 
-const fs = require("fs");
-const path = require("path");
 const { program } = require("commander");
-
-const VERSION = "1.0.0";
-
-const DEFAULT_IGNORE = [
-  "node_modules",
-  ".git",
-  ".env",
-  ".env.local",
-  ".env.production",
-  ".DS_Store",
-  "package-lock.json",
-  "yarn.lock",
-  "pnpm-lock.yaml",
-  ".next",
-  ".nuxt",
-  "dist",
-  "build",
-  ".cache",
-  "package.json",
-  "README.md",
-];
-
-function loadIgnoreConfig() {
-  const configPath = path.resolve(process.cwd(), "repomeld.ignore.json");
-  const pkgDir = path.resolve(__dirname, "..", "repomeld.ignore.json");
-  for (const loc of [configPath, pkgDir]) {
-    if (fs.existsSync(loc)) {
-      try {
-        const data = JSON.parse(fs.readFileSync(loc, "utf8"));
-        if (Array.isArray(data.ignore)) {
-          return data.ignore;
-        }
-      } catch {
-        console.warn(`  ⚠️  Could not parse ${loc}, using defaults.`);
-      }
-    }
-  }
-  return [];
-}
-
-const IGNORE_FROM_CONFIG = loadIgnoreConfig();
-
-const LANGUAGE_MAP = {
-  js: "javascript", jsx: "javascript", ts: "typescript", tsx: "typescript",
-  py: "python", rb: "ruby", java: "java", cpp: "cpp", c: "c",
-  cs: "csharp", go: "go", rs: "rust", php: "php", swift: "swift",
-  kt: "kotlin", html: "html", css: "css", scss: "scss", json: "json",
-  yaml: "yaml", yml: "yaml", md: "markdown", sh: "bash", bash: "bash",
-  toml: "toml", xml: "xml", sql: "sql", graphql: "graphql",
-};
-
-function getLanguage(filePath) {
-  const ext = path.extname(filePath).slice(1).toLowerCase();
-  return LANGUAGE_MAP[ext] || "";
-}
-
-function getAllFiles(dirPath, ignoreList, fileList = []) {
-  let entries;
-  try {
-    entries = fs.readdirSync(dirPath, { withFileTypes: true });
-  } catch {
-    return fileList;
-  }
-
-  for (const entry of entries) {
-    const fullPath = path.join(dirPath, entry.name);
-    const relativePath = path.relative(process.cwd(), fullPath);
-
-    if (
-      ignoreList.some(
-        (ig) => entry.name === ig || relativePath.startsWith(ig + path.sep) || relativePath === ig
-      )
-    ) {
-      continue;
-    }
-
-    if (entry.isDirectory()) {
-      getAllFiles(fullPath, ignoreList, fileList);
-    } else if (entry.isFile()) {
-      fileList.push(fullPath);
-    }
-  }
-
-  return fileList;
-}
-
-function isBinaryFile(filePath) {
-  try {
-    const buffer = Buffer.alloc(512);
-    const fd = fs.openSync(filePath, "r");
-    const bytesRead = fs.readSync(fd, buffer, 0, 512, 0);
-    fs.closeSync(fd);
-    for (let i = 0; i < bytesRead; i++) {
-      if (buffer[i] === 0) return true;
-    }
-    return false;
-  } catch {
-    return true;
-  }
-}
-
-function matchesExtensions(filePath, exts) {
-  if (!exts || exts.length === 0) return true;
-  const ext = path.extname(filePath).slice(1).toLowerCase();
-  return exts.map((e) => e.replace(/^\./, "").toLowerCase()).includes(ext);
-}
-
-function matchesPattern(filePath, patterns) {
-  if (!patterns || patterns.length === 0) return false;
-  const rel = path.relative(process.cwd(), filePath);
-  return patterns.some((p) => rel.includes(p) || path.basename(filePath).includes(p));
-}
-
-function formatSize(bytes) {
-  if (bytes < 1024) return `${bytes} B`;
-  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
-  return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
-}
-
-function printBanner() {
-  console.log(`
-╔══════════════════════════════════════════════════════╗
-║              repomeld  v${VERSION}                   ║
-║        Meld your repo into one file 🔥               ║
-╠══════════════════════════════════════════════════════╣
-║  💼 Author available for freelance & full-time work  ║
-║     📧  susheelhbti@gmail.com                        ║
-╚══════════════════════════════════════════════════════╝`);
-}
-
-function buildHeader(style, relativePath, filePath, lineCount, showMeta) {
-  const lang = getLanguage(filePath);
-  const size = formatSize(fs.statSync(filePath).size);
-  const meta = showMeta ? `  [${lineCount} lines | ${size}${lang ? " | " + lang : ""}]` : "";
-
-  if (style === "markdown") {
-    return `\n## 📄 ${relativePath}${meta}\n\n\`\`\`${lang}\n`;
-  }
-  if (style === "minimal") {
-    return `\n# ${relativePath}\n`;
-  }
-  // default: banner style
-  const divider = "─".repeat(60);
-  return `\n${divider}\n  FILE: ${relativePath}${meta}\n${divider}\n\n`;
-}
-
-function buildFooter(style) {
-  if (style === "markdown") return "\n```\n";
-  return "\n";
-}
-
-function buildTableOfContents(files, cwd) {
-  let toc = "TABLE OF CONTENTS\n" + "═".repeat(60) + "\n";
-  files.forEach((f, i) => {
-    const rel = path.relative(cwd, f);
-    toc += `  ${String(i + 1).padStart(3, " ")}. ${rel}\n`;
-  });
-  toc += "═".repeat(60) + "\n\n";
-  return toc;
-}
-
-/**
- * Given a desired output path like "repomeld_output.txt", returns a
- * numbered path that does not yet exist, e.g. "repomeld_output__2.txt".
- * If the base name doesn't exist yet, returns it unchanged.
- */
-function resolveOutputPath(desiredPath) {
-  if (!fs.existsSync(desiredPath)) return desiredPath;
-
-  const ext = path.extname(desiredPath);
-  const base = desiredPath.slice(0, desiredPath.length - ext.length);
-
-  let counter = 2;
-  while (true) {
-    const candidate = `${base}__${counter}${ext}`;
-    if (!fs.existsSync(candidate)) return candidate;
-    counter++;
-  }
-}
-
-/**
- * Returns true if the given filePath looks like a repomeld output file
- * (matches the base name pattern with optional __N suffix).
- */
-function isRepomeldOutput(filePath, baseOutputName) {
-  const fileName = path.basename(filePath);
-  const ext = path.extname(baseOutputName);
-  const base = path.basename(baseOutputName, ext);
-  const pattern = new RegExp(`^${escapeRegex(base)}(__\\d+)?${escapeRegex(ext)}$`);
-  return pattern.test(fileName);
-}
-
-function escapeRegex(str) {
-  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-
-function repomeld(options) {
-  printBanner();
-
-  const cwd = process.cwd();
-
-  // Resolve a unique (non-colliding) output path
-  const desiredOutput = path.resolve(cwd, options.output);
-  const outputFile = resolveOutputPath(desiredOutput);
-  const outputBaseName = path.basename(options.output);
-
-  const forceInclude = options.forceInclude || [];
-  const rawIgnore = [...DEFAULT_IGNORE, ...IGNORE_FROM_CONFIG, ...(options.ignore || [])];
-  const ignoreList = forceInclude.length
-    ? rawIgnore.filter((ig) => !forceInclude.some((fi) => ig.includes(fi) || fi.includes(ig)))
-    : rawIgnore;
-  const filterExts = options.ext || [];
-  const maxFileSizeBytes = (parseFloat(options.maxSize) || 500) * 1024;
-  const headerStyle = options.style || "banner";
-  const showMeta = !options.noMeta;
-  const showToc = !options.noToc;
-  const dryRun = options.dryRun || false;
-  const include = options.include || [];
-  const exclude = options.exclude || [];
-  const linesBefore = parseInt(options.linesBefore) || 0;
-  const linesAfter = parseInt(options.linesAfter) || 0;
-
-  console.log(`\n  📂 Source  : ${cwd}`);
-  console.log(`  📄 Output  : ${path.relative(cwd, outputFile)}`);
-  console.log(`  🎨 Style   : ${headerStyle}`);
-  if (filterExts.length) console.log(`  🔍 Filter  : .${filterExts.join(", .")}`);
-  if (forceInclude.length) console.log(`  📌 Force   : ${forceInclude.join(", ")}`);
-  if (dryRun) console.log(`  🧪 Dry run : no file will be written`);
-  console.log();
-
-  let allFiles = getAllFiles(cwd, ignoreList);
-
-  // Filter by extension
-  if (filterExts.length) {
-    allFiles = allFiles.filter((f) => matchesExtensions(f, filterExts));
-  }
-
-  // Include pattern filter
-  if (include.length) {
-    allFiles = allFiles.filter((f) => matchesPattern(f, include));
-  }
-
-  // Exclude pattern filter
-  if (exclude.length) {
-    allFiles = allFiles.filter((f) => !matchesPattern(f, exclude));
-  }
-
-  // Remove ALL repomeld output files (current run + any previous numbered ones)
-  allFiles = allFiles.filter((f) => !isRepomeldOutput(f, outputBaseName));
-
-  if (allFiles.length === 0) {
-    console.log("  ⚠️  No matching files found.\n");
-    return;
-  }
-
-  let combinedContent = "";
-  let skipped = 0;
-  let included = 0;
-  let totalLines = 0;
-  const includedFiles = [];
-
-  for (const filePath of allFiles) {
-    const relativePath = path.relative(cwd, filePath);
-
-    if (isBinaryFile(filePath)) {
-      console.log(`  ⏭  Binary  : ${relativePath}`);
-      skipped++;
-      continue;
-    }
-
-    const stat = fs.statSync(filePath);
-    if (stat.size > maxFileSizeBytes) {
-      console.log(`  ⏭  Too large: ${relativePath} (${formatSize(stat.size)})`);
-      skipped++;
-      continue;
-    }
-
-    try {
-      let content = fs.readFileSync(filePath, "utf8");
-
-      if (options.trim) {
-        content = content.trim();
-      }
-
-      if (linesBefore > 0 || linesAfter > 0) {
-        const lines = content.split("\n");
-        const start = linesBefore;
-        const end = linesAfter > 0 ? lines.length - linesAfter : lines.length;
-        content = lines.slice(start, end).join("\n");
-      }
-
-      const lineCount = content.split("\n").length;
-      totalLines += lineCount;
-      includedFiles.push(filePath);
-
-      combinedContent += buildHeader(headerStyle, relativePath, filePath, lineCount, showMeta);
-      combinedContent += content;
-      combinedContent += buildFooter(headerStyle);
-
-      console.log(`  ✅ ${relativePath}`);
-      included++;
-    } catch (err) {
-      console.log(`  ❌ Error: ${relativePath} — ${err.message}`);
-      skipped++;
-    }
-  }
-
-  // Build final output
-  let finalOutput = "";
-
-  const timestamp = new Date().toISOString();
-  finalOutput += `# Generated by repomeld v${VERSION}\n`;
-  finalOutput += `# Date     : ${timestamp}\n`;
-  finalOutput += `# Source   : ${cwd}\n`;
-  finalOutput += `# Files    : ${included}\n`;
-  finalOutput += `# Lines    : ${totalLines}\n`;
-  finalOutput += `# Author   : susheelhbti@gmail.com — available for freelance & full-time work\n\n`;
-
-  if (showToc) {
-    finalOutput += buildTableOfContents(includedFiles, cwd);
-  }
-
-  finalOutput += combinedContent;
-
-  if (!dryRun) {
-    fs.writeFileSync(outputFile, finalOutput, "utf8");
-  }
-
-  const outputSize = formatSize(Buffer.byteLength(finalOutput, "utf8"));
-
-  console.log(`
-  ✨ repomeld complete!
-  ─────────────────────────────────────────────────
-  ✅ Included : ${included} files
-  ⏭  Skipped  : ${skipped} files
-  📏 Lines    : ${totalLines}
-  💾 Size     : ${outputSize}
-  📄 Output   : ${path.relative(cwd, outputFile)}${dryRun ? "  (dry run — not written)" : ""}
-  ─────────────────────────────────────────────────
-  💼 Need a developer? susheelhbti@gmail.com
-  `);
-}
-
-// ─── CLI Definition ───────────────────────────────────────────
+const { repomeld } = require("../src/index");
+const { VERSION } = require("../src/utils/constants");
 
 program
   .name("repomeld")
-  .description("Meld your entire repo into a single file — perfect for AI context, code reviews & sharing")
+  .description("Meld your entire repo into a single file — perfect for AI context & code reviews")
   .version(VERSION)
-
-  // Output
-  .option("-o, --output <filename>",        "Output file name",                        "repomeld_output.txt")
-
-  // Filtering
-  .option("-e, --ext <exts...>",            "Only include specific extensions          e.g. --ext js ts jsx")
-  .option("--include <patterns...>",        "Only include files matching patterns      e.g. --include src/")
-  .option("--exclude <patterns...>",        "Exclude files matching patterns           e.g. --exclude test spec")
-  .option("-i, --ignore <names...>",        "Extra folders/files to ignore             e.g. --ignore dist .next")
-  .option("--force-include <names...>",     "Force-include files ignored by default    e.g. --force-include vendor")
-  .option("--max-size <kb>",                "Skip files larger than N KB (default 500)","500")
-
-  // Formatting
-  .option("-s, --style <style>",            "Header style: banner | markdown | minimal (default: banner)", "banner")
-  .option("--no-toc",                       "Disable table of contents")
-  .option("--no-meta",                      "Hide file metadata (lines, size, lang)")
-  .option("--trim",                         "Trim leading/trailing whitespace per file")
-
-  // Advanced
-  .option("--lines-before <n>",             "Skip first N lines of each file")
-  .option("--lines-after <n>",              "Skip last N lines of each file")
-  .option("--dry-run",                      "Preview what would be included — don't write output")
-
-  .action((options) => {
-    repomeld(options);
+  .option("-o, --output <filename>", "Output filename", "repomeld_output.txt")
+  .option("-e, --ext <exts...>", "Only include specific extensions")
+  .option("--include <patterns...>", "Force include files matching patterns")
+  .option("--exclude <patterns...>", "Exclude files matching patterns")
+  .option("-i, --ignore <names...>", "Additional ignore patterns")
+  .option("--force-include <names...>", "Force include even if ignored")
+  .option("--max-size <kb>", "Maximum file size in KB", "500")
+  .option("--no-gitignore", "Don't respect .gitignore")
+  .option("-s, --style <style>", "Header style: banner | markdown | minimal", "banner")
+  .option("--no-toc", "Disable table of contents")
+  .option("--no-meta", "Hide file metadata")
+  .option("--trim", "Trim whitespace from each file")
+  .option("--lines-before <n>", "Skip first N lines", parseInt)
+  .option("--lines-after <n>", "Skip last N lines", parseInt)
+  .option("--dry-run", "Preview without writing files")
+  .option("--no-backup", "Skip backup zip creation")
+  .option("--no-update-check", "Skip update check")
+  .action(async (options) => {
+    try {
+      await repomeld(options);
+    } catch (error) {
+      console.error(`\n❌ Error: ${error.message}`);
+      if (process.env.DEBUG) console.error(error);
+      process.exit(1);
+    }
   });
 
-program.parse(process.argv);
+program.parse(process.argv);

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "repomeld",
-  "version": "2.0.4",
+  "version": "3.0.0",
   "description": "Meld your entire repo into a single file — perfect for AI context, code reviews & sharing",
   "main": "bin/cli.js",
   "bin": {
     "repomeld": "bin/cli.js"
   },
   "scripts": {
-    "start": "node bin/cli.js"
+    "start": "node bin/cli.js",
+    "test": "node bin/cli.js --dry-run",
+    "prepublishOnly": "npm run test",
+    "postinstall": "node -e \"console.log('\\n📦 repomeld installed successfully! Run: repomeld --help\\n')\""
   },
   "keywords": [
     "cli",
@@ -18,15 +21,39 @@
     "concat",
     "ai-context",
     "code-review",
-    "repomeld"
+    "repomeld",
+    "git",
+    "repository"
   ],
-  "author": "",
+  "author": "Susheel <susheelhbti@gmail.com>",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sakshsky/repomeld.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sakshsky/repomeld/issues"
+  },
+  "homepage": "https://github.com/sakshsky/repomeld#readme",
   "dependencies": {
-    "commander": "^11.0.0" 
-    
+    "archiver": "^7.0.1",
+    "commander": "^11.1.0",
+    "ignore": "^5.3.2",
+    "isbinaryfile": "^5.0.7"
+  },
+  "devDependencies": {
+    "eslint": "^8.56.0",
+    "prettier": "^3.1.1"
   },
   "engines": {
     "node": ">=14.0.0"
+  },
+  "files": [
+    "bin/",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
   }
 }