@dreamdata_io/verify-tracking 0.1.0

package/dist/report/projection.js

@@ -0,0 +1,125 @@
+import { extractLibraries, extractMessageId, formatLibraryBuild } from "../evidence/network.js";
+function compactRequest(request) {
+    const { payload, ...rest } = request;
+    return {
+        ...rest,
+        messageId: extractMessageId(payload),
+        libraries: extractLibraries(payload).map(formatLibraryBuild),
+    };
+}
+function setNames(values) {
+    return Object.entries(values)
+        .filter(([, value]) => value !== null && value !== "")
+        .map(([name]) => name);
+}
+function compactStorage(storage) {
+    return {
+        cookieNames: setNames(storage.values),
+        localStorageNames: setNames(storage.localStorageValues),
+        ajsCookieNames: setNames(storage.ajsValues),
+        ajsLocalStorageNames: setNames(storage.ajsLocalStorageValues),
+        usesAjsCompatPrefix: storage.usesAjsCompatPrefix,
+    };
+}
+/**
+ * `raw` is the whole gtag argument object. Only `analytics_storage` is ever
+ * read from it, and `analyticsStorage` alongside is already that value
+ * resolved; `kind` keeps the one other thing it said — whether this was the
+ * declared default or a visitor's decision.
+ *
+ * The dedupe is belt-and-braces. init-script.ts used to stack a wrapper on
+ * window.dataLayer per re-assignment and report one push up to 13 times; that
+ * is fixed at the source, and this makes a return of it cost nothing here.
+ */
+function compactConsentPushes(pushes) {
+    const seen = new Set();
+    const compact = [];
+    for (const push of pushes) {
+        const key = JSON.stringify(push);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        compact.push({
+            // The typed field first; the reach into `raw` stays as the fallback
+            // because evidence collected before `verb` existed still has to project
+            // to the same `kind` it always did. The name stays `kind` so stored
+            // reports keep their shape.
+            kind: push.verb ?? (Array.isArray(push.raw) && typeof push.raw[1] === "string" ? push.raw[1] : null),
+            analyticsStorage: push.analyticsStorage,
+            region: push.region ?? null,
+            waitForUpdate: push.waitForUpdate ?? null,
+            timestamp: push.timestamp,
+        });
+    }
+    return compact;
+}
+function compactSecondPage(second) {
+    if (!second)
+        return null;
+    return {
+        ...second,
+        network: { ...second.network, requests: second.network.requests.map(compactRequest) },
+        hardLoad: !second.hardLoad
+            ? null
+            : {
+                ...second.hardLoad,
+                network: {
+                    ...second.hardLoad.network,
+                    requests: second.hardLoad.network.requests.map(compactRequest),
+                },
+            },
+        cookies: compactStorage(second.cookies),
+    };
+}
+/**
+ * Spread-and-override rather than a field list: a phase carries a lot that is
+ * already compact, and a new field added to EvidenceReport should reach the
+ * report on its own rather than being silently dropped here until someone
+ * notices.
+ */
+function compactPhase(phase) {
+    return {
+        ...phase,
+        network: {
+            ...phase.network,
+            requests: phase.network.requests.map(compactRequest),
+            // Compacted for the same reason as `requests`, and more urgently: an
+            // unattributed request's payload belongs to whatever tool sent it, so
+            // this file is the last place its raw body should be reproduced.
+            unattributedRequests: phase.network.unattributedRequests.map(compactRequest),
+        },
+        cookies: compactStorage(phase.cookies),
+        consent: {
+            ...phase.consent,
+            dataLayerConsentPushes: compactConsentPushes(phase.consent.dataLayerConsentPushes),
+        },
+        secondPage: compactSecondPage(phase.secondPage),
+    };
+}
+/**
+ * `rawResponse` is the model's unparsed reply, and `verdicts` /
+ * `remediationAdvice` / `overallPass` are what parsing it produced — except
+ * when parsing FAILED. response-parser.ts falls back to inconclusive verdicts
+ * that carry no findings of their own, and there the raw text is the only
+ * record of what the model actually said, so it stays.
+ */
+function compactResult(result) {
+    const { rawResponse, ...rest } = result;
+    return result.parseFailed ? { ...rest, rawResponse } : rest;
+}
+export function projectReport(evidence, analysis, result, meta) {
+    return {
+        slug: meta.slug ?? null,
+        url: evidence.url,
+        timestamp: evidence.timestamp,
+        // Run-level, not per-phase: nothing about what the site serves a plain
+        // HTTP GET varies with consent state. It is the raw form of
+        // deployment.pageReadability, kept so a reader can check the call.
+        httpProbe: evidence.httpProbe,
+        phases: evidence.phases.map(compactPhase),
+        deployment: analysis,
+        result: compactResult(result),
+        timings: meta.timings ?? null,
+    };
+}
+//# sourceMappingURL=projection.js.map

package/dist/report/projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.js","sourceRoot":"","sources":["../../src/report/projection.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AA4EhG,SAAS,cAAc,CAAC,OAAuB;IAC7C,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACrC,OAAO;QACL,GAAG,IAAI;QACP,SAAS,EAAE,gBAAgB,CAAC,OAAO,CAAC;QACpC,SAAS,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,MAAqC;IACrD,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SAC1B,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;SACrD,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,cAAc,CAAC,OAAwB;IAC9C,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;QACrC,iBAAiB,EAAE,QAAQ,CAAC,OAAO,CAAC,kBAAkB,CAAC;QACvD,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC;QAC3C,oBAAoB,EAAE,QAAQ,CAAC,OAAO,CAAC,qBAAqB,CAAC;QAC7D,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;KACjD,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,oBAAoB,CAAC,MAA8B;IAC1D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,CAAC,IAAI,CAAC;YACX,oEAAoE;YACpE,wEAAwE;YACxE,oEAAoE;YACpE,4BAA4B;YAC5B,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACpG,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;YAC3B,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI;YACzC,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAoC;IAC7D,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO;QACL,GAAG,MAAM;QACT,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE;QACrF,QAAQ,EAAE,CAAC,MAAM,CAAC,QAAQ;YACxB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC;gBACE,GAAG,MAAM,CAAC,QAAQ;gBAClB,OAAO,EAAE;oBACP,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO;oBAC1B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC;iBAC/D;aACF;QACL,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC;KACxC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CAAC,KAAqB;IACzC,OAAO;QACL,GAAG,KAAK;QACR,OAAO,EAAE;YACP,GAAG,KAAK,CAAC,OAAO;YAChB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC;YACpD,qEAAqE;YACrE,sEAAsE;YACtE,iEAAiE;YACjE,oBAAoB,EAAE,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC,GAAG,CAAC,cAAc,CAAC;SAC7E;QACD,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC;QACtC,OAAO,EAAE;YACP,GAAG,KAAK,CAAC,OAAO;YAChB,sBAAsB,EAAE,oBAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,sBAAsB,CAAC;SACnF;QACD,UAAU,EAAE,iBAAiB,CAAC,KAAK,CAAC,UAAU,CAAC;KAChD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,MAAqB;IAC1C,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACxC,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,QAA4B,EAC5B,QAA4B,EAC5B,MAAqB,EACrB,IAAgB;IAEhB,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI;QACvB,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,uEAAuE;QACvE,4DAA4D;QAC5D,mEAAmE;QACnE,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC;QACzC,UAAU,EAAE,QAAQ;QACpB,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;KAC9B,CAAC;AACJ,CAAC"}

package/dist/report/quote-check.js

@@ -0,0 +1,90 @@
+/**
+ * Does a verdict's `evidenceQuote` point at something real?
+ *
+ * The model is asked to cite a field path so a reader can check the claim
+ * against the JSON. Whether it did is worth measuring — a cited field that
+ * does not exist means the verdict rests on nothing — but the measurement has
+ * to distinguish two very different failures, and the first version of this
+ * did not:
+ *
+ * A quote naming `grant.network.invented` is a fabrication. A quote reading
+ * "clean-before-consent: fail, reject-blocks-normal: fail" cites real check
+ * ids in prose and fabricates nothing; it simply is not a path. Scoring both
+ * as "hallucinated" made the check unreadable — measured across the golden
+ * set, the trusted cloud baseline scored 2/7 on one account, worse than the
+ * local model it was there to judge.
+ */
+import { valueAtPath } from "./store.js";
+const PHASE_PREFIXES = ["clean", "grant", "reject"];
+/**
+ * Every dotted/bracketed token embedded in free text, e.g. the
+ * "script.writeKey" inside `script.present: true, script.writeKey: "abc"`. A
+ * capable model returns a bare path; a smaller one tends to return prose that
+ * still names real fields, which is not the same failure as inventing one.
+ */
+export function extractPathCandidates(text) {
+    // Brackets hold an index or a name, quoted or bare: `phases[0]`,
+    // `deployment.checks[page-view-counted-once]` and
+    // `deployment.checks['global-handoff']` are all citations, and the last two
+    // are the forms actually used for a cross-phase check — the quoted one by
+    // the model, the bare one by applyDeterministicChecks (see valueAtPath).
+    return [
+        ...new Set(text.match(/\b[a-zA-Z_][\w]*(?:\.[a-zA-Z_][\w]*|\[['"]?[\w.-]+['"]?\])+/g) ?? []),
+    ];
+}
+/**
+ * A path resolves against the analysis when prefixed `deployment.` (the
+ * deterministic overrides quote it that way), against a named phase when
+ * prefixed `clean.`/`grant.`/`reject.`, and otherwise against any phase — the
+ * prompt asks for a phase prefix, but a bare field name that is real evidence
+ * should not be scored the same as an invented one.
+ */
+function lookup(report, candidate) {
+    const phases = Array.isArray(report.phases) ? report.phases : [];
+    if (candidate.startsWith("deployment.")) {
+        return valueAtPath(report.deployment, candidate.slice("deployment.".length));
+    }
+    const [first, ...rest] = candidate.split(".");
+    if (first !== undefined && PHASE_PREFIXES.includes(first) && rest.length > 0) {
+        const phase = phases.find((p) => p?.phase === first);
+        const value = phase ? valueAtPath(phase, rest.join(".")) : undefined;
+        if (value !== undefined)
+            return value;
+    }
+    for (const phase of phases) {
+        const value = valueAtPath(phase, candidate);
+        if (value !== undefined)
+            return value;
+    }
+    return valueAtPath(report.deployment, candidate);
+}
+function resolves(report, candidate) {
+    return lookup(report, candidate) !== undefined;
+}
+/**
+ * Every field path a quote names, with what the report actually holds there.
+ *
+ * A quote is usually prose with paths embedded in it — "script.present: true,
+ * script.writeKey: 'abc'" — so resolving it as one path answers the wrong
+ * question and answers it wrongly. This resolves each path it names, which is
+ * what a reader checking the claim needs anyway.
+ */
+export function resolveCitations(report, quote) {
+    return extractPathCandidates(quote ?? "").map((path) => {
+        const value = lookup(report, path);
+        return { path, resolved: value !== undefined, value: value ?? null };
+    });
+}
+export function checkQuote(report, quote) {
+    const candidates = extractPathCandidates(quote ?? "");
+    if (candidates.length === 0)
+        return "unverifiable";
+    return candidates.some((candidate) => resolves(report, candidate)) ? "resolved" : "invented";
+}
+export function tallyQuotes(report, verdicts) {
+    const tally = { resolved: 0, unverifiable: 0, invented: 0 };
+    for (const verdict of verdicts)
+        tally[checkQuote(report, verdict.evidenceQuote)] += 1;
+    return tally;
+}
+//# sourceMappingURL=quote-check.js.map

package/dist/report/quote-check.js.map

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

package/dist/report/render.js

@@ -0,0 +1,178 @@
+import { causeLabel } from "../analysis/diagnosis/copy.en.js";
+import { formatDuration } from "../utils/duration.js";
+import { buildContextLines, buildRunContextLines } from "./context.js";
+const RESET = "\x1b[0m";
+const GREEN = "\x1b[32m";
+const RED = "\x1b[31m";
+const GRAY = "\x1b[90m";
+const YELLOW = "\x1b[33m";
+const DIAGNOSIS_LABEL_WIDTH = 11;
+const DIAGNOSIS_WRAP_AT = 76;
+/**
+ * Pads to the label column by VISIBLE width.
+ *
+ * A kind label carries colour escapes, and padEnd counts those, so measuring
+ * the raw string left the coloured rows short by however many bytes the
+ * escapes took and knocked the whole block out of alignment.
+ */
+function padLabel(label) {
+    const visible = label.replace(/\x1b\[[0-9;]*m/g, "").length;
+    return label + " ".repeat(Math.max(1, DIAGNOSIS_LABEL_WIDTH - visible));
+}
+/**
+ * Wraps at word boundaries onto a hanging indent, so a long line stays
+ * readable and every value lines up in the same column.
+ *
+ * `gutter` is the first line's indent and `indent` every later line's. They
+ * differ only on a cause's opening row, where the rank number lives in the
+ * gutter — putting the rank inside the label instead pushed the label column
+ * out by a character or two per cause and broke the alignment it exists for.
+ */
+function wrapInto(label, text, indent, gutter = indent) {
+    const lines = [];
+    let current = "";
+    for (const word of text.split(" ")) {
+        if (current.length > 0 && `${current} ${word}`.length > DIAGNOSIS_WRAP_AT) {
+            lines.push(current);
+            current = word;
+        }
+        else {
+            current = current.length === 0 ? word : `${current} ${word}`;
+        }
+    }
+    if (current.length > 0)
+        lines.push(current);
+    return lines.map((line, index) => index === 0 ? `${gutter}${padLabel(label)}${line}` : `${indent}${" ".repeat(DIAGNOSIS_LABEL_WIDTH)}${line}`);
+}
+function kindLabel(kind) {
+    if (kind === "blocking")
+        return `${RED}BLOCKING${RESET}`;
+    if (kind === "leaking")
+        return `${RED}LEAKING${RESET}`;
+    if (kind === "duplicate-counting")
+        return `${YELLOW}DUPLICATE${RESET}`;
+    if (kind === "hardening")
+        return `${YELLOW}HARDENING${RESET}`;
+    return `${GRAY}UNVERIFIED${RESET}`;
+}
+/**
+ * The finding, first.
+ *
+ * On a terminal this is now the whole report: the phase matrix and both
+ * per-check lists used to sit under it and are gone (see renderTextReport),
+ * because the reader this section exists for — a CS or AM person who wants to
+ * know what to tell the customer — was scrolling past thirty rows of detail
+ * that this block has already collapsed into one cause and one fix.
+ *
+ * Every heading, label and note below is the same wording the review
+ * dashboard (verification/review/index.html) prints for the same diagnosis,
+ * so the terminal and the dashboard cannot describe one run two ways. The
+ * terminal adds one row the dashboard has no room for — Explains, the bridge
+ * down to the check list underneath it — and spells the docs link out as
+ * title plus URL, because a terminal has no anchor text.
+ */
+export function renderDiagnosis(diagnosis, unexplainedObservation) {
+    const lines = [];
+    if (diagnosis.causes.length === 0 && diagnosis.unexplainedChecks.length === 0 && !unexplainedObservation) {
+        // The dashboard renders an empty frame as nothing at all; a terminal has
+        // to say something, or the reader cannot tell a healthy run from a
+        // section that failed to print — and with the check lists gone there is
+        // nothing else on screen to read it off.
+        lines.push(diagnosis.hadFailures
+            ? `${YELLOW}What is wrong: checks failed but no catalogued cause matched them.${RESET}`
+            : `${GREEN}Nothing is wrong: every check that could be judged passed.${RESET}`);
+        return lines;
+    }
+    const everyCauseIsHardening = diagnosis.causes.length > 0 && diagnosis.causes.every((cause) => cause.kind === "hardening");
+    const onlyNotAVerdict = diagnosis.causes.length > 0 && diagnosis.causes.every((cause) => cause.kind === "not-a-verdict");
+    lines.push(onlyNotAVerdict
+        ? "Not a verdict about this site"
+        : everyCauseIsHardening
+            ? "Nothing is broken — one thing to harden"
+            : diagnosis.causes.length === 0
+                ? "Unexplained failures"
+                : "What is wrong — ranked, decided in code");
+    const ranked = diagnosis.causes.length > 1;
+    diagnosis.causes.forEach((cause, index) => {
+        // Numbered causes get a wider gutter so the rank sits outside the label
+        // column and every Fix/Docs/Explains value still lines up.
+        const indent = ranked ? "     " : "  ";
+        const gutter = ranked ? `  ${index + 1}. ` : "  ";
+        // The kind sits in the label column, so the problem text lines up with
+        // the Fix and Docs values underneath it.
+        lines.push(...wrapInto(kindLabel(cause.kind), cause.problem, indent, gutter));
+        lines.push(...wrapInto("Fix", cause.fix, indent));
+        lines.push(`${indent}${padLabel("Docs")}${cause.docTitle} — ${cause.docUrl}`);
+        // The check ids the headline rests on. The terminal no longer prints the
+        // check list itself, so these are the handle a reader who does not trust
+        // the one-liner takes to the stored report or the review dashboard.
+        if (cause.explains.length > 0) {
+            lines.push(...wrapInto("Explains", cause.explains.join(", "), indent).map((line) => `${GRAY}${line}${RESET}`));
+        }
+    });
+    if (diagnosis.alsoFired.length > 0) {
+        lines.push(`  ${GRAY}Also found, outside the top three: ${diagnosis.alsoFired.map(causeLabel).join("; ")}${RESET}`);
+    }
+    if (diagnosis.unexplainedChecks.length > 0) {
+        lines.push(`  ${YELLOW}Not explained by any catalogued cause: ${diagnosis.unexplainedChecks.join(", ")} — a gap in the catalog, not a clean bill.${RESET}`);
+    }
+    // Labelled unverified, and visibly separated from the catalogued causes
+    // above: a model sentence must never be mistaken for a decided one. Printed
+    // whenever the run produced one — the dashboard does the same, and gating it
+    // on unexplainedChecks dropped the note on a run whose gap was a cause the
+    // catalog claimed but could not fix.
+    if (unexplainedObservation) {
+        lines.push(...wrapInto("Model's note", unexplainedObservation, "  ").map((line) => `${GRAY}${line}${RESET}`), `  ${GRAY}${" ".repeat(DIAGNOSIS_LABEL_WIDTH)}(unverified, carries no fix or link)${RESET}`);
+    }
+    return lines;
+}
+export function renderTextReport(evidence, analysis, result, timings) {
+    const lines = [];
+    lines.push(`Dreamdata installation check for ${evidence.url}`);
+    lines.push(`Collected ${evidence.timestamp}`);
+    if (timings) {
+        lines.push(`${GRAY}Timing: collect evidence ${formatDuration(timings.collectEvidenceMs)}, analyze deployment ${formatDuration(timings.analyzeDeploymentMs)}, AI check ${formatDuration(timings.checkWithAIMs)}, total ${formatDuration(timings.totalMs)}${RESET}`);
+    }
+    lines.push("");
+    for (const line of buildRunContextLines(evidence, analysis))
+        lines.push(`${GRAY}${line}${RESET}`);
+    lines.push("");
+    for (const line of renderDiagnosis(analysis.diagnosis, result.unexplainedObservation))
+        lines.push(line);
+    lines.push("");
+    // No phase matrix, no per-check list, no checklist: on a run with eighteen
+    // checks and thirteen verdicts they filled a screen and a half with rows
+    // the diagnosis above has already collapsed into one cause and one fix, and
+    // the reader had to scroll past all of it to reach the verdict. Every one
+    // of them is still in the stored report — the markdown export renders the
+    // matrix and both lists, and the review dashboard renders them per check
+    // with the evidence behind a click. This is the terminal's summary view.
+    // A blocked run is not a failing site. Its verdicts are all inconclusive by
+    // then, so printing FAIL under them would be the report contradicting itself
+    // — and the contradiction a reader resolves in the site's disfavour.
+    lines.push(`Overall: ${analysis.pageReadability.unreadable
+        ? `${GRAY}INCONCLUSIVE — the browser was never served this site's page${RESET}`
+        : result.overallPass
+            ? `${GREEN}PASS${RESET}`
+            : `${RED}FAIL${RESET}`}`);
+    // No "Remediation advice" block: the fix for every catalogued cause is
+    // already printed above, decided in code and carrying a real docs link.
+    // The model's free-text version said the same thing less reliably — it is
+    // still stored on the report and still rendered by the dashboard and the
+    // markdown export, just not read out twice here.
+    const collectionErrors = evidence.phases.flatMap((phase) => phase.collectionErrors.map((err) => `${phase.phase}: ${err}`));
+    if (collectionErrors.length > 0) {
+        lines.push("");
+        lines.push(`${GRAY}Collection warnings:${RESET}`);
+        for (const err of collectionErrors)
+            lines.push(`  - ${err}`);
+    }
+    return lines.join("\n");
+}
+/** Per-phase detail, printed only when the operator asks for it (--verbose). */
+export function renderPhaseDetail(evidence) {
+    return evidence.phases
+        .map((phase) => [`${GRAY}${"─".repeat(60)}${RESET}`, ...buildContextLines(phase).map((l) => `${GRAY}${l}${RESET}`)].join("\n"))
+        .join("\n");
+}
+//# sourceMappingURL=render.js.map

package/dist/report/render.js.map

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

package/dist/report/serializers.js

@@ -0,0 +1,124 @@
+import { formatDuration } from "../utils/duration.js";
+import { buildPhaseMatrixRows, buildRunContextLines } from "./context.js";
+import { projectReport } from "./projection.js";
+/**
+ * The report people and models read: every judgement, and the evidence behind
+ * it with the raw values that only fed those judgements taken back out. See
+ * projection.ts for what is dropped and why it is safe to drop.
+ */
+export function serializeToJson(evidence, analysis, result, meta = {}) {
+    return JSON.stringify(projectReport(evidence, analysis, result, meta), null, 2);
+}
+/**
+ * The archive companion to serializeToJson: the same run, nothing trimmed.
+ * cli.ts writes both from one in-memory collection in one step, so the pair on
+ * disk is always ONE run rather than two that happen to share a slug — which is
+ * the whole point of keeping it, since re-running a live site never reproduces
+ * its evidence exactly.
+ */
+export function serializeEvidenceToJson(evidence, analysis, result, meta = {}) {
+    return JSON.stringify({
+        slug: meta.slug ?? null,
+        url: evidence.url,
+        timestamp: evidence.timestamp,
+        browser: evidence.browser,
+        httpProbe: evidence.httpProbe,
+        phases: evidence.phases,
+        deployment: analysis,
+        result,
+        timings: meta.timings ?? null,
+    }, null, 2);
+}
+export function serializeToMarkdown(evidence, analysis, result, meta = {}) {
+    const lines = [];
+    lines.push(`# Dreamdata installation check — ${evidence.url}`);
+    lines.push("");
+    if (meta.slug)
+        lines.push(`Account: \`${meta.slug}\``);
+    lines.push(`Collected: ${evidence.timestamp}`);
+    lines.push(`Overall: **${analysis.pageReadability.unreadable
+        ? "INCONCLUSIVE — the browser was never served this site's page"
+        : result.overallPass
+            ? "PASS"
+            : "FAIL"}**`);
+    if (meta.timings) {
+        const t = meta.timings;
+        lines.push(`Timing: collect evidence ${formatDuration(t.collectEvidenceMs)}, analyze deployment ${formatDuration(t.analyzeDeploymentMs)}, AI check ${formatDuration(t.checkWithAIMs)}, total ${formatDuration(t.totalMs)}`);
+    }
+    lines.push("");
+    // Ahead of the observation context and the matrix, for the same reason the
+    // terminal puts it first: the reader who needs this section should not have
+    // to work through eighteen checks to reach it.
+    if (analysis.diagnosis.causes.length > 0) {
+        lines.push("## What is wrong");
+        lines.push("");
+        lines.push("Ranked root causes, decided in code from the resolved checks — not model-written.");
+        lines.push("");
+        for (const cause of analysis.diagnosis.causes) {
+            lines.push(`### ${cause.kind.toUpperCase()} — ${cause.problem}`);
+            lines.push("");
+            lines.push(`- **Fix:** ${cause.fix}`);
+            lines.push(`- **Docs:** [${cause.docTitle}](${cause.docUrl})`);
+            if (cause.explains.length > 0)
+                lines.push(`- **Explains:** ${cause.explains.map((id) => `\`${id}\``).join(", ")}`);
+            lines.push("");
+        }
+        if (analysis.diagnosis.alsoFired.length > 0) {
+            lines.push(`Also found, outside the top three: ${analysis.diagnosis.alsoFired.join(", ")}`);
+            lines.push("");
+        }
+    }
+    if (analysis.diagnosis.unexplainedChecks.length > 0) {
+        lines.push(`> Not explained by any catalogued cause: ${analysis.diagnosis.unexplainedChecks.map((id) => `\`${id}\``).join(", ")}`);
+        // Marked as the model's, and marked unverified: a sentence nobody decided
+        // must not sit in the same voice as the causes above it.
+        if (result.unexplainedObservation) {
+            lines.push(">");
+            lines.push(`> _Model's note (unverified, no fix or link): ${result.unexplainedObservation}_`);
+        }
+        lines.push("");
+    }
+    lines.push("## Observation context");
+    lines.push("");
+    for (const line of buildRunContextLines(evidence, analysis))
+        lines.push(`- ${line}`);
+    lines.push("");
+    lines.push("## Phase matrix");
+    lines.push("");
+    const [header, ...rows] = buildPhaseMatrixRows(analysis);
+    lines.push(`| ${header.join(" | ")} |`);
+    lines.push(`| ${header.map(() => "---").join(" | ")} |`);
+    for (const row of rows)
+        lines.push(`| ${row.map((cell) => cell.replace(/\|/g, "\\|")).join(" | ")} |`);
+    lines.push("");
+    lines.push("## Consent behaviour (compared across phases)");
+    lines.push("");
+    lines.push("| Check | Status | Detail |");
+    lines.push("| --- | --- | --- |");
+    for (const check of analysis.checks) {
+        lines.push(`| ${check.title} | ${check.status.toUpperCase()} | ${check.detail.replace(/\|/g, "\\|")} |`);
+    }
+    lines.push("");
+    lines.push("## Installation checklist");
+    lines.push("");
+    lines.push("| Item | Status | Feedback |");
+    lines.push("| --- | --- | --- |");
+    for (const verdict of result.verdicts) {
+        const status = verdict.passed === true ? "PASS" : verdict.passed === false ? "FAIL" : String(verdict.passed).toUpperCase();
+        lines.push(`| ${verdict.title} | ${status} | ${verdict.feedback.replace(/\|/g, "\\|")} |`);
+    }
+    if (result.remediationAdvice) {
+        lines.push("");
+        lines.push("## Remediation advice");
+        lines.push(result.remediationAdvice);
+    }
+    const collectionErrors = evidence.phases.flatMap((phase) => phase.collectionErrors.map((err) => `${phase.phase}: ${err}`));
+    if (collectionErrors.length > 0) {
+        lines.push("");
+        lines.push("## Collection warnings");
+        for (const err of collectionErrors)
+            lines.push(`- ${err}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=serializers.js.map

package/dist/report/serializers.js.map

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