# 05 – Tasks & Backlog (Changelog)

> Zentrales Log über **abgearbeitete Tasks** (Changelog) und das **offene Backlog**.
> Jeder abgeschlossene Arbeitsschritt an der Test-Suite wird hier als Eintrag dokumentiert –
> das beantwortet die Frage: *„Werden Tasks, die abgearbeitet werden, dokumentiert?"* → **Ja, hier.**

**Konvention:**
- Chronologisch, neuestens oben.
- Format: `### [YYYY-MM-DD] Kurztitel` + Stichpunkte (Geändert / Begründung / Impact).
- Offene Punkte wandern in §3 (Backlog), abgeschlossene in §2 (Changelog).
- **Trennung zu `CHANGELOG.md`:** Diese Datei = **Task-Changelog** (was an der Suite abgearbeitet wurde).
  Die **Versions-Historie** des Games + der Suite (z. B. `1.0.2`, Versionssprünge) lebt im Root-`CHANGELOG.md`.
  Große Changes gehören in **beide**.

---

## 1. Status-Snapshot

| Bereich | Status |
|---|---|
| Test-Suite (Audit / Self-Play / Perf / Report) | ✅ implementiert & lauffähig |
| Dokumentation (01–06) | ✅ überarbeitet & konsistent |
| CI-Definition | 🟡 dokumentiert (Workflow noch zu commiten) |
| Refactoring der Game-Datei | 🔵 Advisory-Backlog (siehe `06_Refactoring_Game.md`) |

---

## 2. Changelog (abgearbeitete Tasks)

### [2026-08-28] Doku-Nummerierung vereinheitlicht (01–06)

- **Geändert:** Drei veraltete Dateien (`01_Refactoring_Performance.md`, `02_Audit_Bericht.md`, `03_Automatisierung_SelfPlay.md`) mit altem „Game"-Framing entfernt.
- **Neu:** Kohärentes Set `01_Debug_API`, `02_Audits`, `03_Automatisierung_CI`, `04_Resultate_Report`, `05_Tasks_Backlog`, `06_Refactoring_Game`.
- **Begründung:** Repo ist eine **Test-Suite**, kein Spiel → Doku musste umfokussiert und neu nummeriert werden.
- **Impact:** Keine Code-Änderung; reine Dokumentation.

### [2026-08-28] Schemata gegen echten Code verifiziert

- **Geändert:** `selfplay-results.json`, `perf-result.json`, `audit-result.json`-Schemata in `03` und `04` an den tatsächlichen Skript-Output angepasst.
- **Geändert:** CI-Gate prüft jetzt `summary.fail` statt des nicht existierenden Felds `"failed"`.
- **Begründung:** Doku-Beispiele kollidierten mit der realen Ausgabe (falsche Feldnamen).
- **Impact:** CI-Beispiel läuft jetzt konsistent mit `audit-result.json`.

### [2026-08-28] README auf Test-Suite-Framing umgestellt

- **Geändert:** README beschreibt jetzt das **Test-/Audit-Projekt**, nicht das Spiel.
- **Neu:** Hinweis, dass `Aegis-Labyrinth.html` **manuell** in die Root gelegt werden muss.
- **Begründung:** User-Fokus: Suite testet & auditiert die extern eingelegte Game-Datei.
- **Impact:** Onboarding-Clairity für neue Nutzer.

### [2026-08-28] `report.mjs` als Artefakt-Generator dokumentiert

- **Geändert:** `04_Resultate_Report.md` mit `report.html`-Aufbau + „no data"-Verhalten.
- **Impact:** Klare Referenz, was `npm run report` erzeugt.

---

## 3. Offenes Backlog

> Priorität: **P0** = sofort, **P1** = kurzfristig, **P2** = später. Jede erledigte Aufgabe
> wandert nach oben in §2 (Changelog) mit Datum.

### Test-Suite / CI

| # | Prio | Task |
|---|---|---|
| 1 | P0 | `.github/workflows/ci.yml` aus `03_Automatisierung_CI.md` commiten & aktivieren |
| 2 | P0 | `Aegis-Labyrinth.html` + Test-Artefakte in `.gitignore` sicherstellen |
| 3 | P1 | CI-Secret `AEGIS_GAME_BASE64` anlegen (Game-Datei in CI bereitstellen) |
| 4 | P1 | Lighthouse-Job als eigene CI-Stufe ergänzen (Performance-Score ≥ 80) |
| 5 | P2 | Trend-Tracking: Lauf-Results als CSV/JSON-Artifact archivieren (Trend-Chart) |

### Robustheit der Skripte

| # | Prio | Task |
|---|---|---|
| 6 | P1 | Self-Play: deterministischer Seed für `Math.random()` (reproduzierbare Episoden) |
| 7 | P1 | Perf-Test: Heap-Delta (vorher/nachher) statt absoluter Werte → Leak-Heuristik |
| 8 | P2 | Optionaler Q-Learning-/MCTS-Bot (Outline in alter Doku, ggf. neu aufbauen) |

### Dokumentation

| # | Prio | Task |
|---|---|---|
| 9 | P1 | `01_Debug_API.md` um `effectTuning`/`effectLimits`-Detailfeld ergänzen, wenn es sich ändert |
| 10 | P2 | `report.html`-Screenshot/Beispiel als Referenz in `04` aufnehmen |

---

## 4. How-to: Neue Task dokumentieren

1. Task erledigen (Code / Doku / CI).
2. Oben in §2 einen Eintrag anfügen: `### [JJJJ-MM-TT] Titel` + Stichpunkte.
3. Falls noch offen: als Zeile in §3 eintragen, Priorität setzen.
4. Bei Abschluss: aus §3 entfernen und in §2 verschieben.