From 172f667bc65b7a6095c79ecf5a7711069207bd86 Mon Sep 17 00:00:00 2001
From: Valentin Popov <valentin@popov.link>
Date: Sat, 18 Jul 2026 09:13:52 +0400
Subject: feat(vulkan): compare readback artifacts

---
 docs/tomes/05-render.md | 5 +++++
 1 file changed, 5 insertions(+)

(limited to 'docs/tomes/05-render.md')

diff --git a/docs/tomes/05-render.md b/docs/tomes/05-render.md
index 3b96351..0e2f411 100644
--- a/docs/tomes/05-render.md
+++ b/docs/tomes/05-render.md
@@ -901,6 +901,11 @@ Smoke также сохраняет raw artifact рядом с JSON: `<report-st
 потому что bytes не перекодируются; JSON содержит actual raw enum. GOG selected `50` and produced a 4,147,200-byte file
 for two 960x540 images. Артефакт остаётся локальным output и не попадает в Git.
 
+Smoke option `--expected-readback <path>` выполняет exact byte comparison после
+readback и завершает run с первым differing byte или length mismatch. Fresh GOG
+run с предыдущим format-50 artifact прошёл этот gate. Это regression contract
+нашего static Vulkan viewer, не comparison с оригинальным renderer.
+
 `Land.msh` использует отдельный geometry-only bridge: validated `TerrainFace28`
 сохраняет source triangle order, а его positions и packed UV0 попадают в тот же
 static vertex/index upload path. Для текущего диагностического viewer XZ bounds
-- 
cgit v1.2.3