@erdoai/cli 0.130.0 → 0.131.0

package/dist/index.js

@@ -1283,6 +1283,16 @@ var ErdoClient = class {
       input
     );
   }
+  // Cannot be undone. Removes the lead from every Erdo store so the same phone
+  // and email can arrive as a new lead. Staff-only, for demos and tests. A
+  // retry of a delete that stopped part-way resumes it, and a lead already
+  // deleted answers "already_deleted".
+  deleteLead(datasetSlug, lead) {
+    return this.request(
+      "DELETE",
+      `/v1/datasets/${encodeURIComponent(datasetSlug)}/leads/${encodeURIComponent(lead)}`
+    );
+  }
   // The lead playbook: plain text that decides each lead's next action. An
   // organization that never saved one gets the default template, exists=false.
   getLeadPlaybook() {
@@ -2054,7 +2064,7 @@ async function browserLogin() {
 // src/input.ts
 import { readFileSync as readFileSync2 } from "fs";
 function readMaybeFile(value) {
-  if (!value) return void 0;
+  if (value === void 0) return void 0;
   if (value.startsWith("@@")) return value.slice(1);
   return value.startsWith("@") ? readFileSync2(value.slice(1), "utf8") : value;
 }
@@ -4679,6 +4689,7 @@ function renderApproval(r) {
   }
   facts.push(["created", r.created_at]);
   if (r.decided_at) facts.push(["decided", r.decided_at]);
+  if (r.decision_reason) facts.push(["because", r.decision_reason]);
   if (r.expires_at) facts.push(["expires", r.expires_at]);
   if (r.execution) {
     const reason = r.execution.summary ? ` \u2014 ${r.execution.summary}` : "";
@@ -4738,6 +4749,9 @@ approvalsCmd.command("decide <id>").description("Approve or reject a pending app
 ).option(
   "--constraints <json>",
   `explicit parameter constraints for the standing policy, e.g. '{"spreadsheet_id":{"values":["..."]}}'`
+).option(
+  "--reason <text>",
+  "why you decided this way. On --reject it holds the same proposal back for 7 days: a re-proposal of the same subject that states no new reason is answered with your decline instead of a new approval, and the decision record keeps it as the decider's rationale"
 ).action(
   async (id, opts) => {
     try {
@@ -4774,7 +4788,8 @@ ${listing}`);
       const res = await client.decideApproval(id, {
         decision: opts.approve ? "approved" : "rejected",
         scope: opts.scope,
-        parameter_constraints: constraints
+        parameter_constraints: constraints,
+        ...opts.reason?.trim() ? { reason: opts.reason.trim() } : {}
       });
       console.log(res.message);
     } catch (e) {
@@ -4828,7 +4843,7 @@ approvalsCmd.command("settings [mode]").description(
 });
 var attnCmd = program.command("attention").description("The attention feed \u2014 digests, choices, escalations awaiting a human");
 function attentionItemLine(item) {
-  return [item.slug, item.severity, item.kind, item.status, item.title].join("	");
+  return [item.slug, item.severity, item.kind, item.ask ?? "", item.status, item.title].join("	");
 }
 function renderAttentionItemReport(item, report) {
   console.log("");
@@ -5359,6 +5374,12 @@ pagesCmd.command("update <id>").description(
 ).option(
   "--meta-image-asset <attachmentId>",
   'new public share image: a Brand Style attachment id (og-image / hero photo) (omit to keep current; pass "" to clear)'
+).option(
+  "--build-brief <textOr@file>",
+  "new judge build brief (or @path to a UTF-8 file; omit to keep current, pass an empty string to clear)"
+).option(
+  "--required-modules <csv>",
+  'replacement runtime module list (comma-separated; "[]" clears)'
 ).option("--datasets <csv>", 'replacement read-dataset slugs ("[]" clears)').option("--writable-datasets <csv>", 'replacement writable-dataset slugs ("[]" clears)').option("--kv <csv>", 'replacement read KV-store slugs ("[]" clears)').option("--writable-kv <csv>", 'replacement writable KV-store slugs ("[]" clears)').option("--public", "make the page publicly viewable").option("--private", "make the page private").option(
   "--request-review",
   "ask the judge lenses to review the page after this update and report findings -- for material edits to a LIVE page (layout, forms/CTA, legal/compliance copy, restructured sections), not cosmetic tweaks. First builds and full rewrites are already reviewed automatically"
@@ -5374,6 +5395,8 @@ pagesCmd.command("update <id>").description(
         meta_description: opts.metaDescription,
         meta_icon_asset_id: opts.metaIconAsset,
         meta_image_asset_id: opts.metaImageAsset,
+        build_brief: readMaybeFile(opts.buildBrief),
+        required_modules: grantList(opts.requiredModules),
         dataset_slugs: grantList(opts.datasets),
         writable_dataset_slugs: grantList(opts.writableDatasets),
         kv_slugs: grantList(opts.kv),
@@ -7402,7 +7425,7 @@ filterCmd.command("list <slug>").description("List the default filters on a data
   }
 });
 var leadsCmd = program.command("leads").description(
-  "Read leads in a lead dataset, merge two that are the same person, and run the lead playbook that suggests each lead's next action"
+  "Read leads in a lead dataset, merge two that are the same person, delete one, and run the lead playbook that suggests each lead's next action"
 );
 leadsCmd.command("get <dataset> <lead>").description(
   "Read one lead: its permanent canonical_lead_id, what it told us (on the form and in every call, chat, text and email reply since), the email and phone evidence bound to it, its dataset row, the leads merged into it, and its capture history. <lead> is either the canonical_lead_id UUID or the 22-character lead reference, and an id that has since been merged away resolves to the lead it became \u2014 so an id read off an old capture response still works."
@@ -7516,6 +7539,40 @@ leadsCmd.command("merge <dataset> <survivor>").description(
     }
   }
 );
+leadsCmd.command("delete <dataset> <lead>").description(
+  "Delete a lead from every Erdo store: its row and identity, its text and WhatsApp conversations, its calls and website chats, its emails, and the follow-up engine's decisions about it. The same phone and email submitted again then make a new lead with nothing behind it. This cannot be undone. A staff tool for demos and tests: copies held by providers (message bodies, call audio, sent mail) and in logs stay, and so do opt-outs. A phone or email another lead in the organization also holds is not released until that lead is deleted too. Read the lead with `leads get` before running it."
+).option("-y, --yes", "skip the confirmation prompt").option("--json", "print the raw JSON result instead of a summary").action(async (dataset, lead, opts) => {
+  try {
+    if (!opts.yes) {
+      const answer = await promptLine(
+        `Delete lead ${lead} from ${dataset}? Its row, conversations, calls, emails and follow-up history are removed and this cannot be undone. Type "delete" to continue: `
+      );
+      if (answer.trim() !== "delete") {
+        console.error("Not deleted.");
+        process.exit(1);
+      }
+    }
+    const res = await new ErdoClient().deleteLead(dataset, lead);
+    if (opts.json) {
+      print(res);
+      return;
+    }
+    console.log(
+      res.state === "already_deleted" ? `Lead ${res.reference} was already deleted. That delete removed:` : `Deleted lead ${res.reference}. Removed:`
+    );
+    const removed = Object.entries(res.removed ?? {}).filter(([, count]) => count > 0).sort(([a], [b]) => a.localeCompare(b));
+    if (removed.length === 0) console.log("  nothing");
+    for (const [kind, count] of removed) console.log(`  ${kind.replace(/_/g, " ")}: ${count}`);
+    const shared = (res.shared_phones ?? 0) + (res.shared_emails ?? 0);
+    if (shared > 0) {
+      console.log(
+        `${shared} of this lead's contact details ${shared === 1 ? "is" : "are"} also held by another lead in the organization, so what is kept by number or address for ${shared === 1 ? "it" : "them"} was left in place. Delete that lead too to release ${shared === 1 ? "it" : "them"}.`
+      );
+    }
+  } catch (e) {
+    fail(e);
+  }
+});
 var leadPlaybookCmd = leadsCmd.command("playbook").description("Read, try and save the lead playbook: the plain-text rules for what Erdo does next with each lead");
 leadPlaybookCmd.command("get").description(
   "Show the saved playbook: whether the sweep is enabled, the daily contact cap, the read-back Erdo enforces (each action's mode and the working hours), and the text. An organization that never saved one sees the default template."

package/package.json

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