qvm: history producer callers

docs/ASSET_PIPELINE_TODO.md

@@ -652,3 +652,6 @@ Research progress: RE-656 [report](research/QVM_MODEL_TRANSFORMS.md); remaining
 
 
 Research progress: RE-657 [report](research/QVM_ENTITY_QUERY.md); remaining native/content/runtime/platform scope stays open.
+
+
+Research progress: RE-659 [report](research/QVM_HISTORY_CALLERS.md); remaining native/content/runtime/platform scope stays open.

docs/FINDINGS.md

@@ -998,3 +998,6 @@ Bounded qagame paths recover bomb-plant/inactivity correction requests, direct f
 
 
 **RE-657 — Complete entity tag query and continuation:** 276433 scans880-byte entity records using nonzero532/536 and exact integer540 tag equality; continuation starts after the prior record. [Evidence](research/QVM_ENTITY_QUERY.md).
+
+
+**RE-659 — History producer caller and literal-reference inventory:** One direct append caller156173 and three direct reset callers174399/203011/219630 are present; no aligned initialized-data matches were found. [Evidence](research/QVM_HISTORY_CALLERS.md).

docs/PROVISIONAL_TODO.md

@@ -975,3 +975,6 @@ Research progress: RE-657 [report](research/QVM_ENTITY_QUERY.md); remaining nati
 
 
 RE-648–657 batch complete: [history production and model-hit preparation](research/QVM_HISTORY_HIT_BATCH.md). RE-658 tracks the next bounded research work; original/native parity and full Rust/Bevy/Solari gameplay remain open.
+
+
+Research progress: RE-659 [report](research/QVM_HISTORY_CALLERS.md); remaining native/content/runtime/platform scope stays open.

docs/RESEARCH_LEDGER.md

@@ -952,3 +952,8 @@ Complete279820 updates attacker/victim hit/location/value counters;33715 enables
 ## 2026-10-20 — RE-657 Complete entity tag query and continuation (separate task commit)
 
 276433 scans880-byte entity records using nonzero532/536 and exact integer540 tag equality; continuation starts after the prior record. 60 first-match fixtures and15 repeated scans check all results, exclusion of previous pointers, distinct nonnull names, exhausted pools and unchanged records; unsigned LTU has independent high-bit/equality checks. Full suite: 1097 tests pass. Report regenerates byte-identically (253272 bytes). Storage/filter, links and whitespace checks pass. No assets/Rust runtime changed; the bounded shared evaluator gains tested unsigned LTU support; native/reference/legal/full platform scope remains open.
+
+
+## 2026-10-20 — RE-659 History producer caller and literal-reference inventory (separate task commit)
+
+One direct append caller156173 and three direct reset callers174399/203011/219630 are present; no aligned initialized-data matches were found. Four checks compare exhaustive literal references, actual owner boundaries, copied instruction contexts and initialized-data results. Full suite: 1101 tests pass. Report regenerates byte-identically (26775 bytes). Storage/filter, links and whitespace checks pass. No assets/Rust runtime/shared VM evaluator changed; native/reference/legal/full platform scope remains open.

docs/REVERSE_ENGINEERING_TODO.md

@@ -1018,3 +1018,6 @@ Purpose: turn the supplied installation into an evidence-backed specification of
 
 
 - [ ] RE-658 Recover live history scheduling, complete pose/intersection/contact/damage and lifecycle composition; validate original/native reference behavior and connect a Rust gameplay slice. See the [next ten tasks](research/QVM_HISTORY_HIT_BATCH.md#next-ten-concrete-tasks).
+
+
+- [x] RE-659 History producer caller and literal-reference inventory ([report](research/QVM_HISTORY_CALLERS.md)).

docs/research/QVM_HISTORY_CALLERS.md

@@ -0,0 +1,7 @@
+# History producer caller and literal-reference inventory
+
+RE-659. Reproduce with `python3 scripts/analyze_qvm_history_callers.py`; check with `python3 scripts/test_qvm_history_callers.py`. The [machine report](qvm-history-callers.json) retains source identity and bounded fixtures.
+
+An exhaustive decoded CONST scan finds append142773 at156402 inside156173, and reset142502 at174728/203222/220009 inside174399/203011/219630. Every reference is immediately followed by CALL. The report preserves28 preceding instructions and continuation context for caller argument/guard investigation. No aligned initialized-data word equals either producer entry. This is a complete literal-reference inventory, not proof of dynamic frame scheduling, reset semantics or absence of computed indirect calls. These four source owners bound the next scheduling investigation; do not replace their conditions with assumed connect/respawn/frame labels.
+
+No original executable/full QVM/native collision/physics/rendering executes. Native responses and legal input domains are supplied or unverified where stated; full runtime/macOS/Linux Rust/Bevy/Solari gameplay remains open.

docs/research/README.md

@@ -576,3 +576,6 @@ The extension collector adds five focused tests for native tail calls, command-r
 
 
 [RE-648–657: History production and model-hit preparation](QVM_HISTORY_HIT_BATCH.md), with validation limits and the next ten concrete tasks.
+
+
+[RE-659: History producer caller and literal-reference inventory](QVM_HISTORY_CALLERS.md). Reproduce with `python3 scripts/analyze_qvm_history_callers.py`; check with `python3 scripts/test_qvm_history_callers.py`.

docs/research/qvm-history-callers.json

@@ -0,0 +1,1110 @@
+{
+  "aligned_data_matches": [],
+  "limits": "Complete decoded CONST inventory and aligned initialized-data matches only. Direct literal CALLs are identified; data matches are candidates, not proven function pointers. Context records do not establish dynamic scheduling, reachability or indirect dispatch.",
+  "references": [
+    {
+      "context": [
+        {
+          "code_offset": 461907,
+          "file_offset": 461939,
+          "index": 156374,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 461908,
+          "file_offset": 461940,
+          "index": 156375,
+          "opcode": "ARG",
+          "operand": 8
+        },
+        {
+          "code_offset": 461910,
+          "file_offset": 461942,
+          "index": 156376,
+          "opcode": "LOCAL",
+          "operand": 36
+        },
+        {
+          "code_offset": 461915,
+          "file_offset": 461947,
+          "index": 156377,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 461916,
+          "file_offset": 461948,
+          "index": 156378,
+          "opcode": "ARG",
+          "operand": 12
+        },
+        {
+          "code_offset": 461918,
+          "file_offset": 461950,
+          "index": 156379,
+          "opcode": "CONST",
+          "operand": 1
+        },
+        {
+          "code_offset": 461923,
+          "file_offset": 461955,
+          "index": 156380,
+          "opcode": "ARG",
+          "operand": 16
+        },
+        {
+          "code_offset": 461925,
+          "file_offset": 461957,
+          "index": 156381,
+          "opcode": "CONST",
+          "operand": 30550
+        },
+        {
+          "code_offset": 461930,
+          "file_offset": 461962,
+          "index": 156382,
+          "opcode": "CALL",
+          "operand": null
+        },
+        {
+          "code_offset": 461931,
+          "file_offset": 461963,
+          "index": 156383,
+          "opcode": "POP",
+          "operand": null
+        },
+        {
+          "code_offset": 461932,
+          "file_offset": 461964,
+          "index": 156384,
+          "opcode": "LOCAL",
+          "operand": 48
+        },
+        {
+          "code_offset": 461937,
+          "file_offset": 461969,
+          "index": 156385,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 461938,
+          "file_offset": 461970,
+          "index": 156386,
+          "opcode": "CONST",
+          "operand": 520
+        },
+        {
+          "code_offset": 461943,
+          "file_offset": 461975,
+          "index": 156387,
+          "opcode": "ADD",
+          "operand": null
+        },
+        {
+          "code_offset": 461944,
+          "file_offset": 461976,
+          "index": 156388,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 461945,
+          "file_offset": 461977,
+          "index": 156389,
+          "opcode": "ARG",
+          "operand": 8
+        },
+        {
+          "code_offset": 461947,
+          "file_offset": 461979,
+          "index": 156390,
+          "opcode": "CONST",
+          "operand": 152219
+        },
+        {
+          "code_offset": 461952,
+          "file_offset": 461984,
+          "index": 156391,
+          "opcode": "CALL",
+          "operand": null
+        },
+        {
+          "code_offset": 461953,
+          "file_offset": 461985,
+          "index": 156392,
+          "opcode": "POP",
+          "operand": null
+        },
+        {
+          "code_offset": 461954,
+          "file_offset": 461986,
+          "index": 156393,
+          "opcode": "LOCAL",
+          "operand": 48
+        },
+        {
+          "code_offset": 461959,
+          "file_offset": 461991,
+          "index": 156394,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 461960,
+          "file_offset": 461992,
+          "index": 156395,
+          "opcode": "ARG",
+          "operand": 8
+        },
+        {
+          "code_offset": 461962,
+          "file_offset": 461994,
+          "index": 156396,
+          "opcode": "CONST",
+          "operand": 156413
+        },
+        {
+          "code_offset": 461967,
+          "file_offset": 461999,
+          "index": 156397,
+          "opcode": "CALL",
+          "operand": null
+        },
+        {
+          "code_offset": 461968,
+          "file_offset": 462000,
+          "index": 156398,
+          "opcode": "POP",
+          "operand": null
+        },
+        {
+          "code_offset": 461969,
+          "file_offset": 462001,
+          "index": 156399,
+          "opcode": "LOCAL",
+          "operand": 48
+        },
+        {
+          "code_offset": 461974,
+          "file_offset": 462006,
+          "index": 156400,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 461975,
+          "file_offset": 462007,
+          "index": 156401,
+          "opcode": "ARG",
+          "operand": 8
+        },
+        {
+          "code_offset": 461977,
+          "file_offset": 462009,
+          "index": 156402,
+          "opcode": "CONST",
+          "operand": 142773
+        },
+        {
+          "code_offset": 461982,
+          "file_offset": 462014,
+          "index": 156403,
+          "opcode": "CALL",
+          "operand": null
+        },
+        {
+          "code_offset": 461983,
+          "file_offset": 462015,
+          "index": 156404,
+          "opcode": "POP",
+          "operand": null
+        },
+        {
+          "code_offset": 461984,
+          "file_offset": 462016,
+          "index": 156405,
+          "opcode": "LOCAL",
+          "operand": 48
+        },
+        {
+          "code_offset": 461989,
+          "file_offset": 462021,
+          "index": 156406,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 461990,
+          "file_offset": 462022,
+          "index": 156407,
+          "opcode": "ARG",
+          "operand": 8
+        },
+        {
+          "code_offset": 461992,
+          "file_offset": 462024,
+          "index": 156408,
+          "opcode": "CONST",
+          "operand": 178161
+        },
+        {
+          "code_offset": 461997,
+          "file_offset": 462029,
+          "index": 156409,
+          "opcode": "CALL",
+          "operand": null
+        },
+        {
+          "code_offset": 461998,
+          "file_offset": 462030,
+          "index": 156410,
+          "opcode": "POP",
+          "operand": null
+        }
+      ],
+      "direct_call": true,
+      "instruction": 156402,
+      "owner": 156173,
+      "target": 142773
+    },
+    {
+      "context": [
+        {
+          "code_offset": 517374,
+          "file_offset": 517406,
+          "index": 174700,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 517375,
+          "file_offset": 517407,
+          "index": 174701,
+          "opcode": "STORE4",
+          "operand": null
+        },
+        {
+          "code_offset": 517376,
+          "file_offset": 517408,
+          "index": 174702,
+          "opcode": "LOCAL",
+          "operand": 24
+        },
+        {
+          "code_offset": 517381,
+          "file_offset": 517413,
+          "index": 174703,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 517382,
+          "file_offset": 517414,
+          "index": 174704,
+          "opcode": "ARG",
+          "operand": 8
+        },
+        {
+          "code_offset": 517384,
+          "file_offset": 517416,
+          "index": 174705,
+          "opcode": "CONST",
+          "operand": 0
+        },
+        {
+          "code_offset": 517389,
+          "file_offset": 517421,
+          "index": 174706,
+          "opcode": "ARG",
+          "operand": 12
+        },
+        {
+          "code_offset": 517391,
+          "file_offset": 517423,
+          "index": 174707,
+          "opcode": "CONST",
+          "operand": 468
+        },
+        {
+          "code_offset": 517396,
+          "file_offset": 517428,
+          "index": 174708,
+          "opcode": "ARG",
+          "operand": 16
+        },
+        {
+          "code_offset": 517398,
+          "file_offset": 517430,
+          "index": 174709,
+          "opcode": "CONST",
+          "operand": -101
+        },
+        {
+          "code_offset": 517403,
+          "file_offset": 517435,
+          "index": 174710,
+          "opcode": "CALL",
+          "operand": null
+        },
+        {
+          "code_offset": 517404,
+          "file_offset": 517436,
+          "index": 174711,
+          "opcode": "POP",
+          "operand": null
+        },
+        {
+          "code_offset": 517405,
+          "file_offset": 517437,
+          "index": 174712,
+          "opcode": "LOCAL",
+          "operand": 24
+        },
+        {
+          "code_offset": 517410,
+          "file_offset": 517442,
+          "index": 174713,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 517411,
+          "file_offset": 517443,
+          "index": 174714,
+          "opcode": "CONST",
+          "operand": 104
+        },
+        {
+          "code_offset": 517416,
+          "file_offset": 517448,
+          "index": 174715,
+          "opcode": "ADD",
+          "operand": null
+        },
+        {
+          "code_offset": 517417,
+          "file_offset": 517449,
+          "index": 174716,
+          "opcode": "LOCAL",
+          "operand": 36
+        },
+        {
+          "code_offset": 517422,
+          "file_offset": 517454,
+          "index": 174717,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 517423,
+          "file_offset": 517455,
+          "index": 174718,
+          "opcode": "STORE4",
+          "operand": null
+        },
+        {
+          "code_offset": 517424,
+          "file_offset": 517456,
+          "index": 174719,
+          "opcode": "LOCAL",
+          "operand": 28
+        },
+        {
+          "code_offset": 517429,
+          "file_offset": 517461,
+          "index": 174720,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 517430,
+          "file_offset": 517462,
+          "index": 174721,
+          "opcode": "ARG",
+          "operand": 8
+        },
+        {
+          "code_offset": 517432,
+          "file_offset": 517464,
+          "index": 174722,
+          "opcode": "CONST",
+          "operand": 175123
+        },
+        {
+          "code_offset": 517437,
+          "file_offset": 517469,
+          "index": 174723,
+          "opcode": "CALL",
+          "operand": null
+        },
+        {
+          "code_offset": 517438,
+          "file_offset": 517470,
+          "index": 174724,
+          "opcode": "POP",
+          "operand": null
+        },
+        {
+          "code_offset": 517439,
+          "file_offset": 517471,
+          "index": 174725,
+          "opcode": "LOCAL",
+          "operand": 28
+        },
+        {
+          "code_offset": 517444,
+          "file_offset": 517476,
+          "index": 174726,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 517445,
+          "file_offset": 517477,
+          "index": 174727,
+          "opcode": "ARG",
+          "operand": 8
+        },
+        {
+          "code_offset": 517447,
+          "file_offset": 517479,
+          "index": 174728,
+          "opcode": "CONST",
+          "operand": 142502
+        },
+        {
+          "code_offset": 517452,
+          "file_offset": 517484,
+          "index": 174729,
+          "opcode": "CALL",
+          "operand": null
+        },
+        {
+          "code_offset": 517453,
+          "file_offset": 517485,
+          "index": 174730,
+          "opcode": "POP",
+          "operand": null
+        },
+        {
+          "code_offset": 517454,
+          "file_offset": 517486,
+          "index": 174731,
+          "opcode": "LOCAL",
+          "operand": 24
+        },
+        {
+          "code_offset": 517459,
+          "file_offset": 517491,
+          "index": 174732,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 517460,
+          "file_offset": 517492,
+          "index": 174733,
+          "opcode": "CONST",
+          "operand": 3096
+        },
+        {
+          "code_offset": 517465,
+          "file_offset": 517497,
+          "index": 174734,
+          "opcode": "ADD",
+          "operand": null
+        },
+        {
+          "code_offset": 517466,
+          "file_offset": 517498,
+          "index": 174735,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 517467,
+          "file_offset": 517499,
+          "index": 174736,
+          "opcode": "CONST",
+          "operand": 3
+        }
+      ],
+      "direct_call": true,
+      "instruction": 174728,
+      "owner": 174399,
+      "target": 142502
+    },
+    {
+      "context": [
+        {
+          "code_offset": 604044,
+          "file_offset": 604076,
+          "index": 203194,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 604045,
+          "file_offset": 604077,
+          "index": 203195,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 604046,
+          "file_offset": 604078,
+          "index": 203196,
+          "opcode": "CONST",
+          "operand": 64
+        },
+        {
+          "code_offset": 604051,
+          "file_offset": 604083,
+          "index": 203197,
+          "opcode": "BXOR",
+          "operand": null
+        },
+        {
+          "code_offset": 604052,
+          "file_offset": 604084,
+          "index": 203198,
+          "opcode": "STORE4",
+          "operand": null
+        },
+        {
+          "code_offset": 604053,
+          "file_offset": 604085,
+          "index": 203199,
+          "opcode": "LOCAL",
+          "operand": 28
+        },
+        {
+          "code_offset": 604058,
+          "file_offset": 604090,
+          "index": 203200,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 604059,
+          "file_offset": 604091,
+          "index": 203201,
+          "opcode": "ARG",
+          "operand": 8
+        },
+        {
+          "code_offset": 604061,
+          "file_offset": 604093,
+          "index": 203202,
+          "opcode": "LOCAL",
+          "operand": 68
+        },
+        {
+          "code_offset": 604066,
+          "file_offset": 604098,
+          "index": 203203,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 604067,
+          "file_offset": 604099,
+          "index": 203204,
+          "opcode": "ARG",
+          "operand": 12
+        },
+        {
+          "code_offset": 604069,
+          "file_offset": 604101,
+          "index": 203205,
+          "opcode": "CONST",
+          "operand": 1
+        },
+        {
+          "code_offset": 604074,
+          "file_offset": 604106,
+          "index": 203206,
+          "opcode": "ARG",
+          "operand": 16
+        },
+        {
+          "code_offset": 604076,
+          "file_offset": 604108,
+          "index": 203207,
+          "opcode": "CONST",
+          "operand": 30550
+        },
+        {
+          "code_offset": 604081,
+          "file_offset": 604113,
+          "index": 203208,
+          "opcode": "CALL",
+          "operand": null
+        },
+        {
+          "code_offset": 604082,
+          "file_offset": 604114,
+          "index": 203209,
+          "opcode": "POP",
+          "operand": null
+        },
+        {
+          "code_offset": 604083,
+          "file_offset": 604115,
+          "index": 203210,
+          "opcode": "LOCAL",
+          "operand": 68
+        },
+        {
+          "code_offset": 604088,
+          "file_offset": 604120,
+          "index": 203211,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 604089,
+          "file_offset": 604121,
+          "index": 203212,
+          "opcode": "CONST",
+          "operand": 488
+        },
+        {
+          "code_offset": 604094,
+          "file_offset": 604126,
+          "index": 203213,
+          "opcode": "ADD",
+          "operand": null
+        },
+        {
+          "code_offset": 604095,
+          "file_offset": 604127,
+          "index": 203214,
+          "opcode": "LOCAL",
+          "operand": 28
+        },
+        {
+          "code_offset": 604100,
+          "file_offset": 604132,
+          "index": 203215,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 604101,
+          "file_offset": 604133,
+          "index": 203216,
+          "opcode": "CONST",
+          "operand": 20
+        },
+        {
+          "code_offset": 604106,
+          "file_offset": 604138,
+          "index": 203217,
+          "opcode": "ADD",
+          "operand": null
+        },
+        {
+          "code_offset": 604107,
+          "file_offset": 604139,
+          "index": 203218,
+          "opcode": "BLOCK_COPY",
+          "operand": 12
+        },
+        {
+          "code_offset": 604112,
+          "file_offset": 604144,
+          "index": 203219,
+          "opcode": "LOCAL",
+          "operand": 68
+        },
+        {
+          "code_offset": 604117,
+          "file_offset": 604149,
+          "index": 203220,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 604118,
+          "file_offset": 604150,
+          "index": 203221,
+          "opcode": "ARG",
+          "operand": 8
+        },
+        {
+          "code_offset": 604120,
+          "file_offset": 604152,
+          "index": 203222,
+          "opcode": "CONST",
+          "operand": 142502
+        },
+        {
+          "code_offset": 604125,
+          "file_offset": 604157,
+          "index": 203223,
+          "opcode": "CALL",
+          "operand": null
+        },
+        {
+          "code_offset": 604126,
+          "file_offset": 604158,
+          "index": 203224,
+          "opcode": "POP",
+          "operand": null
+        },
+        {
+          "code_offset": 604127,
+          "file_offset": 604159,
+          "index": 203225,
+          "opcode": "CONST",
+          "operand": 70763
+        },
+        {
+          "code_offset": 604132,
+          "file_offset": 604164,
+          "index": 203226,
+          "opcode": "ARG",
+          "operand": 8
+        },
+        {
+          "code_offset": 604134,
+          "file_offset": 604166,
+          "index": 203227,
+          "opcode": "LOCAL",
+          "operand": 28
+        },
+        {
+          "code_offset": 604139,
+          "file_offset": 604171,
+          "index": 203228,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 604140,
+          "file_offset": 604172,
+          "index": 203229,
+          "opcode": "CONST",
+          "operand": 140
+        },
+        {
+          "code_offset": 604145,
+          "file_offset": 604177,
+          "index": 203230,
+          "opcode": "ADD",
+          "operand": null
+        }
+      ],
+      "direct_call": true,
+      "instruction": 203222,
+      "owner": 203011,
+      "target": 142502
+    },
+    {
+      "context": [
+        {
+          "code_offset": 653678,
+          "file_offset": 653710,
+          "index": 219981,
+          "opcode": "ADD",
+          "operand": null
+        },
+        {
+          "code_offset": 653679,
+          "file_offset": 653711,
+          "index": 219982,
+          "opcode": "LOCAL",
+          "operand": 52
+        },
+        {
+          "code_offset": 653684,
+          "file_offset": 653716,
+          "index": 219983,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 653685,
+          "file_offset": 653717,
+          "index": 219984,
+          "opcode": "CONST",
+          "operand": 520
+        },
+        {
+          "code_offset": 653690,
+          "file_offset": 653722,
+          "index": 219985,
+          "opcode": "ADD",
+          "operand": null
+        },
+        {
+          "code_offset": 653691,
+          "file_offset": 653723,
+          "index": 219986,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 653692,
+          "file_offset": 653724,
+          "index": 219987,
+          "opcode": "CONST",
+          "operand": 20
+        },
+        {
+          "code_offset": 653697,
+          "file_offset": 653729,
+          "index": 219988,
+          "opcode": "ADD",
+          "operand": null
+        },
+        {
+          "code_offset": 653698,
+          "file_offset": 653730,
+          "index": 219989,
+          "opcode": "BLOCK_COPY",
+          "operand": 12
+        },
+        {
+          "code_offset": 653703,
+          "file_offset": 653735,
+          "index": 219990,
+          "opcode": "LOCAL",
+          "operand": 72
+        },
+        {
+          "code_offset": 653708,
+          "file_offset": 653740,
+          "index": 219991,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 653709,
+          "file_offset": 653741,
+          "index": 219992,
+          "opcode": "CONST",
+          "operand": 520
+        },
+        {
+          "code_offset": 653714,
+          "file_offset": 653746,
+          "index": 219993,
+          "opcode": "ADD",
+          "operand": null
+        },
+        {
+          "code_offset": 653715,
+          "file_offset": 653747,
+          "index": 219994,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 653716,
+          "file_offset": 653748,
+          "index": 219995,
+          "opcode": "CONST",
+          "operand": 3096
+        },
+        {
+          "code_offset": 653721,
+          "file_offset": 653753,
+          "index": 219996,
+          "opcode": "ADD",
+          "operand": null
+        },
+        {
+          "code_offset": 653722,
+          "file_offset": 653754,
+          "index": 219997,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 653723,
+          "file_offset": 653755,
+          "index": 219998,
+          "opcode": "CONST",
+          "operand": 3
+        },
+        {
+          "code_offset": 653728,
+          "file_offset": 653760,
+          "index": 219999,
+          "opcode": "EQ",
+          "operand": 220006
+        },
+        {
+          "code_offset": 653733,
+          "file_offset": 653765,
+          "index": 220000,
+          "opcode": "LOCAL",
+          "operand": 72
+        },
+        {
+          "code_offset": 653738,
+          "file_offset": 653770,
+          "index": 220001,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 653739,
+          "file_offset": 653771,
+          "index": 220002,
+          "opcode": "ARG",
+          "operand": 8
+        },
+        {
+          "code_offset": 653741,
+          "file_offset": 653773,
+          "index": 220003,
+          "opcode": "CONST",
+          "operand": -31
+        },
+        {
+          "code_offset": 653746,
+          "file_offset": 653778,
+          "index": 220004,
+          "opcode": "CALL",
+          "operand": null
+        },
+        {
+          "code_offset": 653747,
+          "file_offset": 653779,
+          "index": 220005,
+          "opcode": "POP",
+          "operand": null
+        },
+        {
+          "code_offset": 653748,
+          "file_offset": 653780,
+          "index": 220006,
+          "opcode": "LOCAL",
+          "operand": 72
+        },
+        {
+          "code_offset": 653753,
+          "file_offset": 653785,
+          "index": 220007,
+          "opcode": "LOAD4",
+          "operand": null
+        },
+        {
+          "code_offset": 653754,
+          "file_offset": 653786,
+          "index": 220008,
+          "opcode": "ARG",
+          "operand": 8
+        },
+        {
+          "code_offset": 653756,
+          "file_offset": 653788,
+          "index": 220009,
+          "opcode": "CONST",
+          "operand": 142502
+        },
+        {
+          "code_offset": 653761,
+          "file_offset": 653793,
+          "index": 220010,
+          "opcode": "CALL",
+          "operand": null
+        },
+        {
+          "code_offset": 653762,
+          "file_offset": 653794,
+          "index": 220011,
+          "opcode": "POP",
+          "operand": null
+        },
+        {
+          "code_offset": 653763,
+          "file_offset": 653795,
+          "index": 220012,
+          "opcode": "PUSH",
+          "operand": null
+        },
+        {
+          "code_offset": 653764,
+          "file_offset": 653796,
+          "index": 220013,
+          "opcode": "LEAVE",
+          "operand": 64
+        },
+        {
+          "code_offset": 653769,
+          "file_offset": 653801,
+          "index": 220014,
+          "opcode": "ENTER",
+          "operand": 8
+        },
+        {
+          "code_offset": 653774,
+          "file_offset": 653806,
+          "index": 220015,
+          "opcode": "PUSH",
+          "operand": null
+        },
+        {
+          "code_offset": 653775,
+          "file_offset": 653807,
+          "index": 220016,
+          "opcode": "LEAVE",
+          "operand": 8
+        },
+        {
+          "code_offset": 653780,
+          "file_offset": 653812,
+          "index": 220017,
+          "opcode": "ENTER",
+          "operand": 12
+        }
+      ],
+      "direct_call": true,
+      "instruction": 220009,
+      "owner": 219630,
+      "target": 142502
+    }
+  ],
+  "sha256": "a589351dfe517470a1b121dd2164714987d9e4577bf00c6486e1540035d7a79d",
+  "source": {
+    "archive": "zUrT43_qvm.pk3",
+    "archive_sha256": "b59bf0c5bedf11d50e0edd220da7eade96de40601e98ae14c54c819047df0796",
+    "member": {
+      "bytes": 983300,
+      "comment_hex": "",
+      "compressed_bytes": 246560,
+      "compression": 8,
+      "crc32": "98ea1768",
+      "create_system": 0,
+      "create_version": 63,
+      "date_time": [
+        2018,
+        6,
+        18,
+        22,
+        11,
+        50
+      ],
+      "directory": false,
+      "entry_index": 2,
+      "external_attr": 32,
+      "extra_hex": "0a0020000000000001001800d1e24e974007d40116dcbf962f1fd20116dcbf962f1fd201",
+      "extract_version": 20,
+      "flags": 0,
+      "header_offset": 221309,
+      "internal_attr": 0,
+      "occurrence": 0,
+      "output": "assets/extracted/zUrT43_qvm.pk3/members/000002/vm/qagame.qvm",
+      "path": "vm/qagame.qvm",
+      "sha256": "a589351dfe517470a1b121dd2164714987d9e4577bf00c6486e1540035d7a79d",
+      "type": "member",
+      "volume": 0
+    }
+  }
+}

scripts/analyze_qvm_history_callers.py

@@ -0,0 +1,24 @@
+#!/usr/bin/env python3
+"""Exhaustive literal references and direct call owners for history producers."""
+from pathlib import Path
+from qvm_research_support import source
+from analyze_qvm import write_json
+TARGETS=[142502,142773]
+def inventory(ins):
+    owners={};owner=None
+    for i in ins:
+        if i['opcode']=='ENTER':owner=i['index']
+        owners[i['index']]=owner
+    rows=[]
+    for i in ins:
+        if i['opcode']=='CONST' and i['operand'] in TARGETS:
+            pc=i['index'];direct=ins[pc+1]['opcode']=='CALL';rows.append({'target':i['operand'],'instruction':pc,'owner':owners[pc],'direct_call':direct,'context':ins[max(owners[pc],pc-28):pc+9]})
+    return rows
+
+def main():
+    q,raw,h,ins=source();rows=inventory(ins);tables=[]
+    for address in range(0,h['data_length'],4):
+        value=int.from_bytes(raw[h['data_offset']+address:h['data_offset']+address+4],'little')
+        if value in TARGETS:tables.append({'address':address,'value':value})
+    write_json(Path('docs/research/qvm-history-callers.json'),{'source':q['source'],'sha256':q['sha256'],'references':rows,'aligned_data_matches':tables,'limits':'Complete decoded CONST inventory and aligned initialized-data matches only. Direct literal CALLs are identified; data matches are candidates, not proven function pointers. Context records do not establish dynamic scheduling, reachability or indirect dispatch.'})
+if __name__=='__main__':main()

scripts/test_qvm_history_callers.py

@@ -0,0 +1,16 @@
+import json,unittest
+from pathlib import Path
+from qvm_research_support import source
+class HistoryCallerTests(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls):cls.r=json.loads(Path('docs/research/qvm-history-callers.json').read_text());cls.ins=source()[3]
+    def test_exhaustive_literal_reference_inventory(self):
+        expected=[i['index'] for i in self.ins if i['opcode']=='CONST' and i['operand'] in [142502,142773]];self.assertEqual([p['instruction'] for p in self.r['references']],expected)
+    def test_direct_call_owner_contracts(self):
+        self.assertEqual([(p['target'],p['owner']) for p in self.r['references']],[(142773,156173),(142502,174399),(142502,203011),(142502,219630)])
+        for p in self.r['references']:self.assertTrue(p['direct_call']);self.assertEqual(self.ins[p['instruction']+1]['opcode'],'CALL');self.assertEqual(max(i['index'] for i in self.ins[:p['instruction']] if i['opcode']=='ENTER'),p['owner'])
+    def test_contexts_preserve_actual_instructions(self):
+        for p in self.r['references']:
+            for i in p['context']:self.assertEqual(i,self.ins[i['index']])
+    def test_no_aligned_initialized_data_match(self):self.assertEqual(self.r['aligned_data_matches'],[])
+if __name__=='__main__':unittest.main()