@pristine-ts/cli 1.0.440 → 2.0.1

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

@@ -0,0 +1,315 @@
+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 fs from "fs";
+import path from "path";
+import { pathToFileURL } from "url";
+import { LoggingModuleKeyname, OutputModeEnum, SeverityEnum } from "@pristine-ts/logging";
+import { DirectoryListResultEnum, DirectoryManager, FileManager, MatchTypeEnum, TypesEnum } from "@pristine-ts/file";
+import { CliModule } from "../cli.module";
+import { ConfigLoader } from "../config/config-loader";
+import { BuildManifestChecker } from "./build-manifest-checker";
+import { BuildManifestReader } from "./build-manifest-reader";
+import { BuildManifestStalenessEnum } from "./build-manifest-staleness.enum";
+import { BuildRunner } from "./build-runner";
+import { BuildStalenessPrompt } from "./build-staleness-prompt";
+import { DynamicImporter } from "./dynamic-importer";
+import { LoadedAppModule } from "./loaded-app-module";
+import { PluginLoader } from "./plugin-loader";
+/**
+ * Resolves the consumer's AppModule. The contract is intentionally narrow: there is
+ * exactly one supported way to specify the module — `appModule.sourcePath` +
+ * `appModule.outputPath` in `pristine.config.ts` (or `pristine.config.js`).
+ *
+ * Resolution path:
+ *   1. Read `pristine.config.{ts,js}` via `ConfigLoader`.
+ *   2. If `appModule` is configured: ensure the build is fresh (manifest check, prompt or
+ *      fail on stale), then dynamically import the configured `outputPath`.
+ *   3. If anything above is missing or broken: fall back to a `CliModule`-only synthetic
+ *      AppModule so built-in commands (notably `pristine init`) remain runnable. This is
+ *      the only escape hatch — there is no convention scan, no package.json discovery,
+ *      no cached prior selection.
+ */
+let AppModuleLoader = class AppModuleLoader {
+    constructor(configLoader, pluginLoader, dynamicImporter, buildManifestReader, buildManifestChecker, buildStalenessPrompt, buildRunner) {
+        this.configLoader = configLoader;
+        this.pluginLoader = pluginLoader;
+        this.dynamicImporter = dynamicImporter;
+        this.buildManifestReader = buildManifestReader;
+        this.buildManifestChecker = buildManifestChecker;
+        this.buildStalenessPrompt = buildStalenessPrompt;
+        this.buildRunner = buildRunner;
+        this.defaultExportName = "AppModule";
+        this.fallbackKeyname = "__auto_generated_app.module__";
+    }
+    /**
+     * Resolves the consumer's AppModule and the kernel configuration the CLI should boot
+     * with. The flow has five stages, executed in order:
+     *
+     *   1. **Read the project's pristine.config.{ts,js}** — single source of truth for
+     *      where the user's AppModule lives and what plugins to wire in.
+     *   2. **Check the compiled AppModule is in sync with its source** — when both
+     *      `appModule.sourcePath` and `appModule.outputPath` are configured, compare the
+     *      build manifest's recorded source hash against the current source. If they
+     *      diverge (the user edited source but didn't rebuild), prompt to rebuild in an
+     *      interactive terminal, or fail with an actionable error in CI / non-interactive
+     *      contexts.
+     *   3. **Dynamically import the compiled AppModule** — load the JS file at
+     *      `outputPath` and pull out the configured named export (default `AppModule`).
+     *   4. **Substitute a CliModule-only AppModule when nothing else worked** — when
+     *      there is no config file, no `appModule` block in the config, or the import
+     *      threw, build a synthetic AppModule that imports just CliModule. This keeps the
+     *      bin runnable so the user can run `pristine init`, `pristine help`, etc. to
+     *      recover. There is no convention scan, no package.json discovery — only this
+     *      one escape hatch.
+     *   5. **Wrap with config-declared plugins** — load every plugin listed in the
+     *      config's `plugins` array and merge their modules into the AppModule's import
+     *      graph via a synthetic outer module.
+     *
+     * Final output: a `LoadedAppModule` carrying the (possibly wrapped) AppModule, the
+     * kernel configuration overlay, the logging-module-present flag, and the loaded
+     * plugin list.
+     */
+    load() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const projectRoot = process.cwd();
+            let appModule;
+            let isLoggingModulePresent = false;
+            let resolvedPath;
+            let appModuleExportName = this.defaultExportName;
+            // ── Stage 1: read the project's pristine.config.{ts,js}. ──
+            // Walks up from cwd looking for the config file; returns an empty config object
+            // when no file is found, which lets the substitute-AppModule branch in Stage 4
+            // take over instead of erroring out.
+            const resolvedConfig = yield this.configLoader.load({ startDir: projectRoot });
+            const appModuleConfig = resolvedConfig.config.appModule;
+            // Honor `appModule.export` for projects whose AppModule isn't named `AppModule`.
+            if ((appModuleConfig === null || appModuleConfig === void 0 ? void 0 : appModuleConfig.export) !== undefined) {
+                appModuleExportName = appModuleConfig.export;
+            }
+            // ── Stage 2: check the compiled AppModule is in sync with its source. ──
+            // Only runs when both sourcePath + outputPath are configured (the canonical setup).
+            // `ensureFreshBuild` returns false when the user declined to rebuild after a
+            // staleness prompt, or when we're non-interactive and stale. In either case we
+            // substitute the CliModule-only AppModule so commands like `pristine init` and
+            // `pristine help` still work.
+            if ((appModuleConfig === null || appModuleConfig === void 0 ? void 0 : appModuleConfig.sourcePath) !== undefined && (appModuleConfig === null || appModuleConfig === void 0 ? void 0 : appModuleConfig.outputPath) !== undefined) {
+                const ensured = yield this.ensureFreshBuild(projectRoot, appModuleConfig.sourcePath, appModuleConfig.outputPath);
+                if (ensured === false) {
+                    const fallback = yield this.buildFallbackAppModule(projectRoot);
+                    return new LoadedAppModule(fallback.appModule, this.buildKernelConfiguration(fallback.isLoggingModulePresent, resolvedConfig.config.kernelConfiguration), fallback.isLoggingModulePresent, []);
+                }
+                resolvedPath = path.resolve(projectRoot, appModuleConfig.outputPath);
+            }
+            // ── Stage 3: dynamically import the AppModule (or fall through to Stage 4). ──
+            if (resolvedPath !== undefined) {
+                // Stage 3: dynamic import. The compiled output is a regular JS module; we pull
+                // out the named export and detect LoggingModule presence so Stage 5 can decide
+                // whether to install the CLI's default console-logger configuration overlay.
+                try {
+                    appModule = yield this.importAppModule(resolvedPath, appModuleExportName);
+                    isLoggingModulePresent = ((_a = appModule.importModules) !== null && _a !== void 0 ? _a : []).find(m => m.keyname === LoggingModuleKeyname) !== undefined;
+                }
+                catch (error) {
+                    // Stage 4 (the configured file is broken or missing): we don't crash — that
+                    // would prevent `pristine init` from running and leave the user with no way to
+                    // fix their config. Warn loudly, substitute the CliModule-only AppModule, and
+                    // let the user re-run after fixing the issue.
+                    process.stderr.write(`[pristine] Failed to load AppModule from '${resolvedPath}': ${error.message}\n` +
+                        `[pristine] Falling back to built-in commands only. Fix your AppModule config and re-run.\n`);
+                    const fallback = yield this.buildFallbackAppModule(projectRoot);
+                    appModule = fallback.appModule;
+                    isLoggingModulePresent = fallback.isLoggingModulePresent;
+                }
+            }
+            else {
+                // Stage 4 (no `appModule` block, or no config file at all): substitute the
+                // CliModule-only AppModule so the bin can still bootstrap the user's project.
+                // First-run case (`pristine init` from a fresh project) lands here.
+                const fallback = yield this.buildFallbackAppModule(projectRoot);
+                appModule = fallback.appModule;
+                isLoggingModulePresent = fallback.isLoggingModulePresent;
+            }
+            // ── Stage 5: wrap with config-declared plugins. ──
+            // Plugins declared in `pristine.config.ts` contribute additional modules (e.g.
+            // tooling-only modules the user doesn't want polluting their runtime AppModule).
+            // A failing plugin warns but doesn't abort — the bin stays usable so the user can
+            // fix the offending entry.
+            let plugins = [];
+            try {
+                plugins = yield this.pluginLoader.load(resolvedConfig.config, resolvedConfig.configFilePath, projectRoot);
+            }
+            catch (error) {
+                process.stderr.write(`${error.message}\n`);
+                process.stderr.write("[pristine] Continuing without plugins. Fix the plugin config and re-run.\n");
+            }
+            if (plugins.length > 0) {
+                // Wrap the AppModule with a synthetic outer module that imports both the user's
+                // module and every plugin. Re-detect logging because a plugin could have brought
+                // it in.
+                appModule = this.pluginLoader.wrap(appModule, plugins);
+                if (isLoggingModulePresent === false) {
+                    isLoggingModulePresent = ((_b = appModule.importModules) !== null && _b !== void 0 ? _b : []).find(m => m.keyname === LoggingModuleKeyname) !== undefined;
+                }
+            }
+            // ── Final: assemble the kernel configuration overlay and return. ──
+            // The CLI installs sensible defaults for LoggingModule (simple output mode,
+            // error-level threshold) when LoggingModule is present, then layers the user's
+            // `kernelConfiguration` on top so they can override anything they want.
+            const configuration = this.buildKernelConfiguration(isLoggingModulePresent, resolvedConfig.config.kernelConfiguration);
+            return new LoadedAppModule(appModule, configuration, isLoggingModulePresent, plugins);
+        });
+    }
+    /**
+     * Manifest gate. Checks whether the build manifest still describes the current source/output
+     * paths and source content. If not, prompts the user (TTY) or fails (non-TTY) with a clear
+     * explanation. On a successful inline rebuild, returns true.
+     *
+     * Returns true when the build is fresh or just got rebuilt; false when the user declined to
+     * rebuild or when non-TTY hit a stale state. Callers should treat false as "stop the load".
+     * @private
+     */
+    ensureFreshBuild(projectRoot, sourcePath, outputPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const manifest = this.buildManifestReader.read(projectRoot);
+            const staleness = this.buildManifestChecker.check(manifest, projectRoot, sourcePath, outputPath);
+            if (staleness === BuildManifestStalenessEnum.Fresh) {
+                return true;
+            }
+            // No manifest on disk → user is building with their own pipeline (raw `tsc`, esbuild,
+            // a CI step, etc.) and never invoking `pristine build`. The manifest's purpose is to
+            // detect drift between source and a Pristine-managed build; with no manifest there is
+            // nothing to compare against, so we skip the gate. We still require the configured
+            // `outputPath` to exist — otherwise there's nothing to load.
+            if (staleness === BuildManifestStalenessEnum.Missing) {
+                const absoluteOutput = path.resolve(projectRoot, outputPath);
+                if (fs.existsSync(absoluteOutput)) {
+                    return true;
+                }
+                // Fall through to the "stale" path below — the output is genuinely missing,
+                // which the prompt/non-TTY branches handle with the right error message.
+            }
+            const explanation = this.buildStalenessPrompt.describe(staleness);
+            if (this.buildStalenessPrompt.isInteractive() === false) {
+                process.stderr.write(`[pristine] ${explanation}\n`);
+                return false;
+            }
+            const shouldRebuild = yield this.buildStalenessPrompt.prompt(staleness);
+            if (shouldRebuild !== true) {
+                process.stderr.write(`[pristine] ${explanation}\n`);
+                return false;
+            }
+            process.stderr.write(`[pristine] Rebuilding...\n`);
+            const buildSucceeded = this.buildRunner.run();
+            if (buildSucceeded === false) {
+                process.stderr.write(`[pristine] Rebuild failed. Fix the build error and re-run.\n`);
+                return false;
+            }
+            // After a successful rebuild, re-check that the manifest now passes — guards against the
+            // edge case where `pristine build` ran but, for whatever reason (unconfigured paths,
+            // tsconfig mismatch), didn't write a fresh manifest.
+            const reReadManifest = this.buildManifestReader.read(projectRoot);
+            const recheckStaleness = this.buildManifestChecker.check(reReadManifest, projectRoot, sourcePath, outputPath);
+            if (recheckStaleness !== BuildManifestStalenessEnum.Fresh) {
+                process.stderr.write(`[pristine] Build ran but manifest is still stale: ${this.buildStalenessPrompt.describe(recheckStaleness)}\n`);
+                return false;
+            }
+            return true;
+        });
+    }
+    importAppModule(absolutePath, exportName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const url = pathToFileURL(absolutePath).href;
+            const loaded = yield this.dynamicImporter.import(url);
+            if (!loaded || !loaded[exportName]) {
+                throw new Error(`[pristine] The file at '${absolutePath}' was loaded but did not export '${exportName}'. ` +
+                    `Make sure your AppModule file does \`export const ${exportName}: AppModuleInterface = { ... }\`.`);
+            }
+            return loaded[exportName];
+        });
+    }
+    /**
+     * Builds the safety-net AppModule used when no `appModule` is configured or the configured
+     * file fails to load. Scrapes any `node_modules/@pristine-ts/*` packages already installed
+     * so built-in commands they contribute (e.g. `pristine list`) are still available, then
+     * appends `CliModule` so at minimum the CLI's own commands run. This is intentionally a
+     * one-way safety net, not a discovery tier — it only fires when nothing else worked.
+     */
+    buildFallbackAppModule(projectRoot) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const pristineNodeModulesPath = path.resolve(projectRoot, "node_modules", "@pristine-ts");
+            const modules = [];
+            let isLoggingModulePresent = false;
+            if (fs.existsSync(pristineNodeModulesPath)) {
+                const directoryManager = new DirectoryManager(new FileManager());
+                const moduleFiles = yield directoryManager.list(pristineNodeModulesPath, {
+                    matchType: MatchTypeEnum.Path,
+                    match: /.*\/cjs\/.*\.module\.js$/,
+                    types: TypesEnum.File,
+                    resultType: DirectoryListResultEnum.FilePath,
+                    recurse: true,
+                });
+                for (const moduleFile of moduleFiles) {
+                    const module = yield this.dynamicImporter.import(pathToFileURL(moduleFile).href);
+                    for (const key in module) {
+                        if (key === "LoggingModule")
+                            isLoggingModulePresent = true;
+                        if (key.endsWith("Module"))
+                            modules.push(module[key]);
+                    }
+                }
+            }
+            if (modules.length === 0) {
+                modules.push(CliModule);
+            }
+            return {
+                appModule: {
+                    keyname: this.fallbackKeyname,
+                    importModules: modules,
+                    importServices: [],
+                },
+                isLoggingModulePresent,
+            };
+        });
+    }
+    buildKernelConfiguration(isLoggingModulePresent, userKernelConfiguration) {
+        const configuration = {};
+        if (isLoggingModulePresent) {
+            configuration[LoggingModuleKeyname + ".consoleLoggerOutputMode"] = OutputModeEnum.Simple;
+            configuration[LoggingModuleKeyname + ".logSeverityLevelConfiguration"] = SeverityEnum.Error;
+        }
+        if (userKernelConfiguration !== undefined) {
+            Object.assign(configuration, userKernelConfiguration);
+        }
+        return configuration;
+    }
+};
+AppModuleLoader = __decorate([
+    injectable(),
+    __metadata("design:paramtypes", [ConfigLoader,
+        PluginLoader,
+        DynamicImporter,
+        BuildManifestReader,
+        BuildManifestChecker,
+        BuildStalenessPrompt,
+        BuildRunner])
+], AppModuleLoader);
+export { AppModuleLoader };
+//# sourceMappingURL=app-module-loader.js.map

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

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

package/dist/lib/esm/bootstrap/bootstrap.js

@@ -0,0 +1,15 @@
+export * from "./app-module-loader";
+export * from "./build-manifest";
+export * from "./build-manifest-checker";
+export * from "./build-manifest-reader";
+export * from "./build-manifest-staleness.enum";
+export * from "./build-manifest-writer";
+export * from "./build-runner";
+export * from "./build-staleness-prompt";
+export * from "./dynamic-importer";
+export * from "./init-prompt";
+export * from "./loaded-app-module";
+export * from "./loaded-plugin";
+export * from "./plugin-loader";
+export * from "./source-hasher";
+//# sourceMappingURL=bootstrap.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../../../src/bootstrap/bootstrap.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

package/dist/lib/esm/bootstrap/build-manifest-checker.js

@@ -0,0 +1,61 @@
+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);
+};
+import { injectable } from "tsyringe";
+import fs from "fs";
+import path from "path";
+import { BuildManifestStalenessEnum } from "./build-manifest-staleness.enum";
+import { SourceHasher } from "./source-hasher";
+/**
+ * Decides whether an existing `BuildManifest` still describes the current state of the
+ * project. Compares the manifest's stored paths/hash against the live config + source file
+ * + filesystem. Returns the most-specific reason the manifest is stale so the caller can
+ * render a helpful message ("source changed", "output missing", etc.) rather than a vague
+ * "stale".
+ *
+ * Order of checks matches user impact: things that mean "you definitely need to rebuild"
+ * (output missing, source content changed) come before path drift (config edited but build
+ * not yet rerun) — both are correct to flag, but the messaging differs.
+ */
+let BuildManifestChecker = class BuildManifestChecker {
+    constructor(sourceHasher) {
+        this.sourceHasher = sourceHasher;
+    }
+    check(manifest, projectRoot, configuredSourcePath, configuredOutputPath) {
+        if (manifest === undefined) {
+            return BuildManifestStalenessEnum.Missing;
+        }
+        const absoluteConfiguredSource = path.resolve(projectRoot, configuredSourcePath);
+        const absoluteConfiguredOutput = path.resolve(projectRoot, configuredOutputPath);
+        if (manifest.appModuleSourcePath !== absoluteConfiguredSource) {
+            return BuildManifestStalenessEnum.SourcePathChanged;
+        }
+        if (manifest.appModuleOutputPath !== absoluteConfiguredOutput) {
+            return BuildManifestStalenessEnum.OutputPathChanged;
+        }
+        if (fs.existsSync(manifest.appModuleOutputPath) === false) {
+            return BuildManifestStalenessEnum.OutputMissing;
+        }
+        if (fs.existsSync(manifest.appModuleSourcePath) === false) {
+            // Source vanished — report as content-changed since "missing" is the extreme form.
+            return BuildManifestStalenessEnum.SourceContentChanged;
+        }
+        const currentHash = this.sourceHasher.hashFile(manifest.appModuleSourcePath);
+        if (currentHash !== manifest.sourceHash) {
+            return BuildManifestStalenessEnum.SourceContentChanged;
+        }
+        return BuildManifestStalenessEnum.Fresh;
+    }
+};
+BuildManifestChecker = __decorate([
+    injectable(),
+    __metadata("design:paramtypes", [SourceHasher])
+], BuildManifestChecker);
+export { BuildManifestChecker };
+//# sourceMappingURL=build-manifest-checker.js.map

package/dist/lib/esm/bootstrap/build-manifest-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-manifest-checker.js","sourceRoot":"","sources":["../../../../src/bootstrap/build-manifest-checker.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAC,0BAA0B,EAAC,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAE7C;;;;;;;;;;GAUG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAC/B,YAA6B,YAA0B;QAA1B,iBAAY,GAAZ,YAAY,CAAc;IACvD,CAAC;IAED,KAAK,CACH,QAAmC,EACnC,WAAmB,EACnB,oBAA4B,EAC5B,oBAA4B;QAE5B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,0BAA0B,CAAC,OAAO,CAAC;QAC5C,CAAC;QAED,MAAM,wBAAwB,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;QACjF,MAAM,wBAAwB,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;QAEjF,IAAI,QAAQ,CAAC,mBAAmB,KAAK,wBAAwB,EAAE,CAAC;YAC9D,OAAO,0BAA0B,CAAC,iBAAiB,CAAC;QACtD,CAAC;QAED,IAAI,QAAQ,CAAC,mBAAmB,KAAK,wBAAwB,EAAE,CAAC;YAC9D,OAAO,0BAA0B,CAAC,iBAAiB,CAAC;QACtD,CAAC;QAED,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,mBAAmB,CAAC,KAAK,KAAK,EAAE,CAAC;YAC1D,OAAO,0BAA0B,CAAC,aAAa,CAAC;QAClD,CAAC;QAED,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,mBAAmB,CAAC,KAAK,KAAK,EAAE,CAAC;YAC1D,mFAAmF;YACnF,OAAO,0BAA0B,CAAC,oBAAoB,CAAC;QACzD,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;QAC7E,IAAI,WAAW,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC;YACxC,OAAO,0BAA0B,CAAC,oBAAoB,CAAC;QACzD,CAAC;QAED,OAAO,0BAA0B,CAAC,KAAK,CAAC;IAC1C,CAAC;CACF,CAAA;AAzCY,oBAAoB;IADhC,UAAU,EAAE;qCAEgC,YAAY;GAD5C,oBAAoB,CAyChC"}

package/dist/lib/esm/bootstrap/build-manifest-reader.js

@@ -0,0 +1,38 @@
+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 fs from "fs";
+import path from "path";
+import { BuildManifest } from "./build-manifest";
+/**
+ * Reads `<projectRoot>/.pristine/build-manifest.json` if present and returns a `BuildManifest`
+ * instance. Used by `AppModuleLoader` and `BuildManifestChecker` to inspect the last build.
+ *
+ * Returns `undefined` (not throws) when the manifest is missing — that's a normal state for
+ * fresh projects that haven't run `pristine build` yet. Genuine errors (corrupt JSON, IO
+ * failure) do throw, since silently treating those as "no manifest" would mask real problems.
+ */
+let BuildManifestReader = class BuildManifestReader {
+    constructor() {
+        this.cacheDirName = ".pristine";
+        this.manifestFileName = "build-manifest.json";
+    }
+    read(projectRoot) {
+        const manifestPath = path.resolve(projectRoot, this.cacheDirName, this.manifestFileName);
+        if (fs.existsSync(manifestPath) === false) {
+            return undefined;
+        }
+        const raw = fs.readFileSync(manifestPath, "utf8");
+        const parsed = JSON.parse(raw);
+        return new BuildManifest(parsed.appModuleSourcePath, parsed.appModuleOutputPath, parsed.sourceHash, parsed.builtAt);
+    }
+};
+BuildManifestReader = __decorate([
+    injectable()
+], BuildManifestReader);
+export { BuildManifestReader };
+//# sourceMappingURL=build-manifest-reader.js.map

package/dist/lib/esm/bootstrap/build-manifest-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-manifest-reader.js","sourceRoot":"","sources":["../../../../src/bootstrap/build-manifest-reader.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAE/C;;;;;;;GAOG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAAzB;QACY,iBAAY,GAAW,WAAW,CAAC;QACnC,qBAAgB,GAAW,qBAAqB,CAAC;IAkBpE,CAAC;IAhBC,IAAI,CAAC,WAAmB;QACtB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACzF,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,KAAK,EAAE,CAAC;YAC1C,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE/B,OAAO,IAAI,aAAa,CACtB,MAAM,CAAC,mBAAmB,EAC1B,MAAM,CAAC,mBAAmB,EAC1B,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,OAAO,CACf,CAAC;IACJ,CAAC;CACF,CAAA;AApBY,mBAAmB;IAD/B,UAAU,EAAE;GACA,mBAAmB,CAoB/B"}

package/dist/lib/esm/bootstrap/build-manifest-staleness.enum.js

@@ -0,0 +1,20 @@
+/**
+ * Why a build manifest is no longer trustworthy. Returned by `BuildManifestChecker` so the
+ * caller can render an error message specific to the actual cause rather than a vague "stale".
+ */
+export var BuildManifestStalenessEnum;
+(function (BuildManifestStalenessEnum) {
+    /** Manifest is current — the build output matches what the config + source describe. */
+    BuildManifestStalenessEnum["Fresh"] = "fresh";
+    /** No manifest file on disk. The user hasn't run `pristine build` yet (or deleted the cache). */
+    BuildManifestStalenessEnum["Missing"] = "missing";
+    /** The configured `sourcePath` no longer matches the path stored in the manifest. */
+    BuildManifestStalenessEnum["SourcePathChanged"] = "source-path-changed";
+    /** The configured `outputPath` no longer matches the path stored in the manifest. */
+    BuildManifestStalenessEnum["OutputPathChanged"] = "output-path-changed";
+    /** The source file's content hash no longer matches what was hashed at build time. */
+    BuildManifestStalenessEnum["SourceContentChanged"] = "source-content-changed";
+    /** The compiled output file referenced by the manifest is missing from disk. */
+    BuildManifestStalenessEnum["OutputMissing"] = "output-missing";
+})(BuildManifestStalenessEnum || (BuildManifestStalenessEnum = {}));
+//# sourceMappingURL=build-manifest-staleness.enum.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-manifest-staleness.enum.js","sourceRoot":"","sources":["../../../../src/bootstrap/build-manifest-staleness.enum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,0BAaX;AAbD,WAAY,0BAA0B;IACpC,wFAAwF;IACxF,6CAAe,CAAA;IACf,iGAAiG;IACjG,iDAAmB,CAAA;IACnB,qFAAqF;IACrF,uEAAyC,CAAA;IACzC,qFAAqF;IACrF,uEAAyC,CAAA;IACzC,sFAAsF;IACtF,6EAA+C,CAAA;IAC/C,gFAAgF;IAChF,8DAAgC,CAAA;AAClC,CAAC,EAbW,0BAA0B,KAA1B,0BAA0B,QAarC"}

package/dist/lib/esm/bootstrap/build-manifest-writer.js

@@ -0,0 +1,49 @@
+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);
+};
+import { injectable } from "tsyringe";
+import fs from "fs";
+import path from "path";
+import { BuildManifest } from "./build-manifest";
+import { SourceHasher } from "./source-hasher";
+/**
+ * Writes the build manifest to `<projectRoot>/.pristine/build-manifest.json` atomically
+ * (write-then-rename) so a partial write can never poison subsequent reads. Used by
+ * `BuildCommand` after a successful compile.
+ *
+ * Atomicity matters: if `pristine build` is interrupted (Ctrl+C, OOM kill) mid-write, a
+ * half-written JSON file would make the next `pristine start` think the build was good but
+ * fail to parse the manifest. Renaming after a complete write ensures readers either see
+ * the previous manifest or the new one — never a torn one.
+ */
+let BuildManifestWriter = class BuildManifestWriter {
+    constructor(sourceHasher) {
+        this.sourceHasher = sourceHasher;
+        this.cacheDirName = ".pristine";
+        this.manifestFileName = "build-manifest.json";
+    }
+    write(projectRoot, sourcePath, outputPath) {
+        const absoluteSource = path.resolve(projectRoot, sourcePath);
+        const absoluteOutput = path.resolve(projectRoot, outputPath);
+        const manifest = new BuildManifest(absoluteSource, absoluteOutput, this.sourceHasher.hashFile(absoluteSource), new Date().toISOString());
+        const cacheDir = path.resolve(projectRoot, this.cacheDirName);
+        fs.mkdirSync(cacheDir, { recursive: true });
+        const finalPath = path.resolve(cacheDir, this.manifestFileName);
+        const tempPath = finalPath + ".tmp";
+        fs.writeFileSync(tempPath, JSON.stringify(manifest, null, 2), "utf8");
+        fs.renameSync(tempPath, finalPath);
+        return manifest;
+    }
+};
+BuildManifestWriter = __decorate([
+    injectable(),
+    __metadata("design:paramtypes", [SourceHasher])
+], BuildManifestWriter);
+export { BuildManifestWriter };
+//# sourceMappingURL=build-manifest-writer.js.map

package/dist/lib/esm/bootstrap/build-manifest-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-manifest-writer.js","sourceRoot":"","sources":["../../../../src/bootstrap/build-manifest-writer.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAE7C;;;;;;;;;GASG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAI9B,YAA6B,YAA0B;QAA1B,iBAAY,GAAZ,YAAY,CAAc;QAHtC,iBAAY,GAAW,WAAW,CAAC;QACnC,qBAAgB,GAAW,qBAAqB,CAAC;IAGlE,CAAC;IAED,KAAK,CAAC,WAAmB,EAAE,UAAkB,EAAE,UAAkB;QAC/D,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAC7D,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAE7D,MAAM,QAAQ,GAAG,IAAI,aAAa,CAChC,cAAc,EACd,cAAc,EACd,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,cAAc,CAAC,EAC1C,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CACzB,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAC9D,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC;QAE1C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAChE,MAAM,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;QACpC,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACtE,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAEnC,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF,CAAA;AA5BY,mBAAmB;IAD/B,UAAU,EAAE;qCAKgC,YAAY;GAJ5C,mBAAmB,CA4B/B"}

package/dist/lib/esm/bootstrap/build-manifest.js

@@ -0,0 +1,27 @@
+/**
+ * On-disk record of what `pristine build` produced. Written atomically at the end of a
+ * successful build to `.pristine/build-manifest.json`. Read by every downstream command that
+ * loads the AppModule (`pristine start`, `pristine verify`, etc.) so the loader can detect
+ * staleness — source file changed, config changed, output file missing — without scanning
+ * the filesystem.
+ *
+ * Plain class (no DI / no methods) because manifests serialize to/from JSON and the simpler
+ * the shape is, the harder it is to break the on-disk contract by accident.
+ */
+export class BuildManifest {
+    constructor(
+    /** Absolute path to the AppModule source file as it was at build time. */
+    appModuleSourcePath, 
+    /** Absolute path to the compiled AppModule output file as it was at build time. */
+    appModuleOutputPath, 
+    /** SHA-256 of the source file contents at build time. Drives staleness detection. */
+    sourceHash, 
+    /** ISO-8601 timestamp of when the build completed. */
+    builtAt) {
+        this.appModuleSourcePath = appModuleSourcePath;
+        this.appModuleOutputPath = appModuleOutputPath;
+        this.sourceHash = sourceHash;
+        this.builtAt = builtAt;
+    }
+}
+//# sourceMappingURL=build-manifest.js.map

package/dist/lib/esm/bootstrap/build-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-manifest.js","sourceRoot":"","sources":["../../../../src/bootstrap/build-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,OAAO,aAAa;IACxB;IACE,0EAA0E;IAC1D,mBAA2B;IAC3C,mFAAmF;IACnE,mBAA2B;IAC3C,qFAAqF;IACrE,UAAkB;IAClC,sDAAsD;IACtC,OAAe;QANf,wBAAmB,GAAnB,mBAAmB,CAAQ;QAE3B,wBAAmB,GAAnB,mBAAmB,CAAQ;QAE3B,eAAU,GAAV,UAAU,CAAQ;QAElB,YAAO,GAAP,OAAO,CAAQ;IAEjC,CAAC;CACF"}

package/dist/lib/esm/bootstrap/build-runner.js

@@ -0,0 +1,41 @@
+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 { spawnSync } from "child_process";
+/**
+ * Runs `pristine p:build` as a subprocess of the currently-running bin. Used by
+ * `AppModuleLoader` when the user accepts the "rebuild now?" prompt — re-running the build
+ * inline avoids the awkward "exit, ask the user to type a command, re-enter" loop.
+ *
+ * Spawning rather than dispatching to `BuildCommand` directly keeps `AppModuleLoader` free
+ * of the build pipeline's dependency graph (ConsoleManager, ShellManager, etc.) which only
+ * exists in the kernel container — and the kernel hasn't booted yet at the point this is
+ * called. The subprocess re-bootstraps the kernel cleanly with all of those services.
+ *
+ * Returns `true` on a successful build (exit code 0), `false` on any failure or signal.
+ */
+let BuildRunner = class BuildRunner {
+    constructor() {
+        this.buildCommandName = "p:build";
+    }
+    run() {
+        // process.argv[1] is the absolute path to the running bin file (set by Node when the
+        // bin was invoked). Re-spawning the same bin guarantees we use the exact same CLI
+        // version + setup the user is currently running against — no risk of resolving a
+        // different `pristine` from PATH that doesn't match this process's expectations.
+        const result = spawnSync(process.execPath, [process.argv[1], this.buildCommandName], {
+            stdio: "inherit",
+            cwd: process.cwd(),
+        });
+        return result.status === 0;
+    }
+};
+BuildRunner = __decorate([
+    injectable()
+], BuildRunner);
+export { BuildRunner };
+//# sourceMappingURL=build-runner.js.map

package/dist/lib/esm/bootstrap/build-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-runner.js","sourceRoot":"","sources":["../../../../src/bootstrap/build-runner.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AACpC,OAAO,EAAC,SAAS,EAAC,MAAM,eAAe,CAAC;AAExC;;;;;;;;;;;GAWG;AAEI,IAAM,WAAW,GAAjB,MAAM,WAAW;IAAjB;QACY,qBAAgB,GAAW,SAAS,CAAC;IAcxD,CAAC;IAZC,GAAG;QACD,qFAAqF;QACrF,kFAAkF;QAClF,iFAAiF;QACjF,iFAAiF;QACjF,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC,EAAE;YACnF,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;SACnB,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;IAC7B,CAAC;CACF,CAAA;AAfY,WAAW;IADvB,UAAU,EAAE;GACA,WAAW,CAevB"}