prodex 1.2.0 → 1.3.0

package/dist/cli/picker.js

@@ -7,76 +7,76 @@ 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 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, file_utils_1.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 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, helpers_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, utils_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);
 }
-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;
 }

package/dist/cli/summary.js

@@ -1,14 +1,26 @@
 "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:
+const helpers_1 = require("../core/helpers");
+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({ flags, config }) {
+    logger_1.logger.log(`------- PRODEx RUN @ ${new Date().toLocaleTimeString()} — Codebase decoded -------`);
+    // 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, helpers_1.rel)(e);
+    logger_1.logger.log(result);
 }

package/dist/constants/config-loader.js

@@ -8,6 +8,7 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const default_config_1 = require("./default-config");
 const logger_1 = require("../lib/logger");
+const utils_1 = require("../lib/utils");
 /**
  * 🧩 Load and merge Prodex configuration (v3)
  *
@@ -28,7 +29,7 @@ async function loadProdexConfig(flags = {}, cwd) {
         logger_1.logger.info("No prodex.json found — using defaults.");
     }
     // 2️⃣ Merge defaults → user config
-    const { output, entry, resolve, debug } = default_config_1.DEFAULT_PRODEX_CONFIG;
+    const { output, entry, resolve } = default_config_1.DEFAULT_PRODEX_CONFIG;
     const cfg = {
         ...default_config_1.DEFAULT_PRODEX_CONFIG,
         ...userConfig,
@@ -39,11 +40,12 @@ async function loadProdexConfig(flags = {}, cwd) {
             ui: { ...entry.ui, ...userConfig.entry?.ui },
         },
         resolve: { ...resolve, ...userConfig.resolve },
-        debug: { ...debug, ...userConfig.debug },
         root: cwd,
+        name: flags?.name,
     };
     // 4️⃣ Apply CLI flag overrides (if any)
     applyFlagOverrides(cfg, flags);
+    tidyArrayFields(cfg);
     return cfg;
 }
 /** Merge CLI flags into config where relevant. */
@@ -52,8 +54,7 @@ function applyFlagOverrides(cfg, flags) {
     if (!flags)
         return;
     const outputOverrides = {
-        name: (cfg, v) => (cfg.output.prefix = v),
-        txt: (cfg) => (cfg.output.format = "txt"),
+        txt: (cfg, v) => (cfg.output.format = v ? "txt" : "md"),
     };
     const resolveOverrides = {
         limit: (cfg, v) => (cfg.resolve.limit = v),
@@ -84,7 +85,11 @@ function applyFlagOverrides(cfg, flags) {
     // Conditional override rule:
     // If files exist and include was null/undefined → clear include array
     const hasFiles = Array.isArray(flags.files) ? flags.files.length > 0 : !!flags.files;
-    if (hasFiles && flags.include == null) {
+    if (hasFiles && !flags.include) {
         cfg.resolve.include = [];
     }
 }
+function tidyArrayFields(cfg) {
+    cfg.entry.files = (0, utils_1.normalizePatterns)(cfg.entry.files);
+    ["include", "exclude"].forEach((k) => (cfg.resolve[k] = cfg.resolve[k]));
+}

package/dist/constants/config.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DTS_EXT = exports.BASE_EXTS = exports.GLOBAL_IGNORE = exports.RESOLVERS = exports.CODE_EXTS = exports.ROOT = void 0;
-exports.ROOT = process.cwd();
+exports.VALID_GLOB_CHARS = exports.SUFFIX = exports.DTS_EXT = exports.BASE_EXTS = exports.GLOBAL_IGNORE = exports.RESOLVERS = exports.CODE_EXTS = void 0;
 exports.CODE_EXTS = [".js", ".mjs", ".ts", ".tsx", ".d.ts", ".php"];
 const js_resolver_1 = require("../resolvers/js/js-resolver");
 const php_resolver_1 = require("../resolvers/php/php-resolver");
@@ -10,8 +9,18 @@ exports.RESOLVERS = {
     ".ts": js_resolver_1.resolveJsImports,
     ".tsx": js_resolver_1.resolveJsImports,
     ".d.ts": js_resolver_1.resolveJsImports,
-    ".js": js_resolver_1.resolveJsImports
+    ".js": js_resolver_1.resolveJsImports,
 };
 exports.GLOBAL_IGNORE = ["**/node_modules/**", "**/vendor/**", "**/dist/**"];
 exports.BASE_EXTS = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".types"];
 exports.DTS_EXT = ".d.ts";
+exports.SUFFIX = "trace";
+/**
+ * Normalize and sanitize pattern fields.
+ * - Always returns an array.
+ * - Accepts string or string[].
+ * - Splits comma-separated strings.
+ * - Trims and removes empty elements.
+ * - Filters out invalid or unusable characters for Fast-Glob.
+ */
+exports.VALID_GLOB_CHARS = /^[\w\-@./*?|!{}\[\]^$()+]+$/; // allows Fast-Glob-safe symbols

package/dist/constants/default-config.js

@@ -9,7 +9,7 @@ exports.DEFAULT_PRODEX_CONFIG = {
     version: 3.1,
     output: {
         dir: "prodex",
-        versioned: false,
+        versioned: true,
         prefix: "combined",
         format: "md",
     },
@@ -18,13 +18,7 @@ exports.DEFAULT_PRODEX_CONFIG = {
         ui: {
             roots: ["app", "routes", "resources/js/**"],
             scanDepth: 2,
-            priority: [
-                "**/routes/web.php",
-                "**/routes/api.php",
-                "**/*index.*",
-                "**/*main.*",
-                "**/app.*"
-            ],
+            priority: ["**/routes/web.php", "**/routes/api.php", "**/*index.*", "**/*main.*", "**/app.*"],
         },
     },
     resolve: {
@@ -33,16 +27,8 @@ exports.DEFAULT_PRODEX_CONFIG = {
             "@hooks": "resources/js/hooks",
             "@data": "resources/js/data",
         },
-        exclude: [
-            "node_modules/**",
-            "@shadcn/**",
-            "**/components/ui/**"
-        ],
+        exclude: ["node_modules/**", "@shadcn/**", "**/components/ui/**"],
         depth: 10,
         limit: 200,
     },
-    debug: {
-        verbose: false,
-        showSummary: true,
-    },
 };

package/dist/constants/render-constants.js

@@ -1,10 +1,14 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MD_FOOTER = exports.TEXT_HEADERS = exports.LANG_MAP = void 0;
 // ================================================================
 // 🧩 Prodex — Render Constants
 // Defines shared constants for renderer outDir formats.
 // ================================================================
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TEXT_HEADERS = exports.LANG_MAP = void 0;
+const package_json_1 = __importDefault(require("../../package.json"));
 exports.LANG_MAP = {
     "": "js",
     ".mjs": "js",
@@ -13,11 +17,12 @@ exports.LANG_MAP = {
     ".tsx": "tsx",
     ".php": "php",
     ".json": "json",
-    ".d.ts": "ts"
+    ".d.ts": "ts",
 };
 exports.TEXT_HEADERS = {
     toc: "##==== Combined Scope ====",
-    path: p => `##==== path: ${p} ====`,
-    regionStart: p => `##region ${p}`,
-    regionEnd: "##endregion"
+    path: (p) => `##==== path: ${p} ====`,
+    regionStart: (p) => `##region ${p}`,
+    regionEnd: "##endregion",
 };
+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");

package/dist/core/combine.js

@@ -1,74 +1,38 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runCombine = runCombine;
-const fs_1 = __importDefault(require("fs"));
-const inquirer_1 = __importDefault(require("inquirer"));
-const path_1 = __importDefault(require("path"));
 const picker_1 = require("../cli/picker");
 const summary_1 = require("../cli/summary");
 const dependency_1 = require("./dependency");
 const file_utils_1 = require("./file-utils");
-const renderers_1 = require("./renderers");
 const logger_1 = require("../lib/logger");
-const package_json_1 = __importDefault(require("../../package.json"));
-async function runCombine(cfg, showUi) {
-    const { output, entry, resolve } = cfg;
-    const toMd = cfg.output.format == "md";
-    const ROOT = cfg.root;
-    const { ui } = entry;
-    const entryFiles = entry.files ?? [];
-    let entries = [];
+const output_1 = require("./output");
+async function runCombine({ cfg, opts }) {
+    const { showUi, cliName } = opts;
+    let entries = (await resolveEntries(showUi, cfg)) ?? [];
+    if (!entries.length) {
+        logger_1.logger.error("No entries selected.");
+        return;
+    }
+    (0, summary_1.entrySummary)(entries);
+    const result = await (0, dependency_1.followChain)(entries, cfg);
+    const withinclude = await (0, dependency_1.applyincludes)(cfg, result.files);
+    const autoName = (0, file_utils_1.produceSmartName)(entries);
+    const outputPath = await (0, output_1.produceOutput)({ name: cliName ?? autoName, files: withinclude, cfg, showUi });
+    (0, summary_1.endSummary)(outputPath, result);
+}
+async function resolveEntries(showUi, cfg) {
+    const { root, entry } = cfg;
+    const { files } = entry;
     if (!showUi) {
         logger_1.logger.info("CI Mode");
-        if (!entryFiles.length) {
+        if (!files?.length) {
             logger_1.logger.warn("No entry files defined and UI mode is disabled.");
-            return;
+            process.exit(1);
         }
-        entries = (await (0, file_utils_1.globScan)(entryFiles, { cwd: ROOT })).files;
+        return (await (0, file_utils_1.globScan)(files, { cwd: root })).files;
     }
     else {
-        entries = await (0, picker_1.pickEntries)(ui.roots, ui.scanDepth, cfg);
-    }
-    if (!entries.length) {
-        logger_1.logger.error("No entries selected.");
-        return;
-    }
-    logger_1.logger.log("\n📋 You selected:");
-    for (const e of entries)
-        logger_1.logger.log(" -", e.replace(ROOT + "/", ""));
-    const autoName = (0, file_utils_1.generateOutputName)(entries);
-    const outDir = output.dir;
-    const limit = resolve.limit;
-    let outputBase = autoName;
-    if (showUi) {
-        const { outputBase: answer } = await inquirer_1.default.prompt([
-            {
-                type: "input",
-                name: "outputBase",
-                message: "Output file name (without extension):",
-                default: autoName,
-                filter: (v) => (v.trim() || autoName).replace(/[<>:"/\\|?*]+/g, "_"),
-            },
-        ]);
-        outputBase = answer;
+        return await (0, picker_1.pickEntries)(cfg);
     }
-    try {
-        fs_1.default.mkdirSync(outDir, { recursive: true });
-    }
-    catch {
-        logger_1.logger.warn("Could not create outDir directory:", outDir);
-    }
-    const outputPath = (0, file_utils_1.resolveOutDirPath)(outDir, outputBase, toMd);
-    (0, summary_1.showSummary)({ outDir, fileName: path_1.default.basename(outputPath), entries });
-    const result = await (0, dependency_1.followChain)(entries, cfg, limit);
-    const withinclude = await (0, dependency_1.applyincludes)(cfg, result.files);
-    const sorted = [...withinclude].sort((a, b) => a.localeCompare(b));
-    const footer = ["\n---", "*Generated with [Prodex](https://github.com/emxhive/prodex) — Codebase decoded.*", `<!-- PRODEx v${package_json_1.default.version} | ${new Date().toISOString()} -->`].join("\n");
-    const content = toMd ? [(0, renderers_1.tocTxt)(sorted), ...sorted.map(renderers_1.renderTxt)].join("") : [(0, renderers_1.tocMd)(sorted), ...sorted.map((f, i) => (0, renderers_1.renderMd)(f, i)), footer].join("\n");
-    fs_1.default.writeFileSync(outputPath, content, "utf8");
-    logger_1.logger.log(`\n✅ ${outputPath.norm()}`);
-    (0, summary_1.importSummary)(result);
 }

package/dist/core/dependency.js

@@ -9,7 +9,9 @@ const path_1 = __importDefault(require("path"));
 const config_1 = require("../constants/config");
 const file_utils_1 = require("./file-utils");
 const logger_1 = require("../lib/logger");
-async function followChain(entryFiles, cfg, limit = 200) {
+const utils_1 = require("../lib/utils");
+async function followChain(entryFiles, cfg) {
+    const limit = cfg.resolve.limit;
     logger_1.logger.debug("🧩 Following dependency chain...");
     const visited = new Set();
     const all = [];
@@ -37,15 +39,17 @@ async function followChain(entryFiles, cfg, limit = 200) {
         }
     }
     return {
-        files: [...new Set(all)],
+        files: (0, utils_1.unique)(all),
         stats: { expected, resolved },
     };
 }
 async function applyincludes(cfg, files) {
+    ;
     const { resolve } = cfg;
     const ROOT = cfg.root;
     const scan = await (0, file_utils_1.globScan)(resolve.include, { cwd: ROOT });
     logger_1.logger.debug("APPLY_include", _2j(scan));
-    const combined = [...new Set([...files, ...scan.files])];
+    const combined = (0, utils_1.unique)([...files, ...scan.files]);
+    ;
     return combined;
 }

package/dist/core/file-utils.js

@@ -4,32 +4,33 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.globScan = globScan;
-exports.generateOutputName = generateOutputName;
-exports.resolveOutDirPath = resolveOutDirPath;
+exports.produceSmartName = produceSmartName;
 const path_1 = __importDefault(require("path"));
 const fast_glob_1 = __importDefault(require("fast-glob"));
 const config_1 = require("../constants/config");
 const logger_1 = require("../lib/logger");
+const utils_1 = require("../lib/utils");
 /**
  * Safe micromatch.scan wrapper (compatible with micromatch v4 & v5)
  */
-async function globScan(pattern, opts) {
-    logger_1.logger.debug("PATTERN", pattern);
+async function globScan(patterns, opts) {
+    logger_1.logger.debug("PATTERNS", patterns);
     const { absolute = true, cwd = process.cwd() } = opts;
-    if (!pattern?.length)
+    if (!patterns?.length)
         return { files: [] };
-    const files = await (0, fast_glob_1.default)(pattern, {
+    const files = (await (0, fast_glob_1.default)(patterns, {
         cwd,
+        extglob: true,
         dot: true,
         onlyFiles: true,
         ignore: config_1.GLOBAL_IGNORE,
         absolute,
-    });
+    })).map((f) => path_1.default.resolve(f));
     logger_1.logger.debug("GLOB-SCAN_FILES ", _2j(files));
     return { files };
 }
-function generateOutputName(entries) {
-    const names = entries.map((f) => path_1.default.basename(f, path_1.default.extname(f)));
+function produceSmartName(entries) {
+    const names = (0, utils_1.unique)(entries.map((f) => path_1.default.basename(f, path_1.default.extname(f))));
     if (names.length === 1)
         return names[0];
     if (names.length === 2)
@@ -38,7 +39,3 @@ function generateOutputName(entries) {
         return `${names[0]}-and-${names.length - 1}more`;
     return "unknown";
 }
-function resolveOutDirPath(outDir, base, asTxt = false) {
-    const ext = asTxt ? "txt" : "md";
-    return path_1.default.join(outDir, `${base}-combined.${ext}`);
-}

package/dist/core/output.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.produceOutput = produceOutput;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const prompt_1 = require("../lib/prompt");
+const renderers_1 = require("./renderers");
+const logger_1 = require("../lib/logger");
+const utils_1 = require("../lib/utils");
+const questions_1 = require("../lib/questions");
+const render_constants_1 = require("../constants/render-constants");
+const config_1 = require("../constants/config");
+/**
+ * 🧩 produceOutput()
+ * Handles rendering and writing of the final trace file.
+ * Receives resolved files and configuration from combine.ts.
+ */
+async function produceOutput({ name, files, cfg, showUi }) {
+    const { output: { format, versioned, dir }, } = cfg;
+    ;
+    // 1️⃣ Determine base filename
+    let outputBase = name;
+    if (showUi) {
+        const result = await (0, prompt_1.prompt)(questions_1.OUTPUT_NAME_QUESTION);
+        if (result?.outputBase)
+            outputBase = result.outputBase;
+    }
+    // 2️⃣ Prefix timestamp if versioned
+    outputBase = `${outputBase}-${config_1.SUFFIX}`;
+    if (versioned)
+        outputBase = `${outputBase}_${(0, utils_1.shortTimestamp)()}`;
+    // 3️⃣ Ensure output directory
+    try {
+        fs_1.default.mkdirSync(dir, { recursive: true });
+    }
+    catch {
+        logger_1.logger.warn("Could not create dir directory:", dir);
+    }
+    // 4️⃣ Prepare and write content
+    const outputPath = path_1.default.join(dir, `${outputBase}.${format}`);
+    const sorted = [...files].sort((a, b) => a.localeCompare(b));
+    const content = format === "txt" ? [(0, renderers_1.tocTxt)(sorted), ...sorted.map(renderers_1.renderTxt)].join("") : [(0, renderers_1.tocMd)(sorted), ...sorted.map((f, i) => (0, renderers_1.renderMd)(f, i)), render_constants_1.MD_FOOTER].join("\n");
+    fs_1.default.writeFileSync(outputPath, content, "utf8");
+    return outputPath;
+}

package/dist/index.js

@@ -3,10 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = startProdex;
 const combine_1 = require("./core/combine");
 const init_1 = require("./cli/init");
-const logger_1 = require("./lib/logger");
 const cli_input_1 = require("./cli/cli-input");
 const config_loader_1 = require("./constants/config-loader");
 require("./lib/polyfills");
+const summary_1 = require("./cli/summary");
 async function startProdex() {
     const args = process.argv;
     // Handle init mode
@@ -14,16 +14,13 @@ async function startProdex() {
         return (0, init_1.initProdex)();
     }
     // Parse CLI input
-    const { root, flags, warnings, errors } = (0, cli_input_1.parseCliInput)(args);
-    if (warnings.length)
-        logger_1.logger.warn("Warnings:", warnings);
-    if (errors.length)
-        logger_1.logger.error("Errors:", errors);
+    const { root, flags } = (0, cli_input_1.parseCliInput)(args);
     // Load and merge configuration (with flag overrides)
     const config = await (0, config_loader_1.loadProdexConfig)(flags, root);
-    logger_1.logger.log(`------- PRODEx RUN @ ${new Date().toLocaleTimeString()} — Codebase decoded -------`);
-    // Log parse results for testing
-    logger_1.logger.debug("🧩 Parsed CLI input:", _2j({ flags }));
-    logger_1.logger.debug("Final merged config:", _2j(config));
-    await (0, combine_1.runCombine)(config, !flags.ci && !flags?.files?.length);
+    (0, summary_1.introSummary)({ flags, config });
+    const opts = {
+        showUi: !flags.ci && !flags?.files?.length && !config?.entry?.ui?.enablePicker,
+        cliName: config.name,
+    };
+    await (0, combine_1.runCombine)({ cfg: config, opts });
 }

package/dist/lib/logger.js

@@ -8,7 +8,7 @@ const env = () => {
 exports.logger = {
     debug: (...args) => !env().silent && env().debug && console.log("\n🪶 [debug]", ...args),
     info: (...args) => !env().silent && console.log("\n📌 [info]", ...args),
-    warn: (...args) => !env().silent && console.warn("\n⚠️ [warn]", ...args),
+    warn: (...args) => !env().silent && console.warn("\n⚠️  [warn]", ...args),
     error: (...args) => !env().silent && console.error("\n💥 [error]", ...args),
     log: (...args) => !env().silent && console.log("\n", ...args),
 };

package/dist/lib/polyfills.js

@@ -9,4 +9,19 @@ if (!String.prototype.norm) {
         return this.replace(/\\/g, "/");
     };
 }
+if (!String.prototype.clean) {
+    String.prototype.clean = function () {
+        return this.replace(/[<>:\"/\\|?*]+/g, "_");
+    };
+}
 globalThis._2j = (obj) => util_1.default.inspect(obj, { colors: true, depth: null, breakLength: 150, compact: 3 });
+globalThis._bpt = function (param) {
+    if (process.env.PRODEX_DEBUG !== "1")
+        return;
+    console.log("⭕ BREAKPOINT");
+    if (typeof param === "function")
+        param();
+    else
+        console.log(_2j(param));
+    process.exit(1);
+};

package/dist/lib/prompt.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prompt = prompt;
+const inquirer_1 = __importDefault(require("inquirer"));
+const logger_1 = require("./logger");
+/**
+ * 🧩 prompt()
+ * Unified and safe wrapper for inquirer.prompt()
+ *
+ * - Requires explicit `showUi` flag (no env auto-detection).
+ * - Returns `null` or `fallback` on failure or disabled UI.
+ * - Handles TTY errors and user cancellations gracefully.
+ */
+async function prompt(questions, fallback) {
+    try {
+        const answers = (await inquirer_1.default.prompt(questions));
+        return answers;
+    }
+    catch (err) {
+        if (err?.isTtyError) {
+            logger_1.logger.warn("Interactive prompts not supported (no TTY).");
+        }
+        else if (/canceled|aborted/i.test(err?.message)) {
+            logger_1.logger.warn("Prompt canceled by user.");
+        }
+        else {
+            logger_1.logger.error("Prompt failed:", err.message || err);
+        }
+        return fallback ?? null;
+    }
+}