// Main CLI startup policy helpers for fast paths, proxy startup, aliases, and missing commands.

import {

normalizeLowercaseStringOrEmpty,

normalizeOptionalLowercaseString,

}

export function rewriteUpdateFlagArgv(argv: string[]): string[] {

// Preserve the old root --update spelling by rewriting before Commander registration.

const index = argv.indexOf("--update");

if (index === -1) {

return argv;

// Main CLI entry orchestration: fast paths, env setup, plugin aliases, and Commander dispatch.

import { existsSync } from "node:fs";

import path from "node:path";

import process from "node:process";

const loadProgressModule = async () => await import("./progress.js");

function createGatewayCliMainStartupTrace(argv: string[]) {

// Startup trace is scoped to gateway invocations to avoid routine CLI stderr noise.

const enabled =

isTruthyEnvValue(process.env.OPENCLAW_GATEWAY_STARTUP_TRACE) &&

argv.slice(2).includes("gateway");

// Commander registration for sandbox container list, recreate, and explain commands.

import type { Command } from "commander";

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

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

function createRunner(

commandFn: (opts: CommandOptions, runtime: typeof defaultRuntime) => Promise<void>,

) {

// Sandbox commands share the default runtime error/exit behavior.

return async (opts: CommandOptions) => {

try {

await commandFn(opts, defaultRuntime);

// Secrets CLI for reload, audit, configure, and apply workflows.

import type { Command } from "commander";

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

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

);

async function readPlanFile(pathname: string): Promise<SecretsApplyPlan> {

// Apply consumes a generated plan shape, not arbitrary JSON.

const [{ readFileSync }, { isSecretsApplyPlan }] = await Promise.all([

fsModuleLoader.load(),

import("../secrets/plan.js"),

// Security CLI for local/deep audits and safe remediation.

import {

normalizeOptionalLowercaseString,

normalizeOptionalString,

token?: string;

password?: string;

}) {

// Explicit runtime auth overrides must include the matching credential.

if (!params.mode) {

return undefined;

}

// Fast help renderer for setup/onboard/configure without loading full CLI startup.

import { Command } from "commander";

import { VERSION } from "../version.js";

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

}

export async function tryOutputSetupOnboardConfigureHelp(argv: string[]): Promise<boolean> {

// Register only the requested command so help stays quick and avoids config/plugin startup.

const command = resolveSetupOnboardConfigureHelpCommand(argv);

if (!command) {

return false;

// Skills CLI for workspace status, install/update, ClawHub verification, and workshop proposals.

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

import type { Command } from "commander";

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

workspaceDir: string;

agentId: string;

} {

// Prefer explicit --agent, then infer from cwd, then fall back to configured default agent.

const config = getRuntimeConfig();

const explicitAgentId = normalizeOptionalString(options?.agentId);

const inferredAgentId = explicitAgentId

// Reader/cache for generated CLI startup metadata used by help and completion fast paths.

import fs from "node:fs";

import path from "node:path";

import { fileURLToPath } from "node:url";

}

export function readCliStartupMetadata(moduleUrl: string): Record<string, unknown> | null {

// Check both source and bundled layouts; cache misses too so repeated help stays cheap.

for (const metadataPath of resolveStartupMetadataPathCandidates(moduleUrl)) {

const cached = startupMetadataByPath.get(metadataPath);

if (cached !== undefined) {

// CLI tagline selection helpers, including deterministic random/default/holiday modes.

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

const DEFAULT_TAGLINE = "All your chats, one OpenClaw.";

// Shared Vitest runtime capture helpers for CLI command output assertions.

import { vi } from "vitest";

import type { OutputRuntimeEnv } from "../runtime.js";

import type { MockFn } from "../test-utils/vitest-mock-fn.js";

}

export function createCliRuntimeCapture(): CliRuntimeCapture {

// Capture output in arrays while preserving vi mock call inspection.

const runtimeLogs: string[] = [];

const runtimeErrors: string[] = [];

const stringifyArgs = (args: unknown[]) => args.map((value) => String(value)).join(" ");