Files
aevolution/docs/engineering/ENVIRONMENTAL_QUALIFICATION.md
T

93 lines
5.1 KiB
Markdown

# M6.5 environmental qualification and cost report
Recorded 2026-09-27. Scope: ADR-0055's synthetic, one-site/two-actor fixture.
M6.5a-d are implemented and qualified natively. Linux CI remains an independent
required delivery check; no unobserved CI success is claimed.
## Reproduce
```powershell
.\tools\windows-check.ps1 -Preset release -Action check
.\build\release\evo-environmental-qualification.exe --long
```
CTest runs 16 seeds with 4096 ticks each; `--long` uses 65536 ticks per seed and
adds three 100000-step timing samples. Linux uses the same executable without
`.exe`. The qualification target is part of ordinary CI tests, with a 120-second
cap. Timing is informational, never a noisy portable pass/fail threshold.
## Evidence
| Check | Result |
|---|---|
| Closed energy/C/N/P/other balance | Independent checked sums after every seeded tick |
| Continuous versus restored process | Reports and canonical bytes match; restore every 997 ticks and at run end |
| Source/progress | Disabled/unfunded source, frozen residuals, overflow with carried numerator, no heat recycling (existing contract tests) |
| Limiting resources | Water, C, N, P and organic-other each independently block growth when absent |
| Conversion endpoints | 0/1000 capture and assimilation, retained water cannot become edible biomass |
| Rollback | Late consumer capacity failure undoes prior capture/growth and partial staged bite |
| Input/config admission | Wrong rules/world/IDs, zero source/duration/area/denominators/recipe/cost, invalid efficiencies and temperature limits |
| Temperature | Producer limits in contract suite; consumer inside/outside inclusive endpoints with whole-tick rejection |
| Codec | 13 targeted malformed outer states, trailing bytes, 512 bit mutations with recomputed checksum; accepted alternatives must round-trip canonically |
| Tick exhaustion | Synthesized valid no-op trace ending at u64 max; retry succeeds, wrap/expired input rejects, bytes unchanged |
| Memory | Accounted owned resource bytes remain constant throughout seeded runs |
The 512 mutations produced 3 valid alternative states. That is not an authentication
failure: the format has a corruption checksum, and cannot distinguish a legitimate
alternative state from someone intentionally rewriting and resealing it. Invalid
states reject; accepted states must satisfy canonical restore/replay validation.
The mutation driver is a bounded fuzz-style smoke test, not a coverage-guided fuzzer.
Final extended run:
```text
seeds=16 ticks_per_seed=65536 paired_steps=2097152
captured=2891204 grown=1479838 bites=329231
fingerprint=93a9f9b296caac36 validation_seconds=1.132057
```
There are 1048576 logical ticks and an uninterrupted comparison branch for each,
so 2097152 actual advances. Seeded inputs use the repository's explicit SplitMix64
stream, including source on/off, temperature gates and affordable matter bites.
Assimilation varies across 0, 500 and 1000. Energy bites are separately tested in
the contract/rollback cases. Fingerprint is a diagnostic XOR of final-state hashes,
not an authentication token or replacement for the per-seed byte comparisons.
No new golden or simulation law was changed to obtain these results.
## Local cost sample
Windows x64, MSVC 19.44 Release, AMD Ryzen 7 9800X3D, 8 cores / 16 logical CPUs.
Not a controlled benchmark host and not the deployment R730xd. The step sample
uses one producer/consumer fixture, source enabled, fixed eligible temperature,
no feeding, and includes normal retry-window/anchor maintenance. The separate
seeded qualification above includes feeding, repeated audits and restore work.
| Metric | Observed |
|---|---|
| 100000 steps, three samples | 0.027525 / 0.026734 / 0.026783 seconds |
| Median step batch | 0.026783 seconds |
| Accounted resources | 390216 bytes |
| sizeof process owner (includes retry array and anchor) | 13400 bytes |
| Two reserved 64KiB scratch allowances | 131072 bytes |
| Combined minimum admitted budget | 534688 bytes |
| Final complete snapshot | 30615 bytes |
| Restore including retained-history replay | 0.197700 / 0.240200 / 0.197300 ms |
Accounted bytes are not RSS: allocator headers, stack beyond documented scratch,
and caller-owned query/output buffers are excluded. Snapshot construction requires
the separate bounded output allowance documented by the schema. Small cache-hot
fixtures do not predict MMO tick capacity, networking cost or ecology-worker scale.
No optimization or performance SLA is justified by this measurement alone.
## Remaining scope
Historical scope below is superseded by M6.6/M6.7 and the
[M6.8 integrated qualification](ENVIRONMENTAL_SLICE_QUALIFICATION.md). The M6.5
owner-size measurements above remain historical; M6.6 enlarged bounded receipts.
M6.6: terminal events with retained corpse resources and bounded decomposition.
M6.7: scheduling intervals/catch-up. M6.8: the full death/nutrient/regrowth slice and
longer ecological/cost analysis. This gate does not prove ecological stability,
starvation mortality, player logout fairness, crash-safe publication or host-loss
recovery. M2/M3 maintenance and reproduction rules remain unchanged.