@adverant-nexus/cli 2.0.1 → 3.0.0

package/dist/core/router/command-router.d.ts

@@ -1,33 +1,143 @@
 /**
  * Command Router
  *
- * Routes commands to appropriate handlers
+ * Routes commands to appropriate handlers with:
+ * - Intelligent command resolution (namespace, aliases, etc.)
+ * - Argument validation
+ * - Error handling
+ * - Performance tracking
+ * - Middleware support
  */
-import type { Command, CommandArgs, CommandContext, CommandResult } from '../../types/command.js';
+import type { Command, CommandArgs, CommandContext, CommandResult } from '@adverant-nexus/types';
 import { CommandRegistry } from './command-registry.js';
+/**
+ * Middleware function type for command execution
+ */
+export type CommandMiddleware = (command: Command, args: CommandArgs, context: CommandContext, next: () => Promise<CommandResult>) => Promise<CommandResult>;
+/**
+ * Command Router Implementation
+ *
+ * Handles:
+ * - Command resolution with multiple strategies
+ * - Validation before execution
+ * - Middleware chain execution
+ * - Error handling and reporting
+ * - Performance metrics
+ */
 export declare class CommandRouter {
     private registry;
+    private middlewares;
     constructor(registry: CommandRegistry);
+    /**
+     * Add middleware to the execution chain
+     *
+     * Middleware is executed in the order it was added
+     *
+     * @param middleware - Middleware function
+     *
+     * @example
+     * router.use(async (command, args, context, next) => {
+     *   console.log(`Executing ${command.name}`);
+     *   const result = await next();
+     *   console.log(`Completed ${command.name}`);
+     *   return result;
+     * });
+     */
+    use(middleware: CommandMiddleware): void;
     /**
      * Route and execute a command
+     *
+     * Execution flow:
+     * 1. Find command using resolution strategies
+     * 2. Validate arguments if validator exists
+     * 3. Execute middleware chain
+     * 4. Execute command handler
+     * 5. Return result with metadata
+     *
+     * @param commandName - Command name (can include namespace)
+     * @param args - Command arguments
+     * @param context - Execution context
+     * @returns Command execution result
      */
     route(commandName: string, args: CommandArgs, context: CommandContext): Promise<CommandResult>;
     /**
-     * Find command by name, trying multiple resolution strategies
+     * Execute command with middleware chain
+     *
+     * @param command - Command to execute
+     * @param args - Command arguments
+     * @param context - Execution context
+     * @param index - Current middleware index
+     * @returns Command result
+     */
+    private executeWithMiddleware;
+    /**
+     * Find command by name using multiple resolution strategies
+     *
+     * Resolution strategies (in order):
+     * 1. Direct lookup (exact match)
+     * 2. Namespace prefix (e.g., "services:health")
+     * 3. Common namespaces (services, graphrag, mageagent, etc.)
+     * 4. Command aliases
+     *
+     * @param commandName - Command name to find
+     * @returns Command definition or undefined
      */
     private findCommand;
     /**
-     * Get all available commands
+     * Get all available commands, optionally filtered by namespace
+     *
+     * @param namespace - Optional namespace filter
+     * @returns Array of commands
      */
     listCommands(namespace?: string): Command[];
     /**
-     * Get all namespaces
+     * Get all registered namespaces
+     *
+     * @returns Array of namespace strings
      */
     listNamespaces(): string[];
     /**
-     * Search commands
+     * Search for commands by keyword
+     *
+     * @param keyword - Search keyword
+     * @returns Array of matching commands
      */
     searchCommands(keyword: string): Command[];
+    /**
+     * Get commands organized by category
+     *
+     * @returns Map of category to commands
+     */
+    getCommandsByCategory(): Map<string, Command[]>;
+    /**
+     * Validate command exists and is accessible
+     *
+     * @param commandName - Command name to validate
+     * @param context - Execution context (for auth/workspace checks)
+     * @returns Validation result with error message if invalid
+     */
+    validateCommand(commandName: string, context: CommandContext): {
+        valid: boolean;
+        error?: string;
+        command?: Command;
+    };
+    /**
+     * Get command help text
+     *
+     * @param commandName - Command name
+     * @returns Help text or undefined if command not found
+     */
+    getCommandHelp(commandName: string): string | undefined;
+    /**
+     * Clear all registered middleware
+     */
+    clearMiddleware(): void;
 }
+/**
+ * Factory function to create a new CommandRouter instance
+ *
+ * @param registry - Command registry to use
+ * @returns New CommandRouter instance
+ */
 export declare function createCommandRouter(registry: CommandRegistry): CommandRouter;
 //# sourceMappingURL=command-router.d.ts.map

package/dist/core/router/command-router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-router.d.ts","sourceRoot":"","sources":["../../../src/core/router/command-router.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,WAAW,EACX,cAAc,EACd,aAAa,EACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,eAAe;IAE7C;;OAEG;IACG,KAAK,CACT,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;IAgDzB;;OAEG;IACH,OAAO,CAAC,WAAW;IA8BnB;;OAEG;IACH,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE;IAI3C;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE;CAG3C;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,eAAe,GAAG,aAAa,CAE5E"}
+{"version":3,"file":"command-router.d.ts","sourceRoot":"","sources":["../../../src/core/router/command-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,WAAW,EACX,cAAc,EACd,aAAa,EACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,KAC/B,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5B;;;;;;;;;GASG;AACH,qBAAa,aAAa;IAGZ,OAAO,CAAC,QAAQ;IAF5B,OAAO,CAAC,WAAW,CAA2B;gBAE1B,QAAQ,EAAE,eAAe;IAE7C;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAIxC;;;;;;;;;;;;;;OAcG;IACG,KAAK,CACT,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;IAuEzB;;;;;;;;OAQG;YACW,qBAAqB;IAqBnC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,WAAW;IAqCnB;;;;;OAKG;IACH,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE;IAI3C;;;;OAIG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE;IAI1C;;;;OAIG;IACH,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IAI/C;;;;;;OAMG;IACH,eAAe,CACb,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,GACtB;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;IAkCxD;;;;;OAKG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAwCvD;;OAEG;IACH,eAAe,IAAI,IAAI;CAGxB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,eAAe,GAAG,aAAa,CAE5E"}

package/dist/core/router/command-router.js

@@ -1,18 +1,64 @@
 /**
  * Command Router
  *
- * Routes commands to appropriate handlers
+ * Routes commands to appropriate handlers with:
+ * - Intelligent command resolution (namespace, aliases, etc.)
+ * - Argument validation
+ * - Error handling
+ * - Performance tracking
+ * - Middleware support
+ */
+/**
+ * Command Router Implementation
+ *
+ * Handles:
+ * - Command resolution with multiple strategies
+ * - Validation before execution
+ * - Middleware chain execution
+ * - Error handling and reporting
+ * - Performance metrics
  */
 export class CommandRouter {
     registry;
+    middlewares = [];
     constructor(registry) {
         this.registry = registry;
     }
+    /**
+     * Add middleware to the execution chain
+     *
+     * Middleware is executed in the order it was added
+     *
+     * @param middleware - Middleware function
+     *
+     * @example
+     * router.use(async (command, args, context, next) => {
+     *   console.log(`Executing ${command.name}`);
+     *   const result = await next();
+     *   console.log(`Completed ${command.name}`);
+     *   return result;
+     * });
+     */
+    use(middleware) {
+        this.middlewares.push(middleware);
+    }
     /**
      * Route and execute a command
+     *
+     * Execution flow:
+     * 1. Find command using resolution strategies
+     * 2. Validate arguments if validator exists
+     * 3. Execute middleware chain
+     * 4. Execute command handler
+     * 5. Return result with metadata
+     *
+     * @param commandName - Command name (can include namespace)
+     * @param args - Command arguments
+     * @param context - Execution context
+     * @returns Command execution result
      */
     async route(commandName, args, context) {
-        // Try to find command
+        // Find command using multiple resolution strategies
         const command = this.findCommand(commandName);
         if (!command) {
             return {
@@ -22,41 +68,88 @@ export class CommandRouter {
         }
         // Validate arguments if validator exists
         if (command.validator) {
-            const validation = await command.validator(args, context);
-            if (!validation.valid) {
-                const errors = validation.errors?.map((e) => e.message).join(', ');
+            try {
+                const validation = await command.validator(args, context);
+                if (!validation.valid) {
+                    const errors = validation.errors?.map((e) => e.message).join(', ');
+                    return {
+                        success: false,
+                        error: `Validation failed: ${errors}`,
+                    };
+                }
+            }
+            catch (error) {
                 return {
                     success: false,
-                    error: `Validation failed: ${errors}`,
+                    error: `Validation error: ${error.message}`,
                 };
             }
         }
-        // Execute command handler
+        // Execute command with middleware chain
         try {
             const startTime = Date.now();
-            const result = await command.handler(args, context);
+            // Build middleware chain
+            const result = await this.executeWithMiddleware(command, args, context, 0);
             const duration = Date.now() - startTime;
+            // Add execution metadata
             return {
                 ...result,
                 metadata: {
                     ...result.metadata,
                     duration,
-                    service: command.namespace,
+                    ...(command.namespace && { service: command.namespace }),
                 },
             };
         }
         catch (error) {
-            return {
+            // Handle unexpected errors
+            const errorResult = {
                 success: false,
                 error: error.message || 'Command execution failed',
-                metadata: {
-                    service: command.namespace,
-                },
             };
+            // Add metadata only if we have data to add
+            if (command.namespace || error.name || error.stack) {
+                errorResult.metadata = {
+                    ...(command.namespace && { service: command.namespace }),
+                };
+            }
+            return errorResult;
+        }
+    }
+    /**
+     * Execute command with middleware chain
+     *
+     * @param command - Command to execute
+     * @param args - Command arguments
+     * @param context - Execution context
+     * @param index - Current middleware index
+     * @returns Command result
+     */
+    async executeWithMiddleware(command, args, context, index) {
+        // If we've reached the end of middleware chain, execute handler
+        if (index >= this.middlewares.length) {
+            return command.handler(args, context);
+        }
+        // Execute current middleware with next() function
+        const middleware = this.middlewares[index];
+        if (!middleware) {
+            return command.handler(args, context);
         }
+        return middleware(command, args, context, async () => {
+            return this.executeWithMiddleware(command, args, context, index + 1);
+        });
     }
     /**
-     * Find command by name, trying multiple resolution strategies
+     * Find command by name using multiple resolution strategies
+     *
+     * Resolution strategies (in order):
+     * 1. Direct lookup (exact match)
+     * 2. Namespace prefix (e.g., "services:health")
+     * 3. Common namespaces (services, graphrag, mageagent, etc.)
+     * 4. Command aliases
+     *
+     * @param commandName - Command name to find
+     * @returns Command definition or undefined
      */
     findCommand(commandName) {
         // Strategy 1: Direct lookup
@@ -65,13 +158,20 @@ export class CommandRouter {
             return command;
         // Strategy 2: Try with namespace prefix (e.g., "graphrag:query")
         if (commandName.includes(':')) {
-            const [namespace, name] = commandName.split(':', 2);
+            const [namespace = '', name = ''] = commandName.split(':', 2);
             command = this.registry.get(name, namespace);
             if (command)
                 return command;
         }
         // Strategy 3: Try common namespaces
-        const commonNamespaces = ['services', 'graphrag', 'mageagent', 'sandbox', 'nexus'];
+        const commonNamespaces = [
+            'services',
+            'graphrag',
+            'mageagent',
+            'sandbox',
+            'mcp',
+            'plugins',
+        ];
         for (const namespace of commonNamespaces) {
             command = this.registry.get(commandName, namespace);
             if (command)
@@ -87,24 +187,128 @@ export class CommandRouter {
         return undefined;
     }
     /**
-     * Get all available commands
+     * Get all available commands, optionally filtered by namespace
+     *
+     * @param namespace - Optional namespace filter
+     * @returns Array of commands
      */
     listCommands(namespace) {
         return this.registry.list(namespace);
     }
     /**
-     * Get all namespaces
+     * Get all registered namespaces
+     *
+     * @returns Array of namespace strings
      */
     listNamespaces() {
         return this.registry.listNamespaces();
     }
     /**
-     * Search commands
+     * Search for commands by keyword
+     *
+     * @param keyword - Search keyword
+     * @returns Array of matching commands
      */
     searchCommands(keyword) {
         return this.registry.search(keyword);
     }
+    /**
+     * Get commands organized by category
+     *
+     * @returns Map of category to commands
+     */
+    getCommandsByCategory() {
+        return this.registry.getByCategory();
+    }
+    /**
+     * Validate command exists and is accessible
+     *
+     * @param commandName - Command name to validate
+     * @param context - Execution context (for auth/workspace checks)
+     * @returns Validation result with error message if invalid
+     */
+    validateCommand(commandName, context) {
+        const command = this.findCommand(commandName);
+        if (!command) {
+            return {
+                valid: false,
+                error: `Command '${commandName}' not found`,
+            };
+        }
+        // Check authentication requirement
+        if (command.requiresAuth && !context.config?.auth?.token) {
+            return {
+                valid: false,
+                error: `Command '${commandName}' requires authentication. Run 'nexus auth login' first.`,
+                command,
+            };
+        }
+        // Check workspace requirement
+        if (command.requiresWorkspace && !context.workspace) {
+            return {
+                valid: false,
+                error: `Command '${commandName}' requires a workspace. Run from within a project directory.`,
+                command,
+            };
+        }
+        return {
+            valid: true,
+            command,
+        };
+    }
+    /**
+     * Get command help text
+     *
+     * @param commandName - Command name
+     * @returns Help text or undefined if command not found
+     */
+    getCommandHelp(commandName) {
+        const command = this.findCommand(commandName);
+        if (!command)
+            return undefined;
+        let help = `${command.name} - ${command.description}\n\n`;
+        if (command.usage) {
+            help += `Usage: ${command.usage}\n\n`;
+        }
+        if (command.args && command.args.length > 0) {
+            help += 'Arguments:\n';
+            for (const arg of command.args) {
+                const required = arg.required ? '(required)' : '(optional)';
+                help += `  ${arg.name} ${required} - ${arg.description}\n`;
+            }
+            help += '\n';
+        }
+        if (command.options && command.options.length > 0) {
+            help += 'Options:\n';
+            for (const option of command.options) {
+                const flags = option.short
+                    ? `-${option.short}, --${option.long}`
+                    : `--${option.long}`;
+                help += `  ${flags} - ${option.description}\n`;
+            }
+            help += '\n';
+        }
+        if (command.examples && command.examples.length > 0) {
+            help += 'Examples:\n';
+            for (const example of command.examples) {
+                help += `  ${example}\n`;
+            }
+        }
+        return help;
+    }
+    /**
+     * Clear all registered middleware
+     */
+    clearMiddleware() {
+        this.middlewares = [];
+    }
 }
+/**
+ * Factory function to create a new CommandRouter instance
+ *
+ * @param registry - Command registry to use
+ * @returns New CommandRouter instance
+ */
 export function createCommandRouter(registry) {
     return new CommandRouter(registry);
 }

package/dist/core/router/command-router.js.map

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

package/dist/core/router/examples/commander-integration.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Commander.js Integration Example
+ *
+ * Shows how to integrate the command router with Commander.js
+ */
+import { Command as CommanderCommand } from 'commander';
+import { createCommandRegistry, createCommandRouter, type Command, type CommandContext } from '../index.js';
+/**
+ * Convert router Command to Commander.js Command
+ */
+export declare function commandToCommander(command: Command, router: ReturnType<typeof createCommandRouter>, context: CommandContext): CommanderCommand;
+/**
+ * Create Commander.js program from router registry
+ */
+export declare function createCommanderProgram(registry: ReturnType<typeof createCommandRegistry>, router: ReturnType<typeof createCommandRouter>, context: CommandContext): CommanderCommand;
+/**
+ * Example: Full CLI setup with Commander.js
+ */
+export declare function setupCLI(): Promise<void>;
+//# sourceMappingURL=commander-integration.d.ts.map

package/dist/core/router/examples/commander-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commander-integration.d.ts","sourceRoot":"","sources":["../../../../src/core/router/examples/commander-integration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,OAAO,EACZ,KAAK,cAAc,EAEpB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,EAC9C,OAAO,EAAE,cAAc,GACtB,gBAAgB,CAuGlB;AA4BD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,EAClD,MAAM,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,EAC9C,OAAO,EAAE,cAAc,GACtB,gBAAgB,CAsDlB;AAED;;GAEG;AACH,wBAAsB,QAAQ,kBA2B7B"}