// Root Commander help, global options, banner, version, and example formatting.

import type { Command } from "commander";

import { formatDocsLink } from "../../../packages/terminal-core/src/links.js";

import { isRich, theme } from "../../../packages/terminal-core/src/theme.js";

});

const formatHelpOutput = (str: string) => {

// Commander emits plain section labels; decorate them after command-specific help renders.

let output = str;

const isRootHelp = new RegExp(

`^Usage:\\s+${CLI_NAME_PATTERN}\\s+\\[options\\]\\s+\\[command\\]\\s*$`,

// Parent-command default action helper that prints help with success exit status.

import type { Command } from "commander";

const parentDefaultHelpCommands = new WeakSet<Command>();

// Commander registration for onboard setup flags and lazy onboard runtime execution.

import type { Command } from "commander";

import { formatDocsLink } from "../../../packages/terminal-core/src/links.js";

import { theme } from "../../../packages/terminal-core/src/theme.js";

}

function resolveOnboardAuthFlags(): OnboardAuthFlag[] {

// Provider manifests can add auth flags; keep duplicate CLI aliases out of Commander.

const seenCliFlags = new Set<string>();

const flags: OnboardAuthFlag[] = [];

for (const flag of [...CORE_ONBOARD_AUTH_FLAGS, ...resolveManifestProviderOnboardAuthFlags()]) {

// Sub-CLI registry that lazily wires gateway, models, devices, plugins, and plugin commands.

import type { Command } from "commander";

import { createLazyImportLoader } from "../../shared/lazy-promise.js";

import { resolveCliArgvInvocation } from "../argv-invocation.js";

}

async function registerGatewayRunOnly(program: Command): Promise<void> {

// Hot path for `gateway run`: avoid loading the full gateway command tree.

const { addGatewayRunCommand } = await import("../gateway-cli/run-command.js");

removeCommandByName(program, "gateway");

const gateway = addGatewayRunCommand(

// Small interactive prompt helpers for CLI confirmations.

import { stdin as input, stdout as output } from "node:process";

import readline from "node:readline/promises";

import { normalizeLowercaseStringOrEmpty } from "@openclaw/normalization-core/string-coerce";

// Debug proxy runtime commands for capture sessions, validation, coverage, and blob reads.

import { spawn } from "node:child_process";

import { randomUUID } from "node:crypto";

import process from "node:process";

port?: number;

commandArgs: string[];

}) {

// Each proxied child command gets its own capture session id for later query/filtering.

if (opts.commandArgs.length === 0) {

throw new Error("proxy run requires a command after --");

}

// Commander registration for debug proxy capture, validation, query, and blob commands.

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

import { parseStrictInteger } from "../infra/parse-finite-number.js";

import type { CaptureQueryPreset } from "../proxy-capture/types.js";

);

async function loadProxyCliRuntime(): Promise<ProxyCliRuntime> {

// Keep proxy CA/server/sqlite dependencies out of normal CLI startup.

return await proxyCliRuntimeLoader.load();

}

// QR/setup-code CLI for mobile/device pairing with local or remote Gateway credentials.

import type { Command } from "commander";

import { formatDocsLink } from "../../packages/terminal-core/src/links.js";

import { theme } from "../../packages/terminal-core/src/theme.js";

cfg: OpenClawConfig,

env: NodeJS.ProcessEnv,

): boolean {

// Default/implicit password auth may require resolving a local SecretRef before encoding setup.

if (trimToUndefined(env.OPENCLAW_GATEWAY_PASSWORD)) {

return false;

}

// CLI respawn skip policy for help, interactive TTY commands, and foreground Gateway runs.

import { resolveCliArgvInvocation } from "./argv-invocation.js";

import { getCommandPositionalsWithRootOptions } from "./argv.js";

// Cached startup metadata readers for precomputed root and subcommand help text.

import { readCliStartupMetadata } from "./startup-metadata.js";

export type PrecomputedSubcommandHelpName = "doctor" | "gateway" | "models" | "plugins";

cache: string | null | undefined,

setCache: (value: string | null) => void,

): string | null {

// Missing metadata is expected in source checkouts; fall back to live Commander help.

if (cache !== undefined) {

return cache;

}