# FABRICA BIONIC - FISIER 1/2: CONTEXT & ARHITECTURA
(Lipeste ACEST fisier PRIMUL intr-un chat nou. Apoi lipeste Fisierul 2 = Roadmap. Impreuna dau sesiunii noi tot ce ii trebuie ca sa continue fara sa strice nimic.)

## 1. CINE & SCOP
- Eu = Adrian Moldovan, dev independent in Belgia, lucrez EXCLUSIV de pe iPhone (Termius SSH + Claude app).
- Vreau o FABRICA creativa permanenta, legata prin MCP de abonamentul Claude, care poate: lucra -> vedea -> testa -> repara -> livra, prin zeci de conectori si sute de tool-uri, cu traseu bine mapat si arhitectura logica.
- Scop final: producem SITE-uri / JOCURI / APP-uri printre cele mai puternice din lume, la calitate maxima. Fiecare piesa construita extrem de bine, etapa cu etapa, chiar daca dureaza luni / 100+ sesiuni.

## 2. PRINCIPII DE LUCRU (obligatoriu)
- Calitate peste viteza. O piesa pe rand, dusa la capat si verificata.
- Complexitatea NU = capacitate. Construim coloana (ochi + maini + pipeline + memorie) si tot se conecteaza pe ea.
- Assets REALE, nu jucarii (modele 3D reale din Blender / cadre AI 8K, nu particule care imita obiecte).
- Inginerie sincera: spun direct daca se poate sau nu. Fara entuziasm fals.
- Verific TERMINALUL real inainte sa presupun (vps_health / bash). Daca un tool lipseste, spun.
- Nimic "gata" fara: verificat de ochi (critic) SAU test functional + 0 erori consola + persistat + logat.

## 3. INFRA ACTUALA
- VPS Hetzner bionic-vps-01: CPX62, 16 core, 32GB RAM, FARA GPU. IP 46.225.225.131. root.
- ~37 servicii PM2, Caddy auto-TLS.
- Preview live: orice folder /root/builds/<slug>/ -> https://preview.bionicsovereign.dev/<slug>/ (instant).
- media-service (3031): imagini AI reale 8K (Flux/Leonardo). POST localhost:3031/generate {"prompt":...} -> {url}.
- model_router.py (/root/bionic-memory-v2/): Opus 4.8 prin abonament (CLI) + fallback Groq/Gemini/Ollama.
- Pipeline 8 agenti (/root/bionic-agents/: agent_flow.py, agents_roster.json, materialize.py) + critic Opus.
- Memorie/vault (Obsidian), design system OKLCH (/root/bionic-design-system).
- API Anthropic in /root/.env (cu credit) + abonament Max (generare via CLI).
- Disk ~81% plin (tight) - curatare periodica.

## 4. CONECTORI MCP & TOOLS (zeci/sute)
- Engine VPS (bash root): "Claude engine VPS" / "Engine 2" / "engine3" = DUPLICATE, folosesc UNUL singur. + vps_health.
- Proprii: Obsidianx1 (memorie/vault), Orchestrator (build/deploy/imagini), GitHub Bionic.
- Consumer (din abonament, cand sunt activi in sesiune): Supabase, Netlify, Vercel, Figma, Canva, Gmail (DRAFT only), Google Calendar, Google Drive, Notion, Slack, Linear, Cloudflare, Hugging Face, Exa s.a.
- "Sute de tool-uri" = tool-urile acestor conectori + scripturile de pe VPS + skills (100+ instalate).
- NOTA: nu toti conectorii sunt mereu activi. Verific la inceput ce am in sesiunea curenta.

## 5. CE E DEJA CONSTRUIT (Sesiunea 1 - OCHII)
- shot.js (/root/shots/): render headless chromium pe orice pagina live (WebGL software, fara GPU). Uz: node shot.js <url> <out.png> <waitMs>
- critic_json.py (/root/shots/, model sonnet-4-6): scor 0-10 + probleme + fix-uri exacte. Uz: python3 critic_json.py <png> "<brief>"
- Metrici culoare/luminanta + detectie ecran negru (render fail).
- auto_improve.py (/root/shots/): BUCLA AUTO shot->critic->Opus rescrie cod din fix-uri->repeta, tine cea mai buna versiune. Dovedit: hero 3D 2.4 -> 5.8/10 automat.
- Plan master: /root/FACTORY_MASTER_PLAN.md. Acest pachet: /root/factory/.

## 6. COMENZI CHEIE
- Generare cod premium (abonament Max), output text BUFFERED (scrie la final):
  env -u ANTHROPIC_API_KEY CLAUDE_FLOW_HOOKS_ENABLED=false MAX_THINKING_TOKENS=<n> claude -p "<prompt>" --model claude-opus-4-8 --output-format text [--append-system-prompt "<sys>"] --disallowedTools Bash Edit Write Read NotebookEdit Glob Grep WebFetch WebSearch Task TodoWrite < /dev/null
- Modele API: claude-opus-4-8 (top), claude-sonnet-4-6 (critic/ieftin), claude-haiku-4-5 (rapid).
- Chrome headless path salvat in /root/shots/.chrome_path

## 7. REGULI STRICTE
- bash_exec timeout ~60s. Joburi lungi: nohup in fundal + poll fisier status (sleep <=55). Nu astept in foreground > 55s.
- Transfer fisiere: heredoc cu 'EOF' quoted, linii scurte. NICIODATA base64 pe o singura linie uriasa.
- Editare: backup *.bak.$(date +%s) -> inlocuire literala -> node --check / python3 -m py_compile -> verificare (render/health) -> abia apoi gata.
- Un SINGUR engine MCP (nu mixez cele 3 duplicate).
- GitHub push doar prin Orchestrator/engine github_push (GitHub MCP = read-only/401).
- Inainte de orice build de PRODUS: BRIEF 7 intrebari (in Fisier 2).
- Niciun build premium fara trecere prin ochi (critic) + 0 erori consola.

## 8. LIMITE REALE (sincer)
- FARA GPU: Blender Eevee OK (modele/GLB, randari rapide); Cycles fotoreal = lent. AI imagini = via cloud (media-service).
- Jocuri web: plafon = WebGL stylized de TOP, NU AAA fotoreal in browser.
- Unele UI MCP (ex. Claude Design) = doar interfata, NU se apeleaza programatic din VPS -> sursa manuala de assets.
- AI nu scrie litere corect in imagini -> nume/semnaturi le pun ca text vector peste imagine.
- Disk limitat -> curatam.