@wundr.io/cli 1.0.12 → 1.0.14

package/dist/framework/index.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Wundr CLI Framework - Public API
+ *
+ * This module provides the core framework for building CLI commands:
+ *
+ * - **CommandDefinition**: The interface every command implements
+ * - **CommandRegistry**: Auto-discovery and Commander.js integration
+ * - **OutputFormatter**: Consistent table, JSON, YAML, status, progress output
+ * - **CliErrorHandler**: Typed errors with classification and recovery
+ * - **InteractiveRepl**: REPL loop with history, aliases, and tab completion
+ * - **HelpGenerator**: Structured help text from command metadata
+ * - **CompletionExporter**: Shell completion script generation
+ * - **DebugLogger**: Verbose/debug logging with TTY detection
+ * - **ProgressBar / StepTracker**: Progress tracking for long operations
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   CommandDefinition,
+ *   CommandRegistry,
+ *   OutputFormatter,
+ *   CliErrorHandler,
+ *   InteractiveRepl,
+ *   HelpGenerator,
+ *   CompletionExporter,
+ *   DebugLogger,
+ *   ProgressBar,
+ *   StepTracker,
+ *   commandSuccess,
+ *   commandFailure,
+ *   validationOk,
+ *   validationFail,
+ * } from './framework';
+ *
+ * const myCommand: CommandDefinition = {
+ *   name: 'status',
+ *   description: 'Show system status',
+ *   category: 'daemon',
+ *   async execute(args, options, context) {
+ *     const data = await getStatus();
+ *     const formatter = new OutputFormatter();
+ *     const message = formatter.keyValue(data);
+ *     return commandSuccess(data, message);
+ *   },
+ * };
+ *
+ * const registry = new CommandRegistry();
+ * registry.register(myCommand);
+ * ```
+ *
+ * @module framework
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StepTracker = exports.MultiProgressManager = exports.ProgressBar = exports.TaggedLogger = exports.DebugLogger = exports.CompletionExporter = exports.HelpGenerator = exports.InteractiveRepl = exports.classifyAnyError = exports.classifyError = exports.CliError = exports.CliErrorHandler = exports.OutputFormatter = exports.CommandRegistry = exports.wrapLegacyCommand = exports.commandFailure = exports.commandSuccess = exports.validationFail = exports.validationOk = exports.CATEGORY_LABELS = void 0;
+// Command Interface - Types and contracts
+var command_interface_1 = require("./command-interface");
+Object.defineProperty(exports, "CATEGORY_LABELS", { enumerable: true, get: function () { return command_interface_1.CATEGORY_LABELS; } });
+Object.defineProperty(exports, "validationOk", { enumerable: true, get: function () { return command_interface_1.validationOk; } });
+Object.defineProperty(exports, "validationFail", { enumerable: true, get: function () { return command_interface_1.validationFail; } });
+Object.defineProperty(exports, "commandSuccess", { enumerable: true, get: function () { return command_interface_1.commandSuccess; } });
+Object.defineProperty(exports, "commandFailure", { enumerable: true, get: function () { return command_interface_1.commandFailure; } });
+// Legacy adapter
+Object.defineProperty(exports, "wrapLegacyCommand", { enumerable: true, get: function () { return command_interface_1.wrapLegacyCommand; } });
+// Command Registry
+var command_registry_1 = require("./command-registry");
+Object.defineProperty(exports, "CommandRegistry", { enumerable: true, get: function () { return command_registry_1.CommandRegistry; } });
+// Output Formatter
+var output_formatter_1 = require("./output-formatter");
+Object.defineProperty(exports, "OutputFormatter", { enumerable: true, get: function () { return output_formatter_1.OutputFormatter; } });
+// Error Handler
+var error_handler_1 = require("./error-handler");
+Object.defineProperty(exports, "CliErrorHandler", { enumerable: true, get: function () { return error_handler_1.CliErrorHandler; } });
+Object.defineProperty(exports, "CliError", { enumerable: true, get: function () { return error_handler_1.CliError; } });
+Object.defineProperty(exports, "classifyError", { enumerable: true, get: function () { return error_handler_1.classifyError; } });
+Object.defineProperty(exports, "classifyAnyError", { enumerable: true, get: function () { return error_handler_1.classifyAnyError; } });
+// Interactive REPL
+var interactive_repl_1 = require("./interactive-repl");
+Object.defineProperty(exports, "InteractiveRepl", { enumerable: true, get: function () { return interactive_repl_1.InteractiveRepl; } });
+// Help Generator
+var help_generator_1 = require("./help-generator");
+Object.defineProperty(exports, "HelpGenerator", { enumerable: true, get: function () { return help_generator_1.HelpGenerator; } });
+// Completion Exporter
+var completion_exporter_1 = require("./completion-exporter");
+Object.defineProperty(exports, "CompletionExporter", { enumerable: true, get: function () { return completion_exporter_1.CompletionExporter; } });
+// Debug Logger
+var debug_logger_1 = require("./debug-logger");
+Object.defineProperty(exports, "DebugLogger", { enumerable: true, get: function () { return debug_logger_1.DebugLogger; } });
+Object.defineProperty(exports, "TaggedLogger", { enumerable: true, get: function () { return debug_logger_1.TaggedLogger; } });
+// Progress Manager
+var progress_manager_1 = require("./progress-manager");
+Object.defineProperty(exports, "ProgressBar", { enumerable: true, get: function () { return progress_manager_1.ProgressBar; } });
+Object.defineProperty(exports, "MultiProgressManager", { enumerable: true, get: function () { return progress_manager_1.MultiProgressManager; } });
+Object.defineProperty(exports, "StepTracker", { enumerable: true, get: function () { return progress_manager_1.StepTracker; } });
+//# sourceMappingURL=index.js.map

package/dist/framework/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/framework/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;;;AAEH,0CAA0C;AAC1C,yDAmC6B;AAtB3B,oHAAA,eAAe,OAAA;AAKf,iHAAA,YAAY,OAAA;AACZ,mHAAA,cAAc,OAAA;AAWd,mHAAA,cAAc,OAAA;AACd,mHAAA,cAAc,OAAA;AAEd,iBAAiB;AACjB,sHAAA,iBAAiB,OAAA;AAGnB,mBAAmB;AACnB,uDAI4B;AAH1B,mHAAA,eAAe,OAAA;AAKjB,mBAAmB;AACnB,uDAW4B;AAV1B,mHAAA,eAAe,OAAA;AAYjB,gBAAgB;AAChB,iDAWyB;AAVvB,gHAAA,eAAe,OAAA;AACf,yGAAA,QAAQ,OAAA;AAOR,8GAAA,aAAa,OAAA;AACb,iHAAA,gBAAgB,OAAA;AAGlB,mBAAmB;AACnB,uDAI4B;AAH1B,mHAAA,eAAe,OAAA;AAKjB,iBAAiB;AACjB,mDAI0B;AAHxB,+GAAA,aAAa,OAAA;AAKf,sBAAsB;AACtB,6DAO+B;AAN7B,yHAAA,kBAAkB,OAAA;AAQpB,eAAe;AACf,+CAMwB;AALtB,2GAAA,WAAW,OAAA;AACX,4GAAA,YAAY,OAAA;AAMd,mBAAmB;AACnB,uDAQ4B;AAP1B,+GAAA,WAAW,OAAA;AACX,wHAAA,oBAAoB,OAAA;AACpB,+GAAA,WAAW,OAAA"}

package/dist/framework/interactive-repl.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Interactive REPL - Read-Eval-Print Loop for the CLI.
+ *
+ * Provides:
+ * - Interactive command entry with readline
+ * - Command history with persistence
+ * - Tab completion for commands and options
+ * - Command aliases and shortcuts
+ * - Session context preservation
+ * - Graceful exit handling
+ *
+ * @module framework/interactive-repl
+ */
+import type { CommandContext, GlobalOptions } from './command-interface';
+import type { CommandRegistry } from './command-registry';
+/**
+ * Configuration for the REPL.
+ */
+export interface ReplOptions {
+    /** Prompt string. Defaults to 'wundr> '. */
+    prompt?: string;
+    /** Path for persisting command history. */
+    historyFile?: string;
+    /** Maximum number of history entries. Defaults to 500. */
+    maxHistory?: number;
+    /** Whether to enable tab completion. Defaults to true. */
+    tabCompletion?: boolean;
+    /** Custom aliases mapping short forms to full commands. */
+    aliases?: Record<string, string>;
+    /** Welcome message shown on start. */
+    welcomeMessage?: string;
+    /** Factory to create a CommandContext for each command invocation. */
+    contextFactory?: (globalOpts: GlobalOptions) => CommandContext;
+}
+/**
+ * Command history entry.
+ */
+export interface HistoryEntry {
+    command: string;
+    timestamp: Date;
+    success: boolean;
+    duration?: number;
+}
+export declare class InteractiveRepl {
+    private registry;
+    private rl;
+    private running;
+    private history;
+    private prompt;
+    private historyFile;
+    private maxHistory;
+    private aliases;
+    private tabCompletion;
+    private contextFactory?;
+    constructor(registry: CommandRegistry, options?: ReplOptions);
+    /**
+     * Start the REPL loop.
+     */
+    start(welcomeMessage?: string): Promise<void>;
+    /**
+     * Stop the REPL.
+     */
+    stop(): void;
+    /**
+     * Process a single input line.
+     */
+    private handleLine;
+    /**
+     * Handle built-in REPL commands.
+     * Returns true if the input was a built-in command.
+     */
+    private handleBuiltinCommand;
+    /**
+     * Execute a resolved command.
+     */
+    private executeCommand;
+    /**
+     * Readline completer function.
+     */
+    private completer;
+    /**
+     * Record a command in history.
+     */
+    private recordHistory;
+    /**
+     * Load history from file.
+     */
+    private loadHistory;
+    /**
+     * Save history to file.
+     */
+    private saveHistory;
+    /**
+     * Show command history.
+     */
+    private showHistory;
+    /**
+     * Resolve an alias to the full command.
+     */
+    private resolveAlias;
+    /**
+     * Register a new alias.
+     */
+    addAlias(alias: string, command: string): void;
+    /**
+     * Get all registered aliases.
+     */
+    getAliases(): Readonly<Record<string, string>>;
+    /**
+     * Show registered aliases.
+     */
+    private showAliases;
+    /**
+     * Show REPL help.
+     */
+    private showHelp;
+    /**
+     * Find a command by name or alias.
+     */
+    private findCommand;
+    /**
+     * Suggest similar command names.
+     */
+    private suggestCommands;
+    /**
+     * Parse input respecting quoted strings.
+     */
+    private parseInput;
+    /**
+     * Convert kebab-case to camelCase.
+     */
+    private camelCase;
+    /**
+     * Simple Levenshtein distance.
+     */
+    private levenshtein;
+}
+//# sourceMappingURL=interactive-repl.d.ts.map

package/dist/framework/interactive-repl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-repl.d.ts","sourceRoot":"","sources":["../../src/framework/interactive-repl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,OAAO,KAAK,EACV,cAAc,EAEd,aAAa,EACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAM1D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,sEAAsE;IACtE,cAAc,CAAC,EAAE,CAAC,UAAU,EAAE,aAAa,KAAK,cAAc,CAAC;CAChE;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAoBD,qBAAa,eAAe;IAYxB,OAAO,CAAC,QAAQ;IAXlB,OAAO,CAAC,EAAE,CAAmC;IAC7C,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,cAAc,CAAC,CAAgD;gBAG7D,QAAQ,EAAE,eAAe,EACjC,OAAO,GAAE,WAAgB;IAe3B;;OAEG;IACG,KAAK,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+DnD;;OAEG;IACH,IAAI,IAAI,IAAI;IAkBZ;;OAEG;YACW,UAAU;IA+CxB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAgC5B;;OAEG;YACW,cAAc;IAgF5B;;OAEG;IACH,OAAO,CAAC,SAAS;IAmDjB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAgBnB;;OAEG;IACH,OAAO,CAAC,WAAW;IAiBnB;;OAEG;IACH,OAAO,CAAC,WAAW;IAsBnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9C;;OAEG;IACH,UAAU,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI9C;;OAEG;IACH,OAAO,CAAC,WAAW;IAanB;;OAEG;IACH,OAAO,CAAC,QAAQ;IA2ChB;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,OAAO,CAAC,UAAU;IA8BlB;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,WAAW;CA0BpB"}