feat(micro): replace MICRO_SITE_URL with --branch CLI flag

Instead of an env var, the CLI now derives the site URL from an optional
--branch / -b flag. No branch (or "main") resolves to https://just-be.dev;
any other branch resolves to the Cloudflare Workers preview URL pattern
https://{branch}-just-be-dev.just-be.workers.dev.

siteUrl is threaded as a required parameter into browse() and post() rather
than being read from the environment inside each function.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: just-be-dev

packages/micro/README.md

@@ -53,6 +53,20 @@ Creates a post directly from the command line.
 
 - Bun >= 1.0.0
 - A running instance of the site with `MICRO_BUCKET` (R2) and `MICRO_SECRET` configured
+- `MICRO_SECRET` environment variable set locally to authenticate with the API
+
+## Targeting a Branch Preview
+
+By default the CLI talks to the production site (`https://just-be.dev`). Pass `--branch`
+(or `-b`) to target the Cloudflare Workers preview URL for any branch:
+
+```bash
+micro --branch add-micro-blog-section
+micro post --branch add-micro-blog-section "Hello from the preview"
+```
+
+Branch names are automatically sanitized for subdomain use. Passing `main` (or omitting
+the flag entirely) always resolves to the production URL.
 
 ## Social Media Syndication
 
@@ -104,4 +118,5 @@ To test syndication without real API credentials, simply don't set the environme
 
 ## Development
 
-The CLI talks to the site's HTTP API. Set `MICRO_SECRET` to authenticate and `MICRO_SITE_URL` to point at a local dev server (defaults to `https://just-be.dev`).
+The CLI talks to the site's HTTP API. Set `MICRO_SECRET` to authenticate, then use
+`--branch <name>` to point at the preview URL for your branch.

packages/micro/index.ts

@@ -3,22 +3,48 @@
 import { browse } from "./src/browse.ts";
 import { post } from "./src/post.ts";
 
-const args = process.argv.slice(2);
+const PRODUCTION_URL = "https://just-be.dev";
+const WORKER_NAME = "just-be-dev";
+const WORKERS_DEV_SUBDOMAIN = "just-be";
+
+function siteUrlFromBranch(branch: string | undefined): string {
+  if (!branch || branch === "main") return PRODUCTION_URL;
+  // Sanitize branch name for subdomain use: replace non-alphanumeric chars with hyphens
+  const sanitized = branch
+    .toLowerCase()
+    .replace(/[^a-z0-9-]+/g, "-")
+    .replace(/^-+|-+$/g, "");
+  return `https://${sanitized}-${WORKER_NAME}.${WORKERS_DEV_SUBDOMAIN}.workers.dev`;
+}
+
+// Extract global --branch / -b flag and leave remaining args for command parsing
+const rawArgs = process.argv.slice(2);
+let branch: string | undefined;
+const args: string[] = [];
+
+for (let i = 0; i < rawArgs.length; i++) {
+  if ((rawArgs[i] === "--branch" || rawArgs[i] === "-b") && i + 1 < rawArgs.length) {
+    branch = rawArgs[++i];
+  } else {
+    args.push(rawArgs[i]);
+  }
+}
+
 const command = args[0];
+const siteUrl = siteUrlFromBranch(branch);
 
 async function main() {
   if (!command) {
-    // Default: browse all posts
-    await browse();
+    await browse(siteUrl);
   } else if (command === "post") {
     const content = args[1];
-    await post(content);
+    await post(content, siteUrl);
   } else {
     console.error(`Unknown command: ${command}`);
     console.log("Usage:");
-    console.log("  micro              - Browse all posts");
-    console.log("  micro post         - Create a new post (TUI editor)");
-    console.log('  micro post "text"  - Create a new post directly');
+    console.log("  micro [--branch <name>]               - Browse all posts");
+    console.log("  micro post [--branch <name>]          - Create a new post (TUI editor)");
+    console.log('  micro post [--branch <name>] "text"   - Create a new post directly');
     process.exit(1);
   }
 }

packages/micro/src/browse.ts

@@ -8,27 +8,22 @@ interface Post {
   syndicatedTo: Array<{ platform: string; id: string; url: string }>;
 }
 
-const DEFAULT_SITE_URL = "https://just-be.dev";
-
-function getConfig() {
+function getSecret(): string {
   const secret = process.env.MICRO_SECRET;
   if (!secret) {
     console.error("Error: MICRO_SECRET environment variable not set");
     process.exit(1);
   }
-  return {
-    secret,
-    siteUrl: process.env.MICRO_SITE_URL ?? DEFAULT_SITE_URL,
-  };
+  return secret;
 }
 
-export async function browse() {
+export async function browse(siteUrl: string) {
   p.intro("Micro Blog Browser");
 
   const spinner = p.spinner();
   spinner.start("Loading posts...");
 
-  const { secret, siteUrl } = getConfig();
+  const secret = getSecret();
 
   let posts: Post[];
   try {

packages/micro/src/post.ts

@@ -1,21 +1,17 @@
 import * as p from "@clack/prompts";
 
 const MAX_LENGTH = 280;
-const DEFAULT_SITE_URL = "https://just-be.dev";
 
-function getConfig() {
+function getSecret(): string {
   const secret = process.env.MICRO_SECRET;
   if (!secret) {
     console.error("Error: MICRO_SECRET environment variable not set");
     process.exit(1);
   }
-  return {
-    secret,
-    siteUrl: process.env.MICRO_SITE_URL ?? DEFAULT_SITE_URL,
-  };
+  return secret;
 }
 
-export async function post(content?: string) {
+export async function post(content: string | undefined, siteUrl: string) {
   let postContent = content;
 
   if (!postContent) {
@@ -47,7 +43,7 @@ export async function post(content?: string) {
     }
   }
 
-  const { secret, siteUrl } = getConfig();
+  const secret = getSecret();
   const spinner = p.spinner();
   spinner.start("Creating post...");