diff --git a/docs/STATUS.md b/docs/STATUS.md index 2f519dd..a763a77 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -82,6 +82,8 @@ queries across initial, scheduled and restored worlds. Boundary and full-capacit tests supplement the oracle. The benchmark records uniform/clustered worlds up to 100,000 entities. This is a linear correctness baseline, not a production spatial index. See the spatial contract and validation report for scope/evidence. +Native Release/ASan/analysis/format checks passed, as did all jobs in Gitea run +1409. All 72 Linux benchmark result checksums and match counts equal Windows. Before biology, resolve the relevant heredity and energetic contracts rather than treating proof particles as organisms. Exact game tick rate, NPC mutation, diff --git a/docs/architecture/SPATIAL_CONTRACT.md b/docs/architecture/SPATIAL_CONTRACT.md index a4ff945..fd72333 100644 --- a/docs/architecture/SPATIAL_CONTRACT.md +++ b/docs/architecture/SPATIAL_CONTRACT.md @@ -53,3 +53,11 @@ Clustered query centers are inside the same 32 mm patch as the entities; uniform centers span the entire domain. Dense result allocation/checksumming matters as well as scanning. This does not justify querying all 100,000 entities every tick; measure an index against this baseline when interaction frequency is known. + +GCC 14.2 Release in Gitea run 1409 produced identical checksums and match counts +for all 72 samples; raw output is retained in +[spatial-gcc142.jsonl](../engineering/results/spatial-gcc142.jsonl). +At 100,000 entities the corresponding Linux medians were 62.22/48.97/61.35/90.19 ms +for uniform and 36.42/139.94/77.52/76.47 ms for clustered scenarios (radii in the +table's order). Runner CPU allocation was not captured; these are within-runner +observations, not a cross-platform performance comparison. diff --git a/docs/engineering/VALIDATION.md b/docs/engineering/VALIDATION.md index 5a12105..45ecc3c 100644 --- a/docs/engineering/VALIDATION.md +++ b/docs/engineering/VALIDATION.md @@ -165,7 +165,7 @@ Native commands use `tools/windows-check.ps1 -Preset -Action check` and Release `-Action format`. Initial analysis flagged an unnecessary test-helper vector copy; the helper now takes a const reference. Final analysis, Release, ASan and formatting passed after applying the helper's required line -wrapping. Linux CI is pending the source push. +wrapping. Linux validation is recorded below. `build/release/evo-spatial-benchmark.exe` produced 72 measured records plus metadata in results/spatial-msvc1944.jsonl. One warmup and three samples per @@ -173,3 +173,11 @@ scenario; 1k/10k/100k entities, 128 queries, uniform/clustered positions, four r Timing includes result allocation, destruction and checksum work, excludes setup; no performance threshold. Desktop CPU load was not isolated. No cluster changes are required for this library increment. + +[Gitea run 1409](https://git.aeternalisgames.com/dingo/AEvolution/actions/runs/1409) +passed all four jobs for source `9b19509673d88683ee72e093e42534bfe151f928`: +Linux checks, ECS regression, separate TSan and image smoke/publication. +All 72 spatial benchmark checksums and match counts agree with Windows. +Raw Linux measurements are in results/spatial-gcc142.jsonl; 24 native scenarios +also have identical checksums across their three repetitions. No deployment +manifest, rules version, snapshot format or golden was changed. diff --git a/docs/engineering/results/spatial-gcc142.jsonl b/docs/engineering/results/spatial-gcc142.jsonl new file mode 100644 index 0000000..cb084dc --- /dev/null +++ b/docs/engineering/results/spatial-gcc142.jsonl @@ -0,0 +1,73 @@ +{"benchmark":"spatial_scan","seed":123456,"queries":128,"compiler":"GCC 14.2.0","build":"release"} +{"entities":1000,"clustered":false,"radius_mm":0,"sample":0,"milliseconds":0.907526,"matches":0,"checksum":"8421ae126c7ced25"} +{"entities":1000,"clustered":false,"radius_mm":0,"sample":1,"milliseconds":0.701831,"matches":0,"checksum":"8421ae126c7ced25"} +{"entities":1000,"clustered":false,"radius_mm":0,"sample":2,"milliseconds":0.459202,"matches":0,"checksum":"8421ae126c7ced25"} +{"entities":1000,"clustered":false,"radius_mm":16,"sample":0,"milliseconds":0.464218,"matches":95,"checksum":"1edb741fbb624c04"} +{"entities":1000,"clustered":false,"radius_mm":16,"sample":1,"milliseconds":0.464021,"matches":95,"checksum":"1edb741fbb624c04"} +{"entities":1000,"clustered":false,"radius_mm":16,"sample":2,"milliseconds":0.513037,"matches":95,"checksum":"1edb741fbb624c04"} +{"entities":1000,"clustered":false,"radius_mm":128,"sample":0,"milliseconds":0.624666,"matches":6333,"checksum":"197b09fd12d23f92"} +{"entities":1000,"clustered":false,"radius_mm":128,"sample":1,"milliseconds":0.640371,"matches":6333,"checksum":"197b09fd12d23f92"} +{"entities":1000,"clustered":false,"radius_mm":128,"sample":2,"milliseconds":0.636044,"matches":6333,"checksum":"197b09fd12d23f92"} +{"entities":1000,"clustered":false,"radius_mm":725,"sample":0,"milliseconds":0.902519,"matches":128000,"checksum":"a60febec7ab9e325"} +{"entities":1000,"clustered":false,"radius_mm":725,"sample":1,"milliseconds":0.898049,"matches":128000,"checksum":"a60febec7ab9e325"} +{"entities":1000,"clustered":false,"radius_mm":725,"sample":2,"milliseconds":0.892028,"matches":128000,"checksum":"a60febec7ab9e325"} +{"entities":1000,"clustered":true,"radius_mm":0,"sample":0,"milliseconds":0.465308,"matches":116,"checksum":"95f849d9956a1289"} +{"entities":1000,"clustered":true,"radius_mm":0,"sample":1,"milliseconds":0.487467,"matches":116,"checksum":"95f849d9956a1289"} +{"entities":1000,"clustered":true,"radius_mm":0,"sample":2,"milliseconds":0.465176,"matches":116,"checksum":"95f849d9956a1289"} +{"entities":1000,"clustered":true,"radius_mm":16,"sample":0,"milliseconds":1.52616,"matches":64597,"checksum":"f5f0cd6facbaebcd"} +{"entities":1000,"clustered":true,"radius_mm":16,"sample":1,"milliseconds":1.5056,"matches":64597,"checksum":"f5f0cd6facbaebcd"} +{"entities":1000,"clustered":true,"radius_mm":16,"sample":2,"milliseconds":1.51378,"matches":64597,"checksum":"f5f0cd6facbaebcd"} +{"entities":1000,"clustered":true,"radius_mm":128,"sample":0,"milliseconds":0.901782,"matches":128000,"checksum":"a60febec7ab9e325"} +{"entities":1000,"clustered":true,"radius_mm":128,"sample":1,"milliseconds":0.903477,"matches":128000,"checksum":"a60febec7ab9e325"} +{"entities":1000,"clustered":true,"radius_mm":128,"sample":2,"milliseconds":0.896949,"matches":128000,"checksum":"a60febec7ab9e325"} +{"entities":1000,"clustered":true,"radius_mm":725,"sample":0,"milliseconds":0.891145,"matches":128000,"checksum":"a60febec7ab9e325"} +{"entities":1000,"clustered":true,"radius_mm":725,"sample":1,"milliseconds":0.91268,"matches":128000,"checksum":"a60febec7ab9e325"} +{"entities":1000,"clustered":true,"radius_mm":725,"sample":2,"milliseconds":0.875146,"matches":128000,"checksum":"a60febec7ab9e325"} +{"entities":10000,"clustered":false,"radius_mm":0,"sample":0,"milliseconds":4.90472,"matches":1,"checksum":"5e0835545cadf5ab"} +{"entities":10000,"clustered":false,"radius_mm":0,"sample":1,"milliseconds":4.84548,"matches":1,"checksum":"5e0835545cadf5ab"} +{"entities":10000,"clustered":false,"radius_mm":0,"sample":2,"milliseconds":4.70069,"matches":1,"checksum":"5e0835545cadf5ab"} +{"entities":10000,"clustered":false,"radius_mm":16,"sample":0,"milliseconds":4.15979,"matches":1000,"checksum":"563898c0fe52a528"} +{"entities":10000,"clustered":false,"radius_mm":16,"sample":1,"milliseconds":3.9857,"matches":1000,"checksum":"563898c0fe52a528"} +{"entities":10000,"clustered":false,"radius_mm":16,"sample":2,"milliseconds":3.84411,"matches":1000,"checksum":"563898c0fe52a528"} +{"entities":10000,"clustered":false,"radius_mm":128,"sample":0,"milliseconds":4.79933,"matches":63039,"checksum":"81341d45cf02b3dc"} +{"entities":10000,"clustered":false,"radius_mm":128,"sample":1,"milliseconds":4.29077,"matches":63039,"checksum":"81341d45cf02b3dc"} +{"entities":10000,"clustered":false,"radius_mm":128,"sample":2,"milliseconds":5.03866,"matches":63039,"checksum":"81341d45cf02b3dc"} +{"entities":10000,"clustered":false,"radius_mm":725,"sample":0,"milliseconds":7.25112,"matches":1280000,"checksum":"de44a2f828c85925"} +{"entities":10000,"clustered":false,"radius_mm":725,"sample":1,"milliseconds":7.38898,"matches":1280000,"checksum":"de44a2f828c85925"} +{"entities":10000,"clustered":false,"radius_mm":725,"sample":2,"milliseconds":7.33284,"matches":1280000,"checksum":"de44a2f828c85925"} +{"entities":10000,"clustered":true,"radius_mm":0,"sample":0,"milliseconds":6.77942,"matches":1197,"checksum":"4f2e291b98eb201a"} +{"entities":10000,"clustered":true,"radius_mm":0,"sample":1,"milliseconds":6.37454,"matches":1197,"checksum":"4f2e291b98eb201a"} +{"entities":10000,"clustered":true,"radius_mm":0,"sample":2,"milliseconds":6.11733,"matches":1197,"checksum":"4f2e291b98eb201a"} +{"entities":10000,"clustered":true,"radius_mm":16,"sample":0,"milliseconds":18.2891,"matches":632575,"checksum":"3e1fad9f2fc9870b"} +{"entities":10000,"clustered":true,"radius_mm":16,"sample":1,"milliseconds":18.5971,"matches":632575,"checksum":"3e1fad9f2fc9870b"} +{"entities":10000,"clustered":true,"radius_mm":16,"sample":2,"milliseconds":18.3157,"matches":632575,"checksum":"3e1fad9f2fc9870b"} +{"entities":10000,"clustered":true,"radius_mm":128,"sample":0,"milliseconds":12.0864,"matches":1280000,"checksum":"de44a2f828c85925"} +{"entities":10000,"clustered":true,"radius_mm":128,"sample":1,"milliseconds":11.9077,"matches":1280000,"checksum":"de44a2f828c85925"} +{"entities":10000,"clustered":true,"radius_mm":128,"sample":2,"milliseconds":11.9309,"matches":1280000,"checksum":"de44a2f828c85925"} +{"entities":10000,"clustered":true,"radius_mm":725,"sample":0,"milliseconds":11.6429,"matches":1280000,"checksum":"de44a2f828c85925"} +{"entities":10000,"clustered":true,"radius_mm":725,"sample":1,"milliseconds":11.6287,"matches":1280000,"checksum":"de44a2f828c85925"} +{"entities":10000,"clustered":true,"radius_mm":725,"sample":2,"milliseconds":11.8076,"matches":1280000,"checksum":"de44a2f828c85925"} +{"entities":100000,"clustered":false,"radius_mm":0,"sample":0,"milliseconds":62.2151,"matches":15,"checksum":"50f14f987716b24b"} +{"entities":100000,"clustered":false,"radius_mm":0,"sample":1,"milliseconds":61.3303,"matches":15,"checksum":"50f14f987716b24b"} +{"entities":100000,"clustered":false,"radius_mm":0,"sample":2,"milliseconds":64.9766,"matches":15,"checksum":"50f14f987716b24b"} +{"entities":100000,"clustered":false,"radius_mm":16,"sample":0,"milliseconds":48.3948,"matches":9749,"checksum":"a767f72bb2d9af4a"} +{"entities":100000,"clustered":false,"radius_mm":16,"sample":1,"milliseconds":48.9725,"matches":9749,"checksum":"a767f72bb2d9af4a"} +{"entities":100000,"clustered":false,"radius_mm":16,"sample":2,"milliseconds":50.2148,"matches":9749,"checksum":"a767f72bb2d9af4a"} +{"entities":100000,"clustered":false,"radius_mm":128,"sample":0,"milliseconds":61.4713,"matches":628078,"checksum":"f9038f5eff67bf56"} +{"entities":100000,"clustered":false,"radius_mm":128,"sample":1,"milliseconds":61.3495,"matches":628078,"checksum":"f9038f5eff67bf56"} +{"entities":100000,"clustered":false,"radius_mm":128,"sample":2,"milliseconds":60.2233,"matches":628078,"checksum":"f9038f5eff67bf56"} +{"entities":100000,"clustered":false,"radius_mm":725,"sample":0,"milliseconds":90.1884,"matches":12800000,"checksum":"269e3e46ea192525"} +{"entities":100000,"clustered":false,"radius_mm":725,"sample":1,"milliseconds":101.383,"matches":12800000,"checksum":"269e3e46ea192525"} +{"entities":100000,"clustered":false,"radius_mm":725,"sample":2,"milliseconds":81.5129,"matches":12800000,"checksum":"269e3e46ea192525"} +{"entities":100000,"clustered":true,"radius_mm":0,"sample":0,"milliseconds":36.7429,"matches":12406,"checksum":"1b55d5c4811da009"} +{"entities":100000,"clustered":true,"radius_mm":0,"sample":1,"milliseconds":36.3331,"matches":12406,"checksum":"1b55d5c4811da009"} +{"entities":100000,"clustered":true,"radius_mm":0,"sample":2,"milliseconds":36.4235,"matches":12406,"checksum":"1b55d5c4811da009"} +{"entities":100000,"clustered":true,"radius_mm":16,"sample":0,"milliseconds":139.936,"matches":6036142,"checksum":"736f3c780654854d"} +{"entities":100000,"clustered":true,"radius_mm":16,"sample":1,"milliseconds":140.08,"matches":6036142,"checksum":"736f3c780654854d"} +{"entities":100000,"clustered":true,"radius_mm":16,"sample":2,"milliseconds":139.752,"matches":6036142,"checksum":"736f3c780654854d"} +{"entities":100000,"clustered":true,"radius_mm":128,"sample":0,"milliseconds":77.5218,"matches":12800000,"checksum":"269e3e46ea192525"} +{"entities":100000,"clustered":true,"radius_mm":128,"sample":1,"milliseconds":77.431,"matches":12800000,"checksum":"269e3e46ea192525"} +{"entities":100000,"clustered":true,"radius_mm":128,"sample":2,"milliseconds":77.53,"matches":12800000,"checksum":"269e3e46ea192525"} +{"entities":100000,"clustered":true,"radius_mm":725,"sample":0,"milliseconds":77.6189,"matches":12800000,"checksum":"269e3e46ea192525"} +{"entities":100000,"clustered":true,"radius_mm":725,"sample":1,"milliseconds":76.4663,"matches":12800000,"checksum":"269e3e46ea192525"} +{"entities":100000,"clustered":true,"radius_mm":725,"sample":2,"milliseconds":69.9511,"matches":12800000,"checksum":"269e3e46ea192525"}