@audienti/cli 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -4,6 +4,29 @@ All notable changes to the Audienti CLI are documented here.
 
 ## [Unreleased]
 
+## [0.1.5] - 2026-07-11
+
+### Added
+
+- Add the `https://cli.audienti.com/install` curl installer backed by the public CLI mirror and npm package.
+- Add `audienti operator next --done|--skip|--fail|--return` shortcuts for recording the current prospect next-move outcome without hand-building a payload file.
+- Add `audienti prospects add-profile` and `audienti prospects report-bad-profile` for updating prospect profile channels through the same server paths used by the prospect show page.
+
+### Changed
+
+- Send fingerprinted `operator next` outcome shortcuts through the server-derived row contract so queue-row semantics stay on the API side.
+
+### Fixed
+
+- Reject `audienti operator next --note` and `--occurred-at` unless an outcome flag is present.
+
+## [0.1.4] - 2026-07-11
+
+### Added
+
+- Add `audienti operator next --plan` for deterministic next-action plan output.
+- Add `audienti analytics prospects`, `audienti analytics visibility`, and `audienti analytics content` for account-scoped operational analytics.
+
 ## [0.1.3] - 2026-07-11
 
 ### Changed

package/README.md

@@ -8,6 +8,13 @@ manage plays, import prospects, build lists, and work supported operator flows.
 
 Requires Node.js 20 or newer.
 
+```bash
+curl -fsSL https://cli.audienti.com/install | bash
+audienti --help
+```
+
+Or install directly through npm:
+
 ```bash
 npm install --global @audienti/cli
 audienti --help
@@ -41,6 +48,35 @@ Use `--json` whenever another program or agent will consume the result. Inspect
 the target state before mutations, and use the command-specific help before
 creating, changing, or deleting data.
 
+Common inspection commands:
+
+```bash
+audienti operator next --plan
+audienti prospects show <prsp_id> --json
+audienti prospects list --profiles
+audienti analytics prospects --window 24h
+audienti analytics visibility --window 24h --user me
+audienti analytics content --window week
+```
+
+To work the supported prospect operator queue from the CLI, inspect the next move
+and record the outcome against that same row:
+
+```bash
+audienti operator next --plan
+audienti operator next --done --note "Connection request sent."
+```
+
+To update a prospect's attached profile channels through the same paths used by
+the prospect show page:
+
+```bash
+audienti prospects add-profile <prsp_id> --url prospect@example.com
+audienti prospects add-profile <prsp_id> --url +12025550123
+audienti prospects add-profile <prsp_id> --url https://www.linkedin.com/in/example
+audienti prospects report-bad-profile <prsp_id> <prof_id>
+```
+
 ## Compatibility
 
 The CLI talks to the versioned Audienti `/api/v1` contract at

package/install

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+package="@audienti/cli"
+binary="audienti"
+minimum_node_major=20
+
+say() {
+  printf '%s\n' "$*"
+}
+
+fail() {
+  printf 'Audienti CLI install failed: %s\n' "$*" >&2
+  exit 1
+}
+
+require_command() {
+  if ! command -v "$1" >/dev/null 2>&1; then
+    fail "$2"
+  fi
+}
+
+require_command node "Node.js ${minimum_node_major} or newer is required. Install Node.js, then rerun this script."
+require_command npm "npm is required. Install Node.js ${minimum_node_major} or newer with npm, then rerun this script."
+
+node_major="$(node -p 'Number(process.versions.node.split(".")[0])' 2>/dev/null || true)"
+case "$node_major" in
+  ''|*[!0-9]*)
+    fail "could not determine the installed Node.js version."
+    ;;
+esac
+
+if [ "$node_major" -lt "$minimum_node_major" ]; then
+  fail "Node.js ${minimum_node_major} or newer is required. Current version: $(node --version)."
+fi
+
+say "Installing ${package}..."
+npm install --global --no-audit --no-fund "$package"
+
+global_prefix="$(npm prefix --global 2>/dev/null || true)"
+if [ -n "$global_prefix" ] && [ -d "$global_prefix/bin" ]; then
+  export PATH="$global_prefix/bin:$PATH"
+fi
+
+if ! command -v "$binary" >/dev/null 2>&1; then
+  if [ -n "$global_prefix" ] && [ -x "$global_prefix/bin/$binary" ]; then
+    fail "${binary} installed at ${global_prefix}/bin/${binary}, but that directory is not on PATH."
+  fi
+
+  fail "${binary} was not found on PATH after installation."
+fi
+
+"$binary" --help >/dev/null
+
+cat <<'NEXT'
+Audienti CLI installed.
+
+Next:
+  audienti auth token <token>
+  audienti accounts list --json
+  audienti accounts select <acct_id>
+NEXT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@audienti/cli",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Agent-first command-line client for Audienti.",
   "type": "module",
   "bin": {
@@ -9,6 +9,8 @@
   "files": [
     "bin/",
     "src/",
+    "skills/",
+    "install",
     "README.md",
     "LICENSE",
     "CHANGELOG.md"

package/skills/audienti/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: audienti
+description: Use when the user wants to operate Audienti through the production CLI, including account selection, plays, prospect imports, lists, message previews, or supported operator outcomes.
+---
+
+# Audienti CLI
+
+Use the installed `audienti` command as the production contract. Do not build a
+parallel wrapper or call undocumented API endpoints.
+
+## Setup
+
+1. Verify the command is installed:
+
+```bash
+audienti --help
+```
+
+2. If it is unavailable, install the public package:
+
+```bash
+curl -fsSL https://cli.audienti.com/install | bash
+```
+
+3. Authentication is explicit and per machine. Do not ask a user to paste a
+production token into chat, a repository file, an issue, or a CI secret. Use
+the existing `audienti auth token` flow only after the user supplies a token
+through an approved secure channel.
+
+4. Start with discovery, not mutation:
+
+```bash
+audienti auth status
+audienti accounts list --json
+audienti help agent-workflows
+```
+
+## Operating Rules
+
+- Use `--json` whenever another agent or tool will consume the response.
+- Use `audienti <resource> <action> help` before a mutation when the accepted
+  payload or behavior is unclear.
+- Inspect the current resource before a create, update, attach, delete, or
+  operator outcome writeback.
+- Treat the production API as the source of truth. Persist durable work in
+  Audienti rather than leaving it only in agent prose.
+- Keep current gaps explicit. Do not imply that unsupported actions execute.
+
+## Common Entry Points
+
+```bash
+audienti help agent-workflows
+audienti prospects list --query "name or company" --wide --json
+audienti lists create --name "Target list" --json
+audienti operator next --json
+audienti operator next --plan
+audienti analytics prospects --window 24h --json
+audienti analytics visibility --window 24h --user me --json
+audienti analytics content --window week --json
+```

package/src/api-client.js

@@ -189,6 +189,20 @@ export class AudientiClient {
     });
   }
 
+  addProspectProfile(accountId, prospectId, body) {
+    return this.requestJson(accountPath(accountId, ["prospects", prospectId, "profiles"]), {
+      method: "POST",
+      body
+    });
+  }
+
+  reportBadProspectProfile(accountId, prospectId, body) {
+    return this.requestJson(accountPath(accountId, ["prospects", prospectId, "report_bad_profile"]), {
+      method: "POST",
+      body
+    });
+  }
+
   prospectImport(accountId, body) {
     return this.requestJson(accountPath(accountId, ["prospect_imports"]), {
       method: "POST",
@@ -215,6 +229,18 @@ export class AudientiClient {
     });
   }
 
+  analyticsProspects(accountId, query = {}) {
+    return this.requestJson(accountPath(accountId, ["analytics", "prospects"], query));
+  }
+
+  analyticsVisibility(accountId, query = {}) {
+    return this.requestJson(accountPath(accountId, ["analytics", "visibility"], query));
+  }
+
+  analyticsContent(accountId, query = {}) {
+    return this.requestJson(accountPath(accountId, ["analytics", "content"], query));
+  }
+
   async requestJson(path, { method = "GET", body } = {}) {
     const response = await this.fetchImpl(new URL(path, `${this.host}/`), {
       method,
@@ -296,6 +322,10 @@ function errorMessage(status, body) {
     return "The requested Audienti resource was not found.";
   }
 
+  if (status === 409) {
+    return body?.error || "Audienti rejected the request because the resource changed. Re-fetch and try again.";
+  }
+
   if (status === 422) {
     const reasons = [body?.errors, body?.details].find(Array.isArray);
     const details = reasons?.length > 0 ? reasons.join(", ") : body?.error;

package/src/cli.js

@@ -26,6 +26,8 @@ const DEFAULT_PROFILE_IDENTIFIERS = [
 const DELETE_CONFIRMATION_VALUES = new Set(["yes", "true", "y"]);
 const PROSPECTS_ADD_NOTE_USAGE = "Usage: audienti prospects add-note <prsp_id> (--message <text> [--type <note|steer|voicemail_outreach|video_outreach>] [--engagement-type <key>] | --payload <file.json>) [--json] [--account <acct_id>]";
 const PROSPECTS_ADD_STEER_USAGE = "Usage: audienti prospects add-steer <prsp_id> (--message <text> [--engagement-type <key>] | --payload <file.json>) [--json] [--account <acct_id>]";
+const PROSPECTS_ADD_PROFILE_USAGE = "Usage: audienti prospects add-profile <prsp_id> --url <profile_url|email|phone> [--json] [--account <acct_id>]";
+const PROSPECTS_REPORT_BAD_PROFILE_USAGE = "Usage: audienti prospects report-bad-profile <prsp_id> <prof_id|citation_id> [--json] [--account <acct_id>]";
 const SEQUENCE_EXPORT_CSV_COLUMNS = [
   "prospect_id",
   "prospect_name",
@@ -114,6 +116,8 @@ async function dispatch(argv, context) {
   if (normalizedResource === "prospects" && action === "write") return prospectsWrite(rest, context, { accountOverride });
   if (normalizedResource === "prospects" && action === "add-note") return prospectsAddNote(rest, context, { accountOverride });
   if (normalizedResource === "prospects" && action === "add-steer") return prospectsAddSteer(rest, context, { accountOverride });
+  if (normalizedResource === "prospects" && action === "add-profile") return prospectsAddProfile(rest, context, { accountOverride });
+  if (normalizedResource === "prospects" && action === "report-bad-profile") return prospectsReportBadProfile(rest, context, { accountOverride });
   if (normalizedResource === "prospects" && action === "sequence-preview") return prospectsSequencePreview(rest, context, { accountOverride });
   if (normalizedResource === "prospects" && action === "sequence-export") return prospectsSequenceExport(rest, context, { accountOverride });
   if (normalizedResource === "prospects" && action === "import") return prospectsImport(rest, context, { accountOverride });
@@ -122,6 +126,9 @@ async function dispatch(argv, context) {
   if (normalizedResource === "operator" && action === "queue") return operatorQueue(rest, context, { accountOverride });
   if (normalizedResource === "operator" && action === "next") return operatorNext(rest, context, { accountOverride });
   if (normalizedResource === "operator" && action === "outcome") return operatorOutcome(rest, context, { accountOverride });
+  if (normalizedResource === "analytics" && ["prospects", "prospect"].includes(action)) return analyticsProspects(rest, context, { accountOverride });
+  if (normalizedResource === "analytics" && ["visibility", "visops"].includes(action)) return analyticsVisibility(rest, context, { accountOverride });
+  if (normalizedResource === "analytics" && action === "content") return analyticsContent(rest, context, { accountOverride });
 
   throw new CommandError(usage(), { exitCode: resource ? 1 : 0 });
 }
@@ -858,6 +865,31 @@ async function prospectsAddSteer(args, context, { accountOverride } = {}) {
   });
 }
 
+async function prospectsAddProfile(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, {
+    ...jsonOptions(),
+    url: { type: "string" }
+  });
+  if (positionals.length !== 1 || !values.url) throw new CommandError(PROSPECTS_ADD_PROFILE_USAGE);
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const response = await client.addProspectProfile(accountId, positionals[0], { url: values.url });
+  if (values.json) return writeJson(context.stdout, response);
+
+  renderProspectProfileMutation(response, context, { action: "Added" });
+}
+
+async function prospectsReportBadProfile(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, jsonOptions());
+  if (positionals.length !== 2) throw new CommandError(PROSPECTS_REPORT_BAD_PROFILE_USAGE);
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const response = await client.reportBadProspectProfile(accountId, positionals[0], { profile_id: positionals[1] });
+  if (values.json) return writeJson(context.stdout, response);
+
+  renderProspectProfileMutation(response, context, { action: "Reported" });
+}
+
 async function prospectNoteCommand(args, context, { accountOverride, forcedType, usageText }) {
   const { values, positionals } = parseCommandArgs(args, {
     ...jsonOptions(),
@@ -1010,7 +1042,7 @@ async function toolsGet(args, context, { accountOverride } = {}) {
 }
 
 async function operatorQueue(args, context, { accountOverride } = {}) {
-  const { values, positionals } = parseCommandArgs(args, operatorOptions());
+  const { values, positionals } = parseCommandArgs(args, operatorFilterOptions());
   if (positionals.length > 0) throw new CommandError("Usage: audienti operator queue [--json] [filters] [--account <acct_id>]");
 
   const { client, accountId } = await requireAccountContext(context, { accountOverride });
@@ -1021,12 +1053,30 @@ async function operatorQueue(args, context, { accountOverride } = {}) {
 }
 
 async function operatorNext(args, context, { accountOverride } = {}) {
-  const { values, positionals } = parseCommandArgs(args, operatorOptions());
-  if (positionals.length > 0) throw new CommandError("Usage: audienti operator next [--json] [filters] [--account <acct_id>]");
+  const { values, positionals } = parseCommandArgs(args, operatorNextOptions());
+  if (positionals.length > 0) throw new CommandError("Usage: audienti operator next [--json|--plan|--done|--skip|--fail|--return] [filters] [--note <text>] [--account <acct_id>]");
+  if (values.json && values.plan) throw new CommandError("Choose one output format: use either --json or --plan.");
+  const outcomeStatus = operatorNextOutcomeStatus(values);
+  if (values.plan && outcomeStatus) throw new CommandError("Choose one mode: use either --plan or an outcome flag.");
+  if (!outcomeStatus && (values.note !== undefined || values["occurred-at"] !== undefined)) {
+    throw new CommandError("--note and --occurred-at require an outcome flag: --done, --skip, --fail, or --return.");
+  }
 
   const { client, accountId } = await requireAccountContext(context, { accountOverride });
   const payload = await client.operatorNext(accountId, operatorQuery(values));
+  if (outcomeStatus) {
+    const response = await client.operatorOutcome(accountId, operatorNextOutcomePayload(payload?.next_move, {
+      status: outcomeStatus,
+      note: values.note,
+      occurredAt: values["occurred-at"],
+      filters: payload?.filters
+    }));
+    if (values.json) return writeJson(context.stdout, response);
+
+    return renderOperatorOutcome(response, context);
+  }
   if (values.json) return writeJson(context.stdout, payload);
+  if (values.plan) return renderOperatorPlan(payload?.next_move, context);
 
   renderOperatorNext(payload?.next_move, context);
 }
@@ -1051,6 +1101,39 @@ async function operatorOutcome(args, context, { accountOverride } = {}) {
   renderOperatorOutcome(response, context);
 }
 
+async function analyticsProspects(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, analyticsOptions());
+  if (positionals.length > 0) throw new CommandError("Usage: audienti analytics prospects [--window 24h] [--user <account_user_id|email|name|me>] [--json] [--account <acct_id>]");
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.analyticsProspects(accountId, analyticsQuery(values));
+  if (values.json) return writeJson(context.stdout, payload);
+
+  renderAnalyticsProspects(payload, context);
+}
+
+async function analyticsVisibility(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, analyticsOptions());
+  if (positionals.length > 0) throw new CommandError("Usage: audienti analytics visibility [--window 24h] [--user <account_user_id|email|name|me>] [--json] [--account <acct_id>]");
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.analyticsVisibility(accountId, analyticsQuery(values));
+  if (values.json) return writeJson(context.stdout, payload);
+
+  renderAnalyticsVisibility(payload, context);
+}
+
+async function analyticsContent(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, analyticsOptions());
+  if (positionals.length > 0) throw new CommandError("Usage: audienti analytics content [--window 24h] [--user <account_user_id|email|name|me>] [--json] [--account <acct_id>]");
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.analyticsContent(accountId, analyticsQuery(values));
+  if (values.json) return writeJson(context.stdout, payload);
+
+  renderAnalyticsContent(payload, context);
+}
+
 function parseCommandArgs(args, options) {
   try {
     return parseArgs({
@@ -1106,7 +1189,7 @@ function jsonOptions() {
   };
 }
 
-function operatorOptions() {
+function operatorFilterOptions(extra = {}) {
   return {
     ...jsonOptions(),
     principal: { type: "string" },
@@ -1114,10 +1197,23 @@ function operatorOptions() {
     list: { type: "string" },
     stage: { type: "string" },
     "opportunity-kind": { type: "string" },
-    "writing-status": { type: "string" }
+    "writing-status": { type: "string" },
+    ...extra
   };
 }
 
+function operatorNextOptions() {
+  return operatorFilterOptions({
+    plan: { type: "boolean" },
+    done: { type: "boolean" },
+    skip: { type: "boolean" },
+    fail: { type: "boolean" },
+    return: { type: "boolean" },
+    note: { type: "string" },
+    "occurred-at": { type: "string" }
+  });
+}
+
 function operatorQuery(values) {
   return compactObject({
     principal_account_user_id: values.principal,
@@ -1129,6 +1225,48 @@ function operatorQuery(values) {
   });
 }
 
+function operatorNextOutcomeStatus(values) {
+  const selected = [
+    values.done ? "done" : null,
+    values.skip ? "skipped" : null,
+    values.fail ? "failed" : null,
+    values.return ? "returned" : null
+  ].filter(Boolean);
+  if (selected.length > 1) throw new CommandError("Choose one outcome flag: --done, --skip, --fail, or --return.");
+
+  return selected[0];
+}
+
+function operatorNextOutcomePayload(row, { status, note, occurredAt, filters }) {
+  if (!row) throw new CommandError("No operator moves found.");
+  if (!row.id) throw new CommandError("The next operator move is missing a row id.");
+  if (!row.fingerprint) throw new CommandError("The next operator move is missing a fingerprint; update the server before using outcome shortcuts.");
+
+  return compactObject({
+    row_id: row.id,
+    status,
+    fingerprint: row.fingerprint,
+    queue_filters: filters,
+    note,
+    occurred_at: occurredAt
+  });
+}
+
+function analyticsOptions() {
+  return {
+    ...jsonOptions(),
+    window: { type: "string" },
+    user: { type: "string" }
+  };
+}
+
+function analyticsQuery(values) {
+  return compactObject({
+    window: values.window,
+    account_user_id: values.user
+  });
+}
+
 function compactObject(object) {
   return Object.fromEntries(
     Object.entries(object).filter(([, value]) => value !== undefined && value !== null && String(value).trim() !== "")
@@ -1622,6 +1760,19 @@ function renderProspectNote(payload, context) {
   }
 }
 
+function renderProspectProfileMutation(payload, context, { action }) {
+  const prospect = payload?.prospect || {};
+  const profile = payload?.profile || {};
+  const status = payload?.status ? ` (${payload.status})` : "";
+
+  writeLine(context.stdout, `${action} profile${status}.`);
+  writeLine(context.stdout, `Prospect: ${display(prospect.display_name || prospect.name)} (${display(prospect.prefix_id)})`);
+  writeLine(context.stdout, `Profile: ${display(profile.citation_id || profile.prefix_id)}`);
+  if (profile.identifier) writeLine(context.stdout, `Type: ${profile.identifier}`);
+  if (profile.username) writeLine(context.stdout, `Username: ${profile.username}`);
+  if (profile.url) writeLine(context.stdout, `URL: ${profile.url}`);
+}
+
 function renderProspectSequencePreview(payload, context) {
   const prospect = payload?.prospect || {};
   const report = payload?.report || {};
@@ -1761,6 +1912,60 @@ function renderOperatorNext(row, context) {
   writeLine(context.stdout, operatorRowLine(row));
 }
 
+function renderOperatorPlan(row, context) {
+  if (!row) return writeLine(context.stdout, "No operator moves found.");
+
+  const nextAction = row.next_action || {};
+  const cta = row.cta || {};
+  const draft = row.operator_draft || {};
+
+  writeLine(context.stdout, "Static operator plan");
+  writeLine(context.stdout, `Move: ${display(row.id)}`);
+  writeLine(context.stdout, `Kind: ${display(row.opportunity_kind)}`);
+  writeLine(context.stdout, `Prospect: ${entityLabel(row.prospect)}`);
+  if (row.motion) writeLine(context.stdout, `Motion: ${entityLabel(row.motion)}`);
+  if (row.pipeline_stage || row.plan_state || row.status_label) {
+    writeLine(context.stdout, `State: ${compactText([row.pipeline_stage, row.plan_state, row.status_label]).join(", ")}`);
+  }
+  if (row.due_label) writeLine(context.stdout, `Due: ${row.due_label}`);
+
+  writeLine(context.stdout, "");
+  writeLine(context.stdout, `Next action: ${display(nextActionLabel(row), "Unknown")} (${display(nextAction.type, "unknown")})`);
+  if (nextAction.request_mode) writeLine(context.stdout, `Request mode: ${nextAction.request_mode}`);
+  const timing = timingLabel(nextAction, row);
+  if (timing) writeLine(context.stdout, `Timing: ${timing}`);
+  const target = targetLabel(nextAction);
+  if (target) writeLine(context.stdout, `Target: ${target}`);
+
+  if (Object.keys(cta).length > 0) {
+    writeLine(context.stdout, "");
+    writeLine(context.stdout, `CTA: ${ctaLabel(cta)}`);
+  }
+
+  if (Object.keys(draft).length > 0) {
+    writeLine(context.stdout, "");
+    writeLine(context.stdout, `Draft: ${draftLabel(draft)}`);
+    if (draft.writer_path) writeLine(context.stdout, `Writer: ${draft.writer_path}`);
+    if (draft.subject) writeLine(context.stdout, `Subject: ${draft.subject}`);
+    const body = draft.body || draft.text;
+    if (body) {
+      writeLine(context.stdout, "Body:");
+      writeLine(context.stdout, body);
+    }
+  }
+
+  if (row.rationale) {
+    writeLine(context.stdout, "");
+    writeLine(context.stdout, "Rationale:");
+    writeLine(context.stdout, row.rationale);
+  }
+  if (row.guidance) {
+    writeLine(context.stdout, "");
+    writeLine(context.stdout, "Guidance:");
+    writeLine(context.stdout, row.guidance);
+  }
+}
+
 function renderOperatorOutcome(payload, context) {
   const outcome = payload?.operator_outcome || {};
   const rowId = payload?.row_id || outcome.row_id;
@@ -1774,6 +1979,84 @@ function renderOperatorOutcome(payload, context) {
   }
 }
 
+function renderAnalyticsProspects(payload, context) {
+  writeLine(context.stdout, `Prospect analytics (${analyticsWindowLabel(payload)})`);
+  writeAnalyticsScope(payload, context);
+  writeLine(context.stdout, `Prospects added: ${display(payload?.prospects_added_count, 0)}`);
+  writeAnalyticsActionSummary(payload?.actions, context, "Actions");
+  writeCountTable(context, "Action breakdown", payload?.actions?.breakdown, ["ACTION", "COUNT", "AUTOMATED", "AUTO %"], actionBreakdownRow);
+  writeCountTable(context, "Queue stages", payload?.queue_stages, ["STAGE", "COUNT"], countRow);
+}
+
+function renderAnalyticsVisibility(payload, context) {
+  writeLine(context.stdout, `Visibility analytics (${analyticsWindowLabel(payload)})`);
+  writeAnalyticsScope(payload, context);
+  writeLine(context.stdout, `Unique people engaged: ${display(payload?.unique_people_engaged_count, 0)}`);
+  writeAnalyticsActionSummary(payload?.engagements, context, "Engagements");
+  writeCountTable(context, "Engagement breakdown", payload?.engagements?.breakdown, ["ACTION", "COUNT", "AUTOMATED", "AUTO %"], actionBreakdownRow);
+}
+
+function renderAnalyticsContent(payload, context) {
+  writeLine(context.stdout, `Content analytics (${analyticsWindowLabel(payload)})`);
+  writeAnalyticsScope(payload, context);
+  writeLine(context.stdout, `Published posts: ${display(payload?.published_posts_count, 0)}`);
+  writeCountTable(context, "Stages", payload?.stage_breakdown, ["STAGE", "COUNT"], countRow);
+  writeCountTable(context, "Execution statuses", payload?.execution_status_breakdown, ["STATUS", "COUNT"], countRow);
+}
+
+function writeAnalyticsScope(payload, context) {
+  if (payload?.account_user) {
+    writeLine(context.stdout, `User: ${entityLabel(payload.account_user)}`);
+  } else {
+    writeLine(context.stdout, "User: all account users");
+  }
+}
+
+function writeAnalyticsActionSummary(actions, context, label) {
+  const total = display(actions?.total_count, 0);
+  const automated = display(actions?.automated_count, 0);
+  const percentage = percentageLabel(actions?.automated_percentage);
+  writeLine(context.stdout, `${label}: ${total} (automated ${automated}, ${percentage})`);
+}
+
+function writeCountTable(context, title, rows, headers, mapRow) {
+  const list = Array.isArray(rows) ? rows : [];
+  writeLine(context.stdout, "");
+  writeLine(context.stdout, title);
+  if (list.length === 0) return writeLine(context.stdout, "None");
+
+  writeLine(context.stdout, headers.join("\t"));
+  for (const row of list) writeLine(context.stdout, mapRow(row).join("\t"));
+}
+
+function actionBreakdownRow(row) {
+  return [
+    display(row?.label || row?.key),
+    display(row?.count, 0),
+    display(row?.automated_count, 0),
+    percentageLabel(row?.automated_percentage)
+  ];
+}
+
+function countRow(row) {
+  return [
+    display(row?.label || row?.key),
+    display(row?.count, 0)
+  ];
+}
+
+function analyticsWindowLabel(payload) {
+  const window = payload?.window || {};
+  const key = display(window.key, "24h");
+  if (!window.started_at || !window.ended_at) return key;
+
+  return `${key}: ${window.started_at} to ${window.ended_at}`;
+}
+
+function percentageLabel(value) {
+  return value === undefined || value === null || value === "" ? "n/a" : `${value}%`;
+}
+
 function operatorRowLine(row) {
   return [
     display(row?.id),
@@ -1788,6 +2071,53 @@ function nextActionLabel(source) {
   return source?.recommended_action_label || source?.next_action?.label || source?.cta?.label;
 }
 
+function entityLabel(entity) {
+  if (!entity) return "";
+
+  const name = entity.display_name || entity.name || entity.prefix_id || entity.id;
+  const id = entity.prefix_id || entity.id;
+  return id && id !== name ? `${display(name)} (${display(id)})` : display(name);
+}
+
+function timingLabel(nextAction, row) {
+  const timing = nextAction.timing || {};
+  const mode = timing.mode || row.timing_mode;
+  const scheduledFor = timing.scheduled_for || row.scheduled_for;
+  const parts = compactText([
+    mode,
+    scheduledFor ? `scheduled for ${scheduledFor}` : null
+  ]);
+
+  return parts.join(", ");
+}
+
+function targetLabel(nextAction) {
+  const target = nextAction.target || {};
+  return compactText([
+    target.platform,
+    target.profile_url,
+    target.post_url,
+    target.message_event_id ? `message ${target.message_event_id}` : null,
+    target.post_id ? `post ${target.post_id}` : null
+  ]).join(" | ");
+}
+
+function ctaLabel(cta) {
+  const action = compactText([cta.action || cta.type, cta.platform ? `on ${cta.platform}` : null]).join(" ");
+  const disabled = cta.disabled ? "disabled" : "enabled";
+  return `${display(cta.label, "Unnamed CTA")}${action ? ` (${action})` : ""}${cta.disabled === undefined ? "" : `, ${disabled}`}`;
+}
+
+function draftLabel(draft) {
+  const required = draft.required === true ? "required" : draft.required === false ? "not required" : null;
+  const ready = draft.ready === true ? "ready" : draft.ready === false ? "not ready" : null;
+  return compactText([draft.state, ready, required]).join(", ") || "unknown";
+}
+
+function compactText(values) {
+  return values.map((value) => String(value || "").trim()).filter(Boolean);
+}
+
 function successCount(payload) {
   if (Array.isArray(payload?.added)) return payload.added.length;
   if (Array.isArray(payload?.removed)) return payload.removed.length;
@@ -2036,14 +2366,19 @@ const HELP_TOPICS = new Map([
     "  audienti prospects write <prsp_id> --type <surface_key> [--json]",
     "  audienti prospects add-note <prsp_id> --message <text> [--json]",
     "  audienti prospects add-steer <prsp_id> --message <text> [--json]",
+    "  audienti prospects add-profile <prsp_id> --url <profile_url|email|phone> [--json]",
+    "  audienti prospects report-bad-profile <prsp_id> <prof_id|citation_id> [--json]",
     "  audienti prospects sequence-preview <prsp_id> [--json]",
     "  audienti prospects sequence-export <prsp_id> [--csv]",
     "  audienti prospects import <linkedin_url> [--list <list_id>] [--motion <motn_id>] [--json]",
     "  audienti prospects import-status <primp_id> [--json]",
     "  audienti tools get <email|phone> --url <linkedin_url> [--json]",
-    "  audienti operator next [--json]",
+    "  audienti operator next [--json|--plan|--done|--skip|--fail|--return]",
     "  audienti operator queue [--json]",
     "  audienti operator outcome <row_id> --payload <file.json> [--json]",
+    "  audienti analytics prospects [--window 24h] [--user <account_user_id|email|name|me>] [--json]",
+    "  audienti analytics visibility [--window 24h] [--user <account_user_id|email|name|me>] [--json]",
+    "  audienti analytics content [--window 24h] [--user <account_user_id|email|name|me>] [--json]",
     "",
     "Planned submit-shape help topics:",
     "  audienti prospects disposition help",
@@ -2734,6 +3069,8 @@ const HELP_TOPICS = new Map([
     "  audienti prospects write <prsp_id> --type <surface_key> [--json]",
     "  audienti prospects add-note <prsp_id> --message <text> [--json]",
     "  audienti prospects add-steer <prsp_id> --message <text> [--json]",
+    "  audienti prospects add-profile <prsp_id> --url <profile_url|email|phone> [--json]",
+    "  audienti prospects report-bad-profile <prsp_id> <prof_id|citation_id> [--json]",
     "  audienti prospects sequence-preview <prsp_id> [--json]",
     "  audienti prospects sequence-export <prsp_id> [--csv]",
     "  audienti prospects import <linkedin_url> [--list <list_id>] [--motion <motn_id>] [--json]",
@@ -2945,6 +3282,60 @@ const HELP_TOPICS = new Map([
     "  }"
   ].join("\n")],
 
+  ["prospects add-profile", [
+    "Usage:",
+    `  ${PROSPECTS_ADD_PROFILE_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Add a profile, email address, or phone number to an existing prospect through the same add-profile path used by the prospect show page.",
+    "",
+    "Input shape:",
+    "  prsp_id: prsp_ prospect prefix id",
+    "  url: supported profile URL, plain email address, mailto: URL, plain phone number, or tel: URL",
+    "",
+    "Output shape:",
+    "  prospect: prospect summary",
+    "  profile: attached profile with prefix_id, citation_id, identifier, username, url, and status",
+    "  status: attached | already_attached",
+    "",
+    "API:",
+    "  POST /api/v1/accounts/:account_id/prospects/:id/profiles.json",
+    "",
+    "JSON body:",
+    "  {",
+    "    \"url\": \"prospect@example.com\"",
+    "  }"
+  ].join("\n")],
+
+  ["prospects report-bad-profile", [
+    "Usage:",
+    `  ${PROSPECTS_REPORT_BAD_PROFILE_USAGE.slice("Usage: ".length)}`,
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Report one of a prospect's attached profiles as bad through the same report action used by the prospect show page.",
+    "",
+    "Input shape:",
+    "  prsp_id: prsp_ prospect prefix id",
+    "  prof_id: prof_ prefix id or citation id such as email/profile:name@example.com",
+    "",
+    "Output shape:",
+    "  prospect: prospect summary",
+    "  profile: reported profile",
+    "  status: reported",
+    "",
+    "API:",
+    "  POST /api/v1/accounts/:account_id/prospects/:id/report_bad_profile.json",
+    "",
+    "JSON body:",
+    "  {",
+    "    \"profile_id\": \"prof_abc123\"",
+    "  }"
+  ].join("\n")],
+
   ["prospects sequence-preview", [
     "Usage:",
     "  audienti prospects sequence-preview <prsp_id> [--json] [--connection-state <state>] [--account <acct_id>]",
@@ -3109,11 +3500,11 @@ const HELP_TOPICS = new Map([
 
   ["operator", [
     "Usage:",
-    "  audienti operator next [--json]",
+    "  audienti operator next [--json|--plan|--done|--skip|--fail|--return]",
     "  audienti operator queue [--json]",
     "  audienti operator outcome <row_id> --payload <file.json>",
     "",
-    "Status: read commands and prospect outcome writeback implemented",
+    "Status: read commands and prospect next-move writeback implemented",
     "",
     "Filters:",
     "  --principal <account_user_id>",
@@ -3126,10 +3517,19 @@ const HELP_TOPICS = new Map([
 
   ["operator next", [
     "Usage:",
-    "  audienti operator next [--json] [filters] [--account <acct_id>]",
+    "  audienti operator next [--json|--plan|--done|--skip|--fail|--return] [filters] [--note <text>] [--account <acct_id>]",
     "",
     "Status: implemented",
     "",
+    "Options:",
+    "  --plan  Render a deterministic static plan from the existing next-action coach payload, CTA, and operator draft state",
+    "  --done  Mark the current next prospect move completed through the operator outcome API",
+    "  --skip  Mark the current next prospect move skipped through the operator outcome API",
+    "  --fail  Mark the current next prospect move failed through the operator outcome API",
+    "  --return  Mark the current next prospect move returned through the operator outcome API",
+    "  --note <text>  Optional outcome note used with --done, --skip, --fail, or --return",
+    "  --occurred-at <ISO8601>  Optional completion timestamp used with an outcome flag",
+    "",
     "Output shape:",
     "  next_move.id: row id",
     "  next_move.prospect.prefix_id: prsp_ | null",
@@ -3141,7 +3541,8 @@ const HELP_TOPICS = new Map([
     "  metrics: queue-builder metrics",
     "",
     "API:",
-    "  GET /api/v1/accounts/:account_id/operator/next.json"
+    "  GET /api/v1/accounts/:account_id/operator/next.json",
+    "  POST /api/v1/accounts/:account_id/operator/outcome.json when an outcome flag is used"
   ].join("\n")],
 
   ["operator queue", [
@@ -3187,6 +3588,84 @@ const HELP_TOPICS = new Map([
     "  POST /api/v1/accounts/:account_id/operator/outcome.json"
   ].join("\n")],
 
+  ["analytics", [
+    "Usage:",
+    "  audienti analytics prospects [--window 24h] [--user <account_user_id|email|name|me>] [--json]",
+    "  audienti analytics visibility [--window 24h] [--user <account_user_id|email|name|me>] [--json]",
+    "  audienti analytics visops [--window 24h] [--user <account_user_id|email|name|me>] [--json]",
+    "  audienti analytics content [--window 24h] [--user <account_user_id|email|name|me>] [--json]",
+    "",
+    "Status: implemented",
+    "",
+    "Window:",
+    "  --window <24h|7d|1w|day|week>",
+    "  --user <account_user_id|email|name|me>  Narrow analytics to one account user. Email/name partials are accepted when they match exactly one account user.",
+    "",
+    "Output:",
+    "  Account-scoped analytics for prospects, visibility engagement, and ContentOps publishing."
+  ].join("\n")],
+
+  ["analytics prospects", [
+    "Usage:",
+    "  audienti analytics prospects [--window 24h] [--user <account_user_id|email|name|me>] [--json] [--account <acct_id>]",
+    "",
+    "Status: implemented",
+    "",
+    "Output shape:",
+    "  prospects_added_count: account prospects added in the window",
+    "  account_user: selected account user when --user is provided, otherwise null",
+    "  actions: outbound action totals, type breakdown, and automated percentage",
+    "  queue_stages[]: current account prospect stage counts",
+    "",
+    "API:",
+    "  GET /api/v1/accounts/:account_id/analytics/prospects.json"
+  ].join("\n")],
+
+  ["analytics prospect", [
+    "Usage:",
+    "  audienti analytics prospect [--window 24h] [--user <account_user_id|email|name|me>] [--json] [--account <acct_id>]",
+    "",
+    "Alias for `audienti analytics prospects`."
+  ].join("\n")],
+
+  ["analytics visibility", [
+    "Usage:",
+    "  audienti analytics visibility [--window 24h] [--user <account_user_id|email|name|me>] [--json] [--account <acct_id>]",
+    "",
+    "Status: implemented",
+    "",
+    "Output shape:",
+    "  unique_people_engaged_count: unique prospects or profiles touched by visibility actions in the window",
+    "  account_user: selected account user when --user is provided, otherwise null",
+    "  engagements: visibility action totals, type breakdown, and automated percentage",
+    "",
+    "API:",
+    "  GET /api/v1/accounts/:account_id/analytics/visibility.json"
+  ].join("\n")],
+
+  ["analytics visops", [
+    "Usage:",
+    "  audienti analytics visops [--window 24h] [--user <account_user_id|email|name|me>] [--json] [--account <acct_id>]",
+    "",
+    "Alias for `audienti analytics visibility`."
+  ].join("\n")],
+
+  ["analytics content", [
+    "Usage:",
+    "  audienti analytics content [--window 24h] [--user <account_user_id|email|name|me>] [--json] [--account <acct_id>]",
+    "",
+    "Status: implemented",
+    "",
+    "Output shape:",
+    "  account_user: selected account user when --user is provided, otherwise null",
+    "  published_posts_count: ContentOps work items published in the window",
+    "  stage_breakdown[]: current ContentOps work item stage counts",
+    "  execution_status_breakdown[]: current ContentOps execution status counts",
+    "",
+    "API:",
+    "  GET /api/v1/accounts/:account_id/analytics/content.json"
+  ].join("\n")],
+
   ["agent-workflows", [
     "Usage:",
     "  audienti help agent-workflows",
@@ -3220,6 +3699,8 @@ const HELP_TOPICS = new Map([
     "  audienti prospects show <prsp_id>",
     "  audienti prospects timeline <prsp_id> --types post,comment,reaction --json",
     "  audienti prospects message-types <prsp_id>",
+    "  audienti prospects add-profile <prsp_id> --url prospect@example.com",
+    "  audienti prospects report-bad-profile <prsp_id> <prof_id>",
     "  audienti prospects add-note <prsp_id> --type steer --message \"Meeting will not happen\" --engagement-type action.meeting.canceled",
     "  audienti prospects sequence-preview <prsp_id>",
     "  audienti prospects sequence-export <prsp_id> --csv",
@@ -3230,9 +3711,15 @@ const HELP_TOPICS = new Map([
     "",
     "6. Work the operator queue",
     "  audienti operator next",
+    "  audienti operator next --plan",
     "  audienti operator queue --json",
     "  audienti operator outcome <row_id> --payload <file.json>",
     "",
+    "7. Inspect account analytics",
+    "  audienti analytics prospects --window 24h",
+    "  audienti analytics visibility --window 24h --user me",
+    "  audienti analytics content --window week",
+    "",
     "Good defaults:",
     "  Use --json when another tool or agent will parse the result.",
     "  Use --account <acct_id> to avoid mutating the saved account during one-off runs.",