@letterstory/cli 0.131.1 → 0.133.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.1";
+export const VERSION = "0.133.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
@@ -1343,6 +1343,7 @@ The Site (one model of your whole marketing site, keyed by host and path):
                      [--observation <id>]...           Propose a registry tool call; input is validated now
   site decide <proposal-id> --decision accept|dismiss [--reason <why>]
   site fix <host> <observation-id>... [--action build|build_pr|build_merge|slack|linear|handoff] [--with-preview]
+                                    [--harness claude-code|letterpress-1]
                                                        One change for N observations; handoff prints the prompt, slack/linear need no repo
   site competitors [--since <iso> | --days <n>] [--limit <n>]  Tracked competitors' sites: new and removed pages, by folder
   site watch-competitors [domain] [--limit <n>]        Map competitors' sitemaps (the next few unmapped, or one now)
@@ -1364,9 +1365,13 @@ 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>]...
-             [--action build|build_pr|build_merge|slack|linear] [--with-preview] [--wait]
-                                                       Start a change (attached files go to the sandbox);
+             [--attach-ref <path>]... [--attach-url-ref <name>=<https url>]...
+             [--action build|build_pr|build_merge|slack|linear] [--with-preview]
+             [--harness claude-code|letterpress-1] [--wait]
+                                                       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;
+                                                       --harness picks the coding agent (default: the deployment's);
                                                        --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]
                                                        One PR fixing site-audit issues (repeat --issue to bundle) on every affected page,

package/lib/commands/repo.mjs

@@ -59,12 +59,15 @@ 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" },
 		// --with-preview: the PR opens straight away and a preview of the change stays up next to it.
 		with_preview: { flag: "with-preview", type: "bool" },
+		// --harness claude-code|letterpress-1: the coding agent; omitted, the deployment's default.
+		harness: { flag: "harness", enum: ["claude-code", "letterpress-1"] },
 	},
 	create_repo_change_upload: { file_names: { internal: "the basenames of the --attach files" } },
 	list_repo_sites: {},
@@ -300,7 +303,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 +335,21 @@ async function repoStart(ctx) {
 		"instructions-file",
 		"attach",
 		"attach-url",
+		"attach-ref",
+		"attach-url-ref",
 		"action",
 		"preview",
 		"with-preview",
+		"harness",
 		"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/lib/commands/site.mjs

@@ -180,6 +180,8 @@ const ARGS = {
 		action: { flag: "action", enum: ["build", "build_pr", "build_merge", "slack", "linear", "handoff"] },
 		// --with-preview: the PR opens straight away and a preview of the fix stays up next to it.
 		with_preview: { flag: "with-preview", type: "bool" },
+		// --harness claude-code|letterpress-1: the coding agent; omitted, the deployment's default.
+		harness: { flag: "harness", enum: ["claude-code", "letterpress-1"] },
 	},
 };
 

package/package.json

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