consolidate

Über die Zeit kann ein Vault zwei oder drei Schreibweisen für dieselbe Sache parallel ansammeln: works_at und arbeitet_bei, Person und personen, a11y und accessibility. Die consolidate-Kommandos helfen dir, das gezielt zu prüfen — bevor du eine neue Schreibweise einführst, oder beim Aufräumen eines gewachsenen Vaults.

Eine breitere Einordnung in die Ähnlichkeits-Verfahren von Apparat steht in den Grundbegriffen.

Wie die Konsolidierung funktioniert

Drei Stufen greifen ineinander:

1. Bekannte Schreibweise. Apparat normalisiert deine Eingabe (Persons → person, WorksAt → works_at) und prüft, ob es im Vault bereits einen Wert in dieser Form gibt. Wenn ja, ist die Frage geklärt.
2. Tippfehler-Erkennung. Greift die erste Stufe nicht, vergleicht Apparat deine Eingabe mit den existierenden Werten Buchstabe für Buchstabe — fängt Tippfehler, Buchstaben­dreher und Plural/Singular-Drift.
3. Themen-Nachbarschaft. Wenn der Wert auch als Entitäts­titel im Vault existiert (typisch: ein Tag oder Typ mit eigener Definitionsnotiz), prüft Apparat zusätzlich auf thematische Nähe — fängt Synonyme, die buchstabenmäßig weit auseinander­liegen.

Stufen 2 und 3 sind passiv: sie schlagen vor, sie schreiben nicht. Die Übernahme einer Empfehlung ist eine eigene Aktion (etwa ein neuer Aufruf von entity new oder entity meta mit der kanonischen Schreibweise).

Bedien­kommandos

• consolidate type — listet existierende Typen, die einem Kandidaten ähnlich sind. Praktisch vor entity new, wenn du dir nicht sicher bist, ob du einen neuen Typ erfindest oder einen bestehenden meinst.
• consolidate relation — Pendant für Beziehungs­namen. Praktisch vor entity link.

Tag-Konsolidierung ist nicht als eigenes Kommando ausgelegt — Tags werden im Walkthrough von entity new und entity meta inline geprüft, weil das ihr natürlicher Eingabe-Ort ist.

Beide Kommandos werden vom apparat-Wrapper automatisch im Container ausgeführt, weil die Bedeutungs-Stufe einen erreichbaren Embedding-Dienst braucht.

Was sich nahtlos in die anderen Kommandos integriert

Beim Anlegen oder Bearbeiten einer Entität läuft die Tippfehler-Stufe ohnehin im Hintergrund: entity new, entity link und entity meta zeigen dir Hinweise, sobald du einen neuen Typ, Beziehungs­namen oder Tag eingibst, der einem bestehenden ähnelt. Du kannst die consolidate-Kommandos also als Audit-Werkzeug verstehen — beim normalen Schreiben passiert das wichtigste automatisch.

Wenn der Embedding-Dienst gerade nicht läuft, fällt die Bedeutungs-Stufe still aus; Tippfehler-Erkennung und bekannte Schreibvarianten arbeiten weiter.