repomeld 2.0.1 → 2.0.3

package/README.md

@@ -2,6 +2,8 @@
 
 > Meld your entire repo into a single file — perfect for AI context, code reviews & sharing.
 
+> 💼 **Author [`susheelhbti@gmail.com`](mailto:susheelhbti@gmail.com) is open to freelance & full-time work.**
+
 ---
 
 ## Install
@@ -19,88 +21,183 @@ cd your-project
 repomeld
 ```
 
-Creates `repomeld_output.txt` with all your source files combined, a table of contents, and file metadata — with all public libraries, vendor folders, and boilerplate automatically excluded.
+**No flags needed.** repomeld will walk you through 7 quick questions and configure itself:
+
+```
+╔══════════════════════════════════════╗
+║          repomeld  v1.2.0            ║
+║   Meld your repo into one file 🔥   ║
+╚══════════════════════════════════════╝
+
+  💼 Author susheelhbti@gmail.com is open to freelance & full-time work
+
+  ┌─────────────────────────────────────────────────┐
+  │  Interactive setup — answer 7 quick questions   │
+  │  Press Enter to accept the [default] value      │
+  └─────────────────────────────────────────────────┘
+
+  📄 1/7  Output filename? [repomeld_output.txt]
+       > 
+
+  🎨 2/7  Header style?
+         1) banner   — clear dividers with file info  (default)
+         2) markdown — great for pasting into AI prompts
+         3) minimal  — filename only, no extra formatting
+       > 
+
+  🔍 3/7  Filter to specific file extensions?
+         e.g.  js ts php py    (leave blank = include ALL files)
+       > 
+
+  🏗️  4/7  Enable structure-only mode? (y/n) [n]
+         Strips function bodies — keeps class names + signatures only.
+         Cuts a 400-line file to ~30 lines. Perfect for AI architecture review.
+       > 
+
+  🔗 5/7  Generate a code review graph? (y/n) [n]
+         Adds a Mermaid call graph at the top of the output.
+         AI models read Mermaid natively — shows which files connect to which.
+       > 
+
+  📋 6/7  Include a table of contents? (y/n) [y]
+       > 
+
+  🧪 7/7  Dry run only? (y/n) [n]
+         Preview which files would be included without writing anything.
+       > 
+```
+
+After answering, it shows a summary and runs:
+
+```
+  ┌─────────────────────────────────────────────────┐
+  │  Your configuration                              │
+  ├─────────────────────────────────────────────────┤
+  │  Output         : repomeld_output.txt            │
+  │  Style          : markdown                       │
+  │  Extensions     : php ts                         │
+  │  Structure only : yes ✅                         │
+  │  Review graph   : yes ✅                         │
+  │  Table of cont. : yes                            │
+  │  Dry run        : no                             │
+  └─────────────────────────────────────────────────┘
+```
 
 ---
 
-## Smart Auto-Ignore
+## Skip the Wizard (Power Users)
+
+If you pass any flags, repomeld skips the wizard and runs directly:
 
-repomeld ships with a built-in `repomeld.ignore.json` that **automatically skips** common public libraries and vendor files so your output stays small and focused on your own code.
+```bash
+repomeld --ext ts tsx --style markdown --output context.md
+```
 
-### What gets ignored by default
+Force the wizard at any time with:
 
-| Category | Examples |
-|---|---|
-| Project meta | `package.json`, `README.md`, `yarn.lock`, `.gitignore` |
-| Build output | `dist/`, `build/`, `.next/`, `.nuxt/`, `coverage/` |
-| Vendor folders | `vendor/`, `libs/`, `plugins/`, `assets/vendor/`, `wwwroot/lib/` |
-| Bootstrap | `bootstrap.min.css`, `bootstrap.bundle.min.js`, `bootstrap-icons` |
-| jQuery | `jquery.min.js`, `jquery-ui.min.js`, `jquery.validate.min.js` |
-| Font Awesome | `all.min.css`, `fa-solid-900.woff2`, `fontawesome-free/` |
-| Tailwind CSS | `tailwind.min.css`, `tailwindcss/` |
-| Materialize | `materialize.min.css`, `materialize.min.js` |
-| Bulma | `bulma.min.css` |
-| Semantic UI | `semantic.min.css`, `semantic.min.js` |
-| Foundation | `foundation.min.css`, `foundation.min.js` |
-| UIkit | `uikit.min.css`, `uikit.min.js` |
-| Animate.css | `animate.min.css`, `animate.css` |
-| GSAP | `gsap.min.js`, `ScrollTrigger.min.js`, `TweenMax.min.js` |
-| Swiper / Slick / Owl | `swiper-bundle.min.js`, `slick.min.js`, `owl.carousel.min.js` |
-| Chart.js / D3 / Three.js | `chart.min.js`, `d3.min.js`, `three.min.js` |
-| Axios / Lodash / Moment | `axios.min.js`, `lodash.min.js`, `moment.min.js` |
-| Select2 / Flatpickr | `select2.min.js`, `flatpickr.min.js` |
-| DataTables | `datatables.min.js`, `jquery.dataTables.min.js` |
-| Toastr / SweetAlert | `toastr.min.js`, `sweetalert2.min.js` |
-| Lightbox / Fancybox | `lightbox.min.js`, `glightbox.min.js` |
-| Rich text editors | `quill.min.js`, `tinymce/`, `ckeditor/`, `codemirror/` |
-| Syntax highlighting | `prism.min.js`, `highlight.min.js` |
-| Video / Audio players | `video.js`, `plyr.min.js` |
-| Maps | `leaflet.min.js`, `mapbox-gl.min.js` |
-| Icon sets | `remixicon.css`, `boxicons.css`, `ionicons.css`, `lucide.min.js` |
-| Socket.IO | `socket.io.min.js` |
-| Misc utilities | `lazysizes.js`, `lottie.min.js`, `particles.js`, `typed.js`, `sortable.min.js`, `masonry.js` |
-| Admin templates | `AdminLTE/`, `metronic/`, `coreui/`, `gentelella/` |
-| Env / Secrets | `.env`, `.env.local`, `.env.production` |
+```bash
+repomeld --wizard
+```
 
 ---
 
-## Force-Include an Ignored Library
+## New Features in v1.2.0
+
+### `--structure-only` — Skeleton mode
 
-If you need a normally-ignored file to appear in your output, use `--force-include`:
+Extracts **class names + function signatures** from every file. Strips all body code.
 
 ```bash
-# Include your customized bootstrap.js even though bootstrap is ignored by default
-repomeld --force-include bootstrap
+repomeld --structure-only
+```
 
-# Include multiple overrides
-repomeld --force-include jquery vendor bootstrap
+**Before** (400 lines of PHP):
+```php
+public function available(Request $request)
+{
+    $validated = $request->validate([...]);
+    $guards = SecurityGuard::with('user')
+        ->where('is_available', true)
+        ...
+    // 50 more lines
+}
+```
 
-# Combine with other options
-repomeld --force-include jquery --style markdown --output context.md
+**After** (1 line):
+```php
+public function available(Request $request) { ... }
 ```
 
-`--force-include` matches by name substring, so `--force-include bootstrap` will un-ignore both `bootstrap.min.css` and `bootstrap.min.js`.
+Supports **PHP, JavaScript, TypeScript, Python**. Other languages fall back to the first 30 lines.
+
+Perfect for:
+- Giving AI a full architecture overview without hitting context limits
+- Code review focusing on structure, not implementation
+- Onboarding — understand a codebase in seconds
 
 ---
 
-## Customize the Ignore List
+### `--review-graph` — Mermaid call graph
 
-You can override or extend the ignore list by placing your own `repomeld.ignore.json` in your **project root**. It will take priority over the built-in config.
+Generates a **Mermaid flowchart** at the top of your output showing which files import/call which.
 
-```json
-{
-  "ignore": [
-    "my-custom-vendor-folder",
-    "some-legacy-lib.js",
-    "generated-report.html"
-  ]
-}
+```bash
+repomeld --review-graph
+```
+
+Output (inside the file, readable by AI natively):
+
+````
+```mermaid
+flowchart TD
+  %% Code Review Graph — generated by repomeld
+
+  src_index_js["📄 index.js\n[repomeld, getAllFiles, buildHeader]"]
+  src_utils_js["📄 utils.js\n[formatSize, getLanguage]"]
+  src_graph_js["📄 graph.js\n[buildReviewGraph]"]
+
+  src_index_js --> src_utils_js
+  src_index_js --> src_graph_js
+```
+````
+
+AI models like Claude, GPT-4, and Gemini read Mermaid natively — no image needed.
+
+---
+
+### Power combo: both together
+
+```bash
+repomeld --structure-only --review-graph
 ```
 
-repomeld looks for config in this order:
-1. `repomeld.ignore.json` in your **project root** (user override)
-2. `repomeld.ignore.json` bundled with the npm package (built-in defaults)
-3. Hardcoded `DEFAULT_IGNORE` list in the CLI
+AI gets:
+1. **The map** — which files connect to which (graph)
+2. **The skeleton** — every class and function signature (structure)
+3. **Zero noise** — no implementation details
+
+This is the best way to give AI a complete understanding of a large codebase without wasting context.
+
+---
+
+## Smart Auto-Ignore
+
+repomeld automatically skips common public libraries and vendor files.
+
+| Category | Examples |
+|---|---|
+| Project meta | `package.json`, `README.md`, `yarn.lock`, `.gitignore` |
+| Build output | `dist/`, `build/`, `.next/`, `.nuxt/`, `coverage/` |
+| Vendor folders | `vendor/`, `libs/`, `plugins/`, `assets/vendor/` |
+| Bootstrap | `bootstrap.min.css`, `bootstrap.bundle.min.js` |
+| jQuery | `jquery.min.js`, `jquery-ui.min.js` |
+| Font Awesome | `all.min.css`, `fontawesome-free/` |
+| Tailwind | `tailwind.min.css`, `tailwindcss/` |
+| Chart / D3 / Three | `chart.min.js`, `d3.min.js`, `three.min.js` |
+| Axios / Lodash | `axios.min.js`, `lodash.min.js` |
+| Rich text editors | `tinymce/`, `ckeditor/`, `codemirror/` |
+| Admin templates | `AdminLTE/`, `metronic/`, `coreui/` |
+| Env / Secrets | `.env`, `.env.local`, `.env.production` |
 
 ---
 
@@ -112,6 +209,7 @@ Usage: repomeld [options]
 Options:
   -V, --version                     Show version
   -h, --help                        Show help
+  --wizard                          Interactive step-by-step setup
 
   Output:
   -o, --output <filename>           Output file name (default: "repomeld_output.txt")
@@ -124,14 +222,11 @@ Options:
   --exclude <patterns...>           Exclude files matching patterns
                                     e.g. --exclude test spec
   -i, --ignore <names...>           Extra folders/files to ignore
-                                    e.g. --ignore dist .next
   --force-include <names...>        Force-include files ignored by default
-                                    e.g. --force-include vendor bootstrap jquery
   --max-size <kb>                   Skip files larger than N KB (default: 500)
 
   Formatting:
   -s, --style <style>               Header style: banner | markdown | minimal
-                                    (default: banner)
   --no-toc                          Disable table of contents
   --no-meta                         Hide file metadata (lines, size, lang)
   --trim                            Trim leading/trailing whitespace per file
@@ -139,7 +234,11 @@ Options:
   Advanced:
   --lines-before <n>                Skip first N lines of each file
   --lines-after <n>                 Skip last N lines of each file
-  --dry-run                         Preview what would be included — don't write output
+  --dry-run                         Preview without writing output
+
+  AI / Code Review:
+  --structure-only                  Extract class + function signatures only (no body)
+  --review-graph                    Prepend a Mermaid call graph to the output
 ```
 
 ---
@@ -147,99 +246,87 @@ Options:
 ## Examples
 
 ```bash
-# Basic usage — outputs source files only, libraries auto-ignored
+# Wizard mode (auto when no flags given)
 repomeld
 
-# Only TypeScript and JSX files inside src/
-repomeld --ext ts tsx --include src/
-
-# Exclude test files
-repomeld --exclude test spec __tests__
-
-# Force-include your customized jQuery even though it is ignored by default
-repomeld --force-include jquery
-
-# Force-include multiple libs
-repomeld --force-include vendor bootstrap select2
+# Force wizard even with flags
+repomeld --wizard
 
-# Markdown style output — great for pasting into AI prompts
-repomeld --style markdown --output context.md
+# Only PHP controllers, structure only
+repomeld --ext php --include Controllers --structure-only
 
-# Minimal headers, no table of contents
-repomeld --style minimal --no-toc
+# Full code + call graph
+repomeld --review-graph
 
-# Custom output file
-repomeld --output all_code.txt
+# Best for AI: skeleton + graph, markdown style
+repomeld --structure-only --review-graph --style markdown --output ai_context.md
 
-# Skip large files (over 100 KB)
-repomeld --max-size 100
+# Only TypeScript inside src/
+repomeld --ext ts tsx --include src/
 
-# No metadata shown
-repomeld --no-toc --no-meta
+# Exclude tests
+repomeld --exclude test spec __tests__
 
-# Dry run — preview what would be included without writing
+# Dry run — preview only
 repomeld --dry-run
 
-# Ignore additional folders not in the default list
-repomeld --ignore dist .next coverage
-
-# Combine options
-repomeld --ext ts tsx --include src/ --style markdown --output ai_context.md
+# Large repo: structure only, skip files over 100 KB
+repomeld --structure-only --max-size 100
 ```
 
 ---
 
-## Output Format (banner style — default)
+## Output Format
+
+### With `--review-graph`
 
 ```
-# Generated by repomeld v1.1.0
+# Generated by repomeld v1.2.0
 # Date     : 2024-01-01T00:00:00.000Z
 # Source   : /your/project
-# Files    : 12
-# Lines    : 843
+# Files    : 8
+# Lines    : 312
+# Graph    : review-graph enabled
+# Author   : susheelhbti@gmail.com (open to work)
 
-TABLE OF CONTENTS
 ════════════════════════════════════════════════════════════
-    1. src/index.ts
-    2. src/utils/helper.ts
-    ...
+  CODE REVIEW GRAPH
 ════════════════════════════════════════════════════════════
 
-────────────────────────────────────────────────────────────
-  FILE: src/index.ts  [42 lines | 1.2 KB | typescript]
-────────────────────────────────────────────────────────────
-
-<file contents>
+```mermaid
+flowchart TD
+  ...
 ```
 
----
-
-## Output Format (markdown style)
-
-````
-## 📄 src/index.ts  [42 lines | 1.2 KB | typescript]
-
-```typescript
-<file contents>
+TABLE OF CONTENTS
+...
 ```
-````
 
----
+### With `--structure-only` (PHP example)
 
-## Auto-ignored (always skipped regardless of config)
+```php
+namespace App\Http\Controllers;
+use App\Models\SecurityGuard;
+use App\Models\SecurityRequest;
 
-- `node_modules/`, `.git/`, `dist/`, `build/`, `.next/`, `.nuxt/`, `.cache/`
-- `.env`, `.env.local`, `.env.production`
-- `.DS_Store`, `package-lock.json`, `yarn.lock`, `pnpm-lock.yaml`
-- Binary files (images, executables, fonts, etc.)
-- The output file itself
+class GuardController extends Controller
+{
+    /** Get guard's own profile */
+    public function profile() { ... }
+    public function updateProfile(Request $request) { ... }
+    public function bookings() { ... }
+    public function available(Request $request) { ... }
+    public function toggleAvailability() { ... }
+    public function rate(Request $request, $id) { ... }
+}
+```
 
 ---
 
 ## Publish / Update
 
 ```bash
-npm version patch   # 1.0.0 → 1.0.1
+npm version patch   # 1.2.0 → 1.2.1
 npm publish
 ```
 
@@ -247,10 +334,14 @@ npm publish
 
 ## Contributing
 
-Found a popular library that should be in the ignore list? Open a PR and add it to `repomeld.ignore.json`!
+Found a popular library that should be in the ignore list? Open a PR!
 
 ---
 
 ## License
 
-MIT
+MIT
+
+---
+
+> 💼 **Looking to hire?** The author [`susheelhbti@gmail.com`](mailto:susheelhbti@gmail.com) is available for freelance and full-time work.

package/bin/cli.js

@@ -2,28 +2,18 @@
 
 const fs = require("fs");
 const path = require("path");
+const readline = require("readline");
 const { program } = require("commander");
 
-const VERSION = "1.0.0";
+const VERSION = "1.2.0";
+
+const AUTHOR_NOTE = "  💼 Author susheelhbti@gmail.com is open to freelance & full-time work";
 
 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",
-  "repomeld_output.txt",
+  "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", "repomeld_output.txt",
 ];
 
 function loadIgnoreConfig() {
@@ -33,9 +23,7 @@ function loadIgnoreConfig() {
     if (fs.existsSync(loc)) {
       try {
         const data = JSON.parse(fs.readFileSync(loc, "utf8"));
-        if (Array.isArray(data.ignore)) {
-          return data.ignore;
-        }
+        if (Array.isArray(data.ignore)) return data.ignore;
       } catch {
         console.warn(`  ⚠️  Could not parse ${loc}, using defaults.`);
       }
@@ -62,31 +50,17 @@ function getLanguage(filePath) {
 
 function getAllFiles(dirPath, ignoreList, fileList = []) {
   let entries;
-  try {
-    entries = fs.readdirSync(dirPath, { withFileTypes: true });
-  } catch {
-    return fileList;
-  }
-
+  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);
-    }
+    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;
 }
 
@@ -96,13 +70,9 @@ function isBinaryFile(filePath) {
     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;
-    }
+    for (let i = 0; i < bytesRead; i++) if (buffer[i] === 0) return true;
     return false;
-  } catch {
-    return true;
-  }
+  } catch { return true; }
 }
 
 function matchesExtensions(filePath, exts) {
@@ -123,147 +93,329 @@ function formatSize(bytes) {
   return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
 }
 
+// ─── AUTO-INCREMENT OUTPUT FILENAME ──────────────────────────────────────────
+
+function resolveOutputPath(cwd, filename) {
+  const ext = path.extname(filename);
+  const base = path.basename(filename, ext);
+  let candidate = path.resolve(cwd, filename);
+  let counter = 1;
+  while (fs.existsSync(candidate)) {
+    candidate = path.resolve(cwd, `${base}_${counter}${ext}`);
+    counter++;
+  }
+  return candidate;
+}
+
+// ─── BANNER ───────────────────────────────────────────────────────────────────
+
 function printBanner() {
   console.log(`
-╔══════════════════════════════════╗
-║        repomeld  v${VERSION}     ║
-║   Meld your repo into one file   ║
-╚══════════════════════════════════╝`);
-
-console.log("Developer is looking for freelance job susheelhbti@gmail.com");
+╔══════════════════════════════════════╗
+║          repomeld  v${VERSION}        ║
+║   Meld your repo into one file 🔥   ║
+╚══════════════════════════════════════╝`);
+  console.log(AUTHOR_NOTE);
+  console.log();
 }
 
-function buildHeader(style, relativePath, filePath, lineCount, showMeta) {
+// ─── HEADER / FOOTER ─────────────────────────────────────────────────────────
+
+function buildHeader(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";
+function buildFooter() {
   return "\n";
 }
 
+// ─── TABLE OF CONTENTS ────────────────────────────────────────────────────────
+
 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 += `  ${String(i + 1).padStart(3, " ")}. ${path.relative(cwd, f)}\n`;
   });
   toc += "═".repeat(60) + "\n\n";
   return toc;
 }
 
-function repomeld(options) {
-  printBanner();
+// ─── FILE TREE ────────────────────────────────────────────────────────────────
+
+function buildFileTree(files, cwd) {
+  const tree = {};
+  for (const f of files) {
+    const parts = path.relative(cwd, f).split(path.sep);
+    let node = tree;
+    for (const part of parts) {
+      node[part] = node[part] || {};
+      node = node[part];
+    }
+  }
+
+  function render(node, prefix = "") {
+    const keys = Object.keys(node);
+    return keys.map((key, i) => {
+      const isLast = i === keys.length - 1;
+      const connector = isLast ? "└── " : "├── ";
+      const childPfx = isLast ? "    " : "│   ";
+      const children = Object.keys(node[key]).length
+        ? "\n" + render(node[key], prefix + childPfx)
+        : "";
+      return prefix + connector + key + children;
+    }).join("\n");
+  }
+
+  return "FILE TREE\n" + "═".repeat(60) + "\n"
+    + render(tree) + "\n"
+    + "═".repeat(60) + "\n\n";
+}
+
+// ─── STRUCTURE EXTRACTION ─────────────────────────────────────────────────────
+
+function extractStructure(content, filePath) {
+  const lang = getLanguage(filePath);
+  const lines = content.split("\n");
+  const output = [];
+
+  if (lang === "php") {
+    let insideClass = false;
+    let braceDepth = 0;
+    let classStartDepth = 0;
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (trimmed.startsWith("namespace ") || trimmed.startsWith("use ")) { output.push(line); continue; }
+      const classMatch = trimmed.match(/^(abstract\s+class|class|interface|trait)\s+(\w+)(\s+extends\s+\w+)?(\s+implements\s+[\w,\s]+)?/);
+      if (classMatch) {
+        if (output.length && output[output.length - 1] !== "") output.push("");
+        output.push(line); insideClass = true; classStartDepth = braceDepth;
+      }
+      braceDepth += (line.match(/\{/g) || []).length;
+      braceDepth -= (line.match(/\}/g) || []).length;
+      if (insideClass && braceDepth <= classStartDepth && trimmed === "}") {
+        output.push("}"); insideClass = false; output.push(""); continue;
+      }
+      if (trimmed.startsWith("/**") || trimmed.startsWith("*") || trimmed.startsWith("*/")) {
+        if (insideClass) output.push(line); continue;
+      }
+      if (insideClass) {
+        const methodMatch = trimmed.match(/^(public|protected|private|static|abstract|final|\s)*(function\s+\w+\s*\([^)]*\)(\s*:\s*[\w\?\|\\]+)?)/);
+        if (methodMatch) output.push(`    ${methodMatch[0].trim()} { ... }`);
+        if (trimmed.match(/^(public|protected|private|const)\s+/) && trimmed.endsWith(";") && !trimmed.includes("function"))
+          output.push(`    ${trimmed}`);
+      }
+    }
+    return output.join("\n");
+  }
+
+  if (["javascript", "typescript"].includes(lang)) {
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (trimmed.match(/^(export\s+)?(abstract\s+)?class\s+\w+/)) { output.push(line); continue; }
+      if (trimmed.match(/^(export\s+)?(async\s+)?function\s+\w+\s*\(/)) {
+        output.push(`${line.match(/^\s*/)[0]}${trimmed.replace(/\{[\s\S]*$/, "{ ... }")}`); continue;
+      }
+      if (trimmed.match(/^(export\s+)?(const|let|var)\s+\w+\s*=\s*(async\s+)?\(/)) {
+        output.push(`${line.match(/^\s*/)[0]}${trimmed.split("=>")[0].trim()} => { ... }`); continue;
+      }
+      if (trimmed.match(/^(async\s+)?(\w+)\s*\([^)]*\)\s*(\:\s*[\w<>\[\]]+)?\s*\{/) &&
+        !["if", "while", "for", "switch"].some(k => trimmed.startsWith(k))) {
+        output.push(`${line.match(/^\s*/)[0]}${trimmed.replace(/\{[\s\S]*$/, "{ ... }")}`); continue;
+      }
+      if (trimmed.startsWith("import ")) output.push(line);
+      if (trimmed === "}") output.push(line);
+    }
+    return output.join("\n");
+  }
+
+  if (lang === "python") {
+    for (const line of lines) {
+      const t = line.trim();
+      if (t.startsWith("class ") || t.startsWith("def ") || t.startsWith("async def "))
+        output.push(line.replace(/:[\s\S]*$/, ":"));
+      if (t.startsWith("import ") || t.startsWith("from ")) output.push(line);
+    }
+    return output.join("\n");
+  }
+
+  return lines.slice(0, 30).join("\n") + "\n... (structure extraction not supported for this language)";
+}
+
+// ─── REVIEW GRAPH ─────────────────────────────────────────────────────────────
+
+function buildReviewGraph(files, cwd) {
+  const fileFunctions = {};
+  const fileImports = {};
+
+  for (const filePath of files.slice(0, 25)) {
+    const lang = getLanguage(filePath);
+    if (!["javascript", "typescript", "php", "python"].includes(lang)) continue;
+    let content;
+    try { content = fs.readFileSync(filePath, "utf8"); } catch { continue; }
+    const rel = path.relative(cwd, filePath);
+    const nodeId = rel.replace(/[^a-zA-Z0-9]/g, "_");
+    fileFunctions[rel] = { nodeId, functions: [] };
+    fileImports[rel] = [];
+    for (const line of content.split("\n")) {
+      const t = line.trim();
+      const fnMatch = t.match(/^(export\s+)?(async\s+)?function\s+(\w+)/) ||
+        t.match(/^(public|protected|private|static)?\s*(function\s+(\w+))/) ||
+        t.match(/^def\s+(\w+)/);
+      if (fnMatch) {
+        const name = fnMatch[3] || fnMatch[2] || fnMatch[1];
+        if (name && name.length > 2 && !["if", "for", "while", "switch"].includes(name))
+          fileFunctions[rel].functions.push(name);
+      }
+      const imp = t.match(/require\(['"]([^'"]+)['"]\)/) ||
+        t.match(/^import\s+.*from\s+['"]([^'"]+)['"]/) ||
+        t.match(/^use\s+(App\\[^;]+)/);
+      if (imp) fileImports[rel].push(imp[1]);
+    }
+    fileFunctions[rel].functions = [...new Set(fileFunctions[rel].functions)].slice(0, 5);
+  }
+
+  const fileList = Object.keys(fileFunctions);
+  if (fileList.length === 0) return null;
+
+  let mermaid = "```mermaid\nflowchart TD\n  %% Code Review Graph — generated by repomeld\n\n";
+  for (const rel of fileList) {
+    const { nodeId, functions } = fileFunctions[rel];
+    const label = path.basename(rel);
+    const fnList = functions.length ? `\\n[${functions.join(", ")}]` : "";
+    mermaid += `  ${nodeId}["📄 ${label}${fnList}"]\n`;
+  }
+  mermaid += "\n";
+  let edgeCount = 0;
+  for (const rel of fileList) {
+    for (const imp of fileImports[rel]) {
+      const matched = fileList.find(f => {
+        const base = path.basename(f, path.extname(f));
+        return imp.endsWith(base) || imp.includes(base);
+      });
+      if (matched && matched !== rel && edgeCount < 40) {
+        mermaid += `  ${fileFunctions[rel].nodeId} --> ${fileFunctions[matched].nodeId}\n`;
+        edgeCount++;
+      }
+    }
+  }
+  return mermaid + "```\n";
+}
+
+// ─── INTERACTIVE WIZARD ───────────────────────────────────────────────────────
 
+function ask(rl, question) {
+  return new Promise((resolve) => rl.question(question, resolve));
+}
+
+async function runWizard() {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+  console.log("  ┌─────────────────────────────────────────────────┐");
+  console.log("  │  Interactive setup — answer 1 quick question    │");
+  console.log("  │  Press Enter to accept the [default] value      │");
+  console.log("  └─────────────────────────────────────────────────┘\n");
+
+  const opts = {};
+
+  // 1 — Extensions
+  console.log("  🔍 1/1  Filter to specific extensions?");
+  console.log("         e.g.  js ts py   (leave blank = all files)");
+  const extRaw = await ask(rl, "       > ");
+  opts.ext = extRaw.trim() ? extRaw.trim().split(/\s+/) : [];
+
+  // hardcoded defaults — not optional
+  opts.output        = "repomeld_output.txt";
+  opts.style         = "banner";
+  opts.reviewGraph   = true;
+  opts.noToc         = false;
+  opts.dryRun        = false;
+  opts.structureOnly = false;
+
+  rl.close();
+
+  // Summary
+  console.log("\n  ┌─────────────────────────────────────────────────┐");
+  console.log("  │  Your configuration                              │");
+  console.log("  ├─────────────────────────────────────────────────┤");
+  console.log(`  │  Extensions : ${(opts.ext.length ? opts.ext.join(", ") : "all").padEnd(33)}│`);
+  console.log(`  │  Style      : banner (always)                   │`);
+  console.log(`  │  Graph      : yes (always)                      │`);
+  console.log(`  │  TOC        : yes (always)                      │`);
+  console.log("  └─────────────────────────────────────────────────┘\n");
+
+  return opts;
+}
+
+// ─── CORE ─────────────────────────────────────────────────────────────────────
+
+function repomeld(options) {
   const cwd = process.cwd();
-  const outputFile = path.resolve(cwd, options.output);
+
+  // Always banner, always review graph, always TOC
+  options.style       = "banner";
+  options.reviewGraph = true;
+  options.noToc       = false;
+
+  const outputFile = resolveOutputPath(cwd, options.output || "repomeld_output.txt");
   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.filter(ig => !forceInclude.some(fi => ig.includes(fi) || fi.includes(ig)))
     : rawIgnore;
-  const filterExts = options.ext || [];
+  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}`);
+  const showMeta         = options.noMeta !== true;
+  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;
+  const structureOnly    = options.structureOnly || false;
+
+  console.log(`  📂 Source  : ${cwd}`);
   console.log(`  📄 Output  : ${path.relative(cwd, outputFile)}`);
-  console.log(`  🎨 Style   : ${headerStyle}`);
+  console.log(`  🎨 Style   : banner`);
   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`);
+  if (structureOnly)     console.log(`  🏗️  Mode    : structure only`);
+  console.log(`  🔗 Graph   : review graph enabled`);
+  if (dryRun)            console.log(`  🧪 Dry run : no file will be written`);
   console.log();
 
   let allFiles = getAllFiles(cwd, ignoreList);
+  if (filterExts.length) allFiles = allFiles.filter(f => matchesExtensions(f, filterExts));
+  if (include.length)    allFiles = allFiles.filter(f => matchesPattern(f, include));
+  if (exclude.length)    allFiles = allFiles.filter(f => !matchesPattern(f, exclude));
+  allFiles = allFiles.filter(f => path.resolve(f) !== outputFile);
 
-  // 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 output file from list
-  allFiles = allFiles.filter((f) => path.resolve(f) !== outputFile);
-
-  if (allFiles.length === 0) {
-    console.log("  ⚠️  No matching files found.\n");
-    return;
-  }
+  if (allFiles.length === 0) { console.log("  ⚠️  No matching files found.\n"); return; }
 
   let combinedContent = "";
-  let skipped = 0;
-  let included = 0;
-  let totalLines = 0;
+  let skipped = 0, included = 0, totalLines = 0;
   const includedFiles = [];
 
   for (const filePath of allFiles) {
     const relativePath = path.relative(cwd, filePath);
-
-    if (isBinaryFile(filePath)) {
-      console.log(`  ⏭  Binary  : ${relativePath}`);
-      skipped++;
-      continue;
-    }
-
+    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;
-    }
-
+    if (stat.size > maxFileSizeBytes) { console.log(`  ⏭  Too large: ${relativePath} (${formatSize(stat.size)})`); skipped++; continue; }
     try {
       let content = fs.readFileSync(filePath, "utf8");
-
-      // Trim leading/trailing blank lines if requested
-      if (options.trim) {
-        content = content.trim();
-      }
-
-      // Slice specific lines
+      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");
+        content = lines.slice(linesBefore, linesAfter > 0 ? lines.length - linesAfter : lines.length).join("\n");
       }
-
+      if (structureOnly) content = extractStructure(content, filePath);
       const lineCount = content.split("\n").length;
       totalLines += lineCount;
       includedFiles.push(filePath);
-
-      combinedContent += buildHeader(headerStyle, relativePath, filePath, lineCount, showMeta);
+      combinedContent += buildHeader(relativePath, filePath, lineCount, showMeta);
       combinedContent += content;
-      combinedContent += buildFooter(headerStyle);
-
+      combinedContent += buildFooter();
       console.log(`  ✅ ${relativePath}`);
       included++;
     } catch (err) {
@@ -272,29 +424,36 @@ function repomeld(options) {
     }
   }
 
-  // Build final output
+  // Build final output: metadata → review graph → file tree → TOC → file contents
   let finalOutput = "";
-
-  // Top-level comment
-  const timestamp = new Date().toISOString();
   finalOutput += `# Generated by repomeld v${VERSION}\n`;
-  finalOutput += `# Date     : ${timestamp}\n`;
+  finalOutput += `# Date     : ${new Date().toISOString()}\n`;
   finalOutput += `# Source   : ${cwd}\n`;
   finalOutput += `# Files    : ${included}\n`;
-  finalOutput += `# Lines    : ${totalLines}\n\n`;
-
-  if (showToc) {
-    finalOutput += buildTableOfContents(includedFiles, cwd);
+  finalOutput += `# Lines    : ${totalLines}\n`;
+  if (structureOnly) finalOutput += `# Mode     : structure-only (signatures)\n`;
+  finalOutput += `# Graph    : review-graph enabled\n`;
+  finalOutput += `# Author   : susheelhbti@gmail.com (open to work)\n\n`;
+
+  // Review graph (always)
+  const graph = buildReviewGraph(includedFiles, cwd);
+  if (graph) {
+    finalOutput += "═".repeat(60) + "\n  CODE REVIEW GRAPH\n" + "═".repeat(60) + "\n\n";
+    finalOutput += graph + "\n";
   }
 
+  // File tree (always)
+  finalOutput += buildFileTree(includedFiles, cwd);
+
+  // Table of contents (always)
+  finalOutput += buildTableOfContents(includedFiles, cwd);
+
+  // File contents
   finalOutput += combinedContent;
 
-  if (!dryRun) {
-    fs.writeFileSync(outputFile, finalOutput, "utf8");
-  }
+  if (!dryRun) fs.writeFileSync(outputFile, finalOutput, "utf8");
 
   const outputSize = formatSize(Buffer.byteLength(finalOutput, "utf8"));
-
   console.log(`
   ✨ repomeld complete!
   ─────────────────────────────
@@ -302,41 +461,45 @@ function repomeld(options) {
   ⏭  Skipped  : ${skipped} files
   📏 Lines    : ${totalLines}
   💾 Size     : ${outputSize}
-  📄 Output   : ${options.output}${dryRun ? "  (dry run — not written)" : ""}
+  📄 Output   : ${path.relative(cwd, outputFile)}${dryRun ? "  (dry run — not written)" : ""}
   `);
+  console.log(AUTHOR_NOTE + "\n");
 }
 
-// ─── CLI Definition ───────────────────────────────────────────
+// ─── CLI ──────────────────────────────────────────────────────────────────────
 
 program
   .name("repomeld")
   .description("Meld your entire repo into a single file — perfect for AI context, code reviews & sharing")
   .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 bootstrap jquery")
-  .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 file name",                         "repomeld_output.txt")
+  .option("-e, --ext <exts...>",        "Only include specific extensions")
+  .option("--include <patterns...>",    "Only include files matching patterns")
+  .option("--exclude <patterns...>",    "Exclude files matching patterns")
+  .option("-i, --ignore <names...>",    "Extra folders/files to ignore")
+  .option("--force-include <names...>", "Force-include files ignored by default")
+  .option("--max-size <kb>",            "Skip files larger than N KB",              "500")
+  .option("--no-meta",                  "Hide file metadata")
+  .option("--trim",                     "Trim leading/trailing whitespace per file")
+  .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 without writing output")
+  .option("--structure-only",           "Extract signatures only — no body code")
+  .option("--wizard",                   "Interactive step-by-step setup (auto when no flags given)")
+  .action(async (options) => {
+    printBanner();
+
+    // Auto-wizard when user runs plain `repomeld` with no flags
+    const hasFlags = options.ext || options.include || options.exclude ||
+      options.structureOnly || options.output !== "repomeld_output.txt" ||
+      options.dryRun;
+
+    if (options.wizard || !hasFlags) {
+      const wizardOpts = await runWizard();
+      repomeld({ ...options, ...wizardOpts });
+    } else {
+      repomeld(options);
+    }
   });
 
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "repomeld",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "Meld your entire repo into a single file — perfect for AI context, code reviews & sharing",
   "main": "bin/cli.js",
   "bin": {