Initial NTE history exporter

Initial NTE history exporter

Add a Windows live-capture exporter for NTE pull history with support for
Permanent Monopoly, Limited Monopoly, and Arc Miracle Box histories.

Included:
- live packet capture via Windows raw sockets
- CSV and JSON export generation
- normalized reward and banner mapping files
- Monopoly v7 Points Gift / Chase Reward classification
- Arc Miracle Box decoding with shared pity metadata
- timestamp grouping and UID generation
- Windows launcher scripts with admin prompting
- docs for usage, export format, limitations, and packet notes
- tests covering decoder behaviour and mapping consistency

Generated exports, captures, briefs, and local data are ignored for privacy.

src/nte_history_exporter/pool_mappings.py

@@ -0,0 +1,32 @@
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import Any
+
+PROJECT_ROOT = Path(__file__).resolve().parents[2]
+MAPPINGS_DIR = PROJECT_ROOT / "mappings"
+
+POOL_MAPPING_FILES = {
+    "permanent": "permanent_board.json",
+    "limited_character": "limited_character_board.json",
+    "arc_miracle_box": "arc_miracle_box.json",
+}
+
+
+def load_pool_mapping(pool_key: str) -> dict[str, Any]:
+    filename = POOL_MAPPING_FILES[pool_key]
+    return json.loads((MAPPINGS_DIR / filename).read_text(encoding="utf-8"))
+
+
+def load_pool_mappings() -> dict[str, dict[str, Any]]:
+    return {pool_key: load_pool_mapping(pool_key) for pool_key in POOL_MAPPING_FILES}
+
+
+def pool_meta_from_mapping(mapping: dict[str, Any]) -> dict[str, Any]:
+    return {
+        "id": mapping["banner"]["id"],
+        "name": mapping["banner"]["name"],
+        "system": mapping["system"]["name"],
+        "shared_pity": mapping["banner"]["shared_pity"],
+    }