@getpilfer/cli 0.1.1 → 0.1.3

package/dist/{generated-IFLUY7PB.js → generated-7QDIZ5V5.js}

@@ -3,12 +3,55 @@ import {
   apiRequest,
   coerceBodyFlag,
   coerceQueryFlag,
+  fetchList,
   mergeBody,
+  printList,
   printOutput
-} from "./chunk-QH2MMA3M.js";
+} from "./chunk-CXNVJZ4C.js";
 import "./chunk-GZ4DXDQM.js";
 
+// src/lib/idempotent-create.ts
+async function findExistingResource(options) {
+  const identity = options.identityFields.filter(
+    (field) => isComparable(options.body[field])
+  );
+  if (identity.length === 0) return null;
+  const query = {};
+  for (const field of identity) {
+    if (!options.queryFields.includes(field)) continue;
+    const value = options.body[field];
+    if (typeof value === "string" || typeof value === "number") {
+      query[field] = value;
+    }
+  }
+  const res = await options.request({
+    method: "GET",
+    path: options.resource,
+    token: options.token,
+    baseUrl: options.baseUrl,
+    query
+  });
+  if (!res.ok) return null;
+  const rows = (res.data?.data ?? []).filter(
+    isRecord
+  );
+  return rows.find((row) => identity.every((field) => equalValue(row[field], options.body[field]))) ?? null;
+}
+function isComparable(value) {
+  return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+}
+function equalValue(a, b) {
+  if (typeof a === "string" && typeof b === "string") {
+    return a.trim().toLowerCase() === b.trim().toLowerCase();
+  }
+  return a === b;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 // src/lib/bulk.ts
+import { readFile } from "fs/promises";
 var MAX_IDS = 25;
 var CONCURRENCY = 5;
 var MAX_RETRIES = 3;
@@ -16,6 +59,33 @@ function parseIds(idsFlag) {
   if (!idsFlag?.trim()) return [];
   return idsFlag.split(",").map((s) => s.trim()).filter(Boolean);
 }
+async function parseIdsInput(idsFlag, idsFile) {
+  const inline = idsFlag?.trim() === "-" ? await readStdin() : idsFlag;
+  const fromFile = idsFile ? await readTextSource(idsFile) : "";
+  return [...parseIds(inline), ...parseIdsText(fromFile)];
+}
+async function parseBulkInput(input) {
+  if (!input?.trim()) return [];
+  const text = await readTextSource(input);
+  if (!text.trim()) return [];
+  if (text.trim().startsWith("[") || text.trim().startsWith("{")) {
+    try {
+      const parsed = JSON.parse(text);
+      if (Array.isArray(parsed)) return parsed.filter(isRecord2);
+      if (isRecord2(parsed) && Array.isArray(parsed.data)) {
+        return parsed.data.filter(isRecord2);
+      }
+      if (isRecord2(parsed)) return [parsed];
+    } catch {
+    }
+  }
+  return text.split(/\r?\n/).map((line) => line.trim()).filter(Boolean).map((line) => JSON.parse(line)).filter(isRecord2);
+}
+function getBulkRecordId(record) {
+  if (typeof record._id === "string" && record._id.trim()) return record._id.trim();
+  if (typeof record.id === "string" && record.id.trim()) return record.id.trim();
+  return null;
+}
 function validateBulkIds(ids, resourceLabel) {
   if (ids.length > MAX_IDS) {
     throw new Error(
@@ -29,17 +99,17 @@ async function runBulk(options) {
   const results = [];
   let succeeded = 0;
   let failed = 0;
-  async function runWithRetry(id) {
+  async function runWithRetry(item) {
     let lastRes = null;
     for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
-      const res = await runOne(id);
+      const res = await runOne(item);
       lastRes = res;
       if (res.status !== 429) break;
       const retryAfter = 2 ** attempt;
       await new Promise((r2) => setTimeout(r2, retryAfter * 1e3));
     }
     const r = lastRes;
-    const result = toResult(id, r.ok, r.status, r.data, r.error);
+    const result = toResult(item, r.ok, r.status, r.data, r.error);
     if (r.ok) succeeded++;
     else failed++;
     return result;
@@ -47,8 +117,8 @@ async function runBulk(options) {
   const queue = [...items];
   const workers = Array.from({ length: concurrency }, async () => {
     while (queue.length > 0) {
-      const id = queue.shift();
-      const result = await runWithRetry(id);
+      const item = queue.shift();
+      const result = await runWithRetry(item);
       results.push(result);
     }
   });
@@ -58,12 +128,30 @@ async function runBulk(options) {
     summary: { total: items.length, succeeded, failed }
   };
 }
+function parseIdsText(text) {
+  if (!text?.trim()) return [];
+  return text.split(/[\s,]+/).map((s) => s.trim()).filter(Boolean);
+}
+async function readTextSource(source) {
+  if (source === "-") return readStdin();
+  return readFile(source, "utf-8");
+}
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk)));
+  }
+  return Buffer.concat(chunks).toString("utf-8");
+}
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 
 // src/commands/generated/index.ts
 function register(program, helpers) {
   const { getOutputFormat, requireToken, exitWithError, getBaseUrl, syncRootOptsFromCommand } = helpers;
   const organizationsCmd = program.command("organizations").description("organizations resource");
-  organizationsCmd.command("list").description("List organizations").option("--limit <n>", "Max results").option("--offset <n>", "Skip n results").hook("preAction", (thisCommand) => {
+  organizationsCmd.command("list").description("List organizations").option("--limit <n>", "Max results").option("--offset <n>", "Skip n results").option("--all", "Fetch all pages").option("--fields <fields>", "Comma-separated fields to print").option("--where <field=value>", "Client-side exact filters, comma-separated").option("--jsonl", "Print one compact JSON object per row").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (opts) => {
     const token = requireToken();
@@ -71,10 +159,10 @@ function register(program, helpers) {
     const query = {};
     if (opts.limit != null) query.limit = opts.limit;
     if (opts.offset != null) query.offset = opts.offset;
-    const res = await apiRequest({ method: "GET", path: "organizations", token, baseUrl: getBaseUrl(), query });
+    const res = await fetchList({ path: "organizations", token, baseUrl: getBaseUrl(), query, all: Boolean(opts.all), request: apiRequest });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     const data = res.data?.data ?? [];
-    printOutput(getOutputFormat(), data, false);
+    printList({ format: getOutputFormat(), data, fields: opts.fields, where: opts.where, jsonl: Boolean(opts.jsonl) });
   });
   organizationsCmd.command("get <id>").description("Get one organizations by id").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
@@ -88,7 +176,7 @@ function register(program, helpers) {
     printOutput(getOutputFormat(), data ?? {}, false);
   });
   const projectsCmd = program.command("projects").description("projects resource");
-  projectsCmd.command("list").description("List projects").option("--limit <n>", "Max results").option("--offset <n>", "Skip n results").option("--organization-id <value>", "Filter by organizationId").hook("preAction", (thisCommand) => {
+  projectsCmd.command("list").description("List projects").option("--limit <n>", "Max results").option("--offset <n>", "Skip n results").option("--all", "Fetch all pages").option("--fields <fields>", "Comma-separated fields to print").option("--where <field=value>", "Client-side exact filters, comma-separated").option("--jsonl", "Print one compact JSON object per row").option("--organization-id <value>", "Filter by organizationId").option("--include <value>", "Filter by include").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (opts) => {
     const token = requireToken();
@@ -99,17 +187,23 @@ function register(program, helpers) {
     if (opts.organizationId != null) {
       query.organizationId = coerceQueryFlag(opts.organizationId, { field: "organizationId", flag: "--organization-id", kind: "string" }, exitWithError);
     }
-    const res = await apiRequest({ method: "GET", path: "projects", token, baseUrl: getBaseUrl(), query });
+    if (opts.include != null) {
+      query.include = coerceQueryFlag(opts.include, { field: "include", flag: "--include", kind: "string" }, exitWithError);
+    }
+    const res = await fetchList({ path: "projects", token, baseUrl: getBaseUrl(), query, all: Boolean(opts.all), request: apiRequest });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     const data = res.data?.data ?? [];
-    printOutput(getOutputFormat(), data, false);
+    printList({ format: getOutputFormat(), data, fields: opts.fields, where: opts.where, jsonl: Boolean(opts.jsonl) });
   });
-  projectsCmd.command("get <id>").description("Get one projects by id").hook("preAction", (thisCommand) => {
+  projectsCmd.command("get <id>").description("Get one projects by id").option("--include <value>", "Include/filter by include").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (id, opts) => {
     const token = requireToken();
     if (!token) exitWithError(401, "Missing or invalid token");
     const query = {};
+    if (opts.include != null) {
+      query.include = coerceQueryFlag(opts.include, { field: "include", flag: "--include", kind: "string" }, exitWithError);
+    }
     const res = await apiRequest({ method: "GET", path: "projects/" + encodeURIComponent(id), token, baseUrl: getBaseUrl(), query });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     const data = res.data?.data ?? res.data;
@@ -131,20 +225,69 @@ function register(program, helpers) {
     if (parsedPriority !== void 0) bodyFromFlags.priority = parsedPriority;
     const body = mergeBody(bodyFromFlags, opts.body);
     if (opts.ifNotExists) {
+      const existing = await findExistingResource({
+        resource: "projects",
+        token,
+        baseUrl: getBaseUrl(),
+        body,
+        identityFields: ["name", "organizationId"],
+        queryFields: ["organizationId", "include"],
+        request: apiRequest
+      });
+      if (existing) {
+        printOutput(getOutputFormat(), existing, false);
+        return;
+      }
     }
     const res = await apiRequest({ method: "POST", path: "projects", token, baseUrl: getBaseUrl(), body });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     const data = res.data?.data ?? res.data;
     printOutput(getOutputFormat(), data ?? {}, false);
   });
-  projectsCmd.command("update <id>").description("Update projects").option("--body <json>", "Request body JSON (merged with flags)").option("--ids <ids>", "Comma-separated IDs for bulk update (max 25)").option("--name <value>", "name").option("--description <value>", "description").option("--priority <value>", "priority").hook("preAction", (thisCommand) => {
+  projectsCmd.command("update [id]").description("Update projects").option("--body <json>", "Request body JSON (merged with flags)").option("--ids <ids>", "Comma-separated IDs for bulk update (max 25)").option("--ids-file <path>", "File containing IDs for bulk update").option("--input <path>", "JSON/JSONL records for bulk update; use - for stdin").option("--dry-run", "Preview bulk update without sending requests").option("--name <value>", "name").option("--description <value>", "description").option("--priority <value>", "priority").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (id, opts) => {
     const token = requireToken();
     if (!token) exitWithError(401, "Missing or invalid token");
-    const ids = parseIds(opts.ids);
+    const inputRecords = await parseBulkInput(opts.input);
+    if (inputRecords.length > 0) {
+      const ids2 = inputRecords.map(getBulkRecordId).filter((value) => value !== null);
+      if (ids2.length !== inputRecords.length) exitWithError(400, "Each --input record must include id or _id");
+      validateBulkIds(ids2, "projects");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids2.map((_id) => ({ _id, status: "would_update" })), summary: { total: ids2.length, succeeded: ids2.length, failed: 0 } }, false);
+        return;
+      }
+      const { data: data2, summary } = await runBulk({
+        items: inputRecords,
+        runOne: async (record) => {
+          const itemId = getBulkRecordId(record);
+          const recordBody = { ...record };
+          delete recordBody.id;
+          delete recordBody._id;
+          const bodyFromFlags2 = {};
+          const parsedName2 = coerceBodyFlag(opts.name, { field: "name", flag: "--name", kind: "string" }, exitWithError);
+          if (parsedName2 !== void 0) bodyFromFlags2.name = parsedName2;
+          const parsedDescription2 = coerceBodyFlag(opts.description, { field: "description", flag: "--description", kind: "string" }, exitWithError);
+          if (parsedDescription2 !== void 0) bodyFromFlags2.description = parsedDescription2;
+          const parsedPriority2 = coerceBodyFlag(opts.priority, { field: "priority", flag: "--priority", kind: "string" }, exitWithError);
+          if (parsedPriority2 !== void 0) bodyFromFlags2.priority = parsedPriority2;
+          const body2 = { ...recordBody, ...mergeBody(bodyFromFlags2, opts.body) };
+          const res2 = await apiRequest({ method: "PATCH", path: "projects/" + encodeURIComponent(itemId), token, baseUrl: getBaseUrl(), body: body2 });
+          return { ok: res2.ok, status: res2.status || 0, data: res2.data, error: res2.error };
+        },
+        toResult: (record, ok, status, _data, err) => ok ? { _id: getBulkRecordId(record), status: "updated" } : { _id: getBulkRecordId(record) ?? void 0, error: true, statusCode: status, message: err ?? "Failed" }
+      });
+      printOutput(getOutputFormat(), { data: data2, summary }, false);
+      return;
+    }
+    const ids = await parseIdsInput(opts.ids, opts.idsFile);
     if (ids.length > 0) {
       validateBulkIds(ids, "projects");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids.map((_id) => ({ _id, status: "would_update" })), summary: { total: ids.length, succeeded: ids.length, failed: 0 } }, false);
+        return;
+      }
       const { data: data2, summary } = await runBulk({
         items: ids,
         runOne: async (itemId) => {
@@ -164,6 +307,7 @@ function register(program, helpers) {
       printOutput(getOutputFormat(), { data: data2, summary }, false);
       return;
     }
+    if (!id) exitWithError(400, "Provide id, --ids, --ids-file, or --input");
     const bodyFromFlags = {};
     const parsedName = coerceBodyFlag(opts.name, { field: "name", flag: "--name", kind: "string" }, exitWithError);
     if (parsedName !== void 0) bodyFromFlags.name = parsedName;
@@ -177,14 +321,18 @@ function register(program, helpers) {
     const data = res.data?.data ?? res.data;
     printOutput(getOutputFormat(), data ?? {}, false);
   });
-  projectsCmd.command("delete <id>").description("Delete projects").option("--ids <ids>", "Comma-separated IDs for bulk delete (max 25)").hook("preAction", (thisCommand) => {
+  projectsCmd.command("delete [id]").description("Delete projects").option("--ids <ids>", "Comma-separated IDs for bulk delete (max 25)").option("--ids-file <path>", "File containing IDs for bulk delete").option("--dry-run", "Preview delete without sending requests").option("--yes", "Confirm destructive bulk delete").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (id, opts) => {
     const token = requireToken();
     if (!token) exitWithError(401, "Missing or invalid token");
-    const ids = parseIds(opts.ids);
+    const ids = await parseIdsInput(opts.ids, opts.idsFile);
     if (ids.length > 0) {
       validateBulkIds(ids, "projects");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids.map((_id) => ({ _id, status: "would_delete" })), summary: { total: ids.length, succeeded: ids.length, failed: 0 } }, false);
+        return;
+      }
       const { data, summary } = await runBulk({
         items: ids,
         runOne: async (itemId) => {
@@ -196,12 +344,17 @@ function register(program, helpers) {
       printOutput(getOutputFormat(), { data, summary }, false);
       return;
     }
+    if (!id) exitWithError(400, "Provide id, --ids, or --ids-file");
+    if (opts.dryRun) {
+      printOutput(getOutputFormat(), { _id: id, status: "would_delete" }, false);
+      return;
+    }
     const res = await apiRequest({ method: "DELETE", path: "projects/" + encodeURIComponent(id), token, baseUrl: getBaseUrl() });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     if (getOutputFormat() === "json") console.log(JSON.stringify({ data: null, deleted: true }));
   });
   const spacesCmd = program.command("spaces").description("spaces resource");
-  spacesCmd.command("list").description("List spaces").option("--limit <n>", "Max results").option("--offset <n>", "Skip n results").option("--organization-id <value>", "Filter by organizationId").option("--project-id <value>", "Filter by projectId").hook("preAction", (thisCommand) => {
+  spacesCmd.command("list").description("List spaces").option("--limit <n>", "Max results").option("--offset <n>", "Skip n results").option("--all", "Fetch all pages").option("--fields <fields>", "Comma-separated fields to print").option("--where <field=value>", "Client-side exact filters, comma-separated").option("--jsonl", "Print one compact JSON object per row").option("--organization-id <value>", "Filter by organizationId").option("--project-id <value>", "Filter by projectId").option("--include <value>", "Filter by include").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (opts) => {
     const token = requireToken();
@@ -215,17 +368,23 @@ function register(program, helpers) {
     if (opts.projectId != null) {
       query.projectId = coerceQueryFlag(opts.projectId, { field: "projectId", flag: "--project-id", kind: "string" }, exitWithError);
     }
-    const res = await apiRequest({ method: "GET", path: "spaces", token, baseUrl: getBaseUrl(), query });
+    if (opts.include != null) {
+      query.include = coerceQueryFlag(opts.include, { field: "include", flag: "--include", kind: "string" }, exitWithError);
+    }
+    const res = await fetchList({ path: "spaces", token, baseUrl: getBaseUrl(), query, all: Boolean(opts.all), request: apiRequest });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     const data = res.data?.data ?? [];
-    printOutput(getOutputFormat(), data, false);
+    printList({ format: getOutputFormat(), data, fields: opts.fields, where: opts.where, jsonl: Boolean(opts.jsonl) });
   });
-  spacesCmd.command("get <id>").description("Get one spaces by id").hook("preAction", (thisCommand) => {
+  spacesCmd.command("get <id>").description("Get one spaces by id").option("--include <value>", "Include/filter by include").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (id, opts) => {
     const token = requireToken();
     if (!token) exitWithError(401, "Missing or invalid token");
     const query = {};
+    if (opts.include != null) {
+      query.include = coerceQueryFlag(opts.include, { field: "include", flag: "--include", kind: "string" }, exitWithError);
+    }
     const res = await apiRequest({ method: "GET", path: "spaces/" + encodeURIComponent(id), token, baseUrl: getBaseUrl(), query });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     const data = res.data?.data ?? res.data;
@@ -253,20 +412,75 @@ function register(program, helpers) {
     if (parsedCurrentStrength !== void 0) bodyFromFlags.currentStrength = parsedCurrentStrength;
     const body = mergeBody(bodyFromFlags, opts.body);
     if (opts.ifNotExists) {
+      const existing = await findExistingResource({
+        resource: "spaces",
+        token,
+        baseUrl: getBaseUrl(),
+        body,
+        identityFields: ["name", "organizationId", "projectId"],
+        queryFields: ["organizationId", "projectId", "include"],
+        request: apiRequest
+      });
+      if (existing) {
+        printOutput(getOutputFormat(), existing, false);
+        return;
+      }
     }
     const res = await apiRequest({ method: "POST", path: "spaces", token, baseUrl: getBaseUrl(), body });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     const data = res.data?.data ?? res.data;
     printOutput(getOutputFormat(), data ?? {}, false);
   });
-  spacesCmd.command("update <id>").description("Update spaces").option("--body <json>", "Request body JSON (merged with flags)").option("--ids <ids>", "Comma-separated IDs for bulk update (max 25)").option("--name <value>", "name").option("--description <value>", "description").option("--project-id <value>", "projectId").option("--status <value>", "status").option("--priority <value>", "priority").option("--current-strength <value>", "currentStrength").hook("preAction", (thisCommand) => {
+  spacesCmd.command("update [id]").description("Update spaces").option("--body <json>", "Request body JSON (merged with flags)").option("--ids <ids>", "Comma-separated IDs for bulk update (max 25)").option("--ids-file <path>", "File containing IDs for bulk update").option("--input <path>", "JSON/JSONL records for bulk update; use - for stdin").option("--dry-run", "Preview bulk update without sending requests").option("--name <value>", "name").option("--description <value>", "description").option("--project-id <value>", "projectId").option("--status <value>", "status").option("--priority <value>", "priority").option("--current-strength <value>", "currentStrength").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (id, opts) => {
     const token = requireToken();
     if (!token) exitWithError(401, "Missing or invalid token");
-    const ids = parseIds(opts.ids);
+    const inputRecords = await parseBulkInput(opts.input);
+    if (inputRecords.length > 0) {
+      const ids2 = inputRecords.map(getBulkRecordId).filter((value) => value !== null);
+      if (ids2.length !== inputRecords.length) exitWithError(400, "Each --input record must include id or _id");
+      validateBulkIds(ids2, "spaces");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids2.map((_id) => ({ _id, status: "would_update" })), summary: { total: ids2.length, succeeded: ids2.length, failed: 0 } }, false);
+        return;
+      }
+      const { data: data2, summary } = await runBulk({
+        items: inputRecords,
+        runOne: async (record) => {
+          const itemId = getBulkRecordId(record);
+          const recordBody = { ...record };
+          delete recordBody.id;
+          delete recordBody._id;
+          const bodyFromFlags2 = {};
+          const parsedName2 = coerceBodyFlag(opts.name, { field: "name", flag: "--name", kind: "string" }, exitWithError);
+          if (parsedName2 !== void 0) bodyFromFlags2.name = parsedName2;
+          const parsedDescription2 = coerceBodyFlag(opts.description, { field: "description", flag: "--description", kind: "string" }, exitWithError);
+          if (parsedDescription2 !== void 0) bodyFromFlags2.description = parsedDescription2;
+          const parsedProjectId2 = coerceBodyFlag(opts.projectId, { field: "projectId", flag: "--project-id", kind: "string", allowNull: true }, exitWithError);
+          if (parsedProjectId2 !== void 0) bodyFromFlags2.projectId = parsedProjectId2;
+          const parsedStatus2 = coerceBodyFlag(opts.status, { field: "status", flag: "--status", kind: "string" }, exitWithError);
+          if (parsedStatus2 !== void 0) bodyFromFlags2.status = parsedStatus2;
+          const parsedPriority2 = coerceBodyFlag(opts.priority, { field: "priority", flag: "--priority", kind: "string" }, exitWithError);
+          if (parsedPriority2 !== void 0) bodyFromFlags2.priority = parsedPriority2;
+          const parsedCurrentStrength2 = coerceBodyFlag(opts.currentStrength, { field: "currentStrength", flag: "--current-strength", kind: "number" }, exitWithError);
+          if (parsedCurrentStrength2 !== void 0) bodyFromFlags2.currentStrength = parsedCurrentStrength2;
+          const body2 = { ...recordBody, ...mergeBody(bodyFromFlags2, opts.body) };
+          const res2 = await apiRequest({ method: "PATCH", path: "spaces/" + encodeURIComponent(itemId), token, baseUrl: getBaseUrl(), body: body2 });
+          return { ok: res2.ok, status: res2.status || 0, data: res2.data, error: res2.error };
+        },
+        toResult: (record, ok, status, _data, err) => ok ? { _id: getBulkRecordId(record), status: "updated" } : { _id: getBulkRecordId(record) ?? void 0, error: true, statusCode: status, message: err ?? "Failed" }
+      });
+      printOutput(getOutputFormat(), { data: data2, summary }, false);
+      return;
+    }
+    const ids = await parseIdsInput(opts.ids, opts.idsFile);
     if (ids.length > 0) {
       validateBulkIds(ids, "spaces");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids.map((_id) => ({ _id, status: "would_update" })), summary: { total: ids.length, succeeded: ids.length, failed: 0 } }, false);
+        return;
+      }
       const { data: data2, summary } = await runBulk({
         items: ids,
         runOne: async (itemId) => {
@@ -292,6 +506,7 @@ function register(program, helpers) {
       printOutput(getOutputFormat(), { data: data2, summary }, false);
       return;
     }
+    if (!id) exitWithError(400, "Provide id, --ids, --ids-file, or --input");
     const bodyFromFlags = {};
     const parsedName = coerceBodyFlag(opts.name, { field: "name", flag: "--name", kind: "string" }, exitWithError);
     if (parsedName !== void 0) bodyFromFlags.name = parsedName;
@@ -311,14 +526,18 @@ function register(program, helpers) {
     const data = res.data?.data ?? res.data;
     printOutput(getOutputFormat(), data ?? {}, false);
   });
-  spacesCmd.command("delete <id>").description("Delete spaces").option("--ids <ids>", "Comma-separated IDs for bulk delete (max 25)").hook("preAction", (thisCommand) => {
+  spacesCmd.command("delete [id]").description("Delete spaces").option("--ids <ids>", "Comma-separated IDs for bulk delete (max 25)").option("--ids-file <path>", "File containing IDs for bulk delete").option("--dry-run", "Preview delete without sending requests").option("--yes", "Confirm destructive bulk delete").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (id, opts) => {
     const token = requireToken();
     if (!token) exitWithError(401, "Missing or invalid token");
-    const ids = parseIds(opts.ids);
+    const ids = await parseIdsInput(opts.ids, opts.idsFile);
     if (ids.length > 0) {
       validateBulkIds(ids, "spaces");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids.map((_id) => ({ _id, status: "would_delete" })), summary: { total: ids.length, succeeded: ids.length, failed: 0 } }, false);
+        return;
+      }
       const { data, summary } = await runBulk({
         items: ids,
         runOne: async (itemId) => {
@@ -330,12 +549,17 @@ function register(program, helpers) {
       printOutput(getOutputFormat(), { data, summary }, false);
       return;
     }
+    if (!id) exitWithError(400, "Provide id, --ids, or --ids-file");
+    if (opts.dryRun) {
+      printOutput(getOutputFormat(), { _id: id, status: "would_delete" }, false);
+      return;
+    }
     const res = await apiRequest({ method: "DELETE", path: "spaces/" + encodeURIComponent(id), token, baseUrl: getBaseUrl() });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     if (getOutputFormat() === "json") console.log(JSON.stringify({ data: null, deleted: true }));
   });
   const scoutsCmd = program.command("scouts").description("scouts resource");
-  scoutsCmd.command("list").description("List scouts").option("--limit <n>", "Max results").option("--offset <n>", "Skip n results").option("--organization-id <value>", "Filter by organizationId").option("--category-id <value>", "Filter by categoryId").hook("preAction", (thisCommand) => {
+  scoutsCmd.command("list").description("List scouts").option("--limit <n>", "Max results").option("--offset <n>", "Skip n results").option("--all", "Fetch all pages").option("--fields <fields>", "Comma-separated fields to print").option("--where <field=value>", "Client-side exact filters, comma-separated").option("--jsonl", "Print one compact JSON object per row").option("--organization-id <value>", "Filter by organizationId").option("--category-id <value>", "Filter by categoryId").option("--include <value>", "Filter by include").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (opts) => {
     const token = requireToken();
@@ -349,17 +573,23 @@ function register(program, helpers) {
     if (opts.categoryId != null) {
       query.categoryId = coerceQueryFlag(opts.categoryId, { field: "categoryId", flag: "--category-id", kind: "string" }, exitWithError);
     }
-    const res = await apiRequest({ method: "GET", path: "scouts", token, baseUrl: getBaseUrl(), query });
+    if (opts.include != null) {
+      query.include = coerceQueryFlag(opts.include, { field: "include", flag: "--include", kind: "string" }, exitWithError);
+    }
+    const res = await fetchList({ path: "scouts", token, baseUrl: getBaseUrl(), query, all: Boolean(opts.all), request: apiRequest });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     const data = res.data?.data ?? [];
-    printOutput(getOutputFormat(), data, false);
+    printList({ format: getOutputFormat(), data, fields: opts.fields, where: opts.where, jsonl: Boolean(opts.jsonl) });
   });
-  scoutsCmd.command("get <id>").description("Get one scouts by id").hook("preAction", (thisCommand) => {
+  scoutsCmd.command("get <id>").description("Get one scouts by id").option("--include <value>", "Include/filter by include").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (id, opts) => {
     const token = requireToken();
     if (!token) exitWithError(401, "Missing or invalid token");
     const query = {};
+    if (opts.include != null) {
+      query.include = coerceQueryFlag(opts.include, { field: "include", flag: "--include", kind: "string" }, exitWithError);
+    }
     const res = await apiRequest({ method: "GET", path: "scouts/" + encodeURIComponent(id), token, baseUrl: getBaseUrl(), query });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     const data = res.data?.data ?? res.data;
@@ -413,20 +643,99 @@ function register(program, helpers) {
     if (parsedActivationPotential !== void 0) bodyFromFlags.activationPotential = parsedActivationPotential;
     const body = mergeBody(bodyFromFlags, opts.body);
     if (opts.ifNotExists) {
+      const existing = await findExistingResource({
+        resource: "scouts",
+        token,
+        baseUrl: getBaseUrl(),
+        body,
+        identityFields: ["name", "organizationId"],
+        queryFields: ["organizationId", "categoryId", "include"],
+        request: apiRequest
+      });
+      if (existing) {
+        printOutput(getOutputFormat(), existing, false);
+        return;
+      }
     }
     const res = await apiRequest({ method: "POST", path: "scouts", token, baseUrl: getBaseUrl(), body });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     const data = res.data?.data ?? res.data;
     printOutput(getOutputFormat(), data ?? {}, false);
   });
-  scoutsCmd.command("update <id>").description("Update scouts").option("--body <json>", "Request body JSON (merged with flags)").option("--ids <ids>", "Comma-separated IDs for bulk update (max 25)").option("--name <value>", "name").option("--description <value>", "description").option("--category-id <value>", "categoryId").option("--url <value>", "url").option("--hero-image <value>", "heroImage").option("--priority <value>", "priority").option("--status <value>", "status").option("--estimated-cost <value>", "estimatedCost").option("--potential-cost <value>", "potentialCost").option("--need <value>", "need").option("--urgency <value>", "urgency").option("--use <value>", "use").option("--longevity <value>", "longevity").option("--roi <value>", "roi").option("--system-fit <value>", "systemFit").option("--emotional-pull <value>", "emotionalPull").option("--infrastructure-fit <value>", "infrastructureFit").option("--activation-potential <value>", "activationPotential").hook("preAction", (thisCommand) => {
+  scoutsCmd.command("update [id]").description("Update scouts").option("--body <json>", "Request body JSON (merged with flags)").option("--ids <ids>", "Comma-separated IDs for bulk update (max 25)").option("--ids-file <path>", "File containing IDs for bulk update").option("--input <path>", "JSON/JSONL records for bulk update; use - for stdin").option("--dry-run", "Preview bulk update without sending requests").option("--name <value>", "name").option("--description <value>", "description").option("--category-id <value>", "categoryId").option("--url <value>", "url").option("--hero-image <value>", "heroImage").option("--priority <value>", "priority").option("--status <value>", "status").option("--estimated-cost <value>", "estimatedCost").option("--potential-cost <value>", "potentialCost").option("--need <value>", "need").option("--urgency <value>", "urgency").option("--use <value>", "use").option("--longevity <value>", "longevity").option("--roi <value>", "roi").option("--system-fit <value>", "systemFit").option("--emotional-pull <value>", "emotionalPull").option("--infrastructure-fit <value>", "infrastructureFit").option("--activation-potential <value>", "activationPotential").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (id, opts) => {
     const token = requireToken();
     if (!token) exitWithError(401, "Missing or invalid token");
-    const ids = parseIds(opts.ids);
+    const inputRecords = await parseBulkInput(opts.input);
+    if (inputRecords.length > 0) {
+      const ids2 = inputRecords.map(getBulkRecordId).filter((value) => value !== null);
+      if (ids2.length !== inputRecords.length) exitWithError(400, "Each --input record must include id or _id");
+      validateBulkIds(ids2, "scouts");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids2.map((_id) => ({ _id, status: "would_update" })), summary: { total: ids2.length, succeeded: ids2.length, failed: 0 } }, false);
+        return;
+      }
+      const { data: data2, summary } = await runBulk({
+        items: inputRecords,
+        runOne: async (record) => {
+          const itemId = getBulkRecordId(record);
+          const recordBody = { ...record };
+          delete recordBody.id;
+          delete recordBody._id;
+          const bodyFromFlags2 = {};
+          const parsedName2 = coerceBodyFlag(opts.name, { field: "name", flag: "--name", kind: "string" }, exitWithError);
+          if (parsedName2 !== void 0) bodyFromFlags2.name = parsedName2;
+          const parsedDescription2 = coerceBodyFlag(opts.description, { field: "description", flag: "--description", kind: "string" }, exitWithError);
+          if (parsedDescription2 !== void 0) bodyFromFlags2.description = parsedDescription2;
+          const parsedCategoryId2 = coerceBodyFlag(opts.categoryId, { field: "categoryId", flag: "--category-id", kind: "string", allowNull: true }, exitWithError);
+          if (parsedCategoryId2 !== void 0) bodyFromFlags2.categoryId = parsedCategoryId2;
+          const parsedUrl2 = coerceBodyFlag(opts.url, { field: "url", flag: "--url", kind: "string" }, exitWithError);
+          if (parsedUrl2 !== void 0) bodyFromFlags2.url = parsedUrl2;
+          const parsedHeroImage2 = coerceBodyFlag(opts.heroImage, { field: "heroImage", flag: "--hero-image", kind: "string" }, exitWithError);
+          if (parsedHeroImage2 !== void 0) bodyFromFlags2.heroImage = parsedHeroImage2;
+          const parsedPriority2 = coerceBodyFlag(opts.priority, { field: "priority", flag: "--priority", kind: "string" }, exitWithError);
+          if (parsedPriority2 !== void 0) bodyFromFlags2.priority = parsedPriority2;
+          const parsedStatus2 = coerceBodyFlag(opts.status, { field: "status", flag: "--status", kind: "string" }, exitWithError);
+          if (parsedStatus2 !== void 0) bodyFromFlags2.status = parsedStatus2;
+          const parsedEstimatedCost2 = coerceBodyFlag(opts.estimatedCost, { field: "estimatedCost", flag: "--estimated-cost", kind: "number" }, exitWithError);
+          if (parsedEstimatedCost2 !== void 0) bodyFromFlags2.estimatedCost = parsedEstimatedCost2;
+          const parsedPotentialCost2 = coerceBodyFlag(opts.potentialCost, { field: "potentialCost", flag: "--potential-cost", kind: "number" }, exitWithError);
+          if (parsedPotentialCost2 !== void 0) bodyFromFlags2.potentialCost = parsedPotentialCost2;
+          const parsedNeed2 = coerceBodyFlag(opts.need, { field: "need", flag: "--need", kind: "number" }, exitWithError);
+          if (parsedNeed2 !== void 0) bodyFromFlags2.need = parsedNeed2;
+          const parsedUrgency2 = coerceBodyFlag(opts.urgency, { field: "urgency", flag: "--urgency", kind: "number" }, exitWithError);
+          if (parsedUrgency2 !== void 0) bodyFromFlags2.urgency = parsedUrgency2;
+          const parsedUse2 = coerceBodyFlag(opts.use, { field: "use", flag: "--use", kind: "number" }, exitWithError);
+          if (parsedUse2 !== void 0) bodyFromFlags2.use = parsedUse2;
+          const parsedLongevity2 = coerceBodyFlag(opts.longevity, { field: "longevity", flag: "--longevity", kind: "number" }, exitWithError);
+          if (parsedLongevity2 !== void 0) bodyFromFlags2.longevity = parsedLongevity2;
+          const parsedRoi2 = coerceBodyFlag(opts.roi, { field: "roi", flag: "--roi", kind: "number" }, exitWithError);
+          if (parsedRoi2 !== void 0) bodyFromFlags2.roi = parsedRoi2;
+          const parsedSystemFit2 = coerceBodyFlag(opts.systemFit, { field: "systemFit", flag: "--system-fit", kind: "number" }, exitWithError);
+          if (parsedSystemFit2 !== void 0) bodyFromFlags2.systemFit = parsedSystemFit2;
+          const parsedEmotionalPull2 = coerceBodyFlag(opts.emotionalPull, { field: "emotionalPull", flag: "--emotional-pull", kind: "number" }, exitWithError);
+          if (parsedEmotionalPull2 !== void 0) bodyFromFlags2.emotionalPull = parsedEmotionalPull2;
+          const parsedInfrastructureFit2 = coerceBodyFlag(opts.infrastructureFit, { field: "infrastructureFit", flag: "--infrastructure-fit", kind: "number" }, exitWithError);
+          if (parsedInfrastructureFit2 !== void 0) bodyFromFlags2.infrastructureFit = parsedInfrastructureFit2;
+          const parsedActivationPotential2 = coerceBodyFlag(opts.activationPotential, { field: "activationPotential", flag: "--activation-potential", kind: "number" }, exitWithError);
+          if (parsedActivationPotential2 !== void 0) bodyFromFlags2.activationPotential = parsedActivationPotential2;
+          const body2 = { ...recordBody, ...mergeBody(bodyFromFlags2, opts.body) };
+          const res2 = await apiRequest({ method: "PATCH", path: "scouts/" + encodeURIComponent(itemId), token, baseUrl: getBaseUrl(), body: body2 });
+          return { ok: res2.ok, status: res2.status || 0, data: res2.data, error: res2.error };
+        },
+        toResult: (record, ok, status, _data, err) => ok ? { _id: getBulkRecordId(record), status: "updated" } : { _id: getBulkRecordId(record) ?? void 0, error: true, statusCode: status, message: err ?? "Failed" }
+      });
+      printOutput(getOutputFormat(), { data: data2, summary }, false);
+      return;
+    }
+    const ids = await parseIdsInput(opts.ids, opts.idsFile);
     if (ids.length > 0) {
       validateBulkIds(ids, "scouts");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids.map((_id) => ({ _id, status: "would_update" })), summary: { total: ids.length, succeeded: ids.length, failed: 0 } }, false);
+        return;
+      }
       const { data: data2, summary } = await runBulk({
         items: ids,
         runOne: async (itemId) => {
@@ -476,6 +785,7 @@ function register(program, helpers) {
       printOutput(getOutputFormat(), { data: data2, summary }, false);
       return;
     }
+    if (!id) exitWithError(400, "Provide id, --ids, --ids-file, or --input");
     const bodyFromFlags = {};
     const parsedName = coerceBodyFlag(opts.name, { field: "name", flag: "--name", kind: "string" }, exitWithError);
     if (parsedName !== void 0) bodyFromFlags.name = parsedName;
@@ -519,14 +829,18 @@ function register(program, helpers) {
     const data = res.data?.data ?? res.data;
     printOutput(getOutputFormat(), data ?? {}, false);
   });
-  scoutsCmd.command("delete <id>").description("Delete scouts").option("--ids <ids>", "Comma-separated IDs for bulk delete (max 25)").hook("preAction", (thisCommand) => {
+  scoutsCmd.command("delete [id]").description("Delete scouts").option("--ids <ids>", "Comma-separated IDs for bulk delete (max 25)").option("--ids-file <path>", "File containing IDs for bulk delete").option("--dry-run", "Preview delete without sending requests").option("--yes", "Confirm destructive bulk delete").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (id, opts) => {
     const token = requireToken();
     if (!token) exitWithError(401, "Missing or invalid token");
-    const ids = parseIds(opts.ids);
+    const ids = await parseIdsInput(opts.ids, opts.idsFile);
     if (ids.length > 0) {
       validateBulkIds(ids, "scouts");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids.map((_id) => ({ _id, status: "would_delete" })), summary: { total: ids.length, succeeded: ids.length, failed: 0 } }, false);
+        return;
+      }
       const { data, summary } = await runBulk({
         items: ids,
         runOne: async (itemId) => {
@@ -538,12 +852,17 @@ function register(program, helpers) {
       printOutput(getOutputFormat(), { data, summary }, false);
       return;
     }
+    if (!id) exitWithError(400, "Provide id, --ids, or --ids-file");
+    if (opts.dryRun) {
+      printOutput(getOutputFormat(), { _id: id, status: "would_delete" }, false);
+      return;
+    }
     const res = await apiRequest({ method: "DELETE", path: "scouts/" + encodeURIComponent(id), token, baseUrl: getBaseUrl() });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     if (getOutputFormat() === "json") console.log(JSON.stringify({ data: null, deleted: true }));
   });
   const assetsCmd = program.command("assets").description("assets resource");
-  assetsCmd.command("list").description("List assets").option("--limit <n>", "Max results").option("--offset <n>", "Skip n results").option("--organization-id <value>", "Filter by organizationId").option("--scout-id <value>", "Filter by scoutId").hook("preAction", (thisCommand) => {
+  assetsCmd.command("list").description("List assets").option("--limit <n>", "Max results").option("--offset <n>", "Skip n results").option("--all", "Fetch all pages").option("--fields <fields>", "Comma-separated fields to print").option("--where <field=value>", "Client-side exact filters, comma-separated").option("--jsonl", "Print one compact JSON object per row").option("--organization-id <value>", "Filter by organizationId").option("--scout-id <value>", "Filter by scoutId").option("--include <value>", "Filter by include").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (opts) => {
     const token = requireToken();
@@ -557,17 +876,23 @@ function register(program, helpers) {
     if (opts.scoutId != null) {
       query.scoutId = coerceQueryFlag(opts.scoutId, { field: "scoutId", flag: "--scout-id", kind: "string" }, exitWithError);
     }
-    const res = await apiRequest({ method: "GET", path: "assets", token, baseUrl: getBaseUrl(), query });
+    if (opts.include != null) {
+      query.include = coerceQueryFlag(opts.include, { field: "include", flag: "--include", kind: "string" }, exitWithError);
+    }
+    const res = await fetchList({ path: "assets", token, baseUrl: getBaseUrl(), query, all: Boolean(opts.all), request: apiRequest });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     const data = res.data?.data ?? [];
-    printOutput(getOutputFormat(), data, false);
+    printList({ format: getOutputFormat(), data, fields: opts.fields, where: opts.where, jsonl: Boolean(opts.jsonl) });
   });
-  assetsCmd.command("get <id>").description("Get one assets by id").hook("preAction", (thisCommand) => {
+  assetsCmd.command("get <id>").description("Get one assets by id").option("--include <value>", "Include/filter by include").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (id, opts) => {
     const token = requireToken();
     if (!token) exitWithError(401, "Missing or invalid token");
     const query = {};
+    if (opts.include != null) {
+      query.include = coerceQueryFlag(opts.include, { field: "include", flag: "--include", kind: "string" }, exitWithError);
+    }
     const res = await apiRequest({ method: "GET", path: "assets/" + encodeURIComponent(id), token, baseUrl: getBaseUrl(), query });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     const data = res.data?.data ?? res.data;
@@ -607,20 +932,87 @@ function register(program, helpers) {
     if (parsedCost !== void 0) bodyFromFlags.cost = parsedCost;
     const body = mergeBody(bodyFromFlags, opts.body);
     if (opts.ifNotExists) {
+      const existing = await findExistingResource({
+        resource: "assets",
+        token,
+        baseUrl: getBaseUrl(),
+        body,
+        identityFields: ["name", "organizationId"],
+        queryFields: ["organizationId", "scoutId", "include"],
+        request: apiRequest
+      });
+      if (existing) {
+        printOutput(getOutputFormat(), existing, false);
+        return;
+      }
     }
     const res = await apiRequest({ method: "POST", path: "assets", token, baseUrl: getBaseUrl(), body });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     const data = res.data?.data ?? res.data;
     printOutput(getOutputFormat(), data ?? {}, false);
   });
-  assetsCmd.command("update <id>").description("Update assets").option("--body <json>", "Request body JSON (merged with flags)").option("--ids <ids>", "Comma-separated IDs for bulk update (max 25)").option("--name <value>", "name").option("--description <value>", "description").option("--scout-id <value>", "scoutId").option("--category-id <value>", "categoryId").option("--hero-image <value>", "heroImage").option("--condition <value>", "condition").option("--satisfaction <value>", "satisfaction").option("--usage <value>", "usage").option("--friction <value>", "friction").option("--lifetime-value <value>", "lifetimeValue").option("--acquisition-date <value>", "acquisitionDate").option("--cost <value>", "cost").hook("preAction", (thisCommand) => {
+  assetsCmd.command("update [id]").description("Update assets").option("--body <json>", "Request body JSON (merged with flags)").option("--ids <ids>", "Comma-separated IDs for bulk update (max 25)").option("--ids-file <path>", "File containing IDs for bulk update").option("--input <path>", "JSON/JSONL records for bulk update; use - for stdin").option("--dry-run", "Preview bulk update without sending requests").option("--name <value>", "name").option("--description <value>", "description").option("--scout-id <value>", "scoutId").option("--category-id <value>", "categoryId").option("--hero-image <value>", "heroImage").option("--condition <value>", "condition").option("--satisfaction <value>", "satisfaction").option("--usage <value>", "usage").option("--friction <value>", "friction").option("--lifetime-value <value>", "lifetimeValue").option("--acquisition-date <value>", "acquisitionDate").option("--cost <value>", "cost").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (id, opts) => {
     const token = requireToken();
     if (!token) exitWithError(401, "Missing or invalid token");
-    const ids = parseIds(opts.ids);
+    const inputRecords = await parseBulkInput(opts.input);
+    if (inputRecords.length > 0) {
+      const ids2 = inputRecords.map(getBulkRecordId).filter((value) => value !== null);
+      if (ids2.length !== inputRecords.length) exitWithError(400, "Each --input record must include id or _id");
+      validateBulkIds(ids2, "assets");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids2.map((_id) => ({ _id, status: "would_update" })), summary: { total: ids2.length, succeeded: ids2.length, failed: 0 } }, false);
+        return;
+      }
+      const { data: data2, summary } = await runBulk({
+        items: inputRecords,
+        runOne: async (record) => {
+          const itemId = getBulkRecordId(record);
+          const recordBody = { ...record };
+          delete recordBody.id;
+          delete recordBody._id;
+          const bodyFromFlags2 = {};
+          const parsedName2 = coerceBodyFlag(opts.name, { field: "name", flag: "--name", kind: "string" }, exitWithError);
+          if (parsedName2 !== void 0) bodyFromFlags2.name = parsedName2;
+          const parsedDescription2 = coerceBodyFlag(opts.description, { field: "description", flag: "--description", kind: "string" }, exitWithError);
+          if (parsedDescription2 !== void 0) bodyFromFlags2.description = parsedDescription2;
+          const parsedScoutId2 = coerceBodyFlag(opts.scoutId, { field: "scoutId", flag: "--scout-id", kind: "string", allowNull: true }, exitWithError);
+          if (parsedScoutId2 !== void 0) bodyFromFlags2.scoutId = parsedScoutId2;
+          const parsedCategoryId2 = coerceBodyFlag(opts.categoryId, { field: "categoryId", flag: "--category-id", kind: "string", allowNull: true }, exitWithError);
+          if (parsedCategoryId2 !== void 0) bodyFromFlags2.categoryId = parsedCategoryId2;
+          const parsedHeroImage2 = coerceBodyFlag(opts.heroImage, { field: "heroImage", flag: "--hero-image", kind: "string" }, exitWithError);
+          if (parsedHeroImage2 !== void 0) bodyFromFlags2.heroImage = parsedHeroImage2;
+          const parsedCondition2 = coerceBodyFlag(opts.condition, { field: "condition", flag: "--condition", kind: "number" }, exitWithError);
+          if (parsedCondition2 !== void 0) bodyFromFlags2.condition = parsedCondition2;
+          const parsedSatisfaction2 = coerceBodyFlag(opts.satisfaction, { field: "satisfaction", flag: "--satisfaction", kind: "number" }, exitWithError);
+          if (parsedSatisfaction2 !== void 0) bodyFromFlags2.satisfaction = parsedSatisfaction2;
+          const parsedUsage2 = coerceBodyFlag(opts.usage, { field: "usage", flag: "--usage", kind: "number" }, exitWithError);
+          if (parsedUsage2 !== void 0) bodyFromFlags2.usage = parsedUsage2;
+          const parsedFriction2 = coerceBodyFlag(opts.friction, { field: "friction", flag: "--friction", kind: "number" }, exitWithError);
+          if (parsedFriction2 !== void 0) bodyFromFlags2.friction = parsedFriction2;
+          const parsedLifetimeValue2 = coerceBodyFlag(opts.lifetimeValue, { field: "lifetimeValue", flag: "--lifetime-value", kind: "number" }, exitWithError);
+          if (parsedLifetimeValue2 !== void 0) bodyFromFlags2.lifetimeValue = parsedLifetimeValue2;
+          const parsedAcquisitionDate2 = coerceBodyFlag(opts.acquisitionDate, { field: "acquisitionDate", flag: "--acquisition-date", kind: "number" }, exitWithError);
+          if (parsedAcquisitionDate2 !== void 0) bodyFromFlags2.acquisitionDate = parsedAcquisitionDate2;
+          const parsedCost2 = coerceBodyFlag(opts.cost, { field: "cost", flag: "--cost", kind: "number" }, exitWithError);
+          if (parsedCost2 !== void 0) bodyFromFlags2.cost = parsedCost2;
+          const body2 = { ...recordBody, ...mergeBody(bodyFromFlags2, opts.body) };
+          const res2 = await apiRequest({ method: "PATCH", path: "assets/" + encodeURIComponent(itemId), token, baseUrl: getBaseUrl(), body: body2 });
+          return { ok: res2.ok, status: res2.status || 0, data: res2.data, error: res2.error };
+        },
+        toResult: (record, ok, status, _data, err) => ok ? { _id: getBulkRecordId(record), status: "updated" } : { _id: getBulkRecordId(record) ?? void 0, error: true, statusCode: status, message: err ?? "Failed" }
+      });
+      printOutput(getOutputFormat(), { data: data2, summary }, false);
+      return;
+    }
+    const ids = await parseIdsInput(opts.ids, opts.idsFile);
     if (ids.length > 0) {
       validateBulkIds(ids, "assets");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids.map((_id) => ({ _id, status: "would_update" })), summary: { total: ids.length, succeeded: ids.length, failed: 0 } }, false);
+        return;
+      }
       const { data: data2, summary } = await runBulk({
         items: ids,
         runOne: async (itemId) => {
@@ -658,6 +1050,7 @@ function register(program, helpers) {
       printOutput(getOutputFormat(), { data: data2, summary }, false);
       return;
     }
+    if (!id) exitWithError(400, "Provide id, --ids, --ids-file, or --input");
     const bodyFromFlags = {};
     const parsedName = coerceBodyFlag(opts.name, { field: "name", flag: "--name", kind: "string" }, exitWithError);
     if (parsedName !== void 0) bodyFromFlags.name = parsedName;
@@ -689,14 +1082,18 @@ function register(program, helpers) {
     const data = res.data?.data ?? res.data;
     printOutput(getOutputFormat(), data ?? {}, false);
   });
-  assetsCmd.command("delete <id>").description("Delete assets").option("--ids <ids>", "Comma-separated IDs for bulk delete (max 25)").hook("preAction", (thisCommand) => {
+  assetsCmd.command("delete [id]").description("Delete assets").option("--ids <ids>", "Comma-separated IDs for bulk delete (max 25)").option("--ids-file <path>", "File containing IDs for bulk delete").option("--dry-run", "Preview delete without sending requests").option("--yes", "Confirm destructive bulk delete").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (id, opts) => {
     const token = requireToken();
     if (!token) exitWithError(401, "Missing or invalid token");
-    const ids = parseIds(opts.ids);
+    const ids = await parseIdsInput(opts.ids, opts.idsFile);
     if (ids.length > 0) {
       validateBulkIds(ids, "assets");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids.map((_id) => ({ _id, status: "would_delete" })), summary: { total: ids.length, succeeded: ids.length, failed: 0 } }, false);
+        return;
+      }
       const { data, summary } = await runBulk({
         items: ids,
         runOne: async (itemId) => {
@@ -708,12 +1105,17 @@ function register(program, helpers) {
       printOutput(getOutputFormat(), { data, summary }, false);
       return;
     }
+    if (!id) exitWithError(400, "Provide id, --ids, or --ids-file");
+    if (opts.dryRun) {
+      printOutput(getOutputFormat(), { _id: id, status: "would_delete" }, false);
+      return;
+    }
     const res = await apiRequest({ method: "DELETE", path: "assets/" + encodeURIComponent(id), token, baseUrl: getBaseUrl() });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     if (getOutputFormat() === "json") console.log(JSON.stringify({ data: null, deleted: true }));
   });
   const categoriesCmd = program.command("categories").description("categories resource");
-  categoriesCmd.command("list").description("List categories").option("--limit <n>", "Max results").option("--offset <n>", "Skip n results").option("--organization-id <value>", "Filter by organizationId").hook("preAction", (thisCommand) => {
+  categoriesCmd.command("list").description("List categories").option("--limit <n>", "Max results").option("--offset <n>", "Skip n results").option("--all", "Fetch all pages").option("--fields <fields>", "Comma-separated fields to print").option("--where <field=value>", "Client-side exact filters, comma-separated").option("--jsonl", "Print one compact JSON object per row").option("--organization-id <value>", "Filter by organizationId").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (opts) => {
     const token = requireToken();
@@ -724,10 +1126,10 @@ function register(program, helpers) {
     if (opts.organizationId != null) {
       query.organizationId = coerceQueryFlag(opts.organizationId, { field: "organizationId", flag: "--organization-id", kind: "string" }, exitWithError);
     }
-    const res = await apiRequest({ method: "GET", path: "categories", token, baseUrl: getBaseUrl(), query });
+    const res = await fetchList({ path: "categories", token, baseUrl: getBaseUrl(), query, all: Boolean(opts.all), request: apiRequest });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     const data = res.data?.data ?? [];
-    printOutput(getOutputFormat(), data, false);
+    printList({ format: getOutputFormat(), data, fields: opts.fields, where: opts.where, jsonl: Boolean(opts.jsonl) });
   });
   categoriesCmd.command("get <id>").description("Get one categories by id").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
@@ -754,20 +1156,67 @@ function register(program, helpers) {
     if (parsedDefaultBucket !== void 0) bodyFromFlags.defaultBucket = parsedDefaultBucket;
     const body = mergeBody(bodyFromFlags, opts.body);
     if (opts.ifNotExists) {
+      const existing = await findExistingResource({
+        resource: "categories",
+        token,
+        baseUrl: getBaseUrl(),
+        body,
+        identityFields: ["name", "organizationId"],
+        queryFields: ["organizationId"],
+        request: apiRequest
+      });
+      if (existing) {
+        printOutput(getOutputFormat(), existing, false);
+        return;
+      }
     }
     const res = await apiRequest({ method: "POST", path: "categories", token, baseUrl: getBaseUrl(), body });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     const data = res.data?.data ?? res.data;
     printOutput(getOutputFormat(), data ?? {}, false);
   });
-  categoriesCmd.command("update <id>").description("Update categories").option("--body <json>", "Request body JSON (merged with flags)").option("--ids <ids>", "Comma-separated IDs for bulk update (max 25)").option("--name <value>", "name").option("--default-bucket <value>", "defaultBucket").hook("preAction", (thisCommand) => {
+  categoriesCmd.command("update [id]").description("Update categories").option("--body <json>", "Request body JSON (merged with flags)").option("--ids <ids>", "Comma-separated IDs for bulk update (max 25)").option("--ids-file <path>", "File containing IDs for bulk update").option("--input <path>", "JSON/JSONL records for bulk update; use - for stdin").option("--dry-run", "Preview bulk update without sending requests").option("--name <value>", "name").option("--default-bucket <value>", "defaultBucket").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (id, opts) => {
     const token = requireToken();
     if (!token) exitWithError(401, "Missing or invalid token");
-    const ids = parseIds(opts.ids);
+    const inputRecords = await parseBulkInput(opts.input);
+    if (inputRecords.length > 0) {
+      const ids2 = inputRecords.map(getBulkRecordId).filter((value) => value !== null);
+      if (ids2.length !== inputRecords.length) exitWithError(400, "Each --input record must include id or _id");
+      validateBulkIds(ids2, "categories");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids2.map((_id) => ({ _id, status: "would_update" })), summary: { total: ids2.length, succeeded: ids2.length, failed: 0 } }, false);
+        return;
+      }
+      const { data: data2, summary } = await runBulk({
+        items: inputRecords,
+        runOne: async (record) => {
+          const itemId = getBulkRecordId(record);
+          const recordBody = { ...record };
+          delete recordBody.id;
+          delete recordBody._id;
+          const bodyFromFlags2 = {};
+          const parsedName2 = coerceBodyFlag(opts.name, { field: "name", flag: "--name", kind: "string" }, exitWithError);
+          if (parsedName2 !== void 0) bodyFromFlags2.name = parsedName2;
+          const parsedDefaultBucket2 = coerceBodyFlag(opts.defaultBucket, { field: "defaultBucket", flag: "--default-bucket", kind: "string" }, exitWithError);
+          if (parsedDefaultBucket2 !== void 0) bodyFromFlags2.defaultBucket = parsedDefaultBucket2;
+          const body2 = { ...recordBody, ...mergeBody(bodyFromFlags2, opts.body) };
+          const res2 = await apiRequest({ method: "PATCH", path: "categories/" + encodeURIComponent(itemId), token, baseUrl: getBaseUrl(), body: body2 });
+          return { ok: res2.ok, status: res2.status || 0, data: res2.data, error: res2.error };
+        },
+        toResult: (record, ok, status, _data, err) => ok ? { _id: getBulkRecordId(record), status: "updated" } : { _id: getBulkRecordId(record) ?? void 0, error: true, statusCode: status, message: err ?? "Failed" }
+      });
+      printOutput(getOutputFormat(), { data: data2, summary }, false);
+      return;
+    }
+    const ids = await parseIdsInput(opts.ids, opts.idsFile);
     if (ids.length > 0) {
       validateBulkIds(ids, "categories");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids.map((_id) => ({ _id, status: "would_update" })), summary: { total: ids.length, succeeded: ids.length, failed: 0 } }, false);
+        return;
+      }
       const { data: data2, summary } = await runBulk({
         items: ids,
         runOne: async (itemId) => {
@@ -785,6 +1234,7 @@ function register(program, helpers) {
       printOutput(getOutputFormat(), { data: data2, summary }, false);
       return;
     }
+    if (!id) exitWithError(400, "Provide id, --ids, --ids-file, or --input");
     const bodyFromFlags = {};
     const parsedName = coerceBodyFlag(opts.name, { field: "name", flag: "--name", kind: "string" }, exitWithError);
     if (parsedName !== void 0) bodyFromFlags.name = parsedName;
@@ -796,14 +1246,18 @@ function register(program, helpers) {
     const data = res.data?.data ?? res.data;
     printOutput(getOutputFormat(), data ?? {}, false);
   });
-  categoriesCmd.command("delete <id>").description("Delete categories").option("--ids <ids>", "Comma-separated IDs for bulk delete (max 25)").hook("preAction", (thisCommand) => {
+  categoriesCmd.command("delete [id]").description("Delete categories").option("--ids <ids>", "Comma-separated IDs for bulk delete (max 25)").option("--ids-file <path>", "File containing IDs for bulk delete").option("--dry-run", "Preview delete without sending requests").option("--yes", "Confirm destructive bulk delete").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (id, opts) => {
     const token = requireToken();
     if (!token) exitWithError(401, "Missing or invalid token");
-    const ids = parseIds(opts.ids);
+    const ids = await parseIdsInput(opts.ids, opts.idsFile);
     if (ids.length > 0) {
       validateBulkIds(ids, "categories");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids.map((_id) => ({ _id, status: "would_delete" })), summary: { total: ids.length, succeeded: ids.length, failed: 0 } }, false);
+        return;
+      }
       const { data, summary } = await runBulk({
         items: ids,
         runOne: async (itemId) => {
@@ -815,12 +1269,17 @@ function register(program, helpers) {
       printOutput(getOutputFormat(), { data, summary }, false);
       return;
     }
+    if (!id) exitWithError(400, "Provide id, --ids, or --ids-file");
+    if (opts.dryRun) {
+      printOutput(getOutputFormat(), { _id: id, status: "would_delete" }, false);
+      return;
+    }
     const res = await apiRequest({ method: "DELETE", path: "categories/" + encodeURIComponent(id), token, baseUrl: getBaseUrl() });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     if (getOutputFormat() === "json") console.log(JSON.stringify({ data: null, deleted: true }));
   });
   const labelsCmd = program.command("labels").description("labels resource");
-  labelsCmd.command("list").description("List labels").option("--limit <n>", "Max results").option("--offset <n>", "Skip n results").option("--organization-id <value>", "Filter by organizationId").hook("preAction", (thisCommand) => {
+  labelsCmd.command("list").description("List labels").option("--limit <n>", "Max results").option("--offset <n>", "Skip n results").option("--all", "Fetch all pages").option("--fields <fields>", "Comma-separated fields to print").option("--where <field=value>", "Client-side exact filters, comma-separated").option("--jsonl", "Print one compact JSON object per row").option("--organization-id <value>", "Filter by organizationId").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (opts) => {
     const token = requireToken();
@@ -831,10 +1290,10 @@ function register(program, helpers) {
     if (opts.organizationId != null) {
       query.organizationId = coerceQueryFlag(opts.organizationId, { field: "organizationId", flag: "--organization-id", kind: "string" }, exitWithError);
     }
-    const res = await apiRequest({ method: "GET", path: "labels", token, baseUrl: getBaseUrl(), query });
+    const res = await fetchList({ path: "labels", token, baseUrl: getBaseUrl(), query, all: Boolean(opts.all), request: apiRequest });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     const data = res.data?.data ?? [];
-    printOutput(getOutputFormat(), data, false);
+    printList({ format: getOutputFormat(), data, fields: opts.fields, where: opts.where, jsonl: Boolean(opts.jsonl) });
   });
   labelsCmd.command("get <id>").description("Get one labels by id").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
@@ -861,20 +1320,67 @@ function register(program, helpers) {
     if (parsedColour !== void 0) bodyFromFlags.colour = parsedColour;
     const body = mergeBody(bodyFromFlags, opts.body);
     if (opts.ifNotExists) {
+      const existing = await findExistingResource({
+        resource: "labels",
+        token,
+        baseUrl: getBaseUrl(),
+        body,
+        identityFields: ["name", "organizationId"],
+        queryFields: ["organizationId"],
+        request: apiRequest
+      });
+      if (existing) {
+        printOutput(getOutputFormat(), existing, false);
+        return;
+      }
     }
     const res = await apiRequest({ method: "POST", path: "labels", token, baseUrl: getBaseUrl(), body });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     const data = res.data?.data ?? res.data;
     printOutput(getOutputFormat(), data ?? {}, false);
   });
-  labelsCmd.command("update <id>").description("Update labels").option("--body <json>", "Request body JSON (merged with flags)").option("--ids <ids>", "Comma-separated IDs for bulk update (max 25)").option("--name <value>", "name").option("--colour <value>", "colour").hook("preAction", (thisCommand) => {
+  labelsCmd.command("update [id]").description("Update labels").option("--body <json>", "Request body JSON (merged with flags)").option("--ids <ids>", "Comma-separated IDs for bulk update (max 25)").option("--ids-file <path>", "File containing IDs for bulk update").option("--input <path>", "JSON/JSONL records for bulk update; use - for stdin").option("--dry-run", "Preview bulk update without sending requests").option("--name <value>", "name").option("--colour <value>", "colour").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (id, opts) => {
     const token = requireToken();
     if (!token) exitWithError(401, "Missing or invalid token");
-    const ids = parseIds(opts.ids);
+    const inputRecords = await parseBulkInput(opts.input);
+    if (inputRecords.length > 0) {
+      const ids2 = inputRecords.map(getBulkRecordId).filter((value) => value !== null);
+      if (ids2.length !== inputRecords.length) exitWithError(400, "Each --input record must include id or _id");
+      validateBulkIds(ids2, "labels");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids2.map((_id) => ({ _id, status: "would_update" })), summary: { total: ids2.length, succeeded: ids2.length, failed: 0 } }, false);
+        return;
+      }
+      const { data: data2, summary } = await runBulk({
+        items: inputRecords,
+        runOne: async (record) => {
+          const itemId = getBulkRecordId(record);
+          const recordBody = { ...record };
+          delete recordBody.id;
+          delete recordBody._id;
+          const bodyFromFlags2 = {};
+          const parsedName2 = coerceBodyFlag(opts.name, { field: "name", flag: "--name", kind: "string" }, exitWithError);
+          if (parsedName2 !== void 0) bodyFromFlags2.name = parsedName2;
+          const parsedColour2 = coerceBodyFlag(opts.colour, { field: "colour", flag: "--colour", kind: "string" }, exitWithError);
+          if (parsedColour2 !== void 0) bodyFromFlags2.colour = parsedColour2;
+          const body2 = { ...recordBody, ...mergeBody(bodyFromFlags2, opts.body) };
+          const res2 = await apiRequest({ method: "PATCH", path: "labels/" + encodeURIComponent(itemId), token, baseUrl: getBaseUrl(), body: body2 });
+          return { ok: res2.ok, status: res2.status || 0, data: res2.data, error: res2.error };
+        },
+        toResult: (record, ok, status, _data, err) => ok ? { _id: getBulkRecordId(record), status: "updated" } : { _id: getBulkRecordId(record) ?? void 0, error: true, statusCode: status, message: err ?? "Failed" }
+      });
+      printOutput(getOutputFormat(), { data: data2, summary }, false);
+      return;
+    }
+    const ids = await parseIdsInput(opts.ids, opts.idsFile);
     if (ids.length > 0) {
       validateBulkIds(ids, "labels");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids.map((_id) => ({ _id, status: "would_update" })), summary: { total: ids.length, succeeded: ids.length, failed: 0 } }, false);
+        return;
+      }
       const { data: data2, summary } = await runBulk({
         items: ids,
         runOne: async (itemId) => {
@@ -892,6 +1398,7 @@ function register(program, helpers) {
       printOutput(getOutputFormat(), { data: data2, summary }, false);
       return;
     }
+    if (!id) exitWithError(400, "Provide id, --ids, --ids-file, or --input");
     const bodyFromFlags = {};
     const parsedName = coerceBodyFlag(opts.name, { field: "name", flag: "--name", kind: "string" }, exitWithError);
     if (parsedName !== void 0) bodyFromFlags.name = parsedName;
@@ -903,14 +1410,18 @@ function register(program, helpers) {
     const data = res.data?.data ?? res.data;
     printOutput(getOutputFormat(), data ?? {}, false);
   });
-  labelsCmd.command("delete <id>").description("Delete labels").option("--ids <ids>", "Comma-separated IDs for bulk delete (max 25)").hook("preAction", (thisCommand) => {
+  labelsCmd.command("delete [id]").description("Delete labels").option("--ids <ids>", "Comma-separated IDs for bulk delete (max 25)").option("--ids-file <path>", "File containing IDs for bulk delete").option("--dry-run", "Preview delete without sending requests").option("--yes", "Confirm destructive bulk delete").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (id, opts) => {
     const token = requireToken();
     if (!token) exitWithError(401, "Missing or invalid token");
-    const ids = parseIds(opts.ids);
+    const ids = await parseIdsInput(opts.ids, opts.idsFile);
     if (ids.length > 0) {
       validateBulkIds(ids, "labels");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids.map((_id) => ({ _id, status: "would_delete" })), summary: { total: ids.length, succeeded: ids.length, failed: 0 } }, false);
+        return;
+      }
       const { data, summary } = await runBulk({
         items: ids,
         runOne: async (itemId) => {
@@ -922,12 +1433,17 @@ function register(program, helpers) {
       printOutput(getOutputFormat(), { data, summary }, false);
       return;
     }
+    if (!id) exitWithError(400, "Provide id, --ids, or --ids-file");
+    if (opts.dryRun) {
+      printOutput(getOutputFormat(), { _id: id, status: "would_delete" }, false);
+      return;
+    }
     const res = await apiRequest({ method: "DELETE", path: "labels/" + encodeURIComponent(id), token, baseUrl: getBaseUrl() });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     if (getOutputFormat() === "json") console.log(JSON.stringify({ data: null, deleted: true }));
   });
   const viewsCmd = program.command("views").description("views resource");
-  viewsCmd.command("list").description("List views").option("--limit <n>", "Max results").option("--offset <n>", "Skip n results").option("--organization-id <value>", "Filter by organizationId").option("--project-id <value>", "Filter by projectId").option("--entity-type <value>", "Filter by entityType").hook("preAction", (thisCommand) => {
+  viewsCmd.command("list").description("List views").option("--limit <n>", "Max results").option("--offset <n>", "Skip n results").option("--all", "Fetch all pages").option("--fields <fields>", "Comma-separated fields to print").option("--where <field=value>", "Client-side exact filters, comma-separated").option("--jsonl", "Print one compact JSON object per row").option("--organization-id <value>", "Filter by organizationId").option("--project-id <value>", "Filter by projectId").option("--entity-type <value>", "Filter by entityType").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (opts) => {
     const token = requireToken();
@@ -944,10 +1460,10 @@ function register(program, helpers) {
     if (opts.entityType != null) {
       query.entityType = coerceQueryFlag(opts.entityType, { field: "entityType", flag: "--entity-type", kind: "string" }, exitWithError);
     }
-    const res = await apiRequest({ method: "GET", path: "views", token, baseUrl: getBaseUrl(), query });
+    const res = await fetchList({ path: "views", token, baseUrl: getBaseUrl(), query, all: Boolean(opts.all), request: apiRequest });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     const data = res.data?.data ?? [];
-    printOutput(getOutputFormat(), data, false);
+    printList({ format: getOutputFormat(), data, fields: opts.fields, where: opts.where, jsonl: Boolean(opts.jsonl) });
   });
   viewsCmd.command("get <id>").description("Get one views by id").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
@@ -980,20 +1496,71 @@ function register(program, helpers) {
     if (parsedIsDefault !== void 0) bodyFromFlags.isDefault = parsedIsDefault;
     const body = mergeBody(bodyFromFlags, opts.body);
     if (opts.ifNotExists) {
+      const existing = await findExistingResource({
+        resource: "views",
+        token,
+        baseUrl: getBaseUrl(),
+        body,
+        identityFields: ["name", "entityType", "organizationId", "projectId"],
+        queryFields: ["organizationId", "projectId", "entityType"],
+        request: apiRequest
+      });
+      if (existing) {
+        printOutput(getOutputFormat(), existing, false);
+        return;
+      }
     }
     const res = await apiRequest({ method: "POST", path: "views", token, baseUrl: getBaseUrl(), body });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     const data = res.data?.data ?? res.data;
     printOutput(getOutputFormat(), data ?? {}, false);
   });
-  viewsCmd.command("update <id>").description("Update views").option("--body <json>", "Request body JSON (merged with flags)").option("--ids <ids>", "Comma-separated IDs for bulk update (max 25)").option("--name <value>", "name").option("--project-id <value>", "projectId").option("--config <value>", "config").option("--is-default <value>", "isDefault").hook("preAction", (thisCommand) => {
+  viewsCmd.command("update [id]").description("Update views").option("--body <json>", "Request body JSON (merged with flags)").option("--ids <ids>", "Comma-separated IDs for bulk update (max 25)").option("--ids-file <path>", "File containing IDs for bulk update").option("--input <path>", "JSON/JSONL records for bulk update; use - for stdin").option("--dry-run", "Preview bulk update without sending requests").option("--name <value>", "name").option("--project-id <value>", "projectId").option("--config <value>", "config").option("--is-default <value>", "isDefault").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (id, opts) => {
     const token = requireToken();
     if (!token) exitWithError(401, "Missing or invalid token");
-    const ids = parseIds(opts.ids);
+    const inputRecords = await parseBulkInput(opts.input);
+    if (inputRecords.length > 0) {
+      const ids2 = inputRecords.map(getBulkRecordId).filter((value) => value !== null);
+      if (ids2.length !== inputRecords.length) exitWithError(400, "Each --input record must include id or _id");
+      validateBulkIds(ids2, "views");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids2.map((_id) => ({ _id, status: "would_update" })), summary: { total: ids2.length, succeeded: ids2.length, failed: 0 } }, false);
+        return;
+      }
+      const { data: data2, summary } = await runBulk({
+        items: inputRecords,
+        runOne: async (record) => {
+          const itemId = getBulkRecordId(record);
+          const recordBody = { ...record };
+          delete recordBody.id;
+          delete recordBody._id;
+          const bodyFromFlags2 = {};
+          const parsedName2 = coerceBodyFlag(opts.name, { field: "name", flag: "--name", kind: "string" }, exitWithError);
+          if (parsedName2 !== void 0) bodyFromFlags2.name = parsedName2;
+          const parsedProjectId2 = coerceBodyFlag(opts.projectId, { field: "projectId", flag: "--project-id", kind: "string" }, exitWithError);
+          if (parsedProjectId2 !== void 0) bodyFromFlags2.projectId = parsedProjectId2;
+          const parsedConfig2 = coerceBodyFlag(opts.config, { field: "config", flag: "--config", kind: "string" }, exitWithError);
+          if (parsedConfig2 !== void 0) bodyFromFlags2.config = parsedConfig2;
+          const parsedIsDefault2 = coerceBodyFlag(opts.isDefault, { field: "isDefault", flag: "--is-default", kind: "boolean" }, exitWithError);
+          if (parsedIsDefault2 !== void 0) bodyFromFlags2.isDefault = parsedIsDefault2;
+          const body2 = { ...recordBody, ...mergeBody(bodyFromFlags2, opts.body) };
+          const res2 = await apiRequest({ method: "PATCH", path: "views/" + encodeURIComponent(itemId), token, baseUrl: getBaseUrl(), body: body2 });
+          return { ok: res2.ok, status: res2.status || 0, data: res2.data, error: res2.error };
+        },
+        toResult: (record, ok, status, _data, err) => ok ? { _id: getBulkRecordId(record), status: "updated" } : { _id: getBulkRecordId(record) ?? void 0, error: true, statusCode: status, message: err ?? "Failed" }
+      });
+      printOutput(getOutputFormat(), { data: data2, summary }, false);
+      return;
+    }
+    const ids = await parseIdsInput(opts.ids, opts.idsFile);
     if (ids.length > 0) {
       validateBulkIds(ids, "views");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids.map((_id) => ({ _id, status: "would_update" })), summary: { total: ids.length, succeeded: ids.length, failed: 0 } }, false);
+        return;
+      }
       const { data: data2, summary } = await runBulk({
         items: ids,
         runOne: async (itemId) => {
@@ -1015,6 +1582,7 @@ function register(program, helpers) {
       printOutput(getOutputFormat(), { data: data2, summary }, false);
       return;
     }
+    if (!id) exitWithError(400, "Provide id, --ids, --ids-file, or --input");
     const bodyFromFlags = {};
     const parsedName = coerceBodyFlag(opts.name, { field: "name", flag: "--name", kind: "string" }, exitWithError);
     if (parsedName !== void 0) bodyFromFlags.name = parsedName;
@@ -1030,14 +1598,18 @@ function register(program, helpers) {
     const data = res.data?.data ?? res.data;
     printOutput(getOutputFormat(), data ?? {}, false);
   });
-  viewsCmd.command("delete <id>").description("Delete views").option("--ids <ids>", "Comma-separated IDs for bulk delete (max 25)").hook("preAction", (thisCommand) => {
+  viewsCmd.command("delete [id]").description("Delete views").option("--ids <ids>", "Comma-separated IDs for bulk delete (max 25)").option("--ids-file <path>", "File containing IDs for bulk delete").option("--dry-run", "Preview delete without sending requests").option("--yes", "Confirm destructive bulk delete").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (id, opts) => {
     const token = requireToken();
     if (!token) exitWithError(401, "Missing or invalid token");
-    const ids = parseIds(opts.ids);
+    const ids = await parseIdsInput(opts.ids, opts.idsFile);
     if (ids.length > 0) {
       validateBulkIds(ids, "views");
+      if (opts.dryRun) {
+        printOutput(getOutputFormat(), { data: ids.map((_id) => ({ _id, status: "would_delete" })), summary: { total: ids.length, succeeded: ids.length, failed: 0 } }, false);
+        return;
+      }
       const { data, summary } = await runBulk({
         items: ids,
         runOne: async (itemId) => {
@@ -1049,12 +1621,17 @@ function register(program, helpers) {
       printOutput(getOutputFormat(), { data, summary }, false);
       return;
     }
+    if (!id) exitWithError(400, "Provide id, --ids, or --ids-file");
+    if (opts.dryRun) {
+      printOutput(getOutputFormat(), { _id: id, status: "would_delete" }, false);
+      return;
+    }
     const res = await apiRequest({ method: "DELETE", path: "views/" + encodeURIComponent(id), token, baseUrl: getBaseUrl() });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     if (getOutputFormat() === "json") console.log(JSON.stringify({ data: null, deleted: true }));
   });
   const commentsCmd = program.command("comments").description("comments resource");
-  commentsCmd.command("list").description("List comments").option("--limit <n>", "Max results").option("--offset <n>", "Skip n results").option("--entity-type <value>", "Filter by entityType").option("--entity-id <value>", "Filter by entityId").hook("preAction", (thisCommand) => {
+  commentsCmd.command("list").description("List comments").option("--limit <n>", "Max results").option("--offset <n>", "Skip n results").option("--all", "Fetch all pages").option("--fields <fields>", "Comma-separated fields to print").option("--where <field=value>", "Client-side exact filters, comma-separated").option("--jsonl", "Print one compact JSON object per row").option("--entity-type <value>", "Filter by entityType").option("--entity-id <value>", "Filter by entityId").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
   }).action(async (opts) => {
     const token = requireToken();
@@ -1068,10 +1645,10 @@ function register(program, helpers) {
     if (opts.entityId != null) {
       query.entityId = coerceQueryFlag(opts.entityId, { field: "entityId", flag: "--entity-id", kind: "string" }, exitWithError);
     }
-    const res = await apiRequest({ method: "GET", path: "comments", token, baseUrl: getBaseUrl(), query });
+    const res = await fetchList({ path: "comments", token, baseUrl: getBaseUrl(), query, all: Boolean(opts.all), request: apiRequest });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
     const data = res.data?.data ?? [];
-    printOutput(getOutputFormat(), data, false);
+    printList({ format: getOutputFormat(), data, fields: opts.fields, where: opts.where, jsonl: Boolean(opts.jsonl) });
   });
   commentsCmd.command("create").description("Create comments").option("--body <json>", "Request body JSON (merged with flags)").option("--entity-type <value>", "entityType").option("--entity-id <value>", "entityId").option("--text <value>", "body").option("--parent-comment-id <value>", "parentCommentId").option("--if-not-exists", "Return existing if match found").hook("preAction", (thisCommand) => {
     syncRootOptsFromCommand(thisCommand);
@@ -1089,6 +1666,19 @@ function register(program, helpers) {
     if (parsedParentCommentId !== void 0) bodyFromFlags.parentCommentId = parsedParentCommentId;
     const body = mergeBody(bodyFromFlags, opts.body);
     if (opts.ifNotExists) {
+      const existing = await findExistingResource({
+        resource: "comments",
+        token,
+        baseUrl: getBaseUrl(),
+        body,
+        identityFields: ["entityType", "entityId"],
+        queryFields: ["entityType", "entityId"],
+        request: apiRequest
+      });
+      if (existing) {
+        printOutput(getOutputFormat(), existing, false);
+        return;
+      }
     }
     const res = await apiRequest({ method: "POST", path: "comments", token, baseUrl: getBaseUrl(), body });
     if (!res.ok) exitWithError(res.status || 500, res.error ?? "Request failed");
@@ -1099,4 +1689,4 @@ function register(program, helpers) {
 export {
   register
 };
-//# sourceMappingURL=generated-IFLUY7PB.js.map
+//# sourceMappingURL=generated-7QDIZ5V5.js.map