@adverant-nexus/cli 2.0.1 → 3.0.0

package/dist/core/router/examples/commander-integration.js

@@ -0,0 +1,345 @@
+/**
+ * Commander.js Integration Example
+ *
+ * Shows how to integrate the command router with Commander.js
+ */
+import { Command as CommanderCommand } from 'commander';
+import { createCommandRegistry, createCommandRouter, } from '../index.js';
+/**
+ * Convert router Command to Commander.js Command
+ */
+export function commandToCommander(command, router, context) {
+    const fullName = command.namespace
+        ? `${command.namespace}:${command.name}`
+        : command.name;
+    const program = new CommanderCommand(fullName);
+    // Set description
+    program.description(command.description);
+    // Add arguments
+    if (command.args) {
+        for (const arg of command.args) {
+            const argStr = arg.required ? `<${arg.name}>` : `[${arg.name}]`;
+            const argDesc = arg.variadic ? `${arg.description} (variadic)` : arg.description;
+            program.argument(argStr, argDesc, arg.default);
+        }
+    }
+    // Add options
+    if (command.options) {
+        for (const opt of command.options) {
+            const flags = opt.short
+                ? `-${opt.short}, --${opt.long}`
+                : `--${opt.long}`;
+            const optDesc = opt.env
+                ? `${opt.description} (env: ${opt.env})`
+                : opt.description;
+            // Handle different option types
+            switch (opt.type) {
+                case 'boolean':
+                    program.option(flags, optDesc, opt.default);
+                    break;
+                case 'number':
+                    program.option(flags + ' <value>', optDesc, (val) => parseInt(val, 10), opt.default);
+                    break;
+                case 'array':
+                    program.option(flags + ' <items...>', optDesc, opt.default);
+                    break;
+                default:
+                    program.option(flags + ' <value>', optDesc, opt.default);
+            }
+        }
+    }
+    // Add aliases
+    if (command.aliases) {
+        program.aliases(command.aliases);
+    }
+    // Set action
+    program.action(async (...args) => {
+        const commandArgs = parseCommanderArgs(args, command);
+        try {
+            const result = await router.route(fullName, commandArgs, context);
+            if (!result.success) {
+                console.error(`Error: ${result.error}`);
+                process.exit(1);
+            }
+            // Output result
+            if (result.message) {
+                console.log(result.message);
+            }
+            if (result.data && !context.quiet) {
+                if (context.outputFormat === 'json') {
+                    console.log(JSON.stringify(result.data, null, 2));
+                }
+                else {
+                    console.log(result.data);
+                }
+            }
+        }
+        catch (error) {
+            console.error(`Fatal error: ${error.message}`);
+            if (context.verbose) {
+                console.error(error.stack);
+            }
+            process.exit(1);
+        }
+    });
+    // Add usage examples
+    if (command.examples && command.examples.length > 0) {
+        program.addHelpText('after', '\nExamples:');
+        for (const example of command.examples) {
+            program.addHelpText('after', `  $ ${example}`);
+        }
+    }
+    return program;
+}
+/**
+ * Parse Commander.js args to CommandArgs format
+ */
+function parseCommanderArgs(args, command) {
+    const commandArgs = { _: [] };
+    // Extract positional arguments
+    const numArgs = command.args?.length || 0;
+    for (let i = 0; i < numArgs && i < args.length - 1; i++) {
+        commandArgs._.push(args[i]);
+    }
+    // Extract options (last argument is the Command object)
+    const options = args[args.length - 1];
+    if (options && typeof options === 'object') {
+        for (const [key, value] of Object.entries(options)) {
+            // Skip internal Commander properties
+            if (!key.startsWith('_') && key !== 'options' && key !== 'parent') {
+                commandArgs[key] = value;
+            }
+        }
+    }
+    return commandArgs;
+}
+/**
+ * Create Commander.js program from router registry
+ */
+export function createCommanderProgram(registry, router, context) {
+    const program = new CommanderCommand();
+    // Set program metadata
+    program
+        .name('nexus')
+        .description('Nexus CLI - Unified interface for Nexus services')
+        .version('3.0.0');
+    // Add global options
+    program
+        .option('-v, --verbose', 'Enable verbose logging')
+        .option('-q, --quiet', 'Suppress non-error output')
+        .option('--format <type>', 'Output format (text, json, yaml)', 'text')
+        .option('--config <path>', 'Path to config file');
+    // Get all commands
+    const commands = registry.list();
+    // Group commands by namespace
+    const namespaces = new Map();
+    for (const command of commands) {
+        const namespace = command.namespace || 'general';
+        const existing = namespaces.get(namespace) || [];
+        existing.push(command);
+        namespaces.set(namespace, existing);
+    }
+    // Create subcommands for each namespace
+    for (const [namespace, cmds] of namespaces) {
+        if (namespace === 'general') {
+            // Add top-level commands
+            for (const cmd of cmds) {
+                const subcommand = commandToCommander(cmd, router, context);
+                program.addCommand(subcommand);
+            }
+        }
+        else {
+            // Create namespace subcommand
+            const nsCommand = new CommanderCommand(namespace);
+            nsCommand.description(`${namespace} commands`);
+            // Add commands to namespace
+            for (const cmd of cmds) {
+                const subcommand = commandToCommander(cmd, router, context);
+                // Remove namespace prefix from subcommand name
+                subcommand.name(cmd.name);
+                nsCommand.addCommand(subcommand);
+            }
+            program.addCommand(nsCommand);
+        }
+    }
+    return program;
+}
+/**
+ * Example: Full CLI setup with Commander.js
+ */
+export async function setupCLI() {
+    // 1. Create router
+    const registry = createCommandRegistry();
+    const router = createCommandRouter(registry);
+    // 2. Register commands (from your command definitions)
+    registerCommands(registry);
+    // 3. Discover dynamic commands
+    await registry.discoverDynamicCommands();
+    // 4. Create context
+    const context = {
+        cwd: process.cwd(),
+        config: {},
+        services: new Map(),
+        verbose: false,
+        quiet: false,
+        outputFormat: 'text',
+        transport: null,
+    };
+    // 5. Create Commander program
+    const program = createCommanderProgram(registry, router, context);
+    // 6. Parse arguments
+    await program.parseAsync(process.argv);
+}
+/**
+ * Register example commands
+ */
+function registerCommands(registry) {
+    // Help command
+    registry.register({
+        name: 'help',
+        description: 'Display help information',
+        handler: async () => ({
+            success: true,
+            message: 'Use --help with any command for more information',
+        }),
+    });
+    // Services namespace
+    registry.register({
+        name: 'health',
+        namespace: 'services',
+        description: 'Check health of Nexus services',
+        options: [
+            {
+                long: 'service',
+                short: 's',
+                description: 'Specific service to check',
+                type: 'string',
+            },
+        ],
+        handler: async (args) => ({
+            success: true,
+            data: {
+                service: args.service || 'all',
+                status: 'healthy',
+            },
+        }),
+        examples: [
+            'nexus services health',
+            'nexus services health --service graphrag',
+        ],
+    });
+    registry.register({
+        name: 'start',
+        namespace: 'services',
+        description: 'Start Nexus services',
+        args: [
+            {
+                name: 'services',
+                description: 'Services to start',
+                required: false,
+                type: 'array',
+                variadic: true,
+            },
+        ],
+        handler: async (args) => ({
+            success: true,
+            message: `Starting services: ${args._.join(', ') || 'all'}`,
+        }),
+        examples: ['nexus services start', 'nexus services start graphrag mageagent'],
+    });
+    // GraphRAG namespace
+    registry.register({
+        name: 'query',
+        namespace: 'graphrag',
+        description: 'Query the GraphRAG service',
+        args: [
+            {
+                name: 'query',
+                description: 'Query string',
+                required: true,
+                type: 'string',
+            },
+        ],
+        options: [
+            {
+                long: 'limit',
+                short: 'l',
+                description: 'Number of results',
+                type: 'number',
+                default: 10,
+            },
+            {
+                long: 'format',
+                short: 'f',
+                description: 'Output format',
+                type: 'string',
+                choices: ['text', 'json', 'markdown'],
+                default: 'text',
+            },
+        ],
+        handler: async (args) => ({
+            success: true,
+            data: {
+                query: args._[0],
+                results: [],
+                limit: args.limit,
+            },
+        }),
+        examples: [
+            'nexus graphrag query "What is the architecture?"',
+            'nexus graphrag query "Find errors" --limit 5',
+        ],
+    });
+    // MageAgent namespace
+    registry.register({
+        name: 'run',
+        namespace: 'mageagent',
+        description: 'Run a MageAgent task',
+        args: [
+            {
+                name: 'task',
+                description: 'Task description',
+                required: true,
+                type: 'string',
+            },
+        ],
+        options: [
+            {
+                long: 'interactive',
+                short: 'i',
+                description: 'Interactive mode',
+                type: 'boolean',
+            },
+            {
+                long: 'timeout',
+                short: 't',
+                description: 'Task timeout in seconds',
+                type: 'number',
+                default: 300,
+            },
+        ],
+        handler: async (args) => ({
+            success: true,
+            message: `Running task: ${args._[0]}`,
+            data: {
+                task: args._[0],
+                interactive: args.interactive || false,
+                timeout: args.timeout,
+            },
+        }),
+        examples: [
+            'nexus mageagent run "Analyze code quality"',
+            'nexus mageagent run "Fix bugs" --interactive',
+        ],
+    });
+}
+/**
+ * Run CLI
+ */
+if (import.meta.url === `file://${process.argv[1]}`) {
+    setupCLI().catch((error) => {
+        console.error('Fatal error:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=commander-integration.js.map

package/dist/core/router/examples/commander-integration.js.map

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

package/dist/core/router/index.d.ts

@@ -1,9 +1,17 @@
 /**
  * Router Layer Index
  *
- * Export command router and registry
+ * Exports command router and registry components for the Nexus CLI
+ *
+ * The router layer provides:
+ * - Command registration and management (CommandRegistry)
+ * - Command routing and execution (CommandRouter)
+ * - Dynamic command discovery from services and MCP tools
+ * - Middleware support for cross-cutting concerns
+ * - Validation and error handling
  */
-export { CommandRegistry, createCommandRegistry } from './command-registry.js';
-export { CommandRouter, createCommandRouter } from './command-router.js';
-export type { Command, CommandHandler, CommandContext, CommandResult } from '../../types/command.js';
+export { CommandRegistry, createCommandRegistry, } from './command-registry.js';
+export { CommandRouter, createCommandRouter, type CommandMiddleware, } from './command-router.js';
+export { authMiddleware, workspaceMiddleware, loggingMiddleware, errorHandlingMiddleware, telemetryMiddleware, dryRunMiddleware, confirmationMiddleware, rateLimitMiddleware, createDefaultMiddleware, } from './middleware.js';
+export type { Command, CommandHandler, CommandContext, CommandResult, CommandArgs, CommandValidator, ValidationResult, ValidationError, DynamicCommandSource, ArgumentDefinition, OptionDefinition, ArgumentType, WorkspaceInfo, } from '@adverant-nexus/types';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/router/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/router/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACzE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/router/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EACL,eAAe,EACf,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,OAAO,EACP,cAAc,EACd,cAAc,EACd,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,aAAa,GACd,MAAM,uBAAuB,CAAC"}

package/dist/core/router/index.js

@@ -1,8 +1,19 @@
 /**
  * Router Layer Index
  *
- * Export command router and registry
+ * Exports command router and registry components for the Nexus CLI
+ *
+ * The router layer provides:
+ * - Command registration and management (CommandRegistry)
+ * - Command routing and execution (CommandRouter)
+ * - Dynamic command discovery from services and MCP tools
+ * - Middleware support for cross-cutting concerns
+ * - Validation and error handling
  */
-export { CommandRegistry, createCommandRegistry } from './command-registry.js';
-export { CommandRouter, createCommandRouter } from './command-router.js';
+// Registry exports
+export { CommandRegistry, createCommandRegistry, } from './command-registry.js';
+// Router exports
+export { CommandRouter, createCommandRouter, } from './command-router.js';
+// Middleware exports
+export { authMiddleware, workspaceMiddleware, loggingMiddleware, errorHandlingMiddleware, telemetryMiddleware, dryRunMiddleware, confirmationMiddleware, rateLimitMiddleware, createDefaultMiddleware, } from './middleware.js';
 //# sourceMappingURL=index.js.map

package/dist/core/router/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/router/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/router/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,iBAAiB;AACjB,OAAO,EACL,aAAa,EACb,mBAAmB,GAEpB,MAAM,qBAAqB,CAAC;AAE7B,qBAAqB;AACrB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC"}

package/dist/core/router/middleware.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Built-in Command Middleware
+ *
+ * Common middleware functions for command execution:
+ * - Authentication checks
+ * - Logging and telemetry
+ * - Error handling
+ * - Performance tracking
+ */
+import type { Command, CommandArgs, CommandContext, CommandResult } from '@adverant-nexus/types';
+/**
+ * Middleware function type
+ */
+export type CommandMiddleware = (command: Command, args: CommandArgs, context: CommandContext, next: () => Promise<CommandResult>) => Promise<CommandResult>;
+/**
+ * Authentication middleware
+ *
+ * Checks if user is authenticated when command requires it
+ */
+export declare function authMiddleware(): CommandMiddleware;
+/**
+ * Workspace validation middleware
+ *
+ * Checks if command is run within a workspace when required
+ */
+export declare function workspaceMiddleware(): CommandMiddleware;
+/**
+ * Logging middleware
+ *
+ * Logs command execution with timing information
+ */
+export declare function loggingMiddleware(verbose?: boolean): CommandMiddleware;
+/**
+ * Error handling middleware
+ *
+ * Catches and formats errors consistently
+ */
+export declare function errorHandlingMiddleware(): CommandMiddleware;
+/**
+ * Telemetry middleware
+ *
+ * Tracks command usage for analytics
+ */
+export declare function telemetryMiddleware(onCommandExecuted?: (command: Command, args: CommandArgs, result: CommandResult, duration: number) => void): CommandMiddleware;
+/**
+ * Dry-run middleware
+ *
+ * Prevents command execution when --dry-run flag is set
+ */
+export declare function dryRunMiddleware(): CommandMiddleware;
+/**
+ * Confirmation middleware
+ *
+ * Asks for confirmation before executing destructive commands
+ */
+export declare function confirmationMiddleware(isDestructive: (command: Command) => boolean, confirm: (message: string) => Promise<boolean>): CommandMiddleware;
+/**
+ * Rate limiting middleware
+ *
+ * Prevents command from being executed too frequently
+ */
+export declare function rateLimitMiddleware(maxExecutions: number, windowMs: number): CommandMiddleware;
+/**
+ * Create default middleware stack
+ *
+ * Returns commonly used middleware in recommended order
+ */
+export declare function createDefaultMiddleware(options?: {
+    verbose?: boolean;
+    telemetry?: (command: Command, args: CommandArgs, result: CommandResult, duration: number) => void;
+    confirm?: (message: string) => Promise<boolean>;
+    isDestructive?: (command: Command) => boolean;
+}): CommandMiddleware[];
+//# sourceMappingURL=middleware.d.ts.map

package/dist/core/router/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/core/router/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,WAAW,EACX,cAAc,EACd,aAAa,EACd,MAAM,uBAAuB,CAAC;AAE/B;;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;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,iBAAiB,CAWlD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,iBAAiB,CAWvD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,OAAe,GAAG,iBAAiB,CAwB7E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAoB3D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,iBAAiB,CAAC,EAAE,CAClB,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,KACb,IAAI,GACR,iBAAiB,CAoBnB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,CAuBpD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,EAC5C,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAC7C,iBAAiB,CA2BnB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,iBAAiB,CAkCnB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,CACV,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,KACb,IAAI,CAAC;IACV,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;CAC/C,GAAG,iBAAiB,EAAE,CA+BtB"}