@letterstory/cli 0.30.0 → 0.31.0

package/lib/cli.mjs

@@ -44,7 +44,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.30.0";
+export const VERSION = "0.31.0";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value.
@@ -560,14 +560,18 @@ Ledes (opening lines for cold email, chosen per prospect from a hand-approved li
            [--company <c>] [--company-url <url>] [--school <s>] [--city <c>] [--country <c>]
            [--years <n>] [--linkedin <url>] [--notes <text>]
            [--candidates <1..10>] [--tone warm|direct|playful|formal] [--no-enrich]
+           [--deadline-ms <2000..120000>]
                                                        Synchronous: prints the candidate lines with the
                                                        top choice flagged. Needs at least one of
                                                        --first-name, --name, --email, --company or
                                                        --company-url. Only a match consumes a lede;
                                                        no_match is free. --no-enrich skips the company
                                                        lookup when latency matters more than fit.
+                                                       --deadline-ms leaves out evidence that cannot
+                                                       arrive in time (fewer lines may qualify).
   lede runs [--endpoint <id>] [--limit <n>]            Recent lede calls (telemetry), newest first
   lede history [<domain>] [--days <n>] [--limit <n>]   Openers already sent to an account
+  lede evals [--sweep]                                 Lede quality evals still above zero
   lede balance                                         Ledes left on this org
 
 Landings (a link + context; auto-mentioned in articles by collections you enable):

package/lib/commands/lede.mjs

@@ -57,11 +57,17 @@ export const ARGS = {
 		default_lede: { flag: "default-lede" },
 		// Enrichment is ON by default server-side; `--no-enrich` skips it for latency.
 		enrich: { value: (flags) => (flags["no-enrich"] === true ? false : undefined) },
+		// A latency budget: optional evidence that cannot arrive in time is left out.
+		deadline_ms: { flag: "deadline-ms", type: "num" },
 	},
 	list_lede_runs: {
 		endpoint_id: "endpoint",
 		limit: { flag: "limit", type: "num" },
 	},
+	// The state of the quality exercise: which evals still count above zero.
+	lede_eval_briefing: {
+		sweep: { value: (flags) => (flags.sweep === true ? true : undefined) },
+	},
 	// What has already been said to an account, so the next send does not repeat it.
 	lede_account_history: {
 		domain: { positional: 0, label: "domain" },
@@ -111,11 +117,14 @@ export async function cmdLede(ctx) {
 		case "history":
 		case "sent":
 			return ledeHistory(rest);
+		case "evals":
+		case "briefing":
+			return ledeEvals(rest);
 		case "balance":
 			return ledeBalance(rest);
 		default:
 			throw new CliError(
-				`Unknown lede subcommand: ${sub ?? "(none)"}. Try: list, create, delete, endpoint, run, runs, history, balance`
+				`Unknown lede subcommand: ${sub ?? "(none)"}. Try: list, create, delete, endpoint, run, runs, history, evals, balance`
 			);
 	}
 }
@@ -239,6 +248,15 @@ async function ledeHistory(ctx) {
 	return 0;
 }
 
+// `lede evals [--sweep]` — which categories of false positive still count above zero.
+// The exercise is finished when total_hits reads zero and no new flags are arriving.
+async function ledeEvals(ctx) {
+	const { client, flags, io } = ctx;
+	const result = await client.callTool("lede_eval_briefing", argsFromFlags(ARGS.lede_eval_briefing, flags));
+	printResult(io, flags, result);
+	return 0;
+}
+
 async function ledeBalance(ctx) {
 	const { client, flags, io } = ctx;
 	const result = await client.callTool("get_lede_balance", argsFromFlags(ARGS.get_lede_balance, flags));

package/package.json

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