update-check

update-check vous dit où en est votre projet par rapport à la dernière version publiée. Elle compare trois choses : la version installée dans le projet, celle du paquet que vous lancez et la plus récente sur votre canal de mise à jour. Elle ne fait que rapporter. Rien n’est téléchargé, installé ni écrit, sauf un petit fichier de cache. Les assistants la lancent une fois par session parce que les fichiers d’instructions générés le leur demandent.

Synopsis#

npx bmad-plus update-check [-d <path>] [--refresh] [--offline] [--json]

Ce qu’elle lit et écrit#

• Lit _bmad/.bmad-plus-install.json (version installée), _bmad/update-policy.json (mode, canal, plage) et, pour le verdict de disponibilité, l’inventaire de propriété.
• Ne contacte npm que si le mode de la politique n’est pas off, que vous n’êtes pas en --offline et qu’il n’y a pas de cache frais. La recherche lance npm view bmad-plus@<channel> version engines --json sur le registre officiel https://registry.npmjs.org/, avec 4 secondes de délai, sans nouvel essai et un plafond de 6 secondes.
• Écrit .bmad/update-check.json : la version vue et quand (valable 24 heures), ou l’heure du dernier échec (elle attend alors une heure avant de redemander, sauf --refresh).
• C’est la seule commande BMAD+ qui existe pour interroger npm (update --latest interroge aussi npm, puis télécharge la cible via npm exec). Pour couper complètement ces recherches : update-policy --mode off.

Statuts et raisons#

La sortie texte tient en deux lignes. La première est Installed: <v>; running: <v>; channel <name>: <target>, avec unknown pour une valeur absente. La seconde est <status>: <reason>, suivie de (cached result is stale) quand la cible vient d’un cache expiré.

Quand le statut est update-available, la raison explique ce qui sépare de la mise à jour. ready-for-authorized-update signifie que la politique l’autorise et que les fichiers sont inchangés : canAutoApply est vrai. Autres raisons : approval-required (le mode est notify, donc un humain doit approuver), outside-allowed-range, prerelease-not-allowed, incompatible-node-version, Complete file ownership inventory is required. (installation ancienne), Local changes or an active update require manual review., ownership-readiness-failed.

La ligne JSON porte : schemaVersion, installedVersion, runningVersion, latestVersion (seulement sur le canal latest), targetVersion, channel, status, checkedAt, source (registry, cache, stale-cache ou none), stale, updateAvailable, releaseEligible, versionEligible, canAutoApply, engineCompatible, engines et reason.

Codes de sortie#

Sortie#

Les recettes d’acceptation n’ont pas exercé cette commande ; ces transcriptions sont donc composées à partir des modèles de sortie du code (les versions sont des marqueurs) et signalées comme simulées.

$ npx bmad-plus update-check
Installed: <old>; running: <old>; channel latest: <new>
update-available: approval-required

$ npx bmad-plus update-check --offline --json
{"schemaVersion":1,"installedVersion":"<old>","runningVersion":"<old>","latestVersion":null,"targetVersion":null,"channel":"latest","status":"unknown","checkedAt":null,"source":"none","stale":false,"updateAvailable":null,"releaseEligible":false,"versionEligible":false,"canAutoApply":false,"engineCompatible":null,"engines":{},"reason":"offline"}
# Code de sortie 0. Un assistant y voit « poursuivre la tâche » et ne prétend jamais que la version est à jour.

Erreurs et que faire#

Exemples#

npx bmad-plus update-check --json --refresh