SyncTicket: ein Local-First-Issue-Tracker mit Durable-Object-Relay

Problem und Rahmenbedingungen

SyncTicket ist ein Issue-Tracker im Stil von Linear, gebaut, um die schweren Teile dieses Problems ernst zu nehmen: Der Browser besitzt die Daten, Änderungen funktionieren offline und verschmelzen ohne Konflikte, zwei Browser bleiben in Echtzeit synchron, und die Suche braucht keinen Server. Es ist ein Portfolio-Projekt, das zufällig eine echte Anwendung ist, kein Produkt auf der Suche nach Nutzern. Wer es öffnet, will es beurteilen; also muss sich jede Behauptung in der laufenden Demo oder im Quellcode prüfen lassen. Der Name ist ein Arbeitstitel.

Drei Rahmenbedingungen prägten es. Das Budget war 0 EUR, also läuft alles im Free Plan von Cloudflare, dessen Grenzen (100.000 Requests und 100.000 geschriebene Zeilen pro Tag für den ganzen Account und 2 MB pro gespeichertem Wert) zu Vorgaben für den Entwurf wurden statt zu Überraschungen. Wer die Demo besucht, sollte innerhalb einer Minute damit arbeiten können, also gibt es keine Konten: Der Workspace-Link ist der Zugang. Und die Demo muss weiterlaufen, ohne dass jemand sie beobachtet; wenn sie etwas nicht kann, muss sie es also sagen, statt stillschweigend zu scheitern.

Es nutzt kein LLM. Sein einziges Modell ist ein optionales Sentence-Embedding-Modell für die Suche, das im Browser der Besuchenden läuft.

Architektur

SyncTicket besteht aus zwei Workern im Free Plan von Cloudflare und ist seit dem 22. Oktober 2026 unter syncticket.elbaymalik.com live. Der App-Worker mit SvelteKit liefert die Seiten und das selbst gehostete Suchmodell aus; ein eigener Relay-Worker hält einen Durable-Object-Raum pro Workspace. Getrennt sind sie, weil der stabile SvelteKit-Adapter keine Durable-Object-Klasse exportieren kann.

Im Browser ist jeder Workspace ein Yjs-Dokument: eine Map von Issues, jedes Issue eine Map von Feldern. y-indexeddb speichert es in IndexedDB, und dieses Dokument, nicht der Server, ist die Quelle der Wahrheit. Eine Runes-Brücke in Svelte 5 beobachtet es und aktualisiert eine reaktive Projektion, die die Oberfläche liest; die Oberfläche schreibt nie in die Projektion, nur in das Dokument. Das Kanban-Board ordnet Karten über fraktionale Schlüssel mit zufälligem Suffix, damit zwei Browser, die offline eine Karte anlegen, nicht denselben Schlüssel erzeugen, und ein Reparaturschritt repariert gleiche Schlüssel, die schon existieren.

Das Relay, y-partyserver auf einem Durable Object mit Hibernation, reicht Updates zwischen Browsern weiter und speichert einen Snapshot des Dokuments im SQLite-Speicher des Raums, mit 2 s Debounce und höchstens 5 s Verzug. Die Hibernation sorgt dafür, dass ein ruhender Raum nichts kostet, und sie verdrängt den Speicher des Raums: Das Dokument muss bei jedem Aufwachen aus SQLite neu aufgebaut werden, und die Präsenzliste beginnt leer. Die Suche läuft in einem Modul-Web-Worker. FlexSearch antwortet ab dem ersten Tastendruck; schaltet jemand die Bedeutungssuche ein, läuft all-MiniLM-L6-v2 über Transformers.js auf WebAssembly, und beide Rankings werden mit Reciprocal Rank Fusion verschmolzen. Bei ausgeschalteter Bedeutungssuche zeichnet ein End-to-End-Test jede Anfrage auf, während Suchbegriffe getippt werden, und prüft, dass es keine gibt. Die Entscheidungen dahinter stehen im Entscheidungsprotokoll weiter unten, jeweils mit der Alternative, gegen die sie sich durchgesetzt haben.

Wo die Bibliotheken nicht reichten

Dreimal tat das installierte Paket nicht, was seine Dokumentation oder der Plan annahm. Nur die Präsenz war ein dokumentiertes Versprechen; die beiden anderen Lücken fand ich, indem ich den installierten Code las.

Präsenz: y-protocols dokumentiert, dass ein Peer, von dem 30 Sekunden lang nichts kommt, entfernt wird. y-partyserver löscht das Intervall, das dies tut, auf Client und Server, sodass ein Peer mit zugeklapptem Laptop für immer auf dem Bildschirm blieb. Die Hibernation machte es schlimmer, denn ein aufgewachter Raum hat eine leere Präsenzliste, und das Entfernen eines Peers wird an niemanden gesendet. Jetzt verantwortet der Client die Liveness, mit einem Heartbeat und einem Filter für veraltete Peers, so ausgelegt, dass ein Tab allein nichts sendet und den Raum ruhen lässt.

Verbindung: Der Provider schreibt die Zeit der letzten empfangenen Nachricht und liest sie nie, sodass ein Socket, der still wurde, ohne sich zu schließen, als verbunden und synchron galt. Der erste Entwurf einer Lösung, disconnect() und danach connect() aufzurufen, war doppelt kaputt, wie eine Probe gegen den installierten Provider vor der Auslieferung zeigte: connect() bewirkte nichts, und disconnect() meldete dauerhaft den Kanal ab, der Tabs desselben Browsers synchron hält. Die ausgelieferte Lösung schließt den verdächtigen Socket und lässt das Backoff der Bibliothek neu verbinden.

Speichern: Über der Zeilengrenze von 2 MB bei Cloudflare scheitert das Speichern des Relays mit einer Exception, und die Bibliothek schluckt den Fehler in eine Logzeile, die der Free Plan drei Tage aufbewahrt. Der Raum synchronisierte im Speicher weiter und hätte bei der nächsten Verdrängung alles seit dem letzten guten Speichern verloren. Jetzt prüft das Relay die Größe vor dem Schreiben, behält den letzten guten Snapshot, hält den Fehler dort fest, wo er die Hibernation übersteht, und sagt es jedem Client, auch denen, die später kommen.

Ergebnisse

Alle 13 Phasen der Roadmap sind erledigt, und beide Worker laufen seit dem 22. Oktober 2026 live im Free Plan. Das Deployment wurde so geprüft, wie es das Runbook des Repositorys verlangt, nicht am Ausbleiben einer Fehlermeldung: Das Verbindungs-Popover zeigte „Ready to share“, und ein Issue, das in einem zweiten Browser nur mit dem Share-Link angelegt wurde, erschien im ersten. Es ist eine dauerhafte, offene Demo für Beurteilende, bewusst ohne Konten: Wer einen Workspace-Link hat, kann den Workspace lesen und bearbeiten, und die App rät davon ab, echte Daten einzugeben.

Die Zahlen oben sind lokal gemessen. Die Virtualisierung brachte die Liste bei 10.000 Issues von 5.019 ms auf 33 ms; FlexSearch beantwortet einen ersten Tastendruck in 0,005 ms gegenüber 3,96 ms bei MiniSearch; und zwei Browser auf einem Rechner konvergierten über ein lokales Relay mit Medianen von 29 bis 30 ms, weit unter dem Ziel von 1 s, aber keine Zahl aus der Produktion. Ab rund 6.130 Issues wird ein Workspace nicht mehr gespeichert, und die App sagt das. Die Suchqualität ist nicht gemessen: Es gibt keinen Golden-Datensatz, das hier sind also Zahlen zur Geschwindigkeit, nicht zur Relevanz. Die Gates laufen lokal mit scripts/ci-local.sh, das den CI-Workflow Schritt für Schritt nachbildet.

Die offenen Punkte stehen im Repository. Der Name ist noch ein Arbeitstitel: Das Produkt bekam am 22. Oktober 2026 ein eigenes Logo, aber keinen Namen. Der Build liefert noch eine zweite, bytegleiche Kopie der 23,6 MB großen ONNX-WebAssembly-Datei mit, die nie ausgeliefert wird; beide zusammenzulegen, ist ein offener Folgeschritt. Stiller Verlust über das tägliche Zeilenbudget wird nur allgemein gemeldet, weil die Form seines Fehlers nicht geprüft ist. Eine halb offene Verbindung, die weder das Offline-Ereignis des Browsers noch die Rückkehr zum Tab aufdeckt, fällt erst beim TCP-Timeout des Browsers auf. Board-Cursor aus dem Plan wurden bewusst weggelassen, weil jede Zeigerbewegung einen ruhenden Raum wecken würde. Und es gibt noch keinen Export, um Daten aus einem Workspace zu holen, den das Relay nicht mehr speichern kann; die Daten liegen weiterhin in der eigenen IndexedDB der Besuchenden.

Lehren

Das installierte Paket lesen, nicht seine Dokumentation. Nur eine der drei Lücken oben brach ein dokumentiertes Versprechen; die beiden anderen waren Verhalten, das nur der installierte Code zeigte, und die erste Lösung für eine davon hätte eine stille Regression ausgeliefert. Eine Wegwerf-Probe gegen das Paket auf der Platte kostete weniger als jede von ihnen.

Erst messen, dann wählen. Bei 10.000 Issues kostete die reaktive Schicht 2 ms und das DOM 5 Sekunden, also war die Lösung eine Komponente statt eines Umbaus der Abfrageschicht; die Suchmaschine wurde anhand des ersten Tastendrucks gewählt, nicht anhand einer durchschnittlichen Abfrage.

Eine genannte Grenze schlägt eine verborgene. Der Free Plan setzt harte Grenzen, und wehgetan hätte die, die stillschweigend scheiterte. Den Nutzenden zu sagen, dass ein Workspace nicht mehr gespeichert wird, war billiger und ehrlicher als jedes Speicherschema, das die Wand weiter hinausschiebt.

Ein Dry Run ist kein Deployment. Der ADR zum Deployment-Ziel erwartete beim ersten echten Deployment kleine Überraschungen, und beide lagen im Werkzeug: wrangler login meldete einen Timeout, nachdem es gültige Zugangsdaten geschrieben hatte, und ein bloßes wrangler deploy warnte nur, dass die Relay-Konfiguration eine e2e-Umgebung ohne Rate Limiter enthielt. Beide Deploy-Skripte des Relays nennen jetzt ihre Umgebung.