Layer 3 Phase 5b: integrate runVisualJudge into runJudge (opt-in)

[dadachi]

Summary

Extends JudgeInput with an optional visual field. When provided, runJudge calls runVisualJudge (#40) per configured platform, captures results into JudgeResult, and rolls them into the summary line.

Default behavior unchanged. dispatch.ts doesn't pass visual, so runJudge takes the existing skip path with a clearer trace ("visual config not provided; skipped") instead of the old "not yet wired" placeholder.

When visual is configured, the summary becomes:

Layer 1 3/3 pass · Layer 2 3/3 pass · Layer 3 2/2 pass

New result shape

type JudgeResult = {
  overallPass: boolean;
  summary: string;
  visual?: {
    ios?: VisualJudgePlatformReport;
    android?: VisualJudgePlatformReport;
  };
};

type VisualJudgePlatformReport = {
  pass: boolean;
  screenshotPath?: string;
  scores?: { criterionId: string; pass: boolean; rationale: string }[];
  error?: string;
};

overallPass now requires layer1 + layer2 + visual all passing (when visual is configured).

Defaults when visual is configured

• Rubric — DEFAULT_STAGE1_RUBRIC from Layer 3 Phase 5a: visual-judge orchestration + default Stage 1 rubric #40 (3 criteria).
• Screenshot dir — tmp/screenshots/<slug>/.
• Spec text — domain.displayName; callers can override.

Out of scope

• Wiring visual from dispatch.ts (driver script / plugin entry populates it).
• Resolving artifactPath / bundleId / packageName from the slug (driver-side via Info.plist / AndroidManifest.xml read post-build).
• Bridge from Layer 2 build mode → installAndLaunch.

These three are user-environment specific (where do builds land, what bundle ID does the substrate use) and best decided once we have a real end-to-end run to point at.

Test plan

• npm run ci — 12/12 green. Existing dispatch e2e test unchanged (visual not passed → skip path).
• New shape verified via TypeScript strict-optional compilation.
• After merge: a driver (or temporary main script) populates visual from build artifacts, runs end-to-end, confirms Layer 3 2/2 pass lands in the summary against a real generated app.

🤖 Generated with Claude Code