@pristine-ts/cli 2.0.7 → 2.0.16

package/dist/lib/esm/enums/cli-decorator-metadata-keyname.enum.js

@@ -0,0 +1,11 @@
+/**
+ * Metadata keynames written by `@pristine-ts/cli`'s own property/class decorators and read
+ * back when resolving a command's options. Namespaced under `cli:` so they never collide
+ * with the keys other Pristine decorators (validation, data-mapping, mysql, …) store on the
+ * same class.
+ */
+export var CliDecoratorMetadataKeynameEnum;
+(function (CliDecoratorMetadataKeynameEnum) {
+    CliDecoratorMetadataKeynameEnum["CommandParameter"] = "cli:command-parameter";
+})(CliDecoratorMetadataKeynameEnum || (CliDecoratorMetadataKeynameEnum = {}));
+//# sourceMappingURL=cli-decorator-metadata-keyname.enum.js.map

package/dist/lib/esm/enums/cli-decorator-metadata-keyname.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-decorator-metadata-keyname.enum.js","sourceRoot":"","sources":["../../../../src/enums/cli-decorator-metadata-keyname.enum.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAN,IAAY,+BAEX;AAFD,WAAY,+BAA+B;IACzC,6EAA0C,CAAA;AAC5C,CAAC,EAFW,+BAA+B,KAA/B,+BAA+B,QAE1C"}

package/dist/lib/esm/enums/enums.js

@@ -0,0 +1,3 @@
+export * from "./cli-decorator-metadata-keyname.enum";
+export * from "./terminal-key-name.enum";
+//# sourceMappingURL=enums.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../../../src/enums/enums.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAC;AACtD,cAAc,0BAA0B,CAAC"}

package/dist/lib/esm/enums/exit-code.enum.js

@@ -0,0 +1,6 @@
+export var ExitCodeEnum;
+(function (ExitCodeEnum) {
+    ExitCodeEnum[ExitCodeEnum["Success"] = 0] = "Success";
+    ExitCodeEnum[ExitCodeEnum["Error"] = 1] = "Error";
+})(ExitCodeEnum || (ExitCodeEnum = {}));
+//# sourceMappingURL=exit-code.enum.js.map

package/dist/lib/esm/enums/exit-code.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-code.enum.js","sourceRoot":"","sources":["../../../../src/enums/exit-code.enum.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,qDAAW,CAAA;IACX,iDAAS,CAAA;AACX,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB"}

package/dist/lib/esm/enums/terminal-key-name.enum.js

@@ -0,0 +1,18 @@
+/**
+ * The kinds of keypress the CLI's interactive prompts understand. `TerminalKeyDecoder`
+ * maps the raw bytes Node delivers from a raw-mode stdin onto one of these; every printable
+ * keystroke collapses to `Character` (with the literal character carried separately on
+ * {@link TerminalKey}). `Other` covers control/escape sequences the prompts don't act on
+ * (function keys, unhandled arrows) so callers can ignore them instead of echoing garbage.
+ */
+export var TerminalKeyName;
+(function (TerminalKeyName) {
+    TerminalKeyName["Up"] = "up";
+    TerminalKeyName["Down"] = "down";
+    TerminalKeyName["Enter"] = "enter";
+    TerminalKeyName["Backspace"] = "backspace";
+    TerminalKeyName["CtrlC"] = "ctrl-c";
+    TerminalKeyName["Character"] = "character";
+    TerminalKeyName["Other"] = "other";
+})(TerminalKeyName || (TerminalKeyName = {}));
+//# sourceMappingURL=terminal-key-name.enum.js.map

package/dist/lib/esm/enums/terminal-key-name.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-key-name.enum.js","sourceRoot":"","sources":["../../../../src/enums/terminal-key-name.enum.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,eAQX;AARD,WAAY,eAAe;IACzB,4BAAS,CAAA;IACT,gCAAa,CAAA;IACb,kCAAe,CAAA;IACf,0CAAuB,CAAA;IACvB,mCAAgB,CAAA;IAChB,0CAAuB,CAAA;IACvB,kCAAe,CAAA;AACjB,CAAC,EARW,eAAe,KAAf,eAAe,QAQ1B"}

package/dist/lib/esm/errors/cli-error-code.enum.js

@@ -3,12 +3,22 @@
  * (typed `PristineErrorCode | string`, so any enum value is accepted).
  *
  * Codes here describe CLI-specific failures — command resolution, argument mapping,
- * and argument validation.
+ * argument validation, and command-parameter binding.
  */
 export var CliErrorCode;
 (function (CliErrorCode) {
     CliErrorCode["CommandNotFound"] = "COMMAND_NOT_FOUND";
     CliErrorCode["ArgumentMappingFailed"] = "ARGUMENT_MAPPING_FAILED";
     CliErrorCode["ArgumentValidationFailed"] = "ARGUMENT_VALIDATION_FAILED";
+    /**
+     * Two `@commandParameter` properties on the same options class resolve to the same flag.
+     * A programming error in the command's options definition, not bad user input.
+     */
+    CliErrorCode["CommandParameterFlagConflict"] = "COMMAND_PARAMETER_FLAG_CONFLICT";
+    /**
+     * The user cancelled an interactive prompt with `Ctrl+C`. Carried by
+     * `PromptCancelledError` — a clean, user-initiated cancellation, not a failure.
+     */
+    CliErrorCode["PromptCancelled"] = "PROMPT_CANCELLED";
 })(CliErrorCode || (CliErrorCode = {}));
 //# sourceMappingURL=cli-error-code.enum.js.map

package/dist/lib/esm/errors/cli-error-code.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-error-code.enum.js","sourceRoot":"","sources":["../../../../src/errors/cli-error-code.enum.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,qDAA8C,CAAA;IAC9C,iEAAoD,CAAA;IACpD,uEAAuD,CAAA;AACzD,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB"}
+{"version":3,"file":"cli-error-code.enum.js","sourceRoot":"","sources":["../../../../src/errors/cli-error-code.enum.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,YAgBX;AAhBD,WAAY,YAAY;IACtB,qDAA8C,CAAA;IAC9C,iEAAoD,CAAA;IACpD,uEAAuD,CAAA;IAEvD;;;OAGG;IACH,gFAAgE,CAAA;IAEhE;;;OAGG;IACH,oDAAoC,CAAA;AACtC,CAAC,EAhBW,YAAY,KAAZ,YAAY,QAgBvB"}

package/dist/lib/esm/errors/errors.js

@@ -1,3 +1,4 @@
 export * from "./cli-error-code.enum";
 export * from "./command-not-found.error";
+export * from "./prompt-cancelled.error";
 //# sourceMappingURL=errors.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/errors/errors.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/errors/errors.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC"}

package/dist/lib/esm/errors/prompt-cancelled.error.js

@@ -0,0 +1,21 @@
+import { PristineError, PristineErrorKind } from "@pristine-ts/common";
+import { CliErrorCode } from "./cli-error-code.enum";
+/**
+ * Thrown when the user cancels an interactive prompt with `Ctrl+C`. A clean, user-initiated
+ * cancellation — not a crash — so it carries `kind: UserError` (the `CliErrorReporter`
+ * renders the message verbatim instead of a stack dump) and exit code `130`, following the
+ * POSIX `128 + SIGINT(2)` convention so shell pipelines can detect the interrupt.
+ *
+ * Callers that treat cancellation as a normal branch (e.g. `BuildStalenessPrompt`) catch it
+ * via `instanceof`; everywhere else it propagates to the reporter for a tidy exit.
+ */
+export class PromptCancelledError extends PristineError {
+    constructor() {
+        super("Prompt cancelled.", {
+            code: CliErrorCode.PromptCancelled,
+            exitCode: 130,
+            kind: PristineErrorKind.UserError,
+        });
+    }
+}
+//# sourceMappingURL=prompt-cancelled.error.js.map

package/dist/lib/esm/errors/prompt-cancelled.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-cancelled.error.js","sourceRoot":"","sources":["../../../../src/errors/prompt-cancelled.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAE,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAC,YAAY,EAAC,MAAM,uBAAuB,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,OAAO,oBAAqB,SAAQ,aAAa;IACrD;QACE,KAAK,CAAC,mBAAmB,EAAE;YACzB,IAAI,EAAE,YAAY,CAAC,eAAe;YAClC,QAAQ,EAAE,GAAG;YACb,IAAI,EAAE,iBAAiB,CAAC,SAAS;SAClC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/lib/esm/event-handlers/cli.event-handler.js

@@ -21,18 +21,27 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { inject, injectable, injectAll } from "tsyringe";
 import { CommandEventPayload } from "../event-payloads/command.event-payload";
-import { moduleScoped, ServiceDefinitionTagEnum, tag, UsageError, ValidationError, ExitCode } from "@pristine-ts/common";
-import { CliErrorCode } from "../errors/cli-error-code.enum";
+import { CommandEventResponse } from "../types/command-event-response.type";
+import { moduleScoped, ServiceDefinitionTagEnum, tag, ExitCode } from "@pristine-ts/common";
 import { CommandNotFoundError } from "../errors/command-not-found.error";
-import { Validator } from "@pristine-ts/class-validator";
 import { CliModuleKeyname } from "../cli.module.keyname";
-import { plainToInstance } from "class-transformer";
+import { CommandArgumentResolver } from "../services/command-argument-resolver";
 let CliEventHandler = class CliEventHandler {
-    constructor(logHandler, validator, commands) {
+    constructor(logHandler, commandArgumentResolver, commands) {
         this.logHandler = logHandler;
-        this.validator = validator;
+        this.commandArgumentResolver = commandArgumentResolver;
         this.commands = commands;
     }
+    /**
+     * Resolves and runs the command, then **returns** its exit code wrapped in a
+     * `CommandEventResponse` — it does not call `process.exit`.
+     *
+     * Process lifecycle is the bin's job: `kernel.handle` resolves with this exit code,
+     * `Cli.bootstrap` returns it, and `bin.ts` does the actual `process.exit`. Returning
+     * (rather than exiting) is also what lets the interactive REPL dispatch commands
+     * through this very handler — `kernel.handle(argv, {keyname: Cli})` per typed line —
+     * without the process dying after the first command.
+     */
     handle(event) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a;
@@ -40,76 +49,23 @@ let CliEventHandler = class CliEventHandler {
             if (command === undefined) {
                 // Throws a UsageError (exit 64, `EX_USAGE`). The bin's `.catch` will route it
                 // through `CliErrorReporter.report` which prints a clean one-line stderr and
-                // exits with the right code — no `process.exit` in this method any longer.
+                // exits with the right code.
                 throw new CommandNotFoundError(event.payload.name);
             }
             const args = yield this.resolveArgs(command, (_a = event.payload.arguments) !== null && _a !== void 0 ? _a : {});
             const exitCode = yield command.run(args);
             this.logExitStatus(event.payload.name, exitCode);
-            process.exit(exitCode);
+            return new CommandEventResponse(event, exitCode);
         });
     }
     /**
-     * Maps `rawArgs` (the parsed argv shape produced by `CommandEventMapper`) into a typed
-     * instance of `command.optionsType`, then runs `class-validator` against the instance.
-     *
-     * For commands that opt out of typed options (`optionsType === null`), passes the raw
-     * args through unchanged — the legacy escape hatch for commands that want to handle
-     * argv parsing themselves.
-     *
-     * Throws `UsageError` for mapping failures and `ValidationError` for class-validator
-     * failures. Both carry structured `details` so `CliErrorReporter` can render them as
-     * readable stderr lines without this method touching the console directly.
+     * Maps + validates a command's raw arguments. Delegates to the shared
+     * `CommandArgumentResolver`. Since the REPL dispatches through this same handler, the
+     * one-shot CLI and the REPL resolve arguments through identical logic.
      */
     resolveArgs(command, rawArgs) {
         return __awaiter(this, void 0, void 0, function* () {
-            if (command.optionsType === null) {
-                return rawArgs;
-            }
-            let mapped;
-            try {
-                // class-transformer's plainToInstance is what produces a real instance of the
-                // options class (with the prototype, decorator metadata, and class-validator hooks
-                // intact). DataMapper.autoMap would return a plain object instead, which causes
-                // class-validator to silently report no errors because it can't find decorator
-                // metadata on a non-instance — exactly the bug this rewrite fixes.
-                mapped = plainToInstance(command.optionsType, rawArgs);
-            }
-            catch (cause) {
-                throw new UsageError(`Failed to map CLI arguments to '${command.optionsType.name}': ${cause.message}`, {
-                    code: CliErrorCode.ArgumentMappingFailed,
-                    cause: cause,
-                    details: { targetType: command.optionsType.name },
-                });
-            }
-            const validationErrors = yield this.validator.validate(mapped);
-            if (validationErrors.length === 0) {
-                return mapped;
-            }
-            // Reshape the class-validator output into structured `details` the reporter can
-            // render line-by-line. Keeps the throw single-pass and the reporter format-agnostic.
-            const failures = {};
-            for (const error of validationErrors) {
-                const messages = [];
-                for (const constraintKey in error.constraints) {
-                    // `@pristine-ts/class-validator` stores constraints as `{keyname, message}` objects
-                    // rather than the plain strings vanilla class-validator uses. Extract the message
-                    // when present, falling back to JSON for unknown shapes so we never print
-                    // `[object Object]`.
-                    const constraint = error.constraints[constraintKey];
-                    const message = typeof constraint === "string"
-                        ? constraint
-                        : (constraint && typeof constraint === "object" && typeof constraint.message === "string")
-                            ? constraint.message
-                            : JSON.stringify(constraint);
-                    messages.push(`[${constraintKey}] ${message}`);
-                }
-                failures[error.property] = messages;
-            }
-            throw new ValidationError("Argument validation failed", {
-                code: CliErrorCode.ArgumentValidationFailed,
-                details: failures,
-            });
+            return this.commandArgumentResolver.resolve(command, rawArgs);
         });
     }
     supports(event) {
@@ -131,7 +87,7 @@ CliEventHandler = __decorate([
     injectable(),
     __param(0, inject("LogHandlerInterface")),
     __param(2, injectAll(ServiceDefinitionTagEnum.Command)),
-    __metadata("design:paramtypes", [Object, Validator, Array])
+    __metadata("design:paramtypes", [Object, CommandArgumentResolver, Array])
 ], CliEventHandler);
 export { CliEventHandler };
 //# sourceMappingURL=cli.event-handler.js.map

package/dist/lib/esm/event-handlers/cli.event-handler.js.map

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

package/dist/lib/esm/event-handlers/event-handlers.js

@@ -1,2 +1,3 @@
 export * from "./cli.event-handler";
+export * from "./repl-start.event-handler";
 //# sourceMappingURL=event-handlers.js.map

package/dist/lib/esm/event-handlers/event-handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-handlers.js","sourceRoot":"","sources":["../../../../src/event-handlers/event-handlers.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"event-handlers.js","sourceRoot":"","sources":["../../../../src/event-handlers/event-handlers.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC"}

package/dist/lib/esm/event-handlers/repl-start.event-handler.js

@@ -0,0 +1,244 @@
+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 ReplStartEventHandler_1;
+import * as readline from "node:readline";
+import { inject, injectable } from "tsyringe";
+import { ExecutionContextKeynameEnum, Kernel } from "@pristine-ts/core";
+import { ExitCode, moduleScoped, ServiceDefinitionTagEnum, tag } from "@pristine-ts/common";
+import { TraceStore } from "@pristine-ts/observability";
+import { CliOutput } from "../managers/cli-output.manager";
+import { CliModuleKeyname } from "../cli.module.keyname";
+import { StartReplEventPayload } from "../event-payloads/start-repl.event-payload";
+import { StartReplEventResponse } from "../types/start-repl-event-response.type";
+/**
+ * The interactive `pristine` console, modelled as a long-running event handler. Launched
+ * when the bin is invoked with no command (or `pristine repl`) — `ReplStartEventMapper`
+ * produces a `StartReplEventPayload` and this handler runs the readline loop for the rest
+ * of the process lifetime.
+ *
+ * **Why an event handler.** The REPL is the same shape as `pristine start` (or any
+ * long-running command): an EventHandler whose `handle()` doesn't return until the
+ * session ends. This gives the CLI bootstrap a uniform shape — `cli.ts` just calls
+ * `kernel.handle(argv, {keyname: Cli})` regardless of whether the user invoked a one-shot
+ * command or wants the interactive console. There is no driver/handler asymmetry left in
+ * the bootstrap; the mapping layer routes argv to the right payload.
+ *
+ * **Per-line dispatch.** Each typed line is re-entered through `kernel.handle(...,
+ * {keyname: Cli})` — using `Kernel` (the proper re-entry seam — it owns trace lifecycle,
+ * child container creation, the works). The `Kernel` is `registerInstance`-d into its
+ * own container by `Cli.bootstrap()`, so this handler injects it via DI like any other
+ * service.
+ *
+ * Plus the session verbs `/help`, `/clear`, `/exit` handled in-process (they're not
+ * commands — they don't re-enter the kernel). Tab-completion is driven by the live
+ * command registry and by recent trace ids for `/trace` / `/logs`.
+ */
+let ReplStartEventHandler = ReplStartEventHandler_1 = class ReplStartEventHandler {
+    constructor(kernel, container, cliOutput, traceStore) {
+        this.kernel = kernel;
+        this.container = container;
+        this.cliOutput = cliOutput;
+        this.traceStore = traceStore;
+        this.commands = [];
+    }
+    supports(event) {
+        return event.payload instanceof StartReplEventPayload;
+    }
+    /**
+     * Runs the read-eval-print loop until `/exit` or EOF (Ctrl-D). Resolves with the exit
+     * code wrapped in a `StartReplEventResponse`; the mapper surfaces that to `Cli.bootstrap`.
+     */
+    handle(event) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.commands = this.resolveCommands();
+            this.printBanner();
+            const rl = readline.createInterface({
+                input: process.stdin,
+                output: process.stdout,
+                prompt: ReplStartEventHandler_1.PROMPT,
+                completer: (line) => this.complete(line),
+            });
+            const exitCode = yield new Promise((resolve) => {
+                rl.prompt();
+                rl.on("line", (line) => {
+                    const trimmed = line.trim();
+                    if (trimmed.length === 0) {
+                        rl.prompt();
+                        return;
+                    }
+                    // Pause input while a command runs so its own SIGINT handling (e.g. `logs -f`)
+                    // owns Ctrl-C, and so a second line can't interleave mid-dispatch.
+                    rl.pause();
+                    void this.handleLine(trimmed).then((shouldExit) => {
+                        if (shouldExit) {
+                            rl.close();
+                            return;
+                        }
+                        rl.resume();
+                        rl.prompt();
+                    });
+                });
+                // Ctrl-C at an idle prompt clears the line rather than killing the session.
+                rl.on("SIGINT", () => {
+                    this.cliOutput.writeLine("(type /exit to quit)");
+                    rl.prompt();
+                });
+                rl.on("close", () => {
+                    void this.shutdown().then(() => resolve(ExitCode.Success));
+                });
+            });
+            return new StartReplEventResponse(event, exitCode);
+        });
+    }
+    /**
+     * Handles one input line. Returns true when the session should end.
+     */
+    handleLine(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const withoutSlash = input.startsWith("/") ? input.slice(1) : input;
+            const tokens = withoutSlash.split(/\s+/).filter(token => token.length > 0);
+            const name = tokens[0];
+            const rest = tokens.slice(1);
+            if (name === "exit" || name === "quit") {
+                return true;
+            }
+            if (name === "clear") {
+                console.clear();
+                return false;
+            }
+            if (name === "help") {
+                this.printHelp();
+                return false;
+            }
+            try {
+                // Re-enter the kernel with a synthetic argv under the `Cli` keyname — parsing and
+                // dispatch are identical to a one-shot invocation. The `"pristine"` token is the
+                // bin marker `PristineArgv` scans for; everything after it is treated as user
+                // args. `CliEventHandler` returns the exit code instead of calling `process.exit`,
+                // so the loop survives. An unknown command throws `CommandNotFoundError`, caught
+                // below.
+                yield this.kernel.handle(["node", "pristine", name, ...rest], { keyname: ExecutionContextKeynameEnum.Cli, context: null });
+            }
+            catch (error) {
+                try {
+                    // Stringification + writeLine are wrapped together — `error.message`/`String(error)`
+                    // can throw on pathological inputs, and a throw here would kill the REPL session.
+                    this.cliOutput.writeLine(`Error: ${error instanceof Error ? error.message : String(error)}`);
+                }
+                catch (_a) {
+                    // Drop the error rather than crashing the session.
+                }
+            }
+            return false;
+        });
+    }
+    /**
+     * Readline completer. Completes `/`-prefixed command names and session verbs; for
+     * `/trace` and `/logs` it completes the trailing token with recent trace ids.
+     */
+    complete(line) {
+        const traceIdMatch = /^\/(trace|logs)\s+(\S*)$/.exec(line);
+        if (traceIdMatch !== null) {
+            const partial = traceIdMatch[2];
+            const hits = this.traceStore.recentTraceIds(ReplStartEventHandler_1.TRACE_ID_COMPLETION_LIMIT)
+                .filter(id => id.startsWith(partial));
+            return [hits, partial];
+        }
+        const candidates = [
+            ...this.commands.map(command => `/${command.name}`),
+            ...ReplStartEventHandler_1.SESSION_VERBS,
+        ];
+        const hits = candidates.filter(candidate => candidate.startsWith(line));
+        return [hits.length > 0 ? hits : candidates, line];
+    }
+    printBanner() {
+        this.cliOutput.writeLine("Pristine — interactive console");
+        this.cliOutput.writeLine("Type /help for commands, /exit to quit.");
+        this.cliOutput.writeLine("");
+    }
+    printHelp() {
+        var _a;
+        this.cliOutput.writeLine("Session:");
+        this.cliOutput.writeLine("  /help            show this message");
+        this.cliOutput.writeLine("  /clear           clear the screen");
+        this.cliOutput.writeLine("  /exit            leave the console");
+        this.cliOutput.writeLine("");
+        this.cliOutput.writeLine("Commands (also runnable as `pristine <name>`):");
+        const sorted = [...this.commands].sort((a, b) => a.name.localeCompare(b.name));
+        const longest = sorted.reduce((max, command) => Math.max(max, command.name.length), 0);
+        for (const command of sorted) {
+            const padded = `/${command.name}`.padEnd(longest + 3, " ");
+            this.cliOutput.writeLine(`  ${padded}${(_a = command.description) !== null && _a !== void 0 ? _a : ""}`);
+        }
+    }
+    shutdown() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield this.kernel.stop();
+            }
+            catch (_a) {
+                // Best-effort — we're leaving the process anyway.
+            }
+        });
+    }
+    /**
+     * Enumerates every registered command. Resolved from the per-event child container the
+     * kernel handed this handler when it dispatched the REPL-start event — same container
+     * `HelpCommand`/`ListCommand` themselves use, so commands that depend on
+     * `CurrentChildContainer` resolve cleanly.
+     *
+     * `resolveAll`, justified: framework REPL infrastructure at session start — enumerating
+     * every `Command`-tagged service is a container-introspection operation with no
+     * constructor seam.
+     */
+    resolveCommands() {
+        try {
+            return this.container.resolveAll(ServiceDefinitionTagEnum.Command);
+        }
+        catch (error) {
+            try {
+                // Stringification + stderr.write are wrapped together — `error.message`/`String(error)`
+                // can throw on pathological inputs, and a throw here would bubble out and kill REPL
+                // startup.
+                process.stderr.write(`[repl] could not load commands: ${error instanceof Error ? error.message : String(error)}\n`);
+            }
+            catch (_a) {
+                // Drop the report rather than crashing startup; the empty completer is still usable.
+            }
+            return [];
+        }
+    }
+};
+ReplStartEventHandler.PROMPT = "pristine ❯ ";
+ReplStartEventHandler.SESSION_VERBS = ["/help", "/clear", "/exit"];
+ReplStartEventHandler.TRACE_ID_COMPLETION_LIMIT = 25;
+ReplStartEventHandler = ReplStartEventHandler_1 = __decorate([
+    tag(ServiceDefinitionTagEnum.EventHandler),
+    moduleScoped(CliModuleKeyname),
+    injectable(),
+    __param(0, inject(Kernel)),
+    __param(1, inject(ServiceDefinitionTagEnum.CurrentChildContainer)),
+    __metadata("design:paramtypes", [Kernel, Object, CliOutput,
+        TraceStore])
+], ReplStartEventHandler);
+export { ReplStartEventHandler };
+//# sourceMappingURL=repl-start.event-handler.js.map

package/dist/lib/esm/event-handlers/repl-start.event-handler.js.map

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

package/dist/lib/esm/event-payloads/event-payloads.js

@@ -1,2 +1,3 @@
 export * from "./command.event-payload";
+export * from "./start-repl.event-payload";
 //# sourceMappingURL=event-payloads.js.map

package/dist/lib/esm/event-payloads/event-payloads.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-payloads.js","sourceRoot":"","sources":["../../../../src/event-payloads/event-payloads.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"event-payloads.js","sourceRoot":"","sources":["../../../../src/event-payloads/event-payloads.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC"}

package/dist/lib/esm/event-payloads/start-repl.event-payload.js

@@ -0,0 +1,15 @@
+/**
+ * Payload that signals "launch the interactive REPL." Produced by `ReplStartEventMapper`
+ * for argv shapes with no command (`pristine`) or with the explicit `repl` command
+ * (`pristine repl`). Consumed by `ReplStartEventHandler` which runs the readline loop
+ * for the rest of the process lifetime.
+ *
+ * The payload carries the `scriptPath` (argv[1]) for parity with `CommandEventPayload`
+ * and for diagnostics; the REPL itself reads its input from stdin, not from the payload.
+ */
+export class StartReplEventPayload {
+    constructor(scriptPath) {
+        this.scriptPath = scriptPath;
+    }
+}
+//# sourceMappingURL=start-repl.event-payload.js.map

package/dist/lib/esm/event-payloads/start-repl.event-payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-repl.event-payload.js","sourceRoot":"","sources":["../../../../src/event-payloads/start-repl.event-payload.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,OAAO,qBAAqB;IAChC,YAAmB,UAAkB;QAAlB,eAAU,GAAV,UAAU,CAAQ;IACrC,CAAC;CACF"}

package/dist/lib/esm/interfaces/interfaces.js

@@ -1,2 +1,3 @@
 export * from "./command.interface";
+export * from "./terminal-key.interface";
 //# sourceMappingURL=interfaces.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../src/interfaces/interfaces.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../src/interfaces/interfaces.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC"}

package/dist/lib/esm/interfaces/terminal-key.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=terminal-key.interface.js.map

package/dist/lib/esm/interfaces/terminal-key.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-key.interface.js","sourceRoot":"","sources":["../../../../src/interfaces/terminal-key.interface.ts"],"names":[],"mappings":""}