@davidbalzan/groundwork-console 0.1.7 → 0.1.8

package/README.md

@@ -18,7 +18,7 @@ groundwork-console token     # print the token
 groundwork-console config    # print the config path
 ```
 
-Requires on the host: Node ≥ 22, tmux (pane monitor / spawn), and either the three kit bins above on PATH or a kit checkout at `kitPath` in the config. `doctor` tells you which it found. Console requires: seam `^0.1.0` · agent-coord-mcp `^0.23.0` · groundwork `^0.3.0` · agent-coordination `^0.5.0`.
+Requires on the host: Node ≥ 22, tmux (pane monitor / spawn), and either the three kit bins above on PATH or a kit checkout at `kitPath` in the config. `doctor` tells you which it found. Console requires: seam `^0.1.0` · agent-coord-mcp `^0.24.0` · groundwork `^0.3.0` · agent-coordination `^0.5.0`.
 
 ## From another machine
 

package/dist/gitinfo.js

@@ -1,6 +1,8 @@
 /* Read-only git views for a project's docs: uncommitted hunks (working tree vs HEAD, staged included), last commit touching the file + its hunks, and a docs/ status map. */
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
+import { existsSync } from "node:fs";
+import path from "node:path";
 const run = promisify(execFile);
 async function git(cwd, args) { try {
     const r = await run("git", args, { cwd, maxBuffer: 8 << 20 });
@@ -67,3 +69,115 @@ export async function lastDocsCommit(projectPath) {
     const files = ((await git(projectPath, ["show", "--format=", "--name-only", short, "--", "docs"])) ?? "").split("\n").filter(Boolean).map((f) => f.replace(/^docs\//, ""));
     return { short, subject, date, files };
 }
+const GIT_CACHE_MS = 3_000;
+const STALE_DAYS = 14;
+const GRAPH_MAX = 500;
+const cache = new Map();
+function cached(key, fn) {
+    const hit = cache.get(key);
+    if (hit && Date.now() - hit.at < GIT_CACHE_MS)
+        return hit.value;
+    const value = fn();
+    cache.set(key, { at: Date.now(), value });
+    value.catch(() => cache.delete(key));
+    return value;
+}
+const splitRecords = (out) => (out ?? "").split("\n").filter(Boolean).map((l) => l.split("\x1f"));
+export function gitGraph(projectPath, limit = 200) {
+    const n = Math.max(1, Math.min(GRAPH_MAX, Math.floor(limit) || 200));
+    return cached(`graph:${projectPath}:${n}`, async () => {
+        const head = (await git(projectPath, ["rev-parse", "HEAD"]))?.trim() ?? "";
+        const rows = splitRecords(await git(projectPath, ["log", "--all", "--date-order", `-n${n}`, "--format=%H%x1f%h%x1f%P%x1f%s%x1f%an%x1f%aI%x1f%D"]));
+        const commits = rows.map(([sha, short, parents, subject, author, date, refs]) => ({ sha, short, parents: (parents ?? "").split(" ").filter(Boolean), subject: subject ?? "", author: author ?? "", date: date ?? "", refs: (refs ?? "").split(",").map((r) => r.trim().replace(/^HEAD -> /, "HEAD -> ")).filter(Boolean) }));
+        return { head, commits };
+    });
+}
+/** `git worktree list --porcelain` → entries; dirty = `git status --porcelain` non-empty (skipped for prunable/missing paths); agent from the fleet sibling dir name `<repo>-<agentId>[-<slice>]`, else board owner whose Branch·Worktree column names the branch/path. */
+export function gitWorktrees(projectPath, hints = {}) {
+    return cached(`worktrees:${projectPath}:${(hints.agentIds ?? []).join(",")}`, async () => {
+        const out = (await git(projectPath, ["worktree", "list", "--porcelain"])) ?? "";
+        const blocks = out.split(/\n\s*\n/).map((b) => b.split("\n").filter(Boolean)).filter((b) => b.length);
+        const repoBase = path.basename(projectPath.replace(/\/+$/, ""));
+        const agentIds = [...(hints.agentIds ?? [])].sort((a, b) => b.length - a.length); // longest first: "<project>-worker-1" before "<project>"
+        const worktrees = await Promise.all(blocks.map(async (b, i) => {
+            const get = (k) => b.find((l) => l === k || l.startsWith(k + " "))?.slice(k.length).trim();
+            const wt = get("worktree") ?? "";
+            const sha = get("HEAD") ?? "";
+            const branchRef = get("branch");
+            const prunable = get("prunable") !== undefined;
+            const detached = b.includes("detached") || !branchRef;
+            const branch = branchRef ? branchRef.replace(/^refs\/heads\//, "") : null;
+            const dirty = !prunable && wt && existsSync(wt) ? ((await git(wt, ["status", "--porcelain"])) ?? "").trim().length > 0 : false;
+            const dir = path.basename(wt);
+            let agent;
+            if (i > 0 && dir.startsWith(repoBase + "-")) {
+                const suffix = dir.slice(repoBase.length + 1);
+                agent = agentIds.find((id) => suffix === id || suffix.startsWith(id + "-"));
+            }
+            if (!agent) {
+                const row = hints.boardRows?.find((r) => r.branchWorktree && ((branch && r.branchWorktree.includes(branch)) || r.branchWorktree.includes(dir)));
+                if (row?.owner)
+                    agent = row.owner;
+            }
+            return { path: wt, branch, sha, short: sha.slice(0, 7), detached, dirty, prunable, ...(agent ? { agent } : {}), isMain: i === 0 };
+        }));
+        return { worktrees };
+    });
+}
+/** gh (optional): open/merged/closed PRs by head branch. Missing/unauthenticated gh → null (envelope `ghAvailable:false`). */
+async function ghPrs(projectPath) {
+    try {
+        const r = await run("gh", ["pr", "list", "--state", "all", "--limit", "50", "--json", "number,url,state,title,headRefName"], { cwd: projectPath, maxBuffer: 8 << 20, timeout: 15_000 });
+        const list = JSON.parse(r.stdout);
+        const m = new Map();
+        for (const p of list)
+            if (!m.has(p.headRefName))
+                m.set(p.headRefName, { number: p.number, url: p.url, state: p.state, title: p.title });
+        return m;
+    }
+    catch {
+        return null;
+    }
+}
+export function gitBranches(projectPath, hints = {}) {
+    return cached(`branches:${projectPath}:${(hints.agentIds ?? []).join(",")}`, async () => {
+        const defaultBranch = "main";
+        const base = `origin/${defaultBranch}`;
+        const hasBase = (await git(projectPath, ["rev-parse", "--verify", "-q", `${base}^{commit}`]))?.trim() ? true : false;
+        const rows = splitRecords(await git(projectPath, ["for-each-ref", "--sort=-committerdate", "--format=%(refname)%1f%(objectname)%1f%(objectname:short)%1f%(subject)%1f%(committerdate:iso-strict)", "refs/heads", "refs/remotes"]))
+            .filter(([ref]) => !/^refs\/remotes\/[^/]+\/HEAD$/.test(ref));
+        const [{ worktrees }, prs] = await Promise.all([gitWorktrees(projectPath, hints), ghPrs(projectPath)]);
+        const qaOf = (n) => { const row = hints.openPrs?.find((r) => Object.values(r).some((v) => new RegExp(`(^|[^0-9])#${n}([^0-9]|$)`).test(v))); if (!row)
+            return undefined; const qa = row.mergeGate ?? row.status ?? row.state; return qa ? String(qa) : undefined; };
+        const now = Date.now();
+        const branches = await Promise.all(rows.map(async ([ref, sha, short, subject, date]) => {
+            const remote = ref.startsWith("refs/remotes/");
+            const name = ref.replace(/^refs\/(heads|remotes)\//, "");
+            let ahead = null, behind = null, merged = false;
+            if (hasBase) {
+                const lr = (await git(projectPath, ["rev-list", "--left-right", "--count", `${base}...${ref}`]))?.trim().split(/\s+/);
+                if (lr && lr.length === 2) {
+                    behind = +lr[0];
+                    ahead = +lr[1];
+                }
+                merged = (await gitOk(projectPath, ["merge-base", "--is-ancestor", ref, base]));
+            }
+            const stale = date ? now - Date.parse(date) > STALE_DAYS * 86_400_000 : false;
+            const localName = remote ? name.replace(/^[^/]+\//, "") : name;
+            const wt = remote ? undefined : worktrees.find((w) => w.branch === name);
+            const boardRow = hints.boardRows?.find((r) => r.branchWorktree && r.branchWorktree.includes(localName));
+            const owner = boardRow?.owner || wt?.agent;
+            const pr = prs?.get(localName);
+            const prOut = pr ? { ...pr, ...(qaOf(pr.number) ? { qa: qaOf(pr.number) } : {}) } : undefined;
+            return { name, remote, sha, short, subject: subject ?? "", date: date ?? "", ahead, behind, merged, stale, ...(wt ? { worktree: wt.path } : {}), ...(owner ? { owner } : {}), ...(prOut ? { pr: prOut } : {}) };
+        }));
+        return { defaultBranch, base, baseFound: hasBase, ghAvailable: prs !== null, branches };
+    });
+}
+async function gitOk(cwd, args) { try {
+    await run("git", args, { cwd });
+    return true;
+}
+catch {
+    return false;
+} }

package/dist/kitresolve.js

@@ -2,8 +2,9 @@ import { execFileSync } from "node:child_process";
 import { existsSync, readFileSync, realpathSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-// TODO(kit publish): bump mcp to the version that ships send_message.inReplyTo (kit main 18ffbf4 is still tagged 0.23.0) — until then the capability is detected at runtime (BusClient.supports) and surfaced in /health.requires.mcp.capabilities.
-export const REQUIRES = { seam: "^0.1.0", mcp: "^0.23.0", groundwork: "^0.3.0", playbook: "^0.5.0" };
+// mcp ^0.24.0 ships send_message.inReplyTo (npm 2026-08-19) — that is the floor. send_command's allowlist (/reload-skills since 0.25.0) is NOT a floor:
+// it is feature-detected per connection (BusClient.sendCommands → /health.requires.mcp.capabilities.sendCommand) and the console degrades gracefully without it.
+export const REQUIRES = { seam: "^0.1.0", mcp: "^0.24.0", groundwork: "^0.3.0", playbook: "^0.5.0" };
 const which = (bin) => { try {
     return execFileSync("which", [bin], { encoding: "utf8" }).trim() || null;
 }
@@ -57,25 +58,26 @@ export function installedVersions(kitPath) {
     const gw = groundworkCli(kitPath), pb = playbookCli(kitPath), mcp = mcpServer(kitPath);
     return { seam, groundwork: pkgVersionNear(gw), playbook: pkgVersionNear(pb), mcp: pkgVersionNear(mcp), paths: { groundwork: gw, playbook: pb, mcp, kitCheckout: hasKitCheckout(kitPath) ? kitPath : null } };
 }
-/** Minimal caret-range check (^a.b.c): same major (or same minor when major is 0), and >= min. */
+/** Floor check: the console's requirement is a MINIMUM within the same major (kit packages bump minors often; 0.25.1 must satisfy "^0.24.0").
+    Written as ^a.b.c for familiarity, evaluated as >= a.b.c and < (a+1).0.0 — NOT strict caret semantics for 0.x. */
 export function satisfies(v, range) {
     if (!v)
         return null;
     const m = range.match(/^\^(\d+)\.(\d+)\.(\d+)$/);
     if (!m)
         return null;
-    const [a, b, c] = v.split(".").map(Number);
+    const [a, b, c] = v.split(".").map((n) => parseInt(n, 10));
     const [x, y, z] = m.slice(1).map(Number);
+    if (![a, b, c].every(Number.isFinite))
+        return null;
     if (a !== x)
-        return false;
-    if (x === 0 && b !== y)
-        return false;
-    return a > x || b > y || (b === y && c >= z);
+        return false; // different major: not satisfied (breaking either way)
+    return b > y || (b === y && c >= z);
 }
 export function requiresReport(kitPath, caps) {
     const inst = installedVersions(kitPath);
     const check = (k) => ({ required: REQUIRES[k], installed: inst[k], ok: satisfies(inst[k], REQUIRES[k]) });
-    const r = { seam: check("seam"), mcp: { ...check("mcp"), capabilities: caps ?? { inReplyTo: null }, warnings: caps?.inReplyTo === false ? ["inReplyTo missing — decision replies will not be linked/cleared; upgrade agent-coord-mcp"] : [] }, groundwork: check("groundwork"), playbook: check("playbook") };
+    const r = { seam: check("seam"), mcp: { ...check("mcp"), capabilities: caps ?? { inReplyTo: null, sendCommand: null }, warnings: caps?.inReplyTo === false ? ["inReplyTo missing — decision replies will not be linked/cleared; upgrade agent-coord-mcp"] : [] }, groundwork: check("groundwork"), playbook: check("playbook") };
     return { ...r, paths: inst.paths, ok: Object.values(r).every((x) => x.ok !== false) };
 }
 /** Package root dir for a kit package: the checkout's packages/<dir> if present, else the installed npm package (found from its bin). Null when neither exists. */

package/dist/mcp.js

@@ -74,12 +74,17 @@ export class BusClient {
             const reg = await client.callTool({ name: "register", arguments: { agentId: id.agentId, project: id.project, role: id.role, force: true } });
             log?.(`register → ${JSON.stringify(reg.structuredContent ?? textOf(reg)).slice(0, 160)}`);
             // Feature detection: which args each tool accepts (e.g. send_message.inReplyTo landed in kit 18ffbf4; the live bin may predate it).
+            let sendCommandDesc = "";
             try {
                 const tools = await client.listTools();
-                for (const t of tools.tools)
+                for (const t of tools.tools) {
                     this.toolArgs.set(t.name, new Set(Object.keys(t.inputSchema?.properties ?? {})));
+                    if (t.name === "send_command")
+                        sendCommandDesc = t.description ?? "";
+                }
             }
             catch { /* older server: no detection, pass nothing extra */ }
+            this.commands = await detectCommands(client, sendCommandDesc, log);
             this.client = client;
             return client;
         })();
@@ -91,6 +96,11 @@ export class BusClient {
         }
     }
     toolArgs = new Map();
+    commands = null;
+    /** send_command allowlist detected on the connected server (e.g. ["/clear","/compact"] on 0.24.0, +"/reload-skills" on 0.25.0); null = not connected / undetectable. */
+    get sendCommands() { return this.client ? this.commands : null; }
+    /** True when the connected server accepts this raw control command. */
+    acceptsCommand(cmd) { return this.sendCommands?.includes(cmd) ?? false; }
     /** True when the connected server's tool schema lists this argument (false when unknown or not connected yet). */
     supports(tool, arg) { return this.toolArgs.get(tool)?.has(arg) ?? false; }
     get connected() { return !!this.client; }
@@ -109,6 +119,34 @@ export class BusClient {
     }
     async close() { await this.client?.close(); this.client = null; }
 }
+/* send_command allowlist detection. The MCP does not expose the allowlist in the tool schema (command is a plain string), so:
+   1. probe once per connection with a command that can never be valid — the server rejects it BEFORE looking at to/room or touching any pane
+      (transport.ts sendCommandTool: normalizeControlCommand → `unsupported command '…'. Allowed: /clear, /compact[, /reload-skills]`), so this is
+      side-effect-free and needs no bus-writes gate; 2. fall back to the tool description ("allowlist is locked to /clear, /compact and /reload-skills"). */
+const PROBE_COMMAND = "/__groundwork-console-probe__";
+async function detectCommands(client, description, log) {
+    const fromText = (t) => { const m = t.match(/Allowed:\s*([^\n]+)/i) ?? t.match(/locked to ([^.;\n]+)/i); return m ? [...m[1].matchAll(/\/[a-z][\w-]*/g)].map((x) => x[0]) : []; };
+    try {
+        const res = await client.callTool({ name: "send_command", arguments: { from: "groundwork-console", command: PROBE_COMMAND } });
+        const out = (res.structuredContent ?? parseText(textOf(res)));
+        const list = fromText(typeof out === "string" ? out : out?.error ?? textOf(res));
+        if (list.length) {
+            log?.(`send_command allowlist (probe): ${list.join(" ")}`);
+            return list;
+        }
+    }
+    catch (e) {
+        const list = fromText(e.message ?? "");
+        if (list.length)
+            return list;
+    }
+    const list = fromText(description);
+    if (list.length) {
+        log?.(`send_command allowlist (description): ${list.join(" ")}`);
+        return list;
+    }
+    return null;
+}
 function textOf(r) { return (r.content ?? []).map((c) => c.text ?? "").join("\n"); }
 function parseText(t) { try {
     return JSON.parse(t);

package/dist/server.js

@@ -20,7 +20,7 @@ import { detectedHarnesses, groundworkSkills, playbookCards } from "./skills.js"
 import { extensionsOf } from "./extensions.js";
 import { parseWorkDoc, workstreamsExtensionsOf } from "@davidbalzan/groundwork-seam";
 import { EventEngine } from "./events.js";
-import { docGit, docsStatus, lastDocsCommit } from "./gitinfo.js";
+import { docGit, docsStatus, lastDocsCommit, gitGraph, gitBranches, gitWorktrees } from "./gitinfo.js";
 import { Notifier } from "./notify.js";
 import { Runs } from "./runs.js";
 import { BusClient, AGENT_ID, busWrites, seamWrites, saveSwitches, SWITCHES_FILE } from "./mcp.js";
@@ -46,7 +46,9 @@ const notifier = new Notifier(cfg, runs, events);
 const busDavid = new BusClient(cfg.kitPath, cfg.coordDir, "david", process.env.AGENT_COORD_MCP);
 const clientFor = (id) => (id === "david" ? busDavid : bus);
 /** Capabilities of the connected MCP (null until a client has connected and listed tools). */
-const mcpCaps = () => ({ inReplyTo: bus.connected ? bus.supports("send_message", "inReplyTo") : busDavid.connected ? busDavid.supports("send_message", "inReplyTo") : null });
+const mcpCaps = () => { const cl = bus.connected ? bus : busDavid.connected ? busDavid : null; return { inReplyTo: cl ? cl.supports("send_message", "inReplyTo") : null, sendCommand: cl ? cl.sendCommands : null }; };
+/* Live tmux-attached agents — the only valid send_command targets (the MCP hard-gates to tmux-push/-remote). */
+const liveAttached = () => agents(cfg.coordDir).filter((a) => a.liveness === "live" && (a.transport === "tmux-push" || a.transport === "tmux-push-remote")).map((a) => a.agentId);
 const PUBLIC_DIR = path.resolve(HERE, "../public");
 const root = new Hono();
 const app = new Hono().basePath("/api");
@@ -113,13 +115,24 @@ app.post("/actions/send", async (c) => {
         return c.json({ error: "text required" }, 400);
     if (!b.room && !b.to)
         return c.json({ error: "room or to required" }, 400);
-    // Raw control commands: exactly `/clear` or `/compact` (no args) to ONE agent go through MCP send_command — the only path that types a slash command
-    // into a live CLI (allowlist locked to these two in the MCP; widening it — /reload-skills etc. — is a kit decision, not done here). Everything else is a text DM.
-    const RAW_COMMANDS = new Set(["/clear", "/compact"]);
+    // Raw control commands: a bare `/<cmd>` (no args) to ONE agent goes through MCP send_command — the only path that types a slash command into a live CLI.
+    // The allowlist is the CONNECTED server's (feature-detected: 0.24.0 = /clear /compact; 0.25.0 adds /reload-skills — BusClient.sendCommands). A bare slash
+    // command the server does not accept degrades to the text wrapper `AGENT_ACTION: run /<cmd>` (never a 4xx; the agent runs it from the request, #14).
     const cmd = b.text.trim();
-    if (RAW_COMMANDS.has(cmd)) {
-        if (!b.to)
-            return c.json({ error: `${cmd} is unicast — pick an agent (rooms get text only)` }, 400);
+    let degraded;
+    if (/^\/[a-z][\w-]*$/i.test(cmd) && b.to) {
+        const cl = clientFor(who);
+        try {
+            await cl.connect();
+        }
+        catch { /* not connected → no raw path; fall through to the text DM */ }
+        if (!cl.acceptsCommand(cmd)) {
+            const have = cl.sendCommands;
+            degraded = `${cmd} is not in the connected agent-coord-mcp's send_command allowlist (${have ? have.join(" ") : "unknown"})${cmd === "/reload-skills" ? " — needs agent-coord-mcp ≥0.25.0 + MCP session restart" : ""}; sent as a text request instead`;
+            b.text = `AGENT_ACTION: run ${cmd}`;
+        }
+    }
+    if (/^\/[a-z][\w-]*$/i.test(cmd) && !degraded && (b.to ? clientFor(who).acceptsCommand(cmd) : false)) {
         const r = await runs.exec({ kind: "bus", label: `command ${cmd} → ${b.to}`, sideEffects: true, args: { as: who, to: b.to, command: cmd } }, async (log) => {
             const out = (await clientFor(who).call("send_command", { to: b.to, command: cmd, waitForDelivery: true, deliveryTimeoutMs: 15_000 }, log));
             log(`delivery: ${out.delivery ?? "?"}${out.reason ? ` · ${out.reason}` : ""}${out.note ? ` · ${out.note}` : ""}`);
@@ -130,6 +143,8 @@ app.post("/actions/send", async (c) => {
         const out = (r.result ?? {});
         return c.json({ ...r, raw: true, delivery: out.delivery ?? null, warning: out.delivery === "pending" ? `pusher has not confirmed typing ${cmd} yet${out.reason ? ` — ${out.reason}` : ""}` : undefined }, r.status === "ok" ? 200 : 403);
     }
+    if (/^\/[a-z][\w-]*$/i.test(cmd) && b.room && !b.to)
+        return c.json({ error: `${cmd} is unicast — pick an agent (rooms get text only)` }, 400);
     const PREFIX_RE = /^(BLOCKER|RISK|DONE|FYI|AGENT_ACTION|GO|SCOPE CHANGE|VERDICT|DAVID_DECISION)\b/;
     if (b.room && !PREFIX_RE.test(b.text))
         return c.json({ error: "room posts need a prefix (FYI / AGENT_ACTION / DAVID_DECISION / BLOCKER / RISK / DONE / GO / SCOPE CHANGE / VERDICT)" }, 400);
@@ -137,6 +152,8 @@ app.post("/actions/send", async (c) => {
     const r = await runs.exec({ kind: "bus", label: `send as ${who} ${target}`, sideEffects: true, args: { as: who, room: b.room, to: b.to, kind: b.kind, text: b.text.slice(0, 200) } }, async (log) => {
         const cl = clientFor(who);
         await cl.connect(log);
+        if (degraded)
+            log(`⚠ ${degraded}`);
         // Reply linkage = bus inReplyTo only (console-owned answered.json retired 2026-08-19). Parent: explicit from the UI (answers[0] / inReplyTo);
         // for a DM as David with no explicit parent, the latest still-open DAVID_DECISION DM from that agent — so "reply to the agent" clears its packet.
         let parent = b.inReplyTo ?? b.answers?.[0];
@@ -164,6 +181,56 @@ app.post("/actions/send", async (c) => {
         }
         return out;
     });
+    return c.json({ ...r, ...(degraded ? { raw: false, degraded: true, warning: degraded } : {}) }, r.status === "ok" ? 200 : 403);
+});
+/* Ops › Skills: after a playbook update, push `/reload-skills` RAW to every live tmux-attached agent (send_command, bus-writes gated, only when the connected
+   MCP's allowlist carries it — 0.25.0+). Per-agent delivery confirmed|pending in the Run. Targets may be narrowed with `agentIds`. */
+app.get("/actions/reload-skills", async (c) => {
+    const cl = bus;
+    try {
+        await cl.connect();
+    }
+    catch { /* report what we know */ }
+    return c.json({ supported: cl.acceptsCommand("/reload-skills"), allowlist: cl.sendCommands, agents: liveAttached(), hint: cl.acceptsCommand("/reload-skills") ? null : "needs agent-coord-mcp ≥0.25.0 (send_command allowlist with /reload-skills) + a restart of the console's MCP session and the fleet's" });
+});
+app.post("/actions/reload-skills", async (c) => {
+    const b = (await c.req.json().catch(() => ({})));
+    if (b.confirm !== "RELOAD")
+        return c.json({ error: "confirm must be RELOAD" }, 400);
+    if (!busWrites.enabled)
+        return c.json({ error: "bus writes are off — switch them on in the header (WRITES) first" }, 403);
+    const cl = bus;
+    try {
+        await cl.connect();
+    }
+    catch (e) {
+        return c.json({ error: e.message }, 500);
+    }
+    if (!cl.acceptsCommand("/reload-skills"))
+        return c.json({ error: `connected agent-coord-mcp does not accept /reload-skills (allowlist ${cl.sendCommands?.join(" ") ?? "unknown"}) — needs ≥0.25.0 + MCP session restart` }, 409);
+    const live = liveAttached();
+    const targets = (b.agentIds?.length ? b.agentIds.filter((id) => live.includes(id)) : live);
+    if (!targets.length)
+        return c.json({ error: "no live tmux-attached agents to reload" }, 400);
+    const r = await runs.exec({ kind: "bus", label: `reload skills → ${targets.length} session${targets.length === 1 ? "" : "s"}`, sideEffects: true, args: { agentIds: targets } }, async (log) => {
+        const results = [];
+        for (const to of targets) {
+            try {
+                const out = (await cl.call("send_command", { to, command: "/reload-skills", waitForDelivery: true, deliveryTimeoutMs: 15_000 }, log));
+                const delivery = out.error ? `error: ${out.error}` : out.delivery ?? "?";
+                results.push({ agentId: to, delivery, ...(out.reason ? { reason: out.reason } : {}) });
+                log(`${to}: ${delivery}${out.reason ? ` · ${out.reason}` : ""}`);
+            }
+            catch (e) {
+                results.push({ agentId: to, delivery: `error: ${e.message}` });
+                log(`${to}: error ${e.message}`);
+            }
+        }
+        const confirmed = results.filter((x) => x.delivery === "confirmed").length, pending = results.filter((x) => x.delivery === "pending").length;
+        if (confirmed + pending === 0)
+            throw new Error(`no session accepted /reload-skills (${results.map((x) => `${x.agentId}: ${x.delivery}`).join("; ")})`); // an all-error push is a failed Run, never ok
+        return { results, confirmed, pending };
+    });
     return c.json(r, r.status === "ok" ? 200 : 403);
 });
 /* Uploads — pasted images for DMs. Path + served URL both go into the message text as `[image: <path> · <url>]`.
@@ -307,6 +374,50 @@ app.get("/projects/:name/status", async (c) => {
         return c.json({ error: "unknown project" }, 404);
     return c.json(await status(cfg.kitPath, p.path));
 });
+/* ---- Git branches screen v1 (docs/contracts/git-screen-v1.md): read-only git/gh, 3 s cache, errors → { error } ---- */
+const gitHints = (p) => {
+    const src = existsSync(path.join(p.path, "docs/WORKSTREAMS.md")) ? readFileSync(path.join(p.path, "docs/WORKSTREAMS.md"), "utf8") : null;
+    const rows = boardOf(p.path).workstreams.rows.flatMap((r) => ("branchWorktree" in r ? [{ owner: r.owner, branchWorktree: r.branchWorktree }] : []));
+    let openPrs = [];
+    try {
+        openPrs = src ? workstreamsExtensionsOf(parseWorkDoc(src)).openPrs : [];
+    }
+    catch { /* board unparsable → no qa column */ }
+    return { agentIds: agents(cfg.coordDir).map((a) => a.agentId), boardRows: rows, openPrs };
+};
+app.get("/projects/:name/git/graph", async (c) => {
+    const p = project(c.req.param("name"));
+    if (!p)
+        return c.json({ error: "unknown project" }, 404);
+    try {
+        return c.json(await gitGraph(p.path, Number(c.req.query("limit") ?? 200)));
+    }
+    catch (e) {
+        return c.json({ error: e.message }, 500);
+    }
+});
+app.get("/projects/:name/git/branches", async (c) => {
+    const p = project(c.req.param("name"));
+    if (!p)
+        return c.json({ error: "unknown project" }, 404);
+    try {
+        return c.json(await gitBranches(p.path, gitHints(p)));
+    }
+    catch (e) {
+        return c.json({ error: e.message }, 500);
+    }
+});
+app.get("/projects/:name/git/worktrees", async (c) => {
+    const p = project(c.req.param("name"));
+    if (!p)
+        return c.json({ error: "unknown project" }, 404);
+    try {
+        return c.json(await gitWorktrees(p.path, gitHints(p)));
+    }
+    catch (e) {
+        return c.json({ error: e.message }, 500);
+    }
+});
 app.get("/projects/:name/skills", async (c) => {
     const p = project(c.req.param("name"));
     if (!p)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@davidbalzan/groundwork-console",
   "private": false,
-  "version": "0.1.7",
+  "version": "0.1.8",
   "type": "module",
   "dependencies": {
     "@davidbalzan/groundwork-seam": "^0.1.0",

package/public/assets/{abnfDiagram-N423BO3Z-B0nns4cA.js → abnfDiagram-N423BO3Z-oco1yJr8.js}

@@ -1 +1 @@
-import{m as e,t}from"./mermaid-parser.core-B1iqIz20.js";import{n}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import{m as r}from"./src-l8EnJwXz.js";import"./chunk-I66GZJ75-BD9h95Vq.js";import{n as i,r as a,t as o}from"./chunk-6Q2QTUOP-C3vYg7rX.js";import{t as s}from"./chunk-JWPE2WC7-DVXcaiue.js";import"./mermaid.core-CuFK5CuK.js";var c=e().RailroadAbnf.parser.LangiumParser,l=n(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=n(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=n(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=n(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=n(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=n(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=n(e=>{s(e,o),e.title&&o.setTitle(e.title),e.rules.map(e=>o.addRule(m(e)))},`populateDb`),g={parser:{parse:n(e=>{o.clear(),r.debug(`[ABNF Parser] Starting Langium parse`);let n=c.parse(e);if(n.lexerErrors.length>0||n.parserErrors.length>0)throw new t(n);let i=n.value;r.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),r.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:o}},db:o,renderer:a,styles:i};export{g as diagram};
+import{m as e,t}from"./mermaid-parser.core-BXY3JF8d.js";import{n}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import{m as r}from"./src-D5IewQLB.js";import"./chunk-I66GZJ75-C97VIOWu.js";import{n as i,r as a,t as o}from"./chunk-6Q2QTUOP-nWUr6zuz.js";import{t as s}from"./chunk-JWPE2WC7-DVXcaiue.js";import"./mermaid.core-DqjaFy6t.js";var c=e().RailroadAbnf.parser.LangiumParser,l=n(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=n(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=n(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=n(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=n(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=n(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=n(e=>{s(e,o),e.title&&o.setTitle(e.title),e.rules.map(e=>o.addRule(m(e)))},`populateDb`),g={parser:{parse:n(e=>{o.clear(),r.debug(`[ABNF Parser] Starting Langium parse`);let n=c.parse(e);if(n.lexerErrors.length>0||n.parserErrors.length>0)throw new t(n);let i=n.value;r.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),r.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:o}},db:o,renderer:a,styles:i};export{g as diagram};

package/public/assets/{arc-DsDgWIU7.js → arc-D-FYRBZ0.js}

@@ -1 +1 @@
-import{n as e,t}from"./path-fybaL0A-.js";import{a as n,c as r,d as i,f as a,i as o,l as s,m as c,n as l,o as u,p as d,r as f,u as p}from"./dist-BnkmMC7M.js";function m(e){return e.innerRadius}function h(e){return e.outerRadius}function g(e){return e.startAngle}function _(e){return e.endAngle}function v(e){return e&&e.padAngle}function y(e,t,n,r,i,a,o,s){var c=n-e,l=r-t,u=o-i,d=s-a,f=d*c-u*l;if(!(f*f<1e-12))return f=(u*(t-a)-d*(e-i))/f,[e+f*c,t+f*l]}function b(e,t,n,r,i,a,o){var c=e-n,l=t-r,u=(o?a:-a)/d(c*c+l*l),f=u*l,p=-u*c,m=e+f,h=t+p,g=n+f,_=r+p,v=(m+g)/2,y=(h+_)/2,b=g-m,x=_-h,S=b*b+x*x,C=i-a,w=m*_-g*h,T=(x<0?-1:1)*d(s(0,C*C*S-w*w)),E=(w*x-b*T)/S,D=(-w*b-x*T)/S,O=(w*x+b*T)/S,k=(-w*b+x*T)/S,A=E-v,j=D-y,M=O-v,N=k-y;return A*A+j*j>M*M+N*N&&(E=O,D=k),{cx:E,cy:D,x01:-f,y01:-p,x11:E*(i/C-1),y11:D*(i/C-1)}}function x(){var s=m,x=h,S=e(0),C=null,w=g,T=_,E=v,D=null,O=t(k);function k(){var e,t,m=+s.apply(this,arguments),h=+x.apply(this,arguments),g=w.apply(this,arguments)-r,_=T.apply(this,arguments)-r,v=l(_-g),k=_>g;if(D||=e=O(),h<m&&(t=h,h=m,m=t),!(h>1e-12))D.moveTo(0,0);else if(v>c-1e-12)D.moveTo(h*u(g),h*a(g)),D.arc(0,0,h,g,_,!k),m>1e-12&&(D.moveTo(m*u(_),m*a(_)),D.arc(0,0,m,_,g,k));else{var A=g,j=_,M=g,N=_,P=v,F=v,I=E.apply(this,arguments)/2,L=I>1e-12&&(C?+C.apply(this,arguments):d(m*m+h*h)),R=p(l(h-m)/2,+S.apply(this,arguments)),z=R,B=R,V,H;if(L>1e-12){var U=o(L/m*a(I)),W=o(L/h*a(I));(P-=U*2)>1e-12?(U*=k?1:-1,M+=U,N-=U):(P=0,M=N=(g+_)/2),(F-=W*2)>1e-12?(W*=k?1:-1,A+=W,j-=W):(F=0,A=j=(g+_)/2)}var G=h*u(A),K=h*a(A),q=m*u(N),J=m*a(N);if(R>1e-12){var Y=h*u(j),X=h*a(j),Z=m*u(M),Q=m*a(M),$;if(v<i){if($=y(G,K,Z,Q,Y,X,q,J)){var ee=G-$[0],te=K-$[1],ne=Y-$[0],re=X-$[1],ie=1/a(f((ee*ne+te*re)/(d(ee*ee+te*te)*d(ne*ne+re*re)))/2),ae=d($[0]*$[0]+$[1]*$[1]);z=p(R,(m-ae)/(ie-1)),B=p(R,(h-ae)/(ie+1))}else z=B=0}}F>1e-12?B>1e-12?(V=b(Z,Q,G,K,h,B,k),H=b(Y,X,q,J,h,B,k),D.moveTo(V.cx+V.x01,V.cy+V.y01),B<R?D.arc(V.cx,V.cy,B,n(V.y01,V.x01),n(H.y01,H.x01),!k):(D.arc(V.cx,V.cy,B,n(V.y01,V.x01),n(V.y11,V.x11),!k),D.arc(0,0,h,n(V.cy+V.y11,V.cx+V.x11),n(H.cy+H.y11,H.cx+H.x11),!k),D.arc(H.cx,H.cy,B,n(H.y11,H.x11),n(H.y01,H.x01),!k))):(D.moveTo(G,K),D.arc(0,0,h,A,j,!k)):D.moveTo(G,K),!(m>1e-12)||!(P>1e-12)?D.lineTo(q,J):z>1e-12?(V=b(q,J,Y,X,m,-z,k),H=b(G,K,Z,Q,m,-z,k),D.lineTo(V.cx+V.x01,V.cy+V.y01),z<R?D.arc(V.cx,V.cy,z,n(V.y01,V.x01),n(H.y01,H.x01),!k):(D.arc(V.cx,V.cy,z,n(V.y01,V.x01),n(V.y11,V.x11),!k),D.arc(0,0,m,n(V.cy+V.y11,V.cx+V.x11),n(H.cy+H.y11,H.cx+H.x11),k),D.arc(H.cx,H.cy,z,n(H.y11,H.x11),n(H.y01,H.x01),!k))):D.arc(0,0,m,N,M,k)}if(D.closePath(),e)return D=null,e+``||null}return k.centroid=function(){var e=(+s.apply(this,arguments)+ +x.apply(this,arguments))/2,t=(+w.apply(this,arguments)+ +T.apply(this,arguments))/2-i/2;return[u(t)*e,a(t)*e]},k.innerRadius=function(t){return arguments.length?(s=typeof t==`function`?t:e(+t),k):s},k.outerRadius=function(t){return arguments.length?(x=typeof t==`function`?t:e(+t),k):x},k.cornerRadius=function(t){return arguments.length?(S=typeof t==`function`?t:e(+t),k):S},k.padRadius=function(t){return arguments.length?(C=t==null?null:typeof t==`function`?t:e(+t),k):C},k.startAngle=function(t){return arguments.length?(w=typeof t==`function`?t:e(+t),k):w},k.endAngle=function(t){return arguments.length?(T=typeof t==`function`?t:e(+t),k):T},k.padAngle=function(t){return arguments.length?(E=typeof t==`function`?t:e(+t),k):E},k.context=function(e){return arguments.length?(D=e??null,k):D},k}export{x as t};
+import{n as e,t}from"./path-fybaL0A-.js";import{a as n,c as r,d as i,f as a,i as o,l as s,m as c,n as l,o as u,p as d,r as f,u as p}from"./dist-DoiwlY9_.js";function m(e){return e.innerRadius}function h(e){return e.outerRadius}function g(e){return e.startAngle}function _(e){return e.endAngle}function v(e){return e&&e.padAngle}function y(e,t,n,r,i,a,o,s){var c=n-e,l=r-t,u=o-i,d=s-a,f=d*c-u*l;if(!(f*f<1e-12))return f=(u*(t-a)-d*(e-i))/f,[e+f*c,t+f*l]}function b(e,t,n,r,i,a,o){var c=e-n,l=t-r,u=(o?a:-a)/d(c*c+l*l),f=u*l,p=-u*c,m=e+f,h=t+p,g=n+f,_=r+p,v=(m+g)/2,y=(h+_)/2,b=g-m,x=_-h,S=b*b+x*x,C=i-a,w=m*_-g*h,T=(x<0?-1:1)*d(s(0,C*C*S-w*w)),E=(w*x-b*T)/S,D=(-w*b-x*T)/S,O=(w*x+b*T)/S,k=(-w*b+x*T)/S,A=E-v,j=D-y,M=O-v,N=k-y;return A*A+j*j>M*M+N*N&&(E=O,D=k),{cx:E,cy:D,x01:-f,y01:-p,x11:E*(i/C-1),y11:D*(i/C-1)}}function x(){var s=m,x=h,S=e(0),C=null,w=g,T=_,E=v,D=null,O=t(k);function k(){var e,t,m=+s.apply(this,arguments),h=+x.apply(this,arguments),g=w.apply(this,arguments)-r,_=T.apply(this,arguments)-r,v=l(_-g),k=_>g;if(D||=e=O(),h<m&&(t=h,h=m,m=t),!(h>1e-12))D.moveTo(0,0);else if(v>c-1e-12)D.moveTo(h*u(g),h*a(g)),D.arc(0,0,h,g,_,!k),m>1e-12&&(D.moveTo(m*u(_),m*a(_)),D.arc(0,0,m,_,g,k));else{var A=g,j=_,M=g,N=_,P=v,F=v,I=E.apply(this,arguments)/2,L=I>1e-12&&(C?+C.apply(this,arguments):d(m*m+h*h)),R=p(l(h-m)/2,+S.apply(this,arguments)),z=R,B=R,V,H;if(L>1e-12){var U=o(L/m*a(I)),W=o(L/h*a(I));(P-=U*2)>1e-12?(U*=k?1:-1,M+=U,N-=U):(P=0,M=N=(g+_)/2),(F-=W*2)>1e-12?(W*=k?1:-1,A+=W,j-=W):(F=0,A=j=(g+_)/2)}var G=h*u(A),K=h*a(A),q=m*u(N),J=m*a(N);if(R>1e-12){var Y=h*u(j),X=h*a(j),Z=m*u(M),Q=m*a(M),$;if(v<i){if($=y(G,K,Z,Q,Y,X,q,J)){var ee=G-$[0],te=K-$[1],ne=Y-$[0],re=X-$[1],ie=1/a(f((ee*ne+te*re)/(d(ee*ee+te*te)*d(ne*ne+re*re)))/2),ae=d($[0]*$[0]+$[1]*$[1]);z=p(R,(m-ae)/(ie-1)),B=p(R,(h-ae)/(ie+1))}else z=B=0}}F>1e-12?B>1e-12?(V=b(Z,Q,G,K,h,B,k),H=b(Y,X,q,J,h,B,k),D.moveTo(V.cx+V.x01,V.cy+V.y01),B<R?D.arc(V.cx,V.cy,B,n(V.y01,V.x01),n(H.y01,H.x01),!k):(D.arc(V.cx,V.cy,B,n(V.y01,V.x01),n(V.y11,V.x11),!k),D.arc(0,0,h,n(V.cy+V.y11,V.cx+V.x11),n(H.cy+H.y11,H.cx+H.x11),!k),D.arc(H.cx,H.cy,B,n(H.y11,H.x11),n(H.y01,H.x01),!k))):(D.moveTo(G,K),D.arc(0,0,h,A,j,!k)):D.moveTo(G,K),!(m>1e-12)||!(P>1e-12)?D.lineTo(q,J):z>1e-12?(V=b(q,J,Y,X,m,-z,k),H=b(G,K,Z,Q,m,-z,k),D.lineTo(V.cx+V.x01,V.cy+V.y01),z<R?D.arc(V.cx,V.cy,z,n(V.y01,V.x01),n(H.y01,H.x01),!k):(D.arc(V.cx,V.cy,z,n(V.y01,V.x01),n(V.y11,V.x11),!k),D.arc(0,0,m,n(V.cy+V.y11,V.cx+V.x11),n(H.cy+H.y11,H.cx+H.x11),k),D.arc(H.cx,H.cy,z,n(H.y11,H.x11),n(H.y01,H.x01),!k))):D.arc(0,0,m,N,M,k)}if(D.closePath(),e)return D=null,e+``||null}return k.centroid=function(){var e=(+s.apply(this,arguments)+ +x.apply(this,arguments))/2,t=(+w.apply(this,arguments)+ +T.apply(this,arguments))/2-i/2;return[u(t)*e,a(t)*e]},k.innerRadius=function(t){return arguments.length?(s=typeof t==`function`?t:e(+t),k):s},k.outerRadius=function(t){return arguments.length?(x=typeof t==`function`?t:e(+t),k):x},k.cornerRadius=function(t){return arguments.length?(S=typeof t==`function`?t:e(+t),k):S},k.padRadius=function(t){return arguments.length?(C=t==null?null:typeof t==`function`?t:e(+t),k):C},k.startAngle=function(t){return arguments.length?(w=typeof t==`function`?t:e(+t),k):w},k.endAngle=function(t){return arguments.length?(T=typeof t==`function`?t:e(+t),k):T},k.padAngle=function(t){return arguments.length?(E=typeof t==`function`?t:e(+t),k):E},k.context=function(e){return arguments.length?(D=e??null,k):D},k}export{x as t};

package/public/assets/architecture-TIHT7OUA-bBJswTmy.js

@@ -0,0 +1 @@
+import"./chunk-KEIR6QF5-BICK3FdT.js";import{M as e}from"./mermaid-parser.core-BXY3JF8d.js";export{e as createArchitectureServices};