windgeschworen/docs/ROADMAP.md
danny 37f7ca4e5b CR 25: Tuerwechsel-Crash — Haertung + Forensik, Ursache noch offen
Untersuchung: In vier eskalierenden Reproduktions-Aufbauten (headless direkt,
Doppel-Trigger im selben Frame, windowed, windowed mit echtem
Physik-body_entered und stehender Absage) ueber 175+ Tuerwechsel kein Absturz
und kein einziger Fehlertext. Die Verdachtsstelle aus der CR
(zone_trigger-await) ist in Godot 4.7 nachweislich still: Coroutinen auf
freigegebenen Instanzen brechen stumm ab, gebundene Timer-Signale werden beim
Freigeben getrennt, freigegebene Objekte vergleichen sich gleich null. Die
gesamte freed-instance-Klasse scheidet als Ursache aus. Symptombild laut
Rueckfrage (Fenster minimiert sich, Standbild, wechselnde Tueren) passt zu
einem Stall oder Fokus-Verlust jenseits der Skript-Ebene — das laesst sich
erst mit einem echten Log belegen.

Trotzdem gehaertet, weil beim Suchen zwei echte (stille) Fehler auffielen:
zone_trigger stellt das Absage-Label jetzt ueber einen Kind-Timer statt await
zurueck — kein Zombie-Rest nach dem Wechsel. Und stirbt die Szene unter einem
laufenden Dialog weg (Auto-Start-Szenen wie Appell koennen mit einem
Tuertrigger um denselben Frame rasen), endete der Dialog vorher NIE: die
Autoload-Coroutine hing fuer immer im choose()-Await und legte die Box ueber
die neue Szene. DialogueSystem prueft jetzt pro Frame, ob die Sprecher noch
leben, und beendet den Dialog still; die Box kann eine offene Auswahl von
aussen aufloesen.

Forensik fuer den naechsten Vorfall: Log-Aufbewahrung auf 30 Dateien erhoeht
und jeder Tuerwechsel schreibt eine [tuerwechsel]-Zeile ins Log. Beim
naechsten Standbild die neueste Datei aus
%APPDATA%/Godot/app_userdata/Windgeschworen/logs/ sichern.

CR 25 bleibt in CHANGEREQUESTS.md als IN BEOBACHTUNG stehen. Die
Autoren-Docs dieser Runde (STIMMEN.md neu, SPEC/CHARACTERS-Anpassungen,
CR 25-27) fahren mit diesem Commit ein.

Verifiziert mit einer Regressions-Sonde (5/5: Kind-Timer aktiv, Wechsel mit
stehender Absage sauber, Dialog endet still bei toten Sprechern, 15 weitere
schnelle Wechsel) und einem Boot-Check ueber 13 Szenen; Sonden vor dem Commit
geloescht.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-21 20:20:45 +02:00

145 lines
9.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# ROADMAP.md — Windgeschworen
> Gewichtete Umsetzungs-Reihenfolge über den offenen Backlog aus
> **CHANGEREQUESTS.md**. Dieses Doc ordnet nur — die verbindlichen Details je CR
> stehen weiter in CHANGEREQUESTS.md, der Kanon in SPEC > STORY > WELT. Erledigte
> CRs wandern nach CHANGEREQUESTS_DONE.md; dann hier den Status nachziehen.
>
> Stand: **2026-07-21**. Erledigt: Phasen 0–11, CR 1–8 (8a–8e), CR 11–23 —
> **Wellen 0–3 und die Politur-Welle komplett**. v1 steht inhaltlich und ist
> rundgeschliffen. Offen: der Primitiven-Austausch **CR 24** (Folge-Schritt
> aus CR 23), danach Welle 4 (Akt 2: CR 9/10/8-magie/CR-16-Camp) und das
> eigene Kartenspiel (Stretch).
## Leitprinzip der Reihenfolge
Erst **Entscheidungs-Blocker räumen** (billig, schaltet Ketten frei), dann
**kleine isolierte Fixes** (stabilisieren den Build), dann den **großen
Kampf-Track** (höchstes Risiko, berührt viele v1-Systeme), dann **Flavor/Content**
auf fertigen Systemen, zuletzt die **Akt-2-Features** (jenseits v1).
## Kritischer Pfad
Der ursprüngliche Bau-Pfad (kleine Fixes → CR-8-Bau → Flavor) ist **vollständig
durchlaufen**; v1 steht inhaltlich.
**Jetzt: Politur-Welle** (CR 17–22 aus dem Akt-1-Testdurchlauf; CR 20 erledigt) — v1 rundschleifen,
bevor Akt 2 aufgemacht wird.
**Danach ist der Engpass kein Code, sondern Story:** **Akt 2 ist in STORY.md §9
ausdrücklich „noch auszuarbeiten"**. CR 9 (Bindungs-Achse), CR 10 (Drachenpflege)
und CR 8-magie hängen alle daran — ohne ausgearbeiteten Akt 2 lässt sich ihr Inhalt
nicht sinnvoll spezifizieren. **Welle 4 beginnt also mit Autoren-Arbeit**, nicht
mit Umsetzung.
---
## Welle 0 — Entscheiden & Fundament (PM/Planung) — ✅ erledigt
Reine Doc-/Design-Arbeit, kein Code. Beide Blocker sind geräumt:
- **CR 6 — zweite Siegelkraft.** ✅ Entschieden & ausspezifiziert (Roberts geheime
Kraft: gerade Verstorbene im 5–10-Min-Fenster zurückrufen; CHANGEREQUESTS §6).
Umsetzung → Welle 1.
- **CR 8 — Scope geschärft.** ✅ In **Sub-CRs 8a–8e** zerlegt (+ 8-magie für Akt 2),
alle Autoren-Entscheidungen gesetzt (Encounter-Zonen statt Welt-Sandbox;
Grammatik leicht/schwer/Ausweichen/Dodge/Magie/Kombo; Waffenskill pro Waffe ohne
Rohschaden-Bruch; Permadeath raus → CR 16). Details: CHANGEREQUESTS §8.
## Welle 1 — Kleine isolierte Stabilisierer — ✅ erledigt (2026-07-19)
- **CR 6 — Umsetzung des Zweitsignets** (Entscheidung steht, s. Welle 0). Klein,
weil in v1 nur latent: beim Dreschen zusätzlich zum regulären Siegelkraft ein
**fixes, geheimes zweites** hinter eigenem Flag setzen (nicht im normalen
Reveal zeigen), Daten für Roberts Kraft anlegen, Xaden-erkennt-es-Beat
(STORY §5). Betrifft `hatching_grounds.gd` + `signet_system.gd`.
- **CR 5 — Tyrveil ins Vierte Geschwader / Violets Staffel.** Klein,
self-contained. Staffel-Kameraden Violet/Rhiannon/Ridoc/Sawyer/Liam,
Staffelführer Dain; wirkt auf Formationen, Sparring-Paarungen, Staffel-Ansehen.
- **CR 14 + CR 15 zusammen — Karten-Cluster.** Aula (Gathering Hall) bauen +
verwaiste Schlafsaal-Tür entfernen (CR 14); Hub-Tor-Anordnung an die
Basgiath-Karte angleichen, Lehrtrakt-Bündelung (CR 15). Maßgeblich ist der Text
in ORTE.md, nicht das Referenzbild. **CR 14 ist Voraussetzung für CR 13.**
- **CR 16 — Permadeath raus → Speicher-/Camp-System.** Permadeath-Verdrahtungen
entkoppeln (Viadukt/Tag-9/Dreschen: „Game Over" → „letzter Spielstand"),
ESC-Menü-Save + Schlafen-Save; Camp erst Akt 2. Sinnvoll **vor** CR 8-Bau, weil
CR 8d ohnehin Tag-9 anfasst.
## Welle 2 — Der große Kampf-Track — ✅ erledigt (2026-07-19)
- **CR 8 — Action-RPG-Kampf-Umbau** nach den Sub-CRs **8a→8b→8c→8d→8e**. Die
dauerhaften Regeln des fertigen Systems stehen jetzt in **SPEC §6,
„Kampfsystem"**. Reichweite = **Encounter-Zonen** (Option B), kein
Welt-Sandbox. Berührt Sparring (ersetzt), Tag-9-Hinterhalt (QTE → echter Kampf),
Movement-Abgrenzung (Viadukt/Gauntlet bleiben Geschicklichkeit). Greybox-First;
gleiche DPR über alle Waffenklassen. **Magie-Kampf (8-magie) erst Akt 2.**
## Welle 3 — Flavor/Content auf fertigen Systemen — ✅ erledigt (2026-07-20)
Setzen auf bereits erledigte Systeme auf (CR 8 nicht nötig).
- ~~**CR 11 — Gefechtskunde-Karte (Devera).**~~ **ERLEDIGT (2026-07-20).**
Klick-Karte mit animierten Truppenbewegungen als `map_question`-Beat im
Unterricht; Buch-1-Zeitfilter eingehalten (Poromiel/Greife offen, Veneni
nur als Anomalien, die mit Wahrheit 1 verzahnen).
- ~~**CR 12 — „Blätter jagen".**~~ **ERLEDIGT (2026-07-20).** Treibende Blätter
im Hof, gefangen mit dem bestehenden Movement; speist Muster-Board und
Lexicon. Vater-Seiten selten und bewusst ohne Wahrheit-2-Enthüllung (eigene
Lexicon-Seite statt Muster-Board).
- ~~**CR 13 — Minispiele mit Einsatz**~~ **ERLEDIGT (2026-07-20).** Poker und
Messerspiel am Spieltisch der Aula, mit Marken, Staffel-Ansehen,
Beziehungswerten und echtem Verletzungsrisiko (Schnelligkeits-Malus). Das
**eigene Kartenspiel** war im CR als Stretch markiert und bleibt offen — es
steht als verschlanktes CR 13 in CHANGEREQUESTS.md.
## Politur-Welle — v1-Feinschliff — teilweise erledigt, Nacharbeit offen
CR 20 (Viadukt-Respawn), CR 18 (Viertes Geschwader), CR 21 (Blätter-Jagd) sind
bei einem zweiten Testdurchlauf des Autors bestätigt gut. **CR 17 (Poker) und
CR 19+22 (Schreibpass) waren zu knapp spezifiziert bzw. zu knapp umgesetzt** —
beim Nachprüfen (2026-07-21) kamen drei neue Findings raus, die den
ursprünglichen Abschluss korrigieren:
- **CR 25** — ein Türwechsel-Absturz, den der Autor beim erneuten Test
gemeldet hat (Verdacht: `zone_trigger.gd`, unbestätigt ohne Stack-Trace).
- **CR 26** — CR 19+22 hat nur 11 von 48 Dialog-Dateien wirklich geprüft (die
11 sind sauber verifiziert), 31 fehlen noch. Ursache: die CR-Formulierung
„Xaden zuerst, dann Violet/Imogen" wurde als „nur diese" statt „Priorität,
aber alle" gelesen.
- **CR 27** — Poker fühlte sich nicht wie Poker an (eine Setzrunde, kein
Kartentausch/-aufdecken). CR 17 hatte nie eine Variante festgelegt.
Autor-Entscheidung: **Texas Hold'em**, ersetzt die CR-17-Umsetzung komplett.
## Welle 4 — Akt 2 (jenseits v1)
Greifen erst nach Dreschen + erstem Flug; brauchen die CR-6-Basis.
- **CR 9 — Bindung als dritte Dialog-Achse** (verdeckter Smàladh-Wert 0–100 →
Siegelkraft-Stärke + Kanalisierungs-Ausdauer).
- **CR 10 — Drachenpflege** (Tagesslot am Flight Field) — speist CR 9.
Ton-Regel: Smàladh duldet Pflege erst, dann schätzt er sie.
- **CR 8-magie — Magie-Ebene des Kampfes** (Siegelkraft/Lesser Magic), verzahnt mit
CR 9. Erst nach der Bindung möglich.
- **CR 16 (Rest) — Camp** außerhalb Basgiaths als Speicher-/Schlafpunkt im Feld.
---
## Statusübersicht
| CR | Titel | Welle | Status |
|----|-------|-------|--------|
| 5 | Staffel/Geschwader-Setup | 1 | erledigt (2026-07-19) |
| 6 | Zweite Siegelkraft | 1 | erledigt (2026-07-19, latent; Ausspielung: Akt 3) |
| 7 | Stehendes Gauntlet-Rad | — | erledigt (2026-07-16) |
| 8 | Kampfsystem Action-RPG (8a–8e) | 2 | **erledigt** (2026-07-19, 8a–8e komplett) |
| 8-magie | Magie-Kampf | 4 (Akt 2) | offen |
| 9 | Bindungs-Achse (Akt 2) | 4 | offen |
| 10 | Drachenpflege (Akt 2) | 4 | offen |
| 11 | Gefechtskunde-Karte | 3 | erledigt (2026-07-20) |
| 12 | Blätter jagen | 3 | erledigt (2026-07-20) |
| 13 | Minispiele (Poker + Messerspiel) | 3 | erledigt (2026-07-20) |
| 13-Rest | Eigenes Kartenspiel | — | offen (Stretch, kein v1-Ziel) |
| 17 | Poker: echte Karten + Figuren am Tisch | Politur | **überholt von CR 27** — Setzrunden-Prototyp fühlte sich nicht wie Poker an, ersetzt durch Texas Hold'em |
| 18 | Viertes Geschwader (Ridoc/Sawyer/Liam/Dain) | Politur | erledigt (2026-07-21) — vier Dialogbäume, vier Figuren im Hof, Staffel-Appell als Gruppenszene; beim Nachtest bestätigt |
| 19 | Stimmen-Schreibpass (Dialoge) | Politur | **teilweise** (2026-07-21) — 11 von 48 Dateien wirklich geprüft und verifiziert; Rest siehe **CR 26** |
| 20 | Viadukt-Respawn-Fix (Bug) | Politur | erledigt (2026-07-21) — Respawn am Checkpoint; beim Nachtest bestätigt |
| 21 | Blätter-Jagd (Black-Flag-Gefühl) | Politur | erledigt (2026-07-21) — beim Nachtest bestätigt |
| 22 | Journal/Lexicon-Texte | Politur | erledigt (2026-07-21) |
| 25 | Absturz bei Türwechseln (Bug) | Politur | **in Beobachtung (2026-07-21)** — nicht reproduzierbar (175+ Wechsel sauber); Härtung + Log-Forensik drin, wartet auf nächsten Vorfall mit Log |
| 23 | Asset-Import-Grundausstattung (Quaternius) | Politur | **erledigt (2026-07-21)** — 296 Modelle sortiert unter `assets/models/`, Rig-Kompatibilität in `scenes/test/asset_pipeline_test.tscn` verifiziert |
| 24 | Primitiven-Austausch in den echten Szenen | Politur | offen — Folge-Schritt aus CR 23, Pipeline steht |
| 25 | Türwechsel-Absturz (Bug) | Politur | offen — Verdacht in `zone_trigger.gd`, Repro + Stack-Trace nötig |
| 26 | Stimmen-Schreibpass fertigstellen | Politur | offen — 31 von 48 Dialog-Dateien noch ungeprüft, vollständige Liste in CHANGEREQUESTS §26 |
| 27 | Poker → echtes Texas Hold'em | Politur | offen — ersetzt CR-17-Umsetzung komplett |
| 14 | Aula-Bau + Tür-Fix | 1 | erledigt (2026-07-19) |
| 15 | Hub-Layout an Karte | 1 | erledigt (2026-07-19) |
| 16 | Permadeath raus → Save/Camp | 1 (Camp: Akt 2) | erledigt (2026-07-19); Camp-Rest: Akt 2 |