German-language working spec; README is authoritative for users. This document records what was decided and why, in German, for whoever develops cradle. Anything a user needs is in the English
README.md; where the two appear to differ about a user-visible promise, the README is the one that was published.
Verbindliche Referenz für die Entwicklung. Enthält die ursprüngliche Spezifikation des Maintainers, die daran vorgenommenen fachlichen Korrekturen und die getroffenen Designentscheidungen. Bei Widerspruch gilt dieses Dokument.
- npm-Paket:
cradle-cli - Binary:
cradle - Repo:
github.com/P-hinn/cradle-cli - Lizenz: Apache-2.0
- Stand: 26.09.2026 (Abschnitte 1–12 bis 0.1.3; 13–19 danach)
Der EU Cyber Resilience Act (Verordnung (EU) 2024/2847) verpflichtet Hersteller von Produkten mit digitalen Elementen dazu, ihre Komponenten zu dokumentieren und Schwachstellen zu behandeln. Für Container-Images gibt es dafür gutes Tooling (Syft, Grype, Trivy). Für reine npm-/TypeScript-Projekte ist die Lage schlechter: vorhandene Werkzeuge sind container-orientiert oder erzeugen ein SBOM, ohne bei dem zu helfen, was Teams tatsächlich brauchen — einer wiederholbaren, im CI verankerten Routine plus lesbarer Dokumentation für Audits.
cradle füllt diese Lücke. Der Anspruch ist ausdrücklich nicht, die technisch
vollständigste SBOM-Engine zu bauen, sondern die angenehmste Bedienung für
Node-Teams: ein Befehl, ein sinnvoller Default, ein Report, den man einem Auditor
oder Kunden schicken kann.
Zielgruppe: Entwicklungsteams in EU-Unternehmen, die Software kommerziell ausliefern und in den nächsten Monaten CRA-Nachweise brauchen werden.
Ehrliche Wettbewerbsthese: @cyclonedx/cyclonedx-npm (v6, aktiv gepflegt)
erzeugt bereits saubere CycloneDX-SBOMs aus npm-Projekten. SBOM-Erzeugung ist
Tischeinsatz, kein Alleinstellungsmerkmal. Unser Unterschied ist alles, was danach
kommt: Findings mit Pfad im Abhängigkeitsbaum, VEX-Unterdrückung, Baseline-Diffing,
CRA-Readiness-Checkliste und der HTML-Report.
Bei jeder Designentscheidung in dieser Reihenfolge:
- Ein Befehl muss reichen.
npx cradle-cliohne jede Konfiguration muss in einem beliebigen npm-Projekt etwas Nützliches produzieren. Konfiguration ist optional und additiv, nie Voraussetzung. - Ausgabe vor Features. Der HTML-Report ist das Produkt. Wenn eine Funktion den Report nicht besser macht, kommt sie später.
- Keine Lügen über Rechtssicherheit. Wir helfen bei Dokumentation und Prozess. Wir zertifizieren nichts. Nirgends im Produkt steht „CRA-konform".
- Offline-fähig, wo möglich. SBOM-Erzeugung darf keinen Netzzugriff brauchen. Nur die Schwachstellenabfrage geht raus, und die ist abschaltbar.
- Keine Telemetrie. Nie. Das ist ein Verkaufsargument, kein Verzicht.
Alle Angaben gegen den Verordnungstext geprüft. Quellen am Ende des Dokuments.
| Datum | Was |
|---|---|
| 10.12.2024 | Inkrafttreten |
| 11.06.2026 | Kapitel IV (Art. 35–51): Notifizierung von Konformitätsbewertungsstellen |
| 11.09.2026 | Art. 14: Meldepflichten |
| 11.12.2027 | Volle Anwendung |
Für aktiv ausgenutzte Schwachstellen und schwerwiegende Sicherheitsvorfälle:
- Frühwarnung binnen 24 Stunden ab Kenntnisnahme
- Schwachstellenmeldung binnen 72 Stunden ab Kenntnisnahme
- Abschlussbericht binnen 14 Tagen — ab Verfügbarkeit einer Abhilfe- oder Minderungsmaßnahme, nicht ab Kenntnisnahme (bei Vorfällen: 1 Monat)
Korrektur (siehe §18): Die frühere Fassung dieses Abschnitts schrieb „Abschlussbericht binnen 14 Tagen" ohne den Anknüpfungspunkt. Art. 14 Abs. 2 Buchst. c knüpft die Frist an die Verfügbarkeit der Maßnahme; die Kommission bestätigt das ausdrücklich. Der Unterschied ist erheblich — in beide Richtungen — und eine Meldevorlage darf ihn nicht verwischen.
Meldeweg: ENISA Single Reporting Platform plus das zuständige nationale CSIRT. Formulierungen wie „24-Stunden-Meldepflicht an ENISA" sind verkürzt und gehören nicht ins README.
Verlangt wird eine SBOM „in einem gängigen maschinenlesbaren Format, die zumindest die Abhängigkeiten der obersten Ebene erfasst".
Daraus folgt:
- Transitive Abhängigkeiten sind rechtlich nicht Pflicht. Wir erfassen sie trotzdem, weil Schwachstellentriage unter 24-Stunden-Druck ohne sie nicht funktioniert. Das ist unser Argument, nicht das des Gesetzgebers.
- Kein Format ist namentlich vorgeschrieben. CycloneDX und SPDX erfüllen beide „gängig und maschinenlesbar".
- Die SBOM ist Teil der technischen Dokumentation (Anhang VII), 10 Jahre aufzubewahren, Marktüberwachungsbehörden auf Anfrage vorzulegen.
- Es gibt keine Veröffentlichungspflicht.
- Abs. 8: Der Support-Zeitraum bemisst sich an der erwarteten Nutzungsdauer und beträgt mindestens fünf Jahre; kürzer nur, wenn die erwartete Nutzungsdauer kürzer ist.
- Abs. 9: Sicherheitsupdates müssen nach ihrer Bereitstellung mindestens 10 Jahre verfügbar bleiben, oder für den Rest des Support-Zeitraums, je nachdem, was länger ist.
- Abs. 13: Technische Dokumentation 10 Jahre aufbewahren, oder für den Support-Zeitraum, je nachdem, was länger ist.
Der CRA gilt für Produkte mit digitalen Elementen, die auf dem EU-Markt bereitgestellt werden. Open-Source-Entwicklung außerhalb einer kommerziellen Tätigkeit fällt weitgehend nicht darunter; „Open-Source-Software-Verwalter" (Art. 24) haben abgeschwächte Pflichten. Das README muss das sagen, damit sich niemand adressiert fühlt, der es nicht ist.
| Thema | Entscheidung |
|---|---|
| npm-Paket / Binary | cradle-cli / cradle (cradle ist auf npm belegt) |
| Monorepo | Root-package.json wird metadata.component; Workspaces erscheinen als direkte Komponenten. Ein Report pro Repo als Default, --workspace für einen Report pro Paket — ausformuliert in §16. |
| Lizenzquelle | node_modules von der Platte lesen; fehlt es, wird die Lizenz ehrlich als unbekannt gemeldet und im Readiness-Check als offener Punkt geführt. Kein automatischer Netzzugriff. |
| CycloneDX-Version | 1.6 als Default (maximale Kompatibilität), --spec-version 1.7 als Flag |
| Serialisierung | Selbst gebaut. Das offizielle JSON-Schema liegt unter schema/ und jeder SBOM-Test validiert dagegen. |
| Baseline vs. VEX | Streng getrennt (siehe 6.4) |
| Lint/Format | Biome (ein Binary für beides, kein Prettier daneben) |
| Build | tsdown |
| Tests | Vitest, Fixtures als echte Verzeichnisse unter test/fixtures/ |
| CLI-Parsing | node:util parseArgs, Hilfetexte handgeschrieben |
| Node-Version | >=22.9.0. Node 20 ist seit April 2026 EOL — ein Sicherheitswerkzeug sollte kein abgekündigtes Runtime unterstützen. |
Jede neue Abhängigkeit wird vorher begründet.
| Paket | Begründung |
|---|---|
packageurl-js |
purl-Encoding ist subtil (Scopes, Qualifier); offizielle Implementierung |
yaml |
pnpm-Lockfile und Yarn Berry |
spdx-expression-parse |
Lizenzausdrücke validieren statt Strings durchreichen |
semver |
Korrekte Versionsordnung inkl. Prereleases für die Fix-Auswahl |
@npmcli/arborist wurde vor dem Release wieder entfernt. Es lieferte den
richtigen Baum, brachte aber 115 eigene transitive Abhängigkeiten mit — bei
einem Werkzeug, dessen Thema Größe und Herkunft von Abhängigkeitsbäumen ist, war
das nicht zu rechtfertigen. Die packages-Map von package-lock.json ab
lockfileVersion 2 ist der materialisierte Baum: Pfade, aufgelöste Versionen,
Integrity und seit v2 auch Lizenzen. Kanten folgen Nodes eigener
Auflösungsregel — vom Ort des Abhängigen die node_modules-Kette hochlaufen.
Genau das lässt ein doppelt installiertes Paket auf die richtige Kopie zeigen.
Belegt ist die Gleichwertigkeit durch Snapshots von Arborists eigener Ausgabe,
aufgenommen bevor es entfernt wurde (test/fixtures/expected/), plus einen
Vergleich auf dem echten 248-Paket-Baum dieses Repos. Bilanz:
| mit arborist | ohne | |
|---|---|---|
| Produktions-Komponenten | 118 | 6 |
node_modules (prod) |
22 MB | 1,7 MB |
| Pakete auf der Platte | 88 | 6 |
Nicht gebündelt wird bewusst: die vier verbliebenen Abhängigkeiten bleiben extern und damit unabhängig von einem cradle-Release aktualisierbar. Das ist für ein Supply-Chain-Werkzeug wichtiger als eine Null-Dependency-Zahl.
Bewusst nicht als Dependency, sondern selbst geschrieben:
- Yarn-Classic-Parser —
@yarnpkg/lockfileist seit 2018 unmaintained. ~150 Zeilen eigener Code sind besser als eine tote Abhängigkeit. - Argument-Parsing —
node:utilparseArgsreicht. - HTTP-Client — globales
fetch. - Template-Engine — String-Templates plus ein strikter HTML-Escaper.
Fünf Punkte, an denen die Umsetzung bewusst von der Vorgabe abweicht:
a) hashes brauchen eine Konvertierung. npm schreibt sha512-<base64>.
CycloneDX verlangt in hashes[].content Hex. Die Integrity direkt zu übernehmen
erzeugt ein Feld, das Validatoren durchwinken und Konsumenten falsch lesen.
Zusätzlich hasht die Integrity das Tarball, nicht die Komponente — der Hash gehört
darum auch an eine externalReferences-Eintragung vom Typ distribution.
b) metadata.tools als Array ist seit CycloneDX 1.5 deprecated. Richtig ist
metadata.tools.components[] mit type: application.
c) bom-ref kann nicht immer die purl sein. Dasselbe name@version kann im Baum
mehrfach vorkommen (verschachtelte node_modules bei Versionskonflikten). Ist
bom-ref nicht eindeutig, ist der dependencies-Block kaputt — und der ist der
Unterschied zwischen einem echten SBOM und einer Textdatei. Regel: purl als
bom-ref, solange eindeutig; bei Kollision ein deterministisches Pfad-Suffix.
d) suppress braucht einen Komponenten-Scope. Ein OpenVEX-Statement ist immer
(Vulnerability × Produkt/Subkomponente). Nur über die CVE-ID zu unterdrücken würde
die Schwachstelle für alle betroffenen Pakete stumm schalten — genau das stille
Ignorieren, das VEX verhindern soll. --component <purl> ist Pflicht, sobald mehr
als ein Paket betroffen ist.
e) Der Cache-Pfad muss einen Fallback haben. node_modules/.cache/cradle/
existiert nicht ohne Install und ist im Monorepo mehrdeutig. Regel:
node_modules/.cache/cradle wenn vorhanden, sonst OS-Cache-Verzeichnis,
überschreibbar via CRADLE_CACHE_DIR.
Ohne Argumente im Projektverzeichnis:
Dependency-Graph auflösen. Paketmanager anhand der Lockfile erkennen
(package-lock.json, pnpm-lock.yaml, yarn.lock, bun.lock). Für npm
@npmcli/arborist. Für pnpm und Yarn die Lockfile direkt parsen — das sind drei
Parser, nicht zwei: pnpm v9/v10 (packages + snapshots getrennt), Yarn Classic
(eigenes Textformat) und Yarn Berry (YAML mit __metadata). Bun ist ein klarer
„nicht unterstützt"-Fehler mit Handlungsanweisung.
Alle vier Parser münden in dieselbe Zwischendarstellung (core/resolve/graph.ts),
damit prod/dev-Trennung, bom-ref-Vergabe und Komponentenbau einmal geschrieben
sind und sich überall gleich verhalten. Der Test, der zählt, ist die Äquivalenz:
vier Fixtures mit identischen Abhängigkeiten müssen identische Komponenten und
identische Kanten liefern.
Was pro Format zu beachten war:
| prod/dev in der Lockfile? | Integrity? | Lizenzen? | |
|---|---|---|---|
| npm | ja | ja (SRI) | ja, ab lockfileVersion 2 |
| pnpm | ja, pro Importer | ja (SRI) | nein |
| Yarn Classic | nein | ja (SRI) | nein |
| Yarn Berry | nein | nein (siehe unten) | nein |
- prod/dev wird für Yarn abgeleitet. Classic kennt gar keine Markierung, Berry faltet die dev-Abhängigkeiten des Roots mit den übrigen zusammen. Also wird für alle Ökosysteme gleich gerechnet: einmal von den Produktions-Abhängigkeiten aus laufen, einmal von den Entwicklungs-Abhängigkeiten, und „dev" ist, was der erste Lauf nicht erreicht hat.
- Yarn Berrys
checksumist kein Tarball-Hash. Er ist sha512-groß und sieht aus wie ein Integrity-Wert, ist aber Yarns eigener Cache-Schlüssel über Yarns eigenes Archivformat: für dasselbe Paket notiert npm4162e5d8…und Yarn6d43a916…. Ihn als CycloneDX-SHA-512 auszugeben wäre eine plausibel aussehende Lüge — Berry-SBOMs tragen deshalb keine Hashes. - pnpm-Snapshot-Schlüssel tragen den Peer-Kontext (
debug@4.3.7(supports-color@7.2.0)). Der muss abgeschnitten werden, sonst ist dasselbe Paket unter zwei Peer-Sets zwei Komponenten. - pnpm-Lockfiles vor v9 werden abgelehnt. Vor v9 gab es die
packages/snapshots-Trennung nicht; der alte Aufbau würde in einen leeren Baum parsen und wie ein Projekt ohne Abhängigkeiten aussehen. - Lizenzen kommen bei pnpm und Yarn von der Platte (
node_modules), wie in §4 entschieden. Fehlt sie — frischer Klon, oder Yarn PnP — steht „unbekannt", und der Readiness-Check führt es als offenen Punkt. Kein stiller Netzzugriff, keine erfundene Antwort.
Direkte und transitive Abhängigkeiten werden unterschieden, ebenso Production und
Development. Der Default-Scan umfasst nur Production-Dependencies, weil das der
CRA-relevante Auslieferungsumfang ist. --include-dev erweitert das.
SBOM erzeugen in CycloneDX 1.6 (JSON). Pflichtfelder pro Komponente: bom-ref,
type: library, name, version, purl (korrekt URL-enkodiert, besonders bei
Scoped Packages: pkg:npm/%40scope/name@1.2.3), licenses, hashes (hex, siehe
5a). Die Abhängigkeitsbeziehungen kommen in den dependencies-Block, nicht nur eine
flache Liste. Metadaten: eigenes Projekt als metadata.component, Zeitstempel,
metadata.tools.components[] mit uns selbst.
Schwachstellen abfragen über die OSV.dev-Batch-API
(POST https://api.osv.dev/v1/querybatch), gefolgt von Einzelabfragen für Details.
Blöcke von maximal 1000 Paketen, Retry mit Backoff bei 429, lokaler Cache.
--offline überspringt diesen Schritt und markiert den Report entsprechend.
Severity-Normalisierung: Der CVSS-v3-Basiswert wird aus dem Vektor selbst
berechnet (die Formel ist von FIRST vollständig spezifiziert, also exakt statt
geschätzt) und in die Stufen critical/high/medium/low überführt. Für CVSS v2 und
v4 wird nicht gerechnet — v4 braucht eine große Nachschlagetabelle, und Raten wäre
schlechter als das Label der Datenbank. Dann greift database_specific.severity
(GitHub sagt MODERATE, wo CVSS MEDIUM sagt). Jedes Finding trägt in
severitySource, welcher Weg es war. Der Report weist darauf hin, dass ein
CVSS-Basiswert die Schwachstelle abstrakt beschreibt und nichts über
Erreichbarkeit im konkreten Projekt aussagt.
Zurückgezogene Advisories (withdrawn) werden verworfen.
Der Cache liegt unter dem Schlüssel osv/v1/<id>@<modified>. Weil der
modified-Zeitstempel des Advisories Teil des Schlüssels ist, invalidiert sich
ein geändertes Advisory von selbst; ein Wiederholungslauf kostet genau eine
Batch-Anfrage. --no-cache schaltet ihn ab.
Ergebnis nach .cradle/:
sbom.cdx.json— das SBOMfindings.json— aufgelöste Schwachstellen mit Severity, betroffener Version, Fix-Version und Pfad im Dependency-Baum (kürzester Pfad zuerst)report.html— der Report
Konsolenausgabe: kompakte Zusammenfassung — Komponentenzahl, Findings nach Severity, unterdrückte Findings, die drei wichtigsten Handlungsempfehlungen. Keine Wall of Text.
Das Herzstück. Eine einzelne, selbstständige HTML-Datei ohne externe Ressourcen, die
man per E-Mail verschicken kann. Kein React, kein Build-Schritt — generiertes HTML
mit eingebettetem CSS und minimalem Vanilla-JS für Filter und Sortierung. Das
eingebettete JSON liegt als <script type="application/json"> im Dokument, damit der
Report maschinell weiterverarbeitbar bleibt.
Aufbau:
- Kopf: Projektname, Version, Scan-Zeitpunkt, Paketmanager, Scope (prod/all), Toolversion. Ein Auditor muss auf einen Blick wissen, was wann gescannt wurde.
- Zusammenfassung: Komponentenzahl, Findings nach Severity, unterdrückte Findings, Lizenzverteilung.
- CRA-Readiness-Checkliste (6.5).
- Findings-Tabelle: sortierbar nach Severity, filterbar. Pro Eintrag: CVE/GHSA-ID,
Paket, betroffene Version, Fix-Version, Pfad im Baum (
app > express > body-parser), Link zur OSV-Quelle, bei Unterdrückung die VEX-Begründung. - Komponententabelle: Name, Version, Lizenz, direkt oder transitiv.
- Fußzeile: technische Momentaufnahme, keine Rechtsberatung.
Design: ruhig, druckbar, hoher Kontrast. Bedeutung nie allein über Farbe. Kein Dark-Mode im MVP.
Umgesetzte Details:
- Severity doppelt kodiert. Jede Stufe steht ausgeschrieben da und trägt ein
ordinales Glyph (
●●●critical bis○○○low). Damit überlebt der Rang Graustufendruck und Farbfehlsichtigkeit. - Severity-Herkunft steht im Detail. Entweder „CVSS v3.1 base score 9.8 " oder „wie von der Advisory-Datenbank bewertet" — plus der Satz, dass ein Basiswert die Schwachstelle abstrakt beschreibt und nichts über Erreichbarkeit im Projekt aussagt.
- Escaping an genau einer Stelle (
report/escape.ts). Paketnamen, Advisory-Texte und Referenz-URLs kommen aus dem Netz, und der Report wird lokal geöffnet — ein eingeschleustes Skript liefe mitfile://-Origin. URLs werden aufhttp/httpsbeschränkt; im eingebetteten JSON bleiben sie unverändert erhalten, weil dieser Block ein wortgetreues Protokoll ist und dort inert. - Ohne JavaScript vollständig lesbar. Filter- und Sortierleisten sind
hidden, bis das Skript sie aktiviert; die Tabellen stehen komplett im HTML. - Im Druck kommt alles zurück.
@media printblendet die Bedienelemente aus, hebt jede vom Filter versteckte Zeile wieder ein und schreibt Link-Ziele aus — ein gedruckter Report muss vollständig sein. - Report und SBOM tragen dieselbe
serialNumber, damit ein Prüfer sie einander zuordnen kann. - Ein leerer Befund wird als Momentaufnahme benannt, nicht als Freibrief; ein Offline-Lauf zeigt gar keine Findings-Tabelle, weil eine leere Tabelle wie ein geprüftes „nichts gefunden" aussähe.
Der praktische Alltagsschmerz ist nicht „ich finde keine Schwachstellen", sondern „ich ertrinke in Findings, die mich nicht betreffen".
cradle suppress <finding-id> --component <purl> --justification <grund> --note "..."
schreibt ein Statement in .cradle/vex.json im OpenVEX-Format. Erlaubte
Begründungen sind ausschließlich die im Standard definierten:
component_not_presentvulnerable_code_not_presentvulnerable_code_not_in_execute_pathvulnerable_code_cannot_be_controlled_by_adversaryinline_mitigations_already_exist
Freitext über --note ist zusätzlich möglich, die Kategorie ist Pflicht. Das ist
bewusst etwas unbequem — genau diese Kategorien machen eine Unterdrückung
auditierbar statt zu einem stillen Ignorieren.
--expires <datum> lässt Unterdrückungen ablaufen; sie erscheinen im Report als
„läuft in 12 Tagen ab", und die Konsole warnt 30 Tage vorher. Abgelaufene
Unterdrückungen greifen nicht mehr — genau das ist der Zweck: eine Entscheidung
über eine Abhängigkeit soll erneuert werden müssen, statt still ihre Begründung
zu überleben. Das abgelaufene Statement bleibt am Finding hängen, damit der
Report „ist ausgelaufen" sagen kann und das Finding nicht ohne Vorgeschichte
wieder auftaucht.
Abweichung vom Standard: OpenVEX kennt kein Ablaufdatum. Deshalb steht es als
cradle:expires am Statement — mit Präfix, damit es erkennbar keine
OpenVEX-Eigenschaft ist. Alles andere in vex.json ist reines OpenVEX v0.2.0.
Korrektur (siehe §16): Die frühere Formulierung „konforme Konsumenten
ignorieren es" war zu stark. OpenVEX hat keinen Erweiterungspunkt — das offizielle
JSON-Schema setzt additionalProperties: false am Statement. Ein streng
validierender Konsument verwirft das ganze Dokument, nicht nur den unbekannten
Schlüssel. Das Präfix macht die Erweiterung erkennbar, nicht toleriert.
Weitere umgesetzte Details:
- Autor ist Pflicht. OpenVEX verlangt ihn, und eine unsignierte
Unterdrückung ist im Audit wenig wert. Default ist
git config user.email; fehlt beides, bricht der Befehl mit einer Handlungsanweisung ab. - Identifikation über GHSA oder CVE. Leute notieren sich die CVE, über die
sie gelesen haben; OSV schlüsselt npm-Advisories nach GHSA. Beides wird
akzeptiert, geschrieben wird die von cradle geführte ID plus
aliases. --componentist Pflicht, sobald mehrere Komponenten betroffen sind. Nur über die Advisory-ID zu unterdrücken würde die Schwachstelle überall stumm schalten — genau die pauschale Abtuung, die VEX verhindern soll.- Wiederholtes
suppressersetzt das Statement, statt ein zweites anzuhängen. Eine Korrektur soll als Korrektur lesbar sein, nicht als zwei widersprüchliche Aussagen. - Eine kaputte
vex.jsonbricht den Scan ab. Sie stillschweigend zu überspringen hieße, Findings erneut zu melden, über die das Team längst entschieden hat. - Unterdrückte Findings bleiben im Report und in
findings.json, getrennt ausgewiesen. Ein Prüfer muss der Entscheidung widersprechen können. - Statements, die auf nichts passen, werden gemeldet — meist wurde das Finding durch ein Update behoben und das Statement ist Altlast.
.cradle/vex.json gehört ins Git-Repo des Nutzers und ist der eigentliche Wert, der
über die Zeit entsteht.
Verhält sich wie scan, aber mit Exit-Code-Logik und Baseline-Vergleich.
.cradle/baseline.json speichert den Stand der akzeptierten Findings; check
vergleicht dagegen und meldet nur neue. Das ist der Unterschied zwischen einem Tool,
das man nach zwei Wochen abschaltet, und einem, das bleibt: ein bestehendes Projekt
hat immer Altlasten, und ein Gate, das ab Tag eins rot ist, wird ignoriert.
Trennung Baseline / VEX — verbindlich:
- VEX heißt „betrifft uns nicht". Dauerhaft, begründet, auditierbar.
- Baseline heißt „wissen wir, noch nicht gefixt". Technische Schuld, zeitlich.
- Im Report zwei getrennte Blöcke, nie vermischt.
- Der Readiness-Check zählt baselined-ohne-VEX weiterhin als offen.
checkbleibt grün, die Checkliste nicht. Sonst wäscht die Baseline Findings still weiß, und der Check meldet grün, wo Meldepflicht drohen könnte.
Optionen: --fail-on <severity> (Default high), --baseline schreibt den
aktuellen Stand als neue Baseline, --no-baseline prüft gegen alles.
Exit-Codes: 0 sauber, 1 neue Findings über der Schwelle, 2 Toolfehler. Die
Unterscheidung zwischen 1 und 2 ist wichtig, damit CI-Fehler nicht als
Sicherheitsproblem durchgehen.
Identität eines Findings in der Baseline: Advisory-ID + Paketname, ohne Version. Mit Version würde jeder Patch-Bump eines weiterhin verwundbaren Pakets wie ein brandneues Finding aussehen — und ein Gate, das bei fremdem Rauschen rot wird, wird abgeschaltet. Die Severity beim Akzeptieren wird mitgeschrieben: Wurde ein Advisory seither schlechter eingestuft, gilt es wieder als neu. Ein akzeptiertes Medium ist kein akzeptiertes Critical.
Weitere umgesetzte Details:
--fail-on nevermeldet alles und lässt nichts scheitern — für Teams, die das Gate schrittweise einführen.- Baseline-Einträge, die im Scan nicht mehr vorkommen, werden als „erledigt" ausgewiesen, damit die Datei aufgeräumt werden kann.
- Eine kaputte
baseline.jsonbricht ab, statt still als „keine Baseline" durchzugehen — das würde das Gate unbemerkt scharf schalten. --format githubschreibt Annotationen mit Datei und Zeilennummer aus derpackage.json, wenn es eine direkte Abhängigkeit ist. Eine Annotation an der Zeile, die man ändern kann, wird gelesen; eine auf Zeile 1 nicht. Transitive Pakete stehen nirgends in derpackage.jsonund bekommen stattdessen den Pfad im Baum in die Meldung.scanundcheckteilen sich dieselbe Pipeline (cli/pipeline.ts). Sie müssen sich darüber einig sein, was ein Finding ist — sonst hieße ein grünes Gate etwas anderes als ein sauberer Report.
Wart in der CLI-Benennung: --baseline und --no-baseline sind keine
Gegenteile. Ersteres schreibt die Baseline, letzteres ignoriert sie. So steht
es in der ursprünglichen Spezifikation und so ist es umgesetzt; beide sind als
eigenständige Optionen deklariert, nicht als Negation.
Ausgabe im CI-Modus als kompakte Liste, optional --format github für
GitHub-Actions-Annotationen (::error file=...).
Der Grund, warum jemand uns statt eines generischen SBOM-Generators nimmt. Geprüft wird nicht nur der Paketbestand, sondern auch die Dokumentationspflichten drumherum. Sechs Punkte (die ursprünglich getrennten Punkte zu Art. 13 Abs. 8, 9 und 13 sind zusammengefasst — die beiden Zehnjahresfristen lassen sich aus einem Repo nicht prüfen, gehören aber in die Handlungsanweisung):
| ID | Prüfung | Bezug |
|---|---|---|
sbom |
Existiert ein SBOM und ist es aktueller als die Lockfile? | Anhang I Teil II Nr. 1 |
disclosure |
Existiert eine SECURITY.md mit erreichbarem Kontakt (Adresse oder Meldelink)? |
Anhang I Teil II Nr. 5 |
support-period |
Ist der Support-Zeitraum dokumentiert und erreicht er die Fünfjahresgrenze? | Art. 13 Abs. 8, 9, 13 |
licences |
Sind alle Komponenten mit einer Lizenz versehen? | Anhang I Teil II Nr. 1 |
maintenance |
Deprecated oder seit über 24 Monaten ohne Release? | Anhang I Teil II Nr. 2 |
unresolved |
Offene Findings ohne Fix und ohne VEX-Statement? | Art. 14 |
Jeder Punkt bekommt einen Status — erfüllt / teilweise / offen / nicht prüfbar — und einen konkreten nächsten Schritt, formuliert als Handlungsanweisung, nicht als Vorwurf. Wo cradle es nicht wissen kann, steht nicht prüfbar: eine Checkliste, die grün meldet, weil sie nicht hingesehen hat, ist schlechter als keine.
Konfigurierbar über .cradle/config.json: productName, contactEmail,
supportPeriodEnd, placedOnMarket. Ein unbekannter Schlüssel bricht ab —
ein vertipptes supportPeriodEndd würde sonst still „nicht dokumentiert" melden,
während der Nutzer sicher ist, es dokumentiert zu haben.
Umgesetzte Details:
- Die Fünfjahresgrenze wird kalendergenau gerechnet. Fünf Jahre sind je nach
Schaltjahr 1825 oder 1826 Tage; durch eine mittlere Jahreslänge geteilt ergeben
exakt fünf Kalenderjahre 4,999 — und das Werkzeug würde einem konformen Nutzer
sagen, er sei es nicht. Verglichen wird deshalb Datum gegen Datum. Fehlt
placedOnMarket, ist der Punkt „teilweise": die Grenze ist ohne Startdatum nicht prüfbar. maintenancefragt die npm-Registry und ist unter--offline„nicht prüfbar". Zwei Signale mit sehr unterschiedlichen Kosten, deshalb zwei Umfänge: Deprecated kommt aus dem Einzelversions-Manifest (wenige KB) und wird für alle Komponenten geprüft; letztes Release steht nur im vollständigen Packument (hunderte KB) und wird nur für direkte Abhängigkeiten geholt. Der Report sagt beides ausdrücklich. Dermodified-Zeitstempel der Registry sieht wie eine billige Abkürzung aus und ist keine — er bewegt sich bei Metadatenänderungen:requestgilt dort als „diesen Monat geändert", das letzte echte Release war 2020.- Registry-Ausfälle brechen nichts ab. Diese Information verbessert die Checkliste, sie ist nicht der Zweck des Werkzeugs; ohne Antwort steht „nicht prüfbar".
unresolvedzählt baselined-ohne-VEX als offen.cradle checkbleibt darauf grün, weil ein Gate, das ab Tag eins rot ist, abgeschaltet wird — aber die Baseline sagt „wissen wir", nicht „betrifft uns nicht", und nur VEX sagt Letzteres. Würde die Checkliste die Baseline mitzählen, würde die Baseline Findings still weißwaschen, und zwar genau dort, wo es am meisten zählt.
Composite Action unter action.yml im selben Repo (P-hinn/cradle-cli), ruft
npx cradle-cli@<version> auf:
permissions:
contents: read
pull-requests: write # nur für comment-on-pr
steps:
- uses: actions/checkout@v5
- uses: actions/setup-node@v5
with: { node-version: '22' }
- uses: P-hinn/cradle-cli@v0.3.0
with:
fail-on: high
upload-artifact: true
comment-on-pr: trueAblauf: scan (schreibt SBOM, Findings, Report, Readiness) → check
(Annotationen + Exit-Code) → Artifact-Upload → PR-Kommentar → Fehlschlag bei
neuen Findings.
Umgesetzte Details:
- Der PR-Kommentar wird vom Werkzeug erzeugt, nicht von der Action.
cradle check --format markdowngibt den fertigen Body aus; die Action pipet ihn nur weiter. Damit ist die Formatierung getestet, und das CLI braucht keinerlei Schreibzugriff auf GitHub — das Posten machtgh apiin der Action. - Idempotent über einen Marker (
<!-- cradle-cli:report -->): existiert ein Kommentar mit diesem Marker, wird er perPATCHaktualisiert, sonst perPOSTangelegt. Ein PR, der pro Push einen Kommentar sammelt, ist ein PR, in dem niemand mehr Kommentare liest. Ein Test hält Marker im Werkzeug und Marker in der Action aneinander gekoppelt. - Exit-Code 2 wird als Build-Fehler behandelt, nicht als Sicherheitsergebnis.
Der
check-Schritt läuft bewusst ohneset -e— ein Exit ungleich null ist das Ergebnis. Damit ein fehlgeschlagener Download nicht als „Exit 1 = neue Findings" durchgeht, läuft dasselbe Paket vorher imscan-Schritt mitset -e: ein Installationsproblem lässt den Job dort scheitern. - Keine
${{ }}-Interpolation inrun-Blöcken. Jeder Wert kommt überenv:— direkt eingesetzte Ausdrücke sind ein Script-Injection-Loch. Ein Test prüft das. --fail-on nevermeldet und lässt nichts scheitern, für die schrittweise Einführung.
Die Action lässt sich hier nicht ausführen, deshalb prüft test/action.test.ts
die Fehler, die sonst erst in einer fremden Pipeline auffielen: Tippfehler in
Input-Referenzen, run-Schritte ohne shell, ungepinnte uses-Versionen, ein
abgedrifteter Marker. Die Shell-Schritte selbst wurden lokal gegen ein echtes
Projekt ausgeführt.
Gehört so ins README, damit klar ist: Absicht, keine Lücke.
- Andere Ökosysteme als npm (kein Python, kein Go, keine Container)
SPDX als Ausgabeformat— seit §18.2 vorhanden (--sbom-format spdx, SPDX 2.3). Der Eintrag bleibt durchgestrichen stehen, statt gelöscht zu werden: eine Abgrenzung, die später fällt, ist Teil der Entscheidungsgeschichte.- Signierte Attestationen, Sigstore, SLSA. Der npm-Publish trägt eine Provenance-Attestation; cradle signiert nichts vom Nutzer.
- Eine Weboberfläche oder ein gehosteter Dienst
- Automatische Pull Requests für Updates (das macht Dependabot besser)
- Lizenz-Policy-Enforcement (nur anzeigen, nicht blockieren)
- Die Feststellung, ob eine Schwachstelle aktiv ausgenutzt wird, und damit ob eine Meldepflicht nach Art. 14 besteht (§18.4, §18.5)
Kernlogik strikt getrennt von CLI und Darstellung, damit das Paket auch als Library nutzbar ist.
src/
cli/ Befehle, Argument-Parsing, Konsolenausgabe
core/
resolve/ Paketmanager-Erkennung, Lockfile-Parser, Dependency-Graph
sbom/ CycloneDX-Erzeugung, PURL-Bau, Lizenz-Normalisierung
vulns/ OSV-Client, Caching, Severity-Normalisierung
vex/ OpenVEX lesen/schreiben, Ablaufprüfung, Anwendung auf Findings
readiness/ Die CRA-Checkliste
baseline/ Diffing gegen die Baseline
report/ HTML-Generierung, Templates, CSS
types/ Gemeinsame Typen, alle aus einer Datei re-exportiert
Regel: Funktionen in core/ bekommen ihre Eingaben übergeben und schreiben
nichts direkt auf die Platte oder die Konsole. Dateizugriff und Ausgabe passieren in
cli/. Das macht die Tests einfach.
-
Jeder Lockfile-Parser bekommt mindestens ein echtes Fixture-Projekt als Test, inklusive Scoped Packages, Peer-Dependencies, Workspaces und einem Paket ohne Lizenzangabe. Bestand unter
test/fixtures/:Fixture Deckt ab npm-basicScoped Package, transitive Kette, prod/dev-Trennung npm-workspacesWorkspace-Links, automatisch installierter Peer-Dep, Paket ohne Lizenzfeld, privates Root npm-duplicatesDasselbe Paket zweimal im Baum, verschachtelt unter einem Dependent pnpm-basic,yarn-classic-basic,yarn-berry-basicDieselben Abhängigkeiten wie npm-basic, damit die vier Parser gegeneinander geprüft werden könnennpm-edge-casesnpm:-Alias,git+,file:,bundledDependencies, optionale Dep,overrides, private Registry, deklariert-aber-nicht-in-der-Lockfile (§15)pnpm-edge-casesgit (Key trägt URL), file:(type: directory, keine Version),link:außerhalb des Workspace, unaufgelöstyarn-berry-edge-casesAlias über resolution,patch:, git,portal:mitlinkType: soft,::locator=-Suffixyarn-classic-edge-casesgit und file:allein aus dem Descriptor, unaufgelöstdetect/*Lockfile-Erkennung für npm, pnpm, Yarn Classic, Yarn Berry, Bun, sowie fehlende Lockfile und Nicht-Projekt Jedes
*-edge-cases-Fixture trägt eineREADME.md, die festhält, womit es erzeugt wurde und welche Einträge von Hand geschrieben sind. Diese Unterscheidung ist nicht Kosmetik: drei der in §15 beschriebenen Fehler waren zuerst durch falsch geratene Fixtures verdeckt.Die pnpm- und Yarn-Fixtures tragen ein eingechecktes
node_modulesaus nurpackage.json-Dateien — kein Code —, weil ihre Lockfiles keine Lizenzen führen. Damit laufen die Tests offline und deterministisch ohne Installation. -
Fixtures enthalten nur
package.jsonund Lockfile, kein installiertesnode_modules. Wo ein Parser Daten von der Platte braucht (pnpm, Yarn), wird ein minimalernode_modules-Baum aus reinenpackage.json-Dateien eingecheckt. Tests laufen damit offline und deterministisch, ohnenpm install. -
Jedes erzeugte SBOM wird im Test gegen die eingecheckten offiziellen CycloneDX-Schemata validiert (1.6 und 1.7), nicht gegen handgeschriebene Erwartungen.
-
Der OSV-Client wird in Tests gemockt, nie live abgefragt. Die Antworten unter
test/fixtures/osv/sind einmal echt aufgezeichnet und werden abgespielt; ein Setup-File ersetztglobalThis.fetchdurch einen Werfer, damit ein vergessener Injektionspunkt laut scheitert statt still ins Netz zu gehen. -
Fehlermeldungen sagen, was schiefging und was der Nutzer tun soll. „ENOENT" ist keine Fehlermeldung.
-
Keine
any-Typen ohne Kommentar, der erklärt warum. -
Conventional Commits, kleine Commits, jeder Commit lauffähig.
Nach jedem Meilenstein wird angehalten.
- Gerüst — Repo, Configs, Lizenz, CI,
SPEC.md, Fixture-Verzeichnisse. - Typen, npm-Parser, CycloneDX — Ergebnis:
cradle scan --offlineschreibt ein gegen das offizielle 1.6-Schema validiertessbom.cdx.json. - OSV-Client mit Cache, Findings-Auflösung inklusive Pfad im Baum.
- HTML-Report. Erst ein statischer Entwurf mit echten Daten zur Abnahme, dann Generierungscode. Hier wird bewusst Zeit investiert — das ist das Produkt.
- VEX-Unterdrückung und
suppress-Befehl. - Baseline und
checkmit Exit-Codes. - CRA-Readiness-Checkliste.
- pnpm-, Yarn-Classic- und Yarn-Berry-Parser.
- GitHub Action.
- README, Beispielprojekt, Release-Vorbereitung.
- Verordnung (EU) 2024/2847, EUR-Lex
- CRA-Zusammenfassung der EU-Kommission
- CycloneDX-Spezifikation
- OpenVEX-Spezifikation
- OSV.dev API
cradle ist ein technisches Hilfsmittel zur Dokumentation und Prozessunterstützung.
Es ist keine Rechtsberatung, keine Konformitätsbewertung und keine
Konformitätserklärung. Ob ein Produkt die Anforderungen der Verordnung (EU) 2024/2847
erfüllt, entscheidet nicht dieses Werkzeug. Die harmonisierten Normen zum CRA sind
zum Stand dieses Dokuments nicht final.
Die Abschnitte 1–12 beschreiben den Stand bis 0.1.3. Alles darunter wurde danach entschieden und ergänzt sie, statt sie zu ersetzen. Neue Abschnitte werden angehängt, damit die Nummern in 1–12 als Referenzen stabil bleiben.
Läuft auf push nach main und auf jeden pull_request. Matrix: Node 22 und
24 × ubuntu, macos, windows — sechs Kombinationen, keine Stichprobe davon.
Warum drei Betriebssysteme. Die Lockfile-Parser setzen Pfade zusammen, und
node_modules-Ketten werden hochgelaufen (§4.1). Ein Trennzeichen-Fehler, der
nur unter Windows auftritt, erreicht sonst einen Nutzer, bevor er uns erreicht.
fail-fast: false, weil ein abgebrochener macOS-Lauf genau die Information
verschweigt, die man braucht: ob der Fehler plattformspezifisch war.
Warum Node 24 mitläuft. 22.9 ist der deklarierte Boden (engines), 24 ist
aktuell. Ein Test prüft, dass die untere Matrix-Stufe und engines.node
zusammenpassen; ein angehobener Boden ohne angehobene Matrix wäre sonst
unbemerkt.
Schritte: npm ci, lint, typecheck, test, build — und danach das
gebaute CLI gegen examples/express-service:
scan --offlinemuss die drei Dateien nicht-leer schreiben, undfindings.jsonmussoffline: truetragen. Eine leere Findings-Liste ohne diese Markierung liest sich wie ein geprüftes „nichts gefunden" (§6.2).check --offlinemuss 0 liefern, undcheck --offline ./does-not-existmuss 2 liefern. Beide Seiten des Exit-Code-Vertrags (§6.4), nicht nur die glückliche.
--offline ist hier keine Bequemlichkeit. Ein CI-Job, der api.osv.dev
abfragt, macht eine fremde Störung zu einem roten Build in diesem Repo und den
Lauf nebenbei nicht reproduzierbar. Ein Test prüft, dass jeder Aufruf des
gebauten CLI in ci.yml --offline trägt.
Falle, die einen eigenen Test bekommen hat. GitHub startet shell: bash als
bash --noprofile --norc -eo pipefail. Das -e kommt von außen und wird von
einem set -uo pipefail im Skript nicht abgeschaltet. Ein Schritt, der $?
ausliest, stirbt damit am ersten Exit ungleich null — die Assertion läuft nie und
der Schritt ist grün, weil er nicht hingesehen hat. Deshalb: set +e explizit,
und ein Test, der jeden Schritt mit $? darauf festnagelt. Dieselbe Falle ist in
§6.6 für die Action beschrieben; hier ist sie zum zweiten Mal aufgetreten.
CodeQL mit javascript-typescript und dem Paket security-extended, nicht
dem Default. Die beiden Fragen, die hier zählen, stehen nur im erweiterten Paket:
Pfad-Traversal aus dem Projektverzeichnis heraus (§SECURITY.md) und unsichere
HTML-Konstruktion im Report-Generator. Läuft zusätzlich wöchentlich — ein Repo
mit vier Abhängigkeiten bekommt trotzdem neue Queries.
Scorecard mit publish_results: true. Für ein Werkzeug, dessen Thema
Supply-Chain-Nachweise sind, ist ein veröffentlichter, nachprüfbarer Score das
Mindeste; ein Badge, dem man nur glauben kann, wäre genau die Sorte Nachweis, die
cradle anderen nicht abnimmt. persist-credentials: false beim Checkout.
Actions werden auf @vN gepinnt, nicht auf einen SHA. Scorecards
Pinned-Dependencies-Check bewertet SHA-Pinning besser. Die Entscheidung geht
trotzdem bewusst anders: @vN plus wöchentliches Dependabot für
github-actions hält die Versionen aktuell und lesbar, und ein bestehender Test
(test/action.test.ts) erzwingt das Pinning-Muster repo-weit. Ein niedrigerer
Punktwert in einem Unterpunkt ist hier der ehrlichere Preis.
npm und github-actions, wöchentlich, gruppiert — Runtime und Development
getrennt. Vier Runtime-Abhängigkeiten und eine Handvoll Dev-Abhängigkeiten
ergeben einen prüfbaren Pull Request pro Woche; acht einzelne öffnet niemand.
Commit-Präfixe chore bzw. ci, passend zu §9.
examples/express-service ist ausdrücklich nicht eingetragen. Das Beispiel
ist auf absichtlich veraltete Abhängigkeiten gepinnt, damit es Findings
produziert. Es zu aktualisieren würde es abschaffen. Ein Test hält fest, dass
kein Dependabot-Eintrag auf ein anderes Verzeichnis als / zeigt, damit diese
Auslassung als Entscheidung erkennbar bleibt und nicht als Versehen.
CONTRIBUTING.md, CODE_OF_CONDUCT.md (Contributor Covenant 2.1, Kontakt
identisch mit SECURITY.md — ein Test koppelt beide, damit nicht zwei Adressen
auseinanderlaufen), PULL_REQUEST_TEMPLATE.md und drei Issue-Templates.
blank_issues_enabled: false: ein leeres Issue ist der Weg, auf dem eine
Schwachstelle öffentlich wird.
Das dritte Template, false-positive-finding, ist das eigentliche. Es verlangt
Package Manager, Lockfile-Version und Advisory-ID als Pflichtfelder — ohne
alle drei ist ein False Positive nicht reproduzierbar, und ein nicht
reproduzierbares False Positive ist eine Meinung. Es trennt außerdem vorab drei
Fälle, die sonst jeder einzeln beantwortet werden müssten: ein falsches Advisory
gehört zu OSV, ein zutreffendes Advisory ohne Bezug zum Projekt gehört in
cradle suppress, und hierher gehört nur cradles eigene Mechanik — falsch
gematchte Ranges, falsch gerechnetes CVSS, falsche Fix-Version, falscher Pfad.
CONTRIBUTING.md beschreibt zwei Sorten Fixture getrennt, weil sie
unterschiedliche Aufgaben haben: test/fixtures/ für was cradle mit einer Form
macht (klein, handgeschrieben, im Diff lesbar) und test/corpus/ für hält
cradle eine echte Lockfile in echter Größe aus (siehe §14).
v0.1.3 hat zwei Fehler nacheinander offengelegt.
Erstens, die ursprüngliche Ursache. Release-Assets sind nach Dateinamen
verschlüsselt, und beide SBOMs heißen dort, wo sie geschrieben werden,
sbom.cdx.json. Der zweite Upload kam als HTTP 404 zurück. Das Release war
damit angelegt, der Lauf aber rot, und die Assets fehlten. Behoben durch
eindeutige Namen (<paket>-<version>-sbom.cdx.json) und dadurch, dass der
Workflow wiederholbar wurde: gh release view → edit oder create, Upload mit
--clobber. Ein fehlgeschlagener Lauf soll durch einen zweiten Lauf zu
reparieren sein, nicht durch eine verbrannte Versionsnummer.
Zweitens, die Lücke, die dadurch entstand. Ein Wiederholungslauf überspringt
npm publish, wenn die Version schon auf der Registry liegt — baut die Assets
aber neu. Wurde der Tag zwischenzeitlich verschoben, beschreiben SBOM und Report
auf dem Release einen anderen Commit als das veröffentlichte Tarball. Genau das
war nach 0.1.3 der Zustand: npm führt gitHead = 44eb98d, der Tag v0.1.3 zeigt
auf 1fb556f.
Für ein Werkzeug, dessen Zweck Nachvollziehbarkeit ist, ist das das schlechteste mögliche Ergebnis — schlechter als ein roter Lauf, weil es grün aussieht. Entscheidung:
- Im Skip-Pfad wird npms
gitHeadgegen$GITHUB_SHAverglichen. Abweichung → Abbruch mit der Anweisung, die Version zu erhöhen statt den Tag zu verschieben. - Lässt sich
gitHeadnicht lesen, ist die Gleichheit nicht bewiesen und das ist derselbe Abbruch. „Nicht prüfbar" heißt hier nicht „wahrscheinlich in Ordnung" — dieselbe Regel, die die Readiness-Checkliste auf sich selbst anwendet (§6.5). - Eine veröffentlichte Version ist endgültig. Tags werden nicht verschoben.
Drittens, eine verwandte Reihenfolge. Die beiden Selbst-Scans laufen mit
|| true, weil ein Finding über der Schwelle kein kaputtes Release ist. Ein
Absturz sieht am Exit-Code identisch aus. Die Evidenzdateien werden deshalb auf
Existenz geprüft — und zwar im Scan-Schritt, vor dem Publish. Vorher fiel ein
fehlendes SBOM erst beim Upload auf, also nachdem die Version auf der Registry
war.
Ein Lockfile enthält Formen, die eine SBOM nicht exakt ausdrücken kann: ein Paket unter einem anderen Namen installiert, aus einem git-Commit gebaut, aus einem Verzeichnis vendort, vom Paketmanager gepatcht.
Die Regel ist nicht „alles unterstützen". Sie ist: nichts stillschweigend verwerfen. Eine übersprungene Abhängigkeit hinterlässt eine Ausgabe, die weiterhin vollständig aussieht — die Komponentenliste ist plausibel, die Finding-Zahl liest sich wie eine Antwort, und nichts sagt, dass ein Paket fehlt. Das ist strikt schlechter als es zu sagen, aus demselben Grund, aus dem die Readiness-Checkliste „nicht prüfbar" meldet statt eines zuversichtlichen leeren Felds (§6.5).
Umgesetzt als ResolveNote mit kind, subject, message und hint. Jede Note
steht in der Konsolenausgabe, in findings.json (damit eine Maschine dieselben
Vorbehalte sieht wie ein Mensch) und im Report als eigener Abschnitt vor der
Komponententabelle: alles darüber ist eine Zahl, und eine Zahl kann nicht sagen,
dass eines der gezählten Dinge nicht ganz das ist, wonach es aussieht. Bei einem
gewöhnlichen Projekt fehlt der Abschnitt vollständig, damit seine Anwesenheit
etwas bedeutet.
Sechs Arten: git-dependency, local-dependency, aliased-dependency,
patched-dependency, unresolved-dependency, bundled-dependency.
Bei einem npm:-Alias ("is-alias": "npm:@sindresorhus/is@^7.0.1") trägt die
Komponente @sindresorhus/is, nicht is-alias. Begründung: OSV schlüsselt
Advisories nach dem veröffentlichten Namen, und eine purl auf is-alias würde ein
Paket benennen, das es nicht gibt. Der Alias-Name erscheint dadurch nirgends in
der Ausgabe — genau deshalb gibt es die Note.
Die folgenden waren echt und sind behoben. Sie stehen hier vollständig, weil jeder einzelne dieselbe Signatur hatte: eine plausibel aussehende Ausgabe.
npm
- Eine
file:-Abhängigkeit wurde als Workspace geführt. Beide werden außerhalb vonnode_modulesmaterialisiert und ihre Lockfile-Einträge sind nicht unterscheidbar; nur der deklarierte Range trennt sie. Folge: fremder Code stand in der Workspace-Liste als eigenes Paket des Produkts. - Eine deklarierte, aber in der Lockfile fehlende Abhängigkeit verschwand wortlos.
pnpm
- Eine git-Abhängigkeit bekam eine URL als Version —
pkg:npm/left-pad@https://codeload.github.com/…. Der Key trägt bei pnpm die Tarball-URL; die echte Version steht in einem eigenen Feld. - Eine
file:-Abhängigkeit bekam den Spezifikator als Version —pkg:npm/acme-local-lib@file:local-lib. Beitype: directorysteht die Version nirgends in der Lockfile; sie kommt jetzt aus derpackage.jsondes Verzeichnisses. Ist sie auch dort nicht lesbar, wird die Komponente weggelassen und gemeldet, nicht erfunden. - Monorepos waren flachgeklopft und ihre Mitglieder unerreichbar (§14.1 unten, gefunden durch den Corpus).
Yarn (beide)
splitDescriptorteilte am letzten@. Richtig ist der erste nach Position 0, weil ein Scope-@auf Position 0 sitzt und der Range danach beliebig viele weitere enthalten darf. Ergebnis vorher: Namen wietypescript@patch:typescript.- Berry nahm den Namen aus dem Descriptor statt aus
resolution. Bei einem Alias weichen sie ab, und es entstand eine Komponenteis-aliasmit einer purl für ein nicht existierendes Paket. - Berry behandelte
linkType: softals „ist ein Workspace". Das gilt auch fürportal:undlink:, die damit aus der SBOM fielen und anschließend als „nicht in der Lockfile" gemeldet wurden — obwohl sie sichtbar darin standen. Maßgeblich ist ausschließlich eine@workspace:-Resolution. - Berry speicherte Descriptors nur protokoll-gestrippt. Für einen Alias ist die
gestrippte Form bedeutungslos, also löste er nie auf. Jetzt werden beide
Schreibweisen registriert, zusätzlich die ohne
::locator=-Suffix. - Yarns eingebaute
patch:-Einträge wurden lautlos verworfen. Sie bleiben eine Komponente (zwei wären Doppelzählung), aber mit Note: der Code auf der Platte ist nicht der veröffentlichte. - Yarn Classic erkannte git und
file:überhaupt nicht, weil nur Berrysresolutiongelesen wurde. Classic hat kein solches Feld; die Erkennung liest jetzt den Descriptor-Range.
Gemeinsam
- Eine optionale Root-Abhängigkeit war als
prodgelabelt. Deroptional-Kind galt nur für Paket-Kanten, nicht für die des Roots — CycloneDX hatscope: optional, und die Information ging verloren.
Eine unerfüllte optionale Abhängigkeit. Das ist der Normalfall und funktionierendes Verhalten des Paketmanagers; sie zu melden würde die Notes entwerten, die tatsächlich etwas bedeuten.
Die Tarball-URL landet in externalReferences und nirgends sonst. Nicht in
der purl, nicht in einem Hash-Feld. Eine purl, die einen internen Host und ein
Token einbettet, wäre keine gültige purl — und würde die Registry in jede SBOM
tragen, die an einen Dritten geht. Ein Test hält das fest.
§4 hatte „ein Report pro Repo, --workspace später" festgelegt. Hier ist das
Später.
Ein Monorepo hat eine Lockfile und mehrere Auslieferungsgegenstände. Der repo-weite Report antwortet auf „was steckt in diesem Repository". Ein Paket-Report antwortet auf „was steckt in dem Ding, das mein Team ausliefert" — eine andere Frage, und die, die entscheidet, wer ein Finding behebt.
Der Unterschied steckt im Pfad. @acme/api › fastify › find-my-way ist die
Antwort auf „kann mein Team das reparieren". Der repo-weite Report sagt
acme-monorepo › @acme/api › fastify › find-my-way — dieselbe Tatsache mit einem
Schritt davor, der niemandem gehört.
--workspace löst das Paket nicht eigenständig auf. Es schneidet einen
Teilgraphen aus dem fertigen repo-weiten Graphen: das Paket wird die Wurzel, und
nur was es tatsächlich erreicht bleibt übrig.
Das ist der Kern. Ein Monorepo hat eine Lockfile, also eine Auflösung. Ein eigenständig aufgelöstes Paket würde andere Versionen bekommen als dasselbe Paket im Repo-Kontext — und dann würden zwei cradle-Reports über denselben Code einander widersprechen. Ein Test hält fest, dass jede Version im Paket-Report mit der im Repo-Report übereinstimmt.
Aus derselben Entscheidung folgt: eine OSV-Abfrage für alle Pakete. Die
Advisories sind dieselben, nur die Routen unterscheiden sich, also wird
resolveFindings auf den geschnittenen Graphen erneut angewendet statt das Netz
erneut zu fragen.
In das Verzeichnis des Pakets (packages/api/.cradle/), nicht unter den
Repo-Root. Der Report soll bei dem Code liegen, den er beschreibt — das zählt,
wenn ein Team ein Paket besitzt. Das **/.cradle/*-Muster im README ist genau
deshalb so geschrieben, wie es geschrieben ist.
--workspace all verträgt sich nicht mit --output-dir und bricht ab: jedes
Paket würde in dasselbe Verzeichnis schreiben und nur das letzte überleben — ein
Lauf, der erfolgreich aussieht und sechs Reports verschluckt hat.
Statements werden aus .cradle/vex.json des Repo-Roots und aus dem des Pakets
gelesen; bei Konflikt über dieselbe (Vulnerability × Produkt) gewinnt das Paket.
Nur die Paket-Datei zu lesen hieße, Findings erneut zu melden, über die das Team
auf Repo-Ebene längst entschieden hat — genau das Versagen, dessentwegen eine
kaputte vex.json den Scan abbricht (§6.3). Das zusammengeführte Dokument wird
nie zurückgeschrieben; es entscheidet nur, was dieser Report zählt, und
niemand hat es verfasst.
Hängt @acme/api von @acme/shared ab, erscheint @acme/shared im Report von
@acme/api als gewöhnliche Komponente — mit workspace: true, aber als
Abhängigkeit. Von hier aus ist es eine, nur eine, die man selbst reparieren
kann.
cradle check --workspace <name> gibt es, --workspace all nicht und der
Befehl bricht dafür ab.
Begründung: ein Gate produziert einen Exit-Code und, im Markdown-Format, einen PR-Kommentar. Keines von beiden kann ehrlich für mehrere Pakete sprechen. Ein aggregierter Exit-Code würde „irgendwo ist etwas rot" melden, ohne zu sagen wo, und ein zusammengeworfener Kommentar wäre der Kommentar, den niemand mehr liest (§6.6). Ein Monorepo lässt stattdessen einen check-Job pro Paket laufen — was auch dafür sorgt, dass Annotationen und Baseline dort landen, wo sie hingehören.
Die Baseline liegt entsprechend im Paketverzeichnis. Das ist der eigentliche Gewinn: der Altlast-Berg eines Geschwisterpakets färbt das eigene Gate nicht mehr rot. Ein Test hält genau das fest.
Eine Note (§15), die ein Paket außerhalb des Teilbaums nennt, ist hier Rauschen
und wird weggelassen. Eine Note, die gar keine Komponente im Repository nennt
— unresolved-dependency trägt nur einen Namen und hat per Definition keine —
bleibt erhalten. Sie wegzulassen würde sie aus jedem Report entfernen statt sie
in den richtigen zu verschieben.
Zwei Dinge verhindern, dass zwei Läufe über dieselbe Lockfile dieselben Bytes
erzeugen, und beide sind Absicht: die SBOM stempelt den Zeitpunkt ihrer
Entstehung, und sie prägt eine frische serialNumber, damit ein Prüfer zwei BOMs
auseinanderhalten kann (§6.2). Keines davon ist falsch — es ist nur nicht, was ein
Buildsystem will. Deshalb sind beide überschreibbar statt entfernt; der
Default bleibt genau wie er war.
--timestamp <iso> und --serial-number <urn>. Zwei Läufe mit denselben Werten
erzeugen byte-identische sbom.cdx.json, findings.json und report.html — alle
drei, nicht nur die SBOM, weil der Report Zeitstempel und Seriennummer ebenfalls
trägt.
Beide Eingaben werden geprüft, nicht durchgereicht.
- Ein Zeitstempel wird geparst und auf ISO-UTC normalisiert.
2026-09-26T14:00:00+02:00und2026-09-26T12:00:00Zsind derselbe Augenblick; würde die Schreibweise in die Ausgabe durchschlagen, wäre die Reproduzierbarkeit eine Lüge. Ein nicht parsbarer Wert bricht ab:new Date('2026')ist ein gültiges Datum, und ein lockerer Parse würde das als Neujahrsmitternacht akzeptieren — eine plausibel aussehende falsche Antwort in genau dem Feld, das ein Auditor als „wann wurde das gescannt" liest. - Eine Seriennummer muss die von CycloneDX verlangte UUID-URN-Form haben. Der Tippfehler ist dann ein Fehler mit Handlungsanweisung statt eine Validierungsmeldung in dem Werkzeug, das die Datei als nächstes liest.
--serial-number verträgt sich nicht mit --workspace all und bricht ab. Eine
Seriennummer identifiziert ein BOM; dieselbe an sechs Pakete zu vergeben
erzeugt sechs Dokumente, die behaupten, dasselbe Dokument zu sein. Für einen
reproduzierbaren Monorepo-Build läuft man ein Paket auf einmal:
cradle scan --workspace <name> --serial-number <urn>.
Der Zeitstempel wird dagegen bewusst über alle Workspaces geteilt — alle Reports stammen aus einem Scan zu einem Augenblick.
Geprüft gegen Version 2.1.0 vom 20.08.2025 (src/core/readiness/profiles/bsi-tr-03183.ts).
Versionsermittlung, weil sie eine Falle enthält: die BSI-Download-URLs tragen
eine CMS-Asset-Version. Die Datei BSI-TR-03183-2_v2_2_0.pdf enthält
Dokumentversion 1.1. Maßgeblich ist die Übersichtsseite, nicht der Dateiname.
Achtzehn Datenfelder aus §4, §5.2.1–§5.2.4 und §6.1. Jedes Feld trägt den Abschnitt und die Stelle, an die die Zuordnungstabelle der Richtlinie es in CycloneDX 1.6 legt. Eine Checkliste, die sich nicht auf das Dokument zurückführen lässt, das sie umzusetzen behauptet, ist eine Meinung mit einer Tabelle drumherum.
Das Profil ändert den Exit-Code nie. Mehrere Pflichtfelder sind Aussagen über
die Auslieferung — ob das ausgelieferte Artefakt ausführbar, ein Archiv, eine
strukturierte Datei ist. Ein npm-Paket wird als .tgz geholt und als Verzeichnis
installiert; welches davon ausgeliefert wird, steht in keiner Lockfile. Diese
Felder sind not assessable mit Begründung. Ein dauerhaft roter Build wird
abgeschaltet.
Das einzige Urteil, das das Profil fällt, lautet „kein Pflichtfeld ist offen". Ein Test greppt den Quelltext nach dem Wort compliant — das ist die Grenze, die dieses Werkzeug nicht überschreitet.
Zwei Felder wurden von unerreichbar auf erreichbar gebracht, weil eine
Checkliste, die niemand erfüllen kann, nutzlos ist: metadata.manufacturer aus
contactEmail (§5.2.1) und bsi:component:filename aus der aufgelösten
Tarball-URL (§5.2.2).
Offener Punkt: §4 setzt den SPDX-Mindeststand auf 3.0.1. cradles SPDX-Export ist 2.3 (§18.2). Die CycloneDX-1.6-Ausgabe erfüllt die Formatanforderung; der SPDX-Export tut es nicht, und das Profil prüft deshalb das CycloneDX-Dokument.
--sbom-format cyclonedx|spdx|both, --vex-format openvex|csaf|both.
Keines der beiden Formate sagt etwas, was die bestehende Ausgabe nicht sagt. Sie existieren, weil jemand sie namentlich verlangt: SPDX im Einkauf, CSAF in der europäischen Schwachstellenbehandlung (TR-03183-3, ENISA-Meldeweg).
Also sind es Darstellungen desselben aufgelösten Graphen, keine zweiten
Auflösungen. Das SPDX-Dokument trägt denselben Zeitstempel wie das
CycloneDX-Dokument und dessen Seriennummer im Namespace; ein Test zählt die
Abhängigkeitskanten in beiden und verlangt Gleichheit. CSAF entsteht aus
denselben Suppressions wie vex.json, und CSAFs flags[].label zählt exakt die
fünf OpenVEX-Begründungen auf — die Abbildung ist verlustfrei.
Beide werden gegen die offiziellen Schemata validiert. Eine Datei, die ein Format behauptet und es nicht erfüllt, ist schlechter als keine Datei: der Konsument merkt es, und alles andere in demselben Verzeichnis verliert damit an Glaubwürdigkeit. Für CSAF mussten FIRSTs drei CVSS-Schemata mitvendored werden, die CSAF per absoluter URL referenziert; zwei davon deklarieren draft-04 und werden beim Laden im Test-Helper umgedeutet. Die vendorten Dateien bleiben byteweise wie veröffentlicht — sie sind Beleg dafür, was das Schema sagte, und eine Bearbeitung an Ort und Stelle machte daraus einen Beleg dafür, was wir beschlossen haben, dass es sagen solle.
Leeres CSAF wird nicht geschrieben. Das Schema setzt minItems: 1 auf
vulnerabilities und full_product_names; ohne Suppression gibt es kein
gültiges CSAF-Dokument. Abwesend schlägt ungültig.
Alle Strings des HTML-Reports und des Markdown-Kommentars liegen in
src/report/i18n/. Das lang-Attribut wird mitgesetzt: eine übersetzte Seite,
die weiter lang="en" sagt, wird vom Screenreader falsch ausgesprochen und vom
Browser falsch getrennt.
Terminologie folgt dem deutschen Verordnungstext, nicht einer wörtlichen Übersetzung des Englischen: Schwachstelle (nicht „Verwundbarkeit"), Unterstützungszeitraum (Art. 13 Abs. 8), Komponente, Begründung. Ein Leser mit der Verordnung in der Hand soll dieselben Wörter finden.
Die Disclaimer schwächen sich in der Übersetzung nicht ab. Jeder einzelne hat einen Test. Eine abgemilderte Einschränkung würde den deutschen Report mehr behaupten lassen als den englischen — der einzige Fehler, den eine Übersetzung hier nicht machen darf.
Interpolierte Strings sind Funktionen, keine Templates mit Platzhaltern: Deutsch stellt das Verb anders und bildet Plurale anders („in 1 Tag" / „in 5 Tagen", „braucht" / „brauchen").
Englisch bleibt, was Maschinenvokabular ist: die data-*-Attribute, auf die
das Filterskript matcht, die CSS-Klassen und der Kommentar-Marker, über den die
Action ihren eigenen Kommentar wiederfindet. Deren Übersetzung bräche das Filtern
nur auf Deutsch — die Art Fehler, die ein Release übersteht. Der eingebettete
JSON-Block ist in beiden Sprachen byte-identisch.
Drei Stufen, drei Absätze: Frühwarnung (Art. 14 Abs. 2 Buchst. a, 24 h), Schwachstellenmeldung (Buchst. b, 72 h), Abschlussbericht (Buchst. c, 14 Tage ab Verfügbarkeit einer Maßnahme, siehe Korrektur in §3.2). Meldeweg: ENISA und koordinierendes CSIRT, gleichzeitig (Abs. 1).
Was der Befehl nicht tut, ist der wichtigere Teil.
- Er entscheidet nicht, dass gemeldet werden muss. Art. 14 betrifft aktiv ausgenutzte Schwachstellen. cradle weiß, dass ein Advisory existiert und dass die Lockfile die betroffene Version auflöst. Ob jemand sie ausnutzt, kann kein Abhängigkeitsscanner wissen. Das steht oben in jedem Entwurf, nicht in einer Fußnote.
- Er übermittelt nichts. Er schreibt eine Datei. Ein Werkzeug, das auf einen Timer hin an eine Behörde postet, wäre die schlechteste Funktion in diesem Repository.
Gelesen wird findings.json, nicht das Netz: unter einer 24-Stunden-Frist darf
dieser Befehl nicht auf eine API warten, und so kann der Entwurf dem Report, den
er begleitet, nicht widersprechen. Alles, was eine Lockfile nicht beantworten
kann, ist ein sichtbarer [TO BE COMPLETED]-Platzhalter, und die Konsole zählt,
wie viele offen sind.
Ein CVSS-Basiswert beantwortet „wie schlimm wäre es". Triage unter einer Frist braucht „tut es jemand" — eine andere Frage, und bis hierher die einzige, die cradle nicht beantworten konnte.
check --sort exploit sortiert: bekannt ausgenutzt zuerst, dann EPSS, dann
Schwere. Ein Medium, über das CISA Belege hat, schlägt ein Critical, das niemand
angefasst hat — genau das Gegenteil dessen, was Sortierung nach Schwere sagt.
--fail-on bleibt CVSS-basiert. Ein Gate, dessen Schwelle sich täglich mit
dem Modell eines Dritten bewegt, wird über Nacht rot, ohne dass jemand im Team
etwas geändert hätte — und dann abgeschaltet.
Beide Quellen sind über CVE geschlüsselt, cradle über GHSA. Ein Finding ohne
CVE-Alias zeigt „keine Daten", nicht Null: „keine Daten" und „kein Risiko"
sind verschiedene Antworten. Ausfall einer Quelle wird benannt und der Scan läuft
weiter. Cache tagesweise neu geschlüsselt, weil beide Quellen es sind. Es
verlassen nur CVE-Kennungen die Maschine — kein Paketname, keine Version,
nichts über das Projekt. --no-priority schaltet beides ab, ohne offline zu
gehen.
check --format sarif: SARIF 2.1.0, das einzige Format, das GitHub Code
Scanning und GitLab (seit 19.2) einlesen. Damit braucht keine der beiden
Plattformen eine cradle-spezifische Integration.
- Direkte Abhängigkeit → Zeile in
package.json. Eine Annotation neben etwas, das man ändern kann, wird gelesen; eine auf Zeile 1 nicht. Transitiv → Lockfile, statt eine Zeile zu raten. - Fingerprint = Advisory + Paketname, ohne Version — dieselbe Identität wie die Baseline (§6.4), damit ein Patch-Bump eines weiterhin verwundbaren Pakets keine bereits abgetane Meldung wieder aufreißt.
security-severityträgt den berechneten CVSS-Basiswert, wo es einen gibt, sonst die Bandmitte — und der Hilfetext sagt, welches von beidem. Eine Bandmitte ist erkennbar ein Platzhalter; 7,4 sähe aus wie eine Messung.- Offline ⇒
executionSuccessful: false. Ein Dashboard muss „geprüft und nichts gefunden" von „nicht geprüft" unterscheiden können.
examples/gitlab-ci.yml trennt Evidenz-Job und Gate — nicht aus Stil: GitLab
liest einen Security-Report nur aus einem erfolgreichen Job, der Scan muss
also grün bleiben, auch an einem Tag, an dem das Gate rot ist. Das Gate liest den
Exit-Code explizit, statt jedes Nicht-Null als „verwundbar" zu lesen.
Die Leitprinzipien aus §2 stehen unverändert. Drei Einträge in §4 und §7 sind überholt und oben entsprechend markiert:
| War | Ist |
|---|---|
„Ein Report pro Repo. --workspace später." |
--workspace <name|all> umgesetzt (§16) |
| „SPDX als Ausgabeformat: kommt später" | --sbom-format spdx umgesetzt (§18.2) |
| „Abschlussbericht binnen 14 Tagen" | 14 Tage ab Verfügbarkeit einer Maßnahme (§3.2-Korrektur) |
Keine neue Runtime-Dependency. Die vier aus §4.1 sind unverändert: alles in
den Phasen 1–4 ist mit node:-Modulen, fetch und den vorhandenen vier gebaut.
Neu hinzugekommen sind ausschließlich Dev-Abhängigkeiten in Form vendorter
Schemata unter schema/ — CycloneDX 1.6/1.7, OpenVEX 0.2.0, SPDX 2.3, CSAF 2.0,
SARIF 2.1.0 und FIRSTs drei CVSS-Schemata. Das ist Absicht: ein Test, der ein
Schema aus dem Netz zieht, fällt aus, wenn die Seite eines Dritten ausfällt.
Keine Telemetrie. Unverändert und dauerhaft. Zwei neue Netzziele sind
hinzugekommen (api.first.org, www.cisa.gov, §18.5); beide erhalten
ausschließlich CVE-Kennungen, beide sind in SECURITY.md und im README
verzeichnet, beide sind über --offline oder --no-priority abschaltbar.
In jeder der vier Phasen ist dieselbe Entscheidung mehrfach wiedergekehrt, und sie ist der eigentliche rote Faden dieses Dokuments:
Eine plausibel aussehende falsche Antwort ist schlechter als eine ausdrückliche Nicht-Antwort.
Ausprägungen, jeweils mit Abschnitt:
- Yarn Berrys
checksumwird nicht als SHA-512 ausgegeben (§6.1). - Ein Lockfile-Shape, das nicht abbildbar ist, wird gemeldet statt verworfen (§15.1).
- pnpm lässt eine Komponente weg, deren Version nur ein Ort ist, statt eine purl zu erfinden (§15.3).
- Das BSI-Profil sagt
not assessablestatt zu raten, und nie „compliant" (§18.1). - Ein leeres CSAF-Dokument wird nicht geschrieben (§18.2).
- Die deutsche Übersetzung mildert keine Einschränkung ab (§18.3).
notifystellt nicht fest, dass gemeldet werden muss (§18.4).- Ein Finding ohne CVE zeigt „keine Daten", nicht Null (§18.5).
- SARIF meldet
executionSuccessful: falsefür einen Offline-Lauf (§18.6). - Der Release-Workflow bricht ab, statt Evidenz an ein fremdes Commit zu hängen (§14).
897 Tests. Die drei, die am meisten Fehler gefunden haben:
- Der Corpus (§ test/corpus) — fand den pnpm-Monorepo-Fehler am Tag seiner Entstehung, über eine unabhängig aus der Lockfile gezählte Komponentenzahl.
- Die Randfall-Fixtures (§15) — sieben echte Fehler, davon drei zuvor durch falsch geratene Fixtures verdeckt. Deshalb trägt jedes Fixture jetzt eine README mit Herkunft.
- Der Report-Fuzz (§ test/report/fuzz) — 30 Payloads durch alle Textfelder gleichzeitig. Gegenprobe dokumentiert: Quote-Escaping entfernt ⇒ fünf Tests rot, darunter echtes Attribut-Breakout-XSS.
Vollständige Liste dessen, was nicht gelöst ist:
- devDependencies eines Workspace-Mitglieds zählen als Produktion. Der gemeinsame Graph hat kein Per-Kante-dev-Flag; npm machte es so, pnpm zieht nach (§16, Parität nach §6.1). Fachlich diskutabel — was ein Mitglied für den Build braucht, wird nicht ausgeliefert.
cradle:expiresbricht die strenge OpenVEX-Validierung (§16 in CHANGELOG, Korrektur in §6.3). Der Trade steht im README; ohne--expiresvalidiert die Datei exakt.- SPDX-Export ist 2.3, BSI TR-03183-2 §4 verlangt ≥ 3.0.1 (§18.1). Die CycloneDX-1.6-Ausgabe erfüllt die Formatanforderung.
compositions[].aggregatewird nicht geschrieben (§18.1,component-dependenciesistpartial). Vollständigkeit hängt am Build, nicht an der Lockfile.check --workspace allgibt es nicht und wird ausdrücklich verweigert (§16.6).- Actions werden auf
@vNgepinnt, nicht auf SHA (§13.2). Kostet einen Scorecard-Unterpunkt. - Die Art.-14-Feldlisten stammen aus dem Verordnungstext über Sekundärquellen; EUR-Lex lieferte bei der Recherche HTTP 202. Fristen und Meldeweg sind über die Kommissionsseite abgesichert, die Feldinhalte pro Stufe sollten fachlich gegengelesen werden.