sylius-auth-md — eine Quelle für auth.md und agent_auth.

Zwei Fassungen derselben Auskunft laufen auseinander, sobald eine sich ändert.

Ein Agent, der herausfinden will, wie er sich bei deinem Shop anmeldet, liest zwei Dinge: das Prosadokument unter /auth.md und den maschinenlesbaren agent_auth-Block der OAuth-Metadaten. Werden beide getrennt gepflegt, laufen sie auseinander — es genügt, dass sich eine der beiden Seiten ändert. Der Agent glaubt dann der falschen und scheitert, ohne dass jemand davon erfährt: es gibt keinen Fehler, der irgendwo aufschlägt, nur einen Login, der nicht zustande kommt.

Deshalb wird /auth.md nicht abgelegt, sondern erzeugt. Beide Ausgaben stammen aus denselben Deskriptoren der installierten Authentifizierungsmethoden. Eine Methode, die du hinzufügst oder entfernst, ändert damit beide Fassungen gleichzeitig — Drift ist keine Frage der Disziplin mehr, sondern strukturell ausgeschlossen.

Ist keine Methode registriert, liefert die Route bewusst 404 statt eines leeren Dokuments. Ein auth.md, das keinen Weg hinein nennt, ist keine neutrale Auskunft — es liest sich für einen Agenten als „dieser Shop lehnt Agenten ab“. Das Fehlen der Datei ist die ehrlichere Antwort: hier ist noch nichts konfiguriert.