#!/usr/bin/env python3
"""Classify dynamic object-VM target +0 writers by root context.
The status-comment selector consumer reads object+0xa8+0 only after a status
payload binds object+0xa8 to 0x004576d8. A previous broad scan found 52
dynamic object-VM commands that write to local target offset +0, but none were
inside the status/menu payload.
This review prevents a false promotion: local target offset +0 is not enough.
The candidate root/resource contexts are battle effects, monsters, or field
object scripts, so they are object-local writers unless a status/menu base
binding is also proven.
"""
from __future__ import annotations
import html
import json
from collections import Counter, defaultdict
from pathlib import Path
from typing import Any
ROOT = Path(__file__).resolve().parents[1]
OUT = ROOT / "out"
WEB = ROOT / "web"
def load_json(name: str) -> dict[str, Any]:
try:
data = json.loads((OUT / name).read_text(encoding="utf-8"))
except FileNotFoundError:
return {}
return data if isinstance(data, dict) else {}
def h(value: Any) -> str:
return html.escape("" if value is None else str(value), quote=True)
def classify_context(row: dict[str, Any]) -> str:
cns = " ".join(row.get("linkedCns") or []).lower()
maps = row.get("fieldMaps") or []
if "btl_" in cns or any(name.startswith("z") for name in (row.get("linkedCns") or [])):
return "battle-or-monster-object-local"
if maps or "map_" in cns or "cara_" in cns:
return "field-object-local"
return "resource-object-local"
def build() -> dict[str, Any]:
indirect = load_json("status_comment_indirect_selector_writer_review.json")
target_rows = indirect.get("target0WriterCandidates", [])
if not isinstance(target_rows, list):
target_rows = []
root_groups: dict[tuple[str, str], list[dict[str, Any]]] = defaultdict(list)
for row in target_rows:
if isinstance(row, dict):
root_groups[(row.get("rootVaHex", ""), row.get("rootClass", ""))].append(row)
root_rows = []
class_counts: Counter[str] = Counter()
opcode_counts: Counter[str] = Counter()
status_menu_hits = 0
status_comment_hits = 0
status_backing_bind_hits = 0
for (root_va, root_class), rows in sorted(root_groups.items(), key=lambda item: item[0][0]):
maps = sorted({m for row in rows for m in (row.get("fieldMaps") or [])})
cns = sorted({c for row in rows for c in (row.get("linkedCns") or [])})
opcodes = Counter(row.get("opcodeHex", "") for row in rows)
contexts = Counter(classify_context(row) for row in rows)
context_class = contexts.most_common(1)[0][0] if contexts else "unknown"
class_counts[context_class] += len(rows)
opcode_counts.update(opcodes)
status_menu_hits += sum(1 for row in rows if row.get("inStatusMenuPayloadRange"))
status_comment_hits += sum(1 for row in rows if row.get("inStatusCommentPayloadRange"))
# None of these rows contains a proven 40 1b status backing bind in the
# previous scan. Keep an explicit column so future scans can promote it
# only if that binding is observed.
root_rows.append(
{
"rootVaHex": root_va,
"rootClass": root_class,
"candidateCount": len(rows),
"opcodeCounts": dict(opcodes),
"contextClass": context_class,
"fieldMapCount": len(maps),
"fieldMaps": maps[:16],
"linkedCnsCount": len(cns),
"linkedCns": cns[:20],
"statusBackingBindProven": False,
"sampleCommandVaHexes": [row.get("commandVaHex", "") for row in rows[:8]],
}
)
summary = {
"target0CandidateCount": len(target_rows),
"uniqueRootCount": len(root_rows),
"opcodeCounts": dict(opcode_counts),
"contextClassCounts": dict(class_counts),
"statusMenuPayloadHitCount": status_menu_hits,
"statusCommentPayloadHitCount": status_comment_hits,
"statusBackingBindHitCount": status_backing_bind_hits,
"statusCommentWriterPromoted": False,
"decision": (
"The 52 target +0 dynamic writes are object-local active-script/resource writers. "
"They do not occur inside status/menu payloads and no 0x004576d8 backing-base bind is proven, "
"so they must not be promoted as the status comment story/chapter selector writer."
),
}
return {
"version": 1,
"kind": "hwanse-status-comment-target0-writer-context-review",
"sourceArtifacts": ["out/status_comment_indirect_selector_writer_review.json"],
"summary": summary,
"rootRows": root_rows,
"candidateRows": target_rows,
}
def render_html(data: dict[str, Any]) -> str:
cards = "".join(
f"
{h(k)}{h(v)}
"
for k, v in data["summary"].items()
)
rows = "".join(
"
"
f"
{h(row['rootVaHex'])} {h(row['rootClass'])}
"
f"
{h(row['candidateCount'])}
"
f"
{h(row['contextClass'])}
"
f"
{h(row['opcodeCounts'])}
"
f"
{h(', '.join(row['fieldMaps']))}
"
f"
{h(', '.join(row['linkedCns']))}
"
f"
{h(row['statusBackingBindProven'])}
"
f"
{h(', '.join(row['sampleCommandVaHexes']))}
"
"
"
for row in data["rootRows"]
)
return f"""
Status Comment Target +0 Writer Context Review