@letterstory/cli 0.131.0 → 0.132.0

package/lib/cli.mjs

@@ -62,7 +62,7 @@ import {
 } from "./commands.mjs";
 
 // Keep in sync with cli/package.json.
-export const VERSION = "0.131.0";
+export const VERSION = "0.132.0";
 
 // 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
@@ -1364,8 +1364,10 @@ Repo changes (Claude Code edits your repo in a sandbox; the Letterstory GitHub A
   repo slack-test                                      Post a test into the Send to Slack channel
   repo start --repo <owner/name> --instructions <text>|--instructions-file <path|->
              [--branch <base>] [--attach <path>]... [--attach-url <name>=<https url>]...
+             [--attach-ref <path>]... [--attach-url-ref <name>=<https url>]...
              [--action build|build_pr|build_merge|slack|linear] [--with-preview] [--wait]
-                                                       Start a change (attached files go to the sandbox);
+                                                       Start a change (attached files go to the sandbox;
+                                                       -ref ones are context, never put in the repo);
                                                        --with-preview keeps a preview up next to the PR;
                                                        --wait follows it to the PR
   repo fix-audit --issue <issue-type>... [--audit <id>] [--branch <base>] [--action build|build_pr|build_merge|slack|linear] [--wait]

package/lib/commands/enclosures.mjs

@@ -110,6 +110,10 @@ export const ARGS = {
 		...fields,
 	},
 	list_generator_starters: {},
+	get_generator_version: {
+		generator_id: { positional: 0, label: "enclosure-id", required: true },
+		version: { value: (_flags, positionals) => Number(requirePositional(positionals, 1, "version")) },
+	},
 	add_generator_version: {
 		generator_id: { positional: 0, label: "enclosure-id", required: true },
 		script: { value: (flags) => readTextInput(flags, "script", "script-file") },
@@ -173,6 +177,7 @@ const USAGE = `Usage: enclosures <list|show|create|update|prints>
   enclosures prints <enclosure-id> [--status done|failed|no_fit|…] [--limit <n>]
   enclosures starters
   enclosures create --starter site_audit --login <app-id>       Begin from a starter (its version 1 included)
+  enclosures version <enclosure-id> <n>                        One version in full: its steps and the script prints replay
   enclosures add-version <enclosure-id> (--script <code>|--script-file <path>) --step <text>… [--host <h>…] [--summary <s>]
   enclosures approve <enclosure-id> --version <n>
   enclosures print <enclosure-id> (--prospect <id>…|--list <list-id>) [--version <n>] [--redo] [--dry-run]
@@ -201,6 +206,8 @@ export async function cmdEnclosures(ctx) {
 			return enclosuresApps(rest);
 		case "starters":
 			return enclosuresStarters(rest);
+		case "version":
+			return enclosuresVersion(rest);
 		case "add-version":
 			return enclosuresAddVersion(rest);
 		case "approve":
@@ -346,6 +353,28 @@ async function enclosuresStarters(ctx) {
 	return 0;
 }
 
+async function enclosuresVersion(ctx) {
+	const { client, flags, positionals, io } = ctx;
+	refuseUnknownFlags(ctx, ARGS.get_generator_version, []);
+	const result = await client.callTool(
+		"get_generator_version",
+		argsFromFlags(ARGS.get_generator_version, flags, positionals)
+	);
+	printResult(io, flags, result, ({ version: v }) =>
+		[
+			`version ${v.version} (${v.author})${v.current ? ", prints run this one" : ""}${v.change_summary ? `: ${v.change_summary}` : ""}`,
+			...v.steps.map((s) => `  ${s.n}. ${s.text}${s.screenshot_url ? `  ${s.screenshot_url}` : ""}`),
+			v.allowed_hosts.length ? `  hosts: ${v.allowed_hosts.join(", ")}` : null,
+			v.region ? `  region: ${v.region.selectors.join(", ")}` : null,
+			"",
+			v.script,
+		]
+			.filter((l) => l !== null)
+			.join("\n")
+	);
+	return 0;
+}
+
 async function enclosuresAddVersion(ctx) {
 	const { client, flags, positionals, io } = ctx;
 	refuseUnknownFlags(ctx, ARGS.add_generator_version, ["script", "script-file", "step", "region-selector"]);

package/lib/commands/repo.mjs

@@ -59,7 +59,8 @@ const ARGS = {
 		base_branch: "branch",
 		// --instructions, or a longer brief from --instructions-file <path> / - (stdin).
 		instructions: { value: (flags) => readTextInput(flags, "instructions", "instructions-file") },
-		// --attach <path> (uploaded first) and --attach-url <name>=<https url>, both repeatable.
+		// --attach <path> (uploaded first) and --attach-url <name>=<https url>, both repeatable;
+		// --attach-ref / --attach-url-ref the same for context the agent reads, never puts in the repo.
 		files: { value: (_flags, _positionals, extra) => (extra.files?.length ? extra.files : undefined) },
 		action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack", "linear"] },
 		preview: { flag: "preview", type: "bool" },
@@ -300,7 +301,7 @@ async function uploadAttachments(ctx, paths) {
 			.replace(/[^A-Za-z0-9._ -]/g, "-")
 			.replace(/^[^A-Za-z0-9]+/, "")
 	);
-	if (new Set(names).size !== names.length) throw new CliError("Two --attach files share a name; rename one.");
+	if (new Set(names).size !== names.length) throw new CliError("Two attached files share a name; rename one.");
 	const bytes = paths.map((p) => {
 		try {
 			return readFileSync(p);
@@ -332,14 +333,20 @@ async function repoStart(ctx) {
 		"instructions-file",
 		"attach",
 		"attach-url",
+		"attach-ref",
+		"attach-url-ref",
 		"action",
 		"preview",
 		"with-preview",
 		"wait",
 	]);
+	// One upload for every file (names must be unique across both), then the references marked.
+	const place = flagList(flags.attach);
+	const uploaded = await uploadAttachments(ctx, [...place, ...flagList(flags["attach-ref"])]);
 	const files = [
-		...(await uploadAttachments(ctx, flagList(flags.attach))),
+		...uploaded.map((f, i) => (i < place.length ? f : { ...f, reference: true })),
 		...attachmentUrls(flagList(flags["attach-url"])),
+		...attachmentUrls(flagList(flags["attach-url-ref"])).map((f) => ({ ...f, reference: true })),
 	];
 	const args = argsFromFlags(ARGS.start_repo_change, flags, ctx.positionals, { files });
 	if (!args.repo_owner || !args.repo_name) throw new CliError("Missing --repo owner/name");

package/package.json

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