diff --git a/CHANGES.md b/CHANGES.md index c9dfe5c..39a7b00 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -52,13 +52,18 @@ concern - readable here, never shipped as something to parse. --- -## 5.1.1-beta.2 - 2026-09-12 - SKILL.md: relative Links durch repo-root-relative Pfade ersetzt, docs verify/instructions verify pruefen Linkziele +## 6.0.0-beta.1 - 2026-09-12 - docs verify: der Linkziel-Check erreicht auch die instanz-eigenen kb/CONVENTIONS.md und COLLECTION.md - daher Grenzuebertritt **Author:** Torben Nehmer +**Breaking Change:** docs verify loest ab dieser Version jeden relativen Markdown-Link in den Referenzdateien auf und meldet ein totes Ziel als Fehler - auch in kb/CONVENTIONS.md und kb//COLLECTION.md, die eine Instanz selbst besitzt und die ein Drop-in-Copy der Maschinerie nicht ersetzt. Eine Instanz, deren eigene Konventions- oder Collection-Datei einen relativen Link mit falscher ../-Tiefe oder auf eine inzwischen geloeschte Datei traegt, sieht docs verify nach dem Update fehlschlagen, wo es vorher durchlief. Reparatur: den in der Meldung genannten Datei:Zeile-Link korrigieren - kein Werkzeuglauf, keine Inhaltsmigration. + +**Migration:** none required - Keine kb/-Seite aendert ihre Form. Der Grenzuebertritt ist ein strengerer Check auf instanz-eigener Prosa, keine Schema- oder Frontmatteraenderung. + **High impact** - SKILL.md: relative Links durch repo-root-relative Pfade ersetzt, docs verify/instructions verify pruefen Linkziele +- docs verify: der Linkziel-Check erreicht auch die instanz-eigenen kb/CONVENTIONS.md und COLLECTION.md - daher Grenzuebertritt **Low impact** - gates.md/session-setup.md: die Budget-Ausnahme von version regrade haengt an der Aufrufform @@ -92,6 +97,26 @@ jeden relativen Link in den flachen Instructions und Contracts gegen den Arbeits `instructions/dev/doc-pull-through.md` hatte zwei Links mit falscher `../`-Tiefe, unabhaengig vom Skill-Copy-Problem. +### docs verify: der Linkziel-Check erreicht auch die instanz-eigenen kb/CONVENTIONS.md und COLLECTION.md - daher Grenzuebertritt + +Nachtraegliche Neueinstufung des Bumps darueber, kein zusaetzlicher Code. `check_reference_targets` +laeuft ueber den Dateisatz von `docs toc`, und fuenf Dateien darin gehoeren der Instanz statt dem +Stack: `kb/CONVENTIONS.md` und die vier `kb//COLLECTION.md`. Ein Drop-in-Copy von +`tools/`, `types/`, `instructions/` und `AGENTS.md` ersetzt sie nicht - ein toter relativer Link +darin laesst `docs verify` nach dem Update fehlschlagen, wo es vorher durchlief. Genau die Form, +die `tools/README.md` ยง Adding a command Schritt 5 als MAJOR-Zeile benennt ("a stricter check that +newly fails on shipped content an instance already had"), und `instructions/dev/version-parts.md` +entscheidet den Zweifelsfall zugunsten des Grenzuebertritts. + +Gemessen bricht heute nichts: die zweite bekannte Instanz traegt 25 relative Links in diesen fuenf +Dateien, davon null tote; dieses Repo ebenso. Die Einstufung folgt der Reichweite des Checks, nicht +einem beobachteten Schaden - der Preis einer unnoetigen MAJOR ist eine Release-Notiz, der Preis +einer MINOR, die doch bricht, ist eine Instanz mit fehlschlagendem Update-Pfad unter einer +Versionsnummer, die Drop-in versprochen hat. Aufgefallen ist es in der Schlussphase beim Lesen der +eigenen Regel in `tools/README.md`, nicht durch einen Check - was `docs/version-model.md` ueber +genau diese Stelle sagt ("a person looking at the diff ... not a validator"), hat sich hier +wiederholt. + --- ## 5.1.0 - 2026-09-12 - changelog: Kandidaten-Eintrag nach Impact gruppiert, version regrade zur Nachkorrektur, version release verlangt eine Zusammenfassung diff --git a/VERSION b/VERSION index 9e9bc26..1cd446a 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -5.1.1-beta.2 +6.0.0-beta.1