@wundr.io/cli 1.0.12 → 1.0.13

package/dist/framework/command-registry.d.ts

@@ -0,0 +1,173 @@
+/**
+ * Command Registry - Auto-discovery, registration, and Commander.js integration.
+ *
+ * The registry is the central hub that:
+ * 1. Discovers CommandDefinition files from the commands/ directory
+ * 2. Validates definitions at registration time
+ * 3. Builds a Commander.js program from registered definitions
+ * 4. Provides lookup for shell completion generation
+ * 5. Supports legacy command wrapping for incremental migration
+ *
+ * @module framework/command-registry
+ */
+import { Command } from 'commander';
+import type { CommandDefinition, CommandModule, CommandHook, CommandCategory, CommandContext, GlobalOptions } from './command-interface';
+/**
+ * Options for the command registry.
+ */
+export interface RegistryOptions {
+    /**
+     * Whether to enable strict mode.
+     * In strict mode, duplicate command names cause an error.
+     * In non-strict mode, the later registration wins with a warning.
+     */
+    strict?: boolean;
+    /**
+     * Base directory for auto-discovery.
+     * Defaults to the `commands/` directory relative to the framework.
+     */
+    commandsDir?: string;
+    /**
+     * File pattern for auto-discovery.
+     * Defaults to files ending in `.command.ts` or `.command.js`.
+     * Set to `*` to discover all .ts/.js files.
+     */
+    filePattern?: RegExp;
+}
+/**
+ * Metadata about a registered command for introspection.
+ */
+export interface RegisteredCommand {
+    definition: CommandDefinition;
+    hooks: CommandHook[];
+    registeredAt: Date;
+}
+export declare class CommandRegistry {
+    private commands;
+    private globalHooks;
+    private options;
+    constructor(options?: RegistryOptions);
+    /**
+     * Register a single command definition.
+     *
+     * @param definition - The command to register
+     * @param hooks - Optional lifecycle hooks for this command
+     * @throws Error in strict mode if command name is already registered
+     */
+    register(definition: CommandDefinition, hooks?: CommandHook[]): void;
+    /**
+     * Register a command module (definition + hooks bundle).
+     */
+    registerModule(mod: CommandModule): void;
+    /**
+     * Register a global hook that runs for all commands.
+     */
+    registerGlobalHook(hook: CommandHook): void;
+    /**
+     * Remove a registered command.
+     */
+    unregister(name: string): boolean;
+    /**
+     * Discover and register commands from a directory.
+     *
+     * Scans the directory for files matching the configured pattern.
+     * Each file should export either:
+     * - A `module` property conforming to `CommandModule`
+     * - A `command` property conforming to `CommandDefinition`
+     * - A default export conforming to `CommandDefinition`
+     *
+     * @param directory - Directory to scan. Defaults to configured commandsDir.
+     * @returns Number of commands discovered and registered.
+     */
+    discoverCommands(directory?: string): Promise<number>;
+    /**
+     * Discover commands from multiple directories.
+     *
+     * @param directories - Array of directory paths to scan
+     * @returns Total number of commands discovered
+     */
+    discoverFromDirectories(directories: string[]): Promise<number>;
+    /**
+     * Get a registered command by name.
+     */
+    get(name: string): CommandDefinition | undefined;
+    /**
+     * Find a command by name or alias.
+     * Searches direct name first, then aliases.
+     */
+    findByNameOrAlias(nameOrAlias: string): CommandDefinition | undefined;
+    /**
+     * Check if a command is registered.
+     */
+    has(name: string): boolean;
+    /**
+     * List all registered commands, optionally filtered by category.
+     */
+    list(category?: CommandCategory): CommandDefinition[];
+    /**
+     * List all registered command names.
+     */
+    names(): string[];
+    /**
+     * Get commands grouped by category.
+     */
+    grouped(): Map<CommandCategory | 'uncategorized', CommandDefinition[]>;
+    /**
+     * Get all command names for shell completion.
+     */
+    getCompletionWords(): string[];
+    /**
+     * Build a Commander.js program from all registered commands.
+     *
+     * This is the bridge between the registry's CommandDefinition world
+     * and Commander.js's imperative API. Call this once after all commands
+     * are registered.
+     *
+     * @param program - The root Commander.js Command instance
+     * @param contextFactory - Factory that creates a CommandContext for each invocation
+     */
+    buildProgram(program: Command, contextFactory: (globalOpts: GlobalOptions) => CommandContext): void;
+    /**
+     * Build a single Commander.Command from a CommandDefinition.
+     */
+    private buildCommand;
+    /**
+     * Generate a bash completion script.
+     */
+    generateBashCompletion(programName?: string): string;
+    /**
+     * Generate a zsh completion script.
+     */
+    generateZshCompletion(programName?: string): string;
+    /**
+     * Load a module from a file path. Handles both ESM and CJS.
+     */
+    private loadModule;
+    /**
+     * Validate a command definition at registration time.
+     */
+    private validateDefinition;
+    /**
+     * Run hooks for a specific phase.
+     */
+    private runHooks;
+    /**
+     * Handle a CommandResult by formatting output appropriately.
+     */
+    private handleResult;
+    /**
+     * Convert Commander.js flag specification to a camelCase option name.
+     * e.g., '-p, --port <number>' -> 'port'
+     * e.g., '--dry-run' -> 'dryRun'
+     */
+    private flagsToOptionName;
+    /**
+     * Generate bash case clauses for subcommand completion.
+     */
+    private generateBashCaseClauses;
+    /**
+     * Generate zsh case clauses for subcommand completion.
+     */
+    private generateZshCaseClauses;
+}
+//# sourceMappingURL=command-registry.d.ts.map

package/dist/framework/command-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../../src/framework/command-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,eAAe,EACf,cAAc,EAGd,aAAa,EACd,MAAM,qBAAqB,CAAC;AAO7B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,YAAY,EAAE,IAAI,CAAC;CACpB;AAMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAA6C;IAC7D,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,OAAO,CAA4B;gBAE/B,OAAO,GAAE,eAAoB;IAazC;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,iBAAiB,EAAE,KAAK,GAAE,WAAW,EAAO,GAAG,IAAI;IAoCxE;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAIxC;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAI3C;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQjC;;;;;;;;;;;OAWG;IACG,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuE3D;;;;;OAKG;IACG,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAYrE;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIhD;;;OAGG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAgBrE;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,iBAAiB,EAAE;IAUrD;;OAEG;IACH,KAAK,IAAI,MAAM,EAAE;IAIjB;;OAEG;IACH,OAAO,IAAI,GAAG,CAAC,eAAe,GAAG,eAAe,EAAE,iBAAiB,EAAE,CAAC;IAgBtE;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAsB9B;;;;;;;;;OASG;IACH,YAAY,CACV,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,CAAC,UAAU,EAAE,aAAa,KAAK,cAAc,GAC5D,IAAI;IA0BP;;OAEG;IACH,OAAO,CAAC,YAAY;IAiQpB;;OAEG;IACH,sBAAsB,CAAC,WAAW,GAAE,MAAgB,GAAG,MAAM;IA6B7D;;OAEG;IACH,qBAAqB,CAAC,WAAW,GAAE,MAAgB,GAAG,MAAM;IAiD5D;;OAEG;YACW,UAAU;IAUxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;OAEG;YACW,QAAQ;IAwBtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAqCpB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAkC/B;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAoC/B"}