kimal3 0.2.10 → 0.3.0

package/dist/befehle/kontext-gemeinsam.js

@@ -1,8 +1,13 @@
 import { feld } from "../api.js";
 import { alsWort } from "../argumente.js";
 import { schlussFehler } from "../fehler.js";
+import { befehlIn, schalterIn } from "../befehlswoerter.js";
+import { sprache } from "../sprache.js";
+import { ALLGEMEIN_TEXTE } from "../texte/allgemein.js";
+import { KONTEXT_TEXTE } from "../texte/kontext.js";
 import { BASIS_URL } from "../anmeldung.js";
 import { findeArbeitsplatz } from "../kontext-dateien.js";
+import { ORDNER_NAMEN } from "../kontext-stand.js";
 import { angeboteneFirmen } from "../firmen-liste.js";
 /**
  * Was `kontext runter` (`kontext-runter.ts`) und `kontext hoch`
@@ -36,28 +41,56 @@ import { angeboteneFirmen } from "../firmen-liste.js";
  * stderr, der Aufrufer gibt nur noch `1` zurueck.
  */
 export function arbeitsplatzOderAbsage() {
-    const ordner = findeArbeitsplatz(process.cwd());
-    if (ordner !== null)
-        return ordner;
-    /*
-      🔴 **ECHTE UMLAUTE** -- dieselbe Begruendung wie bei `fremdeDateiAbsage`
-      zwanzig Zeilen tiefer und in `kontext-fragen.ts:26`: Das hier liest ein
-      Kunde im Terminal. Bis Review-Runde 4 stand hier die ASCII-Umschrift,
-      waehrend die Schwesterfunktion in DERSELBEN Datei Umlaute setzte und es im
-      Kommentar begruendete -- eine Datei, zwei Schreibweisen.
-  
-      ⚠️ Der Umlaut-Fix an `kontext-hoch.ts` (Runde 3) hat diesen Zwilling
-      stehen lassen, und die Wache schlug nicht an: Sie prueft den zitierten
-      Ausschnitt „Hier steht kein KI-Arbeitsplatz", und der traegt zufaellig
-      keinen Umlaut. *Eine Wache deckt den Satz, den sie kennt -- nicht die
-      Regel dahinter.*
-    */
-    console.error("Hier steht kein KI-Arbeitsplatz — ich suche von hier aufwärts nach einem");
-    console.error("Ordner, der `kontext/` UND `CLAUDE.md` enthält.");
-    console.error("");
-    console.error("  Wechsle in deinen Arbeitsplatz-Ordner und versuch es dort noch einmal.");
+    const fund = findeArbeitsplatz(process.cwd());
+    if (fund.art === "gefunden")
+        return { pfad: fund.pfad, sprache: fund.sprache };
+    arbeitsplatzAbsageZeilen(fund, sprache()).forEach((z) => console.error(z));
     return null;
 }
+/**
+ * Die Zeilen der Absage, wenn kein (eindeutiger) Arbeitsplatz da ist -- als reine Rechnung mit der
+ * Sprache als Pflichtwert, damit `check:cli` beide Sprachen misst (Teil 3, Task 10).
+ *
+ * 🔴 **ECHTE UMLAUTE** -- dieselbe Begruendung wie bei `fremdeDateiAbsage`
+ * weiter unten und in `kontext-fragen.ts`: Das hier liest ein Kunde im
+ * Terminal. Bis Review-Runde 4 stand hier die ASCII-Umschrift, waehrend die
+ * Schwesterfunktion in DERSELBEN Datei Umlaute setzte -- eine Datei, zwei
+ * Schreibweisen. ⚠️ Der Umlaut-Fix an `kontext-hoch.ts` (Runde 3) hat diesen
+ * Zwilling stehen lassen, und die Wache schlug nicht an: Sie prueft den
+ * zitierten Ausschnitt „Hier steht kein KI-Arbeitsplatz", und der traegt
+ * zufaellig keinen Umlaut. *Eine Wache deckt den Satz, den sie kennt -- nicht
+ * die Regel dahinter.*
+ */
+export function arbeitsplatzAbsageZeilen(fund, s) {
+    const t = KONTEXT_TEXTE[s];
+    // Spec 3.2: zwei Namen nebeneinander -- melden, nicht still einen waehlen, und nichts schreiben.
+    if (fund.art === "beide")
+        return [t.bothFolders1(fund.pfad), t.bothFolders2, "", t.bothFolders3];
+    return [t.noWorkplace1, t.noWorkplace2, "", t.noWorkplace3];
+}
+/**
+ * US-13: Der Ordner hat die alte Sprache, die Firma inzwischen eine andere.
+ * Nichts schreiben (sonst stuenden zwei Sprachen nebeneinander), den Weg nennen.
+ * ⚠️ ECHTE UMLAUTE -- das liest ein Kunde.
+ * `firmenname` (aus der Antwort des Servers) kommt als `--firma "…"` in den Rat, damit
+ * `arbeitsplatz neu` bei mehreren Firmen nicht gleich zurueckfragt (Final-Review, Fund 3);
+ * `null` (aelterer Server ohne Namen) -> der Rat ohne `--firma`, wie bisher.
+ */
+export function fremdeSpracheAbsage(ordner, firma, firmenname) {
+    fremdeSpracheZeilen(ordner, firma, firmenname, sprache()).forEach((z) => console.error(z));
+}
+/** Die Zeilen von `fremdeSpracheAbsage` -- rein, Sprache des Menschen als Pflichtwert (`check:cli`). */
+export function fremdeSpracheZeilen(ordner, firma, firmenname, s) {
+    const t = KONTEXT_TEXTE[s];
+    return [
+        t.languageChanged1(firma, ordner, ORDNER_NAMEN[ordner].kontext),
+        t.languageChanged2,
+        "",
+        t.languageChanged3,
+        t.languageChangedCommand(befehlIn("arbeitsplatz neu", s), schalterIn("firma", s), firmenname === null ? null : alsWort(firmenname, true)), // kein-anzeigetext: Befehlsschlüssel
+        t.languageChanged4,
+    ];
+}
 /**
  * Was ein Mensch liest, wenn eine der fuenf Dateien keine einzige ihrer Fragen
  * mehr traegt -- **woertlich dieselben Zeilen fuer `kontext hoch` und
@@ -66,7 +99,7 @@ export function arbeitsplatzOderAbsage() {
  * 🔴 **WARUM SIE GETEILT WIRD.** `kontext fragen` zaehlte eine solche Datei
  * vorher stillschweigend mit NULL Fragen und liess sie aus beiden Summen
  * fallen. Gemessen mit der ausgelieferten `README.md` als `kontext/marke.md`:
- * „12 von 12 Fragen" statt 17, „Die Marke" nirgends genannt -- und nach zwoelf
+ * „12 von 12 Fragen" statt der vollen Zahl, „Die Marke" nirgends genannt -- und nach zwoelf
  * Antworten meldete der Befehl `✓ Alle 12 Fragen … sind beantwortet`, waehrend
  * `kontext hoch` einen Schritt spaeter auf genau dieser Datei abbrach.
  * *Der lesende Befehl gab die beruhigende Auskunft, der schreibende
@@ -83,10 +116,13 @@ export function arbeitsplatzOderAbsage() {
  * 🔑 ECHTE UMLAUTE -- das hier liest ein Kunde im Terminal. Die ASCII-Umschrift
  * dieses Ordners gilt nur fuer Kommentare.
  */
-export function fremdeDateiAbsage(pfad, titel, ankerPraefix, folge) {
-    console.error(`„${pfad}" sieht nicht aus wie „${titel}". ${folge}`);
-    console.error(`  Ich finde darin keine einzige Frage dieser Datei (Zeilen wie \`<!-- k3:${ankerPraefix}… -->\`).`);
-    console.error("  Hol sie mit `kimal3 kontext runter` zurück und trag deine Antworten dort ein.");
+export function fremdeDateiAbsage(pfad, feld, ankerPraefix, folge) {
+    fremdeDateiZeilen(pfad, feld, ankerPraefix, folge, sprache()).forEach((z) => console.error(z));
+}
+/** Die Zeilen von `fremdeDateiAbsage` -- rein, Sprache des Menschen als Pflichtwert (`check:cli`). */
+export function fremdeDateiZeilen(pfad, feld, ankerPraefix, folge, s) {
+    const t = KONTEXT_TEXTE[s];
+    return [t.fileNotLike(pfad, t.dateiTitel[feld], folge), t.noQuestionFound(ankerPraefix), t.fetchItBack];
 }
 /** `--firma`/`--firma-id` -- die einzigen Optionen, die beide Richtungen kennen. */
 export const ERLAUBT = ["firma", "firma-id"];
@@ -111,19 +147,23 @@ export const ERLAUBT = ["firma", "firma-id"];
  * den Ausweg (`--ueberschreiben`) -- sie kommt woertlich vom Server und wird
  * hier nur ausgegeben, nicht neu formuliert.
  */
-export function absage(antwort, befehl) {
-    const meldung = feld(antwort.koerper, "meldung") ?? "Das hat nicht geklappt.";
+export function absage(antwort, befehl, optionen) {
+    const s = sprache();
+    const t = ALLGEMEIN_TEXTE[s];
+    const meldung = feld(antwort.koerper, "meldung") ?? t.genericFailure;
     if (antwort.status === 402) {
         console.error(meldung);
         return 4;
     }
     if (antwort.status === 401) {
-        console.error(`${meldung} Bitte \`kimal3 login\` ausführen.`);
+        console.error(`${meldung}${t.pleaseSignIn}`);
         return 2;
     }
     if (antwort.status === 409) {
         const grund = feld(antwort.koerper, "grund");
-        if (grund === "veraltet") {
+        // Teil 2: `update-noetig` und `sprache-anders` (Task 14) kommen wie `veraltet` als fertiger
+        // Satz in der Kontosprache -- keine Firmenliste darunter, die mit der Lage nichts zu tun hat.
+        if (grund === "veraltet" || grund === "update-noetig" || grund === "sprache-anders") {
             console.error(meldung);
             return 1;
         }
@@ -137,22 +177,22 @@ export function absage(antwort, befehl) {
                 typeof x.name === "string")
             : [];
         if (auswahl.length > 0) {
-            console.error("\n  Diese beiden heissen gleich — nimm die ID:");
-            firmenIdZeilenKontext(auswahl, befehl).forEach((z) => console.error(z));
+            console.error(t.sameNameUseId);
+            firmenIdZeilenKontext(auswahl, befehl, optionen, s).forEach((z) => console.error(z));
         }
         else {
-            const zeilen = firmenZeilenKontext(namen, befehl);
+            const zeilen = firmenZeilenKontext(namen, befehl, optionen, s);
             if (zeilen.length > 0) {
-                console.error("\n  Deine Firmen:");
+                console.error(t.yourCompanies);
                 zeilen.forEach((z) => console.error(z));
             }
         }
         if (grund === "keine-firma") {
-            console.error(`\n  Eine Firma anlegen: ${BASIS_URL}/firma/neu`);
+            console.error(t.createCompany(BASIS_URL));
         }
         return 1;
     }
-    const schluss = schlussFehler(antwort.status, meldung);
+    const schluss = schlussFehler(antwort.status, meldung, s);
     console.error(schluss.text);
     return schluss.wert;
 }
@@ -160,7 +200,10 @@ export function absage(antwort, befehl) {
  * `firmenZeilen` aus `firmen-liste.ts`, nur mit dem richtigen Befehl in der
  * Zeile -- s. Kommentar an `absage`.
  */
-function firmenZeilenKontext(namen, befehl) {
+export function firmenZeilenKontext(namen, befehl, optionen, s) {
+    const t = ALLGEMEIN_TEXTE[s];
+    // Befehl, schon getippte Optionen, dann der Firmen-Schalter -- in der Sprache des Satzes.
+    const vorne = `${befehlIn(befehl, s)}${optionen}`;
     const anzahl = (name) => namen.filter((n) => n === name).length;
     const gesehen = new Set();
     const zeilen = [];
@@ -170,15 +213,16 @@ function firmenZeilenKontext(namen, befehl) {
         gesehen.add(name);
         const wieOft = anzahl(name);
         if (wieOft === 1) {
-            zeilen.push(`    kimal3 ${befehl} --firma ${alsWort(name, true)}`);
+            zeilen.push(t.companyLine(vorne, schalterIn("firma", s), alsWort(name, true)));
         }
         else {
-            zeilen.push(`    „${name}" — kommt ${wieOft}× vor und ist über den Namen nicht wählbar.`);
+            zeilen.push(t.nameNotUnique(name, wieOft));
         }
     }
     return zeilen;
 }
 /** `firmenIdZeilen` aus `firmen-liste.ts`, nur mit dem richtigen Befehl. */
-function firmenIdZeilenKontext(auswahl, befehl) {
-    return auswahl.map((f, i) => `    kimal3 ${befehl} --firma-id "${f.id}"   # ${f.name} (${i + 1}.)`);
+export function firmenIdZeilenKontext(auswahl, befehl, optionen, s) {
+    const vorne = `${befehlIn(befehl, s)}${optionen}`;
+    return auswahl.map((f, i) => ALLGEMEIN_TEXTE[s].companyIdLine(vorne, schalterIn("firma-id", s), f.id, f.name, i + 1));
 }

package/dist/befehle/kontext-hoch.js

@@ -1,6 +1,9 @@
-import { zerlege } from "../argumente.js";
+import { schalterOhneWert, zerlege } from "../argumente.js";
+import { sprache } from "../sprache.js";
+import { ALLGEMEIN_TEXTE } from "../texte/allgemein.js";
+import { KONTEXT_HOCH_TEXTE } from "../texte/kontext-hoch.js";
 import { ruf } from "../api.js";
-import { FIRMEN_TEXTE, alsMerkzettel, bekannterStandAus, merkzettelNachHoch, } from "../kontext-stand.js";
+import { firmenTexte, alsMerkzettel, bekannterStandAus, merkzettelNachHoch, } from "../kontext-stand.js";
 import { traegtFragenVon } from "../fragen-lesen.js";
 import { leseEineDatei, leseMerkzettelDatei, schreibeMerkzettelDatei } from "../kontext-dateien.js";
 import { ERLAUBT, absage, arbeitsplatzOderAbsage, fremdeDateiAbsage } from "./kontext-gemeinsam.js";
@@ -12,7 +15,7 @@ import { hochZeile } from "../kontext-hoch-zeile.js";
   `marke_md`). Fuer vier der fuenf Dateien war das richtig; die fuenfte,
   `kontext/kurzprofil.md`, fuellt `drei_saetze` und haette daraus `kurzprofil_md`
   bekommen -- ein Feld, das die Route nicht kennt. Die Zuordnung steht jetzt als
-  Tabelle in `FIRMEN_TEXTE` (`../kontext-stand.js`), und dass sie mit `FELDER`
+  Tabelle in `firmenTexte` (`../kontext-stand.js`), und dass sie mit `FELDER`
   in der App uebereinstimmt, prueft `check:kontext`.
 */
 // 📌 `bekannterStandAus` wohnte hier (Fix-Runde 1, Review-Fund 1) und ist seit
@@ -21,25 +24,10 @@ import { hochZeile } from "../kontext-hoch-zeile.js";
 // von HIER haette `api.ts` in einen Kreisimport mit sich selbst gezwungen
 // (diese Datei importiert `ruf` aus `../api.js`). Die volle Begruendung der
 // Rechnung selbst steht jetzt dort.
-const HILFE_HOCH = `
-  kimal3 kontext hoch [--firma "Name" | --firma-id "…"] [--ueberschreiben]
-
-  Schickt deine lokalen Aenderungen an allen fuenf Firmen-Texten nach oben --
-  fuer den Firmen-Admin. Nur wer Admin ist, darf das; die App entscheidet.
-
-  Die fuenf sind die Dateien in kontext/: kurzprofil.md, firma.md, marke.md,
-  systeme.md, sicherheit.md.
-
-  Welche Fragen darin noch offen sind, zeigt "kimal3 kontext fragen".
-
-  --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.
-
-  --ueberschreiben      Speichert auch dann, wenn die Firma inzwischen von
-                        jemand anderem geaendert wurde (§7d).
-`;
+/** Die Hilfe von `kontext hoch` / `context upload` in der Sprache des Menschen. */
+export function hilfe(s) {
+    return KONTEXT_HOCH_TEXTE[s].uploadHelp;
+}
 /**
  * Schickt die fuenf Firmen-Texte des gefundenen Arbeitsplatzes nach oben --
  * die Gegenrichtung zu `kontextRunter` (`kontext-runter.ts`). Fundregel,
@@ -58,20 +46,21 @@ const HILFE_HOCH = `
  * 🔴 **Importiert bewusst KEIN `FELDER` aus `src/app/firma/kontext-felder.ts`.**
  * `cli/src/` ist ein eigenes Paket mit eigenem `tsconfig` und darf nichts aus
  * `src/` importieren (s. Kopf von `kontext-stand.ts`). Welche Datei welches
- * Feld fuellt, steht deshalb in `FIRMEN_TEXTE` -- und dass diese Tabelle mit
+ * Feld fuellt, steht deshalb in `firmenTexte` -- und dass diese Tabelle mit
  * `FELDER` uebereinstimmt, ist eine Pruefung in `check:kontext`.
  */
 export async function kontextHoch(argv) {
+    let s = sprache();
+    let t = KONTEXT_HOCH_TEXTE[s];
     if (argv.includes("--help") || argv.includes("-h")) {
-        console.log(HILFE_HOCH);
+        console.log(hilfe(s));
         return 0;
     }
-    const ueberschreiben = argv.includes("--ueberschreiben");
-    // ⚠️ `zerlege` kennt keine Optionen ohne Wert -- `--ueberschreiben` wird
-    // deshalb VOR der Zerlegung herausgefiltert, genau wie `--help`/`-h` oben
+    // ⚠️ `zerlege` kennt keine Optionen ohne Wert -- `--ueberschreiben` (englisch `--overwrite`)
+    // wird deshalb VOR der Zerlegung herausgefiltert, genau wie `--help`/`-h` oben
     // nie an `zerlege` gereicht werden.
-    const ohneFlag = argv.filter((a) => a !== "--ueberschreiben");
-    const zerlegt = zerlege(ohneFlag, ERLAUBT);
+    const { gesetzt: ueberschreiben, rest: ohneFlag } = schalterOhneWert(argv, "ueberschreiben");
+    const zerlegt = zerlege(ohneFlag, ERLAUBT, s);
     if (!zerlegt.ok) {
         console.error(zerlegt.meldung);
         return 1;
@@ -83,8 +72,8 @@ export async function kontextHoch(argv) {
     // (`bekannterStandAus`), nicht nur aus den Dateien, die gleich gelesen
     // werden. Die Firmenzeile traegt genau EIN `geaendert_am` fuer alle fuenf
     // Felder -- jeder nicht-leere Eintrag kennt es also, auch der der `CLAUDE.md`.
-    const lokalerMerkzettel = leseMerkzettelDatei(ordner);
-    const bekannterStand = bekannterStandAus(lokalerMerkzettel);
+    const lokalerMerkzettel = leseMerkzettelDatei(ordner.pfad);
+    const bekannterStand = bekannterStandAus(lokalerMerkzettel, ordner.sprache);
     /*
       ---- die fuenf Texte lesen ---------------------------------------------
   
@@ -95,15 +84,15 @@ export async function kontextHoch(argv) {
       benennen kann, ist teurer als ein Abbruch, der klar sagt, warum.*
     */
     const werte = {};
-    for (const datei of FIRMEN_TEXTE) {
-        const gelesen = leseEineDatei(ordner, datei.pfad);
+    for (const datei of firmenTexte(ordner.sprache)) {
+        const gelesen = leseEineDatei(ordner.pfad, datei.pfad);
         if (!gelesen.ok) {
             console.error(gelesen.meldung);
             return 1;
         }
         if (gelesen.inhalt === null) {
-            console.error(`„${datei.pfad}" gibt es hier nicht -- ich schicke nichts Halbes hoch.`);
-            console.error("  Erst `kimal3 kontext runter` ausfuehren, dann bearbeiten, dann noch einmal.");
+            console.error(t.uploadFileMissing(datei.pfad));
+            console.error(t.uploadFetchFirst);
             return 1;
         }
         /*
@@ -121,7 +110,7 @@ export async function kontextHoch(argv) {
           angelegt hat, weil `kontext runter` noch nie lief.
         */
         if (!traegtFragenVon(gelesen.inhalt, datei.ankerPraefix)) {
-            fremdeDateiAbsage(datei.pfad, datei.titel, datei.ankerPraefix, "Nichts wurde gespeichert.");
+            fremdeDateiAbsage(datei.pfad, datei.feld, datei.ankerPraefix, t.nothingSaved);
             return 1;
         }
         werte[datei.feld] = gelesen.inhalt;
@@ -134,23 +123,28 @@ export async function kontextHoch(argv) {
         suche.set("firma", wunsch);
     if (wunschId !== undefined)
         suche.set("firma-id", wunschId);
-    const pfad = suche.toString() ? `/api/cli/kontext?${suche.toString()}` : "/api/cli/kontext";
-    const koerper = { stand: bekannterStand, ...werte };
+    const pfad = suche.toString() ? `/api/cli/kontext?${suche.toString()}` : "/api/cli/kontext"; // kein-anzeigetext: Pfad der Schnittstelle
+    // 🌐 Teil 2: Die Sprache des ORDNERS geht mit. Der Server haelt sie gegen die Firmensprache und
+    // sagt `sprache-anders` (409), statt deutsche Texte in eine englische Firma zu schreiben (US-13).
+    const koerper = { stand: bekannterStand, ...werte, sprache: ordner.sprache };
     if (ueberschreiben)
         koerper.ueberschreiben = true;
-    const antwort = await ruf(pfad, { methode: "POST", mitAusweis: true, koerper });
+    const antwort = await ruf(pfad, { methode: "POST", mitAusweis: true, koerper }); // kein-anzeigetext: HTTP-Verb
+    // 🌐 Die Antwort kann die Kontosprache umgestellt haben (Spec 3.2, Schritt 3): Was ab hier gedruckt wird, in der neuen.
+    s = sprache();
+    t = KONTEXT_HOCH_TEXTE[s];
     if (antwort.status !== 200) {
-        return absage(antwort, "kontext hoch");
+        return absage(antwort, "kontext hoch", ""); // kein-anzeigetext: Befehlsschlüssel
     }
     // 🔴 Ein `200` mit unlesbarem Rumpf ist KEIN Erfolg -- dasselbe Muster wie
     // in `kontextRunter` und in `firma-daten.ts`.
     if (antwort.koerper === null || typeof antwort.koerper !== "object") {
-        console.error("Die Antwort war nicht lesbar. Bitte gleich noch einmal.");
+        console.error(ALLGEMEIN_TEXTE[s].unreadableAnswer);
         return 3;
     }
     const ergebnis = alsHochAntwort(antwort.koerper);
     if (ergebnis === null) {
-        console.error("Die Antwort war nicht lesbar. Bitte gleich noch einmal.");
+        console.error(ALLGEMEIN_TEXTE[s].unreadableAnswer);
         return 3;
     }
     /*
@@ -173,7 +167,7 @@ export async function kontextHoch(argv) {
       CLAUDE.md" und riete zu `kontext hoch` -- dem Befehl, der sie gar nicht
       mitnimmt. Gemessen auf der Kundenstrecke am 2026-08-25.
     */
-    const zuSchreiben = merkzettelNachHoch(ergebnis.merkzettel, lokalerMerkzettel, FIRMEN_TEXTE.map((d) => d.pfad));
+    const zuSchreiben = merkzettelNachHoch(ergebnis.merkzettel, lokalerMerkzettel, firmenTexte(ordner.sprache).map((d) => d.pfad), ordner.sprache);
     /*
       🔴 **DIE ERFOLGSMELDUNG STEHT VOR DEM MERKZETTEL** (Review-Runde 4).
   
@@ -186,8 +180,8 @@ export async function kontextHoch(argv) {
       was daneben schiefging. Was hochgeschickt wurde, haengt nicht daran, ob ein
       Merkzettel auf der Platte landet.
     */
-    console.log(hochZeile(ergebnis.uebernommen));
-    const merkzettelSchreiben = schreibeMerkzettelDatei(ordner, zuSchreiben);
+    console.log(hochZeile(ergebnis.uebernommen, s));
+    const merkzettelSchreiben = schreibeMerkzettelDatei(ordner.pfad, zuSchreiben);
     if (!merkzettelSchreiben.ok) {
         /*
           🔴 **ECHTE UMLAUTE -- das liest ein Kunde im Terminal** (Projektregel,
@@ -209,7 +203,7 @@ export async function kontextHoch(argv) {
           verteilt und ist durch eine `includes`-Pruefung ohnehin nicht erfassbar.
           *Wer den Satz hier aendert, aendert ihn dort von Hand mit.*
         */
-        console.error("Die Firma hat deine Änderungen gespeichert — nur der lokale Merkzettel ließ sich nicht schreiben:");
+        console.error(t.savedButTracking);
         console.error(merkzettelSchreiben.meldung);
         // B-d (Dennis, 17.09.): Das ist ein ERFOLG -- die Firma hat gespeichert.
         // Der Rueckgabewert ist fuer Maschinen da, und fuer die ist "gespeichert"

package/dist/befehle/kontext-runter.js

@@ -1,10 +1,14 @@
 import { zerlege } from "../argumente.js";
+import { sprache } from "../sprache.js";
+import { ALLGEMEIN_TEXTE } from "../texte/allgemein.js";
+import { KONTEXT_TEXTE } from "../texte/kontext.js";
+import { ratNachUnberuehrt } from "../kontext-rat.js";
 import { ruf } from "../api.js";
 import { heuteAus } from "../nachricht.js";
 import { istUnsichererPfad } from "../arbeitsplatz-dateien.js";
-import { LEER, VERWALTETE_DATEIEN, alsMerkzettel, sicherungsOrdner, sicherungsZiel, lageAusMerkzetteln, ratNachUnberuehrt, } from "../kontext-stand.js";
+import { LEER, verwalteteDateien, alsMerkzettel, sicherungsOrdner, sicherungsZiel, lageAusMerkzetteln, } from "../kontext-stand.js";
 import { leseEineDatei, leseMerkzettelDatei, schreibeMerkzettelDatei, schreibeVerwalteteDatei, sichereDatei, } from "../kontext-dateien.js";
-import { ERLAUBT, absage, arbeitsplatzOderAbsage } from "./kontext-gemeinsam.js";
+import { ERLAUBT, absage, arbeitsplatzOderAbsage, fremdeSpracheAbsage } from "./kontext-gemeinsam.js";
 /**
  * Holt den Firmenkontext von der App und legt ihn in den verwalteten Dateien
  * des gefundenen Arbeitsplatzes ab -- `CLAUDE.md` und die fuenf Dateien in
@@ -21,7 +25,7 @@ import { ERLAUBT, absage, arbeitsplatzOderAbsage } from "./kontext-gemeinsam.js"
  * Git benutzt.
  *
  * ⛔ **Unterhalb von `werkbank-<name>/` wird nichts geschrieben** (Spec §4).
- * Dieser Befehl kennt genau die Pfade aus `VERWALTETE_DATEIEN`, und in keinem
+ * Dieser Befehl kennt genau die Pfade aus `verwalteteDateien(sprache)`, und in keinem
  * davon steht ein Personenname.
  *
  * 🔁 **Ruling T9-2:** Die Gegenrichtung, `kontextHoch`, wohnt seit dem Split
@@ -29,25 +33,18 @@ import { ERLAUBT, absage, arbeitsplatzOderAbsage } from "./kontext-gemeinsam.js"
  * Firmenwahl-Absage und die `--firma`/`--firma-id`-Optionen ueber
  * `kontext-gemeinsam.ts`.
  */
-const HILFE = `
-  kimal3 kontext runter [--firma "Name" | --firma-id "…"]
-
-  Holt den Firmenkontext (CLAUDE.md + die fuenf Dateien in kontext/) und legt
-  ihn in deinem KI-Arbeitsplatz ab. Was du selbst geaendert hast, fasst der
-  Befehl nicht an -- er sagt dir, wie du es einbringst.
-
-  --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.
-`;
+/** Die Hilfe von `kontext runter` / `context download` in der Sprache des Menschen. */
+export function hilfe(s) {
+    return KONTEXT_TEXTE[s].downloadHelp;
+}
 export async function kontextRunter(argv) {
+    let s = sprache();
+    let t = KONTEXT_TEXTE[s];
     if (argv.includes("--help") || argv.includes("-h")) {
-        console.log(HILFE);
+        console.log(hilfe(s));
         return 0;
     }
-    const zerlegt = zerlege(argv, ERLAUBT);
+    const zerlegt = zerlege(argv, ERLAUBT, s);
     if (!zerlegt.ok) {
         console.error(zerlegt.meldung);
         return 1;
@@ -66,23 +63,32 @@ export async function kontextRunter(argv) {
         suche.set("firma", wunsch);
     if (wunschId !== undefined)
         suche.set("firma-id", wunschId);
-    const pfad = suche.toString() ? `/api/cli/kontext?${suche.toString()}` : "/api/cli/kontext";
-    const antwort = await ruf(pfad, { methode: "GET", mitAusweis: true });
+    const pfad = suche.toString() ? `/api/cli/kontext?${suche.toString()}` : "/api/cli/kontext"; // kein-anzeigetext: Pfad der Schnittstelle
+    const antwort = await ruf(pfad, { methode: "GET", mitAusweis: true }); // kein-anzeigetext: HTTP-Verb
+    // 🌐 Die Antwort kann die Kontosprache umgestellt haben (Spec 3.2, Schritt 3): Was ab hier gedruckt wird, in der neuen.
+    s = sprache();
+    t = KONTEXT_TEXTE[s];
     if (antwort.status !== 200) {
-        return absage(antwort, "kontext runter");
+        return absage(antwort, "kontext runter", ""); // kein-anzeigetext: Befehlsschlüssel
     }
     // 🔴 Ein `200` mit unlesbarem Rumpf ist KEIN Erfolg -- dasselbe Muster wie
     // in `firma-daten.ts`. `ruf` verschluckt Parse-Fehler zu `null`.
     if (antwort.koerper === null || typeof antwort.koerper !== "object") {
-        console.error("Die Antwort war nicht lesbar. Bitte gleich noch einmal.");
+        console.error(ALLGEMEIN_TEXTE[s].unreadableAnswer);
         return 3;
     }
     const daten = alsKontextAntwort(antwort.koerper);
     if (daten === null) {
-        console.error("Die Antwort war nicht lesbar. Bitte gleich noch einmal.");
+        console.error(ALLGEMEIN_TEXTE[s].unreadableAnswer);
         return 3;
     }
-    const lokalerMerkzettel = leseMerkzettelDatei(ordner);
+    // 🔴 US-13: Die Firma spricht inzwischen eine andere Sprache als dieser Ordner. VOR der
+    // Schleife pruefen -- sonst stuenden nach dem Schreiben zwei Sprachen nebeneinander.
+    if (daten.sprache !== ordner.sprache) {
+        fremdeSpracheAbsage(ordner.sprache, daten.sprache, daten.firma.name);
+        return 1;
+    }
+    const lokalerMerkzettel = leseMerkzettelDatei(ordner.pfad);
     const heute = heuteAus(new Date());
     const geschrieben = [];
     // Punkt A-1: die Teilmenge von `geschrieben`, bei der NICHT die Firma etwas
@@ -92,23 +98,35 @@ export async function kontextRunter(argv) {
     const vorlageErneuert = [];
     const gesicherte = [];
     const unberuehrt = [];
-    for (const verwalteterPfad of VERWALTETE_DATEIEN) {
+    /*
+      🔴 **ERST ALLES PRUEFEN UND LESEN, DANN SCHREIBEN** (Final-Review, Fund 2).
+      Bis dahin lief Pruefen und Schreiben in EINER Schleife: Fehlte in der
+      Antwort die vierte Datei, waren `CLAUDE.md` und die ersten drei schon
+      ueberschrieben, der Merkzettel aber nicht -- ein halber Stand, den das
+      naechste `runter` falsch einordnet. Jetzt bricht eine unvollstaendige
+      Lieferung (oder eine unlesbare lokale Datei) ab, bevor ein Byte geschrieben ist.
+    */
+    const vorbereitet = [];
+    for (const verwalteterPfad of verwalteteDateien(ordner.sprache)) {
         const serverDatei = daten.dateien.find((d) => d.pfad === verwalteterPfad);
         if (!serverDatei) {
-            console.error(`Die Antwort enthaelt keine Datei „${verwalteterPfad}". Bitte melden.`);
+            console.error(t.answerMissingFile(verwalteterPfad));
             return 3;
         }
         // Zweites Netz -- s. Kommentar an `schreibeVerwalteteDatei`: `pfad` kommt
         // hier aus der eigenen Iteration, nicht roh vom Server, trotzdem geprueft.
         if (istUnsichererPfad(serverDatei.pfad)) {
-            console.error(`Die Antwort enthaelt einen unsicheren Pfad: „${serverDatei.pfad}". Bitte melden.`);
+            console.error(t.answerUnsafePath(serverDatei.pfad));
             return 3;
         }
-        const lokalGelesen = leseEineDatei(ordner, verwalteterPfad);
+        const lokalGelesen = leseEineDatei(ordner.pfad, verwalteterPfad);
         if (!lokalGelesen.ok) {
             console.error(lokalGelesen.meldung);
             return 1;
         }
+        vorbereitet.push({ pfad: verwalteterPfad, serverInhalt: serverDatei.inhalt, lokalerInhalt: lokalGelesen.inhalt });
+    }
+    for (const { pfad: verwalteterPfad, serverInhalt, lokalerInhalt } of vorbereitet) {
         /*
           🔴 **DIE BEIDEN MERKZETTEL GEHEN ALS GANZES HINEIN -- Punkt A-1,
           2026-08-26.** Hier standen vorher drei Zeilen, die den Eintrag, den
@@ -125,15 +143,15 @@ export async function kontextRunter(argv) {
         */
         const lage = lageAusMerkzetteln({
             pfad: verwalteterPfad,
-            lokalerInhalt: lokalGelesen.inhalt,
-            serverInhalt: serverDatei.inhalt,
+            lokalerInhalt,
+            serverInhalt,
             lokal: lokalerMerkzettel,
             vomServer: daten.merkzettel,
         });
         if (lage === "beides") {
-            // `lokalGelesen.inhalt` ist hier garantiert eine Zeichenkette:
+            // `lokalerInhalt` ist hier garantiert eine Zeichenkette:
             // `lageFuerDatei` liefert "beides" nie, wenn `lokalerInhalt === null`.
-            const sicherung = sichereDatei(ordner, verwalteterPfad, lokalGelesen.inhalt, heute);
+            const sicherung = sichereDatei(ordner.pfad, verwalteterPfad, lokalerInhalt, heute, ordner.sprache);
             if (!sicherung.ok) {
                 console.error(sicherung.meldung);
                 return 1;
@@ -163,7 +181,7 @@ export async function kontextRunter(argv) {
           vermisst hat, weil ihn niemand erreichen konnte.
         */
         if (lage === "server-neuer" || lage === "beides" || lage === "vorlage-neuer") {
-            const geschriebenErg = schreibeVerwalteteDatei(ordner, verwalteterPfad, serverDatei.inhalt);
+            const geschriebenErg = schreibeVerwalteteDatei(ordner.pfad, verwalteterPfad, serverInhalt, ordner.sprache);
             if (!geschriebenErg.ok) {
                 console.error(geschriebenErg.meldung);
                 return 1;
@@ -200,7 +218,7 @@ export async function kontextRunter(argv) {
       dieselbe Sorte Fehlalarm wie eine, die nie ankommt.*
     */
     const merkzettelZumSchreiben = { firma_id: daten.firma.id, dateien: daten.merkzettel.dateien };
-    const merkzettelSchreiben = schreibeMerkzettelDatei(ordner, merkzettelZumSchreiben);
+    const merkzettelSchreiben = schreibeMerkzettelDatei(ordner.pfad, merkzettelZumSchreiben);
     if (!merkzettelSchreiben.ok) {
         console.error(merkzettelSchreiben.meldung);
         return 1;
@@ -217,49 +235,46 @@ export async function kontextRunter(argv) {
     // (vor dem Ergebnis) und nennt den Ordner. Die eigentliche Reihenfolge
     // (erst sichern, dann ueberschreiben) erzwingt schon der Code oben.
     if (gesicherte.length > 0) {
-        console.log(`Ich sichere deine lokale Fassung, bevor ich sie ersetze -- Ordner: ${sicherungsOrdner(heute)}`);
+        console.log(t.backupHeader(sicherungsOrdner(ordner.sprache, heute)));
         for (const g of gesicherte) {
             if (g.nebenVorhandener) {
-                const bisherige = sicherungsZiel(heute, g.pfad).split("/").pop();
+                const bisherige = sicherungsZiel(ordner.sprache, heute, g.pfad).split("/").pop();
                 const neue = g.ziel.split("/").pop();
-                console.log(`  „${g.pfad}": Von heute gibt es schon eine Sicherung (${bisherige}) -- die bleibt ` +
-                    `unveraendert stehen. Deine neuere Fassung sichere ich zusaetzlich als ${neue}, ` +
-                    "bevor ich die Datei im Ordner ersetze.");
+                console.log(t.backupAlreadyToday(g.pfad, bisherige, neue));
             }
             else {
-                console.log(`  „${g.pfad}" -> ${g.ziel.split("/").pop()}`);
+                console.log(t.backupPlain(g.pfad, g.ziel.split("/").pop()));
             }
         }
     }
     if (geschrieben.length > 0) {
-        console.log(`✓ aktualisiert: ${geschrieben.join(", ")}`);
+        console.log(t.updated(geschrieben.join(", ")));
     }
     // 🔴 Punkt A-1: Eine eigene Zeile, kein stilles Mitschreiben. „Aktualisiert"
     // heisst fuer den Leser sonst automatisch „meine Firma hat etwas gesagt" --
     // und dann sucht er in der App eine Aenderung, die es dort nicht gibt.
     if (vorlageErneuert.length > 0) {
-        console.log(`  Davon aus unserer verbesserten Vorlage: ${vorlageErneuert.join(", ")}`);
-        console.log("  Diese Dateien waren seit dem letzten Abgleich mit der Firma unverändert — es ist nichts\n" +
-            "  von dir verloren gegangen. Hättest du seitdem etwas geändert, hätte ich vorher gesichert.");
+        console.log(t.fromOurTemplate(vorlageErneuert.join(", ")));
+        console.log(t.templateUnchanged);
     }
     // §8: Ein Fehlerfall darf nie denselben Namen tragen wie ein Erfolgsfall --
     // "nichts geschrieben" heisst hier DREI verschiedene Dinge, und die Ausgabe
     // muss sie unterscheiden, nicht nur die Rueckgabe (alle drei geben 0).
     if (unberuehrt.length > 0) {
-        console.log(`Ich fasse nichts an -- du hast lokal geaendert: ${unberuehrt.join(", ")}`);
+        console.log(t.leftAlone(unberuehrt.join(", ")));
         // 🔴 Der Rat haengt an der DATEI, nicht nur an der Rolle -- s.
-        // `ratNachUnberuehrt` (kontext-stand.ts), Review-Befund F-3.
-        for (const zeile of ratNachUnberuehrt(unberuehrt, daten.rolle, daten.adminName)) {
+        // `ratNachUnberuehrt` (kontext-rat.ts), Review-Befund F-3.
+        for (const zeile of ratNachUnberuehrt(unberuehrt, daten.rolle, daten.adminName, ordner.sprache, s)) {
             console.log(zeile);
         }
     }
     if (geschrieben.length === 0 && unberuehrt.length === 0) {
-        const alleLeer = VERWALTETE_DATEIEN.every((p) => (daten.merkzettel.dateien[p]?.stand ?? LEER) === LEER);
+        const alleLeer = verwalteteDateien(ordner.sprache).every((p) => (daten.merkzettel.dateien[p]?.stand ?? LEER) === LEER);
         if (alleLeer) {
-            console.log("Deine Firma hat noch nichts hinterlegt. Bis dahin bleiben die Vordrucke stehen.");
+            console.log(t.companyEmpty);
         }
         else {
-            console.log("Dein Firmenkontext ist aktuell.");
+            console.log(t.upToDate);
         }
     }
     return 0;
@@ -277,6 +292,8 @@ function alsKontextAntwort(koerper) {
     const firmaId = firmaRoh.id;
     if (typeof firmaId !== "string" || firmaId.trim() === "")
         return null;
+    const firmaNameRoh = firmaRoh.name;
+    const firmaName = typeof firmaNameRoh === "string" && firmaNameRoh.trim() !== "" ? firmaNameRoh : null;
     const rolle = k.rolle;
     if (rolle !== "admin" && rolle !== "member")
         return null;
@@ -301,5 +318,7 @@ function alsKontextAntwort(koerper) {
     const merkzettel = alsMerkzettel(k.merkzettel);
     if (merkzettel === null)
         return null;
-    return { firma: { id: firmaId }, rolle, adminName, dateien, merkzettel };
+    // 🌐 Teil 2: die Firmensprache. Fehlt das Feld, antwortet ein Server vor 0.3.0 -- der kennt nur Deutsch.
+    const sprache = k.sprache === "en" ? "en" : "de";
+    return { firma: { id: firmaId, name: firmaName }, rolle, adminName, dateien, merkzettel, sprache };
 }