@c9up/ream 0.1.26 → 0.1.28

package/dist/console/BaseCommand.js.map

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

package/dist/console/Console.d.ts

@@ -0,0 +1,86 @@
+/**
+ * `consoleApp` — the programmatic face of the console.
+ *
+ * The CLI is not the only caller: a test wants to run a command and inspect the
+ * result, a controller may want to trigger one, a script may want to check a
+ * command exists before calling it. Spawning a process for that is both slow
+ * and untestable.
+ *
+ *   import consoleApp from '@c9up/ream/services/console'
+ *
+ *   const command = await consoleApp.exec('make:controller', ['user', '--resource'])
+ *   command.exitCode  // 0 on success, 1 on an unhandled failure
+ *   command.result    // whatever run() returned
+ *   command.error     // the failure, when one survived completed()
+ */
+import type { Ui } from './cliui.js';
+import type { Kernel, KernelState } from './Kernel.js';
+import type { CommandClass, CommandInstance, ExecutedCommand, SerializedCommand } from './types.js';
+export interface ConsoleOptions {
+    kernel: Kernel;
+    /**
+     * Loads the application's commands into the kernel. Called once, on first
+     * use — discovery reads the filesystem and imports modules, which is too much
+     * to do at every `hasCommand()`.
+     */
+    load: () => Promise<void>;
+}
+export declare class Console {
+    #private;
+    constructor(options: ConsoleOptions);
+    /**
+     * Load the commands if that has not happened yet.
+     *
+     * Idempotent, and safe under concurrent calls: the in-flight promise is
+     * shared, so two parallel `exec()` calls do not each import every command.
+     */
+    boot(): Promise<void>;
+    /** Run a command and return it, carrying `exitCode`, `result` and `error`. */
+    exec(commandName: string, argv?: readonly string[], options?: {
+        ui?: Ui;
+    }): Promise<ExecutedCommand>;
+    /**
+     * Does a command (or alias) by this name exist?
+     *
+     * Synchronous, as in Console — `await consoleApp.boot()` then `if (consoleApp.hasCommand(…))`.
+     * An async version would be a trap: a Promise is always truthy, so Adonis
+     * code copied over would take every branch.
+     *
+     * Calling it before `boot()` throws rather than answering `false`: an
+     * unloaded registry cannot tell "no such command" from "not looked yet", and
+     * a silent `false` is exactly the failure this signature exists to avoid.
+     */
+    hasCommand(name: string): boolean;
+    /** The metadata of every registered command. Requires {@link boot} too. */
+    getCommands(): SerializedCommand[];
+    /**
+     * The rest of Console's introspection surface, relayed as-is.
+     *
+     * All of it reads the registry, so all of it needs {@link boot} first —
+     * answering from an empty registry would be worse than the error, since
+     * "no such command" and "commands not loaded yet" are indistinguishable to
+     * the caller.
+     */
+    getCommand(commandName: string): SerializedCommand | null;
+    getNamespaceCommands(namespace?: string): SerializedCommand[];
+    getNamespaces(): string[];
+    getAliases(): string[];
+    getAliasCommand(alias: string): SerializedCommand | null;
+    getCommandAliases(commandName: string): string[];
+    getCommandSuggestions(name: string): string[];
+    getNamespaceSuggestions(name: string): string[];
+    /** The kernel's lifecycle stage — Console `getState()`. */
+    getState(): KernelState;
+    /** The command run when none is named. */
+    getDefaultCommand(): CommandClass;
+    /** The command invoked from the command line, once it has been built. */
+    getMainCommand(): CommandInstance | undefined;
+    /**
+     * Resolve a command class by name or alias, throwing when there is none.
+     * Loads the commands first, like {@link exec}.
+     */
+    find(commandName: string): Promise<CommandClass>;
+    /** The underlying kernel, for anything the façade does not cover. */
+    get kernel(): Kernel;
+}
+//# sourceMappingURL=Console.d.ts.map

package/dist/console/Console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Console.d.ts","sourceRoot":"","sources":["../../src/console/Console.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEnG,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAED,qBAAa,OAAO;;gBAMN,OAAO,EAAE,cAAc;IAKnC;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,8EAA8E;IACxE,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,SAAS,MAAM,EAAO,EAC5B,OAAO,GAAE;QAAE,EAAE,CAAC,EAAE,EAAE,CAAA;KAAO,GACxB,OAAO,CAAC,eAAe,CAAC;IAK3B;;;;;;;;;;OAUG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAKjC,2EAA2E;IAC3E,WAAW,IAAI,iBAAiB,EAAE;IAKlC;;;;;;;OAOG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAKzD,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAK7D,aAAa,IAAI,MAAM,EAAE;IAKzB,UAAU,IAAI,MAAM,EAAE;IAKtB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAKxD,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAKhD,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAK7C,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAK/C,2DAA2D;IAC3D,QAAQ,IAAI,WAAW;IAIvB,0CAA0C;IAC1C,iBAAiB,IAAI,YAAY;IAKjC,yEAAyE;IACzE,cAAc,IAAI,eAAe,GAAG,SAAS;IAI7C;;;OAGG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IActD,qEAAqE;IACrE,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}

package/dist/console/Console.js

@@ -0,0 +1,134 @@
+/**
+ * `consoleApp` — the programmatic face of the console.
+ *
+ * The CLI is not the only caller: a test wants to run a command and inspect the
+ * result, a controller may want to trigger one, a script may want to check a
+ * command exists before calling it. Spawning a process for that is both slow
+ * and untestable.
+ *
+ *   import consoleApp from '@c9up/ream/services/console'
+ *
+ *   const command = await consoleApp.exec('make:controller', ['user', '--resource'])
+ *   command.exitCode  // 0 on success, 1 on an unhandled failure
+ *   command.result    // whatever run() returned
+ *   command.error     // the failure, when one survived completed()
+ */
+import { ReamError } from '../errors/ReamError.js';
+export class Console {
+    #kernel;
+    #load;
+    #booting;
+    #booted = false;
+    constructor(options) {
+        this.#kernel = options.kernel;
+        this.#load = options.load;
+    }
+    /**
+     * Load the commands if that has not happened yet.
+     *
+     * Idempotent, and safe under concurrent calls: the in-flight promise is
+     * shared, so two parallel `exec()` calls do not each import every command.
+     */
+    async boot() {
+        this.#booting ??= this.#load().then(() => {
+            this.#booted = true;
+        });
+        await this.#booting;
+    }
+    /** Run a command and return it, carrying `exitCode`, `result` and `error`. */
+    async exec(commandName, argv = [], options = {}) {
+        await this.boot();
+        return this.#kernel.exec(commandName, argv, options);
+    }
+    /**
+     * Does a command (or alias) by this name exist?
+     *
+     * Synchronous, as in Console — `await consoleApp.boot()` then `if (consoleApp.hasCommand(…))`.
+     * An async version would be a trap: a Promise is always truthy, so Adonis
+     * code copied over would take every branch.
+     *
+     * Calling it before `boot()` throws rather than answering `false`: an
+     * unloaded registry cannot tell "no such command" from "not looked yet", and
+     * a silent `false` is exactly the failure this signature exists to avoid.
+     */
+    hasCommand(name) {
+        this.#assertBooted('hasCommand');
+        return this.#kernel.hasCommand(name);
+    }
+    /** The metadata of every registered command. Requires {@link boot} too. */
+    getCommands() {
+        this.#assertBooted('getCommands');
+        return this.#kernel.getCommands();
+    }
+    /**
+     * The rest of Console's introspection surface, relayed as-is.
+     *
+     * All of it reads the registry, so all of it needs {@link boot} first —
+     * answering from an empty registry would be worse than the error, since
+     * "no such command" and "commands not loaded yet" are indistinguishable to
+     * the caller.
+     */
+    getCommand(commandName) {
+        this.#assertBooted('getCommand');
+        return this.#kernel.getCommand(commandName);
+    }
+    getNamespaceCommands(namespace) {
+        this.#assertBooted('getNamespaceCommands');
+        return this.#kernel.getNamespaceCommands(namespace);
+    }
+    getNamespaces() {
+        this.#assertBooted('getNamespaces');
+        return this.#kernel.getNamespaces();
+    }
+    getAliases() {
+        this.#assertBooted('getAliases');
+        return this.#kernel.getAliases();
+    }
+    getAliasCommand(alias) {
+        this.#assertBooted('getAliasCommand');
+        return this.#kernel.getAliasCommand(alias);
+    }
+    getCommandAliases(commandName) {
+        this.#assertBooted('getCommandAliases');
+        return this.#kernel.getCommandAliases(commandName);
+    }
+    getCommandSuggestions(name) {
+        this.#assertBooted('getCommandSuggestions');
+        return this.#kernel.getCommandSuggestions(name);
+    }
+    getNamespaceSuggestions(name) {
+        this.#assertBooted('getNamespaceSuggestions');
+        return this.#kernel.getNamespaceSuggestions(name);
+    }
+    /** The kernel's lifecycle stage — Console `getState()`. */
+    getState() {
+        return this.#kernel.getState();
+    }
+    /** The command run when none is named. */
+    getDefaultCommand() {
+        this.#assertBooted('getDefaultCommand');
+        return this.#kernel.getDefaultCommand();
+    }
+    /** The command invoked from the command line, once it has been built. */
+    getMainCommand() {
+        return this.#kernel.getMainCommand();
+    }
+    /**
+     * Resolve a command class by name or alias, throwing when there is none.
+     * Loads the commands first, like {@link exec}.
+     */
+    async find(commandName) {
+        await this.boot();
+        return this.#kernel.find(commandName);
+    }
+    #assertBooted(method) {
+        if (this.#booted)
+            return;
+        throw new ReamError('E_CONSOLE_NOT_BOOTED', `consoleApp.${method}() was called before the commands were loaded.`, { hint: 'Await consoleApp.boot() first — consoleApp.exec() does it for you.' });
+    }
+    /** The underlying kernel, for anything the façade does not cover. */
+    get kernel() {
+        return this.#kernel;
+    }
+}
+//# sourceMappingURL=Console.js.map

package/dist/console/Console.js.map

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

package/dist/console/ExceptionHandler.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The default renderer for a failure of the command line (Console's
+ * `ExceptionHandler`).
+ *
+ * A class rather than a function so an application can extend it and override
+ * one step — the usual need is "report this error like the framework does, but
+ * ship it somewhere too".
+ */
+import type { Kernel } from './Kernel.js';
+export declare class ExceptionHandler {
+    /** Print the whole error, stack included. */
+    debug: boolean;
+    /**
+     * Error codes to report as a single line, without a stack.
+     *
+     * The framework's own call errors are always in this set: a missing flag is
+     * something the user typed, and a stack trace of the parser tells them
+     * nothing about it.
+     */
+    knownErrorCodes: string[];
+    protected get internalKnownErrorCodes(): readonly string[];
+    /** One line on stderr, through the kernel's own UI. */
+    protected logError(message: string, kernel: Kernel): void;
+    /** The full error, with its stack — what a developer needs. */
+    protected prettyPrintError(error: unknown): Promise<void>;
+    render(error: unknown, kernel: Kernel): Promise<void>;
+}
+//# sourceMappingURL=ExceptionHandler.d.ts.map

package/dist/console/ExceptionHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExceptionHandler.d.ts","sourceRoot":"","sources":["../../src/console/ExceptionHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAgBzC,qBAAa,gBAAgB;IAC3B,6CAA6C;IAC7C,KAAK,UAAO;IAEZ;;;;;;OAMG;IACH,eAAe,EAAE,MAAM,EAAE,CAAK;IAE9B,SAAS,KAAK,uBAAuB,IAAI,SAAS,MAAM,EAAE,CAEzD;IAED,uDAAuD;IACvD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAIzD,+DAA+D;cAC/C,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAoC5D"}

package/dist/console/ExceptionHandler.js

@@ -0,0 +1,76 @@
+/**
+ * The default renderer for a failure of the command line (Console's
+ * `ExceptionHandler`).
+ *
+ * A class rather than a function so an application can extend it and override
+ * one step — the usual need is "report this error like the framework does, but
+ * ship it somewhere too".
+ */
+import { prettyPrintError } from '../errors/prettyPrintError.js';
+import { isReamError } from '../errors/ReamError.js';
+/** Errors the console raises when a command is called wrongly. */
+const CALL_ERROR_CODES = [
+    'E_CONSOLE_COMMAND_NOT_FOUND',
+    'E_CONSOLE_MISSING_ARGUMENT',
+    'E_CONSOLE_MISSING_ARGUMENT_VALUE',
+    'E_CONSOLE_MISSING_FLAG',
+    'E_CONSOLE_MISSING_FLAG_VALUE',
+    'E_CONSOLE_UNKNOWN_FLAG',
+    'E_CONSOLE_INVALID_FLAG_VALUE',
+    'E_CONSOLE_INVALID_FLAG_GROUP',
+    'E_CONSOLE_UNEXPECTED_ARGUMENT',
+    'E_CONSOLE_PROMPT_CANCELLED',
+];
+export class ExceptionHandler {
+    /** Print the whole error, stack included. */
+    debug = true;
+    /**
+     * Error codes to report as a single line, without a stack.
+     *
+     * The framework's own call errors are always in this set: a missing flag is
+     * something the user typed, and a stack trace of the parser tells them
+     * nothing about it.
+     */
+    knownErrorCodes = [];
+    get internalKnownErrorCodes() {
+        return CALL_ERROR_CODES;
+    }
+    /** One line on stderr, through the kernel's own UI. */
+    logError(message, kernel) {
+        kernel.logger.error(message);
+    }
+    /** The full error, with its stack — what a developer needs. */
+    async prettyPrintError(error) {
+        prettyPrintError(error);
+    }
+    async render(error, kernel) {
+        if (typeof error !== 'object' || error === null || !('message' in error)) {
+            this.logError(String(error), kernel);
+            return;
+        }
+        // An unknown command is a typo: the suggestion is the useful part, the
+        // stack is noise.
+        if (isReamError(error, 'E_CONSOLE_COMMAND_NOT_FOUND')) {
+            this.logError(String(error.message), kernel);
+            return;
+        }
+        const code = Reflect.get(error, 'code');
+        if (typeof code === 'string' &&
+            (this.internalKnownErrorCodes.includes(code) || this.knownErrorCodes.includes(code))) {
+            this.logError(String(Reflect.get(error, 'message')), kernel);
+            return;
+        }
+        // An error that knows how to report itself is left to do it.
+        const render = Reflect.get(error, 'render');
+        if (typeof render === 'function') {
+            await Reflect.apply(render, error, [error, kernel]);
+            return;
+        }
+        if (!this.debug) {
+            kernel.logger.fatal(error instanceof Error ? error : String(error));
+            return;
+        }
+        await this.prettyPrintError(error);
+    }
+}
+//# sourceMappingURL=ExceptionHandler.js.map

package/dist/console/ExceptionHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExceptionHandler.js","sourceRoot":"","sources":["../../src/console/ExceptionHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAGpD,kEAAkE;AAClE,MAAM,gBAAgB,GAAG;IACvB,6BAA6B;IAC7B,4BAA4B;IAC5B,kCAAkC;IAClC,wBAAwB;IACxB,8BAA8B;IAC9B,wBAAwB;IACxB,8BAA8B;IAC9B,8BAA8B;IAC9B,+BAA+B;IAC/B,4BAA4B;CAC7B,CAAA;AAED,MAAM,OAAO,gBAAgB;IAC3B,6CAA6C;IAC7C,KAAK,GAAG,IAAI,CAAA;IAEZ;;;;;;OAMG;IACH,eAAe,GAAa,EAAE,CAAA;IAE9B,IAAc,uBAAuB;QACnC,OAAO,gBAAgB,CAAA;IACzB,CAAC;IAED,uDAAuD;IAC7C,QAAQ,CAAC,OAAe,EAAE,MAAc;QAChD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC9B,CAAC;IAED,+DAA+D;IACrD,KAAK,CAAC,gBAAgB,CAAC,KAAc;QAC7C,gBAAgB,CAAC,KAAK,CAAC,CAAA;IACzB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAc,EAAE,MAAc;QACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,EAAE,CAAC;YACzE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAA;YACpC,OAAM;QACR,CAAC;QAED,uEAAuE;QACvE,kBAAkB;QAClB,IAAI,WAAW,CAAC,KAAK,EAAE,6BAA6B,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAA;YAC5C,OAAM;QACR,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QACvC,IACE,OAAO,IAAI,KAAK,QAAQ;YACxB,CAAC,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EACpF,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;YAC5D,OAAM;QACR,CAAC;QAED,6DAA6D;QAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QAC3C,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;YACnD,OAAM;QACR,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;YACnE,OAAM;QACR,CAAC;QAED,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAA;IACpC,CAAC;CACF"}

package/dist/console/HelpCommand.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `help <command>` — the built-in command explaining another one (Console's
+ * `HelpCommand`).
+ *
+ * A registered command, not a branch in the dispatcher: `hasCommand('help')` is
+ * true, `exec('help', ['make:controller'])` works, and it is replaceable like
+ * any other. It reads METADATA, so explaining a command does not import it.
+ */
+import { BaseCommand } from './BaseCommand.js';
+export default class HelpCommand extends BaseCommand {
+    static commandName: string;
+    static description: string;
+    name: string;
+    run(): void;
+}
+//# sourceMappingURL=HelpCommand.d.ts.map

package/dist/console/HelpCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelpCommand.d.ts","sourceRoot":"","sources":["../../src/console/HelpCommand.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAI9C,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,OAAgB,WAAW,SAAS;IACpC,OAAgB,WAAW,SAAkC;IAGrD,IAAI,EAAE,MAAM,CAAA;IAEpB,GAAG,IAAI,IAAI;CAgBZ"}

package/dist/console/HelpCommand.js

@@ -0,0 +1,40 @@
+/**
+ * `help <command>` — the built-in command explaining another one (Console's
+ * `HelpCommand`).
+ *
+ * A registered command, not a branch in the dispatcher: `hasCommand('help')` is
+ * true, `exec('help', ['make:controller'])` works, and it is replaceable like
+ * any other. It reads METADATA, so explaining a command does not import it.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { BaseCommand } from './BaseCommand.js';
+import { args } from './decorators.js';
+import { renderErrorWithSuggestions } from './utils.js';
+export default class HelpCommand extends BaseCommand {
+    static commandName = 'help';
+    static description = 'View help for a given command';
+    run() {
+        const command = this.kernel.getCommand(this.name);
+        if (command === null) {
+            // The same report the kernel gives for an unknown command — one dead end,
+            // one wording.
+            renderErrorWithSuggestions(this.logger, `Command "${this.name}" is not defined.`, this.kernel.getCommandSuggestions(this.name));
+            this.exitCode = 1;
+            return;
+        }
+        this.kernel.printCommandHelp(command);
+    }
+}
+__decorate([
+    args.string({ argumentName: 'command', description: 'Command name' }),
+    __metadata("design:type", String)
+], HelpCommand.prototype, "name", void 0);
+//# sourceMappingURL=HelpCommand.js.map

package/dist/console/HelpCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelpCommand.js","sourceRoot":"","sources":["../../src/console/HelpCommand.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;;;;;;;;;;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAA;AAEvD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,MAAM,CAAU,WAAW,GAAG,MAAM,CAAA;IACpC,MAAM,CAAU,WAAW,GAAG,+BAA+B,CAAA;IAK7D,GAAG;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,0EAA0E;YAC1E,eAAe;YACf,0BAA0B,CACxB,IAAI,CAAC,MAAM,EACX,YAAY,IAAI,CAAC,IAAI,mBAAmB,EACxC,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAC7C,CAAA;YACD,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAA;YACjB,OAAM;QACR,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;IACvC,CAAC;;AAjBO;IADP,IAAI,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;;yCAClD"}

package/dist/console/IndexGenerator.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Writes a commands manifest next to the built commands (Console's
+ * `IndexGenerator`).
+ *
+ * What it buys: listing the commands, or checking that one exists, without
+ * importing a single command module. Scanning a directory means importing every
+ * file in it — the manifest replaces that with one JSON read.
+ */
+import type { SerializedCommand } from './types.js';
+/** What `commands.json` holds. `version` is there to survive a format change. */
+export interface CommandsManifest {
+    version: 1;
+    commands: SerializedCommand[];
+}
+export declare class IndexGenerator {
+    #private;
+    constructor(commandsDirectory: string | URL);
+    /**
+     * Write `commands.json` and the `main.js` / `main.d.ts` loader beside the
+     * commands. Returns the manifest, so a caller can report what it indexed.
+     */
+    generate(): Promise<CommandsManifest>;
+}
+//# sourceMappingURL=IndexGenerator.d.ts.map

package/dist/console/IndexGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexGenerator.d.ts","sourceRoot":"","sources":["../../src/console/IndexGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEnD,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,CAAC,CAAA;IACV,QAAQ,EAAE,iBAAiB,EAAE,CAAA;CAC9B;AAED,qBAAa,cAAc;;gBAGb,iBAAiB,EAAE,MAAM,GAAG,GAAG;IAO3C;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC;CAW5C"}

package/dist/console/IndexGenerator.js

@@ -0,0 +1,65 @@
+/**
+ * Writes a commands manifest next to the built commands (Console's
+ * `IndexGenerator`).
+ *
+ * What it buys: listing the commands, or checking that one exists, without
+ * importing a single command module. Scanning a directory means importing every
+ * file in it — the manifest replaces that with one JSON read.
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import { pathToFileURL } from 'node:url';
+import { FsLoader } from './loaders.js';
+export class IndexGenerator {
+    #directory;
+    constructor(commandsDirectory) {
+        this.#directory =
+            typeof commandsDirectory === 'string'
+                ? pathToFileURL(`${commandsDirectory}/`)
+                : commandsDirectory;
+    }
+    /**
+     * Write `commands.json` and the `main.js` / `main.d.ts` loader beside the
+     * commands. Returns the manifest, so a caller can report what it indexed.
+     */
+    async generate() {
+        const commands = await new FsLoader(this.#directory).getMetaData();
+        const manifest = { version: 1, commands };
+        await mkdir(this.#directory, { recursive: true });
+        await writeFile(new URL('commands.json', this.#directory), JSON.stringify(manifest, null, 2));
+        await writeFile(new URL('main.js', this.#directory), LOADER);
+        await writeFile(new URL('main.d.ts', this.#directory), LOADER_TYPES);
+        return manifest;
+    }
+}
+/**
+ * The generated loader. It satisfies `CommandLoader` structurally, so the
+ * kernel takes it as-is: `kernel.addLoader(await import('./commands/main.js'))`.
+ */
+const LOADER = `import { readFile } from 'node:fs/promises'
+
+/** Generated by Ream's IndexGenerator — do not edit. */
+let manifest
+
+export async function getMetaData() {
+  if (manifest === undefined) {
+    const contents = await readFile(new URL('./commands.json', import.meta.url), 'utf-8')
+    manifest = JSON.parse(contents).commands
+  }
+  return manifest
+}
+
+export async function getCommand(metadata) {
+  const commands = await getMetaData()
+  const command = commands.find((entry) => entry.commandName === metadata.commandName)
+  if (command === undefined) return null
+
+  const imported = await import(new URL(command.filePath, import.meta.url).href)
+  return imported.default ?? null
+}
+`;
+const LOADER_TYPES = `import type { CommandClass, SerializedCommand } from '@c9up/ream'
+
+export declare function getMetaData(): Promise<SerializedCommand[]>
+export declare function getCommand(metadata: SerializedCommand): Promise<CommandClass | null>
+`;
+//# sourceMappingURL=IndexGenerator.js.map

package/dist/console/IndexGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexGenerator.js","sourceRoot":"","sources":["../../src/console/IndexGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AASvC,MAAM,OAAO,cAAc;IAChB,UAAU,CAAK;IAExB,YAAY,iBAA+B;QACzC,IAAI,CAAC,UAAU;YACb,OAAO,iBAAiB,KAAK,QAAQ;gBACnC,CAAC,CAAC,aAAa,CAAC,GAAG,iBAAiB,GAAG,CAAC;gBACxC,CAAC,CAAC,iBAAiB,CAAA;IACzB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,QAAQ,GAAG,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAA;QAClE,MAAM,QAAQ,GAAqB,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAA;QAE3D,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACjD,MAAM,SAAS,CAAC,IAAI,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QAC7F,MAAM,SAAS,CAAC,IAAI,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAA;QAC5D,MAAM,SAAS,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,CAAA;QAEpE,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;CAqBd,CAAA;AAED,MAAM,YAAY,GAAG;;;;CAIpB,CAAA"}