sylius-ucp — beide Lesarten statt der halben Reichweite.
Das Bundle stellt das Discovery-Profil unter /.well-known/ucp bereit. Es liefert bewusst ein Superset: einmal so verschachtelt, wie die Spezifikation es verlangt, und einmal flach, wie Discovery-Scanner danach suchen. Zusätzliche Felder ignoriert jeder konforme Parser.
Beide Auslegungen kommen in echten Clients vor — also bedient das Profil beide.
Die Spezifikation verschachtelt alles unter ucp und verlangt signing_keys. Discovery-Scanner suchen dagegen flach nach protocol_version und endpoints auf oberster Ebene. Das ist keine akademische Unterscheidung: beide Lesarten kommen in echten Clients vor, und wer nur eine bedient, ist für die andere Hälfte schlicht unsichtbar.
Deshalb schreibt das Bundle beides in dasselbe Dokument. Die verschachtelte Fassung ist vollständig und spezifikationstreu, die flachen Felder daneben sind Duplikate derselben Werte. Ein konformer Parser ignoriert, was er nicht kennt — das Superset kostet also nichts außer ein paar hundert Bytes, und diese Bytes kaufen Sichtbarkeit bei Clients, die man nicht kontrolliert.
Die Alternative wäre, sich für eine Auslegung zu entscheiden und darauf zu warten, dass die andere Seite nachzieht. Bei einem Discovery-Dokument ist das die teuerste Variante, weil der Fehlerfall stumm ist: man merkt nicht, dass man nicht gefunden wird.
Quellcode & Doku
Composer-Paket
MIT · Sylius 2.0+ · PHP 8.2+
composer require koh/sylius-ucp
Gebaut, getestet und unter MIT veröffentlicht. Die öffentliche Distribution über Packagist wird vorbereitet (coming soon).
Teil der Familie
MIT
Dieses Paket gehört zu koh/sylius-agent-ready — siebzehn Bundles, die einen Sylius-Shop für KI-Agenten benutzbar machen. Jedes ist einzeln einsetzbar.