Initial project version

2026-08-29 01:45:19 +02:00
commit ea2a2f2cbf
21 changed files with 2830 additions and 0 deletions
@@ -0,0 +1,95 @@
+# 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.