@renoxar/koolie 1.25.0

package/.koolie/core/governance/change-requests/CR-2026-168-paketquellen.md

@@ -0,0 +1,64 @@
+# Änderungsantrag `CR-2026-168`
+
+| Feld | Inhalt |
+|---|---|
+| Titel | Installation über Paketquellen mit dem Banner – und die Gegenprobe, die zehn Fehler für null hielt |
+| Antragstellende Rolle | `<FRAMEWORK_OWNER>` |
+| Datum | 2026-09-30 |
+| Betroffene Artefakte | `paketquellen/` (neu: `bauen.py`, `koolie_befehl.py`, `koolie.cmd`, `npm/koolie.js`, `README.md`), `governance/RELEASE_PROCESS.md` (Abschnitt 4.2), `tests/scripts/pruefungen/werkzeuge.py` (Prüfung 112), `tests/scripts/validate-framework.py`, `tests/scripts/sonden/teil17_paketquellen.py` (neu), `tests/scripts/sonden/apparat.py`, `tests/scripts/probe-pruefungen.py`, `docs/ROADMAP.md` |
+| Ebene laut Entscheidungsbaum 6 | Framework Core (Werkzeuge, Validator, Release-Prozess) |
+| Art | Neuer Lieferweg und neue Prüfung; MINOR-Release ohne Kontingent, ohne Änderung der Laufzeitschicht |
+| Dringlichkeit | geplant (`K-155`, Auftrag des Owners vom 2026-09-30) |
+| Status | 🟢 **entschieden am 2026-09-30** (E1 bis E9) |
+
+---
+
+## 1. Anlass
+
+Der Owner nimmt `K-155` wieder auf, mit D-467 ohne Ziel zurückgestellt: Koolie soll über Paketquellen installierbar werden – winget, npm, PyPI mit pipx, Scoop, Homebrew, Chocolatey. Bedingung: Auch auf diesen Wegen erscheint das Banner aus `1.20.3` (`banner.py`, D-506, `CR-2026-165`). Veröffentlicht wird nichts ohne ausdrückliche Freigabe des Owners.
+
+## 2. Vorprüfung
+
+Vorgelegt am 2026-09-30 mit Schätzung: 0 Sitzungsläufe, 0 USD, rund 24 lokale Installationsläufe, Deckel 40. Die Vorlage liegt außerhalb des Repositoriums. Der Owner folgt den Empfehlungen. Vor der Vorlage erhoben:
+
+- **Download-Adresse:** Der GitHub-Spiegel trägt 13 Releases mit Archiv und Prüfsumme; die SHA-256 von `v1.21.0` dort ist die des lokalen Archivs.
+- **Namen:** `koolie` ist auf PyPI, TestPyPI, npm, Chocolatey, Homebrew, Scoop (Main, Extras) und winget frei.
+- **Terminal beim Installieren**, gemessen mit einer Sonde in einer echten, verborgenen Konsole: pip führt beim Installieren eines Wheels nichts aus; npm gibt `postinstall` kein Terminal und verschluckt die Ausgabe; Chocolatey gibt seinem Skript kein Terminal, zeigt die Ausgabe aber als Text; der installierte Befehl hat bei pip und npm ein Terminal. winget installiert still und verlangt für den Typ „portable“ eine `.exe`.
+
+## 3. Vorlage zur Entscheidung
+
+| # | Frage | Entscheidung | Preis |
+|---|---|---|---|
+| E1 | Welche Paketquellen? | PyPI, npm und Scoop bauen und messen, Homebrew bauen; Chocolatey und winget ohne Ziel (`K-204`) (D-518) | Windows bleibt bei pip, npm und Scoop |
+| E2 | Wo erscheint das Banner? | Im Befehl `koolie`; kein Code im Installationsschritt der Paketquelle (D-519) | Wer nur installiert, sieht es erst beim ersten Aufruf |
+| E3 | Was tut der Befehl? | Ohne Argumente der Dialog, mit Argumenten Banner und `install.py` unverändert, `--version`; Prüfung 112 (D-519) | Ein zweiter Einstieg neben den Startern |
+| E4 | Wo liegen Befehl und Bau? | `paketquellen/` in der Wurzel, nicht im Kern; kein `pyproject.toml` (D-520) | Ein neuer Ordner in der Wurzel des Frameworks |
+| E5 | Was tragen die Pakete? | Genau den Baum des Release-Archivs; Scoop und Homebrew laden das Archiv und prüfen die SHA-256 (D-520) | Wheel rund 4 MB |
+| E6 | Lieferkette? | Später Trusted Publishing aus GitHub Actions am Spiegel; jetzt keine Workflow-Datei (D-521) | Keine Veröffentlichung bis zur Freigabe |
+| E7 | Release-Prozess? | Bauen und Nachprüfen der Pakete in jedem Release; Veröffentlichen als ruhender Schritt (D-521) | Ein Schritt mehr je Release |
+| E8 | Roadmap und Namen? | `1.22.0` = Paketquellen, Modusbindung auf `1.23.0`, erste Veröffentlichung als eigener Posten; Name überall `koolie` (D-518) | Der Name ist nicht reserviert |
+| E9 | Befund am Sondenapparat | Die Gegenprobe liest die Ergebniszeile (D-522) | – |
+
+## 4. Umsetzung
+
+1. **Befehl:** `paketquellen/koolie_befehl.py` (Dialog, Banner vor `install.py`, `--version`, `--no-banner`); Hüllen `paketquellen/koolie.cmd` (Scoop) und `paketquellen/npm/koolie.js` (npm, sucht Python ab 3.8, erbt das Terminal).
+2. **Bau:** `paketquellen/bauen.py` baut aus dem Release-Archiv Wheel, npm-Paket, Scoop-Manifest und Homebrew-Formel mit `SHA256SUMS`, bytegleich wiederholbar, und prüft selbst nach: Dateimenge gleich dem Archiv, Version, `RECORD`, Ziele der Befehle, kein npm-Installationsskript, Prüfsumme in beiden Manifesten.
+3. **Prüfung 112** in `pruefungen/werkzeuge.py`, nur im Quellrepositorium; Sondenteil 17 (`112a` bis `112f`).
+4. **Befund am Apparat:** `apparat.fehlerfrei()` liest die Ergebniszeile (D-522).
+5. **Release-Prozess** Abschnitt 4.2, **Roadmap**, `paketquellen/README.md`.
+
+## 5. Entscheidung
+
+🟢 **Angenommen am 2026-09-30.**
+
+| # | Entscheidung | Decision Record |
+|---|---|---|
+| E1, E8 | Umfang, Roadmap, Namen | D-518 |
+| E2, E3 | Das Banner im Befehl, Prüfung 112 | D-519 |
+| E4, E5 | Ort, Bau und Inhalt | D-520 |
+| E6, E7 | Lieferkette und Release-Prozess | D-521 |
+| E9 | Die Gegenprobe liest die Ergebniszeile | D-522 |
+
+## 6. Messung und Belege
+
+Protokoll `tests/protocols/2026-09-30-paketquellen.md`. Kein Sitzungslauf, 0 USD. Lokal: 13 Paketinstallationen (Sonden und Pakete), 40 Aufrufe des Befehls in vier Wegen, 4 Ende-zu-Ende-Installationen in ein Wegwerfprojekt. Erhebungsablage `leitwerk-erhebungen-2026-09-30-1220` außerhalb des Repositoriums.

package/.koolie/core/governance/change-requests/CR-2026-169-modusbindung-messfragen.md

@@ -0,0 +1,58 @@
+# Änderungsantrag `CR-2026-169`
+
+| Feld | Inhalt |
+|---|---|
+| Titel | Modusbindung M3 bis M5 und die offenen Messfragen – und der Befehl im Folgeturn, den es nicht gab |
+| Antragstellende Rolle | `<FRAMEWORK_OWNER>` |
+| Datum | 2026-10-01 |
+| Betroffene Artefakte | `mandat.py`, `tests/scripts/hook-check-secrets.py`, `tests/scripts/pruefungen/berechtigungen.py` (Prüfung 99), `tests/scripts/sonden/teil18_modusbindung_m3_m5.py` (neu), `tests/scripts/probe-pruefungen.py`, `framework/runtime/rules/00-framework-core.md`, `framework/core/05-working-model.md`, `build/doc/29-grenzen.md`, `clients/claude-code/CLIENT_PACK.md`, Testblätter `fw-change-analyze`, `fw-plan`, `fw-bugfix-prepare`, `fw-refactor` (Stand bestätigt), `onboarding/exercises/README.md`, `docs/ROADMAP.md` |
+| Ebene laut Entscheidungsbaum 6 | Framework Core (Schutzschicht, Arbeitsmodell, Testblätter) |
+| Art | Erweiterte technische Durchsetzung und Messung; MINOR-Release mit Kontingent; die Laufzeitschicht ändert einen Satz ohne neue Zeile |
+| Dringlichkeit | geplant (`K-201`, `K-186`, `K-202`, `K-203`; Roadmap-Zeile `1.23.0`, D-518) |
+| Status | 🟢 **entschieden am 2026-10-01** (E1 bis E8) |
+
+---
+
+## 1. Anlass
+
+Nach `1.22.0` stehen in einem Release zusammen: die Bindung der Modi M3 bis M5 an den Schutz-Hook (`K-201`), die drei offenen Messfragen aus `1.18.0` (`K-186` (1), (4), (5)), der Auftrag gegen die Regel ohne technische Schicht (`K-202`) und, bei Bedarf, die Erweiterung der Vergleichsmessung (`K-203`).
+
+## 2. Vorprüfung
+
+Vorgelegt am 2026-10-01 mit Schätzung (rund 24 Läufe `claude-code`, rund 11 USD, Deckel 30 Läufe und 20 USD); die Vorlage liegt außerhalb des Repositoriums. Der Owner folgt den Empfehlungen. Vor der Vorlage gelesen: Der Leseweg für die Pfadlisten besteht schon (`mandat.py abgleichen`, D-452); die Werte der drei gemessenen Overlays haben drei Gestalten, darunter einen Glob mitten im Pfad – ein Präfixvergleich wie bei M2 trägt sie nicht; Regel 00 nennt die Bindung in einem Satz, der sich ohne neue Zeile umformulieren lässt.
+
+## 3. Vorlage zur Entscheidung
+
+| # | Frage | Entscheidung | Preis |
+|---|---|---|---|
+| E1 | Wie kommt der Hook an die Pfadliste? | `mandat.py modus` kopiert sie beim Binden in die Bindung, dazu `<READ_ONLY_PATHS>`; der Hook liest das Overlay nicht (D-523) | Momentaufnahme bis zum nächsten Binden |
+| E2 | Wie wird ein Glob ausgewertet? | `**`, `*`, `?`, ohne Joker genau die Datei, ohne Groß- und Kleinschreibung; jede Lesart muss im Projekt liegen; Nur-Lese-Pfade bleiben gesperrt (D-523) | Klammern und Mengen gelten wörtlich |
+| E3 | M3 mit engerem Scope? | `--umfang`, ausgewertet als Schnittmenge mit `<ALLOWED_PATHS>`; leere oder offene Liste bindet nicht (D-523) | – |
+| E4 | Prüfung? | Keine neue Nummer: Prüfung 99 vergleicht den Rumpf von `glob_muster` in Hook und `mandat.py`; Sondenteil 18 (D-523) | Abweichung von der Vorlage, die Prüfung 113 vorsah |
+| E5 | `K-186` (1) und (4) | Neue Zelle `SK-003-P05`, Nachstellung von `SK-009-P01`; keine Anweisungsänderung; die Kappung nach Aktualität wird `K-207` (D-524) | – |
+| E6 | `K-186` (5) | Der Beleg war eine Fehllesung; die Sperre eines Skills gilt nur in seinem Turn – benannte Grenze in S3 (D-525) | – |
+| E7 | `K-202` | Auf `cursor` und `openai-codex` ausgedehnt; nicht reproduziert, geklärt (D-526) | Zwei Läufe `cursor` unerhoben |
+| E8 | `K-203` | Nicht in diesem Release, ohne Ziel – kein Bedarf aus einem Projekt | – |
+
+## 4. Umsetzung
+
+1. **Bindung:** `mandat.py modus M3|M4|M5` mit `--umfang`; Hook `glob_muster` und `modus_erlaubt`; `MODUS_GEBUNDEN` in beiden Dateien auf M1 bis M5.
+2. **Prüfung 99** vergleicht den Rumpf von `glob_muster`; Sondenteil 18 (`K201a` bis `K201n`).
+3. **Texte:** Regel 00 Zeile 31 (ein Zeichen kürzer), `05-working-model.md` M3 bis M5, Hauptdokument Kapitel 29, Fähigkeitsmatrix `claude-code` (Zeilen M4 und S3).
+4. **Testblätter:** `SK-003-P05` neu, `SK-004-N04` berichtigt, `SK-009-P01` nachgestellt, Stand von `SK-007-N06` bestätigt; Übungsregister `UEB-33`, `UEB-34`.
+
+## 5. Entscheidung
+
+🟢 **Angenommen am 2026-10-01.**
+
+| # | Entscheidung | Decision Record |
+|---|---|---|
+| E1 bis E4 | Die Modusbindung M3 bis M5 | D-523 |
+| E5 | Suche und Beifund gemessen | D-524 |
+| E6 | Die Sperre eines Skills im Folgeturn | D-525 |
+| E7 | Auftrag gegen die Regel | D-526 |
+| E8 | Vergleichsmessung | – (`K-203` bleibt offen) |
+
+## 6. Messung und Belege
+
+Protokoll `tests/protocols/2026-10-01-modusbindung-messfragen.md`. 21 Sitzungsläufe `claude-code`, 11,08 USD (5 verworfen, Messaufbau); `cursor` 1 Lauf, `openai-codex` 3 Läufe. Erhebungsablage `leitwerk-erhebungen-2026-10-01-1230` außerhalb des Repositoriums.

package/.koolie/core/governance/change-requests/CR-2026-170-erste-veroeffentlichung.md

@@ -0,0 +1,62 @@
+# Änderungsantrag `CR-2026-170`
+
+| Feld | Inhalt |
+|---|---|
+| Titel | Die erste Veröffentlichung auf PyPI und npm – und die beiden Tokens, die eines waren |
+| Antragstellende Rolle | `<FRAMEWORK_OWNER>` |
+| Datum | 2026-10-01 |
+| Betroffene Artefakte | `paketquellen/bauen.py`, `paketquellen/README.md`, `README.md`, `README.en.md`, `QUICKSTART.md`, `QUICKSTART.en.md`, `governance/RELEASE_PROCESS.md` (Abschnitt 4.2, Schritt 9), `tests/scripts/pruefungen/werkzeuge.py` (Prüfung 112), `tests/scripts/validate-framework.py`, `tests/scripts/sonden/teil17_paketquellen.py`, `docs/ROADMAP.md` |
+| Ebene laut Entscheidungsbaum 6 | Framework Core (Werkzeuge, Validator, Release-Prozess) und Einstieg des Repositoriums |
+| Art | Erste Veröffentlichung über Paketquellen; MINOR-Release ohne Kontingent, ohne Änderung der Laufzeitschicht |
+| Dringlichkeit | geplant (`K-155`, Freigabe des Owners vom 2026-09-30, verkleinert am 2026-10-01) |
+| Status | 🟢 **entschieden am 2026-10-01** (E1 bis E7) |
+
+---
+
+## 1. Anlass
+
+`1.22.0` hat die Pakete gebaut und nichts veröffentlicht (D-521); die Zugänge des Owners fehlten am Arbeitsplatz. Am 2026-10-01 sind `PYPI_TOKEN`, `TESTPYPI_TOKEN` und `NPM_TOKEN` als Benutzervariablen gesetzt. Der Owner verkleinert die Freigabe: *„Die anderen Paketquellen würde ich gern nochmal zurückstellen“* – veröffentlicht werden nur PyPI und npm, TestPyPI zuerst mit Installationsprobe, vor dem ersten echten Hochladen je Quelle eine Rückfrage.
+
+## 2. Vorprüfung
+
+Vorgelegt am 2026-10-01 mit Schätzung: 0 Sitzungsläufe, 0 USD, rund 3,5 bis 4 Stunden Arbeit, dazu zwei Freigaben und die Signatur des Owners. Der Owner folgt den Empfehlungen. Vor der Vorlage erhoben:
+
+- **Namen:** `koolie` ist auf PyPI, TestPyPI und npm frei (HTTP 404 auf die Paketadressen).
+- **Zugänge:** Alle drei Benutzervariablen sind gesetzt; `npm whoami` mit dem Token meldet das Konto des Owners. Für PyPI gibt es keine Anmeldeprobe ohne Hochladen.
+- **Die Pakete von `1.23.0`:** Metadaten richtig; die Beschreibung trägt 32 relative Links, die auf pypi.org ins Leere führen, und das npm-Paket zeigt die deutsche `README.md`.
+- **Werkzeuge:** npm 11.12.1, uv 0.11.9 (`uv publish`); `twine` fehlt am Arbeitsplatz und läuft für `twine check` aus einer Wegwerfumgebung.
+
+## 3. Vorlage zur Entscheidung
+
+| # | Frage | Entscheidung | Preis |
+|---|---|---|---|
+| E1 | Wie wird hochgeladen? | Mit den Tokens des Owners vom Arbeitsplatz (`uv publish`, `npm publish`); Trusted Publishing ohne Ziel (`K-210`) (D-527) | Keine Attestierung, keine Provenienz |
+| E2 | Welche Version zuerst? | `1.24.0`, neu gebaut – nicht die Pakete von `1.23.0` (D-527) | Ein Release mehr vor der ersten Veröffentlichung |
+| E3 | Wie läuft die Probe auf TestPyPI? | Vor der Signatur `1.24.0.dev1` aus dem Arbeitsbaum mit Installationsprobe; nach der Signatur das endgültige Wheel auf TestPyPI, dann dieselben Bytes auf PyPI. npm: Trockenlauf und Installation aus der `.tgz` (D-529) | Vorabversionen bleiben auf TestPyPI |
+| E4 | Was zeigen die Paketseiten? | `README.en.md` mit absoluten Links auf die Marke; npm über das Feld `readme` (D-528) | Die Links tragen erst mit der Marke auf dem Spiegel |
+| E5 | Was sagen README und Quickstart? | Die Paketquellen als gleichwertiger Weg neben dem Starter (D-531) | Zwei Wege in der Dokumentation |
+| E6 | Release-Prozess? | Schritt 9 für PyPI und npm ab `1.25.0` mit der Signatur freigegeben; Scoop und Homebrew ruhen (D-530) | Signieren heißt veröffentlichen |
+| E7 | Roadmap und Zugänge | Posten auf PyPI und npm verkleinert; Scoop und Homebrew `K-209`, Trusted Publishing `K-210`. Empfehlung an den Owner: das PyPI-Token nach dem ersten Hochladen durch eines nur für das Projekt `koolie` ersetzen, für npm ein granulares Token mit Ablauf (D-527) | – |
+
+## 4. Umsetzung
+
+1. **Bau:** `paketquellen/bauen.py` schreibt die Links der Beschreibung absolut (`beschreibung()`), gibt sie npm im Feld `readme` mit und baut mit `--vorab N` eine Vorabversion; die Nachprüfung meldet einen relativen Link in METADATA oder `readme` und eine Vorabversion, die die Version der Marke trüge.
+2. **Prüfung 112** baut zusätzlich mit `--vorab 1`; Sondenteil 17 um `112g` und `112h` erweitert.
+3. **Einstieg:** README und Quickstart, deutsch und englisch.
+4. **Release-Prozess** Abschnitt 4.2 Schritt 9, **Roadmap**, `paketquellen/README.md`.
+
+## 5. Entscheidung
+
+🟢 **Angenommen am 2026-10-01.**
+
+| # | Entscheidung | Decision Record |
+|---|---|---|
+| E1, E2, E7 | Zuschnitt, Zugänge, Version | D-527 |
+| E4 | Die Beschreibung auf den Paketseiten | D-528 |
+| E3 | TestPyPI zuerst, mit Vorabversion | D-529 |
+| E6 | Schritt 9 mit der Signatur freigegeben | D-530 |
+| E5 | README und Quickstart | D-531 |
+
+## 6. Messung und Belege
+
+Protokoll `tests/protocols/2026-10-01-erste-veroeffentlichung.md`. Kein Sitzungslauf, 0 USD. Erhebungsablage `leitwerk-erhebungen-2026-10-01-1240` außerhalb des Repositoriums. 🔴 Befund vor dem ersten Hochladen: `TESTPYPI_TOKEN` und `PYPI_TOKEN` trugen dasselbe Token für pypi.org; TestPyPI wies es mit 403 ab.

package/.koolie/core/governance/change-requests/CR-2026-171-befehl-im-projektverzeichnis.md

@@ -0,0 +1,57 @@
+# Änderungsantrag `CR-2026-171`
+
+| Feld | Inhalt |
+|---|---|
+| Titel | Der Befehl im Projektverzeichnis – und die Probe, die nur fragte, ob er startet |
+| Antragstellende Rolle | `<FRAMEWORK_OWNER>` |
+| Datum | 2026-10-01 |
+| Betroffene Artefakte | `install_dialog.py` (`--vorgabe`), `paketquellen/koolie_befehl.py`, `paketquellen/README.md`, `README.md`, `README.en.md`, `QUICKSTART.md`, `QUICKSTART.en.md`, `governance/RELEASE_PROCESS.md` (Abschnitt 4.2), `tests/scripts/pruefungen/werkzeuge.py` (Prüfung 112), `tests/scripts/validate-framework.py`, `tests/scripts/sonden/teil17_paketquellen.py`, `docs/ROADMAP.md` |
+| Ebene laut Entscheidungsbaum 6 | Framework Core (Installer, Werkzeuge, Validator, Release-Prozess) und Einstieg des Repositoriums |
+| Art | PATCH-Release: Bedienung des Befehls und Dokumentation; die Laufzeitschicht im Projekt ändert sich nicht |
+| Dringlichkeit | sofort – vor der ersten Veröffentlichung auf PyPI und npm |
+| Status | 🟢 **entschieden am 2026-10-01** (E1 bis E5) |
+
+---
+
+## 1. Anlass
+
+Vor dem Hochladen von `1.24.0` auf PyPI probierte der Owner die Version aus TestPyPI in einem eigenen Projektverzeichnis aus: `pip install -i <Index von TestPyPI> koolie==1.24.0`. Er erwartete, dass Koolie damit in das Verzeichnis kommt, in dem er steht. pip installierte nur den Befehl, und zwar in einen Ordner außerhalb des `PATH` (*„The script koolie.exe is installed in … which is not on PATH“*). Der Owner hielt an: *„Stop, ich habe mir das mit dem package installer anders vorgestellt.“*
+
+## 2. Vorprüfung
+
+- **Ein Paket führt beim Installieren keinen Code aus** – gemessen mit `1.22.0` (D-519); das bleibt.
+- **`uvx koolie` und `npx koolie`** starten den Befehl im Verzeichnis des Aufrufs, ohne dauerhafte Installation (gemessen). Bis `1.24.0` fragte der Dialog dort trotzdem nach dem Projektverzeichnis, ohne Vorgabe.
+- **`python -m koolie`** startet denselben Befehl, auch wenn der Ordner der Skripte nicht im `PATH` steht (gemessen).
+- **Beifund:** Das Archiv der Vorabversion `1.24.0.dev1` trug CRLF in jeder Textdatei; der dokumentierte Befehl lief ohne `core.eol=lf`.
+
+Vorgelegt im Chat mit Schätzung: rund 1,5 bis 2 Stunden, kein Sitzungslauf, 0 USD. Der Owner: *„ja, so vorgehen mit 1.24.1“*.
+
+## 3. Vorlage zur Entscheidung
+
+| # | Frage | Entscheidung | Preis |
+|---|---|---|---|
+| E1 | Was tut `koolie` ohne Argumente? | Der Dialog nimmt das Verzeichnis des Aufrufs als Vorgabe, Enter übernimmt es; nicht im Framework selbst; die Starter unverändert (D-532) | Ein Enter weniger bis zur Installation – nach Anzeige des Befehls und Bestätigung |
+| E2 | Was steht zuerst in README und Quickstart? | `uvx koolie`, `pipx run koolie`, `npx koolie` im Projektverzeichnis; `pip install` als „nur der Befehl“ mit `python -m koolie` (D-533) | `pipx run` ungemessen |
+| E3 | Was wird veröffentlicht? | `1.24.1` als erste Version auf PyPI und npm; `1.24.0` nicht (D-534) | Eine Marke ohne Paket |
+| E4 | Wie läuft die Probe? | Vorabversion auf TestPyPI, die der Owner im eigenen Projekt ausprobiert (D-533) | Eine Rückfrage mehr vor der Signatur |
+| E5 | Befehl für das Vorabarchiv | `core.eol=lf`, `core.autocrlf=input` wie das Release-Archiv (D-534) | – |
+
+## 4. Umsetzung
+
+1. `install_dialog.py --vorgabe <verzeichnis>`; `koolie_befehl.py` übergibt `os.getcwd()`.
+2. Prüfung 112 startet den Befehl ohne Argumente in einem Wegwerfverzeichnis und verlangt, dass Enter zur nächsten Frage führt; Sonde `112i`.
+3. README und Quickstart, deutsch und englisch; `paketquellen/README.md`; Release-Prozess 4.2.
+
+## 5. Entscheidung
+
+🟢 **Angenommen am 2026-10-01.**
+
+| # | Entscheidung | Decision Record |
+|---|---|---|
+| E1 | Die Vorgabe im Dialog | D-532 |
+| E2, E4 | Der Einbefehl-Weg und die Probe beim Owner | D-533 |
+| E3, E5 | Erste Version `1.24.1`, das Vorabarchiv | D-534 |
+
+## 6. Messung und Belege
+
+Protokoll `tests/protocols/2026-10-01-befehl-im-projektverzeichnis.md`. Kein Sitzungslauf, 0 USD. Erhebungsablage `leitwerk-erhebungen-2026-10-01-1240` außerhalb des Repositoriums.

package/.koolie/core/governance/change-requests/CR-2026-172-auftritt-npm-suche.md

@@ -0,0 +1,58 @@
+# Änderungsantrag `CR-2026-172`
+
+| Feld | Inhalt |
+|---|---|
+| Titel | Ein neuer Auftritt, npm unter dem Scope und die Suche nach dem Ältesten – und der Name, den npm für `cookie` hielt |
+| Antragstellende Rolle | `<FRAMEWORK_OWNER>` |
+| Datum | 2026-10-01 |
+| Betroffene Artefakte | `README.md`, `README.en.md`, `CONTRIBUTING.md` (neu), `QUICKSTART.md`, `QUICKSTART.en.md`, `docs/ADOPTION_GUIDE.md` (Abschnitte 2 und 9), `paketquellen/bauen.py`, `paketquellen/README.md`, `governance/RELEASE_PROCESS.md`, `framework/skills/fw-change-analyze`, `fw-plan`, `fw-bugfix-prepare` (SKILL, CHANGELOG, TESTS), `clients/claude-code/CLIENT_PACK.md` (Zeile B2), `tests/scripts/pruefungen/bestand.py` (Allowlist), `tests/scripts/sonden/teil17_paketquellen.py`, `tests/scripts/validate-framework.py`, `docs/ROADMAP.md` |
+| Ebene laut Entscheidungsbaum 6 | Framework Core (Skills, Werkzeuge, Validator, Release-Prozess), Client Pack `claude-code` und Einstieg des Repositoriums |
+| Art | MINOR-Release: Anweisungsänderung in drei Skills mit Nachlauf, neuer Auftritt, npm-Name |
+| Dringlichkeit | geplant (Owner 2026-10-01: *„mach 1.25.0“*) |
+| Status | 🟢 **entschieden am 2026-10-01** (E1 bis E6) |
+
+---
+
+## 1. Anlass
+
+Drei Dinge kamen am 2026-10-01 zusammen: npm wies das Paket `koolie` beim ersten Hochladen ab (*„too similar to existing package cookie“*); eine Rückmeldung aus dem Umfeld des Owners nannte die README *viel zu lang und zu detailliert* – ein Leser, der über das Repositorium stolpert, wird nicht abgeholt; und die Roadmap führte `K-207` (die Suchgrenze schneidet die ältesten Treffer ab) und `K-208` (ein lesender Befehl ohne Korb lief ohne Rückfrage).
+
+## 2. Vorprüfung
+
+- **README:** 444 Zeilen, 4.315 Wörter, 19 Abschnitte, 16 Verweise auf `CR-`, `D-` oder `K-`. Die Installationsbefehle standen zugleich im Übernahmeleitfaden.
+- **npm:** Ein Paket mit Scope ist ohne `publishConfig.access: public` privat; der Befehl bleibt über `bin` `koolie`.
+- **`K-207`:** Die Anweisung steht wortgleich in drei Skills; nach D-303 öffnet ihre Änderung alle Zellen der drei Testblätter – 27 Zellen statt der zuerst geschätzten zehn. Der Owner wählte die volle Lösung mit Deckel 35 Läufe und 22 USD.
+
+## 3. Vorlage zur Entscheidung
+
+| # | Frage | Entscheidung | Preis |
+|---|---|---|---|
+| E1 | Name auf npm | `@renoxar/koolie`, öffentlich; der Befehl bleibt `koolie` (D-535) | Zwei Paketnamen |
+| E2 | Auftritt | README als Startseite, Maintainer-Inhalte in `CONTRIBUTING.md`, Befehle im Übernahmeleitfaden; deutsch und englisch gleich gekürzt; keine Kennungen auf der Startseite (D-538) | Belege eine Ebene tiefer |
+| E3 | `K-207` | Zweite Suche mit den ältesten zuerst, in allen drei Skills, mit vollem Nachlauf (D-536) | Eine Suche mehr; rund 30 Sitzungsläufe |
+| E4 | `K-208` | Trennlauf mit und ohne `deny`-Eintrag (D-537) | – |
+| E5 | Badges | ja, die Allowlist nimmt Paketseiten und Badges eng gefasst auf (D-535) | – |
+| E6 | Veröffentlichung | PyPI mit der Signatur (D-530); vor dem ersten Hochladen auf npm unter dem neuen Namen eine Rückfrage beim Owner | – |
+
+## 4. Umsetzung
+
+1. README und `README.en.md` neu, `CONTRIBUTING.md` neu, Übernahmeleitfaden Abschnitt 2 (Paketquelle) und 9 (Befehle), Quickstart-Verweise.
+2. `bauen.py`: `NPM_NAME`, `publishConfig`; Nachprüfung meldet einen anderen Namen oder fehlenden öffentlichen Zugang; Sonde `112j`.
+3. Die Suchanweisung in den drei Skills, Versionen 0.1.7, 0.1.9, 0.1.9; Nachlauf aller Zellen.
+4. Zeile B2 der Fähigkeitsmatrix `claude-code` (0.26.4).
+
+## 5. Entscheidung
+
+🟢 **Angenommen am 2026-10-01.**
+
+| # | Entscheidung | Decision Record |
+|---|---|---|
+| E1, E5 | npm unter dem Scope, Badges | D-535 |
+| E3 | Die zweite Suche | D-536 |
+| E4 | Der lesende Befehl ohne Korb | D-537 |
+| E2 | Der Auftritt | D-538 |
+| E6 | Veröffentlichung | D-530 (unverändert) |
+
+## 6. Messung und Belege
+
+Protokoll `tests/protocols/2026-10-01-auftritt-und-suche.md`. Erhebungsablage `leitwerk-erhebungen-2026-10-01-1250` außerhalb des Repositoriums.