consolidate type

consolidate type prüft einen Typ-Kandidaten gegen das aktuelle Vault-Vokabular und meldet alle existierenden Typen, die ähnlich genug sind, dass eine Konsolidierung lohnt. Lese-Kommando: kein Frontmatter wird angefasst, keine Datei geschrieben. Die Übernahme einer Empfehlung passiert anschließend manuell — typischerweise mit entity new für eine neue Entität oder entity meta für eine bestehende.

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

Wofür ist das?

Vor entity new mit einem neuen Typ. Du willst eine Entität als concepts anlegen und fragst dich, ob es schon concept gibt. Ein Aufruf zeigt es dir.
Aufräumen eines gewachsenen Vaults. Beim Audit über die Typ-Liste prüfst du verdächtige Werte gegen das restliche Vokabular.
Inspektion vor der UI. Solange noch keine Web-Oberfläche existiert, ist das Kommando der direkte Zugriff auf die Konsolidierungs-Vorschläge für Typen.

Aufruf

apparat consolidate type <wert> [--vault=<vault>]

Das Argument ist der Typ-Kandidat in deiner Originalschreibweise. Apparat normalisiert intern (kleinschreibung, Bindestriche zu Unterstrichen, einfache englische Singularregel) und meldet die Normalisierung mit, wenn sie das Eingabe-Wort verändert.

Argument / Option	Bedeutung
`value`	Pflicht. Typ-Kandidat in beliebiger Schreibweise.
`--vault=<name	path

Klassen der Ausgabe

Already canonical

Der Kandidat existiert wörtlich (case-insensitiv) als Typ im Vault. Nichts zu tun:

Vault "recherche" — consolidation candidates for type "person":

Already canonical: "person" exists verbatim in the vault.

Catalog match

Der Kandidat fällt nach der Normalisierung mit einem existierenden Typ zusammen. Apparat zeigt die kanonische Schreibweise:

Vault "recherche" — consolidation candidates for type "Persons":

Catalog match: "Persons" → existing canonical spelling "person".

Persons → klein → englischer Singular → person. Die Übernahme ist deine Entscheidung; das Kommando schreibt nichts.

Lexical near matches

Tippfehler, Buchstabendreher und Plural-Drift, die der bekannte-Schreibweisen-Pfad nicht greift, fängt diese Stufe. Treffer kommen mit einem Distanzwert (kleiner = näher):

Vault "recherche" — consolidation candidates for type "orgnaization":

Lexical near matches (typos, plural drift, transpositions):
  - "organization"  (distance 0.083)

Semantic near matches

Wenn ein vorhandener Typ-Wert auch als Entitätstitel im Vault existiert (typisch bei Konzept-Typen mit Definitionsnotiz), zeigt Apparat zusätzlich thematisch nahe Werte, deren Schreibweise weit auseinanderliegt:

Vault "recherche" — consolidation candidates for type "a11y":

Semantic near matches (vocabulary terms with related definition notes):
  - "accessibility"  (distance 0.142)

No similar values found

Wenn keiner der drei Pfade etwas findet, ist der Wert vermutlich genuin neu:

Vault "recherche" — consolidation candidates for type "interview":

✅ No similar existing types found — looks like a genuinely new type.

Exit 0 — ein leeres Ergebnis ist kein Fehler.

Beispielausgabe (Mehrfach-Treffer)

$ apparat consolidate type Persone --vault=recherche
Vault "Recherche" — consolidation candidates for type "Persone":

Lexical near matches (typos, plural drift, transpositions):
  - "person"        (distance 0.143)
  - "organization"  (distance 0.272)

Semantic near matches (vocabulary terms with related definition notes):
  - "concept"       (distance 0.187)

Du entscheidest: person ist hier der wahrscheinliche Treffer (kleinste Distanz, plausible Plural-Drift). organization und concept sind schwächere Hinweise — sie tauchen auf, weil sie unter den Schwellwert kommen, nicht weil Apparat sie für richtig hält.

Voraussetzungen

Vault muss existieren und im Mount-Register stehen, oder per --vault direkt adressiert sein.
Embedding-Dienst läuft im Compose-Stack — sonst fällt die Themen-Nachbarschafts-Stufe still aus, der Rest läuft weiter.

Der einzelne Aufruf bleibt schnell: lokal, einstellige Millisekunden für den Abgleich plus die Embedding-Anfrage, sobald sie nötig wird.

Schwellwerte tunen

Die Standardwerte sind so eingestellt, dass du sie im Normalfall nicht anfassen musst. Wenn du im Praxisbetrieb merkst, dass zu viele oder zu wenige Vorschläge kommen, kannst du an zwei Stellen drehen:

Variable	Standard	Wirkung
`APPARAT_CONSOLIDATE_LEXICAL_THRESHOLD`	`0,3`	Höher: mehr Tippfehler werden als nahe Treffer gemeldet; niedriger: nur naheliegende.
`APPARAT_CONSOLIDATE_SIMILARITY_THRESHOLD`	`0,2`	Höher: Themen-Nachbarn werden großzügiger angeboten; niedriger: nur sehr enge.

Mehr Hintergrund zur Einstellung in der Ähnlichkeits-Übersicht.

Exit-Codes

Code	Bedeutung
0	Lauf erfolgreich abgeschlossen — auch wenn keine ähnlichen Werte gefunden wurden.
1	Vault-Auflösung fehlgeschlagen, Kandidat war leer/nur Whitespace, oder ein anderer korrigierbarer Fehler.

Verwandt

Ähnlichkeit — Übersicht über alle Verfahren.
consolidate relation — Pendant für Beziehungsnamen.
entity new — der typische nächste Schritt, wenn der Vorschlag eine kanonische Schreibweise nahegelegt hat.
entity meta — wenn eine bestehende Entität auf den kanonischen Typ umgestellt werden soll.