@erdoai/cli 0.76.0 → 0.78.0

package/dist/index.js

@@ -4,7 +4,7 @@
 import { readFileSync as readFileSync4 } from "fs";
 import { basename } from "path";
 import { select } from "@inquirer/prompts";
-import { Command } from "commander";
+import { Command as Command2 } from "commander";
 
 // src/config.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
@@ -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
@@ -1582,6 +1588,32 @@ function readMaybeFile(value) {
   return value.startsWith("@") ? readFileSync2(value.slice(1), "utf8") : value;
 }
 
+// src/scope.ts
+import { Option } from "commander";
+var ORG_ENV = "ERDO_ORG";
+var PROJECT_ENV = "ERDO_PROJECT";
+function bindScopeFlags(program2) {
+  program2.option("--org <idOrSlug>", "org to target for this command (overrides the active org)").option(
+    "--project <slugOrId>",
+    "project context for this command \u2014 slug or UUID (must belong to the active org)"
+  );
+  program2.on("option:org", (value) => {
+    process.env[ORG_ENV] = value;
+  });
+  program2.on("option:project", (value) => {
+    process.env[PROJECT_ENV] = value;
+  });
+  return program2;
+}
+function projectOption(description, opts = {}) {
+  const option = new Option("--project <slug>", description).env(PROJECT_ENV);
+  if (opts.mandatory) option.makeOptionMandatory();
+  return option;
+}
+function orgOption(description) {
+  return new Option("--org <idOrSlug>", description).env(ORG_ENV);
+}
+
 // src/update.ts
 import { spawn as spawn2, spawnSync } from "child_process";
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
@@ -1796,14 +1828,9 @@ function compactEvalRunAttribution(run) {
   ].filter((part) => part !== void 0);
   return [run.triggered_by, ...revisions].join("	");
 }
-var program = new Command();
-program.name("erdo").description("Erdo CLI").version(pkg.version).option("--org <idOrSlug>", "org to target for this command (overrides the active org)").option("--project <uuid>", "project context for this command (must belong to the active org)");
-program.hook("preAction", (thisCommand) => {
-  const opts = thisCommand.opts();
-  const org2 = opts.org;
-  if (org2) process.env.ERDO_ORG = org2;
-  if (opts.project) process.env.ERDO_PROJECT = opts.project;
-});
+var program = new Command2();
+program.name("erdo").description("Erdo CLI").version(pkg.version);
+bindScopeFlags(program);
 async function doLogin(opts) {
   let token;
   let me;
@@ -2170,7 +2197,9 @@ This key operates every org you manage; target one with X-Organization-ID (or \`
   }
 });
 var tokenCmd = program.command("token").description("Manage your API tokens (account-level credentials)");
-tokenCmd.command("create").description("Mint a new API token; the secret is printed ONCE").requiredOption("--name <name>", "a label for the token").option("--expires-days <n>", "days until expiry (default: 30)", (v) => parseInt(v, 10)).option("--org <idOrSlug>", "the token's default org (defaults to your active org; must be one you belong to)").action(async (opts) => {
+tokenCmd.command("create").description("Mint a new API token; the secret is printed ONCE").requiredOption("--name <name>", "a label for the token").option("--expires-days <n>", "days until expiry (default: 30)", (v) => parseInt(v, 10)).addOption(
+  orgOption("the token's default org (defaults to your active org; must be one you belong to)")
+).action(async (opts) => {
   try {
     const res = await new ErdoClient().createToken({
       name: opts.name,
@@ -2272,7 +2301,7 @@ wsCmd.command("get <slug>").description("Show a workstream \u2014 status, phases
     fail(e);
   }
 });
-wsCmd.command("create").description("Create a workstream in a project").requiredOption("--project <slug>", "project slug").requiredOption("--slug <slug>", "workstream slug (unique per org)").requiredOption("--title <title>", "human-readable title").option("--description <text>", "free-form description").option(
+wsCmd.command("create").description("Create a workstream in a project").addOption(projectOption("project slug", { mandatory: true })).requiredOption("--slug <slug>", "workstream slug (unique per org)").requiredOption("--title <title>", "human-readable title").option("--description <text>", "free-form description").option(
   "--token-budget <millicents>",
   "spend ceiling in millicents \u2014 100,000 per dollar, so 10000000 = $100 and 25000000 = $250; omit for unlimited",
   (v) => parseInt(v, 10)
@@ -2566,7 +2595,7 @@ expCmd.command("policy <slug>").description(
     fail(e);
   }
 });
-expCmd.command("create").description("Create an experiment with its variants, evidence datasets and decision rule").requiredOption("--project <slug>", "project slug").requiredOption("--slug <slug>", "experiment slug (unique per org)").requiredOption("--title <title>", "title").option("--workstream <slug>", "host workstream").option("--scope <scope>", "local (default), platform_canary, platform_global").option("--hypothesis <text>", "hypothesis markdown").option("--primary-metric <metric>", "the metric the decision rule reads").option("--decision-rule <text>", "the rule that decides ship/stop from the primary metric").option("--guardrail <metric>", "a metric that must not regress (repeatable)", collect, []).option(
+expCmd.command("create").description("Create an experiment with its variants, evidence datasets and decision rule").addOption(projectOption("project slug", { mandatory: true })).requiredOption("--slug <slug>", "experiment slug (unique per org)").requiredOption("--title <title>", "title").option("--workstream <slug>", "host workstream").option("--scope <scope>", "local (default), platform_canary, platform_global").option("--hypothesis <text>", "hypothesis markdown").option("--primary-metric <metric>", "the metric the decision rule reads").option("--decision-rule <text>", "the rule that decides ship/stop from the primary metric").option("--guardrail <metric>", "a metric that must not regress (repeatable)", collect, []).option(
   "--variant <spec>",
   `a variant "key=b,label=3-field form,page=<artifact-id>,alloc=50,class=form_length_change,control" (repeatable). Fields: key=, label=, page= (Erdo artifact id) OR url=<https://\u2026> (an external page the persona panel visits, e.g. a client's live landing page \u2014 mutually exclusive with page=), alloc=, class=, and the bare flag control (or control=true) to mark the baseline. class= declares the structural change vs control for cross-experiment learning: headline_change | hero_media_change | cta_change | form_length_change | social_proof_add | layout_reorder | offer_change | full_page_rebuild`,
   collect,
@@ -2704,7 +2733,7 @@ expCmd.command("set-status <slug> <status>").description("Set an experiment's st
 });
 expCmd.command("calibration").description(
   "Read each judge's track record \u2014 paired predictions and pairwise agreement vs measured reality (the trust dial)"
-).option("--project <slug>", "limit to one project (default: every project you can view)").option("--judge <slug>", "show only judges whose slug contains this text").option("-n, --limit <n>", "max ledger rows scanned (default 5000)", (v) => parseInt(v, 10)).action(async (opts) => {
+).addOption(projectOption("limit to one project (default: every project you can view)")).option("--judge <slug>", "show only judges whose slug contains this text").option("-n, --limit <n>", "max ledger rows scanned (default 5000)", (v) => parseInt(v, 10)).action(async (opts) => {
   try {
     const res = await new ErdoClient().judgeCalibration({
       project_slug: opts.project,
@@ -4954,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.76.0",
+  "version": "0.78.0",
   "description": "Erdo CLI \u2014 drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {