From 6c444d63c552df058685a85284b4166c540514a0 Mon Sep 17 00:00:00 2001
From: Valentin Popov <valentin@popov.link>
Date: Sat, 18 Jul 2026 20:29:53 +0400
Subject: feat(cli): expose unit component provenance

---
 docs/tomes/03-resources.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

(limited to 'docs')

diff --git a/docs/tomes/03-resources.md b/docs/tomes/03-resources.md
index 29fef77..fa5377a 100644
--- a/docs/tomes/03-resources.md
+++ b/docs/tomes/03-resources.md
@@ -484,6 +484,21 @@ Visual dependency expansion наследует этот индекс на edges
 diffuse texture и lightmap. Поэтому ошибка или asset в любой из этих фаз
 сохраняет путь до конкретной записи unit DAT, а не только до миссионного object.
 
+Для воспроизводимой проверки используется `fparkan-cli prototype inspect`.
+Схема JSON `fparkan-prototype-inspect-v2` содержит lossless hex каждого
+32-byte поля unit record и materialized graph edges с `unit_component_index`.
+Например, для GOG AutoDemo:
+
+```powershell
+cargo run -p fparkan-cli -- prototype inspect `
+  --root 'C:\GOG Games\Parkan - Iron Strategy' `
+  --key 'UNITS\UNITS\AutoDEMO\w_m_wlk2.dat' --format json
+```
+
+Вывод фиксирует 18 component records, их MSH/WEAR/MAT0/Texm dependencies и
+точные parent edges. JSON предназначен для анализа и regression evidence, а
+не для интерпретации `kind`, links или opaque tails как готовой game logic.
+
 ## Вспомогательные форматы
 
 MSH, материал и текстура отвечают за видимую форму. Полноценный прототип
-- 
cgit v1.2.3