# Instrukcja Krok po Kroku: Jak przetestować Panel (APEX V10)

Ten krótki poradnik poprowadzi Cię od pustego środowiska do działającej symulacji tworzenia aplikacji przez Rój Strzelb (Shotgun Swarm). Pokaże też w akcji nasze nowe zabezpieczenia SRE.

## Krok 1: Włączenie środowiska
1. Otwórz terminal w głównym katalogu `gema0/`.
2. Uruchom serwer backendowy APEX:
   ```bash
   npm run start
   ```
   *(Na ekranie powinieneś zobaczyć logo GEMA-0 APEX, porty i komunikaty o podłączeniu WebSocket)*
3. Otwórz **drugi, osobny terminal** (nie wyłączając pierwszego) w tym samym katalogu.
4. Uruchom środowisko deweloperskie dla Frontendu (Panelu):
   ```bash
   npm run ui:dev
   ```
   *(Zostaniesz poinformowany, że frontend ruszył, zazwyczaj na porcie `http://localhost:5173` lub podobnym)*

## Krok 2: Otwarcie Panelu (Sequencer UI)
1. W przeglądarce przejdź pod adres wygenerowany przez vite (np. `http://localhost:5173`).
2. W nagłówku powinieneś zobaczyć zielony znaczek **"Live"** z ikoną radia – to znak, że WebSocket poprawnie połączył się z `server.mjs`.

## Krok 3: Stworzenie projektu (Workspace)
1. W sekcji **"THE ORACLE"** po lewej stronie, w polu *"New project name..."* wpisz nazwę testową (np. `KalkulatorZyskow` albo `SzalonyPies`).
2. Kliknij ikonę Plusa (**+**).
3. W logach Timeline'u zobaczysz komunikat o utworzeniu nowego projektu. System stworzy automatycznie w tle odpowiedni folder w `workspaces/<nazwa_projektu>`.

## Krok 4: Wygenerowanie misji
1. Upewnij się, że z listy rozwijanej jest wybrany nowo stworzony projekt.
2. W polu **"Mission Prompt"** wpisz żądanie architektoniczne, np.:
   > *"Zbuduj skrypt, który pobierze dane z /api/users, wyliczy średni wiek, a potem wypluje wynik na konsolę. Nie używaj zewnętrznych bibliotek, oprzyj się o systemowy fetch."*
3. Kliknij przycisk **▶ SWARM_START**.

## Krok 5: Obserwacja (Magia pod maską)
Teraz wystarczy obserwować interfejs (Timeline + logi w prawym dolnym logu THE TIMELINE):
1. **Oraculum** przeanalizuje zadanie (pojawi się fioletowy wskaźnik "Analyzing...").
2. Kiedy mózg skończy, natychmiast wrzuci zlecenia do kolejki. Następnie uruchomi się system **Roju Strzelb (Shotgun Swarm)** (zobaczysz odpalenie 5 Agentów).
3. Dzięki nowej mechanice ujrzysz log typu: *"Rój strzelb odpalony dla tworzenia nowego pliku! (Próba 1/3)"*.
4. **Sędzia (PhantomVM)** odbierze kod w locie i skompiluje. Zobaczysz w logach, że albo wszyscy zostali odrzuceni za Syntax Error (wtedy wejdzie **Próba 2/3**), albo od razu Sędzia zatwierdzi ("Agent 3 wygenerował zawartość... Reszta zgilotynowana").
5. Oraculum po kolei stworzy pliki, doklei nowe procedury i zamknie misję komunikatem o sukcesie.

## Gdzie szukać wyników?
Jeśli system w UI zamelduje **"MISSION_SUCCESS"**, możesz wejść w IDE (Cursor) i sprawdzić folder:
`workspaces/KalkulatorZyskow/`
Znajdziesz tam wygenerowany czysty kod JavaScript oparty na Twoich instrukcjach, poprawnie przetestowany przez Sędziego!