@letterstory/cli 0.6.0 → 0.7.0

package/lib/cli.mjs

@@ -33,10 +33,11 @@ import {
 	cmdPhantomJob,
 	cmdSeers,
 	cmdTemplates,
+	cmdShredder,
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.6.0";
+export const VERSION = "0.7.0";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value.
@@ -267,6 +268,14 @@ Content templates (compose structures seers bind via config.template_key):
   templates update <template-id> [--name] [--angle] [--sections '<json>'|--sections-file <path>]
   templates delete <template-id> --yes
 
+Shredder (diversify content produced outside Letterstory; structure preserved):
+  shredder list                                        Your shredder endpoints + run counts
+  shredder create --name <n>                           New endpoint (returns a callable public id)
+  shredder delete <endpoint-id> --yes
+  shredder run <endpoint-id> (--body <text>|--file <path>|--file -) [--coverage <0..1>] [--attempts <n>]
+                                                       Shred prose through an endpoint (logs telemetry)
+  shredder runs [--endpoint <id>] [--limit <n>]        Recent shred calls (telemetry), newest first
+
 Insights:
   insights site [--period 14d|30d|90d] [--collection <uuid>]
   insights post <article-id> [--period 14d|30d|90d]
@@ -330,6 +339,7 @@ const CLIENT_COMMANDS = {
 	"phantom-job": cmdPhantomJob,
 	seers: cmdSeers,
 	templates: cmdTemplates,
+	shredder: cmdShredder,
 };
 
 // LETTERSTORY_POLL_INTERVAL_MS / LETTERSTORY_MAX_POLLS let an operator (or an

package/lib/commands/shredder.mjs

@@ -0,0 +1,99 @@
+// `shredder` — create shredder endpoints and run content produced OUTSIDE Letterstory
+// through the cross-provider shredder. A shred rewrites each sentence across multiple
+// LLM providers to diversify, leaving structure (headings, lists, tables) untouched, and
+// logs every call to telemetry.
+
+import { CliError } from "../client.mjs";
+import {
+	flagStr,
+	flagNum,
+	requireFlag,
+	requirePositional,
+	readBodyInput,
+	printResult,
+	compact,
+	ok,
+} from "./shared.mjs";
+
+export async function cmdShredder(ctx) {
+	const sub = ctx.positionals[0];
+	const rest = { ...ctx, positionals: ctx.positionals.slice(1) };
+	switch (sub) {
+		case "list":
+		case "ls":
+			return shredderList(rest);
+		case "new":
+		case "create":
+			return shredderCreate(rest);
+		case "delete":
+		case "rm":
+			return shredderDelete(rest);
+		case "run":
+		case "shred":
+			return shredderRun(rest);
+		case "runs":
+		case "telemetry":
+			return shredderRuns(rest);
+		default:
+			throw new CliError(`Unknown shredder subcommand: ${sub ?? "(none)"}. Try: list, create, delete, run, runs`);
+	}
+}
+
+async function shredderList(ctx) {
+	const { client, flags, io } = ctx;
+	const result = await client.callTool("list_shredder_endpoints", {});
+	printResult(io, flags, result);
+	return 0;
+}
+
+async function shredderCreate(ctx) {
+	const { client, flags, io } = ctx;
+	const name = requireFlag(flags, "name");
+	const result = await client.callTool("create_shredder_endpoint", { name });
+	ok(ctx, `Created shredder endpoint "${name}".`);
+	printResult(io, flags, result);
+	return 0;
+}
+
+async function shredderDelete(ctx) {
+	const { client, positionals, flags, io } = ctx;
+	const id = requirePositional(positionals, 0, "endpoint-id");
+	if (!flags.yes) {
+		io.error(`Re-run with --yes to confirm: ${ctx.bin} shredder delete ${id} --yes`);
+		return 1;
+	}
+	const result = await client.callTool("delete_shredder_endpoint", { endpoint_id: id });
+	ok(ctx, "Shredder endpoint deleted.");
+	printResult(io, flags, result);
+	return 0;
+}
+
+async function shredderRun(ctx) {
+	const { client, positionals, flags, io } = ctx;
+	const id = requirePositional(positionals, 0, "endpoint-id");
+	const text = readBodyInput(flags);
+	if (text === undefined) {
+		throw new CliError("Provide the prose to shred with --body <text>, --file <path>, or --file - (stdin).");
+	}
+	const args = compact({
+		endpoint_id: id,
+		text,
+		coverage: flagNum(flags.coverage),
+		attempts_per_unit: flagNum(flags.attempts),
+	});
+	const result = await client.callTool("run_shred", args);
+	ok(ctx, "Shred complete.");
+	printResult(io, flags, result);
+	return 0;
+}
+
+async function shredderRuns(ctx) {
+	const { client, flags, io } = ctx;
+	const args = compact({
+		endpoint_id: flagStr(flags.endpoint),
+		limit: flagNum(flags.limit),
+	});
+	const result = await client.callTool("list_shred_runs", args);
+	printResult(io, flags, result);
+	return 0;
+}

package/lib/commands.mjs

@@ -21,3 +21,4 @@ export * from "./commands/research.mjs";
 export * from "./commands/kernel.mjs";
 export * from "./commands/phantom-job.mjs";
 export * from "./commands/seers.mjs";
+export * from "./commands/shredder.mjs";

package/package.json

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