prodex 1.0.5 → 1.0.6

package/README.md

@@ -5,7 +5,8 @@
 
 ---
 
-## 🧠 Recent Fixes & Updates — v1.0.4
+## 🧠 Recent Fixes & Updates — v1.0.6
+- ⭐ **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`).  
@@ -27,64 +28,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 +50,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.  
+Recommended entries appear at the top of the picker under a **⭐ Recommended entries** section.
+
+
+
+
 
 ---
 
@@ -188,4 +126,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.6
+- ⭐ **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`).  
@@ -27,64 +28,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 +50,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.  
+Recommended entries appear at the top of the picker under a **⭐ Recommended entries** section.
+
+
+
+
 
 ---
 
@@ -188,4 +126,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.6",
   "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: prioritized.includes(f) ? `⭐ ${rel(f)}` : 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,7 +2,6 @@ import fs from "fs";
 import path from "path";
 import {
   ROOT,
-
   CODE_EXTS,
   ENTRY_EXCLUDES,
   IMPORT_EXCLUDES,
@@ -28,12 +27,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,7 +45,8 @@ 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 || []
   };
 
   console.log("?? Active Config:");

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.6",
   "description": "Unified Project Indexer & Dependency Extractor for Laravel + React + Node stacks.",
   "type": "module",
   "bin": {