tinybeeai 0.0.0-stage → 0.16.1

package/dist/impact/pr.js

@@ -0,0 +1,54 @@
+// The PR side of the impact check (KAT-304). A ticket review can say an automated spec needs an update. When a PR for
+// that ticket does not change the spec, the PR review lists it under Not tested yet, so nobody merges the ticket's
+// change and leaves the old spec behind.
+import { createHash } from 'node:crypto';
+import { normalizeRef, requirementOf, specMatches } from '../cases.js';
+import { issueRef } from '../integrations/github-issues.js';
+import { linksFor } from '../links.js';
+import { watchRepos } from '../repos.js';
+import { impactRows } from './store.js';
+const MAX_NOTES = 3;
+const MAX_WHY = 140;
+/** The tickets a PR names: the ones it closes or references, as the traceability links hold them. */
+export function ticketsOfPr(watch, ev) {
+    const out = new Set();
+    if (!ev.pr || !ev.repo)
+        return out;
+    const pr = issueRef(`${ev.repo.owner}/${ev.repo.name}`, ev.pr.number);
+    for (const l of linksFor(pr, watch.id)) {
+        if (l.fromRef !== pr || (l.kind !== 'closes' && l.kind !== 'references'))
+            continue;
+        const ref = normalizeRef(l.toRef);
+        if (ref)
+            out.add(ref);
+    }
+    return out;
+}
+const idOf = (impactId) => createHash('sha1').update(`impact:${impactId}`).digest('hex').slice(0, 6);
+/**
+ * Specs a ticket of this PR says need an update, that the PR leaves unchanged. At most three, so the Not tested yet list
+ * stays short. A spec the PR changes is not listed: the PR is doing what the ticket review asked.
+ */
+export function specNotesForPr(watch, ev, changedPaths) {
+    const tickets = ticketsOfPr(watch, ev);
+    if (!tickets.size)
+        return [];
+    const out = [];
+    const multi = watchRepos(watch).length > 1;
+    for (const r of impactRows(watch.id, { state: 'open' })) {
+        if (r.subject !== 'spec' || r.verdict !== 'update' || !r.specPath || !tickets.has(r.ticket))
+            continue;
+        // The spec of another repo cannot change in this PR, and a path both repos hold is two specs (KAT-316).
+        if (multi && r.repo && ev.repo && r.repo !== `${ev.repo.owner}/${ev.repo.name}`.toLowerCase())
+            continue;
+        if (changedPaths.some((p) => specMatches(r.specPath, p)))
+            continue;
+        const req = requirementOf(r.ticket, watch);
+        const why = (r.note || 'The ticket changes what this test checks.').replace(/\s+/g, ' ').slice(0, MAX_WHY);
+        out.push({ id: idOf(r.id), ticket: r.ticket, ...(req.title ? { ticketTitle: req.title } : {}), title: r.title, file: r.specPath, why });
+        if (out.length >= MAX_NOTES)
+            break;
+    }
+    return out;
+}
+//# sourceMappingURL=pr.js.map

package/dist/impact/pr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr.js","sourceRoot":"","sources":["../../src/impact/pr.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,mHAAmH;AACnH,yCAAyC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,SAAS,GAAG,CAAC,CAAC;AACpB,MAAM,OAAO,GAAG,GAAG,CAAC;AAEpB,qGAAqG;AACrG,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,EAAqC;IAC7E,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI;QAAE,OAAO,GAAG,CAAC;IACnC,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;IACtE,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,CAAC,OAAO,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC;YAAE,SAAS;QACnF,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,GAAG;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,UAAU,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAE7G;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,EAAqC,EAAE,YAAsB;IACxG,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACvC,IAAI,CAAC,OAAO,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC,CAAC,OAAO,KAAK,MAAM,IAAI,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;YAAE,SAAS;QACtG,wGAAwG;QACxG,IAAI,KAAK,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;YAAE,SAAS;QACxG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,QAAS,EAAE,CAAC,CAAC,CAAC;YAAE,SAAS;QACpE,MAAM,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,2CAA2C,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC3G,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;QACxI,IAAI,GAAG,CAAC,MAAM,IAAI,SAAS;YAAE,MAAM;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/impact/store.js

@@ -0,0 +1,365 @@
+// Impact rows, drafts, and decisions (KAT-304, docs/DATA-MODEL.md section 2.3.1). One row per dot, ticket, and subject
+// (a case or a spec). A row that needs an update holds a draft case version; a row that makes a case obsolete holds an
+// Inbox approval of kind case_retire. Nothing here retires or rewrites a case by itself: a person accepts the draft, or
+// approves the retire in the Inbox.
+import { getCase, normalizeSpecPath, requirementOf, snapshotOf, updateCase, CaseInputError, retireCase } from '../cases.js';
+import { closeApproval } from '../agent/approvals.js';
+import { get, insert, list, remove, update } from '../db.js';
+import { githubWebUrl } from '../integrations/github.js';
+import { watchRepos } from '../repos.js';
+const now = () => new Date().toISOString();
+/** The text of the retire draft in the Inbox. */
+export function retireAction(c, row, 
+/** The case revision the review read (KAT-315). Approving refuses when the case changed since. */
+baseRevision) {
+    return {
+        kind: 'case_retire',
+        target: `case:${c.key}`,
+        title: `Retire ${c.key}: ${c.title}`.slice(0, 200),
+        body: [
+            `${row.ticket} removes or replaces what ${c.key} checks, so nobody needs to run it again.`,
+            row.ticketLine ? `Line of the ticket: "${row.ticketLine}"` : '',
+            row.note,
+            'If you approve, the case is retired. Its results stay. If you reject, the case stays as it is.',
+        ]
+            .filter(Boolean)
+            .join('\n\n'),
+        meta: { caseKey: c.key, impactId: row.id, ticket: row.ticket, ...(baseRevision !== undefined ? { baseRevision } : {}) },
+    };
+}
+// ---------- reading ----------
+/** A case is its id. A spec is its repo and its path: two repos may both hold e2e/coupon.spec.ts (KAT-316). */
+const subjectKey = (r) => r.subject === 'case' ? `case:${r.caseId}` : `spec:${r.repo ?? ''}:${r.specPath}`;
+/**
+ * The row as it stands now. An obsolete row follows its Inbox approval: approved means accepted, rejected means
+ * rejected, and a draft nobody decided before it expired means expired. An update row keeps its own state.
+ */
+export function resolveRow(row) {
+    if (row.state !== 'open' || row.verdict === 'valid')
+        return row;
+    if (row.subject === 'case' && row.caseId) {
+        const c = getCase(row.caseId);
+        if (!c)
+            return { ...row, state: 'expired' };
+        // Someone retired the case by hand: an obsolete row got what it asked for, an update row has nothing left to do.
+        if (c.status === 'retired')
+            return { ...row, state: row.verdict === 'obsolete' ? 'accepted' : 'expired' };
+    }
+    if (row.verdict !== 'obsolete' || !row.approvalId)
+        return row;
+    const a = get('approvals', row.approvalId);
+    if (!a)
+        return { ...row, state: 'expired' };
+    if (a.status === 'executed')
+        return { ...row, state: 'accepted' };
+    if (a.status === 'rejected')
+        return { ...row, state: 'rejected' };
+    if (a.status === 'expired' || a.status === 'superseded')
+        return { ...row, state: 'expired' };
+    if (a.status === 'pending' && a.expiresAt && Date.parse(a.expiresAt) <= Date.now())
+        return { ...row, state: 'expired' };
+    return row;
+}
+export function impactRows(dotId, f = {}) {
+    const where = { dotId };
+    if (f.ticket)
+        where.ticket = f.ticket;
+    if (f.caseId)
+        where.caseId = f.caseId;
+    const rows = list('case_impacts', where).map(resolveRow);
+    const order = { obsolete: 0, update: 1, valid: 2 };
+    return rows
+        .filter((r) => (f.state === 'open' ? r.state === 'open' : true))
+        .sort((a, b) => order[a.verdict] - order[b.verdict] ||
+        a.subject.localeCompare(b.subject) ||
+        (a.caseKey ?? a.specPath ?? '').localeCompare(b.caseKey ?? b.specPath ?? '', undefined, { numeric: true }));
+}
+/** The link to a spec in the repo that holds it. A row from before the repo was stored falls back to the dot's first repo. */
+function specUrl(w, path, repoId) {
+    const all = watchRepos(w);
+    const repo = (repoId ? all.find((r) => r.id === repoId.toLowerCase()) : undefined) ?? (repoId ? undefined : (all[0] ?? w.repo));
+    const safe = path ? normalizeSpecPath(path) : null;
+    if (!repo || !safe)
+        return undefined;
+    return `${githubWebUrl().replace(/\/$/, '')}/${encodeURIComponent(repo.owner)}/${encodeURIComponent(repo.name)}/blob/${encodeURIComponent(repo.defaultBranch)}/${safe.split('/').map(encodeURIComponent).join('/')}`;
+}
+/** What the latest check of a ticket matched but left out, from the summary stored on its run. Undefined when nothing was. */
+export function leftOutFor(dotId, ticket) {
+    const latest = list('runs', { watchId: dotId, kind: 'ticket_review' }, { orderBy: 'createdAt DESC' }).find((r) => r.impact?.ticket === ticket);
+    const l = latest?.impact?.leftOut;
+    return l && l.cases + l.specs > 0 ? l : undefined;
+}
+/** The rows as the API returns them: with the ticket as a titled reference, the case now, and a link for a spec. */
+export function impactList(w, f = {}) {
+    const rows = impactRows(w.id, f);
+    const reqs = new Map();
+    const items = rows.map((r) => {
+        let requirement = reqs.get(r.ticket);
+        if (!requirement)
+            reqs.set(r.ticket, (requirement = requirementOf(r.ticket, w)));
+        const c = r.caseId ? getCase(r.caseId) : undefined;
+        const link = r.specPath ? specUrl(w, r.specPath, r.repo) : undefined;
+        return { ...r, requirement, ...(c ? { caseStatus: c.status, currentSteps: c.steps ?? [], title: c.title } : {}), ...(link ? { specUrl: link } : {}) };
+    });
+    const leftOut = f.ticket ? leftOutFor(w.id, f.ticket) : undefined;
+    return { items, open: items.filter((i) => i.state === 'open' && i.verdict !== 'valid').length, ...(leftOut ? { leftOut } : {}) };
+}
+/** The cases a person has not decided on yet, for the Needs review mark in test runs. */
+export function needsReviewFlags(dotId) {
+    const out = new Map();
+    for (const r of impactRows(dotId, { state: 'open' })) {
+        if (r.subject !== 'case' || !r.caseId || r.verdict === 'valid' || out.has(r.caseId))
+            continue;
+        out.set(r.caseId, { impactId: r.id, ticket: r.ticket, verdict: r.verdict });
+    }
+    return out;
+}
+// ---------- drafts ----------
+function draftOf(impactId) {
+    return list('case_versions', { impactId }).find((v) => v.draft === 'draft');
+}
+/** The case version a ticket proposes: the case as it is, with the new steps, linked to the new ticket. */
+function proposedSnapshot(c, steps, ticket) {
+    const base = snapshotOf(c);
+    return { ...base, steps, requirementRefs: base.requirementRefs.includes(ticket) ? base.requirementRefs : [...base.requirementRefs, ticket] };
+}
+/** Writes the draft version of an update row. The old version stays the case's current one. */
+function writeDraft(c, row, steps, readRevision) {
+    const snapshot = proposedSnapshot(c, steps, row.ticket);
+    // The revision the review read (KAT-318), not the one the case has now: an edit made while the model answered must
+    // make accept refuse. Without a read revision, the case as it is now.
+    const base = readRevision ?? c.revision ?? 1;
+    const version = base + 1;
+    const at = now();
+    const have = draftOf(row.id);
+    if (have)
+        update('case_versions', have.id, { snapshot, version, baseRevision: base, at });
+    else
+        insert('case_versions', {
+            caseId: c.id,
+            dotId: c.dotId,
+            version,
+            snapshot,
+            draft: 'draft',
+            ticket: row.ticket,
+            impactId: row.id,
+            baseRevision: base,
+            actor: 'ticket review',
+            at,
+            createdAt: at,
+        });
+    return version;
+}
+/** The draft of an update row, for the app: the snapshot a person accepts or rejects. */
+export function draftSnapshot(impactId) {
+    return draftOf(impactId)?.snapshot;
+}
+/** The row for a candidate, if the ticket was checked against it before. */
+function existingRow(dotId, ticket, cand) {
+    const key = subjectKey({ subject: cand.kind, caseId: cand.caseId, specPath: cand.specPath, repo: cand.repo });
+    const rows = list('case_impacts', { dotId, ticket });
+    const hit = rows.find((r) => subjectKey(r) === key);
+    if (hit || cand.kind !== 'spec' || !cand.repo)
+        return hit;
+    // A spec row from before the repo was stored belongs to the repo of the same path, when only one repo has it.
+    return rows.find((r) => r.subject === 'spec' && !r.repo && r.specPath === cand.specPath);
+}
+const flagged = (verdict) => verdict !== 'valid';
+/**
+ * Stores what the check decided about one candidate. An accepted row is never reopened. A rejected row stays rejected
+ * while the ticket text is the one it was checked against (`hash`, see ticketHash); when the ticket changed, the test
+ * is checked again and may get a new draft. A flag that still waits for a person is not replaced by a later "still
+ * valid". It retires and rewrites nothing: an update row gets a draft version, and an obsolete row asks the caller
+ * (gate=true) to put the retire draft in the Inbox.
+ */
+export function applyDecision(watch, ticket, runId, cand, d, hash) {
+    const prev = existingRow(watch.id, ticket, cand);
+    const prevNow = prev ? resolveRow(prev) : undefined;
+    if (prev && prevNow && flagged(prevNow.verdict)) {
+        if (prevNow.state === 'accepted')
+            return { row: prevNow, gate: false };
+        // A row from before the hash was stored cannot say whether the ticket changed, so its rejection holds.
+        if (prevNow.state === 'rejected' && (!prev.ticketHash || !hash || prev.ticketHash === hash))
+            return { row: prevNow, gate: false };
+        if (prevNow.state === 'open' && (!flagged(d.verdict) || d.verdict === prev.verdict) && !retireDraftStale(prev, d, cand)) {
+            const patch = { runId, updatedAt: now(), ...(hash ? { ticketHash: hash } : {}) };
+            // The ticket text changed (KAT-327): the line, the note and the proposed steps must say what the new text says.
+            const changed = !!hash && !!prev.ticketHash && prev.ticketHash !== hash;
+            if (changed && flagged(d.verdict))
+                Object.assign(patch, { ticketLine: d.ticketLine ?? null, note: d.note, confidence: d.confidence, changes: d.changes ?? null });
+            if (d.verdict === 'update' && prev.subject === 'case' && d.changes) {
+                const c = prev.caseId ? getCase(prev.caseId) : undefined;
+                if (c)
+                    Object.assign(patch, {
+                        changes: d.changes,
+                        ticketLine: d.ticketLine ?? null,
+                        note: d.note,
+                        confidence: d.confidence,
+                        draftVersion: writeDraft(c, prev, d.changes, cand.revision),
+                    });
+            }
+            update('case_impacts', prev.id, patch);
+            return { row: get('case_impacts', prev.id), gate: false };
+        }
+    }
+    // A new row, or the row of an earlier check that this answer replaces (still valid before, a changed verdict, or
+    // an Inbox draft that expired undecided).
+    if (prev) {
+        const old = draftOf(prev.id);
+        if (old)
+            remove('case_versions', old.id);
+        // The retire draft in the Inbox asked about a verdict that no longer stands: it must not retire the case later (KAT-315).
+        if (prev.verdict === 'obsolete' && prev.approvalId)
+            supersedeRetire(prev, d.verdict, cand.revision);
+    }
+    const at = now();
+    const fields = {
+        dotId: watch.id,
+        ticket,
+        runId,
+        subject: cand.kind,
+        caseId: cand.caseId ?? null,
+        caseKey: cand.caseKey ?? null,
+        specPath: cand.specPath ?? null,
+        repo: cand.kind === 'spec' ? (cand.repo ?? null) : null,
+        title: cand.title,
+        verdict: d.verdict,
+        confidence: d.confidence,
+        ticketLine: d.ticketLine ?? null,
+        note: d.note,
+        changes: d.changes ?? null,
+        signals: cand.signals,
+        state: flagged(d.verdict) ? 'open' : 'none',
+        ticketHash: hash ?? null,
+        draftVersion: null,
+        approvalId: null,
+        decidedAt: null,
+        decidedBy: null,
+        updatedAt: at,
+    };
+    let row;
+    if (prev) {
+        update('case_impacts', prev.id, fields);
+        row = get('case_impacts', prev.id);
+    }
+    else
+        row = insert('case_impacts', { ...fields, createdAt: at });
+    if (d.verdict === 'update' && cand.kind === 'case' && d.changes) {
+        const c = getCase(cand.caseId);
+        if (c) {
+            update('case_impacts', row.id, { draftVersion: writeDraft(c, row, d.changes, cand.revision) });
+            row = get('case_impacts', row.id);
+        }
+    }
+    return { row, gate: d.verdict === 'obsolete' };
+}
+/**
+ * True when the row is obsolete again but its pending retire draft read an older case revision than this check did.
+ * That draft would refuse on approval, so the check writes a new one (KAT-315). The same revision keeps the draft.
+ */
+function retireDraftStale(prev, d, cand) {
+    if (d.verdict !== 'obsolete' || prev.verdict !== 'obsolete' || prev.subject !== 'case' || !prev.approvalId)
+        return false;
+    const a = get('approvals', prev.approvalId);
+    if (!a || a.status !== 'pending')
+        return false;
+    const based = a.action.meta?.baseRevision;
+    return typeof based === 'number' && cand.revision !== undefined && cand.revision !== based;
+}
+/** Closes the pending retire draft of a row whose verdict changed. A draft that was already decided stays as it is. */
+function supersedeRetire(row, now, revision) {
+    const a = get('approvals', row.approvalId);
+    if (!a || a.status !== 'pending')
+        return;
+    const why = now === 'obsolete'
+        ? `${row.caseKey ?? 'The case'} changed after this draft was written (version ${revision ?? 'newer'}). A newer check of ${row.ticket} still says it is obsolete, so a new draft replaces this one.`
+        : now === 'update'
+            ? `A newer check of ${row.ticket} says ${row.caseKey ?? 'the case'} needs an update, not a retirement.`
+            : `A newer check of ${row.ticket} no longer says ${row.caseKey ?? 'the case'} is obsolete.`;
+    closeApproval(a, 'superseded', why);
+}
+/** Links the Inbox approval to its obsolete row. Looks the approval up by its meta, since the gate returns only a result. */
+export function attachApproval(row, runId) {
+    const a = list('approvals', { watchId: row.dotId, runId })
+        .filter((x) => x.action.kind === 'case_retire' && x.action.meta?.impactId === row.id)
+        .sort((x, y) => y.createdAt.localeCompare(x.createdAt))[0];
+    if (a)
+        update('case_impacts', row.id, { approvalId: a.id });
+    return get('case_impacts', row.id);
+}
+// ---------- decisions ----------
+export class ImpactDecisionError extends Error {
+}
+/**
+ * A person accepts a row. An update row writes the draft as the case's next version (the old version stays in its
+ * history). A spec row is marked as updated. An obsolete row is decided in the Inbox, not here.
+ */
+export function acceptImpact(row, actor) {
+    const cur = resolveRow(row);
+    if (cur.state !== 'open')
+        throw new ImpactDecisionError(cur.state === 'accepted' || cur.state === 'rejected' ? `This was already ${cur.state}.` : 'This is not waiting for a decision.');
+    if (cur.verdict === 'obsolete')
+        throw new ImpactDecisionError('Retiring a case is decided in the Inbox. Approve the draft there.');
+    if (cur.subject === 'case') {
+        const draft = draftOf(cur.id);
+        const c = cur.caseId ? getCase(cur.caseId) : undefined;
+        if (!draft || !c)
+            throw new ImpactDecisionError('The draft or the case is gone.');
+        if (c.status === 'retired')
+            throw new ImpactDecisionError('This case is retired. Reject the draft instead.');
+        // The draft holds the whole case as it was when the ticket was checked. When the case changed since, writing it
+        // back would silently undo that edit (KAT-314), so the draft stays and a person decides.
+        const based = draft.baseRevision ?? draft.version - 1;
+        const current = c.revision ?? 1;
+        if (current !== based)
+            throw new ImpactDecisionError(`${c.key} changed after this draft was written (the draft is based on version ${based}, the case is now at version ${current}). Nothing was overwritten. Reject this draft, or check the ticket again to get a new one.`);
+        try {
+            updateCase(c, { title: draft.snapshot.title, steps: draft.snapshot.steps, requirementRefs: draft.snapshot.requirementRefs }, actor ?? 'ticket review');
+        }
+        catch (err) {
+            if (err instanceof CaseInputError)
+                throw new ImpactDecisionError(err.message);
+            throw err;
+        }
+        // The case now holds the new version in its history; the draft has done its job.
+        remove('case_versions', draft.id);
+    }
+    update('case_impacts', cur.id, { state: 'accepted', decidedAt: now(), decidedBy: actor ?? null, updatedAt: now() });
+    return get('case_impacts', cur.id);
+}
+/** A person rejects a row. The draft stays on record as rejected; the case does not change. */
+export function rejectImpact(row, actor) {
+    const cur = resolveRow(row);
+    if (cur.state !== 'open')
+        throw new ImpactDecisionError(cur.state === 'accepted' || cur.state === 'rejected' ? `This was already ${cur.state}.` : 'This is not waiting for a decision.');
+    if (cur.verdict === 'obsolete')
+        throw new ImpactDecisionError('Retiring a case is decided in the Inbox. Reject the draft there.');
+    const draft = draftOf(cur.id);
+    if (draft)
+        update('case_versions', draft.id, { draft: 'rejected' });
+    update('case_impacts', cur.id, { state: 'rejected', decidedAt: now(), decidedBy: actor ?? null, updatedAt: now() });
+    return get('case_impacts', cur.id);
+}
+export function getImpact(dotId, id) {
+    const r = get('case_impacts', id);
+    return r && r.dotId === dotId ? r : undefined;
+}
+/** Carries out an approved case_retire: the case is retired, its results stay, and the row is accepted. */
+export function executeCaseRetire(action, actor = 'approval') {
+    const meta = action.meta ?? {};
+    const row = typeof meta.impactId === 'string' ? get('case_impacts', meta.impactId) : undefined;
+    const c = row?.caseId ? getCase(row.caseId) : undefined;
+    if (!row || !c)
+        throw new Error('The case to retire is gone.');
+    // A newer check can change the verdict while the draft waits. The case stays then (KAT-315).
+    if (row.verdict !== 'obsolete')
+        throw new Error(`${c.key} is no longer obsolete: a newer check of ${row.ticket} changed what it says. The case was not retired.`);
+    // A person may have edited the case after the review read it. The edit may be why the case is still wanted (KAT-315).
+    const based = typeof meta.baseRevision === 'number' ? meta.baseRevision : undefined;
+    const current = c.revision ?? 1;
+    if (based !== undefined && current !== based)
+        throw new Error(`${c.key} changed after this retire draft was written (the draft is based on version ${based}, the case is now at version ${current}). The case was not retired. Reject this draft, or check ${row.ticket} again to get a new one.`);
+    retireCase(c, actor);
+    update('case_impacts', row.id, { state: 'accepted', decidedAt: now(), decidedBy: actor, updatedAt: now() });
+}
+//# sourceMappingURL=store.js.map

package/dist/impact/store.js.map

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

package/dist/impact/text.js

@@ -0,0 +1,158 @@
+// Word helpers for the impact check (KAT-304, docs/STAGES.md section 3.1): the words of a ticket and of a test, the
+// lines of a ticket, and the values a line names. Pure functions, no database.
+import { createHash } from 'node:crypto';
+import { normalizeText } from '../flows/testDesign.js';
+/** Words that say nothing about which feature a test or a ticket is about. */
+const COMMON = new Set(('the and for with from that this when then than into onto over under about after before also only just have has had been being are was were will would should must can could may might ' +
+    'not but any all each every some more most less other another same such like make makes made allow allows allowed able need needs want wants use uses used using ' +
+    'user users customer customers person people someone anyone page pages screen button buttons click clicks clicked press presses enter enters entered type types field fields form forms ' +
+    'see sees shown show shows showing display displays displayed open opens close closes check checks test tests tested case cases step steps app application site web ' +
+    'new old add adds added get gets got set sets list lists item items name names text link links view views story ticket tickets feature features behavior behaviour ' +
+    'please note given when whenever there their they them its our out off one two via per way ' +
+    'works working work correctly correct expected expect expects result results state value values').split(/\s+/));
+/** A light plural strip: coupons and coupon are one word. */
+function stem(w) {
+    if (w.length > 5 && w.endsWith('ies'))
+        return `${w.slice(0, -3)}y`;
+    if (w.length > 4 && w.endsWith('es') && /(ch|sh|x|ss)es$/.test(w))
+        return w.slice(0, -2);
+    if (w.length > 3 && w.endsWith('s') && !w.endsWith('ss'))
+        return w.slice(0, -1);
+    return w;
+}
+/** The distinct, meaningful words of a text: lower case, no common words, plurals joined. */
+export function wordsOf(text) {
+    const out = new Set();
+    for (const raw of normalizeText(text).split(' ')) {
+        if (raw.length < 3 && !/^\d+$/.test(raw))
+            continue;
+        if (COMMON.has(raw))
+            continue;
+        const w = stem(raw);
+        if (w.length < 3 && !/^\d+$/.test(w))
+            continue;
+        if (COMMON.has(w))
+            continue;
+        out.add(w);
+    }
+    return [...out];
+}
+/** How many of `a`'s words `b` also holds. */
+export function sharedWords(a, b) {
+    return a.filter((w) => b.has(w));
+}
+/** Everything a ticket says, as one text. */
+export function ticketText(t) {
+    return [t.title, t.description, t.acceptanceCriteria, (t.labels ?? []).join(' ')].filter(Boolean).join('\n');
+}
+/**
+ * A hash of what a person decided on: the title, the description, and the acceptance criteria of the ticket. Spacing
+ * and line breaks do not count, so a ticket saved again without a change keeps its hash. Labels and status do not count.
+ */
+export function ticketHash(t) {
+    const norm = (s) => (s ?? '').replace(/\s+/g, ' ').trim();
+    return createHash('sha256')
+        .update(JSON.stringify([norm(t.title), norm(t.description), norm(t.acceptanceCriteria)]))
+        .digest('hex')
+        .slice(0, 32);
+}
+/** "3 more matched and were left out." The empty string when the cap left nothing out. */
+export function leftOutSentence(l) {
+    const n = l.cases + l.specs;
+    return n > 0 ? `${n} more matched and ${n === 1 ? 'was' : 'were'} left out.` : '';
+}
+const MAX_LINE = 400;
+/**
+ * The lines of a ticket: its title, then each line and each sentence of the description and the acceptance criteria,
+ * without list markers. A ticket line the model cites must be one of these (or part of one).
+ */
+export function ticketLines(t) {
+    const out = [];
+    const add = (s) => {
+        const line = s
+            .replace(/^\s*(?:[-*+]\s+(?:\[[ xX]\]\s*)?|\d+[.)]\s+|#+\s+)/, '')
+            .replace(/\s+/g, ' ')
+            .trim();
+        if (line.length >= 3 && line.length <= MAX_LINE && !out.includes(line))
+            out.push(line);
+    };
+    add(t.title);
+    for (const block of [t.description, t.acceptanceCriteria]) {
+        for (const raw of (block ?? '').split(/\r?\n/)) {
+            // A long line holds several sentences; each is a line of its own. A decimal such as 4.5 is not a sentence end.
+            for (const s of raw.split(/(?<=[.!?])\s+(?=[A-Z"'(])/))
+                add(s);
+        }
+    }
+    return out;
+}
+/** True when `line` is a line of the ticket, ignoring case, punctuation, and spaces. A fragment of a line counts. */
+export function lineInTicket(line, t) {
+    const l = normalizeText(line);
+    if (l.length < 4)
+        return false;
+    return normalizeText(ticketText(t)).includes(l);
+}
+/** The line of the ticket text that holds `fragment` in full, else the fragment. */
+export function wholeLine(fragment, t) {
+    const f = normalizeText(fragment);
+    return ticketLines(t).find((l) => normalizeText(l).includes(f)) ?? fragment.trim();
+}
+/** A line that removes or replaces a behavior. */
+export const REMOVE_CUE = /\b(remov(?:e|es|ed|ing|al)|delet(?:e|es|ed|ing)|drop(?:s|ped|ping)?|retir(?:e|es|ed|ing)|discontinu(?:e|es|ed|ing)|sunset(?:s|ting)?|deprecat\w+|get rid of|goes? away|no longer (?:offer|offered|support|supported|allow|allowed|available|exists?|shown?|needed)|replac(?:e|es|ed|ing)|replaced by)\b/i;
+/** A line that changes a value, a rule, or a message. */
+export const CHANGE_CUE = /\b(chang(?:e|es|ed|ing)|now|instead of|rather than|increas(?:e|es|ed|ing)|decreas(?:e|es|ed|ing)|reduc(?:e|es|ed|ing)|rais(?:e|es|ed|ing)|lower(?:s|ed|ing)?|renam(?:e|es|ed|ing)|updat(?:e|es|ed|ing)|from\s+\S.*\s+to\s+\S|no longer)\b/i;
+/** A number: thousands separators and a decimal fraction stay in it. */
+const NUM = String.raw `(?:\d{1,3}(?:,\d{3})+(?:\.\d+)?|\d+(?:\.\d+)?)`;
+const VALUE = new RegExp(String.raw `"[^"]{1,40}"|(?<![A-Za-z])'[^']{1,40}'(?![A-Za-z])|[$€£]\s?\d[\d,]*(?:\.\d+)?|(?<![A-Za-z0-9.])${NUM}\s?%|(?<![A-Za-z0-9.])${NUM}(?:\s?(?:days?|hours?|minutes?|mins?|seconds?|items?|characters?|chars?|attempts?|times?))?`, 'gi');
+/** The values a text names, in order: money, percents, numbers with a unit, and quoted text. */
+export function valuesIn(text) {
+    return [...text.matchAll(VALUE)].map((m) => m[0].trim().replace(/^["']|["']$/g, '')).filter(Boolean);
+}
+/**
+ * The old and new value a change line names, or null when it names none. Reads "from A to B" and "A instead of B".
+ * It never reads a value out of a line that gives no pair, so the check stays a rule and not a guess.
+ */
+export function valuePair(line) {
+    const fromTo = /\bfrom\s+(.+?)\s+to\s+(.+?)(?:[.,;:](?=\s|$)|\s+(?:when|if|for|on|in|and|so)\b|$)/i.exec(line);
+    if (fromTo) {
+        const a = valuesIn(fromTo[1])[0];
+        const b = valuesIn(fromTo[2])[0];
+        if (a && b && a !== b)
+            return { from: a, to: b };
+    }
+    const instead = /^(.*?)\s+(?:instead of|rather than)\s+(.+)$/i.exec(line);
+    if (instead) {
+        const nowV = valuesIn(instead[1]).at(-1);
+        const oldV = valuesIn(instead[2])[0];
+        if (nowV && oldV && nowV !== oldV)
+            return { from: oldV, to: nowV };
+    }
+    // "Replace 10% with 20%".
+    const swap = /\breplac(?:e|es|ed|ing)\s+(.+?)\s+with\s+(.+?)(?:[.,;:](?=\s|$)|$)/i.exec(line);
+    if (swap) {
+        const a = valuesIn(swap[1])[0];
+        const b = valuesIn(swap[2])[0];
+        if (a && b && a !== b)
+            return { from: a, to: b };
+    }
+    // "not 10%": "SAVE10 now gives 20% off, not 10%."
+    const not = /^(.*),\s*not\s+(.+)$/i.exec(line);
+    if (not && /\bnow\b/i.test(not[1])) {
+        const nowV = valuesIn(not[1]).at(-1);
+        const oldV = valuesIn(not[2])[0];
+        if (nowV && oldV && nowV !== oldV)
+            return { from: oldV, to: nowV };
+    }
+    return null;
+}
+/** Replaces every occurrence of `from` in `s`, ignoring case. Returns null when `from` is not there. */
+export function replaceValue(s, from, to) {
+    const esc = from.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    // A value must stand alone: 10% in "110%" is not 10%.
+    const re = new RegExp(`(?<![\\w.]|\\d,)${esc}(?![\\w]|[.,]\\d)`, 'gi');
+    if (!re.test(s))
+        return null;
+    return s.replace(re, to);
+}
+//# sourceMappingURL=text.js.map

package/dist/impact/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/impact/text.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,+EAA+E;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD,8EAA8E;AAC9E,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,CACE,wLAAwL;IACxL,kKAAkK;IAClK,yLAAyL;IACzL,qKAAqK;IACrK,oKAAoK;IACpK,4FAA4F;IAC5F,gGAAgG,CACjG,CAAC,KAAK,CAAC,KAAK,CAAC,CACf,CAAC;AAEF,6DAA6D;AAC7D,SAAS,IAAI,CAAC,CAAS;IACrB,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IACnE,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACzF,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAChF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,SAAS;QACnD,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,SAAS;QAC/C,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,SAAS;QAC5B,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACb,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;AAClB,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,WAAW,CAAC,CAAoB,EAAE,CAAsB;IACtE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,UAAU,CAAC,CAA0E;IACnG,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/G,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,CAA+D;IACxF,MAAM,IAAI,GAAG,CAAC,CAAqB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9E,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;SACxF,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,eAAe,CAAC,CAAgB;IAC9C,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IAC5B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;AACpF,CAAC;AAED,MAAM,QAAQ,GAAG,GAAG,CAAC;AAErB;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,CAA+D;IACzF,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE;QACxB,MAAM,IAAI,GAAG,CAAC;aACX,OAAO,CAAC,oDAAoD,EAAE,EAAE,CAAC;aACjE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;aACpB,IAAI,EAAE,CAAC;QACV,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzF,CAAC,CAAC;IACF,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACb,KAAK,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC1D,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/C,+GAA+G;YAC/G,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,2BAA2B,CAAC;gBAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,qHAAqH;AACrH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,CAA0E;IACnH,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/B,OAAO,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,CAA+D;IACzG,MAAM,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAClC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;AACrF,CAAC;AAED,kDAAkD;AAClD,MAAM,CAAC,MAAM,UAAU,GACrB,0SAA0S,CAAC;AAE7S,yDAAyD;AACzD,MAAM,CAAC,MAAM,UAAU,GACrB,4OAA4O,CAAC;AAE/O,wEAAwE;AACxE,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAA,gDAAgD,CAAC;AACvE,MAAM,KAAK,GAAG,IAAI,MAAM,CACtB,MAAM,CAAC,GAAG,CAAA,kGAAkG,GAAG,yBAAyB,GAAG,6FAA6F,EACxO,IAAI,CACL,CAAC;AAEF,gGAAgG;AAChG,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACvG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,MAAM,GAAG,oFAAoF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/G,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;IACnD,CAAC;IACD,MAAM,OAAO,GAAG,8CAA8C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1E,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACrE,CAAC;IACD,0BAA0B;IAC1B,MAAM,IAAI,GAAG,qEAAqE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9F,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;IACnD,CAAC;IACD,kDAAkD;IAClD,MAAM,GAAG,GAAG,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACrE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,YAAY,CAAC,CAAS,EAAE,IAAY,EAAE,EAAU;IAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACxD,sDAAsD;IACtD,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,mBAAmB,GAAG,mBAAmB,EAAE,IAAI,CAAC,CAAC;IACvE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7B,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AAC3B,CAAC"}