slivingdoc

Testabdeckung: 83,7 % 😍👌

Funktionen

• Git-ähnliche Semantik: slivingdoc verwendet Begriffe, die wir (und Agenten) alle kennen, ausgelegt für einfache Bedienung

• Automatische Konfliktlösung: committen ohne Angst, im Vertrauen darauf, dass alle Konflikte vor der Annahme gelöst werden müssen

• Hochgeschwindigkeitsverarbeitung: Die Lösung ist konzeptionell recht einfach und ermöglicht sehr hohe Skalierung und Parallelität

• Plug-and-Play: Richten Sie den Bucket ein, zeigen Sie darauf, und beginnen Sie mit dem Synchronisieren von Notizen!

docs/slivingdoc-v1.md ist der vollständig akzeptierte Vertrag hinter diesen Garantien.

Related MCP server: Cellar

Erste Schritte

Fügen Sie es Ihrer agentischen Infrastruktur hinzu:

{
  "mcpServers": {
    "slivingdoc": {
      "command": "npx",
      "args": [
        "-y",
        "slivingdoc",
        "serve",
        "--bucket",
        "my-notes",
        "--workspace-root",
        "/srv/notes"
      ],
      "env": {
        "AWS_ACCESS_KEY_ID": "<your-access-key-id>",
        "AWS_SECRET_ACCESS_KEY": "<your-secret-access-key>",
        "AWS_REGION": "us-east-1"
      }
    }
  }
}

Der Bucket muss existieren, und die Anmeldeinformationen stammen aus der normalen AWS-Kette. Noch kein S3-Konto? examples/seaweedfs/ führt einen lokalen SeaweedFS-Container mit einer Schritt-für-Schritt-Anleitung aus. Sie können auch ein natives Binärprogramm direkt von der GitHub-Veröffentlichung herunterladen (slivingdoc-v<semver>-<os>-<arch>) und es direkt ausführen.

Unterstützte Plattformen: Linux (amd64, 32-Bit-ARMv7, arm64), macOS (amd64, arm64) und Windows (amd64). Das 32-Bit-Linux-ARM-Artefakt unterstützt Raspberry Pi OS armhf.

So funktioniert es

Der Server stellt zwei MCP-Tools über stdio bereit:

notes_pull schreibt das aktuelle Notizbuch in Ihr Verzeichnis. notes_commit veröffentlicht Ihre Änderungen und übernimmt gleichzeitige, konfliktfreie Änderungen. Zwischen den Aufrufen gibt es kein Protokoll – Agenten bearbeiten die Dateien mit den bereits vorhandenen Werkzeugen, und Menschen können mit einem beliebigen Editor im selben Verzeichnis schreiben. Der nächste Commit übernimmt auch ihre Änderungen.

Menschen können beide Operationen auch direkt ausführen, ohne einen MCP-Host. Ein relativer Pfad wird relativ zum Arbeitsverzeichnis aufgelöst:

slivingdoc pull notes
# edit UTF-8 text files under notes/
slivingdoc commit notes -m "meeting summary"

Bei Erfolg wird der einheitliche Ergebnisbericht ausgegeben: der Status OK, die akzeptierte Remote-Generation, die Anzahl der eingefügten und gelöschten Dateien sowie eine Zusammenfassung am Ende. Ein Domänenfehler beendet das Programm mit einem Exit-Code ungleich Null und gibt einen offenen Bericht aus: die Fehlerkategorie, die Wiederholbarkeitsentscheidung und jede Konfliktdatei mit ihren Zeilenbereichen. Farbe wird nur auf einem echten Terminal angezeigt und durch jede nicht-leere NO_COLOR deaktiviert.

Der Git-Teil

Wenn alle Agenten gleichzeitig schreiben würden, würde das funktionieren, aber sie würden von Race-Conditions überrannt werden. Daher verfügt slivingdoc über ein eingebautes Git über libgit2, das effektiv Folgendes tut:

1. git pull

2. (potenzielle Konfliktlösung lokal)

3. git add .

4. git commit -m "<Agenten-Nachricht>"

5. git push

6. (potenzielle Konfliktlösung lokal)

Alle diese Git-Operationen werden lokal innerhalb eines privaten Spiegels des Notizverzeichnisses durchgeführt, was eine "optimierte" Git-Sequenz hinterlässt. Dies funktioniert aufgrund zweier Kompromisse: Erstens kann das lokale Notizverzeichnis bei notes_pull geändert werden, wobei der Remote-Zustand Vorrang hat, was Konfliktmarkierungen hinterlässt. Zweitens funktioniert das System nur für Text (sauberes UTF-8).

Konfiguration

serve, pull und commit lesen dieselben Flags und Umgebungsvariablen. --bucket ist erforderlich. Die häufigsten Flags:

slivingdoc serve -h gibt die vollständige Referenz aus, und docs/running.md behandelt alles, was ein Operator benötigt: alle Flags, die genauen S3-Berechtigungen, Protokollierung (LOG_LEVEL auf stderr), die Notizbuchregeln, Konfliktbehebung und Checkpoint-Aufbewahrung. Das Terraform-Modul in terraform/ stellt einen Bucket und einen IAM-Benutzer mit minimalen Rechten für ein Notizbuch bereit.

Entwicklung

• AGENTS.md – der Entwickler- und Agentenleitfaden: Paketübersicht, Betriebsabläufe, Konventionen und die QA-Prüfungen.

• docs/slivingdoc-v1.md – der akzeptierte Architekturvertrag.

• docs/build.md – der native Build, von der festgelegten libgit2-Quelle bis zur Abhängigkeitsprüfung.

• docs/testing.md – die Testbefehle, die Testebenen und die Kein-Live-AWS-Regel.

• docs/releasing.md – Veröffentlichungsartefakte, npm Trusted Publishing und make release.

make qa #lint plus the full Go and npm test suites

Lizenz

MIT – siehe LICENSE. Hinweise zu Drittanbietern für die statisch verlinkte libgit2 finden Sie in NOTICE.

Nicht verbunden mit Paris Hilton.