prodex 1.2.0 → 1.4.0

package/README.md

@@ -1,7 +1,6 @@
-
 # 🧩 Prodex v1.2.0
 
-> **Because every project deserves a clear map, not a maze.**
+> **Build the maze, I'll write a map.**
 
 ---
 
@@ -9,20 +8,24 @@
 
 - 🆕 **Full CLI support with integrated [Sade](https://github.com/lukeed/sade).**  
   Prodex now runs entirely from the terminal — no `prodex.json` required.  
-  Supports short flags and native glob patterns for flexible targeting.  
-  ```bash
-  prodex -f "**/web.php,**/app.tsx" -i "**/*.d.ts" -x "node_modules/**"
-  prodex --files **/web.php **/app.tsx --include **/*.interface.ts --exclude @shadcn/**
-  ```
+  Supports short flags and native glob patterns for flexible targeting.
+
+     ```bash
+     prodex -f "**/web.php,**/app.tsx" -i "**/*.d.ts" -x "node_modules/**"
+     ```
+
+     ```bash
+     prodex --files "**/web.php,**/app.tsx" --include **/*types.ts --exclude "@shadcn/**"
+     ```
 
 - 🧾 **Markdown mode added and now default.**  
   Output is fully fenced and linkable — jump between the index and any code block.  
-  Text mode remains available using `--txt` or `-t`.  
+  Text mode remains available using `--txt` or `-t`.
 
 - 🗂 **Output naming improved.**  
   Output files are now versioned by default.  
   Custom names are supported using `--name` or `-n`.  
-  Naming conventions have been updated for cleaner, consistent results.  
+  Naming conventions have been updated for cleaner, consistent results.
 
 ---
 
@@ -59,16 +62,16 @@ prodex -f "**/web.php,**/app.tsx" -i "**/*.d.ts" -x "node_modules/**" -n "combin
 
 ### Flag Reference
 
-| Flag | Short | Description |
-|------|--------|-------------|
-| `--files` | `-f` | Entry files — starting points for dependency resolution. Accepts multiple names or globs. |
-| `--include` | `-i` | Adds extra files or patterns to include (e.g. `.d.ts`, interface, or type files). These files are **not dependency-resolved** — they’re appended as-is. |
-| `--exclude` | `-x` | Patterns or folders to skip during the scan. |
-| `--name` | `-n` | Custom output filename (without extension). Versioning still applies automatically. |
+| Flag        | Short | Description                                                                                                                                             |
+| ----------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--files`   | `-f`  | Entry files — starting points for dependency resolution. Accepts multiple names or globs.                                                               |
+| `--include` | `-i`  | Adds extra files or patterns to include (e.g. `.d.ts`, interface, or type files). These files are **not dependency-resolved** — they’re appended as-is. |
+| `--exclude` | `-x`  | Patterns or folders to skip during the scan.                                                                                                            |
+| `--name`    | `-n`  | Custom output filename (without extension). Versioning still applies automatically.                                                                     |
 
 > Globs are powered by [Fast-Glob](https://github.com/mrmlnc/fast-glob).  
 > Use **comma-separated values** for multiple entries.  
-> Wrap globs in quotes when they include special characters like `|` or `&`.  
+> Wrap globs in quotes when they include special characters like `|` or `&`.
 
 ---
 
@@ -84,28 +87,28 @@ prodex -f "**/web.php,**/app.tsx" -i "**/*.d.ts" -x "node_modules/**" -n "combin
 
 - **Combined Output**  
   All code from multiple entries is merged into a single output file.  
-  There’s currently **no limit** on output size, but it’s advised to avoid combining *too many large entries* in a single run.  
+  There’s currently **no limit** on output size, but it’s advised to avoid combining _too many large entries_ in a single run.  
   Future versions will include **smart naming** and **automatic splitting** for oversized outputs.
 
 - **Performance Optimizations**  
-  Planned improvements to resolver speed and dependency traversal for faster processing on large projects.  
+  Planned improvements to resolver speed and dependency traversal for faster processing on large projects.
 
 ---
 
 ## 🧩 Features
 
-| Status | Feature | Description |
-|:--:|----------|--------------|
-| ✅ | **Cross-language indexing** | Resolves imports across JS, TS, React, and PHP (Laravel) projects. |
-| ✅ | **Markdown output** | Generates clean `.md` files with anchors, back-to-top links, and fenced code blocks. |
-| ✅ | **Text output** | Optional `.txt` mode using `--txt` or `-t`. |
-| ✅ | **Glob support** | Works with flexible glob patterns powered by [Fast-Glob](https://github.com/mrmlnc/fast-glob). |
-| ✅ | **Custom output names** | Define your own output prefix using `--name` or `-n`. |
-| ⚠️ | **Interactive picker (UI)** | Still unstable — not recommended for production use. |
-| ⚠️ | **Alias resolution** | Basic alias mapping supported; advanced cases in progress. |
-| 🚧 | **Smart file splitting** | Planned for large combined outputs. |
-| 🚧 | **PSR-4 deep scan** | Planned to improve PHP dependency resolution. |
-| 🚧 | **Speed optimization** | Further resolver and I/O improvements under development. |
+| Status | Feature                     | Description                                                                                    |
+| :----: | --------------------------- | ---------------------------------------------------------------------------------------------- |
+|   ✅   | **Cross-language indexing** | Resolves imports across JS, TS, React, and PHP (Laravel) projects.                             |
+|   ✅   | **Markdown output**         | Generates clean `.md` files with anchors, back-to-top links, and fenced code blocks.           |
+|   ✅   | **Text output**             | Optional `.txt` mode using `--txt` or `-t`.                                                    |
+|   ✅   | **Glob support**            | Works with flexible glob patterns powered by [Fast-Glob](https://github.com/mrmlnc/fast-glob). |
+|   ✅   | **Custom output names**     | Define your own output prefix using `--name` or `-n`.                                          |
+|   ⚠️   | **Interactive picker (UI)** | Still unstable — not recommended for production use.                                           |
+|   ⚠️   | **Alias resolution**        | Basic alias mapping supported; advanced cases in progress.                                     |
+|   🚧   | **Smart file splitting**    | Planned for large combined outputs.                                                            |
+|   🚧   | **PSR-4 deep scan**         | Planned to improve PHP dependency resolution.                                                  |
+|   🚧   | **Speed optimization**      | Further resolver and I/O improvements under development.                                       |
 
 ---
 
@@ -148,24 +151,27 @@ then appends any files matched by the `--include` flag.
 ### 🧠 Suggested Pattern
 
 1. **Pick a meaningful entry file**  
-   Example:  
-   - Frontend: `resources/js/**/dashboard.tsx`  
-   - Backend: `routes/**/(web|api).php`  
-   - Shared logic: `app/Services/**/PaymentService.php`
-
-2. **Run Prodex with includes for type or interface files**  
-   ```bash
-   prodex -f "**/dashboard.tsx" -i "**/*.d.ts,**/*.interface.ts"
-   ```
-
-3. **Export separate maps for each major area**  
-   ```bash
-   prodex -f "**/dashboard.tsx" -n "dashboard-map"
-   prodex -f "**/web|api.php" -n "backend-map"
-   ```
+   Example:
+
+      - Frontend: `resources/js/**/dashboard.tsx`
+      - Backend: `routes/**/(web|api).php`
+      - Shared logic: `app/Services/**/PaymentService.php`
+
+2. **Run Prodex with includes for type or interface files**
+
+      ```bash
+      prodex -f "**/dashboard.tsx" -i "**/*.d.ts,**/*.interface.ts"
+      ```
+
+3. **Export separate maps for each major area**
+
+      ```bash
+      prodex -f "**/dashboard.tsx" -n "dashboard-map"
+      prodex -f "**/(web|api).php" -n "backend-map"
+      ```
 
 4. **Use them together**  
-   Store each output in `/prodex/` or `/docs/maps/`.  
+   Store each output in `/prodex/`
    These maps can be shared with teammates or loaded into AI tools for structured, code-aware assistance.
 
 > ⚡ Each run recursively resolves every import, applies includes, and outputs one complete dependency map for that section.
@@ -197,7 +203,7 @@ prodex -c
 ```
 
 The `-c` (or `--ci`) flag skips interactive mode and uses the config values automatically.  
-Specifying `-f` ( or `--files`) from the CLI also disables the picker by default.  
+Specifying `-f` ( or `--files`) from the CLI also disables the picker by default.
 
 You can permanently disable the picker in the config by setting:
 
@@ -222,7 +228,7 @@ You can permanently disable the picker in the config by setting:
 
 Prodex is still a **work in progress**.  
 Some parts of the experience may be rough, especially around interactive mode and advanced resolvers.  
-Updates are released **multiple times per week — sometimes daily** — to keep improving stability and support.  
+Updates are released **multiple times per week — sometimes daily** — to keep improving stability and support.
 
 Please stay up to date for the best experience.  
-Thank you for testing Prodex early. ❤️  
+Thank you for testing Prodex early. ❤️

package/dist/cli/cli-input.js

@@ -5,45 +5,26 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseCliInput = parseCliInput;
 const sade_1 = __importDefault(require("sade"));
-const flags_1 = require("./flags");
-const logger_1 = require("../lib/logger");
 const path_1 = __importDefault(require("path"));
 const package_json_1 = __importDefault(require("../../package.json"));
+const fs_1 = __importDefault(require("fs"));
+const flags_1 = require("../constants/flags");
 /**
- * Unified CLI parser powered by Sade.
- * Returns { root, entries (from --files), flags, warnings, errors }.
+ * Unified CLI parser powered by Sade and FLAG_MAP.
+ * Returns { root, flags, warnings, errors }.
  */
 function parseCliInput(argv = process.argv) {
     if (argv.includes("-v") || argv.includes("--version")) {
-        logger_1.logger.log(`prodex v${package_json_1.default.version}`);
+        console.log(`prodex v${package_json_1.default.version}`);
         process.exit(0);
     }
     const program = (0, sade_1.default)("prodex [root]");
-    // Register flags dynamically
-    for (const [key, meta] of Object.entries(flags_1.PRODEX_FLAGS)) {
-        const short = meta.short ? `-${meta.short}, ` : "";
-        const long = `--${key}`;
-        const desc = meta.description;
-        let defaultVal;
-        switch (meta.type) {
-            case "boolean":
-                defaultVal = false;
-                break;
-            default:
-                defaultVal = undefined; // defer strings/numbers/lists
-        }
-        if (defaultVal !== undefined) {
-            program.option(`${short}${long}`, desc, defaultVal);
-        }
-        else {
-            program.option(`${short}${long}`, desc);
-        }
-    }
-    let parsed = { root: undefined, flags: {} };
-    // Define default command (root optional)
+    registerFlags(program);
+    let parsed = { rootArg: "", root: undefined, flags: {} };
     program.action((root, opts) => {
         const cwd = process.cwd();
         parsed = {
+            rootArg: root,
             root: root ? path_1.default.resolve(cwd, root) : cwd,
             flags: { ...opts },
         };
@@ -51,36 +32,70 @@ function parseCliInput(argv = process.argv) {
     program.parse(argv);
     const warnings = [];
     const errors = [];
-    // Post-parse casting + normalization
-    for (const [key, meta] of Object.entries(flags_1.PRODEX_FLAGS)) {
-        const raw = parsed.flags[key];
+    parsed.flags = normalizeFlags(parsed.flags, warnings, errors);
+    validateArgs(parsed, warnings, errors);
+    return { ...parsed, warnings, errors };
+}
+function registerFlags(program) {
+    for (const [key, meta] of Object.entries(flags_1.FLAG_MAP)) {
+        const short = meta.short ? `-${meta.short}, ` : "";
+        const long = `--${key}`;
+        const desc = meta.description;
+        const defaultVal = meta.type === "boolean" ? false : undefined;
+        program.option(`${short}${long}`, desc, defaultVal);
+    }
+}
+/** Convert flag values to correct types based on FLAG_MAP metadata. */
+function normalizeFlags(flags, warnings, errors) {
+    for (const [key, meta] of Object.entries(flags_1.FLAG_MAP)) {
+        const raw = flags[key];
         if (raw === undefined)
             continue;
-        const obj = {};
         switch (meta.type) {
             case "number": {
                 const num = Number(raw);
-                if (Number.isNaN(num)) {
+                if (Number.isNaN(num))
                     errors.push(`Flag --${key} expected a number but got "${raw}"`);
-                }
-                else {
-                    parsed.flags[key] = num;
-                }
+                else
+                    flags[key] = num;
                 break;
             }
             case "list": {
-                const arr = String(raw)
+                flags[key] = String(raw)
                     .split(",")
                     .map((v) => v.trim())
                     .filter(Boolean);
-                parsed.flags[key] = arr;
                 break;
             }
+            default: {
+                if (meta.type === "string")
+                    flags[key] = String(raw);
+            }
         }
     }
-    return {
-        ...parsed,
-        warnings,
-        errors,
-    };
+    return flags;
+}
+/** Validate path argument and report unrecognized flags. */
+function validateArgs(parsed, warnings, errors) {
+    const { rootArg } = parsed;
+    if (rootArg) {
+        if (!fs_1.default.existsSync(parsed.root)) {
+            errors.push(`Invalid path argument: "${rootArg}" does not exist.`);
+        }
+        else if (!fs_1.default.statSync(parsed.root).isDirectory()) {
+            errors.push(`Path argument "${rootArg}" is not a directory.`);
+        }
+    }
+    const unknown = parsed.flags?._ || [];
+    if (unknown.length) {
+        warnings.push(`Unrecognized arguments detected [${unknown.join(", ")}]- They were ignored.`);
+    }
+    if (warnings.length)
+        console.warn("Warnings:", warnings);
+    if (errors.length) {
+        for (const err of errors)
+            console.error(err);
+        process.exit(1);
+    }
 }
+//# sourceMappingURL=cli-input.js.map

package/dist/cli/cli-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-input.js","sourceRoot":"","sources":["../../src/cli/cli-input.ts"],"names":[],"mappings":"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","sourcesContent":["import sade from \"sade\";\nimport path from \"path\";\nimport pkg from \"../../package.json\";\nimport fs from \"fs\";\nimport { FLAG_MAP } from \"../constants/flags\";\nimport type { ParsedInput } from \"../types\";\n\n/**\n * Unified CLI parser powered by Sade and FLAG_MAP.\n * Returns { root, flags, warnings, errors }.\n */\nexport function parseCliInput(argv: string[] = process.argv) {\n\tif (argv.includes(\"-v\") || argv.includes(\"--version\")) {\n\t\tconsole.log(`prodex v${pkg.version}`);\n\t\tprocess.exit(0);\n\t}\n\n\tconst program = sade(\"prodex [root]\");\n\tregisterFlags(program);\n\n\tlet parsed: ParsedInput = { rootArg: \"\", root: undefined, flags: {} };\n\n\tprogram.action((root: string | undefined, opts: Record<string, any>) => {\n\t\tconst cwd = process.cwd();\n\t\tparsed = {\n\t\t\trootArg: root,\n\t\t\troot: root ? path.resolve(cwd, root) : cwd,\n\t\t\tflags: { ...opts },\n\t\t};\n\t});\n\n\tprogram.parse(argv);\n\n\tconst warnings: string[] = [];\n\tconst errors: string[] = [];\n\n\tparsed.flags = normalizeFlags(parsed.flags, warnings, errors);\n\tvalidateArgs(parsed, warnings, errors);\n\n\treturn { ...parsed, warnings, errors };\n}\n\nfunction registerFlags(program: ReturnType<typeof sade>) {\n\tfor (const [key, meta] of Object.entries(FLAG_MAP)) {\n\t\tconst short = meta.short ? `-${meta.short}, ` : \"\";\n\t\tconst long = `--${key}`;\n\t\tconst desc = meta.description;\n\t\tconst defaultVal = meta.type === \"boolean\" ? false : undefined;\n\t\tprogram.option(`${short}${long}`, desc, defaultVal);\n\t}\n}\n\n/** Convert flag values to correct types based on FLAG_MAP metadata. */\nfunction normalizeFlags(flags: Record<string, any>, warnings: string[], errors: string[]) {\n\tfor (const [key, meta] of Object.entries(FLAG_MAP)) {\n\t\tconst raw = flags[key];\n\t\tif (raw === undefined) continue;\n\n\t\tswitch (meta.type) {\n\t\t\tcase \"number\": {\n\t\t\t\tconst num = Number(raw);\n\t\t\t\tif (Number.isNaN(num)) errors.push(`Flag --${key} expected a number but got \"${raw}\"`);\n\t\t\t\telse flags[key] = num;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"list\": {\n\t\t\t\tflags[key] = String(raw)\n\t\t\t\t\t.split(\",\")\n\t\t\t\t\t.map((v) => v.trim())\n\t\t\t\t\t.filter(Boolean);\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tdefault: {\n\t\t\t\tif (meta.type === \"string\") flags[key] = String(raw);\n\t\t\t}\n\t\t}\n\t}\n\treturn flags;\n}\n\n/** Validate path argument and report unrecognized flags. */\nfunction validateArgs(parsed: ParsedInput, warnings: string[], errors: string[]) {\n\tconst { rootArg } = parsed;\n\n\tif (rootArg) {\n\t\tif (!fs.existsSync(parsed.root)) {\n\t\t\terrors.push(`Invalid path argument: \"${rootArg}\" does not exist.`);\n\t\t} else if (!fs.statSync(parsed.root).isDirectory()) {\n\t\t\terrors.push(`Path argument \"${rootArg}\" is not a directory.`);\n\t\t}\n\t}\n\n\tconst unknown = parsed.flags?._ || [];\n\tif (unknown.length) {\n\t\twarnings.push(`Unrecognized arguments detected [${unknown.join(\", \")}]- They were ignored.`);\n\t}\n\n\tif (warnings.length) console.warn(\"Warnings:\", warnings);\n\tif (errors.length) {\n\t\tfor (const err of errors) console.error(err);\n\t\tprocess.exit(1);\n\t}\n}\n"]}

package/dist/cli/flags.js

@@ -40,3 +40,4 @@ Usage: prodex [-fcdv]
        [--limit=<int>|-l=<int>]
        [--help|-h]
 `;
+//# sourceMappingURL=flags.js.map

package/dist/cli/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../src/cli/flags.ts"],"names":[],"mappings":";;;AAMA,IAAY,OAUX;AAVD,WAAY,OAAO;IAClB,sBAAW,CAAA;IACX,oBAAS,CAAA;IACT,0BAAe,CAAA;IACf,wBAAa,CAAA;IACb,0BAAe,CAAA;IACf,0BAAe,CAAA;IACf,0BAAe,CAAA;IACf,wBAAa,CAAA;IACb,0BAAe,CAAA;AAChB,CAAC,EAVW,OAAO,uBAAP,OAAO,QAUlB;AAOY,QAAA,YAAY,GAA0B;IAClD,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,8BAA8B,EAAE;IAC1F,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,gCAAgC,EAAE;IAC7F,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sBAAsB,EAAE;IAClF,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,oBAAoB,EAAE;IACnF,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;IACtF,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;IACzF,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,gCAAgC,EAAE;IAC1F,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,gCAAgC,EAAE;IAC1F,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,yBAAyB,EAAE;CACvF,CAAC;AAEF,wCAAwC;AAC3B,QAAA,cAAc,GAA4B,MAAM,CAAC,OAAO,CAAC,oBAAY,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;IAC/G,IAAI,IAAI,CAAC,KAAK;QAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAc,CAAC;IACjD,OAAO,GAAG,CAAC;AACZ,CAAC,EAAE,EAA6B,CAAC,CAAC;AAGrB,QAAA,SAAS,GAAG;;;;;;;;;CASxB,CAAC","sourcesContent":["/**\n * 🧩 Prodex Flag Definitions (v3)\n * Metadata used by the CLI parser for validation, casting, and help output.\n */\nexport type FlagType = \"boolean\" | \"string\" | \"number\" | \"list\";\n\nexport enum FlagKey {\n\tTxt = \"txt\",\n\tCi = \"ci\",\n\tDebug = \"debug\",\n\tName = \"name\",\n\tLimit = \"limit\",\n\tInc = \"include\",\n\tExc = \"exclude\",\n\tHelp = \"help\",\n\tFiles = \"files\",\n}\n\ntype Spec = {\n\tshort?: string;\n\ttype: FlagType;\n\tdescription: string;\n};\nexport const PRODEX_FLAGS: Record<FlagKey, Spec> = {\n\t[FlagKey.Files]: { short: \"f\", type: \"list\", description: \"Comma-separated entry files.\" },\n\t[FlagKey.Txt]: { short: \"t\", type: \"boolean\", description: \"Output as .txt instead of .md.\" },\n\t[FlagKey.Ci]: { short: \"c\", type: \"boolean\", description: \"Headless/no-UI mode.\" },\n\t[FlagKey.Debug]: { short: \"d\", type: \"boolean\", description: \"Enable debug logs.\" },\n\t[FlagKey.Name]: { short: \"n\", type: \"string\", description: \"Custom output filename.\" },\n\t[FlagKey.Limit]: { short: \"l\", type: \"number\", description: \"Override traversal limit.\" },\n\t[FlagKey.Inc]: { type: \"list\", short: \"i\", description: \"Comma-separated include globs.\" },\n\t[FlagKey.Exc]: { type: \"list\", short: \"x\", description: \"Comma-separated exclude globs.\" },\n\t[FlagKey.Help]: { short: \"h\", type: \"boolean\", description: \"Show CLI help and exit.\" },\n};\n\n/** Reverse lookup for short aliases. */\nexport const FLAG_SHORT_MAP: Record<string, FlagKey> = Object.entries(PRODEX_FLAGS).reduce((acc, [key, meta]) => {\n\tif (meta.short) acc[meta.short] = key as FlagKey;\n\treturn acc;\n}, {} as Record<string, FlagKey>);\n\n\nexport const CLI_USAGE = `\nUsage: prodex [-fcdv]\n       [--files=<globs>|-f=<globs>]\n       [--include=<globs>|-i=<globs>]\n       [--exclude=<globs>|-x=<globs>]\n       [--txt|-t] [--ci|-c] [--debug|-d] [--version|-v]\n       [--name=<string>|-n=<string>]\n       [--limit=<int>|-l=<int>]\n       [--help|-h]\n`;\n"]}

package/dist/cli/init.js

@@ -7,15 +7,15 @@ exports.initProdex = initProdex;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const default_config_1 = require("../constants/default-config");
-const logger_1 = require("../lib/logger");
 async function initProdex() {
-    logger_1.logger.log("🪄 Prodex Init — Configuration Wizard (v2)");
+    console.log("🪄 Prodex Init — Configuration Wizard (v3");
     const dest = path_1.default.join(process.cwd(), "prodex.json");
     if (fs_1.default.existsSync(dest)) {
-        logger_1.logger.error("prodex.json already exists. Delete or modify it manually.\n");
+        console.error("prodex.json already exists. Delete or modify it manually.\n");
         return;
     }
     fs_1.default.writeFileSync(dest, JSON.stringify(default_config_1.DEFAULT_PRODEX_CONFIG, null, 2) + "\n", "utf8");
-    logger_1.logger.log(`✅ Created ${dest}`);
-    logger_1.logger.log("💡 Globs supported everywhere (include, exclude, priority).");
+    console.log(`✅ Created ${dest}`);
+    console.log("💡 Globs supported everywhere (include, exclude, priority).");
 }
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":";;;;;AAIA,gCAaC;AAjBD,4CAAoB;AACpB,gDAAwB;AACxB,gEAAoE;AAE7D,KAAK,UAAU,UAAU;IAC/B,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;IAEzD,MAAM,IAAI,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,CAAC,CAAC;IAErD,IAAI,YAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;QAC7E,OAAO;IACR,CAAC;IAED,YAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,sCAAqB,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IACtF,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;AAC5E,CAAC","sourcesContent":["import fs from \"fs\";\nimport path from \"path\";\nimport { DEFAULT_PRODEX_CONFIG } from \"../constants/default-config\";\n\nexport async function initProdex() {\n\tconsole.log(\"🪄 Prodex Init — Configuration Wizard (v3\");\n\n\tconst dest = path.join(process.cwd(), \"prodex.json\");\n\n\tif (fs.existsSync(dest)) {\n\t\tconsole.error(\"prodex.json already exists. Delete or modify it manually.\\n\");\n\t\treturn;\n\t}\n\n\tfs.writeFileSync(dest, JSON.stringify(DEFAULT_PRODEX_CONFIG, null, 2) + \"\\n\", \"utf8\");\n\tconsole.log(`✅ Created ${dest}`);\n\tconsole.log(\"💡 Globs supported everywhere (include, exclude, priority).\");\n}\n"]}

package/dist/cli/picker.js

@@ -7,76 +7,78 @@ exports.pickEntries = pickEntries;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const inquirer_1 = __importDefault(require("inquirer"));
-const config_1 = require("../constants/config");
 const helpers_1 = require("../core/helpers");
-const file_utils_1 = require("../core/file-utils");
-const utils_1 = require("../lib/utils");
+const io_1 = require("../shared/io");
+const helpers_2 = require("../core/helpers");
+const collections_1 = require("../shared/collections");
 const logger_1 = require("../lib/logger");
-async function pickEntries(baseDirs, depth = 2, cfg) {
-    const entryPatterns = cfg.entry?.files || [];
-    const priorities = [...entryPatterns, ...(cfg.entry?.priority || [])];
-    const verbose = !!cfg.verbose;
-    // 1) Resolve patterns to absolute files and preselect them
-    const resolvedEntries = (await (0, file_utils_1.globScan)(entryPatterns, { cwd: config_1.ROOT })).files;
+const prompt_1 = require("../lib/prompt");
+const questions_1 = require("../lib/questions");
+/**
+ * Interactive entry picker for Prodex.
+ * Handles depth-based scanning, caching, and priority ordering.
+ */
+async function pickEntries(cfg) {
+    const { root, entry: { files, ui: { roots = [], priority = [], scanDepth }, }, } = cfg;
+    let depth = scanDepth;
+    const entryPatterns = files || [];
+    const priorities = [...entryPatterns, ...priority];
+    // 1️⃣ Resolve pre-defined entry patterns
+    const resolvedEntries = (await (0, helpers_2.globScan)(entryPatterns, { cwd: root })).files;
     let selected = [...resolvedEntries];
-    // cache: depth -> files[]
+    // cache: depth → files[]
     const scanCache = new Map();
     for (;;) {
-        const files = await getFilesAtDepth({
-            baseDirs,
-            depth,
-            cfg,
-            scanCache,
-            verbose,
-        });
+        const files = await getFilesAtDepth(depth, cfg, scanCache);
         // Merge resolved entries with current scan results
-        const combined = (0, utils_1.unique)([...resolvedEntries, ...files]);
-        // Priority-aware ordering: entries first, then other priorities
+        const combined = (0, collections_1.unique)([...resolvedEntries, ...files]);
         const sorted = (0, helpers_1.orderByPriority)(combined, priorities);
         // Build UI selection list
-        const choices = sorted.map(f => ({
-            name: path_1.default.relative(config_1.ROOT, f).norm(),
+        const choices = sorted.map((f) => ({
+            name: (0, io_1.rel)(f, root),
             value: f,
             checked: selected.includes(f),
         }));
-        choices.push(new inquirer_1.default.Separator());
-        choices.push({ name: "🔽 Load more (go deeper)", value: "__loadmore" });
-        const { picks } = await inquirer_1.default.prompt([
-            {
-                type: "checkbox",
-                name: "picks",
-                message: `Select entry files (depth ${depth})`,
-                choices,
-                loop: false,
-                pageSize: 20,
-            }
-        ]);
+        if (depth < scanDepth + 5) {
+            choices.push(new inquirer_1.default.Separator());
+            choices.push({ name: "🔽 Load more (go deeper)", value: "__loadmore" });
+        }
+        // 🧠 Use unified prompt wrapper
+        const answers = await (0, prompt_1.prompt)((0, questions_1.PICK_ENTRIES_QUESTION)(choices, depth), { picks: [] });
+        if (!answers)
+            return (0, collections_1.unique)(selected);
+        const { picks } = answers;
         if (picks.includes("__loadmore")) {
             depth++;
-            selected = picks.filter(p => p !== "__loadmore");
+            selected = picks.filter((p) => p !== "__loadmore");
             continue;
         }
-        selected = picks.filter(p => p !== "__loadmore");
+        selected = picks.filter((p) => p !== "__loadmore");
         break;
     }
-    return (0, utils_1.unique)(selected);
+    return (0, collections_1.unique)(selected);
 }
-async function getFilesAtDepth({ baseDirs, depth, cfg, scanCache, verbose }) {
+/**
+ * Depth-based directory scanner with caching.
+ */
+async function getFilesAtDepth(depth, cfg, scanCache) {
+    const baseDirs = cfg.entry.ui.roots || [];
     if (scanCache.has(depth)) {
-        logger_1.logger.debug(`[cache] depth=${depth} ✓`);
+        logger_1.logger.debug(`[picker] cache hit → depth=${depth}`);
         return scanCache.get(depth);
     }
-    logger_1.logger.debug(`[scan]  depth=${depth} …`);
+    logger_1.logger.debug(`[picker] scanning → depth=${depth}`);
     const files = [];
     const effectiveCfg = { ...cfg, scanDepth: depth };
     for (const base of baseDirs) {
-        const full = path_1.default.join(config_1.ROOT, base);
+        const full = path_1.default.join(cfg.root, base);
         if (!fs_1.default.existsSync(full))
             continue;
         for (const f of (0, helpers_1.walk)(full, effectiveCfg, 0))
             files.push(f.norm());
     }
     scanCache.set(depth, files);
-    logger_1.logger.debug(`[scan]  depth=${depth} found=${files.length}`);
+    logger_1.logger.debug(`[picker] depth=${depth} found=${files.length}`);
     return files;
 }
+//# sourceMappingURL=picker.js.map

package/dist/cli/picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"picker.js","sourceRoot":"","sources":["../../src/cli/picker.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"fs\";\nimport path from \"path\";\nimport inquirer from \"inquirer\";\nimport { walk, orderByPriority } from \"../core/helpers\";\nimport { rel } from \"../shared/io\";\nimport { globScan } from \"../core/helpers\";\nimport { unique } from \"../shared/collections\";\nimport { logger } from \"../lib/logger\";\nimport { prompt } from \"../lib/prompt\";\nimport type { QuestionSet, ProdexConfig } from \"../types\";\nimport { PICK_ENTRIES_QUESTION } from \"../lib/questions\";\n\n/**\n * Interactive entry picker for Prodex.\n * Handles depth-based scanning, caching, and priority ordering.\n */\nexport async function pickEntries(cfg: ProdexConfig) {\n\tconst {\n\t\troot,\n\t\tentry: {\n\t\t\tfiles,\n\t\t\tui: { roots = [], priority = [], scanDepth },\n\t\t},\n\t} = cfg;\n\n\tlet depth = scanDepth;\n\tconst entryPatterns = files || [];\n\tconst priorities = [...entryPatterns, ...priority];\n\n\t// 1️⃣ Resolve pre-defined entry patterns\n\tconst resolvedEntries = (await globScan(entryPatterns, { cwd: root })).files;\n\tlet selected = [...resolvedEntries];\n\n\t// cache: depth → files[]\n\tconst scanCache = new Map<number, string[]>();\n\n\tfor (;;) {\n\t\tconst files = await getFilesAtDepth(depth, cfg, scanCache);\n\n\t\t// Merge resolved entries with current scan results\n\t\tconst combined = unique([...resolvedEntries, ...files]);\n\t\tconst sorted = orderByPriority(combined, priorities);\n\n\t\t// Build UI selection list\n\t\tconst choices = sorted.map((f) => ({\n\t\t\tname: rel(f, root),\n\t\t\tvalue: f,\n\t\t\tchecked: selected.includes(f),\n\t\t}));\n\n\t\tif (depth < scanDepth + 5) {\n\t\t\tchoices.push(new inquirer.Separator());\n\t\t\tchoices.push({ name: \"🔽 Load more (go deeper)\", value: \"__loadmore\" });\n\t\t}\n\n\t\t// 🧠 Use unified prompt wrapper\n\t\tconst answers = await prompt(PICK_ENTRIES_QUESTION(choices, depth), { picks: [] });\n\t\tif (!answers) return unique(selected);\n\n\t\tconst { picks } = answers;\n\n\t\tif (picks.includes(\"__loadmore\")) {\n\t\t\tdepth++;\n\t\t\tselected = picks.filter((p) => p !== \"__loadmore\");\n\t\t\tcontinue;\n\t\t}\n\n\t\tselected = picks.filter((p) => p !== \"__loadmore\");\n\t\tbreak;\n\t}\n\n\treturn unique(selected);\n}\n\n/**\n * Depth-based directory scanner with caching.\n */\nasync function getFilesAtDepth(depth: number, cfg: ProdexConfig, scanCache: Map<number, string[]>) {\n\tconst baseDirs = cfg.entry.ui.roots || [];\n\tif (scanCache.has(depth)) {\n\t\tlogger.debug(`[picker] cache hit → depth=${depth}`);\n\t\treturn scanCache.get(depth)!;\n\t}\n\n\tlogger.debug(`[picker] scanning → depth=${depth}`);\n\n\tconst files: string[] = [];\n\tconst effectiveCfg = { ...cfg, scanDepth: depth };\n\n\tfor (const base of baseDirs) {\n\t\tconst full = path.join(cfg.root, base);\n\t\tif (!fs.existsSync(full)) continue;\n\t\tfor (const f of walk(full, effectiveCfg, 0)) files.push(f.norm());\n\t}\n\n\tscanCache.set(depth, files);\n\tlogger.debug(`[picker] depth=${depth} found=${files.length}`);\n\treturn files;\n}\n"]}

package/dist/cli/summary.js

@@ -1,14 +1,33 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.showSummary = showSummary;
-exports.importSummary = importSummary;
+exports.endSummary = endSummary;
+exports.introSummary = introSummary;
+exports.entrySummary = entrySummary;
 const logger_1 = require("../lib/logger");
-function showSummary({ outDir, fileName, entries }) {
-    logger_1.logger.debug(`🧩 Active Run → ${fileName} (${entries.length} entries)`);
-}
-function importSummary(result) {
-    logger_1.logger.debug(`\n🧩 Summary:
- • Unique imports expected: ${result.stats.expected.size}
- • Unique imports resolved: ${result.stats.resolved.size}
+const io_1 = require("../shared/io");
+const store_1 = require("../store");
+let CONFIG;
+let FLAGS;
+function endSummary(out, result) {
+    logger_1.logger.debug(`🧩 Summary:
+ • Unique imports expected: ${result?.stats?.expected.size}
+ • Unique imports resolved: ${result?.stats?.resolved.size}
 `);
+    logger_1.logger.log(`✅ ${out.norm()}`);
+}
+function introSummary() {
+    CONFIG = (0, store_1.getConfig)();
+    FLAGS = (0, store_1.getFlags)();
+    logger_1.logger.log(`------- PRODEx RUN @ ${new Date().toLocaleTimeString()} — Codebase decoded -------\n`);
+    // Log parse results for testing
+    logger_1.logger.debug("🧩 Parsed CLI input:", _2j({ FLAGS }));
+    logger_1.logger.debug("Final merged config:", _2j(CONFIG));
+}
+function entrySummary(entries) {
+    let result = "📋 You selected:";
+    for (const e of entries)
+        result += "\n   -" + (0, io_1.rel)(e);
+    if (entries?.length)
+        logger_1.logger.log(result);
 }
+//# sourceMappingURL=summary.js.map

package/dist/cli/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../src/cli/summary.ts"],"names":[],"mappings":";;AAMA,gCAMC;AAED,oCAQC;AAED,oCAIC;AA5BD,0CAAuC;AACvC,qCAAmC;AACnC,oCAA+C;AAE/C,IAAI,MAAM,CAAC;AACX,IAAI,KAAK,CAAC;AACV,SAAgB,UAAU,CAAC,GAAG,EAAE,MAAM;IACrC,eAAM,CAAC,KAAK,CAAC;8BACgB,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI;8BAC5B,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI;CACzD,CAAC,CAAC;IACF,eAAM,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,SAAgB,YAAY;IAC3B,MAAM,GAAG,IAAA,iBAAS,GAAE,CAAC;IACrB,KAAK,GAAG,IAAA,gBAAQ,GAAE,CAAC;IAEnB,eAAM,CAAC,GAAG,CAAC,wBAAwB,IAAI,IAAI,EAAE,CAAC,kBAAkB,EAAE,+BAA+B,CAAC,CAAC;IACnG,gCAAgC;IAChC,eAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACrD,eAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,SAAgB,YAAY,CAAC,OAAiB;IAC7C,IAAI,MAAM,GAAG,kBAAkB,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,OAAO;QAAE,MAAM,IAAI,QAAQ,GAAG,IAAA,QAAG,EAAC,CAAC,CAAC,CAAC;IACrD,IAAI,OAAO,EAAE,MAAM;QAAE,eAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC","sourcesContent":["import { logger } from \"../lib/logger\";\nimport { rel } from \"../shared/io\";\nimport { getConfig, getFlags } from \"../store\";\n\nlet CONFIG;\nlet FLAGS;\nexport function endSummary(out, result) {\n\tlogger.debug(`🧩 Summary:\n • Unique imports expected: ${result?.stats?.expected.size}\n • Unique imports resolved: ${result?.stats?.resolved.size}\n`);\n\tlogger.log(`✅ ${out.norm()}`);\n}\n\nexport function introSummary() {\n\tCONFIG = getConfig();\n\tFLAGS = getFlags();\n\n\tlogger.log(`------- PRODEx RUN @ ${new Date().toLocaleTimeString()} — Codebase decoded -------\\n`);\n\t// Log parse results for testing\n\tlogger.debug(\"🧩 Parsed CLI input:\", _2j({ FLAGS }));\n\tlogger.debug(\"Final merged config:\", _2j(CONFIG));\n}\n\nexport function entrySummary(entries: string[]) {\n\tlet result = \"📋 You selected:\";\n\tfor (const e of entries) result += \"\\n   -\" + rel(e);\n\tif (entries?.length) logger.log(result);\n}\n"]}

package/dist/constants/cache-keys.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CACHE_KEYS = void 0;
+exports.CACHE_KEYS = {
+    ALIASES: "aliases",
+    JS_IMPORTS: "js:imports",
+    JS_STATS: "js:stats",
+    PHP_PSR4: "php:psr4",
+    PHP_BINDINGS: "php:bindings",
+    PHP_FILECACHE: "php:fileCache",
+};
+//# sourceMappingURL=cache-keys.js.map

package/dist/constants/cache-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-keys.js","sourceRoot":"","sources":["../../src/constants/cache-keys.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG;IACzB,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,eAAe;CACrB,CAAC","sourcesContent":["export const CACHE_KEYS = {\r\n\tALIASES: \"aliases\",\r\n\tJS_IMPORTS: \"js:imports\",\r\n\tJS_STATS: \"js:stats\",\r\n\tPHP_PSR4: \"php:psr4\",\r\n\tPHP_BINDINGS: \"php:bindings\",\r\n\tPHP_FILECACHE: \"php:fileCache\",\r\n} as const;\r\n\r\nexport type CacheNamespace = (typeof CACHE_KEYS)[keyof typeof CACHE_KEYS];\r\n"]}