busa-cli 0.9.3 → 0.9.5

package/dist/{chunk-C5BGRNMU.js → chunk-N6NMNVQT.js}

@@ -792,6 +792,34 @@ async function uploadAsset(config, opts) {
     size: file.byteLength
   };
 }
+var INLINE_TEXT_MAX_BYTES = 1024 * 1024;
+async function putTextCommand(client, opts) {
+  const assetId = opts.assetId;
+  const text = opts.file ? readFileSync2(opts.file, "utf8") : opts.text;
+  if (opts.none) {
+    return client.assets.putText({ assetId, none: true });
+  }
+  if (text === void 0) {
+    throw new Error("Provide --text <string>, --file <path>, or --none.");
+  }
+  const sizeBytes = Buffer.byteLength(text, "utf8");
+  if (sizeBytes <= INLINE_TEXT_MAX_BYTES) {
+    return client.assets.putText({ assetId, text });
+  }
+  const upload = await client.assets.createTextUploadUrl({ assetId, sizeBytes });
+  const uploadResponse = await fetch(upload.uploadUrl, {
+    method: "PUT",
+    headers: { "content-type": "text/plain; charset=utf-8" },
+    body: text
+  });
+  if (!uploadResponse.ok) {
+    const body = await uploadResponse.text();
+    throw new Error(
+      `Text byte upload failed (${uploadResponse.status} ${uploadResponse.statusText})${body ? `: ${body}` : ""}`
+    );
+  }
+  return client.assets.putText({ assetId, storageKey: upload.storageKey });
+}
 function runAction(state, handler) {
   return async (_opts, cmd) => {
     const opts = cmd.optsWithGlobals();
@@ -840,9 +868,12 @@ function classifyKind(inner) {
   return { kind: "json" };
 }
 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") return [];
+  if (!shape || typeof shape !== "object") {
+    return [{ key: "input", kind: "json", required: true, root: true }];
+  }
   const fields = [];
   for (const [key, sub] of Object.entries(shape)) {
     const { inner: unwrapped, optional } = unwrapSchema(sub);
@@ -900,13 +931,15 @@ function registerGeneratedCommands(program, state) {
 OpenAPI: ${route.method} ${route.path}`);
     leaf.action(
       runAction(state, (client, opts) => {
-        const input = {};
+        let input = {};
         for (const f of fields) {
           if (GLOBAL_LONG_FLAGS.has(`--${kebab(f.key)}`)) continue;
           const optKey = f.kind === "json" ? `${f.key}Json` : f.key;
           const value = opts[optKey];
           if (value === void 0) continue;
-          input[f.key] = f.kind === "json" ? parseJsonValue(value, `${kebab(f.key)}-json`) : value;
+          const parsed = f.kind === "json" ? parseJsonValue(value, `${kebab(f.key)}-json`) : value;
+          if (f.root) input = parsed;
+          else input[f.key] = parsed;
         }
         let target = client;
         for (const segment of navPath) target = target[segment];
@@ -1056,6 +1089,28 @@ Examples:
       });
     })
   );
+  addGlobalFlags(nodes.command("move")).description("Move or reorder a node (applied immediately, no review needed)").requiredOption("--node-id <id>", "node id to move").option("--parent-node-id <id>", "new parent folder node id; omit to keep the current parent").option(
+    "--position <n>",
+    "new position among the target parent's children",
+    (v) => Number.parseInt(v, 10)
+  ).option("--message <text>", "Change Request message").option("--submitted-by <name>", "producer label").addHelpText(
+    "after",
+    `
+Examples:
+  busabase-cli nodes move --node-id nod_123 --position 0
+  busabase-cli nodes move --node-id nod_123 --parent-node-id nod_456 --position 2`
+  ).action(
+    runAction(
+      state,
+      (client, opts) => client.nodes.move({
+        nodeId: opts.nodeId,
+        parentNodeId: opts.parentNodeId,
+        position: opts.position,
+        message: opts.message,
+        submittedBy: opts.submittedBy
+      })
+    )
+  );
   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("get")).description("Get one Base by slug").requiredOption("--slug <slug>", "Base slug").action(
@@ -1066,12 +1121,16 @@ Examples:
       return found;
     })
   );
-  addGlobalFlags(bases.command("create")).description("Create a Base").requiredOption("--slug <slug>", "Base slug").requiredOption("--name <name>", "Base name").option("--field <slug:name:type...>", "field definition, repeatable").option("--fields-json <json|@file>", "field definitions as JSON array").option("--description <text>", "optional description").option("--parent-node-id <id>", "parent folder node id; omit for root").addHelpText(
+  addGlobalFlags(bases.command("create")).description("Create a Base \u2014 review-first by default: returns a pending Change Request").requiredOption("--slug <slug>", "Base slug").requiredOption("--name <name>", "Base name").option("--field <slug:name:type...>", "field definition, repeatable").option("--fields-json <json|@file>", "field definitions as JSON array").option("--description <text>", "optional description").option("--parent-node-id <id>", "parent folder node id; omit for root").option(
+    "--auto-merge",
+    "skip review and create the Base immediately (default: propose a pending Change Request)"
+  ).addHelpText(
     "after",
     `
 Examples:
   busabase-cli bases create --slug products --name "\u4EA7\u54C1\u76EE\u5F55 Products" --field product_name:"Product Name":text
-  busabase-cli bases create --slug products --name "\u4EA7\u54C1\u76EE\u5F55 Products" --fields-json @fields.json`
+  busabase-cli bases create --slug products --name "\u4EA7\u54C1\u76EE\u5F55 Products" --fields-json @fields.json
+  busabase-cli bases create --slug products --name "Products" --auto-merge   # skip review, create immediately`
   ).action(
     runAction(
       state,
@@ -1080,7 +1139,8 @@ Examples:
         name: opts.name,
         description: opts.description,
         parentNodeId: opts.parentNodeId,
-        fields: parseFieldDefinitions(opts)
+        fields: parseFieldDefinitions(opts),
+        ...opts.autoMerge ? { autoMerge: true } : {}
       })
     )
   );
@@ -1233,6 +1293,37 @@ Examples:
       })
     )
   );
+  addGlobalFlags(program.command("grep")).description(
+    "Search files, Docs, and Base records with one pattern (unified grep; use `assets grep` for files-only)"
+  ).requiredOption("--pattern <regex>", "literal or regex pattern").option("--flags <flags>", 'RegExp flags, e.g. "i" for case-insensitive').option(
+    "--sources <sources...>",
+    'sources to scan: "files", "docs", and/or "records" (default: all three)'
+  ).option("--asset-ids <ids...>", "files scope: specific asset ids").option("--drive-path <path>", "files scope: Drive/Skill mounted path prefix").option("--mime-types <types...>", "files scope: MIME types").option("--node-ids <ids...>", "docs scope: specific Doc node ids").option("--base-ids <ids...>", "records scope: specific Base ids").option("--base-slugs <slugs...>", "records scope: specific Base slugs").option(
+    "--max-matches <n>",
+    "max matches, shared across sources (default 100, cap 1000)",
+    parsePositiveInt
+  ).option("--context-lines <n>", "lines of before/after context (default 0, cap 10)", parseNum).action(
+    runAction(state, (client, opts) => {
+      const filesScope = opts.assetIds || opts.drivePath || opts.mimeTypes ? {
+        assetIds: opts.assetIds,
+        drivePath: opts.drivePath,
+        mimeTypes: opts.mimeTypes
+      } : void 0;
+      const docsScope = opts.nodeIds ? { nodeIds: opts.nodeIds } : void 0;
+      const recordsScope = opts.baseIds || opts.baseSlugs ? {
+        baseIds: opts.baseIds,
+        baseSlugs: opts.baseSlugs
+      } : void 0;
+      return client.grep({
+        pattern: opts.pattern,
+        flags: opts.flags,
+        sources: opts.sources,
+        scope: filesScope || docsScope || recordsScope ? { files: filesScope, docs: docsScope, records: recordsScope } : void 0,
+        maxMatches: opts.maxMatches,
+        contextLines: opts.contextLines
+      });
+    })
+  );
   const addUploadCommand = (parent, hidden = false) => addGlobalFlags(parent.command("upload", { noHelp: hidden })).description("Upload a file and print an asset ref for record fields").requiredOption("--file <path>", "local file to upload").option("--file-name <name>", "stored file name (default: basename of --file)").option("--mime-type <mime>", "MIME type (default: inferred from extension)").option("--context <value>", "upload context (default record-field)").addHelpText(
     "after",
     `
@@ -1241,7 +1332,42 @@ Example:
 
 Use the JSON output directly in an attachment field value, e.g. {"cover_image":[<output>]}.`
   ).action(runAction(state, (_client, opts, config) => uploadAsset(config, opts)));
-  addUploadCommand(program.command("assets").description("Assets"));
+  const assetsCommand = program.command("assets").description("Assets");
+  addUploadCommand(assetsCommand);
+  addGlobalFlags(assetsCommand.command("put-text")).description("Write (or mark none) an asset's Drive Grep Retrieval text slot").requiredOption("--asset-id <id>", "asset id").option("--text <string>", "inline text (\u22641MB)").option("--file <path>", "read text from a local file instead of --text").option("--none", "mark as having no extractable text (e.g. a scanned, image-only PDF)").addHelpText(
+    "after",
+    `
+Examples:
+  busabase-cli assets put-text --asset-id ast_123 --file ./extracted.txt
+  busabase-cli assets put-text --asset-id ast_123 --text "plain text"
+  busabase-cli assets put-text --asset-id ast_123 --none`
+  ).action(runAction(state, (client, opts) => putTextCommand(client, opts)));
+  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({
+        pattern: opts.pattern,
+        flags: opts.flags,
+        scope: opts.assetIds || opts.drivePath || opts.mimeTypes ? {
+          assetIds: opts.assetIds,
+          drivePath: opts.drivePath,
+          mimeTypes: opts.mimeTypes
+        } : void 0,
+        maxMatches: opts.maxMatches,
+        contextLines: opts.contextLines
+      })
+    )
+  );
+  addGlobalFlags(assetsCommand.command("read-lines")).description("Read an exact line range from an asset's text (range capped at 2000 lines)").requiredOption("--asset-id <id>", "asset id").requiredOption("--start-line <n>", "first line (1-based)", parsePositiveInt).requiredOption("--end-line <n>", "last line (1-based)", parsePositiveInt).action(
+    runAction(
+      state,
+      (client, opts) => client.assets.readTextLines({
+        assetId: opts.assetId,
+        startLine: opts.startLine,
+        endLine: opts.endLine
+      })
+    )
+  );
   addGlobalFlags(program.command("api")).description("Raw request to any /api/v1 endpoint").addOption(
     new Option("--method <get|post|put|delete>", "HTTP method").choices(["get", "post", "put", "delete"]).makeOptionMandatory()
   ).requiredOption("--path <p>", "path under /api/v1, e.g. /bases").option("--query <k=v...>", "query-string param, repeatable").option("--body-json <json>", "JSON request body").action(

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runCli
-} from "./chunk-C5BGRNMU.js";
+} from "./chunk-N6NMNVQT.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-C5BGRNMU.js";
+} from "./chunk-N6NMNVQT.js";
 
 // src/index.ts
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "busa-cli",
-  "version": "0.9.3",
+  "version": "0.9.5",
   "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",
@@ -31,7 +31,7 @@
     "README.md"
   ],
   "dependencies": {
-    "busabase-sdk": "0.9.3",
+    "busabase-sdk": "0.9.5",
     "commander": "^14.0.0"
   },
   "engines": {