ingest: raw/notes/Conversation Transcript - Version Part Nomenclature and Breaking Change Gate Session 2026-09-02.md

Files changed:
- kb/concepts/INDEX.md
- kb/concepts/KB Stack Versioning.md
- kb/entities/INDEX.md
- kb/entities/projects/Chemenu.md
- kb/entities/tools/wikitool.md
- kb/index.md
- kb/log.md
- kb/sources/INDEX.md
- kb/sources/Source - Version Part Nomenclature and Breaking Change Gate Session 2026-09-02.md
- raw/notes/Conversation Transcript - Version Part Nomenclature and Breaking Change Gate Session 2026-09-02.md

kb/sources/INDEX.md

@@ -2,7 +2,7 @@
 
 # kb/sources/ - Index
 
-26 page(s). Regenerated by `wikitool index rebuild`.
+27 page(s). Regenerated by `wikitool index rebuild`.
 
 ## All
 
@@ -33,5 +33,6 @@
 | [[Source - Public Release, Corpus Purge and History Squash Session 2026-09-01]] | notes | Sitzung, die den Chemenu-Stack von einer privaten Testinstanz in ein oeffentliches Repo ueberfuehrt: Korpus geloescht statt anonymisiert, Git-History auf einen Commit gesquashed, AGPL-3.0/CC-BY-4.0-Dual-Lizenz gewaehlt, dist export um einen Leak-Canary gehaertet. | 2026-09-01 |
 | [[Source - Publish-Remote Gate and Issue Triage Session 2026-09-01]] | notes | Sitzung, die ein drittes, Token-loses Gate fuer publish baut, instructions/private-instance.md schreibt, sechs Gitea-Issues auf den Rename und die neue Architektur nachzieht und die Actions-Run-Historie entfernen laesst. | 2026-09-01 |
 | [[Source - qmd - GitHub Repository]] | document | GitHub-API-Metadaten, package.json und README-Auszuege von tobi/qmd: TypeScript/Node/Bun statt Go oder Rust, BM25 (SQLite FTS5) plus Vektor-Suche (sqlite-vec) plus LLM-Reranking ueber node-llama-cpp. | 2026-09-02 |
+| [[Source - Version Part Nomenclature and Breaking Change Gate Session 2026-09-02]] | notes | Sitzung, die die Versionsstelle als Kompatibilitaets- statt Migrationsfrage praezisiert und einen Freigabe-Ablauf fuer Breaking Changes in stack-dev einfuehrt | 2026-09-02 |
 | [[Source - Wine]] | notes | Wine-Konfiguration für Arch Linux: pacman-NoExtract-Einstellungen und Bottles-Runtime-Optionen einschließlich Proton- und Lutris-Varianten. | 2026-08-01 |
 

kb/sources/Source - Version Part Nomenclature and Breaking Change Gate Session 2026-09-02.md

@@ -0,0 +1,75 @@
+---
+type: types/source.md
+source_type: notes
+author: Torben Nehmer
+raw_files: [raw/notes/Conversation Transcript - Version Part Nomenclature and Breaking Change Gate Session 2026-09-02.md]
+source_language: de
+date: 2026-09-02
+tags: []
+entities: [wikitool, Chemenu]
+concepts: [KB Stack Versioning]
+summary: Sitzung, die die Versionsstelle als Kompatibilitaets- statt Migrationsfrage praezisiert und einen Freigabe-Ablauf fuer Breaking Changes in stack-dev einfuehrt
+---
+# Source: Version Part Nomenclature and Breaking Change Gate Session 2026-09-02
+
+**Autor:** Torben Nehmer  
+**Datum:** 2026-09-02  
+**Raw-Dateien:** raw/notes/Conversation Transcript - Version Part Nomenclature and Breaking Change Gate Session 2026-09-02.md  
+**Typ:** Notes
+
+## Zusammenfassung
+
+Umsetzung von Gitea-Issue #26: Die Doku des Stacks führte für die Wahl der Versionsstelle zwei
+Fragen zusammen, die nicht dieselbe sind - ob der Korpus migriert werden muss, und ob der
+Wechsel ein Drop-in-Ersatz ist. Nur `version bump --help` unterschied korrekt; die drei
+prosaischen Stellen (`stack-dev`, `version.py`-Docstring, `INSTALL.md`) beschrieben MAJOR als
+Migrationsfrage. Der `2.0.0`-Rebranding-Bump hatte genau daran zuerst `1.9.0` statt `--major`
+angesetzt.
+
+Der Nutzer schärfte die Regel während der Sitzung zu einem konkreten zweiseitigen Test nach:
+"die neue version ist kein drop-in replacement. Sobald irgendwie Hand angelegt werden muss, sei
+es durch den user oder durch ein Migrationsscript, ist es ein major version change. selbiges
+gilt, wenn ein update nicht rückgängig gemacht werden kann [...] in allen Fällen muss bei einem
+Major version change ein 'Breaking Change' vermerkt werden. breaking changes sind damit teuer.
+passe stack-dev so an, dass in diesen Fällen zwingend der user informiert, Alternativen
+aufgezeigt und eine freigabe eingeholt wird." Zwei Auswahlentscheidungen davor: Durchsetzung im
+Code statt reiner Prosa (weil Prosa bereits einmal gedriftet war), und die Freigabe als
+"Decision point" statt als Gate-Sprache, um die drei echten code-erzwungenen Gates nicht zu
+verwässern.
+
+## Kernaussagen
+
+- Kompatibilität (Drop-in-Ersatz, vorwärts wie rückwärts) und Inhaltsmigration sind zwei
+  unabhängige Fragen; MAJOR beantwortet die erste, `--no-migration`/ein Migrationsdokument die
+  zweite.
+- Ein Grenzübertritt kann `kb/` völlig unangetastet lassen und trotzdem MAJOR sein - Katalog:
+  Update-Pfad, Release-Artefaktname, Paket-Import-Name, ein umbenanntes Kommando/Flag/Envvar,
+  die Shape einer maschinengelesenen Datei.
+- Ein Breaking Change ist teuer (jede bestehende Instanz zahlt einmal, von Hand) und deshalb
+  genehmigungspflichtig: Bruch, Handarbeit je Instanz und Alternativen (Shim, aufschieben und
+  bündeln, aufspalten mit Deprecation-Fenster) vorlegen, dann Freigabe abwarten.
+- Reine Prosa-Regeln drifted - deshalb wurde `--breaking` als Pflichtflag samt zweiter, von der
+  Migrationsprüfung unabhängiger `docs verify`-Prüfung eingeführt, nicht nur eine Textänderung.
+
+## Aufgaben
+
+Keine offenen Aufgaben aus dieser Sitzung - Issue #26 wurde in derselben Sitzung geschlossen,
+mit Verweis auf Commit `31662dc` (`2.5.0`).
+
+## Nicht übernommen
+
+- Die vollständige Katalog-Tabelle und der `2.0.0`-Fallbeispiel-Text aus
+  `instructions/dev/version-parts.md` werden hier nicht wiederholt - die Datei ist die
+  autoritative Quelle (Instruktions-Layer, `manual`-artig durch die `instructions/dev/`-Grenze),
+  diese Source-Seite fasst nur zusammen, was zur Entscheidung führte.
+- Der genaue Wortlaut der Tool-Fehlermeldungen (`version bump`-Refusals) steht im Transkript
+  selbst; hier nur die Regel dahinter.
+
+## Verwandte Entities
+
+- [[wikitool]]
+- [[Chemenu]]
+
+## Verwandte Concepts
+
+- [[KB Stack Versioning]]