@variance-authority/tribunal 0.1.0

package/dist/review-read.js

@@ -0,0 +1,361 @@
+import { identityFrom } from '@variance-authority/raster';
+import { ReviewError, number, optionalNumber, optionalText, text, } from './review-rows.js';
+/**
+ * A build, read back out of D1 and turned into what a reviewer is shown.
+ *
+ * Apart from [`review.ts`](./review.ts) because nothing here writes anything:
+ * given rows, these produce the summary, the current decision per subject, the
+ * docket and the per-subject view, and every one of them is safe to call twice.
+ *
+ * Two of the project's arguments are implemented here and nowhere else — that the
+ * *current* decision is the highest sequence rather than the newest timestamp,
+ * and that the docket is ranked by cause pixels rather than by area — and both
+ * are written on the function that carries them, because that is what a later
+ * edit will be looking at when it is about to undo one.
+ */
+export async function summarize(db, project, row) {
+    const build = text(row, 'build', 'a build');
+    const identity = identityFrom(JSON.parse(text(row, 'identity', 'a build')));
+    if (identity === null) {
+        throw new ReviewError(`build "${build}" carries an identity that is not a renderer identity`);
+    }
+    const counted = await db
+        .prepare('SELECT verdict, COUNT(*) AS n FROM build_subjects WHERE project = ? AND build = ? GROUP BY verdict')
+        .bind(project, build)
+        .all();
+    // Every verdict, including the ones nothing pends on. A map missing a key
+    // reports `undefined` where a build genuinely had none, and a review surface
+    // that cannot tell "no ignored subjects" from "this build predates ignores" is
+    // one an operator has to go to the database to trust.
+    const verdicts = {
+        unchanged: 0,
+        changed: 0,
+        new: 0,
+        incomparable: 0,
+        ignored: 0,
+    };
+    for (const entry of counted.results) {
+        const verdict = text(entry, 'verdict', 'a verdict count');
+        if (verdict in verdicts)
+            verdicts[verdict] = number(entry, 'n', 'a verdict count');
+    }
+    const decisions = await latestDecisions(db, project, build);
+    const needing = await db
+        .prepare(`SELECT subject FROM build_subjects
+        WHERE project = ? AND build = ? AND verdict IN ('changed', 'new', 'incomparable')`)
+        .bind(project, build)
+        .all();
+    const pending = needing.results.filter((subject) => !decisions.has(text(subject, 'subject', 'a build subject'))).length;
+    const skipped = await db
+        .prepare(`SELECT kind, COUNT(*) AS n FROM build_not_observed
+        WHERE project = ? AND build = ? GROUP BY kind`)
+        .bind(project, build)
+        .all();
+    const coverage = {
+        stated: number(row, 'says_not_observed', 'a build') !== 0,
+        failed: countOf(skipped.results, 'failed'),
+        excluded: countOf(skipped.results, 'excluded'),
+        unreached: countOf(skipped.results, 'unreached'),
+    };
+    const branch = optionalText(row, 'branch', 'a build');
+    const intent = optionalText(row, 'intent', 'a build');
+    return {
+        project,
+        build,
+        commit: text(row, 'commit', 'a build'),
+        at: text(row, 'at', 'a build'),
+        identity,
+        retention: text(row, 'retention', 'a build') === 'ephemeral' ? 'ephemeral' : 'durable',
+        verdicts,
+        decided: decisions.size,
+        pending,
+        coverage,
+        ...(branch !== undefined ? { branch } : {}),
+        ...(intent !== undefined ? { intent } : {}),
+    };
+}
+/**
+ * The current decision per subject, from an append-only table.
+ *
+ * `MAX(seq)` rather than `MAX(at_ms)`: two decisions can share a millisecond, and
+ * a tie broken arbitrarily would show a reviewer their earlier answer as the
+ * current one. The sequence is the order the rows were written and cannot tie.
+ */
+export async function latestDecisions(db, project, build) {
+    const rows = await db
+        .prepare(`SELECT d.subject, d.decision, d.decided_by, d.note, d.at
+         FROM decisions d
+         JOIN (SELECT subject, MAX(seq) AS seq FROM decisions
+                WHERE project = ? AND build = ? GROUP BY subject) latest
+           ON latest.seq = d.seq`)
+        .bind(project, build)
+        .all();
+    const decisions = new Map();
+    for (const row of rows.results) {
+        const note = optionalText(row, 'note', 'a decision');
+        decisions.set(text(row, 'subject', 'a decision'), {
+            decision: text(row, 'decision', 'a decision') === 'approved' ? 'approved' : 'rejected',
+            by: text(row, 'decided_by', 'a decision'),
+            at: text(row, 'at', 'a decision'),
+            ...(note !== undefined ? { note } : {}),
+        });
+    }
+    return decisions;
+}
+/**
+ * The docket: one entry per cause component, with collateral counted.
+ *
+ * Ranked by cause pixels rather than by total area, because area measures
+ * *displacement* — a container that only reflowed outranks the component that was
+ * edited, measured at 6× on one edit. Collateral is summed into the entry rather
+ * than listed, so one token change across 300 subjects is one review item with a
+ * count.
+ */
+export function docket(subjects) {
+    const causes = new Map();
+    let collateral = 0;
+    for (const subject of subjects) {
+        for (const region of subject.regions) {
+            if (!region.cause) {
+                collateral += region.pixels;
+                continue;
+            }
+            const name = region.component ?? '(unattributed)';
+            const entry = causes.get(name) ?? { subjects: new Set(), pixels: 0 };
+            entry.pixels += region.pixels;
+            entry.subjects.add(subject.subject);
+            if (entry.file === undefined && region.file !== undefined)
+                entry.file = region.file;
+            causes.set(name, entry);
+        }
+    }
+    return [...causes.entries()]
+        .map(([component, entry]) => ({
+        component,
+        subjects: [...entry.subjects].sort(),
+        pixels: entry.pixels,
+        // The same total on every entry, and deliberately so: collateral is a
+        // property of the build, not of one cause. Splitting it between causes
+        // would require deciding which edit pushed which box around, which is
+        // exactly the attribution the semantic tier declined to claim.
+        collateralPixels: collateral,
+        ...(entry.file !== undefined ? { file: entry.file } : {}),
+    }))
+        .sort((left, right) => {
+        const byPixels = right.pixels - left.pixels;
+        if (byPixels !== 0)
+            return byPixels;
+        return left.component < right.component ? -1 : left.component > right.component ? 1 : 0;
+    });
+}
+export function toSubjectView(row, decision) {
+    const what = 'a build subject';
+    const truncated = optionalText(row, 'truncated', what);
+    const missingFonts = optionalText(row, 'missing_fonts', what);
+    const findings = optionalText(row, 'findings', what);
+    const signals = optionalText(row, 'signals', what);
+    const ignored = optionalText(row, 'ignored', what);
+    const relaxed = optionalText(row, 'relaxed', what);
+    const moved = optionalText(row, 'moved', what);
+    const after = optionalText(row, 'after_key', what);
+    const width = row['candidate_width'];
+    const height = row['candidate_height'];
+    const wasWide = row['baseline_width'];
+    const wasTall = row['baseline_height'];
+    return {
+        subject: text(row, 'subject', what),
+        verdict: text(row, 'verdict', what),
+        because: text(row, 'because', what),
+        changedPixels: number(row, 'changed_pixels', what),
+        regions: JSON.parse(text(row, 'regions', what)),
+        has: {
+            before: optionalText(row, 'before_key', what) !== undefined,
+            after: after !== undefined,
+            diff: optionalText(row, 'diff_key', what) !== undefined,
+        },
+        approvable: after !== undefined && optionalText(row, 'candidate_document_digest', what) !== undefined,
+        decision,
+        ...(truncated !== undefined
+            ? { truncated: JSON.parse(truncated) }
+            : {}),
+        ...(missingFonts !== undefined ? { missingFonts: JSON.parse(missingFonts) } : {}),
+        ...(findings !== undefined ? { findings: JSON.parse(findings) } : {}),
+        ...(signals !== undefined
+            ? { signals: JSON.parse(signals) }
+            : {}),
+        // Absent stays absent. A row written before step 10, or by a run whose
+        // config declared nothing, says nothing here — and a `{}` invented in its
+        // place would tell a reader a rule absorbed nothing.
+        ...(ignored !== undefined
+            ? { ignored: JSON.parse(ignored) }
+            : {}),
+        ...(relaxed !== undefined
+            ? { relaxed: JSON.parse(relaxed) }
+            : {}),
+        ...(moved !== undefined ? { moved: JSON.parse(moved) } : {}),
+        ...(typeof width === 'number' && typeof height === 'number' ? { size: { width, height } } : {}),
+        ...(typeof wasWide === 'number' && typeof wasTall === 'number'
+            ? { baseline: { width: wasWide, height: wasTall } }
+            : {}),
+    };
+}
+/**
+ * A stored variation, read back as the record the report wrote.
+ *
+ * Every optional field stays optional. `identical` is the one worth naming: the
+ * column is nullable and `NULL` is read as absent rather than as `false`, because
+ * a pair nothing compared and a pair compared and found to differ are different
+ * claims, and only the second is something a reviewer can act on.
+ *
+ * `how` is narrowed rather than cast. A row holding a word this deployment does
+ * not know is read as *unstated* — the sentence in `because` still says what
+ * happened, and asserting `declared` over an unrecognised value would put "a
+ * person said so" on an inference.
+ */
+export function toVariation(row) {
+    const what = 'a build variation';
+    const parent = optionalText(row, 'parent', what);
+    const identical = row['identical'];
+    const bands = optionalText(row, 'bands', what);
+    const unobserved = optionalText(row, 'unobserved', what);
+    const components = optionalText(row, 'components', what);
+    const digest = optionalText(row, 'digest', what);
+    const how = optionalText(row, 'how', what);
+    return {
+        subject: text(row, 'subject', what),
+        because: text(row, 'because', what),
+        ...(parent !== undefined ? { parent } : {}),
+        ...(identical === null || identical === undefined ? {} : { identical: Number(identical) !== 0 }),
+        ...(bands !== undefined ? { bands: JSON.parse(bands) } : {}),
+        ...(unobserved !== undefined ? { unobserved: JSON.parse(unobserved) } : {}),
+        ...(components !== undefined ? { components: JSON.parse(components) } : {}),
+        ...(digest !== undefined ? { digest } : {}),
+        ...(how === 'declared' || how === 'named' ? { how } : {}),
+    };
+}
+/**
+ * The reach rows, read back as the section the page draws.
+ *
+ * The one rule worth stating: `whole` present means `subjects` stays *absent*,
+ * even though the query returned an empty list either way. A refusal rendered as
+ * an empty attribution reads as "this commit reaches none of your subjects",
+ * which is the sentence somebody merges on — and it is the opposite of what the
+ * row says.
+ */
+export function toReach(row, subjects) {
+    const what = 'a build reach';
+    const whole = optionalText(row, 'whole', what);
+    const unscanned = optionalText(row, 'unscanned', what);
+    const opaque = optionalText(row, 'opaque', what);
+    const attributed = {};
+    for (const entry of subjects) {
+        const because = 'a reached subject';
+        const through = optionalText(entry, 'through', because);
+        const trail = optionalText(entry, 'trail', because);
+        attributed[text(entry, 'subject', because)] = {
+            reached: Number(entry['reached']) !== 0,
+            through: through === undefined ? [] : JSON.parse(through),
+            because: text(entry, 'because', because),
+            ...(trail === undefined ? {} : { trail: JSON.parse(trail) }),
+        };
+    }
+    return {
+        against: text(row, 'against_ref', what),
+        changed: JSON.parse(text(row, 'changed', what)),
+        components: JSON.parse(text(row, 'components', what)),
+        ...(whole === undefined ? { subjects: attributed } : { whole }),
+        ...(unscanned === undefined ? {} : { unscanned: JSON.parse(unscanned) }),
+        ...(opaque === undefined ? {} : { opaque: JSON.parse(opaque) }),
+    };
+}
+/**
+ * One census row, read back as an edge a sentence can be built from.
+ *
+ * No shape checking beyond the parse, for the reason `toReach` gives: the
+ * columns were written from a typed value by `ingest`.
+ */
+export function toPlacement(row) {
+    const what = 'a composition entry';
+    return {
+        component: text(row, 'component', what),
+        subjects: JSON.parse(text(row, 'subjects', what)),
+        within: JSON.parse(text(row, 'within', what)),
+        createdBy: JSON.parse(text(row, 'created_by', what)),
+        renders: JSON.parse(text(row, 'renders', what)),
+    };
+}
+/**
+ * One attributed movement, read back as the run wrote it.
+ *
+ * `cause` is narrowed by comparison against the five rungs rather than cast. It
+ * is the only column here a later schema could widen, and a row carrying a rung
+ * this build does not know is a row it must refuse rather than print.
+ */
+export function toMovement(row) {
+    const what = 'a movement';
+    const cause = text(row, 'cause', what);
+    if (!RUNGS.includes(cause)) {
+        throw new ReviewError(`${what} carries a cause this build does not know: "${cause}"`);
+    }
+    const file = optionalText(row, 'file', what);
+    const tokens = optionalText(row, 'tokens', what);
+    const upstream = optionalText(row, 'upstream', what);
+    const through = optionalText(row, 'through', what);
+    const standing = optionalText(row, 'standing', what);
+    const compared = optionalNumber(row, 'compared', what);
+    return {
+        subject: text(row, 'subject', what),
+        component: text(row, 'component', what),
+        cause: cause,
+        because: text(row, 'because', what),
+        bands: JSON.parse(text(row, 'bands', what)),
+        held: JSON.parse(text(row, 'held', what)),
+        ...(compared === undefined ? {} : { compared }),
+        ...(file === undefined ? {} : { file }),
+        ...(tokens === undefined ? {} : { tokens: JSON.parse(tokens) }),
+        ...(upstream === undefined ? {} : { upstream }),
+        ...(through === undefined ? {} : { through: JSON.parse(through) }),
+        ...(standing === undefined ? {} : { standing: standing === 'flake' ? 'flake' : 'suspect' }),
+    };
+}
+const RUNGS = [
+    'edited',
+    'token',
+    'upstream',
+    'contradicted',
+    'unexplained',
+];
+// Named, not defaulted-to-`failed`. The stored word is the run's conclusion, and
+// anything the reader does not recognise is a hole in this reader — which is
+// what `failed` says — rather than in the run.
+const NOT_OBSERVED = ['excluded', 'unreached', 'failed'];
+export function toNotObserved(row) {
+    const what = 'a not-observed entry';
+    const kind = text(row, 'kind', what);
+    return {
+        subject: text(row, 'subject', what),
+        kind: NOT_OBSERVED.find((known) => known === kind) ?? 'failed',
+        because: text(row, 'because', what),
+    };
+}
+/**
+ * The declaration ledgers, read back whole or read back as absent.
+ *
+ * No shape checking beyond the parse, and that is the same trade `toReach` makes:
+ * the column was written from a typed value by `ingest`, and a reader that
+ * re-validated it would be a second opinion about a shape this repository owns.
+ * What it does refuse is turning a missing column into an empty ledger.
+ */
+export function toDeclarations(row) {
+    const ignores = optionalText(row, 'ignores', 'a build');
+    const sensitivities = optionalText(row, 'sensitivities', 'a build');
+    return {
+        ignores: ignores === undefined ? null : JSON.parse(ignores),
+        sensitivities: sensitivities === undefined ? null : JSON.parse(sensitivities),
+    };
+}
+function countOf(rows, kind) {
+    const found = rows.find((row) => row['kind'] === kind);
+    return found === undefined ? 0 : number(found, 'n', 'a coverage count');
+}
+//# sourceMappingURL=review-read.js.map

package/dist/review-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-read.js","sourceRoot":"","sources":["../src/review-read.ts"],"names":[],"mappings":"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","sourcesContent":["import { identityFrom } from '@variance-authority/raster';\nimport type {\n  FindingRecord,\n  IgnoreLedger,\n  NotObserved,\n  ObservationRecord,\n  ReachHole,\n  ReachedComponent,\n  RegionRecord,\n  SensitivityLedger,\n  SubjectReach,\n  VariationRecord,\n} from '@variance-authority/report';\nimport type { D1Like } from './bindings.js';\nimport {\n  ReviewError,\n  number,\n  optionalNumber,\n  optionalText,\n  text,\n  type Row,\n} from './review-rows.js';\nimport type {\n  BuildSummary,\n  Cause,\n  Coverage,\n  Declarations,\n  DecisionRecord,\n  MovementView,\n  Placement,\n  ReachView,\n  SubjectView,\n} from './review-types.js';\n\n/**\n * A build, read back out of D1 and turned into what a reviewer is shown.\n *\n * Apart from [`review.ts`](./review.ts) because nothing here writes anything:\n * given rows, these produce the summary, the current decision per subject, the\n * docket and the per-subject view, and every one of them is safe to call twice.\n *\n * Two of the project's arguments are implemented here and nowhere else — that the\n * *current* decision is the highest sequence rather than the newest timestamp,\n * and that the docket is ranked by cause pixels rather than by area — and both\n * are written on the function that carries them, because that is what a later\n * edit will be looking at when it is about to undo one.\n */\n\nexport async function summarize(db: D1Like, project: string, row: Row): Promise<BuildSummary> {\n  const build = text(row, 'build', 'a build');\n  const identity = identityFrom(JSON.parse(text(row, 'identity', 'a build')) as unknown);\n  if (identity === null) {\n    throw new ReviewError(`build \"${build}\" carries an identity that is not a renderer identity`);\n  }\n\n  const counted = await db\n    .prepare(\n      'SELECT verdict, COUNT(*) AS n FROM build_subjects WHERE project = ? AND build = ? GROUP BY verdict',\n    )\n    .bind(project, build)\n    .all<Row>();\n\n  // Every verdict, including the ones nothing pends on. A map missing a key\n  // reports `undefined` where a build genuinely had none, and a review surface\n  // that cannot tell \"no ignored subjects\" from \"this build predates ignores\" is\n  // one an operator has to go to the database to trust.\n  const verdicts: Record<ObservationRecord['verdict'], number> = {\n    unchanged: 0,\n    changed: 0,\n    new: 0,\n    incomparable: 0,\n    ignored: 0,\n  };\n  for (const entry of counted.results) {\n    const verdict = text(entry, 'verdict', 'a verdict count') as ObservationRecord['verdict'];\n    if (verdict in verdicts) verdicts[verdict] = number(entry, 'n', 'a verdict count');\n  }\n\n  const decisions = await latestDecisions(db, project, build);\n  const needing = await db\n    .prepare(\n      `SELECT subject FROM build_subjects\n        WHERE project = ? AND build = ? AND verdict IN ('changed', 'new', 'incomparable')`,\n    )\n    .bind(project, build)\n    .all<Row>();\n\n  const pending = needing.results.filter(\n    (subject) => !decisions.has(text(subject, 'subject', 'a build subject')),\n  ).length;\n\n  const skipped = await db\n    .prepare(\n      `SELECT kind, COUNT(*) AS n FROM build_not_observed\n        WHERE project = ? AND build = ? GROUP BY kind`,\n    )\n    .bind(project, build)\n    .all<Row>();\n\n  const coverage: Coverage = {\n    stated: number(row, 'says_not_observed', 'a build') !== 0,\n    failed: countOf(skipped.results, 'failed'),\n    excluded: countOf(skipped.results, 'excluded'),\n    unreached: countOf(skipped.results, 'unreached'),\n  };\n\n  const branch = optionalText(row, 'branch', 'a build');\n  const intent = optionalText(row, 'intent', 'a build');\n\n  return {\n    project,\n    build,\n    commit: text(row, 'commit', 'a build'),\n    at: text(row, 'at', 'a build'),\n    identity,\n    retention: text(row, 'retention', 'a build') === 'ephemeral' ? 'ephemeral' : 'durable',\n    verdicts,\n    decided: decisions.size,\n    pending,\n    coverage,\n    ...(branch !== undefined ? { branch } : {}),\n    ...(intent !== undefined ? { intent } : {}),\n  };\n}\n\n/**\n * The current decision per subject, from an append-only table.\n *\n * `MAX(seq)` rather than `MAX(at_ms)`: two decisions can share a millisecond, and\n * a tie broken arbitrarily would show a reviewer their earlier answer as the\n * current one. The sequence is the order the rows were written and cannot tie.\n */\nexport async function latestDecisions(\n  db: D1Like,\n  project: string,\n  build: string,\n): Promise<ReadonlyMap<string, DecisionRecord>> {\n  const rows = await db\n    .prepare(\n      `SELECT d.subject, d.decision, d.decided_by, d.note, d.at\n         FROM decisions d\n         JOIN (SELECT subject, MAX(seq) AS seq FROM decisions\n                WHERE project = ? AND build = ? GROUP BY subject) latest\n           ON latest.seq = d.seq`,\n    )\n    .bind(project, build)\n    .all<Row>();\n\n  const decisions = new Map<string, DecisionRecord>();\n  for (const row of rows.results) {\n    const note = optionalText(row, 'note', 'a decision');\n    decisions.set(text(row, 'subject', 'a decision'), {\n      decision: text(row, 'decision', 'a decision') === 'approved' ? 'approved' : 'rejected',\n      by: text(row, 'decided_by', 'a decision'),\n      at: text(row, 'at', 'a decision'),\n      ...(note !== undefined ? { note } : {}),\n    });\n  }\n  return decisions;\n}\n\n/**\n * The docket: one entry per cause component, with collateral counted.\n *\n * Ranked by cause pixels rather than by total area, because area measures\n * *displacement* — a container that only reflowed outranks the component that was\n * edited, measured at 6× on one edit. Collateral is summed into the entry rather\n * than listed, so one token change across 300 subjects is one review item with a\n * count.\n */\nexport function docket(subjects: readonly SubjectView[]): readonly Cause[] {\n  const causes = new Map<string, { file?: string; subjects: Set<string>; pixels: number }>();\n  let collateral = 0;\n\n  for (const subject of subjects) {\n    for (const region of subject.regions) {\n      if (!region.cause) {\n        collateral += region.pixels;\n        continue;\n      }\n      const name = region.component ?? '(unattributed)';\n      const entry = causes.get(name) ?? { subjects: new Set<string>(), pixels: 0 };\n      entry.pixels += region.pixels;\n      entry.subjects.add(subject.subject);\n      if (entry.file === undefined && region.file !== undefined) entry.file = region.file;\n      causes.set(name, entry);\n    }\n  }\n\n  return [...causes.entries()]\n    .map(([component, entry]) => ({\n      component,\n      subjects: [...entry.subjects].sort(),\n      pixels: entry.pixels,\n      // The same total on every entry, and deliberately so: collateral is a\n      // property of the build, not of one cause. Splitting it between causes\n      // would require deciding which edit pushed which box around, which is\n      // exactly the attribution the semantic tier declined to claim.\n      collateralPixels: collateral,\n      ...(entry.file !== undefined ? { file: entry.file } : {}),\n    }))\n    .sort((left, right) => {\n      const byPixels = right.pixels - left.pixels;\n      if (byPixels !== 0) return byPixels;\n      return left.component < right.component ? -1 : left.component > right.component ? 1 : 0;\n    });\n}\n\nexport function toSubjectView(row: Row, decision: DecisionRecord | null): SubjectView {\n  const what = 'a build subject';\n  const truncated = optionalText(row, 'truncated', what);\n  const missingFonts = optionalText(row, 'missing_fonts', what);\n  const findings = optionalText(row, 'findings', what);\n  const signals = optionalText(row, 'signals', what);\n  const ignored = optionalText(row, 'ignored', what);\n  const relaxed = optionalText(row, 'relaxed', what);\n  const moved = optionalText(row, 'moved', what);\n  const after = optionalText(row, 'after_key', what);\n  const width = row['candidate_width'];\n  const height = row['candidate_height'];\n  const wasWide = row['baseline_width'];\n  const wasTall = row['baseline_height'];\n\n  return {\n    subject: text(row, 'subject', what),\n    verdict: text(row, 'verdict', what) as ObservationRecord['verdict'],\n    because: text(row, 'because', what),\n    changedPixels: number(row, 'changed_pixels', what),\n    regions: JSON.parse(text(row, 'regions', what)) as RegionRecord[],\n    has: {\n      before: optionalText(row, 'before_key', what) !== undefined,\n      after: after !== undefined,\n      diff: optionalText(row, 'diff_key', what) !== undefined,\n    },\n    approvable:\n      after !== undefined && optionalText(row, 'candidate_document_digest', what) !== undefined,\n    decision,\n    ...(truncated !== undefined\n      ? { truncated: JSON.parse(truncated) as { regions: number; pixels: number } }\n      : {}),\n    ...(missingFonts !== undefined ? { missingFonts: JSON.parse(missingFonts) as string[] } : {}),\n    ...(findings !== undefined ? { findings: JSON.parse(findings) as FindingRecord[] } : {}),\n    ...(signals !== undefined\n      ? { signals: JSON.parse(signals) as ObservationRecord['signals'] }\n      : {}),\n    // Absent stays absent. A row written before step 10, or by a run whose\n    // config declared nothing, says nothing here — and a `{}` invented in its\n    // place would tell a reader a rule absorbed nothing.\n    ...(ignored !== undefined\n      ? { ignored: JSON.parse(ignored) as ObservationRecord['ignored'] }\n      : {}),\n    ...(relaxed !== undefined\n      ? { relaxed: JSON.parse(relaxed) as ObservationRecord['relaxed'] }\n      : {}),\n    ...(moved !== undefined ? { moved: JSON.parse(moved) as ObservationRecord['moved'] } : {}),\n    ...(typeof width === 'number' && typeof height === 'number' ? { size: { width, height } } : {}),\n    ...(typeof wasWide === 'number' && typeof wasTall === 'number'\n      ? { baseline: { width: wasWide, height: wasTall } }\n      : {}),\n  };\n}\n\n/**\n * A stored variation, read back as the record the report wrote.\n *\n * Every optional field stays optional. `identical` is the one worth naming: the\n * column is nullable and `NULL` is read as absent rather than as `false`, because\n * a pair nothing compared and a pair compared and found to differ are different\n * claims, and only the second is something a reviewer can act on.\n *\n * `how` is narrowed rather than cast. A row holding a word this deployment does\n * not know is read as *unstated* — the sentence in `because` still says what\n * happened, and asserting `declared` over an unrecognised value would put \"a\n * person said so\" on an inference.\n */\nexport function toVariation(row: Row): VariationRecord {\n  const what = 'a build variation';\n  const parent = optionalText(row, 'parent', what);\n  const identical = row['identical'];\n  const bands = optionalText(row, 'bands', what);\n  const unobserved = optionalText(row, 'unobserved', what);\n  const components = optionalText(row, 'components', what);\n  const digest = optionalText(row, 'digest', what);\n  const how = optionalText(row, 'how', what);\n\n  return {\n    subject: text(row, 'subject', what),\n    because: text(row, 'because', what),\n    ...(parent !== undefined ? { parent } : {}),\n    ...(identical === null || identical === undefined ? {} : { identical: Number(identical) !== 0 }),\n    ...(bands !== undefined ? { bands: JSON.parse(bands) as string[] } : {}),\n    ...(unobserved !== undefined ? { unobserved: JSON.parse(unobserved) as string[] } : {}),\n    ...(components !== undefined ? { components: JSON.parse(components) as string[] } : {}),\n    ...(digest !== undefined ? { digest } : {}),\n    ...(how === 'declared' || how === 'named' ? { how } : {}),\n  };\n}\n\n/**\n * The reach rows, read back as the section the page draws.\n *\n * The one rule worth stating: `whole` present means `subjects` stays *absent*,\n * even though the query returned an empty list either way. A refusal rendered as\n * an empty attribution reads as \"this commit reaches none of your subjects\",\n * which is the sentence somebody merges on — and it is the opposite of what the\n * row says.\n */\nexport function toReach(row: Row, subjects: readonly Row[]): ReachView {\n  const what = 'a build reach';\n  const whole = optionalText(row, 'whole', what);\n  const unscanned = optionalText(row, 'unscanned', what);\n  const opaque = optionalText(row, 'opaque', what);\n\n  const attributed: Record<string, SubjectReach> = {};\n  for (const entry of subjects) {\n    const because = 'a reached subject';\n    const through = optionalText(entry, 'through', because);\n    const trail = optionalText(entry, 'trail', because);\n    attributed[text(entry, 'subject', because)] = {\n      reached: Number(entry['reached']) !== 0,\n      through: through === undefined ? [] : (JSON.parse(through) as string[]),\n      because: text(entry, 'because', because),\n      ...(trail === undefined ? {} : { trail: JSON.parse(trail) as string[] }),\n    };\n  }\n\n  return {\n    against: text(row, 'against_ref', what),\n    changed: JSON.parse(text(row, 'changed', what)) as string[],\n    components: JSON.parse(text(row, 'components', what)) as ReachedComponent[],\n    ...(whole === undefined ? { subjects: attributed } : { whole }),\n    ...(unscanned === undefined ? {} : { unscanned: JSON.parse(unscanned) as string[] }),\n    ...(opaque === undefined ? {} : { opaque: JSON.parse(opaque) as ReachHole[] }),\n  };\n}\n\n/**\n * One census row, read back as an edge a sentence can be built from.\n *\n * No shape checking beyond the parse, for the reason `toReach` gives: the\n * columns were written from a typed value by `ingest`.\n */\nexport function toPlacement(row: Row): Placement {\n  const what = 'a composition entry';\n  return {\n    component: text(row, 'component', what),\n    subjects: JSON.parse(text(row, 'subjects', what)) as string[],\n    within: JSON.parse(text(row, 'within', what)) as string[],\n    createdBy: JSON.parse(text(row, 'created_by', what)) as string[],\n    renders: JSON.parse(text(row, 'renders', what)) as string[],\n  };\n}\n\n/**\n * One attributed movement, read back as the run wrote it.\n *\n * `cause` is narrowed by comparison against the five rungs rather than cast. It\n * is the only column here a later schema could widen, and a row carrying a rung\n * this build does not know is a row it must refuse rather than print.\n */\nexport function toMovement(row: Row): MovementView {\n  const what = 'a movement';\n  const cause = text(row, 'cause', what);\n  if (!RUNGS.includes(cause as MovementView['cause'])) {\n    throw new ReviewError(`${what} carries a cause this build does not know: \"${cause}\"`);\n  }\n\n  const file = optionalText(row, 'file', what);\n  const tokens = optionalText(row, 'tokens', what);\n  const upstream = optionalText(row, 'upstream', what);\n  const through = optionalText(row, 'through', what);\n  const standing = optionalText(row, 'standing', what);\n  const compared = optionalNumber(row, 'compared', what);\n\n  return {\n    subject: text(row, 'subject', what),\n    component: text(row, 'component', what),\n    cause: cause as MovementView['cause'],\n    because: text(row, 'because', what),\n    bands: JSON.parse(text(row, 'bands', what)) as string[],\n    held: JSON.parse(text(row, 'held', what)) as string[],\n    ...(compared === undefined ? {} : { compared }),\n    ...(file === undefined ? {} : { file }),\n    ...(tokens === undefined ? {} : { tokens: JSON.parse(tokens) as string[] }),\n    ...(upstream === undefined ? {} : { upstream }),\n    ...(through === undefined ? {} : { through: JSON.parse(through) as string[] }),\n    ...(standing === undefined ? {} : { standing: standing === 'flake' ? 'flake' : 'suspect' }),\n  };\n}\n\nconst RUNGS: readonly MovementView['cause'][] = [\n  'edited',\n  'token',\n  'upstream',\n  'contradicted',\n  'unexplained',\n];\n\n// Named, not defaulted-to-`failed`. The stored word is the run's conclusion, and\n// anything the reader does not recognise is a hole in this reader — which is\n// what `failed` says — rather than in the run.\nconst NOT_OBSERVED: readonly NotObserved['kind'][] = ['excluded', 'unreached', 'failed'];\n\nexport function toNotObserved(row: Row): NotObserved {\n  const what = 'a not-observed entry';\n  const kind = text(row, 'kind', what);\n  return {\n    subject: text(row, 'subject', what),\n    kind: NOT_OBSERVED.find((known) => known === kind) ?? 'failed',\n    because: text(row, 'because', what),\n  };\n}\n\n/**\n * The declaration ledgers, read back whole or read back as absent.\n *\n * No shape checking beyond the parse, and that is the same trade `toReach` makes:\n * the column was written from a typed value by `ingest`, and a reader that\n * re-validated it would be a second opinion about a shape this repository owns.\n * What it does refuse is turning a missing column into an empty ledger.\n */\nexport function toDeclarations(row: Row): Declarations {\n  const ignores = optionalText(row, 'ignores', 'a build');\n  const sensitivities = optionalText(row, 'sensitivities', 'a build');\n  return {\n    ignores: ignores === undefined ? null : (JSON.parse(ignores) as IgnoreLedger),\n    sensitivities:\n      sensitivities === undefined ? null : (JSON.parse(sensitivities) as SensitivityLedger),\n  };\n}\n\nfunction countOf(rows: readonly Row[], kind: string): number {\n  const found = rows.find((row) => row['kind'] === kind);\n  return found === undefined ? 0 : number(found, 'n', 'a coverage count');\n}\n"]}

package/dist/review-rows.d.ts

@@ -0,0 +1,30 @@
+/**
+ * How a review operation says no, and every value that can make it say so.
+ *
+ * `ReviewError` is a leaf on purpose: the store, the reader and the writer all
+ * throw it, and a class everything imports cannot live in a file that imports
+ * them back. The readers sit with it because they are where most of these
+ * refusals come from — a stored row is validated rather than cast, for the same
+ * reason [`history-rows.ts`](./history-rows.ts) does it — and `instant` is that
+ * refusal applied to a timestamp on the way in rather than to a column on the way
+ * out.
+ */
+/**
+ * A review operation that cannot be carried out, as distinct from a platform
+ * that could not be reached.
+ *
+ * Separate from `RasterStoreError` because they route differently: this is a 4xx
+ * — the caller asked for something that is not so — and a store failure is a 5xx
+ * and a stopped run. A single error type would make an operator's dashboard show
+ * "Cloudflare is down" for a reviewer who clicked approve on the wrong subject.
+ */
+export declare class ReviewError extends Error {
+    readonly name = "ReviewError";
+}
+export type Row = Record<string, unknown>;
+export declare function text(row: Row, column: string, what: string): string;
+export declare function optionalText(row: Row, column: string, what: string): string | undefined;
+export declare function optionalNumber(row: Row, column: string, what: string): number | undefined;
+export declare function number(row: Row, column: string, what: string): number;
+export declare function instant(at: string, what: string): number;
+//# sourceMappingURL=review-rows.d.ts.map

package/dist/review-rows.js

@@ -0,0 +1,67 @@
+/**
+ * How a review operation says no, and every value that can make it say so.
+ *
+ * `ReviewError` is a leaf on purpose: the store, the reader and the writer all
+ * throw it, and a class everything imports cannot live in a file that imports
+ * them back. The readers sit with it because they are where most of these
+ * refusals come from — a stored row is validated rather than cast, for the same
+ * reason [`history-rows.ts`](./history-rows.ts) does it — and `instant` is that
+ * refusal applied to a timestamp on the way in rather than to a column on the way
+ * out.
+ */
+/**
+ * A review operation that cannot be carried out, as distinct from a platform
+ * that could not be reached.
+ *
+ * Separate from `RasterStoreError` because they route differently: this is a 4xx
+ * — the caller asked for something that is not so — and a store failure is a 5xx
+ * and a stopped run. A single error type would make an operator's dashboard show
+ * "Cloudflare is down" for a reviewer who clicked approve on the wrong subject.
+ */
+export class ReviewError extends Error {
+    name = 'ReviewError';
+}
+export function text(row, column, what) {
+    const value = row[column];
+    if (typeof value !== 'string') {
+        throw new ReviewError(`${what} has a \`${column}\` that is not text`);
+    }
+    return value;
+}
+export function optionalText(row, column, what) {
+    const value = row[column];
+    if (value === null || value === undefined)
+        return undefined;
+    if (typeof value !== 'string') {
+        throw new ReviewError(`${what} has a \`${column}\` that is neither text nor null`);
+    }
+    return value;
+}
+export function optionalNumber(row, column, what) {
+    const value = row[column];
+    if (value === null || value === undefined)
+        return undefined;
+    if (typeof value === 'bigint')
+        return Number(value);
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new ReviewError(`${what} has a \`${column}\` that is neither a number nor null`);
+    }
+    return value;
+}
+export function number(row, column, what) {
+    const value = row[column];
+    if (typeof value === 'bigint')
+        return Number(value);
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new ReviewError(`${what} has a \`${column}\` that is not a number`);
+    }
+    return value;
+}
+export function instant(at, what) {
+    const parsed = Date.parse(at);
+    if (Number.isNaN(parsed)) {
+        throw new ReviewError(`${what} carries "${at}", which is not an ISO-8601 instant`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=review-rows.js.map

package/dist/review-rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-rows.js","sourceRoot":"","sources":["../src/review-rows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;GAQG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAClB,IAAI,GAAG,aAAa,CAAC;CACxC;AAID,MAAM,UAAU,IAAI,CAAC,GAAQ,EAAE,MAAc,EAAE,IAAY;IACzD,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,WAAW,CAAC,GAAG,IAAI,YAAY,MAAM,qBAAqB,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAQ,EAAE,MAAc,EAAE,IAAY;IACjE,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,WAAW,CAAC,GAAG,IAAI,YAAY,MAAM,kCAAkC,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAQ,EAAE,MAAc,EAAE,IAAY;IACnE,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,WAAW,CAAC,GAAG,IAAI,YAAY,MAAM,sCAAsC,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAQ,EAAE,MAAc,EAAE,IAAY;IAC3D,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,WAAW,CAAC,GAAG,IAAI,YAAY,MAAM,yBAAyB,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,EAAU,EAAE,IAAY;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC9B,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,WAAW,CAAC,GAAG,IAAI,aAAa,EAAE,qCAAqC,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["/**\n * How a review operation says no, and every value that can make it say so.\n *\n * `ReviewError` is a leaf on purpose: the store, the reader and the writer all\n * throw it, and a class everything imports cannot live in a file that imports\n * them back. The readers sit with it because they are where most of these\n * refusals come from — a stored row is validated rather than cast, for the same\n * reason [`history-rows.ts`](./history-rows.ts) does it — and `instant` is that\n * refusal applied to a timestamp on the way in rather than to a column on the way\n * out.\n */\n\n/**\n * A review operation that cannot be carried out, as distinct from a platform\n * that could not be reached.\n *\n * Separate from `RasterStoreError` because they route differently: this is a 4xx\n * — the caller asked for something that is not so — and a store failure is a 5xx\n * and a stopped run. A single error type would make an operator's dashboard show\n * \"Cloudflare is down\" for a reviewer who clicked approve on the wrong subject.\n */\nexport class ReviewError extends Error {\n  override readonly name = 'ReviewError';\n}\n\nexport type Row = Record<string, unknown>;\n\nexport function text(row: Row, column: string, what: string): string {\n  const value = row[column];\n  if (typeof value !== 'string') {\n    throw new ReviewError(`${what} has a \\`${column}\\` that is not text`);\n  }\n  return value;\n}\n\nexport function optionalText(row: Row, column: string, what: string): string | undefined {\n  const value = row[column];\n  if (value === null || value === undefined) return undefined;\n  if (typeof value !== 'string') {\n    throw new ReviewError(`${what} has a \\`${column}\\` that is neither text nor null`);\n  }\n  return value;\n}\n\nexport function optionalNumber(row: Row, column: string, what: string): number | undefined {\n  const value = row[column];\n  if (value === null || value === undefined) return undefined;\n  if (typeof value === 'bigint') return Number(value);\n  if (typeof value !== 'number' || !Number.isFinite(value)) {\n    throw new ReviewError(`${what} has a \\`${column}\\` that is neither a number nor null`);\n  }\n  return value;\n}\n\nexport function number(row: Row, column: string, what: string): number {\n  const value = row[column];\n  if (typeof value === 'bigint') return Number(value);\n  if (typeof value !== 'number' || !Number.isFinite(value)) {\n    throw new ReviewError(`${what} has a \\`${column}\\` that is not a number`);\n  }\n  return value;\n}\n\nexport function instant(at: string, what: string): number {\n  const parsed = Date.parse(at);\n  if (Number.isNaN(parsed)) {\n    throw new ReviewError(`${what} carries \"${at}\", which is not an ISO-8601 instant`);\n  }\n  return parsed;\n}\n"]}