Measure the 3D library and open the model review scorecard

docs/asset-tooling.md

@@ -144,6 +144,7 @@ flatpak run org.blender.Blender --background --python "$PWD/tools/blender_assets
 python3 tools/blender_assets.py sheet   # docs/blender_previews/sheet_*.jpg
 python3 tools/blender_assets.py audit   # no Blender needed
 python3 tools/blender_assets.py fit     # gear-vs-body fit report
+python3 tools/blender_assets.py texels  # per-slot texel density (px/m) of the characters
 godot --headless --path . --import
 ```
 
@@ -160,8 +161,8 @@ flatpak run org.blender.Blender --background \
   --python "$PWD/tools/blender_assets.py" -- inspect \
   --file "$PWD/assets/models/blender/npc/npc_casual.glb" \
   --file "$PWD/tmp/downloads/SomeCharacter.glb"
-# machine-readable, for intake scripts
-... -- inspect --file "$PWD/tmp/x.glb" --json
+# machine-readable, for intake scripts (write to a file: Blender prints a banner first)
+... -- inspect --file "$PWD/tmp/x.glb" --json --out "$PWD/tmp/x.json"
 # force a contract family instead of inferring it from the path
 ... -- inspect --file "$PWD/tmp/x.glb" --category npc
 ```
@@ -182,11 +183,28 @@ Caveats:
   pollute bounds or the unskinned list.
 - Bounds and bone rests are converted from Blender Z-up to Godot Y-up (`x, z, -y`),
   matching the contract bands and the audit's coordinate space.
-- Numbers are Blender-side measurements. They agree with `audit` on project assets
-  (same triangle and glTF vertex counts), but `audit` stays the single final gate:
-  it is stdlib-only, runs in CI, and matches what the engine imports.
+- Numbers are Blender-side measurements. Triangles match `audit` on project assets; the seam-split
+  vertex count can differ by ±1 because the importer rounds normals. `audit` stays the single final
+  gate: it is stdlib-only, runs in CI, and matches what the engine imports.
 - `inspect` never writes or adapts the file; scale/grounding/weld/retarget work is the
   separate (not yet built) `adapt` step.
+- `--json` also captures the importer's INFO log in `stats.import_log` instead of printing it.
+  Blender still prints its own version banner before the script runs, so intake scripts should use
+  `--json --out <file>` rather than parsing stdout.
+
+### Texel density (`texels`)
+
+`texel_density()` and the `texels` command compute `resolution * sqrt(UV area / world area)` per
+material slot straight from the GLB, so the number does not depend on island packing. The NPC slot
+maps are 256², and cloth/pants are reported twice: authored density and effective density with the
+runtime 4× repeat from `Materials.NPC_FABRIC_UV_SCALE`. Current values and interpretation are in
+[`3d-model-review.md`](3d-model-review.md).
+
+```bash
+python3 tools/blender_assets.py texels            # all eight characters
+python3 tools/blender_assets.py texels --json     # machine-readable
+python3 tools/blender_assets.py texels --only npc_coat
+```
 
 ## Local map development (planned)