busa-cli 0.10.1 → 0.10.3

package/dist/{chunk-NVBCCPMO.js → chunk-MLTXEKPL.js}

@@ -234,11 +234,11 @@ var baseFieldChangeTask = {
       ...input.message ? { message: input.message } : {},
       ...input.submittedBy ? { submittedBy: input.submittedBy } : {}
     };
-    const bases = client.bases;
     switch (input.operation) {
       case "add":
-        return bases.createFieldChangeRequest({
+        return client.bases.fieldChangeRequest({
           ...common,
+          operation: "create",
           slug: input.slug,
           name: input.name,
           ...input.fieldType ? { type: input.fieldType } : {},
@@ -246,31 +246,36 @@ var baseFieldChangeTask = {
           ...input.options ? { options: input.options } : {}
         });
       case "update":
-        return bases.updateFieldChangeRequest({
+        return client.bases.fieldChangeRequest({
           ...common,
+          operation: "update",
           fieldId: input.fieldId,
           patch: input.patch
         });
       case "delete":
-        return bases.deleteFieldChangeRequest({
+        return client.bases.fieldChangeRequest({
           ...common,
+          operation: "delete",
           fieldId: input.fieldId
         });
       case "convert":
-        return bases.convertFieldChangeRequest({
+        return client.bases.fieldChangeRequest({
           ...common,
+          operation: "convert",
           fieldId: input.fieldId,
           newType: input.newType,
           ...input.selectChoiceMode ? { selectChoiceMode: input.selectChoiceMode } : {}
         });
       case "reorder":
-        return bases.reorderFieldsChangeRequest({
+        return client.bases.fieldChangeRequest({
           ...common,
+          operation: "reorder",
           fieldIds: input.fieldIds
         });
       default:
-        return bases.restoreFieldChangeRequest({
+        return client.bases.fieldChangeRequest({
           ...common,
+          operation: "restore",
           fieldId: input.fieldId
         });
     }
@@ -313,7 +318,7 @@ var changeRequestQueryTask = {
   ],
   execute: async (client, input) => {
     if (input.countsOnly) return client.changeRequests.counts();
-    return client.changeRequests.listPaged({
+    return client.changeRequests.list({
       ...input.status ? { status: input.status } : {},
       ...input.mine !== void 0 ? { mine: input.mine } : {},
       ...input.limit !== void 0 ? { limit: input.limit } : {},
@@ -403,11 +408,6 @@ var changeRequestMergeTask = {
 
 // ../../packages/busabase-contract/src/tasks/file-tree.ts
 var FILE_TREE_KINDS = ["skill", "drive", "airapp"];
-var NAMESPACE = {
-  skill: "skills",
-  drive: "drives",
-  airapp: "airapps"
-};
 var kindParam = {
   name: "kind",
   kind: "enum",
@@ -452,7 +452,7 @@ var nodeListTask = {
   annotations: { readOnly: true, destructive: false },
   params: [kindParam],
   examples: ["busabase-cli nodes list-file-trees --kind skill"],
-  execute: async (client, input) => client[NAMESPACE[resolveKind(input.kind)]].list()
+  execute: async (client, input) => client.fileTrees.list({ type: resolveKind(input.kind) })
 };
 var nodeGetTask = {
   name: "node_get_file_tree",
@@ -478,7 +478,7 @@ var nodeGetTask = {
   annotations: { readOnly: true, destructive: false },
   params: [kindParam, nodeIdParam],
   examples: ["busabase-cli nodes get-file-tree --kind airapp --node-id nod_123"],
-  execute: async (client, input) => client[NAMESPACE[resolveKind(input.kind)]].get({ nodeId: input.nodeId })
+  execute: async (client, input) => client.fileTrees.get({ nodeId: input.nodeId, type: resolveKind(input.kind) })
 };
 var nodeListFilesTask = {
   name: "node_files_list",
@@ -504,7 +504,7 @@ var nodeListFilesTask = {
   annotations: { readOnly: true, destructive: false },
   params: [kindParam, nodeIdParam],
   examples: ["busabase-cli nodes files --kind drive --node-id nod_123"],
-  execute: async (client, input) => client[NAMESPACE[resolveKind(input.kind)]].listFiles({ nodeId: input.nodeId })
+  execute: async (client, input) => client.fileTrees.listFiles({ nodeId: input.nodeId, type: resolveKind(input.kind) })
 };
 var nodeReadFileTask = {
   name: "node_file_read",
@@ -540,9 +540,10 @@ var nodeReadFileTask = {
     }
   ],
   examples: ["busabase-cli nodes read-file --kind skill --node-id nod_123 --file-path SKILL.md"],
-  execute: async (client, input) => client[NAMESPACE[resolveKind(input.kind)]].readFile({
+  execute: async (client, input) => client.fileTrees.readFile({
     nodeId: input.nodeId,
-    filePath: input.filePath
+    filePath: input.filePath,
+    type: resolveKind(input.kind)
   })
 };
 var nodeFilesChangeRequestTask = {
@@ -593,11 +594,12 @@ var nodeFilesChangeRequestTask = {
     }
     const payload = {
       nodeId: input.nodeId,
+      type: resolveKind(input.kind),
       operations: input.operations,
       ...input.message ? { message: input.message } : {},
       ...input.submittedBy ? { submittedBy: input.submittedBy } : {}
     };
-    return client[NAMESPACE[resolveKind(input.kind)]].createChangeRequest(payload);
+    return client.fileTrees.createChangeRequest(payload);
   }
 };
 
@@ -655,15 +657,18 @@ var listArchivedTask = {
     "busabase-cli archived list --scope records --base-id bas_1 --limit 100"
   ],
   execute: async (client, input) => {
-    if (input.scope === "nodes") return client.nodes.listArchived();
-    if (input.scope === "bases") return client.bases.listArchived();
+    if (input.scope === "nodes") return client.nodes.list({ status: "archived" });
+    if (input.scope === "bases") return client.bases.list({ status: "archived" });
     if (!input.baseId) {
       throw new Error(`scope "${input.scope}" requires baseId.`);
     }
     if (input.scope === "fields") return client.bases.listDeletedFields({ baseId: input.baseId });
-    if (input.scope === "views") return client.bases.listArchivedViews({ baseId: input.baseId });
-    return client.bases.listArchivedRecordsPaged({
+    if (input.scope === "views") {
+      return client.bases.listViews({ baseId: input.baseId, status: "archived" });
+    }
+    return client.records.list({
       baseId: input.baseId,
+      status: "archived",
       ...input.limit !== void 0 ? { limit: input.limit } : {},
       ...input.cursor ? { cursor: input.cursor } : {}
     });
@@ -1237,14 +1242,15 @@ var nodeCreateTask = {
     if (FILE_TREE_TYPES.has(type)) {
       const payload = {
         ...common,
+        // `type` is the contract's discriminator, so the narrowing has to be
+        // explicit — `FILE_TREE_TYPES.has` doesn't narrow a plain string.
+        type,
         ...Array.isArray(input.files) ? { files: input.files } : {},
         ...input.mergeMode ? { mergeMode: input.mergeMode } : {},
         ...input.visibility ? { visibility: input.visibility } : {},
         ...input.version ? { version: input.version } : {}
       };
-      if (type === "skill") return client.skills.create(payload);
-      if (type === "drive") return client.drives.create(payload);
-      return client.airapps.create(payload);
+      return client.fileTrees.create(payload);
     }
     if (type === "doc") {
       const payload = { ...common, body: input.body ?? "" };
@@ -1321,20 +1327,20 @@ var recordChangeTask = {
       if (!input.fields || typeof input.fields !== "object") {
         throw new Error('operation "update" requires `fields` (an object keyed by field slug).');
       }
-      return client.records.updateChangeRequest({
+      return client.records.changeRequest({
         ...common,
+        operation: "update",
         fields: input.fields
       });
     }
     if (input.operation === "delete") {
-      return client.records.deleteChangeRequest({
+      return client.records.changeRequest({
         ...common,
+        operation: "delete",
         deleteMode: "archive"
       });
     }
-    return client.records.restoreChangeRequest(
-      common
-    );
+    return client.records.changeRequest({ ...common, operation: "restore" });
   }
 };
 
@@ -1415,7 +1421,7 @@ var recordQueryTask = {
         input.baseId ? { baseId: input.baseId } : {}
       );
     }
-    return client.records.listPaged({
+    return client.records.list({
       ...input.limit !== void 0 ? { limit: input.limit } : {},
       ...input.baseId ? { baseId: input.baseId } : {},
       ...input.cursor ? { cursor: input.cursor } : {},
@@ -1493,7 +1499,8 @@ var viewChangeTask = {
       if (!input.baseId || !input.name) {
         throw new Error('action "create" requires baseId and name.');
       }
-      return client.bases.createViewChangeRequest({
+      return client.views.changeRequest({
+        operation: "create",
         baseId: input.baseId,
         name: input.name,
         ...input.type ? { type: input.type } : {},
@@ -1505,19 +1512,16 @@ var viewChangeTask = {
     const target = { viewId: input.viewId, ...meta };
     if (input.action === "update") {
       if (!input.patch) throw new Error('action "update" requires patch.');
-      return client.views.updateChangeRequest({
+      return client.views.changeRequest({
+        operation: "update",
         ...target,
         ...input.patch
       });
     }
     if (input.action === "delete") {
-      return client.views.deleteChangeRequest(
-        target
-      );
+      return client.views.changeRequest({ operation: "delete", ...target });
     }
-    return client.views.restoreChangeRequest(
-      target
-    );
+    return client.views.changeRequest({ operation: "restore", ...target });
   }
 };
 
@@ -1552,6 +1556,8 @@ import {
   cloudContract,
   createBusabaseClient,
   DEFAULT_BASE_URL as DEFAULT_BASE_URL2,
+  getRecordByField,
+  grepAssets,
   normalizeBaseUrl as normalizeBaseUrl2
 } from "busabase-sdk";
 import {
@@ -2482,15 +2488,15 @@ var reportProgress = (message) => {
 };
 var STATE_ONLY_BACKUP_MESSAGE = [
   "--state-only backup is not implemented, and will not be \u2014 it is superseded by",
-  "`busabase-cli publish`, which writes the same state-level content as a readable,",
+  "`busabase-cli export`, which writes the same state-level content as a readable,",
   "diffable directory you can push to GitHub:",
   "",
-  "  busabase-cli publish <node-slug> -o ./my-package",
+  "  busabase-cli export <node-slug> -o ./my-package",
   "  busabase-cli install https://github.com/<you>/<repo>",
   "",
   "`busabase-cli backup` stays the full-fidelity backup path (raw rows, original ids,",
   "history) \u2014 run it without --state-only. The two formats are deliberately separate:",
-  "a backup carries the audit events, comments, reviews and ACLs that a published",
+  "a backup carries the audit events, comments, reviews and ACLs that an exported",
   "package must never leak."
 ].join("\n");
 var STATE_ONLY_RESTORE_MESSAGE = [
@@ -3393,6 +3399,15 @@ var restoreFieldChangeRequestInputSchema = z6.object({
   message: z6.string().optional(),
   submittedBy: z6.string().optional().default("local-editor")
 });
+var withBaseId = { baseId: z6.string().min(1) };
+var fieldChangeRequestInputSchema = z6.discriminatedUnion("operation", [
+  createFieldChangeRequestInputSchema.extend({ operation: z6.literal("create"), ...withBaseId }),
+  updateFieldChangeRequestInputSchema.extend({ operation: z6.literal("update"), ...withBaseId }),
+  deleteFieldChangeRequestInputSchema.extend({ operation: z6.literal("delete"), ...withBaseId }),
+  convertFieldChangeRequestInputSchema.extend({ operation: z6.literal("convert"), ...withBaseId }),
+  reorderFieldsChangeRequestInputSchema.extend({ operation: z6.literal("reorder"), ...withBaseId }),
+  restoreFieldChangeRequestInputSchema.extend({ operation: z6.literal("restore"), ...withBaseId })
+]);
 
 // ../../packages/busabase-contract/src/domains/base/contract/view-schemas.ts
 import { z as z8 } from "zod";
@@ -3444,7 +3459,13 @@ var listNodesInputSchema = z7.object({
   parentId: z7.string().nullable().optional().describe("Node to start from. Omit or null to start from the space root."),
   depth: z7.coerce.number().int().min(1).max(5).optional().describe(
     "How many levels beneath the start point to eagerly include (default 2 once either field is set). Capped at 5."
-  )
+  ),
+  /**
+   * `active` (default) walks the live tree. `archived` returns the flat set of
+   * soft-archived nodes for the Trash view — no `parentId`/`depth` walk, since
+   * archived nodes are shown as a list, not a tree.
+   */
+  status: z7.enum(["active", "archived"]).optional().default("active")
 }).optional();
 var isDescendantInputSchema = z7.object({
   nodeId: z7.string(),
@@ -3773,6 +3794,9 @@ var createCommentInputSchema = commentSubjectInputSchema.extend({
 var listInputSchema = z7.object({
   limit: z7.coerce.number().int().min(1).max(100).optional().default(50)
 }).optional().default({ limit: 50 });
+var listByStatusInputSchema = z7.object({
+  status: z7.enum(["active", "archived"]).optional().default("active")
+});
 var listChangeRequestsPagedInputSchema = z7.object({
   limit: z7.coerce.number().int().min(1).max(100).optional().default(50),
   /** Opaque base64 cursor (`createdAt|id`) for keyset pagination. */
@@ -3949,6 +3973,24 @@ var restoreViewInputSchema = z8.object({
   message: z8.string().optional().default("Restore view"),
   submittedBy: z8.string().optional().default("local-producer")
 });
+var viewChangeRequestInputSchema = z8.discriminatedUnion("operation", [
+  createViewInputSchema.extend({
+    operation: z8.literal("create"),
+    baseId: z8.string().min(1).describe("Base the new view belongs to.")
+  }),
+  updateViewInputSchema.extend({
+    operation: z8.literal("update"),
+    viewId: z8.string().min(1)
+  }),
+  deleteViewInputSchema.extend({
+    operation: z8.literal("delete"),
+    viewId: z8.string().min(1)
+  }),
+  restoreViewInputSchema.extend({
+    operation: z8.literal("restore"),
+    viewId: z8.string().min(1)
+  })
+]);
 
 // ../../packages/busabase-contract/src/domains/package/types.ts
 var PACKAGE_FORMAT = "busabase-package@1";
@@ -3969,7 +4011,7 @@ var PACKAGE_COMPUTED_FIELD_TYPES = [
   "auto_number",
   "formula",
   // `lookup` is derived from OTHER records and resolved at read time, so it
-  // shows up in `headCommit.fields` like any other value — but publishing it
+  // shows up in `headCommit.fields` like any other value — but exporting it
   // would ship derived data as if it were authored, and install would strip it
   // server-side anyway.
   "lookup",
@@ -4292,7 +4334,8 @@ var applyInstall = async (client, plan, options) => {
       }
       const patched = resolveFieldIdOptions(field, base.node.slug, fieldIds, state.warnings);
       if (!patched) continue;
-      const changeRequest = await client.bases.updateFieldChangeRequest({
+      const changeRequest = await client.bases.fieldChangeRequest({
+        operation: "update",
         baseId: base.baseId,
         fieldId,
         patch: { options: patched },
@@ -4443,7 +4486,8 @@ var createBase = async (client, node, parentNodeId, options, state, bases, field
   bases.push({ node, baseId: result.id });
   indexFields(fieldIds, node.slug, result.fields);
   for (const view of node.base.views) {
-    const changeRequest = await client.bases.createViewChangeRequest({
+    const changeRequest = await client.views.changeRequest({
+      operation: "create",
       baseId: result.id,
       slug: view.slug,
       name: view.name,
@@ -4477,8 +4521,8 @@ var createFileTreeNode = async (client, node, parentNodeId, options, state) => {
     })
   );
   const files = uploaded.filter((entry) => entry !== void 0);
-  const api = node.type === "skill" ? client.skills : node.type === "airapp" ? client.airapps : client.drives;
-  const result = await api.create({
+  const result = await client.fileTrees.create({
+    type: node.type,
     parentNodeId,
     slug: node.slug,
     name: node.name,
@@ -4653,7 +4697,8 @@ var linkRelations = async (client, base, relationFieldSlugs, recordIdsByKey, opt
     if (!hasRelation) continue;
     const recordId = recordIdsByKey.get(record.key);
     if (!recordId) continue;
-    const changeRequest = await client.records.updateChangeRequest({
+    const changeRequest = await client.records.changeRequest({
+      operation: "update",
       recordId,
       fields: { ...toCreatableFields(base.node, record.fields), ...relationValues },
       message: `Link relations for ${base.node.slug}`,
@@ -4710,7 +4755,7 @@ var collectNode = async (client, source, options) => {
     slug: source.slug,
     name: source.name,
     description: source.description ?? "",
-    // `publish` always writes position, so round trips preserve sibling order exactly.
+    // `export` always writes position, so round trips preserve sibling order exactly.
     position: source.position
   };
   switch (source.type) {
@@ -4729,7 +4774,7 @@ var collectNode = async (client, source, options) => {
     case "skill":
     case "airapp":
     case "drive":
-      return collectFileTree(client, source, common, options);
+      return collectFileTree(client, source, source.type, common, options);
     case "file":
       return collectFile(client, source, common, options);
     default:
@@ -4742,7 +4787,7 @@ var collectBase = async (client, source, common, options) => {
   const base = await client.bases.get({ baseId });
   if (!base) {
     throw new Error(
-      `Base node "${source.slug}" has no Base behind it (looked up ${baseId}). The space may be mid-migration; re-run publish.`
+      `Base node "${source.slug}" has no Base behind it (looked up ${baseId}). The space may be mid-migration; re-run export.`
     );
   }
   const views = await client.bases.listViews({ baseId: base.id });
@@ -4771,7 +4816,7 @@ var collectBase = async (client, source, common, options) => {
   };
 };
 var buildIndexes = async (client) => {
-  const bases = await client.bases.list();
+  const bases = await client.bases.list({});
   const baseSlugById = /* @__PURE__ */ new Map();
   const fieldSlugById = /* @__PURE__ */ new Map();
   for (const base of bases) {
@@ -4793,7 +4838,7 @@ var toPackageField = (field, context) => {
     const targetSlug = context.baseSlugById.get(targetBaseId);
     if (!targetSlug) {
       throw new Error(
-        `Field "${context.baseSlug}.${field.slug}" relates to a Base that no longer exists (${targetBaseId}). Fix the field before publishing.`
+        `Field "${context.baseSlug}.${field.slug}" relates to a Base that no longer exists (${targetBaseId}). Fix the field before exporting.`
       );
     }
     options.targetBaseSlug = targetSlug;
@@ -4858,7 +4903,7 @@ var collectRecords = async (client, baseId, fields, options) => {
   let droppedAttachments = 0;
   let cursor;
   do {
-    const page = await client.records.listPaged({ baseId, limit: 100, cursor });
+    const page = await client.records.list({ baseId, limit: 100, cursor });
     for (const record of page.records) {
       if (record.status !== "active") continue;
       const values = {};
@@ -4884,12 +4929,15 @@ var collectRecords = async (client, baseId, fields, options) => {
   }
   return records.sort((a, b) => a.key.localeCompare(b.key, "en"));
 };
-var collectFileTree = async (client, source, common, options) => {
-  const api = source.type === "skill" ? client.skills : source.type === "airapp" ? client.airapps : client.drives;
-  const listed = await api.listFiles({ nodeId: source.id });
+var collectFileTree = async (client, source, type, common, options) => {
+  const listed = await client.fileTrees.listFiles({ nodeId: source.id, type });
   const files = [];
   for (const file of listed) {
-    const read = await api.readFile({ nodeId: source.id, filePath: file.path });
+    const read = await client.fileTrees.readFile({
+      nodeId: source.id,
+      filePath: file.path,
+      type
+    });
     files.push({
       path: file.path,
       bytes: read.encoding === "url" ? await downloadBytes(read.content, file.path, options) : Buffer.from(read.content, "utf8")
@@ -4940,7 +4988,7 @@ var assertSelfContained = (tree, options) => {
       if (field.type !== "relation" || !targetBaseSlug) continue;
       if (!packagedBaseSlugs.has(targetBaseSlug)) {
         throw new Error(
-          `Field "${node.slug}.${field.slug}" relates to Base "${targetBaseSlug}", which is outside the subtree being published. A package must be self-contained \u2014 publish a subtree that includes both Bases, or remove the field.`
+          `Field "${node.slug}.${field.slug}" relates to Base "${targetBaseSlug}", which is outside the subtree being exported. A package must be self-contained \u2014 export a subtree that includes both Bases, or remove the field.`
         );
       }
     }
@@ -4957,7 +5005,7 @@ var assertSelfContained = (tree, options) => {
     }
     if (dangling > 0) {
       options.warn(
-        `Base "${node.slug}" has ${dangling} relation value(s) pointing at records outside the published subtree \u2014 they were dropped.`
+        `Base "${node.slug}" has ${dangling} relation value(s) pointing at records outside the exported subtree \u2014 they were dropped.`
       );
     }
   }
@@ -5588,7 +5636,7 @@ var findTargetFolder = (nodes, slug) => {
   return roots.find((node) => node.slug === slug && node.type === "folder");
 };
 var resolveTargetState = async (client, targetFolderSlug) => {
-  const [nodes, bases] = await Promise.all([client.nodes.list(), client.bases.list()]);
+  const [nodes, bases] = await Promise.all([client.nodes.list({}), client.bases.list({})]);
   return {
     targetFolder: findTargetFolder(nodes, targetFolderSlug),
     existingBaseSlugs: new Set(bases.map((base) => base.slug))
@@ -5867,7 +5915,7 @@ var renderInstallReport = (targetFolderSlug, result) => {
   }
   return lines.join("\n");
 };
-var runPublish = async (client, nodeSlugOrId, options) => {
+var runExport = async (client, nodeSlugOrId, options) => {
   const nodes = await client.nodes.list();
   const source = findSourceNode(nodes, nodeSlugOrId);
   const warnings = [];
@@ -5884,14 +5932,14 @@ var runPublish = async (client, nodeSlugOrId, options) => {
   }
   if (options.json) {
     return {
-      published: !options.dryRun,
+      exported: !options.dryRun,
       package: manifest.name,
       outDir: options.outDir,
       files: [...files.keys()].sort(),
       warnings
     };
   }
-  return renderPublishReport(options, manifest, files, warnings);
+  return renderExportReport(options, manifest, files, warnings);
 };
 var resolveManifest = async (outDir, nameFlag, nodeName, nodeSlug) => {
   const existing = await readExistingManifest(outDir);
@@ -5913,7 +5961,7 @@ var readExistingManifest = async (outDir) => {
     return void 0;
   }
 };
-var renderPublishReport = (options, manifest, files, warnings) => {
+var renderExportReport = (options, manifest, files, warnings) => {
   const lines = [];
   lines.push(
     options.dryRun ? `Dry run \u2014 would write ${files.size} file(s) to ${options.outDir}:` : `Wrote ${files.size} file(s) to ${options.outDir}:`
@@ -5926,7 +5974,7 @@ var renderPublishReport = (options, manifest, files, warnings) => {
   }
   if (!options.dryRun) {
     lines.push("");
-    lines.push("Now publish it to GitHub:");
+    lines.push("Now push it to GitHub:");
     lines.push(`  cd ${options.outDir}`);
     lines.push(
       '  git init && git add . && git commit -m "Add ${name} package"'.replace(
@@ -6381,10 +6429,17 @@ function classifyKind(inner) {
 function inputFields(inputSchema) {
   if (inputSchema === void 0) return [];
   const { inner } = unwrapSchema(inputSchema);
-  const shape = inner?.shape ?? (inner?.def?.type === "object" ? inner.def.shape : void 0);
-  if (!shape || typeof shape !== "object") {
+  const shape = objectShape(inner);
+  if (!shape) {
     return [{ key: "input", kind: "json", required: true, root: true }];
   }
+  return fieldsFromShape(shape);
+}
+function objectShape(inner) {
+  const shape = inner?.shape ?? (inner?.def?.type === "object" ? inner.def.shape : void 0);
+  return shape && typeof shape === "object" ? shape : void 0;
+}
+function fieldsFromShape(shape) {
   const fields = [];
   for (const [key, sub] of Object.entries(shape)) {
     const { inner: unwrapped, optional } = unwrapSchema(sub);
@@ -6393,6 +6448,34 @@ function inputFields(inputSchema) {
   }
   return fields;
 }
+function unionVariants(inputSchema, discriminator = "operation") {
+  if (inputSchema === void 0) return null;
+  const { inner } = unwrapSchema(inputSchema);
+  let unionNode = inner;
+  let extraShape = {};
+  if (inner?.def?.type === "intersection") {
+    for (const side of [inner.def.left, inner.def.right]) {
+      const { inner: sideInner } = unwrapSchema(side);
+      const shape = objectShape(sideInner);
+      if (shape) extraShape = { ...extraShape, ...shape };
+      else unionNode = sideInner;
+    }
+  }
+  const options = unionNode?.def?.options ?? unionNode?.options;
+  if (!Array.isArray(options) || options.length === 0) return null;
+  const variants = [];
+  for (const option of options) {
+    const { inner: optionInner } = unwrapSchema(option);
+    const shape = objectShape(optionInner);
+    if (!shape) return null;
+    const { inner: discInner } = unwrapSchema(shape[discriminator]);
+    const value = discInner?.def?.values?.[0] ?? discInner?.def?.value;
+    if (typeof value !== "string") return null;
+    const { [discriminator]: _pinned, ...rest } = shape;
+    variants.push({ value, fields: fieldsFromShape({ ...rest, ...extraShape }) });
+  }
+  return variants;
+}
 var GENERATED_SKIP = /* @__PURE__ */ new Set([
   "search",
   // top-level `search`
@@ -6402,18 +6485,48 @@ var GENERATED_SKIP = /* @__PURE__ */ new Set([
   // `records by-field-text`
   "records.listChangeRequests",
   // `records change-requests`
-  "airapps.listFiles"
-  // `airapps files`
+  // The `/file-trees` group is exposed by the task layer as `nodes
+  // list-file-trees` / `get-file-tree` / `files` / `read-file` /
+  // `files-change-request`, each taking `--kind` (see tasks/file-tree.ts).
+  "fileTrees.list",
+  "fileTrees.create",
+  "fileTrees.get",
+  "fileTrees.listFiles",
+  "fileTrees.readFile",
+  "fileTrees.createChangeRequest"
 ]);
 function registerGeneratedCommands(program, state) {
   const getGroup = (displayName, tag) => program.commands.find((c2) => c2.name() === displayName) ?? program.command(displayName).description(tag ?? `${displayName} endpoints`);
   const addLeaf = (parent, navPath, procKey, proc) => {
     const { route, inputSchema } = proc["~orpc"];
-    const name = [...navPath.slice(1), procKey].map(kebab).join("-");
+    const baseName = [...navPath.slice(1), procKey].map(kebab).join("-");
+    const variants = unionVariants(inputSchema);
+    if (variants) {
+      for (const variant of variants) {
+        addOneLeaf(
+          parent,
+          navPath,
+          procKey,
+          proc,
+          `${kebab(variant.value)}-${baseName}`,
+          [
+            { key: "operation", kind: "string", required: true, pinned: variant.value },
+            ...variant.fields
+          ],
+          // The shared summary describes the merged endpoint; say which branch this is.
+          `${route.summary ?? baseName} \u2014 operation "${variant.value}"`
+        );
+      }
+      return;
+    }
+    addOneLeaf(parent, navPath, procKey, proc, baseName, inputFields(inputSchema));
+  };
+  const addOneLeaf = (parent, navPath, procKey, proc, name, fields, description) => {
+    const { route } = proc["~orpc"];
     if (parent.commands.some((c2) => c2.name() === name || c2.aliases().includes(name))) return;
-    const fields = inputFields(inputSchema);
-    const leaf = parent.command(name).description(route.summary ?? `${route.method} ${route.path}`);
+    const leaf = parent.command(name).description(description ?? route.summary ?? `${route.method} ${route.path}`);
     for (const f of fields) {
+      if (f.pinned !== void 0) continue;
       const flag = `--${kebab(f.key)}`;
       if (GLOBAL_LONG_FLAGS.has(flag)) continue;
       if (f.kind === "boolean") {
@@ -6446,6 +6559,10 @@ OpenAPI: ${route.method} ${route.path}`);
       runAction(state, (client, opts) => {
         let input = {};
         for (const f of fields) {
+          if (f.pinned !== void 0) {
+            input[f.key] = f.pinned;
+            continue;
+          }
           if (GLOBAL_LONG_FLAGS.has(`--${kebab(f.key)}`)) continue;
           const optKey = f.kind === "json" ? `${f.key}Json` : f.key;
           const value = opts[optKey];
@@ -6677,11 +6794,21 @@ Examples:
     )
   );
   const bases = program.command("bases").description("Bases (structured tables)");
-  addGlobalFlags(bases.command("list")).description("List Bases in the active space").action(runAction(state, (client) => client.bases.list()));
+  addGlobalFlags(bases.command("list")).description("List Bases in the active space").addOption(
+    new Option2("--status <active|archived>", "live Bases (default) or archived ones").choices([
+      "active",
+      "archived"
+    ])
+  ).action(
+    runAction(
+      state,
+      (client, opts) => client.bases.list({ status: opts.status ?? "active" })
+    )
+  );
   addGlobalFlags(bases.command("get")).description("Get one Base by slug").requiredOption("--slug <slug>", "Base slug").action(
     runAction(state, async (client, opts) => {
       const slug = opts.slug;
-      const found = (await client.bases.list()).find((base) => base.slug === slug);
+      const found = (await client.bases.list({})).find((base) => base.slug === slug);
       if (!found) throw new Error(`no Base with slug "${slug}"`);
       return found;
     })
@@ -6728,7 +6855,8 @@ Examples:
           "No field patch supplied. Pass --name, --required, --options-json, or attachment option flags."
         );
       }
-      return client.bases.updateFieldChangeRequest({
+      return client.bases.fieldChangeRequest({
+        operation: "update",
         baseId: opts.baseId,
         fieldId: opts.fieldId,
         patch,
@@ -6767,6 +6895,16 @@ Examples:
   addGlobalFlags(records.command("get")).description("Get one record").requiredOption("--record-id <id>", "record id").action(
     runAction(state, (client, opts) => client.records.get({ recordId: opts.recordId }))
   );
+  addGlobalFlags(records.command("get-by-field")).description("Get one record by an exact field value").requiredOption("--base-id <id>", "Base id").requiredOption("--field-slug <slug>", "field slug").requiredOption("--value-text <value>", "exact field value").action(
+    runAction(
+      state,
+      (client, opts) => getRecordByField(client, {
+        baseId: opts.baseId,
+        fieldSlug: opts.fieldSlug,
+        valueText: opts.valueText
+      })
+    )
+  );
   addGlobalFlags(records.command("change-requests")).description("Change Requests for a record").requiredOption("--record-id <id>", "record id").action(
     runAction(
       state,
@@ -6855,7 +6993,7 @@ Examples:
   addGlobalFlags(assetsCommand.command("grep")).description("Search every text-bearing asset in scope").requiredOption("--pattern <regex>", "literal or regex pattern").option("--flags <flags>", 'RegExp flags, e.g. "i" for case-insensitive').option("--asset-ids <ids...>", "scope: specific asset ids").option("--drive-path <path>", "scope: Drive/Skill mounted path prefix").option("--mime-types <types...>", "scope: MIME types").option("--max-matches <n>", "max matches (default 100, cap 1000)", parsePositiveInt).option("--context-lines <n>", "lines of before/after context (default 0, cap 10)", parseNum).action(
     runAction(
       state,
-      (client, opts) => client.assets.grep({
+      (client, opts) => grepAssets(client, {
         pattern: opts.pattern,
         flags: opts.flags,
         scope: opts.assetIds || opts.drivePath || opts.mimeTypes ? {
@@ -6917,19 +7055,19 @@ field with nothing linked yet does not trigger this.`
       })
     )
   );
-  addGlobalFlags(program.command("publish")).description("Export a node subtree as a Busabase package directory you can push to GitHub").argument("<node-slug-or-id>", "the folder/node to publish").requiredOption("-o, --out-dir <dir>", "output directory for the package").option("--name <name>", "package name (default: reuse busabase.json, else the node slug)").option("--dry-run", "list the files that would be written and write nothing").addHelpText(
+  addGlobalFlags(program.command("export")).description("Export a node subtree as a Busabase package directory you can push to GitHub").argument("<node-slug-or-id>", "the folder/node to export").requiredOption("-o, --out-dir <dir>", "output directory for the package").option("--name <name>", "package name (default: reuse busabase.json, else the node slug)").option("--dry-run", "list the files that would be written and write nothing").addHelpText(
     "after",
     `
-Output is deterministic: publishing twice from an unchanged space produces
+Output is deterministic: exporting twice from an unchanged space produces
 byte-identical files, so a GitHub diff shows exactly what changed.
 
 Examples:
-  busabase-cli publish support-kb -o ./support-kb-template
-  busabase-cli publish support-kb -o ./support-kb-template --name "Support KB" --dry-run`
+  busabase-cli export support-kb -o ./support-kb-template
+  busabase-cli export support-kb -o ./support-kb-template --name "Support KB" --dry-run`
   ).action(
     runArgAction(
       state,
-      (nodeSlugOrId, client, opts, config) => runPublish(client, nodeSlugOrId, {
+      (nodeSlugOrId, client, opts, config) => runExport(client, nodeSlugOrId, {
         outDir: opts.outDir,
         name: opts.name,
         dryRun: Boolean(opts.dryRun),
@@ -6941,7 +7079,7 @@ Examples:
   addGlobalFlags(program.command("backup")).description("Back up the active space to a full-fidelity .bbdump archive").option("-o, --out-file <file>", "output archive path", "space.bbdump").option(
     "--no-history",
     "full-fidelity rows, but omit the history tables (commits, change requests, operations, comments, reviews, audit events)"
-  ).option("--state-only", "superseded by `busabase-cli publish` \u2014 see the error text").addHelpText(
+  ).option("--state-only", "superseded by `busabase-cli export` \u2014 see the error text").addHelpText(
     "after",
     `
 A backup is full fidelity: raw rows with their original ids, every doc body, and
@@ -6953,7 +7091,7 @@ Examples:
   busabase-cli backup -o ./backups/acme-2026-07-19.bbdump
   busabase-cli backup --no-history                           # smaller: current state only
 
-To hand content to someone else rather than back it up, use \`busabase-cli publish\`,
+To hand content to someone else rather than back it up, use \`busabase-cli export\`,
 which writes a readable, diffable package directory you can push to GitHub.`
   ).action(
     runAction(

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runCli
-} from "./chunk-NVBCCPMO.js";
+} from "./chunk-MLTXEKPL.js";
 
 // src/cli.ts
 process.exit(await runCli(process.argv.slice(2)));

package/dist/index.js

@@ -2,7 +2,7 @@ import {
   HELP,
   render,
   runCli
-} from "./chunk-NVBCCPMO.js";
+} from "./chunk-MLTXEKPL.js";
 
 // src/index.ts
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "busa-cli",
-  "version": "0.10.1",
+  "version": "0.10.3",
   "description": "Command-line client for the Busabase OpenAPI REST API. Talks to a local or remote `busabase server`. Short-name alias for busabase-cli.",
   "license": "MIT",
   "homepage": "https://github.com/busabase/busabase/tree/main/apps/busabase-cli",
@@ -33,7 +33,7 @@
   "dependencies": {
     "@zip.js/zip.js": "^2.8.20",
     "busabase-package": "workspace:*",
-    "busabase-sdk": "0.10.1",
+    "busabase-sdk": "0.10.3",
     "commander": "^14.0.0",
     "tar-stream": "^3.1.7",
     "yaml": "^2.9.0",