@letterstory/cli 0.49.2 → 0.51.0

package/README.md

@@ -491,11 +491,25 @@ letterstory arena run-status <run-id>                  # status: awaiting_direct
 letterstory arena direction <run-id> --choice 1
 letterstory arena direction <run-id> --custom "Lead with the hidden costs"
 letterstory arena direction <run-id> --skip            # let the agents decide
+letterstory arena run --topic "payroll solutions" --direction "Lead with the hidden costs"   # no gate, no vote
+
+# Watching runs (what an agent monitoring the account polls):
+letterstory arena runs --status awaiting_direction     # the gates waiting on you
+letterstory arena runs --since 2026-10-02T00:00:00Z --limit 50
+letterstory arena runs --before <next_cursor>          # the next (older) page
+letterstory arena latest --article <uuid>              # the post's latest run, whoever started it
+
+# What research decided each site is — and your call on one (research never overrides it):
+letterstory arena roles --rival                        # competitors research found that you never listed
+letterstory arena role set reviewsite.com --role context
+letterstory arena role set rival.com --role company --company "Rival" --rival
+letterstory arena role reset rival.com                 # hand it back to research
 
 # Arenas are callable endpoints with one-file defaults (the org's default arena is "Letterstory"):
 letterstory arena list
 letterstory arena endpoint create --name "Docs research" --defaults '{"depth":"barebones"}'
 letterstory arena endpoint config <arena-id> [--file cfg.json]
+letterstory arena endpoint update <arena-id> --name "Docs research v2"   # creator or org admin only
 letterstory arena endpoint delete <arena-id> --yes
 
 # Ledes: a prospect's context in, ready-to-send opening lines out (chosen from a

package/lib/cli.mjs

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

package/lib/commands/arena.mjs

@@ -68,6 +68,8 @@ const RUN_OPTIONS = {
 	// --no-verify turns the fact-check off; nothing sent otherwise (the default is on).
 	verify: { value: (flags) => (flags["no-verify"] === true ? false : undefined) },
 	mention_degree: { flag: "mention", enum: ["off", "subtle", "woven"] },
+	// What the fact-check does with a claim it can neither fix nor stand behind: flag or remove it.
+	unresolved_claims: { flag: "unresolved", enum: ["comment", "drop"] },
 	// Positioning as data — a file, not flags: `--context-file ctx.json` of
 	// {manifesto, stances[], priority_topics[], avoid_topics[], identity{is[],is_not[],one_liner}}.
 	context: { value: (flags) => readJsonObjectFlag(flags, "context") },
@@ -116,6 +118,8 @@ export const ARGS = {
 			},
 		},
 		existing_content: { value: (flags) => flagStr(flags["existing-content"]) },
+		// Your own thesis: adopted as the run's direction, so a gate never pauses for it.
+		direction: { flag: "direction" },
 		article_id: { flag: "article" },
 		...RUN_OPTIONS,
 	},
@@ -124,8 +128,32 @@ export const ARGS = {
 	},
 	list_arena_runs: {
 		arena_id: { flag: "arena" },
+		article_id: { flag: "article" },
+		status: { flag: "status", type: "list" },
+		since: { flag: "since" },
+		before: { flag: "before" },
 		limit: { flag: "limit", type: "num" },
 	},
+	get_latest_arena_run: {
+		article_id: { flag: "article", required: true },
+	},
+	// What research decided each site is, and your call on one (never overridden by the model).
+	list_source_roles: {
+		role: { flag: "role", enum: ["authority", "company", "context"] },
+		rival: { flag: "rival", type: "bool" },
+		decided_by: { flag: "decided-by", enum: ["model", "customer", "staff"] },
+		limit: { flag: "limit", type: "num" },
+	},
+	set_source_role: {
+		site: { positional: 1, label: "site", required: true },
+		role: { flag: "role", enum: ["authority", "company", "context"], required: true },
+		company: { flag: "company" },
+		rival: { flag: "rival", type: "bool" },
+		note: { flag: "note" },
+	},
+	reset_source_role: {
+		site: { positional: 1, label: "site", required: true },
+	},
 	submit_arena_direction: {
 		run_id: { positional: 0, label: "run-id", required: true },
 		choice: { flag: "choice", type: "num" },
@@ -144,6 +172,11 @@ export const ARGS = {
 	delete_arena: {
 		arena_id: { positional: 1, label: "arena-id", required: true },
 	},
+	update_arena: {
+		arena_id: { positional: 1, label: "arena-id", required: true },
+		name: { flag: "name" },
+		defaults: { value: (flags) => readJsonObjectFlag(flags, "defaults") },
+	},
 	// The arena's configuration as ONE file: `arena endpoint config <id>` prints it,
 	// `arena endpoint config <id> --file cfg.json` replaces it with the file's document.
 	get_arena_config: {
@@ -167,6 +200,12 @@ export async function cmdArena(ctx) {
 			return arenaRunStatus(rest);
 		case "runs":
 			return arenaRuns(rest);
+		case "latest":
+			return arenaLatest(rest);
+		case "roles":
+			return arenaRoles(rest);
+		case "role":
+			return arenaRole(rest);
 		case "direction":
 			return arenaDirection(rest);
 		case "cancel":
@@ -181,7 +220,7 @@ export async function cmdArena(ctx) {
 			return arenaEndpoint(rest);
 		default:
 			throw new CliError(
-				`Unknown arena subcommand: ${sub ?? "(none)"}. Try: run, run-status, runs, direction, cancel, balance, list, endpoint`
+				`Unknown arena subcommand: ${sub ?? "(none)"}. Try: run, run-status, runs, latest, direction, cancel, balance, list, endpoint, roles, role`
 			);
 	}
 }
@@ -262,6 +301,47 @@ async function arenaRuns(ctx) {
 	return 0;
 }
 
+async function arenaLatest(ctx) {
+	const { client, flags, io } = ctx;
+	const args = argsFromFlags(ARGS.get_latest_arena_run, flags, ctx.positionals);
+	const result = await client.callTool("get_latest_arena_run", args);
+	printResult(io, flags, result);
+	return 0;
+}
+
+async function arenaRoles(ctx) {
+	const { client, flags, io } = ctx;
+	const result = await client.callTool(
+		"list_source_roles",
+		argsFromFlags(ARGS.list_source_roles, flags, ctx.positionals)
+	);
+	printResult(io, flags, result);
+	return 0;
+}
+
+/** `arena role set <site> --role …` / `arena role reset <site>` — your call on one site. */
+async function arenaRole(ctx) {
+	const { client, positionals, flags, io } = ctx;
+	const action = positionals[0];
+	if (action === "set") {
+		const args = argsFromFlags(ARGS.set_source_role, flags, positionals);
+		const result = await client.callTool("set_source_role", args);
+		ok(ctx, `${result?.role?.site ?? args.site} is now ${args.role}${args.rival ? " (a rival)" : ""}.`);
+		printResult(io, flags, result);
+		return 0;
+	}
+	if (action === "reset") {
+		const result = await client.callTool(
+			"reset_source_role",
+			argsFromFlags(ARGS.reset_source_role, flags, positionals)
+		);
+		ok(ctx, result?.reset ? "Handed back to research." : "Research had not recorded that site.");
+		printResult(io, flags, result);
+		return 0;
+	}
+	throw new CliError(`Unknown arena role action: ${action ?? "(none)"}. Try: set, reset`);
+}
+
 async function arenaDirection(ctx) {
 	const { client, flags, io } = ctx;
 	const runId = requirePositional(ctx.positionals, 0, "run-id");
@@ -327,6 +407,14 @@ async function arenaEndpoint(ctx) {
 		printResult(io, flags, result);
 		return 0;
 	}
+	if (action === "update" || action === "edit") {
+		const id = requirePositional(positionals, 1, "arena-id");
+		const args = argsFromFlags(ARGS.update_arena, flags, positionals);
+		const result = await client.callTool("update_arena", args);
+		ok(ctx, `Updated arena ${id}.`);
+		printResult(io, flags, result);
+		return 0;
+	}
 	if (action === "config") {
 		const id = requirePositional(positionals, 1, "arena-id");
 		if (flagStr(flags.file) === undefined) {
@@ -344,5 +432,5 @@ async function arenaEndpoint(ctx) {
 		printResult(io, flags, result);
 		return 0;
 	}
-	throw new CliError(`Unknown arena endpoint action: ${action ?? "(none)"}. Try: create, delete, config`);
+	throw new CliError(`Unknown arena endpoint action: ${action ?? "(none)"}. Try: create, update, delete, config`);
 }

package/package.json

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