@ferrflow/doc 7.27.5 → 7.28.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -121,6 +121,42 @@ Plusieurs fichiers de config trouvés dans le répertoire.
121
121
 
122
122
  `ferrflow init` lancé alors qu'un fichier de config existe déjà.
123
123
 
124
+ ### E1018 : Chemin hors du dépôt
125
+
126
+ <span id="e1018"></span>
127
+
128
+ Un chemin de `versionedFiles` est absolu, ou sort de la racine du dépôt avec `..`. FerrFlow ne lit et n'écrit les fichiers de version qu'à l'intérieur du dépôt : écrivez le chemin relativement à la racine.
129
+
130
+ ### E1019 : Le pattern d'include ne trouve aucun fichier
131
+
132
+ <span id="e1019"></span>
133
+
134
+ Une entrée de `include` ne correspond à aucun fichier. Les patterns sont résolus depuis le répertoire du fichier de config racine. Corrigez le chemin ou supprimez le pattern.
135
+
136
+ ### E1020 : Fichier inclus invalide
137
+
138
+ <span id="e1020"></span>
139
+
140
+ Un fichier chargé via `include` ne décrit pas un package valide. Soit il déclare `workspace`, `include` ou `package`, qui n'ont leur place que dans la config racine, soit son contenu ne se désérialise pas en package. Un fichier inclus décrit un seul package, avec les mêmes clés qu'une entrée `package`.
141
+
142
+ ### E1021 : Package inclus hors du dépôt
143
+
144
+ <span id="e1021"></span>
145
+
146
+ Le `path` d'un package inclus pointe hors de la racine du dépôt. Dans un fichier inclus, `path` est relatif au répertoire de ce fichier, et vaut ce répertoire quand il est vide.
147
+
148
+ ### E1022 : Nom de package en double
149
+
150
+ <span id="e1022"></span>
151
+
152
+ Deux packages portent le même `name`, qu'ils viennent de la config racine ou d'un `include`. L'erreur indique les deux chemins. Renommez l'un des deux.
153
+
154
+ ### E1023 : Package sans chemin
155
+
156
+ <span id="e1023"></span>
157
+
158
+ Un package de la config racine n'a pas de `path`. Renseignez-le relativement à la racine du dépôt, ou déplacez le package dans son propre fichier listé sous `include`, où `path` vaut par défaut le répertoire de ce fichier.
159
+
124
160
  ### E1024 : Fichier versionne introuvable
125
161
 
126
162
  <span id="e1024"></span>
@@ -265,6 +301,39 @@ Le commit de release n'a pas pu être vérifié sur la branche distante.
265
301
 
266
302
  La branche distante n'a pas été trouvée après le push.
267
303
 
304
+ ### E2011 : Release déjà en cours
305
+
306
+ <span id="e2011"></span>
307
+
308
+ Un autre `ferrflow release` détient le verrou de release `.git/ferrflow.lock`, ou le fichier de verrou n'a pas pu être créé. Un verrou laissé par un processus mort sur la même machine est repris automatiquement, et celui d'une autre machine au bout de six heures. Le message affiche le contenu du verrou pour savoir qui le détient.
309
+
310
+ <aside class="ferr-aside ferr-aside--tip"><div class="ferr-aside__body"><p>Si aucune autre release ne tourne, supprimez le fichier de verrou ou relancez avec <code>--force-unlock</code>.</p>
311
+ </div></aside>
312
+
313
+ ### E2012 : Force-push de la branche de release échoué
314
+
315
+ <span id="e2012"></span>
316
+
317
+ FerrFlow n'a pas pu force-push la branche de la PR ou MR de release. Le message reprend la sortie de git. Vérifiez que le token peut pousser sur cette branche et qu'aucune règle de protection n'y interdit le force-push.
318
+
319
+ ### E2013 : Inspection de la branche de release impossible
320
+
321
+ <span id="e2013"></span>
322
+
323
+ Avant de réutiliser la branche de release, FerrFlow lance `git ls-remote`, `git fetch` et `git log` dessus pour vérifier qu'elle ne contient que ses propres commits. L'une de ces commandes a échoué. La release continue : FerrFlow affiche un avertissement et fait comme si la branche ne contenait que ses commits.
324
+
325
+ ### E2014 : Suppression du tag distant échouée
326
+
327
+ <span id="e2014"></span>
328
+
329
+ `ferrflow rollback` n'a pas pu supprimer avec `git push --delete` un tag poussé par l'exécution échouée. Un tag absent du remote, ou qui pointe désormais vers un autre commit, est ignoré. Vérifiez que le token peut supprimer des tags, puis relancez le rollback.
330
+
331
+ ### E2015 : Revert échoué
332
+
333
+ <span id="e2015"></span>
334
+
335
+ `ferrflow rollback` n'a pas pu faire `git revert` sur le commit de release, par exemple parce qu'il entre en conflit avec des changements plus récents. Terminez le revert à la main. FerrFlow ne pousse jamais le revert : poussez la branche vous-même après vérification.
336
+
268
337
  ### E2016 : Clone de shadow-release échoué
269
338
 
270
339
  <span id="e2016"></span>
@@ -282,11 +351,95 @@ L'API GitHub Releases a retourné une erreur.
282
351
  <aside class="ferr-aside ferr-aside--tip"><div class="ferr-aside__body"><p>Vérifiez que <code>GITHUB_TOKEN</code> a la permission <code>contents: write</code>.</p>
283
352
  </div></aside>
284
353
 
285
- ### E3002 to E3010 : Erreurs API GitHub
354
+ ### E3002 : Liste des releases échouée
286
355
 
287
356
  <span id="e3002"></span>
288
357
 
289
- Erreurs lors d'opérations sur l'API GitHub (releases, PR, auto-merge, GraphQL).
358
+ Impossible de récupérer les releases existantes depuis l'API GitHub.
359
+
360
+ ### E3003 : Réponse des releases illisible
361
+
362
+ <span id="e3003"></span>
363
+
364
+ L'API GitHub a renvoyé une réponse dans un format inattendu.
365
+
366
+ ### E3004 : Publication de release échouée
367
+
368
+ <span id="e3004"></span>
369
+
370
+ Impossible de publier (sortir du brouillon) une release GitHub.
371
+
372
+ ### E3005 : Création de pull request échouée
373
+
374
+ <span id="e3005"></span>
375
+
376
+ L'API GitHub a retourné une erreur à la création de la PR.
377
+
378
+ ### E3006 : Réponse de PR illisible
379
+
380
+ <span id="e3006"></span>
381
+
382
+ L'API GitHub a renvoyé une PR dans un format inattendu.
383
+
384
+ ### E3007 : Champ manquant dans la réponse de PR
385
+
386
+ <span id="e3007"></span>
387
+
388
+ La réponse de l'API GitHub pour la PR ne contient pas le champ `number` ou `node_id`.
389
+
390
+ ### E3008 : Activation de l'auto-merge échouée
391
+
392
+ <span id="e3008"></span>
393
+
394
+ Impossible d'activer l'auto-merge sur la PR de release via l'API GraphQL.
395
+
396
+ ### E3009 : Réponse GraphQL illisible
397
+
398
+ <span id="e3009"></span>
399
+
400
+ L'API GraphQL de GitHub a renvoyé une réponse inattendue.
401
+
402
+ ### E3010 : Auto-merge échoué
403
+
404
+ <span id="e3010"></span>
405
+
406
+ La mutation GraphQL qui active l'auto-merge a renvoyé une erreur.
407
+
408
+ ### E3011 : Recherche de la PR de release échouée
409
+
410
+ <span id="e3011"></span>
411
+
412
+ La liste des pull requests ouvertes n'a pas pu être récupérée pendant que FerrFlow cherchait une PR de release existante à mettre à jour. Vérifiez le token et l'accès à l'API GitHub.
413
+
414
+ ### E3012 : Mise à jour de la PR de release échouée
415
+
416
+ <span id="e3012"></span>
417
+
418
+ FerrFlow a trouvé la PR de release ouverte, mais GitHub a refusé la mise à jour de son titre et de sa description. Vérifiez que le token a `pull-requests: write`.
419
+
420
+ ### E3013 : Requête GraphQL échouée
421
+
422
+ <span id="e3013"></span>
423
+
424
+ Une requête vers l'API GraphQL de GitHub a échoué avant d'obtenir une réponse exploitable, sur le réseau ou avec un statut HTTP d'erreur. FerrFlow appelle cette API pour créer le commit de release avec `createCommitOnBranch` quand `FERRFLOW_BOT` est défini.
425
+
426
+ ### E3014 : Erreur GraphQL
427
+
428
+ <span id="e3014"></span>
429
+
430
+ L'API GraphQL de GitHub a répondu par une erreur, ou `createCommitOnBranch` n'a renvoyé aucun identifiant de commit. Le message reprend le texte de l'erreur GitHub.
431
+
432
+ ### E3015 : Déplacement de la branche de release échoué
433
+
434
+ <span id="e3015"></span>
435
+
436
+ Quand `FERRFLOW_BOT` est défini, FerrFlow fait pointer la branche de release sur la tête de la branche cible via l'API refs de GitHub avant d'y créer le commit. GitHub a refusé la mise à jour, ou la création de la ref quand la branche n'existait pas encore. Vérifiez que le token a `contents: write`.
437
+
438
+ ### E3016 : Suppression de release échouée
439
+
440
+ <span id="e3016"></span>
441
+
442
+ `ferrflow rollback` n'a pas pu supprimer une release GitHub créée par l'exécution échouée. Supprimez-la à la main et relancez le rollback.
290
443
 
291
444
  ## API GitLab
292
445
 
@@ -299,27 +452,465 @@ L'API GitLab Releases a retourné une erreur.
299
452
  <aside class="ferr-aside ferr-aside--tip"><div class="ferr-aside__body"><p>Vérifiez que le token CI a les accès API nécessaires.</p>
300
453
  </div></aside>
301
454
 
302
- ### E3102 to E3105 : Erreurs API GitLab
455
+ ### E3102 : Création de merge request échouée
303
456
 
304
457
  <span id="e3102"></span>
305
458
 
306
- Erreurs lors d'opérations sur l'API GitLab (releases, MR, merge).
459
+ L'API GitLab a retourné une erreur à la création de la MR.
460
+
461
+ ### E3103 : Réponse de MR illisible
462
+
463
+ <span id="e3103"></span>
464
+
465
+ L'API GitLab a renvoyé une MR dans un format inattendu.
466
+
467
+ ### E3104 : Champ iid manquant
468
+
469
+ <span id="e3104"></span>
470
+
471
+ La réponse de l'API GitLab pour la MR ne contient pas le champ `iid`.
472
+
473
+ ### E3105 : Merge de la MR échoué
474
+
475
+ <span id="e3105"></span>
476
+
477
+ Impossible de merger la MR de release via l'API GitLab.
478
+
479
+ ### E3106 : Recherche de la MR de release échouée
480
+
481
+ <span id="e3106"></span>
482
+
483
+ La liste des merge requests ouvertes n'a pas pu être récupérée pendant que FerrFlow cherchait une MR de release existante à mettre à jour. Vérifiez le token et l'accès à l'API GitLab.
484
+
485
+ ### E3107 : Mise à jour de la MR de release échouée
486
+
487
+ <span id="e3107"></span>
488
+
489
+ FerrFlow a trouvé la MR de release ouverte, mais GitLab a refusé la mise à jour de son titre et de sa description. Vérifiez les droits du token sur le projet.
490
+
491
+ ## API Gitea
492
+
493
+ ### E3201 : Création de release échouée
494
+
495
+ <span id="e3201"></span>
496
+
497
+ L'API Gitea Releases a retourné une erreur à la création d'une release. Vérifiez que le token peut écrire dans le dépôt.
498
+
499
+ ### E3202 : Liste des releases échouée
500
+
501
+ <span id="e3202"></span>
502
+
503
+ Impossible de lister les releases depuis l'API Gitea pour chercher un brouillon de release existant pour le tag.
504
+
505
+ ### E3203 : Publication de release échouée
506
+
507
+ <span id="e3203"></span>
508
+
509
+ Impossible de publier (sortir du brouillon) une release Gitea.
510
+
511
+ ## API Bitbucket
512
+
513
+ ### E3301 : Résolution du tag de release échouée
514
+
515
+ <span id="e3301"></span>
516
+
517
+ Bitbucket n'a pas de releases. Sur Bitbucket Cloud, FerrFlow interroge plutôt l'API sur le nouveau tag pour en obtenir le lien, et cette requête a échoué. Vérifiez que le token peut lire le dépôt et que le tag a bien été poussé.
307
518
 
308
519
  ## Fichiers de version
309
520
 
310
- Les erreurs E4xxx concernent la lecture, l'écriture et le parsing des fichiers de version :
521
+ Les erreurs E4xxx concernent la lecture, l'écriture et le parsing des fichiers de version. Chaque format a sa propre plage de codes. Les codes UTF-8 invalide viennent de `ferrflow validate`, qui lit les fichiers versionnés comme des octets bruts ; les autres commandes signalent un fichier qui n'est pas en UTF-8 avec l'erreur de lecture du format.
522
+
523
+ ### E4101 : Lecture du fichier TOML impossible
524
+
525
+ <span id="e4101"></span>
526
+
527
+ FerrFlow n'a pas pu lire le fichier de version TOML (`Cargo.toml`, `pyproject.toml`) sur le disque.
528
+
529
+ ### E4102 : Syntaxe TOML invalide
530
+
531
+ <span id="e4102"></span>
532
+
533
+ Le fichier de version TOML ne se parse pas. Le message indique où se trouve l'erreur.
534
+
535
+ ### E4103 : Aucune version dans le fichier TOML
536
+
537
+ <span id="e4103"></span>
538
+
539
+ Aucun des champs `package.version`, `workspace.package.version`, `project.version` ou `tool.poetry.version` n'est renseigné. Un `Cargo.toml` qui déclare `version.workspace = true` tombe aussi ici quand le même fichier n'a pas de `[workspace.package].version` : faites pointer le fichier versionné vers le `Cargo.toml` racine du workspace.
540
+
541
+ ### E4104 : Écriture du fichier TOML impossible
542
+
543
+ <span id="e4104"></span>
544
+
545
+ L'écriture de la nouvelle version dans le fichier de version TOML (`Cargo.toml`, `pyproject.toml`) a échoué.
546
+
547
+ ### E4105 : UTF-8 invalide dans le fichier TOML
548
+
549
+ <span id="e4105"></span>
550
+
551
+ Le contenu du fichier de version TOML (`Cargo.toml`, `pyproject.toml`) n'est pas de l'UTF-8 valide.
552
+
553
+ ### E4201 : Lecture du fichier JSON impossible
554
+
555
+ <span id="e4201"></span>
556
+
557
+ FerrFlow n'a pas pu lire le fichier de version JSON (`package.json`, `composer.json`) sur le disque. Le même code couvre le checkpoint de release `.git/ferrflow.checkpoint.json`.
558
+
559
+ ### E4202 : Syntaxe JSON invalide
560
+
561
+ <span id="e4202"></span>
562
+
563
+ Le fichier de version JSON ne se parse pas. FerrFlow lève aussi ce code quand le checkpoint de release `.git/ferrflow.checkpoint.json` est corrompu ou a été écrit par une autre version de FerrFlow : supprimez ce fichier pour repartir de zéro.
564
+
565
+ ### E4203 : Aucune version dans le fichier JSON
566
+
567
+ <span id="e4203"></span>
568
+
569
+ Le fichier JSON n'a pas de champ `version` au premier niveau.
570
+
571
+ ### E4204 : Écriture du fichier JSON impossible
572
+
573
+ <span id="e4204"></span>
574
+
575
+ L'écriture de la nouvelle version dans le fichier de version JSON (`package.json`, `composer.json`) a échoué. FerrFlow le lève aussi quand il ne peut pas enregistrer ou supprimer le checkpoint de release, ou réécrire le manifeste d'un package dépendant (`package.json` ou `Cargo.toml`) pour suivre une dépendance bumpée.
576
+
577
+ ### E4205 : UTF-8 invalide dans le fichier JSON
578
+
579
+ <span id="e4205"></span>
580
+
581
+ Le contenu du fichier de version JSON (`package.json`, `composer.json`) n'est pas de l'UTF-8 valide.
582
+
583
+ ### E4301 : Lecture de Chart.yaml (helm) impossible
584
+
585
+ <span id="e4301"></span>
586
+
587
+ FerrFlow n'a pas pu lire le `Chart.yaml` déclaré avec `format = "helm"` sur le disque.
588
+
589
+ ### E4302 : Aucune version dans Chart.yaml (helm)
590
+
591
+ <span id="e4302"></span>
592
+
593
+ Le `Chart.yaml` déclaré avec `format = "helm"` n'a pas de champ `version:` au premier niveau.
594
+
595
+ ### E4303 : Écriture de Chart.yaml (helm) impossible
596
+
597
+ <span id="e4303"></span>
598
+
599
+ L'écriture de la nouvelle version dans le `Chart.yaml` déclaré avec `format = "helm"` a échoué.
600
+
601
+ ### E4304 : UTF-8 invalide dans Chart.yaml (helm)
602
+
603
+ <span id="e4304"></span>
604
+
605
+ Le contenu du `Chart.yaml` déclaré avec `format = "helm"` n'est pas de l'UTF-8 valide.
606
+
607
+ ### E4401 : Lecture du fichier XML impossible
608
+
609
+ <span id="e4401"></span>
610
+
611
+ FerrFlow n'a pas pu lire le fichier de version XML (`pom.xml`) sur le disque.
612
+
613
+ ### E4402 : Aucune version dans le fichier XML
614
+
615
+ <span id="e4402"></span>
616
+
617
+ Le fichier XML n'a pas de balise `<version>`.
618
+
619
+ ### E4403 : Écriture du fichier XML impossible
620
+
621
+ <span id="e4403"></span>
622
+
623
+ L'écriture de la nouvelle version dans le fichier de version XML (`pom.xml`) a échoué.
624
+
625
+ ### E4404 : UTF-8 invalide dans le fichier XML
626
+
627
+ <span id="e4404"></span>
628
+
629
+ Le contenu du fichier de version XML (`pom.xml`) n'est pas de l'UTF-8 valide.
630
+
631
+ ### E4410 : Lecture du fichier .csproj impossible
311
632
 
312
- | Plage | Format |
313
- | -------------- | --------------------------------- |
314
- | E4101 to E4105 | TOML (Cargo.toml, pyproject.toml) |
315
- | E4201 to E4205 | JSON (package.json) |
316
- | E4301 to E4304 | Helm / YAML (Chart.yaml) |
317
- | E4401 to E4413 | XML / CSProj |
318
- | E4501 to E4504 | Gradle |
319
- | E4601 to E4603 | Go mod |
320
- | E4701 to E4704 | Texte (VERSION, VERSION.txt) |
633
+ <span id="e4410"></span>
321
634
 
322
- Erreurs courantes : lecture impossible, syntaxe invalide, champ `version` manquant, écriture impossible, UTF-8 invalide.
635
+ FerrFlow n'a pas pu lire le fichier `.csproj` sur le disque.
636
+
637
+ ### E4411 : Aucune version dans le fichier .csproj
638
+
639
+ <span id="e4411"></span>
640
+
641
+ Le fichier `.csproj` n'a pas d'élément `<Version>`.
642
+
643
+ ### E4412 : Écriture du fichier .csproj impossible
644
+
645
+ <span id="e4412"></span>
646
+
647
+ L'écriture de la nouvelle version dans le fichier `.csproj` a échoué.
648
+
649
+ ### E4413 : UTF-8 invalide dans le fichier .csproj
650
+
651
+ <span id="e4413"></span>
652
+
653
+ Le contenu du fichier `.csproj` n'est pas de l'UTF-8 valide.
654
+
655
+ ### E4501 : Lecture du fichier Gradle impossible
656
+
657
+ <span id="e4501"></span>
658
+
659
+ FerrFlow n'a pas pu lire le fichier de build Gradle (`build.gradle`, `build.gradle.kts`) sur le disque.
660
+
661
+ ### E4502 : Aucune version dans le fichier Gradle
662
+
663
+ <span id="e4502"></span>
664
+
665
+ Le fichier de build Gradle n'a pas d'affectation `version = "…"`.
666
+
667
+ ### E4503 : Écriture du fichier Gradle impossible
668
+
669
+ <span id="e4503"></span>
670
+
671
+ L'écriture de la nouvelle version dans le fichier de build Gradle (`build.gradle`, `build.gradle.kts`) a échoué.
672
+
673
+ ### E4504 : UTF-8 invalide dans le fichier Gradle
674
+
675
+ <span id="e4504"></span>
676
+
677
+ Le contenu du fichier de build Gradle (`build.gradle`, `build.gradle.kts`) n'est pas de l'UTF-8 valide.
678
+
679
+ ### E4601 : Impossible de lancer git describe
680
+
681
+ <span id="e4601"></span>
682
+
683
+ Un fichier versionné `gomod` tire sa version des tags git via `git describe`, et la commande n'a pas pu être lancée. Vérifiez que git est dans le `PATH`.
684
+
685
+ ### E4602 : Aucun tag de version
686
+
687
+ <span id="e4602"></span>
688
+
689
+ `git describe` n'a trouvé aucun tag correspondant à `*@v*` ou `v*` pour le package.
690
+
691
+ Depuis FerrFlow v3, le flux de release intercepte ce cas et repart de la version de départ de la stratégie (`0.0.0`, `0`, …) : la première release d'un dépôt neuf réussit sans tag créé à la main. Le code existe toujours pour les programmes qui utilisent `GoModVersionFile` directement, mais `ferrflow release` ne devrait plus l'afficher.
692
+
693
+ ### E4603 : Version illisible depuis go.mod
694
+
695
+ <span id="e4603"></span>
696
+
697
+ La version d'un module Go vient des tags git : FerrFlow ne peut pas la lire dans le contenu de `go.mod`. `ferrflow validate` ignore les entrées `gomod` avec un avertissement.
698
+
699
+ ### E4701 : Lecture du fichier texte impossible
700
+
701
+ <span id="e4701"></span>
702
+
703
+ FerrFlow n'a pas pu lire le fichier de version texte (`VERSION`, `VERSION.txt`) sur le disque.
704
+
705
+ ### E4702 : Aucune version dans le fichier texte
706
+
707
+ <span id="e4702"></span>
708
+
709
+ Le fichier texte est vide. Avec un `selector`, ce code couvre aussi une regex qui ne compile pas, qui n'a pas exactement un groupe de capture, qui ne trouve rien ou qui ne capture que des espaces.
710
+
711
+ ### E4703 : Écriture du fichier texte impossible
712
+
713
+ <span id="e4703"></span>
714
+
715
+ L'écriture de la nouvelle version dans le fichier de version texte (`VERSION`, `VERSION.txt`) a échoué.
716
+
717
+ ### E4704 : UTF-8 invalide dans le fichier texte
718
+
719
+ <span id="e4704"></span>
720
+
721
+ Le contenu du fichier de version texte (`VERSION`, `VERSION.txt`) n'est pas de l'UTF-8 valide.
722
+
723
+ ### E4801 : Lecture de pubspec.yaml impossible
724
+
725
+ <span id="e4801"></span>
726
+
727
+ FerrFlow n'a pas pu lire `pubspec.yaml` sur le disque.
728
+
729
+ ### E4802 : Aucune version dans pubspec.yaml
730
+
731
+ <span id="e4802"></span>
732
+
733
+ `pubspec.yaml` n'a pas de clé `version:` au premier niveau.
734
+
735
+ ### E4803 : Écriture de pubspec.yaml impossible
736
+
737
+ <span id="e4803"></span>
738
+
739
+ L'écriture de la nouvelle version dans `pubspec.yaml` a échoué.
740
+
741
+ ### E4804 : UTF-8 invalide dans pubspec.yaml
742
+
743
+ <span id="e4804"></span>
744
+
745
+ Le contenu de `pubspec.yaml` n'est pas de l'UTF-8 valide.
746
+
747
+ ### E4811 : Lecture de mix.exs impossible
748
+
749
+ <span id="e4811"></span>
750
+
751
+ FerrFlow n'a pas pu lire `mix.exs` sur le disque.
752
+
753
+ ### E4812 : Aucune version dans mix.exs
754
+
755
+ <span id="e4812"></span>
756
+
757
+ `mix.exs` ne contient pas de littéral `version: "…"`.
758
+
759
+ ### E4813 : Écriture de mix.exs impossible
760
+
761
+ <span id="e4813"></span>
762
+
763
+ L'écriture de la nouvelle version dans `mix.exs` a échoué.
764
+
765
+ ### E4814 : UTF-8 invalide dans mix.exs
766
+
767
+ <span id="e4814"></span>
768
+
769
+ Le contenu de `mix.exs` n'est pas de l'UTF-8 valide.
770
+
771
+ ### E4821 : Lecture de Chart.yaml (chartyaml) impossible
772
+
773
+ <span id="e4821"></span>
774
+
775
+ FerrFlow n'a pas pu lire le `Chart.yaml` déclaré avec `format = "chartyaml"` sur le disque.
776
+
777
+ ### E4822 : Aucune version dans Chart.yaml (chartyaml)
778
+
779
+ <span id="e4822"></span>
780
+
781
+ Le `Chart.yaml` déclaré avec `format = "chartyaml"` n'a pas de clé `version:` au premier niveau.
782
+
783
+ ### E4823 : Écriture de Chart.yaml (chartyaml) impossible
784
+
785
+ <span id="e4823"></span>
786
+
787
+ L'écriture de la nouvelle version dans le `Chart.yaml` déclaré avec `format = "chartyaml"` a échoué.
788
+
789
+ ### E4824 : UTF-8 invalide dans Chart.yaml (chartyaml)
790
+
791
+ <span id="e4824"></span>
792
+
793
+ Le contenu du `Chart.yaml` déclaré avec `format = "chartyaml"` n'est pas de l'UTF-8 valide.
794
+
795
+ ### E4831 : Lecture du fichier .gemspec impossible
796
+
797
+ <span id="e4831"></span>
798
+
799
+ FerrFlow n'a pas pu lire le fichier `.gemspec` sur le disque.
800
+
801
+ ### E4832 : Aucune version dans le fichier .gemspec
802
+
803
+ <span id="e4832"></span>
804
+
805
+ Le fichier `.gemspec` n'a pas d'affectation `<ident>.version = "…"`.
806
+
807
+ ### E4833 : Écriture du fichier .gemspec impossible
808
+
809
+ <span id="e4833"></span>
810
+
811
+ L'écriture de la nouvelle version dans le fichier `.gemspec` a échoué.
812
+
813
+ ### E4834 : UTF-8 invalide dans le fichier .gemspec
814
+
815
+ <span id="e4834"></span>
816
+
817
+ Le contenu du fichier `.gemspec` n'est pas de l'UTF-8 valide.
818
+
819
+ ### E4841 : Lecture de Package.swift impossible
820
+
821
+ <span id="e4841"></span>
822
+
823
+ FerrFlow n'a pas pu lire `Package.swift` sur le disque.
824
+
825
+ ### E4842 : Aucune version dans Package.swift
826
+
827
+ <span id="e4842"></span>
828
+
829
+ `Package.swift` n'a pas de déclaration `let <name>Version = "…"` au premier niveau.
830
+
831
+ ### E4843 : Écriture de Package.swift impossible
832
+
833
+ <span id="e4843"></span>
834
+
835
+ L'écriture de la nouvelle version dans `Package.swift` a échoué.
836
+
837
+ ### E4844 : UTF-8 invalide dans Package.swift
838
+
839
+ <span id="e4844"></span>
840
+
841
+ Le contenu de `Package.swift` n'est pas de l'UTF-8 valide.
842
+
843
+ ### E4851 : Lecture du fichier .cabal impossible
844
+
845
+ <span id="e4851"></span>
846
+
847
+ FerrFlow n'a pas pu lire le fichier `.cabal` sur le disque.
848
+
849
+ ### E4852 : Aucune version dans le fichier .cabal
850
+
851
+ <span id="e4852"></span>
852
+
853
+ Le fichier `.cabal` n'a pas de champ `version:` au premier niveau.
854
+
855
+ ### E4853 : Écriture du fichier .cabal impossible
856
+
857
+ <span id="e4853"></span>
858
+
859
+ L'écriture de la nouvelle version dans le fichier `.cabal` a échoué.
860
+
861
+ ### E4854 : UTF-8 invalide dans le fichier .cabal
862
+
863
+ <span id="e4854"></span>
864
+
865
+ Le contenu du fichier `.cabal` n'est pas de l'UTF-8 valide.
866
+
867
+ ### E4861 : Lecture de CMakeLists.txt impossible
868
+
869
+ <span id="e4861"></span>
870
+
871
+ FerrFlow n'a pas pu lire `CMakeLists.txt` sur le disque.
872
+
873
+ ### E4862 : Aucune version dans CMakeLists.txt
874
+
875
+ <span id="e4862"></span>
876
+
877
+ `CMakeLists.txt` n'a pas de déclaration `project(… VERSION …)`.
878
+
879
+ ### E4863 : Écriture de CMakeLists.txt impossible
880
+
881
+ <span id="e4863"></span>
882
+
883
+ L'écriture de la nouvelle version dans `CMakeLists.txt` a échoué.
884
+
885
+ ### E4864 : UTF-8 invalide dans CMakeLists.txt
886
+
887
+ <span id="e4864"></span>
888
+
889
+ Le contenu de `CMakeLists.txt` n'est pas de l'UTF-8 valide.
890
+
891
+ ### E4871 : Lecture de galaxy.yml impossible
892
+
893
+ <span id="e4871"></span>
894
+
895
+ FerrFlow n'a pas pu lire `galaxy.yml` sur le disque.
896
+
897
+ ### E4872 : Aucune version dans galaxy.yml
898
+
899
+ <span id="e4872"></span>
900
+
901
+ `galaxy.yml` n'a pas de clé `version:` au premier niveau.
902
+
903
+ ### E4873 : Écriture de galaxy.yml impossible
904
+
905
+ <span id="e4873"></span>
906
+
907
+ L'écriture de la nouvelle version dans `galaxy.yml` a échoué.
908
+
909
+ ### E4874 : UTF-8 invalide dans galaxy.yml
910
+
911
+ <span id="e4874"></span>
912
+
913
+ Le contenu de `galaxy.yml` n'est pas de l'UTF-8 valide.
323
914
 
324
915
  ## Pré-release
325
916
 
@@ -360,6 +951,23 @@ Un hook a échoué avec `on_failure: "abort"`.
360
951
  <aside class="ferr-aside ferr-aside--tip"><div class="ferr-aside__body"><p>Vérifiez la commande du hook, ou mettez <code>on_failure: &quot;continue&quot;</code>.</p>
361
952
  </div></aside>
362
953
 
954
+ ## Publishers
955
+
956
+ ### E6101 : Publisher mal configuré
957
+
958
+ <span id="e6101"></span>
959
+
960
+ Un publisher n'a pas pu démarrer parce que sa configuration est incomplète : un `registry` absent de `workspace.registries`, une variable `tokenEnv` non définie, un contexte de build, un chart ou un fichier d'asset introuvable, ou un `trustedPublishing` utilisé hors de GitHub Actions. Le message nomme le publisher et l'élément manquant. Rien n'a été publié.
961
+
962
+ ### E6102 : Publication échouée
963
+
964
+ <span id="e6102"></span>
965
+
966
+ L'étape de publication a tourné et a échoué : `cargo publish`, `npm publish`, `twine upload`, `docker buildx`, `helm push`, `gh release upload` ou un webhook a renvoyé une erreur. Le message reprend l'erreur de l'outil, avec les lignes qui en expliquent la cause. Pour cargo, FerrFlow réessaie quelques fois quand l'erreur ressemble à un retard d'index du registre juste après la publication d'une dépendance, et signale E6102 une fois les essais épuisés.
967
+
968
+ <aside class="ferr-aside ferr-aside--tip"><div class="ferr-aside__body"><p>Lancez la même commande à la main depuis le dossier du package, par exemple <code>cargo publish --dry-run</code>, pour voir la sortie complète.</p>
969
+ </div></aside>
970
+
363
971
  ## Query
364
972
 
365
973
  ### E7001 : Aucun package configuré
@@ -380,6 +988,24 @@ Le nom de package spécifié n'existe pas dans la config.
380
988
  <aside class="ferr-aside ferr-aside--tip"><div class="ferr-aside__body"><p>Lancez <code>ferrflow version</code> pour lister les packages.</p>
381
989
  </div></aside>
382
990
 
991
+ ### E7003 : Plage de diff invalide
992
+
993
+ <span id="e7003"></span>
994
+
995
+ `ferrflow diff` attend une plage de la forme `<from>..<to>`, avec deux bornes non vides, par exemple `v1.4.0..v1.6.0`.
996
+
997
+ ### E7004 : Nom de package requis
998
+
999
+ <span id="e7004"></span>
1000
+
1001
+ Le dépôt est un monorepo : `ferrflow diff` doit savoir quel package comparer, avec `ferrflow diff <package> <from>..<to>`.
1002
+
1003
+ ### E7005 : Borne de plage introuvable
1004
+
1005
+ <span id="e7005"></span>
1006
+
1007
+ Une borne de la plage de `ferrflow diff` ne correspond à aucun tag. FerrFlow essaie la valeur telle quelle, puis comme une version passée dans le modèle de tag du package, avec et sans `v` initial. Le message liste les noms essayés. Passez un nom de tag ou une version existants.
1008
+
383
1009
  ## Monorepo
384
1010
 
385
1011
  ### E8001 : Package introuvable dans la config
@@ -402,3 +1028,11 @@ Un tag flottant serait déplacé vers une version plus ancienne.
402
1028
  <span id="e8003"></span>
403
1029
 
404
1030
  Deux packages ou plus dépendent l'un de l'autre via `dependsOn`, directement ou transitivement : il n'existe aucun ordre de release possible. Le message nomme la boucle, par exemple `cycle detected: api → web → api`. Supprimez l'une des arêtes `dependsOn` pour la casser. La vérification s'exécute avant toute écriture de version, donc une configuration cyclique ne laisse jamais de release partielle.
1031
+
1032
+ ## Rollback
1033
+
1034
+ ### E10000 : Rollback bloqué
1035
+
1036
+ <span id="e10000"></span>
1037
+
1038
+ Chaque package de l'exécution échouée a publié sur un registre qui ne permet pas de dépublier : `ferrflow rollback` n'a rien qu'il puisse annuler. Le plan affiché indique chaque package bloqué et la raison.