@appchy/jarvis 0.1.63 → 0.1.65

package/dist/bin.js

@@ -197,19 +197,19 @@ function startScanner(options) {
           const trimmed = rel.trim();
           if (!trimmed) continue;
           const abs = path3.join(repo.path, trimmed);
-          let stat3;
+          let stat4;
           try {
-            stat3 = fs3.statSync(abs);
+            stat4 = fs3.statSync(abs);
           } catch {
             continue;
           }
-          if (!stat3.isFile()) continue;
+          if (!stat4.isFile()) continue;
           const ext = path3.extname(trimmed).slice(1).toLowerCase() || null;
           items.push({
             repoPath: repo.path,
             path: trimmed,
             language: ext,
-            size: stat3.size,
+            size: stat4.size,
             preview: readPreview(abs)
           });
           if (items.length >= BATCH_CAP) break;
@@ -401,20 +401,20 @@ function walkSessions(dir) {
   const out = [];
   for (const name of entries) {
     const p = path3.join(dir, name);
-    let stat3;
+    let stat4;
     try {
-      stat3 = fs3.statSync(p);
+      stat4 = fs3.statSync(p);
     } catch {
       continue;
     }
-    if (stat3.isDirectory()) {
+    if (stat4.isDirectory()) {
       out.push(...walkSessions(p));
       continue;
     }
     if (!name.endsWith(".jsonl") && !name.endsWith(".json")) continue;
     out.push({
       filePath: p,
-      mtimeMs: stat3.mtimeMs,
+      mtimeMs: stat4.mtimeMs,
       messageCount: countLines(p)
     });
   }
@@ -748,7 +748,7 @@ function startIpcServer(socketPath, userId) {
   };
 }
 async function callDaemonIpc(socketPath, method, params, timeoutMs = 5e3) {
-  return new Promise((resolve10, reject) => {
+  return new Promise((resolve11, reject) => {
     const conn = net.connect(socketPath);
     let buf = "";
     let settled = false;
@@ -780,7 +780,7 @@ async function callDaemonIpc(socketPath, method, params, timeoutMs = 5e3) {
         if (parsed.error) {
           finish(() => reject(new Error(parsed.error?.message ?? "ipc error")));
         } else {
-          finish(() => resolve10(parsed.result));
+          finish(() => resolve11(parsed.result));
         }
       } catch (err) {
         finish(() => reject(err instanceof Error ? err : new Error(String(err))));
@@ -1215,10 +1215,10 @@ function humanizeAgo(iso) {
 }
 function readlineQuestion(req) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve10) => {
+  return new Promise((resolve11) => {
     rl.question(req.prompt, (answer) => {
       rl.close();
-      resolve10(answer);
+      resolve11(answer);
     });
   });
 }
@@ -1242,8 +1242,8 @@ var TOOL_DIRS = [
   "/opt/homebrew/bin",
   "/usr/local/bin"
 ];
-function runnable(bin, spawn3) {
-  const probe = spawn3(bin, ["--help"], { stdio: "ignore" });
+function runnable(bin, spawn4) {
+  const probe = spawn4(bin, ["--help"], { stdio: "ignore" });
   return probe.error?.code !== "ENOENT";
 }
 function isExecutable(path22) {
@@ -1255,9 +1255,9 @@ function isExecutable(path22) {
   }
 }
 function locate(bin, options) {
-  const spawn3 = options.spawn ?? spawnSync;
+  const spawn4 = options.spawn ?? spawnSync;
   const executable = options.executable ?? isExecutable;
-  if (runnable(bin, spawn3)) return { command: bin, strayDir: null };
+  if (runnable(bin, spawn4)) return { command: bin, strayDir: null };
   for (const dir of TOOL_DIRS) {
     if (executable(join(dir, bin))) return { command: join(dir, bin), strayDir: dir };
   }
@@ -1267,10 +1267,10 @@ function reachInto(dir) {
   process.env.PATH = `${dir}${delimiter}${process.env.PATH ?? ""}`;
 }
 function resolveGraphify(options = {}) {
-  const tool = locate(BIN, options);
+  const tool2 = locate(BIN, options);
   return {
-    onPath: tool.command !== null && tool.strayDir === null,
-    strayDir: tool.strayDir
+    onPath: tool2.command !== null && tool2.strayDir === null,
+    strayDir: tool2.strayDir
   };
 }
 function findUv(options = {}) {
@@ -1280,15 +1280,15 @@ async function confirmAtTerminal(req) {
   if (!process.stdin.isTTY) return false;
   const question = req.needsUv ? `  Install ${BIN}, and ${UV} (from ${UV_INSTALLER}) which installs it? [Y/n] ` : `  Install ${BIN} now with ${UV}? [Y/n] `;
   const rl = createInterface2({ input: process.stdin, output: process.stderr });
-  const answer = await new Promise((resolve10) => {
-    rl.question(question, (input) => resolve10(input.trim().toLowerCase()));
+  const answer = await new Promise((resolve11) => {
+    rl.question(question, (input) => resolve11(input.trim().toLowerCase()));
   });
   rl.close();
   return answer === "" || answer === "y" || answer === "yes";
 }
 function installGraphify(req, options = {}) {
-  const spawn3 = options.spawn ?? spawnSync;
-  const install = spawn3(req.uv, ["tool", "install", PACKAGE], { stdio: "inherit" });
+  const spawn4 = options.spawn ?? spawnSync;
+  const install = spawn4(req.uv, ["tool", "install", PACKAGE], { stdio: "inherit" });
   if (install.status !== 0) {
     return {
       installed: false,
@@ -1307,16 +1307,16 @@ function installGraphify(req, options = {}) {
   return { installed: true, strayDir: after.strayDir, problem: null };
 }
 function installUv(options = {}) {
-  const spawn3 = options.spawn ?? spawnSync;
-  if (!runnable("curl", spawn3)) {
+  const spawn4 = options.spawn ?? spawnSync;
+  if (!runnable("curl", spawn4)) {
     return { uv: null, problem: `curl is needed to fetch ${UV_INSTALLER} and is not installed.` };
   }
   const script = join(process.env.TMPDIR ?? "/tmp", `uv-install-${process.pid}.sh`);
-  const fetched = spawn3("curl", ["-LsSf", UV_INSTALLER, "-o", script], { stdio: "inherit" });
+  const fetched = spawn4("curl", ["-LsSf", UV_INSTALLER, "-o", script], { stdio: "inherit" });
   if (fetched.status !== 0) {
     return { uv: null, problem: `could not download ${UV_INSTALLER}.` };
   }
-  const ran = spawn3("sh", [script], { stdio: "inherit" });
+  const ran = spawn4("sh", [script], { stdio: "inherit" });
   if (ran.status !== 0) {
     return { uv: null, problem: `the uv installer did not succeed. See ${UV_INSTALLER}.` };
   }
@@ -2510,10 +2510,10 @@ function rootsEqual(a, b) {
 }
 async function readlineQuestion2(question) {
   const rl = createInterface3({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve10) => {
+  return new Promise((resolve11) => {
     rl.question(question, (input) => {
       rl.close();
-      resolve10(input);
+      resolve11(input);
     });
   });
 }
@@ -2593,8 +2593,8 @@ function defaultPrompts() {
 }
 async function promptList(question, fallback) {
   const rl = createInterface3({ input: process.stdin, output: process.stdout });
-  const answer = await new Promise((resolve10) => {
-    rl.question(question, (input) => resolve10(input.trim()));
+  const answer = await new Promise((resolve11) => {
+    rl.question(question, (input) => resolve11(input.trim()));
   });
   rl.close();
   const raw = !answer ? fallback : answer.split(",").map((s) => s.trim()).filter(Boolean);
@@ -2748,8 +2748,8 @@ function register5(program) {
 }
 async function confirm(question) {
   const rl = createInterface4({ input: process.stdin, output: process.stdout });
-  const answer = await new Promise((resolve10) => {
-    rl.question(question, (input) => resolve10(input.trim()));
+  const answer = await new Promise((resolve11) => {
+    rl.question(question, (input) => resolve11(input.trim()));
   });
   rl.close();
   return /^y(es)?$/i.test(answer);
@@ -3020,7 +3020,7 @@ async function idOf(term) {
       } catch {
       }
     }
-    await new Promise((resolve10) => setTimeout(resolve10, 250));
+    await new Promise((resolve11) => setTimeout(resolve11, 250));
   }
   throw new Error("Claude Code started but never registered a session id");
 }
@@ -3089,13 +3089,13 @@ async function live(req) {
     else options.signal.addEventListener("abort", () => term.kill(), { once: true });
   }
   rest();
-  await new Promise((resolve10) => {
+  await new Promise((resolve11) => {
     term.onExit(({ exitCode, signal }) => {
       if (idle) clearTimeout(idle);
       if (closedForIdle) report2("stopped", "closed after sitting idle");
       else if (exitCode === 0) report2("done");
       else report2("failed", endedAs(exitCode, signal));
-      resolve10();
+      resolve11();
     });
   });
 }
@@ -3608,13 +3608,13 @@ async function walkRoot(req) {
   for (const entry of entries) {
     if (entry.startsWith(".")) continue;
     const projectDir = path15.join(req.root.dir, entry);
-    let stat3;
+    let stat4;
     try {
-      stat3 = await fs14.stat(projectDir);
+      stat4 = await fs14.stat(projectDir);
     } catch {
       continue;
     }
-    if (!stat3.isDirectory()) continue;
+    if (!stat4.isDirectory()) continue;
     let files2;
     try {
       files2 = await fs14.readdir(projectDir);
@@ -3655,18 +3655,18 @@ async function listLocalSessionIds(req = {}) {
 async function getSessionFile(req) {
   const provider2 = getSessionProvider({ path: req.path });
   if (!provider2) return null;
-  let stat3;
+  let stat4;
   try {
-    stat3 = await fs14.stat(req.path);
+    stat4 = await fs14.stat(req.path);
   } catch {
     return null;
   }
-  if (!stat3.isFile()) return null;
+  if (!stat4.isFile()) return null;
   return {
     provider: provider2,
     filePath: req.path,
     projectDir: path15.dirname(req.path),
-    mtimeMs: stat3.mtimeMs
+    mtimeMs: stat4.mtimeMs
   };
 }
 var defaultRepoCache = /* @__PURE__ */ new Map();
@@ -4498,45 +4498,10 @@ function describeAge(when) {
 
 // ../../packages/board/src/board.git.ts
 var run3 = promisify4(execFile4);
-var FORMAT = "%x1e%H%x1f%aI%x1f%an%x1f%B";
 var SOURCED = "%x1e%H%x1f%S%x1f%aI%x1f%an%x1f%B";
 var TRAILER = "^Work-Item: ";
 var SEP = "";
 var REC = "";
-async function boardCommits(root, id) {
-  const out = await git2(root, [
-    "log",
-    "--all",
-    "--reverse",
-    `--format=${FORMAT}`,
-    "-E",
-    `--grep=^Work-Item: ${escapeGrep(id)}$`
-  ]);
-  const commits = [];
-  for (const record of out.split(REC)) {
-    if (!record.trim()) continue;
-    const [sha, when, author, message] = record.split(SEP);
-    if (!message || !sha) continue;
-    const branch = await branchOf(root, sha);
-    commits.push({
-      sha,
-      when: when ?? "",
-      by: author ?? "",
-      message,
-      branch,
-      branchLastCommitAt: await lastCommitOn(root, branch)
-    });
-  }
-  return commits;
-}
-async function lastCommitOn(root, branch) {
-  return (await git2(root, ["log", "-1", "--format=%aI", branch || "HEAD"])).trim();
-}
-async function branchOf(root, sha) {
-  const out = await git2(root, ["branch", "--all", "--format=%(refname:short)", "--contains", sha]);
-  const first = out.split("\n").map((line) => line.trim()).filter(Boolean).filter((line) => !line.includes("HEAD ->"))[0];
-  return first ?? "";
-}
 async function git2(root, argv) {
   try {
     const { stdout } = await run3("git", argv, { cwd: root, timeout: 2e4 });
@@ -4545,10 +4510,19 @@ async function git2(root, argv) {
     return "";
   }
 }
-function escapeGrep(value) {
-  return value.replace(/[^A-Za-z0-9_-]/g, (c) => `\\${c}`);
+function boardHistory(root) {
+  const running = walking.get(root);
+  if (running) return running;
+  const walk2 = readHistory(root);
+  walking.set(root, walk2);
+  const done = () => {
+    if (walking.get(root) === walk2) walking.delete(root);
+  };
+  void walk2.then(done, done);
+  return walk2;
 }
-async function boardHistory(root) {
+var walking = /* @__PURE__ */ new Map();
+async function readHistory(root) {
   const [out, tips] = await Promise.all([
     git2(root, ["log", "--all", "--source", "--reverse", `--format=${SOURCED}`, "-E", `--grep=${TRAILER}`]),
     branchTips(root)
@@ -4591,7 +4565,8 @@ async function listHoldersByItem(root) {
   return toHoldersByItem(await boardHistory(root));
 }
 async function listHolders(root, id) {
-  return toHolders(await boardCommits(root, id));
+  const byItem = await listHoldersByItem(root);
+  return byItem.get(id) ?? [];
 }
 
 // ../../packages/board/src/board.tree.ts
@@ -4757,8 +4732,14 @@ async function listWorkItems(_ctx, req, options) {
   return toPage(await scanTree(options.root), req);
 }
 async function findWorkItem(_ctx, req, options) {
-  const all = await scanTree(options.root);
-  return all.find((item2) => item2.id === req.id) ?? null;
+  const work = join4(options.root, "work");
+  for (const base of ["versions", "backlog"]) {
+    for (const file of await walk(join4(work, base))) {
+      const path22 = pathIn(work, file);
+      if (path22.split("/").at(-2) === req.id) return readItem(work, file);
+    }
+  }
+  return null;
 }
 async function getWorkItem(ctx, req, options) {
   const item2 = await findWorkItem(ctx, req, options);
@@ -4887,20 +4868,37 @@ function harnessMessage(err) {
   const said = (e.stderr || e.stdout || "").trim();
   return said || e.message || "the work harness failed";
 }
-async function scanTree(root) {
+function scanTree(root) {
+  const running = scanning.get(root);
+  if (running) return running;
+  const scan2 = readTree(root);
+  scanning.set(root, scan2);
+  const done = () => {
+    if (scanning.get(root) === scan2) scanning.delete(root);
+  };
+  void scan2.then(done, done);
+  return scan2;
+}
+var scanning = /* @__PURE__ */ new Map();
+async function readTree(root) {
   const work = join4(root, "work");
   const items = [];
   for (const base of ["versions", "backlog"]) {
     for (const file of await walk(join4(work, base))) {
-      const text = await readFile(file, "utf-8");
-      const changedAt = (await stat(file)).mtime.toISOString().slice(0, 10);
-      const path22 = relative(work, file).split(sep).join("/");
-      const item2 = toWorkItem({ path: path22, text, changedAt });
+      const item2 = await readItem(work, file);
       if (item2) items.push(item2);
     }
   }
   return items;
 }
+async function readItem(work, file) {
+  const text = await readFile(file, "utf-8");
+  const changedAt2 = (await stat(file)).mtime.toISOString().slice(0, 10);
+  return toWorkItem({ path: pathIn(work, file), text, changedAt: changedAt2 });
+}
+function pathIn(work, file) {
+  return relative(work, file).split(sep).join("/");
+}
 async function walk(dir, depth = 0) {
   if (depth > 6) return [];
   let entries;
@@ -7135,8 +7133,8 @@ function notReadyMs() {
 var PENDING = /* @__PURE__ */ Symbol("pending");
 async function readyWithin(pending) {
   let timer;
-  const timeout = new Promise((resolve10) => {
-    timer = setTimeout(() => resolve10(PENDING), notReadyMs());
+  const timeout = new Promise((resolve11) => {
+    timer = setTimeout(() => resolve11(PENDING), notReadyMs());
     timer.unref?.();
   });
   try {
@@ -9272,7 +9270,7 @@ function createServer(ctx, hosted = [], prompts = []) {
     {
       instructions: buildInstructions({
         ...typeof ctx === "function" ? {} : { ctx },
-        served: [...TOOLS.map((tool) => tool.name), ...hosted.map((tool) => tool.name)]
+        served: [...TOOLS.map((tool2) => tool2.name), ...hosted.map((tool2) => tool2.name)]
       })
     }
   );
@@ -9328,7 +9326,7 @@ function createServer(ctx, hosted = [], prompts = []) {
   return server;
 }
 function buildInstructions(req = {}) {
-  const served = req.served ?? TOOLS.map((tool) => tool.name);
+  const served = req.served ?? TOOLS.map((tool2) => tool2.name);
   const has = (prefix) => served.some((name) => name.startsWith(prefix));
   const lines = [
     "This repo, through one connection: the work it has to do, and a map of what it knows."
@@ -9636,13 +9634,13 @@ async function readFileTree(req) {
   if (entry && mtimeMs !== null && Date.now() - mtimeMs < TREE_FRESHNESS_MS) {
     return { tree: entry.tree, root: entry.root };
   }
-  let stat3;
+  let stat4;
   try {
-    stat3 = await fs15.stat(req.workdir);
+    stat4 = await fs15.stat(req.workdir);
   } catch {
     return { tree: [], root: null };
   }
-  if (!stat3.isDirectory()) return { tree: [], root: null };
+  if (!stat4.isDirectory()) return { tree: [], root: null };
   const tree2 = await walkTree({ absPath: req.workdir, rootPath: req.workdir, depth: 0 });
   await writeTreeCacheEntry({
     workdir: req.workdir,
@@ -9683,15 +9681,15 @@ async function readFileContent(workdir, relPath) {
   if (!absPath.startsWith(resolvedRoot + path16.sep) && absPath !== resolvedRoot) {
     throw new FileReadError("path_outside_workdir", "path_outside_workdir");
   }
-  const stat3 = await fs15.stat(absPath);
-  if (!stat3.isFile()) {
+  const stat4 = await fs15.stat(absPath);
+  if (!stat4.isFile()) {
     throw new FileReadError("not_a_file", "not_a_file");
   }
-  if (stat3.size > MAX_FILE_BYTES) {
-    return { path: relPath, content: null, size: stat3.size, tooLarge: true };
+  if (stat4.size > MAX_FILE_BYTES) {
+    return { path: relPath, content: null, size: stat4.size, tooLarge: true };
   }
   const content = await fs15.readFile(absPath, "utf-8");
-  return { path: relPath, content, size: stat3.size };
+  return { path: relPath, content, size: stat4.size };
 }
 
 // src/workspace.ts
@@ -10117,7 +10115,7 @@ import { createRequire as createRequire2 } from "module";
 var _require = createRequire2(import.meta.url);
 var VERSION2 = _require("../package.json").version ?? "0.0.0";
 var IS_DEV = String(_require("../package.json").name ?? "").endsWith("-dev");
-var SHA = "08bcde1";
+var SHA = "223ee7f";
 var BUILT = "2026-09-09";
 var BUILD = SHA ?? "source";
 var BUILD_LABEL = `${SHA ? `${VERSION2} (${SHA}${BUILT ? ` ${BUILT}` : ""})` : `${VERSION2} (source)`}${IS_DEV ? " \u2014 development build" : ""}`;
@@ -10572,7 +10570,7 @@ async function startAgent(options) {
         timestamp: Date.now()
       };
       publish(envCtx, "env.disconnected", { envId: options.envId, reason: "shutdown" });
-      await new Promise((resolve10) => setImmediate(resolve10));
+      await new Promise((resolve11) => setImmediate(resolve11));
     }
     if (heartbeatTimer) clearInterval(heartbeatTimer);
     if (ipcServer) {
@@ -10849,10 +10847,10 @@ async function getHealth(req = {}) {
 async function probeSocket(url, probeMs) {
   const port = portOf(url);
   if (port === null) return { url, reachable: false };
-  const reachable = await new Promise((resolve10) => {
+  const reachable = await new Promise((resolve11) => {
     const done = (answer) => {
       socket.destroy();
-      resolve10(answer);
+      resolve11(answer);
     };
     const socket = net2.connect({ host: new URL(url).hostname, port }).once("connect", () => done(true)).once("error", () => done(false));
     socket.setTimeout(probeMs, () => done(false));
@@ -11025,10 +11023,10 @@ function removeDir(p) {
 }
 function confirm2(prompt) {
   const rl = createInterface5({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve10) => {
+  return new Promise((resolve11) => {
     rl.question(prompt, (answer) => {
       rl.close();
-      resolve10(/^y(es)?$/i.test(answer.trim()));
+      resolve11(/^y(es)?$/i.test(answer.trim()));
     });
   });
 }
@@ -11868,16 +11866,16 @@ function describeState(verb, response) {
 
 // src/serve/hosted.ts
 import crypto6 from "crypto";
-function toHostedTool(tool) {
+function toHostedTool(tool2) {
   return {
-    name: tool.name,
-    title: tool.title ?? tool.name,
-    description: tool.description,
-    inputSchema: toShape(tool.input),
-    annotations: { readOnlyHint: tool.metadata?.readOnly === true },
+    name: tool2.name,
+    title: tool2.title ?? tool2.name,
+    description: tool2.description,
+    inputSchema: toShape(tool2.input),
+    annotations: { readOnlyHint: tool2.metadata?.readOnly === true },
     call: async (input) => {
-      const output = await tool.call(callerContext(), input);
-      return { ...output, summary: output.message ?? `${tool.name} ok` };
+      const output = await tool2.call(callerContext(), input);
+      return { ...output, summary: output.message ?? `${tool2.name} ok` };
     }
   };
 }
@@ -12181,7 +12179,7 @@ async function readMachine(req) {
 }
 
 // src/ui/server.ts
-var ASSETS = resolve9(dirname7(fileURLToPath4(import.meta.url)), "ui");
+var SHIPPED = resolve9(dirname7(fileURLToPath4(import.meta.url)), "ui");
 var TYPES = {
   ".html": "text/html; charset=utf-8",
   ".js": "text/javascript; charset=utf-8",
@@ -12221,10 +12219,10 @@ async function item(repo, id, res) {
   const read3 = await getWorkItem2(context(), { id }, { root: repo, harness: harness2() });
   json(res, 200, { item: read3.item, brief: read3.brief });
 }
-async function asset(repo, url, res) {
+async function asset(repo, assets, url, res) {
   const wanted = url.pathname === "/" || !extname(url.pathname) ? "/index.html" : url.pathname;
-  const path22 = join9(ASSETS, wanted);
-  if (!path22.startsWith(ASSETS)) {
+  const path22 = join9(assets, wanted);
+  if (!path22.startsWith(assets)) {
     res.writeHead(403).end("no");
     return;
   }
@@ -12249,7 +12247,9 @@ async function asset(repo, url, res) {
     );
   }
 }
-function serveUi(repo, port) {
+function serveUi(repo, port, options = {}) {
+  const assets = options.assets ?? SHIPPED;
+  const watching = /* @__PURE__ */ new Set();
   const server = createServer2((req, res) => {
     const url = new URL(req.url ?? "/", "http://localhost");
     void (async () => {
@@ -12270,7 +12270,17 @@ function serveUi(repo, port) {
           json(res, 200, await readMachine({ root: repo }));
           return;
         }
-        await asset(repo, url, res);
+        if (url.pathname === "/api/v1/ui/reload") {
+          res.writeHead(200, {
+            "content-type": "text/event-stream",
+            "cache-control": "no-store",
+            connection: "keep-alive"
+          });
+          watching.add(res);
+          res.on("close", () => watching.delete(res));
+          return;
+        }
+        await asset(repo, assets, url, res);
       } catch (err) {
         const status2 = err instanceof ServiceError ? err.statusCode : 500;
         json(res, status2, { error: err instanceof Error ? err.message : String(err) });
@@ -12282,21 +12292,167 @@ function serveUi(repo, port) {
     server.listen(port, "127.0.0.1", () => {
       ok({
         url: `http://localhost:${port}`,
-        close: () => new Promise((done) => server.close(() => done()))
+        reload: () => {
+          for (const page of watching) page.write("data: reload\n\n");
+        },
+        close: () => new Promise((done) => {
+          for (const page of watching) page.end();
+          watching.clear();
+          server.close(() => done());
+        })
       });
     });
   });
 }
 
+// src/ui/source.ts
+import { spawn as spawn3 } from "child_process";
+import { existsSync as existsSync6, readFileSync as readFileSync8, watch } from "fs";
+import { stat as stat3 } from "fs/promises";
+import { dirname as dirname8, join as join10, resolve as resolve10 } from "path";
+import { fileURLToPath as fileURLToPath5 } from "url";
+var PAGE = join10("apps", "cli", "dist", "ui");
+var BUNDLE = "app.js";
+var WATCHED = [join10("apps", "cli", "src", "ui"), join10("packages", "ui", "src")];
+function fromSource() {
+  return fileURLToPath5(import.meta.url).endsWith(".ts");
+}
+function sourceCheckout() {
+  const named2 = process.env.JARVIS_SOURCE;
+  if (named2) return usable(resolve10(named2));
+  if (fromSource()) return usable(resolve10(dirname8(fileURLToPath5(import.meta.url)), "../../../.."));
+  const built = builtFrom();
+  return built ? usable(built) : null;
+}
+function builtFrom() {
+  try {
+    const manifest = join10(dirname8(fileURLToPath5(import.meta.url)), "..", "package.json");
+    const read3 = JSON.parse(readFileSync8(manifest, "utf-8"));
+    return typeof read3.jarvis?.source === "string" ? read3.jarvis.source : null;
+  } catch {
+    return null;
+  }
+}
+function usable(root) {
+  const files2 = [
+    join10(root, "apps", "cli", "src", "ui", "browser", "App.tsx"),
+    join10(root, "apps", "cli", "tsup.ui.config.ts")
+  ];
+  const present = files2.every((path22) => existsSync6(path22)) && tool(root, "tsup") && tool(root, "tsx");
+  return present ? root : null;
+}
+function tool(root, name) {
+  const places = [
+    join10(root, "apps", "cli", "node_modules", ".bin", name),
+    join10(root, "node_modules", ".bin", name)
+  ];
+  return places.find((path22) => existsSync6(path22)) ?? null;
+}
+function runFromCheckout(req) {
+  const child = spawn3(
+    tool(req.root, "tsx") ?? "tsx",
+    [
+      "watch",
+      "--clear-screen=false",
+      join10(req.root, "apps", "cli", "src", "bin.ts"),
+      "ui",
+      "--repo",
+      req.repo,
+      "--port",
+      String(req.port),
+      // The supervisor opens the browser, once, when the port answers. Left to the child it
+      // would open a fresh tab on every restart `tsx watch` makes.
+      "--no-open"
+    ],
+    { stdio: "inherit", cwd: req.root }
+  );
+  const relay = (signal) => () => {
+    child.kill(signal);
+  };
+  process.once("SIGINT", relay("SIGINT"));
+  process.once("SIGTERM", relay("SIGTERM"));
+  child.once("exit", (code) => {
+    process.exitCode = code ?? 0;
+  });
+  return child;
+}
+async function watchPage(root) {
+  const dir = join10(root, PAGE);
+  const before = await changedAt(join10(dir, BUNDLE));
+  const build2 = spawn3(
+    tool(root, "tsup") ?? "tsup",
+    ["--config", "tsup.ui.config.ts", ...WATCHED.flatMap((where) => ["--watch", join10(root, where)])],
+    {
+      stdio: ["ignore", "ignore", "inherit"],
+      cwd: join10(root, "apps", "cli")
+    }
+  );
+  const stop = () => {
+    build2.kill("SIGTERM");
+  };
+  try {
+    await landed(join10(dir, BUNDLE), before);
+  } catch (err) {
+    stop();
+    throw err;
+  }
+  return { dir, stop };
+}
+var PATIENCE2 = 12e4;
+async function landed(file, before) {
+  const until = Date.now() + PATIENCE2;
+  while (Date.now() < until) {
+    if (await changedAt(file) > before) return;
+    await new Promise((done) => setTimeout(done, 100));
+  }
+  throw new Error(`the page did not build within ${PATIENCE2 / 1e3}s \u2014 run \`pnpm build\` there to see why`);
+}
+async function changedAt(file) {
+  try {
+    return (await stat3(file)).mtimeMs;
+  } catch {
+    return 0;
+  }
+}
+function whenRebuilt(dir, reload) {
+  let due = null;
+  return watch(dir, (_event, name) => {
+    if (name !== BUNDLE) return;
+    if (due) clearTimeout(due);
+    due = setTimeout(reload, 120);
+  });
+}
+
 // src/commands/ui.ts
 function register21(program) {
-  program.command("ui").description("Open this repo's board in a browser \u2014 nothing to configure, nothing to join").option("--repo <path>", "The repo to show. Default: the working directory").option("--port <number>", "The port to listen on. Default: 3402").option("--no-open", "Print the address instead of opening a browser").action(async (opts) => {
+  program.command("ui").description("Open this repo's board in a browser \u2014 nothing to configure, nothing to join").option("--repo <path>", "The repo to show. Default: the working directory").option("--port <number>", "The port to listen on. Default: 3402").option("--no-open", "Print the address instead of opening a browser").option("--packaged", "Serve the page this build shipped with, never a checkout's").action(async (opts) => {
     const repo = resolveRepo(opts.repo);
     const port = opts.port ? Number.parseInt(opts.port, 10) : 3402;
+    const source2 = opts.packaged ? null : sourceCheckout();
+    if (source2 && !fromSource()) {
+      console.log(`${basename3(repo)} \u2192 serving ${source2}, from source`);
+      runFromCheckout({ root: source2, repo, port });
+      if (opts.open !== false) void openWhenUp(port);
+      return;
+    }
+    let assets;
+    let stopBuilding;
+    if (source2) {
+      console.log("building the board's page from this checkout\u2026");
+      try {
+        const page = await watchPage(source2);
+        assets = page.dir;
+        stopBuilding = page.stop;
+      } catch (err) {
+        console.error(`could not build the page from ${source2}: ${err instanceof Error ? err.message : String(err)}`);
+        console.error("serving the page this build shipped with instead.");
+      }
+    }
     let server;
     try {
-      server = await serveUi(repo, port);
+      server = await serveUi(repo, port, assets ? { assets } : {});
     } catch (err) {
+      stopBuilding?.();
       const busy = err.code === "EADDRINUSE";
       console.error(
         busy ? `port ${port} is already in use. Something else is on it \u2014 pass --port to pick another.` : `could not start: ${err instanceof Error ? err.message : String(err)}`
@@ -12304,16 +12460,37 @@ function register21(program) {
       process.exitCode = 1;
       return;
     }
+    const watching = assets ? whenRebuilt(assets, server.reload) : null;
     console.log(`${basename3(repo)} \u2192 ${server.url}`);
-    console.log("Reading the board from this checkout. Ctrl-C to stop.");
+    console.log(
+      assets ? "Reading the board from this checkout, and rebuilding the page as you save it. Ctrl-C to stop." : "Reading the board from this checkout. Ctrl-C to stop."
+    );
     if (opts.open !== false) openBrowser({ url: server.url });
     await new Promise((done) => {
-      const stop = () => void server.close().then(done);
+      const stop = () => {
+        watching?.close();
+        stopBuilding?.();
+        void server.close().then(done);
+      };
       process.once("SIGINT", stop);
       process.once("SIGTERM", stop);
     });
   });
 }
+async function openWhenUp(port) {
+  const until = Date.now() + 12e4;
+  while (Date.now() < until) {
+    try {
+      const answered = await fetch(`http://localhost:${port}/api/v1/machine`);
+      if (answered.ok) {
+        openBrowser({ url: `http://localhost:${port}` });
+        return;
+      }
+    } catch {
+    }
+    await new Promise((done) => setTimeout(done, 250));
+  }
+}
 
 // src/commands/work.ts
 import { spawnSync as spawnSync3 } from "child_process";