@letterstory/cli 0.62.0 → 0.63.1

package/README.md

@@ -144,6 +144,7 @@ letterstory phantom domain connect <phantom-id> myblog.com      # attach one you
 letterstory posts list [--limit <n>] [--collection <uuid>]
 letterstory posts show <article-id>
 letterstory posts new --title "…" --collection <uuid> --body "…" [--article-id <uuid>]   # or --file <path|->; --article-id updates that article instead of creating one
+letterstory posts new --title "…" --collection <uuid> --body "…" --context "Internal data from 120 accounts: disputes fell 38%."   # your own data: stated in the post with your attribution
 letterstory posts publish <article-id>
 letterstory posts unpublish <article-id>
 letterstory posts delete --id <uuid> [--id <uuid> ...]                # permanent; content, history, and any published copy are all removed
@@ -725,6 +726,11 @@ letterstory insights top [--period 14d|30d|90d] [--collection <uuid>] [--limit <
 AI visibility and page access — the Measure tabs' reads, for scripts and agents:
 
 ```bash
+# The Measure Overview: how often AI answers name you and cite your pages (rates
+# with 95% intervals and gated trends), share of voice, search for your site and
+# the phantom network kept apart, and each ranking target's standing.
+letterstory insights summary [--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

@@ -55,7 +55,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.62.0";
+export const VERSION = "0.63.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.
@@ -240,7 +240,7 @@ Phantomstory (a collection Letterstory hosts as an independent publication):
 Content:
   posts list [--limit <n>] [--collection <uuid>]     List your articles
   posts show <article-id>                            Show one article
-  posts new --title <t> --collection <uuid> (--body <text> | --file <path|->) [--article-id <uuid>]
+  posts new --title <t> --collection <uuid> (--body <text> | --file <path|->) [--article-id <uuid>] [--context <text>]
   posts publish <article-id>                         Publish an article
   posts unpublish <article-id>                       Unpublish an article
   posts delete --id <uuid> [--id <uuid> ...]         Permanently delete article(s)
@@ -862,6 +862,7 @@ Mail:
   mail postal-address "<address>"                      Set the org's CAN-SPAM mailing address (email footers)
 
 Insights:
+  insights summary [--period 14d|30d|90d]              Measure Overview: AI named/cited rates, share of voice, search, targets
   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,7 @@
 // `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 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`), 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";
@@ -19,6 +19,9 @@ export const ARGS = {
 		period: { flag: "period", enum: PERIODS },
 		collection_id: { flag: "collection" },
 	},
+	get_measure_summary: {
+		period: { flag: "period", enum: PERIODS },
+	},
 };
 
 export async function cmdInsights(ctx) {
@@ -35,8 +38,12 @@ export async function cmdInsights(ctx) {
 			return call(rest, "get_ai_visibility_bank");
 		case "access":
 			return call(rest, "get_page_access");
+		case "summary":
+			return call(rest, "get_measure_summary");
 		default:
-			throw new CliError(`Unknown insights subcommand: ${sub ?? "(none)"}. Try: site, post, top, bank, access`);
+			throw new CliError(
+				`Unknown insights subcommand: ${sub ?? "(none)"}. Try: summary, site, post, top, bank, access`
+			);
 	}
 }
 

package/lib/commands/posts.mjs

@@ -73,7 +73,9 @@ async function postsNew(ctx) {
 	const body = readBodyInput(flags);
 	if (!body) throw new CliError("Provide --body or --file <path>.");
 	const articleId = flagStr(flags["article-id"]);
-	const args = compact({ title, body, collection_id: collection, article_id: articleId });
+	// Steering and/or your own data: figures in it are stated in the post with your attribution.
+	const context = flagStr(flags.context);
+	const args = compact({ title, body, collection_id: collection, article_id: articleId, context });
 	const result = await client.callTool("ingest_article", args);
 	ok(ctx, articleId ? `Updated "${title}".` : `Created draft "${title}".`);
 	printResult(io, flags, result);

package/package.json

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