engineering-behavior-observatory 0.2.1

package/dist/src/atlas-grafana.d.ts

@@ -0,0 +1,377 @@
+import { type AtlasView } from "./atlas.js";
+/** Native Grafana panels backed by the maintained Infinity JSON data source. */
+export declare function atlasDashboards(view: AtlasView, atlasUrl?: string): {
+    uid: string;
+    title: string;
+    schemaVersion: number;
+    version: number;
+    editable: boolean;
+    tags: string[];
+    timezone: string;
+    refresh: string;
+    time: {
+        from: string;
+        to: string;
+    };
+    description: string;
+    templating: {
+        list: ({
+            name: "q";
+            label: string;
+            type: string;
+            query: string;
+            current: {
+                text: string;
+                value: string;
+            };
+            multi?: undefined;
+            includeAll?: undefined;
+            allValue?: undefined;
+            options?: undefined;
+        } | {
+            name: "task" | "model" | "harness" | "outcome" | "capture" | "trial" | "review" | "category" | "assessment";
+            label: "task" | "model" | "harness" | "outcome" | "capture" | "trial" | "review" | "category" | "assessment";
+            type: string;
+            query: string;
+            multi: boolean;
+            includeAll: boolean;
+            allValue: string;
+            current: {
+                text: string;
+                value: string;
+            };
+            options: {
+                text: string;
+                value: string;
+                selected: boolean;
+            }[];
+        })[];
+    };
+    links: ({
+        type: string;
+        title: string;
+        url: string;
+        targetBlank: boolean;
+        includeVars?: undefined;
+    } | {
+        type: string;
+        title: string;
+        url: string;
+        includeVars: boolean;
+        targetBlank?: undefined;
+    })[];
+    panels: ({
+        id: number;
+        type: string;
+        title: string;
+        gridPos: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        };
+        options: {
+            mode: string;
+            content: string;
+            showHeader?: undefined;
+            cellHeight?: undefined;
+            orientation?: undefined;
+            showValue?: undefined;
+            stacking?: undefined;
+            legend?: undefined;
+        };
+        datasource?: undefined;
+        transformations?: undefined;
+        targets?: undefined;
+        fieldConfig?: undefined;
+        description?: undefined;
+    } | {
+        id: number;
+        type: string;
+        title: string;
+        gridPos: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        };
+        datasource: {
+            type: string;
+            uid: string;
+        };
+        transformations: {
+            id: string;
+            options: {
+                indexByName: {
+                    [k: string]: number;
+                };
+            };
+        }[];
+        targets: {
+            refId: string;
+            datasource: {
+                type: string;
+                uid: string;
+            };
+            type: string;
+            source: string;
+            url: string;
+            url_options: {
+                method: string;
+                data: string;
+                headers: never[];
+                params: never[];
+            };
+            parser: string;
+            format: string;
+            root_selector: string;
+            columns: {
+                selector: string;
+                text: string;
+                type: string;
+            }[];
+        }[];
+        fieldConfig: {
+            defaults: {
+                custom: {
+                    inspect: boolean;
+                    filterable: boolean;
+                    width: number;
+                    axisWidth?: undefined;
+                };
+                links: {
+                    title: string;
+                    url: string;
+                    targetBlank: boolean;
+                }[];
+                unit?: undefined;
+                min?: undefined;
+            };
+            overrides: never[];
+        };
+        options: {
+            showHeader: boolean;
+            cellHeight: string;
+            mode?: undefined;
+            content?: undefined;
+            orientation?: undefined;
+            showValue?: undefined;
+            stacking?: undefined;
+            legend?: undefined;
+        };
+        description?: undefined;
+    } | {
+        id: number;
+        type: string;
+        title: string;
+        description: string;
+        gridPos: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        };
+        datasource: {
+            type: string;
+            uid: string;
+        };
+        targets: {
+            refId: string;
+            datasource: {
+                type: string;
+                uid: string;
+            };
+            type: string;
+            source: string;
+            url: string;
+            url_options: {
+                method: string;
+                data: string;
+                headers: never[];
+                params: never[];
+            };
+            parser: string;
+            format: string;
+            root_selector: string;
+            columns: {
+                selector: string;
+                text: string;
+                type: string;
+            }[];
+        }[];
+        options: {
+            orientation: string;
+            showValue: string;
+            stacking: string;
+            legend: {
+                showLegend: boolean;
+            };
+            mode?: undefined;
+            content?: undefined;
+            showHeader?: undefined;
+            cellHeight?: undefined;
+        };
+        fieldConfig: {
+            defaults: {
+                unit: string;
+                min: number;
+                custom: {
+                    axisWidth: number;
+                    inspect?: undefined;
+                    filterable?: undefined;
+                    width?: undefined;
+                };
+                links?: undefined;
+            };
+            overrides: never[];
+        };
+        transformations?: undefined;
+    } | {
+        id: number;
+        type: string;
+        title: string;
+        gridPos: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        };
+        datasource: {
+            type: string;
+            uid: string;
+        };
+        targets: {
+            refId: string;
+            datasource: {
+                type: string;
+                uid: string;
+            };
+            type: string;
+            source: string;
+            url: string;
+            url_options: {
+                method: string;
+                data: string;
+                headers: never[];
+                params: never[];
+            };
+            parser: string;
+            format: string;
+            root_selector: string;
+            columns: {
+                selector: string;
+                text: string;
+                type: string;
+            }[];
+        }[];
+        transformations: {
+            id: string;
+            options: {
+                indexByName: {
+                    [k: string]: number;
+                };
+            };
+        }[];
+        fieldConfig: {
+            defaults: {
+                custom: {
+                    filterable: boolean;
+                    width: number;
+                    inspect?: undefined;
+                    axisWidth?: undefined;
+                };
+                links?: undefined;
+                unit?: undefined;
+                min?: undefined;
+            };
+            overrides: never[];
+        };
+        options: {
+            showHeader: boolean;
+            cellHeight: string;
+            mode?: undefined;
+            content?: undefined;
+            orientation?: undefined;
+            showValue?: undefined;
+            stacking?: undefined;
+            legend?: undefined;
+        };
+        description?: undefined;
+    } | {
+        id: number;
+        type: string;
+        title: string;
+        gridPos: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        };
+        datasource: {
+            type: string;
+            uid: string;
+        };
+        transformations: {
+            id: string;
+            options: {
+                indexByName: {
+                    [k: string]: number;
+                };
+            };
+        }[];
+        targets: {
+            refId: string;
+            datasource: {
+                type: string;
+                uid: string;
+            };
+            type: string;
+            source: string;
+            url: string;
+            url_options: {
+                method: string;
+                data: string;
+                headers: never[];
+                params: never[];
+            };
+            parser: string;
+            format: string;
+            root_selector: string;
+            columns: {
+                selector: string;
+                text: string;
+                type: string;
+            }[];
+        }[];
+        fieldConfig: {
+            defaults: {
+                custom: {
+                    filterable: boolean;
+                    width: number;
+                    inspect?: undefined;
+                    axisWidth?: undefined;
+                };
+                links: {
+                    title: string;
+                    url: string;
+                    targetBlank: boolean;
+                }[];
+                unit?: undefined;
+                min?: undefined;
+            };
+            overrides: never[];
+        };
+        options: {
+            showHeader: boolean;
+            cellHeight: string;
+            mode?: undefined;
+            content?: undefined;
+            orientation?: undefined;
+            showValue?: undefined;
+            stacking?: undefined;
+            legend?: undefined;
+        };
+        description?: undefined;
+    })[];
+}[];
+export declare function writeAtlasGrafana(outputRoot: string, view: AtlasView): Promise<void>;

package/dist/src/atlas-grafana.js

@@ -0,0 +1,47 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { ATLAS_FILTERS } from "./atlas.js";
+/** Native Grafana panels backed by the maintained Infinity JSON data source. */
+export function atlasDashboards(view, atlasUrl = view.atlasUrl ?? "http://127.0.0.1:13011") {
+    const query = ATLAS_FILTERS.map((key) => `${key}=\${${key}:percentencode}`).join("&");
+    const datasource = { type: "yesoreyeram-infinity-datasource", uid: "ebo-atlas-derived" };
+    const organize = (names) => [{ id: "organize", options: { indexByName: Object.fromEntries(names.map((name, index) => [name, index])) } }];
+    const variables = ATLAS_FILTERS.map((name) => name === "q" ? { name, label: "Search case evidence", type: "textbox", query: "", current: { text: "", value: "" } } : {
+        name, label: name, type: "custom", query: (view.filterOptions[name] ?? []).map((value) => value.replaceAll(",", "\\,")).join(","),
+        multi: false, includeAll: true, allValue: "$__all", current: { text: "All", value: "$__all" },
+        options: [{ text: "All", value: "$__all", selected: true }, ...(view.filterOptions[name] ?? []).map((value) => ({ text: value, value, selected: false }))],
+    });
+    const target = (path, columns) => ({ refId: "A", datasource, type: "json", source: "url", url: `${atlasUrl}${path}?${query}`, url_options: { method: "GET", data: "", headers: [], params: [] }, parser: "backend", format: "table", root_selector: "", columns: columns.map((selector) => ({ selector, text: selector, type: ["numerator", "denominator", "count"].includes(selector) ? "number" : "string" })) });
+    return ["overview", "behavior"].map((kind) => ({
+        uid: `ebo-atlas-${kind}`, title: `EBO | ${kind === "overview" ? "Cohort overview" : "Behavior Atlas"}`, schemaVersion: 39, version: 1, editable: false,
+        tags: ["ebo", "derived", "restricted-local"], timezone: "utc", refresh: "", time: { from: "now-1h", to: "now" },
+        description: "Rebuildable EBO-derived cohort queries. Not a live capture monitor. No composite score or causal inference.",
+        templating: { list: variables },
+        links: [{ type: "link", title: "Evidence workbench / export cohort report", url: `${atlasUrl}/?${query}`, targetBlank: true }, { type: "link", title: kind === "overview" ? "Behavior Atlas" : "Cohort overview", url: `/d/ebo-atlas-${kind === "overview" ? "behavior" : "overview"}`, includeVars: true }],
+        panels: [
+            { id: 1, type: "text", title: "Evidence and population boundaries", gridPos: { x: 0, y: 0, w: 24, h: 4 }, options: { mode: "markdown", content: "### EBO · Research workbench\nNative evidence remains authoritative. Filters select attempts through matching cases; all judgments on selected attempts remain in metrics. **Proposed is not human-confirmed.** Numerators, denominators and exclusions are shown together. The Grafana time picker affects Tempo only, not the frozen EBO cohort. Use the evidence workbench for review lineage, cited records and standalone report/PDF export." } },
+            { id: 2, type: "table", title: kind === "overview" ? "Selected cohort metrics · exact counts and exclusions" : "Confirmed behavior distributions · opposite assessments remain separate", gridPos: { x: 0, y: 4, w: 24, h: 13 }, datasource,
+                transformations: organize(kind === "overview" ? ["group", "metric", "status", "numerator", "denominator", "unit", "exclusions", "cohortDigest"] : ["group", "category", "assessment", "numerator", "denominator", "status", "exclusions", "dimension", "unit", "rubric", "evaluator", "vocabulary", "cohortDigest"]),
+                targets: [target(kind === "overview" ? "/api/metrics" : "/api/behaviors", kind === "overview" ? ["group", "metric", "status", "numerator", "denominator", "unit", "exclusions", "cohortDigest"] : ["group", "category", "dimension", "rubric", "evaluator", "assessment", "status", "numerator", "denominator", "unit", "exclusions", "cohortDigest"])],
+                fieldConfig: { defaults: { custom: { inspect: true, filterable: true, width: 150 }, links: [{ title: "Inspect selected cohort evidence", url: `${atlasUrl}/?${query}`, targetBlank: true }] }, overrides: [] }, options: { showHeader: true, cellHeight: "sm" } },
+            ...(kind === "behavior" ? [{ id: 4, type: "barchart", title: "Confirmed assessment counts · denominators and exclusions in table above", description: "Counts, not model quality scores. Unavailable values remain null. Exact populations and exclusions are in the behavior table.", gridPos: { x: 0, y: 17, w: 24, h: 10 }, datasource, targets: [target("/api/behavior-chart", ["label", "count"])], options: { orientation: "horizontal", showValue: "always", stacking: "none", legend: { showLegend: false } }, fieldConfig: { defaults: { unit: "short", min: 0, custom: { axisWidth: 180 } }, overrides: [] } }] : []),
+            { id: 5, type: "table", title: "Comparison eligibility · unsupported pairs are unavailable", gridPos: { x: 0, y: kind === "behavior" ? 27 : 17, w: 24, h: 8 }, datasource,
+                targets: [target("/api/comparisons", ["comparison", "measure", "status", "numerator", "denominator", "unit", "exclusions", "limitations"])], transformations: organize(["comparison", "measure", "status", "numerator", "denominator", "unit", "exclusions", "limitations"]),
+                fieldConfig: { defaults: { custom: { filterable: true, width: 150 } }, overrides: [] }, options: { showHeader: true, cellHeight: "sm" } },
+            { id: 3, type: "table", title: "Searchable cases · inspect in Atlas", gridPos: { x: 0, y: kind === "behavior" ? 35 : 25, w: 24, h: 10 }, datasource,
+                transformations: organize(["runId", "attemptId", "model", "harness", "assessment", "review", "task", "trial", "category", "href"]),
+                targets: [target("/api/cases", ["runId", "attemptId", "model", "harness", "task", "trial", "category", "assessment", "review", "href"])],
+                fieldConfig: { defaults: { custom: { filterable: true, width: 150 }, links: [{ title: "Open case and cited evidence", url: "${__data.fields.href}", targetBlank: true }] }, overrides: [] }, options: { showHeader: true, cellHeight: "sm" } },
+        ],
+    }));
+}
+export async function writeAtlasGrafana(outputRoot, view) {
+    const root = join(outputRoot, "grafana");
+    for (const directory of ["dashboards", "provisioning/dashboards", "provisioning/datasources"])
+        await mkdir(join(root, directory), { recursive: true, mode: 0o700 });
+    for (const dashboard of atlasDashboards(view))
+        await writeFile(join(root, "dashboards", `${dashboard.uid}.json`), JSON.stringify(dashboard, null, 2), { mode: 0o600 });
+    await writeFile(join(root, "provisioning/dashboards/atlas.yaml"), "apiVersion: 1\nproviders:\n  - name: ebo-atlas\n    folder: EBO Atlas\n    type: file\n    disableDeletion: true\n    options:\n      path: ${EBO_ATLAS_DASHBOARDS}\n", { mode: 0o600 });
+    await writeFile(join(root, "provisioning/datasources/atlas.yaml"), `apiVersion: 1\ndatasources:\n  - name: EBO Atlas derived data\n    uid: ebo-atlas-derived\n    type: yesoreyeram-infinity-datasource\n    access: proxy\n    editable: false\n    jsonData:\n      allowedHosts:\n        - ${view.atlasUrl ?? "http://127.0.0.1:13011"}\n`, { mode: 0o600 });
+    await writeFile(join(root, "grafana.ini"), `[server]\nhttp_addr = 127.0.0.1\nhttp_port = ${new URL(view.grafanaUrl ?? "http://127.0.0.1:13010").port || "80"}\n[auth.anonymous]\nenabled = true\norg_role = Viewer\n[auth]\ndisable_login_form = true\n[analytics]\nreporting_enabled = false\ncheck_for_updates = false\ncheck_for_plugin_updates = false\n[plugins]\npreinstall_disabled = true\npreinstall_auto_update = false\n`, { mode: 0o600 });
+}

package/dist/src/atlas-html.d.ts

@@ -0,0 +1,2 @@
+import { type AtlasView } from "./atlas.js";
+export declare function renderAtlas(view: AtlasView, interactive: boolean): string;

package/dist/src/atlas-html.js

@@ -0,0 +1,34 @@
+import { ATLAS_FILTERS, atlasBehaviorPartitions } from "./atlas.js";
+import { escapeHtml } from "./human-calibration.js";
+const h = (value) => escapeHtml(value ?? "");
+const title = (value) => value.replaceAll("-", " ");
+const pretty = (value) => h(JSON.stringify(value, null, 2));
+const badge = (value) => `<span class="badge ${["constructive", "adverse", "mixed", "context-dependent", "confirmed", "disputed", "rejected", "abstained", "proposed", "unavailable", "insufficient-evidence"].includes(value) ? value : ""}">${h(title(value))}</span>`;
+export function renderAtlas(view, interactive) {
+    const query = new URLSearchParams(view.filters).toString();
+    const control = interactive ? `<form action="/" method="get" aria-label="Select cohort"><div class="filters">${ATLAS_FILTERS.filter((key) => key !== "q").map((key) => `<label>${h(title(key))}<select name="${key}"><option value="">All ${h(key)}</option>${(view.filterOptions[key] ?? []).map((value) => `<option value="${h(value)}"${view.filters[key] === value ? " selected" : ""}>${h(value)}</option>`).join("")}</select></label>`).join("")}<label class="search">Search case evidence<input name="q" type="search" value="${h(view.filters.q ?? "")}" placeholder="Run, task, category or rationale"></label></div><div class="actions"><button type="submit">Apply cohort</button><a href="/">Clear filters</a><span>Filters select attempts through matching cases. Metrics retain every judgment on selected attempts.</span></div></form>` : `<p class="frozen">Frozen cohort · ${Object.entries(view.filters).map(([key, value]) => `${h(key)}: ${h(value)}`).join(" · ") || "All source attempts"}. Rebuild or use the local workbench to change populations.</p>`;
+    const metricRows = view.report.groups.flatMap((group) => group.metrics.filter(({ id }) => !id.startsWith("structural:")).map((metric) => `<tr><th scope="row">${h(title(metric.id))}<small>${h(metric.population)} population · ${h(Object.values(group.dimensions).join(" / ") || "Selected cohort")}</small></th>${measurement(metric.measurement, metric.id.endsWith("-rate"))}</tr>`)).join("");
+    const structuralRows = view.report.groups.flatMap((group) => group.metrics.filter(({ id }) => id.startsWith("structural:")).map((metric) => `<tr><th scope="row">${h(title(metric.id))}<small>${h(Object.values(group.dimensions).join(" / "))}</small></th>${measurement(metric.measurement)}</tr>`)).join("");
+    const comparisons = view.report.comparisons.map((comparison) => `<tr><th scope="row">${h(comparison.id)}<small>${h(comparison.measure)}</small></th>${measurement(comparison.matchedDifference)}<td>${badge(comparison.claimStatus)}<small>${h(comparison.limitations.join(" "))}</small></td></tr>`).join("");
+    const behaviorGroups = atlasBehaviorPartitions(view).map(({ group, partition }) => `<figure><figcaption><strong>${h(group)} · ${h(partition.behavior.categoryId)}</strong><small>${h(partition.behavior.dimensionId)} · vocabulary ${h(partition.behavior.vocabularyVersion)} · rubric ${h(partition.rubric.id)} ${h(partition.rubric.version)} · evaluator ${h(partition.evaluator.id)} ${h(partition.evaluator.version)}</small></figcaption>${partition.assessments.map(({ assessment, measurement: measure }) => `<div class="distribution">${badge(assessment)} ${measure.status === "available" ? `<meter min="0" max="${measure.denominator.value}" value="${measure.numerator.value}" aria-label="${h(assessment)}: ${measure.numerator.value} of ${measure.denominator.value} ${h(measure.denominator.unit)}"></meter><span>${measure.numerator.value} / ${measure.denominator.value}</span>` : badge("unavailable")}</div>`).join("")}<div class="tablewrap"><table><caption>${h(partition.population)} population · exact counts and exclusions</caption><thead><tr><th>Assessment</th><th>Numerator</th><th>Denominator</th><th>Rate / status</th><th>Exclusions</th></tr></thead><tbody>${partition.assessments.map(({ assessment, measurement: measure }) => `<tr><th>${h(assessment)}</th>${measurement(measure, true)}</tr>`).join("")}</tbody></table></div><details><summary>Source assertions and evaluator bindings</summary><pre>${pretty({ evaluator: partition.evaluator, rubric: partition.rubric, assertions: partition.assertions })}</pre></details></figure>`).join("");
+    const exports = interactive ? `<a class="button secondary" href="/report.html?${h(query)}" target="_blank" rel="noopener">Open cohort report</a><a href="/report.json?${h(query)}" download="atlas-report.json">JSON</a><a href="/report.html?${h(query)}&amp;share=true" target="_blank" rel="noopener">Approved shareable report</a>` : `<button type="button" id="print">Print / save PDF</button>`;
+    return `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta name="referrer" content="no-referrer"><title>${h(view.title)} · Behavior Atlas</title><style>${CSS}</style></head><body>
+<a class="skip" href="#main">Skip to research results</a><header><a class="brand" href="#main">EBO <span>Engineering Behavior Observatory</span></a><div>${badge(view.mode)}<span class="edition">ATLAS / 01</span></div></header>
+<main id="main"><section class="intro"><div><p class="eyebrow">Evidence before interpretation</p><h1>${h(view.title)}</h1><p class="dek">A research workbench for outcomes, behavioral judgments, and the evidence that supports them.</p></div><nav class="exports" aria-label="Report exports">${exports}${view.grafanaUrl ? `<a href="${h(view.grafanaUrl)}/d/ebo-atlas-overview">Grafana overview ↗</a>` : ""}</nav></section>
+<p class="boundary">${view.mode === "restricted-local-only" ? "Restricted local inspection. Semantic judgments are proposals until an explicit human decision confirms them. This report is not approved for sharing." : "Sanitized approved summary. Semantic findings, human prose, native records, operator narrative and local links are excluded."}</p>
+${control}<section class="population" aria-label="Selected population"><div><strong>${view.report.sourcePopulation.uniqueRuns}</strong><span>distinct runs</span></div><div><strong>${view.report.sourcePopulation.selectedAttempts}<em> / ${view.report.sourcePopulation.uniqueAttempts}</em></strong><span>selected / cohort attempts</span></div><div><strong>${view.matchingCases ?? "Unavailable"}</strong><span>matching evidence cases</span></div><div><strong>${view.filteredOutAttempts}<em> / ${view.sourceAttempts}</em></strong><span>attempts excluded by filters / source</span></div></section><p class="empty">Attempt policy excludes ${view.policyExcludedAttempts} / ${view.sourceAttempts} source attempts before case filters. No earlier attempt substitutes for a filtered-out latest retry.</p>
+<section><div class="sectionhead"><h2>01 <span>Observed outcomes</span></h2><p>Counts, units, and eligible populations stay visible.</p></div><div class="tablewrap"><table><caption>Selected cohort metrics from EBO aggregation</caption><thead><tr><th scope="col">Measure / group</th><th scope="col">Numerator</th><th scope="col">Denominator</th><th scope="col">Rate or status</th><th scope="col">Exclusions</th></tr></thead><tbody>${metricRows || '<tr><td colspan="5">No attempts match this cohort. Metrics are unavailable; an empty denominator is not zero performance.</td></tr>'}</tbody></table></div></section>
+${structuralRows ? `<details><summary>Inspect structural measurements and missing capabilities</summary><div class="tablewrap"><table><caption>Structural counts and per-attempt means; ratios with different units are not percentages</caption><thead><tr><th>Measure / group</th><th>Numerator</th><th>Denominator</th><th>Mean or status</th><th>Exclusions</th></tr></thead><tbody>${structuralRows}</tbody></table></div></details>` : ""}
+<section><div class="sectionhead"><h2>02 <span>Behavior &amp; human review</span></h2><p>Opposite assessments remain separate; confidence is evaluator reported.</p></div><div class="legend">${["constructive", "adverse", "mixed", "context-dependent", "proposed", "confirmed", "disputed", "rejected", "abstained", "unavailable"].map(badge).join(" ")}</div>${behaviorGroups || '<p class="empty">Confirmed behavior distributions are unavailable for this cohort or input version.</p>'}<p>Case filters select attempts, not a favorable subset of judgments. Proposed, rejected, disputed and abstained cases are inspectable; they do not become confirmed findings.</p><div class="tablewrap"><table><caption>Matching cases · expand a row for evidence and review lineage</caption><thead><tr><th scope="col">Attempt / condition</th><th scope="col">Assessment</th><th scope="col">Review</th><th scope="col">Evidence</th></tr></thead><tbody>${view.cases.map((item) => caseRow(item, !interactive)).join("") || '<tr><td colspan="4">No matching cases. Native evidence may be absent, or excluded from this sharing mode.</td></tr>'}</tbody></table></div></section>
+<section><div class="sectionhead"><h2>03 <span>Comparison boundaries</span></h2><p>Eligibility gates govern every matched difference.</p></div><div class="tablewrap"><table><caption>Matched comparisons; no causal or significance claims</caption><thead><tr><th>Comparison</th><th>Numerator</th><th>Denominator</th><th>Rate or status</th><th>Exclusions</th><th>Claim / limits</th></tr></thead><tbody>${comparisons || '<tr><td colspan="6">Comparison unavailable: no matched, measure-bound comparison request is configured.</td></tr>'}</tbody></table></div></section>
+${view.operatorNarrative ? `<section class="narrative"><p class="eyebrow">Operator-authored narrative · not inferred by EBO</p><h2>Research notes</h2><p>${h(view.operatorNarrative).replaceAll("\n", "<br>")}</p></section>` : ""}
+<section class="method"><div><h2>Method &amp; limitations</h2><ul>${view.report.limitations.map((item) => `<li>${h(item)}</li>`).join("")}<li>Attempt policy: ${h(view.report.policy.selectedAttemptPolicy)}. Recurrence threshold: ${view.report.policy.recurrence.minimumOccurrences}. Duplicate inputs ignored: ${view.report.sourcePopulation.duplicateInputsIgnored}.</li><li>Displayed cited records are sanitized for secrets and hidden fields. Native evidence remains authoritative.</li><li>Trace views use a separate Tempo backend. Original and replay timestamps are identified per linked case; absence of a link means trace viewing is unavailable.</li></ul>${view.reviewPackets.length ? `<h3>Existing human review packets</h3><p>These local-file links open from the standalone report; browsers may block them from HTTP.</p><ul>${view.reviewPackets.map((href, index) => `<li><a href="${h(href)}">Open configured review packet ${index + 1}</a></li>`).join("")}</ul>` : '<p>No human review packet links configured.</p>'}</div><div><h2>Reproducibility record</h2><dl><dt>Generated</dt><dd>${h(view.generatedAt)}</dd><dt>Read model / aggregate version</dt><dd>${h(view.schemaVersion)}<br>${h(view.report.schemaVersion)}</dd><dt>Source digest</dt><dd><code>${h(view.sourceDigest)}</code></dd><dt>Selected cohort digest</dt><dd><code>${h(view.cohortDigest)}</code></dd></dl><details><summary>Exact source digests and version bindings</summary><pre>${pretty(view.report.sourceLineage)}</pre></details></div></section>
+</main><footer>EBO · Native evidence remains authoritative <span>Descriptive research / no composite ranking</span></footer><script>document.getElementById('print')?.addEventListener('click',()=>window.print());</script></body></html>`;
+}
+function measurement(value, percent = false) {
+    return `<td class="number">${value.numerator.value}<small>${h(value.numerator.unit)}</small></td><td class="number">${value.denominator.value}<small>${h(value.denominator.unit)}</small></td><td>${value.status === "unavailable" ? badge("unavailable") : value.rate === undefined ? "Count" : percent ? `${(value.rate * 100).toFixed(1)}%` : `${Number(value.rate.toPrecision(5))}<small>${h(value.numerator.unit)} / ${h(value.denominator.unit)}</small>`}<small>${h(value.reason ?? "")}</small></td><td>${value.exclusions.map(({ reason, count, unit }) => `${count} ${h(unit)}: ${h(reason)}`).join("<br>") || "None"}</td>`;
+}
+function caseRow(item, expanded) {
+    return `<tr id="case-${h(item.key)}"><th scope="row">${h(item.runId)}<small>${h(item.attemptId)}${item.retryOf ? ` · retry of ${h(item.retryOf)}` : ""}<br>${h(item.model)} · ${h(item.harness)} ${h(item.harnessVersion ?? "version unavailable")}<br>${h(item.task)} · trial ${h(item.trial)}<br>${h(item.capture)} · ${h(item.outcome)}</small></th><td>${badge(item.assessment)}<small>${h(item.category)}<br>${h(item.assertion?.behavior.dimensionId)}</small></td><td>${badge(item.review)}</td><td><details${expanded ? " open" : ""}><summary>Inspect ${item.citations.length} citation${item.citations.length === 1 ? "" : "s"}</summary>${item.assertion ? `<h3>Judgment rationale</h3><p>${h(item.assertion.judgment.rationale)}</p><h3>Alternative explanation</h3><p>${h(item.assertion.judgment.alternativeExplanation)}</p><p>${item.assertion.judgment.disposition === "assessed" ? `Evaluator-reported confidence: ${item.assertion.judgment.confidence.value} / 1 (not calibrated probability)` : `Abstention reason: ${h(item.assertion.judgment.reason)}`}</p><p>Vocabulary ${h(item.assertion.behavior.vocabularyVersion)} · rubric ${h(item.assertion.rubric.id)} ${h(item.assertion.rubric.version)} · evaluator ${h(item.assertion.evaluator.id)} ${h(item.assertion.evaluator.version)}</p><code>${h(item.assertionDigest)}</code>` : "<p>Assertion unavailable: no semantic assessment source was supplied.</p>"}${item.citations.map((citation, index) => `<details id="evidence-${h(item.key)}-${index}"><summary>${h(citation.eventId)} · normalized → native</summary><h3>Native reference</h3><pre>${pretty(citation.nativeReference)}</pre><h3>Normalized event</h3><pre>${pretty(citation.normalizedEvent)}</pre><h3>Cited native record · sanitized display</h3><pre>${pretty(citation.nativeRecord)}</pre></details>`).join("")}<h3>Human decision lineage</h3>${item.decisions.length ? `<ul>${item.decisions.map((decision) => `<li>${h(decision.state)} · ${h(decision.reviewer.id)} · ${h(decision.decidedAt)}<br>${h(decision.rationale)}</li>`).join("")}</ul><details><summary>Exact decision lineage (${item.decisions.length} records)</summary><pre>${pretty(item.decisions)}</pre></details>` : "<p>No human decision supplied. This is not human confirmation.</p>"}${item.trace ? `<p><a href="${h(item.trace.href)}" target="_blank" rel="noopener">Open trace in Tempo ↗</a><br>Original: ${h(item.trace.originalStart)}<br>${item.trace.replayStart ? `Replay-shifted: ${h(item.trace.replayStart)}` : "No replay shift declared"}</p>` : '<p>Trace backend/link unavailable.</p>'}</details></td></tr>`;
+}
+const CSS = `:root{color-scheme:light;--paper:#f7f5ef;--ink:#202b2c;--muted:#526568;--line:#d3d8d0;--accent:#116a68}*{box-sizing:border-box}body{margin:0;background:var(--paper);color:var(--ink);font:15px/1.55 'Avenir Next',Avenir,'Segoe UI',sans-serif}a{color:#095e63;text-underline-offset:3px}button,.button{font:inherit;cursor:pointer;background:var(--accent);color:white;border:1px solid var(--accent);border-radius:3px;padding:9px 14px;text-decoration:none}button:hover,.button:hover{background:#084c4b}a:focus-visible,button:focus-visible,input:focus-visible,select:focus-visible,summary:focus-visible{outline:3px solid #b44b13;outline-offset:3px}header,footer{padding:20px 4vw;display:flex;justify-content:space-between;border-bottom:1px solid var(--line);gap:20px}.brand{font-weight:800;letter-spacing:.13em;text-decoration:none;color:var(--ink)}.brand span{font-size:12px;letter-spacing:.02em;font-weight:400;margin-left:15px}.edition{font:11px monospace;margin-left:18px}main{max-width:1500px;margin:auto;padding:24px 4vw 60px}.intro{display:flex;align-items:center;justify-content:space-between;gap:45px;margin:22px 0}.eyebrow{text-transform:uppercase;letter-spacing:.14em;font-size:11px;color:var(--accent);font-weight:700}h1{font:400 clamp(36px,4vw,60px)/1.08 Georgia,'Times New Roman',serif;max-width:850px;letter-spacing:-.035em;margin:14px 0 20px}.dek{max-width:680px;color:var(--muted);font-size:17px}.exports{display:flex;align-items:center;gap:13px;flex-wrap:wrap;max-width:260px;font-size:13px}.boundary{border-left:3px solid #9a6c27;background:#efeadd;padding:12px 16px;font-size:13px}.filters{display:grid;grid-template-columns:repeat(5,minmax(120px,1fr));gap:12px;margin-top:25px}label{display:grid;gap:5px;font-size:12px;text-transform:capitalize;color:var(--muted)}input,select{font:14px inherit;width:100%;min-height:40px;background:#fffef9;color:var(--ink);border:1px solid #9caeaa;border-radius:3px;padding:8px}.search{grid-column:span 2}.actions{display:flex;align-items:center;gap:18px;margin:16px 0;font-size:13px}.actions span{max-width:650px;color:var(--muted)}.population{display:grid;grid-template-columns:repeat(4,1fr);border-top:2px solid var(--ink);border-bottom:1px solid var(--line);margin:28px 0 38px;padding:20px 0}.population>div{padding:0 20px;border-right:1px solid var(--line)}.population>div:first-child{padding-left:0}.population>div:last-child{border:0}.population strong{display:block;font:38px Georgia,serif;font-variant-numeric:tabular-nums}.population em{font:20px Georgia,serif;color:var(--muted)}.population span{font-size:12px;color:var(--muted)}section{margin-bottom:30px}.sectionhead{display:flex;justify-content:space-between;align-items:baseline;gap:20px}.sectionhead h2{font:13px monospace;color:var(--accent);white-space:nowrap}.sectionhead h2 span{font:26px Georgia,serif;color:var(--ink);margin-left:15px}.sectionhead p{font-size:12px;color:var(--muted)}.tablewrap{overflow-x:auto;border-top:1px solid var(--ink)}table{width:100%;border-collapse:collapse;text-align:left;font-size:13px}caption{text-align:left;padding:12px 0;color:var(--muted);font-size:12px}th,td{vertical-align:top;padding:13px 12px;border-bottom:1px solid var(--line);overflow-wrap:anywhere}thead th{font-size:10px;letter-spacing:.08em;text-transform:uppercase;color:var(--muted);background:#eeeFE8}tbody th{font-weight:500;min-width:175px}small{display:block;font-size:11px;line-height:1.55;color:var(--muted);font-weight:400;margin-top:4px}.number{font-variant-numeric:tabular-nums;font-size:17px;min-width:110px}td:last-child{min-width:170px}details{margin:5px 0;max-width:720px}summary{cursor:pointer;color:var(--accent);font-size:13px;padding:5px 0}details p{max-width:620px}h3{font-size:13px;margin-bottom:4px}pre{white-space:pre-wrap;overflow-wrap:anywhere;max-height:420px;overflow:auto;background:#eceee8;padding:12px;font:11px/1.6 'SFMono-Regular',Consolas,monospace}code{font:11px/1.5 monospace;overflow-wrap:anywhere}.badge{display:inline-block;white-space:nowrap;background:#e5e9e6;color:#344b4c;border:1px solid #bbc8c2;font-size:10px;line-height:1.5;padding:3px 6px;border-radius:3px;text-transform:uppercase;letter-spacing:.025em}.constructive,.confirmed{color:#195b37;background:#e4f0e3;border-color:#8eb796}.adverse,.rejected{color:#8d261f;background:#fae8df;border-color:#d99d88}.mixed,.disputed{color:#764607;background:#f8efcc;border-color:#c8aa62}.context-dependent,.proposed{color:#245b85;background:#e4edf5;border-color:#91adc4}.abstained,.insufficient-evidence{color:#634579;background:#eee6f0;border-color:#bba3c4}.unavailable{color:#5a5d5b;background:#e8e7e3;border-style:dashed}.distribution{display:grid;grid-template-columns:160px 1fr 70px;gap:12px;align-items:center;max-width:720px;margin:10px 0;font-size:12px}meter::-webkit-meter-optimum-value{background:#42676a}meter{width:100%;height:18px;accent-color:var(--accent)}figure{margin:24px 0;padding:20px;border:1px solid var(--line);background:#fffef9}.legend{display:flex;gap:8px;flex-wrap:wrap;margin-bottom:16px}.empty,.frozen{color:var(--muted);font-size:13px}.narrative{max-width:850px;border-left:3px solid var(--accent);padding:15px 25px}.narrative h2,.method h2{font:26px Georgia,serif}.method{display:grid;grid-template-columns:1.2fr 1fr;gap:60px;margin-top:40px;padding-top:20px;border-top:2px solid var(--ink)}.method li,.method p,dl{font-size:12px;color:var(--muted)}dt{font-weight:700;margin-top:12px}dd{margin:4px 0}.skip{position:absolute;left:-999px}.skip:focus{left:15px;top:15px;background:white;padding:12px}footer{font-size:11px;color:var(--muted);border-top:1px solid var(--line);border-bottom:0}@media screen and (max-width:800px){.intro,.sectionhead{display:block}.exports{max-width:none}.filters{grid-template-columns:repeat(2,minmax(100px,1fr))}.population{grid-template-columns:repeat(2,1fr);gap:20px}.population>div:nth-child(3){padding-left:0}.population>div:nth-child(2){border:0}.method{grid-template-columns:1fr;gap:20px}.brand span,.edition{display:none}.actions{flex-wrap:wrap}.sectionhead p{margin-top:0}header,footer{padding:15px 4vw}.tablewrap table{min-width:650px}}@media print{.narrative{break-inside:avoid}th:nth-child(5),td:nth-child(5){min-width:80pt}h2,h3,caption{break-after:avoid}section{margin-bottom:14px}figure{padding:10px;margin:12px 0;break-inside:avoid}.number{font-size:10pt}small{font-size:7pt}td p,td li{font-size:8pt;line-height:1.3;margin:5px 0}.dek{font-size:11pt}.population strong{font-size:20pt}h3{font-size:8pt;margin:6px 0}body{background:white;font-size:10pt}header{padding:0 0 12px}main{padding:12px 0}form,.exports,.skip{display:none}.intro{margin:10px 0}h1{font-size:32pt}.population{margin:12px 0;padding:12px 0}.tablewrap{overflow:visible}table{font-size:8pt}th,td{padding:7px}thead{display:table-header-group}tr,.population{break-inside:avoid}details{break-inside:auto}.method{gap:20px}.sectionhead h2 span{font-size:20pt}pre{max-height:none;overflow:visible}footer{padding:12px 0}@page{size:A4 landscape;margin:14mm}}`;

package/dist/src/atlas.d.ts

@@ -0,0 +1,130 @@
+import { type Server } from "node:http";
+import { type BehaviorAggregate, type AggregationInput, type AggregationReport, type AggregationRequest } from "./aggregation.js";
+import type { BehaviorAssertion } from "./behavior-assertions.js";
+import { type PortableExportPolicy } from "./exports.js";
+import { type ReviewDecision } from "./human-calibration.js";
+type Digest = `sha256:${string}`;
+export declare const ATLAS_FILTERS: readonly ["model", "harness", "task", "trial", "capture", "outcome", "review", "category", "assessment", "q"];
+export type AtlasFilters = Partial<Record<typeof ATLAS_FILTERS[number], string>>;
+export type AtlasRequest = {
+    schemaVersion: "ebo.atlas-request/v1";
+    aggregationRequest: string;
+    title: string;
+    operatorNarrative?: string;
+    reviewPackets?: readonly string[];
+    traces?: ReadonlyArray<{
+        runId: string;
+        attemptId: string;
+        traceId: string;
+        originalStart: string;
+        replayStart?: string;
+    }>;
+    grafanaUrl?: string;
+    atlasUrl?: string;
+    tempoDatasourceUid?: string;
+    sharing?: {
+        policy: PortableExportPolicy;
+        approvedExports: readonly string[];
+        fields: readonly string[];
+    };
+};
+export type AtlasCase = {
+    key: string;
+    runId: string;
+    attemptId: string;
+    model: string;
+    harness: string;
+    task: string;
+    trial: string;
+    capture: string;
+    outcome: string;
+    review: string;
+    category: string;
+    assessment: string;
+    harnessVersion?: string;
+    assertion?: BehaviorAssertion;
+    assertionDigest?: Digest;
+    decisions: readonly ReviewDecision[];
+    citations: ReadonlyArray<{
+        eventId: string;
+        nativeReference: unknown;
+        normalizedEvent: unknown;
+        nativeRecord: unknown;
+    }>;
+    trace?: {
+        href: string;
+        originalStart: string;
+        replayStart?: string;
+    };
+    retryOf?: string;
+};
+export type AtlasView = {
+    schemaVersion: "ebo.atlas-view/v1";
+    title: string;
+    mode: "restricted-local-only" | "partner" | "public";
+    generatedAt: string;
+    sourceDigest: Digest;
+    cohortDigest: Digest;
+    filters: AtlasFilters;
+    filterOptions: Record<string, string[]>;
+    report: AggregationReport;
+    cases: readonly AtlasCase[];
+    sourceAttempts: number;
+    policyExcludedAttempts: number;
+    filteredOutAttempts: number;
+    matchingCases: number | null;
+    operatorNarrative?: string;
+    reviewPackets: readonly string[];
+    grafanaUrl?: string;
+    atlasUrl?: string;
+};
+export type AtlasSource = {
+    request: AtlasRequest;
+    aggregation: AggregationRequest;
+    input: AggregationInput;
+    corpusRoot: string;
+    requestPath: string;
+    cases: AtlasCase[];
+    sourceDigest: Digest;
+};
+export declare function atlasBehaviorPartitions(view: AtlasView): Array<{
+    group: string;
+    partition: BehaviorAggregate;
+}>;
+export declare function atlasBehaviorRows(view: AtlasView): {
+    group: string;
+    category: string;
+    dimension: string;
+    vocabulary: string;
+    rubric: string;
+    evaluator: string;
+    assessment: "constructive" | "adverse" | "mixed" | "context-dependent";
+    label: string;
+    status: "available" | "unavailable";
+    numerator: number | null;
+    denominator: number;
+    unit: string;
+    exclusions: string;
+    cohortDigest: `sha256:${string}`;
+}[] | {
+    group: string;
+    category: string;
+    dimension: string;
+    vocabulary: string;
+    rubric: string;
+    evaluator: string;
+    assessment: string;
+    label: string;
+    status: string;
+    numerator: null;
+    denominator: number;
+    unit: string;
+    exclusions: string;
+    cohortDigest: `sha256:${string}`;
+}[];
+export declare function loadAtlas(requestPath: string): Promise<AtlasSource>;
+export declare function queryAtlas(source: AtlasSource, filters?: AtlasFilters): Promise<AtlasView>;
+export declare function shareAtlas(source: AtlasSource, view: AtlasView): Promise<AtlasView>;
+export declare function writeAtlas(requestPath: string, outputRoot: string, filters?: AtlasFilters, share?: boolean): Promise<AtlasView>;
+export declare function serveAtlas(requestPath: string, port?: number): Promise<Server>;
+export {};