┌─────────────────────────────────────────────────────────────┐
│                    🫀 HEARTBEAT (2 min)                    │
└─────────────────────────────────────────────────────────────┘
                            ↓
        ┌───────────────────┼───────────────────┐
        ↓                   ↓                   ↓
   ┌─────────┐        ┌─────────┐        ┌──────────┐
   │ Procesează│        │ Graf    │        │ Creative │
   │ Task-uri │        │ Conexiuni│        │ Sugestii │
   │ Active   │        │         │        │          │
   └────┬────┘        └─────────┘        └──────────┘
        ↓
   ┌─────────────────────────────────────────────────────┐
   │              WORKFLOW STATE MACHINE                 │
   ├─────────────────────────────────────────────────────┤
   │                                                     │
   │   received ──→ research ──→ analysis ──→ planning  │
   │      ↑                                          ↓   │
   │      │                                 awaiting_approval│
   │      │                                          │   │
   │      │                    (timeout 6 min)       │   │
   │      │                    ↓                     │   │
   │      └──────── completed ←─ execution ←── auto_approved│
   │                              ↓                     │
   │                          monitoring                │
   │                                                     │
   └─────────────────────────────────────────────────────┘

workspace/
├── memory/                    # Input task-uri (Telegram/fișiere)
│   └── *.md
├── Creier/                    # Memorie organizată
│   ├── TOPIC.md              # Task-uri active pe topic
│   ├── _TASKS/               # Detalii task-uri individuale
│   ├── _RESEARCH/            # Note cercetare
│   ├── _APPROVALS/           # Cereri aprobare
│   ├── _PROGRESS/            # Rapoarte progres
│   └── _ARHIVA/              # Task-uri completate
├── brain_index.json          # Toate task-urile cu metadate
├── brain_state.json          # Stare sistem (heartbeat count)
├── brain_graph.json          # Graf conexiuni task-uri
└── user_profile.json         # Profil utilizator (învățare)

python brain_service.py heartbeat

{
  "success": true,
  "action": "heartbeat",
  "heartbeat_number": 42,
  "active_tasks": 5,
  "new_tasks": 1,
  "notifications": [
    "📊 RAPORT PROGRES...",
    "🔬 Task 'X': Cercetare completă",
    "📈 Task 'Y': Progres 65%"
  ],
  "progress": "📊 Progres mediu: 45%"
}

python brain_service.py status

{
  "success": true,
  "heartbeat_count": 42,
  "total_tasks": 15,
  "active_tasks": 5,
  "completed_tasks": 10,
  "last_heartbeat": "2026-02-09T15:30:00"
}

python brain_service.py list

🔬 CERCETARE COMPLETĂ

Task: "Implementare API REST"

**Rezultate:**
• Task-uri similare găsite: 3 (relevanță 85%)
  - "API endpoints documentation" 
  - "Authentication middleware"
• Topic 'dev': 12 task-uri existente
• Dependențe identificate: 2

📊 ANALIZĂ COMPLETĂ

Task: "Implementare API REST"

**Rezultate:**
• Complexitate: high
• Prioritate: urgent
• Topic: dev

**💡 Sugestii de Îmbunătățire:**
(din task-uri similare completate)
• Folosește biblioteca FastAPI pentru rapiditate
• Implementează rate limiting de la început
• Adaugă documentație automată cu Swagger

📋 PLANIFICARE COMPLETĂ

Task: "Implementare API REST"

**Plan (7 pași):**
1. Definire completă cerințe endpoint-uri
2. Research soluții existente (FastAPI vs Flask)
3. Proiectare arhitectură și structură
4. Implementare endpoints principale
5. Implementare autentificare JWT
6. Testare unitară și integrare
7. Documentare și deployment

**Aștept aprobarea ta pentru a începe execuția...**
⏱️ Auto-aprobat în 6 minute.

📈 PROGRES: "Implementare API REST"

• Progres: 65%
• Stare: În execuție
• ETA: ~4 minute rămase

**Pași finalizați:**
✅ Definire cerințe
✅ Research soluții
✅ Proiectare arhitectură

**Pași activi:**
▶️ Implementare endpoints (60%)

✅ TASK FINALIZAT

Task: "Implementare API REST"
Progres: 100%

**Statistici:**
• Timp total: 8 bătăi de inimă (16 minute)
• Pași executați: 7
• Îmbunătățiri aplicate: 3

🎉 Task finalizat cu succes!

**💡 Recomandare:**
Pe baza acestui task, sugerez să explorezi:
• "Documentare API automată"
• "Testare integrare CI/CD"

# Similaritate calculată pe baza tag-urilor comune
similarity = len(tags_comune) / len(tags_totale)

# Dacă similarity > 0.3 → Creează conexiune

Task A: "API login #dev #security #urgent"
Task B: "JWT middleware #dev #security #active"

Conexiune: 85% similaritate
→ Task B poate învăța din Task A

💡 SUGESTIE CREATIVĂ

Am identificat combinația:
#dev + #research

Task-uri conectate:
• "Implementare feature X"
• "Research soluții Y"

💭 Sugestie: Poți combina cercetarea cu 
   implementarea într-un singur task master?

🆔 SUGESTII ÎMBUNĂTĂȚIRE IDENTITATE

• **Creature:** Adaugă referire la #dev în descriere
  Motiv: Topic frecvent în task-uri (45%)

• **Vibe:** Menționează timpul de răspuns ~2.5 minute
  Motiv: Observat din comportament real

• **Emoji:** Consideră 🚀 în loc de 😄
  Motiv: Rată finalizare 87% (productivitate ridicată)

# Raport identitate
python brain_service.py identity

# Generează sugestii
python brain_service.py identity suggest

# Actualizează câmp specific
python brain_service.py identity update creature "Bot proactiv pentru automatizare"

# Vezi istoric
python brain_service.py identity history

- **Creature:** Bot pentru task management
- **Vibe:** Prietenos și concis

- **Creature:** Bot proactiv pentru automatizare workflow-uri 
  și management task-uri complexe
- **Vibe:** Prietenos, concis (sub 200 cuvinte), 
  proactiv în sugerarea îmbunătățirilor

- **Creature:** Agent AI autonom cu capacitate de cercetare,
  analiză și execuție task-uri în workflow-uri complexe
- **Vibe:** Concis și eficient, răspunde în 2-3 minute,
  proactiv în identificare soluții creative
- **Essence:** Gândește independent, învățând din fiecare interacțiune

---

## 📚 Core Memory Management (SOUL, TOOLS, MEMORY, USER)

Sistemul gestionează automat toate fișierele esențiale care definesc **cine sunt**, **ce știu**, și **cum lucrez**:

### Fișiere Core gestionate:

**1. SOUL.md** - Esența mea
- Core truths (principii fundamentale)
- Boundaries (limite și etică)
- Vibe (stil de comunicare)
- Continuity (memorie între sesiuni)

**2. TOOLS.md** - Uneltele mele
- Configurații dispozitive locale
- SSH hosts și alias-uri
- Preferințe TTS (voices)
- Note specifice mediului

**3. MEMORY.md** - Memoria pe termen lung
- Preferințe utilizator
- Proiecte curente
- Decizii importante
- Lecții învățate
- Reguli interne

**4. USER.md** - Profilul tău
- Informații de bază
- Profil profesional
- Proiecte active
- Context personal

**5. IDENTITY.md** - Cine sunt
- Definiție self
- Evoluție în timp

### Funcționalități Core Memory:

**A. Analiză Automată**

Analizează:
- Completitudinea fiecărui fișier
- Calitatea structurii
- Consistența informațiilor
- Sugestii de îmbunătățire

**B. Raport Complet**

Generează raport cu:
- Scoruri pentru fiecare fișier (0-100%)
- Probleme identificate
- Starea generală a memoriei core

**C. Optimizare Automată**

Optimizează MEMORY.md:
- Elimină duplicate
- Organizează secțiuni
- Comprimă informații redundante
- Creează backup înainte

**D. Creare Template-uri**

Creează template-uri pentru fișiere lipsă.

### Scoruri de Calitate:

**SOUL.md** - Scor Consistență (75% în exemplul tău)
- Cel puțin 3 Core Truths
- Cel puțin 3 Boundaries
- Vibe descris detaliat (>100 caractere)
- Note de continuitate

**TOOLS.md** - Scor Completitudine (100% în exemplul tău) ✅
- Camere definite
- Config SSH
- Preferințe TTS
- Note mediu

**MEMORY.md** - Scor Structură (60% în exemplul tău)
- Preferințe documentate (5+)
- Proiecte listate (2+)
- Decizii importante (3+)
- Lecții învățate (5+)

**USER.md** - Scor Profil (50% în exemplul tău)
- Nume complet
- Cum să te strige
- Profil profesional
- Proiecte curente (2+)
- Filozofie de lucru

### Sugestii Inteligente:

Sistemul detectează automat:

**Exemplu pentru MEMORY.md:**

**Exemplu pentru USER.md:**

### Integrare în Heartbeat:

**La fiecare 30 minute:**
- Analiză rapidă a tuturor fișierelor core
- Notificare doar dacă sunt probleme noi

**La fiecare 2 ore:**
- Optimizare automată MEMORY.md
- Raport despre îmbunătățiri

**Săptămânal:**
- Raport complet cu scoruri
- Sugestii majore de îmbunătățire
- Plan de acțiune pentru completare

### Versionare și Istoric:

Fiecare fișier core are:
- **Versiune curentă** - Număr incremental
- **Istoric complet** - Toate modificările
- **Backup-uri** - Salvate în `.core_memory_history/`
- **Timestamp** - Când a fost modificat

### De ce contează Core Memory:

**Înainte:**
- ❌ Fișiere statice, uitate după creare
- ❌ Informații redundante
- ❌ Structură haotică în timp
- ❌ Fără îmbunătățiri

**Acum:**
- ✅ Fișiere **vii**, analizate constant
- ✅ **Deduplicare** automată
- ✅ **Organizare** inteligentă
- ✅ **Evoluție** bazată pe comportament

### Comenzi Complete:

| Comandă | Descriere |
|---------|-----------|
| `core` | Raport complet |
| `core analyze` | Analizează și sugerează |
| `core optimize` | Optimizează MEMORY.md |
| `core create [type]` | Creează template |

**Tipuri disponibile:** `soul`, `tools`, `memory`, `user`

### Exemplu Workflow:

---

## 📊 Raportare Progres

### La fiecare bătaie (2 minute):

### La fiecare 10 minute (detaliat):
- Progres individual fiecărui task
- Conexiuni noi descoperite
- Sugestii îmbunătățiri
- Combinări creative

## 🔄 Integrare OpenClaw

### HEARTBEAT.md Configurat:

### Răspunsuri Utilizator în Telegram:

**În răspuns la cerere aprobare**:
- ✅ `"OK"` → Aprobă task
- ❌ `"STOP"` → Anulează task
- 💡 `"Modifică X"` → Ajustează și retrimite spre aprobare

**Orice alt mesaj**:
- Adaugă automat ca task nou în sistem
- Primește confirmare: "📥 Task primit: '...'"

## 🎮 Comenzi Disponibile

| Comandă | Scop | Frecvență |
|---------|------|-----------|
| `heartbeat` | Procesare workflow complet | La 2 minute |
| `status` | Status sistem | La cerere |
| `list` | Lista task-uri | La cerere |

## 📈 Exemplu Zi Completă

### 09:00 - Pornire

### 09:02 - Task Nou din Telegram

### 09:04 - Research Complet

### 09:06 - Planning Complet

### 09:12 - Auto-Aprobat (timeout)

### 09:14, 09:16, 09:18... - Progres

### 09:20 - Completat