@letterstory/cli 0.139.0 → 0.141.0

package/lib/cli.mjs

@@ -64,7 +64,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.139.0";
+export const VERSION = "0.141.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. Every `type: "bool"` flag (and its
@@ -634,6 +634,7 @@ Ranking targets (what the org wants to be THE answer for — company-wide or on
   targets subqueries [<target-id>] [--retired]         The phrasings asked under each target (who retired one, and why)
   targets subquery add <target-id> <phrasing>          Another way your buyers ask a target's question
   targets subquery update <subquery-id> [--text <t>] [--retire | --restore]
+  targets posts [<target-id>]                          Each target's posts (written for it first), cited and won (28 days)
 
 Arenas (adversarial clusters of research agents -> a sourced, fact-checked outline):
   arena run --topic <text> [--source <url> …] [--must-include <text> …] [--depth barebones|fleshed_out]
@@ -1420,7 +1421,8 @@ Repo changes (Claude Code edits your repo in a sandbox; the Letterstory GitHub A
   repo delete-secret --repo <owner/name> --secret <KEY>
                                                        Delete one
   repo status <run-id>                                 Phase, spend, PR link and Claude's summary
-  repo activity <run-id> [--follow]                    What the sandbox is doing, line by line (--follow: until it stops)
+  repo activity <run-id> [--follow] [--since <iso>]    What the sandbox is doing, line by line (--follow: until it stops)
+  repo say <run-id> <message…>                         Tell a running build something; it carries on with it
   repo list [--status running|succeeded|no_changes|failed|cancelled] [--limit n] [--audit <id>]
              [--source site_audit_issue|site_quick_check|letterprove_install|visitors_install]
   repo publish <run-id>                                Make PR on a preview in review

package/lib/commands/enclosures.mjs

@@ -114,6 +114,10 @@ export const ARGS = {
 		generator_id: { positional: 0, label: "enclosure-id", required: true },
 		prospect_id: "prospect",
 	},
+	set_generator_photo: {
+		generator_id: { positional: 0, label: "enclosure-id", required: true },
+		photo_url: { flag: "url", required: true },
+	},
 	get_generator_version: {
 		generator_id: { positional: 0, label: "enclosure-id", required: true },
 		version: { value: (_flags, positionals) => Number(requirePositional(positionals, 1, "version")) },
@@ -182,6 +186,7 @@ const USAGE = `Usage: enclosures <list|show|create|update|prints>
   enclosures starters
   enclosures create --starter site_audit --login <app-id>       Begin from a starter (its version 1 included)
   enclosures write-steps <enclosure-id> [--prospect <id>]        Claude Code writes its steps from its description
+  enclosures photo <enclosure-id> --url <https link>             A sign photo's photo: you holding a blank sheet
   enclosures version <enclosure-id> <n>                        One version in full: its steps and the script prints replay
   enclosures add-version <enclosure-id> (--script <code>|--script-file <path>) --step <text>… [--host <h>…] [--summary <s>]
   enclosures approve <enclosure-id> --version <n>
@@ -215,6 +220,8 @@ export async function cmdEnclosures(ctx) {
 			return enclosuresVersion(rest);
 		case "write-steps":
 			return enclosuresWriteSteps(rest);
+		case "photo":
+			return enclosuresPhoto(rest);
 		case "add-version":
 			return enclosuresAddVersion(rest);
 		case "approve":
@@ -372,6 +379,18 @@ async function enclosuresWriteSteps(ctx) {
 	return 0;
 }
 
+async function enclosuresPhoto(ctx) {
+	const { client, flags, positionals, io } = ctx;
+	refuseUnknownFlags(ctx, ARGS.set_generator_photo, []);
+	const result = await client.callTool(
+		"set_generator_photo",
+		argsFromFlags(ARGS.set_generator_photo, flags, positionals)
+	);
+	ok(ctx, `Added version ${result.version} with your photo. Test it, then approve it to print with it.`);
+	printResult(io, flags, result, (r) => `version ${r.version}`);
+	return 0;
+}
+
 async function enclosuresVersion(ctx) {
 	const { client, flags, positionals, io } = ctx;
 	refuseUnknownFlags(ctx, ARGS.get_generator_version, []);

package/lib/commands/repo.mjs

@@ -5,6 +5,7 @@
 //   repo list    → list_repo_changes     repo cancel → cancel_repo_change
 //   repo publish → publish_repo_change (Make PR on a preview)
 //   repo revise  → revise_repo_change (ask for more on a preview, before the PR)
+//   repo say     → send_repo_change_message (steer a build while its agent works)
 //   repo repos   → list_github_app_repos  repo branches → list_repo_branches
 //   repo prs     → list_open_pull_requests (every open PR, whoever opened it)
 //   repo install-letterprove → letterprove_open_install_pr
@@ -182,7 +183,16 @@ const ARGS = {
 		auto_merge_after_hours: { value: (flags) => autoMergeHours(flags["auto-merge"]) },
 	},
 	get_repo_change: { run_id: { positional: 0, required: true, label: "run-id" } },
-	get_repo_change_activity: { run_id: { positional: 0, required: true, label: "run-id" } },
+	get_repo_change_activity: {
+		run_id: { positional: 0, required: true, label: "run-id" },
+		since: "since",
+	},
+	send_repo_change_message: {
+		run_id: { positional: 0, required: true, label: "run-id" },
+		message: {
+			value: (flags, positionals) => flagStr(flags.message) ?? (positionals.slice(1).join(" ") || undefined),
+		},
+	},
 	cancel_repo_change: { run_id: { positional: 0, required: true, label: "run-id" } },
 	publish_repo_change: { run_id: { positional: 0, required: true, label: "run-id" } },
 	revise_repo_change: {
@@ -283,6 +293,8 @@ export async function cmdRepo(ctx) {
 			return repoPublish(rest);
 		case "revise":
 			return repoRevise(rest);
+		case "say":
+			return repoSay(rest);
 		case "repos":
 			return repoRepos(rest);
 		case "branches":
@@ -299,7 +311,7 @@ export async function cmdRepo(ctx) {
 			return repoSlackTest(rest);
 		default:
 			throw new CliError(
-				`Unknown repo subcommand: ${sub ?? "(none)"}. Try: start, fix-audit, install-letterprove, install-visitors, sites, set-site, reset-site, secrets, set-secret, delete-secret, status, list, publish, cancel, repos, branches, prs, settings, suggestions, slack-targets, slack-test`
+				`Unknown repo subcommand: ${sub ?? "(none)"}. Try: start, fix-audit, install-letterprove, install-visitors, sites, set-site, reset-site, secrets, set-secret, delete-secret, status, list, publish, revise, say, cancel, repos, branches, prs, settings, suggestions, slack-targets, slack-test`
 			);
 	}
 }
@@ -555,12 +567,12 @@ async function repoStatus(ctx) {
 	return 0;
 }
 
-const ACTIVITY_MARK = { progress: "·", stage: "▸", say: "»", tool: "$", error: "!" };
+const ACTIVITY_MARK = { progress: "·", stage: "▸", say: "»", think: "◇", tool: "$", user: ">", error: "!" };
 
-/** `repo activity <run-id> [--follow]`: the build's feed; --follow prints new lines until it stops. */
+/** `repo activity <run-id> [--follow] [--since <iso>]`: the build's feed; --follow prints new lines until it stops. */
 async function repoActivity(ctx) {
 	const { client, flags, io } = ctx;
-	refuseUnknownFlags(ctx, {}, ["follow"]);
+	refuseUnknownFlags(ctx, {}, ["follow", "since"]);
 	const args = argsFromFlags(ARGS.get_repo_change_activity, flags, ctx.positionals);
 	const line = (l) => `${l.at.slice(11, 19)} ${ACTIVITY_MARK[l.kind] ?? " "} ${l.text}`;
 	let { activity } = await client.callTool("get_repo_change_activity", args);
@@ -623,6 +635,18 @@ async function repoPublish(ctx) {
 	return 0;
 }
 
+/** `repo say <run-id> <message…>` (or --message): steer a build while its agent works. */
+async function repoSay(ctx) {
+	const { client, flags, io } = ctx;
+	refuseUnknownFlags(ctx, {}, ["message"]);
+	const args = argsFromFlags(ARGS.send_repo_change_message, flags, ctx.positionals);
+	if (!args.message) throw new CliError("Say what to tell the build: repo say <run-id> <message…> (or --message)");
+	const result = await client.callTool("send_repo_change_message", args);
+	ok(ctx, result.message);
+	printResult(io, flags, result.sent, (s) => `${s.delivered ? "Sent" : "Waiting for the sandbox"}: ${s.message}`);
+	return 0;
+}
+
 /** `repo revise <run-id> --instructions <text>`: a follow-up on a preview, built on top of it. */
 async function repoRevise(ctx) {
 	const { client, flags, io } = ctx;

package/lib/commands/targets.mjs

@@ -44,6 +44,7 @@ const priority = { value: readPriority };
 // `scripts/parity-check.ts` compares these keys against each tool's published input schema.
 export const ARGS = {
 	list_ranking_targets: { offering_id: offering },
+	list_ranking_target_posts: { target_id: { positional: 0, label: "target-id" } },
 	add_ranking_target: {
 		// The phrase is every positional, so `targets add best payroll software` needs no quotes.
 		phrase: {
@@ -138,7 +139,8 @@ const USAGE = `Usage: targets <list|add|update|activate|deactivate|cap|suggest|s
   targets suggest [--offering <offering-id|company>]
   targets subqueries [<target-id>] [--retired]            the phrasings asked under each target
   targets subquery add <target-id> <phrasing>
-  targets subquery update <subquery-id> [--text <t>] [--retire | --restore]`;
+  targets subquery update <subquery-id> [--text <t>] [--retire | --restore]
+  targets posts [<target-id>]`;
 
 export async function cmdTargets(ctx) {
 	const sub = ctx.positionals[0];
@@ -163,6 +165,8 @@ export async function cmdTargets(ctx) {
 			return subqueriesList(rest);
 		case "subquery":
 			return subqueryWrite(rest);
+		case "posts":
+			return targetsPosts(rest);
 		default:
 			throw new CliError(USAGE);
 	}
@@ -277,6 +281,31 @@ async function targetsCap(ctx) {
 	return 0;
 }
 
+function formatTargetPosts(r) {
+	if (!r.targets?.length) return "No active ranking targets.";
+	const lines = [];
+	for (const t of r.targets) {
+		lines.push(`${t.phrase}${t.queued ? `  (${t.queued} queued)` : ""}`);
+		if (!t.posts.length) lines.push("  No published posts yet.");
+		for (const p of t.posts) {
+			const why = p.writtenForTarget ? (p.subquery ? `for "${p.subquery}"` : "written for it") : "on its pillar";
+			lines.push(`  ${p.title}  [${why}]  cited for ${p.citedQueries} · won ${p.breakthroughQueries}`);
+		}
+	}
+	lines.push(`Cited and won: distinct queries, the last ${r.windowDays} days.`);
+	return lines.join("\n");
+}
+
+async function targetsPosts(ctx) {
+	const { client, flags, io } = ctx;
+	const result = await client.callTool(
+		"list_ranking_target_posts",
+		argsFromFlags(ARGS.list_ranking_target_posts, flags, ctx.positionals)
+	);
+	printResult(io, flags, result, formatTargetPosts);
+	return 0;
+}
+
 async function targetsSuggest(ctx) {
 	const { client, flags, io } = ctx;
 	const result = await client.callTool("suggest_ranking_targets", argsFromFlags(ARGS.suggest_ranking_targets, flags));

package/package.json

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