Files
starface-outlook-sync-addin/CHANGELOG.md
T
duffyduck d3fa452504 Add field-level 3-way merge for bidirectional conflicts
Bisher wurde bei einem Konflikt (beide Seiten geaendert) der ganze Datensatz
ueberschrieben - eine gleichzeitige Aenderung an einem anderen Feld ging
verloren (z.B. A aendert Telefon in Outlook, B aendert Mail in Starface ->
eine Aenderung weg).

Jetzt:
- Mapping speichert je Seite einen Snapshot des letzten Sync-Stands
  (LastOutlook/LastStarface), zusaetzlich zu den Hashes.
- Bei beidseitiger Aenderung im Both-Modus wird feldweise gemergt
  (ContactMerger): unterschiedliche Felder bleiben beide erhalten, nur bei
  echtem Konflikt am selben Feld gewinnt Outlook.
- Echte Feld-Konflikte landen in SyncResult.Conflicts und werden im MainForm
  per Tray-Meldung angezeigt.
- Snapshots werden in allen Baseline-Punkten gesetzt (Phase 1-3) und fuer
  aeltere Mappings beim naechsten unveraenderten Sync nachgetragen.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-08 12:35:10 +02:00

5.0 KiB
Raw Blame History

Changelog

Alle nennenswerten Aenderungen an Starface Outlook Sync werden hier dokumentiert.

Format orientiert sich an Keep a Changelog, Versionsschema ist x.x.x.x (siehe release.sh).

[Unreleased]

Behoben

  • Dubletten auf beiden Seiten beim Synchronisieren. Mehrere zusammenhaengende Ursachen wurden beseitigt:

    • Eine unvollstaendig geladene Starface-Kontaktliste (z.B. durch einen Lade-Fehler oder Timeout) liess die Engine Kontakte faelschlich als "geloescht" ansehen, ihr Mapping verwerfen und sie beim naechsten Lauf neu anlegen. Der Kontakt-Abruf bricht jetzt mit Fehlermeldung ab (inkl. Wiederholversuch), statt still mit einer Teil-Liste weiterzuarbeiten.
    • Ist ein Starface-Kontakt nicht in der geladenen Liste, wird er jetzt per ID direkt abgefragt: existiert er noch (liegt also in einem anderen Adressbuch), bleibt das Mapping erhalten und es wird nichts neu angelegt (keine Dublette). Ist er wirklich geloescht (404), wird er je nach Sync-Richtung in Starface neu angelegt bzw. die Loeschung nach Outlook gespiegelt. (Vorher wurde das Mapping faelschlich behalten und der Kontakt in Outlook->Starface gar nicht neu angelegt.)
    • Das Wiederzuordnen bestehender Kontakte war zu streng: eine von Starface umformatierte Telefonnummer konnte einen eindeutigen E-Mail- oder Namens-Treffer ueberstimmen und so eine Neuanlage statt Verknuepfung ausloesen. Ein gleicher E-Mail- oder voller Namens-Treffer reicht jetzt.
  • Synchronisation extrem langsam / schrieb bei jedem Lauf alle Kontakte neu. Die Aenderungserkennung verglich einen einzigen Hash gegen beide Seiten. Outlook und Starface stellen denselben Kontakt aber unterschiedlich dar (nicht uebertragene Felder, abweichendes Telefonformat), wodurch der Hash nie uebereinstimmte und praktisch jeder Kontakt bei jedem Sync neu geschrieben wurde. Jede Seite hat jetzt eine eigene Baseline (LastOutlookHash / LastStarfaceHash); nur tatsaechlich geaenderte Kontakte werden geschrieben.

Hinzugefuegt

  • Feldweises 3-Wege-Merge bei Konflikten (bidirektional). Wenn derselbe Kontakt zwischen zwei Syncs auf beiden Seiten geaendert wurde, bleiben jetzt Aenderungen an unterschiedlichen Feldern beide erhalten (z.B. einer aendert die Telefonnummer in Outlook, ein anderer die E-Mail in Starface). Nur wenn DASSELBE Feld auf beiden Seiten unterschiedlich geaendert wurde, greift die Vorrang-Regel (Outlook gewinnt). Dafuer wird im Mapping zusaetzlich ein Snapshot des letzten Sync-Stands je Seite gespeichert. Solche echten Feld-Konflikte werden dem Benutzer per Tray-Meldung angezeigt.

Geaendert

  • Doppelte Syncs verhindert (lokal). Der Schutz gegen gleichzeitig laufende Syncs (manuell + Auto-Sync-Timer) ist jetzt atomar (Interlocked) statt eines nicht-atomaren volatile bool, bei dem beide in einem Zeitfenster durchrutschen konnten.
  • Ein-Richtungs-Modi sind jetzt echtes "Ersetzen". Outlook->Starface macht das Starface-Adressbuch zu einer exakten Kopie von Outlook: Kontakte, die nur in Starface existieren (kein Pendant in Outlook), werden geloescht. Starface->Outlook entsprechend umgekehrt. Schutz: Ist die Quelle komplett leer (z.B. falscher Ordner gewaehlt), wird die Loeschphase uebersprungen statt die Zielseite zu leeren. Mass-Loeschungen finden nur bei vollstaendig geladener Liste statt (unvollstaendige Ladevorgaenge brechen vorher ab).
  • Bidirektionale Loeschungen werden jetzt erkannt. Wird ein Kontakt auf einer Seite geloescht und ist die andere Seite seit dem letzten Sync unveraendert (Abgleich ueber die gespeicherte Baseline), wird die Loeschung auf die andere Seite gespiegelt statt den Kontakt wieder anzulegen. Wurde die andere Seite zwischenzeitlich bearbeitet, gewinnt die Bearbeitung und der Kontakt wird neu angelegt (kein Datenverlust). In den Ein-Richtungs-Modi bleibt die jeweilige Quelle fuehrend (Loeschung im Ziel wird wiederhergestellt).
  • Starface-Kontaktdetails werden beim Laden parallel abgerufen (8 gleichzeitig) statt einzeln nacheinander deutlich schneller bei grossen Adressbuechern.
  • UpdateContact (Outlook) und UpdateContactAsync (Starface) geben jetzt den frisch eingelesenen Stand zurueck, damit die Baseline nach dem Schreiben korrekt gesetzt wird und der Sync sauber konvergiert.

Migration

  • Bestehende Mapping-Dateien werden beim ersten Sync automatisch uebernommen (ein ruhiger Durchlauf ohne Massen-Update).
  • Bereits vorhandene Dubletten werden nicht automatisch entfernt die Fixes verhindern nur neue. Vorhandene Doppel-Kontakte einmalig manuell bereinigen.

[0.0.0.23]

Behoben

  • Kritischer Loesch-Fehler: Kontakte wurden bei einer geaenderten Outlook-EntryID nicht mehr massenhaft geloescht.

Geaendert

  • Outlook-Sicherheitsschluessel werden fuer Domaenenumgebungen zusaetzlich nach HKLM geschrieben (unterdrueckt die Outlook-Sicherheitsabfrage).

Aeltere Versionen

Aeltere Releases (v0.0.0.1 v0.0.0.22) sind ueber die Git-Historie und die Git-Tags nachvollziehbar.