@adverant-nexus/cli 2.0.0

package/dist/types/session.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Session Type Definitions
+ *
+ * Types for session management, checkpointing, and history
+ */
+import type { CommandArgs, CommandResult } from './command.js';
+import type { WorkspaceInfo } from './command.js';
+export interface Session {
+    id: string;
+    name: string;
+    created: Date;
+    updated: Date;
+    context: SessionContext;
+    history: HistoryEntry[];
+    results: SessionResult[];
+    nexusMemories: string[];
+    metadata: SessionMetadata;
+}
+export interface SessionContext {
+    workspace?: WorkspaceInfo;
+    cwd: string;
+    config: any;
+    environment: Record<string, string>;
+    services: Record<string, any>;
+}
+export interface HistoryEntry {
+    id: string;
+    timestamp: Date;
+    command: string;
+    args: CommandArgs;
+    namespace?: string;
+    success: boolean;
+    duration: number;
+}
+export interface SessionResult {
+    historyId: string;
+    timestamp: Date;
+    result: CommandResult;
+    output?: string;
+}
+export interface SessionMetadata {
+    totalCommands: number;
+    successfulCommands: number;
+    failedCommands: number;
+    totalDuration: number;
+    lastCommand?: string;
+    tags: string[];
+}
+export interface SessionStorage {
+    save(session: Session): Promise<void>;
+    load(nameOrId: string): Promise<Session | null>;
+    list(): Promise<SessionSummary[]>;
+    delete(nameOrId: string): Promise<void>;
+    export(nameOrId: string): Promise<string>;
+    import(data: string): Promise<Session>;
+}
+export interface SessionSummary {
+    id: string;
+    name: string;
+    created: Date;
+    updated: Date;
+    commandCount: number;
+    tags: string[];
+}
+export interface HistoryManager {
+    add(entry: HistoryEntry): void;
+    get(id: string): HistoryEntry | undefined;
+    list(limit?: number): HistoryEntry[];
+    search(query: string): HistoryEntry[];
+    clear(): void;
+}
+export interface CommandHistory {
+    commands: string[];
+    add(command: string): void;
+    get(index: number): string | undefined;
+    last(n?: number): string[];
+    search(query: string): string[];
+    clear(): void;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/types/session.d.ts.map

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

package/dist/types/session.js

@@ -0,0 +1,7 @@
+/**
+ * Session Type Definitions
+ *
+ * Types for session management, checkpointing, and history
+ */
+export {};
+//# sourceMappingURL=session.js.map

package/dist/types/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/types/session.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/types/transport.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Transport Type Definitions
+ *
+ * Types for HTTP, WebSocket, and MCP transport layers
+ */
+import type { AuthConfig } from './config.js';
+export interface TransportConfig {
+    baseUrl: string;
+    timeout?: number;
+    retries?: number;
+    headers?: Record<string, string>;
+    auth?: AuthConfig;
+}
+export interface HTTPTransport {
+    get<T = any>(path: string, options?: RequestOptions): Promise<T>;
+    post<T = any>(path: string, data?: any, options?: RequestOptions): Promise<T>;
+    put<T = any>(path: string, data?: any, options?: RequestOptions): Promise<T>;
+    patch<T = any>(path: string, data?: any, options?: RequestOptions): Promise<T>;
+    delete<T = any>(path: string, options?: RequestOptions): Promise<T>;
+}
+export interface RequestOptions {
+    params?: Record<string, any>;
+    headers?: Record<string, string>;
+    timeout?: number;
+    retries?: number;
+    signal?: AbortSignal;
+}
+export interface WebSocketTransport {
+    connect(url: string, options?: WSOptions): Promise<void>;
+    disconnect(): Promise<void>;
+    send(event: string, data: any): void;
+    on(event: string, handler: WSEventHandler): void;
+    off(event: string, handler?: WSEventHandler): void;
+    isConnected(): boolean;
+}
+export interface WSOptions {
+    reconnect?: boolean;
+    reconnectDelay?: number;
+    maxReconnectAttempts?: number;
+    timeout?: number;
+}
+export type WSEventHandler = (data: any) => void;
+export interface MCPTransport {
+    connect(config: MCPConfig): Promise<void>;
+    disconnect(): Promise<void>;
+    call<T = any>(method: string, params?: any): Promise<T>;
+    listTools(): Promise<MCPTool[]>;
+    executeTool<T = any>(name: string, args?: any): Promise<T>;
+}
+export interface MCPConfig {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    timeout?: number;
+}
+export interface MCPTool {
+    name: string;
+    description: string;
+    inputSchema: any;
+    outputSchema?: any;
+}
+export interface StreamingTransport {
+    stream<T = any>(path: string, options?: StreamOptions): AsyncIterable<StreamChunk<T>>;
+}
+export interface StreamOptions extends RequestOptions {
+    method?: 'GET' | 'POST';
+    data?: any;
+}
+export interface StreamChunk<T = any> {
+    type: 'data' | 'progress' | 'error' | 'complete';
+    data: T;
+    metadata?: any;
+}
+export interface TransportError extends Error {
+    code: string;
+    statusCode?: number;
+    details?: any;
+    retryable?: boolean;
+}
+export interface RetryConfig {
+    maxAttempts: number;
+    initialDelay: number;
+    maxDelay: number;
+    factor: number;
+    retryableErrors?: string[];
+}
+export interface RequestMetrics {
+    startTime: number;
+    endTime?: number;
+    duration?: number;
+    retries: number;
+    success: boolean;
+    error?: TransportError;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/types/transport.d.ts.map

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

package/dist/types/transport.js

@@ -0,0 +1,7 @@
+/**
+ * Transport Type Definitions
+ *
+ * Types for HTTP, WebSocket, and MCP transport layers
+ */
+export {};
+//# sourceMappingURL=transport.js.map

package/dist/types/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/types/transport.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/utils/config.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Configuration management for nexus-cli
+ */
+import type { HealthCheckResponse } from '../types/api.js';
+export interface CliConfig {
+    apiKey?: string;
+    apiUrl?: string;
+    currentPlugin?: string;
+}
+/**
+ * Get API URL with intelligent fallback
+ * Respects user configuration and environment-specific defaults
+ */
+export declare function getApiUrl(): Promise<string>;
+export declare function loadConfig(): Promise<CliConfig>;
+export declare function saveConfig(config: CliConfig): Promise<void>;
+export declare function updateConfig(updates: Partial<CliConfig>): Promise<void>;
+export declare function getApiKey(): Promise<string | undefined>;
+/**
+ * Check Nexus Nexus API health
+ * Performs health check with timeout and retry logic
+ *
+ * @param apiUrl - The API URL to check (optional, will use default)
+ * @param timeout - Request timeout in milliseconds (default: 5000)
+ * @returns Health check response or null if unhealthy
+ */
+export declare function checkApiHealth(apiUrl?: string, timeout?: number): Promise<HealthCheckResponse | null>;
+/**
+ * Result of API health validation
+ */
+export interface HealthCheckResult {
+    healthy: boolean;
+    status: 'healthy' | 'unhealthy' | 'degraded' | 'unavailable';
+    message: string;
+    details?: HealthCheckResponse;
+    warnings?: string[];
+}
+/**
+ * Validate API health before critical operations
+ * Provides detailed feedback about service status
+ *
+ * @param apiUrl - The API URL to check
+ * @param timeout - Request timeout in milliseconds
+ * @returns Detailed health check result
+ */
+export declare function validateApiHealth(apiUrl?: string, timeout?: number): Promise<HealthCheckResult>;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAe,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAExE,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAgBD;;;GAGG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAoBjD;AAKD,wBAAsB,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC,CAarD;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjE;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7E;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAG7D;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,GAAE,MAAa,GACrB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CA0BrC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,aAAa,CAAC;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,iBAAiB,CAAC,CA8D5B"}

package/dist/utils/config.js

@@ -0,0 +1,166 @@
+/**
+ * Configuration management for nexus-cli
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import axios from 'axios';
+/**
+ * Default API URL configuration
+ * Priority order:
+ * 1. Environment variable NEXUS_API_URL
+ * 2. Saved config file
+ * 3. Kubernetes service discovery (nexus-plugin-manager:9111)
+ * 4. Localhost development (http://localhost:9111)
+ */
+const DEFAULT_API_URLS = {
+    kubernetes: 'http://nexus-plugin-manager:9111',
+    localhost: 'http://localhost:9111',
+    production: process.env.NEXUS_API_URL || undefined
+};
+/**
+ * Get API URL with intelligent fallback
+ * Respects user configuration and environment-specific defaults
+ */
+export async function getApiUrl() {
+    // Priority 1: Environment variable
+    if (process.env.NEXUS_API_URL) {
+        return process.env.NEXUS_API_URL;
+    }
+    // Priority 2: Saved config
+    const config = await loadConfig();
+    if (config.apiUrl) {
+        return config.apiUrl;
+    }
+    // Priority 3: Detect environment
+    // Check if running in Kubernetes cluster
+    if (process.env.KUBERNETES_SERVICE_HOST) {
+        return DEFAULT_API_URLS.kubernetes;
+    }
+    // Priority 4: Default to localhost for development
+    return DEFAULT_API_URLS.localhost;
+}
+const CONFIG_DIR = path.join(os.homedir(), '.nexus');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+export async function loadConfig() {
+    try {
+        await fs.ensureDir(CONFIG_DIR);
+        if (await fs.pathExists(CONFIG_FILE)) {
+            return await fs.readJson(CONFIG_FILE);
+        }
+        return {};
+    }
+    catch (error) {
+        console.error('Failed to load config:', error);
+        return {};
+    }
+}
+export async function saveConfig(config) {
+    try {
+        await fs.ensureDir(CONFIG_DIR);
+        await fs.writeJson(CONFIG_FILE, config, { spaces: 2 });
+    }
+    catch (error) {
+        console.error('Failed to save config:', error);
+        throw error;
+    }
+}
+export async function updateConfig(updates) {
+    const config = await loadConfig();
+    await saveConfig({ ...config, ...updates });
+}
+export async function getApiKey() {
+    const config = await loadConfig();
+    return config.apiKey || process.env.NEXUS_API_KEY;
+}
+/**
+ * Check Nexus Nexus API health
+ * Performs health check with timeout and retry logic
+ *
+ * @param apiUrl - The API URL to check (optional, will use default)
+ * @param timeout - Request timeout in milliseconds (default: 5000)
+ * @returns Health check response or null if unhealthy
+ */
+export async function checkApiHealth(apiUrl, timeout = 5000) {
+    try {
+        const url = apiUrl || await getApiUrl();
+        const response = await axios.get(`${url}/health`, {
+            timeout,
+            validateStatus: (status) => status < 500 // Accept 2xx and 4xx as valid responses
+        });
+        // Extract health data from standard API response wrapper
+        if (response.data && response.data.data) {
+            return response.data.data;
+        }
+        // Fallback: if response is direct health data (no wrapper)
+        if (response.data && 'status' in response.data) {
+            return response.data;
+        }
+        return null;
+    }
+    catch (error) {
+        // Health check failed - return null to indicate unhealthy
+        return null;
+    }
+}
+/**
+ * Validate API health before critical operations
+ * Provides detailed feedback about service status
+ *
+ * @param apiUrl - The API URL to check
+ * @param timeout - Request timeout in milliseconds
+ * @returns Detailed health check result
+ */
+export async function validateApiHealth(apiUrl, timeout) {
+    const health = await checkApiHealth(apiUrl, timeout);
+    if (!health) {
+        return {
+            healthy: false,
+            status: 'unavailable',
+            message: 'Nexus Nexus API is unavailable',
+            warnings: [
+                'Cannot connect to Nexus Nexus',
+                'Check if services are running',
+                'Verify network connectivity'
+            ]
+        };
+    }
+    const warnings = [];
+    // Check for degraded services
+    const degradedServices = health.services.filter(s => s.status === 'degraded');
+    if (degradedServices.length > 0) {
+        warnings.push(`${degradedServices.length} service(s) degraded: ${degradedServices.map(s => s.name).join(', ')}`);
+    }
+    // Check for unhealthy services
+    const unhealthyServices = health.services.filter(s => s.status === 'unhealthy');
+    if (unhealthyServices.length > 0) {
+        warnings.push(`${unhealthyServices.length} service(s) unhealthy: ${unhealthyServices.map(s => s.name).join(', ')}`);
+    }
+    // Overall health assessment
+    if (health.status === 'unhealthy') {
+        return {
+            healthy: false,
+            status: 'unhealthy',
+            message: 'Nexus Nexus API is unhealthy',
+            details: health,
+            warnings
+        };
+    }
+    if (health.status === 'degraded') {
+        return {
+            healthy: true, // Still operational but with warnings
+            status: 'degraded',
+            message: 'Nexus Nexus API is degraded',
+            details: health,
+            warnings
+        };
+    }
+    return {
+        healthy: true,
+        status: 'healthy',
+        message: 'Nexus Nexus API is healthy',
+        details: health,
+        warnings: warnings.length > 0 ? warnings : undefined
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

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

package/dist/utils/error-handler.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Comprehensive Error Handler for Nexus CLI
+ *
+ * Provides custom error types, error formatting, and user-friendly
+ * error messages with proper exit codes.
+ */
+/**
+ * Base error class for all CLI errors
+ */
+export declare class NexusError extends Error {
+    readonly code: string;
+    readonly exitCode: number;
+    readonly context?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, exitCode?: number, context?: Record<string, unknown> | undefined);
+}
+/**
+ * Configuration errors
+ */
+export declare class ConfigurationError extends NexusError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Validation errors
+ */
+export declare class ValidationError extends NexusError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Service connection errors
+ */
+export declare class ServiceConnectionError extends NexusError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Authentication errors
+ */
+export declare class AuthenticationError extends NexusError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Command execution errors
+ */
+export declare class CommandExecutionError extends NexusError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Plugin errors
+ */
+export declare class PluginError extends NexusError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Workspace errors
+ */
+export declare class WorkspaceError extends NexusError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Get exit code for an error
+ */
+export declare function getExitCode(error: unknown): number;
+/**
+ * Format error for display
+ */
+export declare function formatError(error: unknown, verbose?: boolean): string;
+/**
+ * Handle error and exit
+ */
+export declare function handleError(error: unknown, verbose?: boolean): never;
+/**
+ * Global error handler for uncaught exceptions
+ */
+export declare function setupGlobalErrorHandlers(verbose?: boolean): void;
+/**
+ * Create error with suggestions
+ */
+export declare function createErrorWithSuggestions(message: string, suggestions: string[], ErrorClass?: typeof NexusError): NexusError;
+/**
+ * Wrap async function with error handling
+ */
+export declare function wrapAsyncError<T extends (...args: any[]) => Promise<any>>(fn: T, verbose?: boolean): T;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/utils/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;aAGjB,IAAI,EAAE,MAAM;aACZ,QAAQ,EAAE,MAAM;aAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAHjD,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAU,EACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAMpD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,UAAU;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,UAAU;gBACvC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;gBAChC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAgBD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAqBlD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,OAAe,GAAG,MAAM,CA2D5E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,OAAe,GAAG,KAAK,CAa3E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,OAAe,GAAG,IAAI,CAsBvE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EAAE,EACrB,UAAU,GAAE,OAAO,UAAuB,GACzC,UAAU,CAGZ;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EACvE,EAAE,EAAE,CAAC,EACL,OAAO,GAAE,OAAe,GACvB,CAAC,CAQH"}