@ferrflow/doc 7.28.5 → 7.29.0

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.
@@ -692,6 +692,12 @@
692
692
  "continue"
693
693
  ],
694
694
  "default": "abort"
695
+ },
696
+ "timeout": {
697
+ "type": "integer",
698
+ "minimum": 1,
699
+ "description": "Seconds a hook may run before FerrFlow kills it and its child processes, then applies onFailure. Defaults to 900 (15 minutes).",
700
+ "default": 900
695
701
  }
696
702
  },
697
703
  "additionalProperties": false
@@ -1167,6 +1167,12 @@
1167
1167
  "continue"
1168
1168
  ],
1169
1169
  "default": "abort"
1170
+ },
1171
+ "timeout": {
1172
+ "type": "integer",
1173
+ "minimum": 1,
1174
+ "description": "Seconds a hook may run before FerrFlow kills it and its child processes, then applies onFailure. Defaults to 900 (15 minutes).",
1175
+ "default": 900
1170
1176
  }
1171
1177
  },
1172
1178
  "additionalProperties": false
@@ -778,6 +778,7 @@ on_failure = "abort"
778
778
  | `onSuccess` | string | — | Run once after the whole release completes cleanly |
779
779
  | `onError` | string | — | Run once when the release fails; sets `FERRFLOW_ERROR_CODE` (once per run) |
780
780
  | `onFailure` | string | `"abort"` | Strategy — `"abort"` cancels the release on hook failure, `"continue"` prints a warning |
781
+ | `timeout` | number | `900` | Seconds a hook may run before it is killed and `onFailure` applies |
781
782
 
782
783
  ### Environment variables
783
784
 
@@ -807,6 +808,8 @@ For the once-per-run hooks (`preRelease`, `onSuccess`, `onError`) the per-packag
807
808
 
808
809
  `onFailure` is the failure **strategy** (`abort` / `continue`), not a command. The command that runs _when_ a release fails is `onError`, which receives the failing `FERRFLOW_ERROR_CODE`.
809
810
 
811
+ Hooks run with stdin closed, so a command that would prompt (`npm login`, a `gpg` passphrase, a git credential prompt) fails at once instead of waiting forever. A hook still running after `timeout` seconds is killed along with any process it started, and counts as a failed hook: `abort` stops the release, `continue` warns and moves on. Every minute a long hook prints that it is still running. Set `timeout` per package to override the workspace value. On Linux and macOS a hook runs in its own process group so it can be killed with everything it started, which also means a Ctrl+C on an interactive `ferrflow release` stops FerrFlow but not a hook that is already running, and since the timeout is enforced by FerrFlow itself, that hook then runs until it finishes on its own.
812
+
810
813
  ### Per-package hooks
811
814
 
812
815
  Package-level hooks **replace** workspace-level hooks for that package (they are not merged).
@@ -637,6 +637,7 @@ on_failure = "abort"
637
637
  | `onSuccess` | string | — | Exécuté une fois après une release entièrement réussie |
638
638
  | `onError` | string | — | Exécuté une fois quand la release échoue ; définit `FERRFLOW_ERROR_CODE` (une fois) |
639
639
  | `onFailure` | string | `"abort"` | Stratégie — `"abort"` annule la release en cas d'échec de hook, `"continue"` affiche un avertissement |
640
+ | `timeout` | number | `900` | Secondes qu'un hook peut tourner avant d'être tué et que `onFailure` s'applique |
640
641
 
641
642
  ### Variables d'environnement
642
643
 
@@ -666,6 +667,8 @@ Pour les hooks exécutés une seule fois par run (`preRelease`, `onSuccess`, `on
666
667
 
667
668
  `onFailure` est la **stratégie** d'échec (`abort` / `continue`), pas une commande. La commande exécutée _quand_ une release échoue est `onError`, qui reçoit le `FERRFLOW_ERROR_CODE` fautif.
668
669
 
670
+ Les hooks s'exécutent avec stdin fermé : une commande qui poserait une question (`npm login`, une passphrase `gpg`, une demande d'identifiants git) échoue tout de suite au lieu d'attendre indéfiniment. Un hook encore en cours après `timeout` secondes est tué avec les processus qu'il a lancés, et compte comme un hook en échec : `abort` arrête la release, `continue` affiche un avertissement et poursuit. Chaque minute, un hook long indique qu'il tourne toujours. `timeout` défini sur un package remplace la valeur du workspace. Sous Linux et macOS, un hook tourne dans son propre groupe de processus pour pouvoir être tué avec tout ce qu'il a lancé : un Ctrl+C sur un `ferrflow release` interactif arrête donc FerrFlow mais pas un hook déjà en cours, et comme le timeout est appliqué par FerrFlow lui-même, ce hook tourne alors jusqu'à ce qu'il se termine de lui-même.
671
+
669
672
  ### Hooks par package
670
673
 
671
674
  Les hooks au niveau du package **remplacent** les hooks du workspace pour ce package (ils ne sont pas fusionnés).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ferrflow/doc",
3
- "version": "7.28.5",
3
+ "version": "7.29.0",
4
4
  "description": "Documentation for FerrFlow, the universal semantic versioning CLI. Rendered at ferrflow.com/docs.",
5
5
  "license": "MIT",
6
6
  "repository": {