@letterstory/cli 0.176.29 → 0.176.30

package/lib/cli.mjs

@@ -83,7 +83,7 @@ import {
 import { fetchParkedSections, withoutParked } from "./parked.mjs";
 
 // Matches cli/package.json; publish-cli.yml rewrites both to the published version.
-export const VERSION = "0.176.29";
+export const VERSION = "0.176.30";
 
 /** The exit code for a gate refusal (CARD_REQUIRED, PAYMENT_FAILED, OUT_OF_TOKENS): 1 is a plain error. */
 export const EXIT_PAYMENT_REQUIRED = 3;
@@ -1247,6 +1247,11 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
           | record-outcome <account-id> <kind> [--reason code] [--also a,b] [--cause …] [--notice-at ISO]
                      [--at ISO] [--mrr-before N] [--mrr-after N] [--note "…"] [--save-offer …]
                      [--save-result …] [--draft]
+          | highlights [--account <id>] [--days N] [--limit N]   customer love, newest first
+          | highlights-scan [--days 7] [--offset N] [--limit N] [--min-strength 3] [--as-of ISO]
+                     a dry run over the calls: every moment the model finds, posting nothing
+          | highlights-post --picks-file picks.json [--verdict keep|pass]   post picks from a scan
+          | highlights-reorder [--before-ts ts] [--limit N]   repost every clip in call order (deletes old posts)
           | renewals [--days 90]
           | reach-outs [--day YYYY-MM-DD] [--fresh]   the day's reach-outs, N of 5 (#crm-reminders' count)
           | replies [--days 14]               replies nobody has answered yet, newest first

package/lib/commands/admin.mjs

@@ -14,7 +14,7 @@
 //      The old names — evals, eval-add, eval-set, proposals, propose-eval, capture-eval, reject-eval — still work.)
 //   admin evals scoreboard|cases|runs|run|triage|guard|retire …                      (fleet:read / tuning:experiment)
 //   admin fleet-experiments list|articles|clients|mark|unmark|new|assign|assign-eligible|assign-orgs|spin-up|apply|start|stop|decide …  (fleet:read / fleet:experiment)
-//   admin crm import|capture|outreach|signals|record|signal|add|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|revenue|reach-outs|replies|record-churn|draft-churn-reason|undo-churn|outcomes|record-outcome|renewals|track-record|weekly-note|at-risk|expansion-signals|collections|delivery-flags|pulse|client-health|case|onboard|onboarding|retry-onboarding|onboard-plan|payment-link …  (crm:read / crm:write)
+//   admin crm import|capture|outreach|signals|record|signal|add|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|revenue|reach-outs|replies|record-churn|draft-churn-reason|undo-churn|outcomes|record-outcome|highlights|highlights-scan|highlights-post|highlights-reorder|renewals|track-record|weekly-note|at-risk|expansion-signals|collections|delivery-flags|pulse|client-health|case|onboard|onboarding|retry-onboarding|onboard-plan|payment-link …  (crm:read / crm:write)
 //   admin spend summary|reconcile|pnl|margin|pricing|entries|add|import|usage|remove|reference|stripe-sync|services|service …  (spend:read / spend:write)
 //   admin brand-detection <org-id>                                                   (fleet:read)
 //   admin brand-detection <org-id> [--term t]... [--exact t]... [--exclude p]... [--note "…"] | --clear [--note "…"]   (fleet:instrument)
@@ -3595,6 +3595,82 @@ async function cmdAdminCrm(ctx) {
 					`${x.outcome.status === "draft" ? "drafted (a person confirms it)" : "recorded"}: ${outcomeLine(x.outcome)}`
 			);
 		}
+		case "highlights": {
+			// admin crm highlights [--account id] [--days N] [--limit N] — customer love, newest first.
+			const params = new URLSearchParams(
+				compact({ account_id: flagStr(flags.account), days: flagStr(flags.days), limit: flagStr(flags.limit) })
+			);
+			return out(await staffRequest(ctx, "GET", `${CRM}/highlights?${params}`), (r) =>
+				r.highlights.length
+					? r.highlights
+							.map(
+								(h) =>
+									`${h.occurredAt.slice(0, 10)}  ${h.accountName ?? "?"} · ${h.speakerName ?? "?"}  ${h.verdict ?? "undecided"}  s${h.strength ?? "-"}  "${h.quote.slice(0, 90)}"  ${h.id}`
+							)
+							.join("\n")
+					: "(no highlights)"
+			);
+		}
+		case "highlights-scan": {
+			// admin crm highlights-scan [--days 7] [--offset N] [--limit N] [--min-strength 3] [--as-of ISO]
+			// A dry run: every moment the model finds, posting nothing. --json for picks to post.
+			const params = new URLSearchParams(
+				compact({
+					days: flagStr(flags.days),
+					offset: flagStr(flags.offset),
+					limit: flagStr(flags.limit),
+					min_strength: flagStr(flags["min-strength"]),
+					as_of: flagStr(flags["as-of"]),
+				})
+			);
+			return out(await staffRequest(ctx, "GET", `${CRM}/highlights/backfill?${params}`), (r) =>
+				[
+					...r.calls.map((c) =>
+						[
+							`${c.occurredAt.slice(0, 10)}  ${c.accountName ?? c.companyLabel ?? "?"}  ${c.callName}  ${c.skipped ?? ""}`,
+							...c.moments.map(
+								(m) =>
+									`    s${m.strength} ${m.alreadyPosted ? "(posted) " : ""}${m.speakerLabel ?? m.speaker} ${Math.round(m.startSec)}-${Math.round(m.endSec)}s: "${m.quote.slice(0, 100)}"`
+							),
+						].join("\n")
+					),
+					r.nextOffset === null ? "(end)" : `more: --offset ${r.nextOffset} --as-of ${r.asOf}`,
+				].join("\n")
+			);
+		}
+		case "highlights-post": {
+			// admin crm highlights-post --picks-file picks.json [--verdict keep|pass]
+			// picks.json: [{ meeting_id, speaker, quote, start_sec, end_sec, strength }], as a scan returned them.
+			const picks = jsonFile(flags, "picks");
+			if (!Array.isArray(picks))
+				throw new CliError("Usage: admin crm highlights-post --picks-file picks.json [--verdict keep|pass]");
+			const r = await staffPost(
+				ctx,
+				`${CRM}/highlights/backfill`,
+				compact({ picks, verdict: flagStr(flags.verdict) })
+			);
+			return out(r, (x) =>
+				x.results
+					.map(
+						(p) =>
+							`${p.status}${p.clipped ? " (clip)" : ""}  ${p.externalId}${p.error ? `  ${p.error}` : ""}`
+					)
+					.join("\n")
+			);
+		}
+		case "highlights-reorder": {
+			// admin crm highlights-reorder [--before-ts ts] [--limit N] — reposts every clip in call order, deleting old posts.
+			const r = await staffPost(
+				ctx,
+				`${CRM}/highlights/reorder`,
+				compact({ before_ts: flagStr(flags["before-ts"]), limit: flagNum(flags.limit) })
+			);
+			return out(
+				r,
+				(x) =>
+					`reposted ${x.reposted}, ${x.remaining} to go${x.remaining ? ` (--before-ts ${x.beforeTs})` : ""}${x.stoppedOn ? `; stopped on ${x.stoppedOn.id}: ${x.stoppedOn.error}` : ""}`
+			);
+		}
 		case "renewals": {
 			// admin crm renewals [--days 90] — contracts renewing soon, and Stripe cancels scheduled.
 			const params = new URLSearchParams(compact({ days: flagStr(flags.days) }));
@@ -3887,7 +3963,7 @@ async function cmdAdminCrm(ctx) {
 		}
 		default:
 			throw new CliError(
-				"Usage: admin crm import|capture|outreach|signals|record|signal|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|revenue|reach-outs|replies|record-churn|draft-churn-reason|undo-churn|outcomes|record-outcome|renewals|track-record|weekly-note|at-risk|expansion-signals|collections|delivery-flags|pulse|client-health|case|onboard|onboarding|retry-onboarding|onboard-plan|prospect-org|prospect-orgs|prospect-org-repost|payment-link … (see --help)"
+				"Usage: admin crm import|capture|outreach|signals|record|signal|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|revenue|reach-outs|replies|record-churn|draft-churn-reason|undo-churn|outcomes|record-outcome|highlights|highlights-scan|highlights-post|highlights-reorder|renewals|track-record|weekly-note|at-risk|expansion-signals|collections|delivery-flags|pulse|client-health|case|onboard|onboarding|retry-onboarding|onboard-plan|prospect-org|prospect-orgs|prospect-org-repost|payment-link … (see --help)"
 			);
 	}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@letterstory/cli",
-	"version": "0.176.29",
+	"version": "0.176.30",
 	"description": "Spin up and manage Letter phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",