kimal3 0.2.9 → 0.3.0

package/dist/befehle/werkbank.js

@@ -2,8 +2,12 @@ import { existsSync, statSync } from "node:fs";
 import { resolve } from "node:path";
 import { FIRMEN_OPTIONEN, dateienSchreiben, istUnsichererOrdnername, vorlageHolen, werkbankOrdner, } from "../arbeitsplatz-dateien.js";
 import { alsBefehlszeile, alsWort, trenneNamenUndOptionen, zerlege } from "../argumente.js";
-import { werkbankOrdnerAus, werkbankUmbenennen } from "../werkbank-name.js";
-import { FIRMEN_CLAUDE_MD, MERKZETTEL_PFAD, firmenAbgleich, firmennameAusClaudeMd, leseMerkzettel, } from "../kontext-stand.js";
+import { befehlIn, schalterIn } from "../befehlswoerter.js";
+import { sprache } from "../sprache.js";
+import { ARBEITSPLATZ_TEXTE } from "../texte/arbeitsplatz.js";
+import { WERKBANK_TEXTE } from "../texte/werkbank.js";
+import { werkbankOrdnerAus, werkbankSpracheAus, werkbankUmbenennen } from "../werkbank-name.js";
+import { FIRMEN_CLAUDE_MD, MERKZETTEL_PFAD, ORDNER_NAMEN, firmenAbgleich, firmennameAusClaudeMd, leseMerkzettel, } from "../kontext-stand.js";
 import { leseEineDatei, leseMerkzettelDatei } from "../kontext-dateien.js";
 /**
  * Legt **nur eine Werkbank** an — in einem Firmen-Ordner, der schon steht.
@@ -56,27 +60,10 @@ import { leseEineDatei, leseMerkzettelDatei } from "../kontext-dateien.js";
  * verwalten (s. `WEITER-HIER.md`, Entscheidungen). Was dann von außen kommt,
  * darf ein lokaler Befehl nicht überschreiben.
  */
-const HILFE = `
-  kimal3 werkbank neu [dein-vorname] [--firma "Name" | --firma-id "…"]
-
-  Legt eine eigene Werkbank in einem bestehenden Firmen-Ordner an.
-  Die Firmenebene (kontext/, CLAUDE.md, README.md) wird NICHT angefasst.
-
-  dein-vorname  Optional. Der Ordner traegt deinen Namen -- aus "sabine"
-                wird "werkbank-sabine". Ohne Angabe steht dort der Name,
-                den der Server aus deiner Anmelde-Adresse gebildet hat.
-
-  --firma "Name"   Noetig, wenn du zu mehreren Firmen gehoerst.
-                   Die Absage nennt dir die Namen als fertige Befehle.
-
-  --firma-id "…"   Fuer den Fall, dass zwei deiner Firmen GLEICH heissen.
-                   Auch diese Absage nennt dir fertige Befehle.
-
-  🔴 Bricht ab, wenn der Zielordner schon existiert und NICHT leer ist.
-
-  Du hast noch gar keinen Firmen-Ordner?
-     kimal3 arbeitsplatz neu <dein-vorname>
-`;
+/** Die Hilfe von `werkbank neu` / `workbench new` in der Sprache des Menschen. */
+export function hilfe(s) {
+    return WERKBANK_TEXTE[s].help;
+}
 /**
  * 🔴 **Review-Runde 2 zu PR #25 — und es ist DERSELBE Fehler wie in Runde 1,
  * nur eine Datei weiter.** Hier stand:
@@ -102,16 +89,14 @@ const HILFE = `
  * fuellen muss, obwohl die Antwort danebensteht. *Ein Platzhalter ist ein
  * Eingestaendnis, dass man es nicht weiss -- hier weiss man es.*
  */
-function hinweisFuer(ordnerName) {
-    const ziel = alsWort(ordnerName);
-    return ("  Ist das DEINE Werkbank? Dann steht sie schon -- geh einfach hinein:\n" +
-        `    cd ${ziel}\n` +
-        "  Bist du es nicht, nimm deinen eigenen Vornamen:\n" +
-        "    kimal3 werkbank neu <dein-vorname>");
+function hinweisFuer(ordnerName, s) {
+    return WERKBANK_TEXTE[s].adviceOwnWorkbench(alsWort(ordnerName), befehlIn("werkbank neu", s)); // kein-anzeigetext: Befehlsschlüssel
 }
 export async function werkbankNeu(argv) {
+    let s = sprache();
+    let t = WERKBANK_TEXTE[s];
     if (argv.includes("--help") || argv.includes("-h")) {
-        console.log(HILFE);
+        console.log(hilfe(s));
         return 0;
     }
     /*
@@ -133,7 +118,7 @@ export async function werkbankNeu(argv) {
     const { woerter, optionen: optionsArgv } = trenneNamenUndOptionen(argv);
     const nameArg = woerter[0];
     if (nameArg !== undefined && nameArg.trim() === "") {
-        console.error(`Ein leerer Name ist kein gueltiger Name.\n${HILFE}`);
+        console.error(t.emptyName + hilfe(s));
         return 1;
     }
     if (woerter.length > 1) {
@@ -160,17 +145,15 @@ export async function werkbankNeu(argv) {
         */
         const optionsAnhang = optionsArgv.length === 0 ? "" : ` ${alsBefehlszeile(optionsArgv)}`;
         const vorschlag = einfacheWoerter.length === woerter.length
-            ? `Besteht dein Name aus mehreren Woertern? Dann schreib ihn zusammen:\n` +
-                `  kimal3 werkbank neu ${einfacheWoerter.join("-")}${optionsAnhang}\n`
+            ? t.nameSuggestion(befehlIn("werkbank neu", s), einfacheWoerter.join("-"), optionsAnhang) // kein-anzeigetext: Befehlsschlüssel
             : "";
-        console.error(`Mit „${woerter[1]}" kann ich hier nichts anfangen -- nur EIN Name ist erlaubt.\n` +
-            `${vorschlag}${HILFE}`);
+        console.error(t.onlyOneName(woerter[1]) + vorschlag + hilfe(s));
         return 1;
     }
     // 🔑 Erst NACH den Namens-Absagen -- s. Zwilling in `arbeitsplatz.ts`.
-    const zerlegt = zerlege(optionsArgv, FIRMEN_OPTIONEN);
+    const zerlegt = zerlege(optionsArgv, FIRMEN_OPTIONEN, s);
     if (!zerlegt.ok) {
-        console.error(`${zerlegt.meldung}\n${HILFE}`);
+        console.error(`${zerlegt.meldung}\n${hilfe(s)}`);
         return 1;
     }
     const wunsch = {
@@ -180,14 +163,13 @@ export async function werkbankNeu(argv) {
     // `null` heisst: nach dem Umschreiben blieb kein Zeichen uebrig, das in einem
     // Ordnernamen stehen darf. Ein Mensch hat hier getippt und verdient eine
     // Antwort -- der Server schweigt im selben Fall und bleibt beim Vordruck.
-    let gewuenschteWerkbank = null;
+    // 🌐 Teil 2: nur „bleibt etwas uebrig?" -- das Praefix kommt erst aus der Lieferung, s. unten.
     if (nameArg !== undefined) {
-        gewuenschteWerkbank = werkbankOrdnerAus(nameArg);
-        if (gewuenschteWerkbank === null) {
-            console.error(`Aus „${nameArg}" kann ich keinen Ordnernamen machen -- es bleiben nur`);
-            console.error("Zeichen uebrig, die in keinem Ordnernamen stehen duerfen.");
+        if (werkbankOrdnerAus(nameArg, "de") === null) {
+            console.error(t.unusableName1(nameArg));
+            console.error(t.unusableName2);
             console.error("");
-            console.error("  Nimm deinen Vornamen:  kimal3 werkbank neu sabine");
+            console.error(t.unusableName3(befehlIn("werkbank neu", s))); // kein-anzeigetext: Befehlsschlüssel
             return 1;
         }
     }
@@ -198,12 +180,24 @@ export async function werkbankNeu(argv) {
       wird nie erreicht.
     */
     // 🔑 Der getippte Vorname reist in der Absage mit -- s. Zwilling.
-    const befehlsname = nameArg === undefined
-        ? "werkbank neu"
-        : `werkbank neu ${alsWort(nameArg)}`;
-    const holen = await vorlageHolen(befehlsname, wunsch);
+    /*
+      🔑 **Die Firma dieses Ordners** -- Kennung aus dem Merkzettel, Name aus der
+      Firmen-`CLAUDE.md`. `vorlageHolen` nimmt sie nur, wenn der Server wegen
+      mehrerer Firmen fragt (A2-6, 25.09.), und die Wache weiter unten
+      (`firmenAbgleich`) vergleicht mit genau diesen beiden Werten.
+    */
+    const hierGelesen = leseEineDatei(process.cwd(), FIRMEN_CLAUDE_MD);
+    const ordnerFirma = {
+        id: leseMerkzettelDatei(process.cwd()).firma_id,
+        name: firmennameAusClaudeMd(hierGelesen.ok ? hierGelesen.inhalt : null),
+    };
+    const holen = await vorlageHolen("werkbank neu", // kein-anzeigetext: Befehlsschlüssel
+    nameArg === undefined ? "" : ` ${alsWort(nameArg)}`, wunsch, ordnerFirma);
     if (!holen.ok)
         return holen.wert;
+    // 🌐 Die Antwort kann die Kontosprache umgestellt haben (Spec 3.2, Schritt 3): Was ab hier gedruckt wird, in der neuen.
+    s = sprache();
+    t = WERKBANK_TEXTE[s];
     const daten = holen.daten;
     const werkbank = werkbankOrdner(daten.dateien);
     /*
@@ -250,14 +244,17 @@ export async function werkbankNeu(argv) {
       ist kein Grund, sie hier falsch zu benennen.
     */
     if (werkbank !== null && istUnsichererOrdnername(werkbank)) {
-        console.error(`Die Antwort enthaelt einen unsicheren Ordnernamen: „${werkbank}". Bitte melden.`);
+        console.error(t.unsafeFolderName(werkbank));
         return 3;
     }
     if (werkbank === null) {
-        console.error("In der Vorlage steckt kein Werkbank-Ordner -- damit kann ich hier nichts anlegen.");
-        console.error("Bitte melden.");
+        console.error(t.noWorkbank1);
+        console.error(t.noWorkbank2);
         return 3;
     }
+    // 🌐 Teil 2: Das Praefix der gelieferten Werkbank ist die Kontosprache; ein getipptes fremdes
+    // Praefix wird ersetzt, nie verdoppelt (`workbench-jens` bei deutschem Konto -> `werkbank-jens`).
+    const gewuenschteWerkbank = nameArg === undefined ? null : werkbankOrdnerAus(nameArg, werkbankSpracheAus(werkbank) ?? "de");
     /*
       🔑 **Die Prüfung, ob wir überhaupt in einer Firma stehen** -- und sie ist
       keine Förmlichkeit: In `<werkbank>/.claude/settings.json` steht
@@ -304,17 +301,28 @@ export async function werkbankNeu(argv) {
       Eine kaputte Lieferung ist keine falsche Eingabe.
     */
     if (firmenOrdner.length === 0) {
-        console.error("Die Vorlage vom Server nennt gar keine Firmenebene -- damit kann ich");
-        console.error("nicht pruefen, ob du an der richtigen Stelle stehst.");
-        console.error("Das liegt nicht an dir. Bitte melden.");
+        console.error(t.noCompanyLevel1);
+        console.error(t.noCompanyLevel2);
+        console.error(t.noCompanyLevel3);
         return 3;
     }
+    /*
+      🔴 **Teil-2-Rest Minor 7: Der Firmen-Ordner steht da, nur in der Sprache von frueher.** Alter
+      deutscher Ordner (`kontext/`), Firma inzwischen englisch: Der Server liefert die englische
+      Vorlage, `fehlend` nennt `context` -- und der Mensch las "Hier steht kein Firmen-Ordner" samt
+      "Bist du der ERSTE in deiner Firma?". Beides falsch. Diese Absage kommt VOR dem Zweig darunter.
+    */
+    const ordnerSprache = andereOrdnerSprache(fehlend, istOrdner);
+    if (ordnerSprache !== null) {
+        console.error(t.folderInOtherLanguage(ordnerSprache, `kimal3 ${befehlIn("arbeitsplatz neu", s)}`)); // kein-anzeigetext: Befehlsschlüssel
+        return 1;
+    }
     if (fehlend.length > 0) {
-        console.error("Hier steht kein Firmen-Ordner -- ich sehe kein " + fehlend.join(", ") + ".");
-        console.error("Eine Werkbank braucht die Firmenebene daneben; ohne sie findet Claude");
-        console.error("euren Firmenkontext nicht.");
+        console.error(t.noCompanyFolder1(fehlend.join(", ")));
+        console.error(t.noCompanyFolder2);
+        console.error(t.noCompanyFolder3);
         console.error("");
-        console.error("  Steht er woanders? Geh dorthin und versuch es dort noch einmal.");
+        console.error(t.noCompanyFolder4);
         console.error("");
         /*
           🔴 **Hier stand „Du hast noch keinen? kimal3 arbeitsplatz neu"**
@@ -337,12 +345,12 @@ export async function werkbankNeu(argv) {
           das so ist, ist die ehrliche Auskunft „frag, wo er liegt" -- und nicht
           ein Befehl, der etwas Falsches anlegt.
         */
-        console.error("  Bist du der ERSTE in deiner Firma?");
-        console.error("    kimal3 arbeitsplatz neu <dein-vorname>");
+        console.error(t.noCompanyFolder5);
+        console.error(t.noCompanyFolder6(befehlIn("arbeitsplatz neu", s))); // kein-anzeigetext: Befehlsschlüssel
         console.error("");
-        console.error("  Hat deine Firma schon einen? Dann hol dir DEN -- z. B. als Kopie");
-        console.error("  oder ueber euer Repo. Leg keinen neuen an, sonst habt ihr zwei");
-        console.error("  verschiedene Firmenordner mit verschiedenen Regeln darin.");
+        console.error(t.noCompanyFolder7);
+        console.error(t.noCompanyFolder8);
+        console.error(t.noCompanyFolder9);
         return 1;
     }
     /*
@@ -365,11 +373,7 @@ export async function werkbankNeu(argv) {
       („ich schicke nichts Halbes hoch“).
     */
     const inhaltAus = (pfad) => daten.dateien.find((d) => d.pfad === pfad)?.inhalt ?? null;
-    const hierGelesen = leseEineDatei(process.cwd(), FIRMEN_CLAUDE_MD);
-    const abgleich = firmenAbgleich({
-        id: leseMerkzettelDatei(process.cwd()).firma_id,
-        name: firmennameAusClaudeMd(hierGelesen.ok ? hierGelesen.inhalt : null),
-    }, {
+    const abgleich = firmenAbgleich(ordnerFirma, {
         id: leseMerkzettel(inhaltAus(MERKZETTEL_PFAD)).firma_id,
         name: firmennameAusClaudeMd(inhaltAus(FIRMEN_CLAUDE_MD)),
     });
@@ -381,10 +385,10 @@ export async function werkbankNeu(argv) {
       sieht, und laesst den Menschen entscheiden.
     */
     if (abgleich.art === "zweifel") {
-        console.error(`Achtung: Dieser Ordner nennt als Firma „${abgleich.hier}",`);
-        console.error(`du hast aber „${abgleich.gewaehlt}" gewaehlt.`);
-        console.error("Ich lege die Werkbank trotzdem an -- vielleicht heisst die Firma bei euch");
-        console.error("nur anders geschrieben. Stimmt es nicht, loesch den neuen Ordner wieder.");
+        console.error(t.doubt1(abgleich.hier));
+        console.error(t.doubt2(abgleich.gewaehlt));
+        console.error(t.doubt3);
+        console.error(t.doubt4);
         console.error("");
     }
     if (abgleich.art === "andere-firma") {
@@ -400,20 +404,20 @@ export async function werkbankNeu(argv) {
         */
         const genannt = wunsch.firma ?? wunsch.firmaId;
         if (genannt === undefined) {
-            console.error("Dieser Ordner gehoert zu einer anderen Firma als der, zu der du gehoerst.");
-            console.error("Ich lege hier keine Werkbank an, die einen fremden Firmennamen traegt --");
-            console.error("sie wuerde Claude bei jedem Start die falsche Firma nennen.");
+            console.error(t.otherCompany1);
+            console.error(t.otherCompany2);
+            console.error(t.otherCompany3);
             console.error("");
-            console.error("  Deine Werkbank gehoert in den Ordner DEINER Firma. Geh dorthin und");
-            console.error("  versuch es dort noch einmal.");
+            console.error(t.otherCompany4);
+            console.error(t.otherCompany5);
             return 1;
         }
-        console.error(`Dieser Ordner gehoert zu einer ANDEREN Firma als „${genannt}".`);
-        console.error("Ich lege hier keine Werkbank an, die einen fremden Firmennamen traegt --");
-        console.error("sie wuerde Claude bei jedem Start die falsche Firma nennen.");
+        console.error(t.otherNamedCompany1(genannt));
+        console.error(t.otherNamedCompany2);
+        console.error(t.otherNamedCompany3);
         console.error("");
-        console.error(`  Soll die Werkbank fuer „${genannt}" sein? Dann gehoert sie in DEREN Ordner.`);
-        console.error("  Soll sie fuer die Firma hier sein? Dann nimm deren Namen.");
+        console.error(t.otherNamedCompany4(genannt));
+        console.error(t.otherNamedCompany5);
         return 1;
     }
     /*
@@ -453,20 +457,46 @@ export async function werkbankNeu(argv) {
     const meine = umbenannt
         .filter((d) => d.pfad.startsWith(praefix))
         .map((d) => ({ pfad: d.pfad.slice(praefix.length), inhalt: d.inhalt }));
-    const wert = dateienSchreiben(meine, ordnerName, hinweisFuer(ordnerName));
+    const wert = dateienSchreiben(meine, ordnerName, hinweisFuer(ordnerName, s));
     if (wert !== 0)
         return wert;
-    console.log(`✓ ${meine.length} ${meine.length === 1 ? "Datei" : "Dateien"} angelegt.`);
+    console.log(ARBEITSPLATZ_TEXTE[s].filesCreated(meine.length));
     console.log(`  ${resolve(ordnerName)}`);
     console.log("");
-    console.log("  Die Firmenebene ist unberuehrt geblieben.");
+    console.log(t.companyUntouched);
     console.log("");
-    console.log("  Weiter geht's:");
-    console.log(`    cd ${alsWort(ordnerName)}`);
-    console.log("    claude");
-    console.log('    dann "Lass uns einrichten" tippen');
+    /*
+      Erst NACH dem Anlegen (Lage L2): Vorher koennte noch eine Absage folgen, und
+      dann stuende da „uebernommen" fuer etwas, das nie entstanden ist.
+    */
+    if (holen.uebernommen) {
+        const gewaehlt = firmennameAusClaudeMd(inhaltAus(FIRMEN_CLAUDE_MD));
+        console.log(t.companyFromFolder(gewaehlt));
+        console.log(t.companyFromFolderHint(schalterIn("firma", s))); // kein-anzeigetext: Schalterschlüssel
+        console.log("");
+    }
+    // 🔑 Derselbe Rat wie nach `arbeitsplatz neu`: eine Fassung des Ausloesesatzes, nicht zwei.
+    console.log(ARBEITSPLATZ_TEXTE[s].nextStepsHeader);
+    console.log(`    cd ${alsWort(ordnerName)}`); // kein-anzeigetext: Befehlszeile zum Kopieren
+    console.log("    claude"); // kein-anzeigetext: Befehlszeile zum Kopieren
+    console.log(ARBEITSPLATZ_TEXTE[s].nextStepsSay);
     return 0;
 }
+/**
+ * Fehlt NUR der Kontextordner der Lieferung, weil hier der der ANDEREN Sprache steht? (Teil-2-Rest
+ * Minor 7: alter deutscher Ordner, Firma inzwischen englisch.) Dann ist das kein "hier steht kein
+ * Firmen-Ordner", sondern ein Sprachwechsel der Firma -- die Sprache des VORHANDENEN Ordners, sonst null.
+ * Rein (check:cli): `gibtEs` ist im Befehl `istOrdner`.
+ */
+export function andereOrdnerSprache(fehlend, gibtEs) {
+    if (fehlend.length !== 1)
+        return null;
+    if (fehlend[0] === ORDNER_NAMEN.en.kontext && gibtEs(ORDNER_NAMEN.de.kontext))
+        return "de";
+    if (fehlend[0] === ORDNER_NAMEN.de.kontext && gibtEs(ORDNER_NAMEN.en.kontext))
+        return "en";
+    return null;
+}
 /**
  * Die Ordner der Firmenebene, aus der Lieferung abgeleitet: jeder erste
  * Pfad-Teil, der einen Unterordner benennt und nicht die Werkbank ist.

package/dist/befehle-katalog-en.js

@@ -0,0 +1,185 @@
+export const BEFEHLE_EN = {
+    "kimal3 login": {
+        stempel: "013360ee",
+        befehl: "kimal3 login",
+        tippen: "! kimal3 login",
+        terminal: "kimal3 login",
+        beschreibung: "Connect this computer to your account",
+        rhythmusOderSatz: "once per computer",
+        details: [
+            "It shows you an address and a code: open the address in your browser and type in the code. The terminal picks up the confirmation automatically — you have ten minutes.",
+            "After that, it stays that way. Your sign-in is saved as a file in your user folder and survives IDE restarts, computer restarts and updates. If the connection does break after a long pause, a command will tell you — then just run kimal3 login once more; that's not an error.",
+        ],
+    },
+    "kimal3 skill install": {
+        stempel: "8491e5d6",
+        befehl: "kimal3 skill install",
+        tippen: "! kimal3 skill install",
+        terminal: "kimal3 skill install",
+        beschreibung: "Teach Claude to use this tool — and give you the /k3 commands",
+        rhythmusOderSatz: "once — and again after every update",
+        details: [
+            "The command that makes the others useful: it sets up 🤖 Claude's instructions (the “skill”) and 🧑 your slash commands.",
+            "It does NOT run automatically — run it once after installing and again after every update. Otherwise Claude keeps working with the old instructions.",
+            "You'll know it worked when it reports “Skill created.” and lists the slash commands. Claude only picks up both in your NEXT session — restart the current one.",
+        ],
+    },
+    "kimal3 arbeitsplatz neu": {
+        stempel: "231b90bf",
+        befehl: "kimal3 workplace new",
+        tippen: "! kimal3 workplace new",
+        terminal: "kimal3 workplace new",
+        beschreibung: "Create the whole AI Workplace — company level and workbench",
+        rhythmusOderSatz: "once per company",
+        details: [
+            "Fetches the template from your Pro account and creates it here as a real folder — CLAUDE.md, routine commands, the workbench for your projects. The same package is available to download on /pro.",
+            "The folder is called AI-Workplace (KI-Arbeitsplatz for a German-speaking company). To keep several companies apart, use the folder above it, e.g. Clients/ARNO/AI-Workplace. Add your first name and your workbench inside it is called workbench-sabine: kimal3 workplace new sabine.",
+            "If the target folder already exists and isn't empty, the command stops instead of overwriting anything — your work is safe. You'll know it worked when it tells you how many files it created.",
+            "⚠️ It also creates the company level (context/ with brand, systems, security — kontext/ in a German workplace). If that already exists, you need kimal3 workbench new — otherwise you end up with a second company inside the first.",
+        ],
+    },
+    "kimal3 werkbank neu": {
+        stempel: "da69f97f",
+        befehl: "kimal3 workbench new",
+        tippen: "! kimal3 workbench new",
+        terminal: "kimal3 workbench new",
+        beschreibung: "Only create your own workbench in an existing company",
+        rhythmusOderSatz: "once per person",
+        details: [
+            "For everyone except the first person: the company folder is already there (context/ with brand, systems, security — kontext/ in a German workplace) — you only need your own workbench inside it.",
+            "🔴 It doesn't touch the company level. Not a single byte in context/, CLAUDE.md or README.md — not even by writing an ‘identical’ copy over it.",
+            "It only runs if you really are in a company folder. If the company level next to it is missing, it stops and tells you — a workbench without it leads nowhere, because its settings refer to ../context (../kontext in a German workplace).",
+            "Add your first name — the folder is named after it: sabine becomes workbench-sabine. Without it, the server builds the name from your sign-in address. That way you can see later whose workbench is whose.",
+        ],
+    },
+    "kimal3 kontext runter": {
+        stempel: "9ccf1083",
+        befehl: "kimal3 context download",
+        tippen: "! kimal3 context download",
+        terminal: "kimal3 context download",
+        beschreibung: "Fetch the company context — CLAUDE.md and the five files in context/",
+        rhythmusOderSatz: "whenever the company might have changed something",
+        details: [
+            "Fetches CLAUDE.md and the five files in context/ (kontext/ in a German workplace) from your company and puts them in your AI Workplace. Anything you've changed locally is left alone — it tells you how to send it up.",
+            "If you changed a file locally AND the company has changed it too in the meantime, it saves your version in context/before-<date>/ (kontext/vorher-<datum>/ in a German workplace) first, then replaces it — nothing gets lost.",
+            "You'll know it worked when it names the updated files or says “Your company context is up to date.”",
+            "⚠️ Like kimal3 workbench new, it needs your own Pro account. Without one you get exit code 4 — then don't retry.",
+        ],
+    },
+    "kimal3 kontext fragen": {
+        stempel: "34decb4c",
+        befehl: "kimal3 context questions",
+        tippen: "/k3context",
+        terminal: "kimal3 context questions",
+        beschreibung: "Answer the questions about your company — Claude takes you through them",
+        rhythmusOderSatz: "let's answer the questions about my company",
+        details: [
+            "Reads the five files in context/ (kontext/ in a German workplace) and prints every question that has nothing written under it yet — with file, question and hint. If all are answered, it says so in one sentence.",
+            "It only reads: no network, no sign-in, no writing. That's why it comes first — Claude then asks you the questions one by one and writes your answers into the files.",
+            "After that, kimal3 context upload sends them to the company. Only the company admin may do that; everyone else passes their answers on.",
+        ],
+    },
+    "kimal3 kontext hoch": {
+        stempel: "fbf3f20b",
+        befehl: "kimal3 context upload",
+        tippen: "! kimal3 context upload",
+        terminal: "kimal3 context upload",
+        beschreibung: "Upload your local changes to the five company texts",
+        rhythmusOderSatz: "after you've edited context/*.md — company admin only",
+        details: [
+            "Sends all five company texts to your company — the files in context/ (profile.md, company.md, brand.md, systems.md, security.md; in a German workplace kontext/ with kurzprofil.md, firma.md, marke.md, systeme.md, sicherheit.md). That way they also reach your colleagues with their next kimal3 context download.",
+            "🔴 Only the company admin may do this. If you're not one, it tells you — then pass your addition on to the company admin; trying again won't change that.",
+            "⚠️ If something goes wrong, what counts is the MESSAGE, not the number after it. Exit code 1 stands for ‘you're not an admin’, ‘there's no workplace here’, ‘someone else has changed it in the meantime’ (way out: --overwrite) and several more. The same code also appears under “The company has saved your changes — only the local tracking file couldn't be written”, which only says that a file on your disk couldn't be written. That is a success: everything reached the company. Read the sentence, not the number.",
+            "If one of the five files no longer has its original questions — for example because something else was copied over it — it stops and sends nothing, not even the other four. kimal3 context download brings the file back.",
+            "You'll know it worked when it reports “✓ changed at the company:” with the file names.",
+        ],
+    },
+    "kimal3 projekt neu …": {
+        stempel: "34505297",
+        befehl: "kimal3 project new …",
+        tippen: "/k3project <what you built>",
+        terminal: 'kimal3 project new --title "Quote generator" --hours 4 --result 1200',
+        beschreibung: "Add a project to your success profile",
+        rhythmusOderSatz: "add this as a project",
+        details: [
+            "Just say so when you've finished something. Claude puts together the title, time saved and net result itself — it knows the numbers from your conversation. The slash command is the same route, just one step quicker.",
+            "It runs kimal3 project new. Only the title is required; kimal3 project new --help shows all the options.",
+        ],
+    },
+    "kimal3 projekt liste": {
+        stempel: "87d02e68",
+        befehl: "kimal3 project list",
+        tippen: "/k3list",
+        terminal: "kimal3 project list",
+        beschreibung: "Show the projects you've added",
+        rhythmusOderSatz: "show my projects",
+        details: [
+            "Shows what's already in your success profile — with dates and numbers.",
+            "What it's really for: Claude looks here BEFORE adding a project. Without that check, the same project would sooner or later appear twice on a public page that carries your name.",
+        ],
+    },
+    "kimal3 firma daten": {
+        stempel: "3195364c",
+        befehl: "kimal3 company data",
+        tippen: "/k3analyse <your question>",
+        terminal: 'kimal3 company data --company "Nordwind Handel GmbH"',
+        beschreibung: "Fetch your company's data so Claude can analyse it",
+        rhythmusOderSatz: "analyse my company",
+        details: [
+            "Fetches the key figures, people and projects of your company — Claude does the analysis. Just ask: “Which three projects bring in the most measurable return?”",
+            "If you belong to several companies, it never quietly picks one; it lays them out for you as ready-made commands. If two have the SAME name, --company-id helps — also ready to copy, you don't have to rename anything.",
+            "⚠️ This is personal data about your colleagues. For use in a real company you need a commercial Claude account with a data processing agreement. If employees' performance is analysed, in Germany this requires the works council's agreement (co-determination).",
+        ],
+    },
+    "kimal3 wache": {
+        stempel: "2daae4e2",
+        befehl: "kimal3 watch",
+        tippen: "! kimal3 watch",
+        terminal: "kimal3 watch",
+        beschreibung: "Check whether your access is valid and whether anything is pending",
+        rhythmusOderSatz: "automatically when Claude starts",
+        details: [
+            "The daily check runs by itself when Claude Code starts — you don't have to call it. Silent when there's nothing to do; an open task (access, version, skill) is reported in every session until it's done.",
+            "If it stays silent, everything is fine: no line means no problem. It only speaks up when your access has expired, a message is waiting, a new version is available or your skill files are out of date.",
+            "If it can't reach our server, it says nothing about access and messages — but still reports a new version if npm knows one. The two questions don't depend on each other.",
+        ],
+    },
+    "kimal3 logout": {
+        stempel: "9dfc20d7",
+        befehl: "kimal3 logout",
+        tippen: "! kimal3 logout",
+        terminal: "kimal3 logout",
+        beschreibung: "Disconnect this computer",
+        rhythmusOderSatz: "only when needed",
+        details: [
+            "Disconnects this one computer — useful on someone else's or a shared device, or if a computer goes missing. Your other computers stay signed in.",
+        ],
+    },
+};
+/**
+ * Der Fingerabdruck der deutschen Felder eines Katalog-Eintrags: FNV-1a ueber 32 Bit, 8 Hex-Zeichen.
+ * Ein eigener kleiner Hash statt `node:crypto`, damit die Datei importfrei bleibt; er muss keinem
+ * Angreifer standhalten, nur eine Textaenderung bemerken.
+ */
+export function fingerabdruck(b) {
+    const text = JSON.stringify([b.beschreibung, b.wer === "du" ? b.rhythmus : b.ausloeser, b.tippen, b.terminal, b.details]);
+    let h = 0x811c9dc5;
+    for (let i = 0; i < text.length; i++) {
+        h ^= text.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return (h >>> 0).toString(16).padStart(8, "0");
+}
+/** Was ein Katalog-Eintrag in einer Sprache anzeigt -- deutsch unveraendert aus dem Katalog. */
+export function anzeigeIn(eintrag, sprache) {
+    if (sprache === "en")
+        return BEFEHLE_EN[eintrag.befehl];
+    return {
+        befehl: eintrag.befehl,
+        tippen: eintrag.tippen,
+        terminal: eintrag.terminal,
+        beschreibung: eintrag.beschreibung,
+        rhythmusOderSatz: eintrag.wer === "du" ? eintrag.rhythmus : eintrag.ausloeser,
+        details: eintrag.details,
+    };
+}

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;
-}