Aller au contenu principal

Santé des dépendances

Santé des dépendances signale les paquets épinglés par vos dépôts qui ne sont pas vulnérables mais posent quand même problème. Un robot de mise à jour de versions ne les voit pas, car il suit un nom de paquet.

TypeCe que cela veut direD’où vient le signal
DéplacéLe projet a continué sous un autre paquet et celui que vous épinglez s’est arrêté. fremforge ne signale un déplacement que si un successeur est nommé (le remplacement de Renovate, un paquet du même dépôt source qui installe la même commande, ou le seul paquet de ce dépôt sur sa dernière version majeure) et que l’ancien paquet s’est arrêté : son dépôt en est à une version majeure que le paquet n’a jamais reçue, il n’a pas eu de version depuis 30 jours alors que le dépôt continuait, ou le dépôt est archivé. Un dépôt renommé ou redirigé n’est pas, à lui seul, un déplacementfremforge compare le paquet avec son dépôt source sur GitHub
ObsolèteLe registre marque le paquet comme obsolèteLe marquage et le message du registre
AbandonnéAucune version depuis 12 mois, et le projet montre qu’il s’est arrêté : son dépôt est archivé ou désactivé, n’a pas eu de commit depuis 24 mois, ou indique qu’il n’est plus maintenu, qu’il est obsolète ou qu’il cherche des mainteneursLes dates de version de Renovate hébergé, et le dépôt source sur GitHub
InactifAucune version depuis 12 mois, mais rien n’indique que le projet s’est arrêté (ou aucun dépôt source n’est connu). Pour information seulementLes dates de version de Renovate hébergé

Les résultats sont dans Sécurité › Résultats › Dépendances › Santé. Chacun dit en termes simples ce qui s’est passé, par exemple « Dernière version stable 1.19.5 le 28 oct. Le projet en est maintenant à 2.2.6, sous le nom @opencode/cli. ». Quand fremforge sait quel paquet l’a remplacé, le résultat le suggère avec sa commande d’installation. Ils figurent aussi sous le type Santé des dépendances dans Résultats › Tous.

La santé des dépendances nécessite aujourd’hui Renovate hébergé : les résultats n’apparaissent que pour les dépôts qui participent aux mises à jour de versions, car les vérifications tournent à chaque exécution des mises à jour de versions. Activez les mises à jour de versions pour un dépôt pour voir la santé de ses dépendances.

Les résultats Inactif sont seulement informatifs : ils ont leur propre filtre dans l’onglet Santé, ne comptent ni sous Tous ni dans Résultats › Tous, et ne sont jamais envoyés par e-mail, aux webhooks ou à votre SIEM.

Ignorer un résultat

Ignorez un résultat avec un motif, et éventuellement une date de fin, comme les autres résultats de dépendances. Si votre organisation exige une approbation, la demande passe par Exceptions. Un résultat ignoré revient à sa date de fin, et vous pouvez le rouvrir depuis Ignorés.

Notifications

Les résultats nouveaux et rouverts figurent dans le récapitulatif quotidien des alertes. L’E-mail sur la santé des dépendances est activé par défaut pour les organisations dont vous êtes propriétaire, et désactivé là où vous êtes membre. Il envoie un e-mail par organisation et par jour, à 07:00 heure de Copenhague et seulement s’il y a un résultat nouveau ou rouvert, et le récapitulatif quotidien y renvoie au lieu de le répéter. Pour ne plus le recevoir, suivez le lien en bas de l’un de ces e-mails, ou désactivez E-mail sur la santé des dépendances dans vos paramètres de notification : il reste alors désactivé pour toutes les organisations. Si vous l’activez à cet endroit, vous le recevez aussi pour les organisations dont vous êtes membre ; l’e-mail d’un membre donne le nombre de résultats, pas les résultats eux-mêmes.

Le délai d’abandon

12 mois par défaut. Pour un seul dépôt, définissez abandonmentThreshold dans son renovate.json, par exemple "abandonmentThreshold": "24 months". Avec null, la vérification y est désactivée. Un paquet au-delà du délai n’est abandonné qu’avec un second signal de son dépôt source (archivé ou désactivé, aucun commit sur la branche par défaut depuis 24 mois, ou une mention « non maintenu » dans sa description ou en haut de son README) ; sinon il est inactif. Une version plus récente dans le délai, quelle qu’elle soit, signifie qu’il n’est ni l’un ni l’autre. Quand le paquet publie une nouvelle version, fremforge lève un résultat « abandonné » ou « inactif » au plus tard une heure après avoir enregistré cette version.

Indiquer à fremforge d’où vient un paquet

Pour repérer un déplacement, fremforge doit connaître le dépôt source du paquet. Il cherche à trois endroits, dans cet ordre :

  1. les métadonnées du paquet dans le registre (pour npm, le champ repository) ;
  2. .fremforge/dependency-sources.json dans votre dépôt ;
  3. une entrée packageRules avec sourceUrl dans votre configuration Renovate, si la règle nomme le paquet tel quel dans matchPackageNames ou matchDepNames. fremforge lit le premier fichier de configuration JSON qu’il trouve sur la branche par défaut (renovate.json, .renovaterc.json, .renovaterc, ou renovate.json sous .github/, .gitea/ ou .forgejo/) ; une configuration .json5 n’est pas lue pour cela.

Certains paquets n’indiquent aucun dépôt. Listez-les dans .fremforge/dependency-sources.json sur la branche par défaut :

{
  "sources": [
    { "package": "opencode-ai", "ecosystem": "npm", "repo": "anomalyco/opencode" },
    { "package": "internal-tool", "repo": "https://github.com/example/internal-tool" }
  ]
}

package est le nom tel que votre manifeste l’épingle. ecosystem est facultatif ; utilisez-le quand le même nom existe dans deux registres (npm, pypi). repo est propriétaire/nom sur github.com, ou une URL github.com. fremforge lit le fichier à l’exécution suivante. Une entrée illisible est ignorée, les autres comptent toujours. Le fichier est lu jusqu’à 1 Mio et 1 000 entrées.

Les vérifications des déplacements et des abandons lisent le dépôt source sur github.com ; celle des déplacements couvre les paquets npm et PyPI. Quand un dépôt publie des tags plutôt que des versions GitHub, ou que sa version la plus récente a plus de 180 jours, son tag le plus récent compte comme sa dernière version. Chaque exécution vérifie au plus 40 paquets, d’abord ceux jamais vérifiés puis les moins récemment vérifiés, et un résultat est réutilisé pendant 7 jours ; les premières vérifications d’un grand dépôt s’étalent donc sur quelques exécutions. fremforge ne cherche le remplacement d’un paquet déplacé que sur npm. Pour un paquet obsolète, la suggestion vient des règles de remplacement de Renovate, qui couvrent aussi d’autres écosystèmes.