kimal3 0.2.10 → 0.3.0

package/dist/befehle-katalog.js

@@ -11,6 +11,9 @@
  * NodeNext (Import-Pfade enden auf `.js`), die App mit dem Bundler. Eine Datei
  * ohne eigene Importe liest sich aus beiden Welten ohne Uebersetzung.
  *
+ * 🌐 Englisch steht in `befehle-katalog-en.ts` daneben (Teil 3, T3-11) -- eine Datei waere
+ * ueber 300 Code-Zeilen. Die Terminal-Hilfe baut `hilfe.ts` aus beiden.
+ *
  * ⚠️ Der Katalog beschreibt, WAS ES GIBT — nicht, wer es darf. Die Pro-Schranke
  * sitzt in der Route und im Befehl, nicht hier.
  */
@@ -62,7 +65,7 @@ export const BEFEHLE = [
         terminal: "kimal3 arbeitsplatz neu",
         details: [
             "Holt die Vorlage von deinem Pro-Konto und legt sie hier als echten Ordner an — CLAUDE.md, Takt-Befehle, die Werkbank für deine Projekte. Dasselbe Paket, das auch als Download auf /pro liegt.",
-            "Der Ordner heißt immer KI-Arbeitsplatz — mehrere Firmen trennst du über den Ordner darüber, z. B. Kunden/ARNO/KI-Arbeitsplatz. Gib deinen Vornamen mit, dann heißt deine Werkbank darin werkbank-sabine: kimal3 arbeitsplatz neu sabine.",
+            "Der Ordner heißt KI-Arbeitsplatz (bei einer englischsprachigen Firma AI-Workplace) — mehrere Firmen trennst du über den Ordner darüber, z. B. Kunden/ARNO/KI-Arbeitsplatz. Gib deinen Vornamen mit, dann heißt deine Werkbank darin werkbank-sabine (bei einem englischen Konto workbench-sabine): kimal3 arbeitsplatz neu sabine.",
             "Gibt es den Zielordner schon und ist er nicht leer, bricht der Befehl ab, statt etwas zu überschreiben — deine Arbeit ist sicher. Geklappt hat es, wenn er die Zahl der angelegten Dateien nennt.",
             "⚠️ Er legt auch die Firmenebene an (kontext/ mit Marke, Systemen, Sicherheit). Steht die schon, brauchst du kimal3 werkbank neu — sonst entsteht eine zweite Firma in der ersten.",
         ],
@@ -87,7 +90,7 @@ export const BEFEHLE = [
             "Für alle außer der ersten Person: Der Firmen-Ordner steht schon (kontext/ mit Marke, Systemen, Sicherheit) — du brauchst nur deinen eigenen Arbeitsplatz darin.",
             "🔴 Er fasst die Firmenebene nicht an. Kein Byte in kontext/, CLAUDE.md oder README.md — auch nicht schreibend „identisch drüber“.",
             "Er läuft nur, wenn du wirklich in einem Firmen-Ordner stehst. Fehlt die Firmenebene daneben, bricht er ab und sagt es — eine Werkbank ohne sie zeigt ins Leere, weil ihre Einstellungen auf ../kontext verweisen.",
-            "Gib deinen Vornamen mit — der Ordner trägt ihn: aus sabine wird werkbank-sabine. Ohne Angabe bildet der Server ihn aus deiner Anmelde-Adresse. So sieht man später, wem welche Werkbank gehört.",
+            "Gib deinen Vornamen mit — der Ordner trägt ihn: aus sabine wird werkbank-sabine (bei einem englischen Konto workbench-sabine). Ohne Angabe bildet der Server ihn aus deiner Anmelde-Adresse. So sieht man später, wem welche Werkbank gehört.",
         ],
     },
     /*
@@ -180,9 +183,11 @@ export const BEFEHLE = [
     /*
       🔴 Dieser Eintrag steht bewusst NICHT im "Weg, den ein Mensch geht" --
       niemand muss ihn selbst tippen. Er wird bei jedem Start von Claude Code
-      von selbst aufgerufen (Aufgabe 8) und steht hier trotzdem, weil
-      `tippen()` in `wache-rechnung.ts` seine `!`-Schreibweise braucht, wenn die
-      Wache selbst einmal auf ihren eigenen Befehl verweisen muss.
+      von selbst aufgerufen (Aufgabe 8). Er steht hier noch, obwohl `tippen()`
+      in `wache-rechnung.ts` seit Teil 3 (Task 15) die Befehlswoerter aus
+      `befehlswoerter.ts` liest und den Katalog nicht mehr braucht. Die Zeile
+      bleibt sichtbar (Task 16): Die deutsche Hilfe bleibt Zeichen fuer Zeichen,
+      und ein Mensch, der `kimal3 wache` sucht, findet es hier.
     */
     {
         befehl: "kimal3 wache",
@@ -209,47 +214,3 @@ export const BEFEHLE = [
         ],
     },
 ];
-/**
- * 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
-`;
-}
-/**
- * Wie ein Befehl **getippt** wird — aus dem Katalog geholt, nicht abgeschrieben.
- *
- * 🔑 **Warum das eine eigene Funktion ist** (2026-08-20): Auf `/pro` stand
- * `const ANMELDEN = "! kimal3 login"` als Zeichenkette im Seitencode — eine
- * zweite Wahrheit ueber einen Befehl, den der Katalog schon fuehrt. Wer im
- * Katalog umbenennt, laesst sie stehen, und die Seite zeigt weiter den alten
- * Aufruf. Dieselbe Klasse Fehler wie der fest getippte `cd`-Pfad in Runde 3.
- *
- * ⚠️ Sie **wirft**, statt einen leeren Text zu liefern. Die Aufrufer sind
- * Modul-Konstanten — ein falscher Name fliegt damit beim `npm run build` auf,
- * nicht erst beim Kunden vor einem Kopier-Kasten, in dem nichts steht.
- * *Ein stiller Fehler auf einer bezahlten Seite ist teurer als ein lauter im
- * Build.*
- */
-export function tippBefehl(befehl) {
-    const eintrag = BEFEHLE.find((b) => b.befehl === befehl);
-    if (!eintrag) {
-        throw new Error(`Kein Katalog-Eintrag fuer „${befehl}". Steht der Befehl noch in BEFEHLE?`);
-    }
-    return eintrag.tippen;
-}

package/dist/befehlswoerter.js

@@ -0,0 +1,69 @@
+export const BEFEHLSWOERTER = {
+    login: { de: "login", en: "login" },
+    logout: { de: "logout", en: "logout" },
+    "skill install": { de: "skill install", en: "skill install" }, // kein-anzeigetext: Befehlswörter (Spec Abschnitt 6)
+    "arbeitsplatz neu": { de: "arbeitsplatz neu", en: "workplace new" }, // kein-anzeigetext: Befehlswörter (Spec Abschnitt 6)
+    "werkbank neu": { de: "werkbank neu", en: "workbench new" }, // kein-anzeigetext: Befehlswörter (Spec Abschnitt 6)
+    "kontext runter": { de: "kontext runter", en: "context download" }, // kein-anzeigetext: Befehlswörter (Spec Abschnitt 6)
+    "kontext hoch": { de: "kontext hoch", en: "context upload" }, // kein-anzeigetext: Befehlswörter (Spec Abschnitt 6)
+    "kontext fragen": { de: "kontext fragen", en: "context questions" }, // kein-anzeigetext: Befehlswörter (Spec Abschnitt 6)
+    "projekt neu": { de: "projekt neu", en: "project new" }, // kein-anzeigetext: Befehlswörter (Spec Abschnitt 6)
+    "projekt liste": { de: "projekt liste", en: "project list" }, // kein-anzeigetext: Befehlswörter (Spec Abschnitt 6)
+    "firma daten": { de: "firma daten", en: "company data" }, // kein-anzeigetext: Befehlswörter (Spec Abschnitt 6)
+    wache: { de: "wache", en: "watch" },
+    "wache an": { de: "wache an", en: "watch on" }, // kein-anzeigetext: Befehlswörter (Spec Abschnitt 6)
+    "wache aus": { de: "wache aus", en: "watch off" }, // kein-anzeigetext: Befehlswörter (Spec Abschnitt 6)
+};
+/**
+ * Welcher Befehl steht vorne in `argv` -- und was bleibt dahinter?
+ * Zwei Woerter vor einem: `watch on` ist `wache an`, nicht `wache` mit Rest `on`.
+ * `null` heisst: kein Befehl, auch kein halber. Ob der Rest zum Befehl passt, entscheidet der
+ * Verteiler (`kimal3 login extra` bleibt dort unbekannt, wie bisher).
+ */
+export function erkenneBefehl(argv) {
+    const namen = Object.keys(BEFEHLSWOERTER);
+    for (const laenge of [2, 1]) {
+        if (argv.length < laenge)
+            continue;
+        const vorne = argv.slice(0, laenge).join(" ");
+        for (const name of namen) {
+            const w = BEFEHLSWOERTER[name];
+            if (w.de.split(" ").length !== laenge)
+                continue;
+            if (vorne === w.de || vorne === w.en)
+                return { name, rest: argv.slice(laenge) };
+        }
+    }
+    return null;
+}
+/** Das Befehlswort in der Sprache des Satzes, der es nennt -- ohne `kimal3` davor. */
+export function befehlIn(name, sprache) {
+    return BEFEHLSWOERTER[name][sprache];
+}
+/** Englischer Schalter -> deutscher Name, unter dem der Wert abgelegt und zum Server geschickt wird. */
+export const SCHALTER_EN = {
+    company: "firma",
+    "company-id": "firma-id",
+    "no-company": "ohne-firma",
+    overwrite: "ueberschreiben",
+    title: "titel",
+    description: "beschreibung",
+    icon: "symbol",
+    hours: "stunden",
+    result: "ergebnis",
+    revenue: "umsatz",
+    impact: "wirkung",
+    "impact-label": "wirkung-label",
+    "live-since": "live-seit",
+};
+/** `company` -> `firma`; ein deutscher (oder unbekannter) Name bleibt, wie er ist. */
+export function deutscherSchalter(getippt) {
+    return Object.hasOwn(SCHALTER_EN, getippt) ? SCHALTER_EN[getippt] : getippt;
+}
+/** Der Schalter in der Sprache des Satzes, der ihn nennt (ohne `--`). */
+export function schalterIn(deutsch, sprache) {
+    if (sprache === "de")
+        return deutsch;
+    const treffer = Object.entries(SCHALTER_EN).find(([, d]) => d === deutsch);
+    return treffer ? treffer[0] : deutsch;
+}

package/dist/einstellungen-mischen.js

@@ -13,7 +13,7 @@
  * Woran wir einen Eintrag als UNSEREN erkennen -- unabhaengig davon, welche
  * Argumente wir spaeter einmal anhaengen. Siehe `istUnserer`.
  */
-export const WACHE_MARKE = "kimal3 wache";
+export const WACHE_MARKE = "kimal3 wache"; // kein-anzeigetext: Startbefehl in Claudes Einstellungen, bleibt deutsch (T3-5)
 /**
  * Der Befehl, der in die Einstellungen eingetragen wird.
  *
@@ -37,7 +37,7 @@ export const WACHE_MARKE = "kimal3 wache";
  * der JSON-Form, die Claude Code fuer Startbefehle vorsieht, und die wird
  * AUCH BEI RUECKGABEWERT 127 gelesen (ebenfalls gemessen).
  */
-export const WACHE_BEFEHL = `${WACHE_MARKE} --hook`;
+export const WACHE_BEFEHL = `${WACHE_MARKE} --hook`; // kein-anzeigetext: Startbefehl in Claudes Einstellungen, bleibt deutsch (T3-5)
 /**
  * Wie lange Claude auf die Wache wartet, in Sekunden.
  *

package/dist/einstellungen-schreiben.js

@@ -2,6 +2,9 @@ import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { WACHE_BEFEHL, mischeEinstellungen } from "./einstellungen-mischen.js";
+/** Die Kontrolle nach dem Schreiben fand unseren Eintrag nicht -- eigener Fall, damit `detail` `null` sein kann. */
+class EintragFehlt extends Error {
+}
 export function einstellungenDatei() {
     return join(homedir(), ".claude", "settings.json");
 }
@@ -24,7 +27,7 @@ export function trageWacheEin() {
               -- wer beide gleich behandelt, legt eine neue an und der Mensch
               verliert alles, was drinstand.
             */
-            return { art: "gescheitert", grund: `nicht lesbar (${e.message})` };
+            return { art: "gescheitert", schritt: "lesen", detail: e.message };
         }
     }
     const ergebnis = mischeEinstellungen(alt, WACHE_BEFEHL);
@@ -43,7 +46,7 @@ export function trageWacheEin() {
               ist, im Fehlerfall zurueckzukoennen -- ohne Kopie gibt es kein Zurueck,
               und dann ist Schreiben die schlechtere Wahl als Nichtstun.
             */
-            return { art: "gescheitert", grund: `keine Sicherungskopie moeglich (${e.message})` };
+            return { art: "gescheitert", schritt: "sichern", detail: e.message };
         }
     }
     // --- Schritt 3: schreiben ---
@@ -53,19 +56,19 @@ export function trageWacheEin() {
     }
     catch (e) {
         zurueck(gabEsSchon);
-        return { art: "gescheitert", grund: `nicht schreibbar (${e.message})` };
+        return { art: "gescheitert", schritt: "schreiben", detail: e.message };
     }
     // --- Schritt 4: zuruecklesen und erneut pruefen ---
     try {
         const zurueckgelesen = readFileSync(datei, "utf8");
         const geparst = JSON.parse(zurueckgelesen);
         if (!zurueckgelesen.includes(WACHE_BEFEHL) || geparst === null) {
-            throw new Error("unser Eintrag steht nicht in der zurueckgelesenen Datei");
+            throw new EintragFehlt();
         }
     }
     catch (e) {
         zurueck(gabEsSchon);
-        return { art: "gescheitert", grund: `Kontrolle nach dem Schreiben fehlgeschlagen (${e.message})` };
+        return { art: "gescheitert", schritt: "kontrolle", detail: e instanceof EintragFehlt ? null : e.message };
     }
     return { art: "eingetragen" };
 }

package/dist/fehler.js

@@ -8,6 +8,7 @@
  * zieht ueber `anmeldung.ts` das Dateisystem nach; wer von dort importiert,
  * kann die Rechnung nicht mehr allein pruefen.
  */
+import { ALLGEMEIN_TEXTE } from "./texte/allgemein.js";
 /**
  * ⚠️ **404 ist KEIN Eingabefehler** (QA-Befund B-7, 2026-08-18).
  *
@@ -33,11 +34,11 @@
  * bereits "nochmal versuchen kann helfen" -- und ein paar Minuten spaeter ist
  * das Deployment durch.
  */
-export function schlussFehler(status, meldung) {
+export function schlussFehler(status, meldung, sprache) {
+    const t = ALLGEMEIN_TEXTE[sprache];
     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.",
+            text: t.appDoesNotKnowCommand,
             wert: 3,
         };
     }
@@ -57,8 +58,7 @@ export function schlussFehler(status, meldung) {
     */
     if (status === 408 || status === 429) {
         return {
-            text: "Der Server ist gerade überlastet oder hat zu lange gebraucht. " +
-                "Versuch es in einem Moment noch einmal.",
+            text: t.serverOverloaded,
             wert: 3,
         };
     }

package/dist/firmen-liste.js

@@ -6,6 +6,8 @@
  * reine Rechnung, der Import bricht das also nicht.
  */
 import { alsWort } from "./argumente.js";
+import { befehlIn, schalterIn } from "./befehlswoerter.js";
+import { ALLGEMEIN_TEXTE } from "./texte/allgemein.js";
 /**
  * Aus den Namen der eigenen Firmen die Zeilen bauen, die unter „Deine Firmen:"
  * stehen.
@@ -31,7 +33,8 @@ import { alsWort } from "./argumente.js";
  * Diese Funktion sorgt nur dafuer, dass niemand mehr einen Ausweg vorgespielt
  * bekommt, den es nicht gibt.
  */
-export function firmenZeilen(namen) {
+export function firmenZeilen(namen, s) {
+    const t = ALLGEMEIN_TEXTE[s];
     const anzahl = (name) => namen.filter((n) => n === name).length;
     const gesehen = new Set();
     const zeilen = [];
@@ -44,10 +47,10 @@ export function firmenZeilen(namen) {
             // 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 ${alsWort(name, true)}`);
+            zeilen.push(t.companyLine(befehlIn("firma daten", s), schalterIn("firma", s), alsWort(name, true))); // kein-anzeigetext: Befehlsschluessel
         }
         else {
-            zeilen.push(`    „${name}" — kommt ${wieOft}× vor und ist über den Namen nicht wählbar.`);
+            zeilen.push(t.nameNotUnique(name, wieOft));
         }
     }
     return zeilen;
@@ -67,8 +70,8 @@ export function firmenZeilen(namen) {
  * kopierfertige Befehle. Der Name steht als Kommentar dahinter -- eine nackte
  * UUID sagt einem Menschen nichts, und zwei davon untereinander noch weniger.
  */
-export function firmenIdZeilen(auswahl) {
-    return auswahl.map((f, i) => `    kimal3 firma daten --firma-id "${f.id}"   # ${f.name} (${i + 1}.)`);
+export function firmenIdZeilen(auswahl, s) {
+    return auswahl.map((f, i) => ALLGEMEIN_TEXTE[s].companyIdLine(befehlIn("firma daten", s), schalterIn("firma-id", s), f.id, f.name, i + 1));
 }
 /**
  * Die Namen der eigenen Firmen aus einer `409`-Antwort -- was nicht als Text

package/dist/format.js

@@ -0,0 +1,41 @@
+const REGION = { de: "de-DE", en: "en-GB" };
+const MONATE_DE = [
+    "Januar", "Februar", "März", "April", "Mai", "Juni", // kein-anzeigetext: deutsche Monatsnamen als Handliste (T3-13, ICU-unabhaengig); Englisch kommt aus Intl
+    "Juli", "August", "September", "Oktober", "November", "Dezember", // kein-anzeigetext: siehe Zeile 13
+];
+/**
+ * "2026-07-01" -> "1. Juli 2026" / "1 July 2026". Aus der Zeichenkette, nie ueber die Ortszeit
+ * (ein ISO-Datum ohne Uhrzeit gilt als UTC-Mitternacht und kippt sonst einen Tag zurueck).
+ * ⚠️ Erwartet ein REINES Datum (`JJJJ-MM-TT`); passt es nicht, steht lieber das rohe Datum da
+ * als ein kaputter Satz ("NaN. August 2026", der Fehler vom 2026-08-12).
+ */
+export function datumLang(isoDatum, s) {
+    const [jahr, monat, tag] = isoDatum.split("-").map(Number);
+    // 🔑 Deutsch aus der Handliste (T3-13): Die deutsche Ausgabe haengt nicht an der ICU-Fassung des Rechners.
+    if (s === "de") {
+        const name = MONATE_DE[monat - 1];
+        return !name || !jahr || !Number.isFinite(tag) ? isoDatum : `${tag}. ${name} ${jahr}`;
+    }
+    if (!jahr || !(monat >= 1 && monat <= 12) || !tag)
+        return isoDatum;
+    return new Intl.DateTimeFormat(REGION[s], { day: "numeric", month: "long", year: "numeric", timeZone: "UTC" })
+        .format(new Date(Date.UTC(jahr, monat - 1, tag, 12)));
+}
+/**
+ * "1200" -> "1.200 €" / "€1,200"; "0.1" -> "0,10 €" / "€0.10". Cent nur, wenn welche dastehen:
+ * "1.200,00 €" taeuscht eine Genauigkeit vor, "0 €" bei 0,10 € verschweigt eine, die dasteht.
+ * Euro bleibt Euro (Teil 1).
+ */
+export function euro(wert, s) {
+    const stellen = Math.round(wert * 100) % 100 !== 0 ? 2 : 0;
+    if (s === "de") {
+        return `${new Intl.NumberFormat("de-DE", { minimumFractionDigits: stellen, maximumFractionDigits: stellen }).format(wert)} €`;
+    }
+    return new Intl.NumberFormat("en-GB", {
+        style: "currency", currency: "EUR", minimumFractionDigits: stellen, maximumFractionDigits: stellen,
+    }).format(wert);
+}
+/** "6" -> "6", "6.5" -> "6,5" / "6.5". Die Spalte ist numeric(6,2). */
+export function stunden(wert, s) {
+    return new Intl.NumberFormat(REGION[s], { maximumFractionDigits: 2 }).format(wert);
+}

package/dist/fragen-lesen.js

@@ -12,7 +12,7 @@
   🔴 WARUM DAS NICHT NUR BEQUEM, SONDERN DAS EINZIG EHRLICHE IST: Die CLI kann
   nichts aus `src/` importieren (eigenes Paket, eigenes tsconfig -- s. Kopf von
   `kontext-stand.ts`). Ein Katalog in `cli/src/` waere eine ZWEITE Fassung der
-  17 Fragen, und sie friert in dem Moment ein, in dem `npm publish` laeuft: Der
+  Fragen, und sie friert in dem Moment ein, in dem `npm publish` laeuft: Der
   Kunde hat dann eine CLI von gestern und Dateien von heute. Die Datei auf
   seiner Platte kommt dagegen IMMER vom Server -- sie ist die einzige Quelle,
   die nicht gegenueber dem abweichen kann, was er wirklich vor sich hat.
@@ -158,14 +158,14 @@ export function fragenAus(text) {
  *
  * 🔑 **WORAN ERKANNT WIRD: an mindestens einem Anker, der zu DIESER Datei
  * gehoert.** Die Anker sind je Datei benannt (`marke_anrede`, `firma_angebot`,
- * `kurz_kunden` …), und `FIRMEN_TEXTE` (`kontext-stand.ts`) fuehrt je Datei
+ * `kurz_kunden` …), und `firmenTexte` (`kontext-stand.ts`) fuehrt je Datei
  * ihren Praefix. Damit faellt nicht nur die voellig fremde Datei durch, sondern
  * auch der haeufigere Unfall: `marke.md` ueber `firma.md` kopiert. Ein blosses
  * "irgendein Anker steht drin" haette genau den durchgewunken.
  *
  * ⚠️ **Dass die Praefixe wirklich passen, ist keine Verabredung, sondern eine
  * Messung:** `check:kontext` haelt jeden Anker aus `FRAGEN` (der App) gegen den
- * Praefix, den `FIRMEN_TEXTE` fuer seine Datei nennt.
+ * Praefix, den `firmenTexte` fuer seine Datei nennt.
  *
  * 📌 **Der Preis, ausgesprochen:** Wer ALLE Anker einer Datei loescht und nur
  * die Ueberschriften stehen laesst, bekommt hier ein Nein, obwohl die App den

package/dist/hilfe.js

@@ -0,0 +1,24 @@
+import { BEFEHLE } from "./befehle-katalog.js";
+import { anzeigeIn } from "./befehle-katalog-en.js";
+import { ALLGEMEIN_TEXTE } from "./texte/allgemein.js";
+/**
+ * Die Terminal-Hilfe, gebaut aus dem Katalog (umgezogen aus `befehle-katalog.ts`, Teil 3,
+ * T3-11: Sie braucht jetzt beide Katalog-Dateien, und der Katalog bleibt importfrei).
+ *
+ * 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`.
+ *
+ * 🔴 Deutsch Zeichen fuer Zeichen wie vorher; Englisch mit EINER Zeile mehr (T3-13): die deutschen
+ * Befehlswoerter laufen ebenfalls. Der Rahmen (Leerzeichen, Zeilenumbrueche) steht IN den
+ * Textschluesseln, nicht hier (TU-2).
+ */
+export function hilfeText(s) {
+    const t = ALLGEMEIN_TEXTE[s];
+    const eintraege = BEFEHLE.map((b) => anzeigeIn(b, s));
+    const breite = Math.max(...eintraege.map((e) => e.befehl.length));
+    const zeilen = eintraege.map((e) => `  ${e.befehl.padEnd(breite + 2)}${e.beschreibung}`).join("\n");
+    return `${t.helpTagline}${zeilen}${t.helpGermanWordsToo}${t.helpMore}`;
+}

package/dist/kimal3.js

@@ -16,10 +16,14 @@ import { BASIS_URL, leseAnmeldung } from "./anmeldung.js";
 import { gemerkterHinweis, lokalerKontextStandJetzt, NichtAngemeldet } from "./api.js";
 import { leseGesehen, merkeGesehen } from "./gesehen.js";
 import { ausfallMeldung, hinweisAnhaengen } from "./wache-rechnung.js";
+import { WACHE_TEXTE } from "./texte/wache.js";
 import { leseWacheDatei, sitzungJetzt, wacheAusgefallen } from "./wache-schalter.js";
-import { formatiere, heuteAus, skillMeldung, skillZustand, sollZeigen, } from "./nachricht.js";
+import { formatiere, heuteAus, skillZustand, sollZeigen, } from "./nachricht.js";
 import { eigeneVersion } from "./version.js";
-import { hilfeText } from "./befehle-katalog.js";
+import { sprache } from "./sprache.js";
+import { ALLGEMEIN_TEXTE } from "./texte/allgemein.js";
+import { hilfeText } from "./hilfe.js";
+import { erkenneBefehl } from "./befehlswoerter.js";
 import { arbeitsplatzNeu } from "./befehle/arbeitsplatz.js";
 import { werkbankNeu } from "./befehle/werkbank.js";
 import { firmaDaten } from "./befehle/firma-daten.js";
@@ -135,7 +139,9 @@ function gegenUnbehandelteKanalfehlerAbsichern(kanal, meldenAuf) {
             return;
         schonGemeldet = true;
         try {
-            meldenAuf.write(`kimal3: Ausgabekanal-Fehler -- ${fehler.message}\n`);
+            // 🌐 Teil 3: die Sprache wird erst JETZT gelesen (zur Schreibzeit); der Empfaenger selbst
+            // bleibt auf Modulebene vor der ersten Zeile angemeldet.
+            meldenAuf.write(ALLGEMEIN_TEXTE[sprache()].outputChannelError(fehler.message));
         }
         catch {
             // Auch der Fehlerkanal kann kaputt sein -- dann bleibt wenigstens der
@@ -149,7 +155,6 @@ gegenUnbehandelteKanalfehlerAbsichern(process.stderr, null);
 // `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.
  *
@@ -189,8 +194,9 @@ function versionsZeilen() {
     // Zeile zeigt einem Menschen etwas an, und da ist "unbekannt" die ehrliche
     // Antwort. Der andere Aufrufer RECHNET mit dem Wert und braucht dort das
     // Gegenteil -- er will lieber gar keine Nummer als eine erfundene.
-    const version = eigeneVersion() ?? "unbekannt";
-    return `  kimal3 ${version}\n  spricht mit ${BASIS_URL}`;
+    const t = ALLGEMEIN_TEXTE[sprache()];
+    const version = eigeneVersion() ?? t.versionUnknown;
+    return t.versionLines(version, BASIS_URL);
 }
 /**
  * Welcher Update-Hinweis soll ans Ende -- oder keiner?
@@ -254,12 +260,12 @@ function hinweisText() {
         // verrottet lautlos (Befund der vierten Review-Runde).
         const datei = skillDatei();
         const inhalt = existsSync(datei) ? readFileSync(datei, "utf8") : null;
-        if (skillZustand(inhalt, eigene) === "veraltet") {
+        if (skillZustand(inhalt, eigene, sprache()) === "veraltet") {
             // Auch dieser Hinweis nur einmal am Tag, unter einer festen Kennung.
             // Sie kann mit keiner Nachrichten-UUID kollidieren.
             const gesehen = leseGesehen();
             if (gesehen["skill-veraltet"] !== heute) {
-                return { text: skillMeldung(), kennung: "skill-veraltet", tag: heute };
+                return { text: WACHE_TEXTE[sprache()].skillOutdated, kennung: "skill-veraltet", tag: heute };
             }
         }
         /*
@@ -281,7 +287,7 @@ function hinweisText() {
             // Auch dieser Hinweis hoechstens einmal am Tag, unter fester Kennung.
             const gesehen = leseGesehen();
             if (gesehen["wache-ausgefallen"] !== heute) {
-                return { text: ausfallMeldung(), kennung: "wache-ausgefallen", tag: heute };
+                return { text: ausfallMeldung(sprache()), kennung: "wache-ausgefallen", tag: heute };
             }
         }
     }
@@ -463,17 +469,61 @@ function endeMitHinweis(code) {
  * nicht mehr Auskunft, sondern **weniger Behauptung**.
  */
 function zustandsZeile() {
+    const t = ALLGEMEIN_TEXTE[sprache()];
     const a = leseAnmeldung();
-    return a
-        ? `  ● Ausweis hinterlegt für ${a.email}\n` +
-            "    (ob er noch gilt, zeigt erst der nächste Befehl)"
-        : "  ● Nicht angemeldet.  →  kimal3 login";
+    return a ? t.credentialsStored(a.email) : t.notSignedIn;
+}
+/** `null` = der Rest passt nicht zu diesem Befehl -> "kenne ich nicht", wie bisher. */
+async function fuehreAus(name, rest) {
+    const allein = rest.length === 0;
+    switch (name) {
+        case "login": return allein ? login() : null;
+        case "logout": return allein ? logout() : null;
+        case "skill install": return allein ? skillInstall() : null;
+        case "projekt neu": return projektNeu(rest);
+        case "projekt liste": return allein ? projektListe() : null;
+        // ⚠️ Rest wird durchgereicht, nicht auf Gleichheit geprueft: `firma daten --firma X` gehoert dazu.
+        case "firma daten": return firmaDaten(rest);
+        case "arbeitsplatz neu": return arbeitsplatzNeu(rest);
+        case "werkbank neu": return werkbankNeu(rest);
+        case "kontext runter": return kontextRunter(rest);
+        case "kontext hoch": return kontextHoch(rest);
+        case "kontext fragen": return kontextFragen(rest);
+        case "wache an": return allein ? wacheSchalten(true) : null;
+        case "wache aus": return allein ? wacheSchalten(false) : null;
+        case "wache":
+            // 🔴 Der Startbefehl aus `~/.claude/settings.json`, den `skill install` eintraegt (T3-5:
+            // eingetragen wird immer `kimal3 wache --hook`; `kimal3 watch --hook` laeuft genauso).
+            // Er verpackt die Meldung anders -- Begruendung an `wache()`.
+            // ⚠️ Ein Mensch tippt das nie; der Katalog nennt ihn deshalb auch nicht.
+            if (rest.length === 1 && rest[0] === "--hook")
+                return wache(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 (rest.every((a) => a.startsWith("--")))
+                return wache(false);
+            return null;
+    }
 }
 async function haupt() {
     const argv = process.argv.slice(2);
     const wort = argv.join(" ");
     if (argv.length === 0 || wort === "--help" || wort === "-h") {
-        console.log(HILFE);
+        console.log(hilfeText(sprache()));
         console.log(zustandsZeile() + "\n");
         return 0;
     }
@@ -482,61 +532,17 @@ async function haupt() {
         console.log(zustandsZeile() + "\n");
         return 0;
     }
-    if (wort === "login")
-        return login();
-    if (wort === "logout")
-        return logout();
-    if (argv[0] === "projekt" && argv[1] === "neu")
-        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();
-    if (argv[0] === "arbeitsplatz" && argv[1] === "neu")
-        return arbeitsplatzNeu(argv.slice(2));
-    if (argv[0] === "werkbank" && argv[1] === "neu")
-        return werkbankNeu(argv.slice(2));
-    if (argv[0] === "kontext" && argv[1] === "runter")
-        return kontextRunter(argv.slice(2));
-    if (argv[0] === "kontext" && argv[1] === "hoch")
-        return kontextHoch(argv.slice(2));
-    if (argv[0] === "kontext" && argv[1] === "fragen")
-        return kontextFragen(argv.slice(2));
-    if (wort === "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}`);
+    // 🌐 Teil 3 (T3-3): ein Verteiler fuer beide Sprachen. Was heute nur ALLEIN gilt
+    // (`login`, `projekt liste`, `wache an` …), gilt auch weiterhin nur allein -- `kimal3 login
+    // extra` bleibt unbekannt. Der grosse Kommentar zur Nachsicht bei `wache --irgendwas` steht
+    // unten an `fuehreAus` und gilt unveraendert.
+    const erkannt = erkenneBefehl(argv);
+    if (erkannt) {
+        const code = await fuehreAus(erkannt.name, erkannt.rest);
+        if (code !== null)
+            return code;
+    }
+    console.error(`${ALLGEMEIN_TEXTE[sprache()].unknownCommand(wort)}${hilfeText(sprache())}`);
     return 1;
 }
 haupt()
@@ -564,10 +570,10 @@ haupt()
     // Node laeuft aus, sobald die Kanaele leer sind.
     .catch((f) => {
     if (f instanceof NichtAngemeldet) {
-        console.error("Bitte zuerst `kimal3 login` ausführen.");
+        console.error(ALLGEMEIN_TEXTE[sprache()].signInFirst);
         process.exitCode = 2;
         return;
     }
-    console.error("kimal3 ist gerade nicht erreichbar.");
+    console.error(ALLGEMEIN_TEXTE[sprache()].unreachable);
     process.exitCode = 3;
 });