From 79bfd713c1269f83a851f1ebe2baca01f1085895 Mon Sep 17 00:00:00 2001
From: m3ultra <m3ultra@m3ultra.local>
Date: Sun, 19 Jul 2026 19:17:01 +1000
Subject: [PATCH] =?UTF-8?q?docs+benchmarks:=20vertex=20baker=20productioni?=
 =?UTF-8?q?zed=20in=20both=20pipelines=20=E2=80=94=20130s=20e2e,=201s=20ba?=
 =?UTF-8?q?ke,=20zero=20dark=20patches?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 BENCHMARKS.md                | 17 +++++++++++++++++
 docs/FABLE_STARTUP_PACKET.md | 17 +++++++++++++++++
 2 files changed, 34 insertions(+)

diff --git a/BENCHMARKS.md b/BENCHMARKS.md
index 4761b73..1d456f7 100644
--- a/BENCHMARKS.md
+++ b/BENCHMARKS.md
@@ -312,3 +312,20 @@ path needs chart budgeting or per-island parallel unwrap.
 - Wire as `--baker python-fast` in the Jourloy fork + trellis-mac, make it
   the default over the convicted Metal texel path; port sampler to MLX
   (trivial — gather + weighted sum) for the pure-MLX lane.
+
+### §11 addendum — vertex baker PRODUCTIONIZED (2026-07-19 night)
+
+Wired and validated in BOTH pipelines:
+- `vendor/trellis-mac` @ 55fdd7b: `TRELLIS2_BAKER=vertex` env mode in
+  generate.py (Metal + kdtree paths untouched; sentinel-gated).
+- Jourloy fork @ 746e727 (pushed to monster/trellis-2-mrp-mlx): CLI
+  `--baker vertex`.
+
+E2E validation (anatomy, seed 42, 1024-cascade, uncapped density):
+**130.0s total, bake 1s**, 232s wall, 20.8GB peak — full 2.79M-face
+vertex-colored GLB, ZERO dark patches, best local quality yet
+(`render_vprod_front.png`). vs Metal-bake baseline: same speed envelope,
+quality gap closed for albedo. Not yet carried: metallic/roughness maps
+(vertex colors are albedo-only) — MR needs the UV path (Option B) or a
+COLOR_1 convention. MESHGOD finish-farm verts→texture bake = the
+remaining Option-A step for game-budget assets.
diff --git a/docs/FABLE_STARTUP_PACKET.md b/docs/FABLE_STARTUP_PACKET.md
index 7e53b9d..2a5ebdb 100644
--- a/docs/FABLE_STARTUP_PACKET.md
+++ b/docs/FABLE_STARTUP_PACKET.md
@@ -449,3 +449,20 @@ path needs chart budgeting or per-island parallel unwrap.
 - Wire as `--baker python-fast` in the Jourloy fork + trellis-mac, make it
   the default over the convicted Metal texel path; port sampler to MLX
   (trivial — gather + weighted sum) for the pure-MLX lane.
+
+### §11 addendum — vertex baker PRODUCTIONIZED (2026-07-19 night)
+
+Wired and validated in BOTH pipelines:
+- `vendor/trellis-mac` @ 55fdd7b: `TRELLIS2_BAKER=vertex` env mode in
+  generate.py (Metal + kdtree paths untouched; sentinel-gated).
+- Jourloy fork @ 746e727 (pushed to monster/trellis-2-mrp-mlx): CLI
+  `--baker vertex`.
+
+E2E validation (anatomy, seed 42, 1024-cascade, uncapped density):
+**130.0s total, bake 1s**, 232s wall, 20.8GB peak — full 2.79M-face
+vertex-colored GLB, ZERO dark patches, best local quality yet
+(`render_vprod_front.png`). vs Metal-bake baseline: same speed envelope,
+quality gap closed for albedo. Not yet carried: metallic/roughness maps
+(vertex colors are albedo-only) — MR needs the UV path (Option B) or a
+COLOR_1 convention. MESHGOD finish-farm verts→texture bake = the
+remaining Option-A step for game-budget assets.