@pristine-ts/cli 2.0.16 → 2.0.17

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

@@ -1,215 +0,0 @@
-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 ReplSession_1;
-import * as readline from "node:readline";
-import { injectable } from "tsyringe";
-import { ExitCode, moduleScoped, ServiceDefinitionTagEnum } from "@pristine-ts/common";
-import { ExecutionContextKeynameEnum } from "@pristine-ts/core";
-import { ObservabilityStoreReader } from "@pristine-ts/observability";
-import { CliOutput } from "./cli-output.manager";
-import { CliModuleKeyname } from "../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(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: 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(ServiceDefinitionTagEnum.CurrentChildContainer, childContainer);
-            return childContainer.resolveAll(ServiceDefinitionTagEnum.Command);
-        }
-        catch (error) {
-            process.stderr.write(`[repl] could not load commands: ${error instanceof Error ? error.message : String(error)}\n`);
-            return [];
-        }
-    }
-};
-ReplSession.PROMPT = "pristine ❯ ";
-ReplSession.SESSION_VERBS = ["/help", "/clear", "/exit"];
-ReplSession.TRACE_ID_COMPLETION_LIMIT = 25;
-ReplSession = ReplSession_1 = __decorate([
-    injectable(),
-    moduleScoped(CliModuleKeyname),
-    __metadata("design:paramtypes", [CliOutput,
-        ObservabilityStoreReader])
-], ReplSession);
-export { ReplSession };
-//# sourceMappingURL=repl-session.js.map

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

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

package/dist/types/bootstrap/app-module-cache.d.ts

@@ -1,15 +0,0 @@
-/**
- * Persists the user's selection from the disambiguation prompt so subsequent invocations of
- * `pristine` in the same project skip the prompt. Stale entries (target file deleted since
- * the cache was written) are auto-cleaned on read.
- *
- * Best-effort throughout — failures to read or write the cache file are swallowed because
- * the cache is a UX optimization, not correctness-critical.
- */
-export declare class AppModuleCache {
-    private readonly cacheDirName;
-    private readonly cacheFileName;
-    read(projectRoot: string): string | undefined;
-    write(projectRoot: string, absolutePath: string): void;
-    private cachePath;
-}

package/dist/types/bootstrap/app-module-discoverer.d.ts

@@ -1,30 +0,0 @@
-import { AppModuleDiscoveryCandidate } from "./app-module-discovery-candidate";
-/**
- * Scans well-known directories for files that look like AppModule definitions. Non-recursive
- * (each search root is scanned at depth 1 only) so it stays fast on large repos and predictable
- * when users have many nested module files.
- *
- * A file is a candidate when:
- *   - its filename matches `*.module.{js,mjs,cjs}` (and is not a test/spec file), AND
- *   - either the filename literally matches `app.module.{js,mjs,cjs}` (highest confidence,
- *     scored 0), OR the file's exports include a symbol named `AppModule` (scored 10).
- */
-export declare class AppModuleDiscoverer {
-    /**
-     * Search roots scanned for candidates, relative to the project root. Order is intentional:
-     * compiled output first (most likely runtime entry), then build/, then the project root
-     * itself for trivial single-file demos.
-     */
-    private readonly searchRoots;
-    private readonly moduleFileRegex;
-    private readonly appModuleNameRegex;
-    discover(projectRoot: string): Promise<AppModuleDiscoveryCandidate[]>;
-    /**
-     * Synchronous probe: does this file's exports include an `AppModule` symbol? Uses
-     * `require()` rather than dynamic `import()` because (a) we only accept `.js/.mjs/.cjs`
-     * whose CJS variants load synchronously, and (b) discarded probes shouldn't hold open
-     * `import()` promises.
-     * @private
-     */
-    private exportsAppModule;
-}

package/dist/types/bootstrap/app-module-discovery-candidate.d.ts

@@ -1,18 +0,0 @@
-import { AppModuleDiscoveryReasonEnum } from "./app-module-discovery-reason.enum";
-/**
- * A plausible AppModule found by the convention-based scan. Lower `score` beats higher;
- * ties are ambiguous and trigger the disambiguation prompt.
- */
-export declare class AppModuleDiscoveryCandidate {
-    readonly absolutePath: string;
-    /** Path relative to the project root. Used purely for human-facing display. */
-    readonly displayPath: string;
-    /** Lower = better. Files literally named `app.module.*` get 0; AppModule-exporting `*.module.*` files get 10. */
-    readonly score: number;
-    readonly reason: AppModuleDiscoveryReasonEnum;
-    constructor(absolutePath: string, 
-    /** Path relative to the project root. Used purely for human-facing display. */
-    displayPath: string, 
-    /** Lower = better. Files literally named `app.module.*` get 0; AppModule-exporting `*.module.*` files get 10. */
-    score: number, reason: AppModuleDiscoveryReasonEnum);
-}

package/dist/types/bootstrap/app-module-discovery-reason.enum.d.ts

@@ -1,10 +0,0 @@
-/**
- * Why a candidate file was considered a possible AppModule. Used by the disambiguation prompt
- * so the user sees "(matches app.module.*)" vs "(exports AppModule)" alongside each option.
- */
-export declare enum AppModuleDiscoveryReasonEnum {
-    /** The filename matches `app.module.{js,mjs,cjs}`. Highest confidence. */
-    Named = "named",
-    /** The filename is `*.module.{js,mjs,cjs}` and the file's exports include an `AppModule` symbol. */
-    Exports = "exports"
-}

package/dist/types/bootstrap/app-module-prompt.d.ts

@@ -1,20 +0,0 @@
-import { AppModuleDiscoveryCandidate } from "./app-module-discovery-candidate";
-import { DynamicImporter } from "./dynamic-importer";
-/**
- * TTY disambiguation for the AppModule discovery cascade. When multiple equally-ranked
- * candidates exist and stdin/stdout are both connected to a real terminal, ask the user
- * to pick one. When non-interactive (CI, Docker, redirected stdin), the caller should
- * fall back to throwing an actionable error rather than guessing.
- *
- * `@inquirer/prompts` is dynamic-imported through `DynamicImporter` so the prompt UI
- * dependency only loads when actually prompting — keeps non-interactive startup fast and
- * avoids paying for inquirer's TTY-detection overhead on every invocation.
- */
-export declare class AppModulePrompt {
-    private readonly dynamicImporter;
-    private readonly cancelLabel;
-    constructor(dynamicImporter: DynamicImporter);
-    isInteractive(): boolean;
-    prompt(candidates: AppModuleDiscoveryCandidate[]): Promise<string | undefined>;
-    private reasonLabel;
-}

package/dist/types/commands/config-init.command.d.ts

@@ -1,18 +0,0 @@
-import { CommandInterface } from "../interfaces/command.interface";
-import { ConsoleManager } from "../managers/console.manager";
-import { ExitCodeEnum } from "../enums/exit-code.enum";
-/**
- * Generates a starter `pristine.config.ts` in the current directory. If the consumer's
- * `package.json` already declares `pristine.appModule.path` or `pristine.appModule.cjsPath`,
- * the value is migrated into the new config and the user is told to remove the old field.
- */
-export declare class ConfigInitCommand implements CommandInterface<null> {
-    private readonly consoleManager;
-    optionsType: null;
-    name: string;
-    description: string;
-    constructor(consoleManager: ConsoleManager);
-    run(args: any): Promise<ExitCodeEnum | number>;
-    private detectExistingAppModulePath;
-    private renderConfigTemplate;
-}

package/dist/types/enums/exit-code.enum.d.ts

@@ -1,4 +0,0 @@
-export declare enum ExitCodeEnum {
-    Success = 0,
-    Error = 1
-}

package/dist/types/managers/console.manager.d.ts

@@ -1,93 +0,0 @@
-import { ConsoleReadlineOptions } from "../options/console-readline.options";
-export declare class ConsoleManager {
-    private spinnerInterval;
-    private isSpinning;
-    /**
-     * Writes a message to stdout without a newline.
-     * @param message The message to write.
-     */
-    write(message: string): void;
-    /**
-     * Writes a message to stdout with a newline.
-     * @param message The message to write.
-     */
-    writeLine(message: string): void;
-    /**
-     * Writes a table to stdout.
-     * @param table The array of objects to display as a table.
-     */
-    writeTable(table: any[]): void;
-    /**
-     * Writes an error message in red with an 'Error:' prefix.
-     * @param message The error message to display.
-     */
-    writeError(message: string): void;
-    /**
-     * Writes a success message in green with a 'Success:' prefix.
-     * @param message The success message to display.
-     */
-    writeSuccess(message: string): void;
-    /**
-     * Writes a warning message in yellow with a 'Warning:' prefix.
-     * @param message The warning message to display.
-     */
-    writeWarning(message: string): void;
-    /**
-     * Writes an info message in cyan with an 'Info:' prefix.
-     * @param message The info message to display.
-     */
-    writeInfo(message: string): void;
-    /**
-     * Starts a loading spinner with a message.
-     *
-     * @param message The message to display next to the spinner.
-     * @remarks
-     * This method hides the cursor and continuously updates the current line.
-     * Avoid calling other write methods while the spinner is active as they may conflict with the spinner's line clearing.
-     */
-    startSpinner(message: string): void;
-    /**
-     * Stops the loading spinner and optionally prints a completion message.
-     *
-     * @param message Optional completion message to display.
-     * @param success Whether the operation was successful. Defaults to true.
-     * @remarks
-     * Stops the spinner, shows the cursor, and prints a final success or error message on the same line.
-     */
-    stopSpinner(message?: string, success?: boolean): void;
-    /**
-     * Displays or updates a progress bar.
-     *
-     * @param current The current progress value.
-     * @param total The total value to reach (100%).
-     * @param message Optional message to display next to the bar.
-     * @param width The visual width of the progress bar in characters. Defaults to 30.
-     *
-     * @remarks
-     * This method clears the *current* line and writes the progress bar.
-     *
-     * **Important:** If you call `writeLine()` (or any other method that outputs a newline) between calls to `updateProgressBar()`,
-     * the next call to `updateProgressBar()` will start on the *new* line, leaving the previous progress bar state on the line above.
-     *
-     * **Example of creating artifacts:**
-     * ```typescript
-     * manager.updateProgressBar(10, 100); // Draws bar at line N
-     * manager.writeLine("Log message");   // Moves cursor to line N+1
-     * manager.updateProgressBar(20, 100); // Draws bar at line N+1 (Line N has the old bar)
-     * ```
-     */
-    updateProgressBar(current: number, total: number, message?: string, width?: number): void;
-    /**
-     * Reads a string from stdin.
-     * @returns The raw string read from stdin.
-     */
-    read(): string;
-    /**
-     * Reads a line from stdin with a prompt.
-     *
-     * @param question The prompt text to display.
-     * @param options Configuration options for the input (e.g., masking characters).
-     * @returns A promise resolving to the user's input string.
-     */
-    readLine(question: string, options?: ConsoleReadlineOptions): Promise<string>;
-}

package/dist/types/managers/repl-session.d.ts

@@ -1,62 +0,0 @@
-import { Kernel } from "@pristine-ts/core";
-import { ObservabilityStoreReader } from "@pristine-ts/observability";
-import { CliOutput } from "./cli-output.manager";
-/**
- * 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.
- */
-export declare class ReplSession {
-    private readonly cliOutput;
-    private readonly storeReader;
-    private static readonly PROMPT;
-    private static readonly SESSION_VERBS;
-    private static readonly TRACE_ID_COMPLETION_LIMIT;
-    private commands;
-    constructor(cliOutput: CliOutput, storeReader: ObservabilityStoreReader);
-    /**
-     * 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: Kernel): Promise<number>;
-    /**
-     * Handles one input line. Returns true when the session should end.
-     */
-    private handleLine;
-    /**
-     * Readline completer. Completes `/`-prefixed command names and session verbs; for
-     * `/trace` and `/logs` it completes the trailing token with recent trace ids.
-     */
-    private complete;
-    private printBanner;
-    private printHelp;
-    private shutdown;
-    /**
-     * 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.
-     */
-    private resolveCommands;
-}