@letterstory/cli 0.61.2 → 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.61.2";
+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)
@@ -615,9 +615,9 @@ Admin (STAFF key — --staff-key / LETTERSTORY_STAFF_API_KEY; acts before an org
   admin tuning-context [--q "<question>"]              The experiment agent's context pack (JSON):
                                                        the pipeline as deployed, levers, measures,
                                                        goals, related history.
-  admin tuning desk                                    What waits on a person: comparisons to read
-                                                       blind, questions to decide, versions to
-                                                       promote, open corpus flags, overdue patterns.
+  admin tuning pipeline [--primitive write|research|shred|enhance|chain] [--refresh]
+                                                       One primitive's stages as deployed, the
+                                                       registry the Pipeline tab draws (JSON).
   admin tuning <sub> …                                 The console's loop over a staff key: kernels,
                                                        candidate, compare, comparisons, picks, pick,
                                                        reading-list, pair, side-by-side, promote,
@@ -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/admin.mjs

@@ -420,7 +420,7 @@ async function cmdAdminTuningContext(ctx) {
  * and promotion from the ledger (docs/architecture/tuning-foundation.md): the headless half of the
  * tuning console's Write › Kernels and Compare tabs. Needs `tuning:experiment` on the key.
  *
- *   admin tuning desk                                          what waits on a person: comparisons to read blind, questions to decide, versions to promote, open flags, overdue findings
+ *   admin tuning pipeline [--primitive write|research|shred|enhance|chain] [--refresh]   one primitive's stages as deployed (JSON)
  *   admin tuning kernels                                       every catalog kernel, live version, writer, candidates
  *   admin tuning kernel <service-kernel-id> [--version N|live]  one version's file (JSON)
  *   admin tuning candidate <service-kernel-id> --file f.json [--note "…"]   save a file as a candidate version
@@ -530,19 +530,11 @@ async function cmdAdminTuning(ctx) {
 	const json = flagBool(flags.json);
 	const T = "/api/superadmin/tuning";
 	switch (sub) {
-		case "desk": {
-			const d = await staffRequest(ctx, "GET", `${T}/desk`);
-			if (json) return printResult(io, flags, d);
-			const lines = [];
-			for (const c of d.to_read)
-				lines.push(`read blind   ${c.read}/${c.target}  ${c.primitive.padEnd(8)} ${c.title}  ${c.id}`);
-			for (const e of d.to_decide) lines.push(`decide       ${e.status.padEnd(9)} ${e.question}  ${e.id}`);
-			for (const e of d.to_promote) lines.push(`promote      ship      ${e.question}  ${e.id}`);
-			if (d.flags_open) lines.push(`flags        ${d.flags_open} corpus flags open`);
-			if (d.findings_overdue)
-				lines.push(`triage       ${d.findings_overdue} shipped patterns past their due date`);
-			for (const err of d.errors ?? []) lines.push(`(could not read: ${err})`);
-			return io.log(lines.join("\n") || "Nothing waits on a person.");
+		case "pipeline": {
+			const primitive = flagStr(flags.primitive) ?? "write";
+			const q = new URLSearchParams({ primitive });
+			if (flagBool(flags.refresh)) q.set("refresh", "1");
+			return printResult(io, { ...flags, json: true }, await staffRequest(ctx, "GET", `${T}/pipeline?${q}`));
 		}
 		case "kernels": {
 			const r = await staffRequest(ctx, "GET", `${T}/kernel-files`);

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.61.2",
+	"version": "0.63.1",
 	"description": "Spin up and manage Letterstory phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",