feat(vm): add VM-owned PCG64 random and coverage headroom
Intrepid/Prometeu/Runtime/pipeline/pr-master This commit looks good

Implement GC-managed random generators, next/nextf intrinsics, bounded ranges and deterministic conformance coverage. Publish the runtime contract and producer guidance.

Give coverage domains at least five percentage points of measured headroom while preserving sufficient floors. Record local qualification: make ci-domains passes with 939 tests and all domain gates green.
This commit is contained in:
2026-10-09 12:51:05 +01:00
parent 9318cf7cd3
commit 3e39a90083
50 changed files with 2545 additions and 189 deletions
@@ -0,0 +1,19 @@
# Random fixture provenance
The canonical PCG-XSL-RR 128/64 setseq source is pcg-cpp revision
`428802d1a5634f96bcd0705fab379ff0113bcf13`.
Its [check-pcg64.out](https://github.com/imneme/pcg-cpp/blob/428802d1a5634f96bcd0705fab379ff0113bcf13/test-high/expected/check-pcg64.out)
contains the first six seed=42, seq=54 words used here.
Downloaded upstream fixture SHA-256: `afc9e7775bdc59ab90d85caebe533d58ae7324be36cf9a4c975e6d7f86b9df24`.
[random-oracle.py](random-oracle.py) independently uses Python mathematical
integers modulo 2^128, division-based rotation, and Fraction-to-binary64
conversion. It imports no VM/production RNG code and cross-checks those six
canonical words. Additional seeds 0, 1, -1, MIN/MAX and draws 7–8 are generated
by that independent arithmetic model. The Float column maps the same word;
it does not represent alternating calls. Signed values are stored explicitly.
Reproduce with `python3 crates/console/prometeu-vm/tests/fixtures/random-oracle.py`
and check the TSV diff. This is a test oracle, never a runtime dependency.
Statistical quality and sequence conformance are different evidence; these
fixtures establish bits/consumption, not cryptographic or independence claims.