src/cli/node-cli/command-options.ts

import { InvalidArgumentError, type Command } from "commander";

/** Collect repeatable, comma-separated exact node command ids without treating patterns as globs. */
function collectNodeCommandIds(value: string, previous: string[] = []): string[] {
  const ids = value.split(",").map((id) => id.trim());
  if (ids.some((id) => !id)) {
    throw new InvalidArgumentError("--commands requires comma-separated non-empty command ids");
  }
  return [...new Set([...previous, ...ids])].toSorted();
}

export function addNodeCommandOptions(command: Command): Command {
  return command
    .option(
      "--commands <ids>",
      "Advertise only these exact command ids (comma-separated; repeatable)",
      collectNodeCommandIds,
    )
    .option(
      "--all-commands",
      "Advertise the full default command surface and forget any saved --commands allowlist",
    )
    .hook("preAction", (_command, actionCommand) => {
      // Commander conflicts are local-only; include flags split across node and its leaf.
      const opts = actionCommand.optsWithGlobals();
      if (opts.allCommands && opts.commands !== undefined) {
        actionCommand.error("--all-commands cannot be combined with --commands", {
          code: "commander.conflictingOption",
        });
      }
    });
}