kimal3 0.2.8 → 0.2.9

package/dist/kimal3.js

@@ -390,8 +390,34 @@ function endeMitHinweis(code) {
     
           🔑 DIE NOTBREMSE BLEIBT, und sie ist die einzige Stelle, die noch hart
           beendet: Sie ist `unref`t, haelt die Schleife also nicht am Leben, und
-          feuert nur, wenn ein Kanal wirklich haengt. Nach zwei Sekunden ist die
-          Verbindung von draussen ohnehin zu -- der Absturz droht dort nicht.
+          feuert nur, wenn ein Kanal wirklich haengt.
+    
+          🔬 WARUM ZWEI SEKUNDEN -- gemessen statt behauptet (2026-09-10, nach
+          Review-Runde 1 am PR #31). Hier stand als Begruendung: "nach zwei
+          Sekunden ist die Verbindung von draussen ohnehin zu". Das war die
+          einzige ungemessene Zahl im ganzen Umbau, und der Review vermutete
+          genau darin die Gefahr -- die Notbremse koenne ausgerechnet in dem
+          Augenblick zuschlagen, gegen den dieser Fix gebaut ist.
+          Nachgemessen (echte Netzanfrage, danach hartes Beenden nach N ms, je
+          20 Laeufe, Node 24):
+                0 ms .... 20 von 20 Abstuerzen
+                1 ms .... 17 von 20
+                5 ms .... 14 von 20
+               10 ms ..... 7 von 20
+               25 ms ..... 0 von 20
+               50 ms ..... 0 von 20
+            2 000 ms ..... 0 von 20
+            5 000 ms ..... 0 von 20
+          Das gefaehrliche Fenster ist also rund 25 Millisekunden breit, nicht
+          Sekunden -- die zwei Sekunden liegen achtzigfach dahinter. Der Verdacht
+          des Reviews ist damit widerlegt, und Erhoehen wuerde nichts kaufen: Es
+          wuerde nur den einzigen Fall verlangsamen, in dem die Notbremse
+          ueberhaupt zaehlt (ein Kanal, der wirklich haengt).
+          ⚠️ Gemessen auf Node 24; ausgeliefert wird ab Node 20 (cli/package.json).
+          Auf Node 20 ist es NICHT nachgemessen -- auf diesem Rechner steht keine
+          solche Fassung. Was dagegen spricht, dass es dort anders liegt: Der
+          Abbruch haengt an einem Kanal, der gerade zugeht, und das ist eine Sache
+          von Millisekunden, nicht von Sekunden.
         */
         setTimeout(() => process.exit(code), 2000).unref();
         process.stdout.write("", () => {
@@ -524,8 +550,16 @@ haupt()
     // Kommentar an `endeMitHinweis` verbietet, denn auf Windows sind beide
     // Ausgabekanaele asynchron und `process.exit()` wirft Ausstehendes weg.
     // Ausgerechnet die Fehlermeldung waere das Erste, was verlorengeht.
-    // Beide Faelle entstehen NACH einer Netzanfrage, also drohte hier zusaetzlich
-    // derselbe Absturz wie in `endeMitHinweis` (D-18).
+    // ⚠️ Die beiden Faelle liegen dabei VERSCHIEDEN, und das stand hier bis zur
+    // dritten Review-Runde falsch ("beide entstehen nach einer Netzanfrage"):
+    // `NichtAngemeldet` wird in cli/src/api.ts:117 geworfen, BEVOR die Anfrage
+    // ueberhaupt hinausgeht (der `fetch` steht dort erst in Zeile 171) -- dort
+    // drohte der Absturz aus D-18 also nie. Nur die zweite Meldung ("nicht
+    // erreichbar") kommt nach einer Netzanfrage, und nur fuer sie galt das.
+    // 🔑 Fuer BEIDE gilt dagegen der Grund darueber: Auf Windows sind die
+    // Ausgabekanaele asynchron, und ein hartes Beenden wirft Ausstehendes weg.
+    // *Ein Kommentar, der eine richtige Aenderung halb falsch begruendet, ist
+    // gefaehrlicher als keiner -- der naechste Leser rechnet nicht nach.*
     // 🔑 `exitCode` statt `exit`: Die Zahl stimmt, die Meldung kommt an, und
     // Node laeuft aus, sobald die Kanaele leer sind.
     .catch((f) => {

package/package.json

@@ -1,27 +1,27 @@
-{
-  "name": "kimal3",
-  "version": "0.2.8",
-  "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.9",
+  "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"
+}

package/skill/SKILL.md

@@ -192,6 +192,17 @@ Stelle.
 3. **Die Antwort in die genannte Datei schreiben** — unter ihre `## `-Überschrift, über der der
    Anker steht. Die Hinweiszeilen mit `>` gehören uns; **lass sie stehen und schreib darunter.**
 
+   🔴 **Schreib die Antwort so, dass man sie als Rohtext lesen kann:**
+   - **Eine Zeile nie mitten im Satz umbrechen** — auch nicht, wenn sie lang wird. Ein Absatz
+     ist eine Zeile. Die `>`-Hinweise darüber sind umbrochen; **ahm sie nicht nach.**
+   - **Kein `**fett**`, keine Überschriften, keine Tabellen.**
+   - Mehrere Aussagen werden am besten eine Liste, jede Zeile beginnt mit `- `.
+
+   🔑 **Warum:** In der App (**Firma → Kontext**) steht jede Antwort in einem Eingabefeld, das
+   den Text zeigt, wie er in der Datei steht. Ein Umbruch nach ~100 Zeichen reißt dort den Satz
+   mitten durch, und `**fett**` erscheint als Sternchen — bei jeder Kollegin, die dort liest oder
+   weiterschreibt. *Aufgefallen am 25.09.2026 an unseren eigenen Antworten.*
+
    🔴 **Die Pfade zählen ab dem Ordner, den `kontext fragen` als `Arbeitsplatz:` nennt — nicht
    ab deinem Arbeitsverzeichnis.** Der Normalfall ist, dass beides auseinanderfällt:
    `kimal3 arbeitsplatz neu` rät ausdrücklich, in die **Werkbank** zu wechseln und dort Claude

package/skill/commands/k3feierabend.md

@@ -1,43 +1,97 @@
----
-description: Sitzung sauber beenden — Stand sichern, aufräumen, zusammenfassen
----
-
-<!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
-     jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
-     behalten will, kopiert die Datei unter einem anderen Namen. -->
-# Feierabend
-
-> Sauberer Sitzungs-Abschluss: Stand sichern, aufräumen, zusammenfassen — damit der nächste
-> Start (in diesem oder einem anderen Projekt) sauber weitergeht.
-
-Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: erklär kurz, was du tust, und hol
-dir **vor dem Veröffentlichen (Push)** ein OK. Ist ein Schritt hier nicht relevant, sag das kurz
-und überspring ihn — kein Leerlauf.
-
-## 1. Stand sichten
-- Ist es ein Git-Repo? Dann `git status` + `git diff --stat`: Was wurde in dieser Sitzung
-  geändert? Fass es in 1–2 Sätzen zusammen.
-- Kein Git-Repo? Sag das kurz und biete an, eins einzurichten (Sicherheitsnetz) — erzwing nichts.
-
-## 2. Lebende Dokumente nachziehen
-- **Status-/Übergabe-Doc:** Gibt es eine `WEITER-HIER.md` (oder `ROADMAP.md`)? Aktualisiere
-  „aktueller Stand" + „nächster Schritt" auf das, was heute passiert ist. Sag laut, was du
-  geändert hast. Gibt es keins und die Arbeit wächst über eine Sitzung hinaus: eins vorschlagen.
-- **Coach aktuell halten:** Prüf kurz, ob die `CLAUDE.md` (global oder Projekt) an eine neue
-  Arbeitsweise angepasst gehört — **nur bei echtem Anlass**, nicht als Pflichtübung.
-
-## 3. Aufräumen (leichtgewichtig)
-- Offensichtlichen Müll entfernen (`.DS_Store`, `*.tmp`, `*.log`, `__pycache__`).
-- Bei allem Unklaren: **nicht** löschen — auflisten und mich fragen.
-
-## 4. Sichern (mit meinem OK)
-- Stage die relevanten Änderungen — **niemals** Secrets oder `.env*`.
-- Zeig mir kurz, was in den Commit geht, und schlag eine Commit-Nachricht vor.
-- Nach meinem OK: committen. Dann **frag, ob du pushen sollst** (der Schritt „nach außen").
-  Erst nach meiner Bestätigung `git push`.
-
-## 5. Zusammenfassen & Abschied
-- 2–3 Sätze **ohne Fachjargon**: Was haben wir heute geschafft, was habe ich gelernt.
-- **Ein** konkreter, kleiner nächster Schritt fürs nächste Mal (der Cliffhanger — klein halten).
-- Kurzer, freundlicher Abschied wie ein guter Kollege, der Feierabend macht. Warte auf meine
-  Antwort, bevor die Sitzung endet.
+---
+description: Sitzung sauber beenden — Stand sichern, aufräumen, zusammenfassen
+---
+
+<!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
+     jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
+     behalten will, kopiert die Datei unter einem anderen Namen. -->
+# Feierabend
+
+> Sauberer Sitzungs-Abschluss: Stand sichern, aufräumen, zusammenfassen — damit der nächste
+> Start (in diesem oder einem anderen Projekt) sauber weitergeht.
+
+Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: erklär kurz, was du tust, und hol
+dir **vor dem Veröffentlichen (Push)** ein OK. Ist ein Schritt hier nicht relevant, sag das kurz
+und überspring ihn — kein Leerlauf.
+
+## 1. Stand sichten
+- Ist es ein Git-Repo? Dann `git status` + `git diff --stat`: Was wurde in dieser Sitzung
+  geändert? Fass es in 1–2 Sätzen zusammen.
+- Kein Git-Repo? Sag das kurz und biete an, eins einzurichten (Sicherheitsnetz) — erzwing nichts.
+
+## 2. Status-Datei nachziehen — und aufräumen
+Die Status-Datei (`WEITER-HIER.md` oder `ROADMAP.md`) ist der Zettel für den nächsten Start. Sie
+taugt nur, solange man sie in einem Atemzug lesen kann. **Jeder Feierabend schreibt etwas dazu —
+also muss auch jeder Feierabend etwas wegräumen**, sonst wächst sie, bis niemand sie mehr liest.
+
+Gibt es keine Status-Datei und die Arbeit wächst über eine Sitzung hinaus: eine vorschlagen,
+dann weiter mit Schritt 3.
+
+1. **Nachziehen:** „Wo wir stehen" und „nächster Schritt" auf das setzen, was heute passiert ist.
+2. **Wegräumen, was nicht mehr gilt.** Ins Archiv wandert:
+   - was **erledigt** ist (fertige Aufgaben, abgehakte Punkte),
+   - die Geschichten **früherer Sitzungen** („Davor …", „Stand vom …") — in „Wo wir stehen" bleibt
+     nur der heutige Stand,
+   - was im Text **widerlegt oder überholt** ist.
+   Was bleibt: der aktuelle Stand, der nächste Schritt, die offenen Punkte, und je Idee für später
+   **höchstens zwei Sätze** — Ausführliches bekommt eine eigene Datei, die Status-Datei verlinkt sie.
+3. **Ins Archiv heißt: verschieben, nicht löschen.** Gibt es schon ein Archiv (steht meist im Kopf
+   der Status-Datei), dorthin; sonst `WEITER-HIER-archiv.md` daneben anlegen. Unten anhängen, mit
+   dem heutigen Datum als Überschrift, **im Wortlaut** — das Warum früherer Entscheidungen soll
+   auffindbar bleiben.
+4. **Messen statt schätzen:** Zeilen der Status-Datei **vorher und nachher zählen**. Steht in ihrem
+   Kopf eine Zielgröße, gilt die, sonst **150 Zeilen**. Liegt sie danach noch drüber, weiter
+   wegräumen — oder sag laut, warum der Rest bleiben muss. Prüf danach im Archiv nach, dass das
+   Verschobene wirklich dort steht (eine Zeile daraus suchen), bevor du es als erledigt meldest.
+5. **Sag laut, was du geändert hast:** was neu drinsteht, was ins Archiv ging, Zeilen vorher → nachher.
+
+## 3. Gelernte Regeln — gehört etwas festgehalten?
+**Nur bei echtem Anlass**, nicht als Pflichtübung. Ein Anlass ist: Ich habe dich heute korrigiert,
+eine Arbeitsweise ausdrücklich gewollt, oder dieselbe Art Frage zum dritten Mal gleich beantwortet.
+Kein Anlass? Sag das in einem Halbsatz und geh weiter.
+
+Gibt es einen, **schlag die Regel vor** — ein Satz, was du künftig anders machst, dazu Datum und
+Anlass in einem Satz — und trag sie erst nach meinem OK ein. Wohin, hängt davon ab, was sie ist:
+
+| Was ist es? | Wohin |
+|---|---|
+| **Eine Arbeitsregel** — wie du arbeiten, fragen, prüfen, erklären sollst | `~/.claude/rules/kimal3-coach.md`, **unten** im Abschnitt „Gelernte Regeln" (neueste unten) |
+| **Etwas über mich** — wer ich bin, meine Rollen, meine Werkzeuge | meine `~/.claude/CLAUDE.md` |
+| **Etwas über dieses Projekt** — Aufbau, Werkzeuge, Fallen | die `CLAUDE.md` im Projektordner |
+
+🔬 **Vorher nachsehen, ob es die Regel schon gibt** — im Coach und in den CLAUDE.md-Dateien. Steht
+sie schon da, trag sie **nicht** doppelt ein: Sag mir, wo sie steht und dass sie heute nicht
+gegriffen hat. Eine Regel, die zweimal dasteht, wird nicht besser befolgt.
+⚠️ **Gibt es `~/.claude/rules/kimal3-coach.md` nicht**, kommt auch eine Arbeitsregel in meine
+`~/.claude/CLAUDE.md`. Leg die Coach-Datei **nicht** selbst an — sie gehört kimal3.
+🔴 **Im Coach änderst du NUR den Abschnitt „Gelernte Regeln"** und schreibst nur unten dazu. Alles
+darüber ist die Vorlage von kimal3 — dort änderst du nichts.
+
+Sag danach laut, **welcher Satz in welcher Datei** steht (vollständiger Pfad). Der Ordner
+`~/.claude` ist meist kein Git-Repo — die Datei ist dann nicht über Git gesichert; sag das dazu.
+
+## 4. Projekt aufräumen (leichtgewichtig)
+- Offensichtlichen Müll entfernen (`.DS_Store`, `*.tmp`, `*.log`, `__pycache__`).
+- Bei allem Unklaren: **nicht** löschen — auflisten und mich fragen.
+
+## 5. Sichern (mit meinem OK)
+- Stage die relevanten Änderungen **Datei für Datei** — **niemals** Secrets oder `.env*`, und kein
+  `git add -A`, das fremde Arbeit mitnimmt.
+- Zeig mir kurz, was in den Commit geht — **und was bewusst draußen bleibt**: Dateien, die Git noch
+  nicht kennt und die nicht aus dieser Sitzung stammen, stehen mit Namen und einem Satz, was sie
+  sind, in derselben Liste. (Sie kommen oft aus einer anderen Sitzung und fallen sonst niemandem
+  auf.) Mein OK zum Commit gilt für die ganze Liste; will ich eine davon doch dabeihaben, sage ich es.
+- Schlag eine Commit-Nachricht vor.
+- Nach meinem OK: committen.
+- **Pushen, je nach Projekt:** Prüf mit `git remote`, ob es überhaupt ein Ziel gibt.
+  - Kein Ziel: sag das kurz — der Commit ist dann die Sicherung, fertig.
+  - Ein Ziel: **frag, ob du pushen sollst** (der Schritt „nach außen"). Steht in der
+    Projekt-`CLAUDE.md`, dass ein Push etwas auslöst (zum Beispiel die Live-Seite neu ausliefert),
+    sag das dazu. Erst nach meiner Bestätigung `git push`.
+
+## 6. Zusammenfassen & Abschied
+- 2–3 Sätze **ohne Fachjargon**: Was haben wir heute geschafft, was habe ich gelernt — und in
+  einem Satz, was aufgeräumt wurde.
+- **Ein** konkreter, kleiner nächster Schritt fürs nächste Mal (der Cliffhanger — klein halten).
+- Kurzer, freundlicher Abschied wie ein guter Kollege, der Feierabend macht. Warte auf meine
+  Antwort, bevor die Sitzung endet.

package/skill/commands/k3kontext.md

@@ -44,6 +44,8 @@ beantwortet keine davon gut. Genau deshalb ist das ein Gespräch und kein Formul
 
 Schreib die Antwort in die Datei, die `kimal3 kontext fragen` genannt hat, unter ihre
 `## `-Überschrift. Die `>`-Hinweiszeilen gehören uns: **stehen lassen, darunter schreiben.**
+**Wie die Antwort aussieht** (nie mitten im Satz umbrechen, kein Fett) steht in
+`SKILL.md`, Schritt 3 des Ablaufs — halte dich daran, sonst ist sie in der App kaum lesbar.
 
 🔴 **Nichts erfinden**, auch nichts vorschlagen, was wie eine Antwort aussieht. Weiß der Mensch
 etwas nicht, **bleibt die Frage offen** und ist beim nächsten Mal wieder da.