monomind 2.7.12 → 2.7.14

package/packages/@monomind/cli/dist/src/output.js

@@ -1,529 +0,0 @@
-/**
- * CLI Output Formatter
- * Advanced output formatting with tables, progress bars, and colors
- */
-// ============================================
-// Color Support
-// ============================================
-const COLORS = {
-    // Standard colors
-    reset: '\x1b[0m',
-    bold: '\x1b[1m',
-    dim: '\x1b[2m',
-    italic: '\x1b[3m',
-    underline: '\x1b[4m',
-    // Foreground colors
-    black: '\x1b[30m',
-    red: '\x1b[31m',
-    green: '\x1b[32m',
-    yellow: '\x1b[33m',
-    blue: '\x1b[34m',
-    magenta: '\x1b[35m',
-    cyan: '\x1b[36m',
-    white: '\x1b[37m',
-    gray: '\x1b[90m',
-    // Bright foreground colors
-    brightRed: '\x1b[91m',
-    brightGreen: '\x1b[92m',
-    brightYellow: '\x1b[93m',
-    brightBlue: '\x1b[94m',
-    brightMagenta: '\x1b[95m',
-    brightCyan: '\x1b[96m',
-    brightWhite: '\x1b[97m',
-    // Background colors
-    bgBlack: '\x1b[40m',
-    bgRed: '\x1b[41m',
-    bgGreen: '\x1b[42m',
-    bgYellow: '\x1b[43m',
-    bgBlue: '\x1b[44m',
-    bgMagenta: '\x1b[45m',
-    bgCyan: '\x1b[46m',
-    bgWhite: '\x1b[47m'
-};
-export class OutputFormatter {
-    colorEnabled;
-    outputStream;
-    errorStream;
-    verbosity;
-    constructor(options = {}) {
-        this.colorEnabled = options.color ?? this.supportsColor();
-        this.outputStream = process.stdout;
-        this.errorStream = process.stderr;
-        this.verbosity = options.verbosity ?? 'normal';
-    }
-    /**
-     * Set verbosity level
-     * - quiet: Only errors and direct results
-     * - normal: Errors, warnings, info, and results
-     * - verbose: All of normal + debug messages
-     * - debug: All output including trace
-     */
-    setVerbosity(level) {
-        this.verbosity = level;
-    }
-    getVerbosity() {
-        return this.verbosity;
-    }
-    isQuiet() {
-        return this.verbosity === 'quiet';
-    }
-    isVerbose() {
-        return this.verbosity === 'verbose' || this.verbosity === 'debug';
-    }
-    isDebug() {
-        return this.verbosity === 'debug';
-    }
-    supportsColor() {
-        // Check for NO_COLOR environment variable
-        if (process.env.NO_COLOR !== undefined)
-            return false;
-        // Check for FORCE_COLOR environment variable.
-        // Per the supports-color convention, FORCE_COLOR=0 (or "false") forces
-        // color OFF; any other defined, non-empty value forces color ON.
-        if (process.env.FORCE_COLOR !== undefined) {
-            return process.env.FORCE_COLOR !== '0' && process.env.FORCE_COLOR !== 'false';
-        }
-        // Check if stdout is a TTY
-        return process.stdout.isTTY ?? false;
-    }
-    // ============================================
-    // Color Methods
-    // ============================================
-    color(text, ...colors) {
-        if (!this.colorEnabled)
-            return text;
-        const codes = colors.map(c => COLORS[c]).join('');
-        return `${codes}${text}${COLORS.reset}`;
-    }
-    bold(text) {
-        return this.color(text, 'bold');
-    }
-    dim(text) {
-        return this.color(text, 'dim');
-    }
-    success(text) {
-        return this.color(text, 'green');
-    }
-    error(text) {
-        return this.color(text, 'red');
-    }
-    warning(text) {
-        return this.color(text, 'yellow');
-    }
-    info(text) {
-        return this.color(text, 'blue');
-    }
-    highlight(text) {
-        return this.color(text, 'cyan', 'bold');
-    }
-    // ============================================
-    // Output Methods
-    // ============================================
-    write(text) {
-        this.outputStream.write(text);
-    }
-    writeln(text = '') {
-        this.outputStream.write(text + '\n');
-    }
-    writeError(text) {
-        this.errorStream.write(text);
-    }
-    writeErrorln(text = '') {
-        this.errorStream.write(text + '\n');
-    }
-    // ============================================
-    // Formatted Output Methods
-    // ============================================
-    printSuccess(message) {
-        // Success always shows (result output)
-        const icon = this.color('[OK]', 'green', 'bold');
-        this.writeln(`${icon} ${message}`);
-    }
-    printError(message, details) {
-        // Errors always show
-        const icon = this.color('[ERROR]', 'red', 'bold');
-        this.writeErrorln(`${icon} ${message}`);
-        if (details) {
-            this.writeErrorln(this.dim(`  ${details}`));
-        }
-    }
-    printWarning(message) {
-        // Warnings suppressed in quiet mode
-        if (this.verbosity === 'quiet')
-            return;
-        const icon = this.color('[WARN]', 'yellow', 'bold');
-        // Write to stderr (not stdout) so it never interleaves with structured
-        // stdout output (e.g. --format json | jq .)
-        this.writeErrorln(`${icon} ${message}`);
-    }
-    printInfo(message) {
-        // Info suppressed in quiet mode
-        if (this.verbosity === 'quiet')
-            return;
-        const icon = this.color('[INFO]', 'blue', 'bold');
-        // Write to stderr (not stdout) so it never interleaves with structured
-        // stdout output (e.g. --format json | jq .)
-        this.writeErrorln(`${icon} ${message}`);
-    }
-    printDebug(message) {
-        // Debug only shows in verbose/debug mode
-        if (this.verbosity !== 'verbose' && this.verbosity !== 'debug')
-            return;
-        const icon = this.color('[DEBUG]', 'gray');
-        this.writeln(`${icon} ${this.dim(message)}`);
-    }
-    printTrace(message) {
-        // Trace only shows in debug mode
-        if (this.verbosity !== 'debug')
-            return;
-        const icon = this.color('[TRACE]', 'gray', 'dim');
-        this.writeln(`${icon} ${this.dim(message)}`);
-    }
-    // ============================================
-    // Table Formatting
-    // ============================================
-    table(options) {
-        const { columns, data, border = true, header = true, padding = 1, maxWidth } = options;
-        // Calculate column widths
-        const widths = this.calculateColumnWidths(columns, data, maxWidth);
-        const lines = [];
-        const pad = ' '.repeat(padding);
-        // Border characters
-        const borderChars = border ? {
-            topLeft: '+', topRight: '+', bottomLeft: '+', bottomRight: '+',
-            horizontal: '-', vertical: '|',
-            leftT: '+', rightT: '+', topT: '+', bottomT: '+', cross: '+'
-        } : {
-            topLeft: '', topRight: '', bottomLeft: '', bottomRight: '',
-            horizontal: '', vertical: ' ',
-            leftT: '', rightT: '', topT: '', bottomT: '', cross: ''
-        };
-        // Top border
-        if (border) {
-            lines.push(this.createBorderLine(widths, borderChars, 'top', padding));
-        }
-        // Header row
-        if (header) {
-            const headerRow = columns.map((col, i) => {
-                const text = this.truncate(col.header, widths[i]);
-                return pad + this.alignText(this.bold(text), widths[i], col.align) + pad;
-            }).join(borderChars.vertical);
-            lines.push(`${borderChars.vertical}${headerRow}${borderChars.vertical}`);
-            // Header separator
-            if (border) {
-                lines.push(this.createBorderLine(widths, borderChars, 'middle', padding));
-            }
-        }
-        // Data rows
-        for (const row of data) {
-            const rowCells = columns.map((col, i) => {
-                let value = row[col.key];
-                // Apply formatter if provided
-                if (col.format) {
-                    value = col.format(value);
-                }
-                else {
-                    value = String(value ?? '');
-                }
-                const text = this.truncate(String(value), widths[i]);
-                return pad + this.alignText(text, widths[i], col.align) + pad;
-            }).join(borderChars.vertical);
-            lines.push(`${borderChars.vertical}${rowCells}${borderChars.vertical}`);
-        }
-        // Bottom border
-        if (border) {
-            lines.push(this.createBorderLine(widths, borderChars, 'bottom', padding));
-        }
-        return lines.join('\n');
-    }
-    printTable(options) {
-        this.writeln(this.table(options));
-    }
-    calculateColumnWidths(columns, data, maxWidth) {
-        const widths = columns.map((col, i) => {
-            // Start with header width
-            let width = col.header.length;
-            // Check all data values
-            for (const row of data) {
-                let value = row[col.key];
-                if (col.format) {
-                    value = col.format(value);
-                }
-                const len = this.stripAnsi(String(value ?? '')).length;
-                width = Math.max(width, len);
-            }
-            // Apply column-specific width limit
-            if (col.width) {
-                width = Math.min(width, col.width);
-            }
-            return width;
-        });
-        // Apply max width constraint
-        if (maxWidth) {
-            const totalWidth = widths.reduce((a, b) => a + b, 0) + (columns.length * 3) + 1;
-            if (totalWidth > maxWidth) {
-                const reduction = (totalWidth - maxWidth) / columns.length;
-                return widths.map(w => Math.max(3, Math.floor(w - reduction)));
-            }
-        }
-        return widths;
-    }
-    createBorderLine(widths, chars, position, padding) {
-        const cellWidth = (w) => chars.horizontal.repeat(w + (padding * 2));
-        const cells = widths.map(cellWidth).join(position === 'top' ? chars.topT :
-            position === 'bottom' ? chars.bottomT :
-                chars.cross);
-        const left = position === 'top' ? chars.topLeft : position === 'bottom' ? chars.bottomLeft : chars.leftT;
-        const right = position === 'top' ? chars.topRight : position === 'bottom' ? chars.bottomRight : chars.rightT;
-        return `${left}${cells}${right}`;
-    }
-    alignText(text, width, align = 'left') {
-        const len = this.stripAnsi(text).length;
-        const padding = width - len;
-        if (padding <= 0)
-            return text;
-        switch (align) {
-            case 'right':
-                return ' '.repeat(padding) + text;
-            case 'center':
-                const left = Math.floor(padding / 2);
-                const right = padding - left;
-                return ' '.repeat(left) + text + ' '.repeat(right);
-            default:
-                return text + ' '.repeat(padding);
-        }
-    }
-    truncate(text, maxLength) {
-        const stripped = this.stripAnsi(text);
-        if (stripped.length <= maxLength)
-            return text;
-        return stripped.slice(0, maxLength - 3) + '...';
-    }
-    stripAnsi(text) {
-        return text.replace(/\x1b\[[0-9;]*m/g, '');
-    }
-    // ============================================
-    // Progress Bar
-    // ============================================
-    createProgress(options) {
-        return new Progress(this, options);
-    }
-    progressBar(current, total, width = 40) {
-        const percent = Math.min(100, Math.max(0, (current / total) * 100));
-        const filled = Math.round((width * percent) / 100);
-        const empty = width - filled;
-        const bar = this.color('#'.repeat(filled), 'green') +
-            this.dim('-'.repeat(empty));
-        return `[${bar}] ${percent.toFixed(1)}%`;
-    }
-    // ============================================
-    // Spinner
-    // ============================================
-    createSpinner(options) {
-        return new Spinner(this, options);
-    }
-    // ============================================
-    // JSON Output
-    // ============================================
-    json(data, pretty = true) {
-        return pretty ? JSON.stringify(data, null, 2) : JSON.stringify(data);
-    }
-    printJson(data, pretty = true) {
-        this.writeln(this.json(data, pretty));
-    }
-    // ============================================
-    // List Output
-    // ============================================
-    list(items, bullet = '-') {
-        return items.map(item => `  ${bullet} ${item}`).join('\n');
-    }
-    printList(items, bullet = '-') {
-        this.writeln(this.list(items, bullet));
-    }
-    numberedList(items) {
-        return items.map((item, i) => `  ${i + 1}. ${item}`).join('\n');
-    }
-    printNumberedList(items) {
-        this.writeln(this.numberedList(items));
-    }
-    // ============================================
-    // Box Output
-    // ============================================
-    box(content, title) {
-        const lines = content.split('\n');
-        const maxLen = Math.max(...lines.map(l => this.stripAnsi(l).length), title?.length ?? 0);
-        const width = maxLen + 4;
-        const border = {
-            topLeft: '+', topRight: '+',
-            bottomLeft: '+', bottomRight: '+',
-            horizontal: '-', vertical: '|'
-        };
-        const result = [];
-        // Top border with optional title
-        if (title) {
-            const titleText = ` ${title} `;
-            const leftPad = Math.floor((width - titleText.length - 2) / 2);
-            const rightPad = width - titleText.length - leftPad - 2;
-            result.push(border.topLeft +
-                border.horizontal.repeat(leftPad) +
-                this.bold(titleText) +
-                border.horizontal.repeat(rightPad) +
-                border.topRight);
-        }
-        else {
-            result.push(border.topLeft + border.horizontal.repeat(width - 2) + border.topRight);
-        }
-        // Content lines
-        for (const line of lines) {
-            const stripped = this.stripAnsi(line);
-            const padding = maxLen - stripped.length;
-            result.push(`${border.vertical} ${line}${' '.repeat(padding)} ${border.vertical}`);
-        }
-        // Bottom border
-        result.push(border.bottomLeft + border.horizontal.repeat(width - 2) + border.bottomRight);
-        return result.join('\n');
-    }
-    printBox(content, title) {
-        this.writeln(this.box(content, title));
-    }
-    setColorEnabled(enabled) {
-        this.colorEnabled = enabled;
-    }
-    isColorEnabled() {
-        return this.colorEnabled;
-    }
-}
-// ============================================
-// Progress Class
-// ============================================
-export class Progress {
-    current;
-    total;
-    width;
-    startTime;
-    formatter;
-    showPercentage;
-    showETA;
-    lastRender = '';
-    constructor(formatter, options) {
-        this.formatter = formatter;
-        this.current = options.current ?? 0;
-        this.total = options.total;
-        this.width = options.width ?? 40;
-        this.showPercentage = options.showPercentage ?? true;
-        this.showETA = options.showETA ?? true;
-        this.startTime = Date.now();
-    }
-    update(current) {
-        this.current = current;
-        this.render();
-    }
-    increment(amount = 1) {
-        this.update(this.current + amount);
-    }
-    render() {
-        const bar = this.formatter.progressBar(this.current, this.total, this.width);
-        let output = bar;
-        if (this.showETA && this.current > 0) {
-            const elapsed = Date.now() - this.startTime;
-            const rate = this.current / elapsed;
-            const remaining = this.total - this.current;
-            const eta = remaining / rate;
-            if (isFinite(eta)) {
-                output += ` ETA: ${this.formatTime(eta)}`;
-            }
-        }
-        // Clear previous line and write new
-        if (this.lastRender) {
-            process.stdout.write('\r' + ' '.repeat(this.lastRender.length) + '\r');
-        }
-        process.stdout.write(output);
-        this.lastRender = output;
-    }
-    finish() {
-        this.current = this.total;
-        this.render();
-        process.stdout.write('\n');
-    }
-    formatTime(ms) {
-        const seconds = Math.floor(ms / 1000);
-        const minutes = Math.floor(seconds / 60);
-        const hours = Math.floor(minutes / 60);
-        if (hours > 0) {
-            return `${hours}h ${minutes % 60}m`;
-        }
-        else if (minutes > 0) {
-            return `${minutes}m ${seconds % 60}s`;
-        }
-        else {
-            return `${seconds}s`;
-        }
-    }
-}
-// ============================================
-// Spinner Class
-// ============================================
-export class Spinner {
-    formatter;
-    text;
-    frames;
-    interval = null;
-    frameIndex = 0;
-    static SPINNERS = {
-        dots: ['...', '..:', '.::', ':::', '::.', ':..',],
-        line: ['-', '\\', '|', '/'],
-        arc: ['◜', '◠', '◝', '◞', '◡', '◟'],
-        circle: ['◐', '◓', '◑', '◒'],
-        arrows: ['←', '↖', '↑', '↗', '→', '↘', '↓', '↙']
-    };
-    constructor(formatter, options) {
-        this.formatter = formatter;
-        this.text = options.text;
-        this.frames = Spinner.SPINNERS[options.spinner ?? 'dots'];
-    }
-    start() {
-        if (this.interval)
-            return;
-        // `\r`-based in-place redraw only works on a real TTY. Without one
-        // (piped output, CI logs, non-interactive terminals) each animation
-        // frame prints as its own line instead of overwriting the last —
-        // so print the text once and skip the animation entirely.
-        if (!process.stdout.isTTY) {
-            process.stdout.write(`${this.text}\n`);
-            return;
-        }
-        this.interval = setInterval(() => {
-            this.render();
-            this.frameIndex = (this.frameIndex + 1) % this.frames.length;
-        }, 100);
-        this.interval.unref();
-        this.render();
-    }
-    stop(message) {
-        if (this.interval) {
-            clearInterval(this.interval);
-            this.interval = null;
-            // Clear the line (only meaningful when the animation actually ran on a TTY)
-            process.stdout.write('\r' + ' '.repeat(this.text.length + 10) + '\r');
-        }
-        if (message) {
-            this.formatter.writeln(message);
-        }
-    }
-    succeed(message) {
-        this.stop(this.formatter.success(message ?? this.text));
-    }
-    fail(message) {
-        this.stop(this.formatter.error(message ?? this.text));
-    }
-    render() {
-        const frame = this.formatter.info(this.frames[this.frameIndex]);
-        process.stdout.write(`\r${frame} ${this.text}`);
-    }
-    setText(text) {
-        this.text = text;
-    }
-}
-// Export singleton instance
-export const output = new OutputFormatter();
-//# sourceMappingURL=output.js.map

package/packages/@monomind/cli/dist/src/parser.d.ts

@@ -1,93 +0,0 @@
-/**
- * CLI Command Parser
- * Advanced argument parsing with validation and type coercion
- */
-import type { Command, CommandOption, ParsedFlags } from './types.js';
-export interface ParseResult {
-    command: string[];
-    flags: ParsedFlags;
-    positional: string[];
-    raw: string[];
-}
-export interface ParserOptions {
-    stopAtFirstNonFlag?: boolean;
-    allowUnknownFlags?: boolean;
-    booleanFlags?: string[];
-    stringFlags?: string[];
-    arrayFlags?: string[];
-    aliases?: Record<string, string>;
-    defaults?: Record<string, unknown>;
-}
-export declare class CommandParser {
-    private options;
-    private commands;
-    private globalOptions;
-    constructor(options?: ParserOptions);
-    private initializeGlobalOptions;
-    registerCommand(command: Command): void;
-    getCommand(name: string): Command | undefined;
-    getAllCommands(): Command[];
-    /**
-     * Reserved keys that would either pollute the prototype chain (`__proto__`,
-     * `constructor`, `prototype`) or shadow `Object.prototype` methods that
-     * downstream consumers commonly call (`hasOwnProperty`, `toString`,
-     * `valueOf`, `isPrototypeOf`, `propertyIsEnumerable`). All are rejected.
-     */
-    private static readonly RESERVED_FLAG_KEYS;
-    private setFlagSafe;
-    /**
-     * Merge a single parsed flag (or set of `_` positionals) into the
-     * accumulated result flags, collecting repeats into an array instead of
-     * overwriting. Declared `type: 'array'` options always end up as an array
-     * (even a single occurrence); any other repeated flag also becomes an
-     * array on its second occurrence rather than silently dropping the first
-     * value.
-     */
-    private mergeParsedFlags;
-    parse(args: string[]): ParseResult;
-    /**
-     * Convert a camelCase key to kebab-case (inverse of normalizeKey).
-     */
-    private camelToKebab;
-    /**
-     * Ensure every flag is reachable under both its camelCase and
-     * kebab-case spelling. Runs once, after all flags (including
-     * defaults) have been merged into the result.
-     */
-    private mirrorFlagKeys;
-    /**
-     * True when `value` looks like a space-separated negative number
-     * (`-0.5`, `-42`) rather than a new flag. Scoped narrowly to "leading `-`
-     * immediately followed by a digit" — a legitimate flag name never starts
-     * with a digit, so this can't misfire on a genuine following flag while
-     * still letting `--threshold -0.5` consume `-0.5` as the value instead of
-     * being misparsed as a new (bogus) flag.
-     */
-    private looksLikeNegativeNumber;
-    private parseFlag;
-    private parseValue;
-    private normalizeKey;
-    private buildAliases;
-    /**
-     * Build aliases scoped to a specific command/subcommand.
-     * The resolved command's short flags take priority over global ones,
-     * fixing collisions where multiple subcommands use the same short flag (e.g. -t).
-     */
-    private buildScopedAliases;
-    /** Normalize a single command or a resolved chain into an array. */
-    private static asChain;
-    /**
-     * Get boolean flags scoped to a specific command/subcommand chain.
-     */
-    private getScopedBooleanFlags;
-    /**
-     * Get flags declared `type: 'array'`, scoped to a specific command/subcommand chain.
-     */
-    private getScopedArrayFlags;
-    private getBooleanFlags;
-    private applyDefaults;
-    validateFlags(flags: ParsedFlags, command?: Command): string[];
-    getGlobalOptions(): CommandOption[];
-}
-export declare const commandParser: CommandParser;
-//# sourceMappingURL=parser.d.ts.map