agent-coord-mcp 0.17.1 → 0.19.0

package/dist/work.js

@@ -0,0 +1,260 @@
+// 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 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.
+export function renderBoardRow(r) {
+    if (r.raw !== undefined) {
+        const cells = splitRow(r.raw);
+        if (cells.length === 5 && 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 [lane = "", owner = "", state = "", currentSlice = "", nextGo = ""] = splitRow(raw);
+                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 : []));
+}
+//# sourceMappingURL=work.js.map

package/dist/work.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work.js","sourceRoot":"","sources":["../src/work.ts"],"names":[],"mappings":"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"}

package/hooks/marker.mjs

@@ -0,0 +1,18 @@
+// The transport-marker rewrite contract, extracted so it is testable.
+//
+// The marker has TWO writers with different authority: attach_agent CREATES
+// it (authoritative — a fresh attach owns every field, including provenance
+// stamps like serverBuildMtime that only the server can know), and the pusher
+// REWRITES it at startup (partial — it owns its pid, target, and the
+// scriptMtime of the code it actually loaded, and must not touch the rest).
+//
+// A rewrite that rebuilds the marker from scratch drops every field the other
+// writer owns. That is not hypothetical: an earlier from-scratch rewrite
+// dropped scriptMtime and silently disabled doctor's stale-pusher-script
+// check for every local pusher — a marker field a rewrite can drop is a
+// health check that can be switched off by accident.
+export function mergeTransportMarker(existing, own) {
+  // Spread order IS the contract: fields this writer does not own survive;
+  // fields it does own win.
+  return { ...(existing && typeof existing === "object" ? existing : {}), ...own };
+}

package/hooks/roles.mjs

@@ -0,0 +1,79 @@
+// Canonical role identity (Phase 8 Task 4). Dependency-free and
+// side-effect-free: hooks/tier.mjs imports it on the delivery hot path, and it
+// must keep working from a bare checkout with no build step.
+//
+// The problem this exists for: a role's identity used to BE its display string,
+// so renaming it (curator → liaison → aide) churned every id, skill and script
+// that named it. Now the id is frozen and only the name moves.
+//
+// MIRROR: src/roles.ts carries the same logic for the server side — tsconfig's
+// rootDir is `src`, so TypeScript cannot import this file. test/roles.test.mjs
+// asserts the two stay in lockstep; if you change a rule or an id here, change
+// it there too.
+
+// Display text → role id. Lowercase, non-alphanumerics collapse to "-".
+export function slugifyRole(role) {
+  return String(role ?? "")
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "");
+}
+
+// A gate runner is the agent that consumes DONE: reports (QA / coordinator).
+export const GATE_RUNNER_ROLE_IDS = new Set(["qa", "quality", "coordinator", "gate"]);
+// Coordinators countersign work orders (`go`) and in-flight contract
+// amendments (`scope`).
+export const COORDINATOR_ROLE_IDS = new Set(["coordinator"]);
+
+// Normalize any role shape into {roleId, displayName, explicit}.
+//
+// `explicit` records whether the id was DECLARED (registry entry carries a
+// frozen roleId) or DERIVED from display text. It is the difference between
+// "this agent's identity is `gate`" and "this agent's name happens to contain
+// the word gate" — declared ids match exactly, derived ones fall back to the
+// legacy word match below so un-migrated registries keep behaving as they did.
+//
+// Accepts: a plain string, {roleId, displayName}, or an AgentEntry ({role,
+// roleId}) passed straight from the registry.
+export function resolveRole(role) {
+  if (role === null || role === undefined) return undefined;
+  if (typeof role === "string") {
+    const roleId = slugifyRole(role);
+    return roleId ? { roleId, displayName: role, explicit: false } : undefined;
+  }
+  if (typeof role === "object") {
+    const declared = typeof role.roleId === "string" ? slugifyRole(role.roleId) : "";
+    const name =
+      typeof role.displayName === "string" && role.displayName
+        ? role.displayName
+        : typeof role.role === "string" && role.role
+          ? role.role
+          : undefined;
+    if (declared) return { roleId: declared, displayName: name ?? declared, explicit: true };
+    if (name) return resolveRole(name);
+  }
+  return undefined;
+}
+
+// Does this role carry one of `allowedIds`?
+//
+// Declared ids must match exactly — that is the point of freezing them. A
+// derived id additionally matches on any of its hyphen-separated words, which
+// reproduces the pre-Task-4 prose regex (/\b(qa|quality|coordinator|gate)\b/i)
+// for registries that never declared a roleId.
+export function roleMatches(role, allowedIds) {
+  const resolved = resolveRole(role);
+  if (!resolved) return false;
+  if (allowedIds.has(resolved.roleId)) return true;
+  if (resolved.explicit) return false;
+  return resolved.roleId.split("-").some((word) => allowedIds.has(word));
+}
+
+export function isGateRunner(role) {
+  return roleMatches(role, GATE_RUNNER_ROLE_IDS);
+}
+
+export function isCoordinator(role) {
+  return roleMatches(role, COORDINATOR_ROLE_IDS);
+}