@audienti/cli 0.1.6 → 0.1.8

package/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to the Audienti CLI are documented here.
 
 ## [Unreleased]
 
+## [0.1.8] - 2026-07-14
+
+### Added
+
+- Add `audienti motions clone <motn_id> --name <text>` to clone a motion/play config through the API without copying people.
+- Add `audienti motions move-prospects <source_motn_id> --target <target_motn_id> <prsp_id> [prsp_id...]` to transfer prospects between motions/plays.
+
+## [0.1.7] - 2026-07-12
+
+### Fixed
+
+- Show writer test-run target-step error status and warnings when a draft fails instead of rendering an empty drafted-copy block.
+
 ## [0.1.6] - 2026-07-12
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@audienti/cli",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Agent-first command-line client for Audienti.",
   "type": "module",
   "bin": {

package/src/api-client.js

@@ -130,6 +130,20 @@ export class AudientiClient {
     });
   }
 
+  cloneMotion(accountId, motionId, body) {
+    return this.requestJson(accountPath(accountId, ["motions", motionId, "clone"]), {
+      method: "POST",
+      body
+    });
+  }
+
+  moveMotionProspects(accountId, motionId, body) {
+    return this.requestJson(accountPath(accountId, ["motions", motionId, "move_prospects"]), {
+      method: "POST",
+      body
+    });
+  }
+
   motionStatus(accountId, motionId) {
     return this.requestJson(accountPath(accountId, ["motions", motionId, "status"]));
   }

package/src/cli.js

@@ -31,6 +31,8 @@ const PROSPECTS_ADD_PROFILE_USAGE = "Usage: audienti prospects add-profile <prsp
 const PROSPECTS_REPORT_BAD_PROFILE_USAGE = "Usage: audienti prospects report-bad-profile <prsp_id> <prof_id|citation_id> [--json] [--account <acct_id>]";
 const WRITER_TEST_RUN_USAGE = "Usage: audienti writer test-run <prsp_id> [--json] [--mode <report|plan|step>] [--branch <both|no-accept|accepted>] [--step <step_key|row_number>] [--no-cache] [--clear-cache] [--account <acct_id>]";
 const MOTIONS_ANALYTICS_USAGE = "Usage: audienti motions analytics <motn_id> [--window 30d] [--json] [--account <acct_id>]";
+const MOTIONS_CLONE_USAGE = "Usage: audienti motions clone <motn_id> --name <text> [--json] [--account <acct_id>]";
+const MOTIONS_MOVE_PROSPECTS_USAGE = "Usage: audienti motions move-prospects <source_motn_id> --target <target_motn_id> <prsp_id> [prsp_id...] [--json] [--account <acct_id>]";
 const ANALYTICS_PROSPECTS_USAGE = "Usage: audienti analytics prospects [--window 24h] [--cohort-start YYYY-MM-DD --cohort-end YYYY-MM-DD] [--motion <motn_id>] [--provenance <source>] [--user <account_user_id|email|name|me>] [--json] [--account <acct_id>]";
 const ANALYTICS_PROSPECTS_COHORT_ANALYSIS_USAGE = "Usage: audienti analytics prospects cohort-analysis [--weeks <n>] [--window 24h] [--motion <motn_id>] [--provenance <source>] [--user <account_user_id|email|name|me>] [--json] [--account <acct_id>]";
 const ANALYTICS_USERS_USAGE = "Usage: audienti analytics users [--user <account_user_id|email|name|me>] [--window 30d | --start YYYY-MM-DD --end YYYY-MM-DD] [--cohort-start YYYY-MM-DD --cohort-end YYYY-MM-DD] [--motion <motn_id>] [--provenance <source>] [--platform <linkedin|email|gmail>] [--json] [--account <acct_id>]";
@@ -135,6 +137,8 @@ async function dispatch(argv, context) {
   if (normalizedResource === "motions" && action === "prospects") return motionsProspects(rest, context, { accountOverride });
   if (normalizedResource === "motions" && action === "add-prospects") return motionsAddProspects(rest, context, { accountOverride });
   if (normalizedResource === "motions" && action === "create") return motionsCreate(rest, context, { accountOverride });
+  if (normalizedResource === "motions" && action === "clone") return motionsClone(rest, context, { accountOverride });
+  if (normalizedResource === "motions" && action === "move-prospects") return motionsMoveProspects(rest, context, { accountOverride });
   if (normalizedResource === "prospects" && action === "list") return prospectsList(rest, context, { accountOverride });
   if (normalizedResource === "prospects" && action === "show") return prospectsShow(rest, context, { accountOverride });
   if (normalizedResource === "prospects" && action === "timeline") return prospectsTimeline(rest, context, { accountOverride });
@@ -782,6 +786,52 @@ async function motionsCreate(args, context, { accountOverride } = {}) {
   renderMotion(created, context);
 }
 
+async function motionsClone(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, {
+    ...jsonOptions(),
+    name: { type: "string" }
+  });
+  if (positionals.length !== 1 || !values.name) {
+    throw new CommandError(MOTIONS_CLONE_USAGE);
+  }
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const cloned = await client.cloneMotion(accountId, positionals[0], {
+    motion: {
+      name: values.name
+    }
+  });
+  if (values.json) return writeJson(context.stdout, cloned);
+
+  writeLine(context.stdout, `Cloned motion ${display(positionals[0])} as ${display(cloned?.name)} (${display(cloned?.prefix_id)}).`);
+  renderMotion(cloned, context);
+}
+
+async function motionsMoveProspects(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, {
+    ...jsonOptions(),
+    target: { type: "string" }
+  });
+  if (positionals.length < 2 || !values.target) {
+    throw new CommandError(MOTIONS_MOVE_PROSPECTS_USAGE);
+  }
+
+  const [sourceMotionId, ...prospectIds] = positionals;
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.moveMotionProspects(accountId, sourceMotionId, {
+    target_motion_id: values.target,
+    prospect_ids: prospectIds
+  });
+  if (values.json) return writeJson(context.stdout, payload);
+
+  const moved = Number(payload?.moved || 0);
+  const failed = Array.isArray(payload?.failed) ? payload.failed.length : 0;
+  writeLine(context.stdout, `Moved ${moved} prospects from ${display(sourceMotionId)} to ${display(values.target)}.`);
+  if (failed > 0) {
+    writeLine(context.stdout, `${failed} prospects failed.`);
+  }
+}
+
 async function prospectsList(args, context, { accountOverride } = {}) {
   const { values, positionals } = parseCommandArgs(args, {
     ...jsonOptions(),
@@ -1113,7 +1163,7 @@ function writerCachedDraftsForRequest(cache, branchFilter) {
   const branchKeys = writerRequestedBranchKeys(branchFilter);
   return Object.values(cache.entries || {})
     .filter((entry) => branchKeys.includes(entry.branch))
-    .filter((entry) => entry.key && (entry.body || entry.text || entry.subject))
+    .filter((entry) => entry.key && (entry.body || entry.text || entry.subject || writerCacheQualityFailure(entry)))
     .map((entry) => compactObject({
       branch: entry.branch,
       key: entry.key,
@@ -1125,6 +1175,9 @@ function writerCachedDraftsForRequest(cache, branchFilter) {
       body: entry.body,
       text: entry.text,
       status: entry.status,
+      quality_codes: entry.quality_codes,
+      blank_reason: entry.blank_reason,
+      writer_path: entry.writer_path,
       generated_at: entry.generated_at,
       writer_engine: entry.writer_engine,
       target: entry.target,
@@ -1187,7 +1240,7 @@ async function persistWriterDraftsFromPayload(context, { cache, payload }) {
 function writerCacheEntryFromStep(step, { branchKey, generatedAt }) {
   if (step?.kind !== "message") return null;
   if (!step.key) return null;
-  if (!(step.body || step.text || step.subject)) return null;
+  if (!(step.body || step.text || step.subject || writerCacheQualityFailure(step))) return null;
   if (step.status === "planned" || step.status === "unavailable" || step.status === "error") return null;
 
   return compactObject({
@@ -1201,8 +1254,11 @@ function writerCacheEntryFromStep(step, { branchKey, generatedAt }) {
     body: step.body,
     text: step.text,
     status: step.status,
+    quality_codes: Array.isArray(step.quality_codes) ? step.quality_codes.filter(Boolean) : undefined,
+    blank_reason: step.blank_reason,
+    writer_path: step.writer_path,
     generated_at: step.generated_at || generatedAt || new Date().toISOString(),
-    writer_engine: step?.metadata?.writer_engine,
+    writer_engine: step.writer_engine || step?.metadata?.writer_engine,
     target: step.target,
     metadata: step.metadata
   });
@@ -1212,6 +1268,10 @@ function writerCacheEntryKey(entry) {
   return `${entry.branch}:${entry.key}`;
 }
 
+function writerCacheQualityFailure(entry) {
+  return String(entry?.status || "") === "quality_failure";
+}
+
 async function prospectsImport(args, context, { accountOverride } = {}) {
   const { values, positionals } = parseCommandArgs(args, {
     ...jsonOptions(),
@@ -2343,7 +2403,7 @@ function renderWriterStepRow(step, index, context) {
     fixedWidth(compactKindLabel(step.kind), 4),
     fixedWidth(writerStepAction(step), 42),
     fixedWidth(compactChannelLabel(step.channel), 7),
-    fixedWidth(display(step.status), 9)
+    fixedWidth(compactWriterStatusLabel(step.status), 9)
   ].join("  ");
   writeLine(context.stdout, row);
 }
@@ -2359,8 +2419,21 @@ function renderWriterTargetDraft(branch, context) {
   writeLine(context.stdout, `Drafted copy: ${display(draftedStep.stage)}${branch.resolved_target_step ? ` (${branch.resolved_target_step})` : ""}`);
   const targetUrl = writerDraftTargetUrl(draftedStep);
   if (targetUrl) writeLine(context.stdout, `Replying to: ${targetUrl}`);
+  if (draftedStep.status && draftedStep.status !== "success") writeLine(context.stdout, `Status: ${draftedStep.status}`);
+  if (String(draftedStep.status || "") === "quality_failure") {
+    const qualityCodes = Array.isArray(draftedStep.quality_codes) ? draftedStep.quality_codes.filter(Boolean) : [];
+    if (qualityCodes.length) writeLine(context.stdout, `Quality failure: ${qualityCodes.join(", ")}`);
+    if (draftedStep.blank_reason) writeLine(context.stdout, `Blank reason: ${draftedStep.blank_reason}`);
+    if (draftedStep.writer_path) writeLine(context.stdout, `Writer path: ${draftedStep.writer_path}`);
+    if (draftedStep.writer_engine) writeLine(context.stdout, `Writer engine: ${draftedStep.writer_engine}`);
+  }
+  for (const warning of Array.isArray(draftedStep.warnings) ? draftedStep.warnings : []) {
+    if (warning) writeLine(context.stdout, `Warning: ${warning}`);
+  }
+  if (draftedStep.missing_reason) writeLine(context.stdout, `Missing reason: ${draftedStep.missing_reason}`);
   if (draftedStep.subject) writeLine(context.stdout, `Subject: ${draftedStep.subject}`);
-  writeLine(context.stdout, display(draftedStep.body || draftedStep.text || draftedStep.empty_body_reason || ""));
+  const body = draftedStep.body || draftedStep.text || draftedStep.empty_body_reason;
+  writeLine(context.stdout, display(body || "No draft body returned."));
 }
 
 function writerDraftTargetUrl(step) {
@@ -2414,6 +2487,12 @@ function compactChannelLabel(channel) {
   return value;
 }
 
+function compactWriterStatusLabel(status) {
+  const value = String(display(status));
+  if (value === "quality_failure") return "quality";
+  return value;
+}
+
 function fixedWidth(value, width, options = {}) {
   const text = truncateCliText(value, width);
   return options.align === "right" ? text.padStart(width) : text.padEnd(width);
@@ -3241,6 +3320,8 @@ const HELP_TOPICS = new Map([
     "    audienti motions analytics <motn_id>",
     "    audienti motions prospects <motn_id>",
     "    audienti motions create --payload <file.json>",
+    "    audienti motions clone <motn_id> --name <text>",
+    "    audienti motions move-prospects <source_motn_id> --target <target_motn_id> <prsp_id> [prsp_id...]",
     "    Tip: `plays` is accepted anywhere `motions` is accepted.",
     "",
     "  Prospects",
@@ -3813,8 +3894,10 @@ const HELP_TOPICS = new Map([
     "  audienti motions prospects <motn_id> [--json]",
     "  audienti motions add-prospects <motn_id> <prsp_id> [prsp_id...] [--json]",
     "  audienti motions create --payload <file.json> [--json]",
+    "  audienti motions clone <motn_id> --name <text> [--json]",
+    "  audienti motions move-prospects <source_motn_id> --target <target_motn_id> <prsp_id> [prsp_id...] [--json]",
     "",
-    "Status: read, create, status, and prospect attachment commands implemented",
+    "Status: read, create, clone, status, and prospect attachment commands implemented",
     "",
     "CLI synonym:",
     "  `plays` is accepted anywhere `motions` is accepted",
@@ -3988,6 +4071,62 @@ const HELP_TOPICS = new Map([
     "  Use `audienti offers list`, `audienti icps list`, and `audienti users list` to resolve valid ids before calling this command."
   ].join("\n")],
 
+  ["motions clone", [
+    "Usage:",
+    `  ${MOTIONS_CLONE_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Clone one motion or play's configuration under a new name without copying its people.",
+    "",
+    "Input shape:",
+    "  motn_id: motn_ prefix id",
+    "  name: new motion name",
+    "",
+    "Behavior:",
+    "  Copies the motion kind, offer, ICP, principal, premise, approach, targeting profile, suppression policy, secondary roles, and active signal rows.",
+    "  The clone starts as draft with a new empty backing list.",
+    "",
+    "API:",
+    "  POST /api/v1/accounts/:account_id/motions/:id/clone.json",
+    "",
+    "JSON body:",
+    "  {",
+    "    \"motion\": {",
+    "      \"name\": \"Wine Campaign Restaurant Operators\"",
+    "    }",
+    "  }"
+  ].join("\n")],
+
+  ["motions move-prospects", [
+    "Usage:",
+    `  ${MOTIONS_MOVE_PROSPECTS_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Move prospects out of one motion or play and into another motion or play.",
+    "",
+    "Input shape:",
+    "  source_motn_id: source motn_ prefix id",
+    "  target_motn_id: target motn_ prefix id",
+    "  prsp_id: one or more prospect prefix ids",
+    "",
+    "Behavior:",
+    "  Move removes each selected prospect from the source motion and source backing list, then adds it to the target motion and target backing list.",
+    "  Copy is intentionally not exposed until multi-motion membership exists.",
+    "",
+    "API:",
+    "  POST /api/v1/accounts/:account_id/motions/:id/move_prospects.json",
+    "",
+    "JSON body:",
+    "  {",
+    "    \"target_motion_id\": \"motn_target\",",
+    "    \"prospect_ids\": [\"prsp_one\", \"prsp_two\"]",
+    "  }"
+  ].join("\n")],
+
   ["prospects", [
     "Usage:",
     "  audienti prospects list [--json] [filters]",
@@ -4733,6 +4872,8 @@ const HELP_TOPICS = new Map([
     "",
     "2. Create a motion or play",
     "  audienti motions create --payload <file.json>",
+    "  audienti motions clone <motn_id> --name \"New subset motion\"",
+    "  audienti motions move-prospects <source_motn_id> --target <target_motn_id> <prsp_id> [prsp_id...]",
     "  audienti motions status <motn_id>",
     "",
     "3. Add a new prospect from LinkedIn and poll enrichment",