nmarshall commited on
Commit
151f41b
·
1 Parent(s): 9829445

qvm: special contact armor classification

Browse files
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()