@letterstory/cli 0.76.0 → 0.76.1

package/README.md

@@ -749,6 +749,14 @@ AI visibility and page access — the Measure tabs' reads, for scripts and agent
 # search, actions, targets — `ai` is the slow one on a large org.
 letterstory insights summary [--period 14d|30d|90d] [--part <block>]...
 
+# GEO → Competitors: every tracked brand's share of mentions (one per brand per
+# answer) on the window, whether each is moving (the same question on the same
+# engine in both windows — the only up/down read), the question × engine cells
+# behind it, the line per engine, each question's top rival, and every dated
+# change under the number. --period sets the windows: 14d → last 2 complete
+# weeks vs the 2 before, 30d → 4 vs 4, 90d → 13 vs 13.
+letterstory insights competitors [--period 14d|30d|90d]
+
 # The AI Visibility Bank: which questions named you, cited your pages, or both (a
 # breakthrough). All time unless --period; --source picks the phantom network
 # (default), your marketing site, or the whole portfolio; --phantom narrows to

package/lib/cli.mjs

@@ -56,7 +56,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.76.0";
+export const VERSION = "0.76.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.
@@ -922,6 +922,7 @@ Mail:
 
 Insights:
   insights summary [--period …] [--part <block>]...    Measure Overview: AI named/cited rates, share of voice, search, targets
+  insights competitors [--period 14d|30d|90d]          GEO → Competitors: share of mentions per brand, is it moving, by engine/question
   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/insights.mjs

@@ -1,7 +1,8 @@
 // `insights` — Search Console impressions/clicks across the phantom network, at the
 // network, single-post, and top-posts levels (ported from phantomstory-cli's
-// insights.ts); plus Measure's Overview (`summary`), AI Visibility Bank (`bank`)
-// and phantom Page Access (`access`) — the same reads the web app's Measure tabs render.
+// insights.ts); plus Measure's Overview (`summary`), GEO → Competitors
+// (`competitors`), AI Visibility Bank (`bank`) and phantom Page Access (`access`)
+// — the same reads the web app's Measure tabs render.
 
 import { CliError } from "../client.mjs";
 import { flagStr, flagNum, requirePositional, printResult, compact, argsFromFlags } from "./shared.mjs";
@@ -23,6 +24,9 @@ export const ARGS = {
 		period: { flag: "period", enum: PERIODS },
 		parts: { flag: "part", type: "list" },
 	},
+	get_share_of_voice_detail: {
+		period: { flag: "period", enum: PERIODS },
+	},
 };
 
 export async function cmdInsights(ctx) {
@@ -41,9 +45,11 @@ export async function cmdInsights(ctx) {
 			return call(rest, "get_page_access");
 		case "summary":
 			return call(rest, "get_measure_summary");
+		case "competitors":
+			return call(rest, "get_share_of_voice_detail");
 		default:
 			throw new CliError(
-				`Unknown insights subcommand: ${sub ?? "(none)"}. Try: summary, site, post, top, bank, access`
+				`Unknown insights subcommand: ${sub ?? "(none)"}. Try: summary, competitors, site, post, top, bank, access`
 			);
 	}
 }

package/package.json

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