# CyberBrain26 — stav projektu a cesta k prvnímu produktu

**Datum:** 2. října 2026
**Větev / HEAD:** `master` / `b8c71d2` (`chore: close clean baseline checkpoint`)
**Verze:** 4.1.0
**Podklady:** `PROJECT_STATUS.md`, `BASELINE_REVIEW.md`, `EXECUTION_SECURITY_REVIEW.md`, `ROADMAP_V5.md`, `docs/product/*`

> Rozdělení slidů: **ověřeno** = doloženo kódem, testy nebo výstupem příkazů dnes;
> **návrh/hypotéza** = plán nebo předpoklad, který ještě nemá potvrzení trhu či bezpečnosti.

---

## 1. Hlavní závěr

- CyberBrain26 je **otestovaný Python prototyp**, ne produkční ani bezpečnostně certifikovaný systém — **ověřeno**.
- Bezpečnostní jádro (identita → politika → oprávnění → bezpečnost → audit) a autorizovaná exekuce přes Bubblewrap **fungují a jsou testované** — **ověřeno**.
- Repo není čistá vydatelná základna: pracovní strom má **84 stavových položek** (staged + unstaged + 22 untracked) — **ověřeno**.
- Komerční směr V5 (Agent Guard) je **schválený produktový záměr, ne ověřený trh** — tržní hypotéza.

---

## 2. Aktuální stav repozitáře (ověřeno)

| Metrika | Hodnota |
| --- | --- |
|Zdrojové soubory (Python) | 53 |
| Řádky kódu `src/` | ~10 200 |
| Testovací soubory | 15 (~3 800 řádků) |
| Zachycené testy | 291 |
| Ruff (lint) | bez chyb |
| mypy `src/cyberbrain26` | bez chyb (53 souborů) |
| pytest (dnes, tento stroj) | **290 prošlo, 1 selhal** |
| Bubblewrap | nainstalován (`/usr/bin/bwrap`) |

**Výjimka, kterou je nutné řešit:** `tests/test_model_layer.py::TestOllamaClient::test_is_available`
selhává, protože na tomto stroji běží Ollama na `localhost:11434` (model `dolphin-mistral`),
zatímco test předpokládá nedostupný provider. Tvrzení „291 passed“ z `PROJECT_STATUS.md`
dnes **nelze reprodukovat** — jde o test závislý na okolním prostředí, ne o chybu logiky.
Doporučení: oddělit testy s mockem od testů živého providera (`pytest.mark.integration`).

---

## 3. Co je skutečně implementované (ověřeno v kódu)

- **Control Plane:** asynchronní event bus, volatelná in-memory fronta, API a registry; volitelné durable named jobs v SQLite.
- **Security Plane:** identita, policy, permission, schvalování, audit, AI firewall, heuristická redakce PII, quality gates. Schválení i audit umí persistovat do SQLite.
- **Model Layer:** registry providerů, routing, klienti LiteLLM / Ollama / llama.cpp (bez ověření živých health checků).
- **Agent Layer:** planner, coder, evaluator, security, research, browser agent + Ptah orchestrace.
- **Execution Layer:** autorizovaná exekuce Pythonu a shellu přes Bubblewrap — namespaces, bez sítě, jen workspace je zapisovatelný, limity času/CPU/paměti/výstupu, **bez fallbacku na hosta**.
- **Data & Memory:** SQLite pro tasky, audit, schválení; projektová paměť s důvěryhodnostními štítky a keyword retrieval; lokální provenance hash.
- **Extension Layer:** 9 provider kontraktů (transport, tools, identity, credentials, execution, retrieval, provenance, event bus, telemetry).

---

## 4. Architektura — 10 rovin

```
core/ · control_plane/ · execution_plane/ · data_plane/ · security_plane/
governance_plane/ · experience_layer/ · personal_ai_layer/ · integration_layer/
extension_layer/ · (+ model_layer, agents, orchestration)
```

**Master princip —AUTONOMY ONLY ABOVE:**
IDENTITY → POLICY → PERMISSIONS → SECURITY → EVALUATION → AUDIT → GOVERNANCE

Model, planner ani agentní prompt **nejsou bezpečnostní autoritou**; každé volání nástroje
musí projít deterministickou autorizací před spuštěním.

---

## 5. Roadmap: co je hotové a co chybí

| Fáze | Stav |
| --- | --- |
| 0 Forensní audit | dokumentace existuje, historický inventář nebyl znovu validován |
| 1 Čistá základna | balíček, testy a CI existují; **release baseline neuzavřen** |
| 2 Control Plane | event bus/queue hotové; distribuovaní workeři otevřeni |
| 3 Security Foundation | hotovo pro lokální prototyp; trvalá persistence volitelná |
| 4 Modularita | kontrakty + in-memory registry; durable/distribuovaná implementace otevřena |
| 5 Model Layer | registry, routing, 3 klienti; živé health checky neprovedeny |
| 6 Agent Layer | prototypy rolí a Ptah, **nikoli** autonomní produkční agenti |
| 7 Execution | Bubblewrap Python/shell hotový; browser, Git, kontejnery, microVM otevřené |
| 8 Data & Memory | SQLite, paměť, provenance hotové; ChromaDB, Notebook, Knowledge Base otevřené |
| 9 Firewall & Privacy | heuristická redakce napojená na zápis do paměti; širší egress/MCP kontroly otevřené |
| 10+ Lab / governance / enterprise | převážně neimplementováno |

---

## 6. Bezpečnostní realita — co umíme a co ne (ověřeno)

**Enforcing ochrana:**
- `AuthorizedExecutionService`: identita → policy → oprávnění → volitelné schválení → audit **před** spuštěním.
- Bubblewrap: `--unshare-all`, `--new-session`, `--die-with-parent`, sestavuje systémové cesty read-only, workspace jako jediný zapisovatelný bind mount, oddělený `/tmp`, žádná zděděná proměnná prostředí.
- Fail-closed: chybějící Bubblewrap = chyba před spuštěním procesu, **žádný** host shell fallback; nepodporovaný jazyk = `ValueError`.

**Otevřené limity (z `EXECUTION_SECURITY_REVIEW.md`):**
- Chybí cgroup limity (celková paměť, počet procesů, I/O) a disk/inode kvóty workspace.
- Workspace je zapisovatelný host mount — pro nedůvěryhodný vstup nutná jednorázová úlohová kopie.
- Izolace závisí na podpoře namespace v jádře; úklid potomků po timeoutu nutno ověřit na každé podporované konfiguraci.
- SQLite audit je přístupově omezený, ale **nešifrovaný**; retence je logické smazání, ne bezpečné vymazání.
- Bubblewrap **není** schválený jako obecný sandbox pro libovolný nepřátelský kód — toto je posouzení kódu, ne certifikace.

---

## 7. Problém technického řízení (ověřeno)

- **Repozitář není čistý.** 84 položek ve `git status`; u řady cest existuje staged i unstaged verze současně (duální snapshot). Nic nebylo resetováno, smazáno ani commitnuto — uživatelská práce je zachována.
- `PROJECT_STATUS.md` uvádí 81 položek a „291 passed“ — dnes neplatí (84 položek; 290/1). Dokumentace se musí srovnat s realitou před každým externím použitím.
- Historické reporty v `.kilo/` jsou zastarané snapshoty, ne aktuální stav.
- CI (`.github/workflows/ci.yml`) je nakonfigurováno, ale hostovaný běh ještě neproběhl — rozdíly prostředí (Bubblewrap namespace) nejsou ověřené.

---

## 8. Komerční směr — CyberBrain Agent Guard (návrh, ne ověřený trh)

**Pracovní název:** CyberBrain Agent Guard — lokální kontrolní vrstva pro spouštění akcí AI agentů nad vývojářským repozitářem.

**Slib:** „Agent může pracovat ve vymezeném pracovním prostoru. Uživatel vidí a schvaluje akce, které mohou něco změnit, a po běhu má místní záznam o tom, co se stalo.“

- **Cílový kupující (hypotéza):** CTO / engineering / security lead v týmu ~10–100 vývojářů, který už používá coding agenty a chybí mu nezávislá lokální kontrola.
- **První forma:** jednouživatelská lokální instalace, Linux, CLI, jeden podporovaný agent, jeden demo scénář, lokální SQLite stav a audit.
- **Co to není:** obecný „AI operating system“, náhrada IDE, cloudová multi-tenant služba, certifikované compliance řešení ani záruka ochrany proti nepřátelskému kódu.

**Konkurenční riziko (otevvřeně):** schvalování, sandbox i audit jsou u Cursor, Claude Code, VS Code a Codex částečně zabudované. Naše výhoda musí být nezávislá vrstva **nad** existujícími agenty, ne součet jejich funkcí.

---

## 9. Plán po etapách (návrh)

| Etapa | Obsah | Výstup |
| --- | --- | --- |
| 0 | Ověřit, za co zákazník zaplatí (8–12 rozhovorů) | potvrzený problém + kandidáti na design partnera |
| 1 | Uzavřít výchozí stav: inventář pracovního stromu, čistá základna, opravit CI | opakovatelný build z čistého stavu |
| 2 | Jeden uživatelský scénář end-to-end (P0: schválení, běh, diff, audit) | nový uživatel zvládne scénář bez pomoci autora |
| 3 | Zpevnit hranice: cgroup kvóty, retry/cleanup testy, bezpečnostní review nasazení | přesně omezené bezpečnostní tvrzení |
| 4 | Placené piloty a produktové balení | alespoň jeden zaplacený pilot |
| 5 | Rozšíření jen podle placené poptávky | — |

Pracovní časový cíl: **první placený pilot 8–10 týdnů** od zahájení V5, otevřená beta ~10–14 týdnů. Odhad pro jednoho vývojáře na plný úvazek, **odhad, ne závazný termín**.

---

## 10. Metric gate — podle čeho se rozhodujeme

- **Bezpečnost:** 0 známých obejití policy a 0 nespolehlivých fallbacků v podporované cestě.
- **Srozumitelnost schválení:** uživatel umí vysvětlit, jakou akci schválil a jaké soubory se změní.
- **Instalace bez pomoci:** podíl testerů, kteří dokončí postup ze samotného návodu.
- **Obchod:** rozhovory → design partneři → zaplacený pilot → opakované použití.
- **Nepočítat jako pokrok:** počet rovin, agentních rolí nebo providerů (viz ROADMAP V5 §4.7).

**Rozhodovací brány:** po Etapě 0 (trh), 1 (čistá základna), 2 (self-service scénář), 3 (pravdivé bezpečnostní tvrzení), 4 (zaplacený pilot). Neprůjdeme-li bránou, roadmapa se zužuje — nerozšiřuje.

---

## 11. Okamžité další kroky (ověřená priorita)

1. Opravit test `test_is_available` tak, aby nebyl závislý na běžícím Ollama na vývojovém stroji, a srovnat `PROJECT_STATUS.md` s realitou.
2. Rozhodnout o 84 stavových položkách: co jde do release commitu, co archivovat, co rozdělit.
3. Rozjet nové CI na hostovaném runneru a ověřit Bubblewrap namespace podporu.
4. Načíst inventuru pracovního stromu podle `WORKING_TREE_INVENTORY_V5.md` a připravit 2–3týdenní MVP backlog.
5. Kickoff zákaznické discovery (8–12 rozhovorů) — před dalším kódováním, ne po něm.

---

## 12. Co prezentovat a co ne

| Tvrzení | Status |
| --- | --- |
| „Máme testované bezpečnostní jádro pro lokální autorizovanou exekuci“ | **ověřeno** |
| „CLI umí naplánovat a vykonat kroky v omezeném sandboxu“ | **ověřeno** |
| „Jsme bezpečnostní platforma pro libovolný kód“ | **nepravdivé — nepoužívat** |
| „Jsme certifikovaný/compliance produkt“ | **nepravdivé — nepoužívat** |
| „Bezpečnostně uvědomělí vývojáři za to zaplatí“ | **hypotéza k ověření** |
| „Roadmapa V5 je schválený plán“ | **návrh, vyžaduje potvrzení** |

**Princip prezentace:** prodávat ověřené schopnosti a otevřeně uvádět limity sandboxu a stav prototypu. Kontrolovat, aby nezaznělo „AI operating environment“ nebo „neprůstřelný sandbox“ — to je v rozporu s našimi vlastními bezpečnostními závěry.

---

## 13. Podrobnosti a reference

- Stav a ověření: `PROJECT_STATUS.md`, `BASELINE_REVIEW.md`
- Bezpečnost sandboxu: `EXECUTION_SECURITY_REVIEW.md`
- Produkt a roadmap: `ROADMAP_V5.md`, `docs/product/PRODUCT_BRIEF_V5.md`
- Trh a monetizace: `docs/product/MARKET_AND_MONETIZATION_ANALYSIS_V5.md`, `CUSTOMER_DISCOVERY_V5.md`
- Gap analýza MVP: `docs/product/MVP_GAP_ANALYSIS_V5.md`, `V5_FIRST_SPRINT_REPORT.md`

*Prezentace vygenerována z reálného stavu repozitáře; číselné údaje platné k 2. 10. 2026.*