agent-coord-mcp 0.19.1 → 0.23.0

package/dist/work.js

@@ -1,292 +1,2 @@
-// Work state as data (Phase 8 Task 5): queue items, done entries and board
-// rows as typed records, with markdown as a first-class EXPORT rather than the
-// datastore.
-//
-// WHY THIS SHAPE. `docs/QUEUE.md` / `docs/DONE.md` were parsed under a contract
-// requiring exact `—` (U+2014) and ` · ` (U+00B7). A parser once returned ZERO
-// items on the real file while passing every synthetic test, and the consuming
-// UI rendered an empty panel — no error, no signal. The files themselves are
-// good: David edits them, git diffs them, they grep. So markdown stays the
-// INTERFACE and stops being the DATASTORE.
-//
-// MARKDOWN REMAINS AUTHORITATIVE. Delete the store and the documents still
-// stand alone: every field here is recoverable from the file it came from, the
-// exporter is byte-exact, and nothing downstream is required to read records.
-// The store is a derived index until a consumer chooses otherwise.
-//
-// The round-trip guarantee is structural, not incidental: everything this
-// module does NOT model — prose, the write-rule paragraphs, the Cross-project
-// section, fenced examples — is captured verbatim as a `text` block and
-// replayed in place. Only lines it genuinely understands are re-rendered, so
-// an unmodelled construct can never be silently dropped.
-import { createHash } from "node:crypto";
-// The one arity BoardRow can hold. boardCells() and the parser's arity guard
-// both reference this constant so the two sides cannot drift; a test pins
-// boardCells().length === BOARD_ARITY.
-export const BOARD_ARITY = 5;
-export function isMalformedRow(r) {
-    return r.malformed === true;
-}
-// ---------- the glyph contract ----------
-//
-// Pinned in docs/DONE.md and consumed by external parsers: the ref splits on
-// the LAST ` — ` (space, U+2014, space) and the date is a trailing ` · `
-// (space, U+00B7, space) + ISO date. Written as explicit escapes so a source
-// file normalization or a copy-paste through an ASCII-mangling tool can never
-// change them silently — the constants are the contract.
-export const EM_DASH_SEP = " — ";
-export const MIDDOT_SEP = " · ";
-const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
-// Deterministic ids: same content in → same id out, so import→export→import is
-// stable and no id has to be written into the markdown (which would change the
-// bytes the round trip is measured on).
-function idFor(kind, seed) {
-    return `${kind}-${createHash("sha1").update(seed).digest("hex").slice(0, 8)}`;
-}
-// ---------- line-level recognizers ----------
-const QUEUE_LINE = /^- \[( |x)\] \((P1|P2|P3)\) (.*)$/;
-const DONE_LINE = /^- \[( |x)\] (.*)$/;
-export function parseQueueLine(line, section) {
-    const m = QUEUE_LINE.exec(line);
-    if (!m)
-        return null;
-    const [, mark, priority, text] = m;
-    return {
-        id: idFor("q", text ?? ""),
-        priority: priority,
-        text: text ?? "",
-        done: mark === "x",
-        ...(section ? { section } : {}),
-    };
-}
-// Split on the LAST ` — `, then peel a trailing ` · YYYY-MM-DD`. Both parts are
-// optional: an entry with neither is still a done entry, it just carries no
-// verifiable ref — which is a fact about the entry, not a parse failure. The
-// old parser treated the same line as nothing at all.
-export function parseDoneLine(line, section) {
-    const m = DONE_LINE.exec(line);
-    if (!m)
-        return null;
-    let body = m[2] ?? "";
-    let ref;
-    let date;
-    const cut = body.lastIndexOf(EM_DASH_SEP);
-    if (cut !== -1) {
-        const tail = body.slice(cut + EM_DASH_SEP.length);
-        const dot = tail.lastIndexOf(MIDDOT_SEP);
-        if (dot !== -1) {
-            const maybeDate = tail.slice(dot + MIDDOT_SEP.length);
-            if (ISO_DATE.test(maybeDate)) {
-                date = maybeDate;
-                ref = tail.slice(0, dot);
-            }
-        }
-        // A tail with no date is still a ref, as long as it isn't prose with
-        // spaces — refs are `owner/repo#N` or `owner/repo@sha`.
-        if (date === undefined && /^\S+$/.test(tail))
-            ref = tail;
-        if (ref !== undefined)
-            body = body.slice(0, cut);
-    }
-    return {
-        id: idFor("d", `${body}|${ref ?? ""}|${date ?? ""}`),
-        text: body,
-        ...(ref !== undefined ? { ref } : {}),
-        ...(date !== undefined ? { date } : {}),
-        ...(section ? { section } : {}),
-    };
-}
-export function renderQueueLine(item) {
-    return `- [${item.done ? "x" : " "}] (${item.priority}) ${item.text}`;
-}
-export function renderDoneLine(entry) {
-    let line = `- [x] ${entry.text}`;
-    if (entry.ref !== undefined)
-        line += `${EM_DASH_SEP}${entry.ref}`;
-    if (entry.date !== undefined)
-        line += `${MIDDOT_SEP}${entry.date}`;
-    return line;
-}
-// ---------- board table ----------
-const TABLE_ROW = /^\|(.*)\|\s*$/;
-const TABLE_ALIGN = /^\|[\s:|-]+\|\s*$/;
-function splitRow(line) {
-    const m = TABLE_ROW.exec(line);
-    if (!m)
-        return [];
-    return (m[1] ?? "").split("|").map((c) => c.trim());
-}
-function renderRow(cells) {
-    return `| ${cells.join(" | ")} |`;
-}
-function boardCells(r) {
-    return [r.lane, r.owner, r.state, r.currentSlice, r.nextGo];
-}
-// Replay the original line when the fields still say what it said; re-render
-// once anything actually changed. A malformed row has no fields to have
-// changed — it replays its bytes, always.
-export function renderBoardRow(r) {
-    if (isMalformedRow(r))
-        return r.verbatim;
-    if (r.raw !== undefined) {
-        const cells = splitRow(r.raw);
-        if (cells.length === BOARD_ARITY && cells.every((c, i) => c === boardCells(r)[i]))
-            return r.raw;
-    }
-    return renderRow(boardCells(r));
-}
-// Which record kind a `## Heading` opens. `## Queue` → queue items,
-// `## Done` → done entries; anything else closes the record region, so the
-// Cross-project section's bullets stay verbatim prose.
-function sectionKindOf(heading) {
-    const h = heading.replace(/^#+\s*/, "").trim().toLowerCase();
-    if (h === "queue")
-        return "queue";
-    if (h === "done")
-        return "done";
-    return "none";
-}
-export function parseWorkDoc(source) {
-    const trailingNewline = source.endsWith("\n");
-    const lines = source.split("\n");
-    if (trailingNewline)
-        lines.pop(); // the split's empty tail, restored on render
-    const blocks = [];
-    let text = [];
-    let kind = "none";
-    let subsection;
-    let inFence = false;
-    const flushText = () => {
-        if (text.length)
-            blocks.push({ kind: "text", lines: text });
-        text = [];
-    };
-    // Consecutive item lines coalesce into one block; anything in between (a
-    // blank line, a subsection heading) flushes as text first and therefore
-    // starts a new one, which is what keeps rendering order faithful.
-    const pushItem = (item) => {
-        flushText();
-        const last = blocks[blocks.length - 1];
-        if (last?.kind === "queue")
-            last.items.push(item);
-        else
-            blocks.push({ kind: "queue", items: [item] });
-    };
-    const pushEntry = (entry) => {
-        flushText();
-        const last = blocks[blocks.length - 1];
-        if (last?.kind === "done")
-            last.entries.push(entry);
-        else
-            blocks.push({ kind: "done", entries: [entry] });
-    };
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i] ?? "";
-        // Fenced blocks are never interpreted — docs/DONE.md pins the done-line
-        // FORMAT inside a fence, and parsing that example as an entry would
-        // invent a record out of documentation.
-        if (/^\s*```/.test(line)) {
-            inFence = !inFence;
-            text.push(line);
-            continue;
-        }
-        if (inFence) {
-            text.push(line);
-            continue;
-        }
-        if (/^#{1,6}\s/.test(line)) {
-            const level = (line.match(/^#+/) ?? [""])[0].length;
-            if (level <= 2) {
-                kind = sectionKindOf(line);
-                subsection = undefined;
-            }
-            else if (kind !== "none") {
-                subsection = line.replace(/^#+\s*/, "").trim();
-            }
-            text.push(line);
-            continue;
-        }
-        if (kind === "queue") {
-            const item = parseQueueLine(line, subsection);
-            if (item) {
-                pushItem(item);
-                continue;
-            }
-        }
-        else if (kind === "done") {
-            const entry = parseDoneLine(line, subsection);
-            if (entry) {
-                pushEntry(entry);
-                continue;
-            }
-        }
-        // Lanes table: a header row followed by an alignment row.
-        if (TABLE_ROW.test(line) && TABLE_ALIGN.test(lines[i + 1] ?? "")) {
-            const rows = [];
-            let j = i + 2;
-            for (; j < lines.length && TABLE_ROW.test(lines[j] ?? ""); j++) {
-                const raw = lines[j] ?? "";
-                const cells = splitRow(raw);
-                // Arity guard: a row BoardRow cannot hold is refused a record, kept
-                // verbatim, and named loudly — destructuring it into the 5-tuple is
-                // exactly the silent narrow/widen this exists to prevent. An empty
-                // trailing cell (`| a | b | c | d | |`) is still five columns and
-                // still a legitimate row.
-                if (cells.length !== BOARD_ARITY) {
-                    rows.push({
-                        malformed: true,
-                        verbatim: raw,
-                        issue: `board row at line ${j + 1} has ${cells.length} column(s), expected ${BOARD_ARITY} — ` +
-                            `refused (kept verbatim, excluded from board records). Fix the row, or widen BoardRow ` +
-                            `deliberately (BOARD_ARITY + boardCells + this guard together). Row: ${raw}`,
-                    });
-                    continue;
-                }
-                const [lane = "", owner = "", state = "", currentSlice = "", nextGo = ""] = cells;
-                rows.push({ id: idFor("b", lane), lane, owner, state, currentSlice, nextGo, raw });
-            }
-            flushText();
-            blocks.push({ kind: "board", header: line, align: lines[i + 1] ?? "", rows });
-            i = j - 1;
-            continue;
-        }
-        text.push(line);
-    }
-    flushText();
-    return { trailingNewline, blocks };
-}
-export function renderWorkDoc(doc) {
-    const out = [];
-    for (const block of doc.blocks) {
-        if (block.kind === "text")
-            out.push(...block.lines);
-        else if (block.kind === "queue")
-            out.push(...block.items.map(renderQueueLine));
-        else if (block.kind === "done")
-            out.push(...block.entries.map(renderDoneLine));
-        else {
-            out.push(block.header);
-            out.push(block.align);
-            for (const r of block.rows)
-                out.push(renderBoardRow(r));
-        }
-    }
-    return out.join("\n") + (doc.trailingNewline ? "\n" : "");
-}
-// ---------- record extraction ----------
-export function queueItemsOf(doc) {
-    return doc.blocks.flatMap((b) => (b.kind === "queue" ? b.items : []));
-}
-export function doneEntriesOf(doc) {
-    return doc.blocks.flatMap((b) => (b.kind === "done" ? b.entries : []));
-}
-export function boardRowsOf(doc) {
-    return doc.blocks.flatMap((b) => b.kind === "board" ? b.rows.filter((r) => !isMalformedRow(r)) : []);
-}
-// Every refused row's issue, in document order — what makes the parse-time
-// rejection LOUD at the tool layer (import_work/list_work/export_work all
-// surface it) instead of a filtered-out record nobody notices.
-export function workDocIssues(doc) {
-    return doc.blocks.flatMap((b) => b.kind === "board" ? b.rows.filter(isMalformedRow).map((r) => r.issue) : []);
-}
+export { BOARD_ARITY, isMalformedRow, EM_DASH_SEP, MIDDOT_SEP, parseQueueLine, parseDoneLine, renderQueueLine, renderDoneLine, renderBoardRow, parseWorkDoc, renderWorkDoc, queueItemsOf, doneEntriesOf, boardRowsOf, workstreamsV1RowsOf, listWorkBoardOf, projectV1ToLanes, workDocIssues, workDocLegacyWriteIssues, LANES_V0_WRITE_ISSUE, } from "@davidbalzan/groundwork-seam/docs";
 //# sourceMappingURL=work.js.map

package/dist/work.js.map

@@ -1 +1 @@
-{"version":3,"file":"work.js","sourceRoot":"","sources":["../src/work.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"work.js","sourceRoot":"","sources":["../src/work.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,WAAW,EAEX,cAAc,EAGd,WAAW,EACX,UAAU,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,EACd,cAAc,EACd,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,wBAAwB,EACxB,oBAAoB,GAGrB,MAAM,mCAAmC,CAAC"}

package/hooks/roles.mjs

@@ -25,6 +25,10 @@ export const GATE_RUNNER_ROLE_IDS = new Set(["qa", "quality", "coordinator", "ga
 // Coordinators countersign work orders (`go`) and in-flight contract
 // amendments (`scope`).
 export const COORDINATOR_ROLE_IDS = new Set(["coordinator"]);
+// CI receives express-lane DONE: wake. Not a gate-runner — must not grant verdict.
+export const CI_ROLE_IDS = new Set(["ci"]);
+// Console / watchers. May send prefixed messages. Not a gate-runner.
+export const AUTOMATION_ROLE_IDS = new Set(["automation"]);
 
 // Normalize any role shape into {roleId, displayName, explicit}.
 //
@@ -77,3 +81,11 @@ export function isGateRunner(role) {
 export function isCoordinator(role) {
   return roleMatches(role, COORDINATOR_ROLE_IDS);
 }
+
+export function isCi(role) {
+  return roleMatches(role, CI_ROLE_IDS);
+}
+
+export function isAutomation(role) {
+  return roleMatches(role, AUTOMATION_ROLE_IDS);
+}

package/hooks/tier.mjs

@@ -35,7 +35,7 @@ function tierFromRecord(rec, m, opts) {
     case "scope":
       return opts.trustedSenders?.has?.(m.from) ? "urgent" : "routine";
     case "done":
-      return opts.gateRunner ? "urgent" : "routine";
+      return wakesOnDone(opts) ? "urgent" : "routine";
     // risk / fyi / action / verdict: real semantics, but not a reason to
     // interrupt someone else's turn. A risk that genuinely needs an immediate
     // turn is a blocker — that judgement stays with the sender.
@@ -100,12 +100,17 @@ export function classifyTier(m, opts = {}) {
   if (/^SCOPE(?: CHANGE)?:/.test(text)) {
     return opts.trustedSenders?.has?.(m.from) ? "urgent" : "routine";
   }
-  // DONE: is for whoever runs the merge gate (QA/coordinator) — nobody else,
-  // DM or room alike.
-  if (text.startsWith("DONE:")) return opts.gateRunner ? "urgent" : "routine";
+  // DONE: wakes the merge gate (QA/coordinator) OR ci (express-lane).
+  // Classification lives on the GO (`gate: express`), not on the DONE line.
+  // Do not invent `DONE: express`. ci is not a gate-runner (no verdict).
+  if (text.startsWith("DONE:")) return wakesOnDone(opts) ? "urgent" : "routine";
   return "routine";
 }
 
+function wakesOnDone(opts) {
+  return Boolean(opts.gateRunner || opts.ci);
+}
+
 // Tier with the enable switch applied — AGENT_COORD_TIERS=0 restores legacy
 // push-everything.
 export function effectiveTier(m, opts = {}) {

package/hooks/tmux-pusher.mjs

@@ -75,6 +75,7 @@ import { fileURLToPath } from "node:url";
 import path from "node:path";
 import { spawn, spawnSync } from "node:child_process";
 import { effectiveTier, isGateRunnerRole, TierQueue, formatBatch } from "./tier.mjs";
+import { isCi } from "./roles.mjs";
 import { mergeTransportMarker } from "./marker.mjs";
 import { pasteAndSubmit as sharedPasteAndSubmit, submitControl as sharedSubmitControl } from "./submit.mjs";
 
@@ -113,9 +114,10 @@ const MAX_QUEUE_MS = parseInt(process.env.AGENT_COORD_MAX_QUEUE_MS || "15000", 1
 // SCOPE: changes are honored only from these trusted ids. Re-resolved from
 // the registry every 30s so a role change doesn't strand a stale pusher;
 // AGENT_COORD_GATE_RUNNER=1|0 overrides in both directions.
-let tierCtx = { enabled: TIERS_ENABLED, gateRunner: false, trustedSenders: new Set() };
+let tierCtx = { enabled: TIERS_ENABLED, gateRunner: false, ci: false, trustedSenders: new Set() };
 function refreshTierCtx() {
   let gateRunner = false;
+  let ci = false;
   const trusted = new Set();
   try {
     const reg = JSON.parse(readFileSync(path.join(ROOT, "agents.json"), "utf8"));
@@ -123,18 +125,21 @@ function refreshTierCtx() {
       // Pass the whole entry: the frozen roleId lives beside `role`, and
       // reading only the display string would throw the identity away.
       if (isGateRunnerRole(entry)) trusted.add(id);
+      if (id === AGENT_ID) ci = isCi(entry);
     }
     gateRunner = trusted.has(AGENT_ID);
   } catch {
-    // No registry yet — conservative default (not a gate runner).
+    // No registry yet — conservative default (not a gate runner, not ci).
   }
   const env = process.env.AGENT_COORD_GATE_RUNNER;
   if (env === "1" || env === "true") gateRunner = true;
   if (env === "0" || env === "false") gateRunner = false;
-  if (gateRunner !== tierCtx.gateRunner) {
-    process.stderr.write(`[tmux-pusher] gate-runner resolved: ${gateRunner}\n`);
+  // AGENT_COORD_GATE_RUNNER must not flip ci — that would look like a
+  // verdict grant. Express-lane wake is roleId === ci only.
+  if (gateRunner !== tierCtx.gateRunner || ci !== tierCtx.ci) {
+    process.stderr.write(`[tmux-pusher] gate-runner resolved: ${gateRunner} ci: ${ci}\n`);
   }
-  tierCtx = { enabled: TIERS_ENABLED, gateRunner, trustedSenders: trusted };
+  tierCtx = { enabled: TIERS_ENABLED, gateRunner, ci, trustedSenders: trusted };
 }
 refreshTierCtx();
 setInterval(refreshTierCtx, 30_000).unref();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-coord-mcp",
-  "version": "0.19.1",
+  "version": "0.23.0",
   "description": "File-backed MCP server for coordinating multiple AI coding agents (Claude Code, Cursor, Cline, etc.). Local stdio or networked over Streamable HTTP.",
   "type": "module",
   "bin": {
@@ -8,15 +8,6 @@
     "coord-chat": "scripts/coord-chat.mjs",
     "coord-pusher": "scripts/coord-pusher.mjs"
   },
-  "scripts": {
-    "build": "tsc",
-    "prepare": "node scripts/check-self-dependency.mjs && tsc",
-    "start": "node dist/server.js",
-    "dev": "tsx src/server.ts",
-    "pretest": "node scripts/check-self-dependency.mjs && tsc",
-    "test": "node scripts/check-test-count.mjs",
-    "test:raw": "node --test \"test/*.test.mjs\""
-  },
   "files": [
     "dist",
     "src",
@@ -52,14 +43,23 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.4",
+    "@modelcontextprotocol/sdk": "^1.30.0",
     "proper-lockfile": "^4.1.2",
-    "zod": "^4.4.3"
+    "zod": "^4.4.3",
+    "@davidbalzan/groundwork-seam": "0.1.0"
   },
   "devDependencies": {
-    "@types/node": "^25.9.2",
+    "@types/node": "^26.2.0",
     "@types/proper-lockfile": "^4.1.4",
-    "tsx": "^4.19.2",
-    "typescript": "^6.0.3"
+    "tsx": "^4.23.12",
+    "typescript": "^7.0.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "dev": "tsx src/server.ts",
+    "pretest": "node scripts/check-self-dependency.mjs && tsc",
+    "test": "node scripts/check-test-count.mjs",
+    "test:raw": "node --test \"test/*.test.mjs\""
   }
-}
+}

package/scripts/check-self-dependency.mjs

@@ -17,10 +17,13 @@
 // was untouched; a reviewer reads the claim, not the diff. This guard is
 // cheap insurance against that class, not evidence of a recurring bug.
 //
-// Runs on `prepare` (every install), `pretest`, and `prepublishOnly`.
-import { readFileSync } from "node:fs";
+// Runs on `prepare` (every install) and `pretest`.
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, relative } from "node:path";
+import { fileURLToPath } from "node:url";
 
-const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+const pkgDir = fileURLToPath(new URL("..", import.meta.url));
+const pkg = JSON.parse(readFileSync(join(pkgDir, "package.json"), "utf8"));
 const DEP_FIELDS = ["dependencies", "devDependencies", "optionalDependencies", "peerDependencies"];
 
 function selfDepFields(manifest) {
@@ -29,26 +32,71 @@ function selfDepFields(manifest) {
   );
 }
 
-const offenders = selfDepFields(pkg);
+function walkFor(name, start) {
+  let dir = start;
+  for (let i = 0; i < 6; i++) {
+    const candidate = join(dir, name);
+    if (existsSync(candidate)) return { file: candidate, root: dir };
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+
+function npmLockSelfDep() {
+  const sibling = join(pkgDir, "package-lock.json");
+  if (!existsSync(sibling)) return false;
+  try {
+    const lock = JSON.parse(readFileSync(sibling, "utf8"));
+    const rootPkg = lock.packages?.[""];
+    return Boolean(rootPkg && selfDepFields(rootPkg).length);
+  } catch {
+    return false;
+  }
+}
 
-let lockOffender = false;
-try {
-  const lock = JSON.parse(readFileSync(new URL("../package-lock.json", import.meta.url), "utf8"));
-  const rootPkg = lock.packages?.[""];
-  if (rootPkg && selfDepFields(rootPkg).length) lockOffender = true;
-} catch {
-  /* no lockfile yet (fresh checkout pre-install) — nothing to check */
+// pnpm-lock.yaml has no JSON root package. Check this package's importer
+// block for a key named after the package (a self-dep).
+function pnpmLockSelfDep() {
+  const found = walkFor("pnpm-lock.yaml", pkgDir);
+  if (!found) return false;
+  let text;
+  try {
+    text = readFileSync(found.file, "utf8");
+  } catch {
+    return false;
+  }
+  const rel = relative(found.root, pkgDir).split("\\").join("/") || ".";
+  const key = rel === "." ? "." : rel;
+  const escaped = key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const header = new RegExp(`(?<=^|\\n)  ${escaped}:\\n`);
+  const start = text.search(header);
+  if (start === -1) return false;
+  const from = text.indexOf("\n", start) + 1;
+  const next = text.slice(from).search(/\n  [^ \n]/);
+  const block = next === -1 ? text.slice(from) : text.slice(from, from + next);
+  const selfKey = new RegExp(`^[ \\t]+${pkg.name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}:\\s*$`, "m");
+  return selfKey.test(block);
 }
 
-if (offenders.length || lockOffender) {
+const offenders = selfDepFields(pkg);
+const npmLockOffender = npmLockSelfDep();
+const pnpmLockOffender = pnpmLockSelfDep();
+
+if (offenders.length || npmLockOffender || pnpmLockOffender) {
+  const lockBits = [
+    npmLockOffender && "package-lock.json's root package",
+    pnpmLockOffender && "pnpm-lock.yaml's importer for this package",
+  ].filter(Boolean);
   console.error(
     `[check-self-dependency] "${pkg.name}" depends on itself` +
       (offenders.length ? ` in package.json's ${offenders.join(", ")}` : "") +
-      (lockOffender ? `${offenders.length ? " and" : " in"} package-lock.json's root package` : "") +
+      (lockBits.length ? `${offenders.length ? " and" : " in"} ${lockBits.join(" and ")}` : "") +
       `.\nThis happened once before, added by an "npm audit fix" whose commit message said it was ` +
       `lockfile-only (de4e1ee, removed in 3bce3ce — see docs/DONE.md). If you just ran an audit or ` +
       `dependency update, check what else it changed in package.json. ` +
-      `Remove the self-reference from both files and re-run "npm install".`,
+      `Remove the self-reference from the manifest and lockfile.`,
   );
   process.exit(1);
 }

package/scripts/check-test-count.mjs

@@ -22,7 +22,7 @@
 
 import { spawn } from "node:child_process";
 
-const EXPECTED_TESTS = 262;
+const EXPECTED_TESTS = 272;
 
 const expected = Number(process.env.AGENT_COORD_EXPECTED_TESTS ?? EXPECTED_TESTS);
 // Same glob the suite always used — `--test test/` would recurse differently
@@ -41,9 +41,9 @@ child.stdout.on("data", (chunk) => {
 
 child.on("exit", (code, signal) => {
   if (signal) process.exit(1);
-  // The TAP summary lines the runner prints once, at the end.
+  // TAP (`# pass N`) on Node 20–22; spec reporter (`ℹ pass N`) on newer Node.
   const num = (label) => {
-    const m = out.match(new RegExp(`^# ${label} (\\d+)$`, "m"));
+    const m = out.match(new RegExp(`^(?:#|ℹ) ${label} (\\d+)\\s*$`, "m"));
     return m ? Number(m[1]) : null;
   };
   const tests = num("tests");

package/src/roles.ts

@@ -33,6 +33,10 @@ export function slugifyRole(role: unknown): string {
 
 export const GATE_RUNNER_ROLE_IDS = new Set(["qa", "quality", "coordinator", "gate"]);
 export const COORDINATOR_ROLE_IDS = new Set(["coordinator"]);
+// CI receives express-lane DONE: wake. Not a gate-runner — must not grant verdict.
+export const CI_ROLE_IDS = new Set(["ci"]);
+// Console / watchers. May send prefixed messages. Not a gate-runner.
+export const AUTOMATION_ROLE_IDS = new Set(["automation"]);
 
 export function resolveRole(role: RoleInput): ResolvedRole | undefined {
   if (role === null || role === undefined) return undefined;
@@ -70,6 +74,14 @@ export function isCoordinator(role: RoleInput): boolean {
   return roleMatches(role, COORDINATOR_ROLE_IDS);
 }
 
+export function isCi(role: RoleInput): boolean {
+  return roleMatches(role, CI_ROLE_IDS);
+}
+
+export function isAutomation(role: RoleInput): boolean {
+  return roleMatches(role, AUTOMATION_ROLE_IDS);
+}
+
 // Which roles may emit which record.type at the send path. Enforcement lives
 // in messaging.ts (checkRecordAuthority); the table lives here so register/join
 // can ECHO the consequence back at onboarding — a role that cannot emit `go`