#!/usr/bin/env python3 """Classify the parent context of the grounded HUD top-menu sequence. The top menu object sequence at 0x004ddc6c draws/attaches the #6/#3/#4 HUD menu regions. Earlier scans proved the payload, but not the normal-field ESC/X opener that schedules it. This review keeps those two facts separate: * 0x004ddc6c is the grounded top-menu construction sequence. * Its only direct pointer reference is the operand of a VM call command inside 0x0047e6a0, whose own parent context is not referenced as a normal field input/open-menu root. """ from __future__ import annotations import html import json import struct from pathlib import Path from typing import Any from probe_exe_scene_tables import offset_to_va, read_sections, va_to_offset from summarize_object_payload_442c75_callers import decode_stream ROOT = Path(__file__).resolve().parents[1] EXE = ROOT / "Hwanse2.exe" OUT = ROOT / "out" WEB = ROOT / "web" TOP_MENU_OBJECT_SEQUENCE_VA = 0x004DDC6C TOP_MENU_WRAPPER_VA = 0x0047E6A0 TOP_MENU_PRE_WRAPPER_GATE_VA = 0x0047E688 TOP_MENU_REJECT_LOOP_VA = 0x0047E67C TOP_MENU_WRAPPER_CALL_COMMAND_VA = 0x0047E6AC TOP_MENU_WRAPPER_CALL_OPERAND_VA = 0x0047E6B0 TOP_MENU_PARENT_CONTEXT_VA = 0x0047E624 INTRO_TITLE_RESOURCE_LIST_VA = 0x004A2CB0 STATUS_REGION6_CHILD_SCRIPT_VA = 0x004DEE18 RIGHT_PANEL_REGION3_CHILD_SCRIPT_VA = 0x004DEE58 RIGHT_PANEL_REGION4_CHILD_SCRIPT_VA = 0x004DEE98 RIGHT_PANEL_REGION4_PAGE_SCRIPT_VA = 0x004DE468 def hx(value: int | None, width: int = 8) -> str: return "-" if value is None else f"0x{value:0{width}x}" def h(value: Any) -> str: return html.escape("" if value is None else str(value), quote=True) def read_at(exe: bytes, sections: list[dict[str, Any]], va: int, size: int) -> bytes: offset = va_to_offset(sections, va) if offset is None: raise ValueError(f"VA {hx(va)} is outside raw sections") return exe[offset: offset + size] def all_refs(exe: bytes, sections: list[dict[str, Any]], value: int) -> list[int]: needle = struct.pack(" list[int]: needle = struct.pack(" dict[str, Any]: decoded = decode_stream(exe, sections, start_va, max_commands=max_commands, max_bytes=0x160) return { "startVa": start_va, "startVaHex": hx(start_va), "decodedCommandCount": decoded.get("decodedCommandCount", 0), "commands": [ { "vaHex": command.get("vaHex"), "opcodeHex": command.get("opcodeHex"), "opcodeName": command.get("opcodeName"), "length": command.get("length"), "summary": command.get("summary"), "rawHex": command.get("rawHex"), } for command in decoded.get("commands", []) ], } def c_string_list( exe: bytes, sections: list[dict[str, Any]], va: int, size: int = 0x100, limit: int = 16, skip: int = 0, ) -> list[str]: offset = va_to_offset(sections, va) if offset is None: return [] raw = exe[offset + skip: offset + skip + size] names: list[str] = [] for token in raw.split(b"\x00"): if not token: if names: break continue if len(token) == 4 and struct.unpack(" 0x00400000: continue if any(byte < 0x20 or byte > 0x7E for byte in token): break try: text = token.decode("ascii") except UnicodeDecodeError: break if "." not in text and "_" not in text and not text.isalnum(): break names.append(text) if len(names) >= limit: break return names def build_report() -> dict[str, Any]: exe = EXE.read_bytes() sections = read_sections(exe) top_refs = all_refs(exe, sections, TOP_MENU_OBJECT_SEQUENCE_VA) wrapper_refs = all_refs(exe, sections, TOP_MENU_WRAPPER_VA) pre_wrapper_refs = all_refs(exe, sections, TOP_MENU_PRE_WRAPPER_GATE_VA) reject_loop_refs = all_refs(exe, sections, TOP_MENU_REJECT_LOOP_VA) parent_refs = all_refs(exe, sections, TOP_MENU_PARENT_CONTEXT_VA) region6_refs = all_refs(exe, sections, STATUS_REGION6_CHILD_SCRIPT_VA) region3_refs = all_refs(exe, sections, RIGHT_PANEL_REGION3_CHILD_SCRIPT_VA) region4_refs = all_refs(exe, sections, RIGHT_PANEL_REGION4_CHILD_SCRIPT_VA) page_refs = all_refs(exe, sections, RIGHT_PANEL_REGION4_PAGE_SCRIPT_VA) intro_title_resource_names = c_string_list(exe, sections, INTRO_TITLE_RESOURCE_LIST_VA, skip=4) wrapper_call_raw = read_at(exe, sections, TOP_MENU_WRAPPER_CALL_COMMAND_VA, 8) wrapper_call_operand = struct.unpack_from(" str: summary = report["summary"] card_items = [ ("status", report["status"]), ("top seq", summary["topMenuObjectSequenceVaHex"]), ("top refs", summary["topMenuSequenceAllRefCount"]), ("pre-gate refs", summary["topMenuPreWrapperGateDirectRefCount"]), ("wrapper refs", summary["topMenuWrapperDirectRefCount"]), ("parent refs", summary["topMenuParentDirectRefCount"]), ("parent class", summary["parentContextClassification"]), ("opener", summary["normalFieldEscOpenerProven"]), ] cards = "".join(f"
{h(k)}{h(v)}
" for k, v in card_items) def render_commands(context: dict[str, Any]) -> str: return "".join( "" f"{h(command.get('vaHex'))}" f"{h(command.get('opcodeHex'))}
{h(command.get('opcodeName'))}" f"{h(command.get('summary'))}" f"{h(command.get('rawHex'))}" "" for command in context.get("commands", []) ) context_tables = "" for key, title in [ ("parentContext", "Parent Context 0x0047e624"), ("rejectLoop", "Reject Loop 0x0047e67c"), ("preWrapperGate", "Pre-wrapper Gate 0x0047e688"), ("wrapper", "Wrapper 0x0047e6a0"), ("topMenuSequence", "Top Menu Sequence 0x004ddc6c"), ]: context = report["contexts"][key] context_tables += f"""

{h(title)}

{render_commands(context)}
VAopcodesummaryraw
""" ref_rows = "".join( "" f"{h(row['label'])}
{h(row['vaHex'])}" f"{h(row['classification'])}" f"{h(', '.join(row['refsHex']) or '-')}" "" for row in report["referenceSurfaces"] ) negatives = "".join(f"
  • {h(item)}
    • " for item in report["negativeEvidence"]) next_frontier = "".join(f"
  • {h(item)}
    • " for item in report["nextFrontier"]) payload = json.dumps(report, ensure_ascii=False) html_doc = f""" HUD Menu Top Sequence Context Review
    index opener frontier selected-root frontier HUD menu preview JSON

    HUD Menu Top Sequence Context Review

    {h(summary["decision"])}

    {cards}

    Reference Surfaces

    {ref_rows}
    surfaceclassificationrefs
    {context_tables}

    Negative Evidence

      {negatives}

    Next Frontier

      {next_frontier}

    Raw JSON

    
  
    

    



"""
    return "\n".join(line.rstrip() for line in html_doc.splitlines()) + "\n"


def main() -> int:
    report = build_report()
    OUT.mkdir(exist_ok=True)
    WEB.mkdir(exist_ok=True)
    (OUT / "hud_menu_top_sequence_context_review.json").write_text(
        json.dumps(report, ensure_ascii=False, indent=2) + "\n",
        encoding="utf-8",
    )
    (WEB / "hud_menu_top_sequence_context_review.html").write_text(render_html(report), encoding="utf-8")
    print("hud_menu_top_sequence_context_review ok")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())