busa-cli 0.10.2 → 0.10.3

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

@@ -1556,6 +1556,8 @@ import {
   cloudContract,
   createBusabaseClient,
   DEFAULT_BASE_URL as DEFAULT_BASE_URL2,
+  getRecordByField,
+  grepAssets,
   normalizeBaseUrl as normalizeBaseUrl2
 } from "busabase-sdk";
 import {
@@ -2486,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 = [
@@ -4009,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",
@@ -4753,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) {
@@ -4785,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 });
@@ -4836,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;
@@ -4986,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.`
         );
       }
     }
@@ -5003,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.`
       );
     }
   }
@@ -5913,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 = [];
@@ -5930,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);
@@ -5959,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}:`
@@ -5972,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(
@@ -6893,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,
@@ -6981,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 ? {
@@ -7043,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),
@@ -7067,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
@@ -7079,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-DGRADZF2.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-DGRADZF2.js";
+} from "./chunk-MLTXEKPL.js";
 
 // src/index.ts
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "busa-cli",
-  "version": "0.10.2",
+  "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.2",
+    "busabase-sdk": "0.10.3",
     "commander": "^14.0.0",
     "tar-stream": "^3.1.7",
     "yaml": "^2.9.0",