@dench.com/cli 3.8.5-staging.406 → 3.9.0-staging.415

package/campaign.ts

@@ -28,6 +28,7 @@ import {
   linesTemplateFromFile,
   normalizedLineKey,
 } from "./lib/campaign-lines";
+import { campaignReferenceResult } from "./lib/campaign-reference";
 import {
   checkCampaignSteps,
   hasHtmlAndTextBody,
@@ -56,6 +57,11 @@ import {
 } from "./lib/cli-args";
 import { cliVersion } from "./lib/cli-version";
 import { formatCents } from "./lib/search-pricing";
+import {
+  boundWorkspaceReferences,
+  type WorkspaceReferences,
+  withWorkspaceReferenceEnvelopeUrls,
+} from "./lib/workspace-references";
 
 export class CampaignCliError extends Error {}
 
@@ -74,6 +80,7 @@ type CampaignCliContext = {
   jsonOutput: boolean;
   sessionToken?: string;
   host?: string;
+  workspaceSlug?: string;
 };
 
 const OUTREACH = "functions/outreachSequences";
@@ -1382,12 +1389,43 @@ async function loadDetail(
 
 async function runList(ctx: CampaignCliContext): Promise<void> {
   const includeArchived = hasFlag(ctx.args, "--all");
+  const withReferences = hasFlag(ctx.args, "--with-references");
   unknownFlags(ctx.args, "campaign list");
-  const rows = await listCampaigns(ctx, includeArchived);
+  const response = withReferences
+    ? await callQuery(ctx, `${OUTREACH}:listSequencesWithReferences`, {
+        includeArchived,
+      })
+    : await listCampaigns(ctx, includeArchived);
+  const envelope = response as {
+    data?: CampaignRow[];
+  } & Partial<WorkspaceReferences>;
+  const rows = Array.isArray(response)
+    ? (response as CampaignRow[])
+    : (envelope.data ?? []);
+  const payload = withReferences
+    ? withWorkspaceReferenceEnvelopeUrls(
+        {
+          data: rows,
+          ...(envelope.references
+            ? {
+                references: envelope.references,
+                referenceCoverage: envelope.referenceCoverage,
+              }
+            : boundWorkspaceReferences(
+                rows.flatMap(
+                  (row) =>
+                    campaignReferenceResult(ctx, {}, String(row._id), row.name)
+                      .references,
+                ),
+              )),
+        },
+        ctx,
+      )
+    : rows;
   if (rows.length === 0) {
     out(
       ctx,
-      rows,
+      payload,
       includeArchived
         ? 'No campaigns yet. Create one with: dench campaign create --name "..."'
         : 'No live campaigns. Add --all to include archived ones, or create one with: dench campaign create --name "..."',
@@ -1401,7 +1439,7 @@ async function runList(ctx: CampaignCliContext): Promise<void> {
     const owner = row.ownerName ? ` · ${row.ownerName}` : "";
     return `${status} ${row.name}  —  ${people}, ${replied}${owner}  [${row._id}]`;
   });
-  out(ctx, rows, lines);
+  out(ctx, payload, lines);
 }
 
 async function runCreate(ctx: CampaignCliContext): Promise<void> {
@@ -1420,7 +1458,7 @@ async function runCreate(ctx: CampaignCliContext): Promise<void> {
     name,
     timezone,
     ...senderPools,
-  })) as { sequenceId: string };
+  })) as { sequenceId: string; references?: unknown[] };
   if (hasScheduleChanges(patch)) {
     await callMutation(ctx, `${OUTREACH}:updateDraft`, {
       sequenceId: created.sequenceId,
@@ -1444,18 +1482,27 @@ async function runCreate(ctx: CampaignCliContext): Promise<void> {
     ...(patch.startsAt !== undefined ? { startsAt: patch.startsAt } : {}),
     ...(patch.endsAt !== undefined ? { endsAt: patch.endsAt } : {}),
   };
-  out(ctx, payload, [
-    `Created draft campaign "${name}" [${created.sequenceId}]`,
-    `Send window: ${schedules
-      .map(
-        (s) =>
-          `${formatWeekdays(s.weekdays)} ${s.startHour}-${s.endHour} ${s.timezone}`,
-      )
-      .join("; ")}`,
-    "Next: dench campaign steps set <campaign> --file steps.json",
-    'Add people: dench campaign search --titles Founder --limit 25 --out audience.json, then dench campaign add <campaign> --people-file audience.json (or --csv, --list, --object lead --view "<view>")',
-    "Then: dench campaign launch <campaign> --check",
-  ]);
+  out(
+    ctx,
+    campaignReferenceResult(
+      ctx,
+      { ...payload, references: created.references },
+      created.sequenceId,
+      name,
+    ),
+    [
+      `Created draft campaign "${name}" [${created.sequenceId}]`,
+      `Send window: ${schedules
+        .map(
+          (s) =>
+            `${formatWeekdays(s.weekdays)} ${s.startHour}-${s.endHour} ${s.timezone}`,
+        )
+        .join("; ")}`,
+      "Next: dench campaign steps set <campaign> --file steps.json",
+      'Add people: dench campaign search --titles Founder --limit 25 --out audience.json, then dench campaign add <campaign> --people-file audience.json (or --csv, --list, --object lead --view "<view>")',
+      "Then: dench campaign launch <campaign> --check",
+    ],
+  );
 }
 
 async function runDuplicate(ctx: CampaignCliContext): Promise<void> {
@@ -1468,7 +1515,7 @@ async function runDuplicate(ctx: CampaignCliContext): Promise<void> {
   const row = await resolveCampaign(ctx, reference);
   const created = (await callMutation(ctx, `${OUTREACH}:duplicateSequence`, {
     sequenceId: row._id,
-  })) as { sequenceId: string };
+  })) as { sequenceId: string; references?: unknown[] };
   if (name !== undefined) {
     await callMutation(ctx, `${OUTREACH}:updateDraft`, {
       sequenceId: created.sequenceId,
@@ -1479,14 +1526,20 @@ async function runDuplicate(ctx: CampaignCliContext): Promise<void> {
   const steps = row.stepCount ?? 0;
   out(
     ctx,
-    {
-      sequenceId: created.sequenceId,
-      name: copyName,
-      status: "draft",
-      duplicatedFrom: row._id,
-      stepCount: steps,
-      people: 0,
-    },
+    campaignReferenceResult(
+      ctx,
+      {
+        references: created.references,
+        sequenceId: created.sequenceId,
+        name: copyName,
+        status: "draft",
+        duplicatedFrom: row._id,
+        stepCount: steps,
+        people: 0,
+      },
+      created.sequenceId,
+      copyName,
+    ),
     [
       `Duplicated "${row.name}" as the draft "${copyName}" [${created.sequenceId}]: ${steps} ${steps === 1 ? "step" : "steps"}, the same schedule, senders and personalized lines, its lead source (paused), and nobody in it yet.`,
       `Next: dench campaign add ${created.sequenceId} ... (up to ${MAX_CAMPAIGN_PEOPLE} people), then dench campaign launch ${created.sequenceId} --check`,
@@ -1631,7 +1684,19 @@ async function runGet(ctx: CampaignCliContext): Promise<void> {
   }
   out(
     ctx,
-    { detail, analytics, live, ...(analyticsError ? { analyticsError } : {}) },
+    campaignReferenceResult(
+      ctx,
+      {
+        detail,
+        analytics,
+        live,
+        references: (detail as CampaignDetail & Partial<WorkspaceReferences>)
+          .references,
+        ...(analyticsError ? { analyticsError } : {}),
+      },
+      sequenceId,
+      sequence.name,
+    ),
     lines,
   );
 }
@@ -4234,7 +4299,7 @@ Start here (references/CAMPAIGNS.md has the full recipe, from a brief to launch)
   6. dench campaign launch <campaign> --check, then launch once the user says yes
 
 Browse:
-  dench campaign list [--all]                       # live campaigns; --all includes archived
+  dench campaign list [--all] [--with-references]                       # live campaigns; --all includes archived
   dench campaign get <campaign>                     # status, schedule, funnel, Now/Next, holds, people
   dench campaign people <campaign> [--status active|paused|finished|replied|stopped|bounced|failed|draft|complained|unsubscribed]
   dench campaign events <campaign> [--limit 50] [--max-pages 1]   # activity log, newest first
@@ -4468,6 +4533,7 @@ export async function runCampaignCommand(opts: {
   sessionToken?: string;
   jsonOutput?: boolean;
   host?: string;
+  workspaceSlug?: string;
 }): Promise<void> {
   const args = [...opts.args];
   const jsonOutput = hasFlag(args, "--json") || opts.jsonOutput === true;
@@ -4477,6 +4543,7 @@ export async function runCampaignCommand(opts: {
     jsonOutput,
     sessionToken: opts.sessionToken,
     host: opts.host,
+    workspaceSlug: opts.workspaceSlug,
   };
   const subcommand = args.shift();
   if (

package/crm.ts

@@ -29,6 +29,7 @@
  *   crm docs      list / create / link
  *   crm actions   list / run / runs
  */
+
 import type { ConvexHttpClient } from "convex/browser";
 import { makeFunctionReference } from "convex/server";
 import { runAnalyticsCommand } from "./crm-analytics";
@@ -76,6 +77,12 @@ import {
 } from "./lib/enrichment-gateway";
 import { closestMatch, levenshteinDistance } from "./lib/levenshtein";
 import { publicErrorMessage } from "./lib/public-error";
+import {
+  boundWorkspaceReferences,
+  type WorkspaceReference,
+  withWorkspaceReferenceEnvelopeUrls,
+  workspaceReferenceHref,
+} from "./lib/workspace-references";
 
 type JsonRecord = Record<string, unknown>;
 
@@ -663,23 +670,38 @@ export async function applyBatchOpsInChunks(
   idempotencyKey: string | undefined,
   allowUnknown = false,
   onConflict?: CrmOnConflictPolicy,
-): Promise<{ chunks: number; results: unknown[] }> {
+  withReferences = false,
+): Promise<{
+  chunks: number;
+  results: unknown[];
+  references: WorkspaceReference[];
+}> {
   const chunks = chunkArray(ops, CRM_BATCH_CHUNK_SIZE);
   const results: unknown[] = [];
+  const references: WorkspaceReference[] = [];
   for (const [chunkIndex, chunk] of chunks.entries()) {
     const chunkKey = chunkIdempotencyKey(idempotencyKey, chunkIndex);
     const batchResult = (await callMutation(ctx, api.batch.apply, {
       ops: chunk,
+      ...(withReferences ? { withReferences: true } : {}),
       ...runContextArgs(ctx),
       ...(chunkKey ? { idempotencyKey: chunkKey } : {}),
       ...(allowUnknown ? { allowUnknown: true } : {}),
       ...(onConflict ? { onConflict } : {}),
-    })) as { results?: unknown[] } | null | undefined;
+    })) as
+      | { results?: unknown[]; references?: WorkspaceReference[] }
+      | null
+      | undefined;
+    references.push(...(batchResult?.references ?? []));
     if (Array.isArray(batchResult?.results)) {
       results.push(...batchResult.results);
     }
   }
-  return { chunks: chunks.length, results };
+  return {
+    chunks: chunks.length,
+    results,
+    references: boundWorkspaceReferences(references).references,
+  };
 }
 
 function runContextArgs(ctx: CrmCliContext): Record<string, string> {
@@ -871,6 +893,12 @@ export function out(ctx: CrmCliContext, value: unknown): void {
   console.log(JSON.stringify(value, null, 2));
 }
 
+/** Only known product envelopes carry navigation metadata. Cells, documents,
+ * exports and arbitrary JSON values must pass through out() unchanged. */
+function outWithReferences(ctx: CrmCliContext, value: unknown): void {
+  out(ctx, withWorkspaceReferenceEnvelopeUrls(value, ctx));
+}
+
 function getFieldEnrichmentFlag(args: string[]):
   | {
       category: EnrichmentCategory;
@@ -1009,6 +1037,9 @@ const api = {
   },
   entries: {
     list: makeFunctionReference<"query">("functions/crm/entries:list"),
+    listWithReferences: makeFunctionReference<"query">(
+      "functions/crm/entries:listWithReferences",
+    ),
     listPage: makeFunctionReference<"query">("functions/crm/entries:listPage"),
     get: makeFunctionReference<"query">("functions/crm/entries:get"),
     create: makeFunctionReference<"mutation">("functions/crm/entries:create"),
@@ -1029,6 +1060,9 @@ const api = {
     append: makeFunctionReference<"mutation">("functions/crm/cells:append"),
   },
   query: {
+    queryEntriesWithReferences: makeFunctionReference<"action">(
+      "functions/crm/query:runQueryEntriesWithReferences",
+    ),
     queryEntries: makeFunctionReference<"action">(
       "functions/crm/query:runQueryEntries",
     ),
@@ -1037,6 +1071,9 @@ const api = {
     ),
     aggregate: makeFunctionReference<"query">("functions/crm/query:aggregate"),
     search: makeFunctionReference<"query">("functions/crm/query:search"),
+    searchWithReferences: makeFunctionReference<"query">(
+      "functions/crm/query:searchWithReferences",
+    ),
     searchPage: makeFunctionReference<"query">(
       "functions/crm/query:searchPage",
     ),
@@ -1126,7 +1163,7 @@ export async function runCrmCommand(opts: {
   }
   if (isCrmReadHelpRequest(opts.args)) {
     if (subcommand === "query") {
-      console.log(`Usage: dench crm query <object> [--where '<JSON>'] [--select Name,Email] [--sort -Score] [--limit N] [--json]
+      console.log(`Usage: dench crm query <object> [--with-references] [--where '<JSON>'] [--select Name,Email] [--sort -Score] [--limit N] [--json]
   --page [--cursor '<continueCursor>']  Return {page,isDone,continueCursor} in index order; omit --sort.
   --assigned-to me|unassigned|<userId|email> (or --mine) [--assignee-field <Field>]
   Default limit: 100. Maximum: 1000 for a one-shot array, 100 for a cursor page.
@@ -1482,26 +1519,60 @@ async function runSidebarCommand(ctx: CrmCliContext): Promise<void> {
   }
 }
 
+function objectResultReferences(value: unknown) {
+  const refs: WorkspaceReference[] = Array.isArray(value)
+    ? value.flatMap((raw) => {
+        if (!raw || typeof raw !== "object" || typeof raw.name !== "string")
+          return [];
+        const identity = {
+          kind: "crm-object" as const,
+          objectName: raw.name,
+          ...(typeof raw._id === "string" ? { objectId: raw._id } : {}),
+        };
+        return [
+          {
+            ...identity,
+            label:
+              typeof raw.displayName === "string" && raw.displayName
+                ? raw.displayName
+                : raw.name,
+            href: workspaceReferenceHref(identity),
+            ...(typeof raw.icon === "string" ? { objectIcon: raw.icon } : {}),
+          },
+        ];
+      })
+    : [];
+  return boundWorkspaceReferences(refs);
+}
+
 async function runObjectsCommand(ctx: CrmCliContext): Promise<void> {
   const verb = ctx.args.shift();
   switch (verb) {
     case "list": {
       const compact = hasFlag(ctx.args, "--compact");
+      const references = hasFlag(ctx.args, "--with-references");
       assertNoUnknownFlags(ctx.args, "crm objects list");
-      out(
+      const data = await callQuery(
         ctx,
-        await callQuery(
-          ctx,
-          compact ? api.objects.listCompact : api.objects.list,
-          {},
-        ),
+        compact ? api.objects.listCompact : api.objects.list,
+        {},
+      );
+      outWithReferences(
+        ctx,
+        references ? { data, ...objectResultReferences(data) } : data,
       );
       return;
     }
     case "get": {
       const name = shift(ctx.args, "object name");
       assertNoUnknownFlags(ctx.args, "crm objects get");
-      out(ctx, await callQuery(ctx, api.objects.get, { name }));
+      const data = await callQuery(ctx, api.objects.get, { name });
+      outWithReferences(
+        ctx,
+        data && typeof data === "object"
+          ? { ...data, ...objectResultReferences([data]) }
+          : data,
+      );
       return;
     }
     case "create": {
@@ -1514,7 +1585,7 @@ async function runObjectsCommand(ctx: CrmCliContext): Promise<void> {
       const defaultView = getFlag(ctx.args, "--default-view") as any;
       const icon = getFlag(ctx.args, "--icon");
       assertNoUnknownFlags(ctx.args, "crm objects create");
-      out(
+      outWithReferences(
         ctx,
         await callMutation(ctx, api.objects.create, {
           name,
@@ -2459,6 +2530,7 @@ async function runEntriesCommand(ctx: CrmCliContext): Promise<void> {
     case "list": {
       const objectName = shift(ctx.args, "object name");
       const withMeta = hasFlag(ctx.args, "--with-meta");
+      const withReferences = hasFlag(ctx.args, "--with-references");
       const cursorSpecified = ctx.args.includes("--cursor");
       const cursorValue = ctx.args[ctx.args.indexOf("--cursor") + 1];
       if (
@@ -2496,13 +2568,17 @@ async function runEntriesCommand(ctx: CrmCliContext): Promise<void> {
       if (!withMeta) {
         // Bare-array output: the clamp warning already went to stderr
         // (stdout must stay a valid JSON array in --json mode).
-        out(
+        outWithReferences(
           ctx,
-          await callQuery(ctx, api.entries.list, {
-            objectName,
-            limit: limit.effective,
-            ...assigneeScopeArgs,
-          }),
+          await callQuery(
+            ctx,
+            withReferences ? api.entries.listWithReferences : api.entries.list,
+            {
+              objectName,
+              limit: limit.effective,
+              ...assigneeScopeArgs,
+            },
+          ),
         );
         return;
       }
@@ -2513,6 +2589,7 @@ async function runEntriesCommand(ctx: CrmCliContext): Promise<void> {
           ? callQuery(ctx, api.query.scanEntries, {
               objectName,
               dsl: { limit: limit.effective },
+              withReferences: true,
               paginationOpts: {
                 cursor: cursor ?? null,
                 numItems: limit.effective,
@@ -2522,12 +2599,16 @@ async function runEntriesCommand(ctx: CrmCliContext): Promise<void> {
           : callQuery(ctx, api.entries.listPage, {
               objectName,
               limit: limit.effective,
+              withReferences: true,
               ...(cursor !== undefined ? { cursor } : {}),
             }),
         callQuery(ctx, api.objects.get, { name: objectName }),
       ])) as [
         {
           page?: unknown[];
+          objectName?: string;
+          references?: WorkspaceReference[];
+          referenceCoverage?: { available: number };
           isDone?: boolean;
           continueCursor?: string | null;
           truncated?: boolean;
@@ -2544,8 +2625,14 @@ async function runEntriesCommand(ctx: CrmCliContext): Promise<void> {
         : isDone === true && !truncated
           ? false
           : null;
-      out(ctx, {
-        objectName,
+      outWithReferences(ctx, {
+        ...(result?.references
+          ? boundWorkspaceReferences(
+              result.references,
+              result.referenceCoverage?.available,
+            )
+          : {}),
+        objectName: result?.objectName ?? objectName,
         totalCount:
           typeof object?.entryCount === "number" ? object.entryCount : null,
         totalCountScope: "object",
@@ -2700,7 +2787,7 @@ async function runEntriesCommand(ctx: CrmCliContext): Promise<void> {
         }),
       );
       if (!withContext) {
-        out(ctx, entry);
+        outWithReferences(ctx, entry);
         return;
       }
       const [activity, notes, brief] = await Promise.all([
@@ -2724,7 +2811,7 @@ async function runEntriesCommand(ctx: CrmCliContext): Promise<void> {
           { objectName, entryId },
         ),
       ]);
-      out(ctx, {
+      outWithReferences(ctx, {
         ...(entry as Record<string, unknown>),
         context: {
           brief,
@@ -2770,7 +2857,7 @@ async function runEntriesCommand(ctx: CrmCliContext): Promise<void> {
       // Single-row writes rely on the server's schema validation (which
       // returns the same "did you mean …" hint the CLI would). No local
       // pre-fetch — that would add a round-trip to every create.
-      out(
+      outWithReferences(
         ctx,
         withCrmEntryDeepLinks(
           ctx,
@@ -2823,7 +2910,7 @@ async function runEntriesCommand(ctx: CrmCliContext): Promise<void> {
             }),
           )
         : null;
-      const { chunks, results } = await applyBatchOpsInChunks(
+      const { chunks, results, references } = await applyBatchOpsInChunks(
         ctx,
         rows.map((data, index) => ({
           type: "entries.create",
@@ -2840,6 +2927,7 @@ async function runEntriesCommand(ctx: CrmCliContext): Promise<void> {
         idempotencyKey,
         allowUnknown,
         seedKeys ? onConflict : undefined,
+        true,
       );
       // Only claim per-row links when we actually got a result per row. A
       // silently-empty `results` is indistinguishable from "this object has
@@ -2848,7 +2936,8 @@ async function runEntriesCommand(ctx: CrmCliContext): Promise<void> {
       const linked = results.length;
       const statusCounts =
         seedKeys && results.length > 0 ? countResultStatuses(results) : null;
-      out(ctx, {
+      outWithReferences(ctx, {
+        ...boundWorkspaceReferences(references, results.length),
         created: statusCounts ? statusCounts.created : rows.length,
         ...(statusCounts
           ? {
@@ -3217,6 +3306,7 @@ async function runCellsCommand(ctx: CrmCliContext): Promise<void> {
 
 async function runQueryCommand(ctx: CrmCliContext): Promise<void> {
   const objectName = shift(ctx.args, "object name");
+  const withReferences = hasFlag(ctx.args, "--with-references");
   const filter = parseJson(getFlag(ctx.args, "--where")) as
     | JsonRecord
     | undefined;
@@ -3240,16 +3330,32 @@ async function runQueryCommand(ctx: CrmCliContext): Promise<void> {
   const dsl = { filter, select, sort, limit: limit.effective };
   const hasDollarKey = filter ? containsDollarKey(filter) : false;
   const args = hasDollarKey
-    ? { objectName, dslJson: JSON.stringify(dsl), ...assigneeScopeArgs }
-    : { objectName, dsl, ...assigneeScopeArgs };
-  out(
+    ? {
+        objectName,
+        dslJson: JSON.stringify(dsl),
+        ...assigneeScopeArgs,
+        ...(pageMode ? { withReferences: true } : {}),
+      }
+    : {
+        objectName,
+        dsl,
+        ...assigneeScopeArgs,
+        ...(pageMode ? { withReferences: true } : {}),
+      };
+  outWithReferences(
     ctx,
     pageMode
       ? await callQuery(ctx, api.query.scanEntries, {
           ...args,
           paginationOpts: { cursor: cursor ?? null, numItems: limit.effective },
         })
-      : await callAction(ctx, api.query.queryEntries, args),
+      : await callAction(
+          ctx,
+          withReferences
+            ? api.query.queryEntriesWithReferences
+            : api.query.queryEntries,
+          args,
+        ),
   );
 }
 
@@ -3285,6 +3391,7 @@ async function runAggregateCommand(ctx: CrmCliContext): Promise<void> {
 
 async function runSearchCommand(ctx: CrmCliContext): Promise<void> {
   const objectName = getFlag(ctx.args, "--object");
+  const withReferences = hasFlag(ctx.args, "--with-references");
   const selectRaw = getFlag(ctx.args, "--select");
   const select = selectRaw?.split(",").map((name) => name.trim());
   if (select && (select.length > 30 || select.some((name) => !name))) {
@@ -3303,14 +3410,23 @@ async function runSearchCommand(ctx: CrmCliContext): Promise<void> {
   assertNoUnknownFlags(ctx.args, "crm search");
   const text = ctx.args.join(" ").trim();
   if (!text) throw new CrmCliError("Search text required");
-  out(
+  outWithReferences(
     ctx,
-    await callQuery(ctx, projected ? api.query.searchPage : api.query.search, {
-      text,
-      objectName,
-      limit: limit.effective,
-      ...(projected ? { select, cursor } : {}),
-    }),
+    await callQuery(
+      ctx,
+      projected
+        ? api.query.searchPage
+        : withReferences
+          ? api.query.searchWithReferences
+          : api.query.search,
+      {
+        text,
+        objectName,
+        limit: limit.effective,
+        ...(projected ? { withReferences: true } : {}),
+        ...(projected ? { select, cursor } : {}),
+      },
+    ),
   );
 }
 
@@ -4788,7 +4904,7 @@ export function crmHelpText(): string {
   return `Usage: dench crm <subcommand>
 
 Objects (CRM tables):
-  dench crm objects list [--json] [--compact]
+  dench crm objects list [--json] [--compact] [--with-references]
   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]
@@ -4932,7 +5048,7 @@ Fields (columns):
       Update the color (e.g. "#3b82f6") for an existing enum option.
 
 Entries (rows):
-  dench crm entries list <object> [--limit N] [--with-meta [--cursor '<continueCursor>']] [--json]
+  dench crm entries list <object> [--with-references] [--limit N] [--with-meta [--cursor '<continueCursor>']] [--json]
       [--assigned-to me|unassigned|<userId|email> | --mine] [--assignee-field <Field>]
       --with-meta includes readable pagination; totalCount is the entire object's catalog count,
       not a readable or assigned total. Continue only when continueCursor is returned, preserving filters.
@@ -5071,8 +5187,8 @@ Cells (single-field updates):
   dench crm cells append <object> <entryId> <field> '<JSON value>'
 
 Query DSL:
-  dench crm query <object> --where '{"Status":"New"}' --select Name,Email --sort -Score --limit 100
-  dench crm query <object> --page --select Name,Email --limit 100 [--cursor '<continueCursor>'] --json
+  dench crm query <object> [--with-references] --where '{"Status":"New"}' --select Name,Email --sort -Score --limit 100
+  dench crm query <object> [--with-references] --page --select Name,Email --limit 100 [--cursor '<continueCursor>'] --json
     Cursor pages use index order (omit --sort). Continue until isDone, including empty filtered pages.
       [--assigned-to me|unassigned|<userId|email> | --mine] [--assignee-field <Field>]
       --mine AND-s "assigned to me" onto --where without you having to
@@ -5096,7 +5212,7 @@ Aggregates:
   dench crm aggregate <object> --field Status [--sum Amount]
 
 Full-text search:
-  dench crm search [--object <name>] [--select "Name,Email"] [--limit N] [--page] [--cursor <cursor>] <text>
+  dench crm search [--object <name>] [--select "Name,Email"] [--limit N] [--page] [--cursor <cursor>] [--with-references] <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.

package/dench.ts

@@ -5298,6 +5298,10 @@ async function main() {
       jsonOutput: json,
       sessionToken: authedRuntime.sessionToken,
       host: authedRuntime.host,
+      workspaceSlug:
+        authedRuntime.organization?.slug ??
+        process.env.DENCH_ORG_SLUG?.trim() ??
+        undefined,
     });
     return;
   }