@wrenautomation/birdwatch 0.0.0-stage → 0.30.0

package/dist/engine/plans/index.js

@@ -0,0 +1,104 @@
+/**
+ * The default plan file per ask kind. A copy of one, tuned and stored beside a ledger, is how
+ * a run learns: the recipe changes, the agent reads it. `birdwatch plans <kind>` prints one to start from.
+ */
+import { PlanFile as PlanFileShape, } from "../types.js";
+/**
+ * The five sides a researcher covers before the reads start. One tree per round; the agent
+ * fills each facet with tries, in order of what it expects to work.
+ */
+export const TREE = {
+    facets: [
+        { name: "number", why: "a figure: a rate, a price, a count, a date" },
+        { name: "how", why: "how it is done: a method, a step list, a tool" },
+        { name: "who", why: "who does it or buys it, in their own words" },
+        { name: "counter", why: "the case against: what fails, who says no" },
+        {
+            name: "primary",
+            why: "the source itself: a study, a filing, a transcript, the maker's own page",
+        },
+    ],
+    thin: 3,
+};
+const web = {
+    id: "birdwatch/web",
+    kind: "web",
+    version: 6,
+    sources: ["searxng", "exa", "google"],
+    budget: { queries: 3, reads: 6, rounds: 3, checks: 3 },
+    tree: TREE,
+    age: "Prices, tools and numbers that move: prefer the last two years. A principle or a method can be old.",
+    rules: [
+        "Each facet's tries reach different kinds of source: a survey or benchmark with numbers, a trade publication or association, people in the field (forums, Reddit, reviews), a government statistic.",
+        "Put a year in a query only when fresh numbers matter.",
+        "Keep primary sources and people in the field over listicles and aggregators.",
+    ],
+};
+const video = {
+    id: "birdwatch/video",
+    kind: "video",
+    version: 6,
+    sources: ["youtube", "podcasts"],
+    budget: { queries: 3, reads: 4, rounds: 2, checks: 3 },
+    tree: TREE,
+    age: "Tools and platforms: prefer the last two years. A talk on a principle can be old.",
+    rules: [
+        "Each facet's tries reach different kinds of speaker: a practitioner who shows the work, a conference talk, an interview or podcast, a critic or reviewer.",
+        "Drop a clip under 60 seconds unless the ask is about short-form video. Videos of 5 to 60 minutes hold the most.",
+        "A channel that yielded nothing before is a reason to drop.",
+    ],
+};
+const channel = {
+    id: "birdwatch/channel",
+    kind: "channel",
+    version: 6,
+    sources: ["searxng", "youtube", "exa"],
+    budget: { queries: 3, reads: 6, rounds: 2, checks: 3 },
+    tree: TREE,
+    age: "A channel that has not posted in the last year counts for little.",
+    rules: [
+        "Each facet's tries reach different kinds of channel: a creator on video, a writer or newsletter, a podcast, a community.",
+        "Keep the channel's own page over a page about it.",
+    ],
+};
+const person = {
+    id: "birdwatch/person",
+    kind: "person",
+    version: 6,
+    sources: ["searxng", "exa", "linkedin", "google"],
+    budget: { queries: 4, reads: 6, rounds: 2, checks: 3 },
+    tree: TREE,
+    age: "What they do now: prefer the latest pages. Their history can be old.",
+    rules: [
+        "Name the person or company in each query, as the ask writes it.",
+        "Each facet's tries reach different kinds of page: their own site or profile, an interview or talk, press or reviews, a filing or directory.",
+        "Drop a page about a different person or company with the same name.",
+        "Keep what they wrote or said over what a directory copied.",
+    ],
+};
+const site = {
+    id: "birdwatch/site",
+    kind: "site",
+    version: 6,
+    sources: ["sitemap", "searxng", "fetch"],
+    budget: { queries: 4, reads: 8, rounds: 2, checks: 3 },
+    tree: TREE,
+    age: "When two pages of the site disagree, the later one counts.",
+    rules: [
+        "Each facet's tries reach different parts of the site: its product or service pages, its pricing, its blog or help, its people.",
+        "Drop a URL off the site.",
+    ],
+};
+const DEFAULTS = { web, video, channel, person, site };
+/** The default plan file for a kind, validated, as a fresh copy. */
+export function defaultPlanFile(kind) {
+    return PlanFileShape.parse(structuredClone(DEFAULTS[kind]));
+}
+/** The plan file's word on age; a stored file from before version 4 takes its kind's default. Version 5: the review no longer says "at most". Version 6: `tree`, the query tree's guide. 0.30.0 dropped the prompts with no bump: the agent never read them. */
+export const ageOf = (planFile) => planFile.age ?? DEFAULTS[planFile.kind].age;
+/** The plan file's rules for the agent; a stored file from before 0.30.0 takes its kind's default. */
+export const rulesOf = (planFile) => planFile.rules ?? DEFAULTS[planFile.kind].rules ?? [];
+/** The plan file's guide for a query tree; a stored file from before version 6 takes its kind's default. */
+export const treeOf = (planFile) => planFile.tree ?? DEFAULTS[planFile.kind].tree;
+export const PLAN_KINDS = Object.keys(DEFAULTS);
+//# sourceMappingURL=index.js.map

package/dist/engine/plans/index.js.map

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

package/dist/engine/ports.d.ts

@@ -0,0 +1,76 @@
+/**
+ * The ports each agent command is given, as one plain `deps` object. A source is one file that
+ * answers `search` (hits for a query) or `open` (a hit read whole) or both; the registry holds
+ * them by name and the plan's allow-list picks per run. The model is the bulk extract and check's, the extractor
+ * `./document`'s, the ledger `./ledger`'s. Nothing here reaches the network: the adapters in `src/sources` do.
+ */
+import type { Model } from "@wrenautomation/models";
+import type { Judge } from "@wrenautomation/models/judge";
+import type { Document, Extractor } from "../document/index.js";
+import type { Ids } from "../ledger/ids.js";
+import type { Ledger } from "../ledger/ledger.js";
+import type { CostKind, FollowAs, From, HitRecord, QueryRecord } from "../ledger/records.js";
+import type { HitViewIn } from "./types.js";
+export interface Source {
+    name: string;
+    kind: "search" | "open" | "both";
+    cost: CostKind;
+    /** Who the records it writes are from. A person pasting URLs is `human`; the default is `tool`. */
+    from?: From;
+    /** Who its records are by: the person behind a paste. The default is the source's name. */
+    by?: string;
+    /**
+     * Whether its search keeps to that site (a query's `site`). A site-scoped query skips a
+     * searcher that would answer from everywhere. Absent: it keeps to any site.
+     */
+    keeps?(site: string): boolean;
+    /** Hits as the source shows them for free. Throw on failure: the engine writes the spend. */
+    search?(query: QueryRecord): Promise<HitViewIn[]>;
+    /** Whether it lists that page's own posts (`posts`) or pages like it (`similar`). */
+    follows?(as: FollowAs, url: string): boolean;
+    /** The follow's hits, newest or closest first, `n` at most. Throw on failure, like search. */
+    follow?(as: FollowAs, url: string, n: number): Promise<HitViewIn[]>;
+    /**
+     * Whether this source opens that URL at all (a YouTube page, an http(s) page). The read step
+     * asks before a call, so a source that was never going to open it writes no spend. Absent: it
+     * opens everything.
+     */
+    opens?(url: string): boolean;
+    /**
+     * Opens only its own site's URLs, better than any general opener (a thread as data, not a
+     * fetched wall): it gets its turn before the rest, whatever the allow-list's order.
+     */
+    first?: true;
+    /**
+     * The hit read whole. Throw with the reason when it was fetched and nothing usable came back
+     * (a 403, a block, no reader for the media): the engine writes the spend `ok: false` with the
+     * reason and the next opener gets its turn.
+     */
+    open?(hit: HitRecord): Promise<Document>;
+}
+export type Sources = Map<string, Source>;
+export declare const registry: (...sources: Source[]) => Sources;
+/** The allow-list's sources, in its order. A name no source answers to fails the run at its start. */
+export declare function pick(sources: Sources, names: readonly string[]): Source[];
+export interface Deps {
+    sources: Sources;
+    ledger: Ledger;
+    /** The bulk extract and check's model; null: none, and those two commands fail. */
+    model: Model | null;
+    extractor: Extractor;
+    /** Cheap typed answers on every hit, page and finding: a hint and a router. Absent or null: none. */
+    judge?: Judge | null;
+    clock: () => Date;
+    ids: Ids;
+    /** `by` on the records the engine itself writes: this terminal's writer. */
+    writer: string;
+    /** The pause between tries of a call that failed with a Transient; `setTimeout` by default. A test passes a stub. */
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * The searchers a query goes to: all of them, or for a site-scoped query those that keep to it.
+ * A follow goes to the sources that follow its URL that way.
+ */
+export declare const searchersFor: (sources: readonly Source[], q: Pick<QueryRecord, "site" | "follow">) => Source[];
+/** How many hits a follow lists. */
+export declare const FOLLOW_N = 30;

package/dist/engine/ports.js

@@ -0,0 +1,28 @@
+/**
+ * The ports each agent command is given, as one plain `deps` object. A source is one file that
+ * answers `search` (hits for a query) or `open` (a hit read whole) or both; the registry holds
+ * them by name and the plan's allow-list picks per run. The model is the bulk extract and check's, the extractor
+ * `./document`'s, the ledger `./ledger`'s. Nothing here reaches the network: the adapters in `src/sources` do.
+ */
+export const registry = (...sources) => new Map(sources.map((s) => [s.name, s]));
+/** The allow-list's sources, in its order. A name no source answers to fails the run at its start. */
+export function pick(sources, names) {
+    const missing = names.filter((n) => !sources.has(n));
+    if (missing.length)
+        throw new Error(`no source named ${missing.join(", ")}`);
+    return names.map((n) => sources.get(n));
+}
+/**
+ * The searchers a query goes to: all of them, or for a site-scoped query those that keep to it.
+ * A follow goes to the sources that follow its URL that way.
+ */
+export const searchersFor = (sources, q) => {
+    const f = q.follow;
+    if (f)
+        return sources.filter((s) => s.follow && s.follows?.(f.as, f.url));
+    const searchers = sources.filter((s) => s.search);
+    return q.site ? searchers.filter((s) => s.keeps?.(q.site) ?? true) : searchers;
+};
+/** How many hits a follow lists. */
+export const FOLLOW_N = 30;
+//# sourceMappingURL=ports.js.map

package/dist/engine/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../src/engine/ports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkDH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAG,OAAiB,EAAW,EAAE,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAEpG,sGAAsG;AACtG,MAAM,UAAU,IAAI,CAAC,OAAgB,EAAE,KAAwB;IAC7D,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,IAAI,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7E,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAW,CAAC,CAAC;AACpD,CAAC;AAkBD;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,OAA0B,EAC1B,CAAuC,EAC7B,EAAE;IACZ,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1E,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAClD,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAc,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3F,CAAC,CAAC;AAEF,oCAAoC;AACpC,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAC"}

package/dist/engine/recall.d.ts

@@ -0,0 +1,42 @@
+/**
+ * What earlier runs proved, found again: the findings of every run in the ledger, ranked by
+ * MiniSearch (BM25 over the finding's text and quote, prefix and a little fuzz). Each carries its
+ * quote, its source's date and its run, so a later run sees how old a fact is and where it came
+ * from. A finding a call or a failed check dropped is left out. Read only: the agent decides what
+ * still holds, puts it in `known` or reads the source again (WA-934, option A).
+ */
+import { type Ledger } from "../ledger/ledger.js";
+import type { AskKind } from "./plan.js";
+export interface Recalled {
+    finding: string;
+    run: string;
+    /** The ask of the run that found it. */
+    ask: string;
+    text: string;
+    quote: string;
+    url: string;
+    /** The source's own date, when its document had one. */
+    date: string | null;
+    /** When the run found it. */
+    found: string;
+    /** Who wrote it: the agent's id for a finding it read and added, a model's id for `extract`. */
+    by: string;
+    /** `kept`: a call kept it; `open`: no call on it yet. Ranking ignores it. */
+    state: "kept" | "open";
+    /** Other runs that found the same quote on the same page, newest first. */
+    alsoIn: string[];
+    score: number;
+}
+export interface RecallOptions {
+    /** At most this many; 20 by default. */
+    n?: number;
+    /** Leave this run out: the one asking. */
+    not?: string;
+    /** Only runs of this ask kind. */
+    kind?: AskKind;
+    /** Only these runs: a child's siblings and parent. */
+    runs?: readonly string[];
+}
+/** Several ledgers read as one (a folder per day): their records merged in time order. */
+export declare const joined: (ledgers: readonly Pick<Ledger, "scan">[]) => Pick<Ledger, "scan">;
+export declare function recall(ledger: Pick<Ledger, "scan">, terms: string, o?: RecallOptions): Promise<Recalled[]>;

package/dist/engine/recall.js

@@ -0,0 +1,71 @@
+/**
+ * What earlier runs proved, found again: the findings of every run in the ledger, ranked by
+ * MiniSearch (BM25 over the finding's text and quote, prefix and a little fuzz). Each carries its
+ * quote, its source's date and its run, so a later run sees how old a fact is and where it came
+ * from. A finding a call or a failed check dropped is left out. Read only: the agent decides what
+ * still holds, puts it in `known` or reads the source again (WA-934, option A).
+ */
+import MiniSearch from "minisearch";
+import { latestCalls, ofType } from "../ledger/ledger.js";
+import { byTime } from "../ledger/records.js";
+/** Several ledgers read as one (a folder per day): their records merged in time order. */
+export const joined = (ledgers) => ({
+    scan: async (f) => (await Promise.all(ledgers.map((l) => l.scan(f)))).flat().sort(byTime),
+});
+const fold = (s) => s.replace(/\s+/g, " ").trim().toLowerCase();
+export async function recall(ledger, terms, o = {}) {
+    if (!terms.trim())
+        throw new Error("recall needs terms");
+    const records = await ledger.scan({ type: ["snapshot", "finding", "call"] });
+    const asks = new Map();
+    for (const s of ofType(records, "snapshot"))
+        if (!asks.has(s.run))
+            asks.set(s.run, { text: s.ask.text, kind: s.ask.kind });
+    const calls = latestCalls(records);
+    // Newest first, so the first of a quote seen twice is the latest proof of it.
+    const findings = ofType(records, "finding")
+        .filter((f) => f.run !== o.not && calls.get(f.id) !== "drop")
+        .filter((f) => !o.kind || asks.get(f.run)?.kind === o.kind)
+        .filter((f) => !o.runs || o.runs.includes(f.run))
+        .reverse();
+    const byKey = new Map();
+    for (const f of findings) {
+        const quote = f.proof.quote ?? "";
+        const key = `${f.proof.url}\u0000${fold(quote)}`;
+        const seen = byKey.get(key);
+        if (seen) {
+            if (f.run !== seen.run && !seen.alsoIn.includes(f.run))
+                seen.alsoIn.push(f.run);
+            continue;
+        }
+        byKey.set(key, {
+            finding: f.id,
+            run: f.run,
+            ask: asks.get(f.run)?.text ?? "",
+            text: f.text,
+            quote,
+            url: f.proof.url,
+            date: f.date ?? null,
+            found: f.at,
+            by: f.by,
+            state: calls.get(f.id) === "keep" ? "kept" : "open",
+            alsoIn: [],
+            score: 0,
+        });
+    }
+    const index = new MiniSearch({
+        idField: "finding",
+        fields: ["text", "quote"],
+        searchOptions: { boost: { text: 2 }, prefix: true, fuzzy: 0.2 },
+    });
+    index.addAll([...byKey.values()]);
+    const of = new Map([...byKey.values()].map((r) => [r.finding, r]));
+    return index
+        .search(terms)
+        .slice(0, o.n ?? 20)
+        .flatMap((hit) => {
+        const r = of.get(hit.id);
+        return r ? [{ ...r, score: Math.round(hit.score * 100) / 100 }] : [];
+    });
+}
+//# sourceMappingURL=recall.js.map

package/dist/engine/recall.js.map

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

package/dist/engine/state.d.ts

@@ -0,0 +1,96 @@
+import { type CallRecord, type CheckRecord, type ClassRecord, type DeadRecord, type DocumentRecord, type DraftRecord, type EdgeRecord, type FindingRecord, type FoundRecord, type GapRecord, type HitRecord, type JudgeRecord, type LedgerRecord, type PatternRecord, type PersonRecord, type QueryRecord, type SnapshotRecord, type SourceClass, type SpendRecord, type SteerRecord, type Step, type VerdictRecord } from "../ledger/records.js";
+export interface Pointer {
+    round: number;
+    step: Step;
+}
+export interface RunState {
+    run: string;
+    records: LedgerRecord[];
+    /** The latest snapshot: the ask and the allow-list. Absent before round 1's plan. */
+    snapshot: SnapshotRecord | null;
+    /** The round the pointer is in. */
+    round: number;
+    /** Where to go next; null when the run stopped. */
+    next: Pointer | null;
+    /** Why the run stopped or the last step gave up. */
+    note: string | null;
+    queries: QueryRecord[];
+    hits: HitRecord[];
+    documents: DocumentRecord[];
+    findings: FindingRecord[];
+    /** The extractor's word on each document it handled. */
+    verdicts: VerdictRecord[];
+    calls: CallRecord[];
+    spends: SpendRecord[];
+    edges: EdgeRecord[];
+    /** What the person said along the way, oldest first. */
+    steers: SteerRecord[];
+    /** What a step or a person said a round lacks. */
+    gaps: GapRecord[];
+    /** The sample check's word on each finding it checked. */
+    checks: CheckRecord[];
+    /** What the agent says several findings say together. */
+    patterns: PatternRecord[];
+    drafts: DraftRecord[];
+    classes: ClassRecord[];
+    /** Facets the agent gave up on, for the rest of the run. */
+    dead: DeadRecord[];
+    /** People the agent named across platforms, in time order. */
+    people: PersonRecord[];
+    /** The latest class on each document and finding. */
+    classOf: Map<string, SourceClass>;
+    /** The judge's latest answers on each hit, document and finding. */
+    judged: Map<string, JudgeRecord["answers"]>;
+    judges: JudgeRecord[];
+    /** A known hit found again by another query. */
+    founds: FoundRecord[];
+    /** The hit record for each canonical URL: a hit seen again, in any round, is a `found`, not a new record. */
+    hitByKey: Map<string, string>;
+    /** The latest call on each hit and finding. */
+    called: Map<string, "keep" | "drop">;
+}
+/** Records must be in time order. */
+export declare function fold(run: string, records: readonly LedgerRecord[]): RunState;
+/** A finding stays kept unless its latest call is a drop. */
+export declare const kept: (state: RunState, f: FindingRecord) => boolean;
+/** What the run has found so far: the kept findings' sentences with their URLs, oldest first. */
+export declare const found: (state: RunState, round?: number) => string[];
+/**
+ * The round a person's gap or back edge is about. Between rounds (a pause, a stop) the pointer
+ * is one ahead of the last review, so it is the round that review closed; mid-round, the current one.
+ */
+export declare const personRound: (state: RunState) => number;
+/** The queries that found a hit: the one that wrote it, then every one it came back for. */
+export declare const queriesOf: (state: RunState) => Map<string, Set<string>>;
+/** The hits of a round, the ones no call has named yet. */
+export declare const uncalledHits: (state: RunState, round: number) => HitRecord[];
+/**
+ * The hits to read: kept by triage in this round, no document yet. A failed open is tried again
+ * on a rerun (`birdwatch back <run> read`).
+ */
+export declare const toRead: (state: RunState, round: number) => HitRecord[];
+/**
+ * The kept findings to check, at most `n`, spread across documents: each document's first
+ * unchecked finding, then each one's second, and so on. A finding with no quote, or one checked
+ * already, is not in it. Findings come in record order, so the sample is the same on a rerun.
+ */
+export declare function spreadSample(state: RunState, n: number, only?: (f: FindingRecord) => boolean): FindingRecord[];
+/** Share of kept findings a check reads at least: the budget's `checks` is the floor under it. */
+export declare const CHECK_SHARE = 0.1;
+/** The sample's size: the budget's `checks`, or a tenth of the kept findings in reach, whichever is more; 0 checks is none. */
+export declare const checkCount: (inReach: number, budget: number) => number;
+/** A round's sample for the check step, less what the round checked already. */
+export declare const toCheck: (state: RunState, round: number, budget: number) => FindingRecord[];
+/** The documents of a round without a verdict: the extract step has not finished them. */
+export declare const toExtract: (state: RunState, round: number) => DocumentRecord[];
+/** A finding's class: its own, else its document's; undefined when neither has one. */
+export declare const classOfFinding: (state: RunState, f: FindingRecord) => SourceClass | undefined;
+/**
+ * Sources per class over findings still kept: distinct sites, but each forum thread (a
+ * document) counts on its own, so 31 threads on one forum are 31 voices, not one site.
+ */
+export declare function classesOf(state: RunState, ids: readonly string[]): Partial<Record<SourceClass | "unclassed", number>>;
+/** The sources a set of findings rests on: the sum over `classesOf`. */
+export declare const sourcesOf: (classes: ReturnType<typeof classesOf>) => number;
+/** Vendor echo: every classed source is a vendor, and vendors cite each other. */
+export declare const echoOf: (classes: ReturnType<typeof classesOf>) => boolean;

package/dist/engine/state.js

@@ -0,0 +1,162 @@
+/**
+ * A run's state is the fold of its records, never held between steps: every step reads the
+ * trace again. The fold gives the ask, the round, the plan, what each step
+ * has handled, and the pointer: the next step to run, from the `done` and `edge` records.
+ */
+import { hostOf } from "../document/index.js";
+import { latestCalls, ofType } from "../ledger/ledger.js";
+import { STEPS, } from "../ledger/records.js";
+const after = (step) => STEPS[STEPS.indexOf(step) + 1] ?? null;
+/** Records must be in time order. */
+export function fold(run, records) {
+    let next = { round: 1, step: "plan" };
+    let note = null;
+    /** The round whose edge set the pointer: the review's own `done` then leaves it. */
+    let edged = 0;
+    for (const r of records) {
+        if (r.type === "done") {
+            if (!r.ok) {
+                next = { round: r.round, step: r.step };
+                note = r.note ?? null;
+                continue;
+            }
+            if (r.step === "review" && edged === r.round)
+                continue;
+            const to = after(r.step);
+            next = to ? { round: r.round, step: to } : null;
+            note = null;
+        }
+        else if (r.type === "edge") {
+            edged = r.round;
+            if (r.next === "stop")
+                next = null;
+            else if (r.next === "again")
+                next = { round: r.round + 1, step: "plan" };
+            else if (r.to)
+                next = { round: r.round, step: r.to };
+            note = r.why;
+        }
+    }
+    const snapshots = ofType(records, "snapshot");
+    const hits = ofType(records, "hit");
+    return {
+        run,
+        records: [...records],
+        snapshot: snapshots.at(-1) ?? null,
+        round: next?.round ?? snapshots.at(-1)?.round ?? 1,
+        next,
+        note,
+        queries: ofType(records, "query"),
+        hits,
+        documents: ofType(records, "document"),
+        findings: ofType(records, "finding"),
+        verdicts: ofType(records, "verdict"),
+        calls: ofType(records, "call"),
+        spends: ofType(records, "spend"),
+        edges: ofType(records, "edge"),
+        steers: ofType(records, "steer"),
+        gaps: ofType(records, "gap"),
+        checks: ofType(records, "check"),
+        patterns: ofType(records, "pattern"),
+        drafts: ofType(records, "draft"),
+        classes: ofType(records, "class"),
+        dead: ofType(records, "dead"),
+        people: ofType(records, "person"),
+        classOf: new Map(ofType(records, "class").map((c) => [c.on, c.class])),
+        judged: new Map(ofType(records, "judge").map((j) => [j.on, j.answers])),
+        judges: ofType(records, "judge"),
+        founds: ofType(records, "found"),
+        hitByKey: new Map(hits.map((h) => [h.key, h.id])),
+        called: latestCalls(records),
+    };
+}
+/** A finding stays kept unless its latest call is a drop. */
+export const kept = (state, f) => state.called.get(f.id) !== "drop";
+/** What the run has found so far: the kept findings' sentences with their URLs, oldest first. */
+export const found = (state, round) => state.findings
+    .filter((f) => (round === undefined || f.round === round) && kept(state, f))
+    .map((f) => `${f.text} (${f.proof.url})`);
+/**
+ * The round a person's gap or back edge is about. Between rounds (a pause, a stop) the pointer
+ * is one ahead of the last review, so it is the round that review closed; mid-round, the current one.
+ */
+export const personRound = (state) => {
+    const last = state.edges.at(-1);
+    return last && (!state.next || state.next.step === "plan") ? last.round : state.round;
+};
+/** The queries that found a hit: the one that wrote it, then every one it came back for. */
+export const queriesOf = (state) => {
+    const out = new Map(state.hits.map((h) => [h.id, new Set(h.queries)]));
+    for (const f of state.founds)
+        out.get(f.hit)?.add(f.query);
+    return out;
+};
+/** The hits of a round, the ones no call has named yet. */
+export const uncalledHits = (state, round) => state.hits.filter((h) => h.round === round && !state.called.has(h.id));
+/**
+ * The hits to read: kept by triage in this round, no document yet. A failed open is tried again
+ * on a rerun (`birdwatch back <run> read`).
+ */
+export const toRead = (state, round) => {
+    const read = new Set(state.documents.map((d) => d.hit));
+    return state.hits.filter((h) => h.round === round && state.called.get(h.id) === "keep" && !read.has(h.id));
+};
+/**
+ * The kept findings to check, at most `n`, spread across documents: each document's first
+ * unchecked finding, then each one's second, and so on. A finding with no quote, or one checked
+ * already, is not in it. Findings come in record order, so the sample is the same on a rerun.
+ */
+export function spreadSample(state, n, only = () => true) {
+    const checked = new Set(state.checks.map((c) => c.on));
+    const byDoc = new Map();
+    for (const f of state.findings)
+        if (only(f) && f.proof.quote && !checked.has(f.id) && kept(state, f))
+            byDoc.set(f.document, [...(byDoc.get(f.document) ?? []), f]);
+    const out = [];
+    const lists = [...byDoc.values()];
+    for (let i = 0; out.length < n && lists.some((l) => i < l.length); i++)
+        for (const l of lists) {
+            const f = l[i];
+            if (f && out.length < n)
+                out.push(f);
+        }
+    return out;
+}
+/** Share of kept findings a check reads at least: the budget's `checks` is the floor under it. */
+export const CHECK_SHARE = 0.1;
+/** The sample's size: the budget's `checks`, or a tenth of the kept findings in reach, whichever is more; 0 checks is none. */
+export const checkCount = (inReach, budget) => budget ? Math.max(budget, Math.ceil(inReach * CHECK_SHARE)) : 0;
+/** A round's sample for the check step, less what the round checked already. */
+export const toCheck = (state, round, budget) => {
+    const inRound = (f) => f.round === round;
+    const done = state.checks.filter((c) => c.round === round).length;
+    const reach = state.findings.filter((f) => inRound(f) && f.proof.quote && kept(state, f)).length;
+    return spreadSample(state, checkCount(reach, budget) - done, inRound);
+};
+/** The documents of a round without a verdict: the extract step has not finished them. */
+export const toExtract = (state, round) => {
+    const judged = new Set(state.verdicts.map((v) => v.document));
+    return state.documents.filter((d) => d.round === round && !judged.has(d.id));
+};
+/** A finding's class: its own, else its document's; undefined when neither has one. */
+export const classOfFinding = (state, f) => state.classOf.get(f.id) ?? state.classOf.get(f.document);
+/**
+ * Sources per class over findings still kept: distinct sites, but each forum thread (a
+ * document) counts on its own, so 31 threads on one forum are 31 voices, not one site.
+ */
+export function classesOf(state, ids) {
+    const sources = new Map();
+    for (const f of state.findings) {
+        if (!ids.includes(f.id) || !kept(state, f))
+            continue;
+        const c = classOfFinding(state, f) ?? "unclassed";
+        const key = c === "forum" ? f.document : hostOf(f.proof.url);
+        sources.set(c, (sources.get(c) ?? new Set()).add(key));
+    }
+    return Object.fromEntries([...sources].map(([c, s]) => [c, s.size]));
+}
+/** The sources a set of findings rests on: the sum over `classesOf`. */
+export const sourcesOf = (classes) => Object.values(classes).reduce((a, b) => a + (b ?? 0), 0);
+/** Vendor echo: every classed source is a vendor, and vendors cite each other. */
+export const echoOf = (classes) => !!classes.vendor && Object.keys(classes).every((c) => c === "vendor" || c === "unclassed");
+//# sourceMappingURL=state.js.map

package/dist/engine/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/engine/state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAoBL,KAAK,GAIN,MAAM,sBAAsB,CAAC;AAsD9B,MAAM,KAAK,GAAG,CAAC,IAAU,EAAe,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC;AAElF,qCAAqC;AACrC,MAAM,UAAU,IAAI,CAAC,GAAW,EAAE,OAAgC;IAChE,IAAI,IAAI,GAAmB,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACtD,IAAI,IAAI,GAAkB,IAAI,CAAC;IAC/B,oFAAoF;IACpF,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBACV,IAAI,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBACxC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC;gBACtB,SAAS;YACX,CAAC;YACD,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,KAAK,CAAC,CAAC,KAAK;gBAAE,SAAS;YACvD,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAChD,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC7B,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;YAChB,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;gBAAE,IAAI,GAAG,IAAI,CAAC;iBAC9B,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO;gBAAE,IAAI,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;iBACpE,IAAI,CAAC,CAAC,EAAE;gBAAE,IAAI,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;YACrD,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC;QACf,CAAC;IACH,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpC,OAAO;QACL,GAAG;QACH,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;QACrB,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI;QAClC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC;QAClD,IAAI;QACJ,IAAI;QACJ,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC;QACjC,IAAI;QACJ,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC;QACtC,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC;QACpC,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC;QACpC,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC;QAChC,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC;QAChC,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC;QAC5B,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC;QAChC,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC;QACpC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC;QAChC,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC;QACjC,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC;QAC7B,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC;QACjC,OAAO,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,MAAM,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACvE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC;QAChC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC;QAChC,QAAQ,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC;KAC7B,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAe,EAAE,CAAgB,EAAW,EAAE,CACjE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC;AAEpC,iGAAiG;AACjG,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAe,EAAE,KAAc,EAAY,EAAE,CACjE,KAAK,CAAC,QAAQ;KACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;KAC3E,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;AAE9C;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAe,EAAU,EAAE;IACrD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,OAAO,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;AACxF,CAAC,CAAC;AAEF,4FAA4F;AAC5F,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAe,EAA4B,EAAE;IACrE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM;QAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC3D,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAe,EAAE,KAAa,EAAe,EAAE,CAC1E,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEzE;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAe,EAAE,KAAa,EAAe,EAAE;IACpE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CACtB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CACjF,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAe,EACf,CAAS,EACT,OAAsC,GAAG,EAAE,CAAC,IAAI;IAEhD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,IAAI,GAAG,EAA2B,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ;QAC5B,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAClE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;QACpE,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC;AAED,kGAAkG;AAClG,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAE/B,+HAA+H;AAC/H,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,MAAc,EAAU,EAAE,CACpE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAElE,gFAAgF;AAChF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAe,EAAE,KAAa,EAAE,MAAc,EAAmB,EAAE;IACzF,MAAM,OAAO,GAAG,CAAC,CAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC;IACxD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,MAAM,CAAC;IAClE,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACjG,OAAO,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC,CAAC;AAEF,0FAA0F;AAC1F,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAe,EAAE,KAAa,EAAoB,EAAE;IAC5E,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9D,OAAO,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/E,CAAC,CAAC;AAEF,uFAAuF;AACvF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAe,EAAE,CAAgB,EAA2B,EAAE,CAC3F,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAE3D;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,KAAe,EACf,GAAsB;IAEtB,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0C,CAAC;IAClE,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAAE,SAAS;QACrD,MAAM,CAAC,GAAG,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,WAAW,CAAC;QAClD,MAAM,GAAG,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAqC,EAAU,EAAE,CACzE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAE3D,kFAAkF;AAClF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAqC,EAAW,EAAE,CACvE,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,WAAW,CAAC,CAAC"}