Files
aevolution/docs/engineering/ENVIRONMENTAL_QUALIFICATION.md

5.1 KiB

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

.\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:

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. 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.