@letterstory/cli 0.98.3 → 0.98.4

package/lib/cli.mjs

@@ -59,7 +59,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.98.3";
+export const VERSION = "0.98.4";
 
 // 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

package/lib/commands/targets.mjs

@@ -8,7 +8,7 @@
 // routes and staff Fleet do.
 
 import { CliError } from "../client.mjs";
-import { flagStr, flagNum, printResult, argsFromFlags, refuseUnknownFlags, ok } from "./shared.mjs";
+import { flagStr, flagNum, flagList, printResult, argsFromFlags, refuseUnknownFlags, ok } from "./shared.mjs";
 
 const STATUSES = ["active", "inactive", "achieved", "retired"];
 const PRIORITIES = ["high", "normal", "low"];
@@ -25,8 +25,9 @@ function readOffering(flags) {
 }
 const offering = { value: readOffering };
 
-// `--priority high|normal|low|default`: how much the target's questions count in share of
-// voice (high = 3 votes, normal = 2, low = 1); default = back to high, a target's default.
+// `--priority high|normal|low|default`: how often the target's ground is written across target
+// slots, and how much its questions count in share of voice (high = 3, normal = 2, low = 1);
+// default = back to high, a target's default.
 function readPriority(flags) {
 	const v = flagStr(flags.priority);
 	if (v === undefined) {
@@ -55,6 +56,8 @@ export const ARGS = {
 		mention_framing: "framing",
 		offering_id: offering,
 		priority,
+		// `--stance <text>`, repeatable: one point of view per flag.
+		stances: { flag: "stance", type: "list" },
 	},
 	update_ranking_target: {
 		target_id: { positional: 0, label: "target-id", required: true },
@@ -67,6 +70,14 @@ export const ARGS = {
 		offering_id: offering,
 		position: { flag: "position", type: "num" },
 		priority,
+		// `--stance <text>` (repeatable) REPLACES the list; `--clear-stances` empties it.
+		stances: {
+			value: (flags) => {
+				if (flags["clear-stances"] === true) return [];
+				const list = flagList(flags.stance);
+				return list.length ? list : undefined;
+			},
+		},
 	},
 	set_ranking_target_cap: {
 		offering_id: {
@@ -117,8 +128,10 @@ export const ARGS = {
 const USAGE = `Usage: targets <list|add|update|activate|deactivate|cap|suggest|subqueries|subquery>
   targets list [--offering <offering-id|company>]
   targets add <phrase> [--framing <f>] [--offering <offering-id|company>] [--priority high|normal|low]
+                 [--stance <s>]...                       points of view held on this target's ground only
   targets update <target-id> [--phrase <p>] [--framing <f> | --clear-framing] [--offering <offering-id|company>]
                  [--position <n>] [--state active|inactive|achieved|retired] [--priority high|normal|low|default]
+                 [--stance <s>]... | --clear-stances      replaces the target's stances
   targets activate <target-id>
   targets deactivate <target-id>
   targets cap <offering-id|company> <n|default>
@@ -165,7 +178,8 @@ function formatScope(s) {
 function formatTarget(t) {
 	const framing = t.mention_framing ? ` — as ${t.mention_framing}` : "";
 	const prio = t.priority ? `  (${t.priority} priority)` : "";
-	return `  ${t.id}  [${t.status}]  ${t.phrase}${framing}${prio}`;
+	const stances = (t.stances ?? []).map((s) => `\n      · ${s}`).join("");
+	return `  ${t.id}  [${t.status}]  ${t.phrase}${framing}${prio}${stances}`;
 }
 
 // Targets grouped under their scope, each headed by its cap and usage. A target on an
@@ -223,7 +237,7 @@ async function update(ctx, flags) {
 	const args = argsFromFlags(ARGS.update_ranking_target, flags, positionals);
 	if (Object.keys(args).length === 1) {
 		throw new CliError(
-			"Nothing to update — pass --phrase, --framing, --clear-framing, --offering, --position, --state or --priority."
+			"Nothing to update — pass --phrase, --framing, --clear-framing, --stance, --clear-stances, --offering, --position, --state or --priority."
 		);
 	}
 	const result = await client.callTool("update_ranking_target", args);
@@ -233,7 +247,14 @@ async function update(ctx, flags) {
 }
 
 async function targetsUpdate(ctx) {
-	refuseUnknownFlags(ctx, ARGS.update_ranking_target, ["framing", "clear-framing", "offering", "priority"]);
+	refuseUnknownFlags(ctx, ARGS.update_ranking_target, [
+		"framing",
+		"clear-framing",
+		"stance",
+		"clear-stances",
+		"offering",
+		"priority",
+	]);
 	return update(ctx, ctx.flags);
 }
 

package/package.json

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