@thinkingai/ae-cli 6.0.30 → 6.0.31

package/dist/chunk-TKQJQXWT.js

@@ -0,0 +1,68 @@
+import {
+  resolveGatewayDomain
+} from "./chunk-HL2AJQ4Q.js";
+import {
+  dryRunCapability,
+  executeCapabilityWithEnvelope,
+  validateCapability
+} from "./chunk-I4A62X3N.js";
+import {
+  withOutputMetadata
+} from "./chunk-TNW2CI4W.js";
+
+// src/core/capability-command.ts
+import { randomBytes } from "crypto";
+function createCapabilityCommand(config) {
+  return {
+    service: config.cliService,
+    resource: config.resource,
+    command: config.command,
+    capabilityId: config.capabilityId,
+    description: config.description,
+    flags: config.flags,
+    risk: config.risk,
+    validate: config.validate,
+    validateInput: async (ctx) => {
+      const gatewayDomain = resolveGatewayDomain(config.cliService, config.gatewayDomain);
+      const requestHost = config.requestHost ?? ctx.host();
+      const input = config.buildInput(ctx);
+      return validateCapability(requestHost, gatewayDomain, config.capabilityId, input);
+    },
+    dryRun: async (ctx) => {
+      const gatewayDomain = resolveGatewayDomain(config.cliService, config.gatewayDomain);
+      const requestHost = config.requestHost ?? ctx.host();
+      const input = config.buildInput(ctx);
+      return dryRunCapability(requestHost, gatewayDomain, config.capabilityId, input);
+    },
+    execute: async (ctx) => {
+      const gatewayDomain = resolveGatewayDomain(config.cliService, config.gatewayDomain);
+      const requestHost = config.requestHost ?? ctx.host();
+      const input = withLifecycleRequestId(config, config.buildInput(ctx));
+      announceDispatch(config.capabilityId, input);
+      const result = await executeCapabilityWithEnvelope(requestHost, gatewayDomain, config.capabilityId, input);
+      const data = config.postProcess ? config.postProcess(result.data, input) : result.data;
+      return withOutputMetadata(data, result.meta);
+    }
+  };
+}
+function withLifecycleRequestId(config, input) {
+  if (!config.flags.some((flag) => flag.name === "request-id")) {
+    return input;
+  }
+  const supplied = input.request_id;
+  const requestId = typeof supplied === "string" && supplied.length > 0 ? supplied : `cli_${randomBytes(16).toString("hex")}`;
+  return { ...input, request_id: requestId };
+}
+function announceDispatch(capabilityId, input) {
+  if (typeof input.request_id !== "string") {
+    return;
+  }
+  process.stderr.write(
+    `[ae-cli] dispatching capability=${capabilityId} request_id=${input.request_id}
+`
+  );
+}
+
+export {
+  createCapabilityCommand
+};

package/dist/{chunk-ZAOL36CG.js → chunk-TNW2CI4W.js}

@@ -4,6 +4,7 @@ import {
 
 // src/framework/output.ts
 import Table from "cli-table3";
+import { JqError, json as jqJson } from "jq-wasm";
 var KNOWN_ARRAY_FIELDS = [
   "items",
   "events",
@@ -23,6 +24,18 @@ var KNOWN_ARRAY_FIELDS = [
   "columns",
   "properties"
 ];
+var OUTPUT_METADATA = /* @__PURE__ */ Symbol("ae-cli-output-metadata");
+function withOutputMetadata(data, meta) {
+  if (!meta || Object.keys(meta).length === 0) return data;
+  return {
+    [OUTPUT_METADATA]: true,
+    data,
+    meta
+  };
+}
+function isOutputWithMetadata(value) {
+  return Boolean(value?.[OUTPUT_METADATA]);
+}
 function findArrayField(data) {
   if (Array.isArray(data)) return data;
   if (typeof data !== "object" || data === null) return null;
@@ -58,56 +71,59 @@ function formatTable(data) {
   }
   return table.toString();
 }
-function applyJq(data, expr) {
-  if (!expr) return data;
-  const parts = expr.replace(/^\.(data\.)?/, "").split(".");
-  let result = data;
-  for (const part of parts) {
-    const arrayMatch = part.match(/^(.+)\[\]$/);
-    if (arrayMatch) {
-      result = result?.[arrayMatch[1]];
-      if (!Array.isArray(result)) return result;
-      continue;
-    }
-    const indexMatch = part.match(/^(.+)\[(\d+)\]$/);
-    if (indexMatch) {
-      result = result?.[indexMatch[1]]?.[parseInt(indexMatch[2])];
-      continue;
-    }
-    if (part) {
-      result = result?.[part];
-    }
+async function applyJq(data, expr) {
+  const trimmed = expr.trim();
+  if (!trimmed) return data;
+  let results;
+  try {
+    results = await jqJson(data, trimmed);
+  } catch (err) {
+    const message = err instanceof JqError ? err.message : err?.message || String(err);
+    const error = new Error(`Invalid --jq expression: ${message}`);
+    error.type = "validation";
+    error.hint = "Use standard jq syntax, e.g. .status or {status,pendingQuestion}";
+    throw error;
   }
-  return result;
+  if (results.length === 0) return null;
+  if (results.length === 1) return results[0];
+  return results;
 }
-function formatOutput(data, format, jqExpr) {
-  let processed = data;
+async function formatOutput(data, format, jqExpr) {
+  const outputData = isOutputWithMetadata(data) ? data.data : data;
+  const meta = isOutputWithMetadata(data) ? data.meta : void 0;
+  let processed = outputData;
   if (jqExpr) {
-    processed = applyJq(data, jqExpr);
+    processed = await applyJq(outputData, jqExpr);
   }
   if (format === "table") {
     return formatTable(processed);
   }
-  const envelope = { ok: true, data: processed };
+  const envelope = {
+    ok: true,
+    data: processed,
+    ...meta ? { meta } : {}
+  };
   return JSON.stringify(envelope, null, 2);
 }
-function formatError(type, message, hint, code) {
+function formatError(type, message, hint, code, meta) {
   const envelope = {
     ok: false,
-    error: { type, message, hint, code }
+    error: { type, message, hint, code },
+    ...meta && Object.keys(meta).length > 0 ? { meta } : {}
   };
   return JSON.stringify(envelope, null, 2);
 }
-function printError(type, message, hint, code) {
-  const formatted = formatError(type, message, hint, code);
+function printError(type, message, hint, code, meta) {
+  const formatted = formatError(type, message, hint, code, meta);
   process.stderr.write(formatted + "\n");
   logger.error(`[${type}] ${message}${hint ? " | " + hint : ""}`);
 }
-function printOutput(data, format, jqExpr) {
-  process.stdout.write(formatOutput(data, format, jqExpr) + "\n");
+async function printOutput(data, format, jqExpr) {
+  process.stdout.write(await formatOutput(data, format, jqExpr) + "\n");
 }
 
 export {
+  withOutputMetadata,
   printError,
   printOutput
 };

package/dist/{config-ZVPARN4R.js → config-7UZWDE74.js}

@@ -1,7 +1,7 @@
 import {
   printError,
   printOutput
-} from "./chunk-ZAOL36CG.js";
+} from "./chunk-TNW2CI4W.js";
 import {
   GLOBAL_QUERY_CONFIG_KEY,
   getAnalysisMappingPathForClusterMode,
@@ -22,40 +22,40 @@ function registerConfig(program) {
     printError("config", "Missing subcommand.", "Run: ae-cli config --help");
     process.exit(1);
   });
-  configCmd.command("list").description("List configured AE environments").action(() => {
-    printConfigList(program);
+  configCmd.command("list").description("List configured AE environments").action(async () => {
+    await printConfigList(program);
   });
-  configCmd.command("current").description("Show the active AE environment").action(() => {
-    printCurrentConfig(program);
+  configCmd.command("current").description("Show the active AE environment").action(async () => {
+    await printCurrentConfig(program);
   });
-  configCmd.command("use <env>").description("Switch active AE environment by exact URL or unique label").action((env) => {
-    useConfigEnv(program, env);
+  configCmd.command("use <env>").description("Switch active AE environment by exact URL or unique label").action(async (env) => {
+    await useConfigEnv(program, env);
   });
-  configCmd.command("set-host <url>").description("Set the active AE host non-interactively (adds it if not already configured)").option("--label <label>", "Display label for this host (defaults to the host URL)").action((url, opts) => {
+  configCmd.command("set-host <url>").description("Set the active AE host non-interactively (adds it if not already configured)").option("--label <label>", "Display label for this host (defaults to the host URL)").action(async (url, opts) => {
     const normalized = normalizeUrl(url);
     const label = opts.label || normalized;
     addHost(normalized, label);
     setActiveHost(normalized);
-    printOutput({ activeHost: normalized, label }, program.opts().format || "json");
+    await printOutput({ activeHost: normalized, label }, program.opts().format || "json");
   });
-  const clusterMode = configCmd.command("cluster-mode").description("Manage local multi-cluster analysis MCP mode").action(() => {
-    printClusterModeStatus(program);
+  const clusterMode = configCmd.command("cluster-mode").description("Manage local multi-cluster analysis MCP mode").action(async () => {
+    await printClusterModeStatus(program);
   });
-  clusterMode.command("status").description("Show local multi-cluster analysis MCP mode").action(() => {
-    printClusterModeStatus(program);
+  clusterMode.command("status").description("Show local multi-cluster analysis MCP mode").action(async () => {
+    await printClusterModeStatus(program);
   });
-  clusterMode.command("enable").description("Enable local multi-cluster analysis MCP mode").action(() => {
+  clusterMode.command("enable").description("Enable local multi-cluster analysis MCP mode").action(async () => {
     setGlobalQueryModeEnabled(true);
-    printClusterModeStatus(program);
+    await printClusterModeStatus(program);
   });
-  clusterMode.command("disable").description("Disable local multi-cluster analysis MCP mode").action(() => {
+  clusterMode.command("disable").description("Disable local multi-cluster analysis MCP mode").action(async () => {
     setGlobalQueryModeEnabled(false);
-    printClusterModeStatus(program);
+    await printClusterModeStatus(program);
   });
 }
-function printClusterModeStatus(program) {
+async function printClusterModeStatus(program) {
   const enabled = isGlobalQueryModeEnabled();
-  printOutput({
+  await printOutput({
     [GLOBAL_QUERY_CONFIG_KEY]: enabled,
     path: getClusterInfoFilePath(),
     analysisMappingPath: getAnalysisMappingPathForClusterMode(enabled)
@@ -70,20 +70,20 @@ function readHostViews() {
   }));
   return { activeHost: config.activeHost, hosts };
 }
-function printConfigList(program) {
+async function printConfigList(program) {
   const { activeHost, hosts } = readHostViews();
-  printOutput({ activeHost, hosts }, program.opts().format || "json", program.opts().jq);
+  await printOutput({ activeHost, hosts }, program.opts().format || "json", program.opts().jq);
 }
-function printCurrentConfig(program) {
+async function printCurrentConfig(program) {
   const { activeHost, hosts } = readHostViews();
   const current = hosts.find((h) => h.url === activeHost);
   if (!current) {
     failConfig("No active AE environment configured.", "Run: ae-cli config use <env> or ae-cli config list");
     return;
   }
-  printOutput({ activeHost: current.url, label: current.label }, program.opts().format || "json", program.opts().jq);
+  await printOutput({ activeHost: current.url, label: current.label }, program.opts().format || "json", program.opts().jq);
 }
-function useConfigEnv(program, env) {
+async function useConfigEnv(program, env) {
   const target = resolveHost(env);
   if (target.status === "not-found") {
     failConfig(
@@ -100,7 +100,7 @@ function useConfigEnv(program, env) {
     return;
   }
   setActiveHost(target.host.url);
-  printOutput({ activeHost: target.host.url, label: target.host.label }, program.opts().format || "json", program.opts().jq);
+  await printOutput({ activeHost: target.host.url, label: target.host.label }, program.opts().format || "json", program.opts().jq);
 }
 function resolveHost(env) {
   const raw = env.trim();

package/dist/index.js

@@ -5,15 +5,15 @@ import {
   TeAgentApiError,
   TeAgentCredentialsError
 } from "./chunk-R77JT7XD.js";
-import {
-  printError,
-  printOutput
-} from "./chunk-ZAOL36CG.js";
 import {
   CapabilityGatewayError,
   executeCapability,
   uploadInputFileBytes
-} from "./chunk-OJR23CIK.js";
+} from "./chunk-I4A62X3N.js";
+import {
+  printError,
+  printOutput
+} from "./chunk-TNW2CI4W.js";
 import {
   PermissionError
 } from "./chunk-NOO24N7W.js";
@@ -57,24 +57,59 @@ async function runCommand(cmd, opts, globalOpts) {
     }
     const LIMIT_FLAG_PATTERNS = [/limit/i, /page_size/i, /pagesize/i, /row_limit/i, /block_limit/i, /top[-_]?k/i];
     for (const flag of cmd.flags) {
+      if (flag.type !== "number") continue;
+      const val = opts[camelCase(flag.name)];
+      if (val === void 0 || val === null || val === "") continue;
+      const num = Number(val);
+      if (!Number.isFinite(num)) {
+        printError("validation", `--${flag.name} must be a number (got: ${val})`);
+        process.exit(1);
+      }
       const isLimitFlag = LIMIT_FLAG_PATTERNS.some((p) => p.test(flag.name));
-      if (isLimitFlag && flag.type === "number") {
-        const val = opts[camelCase(flag.name)];
-        if (val !== void 0 && val !== null) {
-          const num = Number(val);
-          if (!Number.isInteger(num) || num < 1 || num > 1e4) {
-            printError("validation", `--${flag.name} must be an integer between 1 and 10000 (got: ${val})`);
-            process.exit(1);
-          }
+      if (isLimitFlag) {
+        const min = flag.min ?? 1;
+        const max = flag.max ?? 1e4;
+        if (!Number.isInteger(num) || num < min || num > max) {
+          printError("validation", `--${flag.name} must be an integer between ${min} and ${max} (got: ${val})`);
+          process.exit(1);
+        }
+      } else if (flag.min !== void 0 || flag.max !== void 0) {
+        const min = flag.min ?? Number.NEGATIVE_INFINITY;
+        const max = flag.max ?? Number.POSITIVE_INFINITY;
+        if (num < min || num > max) {
+          const lower = flag.min === void 0 ? "-Infinity" : String(min);
+          const upper = flag.max === void 0 ? "Infinity" : String(max);
+          printError("validation", `--${flag.name} must be a number between ${lower} and ${upper} (got: ${val})`);
+          process.exit(1);
         }
       }
     }
+    if (globalOpts.validate && globalOpts.dryRun) {
+      printError(
+        "validation",
+        "Cannot combine --validate and --dry-run.",
+        "Use --validate to fix parameters; use --dry-run as the pre-execution confirmation."
+      );
+      process.exit(1);
+    }
+    if (globalOpts.validate) {
+      if (cmd.validateInput) {
+        const validateResult = await cmd.validateInput(ctx);
+        await printOutput(validateResult, globalOpts.format, globalOpts.jq);
+      } else {
+        await printOutput(
+          { message: "No --validate implementation for this command (capability gateway commands only)" },
+          globalOpts.format
+        );
+      }
+      return;
+    }
     if (globalOpts.dryRun) {
       if (cmd.dryRun) {
-        const dryResult = cmd.dryRun(ctx);
-        printOutput(dryResult, globalOpts.format, globalOpts.jq);
+        const dryResult = await cmd.dryRun(ctx);
+        await printOutput(dryResult, globalOpts.format, globalOpts.jq);
       } else {
-        printOutput({ message: "No dry-run implementation for this command" }, globalOpts.format);
+        await printOutput({ message: "No dry-run implementation for this command" }, globalOpts.format);
       }
       return;
     }
@@ -86,8 +121,12 @@ async function runCommand(cmd, opts, globalOpts) {
       }
     }
     const result = await cmd.execute(ctx);
-    ctx.out(result);
+    await ctx.out(result);
   } catch (err) {
+    if (err?.type === "validation" && typeof err?.hint === "string" && String(err.message || "").includes("--jq")) {
+      printError("validation", err.message, err.hint);
+      process.exit(1);
+    }
     const message = err.message || String(err);
     logger.error(`Command failed: ${message}`);
     if (err instanceof TeAgentCredentialsError) {
@@ -95,7 +134,7 @@ async function runCommand(cmd, opts, globalOpts) {
     } else if (err instanceof PermissionError) {
       printError("permission", message);
     } else if (err instanceof CapabilityGatewayError) {
-      printError("api", message, err.hint, err.code);
+      printError("api", message, err.hint ?? capabilityGatewayHint(err), err.code, err.meta);
     } else if (err instanceof SecureStoreAuthError) {
       printError("auth", message, "Run: ae-cli auth login");
     } else if (err instanceof TeAgentApiError) {
@@ -114,6 +153,15 @@ async function runCommand(cmd, opts, globalOpts) {
     process.exit(1);
   }
 }
+function capabilityGatewayHint(err) {
+  if (err.code === "CAPABILITY_NOT_FOUND") {
+    return "The current host does not expose this capability. Do not retry with different parameters; use a supported command path or ask the platform/backend owner to enable the capability.";
+  }
+  if (err.httpStatus === 404 && !err.code) {
+    return "The current host returned 404 for this capability route. Do not keep retrying the same command; verify the backend route/capability deployment.";
+  }
+  return void 0;
+}
 function looksLikeAuthFailure(message) {
   const m = message.toLowerCase();
   if (m.includes("403") || m.includes("forbidden") || m.includes("permission")) return false;
@@ -184,8 +232,8 @@ function createRuntimeContext(cmd, opts, globalOpts) {
     service() {
       return cmd.service;
     },
-    out(data) {
-      printOutput(data, globalOpts.format, globalOpts.jq);
+    async out(data) {
+      await printOutput(data, globalOpts.format, globalOpts.jq);
     }
   };
   return ctx;
@@ -215,15 +263,19 @@ function registerCommands(program2, commands) {
     let serviceCmd = program2.commands.find((c) => c.name() === service);
     if (!serviceCmd) {
       serviceCmd = program2.command(service).description(`${service} domain commands`);
+      serviceCmd.allowExcessArguments(false);
     }
     for (const cmd of cmds) {
       let parent = serviceCmd;
       if (cmd.resource) {
-        let resourceCmd = serviceCmd.commands.find((c) => c.name() === cmd.resource);
-        if (!resourceCmd) {
-          resourceCmd = serviceCmd.command(cmd.resource).description(`${cmd.resource} commands`);
+        for (const resource of cmd.resource.split(/\s+/).filter(Boolean)) {
+          let resourceCmd = parent.commands.find((c) => c.name() === resource);
+          if (!resourceCmd) {
+            resourceCmd = parent.command(resource).description(`${resource} commands`);
+            resourceCmd.allowExcessArguments(false);
+          }
+          parent = resourceCmd;
         }
-        parent = resourceCmd;
       }
       const sub = parent.command(cmd.command).description(cmd.description);
       for (const flag of cmd.flags) {
@@ -237,9 +289,13 @@ function registerCommands(program2, commands) {
         }
       }
       sub.option("--host <url>", "Override active AE host URL for this command");
+      sub.option("--format <format>", "Output format: json | table. Default: json.");
+      sub.option("--jq <expr>", "jq 1.8 filter over command payload, applied before output envelope wrapping.");
       sub.action(async (opts) => {
         const globalOpts = extractGlobalOptions(program2);
         if (opts.host) globalOpts.host = opts.host;
+        if (opts.format) globalOpts.format = opts.format;
+        if (opts.jq) globalOpts.jq = opts.jq;
         await runCommand(cmd, opts, globalOpts);
       });
     }
@@ -273,6 +329,7 @@ function extractGlobalOptions(program2) {
     mcpUrl: opts.mcpUrl,
     format: opts.format || "json",
     jq: opts.jq,
+    validate: opts.validate || false,
     dryRun: opts.dryRun || false,
     yes: opts.yes || false
   };
@@ -1219,7 +1276,8 @@ var TrackingClient = class {
     }
     const data = await executeCapability(this.host, TRACK_CAPABILITY_DOMAIN, TRACK_PROGRAM_EXCEL_SAVE, {
       project_id: args.projectId,
-      input_file_id: inputFileId
+      input_file_id: inputFileId,
+      ...args.lang ? { lang: args.lang } : {}
     });
     const env = normalizeUploadResponse(data);
     if (env.return_code !== 0 && env.return_code !== void 0 && !env.data?.eventErrorMap && !env.data?.userErrorMap) {
@@ -2067,7 +2125,8 @@ function registerPlan(cmd, rootProgram) {
       lastRes = await client.uploadProgramExcel({
         projectId: opts.project,
         file,
-        filename: path3.basename(opts.xlsx)
+        filename: path3.basename(opts.xlsx),
+        lang: locale
       });
       console.log(JSON.stringify(lastRes, null, 2));
       if (lastRes.return_code === -1001 && !tokenRefreshed) {
@@ -3000,41 +3059,44 @@ var require2 = createRequire(import.meta.url);
 var pkg = require2("../package.json");
 var { version } = pkg;
 var program = new CommanderCommand();
-program.name("ae-cli").version(version).description("CLI tool for ThinkingAI (AE) analytics platform").option("--host <url>", "Override active AE host URL (e.g., https://ta.thinkingdata.cn)").option("--mcp-url <url>", "Override MCP server URL (e.g., http://localhost/mcp/http/example)").option("--format <format>", "Output format: json | table", "json").option("--jq <expr>", "jq filter expression").option("--dry-run", "Show request details without executing", false).option("--yes", "Skip confirmation for write operations", false).option("--no-update-check", "Skip checking for newer ae-cli versions", false);
+program.name("ae-cli").version(version).description("CLI tool for ThinkingAI (AE) analytics platform").option("--host <url>", "Override active AE host URL (e.g., https://ta.thinkingdata.cn)").option("--mcp-url <url>", "Override MCP server URL (e.g., http://localhost/mcp/http/example)").option("--format <format>", "Output format: json | table", "json").option("--jq <expr>", "jq 1.8 filter over command payload (via jq-wasm), applied before output envelope").option(
+  "--validate",
+  "Optional: validate/normalize capability input only (gateway /validate). Use alone while fixing complex params/qp; do not stack with --dry-run",
+  false
+).option(
+  "--dry-run",
+  "Optional: pre-execution preview without business logic (gateway /dry-run; other transports preview). Use alone to confirm a run; do not stack with --validate",
+  false
+).option("--yes", "Skip confirmation for high-risk write operations", false).option("--no-update-check", "Skip checking for newer ae-cli versions", false);
 async function loadCommands() {
   const commands = [];
   try {
-    const teAnalysis = await import("./te-analysis-HCDNYI7E.js");
+    const teAnalysis = await import("./te-analysis-NJGNWZFC.js");
     commands.push(...teAnalysis.default);
   } catch {
   }
   try {
-    const teAudience = await import("./te-audience-WO377T2J.js");
-    commands.push(...teAudience.default);
-  } catch {
-  }
-  try {
-    const teMeta = await import("./te-meta-PKT27OTN.js");
+    const teMeta = await import("./te-meta-MAAUHFQO.js");
     commands.push(...teMeta.default);
   } catch {
   }
   try {
-    const teCommon = await import("./te-common-CFGQXTFV.js");
+    const teCommon = await import("./te-common-7VTJZPII.js");
     commands.push(...teCommon.default);
   } catch {
   }
   try {
-    const engage = await import("./te-engage-545HJL6J.js");
+    const engage = await import("./te-engage-BUWVSSSK.js");
     commands.push(...engage.default);
   } catch {
   }
   try {
-    const community = await import("./te-community-6A7LKYUH.js");
+    const community = await import("./te-community-TSKJ652U.js");
     commands.push(...community.default);
   } catch {
   }
   try {
-    const dataops = await import("./te-dataops-Z53CTG2U.js");
+    const dataops = await import("./te-dataops-F36T656A.js");
     commands.push(...dataops.default);
   } catch {
   }
@@ -3044,17 +3106,17 @@ async function loadCommands() {
   } catch {
   }
   try {
-    const teTeam = await import("./te-team-RG75PR5D.js");
+    const teTeam = await import("./te-team-OKCOX7OE.js");
     commands.push(...teTeam.default);
   } catch {
   }
   try {
-    const teAgent = await import("./te-agent-FAIBM3SA.js");
+    const teAgent = await import("./te-agent-FCCWUDTJ.js");
     commands.push(...teAgent.default);
   } catch {
   }
   try {
-    const metadata = await import("./metadata-6CCFV4K5.js");
+    const metadata = await import("./metadata-W6JFFMBA.js");
     commands.push(...metadata.default);
   } catch {
   }
@@ -3062,35 +3124,35 @@ async function loadCommands() {
 }
 async function registerAuthCommands() {
   try {
-    const { registerAuth } = await import("./auth-7TQRGLBC.js");
+    const { registerAuth } = await import("./auth-7H3HAAJ3.js");
     registerAuth(program);
   } catch {
   }
 }
 async function registerConfigCommands() {
   try {
-    const { registerConfig } = await import("./config-ZVPARN4R.js");
+    const { registerConfig } = await import("./config-7UZWDE74.js");
     registerConfig(program);
   } catch {
   }
 }
 async function registerApiCommand() {
   try {
-    const { registerApi } = await import("./raw-OHSUK42D.js");
+    const { registerApi } = await import("./raw-CN542NGT.js");
     registerApi(program);
   } catch {
   }
 }
 async function registerCapabilityCommands() {
   try {
-    const { registerCapability } = await import("./capability-KVA55RMK.js");
+    const { registerCapability } = await import("./capability-SEH3JWLN.js");
     registerCapability(program);
   } catch {
   }
 }
 async function registerSyncCommand() {
   try {
-    const { registerSync } = await import("./sync-ULT5SECP.js");
+    const { registerSync } = await import("./sync-ERNHDPB5.js");
     registerSync(program);
   } catch {
   }
@@ -3113,6 +3175,41 @@ async function main() {
   await registerSyncCommand();
   await registerModelCommand();
   registerTracking(program);
+  rejectUnknownHelpCommandPath(program, process.argv.slice(2));
   program.parse();
 }
 main();
+function rejectUnknownHelpCommandPath(root, args) {
+  if (!args.includes("--help") && !args.includes("-h")) {
+    return;
+  }
+  let current = root;
+  for (let i = 0; i < args.length; i += 1) {
+    const token = args[i];
+    if (token === "--" || token === "--help" || token === "-h") {
+      return;
+    }
+    if (token.startsWith("-")) {
+      if (optionConsumesValue(token)) {
+        i += 1;
+      }
+      continue;
+    }
+    const child = current.commands.find((cmd) => cmd.name() === token || cmd.aliases().includes(token));
+    if (child) {
+      current = child;
+      continue;
+    }
+    if (current.commands.length > 0) {
+      process.stderr.write(`error: unknown command '${token}'
+`);
+      process.exit(1);
+    }
+  }
+}
+function optionConsumesValue(token) {
+  if (token.includes("=")) {
+    return false;
+  }
+  return token === "--host" || token === "--mcp-url" || token === "--format" || token === "--jq";
+}