# 🧠 Second Brain

Zweites Gehirn für OpenClaw - Langzeit- und Kurzzeitgedächtnis mit Bewertung, Proaktivität und Selbstheilung.

## Features

- **Engramme** - Gedächtniseinheiten mit Confidence, Korrektheit, Verknüpfungen
- **SQLite + FTS5** - Lokaler Speicher ohne externe Abhängigkeiten
- **Hybrid-Retrieval** - Keyword-Suche + Reranking (später + Embeddings)
- **Correctness-Tracking** - Richtig/Falsch-Feedback mit Lern-Loop
- **Proaktivität** - Heartbeat + Cron für selbständige Checks
- **Fehlerheilung** - Fehler als Engramme, Mustererkennung, Auto-Fix
- **Dashboard** - HTML-Visualisierung, kein Framework nötig
- **OpenClaw-Bridge** - Direkte Integration in Agent-Sessions

## Schnellstart

```bash
cd /root/.openclaw/workspace/second-brain

# Engramm hinzufügen
python3 -m src.cli add "Das ist wichtig" --tag wichtig --source user

# Suchen
python3 -m src.cli search "wichtig"

# Feedback geben
python3 -m src.cli confirm <id>
python3 -m src.cli reject <id>

# Dashboard öffnen
python3 -m src.dashboard

# Stats
python3 -m src.cli stats

# Backup
python3 -m src.openclaw_bridge backup

# Tests
python3 -m tests.test_core
```

## Architektur

```
┌─────────────────┐     ┌──────────────┐     ┌────────────────┐
│   OpenClaw      │────▶│   Bridge     │────▶│  Engram Store  │
│   Agent         │     │  (Session)   │     │   (SQLite)     │
└─────────────────┘     └──────────────┘     └────────────────┘
       │                                               │
       ▼                                               ▼
┌─────────────────┐                           ┌──────────────┐
│   Heartbeat     │                           │  Retriever   │
│   (Cron/Check)  │                           │  (FTS + RR)  │
└─────────────────┘                           └──────────────┘
                                                      │
                                                      ▼
                                              ┌──────────────┐
                                              │   Dashboard  │
                                              │   (HTML)     │
                                              └──────────────┘
```

## Module

| Datei | Zweck |
|-------|-------|
| `src/engram.py` | Engramm-Modell, Confidence, Correctness |
| `src/store.py` | SQLite-CRUD, FTS5-Index, Backup/Export |
| `src/retriever.py` | Suche, Reranking, Verknüpfungen |
| `src/cli.py` | Kommandozeilen-Interface |
| `src/openclaw_bridge.py` | OpenClaw-Integration, Heartbeat, Fehler-Handling |
| `src/dashboard.py` | HTML-Dashboard-Generator |

## CI/CD

- **Repo**: http://192.168.6.31:3000/Otto/second-brain
- **Issues**: 8 offen (Features, Bugs)
- **Cron**: Täglich 2 Uhr Backup

## Nächste Schritte (Phase 2)

1. Vektor-Embeddings via sentence-transformers
2. ChromaDB-Store als Alternative zu SQLite
3. PyTorch Neural Scorer
4. Streamlit-Dashboard
5. Graph-Visualisierung (cytoscape.js)