# V3 Cook-Size Reports CI

`v3-cook-size-reports.v1` is the release gate for the `V3/V3_TODOS.md` §67.1
per-platform cook-size reporting item.

## Gate

- Scope: UE launch cooks for Win64, Mac Apple Silicon, Linux, iOS, Android,
  Steam Deck, Quest 3, Vision Pro, PS5, and PSVR 2.
- Budget source: the V3 client build-size table in `V3/V3_features.md`.
- Required breakdowns: pak chunk, asset class, and Game Feature Plugin.
- Required asset classes: mesh, texture, audio, and sequence.
- CI verifier: `pnpm verify:v3 cook-size-reports`.
- PR summary: `scripts/v3/render-v3-cook-size-pr-comment.mjs` renders a sticky
  `<!-- v3-cook-size-budget-report -->` comment with platform deltas.

## Evidence

`V3/ue/Build/CookSizeReports/cook-size-ci-report.json` records ten launch cook
reports. Each report includes the platform budget, observed initial install,
reserved day-0 patch headroom, total disk after first launch, PR delta versus
the baseline branch, and a pak chunk table whose rows include Game Feature
Plugin ownership plus mesh, texture, audio, and sequence class totals.

The workflow `.github/workflows/v3-cook-size-budgets.yml` runs the verifier on
pull requests and pushes. On pull requests it also renders and updates the
sticky PR comment so reviewers can see size deltas before merge.

The verifier fails closed if any launch platform is missing, any cook exceeds
the V3 budget table, any required breakdown is absent, the workflow stops
posting PR deltas, or the TODO lock is weakened.
