yapout 0.7.0 → 0.9.0

package/dist/index.js

@@ -7,16 +7,16 @@ import {
 } from "./chunk-DLHFRTYU.js";
 
 // src/index.ts
-import { Command as Command16 } from "commander";
+import { Command as Command17 } from "commander";
 
 // src/commands/login.ts
-import { Command } from "commander";
-import http from "http";
-import { createHash } from "crypto";
-import { hostname, userInfo } from "os";
-import chalk from "chalk";
+import { Command as Command2 } from "commander";
+import http2 from "http";
+import { createHash as createHash2 } from "crypto";
+import { hostname as hostname2, userInfo as userInfo2 } from "os";
+import chalk3 from "chalk";
 import open from "open";
-import { anyApi as anyApi2 } from "convex/server";
+import { anyApi as anyApi3 } from "convex/server";
 
 // src/lib/config.ts
 import { homedir } from "os";
@@ -521,8 +521,267 @@ function registerProtocolHandler() {
   }
 }
 
+// src/commands/serve.ts
+import { Command } from "commander";
+import http from "http";
+import { createHash } from "crypto";
+import { hostname, userInfo, platform as platform2, type } from "os";
+import { join as join3 } from "path";
+import {
+  readFileSync as readFileSync2,
+  writeFileSync as writeFileSync3,
+  existsSync as existsSync2,
+  unlinkSync as unlinkSync3,
+  openSync
+} from "fs";
+import { spawn } from "child_process";
+import chalk2 from "chalk";
+import { anyApi as anyApi2 } from "convex/server";
+
+// src/lib/auth.ts
+import chalk from "chalk";
+function requireAuth() {
+  const creds = readCredentials();
+  if (!creds) {
+    console.error(
+      chalk.red("Not logged in.") + " Run " + chalk.cyan("yapout login") + " first."
+    );
+    process.exit(1);
+  }
+  if (Date.now() > creds.expiresAt) {
+    console.error(
+      chalk.red("Session expired.") + " Run " + chalk.cyan("yapout login") + " to re-authenticate."
+    );
+    process.exit(1);
+  }
+  return creds;
+}
+
+// src/commands/serve.ts
+var CLI_VERSION = "0.9.0";
+var DEFAULT_PORT = 7777;
+var PORT_RANGE = 10;
+var HEARTBEAT_MS = 3e4;
+var PID_FILE = join3(getYapoutDir(), "serve.pid");
+var PORT_FILE = join3(getYapoutDir(), "serve.port");
+var LOG_FILE = join3(getYapoutDir(), "serve.log");
+var ALLOWED_ORIGINS = [
+  "https://yapout.com",
+  "https://www.yapout.com",
+  "https://yapout.vercel.app",
+  // Local dev / sandbox ports — wide range so any worktree's auto-allocated
+  // Next.js port works without configuration.
+  ...Array.from({ length: 20 }, (_, i) => `http://localhost:${3e3 + i}`),
+  ...Array.from({ length: 20 }, (_, i) => `http://127.0.0.1:${3e3 + i}`)
+];
+function computeDeviceId() {
+  return createHash("sha256").update(hostname() + userInfo().username).digest("hex").slice(0, 16);
+}
+function corsHeadersFor(origin) {
+  const allowOrigin = origin && ALLOWED_ORIGINS.includes(origin) ? origin : ALLOWED_ORIGINS[0];
+  return {
+    "Access-Control-Allow-Origin": allowOrigin,
+    "Access-Control-Allow-Methods": "GET, OPTIONS",
+    "Access-Control-Allow-Headers": "Content-Type",
+    "Access-Control-Allow-Private-Network": "true",
+    Vary: "Origin"
+  };
+}
+function startServer(payload) {
+  const server = http.createServer((req, res) => {
+    const origin = req.headers.origin;
+    const headers = corsHeadersFor(origin);
+    if (req.method === "OPTIONS") {
+      res.writeHead(204, headers);
+      res.end();
+      return;
+    }
+    if (req.method === "GET" && req.url === "/device") {
+      res.writeHead(200, {
+        ...headers,
+        "Content-Type": "application/json",
+        "Cache-Control": "no-store"
+      });
+      res.end(JSON.stringify(payload));
+      return;
+    }
+    res.writeHead(404, headers);
+    res.end();
+  });
+  return new Promise((resolve12, reject) => {
+    let attempt = 0;
+    const tryListen = () => {
+      const port = DEFAULT_PORT + attempt;
+      const onError = (err) => {
+        server.removeListener("error", onError);
+        if (err.code === "EADDRINUSE" && attempt < PORT_RANGE - 1) {
+          attempt++;
+          tryListen();
+        } else {
+          reject(err);
+        }
+      };
+      server.once("error", onError);
+      server.listen(port, "127.0.0.1", () => {
+        server.removeListener("error", onError);
+        resolve12({
+          port,
+          close: () => server.close()
+        });
+      });
+    };
+    tryListen();
+  });
+}
+async function runForeground() {
+  const creds = requireAuth();
+  const deviceId = computeDeviceId();
+  const payload = {
+    deviceId,
+    name: hostname(),
+    hostname: hostname(),
+    platform: `${type()} ${platform2()}`,
+    cliVersion: CLI_VERSION
+  };
+  const { port } = await startServer(payload);
+  writeFileSync3(PORT_FILE, String(port));
+  writeFileSync3(PID_FILE, String(process.pid));
+  console.log(chalk2.green(`yapout serve listening on http://127.0.0.1:${port}`));
+  console.log(chalk2.dim(`Device: ${payload.name} (${deviceId})`));
+  console.log(chalk2.dim("Press Ctrl-C to stop."));
+  const client = createConvexClient(creds.token);
+  const heartbeat = async () => {
+    try {
+      await client.mutation(anyApi2.functions.devices.heartbeatDevice, {
+        deviceId
+      });
+    } catch {
+    }
+  };
+  client.mutation(anyApi2.functions.devices.registerDevice, {
+    deviceId,
+    name: payload.name,
+    cliVersion: CLI_VERSION,
+    machineHostname: payload.hostname
+  }).catch(() => {
+  });
+  void heartbeat();
+  const interval = setInterval(heartbeat, HEARTBEAT_MS);
+  const shutdown = async () => {
+    clearInterval(interval);
+    try {
+      await client.mutation(anyApi2.functions.devices.markDeviceOffline, {
+        deviceId
+      });
+    } catch {
+    }
+    try {
+      if (existsSync2(PID_FILE)) unlinkSync3(PID_FILE);
+    } catch {
+    }
+    try {
+      if (existsSync2(PORT_FILE)) unlinkSync3(PORT_FILE);
+    } catch {
+    }
+    process.exit(0);
+  };
+  process.on("SIGINT", () => {
+    void shutdown();
+  });
+  process.on("SIGTERM", () => {
+    void shutdown();
+  });
+  await new Promise(() => {
+  });
+}
+function isProcessRunning(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function readPid() {
+  if (!existsSync2(PID_FILE)) return null;
+  const raw = readFileSync2(PID_FILE, "utf-8").trim();
+  const pid = parseInt(raw, 10);
+  return Number.isFinite(pid) ? pid : null;
+}
+function readPort() {
+  if (!existsSync2(PORT_FILE)) return null;
+  const raw = readFileSync2(PORT_FILE, "utf-8").trim();
+  const port = parseInt(raw, 10);
+  return Number.isFinite(port) ? port : null;
+}
+function spawnServeDaemon(argv0) {
+  const existingPid = readPid();
+  if (existingPid && isProcessRunning(existingPid)) return;
+  const logFd = openSync(LOG_FILE, "a");
+  const child = spawn(process.execPath, [argv0, "serve"], {
+    detached: true,
+    stdio: ["ignore", logFd, logFd],
+    env: process.env
+  });
+  child.unref();
+}
+var serveCommand = new Command("serve").description(
+  "Run the local device discovery server (auto-started by `yapout login`)"
+).option("--status", "Check if the server is running").option("--stop", "Stop the running server").action(async (opts) => {
+  if (opts.status) {
+    const pid = readPid();
+    const port = readPort();
+    if (pid && isProcessRunning(pid)) {
+      console.log(
+        chalk2.green(`yapout serve is running`) + chalk2.dim(` (PID ${pid}, port ${port ?? "?"})`)
+      );
+    } else {
+      if (pid) unlinkSync3(PID_FILE);
+      console.log(chalk2.dim("yapout serve is not running"));
+    }
+    return;
+  }
+  if (opts.stop) {
+    const pid = readPid();
+    if (!pid) {
+      console.log(chalk2.dim("yapout serve is not running"));
+      return;
+    }
+    try {
+      process.kill(pid, "SIGTERM");
+      console.log(chalk2.green(`Stopped yapout serve`) + chalk2.dim(` (PID ${pid})`));
+    } catch {
+      console.log(chalk2.dim("Server already stopped"));
+    }
+    try {
+      unlinkSync3(PID_FILE);
+    } catch {
+    }
+    try {
+      unlinkSync3(PORT_FILE);
+    } catch {
+    }
+    return;
+  }
+  const existingPid = readPid();
+  if (existingPid && !isProcessRunning(existingPid)) {
+    try {
+      unlinkSync3(PID_FILE);
+    } catch {
+    }
+  } else if (existingPid && isProcessRunning(existingPid)) {
+    console.log(
+      chalk2.dim(
+        `yapout serve is already running (PID ${existingPid}). Use --stop first.`
+      )
+    );
+    process.exit(1);
+  }
+  await runForeground();
+});
+
 // src/commands/login.ts
-var CLI_VERSION = "0.7.0";
+var CLI_VERSION2 = "0.9.0";
 function safeReturnTo(raw) {
   if (!raw) return null;
   try {
@@ -541,7 +800,7 @@ function startCallbackServer() {
       resolveData = res;
       rejectData = rej;
     });
-    const server = http.createServer((req, res) => {
+    const server = http2.createServer((req, res) => {
       const url = new URL(req.url, `http://localhost`);
       if (url.pathname === "/callback") {
         const token = url.searchParams.get("token");
@@ -593,14 +852,14 @@ function startCallbackServer() {
     }, 12e4);
   });
 }
-var loginCommand = new Command("login").description("Authenticate with yapout").action(async () => {
-  console.log(chalk.dim("Starting authentication..."));
+var loginCommand = new Command2("login").description("Authenticate with yapout").action(async () => {
+  console.log(chalk3.dim("Starting authentication..."));
   const { port, data } = await startCallbackServer();
   const appUrl = getAppUrl();
   const authUrl = `${appUrl}/auth/cli?port=${port}`;
-  console.log(chalk.dim(`Opening browser...`));
+  console.log(chalk3.dim(`Opening browser...`));
   await open(authUrl);
-  console.log(chalk.dim("Waiting for authentication in browser..."));
+  console.log(chalk3.dim("Waiting for authentication in browser..."));
   try {
     const result = await data;
     const creds = {
@@ -615,74 +874,60 @@ var loginCommand = new Command("login").description("Authenticate with yapout").
       Math.round((result.expiresAt - Date.now()) / 864e5)
     );
     console.log(
-      chalk.green("Logged in as ") + chalk.bold(result.email) + chalk.dim(
+      chalk3.green("Logged in as ") + chalk3.bold(result.email) + chalk3.dim(
         ` (expires in ${daysLeft} day${daysLeft === 1 ? "" : "s"})`
       )
     );
     try {
       const client = createConvexClient(creds.token);
-      const deviceId = createHash("sha256").update(hostname() + userInfo().username).digest("hex").slice(0, 16);
-      await client.mutation(anyApi2.functions.devices.registerDevice, {
+      const deviceId = createHash2("sha256").update(hostname2() + userInfo2().username).digest("hex").slice(0, 16);
+      await client.mutation(anyApi3.functions.devices.registerDevice, {
         deviceId,
-        name: hostname(),
-        cliVersion: CLI_VERSION
+        name: hostname2(),
+        cliVersion: CLI_VERSION2
       });
     } catch {
-      console.warn(chalk.dim("Note: Could not register device. This is non-fatal."));
+      console.warn(chalk3.dim("Note: Could not register device. This is non-fatal."));
     }
     try {
       registerProtocolHandler();
       console.log(
-        chalk.dim("Registered yapout:// protocol handler")
+        chalk3.dim("Registered yapout:// protocol handler")
       );
     } catch {
     }
+    try {
+      spawnServeDaemon(process.argv[1]);
+      console.log(chalk3.dim("Started yapout serve in the background"));
+    } catch {
+    }
     process.exit(0);
   } catch (err) {
-    console.error(chalk.red(err.message));
+    console.error(chalk3.red(err.message));
     process.exit(1);
   }
 });
 
 // src/commands/logout.ts
-import { Command as Command2 } from "commander";
-import chalk2 from "chalk";
-var logoutCommand = new Command2("logout").description("Log out of yapout").action(() => {
+import { Command as Command3 } from "commander";
+import chalk4 from "chalk";
+var logoutCommand = new Command3("logout").description("Log out of yapout").action(() => {
   deleteCredentials();
-  console.log(chalk2.green("Logged out."));
+  console.log(chalk4.green("Logged out."));
 });
 
 // src/commands/link.ts
-import { Command as Command3 } from "commander";
-import { resolve as resolve2, join as join3 } from "path";
+import { Command as Command4 } from "commander";
+import { resolve as resolve2, join as join4 } from "path";
 import {
-  existsSync as existsSync2,
+  existsSync as existsSync3,
   mkdirSync as mkdirSync3,
-  readFileSync as readFileSync2,
-  writeFileSync as writeFileSync3,
+  readFileSync as readFileSync3,
+  writeFileSync as writeFileSync4,
   appendFileSync
 } from "fs";
-import { hostname as hostname2 } from "os";
-import chalk4 from "chalk";
-
-// src/lib/auth.ts
-import chalk3 from "chalk";
-function requireAuth() {
-  const creds = readCredentials();
-  if (!creds) {
-    console.error(
-      chalk3.red("Not logged in.") + " Run " + chalk3.cyan("yapout login") + " first."
-    );
-    process.exit(1);
-  }
-  if (Date.now() > creds.expiresAt) {
-    console.error(
-      chalk3.red("Session expired.") + " Run " + chalk3.cyan("yapout login") + " to re-authenticate."
-    );
-    process.exit(1);
-  }
-  return creds;
-}
+import { hostname as hostname3 } from "os";
+import chalk5 from "chalk";
 
 // src/lib/prompts.ts
 import { select } from "@inquirer/prompts";
@@ -734,7 +979,7 @@ branch_prefix: feat
 #   {{ticket.linearTicketId}}, {{ticket.id}}
 # commit_template: "{{ticket.type}}({{ticket.linearTicketId}}): {{ticket.title}}"
 `;
-var linkCommand = new Command3("link").description("Link the current directory to a yapout project").action(async () => {
+var linkCommand = new Command4("link").description("Link the current directory to a yapout project").action(async () => {
   const creds = requireAuth();
   const cwd = resolveRepoRoot(resolve2(process.cwd()));
   const client = createConvexClient(creds.token);
@@ -746,25 +991,25 @@ var linkCommand = new Command3("link").description("Link the current directory t
     );
   } catch (err) {
     console.error(
-      chalk4.red("Failed to fetch projects."),
+      chalk5.red("Failed to fetch projects."),
       err.message
     );
     process.exit(1);
   }
   if (projects.length === 0) {
     console.error(
-      chalk4.yellow("No projects found.") + " Create one at " + chalk4.cyan(`${getAppUrl()}/dashboard`)
+      chalk5.yellow("No projects found.") + " Create one at " + chalk5.cyan(`${getAppUrl()}/dashboard`)
     );
     process.exit(1);
   }
   const selected = await pickProject(projects);
-  const device = getOrCreateDeviceIdentity(hostname2());
+  const device = getOrCreateDeviceIdentity(hostname3());
   try {
     await client.mutation(anyApi.functions.devices.registerDevice, {
       deviceId: device.deviceId,
       name: device.name,
       cliVersion: getCliVersion(),
-      machineHostname: hostname2()
+      machineHostname: hostname3()
     });
     await client.mutation(anyApi.functions.projectCheckouts.linkCheckout, {
       projectId: selected.id,
@@ -773,7 +1018,7 @@ var linkCommand = new Command3("link").description("Link the current directory t
     });
   } catch (err) {
     console.warn(
-      chalk4.yellow("Warning: failed to record this checkout \u2014 "),
+      chalk5.yellow("Warning: failed to record this checkout \u2014 "),
       err.message
     );
   }
@@ -782,17 +1027,17 @@ var linkCommand = new Command3("link").description("Link the current directory t
     projectName: selected.name,
     linkedAt: Date.now()
   });
-  const yapoutDir = join3(cwd, ".yapout");
-  if (!existsSync2(yapoutDir)) {
+  const yapoutDir = join4(cwd, ".yapout");
+  if (!existsSync3(yapoutDir)) {
     mkdirSync3(yapoutDir, { recursive: true });
   }
-  const configPath = join3(yapoutDir, "config.yml");
-  if (!existsSync2(configPath)) {
-    writeFileSync3(configPath, CONFIG_YAML_CONTENT);
+  const configPath = join4(yapoutDir, "config.yml");
+  if (!existsSync3(configPath)) {
+    writeFileSync4(configPath, CONFIG_YAML_CONTENT);
   }
-  const gitignorePath = join3(cwd, ".gitignore");
-  if (existsSync2(gitignorePath)) {
-    const content = readFileSync2(gitignorePath, "utf-8");
+  const gitignorePath = join4(cwd, ".gitignore");
+  if (existsSync3(gitignorePath)) {
+    const content = readFileSync3(gitignorePath, "utf-8");
     if (!content.includes(".yapout/")) {
       appendFileSync(
         gitignorePath,
@@ -800,13 +1045,13 @@ var linkCommand = new Command3("link").description("Link the current directory t
       );
     }
   } else {
-    writeFileSync3(gitignorePath, "# yapout local config\n.yapout/\n");
+    writeFileSync4(gitignorePath, "# yapout local config\n.yapout/\n");
   }
-  const mcpPath = join3(cwd, ".mcp.json");
+  const mcpPath = join4(cwd, ".mcp.json");
   let mcpConfig = {};
-  if (existsSync2(mcpPath)) {
+  if (existsSync3(mcpPath)) {
     try {
-      mcpConfig = JSON.parse(readFileSync2(mcpPath, "utf-8"));
+      mcpConfig = JSON.parse(readFileSync3(mcpPath, "utf-8"));
     } catch {
     }
   }
@@ -815,17 +1060,17 @@ var linkCommand = new Command3("link").description("Link the current directory t
     command: "yapout",
     args: ["mcp-server"]
   };
-  writeFileSync3(mcpPath, JSON.stringify(mcpConfig, null, 2) + "\n");
+  writeFileSync4(mcpPath, JSON.stringify(mcpConfig, null, 2) + "\n");
   const label = selected.githubRepoFullName ? `${selected.name} (${selected.githubRepoFullName})` : selected.name;
   const orgSuffix = selected.org ? ` in ${selected.org.name}` : "";
   console.log(
-    chalk4.green(`Linked to ${label}${orgSuffix}.`) + " Claude Code will discover yapout tools automatically."
+    chalk5.green(`Linked to ${label}${orgSuffix}.`) + " Claude Code will discover yapout tools automatically."
   );
 });
 function getCliVersion() {
   try {
     const pkg = JSON.parse(
-      readFileSync2(join3(import.meta.dirname, "..", "package.json"), "utf-8")
+      readFileSync3(join4(import.meta.dirname, "..", "package.json"), "utf-8")
     );
     return pkg.version ?? "unknown";
   } catch {
@@ -834,15 +1079,15 @@ function getCliVersion() {
 }
 
 // src/commands/unlink.ts
-import { Command as Command4 } from "commander";
-import { resolve as resolve3, join as join4 } from "path";
-import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync4, rmSync } from "fs";
-import chalk5 from "chalk";
-var unlinkCommand = new Command4("unlink").description("Unlink the current directory from its yapout project").action(async () => {
+import { Command as Command5 } from "commander";
+import { resolve as resolve3, join as join5 } from "path";
+import { existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync5, rmSync } from "fs";
+import chalk6 from "chalk";
+var unlinkCommand = new Command5("unlink").description("Unlink the current directory from its yapout project").action(async () => {
   const cwd = resolve3(process.cwd());
   const mapping = getProjectMapping(cwd);
   if (!mapping) {
-    console.error(chalk5.yellow("No project linked to this directory."));
+    console.error(chalk6.yellow("No project linked to this directory."));
     process.exit(1);
   }
   const device = readDeviceIdentity();
@@ -856,26 +1101,26 @@ var unlinkCommand = new Command4("unlink").description("Unlink the current direc
       });
     } catch (err) {
       console.warn(
-        chalk5.yellow("Warning: failed to update server \u2014 "),
+        chalk6.yellow("Warning: failed to update server \u2014 "),
         err.message
       );
     }
   }
   removeProjectMapping(cwd);
-  const yapoutDir = join4(cwd, ".yapout");
-  if (existsSync3(yapoutDir)) {
+  const yapoutDir = join5(cwd, ".yapout");
+  if (existsSync4(yapoutDir)) {
     rmSync(yapoutDir, { recursive: true });
   }
-  const mcpPath = join4(cwd, ".mcp.json");
-  if (existsSync3(mcpPath)) {
+  const mcpPath = join5(cwd, ".mcp.json");
+  if (existsSync4(mcpPath)) {
     try {
-      const mcpConfig = JSON.parse(readFileSync3(mcpPath, "utf-8"));
+      const mcpConfig = JSON.parse(readFileSync4(mcpPath, "utf-8"));
       if (mcpConfig.mcpServers?.yapout) {
         delete mcpConfig.mcpServers.yapout;
         if (Object.keys(mcpConfig.mcpServers).length === 0) {
           rmSync(mcpPath);
         } else {
-          writeFileSync4(
+          writeFileSync5(
             mcpPath,
             JSON.stringify(mcpConfig, null, 2) + "\n"
           );
@@ -884,23 +1129,23 @@ var unlinkCommand = new Command4("unlink").description("Unlink the current direc
     } catch {
     }
   }
-  console.log(chalk5.green("Unlinked."));
+  console.log(chalk6.green("Unlinked."));
 });
 
 // src/commands/status.ts
-import { Command as Command5 } from "commander";
+import { Command as Command6 } from "commander";
 import { resolve as resolve4 } from "path";
-import chalk6 from "chalk";
-var statusCommand = new Command5("status").description("Show yapout status for this directory").action(() => {
-  console.log(chalk6.bold("yapout status\n"));
+import chalk7 from "chalk";
+var statusCommand = new Command6("status").description("Show yapout status for this directory").action(() => {
+  console.log(chalk7.bold("yapout status\n"));
   const creds = readCredentials();
   if (!creds) {
     console.log(
-      `  Auth:     ${chalk6.red("Not logged in.")} Run ${chalk6.cyan("yapout login")}.`
+      `  Auth:     ${chalk7.red("Not logged in.")} Run ${chalk7.cyan("yapout login")}.`
     );
   } else if (Date.now() > creds.expiresAt) {
     console.log(
-      `  Auth:     ${chalk6.red("Session expired.")} Run ${chalk6.cyan("yapout login")}.`
+      `  Auth:     ${chalk7.red("Session expired.")} Run ${chalk7.cyan("yapout login")}.`
     );
   } else {
     const daysLeft = Math.max(
@@ -908,35 +1153,35 @@ var statusCommand = new Command5("status").description("Show yapout status for t
       Math.round((creds.expiresAt - Date.now()) / 864e5)
     );
     console.log(
-      `  Auth:     ${chalk6.green(creds.email)} (expires in ${daysLeft} day${daysLeft === 1 ? "" : "s"})`
+      `  Auth:     ${chalk7.green(creds.email)} (expires in ${daysLeft} day${daysLeft === 1 ? "" : "s"})`
     );
   }
   const cwd = resolve4(process.cwd());
   const mapping = getProjectMapping(cwd);
   if (!mapping) {
     console.log(
-      `  Project:  ${chalk6.yellow("No project linked.")} Run ${chalk6.cyan("yapout link")} in a repo.`
+      `  Project:  ${chalk7.yellow("No project linked.")} Run ${chalk7.cyan("yapout link")} in a repo.`
     );
   } else {
-    console.log(`  Project:  ${chalk6.green(mapping.projectName)}`);
+    console.log(`  Project:  ${chalk7.green(mapping.projectName)}`);
   }
-  console.log(`  Daemon:   ${chalk6.dim("not running")}`);
-  console.log(`  Work:     ${chalk6.dim("no active tickets")}`);
+  console.log(`  Daemon:   ${chalk7.dim("not running")}`);
+  console.log(`  Work:     ${chalk7.dim("no active tickets")}`);
   console.log();
 });
 
 // src/commands/init.ts
-import { Command as Command6 } from "commander";
-import { resolve as resolve5, join as join5 } from "path";
+import { Command as Command7 } from "commander";
+import { resolve as resolve5, join as join6 } from "path";
 import {
-  existsSync as existsSync4,
+  existsSync as existsSync5,
   mkdirSync as mkdirSync4,
-  writeFileSync as writeFileSync5,
-  readFileSync as readFileSync4,
+  writeFileSync as writeFileSync6,
+  readFileSync as readFileSync5,
   appendFileSync as appendFileSync2
 } from "fs";
-import { hostname as hostname3 } from "os";
-import chalk7 from "chalk";
+import { hostname as hostname4 } from "os";
+import chalk8 from "chalk";
 var CONFIG_YAML_CONTENT2 = `# yapout local configuration
 # See: https://docs.yapout.dev/cli/config
 
@@ -961,7 +1206,7 @@ branch_prefix: feat
 #   {{ticket.linearTicketId}}, {{ticket.id}}
 # commit_template: "{{ticket.type}}({{ticket.linearTicketId}}): {{ticket.title}}"
 `;
-var initCommand = new Command6("init").description("Create a yapout project from the current repo and link it").argument("[name]", "Project name (defaults to repo name)").option("--org <slug>", "Org slug to create the project in (skips picker)").action(async (name, options) => {
+var initCommand = new Command7("init").description("Create a yapout project from the current repo and link it").argument("[name]", "Project name (defaults to repo name)").option("--org <slug>", "Org slug to create the project in (skips picker)").action(async (name, options) => {
   const creds = requireAuth();
   const cwd = resolveRepoRoot(resolve5(process.cwd()));
   let repoFullName;
@@ -971,7 +1216,7 @@ var initCommand = new Command6("init").description("Create a yapout project from
     defaultBranch = getDefaultBranch(cwd);
   } catch (err) {
     console.error(
-      chalk7.red("Not a git repo with a GitHub remote."),
+      chalk8.red("Not a git repo with a GitHub remote."),
       err.message
     );
     process.exit(1);
@@ -986,14 +1231,14 @@ var initCommand = new Command6("init").description("Create a yapout project from
     );
   } catch (err) {
     console.error(
-      chalk7.red("Failed to load your orgs."),
+      chalk8.red("Failed to load your orgs."),
       err.message
     );
     process.exit(1);
   }
   if (!orgs || orgs.length === 0) {
     console.error(
-      chalk7.red(
+      chalk8.red(
         "You aren't a member of any org. Sign in to the web app once to create your personal org, then re-run."
       )
     );
@@ -1005,10 +1250,10 @@ var initCommand = new Command6("init").description("Create a yapout project from
     const match = orgs.find((o) => o.org.slug === options.org);
     if (!match) {
       console.error(
-        chalk7.red(`Org "${options.org}" not found among your memberships.`)
+        chalk8.red(`Org "${options.org}" not found among your memberships.`)
       );
       console.error(
-        chalk7.dim(
+        chalk8.dim(
           "Available: " + orgs.map((o) => o.org.slug).join(", ")
         )
       );
@@ -1020,7 +1265,7 @@ var initCommand = new Command6("init").description("Create a yapout project from
     chosenOrgId = orgs[0].org._id;
     chosenOrgName = orgs[0].org.name;
     console.log(
-      chalk7.dim(`Creating in `) + chalk7.cyan(chosenOrgName)
+      chalk8.dim(`Creating in `) + chalk8.cyan(chosenOrgName)
     );
   } else {
     const picked = await pickOrg(
@@ -1034,17 +1279,17 @@ var initCommand = new Command6("init").description("Create a yapout project from
     chosenOrgId = picked.id;
     chosenOrgName = picked.name;
   }
-  const device = getOrCreateDeviceIdentity(hostname3());
+  const device = getOrCreateDeviceIdentity(hostname4());
   try {
     await client.mutation(anyApi.functions.devices.registerDevice, {
       deviceId: device.deviceId,
       name: device.name,
       cliVersion: getCliVersion2(),
-      machineHostname: hostname3()
+      machineHostname: hostname4()
     });
   } catch (err) {
     console.warn(
-      chalk7.yellow("Warning: device registration failed \u2014 "),
+      chalk8.yellow("Warning: device registration failed \u2014 "),
       err.message
     );
   }
@@ -1061,7 +1306,7 @@ var initCommand = new Command6("init").description("Create a yapout project from
     );
   } catch (err) {
     console.error(
-      chalk7.red("Failed to create project."),
+      chalk8.red("Failed to create project."),
       err.message
     );
     process.exit(1);
@@ -1074,7 +1319,7 @@ var initCommand = new Command6("init").description("Create a yapout project from
     });
   } catch (err) {
     console.warn(
-      chalk7.yellow("Warning: failed to record project checkout \u2014 "),
+      chalk8.yellow("Warning: failed to record project checkout \u2014 "),
       err.message
     );
   }
@@ -1083,15 +1328,15 @@ var initCommand = new Command6("init").description("Create a yapout project from
     projectName: result.projectName,
     linkedAt: Date.now()
   });
-  const yapoutDir = join5(cwd, ".yapout");
-  if (!existsSync4(yapoutDir)) mkdirSync4(yapoutDir, { recursive: true });
-  const configPath = join5(yapoutDir, "config.yml");
-  if (!existsSync4(configPath)) {
-    writeFileSync5(configPath, CONFIG_YAML_CONTENT2);
-  }
-  const gitignorePath = join5(cwd, ".gitignore");
-  if (existsSync4(gitignorePath)) {
-    const content = readFileSync4(gitignorePath, "utf-8");
+  const yapoutDir = join6(cwd, ".yapout");
+  if (!existsSync5(yapoutDir)) mkdirSync4(yapoutDir, { recursive: true });
+  const configPath = join6(yapoutDir, "config.yml");
+  if (!existsSync5(configPath)) {
+    writeFileSync6(configPath, CONFIG_YAML_CONTENT2);
+  }
+  const gitignorePath = join6(cwd, ".gitignore");
+  if (existsSync5(gitignorePath)) {
+    const content = readFileSync5(gitignorePath, "utf-8");
     if (!content.includes(".yapout/")) {
       appendFileSync2(
         gitignorePath,
@@ -1099,11 +1344,11 @@ var initCommand = new Command6("init").description("Create a yapout project from
       );
     }
   }
-  const mcpPath = join5(cwd, ".mcp.json");
+  const mcpPath = join6(cwd, ".mcp.json");
   let mcpConfig = {};
-  if (existsSync4(mcpPath)) {
+  if (existsSync5(mcpPath)) {
     try {
-      mcpConfig = JSON.parse(readFileSync4(mcpPath, "utf-8"));
+      mcpConfig = JSON.parse(readFileSync5(mcpPath, "utf-8"));
     } catch {
     }
   }
@@ -1112,20 +1357,20 @@ var initCommand = new Command6("init").description("Create a yapout project from
     command: "yapout",
     args: ["mcp-server"]
   };
-  writeFileSync5(mcpPath, JSON.stringify(mcpConfig, null, 2) + "\n");
+  writeFileSync6(mcpPath, JSON.stringify(mcpConfig, null, 2) + "\n");
   console.log(
-    chalk7.green(`Created project "${result.projectName}"`) + chalk7.dim(
+    chalk8.green(`Created project "${result.projectName}"`) + chalk8.dim(
       ` in ${chosenOrgName} (${repoFullName}, branch: ${defaultBranch})`
     )
   );
   console.log(
-    chalk7.dim("Run ") + chalk7.cyan("yapout_compact") + chalk7.dim(" in Claude Code to generate project context.")
+    chalk8.dim("Run ") + chalk8.cyan("yapout_compact") + chalk8.dim(" in Claude Code to generate project context.")
   );
 });
 function getCliVersion2() {
   try {
     const pkg = JSON.parse(
-      readFileSync4(join5(import.meta.dirname, "..", "package.json"), "utf-8")
+      readFileSync5(join6(import.meta.dirname, "..", "package.json"), "utf-8")
     );
     return pkg.version ?? "unknown";
   } catch {
@@ -1134,18 +1379,18 @@ function getCliVersion2() {
 }
 
 // src/commands/mcp-server.ts
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 
 // src/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { ConvexHttpClient as ConvexHttpClient2 } from "convex/browser";
-import { anyApi as anyApi3 } from "convex/server";
+import { anyApi as anyApi4 } from "convex/server";
 
 // src/mcp/tools/init.ts
 import { z } from "zod";
-import { join as join6 } from "path";
-import { existsSync as existsSync5, mkdirSync as mkdirSync5, writeFileSync as writeFileSync6 } from "fs";
+import { join as join7 } from "path";
+import { existsSync as existsSync6, mkdirSync as mkdirSync5, writeFileSync as writeFileSync7 } from "fs";
 import { stringify as yamlStringify } from "yaml";
 function registerInitTool(server, ctx) {
   server.tool(
@@ -1161,7 +1406,7 @@ function registerInitTool(server, ctx) {
       const defaultBranch = getDefaultBranch(repoRoot);
       const projectName = args.name || repoFullName.split("/")[1] || "unnamed";
       const result = await ctx.client.mutation(
-        anyApi3.functions.projects.createProjectFromCli,
+        anyApi4.functions.projects.createProjectFromCli,
         {
           name: projectName,
           githubRepoFullName: repoFullName,
@@ -1176,11 +1421,11 @@ function registerInitTool(server, ctx) {
         projectName: result.projectName,
         linkedAt: Date.now()
       });
-      const yapoutDir = join6(repoRoot, ".yapout");
-      if (!existsSync5(yapoutDir)) mkdirSync5(yapoutDir, { recursive: true });
-      const configPath = join6(yapoutDir, "config.yml");
-      if (!existsSync5(configPath)) {
-        writeFileSync6(
+      const yapoutDir = join7(repoRoot, ".yapout");
+      if (!existsSync6(yapoutDir)) mkdirSync5(yapoutDir, { recursive: true });
+      const configPath = join7(yapoutDir, "config.yml");
+      if (!existsSync6(configPath)) {
+        writeFileSync7(
           configPath,
           `# yapout local configuration
 
@@ -1249,7 +1494,7 @@ function registerCompactTool(server, ctx) {
       let lastUpdated;
       try {
         const project = await ctx.client.query(
-          anyApi3.functions.projects.getProject,
+          anyApi4.functions.projects.getProject,
           { projectId: ctx.projectId }
         );
         currentContext = project?.contextSummary ?? void 0;
@@ -1292,7 +1537,7 @@ function registerUpdateContextTool(server, ctx) {
         };
       }
       await ctx.client.mutation(
-        anyApi3.functions.projects.updateProjectContext,
+        anyApi4.functions.projects.updateProjectContext,
         {
           projectId: ctx.projectId,
           summary: args.summary
@@ -1362,7 +1607,7 @@ function registerQueueTool(server, ctx) {
         };
       }
       const data = await ctx.client.query(
-        anyApi3.functions.workQueue.getWorkQueue,
+        anyApi4.functions.workQueue.getWorkQueue,
         { projectId: ctx.projectId }
       );
       if (!data) {
@@ -1471,7 +1716,7 @@ function registerGetBriefTool(server, ctx) {
       }
       try {
         const data = await ctx.client.query(
-          anyApi3.functions.findings.getFindingBrief,
+          anyApi4.functions.findings.getFindingBrief,
           { findingId: itemId }
         );
         if (data) {
@@ -1485,7 +1730,7 @@ function registerGetBriefTool(server, ctx) {
       }
       try {
         const bundle = await ctx.client.query(
-          anyApi3.functions.bundles.getBundle,
+          anyApi4.functions.bundles.getBundle,
           { bundleId: itemId }
         );
         if (bundle) {
@@ -1536,8 +1781,8 @@ function registerGetBriefTool(server, ctx) {
 
 // src/mcp/tools/claim.ts
 import { z as z5 } from "zod";
-import { join as join7 } from "path";
-import { existsSync as existsSync6, mkdirSync as mkdirSync6, writeFileSync as writeFileSync7 } from "fs";
+import { join as join8 } from "path";
+import { existsSync as existsSync7, mkdirSync as mkdirSync6, writeFileSync as writeFileSync8 } from "fs";
 function readBranchPrefix(cwd) {
   try {
     const config = readYapoutConfig(cwd);
@@ -1656,7 +1901,7 @@ function formatBundleBrief(bundle, projectContext) {
 async function detectWorkItemKind(client, workItemId) {
   try {
     const bundle = await client.query(
-      anyApi3.functions.bundles.getBundle,
+      anyApi4.functions.bundles.getBundle,
       { bundleId: workItemId }
     );
     if (bundle) {
@@ -1710,7 +1955,7 @@ function registerClaimTool(server, ctx) {
 }
 async function claimStandalone(ctx, args, findingId) {
   const briefData = await ctx.client.query(
-    anyApi3.functions.findings.getFindingBrief,
+    anyApi4.functions.findings.getFindingBrief,
     { findingId }
   );
   if (!briefData) {
@@ -1731,11 +1976,11 @@ async function claimStandalone(ctx, args, findingId) {
   const slug = slugify(finding.title);
   const branchName = linearIssueId ? `${prefix}/${linearIssueId.toLowerCase()}-${slug}` : `${prefix}/${slug}`;
   const localClaim = await ctx.client.mutation(
-    anyApi3.functions.findings.claimFindingLocal,
+    anyApi4.functions.findings.claimFindingLocal,
     { findingId, branchName }
   );
   const claim = await ctx.client.mutation(
-    anyApi3.functions.workQueue.claimForImplementation,
+    anyApi4.functions.workQueue.claimForImplementation,
     {
       projectId: ctx.projectId,
       workItemId: findingId,
@@ -1745,7 +1990,7 @@ async function claimStandalone(ctx, args, findingId) {
   if (linearIssueId && ctx.projectId) {
     try {
       await ctx.client.action(
-        anyApi3.functions.linearStatusMutations.moveIssueStatus,
+        anyApi4.functions.linearStatusMutations.moveIssueStatus,
         {
           projectId: ctx.projectId,
           linearIssueId,
@@ -1802,11 +2047,11 @@ async function claimBundle(ctx, args, bundleId, bundleData) {
     };
   }
   const localClaim = await ctx.client.mutation(
-    anyApi3.functions.findings.claimFindingLocal,
+    anyApi4.functions.findings.claimFindingLocal,
     { findingId: primaryFinding._id, branchName }
   );
   const claim = await ctx.client.mutation(
-    anyApi3.functions.workQueue.claimForImplementation,
+    anyApi4.functions.workQueue.claimForImplementation,
     {
       projectId: ctx.projectId,
       workItemId: bundleId,
@@ -1817,7 +2062,7 @@ async function claimBundle(ctx, args, bundleId, bundleData) {
     if (f.linearIssueId && ctx.projectId) {
       try {
         await ctx.client.action(
-          anyApi3.functions.linearStatusMutations.moveIssueStatus,
+          anyApi4.functions.linearStatusMutations.moveIssueStatus,
           {
             projectId: ctx.projectId,
             linearIssueId: f.linearIssueId,
@@ -1831,7 +2076,7 @@ async function claimBundle(ctx, args, bundleId, bundleData) {
   let projectContext;
   try {
     const briefData = await ctx.client.query(
-      anyApi3.functions.findings.getFindingBrief,
+      anyApi4.functions.findings.getFindingBrief,
       { findingId: primaryFinding._id }
     );
     projectContext = briefData?.projectContext;
@@ -1871,7 +2116,7 @@ async function claimBundle(ctx, args, bundleId, bundleData) {
 async function getDefaultBranchForProject(ctx) {
   try {
     const data = await ctx.client.query(
-      anyApi3.functions.projects.getProject,
+      anyApi4.functions.projects.getProject,
       { projectId: ctx.projectId }
     );
     return data?.githubDefaultBranch || "main";
@@ -1890,7 +2135,7 @@ async function setupWorktree(ctx, itemId, branchName, defaultBranch, brief, pipe
   writeBrief(worktreePath, brief);
   try {
     await ctx.client.mutation(
-      anyApi3.functions.pipelineRuns.reportDaemonEvent,
+      anyApi4.functions.pipelineRuns.reportDaemonEvent,
       {
         pipelineRunId,
         event: "worktree_created",
@@ -1919,14 +2164,14 @@ async function setupWorktree(ctx, itemId, branchName, defaultBranch, brief, pipe
   };
 }
 function writeBrief(dir, brief) {
-  const yapoutDir = join7(dir, ".yapout");
-  if (!existsSync6(yapoutDir)) mkdirSync6(yapoutDir, { recursive: true });
-  writeFileSync7(join7(yapoutDir, "brief.md"), brief);
+  const yapoutDir = join8(dir, ".yapout");
+  if (!existsSync7(yapoutDir)) mkdirSync6(yapoutDir, { recursive: true });
+  writeFileSync8(join8(yapoutDir, "brief.md"), brief);
 }
 async function reportClaimEvents(ctx, pipelineRunId, title, branchName) {
   try {
     await ctx.client.mutation(
-      anyApi3.functions.pipelineRuns.reportDaemonEvent,
+      anyApi4.functions.pipelineRuns.reportDaemonEvent,
       {
         pipelineRunId,
         event: "daemon_claimed",
@@ -1934,7 +2179,7 @@ async function reportClaimEvents(ctx, pipelineRunId, title, branchName) {
       }
     );
     await ctx.client.mutation(
-      anyApi3.functions.pipelineRuns.reportDaemonEvent,
+      anyApi4.functions.pipelineRuns.reportDaemonEvent,
       {
         pipelineRunId,
         event: "branch_created",
@@ -1961,7 +2206,7 @@ function registerEventTool(server, ctx) {
     async (args) => {
       try {
         await ctx.client.mutation(
-          anyApi3.functions.pipelineRuns.reportDaemonEvent,
+          anyApi4.functions.pipelineRuns.reportDaemonEvent,
           {
             pipelineRunId: args.pipelineRunId,
             event: args.event,
@@ -2053,8 +2298,8 @@ async function createPullRequest(title, body, branch, base, repoFullName, cwd) {
 }
 
 // src/mcp/tools/ship.ts
-import { join as join8 } from "path";
-import { existsSync as existsSync7, readFileSync as readFileSync5 } from "fs";
+import { join as join9 } from "path";
+import { existsSync as existsSync8, readFileSync as readFileSync6 } from "fs";
 function buildCommitMessage(message, template, finding, allLinearIds) {
   if (message) return message;
   if (template) {
@@ -2105,9 +2350,9 @@ function registerShipTool(server, ctx) {
       let isBundle = false;
       let bundleTitle;
       try {
-        const briefPath = join8(gitCwd, ".yapout", "brief.md");
-        if (existsSync7(briefPath)) {
-          const brief = readFileSync5(briefPath, "utf-8");
+        const briefPath = join9(gitCwd, ".yapout", "brief.md");
+        if (existsSync8(briefPath)) {
+          const brief = readFileSync6(briefPath, "utf-8");
           const bundleMatch = brief.match(/^# Bundle: (.+)$/m);
           if (bundleMatch) {
             isBundle = true;
@@ -2218,7 +2463,7 @@ function registerShipTool(server, ctx) {
       }
       try {
         await ctx.client.mutation(
-          anyApi3.functions.pipelineRuns.reportDaemonEvent,
+          anyApi4.functions.pipelineRuns.reportDaemonEvent,
           {
             pipelineRunId: args.pipelineRunId,
             event: "push_completed",
@@ -2227,7 +2472,7 @@ function registerShipTool(server, ctx) {
         );
         if (prUrl) {
           await ctx.client.mutation(
-            anyApi3.functions.pipelineRuns.reportDaemonEvent,
+            anyApi4.functions.pipelineRuns.reportDaemonEvent,
             {
               pipelineRunId: args.pipelineRunId,
               event: "pr_opened",
@@ -2239,7 +2484,7 @@ function registerShipTool(server, ctx) {
       }
       try {
         await ctx.client.mutation(
-          anyApi3.functions.pipelineRuns.completePipelineLocal,
+          anyApi4.functions.pipelineRuns.completePipelineLocal,
           {
             pipelineRunId: args.pipelineRunId,
             githubPrNumber: prNumber,
@@ -2255,7 +2500,7 @@ function registerShipTool(server, ctx) {
         if (ctx.projectId) {
           try {
             await ctx.client.action(
-              anyApi3.functions.linearStatusMutations.moveIssueStatus,
+              anyApi4.functions.linearStatusMutations.moveIssueStatus,
               {
                 projectId: ctx.projectId,
                 linearIssueId: linearId,
@@ -2267,7 +2512,7 @@ function registerShipTool(server, ctx) {
           if (prUrl) {
             try {
               await ctx.client.action(
-                anyApi3.functions.linearStatusMutations.addLinearComment,
+                anyApi4.functions.linearStatusMutations.addLinearComment,
                 {
                   projectId: ctx.projectId,
                   linearIssueId: linearId,
@@ -2285,7 +2530,7 @@ function registerShipTool(server, ctx) {
           result.worktreeCleaned = true;
           try {
             await ctx.client.mutation(
-              anyApi3.functions.pipelineRuns.reportDaemonEvent,
+              anyApi4.functions.pipelineRuns.reportDaemonEvent,
               {
                 pipelineRunId: args.pipelineRunId,
                 event: "worktree_cleaned",
@@ -2376,7 +2621,7 @@ function registerCheckTool(server, ctx) {
         if (args.pipelineRunId) {
           try {
             await ctx.client.mutation(
-              anyApi3.functions.pipelineRuns.reportDaemonEvent,
+              anyApi4.functions.pipelineRuns.reportDaemonEvent,
               {
                 pipelineRunId: args.pipelineRunId,
                 event: "running_check",
@@ -2396,7 +2641,7 @@ function registerCheckTool(server, ctx) {
         if (args.pipelineRunId) {
           try {
             await ctx.client.mutation(
-              anyApi3.functions.pipelineRuns.reportDaemonEvent,
+              anyApi4.functions.pipelineRuns.reportDaemonEvent,
               {
                 pipelineRunId: args.pipelineRunId,
                 event: passed ? "check_passed" : "check_failed",
@@ -2428,8 +2673,8 @@ function registerCheckTool(server, ctx) {
 
 // src/mcp/tools/bundle.ts
 import { z as z9 } from "zod";
-import { join as join9 } from "path";
-import { existsSync as existsSync8, writeFileSync as writeFileSync8, mkdirSync as mkdirSync7 } from "fs";
+import { join as join10 } from "path";
+import { existsSync as existsSync9, writeFileSync as writeFileSync9, mkdirSync as mkdirSync7 } from "fs";
 function registerBundleTool(server, ctx) {
   server.tool(
     "yapout_bundle",
@@ -2440,11 +2685,11 @@ function registerBundleTool(server, ctx) {
     },
     async (args) => {
       const result = await ctx.client.mutation(
-        anyApi3.functions.bundles.createBundle,
+        anyApi4.functions.bundles.createBundle,
         { leadFindingId: args.withFinding, joiningFindingId: args.findingId }
       );
       const bundledBrief = await ctx.client.query(
-        anyApi3.functions.bundles.getBundledBrief,
+        anyApi4.functions.bundles.getBundledBrief,
         { bundleId: result.bundleId }
       );
       if (!bundledBrief) {
@@ -2482,9 +2727,9 @@ function registerBundleTool(server, ctx) {
         sections.push("## Project Context", "", bundledBrief.projectContext);
       }
       const combinedBrief = sections.join("\n");
-      const yapoutDir = join9(ctx.cwd, ".yapout");
-      if (!existsSync8(yapoutDir)) mkdirSync7(yapoutDir, { recursive: true });
-      writeFileSync8(join9(yapoutDir, "brief.md"), combinedBrief);
+      const yapoutDir = join10(ctx.cwd, ".yapout");
+      if (!existsSync9(yapoutDir)) mkdirSync7(yapoutDir, { recursive: true });
+      writeFileSync9(join10(yapoutDir, "brief.md"), combinedBrief);
       return {
         content: [
           {
@@ -2541,7 +2786,7 @@ After calling this tool, you should:
       }
       try {
         const result = await ctx.client.mutation(
-          anyApi3.functions.localPipeline.claimForEnrichment,
+          anyApi4.functions.localPipeline.claimForEnrichment,
           {
             projectId,
             ...args.findingId ? { findingId: args.findingId } : {}
@@ -2601,7 +2846,7 @@ function registerGetExistingFindingsTool(server, ctx) {
       }
       try {
         const findings = await ctx.client.query(
-          anyApi3.functions.localPipeline.getExistingFindingTitles,
+          anyApi4.functions.localPipeline.getExistingFindingTitles,
           { projectId }
         );
         if (!findings || findings.length === 0) {
@@ -2697,12 +2942,13 @@ The finding transitions: enriching \u2192 enriched \u2192 ready.`,
       isOversized: z11.boolean().optional().describe("Set to true if this finding is too large for a single PR"),
       suggestedSplit: z11.array(z11.string()).optional().describe("If oversized: suggested sub-finding titles for breaking it down"),
       nature: z11.enum(["implementable", "operational", "spike"]).optional().describe("Override the finding's nature if enrichment reveals it should be reclassified"),
+      cloudSafe: z11.boolean().optional().describe("Set to true ONLY if this is a small mechanical change a cloud agent can ship without sandbox testing \u2014 text/copy edits, classname tweaks, single-named-constant changes, \u226430 lines, single file, no logic/type/dependency changes. Default false."),
       sessionId: z11.string().optional().describe("Bulk enrichment session ID (from yapout_start_enrichment). Updates session stats.")
     },
     async (args) => {
       try {
         await ctx.client.mutation(
-          anyApi3.functions.localPipeline.saveLocalEnrichment,
+          anyApi4.functions.localPipeline.saveLocalEnrichment,
           {
             findingId: args.findingId,
             title: args.title,
@@ -2712,15 +2958,16 @@ The finding transitions: enriching \u2192 enriched \u2192 ready.`,
             clarifications: args.clarifications,
             isOversized: args.isOversized,
             suggestedSplit: args.suggestedSplit,
-            nature: args.nature
+            nature: args.nature,
+            cloudSafe: args.cloudSafe
           }
         );
         await ctx.client.action(
-          anyApi3.functions.localPipeline.syncFindingToLinearLocal,
+          anyApi4.functions.localPipeline.syncFindingToLinearLocal,
           { findingId: args.findingId }
         );
         const finding = await ctx.client.query(
-          anyApi3.functions.findings.getFinding,
+          anyApi4.functions.findings.getFinding,
           { findingId: args.findingId }
         );
         if (args.sessionId) {
@@ -2779,7 +3026,7 @@ function registerSyncToLinearTool(server, ctx) {
     async (args) => {
       try {
         await ctx.client.action(
-          anyApi3.functions.localPipeline.syncFindingToLinearLocal,
+          anyApi4.functions.localPipeline.syncFindingToLinearLocal,
           { findingId: args.findingId }
         );
         return {
@@ -2837,7 +3084,7 @@ function registerSubmitYapSessionTool(server, ctx) {
       }
       try {
         const captureId = await ctx.client.mutation(
-          anyApi3.functions.captures.createFromYapSession,
+          anyApi4.functions.captures.createFromYapSession,
           {
             projectId: ctx.projectId,
             title: args.title,
@@ -3113,7 +3360,7 @@ function registerExtractFromYapTool(server, ctx) {
       }
       try {
         const result = await ctx.client.mutation(
-          anyApi3.functions.captures.extractFromYapSession,
+          anyApi4.functions.captures.extractFromYapSession,
           {
             projectId: ctx.projectId,
             title: args.sessionTitle,
@@ -3225,7 +3472,7 @@ full spec \u2014 schema changes, files to modify, edge cases, and acceptance cri
       }
       try {
         const result = await ctx.client.mutation(
-          anyApi3.functions.localPipeline.decomposeIntoBundle,
+          anyApi4.functions.localPipeline.decomposeIntoBundle,
           {
             findingId: args.findingId,
             bundleDescription: args.bundleDescription,
@@ -3298,7 +3545,7 @@ The finding must be in "enriching" or "enriched" status. It will be transitioned
       }
       try {
         const result = await ctx.client.mutation(
-          anyApi3.functions.findings.markDuplicate,
+          anyApi4.functions.findings.markDuplicate,
           {
             findingId: args.findingId,
             duplicateOfLinearId: args.duplicateOfLinearId,
@@ -3361,7 +3608,7 @@ and issue counts so you can ask the user for confirmation before creating a new
       }
       try {
         const project = await ctx.client.query(
-          anyApi3.functions.projects.getProject,
+          anyApi4.functions.projects.getProject,
           { projectId: ctx.projectId }
         );
         if (!project?.linearTeamId) {
@@ -3376,7 +3623,7 @@ and issue counts so you can ask the user for confirmation before creating a new
           };
         }
         const projects = await ctx.client.action(
-          anyApi3.functions.linearProjectsMutations.fetchProjectsDetailed,
+          anyApi4.functions.linearProjectsMutations.fetchProjectsDetailed,
           { projectId: ctx.projectId, teamId: project.linearTeamId }
         );
         return {
@@ -3438,7 +3685,7 @@ Optionally filter by tags, capture, or explicit finding IDs.`,
       }
       try {
         const allFindings = await ctx.client.query(
-          anyApi3.functions.findings.getProjectFindings,
+          anyApi4.functions.findings.getProjectFindings,
           { projectId }
         );
         let drafts = (allFindings ?? []).filter((f) => f.status === "draft");
@@ -3508,7 +3755,7 @@ When done=true, all findings have been processed.`,
         if (args.skip && args.skipFindingId) {
           try {
             await ctx.client.mutation(
-              anyApi3.functions.localPipeline.releaseEnrichmentClaim,
+              anyApi4.functions.localPipeline.releaseEnrichmentClaim,
               { findingId: args.skipFindingId }
             );
             updateSessionStats(args.sessionId, {
@@ -3518,7 +3765,7 @@ When done=true, all findings have been processed.`,
           }
         }
         const allFindings = await ctx.client.query(
-          anyApi3.functions.findings.getProjectFindings,
+          anyApi4.functions.findings.getProjectFindings,
           { projectId: session.projectId }
         );
         let drafts = (allFindings ?? []).filter(
@@ -3560,7 +3807,7 @@ When done=true, all findings have been processed.`,
         }
         const next = drafts[0];
         const claimResult = await ctx.client.mutation(
-          anyApi3.functions.localPipeline.claimForEnrichment,
+          anyApi4.functions.localPipeline.claimForEnrichment,
           { projectId: session.projectId, findingId: next._id }
         );
         if (!claimResult) {
@@ -3641,7 +3888,7 @@ The bundle and all its findings transition to "enriching" status.`,
     async (args) => {
       try {
         const result = await ctx.client.mutation(
-          anyApi3.functions.bundles.claimBundleForEnrichment,
+          anyApi4.functions.bundles.claimBundleForEnrichment,
           { bundleId: args.bundleId }
         );
         if (!result) {
@@ -3688,6 +3935,7 @@ Call yapout_sync_bundle_to_linear afterwards to create the Linear project.`,
       enrichedDescription: z21.string().describe("Bundle-level description \u2014 the cohesive story of what this bundle delivers"),
       acceptanceCriteria: z21.array(z21.string()).describe("Bundle-level acceptance criteria"),
       implementationBrief: z21.string().describe("Bundle-level implementation brief \u2014 overall approach, architecture decisions, key files"),
+      cloudSafe: z21.boolean().optional().describe("Set true ONLY if the entire bundle is small mechanical work (\u226430 lines total, single-file ideally, text/className/constant edits). Default false. If unsure, false."),
       findings: z21.array(z21.object({
         findingId: z21.string().describe("Finding ID"),
         title: z21.string().describe("Refined finding title"),
@@ -3699,13 +3947,14 @@ Call yapout_sync_bundle_to_linear afterwards to create the Linear project.`,
     async (args) => {
       try {
         await ctx.client.mutation(
-          anyApi3.functions.bundles.saveBundleEnrichment,
+          anyApi4.functions.bundles.saveBundleEnrichment,
           {
             bundleId: args.bundleId,
             title: args.title,
             enrichedDescription: args.enrichedDescription,
             acceptanceCriteria: args.acceptanceCriteria,
             implementationBrief: args.implementationBrief,
+            cloudSafe: args.cloudSafe,
             findings: args.findings.map((f) => ({
               findingId: f.findingId,
               title: f.title,
@@ -3737,6 +3986,113 @@ Call yapout_sync_bundle_to_linear afterwards to create the Linear project.`,
   );
 }
 
+// src/mcp/tools/block-enrichment.ts
+import { z as z22 } from "zod";
+function registerBlockEnrichmentTool(server, ctx) {
+  server.tool(
+    "yapout_block_enrichment",
+    `Refuse to enrich a finding because the user has not provided enough specifics for an autonomous agent to complete the work end-to-end.
+
+Use this when the finding lacks any of: target file/component, intended behavior, scope boundaries, or success criteria. Do NOT produce a half-baked enrichment "for review" \u2014 block instead. The bar for "enriched" is "another agent can ship this with zero further input."
+
+The finding must currently be in "enriching" status (claimed via yapout_get_unenriched_finding).
+
+Transitions: enriching \u2192 needs_input. The user sees the blockerReason and questions in the UI, adds context, and resubmits.`,
+    {
+      findingId: z22.string().describe("The finding ID to block (currently in 'enriching')"),
+      blockerReason: z22.string().describe("One sentence: why this finding cannot be enriched as written. State the missing piece concretely."),
+      blockerQuestions: z22.array(z22.string()).min(1).describe("2-5 specific questions the user must answer before enrichment can succeed. Each must be answerable in a sentence or two.")
+    },
+    async (args) => {
+      try {
+        await ctx.client.mutation(
+          anyApi4.functions.localPipeline.blockLocalEnrichment,
+          {
+            findingId: args.findingId,
+            blockerReason: args.blockerReason,
+            blockerQuestions: args.blockerQuestions
+          }
+        );
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                {
+                  findingId: args.findingId,
+                  status: "needs_input",
+                  message: "Enrichment blocked. The user will see your questions and resubmit with more context."
+                },
+                null,
+                2
+              )
+            }
+          ]
+        };
+      } catch (err) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Error blocking enrichment: ${err.message}`
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+  server.tool(
+    "yapout_block_bundle_enrichment",
+    `Refuse to enrich a bundle because the user has not provided enough specifics for an autonomous agent to ship it end-to-end.
+
+Same semantics as yapout_block_enrichment but for an entire bundle. Bundle status transitions enriching \u2192 needs_input; child findings revert to draft.`,
+    {
+      bundleId: z22.string().describe("The bundle ID to block (currently in 'enriching')"),
+      blockerReason: z22.string().describe("One sentence: why this bundle cannot be enriched."),
+      blockerQuestions: z22.array(z22.string()).min(1).describe("2-5 specific questions the user must answer.")
+    },
+    async (args) => {
+      try {
+        await ctx.client.mutation(
+          anyApi4.functions.bundles.blockBundleEnrichment,
+          {
+            bundleId: args.bundleId,
+            blockerReason: args.blockerReason,
+            blockerQuestions: args.blockerQuestions
+          }
+        );
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                {
+                  bundleId: args.bundleId,
+                  status: "needs_input",
+                  message: "Bundle enrichment blocked. The user will see your questions and resubmit."
+                },
+                null,
+                2
+              )
+            }
+          ]
+        };
+      } catch (err) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Error blocking bundle enrichment: ${err.message}`
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+}
+
 // src/mcp/server.ts
 async function startMcpServer() {
   const cwd = process.cwd();
@@ -3767,7 +4123,7 @@ async function startMcpServer() {
   };
   const server = new McpServer({
     name: "yapout",
-    version: "0.7.0"
+    version: "0.9.0"
   });
   registerInitTool(server, ctx);
   registerCompactTool(server, ctx);
@@ -3793,45 +4149,46 @@ async function startMcpServer() {
   registerEnrichNextTool(server, ctx);
   registerEnrichBundleTool(server, ctx);
   registerSaveBundleEnrichmentTool(server, ctx);
+  registerBlockEnrichmentTool(server, ctx);
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }
 
 // src/commands/mcp-server.ts
-var mcpServerCommand = new Command7("mcp-server").description("Start the MCP server (used by Claude Code)").action(async () => {
+var mcpServerCommand = new Command8("mcp-server").description("Start the MCP server (used by Claude Code)").action(async () => {
   await startMcpServer();
 });
 
 // src/commands/worktrees.ts
-import { Command as Command8 } from "commander";
-import chalk8 from "chalk";
+import { Command as Command9 } from "commander";
+import chalk9 from "chalk";
 import { resolve as resolve6 } from "path";
-var worktreesCommand = new Command8("worktrees").description("List active yapout worktrees").action(() => {
+var worktreesCommand = new Command9("worktrees").description("List active yapout worktrees").action(() => {
   const cwd = resolve6(process.cwd());
   const worktrees = listWorktrees(cwd);
   if (worktrees.length === 0) {
-    console.log(chalk8.dim("No active yapout worktrees."));
+    console.log(chalk9.dim("No active yapout worktrees."));
     return;
   }
-  console.log(chalk8.bold("Active worktrees:\n"));
+  console.log(chalk9.bold("Active worktrees:\n"));
   for (const wt of worktrees) {
     console.log(
-      `  ${chalk8.cyan(wt.path)}  ${chalk8.green(wt.branch)}` + (wt.ticketId ? `  ${chalk8.dim(`(${wt.ticketId})`)}` : "")
+      `  ${chalk9.cyan(wt.path)}  ${chalk9.green(wt.branch)}` + (wt.ticketId ? `  ${chalk9.dim(`(${wt.ticketId})`)}` : "")
     );
   }
   console.log();
 });
 
 // src/commands/clean.ts
-import { Command as Command9 } from "commander";
-import chalk9 from "chalk";
+import { Command as Command10 } from "commander";
+import chalk10 from "chalk";
 import { resolve as resolve7 } from "path";
-var cleanCommand = new Command9("clean").description("Remove worktrees for completed or failed tickets").action(async () => {
+var cleanCommand = new Command10("clean").description("Remove worktrees for completed or failed tickets").action(async () => {
   const creds = requireAuth();
   const cwd = resolve7(process.cwd());
   const worktrees = listWorktrees(cwd);
   if (worktrees.length === 0) {
-    console.log(chalk9.dim("No worktrees to clean."));
+    console.log(chalk10.dim("No worktrees to clean."));
     return;
   }
   const client = createConvexClient(creds.token);
@@ -3847,7 +4204,7 @@ var cleanCommand = new Command9("clean").description("Remove worktrees for compl
       if (isStale) {
         const label = ticket ? `${ticket.status}: ${ticket.title}` : "ticket not found";
         console.log(
-          chalk9.dim(`Removing worktree for ${wt.ticketId} (${label})...`)
+          chalk10.dim(`Removing worktree for ${wt.ticketId} (${label})...`)
         );
         removeWorktree(cwd, wt.path);
         cleaned++;
@@ -3856,10 +4213,10 @@ var cleanCommand = new Command9("clean").description("Remove worktrees for compl
     }
   }
   if (cleaned === 0) {
-    console.log(chalk9.dim("All worktrees are still active."));
+    console.log(chalk10.dim("All worktrees are still active."));
   } else {
     console.log(
-      chalk9.green(
+      chalk10.green(
         `Cleaned ${cleaned} worktree${cleaned === 1 ? "" : "s"}.`
       )
     );
@@ -3867,27 +4224,27 @@ var cleanCommand = new Command9("clean").description("Remove worktrees for compl
 });
 
 // src/commands/watch.ts
-import { Command as Command10 } from "commander";
+import { Command as Command11 } from "commander";
 import { resolve as resolve8 } from "path";
 import {
-  readFileSync as readFileSync6,
-  writeFileSync as writeFileSync9,
-  existsSync as existsSync10,
-  unlinkSync as unlinkSync3
+  readFileSync as readFileSync7,
+  writeFileSync as writeFileSync10,
+  existsSync as existsSync11,
+  unlinkSync as unlinkSync4
 } from "fs";
-import { join as join11 } from "path";
-import chalk11 from "chalk";
+import { join as join12 } from "path";
+import chalk12 from "chalk";
 import { ConvexHttpClient as ConvexHttpClient3 } from "convex/browser";
 
 // src/daemon/watcher.ts
-import { anyApi as anyApi5 } from "convex/server";
+import { anyApi as anyApi6 } from "convex/server";
 import { execSync as execSync4 } from "child_process";
-import { existsSync as existsSync9, mkdirSync as mkdirSync8 } from "fs";
-import { join as join10 } from "path";
+import { existsSync as existsSync10, mkdirSync as mkdirSync8 } from "fs";
+import { join as join11 } from "path";
 import { hostname as osHostname } from "os";
 
 // src/daemon/heartbeat.ts
-import { anyApi as anyApi4 } from "convex/server";
+import { anyApi as anyApi5 } from "convex/server";
 var HEARTBEAT_INTERVAL = 3e4;
 var Heartbeat = class {
   client;
@@ -3915,14 +4272,14 @@ var Heartbeat = class {
       if (currentTicketId) args.currentTicketId = currentTicketId;
       if (currentBranch) args.currentBranch = currentBranch;
       if (worktreePath) args.worktreePath = worktreePath;
-      await this.client.mutation(anyApi4.functions.agents.agentHeartbeat, args);
+      await this.client.mutation(anyApi5.functions.agents.agentHeartbeat, args);
     } catch {
     }
   }
 };
 
 // src/daemon/spawner.ts
-import { spawn } from "child_process";
+import { spawn as spawn2 } from "child_process";
 
 // src/daemon/notifications.ts
 var notifier = null;
@@ -4011,7 +4368,7 @@ var Spawner = class {
       ...process.env,
       YAPOUT_PROJECT_ID: this.projectId
     };
-    const child = spawn("claude", ["--dangerously-skip-permissions", prompt], {
+    const child = spawn2("claude", ["--dangerously-skip-permissions", prompt], {
       cwd: worktreePath,
       stdio: ["pipe", "pipe", "pipe"],
       env,
@@ -4123,7 +4480,7 @@ var Spawner = class {
 };
 
 // src/daemon/display.ts
-import chalk10 from "chalk";
+import chalk11 from "chalk";
 function formatElapsed(ms) {
   const seconds = Math.floor(ms / 1e3);
   if (seconds < 60) return `${seconds}s`;
@@ -4152,35 +4509,35 @@ function render(state) {
   if (queuedCount > 0) statusParts.push(`${queuedCount} queued`);
   const statusLine = statusParts.length > 0 ? statusParts.join(" | ") : "idle";
   lines.push(
-    `${chalk10.bold("yapout watch")} \u2014 ${state.projectName}`
+    `${chalk11.bold("yapout watch")} \u2014 ${state.projectName}`
   );
-  lines.push(`${chalk10.green("Watching")} | ${statusLine}`);
+  lines.push(`${chalk11.green("Watching")} | ${statusLine}`);
   lines.push("");
   for (const agent of state.activeAgents) {
     const elapsed = formatElapsed(now - agent.startedAt);
-    const wt = agent.worktree ? chalk10.dim(`worktree/${agent.ticketRef.toLowerCase()}`) : "";
+    const wt = agent.worktree ? chalk11.dim(`worktree/${agent.ticketRef.toLowerCase()}`) : "";
     lines.push(
-      `  ${chalk10.green("\u25CF")} ${chalk10.bold(agent.ticketRef)}  ${chalk10.dim(truncate2(`"${agent.title}"`, 35))}  ${chalk10.yellow(agent.phase)}  ${wt}  ${chalk10.dim(elapsed)}`
+      `  ${chalk11.green("\u25CF")} ${chalk11.bold(agent.ticketRef)}  ${chalk11.dim(truncate2(`"${agent.title}"`, 35))}  ${chalk11.yellow(agent.phase)}  ${wt}  ${chalk11.dim(elapsed)}`
     );
   }
   for (const ticket of state.queuedTickets) {
     lines.push(
-      `  ${chalk10.dim("\u25CB")} ${chalk10.bold(ticket.ticketRef)}  ${chalk10.dim(truncate2(`"${ticket.title}"`, 35))}  ${chalk10.dim("queued")}`
+      `  ${chalk11.dim("\u25CB")} ${chalk11.bold(ticket.ticketRef)}  ${chalk11.dim(truncate2(`"${ticket.title}"`, 35))}  ${chalk11.dim("queued")}`
     );
   }
   if (state.activeAgents.length > 0 || state.queuedTickets.length > 0) {
     lines.push("");
   }
   if (state.recentEvents.length > 0) {
-    lines.push(chalk10.dim("Recent:"));
+    lines.push(chalk11.dim("Recent:"));
     for (const event of state.recentEvents.slice(0, 8)) {
       lines.push(
-        `  ${chalk10.dim(formatTime(event.time))}  ${event.icon} ${event.message}`
+        `  ${chalk11.dim(formatTime(event.time))}  ${event.icon} ${event.message}`
       );
     }
     lines.push("");
   }
-  lines.push(chalk10.dim("Ctrl+C to stop (agents will finish)"));
+  lines.push(chalk11.dim("Ctrl+C to stop (agents will finish)"));
   return lines.join("\n");
 }
 function clearAndRender(state) {
@@ -4222,7 +4579,7 @@ var Watcher = class {
       );
       process.exit(1);
     }
-    await this.client.mutation(anyApi5.functions.agents.registerAgent, {
+    await this.client.mutation(anyApi6.functions.agents.registerAgent, {
       projectId: this.options.projectId,
       sessionId: this.sessionId,
       machineHostname: this.getHostname()
@@ -4258,7 +4615,7 @@ Waiting for ${this.spawner.activeCount} agent(s) to finish...`
       await this.spawner.gracefulShutdown();
     }
     try {
-      await this.client.mutation(anyApi5.functions.agents.unregisterAgent, {
+      await this.client.mutation(anyApi6.functions.agents.unregisterAgent, {
         sessionId: this.sessionId
       });
     } catch {
@@ -4272,7 +4629,7 @@ Waiting for ${this.spawner.activeCount} agent(s) to finish...`
     }
     this.heartbeat.stop();
     this.spawner.forceKill();
-    this.client.mutation(anyApi5.functions.agents.unregisterAgent, {
+    this.client.mutation(anyApi6.functions.agents.unregisterAgent, {
       sessionId: this.sessionId
     }).catch(() => {
     });
@@ -4314,7 +4671,7 @@ Waiting for ${this.spawner.activeCount} agent(s) to finish...`
   }
   async checkForEnrichmentWork(maxSlots) {
     const tickets = await this.client.query(
-      anyApi5.functions.localPipeline.getUnenrichedTickets,
+      anyApi6.functions.localPipeline.getUnenrichedTickets,
       { projectId: this.options.projectId }
     );
     if (!tickets || tickets.length === 0) return;
@@ -4343,7 +4700,7 @@ Waiting for ${this.spawner.activeCount} agent(s) to finish...`
   }
   async checkForImplementationWork(maxSlots) {
     const data = await this.client.query(
-      anyApi5.functions.tickets.getLocalQueuedTickets,
+      anyApi6.functions.tickets.getLocalQueuedTickets,
       { projectId: this.options.projectId }
     );
     if (!data || data.ready.length === 0) return;
@@ -4375,10 +4732,10 @@ Waiting for ${this.spawner.activeCount} agent(s) to finish...`
   }
   ensureEnrichWorktree() {
     const wtDir = getWorktreesDir(this.options.cwd);
-    const enrichPath = join10(wtDir, "_enrich");
-    if (existsSync9(enrichPath)) return enrichPath;
+    const enrichPath = join11(wtDir, "_enrich");
+    if (existsSync10(enrichPath)) return enrichPath;
     try {
-      if (!existsSync9(wtDir)) mkdirSync8(wtDir, { recursive: true });
+      if (!existsSync10(wtDir)) mkdirSync8(wtDir, { recursive: true });
       const defaultBranch = getDefaultBranch(this.options.cwd);
       execSync4(
         `git worktree add "${enrichPath}" origin/${defaultBranch}`,
@@ -4416,7 +4773,7 @@ Waiting for ${this.spawner.activeCount} agent(s) to finish...`
         if (wt.ticketId) {
           try {
             const ticket = await this.client.query(
-              anyApi5.functions.tickets.getTicket,
+              anyApi6.functions.tickets.getTicket,
               { ticketId: wt.ticketId }
             );
             if (ticket && (ticket.status === "failed" || ticket.status === "workflow2_done")) {
@@ -4481,38 +4838,38 @@ Waiting for ${this.spawner.activeCount} agent(s) to finish...`
 };
 
 // src/commands/watch.ts
-var PID_FILE = join11(getYapoutDir(), "watch.pid");
-var LOG_FILE = join11(getYapoutDir(), "watch.log");
-var watchCommand = new Command10("watch").description("Watch for work and spawn Claude Code agents").option("--bg", "Run in background (detached)").option("--stop", "Stop the background watcher").option("--status", "Check if watcher is running").option("--force", "Force kill on Ctrl+C (don't wait for agents)").action(async (opts) => {
+var PID_FILE2 = join12(getYapoutDir(), "watch.pid");
+var LOG_FILE2 = join12(getYapoutDir(), "watch.log");
+var watchCommand = new Command11("watch").description("Watch for work and spawn Claude Code agents").option("--bg", "Run in background (detached)").option("--stop", "Stop the background watcher").option("--status", "Check if watcher is running").option("--force", "Force kill on Ctrl+C (don't wait for agents)").action(async (opts) => {
   if (opts.status) {
-    if (existsSync10(PID_FILE)) {
-      const pid = parseInt(readFileSync6(PID_FILE, "utf-8").trim(), 10);
-      if (isProcessRunning(pid)) {
+    if (existsSync11(PID_FILE2)) {
+      const pid = parseInt(readFileSync7(PID_FILE2, "utf-8").trim(), 10);
+      if (isProcessRunning2(pid)) {
         console.log(
-          chalk11.green("Watcher is running") + chalk11.dim(` (PID ${pid})`)
+          chalk12.green("Watcher is running") + chalk12.dim(` (PID ${pid})`)
         );
       } else {
-        console.log(chalk11.dim("Watcher is not running (stale PID file)"));
-        unlinkSync3(PID_FILE);
+        console.log(chalk12.dim("Watcher is not running (stale PID file)"));
+        unlinkSync4(PID_FILE2);
       }
     } else {
-      console.log(chalk11.dim("Watcher is not running"));
+      console.log(chalk12.dim("Watcher is not running"));
     }
     return;
   }
   if (opts.stop) {
-    if (!existsSync10(PID_FILE)) {
-      console.log(chalk11.dim("No watcher running"));
+    if (!existsSync11(PID_FILE2)) {
+      console.log(chalk12.dim("No watcher running"));
       return;
     }
-    const pid = parseInt(readFileSync6(PID_FILE, "utf-8").trim(), 10);
+    const pid = parseInt(readFileSync7(PID_FILE2, "utf-8").trim(), 10);
     try {
       process.kill(pid, "SIGTERM");
-      console.log(chalk11.green(`Stopped watcher (PID ${pid})`));
+      console.log(chalk12.green(`Stopped watcher (PID ${pid})`));
     } catch {
-      console.log(chalk11.dim("Watcher already stopped"));
+      console.log(chalk12.dim("Watcher already stopped"));
     }
-    unlinkSync3(PID_FILE);
+    unlinkSync4(PID_FILE2);
     return;
   }
   const creds = requireAuth();
@@ -4520,7 +4877,7 @@ var watchCommand = new Command10("watch").description("Watch for work and spawn
   const mapping = getProjectMapping(cwd);
   if (!mapping) {
     console.error(
-      chalk11.red("No project linked.") + " Run " + chalk11.cyan("yapout link") + " in a repo."
+      chalk12.red("No project linked.") + " Run " + chalk12.cyan("yapout link") + " in a repo."
     );
     process.exit(1);
   }
@@ -4528,16 +4885,16 @@ var watchCommand = new Command10("watch").description("Watch for work and spawn
   const client = new ConvexHttpClient3(getConvexUrl());
   client.setAuth(creds.token);
   if (opts.bg) {
-    writeFileSync9(PID_FILE, process.pid.toString());
+    writeFileSync10(PID_FILE2, process.pid.toString());
     console.log(
-      chalk11.green("Watcher started in background") + chalk11.dim(` (PID ${process.pid}, log: ${LOG_FILE})`)
+      chalk12.green("Watcher started in background") + chalk12.dim(` (PID ${process.pid}, log: ${LOG_FILE2})`)
     );
   }
-  console.log(chalk11.bold(`yapout watch v${"0.7.0"}`));
+  console.log(chalk12.bold(`yapout watch v${"0.9.0"}`));
   console.log(
-    `Project: ${chalk11.green(mapping.projectName)} (${mapping.projectId})`
+    `Project: ${chalk12.green(mapping.projectName)} (${mapping.projectId})`
   );
-  console.log(chalk11.dim("Watching..."));
+  console.log(chalk12.dim("Watching..."));
   console.log();
   const watcher = new Watcher(
     {
@@ -4554,17 +4911,17 @@ var watchCommand = new Command10("watch").description("Watch for work and spawn
   const shutdown = async () => {
     if (shuttingDown) {
       watcher.forceStop();
-      if (existsSync10(PID_FILE)) unlinkSync3(PID_FILE);
+      if (existsSync11(PID_FILE2)) unlinkSync4(PID_FILE2);
       process.exit(0);
     }
     shuttingDown = true;
-    console.log(chalk11.dim("\nShutting down..."));
+    console.log(chalk12.dim("\nShutting down..."));
     if (opts.force) {
       watcher.forceStop();
     } else {
       await watcher.stop();
     }
-    if (existsSync10(PID_FILE)) unlinkSync3(PID_FILE);
+    if (existsSync11(PID_FILE2)) unlinkSync4(PID_FILE2);
     process.exit(0);
   };
   process.on("SIGINT", () => {
@@ -4577,7 +4934,7 @@ var watchCommand = new Command10("watch").description("Watch for work and spawn
   await new Promise(() => {
   });
 });
-function isProcessRunning(pid) {
+function isProcessRunning2(pid) {
   try {
     process.kill(pid, 0);
     return true;
@@ -4587,88 +4944,88 @@ function isProcessRunning(pid) {
 }
 
 // src/commands/queue.ts
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 import { resolve as resolve9 } from "path";
-import chalk12 from "chalk";
-var queueCommand = new Command11("queue").description("Show pipeline state \u2014 what's ready, blocked, and pending").action(async () => {
+import chalk13 from "chalk";
+var queueCommand = new Command12("queue").description("Show pipeline state \u2014 what's ready, blocked, and pending").action(async () => {
   const creds = requireAuth();
   const cwd = resolve9(process.cwd());
   const mapping = getProjectMapping(cwd);
   if (!mapping) {
     console.error(
-      chalk12.red("No project linked.") + " Run " + chalk12.cyan("yapout link") + " in a repo."
+      chalk13.red("No project linked.") + " Run " + chalk13.cyan("yapout link") + " in a repo."
     );
     process.exit(1);
   }
   const client = createConvexClient(creds.token);
-  const { anyApi: anyApi6 } = await import("convex/server");
+  const { anyApi: anyApi7 } = await import("convex/server");
   const [queueData, unenriched, pending] = await Promise.all([
-    client.query(anyApi6.functions.tickets.getLocalQueuedTickets, {
+    client.query(anyApi7.functions.tickets.getLocalQueuedTickets, {
       projectId: mapping.projectId
     }),
-    client.query(anyApi6.functions.localPipeline.getUnenrichedTickets, {
+    client.query(anyApi7.functions.localPipeline.getUnenrichedTickets, {
       projectId: mapping.projectId
     }),
-    client.query(anyApi6.functions.localPipeline.getPendingSources, {
+    client.query(anyApi7.functions.localPipeline.getPendingSources, {
       projectId: mapping.projectId
     })
   ]);
   console.log();
   if (queueData?.ready && queueData.ready.length > 0) {
-    console.log(chalk12.bold("Ready to implement:"));
+    console.log(chalk13.bold("Ready to implement:"));
     for (const t of queueData.ready) {
       const ref = t.linearTicketId ?? t.ticketId;
       const prio = colorPriority(t.priority);
       console.log(
-        `  ${chalk12.bold(ref)}  ${t.title.slice(0, 45).padEnd(45)}  ${prio}  ${chalk12.dim(t.type)}`
+        `  ${chalk13.bold(ref)}  ${t.title.slice(0, 45).padEnd(45)}  ${prio}  ${chalk13.dim(t.type)}`
       );
     }
     console.log();
   }
   if (queueData?.blocked && queueData.blocked.length > 0) {
-    console.log(chalk12.bold("Blocked:"));
+    console.log(chalk13.bold("Blocked:"));
     for (const t of queueData.blocked) {
       console.log(
-        `  ${chalk12.bold(t.ticketId.slice(-6))}  ${t.title.slice(0, 45)}  ${chalk12.red("blocked by " + t.blockedBy.map((id) => id.slice(-6)).join(", "))}`
+        `  ${chalk13.bold(t.ticketId.slice(-6))}  ${t.title.slice(0, 45)}  ${chalk13.red("blocked by " + t.blockedBy.map((id) => id.slice(-6)).join(", "))}`
       );
     }
     console.log();
   }
   if (unenriched && unenriched.length > 0) {
-    console.log(chalk12.bold("Needs enrichment:"));
+    console.log(chalk13.bold("Needs enrichment:"));
     for (const t of unenriched) {
       const ref = t.ticketId;
       console.log(
-        `  ${chalk12.bold(ref.slice(-6))}  ${t.title.slice(0, 45).padEnd(45)}  ${chalk12.dim(t.priority)}`
+        `  ${chalk13.bold(ref.slice(-6))}  ${t.title.slice(0, 45).padEnd(45)}  ${chalk13.dim(t.priority)}`
       );
     }
     console.log();
   }
   if (pending && pending.length > 0) {
-    console.log(chalk12.bold("Pending extraction:"));
+    console.log(chalk13.bold("Pending extraction:"));
     for (const t of pending) {
       const ago = formatAgo(Date.now() - t.createdAt);
       console.log(
-        `  "${t.meetingTitle ?? "Untitled"}" ${chalk12.dim(`(uploaded ${ago})`)}`
+        `  "${t.meetingTitle ?? "Untitled"}" ${chalk13.dim(`(uploaded ${ago})`)}`
       );
     }
     console.log();
   }
   if ((!queueData?.ready || queueData.ready.length === 0) && (!unenriched || unenriched.length === 0) && (!pending || pending.length === 0)) {
-    console.log(chalk12.dim("Queue is empty. Upload a transcript to get started."));
+    console.log(chalk13.dim("Queue is empty. Upload a transcript to get started."));
     console.log();
   }
 });
 function colorPriority(p) {
   switch (p) {
     case "urgent":
-      return chalk12.red(p);
+      return chalk13.red(p);
     case "high":
-      return chalk12.yellow(p);
+      return chalk13.yellow(p);
     case "medium":
-      return chalk12.white(p);
+      return chalk13.white(p);
     case "low":
-      return chalk12.dim(p);
+      return chalk13.dim(p);
     default:
       return p;
   }
@@ -4684,29 +5041,29 @@ function formatAgo(ms) {
 }
 
 // src/commands/next.ts
-import { Command as Command12 } from "commander";
+import { Command as Command13 } from "commander";
 import { resolve as resolve10 } from "path";
-import { writeFileSync as writeFileSync10 } from "fs";
-import { join as join12 } from "path";
-import chalk13 from "chalk";
-var nextCommand = new Command12("next").description("Claim the highest priority ticket and set up for implementation").option("--worktree", "Create a git worktree instead of checking out a branch").action(async (opts) => {
+import { writeFileSync as writeFileSync11 } from "fs";
+import { join as join13 } from "path";
+import chalk14 from "chalk";
+var nextCommand = new Command13("next").description("Claim the highest priority ticket and set up for implementation").option("--worktree", "Create a git worktree instead of checking out a branch").action(async (opts) => {
   const creds = requireAuth();
   const cwd = resolve10(process.cwd());
   const mapping = getProjectMapping(cwd);
   if (!mapping) {
     console.error(
-      chalk13.red("No project linked.") + " Run " + chalk13.cyan("yapout link") + " in a repo."
+      chalk14.red("No project linked.") + " Run " + chalk14.cyan("yapout link") + " in a repo."
     );
     process.exit(1);
   }
   const client = createConvexClient(creds.token);
-  const { anyApi: anyApi6 } = await import("convex/server");
+  const { anyApi: anyApi7 } = await import("convex/server");
   const data = await client.query(
-    anyApi6.functions.tickets.getLocalQueuedTickets,
+    anyApi7.functions.tickets.getLocalQueuedTickets,
     { projectId: mapping.projectId }
   );
   if (!data?.ready || data.ready.length === 0) {
-    console.log(chalk13.dim("No tickets ready for implementation."));
+    console.log(chalk14.dim("No tickets ready for implementation."));
     return;
   }
   const ticket = data.ready[0];
@@ -4714,32 +5071,32 @@ var nextCommand = new Command12("next").description("Claim the highest priority
   const config = readYapoutConfig(cwd);
   const defaultBranch = getDefaultBranch(cwd);
   const branchName = `${config.branch_prefix}/${ref.toLowerCase().replace(/\s+/g, "-")}-${ticket.title.toLowerCase().replace(/[^a-z0-9]+/g, "-").slice(0, 40)}`;
-  console.log(chalk13.bold(`
+  console.log(chalk14.bold(`
 Claimed: ${ref} "${ticket.title}"`));
   fetchOrigin(cwd);
   let workDir = cwd;
   if (opts.worktree) {
     const { createWorktree: createWorktree2 } = await import("./worktree-ZZZIL7TK.js");
     workDir = createWorktree2(cwd, ticket.ticketId, branchName, defaultBranch);
-    console.log(`Worktree: ${chalk13.cyan(workDir)}`);
+    console.log(`Worktree: ${chalk14.cyan(workDir)}`);
   } else {
     checkoutNewBranch(branchName, defaultBranch, cwd);
   }
-  console.log(`Branch: ${chalk13.cyan(branchName)}`);
+  console.log(`Branch: ${chalk14.cyan(branchName)}`);
   const brief = await client.query(
-    anyApi6.functions.tickets.getTicketBrief,
+    anyApi7.functions.tickets.getTicketBrief,
     { ticketId: ticket.ticketId }
   );
   if (brief) {
-    const briefPath = join12(workDir, ".yapout", "brief.md");
+    const briefPath = join13(workDir, ".yapout", "brief.md");
     const briefContent = formatBrief(ref, ticket, brief);
-    writeFileSync10(briefPath, briefContent);
-    console.log(`Brief: ${chalk13.cyan(briefPath)}`);
+    writeFileSync11(briefPath, briefContent);
+    console.log(`Brief: ${chalk14.cyan(briefPath)}`);
   }
   console.log();
   console.log("Start Claude Code to implement, or run:");
   console.log(
-    chalk13.cyan(
+    chalk14.cyan(
       `  claude --dangerously-skip-permissions "Read .yapout/brief.md, implement it, run yapout_check, then yapout_ship"`
     )
   );
@@ -4789,21 +5146,21 @@ function formatBrief(ref, ticket, brief) {
 }
 
 // src/commands/recap.ts
-import { Command as Command13 } from "commander";
+import { Command as Command14 } from "commander";
 import { resolve as resolve11 } from "path";
-import chalk14 from "chalk";
-var recapCommand = new Command13("recap").description("Show a summary of recent yapout activity").option("--week", "Show full week summary (default: today)").action(async (opts) => {
+import chalk15 from "chalk";
+var recapCommand = new Command14("recap").description("Show a summary of recent yapout activity").option("--week", "Show full week summary (default: today)").action(async (opts) => {
   const creds = requireAuth();
   const cwd = resolve11(process.cwd());
   const mapping = getProjectMapping(cwd);
   if (!mapping) {
     console.error(
-      chalk14.red("No project linked.") + " Run " + chalk14.cyan("yapout link") + " in a repo."
+      chalk15.red("No project linked.") + " Run " + chalk15.cyan("yapout link") + " in a repo."
     );
     process.exit(1);
   }
   const client = createConvexClient(creds.token);
-  const { anyApi: anyApi6 } = await import("convex/server");
+  const { anyApi: anyApi7 } = await import("convex/server");
   const now = /* @__PURE__ */ new Date();
   const todayStart = new Date(
     now.getFullYear(),
@@ -4813,33 +5170,33 @@ var recapCommand = new Command13("recap").description("Show a summary of recent
   const weekStart = todayStart - 6 * 24 * 60 * 60 * 1e3;
   const since = opts.week ? weekStart : todayStart;
   const data = await client.query(
-    anyApi6.functions.localPipeline.getRecentActivity,
+    anyApi7.functions.localPipeline.getRecentActivity,
     { projectId: mapping.projectId, since }
   );
   if (!data) {
-    console.log(chalk14.dim("Could not fetch activity data."));
+    console.log(chalk15.dim("Could not fetch activity data."));
     return;
   }
   const period = opts.week ? "This week" : "Today";
   console.log();
-  console.log(chalk14.bold(`${period}:`));
+  console.log(chalk15.bold(`${period}:`));
   if (data.recentTickets.length > 0) {
     for (const t of data.recentTickets) {
       const ref = t.linearTicketId ?? "ticket";
-      console.log(`  ${chalk14.green("\u2713")} ${ref}  ${t.title}`);
+      console.log(`  ${chalk15.green("\u2713")} ${ref}  ${t.title}`);
     }
   }
   if (data.recentPRs.length > 0) {
     for (const p of data.recentPRs) {
       const prRef = p.githubPrNumber ? `PR #${p.githubPrNumber}` : "PR";
-      const statusColor = p.status === "opened" ? chalk14.green : p.status === "draft" ? chalk14.dim : chalk14.yellow;
+      const statusColor = p.status === "opened" ? chalk15.green : p.status === "draft" ? chalk15.dim : chalk15.yellow;
       console.log(
         `  ${statusColor("\u2191")} ${p.prTitle.slice(0, 45)}  ${statusColor(prRef)}  ${statusColor(p.status)}`
       );
     }
   }
   if (data.recentTickets.length === 0 && data.recentPRs.length === 0) {
-    console.log(chalk14.dim("  No activity yet."));
+    console.log(chalk15.dim("  No activity yet."));
   }
   console.log();
   console.log(
@@ -4849,12 +5206,12 @@ var recapCommand = new Command13("recap").description("Show a summary of recent
 });
 
 // src/commands/yap.ts
-import { Command as Command14 } from "commander";
-import chalk15 from "chalk";
-var yapCommand = new Command14("yap").description(
+import { Command as Command15 } from "commander";
+import chalk16 from "chalk";
+var yapCommand = new Command15("yap").description(
   "Start a yap session \u2014 brainstorm with an AI that knows your codebase"
 ).action(() => {
-  console.log(chalk15.bold("yapout yap sessions"));
+  console.log(chalk16.bold("yapout yap sessions"));
   console.log();
   console.log(
     "Yap sessions run inside Claude \u2014 Desktop, CLI, or web \u2014 anywhere the"
@@ -4863,27 +5220,27 @@ var yapCommand = new Command14("yap").description(
   console.log();
   console.log("Just tell Claude:");
   console.log(
-    chalk15.green(`  "Let's have a yap session about [topic]"`)
+    chalk16.green(`  "Let's have a yap session about [topic]"`)
   );
   console.log(
-    chalk15.green(
+    chalk16.green(
       '  "I want to brainstorm [idea] \u2014 be a skeptical QA engineer"'
     )
   );
   console.log();
-  console.log(chalk15.dim("Personas: tech lead, qa engineer, product owner, end user, or custom"));
+  console.log(chalk16.dim("Personas: tech lead, qa engineer, product owner, end user, or custom"));
   console.log(
-    chalk15.dim(
+    chalk16.dim(
       "Claude will call yapout_start_yap to get instructions and yapout_submit_yap_session when done."
     )
   );
 });
 
 // src/commands/handle-uri.ts
-import { Command as Command15 } from "commander";
-import { spawn as spawn2 } from "child_process";
-import { platform as platform2 } from "os";
-import chalk16 from "chalk";
+import { Command as Command16 } from "commander";
+import { spawn as spawn3 } from "child_process";
+import { platform as platform3 } from "os";
+import chalk17 from "chalk";
 var VALID_ACTIONS = ["claim", "enrich", "enrich-bulk", "enrich-bundle", "yap", "compact"];
 function parseYapoutUri(raw) {
   const url = new URL(raw);
@@ -4996,11 +5353,11 @@ function findProjectDir() {
   return dirs[0];
 }
 function launchTerminal(cwd, claudeArgs) {
-  const os = platform2();
+  const os = platform3();
   const claudeCmd = `claude ${claudeArgs.map(shellEscape).join(" ")}`;
   if (os === "win32") {
     const wtArgs = ["wt", "-d", cwd, "cmd", "/k", claudeCmd];
-    const child = spawn2("cmd", ["/c", "start", ...wtArgs], {
+    const child = spawn3("cmd", ["/c", "start", ...wtArgs], {
       cwd,
       stdio: "ignore",
       detached: true,
@@ -5008,7 +5365,7 @@ function launchTerminal(cwd, claudeArgs) {
     });
     child.unref();
     child.on("error", () => {
-      const fallback = spawn2(
+      const fallback = spawn3(
         "cmd",
         ["/c", "start", "cmd", "/k", claudeCmd],
         { cwd, stdio: "ignore", detached: true, shell: true }
@@ -5021,7 +5378,7 @@ function launchTerminal(cwd, claudeArgs) {
   activate
   do script "cd ${shellEscape(cwd)} && ${escaped}"
 end tell`;
-    const child = spawn2("osascript", ["-e", script], {
+    const child = spawn3("osascript", ["-e", script], {
       stdio: "ignore",
       detached: true
     });
@@ -5036,7 +5393,7 @@ end tell`;
     let launched = false;
     for (const term of terminals) {
       try {
-        const child = spawn2(term.cmd, term.args, {
+        const child = spawn3(term.cmd, term.args, {
           stdio: "ignore",
           detached: true
         });
@@ -5049,44 +5406,44 @@ end tell`;
     }
     if (!launched) {
       console.error(
-        chalk16.red("Could not find a terminal emulator. Install gnome-terminal, konsole, or xterm.")
+        chalk17.red("Could not find a terminal emulator. Install gnome-terminal, konsole, or xterm.")
       );
       process.exit(1);
     }
   }
 }
 function shellEscape(s) {
-  if (platform2() === "win32") {
+  if (platform3() === "win32") {
     return `"${s.replace(/"/g, '""')}"`;
   }
   return `'${s.replace(/'/g, "'\\''")}'`;
 }
-var handleUriCommand = new Command15("handle-uri").description("Handle a yapout:// URI (used by OS protocol handler)").argument("<uri>", "The yapout:// URI to handle").action(async (uri) => {
+var handleUriCommand = new Command16("handle-uri").description("Handle a yapout:// URI (used by OS protocol handler)").argument("<uri>", "The yapout:// URI to handle").action(async (uri) => {
   try {
     const parsed = parseYapoutUri(uri);
     const prompt = buildPrompt(parsed);
     const cwd = findProjectDir();
     if (!cwd) {
       console.error(
-        chalk16.red(
+        chalk17.red(
           "No linked project found. Run `yapout init` or `yapout link` in your repo first."
         )
       );
       process.exit(1);
     }
     const label = parsed.ticketId ? `${parsed.action} ${parsed.ticketId}` : parsed.action;
-    console.log(chalk16.dim(`Launching Claude Code to ${label}...`));
+    console.log(chalk17.dim(`Launching Claude Code to ${label}...`));
     launchTerminal(cwd, ["--dangerously-skip-permissions", prompt]);
     setTimeout(() => process.exit(0), 500);
   } catch (err) {
-    console.error(chalk16.red(err.message));
+    console.error(chalk17.red(err.message));
     process.exit(1);
   }
 });
 
 // src/index.ts
-var program = new Command16();
-program.name("yapout").description("yapout \u2014 from meeting transcript to merged PR").version("0.7.0");
+var program = new Command17();
+program.name("yapout").description("yapout \u2014 from meeting transcript to merged PR").version("0.9.0");
 program.addCommand(loginCommand);
 program.addCommand(logoutCommand);
 program.addCommand(initCommand);
@@ -5102,4 +5459,5 @@ program.addCommand(nextCommand);
 program.addCommand(recapCommand);
 program.addCommand(yapCommand);
 program.addCommand(handleUriCommand);
+program.addCommand(serveCommand);
 program.parse();