feat(complete): Tests, README, Heartbeat, Dashboard

- tests/test_core.py: 6 Unit-Tests (alle grün)
- README.md: Vollständige Dokumentation
- HEARTBEAT.md: Proaktivitäts-Checkliste
- Cron: Backup täglich 2 Uhr

Closes #1, #6
This commit is contained in:
2026-05-25 01:05:49 +02:00
parent cf05dba944
commit 08d21f8087
2 changed files with 194 additions and 0 deletions

88
README.md Normal file
View File

@@ -0,0 +1,88 @@
# 🧠 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)