@audienti/cli 0.1.5 → 0.1.6

package/CHANGELOG.md

@@ -4,6 +4,22 @@ 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

package/README.md

@@ -52,9 +52,12 @@ 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
 ```
@@ -67,6 +70,52 @@ 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:
 

package/package.json

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

package/src/api-client.js

@@ -233,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));
   }