kimal3 0.2.3 → 0.2.5

package/README.md

@@ -1,134 +1,136 @@
-# kimal3
-
-**Trag deine KI-Projekte dort ein, wo sie entstehen: im Terminal.**
-
-Wer mit Claude Code arbeitet, baut echte Dinge — und dokumentiert sie hinterher nicht,
-weil das ein zweiter Arbeitsschritt in einem anderen Fenster wäre. `kimal3` schließt
-diese Lücke: Am Ende einer Sitzung trägt Claude das fertige Projekt selbst in dein
-KImal3-Erfolgsprofil ein. Du gibst es dort nur noch frei.
-
-> **Voraussetzung: ein KImal3-Konto mit Pro.**
-> Ohne Pro meldet sich dieses Werkzeug ab, ohne etwas zu tun.
-> Was Pro enthält und wie du es bekommst: **https://app.kimal3.de/pro**
-
-## Loslegen
-
-Einmal pro Rechner:
-
-```bash
-npm install -g kimal3   # das Werkzeug installieren (setzt Node.js voraus)
-kimal3 login            # diesen Rechner mit deinem Konto verbinden
-kimal3 skill install    # Claude beibringen, das Werkzeug zu benutzen
-```
-
-> **In Claude Code?** Dann lass es einrichten, statt es zu tippen — der Satz zum Kopieren steht
-> auf **https://app.kimal3.de/pro**. Nur `kimal3 login` tippst du selbst (dort mit `!`
-> davor), weil die Bestätigung im Browser einen Menschen braucht.
-
-`login` zeigt dir eine Adresse und einen achtstelligen Code. Die Adresse rufst du selbst
-auf und bestätigst den Code dort in deinem eingeloggten Konto — so wie bei `gh auth login`.
-**Es wird kein Passwort ins Terminal getippt.**
-
-## Befehle
-
-```
-kimal3                    Zeigt, ob dieser Rechner angemeldet ist
-kimal3 login              Diesen Rechner mit deinem Konto verbinden
-kimal3 skill install      Claude beibringen, dieses Werkzeug zu benutzen — und dir die /k3-Befehle geben
-kimal3 arbeitsplatz neu   Den ganzen KI-Arbeitsplatz anlegen — Firmenebene und Werkbank
-kimal3 werkbank neu       Nur eine eigene Werkbank in einer bestehenden Firma anlegen
-kimal3 kontext runter     Den Firmenkontext holen — CLAUDE.md und die fünf Dateien in kontext/
-kimal3 kontext fragen     Zeigen, welche Fragen über deine Firma noch unbeantwortet sind
-kimal3 kontext hoch       Deine lokalen Änderungen an den fünf Kontext-Dateien hochschicken
-kimal3 projekt neu …      Ein Projekt ins Erfolgsprofil eintragen
-kimal3 projekt liste      Deine eingetragenen Projekte anzeigen
-kimal3 firma daten        Die Daten deiner Firma holen, damit Claude sie auswerten kann
-kimal3 wache              Läuft von selbst, einmal am Tag: prüft Zugang, Nachricht, Version, Skill
-kimal3 wache aus          Die tägliche Prüfung abschalten — sie sagt dann nichts mehr
-kimal3 wache an           Sie wieder einschalten
-kimal3 logout             Verbindung wieder aufheben
-```
-
-Mehr zu einem Befehl: `kimal3 projekt neu --help`
-
-## Was eingetragen wird
-
-Nur, was du eingibst — Titel, Beschreibung, optional ein Link. **Dein Code wird nicht
-gelesen, nicht hochgeladen und nicht analysiert.** Das Werkzeug schreibt ausschließlich
-über die KImal3-App und hat keinen eigenen Datenbankzugang.
-
-Eingetragene Projekte sind zunächst **nicht öffentlich**. Sie erscheinen in deinem
-Erfolgsprofil, und du entscheidest dort, was sichtbar wird.
-
-## Rückgabewerte
-
-Für Skripte und für Claude selbst:
-
-| Wert | Bedeutung | Hilft |
-|---|---|---|
-| `0` | hat geklappt | — |
-| `1` | Eingabe unvollständig, nichts gefunden — oder deine Claude-Einstellungen sind nicht lesbar | die Meldung lesen, sie nennt den Fall |
-| `2` | nicht angemeldet | `kimal3 login` |
-| `3` | gerade nicht erreichbar | später noch einmal |
-| `4` | kein Pro-Konto | erneutes Versuchen hilft **nicht** |
-
-Der Unterschied zwischen `3` und `4` ist Absicht: Bei `3` lohnt ein zweiter Versuch,
-bei `4` nie.
-
-## Update-Hinweise
-
-Steht eine neuere Fassung bereit, schreibt `kimal3` nach dem Befehl eine eingerückte
-Zeile — höchstens **einmal am Tag**:
-
-```
-  →  kimal3 0.2.0 ist da.  npm i -g kimal3@latest && kimal3 skill install
-```
-
-Sie geht auf **stderr**, nicht auf stdout: `kimal3 firma daten > firma.json` bleibt
-damit sauberes JSON. Sie **ändert den Rückgabewert nicht** — eine `0` bleibt eine `0`.
-Und `kimal3` **installiert nichts von selbst**; der Befehl steht in der Zeile, ausführen
-tust du ihn.
-
-Dasselbe gilt für die Skill-Dateien: Sind die in `~/.claude/skills/kimal3/` älter als
-das installierte Werkzeug, sagt `kimal3` es — dafür braucht es kein Netz.
-
-## Die tägliche Prüfung — und wie du sie abstellst
-
-`kimal3 skill install` trägt eine Zeile in deine Claude-Einstellungen ein
-(`~/.claude/settings.json`). Sie sorgt dafür, dass beim Start von Claude einmal am Tag
-`kimal3 wache` läuft. Die Prüfung sieht nach, ob dein Zugang noch gilt, ob eine neuere
-Fassung bereitsteht, ob deine `/k3`-Befehle veraltet sind und ob eine Nachricht von uns
-anliegt.
-
-**Sie meldet sich nur, wenn wirklich etwas ansteht.** Ist alles in Ordnung, sagt sie nichts.
-
-Willst du sie nicht:
-
-```
-kimal3 wache aus     # ab jetzt still
-kimal3 wache an      # doch wieder
-```
-
-Nach `kimal3 wache aus` wird **nichts mehr an unseren Server geschickt** — die Prüfung
-steigt aus, bevor sie irgendetwas fragt. Gemessen: mit Prüfung rund 0,9 Sekunden, ohne
-rund 0,19 Sekunden, und in den 0,19 Sekunden verlässt kein Byte deinen Rechner.
-
-Die Zeile in den Einstellungen bleibt dabei stehen, damit `kimal3 wache an` sofort wirkt
-und wir deine Einstellungsdatei nicht noch einmal anfassen müssen. Es startet also weiter
-ein kleines Programm von uns, das nach rund 0,19 Sekunden wieder aufhört.
-
-**Soll auch das nicht mehr passieren**, nimm die Zeile selbst heraus: In
-`~/.claude/settings.json` steht unter `hooks` → `SessionStart` ein Eintrag mit dem Befehl
-`kimal3 wache`. Lösch diesen einen Eintrag — den Rest der Datei lass, wie er ist.
-
-## Voraussetzungen
-
-Node.js 20 oder neuer. Sonst nichts — das Werkzeug bringt **keine fremden Bibliotheken**
-mit.
-
-## Lizenz
-
-Proprietär. Die Nutzung ist Inhabern eines gültigen KImal3-Pro-Kontos gestattet;
-Weitergabe, Veränderung und Weiterverwendung des Codes sind nicht erlaubt.
-
-© KImal3 · https://kimal3.de
+# kimal3
+
+**Trag deine KI-Projekte dort ein, wo sie entstehen: im Terminal.**
+
+Wer mit Claude Code arbeitet, baut echte Dinge — und dokumentiert sie hinterher nicht,
+weil das ein zweiter Arbeitsschritt in einem anderen Fenster wäre. `kimal3` schließt
+diese Lücke: Am Ende einer Sitzung trägt Claude das fertige Projekt selbst in dein
+KImal3-Erfolgsprofil ein. Du gibst es dort nur noch frei.
+
+> **Voraussetzung: ein KImal3-Konto mit Pro.**
+> Ohne Pro meldet sich dieses Werkzeug ab, ohne etwas zu tun.
+> Was Pro enthält und wie du es bekommst: **https://app.kimal3.de/pro**
+
+## Loslegen
+
+Einmal pro Rechner:
+
+```bash
+npm install -g kimal3   # das Werkzeug installieren (setzt Node.js voraus)
+kimal3 login            # diesen Rechner mit deinem Konto verbinden
+kimal3 skill install    # Claude beibringen, das Werkzeug zu benutzen
+```
+
+> **In Claude Code?** Dann lass es einrichten, statt es zu tippen — der Satz zum Kopieren steht
+> auf **https://app.kimal3.de/pro**. Nur `kimal3 login` tippst du selbst (dort mit `!`
+> davor), weil die Bestätigung im Browser einen Menschen braucht.
+
+`login` zeigt dir eine Adresse und einen achtstelligen Code. Die Adresse rufst du selbst
+auf und bestätigst den Code dort in deinem eingeloggten Konto — so wie bei `gh auth login`.
+**Es wird kein Passwort ins Terminal getippt.**
+
+## Befehle
+
+```
+kimal3                    Zeigt, ob dieser Rechner angemeldet ist
+kimal3 login              Diesen Rechner mit deinem Konto verbinden
+kimal3 skill install      Claude beibringen, dieses Werkzeug zu benutzen — und dir die /k3-Befehle geben
+kimal3 arbeitsplatz neu   Den ganzen KI-Arbeitsplatz anlegen — Firmenebene und Werkbank
+kimal3 werkbank neu       Nur eine eigene Werkbank in einer bestehenden Firma anlegen
+kimal3 kontext runter     Den Firmenkontext holen — CLAUDE.md und die fünf Dateien in kontext/
+kimal3 kontext fragen     Zeigen, welche Fragen über deine Firma noch unbeantwortet sind
+kimal3 kontext hoch       Deine lokalen Änderungen an den fünf Kontext-Dateien hochschicken
+kimal3 projekt neu …      Ein Projekt ins Erfolgsprofil eintragen
+kimal3 projekt liste      Deine eingetragenen Projekte anzeigen
+kimal3 firma daten        Die Daten deiner Firma holen, damit Claude sie auswerten kann
+kimal3 wache              Läuft von selbst, einmal am Tag: prüft Zugang, Nachricht, Version, Skill
+kimal3 wache aus          Die tägliche Prüfung abschalten — sie sagt dann nichts mehr
+kimal3 wache an           Sie wieder einschalten
+kimal3 logout             Verbindung wieder aufheben
+```
+
+Mehr zu einem Befehl: `kimal3 projekt neu --help`
+
+## Was eingetragen wird
+
+Nur, was du eingibst — Titel, Beschreibung, optional ein Link. **Dein Code wird nicht
+gelesen, nicht hochgeladen und nicht analysiert.** Das Werkzeug schreibt ausschließlich
+über die KImal3-App und hat keinen eigenen Datenbankzugang.
+
+Eingetragene Projekte sind zunächst **nicht öffentlich**. Sie erscheinen in deinem
+Erfolgsprofil, und du entscheidest dort, was sichtbar wird.
+
+## Rückgabewerte
+
+Für Skripte und für Claude selbst:
+
+| Wert | Bedeutung | Hilft |
+|---|---|---|
+| `0` | hat geklappt | — |
+| `1` | Eingabe unvollständig, nichts gefunden — oder deine Claude-Einstellungen sind nicht lesbar | die Meldung lesen, sie nennt den Fall |
+| `2` | nicht angemeldet | `kimal3 login` |
+| `3` | gerade nicht erreichbar | später noch einmal |
+| `4` | kein Pro-Konto | erneutes Versuchen hilft **nicht** |
+
+Der Unterschied zwischen `3` und `4` ist Absicht: Bei `3` lohnt ein zweiter Versuch,
+bei `4` nie.
+
+## Update-Hinweise
+
+Steht eine neuere Fassung bereit, schreibt `kimal3` nach dem Befehl eine eingerückte
+Zeile — höchstens **einmal am Tag**:
+
+```
+  →  kimal3 0.2.0 ist da.  npm i -g kimal3@latest && kimal3 skill install
+```
+
+Sie geht auf **stderr**, nicht auf stdout: `kimal3 firma daten > firma.json` bleibt
+damit sauberes JSON. Sie **ändert den Rückgabewert nicht** — eine `0` bleibt eine `0`.
+Und `kimal3` **installiert nichts von selbst**; der Befehl steht in der Zeile, ausführen
+tust du ihn.
+
+Dasselbe gilt für die Skill-Dateien: Sind die in `~/.claude/skills/kimal3/` älter als
+das installierte Werkzeug, sagt `kimal3` es — dafür braucht es kein Netz.
+
+## Die tägliche Prüfung — und wie du sie abstellst
+
+`kimal3 skill install` trägt eine Zeile in deine Claude-Einstellungen ein
+(`~/.claude/settings.json`). Sie sorgt dafür, dass beim Start von Claude einmal am Tag
+`kimal3 wache` läuft. Die Prüfung sieht nach, ob dein Zugang noch gilt, ob eine neuere
+Fassung bereitsteht, ob deine `/k3`-Befehle veraltet sind und ob eine Nachricht von uns
+anliegt.
+
+**Sie meldet sich nur, wenn wirklich etwas ansteht.** Ist alles in Ordnung, sagt sie nichts.
+
+Willst du sie nicht:
+
+```
+kimal3 wache aus     # ab jetzt still
+kimal3 wache an      # doch wieder
+```
+
+Nach `kimal3 wache aus` wird **nichts mehr an unseren Server geschickt** — die Prüfung
+steigt aus, bevor sie irgendetwas fragt. Gemessen: mit Prüfung rund 0,9 Sekunden, ohne
+rund 0,19 Sekunden, und in den 0,19 Sekunden verlässt kein Byte deinen Rechner.
+
+Die Zeile in den Einstellungen bleibt dabei stehen, damit `kimal3 wache an` sofort wirkt
+und wir deine Einstellungsdatei nicht noch einmal anfassen müssen. Es startet also weiter
+ein kleines Programm von uns, das nach rund 0,19 Sekunden wieder aufhört.
+
+**Soll auch das nicht mehr passieren**, nimm die Zeile selbst heraus: In
+`~/.claude/settings.json` steht unter `hooks` → `SessionStart` ein Eintrag, dessen Befehl
+mit `kimal3 wache` beginnt (heute: `kimal3 wache --hook`, in älteren Installationen ohne
+den Zusatz). ⚠️ **Der Zusatz `--hook` gehört in die Einstellungsdatei, nicht ins Terminal** —
+getippt wird immer nur `kimal3 wache`. Lösch diesen einen Eintrag — den Rest der Datei lass, wie er ist.
+
+## Voraussetzungen
+
+Node.js 20 oder neuer. Sonst nichts — das Werkzeug bringt **keine fremden Bibliotheken**
+mit.
+
+## Lizenz
+
+Proprietär. Die Nutzung ist Inhabern eines gültigen KImal3-Pro-Kontos gestattet;
+Weitergabe, Veränderung und Weiterverwendung des Codes sind nicht erlaubt.
+
+© KImal3 · https://kimal3.de

package/dist/befehle/wache.js

@@ -5,7 +5,7 @@ import { leseGesehen, merkeGesehen } from "../gesehen.js";
 import { heuteAus, sollZeigen, skillZustand } from "../nachricht.js";
 import { eigeneVersion } from "../version.js";
 import { leseWacheDatei, merkeLauf, merkeSitzung, setzeWache, sitzungJetzt, sollHeuteLaufen, } from "../wache-schalter.js";
-import { wacheAntwortAusHttp, wacheZeilen } from "../wache-rechnung.js";
+import { alsHookAusgabe, wacheAntwortAusHttp, wacheBlock, wacheZeilen } from "../wache-rechnung.js";
 import { skillDatei } from "./skill-install.js";
 /**
  * 🔴 BEWUSSTE VORGABE, KEINE MESSUNG (Aufgabe 0b ist vertagt). Der bestehende
@@ -119,8 +119,21 @@ async function frageServer(schluessel, heute) {
  *   2. keine Anmeldedatei    -> still, KEIN NETZAUFRUF (US-5)
  *   3. heute schon gelaufen  -> still, kein Netz
  * Erst danach wird ueberhaupt telefoniert.
+ *
+ * `alsHook` sagt, WOHIN die Meldung geht -- nicht, OB sie kommt. Beide Wege
+ * rechnen dieselben Zeilen aus; sie unterscheiden sich nur in der Verpackung.
+ *   - `false`: ein Mensch hat `kimal3 wache` getippt und liest die Zeilen.
+ *   - `true` : Claude Code hat sie beim Sitzungsstart gestartet. Dann geht die
+ *     Meldung in der JSON-Huelle raus, die einen Absturz beim Beenden
+ *     ueberlebt (Begruendung an `alsHookAusgabe`).
+ *
+ * 🔴 WARUM EIN ARGUMENT UND NICHT DIE UMGEBUNG: `CLAUDE_CODE_SESSION_ID` liegt
+ * auch dann an, wenn ein Mensch `! kimal3 wache` im Claude-Fenster tippt --
+ * gemessen am 2026-09-09. Wer daran erkennen wollte, ob er ein Startbefehl
+ * ist, bekaeme genau dort rohes JSON auf den Bildschirm statt seiner Meldung.
+ * *Das Erkennungsmerkmal muss die Aufrufstelle setzen, nicht der Ort raten.*
  */
-export async function wache() {
+export async function wache(alsHook) {
     try {
         const heute = heuteAus(new Date());
         /*
@@ -155,12 +168,10 @@ export async function wache() {
         // 🔴 VOR der Ausgabe -- sonst spricht die Wache bei einem Fehler in der
         // Ausgabe morgen wieder und uebermorgen wieder.
         merkeLauf(heute);
-        if (zeilen.length === 0)
-            return 0; // 🔴 Stille heisst WIRKLICH nichts --
-        // auch keine leere Kopfzeile.
-        console.log("🔑 kimal3");
-        for (const z of zeilen)
-            console.log(`• ${z}`);
+        const block = wacheBlock(zeilen);
+        if (block === null)
+            return 0;
+        console.log(alsHook ? alsHookAusgabe(block) : block);
         // Erst NACH dem Drucken vermerken, dass die Nachricht heute schon lief --
         // dieselbe Reihenfolge wie beim Update-Kanal in kimal3.ts.
         if (vomServer.hinweis)

package/dist/einstellungen-mischen.js

@@ -9,6 +9,11 @@
  * Arbeitsplatz des Menschen. Das Lesen und Schreiben wohnt in
  * `befehle/skill-install.ts`, samt Sicherungskopie und Zurueckkontrolle.
  */
+/**
+ * Woran wir einen Eintrag als UNSEREN erkennen -- unabhaengig davon, welche
+ * Argumente wir spaeter einmal anhaengen. Siehe `istUnserer`.
+ */
+export const WACHE_MARKE = "kimal3 wache";
 /**
  * Der Befehl, der in die Einstellungen eingetragen wird.
  *
@@ -17,8 +22,22 @@
  * wir nicht. Die Fehlerbehandlung gehoert ins Programm, nicht in die Zeile.
  * *Ein Befehl, der beim Erbauer laeuft, ist keine Aussage ueber den Rechner
  * des Kunden.*
+ * 📌 Gemessen am 2026-09-09, und die Regel ist damit teuer bestaetigt: Claude
+ * Code startet einen Startbefehl auf Windows durch die Git-Bash und, wenn die
+ * fehlt, durch die PowerShell. In der PowerShell 5.1 ist `||` ein
+ * Syntaxfehler -- eine Zeile mit `||` haette dort den Startbefehl ganz
+ * umgeworfen. `--hook` ist ein Wort und laeuft in jeder der vier Huellen.
+ *
+ * 🔑 WOFUER `--hook` DA IST: Claude Code wirft die AUSGABE eines Startbefehls
+ * weg, sobald er einen Rueckgabewert ungleich 0 meldet (gemessen 2026-09-09:
+ * 0 -> Meldung kommt an, 1 und 127 -> nichts kommt an). `kimal3` stuerzt auf
+ * Windows gelegentlich beim BEENDEN ab, nachdem die Meldung vollstaendig
+ * geschrieben ist -- die Wache haette also stumm dagestanden, obwohl sie ihre
+ * Arbeit getan hatte. Mit `--hook` schreibt sie ihre Meldung stattdessen in
+ * der JSON-Form, die Claude Code fuer Startbefehle vorsieht, und die wird
+ * AUCH BEI RUECKGABEWERT 127 gelesen (ebenfalls gemessen).
  */
-export const WACHE_BEFEHL = "kimal3 wache";
+export const WACHE_BEFEHL = `${WACHE_MARKE} --hook`;
 /**
  * Wie lange Claude auf die Wache wartet, in Sekunden.
  *
@@ -40,11 +59,19 @@ function istObjekt(wert) {
  * Wachen auf, und die alte zeigte auf etwas, das es nicht mehr gibt. Weder
  * Compiler noch Waechter faenden das -- es sieht ja aus wie ein fremder
  * Eintrag, den man hoeflich in Ruhe laesst.
+ *
+ * 🔴 ERKANNT WIRD AN DER MARKE, NICHT AM VOLLEN BEFEHL. Genau dieser Fall ist
+ * am 2026-09-09 eingetreten: Der Eintrag hiess `kimal3 wache` und heisst jetzt
+ * `kimal3 wache --hook`. Ein Vergleich gegen den vollen Befehlstext haette den
+ * alten Eintrag fuer fremd gehalten und stehen lassen -- jeder Bestandskunde
+ * haette ab dem naechsten `skill install` ZWEI Wachen bei jedem Claude-Start
+ * gestartet. *Die Vorsichtsmassnahme, die dieser Kommentar beschreibt, haette
+ * beim ersten echten Anlass versagt, wenn sie am ganzen Text gehangen haette.*
  */
 function istUnserer(eintrag) {
     if (!istObjekt(eintrag))
         return false;
-    return typeof eintrag.command === "string" && eintrag.command.includes(WACHE_BEFEHL);
+    return typeof eintrag.command === "string" && eintrag.command.includes(WACHE_MARKE);
 }
 export function mischeEinstellungen(alt, befehl) {
     /*

package/dist/kimal3.js

@@ -335,11 +335,34 @@ async function haupt() {
     if (argv[0] === "kontext" && argv[1] === "fragen")
         return kontextFragen(argv.slice(2));
     if (wort === "wache")
-        return wache();
+        return wache(false);
+    // 🔴 Der Startbefehl aus `~/.claude/settings.json`, den `skill install`
+    // eintraegt. Er verpackt die Meldung anders -- Begruendung an `wache()`.
+    // ⚠️ Ein Mensch tippt das nie; der Katalog nennt ihn deshalb auch nicht.
+    if (wort === "wache --hook")
+        return wache(true);
     if (wort === "wache aus")
         return wacheSchalten(false);
     if (wort === "wache an")
         return wacheSchalten(true);
+    /*
+      🔴 NACHSICHT GEGENUEBER FLAGGEN, DIE ES HIER NOCH NICHT GIBT.
+      Der Eintrag in `~/.claude/settings.json` ueberlebt jede Neuinstallation --
+      auch eine, die eine AELTERE Fassung bringt. Steht dort eines Tages
+      `wache --irgendwas`, das diese Fassung nicht kennt, faellt der Aufruf ohne
+      diese Zeile in den Unbekannt-Zweig: die volle Hilfe bei JEDEM Claude-Start,
+      Rueckgabewert 1, und `merkeSitzung` wird nie erreicht -- woraufhin
+      `wacheAusgefallen` bei jedem weiteren Befehl einen Rat gibt, der nichts
+      behebt. Aus einem fehlenden Zusatz wird so ein lauter Dauerschaden.
+      🔑 Warum die MENSCHEN-Form die richtige Rueckfallebene ist: Sie endet
+      normal mit 0, ihre Meldung kommt also an. Die JSON-Form waere fuer einen
+      Menschen, der aus Neugier eine Flagge tippt, nur Kauderwelsch.
+      ⚠️ Fuer bereits veroeffentlichte Fassungen ist das nicht mehr zu retten --
+      `0.2.3` kennt `--hook` nicht. Diese Zeile sorgt dafuer, dass die naechste
+      Flagge die Falle nicht erneut stellt. (Befund der Durchsicht, 2026-09-09.)
+    */
+    if (argv[0] === "wache" && argv.slice(1).every((a) => a.startsWith("--")))
+        return wache(false);
     console.error(`Den Befehl „${wort}" kenne ich nicht.\n${HILFE}`);
     return 1;
 }

package/dist/wache-rechnung.js

@@ -88,6 +88,51 @@ export function wacheAntwortAusHttp(status, koerper) {
         return { zugangGilt: true, hinweis: null };
     return { zugangGilt: true, hinweis: nachrichtAusAntwort(koerper) };
 }
+/**
+ * Die fertige Meldung -- oder `null`, wenn nichts zu sagen ist.
+ *
+ * 🔑 EINE QUELLE FUER BEIDE AUSGABEWEGE. Dieselben Zeilen gehen einmal ins
+ * Terminalfenster und einmal in die JSON-Huelle fuer den Startbefehl. Waeren
+ * es zwei Textstellen, wuerden sie auseinanderlaufen, und niemand saehe es:
+ * Den einen Weg liest ein Mensch, den anderen nur Claude.
+ *
+ * 🔴 `null` HEISST WIRKLICH NICHTS -- auch keine leere Kopfzeile. Ein
+ * Startbefehl, der jeden Morgen ein einsames „🔑 kimal3" in den Kontext
+ * schreibt, ist Laerm, und Laerm bringt Menschen dazu, die eine Meldung zu
+ * ueberlesen, auf die es ankommt.
+ */
+export function wacheBlock(zeilen) {
+    if (zeilen.length === 0)
+        return null;
+    return ["🔑 kimal3", ...zeilen.map((z) => `• ${z}`)].join("\n");
+}
+/**
+ * Dieselbe Meldung in der Form, die einen Absturz beim Beenden ueberlebt.
+ *
+ * 🔴 WARUM DAS NOETIG IST (gemessen am 2026-09-09): Claude Code wirft die
+ * Ausgabe eines Startbefehls WEG, sobald dieser einen Rueckgabewert ungleich 0
+ * meldet -- gemessen mit 1 und mit 127, beide Male kam nichts an. `kimal3`
+ * stuerzt auf Windows gelegentlich beim Beenden ab (libuv), und zwar
+ * NACHDEM die Meldung vollstaendig geschrieben ist. Die Wache haette also
+ * geschwiegen, obwohl sie ihre Arbeit getan hatte -- und niemand haette es
+ * gemerkt.
+ *
+ * 🔑 DIESE FORM WIRD AUCH BEI 127 GELESEN (ebenfalls gemessen, inklusive
+ * Laerm auf stderr und mit Umlauten). Und der Rueckgabewert bleibt trotzdem
+ * sichtbar: Claude Code protokolliert den Lauf weiter mit
+ * `exit_code: 127, outcome: "error"`. *Wir retten die Meldung, ohne das
+ * Signal „die Wache ist wirklich kaputt" zu loeschen* -- ein `|| exit 0` in
+ * der Befehlszeile haette genau das getan.
+ *
+ * ⚠️ Die Feldnamen sind vorgegeben und muessen GENAU so heissen; steht
+ * `additionalContext` eine Ebene zu weit oben, wird es stillschweigend
+ * ignoriert.
+ */
+export function alsHookAusgabe(block) {
+    return JSON.stringify({
+        hookSpecificOutput: { hookEventName: "SessionStart", additionalContext: block },
+    });
+}
 /**
  * Die Zeile, die erscheint, wenn die Wache fuer diese Claude-Sitzung nicht
  * nachgesehen hat.

package/package.json

@@ -1,27 +1,27 @@
-{
-  "name": "kimal3",
-  "version": "0.2.3",
-  "description": "Trag deine KI-Projekte dort ein, wo sie entstehen: im Terminal.",
-  "type": "module",
-  "bin": {
-    "kimal3": "dist/kimal3.js"
-  },
-  "files": [
-    "dist",
-    "skill",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "kimal3",
-    "cli"
-  ],
-  "homepage": "https://app.kimal3.de/pro",
-  "license": "SEE LICENSE IN README.md"
-}
+{
+  "name": "kimal3",
+  "version": "0.2.5",
+  "description": "Trag deine KI-Projekte dort ein, wo sie entstehen: im Terminal.",
+  "type": "module",
+  "bin": {
+    "kimal3": "dist/kimal3.js"
+  },
+  "files": [
+    "dist",
+    "skill",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "kimal3",
+    "cli"
+  ],
+  "homepage": "https://app.kimal3.de/pro",
+  "license": "SEE LICENSE IN README.md"
+}