#!/usr/bin/env python3
"""Build a compact movement review summary from candidate browser smoke."""
from __future__ import annotations
import argparse
import html
import json
from pathlib import Path
from typing import Any
ROOT = Path(__file__).resolve().parents[1]
OUT = ROOT / "out"
SOURCE_FILE = "candidate_movement_browser_smoke.json"
TOP_LEVEL_FIELDS = [
"status",
"base",
"url",
"trace",
"movementStepSound",
"movementBump",
"wallSlideFacing",
"partyTrailAnimation",
"fieldPoison",
"fieldPoisonPartialContinue",
"fieldPoisonCureContinue",
"fieldPoisonEffectContinue",
"fieldParalysisCureContinue",
"fieldParalysisMovement",
"fieldParalysisPartialContinue",
"checksum",
]
def load_json(path: Path) -> dict[str, Any]:
return json.loads(path.read_text(encoding="utf-8")) if path.exists() else {}
def build_summary(root: Path = ROOT) -> dict[str, Any]:
out_dir = root / "out"
path = out_dir / SOURCE_FILE
payload = load_json(path)
movement = {field: payload.get(field) for field in TOP_LEVEL_FIELDS if field in payload}
movement["snapshots"] = {
"trace": (payload.get("snapshots") or {}).get("trace") or {},
}
movement["sourceFile"] = f"out/{SOURCE_FILE}"
compact_size = len(json.dumps(movement, ensure_ascii=False, separators=(",", ":")).encode("utf-8"))
return {
"kind": "hwanse-movement-candidate-review-summary",
"source": "tools/summarize_movement_candidate_review.py",
"status": "ready",
"sourceFile": f"out/{SOURCE_FILE}",
"boundary": (
"Compact browser movement review contract. It keeps movement smoke strings and the "
"walk trace snapshot used by web/movement_review.html and web/map_occlusion.html; "
"raw movement smoke remains a build/audit/verifier input until those consumers are replaced."
),
"sourceSizeBytes": path.stat().st_size if path.exists() else 0,
"compactSizeBytes": compact_size,
"movement": movement,
}
def html_page(summary: dict[str, Any]) -> str:
movement = summary["movement"]
rows = "\n".join(
""
f"{html.escape(key)} | "
f"{html.escape(str(value))[:1000]} | "
"
"
for key, value in movement.items()
if key != "snapshots"
)
trace = movement.get("snapshots", {}).get("trace", {})
trace_rows = "\n".join(
""
f"| {html.escape(str(sample.get('label', '-')))} | "
f"{html.escape(str(sample.get('selectorHex', '-')))} | "
f"{html.escape(str(sample.get('sourceMatchesSelector', '-')))} | "
f"{html.escape(str(sample.get('projectionMatchesDraw', '-')))} | "
"
"
for sample in trace.get("samples", [])
)
return f"""
Movement Candidate Review Summary
Movement Candidate Review Summary
{html.escape(summary['boundary'])}
{html.escape(summary['sourceFile'])}: {int(summary['sourceSizeBytes']):,} bytes raw, {int(summary['compactSizeBytes']):,} bytes compact.
Fields
Trace Samples
| label | selector | source rect | projection |
|---|
{trace_rows}
"""
def write_outputs(summary: dict[str, Any], out_dir: Path = OUT) -> None:
out_dir.mkdir(parents=True, exist_ok=True)
(out_dir / "movement_candidate_review_summary.json").write_text(
json.dumps(summary, ensure_ascii=False, indent=2) + "\n",
encoding="utf-8",
)
(out_dir / "movement_candidate_review_summary.html").write_text(html_page(summary), encoding="utf-8")
def main() -> None:
parser = argparse.ArgumentParser()
parser.add_argument("--root", type=Path, default=ROOT)
args = parser.parse_args()
root = args.root.resolve()
write_outputs(build_summary(root), root / "out")
if __name__ == "__main__":
main()