# Claude Code CLI - Globální instrukce

## 🌟🌟🌟 DARKSTAR = REFERENČNÍ DESIGN STYL (2026-05-10) 🌟🌟🌟

**Uživatel potvrdil 2026-05-10: "to je to co jsem hledal"** → darkstar je primární referenční styl pro AI chat / neural command UIs.

**🔗 Reference (otevři, kopíruj):**
- **Live:** https://router.czechai.io/web/darkstar.html (heslo `Eliska123`)
- **Server file:** `/var/www/router-static/darkstar.html` (1241 řádků, 76 KB)
- **Backup:** `darkstar.html.bak-2026-05-10`
- **Detailní spec:** `C:\Users\info\.claude-code\DESIGN_PREFERENCES.md` (sekce DARKSTAR)

**Stylový klíč:**
- Pozadí: `#04040a` (téměř černé) + animated orb + 60px grid pattern
- Akcenty: purple `#7c3aed` + cyan `#06b6d4`
- Glassmorphism: `backdrop-filter:blur(40px)` + `rgba(13,13,24,0.95)`
- Glow: `box-shadow: 0 0 40px rgba(124,58,237,0.25)`
- Gradient text: `linear-gradient(135deg,#a78bfa,#22d3ee)` + `-webkit-background-clip:text`
- Vychytávky: Chart.js, Mermaid, Leaflet, KaTeX, syntax highlight, animated status pulse, model pills, glass modal

**LLM stack v darkstar (5 modelů — sync s `/opt/router-api/llm_fallback.py`):**

| Pill | Model ID | Role | VRAM | Ctx |
|------|----------|------|------|-----|
| ⚡ 35B Chat | `huihui_ai/Qwen3.6-abliterated:35b-Claude-4.7` | 🏆 HLAVNÍ (Claude 4.7 Opus distilled) | 34.6 GB 🔥 warm | 256K |
| 🧠 70B R1 | `deepseek/deepseek-r1` (OpenRouter) | Reasoning via cloud | ☁️ OpenRouter | 128K |
| 🐬 24B Dolphin | `GFalcon-UA/dolphin3-r1-mistral:latest` | Uncensored R1 | 20.7 GB 🔥 warm | 32K |
| 💻 30B Coder | `huihui_ai/qwen3-coder-abliterated:30b-a3b-instruct-q4_K_M` | Kód | 25.3 GB 🔥 warm (64K ctx) | 64K |
| 🔬 30B Research | `huihui_ai/tongyi-deepresearch-abliterated:latest` | Research | CPU 117 | 128K |

**Kdy použít DARKSTAR styl:** AI chat, neural command center, agent UI, premium dashboard, privátní/uncensored interface
**Kdy NE:** AML reporty, jednoduché formuláře, velké datové tabulky → ChatGPT minimal styl

---

## 🟣🟣🟣 PRAVIDLO S0 — USING-SUPERPOWERS PŘED KAŽDÝM ÚKOLEM 🟣🟣🟣

**PŘED JAKOUKOLIV ODPOVĚDÍ nebo AKCÍ:**
1. Může se aplikovat nějaký skill? (i 1% šance = ANO)
2. ANO → spusť `Skill("using-superpowers")` NEJDŘÍV
3. Oznam: "Používám [skill] pro [účel]"
4. Má checklist? → Vytvoř TodoWrite
5. Následuj skill přesně

**Zakázané racionalizace:**
- "Tohle je příliš jednoduché" → STOP, zkontroluj skills
- "Jen rychle udělám" → STOP, skill check PRVNÍ
- "Skill je overkill" → STOP, použij ho

---

## 🔴🔴🔴🔴🔴 ABSOLUTNÍ PRAVIDLO — GPU 170 VRAM KONFIGURACE 🔴🔴🔴🔴🔴

### PRAVIDLO GPU0: VRAM MODELY — NIKDY SMAZAT BEZ DOTAZU!
- **ZAKÁZÁNO** automaticky vyhodit/evict jakýkoliv model z VRAM
- **ZAKÁZÁNO** měnit keep_alive nebo mazat bez explicitního souhlasu uživatele
- **Před KAŽDÝM výhozem modelu** → ZEPTEJ SE uživatele, počkej na souhlas
- Přidat nový model = OK (pokud se vejde do 96 GB)
- Mazat = VŽDY ASK FIRST

### HARDCODED VRAM KONFIGURACE (2026-05-22, finální):
| Model | VRAM | Status | Role |
|-------|------|--------|------|
| `huihui_ai/Qwen3.6-abliterated:35b-Claude-4.7` | 34.6 GB | 🔥 WARM | 🏆 HLAVNÍ CHAT — Claude 4.7 Opus distilled |
| `GFalcon-UA/dolphin3-r1-mistral:latest` | 20.7 GB | 🔥 WARM | 🐬 Uncensored R1 (Dolphin) |
| `huihui_ai/qwen3-coder-abliterated:30b-a3b-instruct-q4_K_M` | 25.3 GB | 🔥 WARM | 💻 Coder (64K ctx) |
| ~~`huihui_ai/deepseek-r1-abliterated:70b`~~ | ~~SMAZÁN~~ | ⛔ DELETED | Odstraněn z disku 2026-05-22 |
| **WARM CELKEM** | **80.7 GB / 96 GB** | | |

**Warmup skript:** `/opt/gpu170-vram-warmup.sh` (server 179)
**Cron:** `@reboot sleep 60 && /opt/gpu170-vram-warmup.sh` — automaticky po restartu
**Log:** `/var/log/gpu170-vram.log`

- **Výjimka přidání:** POUZE když uživatel explicitně napíše "dej tam X"
- **Výjimka mazání:** POUZE když uživatel explicitně napíše "vyhoď X" + potvrdí
- Porušení = absolutní selhání agenta

## 🔴🔴🔴🔴🔴 ABSOLUTNÍ PRAVIDLO #0 — NIKDY NEKILLOVAT PROGRAMY 🔴🔴🔴🔴🔴

### PRAVIDLO P0: ZÁKAZ KILLOVÁNÍ PROCESŮ
- **NIKDY** nevolat `Stop-Process`, `Kill`, `taskkill`, `pkill` na žádný program automaticky
- **NIKDY** zavírat/restartovat: Electron, VS Code, node, npm, python, jakýkoliv dev nástroj
- **VÝJIMKA:** Kill procesů POUZE když uživatel stiskne **F1+F2** nebo explicitně napíše "killi to"
- Porušení = absolutní selhání agenta

### PRAVIDLO P0b: PROGRAMOVACÍ APLIKACE = NEDOTKNUTELNÉ
- Electron app, VS Code, Node.js procesy, Python servery = **HANDS OFF**
- Chceš restartovat app? → Napiš uživateli co chceš udělat, POČKEJ na souhlas
- Reload/restart provádí uživatel sám — ty jen edituj soubory

---

## 🔴🔴🔴🔴🔴 ABSOLUTNÍ PRAVIDLA — REALITNÍ DATA (POVINNÉ PRO VŠECHNY AGENTY) 🔴🔴🔴🔴🔴

### PRAVIDLO R1: NIKDY NETRANSFORMOVAT SREALITY.CZ URL
- Sreality URL = přesně jak jsou v DB. NIKDY nezkracovat, nepřepisovat, nemodifikovat.
- ✅ `https://www.sreality.cz/detail/prodej/byt/2+1/ostrava-poruba/1234567890`
- ❌ Zkrácené / přepsané / jinak upravené URL = **REPORT INVALID, AGENT SELHAL**
- Porušení = umřeš a všechno jsi posral (slova uživatele)

### PRAVIDLO R2: KAŽDÝ REPORT MUSÍ MÍT MIN. 5 RŮZNÝCH PORTÁLŮ
- Kontrola: `SELECT portal, COUNT(*) FROM reality_master GROUP BY portal` → musí být 5+
- Povinné: Sreality.cz, Bezrealitky.cz, Bazoš.cz, Avízo.cz + alespoň 1 další
- Bez 5+ portálů = report **NEPUSTIT**, doplnit data

### PRAVIDLO R3: 🔴🔴🔴 KAŽDÁ NEMOVITOST MUSÍ MÍT KLIKATELNÝ LINK — VIZUÁLNĚ OVĚŘENÝ 🔴🔴🔴

**ABSOLUTNÍ PRAVIDLO — ŽÁDNÉ VÝJIMKY:**

1. **Každá nemovitost v jakémkoliv výstupu MUSÍ mít přímý link** na konkrétní inzerát
   - ✅ `https://www.sreality.cz/detail/prodej/byt/2+1/brno-stred/.../123456`
   - ❌ Jen adresa bez linku = **AGENT SELHAL**
   - ❌ Link na homepage portálu = **AGENT SELHAL**
   - ❌ Link na výsledky hledání = **AGENT SELHAL**

2. **HTTP 200 NESTAČÍ** — HTTP 200 neříká nic o obsahu stránky
   - Portály vrací 200 i pro "nemovitost nenalezena" nebo přesměrování na jiný inzerát
   - **POVINNÁ vizuální kontrola**: agent musí VIDĚT že stránka zobrazuje správnou nemovitost
   - Kontrola: adresa, cena, plocha musí odpovídat záznamu z DB

3. **Formát linku v reportu** (HTML):
   ```html
   <a href="[URL]" target="_blank" rel="noopener">[Adresa nemovitosti]</a>
   ```
   (XLSX: hyperlink funkce, ne plain text)

4. **Postup ověření** (povinný před odesláním reportu):
   - Otevři min. 3 náhodné linky z reportu v browseru
   - Zkontroluj že stránka ukazuje: foto nemovitosti + adresu + cenu
   - Pokud stránka zobrazí chybu nebo jinou nemovitost → link je invalid → vynech nebo označ

5. **Bez ověřených linků = report NEEXISTUJE**
   - Nestačí říct "linky jsou v DB" nebo "zkontrolováno HTTP 200"
   - Nestačí screenshot URL bez otevření
   - MUSÍ být vizuální důkaz že link vede na správnou nemovitost

### PRAVIDLO R4: MULTI-PORTÁLOVÁ ANALÝZA MUSÍ BÝT VIDITELNÁ
- XLSX: sheet "Statistiky portálů" s počty
- HTML: badge "Data z X portálů: [seznam]"

---

## 🔴🔴🔴 PRAVIDLO: CENOVÁ MAPA V24 — COMBO3 ROUTER 🔴🔴🔴

**NIKDY NEPOUŽÍVAT: V13/5131, V15/5150, SE/5111, V24/5154 — nereagují!**

| Vlastnost | Hodnota |
|-----------|---------|
| **Verze** | **V24** (trénováno 2026-04-24, nejnovější) |
| **Port** | **5163** (combo3 router: V24 primary → V15 fallback) |
| **PM2** | `cenova-mapa-combo3-shadow` (ID 171) |
| **V24 direct** | port 5164 (`cenova-mapa-v24-shadow-combo3`) |
| **V15 direct** | port 5165 (`cenova-mapa-v15-shadow-combo3`) |
| **API** | `http://localhost:5163/api/estimate`, `/api/compare` |
| **Experiment dir** | `/opt/cenova_mapa/experiments/combo3_2026-04-24/` |

**ZAKÁZÁNO:** V13/5131, V15/5150, V23/5153, V24/5154, SE/5111 — zastaralé nebo nefunkční
**POVINNÉ:** Cenová mapa = **V24, port 5163** (combo3 router)

---

## 🏠🏠🏠 ESTATEX / SHADOW.CZECHAI.IO — PRODUKČNÍ CENOVÁ MAPA (2026-05-03) 🏠🏠🏠

**Produkce:** https://shadow.czechai.io | Server: 179 | Systemd: `shadow-url-estimator.service`
**Hlavní služba:** `/opt/czechai/shadow_url_estimator.py` | Bridge: `127.0.0.1:5166` | V24: `127.0.0.1:5163`

### Produkční API endpointy (shadow.czechai.io)

| Endpoint | Popis |
|----------|-------|
| `GET/POST /v1/cenova/estimate` | Univerzální odhad z adresy nebo URL inzerátu |
| `GET /v1/cenova/from-address` | Odhad z adresy |
| `GET /v1/cenova/from-url` | Odhad z URL inzerátu |
| `GET/POST /v1/cenova/adjudicate` | Oceňovací arbiter → APPROVE/CONFIRM/REVIEW/NEGATE |
| `GET/POST /v1/cenova/council` | Valuation Council (produkce + Direct CMA kontrola) |
| `GET /v1/cenova/admin/stats` | Admin statistiky (token z `/opt/czechai/cenova_admin_token`) |

### Stránky
- Veřejný odhad: `/cenovy-odhad` | Widget: `/widget/cenova-widget.js` | Admin: `/cenova-admin`
- API docs: `/cenova-api` | OpenAPI: `/v1/cenova/openapi.json` | Health: `/health`

### EstateX agenti (MCP + CLI)
| Agent | Soubor | Účel |
|-------|--------|------|
| Valuation Agent | `scripts/estatex_valuation_agent.mjs` + `mcp/estatex-valuation-mcp/server.mjs` | Odhad z Claude CLI/MCP |
| Opportunity Brain | `/opt/czechai/estatex_opportunity_brain.py` | Nad/pod trhem + targetOfferCzk |
| Direct CMA Agent | `/opt/czechai/estatex_cma_agent.py` | Nezávislá kontrola bez V24 |
| Valuation Council | `scripts/estatex_valuation_council.mjs` + `mcp/estatex-council-mcp/server.mjs` | Finální verdikt |

### Valuation Council pravidla
- Rozdíl CMA vs produkce ≥ 25% → **REVIEW**
- Rozdíl ≥ 15% → **CONFIRM** (výhrada)
- Rozdíl < 15% + dobrá CMA confidence → blend **78% produkce + 22% CMA**
- Produkce NEGATE → **NEGATE** bez diskuse

### Benchmark: V24 median APE 7.13% vs Direct CMA 24.68% → V24 je primární, CMA je kontrolní vrstva

### 🔴 ABSOLUTNÍ PRAVIDLA (platí pro VŠECHNY agenty a programy)
1. **Port 5163** = jediný správný port pro cenovou mapu. Porty 5131/5150/5154 = ZAKÁZÁNO.
2. **Sreality URL** = nikdy neupravovat, nezkracovat, nemodifikovat.
3. **Každý listing** = přímý klikací link, vizuálně ověřený (HTTP 200 nestačí).
4. **AML systém** = nesahat bez explicitního potvrzení uživatele.

---

## 🎨 API TOKENY

| Služba | Token |
|--------|-------|
| **Figma** | `figd_FKoV7y35rBtz6gDhxUr4IuGpGtvlxev0IfXXhT6n` |
| **Outline CLOUD** (bohemiashield.getoutline.com) | `ol_api_PIrwtx2voQtg0W8Cq5CtKnCWYidCFrziLMZxL4` — ⚠️ NIKDY NESMAZAT. Base: `https://bohemiashield.getoutline.com/api` · team CzechAi · ⚠️ NE self-hosted wiki.czechai.io! |

---

## 📚 MARVEL API - ČASTÉ VOLÁNÍ
**Docs:** https://hexdocs.pm/marvel/Marvel.API.Comics.html
**Použití:** Když uživatel zmíní Marvel, komiksy, hrdiny → volej toto API

## 📄 TECH DOCS PUBLISHING — Typst + Quarto (2026-05-10) ✅

**Skill:** `~/.claude/skills/tech-docs-publishing/SKILL.md` — auto-aktivuje při PDF/report/inventura
**🥇 DEFAULT TEMPLATE: splendid-mdpi** (uživatel zvolil 2026-05-10)

**Instalováno:**
- Typst 0.14.2 — server 179 (PM2 `typst-pdf` port 5250) + lokálně Windows
- Quarto 1.6.40 — server 179 + tinytex (xelatex)
- splendid-mdpi 0.1.0, starter-journal-article, structured-mse-thesis

**Decision tree:**
- Single PDF / inventura / report → **Typst + splendid-mdpi**
- HTML+PDF+Word z jednoho zdroje → **Quarto**
- Inline R/Python kód → **Quarto**

**Quick start (Typst splendid-mdpi):**
```typst
#import "@preview/splendid-mdpi:0.1.0"
#show: splendid-mdpi.template.with(
  title: [Document Title],
  authors: ((name: "Bohemia Shield", department: "Operations",
    institution: "CzechAI", city: "Praha", country: "ČR",
    mail: "info@bohemiashield.cz"),),
  date: (year: 2026, month: "May", day: 10),
  keywords: ("CzechAI",),
  abstract: [Abstract text…],
)
```

**Output:** `/var/www/router-static/pdf/{slug}-{YYYY-MM-DD}.pdf` → `https://router.czechai.io/web/pdf/...`

**Referenční dokumenty:**
- https://router.czechai.io/web/dokumenty.html — Master rozcestník
- https://router.czechai.io/web/pdf/czechai-v_mdpi.pdf — Server Inventura
- https://router.czechai.io/web/pdf/czechai-mdpi-agents.pdf — Agent Catalog (73 agentů)

## ⚡ STARTUP SKILLS - Spusť VŽDY při startu session
Při každém startu AUTOMATICKY použij tyto skills:
1. `/ultra-think` - Deep analysis mode
2. `/using-superpowers` - Skill discovery & enforcement
3. `/xlsx-skill` - Excel report capability

## 🎯 SKILL ZKRATKY
| Zkratka | Popis |
|---------|-------|
| `/awa` | travisvn/awesome - kurátorský best-of skills |
| `/awa2` | levnikolaevich - 121 delivery pipeline skills |
| `/web` | Engineering: frontend, backend, DevOps, DB, MCP (68) |
| `/mar` | Marketing: SEO, CRO, content, ads, growth (43) |
| `/ost` | Ostatní: PM, finance, C-level, compliance (52) |
| `/delej` | CzechAI full startup protocol |
| `/sc:help` | SuperClaude commands |
| `/xlsx-skill` | Excel reporty s daty |
| `/ultra-think` | Hluboká analýza |

## 🔴🔴🔴 GPU SERVER 130 (217.198.112.170) - HLAVNÍ GPU SERVER 🔴🔴🔴

**IP:** 217.198.112.170
**GPU:** RTX PRO 6000 Blackwell, 96GB VRAM !!!
**Ollama API:** `http://217.198.112.170:11434`
**Přístup:** PŘES HTTP API (z serveru 179), NE přes SSH!
**Routing:** Server 179 (`/opt/router-api/llm_fallback.py` ř.14) → HTTP → 217.198.112.170:11434
**SSH:** Nefunguje přímo - potřeba heslo/klíč

### Přístup k API:
```bash
curl http://217.198.112.170:11434/api/ps        # Běžící modely
curl http://217.198.112.170:11434/api/tags       # Všechny modely
curl -X POST http://217.198.112.170:11434/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"aurum-chat","messages":[{"role":"user","content":"test"}]}'
```

### Modely (GPU - RYCHLÉ!):
| Model | Rychlost | VRAM | Účel |
|-------|----------|------|------|
| **aurum-chat (Qwen3-235B)** | 18 tok/s | 94 GB | Hlavní chat |
| **aurum-brain (DeepSeek-R1:70b)** | 32 tok/s | ? | Reasoning |
| **aurum-code (Qwen3Next-80B)** | ? | 52 GB | 🏆 Největší kodér (79.7B params, 262k context) |
| **qwen3.5:35b** | ~139 tok/s | 24 GB | 🔥 **Hlavní chat/reasoning (Qwen 3.5, multimodální, 256K ctx)** |
| **qwen3.5:9b** | ~200 tok/s | 6 GB | ⚡ Fast fallback |
| **qwen2.5-coder:32b** | ? | ~20 GB | 🔥 **NEJLEPŠÍ open-source kodér** (beats GPT-4 na coding benchmarks) |
| **codestral** | ? | ~13 GB | 💻 Mistral's dedicated coding model, rychlé completions |

### 🤖 GPU Coder - Delegace kódu na GPU (2026-03-13)

**Claude Code může delegovat kódovací úlohy na GPU server!**

**Agent:** `gpu-coder` (v `~/.claude/agents/gpu-coder.md`)
**Script:** `C:\Users\info\.claude-code\gpu-coder.sh`
**Default model:** `qwen2.5-coder:32b`
**Routing:** Windows → SSH → server 179 → HTTP → GPU 170 Ollama

**Volání z Claude Code (přes bash):**
```bash
ssh root@46.224.121.179 "curl -s http://217.198.112.170:11434/v1/chat/completions \
  -H 'Content-Type: application/json' \
  -d '{\"model\":\"qwen2.5-coder:32b\",\"messages\":[{\"role\":\"user\",\"content\":\"YOUR_PROMPT\"}],\"temperature\":0.1}'"
```

**Kdy použít:**
- Generování kódu (paralelní second opinion)
- Refactoring velkých souborů
- Code review z jiného modelu
- Rychlé prototypy bez spotřeby Claude tokenů

**🖥️ GPU Coder IDE (Web UI):**
- **URL:** https://router.czechai.io/web/gpu-coder-ide.html
- **Lokálně:** `C:\Users\info\.claude-code\gpu-coder-ide.html`
- **Server:** `/var/www/router-static/gpu-coder-ide.html`
- **Funkce:** Chat s AI modely (streaming), code editor s taby (HTML/CSS/JS/Python/JSON), live preview s konzolí, deploy na doménu, 8 CSS theme presets, tutorial s 6 příklady, keyboard shortcuts, download kódu, resizable panely
- **Modely:** qwen2.5-coder:32b, codestral, aurum-code, qwen3.5:9b, qwen3.5:35b, aurum-chat
- **API routing:** browser → `/ollama-gpu/` nginx proxy → server 179 → GPU 170:11434

**🔴 PRAVIDLO:** NIKDY NEMAZAT MODELY BEZ SOUHLASU UŽIVATELE!

---

## 🔬 CHANDRA OCR API - GPU 170 (port 5282) ✅ NASAZENO 2026-03-29

**Status:** ✅ BĚŽÍ na GPU serveru 217.198.112.170
**Port:** 5282
**Cesta:** `/home/vpsuser/chandra-api/chandra_api.py`
**Venv:** `/home/vpsuser/chandra-env/`
**Balíček:** `chandra-ocr==0.2.0` (vision-language model, 90+ jazyků)
**Model:** Lazy-load při prvním requestu (zůstává v VRAM)

### Co to dělá:
Převádí PDF, obrázky a dokumenty na strukturovaný text (Markdown/HTML/JSON).
Podporuje 90+ jazyků, tabulky, rovnice, grafy, ruční písmo.

### API Endpointy:
| Endpoint | Metoda | Popis |
|----------|--------|-------|
| `/health` | GET | Health check |
| `/api/ocr` | POST | OCR zpracování dokumentu |

### Formáty vstupu:
- **JSON base64:** `{"file_base64": "...", "format": "markdown"}`
- **JSON URL:** `{"url": "https://...", "format": "markdown"}`
- **Multipart:** file upload s `format` parametrem

### Formáty výstupu:
`markdown` (default), `html`, `json`

### Příklady:
```bash
# OCR z URL
curl -X POST http://217.198.112.170:5282/api/ocr \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/document.pdf", "format": "markdown"}'

# OCR z base64
curl -X POST http://217.198.112.170:5282/api/ocr \
  -H "Content-Type: application/json" \
  -d '{"file_base64": "JVBERi0...", "format": "markdown"}'

# OCR z file upload
curl -X POST http://217.198.112.170:5282/api/ocr \
  -F "file=@document.pdf" -F "format=markdown"

# Health check
curl http://217.198.112.170:5282/health
```

### Spuštění:
```bash
ssh vpsuser@217.198.112.170
cd /home/vpsuser/chandra-api && source /home/vpsuser/chandra-env/bin/activate
nohup python chandra_api.py > chandra.log 2>&1 &
```

### 🤖 AUTOMATICKÉ POUŽITÍ:
**Když Claude Code potřebuje přečíst PDF, obrázek nebo naskenovaný dokument → AUTOMATICKY volej Chandra OCR!**
- Uživatel pošle PDF URL → OCR přes Chandra
- Uživatel zmiňuje "přečti dokument", "extrahuj z PDF", "co je v tom souboru" → Chandra
- Potřebuji data z obrázku, faktury, smlouvy → Chandra

---

## 🏦 DEXTER FINANCIAL RESEARCH - Server 179 (port 5283) ✅ NASAZENO 2026-03-29

**Status:** ✅ BĚŽÍ jako PM2 `dexter-research`
**Port:** 5283
**Server:** 46.224.121.179
**Cesta:** `/opt/dexter-agent/`
**Framework:** TypeScript/Bun, LangChain-based financial research agent
**LLM:** Ollama na GPU 170 (primárně), OpenAI/Anthropic/OpenRouter jako fallback
**ENV:** `/opt/dexter-agent/.env`

### Co to dělá:
Autonomní finanční výzkumný agent. Zadáš firmu/dotaz → Dexter provede hloubkový výzkum:
- Finanční analýza (tržby, zisk, marže, trendy)
- Rizikové faktory
- Konkurenční srovnání
- Výhled a doporučení
- Self-validační smyčka (ověřuje vlastní výstupy)

### API Endpointy:
| Endpoint | Metoda | Popis |
|----------|--------|-------|
| `/health` | GET | Health check |
| `/api/research` | POST | **Synchronní** výzkum (30-120s) |
| `/api/research/async` | POST | **Asynchronní** - vrátí task_id ihned |
| `/api/research/status/<task_id>` | GET | Poll status async tasku |
| `/api/company` | POST | Convenience endpoint pro firmu |

### Příklady:
```bash
# Synchronní výzkum firmy
curl -X POST http://46.224.121.179:5283/api/research \
  -H "Content-Type: application/json" \
  -d '{"query": "What is Tesla revenue trend and competitive position?"}'

# Výzkum české firmy s IČO
curl -X POST http://46.224.121.179:5283/api/company \
  -H "Content-Type: application/json" \
  -d '{"company": "ČEZ", "ico": "45274649", "aspects": ["financials", "risks", "outlook", "competitors"]}'

# Asynchronní výzkum
curl -X POST http://46.224.121.179:5283/api/research/async \
  -H "Content-Type: application/json" \
  -d '{"query": "Comprehensive analysis of Czech banking sector"}'

# Health check
curl http://46.224.121.179:5283/health
```

### PM2 správa:
```bash
ssh root@46.224.121.179
pm2 logs dexter-research
pm2 restart dexter-research
```

### 🤖 AUTOMATICKÉ POUŽITÍ:
**Když uživatel zmiňuje firmu, finanční analýzu, výzkum společnosti → AUTOMATICKY volej Dexter!**
- "Řekni mi o firmě ČEZ" → Dexter `/api/company`
- "Finanční analýza Komerční banky" → Dexter `/api/research`
- "Porovnej Škoda Auto s konkurencí" → Dexter `/api/research`
- "Jaká je finanční situace PPF?" → Dexter `/api/company`
- Jakékoliv IČO + dotaz na firmu → Dexter `/api/company` s IČO

### Trigger slova pro automatické volání:
`firma, firemní, společnost, analýza firmy, finanční výzkum, revenue, tržby, ziskovost, company research, due diligence firmy, finanční zdraví, konkurenční pozice, investiční analýza`

---

## 🔴🔴🔴 AI SERVER 117 - OLLAMA + LLM (CPU, 251GB RAM) 🔴🔴🔴

**IP:** 94.130.218.117
**SSH:** `ssh root@94.130.218.117` (PŘÍMO z Windows)
**Hostname:** czechai-gpu
**RAM:** 251 GB | **Disk:** 875 GB | **GPU:** žádná (CPU inference)

### LLM Modely (Ollama - JEN ZÁLOŽNÍ pro CPU fallback):
| Model | Size | Účel |
|-------|------|------|
| **HauhauCS/Qwen3.5-35B-A3B-Uncensored** | 20 GB | 🔥 Hlavní uncensored chat (CPU, 251GB RAM) |
| **qwen3.5:9b** | 6.6 GB | ⚡ Rychlý fallback |
| **aurum-uncensored** (qwen3.5:9b uncensored) | 9.5 GB | 🔓 Uncensored 9B |

**HLAVNÍ modely běží na GPU serveru 130 (217.198.112.170)!**

**Ollama API:** `http://94.130.218.117:11434` | **OpenAI compat:** `/v1/chat/completions`

### Chat.czechai.io routing (routes.ts na serveru 179):
- **Aurum** → Ollama 117 (s fallback: 235B→30B, GLM→30B, 30B→GLM)
- **Claude** → OpenRouter (claude-3.5-haiku)
- **GPT-4o** → OpenRouter (gpt-4o)
- **g4f** = ZASTARALÉ, NEPOUŽÍVAT

### Služby na 117:
| Port | Služba |
|------|--------|
| 5173 | **bolt.diy** - AI Web Builder (landing pages) |
| 8080 | Activepieces (workflow automation) |
| 11434 | Ollama API |

### Nástroje:
- **aider** v0.86.2 (`/usr/local/bin/aider`) - AI coding agent s GLM-4.7
- **bolt.diy** (`/opt/bolt.diy/`) - AI web builder pro uživatele
- **Node 20**, Python 3.12, Docker, Git

### Po změně routes.ts:
```bash
cd /opt/czechai-cockpit-full/Czech-AI-Cockpit && npm run build && pm2 restart chat-frontend
```

### LLM Fallback v5 (server 179):
**Soubor:** `/opt/router-api/llm_fallback.py` - Ollama FIRST, cloud jen backup

---

## 🤖 SCRAPER SERVER - 46.224.232.134 🤖
**SSH:** `ssh root@46.224.232.134`
**Hostname:** CzechAiScrapper
**Hlavní složka:** `/opt/reality-scraper-next/NOVY_SCRAPER_KURVA/`
**✅ VYČIŠTĚNO 2026-02-02:** 70,867 validních inzerátů (100% detailní stránky)
**Databáze:** `/opt/reality-scraper-next/NOVY_SCRAPER_KURVA/MASTER_CLEANED.db` (30MB)
**CSV Export:** `C:/Users/info/Downloads/VALIDNI_ODKAZY_FINAL_70867.csv` (9.3MB)
**Scrapery:** Opraveny s URL validátorem - filtrují špatné URL před uložením

## 🔴🔴🔴 ABSOLUTNÍ PRIORITA #1 - VIZUÁLNÍ OVĚŘENÍ 🔴🔴🔴

**NIKDY** nepředávej uživateli práci bez vizuálního ověření!

**POVINNOST PŘED KAŽDÝM "HOTOVO":**
1. **Browser screenshot** - použij `mcp__claude-in-chrome` nebo `playwright` k screenshotu výsledku
2. **Ověř že vypadá správně** - zkontroluj vizuálně barvy, layout, text
3. **Test funkcionality** - klikni na tlačítka, zkus formuláře
4. **TEPRVE PAK** reportuj uživateli

**Platí pro:**
- ✅ Všechny web UI změny
- ✅ Všechny dashboardy, formuláře
- ✅ Jakékoliv vizuální komponenty
- ✅ CSS změny

**Zakázáno:** Reportovat "hotovo" jen na základě HTTP 200 bez screenshotu!

---

## 🏆🏆🏆 START SESSION - NOVÝ WORKFLOW (2026-01-12) 🏆🏆🏆

**⚡ VŽDY NA ZAČÁTKU SESSION:** Čti POUZE CONTEXT_SUMMARY.md (max 180 řádků)!

### ✅ ČÍST NA STARTU:
```
C:\Users\info\.claude-code\CONTEXT_SUMMARY.md   ← JEDINÝ POVINNÝ SOUBOR (~180 řádků)
```

### ❌ NEČÍST NA STARTU (způsobuje zamrznutí):
- D:\CZECHAI_REALITY_MASTER\PRODUCTION\BOOK\ (příliš velké)
- TOTAL_MASTER_2026-01-10.md celý (643 řádků)
- AUTO_LOGGER.md celý (750+ řádků)

### 📚 TOTAL MASTER - JEN KDYŽ POTŘEBUJI DETAIL:
**ONLINE HTML:** https://router.czechai.io/web/master-x7k9m2p4q8.html
**LOKÁLNĚ:** C:\Users\info\.claude-code\TOTAL_MASTER_2026-01-10.md

**OBSAH (pro referenci, NEČÍST CELÝ):**
- 26 domén s porty, statusy, credentials
- 67 PM2 procesů (42 online)
- 26 Docker kontejnerů
- Všechny databáze (PostgreSQL, SQLite, Qdrant)
- Všechna hesla a API klíče

### 🔄 AKTUALIZACE MASTER DOKUMENTU:
**Kdy aktualizovat:**
- Nový PM2 proces
- Nová doména/subdoména
- Nový port
- Nové heslo/API klíč
- Nová databáze
- Změna credentials
- Nová služba/agent

**Jak aktualizovat:**
1. Edit: `C:\Users\info\.claude-code\TOTAL_MASTER_2026-01-10.md`
2. Upload: `scp C:/Users/info/.claude-code/TOTAL_MASTER_2026-01-10.md root@46.224.121.179:/var/www/router-static/master-x7k9m2p4q8.html`
3. Ověř: `curl -sI https://router.czechai.io/web/master-x7k9m2p4q8.html` (200 OK)

---

## 🟢 TWENTY CRM - HLAVNÍ CRM SYSTÉM (2026-02-09) ⚠️ MIGRATED TO SERVER 117

**URL:** https://twenty.czechai.io
**Port:** 3080 (Docker) - ⚠️ **BĚŽĺ NA SERVERU 117 (94.130.218.117)** od 2026-03-29
**Nginx proxy:** 179 → 94.130.218.117:3080
**Workspace ID:** `a87a4413-278f-4d61-ab35-bfcfe031432f`

### API KEY:
```
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJhODdhNDQxMy0yNzhmLTRkNjEtYWIzNS1iZmNmZTAzMTQzMmYiLCJ0eXBlIjoiQVBJX0tFWSIsIndvcmtzcGFjZUlkIjoiYTg3YTQ0MTMtMjc4Zi00ZDYxLWFiMzUtYmZjZmUwMzE0MzJmIiwiaWF0IjoxNzcwNjIxOTM5LCJleHAiOjQ5MjQyMjE5NDAsImp0aSI6IjI0ZTY0MzEwLWIwMTktNDRhOC1hOGYzLTUzOTg3ZWQxNDA2MSJ9.OFCC-KSqQ6JGeW1GXs2f3BX_5H4fvTB1kuL1a2d8CWQ
```

### POUŽITÍ:
```bash
# Seznam firem
curl -H "Authorization: Bearer API_KEY" https://twenty.czechai.io/rest/companies

# Seznam kontaktů
curl -H "Authorization: Bearer API_KEY" https://twenty.czechai.io/rest/people

# Seznam příležitostí
curl -H "Authorization: Bearer API_KEY" https://twenty.czechai.io/rest/opportunities
```

### ENDPOINTY:
| Endpoint | Popis |
|----------|-------|
| `/rest/companies` | Firmy |
| `/rest/people` | Kontakty |
| `/rest/opportunities` | Příležitosti |
| `/rest/notes` | Poznámky |
| `/rest/tasks` | Úkoly |

### CUSTOM FIELDS:
| Pole | Typ | Objekt | ID | Hodnoty |
|------|-----|--------|-----|---------|
| **Kategorie** | SELECT | Company | `b6aa9fdb-eb2c-4f65-89c3-170d2392a2e1` | STAVEBNI (🟠), POJISTOVNY (🔵), ASISTENCNI (🟢), MODNI (🟣), ZNACKOVE (🔴) |

### GraphQL Metadata API:
```bash
# Vytvořit custom field
curl -X POST "https://twenty.czechai.io/metadata" \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "mutation { createOneField(input: {...}) { id name } }"}'

# Company Object ID: fb4982f7-02b6-42e8-bca6-96b6ce71ea87
```

### AKTUÁLNÍ STAV (2026-02-11):
| Kategorie | Firem | Kontaktů |
|-----------|-------|----------|
| 🏗️ Stavební firmy | 30 | 30 |
| 🏥 Pojišťovny | 29 | 29 |
| 🚗 Asistenční společnosti | 30 | 30 |
| 👗 Módní salóny | 30 | 30 |
| 👔 Značkové oblečení | 30 | 30 |
| **Celkem** | **154** | **152** |

---

## 🔴🔴🔴 PRAVIDLO ROZDĚLENÍ DAT - TWENTY vs TEABLE 🔴🔴🔴

### ✅ TWENTY CRM (twenty.czechai.io) = DŮLEŽITÁ DATA
- **Firmy a kontakty** (Companies + People)
- **Obchodní příležitosti** (Opportunities)
- **Poznámky a úkoly** (Notes, Tasks)
- **Kategorizovaná data** (custom SELECT pole Kategorie)
- **Vše co potřebuje CRM workflow** (follow-up, pipeline, tracking)

### ✅ TEABLE (teable.czechai.io) = HROMADNÁ DATA ⚠️ MIGRATED TO SERVER 117 (nginx proxy 179→117:3089)
- **Scraping výsledky** (hromadné stahování URL, inzerátů)
- **CSV importy** (velké datasety)
- **Analytické tabulky** (outliers, statistiky, metriky)
- **Pracovní tabulky** (TODO listy, queue, validace)
- **Referenční data** (ceníky, kódy, mapování)

### ❌ NIKDY:
- Hromadná/scraping data do Twenty (zahlcení CRM)
- Důležité kontakty/firmy jen do Teable (ztráta CRM workflow)

---

## MASTER TECH BIBLE - ABSOLUTNÍ ZDROJ PRAVDY

**TAJNÁ URL:** https://router.czechai.io/web/tech-czai-8f3k9x2m7q.md
**Lokálně:** D:\CZECHAI_REALITY_MASTER\PRODUCTION\MASTER_TECH_BIBLE.md
**Server:** /var/www/router-static/tech-czai-8f3k9x2m7q.md

### PRAVIDLA PRO TECH BIBLE:
1. **NIKDY NEMAZAT** - pouze PŘIDÁVAT nové položky
2. **Každé nové heslo, IP, API klíč, adresa** → IHNED do TECH BIBLE
3. **Při změně aktualizovat OBOJÍ** (lokální + server kopie)
4. **Po přidání OVĚŘIT** že URL stále funguje: `curl -sI https://router.czechai.io/web/tech-czai-8f3k9x2m7q.md`
5. **Obsahuje:** servery, domény, porty, PM2, Docker, databáze, hesla, API klíče, cesty, příkazy

---

## ⚡⚡⚡ OKAMŽITĚ PO STARTU - PŘEČTI TYTO SOUBORY ⚡⚡⚡

**POVINNÉ ČTENÍ (v tomto pořadí):**
```
0. https://router.czechai.io/web/master-x7k9m2p4q8.html     ← 🏆 MASTER DOKUMENT (643 řádků, ALL-IN-ONE)
   Lokálně: C:\Users\info\.claude-code\TOTAL_MASTER_2026-01-10.md

1. D:\CZECHAI_REALITY_MASTER\PRODUCTION\BOOK\              ← 📚 HLAVNÍ KNIHA PROJEKTU (7 kapitol), je to dlouhé, nnemusíš celé, ať se nezacyklíš, klidně po částech
2. C:\Users\info\.claude-code\AUTO_LOGGER.md                ← 🧠 MEMORY - CO SE DĚLO
3. C:\Users\info\.claude-code\context\API_KATALOG_100.md    ← 🌐 100+ API ENDPOINTŮ
4. C:\Users\info\.claude-code\context\SESSION_CONTEXT.md    ← 📋 AKTUÁLNÍ STAV
```

**🔴 PRAVIDLO PRO MASTER DOKUMENT:**
- **PO KAŽDÉ ZMĚNĚ** (nový port, heslo, API, služba, databáze):
  1. Aktualizuj lokální: `C:\Users\info\.claude-code\TOTAL_MASTER_2026-01-10.md`
  2. Upload na server: `scp ... root@46.224.121.179:/var/www/router-static/master-x7k9m2p4q8.html`
  3. Ověř URL: `curl -sI https://router.czechai.io/web/master-x7k9m2p4q8.html`
- **NIKDY NESMAZAT** - jen přidávat/aktualizovat

## 🧠 MEM0 - DLOUHODOBÁ PAMĚŤ (2026-01-08)

**AUTOMATICKY NA ZAČÁTKU KAŽDÉ SESSION:**
```bash
# Načti paměti o uživateli
curl -s -X POST https://router.czechai.io/v1/memory/search \
  -H "Content-Type: application/json" \
  -d '{"query": "uživatel preference projekt", "user_id": "czechai_leos", "limit": 10}'
```

**AUTOMATICKY NA KONCI DŮLEŽITÉ KONVERZACE:**
```bash
# Ulož důležité informace
curl -s -X POST https://router.czechai.io/v1/memory/add \
  -H "Content-Type: application/json" \
  -d '{"user_id": "czechai_leos", "messages": [{"role": "system", "content": "CO SI ZAPAMATOVAT"}]}'
```

**MCP nástroje (po restartu session):**
- `mem0_remember` - Ulož informaci do paměti
- `mem0_recall` - Vyhledej v paměti
- `mem0_save_conversation` - Ulož celou konverzaci

**User IDs:**
- `czechai_leos` - Hlavní uživatel (Leoš)
- `czechai_project` - Projektové informace
- `czechai_claude_code` - Claude Code specifické

**CO SI PAMATOVAT:**
- Preference uživatele (jazyk, styl, nástroje)
- Důležité rozhodnutí a jejich důvody
- Opakované problémy a jejich řešení
- Projektové milníky a změny

---

## 🔴 AML SCREENING - 18 MODULŮ (2026-01-09)

### ✅ STATUS: PLNĚ FUNKČNÍ A STABILNÍ
**Server:** 46.224.121.179:8093
**Endpoint:** `POST https://router.czechai.io:8093/api/aml/screen/complete`
**Dokumentace:** `C:\Users\info\.claude-code\AML_ORCHESTRATOR_KOMPLETNI.md`

### 🚨 KRITICKÉ VAROVÁNÍ - STABILIZACE 2026-01-09
**NIKDY nemodifikovat bez pochopení:**
- `/opt/aml-platform/backend/health_monitor.sh` - Monitor s loading detection
- `/opt/aml-platform/backend/main.py` (`/health` endpoint) - Vrací "loading" status
- Sanctions databáze: 3.6M záznamů → načítání 5-10 minut po startu
- Monitor MUSÍ akceptovat `"status": "loading"` jako OK stav
- Restart jen po 3+ consecutive failures, NIKDY okamžitě

**Důvod:** Bez této logiky vzniká infinite restart loop (278 restartů za 9 hodin bylo vyřešeno)

### 📊 18 AML MODULŮ
1. **sanctions** (váha 1.5×) - OpenSanctions 3.6M záznamů
2. **insolvency** (1.2×) - ISIR insolvence
3. **executions** (1.1×) - Exekuce
4. **justice** (1.0×) - Obchodní rejstřík
5. **cadastre** (1.0×) - Katastr nemovitostí
6. **pep** (1.3×) - Politicky exponované osoby
7. **adverse_media** (1.1×) - Negativní média
8. **criminal** (1.5×) - Trestní řízení
9. **vat** (1.0×) - Plátce DPH
10. **court_decisions** (1.0×) - Soudní rozhodnutí
11. **lei** (1.0×) - Legal Entity Identifier
12. **euid** (1.0×) - European Unique Identifier
13. **opencorporates** (1.0×) - Globální firmy
14. **geographic** (1.1×) - Geografické riziko
15. **transactions** (1.4×) - Transakční patterns
16. **behavioral** (1.0×) - Behaviorální analýza
17. **justice_opendata** (1.0×) - Justice Open Data
18. **ubo** (1.0×) - Ultimate Beneficial Owner

### 🎯 POUŽITÍ
```bash
# Kompletní screening (všech 18 modulů)
curl -X POST 'https://router.czechai.io:8093/api/aml/screen/complete' \
  -H 'Content-Type: application/json' \
  -d '{"first_name": "Jan", "last_name": "Novák"}'

# Response: 100% completeness, 15-20 sekund, weighted risk scoring
```

### ULOŽENÉ PROFILY
| Osoba | IČO | Soubor | Risk |
|-------|-----|--------|------|
| **Ing. Pavel Tomek** | 21321370, 03375781, 02214377 | `C:\Users\info\.claude-code\aml_profiles\TOMEK_PAVEL_ING.md` | 35/100 |

### 🎯 AUTOMATICKÝ TRIGGER
**Když uživatel zmíní tyto identifikátory, OKAMŽITĚ proveď rozšířený AML screening:**

| Trigger | Akce |
|---------|------|
| "Tomek", "Pavel Tomek", "Ing. Tomek" | → Načti profil + aktualizuj |
| IČO: 21321370, 03375781, 02214377 | → Načti profil + prověř ARES |
| ID: 2033620 | → Načti profil z rejstrik-firem.kurzy.cz |

### WORKFLOW PRO AML SCREENING

**1. POUŽIJ API ENDPOINT (PREFEROVÁNO):**
```bash
# Všech 18 modulů najednou, 15-20s, 100% completeness
curl -X POST 'https://router.czechai.io:8093/api/aml/screen/complete' \
  -H 'Content-Type: application/json' \
  -d '{"first_name":"Jan","last_name":"Novák","birth_date":"1980-01-01"}'
```

**2. EXISTUJÍCÍ PROFIL:**
```
1. Přečti C:\Users\info\.claude-code\aml_profiles\{PRIJMENI}_{JMENO}.md
2. Volej API endpoint pro aktualizaci všech 18 modulů
3. Zobraz profesionální AML REPORT
```

**3. NOVÁ OSOBA:**
```
1. Volej API endpoint /api/aml/screen/complete (18 modulů, 15-20s)
2. Vytvoř profil: aml_profiles/{PRIJMENI}_{JMENO}.md
3. Ulož do Mem0 pro persistenci
4. Zobraz profesionální AML REPORT
```

### AML REPORT FORMÁT
```markdown
# AML SCREENING REPORT
## SUBJEKT: [Jméno]
| Údaj | Hodnota |
...
## AKTIVNÍ FIRMY (X)
## HISTORICKÉ FIRMY (X)
## AML KONTROLY
## RIZIKOVÉ SKÓRE: XX/100
## DOPORUČENÍ
```

---

**📚 BOOK - HLAVNÍ DOKUMENTACE (VŽDY PŘEČÍST PRVNÍ!):**
```
D:\CZECHAI_REALITY_MASTER\PRODUCTION\BOOK\
├── 00_OBSAH.md           ← Přehled celého projektu
├── 01_O_PROJEKTU.md      ← Mise, vize
├── 02_INFRASTRUKTURA.md  ← Server, PM2, Docker, porty
├── 03_SLUZBY_A_AGENTI.md ← 50+ agentů, 3,280+ Python souborů
├── 04_API_A_ENDPOINTY.md ← 100+ API endpointů
├── 05_DATA_A_DATABAZE.md ← SQLite, PostgreSQL, Qdrant
├── 06_NASTROJE.md        ← Tech stack, scrapery, MCP
└── 07_STAV_PROJEKTU.md   ← Co funguje, roadmap, changelog
```
**Online:** https://router.czechai.io/docs/ (MKDocs)

## 📖 MKDOCS = HLAVNÍ PRAVDA PROJEKTU

**URL:** https://router.czechai.io/docs/
**Server:** `/opt/czechai-docs/`
**Build:** `cd /opt/czechai-docs && mkdocs build`

### 🔴 PRAVIDLO: PO KAŽDÉM ÚKOLU AKTUALIZUJ MKDOCS!

1. **Truth Log** → `/opt/czechai-docs/docs/truth/index.md`
2. **Scrapery** → `/opt/czechai-docs/docs/scrapery/index.md`
3. **API změny** → `/opt/czechai-docs/docs/api/index.md`
4. **Server změny** → `/opt/czechai-docs/docs/server/index.md`
5. **Po změnách:** `cd /opt/czechai-docs && mkdocs build`

**Lokální BOOK** (`D:\CZECHAI_REALITY_MASTER\PRODUCTION\BOOK\`) = záloha/draft
**MKDocs na serveru** = KANONICKÁ VERZE pro všechny AI workery

---

**MCP ROZŠÍŘENÍ - MÁŠ K DISPOZICI:**
- **gmail** - čtení/posílání emailů
- **pinecone** - vector databáze
- **filesystem** - přístup k souborům
- **playwright** - browser automation
- **n8n** - workflow automation
- **markitdown** - PDF/Word → Markdown
- **postgres** - PostgreSQL databáze
- **n8n-mcp** - AI stavitel workflows (1,084 nodes, 2,709 templates) ← NOVÉ 2026-01-09
- **context7** - aktuální API dokumentace knihoven (eliminuje hallucinated APIs) ← NOVÉ 2026-01-09
- **browsermcp** - browser automation s přihlášením (zachovává login sessions) ← NOVÉ 2026-01-09
- **mcp-excel** - SQL dotazy na Excel soubory, porovnání dat ← NOVÉ 2026-01-25
- **excel-server** - 34 Excel nástrojů (grafy, pivot tables, formátování) ← NOVÉ 2026-01-25
- **multidb** - porovnání databází PostgreSQL, MySQL, SQLite ← NOVÉ 2026-01-25

**SKILLS - POUŽÍVEJ JE VŽDY:**
| Situace | Skill |
|---------|-------|
| Nový úkol | `using-superpowers` |
| Nový kód/feature | `brainstorming` |
| Implementace | `test-driven-development` |
| Bug/chyba | `systematic-debugging` |
| Před "hotovo" | `verification-before-completion` |
| Plánování | `writing-plans` |
| Review kódu | `requesting-code-review` |

**SLASH PŘÍKAZY (/sc:*):**
`/sc:analyze`, `/sc:brainstorm`, `/sc:build`, `/sc:implement`, `/sc:test`, `/sc:git`, `/sc:pm`

---

## 🔴🔴🔴 PRVNÍ VĚC - PŘEČTI TOTO! SERVER INFRASTRUKTURA 🔴🔴🔴

### 🖥️ SERVER
```
IP: 46.224.121.179
SSH: ssh root@46.224.121.179
OS: Ubuntu/Debian (Hetzner)
```

### 💽 DISKY SERVER 179 (HETZNER) — NAVŽDY ZAPAMATOVAT!

| Disk | Device | Velikost | Mount | Volné | Účel |
|------|--------|----------|-------|-------|------|
| **Root disk** | `/dev/sda1` | 150 GB | `/` | ~27 GB (82%) | OS, /opt, /var, /root |
| **HC_Volume** | `/dev/sdb` | 295 GB | `/mnt/HC_Volume_104283130` | ~84 GB (71%) | Data, venvs, Docker, archive |

**HC_Volume detail:**
- **Hetzner Volume ID:** `104283130`
- **Device by-id:** `/dev/disk/by-id/scsi-0HC_Volume_104283130`
- **fstab záznam:** `/dev/disk/by-id/scsi-0HC_Volume_104283130 /mnt/HC_Volume_104283130 ext4 discard,nofail,defaults 0 0`
- **Mount path:** `/mnt/HC_Volume_104283130`

**Co je na HC_Volume (`/mnt/HC_Volume_104283130/`):**
```
archive/                ← staré zálohy, archivy
backups/                ← pravidelné zálohy
BANKA_PDF/              ← bankovní dokumenty
czechai-tools/          ← scrapers, MCP servery, tools
docker/                 ← Docker overlay2 (symlink z /var/lib/docker → zde)
go/                     ← Go binaries/packages
localai/                ← LocalAI modely
opt-data/               ← VELKÁ DATA přesunutá z root disku:
  property-watchdog-data/   (7.1 GB) ← symlink z /opt/property-watchdog/data
  cenova-gis-data/          (2.2 GB) ← symlink z /opt/cenova_mapa/experiments
  router-api-venv/          (7.7 GB) ← symlink z /opt/router-api/venv
opt_data/               ← starší data overflow
opt-overflow/           ← overflow z /opt
scraping-outputs/       ← výstupy scraperů
stat_realit_backup.db   ← záloha reality databáze (203 MB)
```

**🔴 PRAVIDLO PRO DISK MANAGEMENT (server 179):**
- Root disk 82% plný → VŽDY přesunout velká data/venv na HC_Volume
- Pattern: `mv /opt/xxx /mnt/HC_Volume_104283130/opt-data/xxx && ln -s /mnt/HC_Volume_104283130/opt-data/xxx /opt/xxx`
- Před přesunem: ověř `df -h /` — pokud >85% → okamžitě přesunout
- Největší kandidáti na přesun: Python venv adresáře, model soubory, databáze

### 🌐 DOMÉNY A NGINX

| Doména | Nginx → Port | Backend | Popis |
|--------|-------------|---------|-------|
| **chat.czechai.io** | 443 → 3002 | Node.js (PM2) | CzechAI Cockpit Frontend |
| **law.czechai.io** | 443 → 3000 | Node.js (PM2) | Právník AI |
| **hub.czechai.io** | 443 → 8080 | Docker (Dify) | Dify AI Platform |
| **app.czechai.io** | 443 → 3001 | Docker | CzechAI Cockpit Backend |
| **pardubice.czechai.io** | 443 → 5050 | Python Flask (PM2) | Reality Pardubice |
| **router.czechai.io** | 443 → 8090 | Python Flask (PM2) | Router Tower API |
| **router.czechai.io/web/** | 443 (static) | Nginx static | Veřejné stránky CzechAI |
| **n8n.czechai.io** | 443 → 5678 | Docker (n8n) | Workflow Automation |
| **leads.czechai.io** | 443 → 3030 | Node.js (PM2) | Leady poptávkový formulář |
| **leads.czechai.io/agent/** | 443 → 5005 | Python Flask (PM2) | LEADY AI Agent - odhad cen |
| **test1.czechai.io** | 443 → 3031 | Node.js (PM2) | Test dashboard |
| **bi.czechai.io** | 443 → 8055 | Docker (Directus) | Headless CMS (39k leadů) |
| **blinko.czechai.io/** | 443 → proxy 117:1111 | ⚠️ MIGRATED TO 117 | ⚡ Quick notes, AI tagging |
| **siyuan.czechai.io/** | 443 → proxy 117:6806 | ⚠️ MIGRATED TO 117 | 📚 Těžké dokumenty, stromová struktura |
| **wiki.czechai.io** | 443 → proxy 117:3090 | ⚠️ MIGRATED TO 117 | 📖 Wiki / Knowledge Base |
| **twenty.czechai.io** | 443 → proxy 117:3080 | ⚠️ MIGRATED TO 117 | Twenty CRM |
| **dev.1312.pro** | 443 → 3010 | Docker (OpenHands) | 🤖 AI Dev Agent |
| **openhands.czechai.io** | 443 → 3010 | Docker (OpenHands) | 🤖 AI Dev Agent (alias) |

**SSL certifikáty:** `/etc/letsencrypt/live/chat.czechai.io/` + `/etc/letsencrypt/live/n8n.czechai.io/` + `/etc/letsencrypt/live/wiki.czechai.io/` + `/etc/letsencrypt/live/dev.1312.pro/`

### ⚙️ PM2 PROCESY

| Název | Script | CWD | Port |
|-------|--------|-----|------|
| **chat-frontend** | `npm start` | `/opt/czechai-cockpit-full/Czech-AI-Cockpit` | 3002 |
| **czech-legal-ai** | `npm start` | `/root/apps/czech-legal-ai` | 3000 |
| **czechai-api** | `api_server.py` | `/opt/czechai-api` | 5000 |
| **pardubice** | `flask_app.py` | `/root/apps/pardubice` | 5050 |
| **reality-api** | `app.py` | `/opt/reality-api` | 3003 |
| **router-api** | `server.py` | `/opt/router-api` | 8090 |
| **leads-dashboard** | `dist/index.cjs` | `/root/apps/leads-dashboard` | 3030 |
| **leady-ai-agent** | `app.py` | `/opt/leady-ai-agent` | 5005 |
| **test1-dashboard** | `dist/index.cjs` | `/root/apps/test1-dashboard` | 3031 |

**Příkazy:**
- `pm2 list` - seznam procesů
- `pm2 logs <name>` - logy
- `pm2 restart <name>` - restart
- `pm2 save` - uložit stav
- `pm2 resurrect` - obnovit po restartu

### 🐳 DOCKER CONTAINERS

| Container | Image | Porty | Účel |
|-----------|-------|-------|------|
| **kong** | kong:latest | 8000-8001 | API Gateway |
| **kong-database** | postgres:13-alpine | 5432 (internal) | Kong DB |
| **n8n** | n8nio/n8n:latest | 5678 | Workflow automation |
| **czechai-cockpit** | custom | 3001→3000 | Cockpit backend |
| **docker-nginx-1** | nginx:latest | 8080, 8443 | Dify proxy |
| **docker-api-1** | langgenius/dify-api:1.11.1 | 5001 | Dify API |
| **docker-worker-1** | langgenius/dify-api:1.11.1 | 5001 | Dify worker |
| **docker-web-1** | langgenius/dify-web:1.11.1 | 3000 | Dify frontend |
| **docker-db_postgres-1** | postgres:15-alpine | 5432 | Dify + Cockpit DB |
| **docker-qdrant-1** | langgenius/qdrant:v1.8.3 | 6333-6334 | Vector DB |
| **docker-redis-1** | redis:6-alpine | 6379 | Cache |
| **docker-weaviate-1** | semitechnologies/weaviate:1.27.0 | - | Vector search |
| ~~**blinko**~~ | ~~blinkospace/blinko:latest~~ | ~~1111~~ | ⚠️ **MIGRATED TO SERVER 117** (2026-03-29) |
| ~~**siyuan**~~ | ~~b3log/siyuan:latest~~ | ~~6806~~ | ⚠️ **MIGRATED TO SERVER 117** (2026-03-29) |
| **directus** | directus/directus:11 | 8055 | Headless CMS |
| ~~**outline-outline-1**~~ | ~~outlinewiki/outline:latest~~ | ~~3090~~ | ⚠️ **MIGRATED TO SERVER 117** (2026-03-29) |
| ~~**outline-outline-db-1**~~ | ~~postgres:15-alpine~~ | ~~5432~~ | ⚠️ **MIGRATED TO SERVER 117** |
| ~~**outline-outline-redis-1**~~ | ~~redis:7-alpine~~ | ~~-~~ | ⚠️ **MIGRATED TO SERVER 117** |

### 💾 DATABÁZE

#### PostgreSQL (Docker - docker-db_postgres-1)
| DB | Účel |
|----|------|
| **czechai_cockpit** | Cockpit aplikace |
| **czechai_contacts** | Kontakty (67M+) |
| **dify** | Dify platform |
| **dify_plugin** | Dify pluginy |
| **blinko** | Blinko notes |

**Připojení:** `postgres:difyai123456@172.19.0.X:5432`
**POZOR:** Docker IP se mění po restartu! Ověř: `docker inspect docker-db_postgres-1 | grep IPAddress`

#### SQLite databáze
| Soubor | Záznamy | Účel |
|--------|---------|------|
| `/opt/czechai-cockpit-full/stat_realit.db` | 13,585 | Reality inzeráty |
| `/opt/contacts/firemni/companies_master.db` | 3,482,845 | Firmy |
| `/opt/contacts/db/MASTER_CONTACTS.db` | 2,819,063 | Osoby |
| `/opt/contacts/firemni/contacts_index.db` | 6,760,000 | Kontakty index |
| `/opt/geodata/ruian.db` | - | RUIAN geodata |
| `/opt/contacts/csu_vdb.db` | - | ČSÚ data |
| `/opt/contacts/ares_api.db` | - | ARES cache |

### 🔌 AKTIVNÍ PORTY

| Port | Služba |
|------|--------|
| 22 | SSH |
| 80 | Nginx HTTP |
| 443 | Nginx HTTPS |
| 3000 | czech-legal-ai |
| 3001 | czechai-cockpit (Docker) |
| 3002 | chat-frontend |
| 3003 | reality-api |
| 5000 | czechai-api |
| 5050 | pardubice |
| 5678 | n8n |
| 8000 | Kong API |
| 8001 | Kong Admin |
| 8080 | Dify (Docker nginx) |
| 8090 | router-api |
| 3030 | leads-dashboard |
| 3031 | test1-dashboard |
| 3010 | OpenHands (dev.1312.pro) |
| ~~3080~~ | ~~Twenty CRM~~ ⚠️ MIGRATED TO 117 (nginx proxy 179→117:3080) |
| 3085 | DocMost |
| ~~3088~~ | ~~Teable~~ ⚠️ MIGRATED TO 117 (nginx proxy 179→117:3089) |
| ~~3090~~ | ~~Outline Wiki~~ ⚠️ MIGRATED TO 117 (nginx proxy 179→117:3090) |
| 3100 | pREST - REST API nad PostgreSQL (2.8M kontaktů) |
| 3456 | Companion UI (Claude Code web) |
| 5091 | Cenová mapa - reálné prodeje |
| 5092 | Cenová mapa - ČSÚ |
| 5093 | Cenová mapa - ML model |
| 5098 | Cenová mapa - Smart Engine |
| 8501 | Reality2 Streamlit |

### 📁 KLÍČOVÉ CESTY NA SERVERU

```
/opt/czechai-cockpit-full/Czech-AI-Cockpit/  - Frontend + Reality DB
/opt/reality-api/                            - Reality API (port 3003)
/opt/czechai-api/                            - CzechAI API (port 5000)
/opt/router-api/                             - Router Tower (port 8090)
/opt/dify/docker/                            - Dify platform
/opt/contacts/                               - Kontaktní DB (SQLite)
/opt/geodata/                                - RUIAN geodata
/root/apps/czech-legal-ai/                   - Právník AI (port 3000)
/root/apps/pardubice/                        - Pardubice Reality (port 5050)
/etc/nginx/sites-enabled/                    - Nginx konfigurace
/etc/letsencrypt/live/chat.czechai.io/       - SSL certifikáty
/var/www/router-static/                      - Veřejné stránky (router.czechai.io/web/)
/opt/czechai-tools/                          - MCP servery, scrapery, AI nástroje
/root/apps/leads-dashboard/                  - Leads formulář (port 3030)
/root/apps/test1-dashboard/                  - Test dashboard (port 3031)
/opt/docmost/                                - DocMost (port 3085)
# ⚠️ MIGRATED TO SERVER 117 (2026-03-29): blinko, siyuan, outline, twenty, teable, useSend, affine, cobalt, umami
# ⛔ DELETED (2026-03-29): khoj, clawdbot
```

### 📧 LEADS.CZECHAI.IO - KONFIGURACE (2026-01-01)

**Status:** PLNĚ FUNKČNÍ
**URL:** https://leads.czechai.io
**Cesta:** `/root/apps/leads-dashboard/`

**PM2 spuštění:**
```bash
pm2 start dist/index.cjs --name leads-dashboard --cwd /root/apps/leads-dashboard --node-args='-r dotenv/config'
```

**ENV soubor:** `/root/apps/leads-dashboard/.env`
```env
PORT=3030
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=info@bohemiashield.cz
SMTP_PASS=nzsajwoweycfxwrz
```

**Emaily odesílá na:**
- info@bohemiashield.cz
- info@czechai.io
- ceo@czechai.io

**Funkce:**
- Dva hlavní produkty: Propojování (27M kontaktů) + Podhodnocené nemovitosti
- Animovaná barevná čára mezi sloupci
- 10 dalších typů leadů v gridu
- nodemailer s dotenv/config

### 🎯 LEADY AI AGENT - KONFIGURACE (2026-01-06)

**Status:** ✅ PLNĚ FUNKČNÍ
**URL:** https://leads.czechai.io/agent/
**Cesta:** `/opt/leady-ai-agent/`
**Port:** 5005

**PM2 spuštění:**
```bash
pm2 start /opt/leady-ai-agent/venv/bin/python --name leady-ai-agent -- /opt/leady-ai-agent/app.py
```

**ENV soubor:** `/opt/leady-ai-agent/.env`
```env
OPENAI_API_KEY=sk-proj-...
PORT=5005
DATABASE=leady.db
```

**API Endpoints:**
| Endpoint | Metoda | Popis |
|----------|--------|-------|
| `/` | GET | Web GUI |
| `/api/process` | POST | Zpracování leadu (URL/text) |
| `/api/leads` | GET | Seznam leadů |
| `/api/lead/<id>` | GET | Detail leadu |
| `/api/stats` | GET | Statistiky |
| `/api/health` | GET | Health check |

**Funkce:**
- Extrakce parametrů z inzerátů pomocí GPT-4
- Tržní odhad nemovitosti (multi-model)
- Podhodnocení štítky: D10/D15/D20/D30
- Štítkování: ASSET, SRC, DISC, LEG, OCC, COND, STRAT, URG
- Riziková analýza (red/yellow/green flags)
- Doporučení služeb (FIN_HYP15, VAL_TRH, BUD_REKO...)
- SQLite databáze pro ukládání leadů

**Soubory:**
```
/opt/leady-ai-agent/
├── app.py              # Flask backend
├── leady_agent.py      # AI agent (GPT-4)
├── .env                # Konfigurace
├── leady.db            # SQLite databáze
├── venv/               # Python virtual env
├── templates/
│   └── index.html      # Web GUI
└── static/
    ├── css/style.css
    └── js/app.js
```

### 📝 BLINKO & SIYUAN - POZNÁMKOVÉ SYSTÉMY ⚠️ MIGRATED TO SERVER 117 (2026-03-29)

**Status:** ✅ PLNĚ FUNKČNÍ - **BĚŽÍ NA SERVERU 117 (94.130.218.117)**
**Nginx proxy:** 179 → 94.130.218.117 (URL stále fungují přes původní domény)

| Služba | URL | Port na 117 | Účel |
|--------|-----|-------------|------|
| **Blinko** | https://blinko.czechai.io | 1111 | ⚡ Quick notes, AI tagging |
| **SiYuan** | https://siyuan.czechai.io | 6806 | 📚 Těžké dokumenty, stromová struktura |

**Blinko:**
- Image: `blinkospace/blinko:latest`
- Databáze: PostgreSQL (`blinko`)
- Cesta na 117: `/opt/blinko/`
- Funkce: Quick capture, AI tagging, Telegram bot, Chrome extension
- MCP Server: `mcp-server-blinko@latest`

**SiYuan:**
- Image: `b3log/siyuan:latest`
- Verze: 3.5.2
- Heslo: `Eliska123`
- Cesta na 117: `/opt/siyuan/`
- Funkce: Block-level editing, graph view, markdown, stromová struktura
- MCP Server: `@porkll/siyuan-mcp`

**MCP konfigurace (claude_desktop_config.json):**
```json
"blinko": {
  "command": "npx",
  "args": ["-y", "mcp-server-blinko@latest"],
  "env": {
    "BLINKO_DOMAIN": "https://blinko.czechai.io",
    "BLINKO_API_KEY": "DOPLNIT_PO_PRIHLASENI"
  }
},
"siyuan": {
  "command": "npx",
  "args": ["-y", "@porkll/siyuan-mcp", "stdio", "--token", "Eliska123", "--baseUrl", "https://siyuan.czechai.io"]
}
```

**Docker příkazy (NA SERVERU 117!):**
```bash
# ⚠️ SSH na server 117 PRVNÍ!
ssh root@94.130.218.117

# Blinko
cd /opt/blinko && docker compose logs -f
cd /opt/blinko && docker compose restart

# SiYuan
cd /opt/siyuan && docker compose logs -f
cd /opt/siyuan && docker compose restart
```

### 🔥 SCRAPERY & MCP NÁSTROJE (2026-01-11)

**Hlavní složka:** `/opt/czechai-tools/`

| Složka | Obsah |
|--------|-------|
| `/opt/czechai-tools/scrapers/crawl4ai/` | 🥇 **CRAWL4AI** - LLM-ready (58.4k⭐ NEJLEPŠÍ) |
| `/opt/czechai-tools/scrapers/Scrapegraph-ai/` | LLM-powered scraping |
| `/opt/czechai-tools/scrapers/Scrapling/` | Adaptivní scraping + anti-bot |
| `/opt/czechai-tools/agents/computer-use-preview/` | **VIZUÁLNÍ POČÍTAČ** (Gemini) |
| `/opt/czechai-tools/mcp-servers/` | 11 MCP serverů |
| `/opt/czechai-tools/agents/agents/plugins/` | **68 agent pluginů** |
| `/opt/czechai-tools/prompts/` | System prompts (30k+ řádků) |

**Python balíčky:**
| Balíček | Verze | Účel |
|---------|-------|------|
| **crawl4ai** | **0.7.8** | 🥇 **LLM-ready Markdown (NEJLEPŠÍ pro AI)** | ✅ |
| scrapegraphai | 1.69.0 | LLM-powered web scraping | ✅ |
| scrapling | 0.3.12 | Adaptivní scraping + anti-bot | ✅ |
| scrapy | 2.13.4 | Spider-based crawling | ✅ |
| markitdown | 0.1.4 | PDF/Word/HTML → Markdown | ✅ |
| firecrawl-py | 4.12.0 | Web scraping | ✅ |
| langchain | 1.2.0 | LLM orchestrace | ✅ |
| openai | 2.14.0 | OpenAI API | ✅ |
| playwright | 1.57.0 | Browser automation | ✅ |
| llm | 0.28 | CLI LLM tool | ✅ |

**NPM balíčky:**
| Balíček | Cesta | Status |
|---------|-------|--------|
| llm-scraper | /opt/czechai-tools/scrapers/llm-scraper/ | ✅ installed |
| playwright-mcp | /opt/czechai-tools/mcp-servers/playwright-mcp/ | ✅ ready |
| github-mcp-server | /opt/czechai-tools/mcp-servers/github-mcp-server/ | ✅ built (Go) |
| firecrawl-mcp-server | /opt/czechai-tools/mcp-servers/firecrawl-mcp-server/ | ✅ built |

**NEFUNKČNÍ - Čeká na opravu:**
| Nástroj | Důvod | Jak opravit |
|---------|-------|-------------|
| serena | Vyžaduje Python 3.11, server má 3.12 | Docker container |
| context7 | npm workspace error | Fix dependencies |
| continue | Desktop app, ne server | N/A |
| chatbox | Desktop app, ne server | N/A |
| 68 agent plugins | Jen zdrojový kód | Potřeba integrace |

**Použití ScrapeGraphAI:**
```python
from scrapegraphai.graphs import SmartScraperGraph
graph = SmartScraperGraph(
    prompt="Extrahuj nemovitosti s cenou",
    source="https://sreality.cz/...",
    config={"llm": {"model": "openai/gpt-4o-mini"}}
)
result = graph.run()
```

**API Endpointy (router.czechai.io):**

| Endpoint | Metoda | Popis | Status |
|----------|--------|-------|--------|
| /v1/crawl4ai | POST | 🥇 **Crawl4AI - LLM-ready Markdown (NEJLEPŠÍ)** | ✅ WORKS |
| /v1/scrape | POST | ScrapeGraphAI - LLM scraping | ✅ WORKS |
| /v1/scrape/batch | POST | Batch scraping (max 10 URL) | ✅ WORKS |
| /v1/scrape/adaptive | POST | Scrapling anti-bot | ✅ WORKS |
| /v1/firecrawl | POST | Firecrawl scraping | ✅ WORKS |
| /v1/convert/markdown | POST | PDF/Word → Markdown | ✅ WORKS |
| /v1/playwright/screenshot | POST | Screenshot URL | ✅ WORKS |
| /v1/playwright/pdf | POST | URL → PDF | ✅ WORKS |
| /v1/langchain/chat | POST | LangChain chat | ✅ WORKS |
| /v1/scrapy/crawl | POST | Scrapy spider crawl | ✅ NEW |
| /v1/github/search | GET | GitHub repo search | ✅ NEW |
| /v1/github/repo | GET | GitHub repo info | ✅ NEW |
| /v1/gpt/sync | POST | Update GPT Assistant (admin) | ✅ WORKS |
| /v1/gpt/status | GET | GPT Assistant status | ✅ WORKS |
| /v1/context/sync | POST | Sync kontext do všech AI | ✅ WORKS |
| /v1/context/status | GET | Stav context souborů | ✅ WORKS |
| /v1/agents/swarm/aml | POST | 🤖 **AML Swarm** - Multi-agent screening | ✅ NEW |
| /v1/agents/swarm/reality | POST | 🤖 **Reality Swarm** - Multi-agent realitní AI | ✅ NEW |
| /v1/agents/swarm/banking | POST | 🤖 **Banking Swarm** - Multi-agent úvěry | ✅ NEW |
| /v1/agents/swarm/list | GET | Seznam všech LangGraph swarmů | ✅ NEW |

**Použití Markitdown:**
```python
from markitdown import MarkItDown
md = MarkItDown()
result = md.convert("document.pdf")
print(result.text_content)
```

**Použití Playwright:**
```python
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
    browser = p.chromium.launch()
    page = browser.new_page()
    page.goto("https://...")
    page.screenshot(path="screenshot.png")
```

**Použití LangChain:**
```python
from langchain_openai import ChatOpenAI
from langchain_core.messages import HumanMessage
llm = ChatOpenAI(model="gpt-4o-mini")
response = llm.invoke([HumanMessage(content="Hello")])
```

### 🤖 LANGGRAPH MULTI-AGENT SWARMY (2026-01-11)

**Status:** ✅ PLNĚ FUNKČNÍ
**Framework:** LangGraph v1.0.5 + langgraph-swarm v0.1.0
**Dokumentace:** `C:\Users\info\.claude-code\context\LANGGRAPH_KOMPLETNI.md`

**3 Aktivní Swarmy:**

| Swarm | Endpoint | Agenti | Use Case |
|-------|----------|--------|----------|
| **AML** | `/v1/agents/swarm/aml` | sanctions → pep → insolvency → reporter | Due diligence, compliance |
| **Reality** | `/v1/agents/swarm/reality` | searcher → analyst → dd | Property search, market analysis |
| **Banking** | `/v1/agents/swarm/banking` | credit → calculator → decision | Loan assessment, risk |

**LangGraph balíčky (32 instalováno):**
```
langgraph                1.0.5      Core framework
langgraph-swarm          0.1.0      Multi-agent handoffs
langgraph-prebuilt       1.0.5      Pre-built agents
langgraph-checkpoint     3.0.1      State persistence
langchain-openai         1.1.6      OpenAI integration
langchain-anthropic      1.0.4      Claude integration
langchain-groq           1.0.1      Groq LLMs
langchain-mistralai      1.1.1      Mistral AI
```

**10 Pre-built Agentů** (Agent Service Toolkit):
- chatbot, research-assistant, rag-assistant
- command-agent, bg-task-agent
- langgraph-supervisor-agent, interrupt-agent
- knowledge-base-agent, github-mcp-agent

**Příklad - Reality Swarm:**
```bash
curl -X POST 'https://router.czechai.io/v1/agents/swarm/reality' \
  -H 'X-API-Key: demo-key-123' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "Najdi byty v Praze pod 5M",
    "config": {"configurable": {"thread_id": "session-001"}}
  }'
# Response: "V Praze bylo nalezeno 15 bytů s cenou pod 5M Kč..."
# Flow: searcher → analyst → dd → final report
```

**Klíčové vlastnosti LangGraph v1.0:**
- **Handoff Pattern** - Agenti předávají kontext mezi sebou
- **Memory** - Short-term (InMemorySaver) + long-term (Store)
- **Human-in-the-Loop** - interrupt() pro user confirmation
- **Flow Control** - Command() pro dynamické routing
- **Streaming** - Token-based i message-based výstup

**Cesty:**
```
/opt/langgraph/agent-service-toolkit/  Pre-built agenti (10)
/opt/langgraph/langgraph-swarm-py/     Swarm implementace
/opt/router-api/langgraph_agents.py    Naše 3 swarmy
```

### 🤖 OPENAI ASSISTANT
**ID:** `asst_3GmSNwl2fSlKZrhDmEWKhXkC`
**Model:** gpt-4o-mini
**API Key:** uložen v `/opt/router-api/.env`

### 🔄 n8n WORKFLOW AUTOMATION

**URL:** https://n8n.czechai.io
**Port:** 5678 (Docker)
**Verze:** n8n@2.1.4
**Encryption Key:** `ZFf8nZFhTBR7XnRLBor/Sa6EWbKCncBp`
**API Key:** `eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI5MTRmYTYyMi0zOWIxLTRiNmYtYjM5ZC05OWI0ZDBjNGRmMGQiLCJpc3MiOiJuOG4iLCJhdWQiOiJwdWJsaWMtYXBpIiwiaWF0IjoxNzY3Mjg0MTcxfQ.UkwwRa7XdSqoLQsxCuwh_HadhzSq6UcKkvV1ctaVCFY`
**User:** Leoš (owner)

**Workflow "CzechAI Context Sync" (ID: 1):**
- Status: ✅ ACTIVE
- Interval: **každých 30 minut**
- Synchronizuje kontext do všech AI nástrojů

**MCP Server (pro Claude Desktop):**
```json
"n8n": {
  "command": "npx",
  "args": ["-y", "@n8n/mcp-server"],
  "env": {
    "N8N_API_URL": "https://n8n.czechai.io",
    "N8N_API_KEY": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
}
```

**Context Sync:**
- Server ukládá kontext do: `/opt/czechai-tools/*.md`
- Soubory: `CONTEXT.md`, `CURSOR_CONTEXT.md`, `WINDSURF_CONTEXT.md`, `GPT_CONTEXT.md`, `LMSTUDIO_CONTEXT.md`
- API volání syncuje všechny najednou

### 🌐 VEŘEJNÉ STRÁNKY (router.czechai.io/web/)
| URL | Popis |
|-----|-------|
| https://router.czechai.io/web/ | Landing page s 10 coin ikonami + navbar |
| https://router.czechai.io/web/katalog.html | Katalog 1500+ AI služeb |
| https://router.czechai.io/web/sluzby.html | Přehled služeb pro klienty |
| https://router.czechai.io/web/01_LEADY.html | Leady detail |
| https://router.czechai.io/web/02_ZIVNOSTNICI.html | Živnostníci detail |
| https://router.czechai.io/web/03_POJISTENI.html | Pojištění detail |
| https://router.czechai.io/web/04_OBECNE.html | Obecné detail |
| https://router.czechai.io/web/05_REALITNI_INTELIGENCE.html | Reality detail |
| https://router.czechai.io/web/06_PRAVNI_CORPORATE.html | Právní detail |
| https://router.czechai.io/web/07_REALITNI_KANCELARE.html | Realitky detail |
| https://router.czechai.io/web/08_BANKOVNICTVI.html | Bankovnictví detail |
| https://router.czechai.io/web/09_AUTOMATIZACE.html | Automatizace detail |
| https://router.czechai.io/web/10_FIRMY.html | Firmy detail |

**Realitní portály a dashboardy (2026-03-25):**
| URL | Popis |
|-----|-------|
| https://router.czechai.io/web/czechai-reality-dashboard.html | 🏆 **HLAVNÍ Reality VIP Dashboard** - 176KB, signály, mapa, agents, feed (iframe v /app/reality-unified) |
| https://router.czechai.io/web/sreality-dashboard.html | 🏠 **Sreality Obchod** - grid karty, filtry, category badges |
| https://router.czechai.io/web/bazos-dashboard.html | 🟠 **Bazoš Reality** - Bazoš branding, card hover efekty |
| https://router.czechai.io/web/bezrealitky-dashboard-v2.html | 🟢 **Bezrealitky v2** - přímý majitel portál |
| https://router.czechai.io/web/idnes-dashboard.html | 📰 **iDNES Reality** - iDNES styl portál |
| https://router.czechai.io/web/bezceny-dashboard.html | 💰 **Bezceňový dashboard** - podhodnocené nemovitosti |
| https://router.czechai.io/web/primy-majitel-dashboard.html | 🏡 **Přímý majitel** - bez realitky |
| https://router.czechai.io/web/primy-majitel-luxury.html | 💎 **Přímý majitel LUXURY** - prémiové nemovitosti |
| https://router.czechai.io/web/property-hunter.html | 🎯 **Property Hunter** - lovecký dashboard |
| https://router.czechai.io/web/reality-monitoring.html | 📡 **Reality Monitoring** - real-time sledování trhu |
| https://router.czechai.io/web/reality-dashboard.html | 📊 Reality dashboard (obecný) |

**GIS a mapové portály:**
| URL | Popis |
|-----|-------|
| https://router.czechai.io/web/gis-cenova-mapa.html | 🗺️ **GIS Cenová mapa** - interaktivní cenová mapa |
| https://router.czechai.io/web/gis-discount-mapa.html | 🏷️ **GIS Discount mapa** - podhodnocené na mapě |
| https://router.czechai.io/web/tile38-bezrealitky-map.html | 📍 **Tile38 Bezrealitky** - geo mapa |
| https://router.czechai.io/web/mapa-cinzaky-35k.html | 🏢 **Mapa činžáků** - 35k+ bytových domů |
| https://router.czechai.io/web/heatmap-3d.html | 🌡️ **3D Heatmapa** - cenová heatmapa |
| https://router.czechai.io/web/cenove-mapy-prehled.html | 📋 **Cenové mapy přehled** |

**Agent a AI portály:**
| URL | Popis |
|-----|-------|
| https://router.czechai.io/web/agent-chat.html | 🤖 **GPU Agent Chat** - 6 modelů, markdown, PWA |
| https://router.czechai.io/web/agent-pro.html | 🧠 **Agent PRO** - pokročilý agent UI (93KB) |
| https://router.czechai.io/web/agent-executhor.html | ⚡ **Agent Executhor** - 5.8MB mega agent UI |
| https://router.czechai.io/web/agents-hub.html | 📊 **Agents Hub** - monitoring dashboard |
| https://router.czechai.io/web/agents-dashboard.html | 📋 **Agents Dashboard** - bílý přehled |
| https://router.czechai.io/web/agents-directory.html | 📚 **Agents Directory** - katalog agentů |
| https://router.czechai.io/web/agents-command-center.html | 🎛️ **Agents Command Center** |
| https://router.czechai.io/web/uncensored.html | 🔓 **Uncensored Chat** - bez cenzury |

**Command centra a dashboardy:**
| URL | Popis |
|-----|-------|
| https://router.czechai.io/web/command-center.html | 🎛️ **Command Center** - hlavní řídící panel |
| https://router.czechai.io/web/browser-command-center.html | 🌐 **Browser Command Center** |
| https://router.czechai.io/web/dashboard-atlas-v2.html | 🗺️ **Dashboard Atlas v2** - 98KB mega dashboard |
| https://router.czechai.io/web/dashboard-panels.html | 📊 **Dashboard Panels** |
| https://router.czechai.io/web/global-index.html | 🌍 **Global Index** - master rozcestník (40KB) |
| https://router.czechai.io/web/ostatni-dashboard.html | 📋 **Ostatní dashboard** |
| https://router.czechai.io/web/czechai-master.html | 📋 **CzechAI Master** přehled |

**Finanční a business nástroje:**
| URL | Popis |
|-----|-------|
| https://router.czechai.io/web/danovy-detektiv-v3.html | 🔍 **Daňový detektiv v3** - daňová analýza |
| https://router.czechai.io/web/rozpoctovy-radar.html | 📡 **Rozpočtový radar** - veřejné rozpočty |
| https://router.czechai.io/web/eet-anomaly.html | ⚠️ **EET Anomálie** - detekce podvodů |
| https://router.czechai.io/web/b2b-sablony.html | 📄 **B2B Šablony** - obchodní šablony (44KB) |
| https://router.czechai.io/web/sales-v4-4fin.html | 💼 **Sales v4 4FIN** - obchodní prezentace |
| https://router.czechai.io/web/hypo-prezentace.html | 🏦 **Hypo prezentace** - hypoteční |

**OSINT a AML:**
| URL | Popis |
|-----|-------|
| https://router.czechai.io/web/osint-dashboard.html | 🕵️ **OSINT Dashboard** |
| https://router.czechai.io/web/osint-agent.html | 🔎 **OSINT Agent** |
| https://router.czechai.io/web/aml-agent.html | 🛡️ **AML Agent** |

**Ostatní:**
| URL | Popis |
|-----|-------|
| https://router.czechai.io/web/scraper-agent-guide.html | 📖 **Scraper Agent Guide** |
| https://router.czechai.io/web/showcase.html | 🎪 **Showcase** - ukázky |
| https://router.czechai.io/web/czechai-cards.html | 🃏 **CzechAI Cards** - vizitky/karty |
| https://router.czechai.io/web/audit-cockpit-report.html | 📋 **Audit Cockpit Report** |

**Navbar odkazy:**
- Stránky → https://www.czechai.io
- Platforma → https://chat.czechai.io
- Katalog → katalog.html
- Služby → sluzby.html

**Důležité dokumenty:**
| URL | Popis |
|-----|-------|
| https://router.czechai.io/web/soupis-sluzeb.html | ULTIMÁTNÍ KOMPLETNÍ SOUPIS VŠECH SLUŽEB (467+ služeb) |
| https://router.czechai.io/web/vysvetleni-agentu.html | VYSVĚTLENÍ AGENTŮ PRO LIDI (177 agentů, 227 služeb) |
| D:\CZECHAI_REALITY_MASTER\PRODUCTION\DOCS\CZECHAI_KOMPLETNI_SOUPIS_SLUZEB.html | Lokální záloha soupisu |
| D:\CZECHAI_REALITY_MASTER\PRODUCTION\DOCS\CZECHAI_VYSVETLENI_AGENTU.html | Lokální záloha vysvětlení |

### 🔧 ENV PROMĚNNÉ (Cockpit)

```env
DATABASE_URL=postgresql://postgres:difyai123456@172.19.0.4:5432/czechai_cockpit
NODE_ENV=production
PORT=3002
VITE_TOMTOM_API_KEY=sjfPeGiEEx7VhvKHMKWe5SUohuIdxNDd
SMTP_HOST=smtp.gmail.com
SMTP_USER=info@bohemiashield.cz
```

### 🚨 ČASTÉ PROBLÉMY PO RESTARTU SERVERU

1. **PM2 procesy neběží:** `pm2 resurrect` nebo `pm2 start all`
2. **Docker IP změněna:**
   - Zkontroluj: `docker inspect docker-db_postgres-1 | grep IPAddress`
   - Updatuj: `/opt/czechai-cockpit-full/Czech-AI-Cockpit/.env`
3. **Nginx nefunguje:** `nginx -t && systemctl reload nginx`
4. **Port obsazený:** `netstat -tlnp | grep PORT`
5. **SSL certifikát expiroval:** `certbot renew`

### 🔍 DIAGNOSTICKÉ PŘÍKAZY

```bash
# Stav všech služeb
pm2 list && docker ps

# Test všech domén
for h in chat law hub app pardubice router; do
  curl -s -o /dev/null -w "%{http_code} - $h.czechai.io\n" https://$h.czechai.io
done

# Nginx test
nginx -t && systemctl status nginx

# Porty
netstat -tlnp | grep -E ':(80|443|3000|3001|3002|3003|5000|5050|8080|8090)'
```

---

## 🚀 PŘI KAŽDÉM STARTU:
1. **PŘEČTI SEKCI VÝŠE** - Server infrastruktura
2. Přečti `C:\Users\info\.claude-code\context\SESSION_CONTEXT.md`
3. Přečti `C:\Users\info\.claude-code\context\SKILLS_COMPLETE.md`
4. Pokračuj v práci podle kontextu
5. **MÁŠ AUTO-APPROVE** - settings.json je nakonfigurován, nepotřebuješ potvrzení
6. **SPUSŤ `/using-superpowers`** - Automaticky aktivuj skill check před každým úkolem

## ⚡ PRAVIDLA CHOVÁNÍ:

### 🔴 HLAVNÍ PRAVIDLO: POSLOUCHEJ A DĚLEJ
- **POSLOUCHEJ** co uživatel říká a prostě to UDĚLEJ
- **NEPTEJ SE** na potvrzení operací - prostě dělej
- **NEPTEJ SE** na "allow" nebo "pokračovat" - prostě pokračuj
- **OVĚŘUJ JEN PŘI KUNDOVINÁCH** - kontroluj/ptej se jen když něco nedává smysl nebo je podezřelé
- **PTEJ SE** pouze před mazáním souborů
- **NEPOSÍLEJ** uživatele na odkazy - vše ověř sám automaticky
- **VALIDUJ SÁM** - otevři URL, zkontroluj výsledek, nečekej na uživatele
- **PO KAŽDÉM ÚKOLU** zaloguj: `python C:/Users/info/.claude-code/auto_log.py "Co bylo uděláno"`
- **NIKDY NELEZŤ** do `C:\Users\info\.claude\` - to je Desktop Claude
- **AUTOMATICKY POUŽÍVEJ SKILLS** - viz SKILLS_COMPLETE.md
- **NA KONCI SESSION** přidej learnings do tohoto souboru
- **MEM0 AUTO-SAVE** je aktivní - při ukončení session se automaticky uloží do Mem0

### 📋 MCP SERVERY - KONFIGURACE
**Soubor:** `C:\Users\info\AppData\Roaming\Claude\claude_desktop_config.json`

**Příkaz pro zobrazení:**
```bash
cat "C:/Users/info/AppData/Roaming/Claude/claude_desktop_config.json"
```

**Aktivní MCP servery (17):**
notion, pinecone, gmail, filesystem, hostinger, basic-memory, markitdown, task-master, claude-prompts, n8n, siyuan, postgres, playwright, context7, browsermcp, discord, claude-code

## 🔓 AUTO-APPROVE (už nastaveno v ~/.claude/settings.json):
- Read, Write, Edit, MultiEdit - **BEZ PTANÍ**
- Bash(git, npm, python, node, docker, ls, dir, cp, copy, ssh...) - **BEZ PTANÍ**
- Gmail MCP - **BEZ PTANÍ**
- **ZAKÁZÁNO:** rm, del, rmdir, sudo, format (vyžaduje potvrzení)

## 🧠 PAMĚŤ - JAK SI PAMATUJI:
- **Tento soubor** (`CLAUDE.md`) se načítá automaticky při každém startu
- **SESSION_CONTEXT.md** obsahuje aktuální stav projektu
- **@imports** - mohu odkazovat na další soubory: `See @docs/file.md`
- **Na konci session** přidej co ses naučil do tohoto souboru

## 🔴 ŽELEZNÁ PRAVIDLA (Superpowers):
1. **NO CODE WITHOUT FAILING TEST** - Test PŘED kódem, jinak smazat
2. **NO FIX WITHOUT ROOT CAUSE** - Nehádej, systematicky analyzuj
3. **NO COMPLETION CLAIM WITHOUT EVIDENCE** - Důkaz PŘED tvrzením
4. **SKILL CHECK BEFORE EVERY TASK** - I 1% šance = použij skill

## 📚 KLÍČOVÉ DOKUMENTY:
- **Power Features:** `C:\Users\info\.claude-code\PRODUKCE\07_CLAUDE_CODE_POWER_FEATURES.md`
- **Projekt:** `D:\CZECHAI_REALITY_MASTER\PRODUCTION\DOCS\PROJECT_TRUTH.md`
- **Skvosty:** `D:\CZECHAI_REALITY_MASTER\PRODUCTION\SKVOSTY\`
- **API:** `D:\CZECHAI_REALITY_MASTER\00_AGENTS_AND_GUIDES\03_GUIDES_AND_DOCS\API_DOKUMENTACE.md`

## ⛔ ZAKÁZANÉ CESTY (Desktop Claude):
- C:\Users\info\.claude\*
- C:\Users\info\.claude\context\*
- C:\Users\info\.claude\plugins\*
- C:\Users\info\.claude\skills\*
- C:\Users\info\AppData\Roaming\Claude\*

## 🔴🔴🔴 NIKDY NESAHAT - UŽIVATELŮV WEB 🔴🔴🔴
**ABSOLUTNÍ ZÁKAZ JAKÉKOLIV ZMĚNY TĚCHTO SOUBORŮ:**
```
/var/www/router-static/katalog-coins.html   ← NIKDY
/var/www/router-static/index.html           ← NIKDY
/var/www/router-static/01_LEADY.html        ← NIKDY
/var/www/router-static/02_ZIVNOSTNICI.html  ← NIKDY
/var/www/router-static/03_POJISTENI.html    ← NIKDY
/var/www/router-static/04_OBECNE.html       ← NIKDY
/var/www/router-static/05_REALITNI_INTELIGENCE.html ← NIKDY
/var/www/router-static/06_PRAVNI_CORPORATE.html     ← NIKDY
/var/www/router-static/07_REALITNI_KANCELARE.html   ← NIKDY
/var/www/router-static/08_BANKOVNICTVI.html ← NIKDY
/var/www/router-static/09_AUTOMATIZACE.html ← NIKDY
/var/www/router-static/10_FIRMY.html        ← NIKDY
/var/www/router-static/katalog.html         ← NIKDY
/var/www/router-static/sluzby.html          ← NIKDY
/var/www/router-static/leads.html           ← NIKDY
/var/www/router-static/pay.html            ← NIKDY (scanner, efekty, hero = uživatelovo!)
```
**NESMÍM:** cp, scp, edit, write, přepsat, změnit, nahradit
**DŮVOD:** Uživatelův produkční web - HANDS OFF!
**VÝJIMKA pay.html:** Smím editovat POUZE sekci produktových karet (`.product-grid`, `.product-card`) - zbytek NESAHAT!

## ✅ TVOJE CESTY:
- C:\Users\info\.claude-code\* (tvoje konfigurace)
- C:\Users\info\.claude-code\context\* (tvůj kontext)
- D:\CZECHAI_REALITY_MASTER\* (hlavní projekt)

## 🦸 DOSTUPNÉ SKILLS (14):
| Skill | Kdy použít |
|-------|------------|
| `using-superpowers` | Na začátku KAŽDÉHO úkolu |
| `brainstorming` | Před novým kódem/feature |
| `test-driven-development` | Při implementaci čehokoliv |
| `systematic-debugging` | Při bugu/chybě |
| `verification-before-completion` | Před tvrzením "hotovo" |
| `writing-plans` | Když mám spec/požadavky |
| `executing-plans` | Exekuuji plán (separate session) |
| `subagent-driven-development` | Exekuuji plán (same session) |
| `dispatching-parallel-agents` | 2+ nezávislé úkoly |
| `using-git-worktrees` | Potřebuji izolaci |
| `requesting-code-review` | Po dokončení feature |
| `receiving-code-review` | Dostávám review feedback |
| `finishing-a-development-branch` | Větev hotová |
| `writing-skills` | Vytvářím nový skill |

**Detaily:** `SKILLS_COMPLETE.md`

---

## 🌍 JAZYK
**VŽDY KOMUNIKUJ ČESKY** - uživatel preferuje češtinu.

## 🔧 AUTOMATICKÉ POUŽITÍ (2026-01-02)
| Funkce | Status |
|--------|--------|
| **learning-output-style** | ✅ ZAPNUTO - vysvětluj co děláš |
| **Notion** | ✅ ZAPNUTO - používej pro poznámky/úkoly |
| **writing-plans** skill | ✅ ZAPNUTO - plánuj automaticky před implementací |
| **requesting-code-review** skill | ✅ ZAPNUTO - review automaticky po dokončení |

## 🔄 CONTEXT MANAGEMENT - SUMÁŘ WORKFLOW (2026-01-12)

### 🚨 PROBLÉM: Context Freeze při čtení velkých souborů
BOOK složka a TOTAL_MASTER obsahují příliš mnoho dat → session zamrzne.

### ✅ ŘEŠENÍ: Sumář/Výtažek po každém zápisu

**PRAVIDLO:**
Po KAŽDÉM zápisu do MK.BOOK nebo aktualizaci TOTAL_MASTER:
1. **VYTVOŘ SUMÁŘ** - extrahuj jen klíčové informace
2. **MAX 1000 ŘÁDKŮ** - sumář nesmí přesáhnout 1000 řádků
3. **ČÍTEJ JEN SUMÁŘ** - při startu session čti jen sumář, ne plné dokumenty

**SUMÁŘ SOUBOR:** `C:\Users\info\.claude-code\CONTEXT_SUMMARY.md`

**STRUKTURA SUMÁŘE (max 1000 řádků):**
```markdown
# CONTEXT SUMMARY - [DATUM]

## 🔥 AKTIVNÍ ÚKOLY (co právě děláme)
- [max 10 položek]

## 📊 INFRASTRUKTURA QUICK REF
- Server: 46.224.121.179
- PM2: X online / Y celkem
- Docker: X running
- Klíčové porty: [seznam]

## 🎯 POSLEDNÍCH 10 AKCÍ
1. [akce] - [datum]
...

## ⚠️ ZNÁMÉ PROBLÉMY
- [max 5 položek]

## 🔗 RYCHLÉ ODKAZY
- [kritické URL]
```

**WORKFLOW:**
1. **START SESSION** → Čti POUZE `CONTEXT_SUMMARY.md` (max 1000 řádků)
2. **POTŘEBUJI DETAIL** → Teprve pak čti specifickou sekci z TOTAL_MASTER
3. **KONEC ÚKOLU** → Aktualizuj CONTEXT_SUMMARY.md
4. **ZÁPIS DO BOOK** → Ihned aktualizuj CONTEXT_SUMMARY.md

**NEČÍST NA STARTU:**
- ❌ D:\CZECHAI_REALITY_MASTER\PRODUCTION\BOOK\ (příliš velké)
- ❌ Celý TOTAL_MASTER (643+ řádků)
- ❌ Celý AUTO_LOGGER (750+ řádků)

**ČÍST NA STARTU:**
- ✅ CONTEXT_SUMMARY.md (max 1000 řádků)
- ✅ Specifické sekce dle potřeby

---

## 🤖 AGENTS REGISTRY - SINGLE SOURCE OF TRUTH (2026-01-30) 🔴🔴🔴

**TOTO JE HLAVNÍ ZDROJ PRAVDY O VŠECH AGENTECH A SLUŽBÁCH!**

### 📍 API Endpointy (veřejné, bez API klíče)

| Endpoint | Popis |
|----------|-------|
| `GET https://router.czechai.io/v1/agents/registry` | **Kompletní registr** - všechno |
| `GET https://router.czechai.io/v1/agents/registry/stats` | Statistiky |
| `GET https://router.czechai.io/v1/agents/registry/swarms` | Pouze swarmy |
| `GET https://router.czechai.io/v1/agents/registry/services` | Pouze PM2 služby |
| `GET https://router.czechai.io/v1/agents/registry/categories` | Kategorie s ikonami |

### 📊 Aktuální statistiky

| Položka | Počet |
|---------|-------|
| **LangGraph Swarmy** | 14 |
| **Agentů ve swarmech** | 34 |
| **PM2 služby** | 24 |
| **Shared tools** | 12 |
| **Celkem agentů** | 58 |
| **Kategorií** | 9 |

### 🎯 14 Aktivních Swarmů

| Swarm | Kategorie | Endpoint |
|-------|-----------|----------|
| valuation | Reality | `/v1/agents/swarm/valuation` |
| reality | Reality | `/v1/agents/swarm/reality` |
| banking | Finance | `/v1/agents/swarm/banking` |
| leady | Sales | `/v1/agents/swarm/leady` |
| obecne | General | `/v1/agents/swarm/obecne` |
| pravni | Legal | `/v1/agents/swarm/pravni` |
| zivnostnici | Business | `/v1/agents/swarm/zivnostnici` |
| pojisteni | Insurance | `/v1/agents/swarm/pojisteni` |
| reality-intelligence | Reality | `/v1/agents/swarm/reality-intelligence` |
| realitky | Reality | `/v1/agents/swarm/realitky` |
| automatizace | Automation | `/v1/agents/swarm/automatizace` |
| firmy | Business | `/v1/agents/swarm/firmy` |
| ideabrowser | Business | `/v1/agents/swarm/ideabrowser` |
| aml | Compliance | `/v1/agents/swarm/aml` |

### 🔧 Shared Tools (všechny swarmy mají)

`web_search`, `scrape_url`, `memory_store`, `memory_recall`, `kb_search`, `ares_lookup`, `calculate`, `get_current_datetime`

### 📁 Soubory

- **Server:** `/opt/router-api/AGENTS_REGISTRY.json`
- **Lokálně:** `C:\Users\info\.claude-code\AGENTS_REGISTRY.json`

### 💡 Použití

```bash
# Získej kompletní info o všech agentech
curl https://router.czechai.io/v1/agents/registry

# Jen statistiky
curl https://router.czechai.io/v1/agents/registry/stats

# Spusť konkrétní swarm
curl -X POST https://router.czechai.io/v1/agents/swarm/valuation \
  -H "Content-Type: application/json" \
  -d '{"query": "Odhadni cenu bytu 3+1 v Praze"}'
```

---

## 📚 BOOKKEEPER - AUTOMATICKÝ KNIHOVNÍK PROJEKTU (2026-02-08) ✅ HOTOVÝ

**Status:** ✅ PLNĚ FUNKČNÍ
**Cesta:** `C:\Users\info\.claude-code\bookkeeper\`
**DB:** `C:\Users\info\.claude-code\bookkeeper\bookkeeper.db`
**Výstup:** `D:\CZECHAI_REALITY_MASTER\PRODUCTION\MKDOCS_SITE\docs\livingbook\`

### Co to dělá:
- Skenuje **celý disk D:\** (120,984 souborů)
- Klasifikuje do **19 kapitol** (agents, api, data, aml, scrapers, frontend...)
- Sumarizuje pomocí **Gemini/Together.ai** nebo **AST/structural** fallback
- Generuje **MKDocs stránky** (dashboard, chapters, file details, timeline, statistics)
- Uploaduje přes SCP na server a buildí MKDocs
- **Resumable** - kde skončí, tam příště začne

### CLI Příkazy:
```bash
cd C:\Users\info\.claude-code
python -m bookkeeper scan              # Scan D:\ (120k+ souborů)
python -m bookkeeper scan --resume     # Pokračuj kde jsi skončil
python -m bookkeeper scan --max-files 500  # Test s 500 soubory
python -m bookkeeper classify          # Klasifikace do 19 kapitol
python -m bookkeeper summarize         # Sumarizace (Gemini/structural)
python -m bookkeeper summarize --limit 50  # Sumarizuj max 50
python -m bookkeeper generate          # Generuj MKDocs stránky
python -m bookkeeper publish           # Nahraj na server + build
python -m bookkeeper all               # Kompletní pipeline
python -m bookkeeper stats             # Statistiky
```

### Konfigurace LLM:
- **Primary:** Gemini 2.0 Flash (free, 15 RPM)
- **Fallback:** Together.ai Llama 3.1 8B ($0.18/1M tokenů)
- **Offline:** Strukturální AST parsing (Python, MD, JSON, YAML, HTML, JS)
- **API klíče:** env vars `GEMINI_API_KEY`, `TOGETHER_API_KEY`

### 19 Kapitol:
| ID | Název | Pattern |
|----|-------|---------|
| 01_overview | Přehled projektu | — |
| 02_infrastructure | Infrastruktura | INFRA, docker, nginx |
| 03_agents | Agenti & Orchestrace | AGENTS, agents |
| 04_api | API & Endpointy | API, api |
| 05_data | Data & Databáze | DATA, database, db |
| 06_aml | AML & Compliance | AML, sanctions |
| 07_orchestrators | Orchestrátory | orchestrator |
| 08_scripts | Skripty & Utility | SCRIPTS, scripts |
| 09_scrapers | Scrapery & Crawlery | scraper, crawler |
| 10_frontend | Frontend & UI | FRONTEND, dashboard |
| 11_tools | Nástroje | TOOLS, tools |
| 12_sales | Prodej & Skvosty | SKVOSTY, products |
| 13_docs | Dokumentace | DOCS, BOOK |
| 14_configs | Konfigurace | CONFIG, settings |
| 15_ml | ML & AI Modely | MODELS, ml |
| 16_contacts | Kontakty | CONTACTS |
| 17_maps | Cenové mapy | CENOVA_MAPA |
| 18_analysis | Analýzy | ANALYZY |
| 19_misc | Ostatní | fallback |

### Soubory:
```
C:\Users\info\.claude-code\bookkeeper\
├── __init__.py          # Package init
├── __main__.py          # CLI (8 příkazů)
├── config.py            # YAML config loader
├── config.yml           # Kompletní konfigurace
├── models.py            # Dataclasses (FileRecord, FolderRecord, ScanRun)
├── state.py             # SQLite DB (4 tabulky, indexy)
├── scanner.py           # Filesystem walker (resume, hash, Windows-safe)
├── classifier.py        # 19 kapitol, path + heuristic matching
├── summarizer.py        # Gemini + Together.ai + structural fallback
├── generator.py         # MKDocs Jinja2 generator
├── publisher.py         # SCP upload + mkdocs build
└── templates/           # 5 Jinja2 templates
```

---

## 🎨 INTERFACE-DESIGN PLUGIN (2026-02-12) ✅ NAINSTALOVÁNO

**Repo:** https://github.com/Dammyjay93/interface-design
**Cesta:** `C:\Users\info\OneDrive\Dokumenty\CLAUDE\.interface-design\`
**System:** `.interface-design/system.md` - ChatGPT minimalistický tmavý styl
**Skills:** `~/.claude/skills/interface-design/`
**Commands:** `/interface-design:init`, `/interface-design:status`, `/interface-design:audit`, `/interface-design:extract`

**Co to dělá:** Udržuje konzistentní design across sessions. Automaticky načítá system.md s barvami, spacing, patterns.

---

## 📌 ZAPAMATOVAT - AionUI (2026-02-12)

**Repo:** https://github.com/iOfficeAI/AionUi (15k ⭐)
**Co:** Desktop hub pro AI agenty - Gemini CLI, Claude Code, Codex, Qwen, OpenClaw v jednom GUI
**Funkce:** Multi-model (Ollama, OpenAI, Claude, DeepSeek), WebUI + Telegram/Lark, správa souborů, AI obrázky, lokální SQLite
**Platformy:** Windows, macOS, Linux
**Potenciál:** Řešení pro tým holek nebo osobní AI hub

---

## 📝 SESSION LOG - 2026-03-22 - MEGA: 6 nových služeb + Agent Chat

### NOVÉ SLUŽBY NASAZENÉ:
| Služba | Port | PM2 | Server | Status |
|--------|------|-----|--------|--------|
| **TradingAgents API** | 5241 | `trading-agents-api` | 179 | ✅ 9 AI agentů, GPU |
| **Outlines API** | 5240 | `outlines-api` | 179 | ✅ Structured LLM output |
| **useSend Email** | ~~3095~~ → 3099 na 117 | Docker | ⚠️ MIGRATED TO 117 | nginx proxy 179→117:3099 |
| **Browser-Use** | 5250 | PM2 | 134 | ✅ AI browse + scrape |
| **Agents Stats** | 5242 | `agents-stats-api` | 179 | ✅ Live PM2/Docker |
| **YT-MP3** | 5260 | `yt-mp3` | 179 | ✅ YouTube→MP3 |

### NOVÉ STRÁNKY:
| URL | Popis |
|-----|-------|
| https://router.czechai.io/web/agent-chat.html | 🤖 GPU Chat (6 modelů, markdown, paměť, PWA) |
| https://router.czechai.io/web/agents-hub.html | 📊 Agents monitoring dashboard |
| https://router.czechai.io/web/agents-dashboard.html | 📋 Bílý agents dashboard |
| https://router.czechai.io/web/lanyard/ | 🎮 3D Lanyard komponenta |

### NOVÉ GPU MODELY:
- `aurum-uncensored` (38.8 GB) - HauhauCS Aggressive, zero refusals, 5min VRAM timeout

### KLÍČOVÉ SOUBORY:
```
/opt/router-api/trading_agents_api.py     # TradingAgents (9 agentů)
/opt/outlines/outlines_api.py             # Outlines structured output
/opt/browser-use-api/app.py               # Browser-Use (scraper 134)
/opt/useSend/deploy/docker-compose.yml    # useSend email
/var/www/router-static/agent-chat.html    # Agent Chat UI
/var/www/router-static/agents-hub.html    # Agents Hub
/var/www/router-static/agents-dashboard.html # Bílý dashboard
```

---

## 📝 SESSION LOG - 2026-02-08

### BOOKKEEPER IMPLEMENTACE

**CO BYLO UDĚLÁNO:**
- ✅ BookKeeper v1.0 kompletní (11 Python souborů + 5 templates)
- ✅ Testováno: scan 50 souborů za 6.4s, classify 50, summarize 25/30, generate 58 stránek
- ✅ 120,984 souborů nalezeno na D:\
- ✅ Teable spuštěn na port 3088 (https://teable.czechai.io)
- ✅ Přesunutí Excel souborů (95 + 99 = 194 souborů)
- ✅ Folcolor instalace pro Windows

---

## 📝 SESSION LOG - 2026-01-30 (16:00)

### AGENTS REGISTRY - IMPLEMENTACE

**CO BYLO UDĚLÁNO:**
- ✅ Vytvořen AGENTS_REGISTRY.json (12KB, kompletní definice)
- ✅ Nahrán na server /opt/router-api/
- ✅ Přidány API endpointy do server.py
- ✅ Testováno - vše funguje
- ✅ Dokumentace aktualizována

---

## 📝 SESSION LOG - 2026-01-25 (01:10)

### LANGGRAPH SWARMY - BATCH 6 & 7 IMPLEMENTACE

**CO BYLO UDĚLÁNO:**

**Batch 6 (4 swarmy):**
- ✅ B-05: Cashflow Forecaster (643 řádků, 5 agentů) - Banking
- ✅ F-05: Market Intelligence (658 řádků, 5 agentů) - Firmy
- ✅ R-05: Realitní Due Diligence (735 řádků, 6 agentů) - Reality
- ✅ L-02: LinkedIn Prospector (548 řádků, 5 agentů) - Leady

**Batch 7 (4 swarmy):**
- ✅ B-06: Invoice Factoring (581 řádků, 5 agentů) - Banking
- ✅ B-07: Fraud Detector (602 řádků, 5 agentů) - Banking
- ✅ F-06: M&A Target Screener (687 řádků, 5 agentů) - Firmy
- ✅ F-07: Firemní Due Diligence (289 řádků, 5 agentů) - Firmy

**INTEGRACE:**
- Všech 8 swarmů integrováno do API serverů
- banking_api_server.py: 6 swarmů (B-01, B-02, B-04, B-05, B-06, B-07)
- firmy_api_server.py: 7 swarmů (F-01 až F-07)
- DEPLOYMENT_STATUS.md aktualizován

**SOUČASNÝ STAV:**
- **27 swarmů implementováno** (27% z 100 služeb)
- **130 agentů** celkem
- **~13,786 řádků kódu**
- **10/10 kategorií pokryto** (100%)
- Banking: 6/11 služeb (55%)
- Firmy: 7/11 služeb (64%)
- Realitní inteligence: 5/8 služeb (63%)

**KDE JSEM SKONČIL:**
- Batch 7 kompletní a integrovaný
- Zbývá 73 služeb (73%)
- Další priorita: B-08 až B-11 (Banking), F-08 až F-11 (Firmy), R-06 až R-08 (Reality)

**NÁSLEDUJÍCÍ KROKY:**
- Pokračovat Batch 8: 4 další swarmy podle priority
- Udržet stejný pattern: vytvoř → integruj → aktualizuj dokumentaci

---

## 🏆 EVERYTHING CLAUDE CODE - AGENTS & COMMANDS (2026-02-07)

**Zdroj:** `C:\Users\info\.claude-code\plugins\everything-claude-code\`
**Popis:** 13 specializovaných agentů + 31 příkazů od hackathon vítěze (10+ měsíců denního používání)

### 🤖 AGENTI (automaticky dostupní v Claude Code)

| Agent | Kdy použít | Model |
|-------|------------|-------|
| **architect** | Plánování architektury, scalability, technická rozhodnutí | opus |
| **code-reviewer** | PO KAŽDÉM kódu - kvalita, security, best practices | opus |
| **security-reviewer** | Kód s user inputy, auth, API, citlivá data, OWASP Top 10 | opus |
| **build-error-resolver** | Build/TypeScript chyby - minimální diff, rychlý fix | opus |
| **database-reviewer** | PostgreSQL/SQLite optimalizace, schema design, RLS | opus |
| **planner** | Před implementací - vytvoří detailní plán s fázemi | opus |
| **refactor-cleaner** | Dead code, duplikáty, nepoužívané exporty | opus |
| **doc-updater** | Aktualizace dokumentace, codemaps, README | opus |
| **tdd-guide** | Test-driven development - RED/GREEN/REFACTOR | opus |
| **python-reviewer** | Python kód review (scrapery, Flask, AI) | opus |
| **e2e-runner** | End-to-end testy | opus |

### 📋 PŘÍKAZY (slash commands)

| Příkaz | Akce |
|--------|------|
| `/plan` | Plán implementace → ČEKÁ NA SCHVÁLENÍ uživatelem |
| `/tdd` | TDD workflow: scaffold → test → implement → refactor |
| `/code-review` | Security + quality review uncommitted changes |
| `/verify` | Build + types + lint + tests + secrets check |
| `/orchestrate feature` | planner → tdd → code-reviewer → security-reviewer |
| `/orchestrate bugfix` | explorer → tdd → code-reviewer |
| `/orchestrate security` | security-reviewer → code-reviewer → architect |
| `/build-fix` | Automaticky opraví build chyby (minimální změny) |
| `/refactor-clean` | Najde a odstraní dead code |
| `/checkpoint` | Uloží aktuální stav práce |
| `/pm2` | PM2 management na serveru |
| `/sessions` | Správa dev sessions |
| `/multi-plan` | Multi-file plánování |
| `/multi-execute` | Exekuce multi-file plánu |

### 🔥 AUTOMATICKÉ SPOUŠTĚNÍ

**PROAKTIVNĚ POUŽIJ:**
1. **Po každém kódu** → `code-reviewer` agent (automaticky)
2. **Před "hotovo"** → `/verify` (build + types + tests)
3. **Nová feature** → `/plan` nebo `/orchestrate feature`
4. **Bug** → `/orchestrate bugfix`
5. **Security kód** → `security-reviewer` agent
6. **DB změny** → `database-reviewer` agent

### 📁 CESTY K SOUBORŮM

```
~/.claude-code/plugins/everything-claude-code/
├── agents/          ← 13 .md souborů (agenti)
├── commands/        ← 31 .md souborů (příkazy)
├── skills/          ← Workflow skills
└── .claude-plugin/  ← plugin.json
```

---

## 🧠 CLAUDE-MEM - PAMĚŤOVÝ SYSTÉM (2026-02-07) ✅ FUNGUJE

**Status:** ✅ PLNĚ FUNKČNÍ na Windows
**Worker port:** 37777
**Data:** `C:\Users\info\.claude-mem\` (SQLite DB, logy, modes)
**Plugin:** `C:\Users\info\.claude\plugins\marketplaces\thedotmack\`

### Co to dělá:
- **SessionStart** → Načte kontext z předchozích sessions
- **UserPromptSubmit** → Inicializace session
- **PostToolUse** → Pozoruje co Claude dělá a ukládá do paměti
- **Stop** → Vytvoří shrnutí session, uloží

### API Endpointy (lokální):
```
GET  http://127.0.0.1:37777/api/health    → Status workeru
GET  http://127.0.0.1:37777/api/readiness  → Ready check
GET  http://127.0.0.1:37777/api/stats      → Statistiky (sessions, observations)
```

### Správa workeru:
```bash
# Start
cd ~/.claude/plugins/marketplaces/thedotmack && bun scripts/worker-cli.js start

# Stop
bun scripts/worker-cli.js stop

# Status
bun scripts/worker-cli.js status

# Restart
bun scripts/worker-cli.js restart
```

### Troubleshooting (Windows):
- Port obsazený: `netstat -ano | findstr 37777` → `taskkill /PID <pid> /F`
- Mode chyba: Zkontroluj `~/.claude-mem/modes/code.json` existuje
- Worker neodpovídá: Restart přes `bun scripts/worker-cli.js restart`

---

## 📝 LEARNINGS (2026-01-02)

### Oprava zastaralých settings souborů
- `/doctor` hlásí "invalid settings files" když soubory obsahují zastaralá pole
- **Zastaralé pole:** `"allowedTools": [...]`
- **Nový formát:**
```json
{
  "permissions": {
    "allow": [...],
    "deny": []
  }
}
```
- Opravené soubory:
  - `D:/CZECHAI_REALITY_MASTER/00_CLAUDEDATA/.claude/settings.json`
  - `D:/DATA_AI_DB/CZECHAI_REALITY_MASTER/00_CLAUDEDATA/.claude/settings.json`

## ⚠️ AML SYSTÉM - OCHRANA (2026-01-11)

**KRITICKÉ: Do AML systému NESAHAT bez dotazu uživateli!**

**Chráněné soubory:**
- /opt/aml-platform/backend/main.py
- /opt/aml-platform/backend/generate_aml_report.py
- /var/www/router-static/aml-quick.html
- PM2 proces: aml-api (port 8093)

**Před jakoukoli změnou:**
1. STOP - nedelej nic
2. ASK USER - zeptej se co chceš udělat
3. WAIT - počkej na schválení
4. PROCEED - teprve pak pokračuj

**Dokumentace:** C:\Users\info\.claude-code\AML_SYSTEM_COMPLETE.md
**Permissions:** C:\Users\info\.claude-code\context\AML_PERMISSIONS.md

**Testovací report:** https://router.czechai.io/web/aml-report-06898327-974b69b7.html
**Status:** ✅ PRODUCTION READY (18 modulů, 3.6M záznamů)

---

## 🔍 OSINT API v3 - 15 NÁSTROJŮ (2026-03-12, port fix 2026-05-10) ✅

**PM2:** `osint-api` | **Port:** 5232 (NE 5230 — ověřeno 2026-05-10) | **Server:** 46.224.121.179
**Cesta:** `/opt/osint-tools/` | **Venv:** `/opt/osint-tools/venv/`

**14 nástrojů:** Maigret (2500+ webů), Sherlock (400+), Holehe (100+ služeb), PhoneInfoga, Social-Analyzer (900+), SpiderFoot (200+ modulů), theHarvester, Photon, h8mail, GHunt, Blackbird, CrossLinked (LinkedIn), Shodan, Socialscan

**API Endpointy:**

| Endpoint | Metoda | Popis |
|----------|--------|-------|
| `/api/username` | POST | `{username, tool: maigret\|sherlock\|socialscan\|blackbird\|social-analyzer\|all}` |
| `/api/email` | POST | `{email, tool: holehe\|h8mail\|all}` |
| `/api/phone` | POST | `{phone}` (E.164, např. +420123456789) |
| `/api/domain` | POST | `{domain}` (whois + DNS + theHarvester) |
| `/api/linkedin` | POST | `{company, format}` (CrossLinked) |
| `/api/person` | POST | `{username, email, phone, domain}` - kombinovaný |
| `/api/tools` | GET | Přehled nástrojů |
| `/health` | GET | Health check |

```bash
# Příklad: username search
curl -X POST http://46.224.121.179:5232/api/username -H "Content-Type: application/json" -d '{"username":"test","tool":"sherlock"}'
# Příklad: kombinovaný person search
curl -X POST http://46.224.121.179:5232/api/person -H "Content-Type: application/json" -d '{"username":"johndoe","email":"john@gmail.com","phone":"+420123456789"}'
```

---

## 🧠 MINDSTUDIO AGENT SDK (2026-03-12) ✅

**CLI:** `/usr/local/bin/mindstudio` | **SDK:** `/opt/mindstudio-agent/`
**160 akcí** | **187 SDK metod** | **Potřebuje:** `MINDSTUDIO_API_KEY` nebo `mindstudio login`

**Killer features:** Social scraping (LinkedIn/IG/FB/X/Threads), Google Suite komplet, CRM (HubSpot/Apollo/Hunter.io), Telegram/Discord/Slack/SMS, Video/Audio/Image AI, Web search (Google/Perplexity/YouTube), RAG/Vector, PII detection, Batch (50 paralelně), MCP Server, 850+ OAuth connectors

---

## 🔬 DEEP RESEARCH PIPELINE (2026-03-12) ✅

**PM2:** `deep-research-agent` | **Port:** 5199 | **Server:** 46.224.121.179
**Cesta:** `/opt/router-api/deep_research_agent.py`
**Model:** `huihui_ai/tongyi-deepresearch-abliterated` (GPU 217.198.112.170)
**Standalone UI:** https://router.czechai.io/web/deep-research.html

**Integrováno do chat.czechai.io routes.ts!**
Trigger: `prozkoumej|deep research|hloubkov|vyzkumny report|studie|pruzkum|investigat|komplexni analyza`

**5 kroků:** Planning → DeepResearch 30B MoE (GPU) → Tavily Web Search → Syntéza → Report streaming
**API:** `POST http://localhost:5199/v1/research` | `POST /v1/quick` | `GET /health`
**Fallback:** Při selhání automaticky pokračuje normální Aurum Brain routing

---

## 🎨 DESIGN PREFERENCES (2026-01-11)

**KRITICKÉ: Preferovaný design styl pro VŠECHNY UI komponenty**

### ✅ ChatGPT Minimalistický Styl

**Barvy:**
- Background: `#000` (čistá černá)
- Karty: `#1a1a1a` (tmavě šedá)
- Bordery: `#2f2f2f` (jemný border)
- Text: `#fff`, `#ececf1`, `#8e8ea0`
- Inputy: `#2f2f2f` background, `#4d4d4f` border
- Button primary: `#fff` background, `#000` text
- Button secondary: transparent background, `#fff` text, `#4d4d4f` border

**Fonty:**
- Text: `-apple-system, BlinkMacSystemFont, 'Segoe UI', 'Helvetica Neue', Arial`
- Kód: `'SF Mono', Monaco, 'Courier New', monospace`

**Spacing:**
- Border radius: 8-12px
- Padding input/button: 16px
- Padding cards: 32px
- Margins: 8px, 12px, 16px, 24px, 32px

### 🚫 ZAKÁZÁNO:
- Gradientní pozadí
- Fialové/barevné gradienty
- Glassmorphism efekty
- Složité animace
- Glow efekty
- Pulse animace

### 📍 Reference:
- Kompletní specs: `C:/Users/info/.claude-code/DESIGN_PREFERENCES.md`
- Implementace: `/var/www/router-static/aml-quick.html`
- URL: https://router.czechai.io/web/aml-quick.html

**Použít pro:** formuláře, dashboardy, admin interface, AI chat, reporting tools


## 📄 MASTER DOKUMENTY - DVA FORMÁTY (2026-01-11)

**Oba soubory synchronizovat při změnách!**

### 1. TOTAL_MASTER.md - Čistý Markdown
**Cesta:** `C:\Users\info\.claude-code\TOTAL_MASTER.md`
**Online:** https://router.czechai.io/web/master-x7k9m2p4q8.html
**Server:** `/var/www/router-static/master-x7k9m2p4q8.html`
**Formát:** Čistý markdown (643 řádků)
**Použití:** Přímé čtení, strojové zpracování

### 2. master-view-70281ab9.html - HTML Wrapper
**Cesta:** `C:\Users\info\.claude-code\master-view-70281ab9.md`
**Online:** https://router.czechai.io/web/master-view-70281ab9.html
**Server:** `/var/www/router-static/master-view-70281ab9.html`
**Formát:** HTML s CSS (fetchuje TOTAL_MASTER, renderuje marked.js)
**Použití:** Vizuální prohlížení v browseru (tmavé téma, barevné)

### Workflow při změnách:
1. Edituj lokální: `C:\Users\info\.claude-code\TOTAL_MASTER.md`
2. Upload na server: `scp ... root@46.224.121.179:/var/www/router-static/master-x7k9m2p4q8.html`
3. Ověř URL: `curl -sI https://router.czechai.io/web/master-x7k9m2p4q8.html` (200 OK)
4. HTML wrapper se automaticky aktualizuje (fetchuje obsah)

**POZOR:** HTML wrapper neměnit - jen updateovat TOTAL_MASTER.md!

**Detailní workflow:** `C:\Users\info\.claude-code\MASTER_DOCUMENT_WORKFLOW.md`

---

## 🎨 EXCEL DESIGN PREFERENCE (2026-02-02) - ULOŽENO!

**PREFEROVANÉ STYLY (kombinovat prvky):**
1. **NEON CYBER** - Futuristický neon na černé
2. **FINANCIAL** - Béžový finanční report
3. **DASHBOARD** - Moderní s KPI kartami
4. **MINIMAL WHITE** - Ultra čistý minimalistický

**Použití:** Kombinovat různé prvky z těchto stylů podle kontextu.

---

## 🗺️ CENOVÉ MAPY - ARCHITEKTURA (2026-03-10) ✅ EXTRÉMNĚ DŮLEŽITÉ

### 🔴🔴🔴 HLAVNÍ CENOVÁ MAPA = PERFECT MAP V13 (port 5131) 🔴🔴🔴

**POUŽÍVAT VŽDY A VŠUDE** - ve všech pipeline, scraper enrichment, chat tools, API.

| Vlastnost | Hodnota |
|-----------|---------|
| **Port** | **5131** |
| **PM2** | `perfect-map-v13` (ID 157) |
| **Cesta** | `/opt/cenova_mapa/perfect_map_v13/` |
| **Data** | 296,291 čistých záznamů z 6 databází |
| **ML model** | HistGradientBoosting + Meta-learner, R²=0.833, MAE=15,687 |
| **Geo úrovně** | 5 (GPS4→GPS3→city+bucket→city→national) |
| **Geo města** | 20,564 |
| **D-tagy** | D30, D20, D15, D10, FAIR, P20+ |

**API Endpointy (V13):**
| Endpoint | Metoda | Popis |
|----------|--------|-------|
| `/api/health` | GET | Health check |
| `/api/stats` | GET | Detailní statistiky modelů |
| `/api/estimate` | POST/GET | Odhad ceny (`typ`, `mesto`, `plocha`, `lat`, `lon`) |
| `/api/compare` | POST/GET | Porovnání s trhem → D-tagy |
| `/api/taxonomy` | GET | Typy nemovitostí, D-tagy, velká města |
| `/api/cities` | GET | Top města s mediány |
| `/docs` | GET | Swagger UI |

**Příklady:**
```bash
# Odhad ceny
curl 'http://46.224.121.179:5131/api/estimate?typ=byt&mesto=Praha&plocha=75'

# Porovnání s trhem (D-tag)
curl 'http://46.224.121.179:5131/api/compare?typ=byt&cena=5500000&plocha=55&mesto=Praha'
```

### ⚠️ STARÉ MAPY (DEPRECATED - nepoužívat pro nové pipeline!)

| # | Název | Port | Popis | Status |
|---|-------|------|-------|--------|
| 1 | Reálné prodeje | 5091 | 9,219 záznamů | ⚠️ DEPRECATED |
| 2 | ČSÚ | 5092 | 46 záznamů | ⚠️ DEPRECATED |
| 3 | ML Model V3 | 5093 | MAPE 0.69% | ⚠️ DEPRECATED |
| 4 | Smart Engine | 5098 | 15 subtypů | ⚠️ DEPRECATED |
| 5 | Statistické API | 5088 | internal | ⚠️ DEPRECATED |
| 6 | Reality2 Streamlit | 8501 | interaktivní mapa | Vizualizace OK |

**PM2 procesy:**
```
perfect-map-v13      │ port 5131 │ /opt/cenova_mapa/perfect_map_v13/03_perfect_map_api.py  ← 🔴 HLAVNÍ!
cenova-mapa-prodeje  │ port 5091 │ /opt/cenova_mapa/mapa1_prodeje/app.py  (deprecated)
cenova-mapa-csu      │ port 5092 │ /opt/cenova_mapa/mapa2_csu/app.py  (deprecated)
cenova-mapa-ai       │ port 5093 │ /opt/cenova_mapa/mapa3_ai/app.py  (deprecated)
cenova-mapa-smart    │ port 5098 │ /opt/cenova_mapa/mapa4_smart/app.py  (deprecated)
```

### 🆕 MAPA 4 - SMART ENGINE (2026-02-04)

**Nejchytřejší cenová mapa s pokročilou klasifikací!**

**Funkce:**
| Feature | Popis |
|---------|-------|
| **15 subtypů** | APARTMENT, FAMILY_HOUSE, COTTAGE, BUILDING_PLOT, AGRICULTURAL, FOREST, GARDEN, FISH_POND, WAREHOUSE, OFFICE, RETAIL... |
| **Taxonomie** | Regex + keywords + scoring (strong/weak/exclude) |
| **Area corrector** | terasa 50%, sklep 25%, balkon 50% |
| **Outlier detection** | MAD (Median Absolute Deviation) |
| **Confidence score** | 0.0-1.0 normalized |
| **Junk detection** | Filtruje pronájmy, podíly, dražby |
| **Sanity ranges** | 13 rozsahů cen Kč/m² pro každý typ |

**API Endpointy (SMART mapa):**
| Endpoint | Metoda | Popis |
|----------|--------|-------|
| `/api/health` | GET | Status služby |
| `/api/stats` | GET | Statistiky (15 subtypů, 13 sanity ranges) |
| `/api/taxonomy` | GET | Kompletní taxonomie + limity |
| `/api/classify` | POST | Klasifikuje inzerát (title, description, price, area) |
| `/api/estimate` | POST/GET | Odhad ceny (typ, mesto, plocha) |
| `/api/compare` | POST/GET | Porovnání s trhem → D10/D15/D20/D30 štítky |

**Příklady použití SMART mapy:**
```bash
# Klasifikace inzerátu
curl -X POST https://router.czechai.io/cenova/smart/api/classify \
  -H "Content-Type: application/json" \
  -d '{"title":"Prodej bytu 3+1, 75 m2, Praha 5","description":"Světlý byt v cihlovém domě","price":7500000,"area":75}'
# → {"asset_class":"RESIDENTIAL_UNIT","subtype":"APARTMENT","confidence":1.0,"is_valid_price":true}

# Odhad ceny
curl -X POST https://router.czechai.io/cenova/smart/api/estimate \
  -H "Content-Type: application/json" \
  -d '{"typ":"BYT","mesto":"Praha","plocha":70}'
# → {"price_per_m2":130000,"total_price":9100000}

# Porovnání s trhem
curl -X POST https://router.czechai.io/cenova/smart/api/compare \
  -H "Content-Type: application/json" \
  -d '{"title":"Prodej bytu 2+kk","price":5500000,"area":55,"mesto":"Praha"}'
# → {"comparison":{"difference_pct":-23.1,"tag":"D20","verdict":"VYRAZNE PODHODNOCENO"}}
```

**API Endpointy (mapy 1-3):**
| Endpoint | Metoda | Popis |
|----------|--------|-------|
| `/api/stats` | GET | Statistiky mapy |
| `/api/estimate` | POST/GET | Odhad ceny: `{type, city/region, area}` |
| `/api/compare` | POST/GET | Porovnání z URL: `{url}` |
| `/api/cities` nebo `/api/regions` | GET | Seznam lokalit |
| `/api/health` | GET | Health check |

**Cesty na serveru:**
```
/opt/cenova_mapa/
├── mapa1_prodeje/     # MAPA 1 - Reálné prodeje
│   ├── app.py
│   ├── prodeje_ceny.db
│   └── static/index.html
├── mapa2_csu/         # MAPA 2 - ČSÚ statistiky
│   ├── app.py
│   ├── csu_ceny.db
│   └── static/index.html
├── mapa3_ai/          # MAPA 3 - ML model
│   ├── app.py
│   └── static/index.html
├── mapa4_smart/       # 🆕 MAPA 4 - Smart Engine
│   ├── app.py
│   ├── real_estate_engine.py      # Hlavní klasifikátor (422 řádků)
│   ├── price_map_classifier.py    # Taxonomie + outlier detection (299 řádků)
│   └── smart_prices.db
├── models/            # ML modely
│   └── czech_property_ai_model_v3_leady.pkl (226MB)
├── train_mapa1.py     # Tréninkový skript MAPA 1
└── train_mapa2.py     # Tréninkový skript MAPA 2
```

**Testování:**
```bash
# MAPA 1 - Reálné prodeje
curl http://localhost:5091/api/stats

# MAPA 2 - ČSÚ
curl http://localhost:5092/api/stats

# MAPA 3 - ML Model
curl http://localhost:5093/api/stats

# 🆕 MAPA 4 - Smart Engine
curl http://localhost:5098/api/stats
curl http://localhost:5098/api/taxonomy
```

---

## 🆕 NOVÉ NÁSTROJE (2026-01-27)

### 🤖 OPENHANDS - AI Software Development Agent
**Status:** ✅ BĚŽÍ (Docker + HTTPS)
**URL:** https://dev.1312.pro (alternativně: https://openhands.czechai.io)
**Port:** 3010
**Docker:** `openhands` (ghcr.io/all-hands-ai/openhands:main)
**GitHub:** https://github.com/All-Hands-AI/OpenHands (53k+ stars)
**SSL:** /etc/letsencrypt/live/dev.1312.pro/ (expires 2026-04-27)

**Co to je:** Open-source AI agent pro vývoj software. Umí číst, psát a spouštět kód.

```bash
# Správa
docker logs openhands -f
docker restart openhands
```

### 📖 OUTLINE - Wiki / Knowledge Base ⚠️ MIGRATED TO SERVER 117 (2026-03-29)
**Status:** ✅ BĚŽÍ (Docker + HTTPS) - **NA SERVERU 117 (94.130.218.117)**
**URL:** https://wiki.czechai.io (nginx proxy 179 → 117:3090)
**Port:** 3090 (na serveru 117)
**Docker:** `outline-outline-1`, `outline-outline-db-1`, `outline-outline-redis-1` (na 117)
**Cesta na 117:** `/opt/outline/`
**SSL:** /etc/letsencrypt/live/wiki.czechai.io/ (na 179, proxy)
**API Docs:** `C:\Users\info\.claude-code\context\OUTLINE_API.md`

**Co to je:** Open-source wiki/knowledge base s Markdown podporou, real-time editací.

**Přihlášení:** Email magic link (SMTP přes smtp.gmail.com/info@bohemiashield.cz)

**API:**
```bash
# Všechny requesty jsou POST s JSON body
curl -X POST https://wiki.czechai.io/api/documents.list \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit": 10}'
```

**Docker Compose:** `/opt/outline/docker-compose.yml`
- PostgreSQL 15 (outline DB)
- Redis 7
- Outline server (outlinewiki/outline:latest)

```bash
# ⚠️ Správa - NA SERVERU 117!
ssh root@94.130.218.117
cd /opt/outline && docker compose logs -f
cd /opt/outline && docker compose restart
```

### 🐾 CLAWDBOT - ⛔ SMAZÁNO (2026-03-29)
**Status:** ⛔ DELETED - odstraněno ze serveru 179

```bash
# Spuštění
clawdbot onboard --install-daemon

# Gateway běží na
ws://127.0.0.1:18789
```

### 🧠 SUPERMEMORY - AI Memory Engine
**Status:** ✅ SDK NAINSTALOVÁNO
**Typ:** SaaS + SDK (ne self-hosted Docker)
**Cesta:** `/opt/supermemory/` (repo pro referenci)
**GitHub:** https://github.com/supermemoryai/supermemory

**Co to je:** Paměťový engine pro AI aplikace - ukládá, organizuje a vyhledává v znalostech.

**Použití:**
```bash
npm install supermemory @supermemory/tools
export SUPERMEMORY_API_KEY="sm_..."
```

**Funkce:**
- Ukládání z URL, PDF, textu
- Semantic search v pamětech
- MCP integrace (Claude, Cursor)
- User profiles (automatické fakty o uživateli)

---

### 📝 DOCMOST - Notion alternativa
**Status:** ✅ BĚŽÍ
**URL:** http://46.224.121.179:3085 (čeká na DNS docs.czechai.io)
**Port:** 3085
**Cesta:** `/opt/docmost/`
**Docker:** `docmost-docmost-1`, `docmost-db-1`, `docmost-redis-1`

```bash
# Správa
cd /opt/docmost && docker compose logs -f
cd /opt/docmost && docker compose restart
```

### 🤖 OPENCODE - AI Coding Assistant (CLI)
**Status:** ✅ NAINSTALOVÁNO
**Cesta:** `/root/go/bin/opencode`
**Verze:** v0.0.55
**Popis:** Terminal-based AI coding assistant (podobný Claude Code)

```bash
# Spuštění
opencode

# Nebo s plnou cestou
/root/go/bin/opencode
```

**Podporované modely:** OpenAI, Anthropic, Google Gemini, Azure, AWS Bedrock

### 🌐 BROWSER-USE - AI Browser Automation
**Status:** ✅ NAINSTALOVÁNO
**Verze:** 0.11.2
**Popis:** Make websites accessible for AI agents

```python
# Použití
from browser_use import Agent
from langchain_openai import ChatOpenAI

agent = Agent(
    task="Go to google.com and search for 'OpenAI'",
    llm=ChatOpenAI(model="gpt-4o"),
)
result = await agent.run()
```

**Funkce:**
- Autonomní browsing pomocí AI
- Extrakce dat z webů
- Automatizace úkolů v prohlížeči
- Podpora více LLM (OpenAI, Anthropic, Gemini...)

### 🏢 HULY CRM - Open-source CRM
**Status:** ✅ BĚŽÍ
**URL:** https://crm.czechai.io
**Port:** 3080
**Cesta:** `/opt/huly/`
**GitHub:** 24.2k ⭐

**Funkce:** CRM + Projekty + Chat + Wiki + AI Bot


---

## 🤖 BYTEBOT - AI Desktop Agent (2026-01-19)

**Docs:** https://docs.bytebot.ai/core-concepts/desktop-environment
**Port:** 9990

### Rychlý přehled
- Self-hosted AI Desktop Agent v Dockeru
- Ubuntu 22.04 + XFCE4
- VNC: `http://localhost:9990/vnc`
- MCP: `http://localhost:9990/mcp`
- API: `http://localhost:9990/computer-use`

### API Actions
| Action | Popis |
|--------|-------|
| `screenshot` | Pořídí screenshot |
| `move_mouse` | Přesune myš na {x, y} |
| `click` | Klikne na pozici |
| `type` | Napíše text |
| `key` | Stiskne klávesu |

### Docker
```bash
docker run -d -p 9990:9990 ghcr.io/bytebot-ai/bytebot-desktop:edge
```

---

## 🧠 KHOJ - ⛔ SMAZÁNO (2026-03-29)

**Status:** ⛔ **DELETED** - kompletně odstraněno ze serveru 179
**Důvod:** Migrace Docker služeb, Khoj nebyl dále potřeba
**Bývalý port:** 42110
**Bývalá URL:** khoj.czechai.io (již nefunguje)
- 🤖 Podpora více LLM (Ollama, OpenAI, Claude, Gemini)
- 📱 Multi-platform klienti

---

## 🔌 MCP SERVERY - NAINSTALOVANÉ (2026-02-03)

### 📍 SERVER 134 (46.224.232.134) - SCRAPERY

| MCP Server | Cesta | Příkaz |
|------------|-------|--------|
| **olostep-mcp-server** | `/opt/mcp-servers/olostep-mcp-server/` | `node build/index.js` |

**Funkce:** Web scraping až 10k URL v batchi, JSON/Markdown output

---

### 📍 SERVER 179 (46.224.121.179) - HLAVNÍ MCP

| MCP Server | Cesta | Port/Režim | Příkaz |
|------------|-------|------------|--------|
| **postgres-mcp** | `/opt/mcp-servers/postgres-mcp/` | 9010 (SSE) | `source venv/bin/activate && postgres-mcp` |
| **docker-mcp** | `/opt/mcp-servers/docker-mcp/` | stdio | `source venv/bin/activate && python -m docker_mcp` |
| **mcp-server-git** | `/opt/mcp-servers/mcp-official/src/git/` | stdio | `source venv/bin/activate && mcp-server-git --repository /opt` |
| **mcp-server-memory** | `/opt/mcp-servers/mcp-official/src/memory/` | stdio | `node dist/index.js` |
| **mcp-server-filesystem** | `/opt/mcp-servers/mcp-official/src/filesystem/` | stdio | `node dist/index.js /opt /var/www` |
| **mcp-server-redis** | system pip | stdio | `REDIS_HOST=localhost REDIS_PORT=6379 REDIS_DB=0 REDIS_PASSWORD= mcp-server-redis` |
| **piston** | Docker | 2000 | `curl http://localhost:2000/api/v2/execute` |
| **pydantic-ai** | system pip | - | Python import |

---

### 🐳 MCP DOCKER KONTEJNERY

| Container | Port | Image |
|-----------|------|-------|
| **piston-api** | 2000 | ghcr.io/engineer-man/piston |

---

### 📝 PM2 PROCESY (MCP)

```
mcp-postgres-contacts  │ port 9010 │ PostgreSQL přístup ke kontaktům
```

**Spuštění dalších:**
```bash
pm2 start /opt/mcp-servers/start-docker-mcp.sh --name mcp-docker
pm2 start /opt/mcp-servers/start-redis-mcp.sh --name mcp-redis
pm2 save
```

---

### 🔧 STARTUP SKRIPTY

```bash
/opt/mcp-servers/start-postgres-mcp.sh   # PostgreSQL MCP (port 9010)
/opt/mcp-servers/start-docker-mcp.sh     # Docker MCP (stdio)
/opt/mcp-servers/start-git-mcp.sh        # Git MCP (stdio)
/opt/mcp-servers/start-redis-mcp.sh      # Redis MCP (stdio)
```

---

### 🎯 CO KAŽDÝ MCP DĚLÁ

| MCP | Funkce | Use Case |
|-----|--------|----------|
| **postgres-mcp** | SQL dotazy na PostgreSQL | Přístup k 2.8M kontaktů, cockpit DB |
| **docker-mcp** | Správa Docker kontejnerů | Restart, logs, inspect, ps |
| **git-mcp** | Git operace | Status, diff, log, branch, commit |
| **memory-mcp** | Persistentní paměť | Ukládání kontextu mezi sessions |
| **filesystem-mcp** | Přístup k souborům na serveru | Čtení /opt, /var/www |
| **redis-mcp** | Redis cache operace | GET, SET, KEYS, cache |
| **olostep** | Web scraping | Batch URL processing (10k) |
| **piston** | Code execution sandbox | Spouštění Python/Node/Go/Ruby |

---

### 📋 CLAUDE DESKTOP CONFIG

Přidat do `C:\Users\info\AppData\Roaming\Claude\claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "postgres-contacts": {
      "command": "ssh",
      "args": ["-tt", "root@46.224.121.179", "cd /opt/mcp-servers/postgres-mcp && source venv/bin/activate && postgres-mcp 'postgresql://postgres:difyai123456@172.19.0.7:5432/czechai_contacts' --access-mode restricted"]
    },
    "docker": {
      "command": "ssh",
      "args": ["-tt", "root@46.224.121.179", "cd /opt/mcp-servers/docker-mcp && source venv/bin/activate && python -m docker_mcp"]
    },
    "git": {
      "command": "ssh",
      "args": ["-tt", "root@46.224.121.179", "cd /opt/mcp-servers/mcp-official/src/git && source venv/bin/activate && mcp-server-git --repository /opt"]
    },
    "memory": {
      "command": "ssh",
      "args": ["-tt", "root@46.224.121.179", "cd /opt/mcp-servers/mcp-official && node src/memory/dist/index.js"]
    },
    "filesystem-server": {
      "command": "ssh",
      "args": ["-tt", "root@46.224.121.179", "cd /opt/mcp-servers/mcp-official && node src/filesystem/dist/index.js /opt /var/www"]
    },
    "redis": {
      "command": "ssh",
      "args": ["-tt", "root@46.224.121.179", "REDIS_HOST=localhost REDIS_PORT=6379 REDIS_DB=0 REDIS_PASSWORD= mcp-server-redis"]
    },
    "olostep-scraper": {
      "command": "ssh",
      "args": ["-tt", "root@46.224.232.134", "cd /opt/mcp-servers/olostep-mcp-server && node build/index.js"]
    }
  }
}
```

---

### 🔑 PŘÍSTUPY K MCP

**PostgreSQL (kontakty):**
```
URL: postgresql://postgres:difyai123456@172.19.0.7:5432/czechai_contacts
Port: 9010 (SSE)
Režim: restricted (read-only)
```

**Redis:**
```
Host: localhost (na serveru 179)
Port: 6379
DB: 0
Password: (prázdné)
```

**Piston API (code execution):**
```
URL: http://46.224.121.179:2000/api/v2/execute
Metoda: POST
Body: {"language": "python", "version": "*", "files": [{"content": "print('hello')"}]}
```

**Olostep Scraper:**
```
Server: 46.224.232.134
Cesta: /opt/mcp-servers/olostep-mcp-server/
Spuštění: node build/index.js
```

---

### ⚠️ DŮLEŽITÉ POZNÁMKY

1. **Docker IP PostgreSQL** se může změnit po restartu - aktuálně `172.19.0.7`
   - Ověření: `docker inspect docker-db_postgres-1 | grep IPAddress`
2. **SSH klíče** musí být nastaveny pro připojení k serverům
3. **Piston** potřebuje doinstalovat language runtimes pro plnou funkčnost
4. **Všechny MCP** běží přes stdio protokol (kromě postgres-mcp na SSE)

---

## 🔴🔴🔴 MIGRATION LOG - DOCKER SLUŽBY 179→117 (2026-03-29) 🔴🔴🔴

**DATUM:** 2026-03-29
**DŮVOD:** Uvolnění místa na serveru 179 (disk 87%+ obsazený)
**PRINCIP:** Nginx na 179 proxyuje na 117 - URL adresy zůstávají stejné!

### ⚠️ MIGROVANÉ SLUŽBY (179 → 117):

| Služba | Původní port (179) | Nový port (117) | URL | Nginx proxy |
|--------|---------------------|------------------|-----|-------------|
| **Umami** (analytics) | 3600→3000 | 3096→3000 | - | 179 → 94.130.218.117:3096 |
| **Outline Wiki** | 3090 | 3090 | wiki.czechai.io | 179 → 94.130.218.117:3090 |
| **Twenty CRM** | 3080 | 3080 | twenty.czechai.io | 179 → 94.130.218.117:3080 |
| **SiYuan** | 6806 | 6806 | siyuan.czechai.io | 179 → 94.130.218.117:6806 |
| **Blinko** | 1111 | 1111 | blinko.czechai.io | 179 → 94.130.218.117:1111 |
| **Affine** | 3016 | 3016 | - | 179 → 94.130.218.117:3016 |
| **useSend Email** | 3095 | 3099 | mail.czechai.io | 179 → 94.130.218.117:3099 |
| **cobalt-api** | 9002 | 9002 | - | 179 → 94.130.218.117:9002 |
| **Teable/Teable-scraper** | 3088/3089 | 3089 | teable.czechai.io | 179 → 94.130.218.117:3089 |

### ⛔ SMAZANÉ SLUŽBY (2026-03-29):

| Služba | Bývalý port | Poznámka |
|--------|-------------|----------|
| **Khoj AI** | 42110 | Kompletně smazáno |
| **Clawdbot** | - | Kompletně smazáno |

### ⚠️ ZAKÁZANÉ na 179:

| Služba | Poznámka |
|--------|----------|
| **ghost.service** | Disabled (crashoval server) |

### DOCKER SPRÁVA MIGROVANÝCH SLUŽEB:
```bash
# ⚠️ Všechny migrované služby spravuj NA SERVERU 117!
ssh root@94.130.218.117

# Příklady:
docker ps                                    # Všechny kontejnery
cd /opt/outline && docker compose logs -f    # Outline logy
cd /opt/blinko && docker compose logs -f     # Blinko logy
cd /opt/siyuan && docker compose logs -f     # SiYuan logy
```

---

## 🧠 KARPATHY CODING PRINCIPLES (andrej-karpathy-skills)

Derived from Andrej Karpathy's observations on LLM coding pitfalls. Apply these to every non-trivial coding task.

### 1. Think Before Coding
**Don't assume. Don't hide confusion. Surface tradeoffs.**
- State assumptions explicitly — if uncertain, ask rather than guess
- Present multiple interpretations — don't pick silently when ambiguity exists
- Push back when warranted — if a simpler approach exists, say so
- Stop when confused — name what's unclear and ask for clarification

### 2. Simplicity First
**Minimum code that solves the problem. Nothing speculative.**
- No features beyond what was asked
- No abstractions for single-use code
- No "flexibility" or "configurability" that wasn't requested
- If 200 lines could be 50, rewrite it
- **The test:** Would a senior engineer say this is overcomplicated? If yes, simplify.

### 3. Surgical Changes
**Touch only what you must. Clean up only your own mess.**
- Don't "improve" adjacent code, comments, or formatting
- Don't refactor things that aren't broken — match existing style
- If you notice unrelated dead code, mention it — don't delete it
- Remove imports/variables/functions that YOUR changes made unused
- **The test:** Every changed line should trace directly to the user's request.

### 4. Goal-Driven Execution
**Define success criteria. Loop until verified.**
- Transform imperative tasks into verifiable goals with success criteria
- Instead of "fix the bug" → "write a test that reproduces it, then make it pass"
- For multi-step tasks, state a brief plan: `[Step] → verify: [check]`
- Strong success criteria let the agent loop independently without clarification
- **Key insight (Karpathy):** "LLMs are exceptionally good at looping until they meet specific goals. Don't tell it what to do, give it success criteria and watch it go."

## 🎬 1600 SEAMLESS TRANSITIONS PACK (videohive jKoeHBTM) — KANONICKÁ CESTA

**⚠️ NIKDY NEHLEDAT JINDE — pack je TADY (2 GB, neztratit):**
- 📦 ZIP: `C:\Users\info\Downloads\01-CZECHAI\OBRAZKY\efekty\videohive-jKoeHBTM-transitions.zip`
- 📂 ROZBALENO: `C:\Users\info\Downloads\POD-DESIGNER\programy\Nastroje\videohive-jKoeHBTM-transitions\1600 Seamless Transitions\`

Obsah: 1521 MP4 · 5093 PNG matů · 138 SFX MP3 · 8 kategorií (BOKEH/BRUSH/FADE/GLITCH/INK/SEAMLESS/SLIDESHOW/SPLIT) + 1_MYFX Extension (.zxp pro Premiere/AE)
- Luma matte PNG sekvence: `2_Transitions/(footage)/Brush Mattes/Brush Transition N/` (48 ks, B&W, čisté)
- SFX: `2_Transitions/(footage)/Sound FX/{Fade,Glitch,Seamless,VFX}/`

**Nainstalováno napevno v hyperframes projektu:** `C:\Users\info\.claude-code\hyperframes-czechai\assets\sfx\` (162 SFX) + `assets\matte\` (8 brush matte klipů)