@letterstory/cli 0.70.1 → 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.1";
+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.

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/package.json

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