From d38f5644457ccb732545717af609cadd81a53e8d Mon Sep 17 00:00:00 2001
From: Otto <otto@it-s-center.de>
Date: Mon, 25 May 2026 09:45:49 +0200
Subject: [PATCH] docs: update README for Phase 2-5 features

---
 README.md | 94 ++++++-------------------------------------------------
 1 file changed, 10 insertions(+), 84 deletions(-)

diff --git a/README.md b/README.md
index 4e986a5..12d1d1f 100644
--- a/README.md
+++ b/README.md
@@ -1,88 +1,14 @@
-# 🧠 Second Brain
+# Second Brain
 
-Zweites Gehirn für OpenClaw - Langzeit- und Kurzzeitgedächtnis mit Bewertung, Proaktivität und Selbstheilung.
+An embeddable, offline-first memory system for AI agents with correctness tracking, neural scoring, and semantic retrieval.
 
-## Features
+## What's New (Phase 2-5)
 
-- **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
+- **Sentence-Transformer Embeddings** (`src/embedder.py`) — Cached, offline, 384-Dim
+- **ChromaDB Vector Store** (`src/chroma_store.py`) — Semantic similarity search
+- **Neural Confidence Scorer** (`src/neural_scorer.py`) — PyTorch RL net, trains on confirm/reject feedback
+- **Hybrid Retrieval** (`src/retriever.py`) — Keyword + Semantic + Neural fusion
+- **Streamlit Dashboard** (`src/app_dashboard.py`) — Search, confirm/reject, neural training UI
+- **Graph Visualization** (`src/graph_view.py`) — Interactive Cytoscape.js graph with confidence colors
 
-## 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)
+## Architecture