@pristine-ts/cli 2.0.7 → 2.0.16

package/dist/lib/cjs/managers/repl-session.js

@@ -0,0 +1,251 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+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 __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+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 ReplSession_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReplSession = void 0;
+const readline = __importStar(require("node:readline"));
+const tsyringe_1 = require("tsyringe");
+const common_1 = require("@pristine-ts/common");
+const core_1 = require("@pristine-ts/core");
+const observability_1 = require("@pristine-ts/observability");
+const cli_output_manager_1 = require("./cli-output.manager");
+const cli_module_keyname_1 = require("../cli.module.keyname");
+/**
+ * The interactive `pristine` console — launched when the bin is invoked with no command
+ * (or `pristine repl`). It keeps the kernel booted for the whole session, so every
+ * command runs instantly with no per-invocation boot cost.
+ *
+ * Slash-prefixed commands dispatch through the *same* path as a one-shot
+ * `pristine <command>` invocation — `kernel.handle(argv, {keyname: Cli})` — so the REPL
+ * and the command line resolve, validate and run commands identically. (This works
+ * because `CliEventHandler` returns the exit code instead of calling `process.exit`.)
+ * Plus the session verbs `/help`, `/clear`, `/exit`. Tab-completion is driven by the live
+ * command registry and by recent trace ids for `/trace` / `/logs`.
+ *
+ * The kernel is **not** a constructor dependency — `ReplSession` is a driver *of* the
+ * kernel, so the running kernel is handed to `start()` by whoever owns it (`Cli`). Only
+ * genuine collaborator services are injected.
+ */
+let ReplSession = ReplSession_1 = class ReplSession {
+    constructor(cliOutput, storeReader) {
+        this.cliOutput = cliOutput;
+        this.storeReader = storeReader;
+        this.commands = [];
+    }
+    /**
+     * Runs the read-eval-print loop until `/exit` or EOF (Ctrl-D). Resolves with the exit
+     * code the bin should return.
+     *
+     * @param kernel The already-started kernel this session drives — passed in by the
+     *   caller that owns it, rather than injected.
+     */
+    start(kernel) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.commands = this.resolveCommands(kernel);
+            this.printBanner();
+            const rl = readline.createInterface({
+                input: process.stdin,
+                output: process.stdout,
+                prompt: ReplSession_1.PROMPT,
+                completer: (line) => this.complete(line),
+            });
+            return 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, kernel).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(kernel).then(() => resolve(common_1.ExitCode.Success));
+                });
+            });
+        });
+    }
+    /**
+     * Handles one input line. Returns true when the session should end.
+     */
+    handleLine(input, kernel) {
+        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 {
+                // Dispatch through the exact same path as a one-shot `pristine <command>`: a
+                // synthetic argv handed to `kernel.handle` with the `Cli` execution context. The
+                // kernel maps it, `CliEventHandler` resolves + validates + runs it and returns the
+                // exit code (no `process.exit`), so the loop survives. An unknown command throws
+                // `CommandNotFoundError`, caught below.
+                yield kernel.handle(["node", "repl", name, ...rest], { keyname: core_1.ExecutionContextKeynameEnum.Cli, context: null });
+            }
+            catch (error) {
+                this.cliOutput.writeLine(`Error: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            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.storeReader.recentTraceIds(ReplSession_1.TRACE_ID_COMPLETION_LIMIT)
+                .filter(id => id.startsWith(partial));
+            return [hits, partial];
+        }
+        const candidates = [
+            ...this.commands.map(command => `/${command.name}`),
+            ...ReplSession_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(kernel) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield kernel.stop();
+            }
+            catch (_a) {
+                // Best-effort — we're leaving the process anyway.
+            }
+        });
+    }
+    /**
+     * Enumerates every registered command.
+     *
+     * Resolved from a dedicated child container with the `CurrentChildContainer` token
+     * registered — some commands (`HelpCommand`, `ListCommand`) inject that token, which
+     * only the kernel's per-event child containers carry. The one-shot path gets it for
+     * free because `CliEventHandler` runs inside such a child container; the REPL builds an
+     * equivalent one once for the whole session.
+     *
+     * `resolveAll`, justified: this is framework REPL infrastructure resolved at session
+     * start, mirroring `Cli.warnOnCommandCollisions`. Enumerating every `Command`-tagged
+     * service is inherently a container-introspection operation with no constructor seam.
+     */
+    resolveCommands(kernel) {
+        try {
+            const childContainer = kernel.container.createChildContainer();
+            childContainer.registerInstance(common_1.ServiceDefinitionTagEnum.CurrentChildContainer, childContainer);
+            return childContainer.resolveAll(common_1.ServiceDefinitionTagEnum.Command);
+        }
+        catch (error) {
+            process.stderr.write(`[repl] could not load commands: ${error instanceof Error ? error.message : String(error)}\n`);
+            return [];
+        }
+    }
+};
+exports.ReplSession = ReplSession;
+ReplSession.PROMPT = "pristine ❯ ";
+ReplSession.SESSION_VERBS = ["/help", "/clear", "/exit"];
+ReplSession.TRACE_ID_COMPLETION_LIMIT = 25;
+exports.ReplSession = ReplSession = ReplSession_1 = __decorate([
+    (0, tsyringe_1.injectable)(),
+    (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname),
+    __metadata("design:paramtypes", [cli_output_manager_1.CliOutput,
+        observability_1.ObservabilityStoreReader])
+], ReplSession);
+//# sourceMappingURL=repl-session.js.map

package/dist/lib/cjs/managers/repl-session.js.map

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

package/dist/lib/cjs/managers/terminal-key-reader.manager.js

@@ -0,0 +1,99 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerminalKeyReader = void 0;
+const tsyringe_1 = require("tsyringe");
+const common_1 = require("@pristine-ts/common");
+const cli_module_keyname_1 = require("../cli.module.keyname");
+const terminal_key_name_enum_1 = require("../enums/terminal-key-name.enum");
+const terminal_key_decoder_1 = require("../utils/terminal-key-decoder");
+const prompt_cancelled_error_1 = require("../errors/prompt-cancelled.error");
+/**
+ * Owns the raw-mode keystroke reading the interactive prompts need (arrow-key `select`,
+ * masked `readSecret`) — the one place in the CLI that flips stdin into raw mode. Node's
+ * stock `readline` is line-buffered and echoes input, so it can't drive an arrow-key menu
+ * or suppress a password's characters; this reads keys one at a time instead.
+ *
+ * Two responsibilities are handled centrally so callers don't each reimplement them:
+ *   - **Cancellation:** `Ctrl+C` rejects the read with {@link PromptCancelledError}.
+ *   - **Terminal restore:** raw mode is entered on start and restored in every exit path,
+ *     so a thrown handler or a cancellation never leaves the terminal in raw mode.
+ *
+ * The `input`/`output` fields default to the process streams and exist as a seam so tests
+ * can drive synthetic keystrokes without a real TTY.
+ */
+let TerminalKeyReader = class TerminalKeyReader {
+    constructor() {
+        this.input = process.stdin;
+        this.output = process.stdout;
+    }
+    /**
+     * Whether both stdin and stdout are interactive terminals. Raw-mode reading is only
+     * meaningful on a real TTY; callers fall back (or skip prompting) when this is false.
+     */
+    isInteractive() {
+        return Boolean(this.input.isTTY) && Boolean(this.output.isTTY);
+    }
+    /**
+     * Reads keystrokes in raw mode, handing each decoded {@link TerminalKey} to `onKey` until
+     * `onKey` ends the read by invoking its `resolve` callback with the result. Resolves to
+     * that value; rejects with {@link PromptCancelledError} on `Ctrl+C`. Raw mode is entered
+     * on start and restored to its prior state in every exit path.
+     */
+    read(onKey) {
+        const input = this.input;
+        const wasRaw = input.isRaw === true;
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const cleanup = () => {
+                input.removeListener("data", onData);
+                if (input.isTTY && typeof input.setRawMode === "function") {
+                    input.setRawMode(wasRaw);
+                }
+                input.pause();
+            };
+            const settle = (run) => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                cleanup();
+                run();
+            };
+            const onData = (data) => {
+                for (const key of terminal_key_decoder_1.TerminalKeyDecoder.decode(data.toString())) {
+                    if (key.name === terminal_key_name_enum_1.TerminalKeyName.CtrlC) {
+                        settle(() => reject(new prompt_cancelled_error_1.PromptCancelledError()));
+                        return;
+                    }
+                    try {
+                        onKey(key, (value) => settle(() => resolve(value)));
+                    }
+                    catch (error) {
+                        settle(() => reject(error));
+                        return;
+                    }
+                    if (settled) {
+                        return;
+                    }
+                }
+            };
+            if (input.isTTY && typeof input.setRawMode === "function") {
+                input.setRawMode(true);
+            }
+            input.resume();
+            input.on("data", onData);
+        });
+    }
+};
+exports.TerminalKeyReader = TerminalKeyReader;
+exports.TerminalKeyReader = TerminalKeyReader = __decorate([
+    (0, tsyringe_1.injectable)(),
+    (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname)
+], TerminalKeyReader);
+//# sourceMappingURL=terminal-key-reader.manager.js.map

package/dist/lib/cjs/managers/terminal-key-reader.manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-key-reader.manager.js","sourceRoot":"","sources":["../../../../src/managers/terminal-key-reader.manager.ts"],"names":[],"mappings":";;;;;;;;;AAAA,uCAAoC;AACpC,gDAAiD;AACjD,8DAAuD;AAEvD,4EAAgE;AAChE,wEAAiE;AACjE,6EAAsE;AAEtE;;;;;;;;;;;;;GAaG;AAGI,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAAvB;QACL,UAAK,GAAsB,OAAO,CAAC,KAAK,CAAC;QACzC,WAAM,GAAuB,OAAO,CAAC,MAAM,CAAC;IAmE9C,CAAC;IAjEC;;;OAGG;IACH,aAAa;QACX,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAI,KAA8D;QACpE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC;QAEpC,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,IAAI,OAAO,GAAG,KAAK,CAAC;YAEpB,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACrC,IAAI,KAAK,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;oBAC1D,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;gBAC3B,CAAC;gBACD,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,CAAC,CAAC;YAEF,MAAM,MAAM,GAAG,CAAC,GAAe,EAAE,EAAE;gBACjC,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO;gBACT,CAAC;gBACD,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,GAAG,EAAE,CAAC;YACR,CAAC,CAAC;YAEF,MAAM,MAAM,GAAG,CAAC,IAAqB,EAAE,EAAE;gBACvC,KAAK,MAAM,GAAG,IAAI,yCAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC;oBAC7D,IAAI,GAAG,CAAC,IAAI,KAAK,wCAAe,CAAC,KAAK,EAAE,CAAC;wBACvC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,6CAAoB,EAAE,CAAC,CAAC,CAAC;wBACjD,OAAO;oBACT,CAAC;oBAED,IAAI,CAAC;wBACH,KAAK,CAAC,GAAG,EAAE,CAAC,KAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACzD,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAc,CAAC,CAAC,CAAC;wBACrC,OAAO;oBACT,CAAC;oBAED,IAAI,OAAO,EAAE,CAAC;wBACZ,OAAO;oBACT,CAAC;gBACH,CAAC;YACH,CAAC,CAAC;YAEF,IAAI,KAAK,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBAC1D,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;YACD,KAAK,CAAC,MAAM,EAAE,CAAC;YACf,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AArEY,8CAAiB;4BAAjB,iBAAiB;IAF7B,IAAA,qBAAU,GAAE;IACZ,IAAA,qBAAY,EAAC,qCAAgB,CAAC;GAClB,iBAAiB,CAqE7B"}

package/dist/lib/cjs/mappers/command-event.mapper.js

@@ -5,6 +5,9 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     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.CommandEventMapper = void 0;
 const core_1 = require("@pristine-ts/core");
@@ -12,10 +15,30 @@ const tsyringe_1 = require("tsyringe");
 const command_event_payload_1 = require("../event-payloads/command.event-payload");
 const common_1 = require("@pristine-ts/common");
 const cli_module_keyname_1 = require("../cli.module.keyname");
-const uuid_1 = require("uuid");
+const pristine_argv_1 = require("../utils/pristine-argv");
 let CommandEventMapper = class CommandEventMapper {
+    constructor(eventIdManager) {
+        this.eventIdManager = eventIdManager;
+    }
+    /**
+     * Matches argv that names an explicit command. The no-command shape and the bare
+     * `pristine repl` form are deliberately rejected here; `ReplStartEventMapper` claims
+     * those. Commands typed inside the interactive session are also re-dispatched under
+     * `Cli`, so this mapper handles them too. Argv parsing is delegated to `PristineArgv`,
+     * which scans for the bin token rather than relying on positional indexing.
+     */
     supportsMapping(rawEvent, executionContext) {
-        return executionContext.keyname === core_1.ExecutionContextKeynameEnum.Cli;
+        if (executionContext.keyname !== core_1.ExecutionContextKeynameEnum.Cli) {
+            return false;
+        }
+        if (Array.isArray(rawEvent) === false) {
+            return false;
+        }
+        const argv = new pristine_argv_1.PristineArgv(rawEvent);
+        if (argv.isValid === false) {
+            return false;
+        }
+        return argv.userArgs.length >= 1 && argv.userArgs[0] !== "repl";
     }
     /**
      * Inspired from: https://github.com/eveningkid/args-parser
@@ -23,21 +46,31 @@ let CommandEventMapper = class CommandEventMapper {
      * @param executionContext
      */
     map(rawEvent, executionContext) {
+        // `supportsMapping` already filters out the unsupported shapes — these guards stay only
+        // as a defence in case the pipeline ever invokes `map` without consulting `supportsMapping`.
         if (Array.isArray(rawEvent) === false) {
             throw new Error("If using the 'CLI', process.argv should be passed as the event.");
         }
-        if (rawEvent.length < 3) {
+        const argv = new pristine_argv_1.PristineArgv(rawEvent);
+        if (argv.isValid === false || argv.userArgs.length === 0) {
             throw new Error("If using the 'CLI', there must be at least one command passed");
         }
-        const command = new command_event_payload_1.CommandEventPayload(rawEvent[2], rawEvent[1]);
+        const command = new command_event_payload_1.CommandEventPayload(argv.userArgs[0], argv.scriptPath);
         // if argument starts with - or --, then there is two options. Either there's an equal sign in the string and after the equal sign is the value or the next argument is actually the value
         // for the value, we need to check if it can be a boolean and if not, if it can be a number. If yes, they should be transformed. Else, the value should be a string.
         // If the argument doesn't start with --, then it's value is simply the true boolean
-        const passedArguments = rawEvent.slice(3);
+        const passedArguments = argv.userArgs.slice(1);
         for (let i = 0; i < passedArguments.length; i++) {
             const arg = passedArguments[i];
             if (arg.startsWith("-") === false) {
+                // Bare (non-dashed) tokens are positionals. Kept as `arguments[arg] = true` for
+                // backward compatibility, and additionally collected in order under the reserved
+                // `_` key so commands like `trace <id>` / `logs <id>` can read a real positional.
                 command.arguments[arg] = true;
+                if (Array.isArray(command.arguments._) === false) {
+                    command.arguments._ = [];
+                }
+                command.arguments._.push(arg);
                 continue;
             }
             const numberOfStartingDashes = arg.startsWith("--") ? 2 : 1;
@@ -90,12 +123,18 @@ let CommandEventMapper = class CommandEventMapper {
             command.arguments[argumentName] = argumentValue;
         }
         return {
-            events: [new core_1.Event("command", command, (0, uuid_1.v4)())],
+            events: [new core_1.Event("command", command, this.eventIdManager.generateEventId())],
             executionOrder: "sequential",
         };
     }
     supportsReverseMapping(eventResponse, response, executionContext) {
-        return executionContext.keyname === core_1.ExecutionContextKeynameEnum.Cli;
+        var _a;
+        if (executionContext.keyname !== core_1.ExecutionContextKeynameEnum.Cli) {
+            return false;
+        }
+        // Reverse-map only the command responses this mapper owns — the REPL-start payload
+        // flows through `ReplStartEventMapper` and would otherwise be silently clobbered here.
+        return ((_a = eventResponse.event) === null || _a === void 0 ? void 0 : _a.payload) instanceof command_event_payload_1.CommandEventPayload;
     }
     /**
      * We want to support returning an exit code directly. This means that in the cli.ts file of the customers, they can directly do:
@@ -112,6 +151,7 @@ exports.CommandEventMapper = CommandEventMapper;
 exports.CommandEventMapper = CommandEventMapper = __decorate([
     (0, common_1.tag)(common_1.ServiceDefinitionTagEnum.EventMapper),
     (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname),
-    (0, tsyringe_1.injectable)()
+    (0, tsyringe_1.injectable)(),
+    __metadata("design:paramtypes", [core_1.EventIdManager])
 ], CommandEventMapper);
 //# sourceMappingURL=command-event.mapper.js.map

package/dist/lib/cjs/mappers/command-event.mapper.js.map

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

package/dist/lib/cjs/mappers/mappers.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./command-event.mapper"), exports);
+__exportStar(require("./repl-start-event.mapper"), exports);
 //# sourceMappingURL=mappers.js.map

package/dist/lib/cjs/mappers/mappers.js.map

@@ -1 +1 @@
-{"version":3,"file":"mappers.js","sourceRoot":"","sources":["../../../../src/mappers/mappers.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC"}
+{"version":3,"file":"mappers.js","sourceRoot":"","sources":["../../../../src/mappers/mappers.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,4DAA0C"}

package/dist/lib/cjs/mappers/repl-start-event.mapper.js

@@ -0,0 +1,80 @@
+"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.ReplStartEventMapper = void 0;
+const core_1 = require("@pristine-ts/core");
+const tsyringe_1 = require("tsyringe");
+const common_1 = require("@pristine-ts/common");
+const start_repl_event_payload_1 = require("../event-payloads/start-repl.event-payload");
+const cli_module_keyname_1 = require("../cli.module.keyname");
+const pristine_argv_1 = require("../utils/pristine-argv");
+/**
+ * Maps the "no command" / `repl` argv shapes onto a `StartReplEventPayload` so the kernel
+ * can dispatch the REPL launch through the normal event pipeline — `cli.ts` just calls
+ * `kernel.handle(process.argv, {keyname: Cli})` regardless of whether the user invoked
+ * `pristine`, `pristine repl`, or `pristine <some-command>`.
+ *
+ * Argv parsing is delegated to `PristineArgv`, which scans for the bin token rather than
+ * assuming positional layout — so the rule is runtime-agnostic and survives launchers
+ * that shape argv differently.
+ *
+ * `CommandEventMapper` explicitly excludes these same shapes from its own
+ * `supportsMapping` so the two mappers partition argv space cleanly — no shape is claimed
+ * by both.
+ */
+let ReplStartEventMapper = class ReplStartEventMapper {
+    constructor(eventIdManager) {
+        this.eventIdManager = eventIdManager;
+    }
+    supportsMapping(rawEvent, executionContext) {
+        if (executionContext.keyname !== core_1.ExecutionContextKeynameEnum.Cli) {
+            return false;
+        }
+        if (Array.isArray(rawEvent) === false) {
+            return false;
+        }
+        const argv = new pristine_argv_1.PristineArgv(rawEvent);
+        if (argv.isValid === false) {
+            return false;
+        }
+        // No user args → REPL. First user arg is `repl` → REPL (any tokens after `repl` are
+        // ignored at routing time, by design).
+        return argv.userArgs.length === 0 || argv.userArgs[0] === "repl";
+    }
+    map(rawEvent, executionContext) {
+        const argv = new pristine_argv_1.PristineArgv(Array.isArray(rawEvent) ? rawEvent : []);
+        const payload = new start_repl_event_payload_1.StartReplEventPayload(argv.scriptPath);
+        return {
+            events: [new core_1.Event("start-repl", payload, this.eventIdManager.generateEventId())],
+            executionOrder: "sequential",
+        };
+    }
+    supportsReverseMapping(eventResponse, response, executionContext) {
+        var _a;
+        return executionContext.keyname === core_1.ExecutionContextKeynameEnum.Cli
+            && ((_a = eventResponse.event) === null || _a === void 0 ? void 0 : _a.payload) instanceof start_repl_event_payload_1.StartReplEventPayload;
+    }
+    /**
+     * The REPL handler resolves with the session's exit code; surface it as-is so
+     * `Cli.bootstrap()` can return it to the bin (which calls `process.exit`).
+     */
+    reverseMap(eventResponse, response, executionContext) {
+        return eventResponse.response;
+    }
+};
+exports.ReplStartEventMapper = ReplStartEventMapper;
+exports.ReplStartEventMapper = ReplStartEventMapper = __decorate([
+    (0, common_1.tag)(common_1.ServiceDefinitionTagEnum.EventMapper),
+    (0, common_1.moduleScoped)(cli_module_keyname_1.CliModuleKeyname),
+    (0, tsyringe_1.injectable)(),
+    __metadata("design:paramtypes", [core_1.EventIdManager])
+], ReplStartEventMapper);
+//# sourceMappingURL=repl-start-event.mapper.js.map

package/dist/lib/cjs/mappers/repl-start-event.mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl-start-event.mapper.js","sourceRoot":"","sources":["../../../../src/mappers/repl-start-event.mapper.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,4CAQ2B;AAC3B,uCAAoC;AACpC,gDAAgF;AAChF,yFAAiF;AACjF,8DAAuD;AACvD,0DAAoD;AAEpD;;;;;;;;;;;;;GAaG;AAII,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAC/B,YAA6B,cAA8B;QAA9B,mBAAc,GAAd,cAAc,CAAgB;IAC3D,CAAC;IAED,eAAe,CAAC,QAAa,EAAE,gBAAgD;QAC7E,IAAI,gBAAgB,CAAC,OAAO,KAAK,kCAA2B,CAAC,GAAG,EAAE,CAAC;YACjE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC;YACtC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,4BAAY,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,oFAAoF;QACpF,uCAAuC;QACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC;IACnE,CAAC;IAED,GAAG,CAAC,QAAa,EAAE,gBAAgD;QACjE,MAAM,IAAI,GAAG,IAAI,4BAAY,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,IAAI,gDAAqB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3D,OAAO;YACL,MAAM,EAAE,CAAC,IAAI,YAAK,CAAwB,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC,CAAC;YACxG,cAAc,EAAE,YAAY;SAC7B,CAAC;IACJ,CAAC;IAED,sBAAsB,CAAC,aAA2D,EAAE,QAAa,EAAE,gBAAgD;;QACjJ,OAAO,gBAAgB,CAAC,OAAO,KAAK,kCAA2B,CAAC,GAAG;eAC9D,CAAA,MAAA,aAAa,CAAC,KAAK,0CAAE,OAAO,aAAY,gDAAqB,CAAC;IACrE,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,aAA2D,EAAE,QAAa,EAAE,gBAAgD;QACrI,OAAO,aAAa,CAAC,QAAQ,CAAC;IAChC,CAAC;CACF,CAAA;AAzCY,oDAAoB;+BAApB,oBAAoB;IAHhC,IAAA,YAAG,EAAC,iCAAwB,CAAC,WAAW,CAAC;IACzC,IAAA,qBAAY,EAAC,qCAAgB,CAAC;IAC9B,IAAA,qBAAU,GAAE;qCAEkC,qBAAc;GADhD,oBAAoB,CAyChC"}

package/dist/lib/cjs/options/command-parameter.options.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=command-parameter.options.js.map

package/dist/lib/cjs/options/command-parameter.options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-parameter.options.js","sourceRoot":"","sources":["../../../../src/options/command-parameter.options.ts"],"names":[],"mappings":""}

package/dist/lib/cjs/options/options.js

@@ -14,5 +14,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./command-parameter.options"), exports);
 __exportStar(require("./console-readline.options"), exports);
 //# sourceMappingURL=options.js.map

package/dist/lib/cjs/options/options.js.map

@@ -1 +1 @@
-{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../src/options/options.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C"}
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../src/options/options.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C;AAC5C,6DAA2C"}