@letterstory/cli 0.176.66 → 0.176.68

package/README.md

@@ -123,6 +123,8 @@ letterstory phantom resume <phantom-id>
 letterstory phantom diagnostics <phantom-id>                    # why is my site empty?
 letterstory phantom balance                                     # sites live / granted, and the cadence cap
 letterstory phantom spread-looks [--apply]                      # a different look per site; dry run unless --apply
+letterstory phantom source <phantom-id> code                    # build the site from its own repo; each new post merges in as Markdown
+letterstory phantom source <phantom-id> template                # back to the shared template (the repo is archived)
 letterstory phantom delete <phantom-id> --yes
 ```
 

package/lib/cli.mjs

@@ -85,7 +85,7 @@ import {
 import { fetchParkedSections, withoutParked } from "./parked.mjs";
 
 // Matches cli/package.json; publish-cli.yml rewrites both to the published version.
-export const VERSION = "0.176.66";
+export const VERSION = "0.176.68";
 
 /** The exit code for a gate refusal (CARD_REQUIRED, PAYMENT_FAILED, OUT_OF_TOKENS): 1 is a plain error. */
 export const EXIT_PAYMENT_REQUIRED = 3;
@@ -568,6 +568,8 @@ Phantomstory (a collection Letter hosts as an independent publication):
                                                        The site's file joined to its collection's
   phantom rebuild <phantom-id> · phantom diagnostics <phantom-id> · phantom balance
   phantom spread-looks [--apply]                         Give each live site a different look (dry run by default)
+  phantom source <phantom-id> code|template              Build the site from its own repo (every post a Markdown
+                                                       file, new posts merged in), or the shared template again
   phantom domain check <domain> · phantom domain buy <phantom-id> <domain> --yes
   phantom domain connect <phantom-id> <domain>
   phantom delete <phantom-id> --yes
@@ -2144,7 +2146,13 @@ export async function run(argv, io = defaultIo()) {
 	}
 
 	try {
-		const config = resolveConfig({ url: str(flags.url), key: str(flags.key) });
+		// A subcommand that declares its own `--key`/`--url` (`automate send --key <event id> --url <page>`) keeps them;
+		// they never become the API key or the API's URL (2026-11-08 E2E: a 401 and a "path not found").
+		const owns = handler.ownFlags?.(positionals[1]) ?? [];
+		const config = resolveConfig({
+			url: owns.includes("url") ? undefined : str(flags.url),
+			key: owns.includes("key") ? undefined : str(flags.key),
+		});
 		// A silent refresh mid-command should persist the new tokens so the next
 		// invocation doesn't have to refresh again — but only when the config we
 		// resolved actually came from a saved OAuth session (a --key/env override

package/lib/commands/automate.mjs

@@ -31,7 +31,7 @@ const TEMPLATES = [
 	"monthly_page_refresh",
 ];
 const UNITS = ["hours", "days", "weeks", "months"];
-const STATUSES = ["pending", "proposed", "acting", "acted", "skipped", "failed", "rejected"];
+const STATUSES = ["pending", "proposed", "acting", "acted", "answered", "skipped", "failed", "rejected"];
 
 const triggerParams = {
 	object: {
@@ -211,6 +211,9 @@ export async function cmdAutomate(ctx) {
 	}
 }
 
+/** The global flags a subcommand reads as its own arguments, so the CLI never takes them as its key or URL. */
+cmdAutomate.ownFlags = (sub) => (sub === "send" ? ["key", "url"] : []);
+
 async function run(ctx, tool, said, extra = {}) {
 	const { client, flags, io } = ctx;
 	const result = await client.callTool(tool, { ...argsFromFlags(ARGS[tool], flags, ctx.positionals), ...extra });

package/lib/commands/phantom.mjs

@@ -116,6 +116,11 @@ export const ARGS = {
 		phantom_id: { positional: 0, label: "phantom-id", required: true },
 		paused: { value: (flags, positionals, extra) => extra.paused },
 	},
+	// `phantom source <id> code|template` — build the site from its own repo, or the shared template again.
+	set_phantom_source: {
+		phantom_id: { positional: 0, label: "phantom-id", required: true },
+		source: { positional: 1, label: "code|template", required: true },
+	},
 	get_phantom_diagnostics: { phantom_id: { positional: 0, label: "phantom-id", required: true } },
 	get_phantom_balance: {},
 	spread_phantom_looks: { apply: { flag: "apply", type: "bool" } },
@@ -162,6 +167,8 @@ export async function cmdPhantom(ctx) {
 		case "pause":
 		case "resume":
 			return phantomPause(rest, sub === "pause");
+		case "source":
+			return call(rest, "set_phantom_source");
 		case "diagnostics":
 		case "diag":
 			return call(rest, "get_phantom_diagnostics");
@@ -173,7 +180,7 @@ export async function cmdPhantom(ctx) {
 			return phantomDomain(rest);
 		default:
 			throw new CliError(
-				`Unknown phantom subcommand: ${sub ?? "(none)"}. Try: list, get, new, config, visitors, delete, rebuild, pause, resume, diagnostics, balance, spread-looks, domain`
+				`Unknown phantom subcommand: ${sub ?? "(none)"}. Try: list, get, new, config, visitors, delete, rebuild, pause, resume, source, diagnostics, balance, spread-looks, domain`
 			);
 	}
 }

package/package.json

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