kimal3 0.2.9 → 0.3.0

package/dist/kontext-stand.js

@@ -48,20 +48,20 @@ import { createHash } from "node:crypto";
  * Menschen mitgeht (sie steht in der Positiv-Liste der `.gitignore`).
  * Deshalb ist sie das Erkennungszeichen in `firmennameAusClaudeMd`.
  *
- * ⚠️ Sie ist zugleich der erste Eintrag von `VERWALTETE_DATEIEN` darunter --
+ * ⚠️ Sie ist zugleich der erste Eintrag von `verwalteteDateien(sprache)` darunter --
  * dass beide dieselbe Datei meinen, prueft `check:cli`. Dort haengt auch die
  * Pruefung, dass die ECHTE Vorlage ihre Ueberschrift noch so schreibt, wie
  * `firmennameAusClaudeMd` sie liest.
  */
-export const FIRMEN_CLAUDE_MD = "CLAUDE.md";
-export const VERWALTETE_DATEIEN = [
-    "CLAUDE.md",
-    "kontext/kurzprofil.md",
-    "kontext/firma.md",
-    "kontext/marke.md",
-    "kontext/systeme.md",
-    "kontext/sicherheit.md",
-];
+export const FIRMEN_CLAUDE_MD = "CLAUDE.md"; // kein-anzeigetext: Dateiname
+export const ORDNER_NAMEN = {
+    de: { wurzel: "KI-Arbeitsplatz", kontext: "kontext", kopf: "KI-Arbeitsplatz", sicherung: "vorher" }, // kein-anzeigetext: Ordnername (Wortliste Teil 2)
+    en: { wurzel: "AI-Workplace", kontext: "context", kopf: "AI Workplace", sicherung: "before" }, // kein-anzeigetext: Ordnername (Wortliste Teil 2)
+};
+const DATEINAMEN = {
+    de: { drei_saetze: "kurzprofil.md", firma_md: "firma.md", marke_md: "marke.md", systeme_md: "systeme.md", sicherheit_md: "sicherheit.md" },
+    en: { drei_saetze: "profile.md", firma_md: "company.md", marke_md: "brand.md", systeme_md: "systems.md", sicherheit_md: "security.md" },
+};
 /**
  * Die FUENF Texte, die eine Firma selbst pflegt -- welche Datei welches Feld
  * der App fuellt, wie sie dort heisst, und woran man sie wiedererkennt.
@@ -75,12 +75,14 @@ export const VERWALTETE_DATEIEN = [
  *
  * 🔴 **Sie ist NICHT der Fragenkatalog.** Hier stehen fuenf Dateinamen, fuenf
  * Feldnamen, fuenf Anzeigenamen und fuenf Praefixe -- kein einziger Fragetext.
- * Die 17 Fragen wohnen genau einmal, in `arbeitsplatz/vorlage/`, und erreichen
+ * Die Fragen wohnen genau einmal, in der Vorlage (`arbeitsplatz/vorlage/`), und erreichen
  * die CLI ueber die ausgelieferte Datei selbst (s. `fragen-lesen.ts`).
  *
- * ⚠️ **`titel` ist ANZEIGETEXT und traegt deshalb echte Umlaute** -- ein Mensch
- * liest ihn im Abbruch von `kontext hoch` („Diese Datei sieht nicht aus wie
- * …"). Die ASCII-Umschrift dieser Datei gilt nur fuer Kommentare.
+ * ⚠️ **`titel` ist hier nur noch der deutsche ABGLEICHWERT** (`kontext-felder.ts`, `check:kontext`
+ * halten ihn gegen die App). Was ein Mensch im Terminal liest -- im Abbruch von `kontext hoch`
+ * („Diese Datei sieht nicht aus wie …") und hinter jedem Pfad in `kontext fragen` --, steht seit
+ * Teil 3 in `KONTEXT_TEXTE[sprache].dateiTitel` (`texte/kontext.ts`), in der Sprache des Menschen
+ * (W-7). Diese Datei darf nichts importieren, deshalb kam der Satz nicht hierher.
  *
  * 🔴 **`ankerPraefix` ist keine Verabredung, sondern eine gemessene Zusage.**
  * `check:kontext` haelt jeden Anker aus `FRAGEN` (der App) gegen den Praefix
@@ -92,14 +94,27 @@ export const VERWALTETE_DATEIEN = [
  * Zuordnungen.** Die App darf diese Datei lesen, die CLI aber nicht die
  * App -- deshalb steht die Tabelle hier und die Uebereinstimmung ist eine
  * Pruefung in `check:kontext`, keine Hoffnung.
+ *
+ * 🌐 **Teil 2:** Der `pfad` haengt an der Firmensprache (`kontext/firma.md` oder
+ * `context/company.md`); Feld, Titel und Anker sind in beiden Sprachen gleich.
+ * Reihenfolge = die von heute (kurzprofil, firma, marke, systeme, sicherheit) --
+ * Merkzettel und Terminal-Ausgaben bleiben damit fuer deutsche Ordner Zeichen fuer
+ * Zeichen gleich. `titel` bleibt deutsch und ist nur der Abgleichwert (s. o.).
  */
-export const FIRMEN_TEXTE = [
-    { pfad: "kontext/kurzprofil.md", feld: "drei_saetze", titel: "Die Firma in drei Sätzen", ankerPraefix: "kurz_" },
-    { pfad: "kontext/firma.md", feld: "firma_md", titel: "Die Firma", ankerPraefix: "firma_" },
-    { pfad: "kontext/marke.md", feld: "marke_md", titel: "Die Marke", ankerPraefix: "marke_" },
-    { pfad: "kontext/systeme.md", feld: "systeme_md", titel: "Die Systeme", ankerPraefix: "systeme_" },
-    { pfad: "kontext/sicherheit.md", feld: "sicherheit_md", titel: "Sicherheit", ankerPraefix: "sicher_" },
+const TEXTE = [
+    { feld: "drei_saetze", titel: "Die Firma in drei Sätzen", ankerPraefix: "kurz_" }, // kein-anzeigetext: Abgleichwert, Anzeige über KONTEXT_TEXTE.dateiTitel (W-7)
+    { feld: "firma_md", titel: "Die Firma", ankerPraefix: "firma_" }, // kein-anzeigetext: Abgleichwert, Anzeige über KONTEXT_TEXTE.dateiTitel (W-7)
+    { feld: "marke_md", titel: "Die Marke", ankerPraefix: "marke_" }, // kein-anzeigetext: Abgleichwert, Anzeige über KONTEXT_TEXTE.dateiTitel (W-7)
+    { feld: "systeme_md", titel: "Die Systeme", ankerPraefix: "systeme_" }, // kein-anzeigetext: Abgleichwert, Anzeige über KONTEXT_TEXTE.dateiTitel (W-7)
+    { feld: "sicherheit_md", titel: "Sicherheit", ankerPraefix: "sicher_" }, // kein-anzeigetext: Abgleichwert, Anzeige über KONTEXT_TEXTE.dateiTitel (W-7)
 ];
+export function firmenTexte(sprache) {
+    return TEXTE.map((t) => ({ ...t, pfad: `${ORDNER_NAMEN[sprache].kontext}/${DATEINAMEN[sprache][t.feld]}` }));
+}
+/** Alle Dateien, die der Merkzettel fuehrt: die Firmen-`CLAUDE.md` zuerst, dann die fuenf Texte. */
+export function verwalteteDateien(sprache) {
+    return [FIRMEN_CLAUDE_MD, ...firmenTexte(sprache).map((t) => t.pfad)];
+}
 /**
  * Der Merkzettel liegt im WURZELVERZEICHNIS des Arbeitsplatzes, eine Ebene
  * ueber `kontext/`.
@@ -110,8 +125,6 @@ export const FIRMEN_TEXTE = [
  * stiller Falschaussage, die niemand bemerkt, bis sie schadet.
  */
 export const MERKZETTEL_PFAD = ".kimal3-stand.json";
-/** Wo die Sicherungen hinkommen. Siehe die Frage am Kopf des Bauplans. */
-export const SICHERUNG_BASIS = "kontext";
 /**
  * Der Stand einer Firma, die nichts gepflegt hat.
  *
@@ -153,10 +166,16 @@ const LEERER_MERKZETTEL = { firma_id: null, dateien: {} };
  * genau dann da, wenn der Server die Firma nicht kannte -- also im
  * Vordruck-Fall, in dem es nichts zu vergleichen gibt.
  */
+// Teil 2: beide Koepfe aus ORDNER_NAMEN (`KI-Arbeitsplatz`, `AI Workplace`), maskiert fuer den Ausdruck.
+const KOPF_MUSTER = new RegExp(
+// kein-anzeigetext: Suchmuster für die Überschrift der Firmen-CLAUDE.md, kein Satz
+`^#\\s*CLAUDE\\.md\\s*—\\s*(.+?)\\s*·\\s*(?:${Object.values(ORDNER_NAMEN)
+    .map((n) => n.kopf.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"))
+    .join("|")})\\s*$`, "m");
 export function firmennameAusClaudeMd(inhalt) {
     if (inhalt === null)
         return null;
-    const treffer = /^#\s*CLAUDE\.md\s*—\s*(.+?)\s*·\s*KI-Arbeitsplatz\s*$/m.exec(inhalt);
+    const treffer = KOPF_MUSTER.exec(inhalt);
     if (treffer === null)
         return null;
     const name = treffer[1].trim();
@@ -390,9 +409,9 @@ export function alsMerkzettel(wert) {
  * die Datei ohne jeden Import ausser `node:crypto`, ist der einzige Weg, der
  * `api.ts` nicht in einen Kreisimport mit sich selbst zwingt.
  */
-export function bekannterStandAus(merkzettel) {
+export function bekannterStandAus(merkzettel, sprache) {
     const staende = new Set();
-    for (const pfad of VERWALTETE_DATEIEN) {
+    for (const pfad of verwalteteDateien(sprache)) {
         const stand = merkzettel.dateien[pfad]?.stand;
         if (stand !== undefined && stand !== LEER)
             staende.add(stand);
@@ -442,9 +461,9 @@ export function bekannterStandAus(merkzettel) {
  * (`leseMerkzettel` oben). Jede Lieferung, die durch diese Funktion entsteht,
  * ist per Definition die aktuelle Fassung.
  */
-export function baueMerkzettel(dateien, staende, firmenId, vorlagenPruefsummen) {
+export function baueMerkzettel(dateien, staende, firmenId, vorlagenPruefsummen, sprache) {
     const raus = {};
-    for (const pfad of VERWALTETE_DATEIEN) {
+    for (const pfad of verwalteteDateien(sprache)) {
         const datei = dateien.find((d) => d.pfad === pfad);
         if (!datei)
             continue;
@@ -466,6 +485,10 @@ export function baueMerkzettel(dateien, staende, firmenId, vorlagenPruefsummen)
  * schreibt keine einzige Datei. Fuer die fuenf gesendeten Texte geht das
  * trotzdem auf: Was der Server zurueckgibt, entsteht aus dem, was die CLI ihm
  * gerade geschickt hat, und dasselbe steht auf der Platte.
+ * ⚠️ Seit dem 25.09. (Luecke L12) gilt das nur noch, weil der SERVER es
+ * sicherstellt: Er liefert einen um neue Fragen ergaenzten Text aus, traegt im
+ * Merkzettel aber die Pruefsumme des GESENDETEN ein -- `merkzettelFuerHochAntwort`
+ * in `src/lib/cli/merkzettel-hoch.ts`. Wer dort etwas aendert, bricht diese Zeile.
  *
  * ⚠️ **Fuer die Firmen-`CLAUDE.md` geht es NICHT auf, seit Ruling K-6.** Sie
  * wird nicht mehr gesendet, aber der Server BAUT sie neu (er setzt die frischen
@@ -495,9 +518,9 @@ export function baueMerkzettel(dateien, staende, firmenId, vorlagenPruefsummen)
  * 🔑 `format` und `firma_id` kommen weiterhin vom SERVER: Beide sagen nichts
  * ueber den Inhalt einer Datei, und bei der Firma ist der Server die Wahrheit.
  */
-export function merkzettelNachHoch(vomServer, lokal, gesendet) {
+export function merkzettelNachHoch(vomServer, lokal, gesendet, sprache) {
     const dateien = {};
-    for (const pfad of VERWALTETE_DATEIEN) {
+    for (const pfad of verwalteteDateien(sprache)) {
         const eintrag = gesendet.includes(pfad) ? vomServer.dateien[pfad] : lokal.dateien[pfad];
         if (eintrag)
             dateien[pfad] = eintrag;
@@ -644,9 +667,9 @@ export function lageAusMerkzetteln(a) {
         aktuelleVorlage: vomServer?.vorlage ?? LEER,
     });
 }
-/** `kontext/vorher-2026-08-21` */
-export function sicherungsOrdner(datum) {
-    return `${SICHERUNG_BASIS}/vorher-${datum}`;
+/** `kontext/vorher-2026-08-21` (deutsch) oder `context/before-2026-08-21` (englisch). */
+export function sicherungsOrdner(sprache, datum) {
+    return `${ORDNER_NAMEN[sprache].kontext}/${ORDNER_NAMEN[sprache].sicherung}-${datum}`;
 }
 /**
  * Wohin die lokale Fassung gesichert wird.
@@ -657,43 +680,23 @@ export function sicherungsOrdner(datum) {
  * Basisnamen haben. Eine kuenftige sechste faellt damit auf, bevor sie eine
  * Sicherung ueberschreibt.
  */
-export function sicherungsZiel(datum, pfad) {
+export function sicherungsZiel(sprache, datum, pfad) {
     const name = pfad.split("/").pop() ?? pfad;
-    return `${sicherungsOrdner(datum)}/${name}`;
+    return `${sicherungsOrdner(sprache, datum)}/${name}`;
 }
-/**
- * Von welchem Ordner aus `kimal3 kontext runter` ueberhaupt wissen kann,
- * welche Firma gemeint ist -- **ohne** das Dateisystem selbst anzufassen.
- *
- * 🔑 WARUM DIESE FUNKTION HIER UND NICHT ERST IN EINER SPAETEREN AUFGABE
- * WOHNT: Diese Datei importiert bewusst nur `node:crypto` (s. Kopf). Die
- * Fundregel selbst braucht kein Dateisystem -- nur eine Liste von Kandidaten,
- * die der Aufrufer (spaeter) mit `readdirSync`/`existsSync` gefuellt hat.
- * Die eigentliche Suche gehoert deshalb woanders hin (zieht Umgebung und
- * Heimverzeichnis hoch); ein Waechter fuer eine reine Pfadregel soll das
- * nicht mit auslösen.
- *
- * Fundregel: Vom aktuellen Verzeichnis aufwaerts suchen, bis ein Ordner
- * gefunden ist, der `kontext/` UND `CLAUDE.md` enthaelt.
- *
- * 🔴 DER ERSTE TREFFER GEWINNT, NICHT DER OBERSTE. Die Kandidaten kommen von
- * UNTEN NACH OBEN (aktuelles Verzeichnis zuerst) -- wer in
- * `Kunden/ARNO/KI-Arbeitsplatz` steht, meint ARNO, nicht `Kunden/`. Wuerde
- * stattdessen der oberste Treffer gewinnen, faende der Befehl bei jedem
- * verschachtelten Arbeitsplatz den falschen.
- *
- * 🔑 BEIDES MUSS STIMMEN. Ein Ordner mit `kontext/`, aber ohne `CLAUDE.md`,
- * ist kein Arbeitsplatz -- sonst traefe der Befehl irgendeinen Ordner, in dem
- * jemand zufaellig etwas "kontext" genannt hat.
- *
- * Kein Treffer -> `null`.
- */
 export function arbeitsplatzAus(kandidaten) {
+    const traegtTexte = (namen, sprache) => Object.values(DATEINAMEN[sprache]).some((n) => namen.includes(n));
     for (const k of kandidaten) {
-        if (k.hatKontext && k.hatClaude)
-            return k.pfad;
+        const de = traegtTexte(k.kontextNamen, "de");
+        const en = traegtTexte(k.contextNamen, "en");
+        if (!k.hatClaude || (!de && !en))
+            continue;
+        // Spec 3.2: beide Namen nebeneinander ist ein Fehler, den das Programm MELDET, statt still einen zu waehlen.
+        if (de && en)
+            return { art: "beide", pfad: k.pfad };
+        return { art: "gefunden", pfad: k.pfad, sprache: en ? "en" : "de" };
     }
-    return null;
+    return { art: "keiner" };
 }
 /*
   🪦 **Hier wohnten `DREI_SAETZE_UEBERSCHRIFT`, der Typ `DreiSaetzeSchnitt` und
@@ -714,7 +717,7 @@ export function arbeitsplatzAus(kandidaten) {
   Fragengeruest gezeigt -- mit den Saetzen der Firma unsichtbar dahinter.
 
   🔑 **Was ihre Aufgabe uebernommen hat:** `kontext/kurzprofil.md` ist seither
-  eine Datei wie die vier anderen. Sie steht in {@link FIRMEN_TEXTE} und wird
+  eine Datei wie die vier anderen. Sie steht in {@link firmenTexte} und wird
   gelesen, hochgeschickt und nachgezogen wie `marke.md` auch. *Fuenf
   gleichrangige Dateien, kein Sonderfall, keine Extra-Meldung.*
 
@@ -723,148 +726,3 @@ export function arbeitsplatzAus(kandidaten) {
   Antworten an der Stelle von `EINSETZ_MARKE_DREI_SAETZE` ein, und dass DIESE
   Marke woertlich in der Vorlage steht, prueft `check:arbeitsplatz`.
 */
-/**
- * Die ARTEN von Rat, die es gibt -- **in der Reihenfolge, in der sie im
- * Terminal stehen.**
- *
- * 🔑 Diese Liste ist zugleich die Quelle des Typs {@link RatArt}. Wer eine
- * dritte Art erfindet, muss sie hier eintragen -- und bekommt danach vom
- * Compiler gesagt, dass {@link RAT_TEXT} noch keinen Text dafuer hat. *Eine
- * Reihenfolge, die nebenher den Typ traegt, kann nicht unvollstaendig sein.*
- *
- * ⚠️ Die Reihenfolge ist nicht Geschmack: `kimal3 kontext runter` druckt seit
- * Befund F-3 erst den Rat fuer die Firmen-Texte und darunter den fuer unsere
- * Vorlage. Wer sie dreht, dreht die Ausgabe beim Kunden.
- */
-const RAT_REIHENFOLGE = ["hochschickbar", "nicht-hochschickbar"];
-/**
- * 🔴 **PUNKT A-7 (2026-08-26): DIESE TABELLE IST DIE ABSICHERUNG, NICHT NUR
- * EINE AUFRAEUMAKTION.**
- *
- * Bis hierher zaehlte {@link ratNachUnberuehrt} ihre Faelle auf: ein `if` fuer
- * „irgendetwas aus {@link FIRMEN_TEXTE}" und ein zweites fuer den woertlichen
- * Dateinamen `"CLAUDE.md"`. {@link VERWALTETE_DATEIEN} hat aber SECHS
- * Eintraege, und eine kuenftige SIEBTE waere durch beide `if`s gefallen --
- * ohne Fehler, ohne Meldung, ohne Rat. *Der Mensch haette gelesen, dass seine
- * Datei in Ruhe gelassen wurde, und nirgends, was er jetzt tun soll.*
- *
- * 🔑 **Warum ein `Record` und keine zweite Liste:** Der Schluesseltyp ist die
- * Vereinigung aller Pfade aus {@link VERWALTETE_DATEIEN}. Eine siebte Datei
- * dort weitet ihn -- und dieses Objekt hat dann einen Schluessel zu wenig,
- * *also uebersetzt die CLI nicht mehr*. Das ist die einzige Absicherung, die
- * auch den erwischt, der diesen Kommentar nie liest.
- *
- * ⚠️ **Warum die Zuordnung nicht IN {@link VERWALTETE_DATEIEN} steht**, wo sie
- * inhaltlich hingehoerte: Diese Liste ist an sechs Stellen ausserhalb dieser
- * Datei eine reine Pfadliste (`ausliefern.ts`, `route.ts`,
- * `kontext-runter.ts`, `kontext-dateien.ts`, zwei Waechter). Aus ihr eine
- * Liste von Objekten zu machen, haette all das angefasst -- fuer denselben
- * Schutz, den der `Record` hier ohne einen einzigen fremden Eingriff gibt.
- *
- * ⚠️ **Sie sagt dasselbe wie {@link FIRMEN_TEXTE}, und das ist eine
- * Doppelung** -- gehalten wird sie von einer Pruefung in `check:kontext`
- * („der `hoch`-Rat geht an genau die Dateien, die `kontext hoch` wirklich
- * traegt"). Die konnte vor diesem Umbau gar nicht rot werden, weil der Rat
- * SELBST aus {@link FIRMEN_TEXTE} entstand; jetzt sind es zwei Tabellen, und
- * ihr Auseinanderlaufen ist messbar.
- */
-const RAT_ART_JE_DATEI = {
-    "CLAUDE.md": "nicht-hochschickbar",
-    "kontext/kurzprofil.md": "hochschickbar",
-    "kontext/firma.md": "hochschickbar",
-    "kontext/marke.md": "hochschickbar",
-    "kontext/systeme.md": "hochschickbar",
-    "kontext/sicherheit.md": "hochschickbar",
-};
-/**
- * Der Wortlaut je Art und Rolle.
- *
- * ⚠️ ECHTE UMLAUTE -- das liest ein Kunde. Die ASCII-Umschrift dieser Datei
- * gilt nur fuer Kommentare.
- *
- * 🔑 `wer` ist die fertige Anrede (` an Lena` oder ` an euren Firmen-Admin`),
- * damit der Rueckfall auf den Sammelbegriff an EINER Stelle steht und nicht in
- * jedem Zweig neu. Ruling T7-1: nie `null` im Klartext.
- */
-const RAT_TEXT = {
-    hochschickbar: (rolle, wer) => rolle === "admin"
-        ? "  Deine Fassung ist die neuere? Dann schick sie hoch:  kimal3 kontext hoch"
-        : "  Deine Fassung bleibt stehen — hochschicken darf nur der Firmen-Admin.\n" +
-            `  Gib deine Ergänzung${wer} weiter; von dort geht sie in der App unter\n` +
-            "  Firma → Kontext oder mit `kimal3 kontext hoch` an alle.",
-    /*
-      🔴 **Auch dieser Zweig kennt die ROLLE -- Punkt A-5, 2026-08-26.** Er tat
-      es bis dahin nicht und riet jedem dasselbe: „Aendere sie dort", also im
-      Formular unter Firma → Kontext. Ein MITGLIED kann das nicht. `kimal3
-      kontext hoch` weist es ab, und den Firmenkontext der Firma darf es in der
-      App nicht schreiben. *Ein Rat, der die Lage nicht aendern kann, ist keiner*
-      -- er schickt einen Menschen an eine Tuer, vor der er keinen Schluessel
-      hat, und laesst ihn den Fehler bei sich suchen.
-  
-      🔑 Was das Mitglied stattdessen liest: WAS es weitergeben soll (die drei
-      Saetze aus `kontext/kurzprofil.md`) und AN WEN -- genau die Form, die der
-      Zweig fuer die fuenf `kontext/`-Dateien oben schon hat.
-    */
-    "nicht-hochschickbar": (rolle, wer) => rolle === "admin"
-        ? "  Die `CLAUDE.md` kann `kimal3 kontext hoch` nicht mitnehmen — der Befehl schickt nur\n" +
-            "  die fünf Dateien aus `kontext/`. Die drei Sätze in dieser Datei kommen aus\n" +
-            "  `kontext/kurzprofil.md`, der Firmenname aus der App: Ändere sie dort, dann holt\n" +
-            "  der nächste `kimal3 kontext runter` sie hierher.\n" +
-            "  Alles Übrige darin ist unsere Vorlage — dafür gibt es keinen Weg zurück."
-        : "  Die `CLAUDE.md` kann `kimal3 kontext hoch` nicht mitnehmen — der Befehl schickt nur\n" +
-            "  die fünf Dateien aus `kontext/`. Deine Änderung bleibt stehen.\n" +
-            "  Die drei Sätze in dieser Datei kommen aus `kontext/kurzprofil.md`, und die ändert\n" +
-            `  nur der Firmen-Admin. Gib deinen Wunsch${wer} weiter; von dort geht\n` +
-            "  `kontext/kurzprofil.md` in der App unter Firma → Kontext oder mit\n" +
-            "  `kimal3 kontext hoch` an alle.\n" +
-            "  Alles Übrige darin ist unsere Vorlage — dafür gibt es keinen Weg zurück.",
-};
-/**
- * Was ein Mensch lesen soll, wenn `kimal3 kontext runter` Dateien in Ruhe
- * laesst, weil er sie lokal geaendert hat -- je nach Rolle und je nach DATEI.
- *
- * 🔴 **DAS IST FUND F, ZUM ZWEITEN MAL -- und diesmal die echte Fassung
- * (Review-Befund F-3, 2026-08-25).** Der Rat lautete fuer die ganze Liste auf
- * einmal: „Deine Fassung ist die neuere? Dann schick sie hoch: kimal3 kontext
- * hoch". Fuer `CLAUDE.md` ist dieser Satz eine Sackgasse: Sie steht in
- * {@link VERWALTETE_DATEIEN} und landet deshalb in der Liste -- aber
- * `kontext hoch` liest ausschliesslich die fuenf Dateien aus
- * {@link FIRMEN_TEXTE} und meldet danach Erfolg, ohne sie. *Der Mensch tippt
- * den geratenen Befehl, sieht einen Haken, und seine Aenderung steht weiter
- * allein auf seiner Platte.*
- *
- * 🔑 Die ausgelieferte `CLAUDE.md` laedt diese Bearbeitung foermlich ein: Sie
- * sagt selbst, aendern muesse man sie nur, wenn sich die Firma aendert.
- *
- * 🔴 **Der Rat wohnt hier und nicht im Befehl, damit ihn eine Wache sehen
- * kann.** Die spurious Fassung desselben Fehlers (`merkzettelNachHoch`) war
- * behoben, die echte lag vier Runden lang offen -- *ein Satz ueber das
- * Verhalten eines Befehls wohnte im Befehl selbst, wo keine Vorlagen-Wache je
- * hinsieht.* `check:kontext` prueft jetzt genau diese Zuordnung.
- *
- * 🔴 **PUNKT A-7 (2026-08-26): DER RAT WIRD ERZEUGT, NICHT AUFGEZAEHLT.** Diese
- * Funktion hatte zwei `if`s -- eines fuer „irgendetwas aus
- * {@link FIRMEN_TEXTE}", eines fuer den woertlichen Namen `"CLAUDE.md"`. Eine
- * siebte verwaltete Datei waere durch beide gefallen und haette schweigend gar
- * keinen Rat bekommen. Jetzt laeuft die Schleife ueber
- * {@link VERWALTETE_DATEIEN} selbst und schlaegt die Art in
- * {@link RAT_ART_JE_DATEI} nach -- eine Datei ohne Zuordnung uebersetzt nicht.
- *
- * ⚠️ **Eine ART, ein Satz -- auch wenn drei ihrer Dateien betroffen sind.** Das
- * war vorher so (ein `if` feuerte einmal) und bleibt so: Der Rat spricht ueber
- * den Weg, nicht ueber die einzelne Datei; dreimal derselbe Absatz waere
- * Laerm.
- */
-export function ratNachUnberuehrt(unberuehrt, rolle, adminName) {
-    // Ruling T7-1: kein `null` im Klartext, sondern der Sammelbegriff.
-    const wer = adminName ? ` an ${adminName}` : " an euren Firmen-Admin";
-    const betroffeneArten = new Set();
-    for (const pfad of VERWALTETE_DATEIEN) {
-        if (unberuehrt.includes(pfad))
-            betroffeneArten.add(RAT_ART_JE_DATEI[pfad]);
-    }
-    // 🔑 Die Reihenfolge kommt aus RAT_REIHENFOLGE, NICHT aus der Einfuegereihen-
-    // folge des `Set` -- sonst haenge die Ausgabe beim Kunden davon ab, in
-    // welcher Reihenfolge VERWALTETE_DATEIEN zufaellig steht.
-    return RAT_REIHENFOLGE.filter((art) => betroffeneArten.has(art)).map((art) => RAT_TEXT[art](rolle, wer));
-}

package/dist/nachricht.js

@@ -8,7 +8,7 @@
  * Die Raender (Datei, Netz, Uhr) wohnen in gesehen.ts, api.ts und kimal3.ts.
  */
 /** Der Stempel, den `kimal3 skill install` ans Ende der SKILL.md schreibt. */
-export const STEMPEL_MARKE = "kimal3:erzeugt version=";
+export const STEMPEL_MARKE = "kimal3:erzeugt version="; // kein-anzeigetext: Stempel in der ausgelieferten Datei
 /**
  * Zieht den Hinweis aus einer Server-Antwort -- oder gibt `null` zurueck.
  *
@@ -119,7 +119,7 @@ export function heuteAus(d) {
  * steht der Server-Stand, den er meint (`kontext-2026-08-26T09:00:00Z`).
  *
  * 🔑 Sie steht als eigener Name da, weil sie von ZWEI Seiten gebraucht wird:
- * `firmenHinweisAus` baut die Kennung, `hinweisErledigt` liest sie wieder
+ * `kontextHinweisAus` baut die Kennung, `hinweisErledigt` liest sie wieder
  * auseinander. Zwei getippte `"kontext-"` waeren zwei Wahrheiten -- und die
  * zweite verrottete lautlos, weil ein Hinweis, der nicht mehr erkannt wird,
  * einfach wieder erscheint, statt einen Fehler zu machen.
@@ -251,34 +251,58 @@ export function stempelAus(inhalt) {
     const treffer = [...inhalt.matchAll(/kimal3:erzeugt version=([0-9][0-9.]*)/g)];
     return treffer.length > 0 ? treffer[treffer.length - 1][1] : null;
 }
+/** Die Stempelzeile -- Deutsch Zeichen fuer Zeichen wie vor Teil 4 (T4-4), Englisch mit Zusatz. */
+export function stempelZeile(version, sprache) {
+    return sprache === "en"
+        ? `<!-- ${STEMPEL_MARKE}${version} sprache=en -->` // kein-anzeigetext: Stempel in der ausgelieferten Datei
+        : `<!-- ${STEMPEL_MARKE}${version} -->`; // kein-anzeigetext: Stempel in der ausgelieferten Datei
+}
+/**
+ * Die Sprache des LETZTEN Stempels (wie `stempelAus`: ein Beispiel im Text darf nicht gewinnen).
+ * Ohne Zusatz -- und bei jedem anderen Zusatz als genau `en` -- Deutsch (T4-4).
+ */
+export function stempelSpracheAus(inhalt) {
+    const treffer = [...inhalt.matchAll(/kimal3:erzeugt version=[0-9][0-9.]*(?: sprache=([a-z]+))?/g)];
+    return treffer.length > 0 && treffer[treffer.length - 1][1] === "en" ? "en" : "de";
+}
 /**
  * Die DREI Zustaende aus US-4/US-5 -- und sie sind ausdruecklich drei, nicht
  * zwei:
  *
- * | Was liegt dort        | Antwort    |
- * |-----------------------|------------|
- * | Datei fehlt           | still      |  <- nie installiert
- * | Datei ohne Stempel    | veraltet   |  <- 0.1.4 und aelter
- * | Stempel aelter        | veraltet   |
- * | Stempel gleich/neuer  | still      |  <- niemand wird rueckwaerts gedraengt
+ * | Was liegt dort                      | Antwort    |
+ * |-------------------------------------|------------|
+ * | Datei fehlt                         | still      |  <- nie installiert
+ * | Datei ohne Stempel                  | veraltet   |  <- 0.1.4 und aelter
+ * | Stempel-Sprache ≠ Lauf-Sprache      | veraltet   |  <- Teil 4, T4-3
+ * | Stempel aelter                      | veraltet   |
+ * | Stempel gleich/neuer                | still      |  <- niemand wird rueckwaerts gedraengt
  *
  * ⚠️ Die ersten beiden sehen im Dateisystem fast gleich aus und bedeuten das
  * Gegenteil. `null` heisst hier "es gibt keine Datei", NICHT "leer".
  */
-export function skillZustand(inhalt, eigeneVersion) {
+export function skillZustand(inhalt, eigeneVersion, sprache) {
     if (inhalt === null)
         return "still";
     const stempel = stempelAus(inhalt);
     if (stempel === null)
         return "veraltet";
+    if (stempelSpracheAus(inhalt) !== sprache)
+        return "veraltet";
     return istAelter(stempel, eigeneVersion) ? "veraltet" : "still";
 }
 /**
- * ⚠️ Sie nennt den Befehl, sie FUEHRT IHN NICHT AUS. Ein Befehl darf nicht
- * mehr tun, als sein Name verspricht -- die Regel steht schon in kimal3.ts.
+ * Muss `kimal3 login` Claudes Anleitung umstellen? (Gesamt-Review Teil 4, Important 1)
+ *
+ * 🔑 NUR die Sprache entscheidet, nicht die Fassung: Auf `/pro` laeuft `skill install` VOR dem Login --
+ * ohne Merkzettel in der Sprache des Betriebssystems. Nach dem Login kennt das Programm die Kontosprache;
+ * weicht der Stempel ab, stellt der Login um. Eine aeltere Fassung in der RICHTIGEN Sprache meldet weiter
+ * die taegliche Pruefung (`skillZustand`) -- der Login schreibt nichts, wozu er keinen Anlass hat.
+ *
+ * ⚠️ Ohne Datei oder ohne Stempel: `false`. Eine Datei ohne Stempel ist von vor 0.1.5 oder nicht von uns --
+ * die fasst der Login nicht an (Lagen-Tabelle L3, L8 in docs/qa/2026-10-02-mehrsprachig-teil-4-messungen.md).
  */
-export function skillMeldung() {
-    return "\n  →  Deine kimal3-Skilldateien sind aelter als die CLI.  kimal3 skill install\n";
+export function skillTauschNoetig(inhalt, sprache) {
+    return inhalt !== null && stempelAus(inhalt) !== null && stempelSpracheAus(inhalt) !== sprache;
 }
 /**
  * Zerlegt den Kopf `X-Kimal3-Kontext-Stand`: `<firmen-id>:<stand>` (Task 10).
@@ -322,12 +346,12 @@ export function kontextStandAusKopf(wert) {
  * 🔑 US-8: `firmenName` steht IM TEXT, nicht nur die ID -- wer in zwei Firmen
  * ist, muss lesen koennen, WELCHE gemeint ist.
  */
-export function firmenHinweisAus(lokalerStand, serverStand, firmenName) {
+export function kontextHinweisAus(lokalerStand, serverStand, text) {
     if (lokalerStand === serverStand)
         return null;
     return {
         id: `${KONTEXT_HINWEIS_PRAEFIX}${serverStand}`,
-        text: `${firmenName} hat den Firmenkontext aktualisiert.  kimal3 kontext runter`,
+        text,
         gilt_unter_version: null,
     };
 }

package/dist/projekt-neu-firma.js

@@ -1,4 +1,6 @@
-import { alsBefehlszeile } from "./argumente.js";
+import { alsBefehlszeile, schalterOhneWert } from "./argumente.js";
+import { schalterIn } from "./befehlswoerter.js";
+import { PROJEKTE_TEXTE } from "./texte/projekte.js";
 /**
  * Der Firmenwunsch bei `projekt neu` -- herausgeloest aus `befehle/projekt-neu.ts`,
  * damit `check:cli` ihn als reine Rechnung pruefen kann (Final-Review F-1).
@@ -21,10 +23,8 @@ import { alsBefehlszeile } from "./argumente.js";
  * gewacht wurde.
  */
 export function ohneFirmaAusArgv(argv) {
-    return {
-        rest: argv.filter((a) => a !== "--ohne-firma"),
-        ohneFirma: argv.includes("--ohne-firma"),
-    };
+    const { gesetzt, rest } = schalterOhneWert(argv, "ohne-firma");
+    return { rest, ohneFirma: gesetzt };
 }
 /**
  * Schritt 2, nach `zerlege`: aus Firmenname, Firmen-ID und dem Schalter den
@@ -38,11 +38,11 @@ export function ohneFirmaAusArgv(argv) {
  * CLI die widerspruechliche Eingabe VORHER ab -- wie beim fehlenden `--titel`
  * daneben.
  */
-export function firmenKoerperAus(firma, firmaId, ohneFirma) {
+export function firmenKoerperAus(firma, firmaId, ohneFirma, s) {
     if (ohneFirma && (firma || firmaId)) {
         return {
             ok: false,
-            meldung: 'Entweder --ohne-firma ODER --firma/--firma-id -- nenn nur eines von beiden.',
+            meldung: PROJEKTE_TEXTE[s].companyConflict,
         };
     }
     return { ok: true, koerper: { firma: firma ?? "", firma_id: firmaId ?? "", ohne_firma: ohneFirma } };
@@ -63,12 +63,12 @@ export function firmenKoerperAus(firma, firmaId, ohneFirma) {
  * `o` an (s. `ohneFirmaAusArgv` oben) und braucht deshalb keinen eigenen
  * Ausschluss.
  */
-export function befehlszeileOhneFirma(o) {
+export function befehlszeileOhneFirma(o, s) {
     const teile = [];
     for (const [name, wert] of Object.entries(o)) {
         if (name === "firma" || name === "firma-id")
             continue;
-        teile.push(`--${name}`, wert);
+        teile.push(`--${schalterIn(name, s)}`, wert);
     }
     return alsBefehlszeile(teile);
 }