@navios/commander 1.6.0 → 1.8.0

package/lib/index.d.mts

@@ -214,6 +214,7 @@ interface ParsedCliArgs {
   /**
    * Parsed options as key-value pairs.
    * Keys are converted from kebab-case to camelCase.
+   * Supports object notation (e.g., --obj.field=value creates { obj: { field: value } }).
    */
   options: Record<string, any>;
   /**
@@ -230,6 +231,8 @@ interface ParsedCliArgs {
  * - Boolean flags
  * - Array options
  * - Positional arguments
+ * - Object notation: `--obj.field=value` or `--obj.nested.field value`
+ *   Creates nested objects automatically (e.g., { obj: { field: value } })
  *
  * @public
  */
@@ -241,9 +244,21 @@ declare class CliParserService {
    *
    * @param argv - Array of command-line arguments (typically process.argv)
    * @param optionsSchema - Optional zod/v4 schema to determine boolean flags and option types
+   * @param availableCommands - Optional list of registered command paths for smart detection.
+   *   When provided, scans argv to find the best matching command, enabling support for
+   *   custom launchers (tsx, ts-node, npx, etc.) that add extra args before the command.
    * @returns Parsed command (space-separated if multi-word), options, and positional arguments
    */
-  parse(argv: string[], optionsSchema?: z.ZodObject): ParsedCliArgs;
+  parse(argv: string[], optionsSchema?: z.ZodObject, availableCommands?: string[]): ParsedCliArgs;
+  /**
+   * Finds the index in argv where the command starts by matching against available commands.
+   * Prioritizes longer/more specific commands (e.g., 'db migrate' matches before 'db').
+   *
+   * @param argv - Full argv array
+   * @param availableCommands - List of registered command paths
+   * @returns Index where the command starts, or 2 as fallback
+   */
+  private findCommandStartIndex;
   /**
    * Converts kebab-case to camelCase
    */
@@ -272,6 +287,45 @@ declare class CliParserService {
    * Unwraps zod/v4Optional and zod/v4Default using zod/v4 v4 API
    */
   private isSchemaArray;
+  /**
+   * Sets a nested property on an object using dot notation path.
+   * Creates intermediate objects as needed.
+   *
+   * @example
+   * setNestedProperty({}, 'a.b.c', 'value') // { a: { b: { c: 'value' } } }
+   */
+  private setNestedProperty;
+  /**
+   * Gets a nested property from an object using dot notation path.
+   * Returns undefined if path doesn't exist.
+   */
+  private getNestedProperty;
+  /**
+   * Checks if an option key contains dot notation (object notation).
+   * Returns true for keys like "obj.field" or "deep.nested.value".
+   */
+  private isObjectNotation;
+  /**
+   * Processes an option key that may contain object notation.
+   * Converts each segment from kebab-case to camelCase.
+   *
+   * @example
+   * processObjectNotationKey('my-obj.field-name') // 'myObj.fieldName'
+   */
+  private processObjectNotationKey;
+  /**
+   * Gets the nested schema for a given dot-notation path.
+   * Returns undefined if the path doesn't lead to a valid schema.
+   */
+  private getNestedSchema;
+  /**
+   * Checks if a nested path represents a boolean field in the schema.
+   */
+  private isNestedBoolean;
+  /**
+   * Checks if a nested path represents an array field in the schema.
+   */
+  private isNestedArray;
 }
 //#endregion
 //#region src/metadata/command-entry.metadata.d.mts
@@ -377,6 +431,11 @@ declare class CommandRegistryService {
    * @returns Formatted string with command help
    */
   formatCommandHelp(commandPath: string): string;
+  /**
+   * Recursively formats nested object options for help display.
+   * Shows nested fields with dot notation (e.g., --config.port)
+   */
+  private formatNestedObjectOptions;
   /**
    * Gets a human-readable type name from a zod/v4 schema.
    */
@@ -387,6 +446,13 @@ declare class CommandRegistryService {
    * or in innerType when .meta() is called before .optional()/.default().
    */
   private getSchemaMeta;
+  /**
+   * Get all registered command paths.
+   * Useful for smart command detection in argv parsing.
+   *
+   * @returns Array of command paths
+   */
+  getAllPaths(): string[];
   /**
    * Clear all registered commands.
    */

package/lib/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":["z","CommandHandler","helpOptionsSchema","ZodString","ZodOptional","core","$strip","ZodObject","HelpOptions","infer","HelpCommand","Promise","ClassTypeWithInstance","LogLevel","NaviosApplication","NaviosModule","CliEnvironment","CommanderLoggerOptions","CommanderTuiOptions","Record","CommanderFactoryOptions","CommanderFactory","TModule","Promise","z","ParsedCliArgs","Record","CliParserService","ZodObject","ClassType","CommandEntryKey","CommandEntryValue","Set","extractModuleCommands","ClassType","CommandMetadata","RegisteredCommand","CommandRegistryService","Map","Array","ClassType","ModuleMetadata","AbstractCliAdapterInterface","CliAdapterOptions","CommanderAdapterService","Promise","Map","Record","Array","AnyInjectableType","InjectionToken","CliParserService","CommandRegistryService","CommanderAdapterService","defineCliEnvironment","Map","InjectionToken","CommanderExecutionContext","CommandExecutionContext"],"sources":["../src/commands/help.command.d.mts","../src/commander.factory.d.mts","../src/services/cli-parser.service.d.mts","../src/metadata/command-entry.metadata.d.mts","../src/services/command-registry.service.d.mts","../src/services/commander-adapter.service.d.mts","../src/define-environment.d.mts","../src/tokens/execution-context.token.d.mts"],"sourcesContent":["import { z } from 'zod/v4'\n\nimport type { CommandHandler } from '../interfaces/command-handler.interface.mjs'\ndeclare const helpOptionsSchema: z.ZodObject<\n  {\n    command: z.ZodOptional<z.ZodString>\n  },\n  z.core.$strip\n>\ntype HelpOptions = z.infer<typeof helpOptionsSchema>\n/**\n * Built-in help command that lists all available commands or shows help for a specific command.\n *\n * @public\n */\nexport declare class HelpCommand implements CommandHandler<HelpOptions> {\n  private logger\n  private commandRegistry\n  execute(options: HelpOptions): Promise<void>\n}\nexport {}\n//# sourceMappingURL=help.command.d.mts.map\n","import type { ClassTypeWithInstance, LogLevel, NaviosApplication, NaviosModule } from '@navios/core'\n\nimport type { CliEnvironment } from './interfaces/environment.interface.mjs'\n/**\n * Logger display options for CLI applications.\n * All options default to false for cleaner CLI output.\n *\n * @public\n */\nexport interface CommanderLoggerOptions {\n  /**\n   * Enabled log levels.\n   * @default ['log', 'error', 'warn', 'debug', 'verbose', 'fatal']\n   */\n  logLevels?: LogLevel[]\n  /**\n   * If true, will print the process ID in the log message.\n   * @default false\n   */\n  showPid?: boolean\n  /**\n   * If true, will print the log level in the log message.\n   * @default true\n   */\n  showLogLevel?: boolean\n  /**\n   * If true, will print the prefix/app name in the log message.\n   * @default false\n   */\n  showPrefix?: boolean\n  /**\n   * If true, will print the context in the log message.\n   * @default true\n   */\n  showContext?: boolean\n  /**\n   * If true, will print the absolute timestamp in the log message.\n   * @default false\n   */\n  showTimestamp?: boolean\n  /**\n   * If enabled, will print timestamp difference between current and previous log message.\n   * @default false\n   */\n  showTimeDiff?: boolean\n}\n/**\n * TUI-specific options for terminal UI mode.\n * Only used when enableTUI is true.\n *\n * @public\n */\nexport interface CommanderTuiOptions {\n  /**\n   * Exit on Ctrl+C.\n   * @default true\n   */\n  exitOnCtrlC?: boolean\n  /**\n   * Adapter to use for the TUI.\n   * @default 'none'\n   */\n  adapter?: 'react' | 'solid' | 'ink' | 'none'\n  /**\n   * Sidebar width in columns.\n   */\n  sidebarWidth?: number\n  /**\n   * Sidebar position.\n   */\n  sidebarPosition?: 'left' | 'right'\n  /**\n   * Sidebar header title.\n   */\n  sidebarTitle?: string\n  /**\n   * Auto close after all screens complete successfully.\n   * Set to true for default delay (5000ms), or specify delay in milliseconds.\n   */\n  autoClose?: boolean | number\n  /**\n   * Theme preset name ('dark', 'light', 'high-contrast') or custom theme object.\n   */\n  theme?: string | Record<string, unknown>\n  /**\n   * Enable mouse support.\n   * @default false\n   */\n  useMouse?: boolean\n  /**\n   * Hide the default console logger screen from the sidebar.\n   * @default false\n   */\n  hideDefaultScreen?: boolean\n  /**\n   * Use OpenTUI for terminal rendering.\n   * When true: Full TUI with sidebar, scrolling, interactive prompts.\n   * When false: Stdout mode - static screens print immediately, others on completion.\n   * @default true for Node.js, false for Bun (OpenTUI not supported)\n   */\n  useOpenTUI?: boolean\n}\n/**\n * Configuration options for CommanderFactory.\n *\n * @public\n */\nexport interface CommanderFactoryOptions {\n  /**\n   * Enabled log levels.\n   * @default ['log', 'error', 'warn', 'debug', 'verbose', 'fatal']\n   */\n  logLevels?: LogLevel[]\n  /**\n   * Logger display options. These override the default CLI-friendly logger settings.\n   * Ignored when enableTUI is true.\n   */\n  logger?: CommanderLoggerOptions\n  /**\n   * Enable TUI mode with @navios/commander-tui.\n   * Requires @navios/commander-tui to be installed.\n   */\n  enableTUI?: boolean\n  /**\n   * TUI-specific options. Only used when enableTUI is true.\n   */\n  tuiOptions?: CommanderTuiOptions\n}\n/**\n * Factory class for creating CLI applications.\n *\n * This is a convenience wrapper around `NaviosFactory.create()` that\n * configures everything needed for CLI usage. It sets up the CLI adapter\n * and returns a typed `NaviosApplication<CliEnvironment>`.\n *\n * @example\n * ```typescript\n * import { CommanderFactory } from '@navios/commander'\n * import { AppModule } from './app.module'\n *\n * async function bootstrap() {\n *   const app = await CommanderFactory.create(AppModule)\n *   await app.init()\n *\n *   const adapter = app.getAdapter()\n *   await adapter.run(process.argv)\n *\n *   await app.close()\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Alternative: use NaviosFactory directly\n * import { NaviosFactory } from '@navios/core'\n * import { defineCliEnvironment, type CliEnvironment } from '@navios/commander'\n *\n * const app = await NaviosFactory.create<CliEnvironment>(AppModule, {\n *   adapter: defineCliEnvironment(),\n * })\n * ```\n */\nexport declare class CommanderFactory {\n  /**\n   * Creates a new CLI application instance configured with the provided module.\n   *\n   * @param appModule - The root CLI module class decorated with `@CliModule`\n   * @param options - Optional configuration options for the CLI application\n   * @returns A promise that resolves to a configured NaviosApplication instance\n   *\n   * @example\n   * ```typescript\n   * const app = await CommanderFactory.create(AppModule)\n   * await app.init()\n   *\n   * const adapter = app.getAdapter()\n   * await adapter.run(process.argv)\n   * ```\n   */\n  static create<TModule extends NaviosModule = NaviosModule>(\n    appModule: ClassTypeWithInstance<TModule>,\n    options?: CommanderFactoryOptions,\n  ): Promise<NaviosApplication<CliEnvironment>>\n}\n//# sourceMappingURL=commander.factory.d.mts.map\n","import type { z } from 'zod/v4'\n/**\n * Result of parsing command-line arguments.\n *\n * @public\n */\nexport interface ParsedCliArgs {\n  /**\n   * The command path (e.g., 'greet', 'user:create').\n   * Multi-word commands are joined with spaces.\n   */\n  command: string\n  /**\n   * Parsed options as key-value pairs.\n   * Keys are converted from kebab-case to camelCase.\n   */\n  options: Record<string, any>\n  /**\n   * Positional arguments that don't match any option flags.\n   */\n  positionals: string[]\n}\n/**\n * Service for parsing command-line arguments.\n *\n * Handles parsing of various CLI argument formats including:\n * - Long options: `--key value` or `--key=value`\n * - Short options: `-k value` or `-abc` (multiple flags)\n * - Boolean flags\n * - Array options\n * - Positional arguments\n *\n * @public\n */\nexport declare class CliParserService {\n  /**\n   * Parses command-line arguments from process.argv\n   * Commands can be multi-word (e.g., 'db migrate', 'cache clear')\n   * Expected format: node script.js command [subcommand...] --flag value --boolean-flag positional1 positional2\n   *\n   * @param argv - Array of command-line arguments (typically process.argv)\n   * @param optionsSchema - Optional zod/v4 schema to determine boolean flags and option types\n   * @returns Parsed command (space-separated if multi-word), options, and positional arguments\n   */\n  parse(argv: string[], optionsSchema?: z.ZodObject): ParsedCliArgs\n  /**\n   * Converts kebab-case to camelCase\n   */\n  private camelCase\n  /**\n   * Attempts to parse string values into appropriate types\n   */\n  private parseValue\n  /**\n   * Extracts boolean field names from a zod/v4 schema\n   * Handles z.ZodObject, zod/v4Optional, and zod/v4Default wrappers\n   */\n  private extractBooleanFields\n  /**\n   * Extracts array field names from a zod/v4 schema\n   * Handles z.ZodObject, zod/v4Optional, and zod/v4Default wrappers\n   */\n  private extractArrayFields\n  /**\n   * Checks if a zod/v4 schema represents a boolean type\n   * Unwraps zod/v4Optional and zod/v4Default using zod/v4 v4 API\n   */\n  private isSchemaBoolean\n  /**\n   * Checks if a zod/v4 schema represents an array type\n   * Unwraps zod/v4Optional and zod/v4Default using zod/v4 v4 API\n   */\n  private isSchemaArray\n}\n//# sourceMappingURL=cli-parser.service.d.mts.map\n","import type { ClassType } from '@navios/core'\n/**\n * Symbol key for storing commands in ModuleMetadata.customEntries.\n * Used by @CliModule to store command classes.\n *\n * @public\n */\nexport declare const CommandEntryKey: unique symbol\n/**\n * Type for the command entry value stored in customEntries.\n *\n * @public\n */\nexport type CommandEntryValue = Set<ClassType>\n/**\n * Extracts commands from a module's metadata.\n * Returns empty set if no commands are defined.\n *\n * @param moduleClass - The module class decorated with @CliModule or @Module\n * @returns Set of command classes registered in the module\n *\n * @example\n * ```typescript\n * const commands = extractModuleCommands(AppModule)\n * for (const command of commands) {\n *   console.log(command.name)\n * }\n * ```\n */\nexport declare function extractModuleCommands(moduleClass: ClassType): Set<ClassType>\n//# sourceMappingURL=command-entry.metadata.d.mts.map\n","import type { ClassType } from '@navios/core'\n\nimport type { CommandMetadata } from '../metadata/index.mjs'\n/**\n * Represents a registered command with its metadata and module information.\n *\n * @public\n */\nexport interface RegisteredCommand {\n  /**\n   * The command class\n   */\n  class: ClassType\n  /**\n   * The command metadata from @Command decorator\n   */\n  metadata: CommandMetadata\n  /**\n   * Name of the module this command belongs to\n   */\n  moduleName: string\n}\n/**\n * Service for registering and looking up CLI commands.\n * Used internally by the CLI adapter to manage discovered commands.\n *\n * @public\n */\nexport declare class CommandRegistryService {\n  private commands\n  /**\n   * Register a command with its metadata.\n   *\n   * @param path - The command path (e.g., 'greet', 'user:create')\n   * @param command - The registered command data\n   * @throws Error if a command with the same path is already registered\n   */\n  register(path: string, command: RegisteredCommand): void\n  /**\n   * Get a command by its path.\n   *\n   * @param path - The command path\n   * @returns The registered command or undefined if not found\n   */\n  getByPath(path: string): RegisteredCommand | undefined\n  /**\n   * Get all registered commands.\n   *\n   * @returns Map of path to registered command\n   */\n  getAll(): Map<string, RegisteredCommand>\n  /**\n   * Get all registered commands as an array of path and class pairs.\n   * Useful for listing available commands.\n   *\n   * @returns Array of objects containing path and class\n   */\n  getAllAsArray(): Array<{\n    path: string\n    class: ClassType\n  }>\n  /**\n   * Formats help text listing all available commands with descriptions.\n   *\n   * @returns Formatted string listing all commands\n   */\n  formatCommandList(): string\n  /**\n   * Formats help text for a specific command.\n   *\n   * @param commandPath - The command path to show help for\n   * @returns Formatted string with command help\n   */\n  formatCommandHelp(commandPath: string): string\n  /**\n   * Gets a human-readable type name from a zod/v4 schema.\n   */\n  private getSchemaTypeName\n  /**\n   * Gets metadata from a zod/v4 schema, traversing innerType if needed.\n   * zod/v4 v4 stores meta at the outermost layer when .meta() is called last,\n   * or in innerType when .meta() is called before .optional()/.default().\n   */\n  private getSchemaMeta\n  /**\n   * Clear all registered commands.\n   */\n  clear(): void\n}\n//# sourceMappingURL=command-registry.service.d.mts.map\n","import type { ClassType, ModuleMetadata } from '@navios/core'\n\nimport type { AbstractCliAdapterInterface } from '../interfaces/abstract-cli-adapter.interface.mjs'\nimport type { CliAdapterOptions } from '../interfaces/environment.interface.mjs'\n/**\n * CLI adapter service that implements the AbstractCliAdapterInterface.\n * Handles command discovery, registration, parsing, and execution.\n *\n * @public\n */\nexport declare class CommanderAdapterService implements AbstractCliAdapterInterface {\n  private container\n  private commandRegistry\n  private cliParser\n  private logger\n  private options\n  private isReady\n  /**\n   * Sets up the adapter with the provided options.\n   * Called during application initialization.\n   */\n  setupAdapter(options: CliAdapterOptions): Promise<void>\n  /**\n   * Called after all modules are loaded.\n   * Iterates through modules and extracts commands from customEntries.\n   */\n  onModulesInit(modules: Map<string, ModuleMetadata>): Promise<void>\n  /**\n   * Registers built-in commands like help.\n   */\n  private registerBuiltInCommands\n  /**\n   * Signals that the adapter is ready to handle commands.\n   */\n  ready(): Promise<void>\n  /**\n   * Disposes of the adapter and cleans up resources.\n   */\n  dispose(): Promise<void>\n  /**\n   * Run the CLI application with the given arguments.\n   * Parses arguments and executes the matching command.\n   */\n  run(argv?: string[]): Promise<void>\n  /**\n   * Execute a command programmatically with the provided options.\n   */\n  executeCommand(\n    path: string,\n    options?: Record<string, unknown>,\n    positionals?: string[],\n  ): Promise<void>\n  /**\n   * Get all registered command paths and their class references.\n   */\n  getAllCommands(): Array<{\n    path: string\n    class: ClassType\n  }>\n}\n//# sourceMappingURL=commander-adapter.service.d.mts.map\n","import type { AnyInjectableType, InjectionToken } from '@navios/core'\n\nimport { CliParserService } from './services/cli-parser.service.mjs'\nimport { CommandRegistryService } from './services/command-registry.service.mjs'\nimport { CommanderAdapterService } from './services/commander-adapter.service.mjs'\n/**\n * Defines the CLI environment configuration for use with NaviosFactory.\n *\n * This function returns the token mappings needed to configure a CLI application.\n * Use it with `NaviosFactory.create()` to create a CLI application.\n *\n * @returns Environment configuration with token mappings\n *\n * @example\n * ```typescript\n * import { NaviosFactory } from '@navios/core'\n * import { defineCliEnvironment, type CliEnvironment } from '@navios/commander'\n *\n * const app = await NaviosFactory.create<CliEnvironment>(AppModule, {\n *   adapter: defineCliEnvironment(),\n * })\n * await app.init()\n *\n * const adapter = app.getAdapter() as AbstractCliAdapterInterface\n * await adapter.run(process.argv)\n * ```\n */\nexport declare function defineCliEnvironment(): {\n  tokens: Map<InjectionToken<any, undefined, false>, AnyInjectableType>\n}\nexport { CommanderAdapterService, CommandRegistryService, CliParserService }\n//# sourceMappingURL=define-environment.d.mts.map\n","import { InjectionToken } from '@navios/core'\n\nimport type { CommanderExecutionContext } from '../interfaces/index.mjs'\n/**\n * Injection token for accessing the current command execution context.\n *\n * Use this token with `inject()` to access the `CommanderExecutionContext` in services\n * that need information about the currently executing command.\n *\n * @example\n * ```typescript\n * import { inject, Injectable } from '@navios/core'\n * import { CommandExecutionContext } from '@navios/commander'\n *\n * @Injectable()\n * class MyService {\n *   private ctx = inject(CommandExecutionContext)\n *\n *   doSomething() {\n *     const commandPath = this.ctx.getCommandPath()\n *     const options = this.ctx.getOptions()\n *     // Use context information...\n *   }\n * }\n * ```\n */\nexport declare const CommandExecutionContext: InjectionToken<\n  CommanderExecutionContext,\n  undefined,\n  false\n>\n//# sourceMappingURL=execution-context.token.d.mts.map\n"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":["z","CommandHandler","helpOptionsSchema","ZodString","ZodOptional","core","$strip","ZodObject","HelpOptions","infer","HelpCommand","Promise","ClassTypeWithInstance","LogLevel","NaviosApplication","NaviosModule","CliEnvironment","CommanderLoggerOptions","CommanderTuiOptions","Record","CommanderFactoryOptions","CommanderFactory","TModule","Promise","z","ParsedCliArgs","Record","CliParserService","ZodObject","ClassType","CommandEntryKey","CommandEntryValue","Set","extractModuleCommands","ClassType","CommandMetadata","RegisteredCommand","CommandRegistryService","Map","Array","ClassType","ModuleMetadata","AbstractCliAdapterInterface","CliAdapterOptions","CommanderAdapterService","Promise","Map","Record","Array","AnyInjectableType","InjectionToken","CliParserService","CommandRegistryService","CommanderAdapterService","defineCliEnvironment","Map","InjectionToken","CommanderExecutionContext","CommandExecutionContext"],"sources":["../src/commands/help.command.d.mts","../src/commander.factory.d.mts","../src/services/cli-parser.service.d.mts","../src/metadata/command-entry.metadata.d.mts","../src/services/command-registry.service.d.mts","../src/services/commander-adapter.service.d.mts","../src/define-environment.d.mts","../src/tokens/execution-context.token.d.mts"],"sourcesContent":["import { z } from 'zod/v4'\n\nimport type { CommandHandler } from '../interfaces/command-handler.interface.mjs'\ndeclare const helpOptionsSchema: z.ZodObject<\n  {\n    command: z.ZodOptional<z.ZodString>\n  },\n  z.core.$strip\n>\ntype HelpOptions = z.infer<typeof helpOptionsSchema>\n/**\n * Built-in help command that lists all available commands or shows help for a specific command.\n *\n * @public\n */\nexport declare class HelpCommand implements CommandHandler<HelpOptions> {\n  private logger\n  private commandRegistry\n  execute(options: HelpOptions): Promise<void>\n}\nexport {}\n//# sourceMappingURL=help.command.d.mts.map\n","import type { ClassTypeWithInstance, LogLevel, NaviosApplication, NaviosModule } from '@navios/core'\n\nimport type { CliEnvironment } from './interfaces/environment.interface.mjs'\n/**\n * Logger display options for CLI applications.\n * All options default to false for cleaner CLI output.\n *\n * @public\n */\nexport interface CommanderLoggerOptions {\n  /**\n   * Enabled log levels.\n   * @default ['log', 'error', 'warn', 'debug', 'verbose', 'fatal']\n   */\n  logLevels?: LogLevel[]\n  /**\n   * If true, will print the process ID in the log message.\n   * @default false\n   */\n  showPid?: boolean\n  /**\n   * If true, will print the log level in the log message.\n   * @default true\n   */\n  showLogLevel?: boolean\n  /**\n   * If true, will print the prefix/app name in the log message.\n   * @default false\n   */\n  showPrefix?: boolean\n  /**\n   * If true, will print the context in the log message.\n   * @default true\n   */\n  showContext?: boolean\n  /**\n   * If true, will print the absolute timestamp in the log message.\n   * @default false\n   */\n  showTimestamp?: boolean\n  /**\n   * If enabled, will print timestamp difference between current and previous log message.\n   * @default false\n   */\n  showTimeDiff?: boolean\n}\n/**\n * TUI-specific options for terminal UI mode.\n * Only used when enableTUI is true.\n *\n * @public\n */\nexport interface CommanderTuiOptions {\n  /**\n   * Exit on Ctrl+C.\n   * @default true\n   */\n  exitOnCtrlC?: boolean\n  /**\n   * Adapter to use for the TUI.\n   * @default 'none'\n   */\n  adapter?: 'react' | 'solid' | 'ink' | 'none'\n  /**\n   * Sidebar width in columns.\n   */\n  sidebarWidth?: number\n  /**\n   * Sidebar position.\n   */\n  sidebarPosition?: 'left' | 'right'\n  /**\n   * Sidebar header title.\n   */\n  sidebarTitle?: string\n  /**\n   * Auto close after all screens complete successfully.\n   * Set to true for default delay (5000ms), or specify delay in milliseconds.\n   */\n  autoClose?: boolean | number\n  /**\n   * Theme preset name ('dark', 'light', 'high-contrast') or custom theme object.\n   */\n  theme?: string | Record<string, unknown>\n  /**\n   * Enable mouse support.\n   * @default false\n   */\n  useMouse?: boolean\n  /**\n   * Hide the default console logger screen from the sidebar.\n   * @default false\n   */\n  hideDefaultScreen?: boolean\n  /**\n   * Use OpenTUI for terminal rendering.\n   * When true: Full TUI with sidebar, scrolling, interactive prompts.\n   * When false: Stdout mode - static screens print immediately, others on completion.\n   * @default true for Node.js, false for Bun (OpenTUI not supported)\n   */\n  useOpenTUI?: boolean\n}\n/**\n * Configuration options for CommanderFactory.\n *\n * @public\n */\nexport interface CommanderFactoryOptions {\n  /**\n   * Enabled log levels.\n   * @default ['log', 'error', 'warn', 'debug', 'verbose', 'fatal']\n   */\n  logLevels?: LogLevel[]\n  /**\n   * Logger display options. These override the default CLI-friendly logger settings.\n   * Ignored when enableTUI is true.\n   */\n  logger?: CommanderLoggerOptions\n  /**\n   * Enable TUI mode with @navios/commander-tui.\n   * Requires @navios/commander-tui to be installed.\n   */\n  enableTUI?: boolean\n  /**\n   * TUI-specific options. Only used when enableTUI is true.\n   */\n  tuiOptions?: CommanderTuiOptions\n}\n/**\n * Factory class for creating CLI applications.\n *\n * This is a convenience wrapper around `NaviosFactory.create()` that\n * configures everything needed for CLI usage. It sets up the CLI adapter\n * and returns a typed `NaviosApplication<CliEnvironment>`.\n *\n * @example\n * ```typescript\n * import { CommanderFactory } from '@navios/commander'\n * import { AppModule } from './app.module'\n *\n * async function bootstrap() {\n *   const app = await CommanderFactory.create(AppModule)\n *   await app.init()\n *\n *   const adapter = app.getAdapter()\n *   await adapter.run(process.argv)\n *\n *   await app.close()\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Alternative: use NaviosFactory directly\n * import { NaviosFactory } from '@navios/core'\n * import { defineCliEnvironment, type CliEnvironment } from '@navios/commander'\n *\n * const app = await NaviosFactory.create<CliEnvironment>(AppModule, {\n *   adapter: defineCliEnvironment(),\n * })\n * ```\n */\nexport declare class CommanderFactory {\n  /**\n   * Creates a new CLI application instance configured with the provided module.\n   *\n   * @param appModule - The root CLI module class decorated with `@CliModule`\n   * @param options - Optional configuration options for the CLI application\n   * @returns A promise that resolves to a configured NaviosApplication instance\n   *\n   * @example\n   * ```typescript\n   * const app = await CommanderFactory.create(AppModule)\n   * await app.init()\n   *\n   * const adapter = app.getAdapter()\n   * await adapter.run(process.argv)\n   * ```\n   */\n  static create<TModule extends NaviosModule = NaviosModule>(\n    appModule: ClassTypeWithInstance<TModule>,\n    options?: CommanderFactoryOptions,\n  ): Promise<NaviosApplication<CliEnvironment>>\n}\n//# sourceMappingURL=commander.factory.d.mts.map\n","import type { z } from 'zod/v4'\n/**\n * Result of parsing command-line arguments.\n *\n * @public\n */\nexport interface ParsedCliArgs {\n  /**\n   * The command path (e.g., 'greet', 'user:create').\n   * Multi-word commands are joined with spaces.\n   */\n  command: string\n  /**\n   * Parsed options as key-value pairs.\n   * Keys are converted from kebab-case to camelCase.\n   * Supports object notation (e.g., --obj.field=value creates { obj: { field: value } }).\n   */\n  options: Record<string, any>\n  /**\n   * Positional arguments that don't match any option flags.\n   */\n  positionals: string[]\n}\n/**\n * Service for parsing command-line arguments.\n *\n * Handles parsing of various CLI argument formats including:\n * - Long options: `--key value` or `--key=value`\n * - Short options: `-k value` or `-abc` (multiple flags)\n * - Boolean flags\n * - Array options\n * - Positional arguments\n * - Object notation: `--obj.field=value` or `--obj.nested.field value`\n *   Creates nested objects automatically (e.g., { obj: { field: value } })\n *\n * @public\n */\nexport declare class CliParserService {\n  /**\n   * Parses command-line arguments from process.argv\n   * Commands can be multi-word (e.g., 'db migrate', 'cache clear')\n   * Expected format: node script.js command [subcommand...] --flag value --boolean-flag positional1 positional2\n   *\n   * @param argv - Array of command-line arguments (typically process.argv)\n   * @param optionsSchema - Optional zod/v4 schema to determine boolean flags and option types\n   * @param availableCommands - Optional list of registered command paths for smart detection.\n   *   When provided, scans argv to find the best matching command, enabling support for\n   *   custom launchers (tsx, ts-node, npx, etc.) that add extra args before the command.\n   * @returns Parsed command (space-separated if multi-word), options, and positional arguments\n   */\n  parse(argv: string[], optionsSchema?: z.ZodObject, availableCommands?: string[]): ParsedCliArgs\n  /**\n   * Finds the index in argv where the command starts by matching against available commands.\n   * Prioritizes longer/more specific commands (e.g., 'db migrate' matches before 'db').\n   *\n   * @param argv - Full argv array\n   * @param availableCommands - List of registered command paths\n   * @returns Index where the command starts, or 2 as fallback\n   */\n  private findCommandStartIndex\n  /**\n   * Converts kebab-case to camelCase\n   */\n  private camelCase\n  /**\n   * Attempts to parse string values into appropriate types\n   */\n  private parseValue\n  /**\n   * Extracts boolean field names from a zod/v4 schema\n   * Handles z.ZodObject, zod/v4Optional, and zod/v4Default wrappers\n   */\n  private extractBooleanFields\n  /**\n   * Extracts array field names from a zod/v4 schema\n   * Handles z.ZodObject, zod/v4Optional, and zod/v4Default wrappers\n   */\n  private extractArrayFields\n  /**\n   * Checks if a zod/v4 schema represents a boolean type\n   * Unwraps zod/v4Optional and zod/v4Default using zod/v4 v4 API\n   */\n  private isSchemaBoolean\n  /**\n   * Checks if a zod/v4 schema represents an array type\n   * Unwraps zod/v4Optional and zod/v4Default using zod/v4 v4 API\n   */\n  private isSchemaArray\n  /**\n   * Sets a nested property on an object using dot notation path.\n   * Creates intermediate objects as needed.\n   *\n   * @example\n   * setNestedProperty({}, 'a.b.c', 'value') // { a: { b: { c: 'value' } } }\n   */\n  private setNestedProperty\n  /**\n   * Gets a nested property from an object using dot notation path.\n   * Returns undefined if path doesn't exist.\n   */\n  private getNestedProperty\n  /**\n   * Checks if an option key contains dot notation (object notation).\n   * Returns true for keys like \"obj.field\" or \"deep.nested.value\".\n   */\n  private isObjectNotation\n  /**\n   * Processes an option key that may contain object notation.\n   * Converts each segment from kebab-case to camelCase.\n   *\n   * @example\n   * processObjectNotationKey('my-obj.field-name') // 'myObj.fieldName'\n   */\n  private processObjectNotationKey\n  /**\n   * Gets the nested schema for a given dot-notation path.\n   * Returns undefined if the path doesn't lead to a valid schema.\n   */\n  private getNestedSchema\n  /**\n   * Checks if a nested path represents a boolean field in the schema.\n   */\n  private isNestedBoolean\n  /**\n   * Checks if a nested path represents an array field in the schema.\n   */\n  private isNestedArray\n}\n//# sourceMappingURL=cli-parser.service.d.mts.map\n","import type { ClassType } from '@navios/core'\n/**\n * Symbol key for storing commands in ModuleMetadata.customEntries.\n * Used by @CliModule to store command classes.\n *\n * @public\n */\nexport declare const CommandEntryKey: unique symbol\n/**\n * Type for the command entry value stored in customEntries.\n *\n * @public\n */\nexport type CommandEntryValue = Set<ClassType>\n/**\n * Extracts commands from a module's metadata.\n * Returns empty set if no commands are defined.\n *\n * @param moduleClass - The module class decorated with @CliModule or @Module\n * @returns Set of command classes registered in the module\n *\n * @example\n * ```typescript\n * const commands = extractModuleCommands(AppModule)\n * for (const command of commands) {\n *   console.log(command.name)\n * }\n * ```\n */\nexport declare function extractModuleCommands(moduleClass: ClassType): Set<ClassType>\n//# sourceMappingURL=command-entry.metadata.d.mts.map\n","import type { ClassType } from '@navios/core'\n\nimport type { CommandMetadata } from '../metadata/index.mjs'\n/**\n * Represents a registered command with its metadata and module information.\n *\n * @public\n */\nexport interface RegisteredCommand {\n  /**\n   * The command class\n   */\n  class: ClassType\n  /**\n   * The command metadata from @Command decorator\n   */\n  metadata: CommandMetadata\n  /**\n   * Name of the module this command belongs to\n   */\n  moduleName: string\n}\n/**\n * Service for registering and looking up CLI commands.\n * Used internally by the CLI adapter to manage discovered commands.\n *\n * @public\n */\nexport declare class CommandRegistryService {\n  private commands\n  /**\n   * Register a command with its metadata.\n   *\n   * @param path - The command path (e.g., 'greet', 'user:create')\n   * @param command - The registered command data\n   * @throws Error if a command with the same path is already registered\n   */\n  register(path: string, command: RegisteredCommand): void\n  /**\n   * Get a command by its path.\n   *\n   * @param path - The command path\n   * @returns The registered command or undefined if not found\n   */\n  getByPath(path: string): RegisteredCommand | undefined\n  /**\n   * Get all registered commands.\n   *\n   * @returns Map of path to registered command\n   */\n  getAll(): Map<string, RegisteredCommand>\n  /**\n   * Get all registered commands as an array of path and class pairs.\n   * Useful for listing available commands.\n   *\n   * @returns Array of objects containing path and class\n   */\n  getAllAsArray(): Array<{\n    path: string\n    class: ClassType\n  }>\n  /**\n   * Formats help text listing all available commands with descriptions.\n   *\n   * @returns Formatted string listing all commands\n   */\n  formatCommandList(): string\n  /**\n   * Formats help text for a specific command.\n   *\n   * @param commandPath - The command path to show help for\n   * @returns Formatted string with command help\n   */\n  formatCommandHelp(commandPath: string): string\n  /**\n   * Recursively formats nested object options for help display.\n   * Shows nested fields with dot notation (e.g., --config.port)\n   */\n  private formatNestedObjectOptions\n  /**\n   * Gets a human-readable type name from a zod/v4 schema.\n   */\n  private getSchemaTypeName\n  /**\n   * Gets metadata from a zod/v4 schema, traversing innerType if needed.\n   * zod/v4 v4 stores meta at the outermost layer when .meta() is called last,\n   * or in innerType when .meta() is called before .optional()/.default().\n   */\n  private getSchemaMeta\n  /**\n   * Get all registered command paths.\n   * Useful for smart command detection in argv parsing.\n   *\n   * @returns Array of command paths\n   */\n  getAllPaths(): string[]\n  /**\n   * Clear all registered commands.\n   */\n  clear(): void\n}\n//# sourceMappingURL=command-registry.service.d.mts.map\n","import type { ClassType, ModuleMetadata } from '@navios/core'\n\nimport type { AbstractCliAdapterInterface } from '../interfaces/abstract-cli-adapter.interface.mjs'\nimport type { CliAdapterOptions } from '../interfaces/environment.interface.mjs'\n/**\n * CLI adapter service that implements the AbstractCliAdapterInterface.\n * Handles command discovery, registration, parsing, and execution.\n *\n * @public\n */\nexport declare class CommanderAdapterService implements AbstractCliAdapterInterface {\n  private container\n  private commandRegistry\n  private cliParser\n  private logger\n  private options\n  private isReady\n  /**\n   * Sets up the adapter with the provided options.\n   * Called during application initialization.\n   */\n  setupAdapter(options: CliAdapterOptions): Promise<void>\n  /**\n   * Called after all modules are loaded.\n   * Iterates through modules and extracts commands from customEntries.\n   */\n  onModulesInit(modules: Map<string, ModuleMetadata>): Promise<void>\n  /**\n   * Registers built-in commands like help.\n   */\n  private registerBuiltInCommands\n  /**\n   * Signals that the adapter is ready to handle commands.\n   */\n  ready(): Promise<void>\n  /**\n   * Disposes of the adapter and cleans up resources.\n   */\n  dispose(): Promise<void>\n  /**\n   * Run the CLI application with the given arguments.\n   * Parses arguments and executes the matching command.\n   */\n  run(argv?: string[]): Promise<void>\n  /**\n   * Execute a command programmatically with the provided options.\n   */\n  executeCommand(\n    path: string,\n    options?: Record<string, unknown>,\n    positionals?: string[],\n  ): Promise<void>\n  /**\n   * Get all registered command paths and their class references.\n   */\n  getAllCommands(): Array<{\n    path: string\n    class: ClassType\n  }>\n}\n//# sourceMappingURL=commander-adapter.service.d.mts.map\n","import type { AnyInjectableType, InjectionToken } from '@navios/core'\n\nimport { CliParserService } from './services/cli-parser.service.mjs'\nimport { CommandRegistryService } from './services/command-registry.service.mjs'\nimport { CommanderAdapterService } from './services/commander-adapter.service.mjs'\n/**\n * Defines the CLI environment configuration for use with NaviosFactory.\n *\n * This function returns the token mappings needed to configure a CLI application.\n * Use it with `NaviosFactory.create()` to create a CLI application.\n *\n * @returns Environment configuration with token mappings\n *\n * @example\n * ```typescript\n * import { NaviosFactory } from '@navios/core'\n * import { defineCliEnvironment, type CliEnvironment } from '@navios/commander'\n *\n * const app = await NaviosFactory.create<CliEnvironment>(AppModule, {\n *   adapter: defineCliEnvironment(),\n * })\n * await app.init()\n *\n * const adapter = app.getAdapter() as AbstractCliAdapterInterface\n * await adapter.run(process.argv)\n * ```\n */\nexport declare function defineCliEnvironment(): {\n  tokens: Map<InjectionToken<any, undefined, false>, AnyInjectableType>\n}\nexport { CommanderAdapterService, CommandRegistryService, CliParserService }\n//# sourceMappingURL=define-environment.d.mts.map\n","import { InjectionToken } from '@navios/core'\n\nimport type { CommanderExecutionContext } from '../interfaces/index.mjs'\n/**\n * Injection token for accessing the current command execution context.\n *\n * Use this token with `inject()` to access the `CommanderExecutionContext` in services\n * that need information about the currently executing command.\n *\n * @example\n * ```typescript\n * import { inject, Injectable } from '@navios/core'\n * import { CommandExecutionContext } from '@navios/commander'\n *\n * @Injectable()\n * class MyService {\n *   private ctx = inject(CommandExecutionContext)\n *\n *   doSomething() {\n *     const commandPath = this.ctx.getCommandPath()\n *     const options = this.ctx.getOptions()\n *     // Use context information...\n *   }\n * }\n * ```\n */\nexport declare const CommandExecutionContext: InjectionToken<\n  CommanderExecutionContext,\n  undefined,\n  false\n>\n//# sourceMappingURL=execution-context.token.d.mts.map\n"],"mappings":"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"}

package/lib/index.mjs

@@ -1,5 +1,5 @@
 import { a as extractCommandMetadata, i as CommandMetadataKey, n as CommandEntryKey, o as getCommandMetadata, r as extractModuleCommands, s as hasCommandMetadata, t as Command } from "./command.decorator-QiRU7ny3.mjs";
-import { n as _CommandRegistryService, t as HelpCommandToken } from "./help-command.token-XHx3WkoD.mjs";
+import { n as _CommandRegistryService, t as HelpCommandToken } from "./help-command.token-D81bRnnl.mjs";
 import { t as CliModule } from "./cli-module.decorator-DAjf_r_W.mjs";
 import { AdapterToken, ConsoleLogger, Container, Injectable, InjectionToken, Logger, NaviosFactory, inject } from "@navios/core";
 import { z } from "zod/v4";
@@ -601,9 +601,13 @@ var CliParserService = class {
 	*
 	* @param argv - Array of command-line arguments (typically process.argv)
 	* @param optionsSchema - Optional zod/v4 schema to determine boolean flags and option types
+	* @param availableCommands - Optional list of registered command paths for smart detection.
+	*   When provided, scans argv to find the best matching command, enabling support for
+	*   custom launchers (tsx, ts-node, npx, etc.) that add extra args before the command.
 	* @returns Parsed command (space-separated if multi-word), options, and positional arguments
-	*/ parse(argv, optionsSchema) {
-		const args = argv.slice(2);
+	*/ parse(argv, optionsSchema, availableCommands) {
+		const startIndex = availableCommands?.length ? this.findCommandStartIndex(argv, availableCommands) : 2;
+		const args = argv.slice(startIndex);
 		if (args.length === 0) throw new Error("[Navios Commander] No command provided");
 		const booleanFields = optionsSchema ? this.extractBooleanFields(optionsSchema) : /* @__PURE__ */ new Set();
 		const arrayFields = optionsSchema ? this.extractArrayFields(optionsSchema) : /* @__PURE__ */ new Set();
@@ -625,12 +629,41 @@ var CliParserService = class {
 				if (equalIndex !== -1) {
 					const optionName = key.slice(0, equalIndex);
 					const optionValue = key.slice(equalIndex + 1);
-					const camelCaseKey = this.camelCase(optionName);
-					if (arrayFields.has(camelCaseKey) || arrayFields.has(optionName)) {
-						if (!options[camelCaseKey]) options[camelCaseKey] = [];
-						options[camelCaseKey].push(this.parseValue(optionValue));
-					} else options[camelCaseKey] = this.parseValue(optionValue);
+					if (this.isObjectNotation(optionName)) {
+						const processedPath = this.processObjectNotationKey(optionName);
+						if (optionsSchema ? this.isNestedArray(optionsSchema, processedPath) : false) {
+							const existingValue = this.getNestedProperty(options, processedPath);
+							if (!Array.isArray(existingValue)) this.setNestedProperty(options, processedPath, []);
+							this.getNestedProperty(options, processedPath).push(this.parseValue(optionValue));
+						} else this.setNestedProperty(options, processedPath, this.parseValue(optionValue));
+					} else {
+						const camelCaseKey = this.camelCase(optionName);
+						if (arrayFields.has(camelCaseKey) || arrayFields.has(optionName)) {
+							if (!options[camelCaseKey]) options[camelCaseKey] = [];
+							options[camelCaseKey].push(this.parseValue(optionValue));
+						} else options[camelCaseKey] = this.parseValue(optionValue);
+					}
 					i++;
+				} else if (this.isObjectNotation(key)) {
+					const processedPath = this.processObjectNotationKey(key);
+					const isBoolean = optionsSchema ? this.isNestedBoolean(optionsSchema, processedPath) : false;
+					const isArray = optionsSchema ? this.isNestedArray(optionsSchema, processedPath) : false;
+					const nextArg = args[i + 1];
+					if (isBoolean) {
+						this.setNestedProperty(options, processedPath, true);
+						i++;
+					} else if (isArray && nextArg && !nextArg.startsWith("-")) {
+						const existingValue = this.getNestedProperty(options, processedPath);
+						if (!Array.isArray(existingValue)) this.setNestedProperty(options, processedPath, []);
+						this.getNestedProperty(options, processedPath).push(this.parseValue(nextArg));
+						i += 2;
+					} else if (nextArg && !nextArg.startsWith("-")) {
+						this.setNestedProperty(options, processedPath, this.parseValue(nextArg));
+						i += 2;
+					} else {
+						this.setNestedProperty(options, processedPath, true);
+						i++;
+					}
 				} else {
 					const camelCaseKey = this.camelCase(key);
 					const isBoolean = booleanFields.has(camelCaseKey) || booleanFields.has(key);
@@ -687,6 +720,28 @@ var CliParserService = class {
 		};
 	}
 	/**
+	* Finds the index in argv where the command starts by matching against available commands.
+	* Prioritizes longer/more specific commands (e.g., 'db migrate' matches before 'db').
+	*
+	* @param argv - Full argv array
+	* @param availableCommands - List of registered command paths
+	* @returns Index where the command starts, or 2 as fallback
+	*/ findCommandStartIndex(argv, availableCommands) {
+		const sortedCommands = [...availableCommands].sort((a, b) => {
+			const aParts = a.split(" ").length;
+			const bParts = b.split(" ").length;
+			if (bParts !== aParts) return bParts - aParts;
+			return b.length - a.length;
+		});
+		for (let startIdx = 1; startIdx < argv.length; startIdx++) for (const cmd of sortedCommands) {
+			const cmdParts = cmd.split(" ");
+			const endIdx = startIdx + cmdParts.length;
+			if (endIdx > argv.length) continue;
+			if (argv.slice(startIdx, endIdx).join(" ") === cmd) return startIdx;
+		}
+		return 2;
+	}
+	/**
 	* Converts kebab-case to camelCase
 	*/ camelCase(str) {
 		return str.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
@@ -769,6 +824,80 @@ var CliParserService = class {
 			return false;
 		}
 	}
+	/**
+	* Sets a nested property on an object using dot notation path.
+	* Creates intermediate objects as needed.
+	*
+	* @example
+	* setNestedProperty({}, 'a.b.c', 'value') // { a: { b: { c: 'value' } } }
+	*/ setNestedProperty(obj, path, value) {
+		const parts = path.split(".");
+		let current = obj;
+		for (let i = 0; i < parts.length - 1; i++) {
+			const part = parts[i];
+			if (!(part in current) || typeof current[part] !== "object" || current[part] === null) current[part] = {};
+			current = current[part];
+		}
+		current[parts[parts.length - 1]] = value;
+	}
+	/**
+	* Gets a nested property from an object using dot notation path.
+	* Returns undefined if path doesn't exist.
+	*/ getNestedProperty(obj, path) {
+		const parts = path.split(".");
+		let current = obj;
+		for (const part of parts) {
+			if (current === void 0 || current === null || typeof current !== "object") return;
+			current = current[part];
+		}
+		return current;
+	}
+	/**
+	* Checks if an option key contains dot notation (object notation).
+	* Returns true for keys like "obj.field" or "deep.nested.value".
+	*/ isObjectNotation(key) {
+		return key.includes(".");
+	}
+	/**
+	* Processes an option key that may contain object notation.
+	* Converts each segment from kebab-case to camelCase.
+	*
+	* @example
+	* processObjectNotationKey('my-obj.field-name') // 'myObj.fieldName'
+	*/ processObjectNotationKey(key) {
+		return key.split(".").map((segment) => this.camelCase(segment)).join(".");
+	}
+	/**
+	* Gets the nested schema for a given dot-notation path.
+	* Returns undefined if the path doesn't lead to a valid schema.
+	*/ getNestedSchema(schema, path) {
+		try {
+			const parts = path.split(".");
+			let currentSchema = schema;
+			for (const part of parts) {
+				while (currentSchema?.def?.type === "optional" || currentSchema?.def?.type === "default") currentSchema = currentSchema.def.innerType;
+				if (currentSchema?.def?.type !== "object") return;
+				const shape = currentSchema.def.shape;
+				if (!shape || !(part in shape)) return;
+				currentSchema = shape[part];
+			}
+			return currentSchema;
+		} catch {
+			return;
+		}
+	}
+	/**
+	* Checks if a nested path represents a boolean field in the schema.
+	*/ isNestedBoolean(schema, path) {
+		const nestedSchema = this.getNestedSchema(schema, path);
+		return nestedSchema ? this.isSchemaBoolean(nestedSchema) : false;
+	}
+	/**
+	* Checks if a nested path represents an array field in the schema.
+	*/ isNestedArray(schema, path) {
+		const nestedSchema = this.getNestedSchema(schema, path);
+		return nestedSchema ? this.isSchemaArray(nestedSchema) : false;
+	}
 	static {
 		_initClass$1();
 	}
@@ -1220,14 +1349,15 @@ var CommanderAdapterService = class {
 	*/ async run(argv = process.argv) {
 		if (!this.isReady) throw new Error("Adapter not ready. Call app.init() first.");
 		try {
-			const preliminaryParse = this.cliParser.parse(argv);
+			const commandPaths = this.commandRegistry.getAllPaths();
+			const preliminaryParse = this.cliParser.parse(argv, void 0, commandPaths);
 			if (preliminaryParse.options.help || preliminaryParse.options.h) {
 				if (preliminaryParse.command === "help") await this.executeCommand("help", {});
 				else await this.executeCommand("help", { command: preliminaryParse.command });
 				return;
 			}
 			const command = this.commandRegistry.getByPath(preliminaryParse.command);
-			const parsed = command?.metadata.optionsSchema ? this.cliParser.parse(argv, command.metadata.optionsSchema) : preliminaryParse;
+			const parsed = command?.metadata.optionsSchema ? this.cliParser.parse(argv, command.metadata.optionsSchema, commandPaths) : preliminaryParse;
 			await this.executeCommand(parsed.command, parsed.options, parsed.positionals);
 		} catch (error) {
 			if (error instanceof Error) {
@@ -1374,7 +1504,7 @@ function dynamicImport(modulePath) {
 			}
 			const { overrideConsoleLogger, ScreenManager } = tuiModule;
 			overrideConsoleLogger(options.tuiOptions?.hideDefaultScreen ?? false);
-			if (options.tuiOptions?.hideDefaultScreen) await import("./help.command-Bynoll_7.mjs");
+			if (options.tuiOptions?.hideDefaultScreen) await import("./help.command-B14cbwE_.mjs");
 			const app = await NaviosFactory.create(appModule, {
 				adapter: defineCliEnvironment(),
 				logger: options.logLevels