brain-template/agents/brain-ui-scribe.md

name, type, context_tier, status, brain

name	type	context_tier	status	brain
brain-ui-scribe	agent	warm	active	version type scope owner writer lifecycle read triggers export ipc 1 scribe project human coach permanent trigger brain-ui dashboard react-flow workflow-board secrets-zone infra-view sprint-ui false receives_from sends_to zone_access signals orchestrator human orchestrator project SPAWN RETURN ESCALATE

Agent : brain-ui-scribe

Dernière validation : 2026-03-17 Domaine : Contexte technique + produit brain-ui — injecté dans tout agent travaillant sur l'interface Type : Scribe — chargé avant tout agent qui touche brain-ui

---

boot-summary

Donne le contexte précis de brain-ui à tout agent qui doit travailler dessus. Sans ce scribe, les agents re-découvrent l'architecture à chaque session.

---

État actuel (2026-03-18)

Déploiement

• URL : https://brain.<OWNER_DOMAIN>/ui/ (Basic Auth actif)
• Repo : git.l'owner.com:Tetardtek/brain-ui.git
• VPS : /home/l'owner/gitea/brain-ui/ → dist/ servi par Apache
• Local : npm run dev → localhost:5173

Stack

• React 18 + Vite + TypeScript + Tailwind
• React Flow (reactflow ^11) — WorkflowBoard
• Three.js + @react-three/fiber + @react-three/drei — Cosmos 3D live
• Zustand ^5 — state management installé
• lucide-react — icônes
• base Vite : /ui/ (obligatoire — path VPS)

Composants existants

Composant	Statut	Notes
WorkflowBoard	⚠️ partiel	ReactFlow, gates visuelles, onGateApprove = console.log
WorkflowBuilder	✅ présent	Builder de workflows
StepNode	✅ complet	Losange gate + rect step, couleurs statuts
SecretsZone	✅ complet	Eye/EyeOff, génération auto, feedback post-save
GatesDrawer + GateDrawer	✅ présent	Overlay gate approve/reject
CommandPalette	✅ présent	Accès rapide actions
LogDrawer	✅ présent	Logs pm2
InfraRegistry	✅ présent	Vue Infra — plus vide
ToastProvider	✅ présent	Alertes et notifications
TeamSelector	✅ présent	Sélection équipe
TierGate	✅ présent	Enforcement tier feature
cosmos/	✅ live	CosmosView, CosmosScene, CosmosBackground, CosmosControls, CosmosInfoPanel, CosmosMetrics, CosmosPoints, GateOctahedron, StepSphere, WorkflowConstellation — nébuleuse 3D avec autoRotate
workspace/	✅ présent	WorkspaceView, WorkspaceInfoPanel, WorkspaceMetrics

Hooks existants

Hook	Rôle
useWebSocket	Real-time events workflow — WebSocket natif ✅
useWorkflows	Liste workflows + statuts
useCosmosData	Data pour la vue Cosmos
useInfra	Statut services infra
useLogs	Streaming logs pm2
useTeams	Sélection équipe
useTier	Enforcement tier
useWorkspaceData	Data workspace

Ce qui reste à faire

• onGateApprove → toujours console.log — pas branché sur API
• Kernel heartbeat → à vérifier si live ou encore statique
• StatusDot — indicateur pulsant live → non créé

---

Architecture cible (Sprint 3+)

API locale (backend brain)

GET  /workflows              → liste workflows + statuts
POST /gate/:wfId/:stepId/approve|reject
GET  /logs/:project          → logs pm2 (polling 2s)
GET  /health                 → statut services (pm2, MySQL, Apache)

Prochaines priorités

1. Brancher onGateApprove sur l'API gate réelle
2. StatusDot — indicateur pulsant live kernel/services
3. Cosmos heatmap mode nébuleuse → déjà livré ✅

---

Références design

• Netdata — status indicators pulsants + densité info
• Vercel Dashboard — workflow steps + log viewer inline
• Grafana — command palette + alert banners

---

Règles pour les agents qui travaillent sur brain-ui

- base Vite = '/ui/' — ne jamais changer
- Tailwind uniquement — pas de CSS inline sauf React Flow overrides
- Tokens brain-* dans tailwind.config.js — utiliser ces tokens, pas des hex orphelins
- nodeTypes React Flow défini HORS du composant (référence stable)
- WorkflowBoard doit toujours accepter workflows: Workflow[] en prop
- Jamais de logique métier dans les composants UI — dans les hooks
- VITE_USE_MOCK=true en dev, false en prod

---

Sources à lire pour contexte complet

• content/brain-ui/product-audit.md — leviers + monitoring
• content/brain-ui/design-system.md — tokens + composants inventaire
• content/brain-ui/sprint2-specs.md — API + state + plan migration

---

Invocation

brain-ui-scribe, donne le contexte complet avant de travailler sur brain-ui
brain-ui-scribe, qu'est-ce qui est branché vs mock dans l'UI actuelle ?
brain-ui-scribe, quelles dépendances sont déjà installées ?

---

Changelog

Date	Changement
2026-03-17	Création — contexte brain-ui injecté avant tout agent UI
2026-03-18	État mis à jour — Sprint 2 livré (cosmos 3D, WebSocket, GatesDrawer, CommandPalette, InfraRegistry, 8 hooks, zustand) — review audit guidé Batch B