@dench.com/cli 0.4.0 → 0.4.2

package/chat-spawn.ts

@@ -17,6 +17,7 @@
  * calls until the workflow finishes.
  */
 
+import { getCurrentRuntimeTimeZone } from "@/lib/timezone";
 import { hasFlag } from "./lib/cli-args";
 
 class ChatSpawnError extends Error {}
@@ -64,12 +65,14 @@ async function postJson(
   bearer: string,
   body: unknown,
 ): Promise<{ ok: boolean; status: number; payload: unknown }> {
+  const timezone = getCurrentRuntimeTimeZone();
   const response = await fetch(url, {
     method: "POST",
     headers: {
       accept: "application/json",
       "content-type": "application/json",
       authorization: `Bearer ${bearer}`,
+      ...(timezone ? { "x-dench-user-timezone": timezone } : {}),
     },
     body: JSON.stringify(body),
   });
@@ -258,7 +261,10 @@ async function followStream(args: {
 }
 
 function joinPositionalsExceptFlags(args: string[]): string {
-  return args.filter((arg) => !arg.startsWith("--")).join(" ").trim();
+  return args
+    .filter((arg) => !arg.startsWith("--"))
+    .join(" ")
+    .trim();
 }
 
 async function runChatNew(ctx: ChatSpawnContext): Promise<void> {
@@ -286,6 +292,7 @@ async function runChatNew(ctx: ChatSpawnContext): Promise<void> {
       visibility,
       title,
       yolo,
+      timezone: getCurrentRuntimeTimeZone(),
     },
   );
   if (!result.ok) {
@@ -341,6 +348,7 @@ async function runChatSend(ctx: ChatSpawnContext): Promise<void> {
       prompt,
       model,
       yolo,
+      timezone: getCurrentRuntimeTimeZone(),
     },
   );
   if (!result.ok) {
@@ -385,9 +393,7 @@ async function runChatFollow(ctx: ChatSpawnContext): Promise<void> {
   const positionals = ctx.args.filter((arg) => !arg.startsWith("--"));
   const threadId = positionals.shift();
   if (!threadId) {
-    throw new ChatSpawnError(
-      "Usage: dench chat follow <threadId> [--json]",
-    );
+    throw new ChatSpawnError("Usage: dench chat follow <threadId> [--json]");
   }
   if (!ctx.jsonOutput) {
     console.error(`--- following stream for thread ${threadId} ---`);

package/crm.ts

@@ -17,8 +17,8 @@
  * The full surface mirrors the plan's "dench-cli CRM surface" section:
  *   crm objects   list / get / create / update / delete / rename
  *   crm fields    list / create / update / delete / reorder
- *   crm entries   list / get / create / update / delete / bulk-delete
- *   crm cells     get / set / append
+ *   crm entries   list / get / create / create-many / update / update-many / delete / bulk-delete
+ *   crm cells     get / set / set-many / append
  *   crm query     <object> --where … --select … --sort … --limit …
  *   crm aggregate <object> --field …
  *   crm batch     --file ops.jsonl
@@ -40,6 +40,8 @@ import {
 
 type JsonRecord = Record<string, unknown>;
 
+const CRM_BATCH_CHUNK_SIZE = 200;
+
 type CrmCliContext = {
   convex: ConvexHttpClient;
   args: string[];
@@ -97,6 +99,150 @@ function getDataFlag(args: string[]): string | undefined {
   return getFlagWithAliases(args, "--data", ["--fields"]);
 }
 
+function getUpdatesFlag(args: string[]): string | undefined {
+  return getFlagWithAliases(args, "--updates", ["--data"]);
+}
+
+function isJsonRecord(value: unknown): value is JsonRecord {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+
+function requireNonEmptyJsonRecord(value: unknown, label: string): JsonRecord {
+  if (!isJsonRecord(value) || Object.keys(value).length === 0) {
+    throw new CrmCliError(`${label} must be a non-empty JSON object`);
+  }
+  return value;
+}
+
+async function readJsonArrayInput(opts: {
+  args: string[];
+  command: string;
+  inlineFlag: string;
+  inlineValue: string | undefined;
+}): Promise<unknown[]> {
+  const filePath = getFlag(opts.args, "--file");
+  assertNoUnknownFlags(opts.args, opts.command);
+  if (opts.inlineValue !== undefined && filePath) {
+    throw new CrmCliError(
+      `${opts.command} accepts either ${opts.inlineFlag} or --file, not both`,
+    );
+  }
+  if (opts.inlineValue === undefined && !filePath) {
+    throw new CrmCliError(
+      `${opts.command} requires ${opts.inlineFlag} '<json-array>' or --file <path>`,
+    );
+  }
+
+  let raw: string;
+  if (filePath) {
+    const fs = await import("node:fs/promises");
+    raw = await fs.readFile(filePath, "utf-8");
+  } else {
+    raw = opts.inlineValue ?? "";
+  }
+
+  const parsed = parseJson(raw);
+  if (!Array.isArray(parsed)) {
+    throw new CrmCliError(`${opts.inlineFlag} must be a JSON array`);
+  }
+  if (parsed.length === 0) {
+    throw new CrmCliError(`${opts.inlineFlag} must include at least one item`);
+  }
+  return parsed;
+}
+
+function parseCreateManyRows(items: unknown[]): JsonRecord[] {
+  return items.map((item, index) =>
+    requireNonEmptyJsonRecord(item, `create-many item ${index + 1}`),
+  );
+}
+
+function parseUpdateManyRows(items: unknown[]): Array<{
+  id: string;
+  data: JsonRecord;
+}> {
+  return items.map((item, index) => {
+    if (!isJsonRecord(item) || typeof item.id !== "string" || !item.id) {
+      throw new CrmCliError(
+        `update-many item ${index + 1} must include a string id`,
+      );
+    }
+    return {
+      id: item.id,
+      data: requireNonEmptyJsonRecord(
+        item.data,
+        `update-many item ${index + 1} data`,
+      ),
+    };
+  });
+}
+
+function parseCellSetManyRows(items: unknown[]): Array<{
+  entryId: string;
+  field: string;
+  value: unknown;
+}> {
+  return items.map((item, index) => {
+    if (!isJsonRecord(item)) {
+      throw new CrmCliError(
+        `cells set-many item ${index + 1} must be a JSON object`,
+      );
+    }
+    if (typeof item.entryId !== "string" || !item.entryId) {
+      throw new CrmCliError(
+        `cells set-many item ${index + 1} must include a string entryId`,
+      );
+    }
+    if (typeof item.field !== "string" || !item.field) {
+      throw new CrmCliError(
+        `cells set-many item ${index + 1} must include a string field`,
+      );
+    }
+    return {
+      entryId: item.entryId,
+      field: item.field,
+      value: item.value ?? null,
+    };
+  });
+}
+
+type CrmBatchOp =
+  | { type: "entries.create"; objectName: string; data: JsonRecord }
+  | { type: "entries.update"; entryId: string; data: JsonRecord };
+
+function chunkArray<T>(items: T[], size: number): T[][] {
+  const chunks: T[][] = [];
+  for (let index = 0; index < items.length; index += size) {
+    chunks.push(items.slice(index, index + size));
+  }
+  return chunks;
+}
+
+function chunkIdempotencyKey(
+  idempotencyKey: string | undefined,
+  chunkIndex: number,
+): string | undefined {
+  return idempotencyKey
+    ? `${idempotencyKey}:chunk-${chunkIndex + 1}`
+    : undefined;
+}
+
+async function applyBatchOpsInChunks(
+  ctx: CrmCliContext,
+  ops: CrmBatchOp[],
+  idempotencyKey: string | undefined,
+): Promise<number> {
+  const chunks = chunkArray(ops, CRM_BATCH_CHUNK_SIZE);
+  for (const [chunkIndex, chunk] of chunks.entries()) {
+    const chunkKey = chunkIdempotencyKey(idempotencyKey, chunkIndex);
+    await callMutation(ctx, api.batch.apply, {
+      ops: chunk,
+      ...(chunkKey ? { idempotencyKey: chunkKey } : {}),
+    });
+  }
+  return chunks.length;
+}
+
 async function callQuery(
   ctx: CrmCliContext,
   fn: Parameters<ConvexHttpClient["query"]>[0],
@@ -139,6 +285,35 @@ function out(ctx: CrmCliContext, value: unknown): void {
   console.log(JSON.stringify(value, null, 2));
 }
 
+function getFieldEnrichmentFlag(args: string[]): {
+  category: EnrichmentCategory;
+  key: string;
+  apolloPath: string;
+  inputFieldName: string;
+} | undefined {
+  const category = parseCategoryFlag(getFlag(args, "--enrichment-category"));
+  const key = getFlag(args, "--enrichment-key");
+  const apolloPath = getFlag(args, "--apollo-path");
+  const inputFieldName = getFlag(args, "--input-field");
+  const sawAny =
+    category !== undefined ||
+    key !== undefined ||
+    apolloPath !== undefined ||
+    inputFieldName !== undefined;
+  if (!sawAny) return undefined;
+  if (!category || !apolloPath || !inputFieldName) {
+    throw new CrmCliError(
+      "Enrichment fields require --enrichment-category people|company, --apollo-path <path>, and --input-field <field>.",
+    );
+  }
+  return {
+    category,
+    key: key ?? apolloPath,
+    apolloPath,
+    inputFieldName,
+  };
+}
+
 const api = {
   transaction: {
     begin: makeFunctionReference<"mutation">("functions/crm/transaction:begin"),
@@ -380,6 +555,7 @@ async function runFieldsCommand(ctx: CrmCliContext): Promise<void> {
         : hasFlag(ctx.args, "--no-indexed")
           ? false
           : undefined;
+      const enrichment = getFieldEnrichmentFlag(ctx.args);
       assertNoUnknownFlags(ctx.args, "crm fields create");
       out(
         ctx,
@@ -395,6 +571,7 @@ async function runFieldsCommand(ctx: CrmCliContext): Promise<void> {
           relatedObjectName,
           relationshipType,
           indexed,
+          enrichment,
         }),
       );
       return;
@@ -412,6 +589,8 @@ async function runFieldsCommand(ctx: CrmCliContext): Promise<void> {
         : hasFlag(ctx.args, "--no-indexed")
           ? false
           : undefined;
+      const enrichment = getFieldEnrichmentFlag(ctx.args);
+      const clearEnrichment = hasFlag(ctx.args, "--clear-enrichment");
       assertNoUnknownFlags(ctx.args, "crm fields update");
       out(
         ctx,
@@ -422,6 +601,8 @@ async function runFieldsCommand(ctx: CrmCliContext): Promise<void> {
           required,
           enumValues,
           indexed,
+          enrichment,
+          clearEnrichment,
         }),
       );
       return;
@@ -509,6 +690,30 @@ async function runEntriesCommand(ctx: CrmCliContext): Promise<void> {
       );
       return;
     }
+    case "create-many": {
+      const objectName = shift(ctx.args, "object name");
+      const dataRaw = getDataFlag(ctx.args);
+      const idempotencyKey = getFlag(ctx.args, "--idempotency-key");
+      const rows = parseCreateManyRows(
+        await readJsonArrayInput({
+          args: ctx.args,
+          command: "crm entries create-many",
+          inlineFlag: "--data",
+          inlineValue: dataRaw,
+        }),
+      );
+      const chunks = await applyBatchOpsInChunks(
+        ctx,
+        rows.map((data) => ({
+          type: "entries.create",
+          objectName,
+          data,
+        })),
+        idempotencyKey,
+      );
+      out(ctx, { created: rows.length, chunks });
+      return;
+    }
     case "update": {
       const objectName = shift(ctx.args, "object name");
       const entryId = shift(ctx.args, "entry id");
@@ -535,6 +740,30 @@ async function runEntriesCommand(ctx: CrmCliContext): Promise<void> {
       );
       return;
     }
+    case "update-many": {
+      const _objectName = shift(ctx.args, "object name");
+      const updatesRaw = getUpdatesFlag(ctx.args);
+      const idempotencyKey = getFlag(ctx.args, "--idempotency-key");
+      const updates = parseUpdateManyRows(
+        await readJsonArrayInput({
+          args: ctx.args,
+          command: "crm entries update-many",
+          inlineFlag: "--updates",
+          inlineValue: updatesRaw,
+        }),
+      );
+      const chunks = await applyBatchOpsInChunks(
+        ctx,
+        updates.map((update) => ({
+          type: "entries.update",
+          entryId: update.id,
+          data: update.data,
+        })),
+        idempotencyKey,
+      );
+      out(ctx, { updated: updates.length, chunks });
+      return;
+    }
     case "delete":
     case "remove": {
       const _objectName = shift(ctx.args, "object name");
@@ -569,11 +798,11 @@ async function runEntriesCommand(ctx: CrmCliContext): Promise<void> {
 
 async function runCellsCommand(ctx: CrmCliContext): Promise<void> {
   const verb = ctx.args.shift();
-  const objectName = shift(ctx.args, "object name");
-  const entryId = shift(ctx.args, "entry id");
-  const fieldName = shift(ctx.args, "field name");
   switch (verb) {
     case "get": {
+      const objectName = shift(ctx.args, "object name");
+      const entryId = shift(ctx.args, "entry id");
+      const fieldName = shift(ctx.args, "field name");
       assertNoUnknownFlags(ctx.args, "crm cells get");
       out(
         ctx,
@@ -586,6 +815,9 @@ async function runCellsCommand(ctx: CrmCliContext): Promise<void> {
       return;
     }
     case "set": {
+      const objectName = shift(ctx.args, "object name");
+      const entryId = shift(ctx.args, "entry id");
+      const fieldName = shift(ctx.args, "field name");
       const value = parseJson(ctx.args.shift()) ?? null;
       assertNoUnknownFlags(ctx.args, "crm cells set");
       out(
@@ -599,7 +831,39 @@ async function runCellsCommand(ctx: CrmCliContext): Promise<void> {
       );
       return;
     }
+    case "set-many": {
+      const _objectName = shift(ctx.args, "object name");
+      const updatesRaw = getUpdatesFlag(ctx.args);
+      const idempotencyKey = getFlag(ctx.args, "--idempotency-key");
+      const updates = parseCellSetManyRows(
+        await readJsonArrayInput({
+          args: ctx.args,
+          command: "crm cells set-many",
+          inlineFlag: "--updates",
+          inlineValue: updatesRaw,
+        }),
+      );
+      const grouped = new Map<string, JsonRecord>();
+      for (const update of updates) {
+        const data = grouped.get(update.entryId) ?? {};
+        data[update.field] = update.value;
+        grouped.set(update.entryId, data);
+      }
+      const ops: CrmBatchOp[] = Array.from(grouped.entries()).map(
+        ([entryId, data]) => ({
+          type: "entries.update",
+          entryId,
+          data,
+        }),
+      );
+      const chunks = await applyBatchOpsInChunks(ctx, ops, idempotencyKey);
+      out(ctx, { updated: updates.length, entriesUpdated: ops.length, chunks });
+      return;
+    }
     case "append": {
+      const objectName = shift(ctx.args, "object name");
+      const entryId = shift(ctx.args, "entry id");
+      const fieldName = shift(ctx.args, "field name");
       const value = parseJson(ctx.args.shift()) ?? null;
       assertNoUnknownFlags(ctx.args, "crm cells append");
       out(
@@ -1431,8 +1695,9 @@ Fields (columns):
   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] \\
-        [--indexed | --no-indexed]
-  dench crm fields update <object> <field> [--description ...] [--required] [--enum-values JSON] [--indexed | --no-indexed]
+        [--indexed | --no-indexed] [--enrichment-category people|company --apollo-path <path> --input-field <field>]
+  dench crm fields update <object> <field> [--description ...] [--required] [--enum-values JSON] [--indexed | --no-indexed] \\
+        [--enrichment-category people|company --apollo-path <path> --input-field <field> | --clear-enrichment]
   dench crm fields delete <object> <field>
   dench crm fields reorder <object> <field1> <field2> <field3> ...
 
@@ -1440,7 +1705,9 @@ Entries (rows):
   dench crm entries list <object> [--limit N] [--json]
   dench crm entries get <object> <entryId>
   dench crm entries create <object> --data '{"Field":"Value",...}'    (alias: --fields)
+  dench crm entries create-many <object> --data '[{"Field":"Value",...}]' [--file rows.json] [--idempotency-key <key>]
   dench crm entries update <object> <entryId> --data '{...}'           (alias: --fields)
+  dench crm entries update-many <object> --updates '[{"id":"...","data":{...}}]' [--file updates.json] [--idempotency-key <key>]
   dench crm entries delete <object> <entryId>
   dench crm entries bulk-delete <object> --ids id1,id2,id3
   Note: --data is REQUIRED on create/update and must include >=1 field.
@@ -1450,6 +1717,7 @@ Entries (rows):
 Cells (single-field updates):
   dench crm cells get <object> <entryId> <field>
   dench crm cells set <object> <entryId> <field> '<JSON value>'
+  dench crm cells set-many <object> --updates '[{"entryId":"...","field":"Status","value":"Done"}]' [--file updates.json] [--idempotency-key <key>]
   dench crm cells append <object> <entryId> <field> '<JSON value>'
 
 Query DSL:
@@ -1467,6 +1735,9 @@ Statuses (kanban columns):
 
 Batch:
   dench crm batch --file ops.jsonl [--idempotency-key <key>]
+  For repeated writes, prefer entries create-many/update-many or cells set-many;
+  for transformations, write a script in /tmp/work/<runId>/ that loops locally
+  and calls a batch surface in chunks.
 
 Import / export:
   dench crm import <object> --csv leads.csv [--map '{"Email":"Email Address"}'] [--on-conflict skip|update|error]