@letterstory/cli 0.33.3 → 0.33.4

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.4";
 
 // 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

@@ -246,10 +246,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 +460,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.4",
 	"description": "Spin up and manage Letterstory phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",