Lookup symbols, addresses, units, and match metadata in crashwoc-decomp. Use when Codex needs to map a function or global to config/GCBE7D/symbols.txt, split ownership, build/GCBE7D/report.json, or fallback DWARF lines.
Start with the repo-local helpers:
python tools/ai_lookup_symbol.py <name-or-address>python tools/ai_context.py <name-or-address>python tools/ai_lookup_unit.py <unit-or-path> when the query is really a source file or unitExamples:
python tools/ai_lookup_symbol.py FindAITypepython tools/ai_lookup_symbol.py 0x800032A0python tools/ai_context.py FindAITypeUse the lookup sources in this order:
config/GCBE7D/symbols.txt for validated names and addressesbuild/GCBE7D/report.json for owning source paths, progress categories, and fuzzy-match databuild/GCBE7D/asm/<unit>.s when you need exact function control flow, rodata strings, or float constants from the extracted retail assemblyconfig/GCBE7D/splits.txt to resolve the owning unit from an address rangesrc/dump_alphaNGCport_DWARF.txt for fallback hints onlyDo not promote DWARF hints into validated facts without checking the rest of the repo state.
ai_lookup_symbol.py first.ai_context.py.ai_match_plan.py.build/GCBE7D/asm/<unit>.s for the exact body and nearby rodata labels before falling back to DWARF.ai_1.c.