@davidbalzan/groundwork-seam 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 David Balzan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,7 @@
+# @davidbalzan/groundwork-seam
+
+Schema owner of `docs/QUEUE.md`, `docs/DONE.md`, `docs/WORKSTREAMS.md`, `docs/FACTS.md`, plus typed protocol records.
+
+Markdown stays authoritative. This package is a library, not a daemon.
+
+PR2 parse contract: any markdown table is a board, arity 5. Header-cell detection is PR3.

package/dist/docs.d.ts

@@ -0,0 +1,125 @@
+import { EM_DASH_SEP, MIDDOT_SEP } from "./glyphs.js";
+import { SCHEMA, type WorkstreamsExtId, type WorkstreamsExtKey } from "./schema.js";
+export type Priority = "P1" | "P2" | "P3";
+export type QueueItem = {
+    id: string;
+    priority: Priority;
+    text: string;
+    done: boolean;
+    section?: string;
+};
+export type DoneEntry = {
+    id: string;
+    text: string;
+    ref?: string;
+    date?: string;
+    section?: string;
+};
+export type BoardRow = {
+    id: string;
+    lane: string;
+    owner: string;
+    state: string;
+    currentSlice: string;
+    nextGo: string;
+    raw?: string;
+};
+export declare const BOARD_ARITY = 5;
+export type MalformedRow = {
+    malformed: true;
+    verbatim: string;
+    issue: string;
+};
+export type AnyBoardRow = BoardRow | WorkstreamsV1Row | ExtensionRow | MalformedRow;
+export declare function isMalformedRow(r: AnyBoardRow): r is MalformedRow;
+export type WorkstreamsV1Row = {
+    id: string;
+    stream: string;
+    owner: string;
+    branchWorktree: string;
+    status: string;
+    blocker: string;
+    lastNote: string;
+    raw?: string;
+};
+export declare function isWorkstreamsV1Row(r: AnyBoardRow): r is WorkstreamsV1Row;
+export type BoardSchema = typeof SCHEMA.workstreams | typeof SCHEMA.workstreamsLanesV0 | WorkstreamsExtId;
+export type ExtensionRow = {
+    extension: WorkstreamsExtKey;
+    cells: string[];
+    raw?: string;
+};
+export declare function isExtensionRow(r: AnyBoardRow): r is ExtensionRow;
+export type Block = {
+    kind: "text";
+    lines: string[];
+} | {
+    kind: "queue";
+    items: QueueItem[];
+} | {
+    kind: "done";
+    entries: DoneEntry[];
+} | {
+    kind: "board";
+    header: string;
+    align: string;
+    schema?: BoardSchema;
+    rows: (BoardRow | WorkstreamsV1Row | ExtensionRow | MalformedRow)[];
+} | {
+    kind: "decisions";
+    items: string[];
+};
+export type WorkDoc = {
+    trailingNewline: boolean;
+    blocks: Block[];
+    warnings?: string[];
+};
+export { EM_DASH_SEP, MIDDOT_SEP };
+export declare function parseQueueLine(line: string, section?: string): QueueItem | null;
+export declare function parseDoneLine(line: string, section?: string): DoneEntry | null;
+export declare function renderQueueLine(item: QueueItem): string;
+export declare function renderDoneLine(entry: DoneEntry): string;
+export declare function renderBoardRow(r: BoardRow | WorkstreamsV1Row | ExtensionRow | MalformedRow): string;
+export declare function parseWorkDoc(source: string): WorkDoc;
+export declare function renderWorkDoc(doc: WorkDoc): string;
+export declare function queueItemsOf(doc: WorkDoc): QueueItem[];
+export declare function doneEntriesOf(doc: WorkDoc): DoneEntry[];
+export declare function boardRowsOf(doc: WorkDoc): BoardRow[];
+export declare function workstreamsV1RowsOf(doc: WorkDoc): WorkstreamsV1Row[];
+export type WorkstreamsExtensions = {
+    openPrs: Record<string, string>[];
+    cutoverGates: Record<string, string>[];
+    needsDavid: Record<string, string>[];
+    risks: Record<string, string>[];
+    rooms: Record<string, string>[];
+    decisions: string[];
+};
+export declare function workstreamsExtensionsOf(doc: WorkDoc): WorkstreamsExtensions;
+export type ListWorkBoardRow = {
+    schema: typeof SCHEMA.workstreams;
+    id: string;
+    stream: string;
+    owner: string;
+    branchWorktree: string;
+    status: string;
+    blocker: string;
+    lastNote: string;
+} | {
+    schema: typeof SCHEMA.workstreamsLanesV0;
+    id: string;
+    lane: string;
+    owner: string;
+    state: string;
+    currentSlice: string;
+    nextGo: string;
+};
+export declare function listWorkBoardOf(doc: WorkDoc): ListWorkBoardRow[];
+export declare function projectV1ToLanes(row: ListWorkBoardRow): Extract<ListWorkBoardRow, {
+    schema: typeof SCHEMA.workstreamsLanesV0;
+}>;
+export declare function workDocIssues(doc: WorkDoc): string[];
+export declare const LANES_V0_WRITE_ISSUE = "workstreams.lanes-v0 is parse-only \u2014 new writes must use workstreams.v1 (6-col Active Streams)";
+/** 5-col Lanes still parses; this is the write-grammar refusal for doctor / export. */
+export declare function workDocLegacyWriteIssues(doc: WorkDoc): string[];
+/** Alias used in the design: MCP BoardRow is lanes-v0. */
+export type LanesV0Row = BoardRow;

package/dist/docs.js

@@ -0,0 +1,494 @@
+// 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";
+import { EM_DASH_SEP, MIDDOT_SEP } from "./glyphs.js";
+import { LANES_V0_HEADERS, SCHEMA, WORKSTREAMS_EXT, WORKSTREAMS_V1_ARITY, WORKSTREAMS_V1_HEADERS, } from "./schema.js";
+// 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;
+}
+export function isWorkstreamsV1Row(r) {
+    return !isMalformedRow(r) && "stream" in r;
+}
+export function isExtensionRow(r) {
+    return !isMalformedRow(r) && "extension" in r && "cells" in r;
+}
+// ---------- 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 { EM_DASH_SEP, 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];
+}
+function v1Cells(r) {
+    return [r.stream, r.owner, r.branchWorktree, r.status, r.blocker, r.lastNote];
+}
+function normHeaderCell(s) {
+    return s.trim().toLowerCase().replace(/\s+/g, " ").replace(/[·•]/g, "\u00b7");
+}
+function headersEqual(cells, expected) {
+    if (cells.length !== expected.length)
+        return false;
+    return cells.every((c, i) => normHeaderCell(c) === normHeaderCell(expected[i] ?? ""));
+}
+/** Lanes-v0 even if extra columns were inserted (the #38 Pane-column shape). */
+function looksLikeLanesHeader(cells) {
+    const n = new Set(cells.map(normHeaderCell));
+    return LANES_V0_HEADERS.every((h) => n.has(normHeaderCell(h)));
+}
+function classifyBoardHeader(cells) {
+    if (headersEqual(cells, WORKSTREAMS_V1_HEADERS))
+        return SCHEMA.workstreams;
+    if (headersEqual(cells, LANES_V0_HEADERS) || looksLikeLanesHeader(cells))
+        return SCHEMA.workstreamsLanesV0;
+    for (const ext of Object.values(WORKSTREAMS_EXT)) {
+        if (headersEqual(cells, ext.headers))
+            return ext.id;
+    }
+    return "unknown";
+}
+// 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 (isExtensionRow(r)) {
+        if (r.raw !== undefined) {
+            const cells = splitRow(r.raw);
+            if (cells.length === r.cells.length && cells.every((c, i) => c === r.cells[i]))
+                return r.raw;
+        }
+        return renderRow(r.cells);
+    }
+    if (isWorkstreamsV1Row(r)) {
+        if (r.raw !== undefined) {
+            const cells = splitRow(r.raw);
+            if (cells.length === WORKSTREAMS_V1_ARITY && cells.every((c, i) => c === v1Cells(r)[i]))
+                return r.raw;
+        }
+        return renderRow(v1Cells(r));
+    }
+    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";
+    if (h === "decisions recorded")
+        return "decisions";
+    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 = [];
+    const warnings = [];
+    let text = [];
+    let kind = "none";
+    let subsection;
+    let inFence = false;
+    let inHtmlComment = 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] });
+    };
+    const pushDecision = (item) => {
+        flushText();
+        const last = blocks[blocks.length - 1];
+        if (last?.kind === "decisions")
+            last.items.push(item);
+        else
+            blocks.push({ kind: "decisions", items: [item] });
+    };
+    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;
+        }
+        // Template examples live inside the coordinator-extensions HTML comment.
+        // Live sections sit *after* a one-line fence comment (deepblackjack).
+        if (inHtmlComment) {
+            text.push(line);
+            if (/-->/.test(line))
+                inHtmlComment = false;
+            continue;
+        }
+        if (/<!--/.test(line) && !/-->/.test(line)) {
+            inHtmlComment = true;
+            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;
+            }
+        }
+        else if (kind === "decisions") {
+            const m = /^-\s+(.+)$/.exec(line);
+            if (m) {
+                pushDecision(m[1] ?? "");
+                continue;
+            }
+        }
+        // Board table: header + alignment. PR3 classifies by header cells.
+        if (TABLE_ROW.test(line) && TABLE_ALIGN.test(lines[i + 1] ?? "")) {
+            const headerCells = splitRow(line);
+            const schema = classifyBoardHeader(headerCells);
+            let j = i + 2;
+            while (j < lines.length && TABLE_ROW.test(lines[j] ?? ""))
+                j++;
+            if (schema === "unknown") {
+                warnings.push(`unknown workstreams grammar at line ${i + 1}; expected workstreams.v1 (6-col Active Streams).`);
+                for (let k = i; k < j; k++)
+                    text.push(lines[k] ?? "");
+                i = j - 1;
+                continue;
+            }
+            const ext = Object.values(WORKSTREAMS_EXT).find((e) => e.id === schema);
+            const expected = schema === SCHEMA.workstreams
+                ? WORKSTREAMS_V1_ARITY
+                : ext
+                    ? ext.headers.length
+                    : BOARD_ARITY;
+            const rows = [];
+            for (let k = i + 2; k < j; k++) {
+                const raw = lines[k] ?? "";
+                const cells = splitRow(raw);
+                if (cells.length !== expected) {
+                    rows.push({
+                        malformed: true,
+                        verbatim: raw,
+                        issue: `board row at line ${k + 1} has ${cells.length} column(s), expected ${expected} — ` +
+                            `refused (kept verbatim, excluded from board records). Fix the row, or widen the schema ` +
+                            `deliberately. Row: ${raw}`,
+                    });
+                    continue;
+                }
+                if (ext) {
+                    rows.push({ extension: ext.key, cells, raw });
+                    continue;
+                }
+                if (schema === SCHEMA.workstreams) {
+                    const [stream = "", owner = "", branchWorktree = "", status = "", blocker = "", lastNote = ""] = cells;
+                    rows.push({
+                        id: idFor("s", stream),
+                        stream,
+                        owner,
+                        branchWorktree,
+                        status,
+                        blocker,
+                        lastNote,
+                        raw,
+                    });
+                }
+                else {
+                    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] ?? "", schema, rows });
+            i = j - 1;
+            continue;
+        }
+        text.push(line);
+    }
+    flushText();
+    return { trailingNewline, blocks, ...(warnings.length ? { warnings } : {}) };
+}
+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 if (block.kind === "decisions")
+            out.push(...block.items.map((item) => `- ${item}`));
+        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.schema === SCHEMA.workstreamsLanesV0
+        ? b.rows.filter((r) => !isMalformedRow(r) && !isWorkstreamsV1Row(r) && !isExtensionRow(r))
+        : []);
+}
+export function workstreamsV1RowsOf(doc) {
+    return doc.blocks.flatMap((b) => b.kind === "board" && b.schema === SCHEMA.workstreams
+        ? b.rows.filter((r) => isWorkstreamsV1Row(r))
+        : []);
+}
+function namedExtRow(ext, cells) {
+    const out = {};
+    ext.fields.forEach((field, i) => {
+        out[field] = cells[i] ?? "";
+    });
+    return out;
+}
+export function workstreamsExtensionsOf(doc) {
+    const out = {
+        openPrs: [],
+        cutoverGates: [],
+        needsDavid: [],
+        risks: [],
+        rooms: [],
+        decisions: [],
+    };
+    for (const b of doc.blocks) {
+        if (b.kind === "decisions") {
+            out.decisions.push(...b.items);
+            continue;
+        }
+        if (b.kind !== "board" || !b.schema)
+            continue;
+        const ext = Object.values(WORKSTREAMS_EXT).find((e) => e.id === b.schema);
+        if (!ext)
+            continue;
+        for (const r of b.rows) {
+            if (isMalformedRow(r) || !isExtensionRow(r))
+                continue;
+            out[ext.key].push(namedExtRow(ext, r.cells));
+        }
+    }
+    return out;
+}
+export function listWorkBoardOf(doc) {
+    const out = [];
+    for (const r of workstreamsV1RowsOf(doc)) {
+        out.push({
+            schema: SCHEMA.workstreams,
+            id: r.id,
+            stream: r.stream,
+            owner: r.owner,
+            branchWorktree: r.branchWorktree,
+            status: r.status,
+            blocker: r.blocker,
+            lastNote: r.lastNote,
+        });
+    }
+    for (const r of boardRowsOf(doc)) {
+        out.push({
+            schema: SCHEMA.workstreamsLanesV0,
+            id: r.id,
+            lane: r.lane,
+            owner: r.owner,
+            state: r.state,
+            currentSlice: r.currentSlice,
+            nextGo: r.nextGo,
+        });
+    }
+    return out;
+}
+export function projectV1ToLanes(row) {
+    if (row.schema === SCHEMA.workstreamsLanesV0)
+        return row;
+    return {
+        schema: SCHEMA.workstreamsLanesV0,
+        id: row.id,
+        lane: row.stream,
+        owner: row.owner,
+        state: row.status,
+        currentSlice: row.lastNote,
+        nextGo: "",
+    };
+}
+// Every refused row's issue, in document order — plus unknown-grammar warnings.
+export function workDocIssues(doc) {
+    const refused = doc.blocks.flatMap((b) => b.kind === "board" ? b.rows.filter(isMalformedRow).map((r) => r.issue) : []);
+    return [...(doc.warnings ?? []), ...refused];
+}
+export const LANES_V0_WRITE_ISSUE = "workstreams.lanes-v0 is parse-only — new writes must use workstreams.v1 (6-col Active Streams)";
+/** 5-col Lanes still parses; this is the write-grammar refusal for doctor / export. */
+export function workDocLegacyWriteIssues(doc) {
+    return doc.blocks.some((b) => b.kind === "board" && b.schema === SCHEMA.workstreamsLanesV0)
+        ? [LANES_V0_WRITE_ISSUE]
+        : [];
+}
+//# sourceMappingURL=docs.js.map

package/dist/docs.js.map

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

package/dist/facts.d.ts

@@ -0,0 +1,18 @@
+export type FactEntry = {
+    id: string;
+    claim: string;
+    verified: string;
+    by: string;
+    method: string;
+};
+export declare function parseFactEntry(lines: [string, string?]): FactEntry | null;
+/** Skip ``` fences; only the `## Facts` section. */
+export declare function parseFactsDoc(source: string): {
+    entries: FactEntry[];
+    issues: string[];
+};
+export declare function renderFactEntry(entry: FactEntry): string;
+/** Returns the new file string. Does not write disk. Twin of set-fact.mjs. */
+export declare function upsertFact(source: string, entry: Omit<FactEntry, "verified"> & {
+    verified?: string;
+}): string;

package/dist/facts.js

@@ -0,0 +1,95 @@
+import { EM_DASH_SEP, MIDDOT_SEP } from "./glyphs.js";
+import { FACT_STALE_DAYS } from "./schema.js";
+const ENTRY_RE = /^- `([^`]+)` — /;
+const META_RE = /^ {2}verified: (\d{4}-\d{2}-\d{2}T\d{2}:\d{2}Z) · by: (\S+) · method: (.+)$/;
+const KEBAB = /^[a-z0-9][a-z0-9-]*$/;
+export function parseFactEntry(lines) {
+    const m = lines[0]?.match(ENTRY_RE);
+    if (!m)
+        return null;
+    const meta = (lines[1] || "").match(META_RE);
+    if (!meta)
+        return null;
+    return {
+        id: m[1] ?? "",
+        claim: lines[0].slice(m[0].length),
+        verified: meta[1] ?? "",
+        by: meta[2] ?? "",
+        method: meta[3] ?? "",
+    };
+}
+function daysSinceIsoDate(iso) {
+    const m = iso.match(/^(\d{4})-(\d{2})-(\d{2})/);
+    if (!m)
+        return 0;
+    const then = new Date(+m[1], +m[2] - 1, +m[3]).getTime();
+    return Math.floor((Date.now() - then) / 86400000);
+}
+/** Skip ``` fences; only the `## Facts` section. */
+export function parseFactsDoc(source) {
+    const lines = source.split("\n");
+    const entries = [];
+    const issues = [];
+    const ids = new Set();
+    let inSection = false;
+    let inFence = false;
+    for (let i = 0; i < lines.length; i++) {
+        if (/^```/.test(lines[i] ?? ""))
+            inFence = !inFence;
+        if (/^## /.test(lines[i] ?? ""))
+            inSection = /^## Facts\s*$/.test(lines[i] ?? "");
+        if (!inSection || inFence)
+            continue;
+        const m = (lines[i] ?? "").match(ENTRY_RE);
+        if (!m)
+            continue;
+        const id = m[1] ?? "";
+        if (!KEBAB.test(id))
+            issues.push(`FACTS: \`${id}\` — id is not kebab-case`);
+        if (ids.has(id))
+            issues.push(`FACTS: \`${id}\` — duplicate id (one writer per fact; replace, don't append)`);
+        ids.add(id);
+        const parsed = parseFactEntry([lines[i] ?? "", lines[i + 1]]);
+        if (!parsed) {
+            issues.push(`FACTS: \`${id}\` — missing/malformed \`verified: … · by: … · method: …\` line`);
+            continue;
+        }
+        entries.push(parsed);
+        const days = daysSinceIsoDate(parsed.verified);
+        if (days > FACT_STALE_DAYS)
+            issues.push(`FACTS: \`${id}\` — verified ${days} days ago (> ${FACT_STALE_DAYS}) — re-verify or delete`);
+    }
+    return { entries, issues };
+}
+export function renderFactEntry(entry) {
+    return (`- \`${entry.id}\`${EM_DASH_SEP}${entry.claim}\n` +
+        `  verified: ${entry.verified}${MIDDOT_SEP}by: ${entry.by}${MIDDOT_SEP}method: ${entry.method}`);
+}
+/** Returns the new file string. Does not write disk. Twin of set-fact.mjs. */
+export function upsertFact(source, entry) {
+    const ts = entry.verified ?? new Date().toISOString().slice(0, 16) + "Z";
+    const block = `- \`${entry.id}\`${EM_DASH_SEP}${entry.claim}\n  verified: ${ts}${MIDDOT_SEP}by: ${entry.by}${MIDDOT_SEP}method: ${entry.method}`;
+    const lines = source.split("\n");
+    const entryRe = new RegExp(`^- \`${entry.id}\` — `);
+    const start = lines.findIndex((l) => entryRe.test(l));
+    if (start >= 0) {
+        const hasMeta = /^ {2}verified:/.test(lines[start + 1] || "");
+        lines.splice(start, hasMeta ? 2 : 1, ...block.split("\n"));
+        return lines.join("\n");
+    }
+    const facts = lines.findIndex((l) => /^## Facts\s*$/.test(l));
+    if (facts < 0)
+        throw new Error("no `## Facts` section in FACTS.md — file is malformed");
+    let end = lines.length;
+    for (let i = facts + 1; i < lines.length; i++) {
+        if (/^## /.test(lines[i] ?? "")) {
+            end = i;
+            break;
+        }
+    }
+    while (end > facts + 1 && (lines[end - 1] ?? "").trim() === "")
+        end--;
+    lines.splice(end, 0, "", ...block.split("\n"));
+    return lines.join("\n");
+}
+//# sourceMappingURL=facts.js.map

package/dist/facts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facts.js","sourceRoot":"","sources":["../src/facts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAU9C,MAAM,QAAQ,GAAG,iBAAiB,CAAC;AACnC,MAAM,OAAO,GACX,6EAA6E,CAAC;AAChF,MAAM,KAAK,GAAG,sBAAsB,CAAC;AAErC,MAAM,UAAU,cAAc,CAAC,KAAwB;IACrD,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;QACd,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAClC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;QACvB,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;QACjB,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW;IACnC,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAChD,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACzD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;AACpD,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAAE,OAAO,GAAG,CAAC,OAAO,CAAC;QACpD,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAAE,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAClF,IAAI,CAAC,SAAS,IAAI,OAAO;YAAE,SAAS;QACpC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,2BAA2B,CAAC,CAAC;QAC5E,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,gEAAgE,CAAC,CAAC;QAC9F,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACZ,MAAM,MAAM,GAAG,cAAc,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CACT,YAAY,EAAE,iEAAiE,CAChF,CAAC;YACF,SAAS;QACX,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,IAAI,GAAG,eAAe;YACxB,MAAM,CAAC,IAAI,CACT,YAAY,EAAE,iBAAiB,IAAI,gBAAgB,eAAe,yBAAyB,CAC5F,CAAC;IACN,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAgB;IAC9C,OAAO,CACL,OAAO,KAAK,CAAC,EAAE,KAAK,WAAW,GAAG,KAAK,CAAC,KAAK,IAAI;QACjD,eAAe,KAAK,CAAC,QAAQ,GAAG,UAAU,OAAO,KAAK,CAAC,EAAE,GAAG,UAAU,WAAW,KAAK,CAAC,MAAM,EAAE,CAChG,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CACxB,MAAc,EACd,KAA0D;IAE1D,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;IACzE,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,EAAE,KAAK,WAAW,GAAG,KAAK,CAAC,KAAK,iBAAiB,EAAE,GAAG,UAAU,OAAO,KAAK,CAAC,EAAE,GAAG,UAAU,WAAW,KAAK,CAAC,MAAM,EAAE,CAAC;IACjJ,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9D,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,IAAI,KAAK,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IACxF,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,KAAK,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAChC,GAAG,GAAG,CAAC,CAAC;YACR,MAAM;QACR,CAAC;IACH,CAAC;IACD,OAAO,GAAG,GAAG,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,GAAG,EAAE,CAAC;IACtE,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/glyphs.d.ts

@@ -0,0 +1,3 @@
+/** Pinned. A source-file normalization must not turn these into ASCII. */
+export declare const EM_DASH_SEP = " \u2014 ";
+export declare const MIDDOT_SEP = " \u00B7 ";

package/dist/glyphs.js

@@ -0,0 +1,4 @@
+/** Pinned. A source-file normalization must not turn these into ASCII. */
+export const EM_DASH_SEP = " \u2014 "; // " — "
+export const MIDDOT_SEP = " \u00b7 "; // " · "
+//# sourceMappingURL=glyphs.js.map

package/dist/glyphs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glyphs.js","sourceRoot":"","sources":["../src/glyphs.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,QAAQ;AAC/C,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,QAAQ"}

package/dist/ids.d.ts

@@ -0,0 +1,2 @@
+/** Internal. Not a public export — work.ts never exported it. */
+export declare function idFor(kind: string, seed: string): string;

package/dist/ids.js

@@ -0,0 +1,6 @@
+import { createHash } from "node:crypto";
+/** Internal. Not a public export — work.ts never exported it. */
+export function idFor(kind, seed) {
+    return `${kind}-${createHash("sha1").update(seed).digest("hex").slice(0, 8)}`;
+}
+//# sourceMappingURL=ids.js.map

package/dist/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,iEAAiE;AACjE,MAAM,UAAU,KAAK,CAAC,IAAY,EAAE,IAAY;IAC9C,OAAO,GAAG,IAAI,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAChF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./docs.js";
+export * from "./glyphs.js";
+export * from "./schema.js";
+export * from "./facts.js";
+export * from "./protocol/index.js";
+export * from "./skills-mirror.js";

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from "./docs.js";
+export * from "./glyphs.js";
+export * from "./schema.js";
+export * from "./facts.js";
+export * from "./protocol/index.js";
+export * from "./skills-mirror.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/protocol/index.d.ts

@@ -0,0 +1,4 @@
+export type { Citation, MessageRecordType, DecisionPayload, VerdictPayload, SummaryPayload, SummaryRecordType, MessageRecord, } from "./records.js";
+export { isDecision } from "./records.js";
+export { PREFIX, DECISION_PREFIX } from "./prefixes.js";
+export { renderRecord } from "./render.js";

package/dist/protocol/index.js

@@ -0,0 +1,4 @@
+export { isDecision } from "./records.js";
+export { PREFIX, DECISION_PREFIX } from "./prefixes.js";
+export { renderRecord } from "./render.js";
+//# sourceMappingURL=index.js.map

package/dist/protocol/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/protocol/prefixes.d.ts

@@ -0,0 +1,2 @@
+export declare const PREFIX: Record<string, string>;
+export declare const DECISION_PREFIX = "DAVID_DECISION";

package/dist/protocol/prefixes.js

@@ -0,0 +1,12 @@
+export const PREFIX = {
+    blocker: "BLOCKER",
+    risk: "RISK",
+    done: "DONE",
+    fyi: "FYI",
+    action: "AGENT_ACTION",
+    go: "GO",
+    scope: "SCOPE CHANGE",
+    verdict: "VERDICT",
+};
+export const DECISION_PREFIX = "DAVID_DECISION";
+//# sourceMappingURL=prefixes.js.map

package/dist/protocol/prefixes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefixes.js","sourceRoot":"","sources":["../../src/protocol/prefixes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAA2B;IAC5C,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,cAAc;IACtB,EAAE,EAAE,IAAI;IACR,KAAK,EAAE,cAAc;IACrB,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,CAAC"}

package/dist/protocol/records.d.ts

@@ -0,0 +1,45 @@
+export type Citation = {
+    kind: "pr" | "file" | "commit" | "url";
+    ref: string;
+};
+export type MessageRecordType = "blocker" | "decision" | "risk" | "done" | "fyi" | "action" | "go" | "scope" | "verdict";
+export type DecisionPayload = {
+    title: string;
+    context: string;
+    options: string[];
+    recommendation: string;
+    ifNoAction: string;
+};
+export type VerdictPayload = {
+    result: "pass" | "fail";
+    headRefOid: string;
+    notes?: string;
+};
+export type SummaryPayload = {
+    summary: string;
+};
+export type SummaryRecordType = "blocker" | "risk" | "fyi" | "action" | "go" | "scope";
+export type MessageRecord = {
+    type: "decision";
+    payload?: DecisionPayload;
+    cites?: Citation[];
+} | {
+    type: "verdict";
+    payload?: VerdictPayload;
+    cites?: Citation[];
+} | {
+    type: "done";
+    payload?: SummaryPayload;
+    cites?: Citation[];
+} | {
+    type: SummaryRecordType;
+    payload?: SummaryPayload;
+    cites?: Citation[];
+};
+/** Monotone: can only GRANT long retention, never remove it. */
+export declare function isDecision(e: {
+    kind?: string;
+    record?: {
+        type?: string;
+    };
+} | null | undefined): boolean;

package/dist/protocol/records.js

@@ -0,0 +1,5 @@
+/** Monotone: can only GRANT long retention, never remove it. */
+export function isDecision(e) {
+    return e?.kind === "decision" || e?.record?.type === "decision";
+}
+//# sourceMappingURL=records.js.map

package/dist/protocol/records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.js","sourceRoot":"","sources":["../../src/protocol/records.ts"],"names":[],"mappings":"AA+BA,gEAAgE;AAChE,MAAM,UAAU,UAAU,CACxB,CAAmE;IAEnE,OAAO,CAAC,EAAE,IAAI,KAAK,UAAU,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,KAAK,UAAU,CAAC;AAClE,CAAC"}

package/dist/protocol/render.d.ts

@@ -0,0 +1,2 @@
+import type { MessageRecord } from "./records.js";
+export declare function renderRecord(record: MessageRecord): string | null;

package/dist/protocol/render.js

@@ -0,0 +1,49 @@
+import { DECISION_PREFIX, PREFIX } from "./prefixes.js";
+function isNonEmpty(v) {
+    return typeof v === "string" && v.trim().length > 0;
+}
+function renderDecision(p) {
+    if (!isNonEmpty(p.title) || !isNonEmpty(p.context))
+        return null;
+    if (!isNonEmpty(p.recommendation) || !isNonEmpty(p.ifNoAction))
+        return null;
+    if (!Array.isArray(p.options) || p.options.length === 0)
+        return null;
+    if (!p.options.every(isNonEmpty))
+        return null;
+    return [
+        `${DECISION_PREFIX}: ${p.title}`,
+        `Context: ${p.context}`,
+        "Options:",
+        ...p.options.map((o, i) => `${i + 1}. ${o}`),
+        `Recommendation: ${p.recommendation}`,
+        `If no action: ${p.ifNoAction}`,
+    ].join("\n");
+}
+function renderVerdict(p) {
+    if (p.result !== "pass" && p.result !== "fail")
+        return null;
+    if (!isNonEmpty(p.headRefOid))
+        return null;
+    const head = `${PREFIX.verdict}: ${p.result.toUpperCase()} ${p.headRefOid}`;
+    return isNonEmpty(p.notes) ? `${head} — ${p.notes}` : head;
+}
+export function renderRecord(record) {
+    if (!record || typeof record.type !== "string")
+        return null;
+    const payload = record.payload;
+    if (payload === undefined || payload === null)
+        return null;
+    if (typeof payload !== "object" || Array.isArray(payload))
+        return null;
+    if (record.type === "decision")
+        return renderDecision(payload);
+    if (record.type === "verdict")
+        return renderVerdict(payload);
+    const prefix = PREFIX[record.type];
+    if (!prefix)
+        return null;
+    const { summary } = payload;
+    return isNonEmpty(summary) ? `${prefix}: ${summary}` : null;
+}
+//# sourceMappingURL=render.js.map

package/dist/protocol/render.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,48 @@
+export declare const SCHEMA: {
+    readonly queue: "queue.v1";
+    readonly done: "done.v1";
+    readonly facts: "facts.v1";
+    readonly workstreams: "workstreams.v1";
+    readonly workstreamsLanesV0: "workstreams.lanes-v0";
+};
+export type SchemaId = (typeof SCHEMA)[keyof typeof SCHEMA];
+export declare const FACT_STALE_DAYS = 14;
+export declare const WORKSTREAMS_V1_ARITY = 6;
+export declare const WORKSTREAMS_V1_HEADERS: readonly ["Stream", "Owner / Agent", "Branch · Worktree", "Status", "Blocker", "Last note"];
+export declare const LANES_V0_ARITY = 5;
+export declare const LANES_V0_HEADERS: readonly ["Lane", "Owner", "State", "Current slice", "Next GO"];
+/** Coordinator-only write region under the WORKSTREAMS fence. Header-cell detected. */
+export declare const WORKSTREAMS_EXT: {
+    readonly openPrs: {
+        readonly id: "workstreams.ext.open-prs";
+        readonly key: "openPrs";
+        readonly headers: readonly ["Repo", "PR", "Owner", "Status", "Merge Gate"];
+        readonly fields: readonly ["repo", "pr", "owner", "status", "mergeGate"];
+    };
+    readonly cutoverGates: {
+        readonly id: "workstreams.ext.cutover-gates";
+        readonly key: "cutoverGates";
+        readonly headers: readonly ["Gate", "Owner", "State", "Notes"];
+        readonly fields: readonly ["gate", "owner", "state", "notes"];
+    };
+    readonly needsDavid: {
+        readonly id: "workstreams.ext.needs-david";
+        readonly key: "needsDavid";
+        readonly headers: readonly ["Decision", "Context", "Recommendation"];
+        readonly fields: readonly ["decision", "context", "recommendation"];
+    };
+    readonly risks: {
+        readonly id: "workstreams.ext.risks";
+        readonly key: "risks";
+        readonly headers: readonly ["Risk", "Impact", "Mitigation"];
+        readonly fields: readonly ["risk", "impact", "mitigation"];
+    };
+    readonly rooms: {
+        readonly id: "workstreams.ext.rooms";
+        readonly key: "rooms";
+        readonly headers: readonly ["Room", "Purpose", "Owner", "State"];
+        readonly fields: readonly ["room", "purpose", "owner", "state"];
+    };
+};
+export type WorkstreamsExtKey = keyof typeof WORKSTREAMS_EXT;
+export type WorkstreamsExtId = (typeof WORKSTREAMS_EXT)[WorkstreamsExtKey]["id"];

package/dist/schema.js

@@ -0,0 +1,53 @@
+export const SCHEMA = {
+    queue: "queue.v1",
+    done: "done.v1",
+    facts: "facts.v1",
+    workstreams: "workstreams.v1",
+    workstreamsLanesV0: "workstreams.lanes-v0",
+};
+export const FACT_STALE_DAYS = 14;
+export const WORKSTREAMS_V1_ARITY = 6;
+export const WORKSTREAMS_V1_HEADERS = [
+    "Stream",
+    "Owner / Agent",
+    "Branch · Worktree",
+    "Status",
+    "Blocker",
+    "Last note",
+];
+export const LANES_V0_ARITY = 5;
+export const LANES_V0_HEADERS = ["Lane", "Owner", "State", "Current slice", "Next GO"];
+/** Coordinator-only write region under the WORKSTREAMS fence. Header-cell detected. */
+export const WORKSTREAMS_EXT = {
+    openPrs: {
+        id: "workstreams.ext.open-prs",
+        key: "openPrs",
+        headers: ["Repo", "PR", "Owner", "Status", "Merge Gate"],
+        fields: ["repo", "pr", "owner", "status", "mergeGate"],
+    },
+    cutoverGates: {
+        id: "workstreams.ext.cutover-gates",
+        key: "cutoverGates",
+        headers: ["Gate", "Owner", "State", "Notes"],
+        fields: ["gate", "owner", "state", "notes"],
+    },
+    needsDavid: {
+        id: "workstreams.ext.needs-david",
+        key: "needsDavid",
+        headers: ["Decision", "Context", "Recommendation"],
+        fields: ["decision", "context", "recommendation"],
+    },
+    risks: {
+        id: "workstreams.ext.risks",
+        key: "risks",
+        headers: ["Risk", "Impact", "Mitigation"],
+        fields: ["risk", "impact", "mitigation"],
+    },
+    rooms: {
+        id: "workstreams.ext.rooms",
+        key: "rooms",
+        headers: ["Room", "Purpose", "Owner", "State"],
+        fields: ["room", "purpose", "owner", "state"],
+    },
+};
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,gBAAgB;IAC7B,kBAAkB,EAAE,sBAAsB;CAClC,CAAC;AAGX,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAElC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,QAAQ;IACR,eAAe;IACf,mBAAmB;IACnB,QAAQ;IACR,SAAS;IACT,WAAW;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,CAAU,CAAC;AAEhG,uFAAuF;AACvF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE;QACP,EAAE,EAAE,0BAA0B;QAC9B,GAAG,EAAE,SAAS;QACd,OAAO,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAC;QACxD,MAAM,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC;KACvD;IACD,YAAY,EAAE;QACZ,EAAE,EAAE,+BAA+B;QACnC,GAAG,EAAE,cAAc;QACnB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;QAC5C,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;KAC5C;IACD,UAAU,EAAE;QACV,EAAE,EAAE,6BAA6B;QACjC,GAAG,EAAE,YAAY;QACjB,OAAO,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,gBAAgB,CAAC;QAClD,MAAM,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,gBAAgB,CAAC;KAClD;IACD,KAAK,EAAE;QACL,EAAE,EAAE,uBAAuB;QAC3B,GAAG,EAAE,OAAO;QACZ,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC;QACzC,MAAM,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC;KACzC;IACD,KAAK,EAAE;QACL,EAAE,EAAE,uBAAuB;QAC3B,GAAG,EAAE,OAAO;QACZ,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC;QAC9C,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC;KAC9C;CACO,CAAC"}

package/dist/skills-mirror.d.ts

@@ -0,0 +1,13 @@
+export type SkillFront = {
+    name: string;
+    data: Record<string, string>;
+    body: string;
+};
+export declare function parseFrontmatter(raw: string): {
+    data: Record<string, string>;
+    body: string;
+};
+export declare function deArgument(body: string): string;
+export declare function isReadOnly(skill: SkillFront): boolean;
+export declare function toCursor(skill: SkillFront): string;
+export declare function toVscode(skill: SkillFront): string;

package/dist/skills-mirror.js

@@ -0,0 +1,48 @@
+const READ_ONLY_TOOLS = new Set(["read", "glob", "grep"]);
+export function parseFrontmatter(raw) {
+    const m = raw.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+    if (!m)
+        return { data: {}, body: raw };
+    const data = {};
+    for (const line of (m[1] ?? "").split("\n")) {
+        const kv = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+        if (kv)
+            data[kv[1] ?? ""] = (kv[2] ?? "").replace(/^["']|["']$/g, "").trim();
+    }
+    return { data, body: m[2] ?? "" };
+}
+export function deArgument(body) {
+    return body
+        .replace(/:\s*\$ARGUMENTS\s*$/gm, ": (the input you provide)")
+        .replace(/\$ARGUMENTS/g, "the input you provide");
+}
+export function isReadOnly(skill) {
+    const tools = skill.data["allowed-tools"];
+    if (!tools)
+        return false;
+    const list = tools
+        .split(",")
+        .map((t) => t.trim().toLowerCase())
+        .filter(Boolean);
+    return list.length > 0 && list.every((t) => READ_ONLY_TOOLS.has(t));
+}
+const GENERATED_NOTE = "<!-- GENERATED from .claude/skills/<name>/SKILL.md by `groundwork`. Do not edit by hand. -->";
+export function toCursor(skill) {
+    return `${GENERATED_NOTE.replace("<name>", skill.name)}\n\n${deArgument(skill.body).trim()}\n`;
+}
+export function toVscode(skill) {
+    const mode = isReadOnly(skill) ? "ask" : "edit";
+    const desc = (skill.data.description || skill.name).replace(/"/g, "'");
+    return [
+        "---",
+        `mode: ${mode}`,
+        `description: ${desc}`,
+        "---",
+        "",
+        GENERATED_NOTE.replace("<name>", skill.name),
+        "",
+        deArgument(skill.body).trim(),
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=skills-mirror.js.map

package/dist/skills-mirror.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-mirror.js","sourceRoot":"","sources":["../src/skills-mirror.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAI1D,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAC1D,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IACvC,MAAM,IAAI,GAA2B,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QACpD,IAAI,EAAE;YAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/E,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI;SACR,OAAO,CAAC,uBAAuB,EAAE,2BAA2B,CAAC;SAC7D,OAAO,CAAC,cAAc,EAAE,uBAAuB,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAiB;IAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,IAAI,GAAG,KAAK;SACf,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;SAClC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,cAAc,GAClB,8FAA8F,CAAC;AAEjG,MAAM,UAAU,QAAQ,CAAC,KAAiB;IACxC,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAiB;IACxC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAChD,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvE,OAAO;QACL,KAAK;QACL,SAAS,IAAI,EAAE;QACf,gBAAgB,IAAI,EAAE;QACtB,KAAK;QACL,EAAE;QACF,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC;QAC5C,EAAE;QACF,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;QAC7B,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@davidbalzan/groundwork-seam",
+  "version": "0.1.0",
+  "description": "Schema owner of QUEUE / DONE / WORKSTREAMS / FACTS plus protocol record types.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./docs": {
+      "types": "./dist/docs.d.ts",
+      "import": "./dist/docs.js"
+    },
+    "./protocol": {
+      "types": "./dist/protocol/index.d.ts",
+      "import": "./dist/protocol/index.js"
+    },
+    "./skills-mirror": {
+      "types": "./dist/skills-mirror.d.ts",
+      "import": "./dist/skills-mirror.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^26.2.0",
+    "typescript": "^7.0.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node --test test/*.test.mjs"
+  }
+}