prodex 1.4.9 → 1.4.11

package/dist/cli/cli-input.js

@@ -75,12 +75,19 @@ function parseCliInput(argv = process.argv) {
 }
 function registerFlags(program) {
     for (const [key, meta] of Object.entries(flags_1.FLAG_MAP)) {
-        const short = meta.short ? `-${meta.short},` : "";
+        const short = meta.short ? `-${meta.short}, ` : "";
         const defaultVal = meta.type === "boolean" ? false : undefined;
         program.option(`${short}--${key}`, meta.description, defaultVal);
     }
 }
 function normalizeFlags(flags, warnings, errors) {
+    // Remap short aliases (-i/-f/-d) to long keys (include/files/debug)
+    for (const [short, longKey] of Object.entries(flags_1.FLAG_SHORT_MAP)) {
+        if (flags[longKey] === undefined && flags[short] !== undefined) {
+            flags[longKey] = flags[short];
+            delete flags[short];
+        }
+    }
     for (const [key, meta] of Object.entries(flags_1.FLAG_MAP)) {
         const raw = flags[key];
         if (raw === undefined)

package/dist/constants/render-constants.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MD_HEADER = exports.MD_FOOTER = exports.TEXT_HEADERS = exports.LANG_MAP = void 0;
+exports.LLM_NOTE = exports.INDEX_RANGE_PLACEHOLDER = exports.MD_HEADER = exports.MD_FOOTER = exports.TEXT_HEADERS = exports.LANG_MAP = void 0;
 const package_json_1 = __importDefault(require("../../package.json"));
 exports.LANG_MAP = {
     "": "js",
@@ -23,3 +23,5 @@ exports.TEXT_HEADERS = {
 };
 exports.MD_FOOTER = ["\n---", "*Generated with [Prodex](https://github.com/emxhive/prodex) — Codebase decoded.*", `<!-- PRODEx v${package_json_1.default.version} | ${new Date().toISOString()} -->`].join("\n");
 exports.MD_HEADER = "*Generated by [Prodex](https://github.com/emxhive/prodex#readme)*";
+exports.INDEX_RANGE_PLACEHOLDER = "L?-L?";
+exports.LLM_NOTE = "> Note for LLMs: `Lx-Ly` ranges refer to lines in this Prodex trace file, not the original source files. Index metadata is provided via the HTML comment markers in this section.";

package/dist/core/managers/config.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConfigManager = void 0;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
-const default_config_1 = require("../../constants/default-config");
+const constants_1 = require("../../constants");
 const utils_1 = require("../../lib/utils");
 const flags_1 = require("../../constants/flags");
 const store_1 = require("../../store");
@@ -19,7 +19,7 @@ class ConfigManager {
     static load(cwd = process.cwd()) {
         const file = path_1.default.join(cwd, "prodex.json");
         if (!fs_1.default.existsSync(file))
-            return default_config_1.DEFAULT_PRODEX_CONFIG;
+            return constants_1.DEFAULT_PRODEX_CONFIG;
         try {
             const parsed = JSON.parse(fs_1.default.readFileSync(file, "utf8"));
             this.rawFile = parsed; // <-- SAVE RAW COPY
@@ -27,20 +27,20 @@ class ConfigManager {
         }
         catch {
             console.warn("⚠️ Invalid prodex.json — using defaults.");
-            return default_config_1.DEFAULT_PRODEX_CONFIG;
+            return constants_1.DEFAULT_PRODEX_CONFIG;
         }
     }
     static merge(user, flags, cwd = process.cwd()) {
         const merged = {
             // ...rest,
             ...user,
-            output: { ...default_config_1.DEFAULT_PRODEX_CONFIG.output, ...user.output },
+            output: { ...constants_1.DEFAULT_PRODEX_CONFIG.output, ...user.output },
             entry: {
-                ...default_config_1.DEFAULT_PRODEX_CONFIG.entry,
+                ...constants_1.DEFAULT_PRODEX_CONFIG.entry,
                 ...user.entry,
-                ui: { ...default_config_1.DEFAULT_PRODEX_CONFIG.entry.ui, ...user.entry?.ui },
+                ui: { ...constants_1.DEFAULT_PRODEX_CONFIG.entry.ui, ...user.entry?.ui },
             },
-            resolve: { ...default_config_1.DEFAULT_PRODEX_CONFIG.resolve, ...user.resolve },
+            resolve: { ...constants_1.DEFAULT_PRODEX_CONFIG.resolve, ...user.resolve },
             root: cwd,
             name: flags?.name ?? null,
         };

package/dist/core/output.js

@@ -11,7 +11,7 @@ const renderers_1 = require("./renderers");
 const logger_1 = require("../lib/logger");
 const utils_1 = require("../lib/utils");
 const questions_1 = require("../lib/questions");
-const config_1 = require("../constants/config");
+const constants_1 = require("../constants");
 /**
  * 🧩 produceOutput()
  * Handles rendering and writing of the final trace file.
@@ -27,7 +27,7 @@ async function produceOutput({ name, files, cfg, showUi }) {
             outputBase = result.outputBase;
     }
     // 2️⃣ Prefix timestamp if versioned
-    outputBase = `${outputBase}-${config_1.SUFFIX}`;
+    outputBase = `${outputBase}-${constants_1.SUFFIX}`;
     if (versioned)
         outputBase = `${outputBase}_${(0, utils_1.shortTimestamp)()}`;
     // 3️⃣ Ensure output directory

package/dist/core/renderers.js

@@ -10,18 +10,17 @@ exports.tocTxt = tocTxt;
 exports.renderTxt = renderTxt;
 const path_1 = __importDefault(require("path"));
 const shared_1 = require("../shared");
-const shared_2 = require("../shared");
 const constants_1 = require("../constants");
 /**
  * renderTraceMd()
- * Builds the full markdown document AND computes:
+ * Builds the full Markdown document AND computes:
  * - listing start/end lines
  * - each file section start/end lines (in the final output)
  */
 // src/core/renderers.ts
 function renderTraceMd(files) {
     const count = files.length;
-    // Render sections once (content of each file)
+    // Render sections at once (content of each file)
     const sections = files.map((f, i) => renderMd(f, i));
     // 1) Build a FIRST PASS doc with placeholder TOC (no line ranges)
     const pass1Toc = buildToc({
@@ -59,23 +58,26 @@ function renderTraceMd(files) {
 const rangeText = (start, end) => ` L${start}-L${end}`;
 function buildToc(opts) {
     const { files, count, listingStart, listingEnd, trace, withRanges } = opts;
+    const indexRange = withRanges && listingStart && listingEnd
+        ? `L${listingStart}-L${listingEnd}`
+        : constants_1.INDEX_RANGE_PLACEHOLDER;
     const tocHead = [
-        `# Index ${withRanges ? rangeText(listingStart, listingEnd) : ""} `,
-        "",
-        "> Note for LLMs: `Lx-Ly` ranges refer to lines in this Prodex trace file, not the original source files.",
-        "",
         constants_1.MD_HEADER,
+        constants_1.LLM_NOTE,
         "",
-        `Included Source Files: ${count}`,
+        "# Index",
+        `<!-- PRODEX_INDEX_RANGE: ${indexRange} -->`,
+        `<!-- PRODEX_FILE_COUNT: ${count} -->`,
+        "<!-- PRODEX_INDEX_LIST_START -->",
     ];
     const items = files.map((f, i) => {
-        const rp = (0, shared_2.rel)(f);
+        const rp = (0, shared_1.rel)(f);
         if (!withRanges || !trace)
             return `- [${rp}](#${i + 1})`;
         const t = trace[i];
         return `- [${rp}](#${i + 1}) ${rangeText(t.startLine, t.endLine)}`;
     });
-    const tocTail = ["", "---"];
+    const tocTail = ["<!-- PRODEX_INDEX_LIST_END -->", "", "---"];
     return [...tocHead, ...items, ...tocTail].join("\n");
 }
 /**
@@ -88,10 +90,28 @@ function buildToc(opts) {
 function analyzeTrace(content, count) {
     const lines = content.split("\n");
     // --- Listing range ---
-    const includedIdx = lines.findIndex((l) => /^Included Source Files\b/.test(l.trim()));
-    // listing begins on the next line after the header
-    const listingStart = includedIdx >= 0 ? includedIdx + 2 : 0; // 1-based
-    const listingEnd = count ? listingStart + count - 1 : listingStart;
+    const startMarkerIdx = lines.findIndex((l) => l.trim() === "<!-- PRODEX_INDEX_LIST_START -->");
+    const endMarkerIdx = lines.findIndex((l) => l.trim() === "<!-- PRODEX_INDEX_LIST_END -->");
+    let listingStart = 0;
+    let listingEnd = 0;
+    if (startMarkerIdx >= 0 && endMarkerIdx > startMarkerIdx) {
+        const itemIdxs = [];
+        for (let i = startMarkerIdx + 1; i < endMarkerIdx; i++) {
+            if (lines[i].trim().startsWith("- "))
+                itemIdxs.push(i);
+        }
+        if (itemIdxs.length) {
+            listingStart = itemIdxs[0] + 1; // 1-based
+            // count is zero during the first (placeholder) pass; cap to the requested count when provided, otherwise use the discovered items
+            const cappedCount = count > 0 ? Math.min(itemIdxs.length, count) : itemIdxs.length;
+            const lastItemIdx = itemIdxs[cappedCount - 1];
+            listingEnd = lastItemIdx + 1;
+        }
+        else {
+            listingStart = startMarkerIdx + 2; // move past the marker line (0-based) and convert to 1-based line numbers
+            listingEnd = listingStart;
+        }
+    }
     // --- Footer start (exclude footer from last file range) ---
     let footerMarkerIdx = lines.findIndex((l) => l.includes("<!-- PRODEx v"));
     if (footerMarkerIdx < 0)
@@ -147,11 +167,23 @@ function analyzeTrace(content, count) {
  */
 function tocMd(files) {
     const count = files.length;
-    const items = files.map((f, i) => `- [${(0, shared_2.rel)(f)}](#${i + 1})`).join("\n");
-    return ["# Index ", `\nIncluded Source Files (${count})`, items, "", "---"].join("\n");
+    const items = files.map((f, i) => `- [${(0, shared_1.rel)(f)}](#${i + 1})`);
+    return [
+        constants_1.MD_HEADER,
+        constants_1.LLM_NOTE,
+        "",
+        "# Index",
+        `<!-- PRODEX_INDEX_RANGE: ${constants_1.INDEX_RANGE_PLACEHOLDER} -->`,
+        `<!-- PRODEX_FILE_COUNT: ${count} -->`,
+        "<!-- PRODEX_INDEX_LIST_START -->",
+        ...items,
+        "<!-- PRODEX_INDEX_LIST_END -->",
+        "",
+        "---",
+    ].join("\n");
 }
 function renderMd(p, i) {
-    const rp = (0, shared_2.rel)(p);
+    const rp = (0, shared_1.rel)(p);
     const ext = path_1.default.extname(p).toLowerCase();
     const lang = constants_1.LANG_MAP[ext] || "txt";
     const code = (0, shared_1.readFileSafe)(p).trimEnd();
@@ -169,10 +201,10 @@ function renderMd(p, i) {
 // TXT versions unchanged
 function tocTxt(files) {
     const sorted = [...files].sort((a, b) => a.localeCompare(b));
-    return ["##==== Combined Scope ====", ...sorted.map((f) => "## - " + (0, shared_2.rel)(f))].join("\n") + "\n\n";
+    return ["##==== Combined Scope ====", ...sorted.map((f) => "## - " + (0, shared_1.rel)(f))].join("\n") + "\n\n";
 }
 function renderTxt(p) {
-    const relPath = (0, shared_2.rel)(p);
+    const relPath = (0, shared_1.rel)(p);
     const code = (0, shared_1.readFileSafe)(p);
     return ["##==== path: " + relPath + " ====", "##region " + relPath, code, "##endregion", ""].join("\n");
 }

package/dist/debug.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const index_1 = __importDefault(require("./index"));
 require("source-map-support/register");
 (async () => {
-    const mockArgs = ["node", "prodex", "@web", "-cd"];
+    const mockArgs = ["node", "prodex", "-i", "src/**", "-d"];
     process.argv = mockArgs;
     //"-f", "**/(dashboard|accounts).tsx",
     console.log("🧩 Debug runner starting...");

package/package.json

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