Method resolve

src/registry.ts:72–128

(commandPath: string[])

  }

  resolve(commandPath: string[]): { command: Command; extra: string[] } {
    let node = this.root;
    const matched: string[] = [];

    for (const part of commandPath) {
      const child = node.children.get(part);
      if (!child) break;
      node = child;
      matched.push(part);
    }

    if (node.command) {
      return { command: node.command, extra: commandPath.slice(matched.length) };
    }

    // Single child: auto-forward (e.g. `mmx quota` → `mmx quota show`)
    if (matched.length > 0 && node.children.size === 1) {
      const [, child] = node.children.entries().next().value as [string, CommandNode];
      if (child.command) {
        return { command: child.command, extra: commandPath.slice(matched.length) };
      }
    }

    // Alias-only group: auto-forward when every child points to the same command.
    // Example: `mmx search "query"` should work even when both `search query`
    // and `search web` are registered as aliases for the same implementation.
    if (matched.length > 0 && node.children.size > 1) {
      const children = Array.from(node.children.values());
      const commands = children.map((child) => child.command);
      const first = commands[0];
      if (first && commands.every((command) => command === first)) {
        return { command: first, extra: commandPath.slice(matched.length) };
      }
    }

    // If we matched some path but no command, show help for that group
    if (matched.length > 0 && node.children.size > 0) {
      const subcommands = Array.from(node.children.entries())
        .map(([name, n]) => {
          if (n.command) return `  ${matched.join(' ')} ${name}    ${n.command.description}`;
          const subs = Array.from(n.children.keys()).join(', ');
          return `  ${matched.join(' ')} ${name} [${subs}]`;
        })
        .join('\n');
      throw new CLIError(
        `Unknown command: mmx ${commandPath.join(' ')}\n\nAvailable commands:\n${subcommands}`,
        ExitCode.USAGE,
        `mmx ${matched.join(' ')} --help`,
      );
    }

    throw new CLIError(
      `Unknown command: mmx ${commandPath.join(' ')}`,
      ExitCode.USAGE,
      'mmx --help',
    );
  }