@erdoai/cli 0.77.0 → 0.78.0

package/dist/index.js

@@ -940,8 +940,14 @@ var ErdoClient = class {
   }
   // The org's dataset vocabulary: every purpose in use, its description, and
   // the dataset that established it (the canonical write target for that role).
-  listDatasetPurposes() {
-    return this.request("GET", `/v1/datasets-purposes`);
+  // scope="managed" reads the same across every client organization a manager
+  // account operates; each entry then names its organization and its
+  // established_by slug is org-qualified, so it can be queried as-is.
+  listDatasetPurposes(params) {
+    const q = new URLSearchParams();
+    if (params?.scope) q.set("scope", params.scope);
+    const qs = q.toString();
+    return this.request("GET", `/v1/datasets-purposes${qs ? `?${qs}` : ""}`);
   }
   // Correct which dataset carries a purpose. Pass `purpose` to set one,
   // `clear_purpose` to remove it; moving a purpose is clearing it from the old
@@ -4977,17 +4983,28 @@ datasetsCmd.command("list").description("List datasets").option(
 });
 datasetsCmd.command("purposes").description(
   "List the org's dataset purposes \u2014 the vocabulary of dataset roles in use (e.g. leads, page events). The established_by slug is the canonical dataset for that role: write there rather than creating a sibling (one purpose = one dataset per org)."
-).action(async () => {
+).option(
+  "--scope <own|managed>",
+  "whose vocabulary to read: own (default) or managed, which reads every client organization a manager account operates and prints the organization alongside each purpose"
+).action(async (opts) => {
   try {
-    const { purposes } = await new ErdoClient().listDatasetPurposes();
+    const scope = opts.scope?.toLowerCase();
+    if (scope && scope !== "own" && scope !== "managed") {
+      fail(new Error("--scope must be own or managed"));
+      return;
+    }
+    const { purposes, message } = await new ErdoClient().listDatasetPurposes({ scope });
     if (purposes.length === 0) {
-      console.error("(no dataset purposes established yet)");
+      console.error(message ? `(${message})` : "(no dataset purposes established yet)");
       return;
     }
-    for (const p of purposes)
+    for (const p of purposes) {
+      const target = p.established_by_dataset_slug ?? p.established_by_dataset_id;
+      const count = `${p.dataset_count} dataset${p.dataset_count === 1 ? "" : "s"}`;
       console.log(
-        `${p.purpose}	${p.established_by_dataset_slug ?? p.established_by_dataset_id}	${p.dataset_count} dataset${p.dataset_count === 1 ? "" : "s"}	${p.description}`
+        scope === "managed" ? `${p.organization_slug ?? "-"}	${p.purpose}	${target}	${count}	${p.description}` : `${p.purpose}	${target}	${count}	${p.description}`
       );
+    }
   } catch (e) {
     fail(e);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@erdoai/cli",
-  "version": "0.77.0",
+  "version": "0.78.0",
   "description": "Erdo CLI \u2014 drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {