src/cli/program/parent-default-help.ts

// Parent-command default action helper that prints help with success exit status.
import type { Command } from "commander";

const parentDefaultHelpCommands = new WeakSet<Command>();

function outputParentHelpWithoutStartupBanner(parent: Command): void {
  const previous = process.env.OPENCLAW_SUPPRESS_HELP_BANNER;
  process.env.OPENCLAW_SUPPRESS_HELP_BANNER = "1";
  try {
    parent.outputHelp();
  } finally {
    if (previous === undefined) {
      delete process.env.OPENCLAW_SUPPRESS_HELP_BANNER;
    } else {
      process.env.OPENCLAW_SUPPRESS_HELP_BANNER = previous;
    }
  }
}

/**
 * Wire a parent command so that invoking it without a subcommand prints the
 * parent's own help and exits with status `0`.
 *
 * Commander's default behavior for a parent with subcommands is to print help
 * and set `process.exitCode = 1`, which differs from `<parent> --help` (which
 * exits 0). That asymmetry breaks shell `&&` chains and surfaces a misleading
 * `ELIFECYCLE Command failed with exit code 1.` line for users running through
 * pnpm. See #73077.
 *
 * Apply this helper only to parent commands that do not have their own default
 * action. Commander does not expose a public "has action handler" API, so
 * callers keep that ownership explicit instead of probing private internals.
 */
export function applyParentDefaultHelpAction(parent: Command): void {
  parentDefaultHelpCommands.add(parent);
  parent.action(() => {
    outputParentHelpWithoutStartupBanner(parent);
    process.exitCode = 0;
  });
}

export function isParentDefaultHelpAction(parent: Command): boolean {
  return parentDefaultHelpCommands.has(parent);
}