@corenel/harness 0.5.0 → 0.5.1

package/dist/api/backend.d.ts

@@ -12,6 +12,27 @@ export interface BackendConfig {
     /** Injected so a test needs no network; defaults to the ambient fetch. */
     fetch?: typeof fetch;
 }
+/**
+ * What the probe found -- INCLUDING whether it got an answer at all.
+ *
+ * An empty capability list has two completely different meanings, and reading
+ * them as one is what hid a probe asking the wrong path for as long as the
+ * feature existed: a backend that ANSWERS without `sessions` is a normal thing
+ * to be pointed at (prompd's gateway only runs models), while a 404, a timeout
+ * or an HTML error page means the question was never answered. The first is
+ * settled; the second is a URL to check. `url` is carried so whoever reports it
+ * can name what was asked.
+ */
+export interface ProbeOutcome {
+    /** The URL the probe asked. */
+    url: string;
+    /** True only when the backend replied with JSON we could read. */
+    answered: boolean;
+    /** What it said it can do. Empty and `answered` is a real "no". */
+    capabilities: readonly string[];
+    /** Why it did not answer. Absent when it did. */
+    reason?: string;
+}
 export interface Backend {
     readonly baseUrl: string;
     readonly client: CorenelApiClient;
@@ -21,6 +42,9 @@ export interface Backend {
     supports(capability: string): boolean;
     /** Ask the backend what it is. Safe to call more than once. */
     probe(): Promise<readonly string[]>;
+    /** The same question, with whether it was answered at all. Prefer this
+     * anywhere the result is REPORTED to a person. */
+    probeDetail(): Promise<ProbeOutcome>;
 }
 /**
  * Point at a backend, or at none.

package/dist/api/backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../api/backend.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,gBAAgB,EAAqB,MAAM,UAAU,CAAC;AAE/D;;eAEe;AACf,eAAO,MAAM,YAAY,aAAa,CAAC;AACvC,eAAO,MAAM,SAAS,UAAU,CAAC;AACjC,eAAO,MAAM,aAAa,cAAc,CAAC;AAEzC,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IACrC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC;4CACwC;IACxC,YAAY,IAAI,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IACtC,+DAA+D;IAC/D,KAAK,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;CACrC;AAuDD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,GAAG,IAAI,CAG1E;AAED,sEAAsE;AACtE,wBAAgB,OAAO,IAAI,OAAO,GAAG,IAAI,CAExC;AAED;;6BAE6B;AAC7B,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE3D"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../api/backend.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,gBAAgB,EAAqB,MAAM,UAAU,CAAC;AAE/D;;eAEe;AACf,eAAO,MAAM,YAAY,aAAa,CAAC;AACvC,eAAO,MAAM,SAAS,UAAU,CAAC;AACjC,eAAO,MAAM,aAAa,cAAc,CAAC;AAEzC,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IACrC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,QAAQ,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC;4CACwC;IACxC,YAAY,IAAI,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IACtC,+DAA+D;IAC/D,KAAK,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IACpC;sDACkD;IAClD,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;CACtC;AA+ED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,GAAG,IAAI,CAG1E;AAED,sEAAsE;AACtE,wBAAgB,OAAO,IAAI,OAAO,GAAG,IAAI,CAExC;AAED;;6BAE6B;AAC7B,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE3D"}

package/dist/api/backend.js

@@ -75,32 +75,56 @@ class RemoteBackend {
         return this.caps.includes(capability);
     }
     probe() {
+        return this.probeDetail().then((r) => r.capabilities);
+    }
+    probeDetail() {
         if (this.probed)
             return this.probed;
+        const url = `${this.baseUrl}/meta`;
         this.probed = (async () => {
             try {
                 // Unauthenticated on purpose: "what are you" must be answerable before a
                 // credential is sorted out, or a signed-out machine could never discover
                 // that signing in would be worth it.
-                const res = await this.fetchImpl(`${this.baseUrl}/meta`);
+                const res = await this.fetchImpl(url);
+                // A 404 here is the classic wrong-path failure, and an API's 404 is an
+                // HTML page -- so it is a question nobody answered, not a capability
+                // list of zero.
                 if (!res.ok)
-                    return [];
-                const body = await res.json();
+                    return { url, answered: false, capabilities: [], reason: `HTTP ${res.status}` };
+                let body;
+                try {
+                    body = await res.json();
+                }
+                catch {
+                    // 200 with an HTML page is what a proxy or a CDN returns. Reading that
+                    // as "holds no sessions" is the reassuring-direction failure.
+                    return { url, answered: false, capabilities: [], reason: 'the reply was not JSON' };
+                }
                 this.caps = Array.isArray(body.capabilities)
                     ? body.capabilities.filter((c) => typeof c === 'string')
                     : [];
-                return this.caps;
+                return { url, answered: true, capabilities: this.caps };
             }
-            catch {
-                // Unreachable, not JSON, or not a corenel backend at all. All of them
-                // mean the same thing: do not use it for anything.
+            catch (err) {
+                // Unreachable, aborted, DNS, TLS. None of them is an answer.
                 this.caps = [];
-                return this.caps;
+                return { url, answered: false, capabilities: [], reason: reasonOf(err) };
             }
         })();
         return this.probed;
     }
 }
+/** A one-line cause for a probe that never landed. Deliberately terse: it goes
+ * into a startup banner next to the URL, where the URL is the actionable half. */
+function reasonOf(err) {
+    if (err instanceof Error) {
+        if (err.name === 'AbortError' || err.name === 'TimeoutError')
+            return 'no reply (timed out)';
+        return err.message || 'unreachable';
+    }
+    return 'unreachable';
+}
 let current = null;
 /**
  * Point at a backend, or at none.

package/dist/api/backend.js.map

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

package/dist/rooms/findings.d.ts

@@ -0,0 +1,134 @@
+/** The findings file, beside SESSION.jsonl in the room's own directory. */
+export declare const FINDINGS_FILE = "FINDINGS.jsonl";
+export declare const FINDING_KIND: "finding";
+/** Per-finding length cap, in characters. The same number as `MAX_ROOM_BRIEF`
+ * on purpose: a finding is a decision stated once, at about the length a room's
+ * whole purpose takes to state. */
+export declare const MAX_FINDING_TEXT = 500;
+/** How many ACTIVE findings a room may hold at once.
+ *
+ * This is a per-turn cost multiplier, not a storage limit: the document is
+ * rendered into every participant's system prompt on every turn, so its size is
+ * paid once per turn per participant for the rest of the room. 16 x 500 chars
+ * is ~8K characters, roughly 2K tokens -- the same order as the transcript
+ * overhead a room already carries, and comfortably under what would start
+ * crowding out the conversation itself. It is also about the point past which a
+ * findings list stops being a document a person reads and becomes a log they
+ * skim: a room with seventeen live decisions has not converged.
+ *
+ * At the cap, recording is REFUSED (out loud, naming the cap) rather than
+ * silently dropping the oldest: a room that quietly loses its first decision to
+ * make room for its seventeenth is worse than one told to tidy up. Revising and
+ * withdrawing still work at the cap, so the room can always make space. */
+export declare const MAX_ROOM_FINDINGS = 16;
+export type FindingLine = {
+    k: typeof FINDING_KIND;
+    op: 'record';
+    id: string;
+    at: number;
+    by: string;
+    text: string;
+} | {
+    k: typeof FINDING_KIND;
+    op: 'revise';
+    id: string;
+    at: number;
+    by: string;
+    text: string;
+} | {
+    k: typeof FINDING_KIND;
+    op: 'withdraw';
+    id: string;
+    at: number;
+    by: string;
+    reason: string;
+};
+export interface Finding {
+    id: string;
+    text: string;
+    /** The participant id that first recorded it. */
+    by: string;
+    at: number;
+    /** Who last revised it, and when. Null for a finding nobody has corrected. */
+    revisedBy: string | null;
+    revisedAt: number | null;
+    /** Set once the room retired this finding. Kept rather than deleted: the
+     * document should be able to say what the room stopped believing. */
+    withdrawn: {
+        by: string;
+        at: number;
+        reason: string;
+    } | null;
+}
+/** One edit a participant (agent or human) asks for. Deliberately id-based for
+ * `revise`/`withdraw`: a positional edit would mean something different by the
+ * time it was applied. */
+export type FindingEdit = {
+    kind: 'record';
+    text: string;
+} | {
+    kind: 'revise';
+    id: string;
+    text: string;
+} | {
+    kind: 'withdraw';
+    id: string;
+    reason: string;
+};
+export declare function encodeFindingLine(line: FindingLine): string;
+/** Apply one line to a folded document. Exported because the engine applies a
+ * turn's edits one at a time and must plan each against the document as the
+ * PREVIOUS edit left it -- otherwise two records in one turn mint the same id. */
+export declare function applyFindingLine(doc: readonly Finding[], line: FindingLine): Finding[];
+/** Fold a FINDINGS.jsonl text into the document. Degrades, never throws: one
+ * malformed line must not take the whole document with it, and a line of any
+ * other kind (a file that ever ends up sharing this one) is simply not ours. */
+export declare function foldFindings(text: string): Finding[];
+/** The findings that still stand. What participants are shown, and what the cap
+ * counts -- a withdrawn finding costs nothing per turn and should not keep the
+ * room from recording a new one. */
+export declare function activeFindings(doc: readonly Finding[]): Finding[];
+/**
+ * Turn one requested edit into the line that would record it, or say why not.
+ *
+ * The ONE place an edit is validated, so the agent's tool, the human's facade
+ * call and the engine's apply step cannot drift into three different ideas of
+ * what a legal finding is. Pure: it writes nothing and mutates nothing.
+ */
+export declare function planFindingEdit(doc: readonly Finding[], edit: FindingEdit, by: string, at: number): {
+    ok: true;
+    line: FindingLine;
+} | {
+    ok: false;
+    problem: string;
+};
+/**
+ * Plan a WHOLE turn's worth of edits against one document, in order.
+ *
+ * Sequential and cumulative: each edit is planned against the document as the
+ * previous one left it, which is the only way two `record` calls in one turn
+ * can mint two different ids -- and the only way an edit that depends on an
+ * earlier one in the same turn (withdraw, then record in its place) can be
+ * judged against reality. A refused edit is SKIPPED with its reason collected,
+ * never fatal: one bad edit must not throw away the good ones beside it.
+ *
+ * Used by the participant's tool (to answer "what id will this get, and would
+ * it even be allowed") and by the engine (to actually write the lines), so the
+ * two can never disagree about what a turn's edits mean.
+ */
+export declare function planFindingEdits(doc: readonly Finding[], edits: readonly FindingEdit[], by: string, at: number): {
+    lines: FindingLine[];
+    doc: Finding[];
+    problems: string[];
+};
+/**
+ * The findings as a participant reads them, ids included so a revision or a
+ * withdrawal can name one.
+ *
+ * Active only. A withdrawn finding is still in the file (and still on screen,
+ * marked, for the person in the room) but must never be rendered here: a
+ * participant shown a retired decision alongside the live ones has no way to
+ * tell them apart and will build on the wrong one.
+ */
+export declare function renderFindings(doc: readonly Finding[]): string;
+//# sourceMappingURL=findings.d.ts.map

package/dist/rooms/findings.d.ts.map

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

package/dist/rooms/findings.js

@@ -0,0 +1,262 @@
+/* The room's living findings document.
+ *
+ * WHAT IT IS. A room's conclusions, recorded AS the room reaches them rather
+ * than recalled once at the end. A record written when a thing is agreed is
+ * accurate; an end-of-room synthesis is a lossy re-reading of prose, and it
+ * fails exactly when the room most needs it (a close that depends on a model
+ * call is a close that can fail).
+ *
+ * WHERE IT LIVES. Beside the transcript, at
+ * `<roomsRoot>/<roomId>/FINDINGS.jsonl` -- the same directory as SESSION.jsonl,
+ * never in the project tree. A room's conclusions belong to the room, not to
+ * whatever workspace happened to be open while it ran.
+ *
+ * WHY A LOG OF EDITS AND NOT A DOCUMENT BLOB. Two participants recording in the
+ * same room must not clobber each other. A whole-document overwrite makes that
+ * the default failure: the later writer's text replaces the earlier writer's,
+ * silently and completely. So the file is an append-only log of per-finding
+ * OPS -- `record`, `revise`, `withdraw` -- each naming ONE finding by id, and
+ * the document is the fold of them. Two participants recording concurrently
+ * append two independent `record` lines and the document holds both. The worst
+ * a genuine collision can do is two revisions of the SAME finding, where the
+ * later one wins and the earlier one is still in the log, which is the failure
+ * mode of a version history rather than of a lost write.
+ *
+ * WHY IT CAN SHRINK. A document that can only grow is a log, not a document.
+ * `revise` corrects a finding in place (the previous wording stays in the log);
+ * `withdraw` retires one with a stated reason, and a withdrawn finding is
+ * marked, never erased -- a reader of the file can still see what the room
+ * believed and when it stopped believing it. Only ACTIVE findings are rendered
+ * to participants, so a withdrawn decision is never re-read as current.
+ *
+ * WHO WRITES IT. Nothing here writes anything: this module is pure. The room
+ * engine is the single writer of a room's files, exactly as it is of
+ * SESSION.jsonl (see turn.ts) -- a participant's tool records its INTENT into
+ * `ctx.runState` and the engine applies it after the turn.
+ */
+/** The findings file, beside SESSION.jsonl in the room's own directory. */
+export const FINDINGS_FILE = 'FINDINGS.jsonl';
+export const FINDING_KIND = 'finding';
+/** Per-finding length cap, in characters. The same number as `MAX_ROOM_BRIEF`
+ * on purpose: a finding is a decision stated once, at about the length a room's
+ * whole purpose takes to state. */
+export const MAX_FINDING_TEXT = 500;
+/** How many ACTIVE findings a room may hold at once.
+ *
+ * This is a per-turn cost multiplier, not a storage limit: the document is
+ * rendered into every participant's system prompt on every turn, so its size is
+ * paid once per turn per participant for the rest of the room. 16 x 500 chars
+ * is ~8K characters, roughly 2K tokens -- the same order as the transcript
+ * overhead a room already carries, and comfortably under what would start
+ * crowding out the conversation itself. It is also about the point past which a
+ * findings list stops being a document a person reads and becomes a log they
+ * skim: a room with seventeen live decisions has not converged.
+ *
+ * At the cap, recording is REFUSED (out loud, naming the cap) rather than
+ * silently dropping the oldest: a room that quietly loses its first decision to
+ * make room for its seventeenth is worse than one told to tidy up. Revising and
+ * withdrawing still work at the cap, so the room can always make space. */
+export const MAX_ROOM_FINDINGS = 16;
+export function encodeFindingLine(line) {
+    return JSON.stringify(line) + '\n';
+}
+function str(v) { return typeof v === 'string' ? v.trim() : ''; }
+/** Apply one line to a folded document. Exported because the engine applies a
+ * turn's edits one at a time and must plan each against the document as the
+ * PREVIOUS edit left it -- otherwise two records in one turn mint the same id. */
+export function applyFindingLine(doc, line) {
+    if (line.op === 'record') {
+        if (doc.some((f) => f.id === line.id))
+            return [...doc];
+        return [...doc, {
+                id: line.id, text: line.text, by: line.by, at: line.at,
+                revisedBy: null, revisedAt: null, withdrawn: null,
+            }];
+    }
+    // A revision or a withdrawal of an id nothing recorded describes nothing:
+    // dropped, exactly as `foldRoom` drops a line written before its open.
+    const found = doc.find((f) => f.id === line.id);
+    if (!found)
+        return [...doc];
+    return doc.map((f) => {
+        if (f.id !== line.id)
+            return f;
+        if (line.op === 'revise')
+            return { ...f, text: line.text, revisedBy: line.by, revisedAt: line.at };
+        return { ...f, withdrawn: { by: line.by, at: line.at, reason: line.reason } };
+    });
+}
+function parseFindingLine(raw) {
+    const s = raw.trim();
+    if (!s)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(s);
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== 'object')
+        return null;
+    const o = parsed;
+    if (o.k !== FINDING_KIND)
+        return null;
+    const id = str(o.id);
+    const by = str(o.by);
+    const at = typeof o.at === 'number' && Number.isFinite(o.at) ? o.at : null;
+    if (!id || !by || at === null)
+        return null;
+    if (o.op === 'record' || o.op === 'revise') {
+        const text = str(o.text);
+        if (!text)
+            return null;
+        return { k: FINDING_KIND, op: o.op, id, at, by, text };
+    }
+    if (o.op === 'withdraw') {
+        const reason = str(o.reason);
+        if (!reason)
+            return null;
+        return { k: FINDING_KIND, op: 'withdraw', id, at, by, reason };
+    }
+    return null;
+}
+/** Fold a FINDINGS.jsonl text into the document. Degrades, never throws: one
+ * malformed line must not take the whole document with it, and a line of any
+ * other kind (a file that ever ends up sharing this one) is simply not ours. */
+export function foldFindings(text) {
+    let doc = [];
+    for (const raw of text.split('\n')) {
+        const line = parseFindingLine(raw);
+        if (line)
+            doc = applyFindingLine(doc, line);
+    }
+    return doc;
+}
+/** The findings that still stand. What participants are shown, and what the cap
+ * counts -- a withdrawn finding costs nothing per turn and should not keep the
+ * room from recording a new one. */
+export function activeFindings(doc) {
+    return doc.filter((f) => f.withdrawn === null);
+}
+/** The next id, never reusing one a withdrawn finding held: an id that comes
+ * back meaning something else makes the log unreadable. */
+function nextFindingId(doc) {
+    let max = 0;
+    for (const f of doc) {
+        const n = /^f(\d+)$/.exec(f.id);
+        if (n)
+            max = Math.max(max, Number(n[1]));
+    }
+    return `f${max + 1}`;
+}
+function idList(doc) {
+    const active = activeFindings(doc).map((f) => f.id);
+    return active.length ? active.join(', ') : '(none)';
+}
+/**
+ * Turn one requested edit into the line that would record it, or say why not.
+ *
+ * The ONE place an edit is validated, so the agent's tool, the human's facade
+ * call and the engine's apply step cannot drift into three different ideas of
+ * what a legal finding is. Pure: it writes nothing and mutates nothing.
+ */
+export function planFindingEdit(doc, edit, by, at) {
+    const author = str(by);
+    if (!author)
+        return { ok: false, problem: 'A finding must record who found it.' };
+    if (edit.kind === 'record') {
+        const text = str(edit.text);
+        if (!text)
+            return { ok: false, problem: 'A finding cannot be empty -- say what the room decided.' };
+        if (text.length > MAX_FINDING_TEXT) {
+            return {
+                ok: false,
+                problem: `That finding is ${text.length} characters; the maximum is ${MAX_FINDING_TEXT}. `
+                    + 'State the decision, not the discussion that reached it.',
+            };
+        }
+        if (activeFindings(doc).length >= MAX_ROOM_FINDINGS) {
+            return {
+                ok: false,
+                problem: `This room already holds the maximum of ${MAX_ROOM_FINDINGS} findings. `
+                    + 'Revise one that is now wrong, or withdraw one that no longer holds, and record this in its place.',
+            };
+        }
+        return { ok: true, line: { k: FINDING_KIND, op: 'record', id: nextFindingId(doc), at, by: author, text } };
+    }
+    const id = str(edit.id);
+    const found = doc.find((f) => f.id === id);
+    if (!found) {
+        return { ok: false, problem: `There is no finding "${id}" in this room. The findings are: ${idList(doc)}.` };
+    }
+    if (found.withdrawn) {
+        return {
+            ok: false,
+            problem: `Finding ${id} was withdrawn (${found.withdrawn.reason}) and cannot be changed. `
+                + 'Record a new finding instead.',
+        };
+    }
+    if (edit.kind === 'revise') {
+        const text = str(edit.text);
+        if (!text)
+            return { ok: false, problem: 'A revision cannot be empty -- withdraw the finding instead.' };
+        if (text.length > MAX_FINDING_TEXT) {
+            return {
+                ok: false,
+                problem: `That revision is ${text.length} characters; the maximum is ${MAX_FINDING_TEXT}.`,
+            };
+        }
+        return { ok: true, line: { k: FINDING_KIND, op: 'revise', id, at, by: author, text } };
+    }
+    const reason = str(edit.reason);
+    if (!reason) {
+        return { ok: false, problem: 'Withdrawing a finding needs a reason -- a decision that vanishes without one cannot be reviewed later.' };
+    }
+    return { ok: true, line: { k: FINDING_KIND, op: 'withdraw', id, at, by: author, reason } };
+}
+/**
+ * Plan a WHOLE turn's worth of edits against one document, in order.
+ *
+ * Sequential and cumulative: each edit is planned against the document as the
+ * previous one left it, which is the only way two `record` calls in one turn
+ * can mint two different ids -- and the only way an edit that depends on an
+ * earlier one in the same turn (withdraw, then record in its place) can be
+ * judged against reality. A refused edit is SKIPPED with its reason collected,
+ * never fatal: one bad edit must not throw away the good ones beside it.
+ *
+ * Used by the participant's tool (to answer "what id will this get, and would
+ * it even be allowed") and by the engine (to actually write the lines), so the
+ * two can never disagree about what a turn's edits mean.
+ */
+export function planFindingEdits(doc, edits, by, at) {
+    let next = [...doc];
+    const lines = [];
+    const problems = [];
+    for (const edit of edits) {
+        const planned = planFindingEdit(next, edit, by, at);
+        if (!planned.ok) {
+            problems.push(planned.problem);
+            continue;
+        }
+        lines.push(planned.line);
+        next = applyFindingLine(next, planned.line);
+    }
+    return { lines, doc: next, problems };
+}
+/**
+ * The findings as a participant reads them, ids included so a revision or a
+ * withdrawal can name one.
+ *
+ * Active only. A withdrawn finding is still in the file (and still on screen,
+ * marked, for the person in the room) but must never be rendered here: a
+ * participant shown a retired decision alongside the live ones has no way to
+ * tell them apart and will build on the wrong one.
+ */
+export function renderFindings(doc) {
+    const active = activeFindings(doc);
+    if (!active.length)
+        return 'Nothing has been recorded in this room yet.';
+    return active.map((f) => `${f.id} (${f.revisedBy ?? f.by}): ${f.text}`).join('\n');
+}
+//# sourceMappingURL=findings.js.map

package/dist/rooms/findings.js.map

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