<!--
  TYLKO DLA WŁAŚCICIELA — NIE DLA AGENTA CURSOR
  Agenci: nie czytaj tego pliku. Szczegóły techniczne → 00_GEMA0_ULTIMATE_MASTERPLAN.md
  i 02_WIZJA_FRONTEND_NLE_SEQUENCER.md. Tu tylko skrót dla człowieka.
-->

# Roadmap GEMA-0 (dla Ciebie)

**Ostatnia aktualizacja:** 2026-05-20  
**Wersja produktu:** 10.0.0 (V10 APEX)

Jeden widok: **co jest**, **co teraz**, **co później**. Bez gałęzi gita i bez technicznego żargonu.

---

## Legenda

| Symbol | Znaczenie |
|--------|-----------|
| ✅ | Ukończone (działa lub jest w repo) |
| 🔧 | **Teraz** — sensowny następny krok |
| ⏳ | Później — nie gubić głowy, zrobimy kiedy indziej |
| 🗄️ | Archiwum — stary panel RPA, nie mieszać z V10 |

---

## ✅ Fundament V10 (backend) — gotowe

| # | Co to daje |
|---|------------|
| ✅ | Zapis zdarzeń (`events.ndjson`) — „taśma” dla UI |
| ✅ | Serwer V10 (`npm start`) — misje, status, WebSocket |
| ✅ | Sędzia kodu (Phantom VM) — składnia, timeout, ślad I/O |
| ✅ | Reguły śladu (`traceExpectations`) — np. wymuszony `tenant_id` |
| ✅ | Rój agentów (Shotgun Swarm) — kilka prób równolegle |
| ✅ | Wszczepianie kodu w plik (AST Grafter — recast/babel) |
| ✅ | Orchestrator — łączy cały proces |
| ✅ | Pierwszy test E2E — `npm run test:first` |

**Nie musisz tego ruszać**, chyba że coś się wywali w testach: `npm run test:apex` lub `npm run test:first`

---

## ✅ Interfejs (frontend) — F1 + F2 gotowe

| # | Co to daje |
|---|------------|
| ✅ | Wygląd Sequencera (oś czasu, tory, panel AST) — `npm run ui:dev` |
| ✅ | **Podłączenie na żywo (F2)** — WebSocket + demo misja (`npm start` + `npm run ui:dev`, badge „Live”) |
| ⏳ | Suwak „cofnij czas” (time-travel po zdarzeniach) |
| ⏳ | Tor Judge (osobna ścieżka śladu sędziego) |
| ⏳ | AST X-Ray z prawdziwego drzewa pliku (dziś: placeholder) |

Szczegóły techniczne (F1/F2): `_docs/02_WIZJA_FRONTEND_NLE_SEQUENCER.md` — **Ty nie musisz czytać**; wystarczy tabela powyżej.

**Demo live:** `npm run test:first` → terminal 1: `npm start` → terminal 2: `npm run ui:dev` → **SWARM_START**.

---

## 🔧 Co robimy **teraz** (kolejność)

1. **Time-travel** — suwak cofania osi czasu po `events.ndjson` (opcjonalnie tor Judge).
2. **Opcjonalnie:** klucz Gemini w `.env` — prawdziwe LLM zamiast mocka przy misjach.

*Jedna rzecz na raz — nie trzeba robić wszystkiego naraz.*

---

## ⏳ Później (nie gubimy — zapisane na później)

| Temat | Po co |
|-------|--------|
| Tree-sitter / Oracle automat | Tańsze planowanie bez wysyłania całego projektu do AI |
| ByteGrafter (magic-string) | Jeszcze precyzyjniejsze wklejanie w plik (dziś wystarcza recast) |
| Tor Judge + AST X-Ray na żywo | Pełna wizualizacja śladu I/O i drzewa pliku |
| Porządek starych gałęzi na GitHubie | Kosmetyka; **nie blokuje** pracy na `main` |

---

## 🗄️ Legacy (stary system)

Stary panel RPA, Python, supervisor → tylko folder `legacy/v2_monolith/`.  
**Nie rozwijamy tego jako V10.** Uruchomienie: `npm run start:legacy` (gdy naprawdę potrzebny).

---

## Jak ten plik żyje (żeby nie było bałaganu)

| Kto | Co robi |
|-----|---------|
| **Ty** | Czytasz tę stronę, gdy pytasz „co dalej?” |
| **Agent** | Nie czyta tego pliku; aktualizuje checkboxy w planach technicznych + wpis w `AGENT_LOG.md` |
| **Po większej zmianie** | Agent lub Ty: zmiana daty u góry + ewentualnie przesunięcie 🔧 / ✅ |

Historia **kiedy co było**: [02_DZIENNIK_ZMIAN.md](02_DZIENNIK_ZMIAN.md)

---

## Jedno zdanie na dziś

> **Backend i live UI (F2) stoją; następny sensowny krok to time-travel — suwak cofania osi czasu po zdarzeniach z serwera.**