@letterstory/cli 0.176.35 → 0.176.37

package/lib/cli.mjs

@@ -83,7 +83,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.35";
+export const VERSION = "0.176.37";
 
 /** 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;
@@ -99,6 +99,8 @@ export const BOOLEAN_FLAGS = new Set([
 	"wait",
 	// automations set: stop reading a data feed.
 	"no-reads",
+	// automations add|set --reads: leave out records the feed only changed.
+	"new-only",
 	// vary start: pause the test running on the page first.
 	"pause-running",
 	// bench run: the spec was just changed.
@@ -605,13 +607,15 @@ Reviewers:
   automations dismiss <topic-id> --collection <id>     Set one subject aside
   automations add topic|series|signal|best --collection <id> [--topic <id>] [--goal <target-id>]
                   [--seer <id>] [--pace <n> | --on "fri 09:00 America/New_York"] [--brief <text>]
-                  [--reads <seer-id> [--window <days>]] [--new-topic <name>] [--new-series <name>]
+                  [--reads <seer-id> [--window <days>] [--new-only]] [--new-topic <name>] [--new-series <name>]
                                                        Add one (refused if it says the same as another).
                                                        --on pins it: one post a week, on that day and time
                                                        --reads: a data feed (a data_feed seer) whose records in
                                                        the window before each post are the post's own data
+                                                       --new-only: only records the feed dates in the window,
+                                                       not ones it merely changed (a price, a flag)
   automations set <automation-id> --collection <id> [--pace <n> | --on "<day> <HH:MM> <tz>" | --unpin]
-                  [--reads <seer-id> [--window <days>] | --no-reads]
+                  [--reads <seer-id> [--window <days>] [--new-only] | --no-reads]
                   [--pause | --resume] [--goal <id>] [--brief <text>] [--remap]
   automations remove <automation-id> --collection <id>
   automate options                                     What an automation can be made of here: the triggers,
@@ -1687,6 +1691,9 @@ Insights:
   insights question <key> [--period 14d|30d|90d] [--filter all|named_you|rival_not_you|no_one] [--limit n]
                                                        One By-question row: the wordings asked and the AI answers
   insights detection                                   How your brand is detected in AI answers (terms, who set them)
+  insights properties                                  Search Console properties the connected Google account can read, the
+                                                       unverified ones, and the one tracked
+  insights property <site-url>                         Pick the Search Console property to track (a key minted by an admin)
   insights site [--period 14d|30d|90d] [--collection <uuid>]
   insights post <article-id> [--period 14d|30d|90d]
   insights top [--period 14d|30d|90d] [--collection <uuid>] [--limit <n>] [--sort clicks|impressions]

package/lib/commands/automations.mjs

@@ -26,6 +26,7 @@ export function parsePublishAt(text) {
 /**
  * `--reads <seer-id> [--window <days>]` → { seer_id, window_days } (the tool's `reads`): a data
  * feed the automation reads, the window ending at each post's publish instant (7 days unless set).
+ * `--new-only` adds include_changed: false (records the feed only changed never count).
  * `--no-reads` sends null (stop reading one).
  */
 export function parseReads(flags) {
@@ -33,12 +34,13 @@ export function parseReads(flags) {
 	const seer = flagStr(flags.reads);
 	if (seer === undefined) {
 		if (flags.window !== undefined) throw new CliError("--window goes with --reads <seer-id>");
+		if (flags["new-only"] === true) throw new CliError("--new-only goes with --reads <seer-id>");
 		return undefined;
 	}
 	const days = flags.window === undefined ? 7 : Number(flags.window);
 	if (!Number.isInteger(days) || days < 1)
 		throw new CliError("--window takes a whole number of days, e.g. --window 7");
-	return { seer_id: seer, window_days: days };
+	return { seer_id: seer, window_days: days, ...(flags["new-only"] === true ? { include_changed: false } : {}) };
 }
 
 /** See `argsFromFlags` in shared.mjs; `scripts/parity-check.ts` diffs these keys against the tool. */

package/lib/commands/insights.mjs

@@ -3,7 +3,8 @@
 // insights.ts); plus Measure's Overview (`summary`), GEO → Competitors
 // (`competitors`), AI Visibility Bank (`bank`) and phantom Page Access (`access`);
 // Measure → Reads (`reads`), Questions (`questions`), Pages (`pages`, one page's answers `page`) and the posts naming you (`mentions`), and the live feed of what
-// is reading the phantom sites (`activity`) — the same reads the web app renders.
+// is reading the phantom sites (`activity`) — the same reads the web app renders. Search Console's
+// property: which ones the connected Google account can read (`properties`) and the one tracked (`property`).
 
 import { CliError } from "../client.mjs";
 import { flagStr, flagNum, requirePositional, printResult, compact, argsFromFlags } from "./shared.mjs";
@@ -56,6 +57,10 @@ export const ARGS = {
 		phantom_id: { flag: "phantom" },
 		limit: { flag: "limit", type: "num" },
 	},
+	list_gsc_properties: {},
+	select_gsc_property: {
+		site_url: { positional: 0, label: "site-url", required: true },
+	},
 	get_share_of_voice_question: {
 		question_key: { positional: 0, label: "question-key", required: true },
 		period: { flag: "period", enum: PERIODS },
@@ -98,9 +103,13 @@ export async function cmdInsights(ctx) {
 			return call(rest, "list_site_mentions");
 		case "activity":
 			return call(rest, "get_recent_activity");
+		case "properties":
+			return call(rest, "list_gsc_properties");
+		case "property":
+			return call(rest, "select_gsc_property");
 		default:
 			throw new CliError(
-				`Unknown insights subcommand: ${sub ?? "(none)"}. Try: summary, reads, questions, pages, page, mentions, competitors, question, detection, activity, site, post, top, bank, access`
+				`Unknown insights subcommand: ${sub ?? "(none)"}. Try: summary, reads, questions, pages, page, mentions, competitors, question, detection, activity, site, post, top, bank, access, properties, property`
 			);
 	}
 }

package/package.json

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