diff --git a/docs/port/HANDOFF.md b/docs/port/HANDOFF.md index 60d9fdab..330f39d8 100644 --- a/docs/port/HANDOFF.md +++ b/docs/port/HANDOFF.md @@ -128,6 +128,20 @@ is untested and is the reading that would matter for authoring a default. ## 🔴 2026-08-30 — do not hardcode the menu's initial focus; the sources disagree +> ⚠️ **SUPERSEDED the same day — read this line before the section.** Both of its +> claims have been overtaken and neither still holds: +> * *"the sources disagree"* — **settled**. Initial focus on a fresh boot is +> **`NEW GAME`**, measured directly on two fresh boots, both the first menu entry. +> The reader that produced the conflicting `TUTORIAL` was two items out. +> → *"the item NAMES below were wrong, and initial focus is NEW GAME"* +> * *"never once run: whether focus persists"* — **it has been run**. The main menu +> **persists**; `EXTRAS` **resets**. → *"EXTRAS resets, the main menu persists"* +> +> Kept, not deleted, because it is what you were told at the time and a reader +> arriving by grep needs to know it was overtaken. Nothing below this line is +> current guidance. + + **New, and it is a warning rather than an answer.** `menu-navigation-semantics.md` records initial focus as **`TUTORIAL`** (2/2 boots). But `boot_menu.sh`'s own closing line says **`NEW GAME`**, and `menu-state-in-memory.md` reaches `EXTRAS` in