@letterstory/cli 0.177.10 → 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.10";
+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;
@@ -435,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",
@@ -1806,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>]
@@ -2203,6 +2210,7 @@ const CLIENT_COMMANDS = {
 	ask: cmdAsk,
 	ideas: cmdIdeas,
 	plan: cmdPlan,
+	memory: cmdMemory,
 	site: cmdSite,
 	evals: cmdEvals,
 	visits: cmdVisits,

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.10",
+	"version": "0.177.11",
 	"description": "Spin up and manage Letter phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",