kimal3 0.1.1 → 0.1.2

package/dist/befehle-katalog.js

@@ -0,0 +1,112 @@
+/**
+ * Alle Befehle, die `kimal3` kennt — als DATEN, nicht als Fliesstext.
+ *
+ * 🔑 Warum das eine eigene Datei ist (Spec US-5, 2026-08-18): Die Liste wird an
+ * ZWEI Orten angezeigt — in der Terminal-Hilfe und im aktiven Pro-Bereich der
+ * App. Zwei handgeschriebene Listen sind die "dieselbe Zahl an zwei Tueren"-
+ * Falle: Der naechste Befehl erschiene in einer und fehlte in der anderen.
+ * Genau so war die `check:`-Prueferliste in CLAUDE.md monatelang unvollstaendig.
+ *
+ * ⚠️ DIESE DATEI IMPORTIERT NICHTS, und das ist Absicht: Die CLI baut mit
+ * NodeNext (Import-Pfade enden auf `.js`), die App mit dem Bundler. Eine Datei
+ * ohne eigene Importe liest sich aus beiden Welten ohne Uebersetzung.
+ *
+ * ⚠️ Der Katalog beschreibt, WAS ES GIBT — nicht, wer es darf. Die Pro-Schranke
+ * sitzt in der Route und im Befehl, nicht hier.
+ */
+export const BEFEHLE = [
+    {
+        befehl: "kimal3 login",
+        beschreibung: "Diesen Rechner mit deinem Konto verbinden",
+        wer: "du",
+        rhythmus: "einmal pro Rechner",
+        beispiel: "kimal3 login",
+        details: [
+            "Der Befehl zeigt dir eine Adresse und einen kurzen Code. Die Adresse im Browser öffnen, den Code eintippen, fertig — das Terminal merkt die Bestätigung von selbst. Zehn Minuten hast du dafür Zeit.",
+            "Danach musst du dich NICHT bei jedem Start neu anmelden: Der Ausweis liegt als Datei in deinem Benutzerordner und übersteht IDE-Neustarts, Rechner-Neustarts und Updates. Bei jedem Aufruf wird er im Hintergrund aufgefrischt, ohne dass du etwas merkst.",
+            "Gelegentlich reißt diese Kette trotzdem — dann sagt ein Befehl „Bitte kimal3 login ausführen\". Das ist kein Fehler, sondern der Normalfall nach längerer Pause: einmal wiederholen und weitermachen.",
+        ],
+    },
+    {
+        befehl: "kimal3 logout",
+        beschreibung: "Verbindung wieder aufheben",
+        wer: "du",
+        rhythmus: "nur wenn nötig",
+        beispiel: "kimal3 logout",
+        details: [
+            "Hebt die Verbindung dieses einen Rechners auf. Für den Alltag brauchst du ihn nicht.",
+            "Sinnvoll ist er, wenn du auf einem fremden oder geteilten Rechner gearbeitet hast — oder wenn ein Gerät abhandenkommt. Deine anderen Rechner bleiben angemeldet.",
+        ],
+    },
+    {
+        befehl: "kimal3 projekt neu …",
+        beschreibung: "Ein Projekt ins Erfolgsprofil eintragen",
+        wer: "claude",
+        ausloeser: "trag das als Projekt ein",
+        beispiel: 'kimal3 projekt neu --titel "Angebots-Generator" --stunden 4 --ergebnis 1200',
+        details: [
+            "Wenn du in Claude etwas fertig gebaut hast und sagst „trag das als Projekt ein\", stellt Claude den Befehl selbst zusammen — mit Titel, Zeitersparnis, Ergebnis und allem, was ihr gerade besprochen habt. Das ist der bequeme Weg, weil Claude die Zahlen schon kennt.",
+            "Selbst tippen kannst du ihn genauso. Pflicht ist nur --titel; alles andere ist freiwillig. Die vollständige Liste aller Angaben zeigt: kimal3 projekt neu --help",
+            "Das Projekt landet in deinem Erfolgsprofil und ist damit Teil deines nachprüfbaren Nachweises.",
+        ],
+    },
+    {
+        befehl: "kimal3 projekt liste",
+        beschreibung: "Deine eingetragenen Projekte anzeigen",
+        wer: "claude",
+        ausloeser: "zeig meine Projekte",
+        beispiel: "kimal3 projekt liste",
+        details: [
+            "Zeigt, was schon in deinem Erfolgsprofil steht.",
+            "Wofür es wirklich da ist: Claude schaut hier VOR dem Eintragen nach. Ohne diesen Blick stünde dasselbe Projekt irgendwann zweimal auf einer öffentlichen Seite, die deinen Namen trägt.",
+        ],
+    },
+    {
+        befehl: "kimal3 firma daten",
+        beschreibung: "Die Daten deiner Firma holen, damit Claude sie auswerten kann",
+        wer: "claude",
+        ausloeser: "werte meine Firma aus",
+        beispiel: 'kimal3 firma daten --firma "Nordwind Handel GmbH"',
+        details: [
+            "Holt Kennzahlen, Menschen und Projekte deiner Firma und gibt sie an Claude weiter. Die Auswertung macht dann Claude — frag einfach los: „Welche drei Projekte bringen den meisten messbaren Ertrag?\" oder „Was sollten wir als Nächstes automatisieren?\"",
+            "Gehörst du zu mehreren Firmen, fragt der Befehl nach — er wählt nie still eine aus.",
+            "⚠️ Es sind personenbezogene Daten von Kolleginnen und Kollegen. Für den Einsatz in einer echten Firma braucht es ein kommerzielles Claude-Konto mit Auftragsverarbeitungsvertrag; werden Leistungen von Beschäftigten ausgewertet, ist das in Deutschland mitbestimmungspflichtig.",
+        ],
+    },
+    {
+        befehl: "kimal3 skill install",
+        beschreibung: "Claude beibringen, dieses Werkzeug zu benutzen — und dir die /k3-Befehle geben",
+        wer: "du",
+        rhythmus: "einmal — und nach jedem Update",
+        beispiel: "kimal3 skill install",
+        details: [
+            "Das ist der Befehl, der aus den anderen erst etwas macht. Er legt ZWEI Dinge in deinem Claude-Ordner ab: eine Anleitung für Claude (das „Skill\") und vier Slash-Befehle für dich.",
+            "🤖 Die Anleitung sorgt dafür, dass Claude von selbst weiß, dass es kimal3 gibt — du sagst „das Projekt ist fertig\", er trägt es ein.",
+            "🧑 Die Slash-Befehle sind dein eigener Griff: Tipp /k3 in Claude Code, und du siehst die ganze Familie — /k3 · /k3projekt · /k3liste · /k3firma. Damit musst du dir keinen Satz merken.",
+            "Er läuft NICHT automatisch. Einmal nach der Installation ausführen — und noch einmal nach jedem Update des Werkzeugs, sonst arbeitet Claude weiter mit der alten Anleitung.",
+            "Woran du merkst, dass es geklappt hat: Der Befehl meldet „Skill angelegt\" (oder „aktualisiert\") und zählt die Slash-Befehle auf. Beides kennt Claude ab der NÄCHSTEN Sitzung — die laufende muss also einmal neu gestartet werden.",
+        ],
+    },
+];
+/**
+ * Die Terminal-Hilfe, gebaut aus dem Katalog.
+ *
+ * Die Spalten richten sich an der laengsten Befehlszeile aus — von Hand
+ * gesetzte Leerzeichen waeren beim naechsten laengeren Befehl krumm.
+ *
+ * 📌 Sie nimmt bewusst NUR `befehl` und `beschreibung`: Im Terminal ist eine
+ * Uebersicht gefragt, kein Handbuch. Die langen `details` haben ihren Platz auf
+ * `/pro`, wo man sie auf- und zuklappen kann — `--help` je Befehl bleibt der
+ * Weg im Terminal.
+ */
+export function hilfeText() {
+    const breite = Math.max(...BEFEHLE.map((b) => b.befehl.length));
+    const zeilen = BEFEHLE.map((b) => `  ${b.befehl.padEnd(breite + 2)}${b.beschreibung}`).join("\n");
+    return `
+  kimal3 — trag deine KI-Projekte dort ein, wo sie entstehen.
+
+${zeilen}
+
+  Mehr zu einem Befehl:  kimal3 projekt neu --help
+`;
+}

package/dist/fehler.js

@@ -0,0 +1,66 @@
+/**
+ * Der gemeinsame Schluss aller Befehle: Was tun mit einer Absage, die kein
+ * Befehl fuer sich beantworten kann?
+ *
+ * 🔑 **Warum das hier wohnt und nicht in `api.ts`:** Es ist eine reine
+ * Rechnung -- Zahl und Text rein, Zahl und Text raus, kein Netz, keine Datei.
+ * Damit ist sie in `check:cli` messbar, ohne einen Server zu starten. `api.ts`
+ * zieht ueber `anmeldung.ts` das Dateisystem nach; wer von dort importiert,
+ * kann die Rechnung nicht mehr allein pruefen.
+ */
+/**
+ * ⚠️ **404 ist KEIN Eingabefehler** (QA-Befund B-7, 2026-08-18).
+ *
+ * Vorher endeten alle drei Befehle auf `status >= 500 ? 3 : 1`. Eine `404`
+ * fiel damit auf die `1` -- und `1` heisst laut `skill/SKILL.md` ausdruecklich
+ * *"Eingabe passt nicht"*. Antwortet die App aber mit `404`, war die Eingabe
+ * fehlerfrei: Die **App** kennt den Befehl noch nicht. Claude folgte der
+ * Betriebsanleitung und erklaerte dem Menschen, seine Eingabe stimme nicht --
+ * woraufhin der Firmenname, Schreibweise und `--firma` prueft und nichts davon
+ * hilft.
+ *
+ * 🔴 **Gemessen am 2026-08-18:** `/api/cli/firma` antwortete auf
+ * `kimal3-app.vercel.app` mit `404`, waehrend `/api/cli/projekt` mit `200`
+ * antwortete -- der Befehl war veroeffentlicht, die Route noch nicht
+ * ausgeliefert. Genau so sieht der Fall im Alltag aus: im Fenster zwischen
+ * `npm publish` und fertigem Deployment, bei einem Rueckbau, und bei jedem
+ * neuen Befehl.
+ *
+ * *Ein Fehlerfall darf nie denselben Namen tragen wie ein anderer, der
+ * Gegenteiliges verlangt.* Deshalb bekommt die `404` den `3`-Topf: dort steht
+ * bereits "nochmal versuchen kann helfen" -- und ein paar Minuten spaeter ist
+ * das Deployment durch.
+ */
+export function schlussFehler(status, meldung) {
+    if (status === 404) {
+        return {
+            text: "Diese Version der App kennt den Befehl noch nicht. " +
+                "Hast du gerade aktualisiert, versuch es in ein paar Minuten noch einmal.",
+            wert: 3,
+        };
+    }
+    /*
+      🔴 **`408` und `429` gehoeren AUCH in den 3-Topf** (Review-Runde 3,
+      2026-08-18). Vorher fiel alles unter 500 auf die `1` -- und die heisst seit
+      Runde 2 ausdruecklich "Wiederholen hilft nicht".
+  
+      Beide Zahlen sagen aber genau das Gegenteil: `429` schickt eine
+      Vercel-Firewall oder ein Supabase-Rate-Limit, `408` ist eine
+      Zeitueberschreitung. Bei beiden ist **Warten die Loesung**, und bei beiden
+      kommt der Rumpf oft als HTML -- dann steht dort nicht einmal eine Meldung,
+      sondern nur "Das hat nicht geklappt.".
+  
+      *Genau die Form von B-7, nur mit einer anderen Zahl:* Der Mensch hat nichts
+      falsch gemacht, das Werkzeug rät ihm trotzdem, es sein zu lassen.
+    */
+    if (status === 408 || status === 429) {
+        return {
+            text: "Der Server ist gerade überlastet oder hat zu lange gebraucht. " +
+                "Versuch es in einem Moment noch einmal.",
+            wert: 3,
+        };
+    }
+    // Alles Uebrige: ein Aussetzer des Servers ist wiederholbar, alles andere
+    // ist die Absage, die der Server selbst formuliert hat.
+    return { text: meldung, wert: status >= 500 ? 3 : 1 };
+}

package/dist/firmen-liste.js

@@ -0,0 +1,52 @@
+/**
+ * Die Firmen-Auswahl, die eine Absage dem Menschen anbietet.
+ *
+ * 🔑 Eine reine Rechnung, damit `check:cli` sie ohne Server pruefen kann --
+ * dieselbe Ueberlegung wie bei `fehler.ts`.
+ */
+/**
+ * Aus den Namen der eigenen Firmen die Zeilen bauen, die unter „Deine Firmen:"
+ * stehen.
+ *
+ * ⚠️ **Ein doppelter Name bekommt KEINEN Befehl** (QA-Befund B-5, 2026-08-18).
+ * Vorher wurde jeder Name stumpf zu einer kopierfertigen Zeile -- bei zwei
+ * gleichnamigen Firmen also **zweimal derselbe Befehl**. Wer ihn ausfuehrte,
+ * bekam dieselbe Absage, die erneut denselben Befehl anbot: eine Sackgasse
+ * ohne Ausweg.
+ *
+ * *Ein Vorschlag, der garantiert wieder scheitert, ist schlimmer als gar
+ * keiner -- er sieht aus wie ein Ausweg und kostet den Menschen den Versuch.*
+ *
+ * 🔑 **Nur der mehrdeutige Name verliert seinen Befehl, nicht die ganze
+ * Liste.** Wer zu „Nordwind", „Nordwind" und „Suedwind" gehoert, kann
+ * „Suedwind" weiterhin waehlen. Dieselbe Lehre steckt schon in der Route
+ * (Review-Befund Runde 2): *Eine Sperre, die mehr sperrt als das Mehrdeutige,
+ * verlangt vom Menschen etwas, das er nicht tun kann.*
+ *
+ * ⚠️ Was hier NICHT geloest wird: An die Daten einer doppelt benannten Firma
+ * kommt man ueber die CLI weiterhin nicht. Das braeuchte eine Auswahl ueber
+ * die ID statt ueber den Namen -- eine eigene Entscheidung, keine Fussnote.
+ * Diese Funktion sorgt nur dafuer, dass niemand mehr einen Ausweg vorgespielt
+ * bekommt, den es nicht gibt.
+ */
+export function firmenZeilen(namen) {
+    const anzahl = (name) => namen.filter((n) => n === name).length;
+    const gesehen = new Set();
+    const zeilen = [];
+    for (const name of namen) {
+        if (gesehen.has(name))
+            continue;
+        gesehen.add(name);
+        const wieOft = anzahl(name);
+        if (wieOft === 1) {
+            // Fertiger Befehl statt blosser Liste: Der naechste Schritt ist dann
+            // Kopieren statt Abtippen -- und ein Name mit Leerzeichen braucht
+            // Anfuehrungszeichen, an die sonst niemand denkt.
+            zeilen.push(`    kimal3 firma daten --firma "${name}"`);
+        }
+        else {
+            zeilen.push(`    „${name}" — kommt ${wieOft}× vor und ist über den Namen nicht wählbar.`);
+        }
+    }
+    return zeilen;
+}

package/dist/kimal3.js

@@ -11,24 +11,21 @@
  * `kimal3 login`, bei 4 hilft genau das nicht. Wer beide auf dieselbe Zahl
  * legt, laesst Claude den falschen Rat geben.
  */
-import { leseAnmeldung } from "./anmeldung.js";
+import { readFileSync } from "node:fs";
+import { BASIS_URL, leseAnmeldung } from "./anmeldung.js";
 import { NichtAngemeldet } from "./api.js";
+import { hilfeText } from "./befehle-katalog.js";
+import { firmaDaten } from "./befehle/firma-daten.js";
 import { login } from "./befehle/login.js";
 import { logout } from "./befehle/logout.js";
 import { projektListe } from "./befehle/projekt-liste.js";
 import { projektNeu } from "./befehle/projekt-neu.js";
 import { skillInstall } from "./befehle/skill-install.js";
-const HILFE = `
-  kimal3 — trag deine KI-Projekte dort ein, wo sie entstehen.
-
-  kimal3 login              Diesen Rechner mit deinem Konto verbinden
-  kimal3 logout             Verbindung wieder aufheben
-  kimal3 projekt neu …      Ein Projekt ins Erfolgsprofil eintragen
-  kimal3 projekt liste      Deine eingetragenen Projekte anzeigen
-  kimal3 skill install      Claude beibringen, dieses Werkzeug zu benutzen
-
-  Mehr zu einem Befehl:  kimal3 projekt neu --help
-`;
+// 📌 Kein handgeschriebener Block mehr (2026-08-18): Die Liste wohnt in
+// `befehle-katalog.ts` und wird von dort AUCH im Pro-Bereich der App angezeigt.
+// Zwei Listen ueber dieselben Befehle driften — die eine bekaeme den naechsten
+// Befehl, die andere nicht, und keiner der beiden Orte wuesste davon.
+const HILFE = hilfeText();
 /**
  * Hilfe plus Zustand.
  *
@@ -42,6 +39,38 @@ const HILFE = `
  * ⚠️ Und KEIN Netzaufruf: Wer nur die Hilfe sehen will, soll nicht auf einen
  * Server warten. Ob die Anmeldung noch gilt, klaert der naechste echte Befehl.
  */
+/**
+ * Welche Version bin ich — und mit wem rede ich?
+ *
+ * ⚠️ **Die Zahl wird GELESEN, nicht abgetippt** (QA-Befund B-8, 2026-08-18).
+ * Stuende sie hier als Text, sagte die CLI nach dem naechsten `npm version`
+ * die alte Nummer -- dieselbe Zahl an zwei Tueren mit zwei Werten, genau das
+ * Muster, das in diesem Projekt schon zweimal zugeschlagen hat.
+ *
+ * 🔑 **Warum die Gegenstelle mit dazugehoert:** Der Fall, fuer den man diese
+ * Auskunft braucht, ist ein **Versatz** zwischen CLI und App (B-7). Dann
+ * helfen erst beide Angaben zusammen: welche CLI laeuft -- und gegen welche
+ * App sie spricht. Eine Version allein beantwortet die Frage nur halb.
+ *
+ * 📌 `../package.json` stimmt aus `dist/` **und** aus `src/`: Beide liegen
+ * eine Ebene unter `cli/`.
+ */
+function versionsZeilen() {
+    let version = "unbekannt";
+    try {
+        const roh = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+        if (roh && typeof roh === "object" && "version" in roh) {
+            const v = roh.version;
+            if (typeof v === "string")
+                version = v;
+        }
+    }
+    catch {
+        // Kein Absturz, wenn die Datei fehlt: "unbekannt" ist eine ehrliche
+        // Antwort, ein Stapelabzug waere keine.
+    }
+    return `  kimal3 ${version}\n  spricht mit ${BASIS_URL}`;
+}
 function zustandsZeile() {
     const a = leseAnmeldung();
     return a
@@ -56,6 +85,11 @@ async function haupt() {
         console.log(zustandsZeile() + "\n");
         return 0;
     }
+    if (wort === "--version" || wort === "-v" || wort === "version") {
+        console.log(versionsZeilen());
+        console.log(zustandsZeile() + "\n");
+        return 0;
+    }
     if (wort === "login")
         return login();
     if (wort === "logout")
@@ -64,6 +98,11 @@ async function haupt() {
         return projektNeu(argv.slice(2));
     if (wort === "projekt liste")
         return projektListe();
+    // ⚠️ Praefix-Vergleich wie bei `projekt neu` und NICHT `wort === "firma daten"`:
+    // `wort` enthaelt die Optionen mit, `firma daten --firma X` fiele bei einem
+    // Gleichheits-Vergleich durch und meldete "Den Befehl kenne ich nicht".
+    if (argv[0] === "firma" && argv[1] === "daten")
+        return firmaDaten(argv.slice(2));
     if (wort === "skill install")
         return skillInstall();
     console.error(`Den Befehl „${wort}" kenne ich nicht.\n${HILFE}`);

package/dist/projekt-zeilen.js

@@ -0,0 +1,253 @@
+/**
+ * Die Zeilen, die `kimal3 projekt liste` ausgibt — und das Lesen der Antwort.
+ *
+ * 🔑 Eine reine Rechnung, damit `check:cli` sie ohne Server pruefen kann --
+ * dieselbe Ueberlegung wie bei `firmen-liste.ts` und `fehler.ts`.
+ *
+ * ⚠️ **Warum hier eigene Formatierer stehen, obwohl die App `euroBetrag` und
+ * `datumLang` schon hat:** Die CLI ist ein eigenstaendiges npm-Paket mit
+ * `rootDir: src` -- sie kann aus `../../src` nichts importieren. Das ist kein
+ * Versehen, sondern der Preis dafuer, dass das Paket ohne die App baut.
+ *
+ * 🔴 Und ein Unterschied ist ABSICHT, kein Drift: `euroBetrag` in der App
+ * rundet auf ganze Euro, weil eine Monats-Selbstauskunft keine Cent-Genauigkeit
+ * hat. Hier werden Cents ANGEZEIGT, sobald welche dastehen. Grund ist die
+ * Hausregel "erst runden, DANN entscheiden": Wer 0,10 € eingetragen hat und im
+ * Terminal "0 €" liest, haelt seine Eingabe fuer verloren. Das Terminal ist der
+ * Ort der Nachschau, die oeffentliche Karte der Ort der Aussage.
+ */
+/** Ein Zahlenfeld: `null` heisst "nicht angegeben", `false` heisst "unlesbar". */
+function zahlFeld(o, name) {
+    const w = o[name];
+    if (w === undefined || w === null)
+        return null;
+    if (typeof w === "number" && Number.isFinite(w))
+        return w;
+    // 🔴 Eine Zahl, die als Zeichenkette ankommt, wird NICHT still zu "nicht
+    // angegeben". Genau das waere die Faktor-1000-Falle in ihrer leisen Form:
+    // Der Mensch sieht ein Projekt ohne Zahlen und glaubt, seine Eingabe sei nie
+    // angekommen. *Stilles Weglassen ist der schlechteste der drei Wege.*
+    return false;
+}
+/**
+ * Die Projekte aus der Antwort lesen.
+ *
+ * ⚠️ **`null` und `[]` sind zwei verschiedene Wirklichkeiten.** `[]` heisst
+ * "du hast noch keine Projekte" -- eine gueltige Antwort auf eine gueltige
+ * Frage. `null` heisst "diese Antwort war nicht lesbar". Faellt beides auf
+ * denselben Rueckgabewert, feiert der Befehl eine Stoerung als Erfolg und
+ * raet zum Eintragen von etwas, das laengst dasteht.
+ *
+ * 🔑 Auch eine ALTE App-Fassung landet hier auf `null`: Sie antwortet mit
+ * `{ "titel": [...] }` und ohne `projekte`. **Das ist aber NICHT das Ende** --
+ * `projekt-liste.ts` fragt danach `titelAusAlterAntwort` und zeigt die Liste
+ * ohne Zahlen, mit Rueckgabewert `0`. Diese Funktion sagt also nur "ich kann
+ * es nicht lesen", nicht "es ist kaputt".
+ *
+ * ⚠️ Hier stand bis zur Review-Runde 3 (2026-08-18) das Gegenteil: "Der Befehl
+ * meldet dann eine unlesbare Antwort und den Rueckgabewert `3`." Das war vor
+ * L-7 richtig und danach falsch -- und der widersprechende Text stand vierzig
+ * Zeilen ueber der Funktion, die es besser weiss.
+ * *In diesem Projekt sind Kommentare tragend* (siehe
+ * `docs/regeln/messen-und-pruefen.md`, Abschnitt 11, in genau diesem Zweig
+ * hinzugefuegt): Der naechste Leser haette geglaubt, den Rueckfallweg gebe es
+ * nicht -- und ihn vielleicht ein zweites Mal gebaut.
+ */
+export function projekteAusAntwort(koerper) {
+    if (!koerper || typeof koerper !== "object")
+        return null;
+    const roh = koerper.projekte;
+    if (!Array.isArray(roh))
+        return null;
+    const projekte = [];
+    for (const eintrag of roh) {
+        if (!eintrag || typeof eintrag !== "object")
+            return null;
+        const o = eintrag;
+        if (typeof o.titel !== "string")
+            return null;
+        if (typeof o.laeuft !== "boolean")
+            return null;
+        const liveSeit = o.live_seit;
+        if (liveSeit !== null && liveSeit !== undefined && typeof liveSeit !== "string")
+            return null;
+        const stunden = zahlFeld(o, "zeitersparnis_std_wo");
+        const ergebnis = zahlFeld(o, "ergebnis_monat_eur");
+        const umsatz = zahlFeld(o, "umsatz_monat_eur");
+        if (stunden === false || ergebnis === false || umsatz === false)
+            return null;
+        projekte.push({
+            titel: o.titel,
+            live_seit: typeof liveSeit === "string" ? liveSeit : null,
+            laeuft: o.laeuft,
+            zeitersparnis_std_wo: stunden,
+            ergebnis_monat_eur: ergebnis,
+            umsatz_monat_eur: umsatz,
+        });
+    }
+    return projekte;
+}
+const MONATE = [
+    "Januar", "Februar", "März", "April", "Mai", "Juni",
+    "Juli", "August", "September", "Oktober", "November", "Dezember",
+];
+/**
+ * "2026-07-01" → "1. Juli 2026". Bewusst aus der Zeichenkette gerechnet statt
+ * ueber `new Date()`: Ein ISO-Datum ohne Uhrzeit gilt als UTC-Mitternacht und
+ * kippt sonst je nach Zeitzone einen Tag zurueck -- und ein Terminal steht
+ * irgendwo auf der Welt.
+ *
+ * ⚠️ Erwartet ein REINES Datum (`JJJJ-MM-TT`), wie es die `date`-Spalte
+ * `live_seit` liefert. Passt es nicht, steht lieber das rohe Datum da als ein
+ * kaputter Satz ("NaN. August 2026" -- der Fehler vom 2026-08-12).
+ */
+function datumLang(isoDatum) {
+    const [jahr, monat, tag] = isoDatum.split("-");
+    const monatsname = MONATE[Number(monat) - 1];
+    if (!monatsname || !jahr || !Number.isFinite(Number(tag)))
+        return isoDatum;
+    return `${Number(tag)}. ${monatsname} ${jahr}`;
+}
+/**
+ * "1200" → "1.200 €", "0.1" → "0,10 €".
+ *
+ * Cents erscheinen nur, wenn welche da sind: "1.200,00 €" taeuscht eine
+ * Genauigkeit vor, die niemand behauptet hat -- "0 €" bei 0,10 € verschweigt
+ * dagegen eine, die dasteht.
+ */
+function euro(wert) {
+    const hatCent = Math.round(wert * 100) % 100 !== 0;
+    const stellen = hatCent ? 2 : 0;
+    return `${new Intl.NumberFormat("de-DE", {
+        minimumFractionDigits: stellen,
+        maximumFractionDigits: stellen,
+    }).format(wert)} €`;
+}
+/** "6" → "6", "6.5" → "6,5". Die Spalte ist numeric(6,2). */
+function stunden(wert) {
+    return new Intl.NumberFormat("de-DE", { maximumFractionDigits: 2 }).format(wert);
+}
+/** Was oben in der zweiten Zeile steht: laeuft, geplant oder noch nicht live. */
+function zustand(p) {
+    if (p.live_seit === null)
+        return "noch nicht live";
+    return p.laeuft
+        ? `live seit ${datumLang(p.live_seit)}`
+        : `geplant ab ${datumLang(p.live_seit)}`;
+}
+/**
+ * Zwei Zeilen je Projekt: Titel, darunter die Angaben.
+ *
+ * 🔑 **Was fehlt, wird als fehlend gezeigt** -- nie durch 0 ersetzt. Ein
+ * Projekt ohne Zahlen ist der Normalfall: Nicht jede Automation hat einen
+ * Eurobetrag, und eine erfundene 0 stuende spaeter oeffentlich auf der Karte
+ * eines Menschen. Eine ausdrueckliche 0 ist dagegen eine ANGABE und wird
+ * gezeigt -- deshalb wird auf `null` geprueft, nicht auf Wahrheitswert.
+ */
+export function projektZeilen(projekte) {
+    const zeilen = [];
+    projekte.forEach((p, i) => {
+        if (i > 0)
+            zeilen.push("");
+        zeilen.push(`    ${i + 1}. ${p.titel}`);
+        const teile = [zustand(p)];
+        if (p.zeitersparnis_std_wo !== null) {
+            teile.push(`${stunden(p.zeitersparnis_std_wo)} Std./Woche`);
+        }
+        if (p.ergebnis_monat_eur !== null) {
+            teile.push(`${euro(p.ergebnis_monat_eur)} Ergebnis/Monat`);
+        }
+        if (p.umsatz_monat_eur !== null) {
+            teile.push(`${euro(p.umsatz_monat_eur)} Umsatz/Monat`);
+        }
+        // Nur der Zustand steht da? Dann sagen wir das ausdruecklich, statt eine
+        // halbe Zeile hinzustellen, die aussieht, als sei etwas abgeschnitten.
+        if (teile.length === 1)
+            teile.push("keine Zahlen eingetragen");
+        zeilen.push(`       ${teile.join(" · ")}`);
+    });
+    return zeilen;
+}
+/**
+ * Liest die ALTE Antwortform (`titel: string[]`, ohne `projekte`).
+ *
+ * 🔑 **Wofuer das da ist** (Befund L-7, 2026-08-18): Die CLI kann neuer sein
+ * als die App -- in jedem Deployment-Fenster zwischen `npm publish` und dem
+ * fertigen Vercel-Build. Dann antwortet der Server voellig korrekt, nur in der
+ * alten Form. Ohne diese Funktion faellt das in denselben Topf wie eine
+ * kaputte Antwort, und die CLI raet zum Wiederholen -- was hier NIE hilft.
+ *
+ * Gibt `null` zurueck, wenn es auch die alte Form nicht ist. Dann ist die
+ * Antwort wirklich unlesbar, und der Rat zum Wiederholen stimmt.
+ */
+export function titelAusAlterAntwort(koerper) {
+    if (!koerper || typeof koerper !== "object")
+        return null;
+    const o = koerper;
+    // ⚠️ Nur wenn `projekte` FEHLT. Ist es da und war trotzdem unlesbar, ist die
+    // Antwort defekt -- dann darf sie nicht als "alte Version" durchgehen.
+    if ("projekte" in o)
+        return null;
+    // Ab Runde 6 stuetzt sich das auf `titelFeldLesen` -- dieselbe Regel darf
+    // nicht an zwei Orten stehen.
+    return titelFeldLesen(koerper);
+}
+/**
+ * Wie viele Projekte ein Erfolgsprofil hoechstens traegt.
+ *
+ * ⚠️ **Das ist eine KOPIE von `MAX_PROJEKTE` aus
+ * `src/app/(erfolgsprofil)/typen.ts`** — die CLI ist ein eigenstaendiges
+ * npm-Paket mit `rootDir: src` und kann aus der App nichts importieren.
+ *
+ * 🔴 **Deshalb misst `npm run check:cli`, dass die beiden Zahlen gleich sind**
+ * (Review-Befund, 2026-08-18). Vorher stand die `12` an zwei Stellen in
+ * `projekt-liste.ts` fest im Text, und nichts pruefte sie gegen die App: Wer
+ * die Grenze dort anhebt, laesst die CLI still weiter "von 12" behaupten.
+ * *Dieselbe Zahl an drei Tueren — das Muster, das dieses Projekt schon zweimal
+ * eingefangen hat.*
+ */
+export const MAX_PROJEKTE_ANZEIGE = 12;
+/**
+ * Sagt, ob die Antwort ueberhaupt ein Feld `projekte` mitbringt.
+ *
+ * 🔑 **Wofuer das da ist** (Review-Runde 4, 2026-08-18): Es schliesst die
+ * Vertraeglichkeits-Matrix in der letzten offenen Richtung. Bisher gab es
+ * zwei Faelle:
+ *   - die App ist AELTER (kein `projekte`, nur `titel`) -> `titelAusAlterAntwort`
+ *   - die Antwort ist Muell (WLAN-Portal, HTML) -> "nicht lesbar", noch mal
+ *
+ * Der dritte fehlte: **die App ist NEUER als die CLI.** Dann steht `projekte`
+ * da, aber ein Eintrag hat eine Form, die diese Fassung nicht kennt --
+ * `projekteAusAntwort` steigt beim ersten aus und gibt `null`. Elf gute
+ * Projekte verschwinden mit dem zwoelften, und der Mensch bekam den Rat,
+ * es gleich noch einmal zu versuchen. **Der Zustand ist aber stabil** --
+ * Wiederholen aendert nichts, bis das Werkzeug aktualisiert wird.
+ *
+ * *Genau die Form von B-5, B-7 und L-7 -- in der einen Richtung, die dieser
+ * Zweig noch nicht abgedeckt hatte.*
+ */
+export function antwortHatProjekteFeld(koerper) {
+    return !!koerper && typeof koerper === "object" && "projekte" in koerper;
+}
+/**
+ * Liest das Feld `titel` — **ohne** zu fragen, ob `projekte` daneben steht.
+ *
+ * 🔑 **Wofuer** (Review-Runde 6, 2026-08-18): Die neue Route liefert `titel`
+ * und `projekte` IMMER gemeinsam. Aendert eine spaetere App-Fassung die Form
+ * eines Eintrags, steigt `projekteAusAntwort` beim ersten aus -- die zwoelf
+ * Titel stehen aber unveraendert daneben. Sie dann nicht zu zeigen und
+ * stattdessen "npm install -g kimal3" zu sagen, wirft Daten weg, die man hat.
+ *
+ * *Wer dem Menschen etwas geben kann, gibt es ihm -- und sagt dazu, was
+ * fehlt.*
+ */
+export function titelFeldLesen(koerper) {
+    if (!koerper || typeof koerper !== "object")
+        return null;
+    const roh = koerper.titel;
+    if (!Array.isArray(roh))
+        return null;
+    if (!roh.every((t) => typeof t === "string"))
+        return null;
+    return roh;
+}

package/package.json

@@ -1,16 +1,27 @@
-{
-  "name": "kimal3",
-  "version": "0.1.1",
-  "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://kimal3-app.vercel.app/pro",
-  "license": "SEE LICENSE IN README.md"
-}
+{
+  "name": "kimal3",
+  "version": "0.1.2",
+  "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://kimal3-app.vercel.app/pro",
+  "license": "SEE LICENSE IN README.md"
+}