From e1f52ed330b17899bb38e9d778b908f90b3d33a2 Mon Sep 17 00:00:00 2001
From: =?utf8?q?J=C3=A9r=C3=B4me=20Benoit?= <jerome.benoit@piment-noir.org>
Date: Fri, 3 Jul 2026 01:50:19 +0200
Subject: [PATCH] docs(reforcexy): document optuna journal recovery

---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index 9b823ea..22c71e4 100644
--- a/README.md
+++ b/README.md
@@ -181,6 +181,12 @@ The documented list of model tunables is at the top of the
 The rewarding logic and tunables are documented in the
 [reward space analysis](./ReforceXY/reward_space_analysis/README.md).
 
+When `rl_config_optuna` uses `storage=file`, ReforceXY may quarantine a
+corrupt Optuna journal as `<original-journal-filename>.corrupt-<UTC>` and retry
+once with a fresh journal. This only affects file-backed Optuna storage. The
+`sampler`, `model_reward_parameters`, `PBRS`, and `&-action` behavior is
+unchanged.
+
 ## Common workflows
 
 **List running compose services and the containers they created:**
-- 
2.53.0