@audienti/cli 0.1.4 → 0.1.6

package/CHANGELOG.md

@@ -4,6 +4,38 @@ All notable changes to the Audienti CLI are documented here.
 
 ## [Unreleased]
 
+## [0.1.6] - 2026-07-12
+
+### Added
+
+- Add `audienti writer test-run <prsp_id>` for a single-prospect campaign preview with the no-reply path, planned actions, channel changes, and drafted messages, plus `--mode plan` and `--mode step --step <step_key|row_number>` for fast simulator and targeted writer-debug runs.
+- Add `audienti analytics prospects --cohort-start YYYY-MM-DD --cohort-end YYYY-MM-DD` to inspect prospects by the `AccountProspect.created_at` cohort while keeping `--window` for activity counts.
+- Add `audienti analytics prospects cohort-analysis --weeks <n>` to compare recent weekly prospect cohorts by current pipeline-stage counts.
+- Add `--motion <motn_id>` to prospect analytics so cohorts can be narrowed to one motion/play.
+- Add `--provenance <source>` to prospect analytics for lower-level intake source filters.
+- Add `audienti analytics users --user me` for account-user action audit analytics with date-range, cohort, motion, and provenance filters.
+- Add `audienti motions analytics <motn_id>` to inspect one motion's produced-day prospect cohorts, current active/inactive mix, and funnel stages from `AccountProspect.created_at`.
+
+### Changed
+
+- Group root help by work area and common workflow so `audienti help` is easier to scan.
+
+## [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

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
@@ -45,11 +52,80 @@ Common inspection commands:
 
 ```bash
 audienti operator next --plan
+audienti writer test-run <prsp_id>
+audienti motions analytics <motn_id>
+audienti prospects show <prsp_id> --json
+audienti prospects list --profiles
 audienti analytics prospects --window 24h
+audienti analytics users --user me --window 30d
 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 inspect activity for prospects that entered the account during a specific
+cohort while keeping a separate activity window:
+
+```bash
+audienti analytics prospects --cohort-start 2026-07-01 --cohort-end 2026-07-07 --window 7d
+```
+
+To compare recent weekly prospect cohorts by their current pipeline stages:
+
+```bash
+audienti analytics prospects cohort-analysis --weeks 4 --motion <motn_id>
+```
+
+To see whether one motion is producing prospects by day, and where each
+produced-day cohort currently sits in the funnel:
+
+```bash
+audienti motions analytics <motn_id>
+```
+
+To audit one account user's outbound actions, optionally narrowed to one motion
+and one AccountProspect.created_at cohort:
+
+```bash
+audienti analytics users --user me --start 2026-07-01 --end 2026-07-07 --cohort-start 2026-06-01 --cohort-end 2026-06-30 --motion <motn_id>
+```
+
+To run a writer campaign test for one prospect, including the no-reply path,
+planned actions, channel changes, and drafted messages:
+
+```bash
+audienti writer test-run <prsp_id>
+```
+
+For fast simulator work, plan the branches without drafting every message:
+
+```bash
+audienti writer test-run <prsp_id> --mode plan
+```
+
+For writer debugging, draft only one selected timeline row on one branch:
+
+```bash
+audienti writer test-run <prsp_id> --mode step --branch no-accept --step 3
+```
+
+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.4",
+  "version": "0.1.6",
   "description": "Agent-first command-line client for Audienti.",
   "type": "module",
   "bin": {
@@ -10,6 +10,7 @@
     "bin/",
     "src/",
     "skills/",
+    "install",
     "README.md",
     "LICENSE",
     "CHANGELOG.md"

package/skills/audienti/SKILL.md

@@ -19,7 +19,7 @@ audienti --help
 2. If it is unavailable, install the public package:
 
 ```bash
-npm install --global @audienti/cli
+curl -fsSL https://cli.audienti.com/install | bash
 ```
 
 3. Authentication is explicit and per machine. Do not ask a user to paste a

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",
@@ -219,6 +233,10 @@ export class AudientiClient {
     return this.requestJson(accountPath(accountId, ["analytics", "prospects"], query));
   }
 
+  analyticsUsers(accountId, query = {}) {
+    return this.requestJson(accountPath(accountId, ["analytics", "users"], query));
+  }
+
   analyticsVisibility(accountId, query = {}) {
     return this.requestJson(accountPath(accountId, ["analytics", "visibility"], query));
   }
@@ -308,6 +326,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;