CLI: streamline startup paths and env parsing

Add shared parseBooleanValue()/isTruthyEnvValue() and apply across CLI, gateway, memory, and live-test flags for consistent env handling.
Introduce route-first fast paths, lazy subcommand registration, and deferred plugin loading to reduce CLI startup overhead.
Centralize config validation via ensureConfigReady() and add config caching/deferred shell env fallback for fewer IO passes.
Harden logger initialization/imports and add focused tests for argv, boolean parsing, frontmatter, and CLI subcommands.

src/cli/argv.ts

@@ -0,0 +1,60 @@
+const HELP_FLAGS = new Set(["-h", "--help"]);
+const VERSION_FLAGS = new Set(["-v", "-V", "--version"]);
+
+export function hasHelpOrVersion(argv: string[]): boolean {
+  return argv.some((arg) => HELP_FLAGS.has(arg) || VERSION_FLAGS.has(arg));
+}
+
+export function getCommandPath(argv: string[], depth = 2): string[] {
+  const args = argv.slice(2);
+  const path: string[] = [];
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (!arg) continue;
+    if (arg === "--") break;
+    if (arg.startsWith("-")) continue;
+    path.push(arg);
+    if (path.length >= depth) break;
+  }
+  return path;
+}
+
+export function getPrimaryCommand(argv: string[]): string | null {
+  const [primary] = getCommandPath(argv, 1);
+  return primary ?? null;
+}
+
+export function buildParseArgv(params: {
+  programName?: string;
+  rawArgs?: string[];
+  fallbackArgv?: string[];
+}): string[] {
+  const baseArgv =
+    params.rawArgs && params.rawArgs.length > 0
+      ? params.rawArgs
+      : params.fallbackArgv && params.fallbackArgv.length > 0
+        ? params.fallbackArgv
+        : process.argv;
+  const programName = params.programName ?? "";
+  const normalizedArgv =
+    programName && baseArgv[0] === programName
+      ? baseArgv.slice(1)
+      : baseArgv[0]?.endsWith("clawdbot")
+        ? baseArgv.slice(1)
+        : baseArgv;
+  const executable = normalizedArgv[0]?.split(/[/\\]/).pop() ?? "";
+  const looksLikeNode =
+    normalizedArgv.length >= 2 && (executable === "node" || executable === "bun");
+  if (looksLikeNode) return normalizedArgv;
+  return ["node", programName || "clawdbot", ...normalizedArgv];
+}
+
+export function isReadOnlyCommand(argv: string[]): boolean {
+  const path = getCommandPath(argv, 2);
+  if (path.length === 0) return false;
+  const [primary, secondary] = path;
+  if (primary === "health" || primary === "status" || primary === "sessions") return true;
+  if (primary === "memory" && secondary === "status") return true;
+  if (primary === "agents" && secondary === "list") return true;
+  return false;
+}