# CyberBrain26 LAB — Předávací Report **Datum:** 2026-09-10 **Fáze:** 3A & 3B — DOKONČENO **Stav:** Produkčně funkční LAB prostředí --- ## 1. Přehled CyberBrain26 LAB je izolované experimentální prostředí pro: - Testování nových funkcí bez rizika pro BETA/NEXT - Vývoj autonomních agentů (OpenClaw) - Sandbox pro neprověřený kód - Experimenty s novými rozhraními ### Umístění Prostředí | Cesta | Porty --- | --- | --- BETA | /home/oem/CyberBrain26 | 8080, 7682, 4000 NEXT | /home/oem/CyberBrain26-next | 8080, 7682, 4000 LAB | /home/oem/CyberBrain26-lab | 8180, 7782, 4100 --- ## 2. Běžící služby Služba | Port | Stav | Popis --- | --- | --- | --- Webapp (UI) | 8180 | status: ok | Hlavní rozhraní s konverzacemi, agenty, workspace SAFE-OI API | 7782 | status: ok | Schvalovací workflow pro kód (execution disabled) LiteLLM Proxy | 4100 | bez DB | Router pro bezplatná LLM API (gemini, mistral, groq, openrouter) ### Verze - Webapp: 3.1-memory-fixed - SAFE-OI: 0.6-phase1 - Konverzací: 29 - Agentů: 16 - Workspace: 11 --- ## 3. Jak spustit LAB ### 3.1 Start cd /home/oem/CyberBrain26-lab ./cb26-lab-start.sh Skript: 1. Zkontroluje projekt a virtuální prostředí. 2. Načte .env.lab (porty, cesty). 3. Zastaví běžící LAB procesy. 4. Spustí LiteLLM proxy (4100). 5. Spustí SAFE-OI API (7782). 6. Spustí Webapp (8180). 7. Otestuje všechny endpointy. ### 3.2 Stop cd /home/oem/CyberBrain26-lab ./cb26-lab-stop.sh ### 3.3 Kontrola stavu cd /home/oem/CyberBrain26-lab ./cb26-lab-check.sh --- ## 4. Jak se připojit ### 4.1 Lokálně (na serveru) Otevři v prohlížeži: http://127.0.0.1:8180 Test endpointů: curl http://127.0.0.1:8180/health | python3 -m json.tool curl http://127.0.0.1:7782/health | python3 -m json.tool ### 4.2 Vzdáleně (SSH + Tailscale) Z libovolného počítače s Tailscale: 1. Připoj se přes Tailscale: tailscale up 2. SSH tunel: ssh -L 8180:127.0.0.1:8180 -L 7782:127.0.0.1:7782 -L 4100:127.0.0.1:4100 oem@virtualmintcb26 3. Otevři v prohlížeži: http://127.0.0.1:8180 ### 4.3 Firewall Služby běží pouze na 127.0.0.1 (localhost). Pro přístup zvenčí je nutný SSH tunel. --- ## 5. Git a verze ### 5.1 Branch - Hlavní větev: lab/phase-3a - Remote: origin/lab/phase-3a - Poslední commit: 5b4ff8cb — "LAB: add cb26-lab-start.sh and fix SAFE-OI port to use env variable" ### 5.2 Bezpečnost Gitu - .env.lab je v .gitignore — nikdy necommituj secret hodnoty. - env.lab.example je bezpečná šablona pro ostatní. - memory/models/, *.onnx, *.bak jsou ignorovány. ### 5.3 Push změn cd /home/oem/CyberBrain26-lab git add . git commit -m "Popis změn" git push origin lab/phase-3a --- ## 6. Adresářová struktura /home/oem/CyberBrain26-lab/ - .env.lab (Konfigurace — NECOMMITOVAT) - env.lab.example (Šablona — BEZPEČNÁ) - cb26-lab-start.sh (Startovací skript) - cb26-lab-stop.sh (Stop skript) - cb26-lab-check.sh (Kontrola stavu) - webapp.py (Hlavní FastAPI aplikace) - scripts/safe_oi_api.py (SAFE-OI API — port z env) - litellm-proxy/config.yaml (Konfigurace LLM routeru) - openclaw/ (OpenClaw worker — read/write v workspace) - tests/ (Testovací skripty) - data-lab/ (LAB data) - logs-lab/ (LAB logy) - memory-lab/ (LAB paměť) - plugins-lab/ (LAB pluginy) - frontend-lab/ (LAB frontend) - workspaces/ (Git workspaces) - audit/ (Audit logy) --- ## 7. Bezpečnost ### 7.1 Izolace - LAB běží na oddělených portech (8180, 7782, 4100). - Žádný přístup k BETA/NEXT datům. - CB26_NETWORK_DEFAULT=DENY — síťový výstup zakázán. - CB26_AUTO_COMMIT=false, CB26_AUTO_PUSH=false, CB26_AUTO_DEPLOY=false. ### 7.2 OpenClaw - read_files: povoleno - write_files: pouze ve workspace + vyžaduje review - delete_files: vyžaduje review - run_commands: pouze allowlist - network_access: zakázáno - commit/push/deploy: zakázáno ### 7.3 Secrets - API klíče jsou pouze v .env.lab (není v Gitu). - LITELLM_MASTER_KEY chrání proxy přístup. - Žádné GitHub tokeny, AWS credentials, ani jiné secret hodnoty v repozitáři. --- ## 8. Logy Služba | Log soubor --- | --- LiteLLM Proxy | /tmp/cb26-lab-litellm.log SAFE-OI API | /tmp/cb26-lab-safeoi-api.log Webapp | /tmp/cb26-lab-webapp.log Pro kontrolu: tail -50 /tmp/cb26-lab-webapp.log --- ## 9. Řešení problémů ### 9.1 Služba neběží Zkontroluj porty: ss -tln | grep -E ":(8180|7782|4100)" Zkontroluj procesy: ps aux | grep -E "(webapp|safe_oi|litellm)" | grep -v grep Podívej se do logů: tail -50 /tmp/cb26-lab-webapp.log ### 9.2 Port je obsazený Zjisti, co běží na portu: lsof -i :8180 Zastav to: kill Nebo použij cb26-lab-stop.sh a restartuj ### 9.3 Git conflict Stáhni změny z remote: git pull origin lab/phase-3a Pokud je conflict, vyřeš ho: git mergetool Commitni a pushni: git add . && git commit -m "Resolve merge conflict" && git push origin lab/phase-3a --- ## 10. Další kroky (Roadmapa) ### Fáze 3C — Coding Workflow (ČÁSTEČNĚ) - [ ] Automatická tvorba Git worktree pro každý úkol. - [ ] Zápis povolen pouze ve worktree. - [ ] Reviewer agent kontroluje diff před merge. - [ ] Ruční tlačítko pro schválení patchů. ### Fáze 3D — VSCodium & Terminal (JEŠTĚ NEZAČATO) - [ ] Propojení řízeného rozhraní VSCodium pro LAB workspace. - [ ] Integrovaný omezený terminál s whitelistovanými příkazy. - [ ] Stop tlačítko pro přerušení úlohy. ### Fáze 4 — Modulární platforma (BUDOUCNOST) - [ ] Event bus implementace. - [ ] Task queue pro frontu úloh. - [ ] Více workerů paralelně. - [ ] Monitoring dashboard. --- ## 11. Kontakty a zdroje - GitHub: https://github.com/cybersecguru26/CyberBrain26 - Branch: lab/phase-3a - Dokumentace: LAB-STATUS.md, Projektovy-plan-a-architektura-CyberBrain26.md --- ## 12. Rychlý checklist pro převzetí - [ ] Nainstaluj Tailscale a připoj se k síti. - [ ] Přihlas se SSH: ssh oem@virtualmintcb26. - [ ] Spusť LAB: cd /home/oem/CyberBrain26-lab && ./cb26-lab-start.sh. - [ ] Ověř služby: ./cb26-lab-check.sh. - [ ] Otevři webapp: http://127.0.0.1:8180. - [ ] Projdi testy: cd tests && python3 -m pytest. - [ ] Přečti si LAB-STATUS.md a LAB-PREDAVACI-REPORT.md. --- LAB je připraveno k použití. Pokud máš otázky, podívej se do logů nebo se zeptej v issue na GitHubu.