Aller au contenu

Référence CLI

Cette page est l’index opérateur canonique des commandes et workflows documentés dans docs/cli.

Elle aide à choisir rapidement le bon outil sans recopier toute l’architecture Runtime, Pipeline ou Domain Core.

Exécution canonique

Depuis la racine du dépôt :

docker compose exec platform-worker wp --allow-root --path=/var/www/html ...

Ne pas utiliser un conteneur ou un chemin WordPress supposé. La posture opérationnelle courante est documentée dans ../operations/runtime-current-state.md.

Règle de sécurité

Avant d’exécuter une commande, déterminer sa classe :

  • lecture : aucune écriture persistante attendue ;
  • simulation : calcule un résultat sans mutation métier ;
  • écriture : modifie une projection, un état de run ou une donnée technique ;
  • sensible : peut toucher au schéma, aux snapshots, aux tables temporaires ou à plusieurs projections.

Le nom d’une commande ne suffit pas à prouver qu’elle est non destructive. La documentation de la commande et son implémentation restent la source de vérité.

Entrées principales

Vue générale

Comparaison et analyse

Simulation et patch virtuel

Dumps et revue manuelle

Validation

Documentation et outillage transverse

Choix rapide

Besoin Document
mesurer un écart sur des données réelles real-sample-comparison.md
regrouper les causes principales difference-family-audit.md
comprendre les statuts de résolution resolution-status-audit.md
simuler sans écrire simulation.md ou virtual-patch.md
examiner les cas individuellement candidate-dump.md ou virtual-candidates-dump.md
établir une conclusion opératoire validation-report.md
vérifier la qualité documentaire docs-check.md et docs-report.md

Media Quality

Media Quality suit une politique audit-first :

  • les évidences sont calculées et exposées ;
  • les diagnostics doivent être observables ;
  • la mutation est désactivée par défaut ;
  • aucune image ne doit être vidée comme simple conséquence d’un doute ;
  • un remplacement éventuel exige une preuve suffisante et une politique d’écriture explicite.

La source canonique est ../architecture/media-quality-engine.md.

Vérifier qu’une commande existe

Ne pas utiliser un simple grep sur la sortie brute de wp cli cmd-dump comme preuve de présence ou d’absence.

Préférer :

docker compose exec platform-worker wp --allow-root --path=/var/www/html help ccx

ou analyser le JSON complet de wp cli cmd-dump --format=json avec un parseur JSON.

Sorties attendues

Une commande opérateur doit fournir, selon son usage :

  • un code de retour explicite ;
  • un résumé lisible ;
  • des compteurs stables ;
  • les identifiants utiles (run_id, feed, batch, projection) ;
  • les erreurs et raisons de rejet ;
  • un format machine lorsqu’il est documenté.

Une commande d’écriture doit annoncer clairement ce qu’elle modifie.

Règle documentaire

Dans docs/cli :

  • documenter l’usage opérateur réel ;
  • indiquer la classe de sécurité de la commande ;
  • distinguer observation, simulation et mutation ;
  • renvoyer vers les documents canoniques plutôt que dupliquer l’architecture ;
  • retirer toute commande qui n’existe plus ou la signaler explicitement comme historique.

Invariants

  1. La CLI reste un adapter mince.
  2. La logique métier vit dans les services applicatifs ou le Domain Core.
  3. Une lecture ne doit pas charger le Pipeline complet sans nécessité.
  4. Une mutation doit être explicite, traçable et idempotente lorsque le cas le permet.
  5. La documentation ne doit jamais présenter une commande comme sûre sans preuve dans le code.

Voir aussi