@pristine-ts/cli 2.0.7 → 2.0.16

package/dist/lib/cjs/bootstrap/app-module-cache.js

@@ -0,0 +1,71 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppModuleCache = void 0;
+const tsyringe_1 = require("tsyringe");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+/**
+ * Persists the user's selection from the disambiguation prompt so subsequent invocations of
+ * `pristine` in the same project skip the prompt. Stale entries (target file deleted since
+ * the cache was written) are auto-cleaned on read.
+ *
+ * Best-effort throughout — failures to read or write the cache file are swallowed because
+ * the cache is a UX optimization, not correctness-critical.
+ */
+let AppModuleCache = class AppModuleCache {
+    constructor() {
+        this.cacheDirName = ".pristine";
+        this.cacheFileName = "last-app-module";
+    }
+    read(projectRoot) {
+        const cachePath = this.cachePath(projectRoot);
+        if (fs_1.default.existsSync(cachePath) === false) {
+            return undefined;
+        }
+        let cached;
+        try {
+            cached = fs_1.default.readFileSync(cachePath, "utf8").trim();
+        }
+        catch (_a) {
+            return undefined;
+        }
+        if (cached.length === 0 || fs_1.default.existsSync(cached) === false) {
+            // Stale cache — the user must have deleted or moved the file. Drop it so it doesn't
+            // keep being suggested on every subsequent invocation.
+            try {
+                fs_1.default.unlinkSync(cachePath);
+            }
+            catch (_b) {
+                // Best-effort cleanup.
+            }
+            return undefined;
+        }
+        return cached;
+    }
+    write(projectRoot, absolutePath) {
+        try {
+            fs_1.default.mkdirSync(path_1.default.resolve(projectRoot, this.cacheDirName), { recursive: true });
+            fs_1.default.writeFileSync(this.cachePath(projectRoot), absolutePath, "utf8");
+        }
+        catch (_a) {
+            // Best-effort.
+        }
+    }
+    cachePath(projectRoot) {
+        return path_1.default.resolve(projectRoot, this.cacheDirName, this.cacheFileName);
+    }
+};
+exports.AppModuleCache = AppModuleCache;
+exports.AppModuleCache = AppModuleCache = __decorate([
+    (0, tsyringe_1.injectable)()
+], AppModuleCache);
+//# sourceMappingURL=app-module-cache.js.map

package/dist/lib/cjs/bootstrap/app-module-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-module-cache.js","sourceRoot":"","sources":["../../../../src/bootstrap/app-module-cache.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,uCAAoC;AACpC,4CAAoB;AACpB,gDAAwB;AAExB;;;;;;;GAOG;AAEI,IAAM,cAAc,GAApB,MAAM,cAAc;IAApB;QACY,iBAAY,GAAW,WAAW,CAAC;QACnC,kBAAa,GAAW,iBAAiB,CAAC;IAyC7D,CAAC;IAvCC,IAAI,CAAC,WAAmB;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC9C,IAAI,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,KAAK,EAAE,CAAC;YACvC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,YAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACrD,CAAC;QAAC,WAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,YAAE,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC;YAC3D,oFAAoF;YACpF,uDAAuD;YACvD,IAAI,CAAC;gBACH,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YAC3B,CAAC;YAAC,WAAM,CAAC;gBACP,uBAAuB;YACzB,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,WAAmB,EAAE,YAAoB;QAC7C,IAAI,CAAC;YACH,YAAE,CAAC,SAAS,CAAC,cAAI,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC;YAC9E,YAAE,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QACtE,CAAC;QAAC,WAAM,CAAC;YACP,eAAe;QACjB,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,WAAmB;QACnC,OAAO,cAAI,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1E,CAAC;CACF,CAAA;AA3CY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,qBAAU,GAAE;GACA,cAAc,CA2C1B"}

package/dist/lib/cjs/bootstrap/app-module-discoverer.js

@@ -0,0 +1,119 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppModuleDiscoverer = void 0;
+const tsyringe_1 = require("tsyringe");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const app_module_discovery_candidate_1 = require("./app-module-discovery-candidate");
+const app_module_discovery_reason_enum_1 = require("./app-module-discovery-reason.enum");
+/**
+ * Scans well-known directories for files that look like AppModule definitions. Non-recursive
+ * (each search root is scanned at depth 1 only) so it stays fast on large repos and predictable
+ * when users have many nested module files.
+ *
+ * A file is a candidate when:
+ *   - its filename matches `*.module.{js,mjs,cjs}` (and is not a test/spec file), AND
+ *   - either the filename literally matches `app.module.{js,mjs,cjs}` (highest confidence,
+ *     scored 0), OR the file's exports include a symbol named `AppModule` (scored 10).
+ */
+let AppModuleDiscoverer = class AppModuleDiscoverer {
+    constructor() {
+        /**
+         * Search roots scanned for candidates, relative to the project root. Order is intentional:
+         * compiled output first (most likely runtime entry), then build/, then the project root
+         * itself for trivial single-file demos.
+         */
+        this.searchRoots = [
+            "dist",
+            "dist/lib/cjs",
+            "dist/lib/esm",
+            "build",
+            ".",
+        ];
+        this.moduleFileRegex = /^[A-Za-z0-9._-]+\.module\.(js|mjs|cjs)$/;
+        this.appModuleNameRegex = /^app\.module\.(js|mjs|cjs)$/i;
+    }
+    discover(projectRoot) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const seen = new Set();
+            const candidates = [];
+            for (const root of this.searchRoots) {
+                const dir = path_1.default.resolve(projectRoot, root);
+                if (fs_1.default.existsSync(dir) === false || fs_1.default.statSync(dir).isDirectory() === false) {
+                    continue;
+                }
+                const entries = fs_1.default.readdirSync(dir, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (entry.isFile() === false)
+                        continue;
+                    if (this.moduleFileRegex.test(entry.name) === false)
+                        continue;
+                    if (entry.name.includes(".spec.") || entry.name.includes(".test."))
+                        continue;
+                    const absolutePath = path_1.default.resolve(dir, entry.name);
+                    // Same physical file (e.g. dist/app.module.js and dist/lib/cjs/app.module.js pointing
+                    // at duplicated builds) — keep the first occurrence (which respects searchRoots order).
+                    if (seen.has(absolutePath))
+                        continue;
+                    seen.add(absolutePath);
+                    const displayPath = path_1.default.relative(projectRoot, absolutePath);
+                    if (this.appModuleNameRegex.test(entry.name)) {
+                        candidates.push(new app_module_discovery_candidate_1.AppModuleDiscoveryCandidate(absolutePath, displayPath, 0, app_module_discovery_reason_enum_1.AppModuleDiscoveryReasonEnum.Named));
+                        continue;
+                    }
+                    if (this.exportsAppModule(absolutePath)) {
+                        candidates.push(new app_module_discovery_candidate_1.AppModuleDiscoveryCandidate(absolutePath, displayPath, 10, app_module_discovery_reason_enum_1.AppModuleDiscoveryReasonEnum.Exports));
+                    }
+                }
+            }
+            candidates.sort((a, b) => {
+                if (a.score !== b.score)
+                    return a.score - b.score;
+                return a.displayPath.localeCompare(b.displayPath);
+            });
+            return candidates;
+        });
+    }
+    /**
+     * Synchronous probe: does this file's exports include an `AppModule` symbol? Uses
+     * `require()` rather than dynamic `import()` because (a) we only accept `.js/.mjs/.cjs`
+     * whose CJS variants load synchronously, and (b) discarded probes shouldn't hold open
+     * `import()` promises.
+     * @private
+     */
+    exportsAppModule(absolutePath) {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const loaded = require(absolutePath);
+            return loaded !== null && typeof loaded === "object" && "AppModule" in loaded;
+        }
+        catch (_a) {
+            // Treat unreadable / unloadable files as non-candidates — the loader couldn't open them
+            // either, so they cannot be the AppModule.
+            return false;
+        }
+    }
+};
+exports.AppModuleDiscoverer = AppModuleDiscoverer;
+exports.AppModuleDiscoverer = AppModuleDiscoverer = __decorate([
+    (0, tsyringe_1.injectable)()
+], AppModuleDiscoverer);
+//# sourceMappingURL=app-module-discoverer.js.map

package/dist/lib/cjs/bootstrap/app-module-discoverer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-module-discoverer.js","sourceRoot":"","sources":["../../../../src/bootstrap/app-module-discoverer.ts"],"names":[],"mappings":"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"}

package/dist/lib/cjs/bootstrap/app-module-discovery-candidate.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppModuleDiscoveryCandidate = void 0;
+/**
+ * A plausible AppModule found by the convention-based scan. Lower `score` beats higher;
+ * ties are ambiguous and trigger the disambiguation prompt.
+ */
+class AppModuleDiscoveryCandidate {
+    constructor(absolutePath, 
+    /** Path relative to the project root. Used purely for human-facing display. */
+    displayPath, 
+    /** Lower = better. Files literally named `app.module.*` get 0; AppModule-exporting `*.module.*` files get 10. */
+    score, reason) {
+        this.absolutePath = absolutePath;
+        this.displayPath = displayPath;
+        this.score = score;
+        this.reason = reason;
+    }
+}
+exports.AppModuleDiscoveryCandidate = AppModuleDiscoveryCandidate;
+//# sourceMappingURL=app-module-discovery-candidate.js.map

package/dist/lib/cjs/bootstrap/app-module-discovery-candidate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-module-discovery-candidate.js","sourceRoot":"","sources":["../../../../src/bootstrap/app-module-discovery-candidate.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAa,2BAA2B;IACtC,YACkB,YAAoB;IACpC,+EAA+E;IAC/D,WAAmB;IACnC,iHAAiH;IACjG,KAAa,EACb,MAAoC;QALpC,iBAAY,GAAZ,YAAY,CAAQ;QAEpB,gBAAW,GAAX,WAAW,CAAQ;QAEnB,UAAK,GAAL,KAAK,CAAQ;QACb,WAAM,GAAN,MAAM,CAA8B;IAEtD,CAAC;CACF;AAVD,kEAUC"}

package/dist/lib/cjs/bootstrap/app-module-discovery-reason.enum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppModuleDiscoveryReasonEnum = void 0;
+/**
+ * Why a candidate file was considered a possible AppModule. Used by the disambiguation prompt
+ * so the user sees "(matches app.module.*)" vs "(exports AppModule)" alongside each option.
+ */
+var AppModuleDiscoveryReasonEnum;
+(function (AppModuleDiscoveryReasonEnum) {
+    /** The filename matches `app.module.{js,mjs,cjs}`. Highest confidence. */
+    AppModuleDiscoveryReasonEnum["Named"] = "named";
+    /** The filename is `*.module.{js,mjs,cjs}` and the file's exports include an `AppModule` symbol. */
+    AppModuleDiscoveryReasonEnum["Exports"] = "exports";
+})(AppModuleDiscoveryReasonEnum || (exports.AppModuleDiscoveryReasonEnum = AppModuleDiscoveryReasonEnum = {}));
+//# sourceMappingURL=app-module-discovery-reason.enum.js.map

package/dist/lib/cjs/bootstrap/app-module-discovery-reason.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-module-discovery-reason.enum.js","sourceRoot":"","sources":["../../../../src/bootstrap/app-module-discovery-reason.enum.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,4BAKX;AALD,WAAY,4BAA4B;IACtC,0EAA0E;IAC1E,+CAAe,CAAA;IACf,oGAAoG;IACpG,mDAAmB,CAAA;AACrB,CAAC,EALW,4BAA4B,4CAA5B,4BAA4B,QAKvC"}

package/dist/lib/cjs/bootstrap/app-module-prompt.js

@@ -0,0 +1,78 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppModulePrompt = void 0;
+const tsyringe_1 = require("tsyringe");
+const app_module_discovery_reason_enum_1 = require("./app-module-discovery-reason.enum");
+const dynamic_importer_1 = require("./dynamic-importer");
+/**
+ * TTY disambiguation for the AppModule discovery cascade. When multiple equally-ranked
+ * candidates exist and stdin/stdout are both connected to a real terminal, ask the user
+ * to pick one. When non-interactive (CI, Docker, redirected stdin), the caller should
+ * fall back to throwing an actionable error rather than guessing.
+ *
+ * `@inquirer/prompts` is dynamic-imported through `DynamicImporter` so the prompt UI
+ * dependency only loads when actually prompting — keeps non-interactive startup fast and
+ * avoids paying for inquirer's TTY-detection overhead on every invocation.
+ */
+let AppModulePrompt = class AppModulePrompt {
+    constructor(dynamicImporter) {
+        this.dynamicImporter = dynamicImporter;
+        this.cancelLabel = "Cancel";
+    }
+    isInteractive() {
+        return Boolean(process.stdout.isTTY) && Boolean(process.stdin.isTTY);
+    }
+    prompt(candidates) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const inquirer = yield this.dynamicImporter.import("@inquirer/prompts");
+            const select = inquirer.select;
+            try {
+                const choice = yield select({
+                    message: "Multiple AppModule candidates were found. Which one should pristine load?",
+                    choices: [
+                        ...candidates.map(c => ({
+                            name: `${c.displayPath}  ${this.reasonLabel(c.reason)}`,
+                            value: c.absolutePath,
+                        })),
+                        { name: this.cancelLabel, value: null },
+                    ],
+                });
+                return choice !== null && choice !== void 0 ? choice : undefined;
+            }
+            catch (_a) {
+                // @inquirer throws on Ctrl+C / SIGINT — treat as a clean abort, not a crash.
+                return undefined;
+            }
+        });
+    }
+    reasonLabel(reason) {
+        switch (reason) {
+            case app_module_discovery_reason_enum_1.AppModuleDiscoveryReasonEnum.Named: return "(matches app.module.*)";
+            case app_module_discovery_reason_enum_1.AppModuleDiscoveryReasonEnum.Exports: return "(exports AppModule)";
+        }
+    }
+};
+exports.AppModulePrompt = AppModulePrompt;
+exports.AppModulePrompt = AppModulePrompt = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __metadata("design:paramtypes", [dynamic_importer_1.DynamicImporter])
+], AppModulePrompt);
+//# sourceMappingURL=app-module-prompt.js.map

package/dist/lib/cjs/bootstrap/app-module-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-module-prompt.js","sourceRoot":"","sources":["../../../../src/bootstrap/app-module-prompt.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,uCAAoC;AAEpC,yFAAgF;AAChF,yDAAmD;AAEnD;;;;;;;;;GASG;AAEI,IAAM,eAAe,GAArB,MAAM,eAAe;IAG1B,YAA6B,eAAgC;QAAhC,oBAAe,GAAf,eAAe,CAAiB;QAF5C,gBAAW,GAAW,QAAQ,CAAC;IAGhD,CAAC;IAED,aAAa;QACX,OAAO,OAAO,CAAE,OAAO,CAAC,MAAc,CAAC,KAAK,CAAC,IAAI,OAAO,CAAE,OAAO,CAAC,KAAa,CAAC,KAAK,CAAC,CAAC;IACzF,CAAC;IAEK,MAAM,CAAC,UAAyC;;YACpD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;YACxE,MAAM,MAAM,GAA4C,QAAQ,CAAC,MAAM,CAAC;YAExE,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC;oBAC1B,OAAO,EAAE,2EAA2E;oBACpF,OAAO,EAAE;wBACP,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;4BACtB,IAAI,EAAE,GAAG,CAAC,CAAC,WAAW,KAAK,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;4BACvD,KAAK,EAAE,CAAC,CAAC,YAAY;yBACtB,CAAC,CAAC;wBACH,EAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,EAAC;qBACtC;iBACF,CAAC,CAAC;gBACH,OAAO,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,SAAS,CAAC;YAC7B,CAAC;YAAC,WAAM,CAAC;gBACP,6EAA6E;gBAC7E,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;KAAA;IAEO,WAAW,CAAC,MAAoC;QACtD,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,+DAA4B,CAAC,KAAK,CAAC,CAAC,OAAO,wBAAwB,CAAC;YACzE,KAAK,+DAA4B,CAAC,OAAO,CAAC,CAAC,OAAO,qBAAqB,CAAC;QAC1E,CAAC;IACH,CAAC;CACF,CAAA;AAtCY,0CAAe;0BAAf,eAAe;IAD3B,IAAA,qBAAU,GAAE;qCAImC,kCAAe;GAHlD,eAAe,CAsC3B"}

package/dist/lib/cjs/bootstrap/build-staleness-prompt.js

@@ -21,7 +21,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BuildStalenessPrompt = void 0;
 const tsyringe_1 = require("tsyringe");
 const build_manifest_staleness_enum_1 = require("./build-manifest-staleness.enum");
-const dynamic_importer_1 = require("./dynamic-importer");
+const cli_prompt_manager_1 = require("../managers/cli-prompt.manager");
+const prompt_cancelled_error_1 = require("../errors/prompt-cancelled.error");
 /**
  * When the build manifest is stale (source edited, output missing, etc.), `AppModuleLoader`
  * stops the load and consults this prompt. In a TTY, asks the user whether to run
@@ -32,8 +33,8 @@ const dynamic_importer_1 = require("./dynamic-importer");
  * this class stays small and testable.
  */
 let BuildStalenessPrompt = class BuildStalenessPrompt {
-    constructor(dynamicImporter) {
-        this.dynamicImporter = dynamicImporter;
+    constructor(cliPrompt) {
+        this.cliPrompt = cliPrompt;
         this.promptMessage = "Run `pristine build` now to refresh?";
     }
     isInteractive() {
@@ -67,17 +68,15 @@ let BuildStalenessPrompt = class BuildStalenessPrompt {
      */
     prompt(reason) {
         return __awaiter(this, void 0, void 0, function* () {
-            const inquirer = yield this.dynamicImporter.import("@inquirer/prompts");
-            const confirm = inquirer.confirm;
             try {
-                return yield confirm({
-                    message: `${this.describe(reason)}\n  ${this.promptMessage}`,
-                    default: true,
-                });
+                return yield this.cliPrompt.confirm(`${this.describe(reason)}\n  ${this.promptMessage}`, true);
             }
-            catch (_a) {
-                // @inquirer throws on Ctrl+C. Treat as a clean cancellation.
-                return undefined;
+            catch (error) {
+                if (error instanceof prompt_cancelled_error_1.PromptCancelledError) {
+                    // Ctrl+C — treat as a clean cancellation so the caller can exit with the explanation.
+                    return undefined;
+                }
+                throw error;
             }
         });
     }
@@ -85,6 +84,6 @@ let BuildStalenessPrompt = class BuildStalenessPrompt {
 exports.BuildStalenessPrompt = BuildStalenessPrompt;
 exports.BuildStalenessPrompt = BuildStalenessPrompt = __decorate([
     (0, tsyringe_1.injectable)(),
-    __metadata("design:paramtypes", [dynamic_importer_1.DynamicImporter])
+    __metadata("design:paramtypes", [cli_prompt_manager_1.CliPrompt])
 ], BuildStalenessPrompt);
 //# sourceMappingURL=build-staleness-prompt.js.map

package/dist/lib/cjs/bootstrap/build-staleness-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"build-staleness-prompt.js","sourceRoot":"","sources":["../../../../src/bootstrap/build-staleness-prompt.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,uCAAoC;AACpC,mFAA2E;AAC3E,yDAAmD;AAEnD;;;;;;;;GAQG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAG/B,YAA6B,eAAgC;QAAhC,oBAAe,GAAf,eAAe,CAAiB;QAF5C,kBAAa,GAAW,sCAAsC,CAAC;IAGhF,CAAC;IAED,aAAa;QACX,OAAO,OAAO,CAAE,OAAO,CAAC,MAAc,CAAC,KAAK,CAAC,IAAI,OAAO,CAAE,OAAO,CAAC,KAAa,CAAC,KAAK,CAAC,CAAC;IACzF,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,MAAkC;QACzC,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,0DAA0B,CAAC,OAAO;gBACrC,OAAO,6EAA6E,CAAC;YACvF,KAAK,0DAA0B,CAAC,iBAAiB;gBAC/C,OAAO,gIAAgI,CAAC;YAC1I,KAAK,0DAA0B,CAAC,iBAAiB;gBAC/C,OAAO,qIAAqI,CAAC;YAC/I,KAAK,0DAA0B,CAAC,oBAAoB;gBAClD,OAAO,4FAA4F,CAAC;YACtG,KAAK,0DAA0B,CAAC,aAAa;gBAC3C,OAAO,uFAAuF,CAAC;YACjG,KAAK,0DAA0B,CAAC,KAAK;gBACnC,oFAAoF;gBACpF,iBAAiB;gBACjB,OAAO,+BAA+B,CAAC;QAC3C,CAAC;IACH,CAAC;IAED;;;OAGG;IACG,MAAM,CAAC,MAAkC;;YAC7C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;YACxE,MAAM,OAAO,GAAsC,QAAQ,CAAC,OAAO,CAAC;YAEpE,IAAI,CAAC;gBACH,OAAO,MAAM,OAAO,CAAC;oBACnB,OAAO,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,aAAa,EAAE;oBAC5D,OAAO,EAAE,IAAI;iBACd,CAAC,CAAC;YACL,CAAC;YAAC,WAAM,CAAC;gBACP,6DAA6D;gBAC7D,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;KAAA;CACF,CAAA;AAnDY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,qBAAU,GAAE;qCAImC,kCAAe;GAHlD,oBAAoB,CAmDhC"}
+{"version":3,"file":"build-staleness-prompt.js","sourceRoot":"","sources":["../../../../src/bootstrap/build-staleness-prompt.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,uCAAoC;AACpC,mFAA2E;AAC3E,uEAAyD;AACzD,6EAAsE;AAEtE;;;;;;;;GAQG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAG/B,YAA6B,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;QAFhC,kBAAa,GAAW,sCAAsC,CAAC;IAGhF,CAAC;IAED,aAAa;QACX,OAAO,OAAO,CAAE,OAAO,CAAC,MAAc,CAAC,KAAK,CAAC,IAAI,OAAO,CAAE,OAAO,CAAC,KAAa,CAAC,KAAK,CAAC,CAAC;IACzF,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,MAAkC;QACzC,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,0DAA0B,CAAC,OAAO;gBACrC,OAAO,6EAA6E,CAAC;YACvF,KAAK,0DAA0B,CAAC,iBAAiB;gBAC/C,OAAO,gIAAgI,CAAC;YAC1I,KAAK,0DAA0B,CAAC,iBAAiB;gBAC/C,OAAO,qIAAqI,CAAC;YAC/I,KAAK,0DAA0B,CAAC,oBAAoB;gBAClD,OAAO,4FAA4F,CAAC;YACtG,KAAK,0DAA0B,CAAC,aAAa;gBAC3C,OAAO,uFAAuF,CAAC;YACjG,KAAK,0DAA0B,CAAC,KAAK;gBACnC,oFAAoF;gBACpF,iBAAiB;gBACjB,OAAO,+BAA+B,CAAC;QAC3C,CAAC;IACH,CAAC;IAED;;;OAGG;IACG,MAAM,CAAC,MAAkC;;YAC7C,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,CAAC;YACjG,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,6CAAoB,EAAE,CAAC;oBAC1C,sFAAsF;oBACtF,OAAO,SAAS,CAAC;gBACnB,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KAAA;CACF,CAAA;AAhDY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,qBAAU,GAAE;qCAI6B,8BAAS;GAHtC,oBAAoB,CAgDhC"}

package/dist/lib/cjs/bootstrap/init-prompt.js

@@ -20,10 +20,10 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InitPrompt = void 0;
 const tsyringe_1 = require("tsyringe");
-const dynamic_importer_1 = require("./dynamic-importer");
+const cli_prompt_manager_1 = require("../managers/cli-prompt.manager");
 /**
- * Interactive Q&A for `pristine init`. Lazy-loads `@inquirer/prompts` so the dep cost is
- * only paid when actually prompting (the same pattern as `BuildStalenessPrompt` uses).
+ * Interactive Q&A for `pristine init`. Prompts through {@link CliPrompt}, the CLI's native
+ * (no third-party dependency) terminal-prompt manager.
  *
  * Each method takes a "current value" so callers can pre-fill answers from CLI flags and
  * only prompt for the gaps. Returning the same value the user passed in is intentional —
@@ -31,8 +31,8 @@ const dynamic_importer_1 = require("./dynamic-importer");
  * prompt.
  */
 let InitPrompt = class InitPrompt {
-    constructor(dynamicImporter) {
-        this.dynamicImporter = dynamicImporter;
+    constructor(cliPrompt) {
+        this.cliPrompt = cliPrompt;
         this.defaultSourcePath = "src/app.module.ts";
         this.defaultOutputPath = "dist/app.module.js";
         this.defaultTsconfig = "tsconfig.json";
@@ -45,83 +45,52 @@ let InitPrompt = class InitPrompt {
         return __awaiter(this, void 0, void 0, function* () {
             if (current !== undefined)
                 return current;
-            const inquirer = yield this.dynamicImporter.import("@inquirer/prompts");
-            const input = inquirer.input;
-            return input({
-                message: "Where does your AppModule source file live?",
-                default: this.defaultSourcePath,
-            });
+            return this.cliPrompt.input("Where does your AppModule source file live?", this.defaultSourcePath);
         });
     }
     askOutputPath(current) {
         return __awaiter(this, void 0, void 0, function* () {
             if (current !== undefined)
                 return current;
-            const inquirer = yield this.dynamicImporter.import("@inquirer/prompts");
-            const input = inquirer.input;
-            return input({
-                message: "Where should the compiled AppModule output land?",
-                default: this.defaultOutputPath,
-            });
+            return this.cliPrompt.input("Where should the compiled AppModule output land?", this.defaultOutputPath);
         });
     }
     askTsconfig(current) {
         return __awaiter(this, void 0, void 0, function* () {
             if (current !== undefined)
                 return current;
-            const inquirer = yield this.dynamicImporter.import("@inquirer/prompts");
-            const input = inquirer.input;
-            return input({
-                message: "Which tsconfig should `pristine build` use?",
-                default: this.defaultTsconfig,
-            });
+            return this.cliPrompt.input("Which tsconfig should `pristine build` use?", this.defaultTsconfig);
         });
     }
     askFormat(current) {
         return __awaiter(this, void 0, void 0, function* () {
             if (current !== undefined)
                 return current;
-            const inquirer = yield this.dynamicImporter.import("@inquirer/prompts");
-            const select = inquirer.select;
-            return select({
-                message: "Which build format do you want?",
-                choices: [
-                    { name: "esm  (modern, recommended)", value: "esm" },
-                    { name: "cjs  (CommonJS)", value: "cjs" },
-                    { name: "both (publish ESM + CJS)", value: "both" },
-                ],
-                default: this.defaultFormat,
-            });
+            return this.cliPrompt.select("Which build format do you want?", [
+                { name: "esm  (modern, recommended)", value: "esm" },
+                { name: "cjs  (CommonJS)", value: "cjs" },
+                { name: "both (publish ESM + CJS)", value: "both" },
+            ], this.defaultFormat);
         });
     }
     askScaffoldSource(current, sourcePath) {
         return __awaiter(this, void 0, void 0, function* () {
             if (current !== undefined)
                 return current;
-            const inquirer = yield this.dynamicImporter.import("@inquirer/prompts");
-            const confirm = inquirer.confirm;
-            return confirm({
-                message: `Scaffold a starter AppModule at ${sourcePath}?`,
-                default: true,
-            });
+            return this.cliPrompt.confirm(`Scaffold a starter AppModule at ${sourcePath}?`, true);
         });
     }
     askWritePackageScripts(current) {
         return __awaiter(this, void 0, void 0, function* () {
             if (current !== undefined)
                 return current;
-            const inquirer = yield this.dynamicImporter.import("@inquirer/prompts");
-            const confirm = inquirer.confirm;
-            return confirm({
-                message: "Add `build`, `start`, `verify` scripts to package.json (only ones that don't already exist)?",
-                default: true,
-            });
+            return this.cliPrompt.confirm("Add `build`, `start`, `verify` scripts to package.json (only ones that don't already exist)?", true);
         });
     }
 };
 exports.InitPrompt = InitPrompt;
 exports.InitPrompt = InitPrompt = __decorate([
     (0, tsyringe_1.injectable)(),
-    __metadata("design:paramtypes", [dynamic_importer_1.DynamicImporter])
+    __metadata("design:paramtypes", [cli_prompt_manager_1.CliPrompt])
 ], InitPrompt);
 //# sourceMappingURL=init-prompt.js.map

package/dist/lib/cjs/bootstrap/init-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"init-prompt.js","sourceRoot":"","sources":["../../../../src/bootstrap/init-prompt.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init-prompt.js","sourceRoot":"","sources":["../../../../src/bootstrap/init-prompt.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,uCAAoC;AACpC,uEAAyD;AAgBzD;;;;;;;;GAQG;AAEI,IAAM,UAAU,GAAhB,MAAM,UAAU;IAMrB,YAA6B,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;QALhC,sBAAiB,GAAW,mBAAmB,CAAC;QAChD,sBAAiB,GAAW,oBAAoB,CAAC;QACjD,oBAAe,GAAW,eAAe,CAAC;QAC1C,kBAAa,GAA2B,KAAK,CAAC;IAG/D,CAAC;IAED,aAAa;QACX,OAAO,OAAO,CAAE,OAAO,CAAC,MAAc,CAAC,KAAK,CAAC,IAAI,OAAO,CAAE,OAAO,CAAC,KAAa,CAAC,KAAK,CAAC,CAAC;IACzF,CAAC;IAEK,aAAa,CAAC,OAA2B;;YAC7C,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC;YAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,6CAA6C,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACrG,CAAC;KAAA;IAEK,aAAa,CAAC,OAA2B;;YAC7C,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC;YAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,kDAAkD,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC1G,CAAC;KAAA;IAEK,WAAW,CAAC,OAA2B;;YAC3C,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC;YAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,6CAA6C,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QACnG,CAAC;KAAA;IAEK,SAAS,CAAC,OAA2C;;YACzD,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC;YAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAC1B,iCAAiC,EACjC;gBACE,EAAC,IAAI,EAAE,4BAA4B,EAAE,KAAK,EAAE,KAAK,EAAC;gBAClD,EAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,KAAK,EAAC;gBACvC,EAAC,IAAI,EAAE,0BAA0B,EAAE,KAAK,EAAE,MAAM,EAAC;aAClD,EACD,IAAI,CAAC,aAAa,CACnB,CAAC;QACJ,CAAC;KAAA;IAEK,iBAAiB,CAAC,OAA4B,EAAE,UAAkB;;YACtE,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC;YAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,mCAAmC,UAAU,GAAG,EAAE,IAAI,CAAC,CAAC;QACxF,CAAC;KAAA;IAEK,sBAAsB,CAAC,OAA4B;;YACvD,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC;YAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAC3B,8FAA8F,EAC9F,IAAI,CACL,CAAC;QACJ,CAAC;KAAA;CACF,CAAA;AArDY,gCAAU;qBAAV,UAAU;IADtB,IAAA,qBAAU,GAAE;qCAO6B,8BAAS;GANtC,UAAU,CAqDtB"}

package/dist/lib/cjs/cli.configuration-keys.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliConfigurationKeys = void 0;
+/**
+ * Typed configuration keys for `@pristine-ts/cli`. Use these constants with `@injectConfig`
+ * for autocomplete + rename safety, instead of typing the parameter name as a string.
+ *
+ * ```ts
+ * import {injectConfig} from "@pristine-ts/common";
+ * import {CliConfigurationKeys} from "@pristine-ts/cli";
+ *
+ * constructor(@injectConfig(CliConfigurationKeys.InteractiveParameters) enabled: boolean) {}
+ * ```
+ */
+exports.CliConfigurationKeys = {
+    /**
+     * Whether the CLI may interactively ask for missing command parameters that declare a
+     * `question` (via `@commandParameter`). Defaults to `true`; set it to `false` to disable
+     * all such prompting (e.g. in CI). Prompting is also skipped automatically whenever the
+     * input is not an interactive terminal, regardless of this value.
+     */
+    InteractiveParameters: "pristine.cli.interactiveParameters",
+};
+//# sourceMappingURL=cli.configuration-keys.js.map

package/dist/lib/cjs/cli.configuration-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.configuration-keys.js","sourceRoot":"","sources":["../../../src/cli.configuration-keys.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACU,QAAA,oBAAoB,GAAG;IAClC;;;;;OAKG;IACH,qBAAqB,EAAE,oCAAoC;CACnD,CAAC"}

package/dist/lib/cjs/cli.js

@@ -24,6 +24,8 @@ const source_hasher_1 = require("./bootstrap/source-hasher");
 const config_loader_1 = require("./config/config-loader");
 const cli_module_1 = require("./cli.module");
 const cli_error_reporter_1 = require("./reporters/cli-error.reporter");
+const cli_prompt_manager_1 = require("./managers/cli-prompt.manager");
+const terminal_key_reader_manager_1 = require("./managers/terminal-key-reader.manager");
 /**
  * Boots the CLI: discovers the consumer's AppModule, starts the kernel, and dispatches
  * `process.argv` to whichever command matches. Returns the process exit code rather than
@@ -64,11 +66,17 @@ class Cli {
                 // and the alias commands can register signal handlers and resolve their delegates.
                 this.kernel.container.registerInstance(core_1.Kernel, this.kernel);
                 this.warnOnCommandCollisions();
-                yield this.kernel.handle(process.argv, { keyname: core_1.ExecutionContextKeynameEnum.Cli, context: null });
-                // The CLI event handler calls `process.exit(exitCode)` itself after the command runs,
-                // so this return is only reached if the dispatcher somehow resolves without exiting —
-                // treat that as a success exit.
-                return 0;
+                // Uniform dispatch: every argv shape flows through `kernel.handle(argv, {keyname:
+                // Cli})`. The mapping layer picks the right payload:
+                //   - `[node, pristine, <command>, ...]` → `CommandEventMapper` → `CliEventHandler`
+                //     runs the command and returns its exit code (no `process.exit`; exiting is
+                //     `bin.ts`'s job).
+                //   - `[node, pristine]` or `[node, pristine, repl, ...]` → `ReplStartEventMapper`
+                //     → `ReplStartEventHandler` runs the interactive session and resolves with the
+                //     exit code on `/exit` or EOF.
+                // No if-REPL branch needed here — the REPL is just another event handler.
+                const exitCode = yield this.kernel.handle(process.argv, { keyname: core_1.ExecutionContextKeynameEnum.Cli, context: null });
+                return typeof exitCode === "number" ? exitCode : 0;
             }
             catch (error) {
                 return yield this.reportFatalError(error);
@@ -136,11 +144,15 @@ class Cli {
         });
     }
     /**
-     * Builds a synthetic outer AppModule that imports both the user's AppModule and CliModule.
+     * Builds a synthetic outer AppModule that imports the user's AppModule plus `CliModule`
+     * — so the CLI's own commands are always registered when the bin is the entry point.
+     * `CliModule` itself imports `ObservabilityModule`, so the logs/traces store travels
+     * along without being named here.
+     *
      * The wrap is unconditional — the kernel dedupes module imports by keyname, so adding
-     * CliModule on top of a graph that already contains it is a no-op rather than an error
-     * or duplicate registration. Cheaper than walking the user's import tree to detect the
-     * already-present case.
+     * `CliModule` on top of a graph that already contains it is a no-op rather than an
+     * error or duplicate registration. Cheaper than walking the user's import tree to
+     * detect the already-present case.
      */
     wrapWithCliModule(appModule) {
         var _a;
@@ -163,7 +175,8 @@ class Cli {
         const sourceHasher = new source_hasher_1.SourceHasher();
         const buildManifestReader = new build_manifest_reader_1.BuildManifestReader();
         const buildManifestChecker = new build_manifest_checker_1.BuildManifestChecker(sourceHasher);
-        const buildStalenessPrompt = new build_staleness_prompt_1.BuildStalenessPrompt(dynamicImporter);
+        const cliPrompt = new cli_prompt_manager_1.CliPrompt(new terminal_key_reader_manager_1.TerminalKeyReader());
+        const buildStalenessPrompt = new build_staleness_prompt_1.BuildStalenessPrompt(cliPrompt);
         const buildRunner = new build_runner_1.BuildRunner();
         return new app_module_loader_1.AppModuleLoader(configLoader, pluginLoader, dynamicImporter, buildManifestReader, buildManifestChecker, buildStalenessPrompt, buildRunner);
     }