kimal3 0.2.10 → 0.3.0

package/README.md

@@ -135,3 +135,138 @@ Proprietär. Die Nutzung ist Inhabern eines gültigen KImal3-Pro-Kontos gestatte
 Weitergabe, Veränderung und Weiterverwendung des Codes sind nicht erlaubt.
 
 © KImal3 · https://kimal3.de
+
+---
+
+# kimal3 (English)
+
+**Log your AI projects where they happen: in the terminal.**
+
+If you work with Claude Code, you build real things — and then never write them up, because that would be an extra step in another window. `kimal3` closes that gap: at the end
+of a session, Claude adds the finished project to your KImal3 success profile itself. All
+you do is approve it there.
+
+> **Requirement: a KImal3 account with Pro.**
+> Without Pro, this tool tells you so and does nothing else.
+> What Pro includes and how to get it: **https://app.kimal3.de/pro**
+
+## Getting started
+
+Once per computer:
+
+```bash
+npm install -g kimal3   # install the tool (needs Node.js)
+kimal3 login            # connect this computer to your account
+kimal3 skill install    # teach Claude to use the tool — and get the /k3 commands
+```
+
+> **In Claude Code?** Then have it set this up for you instead of typing it — the text to copy is on **https://app.kimal3.de/pro**. The only thing you type yourself is `kimal3 login` (with a `!` in front, there), because confirming it in the browser needs a person.
+
+`login` shows you an address and an eight-character code. You open the address yourself and
+confirm the code there, in your signed-in account — just like `gh auth login`.
+**No password is ever typed into the terminal.**
+
+## Commands
+
+```
+kimal3                    Shows whether this computer is signed in
+kimal3 login              Connect this computer to your account
+kimal3 skill install      Teach Claude to use this tool — and give you the /k3 commands
+kimal3 workplace new      Create the whole AI Workplace — company level and workbench
+kimal3 workbench new      Only create your own workbench in an existing company
+kimal3 context download   Fetch the company context — CLAUDE.md and the five files in context/
+kimal3 context questions  Answer the questions about your company — Claude takes you through them
+kimal3 context upload     Upload your local changes to the five company texts
+kimal3 project new …      Add a project to your success profile
+kimal3 project list       Show the projects you've added
+kimal3 company data       Fetch your company's data so Claude can analyse it
+kimal3 watch              Runs by itself when Claude starts: checks your access, messages, version and skill
+kimal3 watch off          Switch the daily check off — it then says nothing at all
+kimal3 watch on           Switch it back on
+kimal3 logout             Disconnect this computer
+```
+
+The German command names in the section above work too.
+
+More about one command: `kimal3 project new --help`
+
+## What gets recorded
+
+Only what you enter — title, description, optionally a link. **Your code is not read,
+not uploaded and not analysed.** The tool only writes through the KImal3 app and has
+no database access of its own.
+
+Projects you add are **not public** at first. They appear in your success profile, and you
+decide there what becomes visible.
+
+## Exit codes
+
+For scripts and for Claude itself:
+
+| Value | Meaning | What helps |
+|---|---|---|
+| `0` | it worked | — |
+| `1` | input incomplete, nothing found — or your Claude settings can't be read | read the message, it names the case |
+| `2` | not signed in | `kimal3 login` |
+| `3` | can't be reached right now | try again later |
+| `4` | no Pro account | trying again does **not** help |
+
+The difference between `3` and `4` is deliberate: with `3` a second attempt is worth it,
+with `4` it never is.
+
+## Update notices
+
+If a newer version is available, `kimal3` writes one indented line after the command — at
+most **once a day**:
+
+```
+  →  There's a new version of kimal3.  npm i -g kimal3@latest && kimal3 skill install
+```
+
+It goes to **stderr**, not stdout: `kimal3 company data > company.json` stays clean JSON.
+It **doesn't change the exit code** — a `0` stays a `0`. And `kimal3` **never installs
+anything by itself**; the line shows the command; running it is up to you.
+
+The same goes for the skill files: if the ones in `~/.claude/skills/kimal3/` are older than
+the installed tool, or in a different language from your account, `kimal3` says so — this
+works without an internet connection.
+
+## The daily check — and how to switch it off
+
+`kimal3 skill install` adds a line to your Claude settings (`~/.claude/settings.json`). It
+makes `kimal3 watch` run when Claude starts — silent when nothing is pending; an open task
+(access, version, skill) is reported in every session until it's done. The check looks at
+whether your access is still valid, whether a newer version is available, whether your `/k3`
+commands are out of date and whether there is a message from us.
+
+**It only speaks up when something is really pending.** If everything is in order, it says
+nothing.
+
+If you don't want it:
+
+```
+kimal3 watch off     # silent from now on
+kimal3 watch on      # back on again
+```
+
+After `kimal3 watch off`, **nothing is sent to our server any more** — the check stops before it asks our server anything. Measured: about 0.9 seconds with the check, about 0.19 seconds without, and in
+those 0.19 seconds not a single byte leaves your computer.
+
+The line in the settings stays, so that `kimal3 watch on` takes effect immediately and we
+don't have to touch your settings file again. So a small program of ours still starts, and
+stops again after about 0.19 seconds.
+
+**If you don't want even that**, remove the line yourself: in `~/.claude/settings.json`,
+under `hooks` → `SessionStart`, there is an entry whose command starts with `kimal3 wache` —
+today `kimal3 wache --hook`, in older installations without `--hook`. ⚠️ **The `--hook` part belongs in the settings file, not in the terminal** — all you ever type is
+`kimal3 watch`. Delete this one entry — leave the rest of the file as it is.
+
+## Requirements
+
+Node.js 20 or newer. Nothing else — the tool comes with **no third-party libraries**.
+
+## Licence
+
+Proprietary. Use is permitted for holders of a valid KImal3 Pro account; redistributing, modifying or reusing the code is not permitted.
+
+© KImal3 · https://kimal3.de

package/dist/api.js

@@ -1,10 +1,11 @@
 import { BASIS_URL, leseAnmeldung } from "./anmeldung.js";
 import { hinweisAusAntwort } from "./nachricht.js";
 import { eigeneVersion } from "./version.js";
+import { KONTO_KOPF, SPRACH_KOPF, sprache, uebernimmKontosprache } from "./sprache.js";
 import { findeArbeitsplatz, leseMerkzettelDatei } from "./kontext-dateien.js";
 import { bekannterStandAus, istKopfwertSicher } from "./kontext-stand.js";
 export class NichtAngemeldet extends Error {
-    constructor() { super("nicht angemeldet"); }
+    constructor() { super("nicht angemeldet"); } // kein-anzeigetext: Fehlername, kimal3.ts faengt ihn ab und druckt ihn nie
 }
 /**
  * Der EINE Weg, auf dem diese Datei den lokalen Merkzettel liest -- Firmen-ID
@@ -48,13 +49,13 @@ export class NichtAngemeldet extends Error {
  */
 function lokaleKontextLage() {
     try {
-        const ordner = findeArbeitsplatz(process.cwd());
-        if (ordner === null)
+        const fund = findeArbeitsplatz(process.cwd());
+        if (fund.art !== "gefunden")
             return null;
-        const merkzettel = leseMerkzettelDatei(ordner);
+        const merkzettel = leseMerkzettelDatei(fund.pfad);
         if (merkzettel.firma_id === null)
             return null;
-        return { firmaId: merkzettel.firma_id, stand: bekannterStandAus(merkzettel) };
+        return { firmaId: merkzettel.firma_id, stand: bekannterStandAus(merkzettel, fund.sprache) };
     }
     catch {
         return null;
@@ -106,7 +107,7 @@ export async function ruf(pfad, optionen = {}) {
         const a = leseAnmeldung();
         if (!a)
             throw new NichtAngemeldet();
-        kopf.Authorization = `Bearer ${a.schluessel}`;
+        kopf.Authorization = `Bearer ${a.schluessel}`; // kein-anzeigetext: HTTP-Kopf
     }
     /*
       🔴 DIE CLI SAGT, WER SIE IST -- und nur daran haengt der Server den
@@ -128,6 +129,12 @@ export async function ruf(pfad, optionen = {}) {
     const version = eigeneVersion();
     if (version !== null)
         kopf["X-Kimal3-Version"] = version;
+    /*
+      🌐 Teil 3 (T3-6): Die Sprache, in der dieses Programm gerade spricht, reist bei JEDEM Aufruf
+      mit. Der Server antwortet dann in der Kontosprache -- oder, wenn er den Menschen nicht kennt,
+      in dieser. Fehlt der Kopf (jede aeltere Fassung), antwortet er deutsch wie bisher.
+    */
+    kopf[SPRACH_KOPF] = sprache();
     /*
       🔴 DER ZWEITE KOPF (Task 10) -- der lokal bekannte Firmenstand, damit der
       Server einen firmenbezogenen Hinweis anhaengen kann ("deine Firma hat den
@@ -152,7 +159,7 @@ export async function ruf(pfad, optionen = {}) {
     const kontextKopf = kontextStandKopf();
     if (kontextKopf !== null)
         kopf["X-Kimal3-Kontext-Stand"] = kontextKopf;
-    const methode = optionen.methode ?? "POST";
+    const methode = optionen.methode ?? "POST"; // kein-anzeigetext: HTTP-Methode
     // Content-Type nur, wenn wirklich etwas im Rumpf steht. Ein GET mit
     // "Content-Type: application/json" und ohne Rumpf ist eine Luege ueber die
     // eigene Anfrage — manche Server nehmen das uebel.
@@ -163,6 +170,8 @@ export async function ruf(pfad, optionen = {}) {
         headers: kopf,
         body: methode === "POST" ? JSON.stringify(optionen.koerper ?? {}) : undefined,
     });
+    // 🌐 Nennt die Antwort eine Kontosprache, gilt sie ab sofort (Spec 3.2, Schritt 3).
+    uebernimmKontosprache(antwort.headers.get(KONTO_KOPF));
     const koerper = await antwort.json().catch(() => null);
     merkeHinweis(koerper);
     return { status: antwort.status, koerper };

package/dist/arbeitsplatz-dateien.js

@@ -32,6 +32,9 @@ import { angeboteneFirmen, firmaAusOrdner } from "./firmen-liste.js";
   statt weg-behauptet zu werden.
 */
 import { absage } from "./befehle/kontext-gemeinsam.js";
+import { sprache } from "./sprache.js";
+import { ALLGEMEIN_TEXTE } from "./texte/allgemein.js";
+import { ARBEITSPLATZ_TEXTE } from "./texte/arbeitsplatz.js";
 /*
   🔁 Die Ableitung „welcher Unterordner ist die Werkbank" wohnt seit dem
   2026-08-20 in `werkbank-name.ts` -- gemeinsam mit der App, die sie fuer `/pro`
@@ -95,7 +98,7 @@ export function firmenSuche(wunsch) {
  * - Scheitert die zweite Anfrage mit `409`, sieht er die ERSTE Rückfrage, nicht
  *   eine über einen Namen, den er nie getippt hat (L11).
  */
-export async function vorlageHolen(befehl, wunsch, ordner) {
+export async function vorlageHolen(befehl, optionen, wunsch, ordner) {
     const antwort = await holeVorlage(wunsch);
     if (antwort.status === 200)
         return lesbar(antwort.koerper, false);
@@ -111,7 +114,7 @@ export async function vorlageHolen(befehl, wunsch, ordner) {
         // Netz, Ausweis, Pro: deren eigene Meldung. Nur eine zweite Rückfrage wird
         // durch die erste ersetzt (L11).
         if (zweite.status !== 409)
-            return { ok: false, wert: absage(zweite, befehl) };
+            return { ok: false, wert: absage(zweite, befehl, optionen) };
     }
     /*
       🔴 **Hier standen dieselben vier Zweige noch einmal abgetippt** (402 vor
@@ -124,15 +127,15 @@ export async function vorlageHolen(befehl, wunsch, ordner) {
       *Ein Zweig, den es nie zu sehen gab, fehlt niemandem, bis der Server
       anfängt zu fragen.*
     */
-    return { ok: false, wert: absage(antwort, befehl) };
+    return { ok: false, wert: absage(antwort, befehl, optionen) };
 }
 function holeVorlage(wunsch) {
-    return ruf(`/api/cli/arbeitsplatz${firmenSuche(wunsch)}`, { methode: "GET", mitAusweis: true });
+    return ruf(`/api/cli/arbeitsplatz${firmenSuche(wunsch)}`, { methode: "GET", mitAusweis: true }); // kein-anzeigetext: Pfad der Schnittstelle und HTTP-Verb
 }
 function lesbar(koerper, uebernommen) {
     const daten = alsVorlageAntwort(koerper);
     if (daten === null) {
-        console.error("Die Antwort war nicht lesbar. Bitte gleich noch einmal.");
+        console.error(ALLGEMEIN_TEXTE[sprache()].unreadableAnswer);
         return { ok: false, wert: 3 };
     }
     return { ok: true, daten, uebernommen };
@@ -205,9 +208,10 @@ export function dateienSchreiben(dateien, ordnerName, hinweis) {
     // Dateien -- sonst meldet der Befehl "✓ 0 Dateien angelegt." und legt dabei
     // nicht einmal einen Ordner an. Derselbe Rueckgabewert wie bei anderen
     // unlesbaren Antworten (3): der Nutzer hat hier nichts falsch gemacht.
+    const t = ARBEITSPLATZ_TEXTE[sprache()];
     if (dateien.length === 0) {
-        console.error("Die Antwort enthielt keine einzige Datei -- das ist kein gueltiges Ergebnis.");
-        console.error("Bitte gleich noch einmal versuchen.");
+        console.error(t.noFiles1);
+        console.error(t.noFiles2);
         return 3;
     }
     const ziel = resolve(ordnerName);
@@ -232,8 +236,8 @@ export function dateienSchreiben(dateien, ordnerName, hinweis) {
                   nicht hineinwechseln. Der Rat war in diesem Zweig unausfuehrbar.
                   *Ein Parameter, der zu einem Zweig passt, gehoert nicht in alle drei.*
                 */
-                console.error(`„${ordnerName}" gibt es schon -- als DATEI, nicht als Ordner.`);
-                console.error("Benenn die Datei um oder geh in einen anderen Ordner.");
+                console.error(t.isAFile1(ordnerName));
+                console.error(t.isAFile2);
                 return 1;
             }
             /*
@@ -247,22 +251,22 @@ export function dateienSchreiben(dateien, ordnerName, hinweis) {
               Bewusst eine geschlossene Liste und kein "alles, was mit Punkt anfaengt":
               Eine `.env` oder ein `.git` IST Inhalt, und den fassen wir nicht an.
             */
-            const OS_KRIMSKRAMS = [".DS_Store", "desktop.ini", "Thumbs.db"];
+            const OS_KRIMSKRAMS = [".DS_Store", "desktop.ini", "Thumbs.db"]; // kein-anzeigetext: Dateinamen des Betriebssystems
             const echterInhalt = readdirSync(ziel).filter((n) => !OS_KRIMSKRAMS.includes(n));
             if (echterInhalt.length > 0) {
-                console.error(`Der Ordner „${ordnerName}" gibt es schon und ist nicht leer.`);
-                console.error("Ich fasse ihn nicht an -- so geht nie versehentlich eigene Arbeit verloren.");
+                console.error(t.notEmpty1(ordnerName));
+                console.error(t.notEmpty2);
                 console.error(hinweis);
                 return 1;
             }
         }
     }
     catch (fehler) {
-        console.error(`Ich komme an den Ordner „${ordnerName}" nicht heran.`);
-        console.error(`Grund: ${fehler instanceof Error ? fehler.message : String(fehler)}`);
+        console.error(t.cannotReach1(ordnerName));
+        console.error(t.reason(fehler instanceof Error ? fehler.message : String(fehler)));
         // ⚠️ Ebenfalls OHNE den `hinweis` (Runde 2): Wer den Ordner nicht lesen darf,
         // kann auch nicht hineinwechseln. Hier hilft nur, was schon dasteht.
-        console.error("Das liegt an diesem Rechner, nicht am Server -- Rechte pruefen.");
+        console.error(t.cannotReach2);
         return 1;
     }
     // 🔴 B-6: ALLE Pfade pruefen, BEVOR die erste Datei geschrieben wird. Wuerde
@@ -272,7 +276,7 @@ export function dateienSchreiben(dateien, ordnerName, hinweis) {
     // je erfaehrt, dass der Ordner unvollstaendig ist.
     for (const datei of dateien) {
         if (istUnsichererPfad(datei.pfad)) {
-            console.error(`Die Antwort enthaelt einen unsicheren Pfad: „${datei.pfad}". Bitte melden.`);
+            console.error(t.unsafePath(datei.pfad));
             return 3;
         }
     }
@@ -304,9 +308,9 @@ export function dateienSchreiben(dateien, ordnerName, hinweis) {
           `readdirSync`-catch. *Ein Fehler, der einmal verstanden und
           aufgeschrieben wurde, ist im Nachbar-catch trotzdem wieder neu.*
         */
-        console.error(`Schreiben fehlgeschlagen: ${fehler instanceof Error ? fehler.message : String(fehler)}`);
-        console.error(`Der Ordner „${ordnerName}" ist dadurch UNVOLLSTAENDIG -- er darf geloescht werden.`);
-        console.error("Das liegt an diesem Rechner, nicht am Server -- Platz und Rechte pruefen.");
+        console.error(t.writeFailed(fehler instanceof Error ? fehler.message : String(fehler)));
+        console.error(t.incomplete(ordnerName));
+        console.error(t.writeFailedBlame);
         return 1;
     }
     return 0;

package/dist/argumente.js

@@ -6,6 +6,12 @@
  * Uebergehen. Wer `--titl` tippt, soll es erfahren, statt ein Projekt ohne
  * Titel anzulegen.
  */
+import { SCHALTER_EN, deutscherSchalter } from "./befehlswoerter.js";
+import { ALLGEMEIN_TEXTE } from "./texte/allgemein.js";
+// `alsWort` wohnt seit Teil 3 in `wort.ts` (importfrei, die App liest es). Hier weiter
+// erreichbar, damit kein Aufrufer im Programm umziehen muss.
+import { alsWort } from "./wort.js";
+export { alsWort };
 /**
  * Trennt die **vorderen Woerter** von den Optionen.
  *
@@ -65,98 +71,8 @@ export function alsBefehlszeile(optionen) {
     */
     return optionen.map((teil) => alsWort(teil)).join(" ");
 }
-/**
- * EIN Wort so in eine Befehlszeile setzen, dass es beim Kopieren wieder genau
- * dieses Wort ergibt.
- *
- * 🔴 **Gegen Befund 4 der zweiten Review-Runde (2026-08-27).** An NEUN Stellen
- * stand dieselbe Zeile — `wert.includes(" ") ? `"${wert}"` : wert` — und alle
- * neun hatten dieselbe Lücke: Ein Wert, der selbst ein Anführungszeichen
- * enthält, sprengt die Anführungszeichen, die man um ihn herum setzt.
- *
- * Der Fall: `kimal3 arbeitsplatz neu sabine --firma 'Blume "Nord" GmbH'`. Der
- * angebotene Rat lautete danach `--firma "Blume "Nord" GmbH"`. Wer ihn
- * kopiert, gibt seiner Kommandozeile **drei** Wörter statt einem und bekommt
- * eine andere, verwirrendere Absage als die, die er gerade gelesen hat.
- * *Ein Rat, der beim Kopieren zerfällt, ist ein Rat in eine zweite Absage* —
- * genau die Lehre, gegen die `alsBefehlszeile` oben gebaut wurde.
- *
- * 🔑 **Warum einfache Anführungszeichen und keine Maskierung mit `\`:**
- * `'…'` bedeutet in beiden Kommandozeilen dasselbe, die auf den Rechnern
- * unserer Kunden laufen — in der von Mac/Linux (`sh`) wie in der von Windows
- * (PowerShell). Eine Maskierung mit `\"` gilt nur in der ersten; in
- * PowerShell müsste man das Zeichen verdoppeln. *Eine Bauform, die nur auf
- * einem der beiden Rechner hält, ist in einem Produkt für beide keine
- * Bauform.*
- *
- * 🔑 **`immer` heisst „setz die Anfuehrungszeichen auch dann, wenn es ohne
- * ginge".** Die Zeilen unter „Deine Firmen:" haben sie seit jeher, und dort
- * gehoeren sie hin: Sie sind zum Kopieren UND zum Weitertippen gedacht -- wer
- * „Suedwind" durch „Blume & Co" ersetzt, hat die Anfuehrungszeichen dann schon
- * stehen. Beim Zusammenbauen einer getippten Zeile (`alsBefehlszeile`) und
- * beim `cd` waere das umgekehrt eine Aenderung an dem, was der Kunde bisher
- * sieht -- deshalb dort die Vorgabe `false`.
- *
- * ⚠️ **Die eine Lage, die offen bleibt:** ein Wert mit BEIDEN Sorten
- * Anführungszeichen. Dafür gibt es keine Schreibweise, die in beiden
- * Kommandozeilen dasselbe heißt. Der Rückfall maskiert nach `sh`-Regeln — und
- * für genau diesen Fall gibt es ohnehin `--firma-id`, das ohne jedes
- * Sonderzeichen auskommt.
- */
-export function alsWort(wert, immer = false) {
-    if (wert === "")
-        return '""';
-    /*
-      Was eine Kommandozeile nicht wörtlich stehen lässt: Leerzeichen (trennen),
-      Anführungszeichen beider Sorten (zitieren) -- und `$` wie ````
-      (rechnen).
-  
-      ⚠️ Der Rückwärtsstrich ist bewusst NICHT dabei: In einem Firmennamen
-      kommt er nicht vor, und ihn mitzunehmen hieße, ihn auch maskieren zu
-      müssen -- was in PowerShell wieder falsch wäre.
-    */
-    /*
-      🔴 **EINE ERLAUBNISLISTE, KEINE VERBOTSLISTE** (Befund 1 der FÜNFTEN
-      Review-Runde, 2026-08-27) -- und die Verbotsliste hatte drei Runden
-      gebraucht, um dreimal zu lecken: erst fehlten die Anführungszeichen, dann
-      `$` und das Akzent-Zeichen, dann `&`, `;`, `|`, Klammern, `<`, `>`.
-  
-      Der Fall, der es aufgedeckt hat: eine Firma namens `Blume&Co` -- **ohne**
-      Leerzeichen, also fiel sie durch jede Prüfung. Die angebotene Zeile hieß
-      `--firma Blume&Co`; in PowerShell ist das ein Syntaxfehler, in `sh`
-      startet es `--firma Blume` im Hintergrund und führt danach `Co` aus.
-  
-      🔑 *Eine Liste dessen, was gefährlich ist, ist immer unvollständig -- die
-      Liste dessen, was harmlos ist, kann man zu Ende schreiben.* Also
-      umgekehrt: Buchstaben (auch Umlaute), Ziffern und eine Handvoll
-      unverfänglicher Satzzeichen bleiben unangetastet, **alles andere wird
-      zitiert**. Ein Anführungszeichen zu viel ist folgenlos; eines zu wenig
-      hat jetzt dreimal einen Rat zerlegt.
-    */
-    if (!immer && /^[A-Za-z0-9À-ÿ._\/@:+-]+$/.test(wert))
-        return wert;
-    /*
-      🔴 **`$` UND ```` MÜSSEN AUS DEN DOPPELTEN ANFÜHRUNGSZEICHEN HERAUS**
-      (Befund 4 der dritten Review-Runde, 2026-08-27). Doppelte Anführungszeichen
-      halten Leerzeichen zusammen, aber sie schützen NICHT vor dem Rechnen: Eine
-      Firma namens `Cash$$ GmbH` ergab die Zeile
-      `--firma "Cash$$ GmbH"`, und `$$` ist in `sh` die Nummer des laufenden
-      Programms. Der Kunde kopiert den angebotenen Befehl und liest danach
-      *„Zu ‚Cash1234 GmbH' gehörst du nicht."* -- wieder ein Rat, der beim
-      Kopieren zerfällt, nur eine Stufe subtiler als der Fall, gegen den diese
-      Funktion gebaut wurde.
-  
-      Deshalb: doppelte Anführungszeichen nur, wenn wirklich nichts Rechnendes
-      drinsteht. Sonst die einfachen, die in beiden Kommandozeilen alles wörtlich
-      nehmen.
-    */
-    if (!/["$\`]/.test(wert))
-        return `"${wert}"`;
-    if (!wert.includes("'"))
-        return `'${wert}'`;
-    return `"${wert.replace(/(["$\`])/g, "\\$1")}"`;
-}
-export function zerlege(argv, erlaubt) {
+export function zerlege(argv, erlaubt, sprache) {
+    const t = ALLGEMEIN_TEXTE[sprache];
     const optionen = {};
     for (let i = 0; i < argv.length; i++) {
         const teil = argv[i];
@@ -167,13 +83,17 @@ export function zerlege(argv, erlaubt) {
         if (!teil.startsWith("--")) {
             return {
                 ok: false,
-                meldung: `Mit „${teil}" kann ich hier nichts anfangen. Erwartet werden nur Optionen wie „--name wert".`,
+                meldung: t.cannotUseWord(teil),
             };
         }
         const gleich = teil.indexOf("=");
-        const name = gleich === -1 ? teil.slice(2) : teil.slice(2, gleich);
+        // 🌐 Teil 3 (T3-4): `getippt` steht in jeder Meldung (der Mensch soll sein eigenes Wort
+        // wiedererkennen), `name` ist der deutsche Name, unter dem der Wert abgelegt wird und zum
+        // Server geht. Doppelt ist doppelt, egal in welcher Sprache (`--firma A --company B`, L-16).
+        const getippt = gleich === -1 ? teil.slice(2) : teil.slice(2, gleich);
+        const name = deutscherSchalter(getippt);
         if (!erlaubt.includes(name)) {
-            return { ok: false, meldung: `Die Option „--${name}" kenne ich nicht.` };
+            return { ok: false, meldung: t.unknownOption(getippt) };
         }
         // ⚠️ **Dieselbe Option zweimal ist ein FEHLER** (QA-Befund B-3, 2026-08-18).
         //
@@ -198,7 +118,7 @@ export function zerlege(argv, erlaubt) {
         if (Object.hasOwn(optionen, name)) {
             return {
                 ok: false,
-                meldung: `Die Option „--${name}" steht zweimal da. Bitte nenne sie nur einmal.`,
+                meldung: t.duplicateOption(getippt),
             };
         }
         if (gleich !== -1) {
@@ -208,10 +128,18 @@ export function zerlege(argv, erlaubt) {
         const wert = argv[i + 1];
         // Eine Zahl mit Minus ist ein Wert; "--irgendwas" ist die naechste Option.
         if (wert === undefined || wert.startsWith("--")) {
-            return { ok: false, meldung: `Der Option „--${name}" fehlt ihr Wert.` };
+            return { ok: false, meldung: t.missingValue(getippt) };
         }
         optionen[name] = wert;
         i++;
     }
     return { ok: true, werte: { optionen } };
 }
+/**
+ * Ein Schalter OHNE Wert (`--ueberschreiben`, `--ohne-firma`) in beiden Sprachen: gesetzt? -- und
+ * `argv` ohne ihn, fuer `zerlege`, das nur Schalter MIT Wert kennt.
+ */
+export function schalterOhneWert(argv, deutsch) {
+    const namen = [deutsch, ...Object.keys(SCHALTER_EN).filter((e) => SCHALTER_EN[e] === deutsch)].map((n) => `--${n}`);
+    return { gesetzt: argv.some((a) => namen.includes(a)), rest: argv.filter((a) => !namen.includes(a)) };
+}