@stndrds/cli 1.0.0-alpha.209 → 1.0.0-alpha.211

package/dist/bin.mjs

@@ -87,6 +87,9 @@ function getGlobalOptions(cmd) {
 function getFormat(cmd) {
   return getGlobalOptions(cmd).format;
 }
+function parseCsvList(value) {
+  return value.split(",").map((item) => item.trim()).filter((item) => item.length > 0);
+}
 function getClientFromCommand(cmd) {
   const root = getGlobalOptions(cmd);
   if (!(root.apiUrl && root.apiKey)) {
@@ -178,6 +181,25 @@ function formatOutput(data, format) {
 `);
 }
 
+// src/commands/autofill.ts
+function registerAutofillCommand(program) {
+  const autofill = program.command("autofill").description("AI attribute autofill (backfill empty record fields)");
+  autofill.command("backfill").description("Dry-run estimate (default) or enqueue an autofill backfill job").requiredOption("--objects <ids>", "comma-separated object IDs to backfill").option("--max-records <n>", "cap the number of records processed").option("--confirm", "enqueue the job instead of returning a dry-run estimate").action(
+    async (opts, cmd) => {
+      const objectIds = parseCsvList(opts.objects);
+      if (objectIds.length === 0) {
+        throw new Error("--objects requires at least one object ID");
+      }
+      const client = getClientFromCommand(cmd);
+      const body = { objectIds };
+      if (opts.maxRecords) body.maxRecords = Number(opts.maxRecords);
+      if (opts.confirm) body.confirm = true;
+      const result = await client.post("/autofill/backfill", body);
+      formatOutput(result, getFormat(cmd));
+    }
+  );
+}
+
 // src/commands/documents.ts
 function registerDocumentsCommand(program) {
   const documents = program.command("documents").description("Manage documents");
@@ -279,15 +301,23 @@ function parseSortFlag(sort) {
   const [attribute, direction = "asc"] = sort.split(":");
   return [{ attribute, direction }];
 }
+function buildQueryBody(opts) {
+  const body = {};
+  if (opts.limit) body.limit = Number(opts.limit);
+  if (opts.offset) body.offset = Number(opts.offset);
+  if (opts.sort) body.sorts = parseSortFlag(opts.sort);
+  if (opts.filter) body.filters = JSON.parse(opts.filter);
+  if (opts.fields !== void 0) body.fields = parseCsvList(opts.fields);
+  return body;
+}
 function registerRecordsCommand(program) {
   const records = program.command("records").description("Manage records (CRUD + search)");
-  records.command("list").description("List records for an object").argument("<object>", "object name (e.g. contacts)").option("--limit <n>", "max records to return").option("--offset <n>", "number of records to skip").option("--sort <sort>", 'sort rule as "attribute:direction"').option("--filter <json>", "filter state as JSON string").action(async (objectName, opts, cmd) => {
+  records.command("list").description("List records for an object").argument("<object>", "object name (e.g. contacts)").option("--limit <n>", "max records to return").option("--offset <n>", "number of records to skip").option("--sort <sort>", 'sort rule as "attribute:direction"').option("--filter <json>", "filter state as JSON string").option(
+    "--fields <names>",
+    "comma-separated reference attributes to hydrate (empty for none, omit for all)"
+  ).action(async (objectName, opts, cmd) => {
     const client = getClientFromCommand(cmd);
-    const body = {};
-    if (opts.limit) body.limit = Number(opts.limit);
-    if (opts.offset) body.offset = Number(opts.offset);
-    if (opts.sort) body.sorts = parseSortFlag(opts.sort);
-    if (opts.filter) body.filters = JSON.parse(opts.filter);
+    const body = buildQueryBody(opts);
     const result = await client.post(`/records/${objectName}/list`, body);
     formatOutput(result, getFormat(cmd));
   });
@@ -314,13 +344,12 @@ function registerRecordsCommand(program) {
     process.stdout.write(`Record ${id} deleted.
 `);
   });
-  records.command("search").description("Full-text search records").argument("<object>", "object name").requiredOption("--query <q>", "search query string").option("--limit <n>", "max records to return").option("--offset <n>", "number of records to skip").option("--sort <sort>", 'sort rule as "attribute:direction"').option("--filter <json>", "filter state as JSON string").action(async (objectName, opts, cmd) => {
+  records.command("search").description("Full-text search records").argument("<object>", "object name").requiredOption("--query <q>", "search query string").option("--limit <n>", "max records to return").option("--offset <n>", "number of records to skip").option("--sort <sort>", 'sort rule as "attribute:direction"').option("--filter <json>", "filter state as JSON string").option(
+    "--fields <names>",
+    "comma-separated reference attributes to hydrate (empty for none, omit for all)"
+  ).action(async (objectName, opts, cmd) => {
     const client = getClientFromCommand(cmd);
-    const body = { q: opts.query };
-    if (opts.limit) body.limit = Number(opts.limit);
-    if (opts.offset) body.offset = Number(opts.offset);
-    if (opts.sort) body.sorts = parseSortFlag(opts.sort);
-    if (opts.filter) body.filters = JSON.parse(opts.filter);
+    const body = { q: opts.query, ...buildQueryBody(opts) };
     const result = await client.post(`/records/${objectName}/search`, body);
     formatOutput(result, getFormat(cmd));
   });
@@ -731,6 +760,7 @@ function createProgram() {
   registerDocumentsCommand(program);
   registerKeysCommand(program);
   registerAuthCommand(program);
+  registerAutofillCommand(program);
   program.hook("preAction", async (_thisCommand, actionCommand) => {
     const raw = program.opts();
     const resolved = await resolveCliConfig({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stndrds/cli",
-  "version": "1.0.0-alpha.209",
+  "version": "1.0.0-alpha.211",
   "description": "CLI tool to interact with Standards API",
   "type": "module",
   "bin": {