2026 OpenClaw front sur Mac distant :
JSON Unlighthouse, seuils liens morts et synthèse régression Lighthouse vers les pull requests — étapes reproductibles
Équipes CI front sur Mac distant : parser le JSON Unlighthouse, appliquer des budgets 4xx et poster les digests Lighthouse en PR. Matrices, champs JSON, seuils et étapes OpenClaw — liens webhook preview et synthèse Bugsnag PR.
Lighthouse sur / seul laisse passer des 404 profonds. Résultat : Unlighthouse plus Lighthouse sur Apple Silicon, fusionnés par OpenClaw en commentaire PR sous 4 Ko.
Trois frictions que ce pipeline retire
1) Lighthouse sur la home alors que la doc imbriquée renvoie 404.
2) Les échecs de liens morts restent dans les logs, pas dans les commentaires PR.
3) Chromium conteneurisé diverge du Mac Safari.
Unlighthouse vs Lighthouse CLI unique : quelle porte quand
Utilisez les deux, mais n’interchangez jamais leurs verdicts. Unlighthouse répond à la santé du graphe de liens ; Lighthouse répond aux budgets labo sur une courte liste blanche.
| Outil | Idéal pour | À éviter quand |
|---|---|---|
| Unlighthouse CI | Graphe de liens internes, codes statut par route, découverte sitemap sur previews. | Vous ne livrez qu’une SPA sans routes marketing. |
| Lighthouse CLI | Budgets LCP, CLS, TBT sur checkout, accueil et tarifs après préchauffage. | Vous devez prouver que les articles de blog à trois niveaux résolvent encore. |
| Porte OpenClaw combinée | Un digest Markdown : liens cassés d’abord, pire métrique ensuite, code de sortie lié à la politique de merge. | Chrome et Node majeurs ne sont pas épinglés sur le même worker Mac. |
« Unlighthouse cartographie, Lighthouse photographie trois URLs » — un Mac distant pour les deux.
Installer Node 24+ et la passerelle OpenClaw sur le Mac distant
- Épingler Node 24 LTS avec la même majeure dans les métadonnées CI ; activer
corepackpour pnpm. - Installer la CLI OpenClaw globalement ou en devDependency ; stocker
OPENCLAW_GATEWAY_TOKENdans le trousseau macOS, pas le dépôt. - Exposer l’ingress HTTPS sur l’hôte loué ; vérifier le HMAC des webhooks de déploiement selon le guide webhook preview.
- File locale sous
.openclaw/queue/si SSH coupe en plein crawl. - Épingler Chromium au même build pour Unlighthouse et Lighthouse ; enregistrer le chemin dans
.openclaw/toolchain.lock.json.
node -v # attendu v24.x pnpm add -D @unlighthouse/cli lighthouse openclaw openclaw gateway doctor --json > .openclaw/reports/doctor.json
JSON de sortie Unlighthouse CI : champs que votre parseur doit lire
Exécutez avec --reporter json et écrivez .openclaw/reports/unlighthouse.json. Les clés stables comptent plus que le pretty-print.
- site.url — racine preview canonique ; comparer à
PREVIEW_URLdu hook. - routes[] —
path,score,reports.lighthouseoptionnel. - reports.links — filtrer
status >= 400sur les href internes. - summary.brokenLinks et ci.buildId — échec rapide et corrélation
OPENCLAW_RUN_ID.
Liens morts, ratio 4xx et règles de blocage merge
| Signal | Budget | Code de sortie |
|---|---|---|
| Liens internes cassés | 0 sur branches release ; <= 2 sur branches doc longues avec ID ticket dans le corps PR. |
2 régression |
| Taux 4xx sur internes crawlés | <= 0,5 % des href internes (échantillon min. 200 liens). |
2 si dépassé |
| 5xx ou timeout | Toute route >= 500 sur chemins liste blanche bloque le merge. |
3 après un retry (infra) |
Seuils de régression performance (LCP, CLS, TBT)
Lancez Lighthouse sur trois URLs revenu ; comparez perf/thresholds.json au même SHA.
| Métrique | Budget mobile | Action si échec |
|---|---|---|
| Score performance | >= 0,85 |
Lister le delta vs artefact baseline dans le commentaire PR. |
| LCP | <= 2500 ms |
Citer la pire URL en premier ; joindre le chemin lhr.json. |
| CLS | <= 0,08 |
Bloquer si le hero bouge après swap de polices. |
| TBT | <= 200 ms |
Sortie 2 ; citer la pire URL. |
Rapport agrégé OpenClaw : commentaire PR et upsert webhook
- Fusionner
link_gate.jsonet les résuméslhr.jsondansgate_digest.json. - Rendre
pr_unlighthouse_lighthouse.mddepuis le modèle ; rester sous 4 Ko pour les relecteurs mobiles. - Commentaire PR : PATCH le commentaire bot avec le marqueur
<!-- openclaw-unlh-lh -->; même flux que la synthèse JUnit Playwright. - Webhook : POST le digest vers OpenClaw
/v1/runs/{id}/eventspour Slack ou les lignes de déploiement.
Coordination Safari et WebKit sur le même Mac
Les scores labo Chromium ne remplacent pas WebKit. Après la porte, exécutez la matrice Playwright Safari double canal avec --workers=1. Bloquez le merge uniquement si webkitBlocksMerge: true dans le JSON de politique.
FAQ des erreurs courantes
Unlighthouse signale zéro route
Vérifiez le protocole sur site.url, activez la découverte sitemap et passez les en-têtes d’auth preview si l’hôte est derrière un SSO.
Les comptes de liens morts diffèrent entre CI et le Mac
Exécutez les deux crawls sur la même région et le même résolveur DNS. Montez le même fichier cookie jar qu’OpenClaw utilise pour les previews authentifiées.
Lighthouse passe mais la PR affiche encore échec
La porte liens a peut-être sorti 2 en premier. Triez le digest avec les liens cassés avant les lignes performance.
Repères chiffrés pour revues d’architecture
Plafonner les routes Unlighthouse à 150 sur les previews pour finir en 12 minutes sur nœuds classe M.
Exiger au moins 200 href internes avant d’appliquer un ratio 0,5 % de 4xx.
Garder les commentaires PR fusionnés sous 4096 octets ; tronquer les listes de routes à 10 lignes avec lien vers les artefacts.
Louez un nœud de build front Mac distant lorsque vous voulez Unlighthouse, Lighthouse et les lanes Safari sur un seul hôte Apple Silicon. Comparez les forfaits nœuds, lisez l’accès SSH et VNC, parcourez l’index du blog et planifiez la capacité sur l’accueil.
Choisissez vos nœuds Unlighthouse et Lighthouse
Exécutez les crawls Unlighthouse et les budgets Lighthouse à côté de Playwright Safari sur Apple Silicon loué. Poursuivez avec la synthèse rapport HTML Playwright PR, puis les forfaits Mac Mini M4.