@letterstory/cli 0.132.0 → 0.134.0

package/lib/cli.mjs

@@ -62,7 +62,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.132.0";
+export const VERSION = "0.134.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
@@ -449,6 +449,10 @@ Reviewers:
   automations show <automation-id> --collection <id>  What it covers, its queued posts, its next ideas
   automations ideas --collection <id>                  The ideas waiting, grouped by the automation that owns each
   automations suggest --collection <id>                What it could add: topics, series formats, signals
+  automations starter --collection <id>                The first automations, from its evidence, with the
+                                                       calls that accept them (steps)
+  automations ground --collection <id>                 Its ground: strengths, near wins and gaps, with the numbers
+  automations works --collection <id>                  What works: each post and automation against its peers
   automations preview topic|series --collection <id> [--name <name>|--topic <id>] [--brief <text>]
                                                        What it would write, before adding it
   automations more --collection <id>                   New topics it doesn't cover yet
@@ -1343,6 +1347,7 @@ The Site (one model of your whole marketing site, keyed by host and path):
                      [--observation <id>]...           Propose a registry tool call; input is validated now
   site decide <proposal-id> --decision accept|dismiss [--reason <why>]
   site fix <host> <observation-id>... [--action build|build_pr|build_merge|slack|linear|handoff] [--with-preview]
+                                    [--harness claude-code|letterpress-1]
                                                        One change for N observations; handoff prints the prompt, slack/linear need no repo
   site competitors [--since <iso> | --days <n>] [--limit <n>]  Tracked competitors' sites: new and removed pages, by folder
   site watch-competitors [domain] [--limit <n>]        Map competitors' sitemaps (the next few unmapped, or one now)
@@ -1365,10 +1370,12 @@ Repo changes (Claude Code edits your repo in a sandbox; the Letterstory GitHub A
   repo start --repo <owner/name> --instructions <text>|--instructions-file <path|->
              [--branch <base>] [--attach <path>]... [--attach-url <name>=<https url>]...
              [--attach-ref <path>]... [--attach-url-ref <name>=<https url>]...
-             [--action build|build_pr|build_merge|slack|linear] [--with-preview] [--wait]
+             [--action build|build_pr|build_merge|slack|linear] [--with-preview]
+             [--harness claude-code|letterpress-1] [--wait]
                                                        Start a change (attached files go to the sandbox;
                                                        -ref ones are context, never put in the repo);
                                                        --with-preview keeps a preview up next to the PR;
+                                                       --harness picks the coding agent (default: the deployment's);
                                                        --wait follows it to the PR
   repo fix-audit --issue <issue-type>... [--audit <id>] [--branch <base>] [--action build|build_pr|build_merge|slack|linear] [--wait]
                                                        One PR fixing site-audit issues (repeat --issue to bundle) on every affected page,

package/lib/commands/automations.mjs

@@ -1,5 +1,5 @@
 // `automations` — a letterbase's automations (docs/architecture/automations.md): what it writes,
-// how often, and why. list / show / ideas / suggest / preview / more / add / set / dismiss / remove, through the same tools the app uses.
+// how often, and why. list / show / ideas / suggest / starter / ground / works / preview / more / add / set / dismiss / remove, through the same tools the app uses.
 // Same flag/positional/io conventions as posts.mjs — no commander, no color.
 
 import { CliError } from "../client.mjs";
@@ -16,6 +16,15 @@ export const ARGS = {
 	suggest_automations: {
 		collection_id: { flag: "collection", required: true },
 	},
+	suggest_starter_automations: {
+		collection_id: { flag: "collection", required: true },
+	},
+	get_ground_measures: {
+		collection_id: { flag: "collection", required: true },
+	},
+	get_what_works: {
+		collection_id: { flag: "collection", required: true },
+	},
 	get_automation: {
 		collection_id: { flag: "collection", required: true },
 		automation_id: { positional: 0, label: "automation-id", required: true },
@@ -61,6 +70,7 @@ export const ARGS = {
 	dismiss_subject: {
 		collection_id: { flag: "collection", required: true },
 		topic_id: { positional: 0, label: "topic-id", required: true },
+		reason: { flag: "reason" },
 	},
 	delete_automation: {
 		collection_id: { flag: "collection", required: true },
@@ -81,6 +91,12 @@ export async function cmdAutomations(ctx) {
 			return run(rest, "list_automation_ideas");
 		case "suggest":
 			return run(rest, "suggest_automations");
+		case "starter":
+			return run(rest, "suggest_starter_automations");
+		case "ground":
+			return run(rest, "get_ground_measures");
+		case "works":
+			return run(rest, "get_what_works");
 		case "preview":
 			return run(rest, "preview_automation");
 		case "more":
@@ -97,7 +113,7 @@ export async function cmdAutomations(ctx) {
 			return run(rest, "delete_automation", "Removed.");
 		default:
 			throw new CliError(
-				`Unknown automations subcommand: ${sub ?? "(none)"}. Try: list, show, ideas, suggest, preview, more, add, set, dismiss, remove`
+				`Unknown automations subcommand: ${sub ?? "(none)"}. Try: list, show, ideas, suggest, starter, ground, works, preview, more, add, set, dismiss, remove`
 			);
 	}
 }

package/lib/commands/probes.mjs

@@ -103,9 +103,11 @@ export async function cmdSuggestions(ctx) {
 			return suggestionsDecide(rest, "dismiss");
 		case "snooze":
 			return suggestionsDecide(rest, "snooze");
+		case "undo":
+			return suggestionsDecide(rest, "undo");
 		default:
 			throw new CliError(
-				"Usage: suggestions <list <collection_id>|approve|dismiss|snooze <verdict|proposal> <id>>"
+				"Usage: suggestions <list <collection_id>|approve|dismiss|snooze|undo <verdict|proposal> <id>>"
 			);
 	}
 }
@@ -117,7 +119,9 @@ function formatSuggestionLine(s) {
 				? `snoozed→${s.snoozed_until.slice(0, 10)}`
 				: `auto→${(s.auto_apply_at ?? "").slice(0, 10)}`
 			: "hold";
-	return `${s.kind} ${s.id}  [${when}]  ${s.cluster_name ?? "site"}: ${s.title}`;
+	const line = `${s.kind} ${s.id}  [${when}]  ${s.cluster_name ?? "site"}: ${s.title}`;
+	// A change to the automations' week: the week after, and why.
+	return s.week ? `${line}\n    ${s.week.line}\n    ${s.reason ?? ""}` : line;
 }
 
 async function suggestionsList(ctx) {

package/lib/commands/repo.mjs

@@ -66,6 +66,8 @@ const ARGS = {
 		preview: { flag: "preview", type: "bool" },
 		// --with-preview: the PR opens straight away and a preview of the change stays up next to it.
 		with_preview: { flag: "with-preview", type: "bool" },
+		// --harness claude-code|letterpress-1: the coding agent; omitted, the deployment's default.
+		harness: { flag: "harness", enum: ["claude-code", "letterpress-1"] },
 	},
 	create_repo_change_upload: { file_names: { internal: "the basenames of the --attach files" } },
 	list_repo_sites: {},
@@ -338,6 +340,7 @@ async function repoStart(ctx) {
 		"action",
 		"preview",
 		"with-preview",
+		"harness",
 		"wait",
 	]);
 	// One upload for every file (names must be unique across both), then the references marked.

package/lib/commands/site.mjs

@@ -180,6 +180,8 @@ const ARGS = {
 		action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack", "linear", "handoff"] },
 		// --with-preview: the PR opens straight away and a preview of the fix stays up next to it.
 		with_preview: { flag: "with-preview", type: "bool" },
+		// --harness claude-code|letterpress-1: the coding agent; omitted, the deployment's default.
+		harness: { flag: "harness", enum: ["claude-code", "letterpress-1"] },
 	},
 };
 

package/package.json

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