@appchy/jarvis 0.1.48 → 0.1.50

package/dist/bin.js

@@ -669,8 +669,8 @@ function rpcRouter() {
         return;
       }
       if (Array.isArray(parsed)) {
-        for (const item of parsed) {
-          await this.dispatch(ctx, item, send);
+        for (const item2 of parsed) {
+          await this.dispatch(ctx, item2, send);
         }
         return;
       }
@@ -748,7 +748,7 @@ function startIpcServer(socketPath, userId) {
   };
 }
 async function callDaemonIpc(socketPath, method, params, timeoutMs = 5e3) {
-  return new Promise((resolve9, reject) => {
+  return new Promise((resolve10, 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(() => resolve9(parsed.result));
+          finish(() => resolve10(parsed.result));
         }
       } catch (err) {
         finish(() => reject(err instanceof Error ? err : new Error(String(err))));
@@ -1106,9 +1106,21 @@ function writeRootsDirect(roots) {
 }
 
 // src/exchange.ts
-import { execSync as execSync2 } from "child_process";
 import os3 from "os";
 import { createInterface } from "readline";
+
+// src/browser.ts
+import { execSync as execSync2 } from "child_process";
+function openBrowser(req) {
+  try {
+    if (process.platform === "darwin") execSync2(`open "${req.url}"`);
+    else if (process.platform === "win32") execSync2(`start "" "${req.url}"`);
+    else execSync2(`xdg-open "${req.url}"`);
+  } catch {
+  }
+}
+
+// src/exchange.ts
 var POLL_INTERVAL_MS2 = 2e3;
 var POLL_TIMEOUT_MS = 10 * 6e4;
 async function exchangeCode(req) {
@@ -1203,21 +1215,13 @@ function humanizeAgo(iso) {
 }
 function readlineQuestion(req) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve9) => {
+  return new Promise((resolve10) => {
     rl.question(req.prompt, (answer) => {
       rl.close();
-      resolve9(answer);
+      resolve10(answer);
     });
   });
 }
-function openBrowser(req) {
-  try {
-    if (process.platform === "darwin") execSync2(`open "${req.url}"`);
-    else if (process.platform === "win32") execSync2(`start "" "${req.url}"`);
-    else execSync2(`xdg-open "${req.url}"`);
-  } catch {
-  }
-}
 function sleep(ms) {
   return new Promise((r) => setTimeout(r, ms));
 }
@@ -2286,10 +2290,10 @@ function rootsEqual(a, b) {
 }
 async function readlineQuestion2(question) {
   const rl = createInterface2({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve9) => {
+  return new Promise((resolve10) => {
     rl.question(question, (input) => {
       rl.close();
-      resolve9(input);
+      resolve10(input);
     });
   });
 }
@@ -2366,8 +2370,8 @@ function defaultPrompts() {
 }
 async function promptList(question, fallback) {
   const rl = createInterface2({ input: process.stdin, output: process.stdout });
-  const answer = await new Promise((resolve9) => {
-    rl.question(question, (input) => resolve9(input.trim()));
+  const answer = await new Promise((resolve10) => {
+    rl.question(question, (input) => resolve10(input.trim()));
   });
   rl.close();
   const raw = !answer ? fallback : answer.split(",").map((s) => s.trim()).filter(Boolean);
@@ -2521,8 +2525,8 @@ function register5(program) {
 }
 async function confirm(question) {
   const rl = createInterface3({ input: process.stdin, output: process.stdout });
-  const answer = await new Promise((resolve9) => {
-    rl.question(question, (input) => resolve9(input.trim()));
+  const answer = await new Promise((resolve10) => {
+    rl.question(question, (input) => resolve10(input.trim()));
   });
   rl.close();
   return /^y(es)?$/i.test(answer);
@@ -2768,7 +2772,7 @@ async function idOf(term) {
       } catch {
       }
     }
-    await new Promise((resolve9) => setTimeout(resolve9, 250));
+    await new Promise((resolve10) => setTimeout(resolve10, 250));
   }
   throw new Error("Claude Code started but never registered a session id");
 }
@@ -2837,13 +2841,13 @@ async function live(req) {
     else options.signal.addEventListener("abort", () => term.kill(), { once: true });
   }
   rest();
-  await new Promise((resolve9) => {
+  await new Promise((resolve10) => {
     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));
-      resolve9();
+      resolve10();
     });
   });
 }
@@ -4189,6 +4193,19 @@ function toHolders(commits) {
   }
   return distinct;
 }
+function toHoldersByItem(commits) {
+  const byItem = /* @__PURE__ */ new Map();
+  for (const commit of commits) {
+    for (const id of readTrailers(commit.message).items) {
+      const forItem = byItem.get(id);
+      if (forItem) forItem.push(commit);
+      else byItem.set(id, [commit]);
+    }
+  }
+  const holders = /* @__PURE__ */ new Map();
+  for (const [id, forItem] of byItem) holders.set(id, toHolders(forItem));
+  return holders;
+}
 function warning(holders, mine) {
   const others = holders.filter((holder) => holder.session !== mine);
   if (others.length === 0) return "";
@@ -4207,6 +4224,7 @@ function isQuiet(commit) {
 }
 function readTrailers(message) {
   const events = [];
+  const items = [];
   let session = "";
   let machine = "";
   for (const raw of message.split("\n")) {
@@ -4214,10 +4232,11 @@ function readTrailers(message) {
     const m = /^(Work-[A-Za-z]+):\s*(.*)$/.exec(line);
     if (!m) continue;
     if (m[1] === "Work-Event" && m[2]) events.push(m[2]);
+    if (m[1] === "Work-Item" && m[2]) items.push(m[2]);
     if (m[1] === "Work-Session") session = m[2] ?? "";
     if (m[1] === "Work-Machine") machine = m[2] ?? "";
   }
-  return { session, machine, events };
+  return { session, machine, events, items };
 }
 function describeAge(when) {
   const at = Date.parse(when);
@@ -4232,6 +4251,8 @@ 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) {
@@ -4279,6 +4300,48 @@ async function git2(root, argv) {
 function escapeGrep(value) {
   return value.replace(/[^A-Za-z0-9_-]/g, (c) => `\\${c}`);
 }
+async function boardHistory(root) {
+  const [out, tips] = await Promise.all([
+    git2(root, ["log", "--all", "--source", "--reverse", `--format=${SOURCED}`, "-E", `--grep=${TRAILER}`]),
+    branchTips(root)
+  ]);
+  const commits = [];
+  for (const record of out.split(REC)) {
+    if (!record.trim()) continue;
+    const [sha, ref, when, author, message] = record.split(SEP);
+    if (!message || !sha) continue;
+    const branch = shorten(ref ?? "");
+    commits.push({
+      sha,
+      when: when ?? "",
+      by: author ?? "",
+      message,
+      branch,
+      branchLastCommitAt: tips.get(branch) ?? ""
+    });
+  }
+  return commits;
+}
+async function branchTips(root) {
+  const out = await git2(root, [
+    "for-each-ref",
+    `--format=%(refname:short)${SEP}%(committerdate:iso-strict)`,
+    "refs/heads",
+    "refs/remotes"
+  ]);
+  const tips = /* @__PURE__ */ new Map();
+  for (const line of out.split("\n")) {
+    const [name, when] = line.split(SEP);
+    if (name && when) tips.set(name, when);
+  }
+  return tips;
+}
+function shorten(ref) {
+  return ref.replace(/^refs\/(heads|remotes)\//, "");
+}
+async function listHoldersByItem(root) {
+  return toHoldersByItem(await boardHistory(root));
+}
 async function listHolders(root, id) {
   return toHolders(await boardCommits(root, id));
 }
@@ -4291,11 +4354,11 @@ import { promisify as promisify5 } from "util";
 
 // ../../packages/errors/src/errors.ts
 var ServiceError = class extends Error {
-  constructor(message, code, statusCode = 500, context) {
+  constructor(message, code, statusCode = 500, context2) {
     super(message);
     this.code = code;
     this.statusCode = statusCode;
-    this.context = context;
+    this.context = context2;
     this.name = "ServiceError";
     Error.captureStackTrace?.(this, this.constructor);
   }
@@ -4320,8 +4383,8 @@ var NotFoundError = class extends ServiceError {
   }
 };
 var ConflictError = class extends ServiceError {
-  constructor(message, context) {
-    super(message, "CONFLICT", 409, context);
+  constructor(message, context2) {
+    super(message, "CONFLICT", 409, context2);
     this.name = "ConflictError";
   }
 };
@@ -4351,7 +4414,7 @@ function toWorkItem(req) {
     code: asList(front.code),
     covers: asList(front.covers),
     dependsOn: asList(front.depends_on),
-    epic: backlog ? parts[1] ?? "" : parts[2] ?? "",
+    epic: backlog ? parts[1] ?? "" : parts.at(-4) ?? "",
     version: backlog ? "backlog" : parts[1] ?? "",
     path: req.path,
     holders: [],
@@ -4359,7 +4422,7 @@ function toWorkItem(req) {
   };
 }
 function toPage(items, req) {
-  const matched = items.filter((item) => req.status ? item.status === req.status : true).filter((item) => req.owner ? item.owner === req.owner : true).filter((item) => req.epic ? item.epic === req.epic : true).filter((item) => req.version ? item.version === req.version : true).sort(byPriorityThenName);
+  const matched = items.filter((item2) => req.status ? item2.status === req.status : true).filter((item2) => req.owner ? item2.owner === req.owner : true).filter((item2) => req.epic ? item2.epic === req.epic : true).filter((item2) => req.version ? item2.version === req.version : true).sort(byPriorityThenName);
   const offset = req.offset ?? 0;
   const limit2 = Math.min(req.limit ?? DEFAULT_LIMIT, MAX_LIMIT);
   const page = matched.slice(offset, offset + limit2);
@@ -4447,12 +4510,19 @@ async function listWorkItems(_ctx, req, options) {
 }
 async function findWorkItem(_ctx, req, options) {
   const all = await scanTree(options.root);
-  return all.find((item) => item.id === req.id) ?? null;
+  return all.find((item2) => item2.id === req.id) ?? null;
 }
 async function getWorkItem(ctx, req, options) {
-  const item = await findWorkItem(ctx, req, options);
-  if (!item) throw new NotFoundError("work item", req.id);
-  return item;
+  const item2 = await findWorkItem(ctx, req, options);
+  if (!item2) throw new NotFoundError("work item", req.id);
+  return item2;
+}
+async function getBrief(_ctx, req, options) {
+  try {
+    return await readFile(join3(options.root, "work", req.path), "utf-8");
+  } catch {
+    return null;
+  }
 }
 async function createWorkItem(ctx, req, options) {
   await harness(
@@ -4577,8 +4647,8 @@ async function scanTree(root) {
       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 item = toWorkItem({ path: path22, text, changedAt });
-      if (item) items.push(item);
+      const item2 = toWorkItem({ path: path22, text, changedAt });
+      if (item2) items.push(item2);
     }
   }
   return items;
@@ -4606,14 +4676,10 @@ function notices(_ctx, _id) {
 }
 async function listWorkItems2(ctx, req, options) {
   const page = await listWorkItems(ctx, req, options);
-  const items = await Promise.all(
-    page.items.map(async (item) => ({
-      ...item,
-      holders: await listHolders(options.root, item.id)
-    }))
-  );
+  const holders = await listHoldersByItem(options.root);
+  const items = page.items.map((item2) => ({ ...item2, holders: holders.get(item2.id) ?? [] }));
   if (!req.takeable) return { ...page, items, notices: notices(ctx) };
-  const free = items.filter((item) => item.holders.length === 0);
+  const free = items.filter((item2) => item2.holders.length === 0);
   return {
     items: free,
     offset: page.offset,
@@ -4623,13 +4689,21 @@ async function listWorkItems2(ctx, req, options) {
     notices: notices(ctx)
   };
 }
+async function getWorkItem2(ctx, req, options) {
+  const item2 = await getWorkItem(ctx, { id: req.id }, options);
+  const [holders, brief3] = await Promise.all([
+    listHolders(options.root, item2.id),
+    getBrief(ctx, { path: item2.path }, options)
+  ]);
+  return { item: { ...item2, holders }, brief: brief3, notices: notices(ctx, item2.id) };
+}
 async function takeWorkItem(ctx, req, options) {
-  const item = await getWorkItem(ctx, { id: req.id }, options);
+  const item2 = await getWorkItem(ctx, { id: req.id }, options);
   const before = await listHolders(options.root, req.id);
   const note = warning(before, req.sessionId ?? "");
   if (req.sessionId)
     await recordSession(ctx, { id: req.id, sessionId: req.sessionId }, options);
-  const moved = item.status === "in-progress" ? await getWorkItem(ctx, { id: req.id }, options) : await moveWorkItem(
+  const moved = item2.status === "in-progress" ? await getWorkItem(ctx, { id: req.id }, options) : await moveWorkItem(
     ctx,
     {
       id: req.id,
@@ -4645,19 +4719,19 @@ async function takeWorkItem(ctx, req, options) {
   };
 }
 async function updateWorkItem(ctx, req, options) {
-  let item = await getWorkItem(ctx, { id: req.id }, options);
+  let item2 = await getWorkItem(ctx, { id: req.id }, options);
   if (req.observed) {
-    item = await observeWorkItem(
+    item2 = await observeWorkItem(
       ctx,
       { id: req.id, ac: req.observed.ac, saw: req.observed.saw },
       options
     );
   }
   if (req.sessionId) {
-    item = await recordSession(ctx, { id: req.id, sessionId: req.sessionId }, options);
+    item2 = await recordSession(ctx, { id: req.id, sessionId: req.sessionId }, options);
   }
   if (req.question) {
-    item = await askWorkItem(
+    item2 = await askWorkItem(
       ctx,
       {
         id: req.id,
@@ -4669,7 +4743,7 @@ async function updateWorkItem(ctx, req, options) {
     );
   }
   return {
-    item: { ...item, holders: await listHolders(options.root, req.id) },
+    item: { ...item2, holders: await listHolders(options.root, req.id) },
     notices: notices(ctx, req.id)
   };
 }
@@ -4677,7 +4751,7 @@ async function completeWorkItem2(ctx, req, options) {
   for (const seen of req.observed ?? []) {
     await observeWorkItem(ctx, { id: req.id, ac: seen.ac, saw: seen.saw }, options);
   }
-  const item = await completeWorkItem(
+  const item2 = await completeWorkItem(
     ctx,
     {
       id: req.id,
@@ -4688,7 +4762,7 @@ async function completeWorkItem2(ctx, req, options) {
     options
   );
   return {
-    item: { ...item, holders: await listHolders(options.root, req.id) },
+    item: { ...item2, holders: await listHolders(options.root, req.id) },
     notices: notices(ctx, req.id)
   };
 }
@@ -4697,9 +4771,9 @@ async function verifyWorkItem2(ctx, req, options) {
   return { ...verified, notices: notices(ctx, req.id) };
 }
 async function createWorkItem2(ctx, req, options) {
-  const item = await createWorkItem(ctx, req, options);
+  const item2 = await createWorkItem(ctx, req, options);
   return {
-    item: { ...item, holders: await listHolders(options.root, item.id) },
+    item: { ...item2, holders: await listHolders(options.root, item2.id) },
     notices: notices(ctx)
   };
 }
@@ -4795,6 +4869,9 @@ function parseList(params) {
   if (params && typeof params !== "object") throw new Error("params must be an object");
   return params ?? {};
 }
+function parseGet(params) {
+  return { id: requireId(params) };
+}
 function parseTake(params) {
   const p = fields(params);
   const actor = p.actor;
@@ -4845,6 +4922,9 @@ function parseCreate(params) {
 async function list(ctx, req) {
   return listWorkItems2(ctx, req, boardOptions());
 }
+async function get(ctx, req) {
+  return getWorkItem2(ctx, req, boardOptions());
+}
 async function take(ctx, req) {
   return takeWorkItem(ctx, req, boardOptions());
 }
@@ -4861,6 +4941,7 @@ async function create(ctx, req) {
   return createWorkItem2(ctx, req, boardOptions());
 }
 router.method("board.list", parseList, list);
+router.method("board.get", parseGet, get);
 router.method("board.take", parseTake, take);
 router.method("board.update", parseUpdate, update);
 router.method("board.verify", parseVerify, verify);
@@ -5119,10 +5200,10 @@ var GraphStore = class {
     }
   }
 };
-function pushInto(map2, key, item) {
+function pushInto(map2, key, item2) {
   const list4 = map2.get(key);
-  if (list4) list4.push(item);
-  else map2.set(key, [item]);
+  if (list4) list4.push(item2);
+  else map2.set(key, [item2]);
 }
 function describeRef(to) {
   return typeof to === "string" ? to : `${to.type}:${to.name}`;
@@ -5237,36 +5318,36 @@ async function find(run6, spec) {
   const listed = await guard(run6, spec.name, () => spec.from.list(ctx));
   if (listed === void 0) return void 0;
   const kept = [];
-  for (const item of listed) {
-    const checked = await validate(run6, spec, item);
+  for (const item2 of listed) {
+    const checked = await validate(run6, spec, item2);
     if (checked) kept.push(checked);
   }
   return {
     spec,
-    entries: kept.map((item) => ({ item, record: {}, items: [] })),
+    entries: kept.map((item2) => ({ item: item2, record: {}, items: [] })),
     ledger: { name: spec.name, items: kept.length, nodes: 0, edges: {}, reserved: {} }
   };
 }
-async function validate(run6, spec, item) {
+async function validate(run6, spec, item2) {
   const schema = spec.from.schema;
-  if (!schema) return item;
+  if (!schema) return item2;
   const checked = await guard(
     run6,
     spec.name,
-    async () => await schema["~standard"].validate(item.data)
+    async () => await schema["~standard"].validate(item2.data)
   );
   if (checked === void 0) return void 0;
   if (checked.issues) {
     run6.report({
       severity: "error",
       code: "MAP_SCHEMA",
-      message: `${spec.name}: ${item.ref} does not match its schema \u2014 ${issueText(checked.issues)}. Keys present: ${keyText(item.data)}`,
+      message: `${spec.name}: ${item2.ref} does not match its schema \u2014 ${issueText(checked.issues)}. Keys present: ${keyText(item2.data)}`,
       plugin: spec.name,
-      ...item.file !== void 0 ? { file: item.file } : {}
+      ...item2.file !== void 0 ? { file: item2.file } : {}
     });
     return void 0;
   }
-  return { ...item, data: checked.value };
+  return { ...item2, data: checked.value };
 }
 async function shape(run6, scope2) {
   const ctx = mapContext(run6, scope2.spec.name);
@@ -5378,8 +5459,8 @@ function toNodeInput(id, record, req) {
     if (key === "items" || key === "links" || key === "rel" || key === "inverse" || key === "ref")
       continue;
     if (RESERVED.includes(key) || key === "id") continue;
-    const json = jsonOf(value);
-    if (json !== void 0) free[key] = json;
+    const json2 = jsonOf(value);
+    if (json2 !== void 0) free[key] = json2;
   }
   return {
     id,
@@ -5409,16 +5490,16 @@ function jsonOf(value) {
   if (Array.isArray(value)) {
     const out = [];
     for (const one of value) {
-      const json = jsonOf(one);
-      if (json !== void 0) out.push(json);
+      const json2 = jsonOf(one);
+      if (json2 !== void 0) out.push(json2);
     }
     return out;
   }
   if (typeof value === "object") {
     const out = {};
     for (const [key, held] of Object.entries(value)) {
-      const json = jsonOf(held);
-      if (json !== void 0) out[key] = json;
+      const json2 = jsonOf(held);
+      if (json2 !== void 0) out[key] = json2;
     }
     return out;
   }
@@ -6026,8 +6107,8 @@ async function pool(items, limit2, work) {
   let next = 0;
   const runners = Array.from({ length: Math.min(limit2, items.length) }, async () => {
     for (let i = next++; i < items.length; i = next++) {
-      const item = items[i];
-      if (item !== void 0) await work(item);
+      const item2 = items[i];
+      if (item2 !== void 0) await work(item2);
     }
   });
   await Promise.all(runners);
@@ -6806,8 +6887,8 @@ function notReadyMs() {
 var PENDING = /* @__PURE__ */ Symbol("pending");
 async function readyWithin(pending) {
   let timer;
-  const timeout = new Promise((resolve9) => {
-    timer = setTimeout(() => resolve9(PENDING), notReadyMs());
+  const timeout = new Promise((resolve10) => {
+    timer = setTimeout(() => resolve10(PENDING), notReadyMs());
     timer.unref?.();
   });
   try {
@@ -7110,34 +7191,34 @@ function workLadder(graph2) {
   for (const node of graph2.nodes()) {
     if (typeof node.metadata.statusCategory === "string") items.push(node);
   }
-  const isItem = new Set(items.map((item) => item.id));
+  const isItem = new Set(items.map((item2) => item2.id));
   const containers = /* @__PURE__ */ new Set();
   const holders = /* @__PURE__ */ new Map();
-  for (const item of items) {
-    for (const edge of graph2.edges({ from: item.id, relation: "belongs_to" })) {
+  for (const item2 of items) {
+    for (const edge of graph2.edges({ from: item2.id, relation: "belongs_to" })) {
       if (!isItem.has(edge.to)) continue;
       containers.add(edge.to);
-      holders.set(item.id, edge.to);
+      holders.set(item2.id, edge.to);
     }
   }
   const children = /* @__PURE__ */ new Map();
   const roots = [];
-  for (const item of items) {
-    const home = holders.get(item.id);
+  for (const item2 of items) {
+    const home = holders.get(item2.id);
     if (home === void 0) {
-      roots.push(item);
+      roots.push(item2);
       continue;
     }
     const bucket = children.get(home) ?? { containers: [], leaves: [] };
-    (containers.has(item.id) ? bucket.containers : bucket.leaves).push(item);
+    (containers.has(item2.id) ? bucket.containers : bucket.leaves).push(item2);
     children.set(home, bucket);
   }
   const members = /* @__PURE__ */ new Map();
-  for (const item of items) {
-    if (containers.has(item.id)) continue;
-    const category = String(item.metadata.statusCategory);
-    const seen = /* @__PURE__ */ new Set([item.id]);
-    let home = holders.get(item.id);
+  for (const item2 of items) {
+    if (containers.has(item2.id)) continue;
+    const category = String(item2.metadata.statusCategory);
+    const seen = /* @__PURE__ */ new Set([item2.id]);
+    let home = holders.get(item2.id);
     while (home !== void 0 && !seen.has(home)) {
       seen.add(home);
       const rollup = members.get(home) ?? {};
@@ -7149,7 +7230,7 @@ function workLadder(graph2) {
   return { items, containers, holders, children, members, roots };
 }
 function leavesOf(ladder) {
-  return ladder.items.filter((item) => !ladder.containers.has(item.id));
+  return ladder.items.filter((item2) => !ladder.containers.has(item2.id));
 }
 
 // ../../packages/data/src/mcp/tools/cache.ts
@@ -7314,15 +7395,15 @@ async function brief(ctx, req) {
   const leaves = leavesOf(ladder);
   const byCategory = {};
   const inFlight = [];
-  for (const item of leaves) {
-    const category = String(item.metadata.statusCategory);
+  for (const item2 of leaves) {
+    const category = String(item2.metadata.statusCategory);
     byCategory[category] = (byCategory[category] ?? 0) + 1;
     if (category === "in-progress")
-      inFlight.push(renderWorkItem(ctx, item, ladder.holders.get(item.id)));
+      inFlight.push(renderWorkItem(ctx, item2, ladder.holders.get(item2.id)));
   }
   const openItems = leaves.filter((i) => i.metadata.statusCategory === "open");
-  for (const item of openItems.slice(0, Math.max(0, itemCap - inFlight.length))) {
-    inFlight.push(renderWorkItem(ctx, item, ladder.holders.get(item.id)));
+  for (const item2 of openItems.slice(0, Math.max(0, itemCap - inFlight.length))) {
+    inFlight.push(renderWorkItem(ctx, item2, ladder.holders.get(item2.id)));
   }
   const shown = inFlight.slice(0, itemCap);
   const allContainers = [...ladder.containers].map((id) => ctx.graph.node(id)).filter((n) => n !== void 0).map((n) => ({
@@ -7407,15 +7488,15 @@ function byContainerRelevance(a, b) {
   const size = (c) => Object.values(c.members).reduce((sum, n) => sum + n, 0);
   return flight(b) - flight(a) || size(b) - size(a) || a.id.localeCompare(b.id);
 }
-function renderWorkItem(ctx, item, home) {
-  const priority = item.metadata.priority;
-  const dependsOn = ctx.graph.edges({ from: item.id, relation: "depends_on" }).map((e) => e.to);
+function renderWorkItem(ctx, item2, home) {
+  const priority = item2.metadata.priority;
+  const dependsOn = ctx.graph.edges({ from: item2.id, relation: "depends_on" }).map((e) => e.to);
   return {
-    id: item.id,
-    ...labelOf(item) ? { title: labelOf(item) } : {},
-    type: item.type,
-    ...typeof item.metadata.status === "string" ? { status: item.metadata.status } : {},
-    statusCategory: String(item.metadata.statusCategory),
+    id: item2.id,
+    ...labelOf(item2) ? { title: labelOf(item2) } : {},
+    type: item2.type,
+    ...typeof item2.metadata.status === "string" ? { status: item2.metadata.status } : {},
+    statusCategory: String(item2.metadata.statusCategory),
     ...typeof priority === "string" ? { priority } : {},
     ...dependsOn.length ? { dependsOn } : {},
     ...home !== void 0 ? { belongsTo: home } : {}
@@ -7476,7 +7557,7 @@ function listConnections(ctx, req) {
   const statusOf0 = start ? statusOf(start) : void 0;
   const seen = new Set(startIds);
   const withStatus = /* @__PURE__ */ new Map();
-  const context = /* @__PURE__ */ new Map();
+  const context2 = /* @__PURE__ */ new Map();
   let settled = 0;
   const take2 = (id, via) => {
     if (seen.has(id)) return false;
@@ -7488,7 +7569,7 @@ function listConnections(ctx, req) {
       if (via === void 0 && wants(ctx, node, req.direction)) {
         const thing = render(ctx, node);
         const key = thing.id ?? thing.file ?? id;
-        if (!context.has(key)) context.set(key, thing);
+        if (!context2.has(key)) context2.set(key, thing);
       }
       return true;
     }
@@ -7517,7 +7598,7 @@ function listConnections(ctx, req) {
   );
   const page = ordered.slice(0, limit2);
   const label = start ? labelOf(start) ?? start.id : req.node;
-  const read3 = [...context.values()];
+  const read3 = [...context2.values()];
   const nothing = ordered.length === 0 && read3.length === 0;
   return {
     summary: nothing ? `Nothing in the map connects to ${label}.` : `${label} connects to ${ordered.length} thing(s) still open${settled > 0 ? ` (and ${settled} settled)` : ""}${read3.length > 0 ? `, plus ${read3.length} it is read against` : ""}.${ordered.length === 0 ? " Nothing open is on it." : ""}`,
@@ -8331,10 +8412,10 @@ function buildEditSet(ctx, found, limit2, namedGovIds, origin) {
       confidence: "precise",
       ...origin ? { origin } : {}
     });
-    const named = namedGovIds.has(hit.id);
+    const named2 = namedGovIds.has(hit.id);
     for (const r of enforcing.results) {
       if (!r.file) continue;
-      if (named) namedGovFiles.add(r.file);
+      if (named2) namedGovFiles.add(r.file);
       const why = `enforces ${hit.id}`;
       const existing = byFile.get(r.file);
       if (existing) existing.why = existing.why ? `${existing.why}; ${why}` : why;
@@ -9084,11 +9165,11 @@ function graph() {
 }
 function refuseAnotherBranch(req) {
   const asked = req ?? {};
-  const named = typeof asked.branch === "string" ? asked.branch : asked.ref;
-  if (typeof named !== "string" || !named.trim()) return;
+  const named2 = typeof asked.branch === "string" ? asked.branch : asked.ref;
+  if (typeof named2 !== "string" || !named2.trim()) return;
   throw new RpcError(
     JSON_RPC.INVALID_PARAMS,
-    `the map answers for the branch this machine has checked out, and cannot answer for '${named}'. It is built from one checkout, so an answer for another branch would join this branch's code to that branch's work \u2014 which looks like an answer and is not one. Check that branch out and rebuild, or ask the BOARD instead, which does read any branch: \`work list --branch ${named}\` or \`work find\`.`,
+    `the map answers for the branch this machine has checked out, and cannot answer for '${named2}'. It is built from one checkout, so an answer for another branch would join this branch's code to that branch's work \u2014 which looks like an answer and is not one. Check that branch out and rebuild, or ask the BOARD instead, which does read any branch: \`work list --branch ${named2}\` or \`work find\`.`,
     { type: "map_is_per_checkout" }
   );
 }
@@ -9540,7 +9621,7 @@ function parseList2(params) {
   if (params && typeof params !== "object") throw new Error("params must be an object");
   return params ?? {};
 }
-function parseGet(params) {
+function parseGet2(params) {
   if (!params || typeof params !== "object") throw new Error("params required");
   const p = params;
   if (typeof p.id !== "string") throw new Error("id required");
@@ -9570,7 +9651,7 @@ function parseDelete(params) {
 async function list2(ctx, req) {
   return listNotifications(ctx, req);
 }
-async function get(ctx, req) {
+async function get2(ctx, req) {
   return getNotification(ctx, req);
 }
 async function create2(ctx, req) {
@@ -9584,7 +9665,7 @@ async function remove(ctx, req) {
   return { ok: true };
 }
 router.method("notifications.list", parseList2, list2);
-router.method("notifications.get", parseGet, get);
+router.method("notifications.get", parseGet2, get2);
 router.method("notifications.create", parseCreate2, create2);
 router.method("notifications.update", parseUpdate2, update2);
 router.method("notifications.delete", parseDelete, remove);
@@ -9667,7 +9748,7 @@ function parseList3(params) {
   if (params && typeof params !== "object") throw new Error("params must be an object");
   return params ?? {};
 }
-function parseGet2(params) {
+function parseGet3(params) {
   if (!params || typeof params !== "object") throw new Error("params required");
   const p = params;
   if (typeof p.id !== "string") throw new Error("id required");
@@ -9677,12 +9758,12 @@ async function list3(ctx, req) {
   void ctx;
   return listSessions(req);
 }
-async function get2(ctx, req) {
+async function get3(ctx, req) {
   void ctx;
   return getSession(req);
 }
 router.method("sessions.list", parseList3, list3);
-router.method("sessions.get", parseGet2, get2);
+router.method("sessions.get", parseGet3, get3);
 
 // src/workdir.ts
 import { exec as execCb } from "child_process";
@@ -9788,8 +9869,8 @@ 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 = "5b34716";
-var BUILT = "2026-09-08";
+var SHA = "de4a370";
+var BUILT = "2026-09-09";
 var BUILD = SHA ?? "source";
 var BUILD_LABEL = `${SHA ? `${VERSION2} (${SHA}${BUILT ? ` ${BUILT}` : ""})` : `${VERSION2} (source)`}${IS_DEV ? " \u2014 development build" : ""}`;
 
@@ -10139,12 +10220,12 @@ async function startAgent(options) {
     upstream.onConnected(() => {
       if (!paired) {
         paired = true;
-        const board = findBoardOrigin(options.workspacePath);
+        const board2 = findBoardOrigin(options.workspacePath);
         publish(envCtx, "env.paired", {
           envId,
           version: process.env.JARVIS_VERSION ?? "0.0.0",
           os: `${os9.type()} ${os9.release()}`,
-          ...board ? { boardRepo: board.repo, boardBranch: board.branch } : {}
+          ...board2 ? { boardRepo: board2.repo, boardBranch: board2.branch } : {}
         });
       }
       publish(envCtx, "env.heartbeat", { envId, at: (/* @__PURE__ */ new Date()).toISOString() });
@@ -10242,7 +10323,7 @@ async function startAgent(options) {
         timestamp: Date.now()
       };
       publish(envCtx, "env.disconnected", { envId: options.envId, reason: "shutdown" });
-      await new Promise((resolve9) => setImmediate(resolve9));
+      await new Promise((resolve10) => setImmediate(resolve10));
     }
     if (heartbeatTimer) clearInterval(heartbeatTimer);
     if (ipcServer) {
@@ -10519,10 +10600,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((resolve9) => {
+  const reachable = await new Promise((resolve10) => {
     const done = (answer) => {
       socket.destroy();
-      resolve9(answer);
+      resolve10(answer);
     };
     const socket = net2.connect({ host: new URL(url).hostname, port }).once("connect", () => done(true)).once("error", () => done(false));
     socket.setTimeout(probeMs, () => done(false));
@@ -10695,10 +10776,10 @@ function removeDir(p) {
 }
 function confirm2(prompt) {
   const rl = createInterface4({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve9) => {
+  return new Promise((resolve10) => {
     rl.question(prompt, (answer) => {
       rl.close();
-      resolve9(/^y(es)?$/i.test(answer.trim()));
+      resolve10(/^y(es)?$/i.test(answer.trim()));
     });
   });
 }
@@ -11588,10 +11669,10 @@ function createTool(handlers) {
     }
   };
 }
-function describeItem(item) {
-  const held = item.holders && item.holders.length > 0 ? ` \xB7 held by ${item.holders.map((holder) => holder.by || holder.session).join(", ")}` : "";
-  const priority = item.priority ? ` ${item.priority}` : "";
-  return `${item.id} \xB7 ${item.status}${priority}${held} \u2014 ${item.title}`;
+function describeItem(item2) {
+  const held = item2.holders && item2.holders.length > 0 ? ` \xB7 held by ${item2.holders.map((holder) => holder.by || holder.session).join(", ")}` : "";
+  const priority = item2.priority ? ` ${item2.priority}` : "";
+  return `${item2.id} \xB7 ${item2.status}${priority}${held} \u2014 ${item2.title}`;
 }
 function describeList(response) {
   if (response.items.length === 0) return "No work items match.";
@@ -11888,9 +11969,140 @@ function register20(program) {
   });
 }
 
+// src/commands/ui.ts
+import { basename as basename2 } from "path";
+
+// src/ui/server.ts
+import { createServer as createServer2 } from "http";
+import { readFile as readFile7 } from "fs/promises";
+import { basename, dirname as dirname7, extname, join as join9, resolve as resolve9 } from "path";
+import { fileURLToPath as fileURLToPath4 } from "url";
+var ASSETS = resolve9(dirname7(fileURLToPath4(import.meta.url)), "ui");
+var TYPES = {
+  ".html": "text/html; charset=utf-8",
+  ".js": "text/javascript; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".map": "application/json; charset=utf-8"
+};
+function named(html, repo) {
+  return html.replace("<title>Jarvis</title>", `<title>${basename(repo).replace(/[<>]/g, "")} \xB7 Jarvis</title>`);
+}
+function context() {
+  return { requestId: `ui-${Date.now().toString(36)}`, userId: "local" };
+}
+function json(res, status2, body) {
+  const payload2 = JSON.stringify(body);
+  res.writeHead(status2, {
+    "content-type": "application/json; charset=utf-8",
+    "content-length": Buffer.byteLength(payload2),
+    // The board changes under you as sessions work it; a cached page would show a board that has
+    // moved on and give no sign of it.
+    "cache-control": "no-store"
+  });
+  res.end(payload2);
+}
+async function board(repo, url, res) {
+  const req = {};
+  const limit2 = url.searchParams.get("limit");
+  if (limit2) req.limit = Number.parseInt(limit2, 10);
+  const offset = url.searchParams.get("offset");
+  if (offset) req.offset = Number.parseInt(offset, 10);
+  const status2 = url.searchParams.get("status");
+  if (status2) req.status = status2;
+  const page = await listWorkItems2(context(), req, { root: repo, harness: harness2() });
+  json(res, 200, { items: page.items, total: page.total, hasMore: page.hasMore });
+}
+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) {
+  const wanted = url.pathname === "/" || !extname(url.pathname) ? "/index.html" : url.pathname;
+  const path22 = join9(ASSETS, wanted);
+  if (!path22.startsWith(ASSETS)) {
+    res.writeHead(403).end("no");
+    return;
+  }
+  try {
+    const raw = await readFile7(path22);
+    const body = extname(path22) === ".html" ? Buffer.from(named(raw.toString("utf-8"), repo)) : raw;
+    res.writeHead(200, {
+      "content-type": TYPES[extname(path22)] ?? "application/octet-stream",
+      "content-length": body.byteLength
+    });
+    res.end(body);
+  } catch {
+    res.writeHead(404, { "content-type": "text/plain; charset=utf-8" });
+    res.end(
+      "not found. If this is a fresh checkout, the UI is built by `pnpm --filter @appchy/jarvis build`."
+    );
+  }
+}
+function serveUi(repo, port) {
+  const server = createServer2((req, res) => {
+    const url = new URL(req.url ?? "/", "http://localhost");
+    void (async () => {
+      try {
+        if (url.pathname.startsWith("/api/v1/board/items")) {
+          if (req.method !== "GET") {
+            json(res, 405, {
+              error: "this board is read-only here. Changing it runs the harness that owns the tree's invariants \u2014 use `jarvis work` for now."
+            });
+            return;
+          }
+          const id = url.pathname.slice("/api/v1/board/items".length).replace(/^\//, "");
+          if (id) await item(repo, decodeURIComponent(id), res);
+          else await board(repo, url, res);
+          return;
+        }
+        await asset(repo, url, res);
+      } catch (err) {
+        const status2 = err instanceof ServiceError ? err.statusCode : 500;
+        json(res, status2, { error: err instanceof Error ? err.message : String(err) });
+      }
+    })();
+  });
+  return new Promise((ok, fail) => {
+    server.once("error", fail);
+    server.listen(port, "127.0.0.1", () => {
+      ok({
+        url: `http://localhost:${port}`,
+        close: () => new Promise((done) => server.close(() => done()))
+      });
+    });
+  });
+}
+
+// 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) => {
+    const repo = resolveRepo(opts.repo);
+    const port = opts.port ? Number.parseInt(opts.port, 10) : 3402;
+    let server;
+    try {
+      server = await serveUi(repo, port);
+    } catch (err) {
+      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)}`
+      );
+      process.exitCode = 1;
+      return;
+    }
+    console.log(`${basename2(repo)} \u2192 ${server.url}`);
+    console.log("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);
+      process.once("SIGINT", stop);
+      process.once("SIGTERM", stop);
+    });
+  });
+}
+
 // src/commands/work.ts
 import { spawnSync as spawnSync3 } from "child_process";
-function register21(program) {
+function register22(program) {
   program.command("work").description("The board \u2014 take work, prove it, finish it").argument("[args...]", "Passed to the harness untouched").allowUnknownOption().passThroughOptions().helpOption(false).action((passed) => {
     const problem = harnessProblem();
     if (problem) {
@@ -11934,6 +12146,7 @@ function createCli() {
   register20(program);
   register2(program);
   register21(program);
+  register22(program);
   return program;
 }