NOTES.md: Factor5-Sound von Stefan bestaetigt, Repo-Hygiene-Fund dokumentiert

NOTES.md

@@ -1234,3 +1234,53 @@ Spielmaterial/Musik, nur als Download fuer den Privatgebrauch, siehe
 Naechster Schritt weiterhin offen: echtes Gameplay (Tony auf `W1L0` bewegen).
 Sobald Stefan den richtigen Factor5-Song bestaetigt hat, kurzer Fix, dann
 weiter zu Gameplay.
+
+## Stand 23.07.2026, vormittags -- Factor5-Sound bestaetigt + Repo-Hygiene-Fund
+
+**1) Factor5-Sound ist bestaetigt richtig.** Stefan hat sich durch die
+Hoerproben gehoert und explizit `TITEL2_song1.wav` als den richtigen
+Factor5-"Brausen"-Sound zurueckgemeldet -- das ist exakt die Datei, die seit
+`af2ead1` schon eingebaut ist (`audio_paths.get(('TITEL2', 1))` in
+`run_once()`). Kein Code-Aenderung noetig, nur der offene Vorbehalt von
+22.07. ("nicht durch Reinhoeren verifiziert") ist jetzt erledigt.
+
+**2) Repo-Hygiene-Bug gefunden + gefixt (kein Stefan-Report, selbst
+entdeckt beim Nachschauen):** `tools/tfmx_player/render_tfmx.c` war in
+`origin/master` NICHT auf dem aktuellen Stand -- das Song-Index-Feature
+(noetig fuer genau obigen Factor5-Fix, TITEL2 Song 1 statt Song 0) existierte
+nur lokal auf der VM (`/home/aria/kellogg_remake`, gebaut, aber nie
+committet), nicht im Repo selbst. Ein frischer `git clone` + `build.sh`
+haette also einen Binary OHNE Song-Auswahl erzeugt -- jeder
+`render_wav(..., song_index=N)`-Call waere stillschweigend auf Song 0
+zurueckgefallen (kein Crash, aber h��rbar falscher Sound). Genau die Art
+1:1-Port-Bruch, die Stefan nicht will.
+
+Ursache: parallel zur Session ist ein zweiter Git-Checkout unter `/tmp`
+(tmpfs!) entstanden und dort unabhaengig weitergearbeitet worden, ohne vorher
+zu fetchen -- Historie ist auseinandergelaufen (zwei verschiedene Commits fuer
+denselben Hang-Fix). Nach Abgleich: `/home/aria/kellogg_remake` (die
+tatsaechliche Arbeitskopie) war fuer ALLE Dateien ausser dieser einen C-Datei
+schon 1:1 identisch mit `origin/master`. Fix: `render_tfmx.c` nachgezogen und
+committet (`a077dce`), der veraltete `/tmp`-Checkout mit den ueberholten
+Doppel-Commits verworfen (kein Datenverlust, deren Inhalt war ohnehin ein
+aelterer Zwischenstand als das, was schon auf `origin/master` lag).
+
+**Lehre / Infra-Aenderung:** der Arbeits-Git-Checkout fuer Commits/Pushes
+liegt jetzt dauerhaft unter `/home/aria/tony-remake-git` (statt `/tmp`,
+das ist RAM-tmpfs und wird bei jedem VM-Neustart geleert -- genau DAS hat
+den Doppel-Checkout ueberhaupt erst ermoeglicht). Kuenftige Sessions: dort
+weiterarbeiten, IMMER zuerst `git fetch && git status` gegen `origin/master`
+pruefen bevor neue Commits drauf, um erneutes Auseinanderlaufen zu vermeiden.
+
+**Naechster Schritt:** Der Factor5-Sound-Vorbehalt ist jetzt erledigt, die
+Intro-Sequenz ist damit inhaltlich fertig (Rauser -> Factor5 -> Kellogg's-Logo
+mit Vorhang+Scanlines -> Titelbild, alles mit korrektem Sound, freeze-frei).
+Zwei Baustellen bleiben offen, beide von Stefan noch nicht explizit
+beauftragt:
+  1. Der von Stefan gemeldete schwarze-Screen/Fenster-Haenger nach dem
+     Rauser-Intro sollte jetzt behoben sein (Hang-Fix oben) -- noch nicht von
+     Stefan nochmal getestet/bestaetigt.
+  2. Der naechste grosse inhaltliche Meilenstein bleibt unveraendert: echtes
+     Gameplay, Tony auf Level `W1L0` steuerbar machen (Map/Sprites/Kollision
+     sind alle schon fertig extrahiert, es fehlt nur noch die Spiellogik/der
+     eigentliche Python-Spiel-Loop).