@letterstory/cli 0.33.3 → 0.33.5

package/lib/cli.mjs

@@ -45,7 +45,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.33.3";
+export const VERSION = "0.33.5";
 
 // 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

@@ -170,6 +170,12 @@ export const ARGS = {
 		// `[{"name":"...","treatment":"never"|"mention_once"|"mention_often"|"lead_company",
 		// "linkable":false}, ...]` (linkable optional, default true).
 		entities: { value: (flags) => readJsonFileFlag(flags, "entities-file") },
+		// Your own guidance for the writer (2026-09-25): how to write, not what is true. Sent
+		// on its own field and appended AFTER the claims are read from the input, so nothing in
+		// it becomes a claim the article must carry. Inline for a sentence, a file for a page.
+		directives: {
+			value: (flags) => flagStr(flags.directives) ?? readTextFileFlag(flags, "directives-file"),
+		},
 	},
 	create_kernel_endpoint: {
 		name: { flag: "name", required: true },
@@ -246,10 +252,46 @@ async function kernelStatus(ctx) {
 	const { client, positionals, flags, io } = ctx;
 	const jobId = requirePositional(positionals, 0, "kernel-job-id");
 	const result = await client.callTool("get_kernel_run_status", { kernel_job_id: jobId });
+	printRecordLine(ctx, result);
 	printResult(io, flags, result);
 	return 0;
 }
 
+/**
+ * THE RECORD'S HEADLINE, one line, on a done run — the same `verification.service` both poll
+ * tools return (get_kernel_run_status for an article-bound run, get_kernel_endpoint_run for a
+ * standalone one), so a reader at a terminal sees "invented 0" before the JSON. Quiet under
+ * --json / --quiet like every other `ok` line. The full record is in the JSON below it.
+ */
+export function recordSummaryLine(result) {
+	const service = toolField(result, "verification")?.service;
+	if (!service || typeof service !== "object") return null;
+	const parts = [];
+	const s = service.sentences;
+	if (s && typeof s === "object") {
+		if (typeof s.supported === "number") parts.push(`${s.supported} supported`);
+		if (typeof s.contradicted === "number" || typeof s.unreferenced === "number")
+			parts.push(`${(s.contradicted ?? 0) + (s.unreferenced ?? 0)} invented`);
+		if (typeof s.dropped === "number") parts.push(`${s.dropped} dropped`);
+	}
+	const h = service.held;
+	if (h && typeof h.blocks === "number") parts.push(`held ${h.restored ?? 0}/${h.blocks}`);
+	const c = service.attachments?.citations;
+	if (c && typeof c.expected === "number") parts.push(`citations ${c.carried ?? 0}/${c.expected}`);
+	if (typeof service.shape?.title_held === "boolean")
+		parts.push(service.shape.title_held ? "title held" : "title not held");
+	if (typeof service.length?.delta === "number") {
+		const pct = Math.round(service.length.delta * 100);
+		parts.push(`length ${pct >= 0 ? "+" : ""}${pct}%`);
+	}
+	return parts.length ? `Record: ${parts.join(" \u00B7 ")}` : null;
+}
+
+function printRecordLine(ctx, result) {
+	const line = recordSummaryLine(result);
+	if (line) ok(ctx, line);
+}
+
 /* ------------------------------------------------------------------ */
 /* The standalone endpoint: prose back, nothing written into an article */
 /* ------------------------------------------------------------------ */
@@ -424,6 +466,7 @@ async function kernelRunStatus(ctx) {
 	const { client, positionals, flags, io } = ctx;
 	const runId = requirePositional(positionals, 0, "run-id");
 	const result = await client.callTool("get_kernel_endpoint_run", { run_id: runId });
+	printRecordLine(ctx, result);
 	printResult(io, flags, result);
 	return 0;
 }

package/package.json

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