docs: document the published v8.0 dataset + corpus-free reproduction

README.md

@@ -19,9 +19,23 @@ Generative text→skeletal-animation model shipped with
 
 - `t2m.onnx` + `t2m-vocab.json` — the generative model + its vocab/contract.
 - `t2m-v61.onnx` / `t2m-v4.onnx` — previous versions, kept for rollback.
-- `motion-library-v2.json` — the curated **template clip library**. It is both
-  the fallback for prompts outside the model vocab *and* — since v8.0 — the
-  model's training data.
+- `motion-library-v2.json` — the curated **template clip library** (150 clips).
+  It is both the fallback for prompts outside the model vocab *and* — since
+  v8.0 — the model's training data. This is the exact library v8.0 trained on.
+- `ATTRIBUTION-v2.md` — **required credits** for the CC-BY clips in that
+  library. It must ship with the data and with anything derived from it.
+
+## Dataset
+
+The published library is the full v8.0 training source: 150 clips drawn from 31
+source assets — 27 CC-BY-4.0, plus CC0 material (largely Quaternius packs) and
+17 clips the author owns outright. Every CC-BY asset is credited in
+`ATTRIBUTION-v2.md`; no clip in the library lacks a credit where one is due.
+
+To rebuild the training cache from it, see **Reproducing** below. The cache
+itself is not published — it is fully regenerable from this library, and it
+stamps its own `buildArgv`/`buildFlags` so any `.npz` can state how it was
+built.
 
 ## What changed in v8.0
 
@@ -82,11 +96,12 @@ curated clips is the improvement path.
 ## Training data — permissive only
 
 The curated library is CC0/CC-BY content (Sketchfab, OpenGameArt, Quaternius
-packs) with per-asset provenance in `manifest.json` and credits in
-`ATTRIBUTION.md`, **which must ship with the library**. Earlier CMU MoCap
-windows (commercial-OK) remain in the corpus path. AMASS / HumanML3D / KIT-ML
-are **excluded** (non-commercial). Zombie/fruit/non-humanoid characters are
-filtered out.
+packs) plus clips the author owns; credits are in `ATTRIBUTION-v2.md`, **which
+must ship with the library and with anything derived from it**. Earlier CMU
+MoCap windows (commercial-OK) remain in the corpus path but no longer dominate
+training. AMASS / HumanML3D / KIT-ML are **excluded** (non-commercial).
+Zombie/fruit/non-humanoid characters are filtered out, as are clips failing the
+anatomical ankle gate or resolving fewer than 16 of the 22 canonical roles.
 
 ## Architecture (v8.0)
 
@@ -115,8 +130,13 @@ world delta); `fps: 30`, `T: 60` (2.0 s).
 `scripts/prep-t2m-v6.py` + `scripts/train-t2m-flow-v5.py` in the QtMeshEditor
 repo (one-time, offline dev tools — the app never runs Python):
 
+`--corpus` is optional and points at the raw CMU-derived corpus, which is NOT
+published here; with `--library-repeat 40` the curated library dominates
+training either way, so omitting it reproduces the same shape of dataset from
+the published files alone:
+
 ```
-python3 scripts/prep-t2m-v6.py --corpus <corpus> --library motion-library-v2.json \
+python3 scripts/prep-t2m-v6.py --library motion-library-v2.json \
     --library-repeat 40 --min-roles 16 --out t2m.npz
 python3 scripts/train-t2m-flow-v5.py --data t2m.npz --out flow --dim 384 --layers 8 \
     --phase-weight 0.08 --twist-weight 0.5 --travel-weight 0.2 --amp-weight 0.4 \