@erdoai/cli 0.126.0 → 0.127.0

package/dist/index.js

@@ -1257,10 +1257,22 @@ var ErdoClient = class {
   }
   // The captures the platform refused to resolve: two leads sharing a contact
   // detail, or a submission whose email and phone point at different leads.
-  listLeadMergeCandidates(datasetSlug, limit) {
-    const qs = limit ? `?limit=${encodeURIComponent(String(limit))}` : "";
+  listLeadMergeCandidates(datasetSlug, limit, traffic) {
+    const query = new URLSearchParams();
+    if (limit !== void 0) query.set("limit", String(limit));
+    if (traffic !== void 0) query.set("traffic", traffic);
+    const qs = query.size ? `?${query}` : "";
     return this.request("GET", `/v1/datasets/${encodeURIComponent(datasetSlug)}/lead-candidates${qs}`);
   }
+  resolveLeadCapture(datasetSlug, captureID, input) {
+    if (!["apply_to_lead", "dismiss"].includes(input.action) || typeof input.reason !== "string" || !input.reason.trim()) {
+      throw new Error("A resolution action and reason are required.");
+    }
+    if (input.apply && (!input.operation_key || !input.expected_snapshot)) {
+      throw new Error("Apply requires operation_key and expected_snapshot from the exact preview.");
+    }
+    return this.request("POST", `/v1/datasets/${encodeURIComponent(datasetSlug)}/lead-captures/${encodeURIComponent(captureID)}/resolve`, input);
+  }
   // Not reversible in practice: the absorbed lead's row values are combined into
   // the survivor's and its row is gone. It needs no idempotency key — the pair it
   // joins identifies it, so a retry answers "already_merged".
@@ -6749,7 +6761,7 @@ datasetsCmd.command("create <name>").description(
 });
 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) => {
+).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("--reviewed-optional-addition <name>", "producer-reviewed optional column to add atomically; repeat for multiple columns", (value, previous = []) => [...previous, value], []).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 declaredSchema = readSchemaFile(opts.schema);
     const result = await new ErdoClient().ensureDataset({
@@ -6758,6 +6770,7 @@ datasetsCmd.command("ensure <purpose>").description(
       ...opts.description ? { description: opts.description } : {},
       ...opts.purposeDescription ? { purpose_description: opts.purposeDescription } : {},
       ...opts.preferredDataset ? { preferred_dataset: opts.preferredDataset } : {},
+      ...opts.reviewedOptionalAddition.length ? { reviewed_optional_additions: opts.reviewedOptionalAddition } : {},
       ...opts.emailColumn ? { email_column: opts.emailColumn } : {},
       ...opts.phoneColumn ? { phone_column: opts.phoneColumn } : {},
       declared_schema: declaredSchema
@@ -7392,10 +7405,10 @@ leadsCmd.command("get <dataset> <lead>").description(
   }
 });
 leadsCmd.command("candidates <dataset>").description(
-  "List the captures the platform refused to resolve \u2014 where two leads share a contact detail, or a submission's email and phone point at different leads. The platform records the candidates instead of guessing, and this is the queue a person drains with `leads merge`."
-).option("-l, --limit <n>", "maximum captures to return (default 50, maximum 200)", (v) => parseInt(v, 10)).option("--json", "print the raw JSON result instead of a table").action(async (dataset, opts) => {
+  "List unresolved refused submissions and their candidate leads. Inspect the saved evidence before previewing an apply-to-lead or dismissal decision with leads resolve-capture."
+).option("-l, --limit <n>", "maximum captures to return (default 50, maximum 200)", (v) => parseInt(v, 10)).addOption(new Option2("--traffic <kind>", "include real submissions, independently trusted tests, or both").choices(["real", "test", "all"])).option("--json", "print the raw JSON result instead of a table").action(async (dataset, opts) => {
   try {
-    const res = await new ErdoClient().listLeadMergeCandidates(dataset, opts.limit);
+    const res = await new ErdoClient().listLeadMergeCandidates(dataset, opts.limit, opts.traffic);
     if (opts.json) {
       print(res);
       return;
@@ -7413,8 +7426,10 @@ leadsCmd.command("candidates <dataset>").description(
     }
     const rows = [];
     for (const item of candidates) {
+      if (!item.candidates?.length) rows.push([item.capture.id, item.capture.created_at, item.capture.resolution, "No candidate", "", "", ""]);
       for (const candidate of item.candidates ?? []) {
         rows.push([
+          item.capture.id,
           item.capture.created_at,
           item.capture.resolution,
           candidate.canonical_lead_id,
@@ -7424,15 +7439,29 @@ leadsCmd.command("candidates <dataset>").description(
         ]);
       }
     }
-    printAlignedTable(["captured", "why", "lead", "emails", "phones", "settled"], rows);
+    printAlignedTable(["receipt", "captured", "why", "lead", "emails", "phones", "settled"], rows);
     console.log(
       `
-Merge two of them with: erdo leads merge ${res.dataset_slug} <survivor> --absorb <lead>`
+Review saved submission evidence with: erdo leads resolve-capture ${res.dataset_slug} <receipt> --input <decision.json>`
     );
   } catch (e) {
     fail(e);
   }
 });
+leadsCmd.command("resolve-capture <dataset> <receipt>").description("Preview a refused submission against a candidate lead, or record an audited dismissal. Applying preserves the original receipt and does not merge identities, report a conversion, or replay arrival automations.").requiredOption("--input <file>", "JSON decision: action, target_lead_id for apply_to_lead, reason; applying also requires expected_snapshot and operation_key").option("--apply", "confirm the exact preview; without this flag the decision only previews").action(async (dataset, receipt, opts) => {
+  try {
+    const input = JSON.parse(readFileSync4(opts.input, "utf8"));
+    if (!input || typeof input !== "object" || Array.isArray(input)) throw new Error("--input must contain a JSON object");
+    if (Object.hasOwn(input, "apply")) throw new Error("Use the explicit --apply flag; do not put apply in the decision file");
+    for (const key of Object.keys(input)) {
+      if (!["action", "target_lead_id", "reason", "expected_snapshot", "operation_key"].includes(key)) throw new Error(`Unknown decision field: ${key}`);
+    }
+    const result = await new ErdoClient().resolveLeadCapture(dataset, receipt, { ...input, apply: Boolean(opts.apply) });
+    print(result);
+  } catch (e) {
+    fail(e);
+  }
+});
 leadsCmd.command("merge <dataset> <survivor>").description(
   "Merge two leads into one. The absorbed lead stops being its own lead: its contact evidence moves onto the survivor, and the two dataset rows become one row \u2014 a value the absorbed row carries fills a blank in the survivor's row, and never replaces one the survivor already holds unless you name the column with --overwrite-column. This cannot be undone: the absorbed row's values are combined away and only the pointer survives, so an id already handed out keeps resolving. Read both leads with `leads get` before running it."
 ).requiredOption("--absorb <lead>", "the lead that stops being its own lead (UUID or lead reference)").option(
@@ -7907,6 +7936,10 @@ must not affect priority  ${rb.priority.forbidden_factors.join(", ")}`);
     }
   }
   if (rb.flow) printLeadPlaybookFlow(rb.flow);
+  if (rb.call_plan?.length) {
+    console.log("\ncalls to a lead who has not answered (enforced)");
+    for (const line of rb.call_plan) console.log(`  ${line}`);
+  }
   if (rb.limits?.length) {
     console.log("\nlimits Erdo applied");
     for (const l of rb.limits) console.log(`  ${l.kind} \u2192 ${l.mode}: ${l.reason}`);

package/package.json

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