• v4.3.0 0b8ca746fa

    v4.3.0
    CI / verify (push) Successful in 49s
    Release / release (push) Successful in 36s
    Stable

    torben released this 2026-09-03 17:04:16 +00:00 | 76 commits to main since this release

    4.3.0 - 2026-09-03 - docs/ als ausgelieferter Hintergrund-Ort; Decision-Seiten bleiben in kb/, Decay-Skip fuer concept_type: decision

    Author: Torben Nehmer

    Gitea #38: dist export lieferte bislang keine einzige kb/-Seite aus - eine frische Instanz
    bekam den Stack, aber keinen Grund für seine Form. Die dokumentierte adr-NNN--Konvention in
    kb/concepts/COLLECTION.md existierte zudem nur auf Papier: keine der sieben
    concept_type: decision-Seiten folgte ihr, und confidence_decay() lief bedingungslos über sie

    • ein Kategorienfehler, weil Zeitablauf eine Entscheidung nicht falscher macht, nur Supersession
      tut das.

    Neu: docs/ - ein inertes Verzeichnis für Stack-Hintergrund (warum der Stack so gebaut ist,
    nicht was diese Instanz entschieden hat). Keine Frontmatter, kein Typ, kein Index, kein Lint,
    keine Decay, keine Provenance, keine COLLECTION.md. dist export liefert es verbatim aus, wie
    instructions/ und types/. Befüllung folgt in Gitea #45.

    Verworfen, nach Prüfung: ein Umzug der sieben Decision-Seiten nach decisions/. Der
    Subtyp-Floor aus #28 verlangt mindestens eine Seite je deklariertem concept_type, und ein
    Umzug hätte decision auf null gebracht; dazu zeigen 89 Wikilinks aus kb/ sowie
    tool-eigene Frontmatter-Arrays auf die sieben, und links.py/xref add kennen kein Ziel
    außerhalb kb/. Die sieben bleiben in kb/concepts/, ebenso ein zweiter, separat erwogener
    Rename (docs verifyparity verify) - der wäre nur nötig gewesen, wenn ein Befehl auf das
    Verzeichnis docs/ wirkt, und keiner tut das.

    Geändert:

    • confidence_decay() überspringt concept_type: decision strukturell (kategorische Ausnahme,
      nicht als Brücke gebaut - Begründung im Docstring).
    • kb/concepts/COLLECTION.md § Decisions ersetzt die tote ADR-Vorlage durch die real gelebte
      Form: eine Entscheidung ist eine gewöhnliche Concept-Seite, organische Prosa, kein
      adr-NNN--Präfix, **Status:** optional, Supersession per supersedes-Link.
    • kb/CONVENTIONS.md § Naming und instructions/kb-profiles.md (Profil german) korrigiert -
      beide dokumentierten noch die verworfene adr-NNN--Namensregel.
    • AGENTS.md § File naming und § Routing: docs/-Zeile, plus die Regel, dass docs/ keinen
      normativen Satz trägt (das hält Invariante 8 heil - was binden würde, gehört in einen
      Contract).
    • tools/CONTRACT.md: Klarstellung, dass docs verify Dokumentations-Parität prüft, nicht das
      docs/-Verzeichnis, sowie docs/ in der dist export-Zeile ergänzt.

    Additiv und in beide Richtungen drop-in: eine bestehende Instanz ohne docs/ exportiert
    weiterhin identisch (leerer _copy_tree-Treffer), eine Instanz mit docs/ bekommt es ab jetzt
    mitgeliefert. Kein Feld, kein Kommando ändert sein Verhalten für bestehenden Inhalt.

    Migration: none required.

    Berührt: tools/chemenu/commands/confidence_decay.py, tools/chemenu/commands/dist_cmd.py,
    tools/chemenu/tests/test_confidence_decay.py, tools/chemenu/tests/test_dist_cmd.py,
    kb/concepts/COLLECTION.md, kb/CONVENTIONS.md, instructions/kb-profiles.md, AGENTS.md,
    tools/CONTRACT.md.

    Downloads