@letterstory/cli 0.33.6 → 0.33.8

package/lib/cli.mjs

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

@@ -109,6 +109,7 @@ export const ARGS = {
 		input: { value: (flags) => readBodyInput(flags) },
 		kernel_id: "kernel",
 		target_word_count: { flag: "words", type: "num" },
+		target_word_tolerance: { flag: "words-tolerance", type: "num" },
 		label: "label",
 		// The flag is --read-as, which is what shipped; an earlier draft called it --brief-mode.
 		content_kind: {
@@ -218,6 +219,22 @@ export const ARGS = {
 		kernel_id: { positional: 1, label: "kernel-id", required: true },
 		eval_id: { positional: 2, label: "eval-id", required: true },
 	},
+	update_kernel: {
+		kernel_id: { positional: 0, label: "kernel-id", required: true },
+		name: "name",
+		description: "description",
+		// A whole-document JSON file, same reasoning as add_kernel_custom_eval's detector/repair:
+		// register/humor/inquisitive/notes together are a real object, not four independent
+		// flags — kernelVoiceConfigSchema requires register/humor/inquisitive all at once, so a
+		// partial flag set would just fail the tool's own validation anyway.
+		voice_config: { value: (flags) => readJsonFileFlag(flags, "voice-config-file") },
+	},
+	archive_kernel: {
+		kernel_id: { positional: 0, label: "kernel-id", required: true },
+	},
+	get_kernel_endpoint_run_steps: {
+		run_id: { positional: 0, label: "run-id", required: true },
+	},
 };
 
 export async function cmdKernel(ctx) {
@@ -237,6 +254,10 @@ export async function cmdKernel(ctx) {
 			return kernelEndpoint(rest);
 		case "eval":
 			return kernelEval(rest);
+		case "update":
+			return kernelUpdate(rest);
+		case "archive":
+			return kernelArchive(rest);
 		case "write":
 			return kernelWrite(rest);
 		case "polish":
@@ -249,7 +270,7 @@ export async function cmdKernel(ctx) {
 			return kernelBalance(rest);
 		default:
 			throw new CliError(
-				`Unknown kernel subcommand: ${sub ?? "(none)"}. Try: list, endpoints, endpoint, eval, write, polish, run-status, runs, balance, run, status`
+				`Unknown kernel subcommand: ${sub ?? "(none)"}. Try: list, endpoints, endpoint, eval, update, archive, write, polish, run-status, runs, balance, run, status`
 			);
 	}
 }
@@ -472,6 +493,39 @@ async function kernelEval(ctx) {
 	throw new CliError(`Unknown kernel eval action: ${action ?? "(none)"}. Try: add, rm`);
 }
 
+/**
+ * `kernel update <kernel-id>` — name/description/voice on an org-owned kernel. Raw
+ * prompt/config editing stays staff-only (the app's own developer console), same as always.
+ */
+async function kernelUpdate(ctx) {
+	const { client, positionals, flags, io } = ctx;
+	const args = argsFromFlags(ARGS.update_kernel, flags, positionals);
+	if (args.name === undefined && args.description === undefined && args.voice_config === undefined) {
+		throw new CliError("Provide at least one of --name, --description, --voice-config-file <path>.");
+	}
+	const result = await client.callTool("update_kernel", args);
+	ok(ctx, `Updated kernel ${args.kernel_id}.`);
+	printResult(io, flags, result);
+	return 0;
+}
+
+/**
+ * `kernel archive <kernel-id>` — never a hard delete; every run it ever produced keeps its
+ * attribution. Requires --yes, same as every other destructive kernel/endpoint command.
+ */
+async function kernelArchive(ctx) {
+	const { client, positionals, flags, io } = ctx;
+	const args = argsFromFlags(ARGS.archive_kernel, flags, positionals);
+	if (!flags.yes) {
+		io.error(`Re-run with --yes to confirm: ${ctx.bin} kernel archive ${args.kernel_id} --yes`);
+		return 1;
+	}
+	const result = await client.callTool("archive_kernel", args);
+	ok(ctx, `Archived kernel ${args.kernel_id}.`);
+	printResult(io, flags, result);
+	return 0;
+}
+
 /**
  * The OTHER door: run the same pipeline against a document you already have, instead of
  * writing a new one. Decomposed into a brief and GENERATED FRESH (content_kind: "article",
@@ -535,6 +589,16 @@ async function kernelPolish(ctx) {
 async function kernelRunStatus(ctx) {
 	const { client, positionals, flags, io } = ctx;
 	const runId = requirePositional(positionals, 0, "run-id");
+	if (flags.steps === true) {
+		// The round-by-round draft trace instead of the run summary — the same view the app's
+		// kernel detail page shows as its version-diff and rule-trip panels.
+		const result = await client.callTool(
+			"get_kernel_endpoint_run_steps",
+			argsFromFlags(ARGS.get_kernel_endpoint_run_steps, flags, positionals)
+		);
+		printResult(io, flags, result);
+		return 0;
+	}
 	const result = await client.callTool("get_kernel_endpoint_run", { run_id: runId });
 	printRecordLine(ctx, result);
 	printResult(io, flags, result);

package/package.json

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