@letterstory/cli 0.131.1 → 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.1";
+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/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.1",
+	"version": "0.132.0",
 	"description": "Spin up and manage Letterstory phantom blogs from your terminal.",
 	"type": "module",
 	"license": "UNLICENSED",