qvm: special contact armor classification
Browse files- docs/ASSET_PIPELINE_TODO.md +3 -0
- docs/FINDINGS.md +3 -0
- docs/PROVISIONAL_TODO.md +3 -0
- docs/RESEARCH_LEDGER.md +5 -0
- docs/REVERSE_ENGINEERING_TODO.md +3 -0
- docs/research/QVM_CONTACT_SPECIAL.md +7 -0
- docs/research/README.md +3 -0
- docs/research/qvm-contact-special.json +0 -0
- scripts/analyze_qvm_contact_special.py +14 -0
- scripts/test_qvm_contact_special.py +23 -0
docs/ASSET_PIPELINE_TODO.md
CHANGED
|
@@ -808,3 +808,6 @@ RE-703–712 batch complete: [damage factor and contact dispatch](research/QVM_D
|
|
| 808 |
|
| 809 |
|
| 810 |
Research progress: RE-714 [report](research/QVM_CONTACT_FACTOR.md); remaining native/content/runtime/platform scope stays open.
|
|
|
|
|
|
|
|
|
|
|
|
| 808 |
|
| 809 |
|
| 810 |
Research progress: RE-714 [report](research/QVM_CONTACT_FACTOR.md); remaining native/content/runtime/platform scope stays open.
|
| 811 |
+
|
| 812 |
+
|
| 813 |
+
Research progress: RE-715 [report](research/QVM_CONTACT_SPECIAL.md); remaining native/content/runtime/platform scope stays open.
|
docs/FINDINGS.md
CHANGED
|
@@ -1154,3 +1154,6 @@ RE-703–712 batch complete: [damage factor and contact dispatch](research/QVM_D
|
|
| 1154 |
|
| 1155 |
|
| 1156 |
**RE-714 — Ordinary contact factor composition:** Ordinary292545 now calls complete289594, multiplies its returned float factor by100 and suppresses the scalar when the output location is zero. [Evidence](research/QVM_CONTACT_FACTOR.md).
|
|
|
|
|
|
|
|
|
|
|
|
| 1154 |
|
| 1155 |
|
| 1156 |
**RE-714 — Ordinary contact factor composition:** Ordinary292545 now calls complete289594, multiplies its returned float factor by100 and suppresses the scalar when the output location is zero. [Evidence](research/QVM_CONTACT_FACTOR.md).
|
| 1157 |
+
|
| 1158 |
+
|
| 1159 |
+
**RE-715 — Special weapon4 contact classification:** The special contact path fixes scalar1, reads the first context category and reclassifies head/torso through actual inventory, without invoking289594 or changing its accumulator. [Evidence](research/QVM_CONTACT_SPECIAL.md).
|
docs/PROVISIONAL_TODO.md
CHANGED
|
@@ -1143,3 +1143,6 @@ RE-703–712 batch complete: [damage factor and contact dispatch](research/QVM_D
|
|
| 1143 |
|
| 1144 |
|
| 1145 |
Research progress: RE-714 [report](research/QVM_CONTACT_FACTOR.md); remaining native/content/runtime/platform scope stays open.
|
|
|
|
|
|
|
|
|
|
|
|
| 1143 |
|
| 1144 |
|
| 1145 |
Research progress: RE-714 [report](research/QVM_CONTACT_FACTOR.md); remaining native/content/runtime/platform scope stays open.
|
| 1146 |
+
|
| 1147 |
+
|
| 1148 |
+
Research progress: RE-715 [report](research/QVM_CONTACT_SPECIAL.md); remaining native/content/runtime/platform scope stays open.
|
docs/RESEARCH_LEDGER.md
CHANGED
|
@@ -1210,3 +1210,8 @@ Batch RE-703–712 closes ten independently checked research tasks in ten separa
|
|
| 1210 |
## 2026-10-21 — RE-714 Ordinary contact factor composition (separate task commit)
|
| 1211 |
|
| 1212 |
Ordinary292545 now calls complete289594, multiplies its returned float factor by100 and suppresses the scalar when the output location is zero. 96 weapon/location/equipment/clock/override fixtures verify actual pointer handoff, float32 scaling and zero-location suppression. Full suite: 1304 tests pass. Report regenerates byte-identically (311243 bytes). Storage/filter, links and whitespace checks pass. No assets/Rust runtime/shared VM evaluator changed; native/reference/legal/full platform scope remains open.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1210 |
## 2026-10-21 — RE-714 Ordinary contact factor composition (separate task commit)
|
| 1211 |
|
| 1212 |
Ordinary292545 now calls complete289594, multiplies its returned float factor by100 and suppresses the scalar when the output location is zero. 96 weapon/location/equipment/clock/override fixtures verify actual pointer handoff, float32 scaling and zero-location suppression. Full suite: 1304 tests pass. Report regenerates byte-identically (311243 bytes). Storage/filter, links and whitespace checks pass. No assets/Rust runtime/shared VM evaluator changed; native/reference/legal/full platform scope remains open.
|
| 1213 |
+
|
| 1214 |
+
|
| 1215 |
+
## 2026-10-21 — RE-715 Special weapon4 contact classification (separate task commit)
|
| 1216 |
+
|
| 1217 |
+
The special contact path fixes scalar1, reads the first context category and reclassifies head/torso through actual inventory, without invoking289594 or changing its accumulator. 224 category/client/health/slot combinations check scalar, classifier decisions, exact item queries and exclusion of slot16. Full suite: 1308 tests pass. Report regenerates byte-identically (215339 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
CHANGED
|
@@ -1186,3 +1186,6 @@ Purpose: turn the supplied installation into an evidence-backed specification of
|
|
| 1186 |
|
| 1187 |
|
| 1188 |
- [x] RE-714 Ordinary contact factor composition ([report](research/QVM_CONTACT_FACTOR.md)).
|
|
|
|
|
|
|
|
|
|
|
|
| 1186 |
|
| 1187 |
|
| 1188 |
- [x] RE-714 Ordinary contact factor composition ([report](research/QVM_CONTACT_FACTOR.md)).
|
| 1189 |
+
|
| 1190 |
+
|
| 1191 |
+
- [x] RE-715 Special weapon4 contact classification ([report](research/QVM_CONTACT_SPECIAL.md)).
|
docs/research/QVM_CONTACT_SPECIAL.md
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# Special weapon4 contact classification
|
| 2 |
+
|
| 3 |
+
RE-715. Reproduce with `python3 scripts/analyze_qvm_contact_special.py`; check with `python3 scripts/test_qvm_contact_special.py`. The [machine report](qvm-contact-special.json) retains source identity and bounded fixtures.
|
| 4 |
+
|
| 5 |
+
Actual292675 jumps to292736 when special local52 is set. It stores float32(1) in local56, reads context68 into local60, and skips equipment checks for null clients. Live32155/32117 selects torso3/4 using item17 and head1/2 using item22, requiring positive client208 and a matching low byte in the first16 slots. Other categories remain unchanged. This path bypasses289594 and preserves the extra accumulator. Its flag is an explicit recovered-prefix input; complete caller legality and later event behavior remain separate. No health damage executes.
|
| 6 |
+
|
| 7 |
+
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
CHANGED
|
@@ -744,3 +744,6 @@ The extension collector adds five focused tests for native tail calls, command-r
|
|
| 744 |
|
| 745 |
|
| 746 |
[RE-714: Ordinary contact factor composition](QVM_CONTACT_FACTOR.md). Reproduce with `python3 scripts/analyze_qvm_contact_factor.py`; check with `python3 scripts/test_qvm_contact_factor.py`.
|
|
|
|
|
|
|
|
|
|
|
|
| 744 |
|
| 745 |
|
| 746 |
[RE-714: Ordinary contact factor composition](QVM_CONTACT_FACTOR.md). Reproduce with `python3 scripts/analyze_qvm_contact_factor.py`; check with `python3 scripts/test_qvm_contact_factor.py`.
|
| 747 |
+
|
| 748 |
+
|
| 749 |
+
[RE-715: Special weapon4 contact classification](QVM_CONTACT_SPECIAL.md). Reproduce with `python3 scripts/analyze_qvm_contact_special.py`; check with `python3 scripts/test_qvm_contact_special.py`.
|
docs/research/qvm-contact-special.json
ADDED
|
The diff for this file is too large to render.
See raw diff
|
|
|
scripts/analyze_qvm_contact_special.py
ADDED
|
@@ -0,0 +1,14 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
#!/usr/bin/env python3
|
| 2 |
+
"""Special contact scalar1 and recovered live inventory location selection."""
|
| 3 |
+
import itertools
|
| 4 |
+
from pathlib import Path
|
| 5 |
+
from qvm_research_support import source
|
| 6 |
+
from qvm_contact_support import seed,run
|
| 7 |
+
from analyze_qvm import write_json
|
| 8 |
+
|
| 9 |
+
def main():
|
| 10 |
+
q,raw,h,ins=source();rows=[]
|
| 11 |
+
for loc,client,health,slot in itertools.product(range(1,15),[False,True],[0,100],[-1,0,15,16]):
|
| 12 |
+
a=dict(location=loc,client=client,client_health=health,vest_slot=slot if loc in (3,4) else -1,helmet_slot=slot if loc in (1,2) else -1,weapon=4,special=True);_,p=run(ins,seed(raw,h,**a),292675,292833);p['input']=a;rows.append(p)
|
| 13 |
+
write_json(Path('docs/research/qvm-contact-special.json'),{'source':q['source'],'sha256':q['sha256'],'probes':rows,'limits':'Actual292675 and292736..292832; actual32155/32117 inventory. Selected special flag is a supplied prefix result, not inferred gameplay validity. No factor/event/health execution.'})
|
| 14 |
+
if __name__=='__main__':main()
|
scripts/test_qvm_contact_special.py
ADDED
|
@@ -0,0 +1,23 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
import json,unittest
|
| 2 |
+
from pathlib import Path
|
| 3 |
+
from test_qvm_ground import word
|
| 4 |
+
class SpecialContactTests(unittest.TestCase):
|
| 5 |
+
@classmethod
|
| 6 |
+
def setUpClass(cls):cls.ps=json.loads(Path('docs/research/qvm-contact-special.json').read_text())['probes']
|
| 7 |
+
def test_scalar_one_and_no_extra_accumulation(self):
|
| 8 |
+
for p in self.ps:self.assertEqual(p['scalar_word'],word(1));self.assertEqual(p['extra_word'],word(0.25));self.assertEqual(p['target_health'],100)
|
| 9 |
+
def test_independent_equipment_health_slot_location_oracle(self):
|
| 10 |
+
for p in self.ps:
|
| 11 |
+
a=p['input'];loc=a['location']
|
| 12 |
+
if a['client']:
|
| 13 |
+
if loc in (3,4):loc=4 if a['client_health']>0 and 0<=a['vest_slot']<16 else 3
|
| 14 |
+
if loc in (1,2):loc=2 if a['client_health']>0 and 0<=a['helmet_slot']<16 else 1
|
| 15 |
+
self.assertEqual(p['location'],loc)
|
| 16 |
+
def test_only_relevant_equipment_call(self):
|
| 17 |
+
for p in self.ps:
|
| 18 |
+
a=p['input'];item=17 if a['location'] in (3,4) else 22 if a['location'] in (1,2) else None;calls=p['execution']['calls'];self.assertEqual(len(calls),int(a['client'] and item is not None))
|
| 19 |
+
if calls:self.assertEqual(calls[0]['target'],32155);self.assertEqual(calls[0]['args']['12'],item)
|
| 20 |
+
def test_no_factor_health_or_event_effects(self):
|
| 21 |
+
self.assertEqual(len(self.ps),224)
|
| 22 |
+
for p in self.ps:self.assertTrue(all(not v for v in p['effects'].values()));self.assertEqual(p['execution']['stop'],292833)
|
| 23 |
+
if __name__=='__main__':unittest.main()
|