@letterstory/cli 0.15.2 → 0.15.3

package/lib/cli.mjs

@@ -24,6 +24,8 @@ import {
 	cmdFlows,
 	cmdConnectors,
 	cmdStrategy,
+	cmdProbes,
+	cmdSuggestions,
 	cmdOnboarding,
 	cmdSeries,
 	cmdInsights,
@@ -41,7 +43,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.15.2";
+export const VERSION = "0.15.3";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value.
@@ -242,6 +244,12 @@ Strategy & onboarding:
   strategy sitemap --collection <uuid> --url <sitemap_url> [--sub <url> …] [--pattern <glob>]
   strategy topics list --collection <uuid>             List the topic map's clusters/spokes
   strategy topics set --collection <uuid> (--topic <topic-id> | --suggestion <suggestion-id>)
+  suggestions list <collection_id>                     List pending strategy suggestions + their auto-apply countdown
+  suggestions approve | dismiss | snooze <verdict|proposal> <id> [--days <n>]
+  probes list [--collection <uuid>] [--active-only] [--kind mention|citation|page]
+  probes keep | pause | resume <probe_id>              Keep = protect an AI probe from rotation (no pause)
+  probes edit <probe_id> <new question text>           Fix/sharpen a generated probe
+  probes add <question> [--kind mention|citation] [--scope site|company|<blogId>] [--cluster <id>]
   onboarding status                                    Show the onboarding checklist
   onboarding step [--current <step>] [--complete <step>] [--skip <step>] [--status <status>]
   series list                                          The org's content series + coverage state
@@ -459,6 +467,8 @@ const CLIENT_COMMANDS = {
 	flows: cmdFlows,
 	connectors: cmdConnectors,
 	strategy: cmdStrategy,
+	probes: cmdProbes,
+	suggestions: cmdSuggestions,
 	onboarding: cmdOnboarding,
 	series: cmdSeries,
 	insights: cmdInsights,

package/lib/commands/probes.mjs

@@ -0,0 +1,145 @@
+// `probes` + `suggestions` — surface parity with the Measure → Probes tab and
+// the collection strategy queue. Thin wrappers over the MCP tools (list_probes,
+// control_probe, add_probe; list_strategy_suggestions, decide_strategy_suggestion),
+// which themselves call the same shared lib seams the web + REST use. So an agent
+// or a script can see and act on exactly what a person can.
+
+import { CliError } from "../client.mjs";
+import { flagStr, flagNum, flagBool, requirePositional, printResult, compact, ok } from "./shared.mjs";
+
+export async function cmdProbes(ctx) {
+	const sub = ctx.positionals[0];
+	const rest = { ...ctx, positionals: ctx.positionals.slice(1) };
+	switch (sub) {
+		case "list":
+		case "ls":
+			return probesList(rest);
+		case "keep":
+			return probesControl(rest, "keep");
+		case "pause":
+			return probesControl(rest, "pause");
+		case "resume":
+			return probesControl(rest, "resume");
+		case "edit":
+			return probesEdit(rest);
+		case "add":
+			return probesAdd(rest);
+		default:
+			throw new CliError("Usage: probes <list|keep|pause|resume|edit|add>");
+	}
+}
+
+function formatProbeLine(p) {
+	const state = p.lifecycle_state ? `[${p.lifecycle_state}]` : p.is_active ? "[active]" : "[paused]";
+	return `${p.id}  ${state}  (${p.probe_kind}/${p.scope}, source=${p.source ?? "?"})  ${p.text}`;
+}
+
+async function probesList(ctx) {
+	const { client, flags, io } = ctx;
+	const result = await client.callTool(
+		"list_probes",
+		compact({
+			collection_id: flagStr(flags.collection),
+			active_only: flagBool(flags["active-only"]),
+			probe_kind: flagStr(flags.kind),
+		})
+	);
+	printResult(io, flags, result, (r) => {
+		const lines = (r.probes ?? []).map(formatProbeLine);
+		if (!lines.length) lines.push("No probes match.");
+		return lines.join("\n");
+	});
+	return 0;
+}
+
+async function probesControl(ctx, action) {
+	const { client, positionals } = ctx;
+	const probeId = requirePositional(positionals, 0, "probe_id");
+	const result = await client.callTool("control_probe", { probe_id: probeId, action });
+	ok(ctx, result.noop ? "Nothing to change (already in that state)." : `Probe ${action}d.`);
+	return 0;
+}
+
+async function probesEdit(ctx) {
+	const { client, positionals } = ctx;
+	const probeId = requirePositional(positionals, 0, "probe_id");
+	const text = positionals.slice(1).join(" ").trim();
+	if (!text) throw new CliError("Usage: probes edit <probe_id> <new question text>");
+	await client.callTool("control_probe", { probe_id: probeId, action: "edit", text });
+	ok(ctx, "Question updated.");
+	return 0;
+}
+
+async function probesAdd(ctx) {
+	const { client, positionals, flags } = ctx;
+	const text = positionals.join(" ").trim();
+	if (!text)
+		throw new CliError(
+			"Usage: probes add <question> [--kind mention|citation] [--scope site|company|<blogId>] [--cluster <id>]"
+		);
+	const result = await client.callTool(
+		"add_probe",
+		compact({
+			text,
+			probe_kind: flagStr(flags.kind) ?? "mention",
+			scope: flagStr(flags.scope) ?? "site",
+			cluster_id: flagStr(flags.cluster),
+		})
+	);
+	ok(ctx, `Added probe ${result.id}.`);
+	return 0;
+}
+
+export async function cmdSuggestions(ctx) {
+	const sub = ctx.positionals[0];
+	const rest = { ...ctx, positionals: ctx.positionals.slice(1) };
+	switch (sub) {
+		case "list":
+		case "ls":
+			return suggestionsList(rest);
+		case "approve":
+			return suggestionsDecide(rest, "approve");
+		case "dismiss":
+			return suggestionsDecide(rest, "dismiss");
+		case "snooze":
+			return suggestionsDecide(rest, "snooze");
+		default:
+			throw new CliError(
+				"Usage: suggestions <list <collection_id>|approve|dismiss|snooze <verdict|proposal> <id>>"
+			);
+	}
+}
+
+function formatSuggestionLine(s) {
+	const when =
+		s.disposition === "auto"
+			? s.snoozed_until
+				? `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}`;
+}
+
+async function suggestionsList(ctx) {
+	const { client, positionals, flags, io } = ctx;
+	const collectionId = requirePositional(positionals, 0, "collection_id");
+	const result = await client.callTool("list_strategy_suggestions", { collection_id: collectionId });
+	printResult(io, flags, result, (r) => {
+		const lines = (r.suggestions ?? []).map(formatSuggestionLine);
+		if (!lines.length) lines.push("Nothing pending.");
+		return lines.join("\n");
+	});
+	return 0;
+}
+
+async function suggestionsDecide(ctx, decision) {
+	const { client, positionals, flags } = ctx;
+	const kind = requirePositional(positionals, 0, "kind (verdict|proposal)");
+	const id = requirePositional(positionals, 1, "id");
+	const result = await client.callTool(
+		"decide_strategy_suggestion",
+		compact({ kind, id, decision, snooze_days: decision === "snooze" ? flagNum(flags.days) : undefined })
+	);
+	ok(ctx, result.applied ?? `Suggestion ${decision}d.`);
+	return 0;
+}

package/lib/commands.mjs

@@ -14,6 +14,7 @@ export * from "./commands/authors.mjs";
 export * from "./commands/flows.mjs";
 export * from "./commands/connectors.mjs";
 export * from "./commands/strategy.mjs";
+export * from "./commands/probes.mjs";
 export * from "./commands/series.mjs";
 export * from "./commands/insights.mjs";
 export * from "./commands/covers.mjs";

package/package.json

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