openclaw/src/cli/program/action-reparse.ts

// Reparse support for lazy commands after their placeholder has been replaced.
import type { Command } from "commander";
import { buildParseArgv } from "../argv.js";
import { resolveActionArgs, resolveCommandOptionArgs } from "./helpers.js";

function getCommandPathFromRoot(command: Command | undefined): string[] {
  const path: string[] = [];
  let current = command;
  while (current?.parent) {
    const name = current.name();
    if (name) {
      path.unshift(name);
    }
    current = current.parent;
  }
  return path;
}

function buildFallbackArgv(program: Command, actionCommand: Command | undefined): string[] {
  const actionArgsList = resolveActionArgs(actionCommand);
  const parentOptionArgs =
    actionCommand?.parent === program ? resolveCommandOptionArgs(program) : [];
  const commandPath = getCommandPathFromRoot(actionCommand);
  if (commandPath.length === 0) {
    return [...parentOptionArgs, ...actionArgsList];
  }
  return [
    ...commandPath.slice(0, -1),
    ...parentOptionArgs,
    commandPath[commandPath.length - 1],
    ...actionArgsList,
  ];
}

function findRootCommand(cmd: Command): Command {
  let current: Command = cmd;
  while (current.parent) {
    current = current.parent;
  }
  return current;
}

/** Rebuild argv from Commander action args and re-run parsing after lazy registration. */
export async function reparseProgramFromActionArgs(
  program: Command,
  actionArgs: unknown[],
): Promise<void> {
  const actionCommand = actionArgs.at(-1) as Command | undefined;
  // Use the true root program for argv reconstruction and parsing.
  // Commander keeps rawArgs as a JS runtime field, not a typed API; if a
  // future version removes it, buildParseArgv falls back to reconstructed argv.
  const rootProgram = findRootCommand(actionCommand ?? program);
  const rawArgs = (rootProgram as Command & { rawArgs?: string[] }).rawArgs;
  const fallbackArgv = buildFallbackArgv(program, actionCommand);
  const parseArgv = buildParseArgv({
    programName: rootProgram.name(),
    rawArgs,
    fallbackArgv,
  });
  await rootProgram.parseAsync(parseArgv);
}