@letterstory/cli 0.70.0 → 0.70.2

package/README.md

@@ -398,6 +398,10 @@ export LETTERSTORY_STAFF_API_KEY=<your staff key with crm:read,crm:write>
 letterstory admin crm signals --status new             # the Inbound feed (unmatched signals)
 letterstory admin crm record --source bookface --kind message \
   --title "Asked about phantoms on Bookface" --name "Jane Doe" --company Acme --domain acme.com
+# Re-running that is a no-op: with no --external-id the intake derives an idempotency key from
+# the signal's content, so a retried agent loop cannot fill the feed with the same observation.
+# Pass --external-id when the source has a stable id (a thread id, a tweet id), or to record that
+# an otherwise identical signal happened AGAIN.
 letterstory admin crm record --source twitter --kind social_engagement \
   --title "Liked our launch tweet" --name "Pat" --linkedin https://linkedin.com/in/pat
 letterstory admin crm signal <signal-id> qualify       # link/create the account

package/lib/cli.mjs

@@ -56,7 +56,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.70.0";
+export const VERSION = "0.70.2";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value.
@@ -826,13 +826,15 @@ Sequences (multi-step cold email sent from your mailers; approving or enrolling
   sequences get <sequence-id>                          Flow, enrollments, who replied at each step
   sequences create --name <n> (--flow '<json>'|--flow-file <path>) [--mailer <mailer-id>]...
            [--[no-]opt-out-footer] [--[no-]postal-address-footer] [--[no-]unsubscribe-links] [--[no-]detect-reply-opt-outs]
-           [--[no-]test-mode] [--send-window-start <HH:MM>] [--send-window-end <HH:MM>] [--send-window-timezone <IANA tz>]
+           [--[no-]test-mode] [--default-lede <fallback opener line>]
+           [--send-window-start <HH:MM>] [--send-window-end <HH:MM>] [--send-window-timezone <IANA tz>]
                                                        New draft sequence (nothing sends yet; rails default on, opt-out line off;
                                                        sends 9:00-17:00 in each recipient's inferred timezone, else the sender's)
   sequences update <sequence-id> [--name <n>] [--flow '<json>'|--flow-file <path>]
            [--status draft|active|paused|archived] [--mailer <mailer-id>]...
            [--[no-]opt-out-footer] [--[no-]postal-address-footer] [--[no-]unsubscribe-links] [--[no-]detect-reply-opt-outs]
-           [--[no-]test-mode] [--send-window-start <HH:MM>] [--send-window-end <HH:MM>] [--send-window-timezone <IANA tz>]
+           [--[no-]test-mode] [--default-lede <fallback opener line>]
+           [--send-window-start <HH:MM>] [--send-window-end <HH:MM>] [--send-window-timezone <IANA tz>]
                                                        --test-mode (internal accounts only): walks as live, sends nothing
   sequences pause|resume <sequence-id>                 Stop / restart sending
   sequences enroll <sequence-id> (--list <list-id> | --email <addr>... | --recipients '<json>'|--recipients-file <path>)

package/lib/commands/admin.mjs

@@ -1795,8 +1795,15 @@ async function cmdAdminCrm(ctx) {
 			});
 			if (!body.title)
 				throw new CliError(
-					'Usage: admin crm record --title "Liked our launch tweet" [--source twitter] [--kind social_engagement] …'
+					'Usage: admin crm record --title "Liked our launch tweet" [--source twitter] [--kind social_engagement] [--external-id <id>] …'
 				);
+			// No local default for --external-id on purpose. The intake derives one
+			// from the signal's content when none is sent (deriveExternalId in
+			// src/lib/crm/signals-intake.ts), so a re-run is already a no-op and the
+			// rule lives in ONE place. Computing a second fingerprint here would be a
+			// copy that drifts, and it would differ from what a webhook or any other
+			// agent sends for the same observation. Pass --external-id when the source
+			// has a stable id of its own, or to say "this happened again".
 			const r = await staffPost(ctx, `${CRM}/signals`, body);
 			return out(r, (x) => `${x.duplicate ? "already recorded" : "recorded"}: ${signalLine(x.signal)}`);
 		}

package/lib/commands/outbound.mjs

@@ -61,6 +61,8 @@ const SEQUENCE_RAIL_ARGS = {
 	detect_reply_opt_outs: { flag: "detect-reply-opt-outs", type: "bool", negate: "no-detect-reply-opt-outs" },
 	// Staff-only to turn on (the server refuses it for anyone else): walks as live, sends nothing.
 	test_mode: { flag: "test-mode", type: "bool", negate: "no-test-mode" },
+	// The fallback opener line for recipients with no opener (blank clears it on update).
+	default_lede: "default-lede",
 };
 
 // A send-window edge from --<flag> HH:MM (or a raw minute of day) → the

package/package.json

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