@pristine-ts/cli 1.0.440 → 2.0.2

package/dist/lib/cjs/commands/init.command.js

@@ -0,0 +1,249 @@
+"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());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InitCommand = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const common_1 = require("@pristine-ts/common");
+const tsyringe_1 = require("tsyringe");
+const console_manager_1 = require("../managers/console.manager");
+const exit_code_enum_1 = require("../enums/exit-code.enum");
+const cli_module_keyname_1 = require("../cli.module.keyname");
+const init_command_options_1 = require("./init.command-options");
+const init_prompt_1 = require("../bootstrap/init-prompt");
+/**
+ * Scaffolds a new Pristine project setup. In a TTY, prompts the user for source path,
+ * output path, tsconfig, build format, and a couple of yes/no decisions; in non-TTY (CI),
+ * accepts every value via `--source-path`, `--output-path`, etc. flags or refuses to run.
+ *
+ * What it produces:
+ *   - `pristine.config.ts` at the project root with the answers populated.
+ *   - Optionally, a starter AppModule at the configured `sourcePath` (only when the file
+ *     doesn't already exist — never overwrites).
+ *   - Optionally, `npm` scripts in `package.json`: `build`, `start`, `verify` (only ones
+ *     that don't already exist — never overwrites).
+ *   - `.pristine/` added to `.gitignore` if a `.gitignore` exists at the project root.
+ *
+ * Refuses to overwrite an existing `pristine.config.ts` so re-running init is safe.
+ */
+let InitCommand = class InitCommand {
+    constructor(consoleManager, initPrompt) {
+        this.consoleManager = consoleManager;
+        this.initPrompt = initPrompt;
+        this.optionsType = init_command_options_1.InitCommandOptions;
+        this.name = "p:init";
+        this.description = "Scaffold pristine.config.ts (and optionally an AppModule + npm scripts) interactively.";
+        this.configFileName = "pristine.config.ts";
+        this.gitignoreEntry = ".pristine/";
+    }
+    run(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const projectRoot = process.cwd();
+            const configPath = path_1.default.resolve(projectRoot, this.configFileName);
+            if (fs_1.default.existsSync(configPath)) {
+                this.consoleManager.writeError(`${this.configFileName} already exists at ${configPath}. Aborting to avoid overwriting.`);
+                return exit_code_enum_1.ExitCodeEnum.Error;
+            }
+            const answers = yield this.gatherAnswers(args);
+            if (answers === undefined) {
+                // Already-rendered error for non-TTY missing flags. Bail.
+                return exit_code_enum_1.ExitCodeEnum.Error;
+            }
+            fs_1.default.writeFileSync(configPath, this.renderConfigTemplate(answers), "utf8");
+            this.consoleManager.writeSuccess(`Created ${path_1.default.relative(projectRoot, configPath)}`);
+            if (answers.scaffoldSource) {
+                this.scaffoldSource(projectRoot, answers.sourcePath);
+            }
+            if (answers.writePackageScripts) {
+                this.addPackageScripts(projectRoot);
+            }
+            this.addToGitignore(projectRoot);
+            this.consoleManager.writeInfo("Next steps:");
+            this.consoleManager.writeLine("  1. npm install --save-dev @pristine-ts/cli  (if you haven't already)");
+            this.consoleManager.writeLine("  2. npm run build       # compile your AppModule");
+            this.consoleManager.writeLine("  3. npm run start       # boot your app");
+            return exit_code_enum_1.ExitCodeEnum.Success;
+        });
+    }
+    /**
+     * Fills in answers from CLI flags first, then prompts (in TTY) for whatever's missing.
+     * Returns undefined when running non-TTY with insufficient flags so the caller can exit
+     * with the right error code (already rendered).
+     * @private
+     */
+    gatherAnswers(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const sourcePath = args["source-path"];
+            const outputPath = args["output-path"];
+            const tsconfig = args.tsconfig;
+            const format = args.format;
+            if (this.initPrompt.isInteractive() === false) {
+                const missing = [];
+                if (sourcePath === undefined)
+                    missing.push("--source-path");
+                if (outputPath === undefined)
+                    missing.push("--output-path");
+                if (missing.length > 0) {
+                    this.consoleManager.writeError(`Non-interactive run is missing required flag(s): ${missing.join(", ")}. ` +
+                        `Either run \`pristine init\` in a terminal or pass the flags explicitly.`);
+                    return undefined;
+                }
+            }
+            return {
+                sourcePath: yield this.initPrompt.askSourcePath(sourcePath),
+                outputPath: yield this.initPrompt.askOutputPath(outputPath),
+                tsconfig: yield this.initPrompt.askTsconfig(tsconfig),
+                format: yield this.initPrompt.askFormat(format),
+                scaffoldSource: yield this.initPrompt.askScaffoldSource(args.scaffold, sourcePath !== null && sourcePath !== void 0 ? sourcePath : "src/app.module.ts"),
+                writePackageScripts: yield this.initPrompt.askWritePackageScripts(args.scripts),
+            };
+        });
+    }
+    /**
+     * Writes a starter AppModule at the configured source path if and only if the file
+     * doesn't already exist. Never overwrites — re-running init on an established project
+     * shouldn't risk clobbering real code.
+     * @private
+     */
+    scaffoldSource(projectRoot, sourcePath) {
+        const absolutePath = path_1.default.resolve(projectRoot, sourcePath);
+        if (fs_1.default.existsSync(absolutePath)) {
+            this.consoleManager.writeInfo(`AppModule source already exists at ${sourcePath}; skipping scaffold.`);
+            return;
+        }
+        fs_1.default.mkdirSync(path_1.default.dirname(absolutePath), { recursive: true });
+        fs_1.default.writeFileSync(absolutePath, this.renderAppModuleTemplate(), "utf8");
+        this.consoleManager.writeSuccess(`Created ${sourcePath}`);
+    }
+    /**
+     * Adds `build`, `start`, `verify` to package.json's scripts. Only adds scripts that
+     * don't already exist — never overwrites a user-defined script.
+     * @private
+     */
+    addPackageScripts(projectRoot) {
+        var _a;
+        const packageJsonPath = path_1.default.resolve(projectRoot, "package.json");
+        if (fs_1.default.existsSync(packageJsonPath) === false) {
+            this.consoleManager.writeWarning("package.json not found; skipping script additions.");
+            return;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(fs_1.default.readFileSync(packageJsonPath, "utf8"));
+        }
+        catch (error) {
+            this.consoleManager.writeError(`Failed to parse package.json: ${error.message}`);
+            return;
+        }
+        parsed.scripts = (_a = parsed.scripts) !== null && _a !== void 0 ? _a : {};
+        const desired = {
+            build: "pristine build",
+            start: "pristine start",
+            verify: "pristine verify",
+        };
+        const added = [];
+        const skipped = [];
+        for (const [scriptName, scriptCommand] of Object.entries(desired)) {
+            if (parsed.scripts[scriptName] === undefined) {
+                parsed.scripts[scriptName] = scriptCommand;
+                added.push(scriptName);
+            }
+            else {
+                skipped.push(scriptName);
+            }
+        }
+        if (added.length === 0) {
+            this.consoleManager.writeInfo("All target scripts already exist in package.json; nothing added.");
+            return;
+        }
+        fs_1.default.writeFileSync(packageJsonPath, JSON.stringify(parsed, null, 2) + "\n", "utf8");
+        this.consoleManager.writeSuccess(`Added ${added.length} script(s) to package.json: ${added.join(", ")}`);
+        if (skipped.length > 0) {
+            this.consoleManager.writeInfo(`Kept existing script(s): ${skipped.join(", ")}`);
+        }
+    }
+    /**
+     * Adds `.pristine/` to `.gitignore` if `.gitignore` exists and the entry isn't already
+     * there. Doesn't create `.gitignore` from scratch — that would be presumptuous in a
+     * project that hasn't initialized git.
+     * @private
+     */
+    addToGitignore(projectRoot) {
+        const gitignorePath = path_1.default.resolve(projectRoot, ".gitignore");
+        if (fs_1.default.existsSync(gitignorePath) === false)
+            return;
+        const current = fs_1.default.readFileSync(gitignorePath, "utf8");
+        const lines = current.split("\n").map(l => l.trim());
+        if (lines.includes(this.gitignoreEntry) || lines.includes(".pristine") || lines.includes(".pristine/*")) {
+            return;
+        }
+        const separator = current.endsWith("\n") ? "" : "\n";
+        fs_1.default.appendFileSync(gitignorePath, `${separator}${this.gitignoreEntry}\n`, "utf8");
+        this.consoleManager.writeInfo(`Added '${this.gitignoreEntry}' to .gitignore`);
+    }
+    renderConfigTemplate(answers) {
+        return `import {defineConfig} from "@pristine-ts/cli";
+
+/**
+ * Pristine CLI configuration. Generated by \`pristine init\`. Re-run \`pristine init\` to
+ * regenerate (it refuses to overwrite this file by design — delete it first).
+ */
+export default defineConfig({
+  appModule: {
+    sourcePath: "${answers.sourcePath}",
+    outputPath: "${answers.outputPath}",
+  },
+  build: {
+    tsconfig: "${answers.tsconfig}",
+    format: "${answers.format}",
+  },
+});
+`;
+    }
+    renderAppModuleTemplate() {
+        return `import {AppModuleInterface} from "@pristine-ts/common";
+import {CoreModule} from "@pristine-ts/core";
+
+/**
+ * Your application's root module. Imported by \`pristine\` at boot — anything reachable from
+ * \`importModules\` / \`importServices\` is registered with the kernel.
+ */
+export const AppModule: AppModuleInterface = {
+  keyname: "my-app",
+  importModules: [
+    CoreModule,
+  ],
+  importServices: [],
+};
+`;
+    }
+};
+exports.InitCommand = InitCommand;
+exports.InitCommand = InitCommand = __decorate([
+    (0, common_1.tag)(common_1.ServiceDefinitionTagEnum.Command),
+    (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname),
+    (0, tsyringe_1.injectable)(),
+    __metadata("design:paramtypes", [console_manager_1.ConsoleManager,
+        init_prompt_1.InitPrompt])
+], InitCommand);
+//# sourceMappingURL=init.command.js.map

package/dist/lib/cjs/commands/init.command.js.map

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

package/dist/lib/cjs/commands/list-alias.command.js

@@ -0,0 +1,50 @@
+"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.ListAliasCommand = void 0;
+const common_1 = require("@pristine-ts/common");
+const tsyringe_1 = require("tsyringe");
+const cli_module_keyname_1 = require("../cli.module.keyname");
+const list_command_1 = require("./list.command");
+/**
+ * Top-level alias for the framework-reserved `p:list` command. Injects the delegate
+ * directly via standard DI.
+ */
+let ListAliasCommand = class ListAliasCommand {
+    constructor(delegate) {
+        this.delegate = delegate;
+        this.optionsType = null;
+        this.name = "list";
+        this.description = "Alias for p:list.";
+    }
+    run(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.delegate.run(args);
+        });
+    }
+};
+exports.ListAliasCommand = ListAliasCommand;
+exports.ListAliasCommand = ListAliasCommand = __decorate([
+    (0, common_1.tag)(common_1.ServiceDefinitionTagEnum.Command),
+    (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname),
+    (0, tsyringe_1.injectable)(),
+    __metadata("design:paramtypes", [list_command_1.ListCommand])
+], ListAliasCommand);
+//# sourceMappingURL=list-alias.command.js.map

package/dist/lib/cjs/commands/list-alias.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-alias.command.js","sourceRoot":"","sources":["../../../../src/commands/list-alias.command.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,gDAAgF;AAChF,uCAAoC;AAGpC,8DAAuD;AACvD,iDAA2C;AAE3C;;;GAGG;AAII,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAK3B,YAA6B,QAAqB;QAArB,aAAQ,GAAR,QAAQ,CAAa;QAJlD,gBAAW,GAAG,IAAI,CAAC;QACnB,SAAI,GAAG,MAAM,CAAC;QACd,gBAAW,GAAG,mBAAmB,CAAC;IAGlC,CAAC;IAEK,GAAG,CAAC,IAAS;;YACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;KAAA;CACF,CAAA;AAXY,4CAAgB;2BAAhB,gBAAgB;IAH5B,IAAA,YAAG,EAAC,iCAAwB,CAAC,OAAO,CAAC;IACrC,IAAA,qBAAY,EAAC,qCAAgB,CAAC;IAC9B,IAAA,qBAAU,GAAE;qCAM4B,0BAAW;GALvC,gBAAgB,CAW5B"}

package/dist/lib/cjs/commands/list.command.js

@@ -27,12 +27,18 @@ const tsyringe_1 = require("tsyringe");
 const console_manager_1 = require("../managers/console.manager");
 const exit_code_enum_1 = require("../enums/exit-code.enum");
 const cli_module_keyname_1 = require("../cli.module.keyname");
+/**
+ * Lists every registered command's name. Like `HelpCommand`, this resolves the command set
+ * lazily inside `run()` via the injected child container to avoid the self-referential cycle
+ * that constructor-time `@injectAll(Command)` would create — see `HelpCommand` for details.
+ */
 let ListCommand = class ListCommand {
     constructor(consoleManager, container) {
         this.consoleManager = consoleManager;
         this.container = container;
         this.optionsType = null;
         this.name = "p:list";
+        this.description = "List every registered command (built-in and custom).";
     }
     run(args) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -48,7 +54,7 @@ exports.ListCommand = ListCommand = __decorate([
     (0, common_1.tag)(common_1.ServiceDefinitionTagEnum.Command),
     (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname),
     (0, tsyringe_1.injectable)(),
-    __param(1, (0, tsyringe_1.injectAll)(common_1.ServiceDefinitionTagEnum.CurrentChildContainer)),
+    __param(1, (0, tsyringe_1.inject)(common_1.ServiceDefinitionTagEnum.CurrentChildContainer)),
     __metadata("design:paramtypes", [console_manager_1.ConsoleManager, Object])
 ], ListCommand);
 //# sourceMappingURL=list.command.js.map

package/dist/lib/cjs/commands/list.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"list.command.js","sourceRoot":"","sources":["../../../../src/commands/list.command.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAAgF;AAChF,uCAAoE;AAEpE,iEAA2D;AAC3D,4DAAqD;AACrD,8DAAuD;AAKhD,IAAM,WAAW,GAAjB,MAAM,WAAW;IAItB,YACmB,cAA8B,EACY,SAA+C;QADzF,mBAAc,GAAd,cAAc,CAAgB;QAC6B,cAAS,GAAT,SAAS,CAAqB;QAL5G,gBAAW,GAAG,IAAI,CAAC;QACnB,SAAI,GAAG,QAAQ,CAAC;IAKhB,CAAC;IAEK,GAAG,CAAC,IAAS;;YACjB,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAC;YAC9D,MAAM,QAAQ,GAA4B,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,iCAAwB,CAAC,OAAO,CAAC,CAAC;YACtG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YAEzE,OAAO,6BAAY,CAAC,OAAO,CAAC;QAC9B,CAAC;KAAA;CACF,CAAA;AAhBY,kCAAW;sBAAX,WAAW;IAHvB,IAAA,YAAG,EAAC,iCAAwB,CAAC,OAAO,CAAC;IACrC,IAAA,qBAAY,EAAC,qCAAgB,CAAC;IAC9B,IAAA,qBAAU,GAAE;IAOR,WAAA,IAAA,oBAAS,EAAC,iCAAwB,CAAC,qBAAqB,CAAC,CAAA;qCADzB,gCAAc;GALtC,WAAW,CAgBvB"}
+{"version":3,"file":"list.command.js","sourceRoot":"","sources":["../../../../src/commands/list.command.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAAgF;AAChF,uCAAiE;AAEjE,iEAA2D;AAC3D,4DAAqD;AACrD,8DAAuD;AAEvD;;;;GAIG;AAII,IAAM,WAAW,GAAjB,MAAM,WAAW;IAKtB,YACmB,cAA8B,EACS,SAA+C;QADtF,mBAAc,GAAd,cAAc,CAAgB;QAC0B,cAAS,GAAT,SAAS,CAAqB;QANzG,gBAAW,GAAG,IAAI,CAAC;QACnB,SAAI,GAAG,QAAQ,CAAC;QAChB,gBAAW,GAAG,sDAAsD,CAAC;IAMrE,CAAC;IAEK,GAAG,CAAC,IAAS;;YACjB,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAC;YAC9D,MAAM,QAAQ,GAA4B,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,iCAAwB,CAAC,OAAO,CAAC,CAAC;YACtG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YAEzE,OAAO,6BAAY,CAAC,OAAO,CAAC;QAC9B,CAAC;KAAA;CACF,CAAA;AAlBY,kCAAW;sBAAX,WAAW;IAHvB,IAAA,YAAG,EAAC,iCAAwB,CAAC,OAAO,CAAC;IACrC,IAAA,qBAAY,EAAC,qCAAgB,CAAC;IAC9B,IAAA,qBAAU,GAAE;IAQR,WAAA,IAAA,iBAAM,EAAC,iCAAwB,CAAC,qBAAqB,CAAC,CAAA;qCADtB,gCAAc;GANtC,WAAW,CAkBvB"}

package/dist/lib/cjs/commands/start-alias.command.js

@@ -0,0 +1,51 @@
+"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.StartAliasCommand = void 0;
+const common_1 = require("@pristine-ts/common");
+const tsyringe_1 = require("tsyringe");
+const cli_module_keyname_1 = require("../cli.module.keyname");
+const start_command_1 = require("./start.command");
+const start_command_options_1 = require("./start.command-options");
+/**
+ * Top-level alias for the framework-reserved `p:start` command. Injects the delegate
+ * directly via standard DI.
+ */
+let StartAliasCommand = class StartAliasCommand {
+    constructor(delegate) {
+        this.delegate = delegate;
+        this.optionsType = start_command_options_1.StartCommandOptions;
+        this.name = "start";
+        this.description = "Alias for p:start.";
+    }
+    run(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.delegate.run(args);
+        });
+    }
+};
+exports.StartAliasCommand = StartAliasCommand;
+exports.StartAliasCommand = StartAliasCommand = __decorate([
+    (0, common_1.tag)(common_1.ServiceDefinitionTagEnum.Command),
+    (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname),
+    (0, tsyringe_1.injectable)(),
+    __metadata("design:paramtypes", [start_command_1.StartCommand])
+], StartAliasCommand);
+//# sourceMappingURL=start-alias.command.js.map

package/dist/lib/cjs/commands/start-alias.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-alias.command.js","sourceRoot":"","sources":["../../../../src/commands/start-alias.command.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,gDAAgF;AAChF,uCAAoC;AAGpC,8DAAuD;AACvD,mDAA6C;AAC7C,mEAA4D;AAE5D;;;GAGG;AAII,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAK5B,YAA6B,QAAsB;QAAtB,aAAQ,GAAR,QAAQ,CAAc;QAJnD,gBAAW,GAAG,2CAAmB,CAAC;QAClC,SAAI,GAAG,OAAO,CAAC;QACf,gBAAW,GAAG,oBAAoB,CAAC;IAGnC,CAAC;IAEK,GAAG,CAAC,IAAyB;;YACjC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;KAAA;CACF,CAAA;AAXY,8CAAiB;4BAAjB,iBAAiB;IAH7B,IAAA,YAAG,EAAC,iCAAwB,CAAC,OAAO,CAAC;IACrC,IAAA,qBAAY,EAAC,qCAAgB,CAAC;IAC9B,IAAA,qBAAU,GAAE;qCAM4B,4BAAY;GALxC,iBAAiB,CAW7B"}

package/dist/lib/cjs/commands/start.command-options.js

@@ -0,0 +1,34 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StartCommandOptions = void 0;
+require("reflect-metadata");
+const class_validator_1 = require("@pristine-ts/class-validator");
+/**
+ * Runtime overrides for `pristine start`. These are applied to every `RuntimeServerInterface`
+ * the kernel resolves — implementations are free to ignore them. The flags exist mainly for
+ * one-off cases ("I just need to test on a different port right now"); the canonical place
+ * to set defaults is the matching module's configurationDefinitions or `pristine.config.ts`.
+ */
+class StartCommandOptions {
+}
+exports.StartCommandOptions = StartCommandOptions;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], StartCommandOptions.prototype, "port", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], StartCommandOptions.prototype, "address", void 0);
+//# sourceMappingURL=start.command-options.js.map

package/dist/lib/cjs/commands/start.command-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.command-options.js","sourceRoot":"","sources":["../../../../src/commands/start.command-options.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,4BAA0B;AAC1B,kEAA4E;AAE5E;;;;;GAKG;AACH,MAAa,mBAAmB;CAQ/B;AARD,kDAQC;AALC;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;iDACG;AAId;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;oDACM"}

package/dist/lib/cjs/commands/start.command.js

@@ -0,0 +1,169 @@
+"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 __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+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 StartCommand_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StartCommand = void 0;
+const common_1 = require("@pristine-ts/common");
+const tsyringe_1 = require("tsyringe");
+const core_1 = require("@pristine-ts/core");
+const console_manager_1 = require("../managers/console.manager");
+const exit_code_enum_1 = require("../enums/exit-code.enum");
+const cli_module_keyname_1 = require("../cli.module.keyname");
+const start_command_options_1 = require("./start.command-options");
+/**
+ * Boots the AppModule, starts every registered `RuntimeServerInterface` (HTTP server, gRPC
+ * server, etc.), and keeps the process alive until SIGTERM or SIGINT. On signal, runs the
+ * registered `onShutdown` hooks via `Kernel.stop()` and exits.
+ *
+ * This is the production-grade entry point. Use `pristine start` (or its `pristine p:start`
+ * canonical name) instead of `node dist/main.js` if you want Pristine to manage the lifecycle,
+ * signal handling, and graceful shutdown — including listening on every server module the
+ * AppModule imports.
+ *
+ * Notes:
+ *   - The kernel is **already started** by `bootstrap()` before this command runs (the CLI
+ *     boots once for every command). This command does not call `kernel.start()` again — it
+ *     just starts the registered servers and keeps the process alive.
+ *   - `RuntimeServer`-tagged services are constructor-injected via `@injectAll`. This works
+ *     because `RuntimeServer` is a different tag than `Command`, so there's no self-reference
+ *     cycle (StartCommand is `@tag(Command)`, not `@tag(RuntimeServer)`). When no servers
+ *     are registered, the array is empty and the start path skips the loop.
+ *   - The `Kernel` is injected only for `kernel.stop()` — the legitimate use of the Kernel
+ *     as a service. Other resolution (commands, runtime servers, etc.) goes through
+ *     standard DI rather than reaching through `kernel.container`.
+ *   - The shutdown timeout (per `onShutdown` hook) defaults to 10 seconds. The whole-process
+ *     hard exit timeout defaults to 30 seconds — if the orderly shutdown doesn't finish in
+ *     that window, the process is force-exited so Kubernetes / ECS don't get stuck waiting.
+ *   - `--port` / `--address` flags are propagated to every RuntimeServer's `start()`. In
+ *     multi-server scenarios where servers should listen on different ports, use the per-module
+ *     configuration values (e.g. `pristine.http.kernel-server.port`) instead of CLI flags.
+ *   - Watch mode (`--watch`) is not yet implemented. For a dev loop, wrap `pristine start` in
+ *     `nodemon` or `tsx --watch`.
+ */
+let StartCommand = StartCommand_1 = class StartCommand {
+    constructor(consoleManager, kernel, servers) {
+        this.consoleManager = consoleManager;
+        this.kernel = kernel;
+        this.servers = servers;
+        this.optionsType = start_command_options_1.StartCommandOptions;
+        this.name = "p:start";
+        this.description = "Boot the AppModule and run until SIGTERM/SIGINT. Production-grade entry point.";
+        // Sentinel name of the DefaultRuntimeServer registered in @pristine-ts/core. We filter
+        // it out of `this.servers` before doing any real work because it's a no-op placeholder
+        // whose only job is to make `@injectAll(RuntimeServer)` resolvable in apps that don't
+        // import a real server module.
+        this.defaultRuntimeServerName = "__default__";
+    }
+    run(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const servers = this.servers.filter(s => s.name !== this.defaultRuntimeServerName);
+            const overrides = (args.port !== undefined || args.address !== undefined)
+                ? { port: args.port, address: args.address }
+                : undefined;
+            for (const server of servers) {
+                try {
+                    yield server.start(overrides);
+                }
+                catch (error) {
+                    this.consoleManager.writeError(`Failed to start server '${server.name}': ${error.message}`);
+                    // Best-effort: stop any servers that did start before we abort.
+                    for (const started of servers) {
+                        if (started === server)
+                            break;
+                        try {
+                            yield started.stop();
+                        }
+                        catch ( /* swallow */_a) { /* swallow */ }
+                    }
+                    return exit_code_enum_1.ExitCodeEnum.Error;
+                }
+            }
+            if (servers.length === 0) {
+                this.consoleManager.writeSuccess("Pristine app running. Send SIGTERM (or Ctrl+C) to stop.");
+            }
+            else {
+                const labels = servers.map(s => s.name).join(", ");
+                this.consoleManager.writeSuccess(`Pristine app running with ${servers.length} server(s): ${labels}. Send SIGTERM (or Ctrl+C) to stop.`);
+            }
+            return new Promise((resolve) => {
+                let shuttingDown = false;
+                // Keep the event loop alive. Without this, Node would exit as soon as it noticed nothing
+                // else (no open sockets, no timers, no listening servers from user modules) was pending —
+                // signal handlers alone don't count as work. The interval is a 1-day no-op heartbeat;
+                // we clear it on shutdown so the process can actually exit when stop() returns.
+                const heartbeat = setInterval(() => { }, 1 << 30);
+                const initiateShutdown = (signal) => __awaiter(this, void 0, void 0, function* () {
+                    if (shuttingDown) {
+                        // Second signal arrived while we're already shutting down — escalate to an immediate
+                        // hard exit. This mirrors the behavior of most production runtimes (one Ctrl+C =
+                        // graceful, two = right now).
+                        this.consoleManager.writeWarning(`Received ${signal} again — forcing exit.`);
+                        process.exit(130);
+                    }
+                    shuttingDown = true;
+                    this.consoleManager.writeInfo(`Received ${signal}, shutting down gracefully...`);
+                    const hardExitTimer = setTimeout(() => {
+                        this.consoleManager.writeError(`Shutdown exceeded ${StartCommand_1.HARD_EXIT_TIMEOUT_MS}ms — forcing exit.`);
+                        process.exit(1);
+                    }, StartCommand_1.HARD_EXIT_TIMEOUT_MS);
+                    // Don't keep the event loop alive just for the timer.
+                    hardExitTimer.unref();
+                    try {
+                        // Kernel.stop() invokes module onShutdown hooks in outer-to-inner order, including
+                        // HttpModule.onShutdown which calls KernelHttpServer.stop(). No need to stop the
+                        // servers individually here.
+                        yield this.kernel.stop();
+                        this.consoleManager.writeSuccess("Shutdown complete.");
+                        clearTimeout(hardExitTimer);
+                        clearInterval(heartbeat);
+                        resolve(exit_code_enum_1.ExitCodeEnum.Success);
+                    }
+                    catch (error) {
+                        this.consoleManager.writeError(`Shutdown error: ${error.message}`);
+                        clearTimeout(hardExitTimer);
+                        clearInterval(heartbeat);
+                        resolve(exit_code_enum_1.ExitCodeEnum.Error);
+                    }
+                });
+                // Register on each signal once. A second SIGINT/SIGTERM goes through `initiateShutdown`
+                // again, which detects `shuttingDown` and force-exits.
+                process.on("SIGTERM", () => { void initiateShutdown("SIGTERM"); });
+                process.on("SIGINT", () => { void initiateShutdown("SIGINT"); });
+            });
+        });
+    }
+};
+exports.StartCommand = StartCommand;
+// Force-exit safeguard: if onShutdown hooks are still running after this many milliseconds
+// past the first signal, the process is killed. Prevents orchestrators from waiting on a
+// wedged shutdown.
+StartCommand.HARD_EXIT_TIMEOUT_MS = 30000;
+exports.StartCommand = StartCommand = StartCommand_1 = __decorate([
+    (0, common_1.tag)(common_1.ServiceDefinitionTagEnum.Command),
+    (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname),
+    (0, tsyringe_1.injectable)(),
+    __param(2, (0, tsyringe_1.injectAll)(common_1.ServiceDefinitionTagEnum.RuntimeServer)),
+    __metadata("design:paramtypes", [console_manager_1.ConsoleManager,
+        core_1.Kernel, Array])
+], StartCommand);
+//# sourceMappingURL=start.command.js.map

package/dist/lib/cjs/commands/start.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.command.js","sourceRoot":"","sources":["../../../../src/commands/start.command.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAAgF;AAChF,uCAA+C;AAC/C,4CAAiE;AAEjE,iEAA2D;AAC3D,4DAAqD;AACrD,8DAAuD;AACvD,mEAA4D;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAII,IAAM,YAAY,oBAAlB,MAAM,YAAY;IAgBvB,YACmB,cAA8B,EAC9B,MAAc,EACoB,OAAkD;QAFpF,mBAAc,GAAd,cAAc,CAAgB;QAC9B,WAAM,GAAN,MAAM,CAAQ;QACqC,YAAO,GAAP,OAAO,CAA0B;QAlBvG,gBAAW,GAAG,2CAAmB,CAAC;QAClC,SAAI,GAAG,SAAS,CAAC;QACjB,gBAAW,GAAG,gFAAgF,CAAC;QAO/F,uFAAuF;QACvF,uFAAuF;QACvF,sFAAsF;QACtF,+BAA+B;QACd,6BAAwB,GAAW,aAAa,CAAC;IAOlE,CAAC;IAEK,GAAG,CAAC,IAAyB;;YACjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,wBAAwB,CAAC,CAAC;YAEnF,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC;gBACvE,CAAC,CAAC,EAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAC;gBAC1C,CAAC,CAAC,SAAS,CAAC;YAEd,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,IAAI,CAAC;oBACH,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBAChC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,2BAA2B,MAAM,CAAC,IAAI,MAAO,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;oBACvG,gEAAgE;oBAChE,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;wBAC9B,IAAI,OAAO,KAAK,MAAM;4BAAE,MAAM;wBAC9B,IAAI,CAAC;4BAAC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;wBAAC,CAAC;wBAAC,QAAQ,aAAa,IAAf,CAAC,CAAC,aAAa,CAAC,CAAC;oBACvD,CAAC;oBACD,OAAO,6BAAY,CAAC,KAAK,CAAC;gBAC5B,CAAC;YACH,CAAC;YAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,yDAAyD,CAAC,CAAC;YAC9F,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnD,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,6BAA6B,OAAO,CAAC,MAAM,eAAe,MAAM,qCAAqC,CAAC,CAAC;YAC1I,CAAC;YAED,OAAO,IAAI,OAAO,CAAwB,CAAC,OAAO,EAAE,EAAE;gBACpD,IAAI,YAAY,GAAG,KAAK,CAAC;gBAEzB,yFAAyF;gBACzF,0FAA0F;gBAC1F,sFAAsF;gBACtF,gFAAgF;gBAChF,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,GAAa,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;gBAE5D,MAAM,gBAAgB,GAAG,CAAO,MAAsB,EAAE,EAAE;oBACxD,IAAI,YAAY,EAAE,CAAC;wBACjB,qFAAqF;wBACrF,iFAAiF;wBACjF,8BAA8B;wBAC9B,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,YAAY,MAAM,wBAAwB,CAAC,CAAC;wBAC7E,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACpB,CAAC;oBACD,YAAY,GAAG,IAAI,CAAC;oBAEpB,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,YAAY,MAAM,+BAA+B,CAAC,CAAC;oBAEjF,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;wBACpC,IAAI,CAAC,cAAc,CAAC,UAAU,CAC5B,qBAAqB,cAAY,CAAC,oBAAoB,oBAAoB,CAC3E,CAAC;wBACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBAClB,CAAC,EAAE,cAAY,CAAC,oBAAoB,CAAC,CAAC;oBACtC,sDAAsD;oBACtD,aAAa,CAAC,KAAK,EAAE,CAAC;oBAEtB,IAAI,CAAC;wBACH,mFAAmF;wBACnF,iFAAiF;wBACjF,6BAA6B;wBAC7B,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;wBACzB,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC;wBACvD,YAAY,CAAC,aAAa,CAAC,CAAC;wBAC5B,aAAa,CAAC,SAAS,CAAC,CAAC;wBACzB,OAAO,CAAC,6BAAY,CAAC,OAAO,CAAC,CAAC;oBAChC,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,mBAAoB,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;wBAC9E,YAAY,CAAC,aAAa,CAAC,CAAC;wBAC5B,aAAa,CAAC,SAAS,CAAC,CAAC;wBACzB,OAAO,CAAC,6BAAY,CAAC,KAAK,CAAC,CAAC;oBAC9B,CAAC;gBACH,CAAC,CAAA,CAAC;gBAEF,wFAAwF;gBACxF,uDAAuD;gBACvD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,KAAK,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnE,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,KAAK,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACnE,CAAC,CAAC,CAAC;QACL,CAAC;KAAA;;AAvGU,oCAAY;AAKvB,2FAA2F;AAC3F,yFAAyF;AACzF,mBAAmB;AACK,iCAAoB,GAAG,KAAM,AAAT,CAAU;uBAR3C,YAAY;IAHxB,IAAA,YAAG,EAAC,iCAAwB,CAAC,OAAO,CAAC;IACrC,IAAA,qBAAY,EAAC,qCAAgB,CAAC;IAC9B,IAAA,qBAAU,GAAE;IAoBR,WAAA,IAAA,oBAAS,EAAC,iCAAwB,CAAC,aAAa,CAAC,CAAA;qCAFjB,gCAAc;QACtB,aAAM;GAlBtB,YAAY,CAwGxB"}