@letterstory/cli 0.176.80 → 0.176.81

package/lib/cli.mjs

@@ -85,7 +85,7 @@ import {
 import { fetchParkedSections, withoutParked } from "./parked.mjs";
 
 // Matches cli/package.json; publish-cli.yml rewrites both to the published version.
-export const VERSION = "0.176.80";
+export const VERSION = "0.176.81";
 
 /** The exit code for a gate refusal (CARD_REQUIRED, PAYMENT_FAILED, OUT_OF_TOKENS): 1 is a plain error. */
 export const EXIT_PAYMENT_REQUIRED = 3;
@@ -684,6 +684,12 @@ Reviewers:
   automate send <event-name> --title <what happened> [--key <id>] [--url <u>] [--fact k=v ...]
                 [--email <e>] [--person <name>] [--company <c>]
                                                        Send an event from your own systems
+  automate findings [--state new|acted|dismissed|expired] [--automation <id>] [--site <host>] [--page <url>]
+                   [--limit <n>] [--cursor <t>]
+                                                       What the automations noticed: evidence, what it's about,
+                                                       the button that acts on it, and how it ended
+  automate act <finding-id>                            Make the call a finding stores, as you
+  automate dismiss <finding-id> [--reason <why>]       Set a finding aside
   automate remove <automation-id>
   reviewers invite <article-id> --email <e> [--name <n>]
                                                        Invite a guest to review one post

package/lib/commands/automate.mjs

@@ -1,6 +1,6 @@
 // `automate` — Letterpress → Automations (docs/architecture/event-automations.md): an event, read
 // against your filter (--instruction), then done by Letterpress as your prompt (--prompt) says.
-// options / list / show / add / set / try / runs / approve / reject / send / remove, through the
+// options / list / show / add / set / try / runs / approve / reject / send / findings / act / dismiss / remove, through the
 // same tools the app uses. (A letterbase's writing automations are made and paced with `automations`.) `list` also
 // shows the jobs Letter runs for the account (source "letter": internal links, the blog's sync, the site's re-audit,
 // Fix autopilot, add-your-name suggestions, Auto-Plan, and each letterbase's writing automations), each with its
@@ -34,6 +34,7 @@ const TEMPLATES = [
 ];
 const UNITS = ["hours", "days", "weeks", "months"];
 const STATUSES = ["pending", "proposed", "acting", "acted", "answered", "skipped", "failed", "rejected"];
+const FINDING_STATES = ["new", "acted", "dismissed", "expired"];
 
 const triggerParams = {
 	object: {
@@ -164,6 +165,29 @@ export const ARGS = {
 		decision: { internal: "approve or reject, from the subcommand" },
 		reason: { flag: "reason" },
 	},
+	// What the automations noticed (docs/architecture/automation-findings.md): read, act on, dismiss.
+	list_findings: {
+		automation_id: { flag: "automation" },
+		state: { flag: "state", enum: FINDING_STATES },
+		about: {
+			object: {
+				host: { flag: "site" },
+				page_url: { flag: "page" },
+				collection_id: { flag: "letterbase" },
+				question: { flag: "question" },
+				target_id: { flag: "target" },
+			},
+		},
+		limit: { flag: "limit", type: "num" },
+		cursor: { flag: "cursor" },
+	},
+	act_on_finding: {
+		finding_id: { positional: 0, label: "finding-id", required: true },
+	},
+	dismiss_finding: {
+		finding_id: { positional: 0, label: "finding-id", required: true },
+		reason: { flag: "reason" },
+	},
 	send_automation_event: {
 		event: { positional: 0, label: "event-name", required: true },
 		key: { flag: "key" },
@@ -207,12 +231,18 @@ export async function cmdAutomate(ctx) {
 			return run(rest, "decide_automation_run", "Rejected.", { decision: "reject" });
 		case "send":
 			return run(rest, "send_automation_event");
+		case "findings":
+			return run(rest, "list_findings");
+		case "act":
+			return run(rest, "act_on_finding", "Done.");
+		case "dismiss":
+			return run(rest, "dismiss_finding", "Dismissed.");
 		case "remove":
 		case "rm":
 			return run(rest, "delete_event_automation", "Removed.");
 		default:
 			throw new CliError(
-				`Unknown automate subcommand: ${sub ?? "(none)"}. Try: options, list, show, add, set, try, runs, approve, reject, send, remove`
+				`Unknown automate subcommand: ${sub ?? "(none)"}. Try: options, list, show, add, set, try, runs, approve, reject, send, findings, act, dismiss, remove`
 			);
 	}
 }

package/package.json

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