@letterstory/cli 0.48.0 → 0.49.1

package/README.md

@@ -388,6 +388,10 @@ letterstory admin crm slack-channels [--all]           # Watchdog channels + the
 letterstory admin crm link-slack <account-id> C0123ABC # the CRM's watch-only Slack link (`none` unlinks)
 letterstory admin crm import leads.csv --dry-run       # bulk-import leads: what would be created/matched
 letterstory admin crm import leads.csv --tag "YC W26"  # …and for real (dedupes by domain, then company name)
+letterstory admin crm capture thread.png --context "this is for tryordinal.com" --dry-run
+                                                       # a screenshot → a lead: what it read, which account
+letterstory admin crm capture thread.png --context "this is for tryordinal.com"  # …and for real
+letterstory admin crm capture --text-file notes.txt    # pasted text or notes work the same way
 
 # One-click onboarding of a won client (key needs crm:write + fleet:onboard + org:create)
 letterstory admin crm onboard <account-id> --domain acme.com \

package/lib/cli.mjs

@@ -54,7 +54,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.48.0";
+export const VERSION = "0.49.1";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value.
@@ -563,6 +563,8 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
                                                        ledger entry. Written by \`npm run lab --
                                                        publish\` in the kernels repo.
   admin crm import <file.csv> [--source <name>] [--tag "…"] [--dry-run]
+          | capture [shot.png …] [--text "…" | --text-file f] [--context "this is for acme.com"]
+                    [--account <id>] [--dry-run]   screenshots / a thread / a note → a lead
           | signals [--status new] [--intent qualified] [--source rb2b] [--account <id>]
           | record --title "…" [--source bookface] [--kind other] [--intent qualified]
                    [--name …] [--email …] [--company …] [--domain …] [--linkedin …] [--detail …]

package/lib/commands/admin.mjs

@@ -8,7 +8,7 @@
 //   admin tuning-context [--q "<question>"]                                         (tuning:experiment)
 //   admin tuning-import <brief-results.json> [--experiment <id>]                    (tuning:experiment)
 //   admin evals scoreboard|cases|runs|run|triage|guard|retire …                      (fleet:read / tuning:experiment)
-//   admin crm import|signals|record|signal|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|record-churn|undo-churn|onboard|onboarding|retry-onboarding|onboard-plan|payment-link …  (crm:read / crm:write)
+//   admin crm import|capture|signals|record|signal|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|record-churn|undo-churn|onboard|onboarding|retry-onboarding|onboard-plan|payment-link …  (crm:read / crm:write)
 //   admin create-org --domain acme.com [--name "Acme"] [--test] [--no-key] [--key-name N]
 //                    [--capabilities a,b] [--onboard] [--about "…"] [--sitemap <url>]
 //                    [--cms <provider>] [--posts N] [--seers suggest|skip] [--no-visuals]
@@ -627,6 +627,75 @@ function onboardBody(flags) {
 	});
 }
 
+const CRM_CAPTURE_TYPES = {
+	png: "image/png",
+	jpg: "image/jpeg",
+	jpeg: "image/jpeg",
+	gif: "image/gif",
+	webp: "image/webp",
+};
+
+/**
+ * `admin crm capture [image…] [--text "…" | --text-file f] [--context "this is for acme.com"]
+ * [--account id] [--dry-run]` — screenshots, a pasted thread or a note → a lead. The same
+ * captureLead the CRM's paste box and Slack's "Send to CRM" call (POST /api/superadmin/crm/capture).
+ */
+async function cmdAdminCrmCapture(ctx, paths) {
+	const { flags, io } = ctx;
+	const usage =
+		'Usage: admin crm capture [image.png …] [--text "…" | --text-file notes.txt] [--context "this is for acme.com"] [--account <id>] [--dry-run]';
+	const images = paths.map((path) => {
+		const media_type = CRM_CAPTURE_TYPES[path.split(".").pop()?.toLowerCase() ?? ""];
+		if (!media_type) throw new CliError(`${path}: only png, jpg, gif and webp screenshots can be read`);
+		try {
+			return { media_type, data: readFileSync(path).toString("base64") };
+		} catch (err) {
+			throw new CliError(`Could not read ${path}: ${err.message}`);
+		}
+	});
+	let text = flagStr(flags.text);
+	const textFile = flagStr(flags["text-file"]);
+	if (textFile) {
+		try {
+			text = readFileSync(textFile, "utf8");
+		} catch (err) {
+			throw new CliError(`Could not read ${textFile}: ${err.message}`);
+		}
+	}
+	if (images.length === 0 && !text) throw new CliError(usage);
+	const r = await staffPost(
+		ctx,
+		`${CRM}/capture`,
+		compact({
+			images: images.length ? images : undefined,
+			text,
+			context: flagStr(flags.context),
+			account_id: flagStr(flags.account),
+			source: flagStr(flags.source) ?? "agent",
+			dry_run: flagBool(flags["dry-run"]) || undefined,
+		})
+	);
+	if (flagBool(flags.json)) return printResult(io, flags, r);
+	const verb = r.dryRun
+		? r.accountId
+			? "would add to"
+			: "would create"
+		: r.duplicate
+			? "already captured →"
+			: r.accountCreated
+				? "created"
+				: "added to";
+	io.log(
+		`${verb} ${r.accountName ?? "a new account"}${r.accountUrl ? `  ${r.accountUrl}` : ""}${r.matchedVia ? `  (via ${r.matchedVia})` : ""}`
+	);
+	if (r.read) {
+		io.log(`  ${r.read.title}`);
+		if (r.contacts.length)
+			io.log(`  contacts: ${r.contacts.map((p) => p.name + (p.email ? ` <${p.email}>` : "")).join(", ")}`);
+		if (r.read.notes) io.log(`  notes: ${r.read.notes}`);
+	}
+}
+
 /**
  * `admin crm …` — the headless half of the staff CRM, so a background agent can watch the
  * pipeline and record the signals that have no webhook (Bookface, tweet likes, DMs).
@@ -641,6 +710,8 @@ async function cmdAdminCrm(ctx) {
 	switch (sub) {
 		case "import":
 			return cmdAdminCrmImport(ctx, id);
+		case "capture":
+			return cmdAdminCrmCapture(ctx, ctx.positionals.slice(1));
 		case "signals": {
 			const params = new URLSearchParams(
 				compact({
@@ -875,7 +946,7 @@ async function cmdAdminCrm(ctx) {
 		}
 		default:
 			throw new CliError(
-				"Usage: admin crm import|signals|record|signal|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|record-churn|undo-churn|onboard|onboarding|retry-onboarding|onboard-plan|payment-link … (see --help)"
+				"Usage: admin crm import|capture|signals|record|signal|accounts|account|score|slack-channels|link-slack|white-glove|set-white-glove|churn|record-churn|undo-churn|onboard|onboarding|retry-onboarding|onboard-plan|payment-link … (see --help)"
 			);
 	}
 }

package/lib/commands/kernel.mjs

@@ -123,6 +123,10 @@ export const ARGS = {
 		// field a template resolves to, sent by a caller who has their own.
 		skeleton: { value: (flags) => readJsonFileFlag(flags, "skeleton-file") },
 		brief_json: { value: (flags) => readJsonFileFlag(flags, "brief-json-file") },
+		// A deep patch over the kernel's config for THIS run only (2026-10-02): how a run names a
+		// writer without a new kernel version — `--config-patch-file patch.json` with
+		// `{ "model": "echo/echo" }`, `repairModel`, `quality.model` and the rest of the config.
+		config_patch: { value: (flags) => readJsonFileFlag(flags, "config-patch-file") },
 		// A TEMPLATE INSTEAD OF HAND-BUILDING THOSE. `--template <key>` resolves one of your
 		// templates against the material you sent and fills `skeleton`, `target_word_count` and
 		// `brief_json` for this call — and the finished run comes back ASSEMBLED rather than as

package/package.json

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