@davidbalzan/groundwork-console 0.1.12 → 0.1.14

package/dist/bus.js

@@ -19,6 +19,54 @@ const tailJsonl = (p, limit) => {
         return { malformed: true, raw: l };
     } });
 };
+/* Thresholds are judgement, not measurement, and are stated here rather than buried: "producing"
+   is the working cadence, and >8h is the shape of an overnight stall. The 2h boundary exists
+   because the previous model put a coffee break and a seventeen-hour stall in one bucket. */
+const EMITTING_MS = 2 * 3_600_000;
+const SILENT_MS = 8 * 3_600_000;
+const SCAN_LINES = 4000;
+/** Newest emission per agent, from the room logs and the status stream. */
+export function outputIndex(root, scanLines = SCAN_LINES) {
+    const out = new Map();
+    const note = (from, ts, basis) => {
+        if (typeof from !== "string" || typeof ts !== "number")
+            return;
+        const prev = out.get(from);
+        if (!prev || ts > prev.ts)
+            out.set(from, { ts, basis });
+    };
+    const roomDir = path.join(root, "rooms");
+    if (existsSync(roomDir))
+        for (const f of readdirSync(roomDir).filter((x) => x.endsWith(".jsonl"))) {
+            for (const m of tailJsonl(path.join(roomDir, f), scanLines))
+                note(m.from, m.ts, "room");
+        }
+    for (const m of tailJsonl(path.join(root, "status.jsonl"), scanLines))
+        note(m.agentId ?? m.from, m.ts, "status");
+    /* DMs count as output and are NOT in the room logs — they are rows in the RECIPIENT's inbox,
+       carrying the sender in `from`. Omitting them made an agent working entirely by DM read as
+       stalled; that was caught on the first live run, where this console's own worker showed
+       `stalled` while it had been reporting by DM all morning. Scanning inboxes attributes each
+       message to its sender, not its owner. */
+    const inboxDir = path.join(root, "inbox");
+    if (existsSync(inboxDir))
+        for (const f of readdirSync(inboxDir).filter((x) => x.endsWith(".jsonl"))) {
+            for (const m of tailJsonl(path.join(inboxDir, f), scanLines))
+                note(m.from, m.ts, "dm");
+        }
+    return out;
+}
+/* `unknown` is NOT "no output" — it is "none within the scanned window", and the window is reported
+   so a caller can tell the two apart. Collapsing them would be the same defect one level down. */
+const progressOf = (hit, now, scanLines) => {
+    if (!hit)
+        return { lastOutputAt: null, ageMs: null, state: "unknown", basis: null, scannedLines: scanLines, measures: "bus-emissions" };
+    const ageMs = now - hit.ts;
+    return { lastOutputAt: hit.ts, ageMs, state: ageMs < EMITTING_MS ? "emitting" : ageMs < SILENT_MS ? "quiet-on-bus" : "silent-on-bus", basis: hit.basis, scannedLines: scanLines, measures: "bus-emissions" };
+};
+/* Reachability buckets. `idle` used to span 15 MINUTES to 24 HOURS, so a coffee break and an
+   overnight stall rendered identically; `dormant` splits that. */
+export const reachOf = (age) => age < 15 * 60_000 ? "live" : age < 2 * 3_600_000 ? "idle" : age < 24 * 3_600_000 ? "dormant" : "dead";
 export async function agentsAsync(root) {
     const panes = await listPanes();
     const base = agentsSync(root);
@@ -33,11 +81,14 @@ export async function agentsAsync(root) {
         const paneActivity = ct === undefined || ct === null ? windowActivity : ct || null; // 0 = seeded, no change observed yet → treated as unknown, not as "now"
         const lastSeen = Math.max(a.lastSeen ?? 0, paneActivity ?? 0);
         const age = lastSeen ? Date.now() - lastSeen : Infinity;
-        return { ...a, paneActivity, windowActivity, windowName: pane?.windowName ?? null, paneCommand: pane?.command ?? null, paneAlive: pane ? !pane.dead : null, lastSeen: lastSeen || null, heartbeatAgeMs: Number.isFinite(age) ? age : null, liveness: age < 15 * 60_000 ? "live" : age < 24 * 3_600_000 ? "idle" : "dead", active: paneActivity ? Date.now() - paneActivity < 60_000 : false };
+        /* paneActivity is another REACHABILITY input, not progress: a pane redraws when a message is pasted into
+           it. It is deliberately not folded into `progress`, which stays as agentsSync computed it. */
+        return { ...a, paneActivity, windowActivity, windowName: pane?.windowName ?? null, paneCommand: pane?.command ?? null, paneAlive: pane ? !pane.dead : null, lastSeen: lastSeen || null, heartbeatAgeMs: Number.isFinite(age) ? age : null, reachability: reachOf(age), active: paneActivity ? Date.now() - paneActivity < 60_000 : false };
     }).sort((a, b) => (b.lastSeen ?? 0) - (a.lastSeen ?? 0));
 }
 export const agents = agentsSync;
-export function agentsSync(root) {
+export function agentsSync(root, scanLines = SCAN_LINES) {
+    const output = outputIndex(root, scanLines);
     const reg = readJson(path.join(root, "agents.json"), {});
     const transports = existsSync(path.join(root, "transports")) ? new Set(readdirSync(path.join(root, "transports")).map((f) => f.replace(/\.json$/, ""))) : new Set();
     const now = Date.now();
@@ -48,7 +99,7 @@ export function agentsSync(root) {
         const mtimes = [tPath, path.join(root, "inbox", `${a.agentId}.jsonl`), path.join(root, "cursors", `${a.agentId}.json`)].filter(existsSync).map((f) => statSync(f).mtimeMs);
         const lastSeen = Math.max(a.lastHeartbeat ?? 0, ...mtimes);
         const age = lastSeen ? now - lastSeen : Infinity;
-        return { ...a, transport: t?.transport ?? t?.kind ?? (t ? "tmux-push" : null), pane: t?.tmuxTarget ?? null, liveness: age < 15 * 60_000 ? "live" : age < 24 * 3_600_000 ? "idle" : "dead", heartbeatAgeMs: Number.isFinite(age) ? age : null, lastSeen: lastSeen || null };
+        return { ...a, transport: t?.transport ?? t?.kind ?? (t ? "tmux-push" : null), pane: t?.tmuxTarget ?? null, reachability: reachOf(age), heartbeatAgeMs: Number.isFinite(age) ? age : null, lastSeen: lastSeen || null, progress: progressOf(output.get(a.agentId), now, scanLines) };
     }).sort((a, b) => (b.lastSeen ?? 0) - (a.lastSeen ?? 0));
 }
 export function rooms(root) {

package/dist/events.js

@@ -103,7 +103,7 @@ export class EventEngine {
     }
     /** The live coordinator agent for a project/room (role coordinator, project == room or name), else null. */
     coordinatorFor(project, room) {
-        const a = agents(this.cfg.coordDir).find((x) => /coordinator/i.test(x.role ?? "") && (x.project === room || x.project === project) && x.liveness !== "dead");
+        const a = agents(this.cfg.coordDir).find((x) => /coordinator/i.test(x.role ?? "") && (x.project === room || x.project === project) && x.reachability !== "dead");
         return a?.agentId ?? null;
     }
     emitRaw(type, project, data) {

package/dist/gitinfo.js

@@ -3,6 +3,7 @@ import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import { existsSync } from "node:fs";
 import path from "node:path";
+import { refsIn, refsMatch } from "@davidbalzan/groundwork-seam";
 const run = promisify(execFile);
 async function git(cwd, args) { try {
     const r = await run("git", args, { cwd, maxBuffer: 8 << 20 });
@@ -139,6 +140,59 @@ async function ghPrs(projectPath) {
         return null;
     }
 }
+/* Which PR a board row is ABOUT, from its `pr` CELL — never from a `#n` appearing anywhere in the
+   row. The openPrs extension declares fields ["repo","pr","owner","status","mergeGate"], so the
+   answer has a designated column and reading the others is a guess.
+
+   The old matcher was `Object.values(r).some(v => /#n/.test(v))`, which meant a Status cell reading
+   "blocked by #39" made THAT row answer for PR 39 — and `find` returns the first hit, so a mention
+   beat the real row. Measured on a two-row fixture: qaOf(39) returned "FAIL — held" from #57's row
+   while #39's own row said PASS. A passing PR shown as failing, in the alarming direction.
+
+   Same defect the kit found in queue-done-loop the same afternoon: a ref MENTIONED in a row is a
+   different fact from the ref that IDENTIFIES it. */
+/* `owner/name` from a remote URL, ssh or https. null when there is no origin. */
+export const slugFromRemoteUrl = (url) => {
+    const m = url ? /(?:[:/])([^/:]+\/[^/]+?)(?:\.git)?$/.exec(url.trim()) : null;
+    return m ? m[1] : null;
+};
+const originSlug = async (projectPath) => slugFromRemoteUrl(await git(projectPath, ["remote", "get-url", "origin"]));
+/* The ref a board row is ABOUT: its `pr` CELL, qualified by its `repo` CELL when it has one.
+   Never a `#ref` occurring anywhere else in the row — a Status reading "blocked by #39" used to
+   make that row answer for PR 39, and `find` returns the first hit, so a mention beat the row that
+   actually was that PR.
+
+   Ref parsing and comparison now come from the seam (0.1.8) instead of the local pair this file
+   used to carry. That pair was a re-derivation of a primitive the seam did not yet export; it does
+   now, and keeping our own would be a fifth matcher of the class the kit spent a day removing.
+
+   ONE DELIBERATE BEHAVIOUR CHANGE, adopted rather than worked around: with NO origin remote
+   (`contextRepo` null) and a row that names a repo, the local version ACCEPTED — it could not
+   establish a difference, so it declined to assert one. `refsMatch` returns false: an unresolvable
+   tie is not a tie. The seam's direction is the conservative one for this caller too — showing no
+   merge gate is better than showing another repo's — so the console takes the primitive's
+   semantics rather than keeping a private exception. */
+const rowRef = (row) => {
+    const cell = (row.pr ?? "").trim();
+    const repo = (row.repo ?? "").trim();
+    /* Qualify with the repo column only when the cell is not ALREADY qualified. The test is a `/`,
+       not a `#`: an earlier draft checked for `#` and every pr cell contains one, so qualification
+       silently never happened and a cross-repo collision resolved to the first row. Caught by the
+       two-repos fixture, which is why that fixture exists. */
+    const [ref] = refsIn(repo && !cell.includes("/") ? `${repo}#${cell.replace(/^#/, "")}` : cell);
+    return ref ?? null;
+};
+/* The gate a board reports for PR `n` in THIS repo, or undefined. Exported and used by
+   gitBranches directly, so the test exercises this function rather than a copy of it — a test that
+   re-implements the matcher pins the fixture, not the code. */
+export const gateForPr = (rows, n, slug) => {
+    const [target] = refsIn(slug ? `${slug}#${n}` : `#${n}`);
+    if (!target)
+        return undefined;
+    const row = rows?.find((r) => { const ref = rowRef(r); return ref ? refsMatch(target, ref, { contextRepo: slug }) : false; });
+    const qa = row?.mergeGate ?? row?.status;
+    return qa ? String(qa) : undefined;
+};
 export function gitBranches(projectPath, hints = {}) {
     return cached(`branches:${projectPath}:${(hints.agentIds ?? []).join(",")}`, async () => {
         const defaultBranch = "main";
@@ -147,8 +201,8 @@ export function gitBranches(projectPath, hints = {}) {
         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 slug = await originSlug(projectPath);
+        const qaOf = (n) => gateForPr(hints.openPrs, n, slug);
         const now = Date.now();
         const branches = await Promise.all(rows.map(async ([ref, sha, short, subject, date]) => {
             const remote = ref.startsWith("refs/remotes/");

package/dist/seam.js

@@ -1,7 +1,7 @@
 /* Read-only views over a project's seam files, parsed ONLY through @davidbalzan/groundwork-seam. */
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
-import { parseWorkDoc, queueItemsOf, doneEntriesOf, listWorkBoardOf, workDocIssues, SCHEMA } from "@davidbalzan/groundwork-seam";
+import { parseWorkDoc, queueItemsOf, doneEntriesOf, listWorkBoardOf, workDocIssues, boardSchemaOf, SCHEMA } from "@davidbalzan/groundwork-seam";
 import { parseFactsDoc } from "@davidbalzan/groundwork-seam";
 const read = (p) => (existsSync(p) ? readFileSync(p, "utf8") : null);
 const FACT_STALE_DAYS = 14; // groundwork doctor rule
@@ -13,14 +13,22 @@ export function boardOf(projectPath) {
     const f = read(path.join(docs, "FACTS.md"));
     const wsDoc = ws ? parseWorkDoc(ws) : null;
     const board = wsDoc ? listWorkBoardOf(wsDoc) : [];
-    /* Read the schema off the Active Streams BLOCK, not off its rows. A board with a valid
-       workstreams.v1 header and zero streams yields zero rows, and deriving the schema from
-       rows made "no work in flight" indistinguishable from "grammar not recognised" — the
-       console then rendered the alarming one. Only the two board grammars count here; the
-       workstreams.ext.* blocks are separate tables and must never answer this question. */
-    const boardSchemas = [SCHEMA.workstreams, SCHEMA.workstreamsLanesV0];
-    const blockSchema = wsDoc?.blocks.find((bl) => bl.kind === "board" && typeof bl.schema === "string" && boardSchemas.includes(bl.schema))?.schema ?? null;
-    const schema = blockSchema ?? board.find((r) => "schema" in r)?.schema ?? null;
+    /* Schema comes from the seam's boardSchemaOf, not from a local re-derivation.
+       The console used to work this out itself, and console#35 fixed the first defect in that
+       copy: it read the schema off the first parsed ROW, so an empty-but-valid board yielded
+       null and rendered "unknown workstreams grammar" — the alarming reading of an empty one.
+       The seam now exports the answer, and its version is better than ours on two counts we
+       had wrong:
+         - it EXCLUDES extension tables by deriving their ids from WORKSTREAMS_EXT, so
+           registering a new extension cannot forget to exclude it. Ours allow-listed the two
+           board grammars we knew, which meant any FUTURE board schema read as unrecognised.
+         - it returns "unknown" only when a header was actually REFUSED, and null when there
+           is simply no board block. Ours collapsed those: `schema ?? (ws ? "unknown" : null)`
+           reported "unknown grammar" for a WORKSTREAMS.md that merely has no Active Streams
+           table — the same conflation console#35 fixed, one case over, still live until now.
+       So `null` here means "no board table", NOT "no file"; the caller must not render those
+       as the same thing. `files.workstreams` is what distinguishes them. */
+    const schema = wsDoc ? boardSchemaOf(wsDoc) : null;
     const qDoc = q ? parseWorkDoc(q) : null;
     const dDoc = d ? parseWorkDoc(d) : null;
     const facts = f ? parseFactsDoc(f) : null;
@@ -31,9 +39,18 @@ export function boardOf(projectPath) {
     return {
         files: { workstreams: !!ws, queue: !!q, done: !!d, facts: !!f },
         prd,
-        workstreams: { schema: schema ?? (ws ? "unknown" : null), rows: board, issues: wsDoc ? workDocIssues(wsDoc) : [] },
+        workstreams: { schema, rows: board, issues: wsDoc ? workDocIssues(wsDoc) : [] },
         queue: qDoc ? queueItemsOf(qDoc) : [],
         done: dDoc ? doneEntriesOf(dDoc) : [],
+        /* QUEUE.md and DONE.md parse issues. Only WORKSTREAMS.md's were ever surfaced, so a malformed
+           queue line was parsed, kept, rendered — and reported NOWHERE. That gap is the console's half
+           of seam 0.1.6: the seam stopped DROPPING an out-of-range priority precisely so a consumer
+           could say something about it, and this consumer said nothing. `workDocIssues` already carries
+           the message (the seam builds it with invalidPriorityIssue), so nothing here re-derives it.
+           Siblings rather than a reshape of `queue`/`done`: those are arrays every caller maps over,
+           and the gap is a missing signal, not a wrong shape. */
+        queueIssues: qDoc ? workDocIssues(qDoc) : [],
+        doneIssues: dDoc ? workDocIssues(dDoc) : [],
         facts: facts
             ? {
                 entries: facts.entries.map((e) => {

package/dist/seamwrite.js

@@ -65,7 +65,11 @@ export function addQueueItem(projectPath, item, log) {
     log(`wrote docs/QUEUE.md (+1 item, ${out.length - src.length} bytes)`);
     return { file: "docs/QUEUE.md", line: renderWorkDocLine(newItem), bytesDelta: out.length - src.length };
 }
-const renderWorkDocLine = (q) => `- [ ] (${q.priority}) ${q.text}`;
+/* Display-only echo of the line we appended. `QueueItem.priority` is nullable since seam 0.1.6, and
+   interpolating a null renders the literal "(null)" — so fall back to the raw tag the seam kept. The
+   console never CREATES such an item (addQueueItem's input is narrowed to P1|P2|P3); this guards the
+   echo against a shape the type now permits. */
+const renderWorkDocLine = (q) => `- [${q.done ? "x" : " "}] (${q.priority ?? q.priorityRaw ?? "?"}) ${q.text}`;
 /** Re-verify (or add) a fact: seam upsertFact with a fresh timestamp. */
 export function reverifyFact(projectPath, entry, log) {
     const file = path.join(projectPath, "docs/FACTS.md");

package/dist/server.js

@@ -48,7 +48,7 @@ const clientFor = (id) => (id === "david" ? busDavid : bus);
 /** Capabilities of the connected MCP (null until a client has connected and listed tools). */
 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 liveAttached = () => agents(cfg.coordDir).filter((a) => a.reachability === "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");
@@ -286,7 +286,7 @@ app.get("/projects", (c) => {
     catch {
         return null;
     } })();
-    const liveAgents = agents(cfg.coordDir).filter((a) => a.liveness !== "dead");
+    const liveAgents = agents(cfg.coordDir).filter((a) => a.reachability !== "dead");
     return c.json(cfg.projects.map((p) => {
         const b = boardOf(p.path);
         const fleet = fleetStatus(liveAgents.filter((a) => a.project === p.room || a.project === p.name));
@@ -723,7 +723,7 @@ app.get("/projects/:name/fleet", async (c) => {
     const p = project(c.req.param("name"));
     if (!p)
         return c.json({ error: "unknown project" }, 404);
-    const live = (await agentsAsync(cfg.coordDir)).filter((a) => a.liveness !== "dead" && (a.project === p.room || a.project === p.name));
+    const live = (await agentsAsync(cfg.coordDir)).filter((a) => a.reachability !== "dead" && (a.project === p.room || a.project === p.name));
     return c.json({ ...fleetStatus(live), templates: FLEET_TEMPLATES, window: `fleet-${p.name}` });
 });
 const roleOfAgent = (id) => agents(cfg.coordDir).find((a) => a.agentId === id)?.role ?? null;
@@ -788,7 +788,7 @@ app.post("/actions/prune", async (c) => {
 });
 app.post("/actions/unregister-dead", async (c) => {
     const b = (await c.req.json().catch(() => ({})));
-    const dead = agents(cfg.coordDir).filter((a) => a.liveness === "dead" && !["groundwork-console", "david"].includes(a.agentId)).map((a) => a.agentId);
+    const dead = agents(cfg.coordDir).filter((a) => a.reachability === "dead" && !["groundwork-console", "david"].includes(a.agentId)).map((a) => a.agentId);
     const ids = (b.agentIds?.length ? b.agentIds.filter((id) => dead.includes(id)) : dead);
     if (b.confirm !== "UNREGISTER")
         return c.json({ error: "confirm must be UNREGISTER", wouldUnregister: ids }, 400);
@@ -810,7 +810,7 @@ app.post("/actions/unregister", async (c) => {
     return c.json(r, r.status === "ok" ? 200 : 403);
 });
 /* ---- Roadmap actions: message the project's aide (plan) or coordinator (kick off) as david ---- */
-const roleAgent = (projectName, room, roleRe) => agents(cfg.coordDir).find((a) => roleRe.test(a.role ?? "") && (a.project === room || a.project === projectName) && a.liveness !== "dead")?.agentId ?? null;
+const roleAgent = (projectName, room, roleRe) => agents(cfg.coordDir).find((a) => roleRe.test(a.role ?? "") && (a.project === room || a.project === projectName) && a.reachability !== "dead")?.agentId ?? null;
 app.get("/projects/:name/agents", (c) => {
     const p = project(c.req.param("name"));
     if (!p)
@@ -855,7 +855,7 @@ app.post("/actions/task/:name/:phase/:line", async (c) => {
         return c.json({ error: "no task at that line" }, 404);
     if (task.done)
         return c.json({ error: "already ticked" }, 409);
-    const live = agents(cfg.coordDir).filter((a) => a.liveness !== "dead");
+    const live = agents(cfg.coordDir).filter((a) => a.reachability !== "dead");
     const owner = b.owner && live.some((a) => a.agentId === b.owner) ? b.owner : roleAgent(p.name, p.room, /aide|liaison|curator/i);
     if (!owner)
         return c.json({ error: `no live owner or aide for ${p.name}` }, 409);
@@ -897,7 +897,7 @@ app.get("/projects/:name/doctor/fixers", async (c) => {
     const p = project(c.req.param("name"));
     if (!p)
         return c.json({ error: "unknown project" }, 404);
-    const live = (await agentsAsync(cfg.coordDir)).filter((a) => a.liveness !== "dead" && (a.project === p.room || a.project === p.name));
+    const live = (await agentsAsync(cfg.coordDir)).filter((a) => a.reachability !== "dead" && (a.project === p.room || a.project === p.name));
     const out = {};
     for (const [check, o] of Object.entries(DOCTOR_OWNER)) {
         const a = live.find((x) => o.re.test(x.role ?? ""));
@@ -913,7 +913,7 @@ app.post("/actions/doctor-fix/:name", async (c) => {
     const o = DOCTOR_OWNER[b.check];
     if (!o)
         return c.json({ error: "no fixer role for this check" }, 400);
-    const live = (await agentsAsync(cfg.coordDir)).filter((a) => a.liveness !== "dead" && (a.project === p.room || a.project === p.name));
+    const live = (await agentsAsync(cfg.coordDir)).filter((a) => a.reachability !== "dead" && (a.project === p.room || a.project === p.name));
     const target = live.find((x) => o.re.test(x.role ?? ""))?.agentId;
     if (!target)
         return c.json({ error: `no live ${o.role} for ${p.name}` }, 409);
@@ -1036,9 +1036,9 @@ app.get("/bus/panes", async (c) => {
     const lines = Number(c.req.query("lines") ?? 40);
     const p = proj ? project(proj) : undefined;
     const all = await agentsAsync(cfg.coordDir);
-    const scoped = all.filter((a) => a.pane && a.liveness !== "dead" && (!p || a.project === p.name || (p.room && a.project === p.room)));
+    const scoped = all.filter((a) => a.pane && a.reachability !== "dead" && (!p || a.project === p.name || (p.room && a.project === p.room)));
     const colors = c.req.query("colors") === "1";
-    const out = await Promise.all(scoped.map(async (a) => ({ agentId: a.agentId, role: a.role ?? null, project: a.project ?? null, pane: a.pane, windowName: a.windowName ?? null, command: a.paneCommand, active: a.active, paneActivity: a.paneActivity, liveness: a.liveness, capture: await capturePane(a.pane, lines, colors) })));
+    const out = await Promise.all(scoped.map(async (a) => ({ agentId: a.agentId, role: a.role ?? null, project: a.project ?? null, pane: a.pane, windowName: a.windowName ?? null, command: a.paneCommand, active: a.active, paneActivity: a.paneActivity, reachability: a.reachability, capture: await capturePane(a.pane, lines, colors) })));
     return c.json(out);
 });
 /* Pane viewer: read-only capture of an agent's tmux pane (never sends keys). */

package/dist/tmux.js

@@ -1,4 +1,4 @@
-/* Read-only tmux views: pane activity (for liveness + activity indicators) and pane capture (for the pane viewer). Never sends keys. */
+/* Read-only tmux views: pane activity (for reachability + activity indicators) and pane capture (for the pane viewer). Never sends keys. */
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 const run = promisify(execFile);

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@davidbalzan/groundwork-console",
   "private": false,
-  "version": "0.1.12",
+  "version": "0.1.14",
   "type": "module",
   "dependencies": {
-    "@davidbalzan/groundwork-seam": "^0.1.0",
+    "@davidbalzan/groundwork-seam": "0.1.8",
     "@hono/node-server": "^2.1.1",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "hono": "^4.13.2",
@@ -48,8 +48,12 @@
     "publish-check": "node scripts/publish-check.mjs",
     "test:inject": "tsx test/inject.test.mts",
     "test:skills": "tsx test/skills.test.mts",
-    "test": "pnpm run test:inject && pnpm run test:skills && pnpm run test:board && pnpm run test:panes",
+    "test": "pnpm run test:inject && pnpm run test:skills && pnpm run test:board && pnpm run test:panes && pnpm run test:seam-contract && pnpm run test:prref && pnpm run test:progress && pnpm run test:publish-check",
     "test:board": "tsx test/board.test.mts",
-    "test:panes": "tsx test/panes.test.mts"
+    "test:panes": "tsx test/panes.test.mts",
+    "test:seam-contract": "tsx test/seam-contract.test.mts",
+    "test:prref": "tsx test/prref.test.mts",
+    "test:progress": "tsx test/progress.test.mts",
+    "test:publish-check": "tsx test/publish-check.test.mts"
   }
 }

package/public/assets/{abnfDiagram-N423BO3Z-C7_Zpec2.js → abnfDiagram-N423BO3Z-BSvB33qO.js}

@@ -1 +1 @@
-import{m as e,t}from"./mermaid-parser.core-B98Rk-oq.js";import{n}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import{m as r}from"./src-fnYA6irH.js";import"./chunk-I66GZJ75-CfWGFqqO.js";import{n as i,r as a,t as o}from"./chunk-6Q2QTUOP-BQYOf-YY.js";import{t as s}from"./chunk-JWPE2WC7-DVXcaiue.js";import"./mermaid.core-CqRCrVqJ.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-CIHTTkEa.js";import{n}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import{m as r}from"./src-eh414mKr.js";import"./chunk-I66GZJ75-C8VZHfLH.js";import{n as i,r as a,t as o}from"./chunk-6Q2QTUOP-BEP7PF5q.js";import{t as s}from"./chunk-JWPE2WC7-DVXcaiue.js";import"./mermaid.core-Cc5OhPpa.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-Bbq8pKhn.js → arc-zFmco7vQ.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-BhEZ2d35.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-By9Jxne0.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-BQFAhsKM.js

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