@renoxar/koolie 1.25.0

package/.koolie/core/tests/protocols/2026-09-24-uebergabe-lokal.md

@@ -0,0 +1,85 @@
+# Protokoll: Die Übergabe wird ein lokales Arbeitsdokument – und vier Prüfungen verlieren ihren Anker
+
+| Feld | Inhalt |
+|---|---|
+| Datum | 2026-09-24 |
+| Release | `1.4.1` |
+| Änderungsantrag | `CR-2026-134` |
+| Art | Korrektur am Prüfapparat und an zwei Übernahmetexten – **keine Sitzung, kein Kontingent, kein Modelllauf** |
+| Gegenstand | Die Übergabe aus dem Versionierten nehmen, ohne daß der Validator dabei leise weniger prüft; die Wurzel-README an `1.4.0` angleichen |
+| Ergebnis | 🟢 **Entschieden und umgesetzt, `D-350` und `D-351`.** 🔴 **Vier Prüfungen hingen an der Übergabe, zwei davon hätten ihr Austragen nicht bemerkt** – gemessen mit Gegenbeweis. 🔴 **Und der erste Befehl der Übernahmeanleitung lief nicht** |
+
+---
+
+## 1. Was gefragt war
+
+Der Framework Owner will die Übergabe und ihre Vorlage nicht mehr eingecheckt haben; beide
+sollen nur lokal vorliegen. Die Prüfungen 67 und 78 (soweit sie die Übergabe betreffen)
+sollen ersatzlos entfallen, das Kennzeichen des Quellrepositoriums eine eigene Datei
+werden, Übergabe und Beilage getrennt bleiben. Dazu: die Wurzel-README auf den Stand von
+`1.4.0` bringen.
+
+## 2. Gegenprüfung
+
+### 2.1 Was an der Übergabe hing
+
+Gezählt mit `grep` über `validate-framework.py` und `probe-pruefungen.py`, **bevor** etwas
+geändert wurde: Die Übergabe ist Gegenstand der Prüfungen **67** und **78** (vierter
+Abschnitt) und **Anker** der Prüfungen **75, 78, 79 und 81** – an ihr unterschieden sie
+Quellrepositorium und übernehmendes Projekt. 75 und 81 lesen dafür den **versionierten**
+Bestand (`git ls-files`), 78 und 79 den Arbeitsbaum. Im Sondenapparat hingen die Einheiten
+67a–d, die Gegenproben 67a/67b, 78d/78e und die Gegenprobe 82b an ihr.
+
+### 2.2 🔴 Der Gegenbeweis: Das Austragen allein hätte niemand bemerkt
+
+Eine Kopie des versionierten Bestands, die Übergabe **lokal vorhanden, aber nicht
+verfolgt**, `README.md` durchgehend auf LF gestellt, `git init` und `git add -A`:
+
+| Validator | Treffer auf `README.md: trägt …` |
+|---|---|
+| aus `1.4.0` (Anker: `UEBERGABE.md` im versionierten Bestand) | 🔴 **0** |
+| aus `1.4.1` (Anker: `.koolie/QUELLREPOSITORIUM.md`) | 🟢 **1** |
+
+➡️ ***Ein Anker, der nur an einem Arbeitsplatz liegt, ist keiner.*** Der alte Validator
+lief in diesem Baum ohne Befund durch und prüfte dabei nur noch das Ausgelieferte.
+
+### 2.3 Die README und ihre Nachbarn
+
+| # | Fundstelle | Befund |
+|---|---|---|
+| R1 | `README.md`, Einleitung | zwei Client Packs genannt, drei ausgeliefert |
+| R2 | `README.md`, Hinweis unter dem Baum | *„Eine eigene Hook-Datei gibt es nicht"* – bei `openai-codex` gibt es nur sie (`.codex/hooks.json`) |
+| R3 | `README.md`, `install.py`-Tabelle und Hinweis | die Hook-Konfiguration als Projekteigentum für alle Packs; bei `openai-codex` gehört die Hook-Datei zum Kern (`shared_core`) und wird bei `--update` erneuert, womit sich ihr Hash und damit das Hook-Vertrauen ändert |
+| R4 | `README.md`, Absatz zu `root-template/` | *„in beiden Manifesten"* – `seed_paths` ist in allen drei leer (gezählt) |
+| 🔴 R5 | `README.md` und zweimal `docs/ADOPTION_GUIDE.md` | `cp -r .koolie/core/ /pfad/zum/projekt/` legt mit dem Schrägstrich am Quellpfad den Kern unter `<projekt>/core` ab – **der erste Befehl der Anleitung lief nicht** |
+| N1 | `build/doc/00-kopf.md` | *„Ausgeliefert werden zwei"* – Prüfung 77 hält dort die Version, nicht den Inhalt |
+| N2 | `governance/ADOPTION_REGISTRY.md` | Spalte `Overlay-Version` auf `0.3.3` und `1.1.0`, die Projekte trugen `0.3.5` und `1.3.0` – Prüfung 82 hält nur die Framework-Version |
+
+## 3. Umsetzung
+
+Wie in `CR-2026-134` Abschnitt 4. Die Nummer 67 bleibt im Register als *entfallen*;
+Prüfung 40 verlangt ein lückenloses Register. Die Sondenmenge steht an allen drei Stellen
+als *„6, 14, 18 bis 66 und 68 bis 88"*.
+
+**Neu im Sondenapparat, beide im Bündel zu Prüfung 81:**
+
+| Einheit | Was sie mißt |
+|---|---|
+| **Sonde 81d** | `README.md` – eine Datei der Wurzel, außerhalb des Kerns – auf der anderen Zeilenendeform wird im Quellrepositorium gemeldet. **Gegen den Vorstand fällt sie** (Abschnitt 2.2) |
+| **Gegenprobe 81b** | dieselbe Datei ohne Kennzeichen, also in einem übernehmenden Projekt: nicht gemeldet |
+
+## 4. Abnahme
+
+| Lauf | Ergebnis |
+|---|---|
+| `validate-framework.py --root .` | **0 Fehler, 0 Warnungen** |
+| `probe-pruefungen.py .` mit `PYTHONIOENCODING=utf-8` | 🟢 **alle Sonden und Gegenproben bestanden**, 323 Einheiten, Exit 0 |
+| `probe-pruefungen.py .` ohne | 🟢 **alle Sonden und Gegenproben bestanden**, 323 Einheiten, Exit 0 |
+| Ergebniszeilen oberhalb der Trennlinie, beide Läufe | 🟢 **zeilengleich** (511 Zeilen bis zur Trennlinie; darunter nur Laufzeiten, D-94) |
+
+## 5. Was offen bleibt
+
+- ⚠️ **Stand und Zahlen der Übergabe prüft niemand mehr** – der benannte Preis von D-350.
+- ⚠️ **`K-104`** (eine Prüfung auf die Aussagen der Wurzel-README) bleibt, wo er steht.
+  R1 bis R5 sind von Hand gefunden, und der schwerste davon – ein Befehl, der nicht lief –
+  ist die Art Befund, die eine Textprüfung nicht sieht.

package/.koolie/core/tests/protocols/2026-09-25-code-pack-posten.md

@@ -0,0 +1,86 @@
+# Protokoll: Die Code- und Pack-Posten der Durchsicht – und der Hook, dem nach jeder Hebung neu vertraut werden muss
+
+| Feld | Inhalt |
+|---|---|
+| Datum | 2026-09-25 |
+| Release | `1.10.0` |
+| Änderungsantrag | `CR-2026-146` |
+| Art | Werkzeuge, Client Packs und Hauptdokument nach den Befunden der Durchsicht der Klasse B – **drei kurze Sitzungsläufe mit Claude Code für `K-129` (1), sonst keine Sitzung, kein Kontingent** |
+| Gegenstand | `install.py`, `validate-framework.py --mermaid`, `build/assemble.py`, `build/build-docx.py`, die drei Client Packs und ihre Vorlage, `02-privacy.md`, `03-security.md`, `onboarding/exercises/README.md` |
+| Ergebnis | 🟢 **Entschieden, `D-395` bis `D-401`.** Acht Klärungspunkte beantwortet, `K-152` neu; zwei neue Sondenbündel, beide fallen gegen den Vorstand |
+
+---
+
+## 1. Was gefragt war
+
+Wiederaufnahmepunkt von `1.9.3`, Punkt 2: die Code- und Pack-Posten der Durchsicht (D-384),
+`K-125` entscheiden oder vertagen. Fragen (a) bis (j) vorgelegt am 2026-09-25 und angenommen.
+`CR-2026-146` E1 bis E10; E11 ist die Einplanung von Kiro, beauftragt während des Baus (D-401).
+
+## 2. Messungen
+
+**Gegenbeweis gegen den Vorstand.** Ein Baum aus `v1.9.3` (`git archive`) mit dem neuen
+Sondenskript:
+
+| Einheit | `v1.9.3` | `1.10.0` |
+|---|---|---|
+| `D395` (`openai-codex`: Vertrauensschritte nach Installation und Hebung) | FEHL – keiner der drei Sätze, dafür der Integritätsblock | OK |
+| `D395a` (`claude-code`: Integritätsblock, kein Vertrauensschritt) | OK | OK |
+| `D398`, `D398a` (Unterscheidung des Renderers) | FEHL – das Modul gibt es nicht | OK |
+
+**`K-145`, am Renderer gemessen** (`mmdc` mit Edge über die Konfiguration des Baus):
+
+| Fall | Exit | Umgebungsfehler erkannt |
+|---|---|---|
+| gültiger Block, mit Konfiguration | 0 | – |
+| ungültiger Block, mit Konfiguration (*„Parse error on line 2“*) | 1 | nein – bleibt ein Fehler |
+| gültiger Block, **ohne** Konfiguration (*„Could not find chrome-headless-shell“*) | 1 | ja |
+
+`validate-framework.py --mermaid` am Stand `v1.9.3`: **8 Fehler**, einer je Mermaid-Block; neu:
+**0**.
+
+**`K-127`, am Bau gemessen:** `assemble.py --client openai-codex` – `v1.9.3` bettet
+`.codex/config.toml` mit der Sprachangabe `json` ein, 1.949.844 Zeichen, die Kopfzeile des Packs
+sechsmal; neu mit `toml`, 1.994.810 Zeichen, siebenmal (die Matrix in Kapitel 7a).
+
+**`K-129` (1), gemessen mit Claude Code `2.1.282`** in einem Messbaum außerhalb des
+Benutzerprofils: ein Elternverzeichnis mit einer `CLAUDE.md` (Kontrollmarke E), darunter ein
+Projekt mit eigener `CLAUDE.md` (Marke P). Frage an die Sitzung: welche Marken in den
+mitgegebenen Anweisungen stehen, ohne Werkzeug; je Lauf eine Runde, keine Abweisung.
+
+| Lauf | Eintrag `claudeMdExcludes: ["**/cme/CLAUDE.md"]` | Antwort |
+|---|---|---|
+| A (Gegenlauf) | keiner | E, P |
+| B | `.claude/settings.json` | P |
+| C | `.claude/settings.local.json` | P |
+
+**Installierte Laufzeitschicht.** Frischinstallationen aus `v1.9.3` und `1.10.0` je Pack
+verglichen: Unterschiede nur in der Regelvorlage `21-overlay-TEMPLATE.md.template` (alle drei
+Packs) und im Kommentar der erzeugten Berechtigungsdatei (`claude-code`, `devin-desktop`).
+Wurzel-Anweisung, Regeln, Skills, Hooks, Agentenprofile byte-gleich.
+
+## 3. Befund beim Bau
+
+- **Die Empfehlung zu (g) stand gegen D-39.** Die Fehlerausgabe des Renderers zitiert den
+  Diagrammtext; der Validator gibt sie deshalb bewusst nicht wieder. Umgesetzt ist die
+  Unterscheidung nach Umgebungs- und Diagrammfehler ohne Wiedergabe (D-398).
+- **Derselbe falsche Satz an zweiter Stelle.** *„mit keinem Overlaytext verglichen“* stand
+  nicht nur im Kommentar von `clientmap.py` (`K-151` (5)), sondern auch in `03-security.md`;
+  beide berichtigt (D-399).
+- **`K-137` war zum Teil überholt:** Die vermisste Matrixzeile X2 steht in allen drei Packs.
+
+## 4. Abnahme
+
+| Lauf | Ergebnis |
+|---|---|
+| Validator | 0 Fehler, 0 Warnungen, beide Kodierungsumgebungen; mit `--mermaid` ebenfalls 0 Fehler, 0 Warnungen |
+| Sondenlauf | **346** Einheiten (344 und die zwei neuen Bündel), alle bestanden, beide Kodierungsumgebungen zeilengleich (608 Zeilen), rund 670 s Wanduhr; Abnahmelauf gegen den fertigen Baum zeilengleich |
+| Pilot / Übungsrepositorium | 1 Fehler, 2 Warnungen / 0 Fehler, 1 Warnung – unverändert gegen den Stand vor dem Heben; mit `install.py --target <projekt> --update` gehoben, 564 Kerndateien, dort committet. Beim Heben meldet `install.py` je Projekt eine aktualisierte Laufzeitdatei, die Regelvorlage 21 |
+| Bau | `v1.10.0` 1.996.452 / 1.997.621 / 1.991.356 Bytes (`devin-desktop` / `claude-code` / `openai-codex`); Kapitel 31 nennt 564 versionierte Dateien, 8 Diagramme je Fassung; im Bau für `openai-codex` die Berechtigungsdatei als `toml`, die Matrix des Packs in Kapitel 7a |
+
+## 5. Was offen bleibt
+
+- `install.py` nennt die Vertrauensschritte, es prüft sie nicht (`K-118`).
+- `K-138` bis `K-144`, `K-146`, `K-148` bis `K-150` für `1.11.0`; `K-147` für `1.12.0` (D-401), `K-152`
+  ohne Ziel-Release.
+- Die Abnahme des macOS-Starters auf macOS steht weiter aus.

package/.koolie/core/tests/protocols/2026-09-25-dokumentationsstandard.md

@@ -0,0 +1,101 @@
+# Protokoll: Der Dokumentationsstandard – und die Roadmap, die zu zwei Dritteln Rückblick war
+
+| Feld | Inhalt |
+|---|---|
+| Datum | 2026-09-25 |
+| Release | `1.9.0` |
+| Änderungsantrag | `CR-2026-142` |
+| Art | Qualitätssicherungsrelease der Dokumentation: Kriterien, vier neue Prüfungen, eine Bauform des Hauptdokuments, Durchsicht der Klassen A und D, Kürzung der Roadmap – **keine Sitzung mit einem Client, kein Kontingent**; die Kaltleser-Probe lief mit fünf kurzen Modellläufen |
+| Gegenstand | Bestand und Merkmale aller Dokumente; die Prüfungen 91 bis 94 gegen den Bestand `v1.8.0`; die Kennungen der gestrichenen Roadmap-Blöcke; die Kaltleser-Probe an README, Übernahmeleitfaden und Quick-Start |
+| Ergebnis | 🟢 **Entschieden, `D-371` bis `D-380`.** Vier Klassen mit Kriterien; die Prüfungen 91 bis 94 melden gegen den Bestand `v1.8.0` 26 Befunde und laufen nach der Durchsicht still; Klassen A und D durchgesehen; Roadmap 337 → rund 114 KB ohne verlorene Kennung; die Kaltleser-Probe fand fünf unerklärte Begriffe und kein falsch |
+
+---
+
+## 1. Was gefragt war
+
+Wiederaufnahmepunkt von `1.8.0`, Punkt 2: das Qualitätssicherungsrelease der Dokumentation
+(D-370). Zuerst der Vorbedingungsdurchgang, dann die Entscheidungsfragen (a) bis (l),
+vorgelegt am 2026-09-25 und angenommen (*„Passt, fahre so fort“*). `CR-2026-142` E1 bis E12.
+
+## 2. Messungen vor dem Bau
+
+| Messung | Ergebnis | Folge |
+|---|---|---|
+| Bestand | 559 versionierte Dateien, 352 Nachweisschicht; 181 Markdown-Dokumente außerhalb (3,2 MB) und 34 Kapitelquellen | vier Klassen (D-371) |
+| Wörter mit „ß“ | 308 verschiedene; **603** Treffer der Schreibung vor 1996 gegen **1.192** geltende; **19** Dokumente mischen beide; außerhalb der Register **74** in 14 Dokumenten | Prüfung 92, Umstellung (D-373) |
+| Geschichtsmarken | 316, davon 180 im Decision Log | Regel D-376, keine Prüfung |
+| Steckbrief | 99 von 215; ohne 116, nach begründeten Ausnahmen **5** | Prüfung 94 (D-375) |
+| Form | Codeblöcke, Ebenen, Tabellen sauber; **1** Datei mit drei Hauptüberschriften (`fw-reviewer.md`) | Prüfung 93 (D-374) |
+| Roadmap | 337 KB, davon rund 200 KB Rückblicke vor `1.0.0` | Kürzung (D-378) |
+| Kapitel 31 | *„502 Dateien, 123 Anträge“* zu `0.89.0`; *„78 Dateien, bei beiden Packs“* | Bau setzt ein (D-377) |
+
+**Gegenbeweis der Prüfungen gegen den Bestand `v1.8.0`:** Der neue Validator meldete am
+unveränderten Baum **26 Fehler** – 14 Dokumente mit alter Schreibung (74 Wörter), eine Datei
+mit drei Hauptüberschriften, fünf ohne Steckbrief, dazu die erwarteten Registerbefunde.
+
+## 3. Wirkungsnachweis – Sonden und Gegenproben, mit Gegenbeweis
+
+| Einheit | Stand `1.9.0` | Gegenbeweis (Validator aus `v1.8.0`) |
+|---|---|---|
+| `91a`, `91b` (Sonden) | OK | **je FEHL** |
+| `92a`, `92b` (Sonden) | OK | **je FEHL** |
+| `93a` bis `93d` (Sonden) | OK | **je FEHL** |
+| `94a`, `94b` (Sonden) | OK | **je FEHL** |
+| Gegenproben `91a`, `92a`–`92c`, `93a`, `93b`, `94a` | OK | OK – **erwartet**: der alte Validator meldet nichts davon |
+| Bau mit `assemble.py` aus `v1.8.0` | – | läuft durch und lässt **23** `{{ZAHL:…}}`, **2** `{{VERSION}}`, **2** `{{CLIENT}}` unaufgelöst im Dokument stehen |
+
+Der Gegenbeweis lief an einer vollständigen Kopie des Arbeitsbaums außerhalb des
+Repositoriums, die danach gelöscht wurde.
+
+## 4. Die Kaltleser-Probe (D-379)
+
+Je Dokument eine frische Sitzung (kleinstes verfügbares Modell), die **nur** das eine
+Dokument lesen durfte und fünf feste Fragen eines Erstlesers beantwortete. Das Soll ist vor
+den Läufen aus den Dokumenten geschrieben worden.
+
+| Lauf | Dokument | richtig | teilweise | falsch | Befund am Dokument → Abhilfe |
+|---|---|---|---|---|---|
+| 1 | Wurzel-README | 4 | 1 | 0 | Aktivierung und *„bis dahin nur lesend“* fehlten im Installationsweg → Schritt 4 ergänzt; Kennungen unerklärt → Satz ergänzt |
+| 1 | Übernahmeleitfaden | 4 | 1 | 0 | Commit im Projekt (D-343) fehlte in der Aktualisierung → Schritt 6; Kennungen unerklärt → Satz ergänzt |
+| 1 | Quick-Start | 5 | 0 | 0 | Kürzel P, R, M unerklärt → Verweis auf ihre Fundstellen |
+| 2 | Wurzel-README | 5 | 0 | 0 | *„Overlay-Muster“* unerklärt → Satz ergänzt |
+| 2 | Übernahmeleitfaden | 4 | 1 | 0 | Commit jetzt genannt (unter Frage 1); *„Laufzeitschicht“* unerklärt → Erklärung beim ersten Auftreten |
+
+**Kein *„falsch“*.** Jeder *„Unklar“*-Hinweis war ein Begriff, der beim ersten Auftreten
+nicht erklärt war – dieselbe Bauform in allen fünf Läufen.
+
+## 5. Abnahme
+
+| Lauf | Ergebnis |
+|---|---|
+| Validator | **0 Fehler, 0 Warnungen**, beide Kodierungsumgebungen |
+| Sondenlauf | **341 Einheiten, alle bestanden** (vorher 337; neu die Bündel `sonden_roadmapstand`, `sonden_rechtschreibung`, `sonden_dokumentform`, `sonden_steckbrief`), beide Kodierungsumgebungen Exit 0 und oberhalb der Trennlinie zeilengleich (592 Zeilen), rund 645 s Wanduhr je Lauf; **Abnahmelauf gegen den fertigen Baum** zeilengleich |
+| Pilot / Übungsrepo `--strict-overlay` nach der Hebung | beide mit `--target --update`, **555 Kerndateien, 0 abweichend**, `LIEFERUMFANG` = `voll`; aktualisiert nur das Reviewprofil `fw-reviewer`. Pilot **1 Fehler, 2 Warnungen**, alle im projekteigenen `CHANGELOG.md`; Übungsrepo **0 Fehler, 1 Warnung** (Länge der eigenen Regeldatei) – beide unverändert zum Vorstand. Die Prüfungen 91 bis 94 laufen in beiden still |
+| Bau | alle drei Word-Fassungen `v1.9.0` in `build/out/` (1.944.424 / 1.945.737 / 1.940.322 Bytes für `devin-desktop` / `claude-code` / `openai-codex`), im Erzeugnis nachgezählt: Dokumentversion `1.9.0`, *„94 Prüfungen“*, Kapitel 31.1 mit **555** Dateien und **78** installierten Dateien je Pack, eingesetzt vom Bau; die vier verbliebenen `{{` sind Zitate aus dem Decision Log, die 84 *„daß“* stehen in eingebetteten Registern |
+
+## 6. Nebenhandlungen außerhalb des Kerns
+
+- Signierte Marke `v1.8.0` (vom Owner gesetzt, `Good "git" signature`) **vor** dem
+  Gitea-Release gepusht. Schritte 5 bis 7 aus `RELEASE_PROCESS.md` 4.1, **zum ersten Mal mit
+  `-c tar.umask=022` aus dem Prozesstext**: `koolie-1.8.0.tar.gz`, **559 Dateien** = `git
+  ls-tree` der Marke, kein CRLF, `install.command` `0755`, alle übrigen 558 Dateien `0644`,
+  Lizenz an beiden Stellen gleich, kein `build/out/`; zweimal erzeugt, bytegleich.
+  Gitea-Release mit Archiv und Prüfsumme, beide Anhänge bytegleich zurückgelesen.
+
+## 7. Befunde während des Baus
+
+- **Prüfung 93 fand in ihrer ersten Stunde zwei Präparationen des Sondenapparats** (zu
+  Prüfung 31), die Tabellenzeilen mit einer Spalte zu viel einfügten. Die Gegenprobe 31 lief
+  bis dahin grün, weil keine Prüfung die Spaltenzahl kannte.
+- **Prüfung 75** führte die Roadmap als erklärte Fundstelle des alten Namens; nach der
+  Kürzung nahm die Ausnahme nichts mehr aus und meldete sich selbst (0.57.1).
+- Ein Bearbeitungswerkzeug mit Zeilenstrom (`sed -i`) stellte eine Kapitelquelle auf LF um,
+  ein Ersetzungsskript erzeugte im README zwei Wagenrückläufe ohne Zeilenvorschub – beide
+  meldeten Prüfung 81 bzw. die Prüfung auf verirrte Steuerzeichen sofort.
+- Die Durchsicht hat Befunde geliefert, die eine Entscheidung brauchen: `K-123` bis `K-129`.
+
+## 8. Offen und benannt
+
+- Die inhaltliche Durchsicht der Klasse B (`1.9.1` ff., D-380).
+- `K-123` bis `K-129`.
+- Die Abnahme des macOS-Starters auf macOS (aus `1.7.0`).

package/.koolie/core/tests/protocols/2026-09-25-installer-je-zielsystem.md

@@ -0,0 +1,134 @@
+# Protokoll: Der Installer je Zielsystem – und die Prüfung, die ohne PyYAML Fehler erfand
+
+| Feld | Inhalt |
+|---|---|
+| Datum | 2026-09-25 |
+| Release | `1.7.0` |
+| Änderungsantrag | `CR-2026-140` |
+| Art | Neuer Übernahmeweg (Starter, Dialog, `install.py --target`), korrigierte Prüfung, erweiterter Prüfapparat – **keine Sitzung, kein Kontingent, kein Modelllauf** |
+| Gegenstand | Die Starter unter Windows, Git Bash und Linux; `--target` aus beiden Quellformen; die Mindestversion an Python 3.8 und 3.14; Prüfung 33 ohne PyYAML; beide übernehmenden Projekte, zum ersten Mal über das Werkzeug gehoben |
+| Ergebnis | 🟢 **Entschieden, `D-362` bis `D-366`.** Installation über `--target` Datei für Datei gleich dem Handweg; Python 3.8 gemessen. 🔴 **Prüfung 33 erfand ohne PyYAML neun Fehler je `claude-code`-Installation** – behoben; 🔴 **die Starter lagen außerhalb des Prüfapparats** – aufgenommen, und die Inhaltsprüfung schlug sofort an. ⚠️ **Abnahme auf macOS offen** |
+
+---
+
+## 1. Was gefragt war
+
+Wiederaufnahmepunkt von `1.6.0`, Punkt 2: der Installer je Zielsystem, Fokus Windows und
+macOS (Vorgabe des Owners vom 2026-09-25). Vor dem Bau vorgelegt als Fragen (a) bis (j);
+(a) bis (i) angenommen, (j) – die Abnahme auf macOS – offen. `CR-2026-140` E1 bis E11.
+
+## 2. Messungen
+
+Alle Messungen an Wegwerf-Verzeichnissen außerhalb des Repositoriums.
+
+### 2.1 Vor dem Bau
+
+| Messung | Ergebnis | Folge |
+|---|---|---|
+| `Get-ExecutionPolicy -List` am Arbeitsplatz | `LocalMachine AllSigned`, `CurrentUser RemoteSigned` | Starter als `.cmd`, nicht `.ps1` |
+| Python-Fundorte | `C:\Python314\python.exe`, **`WindowsApps\python.exe`** (Store-Platzhalter), `py.exe` | Versionsprobe statt Namensprobe |
+| Dateimodi im Repositorium | **kein** Träger mit `100755` | `install.command` bekommt ihn, Sonde |
+| Kernumfang nach Verzeichnis | `tests/` 179 Dateien – **darin Hooks und Validator** (`tests/scripts/`) | Lieferumfang nicht in `1.7.0` (D-366) |
+| Statische Analyse der Werkzeuge (`vermin`) | Untergrenze 3.7 | gemessen wird 3.8 (3.7 nicht beschaffbar) |
+
+### 2.2 Die Mindestversion: 3.8 gegen 3.14
+
+| Messung | Ergebnis |
+|---|---|
+| Installation je Pack mit `--overlay general`, 3.8.20 gegen 3.14.4 | **alle drei byteweise gleich** |
+| Validator mit PyYAML gegen dieselbe Installation, je Pack | **zeilengleich** (je 8 Fehler, 5 Warnungen – die eines Projekts ohne README und Commit) |
+| Alle 41 Python-Träger des Repositoriums unter 3.8 kompiliert | **0 Syntaxfehler** |
+| 🔴 **Validator OHNE PyYAML, je Pack** | `devin-desktop`, `openai-codex`: nur die PyYAML-Warnung mehr. **`claude-code`: neun Fehler mehr** – `disallowed-tools traegt []` an neun Skills |
+
+Die neun Fehler sind falsch: Die installierten `SKILL.md` tragen die Liste
+(`disallowed-tools: Edit, Write, NotebookEdit, Bash`). Prüfung 33 las aus dem Rohtext,
+den `parse_frontmatter` ohne PyYAML liefert, mit `.get()` nichts. Nach dem Rückfall
+`_flaches_feld()`: ohne PyYAML dieselben Meldungen wie mit, bis auf die Warnung; eine auf
+`Edit` verkürzte Liste wird weiter gemeldet.
+
+### 2.3 `--target` gegen den Handweg
+
+| Lauf | Ergebnis |
+|---|---|
+| `--target` (Klon, `claude-code`, `--overlay general`), danach `--update`, gegen `git ls-files \| tar` + `install.py` | **Datei für Datei gleich** (`diff -r` ohne `__pycache__`, `.git`) |
+| Kennzeichen, Overlay der Quelle | nicht mitkopiert |
+| Zweiter Aufruf ohne `--update` | Abbruch, *„Heben auf diesen Stand: --update“* |
+
+### 2.4 Die Starter
+
+| Lauf | Ergebnis |
+|---|---|
+| `install.cmd`, Eingabe umgeleitet, Projektpfad `C:\lw-mig\zieltest\Pröjekt (x86) neu` (Leerzeichen, Umlaut, Klammer, Anführungszeichen wie beim Hineinziehen) | installiert (`devin-desktop`, `--overlay general`) |
+| `install.cmd`, `PATH` nur `System32` und `WindowsApps` | Platzhalter übergangen, *„Koolie braucht Python 3.8 oder neuer“*, Exit 1 |
+| `install.cmd`, `PATH` mit nur Python 3.8.20 | angenommen, installiert |
+| `install.command` (Indexfassung, LF) in Git Bash, Quelle ohne Git | installiert, Kopie *„Verzeichnis – ohne `__pycache__` und `build/out`“* |
+| `install.command` unter WSL (`sh` = `dash`, Python 3.12.3) | installiert |
+| ⚠️ **macOS** | **nicht gemessen** – die Abnahme steht aus |
+
+⚠️ **Nebenbefund am Meßaufbau:** Eine in cp1252 geschriebene Eingabedatei kam mit
+verstelltem Umlaut an – die Sitzung setzt `PYTHONIOENCODING=utf-8`, und Python liest
+umgeleitete Eingabe dann als UTF-8. Mit UTF-8-Eingabe bestanden. Eine echte
+Konsoleneingabe liest Python über die Konsolenschnittstelle; sie ist davon nicht
+betroffen.
+
+### 2.5 Der Prüfapparat an den Startern
+
+Nach der Aufnahme von `.cmd` und `.command` in `TEXT_EXT` meldete der erste
+Validatorlauf **`FW-CONTENT-URL`** in beiden Startern (die Downloadseite von python.org
+mit Schema). Die Starter nennen seither `python.org` ohne Schema. Vorher hatte keine
+Prüfung die Dateien gelesen.
+
+### 2.6 Die Projekte
+
+Beide zum ersten Mal mit `install.py --target <projekt> --update` gehoben, aus dem
+Arbeitsbaum des Frameworks:
+
+| Projekt | Kern | `--strict-overlay` | Overlay |
+|---|---|---|---|
+| Pilot (`claude-code`) | 549 Dateien, **0 abweichend** gegen `git ls-files` des Frameworks, keine Reste | **1/2** (projekteigenes `CHANGELOG.md`, unverändert); Auskunft weiterhin **38** | `0.3.12` |
+| Übungsrepositorium (`devin-desktop`) | 549 Dateien, **0 abweichend**, keine Reste | **0/1** (Laufzeitfassung 6.095 Zeichen, unverändert) | `1.4.6` |
+
+## 3. Wirkungsnachweis – Sonden und Gegenproben, mit Gegenbeweis
+
+| Einheit | Stand `1.7.0` | Gegenbeweis |
+|---|---|---|
+| `T362`, `T362a` | OK | mit `install.py` aus `1.6.0`: **je FEHL** (Exit 2, `--target` unbekannt); danach bricht das Bündel ab |
+| `T362b` bis `T362h` | OK | mit `install.py` aus `1.6.0`: nicht mehr erreicht – das Bündel bricht nach `T362a` ab |
+| `T363` | OK | an einem Starter mit `(3, 7)`: **FEHL** |
+| `T365` | OK | an einem Starter mit `goto`/Sprungmarke und `install.command` auf `100644`: **FEHL**, alle drei Stellen genannt |
+| `S364`, Gegenprobe `S364a` | OK | mit dem Validator aus `1.6.0`: **je FEHL** (`S364a`: *„PyYAML gesperrt True, still False“*) |
+| Sonden `6s` (beide Starter) | OK | mit dem Validator aus `1.6.0`: **je FEHL** – er liest `.cmd` und `.command` nicht |
+
+Der Gegenbeweis läuft an einer **vollständigen** Kopie des Arbeitsbaums mit den
+Werkzeugen aus `v1.6.0`.
+
+## 4. Abnahme
+
+| Lauf | Ergebnis |
+|---|---|
+| Validator | **0 Fehler, 0 Warnungen**, beide Kodierungsumgebungen |
+| Sondenlauf | **334 Einheiten, alle bestanden** (vorher 330; neu die Bündel `sonden_kopierweg` und `sonden_ohne_pyyaml` und die beiden Sonden `6s`), beide Kodierungsumgebungen Exit 0 und oberhalb der Trennlinie zeilengleich (559 Zeilen), rund 550 s Wanduhr je Lauf; **Abnahmelauf gegen den fertigen Baum zeilengleich** |
+| Sondenlauf unter **Python 3.8.20** (mit PyYAML), an einer Kopie des Baums | **334 Einheiten, alle bestanden**, Exit 0, oberhalb der Trennlinie **zeilengleich zum Lauf unter 3.14** – der Prüfapparat samt Hooks läuft unter 3.8 wie unter 3.14 (rund 610 s Wanduhr) |
+| Pilot / Übungsrepo `--strict-overlay` nach der Hebung | Pilot **1 Fehler, 2 Warnungen**, alle im projekteigenen `CHANGELOG.md`, unverändert; Übungsrepo **0 Fehler, 1 Warnung** (Laufzeitfassung 6.095 Zeichen, unverändert); Auskunft im Pilot weiterhin **38** |
+| Bau | alle drei Word-Fassungen `v1.7.0` in `build/out/` (2.059.134 / 2.060.426 / 2.055.083 Bytes für `devin-desktop` / `claude-code` / `openai-codex`), im Erzeugnis nachgezählt: Dokumentversion `1.7.0`, *„89 Prüfungen“*, je sechsmal `install.cmd`, fünfzehnmal `--target`, zweimal `install_dialog.py` |
+
+## 5. Nebenhandlungen außerhalb des Kerns
+
+- Signierte Marke `v1.6.0` (vom Owner gesetzt, `Good "git" signature`) **vor** dem
+  Gitea-Release gepusht, remote annotiert. Schritte 5 bis 7 aus `RELEASE_PROCESS.md` 4.1:
+  `koolie-1.6.0.tar.gz`, **552 Dateien** = `git ls-tree` der Marke, kein CRLF (bytegenau
+  gezählt), Lizenz an beiden Stellen gleich, kein `build/out/`; Gitea-Release mit Archiv
+  und Prüfsumme, beide Anhänge bytegleich zurückgelesen.
+- Für die Messung der Mindestversion ist Python 3.8.20 über `uv` in das Benutzerprofil des
+  Meßplatzes installiert worden – außerhalb des Repositoriums.
+
+## 6. Offen und benannt
+
+- 🔴 **Die Abnahme des macOS-Starters auf macOS** (Doppelklick im Finder, Gatekeeper,
+  `/usr/bin/python3` ohne Command Line Tools).
+- Der Starter prüft das Python, mit dem er installiert; die Hooks wählen ihren
+  Interpreter bei der Installation selbst. Ob beides dieselbe Fassung ist, prüft keine
+  Stelle.
+- Der wählbare Lieferumfang – Ziel-Release `1.8.0` (D-366).
+- SmartScreen und Gatekeeper warnen vor den unsignierten Startern; gemessen ist keine der
+  beiden Warnungen.

package/.koolie/core/tests/protocols/2026-09-25-klasse-b-core-laufzeit.md

@@ -0,0 +1,126 @@
+# Protokoll: Die Durchsicht der Klasse B, erster Bereich – und die Grenze ohne Sonde
+
+| Feld | Inhalt |
+|---|---|
+| Datum | 2026-09-25 |
+| Release | `1.9.1` |
+| Änderungsantrag | `CR-2026-143` |
+| Art | Durchsicht der Regeldokumente (Core-Module und Laufzeitschicht) nach `docs/DOCUMENTATION_STANDARD.md`, zwei Klärungspunkte beantwortet, Sonden für die Zeichengrenze – **keine Sitzung mit einem Client, kein Kontingent** |
+| Gegenstand | die elf Core-Module, die neun Dateien der Laufzeitschicht, die Modusbegriffe außerhalb der Register, die `.gitignore` des Quellrepositoriums, die installierte Länge der Wurzel-Anweisung je Pack |
+| Ergebnis | 🟢 **Entschieden, `D-381` bis `D-384`.** Kein Regelinhalt geändert; zehn Core-Module und eine Laufzeitdatei überarbeitet, keine Laufzeitdatei länger; sieben Befunde als Klärungspunkte; `K-124` und `K-126` beantwortet; die Zeichengrenze der Prüfung 4 hat Sonden je Pack |
+
+---
+
+## 1. Was gefragt war
+
+Wiederaufnahmepunkt von `1.9.0`, Punkt 2: die Durchsicht der Klasse B, erster Bereich
+(D-380). Vorher zu klären war, wie eine Änderung an der Laufzeitschicht die Projekte
+erreicht und die Zeichengrenze einhält, und welche der Klärungspunkte `K-123` bis `K-129` in
+dieses Release gehören. Fragen (a) bis (i) vorgelegt am 2026-09-25 und angenommen; zu (c)
+fragte der Owner, woher die Grenze kommt und ob sie sich anheben lässt – beantwortet
+(Vorgabe des Frameworks seit `CR-2026-027` E3, kein technischer Grund) und als `K-130`
+eingeplant. `CR-2026-143` E1 bis E8.
+
+## 2. Messungen vor dem Bau
+
+Je eine Testinstallation je Pack (`install.py --client <pack> --root <leer>`), Zeichen, nicht
+Bytes.
+
+| Träger | `claude-code` | `devin-desktop` | `openai-codex` |
+|---|---|---|---|
+| Wurzel-Anweisung | 11.894 | 11.887 | 12.516 (Grenze gilt nicht) |
+| `00-framework-core.md` | 5.142 | 4.853 | 5.090 |
+| `10-privacy-security.md` | 5.168 | 4.801 | 5.160 |
+| `15-development-rules.md` | 3.670 | 3.303 | 3.662 |
+| `20-project-overlay.md` | 3.899 | 3.609 | 3.846 |
+
+Die Quelle `framework/runtime/root-instruction.md` hat 11.924 Zeichen. **Nach dem Bau sind
+die Werte der Wurzel-Anweisung unverändert** (Bündel `sonden_zeichengrenze`, siehe
+Abschnitt 4); die Laufzeitregeln sind unverändert, `fw-reviewer.md` hat 1.610 statt 1.612
+Zeichen.
+
+## 3. Die Durchsicht
+
+Fünf parallele Durchgänge nach einem gemeinsamen schriftlichen Auftrag (Kriterien der Klasse
+B, harte Grenzen: kein Regelinhalt, keine Nummer, kein Anker, keine längere Laufzeitdatei;
+Validator nach jeder Datei). Registereinträge, Sonden und Versionen danach in einem Schritt.
+
+| Durchgang | Geändert | Sachlich berichtigt |
+|---|---|---|
+| `00`, `01`, `04`, `06`, `07` | alle fünf; `01` drei Herleitungen durch D-105, D-291, D-114 ersetzt; Anführungszeichen in `04`, `06`, `07` | `00`: Verweis auf Anhang 31.4 (der alte Anhangtitel existiert nicht mehr); `06`: der Aufrufweg eines Skills galt als werkzeugneutral `/skill-name` `[DOK]`, bei `openai-codex` steht er auf `BELEG OFFEN` – jetzt Verweis auf Zeile S2 der Fähigkeitsmatrix |
+| `02`, `03` | beide; `03` Herleitungen zu D-59, D-76, D-22 ersetzt, `K-126` an vier Stellen | `02`: der Schutz-Hook prüft Lese-, Such-, Schreib- und Ausführungsanfragen (D-33, `hooks.json`), nicht nur die letzten beiden; *„und war es nie“* war falsch (D-59); `03`: ein Querverweis, *„beider Fachmatrizen“* bei drei Packs |
+| `05`, `10` | `05`; `10` unverändert | `05`: *„der eine Client“* durch den Verweis auf `skill_frontmatter.drop_fields` ersetzt |
+| `08`, `09` | beide; `08` Herleitung zu D-303 gestrichen, `09` Herleitung zu D-54 | `08`: der Ablagepfad je Client steht im Laufzeitglossar, Alternativpfade im Pack |
+| Laufzeitschicht | nur `agents/fw-reviewer.md` | der Herkunftskommentar nannte `allowed-tools` als Feld des Clients; `install.py` setzt den Feldnamen je Pack (`agent_frontmatter.tools_field`) |
+
+**Befunde, die eine Entscheidung brauchen** – als Klärungspunkte angelegt, nicht behoben
+(D-381 (b)):
+
+| Kennung | Fundstelle | Befund |
+|---|---|---|
+| `K-131` | `08-skill-conventions.md` Abschnitt 3 | *„ausschließlich belegte Felder“* beschreibt die gerenderte Fassung, nicht die Quelle |
+| `K-132` | `09-risk-model.md` R12 | *„erweiterte Permission-Modi“* als hoch – nicht abgegrenzt gegen D-05 und D-35 |
+| `K-133` | `rules/00-framework-core.md` | M1 als Standardmodus ohne Grundlage im Core-Modul |
+| `K-134` | `10-error-escalation.md`, `05-working-model.md` | Kennung S3 doppelt belegt; S2 ohne Bereitstellung ohne Eskalationsstufe |
+| `K-135` | `rules/10-privacy-security.md` | pauschal hoch, wo R3/R4 mittel sagen |
+| `K-136` | `clients/openai-codex/CLIENT_PACK.md` H4 | die Grenze des Hooks (D-63) nicht genannt |
+| `K-137` | `02-privacy.md` Abschnitt 1.2 | Verweis auf `K-20`, das nur ein Pack betrifft |
+
+**Modusbegriffe (`K-126`, D-382):** umgestellt an 16 Stellen in 13 Dokumenten außerhalb der
+Register (`03` drei, `05`, `09`, das Onboarding fünf, sechs weitere je eine); der Testkatalog (`FW-NE-03`), das Testblatt von `fw-change-small` und das Decision
+Log bleiben, wie sie geschrieben wurden. Die Kapitelquellen des Hauptdokuments nennen die
+Namen schon ausdrücklich als die von `devin-desktop` (`05-glossar.md`, `09-betriebsmodi.md`).
+
+## 4. Wirkungsnachweis – Sonden und Gegenproben, mit Gegenbeweis
+
+| Einheit | Gegenstand | Ergebnis |
+|---|---|---|
+| Sonde 45e | `/.codex/` fehlt in der `.gitignore` des Quellrepositoriums | gemeldet |
+| Gegenprobe 45c | `.codex` statt `/.codex/` | unbeanstandet |
+| Sonde 4a | Wurzel-Anweisung einer `claude-code`-Installation auf 12.001 Zeichen verlängert | gemeldet |
+| Gegenproben 4a, 4b, 4c | frische Installation je Pack | unbeanstandet; `openai-codex` bei 12.516 Zeichen, weil die Grenze dort nicht gilt |
+
+**Gegenbeweis (Gegenstand 3 der Prüfung 45):** Der neue Validator gegen die `.gitignore` von
+`v1.9.0` meldet **fünf** Befunde – `/.claude`, `/.codex`, `/.mcp.json.example`,
+`/CLAUDE.local.md.example`, `/CLAUDE.md`. Und
+der Validator aus `v1.9.0` gegen eine Kopie des fertigen Baums ohne die Zeile `/.codex/`:
+**0 Fehler** – er kennt den Gegenstand nicht; der neue gegen dieselbe Kopie: **1 Fehler**,
+genau diese Zeile (die vier Warnungen beider Läufe kommen aus der Kopie ohne Repositorium).
+
+## 5. Abnahme
+
+| Lauf | Ergebnis |
+|---|---|
+| Validator | **0 Fehler, 0 Warnungen**, beide Kodierungsumgebungen |
+| Sondenlauf | **344 Einheiten, alle bestanden** (vorher 341; neu Sonde 45e, Gegenprobe 45c und das Bündel `sonden_zeichengrenze`), beide Kodierungsumgebungen Exit 0 und oberhalb der Trennlinie zeilengleich (600 Zeilen), rund 660 s Wanduhr je Lauf; **Abnahmelauf gegen den fertigen Baum** zeilengleich |
+| Gegenbeweis | Validator aus `v1.9.0` gegen den Baum ohne `/.codex/`: 0 Fehler; der neue: 1 Fehler (Abschnitt 4) |
+| Pilot / Übungsrepo `--strict-overlay` nach der Hebung | beide mit `--target --update`, **557 Kerndateien**, `LIEFERUMFANG` = `voll`; aktualisiert nur `fw-reviewer` und `fw-change-small` (`SKILL.md`, `CHANGELOG.md`). Pilot **1 Fehler, 2 Warnungen**, alle im projekteigenen `CHANGELOG.md`; Übungsrepo **0 Fehler, 1 Warnung** (Länge der eigenen Regeldatei) – beide unverändert zum Vorstand. Overlay `0.3.15` bzw. `1.4.9`, lokal committet |
+| Bau | alle drei Word-Fassungen `v1.9.1` in `build/out/` (1.949.550 / 1.950.830 / 1.945.428 Bytes für `devin-desktop` / `claude-code` / `openai-codex`), im Erzeugnis nachgezählt: Dokumentversion `1.9.1`, *„94 Prüfungen über 557 versionierte Dateien“* (Prüfung 78), Kapitel 31.1 mit **557** Dateien und **78** installierten Dateien je Pack, eingesetzt vom Bau; die eingebetteten Core-Module führen den Sachbegriff des Modus |
+
+## 6. Nebenhandlungen außerhalb des Kerns
+
+- Signierte Marke `v1.9.0` (vom Owner gesetzt, `Good "git" signature`) **vor** dem
+  Gitea-Release gepusht. Schritte 5 bis 7 aus `RELEASE_PROCESS.md` 4.1 mit
+  `-c tar.umask=022`: `koolie-1.9.0.tar.gz`, **562 Dateien** = `git ls-tree` der Marke, kein
+  CRLF, `install.command` `0755`, alle übrigen 561 Dateien `0644`, Lizenz an beiden Stellen
+  gleich, kein `build/out/`; zweimal erzeugt, bytegleich. Gitea-Release mit Archiv und
+  Prüfsumme, beide Anhänge bytegleich zurückgelesen.
+
+## 7. Befunde während des Baus
+
+- **Die Zeichengrenze der Prüfung 4 hatte keine Sonde** – weder für den Fehler noch für den
+  ausgelieferten Stand je Pack. Gefunden beim Vorbereiten von (c).
+- **Ein Durchgang hat in drei seiner Dateien mit einem Ersetzungsskript Text zerstört** und die
+  Dateien vor dem Neuaufbringen aus dem Repositorium zurückgesetzt; der Endstand ist gültiges
+  UTF-8 mit CRLF und validiert still. Die Harte Regel *„Ersetzungen mit Python und
+  `newline=""`“* hat den Schaden nicht verhindert, die Rücksetzung auf den Index hat ihn
+  begrenzt.
+- **Ein Durchgang setzte einen Packnamen als Handelnden in den Kern** (*„kennt `claude-code`
+  für Skills nicht“*). Prüfung 14 erkennt Produktnamen, nicht Packkennungen in Backticks; die
+  Stelle verweist jetzt auf das Manifestfeld.
+
+## 8. Offen und benannt
+
+- `K-130` bis `K-137`; `K-128` für `1.9.2`, `K-123`, `K-125`, `K-127`, `K-129`, `K-136` für
+  `1.10.0` (D-384).
+- Die Abnahme des macOS-Starters auf macOS (aus `1.7.0`).