From c722c91e2a0d54c1590998b6494c030937a5bf4a Mon Sep 17 00:00:00 2001
From: Igor Lins e Silva <4753812+igorls@users.noreply.github.com>
Date: Wed, 15 Apr 2026 08:54:23 -0300
Subject: [PATCH] test: document orphan-locale recovery for _temp_locale helper

---
 tests/test_entity_detector.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/tests/test_entity_detector.py b/tests/test_entity_detector.py
index 83e0798..50cb7d1 100644
--- a/tests/test_entity_detector.py
+++ b/tests/test_entity_detector.py
@@ -392,6 +392,11 @@ def _temp_locale(locale_code: str, entity_section: dict):
 
     Cleans up the file and clears every cache that depends on locale data on exit,
     even if the test fails or the entity section is invalid.
+
+    Note: writes into the real mempalace/i18n/ directory. If a test process is
+    SIGKILLed mid-test the orphan zz-test-*.json file will break test_all_languages_load
+    on the next run (the fixture lacks the required terms/cli/aaak sections).
+    Recover with `rm mempalace/i18n/zz-test-*.json`.
     """
     from mempalace import i18n
     from mempalace import entity_detector