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,50 @@
---
id: LSN-0064
ticket: coverage-domain-minimum-margin
title: Measured Coverage and Acceptance Floors
created: 2026-10-09
tags: [coverage, ci, measurement]
---
## Context
A coverage gate set equal to its observed percentage has almost no room for
variation. This workspace had several such floors. An explicitly reviewed
revision now provides at least five percentage points of local headroom in
all 15 domains, lowering eight floors and retaining seven.
The published contract is in [Coverage domains](../../../docs/vm-arch/COVERAGE_DOMAINS.md),
with [measured evidence](../../../docs/vm-arch/COVERAGE_DOMAINS_MARGIN.json) and
[fixed configuration](../../../files/config/runtime-edge-coverage-domains.json).
DEC-0051 and PLN-0182 record the accepted revision and execution; their lifecycle
is retained in the [discussion index](../../index.ndjson).
## Separate the Measurement from the Floor
Observed coverage describes one execution. A floor describes how much decline
the reviewed gate accepts. They serve different purposes even when their
numbers initially coincide. Five percentage points below 88.56% is 83.56%,
not a relative five-percent reduction.
Snapshot original floors before editing. For this revision, compute
`min(original_floor, measured_percent - 5.00)` in integer hundredths after
the auditor's downward truncation. This retains already sufficient floors
and prevents repeated subtraction from weakening the policy accidentally.
Keep floors fixed in later CI runs; future revisions require explicit review.
## Use Verification to Account for Observed Variation
Two full local runs passed, but system/runtime measured 81.26% initially and
81.19% during verification. The final 76.19% floor uses the lower observation.
All gates were rechecked against that unchanged verification report. Treating
the initial measurement as immutable would have left only 4.93 points of
headroom. Local evidence qualifies the executed host, not an unexecuted pipeline.
## Preserve Independent Checks
Margin changes affect acceptance floors only. Source ownership, exclusions,
nonempty evidence requirements and percentage arithmetic still apply. The
939 passing tests continue to check behavior independently of coverage.
Historical evidence remains unchanged; new evidence records the current
measurements, floors and fingerprints. A fresh snapshot explains the revision
without making an earlier run appear to have used the new configuration.