@letterstory/cli 0.38.0 → 0.39.0

package/README.md

@@ -590,6 +590,20 @@ letterstory insights post <article-id> [--period 14d|30d|90d]
 letterstory insights top [--period 14d|30d|90d] [--collection <uuid>] [--limit <n>] [--sort clicks|impressions]
 ```
 
+AI visibility and page access — the Measure tabs' reads, for scripts and agents:
+
+```bash
+# 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
+# specific phantom sites (repeatable); --answers caps receipts per question.
+letterstory insights bank [--source phantoms|marketing|all] [--phantom <uuid>]... [--period 14d|30d|90d] [--answers <n>]
+
+# Page access: AI answer engines, search crawlers and confirmed human readers on
+# your phantom sites; --collection narrows to the site(s) a collection publishes.
+letterstory insights access [--period 14d|30d|90d] [--collection <uuid>]
+```
+
 ## Anything else
 
 Every Letterstory tool is reachable, not just the ones with a dedicated command group:

package/lib/cli.mjs

@@ -50,7 +50,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.38.0";
+export const VERSION = "0.39.0";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value.
@@ -746,6 +746,10 @@ Insights:
   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]
+  insights bank [--source phantoms|marketing|all] [--phantom <uuid>]... [--period 14d|30d|90d] [--answers <n>]
+                                                       AI Visibility Bank: named / cited / breakthrough evidence (all time by default)
+  insights access [--period 14d|30d|90d] [--collection <uuid>]
+                                                       Page access: who's reading your phantom sites
 
 Feedback (tell us what's broken, missing, unclear, or wanted):
   feedback submit --category bug|missing_feature|unclear|feature_request|praise|other

package/lib/commands/insights.mjs

@@ -1,9 +1,25 @@
 // `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.
+// network, single-post, and top-posts levels (ported from phantomstory-cli's
+// insights.ts); plus Measure's 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 } from "./shared.mjs";
+import { flagStr, flagNum, requirePositional, printResult, compact, argsFromFlags } from "./shared.mjs";
+
+const PERIODS = ["14d", "30d", "90d"];
+
+export const ARGS = {
+	get_ai_visibility_bank: {
+		source: { flag: "source", enum: ["phantoms", "marketing", "all"] },
+		phantom_ids: { flag: "phantom", type: "list" },
+		period: { flag: "period", enum: PERIODS },
+		answers_per_prompt: { flag: "answers", type: "num" },
+	},
+	get_page_access: {
+		period: { flag: "period", enum: PERIODS },
+		collection_id: { flag: "collection" },
+	},
+};
 
 export async function cmdInsights(ctx) {
 	const sub = ctx.positionals[0];
@@ -15,8 +31,12 @@ export async function cmdInsights(ctx) {
 			return insightsPost(rest);
 		case "top":
 			return insightsTop(rest);
+		case "bank":
+			return call(rest, "get_ai_visibility_bank");
+		case "access":
+			return call(rest, "get_page_access");
 		default:
-			throw new CliError(`Unknown insights subcommand: ${sub ?? "(none)"}. Try: site, post, top`);
+			throw new CliError(`Unknown insights subcommand: ${sub ?? "(none)"}. Try: site, post, top, bank, access`);
 	}
 }
 
@@ -49,3 +69,9 @@ async function insightsTop(ctx) {
 	printResult(io, flags, result);
 	return 0;
 }
+
+async function call(ctx, tool) {
+	const result = await ctx.client.callTool(tool, argsFromFlags(ARGS[tool], ctx.flags, ctx.positionals));
+	printResult(ctx.io, ctx.flags, result);
+	return 0;
+}

package/package.json

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