diff --git a/CHANGES.md b/CHANGES.md index 8250de9..31e6e01 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -35,7 +35,7 @@ dev-checkout concern - readable here, never shipped as something to parse. --- -## 5.0.0-beta.19 - 2026-09-11 - Breiten-Auslöser für Ingests: Extract-Pass statt einer Seite pro Namen, types/source.md nachgezogen +## 5.0.0-beta.20 - 2026-09-11 - stack-close Schritt 3: ein Doku-Nachzug in einen versionierten Pfad braucht seinen eigenen Bump **Author:** Torben Nehmer @@ -72,6 +72,7 @@ dev-checkout concern - readable here, never shipped as something to parse. - raw/*/.gitkeep-Glob in dist-upgrade-Doku auf den flachen raw/.gitkeep-Anker korrigiert - Breiten-Auslöser für Ingests: eine einzelne, thematisch breite Quelle bekommt einen Extract-Pass statt einer Seite pro Namen - Breiten-Auslöser für Ingests: Extract-Pass statt einer Seite pro Namen, types/source.md nachgezogen +- stack-close Schritt 3: ein Doku-Nachzug in einen versionierten Pfad braucht seinen eigenen Bump @@ -1450,6 +1451,25 @@ bestehenden `raw_files:`-Signal). Verifiziert: `tools/wikitool docs verify`, `instructions sync` für die generierten Regionen und die veröffentlichten Kopien. Schließt #61. +**`stack-close` Schritt 3 sagt jetzt, dass ein Doku-Nachzug seinen eigenen Bump braucht.** +Direkt aus dem vorigen Paket gelernt: dessen Abschlussphase zog `types/source.md` nach, ohne +`VERSION` zu bewegen, und CI-Run 249 fiel an der Version Gate um. Die Sitzung las den Nachzug +als Dokumentation - `types/source.md` ist aber beides, Dokument und ausgelieferte +Verhaltensbeschreibung, und die Gate ist nach Pfad gefasst, nicht nach Absicht +(`^(tools/|types/|instructions/|AGENTS\.md$|[^/]+/CONTRACT\.md$)`). + +Das ist kein Ausrutscher, sondern eine Reihenfolge, die sich wiederholt: `stack-dev` Schritt 4 +bumpt die eigentliche Änderung, und Schritt 3 dieses Skills läuft *danach* - in genau den +Pfaden, die die Gate bewacht. Schritt 3 trägt den Satz deshalb jetzt selbst, samt der Falle +("nur Dokumentation") und des Auswegs (`version bump --patch` im selben Zug, was beim laufenden +Kandidaten ohnehin nur den Zähler bewegt). Nicht nach `doc-pull-through.md` gelegt, obwohl es +dort thematisch auch passte: die Entscheidung fällt in dem Schritt, der den Commit auslöst, und +zwei Kopien wären die Dopplung, die Invariante 8 verbietet. + +Geändert: `instructions/dev/stack-close/SKILL.md` (Schritt 3). Verifiziert: +`tools/wikitool docs verify`, `tools/wikitool instructions verify`, volle `pytest`-Suite, +`instructions sync` für die veröffentlichte Kopie. Kein Issue - direkt korrigiert. + --- ## 4.7.4 - 2026-09-04 - bootstrap.md nennt den session-id-WARN nach frischem Bootstrap explizit als erwartet diff --git a/VERSION b/VERSION index d486cc7..b48e7d0 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -5.0.0-beta.19 +5.0.0-beta.20 diff --git a/instructions/dev/stack-close/SKILL.md b/instructions/dev/stack-close/SKILL.md index ba54d38..f4e977d 100644 --- a/instructions/dev/stack-close/SKILL.md +++ b/instructions/dev/stack-close/SKILL.md @@ -86,6 +86,17 @@ and a fresh subagent starts without the session's context). behaviour one of these documents describes, update it now; if none did, say so rather than leaving the question unasked. + **A pull-through of its own needs its own bump.** This phase runs *after* `stack-dev` step 4 + has already bumped the version, and the documents it touches are frequently the ones CI's + version gate watches - `types/`, `instructions/`, `tools/`, `AGENTS.md`, any + `/CONTRACT.md`. A commit into one of those without a `VERSION` line fails the gate + (`.gitea/workflows/ci.yml`, "Version gate"), whatever the session meant it as. Reading the + edit as "only documentation" is the trap: `types/source.md` is a document *and* a shipped + behaviour description, and the gate is scoped by path, not by intent. So run + `tools/wikitool version bump --patch` in the same breath as the pull-through commit - it + only advances the running candidate's counter - rather than discovering it from a red run + after the issue is already closed. + 4. **Name which model ran which phase - not only this one.** This is the handover in full, not a note about the tail alone: state the model for the design/version-part/boundary-judgment phase (`stack-dev` step 3), for the mechanical middle (code, tests, the version bump), and for