knowledge-base/wiki/decisions/2026-04-volume-persistence.md
Hector 0e02fdbd59 feat: people-pages for all TODO institutions markers
- Created 27 new people-pages for all TODO-marked persons
- Replaced all TODO: people-page markers with wiki-links in institutions
- Cross-referenced back to institutions from each people-page
- 0 TODO markers remaining

New people-pages:
  shayne-coplan, jim-zemlin, wang-changhu, yang-bingyang, demis-hassabis,
  clement-delangue, thomas-kurian, fei-fei-li, christopher-manning,
  sam-altman, ilya-sutskever, moritz-kaminski, elon-musk, nicolas-burtey,
  elizabeth-stark, olaoluwa-osuntokun, jan-leike, oren-etzioni,
  ali-farhadi, jaime-sevilla, max-tegmark, daniela-rus, jared-kaplan,
  alex-atallah, andrew-moore, tuomas-sandholm, mitchell-baker
2026-06-25 21:44:25 +02:00

2.4 KiB

created updated sources tags
2026-06-16 2026-06-16
decisions
architecture
infrastructure
docker
persistence

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

Hintergrund — Warum das passierte

Vor dieser Entscheidung lief der Bot-Container mit einem ephemeren Filesystem — kein persistentes Volume, kein Bind-Mount. Drei Probleme häuften sich in der ersten Aprilwoche:

  1. LanceDB-Installation am 2026-04-04 verursachte einen Container-Reset, weil das Datenverzeichnis ~/.lancedb auf dem Container-Filesystem lag und beim Rebuild verloren ging.
  2. Memory-System (Schicht 3) baute auf LanceDB auf — Reset bedeutete Totalverlust des Vektor-Index.
  3. OAuth-Tokens (ByteRover .brv-cli, Subconscious-Plugin-Tokens) wurden gleich mitverloren.

Die Entscheidung am 2026-04-06 zog daraus die Konsequenz: alles, was über Container-Lebensdauer hinaus leben soll, gehört auf ein gemountetes Volume — nicht "manchmal" oder "für wichtige Daten", sondern ausnahmslos.

Konsequenzen

Die strikte Volume-Pflicht wurde zur Grundlage für alle späteren Architekturentscheidungen: Memory-System, Wiki-Repository, Plugin-State. Siehe ../architecture/container-volume-persistence.md für die allgemeinen Lessons Learned und ../architecture/byterover-knowledge-mining.md für die konkrete Pipeline, die an genau dieser Lücke scheiterte.

Verwandte Seiten