@adverant-nexus/cli 2.0.0

package/dist/index.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+/**
+ * Nexus CLI - Main Entry Point
+ *
+ * World-class CLI for Adverant-Nexus
+ * Surpassing Claude Code and Gemini CLI
+ */
+import chalk from 'chalk';
+import boxen from 'boxen';
+// @ts-ignore - no types available
+import updateNotifier from 'update-notifier';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { readFileSync } from 'fs';
+import { runCLI } from './cli.js';
+import { setupGlobalErrorHandlers } from './utils/error-handler.js';
+import { logger } from './utils/logger.js';
+// ESM compatibility for __dirname
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Display banner
+ */
+function displayBanner() {
+    const banner = chalk.cyan.bold(`
+╔═══════════════════════════════════════════════════════════════╗
+║                                                               ║
+║              🧠  Adverant-Nexus CLI v2.0.0                   ║
+║                                                               ║
+║     World-Class CLI for 32+ Microservices & 70+ AI Tools     ║
+║                                                               ║
+╚═══════════════════════════════════════════════════════════════╝
+  `);
+    console.log(banner);
+}
+/**
+ * Check for updates
+ */
+async function checkForUpdates() {
+    try {
+        // Read package.json for version info
+        const packageJsonPath = join(__dirname, '..', 'package.json');
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+        const notifier = updateNotifier({
+            pkg: packageJson,
+            updateCheckInterval: 1000 * 60 * 60 * 24, // 24 hours
+        });
+        if (notifier.update) {
+            const message = `
+Update available ${chalk.dim(notifier.update.current)} → ${chalk.green(notifier.update.latest)}
+
+Run ${chalk.cyan(`npm install -g ${packageJson.name}`)} to update
+      `;
+            console.log(boxen(message, {
+                padding: 1,
+                margin: 1,
+                borderStyle: 'round',
+                borderColor: 'yellow',
+            }));
+        }
+    }
+    catch (error) {
+        // Silently fail update check
+        logger.debug('Update check failed:', error);
+    }
+}
+/**
+ * Main entry point
+ */
+async function main() {
+    // Setup global error handlers first
+    setupGlobalErrorHandlers(process.argv.includes('--verbose') || process.argv.includes('-v'));
+    // Show banner unless --quiet or --no-banner
+    if (!process.argv.includes('--quiet') && !process.argv.includes('-q') && !process.argv.includes('--no-banner')) {
+        displayBanner();
+    }
+    // Check for updates (async, don't block)
+    checkForUpdates().catch(() => {
+        // Silently fail
+    });
+    // Handle special cases
+    const args = process.argv.slice(2);
+    // Show version
+    if (args.includes('--version') || args.includes('-V')) {
+        console.log('2.0.0');
+        process.exit(0);
+    }
+    // Show help
+    if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
+        // Will be handled by Commander
+    }
+    // Run CLI
+    try {
+        await runCLI();
+    }
+    catch (error) {
+        logger.error('CLI execution failed:', error);
+        process.exit(1);
+    }
+}
+// Execute main
+main().catch((error) => {
+    console.error(chalk.red.bold('Fatal error:'), error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/output/formatters/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Output Formatters Exports
+ */
+export * from './text-formatter.js';
+export * from './json-formatter.js';
+export * from './yaml-formatter.js';
+export * from './table-formatter.js';
+export * from './stream-formatter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/output/formatters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/output/formatters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/dist/output/formatters/index.js

@@ -0,0 +1,9 @@
+/**
+ * Output Formatters Exports
+ */
+export * from './text-formatter.js';
+export * from './json-formatter.js';
+export * from './yaml-formatter.js';
+export * from './table-formatter.js';
+export * from './stream-formatter.js';
+//# sourceMappingURL=index.js.map

package/dist/output/formatters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/output/formatters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/dist/output/formatters/json-formatter.d.ts

@@ -0,0 +1,71 @@
+/**
+ * JSON Formatter
+ *
+ * Machine-parseable JSON output formatting
+ */
+import type { OutputFormatter, FormatOptions, OutputFormat } from '../../types/output.js';
+export declare class JSONFormatter implements OutputFormatter {
+    readonly format: OutputFormat;
+    /**
+     * Format result as JSON
+     */
+    formatResult(result: any, options?: FormatOptions): string;
+    /**
+     * Check if formatter supports given format
+     */
+    supports(format: OutputFormat): boolean;
+    /**
+     * Format as compact JSON (single line)
+     */
+    formatCompact(result: any): string;
+    /**
+     * Format as pretty JSON (indented)
+     */
+    formatPretty(result: any, indent?: number): string;
+    /**
+     * Parse JSON string safely
+     */
+    parse<T = any>(jsonString: string): T | null;
+    /**
+     * Validate JSON string
+     */
+    isValid(jsonString: string): boolean;
+    /**
+     * Format with metadata wrapper
+     */
+    formatWithMetadata(result: any, metadata: Record<string, any>): string;
+    /**
+     * Format as JSON Lines (newline-delimited JSON)
+     */
+    formatLines(items: any[]): string;
+    /**
+     * Format error as JSON
+     */
+    formatError(error: Error | string): string;
+    /**
+     * Format success response
+     */
+    formatSuccess(data: any, message?: string): string;
+    /**
+     * Escape special characters for JSON
+     */
+    escape(str: string): string;
+    /**
+     * Minify JSON (remove whitespace)
+     */
+    minify(jsonString: string): string;
+    /**
+     * Beautify JSON (add indentation)
+     */
+    beautify(jsonString: string, indent?: number): string;
+    /**
+     * Merge multiple JSON objects
+     */
+    merge(...objects: any[]): string;
+    /**
+     * Filter JSON by keys
+     */
+    filter(result: any, keys: string[]): string;
+}
+export declare const jsonFormatter: JSONFormatter;
+//# sourceMappingURL=json-formatter.d.ts.map

package/dist/output/formatters/json-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-formatter.d.ts","sourceRoot":"","sources":["../../../src/output/formatters/json-formatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1F,qBAAa,aAAc,YAAW,eAAe;IACnD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAU;IAEvC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;IA4F1D;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO;IAIvC;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM;IAIlC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,SAAI,GAAG,MAAM;IAI7C;;OAEG;IACH,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAQ5C;;OAEG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IASpC;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM;IAOtE;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM;IAMjC;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM;IAa1C;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAQlD;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAW3B;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAUlC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,MAAM;IAUhD;;OAEG;IACH,KAAK,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM;IAKhC;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM;CAc5C;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/output/formatters/json-formatter.js

@@ -0,0 +1,236 @@
+/**
+ * JSON Formatter
+ *
+ * Machine-parseable JSON output formatting
+ */
+export class JSONFormatter {
+    format = 'json';
+    /**
+     * Format result as JSON
+     */
+    formatResult(result, options) {
+        const pretty = options?.pretty ?? false;
+        const indent = options?.indent ?? 2;
+        try {
+            // Handle circular references
+            const seen = new WeakSet();
+            const replacer = (key, value) => {
+                // Handle special types
+                if (value === undefined) {
+                    return null;
+                }
+                if (value instanceof Error) {
+                    return {
+                        __type: 'Error',
+                        name: value.name,
+                        message: value.message,
+                        stack: value.stack,
+                    };
+                }
+                if (value instanceof Date) {
+                    return {
+                        __type: 'Date',
+                        value: value.toISOString(),
+                    };
+                }
+                if (value instanceof RegExp) {
+                    return {
+                        __type: 'RegExp',
+                        pattern: value.source,
+                        flags: value.flags,
+                    };
+                }
+                if (value instanceof Set) {
+                    return {
+                        __type: 'Set',
+                        values: Array.from(value),
+                    };
+                }
+                if (value instanceof Map) {
+                    return {
+                        __type: 'Map',
+                        entries: Array.from(value.entries()),
+                    };
+                }
+                if (typeof value === 'bigint') {
+                    return {
+                        __type: 'BigInt',
+                        value: value.toString(),
+                    };
+                }
+                if (typeof value === 'symbol') {
+                    return {
+                        __type: 'Symbol',
+                        description: value.description,
+                    };
+                }
+                // Handle circular references
+                if (typeof value === 'object' && value !== null) {
+                    if (seen.has(value)) {
+                        return { __type: 'Circular', ref: '[Circular]' };
+                    }
+                    seen.add(value);
+                }
+                return value;
+            };
+            if (pretty) {
+                return JSON.stringify(result, replacer, indent);
+            }
+            else {
+                return JSON.stringify(result, replacer);
+            }
+        }
+        catch (error) {
+            // Fallback for any serialization errors
+            return JSON.stringify({
+                __error: 'Failed to serialize result',
+                message: error.message,
+                type: typeof result,
+            });
+        }
+    }
+    /**
+     * Check if formatter supports given format
+     */
+    supports(format) {
+        return format === 'json';
+    }
+    /**
+     * Format as compact JSON (single line)
+     */
+    formatCompact(result) {
+        return this.formatResult(result, { pretty: false });
+    }
+    /**
+     * Format as pretty JSON (indented)
+     */
+    formatPretty(result, indent = 2) {
+        return this.formatResult(result, { pretty: true, indent });
+    }
+    /**
+     * Parse JSON string safely
+     */
+    parse(jsonString) {
+        try {
+            return JSON.parse(jsonString);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Validate JSON string
+     */
+    isValid(jsonString) {
+        try {
+            JSON.parse(jsonString);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Format with metadata wrapper
+     */
+    formatWithMetadata(result, metadata) {
+        return this.formatResult({
+            metadata,
+            data: result,
+        });
+    }
+    /**
+     * Format as JSON Lines (newline-delimited JSON)
+     */
+    formatLines(items) {
+        return items
+            .map((item) => this.formatResult(item, { pretty: false }))
+            .join('\n');
+    }
+    /**
+     * Format error as JSON
+     */
+    formatError(error) {
+        const errorObj = typeof error === 'string'
+            ? { error: error }
+            : {
+                error: error.message,
+                name: error.name,
+                stack: error.stack,
+            };
+        return this.formatResult(errorObj);
+    }
+    /**
+     * Format success response
+     */
+    formatSuccess(data, message) {
+        return this.formatResult({
+            success: true,
+            message,
+            data,
+        });
+    }
+    /**
+     * Escape special characters for JSON
+     */
+    escape(str) {
+        return str
+            .replace(/\\/g, '\\\\')
+            .replace(/"/g, '\\"')
+            .replace(/\n/g, '\\n')
+            .replace(/\r/g, '\\r')
+            .replace(/\t/g, '\\t')
+            .replace(/\f/g, '\\f')
+            .replace(/\b/g, '\\b');
+    }
+    /**
+     * Minify JSON (remove whitespace)
+     */
+    minify(jsonString) {
+        try {
+            const parsed = JSON.parse(jsonString);
+            return JSON.stringify(parsed);
+        }
+        catch {
+            // If parsing fails, return original
+            return jsonString;
+        }
+    }
+    /**
+     * Beautify JSON (add indentation)
+     */
+    beautify(jsonString, indent = 2) {
+        try {
+            const parsed = JSON.parse(jsonString);
+            return JSON.stringify(parsed, null, indent);
+        }
+        catch {
+            // If parsing fails, return original
+            return jsonString;
+        }
+    }
+    /**
+     * Merge multiple JSON objects
+     */
+    merge(...objects) {
+        const merged = Object.assign({}, ...objects);
+        return this.formatResult(merged);
+    }
+    /**
+     * Filter JSON by keys
+     */
+    filter(result, keys) {
+        if (typeof result !== 'object' || result === null) {
+            return this.formatResult(result);
+        }
+        const filtered = {};
+        for (const key of keys) {
+            if (key in result) {
+                filtered[key] = result[key];
+            }
+        }
+        return this.formatResult(filtered);
+    }
+}
+export const jsonFormatter = new JSONFormatter();
+//# sourceMappingURL=json-formatter.js.map

package/dist/output/formatters/json-formatter.js.map

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

package/dist/output/formatters/stream-formatter.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Stream Formatter
+ *
+ * Stream-JSON formatter for real-time event output
+ */
+import type { OutputFormatter, FormatOptions, OutputFormat, StreamEvent, StreamMetadata } from '../../types/output.js';
+export declare class StreamFormatter implements OutputFormatter {
+    readonly format: OutputFormat;
+    /**
+     * Format result as stream-json (newline-delimited JSON)
+     */
+    formatResult(result: any, options?: FormatOptions): string;
+    /**
+     * Check if formatter supports given format
+     */
+    supports(format: OutputFormat): boolean;
+    /**
+     * Format stream event
+     */
+    formatEvent(event: StreamEvent): string;
+    /**
+     * Format progress event
+     */
+    formatProgress(current: number, total: number, message?: string, metadata?: Partial<StreamMetadata>): string;
+    /**
+     * Format data event
+     */
+    formatData(data: any, metadata?: Partial<StreamMetadata>): string;
+    /**
+     * Format result event
+     */
+    formatResultEvent(result: any, metadata?: Partial<StreamMetadata>): string;
+    /**
+     * Format error event
+     */
+    formatError(error: Error | string, metadata?: Partial<StreamMetadata>): string;
+    /**
+     * Format complete event
+     */
+    formatComplete(summary?: any, metadata?: Partial<StreamMetadata>): string;
+    /**
+     * Format step event
+     */
+    formatStep(step: string, metadata?: Partial<StreamMetadata>): string;
+    /**
+     * Parse stream-json line
+     */
+    parseEvent(line: string): StreamEvent | null;
+    /**
+     * Parse stream of newline-delimited JSON
+     */
+    parseStream(stream: AsyncIterable<string>): AsyncIterable<StreamEvent>;
+    /**
+     * Format batch of events
+     */
+    formatBatch(events: StreamEvent[]): string;
+    /**
+     * Create event builder
+     */
+    createEventBuilder(): StreamEventBuilder;
+    /**
+     * Calculate ETA
+     */
+    calculateETA(current: number, total: number, startTime: number): number;
+    /**
+     * Calculate rate
+     */
+    calculateRate(current: number, startTime: number): number;
+}
+/**
+ * Stream event builder for convenience
+ */
+export declare class StreamEventBuilder {
+    private startTime;
+    private formatter;
+    constructor(formatter: StreamFormatter);
+    /**
+     * Emit progress event
+     */
+    progress(current: number, total: number, message?: string): string;
+    /**
+     * Emit data event
+     */
+    data(data: any): string;
+    /**
+     * Emit result event
+     */
+    result(result: any): string;
+    /**
+     * Emit error event
+     */
+    error(error: Error | string): string;
+    /**
+     * Emit complete event
+     */
+    complete(summary?: any): string;
+    /**
+     * Emit step event
+     */
+    step(step: string): string;
+    /**
+     * Reset start time
+     */
+    reset(): void;
+}
+export declare const streamFormatter: StreamFormatter;
+//# sourceMappingURL=stream-formatter.d.ts.map

package/dist/output/formatters/stream-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-formatter.d.ts","sourceRoot":"","sources":["../../../src/output/formatters/stream-formatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,WAAW,EACX,cAAc,EACf,MAAM,uBAAuB,CAAC;AAE/B,qBAAa,eAAgB,YAAW,eAAe;IACrD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAiB;IAE9C;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;IAW1D;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO;IAIvC;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM;IAKvC;;OAEG;IACH,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GACjC,MAAM;IAkBT;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,MAAM;IAWjE;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,MAAM;IAW1E;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,MAAM;IAoB9E;;OAEG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,MAAM;IAWzE;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,MAAM;IAcpE;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAqB5C;;OAEG;IACI,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,WAAW,CAAC;IAa7E;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM;IAI1C;;OAEG;IACH,kBAAkB,IAAI,kBAAkB;IAIxC;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAUvE;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;CAM1D;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,SAAS,CAAkB;gBAEvB,SAAS,EAAE,eAAe;IAItC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAUlE;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM;IAIvB;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM;IAI3B;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM;IAIpC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,GAAG,MAAM;IAK/B;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI1B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED,eAAO,MAAM,eAAe,iBAAwB,CAAC"}