le0nardomartins/ClaudeMemorySync-Server

Claude Memory Sync: Server

Repositorien:

• Server (dieses): https://github.com/le0nardomartins/ClaudeMemorySync-Server
• Client (einer pro PC): https://github.com/le0nardomartins/ClaudeMemorySync. Der Client hat die Skill claude-memory-sync, führt einen 3-Wege-Merge durch, verschlüsselt alles mit der SYNC_KEY und unterstützt auch einen serverlosen Modus über ein privates Git-Repository.

Der Server führt kein Merge durch und liest den Inhalt nicht. Er speichert versiegelte Manifeste und Blobs und akzeptiert nur eine neue Version, wenn sie von der aktuellsten ausgeht (ansonsten 409 Conflict).

Bei Bedarf lesen Sie in diesem Ordner:

• deploy.md: Hochladen auf Railway oder einen anderen Anbieter, Aktualisieren
• api.md: Protokoll zum Debuggen von Anfragen
• operations.md: SQL für Abfragen und Wartung, Backup, Widerruf, Diagnose

Immer geltende Regeln

1. Daten. Mit SYNC_KEY auf den PCs enthält die Datenbank nur verschlüsselte Daten. Ohne sie enthält sie API-Schlüssel des Benutzers. Setzen Sie Postgres in keinem Fall öffentlich zugänglich und geben Sie niemals DATABASE_URL weiter.
2. Schlüssel. CLIENT_PUBLIC_KEYS enthält nur öffentliche Schlüssel, die sichtbar sein dürfen. CLIENT_PRIVATE_KEY und SYNC_KEY gelangen niemals auf den Server oder in den Chat.
3. Vorher bestätigen vor Deployment, Push, Änderung von Umgebungsvariablen auf Railway, TRUNCATE, DELETE oder anderen irreversiblen Aktionen. Erstellen Sie ein Backup (pg_dump, siehe operations.md), bevor Sie Daten verändern.
4. Gekoppeltes Protokoll. Client und Server müssen dieselbe Protokollversion verwenden. Wenn Sie eines aktualisieren, erinnern Sie den Benutzer daran, das andere auf allen PCs zu aktualisieren.
5. Server zurücksetzen löscht nichts auf den PCs. Jeder PC behält die lokale Datenbank und sendet alles in der nächsten Runde erneut. Um eine Datei von allen PCs zu entfernen, löschen Sie sie einfach auf einem PC: Fassen Sie dafür nicht den Server an.

Aufgaben

Erstmaliges Deployment

Folgen Sie deploy.md → "Railway". Der Benutzer muss:

• das Projekt und Postgres im Dashboard erstellen oder die Nutzung der Railway CLI autorisieren;
• die öffentlichen Schlüssel einfügen.

Prüfen Sie am Ende im Log die Zeile memory server auf port ... | PCs autorisiert: ....

PC autorisieren

1. Generieren Sie auf dem PC die Schlüssel: python src/components/remote_client.py keygen <name> (Client) oder npm run keygen -- <name> (hier).
2. Fügen Sie <name>:<base64> in CLIENT_PUBLIC_KEYS ein, durch Komma getrennt, ohne die anderen zu löschen.
3. Railway startet automatisch neu. Prüfen Sie den Namen in PCs autorisiert im Log.

PC widerrufen

Löschen Sie seinen Eintrag aus CLIENT_PUBLIC_KEYS. Falls der Rechner kompromittiert wurde, empfehlen Sie dem Benutzer, die SYNC_KEY auf allen PCs zu wechseln (Fehlerbehebung des Clients) und den Verlauf zurückzusetzen (operations.md).

Diagnose

Lesen Sie die Logs des Dienstes (Railway-Dashboard oder railway logs) und vergleichen Sie mit operations.md → "Diagnose". Auf Client-Seite ist die Datei sync.log. 409 gefolgt von 201 ist normal.

Datenbank abfragen oder warten

Verwenden Sie die Abfragen aus operations.md. Für punktuellen Zugriff nutzen Sie railway connect Postgres. Bevorzugen Sie schreibgeschützte Abfragen und bestätigen Sie jede Schreiboperation.

Server aktualisieren

1. Führen Sie einen Push im Repository aus: Railway deployed über das Dockerfile. Migrationen laufen beim Start automatisch (db.migrate).
2. Bitten Sie danach, die Clients zu aktualisieren.