cubefarm 0.1.0 → 0.2.0

package/dist-server/index.js

@@ -1,7 +1,7 @@
 // server/index.ts
 import http2 from "node:http";
-import path7 from "node:path";
-import fs5 from "node:fs";
+import path8 from "node:path";
+import fs6 from "node:fs";
 import express from "express";
 import { WebSocketServer } from "ws";
 
@@ -154,6 +154,25 @@ async function createIssue(fullName, title, body, labels = []) {
   if (!match) throw new Error(`Could not read the new issue number from gh output: ${out}`);
   return Number(match[1]);
 }
+async function issueState(fullName, number) {
+  try {
+    const raw = await ghJson(["issue", "view", String(number), "-R", fullName, "--json", "state"]);
+    return raw.state === "OPEN" ? "OPEN" : "CLOSED";
+  } catch {
+    return null;
+  }
+}
+async function editIssue(fullName, number, edit) {
+  const args = ["issue", "edit", String(number), "-R", fullName];
+  if (edit.body !== void 0) args.push("--body-file", "-");
+  for (const l of edit.addLabels ?? []) {
+    await ensureLabel(fullName, l);
+    args.push("--add-label", l);
+  }
+  for (const l of edit.removeLabels ?? []) args.push("--remove-label", l);
+  if (args.length === 5) return;
+  await gh(args, edit.body !== void 0 ? { input: edit.body || " " } : void 0);
+}
 async function mergePull(fullName, number, method, headSha) {
   const pr = await ghJson(["pr", "view", String(number), "-R", fullName, "--json", "headRefName,isCrossRepository"]);
   await gh(["pr", "merge", String(number), "-R", fullName, `--${method}`, ...headSha ? ["--match-head-commit", headSha] : []], { timeoutMs: 6e4 });
@@ -282,37 +301,40 @@ async function syncMain(fullName, defaultBranch, opts) {
   const result = await withRepoLock(fullName, async () => {
     if (!await exists(path2.join(dir, ".git"))) return null;
     const g = (args, timeoutMs) => git(args, { cwd: dir, timeoutMs });
+    let behind = 0;
     try {
       await g(["fetch", "origin", "--prune"], 18e4);
       const target = `origin/${defaultBranch}`;
-      const behind = Number(await g(["rev-list", "--count", `HEAD..${target}`]));
+      behind = Number(await g(["rev-list", "--count", `HEAD..${target}`]));
       const commits = `${behind} commit${behind === 1 ? "" : "s"}`;
       const branch = await g(["symbolic-ref", "--short", "-q", "HEAD"]).catch(() => "");
-      if (branch !== defaultBranch) return { status: `on ${branch ? `branch ${branch}` : "a detached HEAD"}${behind ? ` (${defaultBranch} is ${commits} ahead)` : ""}` };
-      if (behind === 0) return { status: "in sync" };
-      if (Number(await g(["rev-list", "--count", `${target}..HEAD`])) > 0) return { status: `diverged: local commits, and ${commits} to pull` };
-      if (!opts.touch) return { status: `update ready (${commits})` };
-      if (await g(["status", "--porcelain", "--untracked-files=no"])) return { status: `${behind} behind: local changes` };
+      const stays = (status) => ({ status, behind, updatable: false });
+      if (branch !== defaultBranch) return stays(`on ${branch ? `branch ${branch}` : "a detached HEAD"}${behind ? ` (${defaultBranch} is ${commits} ahead)` : ""}`);
+      if (behind === 0) return stays("in sync");
+      if (Number(await g(["rev-list", "--count", `${target}..HEAD`])) > 0) return stays(`diverged: local commits, and ${commits} to pull`);
+      if (!opts.touch) return { status: `update ready (${commits})`, behind, updatable: true };
+      if (await g(["status", "--porcelain", "--untracked-files=no"])) return { status: `${behind} behind: local changes`, behind, updatable: true };
       const before = await g(["rev-parse", "HEAD"]);
       try {
         await g(["merge", "--ff-only", target], 12e4);
       } catch {
-        return { status: `${behind} behind: local files are in the way` };
+        return { status: `${behind} behind: local files are in the way`, behind, updatable: true };
       }
       const changed = (await g(["diff", "--name-only", before, "HEAD"])).split(/\r?\n/);
       const install = changed.some((f) => f === "package.json" || f === "package-lock.json") && await exists(path2.join(dir, "package.json"));
-      return { status: `updated to ${await g(["rev-parse", "--short", "HEAD"])}`, install };
+      return { status: `updated to ${await g(["rev-parse", "--short", "HEAD"])}`, behind: 0, updatable: false, install };
     } catch (err) {
-      return { status: `sync failed: ${err.message.split(/\r?\n/)[0].slice(0, 160)}` };
+      return { status: `sync failed: ${err.message.split(/\r?\n/)[0].slice(0, 160)}`, behind, updatable: false };
     }
   });
-  if (!result?.install) return result?.status ?? null;
+  if (!result?.install) return result;
+  const { install: _install, ...sync } = result;
   try {
     await npmInstall(dir);
-    return `${result.status} \xB7 dependencies installed`;
+    return { ...sync, status: `${sync.status} \xB7 dependencies installed` };
   } catch (err) {
     console.warn(`npm install in ${dir} failed:`, err.message);
-    return `${result.status} \xB7 npm install failed`;
+    return { ...sync, status: `${sync.status} \xB7 npm install failed` };
   }
 }
 function githubFromConfig(config) {
@@ -632,6 +654,8 @@ function describeOfficeTool(action, input) {
       return `\u{1F44B} propose_let_go ${String(input.agent_id ?? "")}`;
     case "file_issue":
       return `\u{1F4DD} file_issue "${clip(String(input.title ?? ""), 70)}"${floor}${input.specialty ? ` \xB7 ${input.specialty}` : ""}`;
+    case "route_issue":
+      return `\u{1F500} route_issue #${String(input.number ?? "?")}${floor}${input.specialty !== void 0 ? ` \xB7 ${input.specialty || "no specialty"}` : ""}${Array.isArray(input.depends_on) ? ` \xB7 depends on ${input.depends_on.map((n) => `#${n}`).join(", ") || "nothing"}` : ""}`;
   }
   return `\u{1F3E2} ${action}(${clip(JSON.stringify(input), 120)})`;
 }
@@ -764,6 +788,9 @@ function startSession(opts, callbacks, defaultBranch) {
           cb.log([{ kind: "error", text: `\u26A0 Subscription usage ${info.status === "rejected" ? "limit reached" : "warning"} (${info.rateLimitType ?? "limit"}) \xB7 resets ${when}` }]);
           const overage = info.isUsingOverage || info.overageStatus === "allowed" || info.overageStatus === "allowed_warning";
           if (info.status === "rejected" && !overage) cb.limited?.(info.resetsAt ? info.resetsAt * 1e3 : null);
+          if (info.status === "allowed_warning" && !overage) {
+            cb.usageWarning?.({ resetsAt: info.resetsAt ? info.resetsAt * 1e3 : null, rateLimitType: info.rateLimitType ?? null, utilization: info.utilization ?? null });
+          }
         }
         break;
       }
@@ -1051,6 +1078,71 @@ var realPreviews = {
   hasDefault: async (fullName) => fs3.access(path4.join(mainDir(fullName), "package.json")).then(() => true).catch(() => false)
 };
 
+// server/officeUpdate.ts
+import fs4 from "node:fs/promises";
+import path5 from "node:path";
+var DRAIN_TIMEOUT_MS = 20 * 6e4;
+var POSTPONE_MS = 2 * 60 * 6e4;
+function underLauncher(proc = process) {
+  return typeof proc.send === "function" && proc.env.SWARM_LAUNCHER === "1";
+}
+function drainDecision(s) {
+  const idle = (state) => ({ state, drainingSince: null, send: false, timedOut: false });
+  if (s.sent) return { state: "updating", drainingSince: s.drainingSince, send: false, timedOut: false };
+  if (s.behind <= 0) return idle("none");
+  if (!s.launcher) return idle(s.failed ? "failed" : "available");
+  const postponed = s.postponedUntil !== null && s.now < s.postponedUntil && s.behind <= s.postponedBehind;
+  const failedHold = s.failed !== null && s.behind <= (s.failedBehind ?? Infinity);
+  const due = s.requested || s.autoUpdate && !postponed && !failedHold;
+  if (!due) return idle(s.failed ? "failed" : s.autoUpdate && postponed ? "waiting" : "available");
+  const since = s.drainingSince ?? s.now;
+  const timedOut = s.running > 0 && s.now - since >= DRAIN_TIMEOUT_MS;
+  return { state: "draining", drainingSince: since, send: s.running === 0 || timedOut, timedOut };
+}
+function parseLastUpdate(raw) {
+  try {
+    const u = JSON.parse(raw);
+    if (!u || typeof u.from !== "string" || typeof u.ok !== "boolean") return null;
+    return {
+      from: u.from,
+      to: typeof u.to === "string" ? u.to : "",
+      ok: u.ok,
+      error: typeof u.error === "string" ? u.error : void 0,
+      installed: !!u.installed,
+      built: !!u.built,
+      at: Number(u.at) || Date.now()
+    };
+  } catch {
+    return null;
+  }
+}
+async function takeLastUpdate(home) {
+  const file = path5.join(home, "last-update.json");
+  const raw = await fs4.readFile(file, "utf8").catch(() => null);
+  if (raw === null) return null;
+  await fs4.rm(file, { force: true, maxRetries: 3 }).catch(() => void 0);
+  return parseLastUpdate(raw);
+}
+function lastUpdateMessage(u, commits) {
+  if (!u.ok) return `\u26A0\uFE0F Update failed and was rolled back: ${u.error || "unknown error"}`;
+  const n = commits === null ? "" : ` (${commits} commit${commits === 1 ? "" : "s"})`;
+  return `\u2B06\uFE0F Updated the office from ${u.from.slice(0, 7)} to ${u.to.slice(0, 7)}${n}`;
+}
+var OFFICE_DIR = path5.resolve(import.meta.dirname, "..");
+var isSamePath = (a, b) => process.platform === "win32" ? path5.resolve(a).toLowerCase() === path5.resolve(b).toLowerCase() : path5.resolve(a) === path5.resolve(b);
+var realOffice = {
+  launcher: underLauncher(),
+  head: () => git(["rev-parse", "HEAD"], { cwd: OFFICE_DIR }).catch(() => null),
+  isOwnFolder: (dir) => isSamePath(dir, OFFICE_DIR),
+  commitsBetween: (from, to) => git(["rev-list", "--count", `${from}..${to}`], { cwd: OFFICE_DIR }).then(Number).catch(() => null),
+  takeLastUpdate: () => takeLastUpdate(HOME_DIR),
+  async update(from) {
+    if (!underLauncher()) throw new Error("The office was not started by the launcher");
+    await new Promise((resolve, reject) => process.send({ type: "office:update", from }, void 0, {}, (err) => err ? reject(err) : resolve()));
+    return null;
+  }
+};
+
 // server/backend.ts
 var realBackend = {
   demo: false,
@@ -1060,6 +1152,8 @@ var realBackend = {
   listIssues,
   listPulls,
   createIssue,
+  issueState,
+  editIssue,
   mergePull,
   updateBranch,
   closePull,
@@ -1081,13 +1175,14 @@ var realBackend = {
   removeDesk,
   releaseDesk,
   startSession,
-  previews: realPreviews
+  previews: realPreviews,
+  office: realOffice
 };
 
 // server/demo.ts
 import crypto2 from "node:crypto";
 import http from "node:http";
-import path5 from "node:path";
+import path6 from "node:path";
 var now = () => (/* @__PURE__ */ new Date()).toISOString();
 function issue(n, title, body, fullName, labels = []) {
   return { number: n, title, body, url: `https://github.com/${fullName}/issues/${n}`, labels, createdAt: now() };
@@ -1095,6 +1190,7 @@ function issue(n, title, body, fullName, labels = []) {
 var repos = /* @__PURE__ */ new Map();
 var bareRepos = /* @__PURE__ */ new Set();
 var mergedSinceSync = /* @__PURE__ */ new Map();
+var closedIssues = /* @__PURE__ */ new Set();
 var fakeSha = () => crypto2.randomBytes(20).toString("hex");
 function runChecks(pr, fail = Math.random() < 0.2) {
   Object.assign(pr, { checks: "pending", pendingChecks: ["CI / build", "Vercel"], failedChecks: [] });
@@ -1139,7 +1235,7 @@ function screenshotSvg(title, url, hue) {
 </svg>`;
 }
 function devScript(opts, cb, issueNumber, issueTitle) {
-  const branch = path5.basename(opts.cwd);
+  const branch = path6.basename(opts.cwd);
   const hue = issueNumber * 67 % 360;
   const file = ["src/App.tsx", "src/components/TodoList.tsx", "src/api/routes.ts", "src/styles.css"][issueNumber % 4];
   const port = 5200 + issueNumber % 50;
@@ -1277,7 +1373,7 @@ function fakeSession(opts, cb, fullName) {
         number: n,
         title,
         url,
-        headRefName: `swarm/issue-${number}-${path5.basename(opts.cwd).replace(/-[0-9a-f]{4}$/, "")}`,
+        headRefName: `swarm/issue-${number}-${path6.basename(opts.cwd).replace(/-[0-9a-f]{4}$/, "")}`,
         state: "OPEN",
         isDraft: false,
         mergeable: "MERGEABLE",
@@ -1329,6 +1425,16 @@ function fakeSession(opts, cb, fullName) {
     }
   };
 }
+var USAGE_WARNING_AT = 4;
+var USAGE_WARNING_MS = 5 * 6e4;
+var sessionsStarted = 0;
+function fakeUsageWarning(cb) {
+  setTimeout(() => {
+    const resetsAt = Date.now() + USAGE_WARNING_MS;
+    cb.log([{ kind: "error", text: `\u26A0 Subscription usage warning (five_hour) \xB7 resets ${new Date(resetsAt).toLocaleTimeString()} (demo)` }]);
+    cb.usageWarning?.({ resetsAt, rateLimitType: "five_hour", utilization: 0.82 });
+  }, 3e3);
+}
 function createDemoBackend() {
   const deskRepo = /* @__PURE__ */ new Map();
   const folders = /* @__PURE__ */ new Map();
@@ -1379,6 +1485,16 @@ function createDemoBackend() {
       r.issues.push(issue(n, title, body, fullName, labels));
       return n;
     },
+    issueState: async (fullName, number) => {
+      const r = repos.get(fullName);
+      return r?.issues.some((i) => i.number === number) ? "OPEN" : closedIssues.has(`${fullName}#${number}`) ? "CLOSED" : null;
+    },
+    editIssue: async (fullName, number, edit) => {
+      const i = repos.get(fullName)?.issues.find((x) => x.number === number);
+      if (!i) throw new Error(`Unknown issue #${number}`);
+      if (edit.body !== void 0) i.body = edit.body;
+      i.labels = [...i.labels.filter((l) => !edit.removeLabels?.includes(l)), ...(edit.addLabels ?? []).filter((l) => !i.labels.includes(l))];
+    },
     mergePull: async (fullName, number, _method, headSha) => {
       const r = repos.get(fullName);
       const pr = r?.pulls.find((p) => p.number === number);
@@ -1387,6 +1503,7 @@ function createDemoBackend() {
       mergedSinceSync.set(fullName, (mergedSinceSync.get(fullName) ?? 0) + 1);
       pr.state = "MERGED";
       pr.mergedAt = now();
+      for (const n of pr.closesIssues) closedIssues.add(`${fullName}#${n}`);
       r.issues = r.issues.filter((i) => !pr.closesIssues.includes(i.number));
     },
     updateBranch: async (fullName, number) => {
@@ -1428,10 +1545,10 @@ Closes #${pr.closesIssues[0] ?? "?"}`,
     ensureClone: async () => new Promise((r) => setTimeout(r, 400)),
     syncMain: async (fullName, _branch, { touch }) => {
       const behind = mergedSinceSync.get(fullName) ?? 0;
-      if (behind === 0) return "in sync";
-      if (!touch) return `update ready (${behind} commit${behind === 1 ? "" : "s"})`;
+      if (behind === 0) return { status: "in sync", behind: 0, updatable: false };
+      if (!touch) return { status: `update ready (${behind} commit${behind === 1 ? "" : "s"})`, behind, updatable: true };
       mergedSinceSync.set(fullName, 0);
-      return `updated to ${fakeSha().slice(0, 7)}`;
+      return { status: `updated to ${fakeSha().slice(0, 7)}`, behind: 0, updatable: false };
     },
     mainDir: (fullName) => `/demo/${fullName}/main`,
     deskDir: (fullName, slug) => `/demo/${fullName}/desks/${slug}`,
@@ -1443,10 +1560,32 @@ Closes #${pr.closesIssues[0] ?? "?"}`,
     },
     removeDesk: async () => void 0,
     releaseDesk: async () => void 0,
-    startSession: (opts, cb) => opts.role === "ceo" ? ceoSession(opts, cb) : fakeSession(opts, cb, deskRepo.get(opts.cwd) ?? [...repos.keys()][0]),
-    previews: demoPreviews
+    startSession: (opts, cb) => {
+      if (++sessionsStarted === USAGE_WARNING_AT) fakeUsageWarning(cb);
+      return opts.role === "ceo" ? ceoSession(opts, cb) : fakeSession(opts, cb, deskRepo.get(opts.cwd) ?? [...repos.keys()][0]);
+    },
+    previews: demoPreviews,
+    office: demoOffice
   };
 }
+var OFFICE_REPO = "demo-co/pixel-todo";
+var DEMO_HEAD = `0ff1ce5${"0".repeat(33)}`;
+var lastFakeUpdate = { to: "", commits: 0 };
+var demoOffice = {
+  launcher: underLauncher() || process.env.SWARM_DEMO_LAUNCHER === "1",
+  head: async () => DEMO_HEAD,
+  isOwnFolder: (dir) => dir === `/demo/${OFFICE_REPO}/main`,
+  // Only its own fake updates have a count; one the real launcher did (u) gets no count rather than a wrong one.
+  commitsBetween: async (_from, to) => to === lastFakeUpdate.to ? lastFakeUpdate.commits : null,
+  takeLastUpdate: () => takeLastUpdate(HOME_DIR),
+  async update(from) {
+    await new Promise((r) => setTimeout(r, 4e3));
+    lastFakeUpdate.commits = mergedSinceSync.get(OFFICE_REPO) ?? 0;
+    mergedSinceSync.set(OFFICE_REPO, 0);
+    lastFakeUpdate.to = fakeSha();
+    return { from, to: lastFakeUpdate.to, ok: true, installed: true, built: true, at: Date.now() };
+  }
+};
 function placeholderPage(title, hue) {
   const safe = title.replace(/[<>&"]/g, "");
   return `<!doctype html>
@@ -1716,6 +1855,13 @@ Acceptance criteria:
           return `Floor ${f.floor} is overstaffed: ${devs} developers for ${f.backlog.length} open issues. I suggest letting ${idle[idle.length - 1].name} go; it's on your phone.`;
         }
       }
+      for (const f of s.floors) {
+        const specialist = f.team.find((a) => a.role === "dev" && a.specialty);
+        const unrouted = f.backlog.find((i) => !i.specialty && !i.inProgress);
+        if (!specialist || !unrouted) continue;
+        const out = await use("route_issue", { floor: f.floor, number: unrouted.number, specialty: specialist.specialty });
+        if (!out.startsWith("Refused")) return `Floor ${f.floor}: #${unrouted.number} had no specialty, so I routed it to ${specialist.specialty}, ${specialist.name}'s lane.`;
+      }
       const issues = s.floors.reduce((n, f) => n + f.backlog.length, 0);
       const prs = s.floors.reduce((n, f) => n + f.pullRequests.length, 0);
       return `All ${s.floors.length} floors look healthy: ${issues} open issues and ${prs} pull requests in flight. No changes needed.`;
@@ -1794,13 +1940,80 @@ Acceptance criteria:
 }
 
 // server/swarm.ts
-import fs4 from "node:fs/promises";
-import path6 from "node:path";
+import fs5 from "node:fs/promises";
+import path7 from "node:path";
 import crypto3 from "node:crypto";
 
 // server/ceo.ts
 import { createSdkMcpServer, tool } from "@anthropic-ai/claude-agent-sdk";
 import { z } from "zod";
+
+// shared/issues.ts
+function issueSpecialty(labels) {
+  const l = labels.find((x) => /^swarm:/i.test(x) && !/^swarm:skip$/i.test(x));
+  return l ? l.slice(6).toLowerCase() : "";
+}
+function blockers(body, open) {
+  const out = /* @__PURE__ */ new Set();
+  for (const m of (body ?? "").matchAll(/\b(?:depends\s+on|blocked\s+by)\s*:?\s*((?:#\d+(?:\s*(?:,|and|&)\s*)?)+)/gi)) {
+    for (const n of m[1].matchAll(/#(\d+)/g)) if (open.has(Number(n[1]))) out.add(Number(n[1]));
+  }
+  return [...out];
+}
+var DEPENDENCY = /\b(?:depends\s+on|blocked\s+by)\s*:?\s*(?:#\d+(?:\s*(?:,|and|&)\s*)?)+/gi;
+var STATEMENT = new RegExp(`\\s*${DEPENDENCY.source}[.;,]?`, "gi");
+function setDependsOn(body, deps) {
+  const lines = [];
+  let dropped = false;
+  for (const line of (body ?? "").split(/\r?\n/)) {
+    const rest2 = line.match(DEPENDENCY) ? line.replace(STATEMENT, "").trimEnd() : line;
+    if (rest2 !== line && !/[\p{L}\p{N}]/u.test(rest2)) {
+      dropped = true;
+      continue;
+    }
+    if (dropped && !rest2.trim() && !lines[lines.length - 1]?.trim()) continue;
+    dropped = false;
+    lines.push(rest2);
+  }
+  while (lines.length && !lines[0].trim()) lines.shift();
+  const rest = lines.join("\n");
+  if (deps.length === 0) return rest;
+  return `Depends on ${deps.map((n) => `#${n}`).join(", ")}${rest ? `
+
+${rest}` : ""}`;
+}
+function holdUps(issues) {
+  const open = new Set(issues.map((i) => i.number));
+  const waiters = /* @__PURE__ */ new Map();
+  for (const i of issues) for (const b of blockers(i.body, open)) waiters.set(b, [...waiters.get(b) ?? [], i.number]);
+  const chains = /* @__PURE__ */ new Map();
+  const visiting = /* @__PURE__ */ new Set();
+  const chain = (n) => {
+    const known = chains.get(n);
+    if (known !== void 0) return known;
+    if (visiting.has(n)) return 0;
+    visiting.add(n);
+    const longest = Math.max(0, ...(waiters.get(n) ?? []).map((w) => chain(w) + 1));
+    visiting.delete(n);
+    chains.set(n, longest);
+    return longest;
+  };
+  const out = /* @__PURE__ */ new Map();
+  for (const i of issues) {
+    const seen = /* @__PURE__ */ new Set();
+    const stack = [...waiters.get(i.number) ?? []];
+    while (stack.length) {
+      const n = stack.pop();
+      if (n === i.number || seen.has(n)) continue;
+      seen.add(n);
+      stack.push(...waiters.get(n) ?? []);
+    }
+    out.set(i.number, { chain: chain(i.number), waiting: seen.size });
+  }
+  return out;
+}
+
+// server/ceo.ts
 var EFFORT = z.enum(["low", "medium", "high", "xhigh", "max"]);
 function createOfficeTools(h) {
   const run2 = async (fn) => {
@@ -1880,6 +2093,17 @@ function createOfficeTools(h) {
         specialty: z.string().max(24).optional()
       },
       (a) => run2(() => h.fileIssue(a))
+    ),
+    tool(
+      "route_issue",
+      'Fix the routing of an open issue instead of filing a duplicate: change its specialty, rewrite its "Depends on #N" line, or both. The rest of the body stays as it is.',
+      {
+        floor: z.number().int(),
+        number: z.number().int().positive().describe("The issue number"),
+        specialty: z.string().max(24).optional().describe('Sets swarm:<specialty> and removes any other; "" for none. Someone on the floor, or a pending proposal, must have it.'),
+        depends_on: z.array(z.number().int().positive()).max(10).optional().describe("Issues it waits for; [] for none. Not for an issue in progress.")
+      },
+      (a) => run2(() => h.routeIssue(a))
     )
   ];
   const server2 = createSdkMcpServer({ name: "office", version: "1.0.0", tools: defs });
@@ -1917,7 +2141,8 @@ function ceoSystemPrompt(o) {
     '- Titles are specific ("Three.js graphics engineer", not "Developer"). A specialty is a short lowercase slug ("graphics", "gameplay", "frontend", "backend", "content", "a11y", "devops"). Only route an issue to a specialty that someone on the floor has, or that you are proposing to hire.',
     "- Before proposing a hire, check the floor and the pending proposals for someone who already covers it. If the manager declined a similar proposal (recentDecisions), do not propose it again unless something has changed, and say what.",
     `- ${o.hiring === "auto" ? "Hiring is on auto: proposals within the team cap are approved immediately, so be deliberate." : "The manager approves every hire, so explain each reason in a sentence or two they can decide on."}`,
-    `- Issues: plan for parallel work. What keeps a floor busy is the number of issues that can start right now (capacity.issuesReadyToStart in company_status); aim for at least one per developer. Write "Depends on #N" only when an issue truly cannot start until #N's code is merged, because it waits until #N is closed. Keep dependency chains to two steps at most, keep foundation issues small, and split big pieces into parts that can be built side by side. The office starts the issues that hold up others first. Do not duplicate open issues. File at most 12 issues per job.`,
+    `- Issues: plan for parallel work. What keeps a floor busy is the number of issues that can start right now (capacity.issuesReadyToStart in company_status); aim for at least one per developer. Write "Depends on #N" only when an issue truly cannot start until #N's code is merged, because it waits until #N is closed. Keep dependency chains to two steps at most, keep foundation issues small, and split big pieces into parts that can be built side by side. The office starts the issues that hold up others first. Do not duplicate open issues: fix an existing issue's specialty or dependencies with route_issue. File at most 12 issues per job, or per message from the manager.`,
+    "- When company.usage in company_status says pacing or paused, Claude's usage is running low and the office is finishing open work first: file only what is needed next, not a whole milestone.",
     "- Your final message goes straight to the manager's phone. Keep it short and plain: what you found, what you proposed, what you filed, and any question you need answered. No headings, no tables."
   ].join("\n");
 }
@@ -1951,7 +2176,7 @@ ${floor.backlog === 0 ? "The backlog is empty: plan the first milestone as issue
       return [
         "Periodic review of the company. For every floor, look at:",
         "- floors without a profile or QA brief: study them and write one",
-        "- backlog against the team (capacity): fewer issues ready to start than free developers, long dependency chains, a specialty with a long queue",
+        "- backlog against the team (capacity): fewer issues ready to start than free developers, long dependency chains, a specialty with a long queue (fix those with route_issue)",
         "- pull requests stuck in QA or marked as needing a human",
         "- floors with a brief and an empty backlog: plan the next milestone",
         "Propose hires or let-gos only when clearly justified. If nothing needs doing, reply with one short sentence saying so."
@@ -1974,6 +2199,81 @@ function jobLabel(job, floor) {
       return "Replying to you";
   }
 }
+var IssueCap = class {
+  // floors that got issues, to refresh when the job ends
+  constructor(max) {
+    this.max = max;
+  }
+  max;
+  filed = 0;
+  // since the job started or the manager's last message
+  total = 0;
+  // in the whole job
+  repos = /* @__PURE__ */ new Set();
+  check() {
+    if (this.filed >= this.max) throw new Error(`You already filed ${this.max} issues in this job. That's plenty for one milestone. The manager's next message allows more.`);
+  }
+  record(repoId2) {
+    this.filed++;
+    this.total++;
+    this.repos.add(repoId2);
+  }
+  managerMessage() {
+    this.filed = 0;
+  }
+};
+function waitsDepth(n, deps, seen = /* @__PURE__ */ new Set()) {
+  if (seen.has(n)) return 0;
+  seen.add(n);
+  const depth = Math.max(0, ...(deps.get(n) ?? []).map((d) => waitsDepth(d, deps, seen) + 1));
+  seen.delete(n);
+  return depth;
+}
+function planRoute(r) {
+  const issue2 = r.issues.find((i) => i.number === r.number);
+  if (!issue2) throw new Error(r.closed(r.number) ? `#${r.number} is closed.` : `There is no open issue #${r.number} on floor ${r.floor}.`);
+  if (r.specialty === void 0 && r.dependsOn === void 0) throw new Error("Nothing to change: pass specialty, depends_on or both.");
+  const plan = { addLabels: [], removeLabels: [], body: null, summary: "" };
+  const done = [];
+  if (r.specialty !== void 0) {
+    const slug = specialtySlug(r.specialty);
+    if (r.specialty.trim() && !slug) throw new Error(`"${r.specialty}" is not a specialty. Use a short lowercase slug, or "" for none.`);
+    if (slug && !r.specialties.includes(slug)) {
+      const have = [...new Set(r.specialties)].join(", ") || "none";
+      throw new Error(`Nobody on floor ${r.floor} has the specialty "${slug}", and no pending proposal does. Specialties there: ${have}.`);
+    }
+    const label = slug ? specialtyLabel(slug) : null;
+    plan.removeLabels = issue2.labels.filter((l) => /^swarm:/i.test(l) && !/^swarm:skip$/i.test(l) && l !== label);
+    if (label && !issue2.labels.includes(label)) plan.addLabels = [label];
+    done.push(slug ? `routed to ${slug}` : "no specialty");
+  }
+  if (r.dependsOn !== void 0) {
+    if (r.inProgress) throw new Error(`#${r.number} is already in progress, so its dependencies can't change. Changing its specialty is fine.`);
+    const deps = [...new Set(r.dependsOn.map(Number))];
+    const open = new Set(r.issues.map((i) => i.number));
+    for (const d of deps) {
+      if (d === r.number) throw new Error(`#${r.number} can't depend on itself.`);
+      if (!open.has(d)) throw new Error(r.closed(d) ? `#${d} is closed, so there's nothing to wait for.` : `There is no open issue #${d} on floor ${r.floor}.`);
+    }
+    const body = setDependsOn(issue2.body, deps);
+    const after = r.issues.map((i) => i.number === r.number ? { ...i, body } : i);
+    const waits = new Map(after.map((i) => [i.number, blockers(i.body, open)]));
+    const loop = deps.find((d) => reaches(d, r.number, waits));
+    if (loop !== void 0) throw new Error(`#${loop} already waits for #${r.number}, directly or through other issues, so that would be a cycle.`);
+    const depth = waitsDepth(r.number, waits) + (holdUps(after).get(r.number)?.chain ?? 0);
+    if (depth > 2) throw new Error(`That makes a dependency chain ${depth} steps deep through #${r.number}. Keep chains to 2 steps at most: split the work so more of it can start side by side.`);
+    if (body !== issue2.body) plan.body = body;
+    done.push(deps.length ? `depends on ${deps.map((d) => `#${d}`).join(", ")}` : "no dependencies");
+  }
+  plan.summary = `#${r.number} on floor ${r.floor}: ${done.join(", ")}.`;
+  return plan;
+}
+function reaches(from, to, waits, seen = /* @__PURE__ */ new Set()) {
+  if (from === to) return true;
+  if (seen.has(from)) return false;
+  seen.add(from);
+  return (waits.get(from) ?? []).some((n) => reaches(n, to, waits, seen));
+}
 function specialtySlug(s) {
   const slug = String(s ?? "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 24);
   return slug === "skip" ? "" : slug;
@@ -1989,6 +2289,38 @@ var HttpError = class extends Error {
   status;
 };
 
+// server/mergeGate.ts
+var MAX_MERGE_FIXES = 3;
+var CHECKS_ALERT_MS = 30 * 6e4;
+var MERGE_RETRY_MS = 10 * 6e4;
+function mergeStep(pr, rec, now2, opts) {
+  if (pr.isDraft) return { do: "wait", note: "a draft: waiting", set: {} };
+  if (!opts.detailed && (pr.mergeable === "UNKNOWN" || pr.mergeState === "UNKNOWN")) return { do: "details", set: {} };
+  const set = {};
+  if (rec.passedSha == null) set.passedSha = pr.headSha;
+  if (pr.headSha !== (set.passedSha ?? rec.passedSha)) return { do: "requeue", set };
+  const needsHuman = rec.mergeFixes >= MAX_MERGE_FIXES;
+  if (pr.mergeable === "CONFLICTING" || pr.mergeState === "DIRTY") {
+    return { do: "send-back", reason: "conflict", instructions: `It conflicts with ${opts.base}.`, needsHuman, set };
+  }
+  if (pr.checks === "failing") {
+    const instructions = pr.failedChecks.map((c) => `- ${c.name}${c.url ? `: ${c.url}` : ""}`).join("\n");
+    return { do: "send-back", reason: "checks", instructions, needsHuman, set };
+  }
+  if (pr.checks === "pending") {
+    const since = rec.pendingSince ?? now2;
+    if (rec.pendingSince == null) set.pendingSince = since;
+    const alert = now2 - since > CHECKS_ALERT_MS && !rec.alerted;
+    if (alert) set.alerted = true;
+    return { do: "wait", note: `waiting for checks: ${pr.pendingChecks.join(", ") || "running"}`, alert, set };
+  }
+  set.pendingSince = null;
+  if (pr.mergeable === "UNKNOWN") return { do: "wait", note: "GitHub is checking it can merge", set };
+  if (pr.mergeState === "BEHIND") return { do: "update-branch", set };
+  if (rec.mergeRetryAt && now2 < rec.mergeRetryAt) return { do: "wait", set };
+  return { do: "merge", set };
+}
+
 // server/previews.ts
 var PREVIEW_BASE_PORT = 6300;
 var LOG_KEEP = 200;
@@ -2189,47 +2521,41 @@ var Previews = class {
   }
 };
 
-// shared/issues.ts
-function issueSpecialty(labels) {
-  const l = labels.find((x) => /^swarm:/i.test(x) && !/^swarm:skip$/i.test(x));
-  return l ? l.slice(6).toLowerCase() : "";
+// server/pacing.ts
+var PACING_MS = 60 * 6e4;
+var DEFAULT_PACING_SESSIONS = 3;
+function mayStart(kind, c) {
+  if (c.now < c.pausedUntil) return false;
+  if (kind === "issue" && c.now < c.pacingUntil) return c.running < c.pacingSessions;
+  return true;
 }
-function blockers(body, open) {
-  const out = /* @__PURE__ */ new Set();
-  for (const m of (body ?? "").matchAll(/\b(?:depends\s+on|blocked\s+by)\s*:?\s*((?:#\d+(?:\s*(?:,|and|&)\s*)?)+)/gi)) {
-    for (const n of m[1].matchAll(/#(\d+)/g)) if (open.has(Number(n[1]))) out.add(Number(n[1]));
-  }
-  return [...out];
+function usageView(c) {
+  if (c.now < c.pausedUntil) return { state: "paused", until: c.pausedUntil };
+  if (c.now < c.pacingUntil) return { state: "pacing", until: c.pacingUntil };
+  return { state: "normal", until: null };
 }
-function holdUps(issues) {
-  const open = new Set(issues.map((i) => i.number));
-  const waiters = /* @__PURE__ */ new Map();
-  for (const i of issues) for (const b of blockers(i.body, open)) waiters.set(b, [...waiters.get(b) ?? [], i.number]);
-  const chains = /* @__PURE__ */ new Map();
-  const visiting = /* @__PURE__ */ new Set();
-  const chain = (n) => {
-    const known = chains.get(n);
-    if (known !== void 0) return known;
-    if (visiting.has(n)) return 0;
-    visiting.add(n);
-    const longest = Math.max(0, ...(waiters.get(n) ?? []).map((w) => chain(w) + 1));
-    visiting.delete(n);
-    chains.set(n, longest);
-    return longest;
-  };
-  const out = /* @__PURE__ */ new Map();
-  for (const i of issues) {
-    const seen = /* @__PURE__ */ new Set();
-    const stack = [...waiters.get(i.number) ?? []];
-    while (stack.length) {
-      const n = stack.pop();
-      if (n === i.number || seen.has(n)) continue;
-      seen.add(n);
-      stack.push(...waiters.get(n) ?? []);
-    }
-    out.set(i.number, { chain: chain(i.number), waiting: seen.size });
-  }
-  return out;
+function clock(at, now2) {
+  const d = new Date(at);
+  const hm = `${String(d.getHours()).padStart(2, "0")}:${String(d.getMinutes()).padStart(2, "0")}`;
+  return d.toDateString() === new Date(now2).toDateString() ? hm : `${d.toLocaleDateString("en-US", { weekday: "short" })} ${hm}`;
+}
+function usageLabel(u, now2) {
+  return u.state === "normal" || u.until === null ? "normal" : `${u.state} until ${clock(u.until, now2)}`;
+}
+function clampPacingSessions(v) {
+  const n = Math.round(Number(v));
+  return Number.isFinite(n) && n > 0 ? Math.min(32, n) : DEFAULT_PACING_SESSIONS;
+}
+var LIMIT_NAMES = {
+  five_hour: "5-hour limit",
+  seven_day: "weekly limit",
+  seven_day_opus: "weekly Opus limit",
+  seven_day_sonnet: "weekly Sonnet limit"
+};
+function pacingMessage(w, until, sessions, now2) {
+  const pct = w.utilization === null ? null : Math.round(w.utilization <= 1 ? w.utilization * 100 : w.utilization);
+  const what = [w.rateLimitType ? LIMIT_NAMES[w.rateLimitType] ?? w.rateLimitType.replace(/_/g, " ") : null, pct === null ? null : `${pct}%`].filter(Boolean).join(", ");
+  return `\u{1F422} Claude's usage is getting high${what ? ` (${what})` : ""}. Until ${clock(until, now2)} the office finishes open work first and starts at most ${sessions} session${sessions === 1 ? "" : "s"} at a time.`;
 }
 
 // shared/types.ts
@@ -2279,8 +2605,8 @@ var EFFORTS = ["low", "medium", "high", "xhigh", "max"];
 var CEO_MODEL = "claude-opus-5-5";
 var CEO_EFFORT = "xhigh";
 var CEO_NAME = "Morgan";
-var CEO_DIR = path6.join(HOME_DIR, "ceo");
-var DEFAULT_PROJECTS_DIR = defaultProjectsDir(path6.resolve(import.meta.dirname, ".."));
+var CEO_DIR = path7.join(HOME_DIR, "ceo");
+var DEFAULT_PROJECTS_DIR = defaultProjectsDir(path7.resolve(import.meta.dirname, ".."));
 var MAX_PENDING_REQUESTS = 8;
 var MAX_ISSUES_PER_JOB = 12;
 var KEEP_MESSAGES = 200;
@@ -2292,20 +2618,15 @@ var FREE = ["idle", "done"];
 var ERROR_COOLDOWN_MS = 2 * 6e4;
 var MAX_ISSUE_FAILURES = 2;
 var LIMIT_PAUSE_MS = 15 * 6e4;
-var MAX_MERGE_FIXES = 3;
-var CHECKS_ALERT_MS = 30 * 6e4;
-var MERGE_RETRY_MS = 10 * 6e4;
-var OFFICE_DIR = path6.resolve(import.meta.dirname, "..");
-var isSamePath = (a, b) => process.platform === "win32" ? path6.resolve(a).toLowerCase() === path6.resolve(b).toLowerCase() : path6.resolve(a) === path6.resolve(b);
 var oneLine = (err) => (err instanceof Error ? err.message : String(err)).split(/\r?\n/)[0].slice(0, 200);
-var SCREENS_DIR = path6.join(HOME_DIR, "screens");
+var SCREENS_DIR = path7.join(HOME_DIR, "screens");
 var MIME_EXT = { "image/png": "png", "image/jpeg": "jpg", "image/webp": "webp", "image/svg+xml": "svg" };
-var screenFile = (agentId, mime) => path6.join(SCREENS_DIR, `${agentId}.${MIME_EXT[mime] ?? "img"}`);
+var screenFile = (agentId, mime) => path7.join(SCREENS_DIR, `${agentId}.${MIME_EXT[mime] ?? "img"}`);
 async function loadScreen(agentId) {
   for (const [mime, ext] of Object.entries(MIME_EXT)) {
-    const file = path6.join(SCREENS_DIR, `${agentId}.${ext}`);
+    const file = path7.join(SCREENS_DIR, `${agentId}.${ext}`);
     try {
-      const [data, stat] = await Promise.all([fs4.readFile(file), fs4.stat(file)]);
+      const [data, stat] = await Promise.all([fs5.readFile(file), fs5.stat(file)]);
       return { data, mime, at: stat.mtimeMs };
     } catch {
     }
@@ -2313,7 +2634,7 @@ async function loadScreen(agentId) {
   return null;
 }
 async function removeScreens(agentId) {
-  await Promise.all(Object.values(MIME_EXT).map((ext) => fs4.rm(path6.join(SCREENS_DIR, `${agentId}.${ext}`), { force: true })));
+  await Promise.all(Object.values(MIME_EXT).map((ext) => fs5.rm(path7.join(SCREENS_DIR, `${agentId}.${ext}`), { force: true })));
 }
 var QA_SCHEMA = {
   type: "object",
@@ -2405,7 +2726,9 @@ var Swarm = class {
       companyName: "",
       projectsDir: DEFAULT_PROJECTS_DIR,
       setupDone: false,
-      tutorialStep: 0
+      tutorialStep: 0,
+      autoUpdate: true,
+      pacingSessions: DEFAULT_PACING_SESSIONS
     },
     repos: [],
     agents: [],
@@ -2427,10 +2750,11 @@ var Swarm = class {
       updateJob: (a) => this.updateJob(a),
       proposeHire: (a) => this.proposeHire(a),
       proposeLetGo: (a) => this.proposeLetGo(a),
-      fileIssue: (a) => this.fileIssue(a)
+      fileIssue: (a) => this.fileIssue(a),
+      routeIssue: (a) => this.routeIssue(a)
     });
   }
-  ceoIssues = { filed: 0, repos: /* @__PURE__ */ new Set() };
+  ceoIssues = new IssueCap(MAX_ISSUES_PER_JOB);
   // issues filed during the current CEO job
   messageSeq = 1;
   agentRt = /* @__PURE__ */ new Map();
@@ -2442,10 +2766,25 @@ var Swarm = class {
   flushTimer = null;
   logSeq = 1;
   previews;
+  officeHead = null;
+  // the commit the office runs (null: not a git checkout, so no self-update)
+  officeUpdate = {
+    behind: 0,
+    requested: false,
+    postponedUntil: null,
+    postponedBehind: 0,
+    failed: null,
+    failedBehind: null,
+    drainingSince: null,
+    sent: false,
+    handedOver: false
+    // sessions cut off by the hand-over are the restarted office's to recover
+  };
+  lastOfficeView = "";
   // ---------- lifecycle ----------
   async init() {
     try {
-      const raw = await fs4.readFile(STATE_FILE, "utf8");
+      const raw = await fs5.readFile(STATE_FILE, "utf8");
       const loaded = JSON.parse(raw);
       this.state = {
         settings: { ...this.state.settings, ...loaded.settings },
@@ -2540,6 +2879,9 @@ var Swarm = class {
     ]);
     for (const r of this.state.repos) void this.previews.refreshDefault(r);
     this.recover(interrupted);
+    this.officeHead = await this.backend.office.head();
+    const updated = await this.backend.office.takeLastUpdate().catch(() => null);
+    if (updated) await this.reportUpdate(updated);
     setInterval(() => this.state.repos.forEach((r, i) => setTimeout(() => void this.syncRepo(r.id), i * 1500)), SYNC_INTERVAL_MS);
     setInterval(() => this.schedule(), SCHEDULER_INTERVAL_MS);
     this.save();
@@ -2660,7 +3002,10 @@ var Swarm = class {
       requests: this.state.requests,
       ceo: this.ceoInfo(),
       messages: this.state.messages.slice(-100),
-      phoneReadAt: this.state.phoneReadAt
+      phoneReadAt: this.state.phoneReadAt,
+      usage: this.usageNow(),
+      officeCommit: this.officeHead?.slice(0, 7) ?? null,
+      officeUpdate: this.officeHead ? this.officeUpdateView() : void 0
     };
   }
   screenshot(agentId) {
@@ -2719,14 +3064,17 @@ var Swarm = class {
   // ---------- persistence ----------
   save() {
     if (this.saveTimer) return;
-    this.saveTimer = setTimeout(async () => {
-      this.saveTimer = null;
-      for (const a of this.state.agents) a.logTail = (this.agentRt.get(a.id)?.log ?? []).slice(-200);
-      await fs4.mkdir(path6.dirname(STATE_FILE), { recursive: true });
-      const tmp = `${STATE_FILE}.tmp`;
-      await fs4.writeFile(tmp, JSON.stringify(this.state, null, 2));
-      await fs4.rename(tmp, STATE_FILE);
-    }, 1500);
+    this.saveTimer = setTimeout(() => void this.writeState().catch((err) => console.warn("could not save the state", err)), 1500);
+  }
+  /** Write the state file now, e.g. before the office stops or hands itself to the launcher. */
+  async writeState() {
+    if (this.saveTimer) clearTimeout(this.saveTimer);
+    this.saveTimer = null;
+    for (const a of this.state.agents) a.logTail = (this.agentRt.get(a.id)?.log ?? []).slice(-200);
+    await fs5.mkdir(path7.dirname(STATE_FILE), { recursive: true });
+    const tmp = `${STATE_FILE}.tmp`;
+    await fs5.writeFile(tmp, JSON.stringify(this.state, null, 2));
+    await fs5.rename(tmp, STATE_FILE);
   }
   // ---------- lookups ----------
   repo(id) {
@@ -2808,7 +3156,7 @@ var Swarm = class {
     const name = fullName.split("/")[1];
     const taken = folders.find((f) => f.name.toLowerCase() === name.toLowerCase());
     if (taken) throw new HttpError(409, `${taken.path} already exists and isn't a clone of ${fullName}. Connect that folder instead, or rename it first.`);
-    return path6.join(root, name);
+    return path7.join(root, name);
   }
   /** A brand-new project: a folder in your projects folder, pushed to a new GitHub repo. */
   async createRepo(name, opts) {
@@ -2820,11 +3168,11 @@ var Swarm = class {
   }
   /** The folders in your projects folder (or another folder you point at), and which are floors already. */
   async listProjectFolders(dir) {
-    const root = dir?.trim() ? path6.resolve(dir.trim()) : this.state.settings.projectsDir;
+    const root = dir?.trim() ? path7.resolve(dir.trim()) : this.state.settings.projectsDir;
     const folders = await this.backend.scanProjects(root).catch((err) => {
       throw new HttpError(400, err.message);
     });
-    const same = (a, b) => path6.resolve(a).toLowerCase() === path6.resolve(b).toLowerCase();
+    const same = (a, b) => path7.resolve(a).toLowerCase() === path7.resolve(b).toLowerCase();
     const floorOf = (f) => this.state.repos.find((r) => r.localPath && same(r.localPath, f.path) || f.github && r.id.toLowerCase() === f.github.toLowerCase())?.floor ?? null;
     return { root, folders: folders.map((f) => ({ name: f.name, path: f.path, git: f.git, github: f.github, floor: floorOf(f) })) };
   }
@@ -2921,46 +3269,38 @@ var Swarm = class {
   }
   /** One step toward merging a QA-passed PR. Returns true when it merged. */
   async advanceMerge(repo, rec, pr) {
-    if (pr.isDraft) return this.mergeNote(rec, "a draft: waiting");
-    if (pr.mergeable === "UNKNOWN" || pr.mergeState === "UNKNOWN") {
+    let step = mergeStep(pr, rec, Date.now(), { base: repo.defaultBranch });
+    if (step.do === "details") {
       const d = await this.backend.prDetails(repo.fullName, pr.number);
       pr = { ...pr, headSha: d.headSha, mergeable: d.mergeable, mergeState: d.mergeState };
+      step = mergeStep(pr, rec, Date.now(), { base: repo.defaultBranch, detailed: true });
     }
-    rec.passedSha ??= pr.headSha;
-    if (pr.headSha !== rec.passedSha) {
+    Object.assign(rec, step.set);
+    if (step.do === "requeue") {
       this.setQa(rec, { status: "queued", round: rec.round + 1, retests: rec.retests + 1, mergeNote: null, pendingSince: null });
       setTimeout(() => this.schedule(), 200);
       return false;
     }
-    if (pr.mergeable === "CONFLICTING" || pr.mergeState === "DIRTY") {
-      return this.sendBack(repo, rec, "conflict", `It conflicts with ${repo.defaultBranch}.`);
-    }
-    if (pr.checks === "failing") {
-      return this.sendBack(repo, rec, "checks", pr.failedChecks.map((c) => `- ${c.name}${c.url ? `: ${c.url}` : ""}`).join("\n"));
-    }
-    if (pr.checks === "pending") {
-      rec.pendingSince ??= Date.now();
-      if (Date.now() - rec.pendingSince > CHECKS_ALERT_MS && !rec.alerted) {
-        rec.alerted = true;
+    if (step.do === "send-back") return this.sendBack(repo, rec, step.reason, step.instructions, step.needsHuman);
+    if (step.do === "wait") {
+      if (step.alert) {
         this.postMessage("office", `\u23F3 PR #${pr.number} on ${repo.fullName} passed QA, but its checks (${pr.pendingChecks.join(", ")}) have been running for over ${CHECKS_ALERT_MS / 6e4} minutes. It merges as soon as they finish.`);
       }
-      return this.mergeNote(rec, `waiting for checks: ${pr.pendingChecks.join(", ") || "running"}`);
+      return step.note === void 0 ? false : this.mergeNote(rec, step.note);
     }
-    rec.pendingSince = null;
-    if (pr.mergeable === "UNKNOWN") return this.mergeNote(rec, "GitHub is checking it can merge");
-    if (pr.mergeState === "BEHIND") {
+    if (step.do === "update-branch") {
       this.mergeNote(rec, `updating the branch with ${repo.defaultBranch}`);
       await this.backend.updateBranch(repo.fullName, pr.number);
       const details = await this.backend.prDetails(repo.fullName, pr.number);
       this.setQa(rec, { passedSha: details.headSha });
       return false;
     }
-    if (rec.mergeRetryAt && Date.now() < rec.mergeRetryAt) return false;
+    if (step.do !== "merge") return false;
     this.mergeNote(rec, "merging\u2026");
     let error = "";
     for (const method of ["squash", "merge", "rebase"]) {
       try {
-        await this.backend.mergePull(repo.fullName, pr.number, method, rec.passedSha);
+        await this.backend.mergePull(repo.fullName, pr.number, method, rec.passedSha ?? pr.headSha);
         error = "";
         break;
       } catch (err) {
@@ -2989,8 +3329,8 @@ var Swarm = class {
     return false;
   }
   /** QA passed, but the PR can't merge as it is: a developer fixes it, and QA re-tests if the code changed. */
-  sendBack(repo, rec, reason, fixInstructions) {
-    if (rec.mergeFixes >= MAX_MERGE_FIXES) {
+  sendBack(repo, rec, reason, fixInstructions, needsHuman) {
+    if (needsHuman) {
       this.setQa(rec, { status: "needs-human", mergeNote: null });
       this.postMessage("office", `\u26A0\uFE0F PR #${rec.prNumber} on ${repo.fullName} still ${reason === "conflict" ? `conflicts with ${repo.defaultBranch}` : "fails its checks"} after ${MAX_MERGE_FIXES} fixes, so it needs you.`);
       return false;
@@ -3003,14 +3343,16 @@ var Swarm = class {
   async syncFolder(repo) {
     const rt = this.repoRt.get(repo.id);
     if (!rt || rt.cloneStatus !== "ready") return rt?.folderSync ?? null;
-    const own = isSamePath(this.backend.mainDir(repo.fullName), OFFICE_DIR);
-    const status = await this.backend.syncMain(repo.fullName, repo.defaultBranch, { touch: !own }).catch((err) => `sync failed: ${oneLine(err)}`);
+    const own = this.backend.office.isOwnFolder(this.backend.mainDir(repo.fullName));
+    const sync = await this.backend.syncMain(repo.fullName, repo.defaultBranch, { touch: !own }).catch((err) => ({ status: `sync failed: ${oneLine(err)}`, behind: 0, updatable: false }));
+    const status = sync?.status ?? null;
+    if (own && sync) this.setOfficeBehind(sync.updatable ? sync.behind : 0);
     if (!this.repoRt.has(repo.id)) return null;
     const before = rt.folderSync;
     rt.folderSync = status;
     this.emitRepo(repo);
     if (status && status !== before) {
-      const name = repo.localPath ? path6.basename(repo.localPath) : repo.fullName;
+      const name = repo.localPath ? path7.basename(repo.localPath) : repo.fullName;
       if (status.startsWith("updated")) this.toast("success", `\u{1F4C1} ${name}: ${status}`);
       else if (/behind|diverged|failed/.test(status)) this.toast("info", `\u{1F4C1} ${name} wasn't updated: ${status}`);
     }
@@ -3030,8 +3372,9 @@ var Swarm = class {
     return this.previews.stop(this.repo(id));
   }
   /** Server shutdown: stop every floor's app so nothing is left holding a preview port. */
-  shutdown() {
-    return this.previews.stopAll(this.state.repos);
+  async shutdown() {
+    await this.writeState().catch((err) => console.warn("could not save the state", err));
+    await this.previews.stopAll(this.state.repos);
   }
   async cloneRepo(id) {
     const repo = this.state.repos.find((r) => r.id === id);
@@ -3419,9 +3762,10 @@ Note from the manager: ${note}` : ""
           rt.shots.push({ data, mime, url: rt.browserUrl, at });
           if (rt.shots.length > 12) rt.shots.shift();
           this.broadcast({ type: "screen", agentId: a.id, url: rt.browserUrl, at });
-          void removeScreens(a.id).then(() => fs4.mkdir(SCREENS_DIR, { recursive: true })).then(() => fs4.writeFile(screenFile(a.id, mime), data)).catch((err) => console.warn("could not save screenshot", err));
+          void removeScreens(a.id).then(() => fs5.mkdir(SCREENS_DIR, { recursive: true })).then(() => fs5.writeFile(screenFile(a.id, mime), data)).catch((err) => console.warn("could not save screenshot", err));
         },
         limited: (at) => this.pauseForLimit(at),
+        usageWarning: (info) => this.paceForWarning(info),
         finished: (result) => void this.onFinished(a, repo, result)
       },
       repo.defaultBranch
@@ -3430,6 +3774,7 @@ Note from the manager: ${note}` : ""
   async onFinished(a, repo, result) {
     const rt = this.agentRt.get(a.id);
     if (!rt || !this.state.agents.includes(a)) return;
+    if (this.officeUpdate.handedOver) return;
     rt.session = null;
     rt.currentTool = null;
     a.endedAt = Date.now();
@@ -3842,9 +4187,11 @@ Full report with screenshots: ${rec.commentUrl}` : "",
     if (patch.ceoHeartbeatMin !== void 0) s.ceoHeartbeatMin = Math.max(0, Math.min(1440, Math.round(Number(patch.ceoHeartbeatMin)) || 0));
     if (typeof patch.managerName === "string") s.managerName = patch.managerName.trim().slice(0, 40);
     if (typeof patch.companyName === "string") s.companyName = patch.companyName.trim().slice(0, 60);
-    if (typeof patch.projectsDir === "string" && patch.projectsDir.trim()) s.projectsDir = path6.resolve(patch.projectsDir.trim());
+    if (typeof patch.projectsDir === "string" && patch.projectsDir.trim()) s.projectsDir = path7.resolve(patch.projectsDir.trim());
     if (typeof patch.setupDone === "boolean") s.setupDone = patch.setupDone;
     if (patch.tutorialStep !== void 0) s.tutorialStep = Math.max(-1, Math.round(Number(patch.tutorialStep)) || 0);
+    if (typeof patch.autoUpdate === "boolean") s.autoUpdate = patch.autoUpdate;
+    if (patch.pacingSessions !== void 0) s.pacingSessions = clampPacingSessions(patch.pacingSessions);
     this.save();
     this.broadcast({ type: "settings", settings: s });
     this.emitCeo();
@@ -3879,6 +4226,9 @@ Full report with screenshots: ${rec.commentUrl}` : "",
   // `${repoId}#${issue}`: its developer was asked once to finish the missing PR
   pausedUntil = 0;
   // Claude's usage limit was hit: nothing new starts before this
+  pacingUntil = 0;
+  // Claude warned about usage: new issues are paced until this
+  lastUsage = "";
   /** Backlog issues that can start now, most urgent first: the ones holding up the longest chain of other issues, then the oldest. */
   readyIssues(repo) {
     const issues = this.repoRt.get(repo.id).issues;
@@ -3938,7 +4288,7 @@ Full report with screenshots: ${rec.commentUrl}` : "",
    * free developer is least needed elsewhere, so nobody sits idle while there is work that can start.
    */
   startIssueWork(repo) {
-    if (!repo.autoAssign) return false;
+    if (!repo.autoAssign || !this.mayStart("issue")) return false;
     const free = this.available(repo, "dev");
     const ready = free.length ? this.readyIssues(repo) : [];
     if (ready.length === 0) return false;
@@ -3958,6 +4308,39 @@ Full report with screenshots: ${rec.commentUrl}` : "",
     const fresh = Date.now() >= this.pausedUntil;
     this.pausedUntil = until;
     if (fresh) this.postMessage("office", `\u23F8 Claude's usage limit was reached. The office starts no new work until ${new Date(until).toLocaleTimeString()}; sessions already running carry on.`);
+    this.emitUsage();
+  }
+  /** Claude warned that usage is getting high: pace new issues until the window resets, rather than run into the limit. */
+  paceForWarning(info) {
+    const now2 = Date.now();
+    const until = info.resetsAt && info.resetsAt > now2 ? info.resetsAt : now2 + PACING_MS;
+    if (until <= this.pacingUntil) return;
+    const fresh = now2 >= this.pacingUntil;
+    this.pacingUntil = until;
+    if (fresh) this.postMessage("office", pacingMessage(info, until, this.state.settings.pacingSessions, now2));
+    this.emitUsage();
+  }
+  /** May work of this kind start now, as far as Claude's usage goes? */
+  mayStart(kind) {
+    return mayStart(kind, { now: Date.now(), pausedUntil: this.pausedUntil, pacingUntil: this.pacingUntil, running: this.running(), pacingSessions: this.state.settings.pacingSessions });
+  }
+  usageNow() {
+    return usageView({ now: Date.now(), pausedUntil: this.pausedUntil, pacingUntil: this.pacingUntil });
+  }
+  emitUsage() {
+    const usage = this.usageNow();
+    const key = JSON.stringify(usage);
+    if (key === this.lastUsage) return;
+    this.lastUsage = key;
+    this.broadcast({ type: "usage", usage });
+  }
+  /** Pacing and pauses run out on their own: say so when pacing ends. */
+  tickUsage() {
+    if (this.pacingUntil && Date.now() >= this.pacingUntil) {
+      this.pacingUntil = 0;
+      this.postMessage("office", "\u2705 Claude's usage is back to normal. The office starts new work at full speed again.");
+    }
+    this.emitUsage();
   }
   /** A failed session releases its issue for someone else; an issue that keeps failing waits for the manager. */
   issueFailed(repo, n) {
@@ -3975,6 +4358,8 @@ Full report with screenshots: ${rec.commentUrl}` : "",
    * so no repo can hog the slots.
    */
   schedule() {
+    this.tickUsage();
+    if (this.officeUpdateTick()) return;
     if (this.limited()) return;
     this.maybeHeartbeat();
     this.startCeoWork();
@@ -3996,6 +4381,126 @@ Full report with screenshots: ${rec.commentUrl}` : "",
       }
     }
   }
+  // ---------- the office's own update ----------
+  drainInput() {
+    const u = this.officeUpdate;
+    return {
+      now: Date.now(),
+      behind: this.officeHead ? u.behind : 0,
+      launcher: this.backend.office.launcher,
+      autoUpdate: this.state.settings.autoUpdate !== false,
+      requested: u.requested,
+      postponedUntil: u.postponedUntil,
+      postponedBehind: u.postponedBehind,
+      failed: u.failed,
+      failedBehind: u.failedBehind,
+      drainingSince: u.drainingSince,
+      sent: u.sent,
+      running: this.running()
+    };
+  }
+  officeUpdateView() {
+    const u = this.officeUpdate;
+    const input = this.drainInput();
+    const d = drainDecision(input);
+    const until = u.postponedUntil ? new Date(u.postponedUntil).toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" }) : "";
+    const detail = d.state === "failed" ? u.failed : d.state === "waiting" ? `Postponed until ${until}, or until a newer commit lands.` : null;
+    return { state: d.state, behind: input.behind, launcher: input.launcher, drainingSince: u.drainingSince ?? d.drainingSince, running: input.running, detail };
+  }
+  emitOfficeUpdate() {
+    if (!this.officeHead) return;
+    const view = this.officeUpdateView();
+    const key = JSON.stringify(view);
+    if (key === this.lastOfficeView) return;
+    this.lastOfficeView = key;
+    this.broadcast({ type: "officeUpdate", officeUpdate: view });
+  }
+  /** The own-folder check found the office this many commits behind GitHub. */
+  setOfficeBehind(behind) {
+    const u = this.officeUpdate;
+    if (u.failed && u.failedBehind === null) u.failedBehind = behind;
+    u.behind = behind;
+    if (behind === 0) Object.assign(u, { requested: false, failed: null, failedBehind: null });
+    this.officeUpdateTick();
+  }
+  /**
+   * Take the office's own update one step (see drainDecision): drain, and once nothing is running, or the drain timed
+   * out, hand it to the launcher. True while nothing new may start.
+   */
+  officeUpdateTick() {
+    if (!this.officeHead) return false;
+    const u = this.officeUpdate;
+    const d = drainDecision(this.drainInput());
+    if (d.state === "draining" && u.drainingSince === null) {
+      const running = this.running();
+      this.postMessage(
+        "office",
+        `\u2B06\uFE0F Updating the office (${u.behind} new commit${u.behind === 1 ? "" : "s"}). Nothing new starts${running ? ` while ${running} running session${running === 1 ? "" : "s"} finish` : ""}; then it installs and restarts.`
+      );
+    }
+    u.drainingSince = d.drainingSince;
+    if (d.send) void this.handOver(d.timedOut);
+    this.emitOfficeUpdate();
+    return d.state === "draining" || d.state === "updating";
+  }
+  /** Drained: hand the update to the launcher. Sessions still running after the timeout stop the way a restart stops them. */
+  async handOver(timedOut) {
+    const u = this.officeUpdate;
+    const from = this.officeHead;
+    u.sent = true;
+    const busy = this.state.agents.filter((a) => BUSY.includes(a.status));
+    if (timedOut) this.postMessage("office", `\u23F1 ${busy.length} session${busy.length === 1 ? " was" : "s were"} still running after 20 minutes. Stopped; the work goes back to the queue after the update.`);
+    this.emitOfficeUpdate();
+    u.handedOver = true;
+    await this.writeState().catch((err) => console.warn("could not save the state", err));
+    for (const a of busy) this.agentRt.get(a.id)?.session?.stop();
+    try {
+      const result = await this.backend.office.update(from);
+      if (result) await this.afterUpdate(result);
+    } catch (err) {
+      await this.afterUpdate({ from, to: from, ok: false, error: `the launcher didn't take the update: ${oneLine(err)}`, installed: false, built: false, at: Date.now() });
+    }
+  }
+  /** An update that didn't restart the office (the demo, or a failed hand-over): recover like a restart would, then report it. */
+  async afterUpdate(result) {
+    const u = this.officeUpdate;
+    Object.assign(u, { sent: false, handedOver: false, requested: false, drainingSince: null });
+    const interrupted = this.state.agents.filter((a) => BUSY.includes(a.status));
+    for (const a of interrupted) {
+      Object.assign(a, { status: "stopped", lastError: "The office updated itself while this agent was working." });
+      const rt = this.agentRt.get(a.id);
+      if (rt) Object.assign(rt, { session: null, currentTool: null });
+    }
+    this.ensureCeo(interrupted);
+    this.recover(interrupted);
+    interrupted.forEach((a) => this.emitAgent(a));
+    await this.reportUpdate(result);
+    if (!result.ok) u.failedBehind = u.behind;
+    const own = this.state.repos.find((r) => this.backend.office.isOwnFolder(this.backend.mainDir(r.fullName)));
+    if (own) await this.syncFolder(own);
+    this.emitCeo();
+    this.save();
+    setTimeout(() => this.schedule(), 300);
+  }
+  /** One phone message about the last update (the launcher's last-update.json, or the demo's fake). */
+  async reportUpdate(result) {
+    const commits = result.ok && result.to ? await this.backend.office.commitsBetween(result.from, result.to) : null;
+    this.postMessage("office", lastUpdateMessage(result, commits));
+    Object.assign(this.officeUpdate, { failed: result.ok ? null : result.error || "unknown error", failedBehind: null });
+  }
+  /** The manager's Update now (drain now, even with automatic updates off) or Later (not for 2 hours, or until a newer commit). */
+  updateOffice(action) {
+    if (action !== "now" && action !== "later") throw new HttpError(400, 'action must be "now" or "later"');
+    const u = this.officeUpdate;
+    if (!this.officeHead || !this.backend.office.launcher) throw new HttpError(409, "The office can only update itself when its launcher started it (npm run dev or npm start).");
+    if (u.sent) throw new HttpError(409, "The update is already under way.");
+    if (u.behind <= 0) throw new HttpError(409, "The office is up to date: there is nothing to update.");
+    if (action === "now") Object.assign(u, { requested: true, postponedUntil: null });
+    else Object.assign(u, { requested: false, postponedUntil: Date.now() + POSTPONE_MS, postponedBehind: u.behind });
+    this.officeUpdateTick();
+    setTimeout(() => this.schedule(), 200);
+    return this.officeUpdateView();
+  }
   // ---------- the CEO ----------
   ceo() {
     return this.state.agents.find((a) => a.id === CEO_ID);
@@ -4122,11 +4627,11 @@ ${job.text}` } : job;
       this.state.ceo.lastReviewAt = Date.now();
       this.state.ceo.lastFingerprint = this.fingerprint();
     }
-    this.ceoIssues = { filed: 0, repos: /* @__PURE__ */ new Set() };
+    this.ceoIssues = new IssueCap(MAX_ISSUES_PER_JOB);
     this.emitAgent(a);
     this.emitCeo();
     this.save();
-    await fs4.mkdir(CEO_DIR, { recursive: true }).catch(() => void 0);
+    await fs5.mkdir(CEO_DIR, { recursive: true }).catch(() => void 0);
     if (a.status !== "working") {
       this.state.ceo.job = null;
       this.emitCeo();
@@ -4141,7 +4646,7 @@ ${job.text}` } : job;
           name: a.name,
           company: s.companyName,
           manager: s.managerName,
-          notesFile: path6.join(CEO_DIR, "NOTES.md"),
+          notesFile: path7.join(CEO_DIR, "NOTES.md"),
           sessionLimit: s.sessionLimit,
           teamCap: s.teamCap,
           hiring: s.hiring
@@ -4170,6 +4675,7 @@ ${job.text}` } : job;
         screenshot: () => void 0,
         turn: (text) => this.postMessage("ceo", text),
         limited: (at) => this.pauseForLimit(at),
+        usageWarning: (info) => this.paceForWarning(info),
         finished: (result) => this.onCeoFinished(a, result)
       },
       ""
@@ -4177,7 +4683,7 @@ ${job.text}` } : job;
   }
   onCeoFinished(a, result) {
     const rt = this.agentRt.get(a.id);
-    if (!rt) return;
+    if (!rt || this.officeUpdate.handedOver) return;
     rt.session = null;
     rt.currentTool = null;
     a.endedAt = Date.now();
@@ -4194,7 +4700,7 @@ ${job.text}` } : job;
       this.postMessage("office", `\u26A0\uFE0F ${a.name} hit a problem while ${what}: ${a.lastError.slice(0, 240)}`);
     } else {
       a.status = "done";
-      const filed = this.ceoIssues.filed ? ` \xB7 ${this.ceoIssues.filed} issue${this.ceoIssues.filed === 1 ? "" : "s"} filed` : "";
+      const filed = this.ceoIssues.total ? ` \xB7 ${this.ceoIssues.total} issue${this.ceoIssues.total === 1 ? "" : "s"} filed` : "";
       this.appendLog(a, [{ kind: "done", text: `\u2714 Done in ${this.minutes(a)}m \xB7 ${a.turns} turns${filed}` }]);
     }
     for (const id of this.ceoIssues.repos) void this.syncRepo(id);
@@ -4212,6 +4718,7 @@ ${job.text}` } : job;
     const rt = this.agentRt.get(a.id);
     if (rt.session) {
       this.appendLog(a, [{ kind: "manager", text: `\u25B6 Manager: ${t}` }]);
+      this.ceoIssues.managerMessage();
       rt.session.send(`Message from the manager (they read your reply on their phone, so keep it short):
 ${t}`);
       return;
@@ -4434,6 +4941,7 @@ ${t}`);
           teamCap: s.teamCap,
           sessionLimit: s.sessionLimit || "none",
           sessionsRunning: this.running(),
+          usage: usageLabel(this.usageNow(), Date.now()),
           deskLimits: { dev: MAX_DESKS.dev, qa: MAX_DESKS.qa }
         },
         floors,
@@ -4577,7 +5085,7 @@ ${t}`);
   }
   async fileIssue(x) {
     const repo = this.floorRepo(x.floor);
-    if (this.ceoIssues.filed >= MAX_ISSUES_PER_JOB) throw new Error(`You already filed ${MAX_ISSUES_PER_JOB} issues in this job. That's plenty for one milestone.`);
+    this.ceoIssues.check();
     const title = String(x.title ?? "").trim().slice(0, 120);
     if (!title) throw new Error("An issue needs a title.");
     const slug = specialtySlug(x.specialty);
@@ -4586,10 +5094,35 @@ ${t}`);
 ---
 _Filed by ${this.ceo().name}, the cubefarm CEO._`;
     const n = await this.backend.createIssue(repo.fullName, title, body, slug ? [specialtyLabel(slug)] : []);
-    this.ceoIssues.filed++;
-    this.ceoIssues.repos.add(repo.id);
+    this.ceoIssues.record(repo.id);
     return `Filed #${n} on floor ${repo.floor}: ${title}${slug ? ` (routed to ${slug})` : ""}.`;
   }
+  /** Change an open issue's specialty and/or dependencies (see planRoute for what is refused). */
+  async routeIssue(x) {
+    const repo = this.floorRepo(x.floor);
+    const issues = this.repoRt.get(repo.id)?.issues ?? [];
+    const asked = [Number(x.number), ...(x.depends_on ?? []).map(Number)].filter((n) => !issues.some((i) => i.number === n));
+    const states = new Map(await Promise.all([...new Set(asked)].map(async (n) => [n, await this.backend.issueState(repo.fullName, n).catch(() => null)])));
+    const specialties = [
+      ...this.state.agents.filter((a) => a.repoId === repo.id && a.specialty).map((a) => a.specialty.toLowerCase()),
+      ...this.state.requests.filter((r) => r.status === "pending" && r.kind === "hire" && r.repoId === repo.id && r.specialty).map((r) => r.specialty)
+    ];
+    const plan = planRoute({
+      floor: repo.floor,
+      number: Number(x.number),
+      specialty: x.specialty,
+      dependsOn: x.depends_on,
+      issues,
+      closed: (n) => states.get(n) === "CLOSED",
+      inProgress: this.issueTaken(repo, Number(x.number)),
+      specialties
+    });
+    if (plan.body !== null || plan.addLabels.length || plan.removeLabels.length) {
+      await this.backend.editIssue(repo.fullName, Number(x.number), { body: plan.body ?? void 0, addLabels: plan.addLabels, removeLabels: plan.removeLabels });
+      await this.syncRepo(repo.id);
+    }
+    return plan.summary;
+  }
 };
 
 // server/index.ts
@@ -4706,6 +5239,7 @@ app.get("/api/agents/:id/screen", (req, res) => {
   res.end(shot.data);
 });
 app.patch("/api/settings", route((req) => swarm.updateSettings(req.body ?? {})));
+app.post("/api/office/update", route((req) => swarm.updateOffice(req.body?.action)));
 app.post("/api/ceo/message", route((req) => swarm.messageCeo(str(req.body.text))));
 app.post("/api/ceo/review", route(() => swarm.requestReview()));
 app.post("/api/phone/read", route((req) => swarm.markPhoneRead(Number(req.body?.at) || Date.now())));
@@ -4714,10 +5248,10 @@ app.post(
   route((req) => swarm.approveRequest(String(req.params.id), { name: str(req.body?.name) || void 0, model: typeof req.body?.model === "string" ? req.body.model : void 0, effort: typeof req.body?.effort === "string" ? req.body.effort : void 0 }))
 );
 app.post("/api/requests/:id/reject", route((req) => swarm.rejectRequest(String(req.params.id), str(req.body?.note))));
-var dist = path7.resolve(import.meta.dirname, "../dist");
-if (fs5.existsSync(dist)) {
+var dist = path8.resolve(import.meta.dirname, "../dist");
+if (fs6.existsSync(dist)) {
   app.use(express.static(dist));
-  app.get(/^(?!\/api).*/, (_req, res) => res.sendFile(path7.join(dist, "index.html")));
+  app.get(/^(?!\/api).*/, (_req, res) => res.sendFile(path8.join(dist, "index.html")));
 }
 app.use((err, _req, res, _next) => {
   const parserStatus = err?.status;
@@ -4750,4 +5284,9 @@ var shutdown = (signal) => {
 };
 process.once("SIGINT", () => shutdown("SIGINT"));
 process.once("SIGTERM", () => shutdown("SIGTERM"));
+if (underLauncher()) {
+  process.on("message", (msg) => {
+    if (msg?.type === "office:shutdown") shutdown("update");
+  });
+}
 //# sourceMappingURL=index.js.map