@letterstory/cli 0.101.1 → 0.102.1

package/lib/cli.mjs

@@ -60,7 +60,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.101.1";
+export const VERSION = "0.102.1";
 
 // 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
@@ -400,7 +400,7 @@ Flows:
 
 Connectors:
   connectors list                                      List external publish destinations
-  connectors publish <article-id> --to <connector> --target <uuid> [--flow-run <uuid>]
+  connectors publish <article-id> --to <connector> --target <uuid>
                                                        [--confirm-missing-target] re-publish even though
                                                        the item was deleted/unpublished on the provider
   connectors status --connector <connector> --publish-id <id>
@@ -1152,12 +1152,16 @@ Repo changes (Claude Code edits your repo in a sandbox; the Letterstory GitHub A
   repo fix-audit --issue <issue-type> [--audit <id>] [--branch <base>] [--preview] [--wait]
                                                        One PR fixing a site-audit issue on every affected page,
                                                        in the repo verified to build the site
+  repo install-letterprove --repo <owner/name> [--branch <base>] [--wait]
+                                                       One PR adding Letterprove's script and identify calls
+                                                       (pick the repo where users sign in)
   repo sites [--detect [--force]]                      Which website each repo builds, and the evidence
   repo set-site --repo <owner/name> --site <host> [--not]
                                                        Say which site a repo builds (--not: correct a wrong label)
   repo reset-site --repo <owner/name> --site <host>    Back to automatic detection
   repo status <run-id>                                 Phase, spend, PR link and Claude's summary
   repo list [--status running|succeeded|no_changes|failed|cancelled] [--limit n] [--audit <id>]
+             [--source site_audit_issue|site_quick_check|letterprove_install]
   repo publish <run-id>                                Make PR on a preview in review
   repo cancel <run-id>                                 Stop it and delete the sandbox; no PR (Discard a preview)
 

package/lib/commands/connectors.mjs

@@ -16,7 +16,6 @@ export const ARGS = {
 		article_id: { positional: 0, label: "article-id", required: true },
 		connector: { flag: "to", required: true, enum: PUBLISH_CONNECTORS },
 		target_id: { flag: "target", required: true },
-		flow_run_id: "flow-run",
 		// A re-publish whose external item was deleted or unpublished in the client's CMS
 		// is refused, and the refusal explains itself. --confirm-missing-target is the
 		// answer to that specific question: it re-creates / re-publishes the item there.

package/lib/commands/flows.mjs

@@ -1,6 +1,6 @@
-// `flows` — manage the flow_run.completed completion webhook. list/run/status
-// (Enhance flow authoring + running) are retired along with the rest of that UI;
-// see docs/architecture/enhance-flows-retirement.md for the removal. get_webhook/set_webhook are untouched —
+// `flows webhook` — manage the API key's webhook destination (article.published, article.finished).
+// list/run/status (Enhance flow authoring + running) are retired and the flow tables dropped;
+// see docs/architecture/enhance-flows-retirement.md. get_webhook/set_webhook are untouched —
 // they configure a webhook on the API key, not an Enhance flow.
 
 import { CliError } from "../client.mjs";

package/lib/commands/repo.mjs

@@ -4,6 +4,7 @@
 //   repo list    → list_repo_changes     repo cancel → cancel_repo_change
 //   repo publish → publish_repo_change (Make PR on a preview)
 //   repo repos   → list_github_app_repos  repo branches → list_repo_branches
+//   repo install-letterprove → letterprove_open_install_pr
 
 import { readFileSync } from "node:fs";
 import { basename } from "node:path";
@@ -59,6 +60,11 @@ const ARGS = {
 		base_branch: "branch",
 		preview: { flag: "preview", type: "bool" },
 	},
+	letterprove_open_install_pr: {
+		repo_owner: { value: (flags) => splitRepo(flags).owner },
+		repo_name: { value: (flags) => splitRepo(flags).name },
+		base_branch: "branch",
+	},
 	get_repo_change: { run_id: { positional: 0, required: true, label: "run-id" } },
 	cancel_repo_change: { run_id: { positional: 0, required: true, label: "run-id" } },
 	publish_repo_change: { run_id: { positional: 0, required: true, label: "run-id" } },
@@ -66,6 +72,7 @@ const ARGS = {
 		status: { flag: "status", enum: ["running", "succeeded", "no_changes", "failed", "cancelled"] },
 		limit: { flag: "limit", type: "num" },
 		audit_id: "audit",
+		source_kind: { flag: "source", enum: ["site_audit_issue", "site_quick_check", "letterprove_install"] },
 	},
 	list_github_app_repos: {},
 	list_repo_branches: {
@@ -99,6 +106,8 @@ export async function cmdRepo(ctx) {
 			return repoStatus(rest);
 		case "fix-audit":
 			return repoFixAudit(rest);
+		case "install-letterprove":
+			return repoInstallLetterprove(rest);
 		case "sites":
 			return repoSites(rest);
 		case "set-site":
@@ -117,7 +126,7 @@ export async function cmdRepo(ctx) {
 			return repoBranches(rest);
 		default:
 			throw new CliError(
-				`Unknown repo subcommand: ${sub ?? "(none)"}. Try: start, fix-audit, sites, set-site, reset-site, status, list, publish, cancel, repos, branches`
+				`Unknown repo subcommand: ${sub ?? "(none)"}. Try: start, fix-audit, install-letterprove, sites, set-site, reset-site, status, list, publish, cancel, repos, branches`
 			);
 	}
 }
@@ -239,6 +248,22 @@ async function repoFixAudit(ctx) {
 	return followRun(ctx, result.run);
 }
 
+/** `repo install-letterprove --repo owner/name [--branch b] [--wait]`: Letterprove's script + identify calls → one PR. */
+async function repoInstallLetterprove(ctx) {
+	const { client, flags, io } = ctx;
+	refuseUnknownFlags(ctx, {}, ["repo", "owner", "name", "branch", "wait"]);
+	const result = await client.callTool(
+		"letterprove_open_install_pr",
+		argsFromFlags(ARGS.letterprove_open_install_pr, flags, ctx.positionals)
+	);
+	ok(ctx, result.message);
+	if (!flags.wait) {
+		printResult(io, flags, result.run, describe);
+		return 0;
+	}
+	return followRun(ctx, result.run);
+}
+
 /** `repo sites [--detect] [--force]`: which website each repo builds, and why. */
 async function repoSites(ctx) {
 	const { client, flags, io } = ctx;

package/package.json

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