@dench.com/cli 3.6.6-staging.386 → 3.7.0-staging.387

package/crm.ts

@@ -239,6 +239,7 @@ function normalizeRpcError(error: unknown): Error {
       userFacingConvexErrorMessage(error) ??
         (error instanceof Error ? error.message : String(error)),
     ),
+    { cause: error },
   );
 }
 
@@ -246,7 +247,8 @@ export function shift(args: string[], expected: string): string {
   try {
     return shiftRaw(args, expected);
   } catch (error) {
-    if (error instanceof CliArgError) throw new CrmCliError(error.message);
+    if (error instanceof CliArgError)
+      throw new CrmCliError(error.message, { cause: error });
     throw error;
   }
 }
@@ -290,7 +292,8 @@ function resolveLimitFlag(
   try {
     parsed = parseLimitRaw(raw, opts);
   } catch (error) {
-    if (error instanceof CliArgError) throw new CrmCliError(error.message);
+    if (error instanceof CliArgError)
+      throw new CrmCliError(error.message, { cause: error });
     throw error;
   }
   if (parsed.clamped) {
@@ -365,7 +368,8 @@ function parseJson(value: string | undefined): unknown {
   try {
     return parseJsonRaw(value);
   } catch (error) {
-    if (error instanceof CliArgError) throw new CrmCliError(error.message);
+    if (error instanceof CliArgError)
+      throw new CrmCliError(error.message, { cause: error });
     throw error;
   }
 }
@@ -377,7 +381,8 @@ export function assertNoUnknownFlags(
   try {
     assertNoUnknownFlagsRaw(args, command);
   } catch (error) {
-    if (error instanceof CliArgError) throw new CrmCliError(error.message);
+    if (error instanceof CliArgError)
+      throw new CrmCliError(error.message, { cause: error });
     throw error;
   }
 }
@@ -780,11 +785,23 @@ export async function callQuery(
   }
 }
 
+/** Every parsed token must be accounted for before an external effect. */
+function assertWriteArguments(ctx: CrmCliContext): void {
+  assertNoUnknownFlags(ctx.args, "crm");
+  if (ctx.args.length) {
+    const error = new CliArgError(
+      `Unexpected argument: ${ctx.args[0]}. Run the command with --help for usage.`,
+    );
+    throw new CrmCliError(error.message, { cause: error });
+  }
+}
+
 export async function callMutation(
   ctx: CrmCliContext,
   fn: Parameters<ConvexHttpClient["mutation"]>[0],
   args: Record<string, unknown> = {},
 ): Promise<unknown> {
+  assertWriteArguments(ctx);
   try {
     return await ctx.convex.mutation(fn, {
       ...args,
@@ -800,6 +817,7 @@ export async function callAction(
   fn: Parameters<ConvexHttpClient["action"]>[0],
   args: Record<string, unknown> = {},
 ): Promise<unknown> {
+  assertWriteArguments(ctx);
   try {
     return await ctx.convex.action(fn, {
       ...args,
@@ -914,6 +932,9 @@ const api = {
   },
   objects: {
     list: makeFunctionReference<"query">("functions/crm/objects:list"),
+    listCompact: makeFunctionReference<"query">(
+      "functions/crm/objects:listCompact",
+    ),
     get: makeFunctionReference<"query">("functions/crm/objects:get"),
     materializeView: makeFunctionReference<"action">(
       "functions/crm/objects:completeView",
@@ -963,6 +984,9 @@ const api = {
   },
   fields: {
     list: makeFunctionReference<"query">("functions/crm/fields:list"),
+    listCompact: makeFunctionReference<"query">(
+      "functions/crm/fields:listCompact",
+    ),
     create: makeFunctionReference<"mutation">("functions/crm/fields:create"),
     update: makeFunctionReference<"mutation">("functions/crm/fields:update"),
     remove: makeFunctionReference<"mutation">("functions/crm/fields:remove"),
@@ -1013,6 +1037,9 @@ const api = {
     ),
     aggregate: makeFunctionReference<"query">("functions/crm/query:aggregate"),
     search: makeFunctionReference<"query">("functions/crm/query:search"),
+    searchPage: makeFunctionReference<"query">(
+      "functions/crm/query:searchPage",
+    ),
   },
   statuses: {
     list: makeFunctionReference<"query">("functions/crm/statuses:list"),
@@ -1459,8 +1486,16 @@ async function runObjectsCommand(ctx: CrmCliContext): Promise<void> {
   const verb = ctx.args.shift();
   switch (verb) {
     case "list": {
+      const compact = hasFlag(ctx.args, "--compact");
       assertNoUnknownFlags(ctx.args, "crm objects list");
-      out(ctx, await callQuery(ctx, api.objects.list, {}));
+      out(
+        ctx,
+        await callQuery(
+          ctx,
+          compact ? api.objects.listCompact : api.objects.list,
+          {},
+        ),
+      );
       return;
     }
     case "get": {
@@ -2159,8 +2194,16 @@ async function runFieldsCommand(ctx: CrmCliContext): Promise<void> {
   switch (verb) {
     case "list": {
       const objectName = shift(ctx.args, "object name");
+      const compact = hasFlag(ctx.args, "--compact");
       assertNoUnknownFlags(ctx.args, "crm fields list");
-      out(ctx, await callQuery(ctx, api.fields.list, { objectName }));
+      out(
+        ctx,
+        await callQuery(
+          ctx,
+          compact ? api.fields.listCompact : api.fields.list,
+          { objectName },
+        ),
+      );
       return;
     }
     case "create": {
@@ -2294,7 +2337,7 @@ async function runFieldsCommand(ctx: CrmCliContext): Promise<void> {
       // Assert before consuming the rest as positional field names so a
       // typo'd flag fails loudly rather than getting silently filtered.
       assertNoUnknownFlags(ctx.args, "crm fields reorder");
-      const orderedFieldNames = [...ctx.args];
+      const orderedFieldNames = ctx.args.splice(0);
       out(
         ctx,
         await callMutation(ctx, api.fields.reorder, {
@@ -2311,7 +2354,7 @@ async function runFieldsCommand(ctx: CrmCliContext): Promise<void> {
       // there are no stray flags so a typo'd `--limit` fails loud
       // instead of being silently consumed as an enum value.
       assertNoUnknownFlags(ctx.args, "crm fields enum-reorder");
-      const orderedValues = [...ctx.args];
+      const orderedValues = ctx.args.splice(0);
       if (orderedValues.length === 0) {
         throw new CrmCliError(
           "dench crm fields enum-reorder requires at least one value. " +
@@ -2417,6 +2460,15 @@ async function runEntriesCommand(ctx: CrmCliContext): Promise<void> {
       const objectName = shift(ctx.args, "object name");
       const withMeta = hasFlag(ctx.args, "--with-meta");
       const cursorSpecified = ctx.args.includes("--cursor");
+      const cursorValue = ctx.args[ctx.args.indexOf("--cursor") + 1];
+      if (
+        cursorSpecified &&
+        (!cursorValue?.trim() || cursorValue.startsWith("--"))
+      )
+        throw new CrmCliError(
+          "--cursor requires a non-empty continuation cursor.",
+          { cause: new CliArgError("Invalid --cursor") },
+        );
       const cursor = getFlag(ctx.args, "--cursor");
       if (cursorSpecified && (!cursor?.trim() || cursor.startsWith("--")))
         throw new CrmCliError(
@@ -2483,8 +2535,7 @@ async function runEntriesCommand(ctx: CrmCliContext): Promise<void> {
         { entryCount?: number; visibility?: string } | null,
       ];
       const entries = Array.isArray(result?.page) ? result.page : [];
-      const isDone =
-        typeof result?.isDone === "boolean" ? result.isDone : null;
+      const isDone = typeof result?.isDone === "boolean" ? result.isDone : null;
       const truncated = result?.truncated === true;
       const continueCursor =
         isDone === false ? result?.continueCursor || null : null;
@@ -3234,25 +3285,31 @@ async function runAggregateCommand(ctx: CrmCliContext): Promise<void> {
 
 async function runSearchCommand(ctx: CrmCliContext): Promise<void> {
   const objectName = getFlag(ctx.args, "--object");
-  // Search caps at 100 server-side. Warn on stderr when clamped (the
-  // output is a bare JSON array, so stdout must stay untouched).
+  const selectRaw = getFlag(ctx.args, "--select");
+  const select = selectRaw?.split(",").map((name) => name.trim());
+  if (select && (select.length > 30 || select.some((name) => !name))) {
+    throw new CrmCliError(
+      "--select requires between 1 and 30 nonempty field names.",
+    );
+  }
+  const page = hasFlag(ctx.args, "--page");
+  const cursor = getFlag(ctx.args, "--cursor");
+  const projected = select !== undefined || page || cursor !== undefined;
   const limit = resolveLimitFlag(ctx.args, {
-    defaultValue: 50,
+    defaultValue: projected ? 20 : 50,
     cap: 100,
     command: "crm search",
   });
-  // Drain known flags before joining the rest into the search text so a
-  // typo like `--objct` surfaces instead of being concatenated into the
-  // query string.
   assertNoUnknownFlags(ctx.args, "crm search");
   const text = ctx.args.join(" ").trim();
   if (!text) throw new CrmCliError("Search text required");
   out(
     ctx,
-    await callQuery(ctx, api.query.search, {
+    await callQuery(ctx, projected ? api.query.searchPage : api.query.search, {
       text,
       objectName,
       limit: limit.effective,
+      ...(projected ? { select, cursor } : {}),
     }),
   );
 }
@@ -3382,7 +3439,8 @@ async function runActionsCommand(ctx: CrmCliContext): Promise<void> {
       const objectName = shift(ctx.args, "object name");
       const fieldId = shift(ctx.args, "field id");
       const actionId = shift(ctx.args, "action id");
-      const entryIds = ctx.args.filter((a) => !a.startsWith("--"));
+      assertNoUnknownFlags(ctx.args, "crm actions run");
+      const entryIds = ctx.args.splice(0);
       if (entryIds.length === 0) {
         throw new CrmCliError("Provide at least one entry id");
       }
@@ -3922,7 +3980,7 @@ export function remapKeys(
 // ── SQL escape hatch ─────────────────────────────────────────────────────
 
 async function runSqlCommand(ctx: CrmCliContext): Promise<void> {
-  const sql = ctx.args.join(" ").trim();
+  const sql = ctx.args.splice(0).join(" ").trim();
   if (!sql) {
     throw new CrmCliError("dench crm sql '<SELECT ... FROM ...>'");
   }
@@ -4411,6 +4469,7 @@ async function enrichCellThroughGateway(
   ctx: CrmCliContext,
   args: CellEnrichmentArgs,
 ): Promise<Record<string, unknown>> {
+  assertWriteArguments(ctx);
   const target = await resolveEnrichmentTarget(ctx, args);
   const entry = asEntry(
     await callQuery(ctx, api.entries.get, {
@@ -4434,6 +4493,7 @@ async function enrichObjectThroughGateway(
   ctx: CrmCliContext,
   args: ObjectEnrichmentArgs,
 ): Promise<Record<string, unknown>> {
+  assertWriteArguments(ctx);
   const target = await resolveEnrichmentTarget(ctx, args);
   const entries = asEntries(
     await callQuery(ctx, api.entries.list, {
@@ -4615,6 +4675,7 @@ async function runEnrichCommand(ctx: CrmCliContext): Promise<void> {
       const lookups = input.map((value, index) =>
         requireNonEmptyJsonRecord(value, `lookup ${index + 1}`),
       );
+      assertWriteArguments(ctx);
       out(ctx, await enrichProfiles({ kind, lookups }, ctx.enrichmentGateway));
       return;
     }
@@ -4720,10 +4781,14 @@ async function runReportsCommand(ctx: CrmCliContext): Promise<void> {
 }
 
 function crmHelp(): void {
-  console.log(`Usage: dench crm <subcommand>
+  console.log(crmHelpText());
+}
+
+export function crmHelpText(): string {
+  return `Usage: dench crm <subcommand>
 
 Objects (CRM tables):
-  dench crm objects list [--json]
+  dench crm objects list [--json] [--compact]
   dench crm objects get <name>
   dench crm objects create <name> [--description ...] [--default-view kanban] [--icon ...]
   dench crm objects update <name> [--default-view ...] [--icon ...] [--display-name "Clients"] [--display-name-singular "Client"] [--visibility workspace|owner_only|owner_plus_members]
@@ -4810,7 +4875,7 @@ Sidebar (progressive disclosure — Library + home Pinned strip; layout is WORKS
       shared shortcut, not a Library move; open to any member.
 
 Fields (columns):
-  dench crm fields list <object> [--json]
+  dench crm fields list <object> [--compact] [--json]
   dench crm fields create <object> <name> --type text|email|phone|url|number|boolean|date|enum|relation|user|tags|action|file|richtext \\
         [--required] [--description ...] [--enum-values JSON] [--enum-colors JSON] \\
         [--enum-multiple] [--related-object <name>] [--relationship many_to_one|many_to_many] \\
@@ -5031,7 +5096,10 @@ Aggregates:
   dench crm aggregate <object> --field Status [--sum Amount]
 
 Full-text search:
-  dench crm search [--object <name>] [--limit N] <text>
+  dench crm search [--object <name>] [--select "Name,Email"] [--limit N] [--page] [--cursor <cursor>] <text>
+      --select returns a compact page with stable IDs, selected cells, isDone
+      and continueCursor. Follow cursors until isDone for complete results.
+      Without --select/--page/--cursor the legacy full-row array is unchanged.
 
 Statuses (kanban columns):
   dench crm statuses list <object>
@@ -5215,5 +5283,5 @@ unambiguous, but prefer canonical names from 'crm objects list'.
 
 Global flags:
   --json    Output raw JSON instead of pretty-printed text.
-`);
+`;
 }

package/dench.ts

@@ -28,10 +28,12 @@ import {
   resolveHostFromArgs,
   STAGING_HOST,
 } from "./host";
+import { CliArgError, isHelpRequest } from "./lib/cli-args";
 import { cliVersion } from "./lib/cli-version";
+import { assertDeclaredCommandFlags } from "./lib/command-args";
 import { denchConfigDirectory } from "./lib/config-path.mjs";
 import { resolveOrganizationBySelector } from "./lib/organizationSelector";
-import { backendErrorText } from "./lib/public-error";
+import { backendErrorText, publicErrorDetails } from "./lib/public-error";
 import { formatApprovalOpenMessage, openUrl } from "./openUrl";
 import {
   explicitSessionKeyInput,
@@ -215,7 +217,10 @@ const api = {
 };
 const CONFIG_DIR = denchConfigDirectory();
 const CONFIG_PATH = join(CONFIG_DIR, "config.json");
-const args = process.argv.slice(2);
+const args = process.argv.slice(2).flatMap((arg) => {
+  const split = arg.startsWith("--") ? arg.indexOf("=") : -1;
+  return split > 2 ? [arg.slice(0, split), arg.slice(split + 1)] : [arg];
+});
 const json = args.includes("--json");
 const filteredArgs = args.filter((arg) => arg !== "--json");
 const scopedStatus = args.includes("--mine") || args.includes("--self");
@@ -321,13 +326,18 @@ function throwIfCliError(value: unknown) {
   }
   const record = value as JsonRecord;
   if (record.ok === false && typeof record.error === "string") {
-    throw new Error(record.error);
+    throw new CliError(record.error, publicErrorDetails(record));
   }
 }
 
 function normalizeCliError(error: unknown): CliError {
-  if (error instanceof CliError) return error;
+  if (error instanceof CliError) {
+    error.payload = { ...error.payload, ...publicErrorDetails(error.payload) };
+    return error;
+  }
   const message = backendErrorText(error);
+  if (error instanceof CliArgError)
+    return new CliError(message, { code: error.code, retryable: false });
   if (message.includes("Invalid dev agent key")) {
     return new CliError("Invalid dev agent key", {
       code: "invalid_dev_agent_key",
@@ -369,7 +379,10 @@ function normalizeCliError(error: unknown): CliError {
       ],
     });
   }
-  return new CliError(message);
+  return new CliError(message, {
+    code: "cli_error",
+    ...publicErrorDetails(error),
+  });
 }
 
 function _parseJsonObjectOption(name: string) {
@@ -673,6 +686,8 @@ Subagents:
   Help: dench agent help
 
   dench --version
+  dench reference <name> [--json]      Offline CLI-version-matched skill/reference
+  dench reference --list [--json]     Bundled reference index and revision
 
 Self-updating agent harness:
   dench identity show | edit                    IDENTITY.md (org-wide)
@@ -2701,12 +2716,21 @@ function stripRuntimeFlags(args: string[]) {
     "--staging",
     "--use-dev-env",
   ]);
-  const valueFlags = new Set(["--convex-url", "--host", "--backend"]);
+  const valueFlags = new Set([
+    "--convex-url",
+    "--host",
+    "--backend",
+    "--session-key",
+    "--session",
+  ]);
   const stripped: string[] = [];
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
     if (booleanFlags.has(arg)) continue;
     if (valueFlags.has(arg)) {
+      if (!args[i + 1] || args[i + 1].startsWith("--")) {
+        throw new CliArgError(`Missing value for ${arg}`);
+      }
       i++;
       continue;
     }
@@ -3392,7 +3416,7 @@ async function resolveFsDaemonEnv(): Promise<NodeJS.ProcessEnv> {
 }
 
 async function runFsCommand() {
-  const subArgs = args.slice(args.indexOf("fs") + 1);
+  const subArgs = stripRuntimeFlags(args.slice(args.indexOf("fs") + 1));
   const configuredBinary = process.env.DENCH_FS_DAEMON_BIN?.trim();
   const binary = configuredBinary || "dench-fs-daemon";
   const daemonEnv = await resolveFsDaemonEnv();
@@ -4303,10 +4327,95 @@ function isCommandNotFound(error: unknown) {
 }
 
 async function main() {
+  if (isHelpRequest(args)) {
+    const helpArgs = stripRuntimeFlags(args).filter((arg) => arg !== "--json");
+    if (helpArgs[0] === "help") helpArgs.shift();
+    if (!helpArgs.length || ["--help", "-h"].includes(helpArgs[0])) {
+      help();
+      return;
+    }
+    const path = helpArgs.filter(
+      (arg) => !["help", "--help", "-h"].includes(arg),
+    );
+    // Root help retains domain-specific setup, account and pagination guidance.
+    // These are explicit help-only paths; never pass mutation arguments to a handler.
+    if (path.length === 1) {
+      const roots: Record<string, () => void | Promise<void>> = {
+        reference: async () =>
+          console.log((await import("./reference")).REFERENCE_HELP),
+        tool: toolHelp,
+        integrations: integrationsHelp,
+        backend: backendHelp,
+        signin: signinHelp,
+        login: signinHelp,
+        onboard: signinHelp,
+        setup: signinHelp,
+        "what-can-i-do": signinHelp,
+        register: signinHelp,
+        memory: memoryHelp,
+        billing: billingHelp,
+        logout: logoutHelp,
+        context: contextHelp,
+        artifacts: artifactsHelp,
+        "suggested-work": artifactsHelp,
+        lists: listsCliHelp,
+        leads: leadsHelp,
+        companies: companiesHelp,
+        jobs: jobsHelp,
+        status: statusHelp,
+        web: async () => (await import("./web")).webHelp(),
+        crm: async () =>
+          (await import("./crm")).runCrmCommand({
+            convex: {} as ConvexHttpClient,
+            args: ["help"],
+          }),
+        apps: async () =>
+          (await import("./apps")).runAppsCommand({
+            convex: {} as ConvexHttpClient,
+            args: ["help"],
+          }),
+      };
+      if (roots[path[0]]) {
+        await roots[path[0]]();
+        return;
+      }
+    }
+    if (helpArgs[0] === "reference") {
+      console.log((await import("./reference")).REFERENCE_HELP);
+      return;
+    }
+    // Preserve the small, established CRM read help including its cursor contract.
+    if (helpArgs[0] === "crm" && ["query", "aggregate"].includes(helpArgs[1])) {
+      const { runCrmCommand } = await import("./crm");
+      await runCrmCommand({
+        convex: {} as ConvexHttpClient,
+        args: [...helpArgs.slice(1), "--help"],
+      });
+      return;
+    }
+    const { commandHelp } = await import("./lib/command-help");
+    const usage =
+      helpArgs[0] === "email"
+        ? (await import("./email")).emailHelpText()
+        : helpArgs[0] === "crm"
+          ? (await import("./crm")).crmHelpText()
+          : "";
+    console.log(commandHelp(helpArgs, usage));
+    return;
+  }
   const command = positional(0);
   const subcommand = positional(1);
 
-  if (command === "version" || hasFlag("--version")) {
+  assertDeclaredCommandFlags(stripRuntimeFlags(args));
+
+  if (command === "reference") {
+    await (await import("./reference")).runReferenceCommand(
+      stripRuntimeFlags(args.slice(args.indexOf("reference") + 1)),
+    );
+    return;
+  }
+
+  if (command === "version" || stripRuntimeFlags(args)[0] === "--version") {
     console.log(await cliVersion());
     return;
   }
@@ -4741,7 +4850,7 @@ async function main() {
   }
 
   if (command === "web") {
-    const subArgs = args.slice(args.indexOf("web") + 1);
+    const subArgs = stripRuntimeFlags(args.slice(args.indexOf("web") + 1));
     const filteredSubArgs = subArgs.filter((a) => a !== "--json");
     const { runWebCommand, webHelp } = await import("./web");
     const sub = filteredSubArgs[0];
@@ -4761,7 +4870,7 @@ async function main() {
   }
 
   if (command === "search") {
-    const subArgs = args.slice(args.indexOf("search") + 1);
+    const subArgs = stripRuntimeFlags(args.slice(args.indexOf("search") + 1));
     const filteredSubArgs = subArgs.filter((a) => a !== "--json");
     const { runSearchCommand } = await import("./search");
     const sub = filteredSubArgs[0];
@@ -4784,7 +4893,7 @@ async function main() {
   }
 
   if (command === "image") {
-    const subArgs = args.slice(args.indexOf("image") + 1);
+    const subArgs = stripRuntimeFlags(args.slice(args.indexOf("image") + 1));
     const filteredSubArgs = subArgs.filter((a) => a !== "--json");
     const { runImageCommand } = await import("./image");
     const sub = filteredSubArgs[0];
@@ -4804,7 +4913,7 @@ async function main() {
   }
 
   if (command === "email") {
-    const subArgs = args.slice(args.indexOf("email") + 1);
+    const subArgs = stripRuntimeFlags(args.slice(args.indexOf("email") + 1));
     const { runEmailCommand } = await import("./email");
     const runtime = await getRuntime();
     const authedRuntime = requireAuthenticatedRuntime(runtime, "dench email");
@@ -4813,7 +4922,7 @@ async function main() {
       | undefined;
     try {
       if (
-        subArgs[0] !== "draft" &&
+        !["draft", "inbox", "send"].includes(subArgs[0]) &&
         !subArgs.some(
           (arg) => arg === "--mailbox" || arg.startsWith("--mailbox="),
         )
@@ -4922,7 +5031,7 @@ async function main() {
   }
 
   if (command === "browser") {
-    const subArgs = args.slice(args.indexOf("browser") + 1);
+    const subArgs = stripRuntimeFlags(args.slice(args.indexOf("browser") + 1));
     const { runBrowserCommand } = await import("./browser");
     const runtime = await getRuntime();
     const authedRuntime = requireAuthenticatedRuntime(runtime, "dench browser");
@@ -4947,7 +5056,7 @@ async function main() {
   // `dench ads` is canonical; `dench ad` and `dench adline` are aliases for
   // the same command (one code path in ./ads).
   if (command === "ads" || command === "ad" || command === "adline") {
-    const subArgs = args.slice(args.indexOf(command) + 1);
+    const subArgs = stripRuntimeFlags(args.slice(args.indexOf(command) + 1));
     const { runAdsCommand } = await import("./ads");
     // Earning is opt-in: resolve the agent session token best-effort so a
     // signed-in developer gets credited on flush, but never require login —
@@ -4983,7 +5092,7 @@ async function main() {
   }
 
   if (command === "chat") {
-    const subArgs = args.slice(args.indexOf("chat") + 1);
+    const subArgs = stripRuntimeFlags(args.slice(args.indexOf("chat") + 1));
     const sub = subArgs[0];
     if (!sub || sub === "help" || sub === "--help") {
       const { runChatCommand } = await import("./chat");
@@ -5033,7 +5142,7 @@ async function main() {
   }
 
   if (command === "agent") {
-    const subArgs = args.slice(args.indexOf("agent") + 1);
+    const subArgs = stripRuntimeFlags(args.slice(args.indexOf("agent") + 1));
     const sub = subArgs[0];
     if (!sub || sub === "help" || sub === "--help") {
       const { runAgentCommand } = await import("./agent");
@@ -5110,7 +5219,7 @@ async function main() {
   // `dench cron`. Same dispatch, same auth, same handler — only the
   // top-level command name differs to match the workspace UI rename.
   if (command === "cron" || command === "routine" || command === "routines") {
-    const subArgs = args.slice(args.indexOf(command) + 1);
+    const subArgs = stripRuntimeFlags(args.slice(args.indexOf(command) + 1));
     const sub = subArgs[0];
     // Help is a no-auth path so users can read the surface without a
     // session — mirrors `dench crm help`.
@@ -5159,7 +5268,7 @@ async function main() {
     "daily",
   ]);
   if (AGENT_CONFIG_COMMANDS.has(command)) {
-    const subArgs = args.slice(args.indexOf(command) + 1);
+    const subArgs = stripRuntimeFlags(args.slice(args.indexOf(command) + 1));
     if (
       subArgs[0] === "help" ||
       subArgs.includes("--help") ||