# Dziennik zmian (dla Ciebie) **Format:** najnowsze wpisy **na górze**. Szukaj po dacie `YYYY-MM-DD HH:MM`. --- **2026-05-31 03:08** - Architektura: Key Pooling i Mixture of Experts (MoE) dla Roju (Swarm). - Backend teraz rotuje zapytania po wielu darmowych kluczach (`GEMINI_SWARM_KEYS` w `.env`) w razie zablokowania lub rate limit. - Dodano miksowanie modeli: lżejszy `2.0-flash` zajmuje się UI (m.in. CSS), a reszta Roju to miks `2.5-flash` z `2.0-flash`. - Ty zrób: Upewnij się, że zaktualizowałeś plik `.env` dopisując `GEMINI_SWARM_KEYS="klucz1,klucz2"`. Jeśli testy manualne przejdą, zrób `git commit` i `git push origin main`. **2026-05-30 20:30** - P1: przycisk „Podgląd” w Sequencer UI (preview + dev/start), testy resolvePreviewLink + import. - Gałąź `cursor/p1-operational-closure-2bbd` — po merge PR: `git pull origin main`. **2026-05-30 12:00** - Domknięcie V10.1: Swarm bez floor 15, Radar jsx/html, `/api/mission` → Oraculum, wersja `10.1.0`, cleanup RAM przy shutdown. - Gałąź: `cursor/v10-1-completion-f265` — po merge PR: `git pull` + ewentualnie `git push origin main` jeśli lokalny main był behind. **2026-05-30 04:00** - Przeniesiono stare testy do `legacy_tests/`. - Potwierdzono obecność nowych testów, dodano skrypt `"test:new": "node --test backend/tests/**/*.test.mjs"`. - Zaimplementowano funkcję importu projektów z zewnątrz (`/api/projects/import`) i interfejs z przyciskiem "Import Project" w aplikacji React. - Wymagany `git push origin main` jeśli zatwierdzasz te zmiany. ## 2026-05-30 03:00 — Wdrożenie pracy w pamięci RAM (Zero Disk Touch) - **Co:** Zrealizowano postulat RAM-first pipeline z Masterplanu V8. Utworzono moduł `ramWorkspaceManager.mjs` kopiujący pliki projektu do TMPFS (`os.tmpdir`) i przepisano Mózg (Orchestratora), by Rój operował wyłącznie na izolowanym RAM-ie, po czym atomowo zrzucał kod do właściwego folderu po sukcesie. - **Zrobiono:** Przepięcie zapisu plików przez operacje na nowym obiekcie. - **Ty zrób:** Nie musisz nic robić. Zmiany skomitowane i wypchnięte do GitHub origin. ## 2026-05-29 15:55 — Wdrożenie Architektury V10 SRE - **Co:** Zrealizowano 5 krytycznych poprawek z raportu audytu: asynchroniczne per-project kolejkowanie (`server.mjs`), wydłużenie lockTimeout do 90s (`lockManager.mjs`), ESM "sandbox ratunkowy" u Sędziego (`phantomVM.mjs`), Heurystyka Najdłuższego Bloku w logice sanitazycji (`sanitizeGeneratedCode.mjs`) oraz podpięcie Graftingu w Orkiestratorze. - **Ty zrób:** Możesz w spokoju obserwować stabilną pracę systemu, operacja SRE V10 została wdrożona na git. Pchanie do remote (git push) zrealizowano. ## 2026-05-29 15:15 — Przebudowa Sędziego (PhantomVM Frontend Bypass) - **Co:** Wyeliminowano awarie Sędziego na kodzie z React/JSX lub ESM (błędy `Cannot use import statement` i `Unexpected token`). Sędzia teraz ignoruje `node:vm` dla frontendu. - **Zrobiono:** Kod przesyła flagę `targetFile`. `PhantomVM` dynamicznie wykrywa JSX/importy/rozszerzenia, walidując jedynie drzewo AST za pomocą Babela, a uruchamia tylko stricte backendowe moduły CJS. - **Ty zrób:** Uruchom serwer i zrób test tworzenia komponentu React. Commit: `git commit -am "feat(phantomVM): bypass node vm execution for frontend and jsx files"` i `git push origin main`. ## 2026-05-29 15:06 — Audyt I/O i Sanityzacja Kodu (PhantomVM & CREATE_NEW_FILE) - **Co:** Naprawiono błędy z `Unexpected token ':'` oraz "uderzanie w ścianę" przy tworzeniu nowych plików. Zbudowano bezpieczny parser tagów markdown (`sanitizeGeneratedCode.mjs`), który nie usuwa ważnych znaków (jak typy TS). - **Zrobiono:** Dodano twarde tworzenie folderów (`mkdir {recursive: true}`) przed zapisami w `orchestrator.mjs` i `byteGrafter.mjs`. Zmieniono silnik czyszczący w `shotgunSwarm.mjs`. - **Ty zrób:** Zweryfikuj poprzez test E2E. Zrób commit: `git commit -am "fix(core): safe code sanitization and force recursive mkdir before I/O"` i push `git push origin main`. ## 2026-05-29 06:01 — Uszczelnienie Roju (Staggering i Prompt JS) - **Co:** Zaktualizowano `shotgunSwarm.mjs`. Wdrożono rygorystyczny prompt (zero TypeScriptu, zero formatowania markdown) oraz opóźnienie wyzwalania agentów (`250ms * index`), aby zapobiec przeciążeniom API. - **Zrobiono:** Zmiany w kodzie. Zmniejszono ryzyko błędu `Unexpected token ':'` u sędziego oraz `429/503` w API. - **Ty zrób:** Uruchom serwer testowo, stwórz commit `git commit -am "fix(swarm): staggering and strict JS prompt"` i wykonaj `git push origin main`. ## 2026-05-29 05:00 — SRE: Zabezpieczenia dla Pracy Nienadzorowanej - **Co:** Implementacja zabezpieczeń timeout, retries i mutex (SRE) przeciw zawieszaniu podczas overnight runs. - **Zrobiono:** Kod produkcyjny w `orchestrator.mjs`, `shotgunSwarm.mjs`, `phantomVM.mjs`, `oraculum.mjs`. - **Ty zrób:** Uruchom serwer testowo i commitnij zmiany. Jeśli działa, `git push origin main`. ## 2026-05-29 04:38 — Reaktywacja Sędziego i stabilizacja Reacta - **Co:** Wdrożenie planu naprawczego (Luki A, B, C i D). Dodano kolejkę zadań React do poprawnego renderingu manifestu Oraculum. Sędzia otrzymuje już `validationArgs`. Całkowicie usunięto martwy kod `assemblyWatcher.mjs`. - **Zrobiono:** Kod produkcyjny. Ekran nie migocze przy długim Manifeście. - **Ty zrób:** Uruchom serwer testowo i zweryfikuj wizualnie Swarm. Commit i push: `git add . && git commit -m "fix: react frontend mission queue, oracle analyzing state, passing validationArgs to PhantomVM, remove assemblyWatcher" && git push origin main`. ## 2026-05-29 04:25 — Konstytucja Projektu (Zasada Zerowych Halucynacji) - **Co:** Wygenerowano uniwersalny szablon `.project_rules` w głównym folderze `workspaces/`. Zawiera on 5 żelaznych dyrektyw technologicznych: zero halucynacji (praca na Radarze), kod na produkcję bez komentarzy, optymalizacja pod Node.js, absolutny zakaz połykania błędów oraz modularność na poziomie byte-splicingu. - **Stan:** Regulamin jest teraz centralnym punktem ładowanym automatycznie do System Promptu Oraculum przy każdej misji. - **Ty zrób:** Możesz zatwierdzić to rewizją: `git add .` i `git commit -m "feat: universal project rules constitution for zero hallucinations"` i wypchnąć na GitHuba. ## 2026-05-29 04:20 — Fuzja Rurociągu (Integracja Oraculum + Radaru) - **Co:** Wykonano fuzję logiki w `backend/server.mjs`. Z endpointu `/api/oraculum` wycięto stary kod tworzący mockowane szkielety. W to miejsce wstawiono 4-krokowy rurociąg: Wczytywanie regulaminów -> Mapowanie architektury Radarem -> Manifest ustrukturyzowany z Oraculum -> Asynchroniczna tablica `missions` przekazywana na zapleczu do Orkiestratora. - **Stan:** Backend jest oficjalnie zamknięty i ustrukturyzowany w ramach pełnej pętli decyzyjno-wykonawczej APEX 10. - **Ty zrób:** Możesz przetestować z frontendu działanie nowej asynchronicznej pętli pod kątem ewentualnych poprawek w wyświetlaniu zdarzeń w UI, a następnie wykonaj commit (`git commit -am "feat: fuse pipeline orchestrator with radar and oraculum native output"`) i wciśnij to na `main`. ## 2026-05-29 04:18 — Wdrożenie Radaru Architektury (Static Analysis Indexer) - **Co:** Zaimplementowano moduł `backend/ast/workspaceIndexer.mjs`, który błyskawicznie skanuje katalog projektu odrzucając np. `node_modules` i przy użyciu `@babel/parser` buduje lekką mapę wszystkich deklaracji (funkcji/klas). Pamięciożerne analizy są omijane poprzez ignorowanie ciał funkcji i wymuszony Garbage Collection. - **Stan:** Moduł przygotowany. W kolejnych etapach zostanie podpięty pod Mózg, aby wyeliminować halucynacje Oraculum. - **Ty zrób:** Upewnij się, że zmiany wejdą w skład commita (wykonaj `git add .` i `git commit -am "feat: lightweight workspace static analysis indexer"`), a następnie ewentualnie zrób `git push origin main`. ## 2026-05-29 04:10 — Wymuszenie czystego JSON z Oraculum (Architektura) - **Co:** Przebudowano bramkę Gemini (`aiGateway.mjs`) by wymuszała twardy format `application/json` oraz odchudzono Mózg (`oraculum.mjs`) ze starego zgadywania formatów. Nowe Oraculum operuje z dynamicznym wstrzykiwaniem regulaminu projektu (domainRules). - **Stan:** Kod `oraculum.mjs` i `aiGateway.mjs` zaktualizowany i gotowy. (Uwaga: stary rurociąg w `server.mjs` będzie wymagał aktualizacji do nowej struktury w kolejnym kroku). - **Ty zrób:** Aktualnie zrób ew. rewizję w kodzie i poczekaj z commitem do dostosowania `server.mjs` lub zrób `git commit -am "refactor: structured native json output for oraculum"`. ## 2026-05-29 02:22 — Wdrożenie In-Memory Byte-Range Lock Manager - **Co:** Zastąpiono planowane mechanizmy blokowania plików `.lock` przez asynchroniczny `LockManager` działający na przedziałach bajtowych AST w pamięci operacyjnej z detekcją kolizji. - **Stan:** Moduł gotowy (`backend/core/lockManager.mjs`) w pełni zabezpieczony timeoutami i unikalnymi ID. - **Ty zrób:** Upewnij się, że zrobisz commit (`git add .` i `git commit -m "feat: in-memory byte-range lock manager"`) oraz `git push origin main`. ## 2026-05-29 02:22 — Przebudowa shotgunSwarm.mjs (Uwolnienie Roju) - **Co:** Usunięto ograniczenia ilości agentów, skalując ich od 15 do 20 instancji. Wdrożono `MICRO_STYLES` wpływające na kod każdego agenta oraz obsługę `AbortController` i `Promise.any`, by skutecznie odrzucać przegranych i zachować stabilność aplikacji. Zoptymalizowano ucinanie komentarzy i markdownu w regexach. - **Stan:** Wszystko działa zintegrowane. Skrypt gotowy do agresywnego uderzania masowymi zapytaniami z szeroką temperaturą do szybkich i małych modeli (2.5-flash). - **Ty zrób:** Aktualnie zostanie wykonany commit i push na origin main na Twoje polecenie. ## 2026-05-29 01:46 — Zastąpienie recast przez byteGrafter.mjs (AST z hard byte-splicingiem) - **Co:** Usunięto starą, awaryjną bibliotekę `recast` i usunięto moduł `ast_grafter.mjs`. Zastąpiono go nowym modułem `byteGrafter.mjs` z "Bottom-Up Grafting", używając `magic-string` i twardych współrzędnych znakowych z `@babel/parser`. - **Stan:** Wszystkie moduły (`orchestrator.mjs` i `test_grafter.mjs`) zostały przepięte. Testy przeszły wzorowo. Zależność `recast` zutylizowana. - **Ty zrób:** Upewnij się, że zmiany wejdą w skład commita (wykonaj `git add .` oraz `git commit -m "feat: replace recast with byteGrafter for deterministic AST splicing"`), a następnie zrób `git push origin main`. ## 2026-05-28 23:55 — Archeologia i poszukiwanie zgubionych mechanik AST/Roju - **Co:** Wykonano pełen skan całego dysku, historii gita, staszy oraz archiwów w poszukiwaniu rzekomych starych mechanik (`magic-string`, `slice()`, 20-50 iteracji roju, "lock manager"). Udowodniono, że takie mechaniki kodowe nigdy fizycznie w projekcie nie istniały, a występowały jedynie w fazie planowania w dokumentach Markdown jako "byteGrafter". - **Stan:** Nic nie zostało zmienione ani skopiowane do folderu `recovery_zone`, ponieważ poszukiwane skrypty nie istnieją. - **Ty zrób:** Nie ma potrzeby nic robić, chyba że zechcesz faktycznie wdrożyć te wizjonerskie zapowiedzi z dawnych plików dokumentacji. ## 2026-05-28 22:51 — Ochrona rygoru danych przed CRLF - **Co:** Zablokowano konwersję końcówek linii LF na CRLF tworząc plik `.gitattributes` (`* text=auto eol=lf`) i wykonując lokalnie `git config core.autocrlf false`. Zapobiega to uszkodzeniu mapowania zakresów bajtowych AST w kontenerach Linux. - **Stan:** Konfiguracja repozytorium zabezpieczona dla rurociągu AST. - **Ty zrób:** Upewnij się, że zmiany wejdą w skład commita (wykonaj `git add .gitattributes` oraz `git commit -m "chore: secure LF line endings for AST"`), a następnie zrób `git push origin main`. ## 2026-05-28 22:30 — Nowoczesne Modele Gemini z rocznika 2026 i udany test E2E - **Co:** Wyeliminowano błędy API z wariantami `1.5` z powodu zaprzestania obsługi przez Google. Oraculum uderza teraz po logicznym gigancie `gemini-2.5-pro`, a z kolei Rój odpala zapytania po tanim (darmowym na API) i błyskawicznym `gemini-2.5-flash`. Test E2E przeszedł pomyślnie kończąc na zapisie AST. - **Stan:** System GEMA-0 APEX operuje od początku (Kokpit) do samego końca (Zapis piku) płynnie i bezbłędnie. Zaktualizowano logowania. - **Ty zrób:** Aby zakończyć, wpisz w terminal: `git add .` po czym `git commit -am "fix: use 2.5-pro for oracle and 2.5-flash for swarm"` i ostatecznie `git push origin main`. ## 2026-05-28 18:25 — Uzbrojenie PhantomVM i przepięcie Kokpitu - **Co:** Sędzia (PhantomVM) nie jest już atrapą - dynamicznie wykonuje w sandboxie node:vm testy zdefiniowane przez AI z pliku `30_mechanical_gate.json`, pilnując poprawności wyjścia i nieskończonych pętli (timeout 2000ms). W Kokpicie usunięto pola konfiguracji na rzecz czystego interfejsu (Oraculum decyduje samo). - **Stan:** Kod w `backend/core/phantomVM.mjs`, zaktualizowane przekazywanie zmiennych przez `orchestrator.mjs` -> `shotgunSwarm.mjs` -> `PhantomVM`. Przebudowany interfejs w `App.jsx`. Cały rurociąg gotowy na E2E. - **Ty zrób:** Uruchom pełen test przepływu (wpisz prompt w Oraculum, wymuś funkcję dodającą) by przetestować asercje Sędziego, zrób commit: `git commit -am "feat: dynamic PhantomVM tests validation with vm sandbox"` i wypchnij na `main`. ## 2026-05-28 18:20 — Moduł Oraculum i wdrożenie prawdziwego API Gemini - **Co:** Zainstalowano integrację z @google/generative-ai. Oraculum (Gemini 1.5 Pro) generuje strukturę kodu, a Shotgun Swarm (Gemini 1.5 Flash) atakuje 3 procesami. Zbudowano endpoint `/api/oraculum`, który zapisuje pliki na dysku podpadając pod Assembly Watcher. - **Stan:** Kod w `backend/ai/aiGateway.mjs`, `oraculum.mjs`, `shotgunSwarm.mjs` i `server.mjs`. Zabezpieczono crashe API (try/catch oraz AbortController). - **Ty zrób:** Zweryfikuj, użyj "Oracla" podając intencję misji, zobacz jak Orkiestrator przetwarza zadanie od początku do końca, po czym wykonaj `git commit -am "feat: oraculum module and shotgun swarm real API"` oraz `git push origin main`. ## 2026-05-28 05:25 — Most kodowy assembly -> misja (Watcher) - **Co:** Utworzono watcher (`assemblyWatcher.mjs`) i adapter dla `.gema0/assembly/`. Nowe foldery z zadaniami przekształcane są na strzały do Orkiestratora (`POST /api/mission`). Orkiestrator wspiera teraz `30_mechanical_gate.json` (wykonuje w terminalu). - **Stan:** Kod gotowy. Pliki `.lock` i `20_agent_report.md` zapobiegają podwójnemu wysłaniu. Zdarzenia wędrują na frontend. - **Ty zrób:** Przetestuj system, wrzuć zadanie do workspaces, a następnie utwórz commit `git commit -am "feat: most kodowy assembly -> misja, wsparcie mechanical gate"` i `git push origin main`. ## 2026-05-28 04:45 — Opcje Misji i Ochrona Orkiestratora przed Crashem - **Co:** W panelu Oracla dodano Target File Name i Operation Mode (CREATE_NEW_FILE/GRAFT_EXISTING_AST). Orkiestrator obsłuży brak AST przy `CREATE_NEW_FILE`, generując po prostu nowy plik i chroniąc node.js przed crashami (`AGENT_FAILED`). - **Stan:** Kod zaktualizowany w `App.jsx`, `server.mjs`, `orchestrator.mjs`. - **Ty zrób:** Przetestuj tryb CREATE_NEW_FILE. Potem zrób commit: `git add .`, `git commit -m "feat: add mission settings and prevent AST crash"`, `git push origin main`. ## 2026-05-28 04:15 — The Oracle (Frontend) spięty z Workspace Managerem - **Co:** Lewy panel "THE ORACLE" pozwala teraz na podgląd/tworzenie projektów oraz podanie opisu misji. Przycisk "SWARM_START" wysyła te dane wprost do endpointu `/api/mission`. - **Stan:** Kod w `frontend/sequencer-ui/src/App.jsx` (nowe stany React, API fetch requests). - **Ty zrób:** Możesz przetestować z przeglądarki nowy wygląd Oracla, potem dodaj zmiany do repo (`git add .`, `git commit -m "feat(ui): dynamic Oracle panel with projects and prompt"`, `git push origin main`). ## 2026-05-28 04:08 — Workspace Manager + zaktualizowana struktura misji - **Co:** Dodano moduł tworzący projekty w systemie plików (folder `workspaces/` ze strukturą `.gema0/strategic` i `assembly`), endpointy `GET` i `POST /api/projects`. Wymuszono przesyłanie kluczy `projectId` i `prompt` w payloadzie `POST /api/mission`. - **Stan:** Kod w `backend/server.mjs` i nowym pliku `backend/core/workspaceManager.mjs`. - **Ty zrób:** Zobacz zmianę kodu i ewentualnie zrób commit + `git push origin main`. ## 2026-05-20 — Dokumentacja zsynchronizowana z kodem - **Co:** roadmap, snapshot Gemini, masterplan — F2 live ✓, następny krok: time-travel - **Stan:** tylko docs (bez zmian w kodzie backend/frontend) - **Ty zrób:** opcjonalnie commit + `git push origin main` ## 2026-05-19 — Zamknięcie sesji: wszystko na GitHubie - **Co:** `gemini-gema/` (Gema Pro), roadmap, git FAQ; push `1a64691` - **Stan:** `main` = `origin/main`, working tree clean - **Ty zrób:** skonfiguruj Gema wg `gemini-gema/README_DLA_WLASCICIELA.md`; dalsza praca w Cursor + Gemini ## 2026-05-19 — Push na GitHub OK (`origin/main`) - **Co:** `git push origin main` — wypchnięto do `fc59b7d..c5fe98e` - **Stan:** `main` = `origin/main`, commit `c5fe98e` (instrukcje DLA_WLASCICIELA + V10) - **Ty zrób:** nic — backup na GitHubie aktualny ## 2026-05-19 17:00 — Instrukcje tylko dla właściciela + porządek V10 - **Co:** folder `_docs/DLA_WLASCICIELA/` (git, mapa, ten dziennik); V10 rozdzielone od `legacy/`. - **Commity (lokalnie):** m.in. `d385073`, `fc59b7d` — pełna lista: `git log -5 --oneline` - **Ty zrób:** `git push origin main` jeśli `git status` pokazuje `ahead of origin/main` - **Testy:** `npm run test:apex` — OK przy ostatniej kontroli ## 2026-05-19 14:40 — V10 zacommitowane lokalnie na main - **Co:** `backend/server.mjs`, `package.json` APEX 10.0.0, rozdzielenie legacy. - **Ty zrób:** push na GitHub (wtedy jeszcze nie wypchnięte — sprawdź `git status`) --- ## Szablon (kopiuj dla ręcznych notatek) ```markdown ## YYYY-MM-DD HH:MM — Krótki tytuł - **Co:** … - **Commity:** `hash` lub „brak” - **Ty zrób:** push / nic / sprawdź .env ``` --- *Starszą historię techniczną agentów zobaczysz w `_docs/AGENT_LOG.md` (dla AI — nie musisz czytać).*