wicked-crew 0.7.40 → 0.7.45

package/dist/api/chat-citations.js

@@ -0,0 +1,528 @@
+/**
+ * Chat citation verification (crew#561, F-RC1-117 — Wave 1 criterion 2).
+ *
+ * # The defect
+ *
+ * A chat seat answers with citations — repo-relative paths, `path:line` refs, `path:symbol` refs
+ * and commit SHAs — and the daemon relays that text UNTOUCHED. On the RC1 Phase 6 re-run the
+ * opencode seat answered "summarize the last 10 commits across all 9 repos" with 26 SHAs, of which
+ * **2 did not exist in any repo**, and three line refs were off by a few lines. Every citation
+ * rendered as plain text, so a reader could not tell a real SHA from an invented one — and these
+ * are exactly the tokens a reader pastes into `git show`, a PR or a commit message.
+ *
+ * The daemon is the ONE place that can tell: it already knows the chat's read roots (the scope it
+ * handed the seats), and `stat` + `git cat-file -e` are cheap. So it verifies, and says what it
+ * found — it never edits the seat's text. Mark, don't rewrite.
+ *
+ * # What is verified
+ *
+ * | kind     | citation                          | check |
+ * |----------|-----------------------------------|-------|
+ * | `path`   | `crew/src/api/routes.ts`          | the file exists under a read root |
+ * | `line`   | `routes.ts:2264`, `x.ts:80-90`    | the file exists AND has that many lines; when a symbol is named right before the ref, that the symbol is ON that line — otherwise the line it IS on, as a CORRECTION |
+ * | `symbol` | `execute_wrapped.rs:build_worker_command` | the file exists AND contains the symbol |
+ * | `sha`    | `6d77153`, 7–40 hex               | `git rev-parse --verify --quiet <sha>^{commit}` in the repo the text names, else in any read root |
+ *
+ * # Why a false positive is worse than a miss
+ *
+ * Prose looks like a path (`e.g`, `something.this`) and words look like SHAs. Flagging prose
+ * UNVERIFIED would train the reader to ignore the marks, which is worse than not marking. So:
+ *
+ *  - a bare `name.ext` token with no directory and no `:line`/`:symbol` suffix that resolves
+ *    nowhere is DROPPED, not marked — it was probably never a citation;
+ *  - a hex run with no digit or no `a-f` letter is not a SHA candidate (`effaced` is a word; the
+ *    price is that an all-digit short SHA — ~4% of 7-char prefixes — is not checked);
+ *  - a token WITH a separator or a `:line`/`:symbol` suffix IS a citation: unresolvable means
+ *    `unverified`, because that shape is not prose.
+ *
+ * # Bounded, and never in the reply's way
+ *
+ * The pass runs AFTER the `chatReply` frame is broadcast (`server.ts`), so a reply is never delayed
+ * by verification, and it is bounded twice: at most {@link DEFAULT_MAX_ITEMS} citations and
+ * {@link DEFAULT_BUDGET_MS} of wall clock. Whatever the budget did not reach is reported
+ * `unchecked` — a state of its own, never silently "verified".
+ *
+ * The verdicts ride `/ws` as ONE `chatCitations` frame per reply, stamped with the same `turn_id`
+ * the reply carries, and the studio marks the reply from it (badge + counter). The text on the wire
+ * and in the transcript is the seat's own.
+ */
+import { readFileSync, statSync } from 'node:fs';
+import { isAbsolute, join, relative, resolve } from 'node:path';
+import { execCapped } from '../core/exec.js';
+/** At most this many citations are checked per reply; the rest are `unchecked`. */
+export const DEFAULT_MAX_ITEMS = 80;
+/**
+ * Wall-clock budget for one reply's pass, ms. Overrun ⇒ the remainder is `unchecked`.
+ *
+ * 15 s, not 3: the pass runs entirely off the reply's path (nothing waits on it but the marks
+ * appearing a moment later), and the number worth protecting is COVERAGE, not latency. The RC1
+ * Phase 6 answer cited 26 SHAs over 9 repos — a fabricated one sweeps every root — and on a loaded
+ * desktop a `git cat-file` spawn is not always instant, so a 3 s budget would have reported most of
+ * that answer `unchecked`, which reads like the feature is not working. The budget exists so the
+ * work is BOUNDED, not so it is fast; it is re-read between citations AND between roots.
+ */
+export const DEFAULT_BUDGET_MS = 15_000;
+/** Per-git-call timeout, ms. Generous on purpose: a spawn on a loaded desktop is not instant, and
+ *  a timeout is an ERROR (`unchecked`), never an "absent" — the whole pass is bounded anyway. */
+const GIT_TIMEOUT_MS = 10_000;
+/** A file bigger than this is not read for a line/symbol check (it is a citation, not a corpus). */
+const MAX_READ_BYTES = 4 * 1024 * 1024;
+/** How far back a `line` citation looks for the symbol the sentence names. */
+const SYMBOL_CONTEXT_CHARS = 200;
+// ── Extraction ───────────────────────────────────────────────────────────────
+/**
+ * A file-ish token with an optional `:line`, `:line-line` or `:symbol` suffix.
+ *
+ * The filename must carry an extension of 2–10 lowercase alphanumerics starting with a letter:
+ * that is what keeps `e.g`, `0.7.33` and a sentence's `end.Next` out (one char, digits first,
+ * uppercase respectively) while admitting `.ts`, `.rs`, `.md`, `.json`, `.tsx`, `.yml`.
+ */
+const PATH_RE = /(?<![\w/.:-])((?:[\w.-]+\/)*[\w-]+\.[a-z][a-z0-9]{1,9})(?::(\d+(?:-\d+)?|[A-Za-z_]\w*))?(?![\w-])/g;
+/** A 7–40 hex run that is a whole token (never part of a path, a version or a colour). */
+const SHA_RE = /(?<![\w/.:#-])([0-9a-f]{7,40})(?![\w-])/g;
+/**
+ * The symbol a line ref is introduced by: the last backticked IDENTIFIER that sits within ~40
+ * characters of glue before the ref (`` `acceptancePhaseIds` is `acceptance.ts:80` ``). Deliberately
+ * tight — a symbol from further back in the sentence would "correct" the next ref to the wrong line,
+ * which is a fabricated correction of its own.
+ */
+const TRAILING_SYMBOL_RE = /`([A-Za-z_]\w{2,})`([^`]{0,40})$/;
+/** The text before a citation, with the ref's own opening backtick removed. */
+function symbolNamedBefore(text, at) {
+    const before = text.slice(Math.max(0, at - SYMBOL_CONTEXT_CHARS), at).replace(/`$/, '');
+    return TRAILING_SYMBOL_RE.exec(before)?.[1];
+}
+/** Prose that looks like a file but is not: extension-shaped words we never treat as citations. */
+const PATH_STOPWORDS = new Set(['e.g', 'i.e', 'vs.']);
+/** `wicked-crew` is cited as `crew` as often as by its name: every alias a reply may use. */
+export function repoAliases(root) {
+    const out = new Set([root.name]);
+    if (root.name.startsWith('wicked-'))
+        out.add(root.name.slice('wicked-'.length));
+    const base = root.absRoot.split(/[\\/]/).filter((s) => s.length > 0).pop();
+    if (base !== undefined && base.length > 0) {
+        out.add(base);
+        if (base.startsWith('wicked-'))
+            out.add(base.slice('wicked-'.length));
+    }
+    return [...out].filter((a) => a.length >= 3).sort((a, b) => b.length - a.length);
+}
+/** The repo name the text names closest before `at`, when any (`crew \`6d77153\`` → `crew`). */
+function repoNamedBefore(text, at, roots) {
+    const before = text.slice(Math.max(0, at - SYMBOL_CONTEXT_CHARS), at).toLowerCase();
+    let best;
+    for (const root of roots) {
+        for (const alias of repoAliases(root)) {
+            const index = before.lastIndexOf(alias.toLowerCase());
+            if (index < 0)
+                continue;
+            if (best === undefined || index > best.index)
+                best = { name: root.name, index };
+        }
+    }
+    return best?.name;
+}
+/**
+ * Every citation in a reply, in text order, deduplicated by (kind, raw).
+ *
+ * Pure: no filesystem, no git. `roots` is read only for the repo aliases a SHA's sentence may name.
+ */
+export function extractCitations(text, roots) {
+    const seen = new Set();
+    const out = [];
+    const push = (c) => {
+        const key = `${c.kind}\u0000${c.raw}`;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        out.push(c);
+    };
+    for (const m of text.matchAll(PATH_RE)) {
+        const path = m[1];
+        const suffix = m[2];
+        if (PATH_STOPWORDS.has(path))
+            continue;
+        const raw = m[0];
+        if (suffix === undefined) {
+            push({ raw, kind: 'path', path });
+            continue;
+        }
+        if (/^\d/.test(suffix)) {
+            const line = Number.parseInt(suffix.split('-')[0], 10);
+            const symbol = symbolNamedBefore(text, m.index);
+            push({ raw, kind: 'line', path, line, ...(symbol !== undefined ? { symbol } : {}) });
+            continue;
+        }
+        push({ raw, kind: 'symbol', path, symbol: suffix });
+    }
+    for (const m of text.matchAll(SHA_RE)) {
+        const sha = m[1];
+        // A word, a date or a number is not a SHA: a real one carries both a digit and an a-f letter.
+        if (!/\d/.test(sha) || !/[a-f]/.test(sha))
+            continue;
+        const repo = repoNamedBefore(text, m.index, roots);
+        push({ raw: sha, kind: 'sha', ...(repo !== undefined ? { repo } : {}) });
+    }
+    return out.sort((a, b) => text.indexOf(a.raw) - text.indexOf(b.raw));
+}
+// ── Verification ─────────────────────────────────────────────────────────────
+/** The default deps: the real filesystem and the real git. */
+export function chatCitationDeps() {
+    return {
+        fileExists(abs) {
+            try {
+                return statSync(abs).isFile();
+            }
+            catch {
+                return false;
+            }
+        },
+        readLines(abs) {
+            try {
+                const st = statSync(abs);
+                if (!st.isFile() || st.size > MAX_READ_BYTES)
+                    return null;
+                return readFileSync(abs, 'utf8').split('\n');
+            }
+            catch {
+                return null;
+            }
+        },
+        async listFiles(absRoot) {
+            try {
+                const { stdout } = await execCapped('git', ['-C', absRoot, 'ls-files'], {
+                    timeout: GIT_TIMEOUT_MS,
+                    windowsHide: true,
+                });
+                return stdout.split('\n').filter((l) => l.length > 0);
+            }
+            catch {
+                // A listing that FAILED is not an empty repo (see {@link CommitCheck} for the same rule).
+                return null;
+            }
+        },
+        async commitExists(absRoot, sha) {
+            try {
+                // `rev-parse --verify --quiet`, not `cat-file -e`: cat-file exits 128 ("Not a valid object
+                // name") for a commit that is simply absent, which is indistinguishable from 128 for "not a
+                // git repository". rev-parse separates them — 0 present, 1 absent, 128 the repo/tool is
+                // wrong — and that separation is the whole point (see {@link CommitCheck}).
+                await execCapped('git', ['-C', absRoot, 'rev-parse', '--verify', '--quiet', `${sha}^{commit}`], {
+                    timeout: GIT_TIMEOUT_MS,
+                    windowsHide: true,
+                });
+                return 'present';
+            }
+            catch (err) {
+                // EXIT 1 is git's own "this repo has no such commit" — the only answer that means absent. A
+                // timeout (`killed`, no numeric code), a missing git, or 128 (not a repository) is an ERROR.
+                return err.code === 1 ? 'absent' : 'error';
+            }
+        },
+        now: () => Date.now(),
+    };
+}
+/**
+ * Resolve a cited path against the read roots. Two spellings, in order:
+ *  1. `<repo name>/<rest>` — the shape crew#618's rewrite produces;
+ *  2. `<rest>` relative to each root — a reply that dropped the repo prefix.
+ * A bare `name.ext` (no separator) falls through to the basename index instead.
+ *
+ * There is no absolute-path arm, because there can be no absolute citation to resolve: the pass
+ * runs on the crew#618-REWRITTEN reply, where every host path under a read root is already
+ * repo-relative — and a host path outside every read root is unverifiable by construction.
+ */
+function under(root, rest) {
+    const abs = resolve(join(root.absRoot, rest));
+    // INSIDE the root, by path boundary — not by string prefix. A cited `alpha/../alpha-secrets/x.ts`
+    // resolves to a SIBLING directory whose name merely starts with the root's ("/r/alpha-secrets"
+    // vs "/r/alpha"), which a `startsWith` admits; the chat's read roots are the scope, so a citation
+    // that leaves them is not resolvable here at all (independent review of #722, HIGH).
+    const rel = relative(root.absRoot, abs);
+    if (rel === '' || rel.startsWith('..') || isAbsolute(rel))
+        return undefined;
+    return { abs, root };
+}
+function resolvePath(path, roots) {
+    const slash = path.indexOf('/');
+    if (slash > 0) {
+        const head = path.slice(0, slash);
+        const rest = path.slice(slash + 1);
+        for (const root of roots) {
+            if (repoAliases(root).includes(head)) {
+                const at = under(root, rest);
+                if (at !== undefined)
+                    return at;
+            }
+        }
+    }
+    for (const root of roots) {
+        const at = under(root, path);
+        if (at !== undefined)
+            return at;
+    }
+    return undefined;
+}
+/** A word-boundary hit for `symbol`, 1-based; `0` when the file does not contain it. */
+function lineOfSymbol(lines, symbol) {
+    const re = new RegExp(`\\b${symbol.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\b`);
+    for (let i = 0; i < lines.length; i++) {
+        if (re.test(lines[i]))
+            return i + 1;
+    }
+    return 0;
+}
+/**
+ * Verify every citation in a reply, bounded. Never throws: a broken root, an unreadable file or a
+ * git that is not there is a verdict (`unverified` / `unchecked`), not an error.
+ */
+export async function verifyCitations(text, roots, deps = chatCitationDeps(), opts = {}) {
+    const maxItems = opts.maxItems ?? DEFAULT_MAX_ITEMS;
+    const budgetMs = opts.budgetMs ?? DEFAULT_BUDGET_MS;
+    const started = deps.now();
+    const candidates = extractCitations(text, roots);
+    const items = [];
+    /** Basename → repo-relative paths, per root; built ONCE and only if a bare name needs it. */
+    let basenames;
+    /** A root whose listing failed: a bare name that is "in no repo" may simply be in that one. */
+    let indexPartial = false;
+    const indexBasenames = async () => {
+        if (basenames !== undefined)
+            return basenames;
+        const index = new Map();
+        for (const root of roots) {
+            const listed = await deps.listFiles(root.absRoot);
+            if (listed === null) {
+                indexPartial = true;
+                continue;
+            }
+            for (const rel of listed) {
+                const base = rel.split('/').pop();
+                if (base === undefined)
+                    continue;
+                const hits = index.get(base);
+                const entry = { abs: join(root.absRoot, rel), root };
+                if (hits === undefined)
+                    index.set(base, [entry]);
+                else
+                    hits.push(entry);
+            }
+        }
+        basenames = index;
+        return index;
+    };
+    /** The file a path/line/symbol citation names, or how it failed. */
+    const locate = async (c) => {
+        const path = c.path;
+        const direct = resolvePath(path, roots);
+        if (direct !== undefined && deps.fileExists(direct.abs))
+            return { at: direct };
+        if (!path.includes('/')) {
+            // `git ls-files` lists what is TRACKED, which is not the same as what is on disk: a file
+            // deleted from the working tree is still listed, and reporting it `verified` would be exactly
+            // the kind of false confirmation this pass exists to stop (independent review of #722).
+            const hits = ((await indexBasenames()).get(path) ?? []).filter((h) => deps.fileExists(h.abs));
+            if (hits.length === 1)
+                return { at: hits[0] };
+            if (hits.length > 1)
+                return { miss: 'ambiguous' };
+            // A repo the daemon could not LIST cannot be said to lack the file.
+            if (indexPartial)
+                return { miss: 'unknown' };
+            // A bare name that is in no repo and carries no line/symbol suffix was probably prose.
+            return { miss: c.kind === 'path' ? 'prose' : 'none' };
+        }
+        return { miss: 'none' };
+    };
+    for (const c of candidates) {
+        if (items.length >= maxItems || deps.now() - started > budgetMs) {
+            items.push({
+                raw: c.raw,
+                kind: c.kind,
+                status: 'unchecked',
+                note: 'the verification budget for this reply ran out before this citation',
+            });
+            continue;
+        }
+        if (c.kind === 'sha') {
+            const named = c.repo !== undefined ? roots.find((r) => r.name === c.repo) : undefined;
+            const inNamed = named !== undefined ? await deps.commitExists(named.absRoot, c.raw) : 'absent';
+            if (inNamed === 'present') {
+                items.push({ raw: c.raw, kind: 'sha', status: 'verified', resolved: named.name });
+                continue;
+            }
+            let elsewhere;
+            // The budget is re-read BETWEEN roots, not only between citations: one fabricated SHA over
+            // nine roots is nine git calls, and a slow root must not let one citation outlast the whole
+            // reply's budget (independent review of #722). A sweep that did not FINISH — budget gone, or
+            // a repo the check errored on — says `unchecked`: "in no repo" is a claim it did not earn.
+            let swept = inNamed !== 'error';
+            for (const root of roots) {
+                if (root === named)
+                    continue;
+                if (deps.now() - started > budgetMs) {
+                    swept = false;
+                    break;
+                }
+                const found = await deps.commitExists(root.absRoot, c.raw);
+                if (found === 'present') {
+                    elsewhere = root;
+                    break;
+                }
+                if (found === 'error')
+                    swept = false;
+            }
+            if (elsewhere === undefined && !swept) {
+                items.push({
+                    raw: c.raw,
+                    kind: 'sha',
+                    status: 'unchecked',
+                    note: "this chat's repositories could not all be checked for that commit",
+                });
+                continue;
+            }
+            if (elsewhere === undefined) {
+                items.push({
+                    raw: c.raw,
+                    kind: 'sha',
+                    status: 'unverified',
+                    note: named !== undefined
+                        ? `no such commit in ${named.name} — or in any other repo in this chat's scope`
+                        : "no such commit in any repo in this chat's scope",
+                });
+            }
+            else if (named === undefined) {
+                items.push({ raw: c.raw, kind: 'sha', status: 'verified', resolved: elsewhere.name });
+            }
+            else {
+                items.push({
+                    raw: c.raw,
+                    kind: 'sha',
+                    status: 'corrected',
+                    resolved: elsewhere.name,
+                    note: `the commit is in ${elsewhere.name}, not ${named.name}`,
+                });
+            }
+            continue;
+        }
+        const found = await locate(c);
+        if ('miss' in found) {
+            if (found.miss === 'prose')
+                continue; // never a mark on prose
+            if (found.miss === 'unknown') {
+                items.push({
+                    raw: c.raw,
+                    kind: c.kind,
+                    status: 'unchecked',
+                    note: "a repository in this chat's scope could not be listed, so this file was not looked for",
+                });
+                continue;
+            }
+            items.push({
+                raw: c.raw,
+                kind: c.kind,
+                status: 'unverified',
+                note: found.miss === 'ambiguous'
+                    ? "several repos in this chat's scope have a file with that name — the citation does not say which"
+                    : "no such file in this chat's scope",
+            });
+            continue;
+        }
+        const at = found.at;
+        if (c.kind === 'path') {
+            items.push({ raw: c.raw, kind: 'path', status: 'verified', resolved: `${at.root.name}` });
+            continue;
+        }
+        const lines = deps.readLines(at.abs);
+        if (lines === null) {
+            items.push({
+                raw: c.raw,
+                kind: c.kind,
+                status: 'unchecked',
+                note: 'the file is there, but could not be read to check the reference',
+            });
+            continue;
+        }
+        if (c.kind === 'symbol') {
+            const line = lineOfSymbol(lines, c.symbol);
+            if (line > 0)
+                items.push({ raw: c.raw, kind: 'symbol', status: 'verified', resolved: `${c.path}:${line}` });
+            else
+                items.push({
+                    raw: c.raw,
+                    kind: 'symbol',
+                    status: 'unverified',
+                    note: `${at.root.name} has the file, but it does not contain ${c.symbol}`,
+                });
+            continue;
+        }
+        // kind === 'line'
+        const line = c.line;
+        if (line < 1 || line > lines.length) {
+            items.push({
+                raw: c.raw,
+                kind: 'line',
+                status: 'unverified',
+                note: `the file has ${lines.length} lines`,
+            });
+            continue;
+        }
+        if (c.symbol === undefined) {
+            items.push({ raw: c.raw, kind: 'line', status: 'verified' });
+            continue;
+        }
+        const cited = lines[line - 1];
+        const re = new RegExp(`\\b${c.symbol.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\b`);
+        if (re.test(cited)) {
+            items.push({ raw: c.raw, kind: 'line', status: 'verified' });
+            continue;
+        }
+        const actual = lineOfSymbol(lines, c.symbol);
+        if (actual > 0) {
+            const corrected = c.raw.replace(/:\d+(?:-\d+)?$/, `:${actual}`);
+            items.push({
+                raw: c.raw,
+                kind: 'line',
+                status: 'corrected',
+                resolved: corrected,
+                note: `${c.symbol} is on line ${actual}, not ${line}`,
+            });
+        }
+        else {
+            items.push({
+                raw: c.raw,
+                kind: 'line',
+                status: 'unverified',
+                note: `line ${line} does not mention ${c.symbol}, and the file does not either`,
+            });
+        }
+    }
+    return {
+        verified: items.filter((i) => i.status === 'verified').length,
+        unverifiable: items.filter((i) => i.status === 'unverified').length,
+        corrected: items.filter((i) => i.status === 'corrected').length,
+        unchecked: items.filter((i) => i.status === 'unchecked').length,
+        items,
+    };
+}
+/**
+ * The `/ws` frame for one reply's verdicts, or `null` when there is nothing to say (no citation
+ * survived extraction — a chatty reply with no references marks nothing).
+ */
+export function citationsFrame(reply, result) {
+    if (result.items.length === 0)
+        return null;
+    return {
+        type: 'chatCitations',
+        chat: reply.chat,
+        cliKey: reply.cliKey,
+        ...(reply.turn_id !== undefined ? { turn_id: reply.turn_id } : {}),
+        verified: result.verified,
+        unverifiable: result.unverifiable,
+        corrected: result.corrected,
+        unchecked: result.unchecked,
+        items: result.items,
+        ...(reply.project_id !== undefined ? { project_id: reply.project_id } : {}),
+    };
+}
+//# sourceMappingURL=chat-citations.js.map

package/dist/api/chat-citations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-citations.js","sourceRoot":"","sources":["../../src/api/chat-citations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEhE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAgD7C,mFAAmF;AACnF,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACxC;iGACiG;AACjG,MAAM,cAAc,GAAG,MAAM,CAAC;AAC9B,oGAAoG;AACpG,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AACvC,8EAA8E;AAC9E,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAuCjC,gFAAgF;AAEhF;;;;;;GAMG;AACH,MAAM,OAAO,GACX,oGAAoG,CAAC;AAEvG,0FAA0F;AAC1F,MAAM,MAAM,GAAG,0CAA0C,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,kBAAkB,GAAG,kCAAkC,CAAC;AAE9D,+EAA+E;AAC/E,SAAS,iBAAiB,CAAC,IAAY,EAAE,EAAU;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,oBAAoB,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACxF,OAAO,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,mGAAmG;AACnG,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAEtD,6FAA6F;AAC7F,MAAM,UAAU,WAAW,CAAC,IAAkB;IAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IAChF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IAC3E,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACd,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;AACnF,CAAC;AAED,gGAAgG;AAChG,SAAS,eAAe,CAAC,IAAY,EAAE,EAAU,EAAE,KAA8B;IAC/E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,oBAAoB,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACpF,IAAI,IAAiD,CAAC;IACtD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;YACtD,IAAI,KAAK,GAAG,CAAC;gBAAE,SAAS;YACxB,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK;gBAAE,IAAI,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;QAClF,CAAC;IACH,CAAC;IACD,OAAO,IAAI,EAAE,IAAI,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,KAA8B;IAC3E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,CAAC,CAAc,EAAQ,EAAE;QACpC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC;QACtC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO;QAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACd,CAAC,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACnB,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QACvC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QAClB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAClC,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;YACxD,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YAChD,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACrF,SAAS;QACX,CAAC;QACD,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QAClB,8FAA8F;QAC9F,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,SAAS;QACpD,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACnD,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,gFAAgF;AAEhF,8DAA8D;AAC9D,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,UAAU,CAAC,GAAG;YACZ,IAAI,CAAC;gBACH,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;YAChC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,SAAS,CAAC,GAAG;YACX,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;gBACzB,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,GAAG,cAAc;oBAAE,OAAO,IAAI,CAAC;gBAC1D,OAAO,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,OAAO;YACrB,IAAI,CAAC;gBACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE;oBACtE,OAAO,EAAE,cAAc;oBACvB,WAAW,EAAE,IAAI;iBAClB,CAAC,CAAC;gBACH,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACxD,CAAC;YAAC,MAAM,CAAC;gBACP,0FAA0F;gBAC1F,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,GAAG;YAC7B,IAAI,CAAC;gBACH,2FAA2F;gBAC3F,4FAA4F;gBAC5F,wFAAwF;gBACxF,4EAA4E;gBAC5E,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,GAAG,WAAW,CAAC,EAAE;oBAC9F,OAAO,EAAE,cAAc;oBACvB,WAAW,EAAE,IAAI;iBAClB,CAAC,CAAC;gBACH,OAAO,SAAS,CAAC;YACnB,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,4FAA4F;gBAC5F,6FAA6F;gBAC7F,OAAQ,GAA0B,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;YACrE,CAAC;QACH,CAAC;QACD,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;AACJ,CAAC;AAsBD;;;;;;;;;GASG;AACH,SAAS,KAAK,CAAC,IAAkB,EAAE,IAAY;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9C,kGAAkG;IAClG,+FAA+F;IAC/F,kGAAkG;IAClG,qFAAqF;IACrF,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACxC,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5E,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AACvB,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,KAA8B;IAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrC,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAC7B,IAAI,EAAE,KAAK,SAAS;oBAAE,OAAO,EAAE,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;IAClC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,wFAAwF;AACxF,SAAS,YAAY,CAAC,KAAwB,EAAE,MAAc;IAC5D,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAChF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,KAA8B,EAC9B,OAAyB,gBAAgB,EAAE,EAC3C,OAAsB,EAAE;IAExB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,iBAAiB,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,iBAAiB,CAAC;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACjD,MAAM,KAAK,GAAuB,EAAE,CAAC;IACrC,6FAA6F;IAC7F,IAAI,SAA8C,CAAC;IACnD,+FAA+F;IAC/F,IAAI,YAAY,GAAG,KAAK,CAAC;IAEzB,MAAM,cAAc,GAAG,KAAK,IAAsC,EAAE;QAClE,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;QAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,YAAY,GAAG,IAAI,CAAC;gBACpB,SAAS;YACX,CAAC;YACD,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;gBACzB,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;gBAClC,IAAI,IAAI,KAAK,SAAS;oBAAE,SAAS;gBACjC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC7B,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;gBACrD,IAAI,IAAI,KAAK,SAAS;oBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;;oBAC5C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QACD,SAAS,GAAG,KAAK,CAAC;QAClB,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,oEAAoE;IACpE,MAAM,MAAM,GAAG,KAAK,EAClB,CAAc,EACoE,EAAE;QACpF,MAAM,IAAI,GAAG,CAAC,CAAC,IAAK,CAAC;QACrB,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACxC,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;QAC/E,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,yFAAyF;YACzF,8FAA8F;YAC9F,wFAAwF;YACxF,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,cAAc,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9F,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAE,EAAE,CAAC;YAC/C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YAClD,oEAAoE;YACpE,IAAI,YAAY;gBAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YAC7C,uFAAuF;YACvF,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACxD,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,QAAQ,EAAE,CAAC;YAChE,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,MAAM,EAAE,WAAW;gBACnB,IAAI,EAAE,qEAAqE;aAC5E,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACtF,MAAM,OAAO,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC/F,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAM,CAAC,IAAI,EAAE,CAAC,CAAC;gBACnF,SAAS;YACX,CAAC;YACD,IAAI,SAAmC,CAAC;YACxC,2FAA2F;YAC3F,4FAA4F;YAC5F,6FAA6F;YAC7F,2FAA2F;YAC3F,IAAI,KAAK,GAAG,OAAO,KAAK,OAAO,CAAC;YAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,IAAI,KAAK,KAAK;oBAAE,SAAS;gBAC7B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,QAAQ,EAAE,CAAC;oBACpC,KAAK,GAAG,KAAK,CAAC;oBACd,MAAM;gBACR,CAAC;gBACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;gBAC3D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACxB,SAAS,GAAG,IAAI,CAAC;oBACjB,MAAM;gBACR,CAAC;gBACD,IAAI,KAAK,KAAK,OAAO;oBAAE,KAAK,GAAG,KAAK,CAAC;YACvC,CAAC;YACD,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC;gBACtC,KAAK,CAAC,IAAI,CAAC;oBACT,GAAG,EAAE,CAAC,CAAC,GAAG;oBACV,IAAI,EAAE,KAAK;oBACX,MAAM,EAAE,WAAW;oBACnB,IAAI,EAAE,mEAAmE;iBAC1E,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC;oBACT,GAAG,EAAE,CAAC,CAAC,GAAG;oBACV,IAAI,EAAE,KAAK;oBACX,MAAM,EAAE,YAAY;oBACpB,IAAI,EACF,KAAK,KAAK,SAAS;wBACjB,CAAC,CAAC,qBAAqB,KAAK,CAAC,IAAI,8CAA8C;wBAC/E,CAAC,CAAC,iDAAiD;iBACxD,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;YACxF,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC;oBACT,GAAG,EAAE,CAAC,CAAC,GAAG;oBACV,IAAI,EAAE,KAAK;oBACX,MAAM,EAAE,WAAW;oBACnB,QAAQ,EAAE,SAAS,CAAC,IAAI;oBACxB,IAAI,EAAE,oBAAoB,SAAS,CAAC,IAAI,SAAS,KAAK,CAAC,IAAI,EAAE;iBAC9D,CAAC,CAAC;YACL,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;YACpB,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;gBAAE,SAAS,CAAC,wBAAwB;YAC9D,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC7B,KAAK,CAAC,IAAI,CAAC;oBACT,GAAG,EAAE,CAAC,CAAC,GAAG;oBACV,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,MAAM,EAAE,WAAW;oBACnB,IAAI,EAAE,wFAAwF;iBAC/F,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,MAAM,EAAE,YAAY;gBACpB,IAAI,EACF,KAAK,CAAC,IAAI,KAAK,WAAW;oBACxB,CAAC,CAAC,iGAAiG;oBACnG,CAAC,CAAC,mCAAmC;aAC1C,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1F,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,MAAM,EAAE,WAAW;gBACnB,IAAI,EAAE,iEAAiE;aACxE,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,MAAO,CAAC,CAAC;YAC5C,IAAI,IAAI,GAAG,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;;gBAE1G,KAAK,CAAC,IAAI,CAAC;oBACT,GAAG,EAAE,CAAC,CAAC,GAAG;oBACV,IAAI,EAAE,QAAQ;oBACd,MAAM,EAAE,YAAY;oBACpB,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,0CAA0C,CAAC,CAAC,MAAO,EAAE;iBAC3E,CAAC,CAAC;YACL,SAAS;QACX,CAAC;QAED,kBAAkB;QAClB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAK,CAAC;QACrB,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,YAAY;gBACpB,IAAI,EAAE,gBAAgB,KAAK,CAAC,MAAM,QAAQ;aAC3C,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YAC7D,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAE,CAAC;QAC/B,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAClF,IAAI,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YAC7D,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,MAAM,EAAE,CAAC,CAAC;YAChE,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,WAAW;gBACnB,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,GAAG,CAAC,CAAC,MAAM,eAAe,MAAM,SAAS,IAAI,EAAE;aACtD,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC;gBACT,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,YAAY;gBACpB,IAAI,EAAE,QAAQ,IAAI,qBAAqB,CAAC,CAAC,MAAM,gCAAgC;aAChF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,MAAM;QAC7D,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,YAAY,CAAC,CAAC,MAAM;QACnE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM;QAC/D,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM;QAC/D,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,KAA8E,EAC9E,MAA2B;IAE3B,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5E,CAAC;AACJ,CAAC"}

package/dist/api/chat-transcripts.d.ts

@@ -26,7 +26,7 @@
  * Registered in `tests/fixtures/state-home-subtrees.json` as `chats` (crew half; the core half —
  * the worker Read fence — landed with core-ts 0.7.26), and named in `state-home-registry.ts`.
  */
-import type { ChatTranscriptRecord, CoreEvent } from '../core/types.js';
+import type { ChatCitationItem, ChatTranscriptRecord, CoreEvent } from '../core/types.js';
 /** The state-home entry (`<state home>/chats/`) — the name the fixture registers. */
 export declare const CHAT_TRANSCRIPTS_DIRNAME = "chats";
 /** One repo root → name mapping entry used for path rewriting (crew#618). */
@@ -79,6 +79,25 @@ export declare class ChatTranscriptStore {
      * roots registered for the chat via {@link registerRoots}.
      */
     observe(stamped: CoreEvent): void;
+    /**
+     * The citation verdicts of a reply already recorded (crew#561): appended as their OWN record,
+     * because the transcript is append-only and verification finishes AFTER the reply is stored. A
+     * reader folds it onto the `seat` record with the same `turnId` + `cliKey` — which is what keeps
+     * a fabricated SHA marked across a reload, instead of rendering as plain text again.
+     *
+     * Only a STAMPED frame is recorded: without a `turn_id` there is no reply to fold it onto (the
+     * same rule {@link observe} applies), and a straggler must never recreate a dropped file.
+     */
+    recordCitations(frame: {
+        chat: string;
+        cliKey: string;
+        turn_id?: string;
+        verified: number;
+        unverifiable: number;
+        corrected: number;
+        unchecked: number;
+        items: ChatCitationItem[];
+    }): void;
     /** Every record of the chat in append order; `[]` for a chat with no file (or a refused id). */
     read(chatId: string): ChatTranscriptRecord[];
     /**

package/dist/api/chat-transcripts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-transcripts.d.ts","sourceRoot":"","sources":["../../src/api/chat-transcripts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAa,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAInF,qFAAqF;AACrF,eAAO,MAAM,wBAAwB,UAAU,CAAC;AAEhD,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,MAAM,CAezF;AAED,8FAA8F;AAC9F,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAgBD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,8FAA8F;IAC9F,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkD;gBAEhE,IAAI,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;KAAO;IAK3D;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,IAAI;IAIvE,mEAAmE;IACnE,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,6FAA6F;IAC7F,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,MAAM;IAcd,sGAAsG;IACtG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAIxF;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI;IAqBjC,gGAAgG;IAChG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,EAAE;IAe5C;;;;;;OAMG;IACH,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS;IAazC,gFAAgF;IAChF,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAM1B;;;;OAIG;IACH,aAAa,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI;IAWzD,kGAAkG;IAClG,QAAQ,IAAI,IAAI;CAGjB"}
+{"version":3,"file":"chat-transcripts.d.ts","sourceRoot":"","sources":["../../src/api/chat-transcripts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAa,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIrG,qFAAqF;AACrF,eAAO,MAAM,wBAAwB,UAAU,CAAC;AAEhD,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,MAAM,CAezF;AAED,8FAA8F;AAC9F,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAgBD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,8FAA8F;IAC9F,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkD;gBAEhE,IAAI,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;KAAO;IAK3D;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,IAAI;IAIvE,mEAAmE;IACnE,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,6FAA6F;IAC7F,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,MAAM;IAcd,sGAAsG;IACtG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAIxF;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI;IAqBjC;;;;;;;;OAQG;IACH,eAAe,CAAC,KAAK,EAAE;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,gBAAgB,EAAE,CAAC;KAC3B,GAAG,IAAI;IAmBR,gGAAgG;IAChG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,EAAE;IAe5C;;;;;;OAMG;IACH,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS;IAazC,gFAAgF;IAChF,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAM1B;;;;OAIG;IACH,aAAa,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI;IAWzD,kGAAkG;IAClG,QAAQ,IAAI,IAAI;CAGjB"}

package/dist/api/chat-transcripts.js

@@ -150,6 +150,35 @@ export class ChatTranscriptStore {
             usage: usageOf(frame['usage']),
         });
     }
+    /**
+     * The citation verdicts of a reply already recorded (crew#561): appended as their OWN record,
+     * because the transcript is append-only and verification finishes AFTER the reply is stored. A
+     * reader folds it onto the `seat` record with the same `turnId` + `cliKey` — which is what keeps
+     * a fabricated SHA marked across a reload, instead of rendering as plain text again.
+     *
+     * Only a STAMPED frame is recorded: without a `turn_id` there is no reply to fold it onto (the
+     * same rule {@link observe} applies), and a straggler must never recreate a dropped file.
+     */
+    recordCitations(frame) {
+        if (frame.turn_id === undefined)
+            return;
+        const file = this.fileOf(frame.chat);
+        // No file ⇒ no reply was ever recorded for this chat (a reclaimed id, a refused chat id): a
+        // citations record alone would recreate a transcript that has nothing to fold onto.
+        if (file === null || !existsSync(file))
+            return;
+        this.append(frame.chat, {
+            at: this.now(),
+            turnId: frame.turn_id,
+            kind: 'citations',
+            cliKey: frame.cliKey,
+            verified: frame.verified,
+            unverifiable: frame.unverifiable,
+            corrected: frame.corrected,
+            unchecked: frame.unchecked,
+            items: frame.items,
+        });
+    }
     /** Every record of the chat in append order; `[]` for a chat with no file (or a refused id). */
     read(chatId) {
         const file = this.fileOf(chatId);