@erdoai/cli 0.99.0 → 0.101.0

package/dist/index.js

@@ -1072,17 +1072,20 @@ var ErdoClient = class {
     const qs = q.toString();
     return this.request("GET", `/v1/datasets${qs ? `?${qs}` : ""}`);
   }
-  // The org's dataset vocabulary: every purpose in use, its description, and
-  // the dataset that established it (the canonical write target for that role).
+  // The org's dataset vocabulary: every purpose in use, its current dataset,
+  // and the declared producer contract on that same dataset.
   // 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.
+  // current dataset 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}` : ""}`);
   }
+  ensureDataset(input) {
+    return this.request("POST", "/v1/datasets-ensure", input);
+  }
   // 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
   // dataset and setting it on the right one. Setting a purpose the org already
@@ -4132,7 +4135,7 @@ function renderDecision(detail) {
     ["class", d.decision_class],
     ["source", d.source],
     ["applies", d.applicability === "standing" ? "standing (until superseded)" : "one-off authorization"],
-    ["decided by", d.decider_kind]
+    ["decided by", d.decided_by_name ? `${d.decided_by_name} (${d.decider_kind})` : d.decider_kind]
   ];
   if (d.subject_label) facts.push(["subject", d.subject_label]);
   if (d.execution_status) facts.push(["execution", d.execution_status]);
@@ -4545,7 +4548,7 @@ function renderAttentionItemReport(item, report) {
       console.log(`  ${d.slug} \u2014 ${d.what}`);
       if (d.why) console.log(`    why: ${d.why}`);
       if (d.alternatives_considered) console.log(`    alternatives considered: ${d.alternatives_considered}`);
-      console.log(`    decided by: ${d.decider_kind}`);
+      console.log(`    decided by: ${d.decided_by_name ? `${d.decided_by_name} (${d.decider_kind})` : d.decider_kind}`);
       console.log(`    status: ${d.status}`);
       if (d.outcome_label) console.log(`    outcome: ${d.outcome_label}`);
     } else {
@@ -6097,7 +6100,7 @@ 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)."
+  "List the org's dataset purposes \u2014 the vocabulary of dataset roles in use (e.g. leads, page events). Each purpose resolves to the current dataset and its declared schema: write there rather than creating a sibling (one purpose = one dataset per org)."
 ).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"
@@ -6114,7 +6117,7 @@ datasetsCmd.command("purposes").description(
       return;
     }
     for (const p of purposes) {
-      const target = p.established_by_dataset_slug ?? p.established_by_dataset_id;
+      const target = p.dataset_count > 1 ? `(split: ${p.dataset_count} datasets)` : p.dataset_slug ?? p.dataset_id ?? "(unbound)";
       const count = `${p.dataset_count} dataset${p.dataset_count === 1 ? "" : "s"}`;
       console.log(
         scope === "managed" ? `${p.organization_slug ?? "-"}	${p.purpose}	${target}	${count}	${p.description}` : `${p.purpose}	${target}	${count}	${p.description}`
@@ -6124,6 +6127,30 @@ datasetsCmd.command("purposes").description(
     fail(e);
   }
 });
+datasetsCmd.command("ensure <purpose>").description(
+  "Create or reuse the one dataset for a purpose and verify its declared producer contract. Refuses legacy splits and incompatible populated datasets instead of choosing silently."
+).requiredOption("--schema <file>", "JSON file containing { columns: [...] } or a columns array").option("--name <name>", "dataset name when creation is required").option("--description <text>", "dataset description when creation is required").option("--purpose-description <text>", "what writes and reads this purpose").option("--preferred-dataset <slug>", "existing bound dataset slug or id to adopt").option("--email-column <name>", "for a leads purpose: which declared column holds the email (default email)").option("--phone-column <name>", "for a leads purpose: which declared column holds the phone (default phone)").action(async (purpose, opts) => {
+  try {
+    const parsed = JSON.parse(readFileSync4(opts.schema, "utf8"));
+    const declaredSchema = Array.isArray(parsed) ? { columns: parsed } : parsed;
+    if (!declaredSchema || !Array.isArray(declaredSchema.columns)) {
+      throw new Error('--schema must contain a JSON columns array or {"columns": [...]} object');
+    }
+    const result = await new ErdoClient().ensureDataset({
+      purpose,
+      ...opts.name ? { name: opts.name } : {},
+      ...opts.description ? { description: opts.description } : {},
+      ...opts.purposeDescription ? { purpose_description: opts.purposeDescription } : {},
+      ...opts.preferredDataset ? { preferred_dataset: opts.preferredDataset } : {},
+      ...opts.emailColumn ? { email_column: opts.emailColumn } : {},
+      ...opts.phoneColumn ? { phone_column: opts.phoneColumn } : {},
+      declared_schema: declaredSchema
+    });
+    console.log(`${result.slug}	${result.created ? "created" : "reused"}	${result.purpose}`);
+  } catch (e) {
+    fail(e);
+  }
+});
 datasetsCmd.command("set-purpose <slug> [purpose]").description(
   "Set (or with --clear, remove) the dataset's purpose \u2014 the org-vocabulary role `datasets purposes` reports. Use it to CORRECT a purpose that names the wrong dataset: one purpose maps to one dataset per org, so a purpose left on the wrong one points everything that resolves through the vocabulary at the wrong rows. Moving a purpose is two calls \u2014 clear it from the old dataset, set it on the right one. Setting a purpose the org already uses elsewhere succeeds and prints a warning naming what it now shadows."
 ).option("--clear", "remove the dataset's purpose instead of setting one").option(
@@ -7432,7 +7459,7 @@ pipelinesCmd.command("get <slug>").description("Show one event pipeline \u2014 s
 });
 pipelinesCmd.command("update <slug>").description(
   "Update an event pipeline's editable fields \u2014 omitted fields keep their current values (merge). Use get first for the current transform/actions; --transform-js/--pipeline accept @file"
-).option("--name <name>", "new name").option("--description <description>", "new description").option("--state <state>", "new state: active, disabled, or proposed").option("--transform-js <jsOr@file>", "new transform \u2014 function transform(event) { \u2026 } (or @path to a file)").option(
+).option("--name <name>", "new name").option("--description <description>", "new description").option("--state <state>", "new state: active, disabled, or proposed").option("--transform-js <jsOr@file>", "new transform \u2014 function transform(event) { \u2026 } (or @path to a file)").option("--turnstile <jsonOr@file>", `optional managed form protection settings; use @file for widget credentials, or '{"enabled":false}' to disable`).option(
   "--pipeline <jsonOr@file>",
   `replacement ordered actions array as JSON (or @path to a file), e.g. '[{"type":"dataset.write","key_column":"email","dataset_slug":"acme-leads"}]'`
 ).action(
@@ -7441,6 +7468,18 @@ pipelinesCmd.command("update <slug>").description(
     if (opts.name !== void 0) body.name = opts.name;
     if (opts.description !== void 0) body.description = opts.description;
     if (opts.state !== void 0) body.state = opts.state;
+    const turnstileRaw = readMaybeFile(opts.turnstile);
+    if (turnstileRaw !== void 0) {
+      try {
+        const protection = JSON.parse(turnstileRaw);
+        if (!protection || Array.isArray(protection) || typeof protection !== "object" || typeof protection.enabled !== "boolean") {
+          throw new Error("invalid settings");
+        }
+        body.turnstile = protection;
+      } catch {
+        fail(new Error("--turnstile must be a JSON object with an enabled boolean"));
+      }
+    }
     const transformJs = readMaybeFile(opts.transformJs);
     if (transformJs !== void 0) body.transform_js = transformJs;
     const pipelineRaw = readMaybeFile(opts.pipeline);
@@ -7456,7 +7495,7 @@ pipelinesCmd.command("update <slug>").description(
     if (Object.keys(body).length === 0) {
       fail(
         new Error(
-          "nothing to update \u2014 pass at least one of --name, --description, --state, --transform-js, --pipeline"
+          "nothing to update \u2014 pass at least one of --name, --description, --state, --transform-js, --pipeline, --turnstile"
         )
       );
     }

package/package.json

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