@letterstory/cli 0.25.5 → 0.25.6

package/lib/cli.mjs

@@ -44,7 +44,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.25.5";
+export const VERSION = "0.25.6";
 
 // Flags that never take a value. Listing them explicitly means `deploy get --json <id>`
 // can't accidentally swallow the id as --json's value.
@@ -455,10 +455,13 @@ Seers (event-driven signals -> drafts):
   seers list                                           List seers with recent activity
   seers get <seer-id>                                  One seer's full config + poll state
   seers providers                                      Provider catalog: config fields + behavior keys
-  seers create --name <n> --collection <uuid> --provider <p>
+  seers create --name <n> --provider <p> [--collection <uuid>]
                [--mode suggest|auto] [--interval <min>] [--config '<json>'|--config-file <path>]
-  seers update <seer-id> [--name] [--collection] [--mode] [--enabled true|false]
-               [--interval <min>] [--config '<json>'|--config-file <path>]
+                                                      --collection is optional: omit it for a
+                                                      detect-only seer (scans + judges, never
+                                                      produces). --mode auto requires one.
+  seers update <seer-id> [--name] [--collection <uuid> | --clear-collection] [--mode]
+               [--enabled true|false] [--interval <min>] [--config '<json>'|--config-file <path>]
   seers delete <seer-id> --yes
   seers run <seer-id> [--dry-run] [--no-produce] [--async]
                                                        Run now — THE DOOR (one seer run from the balance).

package/lib/commands/seers.mjs

@@ -16,6 +16,16 @@ import { readFileSync, writeFileSync } from "node:fs";
 import { CliError } from "../client.mjs";
 import { flagStr, flagBool, requirePositional, printResult, ok, argsFromFlags } from "./shared.mjs";
 
+// A single-value flag the API clears with an explicit `null` (same idiom as
+// strategy.mjs's clearableList): `--clear-collection` sends null, `--collection <uuid>`
+// sends it, neither sends nothing (no change).
+const clearableValue = (flag, clearFlag) => ({
+	value: (flags) => {
+		if (flags[clearFlag]) return null;
+		return flagStr(flags[flag]);
+	},
+});
+
 /**
  * How the ratcheted commands in this file source their tool inputs — see `argsFromFlags` in
  * shared.mjs and `scripts/parity-check.ts`. The rest of the module predates the field-level
@@ -46,7 +56,9 @@ export const ARGS = {
 	},
 	create_seer: {
 		name: { flag: "name", required: true },
-		collection_id: { flag: "collection", required: true },
+		// Optional (2026-09-18): omit it for a detect-only seer — it can scan and judge
+		// forever but never produce (auto mode is rejected without one).
+		collection_id: { flag: "collection" },
 		provider: { flag: "provider", required: true },
 		mode: { flag: "mode", enum: ["suggest", "auto"] },
 		poll_interval_minutes: { flag: "interval", type: "num" },
@@ -57,7 +69,9 @@ export const ARGS = {
 	update_seer: {
 		seer_id: { positional: 0, label: "seer-id", required: true },
 		name: { flag: "name" },
-		collection_id: { flag: "collection" },
+		// --collection <uuid> sets it, --clear-collection sends null (the seer becomes
+		// detect-only — rejected if it's mode "auto"), neither leaves it unchanged.
+		collection_id: clearableValue("collection", "clear-collection"),
 		mode: { flag: "mode", enum: ["suggest", "auto"] },
 		enabled: { value: (flags) => readEnabledFlag(flags) },
 		poll_interval_minutes: { flag: "interval", type: "num" },

package/package.json

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