feat: B2 — Hollow resurfaces your memories unprompted

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

app.py

@@ -7,7 +7,7 @@ from character import (FRAGMENT_TONES, OPENING_LINE, OWN_FRAGMENTS,
                        build_system_prompt)
 from engine import run_turn
 from finale import finale_steps, finale_steps_bad, finale_steps_good
-from memory import apply_update, get_tier, decide_ending, should_recall, style_signal
+from memory import apply_update, get_tier, decide_ending, pick_aware_memory, should_recall, style_signal
 from render import render_entity, render_treasure
 from voice import speak
 
@@ -45,6 +45,7 @@ def _pristine_state():
         "wounds": [],
         "ending": None,
         "fragments_told": 0,
+        "last_aware_memory": None,
         "voice_on": True,
         "msg_lengths": [],
     }
@@ -95,6 +96,7 @@ def _init_state():
             "wounds": [],
             "ending": None,
             "fragments_told": 2 if warm else 0,
+            "last_aware_memory": None,
             "voice_on": True,
             "msg_lengths": [],
         }
@@ -113,6 +115,7 @@ def _init_state():
             "wounds": ["you're nothing", "talking to you is a waste of time"],
             "ending": None,
             "fragments_told": 0,
+            "last_aware_memory": None,
             "voice_on": True,
             "msg_lengths": [],
         }
@@ -386,6 +389,11 @@ def chat(user_msg: str, state: dict, history: list):
             and state.get("tone", 0) >= FRAGMENT_TONES[told]):
         own_fragment = OWN_FRAGMENTS[told]
 
+    # B2: on non-recall turns (every 3rd), quietly resurface an earlier memory
+    aware_memory = None
+    if not (do_recall and recall_memory) and state["turn"] % 3 == 0:
+        aware_memory = pick_aware_memory(state, exclude=recall_memory)
+
     lengths = state.get("msg_lengths", []) + [len(user_msg.split())]
     state["msg_lengths"] = lengths[-5:]          # keep the last 5
 
@@ -395,7 +403,8 @@ def chat(user_msg: str, state: dict, history: list):
                                  ask_for_memory=(state["turn"] >= 3
                                                  and not state["treasure"]),
                                  own_fragment=own_fragment,
-                                 style=style_signal(state["msg_lengths"]))
+                                 style=style_signal(state["msg_lengths"]),
+                                 aware_memory=aware_memory)
     chat_messages = [{"role": "system", "content": system}] + state["history"] + [
         {"role": "user", "content": user_msg}
     ]
@@ -420,6 +429,9 @@ def chat(user_msg: str, state: dict, history: list):
     if own_fragment and not turn_failed:
         state["fragments_told"] = told + 1
 
+    if aware_memory and not turn_failed:
+        state["last_aware_memory"] = aware_memory
+
     state["history"].append({"role": "user", "content": user_msg})
     state["history"].append({"role": "assistant", "content": reply})
     state["turn"] += 1

character.py

@@ -103,7 +103,8 @@ def build_system_prompt(affinity: int, treasure: list[str],
                         tone: int = 0, wounds: list[str] | None = None,
                         ask_for_memory: bool = False,
                         own_fragment: str | None = None,
-                        style: str | None = None) -> str:
+                        style: str | None = None,
+                        aware_memory: str | None = None) -> str:
     tier = get_tier(affinity)
     persona = _PERSONA[tier]
 
@@ -146,4 +147,7 @@ def build_system_prompt(affinity: int, treasure: list[str],
             "'...no. that was yours. wasn't it?' Do this naturally, within the flow of the conversation."
         )
 
+    if aware_memory:
+        parts.append(f"Earlier the visitor told you: \"{aware_memory}\". You may bring it up unprompted, gently, as if it has been on your mind.")
+
     return "\n".join(parts)

memory.py

@@ -69,6 +69,17 @@ def apply_update(state: dict, raw_json: str, reply: str = "") -> dict:
     return state
 
 
+def pick_aware_memory(state: dict, exclude: str | None) -> str | None:
+    """An earlier memory Hollow may quietly resurface this turn: unclaimed, not
+    the one being recalled (`exclude`), not the one it just resurfaced. Returns
+    the newest eligible memory, or None if none fit."""
+    claimed = set(state.get("claimed", []))
+    last = state.get("last_aware_memory")
+    pool = [m for m in state.get("treasure", [])
+            if m not in claimed and m != exclude and m != last]
+    return pool[-1] if pool else None
+
+
 def should_recall(state: dict) -> tuple[bool, str | None]:
     if state["affinity"] < 45:
         return False, None

tests/test_memory.py

@@ -361,3 +361,18 @@ class TestStyleSignal:
         from memory import style_signal
         assert style_signal([]) is None
         assert style_signal([10, 12, 15]) is None
+
+
+class TestPickAwareMemory:
+    def test_picks_an_unclaimed_memory_not_the_recall_one(self):
+        from memory import pick_aware_memory
+        s = {"treasure": ["a", "b", "c"], "claimed": ["a"], "last_aware_memory": None}
+        assert pick_aware_memory(s, exclude="b") == "c"   # not claimed(a), not excluded(b)
+    def test_avoids_repeating_the_last_one(self):
+        from memory import pick_aware_memory
+        s = {"treasure": ["a", "b"], "claimed": [], "last_aware_memory": "b"}
+        assert pick_aware_memory(s, exclude=None) == "a"
+    def test_none_when_nothing_eligible(self):
+        from memory import pick_aware_memory
+        s = {"treasure": ["a"], "claimed": ["a"], "last_aware_memory": None}
+        assert pick_aware_memory(s, exclude=None) is None