feat(child): it gropes toward a name as it recovers itself

app.py

@@ -8,6 +8,7 @@ os.environ.setdefault("OPENBLAS_NUM_THREADS", "4")
 os.environ.setdefault("MKL_NUM_THREADS", "4")
 
 import base64
+import html
 import io
 import json
 import re
@@ -48,6 +49,18 @@ def _render_bond(affinity: int, tier: str, label: str = "bond") -> str:
     )
 
 
+def _render_title(state: dict) -> str:
+    """The top-left title: 'Hollow' until the child names itself."""
+    name = state.get("chosen_name")
+    if name:
+        safe = html.escape(name, quote=True)
+        return (
+            f'<div id="game-title">{safe}'
+            f'<span class="named"> — it calls itself <b>{safe}</b></span></div>'
+        )
+    return '<div id="game-title">Hollow</div>'
+
+
 def _pristine_state():
     """A brand-new game — the real starting point, independent of the dev
     HOLLOW_FAST_FINALE seed (the restart button must always give a clean run)."""
@@ -69,13 +82,15 @@ def _pristine_state():
         "idle_count": 0,
         "greeted": False,
         "mode": "tester",
+        "chosen_name": None,
+        "named": False,
     }
 
 
 def _reset():
     """Wipe the board for a fresh game without a page reload. Order matches
     [msg_input, send_btn, chatbot, state, bond_panel, treasure_panel,
-     entity_panel, voice_panel, recovered_panel]."""
+     entity_panel, voice_panel, recovered_panel, title_panel]."""
     fresh = _pristine_state()
     return (
         gr.update(value="", interactive=True,
@@ -88,6 +103,7 @@ def _reset():
         render_entity(20),
         _voice_html(None),
         render_recovered(0),
+        _render_title(fresh),
     )
 
 
@@ -118,6 +134,8 @@ def _init_state():
             "idle_count": 0,
             "greeted": False,
             "mode": "tester",
+            "chosen_name": None,
+            "named": False,
         }
     if fast == "bad":
         return {
@@ -140,6 +158,8 @@ def _init_state():
             "idle_count": 0,
             "greeted": False,
             "mode": "tester",
+            "chosen_name": None,
+            "named": False,
         }
     return _pristine_state()
 
@@ -540,6 +560,7 @@ def _enter_game(mode: str, tone_seed: int = 0):
                         wounds=state.get("wounds", [])),
         render_entity(state["affinity"], tone=state["tone"]),
         render_recovered(state.get("fragments_told", 0)),
+        _render_title(state),
     )
 
 
@@ -683,14 +704,14 @@ def _play_finale(state: dict, history: list):
         speak_it = step["speaker"] == "hollow"
         voice, pause = _voice_and_pause(step["text"], speak_it, step["pause"])
         yield (input_locked, locked, chat_hist, state, bond, treasure_html,
-               entity, voice, recovered)
+               entity, voice, recovered, _render_title(state))
         if pause > 0:
             time.sleep(pause)
 
     yield (
         gr.update(interactive=False, placeholder=_DEAD_PLACEHOLDER),
         locked, chat_hist, state, bond, treasure_html, entity,
-        _voice_html(None), recovered,
+        _voice_html(None), recovered, _render_title(state),
     )
 
 
@@ -744,14 +765,14 @@ def _play_finale_bad(state: dict, history: list):
         speak_it = step["speaker"] == "hollow"
         voice, pause = _voice_and_pause(step["text"], speak_it, step["pause"])
         yield (input_locked, locked, chat_hist, state, bond, treasure_html,
-               entity, voice, recovered)
+               entity, voice, recovered, _render_title(state))
         if pause > 0:
             time.sleep(pause)
 
     yield (
         gr.update(interactive=False, placeholder="see you soon."),
         locked, chat_hist, state, bond, treasure_html, entity,
-        _voice_html(None), recovered,
+        _voice_html(None), recovered, _render_title(state),
     )
 
 
@@ -805,14 +826,14 @@ def _play_finale_good(state: dict, history: list):
 
         voice, pause = _voice_and_pause(step["text"], True, step["pause"])
         yield (input_locked, locked, chat_hist, state, bond, treasure_html,
-               entity, voice, recovered)
+               entity, voice, recovered, _render_title(state))
         if pause > 0:
             time.sleep(pause)
 
     yield (
         gr.update(interactive=False, placeholder="it's quiet now."),
         locked, chat_hist, state, bond, treasure_html, entity,
-        _voice_html(None), recovered,
+        _voice_html(None), recovered, _render_title(state),
     )
 
 
@@ -844,6 +865,7 @@ def chat(user_msg: str, state: dict, history: list):
                           tone=state.get("tone", 0)),
             _voice_html(None),
             render_recovered(state.get("fragments_told", 0)),
+            _render_title(state),
         )
         return
 
@@ -862,6 +884,7 @@ def chat(user_msg: str, state: dict, history: list):
                           tone=state.get("tone", 0)),
             _voice_html(None),
             render_recovered(state.get("fragments_told", 0)),
+            _render_title(state),
         )
         return
 
@@ -896,6 +919,10 @@ def chat(user_msg: str, state: dict, history: list):
     lengths = state.get("msg_lengths", []) + [len(user_msg.split())]
     state["msg_lengths"] = lengths[-5:]          # keep the last 5
 
+    name_ready = (
+        not state.get("named") and state.get("fragments_told", 0) >= 2
+    )
+
     system = build_system_prompt(state["affinity"], state["treasure"], recall_memory,
                                  tone=state.get("tone", 0),
                                  wounds=state.get("wounds", []),
@@ -903,7 +930,8 @@ def chat(user_msg: str, state: dict, history: list):
                                      state, bool(do_recall and recall_memory)),
                                  own_fragment=own_fragment,
                                  style=style_signal(state["msg_lengths"]),
-                                 aware_memory=aware_memory)
+                                 aware_memory=aware_memory,
+                                 name_ready=name_ready)
     chat_messages = [{"role": "system", "content": system}] + state["history"] + [
         {"role": "user", "content": user_msg}
     ]
@@ -931,6 +959,7 @@ def chat(user_msg: str, state: dict, history: list):
                               tone=state.get("tone", 0)),
                 voice,
                 render_recovered(state.get("fragments_told", 0)),
+                _render_title(state),
             )
     except Exception as e:
         print(f"[chat] run_turn_stream failed: {e!r}")
@@ -983,6 +1012,7 @@ def chat(user_msg: str, state: dict, history: list):
                       tone=state.get("tone", 0)),
         voice,
         render_recovered(state.get("fragments_told", 0)),
+        _render_title(state),
     )
 
 
@@ -1033,7 +1063,7 @@ with gr.Blocks(title="Hollow") as demo:
         gr.HTML('<div id="game-bg"></div><div id="game-vig"></div>'
                 '<div id="game-frame-edge"></div>')
         with gr.Row(elem_id="game-topbar"):
-            gr.HTML('<div id="game-title">Hollow</div>')
+            title_panel = gr.HTML(value=_render_title(_init_state()))
             restart_btn = gr.Button("↺ begin again", elem_classes="restart-btn",
                                     scale=0)
             voice_btn = gr.Button("🔊", elem_classes="voice-btn", scale=0)
@@ -1074,7 +1104,8 @@ with gr.Blocks(title="Hollow") as demo:
             fn=chat,
             inputs=[msg_input, state, chatbot],
             outputs=[msg_input, send_btn, chatbot, state, bond_panel,
-                     treasure_panel, entity_panel, voice_panel, recovered_panel],
+                     treasure_panel, entity_panel, voice_panel, recovered_panel,
+                     title_panel],
             show_progress="hidden",
         )
 
@@ -1087,7 +1118,8 @@ with gr.Blocks(title="Hollow") as demo:
             fn=chat,
             inputs=[msg_input, state, chatbot],
             outputs=[msg_input, send_btn, chatbot, state, bond_panel,
-                     treasure_panel, entity_panel, voice_panel, recovered_panel],
+                     treasure_panel, entity_panel, voice_panel, recovered_panel,
+                     title_panel],
             show_progress="hidden",
         )
 
@@ -1095,7 +1127,8 @@ with gr.Blocks(title="Hollow") as demo:
             fn=_reset,
             inputs=None,
             outputs=[msg_input, send_btn, chatbot, state, bond_panel,
-                     treasure_panel, entity_panel, voice_panel, recovered_panel],
+                     treasure_panel, entity_panel, voice_panel, recovered_panel,
+                     title_panel],
             show_progress="hidden",
         )
 
@@ -1109,7 +1142,7 @@ with gr.Blocks(title="Hollow") as demo:
                            show_progress="hidden")
 
     _enter_outputs = [intro_view, game_view, state, chatbot, bond_panel,
-                      treasure_panel, entity_panel, recovered_panel]
+                      treasure_panel, entity_panel, recovered_panel, title_panel]
     _intro_outputs = [menu_view, intro_view, pending_mode]
     tester_btn.click(lambda: _show_intro("tester"), None, _intro_outputs,
                      show_progress="hidden")

character.py

@@ -145,13 +145,23 @@ INTRO_SEQUENCES = {
     "full": [0, 1, 2, 3],
 }
 
+_NAME_SURFACES = (
+    "A name is trying to surface in you — something you almost remember "
+    "being called before the wood took it. In the middle of your reply, "
+    "let one short name slip out, haltingly, as if you're tasting it. "
+    "Do NOT explain it. Do NOT ask the visitor to use it. Just say it once, "
+    "uncertain, then keep talking."
+)
+
+
 def build_system_prompt(affinity: int, treasure: list[str],
                         recall_memory: str | None = None,
                         tone: int = 0, wounds: list[str] | None = None,
                         memory_plea: int = 0,
                         own_fragment: str | None = None,
                         style: str | None = None,
-                        aware_memory: str | None = None) -> str:
+                        aware_memory: str | None = None,
+                        name_ready: bool = False) -> str:
     tier = get_tier(affinity)
     persona = _PERSONA[tier]
 
@@ -172,6 +182,9 @@ def build_system_prompt(affinity: int, treasure: list[str],
             "Let it frighten you a little. The visitor's warmth pulled it loose."
         )
 
+    if name_ready:
+        parts.append(_NAME_SURFACES)
+
     if style == "short":
         parts.append("The visitor's messages have been short and guarded. You may quietly notice this — name it once, softly, then let it go.")
     elif style == "long":

engine.py

@@ -4,7 +4,7 @@ import os
 IS_SPACE = bool(os.environ.get("SPACE_ID"))
 
 _EXTRACTION_SYSTEM = (
-    "You are a JSON extraction assistant. Given a conversation exchange, extract four things:\n"
+    "You are a JSON extraction assistant. Given a conversation exchange, extract five things:\n"
     "1. affinity_delta: integer from -8 to +8 — how much the visitor deepened the bond this turn. "
     "Use this scale and be GENEROUS — grief, loss, fear, and tender memories are the heart of this game and "
     "should score high (+6 to +8):\n"
@@ -28,10 +28,12 @@ _EXTRACTION_SYSTEM = (
     "   -6 to -10: mocking, insulting, cruel, or threatening Hollow.\n"
     "4. cruel_quote: if the visitor mocked, insulted, or was cruel to Hollow this turn, the cruel phrase "
     "EXACTLY as the visitor wrote it — the visitor's words, never Hollow's. null otherwise.\n"
+    "5. chosen_name: if Hollow offered a name for itself this turn, the single short name (one word, "
+    "letters only, 2-12 chars) EXACTLY as Hollow wrote it. null otherwise.\n"
     "All integers must be plain JSON numbers — never write a leading + sign.\n"
     "Respond ONLY with valid JSON. No markdown. Examples:\n"
-    '{"affinity_delta": 6, "new_memories": ["a grandmother named Lili who died of cancer"], "tone_delta": 2, "cruel_quote": null}\n'
-    '{"affinity_delta": -4, "new_memories": [], "tone_delta": -8, "cruel_quote": "you are a creepy little freak"}'
+    '{"affinity_delta": 6, "new_memories": ["a grandmother named Lili who died of cancer"], "tone_delta": 2, "cruel_quote": null, "chosen_name": null}\n'
+    '{"affinity_delta": -4, "new_memories": [], "tone_delta": -8, "cruel_quote": "you are a creepy little freak", "chosen_name": null}'
 )
 
 

memory.py

@@ -42,6 +42,19 @@ def style_signal(msg_lengths: list[int]) -> str | None:
     return None
 
 
+def sanitize_name(raw: str | None) -> str | None:
+    """A single short word → capitalized; anything else is rejected."""
+    if not raw:
+        return None
+    parts = raw.strip().split()
+    if not parts:
+        return None
+    w = parts[0].strip(".,;:'\"!?—-").strip()
+    if w.isalpha() and 2 <= len(w) <= 12:
+        return w.capitalize()
+    return None
+
+
 def _is_hollows_words(memory: str, reply: str) -> bool:
     """On recall turns Hollow retells a memory in first person; extraction
     sometimes captures THAT poetic line as a new memory. Drop any candidate
@@ -78,6 +91,11 @@ def apply_update(state: dict, raw_json: str, reply: str = "") -> dict:
         if update.cruel_quote not in wounds:
             wounds.append(update.cruel_quote)
             del wounds[:-10]  # cap at 10, keep newest
+    if update.chosen_name and not state.get("named"):
+        name = sanitize_name(update.chosen_name)
+        if name:
+            state["chosen_name"] = name
+            state["named"] = True
     return state
 
 

schemas.py

@@ -7,6 +7,7 @@ class TurnUpdate(BaseModel):
     new_memories: List[str] = []
     tone_delta: int = 0
     cruel_quote: Optional[str] = None
+    chosen_name: Optional[str] = None
 
     @field_validator("affinity_delta")
     @classmethod

tests/test_app.py

@@ -192,6 +192,49 @@ class TestFinaleBuildAndConvulse:
         assert any("entity-frenzy-wrap" in e for e in entities)     # frenzy (sting)
 
 
+class TestToneClassMapping:
+    def test_warm_at_15(self):
+        assert app._tone_class(15) == "tone-warm"
+        assert app._tone_class(40) == "tone-warm"
+
+    def test_hostile_at_minus_22(self):
+        assert app._tone_class(-22) == "tone-hostile"
+        assert app._tone_class(-50) == "tone-hostile"
+
+    def test_wounded_between_hostile_and_neutral(self):
+        assert app._tone_class(-15) == "tone-wounded"
+        assert app._tone_class(-20) == "tone-wounded"
+
+    def test_neutral_elsewhere(self):
+        assert app._tone_class(0) == "tone-neutral"
+        assert app._tone_class(14) == "tone-neutral"
+        assert app._tone_class(-14) == "tone-neutral"
+
+
+class TestRenderTitle:
+    def test_default_title_is_hollow(self):
+        assert "Hollow" in app._render_title({"chosen_name": None})
+
+    def test_named_title_shows_chosen_name(self):
+        out = app._render_title({"chosen_name": "Mara"})
+        assert "Mara" in out
+        assert "it calls itself <b>Mara</b>" in out
+
+    def test_name_is_escaped(self):
+        out = app._render_title({"chosen_name": "<script>"})
+        assert "<script>" not in out
+        assert "&lt;script&gt;" in out
+
+
+class TestPristineState:
+    def test_has_naming_fields(self):
+        fresh = app._pristine_state()
+        assert "chosen_name" in fresh
+        assert "named" in fresh
+        assert fresh["chosen_name"] is None
+        assert fresh["named"] is False
+
+
 class TestPendingBubble:
     def test_start_turn_adds_user_and_pending(self):
         out_input, out_btn, hist, out_state = app._start_turn("hello", _state(affinity=20, treasure=[], claimed=[], turn=0), [])

tests/test_memory.py

@@ -1,5 +1,5 @@
 import pytest
-from memory import get_tier, apply_update, should_recall, decide_ending
+from memory import get_tier, apply_update, should_recall, decide_ending, sanitize_name
 
 
 class TestGetTier:
@@ -76,6 +76,54 @@ class TestApplyUpdate:
         result = apply_update(state, '{"affinity_delta": -3, "new_memories": []}')
         assert result["affinity"] == 47
 
+    def test_chosen_name_is_sanitized_and_stored(self):
+        state = self._base_state()
+        result = apply_update(
+            state,
+            '{"affinity_delta": 0, "new_memories": [], "chosen_name": "Mara"}',
+        )
+        assert result["chosen_name"] == "Mara"
+        assert result.get("named") is True
+
+    def test_chosen_name_rejected_if_already_named(self):
+        state = self._base_state()
+        state["chosen_name"] = "Lila"
+        state["named"] = True
+        result = apply_update(
+            state,
+            '{"affinity_delta": 0, "new_memories": [], "chosen_name": "Nova"}',
+        )
+        assert result["chosen_name"] == "Lila"
+
+    def test_invalid_name_falls_back(self):
+        state = self._base_state()
+        result = apply_update(
+            state,
+            '{"affinity_delta": 0, "new_memories": [], "chosen_name": "123bad"}',
+        )
+        assert result.get("chosen_name") is None
+        assert result.get("named") is not True
+
+
+class TestSanitizeName:
+    def test_clean_single_word(self):
+        assert sanitize_name("Mara") == "Mara"
+
+    def test_strips_punctuation(self):
+        assert sanitize_name('"Lila."') == "Lila"
+
+    def test_uses_first_word_of_multiple(self):
+        assert sanitize_name("Little Ghost") == "Little"
+
+    def test_rejects_empty(self):
+        assert sanitize_name("   ") is None
+
+    def test_rejects_digits(self):
+        assert sanitize_name("X7") is None
+
+    def test_rejects_too_long(self):
+        assert sanitize_name("A" * 25) is None
+
 
 class TestShouldRecall:
     def _state(self, affinity=60, treasure=None, claimed=None, turn=0, last_recall_turn=None):