@letterstory/cli 0.82.2 → 0.82.3

package/lib/cli.mjs

@@ -57,7 +57,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.82.2";
+export const VERSION = "0.82.3";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value. Every `type: "bool"` flag (and its
@@ -333,10 +333,16 @@ Collections:
   collections autopen <id> [--template <key>|none] [--kernel-family <name>|org]
                            [--mention off|subtle|woven] [--outline-depth barebones|fleshed_out]
                            [--direction-gate true|false] [--auto-start true|false]
+                           [--prefer <site> …|none]
       The Auto-Pen settings the app's panel writes. --template binds a content
       template (from 'templates list') as this collection's default, which is how
       a template you author here actually gets used. A patch: unset flags are
-      left alone.
+      left alone. --prefer REPLACES the preferred sources: SITES research
+      searches for every post's topic and reaches for first when a figure fits
+      (a URL is saved as its site) — your own site included; 'none' clears them.
+  collections cite-preferred <id> [--limit <n>] [--dry-run]
+      Bring published posts up to the preferred sources: each eligible post gets
+      at most one preferred figure, linked on the figure, then republishes.
 
 Authors (the per-collection author bank — recurring bylines):
   authors list <collection-id>                        List the bank + byline distribution
@@ -452,7 +458,7 @@ Ranking targets (what the org wants to be THE answer for — company-wide or on
 Arenas (adversarial clusters of research agents -> a sourced, fact-checked outline):
   arena run --topic <text> [--source <url> …] [--must-include <text> …] [--depth barebones|fleshed_out]
             [--gate] [--no-verify] [--provider native|exa|youcom|context-dev] [--mention off|subtle|woven]
-            [--context-file ctx.json] [--block <name> …] [--block-domain <domain> …]
+            [--context-file ctx.json] [--block <name> …] [--block-domain <domain> …] [--prefer <site> …]
             [--arena <arena-id>] [--article <uuid>] [--no-wait]
                                                         Start a run and follow it. --article makes
                                                         it HOSTED (outline written into that post,

package/lib/commands/arena.mjs

@@ -22,6 +22,7 @@ import {
 	toolField,
 	followJob,
 	argsFromFlags,
+	preferredSourcesFlag,
 } from "./shared.mjs";
 
 /** `--<flag> <path>` → the file's parsed JSON, or undefined when the flag is not set. */
@@ -75,6 +76,8 @@ const RUN_OPTIONS = {
 	context: { value: (flags) => readJsonObjectFlag(flags, "context") },
 	blocked_mentions: { flag: "block", type: "list" },
 	blocked_domains: { flag: "block-domain", type: "list" },
+	// Pages (read every run) and sites research reaches for first; `--prefer none` declares none.
+	preferred_sources: { value: (flags) => preferredSourcesFlag(flags.prefer) },
 };
 
 /**

package/lib/commands/collections.mjs

@@ -2,7 +2,7 @@
 // Ported from phantomstory-cli's collections.ts.
 
 import { CliError } from "../client.mjs";
-import { flagStr, printResult, ok, argsFromFlags } from "./shared.mjs";
+import { flagStr, printResult, ok, argsFromFlags, preferredSourcesFlag } from "./shared.mjs";
 import { cmdCollection } from "./collection.mjs";
 
 // `--flag none|off|""` clears a nullable field; the server takes null for that.
@@ -47,6 +47,11 @@ export const ARGS = {
 		regenerate_topic_map: { value: (flags) => (flags["no-topic-map"] === undefined ? undefined : false) },
 		stock_headlines: { value: (flags) => (flags["no-headlines"] === undefined ? undefined : false) },
 	},
+	cite_preferred_sources: {
+		collection_id: { positional: 0, label: "collection-id", required: true },
+		limit: { flag: "limit", type: "num" },
+		dry_run: { value: (flags) => (flags["dry-run"] === true ? true : undefined) },
+	},
 	update_auto_pen_config: {
 		collection_id: { positional: 0, label: "collection-id", required: true },
 		// `--template none` clears the binding; the server takes null for that.
@@ -69,6 +74,8 @@ export const ARGS = {
 		},
 		mention: { object: { degree: "mention" } },
 		auto_start_on_curate: stringBool("auto-start"),
+		// Replaces the collection's preferred sources; `--prefer none` clears them.
+		preferred_sources: { value: (flags) => preferredSourcesFlag(flags.prefer) },
 	},
 };
 
@@ -99,9 +106,11 @@ export async function cmdCollections(ctx) {
 			return collectionsAutoPen(rest);
 		case "activate":
 			return collectionsActivate(rest);
+		case "cite-preferred":
+			return collectionsCitePreferred(rest);
 		default:
 			throw new CliError(
-				`Unknown collections subcommand: ${sub ?? "(none)"}. Try: list, new, update, delete, assign, autopen, activate`
+				`Unknown collections subcommand: ${sub ?? "(none)"}. Try: list, new, update, delete, assign, autopen, activate, cite-preferred`
 			);
 	}
 }
@@ -129,6 +138,26 @@ async function collectionsActivate(ctx) {
 	return 0;
 }
 
+/**
+ * `collections cite-preferred <id> [--limit <n>] [--dry-run]` — bring the collection's published
+ * posts up to its preferred sources: each eligible post places at most one preferred figure and
+ * republishes. The same function as the app's "Apply to published posts".
+ */
+async function collectionsCitePreferred(ctx) {
+	const { client, positionals, flags, io } = ctx;
+	const args = argsFromFlags(ARGS.cite_preferred_sources, flags, positionals);
+	const result = await client.callTool("cite_preferred_sources", args);
+	const n = result?.started?.length ?? 0;
+	ok(
+		ctx,
+		result?.dry_run
+			? `Would run ${n} post${n === 1 ? "" : "s"}; ${result?.skipped?.length ?? 0} skipped.`
+			: `Started ${n} post${n === 1 ? "" : "s"}${result?.republishes === false ? " (changes wait on the draft for approval)" : ""}; ${result?.skipped?.length ?? 0} skipped.`
+	);
+	printResult(io, flags, result);
+	return 0;
+}
+
 async function collectionsUpdate(ctx) {
 	const { client, positionals, flags, io } = ctx;
 	const patch = argsFromFlags(ARGS.update_collection, flags, positionals);
@@ -166,7 +195,7 @@ async function collectionsAutoPen(ctx) {
 	const patch = argsFromFlags(ARGS.update_auto_pen_config, flags, positionals);
 	if (Object.keys(patch).length === 1) {
 		throw new CliError(
-			"Nothing to change. Pass at least one of --template, --kernel-family, --mention, --outline-depth, --direction-gate, --auto-start."
+			"Nothing to change. Pass at least one of --template, --kernel-family, --mention, --outline-depth, --direction-gate, --auto-start, --prefer."
 		);
 	}
 

package/lib/commands/shared.mjs

@@ -32,6 +32,20 @@ export function flagList(v) {
 	return typeof v === "string" ? [v] : [];
 }
 
+/**
+ * `--prefer <site>` (repeatable or comma-separated) → preferred_sources `[{ url }]` (a site; a URL is read as its site); `--prefer none`
+ * → `[]` (clears a standing list); absent → undefined.
+ */
+export function preferredSourcesFlag(v) {
+	if (v === undefined) return undefined;
+	const list = flagList(v)
+		.flatMap((x) => x.split(","))
+		.map((x) => x.trim())
+		.filter(Boolean);
+	if (list.length === 1 && list[0] === "none") return [];
+	return list.map((url) => ({ url }));
+}
+
 export function requireFlag(flags, name) {
 	const v = flagStr(flags[name]);
 	if (v === undefined) throw new CliError(`Missing required --${name}`);

package/package.json

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