Add full quantile stats and post-hoc calibration

docs/README.md

@@ -14,3 +14,5 @@ Conventions:
 Tools:
 - `example/diagnose_ks.py` for per-feature KS + CDF plots.
 - `example/run_all_full.py` for one-command full pipeline + diagnostics.
+Notes:
+- If `use_quantile_transform` is enabled, run `prepare_data.py` with `full_stats: true` to build quantile tables.

docs/decisions.md

@@ -62,3 +62,12 @@
 - **Files**:
   - `example/export_samples.py`
   - `example/config.json`
+
+## 2026-01-27 — Post-hoc quantile calibration
+- **Decision**: Add optional post-hoc quantile calibration to align generated 1D CDFs with real data.
+- **Why**: KS remained high with distribution shifts even after boundary fixes.
+- **Files**:
+  - `example/data_utils.py`
+  - `example/export_samples.py`
+  - `example/prepare_data.py`
+  - `example/config.json`