@letterstory/cli 0.25.1 → 0.25.2

package/lib/cli.mjs

@@ -44,7 +44,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.25.1";
+export const VERSION = "0.25.2";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value.

package/lib/commands/kernel.mjs

@@ -78,28 +78,32 @@ export const ARGS = {
 		// it from a path. Omit both to write from the article as it stands.
 		brief: { value: (flags) => flagStr(flags.brief) ?? readBodyInput({ file: flagStr(flags["brief-file"]) }) },
 	},
-	// The standalone door. Two subcommands share this one tool: `write` sends a `brief`,
-	// `polish` sends a `document`; the map is one, so a field the tool gains is a field
-	// BOTH subcommands must learn (or knowingly gap) — that is the ratchet.
+	// The standalone door. Two subcommands share this one tool: `write` and `polish` both
+	// send `input`, `polish` forcing content_kind to "document" — the map is one, so a field
+	// the tool gains is a field BOTH subcommands must learn (or knowingly gap) — that is the
+	// ratchet.
 	run_kernel: {
 		endpoint_id: { positional: 0, label: "endpoint-id", required: true },
-		brief: { value: (flags, _p, extra) => (extra.door === "brief" ? readBodyInput(flags) : undefined) },
-		document: { value: (flags, _p, extra) => (extra.door === "document" ? readBodyInput(flags) : undefined) },
-		// Documented dead field on the tool; accepted so an old --format still validates.
-		format: { flag: "format", enum: ["auto", "html", "markdown"] },
+		input: { value: (flags) => readBodyInput(flags) },
 		kernel_id: "kernel",
 		target_word_count: { flag: "words", type: "num" },
-		content_type: "content-type",
+		label: "label",
 		// The flag is --read-as, which is what shipped; an earlier draft called it --brief-mode.
-		brief_mode: { flag: "read-as", enum: ["auto", "brief", "content", "blog", "outline", "research", "notes"] },
+		content_kind: {
+			flag: "read-as",
+			enum: ["auto", "instruction", "document", "article", "outline", "research", "notes"],
+		},
 		// The two products, in one run: every round is shredded before the kernel's jury sees
 		// it, so the verdict lands on the text that actually ships. Costs a shred as well as a
 		// run.
 		shredder_endpoint_id: "shredder",
 		shred_aggression: { flag: "shred-aggression", enum: ["standard", "high", "max"] },
-		person: { flag: "person", enum: ["third", "first_plural", "first_singular"] },
-		author_name: "author",
-		allow_experience_claims: { flag: "experience-claims", type: "bool" },
+		voice: {
+			object: {
+				person: { flag: "person", enum: ["third", "first_plural", "first_singular"] },
+				allow_experience_claims: { flag: "experience-claims", type: "bool" },
+			},
+		},
 		// The mechanism's full contract, declared on the door (2026-09-17, Kernels wave step 1).
 		// A shape and a typed brief are files, not flags — `--skeleton-file shape.json` is the
 		// field a template resolves to, sent by a caller who has their own.
@@ -123,12 +127,13 @@ export const ARGS = {
 				evidence: { value: (flags) => readTextFileFlag(flags, "shred-evidence-file") },
 			},
 		},
-		// Named-entity treatment (2026-09-17): a list, not a scalar flag, so it's a file like
-		// skeleton/brief_json — `--entities-file entities.json` of `[{"name":"...","treatment":
-		// "never"|"name_only"|"subtle"|"woven"|"lead"}, ...]`.
+		// Named-entity treatment (2026-09-17, renamed 2026-09-18): a list, not a scalar flag,
+		// so it's a file like skeleton/brief_json — `--entities-file entities.json` of
+		// `[{"name":"...","treatment":"never"|"mention_once"|"mention_often"|"lead_company",
+		// "linkable":false}, ...]` (linkable optional, default true).
 		entities: { value: (flags) => readJsonFileFlag(flags, "entities-file") },
-		// document-only: hold the document's own shape through the edit. Default true; pass
-		// --no-preserve-shape to let the kernel restructure freely.
+		// content_kind "document" only: hold the document's own shape through the edit. Default
+		// true; pass --no-preserve-shape to let the kernel restructure freely.
 		preserve_shape: { flag: "preserve-shape", type: "bool" },
 	},
 	create_kernel_endpoint: {
@@ -228,8 +233,8 @@ async function kernelEndpoints(ctx) {
 
 async function kernelWrite(ctx) {
 	const { client, positionals, flags, io } = ctx;
-	const args = argsFromFlags(ARGS.run_kernel, flags, positionals, { door: "brief" });
-	if (args.brief === undefined) {
+	const args = argsFromFlags(ARGS.run_kernel, flags, positionals);
+	if (args.input === undefined) {
 		throw new CliError("Provide the brief with --body <text>, --file <path>, or --file - (stdin).");
 	}
 	const result = await client.callTool("run_kernel", args);
@@ -322,22 +327,24 @@ async function kernelEndpoint(ctx) {
 
 /**
  * The OTHER door: run the same pipeline against a document you already have, instead of
- * writing a new one. Skips generation only — the rules, the in-loop shred and the jury all
- * still run, which is what keeps your own markup (images, embeds, links, tables, anchors,
- * shortcodes) intact through a real pass rather than an unguarded shortcut.
+ * writing a new one. Decomposed into a brief and GENERATED FRESH (content_kind: "document",
+ * forced below) — not edited in place — with your own headings and embedded media (images,
+ * tables) extracted first and spliced back into the generated draft afterward, so they
+ * survive a pass that would otherwise be text-only and lose them.
  *
  * ASYNCHRONOUS, same as `write` — this used to be a separate, synchronous, unmetered "polish"
- * that answered in one request. That path was deleted (2026-09-15, letterstory#1783): it
- * worked by skipping the rules and the jury, and that was the actual cost of being instant
- * and free. `document` now costs a run and follows the identical submit-and-poll shape
+ * that answered in one request, and before that an EARLIER `document` mode that skipped
+ * generation to hold shape "in place." Neither exists any more (2026-09-15, letterstory#1783;
+ * 2026-09-17). `document` now costs a run and follows the identical submit-and-poll shape
  * `write` does, so this command does too — `--no-wait` behaves the same way here.
  */
 async function kernelPolish(ctx) {
 	const { client, positionals, flags, io } = ctx;
-	const args = argsFromFlags(ARGS.run_kernel, flags, positionals, { door: "document" });
-	if (args.document === undefined) {
+	const args = argsFromFlags(ARGS.run_kernel, flags, positionals);
+	if (args.input === undefined) {
 		throw new CliError("Provide the document with --body <text>, --file <path>, or --file - (stdin).");
 	}
+	args.content_kind = args.content_kind ?? "document";
 	const result = await client.callTool("run_kernel", args);
 	const runId = toolField(result, "run_id");
 	if (!runId) {

package/package.json

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