@letterstory/cli 0.177.9 → 0.177.11

package/lib/cli.mjs

@@ -68,6 +68,7 @@ import {
 	cmdAsk,
 	cmdIdeas,
 	cmdPlan,
+	cmdMemory,
 	cmdSite,
 	cmdEvals,
 	cmdOfferings,
@@ -87,7 +88,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.177.9";
+export const VERSION = "0.177.11";
 
 /** 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;
@@ -100,6 +101,11 @@ export const BOOLEAN_FLAGS = new Set([
 	"connect-only",
 	// admin demo ideas: every live recipe, not only the Ideas that fit.
 	"library",
+	// admin demo sweep: prepare each recipe's org for a person to start, pull requests, make orgs, skip the refit.
+	"prepare",
+	"pull-requests",
+	"make-orgs",
+	"no-refit",
 	// admin targets check: check every target again, checked or not.
 	"recheck",
 	// build list: also move the builds' open changes along while polling.
@@ -430,6 +436,8 @@ export const BOOLEAN_FLAGS = new Set([
 	"dry",
 	// admin billing emails --bounced
 	"bounced",
+	// `memory ingest --include-website` reads the org's own site too: value-less.
+	"include-website",
 	// models add: train once the links are added. models confirm: keep the found links not named, or don't train yet.
 	"train",
 	"keep-rest",
@@ -1204,6 +1212,14 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
   admin demo check <org-id>                            Is it ready to show? Competitors, targets, answers, the
                                                        Plan's rows, the issues open, no PR open, GitHub, the
                                                        phantom's site. Exits 1 when not ready.
+  admin demo ideas <org-id> [--library] [--preview] [--force] | --status [--id <run>]
+                                                       Start every Idea on a demo org for real (pull requests, or
+                                                       previews), or read how the latest run went.
+  admin demo sweep [--prepare] [--pull-requests] [--recipes a,b] [--orgs a,b] [--exclude a,b] [--buy a,b] [--make-orgs] [--no-refit] | --status [--id <sweep>]
+                                                       Every live recipe end to end: each gets a test org whose Ideas
+                                                       offers it, its Start pressed (or, with --prepare, left for you
+                                                       to press in the app), and its outcome judged, with who owns a
+                                                       failure. Exits 1 when the sweep failed.
   admin brand-detection <org-id> [--term <t>]... [--exact <t>]... [--exclude <phrase>]... [--note "…"] | --clear [--note "…"]
                                                        How a client's brand is detected in AI answers, with
                                                        every earlier setting; with flags, set the exact set
@@ -1793,6 +1809,10 @@ Insights:
   plan later remove <queued-id>                        Take a queued row back off
   plan strategies [--site host] [--archived]           The goals typed on Ideas, each a strategy
   plan strategy add "<words…>" [--site host]           Keep a goal in your words as a strategy
+  plan strategy archive <strategy-id> [--restore]      Put one away (its card leaves the Plan), or bring it back
+  memory ingest [--text|--text-file <path|->] [--link <url>]… [--include-website] [--mcp-url <url>]  Push context to Memory: a reviewable proposal
+  memory apply <ingestion-id> --changes <id>,<id>       Save the proposed changes you accept
+  memory add --section <id> --body <text> [--title] [--origin]  File one entry in a custom memory section
   plan strategy archive <strategy-id> [--restore]      Put one away (its goal leaves Ideas), or bring it back
   insights summary [--period …] [--part <block>]...    Measure Overview: AI named/cited rates, share of voice, search, targets
   insights reads [--period …] [--site all|own|phantoms|<key>]... [--path <path>] [--engine <operator>]
@@ -2190,6 +2210,7 @@ const CLIENT_COMMANDS = {
 	ask: cmdAsk,
 	ideas: cmdIdeas,
 	plan: cmdPlan,
+	memory: cmdMemory,
 	site: cmdSite,
 	evals: cmdEvals,
 	visits: cmdVisits,

package/lib/commands/admin.mjs

@@ -6910,7 +6910,7 @@ const DEMO_ITEM_FLAGS = [
 	"setup",
 ];
 const DEMO_USAGE =
-	"Usage: admin demo guide | list [--enrollable] | show <org-id> [--moves] | set <org-id> [--enroll] [--unenroll] [--file <state.json>] [--phantom parked|shown] [--main-blog …] [--visitors …] [--probes not_run|shown] [--cms hidden|shown] [--publish-target …] [--search-console …] [--github …] [--domain …] [--setup fresh|finished] [--domain-cap n] [--inject <key>]... [--hide <key>]... [--save-as <name>] [--baseline <owner/repo>[@sha] | --clear-baseline] [--copy-from <org-id> [--copy-scenarios a,b] [--overwrite]] [--auto-reset <scenario>|off] [--every <minutes>] [--release] | domains | new <domain> [--name <n>] [--brief <t>] [--full] [--host vercel|pages] [--no-wait] | teardown <org-id> [--keep-repo] | bootstrap <org-id>... --from <org-id> [--scenarios a,b] [--overwrite] | reset <org-id> <scenario> [--clean-slate] [--close-prs since_applied|all_open|none] [--hold <minutes>] [--restore-repo revert|force] [--rebuild] [--reread-company] [--forget-company] [--forget-site] | check <org-id> | ideas <org-id> [--library] [--preview] [--force] | ideas <org-id> --status [--id <run-id>]";
+	"Usage: admin demo guide | list [--enrollable] | show <org-id> [--moves] | set <org-id> [--enroll] [--unenroll] [--file <state.json>] [--phantom parked|shown] [--main-blog …] [--visitors …] [--probes not_run|shown] [--cms hidden|shown] [--publish-target …] [--search-console …] [--github …] [--domain …] [--setup fresh|finished] [--domain-cap n] [--inject <key>]... [--hide <key>]... [--save-as <name>] [--baseline <owner/repo>[@sha] | --clear-baseline] [--copy-from <org-id> [--copy-scenarios a,b] [--overwrite]] [--auto-reset <scenario>|off] [--every <minutes>] [--release] | domains | new <domain> [--name <n>] [--brief <t>] [--full] [--host vercel|pages] [--no-wait] | teardown <org-id> [--keep-repo] | bootstrap <org-id>... --from <org-id> [--scenarios a,b] [--overwrite] | reset <org-id> <scenario> [--clean-slate] [--close-prs since_applied|all_open|none] [--hold <minutes>] [--restore-repo revert|force] [--rebuild] [--reread-company] [--forget-company] [--forget-site] | check <org-id> | ideas <org-id> [--library] [--preview] [--force] | ideas <org-id> --status [--id <run-id>] | sweep [--prepare] [--pull-requests] [--recipes <id>,…] [--orgs <id>,…] [--exclude <id>,…] [--buy <recipe-id>,…] [--make-orgs] [--no-refit] | sweep --status [--id <sweep-id>]";
 
 const readinessLines = (r) =>
 	r
@@ -6936,6 +6936,49 @@ const ideasRunLines = (run) =>
 			].join("\n")
 		: "No run yet.";
 
+const SWEEP_MARK = {
+	ready: "READY",
+	passed: "PASS",
+	failed: "FAIL",
+	waiting: "WAIT",
+	held: "HELD",
+	no_org: "NO ORG",
+	not_derivable: "NO PROFILE",
+	pending: "…",
+};
+
+/** A recipe sweep's report (get_recipe_sweep), one block per recipe. */
+const recipeSweepLines = (sweep, appUrl) =>
+	sweep
+		? [
+				`${sweep.summary}  (${sweep.state}${sweep.note && sweep.state !== "done" ? `: ${sweep.note}` : ""})`,
+				`${sweep.start ? "started by the sweep" : "prepared for you to start"}, ${sweep.delivery === "build" ? "previews" : "pull requests"}, by ${sweep.started_by_name ?? "staff"} at ${sweep.created_at}  sweep ${sweep.id}`,
+				...sweep.items.map((i) =>
+					[
+						`\n${(SWEEP_MARK[i.result] ?? i.result).padEnd(10)} ${i.name}`,
+						i.org ? `  org: ${i.org.name} (${i.org.host})${i.org.made ? ", made for it" : ""}` : null,
+						i.fit[0] ? `  fit: ${i.fit[0].fits}: ${i.fit[0].why}` : null,
+						i.row
+							? `  row: ${i.row.title}${i.row.line ? ` / ${i.row.line}` : ""}${i.row.button ? ` [${i.row.button}]` : ""}`
+							: null,
+						i.did
+							? `  did: ${i.did.tools.join(", ") || "no tools"}${i.did.sandbox ? ", a sandbox" : ""}${i.did.cost_usd != null ? `, $${i.did.cost_usd}` : ""}`
+							: null,
+						i.verdict ? `  outcome: ${i.verdict.state}: ${i.verdict.observed}` : null,
+						i.cause ? `  cause: ${i.cause.owner}: ${i.cause.why}` : null,
+						i.profile_problem ? `  profile: ${i.profile_problem}` : null,
+						i.profile?.unsettable?.length
+							? `  can't be made on a test org: ${i.profile.unsettable.map((u) => u.key).join(", ")}`
+							: null,
+						i.links?.ideas ? `  open: ${appUrl}${i.links.ideas}` : null,
+						i.links?.build ? `  build: ${appUrl}${i.links.build}` : null,
+					]
+						.filter(Boolean)
+						.join("\n")
+				),
+			].join("\n")
+		: "No sweep yet.";
+
 async function cmdAdminDemo(ctx) {
 	const { flags, positionals, io } = ctx;
 	const sub = positionals[0];
@@ -7194,6 +7237,30 @@ async function cmdAdminDemo(ctx) {
 			printResult(io, flags, result, (r) => ideasRunLines(r.run));
 			return result.run?.state === "failed" ? 1 : 0;
 		}
+		case "sweep": {
+			// Every live recipe end to end on test orgs (run_recipe_sweep), or the latest sweep's report (get_recipe_sweep).
+			const path = `${DEMO}/sweeps`;
+			const id = flagStr(flags.id);
+			const result =
+				flagBool(flags.status) || id
+					? await staffRequest(ctx, "GET", id ? `${path}?id=${encodeURIComponent(id)}` : path)
+					: await staffPost(
+							ctx,
+							path,
+							compact({
+								start: flagBool(flags.prepare) ? false : undefined,
+								delivery: flagBool(flags["pull-requests"]) ? "build_pr" : undefined,
+								recipes: flags.recipes ? flagList(flags.recipes) : undefined,
+								orgs: flags.orgs ? flagList(flags.orgs) : undefined,
+								exclude: flags.exclude ? flagList(flags.exclude) : undefined,
+								purchases: flags.buy ? flagList(flags.buy) : undefined,
+								make_orgs: flagBool(flags["make-orgs"]) || undefined,
+								refit: flagBool(flags["no-refit"]) ? false : undefined,
+							})
+						);
+			printResult(io, flags, result, (r) => recipeSweepLines(r.sweep, ctx.client.url));
+			return result.sweep?.state === "failed" ? 1 : 0;
+		}
 		default:
 			throw new CliError(DEMO_USAGE);
 	}

package/lib/commands/memory.mjs

@@ -0,0 +1,88 @@
+// `memory` — push context into Memory from a terminal, the way an agent does it over the MCP: thin wrappers over
+// the same tools, nothing of their own.
+//   memory ingest [--text <t>|--text-file <path|->] [--link <url>]… [--include-website] [--mcp-url <url> [--mcp-token <t>] [--mcp-focus <words>]]
+//                                              → ingest_context (a reviewable proposal; nothing is saved yet)
+//   memory apply <ingestion-id> --changes <change-id>[,<change-id>…]   → apply_context (saves the accepted changes)
+//   memory add --section <id> (--body <t>|--body-file <path|->) [--title <t>] [--origin <where it was read>]
+//                                              → add_memory_entry (one entry in a custom section)
+
+import { CliError } from "../client.mjs";
+import { argsFromFlags, flagCsv, flagStr, printResult, readTextInput, refuseUnknownFlags } from "./shared.mjs";
+
+export const ARGS = {
+	ingest_context: {
+		text: { value: (flags) => readTextInput(flags, "text", "text-file") },
+		links: { flag: "link", type: "list" },
+		include_website: { flag: "include-website", type: "bool" },
+		mcp_servers: {
+			value: (flags) => {
+				const url = flagStr(flags["mcp-url"]);
+				const token = flagStr(flags["mcp-token"]);
+				const focus = flagStr(flags["mcp-focus"]);
+				if (!url) return undefined;
+				return [{ url, ...(token ? { authorization_token: token } : {}), ...(focus ? { focus } : {}) }];
+			},
+		},
+	},
+	apply_context: {
+		ingestion_id: { positional: 0, required: true, label: "ingestion-id" },
+		accepted_change_ids: { value: (flags) => flagCsv(flags.changes) },
+	},
+	add_memory_entry: {
+		section_id: { flag: "section", required: true },
+		body: { value: (flags) => readTextInput(flags, "body", "body-file") },
+		title: "title",
+		origin: "origin",
+	},
+};
+
+export async function cmdMemory(ctx) {
+	const { client, flags, io } = ctx;
+	const sub = ctx.positionals[0];
+	const rest = ctx.positionals.slice(1);
+	if (sub === "ingest") {
+		refuseUnknownFlags(ctx, ARGS.ingest_context, ["text-file", "mcp-url", "mcp-token", "mcp-focus"]);
+		const args = argsFromFlags(ARGS.ingest_context, flags, rest);
+		if (!args.text && !args.links?.length && !args.include_website && !args.mcp_servers) {
+			throw new CliError(
+				"Give it something to read: --text, --text-file, --link, --include-website or --mcp-url."
+			);
+		}
+		const result = await client.callTool("ingest_context", args);
+		printResult(io, flags, result, (r) =>
+			[
+				`Pass ${r.ingestion_id}: ${r.summary}`,
+				`${r.changes.length} proposed change${r.changes.length === 1 ? "" : "s"}. Nothing is saved yet.`,
+				...r.changes.map((c) => `  ${c.id}  [${c.area}] ${c.label}`),
+				r.changes.length ? `Save the ones you accept: memory apply ${r.ingestion_id} --changes <id>,<id>` : "",
+			]
+				.filter(Boolean)
+				.join("\n")
+		);
+		return 0;
+	}
+	if (sub === "apply") {
+		refuseUnknownFlags(ctx, ARGS.apply_context, ["changes"]);
+		const args = argsFromFlags(ARGS.apply_context, flags, rest);
+		if (!args.accepted_change_ids?.length) throw new CliError("Say which changes to save: --changes <id>[,<id>…].");
+		const result = await client.callTool("apply_context", args);
+		printResult(
+			io,
+			flags,
+			result,
+			(r) => `Saved ${r.applied_change_ids.length} change${r.applied_change_ids.length === 1 ? "" : "s"}.`
+		);
+		return 0;
+	}
+	if (sub === "add") {
+		refuseUnknownFlags(ctx, ARGS.add_memory_entry, ["body-file"]);
+		const args = argsFromFlags(ARGS.add_memory_entry, flags, rest);
+		if (!args.body) throw new CliError("Say what to remember: --body <text> or --body-file <path|->.");
+		const result = await client.callTool("add_memory_entry", args);
+		printResult(io, flags, result, (r) => `Filed${r.entry?.id ? `: ${r.entry.id}` : ""}.`);
+		return 0;
+	}
+	throw new CliError(
+		"Usage: memory ingest [--text|--text-file|--link|--include-website|--mcp-url] | memory apply <ingestion-id> --changes <ids> | memory add --section <id> --body <text>"
+	);
+}

package/lib/commands.mjs

@@ -48,6 +48,7 @@ export * from "./commands/repo.mjs";
 export * from "./commands/build.mjs";
 export * from "./commands/ask.mjs";
 export * from "./commands/plan.mjs";
+export * from "./commands/memory.mjs";
 export * from "./commands/site.mjs";
 export * from "./commands/evals.mjs";
 export * from "./commands/visits.mjs";

package/lib/documents.mjs

@@ -59,6 +59,8 @@ export const DOCUMENT_FLAG_PAIRS = [
 	["body", "file"],
 	["brief", "brief-file"],
 	["text", "text-file"],
+	// `memory add --body-file`: one entry's prose.
+	["body", "body-file"],
 	// An offering's (or the company's) manifesto is prose — a PDF or a .docx is fair game.
 	["manifesto", "manifesto-file"],
 	// A repo change's brief (repo.mjs `repo start`) — prose, so a .docx or PDF spec is fine.

package/package.json

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