import { renderPublicCampaignSummary } from "./public-summary-image.js";
import { execFile } from "node:child_process";
import { promisify } from "node:util";
import { mkdtemp, mkdir, readFile, rm, writeFile } from "node:fs/promises";
import os from "node:os";
import path from "node:path";
import { afterEach, describe, expect, it } from "vitest";
import { runnerMatrix } from "./catalog.js";
import { discoverReportCatalog } from "./report-catalog.js";
import { buildRunnerCampaign } from "./history.js";
import { renderRunnerE2EDashboard } from "./dashboard.js";
import { regenerateRunnerDashboard } from "./dashboard-regenerate.js";
import { journeyCapabilities } from "./journey-features.js";
import type { RunnerE2EResult } from "./types.js";
const temporary: string[] = [];
afterEach(async () => {
await Promise.all(
temporary.splice(0).map((dir) => rm(dir, { recursive: true, force: true })),
);
});
const id = "branch-only-chat.branch-provider.local.conversation";
const missingId = "branch-only-chat.branch-provider.local.reset";
function result(): RunnerE2EResult {
return {
schema: "paperclip.runner-e2e.result/v2",
executionId: id,
suiteId: "branch-only-chat",
suiteDefinitionHash: "branch-definition",
profileId: "branch-provider",
environmentId: "local",
caseId: "conversation",
provider: '
',
model: "branch-model",
runtimeMode: "native",
attempt: 1,
status: "passed",
cleanup: "passed",
durationMs: 1000,
startedAt: "2026-09-11T21:00:00.000Z",
finishedAt: "2026-09-11T21:00:01.000Z",
screenshots: [
{
id: "final-state",
label: '',
file: "final-state.png",
publication: "public-runner-fixture",
},
],
};
}
function campaign(results: RunnerE2EResult[] = [result()]) {
return buildRunnerCampaign({
campaignId: "branch-campaign",
generatedAt: "2026-09-11T21:01:00.000Z",
expected: [id, missingId],
results,
});
}
describe("trusted report catalog discovery", () => {
it("shows only the campaign selection while retaining a missing selected result", () => {
const known = runnerMatrix.find((execution) => execution.id === "core-compatibility.legacy-codex.local.ask-question")!;
const missing = runnerMatrix.find((execution) => execution.id === "core-compatibility.legacy-codex.local.message-marker")!;
const page = renderRunnerE2EDashboard({
title: "Narrow campaign", generatedAt: "2026-10-20T12:00:00Z",
expected: [known.id, missing.id], catalog: runnerMatrix,
entries: [{ result: { ...result(), executionId: known.id, suiteId: known.suite.id,
profileId: known.profile.id, environmentId: known.environment.id, caseId: known.task.id }, valid: true, errors: [] }],
});
expect(page).toContain(`data-execution-id="${known.id}"`);
expect(page).toContain(`data-execution-id="${missing.id}"`);
expect(page).toContain('class="case case-missing"');
expect(page).not.toContain('id="suite-first-task"');
expect(page).not.toContain('data-report-profile="runner-copilot"');
expect(page).not.toContain('class="suite-nav"');
expect(page.match(/data-report-case\s/g)).toHaveLength(2);
expect(page).toContain('data-report-features="questions-and-approvals"');
expect(page).toContain('title="questions-and-approvals/questions"');
expect(page).toContain("No mapped journey");
expect(page).toContain("0/1 passed · 1 missing");
});
it("leaves an unfamiliar journey unmapped even when its case name matches", () => {
const known = runnerMatrix.find((execution) => execution.id === "core-compatibility.legacy-codex.local.ask-question")!;
expect(journeyCapabilities(known).map((capability) => capability.id)).toEqual(["questions-and-approvals/questions"]);
expect(journeyCapabilities({ ...known, suite: { ...known.suite, id: "branch-only" } })).toEqual([]);
const product = { ...known, suite: { ...known.suite, id: "product-journeys" } };
expect(journeyCapabilities(product).map(capability => capability.id)).toEqual(["questions-and-approvals/questions"]);
expect(journeyCapabilities({ ...product, task: { ...known.task, id: "task-create" } }).map(capability => capability.id)).toEqual(["tasks/create"]);
});
it("aggregates unknown suites and renders their cases, missing results, and screenshot gallery", () => {
const summary = campaign();
expect(summary.suites).toEqual([
expect.objectContaining({
suiteId: "branch-only-chat",
selected: 2,
executed: 1,
passed: 1,
failed: 1,
complete: false,
}),
]);
const page = renderRunnerE2EDashboard({
title: "Report",
generatedAt: summary.generatedAt,
expected: summary.expected,
catalog: [],
campaign: summary,
entries: [
{
result: result(),
valid: true,
errors: [],
evidenceBaseHref: `evidence/${id}/attempt-1`,
evidenceFiles: ["final-state.png"],
},
],
});
expect(page).toContain('id="suite-branch-only-chat"');
expect(page).toContain('class="suite-summary"');
expect(page).toContain(`data-execution-id="${id}"`);
expect(page).toContain(`data-execution-id="${missingId}"`);
expect(page).toContain('class="case case-missing"');
expect(page).toContain("No result artifact was uploaded");
expect(page).toContain(
`data-gallery-href="evidence/${id}/attempt-1/final-state.png"`,
);
expect(page).toContain("View gallery · 1");
expect(page).toContain("<img src=x onerror="alert(1)">");
expect(page).not.toContain("
alert("label")');
});
it("renders selected branch suites in the public summary image without provider content", () => {
const page = renderPublicCampaignSummary(campaign());
expect(page).toContain("1/2");
expect(page).toContain("branch-only-chat");
expect(page).not.toContain("0/0");
expect(page).not.toContain("onerror");
expect(page).not.toContain("branch-model");
});
it("retains ordinary catalog metadata and marks no-results branch selections failed", () => {
const catalog = discoverReportCatalog({
catalog: runnerMatrix,
expected: [runnerMatrix[0]!.id],
results: [],
});
expect(catalog).toEqual(runnerMatrix);
expect(catalog[0]).toBe(runnerMatrix[0]);
expect(campaign([])).toMatchObject({
selected: 2,
executed: 0,
passed: 0,
failed: 2,
suites: [
expect.objectContaining({ suiteId: "branch-only-chat", failed: 2 }),
],
});
});
it("uses known profile metadata in a new suite and rejects forged identities", () => {
const known = runnerMatrix[0]!;
const knownProfileId = `branch-only-chat.${known.profile.id}.${known.environment.id}.conversation`;
expect(
discoverReportCatalog({
catalog: runnerMatrix,
expected: [knownProfileId],
results: [],
}).at(-1)?.profile,
).toBe(known.profile);
expect(() =>
discoverReportCatalog({
catalog: [],
expected: [id],
results: [{ ...result(), suiteId: "forged-suite" }],
}),
).toThrow("Result identity does not match");
expect(() =>
discoverReportCatalog({
catalog: [],
expected: ["../../private"],
results: [],
}),
).toThrow("Invalid report execution identity");
expect(() =>
discoverReportCatalog({ catalog: [], expected: [id, id], results: [] }),
).toThrow("must be unique");
});
it("keeps the suite's profile when another suite uses the same profile ID", () => {
const known = runnerMatrix[0]!;
const other = {
...known,
id: `other-suite.shared-profile.${known.environment.id}.existing-case`,
suite: { ...known.suite, id: "other-suite" },
profile: { ...known.profile, id: "shared-profile", model: "other-model" },
};
const selected = {
...other,
id: `selected-suite.shared-profile.${known.environment.id}.existing-case`,
suite: { ...known.suite, id: "selected-suite" },
profile: { ...other.profile, label: "Selected profile", model: "selected-model" },
};
const executionId = `selected-suite.shared-profile.${known.environment.id}.new-case`;
const discovered = discoverReportCatalog({
catalog: [other, selected],
expected: [executionId],
results: [{ ...result(), executionId, suiteId: "selected-suite", profileId: "shared-profile",
environmentId: known.environment.id, caseId: "new-case", provider: selected.profile.provider, model: selected.profile.model }],
}).find(execution => execution.id === executionId);
expect(discovered?.profile).toBe(selected.profile);
expect(discovered?.profile.model).toBe("selected-model");
});
it("matches a new suite's profile by both recorded provider and model", () => {
const known = runnerMatrix[0]!;
const selected = {
...known,
id: `known-suite.shared-profile.${known.environment.id}.existing-case`,
suite: { ...known.suite, id: "known-suite" },
profile: { ...known.profile, id: "shared-profile", provider: "selected-provider", model: "selected-model" },
};
const executionId = `branch-only-chat.shared-profile.${known.environment.id}.conversation`;
const discovered = discoverReportCatalog({
catalog: [
{ ...selected, id: `wrong-model.shared-profile.${known.environment.id}.existing-case`, suite: { ...known.suite, id: "wrong-model" }, profile: { ...selected.profile, model: "other-model" } },
{ ...selected, id: `wrong-provider.shared-profile.${known.environment.id}.existing-case`, suite: { ...known.suite, id: "wrong-provider" }, profile: { ...selected.profile, provider: "other-provider" } },
selected,
],
expected: [executionId],
results: [{ ...result(), executionId, profileId: "shared-profile", environmentId: known.environment.id,
provider: "selected-provider", model: "selected-model" }],
}).find(execution => execution.id === executionId);
expect(discovered?.profile).toBe(selected.profile);
});
it.each([
null, [], { title: 12 }, { description: false }, { notes: "not an array" },
{ notes: [42] }, { links: "not an array" }, { links: [null] },
{ links: [{ label: "Missing destination" }] }, { links: [{ href: "provenance.json" }] },
])("rejects malformed presentation metadata before rewriting retained measurements (%#)", async presentation => {
const bundle = await mkdtemp(path.join(os.tmpdir(), "branch-report-invalid-presentation-"));
temporary.push(bundle);
const file = path.join(bundle, "normalized-results.json");
const retained = JSON.stringify({ ...campaign(), presentation });
await writeFile(file, retained);
await expect(regenerateRunnerDashboard({ bundle, historyFile: null })).rejects.toThrow("invalid presentation metadata");
expect(await readFile(file, "utf8")).toBe(retained);
await expect(readFile(path.join(bundle, "index.html"), "utf8")).rejects.toMatchObject({ code: "ENOENT" });
});
it("regenerates branch-only cards and gallery from persisted JSON using trusted code", async () => {
const bundle = await mkdtemp(
path.join(os.tmpdir(), "branch-report-regenerate-"),
);
temporary.push(bundle);
const evidence = path.join(bundle, "evidence", id, "attempt-1");
await mkdir(evidence, { recursive: true });
await writeFile(path.join(evidence, "final-state.png"), "fixture");
await writeFile(
path.join(bundle, "normalized-results.json"),
JSON.stringify({ ...campaign([{ ...result(), targetUrl: "https://qa.example.test", matcherResults: [{ matcher: { kind: "json_path", path: "saved", expected: true }, passed: true, detail: "Saved after reload" }] }]), suites: [], presentation: { title: "QA basics", notes: ["Original measurement retained"], links: [{ label: "Provenance", href: "provenance.json" }, { label: "Unsafe destination", href: "javascript:alert(1)" }] } }),
);
await regenerateRunnerDashboard({ bundle, historyFile: null });
const page = await readFile(path.join(bundle, "index.html"), "utf8");
expect(page).toContain('data-gallery-target-url="https://qa.example.test/"');
expect(page).toContain('href="https://qa.example.test/" target="_blank"');
expect(page).toContain("Saved after reload");
expect(page).toContain("Original measurement retained");
expect(page).toContain('Provenance');
expect(page).not.toContain("javascript:alert(1)");
expect(page).not.toContain("Unsafe destination");
expect(page).toContain(`data-execution-id="${id}"`);
expect(page).toContain(`data-execution-id="${missingId}"`);
expect(page).toContain(
`data-gallery-href="evidence/${id}/attempt-1/final-state.png"`,
);
const normalized = JSON.parse(
await readFile(path.join(bundle, "normalized-results.json"), "utf8"),
);
expect(normalized.presentation).toEqual({ title: "QA basics", notes: ["Original measurement retained"], links: [{ label: "Provenance", href: "provenance.json" }, { label: "Unsafe destination", href: "javascript:alert(1)" }] });
expect(normalized.results[0].targetUrl).toBe("https://qa.example.test");
expect(normalized.suites).toEqual([
expect.objectContaining({
suiteId: "branch-only-chat",
selected: 2,
passed: 1,
failed: 1,
}),
]);
});
it("generates an explicit failed result with the correct unknown identity when no artifact exists", async () => {
const root = await mkdtemp(
path.join(os.tmpdir(), "branch-report-missing-"),
);
temporary.push(root);
const out = path.join(root, "merged");
const repo = path.resolve(import.meta.dirname, "../..");
await promisify(execFile)(
process.execPath,
[
path.join(repo, "cli/node_modules/tsx/dist/cli.mjs"),
path.join(repo, "tests/runner-e2e/report.ts"),
],
{
cwd: repo,
env: {
...process.env,
PAPERCLIP_RUNNER_E2E_REPORT_ROOT: root,
PAPERCLIP_RUNNER_E2E_REPORT_OUT: out,
PAPERCLIP_RUNNER_E2E_EXPECTED_IDS: JSON.stringify([missingId]),
},
},
).catch((error: { code?: number }) => {
if (error.code !== 1) throw error;
});
const normalized = JSON.parse(
await readFile(path.join(out, "normalized-results.json"), "utf8"),
);
expect(normalized.results).toEqual([
expect.objectContaining({
executionId: missingId,
suiteId: "branch-only-chat",
profileId: "branch-provider",
caseId: "reset",
attempt: 0,
status: "failed",
}),
]);
expect(normalized.suites).toEqual([
expect.objectContaining({
suiteId: "branch-only-chat",
failed: 1,
executed: 0,
}),
]);
expect(await readFile(path.join(out, "index.html"), "utf8")).toContain(
`data-execution-id="${missingId}"`,
);
});
it.each([
"1/../../../escape",
"
",
-1,
1.5,
Infinity,
])("rejects malformed attempts before report staging: %s", (attempt) => {
expect(() =>
campaign([{ ...result(), attempt } as RunnerE2EResult]),
).toThrow("result.attempt");
});
it("validates nested timing and billing fields before rendering", () => {
const malicious = {
...result(),
turnTimings: [{ turn: "" }],
} as unknown as RunnerE2EResult;
expect(() => campaign([malicious])).toThrow("result.turnTimings[0].turn");
const measured = campaign().results[0]!;
expect(() =>
campaign([
{
...measured,
billing: {
...measured.billing!,
llm: {
...measured.billing!.llm,
runCount: "
" as unknown as number,
},
},
},
]),
).toThrow("result.billing.llm.runCount");
});
it("does not certify a same-sized replacement matrix or changed suite definition", () => {
const known = runnerMatrix.filter(
(entry) => entry.suite.id === runnerMatrix[0]!.suite.id,
);
const receipts = known.map((entry) => ({
...result(),
executionId: entry.id,
suiteId: entry.suite.id,
suiteDefinitionHash: entry.suiteDefinitionHash,
profileId: entry.profile.id,
environmentId: entry.environment.id,
caseId: entry.task.id,
}));
const build = (results: RunnerE2EResult[]) =>
buildRunnerCampaign({
campaignId: "matrix-proof",
generatedAt: result().finishedAt,
expected: results.map((item) => item.executionId),
results,
});
expect(build(receipts).suites[0]!.complete).toBe(true);
const replacement = receipts.map((item, index) =>
index
? item
: {
...item,
caseId: "replacement",
executionId: item.executionId.replace(/[^.]+$/, "replacement"),
},
);
expect(build(replacement).suites[0]!.complete).toBe(false);
expect(
build(
receipts.map((item) => ({
...item,
suiteDefinitionHash: "different-definition",
})),
).suites[0]!.complete,
).toBe(false);
});
});