Parcourir la documentation
update-policy
Afficher ou fixer la politique du projet qui décide si BMAD+ cherche des mises à jour et si certaines peuvent s’appliquer sans vous : modes off, notify, auto, canal, plage, préversions, erreurs.
La politique de mise à jour est un petit fichier de votre projet qui dit ce que BMAD+ peut faire face aux nouvelles versions. Par défaut, il vous prévient et attend. Vous pouvez couper les recherches, ou autoriser des mises à jour automatiques dans une plage de versions de votre choix : c’est ainsi qu’une équipe laisse avancer une série de correctifs de confiance tout en gardant un humain aux commandes pour le reste. update-policy affiche la politique et, avec des options, la réécrit. Elle ne vérifie ni n’installe rien elle-même.
Synopsis
npx bmad-plus update-policy [-d <path>] [--mode <off|notify|auto>] [--range <semver-range>] [--channel <tag>] [--allow-prerelease | --stable-only] [--json]| Option | Argument | Ce qu’elle fait |
|---|---|---|
-d, --directory <path> | dossier | Projet (par défaut : dossier courant). |
--mode <mode> | off, notify, auto | off : ne jamais contacter npm. notify : vérifier et rapporter, un humain applique. auto : autoriser des mises à jour automatiques dans --range. auto exige --range. |
--range <range> | plage semver | Les versions que les mises à jour automatiques peuvent atteindre, par exemple ^0.23.0. Doit être une plage semver valide. |
--channel <tag> | étiquette npm | L’étiquette de publication npm à suivre. Par défaut latest. Lettres minuscules, chiffres, - et _, en commençant par une lettre, 32 caractères au plus. |
--allow-prerelease | - | Autoriser les préversions comme cibles. |
--stable-only | - | Interdire les préversions (le défaut). Incompatible avec --allow-prerelease. |
--json | - | Afficher {"policy": {...}, "changed": true|false} ; les erreurs affichent {"error": "..."}. |
Le fichier de politique
La politique vit dans _bmad/update-policy.json. Sans fichier, le défaut s’applique : mode notify, canal latest, pas de plage, pas de préversion, registre https://registry.npmjs.org/. Le registre n’est pas configurable : toute autre valeur rend la politique invalide, si bien que les mises à jour ne peuvent pas être redirigées vers une autre source. Les clés inconnues sont refusées. Le fichier est écrit de façon atomique et jamais à travers un lien.
{
"schemaVersion": 1,
"mode": "auto",
"channel": "latest",
"allowedRange": "~0.23.0",
"allowPrerelease": false,
"registry": "https://registry.npmjs.org/"
}| Mode | update-check | update --latest |
|---|---|---|
off | Ne contacte pas npm : statut off. | Refusée : updates-disabled. |
notify (défaut) | Vérifie et rapporte ; la raison est approval-required. | Seulement avec --yes. --auto est refusé. |
auto | Rapporte ready-for-authorized-update quand la cible est dans la plage et que les fichiers sont inchangés. | Avec --yes, ou avec --auto pour une cible dans la plage ; --auto exige aussi un inventaire de propriété complet et aucun conflit. |
Codes de sortie
| Code | Signification |
|---|---|
| 0 | Politique affichée ou enregistrée. |
| 1 | Combinaison d’options invalide, politique invalide ou fichier de politique illisible. Le message va sur le flux d’erreur (ou dans le champ JSON error). |
Sortie
La sortie tient en une ligne : Update policy saved: ... quand vous avez changé quelque chose, Update policy: ... quand vous avez seulement regardé. Les transcriptions sont composées à partir du modèle du code et signalées comme simulées.
npx bmad-plus update-policy
Update policy: notify; channel=latest; range=none; prereleases=false
npx bmad-plus update-policy --mode auto --range "~0.23.0"
Update policy saved: auto; channel=latest; range=~0.23.0; prereleases=falsenpx bmad-plus update-policy
npx bmad-plus update-policy --mode auto --range "~0.23.0"Erreurs et que faire
| Message | Cause | Que faire |
|---|---|---|
Choose --allow-prerelease or --stable-only. | Les deux options sont données. | N’en gardez qu’une. |
--mode auto requires an explicit --range. | auto sans plage. | Ajoutez --range "<semver range>". |
Invalid update policy: check mode, channel, range, prerelease flag and official registry. | Une valeur est hors limites : mode, nom de canal, syntaxe de plage, ou registre autre que celui de npm. | Corrigez la valeur. Le registre ne peut pas être changé. |
Automatic updates require an explicit allowedRange. | Le fichier dit auto sans allowedRange. | Fixez une plage, ou changez le mode. |
Update policy is unreadable or invalid: ... | Le fichier existant n’est pas du JSON valide ou échoue à la validation. | Corrigez ou supprimez _bmad/update-policy.json, puis fixez de nouveau la politique. |
Exemples
npx bmad-plus update-policy --mode offnpx bmad-plus update-policy --mode notifyVoir aussi
- update-check update-check
- update update
- Tout le cycle de vie Installer, mettre à jour, désinstaller