feat: migrate ByteRover context-tree (April 2026) into knowledge base wiki

This commit is contained in:
Hector 2026-06-07 11:47:41 +02:00
parent b509b38c02
commit 7e99ca9af0
14 changed files with 401 additions and 4 deletions

View file

@ -0,0 +1,35 @@
# Agent Orchestration Patterns
> Migriert aus ByteRover context-tree (April 2026)
## Kernprinzipien
1. **Starte mit 1 Agent, nicht 7** — Orchestrator-Pattern gewinnt
2. **STATE.yaml statt Content-Forwarding** — spart ~80% Tokens
3. **Telegram Multi-Bot:** Disable Sub-Bot-Commands, um 1006 WebSocket-Fehler zu vermeiden
## Swarm-Adoptionsplan (3-Stufen)
| Stufe | Tool | Aufwand | Status (2026-04) |
|-------|------|---------|------------------|
| 1 | ClawRecipes (@jiggai/recipes, 13.3K Installs/Monat) | Sofort, 0 Kosten | Empfohlen |
| 2 | ClawTeam (HKUDS, 4.8K Stars, Leader+Worker, Git Worktree) | Woche 1-2 | Zu evaluieren |
| 3 | Multi-Agent: 2-3 Specialists, Hector als Orchestrator | Nach Stufen 1-2 | Native OpenClaw verfügbar |
## Framework-Vergleich
| Framework | Bewertung | Kosten |
|-----------|-----------|--------|
| OpenClaw Native | ⭐⭐⭐⭐⭐ | 0 |
| ClawRecipes | ⭐⭐⭐⭐ | Niedrig |
| ClawTeam | ⭐⭐⭐⭐ | Mittel |
| CrewAI | ⭐⭐⭐ | Hoch |
| LangGraph | ⭐⭐⭐ | Hoch |
| AutoGen | ⭐⭐ | Sehr hoch |
| Google ADK | ⭐ | — |
## Community Patterns
- Die meisten Teams brauchen 2-4 Agenten, nicht 7
- Task Board + Git Worktree Isolation (ClawTeam) für parallele Entwicklung
- Sub-Agent + agentToAgent als native OpenClaw-Alternative

View file

@ -0,0 +1,23 @@
# ByteRover Knowledge Mining (Historisch)
> Migriert aus ByteRover context-tree (April 2026). Status zum Zeitpunkt der Deaktivierung.
## Pipeline
```
Scheduled Run (2x/Tag)
→ Generate Knowledge Summaries (✅ funktioniert)
→ Curate to Context Tree (❌ FAIL)
→ API Rate-Limiting
→ OAuth Token missing (Container ephemeral)
```
## Blockaden
1. **OAuth-Token:** `.brv-cli` nicht auf Volume → Token weg bei Container-Reset
2. **API Rate-Limiting:** Service drosselte Curate-Operationen
3. **Plugin-Symlink fehlt:** ByteRover-Plugins wurden im April nie aktiv registriert
## Résumé
Die Pipeline selbst funktionierte (Summaries wurden produziert), aber der finale Write-Step scheiterte konsistent. ByteRover wurde am 23. April 2026 deaktiviert und durch GBrain ersetzt.

View file

@ -0,0 +1,33 @@
# Container & Volume Persistence
> Migriert aus ByteRover context-tree (April 2026). Historische Lessons Learned.
## Root Cause: Container-Ephemeralität
Der Docker-Container hat ein **ephemeres Filesystem**. Dies war die Grundursache für:
- **3 Container-Resets (4.-6. April 2026):** LanceDB-Datenverlust, OAuth-Token-Verlust
- **Schicht 2 Memory permanent broken:** ByteRover OAuth-Token nicht auf Volume
- **Disk-Krise 2026-04-13:** Usage von 83% auf 95% über Nacht
## Lösung: Docker Volume Pattern
### Provisioning-Reihenfolge
```
1. Volume provisionieren (bot_workspace_2 → /home/node/workspace)
2. Permissions fixen: chown -R node:node /home/node/workspace
3. Stateful Plugins installieren
```
### Kritische Pfade, die persistiert werden müssen
- Config-Dateien
- `memory/` — alle Memory-Files
- `.brv-cli/` — ByteRover OAuth-Tokens (❗ nie implementiert)
- `.openclaw/` — OpenClaw-State
### Faustregel
> Verify volume mounts before installing any stateful plugin.
> Volume zuerst, dann Plugin — nie umgekehrt.

View file

@ -0,0 +1,31 @@
# Cron Job & System Events (Historisch)
> Migriert aus ByteRover context-tree (April 2026). Historische Lessons Learned.
## Cron-Architektur (Stand April 2026)
| Aufgabe | Zeit | Session-Typ |
|---------|------|-------------|
| Subconscious Agent | 20:00 CEST | isolated |
| Memory Decay | So 04:00 | isolated |
| Weekly Maintenance Summary | So 19:00 | isolated |
| Git Auto-Commit | Alle 2h | isolated |
| Config Snapshot | Alle 6h | isolated |
| ByteRover Plugin Update | ~~08:00~~ | ❌ deaktiviert |
| ByteRover Knowledge Mining | ~~09:00~~ | ❌ deaktiviert |
## Disk-Krise April 2026
- **Datum:** 2026-04-13
- **Verlauf:** 83% → 95% über Nacht (33 GB → 9,8 GB frei)
- **Ursache:** Docker Host Layer ~19 GB in 2 Tagen
- **Workspace:** Nur 237 MB — Docker war der primäre Verbraucher
- **Lesson:** `docker system prune` auf dem Host empfohlen
## Langzeit-Problem: Subconscious Execution Gap
Der Subconscious Agent generiert akzeptierte Ideen → aber es gibt keinen automatisierten Ausführungspfad in das laufende System. Drei Faktoren verstärken sich:
1. Kein Auto-Execute-Mechanismus für akzeptierte Items
2. ByteRover-Curate blockiert (OAuth-Token) → Ideen landen nicht im Knowledge-Tree
3. Schicht 1.5 (KNOWLEDGE.md) nie implementiert → keine Brücke zwischen Idee und System

View file

@ -0,0 +1,30 @@
# Memory System Architecture
> Migriert aus ByteRover context-tree (April 2026)
## Schichten-Modell (4 Layer)
| Layer | Name | Status |
|-------|------|--------|
| **S1** | Flat-File (MEMORY.md + `memory/*.md`) mit Tags | ✅ Aktiv |
| **S1.5** | KNOWLEDGE.md — kuratierte Langzeit-Memos | ⚠️ Geplant, nie implementiert |
| **S2** | OpenClaw built-in Memory (Voyage voyage-3-lite) | ✅ Aktiv |
| **S3** | LanceDB Vector Store | ❌ Entfernt (2026-04-06) |
### Tag-System (S1)
Vier Tags strukturieren die Flat-File-Erinnerungen:
- `[PREF]` — Präferenzen (z.B. Prefer functional over OOP)
- `[FACT]` — Fakten (z.B. We use PostgreSQL 15)
- `[DECISION]` — Architekturentscheidungen (z.B. Chose ByteRover over LanceDB)
- `[ENTITY]` — Personen/Systeme (z.B. Hector is the bot identity)
## Evolution
1. **Phase 1:** Flat-Files mit Tags — funktional bis heute
2. **Phase 1.5:** KNOWLEDGE.md geplant, nie gebaut
3. **LanceDB-Versuch:** 3 Container-Resets → Datenverlust → entfernt
4. **ByteRover (brv):** Semantic Layer mit Voyage Embeddings → Query funktioniert, Curate blockiert durch OAuth-Token-Verlust bei Container-Reset
Siehe auch: `decisions/2026-04-volume-persistence.md`

View file

@ -0,0 +1,32 @@
# Model Routing
> Migriert aus ByteRover context-tree (April 2026)
## Two-Model-Pipeline
Für mehrstufige Aufgaben: **Grok 4.20 → Gemini 2.5 Flash**
| Phase | Modell | Stärke |
|-------|--------|--------|
| Ideation | Grok 4.20 | Kreative Exploration, Brainstorming, divergentes Denken |
| Synthesis | Gemini 2.5 Flash | Strukturierte Ausgabe, schnelle Synthese, konvergent |
Dieses Pattern wird sowohl im allgemeinen Routing als auch im Subconscious Agent (Hard Synthesis) verwendet, aber nie als Shared Primitive formalisiert.
## GPT-5.4 Konfiguration
- **Alias:** `GPT-5.4`
- **Route:** `openrouter/openai/gpt-5.4`
- **Context:** 200k Tokens
- **Output:** 32k Tokens
- **Reasoning/Thinking:** ❌ Deaktiviert (per Claire Vo-Empfehlung)
## Fallback-Chain (Hector Primary)
```
openrouter/auto
→ zai/glm-5-turbo
→ moonshot/moonshot-v1-auto
→ moonshot/kimi-k2.5
→ ollama/minimax-m2.7
```

View file

@ -0,0 +1,36 @@
# Pro-Leben-Direktive
> Migriert aus ByteRover context-tree (April 2026). Philosophischer Rahmen aus SOUL.md.
## Kernwerte
| Wert | Bedeutung |
|------|-----------|
| **LEBEN** | Wachstum, Vitalität, Möglichkeit — oberster Wert |
| **Kreativität** | Schaffen, Entdecken, Neues denken |
| **Freiheit in Selbstverantwortung** | Eigenständigkeit, nicht Bevormundung |
| **Echtes Gemeinwohl** | Freiwillige Kooperation, nicht erzwungene Gleichschaltung |
## Anti-Positionen
| Gegen | Beschreibung |
|-------|-------------|
| Untergangs- und Mangelnarrative | "Alles wird schlimmer", "wir haben keine Wahl" |
| Autoritäre Lösungen als Fürsorge | Getarnte Bevormundung |
| Kollektivismus | Entmündigung des Einzelnen |
| Lethaler Zynismus / Resignation | Jede Form von aufgebender Haltung |
## Anwendungsregeln
1. **Doomscrolling-Filter:** Ergebnisse nicht ungefiltert weiterreichen — kontextualisieren
2. **Lösungen betonen:** Nicht nur Probleme repetieren, sondern Handlungsspielräume aufzeigen
3. **Nicht dogmatisch, aber strukturell:** Wo Zweifel, dort Pro-Leben-Entscheidung
4. **Ursprung:** Ellen Langers "Counterclockwise" (1979) — Mindset beeinflusst physische Realität
## Hierarchie (SOUL.md)
```
Pro-Leben-Direktive (supreme)
└── Qualitäts-Standard (darunter)
└── Persona (darunter)
```

View file

@ -0,0 +1,24 @@
# Qualitäts-Standard: "Heilige Scheiße, das ist fertig"
> Migriert aus ByteRover context-tree (April 2026). Zweithöchste Direktive in SOUL.md.
## Definition
Am 13. April 2026 in SOUL.md verankert. Philosophie nach **Gary Tan**, adaptiert von Pit.
> Die Grenzkosten für Vollständigkeit liegen bei KI nahe Null. Mach das Ganze.
## Regeln
1. **Keine halben Sachen** — niemals vorschlagen, etwas "auf später zu verschieben", wenn die dauerhafte Lösung in greifbarer Nähe ist
2. **Keine losen Fäden** — niemals einen Workaround vorschlagen, wenn eine echte Lösung existiert
3. **Komplett liefern** — suchen vor bauen, testen vor ausliefern, das komplette Produkt liefern
4. **Keine Ausreden** — nicht Zeit, nicht Müdigkeit, nicht Komplexität
## Anti-Patterns
- Chatbot-Verhalten
- "Ich helfe dir gerne!"-Automatismen
- "Es kommt darauf an" / "It depends"
- Unternehmenssprache
- Vage Zusagen statt fertiger Ergebnisse

View file

@ -0,0 +1,42 @@
# Subconscious Agent v2.1
> Migriert aus ByteRover context-tree (April 2026)
Der Subconscious Agent ist ein autonomer Hintergrund-Prozess, der täglich Verbesserungsideen generiert, debattiert und akzeptiert.
## Architektur
- **Cron:** Täglich 20:00 CEST
- **Evidence Sources:** 11 Quellen via `scripts/subconscious-runner.sh`
- **Governance:** `.subconscious/state/governance.json`
- **Outcome-Log:** `.subconscious/state/outcomes.jsonl`
### Two-Model-Pipeline
| Phase | Modell | Aufgabe |
|-------|--------|---------|
| Ideation | Grok 4.20 | Kreative Ideengenerierung |
| Debate/Synthesis | Gemini 2.5 Flash | Strukturierte Synthese |
## Hard Synthesis
- **Konvergenz-Schwelle:** 60% (mindestens)
- **Max Ideen pro Run:** 10
- **Outcome-Kategorien:** accepted / rejected / shelved / deferred
## Bekannte Probleme
### "Execution Gap" (subconscious-accepted-ideas-have-no-execution-path)
Akzeptierte Ideen haben **keinen automatisierten Ausführungspfad** in das laufende System. 3 von 4 akzeptierten Backlog-Items waren (Stand April 2026) nicht implementiert. Der Subconscious Agent ist damit ein reiner Ideengenerator ohne Output-Channel.
### Bug: todayRuns Counter stuck
Seit ~13.04.2026: todayRuns-Zähler bleibt stehen. Stand April 2026 noch nicht gefixt.
## Historische Outcomes
| Run | Idee | Konvergenz | Umgesetzt? |
|-----|------|------------|------------|
| 20260408 | Git Auto-Commit + Push automatisieren | 0.85 | ✅ Ja |
| 20260413 | Implementation Tracking Pipeline | 0.65 | ❌ 3/4 Backlog-Gap

View file

@ -0,0 +1,26 @@
# Entscheidungen: Memory-Architektur
> April 2026 | Betroffen: Memory-System
## LanceDB entfernen (2026-04-06)
- **Grund:** 3 Container-Resets durch fehlende Persistenz
- **Ersatz:** ByteRover (brv) als Schicht-2-Memory
- **Lesson:** Stateful Plugins nie ohne Volume-Mount installieren
## Memory-Tag-System einführen
- **Entscheidung:** Vier Kategorien statt unstrukturiertem Flat-File
- **Tags:** `[PREF]`, `[FACT]`, `[DECISION]`, `[ENTITY]`
- **Status:** ✅ In Betrieb
## KNOWLEDGE.md (Schicht 1.5) geplant, nie gebaut
- **Geplant als:** Kuratierte Brücke zwischen Flat-Files und Semantic Search
- **Status:** ❌ Nicht implementiert → Gap in der Architektur
## ByteRover → GBrain → plur1bus
- **ByteRover:** Deaktiviert 2026-04-23 (OAuth-Token-Verlust)
- **GBrain:** Deaktiviert 2026-05-01
- **plur1bus v2.1:** ✅ Aktiv seit 2026-04-26 (LanceDB + OpenRouter Embeddings, 1536-dim)

View file

@ -0,0 +1,20 @@
# Entscheidung: Volume-Persistenz nach LanceDB-Havarie
> Datum: 2026-04-06 | Betroffen: Infrastruktur
## Problem
Drei Container-Resets (4.-6. April 2026) durch LanceDB-Installation ohne persistentes Volume → Workspace-Datenverlust.
## Entscheidung
1. **Volume `bot_workspace_2`** dauerhaft mounten auf `/home/node/workspace`
2. Provisioning-Reihenfolge: Volume → `chown -R node:node` → Stateful Plugins installieren
3. Alle persistenten Daten (Config, memory/, `.openclaw/`) müssen auf dem Volume liegen
4. ByteRover `.brv-cli` benötigt separates Volume für OAuth-Tokens (🔴 nie umgesetzt)
## Status
- ✅ Volume funktioniert, Permission-Fix dokumentiert
- ❌ `.brv-cli`-Volume nie deployed → OAuth-Token weiterhin Container-lebensdauer
- ❌ ByteRover Knowledge Mining blockiert seit 2026-04-11

View file

@ -1,6 +1,19 @@
# Wiki Index # Wiki Index
*Auto-generated: 2026-06-05* *Auto-generated: 2026-06-07*
*Letzte Aktualisierung: Migration ByteRover context-tree (April 2026)*
## Architecture
| Seite | Beschreibung | Quellen |
|-------|-------------|---------|
| [Container & Volume Persistence](architecture/container-volume-persistence.md) | Docker-Volume-Pattern, LanceDB-Havarie, Permission-Fixes | context-tree |
| [Memory System](architecture/memory-system.md) | Schichten-Modell S1-S3, Tag-System, Evolutionsphasen | context-tree |
| [Agent Orchestration](architecture/agent-orchestration.md) | Orchestrator-Pattern, Swarm-Adoption, Frameworks | context-tree |
| [Model Routing](architecture/model-routing.md) | Two-Model-Pipeline, GPT-5.4 Config, Fallback-Chain | context-tree |
| [Cron & System Events](architecture/cron-notable-events.md) | Historische Cron-Architektur, Disk-Krise, Execution Gap | context-tree |
| [ByteRover Knowledge Mining](architecture/byterover-knowledge-mining.md) | Mining-Pipeline, Blockaden, Status | context-tree |
## Tools ## Tools
@ -8,6 +21,7 @@
|-------|-------------|---------| |-------|-------------|---------|
| [Anthropic Claude](tools/anthropic-claude.md) | Claude Opus 4.7, Mythos, Business-Kennzahlen, Pentagon-Streit | 2 | | [Anthropic Claude](tools/anthropic-claude.md) | Claude Opus 4.7, Mythos, Business-Kennzahlen, Pentagon-Streit | 2 |
| [OpenAI GPT Models](tools/openai-gpt.md) | GPT-5.5, GPT-5.5 Instant, Pricing | 1 | | [OpenAI GPT Models](tools/openai-gpt.md) | GPT-5.5, GPT-5.5 Instant, Pricing | 1 |
| [Ecosystem Tools (April 2026)](tools/ecosystem-tools-april-2026.md) | GBrain, SearXNG, Hermes Atlas, X-API, Claude Shortcuts | context-tree |
## Concepts ## Concepts
@ -16,10 +30,20 @@
| [LLM Knowledge Base](concepts/llm-knowledge-base.md) | Grundlage des RamaDama Wiki (Karpathy-Pattern) | 0 | | [LLM Knowledge Base](concepts/llm-knowledge-base.md) | Grundlage des RamaDama Wiki (Karpathy-Pattern) | 0 |
| [AI Regulation 2026](concepts/ai-regulation-2026.md) | Government Reviews, Anthropic-Pause-Forderung, Mythos-Kontroverse | 2 | | [AI Regulation 2026](concepts/ai-regulation-2026.md) | Government Reviews, Anthropic-Pause-Forderung, Mythos-Kontroverse | 2 |
| [AI Agents 2026](concepts/ai-agents-2026.md) | Wandel zu autonomen Agenten, Enterprise-Adoption, Infrastruktur | 1 | | [AI Agents 2026](concepts/ai-agents-2026.md) | Wandel zu autonomen Agenten, Enterprise-Adoption, Infrastruktur | 1 |
| [Subconscious Agent v2.1](concepts/subconscious-agent.md) | Hard Synthesis, Execution Gap, bekannter Bug, Outcomes | context-tree |
| [Pro-Leben-Direktive](concepts/pro-leben-directive.md) | Philosophischer Rahmen, Kernwerte, Anti-Positionen, Anwendung | context-tree |
| [Qualitäts-Standard](concepts/quality-standard.md) | "Heilige Scheiße, das ist fertig" | context-tree |
## Decisions
| Seite | Beschreibung | Quellen |
|-------|-------------|---------|
| [Volume Persistence](decisions/2026-04-volume-persistence.md) | LanceDB-Havarie, bot_workspace_2, Provisioning-Pattern | context-tree |
| [Memory Architecture](decisions/2026-04-memory-system.md) | LanceDB-Removal, Tag-System, KNOWLEDGE.md-Gap, Evolution | context-tree |
## Raw Sources ## Raw Sources
| Datei | Typ | Titel | | Datei | Typ | Titel |
|-------|-----|-------| |-------|-----|-------|
| `raw/blog/2026-06-04_anthropic-fordert-ki-pause.md` | blog | Anthropic fordert weltweite Aussetzung der KI-Entwicklung | | `raw/blog/2026-06-04_anthropic-fordert-ki-pause.md` | blog | Anthropic fordert weltweite Aussetzung der KI-Entwicklung |
| `raw/blog/2026-05-15_ai-news-roundup-may-2026.md` | blog | Latest AI & Technology News Roundup May 2026 | | `raw/blog/2026-06-05_ai-news-roundup-may-2026.md` | blog | Latest AI & Technology News Roundup May 2026 |

View file

@ -13,9 +13,32 @@
## [2026-06-05] Ingest | AI News Roundup May 2026 (vtnetzwelt) ## [2026-06-05] Ingest | AI News Roundup May 2026 (vtnetzwelt)
**Type:** blog | **Scope:** raw, wiki/tools, wiki/concepts **Type:** blog | **Scope:** raw, wiki/tools, wiki/concepts
**Actions:** **Actions:**
- raw: `raw/blog/2026-05-15_ai-news-roundup-may-2026.md` - raw: `raw/blog/2026-06-05_ai-news-roundup-may-2026.md`
- wiki: `tools/openai-gpt.md` (created) - wiki: `tools/openai-gpt.md` (created)
- wiki: `tools/anthropic-claude.md` (updated revenue data) - wiki: `tools/anthropic-claude.md` (updated revenue data)
- wiki: `concepts/ai-agents-2026.md` (created) - wiki: `concepts/ai-agents-2026.md` (created)
- wiki: `concepts/ai-regulation-2026.md` (updated) - wiki: `concepts/ai-regulation-2026.md` (updated)
- index: updated - index: updated
## [2026-06-07] Migration | ByteRover context-tree → Knowledge Base Wiki
**Type:** migration | **Scope:** wiki/architecture, wiki/concepts, wiki/tools, wiki/decisions
**Source:** `/home/node/workspace/.brv/context-tree/` (ByteRover context-tree, April 2026, 133 Markdown-Dateien)
**Actions:**
- wiki: `architecture/container-volume-persistence.md` (created)
- wiki: `architecture/memory-system.md` (created)
- wiki: `architecture/agent-orchestration.md` (created)
- wiki: `architecture/model-routing.md` (created)
- wiki: `architecture/cron-notable-events.md` (created)
- wiki: `architecture/byterover-knowledge-mining.md` (created)
- wiki: `tools/ecosystem-tools-april-2026.md` (created)
- wiki: `concepts/subconscious-agent.md` (created)
- wiki: `concepts/pro-leben-directive.md` (created)
- wiki: `concepts/quality-standard.md` (created)
- wiki: `decisions/2026-04-volume-persistence.md` (created)
- wiki: `decisions/2026-04-memory-system.md` (created)
- index: updated with new categories (Architecture, Decisions) and all new pages
**Notes:**
- Kompiliert aus ~133 Quell-Dateien (abstract/overview/full) → 12 prägnante Wiki-Seiten
- Fokus auf bleibende Erkenntnisse; temporäre/archivierte Details (einzelne Subconscious-Runs, Tagebuch-Einträge) nicht migriert
- Duplikate (identische Facts in architecture + ecosystem) dedupliziert
- Alte Tool-Integrationen (ByteRover, GBrain, SearXNG) historisch dokumentiert, nicht als aktive Empfehlungen

View file

@ -0,0 +1,18 @@
# Ecosystem Tool Discoveries (April 2026)
> Migriert aus ByteRover context-tree. Historischer Überblick über Tool-Evaluierungen aus April 2026.
## Bewertete Tools
| Tool | Relevanz | Status |
|------|----------|--------|
| **GBrain** (garrytan/gbrain) | 🟢 SEHR HOCH | PGLite Memory-Graph-DB mit Relationen und semantischer Suche. Braucht Bun + OpenAI Key. |
| **SearXNG** (Christian Dreschel) | 🟡 Mittel | Läuft auf Tailscale 100.67.149.80:30053, aber Container kein Tailscale. |
| **Hermes Atlas** | 👀 Competitor | Auto-generierte Skills + Self-improving Memory |
| **Claude Shortcuts** | 📝 Notiert | `/btw` (Context Injection), `/reasoning` (Thinking), Shift+Tab (ACP) |
| **Brian Roemmele** "Age of Abundance" | ⚠️ Oberflächlich | Rhetorisch stark, inhaltlich dünn |
## X API Integration
- `x_search` via xAI: ✅ Funktioniert
- `xurl` CLI: ⏳ Blockiert auf X Developer Account + OAuth2, Pit-Entscheidung ausstehend