@audienti/cli 0.1.32 → 0.1.34

package/CHANGELOG.md

@@ -4,6 +4,24 @@ All notable changes to the Audienti CLI are documented here.
 
 ## [Unreleased]
 
+## [0.1.34] - 2026-08-17
+
+### Added
+
+- Add `audienti icps update <icp_id> --payload <file.json>` for rich ICP facet patches using the same payload shape as ICP creation.
+- Surface executable motion configuration validity in `audienti motions status`, including missing outbound signals and missing LOPA tracked profile URLs.
+- Add outbound motion signal configuration to `audienti motions create --payload` and `audienti motions update <motn_id> --payload <file.json>`, including scoped company/person/both signal rows.
+
+### Changed
+
+- Default omitted inbound motion channels to LinkedIn-only when motions are created through the CLI/API contract; Reddit remains explicit opt-in.
+
+## [0.1.33] - 2026-08-13
+
+### Added
+
+- Add `audienti motions quick-start --url <company_url>` for URL-generated quick-start drafts, with optional `--wait --confirm` motion setup and discovery launch.
+
 ## [0.1.32] - 2026-08-11
 
 ### Added

package/README.md

@@ -139,8 +139,10 @@ audienti operator next --plan
 audienti writer test-run <prsp_id>
 audienti motions analytics <motn_id>
 audienti motions run-discovery <motn_id>
+audienti motions quick-start --url https://example.com --wait --confirm
 audienti motions update <motn_id> --status paused
 audienti motions update <motn_id> --own-post-engagement true
+audienti motions update <motn_id> --payload motion-signals.json
 audienti motions activate <motn_id>
 audienti motions delete <motn_id> --confirm yes
 audienti content programs
@@ -248,6 +250,36 @@ used by the operator surface:
 audienti motions run-discovery <motn_id>
 ```
 
+To check whether a motion has executable configuration before preparing,
+activating, or running discovery:
+
+```bash
+audienti motions status <motn_id>
+audienti motions status <motn_id> --json
+```
+
+The JSON response includes `executable_configuration.valid` plus a reason when
+the config is incomplete, such as missing outbound signals or missing LOPA
+tracked profile URLs.
+
+To create and launch a quick-start motion from a company URL:
+
+```bash
+audienti motions quick-start --url https://example.com --wait --confirm
+```
+
+To create or update an ICP from a rich JSON payload:
+
+```bash
+audienti icps create --payload icp.json
+audienti icps update <icp_id> --payload icp-patch.json
+```
+
+`icps update --payload` accepts the same human-readable facet keys as create.
+Supplied facet collections, such as `company_sizes_attributes`, replace that
+collection in place; omitted fields and collections remain unchanged. Invalid
+lookup values fail server-side without partially applying the patch.
+
 To audit one account user's outbound actions, optionally narrowed to one motion
 and one AccountProspect.created_at cohort:
 

package/package.json

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

package/skills/audienti/SKILL.md

@@ -100,6 +100,7 @@ audienti prospects unlock <prsp_id> --json
 audienti users activity me --window 7d --json
 audienti prospects import-batch --file prospects.csv --motion <motn_id> --assigned-user me --json
 audienti lists create --name "Target list" --json
+audienti motions quick-start --url https://example.com --wait --confirm --json
 audienti motions update <motn_id> --status paused --json
 audienti motions activate <motn_id> --json
 audienti motions delete <motn_id> --confirm yes --json

package/src/api-client.js

@@ -375,6 +375,24 @@ export class AudientiClient {
     });
   }
 
+  createQuickStart(accountId, body) {
+    return this.requestJson(accountPath(accountId, ["quick_start"]), {
+      method: "POST",
+      body
+    });
+  }
+
+  quickStart(accountId, draftId) {
+    return this.requestJson(accountPath(accountId, ["quick_start", draftId]));
+  }
+
+  confirmQuickStart(accountId, draftId, body = {}) {
+    return this.requestJson(accountPath(accountId, ["quick_start", draftId, "confirm"]), {
+      method: "POST",
+      body
+    });
+  }
+
   motionProspects(accountId, motionId, query = {}) {
     return this.requestJson(accountPath(accountId, ["motions", motionId, "prospects"], query));
   }

package/src/cli.js

@@ -72,7 +72,7 @@ const OFFERS_DELETE_USAGE = "Usage: audienti offers delete <offr_id> --confirm <
 const WRITER_TEST_RUN_USAGE = "Usage: audienti writer test-run <prsp_id> [--json] [--mode <plan|report|step>] [--branch <both|no-accept|accepted>] [--step <step_key|row_number>] [--report <rprt_id>] [--no-wait] [--timeout-seconds <n>] [--poll-interval-seconds <n>] [--account <acct_id>]";
 const WRITER_TEST_RUN_SHOW_USAGE = "Usage: audienti writer test-run show <prsp_id> <rprt_id> [--json] [--account <acct_id>]";
 const MOTIONS_ANALYTICS_USAGE = "Usage: audienti motions analytics <motn_id> [--window 30d] [--json] [--account <acct_id>]";
-const MOTIONS_UPDATE_USAGE = "Usage: audienti motions update <motn_id> [--status <draft|preparing|active|paused|archived>] [--tags <tag[,tag...]>] [--own-post-engagement <true|false>] [--json] [--account <acct_id>]";
+const MOTIONS_UPDATE_USAGE = "Usage: audienti motions update <motn_id> ([--status <draft|preparing|active|paused|archived>] [--tags <tag[,tag...]>] [--own-post-engagement <true|false>] | --payload <file.json>) [--json] [--account <acct_id>]";
 const CONTENT_PROGRAMS_USAGE = "Usage: audienti content programs [--user <account_user_id|email|name|me>] [--json] [--account <acct_id>]";
 const CONTENT_PLAN_USAGE = "Usage: audienti content plan <cprg_id> [--week <n>] [--due] [--json] [--account <acct_id>]";
 const CONTENT_SHOW_USAGE = "Usage: audienti content show <cpwi_id> [--json] [--account <acct_id>]";
@@ -89,8 +89,9 @@ const MOTIONS_DELETE_USAGE = "Usage: audienti motions delete <motn_id> --confirm
 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 MOTIONS_RUN_DISCOVERY_USAGE = "Usage: audienti motions run-discovery <motn_id> [--target-count <n>] [--json] [--account <acct_id>]";
+const MOTIONS_QUICK_START_USAGE = "Usage: audienti motions quick-start --url <company_url> [--principal <account_user_id|me>] [--feedback <text>] [--offer-type <type>] [--force] [--confirm] [--wait] [--timeout-seconds <n>] [--poll-interval-seconds <n>] [--json] [--account <acct_id>]";
 const ICPS_SHOW_USAGE = "Usage: audienti icps show <icp_id> [--json] [--account <acct_id>]";
-const ICPS_UPDATE_USAGE = "Usage: audienti icps update <icp_id> [--name <text>] [--notes <text>] [--discovery-keyword <text>] [--tags <tag[,tag...]>] [--json] [--account <acct_id>]";
+const ICPS_UPDATE_USAGE = "Usage: audienti icps update <icp_id> ([--name <text>] [--notes <text>] [--discovery-keyword <text>] [--tags <tag[,tag...]>] | --payload <file.json>) [--json] [--account <acct_id>]";
 const ICPS_ADD_TAG_USAGE = "Usage: audienti icps add-tag <icp_id> <tag> [--json] [--account <acct_id>]";
 const ICPS_REMOVE_TAG_USAGE = "Usage: audienti icps remove-tag <icp_id> <tag> [--json] [--account <acct_id>]";
 const LISTS_ADD_TAG_USAGE = "Usage: audienti lists add-tag <list_id> <tag> [--json] [--account <acct_id>]";
@@ -248,6 +249,7 @@ async function dispatch(argv, context) {
   if (normalizedResource === "motions" && action === "clone") return motionsClone(rest, context, { accountOverride });
   if (normalizedResource === "motions" && action === "move-prospects") return motionsMoveProspects(rest, context, { accountOverride });
   if (normalizedResource === "motions" && action === "run-discovery") return motionsRunDiscovery(rest, context, { accountOverride });
+  if (normalizedResource === "motions" && action === "quick-start") return motionsQuickStart(rest, context, { accountOverride });
   if (normalizedResource === "content" && action === "programs") return contentPrograms(rest, context, { accountOverride });
   if (normalizedResource === "content" && action === "plan") return contentPlan(rest, context, { accountOverride });
   if (normalizedResource === "content" && action === "show") return contentShow(rest, context, { accountOverride });
@@ -1028,25 +1030,19 @@ async function icpsCreate(args, context, { accountOverride } = {}) {
 async function icpsUpdate(args, context, { accountOverride } = {}) {
   const { values, positionals } = parseCommandArgs(args, {
     ...jsonOptions(),
+    payload: { type: "string" },
     name: { type: "string" },
     notes: { type: "string" },
     tags: { type: "string" },
     "discovery-keyword": { type: "string" }
   });
-  const hasUpdateField = values.name || values.notes !== undefined || values.tags !== undefined || values["discovery-keyword"] !== undefined;
+  const hasUpdateField = values.payload || icpSimpleFieldsPresent(values);
   if (positionals.length !== 1 || !hasUpdateField) {
     throw new CommandError(ICPS_UPDATE_USAGE);
   }
 
   const { client, accountId } = await requireAccountContext(context, { accountOverride });
-  const icp = await client.updateIcp(accountId, positionals[0], {
-    icp: compactObject({
-      name: values.name,
-      notes: values.notes,
-      discovery_keyword: values["discovery-keyword"],
-      tags: values.tags !== undefined ? tagList(values.tags) : undefined
-    })
-  });
+  const icp = await client.updateIcp(accountId, positionals[0], { icp: await icpUpdatePayload(values) });
   if (values.json) return writeJson(context.stdout, icp);
 
   writeLine(context.stdout, `Updated ICP ${display(icp?.name)} (${display(icp?.prefix_id)}).`);
@@ -1543,6 +1539,55 @@ async function motionsRunDiscovery(args, context, { accountOverride } = {}) {
   renderMotionDiscoveryRun(payload, context);
 }
 
+async function motionsQuickStart(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, {
+    ...jsonOptions(),
+    url: { type: "string" },
+    principal: { type: "string" },
+    feedback: { type: "string" },
+    "offer-type": { type: "string" },
+    force: { type: "boolean" },
+    confirm: { type: "boolean" },
+    wait: { type: "boolean" },
+    "timeout-seconds": { type: "string" },
+    "poll-interval-seconds": { type: "string" }
+  });
+  if (positionals.length > 0 || !values.url) throw new CommandError(MOTIONS_QUICK_START_USAGE);
+
+  const timeoutSeconds = normalizeOptionalPositiveInteger(values["timeout-seconds"], "--timeout-seconds") || DEFAULT_LOOKUP_TIMEOUT_SECONDS;
+  const pollIntervalSeconds = normalizeOptionalPositiveInteger(values["poll-interval-seconds"], "--poll-interval-seconds") || DEFAULT_LOOKUP_POLL_INTERVAL_SECONDS;
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const requestBody = {
+    quick_start: compactObject({
+      company_url: values.url,
+      principal_account_user_id: values.principal,
+      feedback: values.feedback,
+      offer_type: values["offer-type"],
+      force: values.force || undefined
+    })
+  };
+
+  let draft = await client.createQuickStart(accountId, requestBody);
+  if (values.wait && !quickStartReady(draft)) {
+    draft = await waitForQuickStartDraft(client, accountId, draft, context, { timeoutSeconds, pollIntervalSeconds });
+  }
+
+  if (values.confirm) {
+    if (!quickStartReady(draft)) {
+      throw new CommandError(`Quick-start draft ${display(draft?.id)} is ${display(draft?.status)}. Re-run with --wait or confirm after it is ready.`);
+    }
+
+    const payload = await client.confirmQuickStart(accountId, draft.id, {});
+    if (values.json) return writeJson(context.stdout, payload);
+
+    renderQuickStartConfirmation(payload, context);
+    return;
+  }
+
+  if (values.json) return writeJson(context.stdout, draft);
+  renderQuickStartDraft(draft, context);
+}
+
 async function motionsAnalytics(args, context, { accountOverride } = {}) {
   const { values, positionals } = parseCommandArgs(args, {
     ...jsonOptions(),
@@ -1632,7 +1677,7 @@ async function motionsCreate(args, context, { accountOverride } = {}) {
   }
 
   const { client, accountId } = await requireAccountContext(context, { accountOverride });
-  const payload = await readJsonPayload(values.payload);
+  const payload = normalizeMotionCreatePayload(await readJsonPayload(values.payload));
   const created = await client.createMotion(accountId, { motion: payload });
   if (values.json) return writeJson(context.stdout, created);
 
@@ -1640,6 +1685,14 @@ async function motionsCreate(args, context, { accountOverride } = {}) {
   renderMotion(created, context);
 }
 
+function normalizeMotionCreatePayload(payload) {
+  if (!payload || typeof payload !== "object" || Array.isArray(payload)) return payload;
+  if (String(payload.kind || "").trim().toLowerCase() !== "inbound") return payload;
+  if (Object.prototype.hasOwnProperty.call(payload, "inbound_channels")) return payload;
+
+  return { ...payload, inbound_channels: ["linkedin"] };
+}
+
 async function motionsDelete(args, context, { accountOverride } = {}) {
   const { values, positionals } = parseCommandArgs(args, {
     ...jsonOptions(),
@@ -1660,30 +1713,44 @@ async function motionsDelete(args, context, { accountOverride } = {}) {
 async function motionsUpdate(args, context, { accountOverride } = {}) {
   const { values, positionals } = parseCommandArgs(args, {
     ...jsonOptions(),
+    payload: { type: "string" },
     status: { type: "string" },
     tags: { type: "string" },
     "own-post-engagement": { type: "string" }
   });
-  const hasUpdateField = values.status || values.tags !== undefined || values["own-post-engagement"] !== undefined;
+  const hasUpdateField = values.payload || motionSimpleFieldsPresent(values);
   if (positionals.length !== 1 || !hasUpdateField) {
     throw new CommandError(MOTIONS_UPDATE_USAGE);
   }
 
-  const normalizedStatus = normalizeMotionStatus(values.status);
-  const motionAttributes = compactObject({
-    status: normalizedStatus,
-    play_tags: values.tags !== undefined ? tagList(values.tags) : undefined,
-    own_post_engagement: values["own-post-engagement"] !== undefined ? parseBooleanString(values["own-post-engagement"], "--own-post-engagement") : undefined
-  });
-
   const { client, accountId } = await requireAccountContext(context, { accountOverride });
-  const motion = await client.updateMotion(accountId, positionals[0], { motion: motionAttributes });
+  const motion = await client.updateMotion(accountId, positionals[0], { motion: await motionUpdatePayload(values) });
   if (values.json) return writeJson(context.stdout, motion);
 
   writeLine(context.stdout, `Updated motion ${display(motion?.name)} (${display(motion?.prefix_id)}).`);
   renderMotion(motion, context);
 }
 
+async function motionUpdatePayload(values) {
+  if (values.payload) {
+    if (motionSimpleFieldsPresent(values)) {
+      throw new CommandError("Choose one motion input mode: either --payload <file.json> or the simple --status/--tags/--own-post-engagement flags.");
+    }
+
+    return readJsonPayload(values.payload);
+  }
+
+  return compactObject({
+    status: normalizeMotionStatus(values.status),
+    play_tags: values.tags !== undefined ? tagList(values.tags) : undefined,
+    own_post_engagement: values["own-post-engagement"] !== undefined ? parseBooleanString(values["own-post-engagement"], "--own-post-engagement") : undefined
+  });
+}
+
+function motionSimpleFieldsPresent(values) {
+  return Boolean(values.status) || values.tags !== undefined || values["own-post-engagement"] !== undefined;
+}
+
 async function motionsStatusShortcut(action, args, context, { accountOverride } = {}) {
   const usage = `Usage: audienti motions ${action} <motn_id> [--json] [--account <acct_id>]`;
   const { values, positionals } = parseCommandArgs(args, jsonOptions());
@@ -3524,7 +3591,7 @@ function filterRecordsByTag(records, value, field) {
 
 async function icpCreatePayload(values) {
   if (values.payload) {
-    if (values.name || values.notes || values.tags !== undefined || values["discovery-keyword"]) {
+    if (icpSimpleFieldsPresent(values)) {
       throw new CommandError("Choose one ICP input mode: either --payload <file.json> or the simple --name/--notes/--discovery-keyword/tags flags.");
     }
 
@@ -3543,6 +3610,27 @@ async function icpCreatePayload(values) {
   });
 }
 
+async function icpUpdatePayload(values) {
+  if (values.payload) {
+    if (icpSimpleFieldsPresent(values)) {
+      throw new CommandError("Choose one ICP input mode: either --payload <file.json> or the simple --name/--notes/--discovery-keyword/tags flags.");
+    }
+
+    return readJsonPayload(values.payload);
+  }
+
+  return compactObject({
+    name: values.name,
+    notes: values.notes,
+    tags: values.tags !== undefined ? tagList(values.tags) : undefined,
+    discovery_keyword: values["discovery-keyword"]
+  });
+}
+
+function icpSimpleFieldsPresent(values) {
+  return Boolean(values.name) || values.notes !== undefined || values.tags !== undefined || values["discovery-keyword"] !== undefined;
+}
+
 async function prospectNotePayload(values, { forcedType, usageText } = {}) {
   const engagementKey = values["engagement-type"] || values["engagement-key"];
 
@@ -4272,6 +4360,7 @@ function renderMotion(motion, context) {
   writeLine(context.stdout, `Motion: ${display(motion?.name)} (${display(motion?.prefix_id)})`);
   writeLine(context.stdout, `Status: ${display(motion?.status)}`);
   writeLine(context.stdout, `Kind: ${display(motion?.kind)}`);
+  renderExecutableConfiguration(motion?.executable_configuration, context);
   if (motion?.offer?.name) writeLine(context.stdout, `Offer: ${motion.offer.name} (${display(motion.offer.prefix_id)})`);
   if (motion?.icp?.name) writeLine(context.stdout, `ICP: ${motion.icp.name} (${display(motion.icp.prefix_id)})`);
   if (motion?.list?.name) writeLine(context.stdout, `List: ${motion.list.name} (${display(motion.list.prefix_id)})`);
@@ -4342,10 +4431,23 @@ function renderMotionStatus(status, context) {
   writeLine(context.stdout, `Motion: ${display(status?.name)} (${display(status?.prefix_id)})`);
   writeLine(context.stdout, `State: ${display(status?.state)}`);
   writeLine(context.stdout, `Reason: ${display(status?.reason_label || status?.reason_key)}`);
+  renderExecutableConfiguration(status?.executable_configuration, context);
   if (status?.description) writeLine(context.stdout, status.description);
   if (status?.action?.label) writeLine(context.stdout, `Action: ${status.action.label}`);
 }
 
+function renderExecutableConfiguration(config, context) {
+  if (!config || typeof config !== "object") return;
+
+  writeLine(context.stdout, `Valid config: ${config.valid ? "yes" : "no"}`);
+  if (!config.valid && (config.reason_label || config.reason_key)) {
+    writeLine(context.stdout, `Config reason: ${display(config.reason_label || config.reason_key)}`);
+  }
+  if (!config.valid && config.description) {
+    writeLine(context.stdout, `Config detail: ${config.description}`);
+  }
+}
+
 function renderProspects(payload, context, { wide = false, profiles = false } = {}) {
   const prospects = Array.isArray(payload?.prospects) ? payload.prospects : [];
   if (prospects.length === 0) return writeLine(context.stdout, "No prospects found.");
@@ -5324,6 +5426,45 @@ function renderMotionDiscoveryRun(payload, context) {
   writeLine(context.stdout, `Target count: ${display(payload?.target_count)}`);
 }
 
+function renderQuickStartDraft(draft, context) {
+  writeLine(context.stdout, `Quick-start draft ${display(draft?.id)} is ${display(draft?.status)}.`);
+  writeLine(context.stdout, `URL: ${display(draft?.normalized_url)}`);
+  if (draft?.principal_account_user) writeLine(context.stdout, `Principal: ${accountUserLabel(draft.principal_account_user)}`);
+  if (draft?.expires_at) writeLine(context.stdout, `Expires: ${draft.expires_at}`);
+  if (draft?.error) writeLine(context.stdout, `Error: ${draft.error}`);
+  if (quickStartReady(draft)) writeLine(context.stdout, `Confirm: audienti motions quick-start --url ${draft.normalized_url} --confirm`);
+}
+
+function renderQuickStartConfirmation(payload, context) {
+  const motion = payload?.motion || {};
+  writeLine(context.stdout, `Quick-start motion ${display(entityLabel(motion) || motion.prefix_id)} ${payload?.reused ? "reused" : "created"}.`);
+  writeLine(context.stdout, `Motion status: ${display(motion.status)}`);
+  writeLine(context.stdout, `Reservation: ${display(payload?.reservation?.status)} / ${display(payload?.reservation?.launch_status)}`);
+  if (payload?.reservation?.launch_reason) writeLine(context.stdout, `Launch reason: ${payload.reservation.launch_reason}`);
+}
+
+function quickStartReady(draft) {
+  return draft?.ready === true || draft?.status === "ready";
+}
+
+function quickStartTerminal(draft) {
+  return quickStartReady(draft) || draft?.status === "failed";
+}
+
+async function waitForQuickStartDraft(client, accountId, initialDraft, context, { timeoutSeconds, pollIntervalSeconds }) {
+  let draft = initialDraft;
+  const deadline = context.now().getTime() + timeoutSeconds * 1000;
+
+  while (!quickStartTerminal(draft)) {
+    if (context.now().getTime() >= deadline) return draft;
+
+    await context.sleep(pollIntervalSeconds * 1000);
+    draft = await client.quickStart(accountId, draft.id);
+  }
+
+  return draft;
+}
+
 function renderAnalyticsDashboard(payload, context) {
   writeLine(context.stdout, `Dashboard analytics (${display(payload?.cohort?.label, "selected cohort")})`);
   if (payload?.cohort) {
@@ -6145,9 +6286,11 @@ const HELP_TOPICS = new Map([
     "    audienti motions show <motn_id>",
     "    audienti motions analytics <motn_id>",
     "    audienti motions run-discovery <motn_id>",
+    "    audienti motions quick-start --url <company_url> --confirm --wait",
     "    audienti motions prospects <motn_id>",
     "    audienti motions create --payload <file.json>",
     "    audienti motions update <motn_id> [--status <state>] [--tags <tag[,tag...]>] [--own-post-engagement <true|false>]",
+    "    audienti motions update <motn_id> --payload <file.json>",
     "    audienti motions add-tag <motn_id> <tag>",
     "    audienti motions remove-tag <motn_id> <tag>",
     "    audienti motions activate <motn_id>",
@@ -6202,7 +6345,7 @@ const HELP_TOPICS = new Map([
     "    audienti offers delete <offr_id> --confirm <yes|true|Y|y>",
     "    audienti icps list [--tag <tag>]",
     "    audienti icps show <icp_id>",
-    "    audienti icps update <icp_id> [--tags <tag[,tag...]>]",
+    "    audienti icps update <icp_id> [--tags <tag[,tag...]> | --payload <file.json>]",
     "    audienti icps add-tag <icp_id> <tag>",
     "    audienti icps remove-tag <icp_id> <tag>",
     "    audienti companies search --query <text>",
@@ -6679,7 +6822,7 @@ const HELP_TOPICS = new Map([
     "  audienti icps list [--tag <tag>] [--json]",
     "  audienti icps show <icp_id> [--json]",
     "  audienti icps create (--name <text> | --payload <file.json>) [--json]",
-    "  audienti icps update <icp_id> [--tags <tag[,tag...]>] [--json]",
+    "  audienti icps update <icp_id> ([--tags <tag[,tag...]>] | --payload <file.json>) [--json]",
     "  audienti icps add-tag <icp_id> <tag> [--json]",
     "  audienti icps remove-tag <icp_id> <tag> [--json]",
     "",
@@ -6772,12 +6915,12 @@ const HELP_TOPICS = new Map([
 
   ["icps update", [
     "Usage:",
-    "  audienti icps update <icp_id> [--name <text>] [--notes <text>] [--discovery-keyword <text>] [--tags <tag[,tag...]>] [--json] [--account <acct_id>]",
+    `  ${ICPS_UPDATE_USAGE.slice("Usage: ".length)}`,
     "",
     "Status: implemented",
     "",
     "Purpose:",
-    "  Update simple ICP fields or replace the ICP's full tag set.",
+    "  Update simple ICP fields, replace the ICP's full tag set, or apply a rich ICP payload patch.",
     "",
     "Input shape:",
     "  icp_id: icpp_ prefixed id or integer id",
@@ -6785,15 +6928,30 @@ const HELP_TOPICS = new Map([
     "  notes: string | optional",
     "  discovery_keyword: string | optional",
     "  tags: comma-separated tag list | optional",
+    "  payload: file.json | optional full or partial ICP object using the account API create shape",
+    "",
+    "Behavior:",
+    "  Choose either --payload or simple flags. Supplied facet collections replace that collection in place; omitted fields and facet collections remain unchanged.",
+    "  Human-readable lookup-backed facet names are resolved by the account API. Invalid lookup values fail with 422 and no partial mutation.",
     "",
     "API:",
     "  PATCH /api/v1/accounts/:account_id/icps/:id.json",
     "",
-    "JSON body:",
+    "Simple JSON body:",
     "  {",
     "    \"icp\": {",
     "      \"tags\": [\"enterprise\", \"renewal\"]",
     "    }",
+    "  }",
+    "",
+    "Payload file example:",
+    "  {",
+    "    \"company_sizes_attributes\": [",
+    "      {\"name\": \"1001-5000 employees\"}",
+    "    ],",
+    "    \"seniorities_attributes\": [",
+    "      {\"name\": \"CXO\"}",
+    "    ]",
     "  }"
   ].join("\n")],
 
@@ -7393,11 +7551,12 @@ const HELP_TOPICS = new Map([
     "  audienti motions show <motn_id> [--json]",
     "  audienti motions status <motn_id> [--json]",
     "  audienti motions run-discovery <motn_id> [--target-count <n>] [--json]",
+    "  audienti motions quick-start --url <company_url> [--confirm] [--wait] [--json]",
     "  audienti motions analytics <motn_id> [--window 30d] [--json]",
     "  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 update <motn_id> [--status <draft|preparing|active|paused|archived>] [--tags <tag[,tag...]>] [--own-post-engagement <true|false>] [--json]",
+    "  audienti motions update <motn_id> ([--status <draft|preparing|active|paused|archived>] [--tags <tag[,tag...]>] [--own-post-engagement <true|false>] | --payload <file.json>) [--json]",
     "  audienti motions add-tag <motn_id> <tag> [--json]",
     "  audienti motions remove-tag <motn_id> <tag> [--json]",
     "  audienti motions activate <motn_id> [--json]",
@@ -7407,7 +7566,7 @@ const HELP_TOPICS = new Map([
     "  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 update, delete, clone, status, discovery launch, and prospect attachment commands implemented",
+    "Status: read, create, quick-start, status update, delete, clone, status, discovery launch, and prospect attachment commands implemented",
     "",
     "CLI synonym:",
     "  `plays` is accepted anywhere `motions` is accepted",
@@ -7495,6 +7654,7 @@ const HELP_TOPICS = new Map([
     "  state: healthy_idle | broken",
     "  reason_key: string",
     "  reason_label: string",
+    "  executable_configuration: { valid: boolean, reason_key: string | null, reason_label: string | null, description: string | null }",
     "  description: string",
     "  action: { key: string, label: string } | null",
     "  stats: { target_count, deficit, projected_connectable, capacity, daily_target }",
@@ -7545,6 +7705,36 @@ const HELP_TOPICS = new Map([
     "  POST /api/v1/accounts/:account_id/motions/:id/run_discovery.json"
   ].join("\n")],
 
+  ["motions quick-start", [
+    "Usage:",
+    `  ${MOTIONS_QUICK_START_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Draft a quick-start motion from a company URL, then optionally confirm it into a launched quick-start motion.",
+    "",
+    "Options:",
+    "  --url <company_url>       Public HTTP(S) URL used by the quick-start drafter.",
+    "  --principal <user>        Account user id or me. Defaults to the authenticated token user.",
+    "  --feedback <text>         Optional operator guidance for the draft.",
+    "  --offer-type <type>       Optional supported offer type hint.",
+    "  --force                  Request a fresh draft when inputs should replace an existing ready draft.",
+    "  --confirm                Confirm the ready draft into motion setup and discovery launch.",
+    "  --wait                   Poll until the generated draft is ready before returning or confirming.",
+    "  --timeout-seconds <n>    Maximum wait time. Defaults to 60.",
+    "  --poll-interval-seconds <n>  Poll cadence. Defaults to 2.",
+    "",
+    "Pipeline:",
+    "  POST creates or reuses a QuickStartDraft and enqueues GenerateQuickStartDraftJob when needed.",
+    "  POST confirm calls QuickStartOrchestrator, creating ICP, offer, signals, motion, reservation, and discovery launch.",
+    "",
+    "API:",
+    "  POST /api/v1/accounts/:account_id/quick_start.json",
+    "  GET /api/v1/accounts/:account_id/quick_start/:draft_id.json",
+    "  POST /api/v1/accounts/:account_id/quick_start/:draft_id/confirm.json"
+  ].join("\n")],
+
   ["motions prospects", [
     "Usage:",
     "  audienti motions prospects <motn_id> [--json] [--account <acct_id>]",
@@ -7616,7 +7806,9 @@ const HELP_TOPICS = new Map([
     "  icp_id: icpp_ prefix id | optional",
     "  list_id: list_ prefix id | optional",
     "  play_tags: [string] | optional",
-    "  inbound_channels: [linkedin | reddit] | optional",
+    "  signal_rows: [{ scope: company | person | both, question: string, company_signal_category: string | optional, role_terms: string | optional, posting_language: string | optional, topics: string | optional }] | optional for outbound motions",
+    "  signal_questions: newline-delimited company::, person::, or both:: legacy question text | optional for outbound motions",
+    "  inbound_channels: [linkedin | reddit] | optional; defaults to [linkedin] for inbound motions",
     "  lopa_profiles: [{ url: string, source_type: creator | competitor | partner | customer | other }] | optional",
     "",
     "JSON example:",
@@ -7671,25 +7863,44 @@ const HELP_TOPICS = new Map([
     "Status: implemented",
     "",
     "Purpose:",
-    "  Change one motion or play's lifecycle status or replace its tag set.",
+    "  Change one motion or play's lifecycle status, replace its tag set, or patch rich motion configuration.",
     "",
     "Input shape:",
     "  motn_id: motn_ prefix id",
     "  status: draft | preparing | active | paused | archived | optional",
     "  tags: comma-separated tag list | optional",
+    "  payload: file.json | optional full or partial motion object using the account API shape",
     "",
     "Behavior:",
-    "  Updates only the provided fields. Sending --tags replaces the motion's full tag set.",
+    "  Choose either --payload or simple flags. Updates only the provided fields. Sending --tags replaces the motion's full tag set.",
+    "  Payload mode supports outbound signal_rows or legacy signal_questions; supplied rows replace the motion's active ready signals.",
     "",
     "API:",
     "  PATCH /api/v1/accounts/:account_id/motions/:id.json",
     "",
-    "JSON body:",
+    "Simple JSON body:",
     "  {",
       "    \"motion\": {",
       "      \"status\": \"paused\",",
       "      \"play_tags\": [\"sarit\", \"pj\"]",
       "    }",
+    "  }",
+    "",
+    "Payload file example:",
+    "  {",
+    "    \"signal_rows\": [",
+    "      {",
+    "        \"scope\": \"company\",",
+    "        \"question\": \"Is the company hiring revenue operations leaders?\",",
+    "        \"company_signal_category\": \"hiring\",",
+    "        \"role_terms\": \"Revenue Operations\"",
+    "      },",
+    "      {",
+    "        \"scope\": \"person\",",
+    "        \"question\": \"Is the person talking about pipeline quality?\",",
+    "        \"topics\": \"pipeline quality\"",
+    "      }",
+    "    ]",
     "  }"
   ].join("\n")],