@letterstory/cli 0.176.91 → 0.176.93

package/lib/cli.mjs

@@ -86,7 +86,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.91";
+export const VERSION = "0.176.93";
 
 /** 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;
@@ -354,6 +354,8 @@ export const BOOLEAN_FLAGS = new Set([
 	"consent",
 	"no-redesign",
 	"no-test-mode",
+	"first-touch-only",
+	"no-first-touch-only",
 	"no-unsubscribe-links",
 	"now",
 	"opt-out-footer",
@@ -1640,6 +1642,7 @@ Sequences (multi-step cold email sent from your mailers; approving or enrolling
            [--[no-]opt-out-footer] [--[no-]postal-address-footer] [--[no-]unsubscribe-links] [--[no-]detect-reply-opt-outs]
            [--[no-]test-mode] [--default-lede <fallback opener line>]
            [--send-window-start <HH:MM>] [--send-window-end <HH:MM>] [--send-window-timezone <IANA tz>]
+           [--daily-send-cap <n>|none] [--[no-]first-touch-only]
                                                        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>]
@@ -1648,6 +1651,7 @@ Sequences (multi-step cold email sent from your mailers; approving or enrolling
            [--[no-]test-mode] [--default-lede <fallback opener line>]
            [--send-window-start <HH:MM>] [--send-window-end <HH:MM>] [--send-window-timezone <IANA tz>]
            [--enroll-on-cake paid|scheduled|out_for_delivery|delivered|none] [--enroll-on-cake-list <list-id>|none]
+           [--daily-send-cap <n>|none] [--[no-]first-touch-only]
                                                        --test-mode (internal accounts only): walks as live, sends nothing
                                                        --enroll-on-cake: start it when a recipient's Daymaker cake reaches that stage
                                                        --enroll-on-cake-list: only for prospects in that list (none = any)
@@ -1686,8 +1690,10 @@ Prospects (who you write to):
                                                        --find-emails: look up the business email of rows with a
                                                        LinkedIn URL and no email (paid; default 25 lookups)
   prospects source --description <who you want> [--list <list-id>|--list-name <n>] [--limit <1..100>]
-           [--one-per-company] [--enrich]              Fill a list from paid data providers (background);
-                                                       --enrich starts enrichment as soon as the pull lands
+           [--one-per-company] [--enrich] [--exclude-platform webflow]...
+                                                       Fill a list from paid data providers (background);
+                                                       --enrich starts enrichment as soon as the pull lands;
+                                                       --exclude-platform leaves out sites built on it
   prospects enrich [--list <list-id>] [--status <s>] [--q <search>]
                                                        Funding + competitors for un-enriched rows
   prospects openers <list-id> [--group <ledes-group-id>|--new-group <name>]

package/lib/commands/admin.mjs

@@ -5172,6 +5172,8 @@ function recipeDetail(r) {
 		`${pad}recipe:           ${v.recipe || "—"}`,
 		`${pad}when to use:      ${v.when_to_use || "—"}`,
 		`${pad}when not to use:  ${v.when_not_to_use || "—"}`,
+		// The facts it cannot run without (the fit holds it back in code); unset is the legacy rule until reviewed.
+		`${pad}required inputs:  ${v.requires == null ? "not reviewed (the legacy rule)" : v.requires.join(", ") || "none"}`,
 	];
 	return [
 		`${r.name}  weight ${r.weight}/10  ${r.id}`,
@@ -5186,8 +5188,13 @@ function recipeDetail(r) {
 					`  its prompt:       ${r.automation.prompt}`,
 				]
 			: []),
-		...(r.primitives_access ? ["  letter's tools:   its build may use them (primitives_access)"] : []),
-		...(r.immediate ? ["  immediate:        a quick win: the Plan puts one in every top three"] : []),
+		...(r.tool_access
+			? [
+					`  letter's tools:   its build needs ${r.tool_access.required?.join(", ") || "none named"}; may write ${r.tool_access.writes?.join(", ") || "nothing"} (tool_access)`,
+				]
+			: r.primitives_access
+				? ["  letter's tools:   its build may read the account through them (primitives_access)"]
+				: []),
 		...(variations.length > 1
 			? variations.flatMap((v, i) => [`  variation ${i + 1}: ${v.name}`, ...fields(v, "    ")])
 			: fields(r, "  ")),
@@ -5240,7 +5247,7 @@ function recipeFromFlags(flags) {
 		// --primitives-access true hands a start's build Letter's own tools; false takes them away.
 		primitives_access:
 			flags["primitives-access"] === undefined ? undefined : String(flags["primitives-access"]) === "true",
-		// --immediate true marks a quick win (live within a day): the Plan puts one in every top three.
+		// --immediate is accepted for old scripts and read by nothing: a quick row is one whose runs is empty.
 		immediate: flags.immediate === undefined ? undefined : String(flags.immediate) === "true",
 		// --reads llms_txt,github declares the facts its conditions rest on; --reads "" clears them.
 		reads: flagStr(flags.reads)

package/lib/commands/outbound.mjs

@@ -89,6 +89,22 @@ const SEQUENCE_WINDOW_ARGS = {
 	send_window_end_minute: { value: windowMinute("send-window-end") },
 	send_window_timezone: "send-window-timezone",
 };
+// --daily-send-cap <n|none>: the most emails the sequence sends per UTC day across its mailers;
+// --first-touch-only: only people no other sequence has written to.
+const SEQUENCE_LIMIT_ARGS = {
+	daily_send_cap: {
+		value: (flags) => {
+			const raw = flagStr(flags["daily-send-cap"]);
+			if (raw === undefined) return undefined;
+			if (raw === "none") return null;
+			const n = Number(raw);
+			if (!Number.isInteger(n) || n < 1 || n > 500)
+				throw new CliError(`--daily-send-cap takes 1–500 or none (got ${raw})`);
+			return n;
+		},
+	},
+	first_touch_only: { flag: "first-touch-only", type: "bool", negate: "no-first-touch-only" },
+};
 // --enroll-on-cake <stage>: start the sequence when a recipient's Daymaker cake
 // reaches it; `none` clears it.
 const CAKE_TRIGGER_STAGES = ["paid", "scheduled", "out_for_delivery", "delivered"];
@@ -169,6 +185,7 @@ export const ARGS = {
 		mailer_ids: mailerIds,
 		...SEQUENCE_RAIL_ARGS,
 		...SEQUENCE_WINDOW_ARGS,
+		...SEQUENCE_LIMIT_ARGS,
 		enroll_on_cake: enrollOnCake,
 		enroll_on_cake_list_id: enrollOnCakeList,
 	},
@@ -180,6 +197,7 @@ export const ARGS = {
 		mailer_ids: mailerIds,
 		...SEQUENCE_RAIL_ARGS,
 		...SEQUENCE_WINDOW_ARGS,
+		...SEQUENCE_LIMIT_ARGS,
 		enroll_on_cake: enrollOnCake,
 		enroll_on_cake_list_id: enrollOnCakeList,
 	},
@@ -291,6 +309,7 @@ export const ARGS = {
 		list_name: "list-name",
 		limit: { flag: "limit", type: "num" },
 		one_per_company: { flag: "one-per-company", type: "bool" },
+		exclude_platforms: { flag: "exclude-platform", type: "list" },
 		enrich: { flag: "enrich", type: "bool" },
 	},
 	enrich_prospects: {

package/package.json

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