lootforge 0.3.0

package/dist/showcase/releaseEvidenceSchema.js

@@ -0,0 +1,165 @@
+import { z } from "zod";
+import { nonEmptyString } from "../shared/schemas.js";
+export const numberOrNullSchema = z.number().nullable();
+export const providerQualitySchema = z.object({
+    targetCount: z.number().int().min(0),
+    passedHardGates: z.number().int().min(0),
+    failedHardGates: z.number().int().min(0),
+    hardErrors: z.number().int().min(0),
+    passRate: numberOrNullSchema,
+    finalScoreMean: numberOrNullSchema,
+    finalScoreMedian: numberOrNullSchema,
+    candidateScoreMean: numberOrNullSchema,
+});
+export const providerCoarseToFineSchema = z.object({
+    enabledJobs: z.number().int().min(0),
+    promotedCandidates: z.number().int().min(0),
+    discardedCandidates: z.number().int().min(0),
+    skippedJobs: z.number().int().min(0),
+});
+export const providerAgenticRetrySchema = z.object({
+    enabledJobs: z.number().int().min(0),
+    attemptedJobs: z.number().int().min(0),
+    attemptedTotal: z.number().int().min(0),
+    succeededJobs: z.number().int().min(0),
+    triggerCodes: z.record(z.number().int().min(0)),
+});
+export const providerPackInvariantsSchema = z.object({
+    errors: z.number().int().min(0),
+    warnings: z.number().int().min(0),
+    issueCodes: z.array(nonEmptyString),
+});
+export const providerConsistencySchema = z.object({
+    groups: z.number().int().min(0),
+    warningTargets: z.number().int().min(0),
+    outlierTargets: z.number().int().min(0),
+    totalPenalty: z.number().int().min(0),
+    maxScore: numberOrNullSchema,
+});
+export const providerStylePolicySchema = z.object({
+    errorCount: z.number().int().min(0),
+    warningCount: z.number().int().min(0),
+    codes: z.array(nonEmptyString),
+});
+export const providerSpritesheetSchema = z.object({
+    issueCount: z.number().int().min(0),
+    animationsMeasured: z.number().int().min(0),
+    maxSilhouetteDrift: numberOrNullSchema,
+    maxAnchorDrift: numberOrNullSchema,
+    maxIdentityDrift: numberOrNullSchema,
+    maxPoseDrift: numberOrNullSchema,
+});
+export const providerFeatureSchema = z.object({
+    coarseToFine: providerCoarseToFineSchema,
+    agenticRetry: providerAgenticRetrySchema,
+    packInvariants: providerPackInvariantsSchema,
+    consistencyOutliers: providerConsistencySchema,
+    stylePolicy: providerStylePolicySchema,
+    spritesheetDrift: providerSpritesheetSchema,
+});
+export const providerEvidenceSchema = z.object({
+    id: nonEmptyString,
+    label: nonEmptyString,
+    provider: nonEmptyString,
+    manifestPath: nonEmptyString,
+    outDir: nonEmptyString,
+    generatedAt: nonEmptyString,
+    quality: providerQualitySchema,
+    features: providerFeatureSchema,
+});
+export const aggregateQualitySchema = z.object({
+    providerCount: z.number().int().min(0),
+    targetCount: z.number().int().min(0),
+    passedHardGates: z.number().int().min(0),
+    failedHardGates: z.number().int().min(0),
+    hardErrors: z.number().int().min(0),
+    passRate: numberOrNullSchema,
+    finalScoreMean: numberOrNullSchema,
+    finalScoreMedian: numberOrNullSchema,
+});
+export const aggregateFeaturesSchema = z.object({
+    coarseToFineEnabledJobs: z.number().int().min(0),
+    coarseToFinePromotedCandidates: z.number().int().min(0),
+    coarseToFineDiscardedCandidates: z.number().int().min(0),
+    agenticRetryAttemptedJobs: z.number().int().min(0),
+    agenticRetryAttempts: z.number().int().min(0),
+    packInvariantErrors: z.number().int().min(0),
+    packInvariantWarnings: z.number().int().min(0),
+    consistencyOutlierTargets: z.number().int().min(0),
+    stylePolicyErrors: z.number().int().min(0),
+    spritesheetIssueCount: z.number().int().min(0),
+});
+export const scenarioValueSchema = z.object({
+    label: nonEmptyString,
+    value: nonEmptyString,
+});
+export const scenarioEvidenceSchema = z.object({
+    id: nonEmptyString,
+    title: nonEmptyString,
+    panelFile: nonEmptyString,
+    summary: nonEmptyString,
+    values: z.array(scenarioValueSchema),
+});
+export const providerComparisonSchema = z.object({
+    id: nonEmptyString,
+    leftId: nonEmptyString,
+    rightId: nonEmptyString,
+    finalScoreMeanDelta: numberOrNullSchema,
+    passRateDelta: numberOrNullSchema,
+    hardErrorDelta: z.number().int(),
+});
+export const baselineDeltaSchema = z.object({
+    baselineVersion: nonEmptyString,
+    finalScoreMeanDelta: numberOrNullSchema,
+    passRateDelta: numberOrNullSchema,
+    hardErrorDelta: z.number().int(),
+});
+const SCHEMA_VERSION = "release-showcase-v2";
+export const ReleaseEvidenceReportSchema = z.object({
+    schemaVersion: z.literal(SCHEMA_VERSION),
+    generatedAt: nonEmptyString,
+    release: z.object({
+        version: nonEmptyString,
+        codename: nonEmptyString,
+        comparisonPolicy: nonEmptyString,
+    }),
+    baseline: z
+        .object({
+        version: nonEmptyString,
+        evidencePath: nonEmptyString.optional(),
+        available: z.boolean(),
+    })
+        .optional(),
+    providers: z.array(providerEvidenceSchema),
+    aggregate: z.object({
+        quality: aggregateQualitySchema,
+        features: aggregateFeaturesSchema,
+    }),
+    comparisons: z.object({
+        providerPairs: z.array(providerComparisonSchema).default([]),
+        baselineDelta: baselineDeltaSchema.optional(),
+    }),
+    scenarios: z.array(scenarioEvidenceSchema),
+});
+/** Read v1 or v2 reports, normalizing v1 to v2. */
+export function normalizeReportSchema(raw) {
+    const obj = raw;
+    if (obj.schemaVersion === "release-showcase-v1") {
+        const comparisons = obj.comparisons;
+        const providerPairs = [];
+        if (comparisons?.openaiVsNano) {
+            const pair = comparisons.openaiVsNano;
+            providerPairs.push({ id: "openai-vs-nano", ...pair });
+        }
+        return {
+            ...obj,
+            schemaVersion: SCHEMA_VERSION,
+            comparisons: {
+                providerPairs,
+                baselineDelta: comparisons?.baselineDelta,
+            },
+        };
+    }
+    return raw;
+}
+//# sourceMappingURL=releaseEvidenceSchema.js.map

package/dist/showcase/releaseEvidenceSchema.js.map

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

package/dist/showcase/scenarioRenderer.d.ts

@@ -0,0 +1,19 @@
+import { type ResolvedReleaseShowcaseConfig } from "./releaseConfig.js";
+import { type ReleaseEvidenceReport } from "./releaseEvidenceSchema.js";
+export interface PanelManifest {
+    generatedAt: string;
+    releaseVersion: string;
+    panelCount: number;
+    panels: {
+        id: string;
+        title: string;
+        file: string;
+    }[];
+}
+export declare function renderScenarioPanels(params: {
+    config: ResolvedReleaseShowcaseConfig;
+    report: ReleaseEvidenceReport;
+    baselineReport?: ReleaseEvidenceReport;
+    destDir: string;
+    repoRoot: string;
+}): Promise<PanelManifest>;

package/dist/showcase/scenarioRenderer.js

@@ -0,0 +1,488 @@
+import { readFile, mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import sharp from "sharp";
+import { cardImage, renderSideBySide, renderGallery, renderFeatureShowcase, resolveImageOrPlaceholder, makePlaceholderImage, tilePreview, } from "./panelRenderer.js";
+// ---------------------------------------------------------------------------
+// Scenario registry
+// ---------------------------------------------------------------------------
+const SCENARIO_RENDERERS = {
+    "quality-delta": renderQualityDelta,
+    "provider-openai-vs-nano": renderProviderComparison,
+    "provider-comparison": renderProviderComparison,
+    "spritesheet-drift-qa": renderSpritesheetDrift,
+    "style-bible-policy": renderStylePolicy,
+    "coarse-to-fine": renderCoarseToFine,
+    "agentic-retry": renderAgenticRetry,
+    "pack-invariants": renderPackInvariants,
+    "consistency-outliers": renderConsistencyOutliers,
+};
+// ---------------------------------------------------------------------------
+// Main entry point
+// ---------------------------------------------------------------------------
+export async function renderScenarioPanels(params) {
+    const { config, report, baselineReport, destDir, repoRoot } = params;
+    await mkdir(destDir, { recursive: true });
+    const ctx = { config, report, baselineReport, repoRoot };
+    const scenarioConfigById = new Map(config.scenarios.map((s) => [s.id, s]));
+    const manifest = {
+        generatedAt: new Date().toISOString(),
+        releaseVersion: config.releaseVersion,
+        panelCount: 0,
+        panels: [],
+    };
+    for (let index = 0; index < config.readmePanels.length; index += 1) {
+        const panelId = config.readmePanels[index];
+        const scenarioConfig = scenarioConfigById.get(panelId);
+        if (!scenarioConfig)
+            continue;
+        const outPath = path.join(destDir, scenarioConfig.panelFile);
+        const subtitle = buildSubtitle(scenarioConfig.description, index + 1, config.readmePanels.length);
+        const renderer = SCENARIO_RENDERERS[panelId] ?? renderDefaultGallery;
+        process.stdout.write(`[render] ${panelId} -> ${scenarioConfig.panelFile}\n`);
+        await renderer(ctx, outPath, scenarioConfig.title, subtitle);
+        manifest.panels.push({
+            id: panelId,
+            title: scenarioConfig.title,
+            file: scenarioConfig.panelFile,
+        });
+    }
+    manifest.panelCount = manifest.panels.length;
+    await writeFile(path.join(destDir, "panel-manifest.json"), `${JSON.stringify(manifest, null, 2)}\n`);
+    return manifest;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function buildSubtitle(description, panelIndex, panelCount) {
+    const desc = description ?? "Release showcase evidence";
+    return `Panel ${panelIndex}/${panelCount} - ${desc}`;
+}
+function providerImagesDir(outDir) {
+    return path.join(outDir, "assets", "imagegen", "processed", "images");
+}
+function primaryProvider(report) {
+    return report.providers.reduce((best, p) => (!best || p.quality.targetCount > best.quality.targetCount ? p : best), undefined);
+}
+function canonicalProvider(config, report) {
+    return (report.providers.find((provider) => provider.id === config.canonicalRunId) ??
+        primaryProvider(report));
+}
+function providerWithHighestFeatureScore(providers, scoreFor) {
+    return providers.reduce((best, provider) => (!best || scoreFor(provider) > scoreFor(best) ? provider : best), undefined);
+}
+function providerWithCoarseToFineTrace(config, report) {
+    const traced = providerWithHighestFeatureScore(report.providers, (provider) => {
+        const feature = provider.features.coarseToFine;
+        return (feature.enabledJobs * 100 + feature.promotedCandidates * 10 + feature.discardedCandidates);
+    });
+    if (!traced || traced.features.coarseToFine.enabledJobs === 0) {
+        return canonicalProvider(config, report);
+    }
+    return traced;
+}
+function providerWithAgenticRetryTrace(config, report) {
+    const traced = providerWithHighestFeatureScore(report.providers, (provider) => {
+        const feature = provider.features.agenticRetry;
+        return feature.attemptedJobs * 100 + feature.attemptedTotal * 10 + feature.enabledJobs;
+    });
+    if (!traced || traced.features.agenticRetry.attemptedJobs === 0) {
+        return canonicalProvider(config, report);
+    }
+    return traced;
+}
+function findProviderById(report, id) {
+    return report.providers.find((p) => p.id === id);
+}
+const SHOWCASE_TARGETS = ["hero-idle", "dungeon-tile", "ui-relic"];
+/** Maps 0.3.0 target names to prior-version equivalents for baseline resolution. */
+const BASELINE_TARGET_ALIASES = {
+    "ui-relic": ["ui-relic-icon"],
+};
+// ---------------------------------------------------------------------------
+// Scenario: quality-delta (side-by-side)
+// ---------------------------------------------------------------------------
+async function renderQualityDelta(ctx, outPath, title, subtitle) {
+    const canonical = canonicalProvider(ctx.config, ctx.report);
+    if (!canonical) {
+        await renderPlaceholderPanel(outPath, title, subtitle);
+        return;
+    }
+    const currentImages = providerImagesDir(canonical.outDir);
+    const baselineProvider = ctx.baselineReport ? primaryProvider(ctx.baselineReport) : undefined;
+    const baselineImages = baselineProvider ? providerImagesDir(baselineProvider.outDir) : undefined;
+    const baselineFallbackDir = ctx.report.baseline?.version
+        ? path.join(ctx.repoRoot, "docs", "showcase", ctx.report.baseline.version)
+        : undefined;
+    const pairs = [];
+    for (const targetId of SHOWCASE_TARGETS) {
+        const baselineCandidates = [];
+        const aliases = [targetId, ...(BASELINE_TARGET_ALIASES[targetId] ?? [])];
+        for (const alias of aliases) {
+            if (baselineImages)
+                baselineCandidates.push(path.join(baselineImages, `${alias}.png`));
+            if (baselineFallbackDir)
+                baselineCandidates.push(path.join(baselineFallbackDir, `${alias}.png`));
+        }
+        pairs.push({
+            label: targetId,
+            leftImage: await resolveImageOrPlaceholder(baselineCandidates, `${ctx.report.baseline?.version ?? "Baseline"} unavailable`),
+            rightImage: await resolveImageOrPlaceholder([path.join(currentImages, `${targetId}.png`)], `${ctx.config.releaseVersion} unavailable`),
+        });
+    }
+    await renderSideBySide({
+        title,
+        subtitle,
+        pairs,
+        leftLabel: ctx.report.baseline?.version ?? "Baseline",
+        rightLabel: ctx.config.releaseVersion,
+        outPath,
+    });
+}
+// ---------------------------------------------------------------------------
+// Scenario: provider comparison (side-by-side)
+// ---------------------------------------------------------------------------
+async function renderProviderComparison(ctx, outPath, title, subtitle) {
+    if (ctx.report.comparisons.providerPairs.length === 0) {
+        await renderDefaultGallery(ctx, outPath, title, subtitle);
+        return;
+    }
+    const pair = ctx.report.comparisons.providerPairs[0];
+    const leftProvider = findProviderById(ctx.report, pair.leftId);
+    const rightProvider = findProviderById(ctx.report, pair.rightId);
+    if (!leftProvider || !rightProvider) {
+        await renderDefaultGallery(ctx, outPath, title, subtitle);
+        return;
+    }
+    const leftImages = providerImagesDir(leftProvider.outDir);
+    const rightImages = providerImagesDir(rightProvider.outDir);
+    const pairs = [];
+    for (const targetId of SHOWCASE_TARGETS) {
+        pairs.push({
+            label: targetId,
+            leftImage: await resolveImageOrPlaceholder([path.join(leftImages, `${targetId}.png`)], `${leftProvider.label} unavailable`),
+            rightImage: await resolveImageOrPlaceholder([path.join(rightImages, `${targetId}.png`)], `${rightProvider.label} unavailable`),
+        });
+    }
+    await renderSideBySide({
+        title,
+        subtitle,
+        pairs,
+        leftLabel: leftProvider.label,
+        rightLabel: rightProvider.label,
+        outPath,
+    });
+}
+// ---------------------------------------------------------------------------
+// Scenario: spritesheet drift (gallery)
+// ---------------------------------------------------------------------------
+async function renderSpritesheetDrift(ctx, outPath, title, subtitle) {
+    const canonical = canonicalProvider(ctx.config, ctx.report);
+    if (!canonical) {
+        await renderPlaceholderPanel(outPath, title, subtitle);
+        return;
+    }
+    const imagesDir = providerImagesDir(canonical.outDir);
+    const framesDir = path.join(imagesDir, "__frames", "hero-sheet");
+    await renderGallery({
+        title,
+        subtitle,
+        cardHeightScale: 1.3,
+        items: [
+            {
+                label: "Seed Reference",
+                image: await resolveImageOrPlaceholder([path.join(imagesDir, "hero-idle.png")], "Seed image unavailable"),
+            },
+            {
+                label: "Walk Frame 1",
+                image: await resolveImageOrPlaceholder([path.join(framesDir, "hero-sheet__walk_00.png")], "Walk frame unavailable"),
+            },
+            {
+                label: "Walk Frame 2",
+                image: await resolveImageOrPlaceholder([path.join(framesDir, "hero-sheet__walk_01.png")], "Walk frame unavailable"),
+            },
+            {
+                label: "Walk Frame 3",
+                image: await resolveImageOrPlaceholder([path.join(framesDir, "hero-sheet__walk_02.png")], "Walk frame unavailable"),
+            },
+        ],
+        outPath,
+    });
+}
+// ---------------------------------------------------------------------------
+// Scenario: style policy (gallery)
+// ---------------------------------------------------------------------------
+async function renderStylePolicy(ctx, outPath, title, subtitle) {
+    const canonical = canonicalProvider(ctx.config, ctx.report);
+    if (!canonical) {
+        await renderPlaceholderPanel(outPath, title, subtitle);
+        return;
+    }
+    const imagesDir = providerImagesDir(canonical.outDir);
+    await renderGallery({
+        title,
+        subtitle,
+        items: [
+            {
+                label: "Hero Sprite",
+                image: await resolveImageOrPlaceholder([path.join(imagesDir, "hero-idle.png")], "Hero unavailable"),
+            },
+            {
+                label: "Dungeon Tile",
+                image: await resolveImageOrPlaceholder([path.join(imagesDir, "dungeon-tile.png")], "Tile unavailable"),
+            },
+            {
+                label: "UI Icon",
+                image: await resolveImageOrPlaceholder([path.join(imagesDir, "ui-relic.png")], "UI relic unavailable"),
+            },
+            {
+                label: "Spritesheet",
+                image: await renderWalkStripPreview(imagesDir),
+            },
+        ],
+        outPath,
+    });
+}
+// ---------------------------------------------------------------------------
+// Scenario: coarse-to-fine (feature showcase)
+// ---------------------------------------------------------------------------
+async function renderCoarseToFine(ctx, outPath, title, subtitle) {
+    const traced = providerWithCoarseToFineTrace(ctx.config, ctx.report);
+    if (!traced) {
+        await renderPlaceholderPanel(outPath, title, subtitle);
+        return;
+    }
+    const resolved = await resolveCoarseToFineImages(traced.outDir);
+    await renderFeatureShowcase({
+        title,
+        subtitle,
+        ...resolved,
+        outPath,
+    });
+}
+// ---------------------------------------------------------------------------
+// Scenario: agentic retry (feature showcase)
+// ---------------------------------------------------------------------------
+async function renderAgenticRetry(ctx, outPath, title, subtitle) {
+    const traced = providerWithAgenticRetryTrace(ctx.config, ctx.report);
+    if (!traced) {
+        await renderPlaceholderPanel(outPath, title, subtitle);
+        return;
+    }
+    const resolved = await resolveAgenticRetryImages(traced.outDir);
+    await renderFeatureShowcase({
+        title,
+        subtitle,
+        ...resolved,
+        outPath,
+    });
+}
+// ---------------------------------------------------------------------------
+// Scenario: pack invariants (gallery)
+// ---------------------------------------------------------------------------
+async function renderPackInvariants(ctx, outPath, title, subtitle) {
+    const canonical = canonicalProvider(ctx.config, ctx.report);
+    if (!canonical) {
+        await renderPlaceholderPanel(outPath, title, subtitle);
+        return;
+    }
+    const imagesDir = providerImagesDir(canonical.outDir);
+    const tile = await resolveImageOrPlaceholder([path.join(imagesDir, "dungeon-tile.png")], "Tile unavailable");
+    const tileGrid = await tilePreview(tile, 6, 6, 80);
+    await renderGallery({
+        title,
+        subtitle,
+        items: [
+            { label: "Tile Repeat Grid", image: tileGrid },
+            {
+                label: "Sheet Continuity",
+                image: await renderWalkStripPreview(imagesDir),
+            },
+            {
+                label: "Sprite Uniqueness",
+                image: await resolveImageOrPlaceholder([path.join(imagesDir, "hero-idle.png")], "Hero unavailable"),
+            },
+            {
+                label: "Icon Uniqueness",
+                image: await resolveImageOrPlaceholder([path.join(imagesDir, "ui-relic.png")], "Relic unavailable"),
+            },
+        ],
+        outPath,
+    });
+}
+// ---------------------------------------------------------------------------
+// Scenario: consistency outliers (gallery)
+// ---------------------------------------------------------------------------
+async function renderConsistencyOutliers(ctx, outPath, title, subtitle) {
+    const canonical = canonicalProvider(ctx.config, ctx.report);
+    if (!canonical) {
+        await renderPlaceholderPanel(outPath, title, subtitle);
+        return;
+    }
+    const imagesDir = providerImagesDir(canonical.outDir);
+    const items = [];
+    for (const targetId of SHOWCASE_TARGETS) {
+        items.push({
+            label: targetId,
+            image: await resolveImageOrPlaceholder([path.join(imagesDir, `${targetId}.png`)], `${targetId} unavailable`),
+        });
+    }
+    await renderGallery({ title, subtitle, items, outPath });
+}
+// ---------------------------------------------------------------------------
+// Default fallback (gallery of showcase targets)
+// ---------------------------------------------------------------------------
+async function renderDefaultGallery(ctx, outPath, title, subtitle) {
+    const canonical = canonicalProvider(ctx.config, ctx.report);
+    if (!canonical) {
+        await renderPlaceholderPanel(outPath, title, subtitle);
+        return;
+    }
+    const imagesDir = providerImagesDir(canonical.outDir);
+    const items = [];
+    for (const targetId of SHOWCASE_TARGETS) {
+        items.push({
+            label: targetId,
+            image: await resolveImageOrPlaceholder([path.join(imagesDir, `${targetId}.png`)], `${targetId} unavailable`),
+        });
+    }
+    await renderGallery({ title, subtitle, items, outPath });
+}
+// ---------------------------------------------------------------------------
+// Placeholder panel for zero-provider edge case
+// ---------------------------------------------------------------------------
+async function renderPlaceholderPanel(outPath, title, subtitle) {
+    const placeholder = await makePlaceholderImage("No provider data available");
+    await renderGallery({
+        title,
+        subtitle,
+        items: [{ label: "No data", image: placeholder }],
+        outPath,
+    });
+}
+async function readProvenanceJobs(outDir) {
+    try {
+        const raw = await readFile(path.join(outDir, "provenance", "run.json"), "utf8");
+        const parsed = JSON.parse(raw);
+        return parsed.jobs ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+async function resolveCoarseToFineImages(outDir) {
+    const jobs = await readProvenanceJobs(outDir);
+    for (const job of jobs) {
+        const coarse = job.coarseToFine;
+        if (!coarse)
+            continue;
+        const promoted = coarse.promoted?.[0];
+        const discarded = coarse.discarded?.[0];
+        // Show the two raw draft candidates side-by-side so the viewer sees two
+        // distinct generations and understands which one the scorer promoted.
+        // We intentionally show the raw drafts (not the refined output) because
+        // they have visible composition differences that demonstrate selection.
+        if (promoted?.outputPath && discarded?.outputPath) {
+            const fmtScore = (s) => s != null ? ` (${Math.round(s).toLocaleString()})` : "";
+            return {
+                beforeImage: await resolveImageOrPlaceholder([discarded.outputPath], "No discarded draft"),
+                afterImage: await resolveImageOrPlaceholder([promoted.outputPath], "No promoted draft"),
+                beforeLabel: `Rejected Draft${fmtScore(discarded.score)}`,
+                afterLabel: `Promoted Draft${fmtScore(promoted.score)}`,
+            };
+        }
+        // Only promoted available -- fall back to promoted vs placeholder
+        const fallbackPath = promoted?.refinedOutputPath ?? promoted?.outputPath;
+        if (fallbackPath) {
+            return {
+                beforeImage: await resolveImageOrPlaceholder(discarded?.outputPath ? [discarded.outputPath] : [], "No discarded draft"),
+                afterImage: await resolveImageOrPlaceholder([fallbackPath], "No promoted candidate"),
+                beforeLabel: "Draft (Discarded)",
+                afterLabel: "Promoted (Selected)",
+            };
+        }
+        // All candidates discarded -- show the two best discarded side-by-side
+        const allDiscarded = coarse.discarded ?? [];
+        if (allDiscarded.length >= 2) {
+            const sorted = [...allDiscarded].sort((a, b) => (b.score ?? 0) - (a.score ?? 0));
+            const fmtScore = (s) => s != null ? ` (${Math.round(s).toLocaleString()})` : "";
+            return {
+                beforeImage: await resolveImageOrPlaceholder(sorted[1].outputPath ? [sorted[1].outputPath] : [], "No draft available"),
+                afterImage: await resolveImageOrPlaceholder(sorted[0].outputPath ? [sorted[0].outputPath] : [], "No draft available"),
+                beforeLabel: `Rejected #2${fmtScore(sorted[1].score)}`,
+                afterLabel: `Rejected #1${fmtScore(sorted[0].score)}`,
+            };
+        }
+        if (allDiscarded.length === 1 && allDiscarded[0].outputPath) {
+            const fmtScore = (s) => s != null ? ` (${Math.round(s).toLocaleString()})` : "";
+            return {
+                beforeImage: await resolveImageOrPlaceholder([allDiscarded[0].outputPath], "No draft available"),
+                afterImage: await makePlaceholderImage("None promoted"),
+                beforeLabel: `Rejected${fmtScore(allDiscarded[0].score)}`,
+                afterLabel: "None Promoted",
+            };
+        }
+    }
+    const placeholder = await resolveImageOrPlaceholder([], "No coarse-to-fine trace");
+    return {
+        beforeImage: placeholder,
+        afterImage: placeholder,
+        beforeLabel: "Draft (Discarded)",
+        afterLabel: "Promoted (Selected)",
+    };
+}
+async function renderWalkStripPreview(imagesDir) {
+    const framesDir = path.join(imagesDir, "__frames", "hero-sheet");
+    const frameImages = await Promise.all([0, 1, 2].map((index) => resolveImageOrPlaceholder([path.join(framesDir, `hero-sheet__walk_${String(index).padStart(2, "0")}.png`)], "Walk frame unavailable")));
+    const tileWidth = 118;
+    const tileHeight = 220;
+    const padding = 12;
+    const gap = 8;
+    const width = padding * 2 + tileWidth * frameImages.length + gap * (frameImages.length - 1);
+    const height = padding * 2 + tileHeight;
+    const composites = await Promise.all(frameImages.map(async (image, index) => ({
+        input: await cardImage(image, tileWidth, tileHeight),
+        left: padding + index * (tileWidth + gap),
+        top: padding,
+    })));
+    return sharp({
+        create: {
+            width,
+            height,
+            channels: 4,
+            background: { r: 9, g: 7, b: 14, alpha: 1 },
+        },
+    })
+        .composite(composites)
+        .png({ compressionLevel: 9 })
+        .toBuffer();
+}
+async function resolveAgenticRetryImages(outDir) {
+    const jobs = await readProvenanceJobs(outDir);
+    const fmtScore = (s) => s != null ? ` (${Math.round(s).toLocaleString()})` : "";
+    for (const job of jobs) {
+        const retry = job.agenticRetry;
+        if (!retry?.enabled || !retry.attempts?.length)
+            continue;
+        const attempt = retry.attempts[0];
+        // Use retryOutputPath (the actual retry candidate) rather than outputPath
+        // (which is the re-selected best candidate and may be the same as source
+        // when the retry didn't improve the score).
+        const retryImage = attempt.retryOutputPath ?? attempt.outputPath;
+        if (attempt.sourceOutputPath && retryImage) {
+            return {
+                beforeImage: await resolveImageOrPlaceholder([attempt.sourceOutputPath], "Original unavailable"),
+                afterImage: await resolveImageOrPlaceholder([retryImage], "Corrected unavailable"),
+                beforeLabel: `Original${fmtScore(attempt.scoreBefore)}`,
+                afterLabel: `Auto-Corrected${fmtScore(attempt.scoreAfter)}`,
+            };
+        }
+    }
+    const placeholder = await resolveImageOrPlaceholder([], "No agentic retry trace");
+    return {
+        beforeImage: placeholder,
+        afterImage: placeholder,
+        beforeLabel: "Original",
+        afterLabel: "Auto-Corrected",
+    };
+}
+//# sourceMappingURL=scenarioRenderer.js.map