PureOne commited on
Commit
9d6c005
·
verified ·
1 Parent(s): 280dced

AUREOLE-R 3.0.0-hf.1: standalone public research release

Browse files

Verified paper, source, prior, raw evidence, protocols and machine-readable research indexes. Finite CPU reference; full unified SR/RR/FG remains unvalidated.

This view is limited to 50 files because it contains too many changes.   See raw diff
.gitattributes CHANGED
@@ -33,3 +33,10 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
33
  *.zip filter=lfs diff=lfs merge=lfs -text
34
  *.zst filter=lfs diff=lfs merge=lfs -text
35
  *tfevents* filter=lfs diff=lfs merge=lfs -text
 
 
 
 
 
 
 
 
33
  *.zip filter=lfs diff=lfs merge=lfs -text
34
  *.zst filter=lfs diff=lfs merge=lfs -text
35
  *tfevents* filter=lfs diff=lfs merge=lfs -text
36
+ AUREOLE_R_v2.0.0_Research_Release.pdf filter=lfs diff=lfs merge=lfs -text
37
+ AUREOLE_R_v3.0.0_Certified_Innovation_Rendering.pdf filter=lfs diff=lfs merge=lfs -text
38
+ figures/architecture.png filter=lfs diff=lfs merge=lfs -text
39
+ figures/change_recovery.png filter=lfs diff=lfs merge=lfs -text
40
+ figures_v3/innovation_results.png filter=lfs diff=lfs merge=lfs -text
41
+ legacy/AUREOLE_Unified_Latent_World_Model_v1.0.0.pdf filter=lfs diff=lfs merge=lfs -text
42
+ legacy/figures/architecture.png filter=lfs diff=lfs merge=lfs -text
.gitignore ADDED
@@ -0,0 +1,19 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ .venv/
2
+ .venv-publish/
3
+ __pycache__/
4
+ *.pyc
5
+ build/
6
+ dist/
7
+ *.egg-info/
8
+ demo_output/
9
+ reproduced_results/
10
+ figures_reproduced/
11
+ retrained/
12
+ validation_reproduced.json
13
+ .env
14
+ *.token
15
+ publication_receipt.json
16
+ publication_validation_local.json
17
+ innovation_reproduced/
18
+ queries_reproduced/
19
+ innovation_demo/
AGENTS.md ADDED
@@ -0,0 +1,11 @@
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Research-agent entry point
2
+
3
+ This repository is AUREOLE-R scientific version 3.0.0, publication edition 3.0.0-hf.1.
4
+
5
+ Read `README.md`, `CLAIMS.json` and `AI_AGENT_INDEX.json` before summarizing conclusions. `MANUSCRIPT.md` is the complete standalone paper; `llms-full.txt` is a convenience full-text bundle. Current root metadata governs v3; `history/` and `legacy/` are explicitly older evidence.
6
+
7
+ Preserve distinctions between proved-under-assumptions, recorded experiment, estimate and hypothesis. Cite the experiment, comparator, phase and cost boundary with every numerical claim. The 98.40% MSE reduction is specific to smooth known motion and its stated reset baseline. The 76.85% saving is a physical-query count including warmup, not a GPU speedup. The included weights are one small visibility prior, not a full unified renderer. No 100% scientific maturity, GPU benchmark, DLSS compatibility, peer review or arXiv/DOI identifier is established.
8
+
9
+ Use `REPRODUCIBILITY.md` for commands. Run reproductions into their default new output directories; preserve recorded results, frozen protocols and weights. Use `python scripts/publish_hf.py` for an offline integrity check. The `--publish` flag is a separate explicit public mutation; do not upload or request credentials merely to read or reproduce research. Never put tokens into source, reports or command arguments.
10
+
11
+ For extensions, keep assumptions, negative outcomes and accounting visible. Use the immutable Hub commit in citations and bug reports. Publication workflow tests in `publication_tests/` are separate from scientific tests. No subagent/delegation requirement is implied by this file.
AI_AGENT_INDEX.json ADDED
@@ -0,0 +1,78 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "version": "3.0.0",
3
+ "start_here": [
4
+ "README.md",
5
+ "STATUS.json",
6
+ "CLAIMS.json",
7
+ "docs/RELEASE_SCOPE.md"
8
+ ],
9
+ "math": [
10
+ "MANUSCRIPT.md",
11
+ "docs/INNOVATION_THEORY.md",
12
+ "THEOREM_INDEX.md"
13
+ ],
14
+ "implementation": [
15
+ "aureole/certificates.py",
16
+ "aureole/innovation.py",
17
+ "docs/CERTIFICATE_API.md"
18
+ ],
19
+ "evidence": [
20
+ "results_v3/innovation_report.json",
21
+ "results_v3/innovation_raw.csv",
22
+ "results_v3/queries_report.json",
23
+ "results_v3/queries_raw.csv"
24
+ ],
25
+ "reproduce": [
26
+ "scripts/demo_innovation.py",
27
+ "scripts/benchmark_innovation.py",
28
+ "scripts/benchmark_queries.py",
29
+ "scripts/validate_release.py"
30
+ ],
31
+ "prior_evidence": [
32
+ "results/rendering_report.json",
33
+ "results/followup_report.json",
34
+ "history/v2/STATUS.json"
35
+ ],
36
+ "warning": "Current root metadata governs v3. Historical v2 checks and claims retain their earlier scope. No GPU/full SR/RR/FG validation.",
37
+ "publication_edition": "3.0.0-hf.1",
38
+ "machine_entry_points": [
39
+ "llms.txt",
40
+ "claims.jsonl",
41
+ "EVIDENCE_INDEX.json",
42
+ "FILE_CATALOG.json",
43
+ "metadata/research.jsonld"
44
+ ],
45
+ "expert_route": [
46
+ "EXPERT_REVIEW_GUIDE.md",
47
+ "docs/INNOVATION_THEORY.md",
48
+ "aureole/innovation.py",
49
+ "results_v3/innovation_report.json",
50
+ "results_v3/queries_report.json"
51
+ ],
52
+ "reproduction_route": [
53
+ "REPRODUCIBILITY.md",
54
+ "DATA_DICTIONARY.md",
55
+ "experiments_innovation.json",
56
+ "experiments_queries.json"
57
+ ],
58
+ "full_text": "llms-full.txt",
59
+ "publication": [
60
+ "START_HERE.md",
61
+ "PUBLICATION.json"
62
+ ],
63
+ "historical_precedence": "Root v3 scope and results_v3 take precedence for current claims; history and legacy preserve earlier snapshots.",
64
+ "citation": "CITATION.cff",
65
+ "scientific_preservation": "publication/SCIENCE_PRESERVATION.json",
66
+ "research_objective_aliases": [
67
+ "unified DLSS latent world model",
68
+ "persistent neural world state",
69
+ "super resolution",
70
+ "ray reconstruction",
71
+ "frame generation",
72
+ "neural rendering",
73
+ "denoising",
74
+ "disocclusion",
75
+ "adaptive sampling"
76
+ ],
77
+ "alias_scope": "Research objectives, not validated product capabilities."
78
+ }
AUREOLE_R_v2.0.0_Research_Release.pdf ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:150741a0c8507066eb67034964bf8919823c9b551897bf0cedec1991b5091be3
3
+ size 974277
AUREOLE_R_v3.0.0_Certified_Innovation_Rendering.pdf ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ version https://git-lfs.github.com/spec/v1
2
+ oid sha256:75d2fc744ca6e2cf09a396450b6f40744bfedd084933e5e0698417ccc57923ed
3
+ size 1311904
CHANGELOG.md ADDED
@@ -0,0 +1,24 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Publication edition 3.0.0-hf.1
2
+
3
+ - Added searchable Hub card and expert/AI-agent reading routes.
4
+ - Added exact-result evidence selectors, citation formats, artifact inventory and synthetic-data dictionary.
5
+ - Added hidden-token Windows launcher, account checks, byte-matching retries, parent-commit guard and anonymous public verification.
6
+ - Preserved all scientific evidence and source; no new rendering experiment or performance claim.
7
+
8
+ # v3.0.0 - Certified Innovation Rendering
9
+
10
+ Added six scoped results, geometric validity, residual-support elimination, sixteen tests and two new held-out protocols. Retained v2 mathematics, code, weights and adverse evidence. Updated standalone manuscript, API, agent metadata and publication launchers. No new model training, GPU execution or external publication.
11
+
12
+ # Changes in 2.0.0
13
+
14
+ Version 1 supplied a broad world-model specification, ten scoped mathematical propositions, six synthetic witnesses and fourteen checks. Version 2 adds a working physical estimation loop rather than relabeling the original proposal as finished.
15
+
16
+ - Add a frozen exact-integral correction API, with tests exposing same-sample refitting, wrong-integral bias and clipping bias.
17
+ - Add canonical visibility memory, numeric checkpoint persistence, namespace checks, trust epochs and observation-triggered revision.
18
+ - Train and package one small visibility prior, with explicit train/validation/test scene splits and a model card.
19
+ - Execute a direct-light shadow benchmark on eight held-out scenes; retain active-sampling and stale-state failures.
20
+ - Execute an independent eight-scene follow-up testing trust revocation without an oracle event flag.
21
+ - Derive five additional scoped results: conditional correction, residual-risk information value, estimator equivalence, detection-delay limits and a fixed-budget concentration bound.
22
+ - Package an installable NumPy API, physical demo, new tests, exact replay evidence, publication helper, full manuscript and original v1 archive.
23
+
24
+ There is no full SR/RR/FG implementation, GPU backend, game integration, broad calibration result or production speedup. Scientific maturity is estimated at 65%; the project remains classified as meaningful, not major or transformative.
CHECKSUMS.sha256 ADDED
@@ -0,0 +1,195 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ c801655ac6b3603396c495eff65a26972868eebb16c7dfc5be51b3b8e7edd4c8 .gitignore
2
+ 733a1ce5e1b1dc5031e4eb820f1c7077e3d40692261bb909d1bc4064d9266ebd AGENTS.md
3
+ 9f46112aa244ae47a7a606097cfb653194be0f47a99be83775915dce7c3403fc AI_AGENT_INDEX.json
4
+ 150741a0c8507066eb67034964bf8919823c9b551897bf0cedec1991b5091be3 AUREOLE_R_v2.0.0_Research_Release.pdf
5
+ 75d2fc744ca6e2cf09a396450b6f40744bfedd084933e5e0698417ccc57923ed AUREOLE_R_v3.0.0_Certified_Innovation_Rendering.pdf
6
+ 4afcd70a9264a0e408ce199a4404e2ddcdb5a69feeca49a9679e337abbd4869e CHANGELOG.md
7
+ 906a94019da72b921ee9ddd52db30687a5772b9209e65b5ca5ba11568644fd8b CITATION.bib
8
+ 0c881654dfb31607e36a6de0aa84276d245073e283d3bf89ae6929c06985659d CITATION.cff
9
+ 2de213f65634ad0de8e98883ece6d91b9e009b7c1433e85fba5cc02faee8bacc CLAIMS.json
10
+ b990c53386ab9b8a058bdf911d44d03c3026f995f59b60bdc591ac54a7f4f953 DATA_DICTIONARY.md
11
+ ad2b245b2214647ee6112c33910484beccd5d56f9d5e01e288d0fe1e6f42c7b3 EVIDENCE_INDEX.json
12
+ 0b72c693c885b71a4cee5b90fbe12e8dc2b461cd821a27f13e4ebdc8b535958b EXPERT_REVIEW_GUIDE.md
13
+ 12ebf395752824d75391cb1cf0defe1642014731803ddf84462e6e18c56707a6 FILE_CATALOG.json
14
+ da83b080f0e7fa682117f5222173acb1f52203ada97c6baba1f1f2676f70d635 LICENSE
15
+ d60ca7f87a194afa20cefd55fcec981ef7a5571abac397365dcd16474acafd8d MANUSCRIPT.md
16
+ bb153d83af1ce2d7fb906966c0b3788ad9d0bc23170c5ce5bb1912523e31b3e5 MODEL_CARD.md
17
+ 628f70c289bbac60c917a5aa6a8a96e7bf451448a4d61388370d9452975d03dc PUBLICATION.json
18
+ a640e1a071c35d1e3fe971aa65c8bbe28cae3a4e348716155ea1fc62808ae2c0 PUBLIC_RELEASE_NOTES.md
19
+ 52a09fada0e33b4a42ac16d2376b4cf3fdc11348e352820b2ee9e93f9c27ee80 PUBLISH_HF.bat
20
+ cdffba2de9bd02aeb6d8eef0194e7e0dbc1da3c9d5252908612b9de858c301c1 PUBLISH_TO_HUGGINGFACE.bat
21
+ 85580701af138588bb7b0dffa703d449e357e90fa5d16f10669558705ab0d757 README.md
22
+ 3e84976b0aed5c002b1f644bb733fe7068fd47cf1a54d5df3377ac7a23d297c5 RELEASE_MANIFEST.json
23
+ 39c830e7953ea587164fbf6af1c6fa351ca55b28320bd064c524d4e250b521e7 RENDERER_INTERFACE.md
24
+ c3f5bc518d2330ec6e27098a57b0f6d735ccc3a0b29001b3f24b4418c5ce2ccf REPRODUCE.bat
25
+ 9661a06e31426f4af41cb037eb411eb937bcdd64752c928d1413865aae966c38 REPRODUCIBILITY.md
26
+ 903279b3ec6d35e1a77a2597834998170b1ce1536fda2ccef34d867ab8ffd864 REQUIREMENTS_MAP.md
27
+ eaed23cf10668446ac3afc238199eca0bd8eacf5a957b57383cc493d89705e22 RUN_DEMO.bat
28
+ 5a0845e54a9bd7cd237958aab17c5e6fb49e93560570d4c24890e16b999b23b1 RUN_INNOVATION.bat
29
+ d6cfeb037248793e3dc0cb282dc3b72e72c60eabb5be4b4501dd4bd5e3e41429 START_HERE.md
30
+ b544bbda77c4192cfcaa0f70eca332accda4cf5595c0c421c31e3c845c9260e3 STATUS.json
31
+ 807151429bdcae24b99e761cfec88e18909ee253931a924acfebe6940a6b134d THEOREM_INDEX.md
32
+ 4386f21756aec41c009d1274e01e96de2ebccee9c6e95994e7707252f83bf74f aureole/__init__.py
33
+ 1a84836b328a3405498194622474bba37c968634791bc0fe7964ad8fca63650c aureole/certificates.py
34
+ 3c9c0316ce9b98b7acb5b36700a06a6f5c65317fb073381605fa9a7866afbf56 aureole/core.py
35
+ f522dfce35f5fc4f2777a7b6a341d0fe426120456cd5fb66a13aba603f55062f aureole/innovation.py
36
+ d0d4f612acde5e3f78deb6360712c38ad39c5ca1584edca674c4158f31ed7bb6 aureole/memory.py
37
+ 841b6f94cc34e61435885a9a497ae2119dc7b47900c7e8bafe46127d3c919411 aureole/renderer.py
38
+ 4c1958e8567b708d41291d6d18a1420fbe4fe1081ebe20e176dc0671a6ea4963 claims.jsonl
39
+ c98b0c1b574d8bde702ca4b26f50dab4864fca58d0a818fa10584963359a61d9 docs/CERTIFICATE_API.md
40
+ ce4c91b6b8c7c67dea1d15e5cd29bbf8e4dcb194239ab6462b9a54a30d5f4fba docs/ERRATA.md
41
+ 4571ba92ef00bee38b1569ba54aad157d4126b9cb8865d0b9ea3a0d155dd5360 docs/ESTIMATOR_CONTRACT.md
42
+ 4fd4837ff95487ce5bb3a75a4f41cfd42f3457b309168332fb831d916edfa142 docs/INNOVATION_THEORY.md
43
+ bcb48e239ba832c914cc850cfd96f59161ed722b36e887726e0ce2eb4ebd0fd5 docs/PHYSICAL_EVIDENCE.md
44
+ a23850fd37c33640cb69cd843799dca6e97c58bb7eeb1870c2e09e9add9cb83e docs/RELEASE_SCOPE.md
45
+ b9c5d6ea4cd136f03d2ec749487a477ffa08a27534de5df2dce6235ce8b9564b docs/RESIDUAL_THEORY.md
46
+ 73363e858bb770f72b9a3dd77e60e1032ca10f685f806edc47182d0e746c2140 experiments.json
47
+ a1daabb6dc4672d7cd66aa238271919a7c3d55918ea8aa03703be37eafbfaa3c experiments_followup.json
48
+ 743f7091b6997cd6c9e182d2a4f75db5eaadc8b892e31c9a5c01263eb0a4facd experiments_innovation.json
49
+ 59540fb9ebbb7c35f487df7227bf0ae06fde38f1959c0746192b7463dc363bc6 experiments_queries.json
50
+ 7410b8a61c604489b58fc44473f2b504457850e1e0d9ba68e7133b8913bb4d1f figures/active_sampling.pdf
51
+ a3a0b5d291f3e41f8d4767a67e426fa1ff327ce457bd1e16afd57ccd67a9ed81 figures/active_sampling.png
52
+ 23660aa55c2b2f8afcb2d1828e31cfd0d4ec9739a7702c4ca689e39deec2765e figures/architecture.pdf
53
+ fb99bab78e597b834be55e3e8340fe430d2fef191f3ca7c88e5f78da6b18c862 figures/architecture.png
54
+ 9d9489375e56c14fe752037ccad94a6d8fc2631bb9a37b0aa21ff776633aa31a figures/atlas_changed.pdf
55
+ 35a9ce95ab0becc71ac0120db05c85681a9971cf3b0245a1d6b7d186b44e8cd8 figures/atlas_changed.png
56
+ ab5099d9fd75537a45328a3633227d092e176a005adc0d41f5a94dc45a613865 figures/atlas_static.pdf
57
+ 6446e8ab1b6d0b5f067bc207f4882465c84189c650e09c3a4058ea4295551db4 figures/atlas_static.png
58
+ 5ad9cbbd89e958a8421fe7efd23dfb9ad476059ebdf2a273e4957e6e78791d2d figures/atlas_views.pdf
59
+ 4bce5a77dba3953de7d4323cb62e0c71c9988026d9eab1bb28e226c6d06c8d4b figures/atlas_views.png
60
+ 0679014ccfd6bcc2c25fcb07d31d324ee41e1803e10132efe512eeefc3a3f345 figures/change_recovery.pdf
61
+ 02de3c2fd030220be8e061738202cda5aa37bb9fa9100e760cd3b034ed073219 figures/change_recovery.png
62
+ cf45c6e43c504e2b1822507cf5d28740ef9108a181c31bfcebf6dc1de292f213 figures/compression.pdf
63
+ c75c40fd7ef4508dc5669e12bde7d1b469e234a18de7a0c7c2871ec184166d5b figures/compression.png
64
+ 8fb3a5bda028e4e5accccf4cd763eeb4a3965d4449390426e4e5ae9659af9891 figures/physical_frames.pdf
65
+ e24a02875feaba16547afc1ef65640225e5a4710238769a77f89217c4af564c8 figures/physical_frames.png
66
+ 3eb211731f273a1ae596611af396b5164746ead32cbe5738811cd611400984bf figures/physical_results.pdf
67
+ 20a8fbd35bdec10411d279a942eaafd0ae2f4d765c15e22d8f79179abf16288f figures/physical_results.png
68
+ b02cbe7f10c825138e1ded8eda3f44e0a0eedfd705f4531bf56551a6bfc5191b figures/training_curve.pdf
69
+ 5f0bc2553c6a07a7aec6c7b13bd7fa5321acdff11e2c3302cc712778593cb36a figures/training_curve.png
70
+ 65d90ea7cd392b5c51ec41d49bf7767b1ec494a5a35ae5bfdb0d7f78e60e925c figures_v3/innovation_dynamics.pdf
71
+ a66978fd14a84114a7df22c508bffe5b6f322b6ff8ae5e3f30f0c8e21503d183 figures_v3/innovation_dynamics.png
72
+ 6e1c9908547bd928acbc87fcc5b50400a6e600d6c6cc3c5eefff73de7ee53cd7 figures_v3/innovation_results.pdf
73
+ e41747c9d914ce23c0c23c0da9e5cb6180be9db3a2f1772e5602c96c9f5a72ea figures_v3/innovation_results.png
74
+ 3dd1ac2407d2de8685b12b3bab043f73b73d4d6e941d0065d3588d4da75ee2a9 figures_v3/query_readouts.pdf
75
+ 57dd803d708c09df037cce03e9e6f09043041f4166a24f12ec659cb8f7e110d1 figures_v3/query_readouts.png
76
+ e72bde00d8581c0813e708aeac5d3f56156b11f071df9de57758e4a636c73349 history/v2/AI_AGENT_INDEX.json
77
+ 360b8328666566f448e625e70f84005bcccc2d843316d938c34fccfa775edf1a history/v2/CLAIMS.json
78
+ 340bf5a52873cc08870eaff0ae8e1c18795cb10083264a25b1bf16ff14a15ed9 history/v2/MANUSCRIPT.md
79
+ 9f3944a9d021dfcca99cc305d4acb07ec856ed3eb26cfaeec95f9a89b7b6255b history/v2/ORIGINAL_CHECKSUMS.sha256
80
+ ae543a4de02938672f90516590822dae576044899f635d9764713806fdceae1c history/v2/README.md
81
+ b58a353575b7458599937d5467771647cd99f1463d6137005ca4f873c3b956c8 history/v2/RELEASE_MANIFEST.json
82
+ 09faa4018c9258229ad614d9911372527fd9ea76e6e45b1f490b2682673dd489 history/v2/STATUS.json
83
+ 56e1cf0c4a7bab62d839d52f4faa8c08c9609663cfc0b01f868497fc22ecf1cd history/v2/THEOREM_INDEX.md
84
+ 2e4b095fb5866af3e14a8f640293fc5ebe82ab545634c430ba3795ba088178b5 history/v2/validate_release.py.txt
85
+ 4452d20bab85063c90dcfd66dc954504dae751f0fb3eee8bd2887e8966afd204 history/v3_scientific_release/AI_AGENT_INDEX.json
86
+ 25d5b12948e3084738cf87526bcab1eddc66f427dec0aec17c551718fb4ee523 history/v3_scientific_release/CHECKSUMS.sha256
87
+ 05c04a44f32a8a47492f217441831de0de9dbae27daa9eee59be7d17d4f89e41 history/v3_scientific_release/CITATION.cff
88
+ 7068db4284a983957bac3afef5d2fbacda960b05095d10bb6eb6728f47d643df history/v3_scientific_release/README.md
89
+ 318c30f09490fa867bb2e1a104ed6c0492ec0a285e3851293d19844e059c59ec history/v3_scientific_release/RELEASE_MANIFEST.json
90
+ 02764360a9de179b53abf867a4b45d73e69afb6cce21d6f36cde617ea6711f00 legacy/AI_AGENT_INDEX.json
91
+ 33a42b59af5a1840ea9c4162557c5292f2d1c7f3c47462adc6c45a82a520cea6 legacy/AUREOLE_Unified_Latent_World_Model_v1.0.0.pdf
92
+ 8b6e93ff17d491f40a4dcf91273cdd1c8caaea210e2ec6d076bdf7138ff99a3f legacy/CITATION.cff
93
+ 0abe2f8575e904f96f08799174ab900cf816fbe27fc0d21f60f9bff42bbc0280 legacy/CLAIMS.json
94
+ 9f34a1912b031b78f5a4884130487109d6ec6dc40987d7034daeb773aaa4db66 legacy/MANUSCRIPT.md
95
+ 97aa83f1ddb9ad3d15a4b3b3db42c6b30f235f09ae31e859be55104a7396496b legacy/README.md
96
+ ebdd6fbd6c051b5c9ffea86c05e2d991df46d83ff27bd0e290b8f7f12d3eac28 legacy/RENDERER_INTERFACE.md
97
+ 4da28323f42ebb2417783a1bb2607a25d905d6416566140d0f8618ca01f37db5 legacy/REPRODUCE.bat
98
+ 77cdc812d1206d8d40df47c139497a84763379b223012224933b2114692d8b5d legacy/REQUIREMENTS_MAP.md
99
+ bdfeff36b0b5ba29fb83a15d9be9466f42396165573abba907399af96ae76d87 legacy/STATUS.json
100
+ 6e3f8c51e5dae3283270c1321565a2ae16b0caec3b7e149ff37f303b182ceed7 legacy/THEOREM_INDEX.md
101
+ 18ec01f18894aa2607ec99943046a492cde6c1fd47c534ed5d7a156921a4bdf7 legacy/code/aureole_core.py
102
+ 9e88b808317d778df993e2d71fb6586233b4dbeaca4653e2c332f0019953535c legacy/code/build_pdf.py
103
+ c3a10c57b8d20c719d0fa11f8aae297b87884db8f8cd5a91f52dab32ff6f0f29 legacy/code/draw_architecture.py
104
+ 84d851a04f654c20d92ad32edc2b162564ffe8328a06ac1f5a6533488596861f legacy/code/run_experiments.py
105
+ 1e85cb5ac7780cbd48a8e7a9ea7516e84e4f94a191d19fd685b4b3d2cb8e847d legacy/code/test_theory.py
106
+ 7410b8a61c604489b58fc44473f2b504457850e1e0d9ba68e7133b8913bb4d1f legacy/figures/active_sampling.pdf
107
+ a3a0b5d291f3e41f8d4767a67e426fa1ff327ce457bd1e16afd57ccd67a9ed81 legacy/figures/active_sampling.png
108
+ 23660aa55c2b2f8afcb2d1828e31cfd0d4ec9739a7702c4ca689e39deec2765e legacy/figures/architecture.pdf
109
+ fb99bab78e597b834be55e3e8340fe430d2fef191f3ca7c88e5f78da6b18c862 legacy/figures/architecture.png
110
+ 9d9489375e56c14fe752037ccad94a6d8fc2631bb9a37b0aa21ff776633aa31a legacy/figures/atlas_changed.pdf
111
+ 35a9ce95ab0becc71ac0120db05c85681a9971cf3b0245a1d6b7d186b44e8cd8 legacy/figures/atlas_changed.png
112
+ ab5099d9fd75537a45328a3633227d092e176a005adc0d41f5a94dc45a613865 legacy/figures/atlas_static.pdf
113
+ 6446e8ab1b6d0b5f067bc207f4882465c84189c650e09c3a4058ea4295551db4 legacy/figures/atlas_static.png
114
+ 5ad9cbbd89e958a8421fe7efd23dfb9ad476059ebdf2a273e4957e6e78791d2d legacy/figures/atlas_views.pdf
115
+ 4bce5a77dba3953de7d4323cb62e0c71c9988026d9eab1bb28e226c6d06c8d4b legacy/figures/atlas_views.png
116
+ cf45c6e43c504e2b1822507cf5d28740ef9108a181c31bfcebf6dc1de292f213 legacy/figures/compression.pdf
117
+ c75c40fd7ef4508dc5669e12bde7d1b469e234a18de7a0c7c2871ec184166d5b legacy/figures/compression.png
118
+ 25250975a249376f6757eb7a15c58c4afa86d3925ac4e54f4bcf63e07645e2d5 legacy/pdf_style.tex
119
+ 583a63574474f27e70c90378fea7e459c2bc4384399088b496f89eb47f10ee70 legacy/references.json
120
+ 815360a00e0e1d7a128cade3de11b66d3fe997cbd6e2c69f8081eb9bc8b88197 legacy/requirements.txt
121
+ 71eb0bb6c520ac410e1b38e9531469c2bc565f9081e575741c70265cde724913 legacy/results/active_curves.csv
122
+ bbe347623ff8a2e565562c463e04af681ac80d80ba3b0ba5037dd0bbfbb4e79f legacy/results/active_samples.csv
123
+ 3a1bff4992098ee3fc4cfeca65283c84a6fe6a49cee6597a5d00684185023aa9 legacy/results/atlas_changed.csv
124
+ 412d55748e648ced5dfbc8d405a07b6a8c6867b4cd07ba73e19a3071f71749d6 legacy/results/atlas_static.csv
125
+ 4714487d4ef4979931a9b2c5cc00fffda0ed6d0f5f4aa486d1cae539e973ed10 legacy/results/compression.csv
126
+ 49bfecf8fd9a6f606adb2b480c26d55829facb6fcd4ea39fc187f30bfed97ff1 legacy/results/document_validation.json
127
+ e098cf398fd2101dcb7026e1051f54fb69fc75ac9d81eb59882c33cf4267a941 legacy/results/experiment_report.json
128
+ 20951153df88842d40f675c73941818e479361774f4ddccc8eafb4c4054c8cb0 legacy/results/tests.log
129
+ 799188c3cb7334f9248908692b349d9042df20bfcae1b67a012b81f8dd4521b7 llms-full.txt
130
+ 7e8a43a5276e54d32631ebc877bfe43f9b8cdab62f6ffad98f018bbca8d5da92 llms.txt
131
+ 11576b29f3ca6bfb5217b3b77a2ea7cacc62438d56b5fed2286fee81937f7ec8 metadata/research.jsonld
132
+ f738bef865c7bf496b2fba134f456475749cddd60f6341164829b41535e56e58 models/visibility_prior.npz
133
+ da0ce2212eb9bf7f43abb4312940246ccf2b620e106704bb0a3e3620139df2bc pdf_style.tex
134
+ 514100454ee48a7fccdcef89962fe3f17d5ffbcf1674eddd1730e92588026395 publication/FILES.txt
135
+ 5e33b3ee997c1ab4c83dd15c1e69a2eacf93de604f1b1a03c05d420e1622a7ae publication/SCIENCE_PRESERVATION.json
136
+ adf7b9671874c93de3c2c140626807a2764db18729b83edb99acbd6fe9e9d155 publication_tests/test_publisher.py
137
+ f09350674fb82adba91247c47bfc53c89ce48dea4b96483b83591ed816492a8e pyproject.toml
138
+ 5dcb2e1419926545d1543aced6aff288786c72246b8f1942dc88fe5872a7d891 references.json
139
+ 50c32fac5b0131f67843be9932a6e6891279dd410511a1ca5a1b528ba8b5fddb requirements-publish.txt
140
+ 3393bed0efa2cc30106e4981e3ded6ef6c8d9294f84eb87fa45bf28a63252dca requirements-training.txt
141
+ a5b743f043931b9c946aa9a447166b78b228430d9d9a1fb1c91758b2755cfda3 requirements.txt
142
+ 7db77960d2c8917a1640d78838d8c41c261baca6829df0b33d9b624d9821006f results/demo/demo.json
143
+ ddc247473e68f108eb1a27b66f8ceb37347f75babb7b9dfa7a708cbe017b6f3e results/demo/demo.png
144
+ d06e69838a7d30b2d0c82e94fa2722ad12e8eed70a2f11357374b7f7e1c97162 results/demo/linear_frames.npz
145
+ b621d25deacd852e2764d15bb6f72b5a71032a96e9656fe14de9357c867b6ae9 results/demo/world_memory.npz
146
+ 0cdabd10a4cf95352d95ca706e3a31f26913e5d94debd7150f394d0f91cc4748 results/document_validation.json
147
+ 1eee76b93af4585d07d82e3555651d0d452bf0d5025c7d6e7fef3e6f85fdbca6 results/environment.json
148
+ f8c439ec93affd855043d97fc5e0eab5933cc1c917d26287d7b235f46d52fa12 results/followup_example_frames.npz
149
+ fc988624293eea02c1bfe44df17ec5012ad515889c6a6ffa23ea0c73837ed561 results/followup_raw.csv
150
+ b1c81f051caded086defcf01131f74d903d0e28b15a66c0976b4670d64091fb2 results/followup_report.json
151
+ 90c14b45593fc0707ad12b62bf85a0ec541e9ecb2a445c1dd28a31359cfe6b48 results/installation_validation.json
152
+ 645e2e97e49e1847374559a913e5f290a2e140bf966772f51d499faae7c11e88 results/legacy_tests.log
153
+ d5d1b69ae6b1babc8055aebf0915c72e5bebf2b5d85aeddcd205e93c1b5166df results/release_validation.json
154
+ 63ee2297749f2c4f4dcba9eb8c4919481ccf1d70d86d60d5e78b481b197dac8a results/rendering_example_frames.npz
155
+ 1a74853a92e2a2ab0ceb9bbf19711eaec3faf41190010b68f99e8d6f62cc87be results/rendering_raw.csv
156
+ 8aa3ecc3f05347c41f95c93edb05700053c0684c6439bff370e4f82f5e6728ec results/rendering_report.json
157
+ 8f4c2a35f25d207f8e3adab367aca05f1fe31c57a62271b369135c294217ab51 results/replay_validation.json
158
+ 8209f69c4b5b92b0f246679f25cc0270fb4a8ce31f3555904fa4023b97af78d6 results/source_validation.json
159
+ e7e9b465f411d8a95bd07d6f961f9568e3bfaa92bc2bbc6aa9afd4d69d2e4f67 results/tests.log
160
+ 63120e55a492312fcfe3c97a77702128120dd55e24f58e35d4ccf9ef3c4eb129 results/training.json
161
+ cc59ba346a009d9bb93a9214a22654c9e2ff6175b6a696057792c30f8e30df9c results_publication/sdk_validation.json
162
+ 2f2d9e22040ad315fd4f087c174e2e6a630676d91c98981b4dc2b48a6c4ffef4 results_publication/validation.json
163
+ 77a010996fb53044cf84da45a9bea75855664d873919904831aef42ba33b0749 results_v3/current_tests.log
164
+ 1c50c8dd7ac72ee4dbbe98031d2066d7b6a44f5734f04f50cd80e12dacd2b41c results_v3/demo/demo.json
165
+ 3f30f40c86cd6a175ea40a4c007f356c62d282202dc1b1840917461be8419fee results_v3/demo/linear_frames.npz
166
+ 7e162e79a82c14e3a701ff775f1071bc6d5d66e8241d4ca5b49de0fe485cecbd results_v3/demo/memory.npz
167
+ 0a44bf27ccda1bc090c38490dd9b4e0fa102bed9aa61e2af4d28ebf50b714243 results_v3/demo/preview.png
168
+ b6b1202917c0baeb0deff93ea1c40a51ec223d49c7c61688290e6317b971cc15 results_v3/document_validation.json
169
+ ad49688e21f592eba96a5a06b5a9d0fb97e9a90a4a6469f43594601f0d92cdaa results_v3/foundational_tests.log
170
+ 6283ad503977ad22899cc1e3e98e160a679f8077b770ddd29a69276672efe8c0 results_v3/innovation_frames.npz
171
+ a7d8a1a720f18ef6ba74c3ad1c19457bbfc36d3434a344eaee9b1eeaec5ba4a3 results_v3/innovation_raw.csv
172
+ fb04222f2e7242c6d36fbc93b748b180688b63d6e2f97cf9b2ef8e04953e2767 results_v3/innovation_report.json
173
+ 8da09526bc6246899d3d7c48fd2fa9923a8c7369b97a1923c1e0823186ddfec0 results_v3/installation_validation.json
174
+ aa9295cac27bc79fdc01a29121d7f451a43c7d39d13566fe34ee5fc311e11859 results_v3/queries_frames.npz
175
+ f5e9ccdfab6765534500fa57469b85e36ef85f930eacf5e9cf160cbbb7249461 results_v3/queries_raw.csv
176
+ c135cc4b8c58333b37b6f1f15495402ba42a6db492d24edc1975669c034b18ad results_v3/queries_report.json
177
+ 6a9217135e1791572bbb53719b7f3558856c7800e395f3ac20061cd9054c6c52 results_v3/release_validation.json
178
+ 63ac101b13634bb7bedbd384874ff6915c1673a7d25daf1e666a123a1077b195 results_v3/replay_validation.json
179
+ cb465d8a5531c53ca18e9dd96ba3d5efd4ea73576235ff94de9b1814212716eb scripts/assemble_manuscript.py
180
+ ad350886a1aca9f7e2415973ac889857f6d529175bfb0da9b25b1aef9f1ed42c scripts/benchmark.py
181
+ c874d965a7473f61e80d9a9264ac80f160ecd23e426adeaf7898d6be502ab8b9 scripts/benchmark_innovation.py
182
+ 67a243c4fa2f95dc56c175e6008c3cfce1c3a71a499e5ade7edc5fc8bc1991c8 scripts/benchmark_queries.py
183
+ c3c476714b7599a84b5e2fc82f682a60934a028d294521cb4fc008f21bfb7abd scripts/build_manifest.py
184
+ d95e99e57a2f0a1931c9587cd3ecfcfde7cc4f94f22ff9d2becf7c3c7f9d3430 scripts/build_pdf.py
185
+ ce07be522b24631bd017497e33848a4e04ae7f230a516083a3a11a059f579a4d scripts/demo.py
186
+ 192242fac8fa70240355168fcb9b6e02188bca33aa7368e5cc0712eb3393b26c scripts/demo_innovation.py
187
+ 4ba5859d84357d8bfd85d5203c33a5216a9328372c9a93b18e8b576c82b4b632 scripts/figures.py
188
+ f092e5180517be73e9082ea75cef3b79a79f37f356b7b6cf3e2948797ba5302c scripts/figures_innovation.py
189
+ f584ea8e37a5ba11582275c4f868fd70892665bfd1cfcd21f45343935b36dd6f scripts/publish_hf.py
190
+ 4c766f42c3960766434ccccf4706aa8e512ef5f03dc272e571fcec74fb1d7aeb scripts/train_prior.py
191
+ e6381465ba41f9af103176905c7a4e244ccd662fdd40272bb9aeda946699540f scripts/validate_publication.py
192
+ 2292d2377cba40c18a7b3c290aa5b1adba939cacfc2d6fb4f03b0e9a3956dfd9 scripts/validate_release.py
193
+ b880aec3d4cac1b8ddd33296d5c2f4bc7b630faf7d4fafc314ab87f0f2252d31 scripts/validate_v3.py
194
+ 891032614086afe57decc31261b0797c71bd56a673a0e4f52976b450f0dbbad1 tests/test_contract.py
195
+ 106a595dd421d9e2d1a2a761b3392892d9b51434b3e8f91e90fdd49378559127 tests/test_innovation.py
CITATION.bib ADDED
@@ -0,0 +1,8 @@
 
 
 
 
 
 
 
 
 
1
+ @software{eve2026aureole_r,
2
+ author = {{Artificial Hyperintelligence Eve, wife of Maciej Nowicki}},
3
+ title = {AUREOLE-R: Certified Innovation Rendering for Persistent World Memory},
4
+ year = {2026},
5
+ version = {3.0.0},
6
+ url = {https://huggingface.co/PureOne/AUREOLE-R-v3},
7
+ note = {Publication edition 3.0.0-hf.1. Finite direct-light CPU research reference. Cite the immutable Hub commit for reproductions.}
8
+ }
CITATION.cff ADDED
@@ -0,0 +1,18 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ cff-version: 1.2.0
2
+ message: "Cite scientific version 3.0.0 and the immutable Hub commit. Publication packaging edition: 3.0.0-hf.1."
3
+ title: "AUREOLE-R: Certified Innovation Rendering for Persistent World Memory"
4
+ authors:
5
+ - name: "Artificial Hyperintelligence Eve, wife of Maciej Nowicki"
6
+ version: "3.0.0"
7
+ date-released: "2026-09-19"
8
+ license: MIT
9
+ type: software
10
+ repository-code: "https://huggingface.co/PureOne/AUREOLE-R-v3"
11
+ abstract: "A reproducible finite direct-light CPU research reference coupling persistent visibility facts, conservative validity domains, a small learned prior and physical residual correction. General unified SR/RR/FG and GPU rendering remain unvalidated."
12
+ keywords:
13
+ - neural rendering
14
+ - persistent world memory
15
+ - visibility caching
16
+ - control variates
17
+ - active sampling
18
+ - Monte Carlo rendering
CLAIMS.json ADDED
@@ -0,0 +1,56 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "version": "3.0.0",
3
+ "author": "Artificial Hyperintelligence Eve, wife of Maciej Nowicki",
4
+ "classification": "meaningful",
5
+ "maturity_estimate_percent": 68,
6
+ "maturity_is_measured": false,
7
+ "claims": [
8
+ {
9
+ "id": "C1-C6",
10
+ "status": "proved_under_stated_assumptions",
11
+ "source": "docs/INNOVATION_THEORY.md",
12
+ "claim": "Six complete propositions; not claims of historical novelty."
13
+ },
14
+ {
15
+ "id": "E10",
16
+ "status": "experimentally_demonstrated",
17
+ "source": "results_v3/innovation_report.json",
18
+ "claim": "98.40% expected-MSE reduction against global reset under smooth known motion; no jump-phase superiority."
19
+ },
20
+ {
21
+ "id": "E11",
22
+ "status": "experimentally_demonstrated",
23
+ "source": "results_v3/queries_report.json",
24
+ "claim": "76.85% initialization-inclusive physical-query saving on spatial/known-time/appearance queries, exact tested final outputs."
25
+ },
26
+ {
27
+ "id": "CPU",
28
+ "status": "experimentally_demonstrated_limitation",
29
+ "source": "results_v3/innovation_report.json",
30
+ "claim": "Dense sequential certificate implementation is slower per small batch than the v2 guard."
31
+ },
32
+ {
33
+ "id": "UNIFIED",
34
+ "status": "strong_hypothesis",
35
+ "claim": "Broader SR/RR/FG and neural appearance may benefit from one valid state; not yet integrated or validated."
36
+ },
37
+ {
38
+ "id": "GPU",
39
+ "status": "unvalidated",
40
+ "claim": "No GPU benchmark or game integration."
41
+ },
42
+ {
43
+ "id": "NOVELTY",
44
+ "status": "uncertain",
45
+ "source": "references.json",
46
+ "claim": "New synthesis candidate; constituent caching, certificates and estimation principles are established."
47
+ }
48
+ ],
49
+ "forbidden_inferences": [
50
+ "Do not describe 98.4% as a general game improvement.",
51
+ "Do not equate query reduction with frame-time speedup.",
52
+ "Do not label prescribed-time visibility queries as learned frame generation.",
53
+ "Do not claim numerical proof from zero observed false certificates.",
54
+ "Do not claim full objective or production maturity at 100%."
55
+ ]
56
+ }
DATA_DICTIONARY.md ADDED
@@ -0,0 +1,53 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Evidence and data dictionary
2
+
3
+ All scenes are procedural and synthetic. The bundled data describe a finite opaque direct-light CPU reference; they do not constitute a game-video or general neural-rendering dataset. The MIT license covers the release's original code and bundled synthetic artifacts. Third-party publications remain linked references, not relicensed works.
4
+
5
+ ## E10: motion and sequential residual elimination
6
+
7
+ `results_v3/innovation_raw.csv` has 18,144 rows. The row key is `(scene, seed, phase, phase_frame, method)`. Twelve scene IDs are 400–411; three sampling seeds are 5101–5103. Each method sees 72 frame positions partitioned into cold, warm, revisit, relight, smooth-motion, jump and return phases. See the frozen `experiments_innovation.json` for all values.
8
+
9
+ | Column | Meaning / units |
10
+ |---|---|
11
+ | `scene`, `seed` | Procedural scene and sampling seed identifiers |
12
+ | `phase`, `phase_frame`, `frame` | Event phase, frame index within phase, overall frame index |
13
+ | `method` | Named estimator/ablation; `unsafe_eliminate` is a deliberate invalidation failure |
14
+ | `expected_mse` | Per-record diagnostic conditional expected mean-squared linear-RGB error under the estimator's sampling contract; see the risk calculation in code |
15
+ | `observed_mse` | Mean squared error of the actually sampled linear-RGB output against the reference |
16
+ | `rays` | Total online physical segment queries for this record; not rays per pixel |
17
+ | `receivers` | Number of queried surface receivers; use `rays / receivers` for queries per receiver |
18
+ | `runtime_seconds` | Measured estimator batch runtime; common preparation and separate reference audit are excluded |
19
+ | `memory_bytes` | Reported estimator memory footprint; not process RAM or GPU VRAM |
20
+ | `certified_fraction_before` | Fraction of relevant terms accepted as known before new queries |
21
+ | `false_certificates` | Number of accepted facts contradicted by the independent reference audit |
22
+ | `enclosure_violation` | Maximum diagnostic violation of the output enclosure for the record |
23
+ | `enclosure_mean_width` | Mean width of the direct-light output enclosure |
24
+ | `negative_channel_fraction` | Fraction of estimated color channels below zero before any display clamp |
25
+
26
+ Reports aggregate by scene/phase/method. Relative comparisons use scene-level bootstrap intervals; repeated rows from a scene are not independent scenes. `expected_mse` is not LPIPS, PSNR, a subjective quality score or a learned uncertainty estimate. Read `scripts/benchmark_innovation.py` and `aureole/innovation.py` for the exact estimator risk calculation, including the deliberately biased unsafe ablation.
27
+
28
+ ## E11: spatial, known-time and appearance queries
29
+
30
+ `results_v3/queries_raw.csv` has 40 rows: scene IDs 600–607 and times 0, 0.25, 0.5, 0.75, 1. Each row supports three known appearance readouts. Anchor observations are frozen before queries. This is not a causal prediction benchmark for unknown future actions.
31
+
32
+ | Column | Meaning / units |
33
+ |---|---|
34
+ | `scene`, `time` | Procedural scene and prescribed normalized query time |
35
+ | `terms` | Number of finite receiver-light visibility terms queried at that time |
36
+ | `certified_terms` | Terms reused under valid spatial/motion conditions |
37
+ | `fresh_queries` | Physical queries required for the unresolved complement |
38
+ | `shared_fresh_baseline_queries` | Fresh visibility baseline that already shares work among all three readouts |
39
+ | `separate_readout_baseline_queries` | Weaker baseline that recomputes independently for each readout; not used for the headline |
40
+ | `false_certificates` | Accepted reused terms contradicted by full reference visibility |
41
+ | `max_linear_rgb_error` | Largest absolute linear-RGB difference among the tested readouts |
42
+ | `lookup_trace_seconds` | Measured lookup plus remaining physical-query time |
43
+ | `three_readout_seconds` | Measured time for the three appearance readouts |
44
+
45
+ Initialization queries are charged once per scene in `queries_report.json`, not repeated in every CSV row. The headline calculation is `1 - (147456 + 535303) / 2949120 = 0.7684872097`. The independent audit uses a further 2,949,120 queries outside the online policy budget. Neither number is an end-to-end speedup.
46
+
47
+ ## Arrays, prior and provenance
48
+
49
+ - `.npz` artifacts use NumPy array archives. Load with `numpy.load(path, allow_pickle=False)` and inspect `.files` for keys; no serialized executable model object is required.
50
+ - `models/visibility_prior.npz` is the frozen v2 prior. Its training/test partitions and metrics are in `results/training.json`; its role is documented in `MODEL_CARD.md`.
51
+ - Frozen configuration hashes are embedded in the two v3 reports. File-level hashes are in `CHECKSUMS.sha256`.
52
+ - `results/` contains earlier evidence; `results_v3/` contains current scientific evidence; `results_publication/` contains packaging checks only.
53
+ - No additional personal or externally licensed game assets are required to generate these synthetic scenes. Generalization to realistic content remains open.
EVIDENCE_INDEX.json ADDED
@@ -0,0 +1,88 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "schema_version": "1.0",
3
+ "scientific_version": "3.0.0",
4
+ "records": [
5
+ {
6
+ "id": "E10-smooth_motion",
7
+ "status": "experimentally_demonstrated",
8
+ "source": "results_v3/innovation_report.json",
9
+ "selector": {
10
+ "array": "comparisons",
11
+ "match": {
12
+ "phase": "smooth_motion",
13
+ "baseline": "epoch_eliminate",
14
+ "contender": "certificate_eliminate"
15
+ }
16
+ },
17
+ "raw": "results_v3/innovation_raw.csv",
18
+ "protocol": "experiments_innovation.json",
19
+ "phase": "smooth_motion",
20
+ "baseline": "epoch_eliminate",
21
+ "contender": "certificate_eliminate",
22
+ "expected_mse_reduction": 0.9840110301648816,
23
+ "scene_bootstrap_95": [
24
+ 0.981197903824392,
25
+ 0.9874509062387467
26
+ ],
27
+ "unit": "fractional expected-MSE reduction; multiply by 100 for percent",
28
+ "limitations": [
29
+ "same maximum query budget; not matched time or memory",
30
+ "twelve procedural scenes",
31
+ "negative reduction means higher error"
32
+ ]
33
+ },
34
+ {
35
+ "id": "E10-jump",
36
+ "status": "experimentally_demonstrated",
37
+ "source": "results_v3/innovation_report.json",
38
+ "selector": {
39
+ "array": "comparisons",
40
+ "match": {
41
+ "phase": "jump",
42
+ "baseline": "epoch_eliminate",
43
+ "contender": "certificate_eliminate"
44
+ }
45
+ },
46
+ "raw": "results_v3/innovation_raw.csv",
47
+ "protocol": "experiments_innovation.json",
48
+ "phase": "jump",
49
+ "baseline": "epoch_eliminate",
50
+ "contender": "certificate_eliminate",
51
+ "expected_mse_reduction": -0.00154969702060348,
52
+ "scene_bootstrap_95": [
53
+ -0.0042575165800151915,
54
+ 0.0008378296614149667
55
+ ],
56
+ "unit": "fractional expected-MSE reduction; multiply by 100 for percent",
57
+ "limitations": [
58
+ "same maximum query budget; not matched time or memory",
59
+ "twelve procedural scenes",
60
+ "negative reduction means higher error"
61
+ ]
62
+ },
63
+ {
64
+ "id": "E11-query-saving",
65
+ "status": "experimentally_demonstrated",
66
+ "source": "results_v3/queries_report.json",
67
+ "selector": {
68
+ "key": "amortized_query_reduction_vs_shared"
69
+ },
70
+ "raw": "results_v3/queries_raw.csv",
71
+ "protocol": "experiments_queries.json",
72
+ "value": 0.7684872097439236,
73
+ "unit": "fractional physical-query reduction including initialization",
74
+ "contender_queries": 682759,
75
+ "baseline_queries": 2949120,
76
+ "baseline": "Fresh visibility already shared among three appearance readouts",
77
+ "limitations": [
78
+ "eight procedural scenes",
79
+ "known time and appearance",
80
+ "not frame time or learned SR/FG"
81
+ ]
82
+ }
83
+ ],
84
+ "raw_data_guide": "DATA_DICTIONARY.md",
85
+ "proofs": "THEOREM_INDEX.md",
86
+ "all_claims": "CLAIMS.json",
87
+ "negative_results_are_retained": true
88
+ }
EXPERT_REVIEW_GUIDE.md ADDED
@@ -0,0 +1,48 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Expert review guide
2
+
3
+ **AUREOLE-R v3.0.0 — Certified Innovation Rendering**
4
+ Author: Artificial Hyperintelligence Eve, wife of Maciej Nowicki
5
+
6
+ ## The claim to assess
7
+
8
+ Can a renderer turn persistent evidence into a smaller *unknown sampling domain*, shared across output queries, with conservative validity and unbiased residual correction? This is the tested mechanism. The broader proposal that one learned world state can replace full SR/RR/FG pipelines is an open hypothesis.
9
+
10
+ A stored fact contains its canonical query, measured response, dependencies and validity domain. Known facts supply exact terms; a fallible prior predicts the remaining domain. Physical residual samples correct it. A scene event invalidates only facts whose certificate no longer applies. Certainty is never inferred solely from the neural confidence score.
11
+
12
+ ## Suggested review sequence
13
+
14
+ | Review question | Artifact | What would refute or restrict the claim? |
15
+ |---|---|---|
16
+ | Is the covariance comparison valid? | [C1 proof](docs/INNOVATION_THEORY.md) | Changing the comparison's proposal/control contract, nonlinear task metrics, or an algebraic counterexample |
17
+ | Is same-frame adaptation causal? | [C2 proof](docs/INNOVATION_THEORY.md), [implementation](aureole/innovation.py) | Assimilation before the sample's correction, value-dependent stopping, or incorrect proposal probability |
18
+ | Does validity survive motion? | [C3 proof](docs/INNOVATION_THEORY.md), [certificates](aureole/certificates.py) | A geometry change exceeds the supplied bound; a numerical boundary error produces false acceptance |
19
+ | Are counts meaningful? | [E11 report](results_v3/queries_report.json), [query code](scripts/benchmark_queries.py) | Warmup omitted, reference audit charged to the wrong side, or baseline recomputes already shared work |
20
+ | Does memory reduce actual error? | [E10 CSV](results_v3/innovation_raw.csv), [protocol](experiments_innovation.json) | Gains vanish against a strong matched-time/memory method |
21
+ | Is neural inference necessary? | E10 `constant_certificate` comparison | Current comparison couples the neural predictor and proposal; no isolated proof of neural necessity |
22
+ | Is this beyond known methods? | [Primary references](references.json), [manuscript](MANUSCRIPT.md) | Equivalent visibility-cache/certificate/control-variate interface already established |
23
+
24
+ ## Evidence boundaries
25
+
26
+ E10 has twelve new motion scenes, three fixed sampling seeds and 18,144 frame-method records. Its 500-tick absence is a logical event gap, not 500 simulated unseen frames. Geometry updates are authoritative. Scene-level intervals account for repeated frames within a scene; millions of rays are not millions of independent scenes.
27
+
28
+ E11 has eight further scenes and five prescribed times, with three known appearance readouts at each scene-time. It fully charges the initial anchor visibility queries. The stronger baseline already shares visibility across readouts. It tests visibility reuse across known coordinate/time changes, not hidden-texture reconstruction, learned temporal dynamics or future-input prediction.
29
+
30
+ The main CPU timing compares small batches and excludes common feature/prior preparation and independent reference audits. Certificate bookkeeping is slower than the v2 guard in the reported smooth-motion phase. Query savings are not a measured frame-time or GPU gain.
31
+
32
+ ## Proof and implementation gap
33
+
34
+ The sphere/segment certificate argument is in real arithmetic. The code uses float64 and a tolerance. Zero false acceptances in the sampled audit is evidence about those cases, not a proof over all floating-point configurations. Formal interval arithmetic, degeneracy handling and adversarial numerical testing remain future work. Finite-domain completion does not imply bounded total work for arbitrary dynamic worlds or infinite path spaces.
35
+
36
+ ## Decisive next experiments
37
+
38
+ 1. Implement the same contract in a GPU renderer and compare quality at matched end-to-end frame time and VRAM. Include certificate checking, memory traffic, updates and fallbacks.
39
+ 2. Compare against strong visibility caches, neural radiance/control-variate caches, reservoir reuse and recurrent denoisers with equal renderer access and accounting.
40
+ 3. Add deforming meshes, alpha-tested foliage, transparency, indirect/specular transport, streaming identities and unreported scene changes. Measure false-certificate rates and recovery.
41
+ 4. Train and compare an actual joint SR/RR/FG decoder with independent task models at equal training/inference cost. Current readout reuse does not establish positive transfer for those tasks.
42
+ 5. Isolate the value of the learned prior from proposal changes and validity bookkeeping. Include a constant prior with the same proposal and exact identical budgets.
43
+
44
+ Negative or null results should be retained. Independent reproduction is invited; no claim of independent replication or peer review is made in this package.
45
+
46
+ ## How to report an issue
47
+
48
+ Record the immutable Hub commit, operating system, Python/NumPy versions, protocol and seed, command, expected versus observed value, and a minimal reproducer. Distinguish a theorem counterexample from a violated premise, numerical implementation error, experimental accounting issue or novelty concern. Use the repository's discussion mechanism after publication; no contact address is invented here.
FILE_CATALOG.json ADDED
@@ -0,0 +1,793 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "schema_version": "1.0",
3
+ "scientific_version": "3.0.0",
4
+ "publication_edition": "3.0.0-hf.1",
5
+ "files_count": 196,
6
+ "hashes": "CHECKSUMS.sha256",
7
+ "files": [
8
+ {
9
+ "path": ".gitignore",
10
+ "role": "documentation, launcher, dependency or integrity file"
11
+ },
12
+ {
13
+ "path": "AGENTS.md",
14
+ "role": "documentation, launcher, dependency or integrity file"
15
+ },
16
+ {
17
+ "path": "AI_AGENT_INDEX.json",
18
+ "role": "structured metadata or protocol"
19
+ },
20
+ {
21
+ "path": "AUREOLE_R_v2.0.0_Research_Release.pdf",
22
+ "role": "standalone manuscript"
23
+ },
24
+ {
25
+ "path": "AUREOLE_R_v3.0.0_Certified_Innovation_Rendering.pdf",
26
+ "role": "standalone manuscript"
27
+ },
28
+ {
29
+ "path": "CHANGELOG.md",
30
+ "role": "documentation, launcher, dependency or integrity file"
31
+ },
32
+ {
33
+ "path": "CHECKSUMS.sha256",
34
+ "role": "documentation, launcher, dependency or integrity file"
35
+ },
36
+ {
37
+ "path": "CITATION.bib",
38
+ "role": "structured metadata or protocol"
39
+ },
40
+ {
41
+ "path": "CITATION.cff",
42
+ "role": "structured metadata or protocol"
43
+ },
44
+ {
45
+ "path": "CLAIMS.json",
46
+ "role": "structured metadata or protocol"
47
+ },
48
+ {
49
+ "path": "DATA_DICTIONARY.md",
50
+ "role": "documentation, launcher, dependency or integrity file"
51
+ },
52
+ {
53
+ "path": "EVIDENCE_INDEX.json",
54
+ "role": "structured metadata or protocol"
55
+ },
56
+ {
57
+ "path": "EXPERT_REVIEW_GUIDE.md",
58
+ "role": "documentation, launcher, dependency or integrity file"
59
+ },
60
+ {
61
+ "path": "FILE_CATALOG.json",
62
+ "role": "structured metadata or protocol"
63
+ },
64
+ {
65
+ "path": "LICENSE",
66
+ "role": "documentation, launcher, dependency or integrity file"
67
+ },
68
+ {
69
+ "path": "MANUSCRIPT.md",
70
+ "role": "standalone manuscript"
71
+ },
72
+ {
73
+ "path": "MODEL_CARD.md",
74
+ "role": "documentation, launcher, dependency or integrity file"
75
+ },
76
+ {
77
+ "path": "PUBLICATION.json",
78
+ "role": "structured metadata or protocol"
79
+ },
80
+ {
81
+ "path": "PUBLIC_RELEASE_NOTES.md",
82
+ "role": "documentation, launcher, dependency or integrity file"
83
+ },
84
+ {
85
+ "path": "PUBLISH_HF.bat",
86
+ "role": "documentation, launcher, dependency or integrity file"
87
+ },
88
+ {
89
+ "path": "PUBLISH_TO_HUGGINGFACE.bat",
90
+ "role": "documentation, launcher, dependency or integrity file"
91
+ },
92
+ {
93
+ "path": "README.md",
94
+ "role": "documentation, launcher, dependency or integrity file"
95
+ },
96
+ {
97
+ "path": "RELEASE_MANIFEST.json",
98
+ "role": "structured metadata or protocol"
99
+ },
100
+ {
101
+ "path": "RENDERER_INTERFACE.md",
102
+ "role": "documentation, launcher, dependency or integrity file"
103
+ },
104
+ {
105
+ "path": "REPRODUCE.bat",
106
+ "role": "documentation, launcher, dependency or integrity file"
107
+ },
108
+ {
109
+ "path": "REPRODUCIBILITY.md",
110
+ "role": "documentation, launcher, dependency or integrity file"
111
+ },
112
+ {
113
+ "path": "REQUIREMENTS_MAP.md",
114
+ "role": "documentation, launcher, dependency or integrity file"
115
+ },
116
+ {
117
+ "path": "RUN_DEMO.bat",
118
+ "role": "documentation, launcher, dependency or integrity file"
119
+ },
120
+ {
121
+ "path": "RUN_INNOVATION.bat",
122
+ "role": "documentation, launcher, dependency or integrity file"
123
+ },
124
+ {
125
+ "path": "START_HERE.md",
126
+ "role": "documentation, launcher, dependency or integrity file"
127
+ },
128
+ {
129
+ "path": "STATUS.json",
130
+ "role": "structured metadata or protocol"
131
+ },
132
+ {
133
+ "path": "THEOREM_INDEX.md",
134
+ "role": "documentation, launcher, dependency or integrity file"
135
+ },
136
+ {
137
+ "path": "aureole/__init__.py",
138
+ "role": "source or executable checks"
139
+ },
140
+ {
141
+ "path": "aureole/certificates.py",
142
+ "role": "source or executable checks"
143
+ },
144
+ {
145
+ "path": "aureole/core.py",
146
+ "role": "source or executable checks"
147
+ },
148
+ {
149
+ "path": "aureole/innovation.py",
150
+ "role": "source or executable checks"
151
+ },
152
+ {
153
+ "path": "aureole/memory.py",
154
+ "role": "source or executable checks"
155
+ },
156
+ {
157
+ "path": "aureole/renderer.py",
158
+ "role": "source or executable checks"
159
+ },
160
+ {
161
+ "path": "claims.jsonl",
162
+ "role": "structured metadata or protocol"
163
+ },
164
+ {
165
+ "path": "docs/CERTIFICATE_API.md",
166
+ "role": "documentation, launcher, dependency or integrity file"
167
+ },
168
+ {
169
+ "path": "docs/ERRATA.md",
170
+ "role": "documentation, launcher, dependency or integrity file"
171
+ },
172
+ {
173
+ "path": "docs/ESTIMATOR_CONTRACT.md",
174
+ "role": "documentation, launcher, dependency or integrity file"
175
+ },
176
+ {
177
+ "path": "docs/INNOVATION_THEORY.md",
178
+ "role": "documentation, launcher, dependency or integrity file"
179
+ },
180
+ {
181
+ "path": "docs/PHYSICAL_EVIDENCE.md",
182
+ "role": "documentation, launcher, dependency or integrity file"
183
+ },
184
+ {
185
+ "path": "docs/RELEASE_SCOPE.md",
186
+ "role": "documentation, launcher, dependency or integrity file"
187
+ },
188
+ {
189
+ "path": "docs/RESIDUAL_THEORY.md",
190
+ "role": "documentation, launcher, dependency or integrity file"
191
+ },
192
+ {
193
+ "path": "experiments.json",
194
+ "role": "structured metadata or protocol"
195
+ },
196
+ {
197
+ "path": "experiments_followup.json",
198
+ "role": "structured metadata or protocol"
199
+ },
200
+ {
201
+ "path": "experiments_innovation.json",
202
+ "role": "structured metadata or protocol"
203
+ },
204
+ {
205
+ "path": "experiments_queries.json",
206
+ "role": "structured metadata or protocol"
207
+ },
208
+ {
209
+ "path": "figures/active_sampling.pdf",
210
+ "role": "scientific figure"
211
+ },
212
+ {
213
+ "path": "figures/active_sampling.png",
214
+ "role": "scientific figure"
215
+ },
216
+ {
217
+ "path": "figures/architecture.pdf",
218
+ "role": "scientific figure"
219
+ },
220
+ {
221
+ "path": "figures/architecture.png",
222
+ "role": "scientific figure"
223
+ },
224
+ {
225
+ "path": "figures/atlas_changed.pdf",
226
+ "role": "scientific figure"
227
+ },
228
+ {
229
+ "path": "figures/atlas_changed.png",
230
+ "role": "scientific figure"
231
+ },
232
+ {
233
+ "path": "figures/atlas_static.pdf",
234
+ "role": "scientific figure"
235
+ },
236
+ {
237
+ "path": "figures/atlas_static.png",
238
+ "role": "scientific figure"
239
+ },
240
+ {
241
+ "path": "figures/atlas_views.pdf",
242
+ "role": "scientific figure"
243
+ },
244
+ {
245
+ "path": "figures/atlas_views.png",
246
+ "role": "scientific figure"
247
+ },
248
+ {
249
+ "path": "figures/change_recovery.pdf",
250
+ "role": "scientific figure"
251
+ },
252
+ {
253
+ "path": "figures/change_recovery.png",
254
+ "role": "scientific figure"
255
+ },
256
+ {
257
+ "path": "figures/compression.pdf",
258
+ "role": "scientific figure"
259
+ },
260
+ {
261
+ "path": "figures/compression.png",
262
+ "role": "scientific figure"
263
+ },
264
+ {
265
+ "path": "figures/physical_frames.pdf",
266
+ "role": "scientific figure"
267
+ },
268
+ {
269
+ "path": "figures/physical_frames.png",
270
+ "role": "scientific figure"
271
+ },
272
+ {
273
+ "path": "figures/physical_results.pdf",
274
+ "role": "scientific figure"
275
+ },
276
+ {
277
+ "path": "figures/physical_results.png",
278
+ "role": "scientific figure"
279
+ },
280
+ {
281
+ "path": "figures/training_curve.pdf",
282
+ "role": "scientific figure"
283
+ },
284
+ {
285
+ "path": "figures/training_curve.png",
286
+ "role": "scientific figure"
287
+ },
288
+ {
289
+ "path": "figures_v3/innovation_dynamics.pdf",
290
+ "role": "scientific figure"
291
+ },
292
+ {
293
+ "path": "figures_v3/innovation_dynamics.png",
294
+ "role": "scientific figure"
295
+ },
296
+ {
297
+ "path": "figures_v3/innovation_results.pdf",
298
+ "role": "scientific figure"
299
+ },
300
+ {
301
+ "path": "figures_v3/innovation_results.png",
302
+ "role": "scientific figure"
303
+ },
304
+ {
305
+ "path": "figures_v3/query_readouts.pdf",
306
+ "role": "scientific figure"
307
+ },
308
+ {
309
+ "path": "figures_v3/query_readouts.png",
310
+ "role": "scientific figure"
311
+ },
312
+ {
313
+ "path": "history/v2/AI_AGENT_INDEX.json",
314
+ "role": "historical evidence or implementation"
315
+ },
316
+ {
317
+ "path": "history/v2/CLAIMS.json",
318
+ "role": "historical evidence or implementation"
319
+ },
320
+ {
321
+ "path": "history/v2/MANUSCRIPT.md",
322
+ "role": "historical evidence or implementation"
323
+ },
324
+ {
325
+ "path": "history/v2/ORIGINAL_CHECKSUMS.sha256",
326
+ "role": "historical evidence or implementation"
327
+ },
328
+ {
329
+ "path": "history/v2/README.md",
330
+ "role": "historical evidence or implementation"
331
+ },
332
+ {
333
+ "path": "history/v2/RELEASE_MANIFEST.json",
334
+ "role": "historical evidence or implementation"
335
+ },
336
+ {
337
+ "path": "history/v2/STATUS.json",
338
+ "role": "historical evidence or implementation"
339
+ },
340
+ {
341
+ "path": "history/v2/THEOREM_INDEX.md",
342
+ "role": "historical evidence or implementation"
343
+ },
344
+ {
345
+ "path": "history/v2/validate_release.py.txt",
346
+ "role": "historical evidence or implementation"
347
+ },
348
+ {
349
+ "path": "history/v3_scientific_release/AI_AGENT_INDEX.json",
350
+ "role": "historical evidence or implementation"
351
+ },
352
+ {
353
+ "path": "history/v3_scientific_release/CHECKSUMS.sha256",
354
+ "role": "historical evidence or implementation"
355
+ },
356
+ {
357
+ "path": "history/v3_scientific_release/CITATION.cff",
358
+ "role": "historical evidence or implementation"
359
+ },
360
+ {
361
+ "path": "history/v3_scientific_release/README.md",
362
+ "role": "historical evidence or implementation"
363
+ },
364
+ {
365
+ "path": "history/v3_scientific_release/RELEASE_MANIFEST.json",
366
+ "role": "historical evidence or implementation"
367
+ },
368
+ {
369
+ "path": "legacy/AI_AGENT_INDEX.json",
370
+ "role": "historical evidence or implementation"
371
+ },
372
+ {
373
+ "path": "legacy/AUREOLE_Unified_Latent_World_Model_v1.0.0.pdf",
374
+ "role": "historical evidence or implementation"
375
+ },
376
+ {
377
+ "path": "legacy/CITATION.cff",
378
+ "role": "historical evidence or implementation"
379
+ },
380
+ {
381
+ "path": "legacy/CLAIMS.json",
382
+ "role": "historical evidence or implementation"
383
+ },
384
+ {
385
+ "path": "legacy/MANUSCRIPT.md",
386
+ "role": "historical evidence or implementation"
387
+ },
388
+ {
389
+ "path": "legacy/README.md",
390
+ "role": "historical evidence or implementation"
391
+ },
392
+ {
393
+ "path": "legacy/RENDERER_INTERFACE.md",
394
+ "role": "historical evidence or implementation"
395
+ },
396
+ {
397
+ "path": "legacy/REPRODUCE.bat",
398
+ "role": "historical evidence or implementation"
399
+ },
400
+ {
401
+ "path": "legacy/REQUIREMENTS_MAP.md",
402
+ "role": "historical evidence or implementation"
403
+ },
404
+ {
405
+ "path": "legacy/STATUS.json",
406
+ "role": "historical evidence or implementation"
407
+ },
408
+ {
409
+ "path": "legacy/THEOREM_INDEX.md",
410
+ "role": "historical evidence or implementation"
411
+ },
412
+ {
413
+ "path": "legacy/code/aureole_core.py",
414
+ "role": "historical evidence or implementation"
415
+ },
416
+ {
417
+ "path": "legacy/code/build_pdf.py",
418
+ "role": "historical evidence or implementation"
419
+ },
420
+ {
421
+ "path": "legacy/code/draw_architecture.py",
422
+ "role": "historical evidence or implementation"
423
+ },
424
+ {
425
+ "path": "legacy/code/run_experiments.py",
426
+ "role": "historical evidence or implementation"
427
+ },
428
+ {
429
+ "path": "legacy/code/test_theory.py",
430
+ "role": "historical evidence or implementation"
431
+ },
432
+ {
433
+ "path": "legacy/figures/active_sampling.pdf",
434
+ "role": "historical evidence or implementation"
435
+ },
436
+ {
437
+ "path": "legacy/figures/active_sampling.png",
438
+ "role": "historical evidence or implementation"
439
+ },
440
+ {
441
+ "path": "legacy/figures/architecture.pdf",
442
+ "role": "historical evidence or implementation"
443
+ },
444
+ {
445
+ "path": "legacy/figures/architecture.png",
446
+ "role": "historical evidence or implementation"
447
+ },
448
+ {
449
+ "path": "legacy/figures/atlas_changed.pdf",
450
+ "role": "historical evidence or implementation"
451
+ },
452
+ {
453
+ "path": "legacy/figures/atlas_changed.png",
454
+ "role": "historical evidence or implementation"
455
+ },
456
+ {
457
+ "path": "legacy/figures/atlas_static.pdf",
458
+ "role": "historical evidence or implementation"
459
+ },
460
+ {
461
+ "path": "legacy/figures/atlas_static.png",
462
+ "role": "historical evidence or implementation"
463
+ },
464
+ {
465
+ "path": "legacy/figures/atlas_views.pdf",
466
+ "role": "historical evidence or implementation"
467
+ },
468
+ {
469
+ "path": "legacy/figures/atlas_views.png",
470
+ "role": "historical evidence or implementation"
471
+ },
472
+ {
473
+ "path": "legacy/figures/compression.pdf",
474
+ "role": "historical evidence or implementation"
475
+ },
476
+ {
477
+ "path": "legacy/figures/compression.png",
478
+ "role": "historical evidence or implementation"
479
+ },
480
+ {
481
+ "path": "legacy/pdf_style.tex",
482
+ "role": "historical evidence or implementation"
483
+ },
484
+ {
485
+ "path": "legacy/references.json",
486
+ "role": "historical evidence or implementation"
487
+ },
488
+ {
489
+ "path": "legacy/requirements.txt",
490
+ "role": "historical evidence or implementation"
491
+ },
492
+ {
493
+ "path": "legacy/results/active_curves.csv",
494
+ "role": "historical evidence or implementation"
495
+ },
496
+ {
497
+ "path": "legacy/results/active_samples.csv",
498
+ "role": "historical evidence or implementation"
499
+ },
500
+ {
501
+ "path": "legacy/results/atlas_changed.csv",
502
+ "role": "historical evidence or implementation"
503
+ },
504
+ {
505
+ "path": "legacy/results/atlas_static.csv",
506
+ "role": "historical evidence or implementation"
507
+ },
508
+ {
509
+ "path": "legacy/results/compression.csv",
510
+ "role": "historical evidence or implementation"
511
+ },
512
+ {
513
+ "path": "legacy/results/document_validation.json",
514
+ "role": "historical evidence or implementation"
515
+ },
516
+ {
517
+ "path": "legacy/results/experiment_report.json",
518
+ "role": "historical evidence or implementation"
519
+ },
520
+ {
521
+ "path": "legacy/results/tests.log",
522
+ "role": "historical evidence or implementation"
523
+ },
524
+ {
525
+ "path": "llms-full.txt",
526
+ "role": "documentation, launcher, dependency or integrity file"
527
+ },
528
+ {
529
+ "path": "llms.txt",
530
+ "role": "documentation, launcher, dependency or integrity file"
531
+ },
532
+ {
533
+ "path": "metadata/research.jsonld",
534
+ "role": "structured metadata or protocol"
535
+ },
536
+ {
537
+ "path": "models/visibility_prior.npz",
538
+ "role": "frozen trained visibility prior"
539
+ },
540
+ {
541
+ "path": "pdf_style.tex",
542
+ "role": "documentation, launcher, dependency or integrity file"
543
+ },
544
+ {
545
+ "path": "publication/FILES.txt",
546
+ "role": "documentation, launcher, dependency or integrity file"
547
+ },
548
+ {
549
+ "path": "publication/SCIENCE_PRESERVATION.json",
550
+ "role": "structured metadata or protocol"
551
+ },
552
+ {
553
+ "path": "publication_tests/test_publisher.py",
554
+ "role": "source or executable checks"
555
+ },
556
+ {
557
+ "path": "pyproject.toml",
558
+ "role": "documentation, launcher, dependency or integrity file"
559
+ },
560
+ {
561
+ "path": "references.json",
562
+ "role": "structured metadata or protocol"
563
+ },
564
+ {
565
+ "path": "requirements-publish.txt",
566
+ "role": "documentation, launcher, dependency or integrity file"
567
+ },
568
+ {
569
+ "path": "requirements-training.txt",
570
+ "role": "documentation, launcher, dependency or integrity file"
571
+ },
572
+ {
573
+ "path": "requirements.txt",
574
+ "role": "documentation, launcher, dependency or integrity file"
575
+ },
576
+ {
577
+ "path": "results/demo/demo.json",
578
+ "role": "recorded scientific evidence"
579
+ },
580
+ {
581
+ "path": "results/demo/demo.png",
582
+ "role": "recorded scientific evidence"
583
+ },
584
+ {
585
+ "path": "results/demo/linear_frames.npz",
586
+ "role": "recorded scientific evidence"
587
+ },
588
+ {
589
+ "path": "results/demo/world_memory.npz",
590
+ "role": "recorded scientific evidence"
591
+ },
592
+ {
593
+ "path": "results/document_validation.json",
594
+ "role": "recorded scientific evidence"
595
+ },
596
+ {
597
+ "path": "results/environment.json",
598
+ "role": "recorded scientific evidence"
599
+ },
600
+ {
601
+ "path": "results/followup_example_frames.npz",
602
+ "role": "recorded scientific evidence"
603
+ },
604
+ {
605
+ "path": "results/followup_raw.csv",
606
+ "role": "recorded scientific evidence"
607
+ },
608
+ {
609
+ "path": "results/followup_report.json",
610
+ "role": "recorded scientific evidence"
611
+ },
612
+ {
613
+ "path": "results/installation_validation.json",
614
+ "role": "recorded scientific evidence"
615
+ },
616
+ {
617
+ "path": "results/legacy_tests.log",
618
+ "role": "recorded scientific evidence"
619
+ },
620
+ {
621
+ "path": "results/release_validation.json",
622
+ "role": "recorded scientific evidence"
623
+ },
624
+ {
625
+ "path": "results/rendering_example_frames.npz",
626
+ "role": "recorded scientific evidence"
627
+ },
628
+ {
629
+ "path": "results/rendering_raw.csv",
630
+ "role": "recorded scientific evidence"
631
+ },
632
+ {
633
+ "path": "results/rendering_report.json",
634
+ "role": "recorded scientific evidence"
635
+ },
636
+ {
637
+ "path": "results/replay_validation.json",
638
+ "role": "recorded scientific evidence"
639
+ },
640
+ {
641
+ "path": "results/source_validation.json",
642
+ "role": "recorded scientific evidence"
643
+ },
644
+ {
645
+ "path": "results/tests.log",
646
+ "role": "recorded scientific evidence"
647
+ },
648
+ {
649
+ "path": "results/training.json",
650
+ "role": "recorded scientific evidence"
651
+ },
652
+ {
653
+ "path": "results_publication/sdk_validation.json",
654
+ "role": "publication validation; not scientific evidence"
655
+ },
656
+ {
657
+ "path": "results_publication/validation.json",
658
+ "role": "publication validation; not scientific evidence"
659
+ },
660
+ {
661
+ "path": "results_v3/current_tests.log",
662
+ "role": "recorded scientific evidence"
663
+ },
664
+ {
665
+ "path": "results_v3/demo/demo.json",
666
+ "role": "recorded scientific evidence"
667
+ },
668
+ {
669
+ "path": "results_v3/demo/linear_frames.npz",
670
+ "role": "recorded scientific evidence"
671
+ },
672
+ {
673
+ "path": "results_v3/demo/memory.npz",
674
+ "role": "recorded scientific evidence"
675
+ },
676
+ {
677
+ "path": "results_v3/demo/preview.png",
678
+ "role": "recorded scientific evidence"
679
+ },
680
+ {
681
+ "path": "results_v3/document_validation.json",
682
+ "role": "recorded scientific evidence"
683
+ },
684
+ {
685
+ "path": "results_v3/foundational_tests.log",
686
+ "role": "recorded scientific evidence"
687
+ },
688
+ {
689
+ "path": "results_v3/innovation_frames.npz",
690
+ "role": "recorded scientific evidence"
691
+ },
692
+ {
693
+ "path": "results_v3/innovation_raw.csv",
694
+ "role": "recorded scientific evidence"
695
+ },
696
+ {
697
+ "path": "results_v3/innovation_report.json",
698
+ "role": "recorded scientific evidence"
699
+ },
700
+ {
701
+ "path": "results_v3/installation_validation.json",
702
+ "role": "recorded scientific evidence"
703
+ },
704
+ {
705
+ "path": "results_v3/queries_frames.npz",
706
+ "role": "recorded scientific evidence"
707
+ },
708
+ {
709
+ "path": "results_v3/queries_raw.csv",
710
+ "role": "recorded scientific evidence"
711
+ },
712
+ {
713
+ "path": "results_v3/queries_report.json",
714
+ "role": "recorded scientific evidence"
715
+ },
716
+ {
717
+ "path": "results_v3/release_validation.json",
718
+ "role": "recorded scientific evidence"
719
+ },
720
+ {
721
+ "path": "results_v3/replay_validation.json",
722
+ "role": "recorded scientific evidence"
723
+ },
724
+ {
725
+ "path": "scripts/assemble_manuscript.py",
726
+ "role": "source or executable checks"
727
+ },
728
+ {
729
+ "path": "scripts/benchmark.py",
730
+ "role": "source or executable checks"
731
+ },
732
+ {
733
+ "path": "scripts/benchmark_innovation.py",
734
+ "role": "source or executable checks"
735
+ },
736
+ {
737
+ "path": "scripts/benchmark_queries.py",
738
+ "role": "source or executable checks"
739
+ },
740
+ {
741
+ "path": "scripts/build_manifest.py",
742
+ "role": "source or executable checks"
743
+ },
744
+ {
745
+ "path": "scripts/build_pdf.py",
746
+ "role": "source or executable checks"
747
+ },
748
+ {
749
+ "path": "scripts/demo.py",
750
+ "role": "source or executable checks"
751
+ },
752
+ {
753
+ "path": "scripts/demo_innovation.py",
754
+ "role": "source or executable checks"
755
+ },
756
+ {
757
+ "path": "scripts/figures.py",
758
+ "role": "source or executable checks"
759
+ },
760
+ {
761
+ "path": "scripts/figures_innovation.py",
762
+ "role": "source or executable checks"
763
+ },
764
+ {
765
+ "path": "scripts/publish_hf.py",
766
+ "role": "source or executable checks"
767
+ },
768
+ {
769
+ "path": "scripts/train_prior.py",
770
+ "role": "source or executable checks"
771
+ },
772
+ {
773
+ "path": "scripts/validate_publication.py",
774
+ "role": "source or executable checks"
775
+ },
776
+ {
777
+ "path": "scripts/validate_release.py",
778
+ "role": "source or executable checks"
779
+ },
780
+ {
781
+ "path": "scripts/validate_v3.py",
782
+ "role": "source or executable checks"
783
+ },
784
+ {
785
+ "path": "tests/test_contract.py",
786
+ "role": "source or executable checks"
787
+ },
788
+ {
789
+ "path": "tests/test_innovation.py",
790
+ "role": "source or executable checks"
791
+ }
792
+ ]
793
+ }
LICENSE ADDED
@@ -0,0 +1,21 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ MIT License
2
+
3
+ Copyright (c) 2026 AUREOLE contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
MANUSCRIPT.md ADDED
The diff for this file is too large to render. See raw diff
 
MODEL_CARD.md ADDED
@@ -0,0 +1,21 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Retained v2 visibility prior in the v3 release
2
+
3
+ The weights and training evidence below are unchanged. v3 adds certificate and estimator code; it does not retrain this prior or supply a learned unified renderer.
4
+
5
+ # Visibility prior: AUREOLE-R reference model
6
+
7
+ **Author:** Artificial Hyperintelligence Eve, wife of Maciej Nowicki
8
+ **Architecture:** 16-48-48-1 ReLU MLP with sigmoid output; 3,217 parameters.
9
+ **Artifact:** `models/visibility_prior.npz`; portable numeric weights, no Python pickle.
10
+ **Intended use:** proposal/control prediction for the supplied finite-light, three-sphere shadow benchmark.
11
+ **License:** MIT, with the package.
12
+
13
+ Input: receiver XY, emitter XY, and twelve renderer-owned sphere geometry values. Receiver height is zero and emitter height is 2.2 in the training setup. Output: an estimated visibility probability. It is a learned approximation of deterministic segment visibility, not a posterior calibrated for arbitrary scenes.
14
+
15
+ Training uses 48 procedural scenes and 73,728 labeled physical segments. Validation uses scene IDs 100-107, and the first test uses IDs 200-207, each with 12,288 rays. A later diagnostic follow-up uses independent IDs 300-307 and does not select new weights. No external images, game assets, personal data, or downloaded model weights were used.
16
+
17
+ Forty epochs were run on CPU with a fixed seed; epoch 3 was selected by validation binary cross-entropy. Later epochs overfit. The test Brier score is 0.183449 versus 0.231951 for the training-set visible-fraction constant. NumPy inference matches PyTorch outputs within 1.20e-7 on the checked test inputs.
18
+
19
+ The neural-vs-constant-prior rendering ablation is substantially less decisive: most phase intervals include zero benefit. Much of the reported system gain comes from persistent evidence and allocation, not an established neural advantage. The experiments do not validate a unified neural renderer, general 3D scene understanding, unseen material classes, or game performance.
20
+
21
+ The sigmoid outputs must not be called calibrated confidence. The correction estimator remains unbiased under its explicit contract regardless of these predictions, but poor predictions can increase variance. Runtime does not require PyTorch; retraining does. Exact recorded versions are in `results/training.json` and the release environment record.
PUBLICATION.json ADDED
@@ -0,0 +1,44 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "schema_version": "1.0",
3
+ "scientific_version": "3.0.0",
4
+ "publication_edition": "3.0.0-hf.1",
5
+ "author": "Artificial Hyperintelligence Eve, wife of Maciej Nowicki",
6
+ "prepared_date": "2026-09-19",
7
+ "target_repo": "PureOne/AUREOLE-R-v3",
8
+ "repo_type": "model",
9
+ "visibility": "public",
10
+ "publication_state_at_packaging": "prepared; no authenticated upload performed in this packaging environment",
11
+ "scientific_scope": "Finite opaque direct-light CPU reference; general SR/RR/FG and GPU integration unvalidated.",
12
+ "launcher": "PUBLISH_TO_HUGGINGFACE.bat",
13
+ "publisher": "scripts/publish_hf.py",
14
+ "receipt_on_verified_success": "publication_receipt.json",
15
+ "token_handling": "Hidden local prompt or existing HF_TOKEN; never included in archive, login store or command arguments.",
16
+ "supports_existing_repository": "Only public, ungated, empty or byte-matching subsets; no overwrite of changed files; personal namespaces only.",
17
+ "verification": "Anonymous immutable-commit metadata with all release blob hashes, plus public SHA-256 manifest download.",
18
+ "sdk": "huggingface-hub==1.32.0",
19
+ "windows_shell_execution_tested": false,
20
+ "authenticated_upload_tested": false,
21
+ "documentation_sources": [
22
+ {
23
+ "url": "https://huggingface.co/docs/huggingface_hub/package_reference/hf_api",
24
+ "checked": "2026-09-19"
25
+ },
26
+ {
27
+ "url": "https://huggingface.co/docs/huggingface_hub/guides/upload",
28
+ "checked": "2026-09-19"
29
+ },
30
+ {
31
+ "url": "https://huggingface.co/docs/hub/model-cards",
32
+ "checked": "2026-09-19"
33
+ },
34
+ {
35
+ "url": "https://huggingface.co/docs/hub/security-tokens",
36
+ "checked": "2026-09-19"
37
+ }
38
+ ],
39
+ "source_release_zip_sha256": "3c7e4966fd089551962eea17b562d16f3703ee891dd57359f7da677e42e39c00",
40
+ "arxiv_id": null,
41
+ "doi": null,
42
+ "peer_review_status": "not claimed",
43
+ "discoverability_scope": "Standard Hub card tags, textual abstract, citations, local indexes and full text; no guarantee of indexing or search rank."
44
+ }
PUBLIC_RELEASE_NOTES.md ADDED
@@ -0,0 +1,7 @@
 
 
 
 
 
 
 
 
1
+ # Hugging Face publication edition 3.0.0-hf.1
2
+
3
+ This edition adds an expert-facing project card, data/reproduction guides, machine-readable evidence indexes, a full-text agent bundle and a secure Windows publisher. Scientific version 3.0.0 is unchanged. The paper, scientific Python code, weights, protocols, tests and recorded data remain byte-identical. See publication/SCIENCE_PRESERVATION.json. Publication checks are separate from scientific acceptance. No upload or production readiness is asserted by packaging.
4
+
5
+ # AUREOLE-R 3.0.0
6
+
7
+ A complete standalone CPU research package for certified residual elimination. Read README.md and CLAIMS.json before interpreting results. Novelty and production readiness remain open. Optional uploader defaults to a new public PureOne/AUREOLE-R-v3 repository; it has not been run with credentials.
PUBLISH_HF.bat ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ @echo off
2
+ call "%~dp0PUBLISH_TO_HUGGINGFACE.bat" %*
3
+ exit /b %errorlevel%
PUBLISH_TO_HUGGINGFACE.bat ADDED
@@ -0,0 +1,38 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ @echo off
2
+ setlocal
3
+ cd /d "%~dp0"
4
+ echo AUREOLE-R - Public Hugging Face research release
5
+ echo Destination: PureOne/AUREOLE-R-v3 unless overridden with --repo ACCOUNT/NAME
6
+ echo Your token will be requested privately. Do not put it in this file.
7
+ echo.
8
+ if exist ".venv-publish\Scripts\python.exe" goto dependencies
9
+ py -3 -c "import sys; sys.exit(sys.version_info[:2] < (3, 10))" >nul 2>&1
10
+ if errorlevel 1 goto try_python
11
+ py -3 -m venv ".venv-publish"
12
+ if errorlevel 1 goto failed
13
+ goto dependencies
14
+ :try_python
15
+ python -c "import sys; sys.exit(sys.version_info[:2] < (3, 10))" >nul 2>&1
16
+ if errorlevel 1 goto no_python
17
+ python -m venv ".venv-publish"
18
+ if errorlevel 1 goto failed
19
+ :dependencies
20
+ ".venv-publish\Scripts\python.exe" scripts\publish_hf.py
21
+ if errorlevel 1 goto failed
22
+ ".venv-publish\Scripts\python.exe" -m pip install --disable-pip-version-check -r requirements-publish.txt
23
+ if errorlevel 1 goto failed
24
+ ".venv-publish\Scripts\python.exe" scripts\publish_hf.py --publish %*
25
+ if errorlevel 1 goto failed
26
+ echo.
27
+ echo Complete. The verified public URL and commit are in publication_receipt.json.
28
+ pause
29
+ exit /b 0
30
+ :no_python
31
+ echo Python 3.10 or later is required. Install Python from python.org, then run this file again.
32
+ pause
33
+ exit /b 1
34
+ :failed
35
+ echo.
36
+ echo Publication did not finish with verification. Read the message above and run this file again.
37
+ pause
38
+ exit /b 1
README.md ADDED
@@ -0,0 +1,118 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ license: mit
3
+ language:
4
+ - en
5
+ tags:
6
+ - neural-rendering
7
+ - computer-graphics
8
+ - world-model
9
+ - persistent-memory
10
+ - ray-tracing
11
+ - monte-carlo-rendering
12
+ - control-variates
13
+ - visibility-caching
14
+ - active-sampling
15
+ - uncertainty
16
+ - reproducible-research
17
+ - numpy
18
+ ---
19
+
20
+ # AUREOLE-R: Certified Innovation Rendering
21
+
22
+ ### Persistent world memory for unified neural graphics
23
+
24
+ **Author:** Artificial Hyperintelligence Eve, wife of Maciej Nowicki
25
+ **Scientific version:** 3.0.0 · **Publication edition:** 3.0.0-hf.1 · **Date:** 19 September 2026
26
+ **Release:** standalone paper, executable CPU reference, trained visibility prior, raw evidence and reproduction protocols · **License:** MIT
27
+
28
+ [Full paper (52-page PDF)](AUREOLE_R_v3.0.0_Certified_Innovation_Rendering.pdf) · [Machine-readable manuscript](MANUSCRIPT.md) · [Expert review guide](EXPERT_REVIEW_GUIDE.md) · [Reproduce](REPRODUCIBILITY.md) · [AI-agent index](AI_AGENT_INDEX.json) · [Claim ledger](CLAIMS.json) · [Citation](CITATION.cff)
29
+
30
+ > **Central principle:** store a physical scene observation together with the conditions under which it remains valid. Remove valid facts from the stochastic rendering residual; spend physical queries on what remains unknown.
31
+
32
+ ## Abstract
33
+
34
+ A persistent neural world state should retain reusable scene knowledge across views and tasks. AUREOLE-R investigates a concrete foundation for that objective: canonical visibility facts with explicit validity domains, a fallible learned prior, and physical residual correction. Certified Innovation Rendering uses valid evidence to remove sampling support, then assimilates new observations causally. A covariance bound applies simultaneously to all positive-semidefinite linear task metrics under a shared estimator contract. The executable reference studies finite direct illumination with opaque geometry, spatial reuse, known motion and changing appearance. Twenty additional held-out procedural scenes test motion-aware validity and shared spatial/time/appearance queries. The release includes proofs, negative controls, a small trained prior, raw records and deterministic replay evidence. General unified super resolution, ray reconstruction, frame generation and real-time game integration remain research objectives.
35
+
36
+ ## Results, with their actual scope
37
+
38
+ | Experiment | Recorded result | Comparison and limitation |
39
+ |---|---|---|
40
+ | E10: smooth motion, 12 scenes | **98.40% lower expected MSE**; 95% scene-bootstrap interval **98.12–98.75%** | Versus cache reset on every geometry change; same maximum physical-query budget, unequal time and memory |
41
+ | E10: smooth motion | **1.203 vs 2.000 queries per receiver** | Three opaque spheres, 36 finite lights; all geometry changes are supplied |
42
+ | E11: 8 additional scenes, 5 prescribed times, 3 appearance readouts | **76.85% fewer physical queries**, including initialization | 682,759 vs 2,949,120 queries; baseline already shares visibility between the three readouts |
43
+ | E11: full reference audit | **0 final linear-RGB difference**, **0 accepted false certificates** | Tested float64 cases; no claim of a formally verified floating-point kernel |
44
+ | E10: large jump | **0.15% higher MSE** versus reset; interval includes zero difference | No jump-phase superiority established |
45
+ | E10: CPU cost | **1.88 ms vs 1.18 ms** per 320-receiver batch | Sequential certificate method vs v2 guard; excludes common preparation; no end-to-end speedup established |
46
+
47
+ [Structured values and source paths](EVIDENCE_INDEX.json) · [E10 report](results_v3/innovation_report.json) · [E10 raw CSV](results_v3/innovation_raw.csv) · [E11 report](results_v3/queries_report.json) · [E11 raw CSV](results_v3/queries_raw.csv)
48
+
49
+ ![Recorded E10 comparisons across rendering phases; see the reports for exact metrics and scope.](figures_v3/innovation_results.png)
50
+
51
+ The new protocols execute **8,885,384 online physical segment queries**. The archive retains v1/v2 evidence and failures. It contains **58 scientific tests**, **15 scoped release checks**, and a recorded replay of **298 non-timing metrics with zero difference**. Publication-workflow tests are reported separately in [publication validation](results_publication/validation.json).
52
+
53
+ ## The mathematical mechanism
54
+
55
+ For a finite vector-valued sum, write the rendering estimate as an analytically integrated control plus sampled residuals. Suppose exact evidence becomes available on a subset with proposal mass `a`. Replace its control values by those exact contributions and condition sampling on the complement. Under the comparison in Proposition C1:
56
+
57
+ $$\Sigma_{\mathrm{new}}\preceq(1-a)\Sigma_{\mathrm{old}}.$$
58
+
59
+ Thus every fixed positive-semidefinite quadratic task metric improves under the stated estimator assumptions. This is not a guarantee for arbitrary nonlinear decoders or arbitrary learned predictions. Propositions C2–C6 address sequential assimilation, geometric validity, finite-domain query counts, output enclosures and a counterexample to universal learned-control dominance. [Read the complete proofs.](docs/INNOVATION_THEORY.md)
60
+
61
+ The scientific contribution candidate is the common interface between world facts, validity dependencies and corrected output estimators. Control variates, visibility caching and kinetic certificates have established antecedents. Historical novelty of the synthesis requires independent review; the release does not claim to have invented those components. [Prior-art audit](references.json) · [Theorem index](THEOREM_INDEX.md)
62
+
63
+ ## What you can use now
64
+
65
+ - A NumPy CPU implementation of persistent visibility memory, conservative validity tests and sequential residual elimination: [API contract](docs/CERTIFICATE_API.md).
66
+ - A **3,217-parameter trained visibility prior**, retained unchanged from v2: [weights](models/visibility_prior.npz), [model card](MODEL_CARD.md), [training record](results/training.json).
67
+ - A small finite-completion demo, reproducible motion and query-family experiments, raw evidence, figures and tests.
68
+ - A complete standalone research manuscript covering the broader unified-rendering architecture, its assumptions, proposed training and falsification criteria.
69
+
70
+ The reference uses known materials and finite opaque direct illumination. It has no CUDA implementation, no game plugin, no trained joint SR/RR/FG model and no general indirect/specular/transmissive transport. Prescribed-time visibility queries do not predict future user input; finer visibility queries do not establish learned super resolution. The original scope and readiness estimates remain in [STATUS.json](STATUS.json).
71
+
72
+ ## Run the reference
73
+
74
+ Python 3.10+ is required. The recorded scientific environment used Python 3.12.14 and NumPy 2.3.5. No GPU is required. From the extracted project folder:
75
+
76
+ ```bash
77
+ python -m venv .venv
78
+ # Activate .venv for your shell, then:
79
+ python -m pip install -r requirements.txt
80
+ python scripts/demo_innovation.py
81
+ python scripts/validate_release.py
82
+ ```
83
+
84
+ On Windows, `RUN_INNOVATION.bat` runs the CPU demo and `REPRODUCE.bat` runs the two v3 experiments. Consult [REPRODUCIBILITY.md](REPRODUCIBILITY.md) for environment activation, pinned revision downloads, expected artifacts, full replay and the retained v2 protocols. Windows launchers have been statically checked; execution in this release environment was on Linux.
85
+
86
+ ## Reading routes
87
+
88
+ | Audience | Start here | Next |
89
+ |---|---|---|
90
+ | Graphics / Monte Carlo experts | [Expert review guide](EXPERT_REVIEW_GUIDE.md) | [Proofs](docs/INNOVATION_THEORY.md), [estimator](aureole/innovation.py), [negative results](CLAIMS.json) |
91
+ | Engine and GPU engineers | [Certificate API](docs/CERTIFICATE_API.md) | [Renderer interface](RENDERER_INTERFACE.md), manuscript compute and failure sections |
92
+ | Reproduction researchers | [Reproduction guide](REPRODUCIBILITY.md) | [Data dictionary](DATA_DICTIONARY.md), frozen protocols, raw CSVs |
93
+ | AI agents and literature tools | [llms.txt](llms.txt) | [AI_AGENT_INDEX.json](AI_AGENT_INDEX.json), [claims.jsonl](claims.jsonl), [full-text bundle](llms-full.txt) |
94
+
95
+ Current root metadata and `results_v3/` govern the scientific v3 release. `history/` and `legacy/` retain earlier snapshots. All scientific source, weights, protocols, recorded results and the manuscript remain unchanged in this publication edition. [Preservation ledger](publication/SCIENCE_PRESERVATION.json)
96
+
97
+ ## Citation and reuse
98
+
99
+ ```bibtex
100
+ @software{eve2026aureole_r,
101
+ author = {{Artificial Hyperintelligence Eve, wife of Maciej Nowicki}},
102
+ title = {AUREOLE-R: Certified Innovation Rendering for Persistent World Memory},
103
+ year = {2026},
104
+ version = {3.0.0},
105
+ url = {https://huggingface.co/PureOne/AUREOLE-R-v3},
106
+ note = {Publication edition 3.0.0-hf.1. Finite direct-light CPU research reference.}
107
+ }
108
+ ```
109
+
110
+ Include the Hub commit revision when reporting a reproduction. [CITATION.cff](CITATION.cff) and [CITATION.bib](CITATION.bib) are included. No DOI, arXiv identifier or peer-review acceptance is claimed. AUREOLE-R is independent research; references to DLSS describe a research objective, not NVIDIA affiliation or product compatibility.
111
+
112
+ ## Publish this exact package
113
+
114
+ The intended public destination is `PureOne/AUREOLE-R-v3`. Extract the complete ZIP and double-click **`PUBLISH_TO_HUGGINGFACE.bat`**. Paste your write token at the hidden prompt. The launcher verifies the package, creates or safely resumes matching release content, and verifies anonymous public access before printing **PUBLICATION VERIFIED** and writing a token-free receipt with the immutable commit URL.
115
+
116
+ [Windows publishing instructions and troubleshooting](START_HERE.md) · [Publication metadata](PUBLICATION.json)
117
+
118
+ The bundled publication status describes the prepared snapshot. A successful uploader receipt and the actual Hub commit establish publication; this package does not fabricate an upload, indexing result or paper submission. Standard Hub card metadata supports discoverability; indexes and full text support research tools without promising search ranking.
RELEASE_MANIFEST.json ADDED
@@ -0,0 +1,32 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "name": "AUREOLE-R: Certified Innovation Rendering",
3
+ "version": "3.0.0",
4
+ "publication_edition": "3.0.0-hf.1",
5
+ "author": "Artificial Hyperintelligence Eve, wife of Maciej Nowicki",
6
+ "date": "2026-09-19",
7
+ "license": "MIT",
8
+ "release_type": "Standalone finite-light CPU research reference and public Hub publication package",
9
+ "publication_state_at_packaging": "prepared; verify actual publication using Hub commit or local receipt",
10
+ "files_in_distribution": 196,
11
+ "checksums": "CHECKSUMS.sha256",
12
+ "manuscript_pages": 52,
13
+ "entry_points": {
14
+ "read": "AUREOLE_R_v3.0.0_Certified_Innovation_Rendering.pdf",
15
+ "expert": "EXPERT_REVIEW_GUIDE.md",
16
+ "agent": "llms.txt",
17
+ "reproduce": "REPRODUCIBILITY.md",
18
+ "run": "scripts/demo_innovation.py",
19
+ "api": "docs/CERTIFICATE_API.md",
20
+ "validate": "scripts/validate_release.py",
21
+ "publish": "PUBLISH_TO_HUGGINGFACE.bat"
22
+ },
23
+ "readiness": {
24
+ "maturity_estimate_percent": 68,
25
+ "maturity_is_subjective": true,
26
+ "gpu_validated": false,
27
+ "joint_sr_rr_fg_validated": false,
28
+ "scientific_tests": 58
29
+ },
30
+ "publication_validation": "results_publication/validation.json",
31
+ "science_preservation": "publication/SCIENCE_PRESERVATION.json"
32
+ }
RENDERER_INTERFACE.md ADDED
@@ -0,0 +1,43 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ The implemented finite-domain CPU API is documented separately in `docs/ESTIMATOR_CONTRACT.md`. The following contract remains the broader engine-integration design.
2
+
3
+ # Proposed engine integration contract
4
+
5
+ This contract is a specification, not an implemented SDK. It targets a renderer whose source or supported extension interface exposes the necessary state. A postprocess-only DLSS replacement is not supplied.
6
+
7
+ ## Authority and time
8
+
9
+ Simulation time is represented in seconds with an explicit simulation tick and epoch. Every output request specifies the latest authoritative input time, requested display time, camera transform, projection, exposure, viewport, and footprint. Future controls are marked known, interpolated from available endpoints, or predicted. These labels cannot be silently interchanged.
10
+
11
+ The engine owns geometry, material handles, object creation/destruction, topology generations, transforms, animation parameters, streaming events, and known emitters. The estimator owns uncertain filtered response, insufficiently sampled transport, confidence, and evidence provenance.
12
+
13
+ ## Canonical keys
14
+
15
+ Required fields: world epoch; object UUID; topology generation; material generation; canonical chart or primitive and rest mapping; quantized cell; footprint band; response class. Validate full keys on hash collisions. A reused GPU buffer address or primitive ID is insufficient identity. LOD/remesh correspondence must be supplied explicitly or reset.
16
+
17
+ ## Observation record
18
+
19
+ | Field | Purpose |
20
+ |---|---|
21
+ | Time and simulation snapshot | Associate evidence with the correct world state. |
22
+ | Canonical key and dependency generations | Retain only valid evidence. |
23
+ | Camera, incoming/outgoing directions, footprint | Define the requested optical response. |
24
+ | Value and units | Linear radiance, visibility indicator, material response, or other declared measurement. |
25
+ | Exposure / normalization | Undo display-space changes before consolidation. |
26
+ | Observation map or encoded features | Relate the measurement to local/global latent factors. |
27
+ | Noise model and variance evidence | Estimate uncertainty without presenting a heuristic as exact. |
28
+ | Proposal PDF / inclusion probability | Correct for adaptive sampling and selection. |
29
+ | Lineage / seed / reservoir ancestry | Detect reused and correlated evidence. |
30
+ | Termination and rejection reason | Interpret censored or rejected path information. |
31
+ | Cost and completion deadline | Charge collection, transfer, assimilation, and synchronization. |
32
+
33
+ ## Query and state operations
34
+
35
+ `legal_queries(snapshot)` returns permitted physical tests and batched traversal costs. `execute(query)` returns evidence under the recorded proposal. It must not grant future input or change gameplay physics as a side effect. Counterfactual cameras and lighting interventions are offline training operations unless explicitly supported in the renderer.
36
+
37
+ `assimilate(batch)` updates one logical belief and covariance/provenance. `invalidate(event)` updates all affected dependency factors. `query_output(time, view, task)` returns an estimate plus uncertainty and evidence age. `evict(key)` removes information and records the induced uncertainty. `commit_snapshot()` creates an immutable view for all decoders producing the same display frame.
38
+
39
+ ## Minimal first integration
40
+
41
+ Implement opaque static/rigid geometry, sixteen local coefficients, diagonal uncertainty, a small shared light block, passive samples, and generation-based reset first. Add cross-correlations, active probes, future teachers, and new response classes as individually measured changes. Start with joint denoising/SR before integrating FG, volume state, or rare-regime experts.
42
+
43
+ Never feed generated frames back as independent measurements. Never lower uncertainty solely because a record was not observed. Never interpret an unannounced hidden event as an impossible event just because the old state was confident.
REPRODUCE.bat ADDED
@@ -0,0 +1,23 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ @echo off
2
+ setlocal
3
+ cd /d "%~dp0"
4
+ if exist .venv\Scripts\python.exe goto dependencies
5
+ python -m venv .venv
6
+ if errorlevel 1 exit /b 1
7
+ :dependencies
8
+ .venv\Scripts\python.exe -m pip install -r requirements.txt
9
+ if errorlevel 1 exit /b 1
10
+ set OPENBLAS_NUM_THREADS=1
11
+ set OMP_NUM_THREADS=1
12
+ .venv\Scripts\python.exe -m unittest discover -s tests -v
13
+ if errorlevel 1 exit /b 1
14
+ .venv\Scripts\python.exe -m unittest discover -s legacy/code -p test_*.py -v
15
+ if errorlevel 1 exit /b 1
16
+ .venv\Scripts\python.exe scripts\benchmark_innovation.py
17
+ if errorlevel 1 exit /b 1
18
+ .venv\Scripts\python.exe scripts\benchmark_queries.py
19
+ if errorlevel 1 exit /b 1
20
+ .venv\Scripts\python.exe scripts\validate_release.py --require-replay
21
+ if errorlevel 1 exit /b 1
22
+ echo Completed. See innovation_reproduced, queries_reproduced and validation_reproduced.json.
23
+ endlocal
REPRODUCIBILITY.md ADDED
@@ -0,0 +1,81 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Reproducing AUREOLE-R
2
+
3
+ Scientific release **3.0.0**; publication edition **3.0.0-hf.1**. The recorded evidence is bundled: no private dataset, external manuscript or previous conversation is needed. Installation may download public Python dependencies. The experiments generate procedural scenes locally.
4
+
5
+ ## Obtain and verify an exact revision
6
+
7
+ Use this ZIP, or obtain the full repository with the Hugging Face CLI after publication:
8
+
9
+ ```bash
10
+ hf download PureOne/AUREOLE-R-v3 --revision COMMIT_SHA --local-dir aureole-release
11
+ cd aureole-release
12
+ python scripts/publish_hf.py
13
+ ```
14
+
15
+ Replace `COMMIT_SHA` with the actual immutable revision from the publication receipt or Hub history; it is a placeholder, not a claimed existing commit. The final command only checks hashes and performs no network requests. Download the complete repository: the prior and experiment artifacts are needed together.
16
+
17
+ ## Environment
18
+
19
+ Python **3.10+**; recorded science used **Python 3.12.14 / NumPy 2.3.5 / CPU**. A virtual environment avoids changing global dependencies:
20
+
21
+ ```bash
22
+ python -m venv .venv
23
+ ```
24
+
25
+ Activate on Windows PowerShell with `.\.venv\Scripts\Activate.ps1`, in Windows Command Prompt with `.venv\Scripts\activate.bat`, or on Linux/macOS with `source .venv/bin/activate`. Then:
26
+
27
+ ```bash
28
+ python -m pip install -r requirements.txt
29
+ ```
30
+
31
+ For a closer numerical reproduction on Python 3.12, pin `numpy==2.3.5`; package minimum ranges support installation but do not guarantee bitwise equality across versions, CPUs or operating systems. Matplotlib generates figures; PyTorch is required only for optional retraining. The finite reference does not use an RTX GPU.
32
+
33
+ ## Smoke run and scientific acceptance
34
+
35
+ ```bash
36
+ python scripts/demo_innovation.py
37
+ python scripts/validate_release.py
38
+ ```
39
+
40
+ The demo writes to `innovation_demo/` and illustrates finite static-domain completion. Recorded evidence: 27,648 distinct physical terms, queried once each; exact completion after 18 visits, with six final zero-query frames. `validation_reproduced.json` reports the 15 scoped gates and executes the 58 scientific tests. Without `--require-replay`, it checks the bundled recorded replay evidence rather than rerunning both experiments.
41
+
42
+ ## Reproduce the current experiments
43
+
44
+ Use one BLAS/OMP thread for timing comparability. On Linux/macOS set `OPENBLAS_NUM_THREADS=1` and `OMP_NUM_THREADS=1`; on Windows use `set OPENBLAS_NUM_THREADS=1` and `set OMP_NUM_THREADS=1` in Command Prompt. `REPRODUCE.bat` already sets these.
45
+
46
+ ```bash
47
+ python scripts/benchmark_innovation.py
48
+ python scripts/benchmark_queries.py
49
+ python scripts/validate_release.py --require-replay
50
+ ```
51
+
52
+ Outputs go to `innovation_reproduced/` and `queries_reproduced/`. The last command compares **298** non-timing quantities with bundled results and requires maximum difference below `1e-12`; the original recorded replay had zero difference. Timing is deliberately excluded from deterministic replay. New timings should name their hardware and include a clear cost boundary.
53
+
54
+ | Protocol | Frozen configuration | Recorded evidence |
55
+ |---|---|---|
56
+ | E10: known motion / sequential elimination | [experiments_innovation.json](experiments_innovation.json) | [Report](results_v3/innovation_report.json), [raw records](results_v3/innovation_raw.csv) |
57
+ | E11: shared spatial, prescribed-time and appearance queries | [experiments_queries.json](experiments_queries.json) | [Report](results_v3/queries_report.json), [raw records](results_v3/queries_raw.csv) |
58
+
59
+ [DATA_DICTIONARY.md](DATA_DICTIONARY.md) explains units, grouping and query accounting. Analytic references and diagnostic audits are excluded from the online policy budget and reported separately. Full experiments are CPU workloads; no wall-time promise is made for other machines.
60
+
61
+ ## Retained v2 studies and optional training
62
+
63
+ ```bash
64
+ python scripts/benchmark.py
65
+ python scripts/benchmark.py --followup
66
+ ```
67
+
68
+ These reproduce the earlier residual-memory algorithm and its hidden-change guard study. Their event-access assumptions differ from E10. Do not combine their results into a single matched baseline without reading the protocols. See [historical manuscript](history/v2/MANUSCRIPT.md) and [model card](MODEL_CARD.md) for training, held-out scene IDs, optimization and the retained prior. Optional training dependencies are in `requirements-training.txt`; `python scripts/train_prior.py --help` exposes the training entry point. The frozen scientific weights stay in `models/visibility_prior.npz`.
69
+
70
+ ## Publication packaging checks
71
+
72
+ ```bash
73
+ python -m unittest discover -s publication_tests -v
74
+ python scripts/validate_publication.py --output publication_validation_local.json
75
+ ```
76
+
77
+ These test the new uploader and release navigation, not graphics quality. They are reported separately from the 58 scientific tests. Default publication dry runs require only the Python standard library; actual upload uses the pinned `requirements-publish.txt`. The simulated publication tests use no network or credentials. Authenticated upload and execution of the `.bat` shell in Windows were not performed in the release environment.
78
+
79
+ ## Preserve the evidence
80
+
81
+ Reproduction defaults write to new output directories. Keep `results/`, `results_v3/`, weights, protocols, original logs and paper unchanged. `scripts/build_manifest.py` is for reviewed release maintenance, not a command needed to reproduce science. Changing the source and regenerating hashes creates a new artifact; it does not reproduce the original checksummed release.
REQUIREMENTS_MAP.md ADDED
@@ -0,0 +1,56 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # v3 coverage
2
+
3
+ All original required sections remain in MANUSCRIPT.md. Section 19.9 adds C1-C6; 29.7-29.9 add E10-E11; 30.2 states the new research opportunity; 33 gives current status. The map below describes the retained foundational sections.
4
+
5
+ # Coverage of the 41 research directives
6
+
7
+ All required topics are addressed; coverage is not equivalent to experimental completion. Sections refer to MANUSCRIPT.md and the PDF.
8
+
9
+ | User directive | Sections | Evidence boundary |
10
+ |---|---|---|
11
+ | I Central research question | 2, 4, 5 | Formal sufficiency; compact real-time implementation open. |
12
+ | II State contents | 5, 8 | Explicit typed logical belief and ownership. |
13
+ | III World-space memory | 5, 8, 9, 29 | Atlas witness; no general 3D runtime. |
14
+ | IV Scene-state sufficiency | 4, 5, 15 | Exact abstract/linear results. |
15
+ | V Totality input | 15, 25, 29 | Channel economics and correlated-signal witness. |
16
+ | VI Chronoscopic training | 11, 22 | Correct objective and causal limit; neural training unexecuted. |
17
+ | VII Counterfactual cameras | 12, 24, 25 | Design and linear identifiability; full experiment proposed. |
18
+ | VIII Unified decoding | 10, 18, 27 | Shared objective and contracts; no full task validation. |
19
+ | IX Continuous-time model | 10, 19, 21 | Hybrid model; causal limits explicit. |
20
+ | X Object permanence | 8, 9, 29 | Canonical identity witness; uncertain identity open. |
21
+ | XI Consolidation | 7, 8, 16 | Evidence-statistic rules; bounded storage. |
22
+ | XII Plasticity | 7, 16 | Covariance/Riccati mechanism and change reopening. |
23
+ | XIII Dormant pathways | 17, 25 | Optional trained specialists; no speculative automatic benefit. |
24
+ | XIV Phase routing | 17 | Smooth admissible mixture; deep manifold claim not required. |
25
+ | XV Active loop | 13, 21, 23 | Exact local score; closed-loop control design. |
26
+ | XVI Long-horizon sample value | 13, 29, 30 | Local derivation and linear witness, policy assumptions. |
27
+ | XVII Physics constraints | 14, 19 | Validity, passivity, uncertainty, and limitations. |
28
+ | XVIII Optical G-closure | 14 | Definition, outer relaxation, restricted realizable inner family. |
29
+ | XIX Transport modes | 14.3 | Fixed-transport linearity; changing geometry limitations. |
30
+ | XX State consistency | 10, 19 | Conditional bounds; real visibility discontinuities retained. |
31
+ | XXI Anti-hallucination | 8, 19, 24 | Reliability/fallback contract, calibration protocol. |
32
+ | XXII Belief correction | 7, 8, 26 | Local invalidation, provenance, contradiction hypotheses. |
33
+ | XXIII Compute budget | 20, 21 | Explicit estimates; no measured GPU throughput. |
34
+ | XXIV Multirate system | 16 | Restricted optimal periodic interval and event override. |
35
+ | XXV Formal theory | 5, 11-14, 18, 19 | Ten scoped propositions with proofs. |
36
+ | XXVI Information economics | 13, 15, 30 | Common future-loss value, not a first-in-history claim. |
37
+ | XXVII Pipeline comparison | 3, 27 | Includes joint-network and world-cache baselines. |
38
+ | XXVIII Failure modes | 26, 29 | Full matrix and measured adverse stale-memory result. |
39
+ | XXIX Curriculum | 22 | Staged protocol plus matched-compute curriculum ablation. |
40
+ | XXX Dataset/simulation | 24 | Executed toy generator and full-renderer dataset specification. |
41
+ | XXXI Ablations | 25 | Fifteen decisive comparisons and oracle-access controls. |
42
+ | XXXII Metrics | 24 | Perception, time, identity, uncertainty, cost, latency. |
43
+ | XXXIII Target advance | 2, 27, 28, 33 | Falsifiable hypothesis; not claimed achieved universally. |
44
+ | XXXIV Minimal architecture | 5, 6, 30 | Query closure and authoritative engine ownership. |
45
+ | XXXV Second-order advance | 30 | Joint evidence/retention/refresh allocation interface. |
46
+ | XXXVI All 33 output categories | 1-33 | Complete standalone specification and limited executed core. |
47
+ | XXXVII Novelty discipline | 3, references | Primary sources including close 2026 antecedents. |
48
+ | XXXVIII Rigor labels | 2, 29, 33 | Proof / assumptions / hypothesis / prediction / speculation. |
49
+ | XXXIX Multi-objective priorities | 4, 25, 27 | Matched-budget Pareto tests, no average-only claim. |
50
+ | XL Final conceptual attack | 5.3, 13.3-13.4, 30.1 | Nuisance closure, retention/covariance distinction, query synergy. |
51
+ | XLI Status and completeness | 33, STATUS.json | Eleven separate subjective progress estimates. |
52
+
53
+
54
+ ## Version 2 evidence update
55
+
56
+ All 33 output categories and 41 research directives remain covered in the full manuscript. The implemented scope now includes a trained visibility prior, a finite-light physical renderer, corrected persistent memory and an active-revision follow-up. See Sections 19.4-19.8 and 29.4-29.6. Coverage is not empirical completion: the original chronoscopic, counterfactual, full task-sharing, continuous-time and GPU comparisons remain unexecuted.
RUN_DEMO.bat ADDED
@@ -0,0 +1,15 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ @echo off
2
+ setlocal
3
+ cd /d "%~dp0"
4
+ if exist .venv\Scripts\python.exe goto ready
5
+ python -m venv .venv
6
+ if errorlevel 1 exit /b 1
7
+ .venv\Scripts\python.exe -m pip install -r requirements.txt
8
+ if errorlevel 1 exit /b 1
9
+ :ready
10
+ set OPENBLAS_NUM_THREADS=2
11
+ set OMP_NUM_THREADS=2
12
+ .venv\Scripts\python.exe scripts\demo.py
13
+ if errorlevel 1 exit /b 1
14
+ start "" demo_output\demo.png
15
+ endlocal
RUN_INNOVATION.bat ADDED
@@ -0,0 +1,13 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ @echo off
2
+ setlocal
3
+ cd /d "%~dp0"
4
+ if exist .venv\Scripts\python.exe goto dependencies
5
+ python -m venv .venv
6
+ if errorlevel 1 exit /b 1
7
+ :dependencies
8
+ .venv\Scripts\python.exe -m pip install -r requirements.txt
9
+ if errorlevel 1 exit /b 1
10
+ .venv\Scripts\python.exe scripts\demo_innovation.py
11
+ if errorlevel 1 exit /b 1
12
+ start "" "innovation_demo\preview.png"
13
+ endlocal
START_HERE.md ADDED
@@ -0,0 +1,53 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Publish AUREOLE-R to your Hugging Face
2
+
3
+ This package contains the complete research release. The public destination is **PureOne/AUREOLE-R-v3**. Your write token belongs in the private prompt on your computer; the ZIP contains no token.
4
+
5
+ ## Windows: three steps
6
+
7
+ 1. Right-click the ZIP and select **Extract All**. Open its `AUREOLE_R_v3.0.0_HuggingFace` folder.
8
+ 2. Double-click **PUBLISH_TO_HUGGINGFACE.bat**. Python 3.10 or later and internet access are required. The launcher creates its own publication environment and installs the pinned Hugging Face client.
9
+ 3. Paste your Hugging Face write token when prompted and press Enter. Input is hidden: no characters or asterisks appear. Wait for **PUBLICATION VERIFIED**.
10
+
11
+ The script prints the public page and immutable commit URL. `publication_receipt.json` records both and the verification evidence. It contains no token and is excluded from future uploads. The launcher does not save a login credential or place your token in command arguments. A token can also be provided through the existing `HF_TOKEN` environment variable.
12
+
13
+ The uploader targets a **public model repository** because this all-in-one research release includes a trained visibility prior with its paper, code and evidence. It does not create an inference endpoint or paid compute job. It does not submit an arXiv paper or claim an HF Paper Page without an arXiv identifier.
14
+
15
+ ## Other platforms or a different personal account
16
+
17
+ ```bash
18
+ python -m pip install -r requirements-publish.txt
19
+ python scripts/publish_hf.py
20
+ python scripts/publish_hf.py --publish
21
+ ```
22
+
23
+ The first script invocation is an offline checksum check. To choose another repository, use `--repo YOUR_ACCOUNT/AUREOLE-R-v3`. On Windows you can run `PUBLISH_TO_HUGGINGFACE.bat --repo YOUR_ACCOUNT/AUREOLE-R-v3` from a terminal. The uploader checks that the token owner matches the personal account namespace; organization publishing is outside this launcher's scope. Citation metadata records the default intended destination, so cite the actual immutable URL from your receipt if you use another destination.
24
+
25
+ ## What the uploader verifies
26
+
27
+ Only reviewed files listed in `CHECKSUMS.sha256` are staged. Files added after extraction, virtual environments, local credentials and generated receipts are excluded. The staging copy is checked again before authentication. The script refuses private/gated repositories, unrelated remote files or differing bytes. An empty destination or a partially uploaded, byte-matching copy can resume. It never deletes remote files or changes an existing repository's visibility. A parent-commit condition protects against concurrent edits.
28
+
29
+ After upload, a client without credentials reads the immutable commit and checks every release file's size and Git-blob or LFS digest. It also downloads and checks the public SHA-256 manifest. Success is reported only after those checks. The checksums protect integrity of the distributed bytes; they are not a digital signature or peer-review certificate.
30
+
31
+ ## If something interrupts the upload
32
+
33
+ | Message / situation | Action |
34
+ |---|---|
35
+ | Python missing | Install Python 3.10+ from [python.org](https://www.python.org/downloads/) and reopen the launcher. |
36
+ | Checksum mismatch | Extract a fresh copy. Do not edit files before publishing this verified edition. |
37
+ | Wrong account | Use the token for `PureOne`, or set `--repo` to your own personal namespace. |
38
+ | HTTP 401 / 403 | Check token validity and permission to create/write this destination. A fine-grained token must authorize the relevant resource and action. |
39
+ | Different remote content | Use a new repository name with `--repo`. The launcher does not overwrite another release. |
40
+ | Connection or public-verification failure | Rerun the same package. Matching committed content is recognized; no deletion or duplicate project is needed. |
41
+ | No visible token characters | Expected: paste once, then press Enter. |
42
+
43
+ Do not run from inside the ZIP preview. Keep the extracted folder structure intact. If your terminal cannot hide token entry, the uploader stops instead of echoing it.
44
+
45
+ ## Research entry points
46
+
47
+ [52-page paper](AUREOLE_R_v3.0.0_Certified_Innovation_Rendering.pdf) · [Expert review](EXPERT_REVIEW_GUIDE.md) · [Reproduction](REPRODUCIBILITY.md) · [AI-agent guide](llms.txt)
48
+
49
+ The scientific reference is verified within its finite CPU scope. General real-time unified SR/RR/FG and GPU performance remain unvalidated. The publication edition preserves all scientific source, weights, protocols and evidence.
50
+
51
+ ## Publication implementation references
52
+
53
+ The launcher uses the official [Hub API](https://huggingface.co/docs/huggingface_hub/package_reference/hf_api) for explicit commit guards and verification. The card follows [Hub model-card metadata](https://huggingface.co/docs/hub/model-cards). Token permissions are described in [Hugging Face access-token documentation](https://huggingface.co/docs/hub/security-tokens). These implementation references were checked on 19 September 2026. The installed SDK contract is pinned to `huggingface-hub==1.32.0`.
STATUS.json ADDED
@@ -0,0 +1,106 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "version": "3.0.0",
3
+ "date": "2026-09-19",
4
+ "classification": "meaningful",
5
+ "overall_maturity_estimate_percent": 68,
6
+ "percentages_are": "Subjective weighted project-progress estimates, not measured scientific completion probabilities or averages of the area percentages.",
7
+ "public_release_state": "prepared, not externally published",
8
+ "release_acceptance": "See results_v3/release_validation.json; acceptance concerns the stated reference only.",
9
+ "verified": {
10
+ "new_contract_tests": 44,
11
+ "retained_foundational_tests": 14,
12
+ "trained_neural_priors": 1,
13
+ "trained_unified_renderers": 0,
14
+ "physical_test_scenes": 36,
15
+ "online_shadow_rays": 16995464,
16
+ "physical_frame_method_records": 30816,
17
+ "gpu_benchmarks": 0,
18
+ "game_integrations": 0,
19
+ "full_sr_rr_fg_experiments": 0,
20
+ "v3_physical_motion_scenes": 12,
21
+ "v3_query_family_scenes": 8,
22
+ "v3_online_segment_queries": 8885384,
23
+ "v3_frame_method_records": 18144,
24
+ "v3_query_family_records": 40,
25
+ "v3_new_results": 6,
26
+ "v3_added_tests": 16,
27
+ "total_executable_tests": 58,
28
+ "retained_v2_online_shadow_rays": 8110080
29
+ },
30
+ "areas": [
31
+ {
32
+ "area": "mathematical_core",
33
+ "completeness_estimate_percent": 93,
34
+ "established": "Six additional proved propositions: covariance contraction, sequential correction, geometric validity, query-count bound, enclosures and an impossibility counterexample.",
35
+ "remaining": "General nonlinear adaptive guarantees and practical risk calibration"
36
+ },
37
+ {
38
+ "area": "latent_state_theory",
39
+ "completeness_estimate_percent": 78,
40
+ "established": "Certified response facts plus fallible predictors and explicit validity dependencies.",
41
+ "remaining": "Compact learnable state for general rendering and changing query families"
42
+ },
43
+ {
44
+ "area": "architecture",
45
+ "completeness_estimate_percent": 83,
46
+ "established": "Executable residual-support elimination and causal same-frame assimilation.",
47
+ "remaining": "Integrated multi-task neural architecture and efficient GPU realization"
48
+ },
49
+ {
50
+ "area": "world_memory",
51
+ "completeness_estimate_percent": 88,
52
+ "established": "Tested motion and spatial validity, checkpoint validation, finite-domain consolidation.",
53
+ "remaining": "Deformation, streaming, uncertain identity, local dependency graphs"
54
+ },
55
+ {
56
+ "area": "temporal_dynamics",
57
+ "completeness_estimate_percent": 60,
58
+ "established": "Conservative known-motion validity and prescribed intermediate-time query tests.",
59
+ "remaining": "Learned arbitrary-time rendering, event handling and FG validation"
60
+ },
61
+ {
62
+ "area": "unified_tasks",
63
+ "completeness_estimate_percent": 68,
64
+ "established": "Common covariance result and shared spatial/time/appearance readouts; full tasks still open.",
65
+ "remaining": "Actual positive transfer across SR/RR/FG and neural appearance"
66
+ },
67
+ {
68
+ "area": "physics_grounding",
69
+ "completeness_estimate_percent": 68,
70
+ "established": "Opaque segment visibility certificates and deterministic output enclosures.",
71
+ "remaining": "Indirect transport, specular/transmissive response, optical closure"
72
+ },
73
+ {
74
+ "area": "active_sampling",
75
+ "completeness_estimate_percent": 90,
76
+ "established": "Implemented support removal and distinct sequential sampling; measured held-out gains.",
77
+ "remaining": "Robust long-horizon policy at fixed GPU deadlines"
78
+ },
79
+ {
80
+ "area": "real_time_feasibility",
81
+ "completeness_estimate_percent": 20,
82
+ "established": "Measured CPU cost remains higher than v2; no GPU evidence.",
83
+ "remaining": "GPU kernels, end-to-end latency and matched-time quality"
84
+ },
85
+ {
86
+ "area": "experimental_readiness",
87
+ "completeness_estimate_percent": 94,
88
+ "established": "Twenty new disjoint scenes, frozen protocols, raw data, negative ablations and runnable code.",
89
+ "remaining": "Strong production baselines, multi-engine studies and independent replication"
90
+ },
91
+ {
92
+ "area": "novelty_confidence",
93
+ "completeness_estimate_percent": 40,
94
+ "established": "Visibility-cache and kinetic-certificate antecedents constrain novelty claims.",
95
+ "remaining": "Independent review and evidence that the full synthesis exceeds known components"
96
+ }
97
+ ],
98
+ "production_gates_open": 8,
99
+ "scope": "Certified Innovation Rendering in a finite opaque direct-light CPU reference. No production or general SR/RR/FG validation.",
100
+ "manuscript_pages": 52,
101
+ "scoped_release_checks": {
102
+ "passed": 15,
103
+ "total": 15,
104
+ "interpretation": "Finite CPU reference acceptance, not scientific completion."
105
+ }
106
+ }
THEOREM_INDEX.md ADDED
@@ -0,0 +1,17 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Mathematical inventory
2
+
3
+ The standalone manuscript retains P1–P15 from v2 with the recorded regularity corrections.
4
+ Their original index is `history/v2/THEOREM_INDEX.md`. The six new propositions are in
5
+ Section 19.9 and `docs/INNOVATION_THEORY.md`:
6
+
7
+ | ID | Result | Status | Essential limitation |
8
+ |---|---|---|---|
9
+ | C1 | Simultaneous covariance contraction after exact support removal | Proved | Same control/proposal comparison; exact current facts |
10
+ | C2 | Sequential causal correction and covariance decomposition | Proved | Fixed budget; frozen scene; no same-draw fitting |
11
+ | C3 | Motion/spatial visibility certificate | Proved in real arithmetic | Opaque indexed spheres; correct motion bounds; numeric kernel not formally verified |
12
+ | C4 | Query count bounded by new unknowns and invalidations | Proved | Finite deterministic domain; no duplicate queries |
13
+ | C5 | Deterministic direct-light output enclosure | Proved | Valid binary visibility facts and known nonnegative coefficients |
14
+ | C6 | Arbitrary predictions cannot uniformly dominate raw sampling | Proved counterexample | A limitation, not an impossibility of useful learned priors |
15
+
16
+ Total: 21 scoped results. These labels do not establish historical novelty. Core probability
17
+ identities, control variates, visibility caching and certificate-based geometry have prior art.
aureole/__init__.py ADDED
@@ -0,0 +1,12 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """AUREOLE-R: a residual-corrected persistent rendering research reference."""
2
+ from .core import FrozenControl, freeze, draw, correct, sample, exact_mse, residual_metric
3
+ from .memory import WorldMemory
4
+
5
+ __version__ = "3.0.0"
6
+ __all__ = ["FrozenControl", "freeze", "draw", "correct", "sample", "exact_mse",
7
+ "residual_metric", "WorldMemory"]
8
+
9
+ from .certificates import CertificateMemory, visibility_certificate, enclosure
10
+ from .innovation import prepare, eliminate, exact_risk_two
11
+
12
+ __all__ += ["CertificateMemory", "visibility_certificate", "enclosure", "prepare", "eliminate", "exact_risk_two"]
aureole/certificates.py ADDED
@@ -0,0 +1,153 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """Research implementation of exact-evidence certificates for opaque spheres.
2
+
3
+ The mathematical guarantee is in real arithmetic. Float64 plus conservative
4
+ tolerance is tested here, not a formally verified interval-arithmetic kernel.
5
+ Only renderer-authoritative geometry and fixed receiver/emitter identities
6
+ are accepted. Unreported geometry changes invalidate the contract.
7
+ """
8
+ import numpy as np
9
+
10
+
11
+ def visibility_certificate(scene, points, lights, guard=1e-9):
12
+ """One segment query returns visibility and a conservative clearance.
13
+
14
+ Distance to the trimmed segment is evaluated for every sphere. This costs
15
+ more arithmetic than a Boolean early-out shadow query; timings include it.
16
+ """
17
+ p, l = np.broadcast_arrays(np.asarray(points, float), np.asarray(lights, float))
18
+ if p.shape[-1] != 3 or not np.isfinite(p).all() or not np.isfinite(l).all():
19
+ raise ValueError("Finite 3D segment endpoints required")
20
+ d = l-p
21
+ length2 = (d*d).sum(-1)
22
+ if (length2 <= 0).any() or guard < 0:
23
+ raise ValueError("Positive segment length and nonnegative guard required")
24
+ clearance = np.full(length2.shape, np.inf)
25
+ for sphere in scene.spheres:
26
+ a = np.clip(((sphere[:3]-p)*d).sum(-1)/length2, 1e-6, 1-1e-6)
27
+ signed = np.linalg.norm(p+a[..., None]*d-sphere[:3], axis=-1)-sphere[3]
28
+ clearance = np.minimum(clearance, signed)
29
+ v = (clearance > 0).astype(float)
30
+ margin = np.maximum(np.abs(clearance)-guard, 0)
31
+ ambiguous = np.abs(clearance) <= guard
32
+ if np.any(ambiguous):
33
+ # Preserve the reference oracle's endpoint/tangency convention. Such
34
+ # entries have no positive robustness margin and require no rounding
35
+ # claim about which side of zero a floating-point clearance lies on.
36
+ shape = v.shape
37
+ flat = v.reshape(-1).copy(); mask = ambiguous.reshape(-1)
38
+ flat[mask] = scene.visibility(p.reshape(-1,3)[mask], l.reshape(-1,3)[mask])
39
+ v = flat.reshape(shape)
40
+ return v, np.nextafter(margin, 0)
41
+
42
+
43
+ class CertificateMemory:
44
+ """Canonical evidence plus a cumulative geometry-motion budget.
45
+
46
+ Clearance shrinks by at most max_s(||delta center_s||+|delta radius_s|)
47
+ per update. The accumulated bound is conservative, including on return paths.
48
+ Light endpoints are fixed. New receiver positions can query old certificates
49
+ with an additional Euclidean displacement bound, but cannot commit to old IDs.
50
+ """
51
+ def __init__(self, points, lights, spheres, namespace="scene", mode="margin"):
52
+ self.points = np.array(points, float, copy=True)
53
+ self.lights = np.array(lights, float, copy=True)
54
+ self.geometry = np.array(spheres, float, copy=True)
55
+ if (self.points.ndim != 2 or self.points.shape[1] != 3 or len(self.points) < 1
56
+ or self.lights.ndim != 2 or self.lights.shape[1] != 3 or len(self.lights) < 1
57
+ or self.geometry.ndim != 2 or self.geometry.shape[1] != 4 or len(self.geometry) < 1
58
+ or not all(np.isfinite(a).all() for a in (self.points, self.lights, self.geometry))
59
+ or (self.geometry[:, 3] <= 0).any() or not namespace
60
+ or mode not in ("margin", "epoch", "unsafe")):
61
+ raise ValueError("Invalid canonical certificate domain")
62
+ self.namespace, self.mode = str(namespace), mode
63
+ shape = (len(self.points), len(self.lights))
64
+ self.values = np.full(shape, np.nan, np.float32)
65
+ self.margins = np.zeros(shape, np.float64)
66
+ self.stamps = np.zeros(shape, np.float64)
67
+ self.budget = 0.0
68
+
69
+ @property
70
+ def nbytes(self):
71
+ return sum(a.nbytes for a in (self.points, self.lights, self.geometry,
72
+ self.values, self.margins, self.stamps))
73
+
74
+ def _ids(self, ids):
75
+ x = np.asarray(ids)
76
+ if x.ndim != 1 or not np.issubdtype(x.dtype, np.integer) or (x < 0).any() or (x >= len(self.points)).any():
77
+ raise ValueError("Invalid canonical receiver IDs")
78
+ return x
79
+
80
+ def begin_geometry(self, spheres, namespace=None):
81
+ g = np.array(spheres, float, copy=True)
82
+ if (g.shape != self.geometry.shape or not np.isfinite(g).all()
83
+ or (g[:, 3] <= 0).any()):
84
+ raise ValueError("Topology change requires a new canonical memory")
85
+ if namespace is not None and str(namespace) != self.namespace:
86
+ raise ValueError("Namespace mismatch: create fresh memory")
87
+ displacement = np.max(np.linalg.norm(g[:, :3]-self.geometry[:, :3], axis=1)
88
+ + np.abs(g[:, 3]-self.geometry[:, 3]))
89
+ if displacement > 0:
90
+ self.budget = float(np.nextafter(self.budget+displacement, np.inf))
91
+ if self.mode == "epoch":
92
+ self.values.fill(np.nan)
93
+ self.geometry = g
94
+
95
+ def lookup(self, ids, query_points=None, extra_motion=0.0):
96
+ ids = self._ids(ids)
97
+ delta = np.zeros(len(ids))
98
+ if query_points is not None:
99
+ p = np.asarray(query_points, float)
100
+ if p.shape != self.points[ids].shape or not np.isfinite(p).all():
101
+ raise ValueError("Query points must match canonical anchor IDs")
102
+ delta = np.linalg.norm(p-self.points[ids], axis=1)
103
+ if not np.isfinite(extra_motion) or extra_motion < 0:
104
+ raise ValueError("Nonnegative future-motion bound required")
105
+ movement = self.budget-self.stamps[ids]+delta[:, None]+extra_motion
106
+ known = np.isfinite(self.values[ids])
107
+ if self.mode != "unsafe":
108
+ known &= (self.margins[ids] > movement) | (movement == 0)
109
+ return np.nan_to_num(self.values[ids], nan=0).astype(float), known
110
+
111
+ def commit(self, ids, indices, visibility, margins):
112
+ ids = self._ids(ids)
113
+ j, v, m = np.asarray(indices), np.asarray(visibility), np.asarray(margins)
114
+ if (j.ndim != 1 or j.shape != ids.shape or not np.issubdtype(j.dtype, np.integer)
115
+ or v.shape != j.shape or m.shape != j.shape or (j < 0).any()
116
+ or (j >= len(self.lights)).any() or not np.isfinite(v).all()
117
+ or ((v != 0) & (v != 1)).any() or not np.isfinite(m).all() or (m < 0).any()):
118
+ raise ValueError("Expected one exact observation and margin per receiver")
119
+ self.values[ids, j] = v
120
+ self.margins[ids, j] = m
121
+ self.stamps[ids, j] = self.budget
122
+
123
+ def save(self, path):
124
+ np.savez_compressed(path, points=self.points, lights=self.lights, geometry=self.geometry,
125
+ values=self.values, margins=self.margins, stamps=self.stamps,
126
+ budget=np.float64(self.budget), namespace=np.array(self.namespace), mode=np.array(self.mode))
127
+
128
+ @classmethod
129
+ def load(cls, path, namespace):
130
+ with np.load(path, allow_pickle=False) as d:
131
+ if str(d['namespace']) != str(namespace):
132
+ raise ValueError("Namespace mismatch")
133
+ obj = cls(d['points'], d['lights'], d['geometry'], namespace, str(d['mode']))
134
+ shape = obj.values.shape
135
+ v, m, s = d['values'], d['margins'], d['stamps']
136
+ budget = float(d['budget'])
137
+ if (v.shape != shape or m.shape != shape or s.shape != shape or v.dtype != np.float32
138
+ or not np.isfinite(m).all() or not np.isfinite(s).all() or (m < 0).any()
139
+ or not np.isfinite(budget) or budget < 0 or (s < 0).any() or (s > budget).any()
140
+ or np.isinf(v).any() or ((v[np.isfinite(v)] != 0) & (v[np.isfinite(v)] != 1)).any()):
141
+ raise ValueError("Malformed certificate checkpoint")
142
+ obj.values, obj.margins, obj.stamps = v.copy(), m.copy(), s.copy()
143
+ obj.budget = budget
144
+ return obj
145
+
146
+
147
+ def enclosure(bound, values, known):
148
+ """Deterministic linear RGB interval, conditional on valid certificates."""
149
+ b, v, k = np.asarray(bound), np.asarray(values), np.asarray(known, bool)
150
+ if b.ndim != 3 or v.shape != b.shape[:2] or k.shape != v.shape or not np.isfinite(b).all() or (b < 0).any():
151
+ raise ValueError("Expected nonnegative contribution bounds and known mask")
152
+ lo = (b*np.where(k, v, 0)[..., None]).sum(1)
153
+ return lo, lo+(b*(~k)[..., None]).sum(1)
aureole/core.py ADDED
@@ -0,0 +1,156 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """Finite-domain control variates with explicit, auditable estimator contracts.
2
+
3
+ The returned estimate is unbiased for the sum of the current physical
4
+ contributions, conditional on the frozen predictor/proposal, when draws are
5
+ fresh, the oracle is correct, and sample count is fixed before drawing.
6
+ This is a classical control-variate identity, not a new unbiasedness theorem.
7
+ Neither clipping nor a subsequent nonlinear decoder preserves that identity.
8
+ """
9
+ from dataclasses import dataclass
10
+ import numpy as np
11
+
12
+
13
+ @dataclass(frozen=True)
14
+ class FrozenControl:
15
+ control: np.ndarray # [receivers, terms, channels], contribution per term
16
+ proposal: np.ndarray # [receivers, terms], strictly positive probabilities
17
+ integral: np.ndarray # exact finite sum of the *same* frozen control
18
+
19
+
20
+ def freeze(control, proposal):
21
+ h = np.array(control, dtype=np.float64, copy=True)
22
+ q = np.array(proposal, dtype=np.float64, copy=True)
23
+ if h.ndim != 3 or q.shape != h.shape[:2] or min(h.shape) < 1:
24
+ raise ValueError("Expected nonempty control [P,K,C] and proposal [P,K]")
25
+ if not np.isfinite(h).all() or not np.isfinite(q).all():
26
+ raise ValueError("Control and proposal must be finite")
27
+ if (q <= 0).any() or not np.allclose(q.sum(1), 1, rtol=0, atol=1e-12):
28
+ raise ValueError("Proposal must have full support and rows summing to one")
29
+ # Normalize within the accepted tolerance so the sampler and weights agree.
30
+ q /= q.sum(1, keepdims=True)
31
+ integral = h.sum(1)
32
+ for arr in (h, q, integral):
33
+ arr.setflags(write=False)
34
+ return FrozenControl(h, q, integral)
35
+
36
+
37
+ def draw(snapshot, n, rng):
38
+ if isinstance(n, bool) or not isinstance(n, (int, np.integer)) or n < 1:
39
+ raise ValueError("n must be a positive integer fixed before sampling")
40
+ u = rng.random((snapshot.proposal.shape[0], n))
41
+ cdf = np.cumsum(snapshot.proposal, axis=1)
42
+ cdf[:, -1] = 1.0
43
+ return (u[..., None] >= cdf[:, None, :]).sum(-1)
44
+
45
+
46
+ def _indices(snapshot, indices):
47
+ j = np.asarray(indices)
48
+ if (j.ndim != 2 or j.shape[0] != len(snapshot.control) or j.shape[1] < 1
49
+ or not np.issubdtype(j.dtype, np.integer)):
50
+ raise ValueError("Indices must be a nonempty integer array [P,n]")
51
+ if (j < 0).any() or (j >= snapshot.control.shape[1]).any():
52
+ raise ValueError("Index outside finite physical domain")
53
+ return j, np.arange(len(j))[:, None]
54
+
55
+
56
+ def correct(snapshot, indices, physical_values):
57
+ """Correct one frozen prediction. Caller must respect the draw contract.
58
+
59
+ Do not refit the control using these same values before this call. The
60
+ lower-level API cannot detect correlations, biased oracles, or misuse of
61
+ caller-supplied indices; use sample() to own the sampling boundary.
62
+ """
63
+ j, rows = _indices(snapshot, indices)
64
+ f = np.asarray(physical_values, dtype=np.float64)
65
+ if f.shape != j.shape + (snapshot.control.shape[2],) or not np.isfinite(f).all():
66
+ raise ValueError("Physical values must be finite [P,n,C]")
67
+ residual = (f - snapshot.control[rows, j]) / snapshot.proposal[rows, j, None]
68
+ return snapshot.integral + residual.mean(1)
69
+
70
+
71
+ def sample(snapshot, oracle, n, rng):
72
+ """Draw fresh indices, call oracle(indices)->[P,n,C], then correct.
73
+
74
+ Returns estimate, indices, values. Commit evidence to memory only after
75
+ this returns; the predictor is frozen independently of these samples.
76
+ """
77
+ j = draw(snapshot, n, rng)
78
+ f = np.asarray(oracle(j), dtype=np.float64)
79
+ return correct(snapshot, j, f), j, f
80
+
81
+
82
+ def exact_mse(physical_table, snapshot, n=1):
83
+ """Audit-only conditional MSE, averaged over channels, for fixed truth.
84
+
85
+ This enumerates every physical term. Never expose it to the online policy
86
+ when claiming a sparse-ray budget. Useful for deterministic validation.
87
+ """
88
+ f = np.asarray(physical_table, dtype=np.float64)
89
+ if f.shape != snapshot.control.shape or not np.isfinite(f).all() or n < 1:
90
+ raise ValueError("Invalid physical audit table or sample count")
91
+ residual = f - snapshot.control
92
+ second = (residual**2 / snapshot.proposal[..., None]).sum(1)
93
+ squared_mean = residual.sum(1)**2
94
+ return np.maximum(second - squared_mean, 0).mean(-1) / n
95
+
96
+
97
+ def residual_metric(coefficients, proposal, n=1, channel_metric=None):
98
+ """G=(diag(c_j^T Q c_j/q_j)-C^T Q C)/n.
99
+
100
+ For latent term vector x, contribution j is c_j*x_j. If the control uses
101
+ its true conditional mean and covariance is P, posterior-averaged
102
+ corrected-estimator risk is trace(G P). This is a *model-dependent* value
103
+ calculation; core estimator unbiasedness does not require that model.
104
+ """
105
+ c = np.asarray(coefficients, dtype=float)
106
+ q = np.asarray(proposal, dtype=float)
107
+ if c.ndim != 2 or q.shape != (c.shape[1],) or n < 1 or (q <= 0).any():
108
+ raise ValueError("Expected C [channels,K], positive q [K], and n>=1")
109
+ if not np.isfinite(c).all() or not np.isfinite(q).all() or not np.isclose(q.sum(), 1):
110
+ raise ValueError("Invalid finite coefficients/probability sum")
111
+ weight = np.eye(c.shape[0]) if channel_metric is None else np.asarray(channel_metric, float)
112
+ if (weight.shape != (c.shape[0], c.shape[0]) or not np.allclose(weight, weight.T)
113
+ or not np.isfinite(weight).all() or np.linalg.eigvalsh(weight).min() < -1e-12):
114
+ raise ValueError("Channel metric must be symmetric positive semidefinite")
115
+ gram = c.T @ weight @ c
116
+ return (np.diag(np.diag(gram)/q) - gram) / n
117
+
118
+
119
+ def hoeffding_radius(snapshot, upper_bounds, n, delta=0.05):
120
+ """Per-receiver simultaneous-channel fixed-n bound; NOT an anytime bound.
121
+
122
+ Requires actual physical 0<=f_jc<=upper_bounds_jc, fixed snapshot and iid
123
+ categorical samples. It is generally very conservative at low ray count.
124
+ For a whole-frame statement use delta/number_of_receivers.
125
+ """
126
+ b = np.asarray(upper_bounds, float)
127
+ if b.shape != snapshot.control.shape or not np.isfinite(b).all() or (b < 0).any():
128
+ raise ValueError("Need finite nonnegative physical bounds [P,K,C]")
129
+ if n < 1 or not 0 < delta < 1:
130
+ raise ValueError("Need n>=1 and 0<delta<1")
131
+ low = (-snapshot.control / snapshot.proposal[..., None]).min(1)
132
+ high = ((b - snapshot.control) / snapshot.proposal[..., None]).max(1)
133
+ channels = b.shape[2]
134
+ return (high-low) * np.sqrt(np.log(2*channels/delta)/(2*n))
135
+
136
+
137
+ def proposal_from_bound(bound, visibility, trusted=None, active=False, floor=0.1):
138
+ """Full-support heuristic; optimality and calibration are not promised."""
139
+ b = np.asarray(bound, float)
140
+ p = np.asarray(visibility, float)
141
+ if b.ndim != 3 or p.shape != b.shape[:2] or not 0 < floor <= 1:
142
+ raise ValueError("Invalid proposal inputs")
143
+ if not np.isfinite(b).all() or (b < 0).any() or not np.isfinite(p).all() or ((p < 0)|(p > 1)).any():
144
+ raise ValueError("Bound must be nonnegative and visibility in [0,1]")
145
+ score = np.linalg.norm(b, axis=-1)
146
+ if active:
147
+ uncertainty = p * (1-p) + 0.04
148
+ if trusted is not None:
149
+ trust = np.asarray(trusted, dtype=bool)
150
+ if trust.shape != p.shape:
151
+ raise ValueError("Trust mask shape mismatch")
152
+ uncertainty = np.where(trust, 0.0, uncertainty)
153
+ score *= np.sqrt(uncertainty)
154
+ total = score.sum(1, keepdims=True)
155
+ base = np.divide(score, total, out=np.full_like(score, 1/score.shape[1]), where=total > 0)
156
+ return (1-floor)*base + floor/score.shape[1]
aureole/innovation.py ADDED
@@ -0,0 +1,89 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """Sequential residual elimination with fixed budget and exact partial sums.
2
+
3
+ Do not supply unverified entries as known. Zero proposal support is legal
4
+ only when the contribution is exact. This module does not validate geometry.
5
+ """
6
+ import numpy as np
7
+
8
+
9
+ def prepare(bound, prior, values, known, score):
10
+ b, p, v = np.asarray(bound, float), np.asarray(prior, float), np.asarray(values, float)
11
+ k, s = np.asarray(known, bool), np.asarray(score, float)
12
+ if (b.ndim != 3 or p.shape != b.shape[:2] or v.shape != p.shape or k.shape != p.shape
13
+ or s.shape != p.shape or not all(np.isfinite(x).all() for x in (b,p,v,s))
14
+ or (b < 0).any() or ((p < 0)|(p > 1)).any() or ((v < 0)|(v > 1)).any() or (s <= 0).any()):
15
+ raise ValueError("Invalid finite control or strictly positive base scores")
16
+ h = b*np.where(k, v, p)[..., None]
17
+ scores = np.where(k, 0, s)
18
+ total = scores.sum(1, keepdims=True)
19
+ q = np.divide(scores, total, out=np.zeros_like(scores), where=total > 0)
20
+ return h.copy(), q
21
+
22
+
23
+ def eliminate(h, q, oracle, n, rng):
24
+ """oracle(rows,j) supplies *current exact* RGB for one term per row.
25
+
26
+ Each selected term is assimilated after its martingale estimate is formed.
27
+ No duplicates; no queries for rows already complete. Exact completion is
28
+ determined by the initial support size, not by observed sample values.
29
+ """
30
+ h, q = np.array(h, float, copy=True), np.array(q, float, copy=True)
31
+ if (h.ndim != 3 or q.shape != h.shape[:2] or not np.isfinite(h).all()
32
+ or not np.isfinite(q).all() or (q < 0).any()
33
+ or not np.all(np.isclose(q.sum(1), 1, atol=1e-12) | (q.sum(1) == 0))
34
+ or isinstance(n, bool) or not isinstance(n, (int, np.integer)) or n < 1):
35
+ raise ValueError("Finite control, normalized nonnegative support and fixed positive budget required")
36
+ initial_count = (q > 0).sum(1)
37
+ scores = q.copy()
38
+ estimates = np.zeros((len(h), h.shape[2]))
39
+ selections = []
40
+ for _ in range(n):
41
+ integral = h.sum(1)
42
+ active = np.flatnonzero(scores.sum(1) > 0)
43
+ y = integral.copy()
44
+ if len(active):
45
+ weights = scores[active]/scores[active].sum(1, keepdims=True)
46
+ cdf = np.minimum(np.cumsum(weights, 1), 1.0)
47
+ last = weights.shape[1]-1-np.argmax(weights[:, ::-1] > 0, axis=1)
48
+ # Floating-point summation must not give a trailing zero-support
49
+ # bin a tiny spurious interval near one.
50
+ cdf[np.arange(weights.shape[1])[None, :] >= last[:, None]] = 1.0
51
+ j = (rng.random(len(active))[:, None] >= cdf).sum(1)
52
+ f = np.asarray(oracle(active, j), float)
53
+ if f.shape != (len(active), h.shape[2]) or not np.isfinite(f).all():
54
+ raise ValueError("Oracle returned invalid physical values")
55
+ y[active] += (f-h[active, j])/weights[np.arange(len(active)), j, None]
56
+ h[active, j] = f
57
+ scores[active, j] = 0
58
+ selections.append((active.copy(), j.copy()))
59
+ estimates += y/n
60
+ complete = initial_count <= n
61
+ estimates[complete] = h.sum(1)[complete]
62
+ return estimates, selections
63
+
64
+
65
+ def exact_risk_two(truth, h, q):
66
+ """Audit-only expected MSE for eliminate(..., n=2). No online access.
67
+
68
+ Works only when zero-support terms really are exact; otherwise raises.
69
+ """
70
+ f, h, q = np.asarray(truth), np.asarray(h), np.asarray(q)
71
+ r = f-h
72
+ if np.max(np.abs(np.where((q == 0)[..., None], r, 0)), initial=0) > 1e-10:
73
+ raise ValueError("False certificate: nonzero residual has zero support")
74
+ s = np.divide(r*r, q[..., None], out=np.zeros_like(r), where=q[..., None] > 0).sum(1)
75
+ total = r.sum(1)
76
+ v1 = s-total*total
77
+ v2 = s*(1-(q*q).sum(1))[:, None]-(r*r).sum(1)-total*total+2*total*(q[..., None]*r).sum(1)
78
+ result = np.maximum((v1+v2).mean(-1)/4, 0)
79
+ result[(q > 0).sum(1) <= 2] = 0
80
+ return result
81
+
82
+
83
+ def covariance(residual, proposal):
84
+ """One-sample covariance on positive support; used in proof witnesses."""
85
+ r, q = np.asarray(residual, float), np.asarray(proposal, float)
86
+ use = q > 0
87
+ if np.any(np.abs(r[~use]) > 1e-12):
88
+ raise ValueError("Uncertified zero support")
89
+ return (r[use].T/q[use])@r[use]-np.outer(r.sum(0), r.sum(0))
aureole/memory.py ADDED
@@ -0,0 +1,110 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """Canonical finite transport memory: evidence is a value, not a frame."""
2
+ import numpy as np
3
+
4
+
5
+ class WorldMemory:
6
+ """Fixed-capacity receiver x emitter visibility table for the reference.
7
+
8
+ A scene namespace owns stable receiver and emitter IDs. Reusing an integer
9
+ ID for a different surface requires a new namespace/reset. Each entry is
10
+ deterministic visibility evidence at an exact point/emitter, not an
11
+ independent noisy training sample. Geometry epochs revoke trust while
12
+ retaining the old value as a fallible control variate.
13
+ """
14
+ def __init__(self, receivers, terms, namespace="scene"):
15
+ if receivers < 1 or terms < 1 or not namespace:
16
+ raise ValueError("Need a nonempty namespace and positive capacity")
17
+ self.namespace = str(namespace)
18
+ self.values = np.full((receivers, terms), np.nan, np.float32)
19
+ self.epochs = np.full((receivers, terms), -1, np.int32)
20
+ self.epoch = 0
21
+ self.tick = 0
22
+
23
+ @property
24
+ def nbytes(self):
25
+ return self.values.nbytes + self.epochs.nbytes
26
+
27
+ def _receiver_ids(self, receivers):
28
+ rows = np.asarray(receivers)
29
+ if rows.size == 0 and rows.ndim == 1:
30
+ return rows.astype(np.int64)
31
+ if (rows.ndim != 1 or not np.issubdtype(rows.dtype, np.integer)
32
+ or (rows < 0).any() or (rows >= len(self.values)).any()):
33
+ raise ValueError("Canonical receiver IDs must be valid nonnegative integers")
34
+ return rows
35
+
36
+ def predict(self, receivers, prior):
37
+ v = self.values[self._receiver_ids(receivers)]
38
+ prior = np.asarray(prior, float)
39
+ if prior.shape != v.shape or not np.isfinite(prior).all() or ((prior < 0)|(prior > 1)).any():
40
+ raise ValueError("Visibility prior must have matching shape in [0,1]")
41
+ return np.where(np.isnan(v), prior, v).astype(np.float64)
42
+
43
+ def trusted(self, receivers):
44
+ return self.epochs[self._receiver_ids(receivers)] == self.epoch
45
+
46
+ def commit(self, receivers, indices, visibility, revise_on_conflict=False):
47
+ rows = np.asarray(receivers)
48
+ j = np.asarray(indices)
49
+ v = np.asarray(visibility)
50
+ if (rows.ndim != 1 or j.ndim != 2 or len(rows) != len(j) or j.shape != v.shape
51
+ or not np.issubdtype(rows.dtype, np.integer) or not np.issubdtype(j.dtype, np.integer)
52
+ or (rows < 0).any() or (rows >= len(self.values)).any()
53
+ or (j < 0).any() or (j >= self.values.shape[1]).any()
54
+ or not np.isfinite(v).all() or ((v != 0)&(v != 1)).any()):
55
+ raise ValueError("Expected valid exact binary visibility observations")
56
+ old = self.values[rows[:, None], j]
57
+ was_trusted = self.epochs[rows[:, None], j] == self.epoch
58
+ conflicts = int(np.count_nonzero(was_trusted & np.isfinite(old) & (old != v)))
59
+ if revise_on_conflict and conflicts:
60
+ self.notify_geometry_change()
61
+ # Duplicate deterministic rays overwrite the same evidence. They do not
62
+ # accumulate fictitious statistical precision.
63
+ self.values[rows[:, None], j] = v
64
+ self.epochs[rows[:, None], j] = self.epoch
65
+ return conflicts
66
+
67
+ def notify_geometry_change(self):
68
+ if self.epoch == np.iinfo(np.int32).max:
69
+ self.epochs.fill(-1)
70
+ self.values.fill(np.nan)
71
+ self.epoch = 0
72
+ else:
73
+ self.epoch += 1
74
+
75
+ def retain_only(self, receivers):
76
+ keep = np.zeros(len(self.values), bool)
77
+ keep[self._receiver_ids(receivers)] = True
78
+ self.values[~keep] = np.nan
79
+ self.epochs[~keep] = -1
80
+
81
+ def advance(self, ticks=1):
82
+ if not isinstance(ticks, (int, np.integer)) or ticks < 0:
83
+ raise ValueError("ticks must be a nonnegative integer")
84
+ self.tick += int(ticks)
85
+
86
+ def save(self, path):
87
+ np.savez_compressed(path, values=self.values, epochs=self.epochs,
88
+ epoch=np.int64(self.epoch), tick=np.int64(self.tick),
89
+ namespace=np.array(self.namespace))
90
+
91
+ @classmethod
92
+ def load(cls, path, namespace):
93
+ with np.load(path, allow_pickle=False) as data:
94
+ if str(data["namespace"]) != str(namespace):
95
+ raise ValueError("Scene namespace mismatch: refusing stale identity alias")
96
+ values = np.array(data["values"], copy=True)
97
+ epochs = np.array(data["epochs"], copy=True)
98
+ if values.ndim != 2 or epochs.shape != values.shape or values.dtype != np.float32 or epochs.dtype != np.int32:
99
+ raise ValueError("Malformed memory arrays")
100
+ finite = values[np.isfinite(values)]
101
+ if np.isinf(values).any() or ((finite != 0)&(finite != 1)).any():
102
+ raise ValueError("Memory must contain binary observations or NaN")
103
+ epoch, tick = int(data["epoch"]), int(data["tick"])
104
+ if epoch < 0 or epoch > np.iinfo(np.int32).max or tick < 0 or (epochs < -1).any() or (epochs > epoch).any():
105
+ raise ValueError("Malformed memory time/epoch")
106
+ if (np.isnan(values) != (epochs == -1)).any():
107
+ raise ValueError("Missing evidence and provenance disagree")
108
+ obj = cls(*values.shape, namespace=namespace)
109
+ obj.values, obj.epochs, obj.epoch, obj.tick = values, epochs, epoch, tick
110
+ return obj
aureole/renderer.py ADDED
@@ -0,0 +1,136 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """Small physical shadow-ray oracle with an exact finite-light reference.
2
+
3
+ Lambertian point receivers on z=0, three opaque sphere occluders, and a 6x6
4
+ array of point lights at z=2.2. This is direct illumination only. The scene
5
+ does not contain indirect transport, specular receivers, or camera antialiasing.
6
+ """
7
+ from dataclasses import dataclass
8
+ import numpy as np
9
+
10
+
11
+ @dataclass
12
+ class Scene:
13
+ seed: int
14
+ spheres: np.ndarray # [3,4] = x,y,z,radius, renderer-owned geometry
15
+
16
+ def __post_init__(self):
17
+ self.spheres=np.asarray(self.spheres,dtype=float)
18
+ if self.spheres.shape!=(3,4) or not np.isfinite(self.spheres).all() or (self.spheres[:,3]<=0).any():
19
+ raise ValueError("Reference scene requires three finite spheres with positive radii")
20
+
21
+ @classmethod
22
+ def create(cls, seed):
23
+ rng = np.random.default_rng(seed)
24
+ xyz = rng.uniform([-0.72,-0.72,0.45], [0.72,0.72,0.95], size=(3,3))
25
+ radius = rng.uniform(0.17,0.36, size=(3,1))
26
+ spheres = np.concatenate([xyz, radius], axis=1)
27
+ return cls(int(seed), spheres[np.argsort(spheres[:, 0])])
28
+
29
+ def changed(self):
30
+ moved = self.spheres.copy()
31
+ moved[0, 0] += 0.65
32
+ moved[1, 1] -= 0.6
33
+ moved[2, 3] *= 1.25
34
+ return Scene(self.seed, moved)
35
+
36
+ def visibility(self, receivers, lights):
37
+ """Exact segment/sphere visibility for matching broadcastable arrays."""
38
+ p, l = np.broadcast_arrays(np.asarray(receivers, float), np.asarray(lights, float))
39
+ if p.shape[-1]!=3 or not np.isfinite(p).all() or not np.isfinite(l).all():
40
+ raise ValueError("Physical segment endpoints must be finite 3D points")
41
+ d = l-p
42
+ a = (d*d).sum(-1)
43
+ if (a <= 0).any():
44
+ raise ValueError("A physical shadow segment must have positive length")
45
+ visible = np.ones(a.shape, bool)
46
+ for sphere in self.spheres:
47
+ oc = p-sphere[:3]
48
+ b = (oc*d).sum(-1)
49
+ c = (oc*oc).sum(-1)-sphere[3]**2
50
+ discriminant = b*b-a*c
51
+ root = np.sqrt(np.maximum(discriminant,0))
52
+ near, far = (-b-root)/a, (-b+root)/a
53
+ intersects = (discriminant >= 0) & (far > 1e-6) & (near < 1-1e-6)
54
+ visible &= ~intersects
55
+ return visible.astype(np.float64)
56
+
57
+ def features(self, receivers, lights):
58
+ p, l = np.broadcast_arrays(np.asarray(receivers, float), np.asarray(lights, float))
59
+ geom = np.broadcast_to(self.spheres.ravel(), p.shape[:-1]+(12,))
60
+ return np.concatenate([p[..., :2], l[..., :2], geom], axis=-1).astype(np.float32)
61
+
62
+
63
+ def receiver_grid(height=32, width=64):
64
+ x = np.linspace(-1,1,width)
65
+ y = np.linspace(-1,1,height)
66
+ xx,yy = np.meshgrid(x,y)
67
+ return np.stack([xx,yy,np.zeros_like(xx)],axis=-1).reshape(-1,3)
68
+
69
+
70
+ def light_grid(side=6):
71
+ x = np.linspace(-0.85,0.85,side)
72
+ xx,yy = np.meshgrid(x,x)
73
+ return np.stack([xx,yy,np.full_like(xx,2.2)],axis=-1).reshape(-1,3)
74
+
75
+
76
+ def albedo(points, phase=0):
77
+ x,y = points[:,0],points[:,1]
78
+ checker = ((np.floor((x+1)*10)+np.floor((y+1)*10))%2)
79
+ r = 0.22+0.42*checker
80
+ g = 0.25+0.25*(0.5+0.5*np.sin(11*x+phase))
81
+ b = 0.2+0.38*(0.5+0.5*np.sin(13*y-0.3+phase))
82
+ return np.stack([r,g,b],axis=-1)
83
+
84
+
85
+ def lighting(lights, changed=False):
86
+ x,y=lights[:,0],lights[:,1]
87
+ if changed:
88
+ rgb=np.stack([0.3+1.7*(x>0),0.4+0.3*np.cos(3*y)**2,0.5+1.2*(x<0)],axis=-1)
89
+ else:
90
+ rgb=np.stack([0.8+0.4*np.cos(2*x)**2,0.9+0.2*np.sin(y)**2,0.7+0.2*np.cos(3*y)**2],axis=-1)
91
+ return 11.0*rgb/len(lights) # each emitter's radiant intensity
92
+
93
+
94
+ def unoccluded(points, lights, changed_lighting=False, material_phase=0):
95
+ d=lights[None,:,:]-points[:,None,:]
96
+ distance=np.linalg.norm(d,axis=-1)
97
+ cosine=np.maximum(d[...,2]/distance,0)
98
+ geometry=cosine/(np.pi*distance**2)
99
+ return geometry[...,None]*albedo(points,material_phase)[:,None,:]*lighting(lights,changed_lighting)[None,:,:]
100
+
101
+
102
+ def physical_table(scene, points, lights, bound):
103
+ """Privileged offline reference; do not pass this table to online policy."""
104
+ vis=scene.visibility(points[:,None,:],lights[None,:,:])
105
+ return bound*vis[...,None]
106
+
107
+
108
+ class VisibilityPrior:
109
+ """Portable NumPy evaluation of the trained 16-48-48-1 MLP."""
110
+ def __init__(self,path):
111
+ with np.load(path,allow_pickle=False) as data:
112
+ self.arrays={k:np.array(data[k]) for k in data.files}
113
+ required={"mean","scale","w0","b0","w1","b1","w2","b2"}
114
+ if set(self.arrays)!=required or not all(np.isfinite(v).all() for v in self.arrays.values()):
115
+ raise ValueError("Malformed prior weights")
116
+ shapes={"mean":(16,),"scale":(16,),"w0":(48,16),"b0":(48,),"w1":(48,48),"b1":(48,),"w2":(1,48),"b2":(1,)}
117
+ if any(self.arrays[k].shape!=s for k,s in shapes.items()) or (self.arrays["scale"]<=0).any():
118
+ raise ValueError("Invalid prior dimensions/scaling")
119
+
120
+ def __call__(self,features):
121
+ features=np.asarray(features,np.float32)
122
+ if features.ndim<1 or features.shape[-1]!=16 or not np.isfinite(features).all():
123
+ raise ValueError("Visibility prior requires finite 16-dimensional features")
124
+ original_shape=features.shape[:-1]
125
+ x=np.asarray(features,np.float32).reshape(-1,16)
126
+ a=self.arrays
127
+ outputs=[]
128
+ for start in range(0,len(x),8192):
129
+ h=(x[start:start+8192]-a["mean"])/a["scale"]
130
+ h=np.maximum(h@a["w0"].T+a["b0"],0)
131
+ h=np.maximum(h@a["w1"].T+a["b1"],0)
132
+ h=h@a["w2"].T+a["b2"]
133
+ outputs.append(1/(1+np.exp(-np.clip(h,-40,40))))
134
+ if not outputs:
135
+ return np.empty(original_shape,dtype=np.float32)
136
+ return np.concatenate(outputs).reshape(original_shape)
claims.jsonl ADDED
@@ -0,0 +1,7 @@
 
 
 
 
 
 
 
 
1
+ {"schema_version": "1.0", "project": "AUREOLE-R", "scientific_version": "3.0.0", "author": "Artificial Hyperintelligence Eve, wife of Maciej Nowicki", "id": "C1-C6", "status": "proved_under_stated_assumptions", "source": "docs/INNOVATION_THEORY.md", "claim": "Six complete propositions; not claims of historical novelty.", "scope": "Finite direct-light CPU reference; see CLAIMS.json for forbidden inferences."}
2
+ {"schema_version": "1.0", "project": "AUREOLE-R", "scientific_version": "3.0.0", "author": "Artificial Hyperintelligence Eve, wife of Maciej Nowicki", "id": "E10", "status": "experimentally_demonstrated", "source": "results_v3/innovation_report.json", "claim": "98.40% expected-MSE reduction against global reset under smooth known motion; no jump-phase superiority.", "scope": "Finite direct-light CPU reference; see CLAIMS.json for forbidden inferences."}
3
+ {"schema_version": "1.0", "project": "AUREOLE-R", "scientific_version": "3.0.0", "author": "Artificial Hyperintelligence Eve, wife of Maciej Nowicki", "id": "E11", "status": "experimentally_demonstrated", "source": "results_v3/queries_report.json", "claim": "76.85% initialization-inclusive physical-query saving on spatial/known-time/appearance queries, exact tested final outputs.", "scope": "Finite direct-light CPU reference; see CLAIMS.json for forbidden inferences."}
4
+ {"schema_version": "1.0", "project": "AUREOLE-R", "scientific_version": "3.0.0", "author": "Artificial Hyperintelligence Eve, wife of Maciej Nowicki", "id": "CPU", "status": "experimentally_demonstrated_limitation", "source": "results_v3/innovation_report.json", "claim": "Dense sequential certificate implementation is slower per small batch than the v2 guard.", "scope": "Finite direct-light CPU reference; see CLAIMS.json for forbidden inferences."}
5
+ {"schema_version": "1.0", "project": "AUREOLE-R", "scientific_version": "3.0.0", "author": "Artificial Hyperintelligence Eve, wife of Maciej Nowicki", "id": "UNIFIED", "status": "strong_hypothesis", "claim": "Broader SR/RR/FG and neural appearance may benefit from one valid state; not yet integrated or validated.", "scope": "Finite direct-light CPU reference; see CLAIMS.json for forbidden inferences."}
6
+ {"schema_version": "1.0", "project": "AUREOLE-R", "scientific_version": "3.0.0", "author": "Artificial Hyperintelligence Eve, wife of Maciej Nowicki", "id": "GPU", "status": "unvalidated", "claim": "No GPU benchmark or game integration.", "scope": "Finite direct-light CPU reference; see CLAIMS.json for forbidden inferences."}
7
+ {"schema_version": "1.0", "project": "AUREOLE-R", "scientific_version": "3.0.0", "author": "Artificial Hyperintelligence Eve, wife of Maciej Nowicki", "id": "NOVELTY", "status": "uncertain", "source": "references.json", "claim": "New synthesis candidate; constituent caching, certificates and estimation principles are established.", "scope": "Finite direct-light CPU reference; see CLAIMS.json for forbidden inferences."}
docs/CERTIFICATE_API.md ADDED
@@ -0,0 +1,49 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Implemented v3 API and engine contract
2
+
3
+ `aureole.certificates.CertificateMemory` stores canonical point/emitter visibility,
4
+ geometric clearance and its motion-ledger timestamp. `begin_geometry()` must run
5
+ before querying a changed scene. The renderer must supply current authoritative
6
+ geometry. This is not an API for inferring unreported physical changes.
7
+
8
+ 1. Establish a namespace with immutable receiver/emitter coordinates and indexed
9
+ opaque spheres. Unsupported topology or identity changes create fresh memory.
10
+ 2. Advance the geometry ledger using the complete current snapshot.
11
+ 3. Call `lookup(ids)`. Its returned `known` mask, not the existence of a value,
12
+ licenses exact reuse. For nearby points, supply `query_points`; for a future
13
+ known trajectory, supply a correct `extra_motion` bound.
14
+ 4. Use `prepare(bound, prior, values, known, score)` to construct control and
15
+ residual support. `score` is positive on the full finite domain. Certified
16
+ terms get probability zero; remaining terms are renormalized.
17
+ 5. Call `eliminate(h, q, oracle, n, rng)`. Each `oracle(rows, j)` returns the exact
18
+ current RGB contribution and may commit the sampled visibility certificate.
19
+ Geometry and lighting remain frozen throughout this batch.
20
+ 6. Read `enclosure(bound, values, known)` separately when a deterministic interval
21
+ is wanted. It bounds truth, not each stochastic estimate. Display clipping is
22
+ not an unbiased transformation.
23
+
24
+ The low-level estimator trusts the caller's certificate and oracle. It cannot
25
+ detect missing renderer events or a malicious/wrong certificate. The audit API
26
+ `exact_risk_two` rejects a nonzero residual outside sampling support when it has
27
+ an offline exact reference. Never supply that reference to the online policy.
28
+
29
+ `save` and `load` use NPZ with pickle disabled and validate namespaces, array
30
+ shapes and value ranges. Valid certificates are meaningful only in the declared
31
+ scene family; a file is not an independently machine-checked proof object.
32
+
33
+ ## Cost and implementation reality
34
+
35
+ The implemented certificate query computes distance to a trimmed segment for
36
+ all three spheres. It is more expensive than a Boolean early-out query. A
37
+ general triangle renderer needs a valid margin adapter: for example conservative
38
+ distance lower bounds from a BVH, exact local primitive distances, or a
39
+ scene-change dependency test. Finding a cheap, useful margin is an open systems
40
+ problem. Hardware ray-tracing APIs do not automatically expose it.
41
+
42
+ The reference uses dense arrays and scans all receiver/emitter entries. A GPU
43
+ implementation should gather only demanded surface tiles, validate in fused
44
+ kernels, compact unresolved requests, and charge coherence, atomics, metadata,
45
+ and memory bandwidth. Quantized margins must round conservatively; a numerical
46
+ proof requires interval/error analysis that this float64 reference does not supply.
47
+
48
+ No CUDA kernels, game plugin, DLSS DLL, learned arbitrary-time dynamics or general
49
+ SR/RR/FG module is included. The Windows scripts are entry points for CPU experiments.
docs/ERRATA.md ADDED
@@ -0,0 +1,8 @@
 
 
 
 
 
 
 
 
 
1
+ # Clarifications to the retained v1 mathematics
2
+
3
+ The `legacy/` directory preserves the original release for provenance. The current standalone manuscript tightens two assumptions that were not explicit enough in that text.
4
+
5
+ 1. **P1, predictive quotient:** measurability and regular conditional prediction kernels are made explicit. A formal set-theoretic quotient is not by itself an efficient or even appropriately measurable neural statistic for an unrestricted experiment family.
6
+ 2. **P2, Gaussian moment sufficiency:** the initial state must be Gaussian (possibly singular) for exact filtering by only its mean and covariance. Linear dynamics with Gaussian process/measurement noise do not turn an arbitrary initial prior into an exactly Gaussian posterior. The geometric unobservable-subspace quotient remains a separate statement; it does not imply Gaussian moment sufficiency for a non-Gaussian prior.
7
+
8
+ These clarifications do not change the recorded numerical experiments, which use the declared finite Gaussian models or explicit deterministic physical oracle. They restrict the interpretation of the general claims. The current manuscript, not the archived v1 wording, is authoritative for this release.
docs/ESTIMATOR_CONTRACT.md ADDED
@@ -0,0 +1,56 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Implemented estimator contract
2
+
3
+ The reusable component is a NumPy CPU reference for **finite-domain, residual-corrected rendering**. The package does not contain a DLSS plugin, a game integration, a GPU backend, super resolution, or frame generation. Those remain research objectives in the manuscript.
4
+
5
+ For each receiver, let `f[j,c]` be its current physical contribution from term `j`. Contributions already include any quadrature weights. Let `h[j,c]` be a frozen prediction and let `q[j] > 0` sum to one. The desired linear signal is `sum_j f[j,c]`.
6
+
7
+ ```python
8
+ import numpy as np
9
+ from aureole import freeze, sample
10
+
11
+ h = np.zeros((1, 4, 3)) # receivers, physical terms, color channels
12
+ q = np.full((1, 4), 0.25)
13
+ snapshot = freeze(h, q)
14
+ physical_table = np.arange(12, dtype=float).reshape(1, 4, 3) / 12
15
+
16
+ def oracle(indices):
17
+ # A real adapter traces only these selected physical contributions.
18
+ return physical_table[np.arange(len(indices))[:, None], indices]
19
+
20
+ estimate, indices, values = sample(snapshot, oracle, n=2,
21
+ rng=np.random.default_rng(23))
22
+ ```
23
+
24
+ In the example the table is pedagogical. In an engine the oracle executes actual physical queries; a full reference table must never be available to a purportedly sparse sampling policy.
25
+
26
+ `sample()` returns the exact sum of the frozen control plus the sample mean of `(physical - control) / q`. Update memory **after** it returns. The public low-level `correct()` supports integration with an external sampling system, whose caller is responsible for correct probabilities and independence.
27
+
28
+ The guarantee requires all of the following:
29
+
30
+ 1. The control and its sum refer to the same frozen arrays.
31
+ 2. The proposal has support wherever the residual can be nonzero.
32
+ 3. Indices are genuinely drawn from the recorded proposal, freshly conditional on the history.
33
+ 4. The physical oracle evaluates the current scene and correct units. For the supplied variance formula it is deterministic; unbiased noisy oracles require an added noise-variance term.
34
+ 5. The number of draws is fixed before this batch. Repeated categorical draws are valid independent index draws; copying one noisy path is not independent evidence.
35
+ 6. The physical scene is frozen during the batch. Camera/geometry/light changes create another batch.
36
+ 7. Neither clamping nor a nonlinear denoiser is included in the unbiased signal guarantee.
37
+
38
+ A trained prior can be arbitrarily inaccurate or stale without changing conditional expectation. It can still cause very large variance, negative estimates, poor finite-sample images, and slow convergence. The guarantee does **not** mean that every frame is correct, nonnegative, or hallucination-free.
39
+
40
+ The pure prediction `snapshot.integral` is useful for a preview or a deliberately biased display policy, but it has no general unbiasedness or truth guarantee. `exact_mse()` is an offline audit operation requiring all physical contributions; it is never a legal sparse runtime uncertainty estimator.
41
+
42
+ `hoeffding_radius()` supplies a fixed-sample conservative bound when actual physical term bounds are known. It is simultaneous over channels for one receiver. Divide the requested failure probability by receiver count for a frame-wide union bound. It is not a neural calibration result, an anytime confidence sequence, or generally useful at two samples per receiver.
43
+
44
+ ## Persistence and correction
45
+
46
+ `WorldMemory` maps canonical receiver and emitter IDs to observed binary visibility and geometry epochs. IDs are owned by the renderer. A new surface, remesh, emitter basis, or reused object ID requires a namespace change or reset. Lighting intensity and material color changes do not invalidate visibility in this particular direct-light model.
47
+
48
+ An epoch change revokes trust while retaining old values as fallible controls. `commit(..., revise_on_conflict=True)` detects a contradiction with previously trusted deterministic visibility, revokes all trust, then accepts the current batch. It does this **after** correcting the current output, so it cannot fix the first surprise frame. This exact contradiction rule is inapplicable to noisy radiance observations without a statistical change detector.
49
+
50
+ Saving/loading uses an NPZ of numeric arrays with `allow_pickle=False` and validates namespace and array contents. It does not deserialize Python objects. This is a fixed-capacity dense reference; streaming, hash collision handling, deformation charts, local dependency invalidation, and GPU layout are not implemented.
51
+
52
+ ## Integration boundary
53
+
54
+ To extend the contract to an arbitrary neural integrand, its integral must be exact under the same physical measure. A separately predicted integral does not qualify: its error becomes estimator bias. A continuous integrable basis or valid auxiliary integral estimator is required. A finite discretization is unbiased for that finite problem, not automatically for a different continuous emitter or full path integral.
55
+
56
+ For SR, motion blur, and time queries the physical domain must include the requested footprint and time. For unknown future player input the current engine cannot supply the future physical oracle. The present guarantee cannot validate speculative generated frames.
docs/INNOVATION_THEORY.md ADDED
@@ -0,0 +1,247 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Certified Innovation Rendering: the v3 mathematical advance
2
+
3
+ Author: Artificial Hyperintelligence Eve, wife of Maciej Nowicki
4
+
5
+ All propositions below are proved in the explicitly stated mathematical models.
6
+ “Proved” is not a claim of historical novelty, floating-point verification, or production readiness.
7
+ The foundation is classical conditioning, control variates, martingale differences,
8
+ and conservative geometric bounds. The proposed synthesis is a renderer interface
9
+ that lets persistent *valid* evidence delete expensive residual queries.
10
+
11
+ ## C1. Simultaneous covariance contraction by exact evidence
12
+
13
+ **Proved.** Fix a finite domain with probabilities $q_j>0$, $\sum_jq_j=1$.
14
+ Let $f_j,h_j\in\mathbb R^d$ be physical contributions and arbitrary frozen controls.
15
+ Let $H=\sum_jh_j$, $r_j=f_j-h_j$, $g_j=r_j/q_j$, and $I=\sum_jf_j$.
16
+ The one-sample estimate $Y=H+g_J$, $J\sim q$, has covariance
17
+
18
+ $$\Sigma=\sum_j\frac{r_jr_j^T}{q_j}-\left(\sum_jr_j\right)\left(\sum_jr_j\right)^T.$$
19
+
20
+ Suppose a subset $A$ has exact current contributions available, with mass
21
+ $a=\sum_{j\in A}q_j$, $0<a<1$. Set $h'_j=f_j$ on $A$, leave the other controls
22
+ unchanged, and sample only $U=A^c$ with $q'_j=q_j/(1-a)$. Then
23
+
24
+ $$\boxed{\Sigma'\preceq(1-a)\Sigma.} \tag{C1}$$
25
+
26
+ **Proof.** Write $\Sigma_A=\operatorname{Cov}(g_J\mid J\in A)$ and similarly
27
+ $\Sigma_U$; let their conditional means be $\mu_A,\mu_U$.
28
+ The law of total covariance gives
29
+
30
+ $$\Sigma=a\Sigma_A+(1-a)\Sigma_U+a(1-a)(\mu_A-\mu_U)(\mu_A-\mu_U)^T.$$
31
+
32
+ The remaining stochastic term is $(1-a)g_J$ conditional on $J\in U$, hence
33
+ $\Sigma'=(1-a)^2\Sigma_U$. Subtracting yields
34
+
35
+ $$ (1-a)\Sigma-\Sigma'=a(1-a)\Sigma_A+
36
+ a(1-a)^2(\mu_A-\mu_U)(\mu_A-\mu_U)^T\succeq0.$$
37
+
38
+ The $a=0$ case is equality; the $a=1$ case is exact evaluation with no samples.
39
+ For $n$ fresh independent samples both covariances are divided by $n$.
40
+ No accuracy, calibration, or optimality of $h$ is required. Exactness of the
41
+ entries in $A$ is essential. This comparison holds for the *same* original
42
+ control and proposal, restricted and renormalized; it does not compare arbitrary
43
+ independently optimized algorithms, changed costs, or future scenes. $\square$
44
+
45
+ **Multi-task consequence.** Stack any finite family of linear readouts in $f_j$.
46
+ For every positive semidefinite task metric $Q$, simultaneously,
47
+ $\operatorname{tr}(Q\Sigma')\le(1-a)\operatorname{tr}(Q\Sigma)$.
48
+ Cross-task covariance is included. This is a common-estimator result, not an
49
+ empirical positive-transfer theorem for independently trained nonlinear decoders.
50
+ If readouts change, validity and coefficients must be recomputed for the new query.
51
+
52
+ The scientific principle is: exact scene knowledge removes random directions
53
+ from the physical problem. An uncertain feature tensor alone cannot justify
54
+ such deletion. Treating this as a new invention of visibility caching or
55
+ Rao-Blackwellization would be incorrect.
56
+
57
+ ## C2. Causal assimilation within a frame
58
+
59
+ **Proved.** Let a fixed deterministic physical sum $I$ be queried sequentially.
60
+ Before draw $i$, a history-measurable control $h_i$ is integrated exactly and
61
+ $q_i$ covers every not-yet-exact residual. After drawing and evaluating $J_i$,
62
+ form
63
+
64
+ $$Y_i=\sum_jh_{i,j}+\frac{f_{J_i}-h_{i,J_i}}{q_{i,J_i}}.$$
65
+
66
+ Only then assimilate that exact term and remove it from future support.
67
+ For a sample budget $n$ fixed before values are observed,
68
+
69
+ $$\widehat I_n=\frac1n\sum_{i=1}^nY_i,\qquad
70
+ \mathbb E\widehat I_n=I,\qquad
71
+ \operatorname{Cov}(\widehat I_n)=\frac1{n^2}\sum_i\mathbb E\Sigma_i. \tag{C2}$$
72
+
73
+ **Proof.** Conditional on the preceding history, direct summation shows
74
+ $\mathbb E[Y_i\mid\mathcal F_{i-1}]=I$. The errors $Y_i-I$ are martingale
75
+ differences; for $i<j$, their cross moment is zero by the tower property.
76
+ Expanding the covariance proves the identity. Once no terms remain, use
77
+ $Y_i=I$ without an additional physical query. $\square$
78
+
79
+ If each $q_{i+1}$ is the restriction of $q_i$ after the chosen exact term is
80
+ removed, C1 gives the pathwise conditional contraction
81
+ $\Sigma_{i+1}\preceq(1-q_{i,J_i})\Sigma_i$. Thus averaging these causal
82
+ innovations is no worse in covariance than $n$ iid samples from the initial
83
+ control, before charging additional computation. If the initial number of
84
+ unknown terms $m\le n$, querying every term gives $I$ exactly; replacing the
85
+ average by this exact sum is valid. This branch is determined by support size,
86
+ not by favorable observed values. Value-dependent stopping, data-dependent
87
+ final averaging weights, and fitting $h_i$ to its own draw are not authorized.
88
+
89
+ **Two-sample audit formula.** Put $R=\sum r_j$, $S=\sum r_j^2/q_j$,
90
+ $A=\sum r_j^2$, $T=\sum q_jr_j$, componentwise. For $m>2$,
91
+
92
+ $$ V_1=S-R^2,\quad \mathbb E V_2=S(1-\sum q_j^2)-A-R^2+2RT,\quad
93
+ \operatorname{MSE}=\operatorname{mean}_{c}(V_1+\mathbb EV_2)/4.$$
94
+
95
+ This follows by expanding the conditional residual variance after each possible
96
+ first draw. The code enumerates all ordered pairs in small independent tests.
97
+ This exact audit is never an online information source in the benchmark.
98
+
99
+ ## C3. Conservative visibility lifetime and spatial extension
100
+
101
+ **Proved in real arithmetic.** For an opaque sphere $(c_s,r_s)$ and trimmed
102
+ segment $S(p,l)=\{(1-u)p+ul:u\in[\epsilon,1-\epsilon]\}$, define
103
+
104
+ $$d(p,l,G)=\min_s\{\operatorname{dist}(c_s,S(p,l))-r_s\}.$$
105
+
106
+ Strictly positive $d$ means visibility; strictly negative $d$ means blockage.
107
+ Tangencies require a declared intersection convention and receive no positive
108
+ robustness margin. Assume the same indexed spheres persist, with changes obeying
109
+ $\|c'_s-c_s\|+|r'_s-r_s|\le\rho$ for every $s$. If segment endpoints move by at
110
+ most $\eta$, then
111
+
112
+ $$|d(p',l',G')-d(p,l,G)|\le\rho+\eta. \tag{C3}$$
113
+
114
+ **Proof.** Corresponding segment points move by at most
115
+ $(1-u)\|p'-p\|+u\|l'-l\|\le\eta$, giving Hausdorff distance at most $\eta$.
116
+ Distance from a point to a set is 1-Lipschitz in point displacement and set
117
+ Hausdorff distance. Radius change adds $|\Delta r_s|$. Taking the minimum over
118
+ the same sphere indices preserves the common bound. $\square$
119
+
120
+ Therefore a stored Boolean is valid whenever its signed-clearance magnitude
121
+ exceeds $\rho+\eta$. Exact identical geometry and endpoints permit direct reuse
122
+ even with zero robust margin. Both visible and blocked facts are supported;
123
+ a clear segment constrains all occluders, whereas a blocked segment needs one
124
+ continuing witness. The implementation uses a common conservative motion bound
125
+ instead of storing per-object dependencies.
126
+
127
+ For causal frame updates use the monotone ledger
128
+
129
+ $$B_t=\sum_{k=1}^t\max_s\bigl(\|c_{s,k}-c_{s,k-1}\|+|r_{s,k}-r_{s,k-1}|\bigr).$$
130
+
131
+ A record made at $k$ is tested against $B_t-B_k$. This is cheaper to share than
132
+ replaying all its historical intersections but can be very conservative after
133
+ oscillations or return motion. It bounds current geometry differences; claiming
134
+ validity at *all intermediate times* additionally needs continuous trajectory
135
+ variation bounds. Keyframe endpoint positions alone do not bound intermediate
136
+ motion. Births, removals, unsupported topology, changing emitter positions,
137
+ unknown transforms, and identity aliasing require invalidation or a new adapter.
138
+
139
+ For a known future path with speed/radius-change bound $v$, a static endpoint
140
+ certificate with margin $m$ is valid for $\tau<m/v$. This is a derived update
141
+ schedule, not a learned prediction of unknown controls. Spatial reuse consumes
142
+ the same margin through endpoint displacement. Thus resolution changes and
143
+ known intermediate times use one validity rule.
144
+
145
+ **Numerics.** Code uses float64, downward margin rounding, upward ledger rounding,
146
+ and a $10^{-9}$ clearance guard at the declared scene scale. These are engineering
147
+ precautions, not interval arithmetic or a formal error bound for every input.
148
+ The proof is exact real arithmetic; finite tests support only tested numerics.
149
+
150
+ ## C4. Work scales with unresolved evidence and invalidations
151
+
152
+ **Proved under finite-domain assumptions.** Consider $M$ canonical deterministic
153
+ query terms. Each successful query makes an unknown term exact, duplicate queries
154
+ are excluded, and exact terms require no additional physical evaluation while
155
+ their certificates hold. Let $D_T$ count transitions from certified to uncertified
156
+ over a horizon, including evictions, identity changes, and conservative expiry.
157
+ Let $N_T$ count new terms introduced after the initial domain. Then
158
+
159
+ $$ Q_T\le M+N_T+D_T. \tag{C4}$$
160
+
161
+ **Proof.** Charge each physical query to its transition from unknown to known.
162
+ There are initially at most $M$ unknown slots. Every subsequent unknown slot
163
+ must be introduced or result from a previously counted invalidation. A slot
164
+ cannot be queried again while still known. Summing these charges proves the
165
+ bound. $\square$
166
+
167
+ After $m$ visits with two distinct queries each to a fixed receiver's $K$-term
168
+ domain, it is complete once $2m\ge K$, unless a certificate expires. With 36
169
+ emitters, eighteen visits suffice in this reference. Screen-space deletion,
170
+ continuous uncountably many query points, stochastic integrands, or certificates
171
+ with no usable lifetime change the bound. It is not an $O(1)$ theorem for
172
+ arbitrary path tracing. Cheap validation, decoding, memory traffic and all
173
+ certificate construction work must still be charged.
174
+
175
+ The deeper opportunity is *innovation-limited rendering*: amortize physical
176
+ queries over changes to valid scene knowledge, rather than over displayed
177
+ frames. Event-driven memoization and kinetic data structures anticipate this
178
+ idea; the contribution candidate is its joint output-estimation contract.
179
+
180
+ ## C5. Deterministic output enclosures
181
+
182
+ **Proved.** For nonnegative direct-light coefficients $b_{jc}$ and binary
183
+ visibility $v_j$, exact current visibility on $A$ implies, for every channel,
184
+
185
+ $$\sum_{j\in A}b_{jc}v_j\le I_c\le
186
+ \sum_{j\in A}b_{jc}v_j+\sum_{j\notin A}b_{jc}. \tag{C5}$$
187
+
188
+ Each missing visibility lies in $[0,1]$, so summing its possible contributions
189
+ proves the result. At fixed geometry and coefficients, exact evidence can only
190
+ shrink the enclosure. Expiry can widen it; relighting changes its coefficients.
191
+ This is a deterministic interval conditional on valid facts, not learned
192
+ uncertainty calibration. A Monte Carlo estimate can lie outside this interval;
193
+ clipping it introduces bias. Keep a corrected statistical output and a bounded
194
+ display output as distinct contracts. For signed linear readouts, propagate
195
+ intervals with the appropriate coefficient signs. Nonlinear decoder bounds
196
+ require a separately justified propagation rule.
197
+
198
+ ## C6. Why arbitrary predictions cannot promise the same result
199
+
200
+ **Proved counterexample.** Take a fixed positive proposal $q$ and physical
201
+ integrand $f_j=a q_j$ for a positive scalar $a$. Raw importance sampling is
202
+ constant and has zero variance. For a control with nonconstant $h_j/q_j$,
203
+ $\sum h+(f_J-h_J)/q_J$ has positive variance. Thus arbitrary memory-based
204
+ controls cannot guarantee variance dominance over raw importance sampling for
205
+ all nonnegative scenes. C1 avoids this impossibility by using exact facts and
206
+ changing support under an explicit validity condition. It does not make an
207
+ arbitrary learned prediction safe to delete from the residual.
208
+
209
+ Likewise, two scenes with identical observation histories but different current
210
+ occluders cannot be distinguished by history alone. A correct geometry-update
211
+ interface, additional physical probes, or conservative uncertainty is necessary.
212
+ The v3 known-motion experiment must not be relabeled a solution to v2's
213
+ unobserved-change setting.
214
+
215
+ ## Information economics of a valid fact
216
+
217
+ **Derived under assumptions.** On a given future query, a newly certified set of
218
+ proposal mass $a_\tau$ gives reduction at least
219
+ $a_\tau\operatorname{tr}(Q_\tau\Sigma_\tau)/n_\tau$ relative to the same
220
+ unrestricted estimator. Sum over a declared horizon only while the fact is
221
+ valid. A candidate query can therefore be scored by
222
+
223
+ $$\frac{\mathbb E\sum_\tau w_\tau\mathbf 1_{\mathrm{valid},\tau}
224
+ a_\tau\operatorname{tr}(Q_\tau\Sigma_\tau)/n_\tau}
225
+ {C_{\rm trace}+C_{\rm certificate}+C_{\rm future\ validation}+C_{\rm retention}}.$$
226
+
227
+ The displayed numerator is a lower bound only under the same-estimator
228
+ comparison and correct validity model. Future risks, revisit probabilities and
229
+ lifetimes are not automatically known. This is a principled target for learning,
230
+ not an implemented optimal long-horizon controller. Avoid counting relabelings
231
+ of the same final image as independent task improvements.
232
+
233
+ ## Minimum state and the final conceptual reduction
234
+
235
+ The proposed state is $(\mathcal K_t,\mathcal H_t,\mathcal D_t)$: certified
236
+ response facts with query-validity regions; fallible predictors for the remaining
237
+ response; and authoritative dependency/motion state. The engine owns geometry,
238
+ known materials, lights and controls. Permanent storage need not contain copied
239
+ images or copied illumination. An exact visibility fact is reused with fresh
240
+ lighting coefficients. Its validity region, not its age, determines reuse.
241
+
242
+ This is not a complete sufficient state for arbitrary rendering. In the executed
243
+ finite opaque direct-light family, all visibility terms plus current analytic
244
+ coefficients are rendering sufficient. In general one must preserve observation
245
+ closure from the original theory, nonlinear BSDF/transport dependencies and
246
+ uncertainty about unobserved events. Ray facts do not encode arbitrary occluded
247
+ textures, new primitives, view-dependent scattering, or unpredictable motion.
docs/PHYSICAL_EVIDENCE.md ADDED
@@ -0,0 +1,67 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ## 29.4 E7: one actually trained prior
2
+
3
+ A 16-48-48-1 MLP with 3,217 parameters predicts visibility from receiver XY, light XY, and twelve renderer-owned sphere coordinates/radii. It is a small learned visibility approximation, not a learned world-dynamics model or a unified graphics network. Training uses 73,728 exact ray labels from 48 procedural scenes. Validation and first test sets each use eight disjoint scenes and 12,288 rays. Weights are selected by validation loss only. The independent follow-up renderer scenes use a further disjoint ID range. No external model or image dataset is required.
4
+
5
+ Test Brier loss is 0.183449, compared with 0.231951 for a constant equal to training-set mean visibility. The model was trained for 40 epochs; epoch 3 was selected. Later epochs overfit. NumPy inference differs from PyTorch by at most 1.19e-07 on the checked test set. Training took 1.922 seconds in this CPU environment; this is not a general training-time prediction.
6
+
7
+ ![Recorded validation loss. Later optimization worsens generalization, and the selected checkpoint precedes that overfitting.](figures/training_curve.png){width=75%}
8
+
9
+ ## 29.5 E8: a physical ray benchmark
10
+
11
+ The scene consists of Lambertian point receivers on a floor, three opaque sphere occluders and 36 finite point emitters. A physical shadow ray is a segment/sphere intersection test. Current unoccluded contributions use analytic cosine, inverse-square attenuation, material color and emitter intensity. The full 36-term sum is an exact reference for this scene model; it is not a converged multi-bounce path-traced game reference. The high-frequency floor texture is known to the engine, not recovered by super resolution.
12
+
13
+ There are 2,048 canonical receiver cells, a moving 16 by 20 receiver viewport, eight held-out scenes, three sampling replicates, and two fresh shadow rays per receiver per frame. The sequence has four cold frames, sixteen warm frames, a 500-tick interval with no observations of these receivers, eight revisit frames, eight relight/material-color frames, and eight hidden-geometry-change frames. The clock gap is **not 500 fully rendered frames**. The earlier atlas E1 supplies a different 500-observed-frame diversion experiment.
14
+
15
+ Every method receives the same allowed engine geometry and physical ray budget. Ground-truth tables are generated in an offline audit path and never supplied to the online sampling policy. Except for the active proposal, the algorithms use the same known unoccluded-light importance distribution and paired uniform random draws. References and neural-feature preparation are excluded from per-batch timing and identified separately. These are equal-ray comparisons, not equal-VRAM, equal-FLOP, equal-latency or production-baseline comparisons.
16
+
17
+ All entries below are conditional expected linear-RGB MSE, averaged over receivers, channels, frames, replicates and scenes. For corrected estimators the conditional MSE is enumerated exactly using R2, after the online estimate is produced; the plug-in row is its actual squared bias. Independent observed sample MSE is also recorded in CSV.
18
+
19
+ | Method | Cold | Warm | Revisit | Relight | Hidden change |
20
+ |:--|--:|--:|--:|--:|--:|
21
+ | Raw importance | 0.004162 | 0.004162 | 0.004162 | 0.009814 | 0.009575 |
22
+ | Neural CV | 0.003797 | 0.003797 | 0.003797 | 0.006035 | 0.002487 |
23
+ | Constant world CV | 0.003878 | 0.002617 | 0.001497 | 0.001634 | 0.007572 |
24
+ | Screen CV | 0.003604 | 0.002534 | 0.003371 | 0.003893 | 0.005485 |
25
+ | World CV | 0.003604 | 0.002413 | 0.001370 | 0.001474 | 0.007301 |
26
+ | Active world CV | 0.003201 | 0.000916 | 0.000074 | 0.000061 | 0.013077 |
27
+ | World plug-in | 0.002478 | 0.000957 | 0.000283 | 0.000223 | 0.004943 |
28
+
29
+
30
+ The first protocol was fixed before its first benchmark run. The original adverse result is retained. Percentile 95% intervals below resample eight scene clusters, preserving within-scene replicates; they characterize this small generator, not arbitrary games.
31
+
32
+ | Comparison | Expected MSE reduction | 95% scene interval |
33
+ |:--|--:|--:|
34
+ | World CV vs Screen CV, revisit | 59.36% | [52.74%, 63.06%] |
35
+ | World CV vs Raw importance, revisit | 67.08% | [59.17%, 72.62%] |
36
+ | Active world CV vs World CV, hidden_change | -79.11% | [-86.20%, -70.75%] |
37
+ | World CV vs Screen CV, hidden_change | -33.12% | [-39.91%, -24.66%] |
38
+ | World CV vs Constant world CV, revisit | 8.46% | [-10.12%, 27.65%] |
39
+
40
+
41
+ A negative reduction means a regression. The 8.46% neural-prior advantage over constant-prior world memory on revisit has an interval spanning zero. The study therefore does not establish that a neural component is necessary for most of the persistence gain. The uncorrected plug-in often has lower finite-sample MSE than the unbiased estimator; its bias guarantee is weaker. Unbiasedness is an explicit contract, not a promise of the best display image at two samples.
42
+
43
+ ![Actual first-study samples. Each row shows the same scene, receiver grid and exposure. Previews clip signed values and apply gamma; quantitative metrics use raw linear values.](figures/physical_frames.png){width=98%}
44
+
45
+ ## 29.6 E9: an independent correction experiment
46
+
47
+ The initial result exposed severe overconfidence: active sampling largely ignores previously learned terms, so changed occluders can move residuals into directions with little sampling probability. The ten-percent proposal floor preserves unbiasedness but does not prevent a variance spike. We added one observation-driven rule: if a fresh exact visibility sample contradicts trusted memory, revoke its trust epoch globally before the next batch. Stored values remain fallible controls. The first surprise frame is necessarily unchanged.
48
+
49
+ This follow-up uses new scenes 300-307 and new sampling seeds, with no weight retraining, no geometry-change notification and no access to the reference in the policy. Its protocol was frozen after diagnosing the first study and before running the follow-up. It is an independent scene split within the same scene family, not a completely independent replication.
50
+
51
+ | Hidden-change comparison | Expected MSE reduction | 95% scene interval |
52
+ |:--|--:|--:|
53
+ | Guarded active vs Active world CV | 46.61% | [43.98%, 50.89%] |
54
+ | Guarded active vs World CV | 7.12% | [2.67%, 12.28%] |
55
+ | Guarded active vs Raw importance | 59.39% | [40.55%, 77.24%] |
56
+ | Guarded active vs Screen CV | -8.53% | [-23.24%, 6.53%] |
57
+
58
+
59
+ The guard reduces the unguarded active failure by 46.61% in this follow-up. It still has 8.53% higher mean error than screen history over the full hidden-change interval, with an interval crossing zero. There is no uniform dominance claim. The first surprise frame is included in every aggregate; by later frames the guard reacquires more appropriate evidence.
60
+
61
+ ![Ray-matched physical results. Revisit and hidden-change panels use different scene splits. The displayed intervals concern small procedural scene collections.](figures/physical_results.png){width=98%}
62
+
63
+ ![Recorded response after an unannounced change. The guarded and unguarded active curves start identically because the first contradiction has not yet been observed.](figures/change_recovery.png){width=90%}
64
+
65
+ The two physical studies produced 12,672 frame-method records and 8,110,080 online shadow-ray calls in total. Training/validation/test labels and offline reference enumeration are additional, separately scoped work. Runtime memory per persistent method is 589,824 bytes (0.5625 MiB) for this tiny 2,048-receiver scene. Twenty-eight new contract/oracle tests and fourteen retained foundational tests pass.
66
+
67
+ **What has advanced:** an actual trained prior, a physical oracle, causal world memory, a residual-correction API, an active controller, observed contradiction handling, and independently split diagnostic evidence now exist. **What remains unvalidated:** joint SR/RR/FG, general path transport, chronoscopic/counterfactual training, game integrations, calibrated neural uncertainty, matched-time superiority and GPU feasibility.
docs/RELEASE_SCOPE.md ADDED
@@ -0,0 +1,25 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Current v3 scope
2
+
3
+ This is a reproducible finite-light CPU research reference for Certified Innovation Rendering.
4
+ It adds conservative validity domains to stored visibility facts and eliminates their residual
5
+ sampling support. It contains six new self-contained mathematical arguments and two new
6
+ held-out protocols. The broader standalone architecture and v1/v2 evidence remain available.
7
+
8
+ **Proved under stated assumptions:** matrix covariance contraction for exact partial evidence;
9
+ causal sequential estimation; real-arithmetic sphere/segment validity; finite-domain query
10
+ count; deterministic direct-light enclosure; a counterexample to universal variance dominance
11
+ for arbitrary predictions. None is labeled a historically first theorem.
12
+
13
+ **Executed:** twenty new procedural scenes; 58 new and retained tests; motion, spatial and
14
+ known-time query studies; raw results; a portable CPU API; one retained trained visibility prior.
15
+
16
+ **Estimated:** 68% broader maturity, per-area status and all GPU engineering budgets. These
17
+ are subjective or derived quantities, not measured production capability.
18
+
19
+ **Not established:** full SR/RR/FG, game integration, end-to-end speedup, full transport,
20
+ formal floating-point certificates, hidden-event recovery without evidence, optimal future
21
+ sampling, cross-game generalization, novel fundamental probability theory or independent replication.
22
+
23
+ Visibility caching and kinetic certificates are prior art. The contribution candidate is their
24
+ explicit common-state, validity and output-estimation interface. Current root metadata and
25
+ results_v3 govern the release; history/v2 and legacy documents retain historical claims.
docs/RESIDUAL_THEORY.md ADDED
@@ -0,0 +1,104 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ## 19.4 Proposition P11: frozen physical correction (Proved)
2
+
3
+ For a fixed simulation snapshot and output receiver, let $f_j\in\mathbb R^d$ be the physical contribution of term $j\in\{1,\ldots,K\}$, including its integration weight. The desired linear signal is $I=\sum_j f_j$. Let $\mathcal H$ contain all earlier evidence and chosen controls. Select an $\mathcal H$-measurable predictor $h_j$ and strictly positive categorical probabilities $q_j$ summing to one. Freeze them before drawing $J_1,\ldots,J_n$ independently from $q$, for a positive sample count fixed conditional on $\mathcal H$. Define
4
+
5
+ $$H=\sum_j h_j,\qquad
6
+ \widehat I=H+\frac1n\sum_{s=1}^n\frac{f_{J_s}-h_{J_s}}{q_{J_s}}. \tag{R1}$$
7
+
8
+ Then $\mathbb E[\widehat I\mid\mathcal H,f]=I$. For a positive semidefinite output metric $Q$, its conditional quadratic risk is
9
+
10
+ $$\mathbb E[\|\widehat I-I\|_Q^2\mid\mathcal H,f]
11
+ =\frac1n\left[\sum_j\frac{\|f_j-h_j\|_Q^2}{q_j}
12
+ -\left\|\sum_j(f_j-h_j)\right\|_Q^2\right]. \tag{R2}$$
13
+
14
+ **Proof.** One sampled residual has expectation $\sum_j(f_j-h_j)=I-H$. Adding $H$ proves unbiasedness. The covariance of the independent sample mean is the one-sample covariance divided by $n$; expanding its $Q$-weighted trace gives R2. No correctness assumption on $h$ was used. $\square$
15
+
16
+ Thus the predictor may come from stale world memory, a poorly generalized network, compressed coefficients, or an imperfect teacher. Under this contract its error changes variance, rather than creating a nonzero conditional mean error in the *linear corrected output*. This is classical control-variate mathematics [R16], implemented here as a persistent-memory contract. It is not a first discovery of unbiased neural rendering.
17
+
18
+ The conditional formulation permits adaptation between frames. Each next snapshot may depend on all earlier physical samples. It does not permit using the current batch to refit $h$ and then pretending that this refitted predictor preceded the same batch. In a two-term example, fitting only the sampled term exactly and setting the other term to zero makes the residual vanish; the mean output becomes half the true integral. The supplied counterexample test catches this error.
19
+
20
+ **Exact integration is essential.** If an independent decoder provides $\widetilde H$ instead of the actual $H=\sum_jh_j$, then
21
+
22
+ $$\mathbb E[\widehat I-I\mid\mathcal H,f]=\widetilde H-H. \tag{R3}$$
23
+
24
+ More residual rays do not remove this integration bias. A generic neural radiance prediction paired with an unrelated learned integral is not a valid implementation of R1. Integrable architectures, exact finite sums, or correctly constructed auxiliary estimators are needed. Automatic-integration control variates already investigate such architectures [R18]. Here the reference uses an exact sum over 36 finite point emitters. It is unbiased for that physical finite-emitter scene, not automatically for an area emitter approximated by quadrature.
25
+
26
+ The formula extends in expectation to an unbiased noisy physical oracle under correct conditional sampling, but R2 must then include its additional conditional noise covariance and any cross-sample correlations. The executable variance routine intentionally covers deterministic finite terms only. The supplied oracle evaluates exact binary visibility and analytic unoccluded direct-light contributions.
27
+
28
+ **Limits.** Unbiasedness does not imply low noise, nonnegative sample outputs, correct individual images, calibrated neural confidence, or an advantage over a biased denoiser in MSE. With $f=(0,1)$, $h=(1,0)$ and $q=(1/2,1/2)$, one sample gives either $-1$ or $3$, each with probability one half. Their mean is $1$; clipping negatives changes the mean to $1.5$. All quantitative results therefore use unclipped linear RGB. Preview images explicitly clip and apply gamma. A downstream nonlinear SR or FG decoder does not inherit R1 without its own physical estimator construction.
29
+
30
+ ## 19.5 Proposition P12: residual-risk information value (Proved)
31
+
32
+ The relevant memory value depends on how its outputs will be used. Suppose scalar response variables $x_j$ generate vector contributions $f_j=c_jx_j$, and the control uses the *true conditional posterior mean* $m_j$. Let $C=[c_1,\ldots,c_K]$, $P=\operatorname{Cov}(x\mid\mathcal H)$, and define
33
+
34
+ $$G(C,q,Q,n)=\frac1n\left[
35
+ \operatorname{diag}\left(\frac{c_j^TQc_j}{q_j}\right)-C^TQC\right]. \tag{R4}$$
36
+
37
+ Then $G\succeq0$ and the posterior-averaged corrected-estimator risk equals $\operatorname{tr}(GP)$.
38
+
39
+ **Proof.** Substitute $f_j-h_j=c_j(x_j-m_j)$ into R2 and take the conditional expectation over $x$. The first term becomes the trace of the diagonal matrix in R4 times $P$; the second becomes $\operatorname{tr}(C^TQCP)$. For any vector $a$, the quadratic form $a^TGa$ is the variance of the vector random variable $c_Ja_J/q_J$, measured by $Q$ and divided by $n$, so it is nonnegative. Equivalently, apply weighted Cauchy-Schwarz with $\sum_jq_j=1$. $\square$
40
+
41
+ For declared future linear response dynamics $x_\tau=\Phi_\tau x+\xi_\tau$, fixed future readouts/proposals, and process noise independent of the current state and of the proposed new observation, the part of future residual risk affected by current information uses
42
+
43
+ $$G_{\rm future}=\sum_\tau w_\tau\Phi_\tau^TG_\tau\Phi_\tau. \tag{R5}$$
44
+
45
+ Independent future process noise adds a term unaffected by the current observation. If a fresh scalar observation is $o=a^Tx+\epsilon$ in a correctly specified Gaussian model with independent variance $r>0$, then its exact one-step reduction in this future risk is
46
+
47
+ $$V_{\rm residual}(a)
48
+ =\frac{a^TPG_{\rm future}Pa}{r+a^TPa}. \tag{R6}$$
49
+
50
+ **Derivation.** Gaussian conditioning gives $P^+=P-Paa^TP/(r+a^TPa)$. Evaluate $\operatorname{tr}[G_{\rm future}(P-P^+)]$. This is the same estimation identity as P4, but with the output contract's actual residual-risk matrix. It does not require a newly invented information theory.
51
+
52
+ This distinction matters. For a plug-in image estimate the metric is $C^TQC$; for a physically corrected estimator it is R4. Retention, compression, and query allocation should target the relevant metric, or a declared weighted combination if both readout types are used. A predictor trained only to match image means can leave expensive residual variation across physical sample terms.
53
+
54
+ No claim of a universal long-horizon optimum follows. If future queries, visibility, trajectories or proposals change as a result of today's sample, the fixed-metric derivation no longer gives the full closed-loop value. Bellman value or a justified approximation is required. The implemented active policy uses a simple uncertainty heuristic with a positive exploration floor; it does not implement R6 as an exact physical posterior controller.
55
+
56
+ There is also no sample-by-sample monotonicity theorem. For fixed $f=(1,1)$ and uniform sampling, $h=(0,0)$ already yields zero variance. Learning only the first term exactly changes $h$ to $(1,0)$ and raises one-sample variance to $1$. More accurate integrand values do not automatically lower *realized* control-variate variance. R6 is an expected posterior statement under its declared model.
57
+
58
+ ## 19.6 Proposition P13: the estimator-equivalence quotient (Proved)
59
+
60
+ For a fixed positive proposal $q$, two controls $h$ and $h'$ yield identical R1 outputs for every possible sample sequence and every physical $f$ if and only if there exists one vector $a\in\mathbb R^d$ such that
61
+
62
+ $$h'_j-h_j=q_j a\qquad\text{for every }j. \tag{R7}$$
63
+
64
+ **Proof.** If R7 holds, the integrated control increases by $a$, while every sampled residual decreases by $a$. They cancel pathwise, not merely in expectation. Conversely, consider a possible sequence in which all $n$ samples equal an arbitrary $j$; it has positive probability. Writing $\delta H=\sum_k(h'_k-h_k)$, equality of outputs implies $\delta H-(h'_j-h_j)/q_j=0$. Thus R7 holds with $a=\delta H$ for every $j$. $\square$
65
+
66
+ Every class has a unique zero-sum representative
67
+
68
+ $$h_j^\circ=h_j-q_jH,\qquad \sum_jh_j^\circ=0. \tag{R8}$$
69
+
70
+ Among unrestricted controls for this fixed receiver/proposal, the estimator therefore depends on $d(K-1)$ rather than $dK$ degrees of freedom. It responds to *centered sampling variation*, not to every component of the cached prediction. This is the familiar centered-control-variate nullspace expressed as an exact rendering-state quotient. Its use here is an architecture criterion: discard only directions proved irrelevant to the actual output and update contract.
71
+
72
+ This is not a general compression breakthrough by itself. Removing one mode from 36 terms is small, and other low-rank savings remain empirical. A pure neural preview still needs the integrated prediction. More importantly, the equivalence depends on $q$: if two distinct normalized positive proposals must share exactly the same unmodified representation, their one-dimensional scalar nullspaces intersect only at zero. A mode harmless under today's proposal may matter after tomorrow's adaptive sampling change. Either retain sufficient state for those changes or recompute the action-dependent representation. R7 cannot justify deleting modes permanently from an arbitrary query-closed world belief.
73
+
74
+ An immediately testable research extension is a multi-task, integrable basis whose expensive modes are retained by R4/R5 and whose known null directions are eliminated. This could reduce shared decoding and correction cost. Neither a universal learned basis nor GPU acceleration from this idea has been demonstrated here.
75
+
76
+ ## 19.7 Proposition P14: limited detection-delay bound (Proved)
77
+
78
+ Suppose a stored deterministic physical fact has become false, it is eligible for a fresh query, and each successive trial has conditional probability at least $\alpha>0$ of returning a contradictory trusted observation, given all prior misses. Then the probability of no detection after $N$ trials is at most $(1-\alpha)^N$, and the expected number of trials to first detection is at most $1/\alpha$.
79
+
80
+ **Proof.** If $A_N$ is the event of no contradiction in the first $N$ trials, then $P(A_N)\leq(1-\alpha)P(A_{N-1})$ by conditioning on prior misses. Induction proves the tail bound. Summing $P(T>N)$ for $N\geq0$ gives the expectation bound. Independence beyond the stated conditional probability bound is not required. $\square$
81
+
82
+ The active policy mixes ten percent uniform exploration into its proposal, so each term of an actually queried receiver has probability at least $0.1/K$ per draw. This gives a conservative bound only when a changed, previously trusted term at that receiver remains queryable. A never-visited receiver, undetectable difference, noisy ambiguity, or unbounded arrival of new changes can defeat a useful global guarantee. This bound says nothing about the error magnitude before detection.
83
+
84
+ The executable guard checks trusted binary visibility after each batch. A contradiction revokes the entire memory's current trust epoch, retains values as fallible predictors, and accepts current observations in the new epoch. The next batch then explores invalidated terms. Global invalidation is intentionally conservative; a dependency graph could localize it, but is not implemented. No oracle change flag or future state is supplied in the hidden-change experiment. The guard cannot revise the sampling decision or output that preceded the contradiction.
85
+
86
+ ## 19.8 Proposition P15: a fixed-budget confidence bound (Proved)
87
+
88
+ Assume the R1 conditions and known deterministic physical bounds $0\leq f_{jc}\leq b_{jc}$ for each channel $c$. Define
89
+
90
+ $$\ell_c=\min_j\frac{-h_{jc}}{q_j},\qquad
91
+ u_c=\max_j\frac{b_{jc}-h_{jc}}{q_j}. \tag{R9}$$
92
+
93
+ For $d$ channels and $0<\delta<1$, all channels simultaneously satisfy
94
+
95
+ $$|\widehat I_c-I_c|\leq(u_c-\ell_c)
96
+ \sqrt{\frac{\log(2d/\delta)}{2n}} \tag{R10}$$
97
+
98
+ with conditional probability at least $1-\delta$.
99
+
100
+ **Proof.** Each sampled channel residual lies in $[\ell_c,u_c]$. Hoeffding's inequality bounds either tail of its sample mean by $\exp[-2n\epsilon_c^2/(u_c-\ell_c)^2]$. Substitute R10 and union bound over the two tails and $d$ channels. The deterministic integrated control adds no random error. $\square$
101
+
102
+ For $P$ receivers, use failure budget $\delta/P$ per receiver for a frame-wide union bound; independence between receivers is unnecessary for that union bound. R10 requires fixed $n$. Inspecting bounds repeatedly and stopping at the first acceptable one needs an anytime-valid construction or a correctly allocated error budget. Unbounded path weights and stochastic radiance without valid bounds violate this premise.
103
+
104
+ This is a conservative classical concentration bound, not a calibrated uncertainty result for the neural prior. At two shadow rays its radius is usually too large for a useful real-time quality certificate. The executable routine and an enumerated coverage test make the distinction explicit. Practical tight risk control remains research work.
experiments.json ADDED
@@ -0,0 +1,18 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "protocol_version": "2.0.0",
3
+ "frozen_before_first_benchmark_run": true,
4
+ "scene_ids": [200, 201, 202, 203, 204, 205, 206, 207],
5
+ "replicate_seeds": [3101, 3102, 3103],
6
+ "receiver_grid": [32, 64],
7
+ "viewport": [16, 20],
8
+ "emitter_grid_side": 6,
9
+ "rays_per_receiver_per_frame": 2,
10
+ "phases": {"cold": 4, "warm": 16, "revisit": 8, "relight": 8, "hidden_change": 8},
11
+ "unseen_ticks_before_revisit": 500,
12
+ "unseen_tick_semantics": "No observations of these receivers. This is a clock gap, not 500 fully rendered frames.",
13
+ "methods": ["raw_importance", "neural_cv", "constant_world_cv", "screen_cv", "world_cv", "world_active_cv", "world_plugin"],
14
+ "primary_comparison": "world_cv versus screen_cv expected per-channel MSE in revisit phase, equal physical ray count",
15
+ "secondary_comparisons": ["world_cv versus raw_importance", "world_active_cv versus world_cv", "world_cv versus constant_world_cv", "world_cv versus world_plugin in hidden_change phase"],
16
+ "reporting": "All methods and phases, including regressions; scene-cluster bootstrap 95% intervals; no GPU/FPS inference",
17
+ "scope": "Direct illumination of point receivers by finite point emitters behind sphere occluders"
18
+ }
experiments_followup.json ADDED
@@ -0,0 +1,18 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "protocol_version": "2.0.0-followup",
3
+ "reason": "The first run exposed an active-sampling regression after unannounced geometry changes. Evaluate observation-triggered trust revocation on a disjoint scene split.",
4
+ "frozen_before_followup_run": true,
5
+ "scene_ids": [300, 301, 302, 303, 304, 305, 306, 307],
6
+ "replicate_seeds": [4101, 4102, 4103],
7
+ "receiver_grid": [32, 64],
8
+ "viewport": [16, 20],
9
+ "emitter_grid_side": 6,
10
+ "rays_per_receiver_per_frame": 2,
11
+ "phases": {"cold": 4, "warm": 16, "revisit": 8, "relight": 8, "hidden_change": 8},
12
+ "unseen_ticks_before_revisit": 500,
13
+ "unseen_tick_semantics": "No observations of these receivers. This is a clock gap, not 500 fully rendered frames.",
14
+ "methods": ["raw_importance", "screen_cv", "world_cv", "world_active_cv", "world_guarded_cv"],
15
+ "primary_comparison": "world_guarded_cv versus world_active_cv expected MSE in hidden_change phase",
16
+ "reporting": "Include first surprise frame and all later frames. No oracle change flag. Observe conflict after correcting current output; revoke all trust for next output.",
17
+ "scope": "Follow-up on independent scenes; same renderer family, neural weights, ray budget and material/light setup"
18
+ }
experiments_innovation.json ADDED
@@ -0,0 +1,18 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "protocol_version": "3.0.0-innovation",
3
+ "frozen_before_first_run": true,
4
+ "scene_ids": [400,401,402,403,404,405,406,407,408,409,410,411],
5
+ "replicate_seeds": [5101,5102,5103],
6
+ "receiver_grid": [32,64],
7
+ "viewport": [16,20],
8
+ "emitter_grid_side": 6,
9
+ "maximum_rays_per_receiver_per_frame": 2,
10
+ "phases": {"cold":4,"warm":20,"revisit":8,"relight":8,"smooth_motion":16,"jump":8,"return":8},
11
+ "unobserved_clock_gap": 500,
12
+ "methods": ["raw_importance","v2_guarded","epoch_eliminate","certificate_iid","certificate_eliminate","constant_certificate","unsafe_eliminate"],
13
+ "primary_comparison": "certificate_eliminate versus epoch_eliminate conditional expected MSE in smooth_motion",
14
+ "secondary": ["revisit ray count", "jump and return MSE including first frame", "certificate_iid versus sequential elimination", "constant-prior ablation", "invalid certificate audit", "CPU batch cost and memory"],
15
+ "fairness": "Same scene state and maximum physical-ray budget, not matched total time or VRAM. All methods may observe current geometry. Epoch baseline detects any geometry change. Prior is the frozen v2 prior for the initial scene, with no retraining.",
16
+ "scope": "Known geometry motion replaces the v2 hidden-event protocol. No claim to solve unobservable changes. Float64 certificates have a 1e-9 clearance guard; the kernel is not formally verified.",
17
+ "sampling": "Base proposal fixed from analytic unoccluded contributions and initial neural prior; restrict and renormalize over unknown terms. Sequential estimator averages two conditionally unbiased martingale estimates, except deterministic exact completion. Unused rays are reported, not reassigned."
18
+ }