Function buildReviewReport

src/artifacts/review.ts:93–139

(inputs: ReviewInputs)

 * "fine" to a weak vision model). Otherwise the vision verdict stands.
 */
export function buildReviewReport(inputs: ReviewInputs): ReviewReport {
  const consoleErrors = inputs.consoleErrors ?? [];
  const pageErrors = inputs.pageErrors ?? [];
  const runtimeErrors = [...pageErrors, ...consoleErrors];

  // If we couldn't see anything, we can't claim a visual verdict.
  if (!inputs.sawScreenshot && runtimeErrors.length === 0) {
    return {
      verdict: 'unverified',
      summary: 'Could not capture a screenshot or any runtime errors — preview not verified visually.',
      issues: [],
      visionAnswer: inputs.visionAnswer ?? '',
    };
  }

  const visionVerdict = classifyVisionAnswer(inputs.visionAnswer ?? '');
  const visionIssues = extractIssues(inputs.visionAnswer ?? '');

  // Runtime errors dominate.
  if (runtimeErrors.length > 0) {
    return {
      verdict: 'broken',
      summary: `The page reported ${runtimeErrors.length} runtime error(s) — the artifact is not rendering correctly.`,
      issues: [
        ...pageErrors.map(e => `Page error: ${e}`),
        ...consoleErrors.map(e => `Console error: ${e}`),
        ...visionIssues,
      ],
      visionAnswer: inputs.visionAnswer ?? '',
    };
  }

  // No runtime errors → trust the vision verdict.
  const summaryByVerdict: Record<ReviewVerdict, string> = {
    looks_good: 'Rendered correctly with no obvious visual issues.',
    needs_work: 'Renders, but the review found visual problems to fix.',
    broken: 'The review judged the render broken (blank or missing core content).',
    unverified: 'Screenshot captured but the review was inconclusive.',
  };

  return {
    verdict: visionVerdict,
    summary: summaryByVerdict[visionVerdict],
    issues: visionIssues,
    visionAnswer: inputs.visionAnswer ?? '',
  };
}

/** Render the report as the text the parent model reads back. */
export function formatReviewReport(artifactId: string, version: number, report: ReviewReport): string {