ship-em 0.1.0 → 0.2.0

package/dist/index.js

@@ -9,14 +9,15 @@ import chalk4 from "chalk";
 import axios2 from "axios";
 import FormData2 from "form-data";
 import { createReadStream } from "fs";
-import { rmSync, existsSync as existsSync5, appendFileSync, writeFileSync as writeFileSync2, readFileSync as readFileSync5, readdirSync as readdirSync3, statSync as statSync3 } from "fs";
-import { join as join6 } from "path";
+import { rmSync, existsSync as existsSync6, appendFileSync, writeFileSync as writeFileSync4, readFileSync as readFileSync7, readdirSync as readdirSync5, statSync as statSync3 } from "fs";
+import { join as join8 } from "path";
 import { tmpdir } from "os";
 import { create as tarCreate } from "tar";
 
 // src/ui/terminal.ts
 import chalk from "chalk";
 import ora from "ora";
+import { execSync } from "child_process";
 var brand = {
   blue: chalk.hex("#3B82F6"),
   brightBlue: chalk.hex("#60A5FA"),
@@ -197,8 +198,31 @@ var ui = {
     );
     console.log("");
   },
+  // Copy text to clipboard (best-effort)
+  copyToClipboard(text) {
+    try {
+      if (process.platform === "darwin") {
+        execSync("pbcopy", { input: text, stdio: ["pipe", "ignore", "ignore"] });
+        return true;
+      } else if (process.platform === "linux") {
+        try {
+          execSync("xclip -selection clipboard", { input: text, stdio: ["pipe", "ignore", "ignore"] });
+          return true;
+        } catch {
+          try {
+            execSync("xsel --clipboard --input", { input: text, stdio: ["pipe", "ignore", "ignore"] });
+            return true;
+          } catch {
+            return false;
+          }
+        }
+      }
+    } catch {
+    }
+    return false;
+  },
   // Deploy celebration box — shown on success
-  deployBox(appName, url, elapsedSec, fileCount, totalBytes) {
+  deployBox(appName, url, elapsedSec, fileCount, totalBytes, isAnonymous = false) {
     const statsLine = `Deployed in ${elapsedSec.toFixed(1)}s \xB7 ${fileCount} files \xB7 ${ui.formatBytes(totalBytes)}`;
     const content = [
       ["\u{1F680} Shipped!", brand.green.bold("\u{1F680} Shipped!")],
@@ -229,14 +253,25 @@ var ui = {
     }
     console.log(`  ${brand.blue("\u2502")}${" ".repeat(innerWidth)}${brand.blue("\u2502")}`);
     console.log(`  ${brand.blue("\u2570" + "\u2500".repeat(innerWidth) + "\u256F")}`);
+    const copied = ui.copyToClipboard(url);
+    console.log("");
+    console.log(`  ${brand.bold("Share it:")}`);
+    const tweetText = encodeURIComponent(`I just shipped ${appName} live in ${elapsedSec.toFixed(0)}s with @shipem_dev
+
+${url}`);
+    console.log(`    ${brand.gray("Twitter")}  \u2192 ${brand.brightBlue.underline(`https://twitter.com/intent/tweet?text=${tweetText}`)}`);
+    console.log(`    ${brand.gray("Copy URL")} \u2192 ${copied ? brand.green("Copied to clipboard!") : brand.dim(url)}`);
     console.log("");
+    if (isAnonymous) {
+      console.log(`  ${brand.bold("Keep it:")} Run ${chalk.cyan("shipem login")} to claim this deploy`);
+      console.log(`           and get a custom domain.`);
+      console.log("");
+    }
     console.log(`  ${brand.bold("Next steps:")}`);
     console.log(`    ${brand.gray("Update")}   \u2192 ${chalk.cyan("npx shipem")}`);
     console.log(`    ${brand.gray("Status")}   \u2192 ${chalk.cyan("npx shipem status")}`);
     console.log(`    ${brand.gray("Remove")}   \u2192 ${chalk.cyan("npx shipem down")}`);
     console.log("");
-    console.log(`  ${brand.dim("Tip: Share your app! Just send the URL.")}`);
-    console.log("");
   },
   // Format bytes
   formatBytes(bytes) {
@@ -244,6 +279,97 @@ var ui = {
     if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
     return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
   },
+  // Progress bar
+  progressBar(current, total, width = 30) {
+    const ratio = Math.min(current / total, 1);
+    const filled = Math.round(width * ratio);
+    const empty = width - filled;
+    const bar = brand.blue("\u2588".repeat(filled)) + brand.gray("\u2591".repeat(empty));
+    const pct = Math.round(ratio * 100);
+    return `${bar} ${pct}%`;
+  },
+  // Phase timing display
+  phaseTimeline(phases) {
+    const parts = [];
+    for (const phase of phases) {
+      const sec = (phase.durationMs / 1e3).toFixed(1);
+      parts.push(`${phase.name} (${sec}s)`);
+    }
+    console.log(`  ${brand.dim(parts.join(" \u2192 "))}`);
+  },
+  // Deploy celebration box — enhanced with timing
+  deployBoxEnhanced(appName, url, phases, fileCount, totalBytes, totalElapsedSec, isAnonymous = false) {
+    const statsLine = `Deployed in ${totalElapsedSec.toFixed(1)}s \xB7 ${fileCount} files \xB7 ${ui.formatBytes(totalBytes)}`;
+    const content = [
+      ["\u{1F680} Shipped!", brand.green.bold("\u{1F680} Shipped!")],
+      null,
+      [`${appName} is live`, `${brand.white.bold(appName)} is live`],
+      null,
+      [`\u2192 ${url}`, `${brand.blue("\u2192")} ${brand.brightBlue.underline(url)}`],
+      null,
+      [statsLine, brand.dim(statsLine)]
+    ];
+    const maxPlain = Math.max(
+      ...content.filter((item) => item !== null).map(([p]) => visibleLen(p))
+    );
+    const innerWidth = maxPlain + 6;
+    console.log("");
+    console.log(`  ${brand.blue("\u256D" + "\u2500".repeat(innerWidth) + "\u256E")}`);
+    console.log(`  ${brand.blue("\u2502")}${" ".repeat(innerWidth)}${brand.blue("\u2502")}`);
+    for (const item of content) {
+      if (!item) {
+        console.log(`  ${brand.blue("\u2502")}${" ".repeat(innerWidth)}${brand.blue("\u2502")}`);
+      } else {
+        const [plain, colored] = item;
+        const rightPad = innerWidth - 3 - visibleLen(plain);
+        console.log(
+          `  ${brand.blue("\u2502")}   ${colored}${" ".repeat(Math.max(0, rightPad))}${brand.blue("\u2502")}`
+        );
+      }
+    }
+    console.log(`  ${brand.blue("\u2502")}${" ".repeat(innerWidth)}${brand.blue("\u2502")}`);
+    console.log(`  ${brand.blue("\u2570" + "\u2500".repeat(innerWidth) + "\u256F")}`);
+    if (phases.length > 0) {
+      console.log("");
+      ui.phaseTimeline(phases);
+    }
+    const copied = ui.copyToClipboard(url);
+    console.log("");
+    console.log(`  ${brand.bold("Share it:")}`);
+    const tweetText = encodeURIComponent(`I just shipped ${appName} live in ${totalElapsedSec.toFixed(0)}s with @shipem_dev
+
+${url}`);
+    console.log(`    ${brand.gray("Twitter")}  \u2192 ${brand.brightBlue.underline(`https://twitter.com/intent/tweet?text=${tweetText}`)}`);
+    console.log(`    ${brand.gray("Copy URL")} \u2192 ${copied ? brand.green("Copied to clipboard!") : brand.dim(url)}`);
+    console.log("");
+    if (isAnonymous) {
+      console.log(`  ${brand.bold("Keep it:")} Run ${chalk.cyan("shipem login")} to claim this deploy`);
+      console.log(`           and get a custom domain.`);
+      console.log("");
+    }
+    console.log(`  ${brand.bold("Next steps:")}`);
+    console.log(`    ${brand.gray("Update")}   \u2192 ${chalk.cyan("npx shipem")}`);
+    console.log(`    ${brand.gray("Status")}   \u2192 ${chalk.cyan("npx shipem status")}`);
+    console.log(`    ${brand.gray("Remove")}   \u2192 ${chalk.cyan("npx shipem down")}`);
+    console.log("");
+  },
+  // Rich status display for deploy history
+  deployHistory(deploys) {
+    if (deploys.length === 0) return;
+    console.log(`  ${brand.bold("Recent deploys:")}`);
+    const show = deploys.slice(0, 5);
+    for (let i = 0; i < show.length; i++) {
+      const d = show[i];
+      const date = new Date(d.timestamp);
+      const dateStr = date.toLocaleDateString("en-US", { month: "short", day: "numeric" });
+      const timeStr = date.toLocaleTimeString("en-US", { hour: "2-digit", minute: "2-digit", hour12: false });
+      const connector = i === show.length - 1 ? "\u2514\u2500\u2500" : "\u251C\u2500\u2500";
+      console.log(
+        `  ${brand.gray(connector)} ${dateStr}, ${timeStr}  ${brand.green("\u2713")}  ${d.duration.toFixed(1)}s  ${d.files} files  ${d.size}`
+      );
+    }
+    console.log("");
+  },
   // Colorize framework name
   framework(name) {
     const colors = {
@@ -256,14 +382,28 @@ var ui = {
       remix: "#818cf8",
       nuxt: "#00DC82",
       gatsby: "#663399",
-      flask: "#22c55e",
-      fastapi: "#009688",
-      django: "#22c55e",
-      express: "#fbbf24",
       hono: "#E36002"
     };
     const color = colors[name] ?? "#3B82F6";
     return chalk.hex(color).bold(name);
+  },
+  // Framework icon
+  frameworkIcon(name) {
+    const icons = {
+      nextjs: "\u25B2",
+      "vite-react": "\u269B",
+      "vite-vue": "\u{1F7E2}",
+      "vite-svelte": "\u{1F525}",
+      astro: "\u{1F680}",
+      sveltekit: "\u{1F525}",
+      remix: "\u{1F4BF}",
+      nuxt: "\u{1F49A}",
+      gatsby: "\u{1F7E3}",
+      hono: "\u{1F525}",
+      "create-react-app": "\u269B",
+      "static-html": "\u{1F4C4}"
+    };
+    return icons[name] ?? "\u{1F4E6}";
   }
 };
 
@@ -358,6 +498,12 @@ function getNodeVersion(pkg, cwd) {
   return "20";
 }
 function scanProject(cwd = process.cwd()) {
+  const result = scanProjectInternal(cwd);
+  const monorepo = detectMonorepo(cwd);
+  if (monorepo) result.monorepo = monorepo;
+  return result;
+}
+function scanProjectInternal(cwd) {
   const files = listTopLevelFiles(cwd);
   const dirs = listTopLevelDirs(cwd);
   const allEntries = [...files, ...dirs];
@@ -534,21 +680,6 @@ function scanProject(cwd = process.cwd()) {
         files: allEntries
       };
     }
-    if (deps["express"]) {
-      return {
-        framework: "express",
-        buildCommand: pkg.scripts?.build ?? "npm run build",
-        outputDirectory: "dist",
-        installCommand: detectPackageManager(cwd),
-        serverType: "server",
-        deployTarget: "flyio",
-        nodeVersion,
-        envVars,
-        projectName,
-        confidence: 0.88,
-        files: allEntries
-      };
-    }
     if (pkg.scripts?.build) {
       return {
         framework: "unknown",
@@ -565,41 +696,9 @@ function scanProject(cwd = process.cwd()) {
       };
     }
   }
-  if (hasFile("requirements.txt") || hasFile("pyproject.toml") || hasFile("Pipfile")) {
-    const projectName = cwd.split("/").pop() ?? "my-app";
-    const envVars = detectEnvVarsFromFiles(cwd);
-    let framework = "unknown";
-    let buildCommand = "pip install -r requirements.txt";
-    const requirements = readFile(join(cwd, "requirements.txt")) ?? "";
-    const pyproject = readFile(join(cwd, "pyproject.toml")) ?? "";
-    const combined = requirements + pyproject;
-    if (combined.includes("fastapi")) {
-      framework = "fastapi";
-      buildCommand = "pip install -r requirements.txt";
-    } else if (combined.includes("flask")) {
-      framework = "flask";
-      buildCommand = "pip install -r requirements.txt";
-    } else if (combined.includes("django")) {
-      framework = "django";
-      buildCommand = "pip install -r requirements.txt && python manage.py collectstatic --noinput";
-    }
-    return {
-      framework,
-      buildCommand,
-      outputDirectory: ".",
-      installCommand: "pip install -r requirements.txt",
-      serverType: "server",
-      deployTarget: "flyio",
-      pythonVersion: detectPythonVersion(cwd),
-      envVars,
-      projectName,
-      confidence: 0.85,
-      files: allEntries
-    };
-  }
   if (hasFile("index.html")) {
     const projectName = cwd.split("/").pop() ?? "my-app";
-    return {
+    const result = {
       framework: "static-html",
       buildCommand: "",
       outputDirectory: ".",
@@ -611,6 +710,7 @@ function scanProject(cwd = process.cwd()) {
       confidence: 0.9,
       files: allEntries
     };
+    return result;
   }
   return buildUnknown(cwd, files);
 }
@@ -634,16 +734,6 @@ function detectPackageManager(cwd) {
   if (existsSync(join(cwd, "bun.lockb"))) return "bun install";
   return "npm install";
 }
-function detectPythonVersion(cwd) {
-  const pythonVersion = readFile(join(cwd, ".python-version"));
-  if (pythonVersion) return pythonVersion.trim();
-  const pyproject = readFile(join(cwd, "pyproject.toml"));
-  if (pyproject) {
-    const match = pyproject.match(/python\s*=\s*["']([^"']+)["']/);
-    if (match) return match[1].replace(/[^0-9.]/g, "");
-  }
-  return "3.11";
-}
 function mergeEnvVars(base, extra) {
   const seen = new Set(base.map((v) => v.name));
   const merged = [...base];
@@ -655,325 +745,57 @@ function mergeEnvVars(base, extra) {
   }
   return merged;
 }
-function collectFileSamples(cwd, maxFiles = 20) {
-  const samples = {};
-  const importantFiles = [
-    "package.json",
-    "tsconfig.json",
-    "vite.config.ts",
-    "vite.config.js",
-    "next.config.js",
-    "next.config.ts",
-    "astro.config.mjs",
-    "svelte.config.js",
-    "nuxt.config.ts",
-    "remix.config.js",
-    "requirements.txt",
-    "pyproject.toml",
-    "Pipfile",
-    "Dockerfile",
-    "docker-compose.yml",
-    ".env.example",
-    ".env.local.example",
-    "wrangler.toml",
-    "fly.toml"
-  ];
-  for (const file of importantFiles) {
-    const content = readFile(join(cwd, file));
-    if (content) {
-      samples[file] = content.slice(0, 2e3);
-      if (Object.keys(samples).length >= maxFiles) break;
-    }
-  }
-  const topLevel = readdirSync(cwd).slice(0, 30);
-  samples["[directory listing]"] = topLevel.join("\n");
-  return samples;
-}
-
-// src/detect/ai-detect.ts
-import Anthropic from "@anthropic-ai/sdk";
-import { z } from "zod";
-
-// src/config.ts
-import Conf from "conf";
-import { readFileSync as readFileSync2, writeFileSync, existsSync as existsSync2 } from "fs";
-import { join as join2 } from "path";
-var SHIPEM_API_URL = process.env.SHIPEM_API_URL ?? "https://api.shipem.dev";
-var globalConf = new Conf({
-  projectName: "shipem",
-  schema: {
-    cloudflare: {
-      type: "object",
-      properties: {
-        apiToken: { type: "string" },
-        accountId: { type: "string" }
-      }
-    },
-    anthropicApiKey: { type: "string" },
-    sessionToken: { type: "string" }
+function detectMonorepo(cwd) {
+  const hasFile = (name) => existsSync(join(cwd, name));
+  if (hasFile("turbo.json")) {
+    const packages = findWorkspacePackages(cwd);
+    return { type: "turbo", packages };
   }
-});
-function getCloudflareCredentials() {
-  const creds = globalConf.get("cloudflare");
-  const token = process.env.CLOUDFLARE_API_TOKEN ?? creds?.apiToken;
-  const accountId = process.env.CLOUDFLARE_ACCOUNT_ID ?? creds?.accountId;
-  if (token && accountId) {
-    return { apiToken: token, accountId };
+  if (hasFile("nx.json")) {
+    const packages = findWorkspacePackages(cwd);
+    return { type: "nx", packages };
   }
-  return null;
-}
-function getAnthropicApiKey() {
-  return process.env.ANTHROPIC_API_KEY ?? globalConf.get("anthropicApiKey") ?? null;
-}
-function getSessionToken() {
-  return globalConf.get("sessionToken") ?? null;
-}
-function setSessionToken(token) {
-  globalConf.set("sessionToken", token);
-}
-function clearSessionToken() {
-  globalConf.delete("sessionToken");
-}
-var SHIPIT_CONFIG_FILE = "shipem.json";
-function readProjectConfig(cwd = process.cwd()) {
-  const configPath = join2(cwd, SHIPIT_CONFIG_FILE);
-  if (!existsSync2(configPath)) {
-    return {};
+  if (hasFile("pnpm-workspace.yaml")) {
+    const packages = findWorkspacePackages(cwd);
+    return { type: "pnpm-workspaces", packages };
   }
   try {
-    const raw = readFileSync2(configPath, "utf-8");
-    const config = JSON.parse(raw);
-    warnIfConfigContainsSecrets(config, configPath);
-    return config;
+    const pkg = JSON.parse(readFileSync(join(cwd, "package.json"), "utf-8"));
+    if (pkg.workspaces) {
+      const packages = findWorkspacePackages(cwd);
+      if (hasFile("yarn.lock")) {
+        return { type: "yarn-workspaces", packages };
+      }
+      return { type: "npm-workspaces", packages };
+    }
   } catch {
-    return {};
-  }
-}
-function writeProjectConfig(config, cwd = process.cwd()) {
-  const configPath = join2(cwd, SHIPIT_CONFIG_FILE);
-  writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
-}
-var SECRET_KEY_PATTERN = /token|secret|key|password|credential|api_?key/i;
-function warnIfConfigContainsSecrets(config, configPath) {
-  const envVars = config.project?.envVars ?? [];
-  const populated = envVars.filter((v) => v.value && SECRET_KEY_PATTERN.test(v.name));
-  if (populated.length > 0) {
-    const names = populated.map((v) => v.name).join(", ");
-    process.stderr.write(
-      `
-[Shipem] Warning: ${configPath} contains values for sensitive env vars (${names}).
-  Ensure shipem.json is listed in .gitignore to avoid committing credentials.
-
-`
-    );
   }
+  return void 0;
 }
-
-// src/detect/ai-detect.ts
-var AIDetectionSchema = z.object({
-  framework: z.string().describe("The detected framework or stack"),
-  frameworkId: z.enum([
-    "nextjs",
-    "vite-react",
-    "vite-vue",
-    "vite-svelte",
-    "astro",
-    "sveltekit",
-    "remix",
-    "nuxt",
-    "gatsby",
-    "create-react-app",
-    "flask",
-    "fastapi",
-    "django",
-    "express",
-    "hono",
-    "static-html",
-    "unknown"
-  ]),
-  buildCommand: z.string().describe("Command to build the project"),
-  outputDirectory: z.string().describe("Directory containing built output"),
-  installCommand: z.string().describe("Command to install dependencies"),
-  serverType: z.enum(["static", "serverless", "server"]),
-  deployTarget: z.enum(["cloudflare-pages", "cloudflare-workers", "flyio"]),
-  nodeVersion: z.string().optional(),
-  pythonVersion: z.string().optional(),
-  envVars: z.array(z.object({
-    name: z.string(),
-    description: z.string(),
-    required: z.boolean(),
-    autoProvision: z.boolean().optional()
-  })),
-  notes: z.string().describe("Brief explanation of detection decisions"),
-  confidence: z.number().min(0).max(1)
-});
-async function aiDetectProject(fileSamples, heuristicResult) {
-  const apiKey = getAnthropicApiKey();
-  if (!apiKey) {
-    return null;
-  }
-  const client = new Anthropic({ apiKey });
-  const fileContent = Object.entries(fileSamples).map(([name, content]) => `### ${name}
-\`\`\`
-${content}
-\`\`\``).join("\n\n");
-  const heuristicContext = heuristicResult ? `
-Heuristic detection suggests: ${JSON.stringify(heuristicResult, null, 2)}
-` : "";
-  const prompt = `You are analyzing a software project to determine how to deploy it.
-
-${heuristicContext}
-
-Here are the key project files:
-
-${fileContent}
-
-Based on these files, determine:
-1. The exact framework/stack being used
-2. The correct build command
-3. The output directory after build
-4. Required environment variables (look carefully at the code for API keys, database URLs, etc.)
-5. Whether this is a static site, serverless, or needs a persistent server
-6. The best deploy target (cloudflare-pages for static/JAMstack, cloudflare-workers for edge/serverless, flyio for full-stack servers)
-
-Be thorough about environment variables - check imports, API clients, and configuration files for any external services being used.
-
-Call the analyze_project tool with your findings.`;
-  const toolInputSchema = {
-    type: "object",
-    properties: {
-      framework: { type: "string", description: "The detected framework or stack" },
-      frameworkId: {
-        type: "string",
-        enum: [
-          "nextjs",
-          "vite-react",
-          "vite-vue",
-          "vite-svelte",
-          "astro",
-          "sveltekit",
-          "remix",
-          "nuxt",
-          "gatsby",
-          "create-react-app",
-          "flask",
-          "fastapi",
-          "django",
-          "express",
-          "hono",
-          "static-html",
-          "unknown"
-        ]
-      },
-      buildCommand: { type: "string", description: "Command to build the project" },
-      outputDirectory: { type: "string", description: "Directory containing built output" },
-      installCommand: { type: "string", description: "Command to install dependencies" },
-      serverType: { type: "string", enum: ["static", "serverless", "server"] },
-      deployTarget: { type: "string", enum: ["cloudflare-pages", "cloudflare-workers", "flyio"] },
-      nodeVersion: { type: "string" },
-      pythonVersion: { type: "string" },
-      envVars: {
-        type: "array",
-        items: {
-          type: "object",
-          properties: {
-            name: { type: "string" },
-            description: { type: "string" },
-            required: { type: "boolean" },
-            autoProvision: { type: "boolean" }
-          },
-          required: ["name", "description", "required"]
-        }
-      },
-      notes: { type: "string", description: "Brief explanation of detection decisions" },
-      confidence: { type: "number", minimum: 0, maximum: 1 }
-    },
-    required: [
-      "framework",
-      "frameworkId",
-      "buildCommand",
-      "outputDirectory",
-      "installCommand",
-      "serverType",
-      "deployTarget",
-      "envVars",
-      "notes",
-      "confidence"
-    ]
-  };
-  try {
-    const response = await client.messages.create({
-      model: "claude-sonnet-4-20250514",
-      max_tokens: 4096,
-      tools: [
-        {
-          name: "analyze_project",
-          description: "Analyze a software project to determine its framework, build config, and deployment configuration",
-          input_schema: toolInputSchema
+function findWorkspacePackages(cwd) {
+  const packages = [];
+  const commonDirs = ["packages", "apps", "projects", "services"];
+  for (const dir of commonDirs) {
+    const dirPath = join(cwd, dir);
+    if (existsSync(dirPath)) {
+      try {
+        const entries = readdirSync(dirPath, { withFileTypes: true });
+        for (const entry of entries) {
+          if (entry.isDirectory() && existsSync(join(dirPath, entry.name, "package.json"))) {
+            packages.push(entry.name);
+          }
         }
-      ],
-      tool_choice: { type: "tool", name: "analyze_project" },
-      messages: [{ role: "user", content: prompt }]
-    });
-    let toolInput = null;
-    for (const block of response.content) {
-      if (block.type === "tool_use" && block.name === "analyze_project") {
-        toolInput = block.input;
-        break;
+      } catch {
       }
     }
-    if (!toolInput) {
-      return null;
-    }
-    const validated = AIDetectionSchema.parse(toolInput);
-    return {
-      framework: validated.frameworkId,
-      buildCommand: validated.buildCommand,
-      outputDirectory: validated.outputDirectory,
-      installCommand: validated.installCommand,
-      serverType: validated.serverType,
-      deployTarget: validated.deployTarget,
-      nodeVersion: validated.nodeVersion,
-      pythonVersion: validated.pythonVersion,
-      envVars: validated.envVars,
-      notes: validated.notes,
-      confidence: validated.confidence
-    };
-  } catch (err) {
-    return null;
-  }
-}
-function mergeDetectionResults(heuristic, aiResult) {
-  if (!aiResult || aiResult.confidence < 0.7) {
-    return heuristic;
-  }
-  const seen = new Set(heuristic.envVars.map((v) => v.name));
-  const mergedEnvVars = [...heuristic.envVars];
-  for (const v of aiResult.envVars) {
-    if (!seen.has(v.name)) {
-      seen.add(v.name);
-      mergedEnvVars.push(v);
-    }
   }
-  return {
-    framework: aiResult.framework !== "unknown" ? aiResult.framework : heuristic.framework,
-    buildCommand: aiResult.buildCommand || heuristic.buildCommand,
-    outputDirectory: aiResult.outputDirectory || heuristic.outputDirectory,
-    installCommand: aiResult.installCommand || heuristic.installCommand,
-    serverType: aiResult.serverType,
-    deployTarget: aiResult.deployTarget,
-    nodeVersion: aiResult.nodeVersion ?? heuristic.nodeVersion,
-    pythonVersion: aiResult.pythonVersion ?? heuristic.pythonVersion,
-    envVars: mergedEnvVars,
-    notes: aiResult.notes,
-    confidence: Math.max(heuristic.confidence, aiResult.confidence)
-  };
+  return packages;
 }
 
 // src/build/builder.ts
 import { execa } from "execa";
-import { existsSync as existsSync3 } from "fs";
-import { join as join3 } from "path";
+import { existsSync as existsSync2 } from "fs";
+import { join as join2 } from "path";
 import chalk2 from "chalk";
 async function buildProject(config, cwd = process.cwd()) {
   const start = Date.now();
@@ -1091,8 +913,8 @@ async function buildProject(config, cwd = process.cwd()) {
     }
     console.log("");
   }
-  const outputPath = join3(cwd, config.outputDirectory);
-  if (config.buildCommand && !existsSync3(outputPath)) {
+  const outputPath = join2(cwd, config.outputDirectory);
+  if (config.buildCommand && !existsSync2(outputPath)) {
     return {
       success: false,
       outputDirectory: config.outputDirectory,
@@ -1120,66 +942,178 @@ function parseErrorMessage(raw, outputLines) {
   return lines.slice(-5).join("\n");
 }
 
-// src/commands/login.ts
-import { createServer } from "http";
-import { randomBytes } from "crypto";
-import open from "open";
-var CALLBACK_PORT_START = 9999;
-var MAX_PORT_ATTEMPTS = 10;
-async function loginCommand(opts = {}) {
-  if (!opts.skipBanner) ui.banner();
-  ui.section("Logging in to Shipem...");
-  ui.br();
-  const cliState = randomBytes(16).toString("hex");
-  let resolveToken;
-  let rejectToken;
-  const tokenPromise = new Promise((resolve, reject) => {
-    resolveToken = resolve;
-    rejectToken = reject;
-  });
-  let hasHandled = false;
-  const server = createServer((req, res) => {
-    if (!req.url) return;
-    if (hasHandled) {
-      res.writeHead(200, { "Content-Type": "text/html" });
-      res.end('<html><body style="font-family:sans-serif;padding:40px">Login already completed. You can close this tab.</body></html>');
-      return;
-    }
-    const url = new URL(req.url, `http://127.0.0.1:${actualPort}`);
-    const token2 = url.searchParams.get("token");
-    const login = url.searchParams.get("login");
-    const returnedState = url.searchParams.get("state");
-    if (returnedState !== cliState) {
-      hasHandled = true;
-      res.writeHead(400, { "Content-Type": "text/html" });
-      res.end('<html><body style="font-family:sans-serif;padding:40px;color:red">State mismatch \u2014 possible CSRF. Please try logging in again.</body></html>');
-      rejectToken(new Error("State mismatch in OAuth callback \u2014 possible CSRF attack"));
-      return;
-    }
-    if (token2) {
-      hasHandled = true;
-      const html = `<!DOCTYPE html>
-<html>
-<head><title>Shipem \u2014 Logged in!</title>
-<style>
-  body { font-family: -apple-system, sans-serif; text-align: center; padding: 60px; background: #0f172a; color: #e2e8f0; }
-  h2 { color: #22c55e; font-size: 2rem; margin-bottom: 12px; }
-  p { color: #94a3b8; font-size: 1.1rem; }
-</style>
-</head>
-<body>
-  <h2>\u2705 Logged in${login ? ` as @${login}` : ""}!</h2>
-  <p>You can close this tab and return to your terminal.</p>
-</body>
-</html>`;
-      res.writeHead(200, { "Content-Type": "text/html" });
-      res.end(html);
-      resolveToken(token2);
-    } else {
+// src/config.ts
+import Conf from "conf";
+import { readFileSync as readFileSync2, writeFileSync, existsSync as existsSync3 } from "fs";
+import { join as join3 } from "path";
+var SHIPEM_API_URL = process.env.SHIPEM_API_URL ?? "https://api.shipem.dev";
+var globalConf = new Conf({
+  projectName: "shipem",
+  schema: {
+    cloudflare: {
+      type: "object",
+      properties: {
+        apiToken: { type: "string" },
+        accountId: { type: "string" }
+      }
+    },
+    sessionToken: { type: "string" }
+  }
+});
+function getCloudflareCredentials() {
+  const creds = globalConf.get("cloudflare");
+  const token = process.env.CLOUDFLARE_API_TOKEN ?? creds?.apiToken;
+  const accountId = process.env.CLOUDFLARE_ACCOUNT_ID ?? creds?.accountId;
+  if (token && accountId) {
+    return { apiToken: token, accountId };
+  }
+  return null;
+}
+function getSessionToken() {
+  return globalConf.get("sessionToken") ?? null;
+}
+function setSessionToken(token) {
+  globalConf.set("sessionToken", token);
+}
+function clearSessionToken() {
+  globalConf.delete("sessionToken");
+}
+var SHIPIT_CONFIG_FILE = "shipem.json";
+function readProjectConfig(cwd = process.cwd()) {
+  const configPath = join3(cwd, SHIPIT_CONFIG_FILE);
+  if (!existsSync3(configPath)) {
+    return {};
+  }
+  try {
+    const raw = readFileSync2(configPath, "utf-8");
+    const config = JSON.parse(raw);
+    warnIfConfigContainsSecrets(config, configPath);
+    return config;
+  } catch {
+    return {};
+  }
+}
+function writeProjectConfig(config, cwd = process.cwd()) {
+  const configPath = join3(cwd, SHIPIT_CONFIG_FILE);
+  writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
+var SECRET_KEY_PATTERN = /token|secret|key|password|credential|api_?key/i;
+function warnIfConfigContainsSecrets(config, configPath) {
+  const envVars = config.project?.envVars ?? [];
+  const populated = envVars.filter((v) => v.value && SECRET_KEY_PATTERN.test(v.name));
+  if (populated.length > 0) {
+    const names = populated.map((v) => v.name).join(", ");
+    process.stderr.write(
+      `
+[Shipem] Warning: ${configPath} contains values for sensitive env vars (${names}).
+  Ensure shipem.json is listed in .gitignore to avoid committing credentials.
+
+`
+    );
+  }
+}
+
+// src/commands/login.ts
+import { createServer } from "http";
+import { randomBytes } from "crypto";
+import open from "open";
+
+// src/errors.ts
+var ShipemError = class extends Error {
+  /** Machine-readable error code for programmatic consumers (--json mode). */
+  code;
+  /** Suggested exit code: 1 = user error, 2 = system/infra error. */
+  exitCode;
+  constructor(message, opts = { code: "ERR_UNKNOWN" }) {
+    super(message, { cause: opts.cause });
+    this.name = "ShipemError";
+    this.code = opts.code;
+    this.exitCode = opts.exitCode ?? 1;
+  }
+};
+var NetworkError = class extends ShipemError {
+  constructor(message, opts) {
+    super(message, { code: "ERR_NETWORK", exitCode: 2, cause: opts?.cause });
+    this.name = "NetworkError";
+  }
+};
+var AuthError = class extends ShipemError {
+  constructor(message, opts) {
+    super(message, { code: "ERR_AUTH", exitCode: 1, cause: opts?.cause });
+    this.name = "AuthError";
+  }
+};
+var DeployError = class extends ShipemError {
+  constructor(message, opts) {
+    super(message, { code: "ERR_DEPLOY", exitCode: 2, cause: opts?.cause });
+    this.name = "DeployError";
+  }
+};
+var ConfigError = class extends ShipemError {
+  constructor(message, opts) {
+    super(message, { code: "ERR_CONFIG", exitCode: 1, cause: opts?.cause });
+    this.name = "ConfigError";
+  }
+};
+
+// src/commands/login.ts
+var CALLBACK_PORT_START = 9999;
+var MAX_PORT_ATTEMPTS = 10;
+var LOGIN_TIMEOUT_MS = 5 * 60 * 1e3;
+async function loginCommand(opts = {}) {
+  if (!opts.skipBanner) ui.banner();
+  ui.section("Logging in to Shipem...");
+  ui.br();
+  const cliState = randomBytes(16).toString("hex");
+  let resolveToken;
+  let rejectToken;
+  const tokenPromise = new Promise((resolve, reject) => {
+    resolveToken = resolve;
+    rejectToken = reject;
+  });
+  let hasHandled = false;
+  const server = createServer((req, res) => {
+    if (!req.url) return;
+    if (hasHandled) {
+      res.writeHead(200, { "Content-Type": "text/html" });
+      res.end('<html><body style="font-family:sans-serif;padding:40px">Login already completed. You can close this tab.</body></html>');
+      return;
+    }
+    const url = new URL(req.url, `http://127.0.0.1:${actualPort}`);
+    const token2 = url.searchParams.get("token");
+    const login = url.searchParams.get("login");
+    const returnedState = url.searchParams.get("state");
+    if (returnedState !== cliState) {
+      hasHandled = true;
+      res.writeHead(400, { "Content-Type": "text/html" });
+      res.end('<html><body style="font-family:sans-serif;padding:40px;color:red">State mismatch \u2014 possible CSRF. Please try logging in again.</body></html>');
+      rejectToken(new AuthError("State mismatch in OAuth callback \u2014 possible CSRF attack"));
+      return;
+    }
+    if (token2) {
+      hasHandled = true;
+      const html = `<!DOCTYPE html>
+<html>
+<head><title>Shipem \u2014 Logged in!</title>
+<style>
+  body { font-family: -apple-system, sans-serif; text-align: center; padding: 60px; background: #0f172a; color: #e2e8f0; }
+  h2 { color: #22c55e; font-size: 2rem; margin-bottom: 12px; }
+  p { color: #94a3b8; font-size: 1.1rem; }
+</style>
+</head>
+<body>
+  <h2>\u2705 Logged in${login ? ` as @${login}` : ""}!</h2>
+  <p>You can close this tab and return to your terminal.</p>
+</body>
+</html>`;
+      res.writeHead(200, { "Content-Type": "text/html" });
+      res.end(html);
+      resolveToken(token2);
+    } else {
       hasHandled = true;
       res.writeHead(400, { "Content-Type": "text/html" });
       res.end('<html><body style="font-family:sans-serif;padding:40px">Authentication failed. Please try again.</body></html>');
-      rejectToken(new Error("Authentication failed \u2014 no token received"));
+      rejectToken(new AuthError("Authentication failed \u2014 no token received"));
     }
   });
   let actualPort = CALLBACK_PORT_START;
@@ -1201,7 +1135,7 @@ async function loginCommand(opts = {}) {
     }
   }
   if (!bound) {
-    throw new Error(`Could not bind to any port in range ${CALLBACK_PORT_START}\u2013${CALLBACK_PORT_START + MAX_PORT_ATTEMPTS - 1}. Please free up a port and try again.`);
+    throw new NetworkError(`Could not bind to any port in range ${CALLBACK_PORT_START}\u2013${CALLBACK_PORT_START + MAX_PORT_ATTEMPTS - 1}. Please free up a port and try again.`);
   }
   const callbackUrl = `http://localhost:${actualPort}`;
   const loginUrl = `${SHIPEM_API_URL}/auth/github?cli_callback=${encodeURIComponent(callbackUrl)}&cli_state=${cliState}`;
@@ -1210,13 +1144,12 @@ async function loginCommand(opts = {}) {
   ui.dim(loginUrl);
   ui.br();
   await open(loginUrl);
-  const timeoutMs = 5 * 60 * 1e3;
   let token;
   try {
     token = await Promise.race([
       tokenPromise,
       new Promise(
-        (_, reject) => setTimeout(() => reject(new Error("Login timed out after 5 minutes. Please try again.")), timeoutMs)
+        (_, reject) => setTimeout(() => reject(new AuthError("Login timed out after 5 minutes. Please try again.")), LOGIN_TIMEOUT_MS)
       )
     ]);
   } finally {
@@ -1228,15 +1161,339 @@ async function loginCommand(opts = {}) {
   ui.br();
 }
 
+// src/commands/fix.ts
+import { existsSync as existsSync4, readFileSync as readFileSync3, writeFileSync as writeFileSync2, readdirSync as readdirSync2 } from "fs";
+import { join as join4 } from "path";
+import { execa as execa2 } from "execa";
+function findMissingModules(errorOutput) {
+  const modules = /* @__PURE__ */ new Set();
+  const cannotFind = errorOutput.matchAll(/Cannot find module ['"]([^'"]+)['"]/g);
+  for (const m of cannotFind) {
+    modules.add(extractPkgName(m[1]));
+  }
+  const moduleNotFound = errorOutput.matchAll(/Module not found.*?['"]([^'"]+)['"]/g);
+  for (const m of moduleNotFound) {
+    modules.add(extractPkgName(m[1]));
+  }
+  const cannotFindPkg = errorOutput.matchAll(/Cannot find package ['"]([^'"]+)['"]/g);
+  for (const m of cannotFindPkg) {
+    modules.add(extractPkgName(m[1]));
+  }
+  const couldNotResolve = errorOutput.matchAll(/Could not resolve ["']([^"']+)["']/g);
+  for (const m of couldNotResolve) {
+    if (!m[1].startsWith(".") && !m[1].startsWith("/")) {
+      modules.add(extractPkgName(m[1]));
+    }
+  }
+  return [...modules].filter((m) => m && !m.startsWith(".") && !m.startsWith("/"));
+}
+function extractPkgName(importPath) {
+  if (importPath.startsWith("@")) {
+    const parts = importPath.split("/");
+    return parts.slice(0, 2).join("/");
+  }
+  return importPath.split("/")[0];
+}
+function findMissingPeerDeps(errorOutput) {
+  const peers = /* @__PURE__ */ new Set();
+  const peerMatches = errorOutput.matchAll(
+    /(?:requires|missing) (?:a )?peer (?:dependency|dep)[^"']*['"]([^'"]+)['"]/gi
+  );
+  for (const m of peerMatches) {
+    peers.add(extractPkgName(m[1]));
+  }
+  const warnMatches = errorOutput.matchAll(
+    /peerDepend[^"']*['"]([^'"]+)['"].*should be/gi
+  );
+  for (const m of warnMatches) {
+    peers.add(extractPkgName(m[1]));
+  }
+  return [...peers];
+}
+function detectTsConfigFixes(errorOutput, cwd) {
+  const tsErrors = errorOutput.match(/TS\d+/g) ?? [];
+  if (tsErrors.length === 0) return null;
+  const fixes = {};
+  const descriptions = [];
+  if (tsErrors.includes("TS7006") || tsErrors.includes("TS7005")) {
+    fixes.noImplicitAny = false;
+    descriptions.push("Disable noImplicitAny");
+  }
+  if (tsErrors.includes("TS2307")) {
+    fixes.moduleResolution = "bundler";
+    descriptions.push("Set moduleResolution to bundler");
+  }
+  if (tsErrors.includes("TS2769") || tsErrors.includes("TS2345") || tsErrors.includes("TS2322")) {
+    fixes.strict = false;
+    descriptions.push("Disable strict mode");
+  }
+  if (tsErrors.includes("TS18028") || tsErrors.includes("TS1259") || tsErrors.includes("TS1479")) {
+    fixes.esModuleInterop = true;
+    fixes.allowSyntheticDefaultImports = true;
+    descriptions.push("Enable ESM interop");
+  }
+  if (descriptions.length === 0) return null;
+  return { fixes, description: descriptions.join(", ") };
+}
+function applyTsConfigFixes(cwd, fixes) {
+  const tsconfigPath = join4(cwd, "tsconfig.json");
+  if (!existsSync4(tsconfigPath)) return false;
+  try {
+    const content = readFileSync3(tsconfigPath, "utf-8");
+    const stripped = content.replace(/\/\/[^\n]*/g, "").replace(/\/\*[\s\S]*?\*\//g, "");
+    const tsconfig = JSON.parse(stripped);
+    if (!tsconfig.compilerOptions) tsconfig.compilerOptions = {};
+    Object.assign(tsconfig.compilerOptions, fixes);
+    writeFileSync2(tsconfigPath, JSON.stringify(tsconfig, null, 2) + "\n", "utf-8");
+    return true;
+  } catch {
+    return false;
+  }
+}
+function findMissingEnvVars(cwd) {
+  const referenced = /* @__PURE__ */ new Set();
+  const patterns = [
+    /process\.env\.([A-Z_][A-Z0-9_]*)/g,
+    /import\.meta\.env\.([A-Z_][A-Z0-9_]*)/g
+  ];
+  function scanDir(dir, depth) {
+    if (depth > 4) return;
+    try {
+      const entries = readdirSync2(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (entry.name === "node_modules" || entry.name === ".git" || entry.name === "dist" || entry.name === ".next") continue;
+        const fullPath = join4(dir, entry.name);
+        if (entry.isDirectory()) {
+          scanDir(fullPath, depth + 1);
+        } else if (/\.(ts|tsx|js|jsx|mjs|mts|vue|svelte|astro)$/.test(entry.name)) {
+          try {
+            const content = readFileSync3(fullPath, "utf-8");
+            for (const pat of patterns) {
+              pat.lastIndex = 0;
+              let match;
+              while ((match = pat.exec(content)) !== null) {
+                referenced.add(match[1]);
+              }
+            }
+          } catch {
+          }
+        }
+      }
+    } catch {
+    }
+  }
+  scanDir(cwd, 0);
+  const ignoredVars = /* @__PURE__ */ new Set(["NODE_ENV", "PORT", "HOST", "CI", "HOME", "PWD", "PATH", "TERM"]);
+  const missing = [];
+  for (const v of referenced) {
+    if (ignoredVars.has(v)) continue;
+    if (!process.env[v]) missing.push(v);
+  }
+  return missing;
+}
+function generateEnvExample(cwd, vars) {
+  if (vars.length === 0) return false;
+  const envExamplePath = join4(cwd, ".env.example");
+  if (existsSync4(envExamplePath)) return false;
+  const content = vars.map((v) => `${v}=`).join("\n") + "\n";
+  writeFileSync2(envExamplePath, content, "utf-8");
+  return true;
+}
+function detectFrameworkConfigFixes(errorOutput, cwd, framework) {
+  const fixes = [];
+  if (framework === "nextjs") {
+    const nextConfigPath = existsSync4(join4(cwd, "next.config.mjs")) ? join4(cwd, "next.config.mjs") : existsSync4(join4(cwd, "next.config.js")) ? join4(cwd, "next.config.js") : null;
+    if (nextConfigPath && errorOutput.includes("output")) {
+      try {
+        const content = readFileSync3(nextConfigPath, "utf-8");
+        if (!content.includes("output")) {
+          fixes.push(`Add output: 'export' to ${nextConfigPath.split("/").pop()}`);
+        }
+      } catch {
+      }
+    }
+  }
+  if ((framework === "vite-react" || framework === "vite-vue" || framework === "vite-svelte") && errorOutput.includes("plugin")) {
+    const pkgPath = join4(cwd, "package.json");
+    try {
+      const pkg = JSON.parse(readFileSync3(pkgPath, "utf-8"));
+      const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+      if (framework === "vite-react" && !deps["@vitejs/plugin-react"]) {
+        fixes.push("Install @vitejs/plugin-react");
+      }
+      if (framework === "vite-vue" && !deps["@vitejs/plugin-vue"]) {
+        fixes.push("Install @vitejs/plugin-vue");
+      }
+    } catch {
+    }
+  }
+  return fixes;
+}
+async function runFixHeuristics(errorOutput, cwd, config) {
+  const actions = [];
+  let anyFixApplied = false;
+  const missingModules = findMissingModules(errorOutput);
+  if (missingModules.length > 0) {
+    const installCmd = config.installCommand.split(" ")[0] ?? "npm";
+    for (const mod of missingModules) {
+      const spinner = ui.spinner(`Installing missing dependency: ${mod}`);
+      try {
+        await execa2(installCmd, ["add", mod], { cwd, timeout: 6e4 });
+        spinner.succeed(`Installed ${mod}`);
+        actions.push(`Installed missing dependency: ${mod}`);
+        anyFixApplied = true;
+      } catch {
+        spinner.fail(`Failed to install ${mod}`);
+        actions.push(`Failed to install ${mod}`);
+      }
+    }
+  }
+  const missingPeers = findMissingPeerDeps(errorOutput);
+  if (missingPeers.length > 0) {
+    const installCmd = config.installCommand.split(" ")[0] ?? "npm";
+    for (const peer of missingPeers) {
+      if (missingModules.includes(peer)) continue;
+      const spinner = ui.spinner(`Installing peer dependency: ${peer}`);
+      try {
+        await execa2(installCmd, ["add", peer], { cwd, timeout: 6e4 });
+        spinner.succeed(`Installed peer dep: ${peer}`);
+        actions.push(`Installed peer dependency: ${peer}`);
+        anyFixApplied = true;
+      } catch {
+        spinner.fail(`Failed to install peer dep: ${peer}`);
+        actions.push(`Failed to install ${peer}`);
+      }
+    }
+  }
+  const tsConfigFixes = detectTsConfigFixes(errorOutput, cwd);
+  if (tsConfigFixes) {
+    const applied = applyTsConfigFixes(cwd, tsConfigFixes.fixes);
+    if (applied) {
+      actions.push(`Updated tsconfig.json: ${tsConfigFixes.description}`);
+      anyFixApplied = true;
+    }
+  }
+  const missingEnvVars = findMissingEnvVars(cwd);
+  if (missingEnvVars.length > 0) {
+    const generated = generateEnvExample(cwd, missingEnvVars);
+    if (generated) {
+      actions.push(`Generated .env.example with ${missingEnvVars.length} vars: ${missingEnvVars.join(", ")}`);
+      anyFixApplied = true;
+    }
+  }
+  const frameworkFixes = detectFrameworkConfigFixes(errorOutput, cwd, config.framework);
+  for (const fix of frameworkFixes) {
+    actions.push(`Suggestion: ${fix}`);
+  }
+  return { actions, fixed: anyFixApplied };
+}
+async function fixCommand(options = {}) {
+  const cwd = process.cwd();
+  ui.section("Shipem Fix \u2014 Auto-repair build issues");
+  ui.br();
+  const scanSpinner = ui.spinner("Scanning project...");
+  const detection = scanProject(cwd);
+  scanSpinner.succeed(`Detected: ${ui.framework(detection.framework)}`);
+  if (!detection.buildCommand) {
+    ui.warn("No build command detected. Nothing to fix.");
+    return;
+  }
+  const projectConfig = {
+    name: detection.projectName,
+    framework: detection.framework,
+    buildCommand: detection.buildCommand,
+    outputDirectory: detection.outputDirectory,
+    installCommand: detection.installCommand,
+    serverType: detection.serverType,
+    nodeVersion: detection.nodeVersion,
+    envVars: detection.envVars,
+    deployTarget: detection.deployTarget,
+    detectedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  ui.br();
+  ui.section("Running build...");
+  ui.br();
+  let buildResult = await buildProject(projectConfig, cwd);
+  if (buildResult.success) {
+    ui.br();
+    ui.success("Build already passes! No fixes needed.");
+    ui.br();
+    return;
+  }
+  ui.br();
+  ui.section("Analyzing build errors...");
+  ui.br();
+  const errorOutput = buildResult.error ?? "";
+  const { actions, fixed } = await runFixHeuristics(errorOutput, cwd, projectConfig);
+  ui.br();
+  if (actions.length > 0) {
+    ui.section("Actions taken:");
+    for (const action of actions) {
+      ui.info(action);
+    }
+    ui.br();
+  }
+  if (!fixed) {
+    ui.warn("Could not automatically fix the build errors.");
+    ui.br();
+    ui.dim("Suggestions:");
+    ui.dim("  1. Paste the error into your AI coding tool for a fix");
+    ui.dim("  2. Check the error output above for clues");
+    ui.dim("  3. Run `npx shipem --verbose` for detailed output");
+    ui.br();
+    return;
+  }
+  ui.section("Re-running build after fixes...");
+  ui.br();
+  buildResult = await buildProject(projectConfig, cwd);
+  if (buildResult.success) {
+    ui.br();
+    ui.success("Fixed! Build passes now.");
+    ui.dim("Run `npx shipem` to deploy.");
+    ui.br();
+  } else {
+    ui.br();
+    ui.warn("Build still failing after fixes.");
+    ui.br();
+    ui.dim("What was tried:");
+    for (const action of actions) {
+      ui.dim(`  - ${action}`);
+    }
+    ui.br();
+    ui.dim("Tip: Paste the error into your AI coding tool \u2014 it can usually fix it.");
+    ui.br();
+  }
+}
+async function tryInlineFix(errorOutput, cwd, config) {
+  ui.br();
+  ui.section("Attempting auto-fix...");
+  ui.br();
+  const { actions, fixed } = await runFixHeuristics(errorOutput, cwd, config);
+  if (actions.length > 0) {
+    for (const action of actions) {
+      ui.info(action);
+    }
+    ui.br();
+  }
+  if (!fixed) {
+    ui.warn("Could not automatically fix the issue.");
+    return null;
+  }
+  ui.section("Re-building after fix...");
+  ui.br();
+  const buildResult = await buildProject(config, cwd);
+  return buildResult;
+}
+
 // src/deploy/cloudflare.ts
 import axios from "axios";
 import { createHash } from "crypto";
-import { readdirSync as readdirSync2, statSync as statSync2, readFileSync as readFileSync4 } from "fs";
-import { join as join5, relative } from "path";
+import { readdirSync as readdirSync3, statSync as statSync2, readFileSync as readFileSync5 } from "fs";
+import { join as join6, relative } from "path";
 
 // src/deploy/exclude.ts
-import { existsSync as existsSync4, readFileSync as readFileSync3 } from "fs";
-import { join as join4 } from "path";
+import { existsSync as existsSync5, readFileSync as readFileSync4 } from "fs";
+import { join as join5 } from "path";
 import chalk3 from "chalk";
 var DEFAULT_PATTERNS = [
   ".git",
@@ -1288,9 +1545,9 @@ function matchesIgnoreLine(relPath, line) {
   return false;
 }
 function loadIgnoreLines(filePath) {
-  if (!existsSync4(filePath)) return [];
+  if (!existsSync5(filePath)) return [];
   try {
-    return readFileSync3(filePath, "utf-8").split("\n");
+    return readFileSync4(filePath, "utf-8").split("\n");
   } catch {
     return [];
   }
@@ -1303,11 +1560,11 @@ function shouldExclude(filePath, projectRoot) {
   }
   if (projectRoot) {
     const relPath = normalized;
-    const shipemIgnoreLines = loadIgnoreLines(join4(projectRoot, ".shipemignore"));
+    const shipemIgnoreLines = loadIgnoreLines(join5(projectRoot, ".shipemignore"));
     for (const line of shipemIgnoreLines) {
       if (matchesIgnoreLine(relPath, line)) return true;
     }
-    const gitIgnoreLines = loadIgnoreLines(join4(projectRoot, ".gitignore"));
+    const gitIgnoreLines = loadIgnoreLines(join5(projectRoot, ".gitignore"));
     for (const line of gitIgnoreLines) {
       if (matchesIgnoreLine(relPath, line)) return true;
     }
@@ -1317,7 +1574,7 @@ function shouldExclude(filePath, projectRoot) {
 function warnIfEnvFilesInOutputDir(outputDir) {
   const envFiles = [".env", ".env.local", ".env.production"];
   for (const name of envFiles) {
-    if (existsSync4(join4(outputDir, name))) {
+    if (existsSync5(join5(outputDir, name))) {
       process.stderr.write(
         chalk3.yellow(`
 \u26A0  Warning: ${name} found in output directory \u2014 it will be excluded from deployment.
@@ -1329,6 +1586,11 @@ function warnIfEnvFilesInOutputDir(outputDir) {
 
 // src/deploy/cloudflare.ts
 var CF_API_BASE = "https://api.cloudflare.com/client/v4";
+var CF_UPLOAD_ENDPOINT = "https://upload.storageapi.cloudflare.com/pages-uploads";
+var CF_PROJECT_NAME_MAX_LENGTH = 28;
+var CF_REQUEST_TIMEOUT_MS = 6e4;
+var DEPLOY_POLL_INTERVAL_MS = 3e3;
+var DEPLOY_TIMEOUT_MS = 3 * 60 * 1e3;
 var CloudflarePages = class {
   client;
   accountId;
@@ -1340,7 +1602,7 @@ var CloudflarePages = class {
         Authorization: `Bearer ${apiToken}`,
         "Content-Type": "application/json"
       },
-      timeout: 6e4
+      timeout: CF_REQUEST_TIMEOUT_MS
     });
   }
   async getOrCreateProject(projectName, config) {
@@ -1354,7 +1616,7 @@ var CloudflarePages = class {
     } catch (err) {
       const status = err.response?.status;
       if (status !== 404) {
-        throw new Error(`Failed to check project: ${extractCFError(err)}`);
+        throw new DeployError(`Failed to check project: ${extractCFError(err)}`);
       }
     }
     try {
@@ -1381,11 +1643,11 @@ var CloudflarePages = class {
         }
       );
       if (!res.data.success) {
-        throw new Error(res.data.errors[0]?.message ?? "Unknown error creating project");
+        throw new DeployError(res.data.errors[0]?.message ?? "Unknown error creating project");
       }
       return res.data.result;
     } catch (err) {
-      throw new Error(`Failed to create Pages project: ${extractCFError(err)}`);
+      throw new DeployError(`Failed to create Pages project: ${extractCFError(err)}`, { cause: err });
     }
   }
   async setEnvironmentVariables(projectName, envVars) {
@@ -1410,16 +1672,16 @@ var CloudflarePages = class {
         }
       );
     } catch (err) {
-      throw new Error(`Failed to set environment variables: ${extractCFError(err)}`);
+      throw new DeployError(`Failed to set environment variables: ${extractCFError(err)}`, { cause: err });
     }
   }
   async deployDirectory(projectName, outputDir, cwd = process.cwd()) {
-    const fullOutputPath = join5(cwd, outputDir);
+    const fullOutputPath = join6(cwd, outputDir);
     const filePaths = collectFiles(fullOutputPath);
     let totalBytes = 0;
     const fileMap = /* @__PURE__ */ new Map();
     for (const filePath of filePaths) {
-      const content = readFileSync4(filePath);
+      const content = readFileSync5(filePath);
       const hash = createHash("sha256").update(content).digest("hex");
       const urlPath = "/" + relative(fullOutputPath, filePath).replace(/\\/g, "/");
       fileMap.set(urlPath, { hash, content });
@@ -1442,11 +1704,11 @@ var CloudflarePages = class {
       const res = await this.client.post(
         `/accounts/${this.accountId}/pages/projects/${projectName}/deployments`,
         { files: manifest, branch: "main" },
-        { timeout: 6e4 }
+        { timeout: CF_REQUEST_TIMEOUT_MS }
       );
       if (!res.data.success) {
         deploySpinner.fail("Deployment creation failed");
-        throw new Error(res.data.errors[0]?.message ?? "Deployment failed");
+        throw new DeployError(res.data.errors[0]?.message ?? "Deployment failed");
       }
       jwt = res.data.result.jwt;
       requiredFiles = res.data.result.required_files ?? [];
@@ -1454,7 +1716,7 @@ var CloudflarePages = class {
       deploySpinner.succeed("Deployment created");
     } catch (err) {
       deploySpinner.fail("Deployment creation failed");
-      throw new Error(`Deployment failed: ${extractCFError(err)}`);
+      throw new DeployError(`Deployment failed: ${extractCFError(err)}`, { cause: err });
     }
     if (requiredFiles.length > 0) {
       const uploadSpinner = ui.spinner(
@@ -1467,19 +1729,19 @@ var CloudflarePages = class {
         try {
           const formData = new FormData();
           formData.append(hash, new Blob([content], { type: "application/octet-stream" }), hash);
-          await fetch("https://upload.storageapi.cloudflare.com/pages-uploads", {
+          await fetch(CF_UPLOAD_ENDPOINT, {
             method: "POST",
             headers: { Authorization: `Bearer ${jwt}` },
             body: formData
           }).then(async (res) => {
             if (!res.ok) {
               const text = await res.text().catch(() => res.statusText);
-              throw new Error(`Upload failed (${res.status}): ${text}`);
+              throw new DeployError(`Upload failed (${res.status}): ${text}`);
             }
           });
         } catch (err) {
           uploadSpinner.fail("Upload failed");
-          throw new Error(`Failed to upload file (hash ${hash}): ${err instanceof Error ? err.message : String(err)}`);
+          throw new DeployError(`Failed to upload file (hash ${hash}): ${err instanceof Error ? err.message : String(err)}`, { cause: err });
         }
         uploaded++;
         uploadSpinner.text = `Uploading files... ${uploaded}/${requiredFiles.length}`;
@@ -1489,37 +1751,113 @@ var CloudflarePages = class {
     ui.success("Live!");
     return { deployment, fileCount, totalBytes };
   }
-  async waitForDeployment(projectName, deploymentId, timeoutMs = 3 * 60 * 1e3) {
-    const deploySpinner = ui.spinner("Deploying to Cloudflare Pages");
-    const start = Date.now();
-    while (Date.now() - start < timeoutMs) {
-      await sleep(3e3);
-      try {
-        const res = await this.client.get(
-          `/accounts/${this.accountId}/pages/projects/${projectName}/deployments/${deploymentId}`
-        );
-        if (!res.data.success) continue;
-        const deployment = res.data.result;
-        const stage = deployment.latest_stage;
-        deploySpinner.text = `Deploying... (${stage?.name ?? "initializing"})`;
+  async deployBranch(projectName, outputDir, branch, cwd = process.cwd()) {
+    const fullOutputPath = join6(cwd, outputDir);
+    const filePaths = collectFiles(fullOutputPath);
+    let totalBytes = 0;
+    const fileMap = /* @__PURE__ */ new Map();
+    for (const filePath of filePaths) {
+      const content = readFileSync5(filePath);
+      const hash = createHash("sha256").update(content).digest("hex");
+      const urlPath = "/" + relative(fullOutputPath, filePath).replace(/\\/g, "/");
+      fileMap.set(urlPath, { hash, content });
+      totalBytes += content.length;
+    }
+    const hashToContent = /* @__PURE__ */ new Map();
+    for (const { hash, content } of fileMap.values()) {
+      if (!hashToContent.has(hash)) hashToContent.set(hash, content);
+    }
+    const fileCount = filePaths.length;
+    const manifest = {};
+    for (const [urlPath, { hash }] of fileMap) {
+      manifest[urlPath] = hash;
+    }
+    const deploySpinner = ui.spinner(`Creating preview deployment (branch: ${branch})...`);
+    let jwt;
+    let requiredFiles;
+    let deployment;
+    try {
+      const res = await this.client.post(
+        `/accounts/${this.accountId}/pages/projects/${projectName}/deployments`,
+        { files: manifest, branch },
+        { timeout: CF_REQUEST_TIMEOUT_MS }
+      );
+      if (!res.data.success) {
+        deploySpinner.fail("Preview deployment creation failed");
+        throw new DeployError(res.data.errors[0]?.message ?? "Preview deployment failed");
+      }
+      jwt = res.data.result.jwt;
+      requiredFiles = res.data.result.required_files ?? [];
+      deployment = res.data.result;
+      deploySpinner.succeed("Preview deployment created");
+    } catch (err) {
+      deploySpinner.fail("Preview deployment creation failed");
+      throw new DeployError(`Preview deployment failed: ${extractCFError(err)}`, { cause: err });
+    }
+    if (requiredFiles.length > 0) {
+      const uploadSpinner = ui.spinner(
+        `Uploading ${requiredFiles.length} files (${ui.formatBytes(totalBytes)})`
+      );
+      let uploaded = 0;
+      for (const hash of requiredFiles) {
+        const content = hashToContent.get(hash);
+        if (!content) continue;
+        try {
+          const formData = new FormData();
+          formData.append(hash, new Blob([content], { type: "application/octet-stream" }), hash);
+          await fetch(CF_UPLOAD_ENDPOINT, {
+            method: "POST",
+            headers: { Authorization: `Bearer ${jwt}` },
+            body: formData
+          }).then(async (res) => {
+            if (!res.ok) {
+              const text = await res.text().catch(() => res.statusText);
+              throw new DeployError(`Upload failed (${res.status}): ${text}`);
+            }
+          });
+        } catch (err) {
+          uploadSpinner.fail("Upload failed");
+          throw new DeployError(`Failed to upload file (hash ${hash}): ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+        }
+        uploaded++;
+        uploadSpinner.text = `Uploading files... ${uploaded}/${requiredFiles.length}`;
+      }
+      uploadSpinner.succeed(`Upload complete \u2014 ${fileCount} files (${ui.formatBytes(totalBytes)})`);
+    }
+    ui.success("Preview deployed!");
+    return { deployment, fileCount, totalBytes };
+  }
+  async waitForDeployment(projectName, deploymentId, timeoutMs = DEPLOY_TIMEOUT_MS) {
+    const deploySpinner = ui.spinner("Deploying to Cloudflare Pages");
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+      await sleep(DEPLOY_POLL_INTERVAL_MS);
+      try {
+        const res = await this.client.get(
+          `/accounts/${this.accountId}/pages/projects/${projectName}/deployments/${deploymentId}`
+        );
+        if (!res.data.success) continue;
+        const deployment = res.data.result;
+        const stage = deployment.latest_stage;
+        deploySpinner.text = `Deploying... (${stage?.name ?? "initializing"})`;
         if (stage?.status === "success") {
           deploySpinner.succeed("Deployed successfully");
           return deployment;
         }
         if (stage?.status === "failure") {
           deploySpinner.fail("Deployment failed");
-          throw new Error(
+          throw new DeployError(
             `Deployment failed at stage '${stage.name}'. Check the Cloudflare Pages dashboard for details.`
           );
         }
       } catch (err) {
-        if (err instanceof Error && err.message.includes("Deployment failed")) {
+        if (err instanceof DeployError) {
           throw err;
         }
       }
     }
     deploySpinner.fail("Deployment timed out");
-    throw new Error("Deployment timed out. Check the Cloudflare Pages dashboard for status.");
+    throw new DeployError("Deployment timed out. Check the Cloudflare Pages dashboard for status.");
   }
   async getDeploymentStatus(projectName, deploymentId) {
     try {
@@ -1548,7 +1886,7 @@ var CloudflarePages = class {
         `/accounts/${this.accountId}/pages/projects/${projectName}`
       );
     } catch (err) {
-      throw new Error(`Failed to delete project: ${extractCFError(err)}`);
+      throw new DeployError(`Failed to delete project: ${extractCFError(err)}`, { cause: err });
     }
   }
   getProjectUrl(projectName) {
@@ -1572,9 +1910,9 @@ var CloudflarePages = class {
 function collectFiles(dir) {
   const results = [];
   function walk(currentDir) {
-    const entries = readdirSync2(currentDir);
+    const entries = readdirSync3(currentDir);
     for (const entry of entries) {
-      const fullPath = join5(currentDir, entry);
+      const fullPath = join6(currentDir, entry);
       if (shouldExclude(fullPath)) continue;
       if (entry.startsWith(".") && entry !== ".well-known") continue;
       const stat = statSync2(fullPath);
@@ -1601,7 +1939,35 @@ function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 function sanitizeProjectName(name) {
-  return name.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 28);
+  return name.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, CF_PROJECT_NAME_MAX_LENGTH);
+}
+
+// src/deploy/badge.ts
+import { readdirSync as readdirSync4, readFileSync as readFileSync6, writeFileSync as writeFileSync3 } from "fs";
+import { join as join7 } from "path";
+var BADGE_HTML = `<!-- Shipped with Shipem -->
+<div id="shipem-badge" style="position:fixed;bottom:12px;right:12px;z-index:9999;font-family:-apple-system,BlinkMacSystemFont,sans-serif;font-size:12px;background:rgba(13,17,23,0.9);color:#94A3B8;padding:6px 12px;border-radius:20px;border:1px solid rgba(59,130,246,0.3);text-decoration:none;display:flex;align-items:center;gap:6px;backdrop-filter:blur(8px);transition:opacity 0.2s"><a href="https://shipem.dev" target="_blank" rel="noopener" style="color:#94A3B8;text-decoration:none;display:flex;align-items:center;gap:6px">Shipped with <span style="color:#3B82F6">\u26A1</span> Shipem</a></div>`;
+function injectBadge(outputDir) {
+  let injected = 0;
+  try {
+    const files = readdirSync4(outputDir).filter((f) => f.endsWith(".html"));
+    for (const file of files) {
+      const filePath = join7(outputDir, file);
+      const content = readFileSync6(filePath, "utf-8");
+      if (content.includes("shipem-badge")) continue;
+      if (content.includes("</body>")) {
+        writeFileSync3(filePath, content.replace("</body>", `${BADGE_HTML}
+</body>`), "utf-8");
+        injected++;
+      } else if (content.includes("</html>")) {
+        writeFileSync3(filePath, content.replace("</html>", `${BADGE_HTML}
+</html>`), "utf-8");
+        injected++;
+      }
+    }
+  } catch {
+  }
+  return injected;
 }
 
 // src/commands/deploy.ts
@@ -1619,6 +1985,10 @@ var ENV_VAR_HELP = {
   STRIPE_PUBLISHABLE_KEY: { desc: "Stripe publishable key", url: "https://dashboard.stripe.com/apikeys" },
   NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY: { desc: "Stripe publishable key (public)", url: "https://dashboard.stripe.com/apikeys" }
 };
+var SOURCE_FILE_SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", ".git", ".next", "dist", "build", "out", ".turbo", "coverage"]);
+var DEPLOY_TIMEOUT_MS2 = 5 * 60 * 1e3;
+var LOW_CONFIDENCE_THRESHOLD = 0.7;
+var NOT_A_PROJECT_THRESHOLD = 0.4;
 async function apiRequest(config) {
   try {
     return await axios2(config);
@@ -1626,26 +1996,25 @@ async function apiRequest(config) {
     if (axios2.isAxiosError(err)) {
       const code = err.code;
       if (code === "ECONNREFUSED" || code === "ENOTFOUND" || code === "ETIMEDOUT") {
-        throw new Error("Cannot reach Shipem servers. Check your internet connection and try again.");
+        throw new NetworkError("Cannot reach Shipem servers. Check your internet connection and try again.", { cause: err });
       }
       const status = err.response?.status;
       if (status === 401) throw err;
-      if (status === 500) throw new Error("Shipem servers are having issues. Try again in a moment.");
-      if (status === 429) throw new Error("Too many requests. Please wait before deploying again.");
-      if (status === 413) throw new Error("Project is too large to deploy (max 100 MB).");
+      if (status === 500) throw new DeployError("Shipem servers are having issues. Try again in a moment.", { cause: err });
+      if (status === 429) throw new DeployError("Too many requests. Please wait before deploying again.", { cause: err });
+      if (status === 413) throw new DeployError("Project is too large to deploy (max 100 MB).", { cause: err });
     }
     throw err;
   }
 }
 function countSourceFiles(dir) {
-  const SKIP = /* @__PURE__ */ new Set(["node_modules", ".git", ".next", "dist", "build", "out", ".turbo", "coverage"]);
   let count = 0;
   function walk(d) {
     try {
-      const entries = readdirSync3(d, { withFileTypes: true });
+      const entries = readdirSync5(d, { withFileTypes: true });
       for (const entry of entries) {
-        if (SKIP.has(entry.name) || entry.name.startsWith(".")) continue;
-        if (entry.isDirectory()) walk(join6(d, entry.name));
+        if (SOURCE_FILE_SKIP_DIRS.has(entry.name) || entry.name.startsWith(".")) continue;
+        if (entry.isDirectory()) walk(join8(d, entry.name));
         else count++;
       }
     } catch {
@@ -1659,9 +2028,9 @@ function countOutputFiles(dir) {
   let totalBytes = 0;
   function walk(d) {
     try {
-      const entries = readdirSync3(d, { withFileTypes: true });
+      const entries = readdirSync5(d, { withFileTypes: true });
       for (const entry of entries) {
-        const fullPath = join6(d, entry.name);
+        const fullPath = join8(d, entry.name);
         if (entry.isDirectory()) walk(fullPath);
         else {
           fileCount++;
@@ -1677,8 +2046,55 @@ function countOutputFiles(dir) {
   walk(dir);
   return { fileCount, totalBytes };
 }
+function showBuildErrorHelp(errMsg) {
+  const moduleMatch = errMsg.match(/Cannot find module ['"]([^'"]+)['"]/);
+  const missingDepMatch = errMsg.match(/Module not found.*['"]([^'"]+)['"]/);
+  const tsErrorMatch = errMsg.match(/TS\d+:/);
+  const syntaxMatch = errMsg.match(/SyntaxError/);
+  const envMatch = errMsg.match(/process\.env\.([A-Z_][A-Z0-9_]*)/);
+  if (moduleMatch || missingDepMatch) {
+    const modName = moduleMatch?.[1] ?? missingDepMatch?.[1] ?? "unknown";
+    const pkgName = modName.startsWith("@") ? modName.split("/").slice(0, 2).join("/") : modName.split("/")[0];
+    ui.friendlyError(
+      "Missing dependency",
+      `Module '${modName}' not found`,
+      `Run: npm install ${pkgName}`,
+      "AI tools sometimes reference packages that aren't installed. Install the missing package and try again."
+    );
+  } else if (tsErrorMatch) {
+    ui.friendlyError(
+      "TypeScript error",
+      errMsg.split("\n")[0] ?? errMsg,
+      "Run: npx tsc --noEmit to see all type errors",
+      "AI-generated code sometimes has type errors. Check the error above and fix the types."
+    );
+  } else if (syntaxMatch) {
+    ui.friendlyError(
+      "Syntax error in your code",
+      errMsg.split("\n")[0] ?? errMsg,
+      "Check the file mentioned above for syntax issues",
+      "AI tools occasionally generate invalid syntax. Look for missing brackets, commas, or quotes."
+    );
+  } else if (envMatch) {
+    ui.friendlyError(
+      "Missing environment variable",
+      `Your code references ${envMatch[1]} but it's not set`,
+      `Set it: export ${envMatch[1]}=your_value`,
+      "Or add it to a .env file in your project root."
+    );
+  } else {
+    ui.friendlyError(
+      "Your app failed to build",
+      errMsg.split("\n")[0] ?? errMsg,
+      "Fix the error above, then run `npx shipem` again",
+      "Tip: If your AI tool generated this code, paste the error back to it for a fix."
+    );
+  }
+}
 async function deployCommand(options) {
   const startTime = Date.now();
+  const phases = [];
+  let phaseStart = Date.now();
   const cwd = process.cwd();
   const existingConfig = readProjectConfig(cwd);
   const isRedeploy = !!existingConfig.project && !!existingConfig.deployment;
@@ -1692,27 +2108,15 @@ async function deployCommand(options) {
   } else {
     ui.banner();
   }
+  const isAnonymous = !getSessionToken() && !getCloudflareCredentials();
   if (isFirstRun) {
     console.log(`  ${chalk4.white.bold("Welcome to Shipem!")} \u2728`);
     console.log("");
-    console.log(`  ${chalk4.dim("One-time setup (takes 30 seconds):")}`);
-    console.log(`  ${chalk4.dim("1. Sign in with GitHub")}`);
-    console.log(`  ${chalk4.dim("2. We handle everything else")}`);
+    console.log(`  ${chalk4.dim("No account needed. Deploying your app now...")}`);
     console.log("");
   }
   let sessionToken = getSessionToken();
-  if (!sessionToken) {
-    await loginCommand({ skipBanner: true });
-    sessionToken = getSessionToken();
-    if (!sessionToken) {
-      ui.fatal("Login failed. Please try again with: shipem login");
-    }
-    console.log("");
-    console.log(`  ${chalk4.hex("#22C55E")("\u2713")} ${chalk4.bold("Signed in!")}`);
-    console.log("");
-    console.log(`  Now deploying your app...`);
-    console.log("");
-  }
+  phaseStart = Date.now();
   ui.section("Scanning project...");
   ui.br();
   let projectConfig;
@@ -1721,41 +2125,40 @@ async function deployCommand(options) {
     ui.success(`Using saved config: ${ui.framework(projectConfig.framework)}`);
   } else {
     const scanSpinner = ui.spinner("Scanning project files");
-    const heuristicResult = scanProject(cwd);
+    let heuristicResult = scanProject(cwd);
     scanSpinner.succeed("Project files scanned");
-    const sourceFileCount = countSourceFiles(cwd);
-    let finalDetection;
-    const anthropicKey = getAnthropicApiKey();
-    const heuristicAsAnalysis = {
-      framework: heuristicResult.framework,
-      buildCommand: heuristicResult.buildCommand,
-      outputDirectory: heuristicResult.outputDirectory,
-      installCommand: heuristicResult.installCommand,
-      serverType: heuristicResult.serverType,
-      deployTarget: heuristicResult.deployTarget,
-      nodeVersion: heuristicResult.nodeVersion,
-      pythonVersion: heuristicResult.pythonVersion,
-      envVars: heuristicResult.envVars,
-      notes: "",
-      confidence: heuristicResult.confidence
-    };
-    if (anthropicKey) {
-      const aiSpinner = ui.spinner("Analyzing with Claude AI");
-      try {
-        const fileSamples = collectFileSamples(cwd);
-        const aiResult = await aiDetectProject(fileSamples, heuristicAsAnalysis);
-        finalDetection = mergeDetectionResults(heuristicAsAnalysis, aiResult);
-        aiSpinner.succeed("AI analysis complete");
-        if (aiResult?.notes) {
-          ui.dim(aiResult.notes);
+    if (heuristicResult.monorepo && heuristicResult.monorepo.packages.length > 0) {
+      const mono = heuristicResult.monorepo;
+      ui.info(`Monorepo detected (${mono.type}) \u2014 ${mono.packages.length} packages found`);
+      ui.br();
+      let packageName = options.package;
+      if (!packageName && !options.yes) {
+        const { selected } = await inquirer.prompt([
+          {
+            type: "list",
+            name: "selected",
+            message: "Which package to deploy?",
+            choices: mono.packages.map((p) => ({ name: p, value: p }))
+          }
+        ]);
+        packageName = selected;
+      } else if (!packageName) {
+        packageName = mono.packages[0];
+      }
+      if (packageName) {
+        const commonDirs = ["packages", "apps", "projects", "services"];
+        for (const dir of commonDirs) {
+          const pkgDir = join8(cwd, dir, packageName);
+          if (existsSync6(pkgDir)) {
+            ui.info(`Deploying package: ${chalk4.cyan(packageName)} (${dir}/${packageName})`);
+            heuristicResult = scanProject(pkgDir);
+            break;
+          }
         }
-      } catch {
-        aiSpinner.warn("AI analysis failed, using heuristic detection");
-        finalDetection = heuristicAsAnalysis;
       }
-    } else {
-      finalDetection = heuristicAsAnalysis;
     }
+    const sourceFileCount = countSourceFiles(cwd);
+    const finalDetection = heuristicResult;
     const projectName = options.name ?? heuristicResult.projectName;
     ui.projectAnalysis({
       name: projectName,
@@ -1766,11 +2169,11 @@ async function deployCommand(options) {
       deployTarget: finalDetection.deployTarget,
       envVarCount: finalDetection.envVars.length
     });
-    if (finalDetection.confidence < 0.7 && !options.yes) {
+    if (finalDetection.confidence < LOW_CONFIDENCE_THRESHOLD && !options.yes) {
       ui.warn(`Low confidence detection (${Math.round(finalDetection.confidence * 100)}%). Please verify the settings.`);
       ui.br();
     }
-    if (finalDetection.confidence < 0.4 && !existsSync5(join6(cwd, "package.json")) && !existsSync5(join6(cwd, "requirements.txt")) && !existsSync5(join6(cwd, "index.html"))) {
+    if (finalDetection.confidence < NOT_A_PROJECT_THRESHOLD && !existsSync6(join8(cwd, "package.json")) && !existsSync6(join8(cwd, "requirements.txt")) && !existsSync6(join8(cwd, "index.html"))) {
       ui.friendlyError(
         "This does not look like a project",
         "No package.json, requirements.txt, or index.html found",
@@ -1858,66 +2261,80 @@ async function deployCommand(options) {
       }
     }
   }
-  if (!options.skipBuild) {
+  phases.push({ name: "Scan", durationMs: Date.now() - phaseStart });
+  if (!options.skipBuild && !options.turbo) {
+    phaseStart = Date.now();
     ui.section("Building...");
     ui.br();
     let buildResult = await buildProject(projectConfig, cwd);
     if (!buildResult.success) {
       ui.br();
       const errMsg = buildResult.error ?? "Unknown build error";
-      const moduleMatch = errMsg.match(/Cannot find module ['"]([^'"]+)['"]/);
-      if (moduleMatch) {
-        ui.friendlyError(
-          "Your app failed to build",
-          `Module '${moduleMatch[1]}' not found`,
-          'Run "npm install" in your project, then try again'
-        );
-      } else {
-        ui.friendlyError(
-          "Your app failed to build",
-          errMsg.split("\n")[0] ?? errMsg,
-          "Fix the error above, then run `npx shipem` again"
-        );
-      }
+      showBuildErrorHelp(errMsg);
       if (options.yes) {
-        process.exit(1);
-      }
-      const { action } = await inquirer.prompt([
-        {
-          type: "list",
-          name: "action",
-          message: "Build failed. What would you like to do?",
-          choices: [
-            { name: "Try again", value: "retry" },
-            { name: "Deploy without building (use existing output directory)", value: "skip" },
-            { name: "Quit", value: "quit" }
-          ]
+        const fixResult = await tryInlineFix(errMsg, cwd, projectConfig);
+        if (fixResult?.success) {
+          ui.success("Fixed! Continuing deploy...");
+          ui.br();
+        } else {
+          process.exit(1);
         }
-      ]);
-      if (action === "quit") {
-        ui.br();
-        process.exit(1);
-      }
-      if (action === "retry") {
-        ui.br();
-        ui.section("Building (retry)...");
-        ui.br();
-        buildResult = await buildProject(projectConfig, cwd);
-        if (!buildResult.success) {
+      } else {
+        const { action } = await inquirer.prompt([
+          {
+            type: "list",
+            name: "action",
+            message: "Build failed. What would you like to do?",
+            choices: [
+              { name: "Auto-fix and retry (recommended)", value: "fix" },
+              { name: "Try again without fixing", value: "retry" },
+              { name: "Deploy without building (use existing output directory)", value: "skip" },
+              { name: "Quit", value: "quit" }
+            ]
+          }
+        ]);
+        if (action === "quit") {
           ui.br();
-          ui.friendlyError(
-            "Your app failed to build again",
-            buildResult.error?.split("\n")[0] ?? "Unknown build error",
-            "Fix the error above, then run `npx shipem` again"
-          );
           process.exit(1);
         }
+        if (action === "fix") {
+          const fixResult = await tryInlineFix(errMsg, cwd, projectConfig);
+          if (fixResult?.success) {
+            ui.success("Fixed! Continuing deploy...");
+            ui.br();
+          } else {
+            ui.br();
+            ui.dim("Tip: Paste this error into your AI coding tool \u2014 it can usually fix it.");
+            process.exit(1);
+          }
+        } else if (action === "retry") {
+          ui.br();
+          ui.section("Building (retry)...");
+          ui.br();
+          buildResult = await buildProject(projectConfig, cwd);
+          if (!buildResult.success) {
+            ui.br();
+            showBuildErrorHelp(buildResult.error ?? "Unknown build error");
+            ui.dim("Tip: Paste this error into your AI coding tool \u2014 it can usually fix it.");
+            process.exit(1);
+          }
+        }
       }
       ui.br();
     } else {
       ui.br();
     }
+    phases.push({ name: "Build", durationMs: Date.now() - phaseStart });
   }
+  if (isAnonymous) {
+    const outputPath = join8(cwd, projectConfig.outputDirectory);
+    const badgeCount = injectBadge(outputPath);
+    if (badgeCount > 0) {
+      ui.dim(`Added "Shipped with Shipem" badge to ${badgeCount} HTML file${badgeCount > 1 ? "s" : ""}`);
+      ui.br();
+    }
+  }
+  phaseStart = Date.now();
   ui.section("Deploying...");
   ui.br();
   let liveUrl;
@@ -1928,12 +2345,9 @@ async function deployCommand(options) {
   const useDirectDeploy = options.direct === true || cfCreds !== null;
   if (useDirectDeploy) {
     if (!cfCreds) {
-      ui.friendlyError(
-        "Direct deploy requires Cloudflare credentials",
-        "CLOUDFLARE_API_TOKEN or CLOUDFLARE_ACCOUNT_ID is not set",
-        "Set CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID environment variables, then try again"
+      throw new ConfigError(
+        "Direct deploy requires Cloudflare credentials. Set CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID environment variables."
       );
-      process.exit(1);
     }
     ui.dim("Direct Cloudflare deployment (using your credentials)...");
     ui.br();
@@ -1951,18 +2365,13 @@ async function deployCommand(options) {
       liveUrl = finalDeployment.url || cf.getProjectUrl(cfProjectName);
       projectId = cfProjectName;
     } catch (err) {
-      const msg = err instanceof Error ? err.message : String(err);
-      ui.friendlyError(
-        "Deployment failed",
-        msg,
-        "Check your Cloudflare credentials and try again"
-      );
-      process.exit(1);
+      if (err instanceof DeployError) throw err;
+      throw new DeployError(err instanceof Error ? err.message : String(err), { cause: err });
     }
-  } else {
-    const tarPath = join6(tmpdir(), `shipem-${Date.now()}.tar.gz`);
+  } else if (sessionToken) {
+    const tarPath = join8(tmpdir(), `shipem-${Date.now()}.tar.gz`);
     try {
-      const outputPath = join6(cwd, projectConfig.outputDirectory);
+      const outputPath = join8(cwd, projectConfig.outputDirectory);
       warnIfEnvFilesInOutputDir(outputPath);
       const stats = countOutputFiles(outputPath);
       deployFileCount = stats.fileCount;
@@ -2003,7 +2412,7 @@ async function deployCommand(options) {
           Authorization: `Bearer ${sessionToken}`
         },
         maxBodyLength: Infinity,
-        timeout: 5 * 60 * 1e3,
+        timeout: DEPLOY_TIMEOUT_MS2,
         onUploadProgress: (evt) => {
           if (!activatingSpinner && evt.total && evt.loaded >= evt.total) {
             const uploadSec = ((Date.now() - uploadStart) / 1e3).toFixed(1);
@@ -2025,7 +2434,7 @@ async function deployCommand(options) {
           await loginCommand({ skipBanner: true });
           sessionToken = getSessionToken();
           if (!sessionToken) {
-            throw new Error("Login failed after session expiry. Please run: shipem login");
+            throw new AuthError("Login failed after session expiry. Please run: shipem login");
           }
           const retryForm = new FormData2();
           retryForm.append("config", JSON.stringify({
@@ -2047,7 +2456,7 @@ async function deployCommand(options) {
             response = await apiRequest(deployConfig);
           } catch (retryErr) {
             if (axios2.isAxiosError(retryErr) && retryErr.response?.status === 401) {
-              throw new Error("Authentication failed after re-login. Please run: shipem login");
+              throw new AuthError("Authentication failed after re-login. Please run: shipem login");
             }
             throw retryErr;
           }
@@ -2063,21 +2472,105 @@ async function deployCommand(options) {
       liveUrl = response.data.url;
       projectId = response.data.projectId;
     } catch (err) {
+      if (err instanceof AuthError || err instanceof NetworkError || err instanceof DeployError) {
+        throw err;
+      }
       const msg = err instanceof Error ? err.message : String(err);
-      if (msg.includes("Cannot reach")) {
-        ui.friendlyError(
-          "Cannot reach Shipem servers",
-          "Network connection failed",
-          "Check your internet and try again"
-        );
-      } else {
-        ui.friendlyError(
-          "Deployment failed",
-          msg,
-          "Check your connection and try again with: npx shipem"
-        );
+      throw new DeployError(`Deployment failed: ${msg}`, { cause: err });
+    } finally {
+      try {
+        rmSync(tarPath);
+      } catch {
       }
-      process.exit(1);
+    }
+  } else {
+    ui.br();
+    ui.warn("No Cloudflare credentials found and not logged in.");
+    ui.br();
+    console.log(`  ${chalk4.bold("To deploy, choose one option:")}`);
+    console.log("");
+    console.log(`  ${chalk4.cyan("Option 1:")} Set Cloudflare credentials (free account)`);
+    console.log(`    ${chalk4.dim("export CLOUDFLARE_API_TOKEN=your_token")}`);
+    console.log(`    ${chalk4.dim("export CLOUDFLARE_ACCOUNT_ID=your_account_id")}`);
+    console.log(`    ${chalk4.dim("Get these from: https://dash.cloudflare.com/profile/api-tokens")}`);
+    console.log("");
+    console.log(`  ${chalk4.cyan("Option 2:")} Log in to Shipem`);
+    console.log(`    ${chalk4.dim("npx shipem login")}`);
+    console.log("");
+    const { action } = await inquirer.prompt([
+      {
+        type: "list",
+        name: "action",
+        message: "What would you like to do?",
+        choices: [
+          { name: "Log in with GitHub (sets up deployment)", value: "login" },
+          { name: "Quit (I'll set up Cloudflare credentials)", value: "quit" }
+        ]
+      }
+    ]);
+    if (action === "quit") {
+      process.exit(0);
+    }
+    await loginCommand({ skipBanner: true });
+    sessionToken = getSessionToken();
+    if (!sessionToken) {
+      throw new AuthError("Login failed. Please try again with: shipem login");
+    }
+    console.log("");
+    console.log(`  ${chalk4.hex("#22C55E")("\u2713")} ${chalk4.bold("Signed in!")}`);
+    console.log("");
+    const tarPath = join8(tmpdir(), `shipem-${Date.now()}.tar.gz`);
+    try {
+      const outputPath = join8(cwd, projectConfig.outputDirectory);
+      warnIfEnvFilesInOutputDir(outputPath);
+      const stats = countOutputFiles(outputPath);
+      deployFileCount = stats.fileCount;
+      deployTotalBytes = stats.totalBytes;
+      const packagingSpinner = ui.spinner("Packaging files...");
+      await tarCreate(
+        {
+          gzip: true,
+          file: tarPath,
+          cwd: outputPath,
+          filter: (filePath) => !shouldExclude(filePath, cwd)
+        },
+        ["."]
+      );
+      packagingSpinner.succeed(
+        `Packaged ${deployFileCount} files (${ui.formatBytes(deployTotalBytes)})`
+      );
+      const uploadSpinner = ui.spinner("Uploading to cloud...");
+      const form = new FormData2();
+      form.append("config", JSON.stringify({
+        name: projectConfig.name,
+        framework: projectConfig.framework,
+        deployTarget: projectConfig.deployTarget,
+        outputDirectory: projectConfig.outputDirectory
+      }));
+      form.append("artifacts", createReadStream(tarPath), {
+        filename: "artifacts.tar.gz",
+        contentType: "application/gzip"
+      });
+      const response = await apiRequest({
+        method: "post",
+        url: `${SHIPEM_API_URL}/projects/deploy`,
+        data: form,
+        headers: {
+          ...form.getHeaders(),
+          Authorization: `Bearer ${sessionToken}`
+        },
+        maxBodyLength: Infinity,
+        timeout: DEPLOY_TIMEOUT_MS2
+      });
+      uploadSpinner.succeed("Deployed successfully");
+      liveUrl = response.data.url;
+      projectId = response.data.projectId;
+    } catch (err) {
+      if (err instanceof AuthError || err instanceof NetworkError || err instanceof DeployError) {
+        throw err;
+      }
+      const msg = err instanceof Error ? err.message : String(err);
+      throw new DeployError(`Deployment failed: ${msg}`, { cause: err });
     } finally {
       try {
         rmSync(tarPath);
@@ -2085,6 +2578,8 @@ async function deployCommand(options) {
       }
     }
   }
+  phases.push({ name: "Upload", durationMs: Date.now() - phaseStart });
+  const elapsedSec = (Date.now() - startTime) / 1e3;
   const configToSave = {
     ...projectConfig,
     envVars: projectConfig.envVars.map(({ value: _stripped, ...rest }) => rest)
@@ -2097,61 +2592,747 @@ async function deployCommand(options) {
     deployedAt: (/* @__PURE__ */ new Date()).toISOString(),
     status: "success"
   };
-  writeProjectConfig({ project: configToSave, deployment: deploymentState }, cwd);
-  const gitignorePath = join6(cwd, ".gitignore");
-  if (existsSync5(gitignorePath)) {
-    const gitignoreContent = readFileSync5(gitignorePath, "utf-8");
+  const deployRecord = {
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    url: liveUrl,
+    duration: elapsedSec,
+    files: deployFileCount,
+    size: ui.formatBytes(deployTotalBytes),
+    framework: projectConfig.framework
+  };
+  const existingHistory = existingConfig.deployments ?? [];
+  const updatedHistory = [deployRecord, ...existingHistory].slice(0, 20);
+  writeProjectConfig({
+    project: configToSave,
+    deployment: deploymentState,
+    deployments: updatedHistory
+  }, cwd);
+  const gitignorePath = join8(cwd, ".gitignore");
+  if (existsSync6(gitignorePath)) {
+    const gitignoreContent = readFileSync7(gitignorePath, "utf-8");
     const lines = gitignoreContent.split("\n").map((l) => l.trim());
     if (!lines.includes("shipem.json")) {
       appendFileSync(gitignorePath, "\n# Shipem config\nshipem.json\n");
     }
   } else {
-    writeFileSync2(gitignorePath, "# Shipem config\nshipem.json\n");
+    writeFileSync4(gitignorePath, "# Shipem config\nshipem.json\n");
   }
-  const elapsedSec = (Date.now() - startTime) / 1e3;
-  ui.deployBox(projectConfig.name, liveUrl, elapsedSec, deployFileCount, deployTotalBytes);
+  ui.deployBoxEnhanced(
+    projectConfig.name,
+    liveUrl,
+    phases,
+    deployFileCount,
+    deployTotalBytes,
+    elapsedSec,
+    isAnonymous
+  );
 }
 
-// src/commands/status.ts
-import chalk5 from "chalk";
-async function statusCommand() {
-  const cwd = process.cwd();
-  const config = readProjectConfig(cwd);
-  if (!config.deployment) {
-    ui.warn("No deployment found in this directory.");
-    ui.dim("Run `shipem` to deploy your app.");
-    process.exit(0);
+// src/commands/env.ts
+import { existsSync as existsSync7, readFileSync as readFileSync8, readdirSync as readdirSync6, writeFileSync as writeFileSync5 } from "fs";
+import { join as join9 } from "path";
+var SERVICE_LINKS = {
+  SUPABASE_URL: { name: "Supabase", url: "https://app.supabase.com/project/_/settings/api" },
+  SUPABASE_ANON_KEY: { name: "Supabase", url: "https://app.supabase.com/project/_/settings/api" },
+  NEXT_PUBLIC_SUPABASE_URL: { name: "Supabase", url: "https://app.supabase.com/project/_/settings/api" },
+  NEXT_PUBLIC_SUPABASE_ANON_KEY: { name: "Supabase", url: "https://app.supabase.com/project/_/settings/api" },
+  VITE_SUPABASE_URL: { name: "Supabase", url: "https://app.supabase.com/project/_/settings/api" },
+  VITE_SUPABASE_ANON_KEY: { name: "Supabase", url: "https://app.supabase.com/project/_/settings/api" },
+  OPENAI_API_KEY: { name: "OpenAI", url: "https://platform.openai.com/api-keys" },
+  ANTHROPIC_API_KEY: { name: "Anthropic", url: "https://console.anthropic.com/settings/keys" },
+  STRIPE_SECRET_KEY: { name: "Stripe", url: "https://dashboard.stripe.com/apikeys" },
+  STRIPE_PUBLISHABLE_KEY: { name: "Stripe", url: "https://dashboard.stripe.com/apikeys" },
+  NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY: { name: "Stripe", url: "https://dashboard.stripe.com/apikeys" },
+  FIREBASE_API_KEY: { name: "Firebase", url: "https://console.firebase.google.com/project/_/settings/general" },
+  NEXT_PUBLIC_FIREBASE_API_KEY: { name: "Firebase", url: "https://console.firebase.google.com/project/_/settings/general" },
+  FIREBASE_PROJECT_ID: { name: "Firebase", url: "https://console.firebase.google.com/project/_/settings/general" },
+  DATABASE_URL: { name: "Database", url: "" },
+  RESEND_API_KEY: { name: "Resend", url: "https://resend.com/api-keys" },
+  CLERK_SECRET_KEY: { name: "Clerk", url: "https://dashboard.clerk.com/last-active?path=api-keys" },
+  NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY: { name: "Clerk", url: "https://dashboard.clerk.com/last-active?path=api-keys" }
+};
+function scanSourceForEnvVars(cwd) {
+  const found = /* @__PURE__ */ new Set();
+  const patterns = [
+    /process\.env\.([A-Z_][A-Z0-9_]*)/g,
+    /import\.meta\.env\.([A-Z_][A-Z0-9_]*)/g,
+    /(?:NEXT_PUBLIC_|VITE_|NUXT_|GATSBY_)([A-Z0-9_]*)/g
+  ];
+  function scanDir(dir, depth) {
+    if (depth > 5) return;
+    try {
+      const entries = readdirSync6(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (["node_modules", ".git", "dist", ".next", "build", ".svelte-kit", ".output", ".turbo", "coverage"].includes(entry.name)) continue;
+        const fullPath = join9(dir, entry.name);
+        if (entry.isDirectory()) {
+          scanDir(fullPath, depth + 1);
+        } else if (/\.(ts|tsx|js|jsx|mjs|mts|vue|svelte|astro)$/.test(entry.name)) {
+          try {
+            const content = readFileSync8(fullPath, "utf-8");
+            for (const pat of patterns) {
+              pat.lastIndex = 0;
+              let match;
+              while ((match = pat.exec(content)) !== null) {
+                if (pat.source.includes("NEXT_PUBLIC_") && !match[0].includes("process.env") && !match[0].includes("import.meta.env")) {
+                  found.add(match[0]);
+                } else {
+                  found.add(match[1]);
+                }
+              }
+            }
+          } catch {
+          }
+        }
+      }
+    } catch {
+    }
   }
-  const { deployment, project } = config;
-  ui.section("Deployment Status");
-  ui.br();
-  ui.kv("App", deployment.projectName);
-  ui.kv("URL", chalk5.blue.underline(deployment.url));
-  ui.kv("Deployed", new Date(deployment.deployedAt).toLocaleString());
-  ui.kv("Target", deployment.deployTarget);
-  ui.br();
-  if ((deployment.deployTarget === "cloudflare-pages" || deployment.deployTarget === "cloudflare-workers") && deployment.cloudflareProjectName) {
-    const cfCreds = getCloudflareCredentials();
-    if (cfCreds) {
-      const spinner = ui.spinner("Fetching live status from Cloudflare");
-      const cf = new CloudflarePages(cfCreds.apiToken, cfCreds.accountId);
-      try {
-        const status = await cf.getDeploymentStatus(
-          deployment.cloudflareProjectName,
-          deployment.deploymentId
+  scanDir(cwd, 0);
+  const ignore = /* @__PURE__ */ new Set(["NODE_ENV", "PORT", "HOST", "CI", "HOME", "PWD", "PATH", "TERM", "USER", "SHELL", "LANG", "TZ"]);
+  return [...found].filter((v) => !ignore.has(v)).sort();
+}
+function readEnvFile(cwd) {
+  const vars = /* @__PURE__ */ new Set();
+  const envFiles = [".env", ".env.local", ".env.development", ".env.production"];
+  for (const file of envFiles) {
+    const content = readFile2(join9(cwd, file));
+    if (content) {
+      for (const line of content.split("\n")) {
+        const match = line.match(/^([A-Z_][A-Z0-9_]*)=/);
+        if (match) vars.add(match[1]);
+      }
+    }
+  }
+  return vars;
+}
+function readFile2(path) {
+  try {
+    return readFileSync8(path, "utf-8");
+  } catch {
+    return null;
+  }
+}
+async function envCommand() {
+  const cwd = process.cwd();
+  console.log("");
+  console.log(`  ${brand.blue.bold("\u{1F511} Environment Variable Intelligence")}`);
+  console.log("");
+  const spinner = ui.spinner("Scanning source code for environment variables...");
+  const sourceVars = scanSourceForEnvVars(cwd);
+  const envFileVars = readEnvFile(cwd);
+  spinner.succeed(`Found ${sourceVars.length} env vars referenced in code`);
+  console.log("");
+  if (sourceVars.length === 0) {
+    ui.success("No environment variables detected in source code.");
+    ui.br();
+    return;
+  }
+  const present = [];
+  const missing = [];
+  const inEnv = [];
+  for (const v of sourceVars) {
+    if (process.env[v]) {
+      inEnv.push(v);
+    } else if (envFileVars.has(v)) {
+      present.push(v);
+    } else {
+      missing.push(v);
+    }
+  }
+  if (present.length > 0) {
+    console.log(`  ${brand.green("\u2713")} ${brand.bold("Set in .env file:")}`);
+    for (const v of present) {
+      console.log(`    ${brand.green("\xB7")} ${v}`);
+    }
+    console.log("");
+  }
+  if (inEnv.length > 0) {
+    console.log(`  ${brand.green("\u2713")} ${brand.bold("Set in environment:")}`);
+    for (const v of inEnv) {
+      console.log(`    ${brand.green("\xB7")} ${v}`);
+    }
+    console.log("");
+  }
+  if (missing.length > 0) {
+    console.log(`  ${brand.yellow("\u26A0")} ${brand.bold("Missing (not set):")}`);
+    for (const v of missing) {
+      const service = SERVICE_LINKS[v];
+      if (service && service.url) {
+        console.log(`    ${brand.red("\xB7")} ${v}  ${brand.dim("\u2192")} ${brand.brightBlue.underline(service.url)}`);
+      } else {
+        console.log(`    ${brand.red("\xB7")} ${v}`);
+      }
+    }
+    console.log("");
+  }
+  const envExamplePath = join9(cwd, ".env.example");
+  if (!existsSync7(envExamplePath) && sourceVars.length > 0) {
+    const content = sourceVars.map((v) => {
+      const service = SERVICE_LINKS[v];
+      const comment = service ? ` # ${service.name}` : "";
+      return `${v}=${comment}`;
+    }).join("\n") + "\n";
+    writeFileSync5(envExamplePath, content, "utf-8");
+    ui.success("Generated .env.example from detected variables");
+    console.log("");
+  } else if (existsSync7(envExamplePath)) {
+    ui.dim(".env.example already exists");
+    console.log("");
+  }
+  const total = sourceVars.length;
+  const setCount = present.length + inEnv.length;
+  if (missing.length === 0) {
+    ui.success(`All ${total} environment variables are set.`);
+  } else {
+    ui.warn(`${missing.length} of ${total} env vars are missing. Your build may fail.`);
+    ui.dim("Set them in a .env file or export them in your shell.");
+  }
+  console.log("");
+}
+
+// src/commands/init.ts
+import inquirer2 from "inquirer";
+import { execa as execa3 } from "execa";
+import { existsSync as existsSync8, writeFileSync as writeFileSync6, mkdirSync } from "fs";
+import { join as join10 } from "path";
+import chalk6 from "chalk";
+
+// src/commands/templates.ts
+import chalk5 from "chalk";
+var TEMPLATES = [
+  {
+    name: "astro-blog",
+    description: "Astro blog with Markdown/MDX support and RSS feed",
+    framework: "astro",
+    createCmd: ["npm", "create", "astro@latest", "--", "--template", "blog"],
+    postScaffold: ["npx", "astro", "add", "mdx", "--yes"]
+  },
+  {
+    name: "nextjs-saas",
+    description: "Next.js SaaS starter with App Router, Tailwind CSS, and TypeScript",
+    framework: "nextjs",
+    createCmd: ["npx", "create-next-app@latest", "--", "--ts", "--app", "--tailwind", "--eslint", "--src-dir", "--no-import-alias"]
+  },
+  {
+    name: "vite-react",
+    description: "Vite + React + TypeScript \u2014 fast SPA starter",
+    framework: "vite-react",
+    createCmd: ["npm", "create", "vite@latest", "--", "--template", "react-ts"]
+  },
+  {
+    name: "sveltekit-app",
+    description: "SvelteKit full-stack app with TypeScript",
+    framework: "sveltekit",
+    createCmd: ["npm", "create", "svelte@latest"]
+  },
+  {
+    name: "static-portfolio",
+    description: "Minimal static HTML/CSS portfolio \u2014 no build step required",
+    framework: "static-html",
+    createCmd: []
+    // No create tool — we scaffold manually
+  }
+];
+function getTemplate(name) {
+  return TEMPLATES.find((t) => t.name.toLowerCase() === name.toLowerCase());
+}
+function getTemplateNames() {
+  return TEMPLATES.map((t) => t.name);
+}
+async function templatesCommand() {
+  ui.banner();
+  console.log(`  ${brand.bold("Available templates")}`);
+  console.log(`  ${brand.dim("Use with: shipem init --template <name>")}`);
+  console.log("");
+  const maxNameLen = Math.max(...TEMPLATES.map((t) => t.name.length));
+  for (const tpl of TEMPLATES) {
+    const padding = " ".repeat(maxNameLen - tpl.name.length);
+    console.log(
+      `  ${chalk5.cyan(tpl.name)}${padding}  ${brand.dim("\u2014")}  ${tpl.description}`
+    );
+    console.log(
+      `  ${" ".repeat(maxNameLen)}     ${brand.dim(`Framework: ${tpl.framework}`)}`
+    );
+    console.log("");
+  }
+  console.log(`  ${brand.bold("Quick start:")}`);
+  console.log(`    ${chalk5.cyan("npx shipem init --template astro-blog")}`);
+  console.log(`    ${chalk5.cyan("npx shipem init --template nextjs-saas")}`);
+  console.log("");
+}
+
+// src/commands/init.ts
+var FRAMEWORKS = [
+  {
+    name: "Astro (static sites, blogs, portfolios)",
+    value: "astro",
+    createCmd: ["npm", "create", "astro@latest", "--", "--template", "basics"],
+    keywords: ["portfolio", "blog", "personal", "marketing", "docs", "documentation", "static"]
+  },
+  {
+    name: "Next.js (full-stack React, dashboards, SaaS)",
+    value: "nextjs",
+    createCmd: ["npx", "create-next-app@latest", "--", "--ts", "--app", "--tailwind", "--eslint", "--src-dir", "--no-import-alias"],
+    keywords: ["dashboard", "saas", "app", "application", "admin", "full-stack", "fullstack", "e-commerce", "ecommerce"]
+  },
+  {
+    name: "Vite + React (SPAs, landing pages)",
+    value: "vite-react",
+    createCmd: ["npm", "create", "vite@latest", "--", "--template", "react-ts"],
+    keywords: ["landing", "page", "spa", "single", "react", "frontend", "form", "calculator"]
+  },
+  {
+    name: "Vite + Vue (SPAs with Vue)",
+    value: "vite-vue",
+    createCmd: ["npm", "create", "vite@latest", "--", "--template", "vue-ts"],
+    keywords: ["vue"]
+  },
+  {
+    name: "SvelteKit (Svelte full-stack)",
+    value: "sveltekit",
+    createCmd: ["npm", "create", "svelte@latest"],
+    keywords: ["svelte"]
+  }
+];
+function matchFramework(description) {
+  const lower = description.toLowerCase();
+  let bestScore = 0;
+  let best = FRAMEWORKS[0];
+  for (const fw of FRAMEWORKS) {
+    let score = 0;
+    for (const keyword of fw.keywords) {
+      if (lower.includes(keyword)) score += 1;
+    }
+    if (score > bestScore) {
+      bestScore = score;
+      best = fw;
+    }
+  }
+  return best;
+}
+function generateProjectName(description) {
+  return description.toLowerCase().replace(/[^a-z0-9\s]/g, "").trim().split(/\s+/).slice(0, 3).join("-").slice(0, 30) || "my-app";
+}
+async function initCommand(options = {}) {
+  ui.banner();
+  console.log(`  ${brand.bold("Create a new project")}`);
+  console.log(`  ${brand.dim("From idea to live website in 2 commands")}`);
+  console.log("");
+  if (options.template) {
+    const tpl = getTemplate(options.template);
+    if (!tpl) {
+      ui.error(`Unknown template: ${options.template}`);
+      ui.br();
+      ui.info("Available templates:");
+      for (const name of getTemplateNames()) {
+        ui.dim(`  ${name}`);
+      }
+      ui.br();
+      ui.dim("Run `shipem templates` to see descriptions.");
+      ui.br();
+      process.exit(1);
+    }
+    await scaffoldFromTemplate(tpl, options);
+    return;
+  }
+  const { description } = await inquirer2.prompt([
+    {
+      type: "input",
+      name: "description",
+      message: "What are you building? (describe in plain English)",
+      validate: (v) => v.trim().length > 0 || "Please describe your project"
+    }
+  ]);
+  const matched = matchFramework(description);
+  const projectName = generateProjectName(description);
+  console.log("");
+  ui.info(`Matched: ${ui.framework(matched.value)} \u2014 ${matched.name.split("(")[0].trim()}`);
+  if (!options.yes) {
+    const { framework } = await inquirer2.prompt([
+      {
+        type: "list",
+        name: "framework",
+        message: "Use this framework?",
+        choices: [
+          { name: `${matched.name} (recommended)`, value: matched.value },
+          ...FRAMEWORKS.filter((f) => f.value !== matched.value).map((f) => ({
+            name: f.name,
+            value: f.value
+          }))
+        ]
+      }
+    ]);
+    const selected = FRAMEWORKS.find((f) => f.value === framework) ?? matched;
+    if (selected.value !== matched.value) {
+      Object.assign(matched, selected);
+    }
+  }
+  console.log("");
+  const scaffoldSpinner = ui.spinner(`Scaffolding with ${matched.value}...`);
+  try {
+    const cmd = [...matched.createCmd];
+    if (matched.value === "astro") {
+      cmd.push(projectName);
+    } else if (matched.value === "nextjs") {
+      const dashIdx = cmd.indexOf("--");
+      cmd.splice(dashIdx, 0, projectName);
+    } else {
+      const dashIdx = cmd.indexOf("--");
+      if (dashIdx >= 0) {
+        cmd.splice(dashIdx, 0, projectName);
+      } else {
+        cmd.push(projectName);
+      }
+    }
+    await execa3(cmd[0], cmd.slice(1), {
+      cwd: process.cwd(),
+      timeout: 12e4,
+      stdio: "pipe"
+    });
+    scaffoldSpinner.succeed(`Created ${projectName}/`);
+  } catch (err) {
+    scaffoldSpinner.fail("Scaffolding failed");
+    const msg = err instanceof Error ? err.message : String(err);
+    ui.dim(msg);
+    ui.br();
+    ui.info("Creating minimal project instead...");
+    createMinimalProject(projectName, description);
+  }
+  const projectDir = join10(process.cwd(), projectName);
+  if (existsSync8(projectDir)) {
+    writeFileSync6(
+      join10(projectDir, "shipem.json"),
+      JSON.stringify({ project: { name: projectName, framework: matched.value } }, null, 2) + "\n",
+      "utf-8"
+    );
+  }
+  console.log("");
+  console.log(`  ${brand.green.bold("Ready!")} Now run:`);
+  console.log("");
+  console.log(`    ${chalk6.cyan(`cd ${projectName} && npx shipem`)}`);
+  console.log("");
+}
+async function scaffoldFromTemplate(tpl, options) {
+  let projectName;
+  if (options.yes) {
+    projectName = `my-${tpl.name}`;
+  } else {
+    const { name } = await inquirer2.prompt([
+      {
+        type: "input",
+        name: "name",
+        message: "Project name?",
+        default: `my-${tpl.name}`,
+        validate: (v) => v.trim().length > 0 || "Please enter a project name"
+      }
+    ]);
+    projectName = name.trim().toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").slice(0, 30) || `my-${tpl.name}`;
+  }
+  ui.info(`Template: ${chalk6.cyan(tpl.name)} \u2014 ${tpl.description}`);
+  ui.br();
+  if (tpl.createCmd.length === 0) {
+    const scaffoldSpinner = ui.spinner(`Creating ${projectName}/...`);
+    createStaticPortfolio(projectName);
+    scaffoldSpinner.succeed(`Created ${projectName}/`);
+  } else {
+    const scaffoldSpinner = ui.spinner(`Scaffolding ${tpl.name}...`);
+    try {
+      const cmd = [...tpl.createCmd];
+      if (tpl.framework === "astro") {
+        cmd.push(projectName);
+      } else if (tpl.framework === "nextjs") {
+        const dashIdx = cmd.indexOf("--");
+        cmd.splice(dashIdx, 0, projectName);
+      } else {
+        const dashIdx = cmd.indexOf("--");
+        if (dashIdx >= 0) {
+          cmd.splice(dashIdx, 0, projectName);
+        } else {
+          cmd.push(projectName);
+        }
+      }
+      await execa3(cmd[0], cmd.slice(1), {
+        cwd: process.cwd(),
+        timeout: 12e4,
+        stdio: "pipe"
+      });
+      scaffoldSpinner.succeed(`Created ${projectName}/`);
+      if (tpl.postScaffold && tpl.postScaffold.length > 0) {
+        const postSpinner = ui.spinner("Running post-scaffold setup...");
+        try {
+          await execa3(tpl.postScaffold[0], tpl.postScaffold.slice(1), {
+            cwd: join10(process.cwd(), projectName),
+            timeout: 12e4,
+            stdio: "pipe"
+          });
+          postSpinner.succeed("Post-scaffold setup complete");
+        } catch {
+          postSpinner.fail("Post-scaffold setup failed (non-critical)");
+        }
+      }
+    } catch (err) {
+      scaffoldSpinner.fail("Scaffolding failed");
+      const msg = err instanceof Error ? err.message : String(err);
+      ui.dim(msg);
+      ui.br();
+      ui.info("Creating minimal project instead...");
+      createMinimalProject(projectName, tpl.description);
+    }
+  }
+  const projectDir = join10(process.cwd(), projectName);
+  if (existsSync8(projectDir)) {
+    writeFileSync6(
+      join10(projectDir, "shipem.json"),
+      JSON.stringify({ project: { name: projectName, framework: tpl.framework } }, null, 2) + "\n",
+      "utf-8"
+    );
+  }
+  console.log("");
+  console.log(`  ${brand.green.bold("Ready!")} Now run:`);
+  console.log("");
+  console.log(`    ${chalk6.cyan(`cd ${projectName} && npx shipem`)}`);
+  console.log("");
+}
+function createMinimalProject(projectName, description) {
+  const dir = join10(process.cwd(), projectName);
+  if (!existsSync8(dir)) {
+    mkdirSync(dir, { recursive: true });
+    writeFileSync6(join10(dir, "index.html"), `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${description}</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body { font-family: -apple-system, BlinkMacSystemFont, sans-serif; display: flex; align-items: center; justify-content: center; min-height: 100vh; background: #0a0a0a; color: #ededed; }
+    h1 { font-size: 2.5rem; margin-bottom: 1rem; }
+    p { color: #888; }
+  </style>
+</head>
+<body>
+  <div style="text-align: center">
+    <h1>${description}</h1>
+    <p>Built with Shipem</p>
+  </div>
+</body>
+</html>`, "utf-8");
+    ui.success(`Created ${projectName}/ with minimal HTML`);
+  }
+}
+function createStaticPortfolio(projectName) {
+  const dir = join10(process.cwd(), projectName);
+  mkdirSync(dir, { recursive: true });
+  writeFileSync6(join10(dir, "index.html"), `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>My Portfolio</title>
+  <link rel="stylesheet" href="style.css">
+</head>
+<body>
+  <header>
+    <h1>Hello, I'm <span class="accent">Your Name</span></h1>
+    <p>Developer &middot; Designer &middot; Creator</p>
+  </header>
+  <main>
+    <section class="projects">
+      <h2>Projects</h2>
+      <div class="grid">
+        <div class="card">
+          <h3>Project One</h3>
+          <p>A brief description of this project.</p>
+        </div>
+        <div class="card">
+          <h3>Project Two</h3>
+          <p>A brief description of this project.</p>
+        </div>
+        <div class="card">
+          <h3>Project Three</h3>
+          <p>A brief description of this project.</p>
+        </div>
+      </div>
+    </section>
+  </main>
+  <footer>
+    <p>Shipped with Shipem</p>
+  </footer>
+</body>
+</html>`, "utf-8");
+  writeFileSync6(join10(dir, "style.css"), `* { margin: 0; padding: 0; box-sizing: border-box; }
+body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; background: #0a0a0a; color: #ededed; min-height: 100vh; }
+header { text-align: center; padding: 4rem 1rem 2rem; }
+header h1 { font-size: 2.5rem; margin-bottom: 0.5rem; }
+.accent { color: #3B82F6; }
+header p { color: #888; font-size: 1.1rem; }
+main { max-width: 900px; margin: 0 auto; padding: 2rem 1rem; }
+h2 { margin-bottom: 1.5rem; color: #ccc; }
+.grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(250px, 1fr)); gap: 1.5rem; }
+.card { background: #1a1a1a; border: 1px solid #333; border-radius: 8px; padding: 1.5rem; }
+.card h3 { margin-bottom: 0.5rem; }
+.card p { color: #888; font-size: 0.9rem; }
+footer { text-align: center; padding: 3rem 1rem; color: #555; font-size: 0.85rem; }
+`, "utf-8");
+}
+
+// src/commands/dev.ts
+import { execa as execa4 } from "execa";
+import chalk7 from "chalk";
+var DEV_COMMANDS = {
+  nextjs: ["npx", "next", "dev"],
+  astro: ["npx", "astro", "dev"],
+  sveltekit: ["npx", "vite", "dev"],
+  nuxt: ["npx", "nuxi", "dev"],
+  remix: ["npx", "remix", "dev"],
+  gatsby: ["npx", "gatsby", "develop"],
+  "vite-react": ["npx", "vite"],
+  "vite-vue": ["npx", "vite"],
+  "vite-svelte": ["npx", "vite"],
+  "create-react-app": ["npx", "react-scripts", "start"]
+};
+async function devCommand() {
+  const cwd = process.cwd();
+  ui.section("Shipem Dev");
+  ui.br();
+  const detection = scanProject(cwd);
+  const devCmd = DEV_COMMANDS[detection.framework];
+  if (!devCmd) {
+    ui.warn(`No dev server known for framework: ${detection.framework}`);
+    ui.dim("Start your dev server manually, then press [d] to deploy.");
+    ui.br();
+    return;
+  }
+  ui.success(`Detected: ${ui.framework(detection.framework)}`);
+  ui.info(`Starting: ${devCmd.join(" ")}`);
+  ui.br();
+  let devProcess = null;
+  try {
+    devProcess = execa4(devCmd[0], devCmd.slice(1), {
+      cwd,
+      stdio: ["pipe", "pipe", "pipe"],
+      env: { ...process.env, FORCE_COLOR: "1" }
+    });
+    devProcess.stdout?.on("data", (chunk) => {
+      process.stdout.write(chunk);
+    });
+    devProcess.stderr?.on("data", (chunk) => {
+      process.stderr.write(chunk);
+    });
+    console.log("");
+    console.log(`  ${brand.blue("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500")}`);
+    console.log(`  ${brand.bold("Shipem Dev")}  Press ${chalk7.cyan("[d]")} to deploy   Press ${chalk7.cyan("[q]")} to quit`);
+    console.log(`  ${brand.blue("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500")}`);
+    console.log("");
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(true);
+      process.stdin.resume();
+      process.stdin.setEncoding("utf-8");
+      process.stdin.on("data", async (key) => {
+        if (key === "d" || key === "D") {
+          console.log("");
+          ui.section("Deploying...");
+          ui.br();
+          if (devProcess) {
+            devProcess.kill("SIGTERM");
+          }
+          try {
+            await deployCommand({ yes: true, skipBuild: false });
+          } catch (err) {
+            ui.error(err instanceof Error ? err.message : "Deploy failed");
+          }
+          console.log("");
+          ui.dim("Dev server stopped after deploy. Run `shipem dev` again to restart.");
+          process.exit(0);
+        }
+        if (key === "q" || key === "Q" || key === "") {
+          console.log("");
+          ui.info("Shutting down dev server...");
+          if (devProcess) {
+            devProcess.kill("SIGTERM");
+          }
+          process.exit(0);
+        }
+      });
+    }
+    await devProcess;
+  } catch (err) {
+    if (devProcess?.killed) return;
+    const msg = err instanceof Error ? err.message : String(err);
+    if (!msg.includes("SIGTERM")) {
+      ui.error(`Dev server failed: ${msg}`);
+    }
+  }
+}
+
+// src/commands/status.ts
+import chalk8 from "chalk";
+function timeAgo2(isoStr) {
+  const diff = Date.now() - new Date(isoStr).getTime();
+  const mins = Math.floor(diff / 6e4);
+  if (mins < 1) return "just now";
+  if (mins === 1) return "1 minute ago";
+  if (mins < 60) return `${mins} minutes ago`;
+  const hrs = Math.floor(mins / 60);
+  if (hrs === 1) return "1 hour ago";
+  if (hrs < 24) return `${hrs} hours ago`;
+  const days = Math.floor(hrs / 24);
+  return days === 1 ? "yesterday" : `${days} days ago`;
+}
+async function statusCommand() {
+  const cwd = process.cwd();
+  const config = readProjectConfig(cwd);
+  if (!config.deployment) {
+    ui.warn("No deployment found in this directory.");
+    ui.dim("Run `shipem` to deploy your app.");
+    process.exit(0);
+  }
+  const { deployment } = config;
+  const project = config.project;
+  const deploys = config.deployments ?? [];
+  console.log("");
+  console.log(`  ${brand.blue.bold("\u26A1 Shipem Status")}`);
+  console.log("");
+  ui.kv("Project", chalk8.bold(deployment.projectName));
+  if (project) {
+    ui.kv("Framework", `${ui.frameworkIcon(project.framework)} ${ui.framework(project.framework)}`);
+  }
+  const ago = timeAgo2(deployment.deployedAt);
+  const lastDeploy = deploys[0];
+  if (lastDeploy) {
+    ui.kv("Last deploy", `${ago} (${lastDeploy.duration.toFixed(1)}s)`);
+  } else {
+    ui.kv("Last deploy", ago);
+  }
+  ui.kv("URL", chalk8.blue.underline(deployment.url));
+  ui.kv("Deploys", `${deploys.length} total`);
+  console.log("");
+  if (deploys.length > 0) {
+    ui.deployHistory(deploys);
+  }
+  if ((deployment.deployTarget === "cloudflare-pages" || deployment.deployTarget === "cloudflare-workers") && deployment.cloudflareProjectName) {
+    const cfCreds = getCloudflareCredentials();
+    if (cfCreds) {
+      const spinner = ui.spinner("Fetching live status from Cloudflare");
+      const cf = new CloudflarePages(cfCreds.apiToken, cfCreds.accountId);
+      try {
+        const status = await cf.getDeploymentStatus(
+          deployment.cloudflareProjectName,
+          deployment.deploymentId
         );
         if (status) {
           spinner.succeed("Status fetched");
           ui.kv("Deployment ID", status.id);
           ui.kv(
             "Status",
-            status.latest_stage?.status === "success" ? chalk5.green("\u2713 Active") : chalk5.yellow(status.latest_stage?.status ?? "unknown")
+            status.latest_stage?.status === "success" ? chalk8.green("\u2713 Active") : chalk8.yellow(status.latest_stage?.status ?? "unknown")
           );
           ui.br();
           if (status.stages && status.stages.length > 0) {
             ui.section("Build stages:");
             for (const stage of status.stages) {
-              const icon = stage.status === "success" ? chalk5.green("\u2713") : stage.status === "failure" ? chalk5.red("\u2717") : chalk5.gray("\xB7");
+              const icon = stage.status === "success" ? chalk8.green("\u2713") : stage.status === "failure" ? chalk8.red("\u2717") : chalk8.gray("\xB7");
               ui.info(`${icon} ${stage.name}`);
             }
             ui.br();
@@ -2175,7 +3356,7 @@ async function statusCommand() {
 }
 
 // src/commands/logs.ts
-import chalk6 from "chalk";
+import chalk9 from "chalk";
 async function logsCommand(options) {
   const cwd = process.cwd();
   const config = readProjectConfig(cwd);
@@ -2187,18 +3368,14 @@ async function logsCommand(options) {
   const { deployment } = config;
   if (deployment.deployTarget !== "cloudflare-pages" && deployment.deployTarget !== "cloudflare-workers") {
     ui.warn("Log streaming is only available for Cloudflare Pages deployments.");
-    ui.dim(`For Fly.io apps, run: flyctl logs --app ${deployment.projectName}`);
     process.exit(0);
   }
   if (!deployment.cloudflareProjectName) {
-    ui.fatal("Missing Cloudflare project name in deployment config.");
+    throw new ConfigError("Missing Cloudflare project name in deployment config.");
   }
   const cfCreds = getCloudflareCredentials();
   if (!cfCreds) {
-    ui.fatal(
-      "Cloudflare credentials not found.",
-      "Set CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID environment variables."
-    );
+    throw new ConfigError("Cloudflare credentials not found. Set CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID environment variables.");
   }
   ui.section("Deployment Logs");
   ui.br();
@@ -2220,11 +3397,11 @@ async function logsCommand(options) {
       const displayLogs = logs.slice(-linesToShow);
       for (const line of displayLogs) {
         if (line.includes("ERROR") || line.includes("error") || line.includes("FAIL")) {
-          console.log(chalk6.red(`  ${line}`));
+          console.log(chalk9.red(`  ${line}`));
         } else if (line.includes("WARN") || line.includes("warn")) {
-          console.log(chalk6.yellow(`  ${line}`));
+          console.log(chalk9.yellow(`  ${line}`));
         } else {
-          console.log(chalk6.gray(`  ${line}`));
+          console.log(chalk9.gray(`  ${line}`));
         }
       }
     }
@@ -2236,7 +3413,7 @@ async function logsCommand(options) {
 }
 
 // src/commands/down.ts
-import inquirer2 from "inquirer";
+import inquirer3 from "inquirer";
 import axios3 from "axios";
 async function downCommand(options) {
   const cwd = process.cwd();
@@ -2253,7 +3430,7 @@ async function downCommand(options) {
   ui.kv("URL", deployment.url);
   ui.br();
   if (!options.yes) {
-    const { confirmed } = await inquirer2.prompt([
+    const { confirmed } = await inquirer3.prompt([
       {
         type: "confirm",
         name: "confirmed",
@@ -2270,10 +3447,7 @@ async function downCommand(options) {
   if ((deployment.deployTarget === "cloudflare-pages" || deployment.deployTarget === "cloudflare-workers") && deployment.cloudflareProjectName) {
     const cfCreds = getCloudflareCredentials();
     if (!cfCreds) {
-      ui.fatal(
-        "Cloudflare credentials not found.",
-        "Set CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID environment variables."
-      );
+      throw new ConfigError("Cloudflare credentials not found. Set CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID environment variables.");
     }
     const spinner = ui.spinner(`Deleting ${deployment.projectName} from Cloudflare Pages`);
     const cf = new CloudflarePages(cfCreds.apiToken, cfCreds.accountId);
@@ -2282,13 +3456,12 @@ async function downCommand(options) {
       spinner.succeed("Deployment deleted from Cloudflare Pages");
     } catch (err) {
       spinner.fail("Failed to delete deployment");
-      ui.error(err instanceof Error ? err.message : "Unknown error");
-      process.exit(1);
+      throw err instanceof DeployError ? err : new DeployError(err instanceof Error ? err.message : "Unknown error", { cause: err });
     }
   } else if ((deployment.deployTarget === "cloudflare-pages" || deployment.deployTarget === "cloudflare-workers") && !deployment.cloudflareProjectName) {
     const token = getSessionToken();
     if (!token) {
-      ui.fatal("Not logged in. Run `shipem login` first.");
+      throw new AuthError("Not logged in. Run `shipem login` first.");
     }
     const spinner = ui.spinner(`Deleting ${deployment.projectName} from Shipem`);
     try {
@@ -2298,16 +3471,11 @@ async function downCommand(options) {
       spinner.succeed("Deployment deleted");
     } catch (err) {
       spinner.fail("Failed to delete deployment");
-      ui.error(err instanceof Error ? err.message : "Unknown error");
-      process.exit(1);
+      if (axios3.isAxiosError(err) && err.code && ["ECONNREFUSED", "ENOTFOUND", "ETIMEDOUT"].includes(err.code)) {
+        throw new NetworkError("Cannot reach Shipem servers. Check your internet connection.", { cause: err });
+      }
+      throw new DeployError(err instanceof Error ? err.message : "Unknown error", { cause: err });
     }
-  } else if (deployment.deployTarget === "flyio") {
-    ui.warn("Fly.io apps cannot be deleted automatically. Manual cleanup required:");
-    ui.info(`flyctl apps destroy ${deployment.projectName} --yes`);
-    ui.br();
-    ui.warn("Local deployment config has NOT been cleared \u2014 re-run after manual deletion.");
-    ui.br();
-    return;
   }
   writeProjectConfig({ project: config.project }, cwd);
   ui.br();
@@ -2316,8 +3484,481 @@ async function downCommand(options) {
   ui.br();
 }
 
-// src/commands/logout.ts
+// src/commands/watch.ts
+import { watch as fsWatch } from "fs";
+import { join as join11, relative as relative2 } from "path";
+import { readdirSync as readdirSync7 } from "fs";
+import chalk10 from "chalk";
+var IGNORE_PATTERNS = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  "dist",
+  "build",
+  ".shipem",
+  "shipem.json",
+  ".next",
+  ".nuxt",
+  ".output",
+  ".svelte-kit",
+  ".turbo",
+  "coverage",
+  ".DS_Store",
+  ".env",
+  ".env.local"
+]);
+var DEBOUNCE_MS = 2e3;
+function timestamp() {
+  const d = /* @__PURE__ */ new Date();
+  return d.toLocaleTimeString("en-US", { hour12: false });
+}
+function collectDirs(dir) {
+  const dirs = [dir];
+  try {
+    const entries = readdirSync7(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      if (IGNORE_PATTERNS.has(entry.name) || entry.name.startsWith(".")) continue;
+      dirs.push(...collectDirs(join11(dir, entry.name)));
+    }
+  } catch {
+  }
+  return dirs;
+}
+async function watchCommand() {
+  const cwd = process.cwd();
+  ui.banner();
+  console.log(`  ${brand.blue.bold("\u26A1")} ${brand.bold("Watching")} for changes...`);
+  console.log(`    Auto-deploy on save. Press ${chalk10.cyan("[q]")} to stop, ${chalk10.cyan("[d]")} to force deploy.`);
+  console.log("");
+  let debounceTimer = null;
+  let isDeploying = false;
+  let lastChangedFile = "";
+  const watchers = [];
+  const triggerDeploy = async (file) => {
+    if (isDeploying) return;
+    isDeploying = true;
+    console.log(`  ${brand.dim(`[${timestamp()}]`)} ${brand.blue("Deploying...")}`);
+    const startTime = Date.now();
+    try {
+      await deployCommand({ yes: true, skipBuild: false });
+      const elapsed = ((Date.now() - startTime) / 1e3).toFixed(1);
+      console.log(`  ${brand.dim(`[${timestamp()}]`)} ${brand.green("\u2713")} Deployed (${elapsed}s)`);
+    } catch (err) {
+      console.log(`  ${brand.dim(`[${timestamp()}]`)} ${brand.red("\u2717")} Deploy failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    isDeploying = false;
+    console.log("");
+    console.log(`  Watching for changes... Press ${chalk10.cyan("[q]")} to stop.`);
+    console.log("");
+  };
+  const onFileChange = (dir, filename) => {
+    if (!filename) return;
+    if (IGNORE_PATTERNS.has(filename)) return;
+    if (isDeploying) return;
+    const relPath = relative2(cwd, join11(dir, filename));
+    lastChangedFile = relPath;
+    console.log(`  ${brand.dim(`[${timestamp()}]`)} File changed: ${chalk10.cyan(relPath)}`);
+    if (debounceTimer) clearTimeout(debounceTimer);
+    debounceTimer = setTimeout(() => {
+      void triggerDeploy(lastChangedFile);
+    }, DEBOUNCE_MS);
+  };
+  const dirs = collectDirs(cwd);
+  for (const dir of dirs) {
+    try {
+      const watcher = fsWatch(dir, { persistent: true }, (_event, filename) => {
+        onFileChange(dir, filename);
+      });
+      watchers.push(watcher);
+    } catch {
+    }
+  }
+  if (process.stdin.isTTY) {
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.setEncoding("utf-8");
+    process.stdin.on("data", (key) => {
+      if (key === "q" || key === "Q" || key === "") {
+        console.log("");
+        ui.info("Stopped watching.");
+        for (const w of watchers) w.close();
+        if (debounceTimer) clearTimeout(debounceTimer);
+        process.exit(0);
+      }
+      if (key === "d" || key === "D") {
+        if (debounceTimer) clearTimeout(debounceTimer);
+        console.log(`  ${brand.dim(`[${timestamp()}]`)} Force deploy triggered`);
+        void triggerDeploy("manual");
+      }
+    });
+  }
+  await new Promise(() => {
+  });
+}
+
+// src/commands/history.ts
+import chalk11 from "chalk";
+
+// src/memory/index.ts
+import { readFileSync as readFileSync9, writeFileSync as writeFileSync7, mkdirSync as mkdirSync2, existsSync as existsSync9 } from "fs";
+import { join as join12 } from "path";
+import { homedir } from "os";
+var SHIPEM_HOME = join12(homedir(), ".shipem");
+var MEMORY_PATH = join12(SHIPEM_HOME, "memory.json");
+var PROJECTS_PATH = join12(SHIPEM_HOME, "projects.json");
+var FIXES_PATH = join12(SHIPEM_HOME, "fixes.json");
+var CONFIG_PATH = join12(SHIPEM_HOME, "config.json");
+function ensureDir() {
+  if (!existsSync9(SHIPEM_HOME)) {
+    mkdirSync2(SHIPEM_HOME, { recursive: true });
+  }
+}
+function readJson2(path, fallback) {
+  try {
+    if (!existsSync9(path)) return fallback;
+    return JSON.parse(readFileSync9(path, "utf-8"));
+  } catch {
+    return fallback;
+  }
+}
+function writeJson(path, data) {
+  ensureDir();
+  writeFileSync7(path, JSON.stringify(data, null, 2) + "\n", "utf-8");
+}
+function getMemory() {
+  return readJson2(MEMORY_PATH, {
+    totalDeploys: 0,
+    totalFixes: 0,
+    firstUsed: (/* @__PURE__ */ new Date()).toISOString()
+  });
+}
+function getProjects() {
+  return readJson2(PROJECTS_PATH, []);
+}
+function getGlobalConfig() {
+  return readJson2(CONFIG_PATH, {});
+}
+function setWebhook(url) {
+  const config = getGlobalConfig();
+  if (url) {
+    config.notifications = { ...config.notifications, webhook: url };
+  } else {
+    if (config.notifications) delete config.notifications.webhook;
+  }
+  writeJson(CONFIG_PATH, config);
+}
+function getWebhook() {
+  return getGlobalConfig().notifications?.webhook;
+}
+
+// src/commands/history.ts
+async function historyCommand() {
+  const projects = getProjects();
+  const memory = getMemory();
+  ui.section("Shipem History \u2014 All Projects");
+  ui.br();
+  if (projects.length === 0) {
+    ui.dim("No projects deployed yet. Run `shipem deploy` to get started.");
+    ui.br();
+    return;
+  }
+  console.log(`  ${brand.dim("Total deploys:")} ${chalk11.cyan(String(memory.totalDeploys))}  ${brand.dim("Total fixes:")} ${chalk11.cyan(String(memory.totalFixes))}  ${brand.dim("Since:")} ${chalk11.cyan(new Date(memory.firstUsed).toLocaleDateString())}`);
+  ui.br();
+  for (const project of projects) {
+    const avgTime = project.deployCount > 0 ? (project.totalDeployTime / project.deployCount).toFixed(1) : "0.0";
+    const lastDeploy = new Date(project.lastDeploy);
+    const dateStr = lastDeploy.toLocaleDateString("en-US", { month: "short", day: "numeric" });
+    const timeStr = lastDeploy.toLocaleTimeString("en-US", { hour: "2-digit", minute: "2-digit", hour12: false });
+    console.log(`  ${brand.bold(project.name)} ${brand.dim(`(${project.framework})`)}`);
+    console.log(`    ${brand.dim("URL:")} ${brand.brightBlue.underline(project.url)}`);
+    console.log(`    ${brand.dim("Deploys:")} ${chalk11.cyan(String(project.deployCount))}  ${brand.dim("Avg:")} ${chalk11.cyan(avgTime + "s")}  ${brand.dim("Last:")} ${dateStr} ${timeStr}`);
+    console.log(`    ${brand.dim("Path:")} ${project.path}`);
+    ui.br();
+  }
+}
+
+// src/commands/config.ts
+async function configCommand(action, key, value) {
+  if (!action || action === "show") {
+    const config = getGlobalConfig();
+    ui.section("Shipem Global Config");
+    ui.br();
+    ui.kv("Webhook", config.notifications?.webhook ?? "(not set)");
+    ui.br();
+    return;
+  }
+  if (action === "set") {
+    if (!key) {
+      ui.error("Usage: shipem config set <key> <value>");
+      ui.dim("Available keys: webhook");
+      ui.br();
+      return;
+    }
+    if (key === "webhook") {
+      if (!value || value === "off") {
+        setWebhook(null);
+        ui.success("Webhook notifications disabled.");
+      } else {
+        setWebhook(value);
+        ui.success(`Webhook set to: ${value}`);
+      }
+      ui.br();
+      return;
+    }
+    ui.error(`Unknown config key: ${key}`);
+    ui.dim("Available keys: webhook");
+    ui.br();
+    return;
+  }
+  ui.error(`Unknown action: ${action}`);
+  ui.dim("Usage: shipem config [show|set] [key] [value]");
+  ui.br();
+}
+
+// src/commands/monitor.ts
+import axios5 from "axios";
+import chalk12 from "chalk";
+import { writeFileSync as writeFileSync8, readFileSync as readFileSync10, existsSync as existsSync10, unlinkSync } from "fs";
+import { join as join13 } from "path";
+import { tmpdir as tmpdir2 } from "os";
+
+// src/notifications/index.ts
 import axios4 from "axios";
+async function sendStatusNotification(message, webhookOverride) {
+  const webhook = webhookOverride ?? getWebhook();
+  if (!webhook) return false;
+  try {
+    await axios4.post(webhook, { text: message }, { timeout: 5e3 });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// src/commands/monitor.ts
+var PID_FILE = join13(tmpdir2(), "shipem-monitor.pid");
+var DEFAULT_INTERVAL_MS = 5 * 60 * 1e3;
+async function checkSite(name, url) {
+  const start = Date.now();
+  try {
+    const resp = await axios5.head(url, { timeout: 1e4, maxRedirects: 5 });
+    return {
+      name,
+      url,
+      status: resp.status,
+      responseTime: Date.now() - start,
+      up: resp.status >= 200 && resp.status < 400
+    };
+  } catch (err) {
+    const elapsed = Date.now() - start;
+    if (axios5.isAxiosError(err) && err.response) {
+      return {
+        name,
+        url,
+        status: err.response.status,
+        responseTime: elapsed,
+        up: false,
+        error: `HTTP ${err.response.status}`
+      };
+    }
+    return {
+      name,
+      url,
+      status: null,
+      responseTime: elapsed,
+      up: false,
+      error: err instanceof Error ? err.message : "Unknown error"
+    };
+  }
+}
+function displayResults(results) {
+  console.clear();
+  ui.section("Shipem Monitor");
+  ui.br();
+  if (results.length === 0) {
+    ui.dim("No projects to monitor. Deploy a project first.");
+    ui.br();
+    return;
+  }
+  const maxName = Math.max(...results.map((r) => r.name.length));
+  for (const r of results) {
+    const nameCol = r.name.padEnd(maxName + 2);
+    const timeCol = `${r.responseTime}ms`.padStart(7);
+    if (r.up) {
+      console.log(`  ${brand.green("\u2713")} ${brand.bold(nameCol)} ${brand.dim(r.url.padEnd(40))} ${brand.green(`${r.status} OK`)}  ${brand.dim(`(${timeCol})`)}`);
+    } else {
+      const statusText = r.error ?? `${r.status}`;
+      console.log(`  ${brand.red("\u2717")} ${brand.bold(nameCol)} ${brand.dim(r.url.padEnd(40))} ${brand.red(statusText)}  ${brand.red("\u2190 DOWN!")}`);
+    }
+  }
+  ui.br();
+}
+async function monitorCommand(options = {}) {
+  if (options.stop) {
+    if (existsSync10(PID_FILE)) {
+      try {
+        const pid = parseInt(readFileSync10(PID_FILE, "utf-8").trim(), 10);
+        process.kill(pid, "SIGTERM");
+        unlinkSync(PID_FILE);
+        ui.success("Monitor daemon stopped.");
+      } catch {
+        ui.warn("Could not stop monitor daemon. It may have already exited.");
+        try {
+          unlinkSync(PID_FILE);
+        } catch {
+        }
+      }
+    } else {
+      ui.info("No monitor daemon running.");
+    }
+    ui.br();
+    return;
+  }
+  const projects = getProjects();
+  if (projects.length === 0) {
+    ui.section("Shipem Monitor");
+    ui.br();
+    ui.dim("No projects found. Deploy a project first, then run `shipem monitor`.");
+    ui.br();
+    return;
+  }
+  const intervalMs = options.interval ? parseInt(options.interval, 10) * 60 * 1e3 : DEFAULT_INTERVAL_MS;
+  if (options.daemon) {
+    writePidFile();
+    ui.success(`Monitor daemon started (PID ${process.pid}). Checking every ${intervalMs / 6e4} minutes.`);
+    ui.dim(`Stop with: shipem monitor stop`);
+    ui.br();
+  }
+  const previousUp = /* @__PURE__ */ new Map();
+  const runCheck = async () => {
+    const results = await Promise.all(
+      projects.map((p) => checkSite(p.name, p.url))
+    );
+    if (!options.daemon) {
+      displayResults(results);
+      const intervalMin = intervalMs / 6e4;
+      console.log(`  ${brand.dim(`Checking every ${intervalMin} minutes. Press ${chalk12.cyan("[q]")} to stop.`)}`);
+      ui.br();
+    }
+    for (const r of results) {
+      const wasUp = previousUp.get(r.name);
+      if (wasUp !== void 0) {
+        if (wasUp && !r.up) {
+          await sendStatusNotification(`\u{1F534} ${r.name} is DOWN! ${r.url} \u2014 ${r.error ?? "unreachable"}`);
+        } else if (!wasUp && r.up) {
+          await sendStatusNotification(`\u{1F7E2} ${r.name} is back UP! ${r.url} \u2014 ${r.responseTime}ms`);
+        }
+      }
+      previousUp.set(r.name, r.up);
+    }
+  };
+  await runCheck();
+  const timer = setInterval(() => void runCheck(), intervalMs);
+  if (!options.daemon && process.stdin.isTTY) {
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.setEncoding("utf-8");
+    process.stdin.on("data", (key) => {
+      if (key === "q" || key === "Q" || key === "") {
+        clearInterval(timer);
+        console.log("");
+        ui.info("Monitor stopped.");
+        process.exit(0);
+      }
+    });
+  }
+  await new Promise(() => {
+  });
+}
+function writePidFile() {
+  writeFileSync8(PID_FILE, String(process.pid), "utf-8");
+}
+
+// src/commands/hooks.ts
+import { existsSync as existsSync11, readFileSync as readFileSync11, writeFileSync as writeFileSync9, unlinkSync as unlinkSync2, chmodSync, mkdirSync as mkdirSync3 } from "fs";
+import { join as join14 } from "path";
+var HOOK_MARKER = "# shipem-auto-deploy";
+var HOOK_CONTENT = `#!/bin/sh
+${HOOK_MARKER}
+# Auto-deploy on commit \u2014 installed by shipem hooks install
+# Run shipem deploy in background so it doesn't block the commit
+nohup shipem deploy --yes --quiet > /dev/null 2>&1 &
+`;
+function getHookPath(cwd) {
+  return join14(cwd, ".git", "hooks", "post-commit");
+}
+function isShipemHook(path) {
+  if (!existsSync11(path)) return false;
+  const content = readFileSync11(path, "utf-8");
+  return content.includes(HOOK_MARKER);
+}
+async function hooksCommand(action) {
+  const cwd = process.cwd();
+  const gitDir = join14(cwd, ".git");
+  if (!existsSync11(gitDir)) {
+    ui.error("Not a git repository. Run `git init` first.");
+    ui.br();
+    return;
+  }
+  const hooksDir = join14(gitDir, "hooks");
+  const hookPath = getHookPath(cwd);
+  if (!action || action === "status") {
+    ui.section("Git Hooks");
+    ui.br();
+    if (isShipemHook(hookPath)) {
+      ui.success("post-commit hook is installed (auto-deploy on commit)");
+      ui.dim(`Remove with: shipem hooks remove`);
+    } else if (existsSync11(hookPath)) {
+      ui.info("A post-commit hook exists but was not installed by Shipem.");
+      ui.dim(`Path: ${hookPath}`);
+    } else {
+      ui.info("No post-commit hook installed.");
+      ui.dim(`Install with: shipem hooks install`);
+    }
+    ui.br();
+    return;
+  }
+  if (action === "install") {
+    if (existsSync11(hookPath) && !isShipemHook(hookPath)) {
+      ui.warn("A post-commit hook already exists and was not created by Shipem.");
+      ui.dim(`Path: ${hookPath}`);
+      ui.dim("Remove it manually or back it up before installing.");
+      ui.br();
+      return;
+    }
+    if (!existsSync11(hooksDir)) {
+      mkdirSync3(hooksDir, { recursive: true });
+    }
+    writeFileSync9(hookPath, HOOK_CONTENT, "utf-8");
+    chmodSync(hookPath, 493);
+    ui.success("Installed post-commit hook \u2192 auto-deploy on commit");
+    ui.dim(`Remove with: shipem hooks remove`);
+    ui.br();
+    return;
+  }
+  if (action === "remove") {
+    if (!existsSync11(hookPath)) {
+      ui.info("No post-commit hook to remove.");
+      ui.br();
+      return;
+    }
+    if (!isShipemHook(hookPath)) {
+      ui.warn("The post-commit hook was not installed by Shipem. Not removing.");
+      ui.br();
+      return;
+    }
+    unlinkSync2(hookPath);
+    ui.success("Removed post-commit hook.");
+    ui.br();
+    return;
+  }
+  ui.error(`Unknown action: ${action}`);
+  ui.dim("Usage: shipem hooks [install|remove|status]");
+  ui.br();
+}
+
+// src/commands/logout.ts
+import axios6 from "axios";
 async function logoutCommand() {
   const token = getSessionToken();
   if (!token) {
@@ -2326,7 +3967,7 @@ async function logoutCommand() {
     return;
   }
   try {
-    await axios4.post(`${SHIPEM_API_URL}/auth/logout`, { token }, { timeout: 5e3 });
+    await axios6.post(`${SHIPEM_API_URL}/auth/logout`, { token }, { timeout: 5e3 });
   } catch {
   }
   clearSessionToken();
@@ -2334,20 +3975,145 @@ async function logoutCommand() {
   ui.br();
 }
 
+// src/commands/preview.ts
+import { execa as execa5 } from "execa";
+import chalk13 from "chalk";
+async function getCurrentBranch() {
+  try {
+    const { stdout } = await execa5("git", ["rev-parse", "--abbrev-ref", "HEAD"]);
+    return stdout.trim();
+  } catch {
+    throw new ConfigError(
+      "Could not detect git branch. Make sure you are inside a git repository."
+    );
+  }
+}
+function sanitizeBranchName(branch) {
+  return branch.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "").slice(0, 28);
+}
+async function previewCommand(options = {}) {
+  const startTime = Date.now();
+  const cwd = process.cwd();
+  ui.banner();
+  console.log(`  ${brand.bold("Preview deployment")}`);
+  console.log(`  ${brand.dim("Deploy a preview from your current branch")}`);
+  console.log("");
+  const branch = await getCurrentBranch();
+  if (branch === "main" || branch === "master") {
+    ui.warn(`You are on '${branch}'. Previews are meant for feature branches.`);
+    ui.dim("Use `shipem deploy` for production deployments.");
+    ui.br();
+  }
+  ui.info(`Branch: ${chalk13.cyan(branch)}`);
+  ui.br();
+  const existingConfig = readProjectConfig(cwd);
+  if (!existingConfig.project) {
+    throw new ConfigError(
+      "No shipem.json found. Run `shipem deploy` first to detect and configure your project."
+    );
+  }
+  const projectConfig = existingConfig.project;
+  const cfCreds = getCloudflareCredentials();
+  if (!cfCreds) {
+    throw new ConfigError(
+      "Preview deployments require Cloudflare credentials.\n  Set CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID environment variables.\n  Get these from: https://dash.cloudflare.com/profile/api-tokens"
+    );
+  }
+  if (!options.skipBuild) {
+    ui.section("Building...");
+    ui.br();
+    const buildResult = await buildProject(projectConfig, cwd);
+    if (!buildResult.success) {
+      throw new DeployError(
+        `Build failed: ${buildResult.error ?? "Unknown error"}. Fix build errors and try again.`
+      );
+    }
+    ui.br();
+  }
+  ui.section("Deploying preview...");
+  ui.br();
+  const cf = new CloudflarePages(cfCreds.apiToken, cfCreds.accountId);
+  const cfProjectName = sanitizeProjectName(projectConfig.name);
+  await cf.getOrCreateProject(cfProjectName, projectConfig);
+  const result = await cf.deployBranch(
+    cfProjectName,
+    projectConfig.outputDirectory,
+    branch,
+    cwd
+  );
+  const finalDeployment = await cf.waitForDeployment(cfProjectName, result.deployment.id);
+  const branchSlug = sanitizeBranchName(branch);
+  const previewUrl = finalDeployment.url || `https://${branchSlug}.${cfProjectName}.pages.dev`;
+  const previewRecord = {
+    branch,
+    url: previewUrl,
+    deploymentId: result.deployment.id,
+    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    status: "success"
+  };
+  const existingPreviews = existingConfig.previews ?? [];
+  const updatedPreviews = [
+    previewRecord,
+    ...existingPreviews.filter((p) => p.branch !== branch)
+  ].slice(0, 20);
+  writeProjectConfig(
+    { ...existingConfig, previews: updatedPreviews },
+    cwd
+  );
+  const elapsedSec = (Date.now() - startTime) / 1e3;
+  console.log("");
+  console.log(`  ${brand.green.bold("Preview live!")}`);
+  console.log("");
+  console.log(`  ${brand.gray("Branch:")}  ${chalk13.cyan(branch)}`);
+  console.log(`  ${brand.gray("URL:")}     ${brand.brightBlue.underline(previewUrl)}`);
+  console.log(`  ${brand.gray("Files:")}   ${result.fileCount} files (${ui.formatBytes(result.totalBytes)})`);
+  console.log(`  ${brand.gray("Time:")}    ${elapsedSec.toFixed(1)}s`);
+  console.log("");
+  const copied = ui.copyToClipboard(previewUrl);
+  if (copied) {
+    ui.success("Preview URL copied to clipboard!");
+  }
+  console.log("");
+  console.log(`  ${brand.bold("Next steps:")}`);
+  console.log(`    ${brand.gray("Share")}     \u2192 Send the preview URL to teammates`);
+  console.log(`    ${brand.gray("Update")}    \u2192 ${chalk13.cyan("npx shipem preview")} (re-deploy this branch)`);
+  console.log(`    ${brand.gray("Promote")}   \u2192 Merge to main and ${chalk13.cyan("npx shipem deploy")}`);
+  console.log("");
+}
+
 // src/index.ts
-import { readFileSync as readFileSync6 } from "fs";
+import { readFileSync as readFileSync12 } from "fs";
 import { fileURLToPath } from "url";
-import { dirname, join as join7 } from "path";
+import { dirname, join as join15 } from "path";
 var __filename2 = fileURLToPath(import.meta.url);
 var __dirname2 = dirname(__filename2);
 var version = "0.1.0";
 try {
   const pkg = JSON.parse(
-    readFileSync6(join7(__dirname2, "../package.json"), "utf-8")
+    readFileSync12(join15(__dirname2, "../package.json"), "utf-8")
   );
   version = pkg.version;
 } catch {
 }
+var globalVerbose = false;
+var globalJson = false;
+function handleError(err, fallbackMsg) {
+  if (globalJson) {
+    const code = err instanceof ShipemError ? err.code : "ERR_UNKNOWN";
+    const message = err instanceof Error ? err.message : fallbackMsg;
+    console.log(JSON.stringify({ success: false, error: message, code }));
+    process.exit(err instanceof ShipemError ? err.exitCode : 2);
+  }
+  ui.br();
+  if (err instanceof ShipemError) {
+    ui.error(err.message);
+    if (globalVerbose || process.env.DEBUG) console.error(err);
+    process.exit(err.exitCode);
+  }
+  ui.error(err instanceof Error ? err.message : fallbackMsg);
+  if (globalVerbose || process.env.DEBUG) console.error(err);
+  process.exit(2);
+}
 var program = new Command();
 program.name("shipem").description(
   "One-command deployment for apps built by AI coding tools.\n\nYour AI built it. We'll ship it."
@@ -2356,61 +4122,136 @@ program.name("shipem").description(
   return "";
 }).addHelpText("after", `
 Quick start:
-  npx shipem          Deploy your app
-  npx shipem login    Authenticate with GitHub
-  npx shipem status   Check deployment status
-  npx shipem down     Take your app offline
+  npx shipem              Deploy your app
+  npx shipem preview      Deploy a preview from your branch
+  npx shipem watch        Watch for changes and auto-deploy
+  npx shipem init         Bootstrap a new project
+  npx shipem init -t <t>  Init from a template
+  npx shipem templates    List available templates
+  npx shipem fix          Auto-fix build errors
+  npx shipem env          Check environment variables
+  npx shipem dev          Start dev server with deploy shortcut
+  npx shipem status       Check deployment status
+  npx shipem history      Show deploy history across projects
+  npx shipem monitor      Monitor site uptime
+  npx shipem hooks        Manage git deploy hooks
+  npx shipem config       Manage global settings
+  npx shipem login        Authenticate with GitHub
+  npx shipem down         Take your app offline
 `);
-program.command("deploy", { isDefault: true }).description("Detect and deploy your app (default command)").option("-y, --yes", "Skip all prompts and use defaults").option("-n, --name <name>", "Override app name").option("--skip-build", "Skip the build step (deploy existing output directory)").option("--direct", "Deploy directly using your Cloudflare credentials (bypass Shipem API)").action(async (options) => {
+program.command("deploy", { isDefault: true }).description("Detect and deploy your app (default command)").option("-y, --yes", "Skip all prompts and use defaults").option("-n, --name <name>", "Override app name").option("--skip-build", "Skip the build step (deploy existing output directory)").option("--turbo", "Skip the build step (alias for --skip-build)").option("--package <name>", "Deploy a specific package from a monorepo").option("--direct", "Deploy directly using your Cloudflare credentials (bypass Shipem API)").option("--verbose", "Show detailed debug output").option("--json", "Output machine-readable JSON instead of human-friendly text").option("--notify [url]", "Send deploy notification to webhook").option("--quiet", "Minimal output (just URL on success)").action(async (options) => {
+  globalVerbose = options.verbose ?? false;
+  globalJson = options.json ?? false;
   try {
     await deployCommand(options);
   } catch (err) {
-    ui.br();
-    ui.error(err instanceof Error ? err.message : "An unexpected error occurred.");
-    if (process.env.DEBUG) {
-      console.error(err);
-    }
-    process.exit(1);
+    handleError(err, "An unexpected error occurred.");
+  }
+});
+program.command("fix").description("Auto-fix common build errors (missing deps, TypeScript issues, etc.)").option("--verbose", "Show detailed debug output").action(async (options) => {
+  globalVerbose = options.verbose ?? false;
+  try {
+    await fixCommand(options);
+  } catch (err) {
+    handleError(err, "Fix command failed.");
+  }
+});
+program.command("env").description("Scan and manage environment variables").action(async () => {
+  try {
+    await envCommand();
+  } catch (err) {
+    handleError(err, "Env command failed.");
+  }
+});
+program.command("init").description("Bootstrap a new project from a description or template").option("-y, --yes", "Skip prompts and use defaults").option("-t, --template <name>", "Use a built-in template (run `shipem templates` to list)").action(async (options) => {
+  try {
+    await initCommand(options);
+  } catch (err) {
+    handleError(err, "Init command failed.");
+  }
+});
+program.command("dev").description("Start dev server with deploy shortcut").action(async () => {
+  try {
+    await devCommand();
+  } catch (err) {
+    handleError(err, "Dev command failed.");
   }
 });
 program.command("login").description("Log in to Shipem via GitHub").action(async () => {
   try {
     await loginCommand();
   } catch (err) {
-    ui.error(err instanceof Error ? err.message : "Login failed.");
-    process.exit(1);
+    handleError(err, "Login failed.");
   }
 });
 program.command("logout").description("Log out of Shipem").action(async () => {
   try {
     await logoutCommand();
   } catch (err) {
-    ui.error(err instanceof Error ? err.message : "Logout failed.");
-    process.exit(1);
+    handleError(err, "Logout failed.");
   }
 });
 program.command("status").description("Check deployment status").action(async () => {
   try {
     await statusCommand();
   } catch (err) {
-    ui.error(err instanceof Error ? err.message : "An unexpected error occurred.");
-    process.exit(1);
+    handleError(err, "An unexpected error occurred.");
   }
 });
 program.command("logs").description("View recent deployment logs").option("-n, --lines <number>", "Number of log lines to show", "100").action(async (options) => {
   try {
     await logsCommand({ lines: options.lines ? parseInt(options.lines, 10) : void 0 });
   } catch (err) {
-    ui.error(err instanceof Error ? err.message : "An unexpected error occurred.");
-    process.exit(1);
+    handleError(err, "An unexpected error occurred.");
   }
 });
 program.command("down").description("Take down a deployment").option("-y, --yes", "Skip confirmation prompt").action(async (options) => {
   try {
     await downCommand(options);
   } catch (err) {
-    ui.error(err instanceof Error ? err.message : "An unexpected error occurred.");
-    process.exit(1);
+    handleError(err, "An unexpected error occurred.");
+  }
+});
+program.command("history").description("Show deploy history across all projects").action(async () => {
+  try {
+    await historyCommand();
+  } catch (err) {
+    handleError(err, "History command failed.");
+  }
+});
+program.command("config [action] [key] [value]").description("Manage global Shipem settings").action(async (action, key, value) => {
+  try {
+    await configCommand(action, key, value);
+  } catch (err) {
+    handleError(err, "Config command failed.");
+  }
+});
+program.command("watch").description("Watch for file changes and auto-deploy").action(async () => {
+  try {
+    await watchCommand();
+  } catch (err) {
+    handleError(err, "Watch command failed.");
+  }
+});
+program.command("hooks [action]").description("Manage git hooks for auto-deploy (install|remove|status)").action(async (action) => {
+  try {
+    await hooksCommand(action);
+  } catch (err) {
+    handleError(err, "Hooks command failed.");
+  }
+});
+var monitorCmd = program.command("monitor").description("Monitor deployed sites for uptime").option("--interval <minutes>", "Check interval in minutes (default: 5)").option("--daemon", "Run as background daemon").action(async (options) => {
+  try {
+    await monitorCommand(options);
+  } catch (err) {
+    handleError(err, "Monitor command failed.");
+  }
+});
+monitorCmd.command("stop").description("Stop the monitor daemon").action(async () => {
+  try {
+    await monitorCommand({ stop: true });
+  } catch (err) {
+    handleError(err, "Monitor stop failed.");
   }
 });
 var domainsCmd = program.command("domains").description("Manage custom domains (coming soon)");
@@ -2419,6 +4260,21 @@ domainsCmd.command("add <domain>").description("Add a custom domain to your depl
   ui.dim("Follow our changelog at https://shipem.dev/changelog for updates.");
   ui.br();
 });
+program.command("preview").description("Deploy a preview URL from the current git branch").option("--skip-build", "Skip the build step").option("--verbose", "Show detailed debug output").action(async (options) => {
+  globalVerbose = options.verbose ?? false;
+  try {
+    await previewCommand(options);
+  } catch (err) {
+    handleError(err, "Preview command failed.");
+  }
+});
+program.command("templates").description("List available project templates for `shipem init --template`").action(async () => {
+  try {
+    await templatesCommand();
+  } catch (err) {
+    handleError(err, "Templates command failed.");
+  }
+});
 program.on("command:*", (cmds) => {
   ui.error(`Unknown command: ${cmds[0]}`);
   ui.dim("Run `shipem --help` to see available commands.");