Auto merge dev → main (#1324)

* update game files

* update files and capture raw spectra payload

BOT/utils.py

@@ -92,6 +92,19 @@ def replay_session_dir(session_id: str | int) -> Path:
 def replay_data_path(session_id: str | int) -> Path:
     return replay_session_dir(session_id) / "replay_data.json.gz"
 
+
+# When enabled, the unmodified Spectra payload is stored next to the transformed
+# replay (as RAW_replay_data.json.gz) so it can be pulled and re-processed later.
+# Toggle off by setting SRE_STORE_RAW_REPLAY=0 in the environment.
+STORE_RAW_REPLAY = os.getenv("SRE_STORE_RAW_REPLAY", "1").strip().lower() not in (
+    "0", "false", "no", "off", "",
+)
+
+
+def raw_replay_data_path(session_id: str | int) -> Path:
+    """Path to the unmodified Spectra payload for a session (pre-transform)."""
+    return replay_session_dir(session_id) / "RAW_replay_data.json.gz"
+
 # Dev team Discord user IDs (bot owner + trusted devs)
 DEV_DISCORD_IDS: set[int] = {
     1357793112277127290,