KB: document the #60 census/re-export aftermath across the context system

- CLAUDE.md front + project-overview: census/re-export DONE (93.5% coverage,
  41KB dark), polish list refreshed; the citation-policy warning rides the
  front matter so it is unmissable.
- locomotion §CROUCH addendum: the re-export CONFIRMS the hand transcription
  field-for-field, documents that Ghidra renders members as int-ARRAY indices
  ([0xfe] == byte 0x3f8 -- why offset-string greps of the export miss them),
  and records the AIRBORNE AUTO-RISE branch the raw pass missed (+ its fix).
- decomp-reference §7: citation policy (@ADDR, never part/LINE -- old
  citations resolve only against archive_2025export/), the array-index
  gotcha, and the full re-export toolchain (ghidra_reexport.sh incl. the 8.3
  short-path requirement, gapcensus, gapdiff).
- open-questions: the leads the re-export produced -- @0x4c0904 is the MASTER
  BTPlayer Performance (team-by-name resolve + EndMission post + score
  heartbeat; our @0x4c083c attribution needs a re-check) and the ~9KB
  l4splr|btmssn cluster that stayed dark THROUGH the fill (no call/data
  reference reaches it -- jump-table entry suspected).
- glossary: dark-region.
Section ordering fixed (addenda above Key Relationships); checkctx CLEAN.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Joe DiPrima
2026-08-06 11:18:48 -05:00
co-authored by Claude Fable 5
parent 51dff6bd5a
commit bf39b81b9d
6 changed files with 71 additions and 9 deletions
+6
View File
@@ -437,3 +437,9 @@ export-gap-blindness:
definition: Concluding "the binary/content lacks X" from the Ghidra EXPORT or the port alone. The export has coverage gaps (#60) and RES-archive content never appears in it, so absence there proves nothing. Four incidents (two falsely [T1]); rule + checklist in reconstruction-gotchas §20 — byte-scan the exe, grep NAMED members, walk the BTL4.RES TOC, consult the manifest.
related_terms: [decomp, RES]
related_topics: [reconstruction-gotchas, source-completeness]
dark-region:
kind: concept
definition: A stretch of BTL4OPT.EXE's code section belonging to no function in the Ghidra export -- invisible to any grep of reference/decomp. Inventoried by tools/gapcensus.py into reference/decomp/GAP_CENSUS.md (after the 2026-08-06 re-export: ~41 KB across 321 regions, down from 90 KB). Absence of an address from the export proves nothing until you check whether it is dark; see reconstruction-gotchas 20 (export-gap-blindness).
related_terms: [decomp, export-gap-blindness]
related_topics: [source-completeness, reconstruction-gotchas]