@pristine-ts/cli 1.0.439 → 2.0.1

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

@@ -0,0 +1,87 @@
+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());
+    });
+};
+import { injectable } from "tsyringe";
+import { BuildManifestStalenessEnum } from "./build-manifest-staleness.enum";
+import { DynamicImporter } from "./dynamic-importer";
+/**
+ * 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
+ * `pristine build` now; in non-TTY (CI, Docker), refuses to prompt and lets the caller exit
+ * non-zero with the explanation — auto-rebuilding in CI hides bugs.
+ *
+ * Just the prompt UI here. The actual rebuild dispatch is the caller's responsibility so
+ * this class stays small and testable.
+ */
+let BuildStalenessPrompt = class BuildStalenessPrompt {
+    constructor(dynamicImporter) {
+        this.dynamicImporter = dynamicImporter;
+        this.promptMessage = "Run `pristine build` now to refresh?";
+    }
+    isInteractive() {
+        return Boolean(process.stdout.isTTY) && Boolean(process.stdin.isTTY);
+    }
+    /**
+     * Renders a one-line explanation of why the manifest is stale. Used by both the prompt
+     * (TTY) and the non-TTY error path so the messaging is identical regardless of channel.
+     */
+    describe(reason) {
+        switch (reason) {
+            case BuildManifestStalenessEnum.Missing:
+                return "No build manifest found. Run `pristine build` before invoking this command.";
+            case BuildManifestStalenessEnum.SourcePathChanged:
+                return "Your config's `appModule.sourcePath` no longer matches the last build. Run `pristine build` to rebuild against the new source.";
+            case BuildManifestStalenessEnum.OutputPathChanged:
+                return "Your config's `appModule.outputPath` no longer matches the last build. Run `pristine build` to rebuild against the new output path.";
+            case BuildManifestStalenessEnum.SourceContentChanged:
+                return "Your AppModule source has changed since the last build. Run `pristine build` to recompile.";
+            case BuildManifestStalenessEnum.OutputMissing:
+                return "The compiled AppModule output is missing on disk. Run `pristine build` to produce it.";
+            case BuildManifestStalenessEnum.Fresh:
+                // Should never be asked to describe Fresh, but a safe fallback beats a thrown error
+                // in a hot path.
+                return "Build manifest is up to date.";
+        }
+    }
+    /**
+     * Asks the user whether to rebuild. Returns `true` for yes, `false` for no, `undefined`
+     * for cancellation (Ctrl+C). Caller decides what to do with each outcome.
+     */
+    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,
+                });
+            }
+            catch (_a) {
+                // @inquirer throws on Ctrl+C. Treat as a clean cancellation.
+                return undefined;
+            }
+        });
+    }
+};
+BuildStalenessPrompt = __decorate([
+    injectable(),
+    __metadata("design:paramtypes", [DynamicImporter])
+], BuildStalenessPrompt);
+export { BuildStalenessPrompt };
+//# sourceMappingURL=build-staleness-prompt.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-staleness-prompt.js","sourceRoot":"","sources":["../../../../src/bootstrap/build-staleness-prompt.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AACpC,OAAO,EAAC,0BAA0B,EAAC,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAC,eAAe,EAAC,MAAM,oBAAoB,CAAC;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,0BAA0B,CAAC,OAAO;gBACrC,OAAO,6EAA6E,CAAC;YACvF,KAAK,0BAA0B,CAAC,iBAAiB;gBAC/C,OAAO,gIAAgI,CAAC;YAC1I,KAAK,0BAA0B,CAAC,iBAAiB;gBAC/C,OAAO,qIAAqI,CAAC;YAC/I,KAAK,0BAA0B,CAAC,oBAAoB;gBAClD,OAAO,4FAA4F,CAAC;YACtG,KAAK,0BAA0B,CAAC,aAAa;gBAC3C,OAAO,uFAAuF,CAAC;YACjG,KAAK,0BAA0B,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,oBAAoB;IADhC,UAAU,EAAE;qCAImC,eAAe;GAHlD,oBAAoB,CAmDhC"}

package/dist/lib/esm/bootstrap/dynamic-importer.js

@@ -0,0 +1,40 @@
+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());
+    });
+};
+import { injectable } from "tsyringe";
+/**
+ * Wraps Node's real dynamic `import()` so it survives both tsc's CJS lowering and esbuild's
+ * bundling. Both transformations otherwise rewrite `await import(x)` to a `require(x)` call —
+ * which is wrong for ESM-only packages and for `file://` URLs. The Function constructor's body
+ * is opaque to both, so the `import()` inside it goes through unrewritten.
+ *
+ * Centralized in one class so the same escape hatch isn't reimplemented in every consumer
+ * (loaders, plugin discovery, config loading, etc.).
+ */
+let DynamicImporter = class DynamicImporter {
+    constructor() {
+        this.importFn = new Function("specifier", "return import(specifier);");
+    }
+    import(specifier) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.importFn(specifier);
+        });
+    }
+};
+DynamicImporter = __decorate([
+    injectable()
+], DynamicImporter);
+export { DynamicImporter };
+//# sourceMappingURL=dynamic-importer.js.map

package/dist/lib/esm/bootstrap/dynamic-importer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-importer.js","sourceRoot":"","sources":["../../../../src/bootstrap/dynamic-importer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AAEpC;;;;;;;;GAQG;AAEI,IAAM,eAAe,GAArB,MAAM,eAAe;IAArB;QACY,aAAQ,GAAwC,IAAI,QAAQ,CAC3E,WAAW,EACX,2BAA2B,CACW,CAAC;IAK3C,CAAC;IAHO,MAAM,CAAC,SAAiB;;YAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC;KAAA;CACF,CAAA;AATY,eAAe;IAD3B,UAAU,EAAE;GACA,eAAe,CAS3B"}

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

@@ -0,0 +1,124 @@
+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());
+    });
+};
+import { injectable } from "tsyringe";
+import { DynamicImporter } from "./dynamic-importer";
+/**
+ * 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).
+ *
+ * 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 —
+ * it keeps the call sites uniform regardless of whether the value came from a flag or a
+ * prompt.
+ */
+let InitPrompt = class InitPrompt {
+    constructor(dynamicImporter) {
+        this.dynamicImporter = dynamicImporter;
+        this.defaultSourcePath = "src/app.module.ts";
+        this.defaultOutputPath = "dist/app.module.js";
+        this.defaultTsconfig = "tsconfig.json";
+        this.defaultFormat = "esm";
+    }
+    isInteractive() {
+        return Boolean(process.stdout.isTTY) && Boolean(process.stdin.isTTY);
+    }
+    askSourcePath(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 does your AppModule source file live?",
+                default: 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,
+            });
+        });
+    }
+    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,
+            });
+        });
+    }
+    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,
+            });
+        });
+    }
+    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,
+            });
+        });
+    }
+    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,
+            });
+        });
+    }
+};
+InitPrompt = __decorate([
+    injectable(),
+    __metadata("design:paramtypes", [DynamicImporter])
+], InitPrompt);
+export { InitPrompt };
+//# sourceMappingURL=init-prompt.js.map

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

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

package/dist/lib/esm/bootstrap/loaded-app-module.js

@@ -0,0 +1,25 @@
+/**
+ * The fully-resolved AppModule + ambient configuration that the CLI uses to boot the kernel.
+ * Returned by `AppModuleLoader.load()`.
+ */
+export class LoadedAppModule {
+    constructor(appModule, configuration, 
+    /**
+     * True when `LoggingModule` is in the resolved AppModule's import graph. The CLI uses
+     * this to decide whether to layer in opinionated default logging configuration (Simple
+     * output mode, Error severity threshold) on top of the kernel configuration.
+     */
+    isLoggingModulePresent, 
+    /**
+     * Plugins loaded from `pristine.config.ts`'s `plugins` array. Empty when no plugins are
+     * declared. Carried through so commands like `pristine info` can show what's contributing
+     * extra modules to the runtime.
+     */
+    plugins) {
+        this.appModule = appModule;
+        this.configuration = configuration;
+        this.isLoggingModulePresent = isLoggingModulePresent;
+        this.plugins = plugins;
+    }
+}
+//# sourceMappingURL=loaded-app-module.js.map

package/dist/lib/esm/bootstrap/loaded-app-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loaded-app-module.js","sourceRoot":"","sources":["../../../../src/bootstrap/loaded-app-module.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,OAAO,eAAe;IAC1B,YACkB,SAA6B,EAC7B,aAA0D;IAC1E;;;;OAIG;IACa,sBAA+B;IAC/C;;;;OAIG;IACa,OAAuB;QAbvB,cAAS,GAAT,SAAS,CAAoB;QAC7B,kBAAa,GAAb,aAAa,CAA6C;QAM1D,2BAAsB,GAAtB,sBAAsB,CAAS;QAM/B,YAAO,GAAP,OAAO,CAAgB;IAEzC,CAAC;CACF"}

package/dist/lib/esm/bootstrap/loaded-plugin.js

@@ -0,0 +1,18 @@
+/**
+ * A successfully-loaded plugin. Records the package name (for collision diagnostics), the
+ * absolute path it was resolved to, and every `*Module` export the plugin's entry produced.
+ */
+export class LoadedPlugin {
+    constructor(
+    /** As declared in `pristine.config.ts` plugins[] (string form or `.name` form). */
+    name, 
+    /** Absolute path resolved by `createRequire` from the consumer's project. */
+    resolvedPath, 
+    /** Modules harvested from the plugin's exports — one entry per `*Module` named export. */
+    modules) {
+        this.name = name;
+        this.resolvedPath = resolvedPath;
+        this.modules = modules;
+    }
+}
+//# sourceMappingURL=loaded-plugin.js.map

package/dist/lib/esm/bootstrap/loaded-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loaded-plugin.js","sourceRoot":"","sources":["../../../../src/bootstrap/loaded-plugin.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,YAAY;IACvB;IACE,mFAAmF;IACnE,IAAY;IAC5B,6EAA6E;IAC7D,YAAoB;IACpC,0FAA0F;IAC1E,OAA0B;QAJ1B,SAAI,GAAJ,IAAI,CAAQ;QAEZ,iBAAY,GAAZ,YAAY,CAAQ;QAEpB,YAAO,GAAP,OAAO,CAAmB;IAE5C,CAAC;CACF"}

package/dist/lib/esm/bootstrap/plugin-loader.js

@@ -0,0 +1,143 @@
+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());
+    });
+};
+import { injectable } from "tsyringe";
+import { createRequire } from "module";
+import path from "path";
+import { pathToFileURL } from "url";
+import { DynamicImporter } from "./dynamic-importer";
+import { LoadedPlugin } from "./loaded-plugin";
+/**
+ * Resolves and loads every plugin declared in `config.plugins`. Plugin packages are resolved
+ * from the **consumer's project**, not from the CLI's install location — a plugin lives in
+ * the consumer's `node_modules`, not in `@pristine-ts/cli/node_modules`. Without
+ * `createRequire` pinned to the project location, `import("@my-org/plugin")` would walk up
+ * from the bin's install dir and miss it.
+ *
+ * A plugin that fails to load surfaces as a thrown error rather than being silently skipped —
+ * silent plugin loading is a footgun that makes "why isn't my command showing up" debuggable
+ * only by reading source.
+ */
+let PluginLoader = class PluginLoader {
+    constructor(dynamicImporter) {
+        this.dynamicImporter = dynamicImporter;
+    }
+    load(config, configFilePath, projectRoot) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const plugins = (_a = config.plugins) !== null && _a !== void 0 ? _a : [];
+            if (plugins.length === 0) {
+                return [];
+            }
+            // `createRequire` needs a "from" file to anchor resolution. When a config file exists,
+            // use it (so plugins resolve relative to where the config lives — important in monorepos).
+            // When no config file exists but plugins are somehow declared, anchor to the project root.
+            const anchor = configFilePath !== null && configFilePath !== void 0 ? configFilePath : path.join(projectRoot, "package.json");
+            const requireFn = createRequire(pathToFileURL(anchor).href);
+            const loaded = [];
+            for (const entry of plugins) {
+                const name = typeof entry === "string" ? entry : entry.name;
+                const resolvedPath = this.resolvePluginPath(name, requireFn, anchor);
+                const imported = yield this.importPlugin(name, resolvedPath);
+                const modules = this.harvestModuleExports(imported);
+                if (modules.length === 0) {
+                    throw new Error(`[pristine] Plugin '${name}' exported no '*Module' symbols. A plugin must export at least one ` +
+                        `ModuleInterface (e.g. \`export const FooModule: ModuleInterface = { keyname: "...", ... }\`).`);
+                }
+                loaded.push(new LoadedPlugin(name, resolvedPath, modules));
+            }
+            return loaded;
+        });
+    }
+    /**
+     * Synthesizes an outer AppModule whose `importModules` includes the user's AppModule plus
+     * every plugin-contributed module, deduplicated by reference. Preserves the user's keyname
+     * (suffixed with `.with-plugins`) so introspection tools (`pristine info`) still surface a
+     * recognizable label.
+     */
+    wrap(appModule, plugins) {
+        var _a;
+        if (plugins.length === 0) {
+            return appModule;
+        }
+        const seen = new Set();
+        const importModules = [];
+        const add = (m) => {
+            if (seen.has(m))
+                return;
+            seen.add(m);
+            importModules.push(m);
+        };
+        add(appModule);
+        for (const plugin of plugins) {
+            for (const module of plugin.modules) {
+                add(module);
+            }
+        }
+        return {
+            keyname: `${appModule.keyname}.with-plugins`,
+            importModules,
+            importServices: (_a = appModule.importServices) !== null && _a !== void 0 ? _a : [],
+        };
+    }
+    resolvePluginPath(name, requireFn, anchor) {
+        try {
+            return requireFn.resolve(name);
+        }
+        catch (error) {
+            throw new Error(`[pristine] Failed to resolve plugin '${name}' from '${anchor}': ${error.message}. ` +
+                `Make sure the plugin package is installed in your project's node_modules.`);
+        }
+    }
+    importPlugin(name, resolvedPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                return yield this.dynamicImporter.import(pathToFileURL(resolvedPath).href);
+            }
+            catch (error) {
+                throw new Error(`[pristine] Failed to import plugin '${name}' from '${resolvedPath}': ${error.message}`);
+            }
+        });
+    }
+    /**
+     * Walks a plugin's exports collecting every value whose name ends in `Module` and looks
+     * like a `ModuleInterface` (has a `keyname` string). Accepts both ESM (default export) and
+     * CJS (named exports on the module namespace) plugin shapes.
+     */
+    harvestModuleExports(imported) {
+        const modules = [];
+        const candidates = [imported, imported === null || imported === void 0 ? void 0 : imported.default].filter(o => o !== undefined && o !== null);
+        for (const candidate of candidates) {
+            for (const key of Object.keys(candidate)) {
+                if (key.endsWith("Module") === false)
+                    continue;
+                const value = candidate[key];
+                if (value !== null && typeof value === "object" && typeof value.keyname === "string") {
+                    modules.push(value);
+                }
+            }
+        }
+        return modules;
+    }
+};
+PluginLoader = __decorate([
+    injectable(),
+    __metadata("design:paramtypes", [DynamicImporter])
+], PluginLoader);
+export { PluginLoader };
+//# sourceMappingURL=plugin-loader.js.map

package/dist/lib/esm/bootstrap/plugin-loader.js.map

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

package/dist/lib/esm/bootstrap/source-hasher.js

@@ -0,0 +1,35 @@
+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;
+};
+import { injectable } from "tsyringe";
+import { createHash } from "crypto";
+import fs from "fs";
+/**
+ * Computes the content hash that goes into the build manifest. SHA-256 because it's
+ * collision-free for our purposes, ships with Node, and the hex digest is short enough
+ * to pretty-print in error messages without truncating.
+ *
+ * The hash is just a fingerprint of the source file's bytes — no AST awareness, no
+ * imports-aware tracing. That's intentional: a deeper hash (e.g. of the whole source tree)
+ * adds complexity and IO without changing the staleness story for the common case (user
+ * edits app.module.ts → hash changes → CLI tells them to rebuild).
+ */
+let SourceHasher = class SourceHasher {
+    constructor() {
+        this.algorithm = "sha256";
+        this.digestPrefix = "sha256:";
+    }
+    hashFile(absolutePath) {
+        const hash = createHash(this.algorithm);
+        hash.update(fs.readFileSync(absolutePath));
+        return this.digestPrefix + hash.digest("hex");
+    }
+};
+SourceHasher = __decorate([
+    injectable()
+], SourceHasher);
+export { SourceHasher };
+//# sourceMappingURL=source-hasher.js.map

package/dist/lib/esm/bootstrap/source-hasher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-hasher.js","sourceRoot":"","sources":["../../../../src/bootstrap/source-hasher.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AACpC,OAAO,EAAC,UAAU,EAAC,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB;;;;;;;;;GASG;AAEI,IAAM,YAAY,GAAlB,MAAM,YAAY;IAAlB;QACY,cAAS,GAAW,QAAQ,CAAC;QAC7B,iBAAY,GAAW,SAAS,CAAC;IAOpD,CAAC;IALC,QAAQ,CAAC,YAAoB;QAC3B,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;CACF,CAAA;AATY,YAAY;IADxB,UAAU,EAAE;GACA,YAAY,CASxB"}

package/dist/lib/esm/cli.js

@@ -0,0 +1,109 @@
+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());
+    });
+};
+import { ExecutionContextKeynameEnum, Kernel } from "@pristine-ts/core";
+import { ServiceDefinitionTagEnum } from "@pristine-ts/common";
+import { AppModuleLoader } from "./bootstrap/app-module-loader";
+import { BuildManifestChecker } from "./bootstrap/build-manifest-checker";
+import { BuildManifestReader } from "./bootstrap/build-manifest-reader";
+import { BuildRunner } from "./bootstrap/build-runner";
+import { BuildStalenessPrompt } from "./bootstrap/build-staleness-prompt";
+import { DynamicImporter } from "./bootstrap/dynamic-importer";
+import { PluginLoader } from "./bootstrap/plugin-loader";
+import { SourceHasher } from "./bootstrap/source-hasher";
+import { ConfigLoader } from "./config/config-loader";
+import { CliModule } from "./cli.module";
+/**
+ * Boots the CLI: discovers the consumer's AppModule, starts the kernel, and dispatches
+ * `process.argv` to whichever command matches. Exported so `bin.ts` can call it explicitly
+ * — the auto-invoke at module load was removed so library consumers importing this file for
+ * its types or `bootstrap` reference do not accidentally trigger an entire kernel boot.
+ *
+ * The bootstrap-layer collaborators (loaders, discoverers, cache, prompt) are instantiated
+ * by hand here rather than resolved through DI. The kernel container does not exist yet at
+ * this point, so DI is not available — manually wiring the (small, stable) class graph is the
+ * least surprising option. Once the kernel is up, the kernel itself is registered into its
+ * own container so commands can inject it.
+ */
+export const bootstrap = () => __awaiter(void 0, void 0, void 0, function* () {
+    const appModuleLoader = buildAppModuleLoader();
+    const { appModule, configuration } = yield appModuleLoader.load();
+    const kernel = new Kernel();
+    // Wrap the user's AppModule with CliModule so the CLI's own commands (`build`,
+    // `start`, `verify`, `init`, `help`, `list`, `info`, custom commands) are always
+    // registered when the bin is the entry point — regardless of whether the user's
+    // AppModule already imports CliModule. The kernel dedupes modules by keyname during
+    // start, so wrapping when CliModule is already in the graph is a no-op; we don't
+    // bother walking the graph to detect that case.
+    yield kernel.start(wrapWithCliModule(appModule), configuration);
+    // Make the running kernel resolvable from within commands so things like `pristine start`
+    // and the alias commands can register signal handlers and resolve their delegates.
+    kernel.container.registerInstance(Kernel, kernel);
+    warnOnCommandCollisions(kernel);
+    yield kernel.handle(process.argv, { keyname: ExecutionContextKeynameEnum.Cli, context: null });
+});
+/**
+ * Hand-wired graph of the bootstrap-layer classes. The kernel container does not exist yet,
+ * so we cannot resolve via DI — but the class graph here is shallow and stable, so manual
+ * wiring stays readable. Each class is `@injectable()` so DI resolution would also work if
+ * we ever moved this into a kernel-pre-boot container.
+ */
+/**
+ * Builds a synthetic outer AppModule that imports both the user's AppModule and CliModule.
+ * 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.
+ */
+const wrapWithCliModule = (appModule) => {
+    var _a;
+    return {
+        keyname: `${appModule.keyname}.with-cli`,
+        importModules: [appModule, CliModule],
+        importServices: (_a = appModule.importServices) !== null && _a !== void 0 ? _a : [],
+    };
+};
+const buildAppModuleLoader = () => {
+    const dynamicImporter = new DynamicImporter();
+    const configLoader = new ConfigLoader(dynamicImporter);
+    const pluginLoader = new PluginLoader(dynamicImporter);
+    const sourceHasher = new SourceHasher();
+    const buildManifestReader = new BuildManifestReader();
+    const buildManifestChecker = new BuildManifestChecker(sourceHasher);
+    const buildStalenessPrompt = new BuildStalenessPrompt(dynamicImporter);
+    const buildRunner = new BuildRunner();
+    return new AppModuleLoader(configLoader, pluginLoader, dynamicImporter, buildManifestReader, buildManifestChecker, buildStalenessPrompt, buildRunner);
+};
+/**
+ * Walks every registered Command-tagged service and warns to stderr if multiple share a
+ * `name`. The CLI's event dispatcher picks whichever match it sees first — without this
+ * warning, a plugin silently shadowing a built-in command (or two plugins shadowing each
+ * other) would be invisible until someone debugged "why is my command not running?". Warning
+ * rather than throwing keeps the bin runnable; users decide whether to fix the conflict.
+ */
+const warnOnCommandCollisions = (kernel) => {
+    var _a;
+    let commands;
+    try {
+        commands = kernel.container.resolveAll(ServiceDefinitionTagEnum.Command);
+    }
+    catch (_b) {
+        return;
+    }
+    const byName = new Map();
+    for (const command of commands) {
+        byName.set(command.name, ((_a = byName.get(command.name)) !== null && _a !== void 0 ? _a : 0) + 1);
+    }
+    for (const [name, count] of byName.entries()) {
+        if (count > 1) {
+            process.stderr.write(`[pristine] WARNING: command '${name}' is registered ${count} times. Only the first match will be dispatched.\n`);
+        }
+    }
+};
+//# sourceMappingURL=cli.js.map

package/dist/lib/esm/cli.js.map

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