Aller au contenu

#Le groupe site

Le groupe theme répond à « mon code est-il bien parti ? ». Celui-ci répond à la question d’après, celle qu’on se pose vraiment : est-ce que mon site va bien ?

Cinq commandes, dont trois qui n’ont besoin d’aucune clé.

CommandeAliasCe qu’elle faitClé
diagnosticdoctorce qui manque au sitelecture, ou aucune avec --adresse
verifiercheckexplore le site publié et dit ce qui casseaucune avec --adresse
vitessespeed, perfle temps de réponse réel de quelques pagesaucune avec --adresse
sauvegarderbackup, exportun export local des thèmeslecture
ouvriropenle site public dans le navigateuraucune avec --adresse
webcosa site

#Ce que le CLI voit du site, et ce qu’il n’en voit pas

C’est la première chose à savoir, parce que c’est ce qui a dessiné ces commandes.

Avec une clé themes, seules les routes de thème répondent. Avec une clé atelier (partenaires), s'y ajoutent les sites, les pages, le menu, la fiche et les fichiers — voir L'atelier. Articles, contacts, domaines et l'écran Diagnostic du CMS restent à la session du navigateur : un porteur de clé n'a pas de cookie, ces routes lui répondent 401.

Ce groupe, lui, fait deux choses, et pas une troisième :

Il regarde le site publiédepuis l’extérieur

Un site publié est une adresse sur le web ouvert. verifier, vitesse et ouvrir le regardent exactement comme le regarde un visiteur — et c’est ce qui les rend justes. Elles n’ont aucune autorisation à demander.

Il lit les thèmespar l’API

diagnostic et sauvegarder passent par /api/themes.

Il ne lit pas le contenuet le dit

Coordonnées, mentions légales, formulaire, pages vides, articles en brouillon : aucune route d’API ne les expose. Le CLI ne les devine pas — il nomme ce qu’il n’a pas regardé, à chaque exécution.

Note

Cette limite est une limite du serveur, pas du CLI. Le jour où une route exposera le diagnostic du CMS à une clé de portée lecture, site diagnostic rendra les quatorze constats au lieu de neuf, sans que rien change ici.

#--adresse, et le domaine personnalisé

Sans --adresse, le CLI déduit l’adresse publique du slug du site : dubois devient https://dubois.webcosa.site, ou http://localhost:3000/s/dubois face à un CMS local.

Un domaine personnalisé ne se déduit pas. Il vit dans la table domaines, qu’aucune route ouverte aux clés n’expose. Un site branché sur atelier-riviere.fr sera donc sondé à partir de son sous-domaine technique : une fois le domaine servi (principal, vérifié, certificat en place), ce sous-domaine renvoie en une redirection 308 vers lui — c’est l’origine du site, la seule adresse que citent sa canonique et son plan. Le CLI suit et compte cette redirection, mais le temps mesuré et les en-têtes de la première réponse sont ceux du sous-domaine, pas de l’adresse que voient les clients.

webcosa site verifier --adresse=https://atelier-riviere.fr

La sortie rappelle systématiquement quand elle a deviné l’adresse plutôt que de la recevoir.

Astuce

--adresse rend aussi ces commandes utilisables sur un site dont vous n’avez pas la clé — celui d’un client que vous dépannez, par exemple. verifier et vitesse n’appellent alors jamais le CMS.

#site diagnostic

Ce qui manque au site, dans la limite de ce qui se voit.

webcosa site diagnostic [--adresse=<url>]
webcosa site diagnosticDiagnostic de Menuiserie Dubois (dubois) ✓ Thème en ligne : Origo 1 brouillon(s) à côté ✓ L'accueil répond 200 en 164 ms ✓ Titre : « Menuiserie Dubois — Agencement sur mesure » ! Aucun résumé pour Google Google prend alors une phrase au hasard dans la page, souvent mal. ✓ Titre de page : « Un travail soigné, tenu dans les délais » ✓ Langue déclarée : fr ✓ Feuille de style servie (4 au total) ✓ robots.txt servi ✓ Plan du site servi

Neuf contrôles : thème publié, réponse de l’accueil, chaîne de redirections, titre, résumé pour Google, <h1>, langue déclarée, feuille de style servie, robots.txt et plan du site. Sort en 1 s’il y a une erreur, jamais sur une alerte.

Note

Pourquoi la feuille de style a son propre contrôle. Le filtre asset_url a produit pendant des semaines un segment assets/ en trop : plus aucun site sur thème Liquid ne chargeait son CSS. Les pages s’affichaient, sans le moindre style, et tous les moniteurs étaient au vert — parce qu’ils s’arrêtaient au code de retour de la page.

Le contrôle prend donc le lien tel qu’il figure dans la page servie et va chercher le fichier. Et il fait passer la feuille du thème (/theme-assets/…) devant celles du cadre applicatif, qui sont servies par le CDN et ne tombent jamais.

#Ce qu’il n’a pas regardé

Cette section s’affiche toujours, y compris quand tout est vert — et c’est le point. « ✓ tout va bien » sur neuf contrôles extérieurs laisserait sinon croire qu’un site sans mentions légales et sans formulaire de contact est un site en bon état.

Sortie du CLIbash
  Ce que le CLI ne peut pas voir
    Les coordonnées, les mentions légales, le formulaire de contact, les
    pages sans titre pour Google, les pages vides, celles qui manquent au
    menu, les articles en brouillon, le domaine personnalisé.

    Ces contrôles vivent dans le CMS (écran Diagnostic) et lisent la base
    derrière une session. Aucune route d'API ne les expose à une clé.

#site verifier

La commande la plus utile du groupe : elle répond à « est-ce que mon site va bien ? » sans ouvrir un navigateur.

webcosa site verifier [--adresse=<url>] [--pages=<n>] [--profondeur=<n>] [--delai=<ms>]
--adresseurl

Le site à explorer. Sans elle, celui de la clé.

--pagesentierdéfaut : 40

Pages explorées — téléchargées et analysées — au maximum.

--profondeurentierdéfaut : 3

Clics depuis la page de départ.

--delaimillisecondesdéfaut : 150

L’attente entre deux requêtes. Elle n’est pas là pour nous protéger, mais pour qu’un contrôle de routine ne ressemble pas à une attaque dans les journaux d’accès du client.

webcosa site verifierExploration de https://dubois.webcosa.site au plus 40 pages, profondeur 3, 150 ms entre deux requêtes, un seul domaine Ce qui casse (2) • répond 500 https://dubois.webcosa.site/legal/mentions-legales cité par https://dubois.webcosa.site/ • répond 404 https://dubois.webcosa.site/images/atelier-2019.jpg cité par https://dubois.webcosa.site/realisations Ce qui coûte (3) • aucun résumé (meta description) : Google prend une phrase au hasard dans la page https://dubois.webcosa.site/contact • 4 redirections en chaîne https://dubois.webcosa.site/tarif → /tarifs → /nos-tarifs • 2 image(s) sans attribut alt https://dubois.webcosa.site/realisations

#Deux listes, et la différence entre elles

Ce qui casse sort en code 1 : pages en erreur, liens internes morts, images qui répondent 404, pages sans <title>. Ce sont des choses qu’un visiteur ou Google rencontre vraiment.

Ce qui coûte ne fait jamais échouer : résumé absent, <h1> manquant, lang absent, images sans alt, redirections en chaîne. Une intégration continue qui échoue sur une image sans alt est une intégration continue qu’on désactive — et avec elle les liens morts qu’elle aurait trouvés le mois suivant.

#Ce qu’elle a plafonné, elle le dit

Sortie du CLIbash
  Ce qui a été regardé
    12 pages explorées, 47 adresses contrôlées

  Ce qui n'a PAS été regardé
    · 9 pages découvertes au-delà du plafond de 40
    · 3 liens sortants — un autre domaine, hors du champ
    · le contenu des pages : ce qui est écrit, personne ne peut le vérifier pour toi
    · les pages qu'aucun lien ne cite — un explorateur suit des liens, il ne devine pas
Attention

Un rapport vert obtenu en n’ayant regardé que six pages sur quarante est pire qu’un rapport rouge : il donne la certitude à la place de l’information. C’est pour cela que cette section s’affiche toujours, et que les plafonds sont rappelés en tête de sortie.

Une page qu’aucun lien ne cite n’est jamais explorée — un explorateur suit des liens, il ne devine pas d’adresses. Si une page publiée n’apparaît pas dans le compte, c’est déjà une information : personne ne peut y arriver non plus.

Note

Pages explorées, adresses contrôlées. Les deux chiffres ne mesurent pas la même chose. Une page explorée est téléchargée et analysée — c’est cher, d’où le plafond de --pages. Une adresse contrôlée n’est interrogée que pour son code de retour — c’est dix fois moins cher, d’où un plafond dix fois plus haut, fixé à --pages × 10.

L’analyse du HTML se fait par expressions régulières, sans analyseur DOM : le CLI n’a aucune dépendance. Une balise <a> citée dans un commentaire sera donc comptée comme un lien. On préfère ce faux positif à son inverse — un lien manqué est un lien mort qui reste en ligne, un lien de trop se voit dans le rapport.

#site vitesse

webcosa site vitesse [--adresse=<url>] [--pages=<n>] [--passages=<n>]
--pagesentierdéfaut : 5

Pages mesurées. Elles sont prises dans le plan du site quand il existe — c’est la liste que le site publie lui-même — et à défaut dans l’accueil et ce qu’il cite.

--passagesentierdéfaut : 3

Mesures par page, au plus 9.

webcosa site vitesseTemps de réponse de https://dubois.webcosa.site 3 passages par page, mesurés depuis CETTE machine page 1er octet à froid page / 46 ms 412 ms 35.4 ko /prestations 53 ms 58 ms 25.0 ko /contact 49 ms 51 ms 25.5 ko Ce que coûte / 890.8 ko — le HTML, plus 15 ressources citées Poids décompressé : ce que le navigateur manipule. Transféré, c'est moins.
Danger

Ce n’est pas une note de performance, et le mot « score » n’apparaît nulle part dans la sortie. Aucun navigateur n’est lancé, aucun JavaScript n’est exécuté, rien n’est mis en page. Lighthouse mesure un rendu ; cette commande mesure une réponse.

Et elle la mesure depuis cette machine et cette connexion. Le même site mesuré en fibre à Paris et en 4G dans un train donnera deux chiffres qui ne se comparent pas. Un chiffre sans son contexte finit dans une conversation où il ne veut plus rien dire.

Note

Pourquoi la médiane, et pourquoi le premier passage à part. Le premier appel vers un hôte paie la résolution DNS et la poignée de main TLS — souvent deux à trois fois le temps des suivants. Une moyenne traînerait ce démarrage à froid dans le résultat final ; la médiane l’écarte.

La colonne « à froid » le montre quand même : c’est ce que subit un visiteur qui arrive pour la première fois. C’est une information, pas du bruit.

Attention

Le poids annoncé est décompressé. Les ressources sont réellement téléchargées, et fetch décompresse en chemin : le total est donc ce que le navigateur manipule une fois la page chargée, pas ce qui passe sur le réseau — souvent trois à cinq fois moins sur du texte.

La première version demandait la taille par une requête HEAD, ce qui semblait plus économe. Elle rendait un total exactement égal au poids du HTML : la plupart des CDN n’annoncent pas content-length sur une réponse compressée, chaque ressource comptait donc pour zéro octet, et la ligne affirmait « plus 15 ressources » sans en avoir ajouté une seule.

#site sauvegarder

webcosa site sauvegarder [--dossier=<chemin>]

Écrit l’archive JSON de chaque thème du site, plus un manifeste. Sans --dossier, dans webcosa-<slug>-<date>/ sous le dossier courant.

webcosa site sauvegarderSauvegarde de Menuiserie Dubois (dubois) vers /Users/marc/webcosa-dubois-2026-08-26 + Origo 51 fichiers · publié + Chantier v2 47 fichiers ✓ 2 thème(s) sauvegardés — 412.7 ko ! Cette sauvegarde ne contient QUE les thèmes.
Danger

Elle ne contient pas votre contenu. Ni les pages, ni les articles, ni les réglages, ni les contacts, ni la médiathèque, ni les redirections.

/api/export les rend tous, en un JSON lisible — mais il s’authentifie par session de navigateur, et rend 401 à une clé d’API. Exportez-les depuis le CMS.

Le nom de la commande reste « sauvegarder » plutôt que « sauvegarder les thèmes », et la limite est écrite en toutes lettres à chaque exécution et dans le fichier sauvegarde.json lui-même. Une sauvegarde se retrouve dans deux ans, sur une autre machine, par quelqu’un d’autre : la phrase affichée au terminal aura disparu depuis longtemps.

sauvegarde.jsonjson
{
  "format": "webcosa-sauvegarde",
  "format_version": 1,
  "site": { "slug": "dubois", "nom": "Menuiserie Dubois" },
  "themes": [
    { "fichier": "themes/origo-11111111.json", "nom": "Origo", "role": "publie" }
  ],
  "absent_de_cette_sauvegarde": [
    "les pages et leurs sections",
    "les articles du blog",
    "les réglages du site (coordonnées, mentions légales, référencement)"
  ]
}

#site ouvrir

webcosa site ouvrir [--adresse=<url>]

Le site public, pas l’aperçu d’un thème — pour celui-là, c’est webcosa theme ouvrir. L’adresse est affichée avant d’être ouverte : sur une machine sans session graphique, elle reste lisible et copiable.

#La suite