@series-a/cli 0.7.1 → 0.15.1

package/CHANGELOG.md

@@ -4,6 +4,61 @@ All notable changes to this package are documented here. This project follows
 [Semantic Versioning](https://semver.org/) and uses
 [Changesets](https://github.com/changesets/changesets) to manage releases.
 
+## 0.15.0 — Newsletter audiences and sending
+
+- `advisoros audiences create|edit|delete|add-leads|remove-leads` — full CRUD for smart audiences (lead segments), not just read + enrol.
+- `advisoros newsletter audience-create|audience-show|audience-edit|audience-delete` — manage mailing audiences; mirrored to Resend automatically when the workspace has it connected, local-only when it does not.
+- `advisoros newsletter contact-add|contacts-import|contact-remove|contact-unsubscribe` — contact management including CSV bulk import.
+- `advisoros newsletter sync-segment <segmentId> <audienceId>` — push a smart audience's leads into a mailing audience.
+- `advisoros newsletter send|test|render|metrics` — send now, schedule, test-send, render HTML, and read delivery totals, open/click/bounce rates and sending health.
+- New Agent API actions on `audiences` and `newsletter`; MCP gains `manage_audience` and `send_newsletter` (44 tools, manifest 0.12.0).
+
+## 0.14.0 — Daily reports
+
+- `advisoros reports list` — browse persisted daily reports (past and present) per workspace, with status, activity totals and recipient/sent counts.
+- `advisoros reports show <id|YYYY-MM-DD>` — full report detail including stats and the shareable dashboard URL.
+- `advisoros reports generate` — run the daily-report engine on demand; dry-run by default, `--send` emails all workspace members, `--to <email>` sends a single test copy.
+- Backed by the new Agent API `daily_reports` resource (`list` / `get` / `generate`).
+
+## 0.13.0 — Full lifecycle + scheduling engine
+
+- Campaign lifecycle is complete from the terminal: `campaigns update` (name, goal, sequence, sender accounts, daily send limit — no longer create-time-only), `launch`, `pause`, `resume`, `archive`, `clone`, and `delete` (dry-run preview by default, `--force` to execute, blocked when the campaign has dispatched activity unless forced).
+- Sequence editing: `sequences update-step`, `delete-step`, and `replace-steps` — steps are no longer append-only. Graph validation flags disconnected nodes and cycles before launch.
+- Scheduling engine awareness: calendar/schedule commands report whether a workspace will publish via Taplio (when connected) or the built-in cron scheduler, so automation targets the right engine.
+- Live counts after writes: campaign and sequence mutations re-read the record and return live stats, clearly separated from the stored snapshot which may lag.
+- Clearer errors under load: the API now returns a typed 429 with retry-after guidance instead of empty lists during heavy automation; the CLI surfaces this plainly.
+
+## 0.12.0 — Agent audit trail
+
+- `advisoros audit list/show/stats` — query the durable per-workspace audit log of every CLI/MCP/Agent API action (actor, surface, action, outcome, duration, correlation ID).
+- CLI requests now send actor/client/version headers so audit records attribute actions to the right user and CLI version.
+- `login` persists the profile email for audit attribution.
+
+## 0.11.0 — Video management
+
+- `videos` resource group: `list`, `show`, `create`, `generate`, `update`, `publish`, `unpublish`, `refresh`, `delete` against video projects, with workspace scoping and destructive-action confirmation.
+
+## 0.10.0 — Calendar & Command Centre write access
+
+- Full content calendar read/write/delete/schedule via CLI, with bulk operations and engine-aware scheduling (Taplio when connected, built-in cron otherwise).
+- Command Centre content management: update, approve, schedule, unschedule, and publish-now actions.
+
+## 0.9.0 — Tone of Voice
+
+- Full Tone of Voice support: workspace configuration, writing-sample references, benchmark pinning, voice cards, scoring/redrafting, and report CRUD.
+
+## 0.8.0 — Content Strategy
+
+- Full content strategy read/write: create, list, show, update, delete strategies; manage strategy posts; retry/resume generation.
+
+## 0.7.0 — Hardening & admin keys
+
+- Shared typed errors with machine-readable codes across all commands.
+- Cursor pagination up to 1,000 items per page.
+- Destructive actions require explicit confirmation (`--confirm` / `--force`).
+- `login --admin` for admin API keys, `--as-agent` impersonation flag, and `whoami` scope reporting.
+- Admin keys (`advos_admin_…`) authorize from key scope alone and work across all workspaces.
+
 ## 0.6.1 — Campaign editing
 
 - `campaigns` — added `update`/`edit` (name, description, goal, sequence, sender accounts, daily send limit, launch stage, status). Mirrors the new `update_campaign` MCP tool.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@series-a/cli",
-  "version": "0.7.1",
+  "version": "0.15.1",
   "description": "AdvisorPro command-line interface — drive leads, campaigns, sequences and agents from your terminal.",
   "type": "module",
   "bin": {

package/src/api.mjs

@@ -1,5 +1,15 @@
+import { randomUUID } from "node:crypto";
+import { createRequire } from "node:module";
 import { getProfile, DEFAULTS } from "./config.mjs";
 
+const CLI_VERSION = (() => {
+  try {
+    return createRequire(import.meta.url)("../package.json").version;
+  } catch {
+    return "unknown";
+  }
+})();
+
 export class AdvisorOSApiError extends Error {
   constructor(message, { status, body } = {}) {
     super(message);
@@ -32,6 +42,11 @@ export async function call(resource, action, params = {}, opts = {}) {
     stored?.agentName ||
     "advisoros-cli";
 
+  const actorEmail =
+    opts.actorEmail || process.env.ADVISOROS_ACTOR_EMAIL || stored?.email || null;
+  const actorUserId =
+    opts.actorUserId || process.env.ADVISOROS_ACTOR_USER_ID || stored?.userId || null;
+
   if (!apiKey) {
     throw new AdvisorOSApiError(
       "No API key configured. Run `advisoros login` or set ADVISOROS_API_KEY.",
@@ -59,6 +74,12 @@ export async function call(resource, action, params = {}, opts = {}) {
       headers: {
         "Content-Type": "application/json",
         "x-service-account-key": apiKey,
+        "x-surface": "cli",
+        "x-client-name": "advisoros-cli",
+        "x-client-version": CLI_VERSION,
+        "x-correlation-id": opts.correlationId || randomUUID(),
+        ...(actorUserId ? { "x-actor-user-id": actorUserId } : {}),
+        ...(actorEmail ? { "x-actor-email": actorEmail } : {}),
       },
       body: JSON.stringify(body),
     });

package/src/commands/auth.mjs

@@ -14,6 +14,7 @@ export function registerAuth(program) {
     .option("--admin", "admin key login — verify cross-workspace, no workspace required", false)
     .option("--base-url <url>", "agent-api base URL", DEFAULTS.baseUrl)
     .option("--as-agent <name>", "caller identity to send as agent_name", "advisoros-cli")
+    .option("--email <email>", "your email — recorded on the audit trail for every action")
     .action(async (opts) => {
       try {
         let { apiKey, workspace, baseUrl, profile } = opts;
@@ -49,7 +50,7 @@ export function registerAuth(program) {
             apiKey, baseUrl, agentName,
           });
           const count = verify?.pagination?.total ?? verify?.workspaces?.length ?? 0;
-          await setProfile(profile, { apiKey, baseUrl, admin: true, agentName, ...(workspace ? { workspaceId: workspace } : {}) });
+          await setProfile(profile, { apiKey, baseUrl, admin: true, agentName, ...(opts.email ? { email: opts.email } : {}), ...(workspace ? { workspaceId: workspace } : {}) });
           process.stdout.write(chalk.green(
             `\n✓ Logged in as admin profile "${profile}" — ${count} workspaces reachable\n` +
             `  Config: ${CONFIG_PATH}\n` +
@@ -63,7 +64,7 @@ export function registerAuth(program) {
           apiKey, workspaceId: workspace, baseUrl, agentName,
         });
         const count = verify?.agents?.length ?? 0;
-        await setProfile(profile, { apiKey, workspaceId: workspace, baseUrl, agentName });
+        await setProfile(profile, { apiKey, workspaceId: workspace, baseUrl, agentName, ...(opts.email ? { email: opts.email } : {}) });
         process.stdout.write(chalk.green(
           `\n✓ Logged in as profile "${profile}" — workspace ${workspace} (${count} agents visible)\n` +
           `  Config: ${CONFIG_PATH}\n`,