Zum Hauptinhalt springen

Zustand der Abhängigkeiten

Zustand der Abhängigkeiten meldet Pakete, die deine Repositories festpinnen und die keine Schwachstelle sind, aber trotzdem ein Problem. Ein Bot für Versionsupdates sieht sie nicht, weil er einem Paketnamen folgt.

ArtWas es bedeutetWoher das Signal kommt
UmgezogenDas Projekt ging unter einem anderen Paket weiter, während das gepinnte stehen blieb. fremforge meldet einen Umzug nur, wenn ein Nachfolger benannt ist (der Ersatz von Renovate, ein Paket aus demselben Quell-Repository, das denselben Befehl installiert, oder das einzige Paket dieses Repositorys auf seiner neuesten Hauptversion) und das alte Paket aufgehört hat: Sein Repository ist auf einer Hauptversion, die das Paket nie bekam, es hatte seit 30 Tagen kein Release, während das Repository weiter veröffentlichte, oder das Repository ist archiviert. Ein umbenanntes oder umgeleitetes Repository allein ist kein Umzugfremforge vergleicht das Paket mit seinem Quell-Repository auf GitHub
VeraltetDie Registry markiert das Paket als veraltetDie Markierung und Meldung der Registry
VerwaistSeit 12 Monaten kein Release, und das Projekt zeigt, dass es aufgehört hat: Sein Repository ist archiviert oder deaktiviert, hatte seit 24 Monaten keinen Commit oder sagt, dass es nicht mehr gepflegt wird, veraltet ist oder Maintainer suchtDie Release-Daten des gehosteten Renovate und das Quell-Repository auf GitHub
RuhendSeit 12 Monaten kein Release, aber nichts deutet darauf hin, dass das Projekt aufgehört hat (oder es gibt kein Quell-Repository zu prüfen). Nur ein HinweisDie Release-Daten des gehosteten Renovate

Die Befunde stehen unter Sicherheit › Befunde › Abhängigkeiten › Zustand. Jeder sagt in einfachen Worten, was passiert ist, zum Beispiel „Letztes stabiles Release 1.19.5 am 28. Okt. Das Projekt ist jetzt bei 2.2.6, unter dem Namen @opencode/cli.“. Erkennt fremforge, welches Paket es abgelöst hat, schlägt der Befund dieses Paket mit dem Installationsbefehl vor. Unter Befunde › Alle stehen sie beim Typ Zustand der Abhängigkeiten.

Der Zustand der Abhängigkeiten braucht derzeit das gehostete Renovate: Befunde erscheinen nur für Repositories, die an den Versionsupdates teilnehmen, weil die Prüfungen bei jedem Lauf der Versionsupdates laufen. Schalte die Versionsupdates für ein Repository ein, um den Zustand seiner Abhängigkeiten zu sehen.

Ruhende Befunde sind nur Hinweise: Sie haben einen eigenen Filter im Tab „Zustand“, zählen nicht unter Alle oder in Befunde › Alle und werden nie per E-Mail, an Webhooks oder an dein SIEM gesendet.

Einen Befund verwerfen

Verwirf einen Befund mit Begründung und optional einem Enddatum, wie andere Befunde zu Abhängigkeiten. Verlangt deine Organisation eine Freigabe für Verwerfungen, geht sie an Ausnahmen. Ein verworfener Befund ist wieder offen, sobald sein Enddatum verstreicht, und du kannst ihn unter Verworfen wieder öffnen.

Benachrichtigungen

Neue und wieder offene Befunde erscheinen in der täglichen Warnungszusammenfassung. Die E-Mail zum Zustand der Abhängigkeiten ist für die Organisationen, die dir gehören, standardmäßig eingeschaltet und aus, wo du Mitglied bist. Du bekommst eine E-Mail pro Organisation und Tag, um 07:00 Uhr Kopenhagener Zeit und nur, wenn es einen neuen oder wieder offenen Befund gibt, und die Tageszusammenfassung verweist darauf, statt sie zu wiederholen. Willst du sie nicht, folge dem Link am Ende einer dieser E-Mails oder schalte E-Mail zum Zustand der Abhängigkeiten in deinen Benachrichtigungseinstellungen aus: Dann bleibt sie für jede Organisation aus. Schaltest du sie dort ein, bekommst du sie auch für die Organisationen, in denen du Mitglied bist; die E-Mail an ein Mitglied nennt die Zahl der Befunde, nicht die Befunde selbst.

Die Schwelle für verwaiste Pakete

Standardmäßig 12 Monate. Für ein einzelnes Repository setzt du abandonmentThreshold in seiner renovate.json, zum Beispiel "abandonmentThreshold": "24 months". Mit null schaltest du die Prüfung dort aus. Ein Paket über der Schwelle ist nur dann verwaist, wenn sein Quell-Repository ein zweites Signal gibt (archiviert oder deaktiviert, seit 24 Monaten kein Commit auf dem Standardbranch oder ein Hinweis in der Beschreibung oder oben in der README, dass es nicht mehr gepflegt wird); sonst ist es ruhend. Ein neueres Release innerhalb der Schwelle, gleich welcher Version, heißt, dass das Paket keines von beidem ist. Veröffentlicht das Paket ein neues Release, entfernt fremforge einen Befund „verwaist“ oder „ruhend“ spätestens eine Stunde, nachdem es dieses Release erfasst hat.

fremforge sagen, woher ein Paket kommt

Um einen Umzug zu erkennen, braucht fremforge das Quell-Repository des Pakets. Es sucht an drei Stellen, in dieser Reihenfolge:

  1. in den Registry-Metadaten des Pakets (bei npm das Feld repository);
  2. in .fremforge/dependency-sources.json in deinem Repository;
  3. in einem packageRules-Eintrag mit sourceUrl in deiner Renovate-Konfiguration, wenn die Regel das Paket wörtlich in matchPackageNames oder matchDepNames nennt. fremforge liest die erste JSON-Konfigurationsdatei, die es auf dem Standard-Branch findet (renovate.json, .renovaterc.json, .renovaterc oder renovate.json unter .github/, .gitea/ oder .forgejo/); eine .json5-Konfiguration wird dafür nicht gelesen.

Manche Pakete nennen gar kein Repository. Trag sie in .fremforge/dependency-sources.json auf dem Standardbranch ein:

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

package ist der Name, wie dein Manifest ihn pinnt. ecosystem ist optional; nutze es, wenn derselbe Name in zwei Registries existiert (npm, pypi). repo ist owner/name auf github.com oder eine github.com-URL. fremforge liest die Datei beim nächsten Lauf. Ein Eintrag, der sich nicht lesen lässt, wird übersprungen; der Rest zählt trotzdem. Die Datei wird bis 1 MiB und 1.000 Einträge gelesen.

Die Prüfungen auf Umzug und verwaiste Pakete lesen das Quell-Repository auf github.com; die Umzugsprüfung deckt npm- und PyPI-Pakete ab. Veröffentlicht ein Repository Tags statt GitHub-Releases, oder ist sein neuestes Release älter als 180 Tage, zählt sein neuester Tag als neueste Version. Jeder Lauf prüft höchstens 40 Pakete, zuerst die nie geprüften und die am längsten nicht geprüften, und ein Ergebnis wird 7 Tage lang wiederverwendet; die ersten Prüfungen eines großen Repositorys verteilen sich also auf mehrere Läufe. Den Ersatz eines umgezogenen Pakets sucht fremforge nur auf npm. Für ein veraltetes Paket kommt der Vorschlag aus den Ersetzungsregeln von Renovate, die auch andere Ökosysteme abdecken.