agent-coord-mcp 0.26.18 → 0.26.20

package/dist/transports/config.js

@@ -0,0 +1,82 @@
+/**
+ * WHICH TRANSPORT THIS FLEET IS CONFIGURED TO USE (Phase 5.4 Task 3.1–3.2).
+ *
+ * Whole-fleet, read ONCE at startup, per David 2026-09-11 — no per-seat
+ * branching in `send_command` or `attach`. Memoised for that reason and not for
+ * speed: a value that can be re-read mid-process is a value that can change
+ * mid-process, and then two calls in one session disagree about what the fleet
+ * is doing.
+ *
+ * ⛔ AN UNKNOWN VALUE REFUSES AT STARTUP. It does not fall back to `tmux-push`.
+ *
+ * The reason is not tidiness. A SILENT FALLBACK AND A CORRECT DEFAULT PRODUCE
+ * IDENTICAL EVIDENCE: both give you a fleet on tmux with nothing in any log, so
+ * a typo in the config reads exactly like a deliberate default, and the person
+ * who typed `heardr` spends the afternoon asking why their transport change did
+ * nothing. Refusing is louder than the bug it prevents.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { ROOT } from "../store.js";
+import { TMUX_PUSH, TRANSPORT_KINDS } from "./types.js";
+/** `$AGENT_COORD_DIR/config.json`, the fleet-wide file. */
+export const TRANSPORT_CONFIG_FILE = path.join(ROOT, "config.json");
+export const TRANSPORT_ENV_VAR = "AGENT_COORD_TRANSPORT";
+function refuse(value, origin) {
+    throw new Error(`[agent-coord-mcp] unknown transport ${JSON.stringify(value)} from ${origin}. ` +
+        `Valid: ${TRANSPORT_KINDS.join(", ")}. ` +
+        `REFUSING AT STARTUP rather than falling back to "${TMUX_PUSH}" — a silent fallback and a correct ` +
+        `default leave identical evidence, so a typo here would look exactly like a working default and the ` +
+        `transport change would appear to do nothing. Fix the value or remove it to get the default.`);
+}
+function asKind(value, origin) {
+    if (typeof value !== "string" || value.length === 0)
+        refuse(String(value), origin);
+    const match = TRANSPORT_KINDS.find((k) => k === value);
+    if (!match)
+        refuse(value, origin);
+    return match;
+}
+let cached;
+/**
+ * Resolve the fleet's transport. Throws on an unknown value — call it once at
+ * startup so the refusal lands before any agent attaches.
+ */
+export function configuredTransport() {
+    if (cached)
+        return cached;
+    if (existsSync(TRANSPORT_CONFIG_FILE)) {
+        let parsed;
+        try {
+            parsed = JSON.parse(readFileSync(TRANSPORT_CONFIG_FILE, "utf8"));
+        }
+        catch (e) {
+            // A CONFIG FILE THAT CANNOT BE PARSED IS NOT AN ABSENT ONE. Treating it as
+            // absent would silently use the default while a file sits there stating
+            // otherwise — the same two-states-one-evidence defect as the fallback.
+            throw new Error(`[agent-coord-mcp] ${TRANSPORT_CONFIG_FILE} is unreadable (${e.message}). ` +
+                `REFUSING rather than treating it as absent: a file that exists and cannot be read is not the ` +
+                `same as no file, and defaulting here would hide a stated intent behind a working fleet.`);
+        }
+        const raw = parsed?.transport;
+        if (raw !== undefined) {
+            cached = { kind: asKind(raw, `${TRANSPORT_CONFIG_FILE} ("transport")`), source: "config", origin: TRANSPORT_CONFIG_FILE };
+            return cached;
+        }
+    }
+    const env = process.env[TRANSPORT_ENV_VAR];
+    if (env !== undefined && env !== "") {
+        cached = { kind: asKind(env, `$${TRANSPORT_ENV_VAR}`), source: "env", origin: `$${TRANSPORT_ENV_VAR}` };
+        return cached;
+    }
+    cached = { kind: TMUX_PUSH, source: "default", origin: `built-in default (${TMUX_PUSH})` };
+    return cached;
+}
+/**
+ * Drop the memo. FOR TESTS ONLY — the whole point of reading once is that
+ * production code cannot do this.
+ */
+export function resetConfiguredTransportForTests() {
+    cached = undefined;
+}
+//# sourceMappingURL=config.js.map

package/dist/transports/config.js.map

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

package/dist/transports/index.js

@@ -0,0 +1,113 @@
+/**
+ * THE REGISTRY — the one place a transport kind is turned into an implementation.
+ *
+ * `resolveTransport` is deliberately total over `TransportKind`: adding a kind to
+ * the union without registering it is a compile error here rather than a silent
+ * fall-through at a call site. Until Task 3, tmux is the only registered
+ * implementation and that is the rollback plan — the seam lands behind no config.
+ */
+import { HERDR, TMUX_PUSH, TMUX_PUSH_REMOTE } from "./types.js";
+import { TmuxTransport } from "./tmux.js";
+import { configuredTransport } from "./config.js";
+export * from "./types.js";
+export * from "./config.js";
+export { TmuxTransport, tmuxAvailable, paneExists, probePane, tmuxVersion } from "./tmux.js";
+let host;
+/** Wire the process-layer implementation in once, at module init. */
+export function registerTmuxHost(h) {
+    host = h;
+}
+export function resolveTransport(kind) {
+    if (!host) {
+        throw new Error("transport host not registered — call registerTmuxHost() before resolveTransport(); " +
+            "this is a wiring error, not a runtime condition");
+    }
+    switch (kind) {
+        case TMUX_PUSH:
+        case TMUX_PUSH_REMOTE:
+            return new TmuxTransport(host, kind);
+        case HERDR:
+            // Task 4. Named so the union stays total and the gap is a stated absence
+            // rather than a default that silently behaves like tmux.
+            throw new Error('transport "herdr" is not implemented yet (Phase 5.4 Task 4)');
+    }
+}
+/* ── the ACTIVE transport, and why `running` is not read from config ────────── */
+/**
+ * The instance this process would actually use to deliver.
+ *
+ * Kept as an OBJECT rather than re-derived from the config value on each call,
+ * and that is the whole design. If `running` were computed by reading the config
+ * and resolving it, then `configured` and `running` would be two names for one
+ * fact and `agrees` could never be false — a check that cannot fail. The active
+ * instance is what startup actually installed, so the two can genuinely differ:
+ * a startup that refused, a process that never wired one, a test that installed
+ * another, a future path that falls back.
+ */
+let active;
+export function setActiveTransport(t) {
+    active = t;
+}
+/** FOR TESTS ONLY — production wires the active transport once, at startup. */
+export function clearActiveTransportForTests() {
+    active = undefined;
+}
+export function activeTransport() {
+    return active;
+}
+/**
+ * Wire the transport this fleet is configured for. Called once at startup, and
+ * it is where an unknown config value turns into a refusal.
+ */
+export function initTransportFromConfig() {
+    const conf = configuredTransport();
+    setActiveTransport(resolveTransport(conf.kind));
+    return { kind: conf.kind, source: conf.source };
+}
+/**
+ * WHAT THIS PROCESS IS ACTUALLY RUNNING, answered by CALLING the transport.
+ *
+ * *A config value is a label someone typed.* This asks the live object instead:
+ * it calls `available()` and puts a synthetic marker through `probe()`, and
+ * reports what came back as the evidence beside the answer. The probe is chosen
+ * to be discriminating rather than decorative — a tmux transport answers a
+ * bogus pane id with a reason that names the pane, and an implementation that
+ * does not talk to panes cannot produce that.
+ *
+ * Returns `undefined` for `kind` when nothing is wired, which is NOT the same as
+ * "tmux by default": a process with no transport delivers nothing, and reporting
+ * a default here would be the exact substitution this function exists to refuse.
+ */
+export async function runningTransport() {
+    const t = active;
+    if (!t) {
+        return {
+            kind: undefined,
+            evidence: "no transport is wired in this process — nothing was called, and no default is assumed",
+        };
+    }
+    const availability = (() => {
+        try {
+            return `available()=${t.available()}`;
+        }
+        catch (e) {
+            return `available() threw: ${e.message}`;
+        }
+    })();
+    let probeEvidence;
+    try {
+        const live = await t.probe({
+            agentId: "__capability_probe__",
+            transport: t.kind,
+            pid: process.pid,
+            target: "__no_such_target__",
+            since: Date.now(),
+        });
+        probeEvidence = `probe(bogus target)=${live.state}${live.state === "live" ? "" : `: ${live.reason}`}`;
+    }
+    catch (e) {
+        probeEvidence = `probe threw: ${e.message}`;
+    }
+    return { kind: t.kind, evidence: `${availability}, ${probeEvidence}` };
+}
+//# sourceMappingURL=index.js.map

package/dist/transports/index.js.map

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

package/dist/transports/tmux.js

@@ -0,0 +1,140 @@
+/**
+ * THE TMUX TRANSPORT — every `tmux` shell-out in this package, in one file.
+ *
+ * Before this, `spawnSync("tmux", …)` appeared at 7 sites in `tools/transport.ts`
+ * and the `has-session` caveat below was written out TWICE, verbatim, at two of
+ * them. A rule duplicated in two comments is a rule that will be re-derived
+ * wrongly at the third site somebody adds.
+ *
+ * WHAT THIS FILE DOES NOT DO, on purpose: spawn or reap the pusher process,
+ * read receipts, or schedule reminders. Delivery is a second process for THIS
+ * transport and will not be for a socket one, so that machinery stays with the
+ * tools that own it and reaches this file through `TmuxHost` below. An interface
+ * that baked in a pusher could not host an implementation that has none.
+ */
+import { spawnSync } from "node:child_process";
+import { TMUX_PUSH, isLocallyProbeable, isTmuxKind, targetOf } from "./types.js";
+/** `tmux -V` — is tmux on this host at all? */
+export function tmuxAvailable() {
+    return spawnSync("tmux", ["-V"]).status === 0;
+}
+/**
+ * DOES THIS TARGET EXIST? The only tmux probe with discriminating power.
+ *
+ * `has-session` VALIDATES THE TARGET; `display-message -p -t <target> "ok"`
+ * DOES NOT — tmux exits 0 for any target, including a pane killed a moment ago,
+ * so that probe had ZERO discriminating power and reported every dead pane
+ * alive. Pinned to the BEHAVIOUR, not a version: measured identical on tmux
+ * 3.6b, 3.7b. A version-pinned claim rots on the next upgrade.
+ *
+ * Positive control, both directions, re-run on tmux 3.7b while extracting this:
+ * bogus target `%99999` -> has-session exit 1, display-message exit 0; live pane
+ * `%8` -> both exit 0. The wrong probe is wrong in only one direction, which is
+ * why it survived: it never reports a live pane dead.
+ */
+export function paneExists(target) {
+    return spawnSync("tmux", ["has-session", "-t", target]).status === 0;
+}
+/**
+ * `has-session` with the failure text, for the one caller that reports it.
+ *
+ * `paneExists` is the boolean most sites want; attach quotes tmux's own stderr
+ * back to the user, and losing that text would make a refusal less useful while
+ * still typechecking — the exact class of silent regression this task guards.
+ */
+export function probePane(target) {
+    const probe = spawnSync("tmux", ["has-session", "-t", target]);
+    return { exists: probe.status === 0, stderr: (probe.stderr ?? "").toString().trim() };
+}
+/** `tmux -V` output, or undefined when tmux is absent. */
+export function tmuxVersion() {
+    const probe = spawnSync("tmux", ["-V"]);
+    if (probe.status !== 0)
+        return undefined;
+    return (probe.stdout ?? "").toString().trim() || undefined;
+}
+export class TmuxTransport {
+    kind;
+    #host;
+    constructor(host, kind = TMUX_PUSH) {
+        this.#host = host;
+        this.kind = kind;
+    }
+    available() {
+        return tmuxAvailable();
+    }
+    attach(args) {
+        return this.#host.attach(args);
+    }
+    detach(agentId) {
+        return this.#host.detach(agentId);
+    }
+    push(marker, text) {
+        return this.#host.push(marker, text);
+    }
+    sendControl(marker, cmd) {
+        return this.#host.sendControl(marker, cmd);
+    }
+    /**
+     * THREE ANSWERS, AND THE THIRD IS LOAD-BEARING.
+     *
+     * Each `unknown` below was previously a `continue` with a comment. The states
+     * are preserved exactly, because "we could not look" is not evidence of death
+     * and a reaper that cannot tell them apart kills live sessions:
+     *
+     * · not a tmux marker        -> unknown (this transport cannot speak for it)
+     * · remote (foreign host)    -> unknown (no local pane; heartbeat decides)
+     * · no target recorded       -> unknown (nothing to probe)
+     * · tmux missing on host     -> unknown (the instrument is absent, not the pane)
+     * · target absent            -> dead
+     * · pusher gone, pane alive  -> dead, and it says which half failed
+     */
+    async probe(marker) {
+        if (!isTmuxKind(marker.transport)) {
+            return { state: "unknown", reason: `transport "${marker.transport}" is not tmux` };
+        }
+        if (!isLocallyProbeable(marker.transport)) {
+            return {
+                state: "unknown",
+                reason: `${marker.transport} runs on another host${marker.host ? ` (${marker.host})` : ""} — no local pane to probe; liveness is heartbeat-based`,
+            };
+        }
+        const target = targetOf(marker);
+        if (!target)
+            return { state: "unknown", reason: "no target recorded on the marker" };
+        if (!tmuxAvailable())
+            return { state: "unknown", reason: "tmux is not available on this host" };
+        if (!paneExists(target))
+            return { state: "dead", reason: `pane ${target} does not exist` };
+        if (!this.#host.pusherAlive(marker)) {
+            return { state: "dead", reason: `pane ${target} is alive but its pusher (pid ${marker.pid}) is gone` };
+        }
+        return { state: "live" };
+    }
+    /**
+     * Reap pushers whose pane has gone, and say which ones could not be judged.
+     *
+     * `unprobeable` is NOT a residual list nobody reads — it is the distinction
+     * PRODUCTION_ROADMAP Phase 5.3 requires between "dead" and "cannot probe".
+     * An agent whose liveness is unknown is left alone and reported, never reaped.
+     */
+    async reapWedged(markers) {
+        const reaped = [];
+        const unprobeable = [];
+        for (const marker of markers) {
+            const live = await this.probe(marker);
+            if (live.state === "unknown") {
+                unprobeable.push(marker.agentId);
+                continue;
+            }
+            if (live.state === "live")
+                continue;
+            if (this.#host.killPusher(marker))
+                reaped.push(marker.agentId);
+            else
+                unprobeable.push(marker.agentId);
+        }
+        return { reaped, unprobeable };
+    }
+}
+//# sourceMappingURL=tmux.js.map

package/dist/transports/tmux.js.map

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

package/dist/transports/types.js

@@ -0,0 +1,86 @@
+/**
+ * THE TRANSPORT SEAM (Phase 5.4 Task 2).
+ *
+ * This interface is DERIVED from the 12 `"tmux-push"` literals and the 7
+ * `spawnSync("tmux", …)` shell-outs that were spread across `tools/`, not
+ * designed top-down. Where the phase doc's sketch and the code disagreed, the
+ * code won — three times, each recorded below, because the gate for this task is
+ * that a running fleet cannot tell the difference.
+ *
+ * 1. `tmux-push-remote` IS A LIVE KIND. The doc's sketch had two kinds; the code
+ *    has three. `registry.ts` gives remote markers heartbeat-based liveness
+ *    because their pid is 0 on a foreign host, and `server.ts` documents the
+ *    value as the wire contract for `scripts/coord-pusher.mjs`. A union without
+ *    it silently reclassifies every remote agent as not-tmux.
+ * 2. THE MARKER HAS NINE FIELDS, NOT SIX. `scriptMtime`, `serverBuildMtime` and
+ *    `rooms` are absent from the sketch and each one closes a defect that
+ *    actually shipped. They are kept verbatim, including the rule they share:
+ *    ABSENT MEANS UNKNOWN, NEVER "ON" — the same principle as `Liveness.unknown`
+ *    below, one field deeper.
+ * 3. `target` IS ADDITIVE, NOT A RENAME. See `targetOf`.
+ */
+/**
+ * Every transport value that can appear in a marker on disk.
+ *
+ * Not `string`: the whole defect being fixed is code branching on a literal
+ * instead of reading the field, and a `string` discriminant cannot tell the
+ * compiler that a branch was missed. Not a two-member union either — see (1).
+ */
+export const TMUX_PUSH = "tmux-push";
+export const TMUX_PUSH_REMOTE = "tmux-push-remote";
+export const HERDR = "herdr";
+export const TRANSPORT_KINDS = [TMUX_PUSH, TMUX_PUSH_REMOTE, HERDR];
+/**
+ * The tmux family. Both members are delivered by a pusher process typing into a
+ * pane; they differ in WHERE that pane is, which is why liveness splits below.
+ *
+ * THIS IS THE ONE PLACE THE TMUX LITERALS LIVE. Twelve call sites used to spell
+ * them; they now ask.
+ */
+const TMUX_KINDS = new Set([TMUX_PUSH, TMUX_PUSH_REMOTE]);
+/** Is this marker carried by the tmux family (local OR remote)? */
+export function isTmuxKind(transport) {
+    return transport !== undefined && TMUX_KINDS.has(transport);
+}
+/**
+ * Is this marker's pane on THIS host, so that a local probe means anything?
+ *
+ * The distinction every `marker.transport !== "tmux-push"` site was making by
+ * hand, with a comment explaining "remote = can't verify". Naming it stops the
+ * next person re-deriving it — and re-deriving it wrongly is how a remote agent
+ * gets reported dead because a pane that was never local did not answer.
+ */
+export function isLocallyProbeable(transport) {
+    return transport === TMUX_PUSH;
+}
+/**
+ * Is liveness for this marker decided by the registry heartbeat rather than by a
+ * local pid? True only for the remote kind, whose pid is 0 on a foreign host.
+ */
+export function isRemoteTmuxKind(transport) {
+    return transport === TMUX_PUSH_REMOTE;
+}
+/**
+ * Read a marker's address, preferring the generic field and falling back to the
+ * tmux-specific one.
+ *
+ * This is the read half of the dual-write. Call it rather than touching either
+ * field: a consumer that reads only `tmuxTarget` goes blind the day a herdr
+ * marker appears, and one that reads only `target` is blind to every marker on
+ * disk today.
+ */
+export function targetOf(marker) {
+    return marker.target ?? marker.tmuxTarget;
+}
+/**
+ * Stamp an address into BOTH fields, so the marker is legible to the current
+ * code and to whatever a revert restores.
+ */
+export function withTarget(marker, target) {
+    if (target === undefined)
+        return marker;
+    return { ...marker, target, tmuxTarget: target };
+}
+/** Keystroke-shaped commands a transport must deliver to an interactive pane. */
+export const CONTROL_COMMANDS = ["clear", "compact", "reload-skills"];
+//# sourceMappingURL=types.js.map

package/dist/transports/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/transports/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,WAAoB,CAAC;AAC9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAA2B,CAAC;AAC5D,MAAM,CAAC,MAAM,KAAK,GAAG,OAAgB,CAAC;AAItC,MAAM,CAAC,MAAM,eAAe,GAA6B,CAAC,SAAS,EAAE,gBAAgB,EAAE,KAAK,CAAU,CAAC;AAEvG;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAS,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAElE,mEAAmE;AACnE,MAAM,UAAU,UAAU,CAAC,SAA6B;IACtD,OAAO,SAAS,KAAK,SAAS,IAAI,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAA6B;IAC9D,OAAO,SAAS,KAAK,SAAS,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAA6B;IAC5D,OAAO,SAAS,KAAK,gBAAgB,CAAC;AACxC,CAAC;AAoDD;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAsD;IAC7E,OAAO,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAmB,MAAS,EAAE,MAA0B;IAChF,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AACnD,CAAC;AAeD,iFAAiF;AACjF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,eAAe,CAAU,CAAC"}

package/dist/typed-records.js

@@ -0,0 +1,174 @@
+// Typed records become obligatory on agent→agent traffic (Phase 5.1 Task 12).
+//
+// THE MECHANISM ALREADY SHIPPED AND ADOPTION WAS THE WHOLE GAP.
+// `hooks/tier.mjs:injectLine` slims a multi-line message to *first line +
+// `[+N lines · record:<type> · retrieve_message id=<uuid>]`* — but ONLY when
+// `record.type` is a string. Measured on the groundwork room 2026-08-30: 206
+// messages, 175 multi-line, 33 typed, 33 slimmed; the coordinator had sent 101
+// and typed 0. The renderer was never the problem.
+//
+// SO THE RULE IS ENFORCED AT THE SEND, NOT THE RENDER. An untyped agent→agent
+// message must not be able to EXIST, or the next reader re-derives the type
+// from prose and we are back to parsing English. Prose is a second source of
+// truth about what a message meant.
+//
+// Three things this module is careful about, each one a stated acceptance
+// property rather than an implementation taste:
+//
+//  1. STAGED, WITH A NAMED DATE. Five fleets share this bus and 7 of 13 server
+//     processes predate 0.26.7. A refusal shipped before a verified restart
+//     rejects messages from agents that CANNOT comply — the sender gets an
+//     error it has no code path to satisfy. So: WARN until the cutover, REFUSE
+//     after it, and the warning names the date in every single message so the
+//     deadline arrives having been announced ~every send rather than once.
+//
+//  2. THE REFUSAL NAMES A TYPE THE SENDER MAY ACTUALLY USE. `go` and `scope`
+//     are coordinator-restricted and `verdict` is gate-runner-restricted
+//     (RECORD_AUTHORITY): the aide hit exactly this, being told to use `scope`
+//     by one check and refused it by another. Naming a forbidden type is
+//     unusable guidance, so every suggestion is filtered through what this
+//     sender's role may emit before it is offered.
+//
+//  3. `fyi` IS AN HONEST CATCH-ALL. If the nine types do not cover a legitimate
+//     send, agents mistype into whatever passes and the type becomes noise —
+//     which costs more than the untyped message did. Anything unrecognised
+//     suggests `fyi` and says so plainly, never a forced `decision`/`risk`.
+// The named cutover. Until this instant an untyped agent→agent send WARNS and
+// is stored; from it, the same send is refused.
+//
+// A DATE, NOT A VERSION, because the constraint being waited on is a fleet-wide
+// RESTART, and no version string on the wire can answer "has every server
+// restarted" — 0.26.7 is published while servers predating it still run. Time
+// is the only clock every one of those processes shares.
+export const TYPED_RECORD_CUTOVER_ISO = "2026-09-15T00:00:00.000Z";
+export const TYPED_RECORD_CUTOVER_MS = Date.parse(TYPED_RECORD_CUTOVER_ISO);
+// `AGENT_COORD_TYPED_RECORDS=warn|refuse` overrides the date. It exists for two
+// callers and no others: tests (which must exercise both sides of a date that
+// has not arrived) and an operator who needs to pull the refusal back for a
+// fleet mid-incident. It is NOT the exemption — an exemption is per-agent and
+// visible (see `proseOnly`); this switch is fleet-wide and invisible, which is
+// exactly why it is not how a less capable model gets on the bus.
+export function typedRecordMode(now = Date.now()) {
+    const env = process.env.AGENT_COORD_TYPED_RECORDS;
+    if (env === "warn" || env === "refuse")
+        return env;
+    return now >= TYPED_RECORD_CUTOVER_MS ? "refuse" : "warn";
+}
+// ---------- suggesting the type the sender should have used ----------
+// A rejection that says only "record required" costs a round trip; one that
+// says "looks like a `done` — it cites a PR" costs none. A FAILURE PATH MUST BE
+// MORE INFORMATIVE THAN THE SUCCESS PATH HERE, because it fires during a
+// migration, at agents that are mid-slice and did nothing wrong yesterday.
+//
+// Read from the text the fleet already writes: the six canonical prefixes are
+// in every card and on ~every message, so the type is usually already declared
+// in English one token in.
+const PREFIX_TYPES = [
+    [/^\s*DONE\b/i, "done", "the message opens with the DONE: prefix"],
+    [/^\s*BLOCKER\b/i, "blocker", "the message opens with the BLOCKER: prefix"],
+    [/^\s*RISK\b/i, "risk", "the message opens with the RISK: prefix"],
+    [/^\s*FYI\b/i, "fyi", "the message opens with the FYI: prefix"],
+    [/^\s*AGENT_ACTION\b/i, "action", "the message opens with the AGENT_ACTION: prefix"],
+    [/^\s*DAVID_DECISION\b/i, "decision", "the message opens with the DAVID_DECISION: prefix"],
+    [/^\s*GO\b/i, "go", "the message opens with the GO: prefix"],
+    [/^\s*SCOPE(?:\s+CHANGE)?\b/i, "scope", "the message opens with the SCOPE: prefix"],
+];
+// Weaker than a prefix and only consulted when there is no prefix at all.
+const SHAPE_TYPES = [
+    [/\b(PASS|FAIL)\b.*\b[0-9a-f]{7,40}\b/, "verdict", "it reads as a gate verdict over a commit sha"],
+    [/^\s*(PASS|FAIL)\b/, "verdict", "it opens with a PASS/FAIL gate result"],
+    [/(^|\s)(#\d+|[\w.-]+\/[\w.-]+#\d+|https:\/\/github\.com\/\S+\/pull\/\d+)/, "done", "it cites a PR"],
+];
+/**
+ * The record type this message most likely should have carried, CONSTRAINED to
+ * what this sender is allowed to emit.
+ *
+ * `mayNotEmit` is the restricted set this role is refused (recordAuthorityFor).
+ * A suggestion landing in it is downgraded to `fyi` and the downgrade is
+ * reported rather than hidden — being quietly steered off `go` reads as the
+ * heuristic being bad, when in fact the role simply does not own that type.
+ */
+export function suggestRecordType(text, mayNotEmit = []) {
+    const forbidden = new Set(mayNotEmit);
+    const firstLine = (text ?? "").split("\n", 1)[0] ?? "";
+    const hit = PREFIX_TYPES.find(([re]) => re.test(firstLine)) ??
+        SHAPE_TYPES.find(([re]) => re.test(firstLine) || re.test(text ?? ""));
+    if (!hit) {
+        return {
+            type: "fyi",
+            why: "nothing in the text names a kind — 'fyi' is the honest catch-all and is never wrong on purpose",
+        };
+    }
+    const [, type, why] = hit;
+    if (forbidden.has(type)) {
+        return {
+            type: "fyi",
+            downgradedFrom: type,
+            why: `${why}, but '${type}' is restricted to roles this sender does not hold — 'fyi' carries the same slimming`,
+        };
+    }
+    return { type, why };
+}
+/**
+ * The one line of guidance appended to both the warning and the refusal. Same
+ * words either side of the cutover ON PURPOSE: an agent that reads it during
+ * the warn window has already been told the exact call that will keep working.
+ */
+export function typedRecordGuidance(s) {
+    const cite = s.type === "done"
+        ? `, cites: [{kind:'pr', ref:'<owner/repo#N>'}]` // a `done` is refused without one anyway
+        : "";
+    return (`looks like a '${s.type}' — ${s.why}. ` +
+        `Add record: {type:'${s.type}', payload:{summary:'<one line>'}${cite}} to this same call; ` +
+        `'text' is untouched by the record and your wording always wins.`);
+}
+// ---------- measuring adoption, and the inverse failure ----------
+// SUCCESS IS THE TRAFFIC TABLE RE-MEASURED, NOT THIS TASK MERGED. The baseline
+// captured the day the rule was made: 212 room messages, 37 typed (17%),
+// 425,903 bytes sitting below line 1 — bytes every reader pays for and no
+// reader asked for.
+//
+// AND THE INVERSE FAILURE LOOKS EXACTLY LIKE SUCCESS ON A COVERAGE NUMBER. If
+// `fyi` becomes nearly everything, coverage reads ~100% while agents are
+// mistyping to get past the gate and the type has stopped carrying
+// information — that is the catch-all rule (12.5) failing, not holding. So the
+// distribution is reported alongside the percentage and is what the verdict
+// keys on. A coverage-only check would certify the failure it exists to catch.
+//
+// The threshold is deliberately generous: `fyi` IS the honest answer for a
+// large share of real traffic, so this fires on domination, not on presence.
+export const FYI_DOMINANCE_THRESHOLD = 0.75;
+/** `messages` is any array of stored messages ({text, record?}). */
+export function typedRecordStats(messages) {
+    const distribution = {};
+    let typed = 0;
+    let unslimmedBytes = 0;
+    for (const m of messages) {
+        const type = typeof m.record?.type === "string" ? m.record.type : undefined;
+        distribution[type ?? "untyped"] = (distribution[type ?? "untyped"] ?? 0) + 1;
+        if (type) {
+            typed++;
+            continue;
+        }
+        const text = m.text ?? "";
+        const nl = text.indexOf("\n");
+        if (nl !== -1)
+            unslimmedBytes += Buffer.byteLength(text.slice(nl + 1), "utf8");
+    }
+    const total = messages.length;
+    const coverage = total ? typed / total : 0;
+    const fyiShareOfTyped = typed ? (distribution.fyi ?? 0) / typed : 0;
+    // Order matters: degeneracy is checked BEFORE coverage, or a room that is
+    // 100% `fyi` reports "healthy" — the exact misreading this guards.
+    const degenerate = typed >= 10 && fyiShareOfTyped > FYI_DOMINANCE_THRESHOLD;
+    const verdict = degenerate ? "degenerate" : coverage >= 0.95 ? "healthy" : "adopting";
+    const note = degenerate
+        ? `'fyi' is ${(fyiShareOfTyped * 100).toFixed(0)}% of typed messages — coverage looks solved while the type has ` +
+            `stopped carrying information. Agents are typing to pass the gate, which is 12.5 FAILING, not holding.`
+        : verdict === "healthy"
+            ? `${(coverage * 100).toFixed(0)}% typed with a spread distribution — the reader-side cost is paid down and the type still discriminates.`
+            : `${(coverage * 100).toFixed(0)}% typed; ${unslimmedBytes.toLocaleString("en-US")} bytes still sit below line 1 in untyped messages, ` +
+                `carried by every reader.`;
+    return { total, typed, coverage: Number(coverage.toFixed(3)), unslimmedBytes, distribution, fyiShareOfTyped: Number(fyiShareOfTyped.toFixed(3)), verdict, note };
+}
+//# sourceMappingURL=typed-records.js.map

package/dist/typed-records.js.map

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

package/dist/work.js

@@ -0,0 +1,2 @@
+export { BOARD_ARITY, isMalformedRow, EM_DASH_SEP, MIDDOT_SEP, parseQueueLine, parseDoneLine, renderQueueLine, renderDoneLine, renderBoardRow, parseWorkDoc, renderWorkDoc, renderWorkDocForWrite, stampQueueIds, zeroIsUnparsed, substantiveLines, 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

@@ -0,0 +1 @@
+{"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,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,wBAAwB,EACxB,oBAAoB,GAGrB,MAAM,mCAAmC,CAAC"}