@oqio/passation

Les couches de vérification d'un chantier de site OQIO : un orchestrateur au-dessus d'outils éprouvés, un rapport unique, un code de sortie.

Une couche constate une propriété d'un site rendu, sans agent et en CI. Ce paquet n'en réécrit aucune qui existe ailleurs : il appelle SiteOne Crawler, Unlighthouse et axe-core, et n'écrit que ce qui est irréductiblement propre à un chantier OQIO — la non-dérive d'un bloc pris au registry, l'absence de texte bouchon, la conformité d'un manifeste de design.

Les quatre commandes

npx --package=@oqio/[email protected] oqio-passation --url=https://exemple.ch/ --racine=.

| Commande | Ce qu'elle fait | |---|---| | oqio-passation | Les couches, contre un site qui tourne. Le rapport et le verdict. | | oqio-jugement | Le dossier de jugement d'une apparence contre l'ADN d'une marque — un juge le lit, la commande ne juge pas. | | oqio-promouvoir | Les pièces d'un chantier passent candidate → éprouvée dans un registry shadcn. | | oqio-manifeste | Confronte les manifestes de design d'un chantier au catalogue du registry. |

Le paquet porte quatre binaires et aucun ne s'appelle passation : npx @oqio/passation ne sait pas lequel lancer. D'où le --package=, qui nomme le paquet et le binaire séparément.

Les codes de sortie

Trois valeurs, et la distinction porte tout le sens de l'outil :

| Code | Ce qu'il dit | |---|---| | 0 | Le site tient. | | 1 | Une couche est rouge — un verdict sur le site. | | 2 | La mesure n'a pas pu se faire — une panne de l'outil, jamais un verdict. |

Un 2 traité comme un 1 ferait échouer un site correct ; un 2 traité comme un 0 laisserait passer un site jamais mesuré. C'est pourquoi il a son propre code.

Deux outils qui ne s'installent pas avec le paquet

La commande le dit quand ils manquent, et sort en 2.

• SiteOne Crawler — n'est pas sur npm : un exécutable propre à la plateforme, à poser dans .crawler/ ou à désigner par --crawler=/chemin (ou SITEONE_CRAWLER).
• Unlighthouse — sur npm, mais 536 Mo. Il n'est donc pas une dépendance : npm i -D unlighthouse quand on en a besoin, ou --unlighthouse=/chemin (ou UNLIGHTHOUSE_CI).

Les deux se cherchent d'abord dans --racine, c'est-à-dire dans le dépôt mesuré. Un chantier ne les porte presque jamais — ils vivent chez qui lance la mesure, et se désignent alors en chemin absolu.

Provenance

Développé et mis à l'épreuve au banc d'essai du système de développement web OQIO, un dépôt privé où chaque couche est vue au rouge sur un site cassé exprès avant d'être livrée. Une couche jamais vue au rouge n'est pas une couche.

MIT.