re: recover the IDXD record-key / field-tag hash (8643/8643)

Closes the 4-byte record key. tag_hash is name_hash's shape -- byte-sum
checksum in the top byte over a 24-bit modular polynomial -- with two different
constants: modulus 0x00FFFFDF (2^24-33, prime) instead of 0x00FFF9D7, and no
lowercasing, so tags are case-sensitive. name_hash explains 0 of 8643.

Recovered from the tables rather than the executable: every inline field name
is a known (name -> tag) pair, and comparing names differing in one character
gives the per-position weights 1, 0x100, 0x10000, 0x21, 0x2100, ... -- a byte
leaving bit 24 re-enters as 33, i.e. reduction mod 2^24-33. Holds where it is
easy to get wrong (distance 8 and 9 carry correctly).

A record's key is the tag of its own name: FormationSet rosters 362/362,
UnitGroup rosters 281/281, S02 squadron names 111/111 -- so records can be
addressed by name without reading the roster first.

Implemented in Python (unitgroup.tag_hash) and Rust
(sylpheed_formats::hash::tag_hash) with 3 new unit tests carrying disc-derived
vectors; cargo test -p sylpheed-formats --lib hash is 8/8 green.

Not settled: the guest routine is unlocated, so this uses exact modular
arithmetic where the game may use a Barrett step without final fixup.
This commit is contained in:
Sylpheed RE agent
2026-08-25 10:38:18 +00:00
parent 6903b19a27
commit cbf52ba9f9
6 changed files with 251 additions and 0 deletions

View File

@@ -91,7 +91,39 @@ def diff_threads(a, b):
print(' T%-5d %-32s %-32s %s' % (t, fa, fb, '' if fa == fb else ' <-- CHANGED'))
def stability(tags):
"""Which thread states hold STILL across repeated samples of one healthy run?
Written after a frozen-vs-healthy diff was read as a signature and did not
reproduce: the healthy state varies between instants too, so a difference of
two samples is not yet a difference of two states. Anything that moves here
is disqualified as freeze evidence before it is ever used as such.
"""
snaps = [(t, per_thread(t)) for t in tags]
snaps = [(t, d) for t, d in snaps if d]
if len(snaps) < 2:
print('need at least 2 usable captures, got %d' % len(snaps)); return
threads = sorted({t for _, d in snaps for t in d}, reverse=True)
print('=== stability across %d healthy captures: %s ===' % (
len(snaps), ', '.join(t for t, _ in snaps)))
stable = moved = 0
for th in threads:
vals = [d.get(th, '--') for _, d in snaps]
uniq = sorted(set(vals))
if len(uniq) == 1:
stable += 1
print(' T%-5d STABLE %s' % (th, uniq[0]))
else:
moved += 1
print(' T%-5d VARIES %s' % (th, ' | '.join(vals)))
print(' --- %d stable, %d vary across healthy play' % (stable, moved))
print(' Only a thread in the STABLE set can carry a frozen-state signature;')
print(' a VARIES thread differing when frozen proves nothing.')
if __name__ == '__main__':
if sys.argv[1:2] == ['--stability']:
stability(sys.argv[2:]); sys.exit(0)
tallies = {t: report(t) for t in (sys.argv[1:] or ['healthy'])}
if len(tallies) > 1:
a, b = list(tallies)