Disziplin der Fehlerübersetzung
Die Kompilierungspipeline von Aggrega gibt Fehler aus vielen Oberflächen aus — Schemavalidatoren, dem Resolver, dem IR-Builder, den Providern, der Go-Template-Engine und den zugrunde liegenden YAML- / Helm- / docker-compose-Bibliotheken, die die Provider kapseln. Fehler, die bis zur CLI durchgereicht werden, beginnen mit einer Kopfzeile in eckigen Klammern, die bis zu zwei Dinge nennt — eine Kategorie, die sagt, welchen Bereich man prüfen sollte (bei den meisten Werten die fehlerhafte Authoring-Oberfläche), und den Kurzcode der Bedingung, die den Build angehalten hat —, gefolgt von einem Quellzeiger und einer Meldung. Hat ein Plugin die Bedingung ausgelöst, wird der Code durch das auslösende Plugin qualifiziert, weil mehr als ein Plugin dieselbe Bedingung melden kann. Diese Seite dokumentiert die Gestalt dieser Ausgabe, damit Autoren Fehlermeldungen direkt deuten können.
Den Katalog der einzelnen Fehler (jeder fatale Abbruch mit Hinweisen zur Behebung) finden Sie unter fatal-halts.md. Die vier Schichten der Schemavalidierung und wie ihre Fehlerformen zusammenwirken, finden Sie unter vocabulary/validation-surface.md.
Die Fehlerkategorien
Ein Kategorie-Tag sagt, welchen Bereich man prüfen sollte. Die meisten nennen die Authoring-Oberfläche, an der die Behebung liegt; die übrigen nennen einen Bereich, der niemandes Autorenfehler ist — das Beschaffen eines Artefakts, ein Governance-Urteil oder Vertrauen und Signierung —, und der Kurzcode neben der Kategorie in der Kopfzeile ist in jedem Fall das, was die konkrete Bedingung identifiziert:
[DEVELOPER_ERROR]— der Fehler gehört zum Verfassen des Aggregate. Die Behebung liegt im YAML des Aggregate oder im vom Entwickler verfassten Teil des Katalogs (Component-Werte,uses-Sockets, Feature-Anbindungen). Beispieloberflächen: Resolver-Abbrüche bei Problemen auf Aggregate-Seite; Selektor- undappliesTo-Verletzungen bei dem, was das Aggregate geschrieben hat.[OPS_ERROR]— der Fehler gehört zu den eigenen Dokumenten des Operators, dem Release und dem Manifest. Die Behebung liegt im YAML des Release (Boundary-Topologie, Parameterwerte, Feature-Anbindungen auf Release-Ebene) oder im YAML des Manifest (über welches Recipe ein Typ bereitgestellt wird, und die daneben geschriebenen Annotations-Bindings). Beispieloberflächen: Schemavalidierung des Release; Template-Auswertung von Boundary-Pfaden;subDirectory-Kollisionen zwischen Providern; Ablehnungen von Mappings und Annotations-Bindings im Manifest; eine Regel, die eine Verbindung ablehnt, die das Release verdrahtet, oder eine Anbindung, die es an einer Verbindung befüllt — der Selektor eines Sockets, der Selektor eines Slots, ein Slot, den ein Socket als erforderlich deklariert; eine Regel, die ein Feature ablehnt, das nur das Release anbindet, an eine Komponente oder an eine Boundary — dasappliesTodes Feature, der Selektor eines Slots, sein deklariertes Schema.[CATALOG_ERROR]— der Fehler gehört zu einer Katalogentität (Recipe, FeatureRecipe, Component, Feature, Plugin). Die Behebung liegt im Kataloginhalt. Beispieloberflächen: Recipe-Formregeln; Kreuzprüfungen vonfeaturesSchemader Workload; Template-Parse-Fehler in im Katalog verfassten Templates.[TRANSLATION_ERROR]— der Fehler gehört zur Provider-seitigen Synthese (ein Provider-Plugin, das versucht, eine Workload, die Ausgabe eines valuesMapping oder ein Overlay mit Quelle in Provider-native Artefakte zu übersetzen). Die Behebung liegt typischerweise in der Formservices/containers/volumesder Workload, in der Template-Ausgabe vonvaluesMappingdes Recipe oder in der Struktur des Overlays im Quellmodus.[FETCH_ERROR]— der Fehler gehört zum Abrufen einer gepinnten Abhängigkeit aus einer Registry oder einer entfernten Quelle, nicht zu einer Authoring-Oberfläche. Die Behebung ist meist betrieblicher Art: sich bei der Registry authentifizieren (docker login <registry>), die Konnektivität wiederherstellen oder ein abgewichenes oder manipuliertes Artefakt neu pinnen (aggrega pull --upgrade --release <release>). Beispieloberflächen: eine Katalogentität oder ein Chart, die in der Registry nicht gefunden werden; Authentifizierung erforderlich oder fehlgeschlagen; Netzwerk nicht erreichbar; der Digest eines zwischengespeicherten Artefakts stimmt nicht mit der Lockfile überein. Abruffehler enthalten in der Meldung einen konkreten Hinweis zur Behebung.[POLICY_ERROR]— der Build wurde von einem Policy-Plugin abgelehnt, das in einer Governance-Urteilsrolle angebunden ist. Dies ist kein Fehler einer Authoring-Oberfläche: Die Eingabe ist wohlgeformt, verletzt aber eine Governance-Regel (Compliance, FinOps oder Sicherheit), die das Plugin durchsetzt. Die Behebung besteht darin, das, was Sie verfasst haben, mit der durchgesetzten Policy in Einklang zu bringen oder die Anbindung der Policy zu überdenken. Die Meldung nennt das ablehnende Plugin und enthält die Regelmeldung, die es geliefert hat.[TRUST_ERROR]— die Vertrauens- und Signierschicht hat den Vorgang abgelehnt. Diese Kategorie nennt einen Bereich statt einer Authoring-Oberfläche und umfasst zwei Abhilfen, die Sie am Kurzcode daneben unterscheiden können. Ihre Vertrauenskonfiguration ist falsch: eine Vertrauens-Policy, die nicht gelesen werden kann, eine gepinnte Vertrauenswurzel, die nicht geladen werden kann, eine schlüssellose Policy, die keine vertrauenswürdige Identität deklariert, eine Signier-Policy, die für die Artefaktart, die Sie veröffentlichen, eine Signatur verlangt, oder ein Plugin, das als vertrauenswürdig für eine Urteilsanbindung erfasst ist, die Ihre Konfiguration nicht mehr anbindet. Dieses Artefakt hat die Verifizierung nicht bestanden: eine Signatur, die sich gegen den Vertrauensanker nicht verifizieren lässt, ein Artefakt ohne Signatur, wo eine verlangt ist, eine Signatur von einem echten, aber nicht vertrauenswürdigen Signierer, oder ein Plugin, dessen erfasste vertrauenswürdige Identität nicht mehr mit dem übereinstimmt, was aufgelöst wird. Die Behebung liegt im ersten Fall in Ihrer Konfiguration oder im committeten Vertrauensdatensatz; im zweiten ist es eine Entscheidung über das Artefakt — das geprüfte wiederherstellen oder das Geänderte prüfen und neu erfassen.
Ein Befund zu einer Feature-Anbindung folgt dem Dokument, das sie geschrieben hat
Ein Feature kann in beiden Dokumenten angebunden werden — das Aggregate bindet eines an einer Komponente oder einem Subsystem an, das Release an seinem Eintrag für eine Komponente oder an einer Boundary —, daher wird die Kategorie eines Befunds zu einer Anbindung daran abgelesen, wo die Anbindung geschrieben wurde, nicht an der Komponente, die sie erreicht. Der Befund wird an dem features:-Eintrag positioniert, der die Anbindung geschrieben hat, in jenem Dokument, und dem Autor jenes Dokuments zugeordnet: Eine Anbindung, die nur das Release vornimmt, wird am eigenen Pfad des Release als [OPS_ERROR] gemeldet, und eine, die das Aggregate vornimmt, am Pfad des Aggregate als [DEVELOPER_ERROR].
[OPS_ERROR E0007] release.yaml at .spec.boundaries.main.components.app.features.metrics selector violation ("component.aggrega.ai/type in (server, worker)", declared by Feature "core/prometheus-exporter", not satisfied by the labels of "app"). Add the labels the Feature's appliesTo requires to this component's type, or attach a Feature whose applicability the component already satisfies.Wo beide Dokumente eine Anbindung schreiben — das Aggregate, das sein Feature benennt, das Release, das es dimensioniert —, wird ein Befund zur Anbindung als Ganzes dort positioniert, wo ihr Feature benannt wird, also im Aggregate. Ein Befund zu einem Teil ihrer Konfiguration wird dort positioniert, wo dieser Teil geschrieben wurde: ihre values gehören dem Entwickler, im Aggregate, und ihr infra dem Operator, im Release. Eine Anbindung, die durch annotationsgesteuerte Expansion entstanden ist, wurde von keinem features:-Eintrag geschrieben, daher wird ein Befund dazu an der Komponente positioniert, in dem Dokument, das die Komponente deklariert, als [DEVELOPER_ERROR].
Ein leer gelassener erforderlicher Slot ist der einzige Fall, den kein Dokument geschrieben hat. Es gibt keine Anbindung, auf die verwiesen werden könnte, daher bleibt der Befund an der Komponente im Aggregate und wird als [DEVELOPER_ERROR] eingeordnet, und seine Abhilfe nennt beide Dokumente, weil jedes von beiden den Slot befüllen kann: „Attach a Feature at that name, in the Aggregate or in the Release, on the component or at a scope above it.“ (Binden Sie ein Feature unter diesem Namen an, im Aggregate oder im Release, an der Komponente oder in einem darüberliegenden Geltungsbereich.)
Der Editor liest dieselbe Platzierung: Ein im Release positionierter Befund wird am Dokument des Release angezeigt, an dem Schlüssel, der ihn geschrieben hat, und am Dokument des Aggregate überhaupt nicht; einer, der im Dokument eines Moduls positioniert ist, das das Aggregate importiert, wird auf dieselbe Weise am Dokument dieses Moduls angezeigt.
Form der Ausgabe
Eine ausgegebene Diagnose beginnt mit der Kopfzeile in eckigen Klammern und dem Quellverweis und stellt die Meldung in eine eigene eingerückte Zeile:
[CATEGORY SHORTCODE] <source> <message>Die Kopfzeile enthält zwei Token, und sie beantworten unterschiedliche Fragen. Die Kategorie ist eine der oben genannten und gibt an, welcher Bereich zu prüfen ist. Der Kurzcode besteht aus dem Buchstaben E und vier Ziffern und benennt die genaue Bedingung, die den Build angehalten hat: Zitieren Sie ihn in einem Bericht, geben Sie ihn in eine Suche ein oder lösen Sie ihn anhand der Tabelle aller Bedingungen in sentinels.md auf. Keines der beiden lässt sich aus dem anderen ableiten, weshalb beide ausgegeben werden — und wo eine Kategorie mehr als eine Abhilfe abdeckt, wie es bei [TRUST_ERROR] der Fall ist, sagt Ihnen der Kurzcode, auf welche Sie gestoßen sind.
Ein von einem Plugin ausgelöster Code wird durch das Plugin qualifiziert, das ihn ausgelöst hat
Jeder Kurzcode benennt eine Bedingung, die Aggrega deklariert, und keine zwei Bedingungen teilen sich einen: Eine Bedingung, die unter einer Nummer deklariert wird, die bereits eine andere Bedingung innehat, wird zurückgewiesen, bevor der Compiler irgendeine Eingabe liest. Ein Plugin vergibt keine eigenen Codes. Wenn es einen Fehler meldet, benennt es eine der Bedingungen, die Aggrega deklariert — eine der wenigen allgemeinen Bedingungen, die beschreiben, wie ein Plugin fehlgeschlagen ist, oder eine spezifischere, wo eine passt — und liefert den Satz, der sagt, was tatsächlich geschehen ist. Zwei Plugins können also denselben Kurzcode melden, und wenn sie das tun, melden sie dieselbe Bedingung.
Was der Code nicht sagen kann, ist, welches Plugin auf die Bedingung gestoßen ist, und eine Kopfzeile, die eine von einem Plugin ausgelöste Bedingung meldet, trägt die Identität des Plugins unmittelbar vor dem Code:
[CATEGORY PLUGIN/SHORTCODE] <source> <message>Der Kurzcode ist immer das letzte Segment — der Buchstabe E und vier Ziffern, nach dem letzten /. Die Identität eines Plugins enthält eigene Trennzeichen und kann eine Version enthalten, daher ist das Lesen vom Ende her statt ab dem ersten / das, was den Code aus jeder Kopfzeile wiederherstellbar macht. Alles vor diesem letzten Segment ist das Plugin.
Das letzte Segment wird wie jeder andere Kurzcode aufgelöst, gleich welches Plugin es ausgelöst hat: Die Tabelle aller Bedingungen in sentinels.md führt es auf, und aggrega explain löst es auf. Zitieren Sie nur das letzte Segment — der Qualifizierer sagt, welches Plugin auf die Bedingung gestoßen ist, nicht, welche Bedingung es ist. Ein Plugin, das einen Code benennt, den Aggrega nicht deklariert — eine Nummer, die keine Bedingung innehat, oder eine ausgemusterte —, bekommt diesen Code nicht ausgegeben: Der Build hält bei E0293 an, qualifiziert durch dieses Plugin, und seine Meldung zitiert den Code, den das Plugin angeboten hat, benennt jene allgemeinen Bedingungen und behält den eigenen Satz des Plugins bei.
Eine Kopfzeile, die einen bloßen Kurzcode ausgibt, meldet eine Bedingung, die Aggrega selbst ausgelöst hat; dazu gehört der Fall, in dem ein Plugin fehlgeschlagen ist und keine eigene Bedingung benannt hat. Dort hat die generische Plugin-Fehlerbedingung des Compilers den Build angehalten, und die Meldung des Plugins enthält die Einzelheiten.
Jedes der beiden Token kann fehlen, und ein fehlendes wird weggelassen
Nichts tritt je an die Stelle eines Tokens, das die Diagnose nicht hat — kein Platzhalter, keine leeren Klammern. Eine Kopfzeile kann auf drei Arten verkürzt sein, und jede sagt Ihnen etwas:
- Kein Kurzcode. Der Fehler benennt keine eigene Bedingung von Aggrega — meist handelt es sich um einen Fehler, den eine vom Compiler umschlossene Bibliothek meldet. Die Kopfzeile gibt nur die Kategorie aus, sodass Sie dennoch wissen, welche Oberfläche zu prüfen ist.
- Keine Kategorie. Der Fehler hat keinen Bereich, an den er Sie verweisen könnte, daher wird keiner geraten. Die Kopfzeile gibt nur den Kurzcode aus, und den Code lösen Sie auf. Zwei Situationen erzeugen dies, und sie lesen sich gleich, weil sie für Ihre Zwecke gleich sind — keine sagt Ihnen, wo Sie nachsehen sollen, und der Code sagt Ihnen, was geschehen ist. Die eine ist ein Defekt im Compiler selbst, bei dem die Meldung dies sagt und Sie bittet, ihn zu melden; der Fall, der tatsächlich auftritt, ist, dass die eigenen Sichten des Compilers auf den Katalog einander widersprechen. Die andere ist ein Fehler, der eine Bedingung benennt, aber nie eine Oberfläche durchlaufen hat, die ihn einem Bereich zuordnet — die übliche Form einer Zurückweisung an der Befehlsgrenze. Eine Kategorie wird nie erfunden, um die Lücke zu füllen, und das ist der Sinn der Auslassung, nicht eine Einschränkung: Die Kategorie beantwortet „welchen Bereich prüfe ich“, und eine Antwort, die gegeben wird, wo die Frage keine hat, ist keine vorsichtige Antwort, sondern eine falsche, nach der zuerst gehandelt wird. Erwähnenswert ist auch, dass der Umkehrschluss nicht gilt: Eine Kopfzeile, die doch eine Kategorie trägt, verweist nicht immer auf etwas, das Sie verfasst haben, denn
[FETCH_ERROR],[POLICY_ERROR]und[TRUST_ERROR]benennen jeweils einen Bereich statt einer Authoring-Oberfläche. - Keines von beiden. Die Klammern entfallen ganz, und die Diagnose besteht aus ihrer Meldung. Dies ist ein Fehler, der keine eigene Bedingung von Aggrega benennt und keinen Bereich hat, an den er Sie verweisen könnte: ein Befehl, der seine Argumente zurückweist, eine Datei, die er nicht lesen kann, ein Abbruch oder ein Fehler, den eine vom Compiler umschlossene Bibliothek meldet, ohne dass eine Bedingung von uns darunterliegt. Es gibt nichts, was anhand von
sentinels.mdaufzulösen wäre, und die Meldung ist alles, was der Fehler zu sagen hat.
Derselbe Fehler, auf eine Zeile reduziert — die Form für Log-Ausgaben statt für ein Terminal —, trägt die Kategorie und lässt den Kurzcode weg:
[CATEGORY] <source>: <message>Eine Kategorie, die in der Kopfzeile fehlt, fehlt auch hier, einschließlich der Klammern, daher lautet diese Zeile nie [] <source>: <message>. Die einzeilige Form wird beim Aufstieg des Fehlers in umschließende Rahmen neu eingebettet, sodass ein leeres Tag in jeden von ihnen mitgenommen würde.
Die Quelle ist ein strukturierter Verweis — typischerweise <file>:<line>:<column>, wenn eine YAML-Position verfügbar ist, oder ein logischer Bezeichner (der Name der Katalogentität, der Name des Release, der Boundary-Pfad), wenn keine Dateiposition zutrifft. Eine dritte Form, <file> at <key>, erscheint, wenn der Verweis sowohl das Dokument als auch den Authoring-Schlüssel darin kennt, aber keine Byte-Position: Die Datei ist das, was Sie öffnen, und der Schlüssel ist das, worauf Sie nach dem Öffnen schauen. Die Meldung ist die oberflächenspezifische Diagnose.
Ein Fehler, der eine einzelne Instanz Ihres Builds betrifft — eine Komponente, eine Komponente, die ein Modul beisteuert, oder ein Modul selbst —, nennt diese Instanz nach der Position als (instance <name>), sodass aggregate.yaml (instance shop) das Aggregate ist, das das Modul shop deklariert. Wo der Fehler kein Dokument hat, auf das er verweisen kann, steht die Instanz allein als instance <name>: Ein Provider, der beim Rendern der Komponente adminer fehlschlägt, gibt [TRANSLATION_ERROR E0082] instance adminer aus, und die Zeilen darunter tragen den Rest des Fehlers, einschließlich jedes Dokuments, das er nennt. Der Name ist derjenige, unter dem das Aggregate die Komponente deklariert; eine Komponente, die ein Modul beisteuert, wird über ihren Pfad durch das Modul benannt, etwa shop.cart. Eine Instanz wird nie dort ausgegeben, wo eine Datei hingehört, sodass das, womit die Quelle beginnt, ein Dokument ist, das Sie öffnen können, oder einer der oben genannten logischen Bezeichner.
Eine über den fertigen Graphen ausgewertete Regel meldet in dieser dritten Form, und der Schlüssel unterscheidet zwei Befunde, wenn die Meldung allein es nicht kann. Eine Regel dieser Art benennt den deklarierenden Komponententyp statt der Instanz, sodass zwei Komponenten desselben Typs, die dieselbe Regel verletzen, dieselbe Meldung zur selben Datei tragen:
[DEVELOPER_ERROR E0162] aggregate.yaml at .spec.components.checkout missing required feature: attach a Feature of the required type to the component ("core/observability/monitoring", required by component type "core/compute/api-server", under the requirement label "monitoring")---[DEVELOPER_ERROR E0162] aggregate.yaml at .spec.components.inventory missing required feature: attach a Feature of the required type to the component ("core/observability/monitoring", required by component type "core/compute/api-server", under the requirement label "monitoring")Der Schlüssel ist der einzige Teil, der sich unterscheidet, und er gibt an, welche der beiden Komponenten zu bearbeiten ist. Beide Befunde tragen denselben Kurzcode, weil beide dieselbe Bedingung sind, zweimal angetroffen — der Kurzcode benennt die Regel, und der Schlüssel benennt das Vorkommen.
Zwei weitere Zeilen gehören zur Form, für einen Fehler, der den Kontext zu ihrer Befüllung mitbringt — der Template-Ausdruck, der fehlgeschlagen ist, und eine Momentaufnahme der Säulen, die an der Fehlerstelle im Geltungsbereich waren:
[CATEGORY SHORTCODE] <source> <message> expression: <the template excerpt that triggered the failure> active pillars: <one line per top-level pillar key in scope at the point of failure>Die Zeile expression: enthält den Template-Auszug, der den Fehler ausgelöst hat. Der Block active pillars: listet die Säulenschlüssel der obersten Ebene auf, die an der Fehlerstelle verfügbar waren, sodass Autoren sehen, was abfragbar war. Beide entfallen, wenn der Fehler keines von beiden mitbringt.
Verschachtelte Kontextrahmen
Ein Fehler durchläuft auf seinem Weg zur CLI oft mehr als eine Oberfläche: Eine Ladephase umschließt den spezifischen Entitätsfehler, der seinerseits einen Sentinel umschließt, der die Regel erklärt. Jeder kategorisierte Rahmen in einer solchen Kette wird dargestellt — der äußerste als Kopfzeile in der obigen Form, jeder verschachtelte Rahmen als eingerückte Fortsetzungszeile caused by: mit eigenem Kategorie-Tag, eigenem Quellverweis und eigener Meldung. Der innerste auf eine Datei verweisende Rahmen ist immer sichtbar:
[CATALOG_ERROR E0094] aggrega-catalog catalog load caused by: [CATALOG_ERROR] aggrega-catalog/recipe/compose/mariadb-copy/1.0.0/recipe.yaml duplicate entity identity within a single catalog directory (recipe identity "compose/mariadb:1.0.0")Nur die Kopfzeile trägt einen Kurzcode, und die Fortsetzungszeilen tragen nur ihre Kategorie. Die Bedingung wird einmal benannt, an der Stelle, an der der Leser auf den Fehler trifft; die Rahmen unter einer Markierung caused by: sind derselbe Fehler, von weiter innen gesehen, sodass eine Wiederholung seines Bezeichners in jedem Rahmen Zeilen hinzufügen würde, ohne Fakten hinzuzufügen. Ein Block note: ist keine Fortsetzungszeile und folgt dieser Regel nicht — er meldet die Bedingungen anderer Dokumente statt derselben von weiter innen; der Abschnitt unten behandelt ihn. Der Code, den die Kopfzeile ausgibt, ist der, den die Kette benennt — hier die Regel ganz unten —, sodass ein Phasenkontext-Rahmen oben dennoch die darunterliegende Bedingung identifiziert.
Von oben nach unten gelesen: die fehlgeschlagene Phase, dann die Entität (mit ihrem Dateipfad), die den Fehler verursacht hat, dann die verletzte Regel. Ein verschachtelter Rahmen, der nichts über seinen Elternrahmen hinaus hinzufügt (gleiche Kategorie, gleiche Quelle, eine Meldung, die der Elternrahmen bereits enthält), wird dedupliziert statt wiederholt, und eine abschließende Erklärung wird nur dargestellt, wenn die Rahmen darüber ihren Text nicht bereits tragen.
Eine Kette reicht tiefer, wann immer ein Fehler auf seinem Weg nach außen mehr Oberflächen durchläuft, und die Regel gilt in jeder Tiefe. Ein Template, das innerhalb der synthetisierten Workload eines Recipe zurückgewiesen wird, durchläuft drei — den gerenderten Knoten, die Template-Oberfläche des Recipe und das Template selbst:
[CATALOG_ERROR E0060] instance db rendering node "db" caused by: [CATALOG_ERROR] recipe "mariadb" workload template caused by: [CATALOG_ERROR] workload[mariadb] template references a root the render context does not define (template "workload[mariadb]" references ".nosuchroot.database", the render context defines .context, .values, .infra, .locals, .provides, .features, .metadata, .attachment_name, .inject, .inject_raw, .steps, .source, .workload, .boundary)Lesen Sie sie wie zuvor von oben nach unten, und beachten Sie drei Dinge, die die zusätzliche Tiefe sichtbar macht. Der Kurzcode erscheint einmal, in der Kopfzeile, wie viele Fortsetzungszeilen auch folgen. Im innersten Rahmen steht der eigene Satz der Bedingung, sodass die tiefste Zeile sowohl die ist, auf die man abgleicht, als auch die, die sagt, was zu ändern ist. Und ein Rahmen ohne Quellverweis gibt nur seine Kategorie aus: Der mittlere Rahmen oben benennt die Oberfläche, an der er fehlgeschlagen ist, in seiner Meldung, weil diese Oberfläche ein Template und keine Datei ist und keine Position hat, auf die verwiesen werden könnte.
Wenn sich der Fehler unter einem Rahmen verzweigt — eine Phase, die vor dem Anhalten mehrere unabhängige Verletzungen gesammelt hat —, trägt die Fortsetzungszeile eine Anzahl, und jeder gesammelte Fehler wird darunter dargestellt, getrennt durch dieselbe Linie ---, die die Mehrfachfehlerketten weiter unten verwenden:
[OPS_ERROR E0099] recipe resolution caused by (2): [OPS_ERROR] .spec.components.edge no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.edge, "edge", of type "example/gateway/nginx-reviewed"). no recipe in the catalog implements this type; write one, then map the type to it --- [OPS_ERROR] .spec.components.internal no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.internal, "internal", of type "example/gateway/nginx-reviewed"). no recipe in the catalog implements this type; write one, then map the type to itDie gesammelten Fehler unter der Anzahl sind ebenfalls Fortsetzungszeilen, daher wiederholt keiner von ihnen den Kurzcode der Kopfzeile — und genau das verhindert, dass eine Verzweigung mit einem Dutzend Verletzungen denselben Bezeichner ein Dutzend Mal ausgibt.
Durchgehend gilt eine einzige Trennzeichen-Grammatik: --- zwischen gleichrangigen Fehlern, caused by: zwischen verschachtelten Kontextrahmen.
Eine zurückgewiesene Katalogdatei und der Fehler, den sie erklärt
Das Laden eines Katalogs, um aufzulösen, wovon ein Release abhängt, ist absichtlich tolerant: Eine Datei, die nicht gelesen werden kann, oder ein Aggrega-Dokument, das nicht geparst oder indiziert werden kann, wird zurückgewiesen und festgehalten, statt den gesamten Ladevorgang abzubrechen. Das verhindert, dass eine fehlerhafte Entität, die Ihr Release nie berührt, einen unabhängigen Build scheitern lässt.
Die Folge ist, dass eine zurückgewiesene Datei stillschweigend im Katalog fehlt — und wenn Ihr Release sie doch erreicht, scheitert der Versuch, einen Verweis auf das aufzulösen, was diese Datei deklariert hat. Dieser Fehler ist eine Folge der Zurückweisung und nicht die Zurückweisung selbst, daher stellt der Bericht die beiden in kausale Reihenfolge, wo immer er die Zurückweisung genau benennen kann:
[CATALOG_ERROR E0215] catalog/recipes/helm/server.yaml document envelope validation failed (Recipe, at catalog/recipes/helm/server.yaml); 6:1: spec.implements: missing required property: implements. correct the document to match its kind's schema note: this file was skipped at load, so the catalog holds nothing under the identity it declares. This Release reaches that identity, so what failed is the attempt to resolve the reference to it: resolve entity "server-recipe:1.0.0": catalog: tier-3 pull server-recipe:1.0.0: recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location: "server-recipe"Die Zurückweisung steht an erster Stelle, mit eigener Kategorie und eigenem Kurzcode, weil sie das benennt, worauf Sie reagieren können: Die Korrektur ist ein fehlendes implements: in einem Recipe, nicht etwas daran, wie ein Verweis in einer Registry nachgeschlagen wird. Der Auflösungsfehler wird darunter trotzdem gemeldet, weil er sagt, warum dieses Dokument überhaupt benötigt wurde.
Eine Zurückweisung steht nur dann an erster Stelle, wenn genau eine zurückgewiesene Datei die Identität deklariert, die der fehlgeschlagene Verweis benennt. Abgeglichen wird die Identität, die jedes Dokument für sich selbst deklariert — sein Typ, sein Name, seine Version und bei einem Rezept die spec.capability, die es eingrenzt —, sodass eine zurückgewiesene Datei, die deklariert, wonach der Verweis fragt, die Datei ist, zu der dieser Verweis aufgelöst worden wäre. Daraus folgen zwei Konsequenzen. Ein Verweis, der einen Bereich von Versionen statt einer Version angibt, benennt kein einzelnes Dokument und hebt daher nichts hervor. Und ein Dokument, das zu fehlerhaft ist, als dass sein Kopf gelesen werden könnte, deklariert überhaupt keine Identität und wird daher nie als Ursache von irgendetwas benannt.
Wo keine zurückgewiesene Datei diese Identität deklariert oder mehr als eine, ist der Bericht so, wie er ohne Zurückweisungsprotokoll wäre: Der Fehler steht an erster Stelle, und jede Zurückweisung wird darunter aufgeführt, damit Sie sie abwägen können. Die falsche Datei als Ursache zu benennen wäre schlimmer, als keine zu benennen, weil Sie danach handeln würden.
[E0105] resolve entity "server-recipe:1.0.0": catalog: tier-3 pull server-recipe:1.0.0: recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location: "server-recipe" note: catalog files skipped at load. A refusal outside this Release's closure is tolerated and never fails a build, so this failure is explained only by a refusal naming something this Release reaches: - Recipe "server-recipe" (catalog/recipes/helm/server.yaml): [CATALOG_ERROR E0215] catalog/recipes/helm/server.yaml: document envelope validation failed (Recipe, at catalog/recipes/helm/server.yaml); 6:1: spec.implements: missing required property: implements. correct the document to match its kind's schemaEiniges an dieser zweiten Form ist wissenswert, weil jedes davon eine Frage beantwortet, die der Block sonst aufwerfen würde.
Die Kopfzeile benennt den Fehler, nicht eine Zurückweisung. Der Kurzcode oben ist der, den der Auflösungsfehler ausgelöst hat, weil dieser Fehler hier an erster Stelle steht — keine zurückgewiesene Datei wurde hervorgehoben, also führt keine von ihnen die Zeile an. Neben ihm steht keine Kategorie, weil nichts auf diesem Pfad den Fehler einem Bereich zugeordnet hat. Die eigene Kopfzeile jeder Zurückweisung steht in ihrem eigenen Eintrag darunter, und dort lesen Sie sie.
Jede Zurückweisung wird aufgeführt, nicht nur die, auf die es ankam. Diese Form zu erreichen bedeutet, dass das Protokoll keine einzelne hervorheben konnte, daher benennt die Notiz die Unterscheidung, statt zu raten: Eine Zurückweisung außerhalb der Hülle dieses Release wird toleriert und kann nicht das sein, was fehlgeschlagen ist, womit eine Zurückweisung, die etwas benennt, das das Release erreicht, als einziger Eintrag bleibt, der den Fehler erklärt. Lesen Sie die Einträge vor dem Hintergrund dessen, was Ihr Release tatsächlich verwendet.
Jeder Eintrag trägt seine eigene Kopfzeile in eckigen Klammern — seine eigene Kategorie und seinen eigenen Kurzcode. Dies ist die einzige Stelle, an der ein Kurzcode unterhalb der Kopfzeile der Diagnose erscheint, und es ist keine Ausnahme von der obigen Regel für Fortsetzungszeilen, sondern eine Folge davon: Ein Eintrag unter note: ist nicht derselbe Fehler von weiter innen gesehen, sondern eine andere Bedingung, ausgelöst von einem anderen Dokument. Ihre Bedingung zu benennen ist das, was Ihnen erlaubt, die Zurückweisung nachzuschlagen und die Datei zu korrigieren — die Handlung, die der Block ermöglichen soll.
Eine zurückgewiesene Datei, deren Kopf zu fehlerhaft war, um die von ihr deklarierte Identität wiederherzustellen, wird nur mit ihrem Pfad aufgeführt. Das ist die ehrliche Lesart eines Dokuments, in das nichts hineinsehen konnte, und der Pfad genügt dennoch, um die Datei zu öffnen. Eine Datei, die so fehlerhaft ist, dass nicht einmal ihr Typ gelesen werden kann — etwa eine, die sich nicht als YAML parsen lässt —, wird auf diese Weise aufgeführt, wenn sie eine Aggrega-apiVersion deklariert, durch eine Zeile, die uneingerückt mit apiVersion: und einem mit aggrega.ai/ beginnenden Wert anfängt, mit der eigenen Begründung des Parsers: der Zeile und dem, was der Parser dort erwartet hat. Eine YAML-Datei, die eine andere apiVersion oder keine deklariert, ist kein Aggrega-Dokument — etwa das Template eines Charts oder eine neben den Entitäten abgelegte Konfigurationsdatei —, daher wird sie nie aufgeführt, wie fehlerhaft sie auch sei.
Eine Datei, die einen Typ deklariert, den kein Katalog enthält, wird nur dort benannt, wo sie den Fehler erklärt. Ein Dokument, das eine Aggrega-apiVersion und einen kind deklariert, den kein Katalog enthält — etwa ein falsch geschriebenes Componnent —, wird von jedem Ladevorgang übergangen, ist also keine Zurückweisung und wird nicht unter ihnen aufgeführt. Wo der fehlgeschlagene Verweis nach dem Namen fragt, den diese Datei deklariert, und nach der Version, wo der Verweis eine angibt, benennt der Bericht sie in einer eigenen Notiz unter dem Fehler, gleich als welcher Typ der Verweis gesammelt wurde — auf jeder unten aufgeführten Oberfläche und bei aggrega build, ob es eine vorhandene Lockfile liest oder zuerst eine befüllt:
[E0114] resolve: no entity in the catalog matches this URI: entity "<reference>" (referenced from <referring paths>) note: a catalog file declares the name this reference asks for under a kind a catalog does not hold, so the load skipped it: - Componnent "<name>" (<path>): [CATALOG_ERROR E0371] <path>: catalog document declares a kind a catalog does not hold (kind "Componnent"). a catalog holds Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate and Plugin documents, and passes over a Workload, a Manifest or a Release; correct the kind, or move the file out of the catalog directoriesDer Fehler steht weiterhin an erster Stelle: Der Typ, den die Datei deklariert, benennt keine Identität, daher wird die Datei nie als die Zurückweisung hervorgehoben, mit der der Bericht beginnt. Die Darstellung, woher lokale Entitäten gelesen werden, entfällt in diesem Bericht, weil die Datei bereits dort liegt, wo der Katalog liest, und sie zu verschieben nicht helfen würde. Eine Datei eines Typs, den kein Katalog enthält, die einen anderen Namen deklariert, erklärt nichts an diesem Fehler und wird nicht erwähnt. aggrega serve, dessen Meldungen einzeilig sind, trägt dieselbe Notiz in dieser Zeile — note: a catalog file declares the name this reference asks for under a kind a catalog does not hold, so the load skipped it:, gefolgt von der Zurückweisung der Datei — und führt eine solche Datei nie unter den beim Laden übersprungenen Dateien auf; das Tool describe von aggrega mcp, nach einem Namen in den Begriffen eines Release gefragt, benennt sie ebenfalls anstelle dieser Darstellung. aggrega validate und aggrega lint über den ganzen Katalog melden jede solche Datei, ob etwas sie erreicht oder nicht — siehe fatal-halts.md §„A catalog document declares a kind a catalog does not hold (Ein Katalogdokument deklariert einen Typ, den ein Katalog nicht enthält)“.
Gleich welche Form Sie erhalten, der Fehler behält seine eigene Identität. Die Notiz wird dem Fehler hinzugefügt, statt über ihm dargestellt zu werden, und das Voranstellen einer Zurückweisung ändert nur, was Sie zuerst lesen — die Bedingung, die der Fehler ausgelöst hat, bleibt also in beiden Fällen intakt: Ihr Kurzcode lässt sich weiterhin auflösen, und ein Tool, das auf die Bedingung abgleicht, findet sie weiterhin.
Wo das zurückgewiesene Dokument selbst das ist, was ein Befehl meldet, wird die Zurückweisung einmal angegeben. aggrega inspect <name> lädt den Katalog strikt, sodass ein Dokument, das der Ladevorgang zurückweist, ihn anhält, und was er ausgibt, ist die Zurückweisung dieses Dokuments als einzelne Diagnose: die Kopfzeile mit Kategorie und Kurzcode der Zurückweisung, das Dokument als Quelle und darunter, was an dem Dokument falsch ist — bei einer Schemaverletzung die verletzten Schlüssel mit ihren Zeilen und Spalten sowie der Rat. Der Ladevorgang, der sie ausgelöst hat, durchlief das Verzeichnis, das er gerade durchging, und den Schritt, der die Datei las, und diese werden nicht als eigene Rahmen ausgegeben, weil jeder dasselbe Dokument erneut benennen würde, ohne eine Tatsache hinzuzufügen. aggrega serve, gefragt, worauf sich ein Name bezieht, wo ein zurückgewiesenes Dokument diesen Namen deklariert, antwortet mit derselben Zurückweisung in denselben Worten in einer Zeile, gefolgt von der Notiz, dass die Datei beim Laden übersprungen wurde. Wie oben bleibt die Bedingung der Zurückweisung in beiden Fällen abgleichbar.
Beide Formen erreichen Sie überall, wo diese Auflösung läuft. aggrega build, aggrega pull, aggrega validate --release und aggrega inspect --closure erzeugen sie in einem Terminal, ebenso wie aggrega validate über ein einzelnes Recipe, dessen implements-Ziel nicht gefunden wird, und ein über aggrega mcp verbundener KI-Assistent erhält dieselbe Darstellung von den Tools build und validate sowie die vorangestellte Zurückweisung in einer Zeile aus einem catalog://-Lesevorgang einer Entität, die eine zurückgewiesene Datei deklariert. Von welcher Oberfläche aus Sie gefragt haben, ändert nichts daran, welche Datei Sie öffnen sollen — einem Aufrufer, der aggrega mcp über HTTP erreicht, wird sie relativ zur Wurzel des Workspace genannt, und eine Datei außerhalb des Workspace, den dieser Server bedient, wird ihm nicht genannt —, und wo eine Zurückweisung an erster Stelle steht, ist der Authoring-Vertrag, auf den die Antwort verweist, der für den Typ, den dieses zurückgewiesene Dokument deklariert — nicht für den Typ des fehlgeschlagenen Verweises.
Die Fehlerklasse der Dokumenthülle
Jedes Entitätsdokument — Katalogentitäten, Aggregates, Manifests, Releases — wird beim Laden gegen das veröffentlichte JSON-Schema seiner Art validiert, noch vor dem typisierten Parsen. Ein Dokument, das seine Hülle verletzt (ein unbekannter Schlüssel, ein fehlendes Pflichtfeld, ein Wert der falschen Form, ein verbotenes Konstrukt wie values: in einem Release), bricht den Build deutlich sichtbar ab, mit einer Diagnose, die zuerst die Bedingung nennt, dann die Entitätsart und die Datei, dann jeden fehlerhaften Schlüssel oder jede fehlerhafte Form mit der Zeile und Spalte, in der er steht, und schließlich, was zu tun ist:
[OPS_ERROR E0215] release.yaml document envelope validation failed (Release, at release.yaml); 12:7: spec.boundaries.main.values: against /$defs/boundary: unexpected property: "values". correct the document to match its kind's schemaDie Diagnose beginnt mit der Bedingung, nennt die Art und die Datei und schließt mit dem, was zu tun ist; jede Verletzung dazwischen trägt nur line:column, da die Kopfzeile die Datei bereits genannt hat. Jeder fehlerhafte Schlüssel wird an seiner eigenen Position gemeldet statt an der Position des Blocks, der ihn enthält, sodass Zeile und Spalte auf den Schlüssel zeigen, den Sie ändern müssen. Wo die Form der Position aus einer wiederverwendbaren Definition im Schema stammt, nennt die Diagnose diese Definition nach dem Wort against — oben against /$defs/boundary —, damit klar ist, gegen welchen Vertrag der Schlüssel geprüft wurde, und die Definition sich nicht wie ein weiterer Schritt entlang des von Ihnen geschriebenen Schlüsselpfads liest. Ein Dokument mit mehreren Verletzungen listet jede an ihrer eigenen Position auf, in Schlüsselreihenfolge, und der Bericht endet nach vier mit der Anzahl der übrigen.
Zwei Dinge sind darüber wissenswert, wohin eine Position zeigt, denn beide sind eher nützlich als überraschend:
- Ein fehlender Pflichtschlüssel hat keine eigene Position — er fehlt per Definition im Dokument. Die Verletzung zeigt stattdessen auf den umschließenden Schlüssel, denn dort gehört der fehlende Eintrag hin. So zeigt
spec.capability: missing required propertyaufspec:, und dort fügen Sie ihn hinzu. - Ein Schlüssel, dessen eigener Name einen Punkt enthält — jedes Label
component.aggrega.ai/…und jede Annotationfeatures.aggrega.ai/…— wird an dem Block gemeldet, der ihn enthält, statt am Eintrag selbst, da die Punkte als Schritte hinab ins Dokument gelesen werden. Eine Verletzung an einem Label zeigt auflabels:.
Wo eine Verletzung einen Schlüssel nennt, der nirgends im Dokument steht — etwa ein ganzer ausgelassener Block metadata: —, wird die Position weggelassen statt geraten, und die Verletzung besteht nur aus dem Schlüsselpfad und der Meldung. Eine Position, der Sie misstrauen müssten, ist schlimmer als gar keine.
Die Kategorie folgt der Authoring-Oberfläche: [CATALOG_ERROR] für Katalogentitäten, [DEVELOPER_ERROR] für Aggregates, [OPS_ERROR] für Releases und Manifests. Dieselbe Prüfung läuft auf jeder Oberfläche, die Entitäten lädt — aggrega build, aggrega lint, aggrega validate und die Editor-Diagnosen, die aggrega serve veröffentlicht —, sodass ein überzähliger oder falsch geschriebener Schlüssel überall dort abgelehnt wird, wo das Dokument zuerst gelesen wird, statt stillschweigend verworfen zu werden. Jede dieser Oberflächen ermittelt die Position auf dieselbe Weise, sodass sie auf denselben Schlüssel zeigen, und jede liest den Satz der Bedingung aus der Bedingung selbst: Die Zeile, die Ihr Editor unterstreicht, ist die Zeile, die das Terminal nennt, und der Satz, mit dem der Eintrag des Editors beginnt, ist der Satz, mit dem das Terminal beginnt. Was die beiden Oberflächen nicht teilen, ist die vollständige Meldung, und das ist beabsichtigt — das Terminal fasst jeden Befund unter einer Kopfzeile zusammen und schließt mit dem Hinweis für den Pfad, während der Editor einen Eintrag pro Befund ausgibt, positioniert auf dessen eigenem Schlüssel, und weder die Datei wiederholt, an die er bereits angehängt ist, noch einen Hinweis, den er sonst bei jeder Unterstreichung wiederholen würde. Der übereinstimmende Teil ist also der, an dem Sie die Bedingung erkennen.
Ketten mehrerer Fehler
Wenn eine einzelne Kompilierung mehrere unabhängige Verletzungen erkennt (am häufigsten während der statischen Analyse, bei der jede Verletzung eines Selektors und von appliesTo gesammelt wird, bevor eine davon den Build abbricht), werden die Fehler zu einer einzigen Kette verbunden. Die CLI durchläuft die Kette und gibt jeden Teilfehler unabhängig aus, getrennt durch eine horizontale Trennlinie:
[DEVELOPER_ERROR E0007] aggregate.yaml at .spec.components.edge.uses.reviewed_upstream.internal selector violation ("gateway.example.com/audit-tier=reviewed", declared on socket "reviewed_upstream", not satisfied by the labels of "internal"). Add the labels the selector requires to the target's component type, or wire the socket to a component that already carries them.---[DEVELOPER_ERROR E0007] aggregate.yaml at .spec.components.edge2.uses.reviewed_upstream.internal selector violation ("gateway.example.com/audit-tier=reviewed", declared on socket "reviewed_upstream", not satisfied by the labels of "internal"). Add the labels the selector requires to the target's component type, or wire the socket to a component that already carries them.Das Trennzeichen --- ist wörtlich zu nehmen — Leser und nachgelagerte Werkzeuge können daran trennen, um die verbundenen Fehler aufzuzählen. Jeder Teilfehler ist ein eigenständiger Fehlschlag und kein Detail seines Nachbarn, daher trägt jeder eine eigene Kopfzeile: seine eigene Kategorie und seinen eigenen Kurzcode, jeweils sofern vorhanden, wie der Abschnitt über fehlende Token beschreibt. Zwei Verletzungen einer Regel nennen denselben Kurzcode, wie oben; zwei Verletzungen verschiedener Regeln nennen verschiedene.
Einen Fehler von Anfang bis Ende lesen
In den meisten Authoring-Kontexten bestimmen das Kategoriepräfix und der Quellverweis gemeinsam, was zu beheben ist:
| Kategorie | Wo die Behebung liegt | Beispieloberflächen |
|---|---|---|
[DEVELOPER_ERROR] | Aggregate-YAML | Verletzungen von Selektoren / appliesTo in dem, was das Aggregate geschrieben hat; Socket-Abweichung bei uses auf Seiten des Aggregate; Abbrüche des Resolvers beim Authoring durch Entwickler. |
[OPS_ERROR] | Release-YAML / Manifest-YAML | Die Pfadvorlage der Boundary verweist auf ein nicht unterstütztes Feld; subDirectory verursacht eine Pfadkollision; Abbrüche des Resolvers beim Authoring des Release; eine Verbindung, die das Release verdrahtet, oder eine Anbindung, die es an einer Verbindung befüllt, abgelehnt durch die Regeln des Sockets oder des Slots; ein Feature, das nur das Release anhängt, an eine Komponente oder an eine Boundary, abgelehnt durch die Regeln des Feature oder des Slots; ein Mapping oder eine Annotationsbindung eines Manifest wird abgelehnt. |
[CATALOG_ERROR] | Recipe / FeatureRecipe / Component / Feature / Plugin | Formregeln eines Recipe; die Vorlage eines FeatureRecipe verweist mit executionScope: boundary auf ein nur pro Komponente verfügbares Feld; die Kreuzprüfung von featuresSchema einer Workload schlägt fehl. |
[TRANSLATION_ERROR] | Workload / Ausgabe von valuesMapping / Quell-Overlay | Auflösung des Probe-Ports in Helm; Kollision von Compose-Dienstnamen über Boundaries hinweg; zwei Compose-Beitragende, die denselben Volume- oder Config-Namen auf oberster Ebene mit widersprüchlichen Inhalten deklarieren; Nichtübereinstimmung des Chart-Namens beim Umbrella helm-chart. |
[FETCH_ERROR] | Beschaffung aus Registry / entfernter Quelle (operativ, kein Authoring) | Artefakt in der Registry nicht gefunden; Authentifizierung erforderlich; Netzwerk nicht erreichbar; Digest im Cache stimmt nicht mit der Lockfile überein. Behebung: authentifizieren, die Konnektivität wiederherstellen oder aggrega pull --upgrade --release <release>. |
[POLICY_ERROR] | Policy-Plugin (Governance-Regel) | Ein Policy-Plugin, das an einer Urteilsrolle der Governance angehängt ist, hat den zusammengesetzten Build anhand einer von ihm durchgesetzten Regel abgelehnt. Behebung: die durchgesetzte Policy erfüllen oder die Anbindung überdenken. |
[TRUST_ERROR] | Trust-Konfiguration oder die eigene Signatur des Artefakts (ein Bereich, keine Authoring-Oberfläche) | Eine nicht lesbare Trust-Policy oder fixierte Vertrauenswurzel; eine schlüssellose Policy, die keine vertrauenswürdige Identität deklariert; eine Signatur-Policy, die für die zu veröffentlichende Art eine Signatur verlangt; ein aufgezeichnetes Gate für eine Urteilsanbindung, das die Konfiguration nicht mehr anbindet. Oder: eine Signatur, die sich nicht verifizieren lässt; ein Artefakt ohne Signatur, wo eine verlangt wird; ein nicht vertrauenswürdiger Signierer; ein Plugin, dessen aufgezeichnete vertrauenswürdige Identität nicht mehr übereinstimmt. Behebung: die Konfiguration oder den eingecheckten Trust-Eintrag korrigieren oder über das Artefakt entscheiden — der Kurzcode sagt, welches von beiden. |
Provider-spezifische Kontextpräfixe (helm: node "<id>": ..., compose: node "<id>": ...) erscheinen im Meldungsteil von Ausgaben mit [TRANSLATION_ERROR] und [CATALOG_ERROR], um den fehlschlagenden Provider zu lokalisieren, wenn mehr als ein Provider im Spiel ist.
Bibliothekseigene Fehler
Fehler, die in einer zugrunde liegenden Bibliothek entstehen (Chart-Ladefehler des Helm SDK, Fehler des YAML-Parsers von docker-compose, Datei-I/O-Fehler durch einen fehlenden Quellpfad), werden mit dem Provider-spezifischen Kontextpräfix umhüllt und erscheinen unter [TRANSLATION_ERROR] oder [CATALOG_ERROR], je nachdem, ob sie bei der Synthese oder beim Laden von Kataloginhalten ausgelöst wurden. Die umhüllte Bibliotheksmeldung bewahrt die Diagnose des ursprünglichen Werkzeugs wörtlich, damit Autoren sie mit der eigenen Dokumentation des Werkzeugs abgleichen können.
Querverweise
fatal-halts.md— Katalog aller fatalen Abbrüche, Fehler für Fehler, mit beabsichtigter Meldung und Behebung.warnings.md— nicht fatale Hinweise, die der Compiler ausgibt.vocabulary/validation-surface.md— die vier Ebenen der Schemavalidierung und wie ihre Fehlerformen zusammenwirken.