prodex 1.0.5 → 1.0.7

package/README.md

@@ -5,7 +5,8 @@
 
 ---
 
-## 🧠 Recent Fixes & Updates — v1.0.4
+## 🧠 Recent Fixes & Updates — v1.0.7
+- ⭐ **Priority Files Support**  — priority files will now appear **first** on the entry selection list.
 
 - 🪟 **Windows path resolution fixed** — now uses proper `file://` URLs for full ESM compatibility.  
 - 🧾 **Improved output naming** — automatic, context-aware filenames (e.g. `prodex-[entries]-combined.txt`).  
@@ -13,6 +14,16 @@
 
 ---
 
+---
+
+## 📦 Installation
+
+### Global install (recommended)
+```bash
+npm install -g prodex
+```
+
+
 ## 🚀 Features
 
 | Feature | Description |
@@ -27,64 +38,6 @@
 
 ---
 
-## 📦 Installation
-
-```bash
-npm install -g prodex
-```
-
-or locally:
-
-```bash
-npm install --save-dev prodex
-```
-
----
-
-## 🧰 Usage
-
-Run from your project root:
-
-```bash
-prodex
-```
-
-or:
-
-```bash
-npx prodex
-```
-
-You’ll be guided through an interactive CLI:
-
-```
-🧩 Prodex — Project Indexer
-🧩 Active Config:
- • Output Directory: ./prodex/
- • Scan Depth: 2
- • Base Dirs: app, routes, resources/js
-```
-
-After selecting entries:
-
-```
-✅ prodex-[entries]-combined.txt written (12 file(s)).
-```
-
----
-
-## 🗂 Output Example
-
-```
-## ==== path: app/Services/Shots/ComputeService.php ====
-## #region app/Services/Shots/ComputeService.php
-<?php
-// your code here...
-## #endregion
-```
-
----
-
 ## ⚙️ Configuration
 
 Optional `.prodex.json` (in project root):
@@ -107,36 +60,31 @@ Optional `.prodex.json` (in project root):
   "importExcludes": [
     "node_modules",
     "@shadcn/"
-  ]
+  ], 
+  "priorityFiles": [
+  "routes/web.php",
+  "routes/api.php",
+  "index.",
+  "main.",
+  "app."
+]
 }
 ```
 
----
+```
 
-## ⚡ CLI Flags (UNTESTED)
 
-| Flag | Description |
-|------|-------------|
-| `--limit <n>` | Override max dependency count |
-| `--output <dir>` | Custom output directory |
-| `--depth <n>` | Set scan depth |
-| `--no-chain` | Disable dependency chain following |
-| `--debug` | Enable verbose logging |
 
-Example:
-```bash
-prodex --depth 3 --output ./dump --limit 500
 ```
 
----
 
-## 🧩 Workflow Overview
 
-1. **Config Loader** — merges `.prodex.json` with defaults and alias maps.  
-2. **Resolvers** —  
-   - JS/TS: follows imports, re-exports, dynamic imports.  
-   - PHP: expands `use`, grouped imports, PSR-4 mappings.  
-3. **Combiner** — normalizes indentation, strips comments, merges all code into one readable combined file.
+Files are matched using `.includes()` (case-insensitive), so `"index."` will match `src/index.js`, `app/index.tsx`, etc.  
+Popular entries appear at the top of the picker.
+
+
+
+
 
 ---
 
@@ -188,4 +136,5 @@ Issues and contributions welcome:
 
 ---
 
-**Prodex** — *because every project deserves a clear map, not a maze.*
+**Prodex** — *Codebase, decoded*
+

package/dist/README.md

@@ -5,7 +5,8 @@
 
 ---
 
-## 🧠 Recent Fixes & Updates — v1.0.4
+## 🧠 Recent Fixes & Updates — v1.0.7
+- ⭐ **Priority Files Support**  — priority files will now appear **first** on the entry selection list.
 
 - 🪟 **Windows path resolution fixed** — now uses proper `file://` URLs for full ESM compatibility.  
 - 🧾 **Improved output naming** — automatic, context-aware filenames (e.g. `prodex-[entries]-combined.txt`).  
@@ -13,6 +14,16 @@
 
 ---
 
+---
+
+## 📦 Installation
+
+### Global install (recommended)
+```bash
+npm install -g prodex
+```
+
+
 ## 🚀 Features
 
 | Feature | Description |
@@ -27,64 +38,6 @@
 
 ---
 
-## 📦 Installation
-
-```bash
-npm install -g prodex
-```
-
-or locally:
-
-```bash
-npm install --save-dev prodex
-```
-
----
-
-## 🧰 Usage
-
-Run from your project root:
-
-```bash
-prodex
-```
-
-or:
-
-```bash
-npx prodex
-```
-
-You’ll be guided through an interactive CLI:
-
-```
-🧩 Prodex — Project Indexer
-🧩 Active Config:
- • Output Directory: ./prodex/
- • Scan Depth: 2
- • Base Dirs: app, routes, resources/js
-```
-
-After selecting entries:
-
-```
-✅ prodex-[entries]-combined.txt written (12 file(s)).
-```
-
----
-
-## 🗂 Output Example
-
-```
-## ==== path: app/Services/Shots/ComputeService.php ====
-## #region app/Services/Shots/ComputeService.php
-<?php
-// your code here...
-## #endregion
-```
-
----
-
 ## ⚙️ Configuration
 
 Optional `.prodex.json` (in project root):
@@ -107,36 +60,31 @@ Optional `.prodex.json` (in project root):
   "importExcludes": [
     "node_modules",
     "@shadcn/"
-  ]
+  ], 
+  "priorityFiles": [
+  "routes/web.php",
+  "routes/api.php",
+  "index.",
+  "main.",
+  "app."
+]
 }
 ```
 
----
+```
 
-## ⚡ CLI Flags (UNTESTED)
 
-| Flag | Description |
-|------|-------------|
-| `--limit <n>` | Override max dependency count |
-| `--output <dir>` | Custom output directory |
-| `--depth <n>` | Set scan depth |
-| `--no-chain` | Disable dependency chain following |
-| `--debug` | Enable verbose logging |
 
-Example:
-```bash
-prodex --depth 3 --output ./dump --limit 500
 ```
 
----
 
-## 🧩 Workflow Overview
 
-1. **Config Loader** — merges `.prodex.json` with defaults and alias maps.  
-2. **Resolvers** —  
-   - JS/TS: follows imports, re-exports, dynamic imports.  
-   - PHP: expands `use`, grouped imports, PSR-4 mappings.  
-3. **Combiner** — normalizes indentation, strips comments, merges all code into one readable combined file.
+Files are matched using `.includes()` (case-insensitive), so `"index."` will match `src/index.js`, `app/index.tsx`, etc.  
+Popular entries appear at the top of the picker.
+
+
+
+
 
 ---
 
@@ -188,4 +136,5 @@ Issues and contributions welcome:
 
 ---
 
-**Prodex** — *because every project deserves a clear map, not a maze.*
+**Prodex** — *Codebase, decoded*
+

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prodex",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Unified Project Indexer & Dependency Extractor for Laravel + React + Node stacks.",
   "type": "module",
   "bin": {

package/dist/src/cli/init.js

@@ -26,6 +26,13 @@ export async function initProdex() {
     "@hooks": "resources/js/hooks",
     "@data": "resources/js/data"
   },
+  "priorityFiles": [
+    "routes/web.php",
+    "routes/api.php",
+    "index.",
+    "main.",
+    "app."
+  ],
   "entryExcludes": [
     "resources/js/components/ui/",
     "app/DTOs/"

package/dist/src/cli/picker.js

@@ -2,9 +2,9 @@ import fs from "fs";
 import path from "path";
 import inquirer from "inquirer";
 import { ROOT } from "../constants/config.js";
-import { walk, rel } from "../core/helpers.js";
+import { walk, rel, sortWithPriority } from "../core/helpers.js";
 
-export async function pickEntries(baseDirs, depth = 2) {
+export async function pickEntries(baseDirs, depth = 2, cfg = {}) {
   let selected = [];
   while (true) {
     const files = [];
@@ -14,10 +14,23 @@ export async function pickEntries(baseDirs, depth = 2) {
       for (const f of walk(full, 0, depth)) files.push(f);
     }
 
-    const choices = files.map(f => ({ name: rel(f), value: f }));
-    choices.push(new inquirer.Separator());
-    choices.push({ name: "🔽 Load more (go deeper)", value: "__loadmore" });
-    choices.push({ name: "📝 Enter custom path", value: "__manual" });
+    const sorted = sortWithPriority(files, cfg.priorityFiles);
+
+    const prioritized = sorted.filter(f =>
+      cfg.priorityFiles?.some(p =>
+        rel(f).replaceAll("\\", "/").toLowerCase().includes(p.toLowerCase())
+      )
+    );
+
+    const choices = sorted.map(f => ({
+      name: rel(f),
+      value: f
+    }));
+
+    // if (prioritized.length) {
+    //   choices.unshift(new inquirer.Separator("⭐ Recommended entries"));
+    //   choices.splice(prioritized.length + 1, 0, new inquirer.Separator("─ Other files"));
+    // }
 
     const { picks } = await inquirer.prompt([
       {

package/dist/src/constants/config-loader.js

@@ -2,11 +2,11 @@ import fs from "fs";
 import path from "path";
 import {
   ROOT,
-
   CODE_EXTS,
   ENTRY_EXCLUDES,
   IMPORT_EXCLUDES,
-  BASE_DIRS
+  BASE_DIRS,
+  PRIORITY_FILES
 } from "./config.js";
 
 /**
@@ -28,12 +28,10 @@ export function loadProdexConfig() {
     }
   }
 
-  // Resolve output directory (always a folder now)
   const outputDir = userConfig.output
     ? path.resolve(ROOT, userConfig.output)
     : path.join(ROOT, "prodex");
 
-  // Ensure directory exists
   try {
     fs.mkdirSync(outputDir, { recursive: true });
   } catch (e) {
@@ -48,18 +46,19 @@ export function loadProdexConfig() {
     importExcludes: [...IMPORT_EXCLUDES, ...(userConfig.importExcludes || [])],
     baseDirs: [...new Set([...(userConfig.baseDirs || []), ...BASE_DIRS])],
     aliasOverrides: userConfig.aliasOverrides || {},
-    limit: userConfig.limit || 200
+    limit: userConfig.limit || 200,
+    priorityFiles: userConfig.priorityFiles || PRIORITY_FILES
   };
 
-  console.log("?? Active Config:");
-  console.log(" • Output Directory:", merged.output);
-  console.log(" • Scan Depth:", merged.scanDepth);
-  console.log(" • Base Dirs:", merged.baseDirs.join(", "));
-  if (userConfig.entryExcludes || userConfig.importExcludes)
-    console.log(" • Custom Exclusions:", {
-      entries: userConfig.entryExcludes?.length || 0,
-      imports: userConfig.importExcludes?.length || 0
-    });
+  // console.log("?? Active Config:");
+  // console.log(" • Output Directory:", merged.output);
+  // console.log(" • Scan Depth:", merged.scanDepth);
+  // console.log(" • Base Dirs:", merged.baseDirs.join(", "));
+  // if (userConfig.entryExcludes || userConfig.importExcludes)
+  //   console.log(" • Custom Exclusions:", {
+  //     entries: userConfig.entryExcludes?.length || 0,
+  //     imports: userConfig.importExcludes?.length || 0
+  //   });
 
   return merged;
 }

package/dist/src/constants/config.js

@@ -29,7 +29,13 @@ export const IMPORT_EXCLUDES = [
 ];
 export const BASE_DIRS = ["src", "bin", "schema", "app", "routes", "resources/js"];
 
-
+export const PRIORITY_FILES = [
+  "routes/web.php",
+  "routes/api.php",
+  "index.",
+  "main.",
+  "app."
+]
 /**
  * Resolver map — links file extensions to their resolver functions.
  * Extend this to support new formats (.vue, .jsx, etc.).

package/dist/src/core/combine.js

@@ -20,7 +20,7 @@ export async function runCombine() {
   const cfg = loadProdexConfig();
   const { baseDirs, scanDepth } = cfg;
 
-  const entries = await pickEntries(baseDirs, scanDepth);
+  const entries = await pickEntries(baseDirs, scanDepth, cfg);
   if (!entries.length) {
     console.log("❌ No entries selected.");
     return;
@@ -41,7 +41,6 @@ export async function runCombine() {
     proceed = true;
 
   if (!yesToAll) {
-    // clone static prompts with dynamic defaults
     const combinePrompts = PROMPTS.combine.map(p => ({
       ...p,
       default:
@@ -64,7 +63,6 @@ export async function runCombine() {
     return;
   }
 
-  // ensure output directory exists
   try {
     fs.mkdirSync(outputDir, { recursive: true });
   } catch {
@@ -104,8 +102,6 @@ const regionEnd = "##endregion";
 function render(p) {
   const ext = path.extname(p);
   let s = read(p);
-  // s = stripComments(s, ext);
-  // s = normalizeIndent(s);
   return `${header(p)}\n${regionStart(p)}\n${s}\n${regionEnd}\n\n`;
 }
 

package/dist/src/core/helpers.js

@@ -23,14 +23,12 @@ export function normalizeIndent(s) {
 }
 
 export function stripComments(code, ext) {
-  // Fast path for PHP or non-JS files — simple regex is fine
   if (ext === ".php") {
     return code
-      .replace(/\/\*[\s\S]*?\*\//g, "") // block comments
-      .replace(/^\s*#.*$/gm, ""); // line comments
+      .replace(/\/\*[\s\S]*?\*\//g, "")
+      .replace(/^\s*#.*$/gm, "");
   }
 
-  // Robust JS/TS-safe parser — avoids stripping inside strings
   let out = "";
   let inStr = false;
   let strChar = "";
@@ -93,7 +91,6 @@ export function stripComments(code, ext) {
   return out;
 }
 
-
 export function isEntryExcluded(p) {
   const r = rel(p);
   return ENTRY_EXCLUDES.some(ex => r.startsWith(ex) || r.includes(ex));
@@ -114,3 +111,17 @@ export function* walk(dir, depth = 0, maxDepth = 2) {
     }
   }
 }
+
+export function sortWithPriority(files, priorityList = []) {
+  if (!priorityList.length) return files;
+  const prioritized = [];
+  const normal = [];
+
+  for (const f of files) {
+    const normalized = f.replaceAll("\\", "/").toLowerCase();
+    if (priorityList.some(p => normalized.includes(p.toLowerCase()))) prioritized.push(f);
+    else normal.push(f);
+  }
+
+  return [...new Set([...prioritized, ...normal])];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prodex",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Unified Project Indexer & Dependency Extractor for Laravel + React + Node stacks.",
   "type": "module",
   "bin": {