Implement Grappler scalar component with original-code references

This commit is contained in:
UnixNight committed 2026-11-03 21:25:54 -05:00
1 parent 70cba65c1f
commit 0c913d15aa
18 files changed
+1014 -14

No files matched your search

+100
View File
@@ -0,0 +1,100 @@
# Grappler scalar checkpoint
2026-11-03. Continues user-requested gadgets after the Rocketship/orbit fixes.
The latest playable packages include the orbit Left/Right correction70cba65.
GrapplerMotion is an isolated component; no live equip/ray/swing/camera path is
enabled. Originals and supplied friend files remain untouched. All investigator
ownership returned after their usage limits; primary integrated retained results.
## Implemented coverage
| Original span, exclusive end | File offset | Managed coverage / verification |
| --- | --- | --- |
|426BE8..426C70|26BE8|Explicit x87 sqrt distance minus100, first-length sentinel and initial rope Z scale.8 native cases, including reattach, fractions and short/negative lengths.|
|426DAC..426DD5|26DAC|Held reel: old length strictly>250, subtract250*dt without final clamp.6 native cases; loop-audio branches are outside the snippet.|
|429DC9..429DF5|29DC9|Fast reel: target<old length, subtract950*dt without target clamp.6 native cases.|
|42A077..42A1A2|2A077|Swing scalar offset acceleration, stored elapsed>=double.2, clamp50 and350 damping boundary, subtract float.2 once.10 native cases; no body constraint/position execution.|
`tools/binary/grappler.py` guards the authoritative EXE identity and enclosing
source spans; `grappler_motion.py` records the four exact span hashes/offsets and
imports completed probe results. The numeric fixture in
`tests/GamePort.GrapplerTests/original-scalar-reference.json` includes source,
generator, executable and log hashes. Eight attachment observations measure only
length/initial-length/scale callback; managed velocityY100 and reel target are
supported by the separate guarded426CDE..426D4D source, not those observations.
Independent jump/fire detach is retained from the prior source contract.
42A0C2 stores Z while retaining its unrounded x87 value until damping; the new
managed helper preserves a double intermediate there. X is reloaded after its
float store. Both are bounded projections; general x87 bit identity is unclaimed.
Neither negative lengths nor250/target overshoot are silently repaired.
## Probe boundary and verification
`grappler_scalar_probe.c` copies the hashed EXE into private memory, relocates
only whitelisted absolute scalar operands in the four slices, seeds synthetic
frame/root/state, stubs the rope shape's scale callback and exits at bounded
slice boundaries. It never invokes the original entrypoint, ray/body dispatch,
audio or renderer. Separate copied Wine32 installation/prefix runs with no
network or Original mount. Thirty cases finish with GRAPPLER_SCALARS_COMPLETE.
The initial fresh Wine prefix exceeded an8-second allowance and could not load
kernel32 on retry; those failures are retained. A copied previously working
prefix resolved startup. A fixed original-image allocation was unavailable;
the final successful probe uses private image relocation instead. Earlier map
failure logs are retained, and no results from failed runs enter the fixture.
The initial C build collided with Windows' byte typedef; emitter naming was
corrected before successful compilation.
Five managed groups compare all30 native observations within.0002 and cover
first-length retention, source-only velocity/target, overshoot, one-step damping,
simultaneous fire/jump and bounded inputs.14 Python source/projection checks,
existing25 movement/15 gadget groups and the main .NET10 build pass. This is
component execution/port compilation, not original or modern Grappler gameplay.
Evidence is under artifacts/grappler-scalars/{source.json,probe-ready/wine.log,
probe-ready/capture.json,managed.log,python.log,movement.log,gadgets.log,build.log}.
## Retained source investigation and remaining integration gates
The following source evidence narrows the next work; it is not a live adapter:
- Aim cursor and attachment have different gates.426A70 attaches on a successful
ray hit without repeating429D00's450-distance/material rejection. Both query
root→full-Euler local(0,2400,2400) using47C210(false). The aim path refreshes
root at42A384, discarding the earlier swing pivot+116. VR08 game vtable4D00D0
slot134 at4D0204→475CD0(false) supports static filter admission, but selected
material/global context and attached callback composition remain to implement.
- 429D00 returning true only ends the remaining active input426030. Ordinary
Jimmy437940 still dispatches437C40/437F90, publishing velocity independently
after swing root work; do not skip normal movement wholesale. Swing constraint
normalization uses OMT quick_magnitude, unlike attachment's explicit sqrt.
- Constructor/helper bindings point to HIROPE→rope01.ASE/jimycarl.png and the
owned cursor's retainedsprites.omt8. Cursor constructor4453B0 includes misleading
shadow debug strings; full draw/size/material consumers and helper retention
remain gates before an exact resource exporter/live visuals.
Retained REA replies, export bundles and closed snapshots:
| Artifact / procedure | REA Evidence |
| --- | --- |
|grappler-ray/rea/01.json47C210|ev_ff5aab3bdc275e6626753743a3567a556f698209ad9f65689cf49a4b5f56107d|
|grappler-ray/rea/02.json469A10|ev_03ea52bd4de36f296429073b5478032e7e55f7dc64c8545de8151bb893dd3542|
|grappler-motion/rea-base/00.json43AA40|ev_4f2a6aa666451db831efd46f5c587573e22d8072315626b8bc2f844f9c6f0cae|
|grappler-motion/rea-base/01.json47B4B0|ev_d45e078c585d3773494c0e0dfb1696178dd0b8ce8b696caf133892ff070e552e|
|grappler-resources/rea-constructors/00.json41EEB0|ev_307511ff899b91988b77796923fdfc31fa0f1bda5549f13b34c775fdc4917591|
|grappler-resources/rea-constructors/01.json4453B0|ev_423e61df2143a9dd441abffb09540b8c4ce401a0a05774d59221db623c2a7007|
|grappler-resources/rea-constructors/02.json445540|ev_76d17159215638e5e200985b3b83fa917c484805543a80a6b0ec2b86d466a488|
|grappler-resources/rea-constructors/03.json41F030|ev_2c7479a578411c7248c48387125c005db3241e79a3cb91254f1c81bff267957f|
All artifact paths are under artifacts/. The unrecognized475CD0 pseudocode
request has a retained provider error; raw vtable/code supplies that leaf's
evidence. Prior unrecognized429D00/426A70 calls were not repeated. No provider
configuration changed. Source disassembly supplements successful recognized
helpers; no whole-function pseudocode success is attributed to missing entries.
Next: selected polygon/material context and exact original attached constraint /
collision callback42A660; helper model/cursor draw+reset/cleanup and shared follow
camera ownership. Then boundedVR08 integration with simultaneous jump/fire,
reattach, control loss, menu, noclip and RETURN tests. No nearest-hook/direct-pull
substitute, invented launch impulse, generic helper persistence or original/native
Windows gameplay claim is enabled by this checkpoint.