kimal3 0.6.3 → 0.6.5

package/dist/logo-ablegen.js

@@ -1,11 +1,12 @@
 import { cpSync, existsSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { basename, dirname, join } from "node:path";
+import { homedir, platform } from "node:os";
+import { basename, dirname, join, posix, win32 } from "node:path";
 import { fileURLToPath } from "node:url";
 import { EINRICHTEN_TEXTE } from "./texte/einrichten.js";
+import { eigeneVersion } from "./version.js";
 /**
  * Legt den Plugin-Katalog mit dem Logo-Mod in `~/.kimal3/claude-plugins` ab und setzt dort die
- * Sprache des Kontos. Claude Code liest den Mod aus genau diesem Ordner (Katalog `kimal3`,
+ * Sprache des Kontos und die Ablage (`mitAblage`). Claude Code liest den Mod aus genau diesem Ordner (Katalog `kimal3`,
  * `plugins-mischen.ts`).
  *
  * 🔑 Warum ein fester Ordner im Benutzerordner und nicht der Ordner im installierten npm-Paket:
@@ -24,10 +25,64 @@ export function mitSprache(quelltext, sprache) {
         return null;
     return quelltext.replace(SPRACH_ZEILE, `const SPRACHE: 'de' | 'en' = '${sprache}'`); // kein-anzeigetext: Quelltext des Mods
 }
+/** Die Zeile im Mod, die beim Ablegen die Ablage bekommt; im Paket steht dort die leere. */
+export const ABLAGE_ZEILE = "const ABLAGE: Ablage = KEINE_ABLAGE"; // kein-anzeigetext: Quelltext des Mods
+/**
+ * Reine Rechnung: der Mod-Text mit der Ablage, oder `null`, wenn die Zeile nicht genau einmal dasteht. Ohne Ablage
+ * (keine eigene Fassung) bleibt die leere Zeile stehen -- der Mod zeigt dann wie bisher nur das Logo (U-9).
+ * 🔴 `split`/`join`, nie `replace(zeile, text)`: Im Ersatz-Text eines `replace` sind `$&` und `$'` Befehle, und ein
+ * Ordnername darf beides enthalten -- dann stünde fremder Quelltext im Mod (messen-und-pruefen §23, U-16). `JSON.stringify`
+ * macht aus jedem Wert ein gültiges Stück Quelltext, auch mit `"` und `\` (Windows-Pfade).
+ */
+export function mitAblage(quelltext, ablage) {
+    const teile = quelltext.split(ABLAGE_ZEILE);
+    if (teile.length !== 2)
+        return null;
+    return ablage === null ? quelltext : teile.join(`const ABLAGE: Ablage = ${JSON.stringify(ablage)}`); // kein-anzeigetext: Quelltext des Mods
+}
+/**
+ * Reine Rechnung hinter `ablageWerte`. Ohne eigene Fassung keine Ablage (`null`).
+ * `npm` ist das `npm-cli.js`, das zu DIESEM Node gehört (Windows daneben, sonst unter `lib/`), und nur dann gesetzt, wenn
+ * es die Datei gibt und `kimal3` global installiert läuft. Sonst `""`: Der Knopf bittet dann Claude (U-10), statt ein
+ * `npm install -g` anzustoßen, nach dem `kimal3 --version` doch die alte Zahl sagte.
+ * 🔑 Global heißt, als Erlaubnisliste (messen-und-pruefen §23): `…/node_modules/kimal3/…` mit genau EINEM `node_modules`,
+ * ohne `_npx` (der Zwischenspeicher von `npx`), und über dem `node_modules` kein `package.json` (sonst ist es der Ordner
+ * eines Projekts). Ein Start aus dem Repo (`cli/dist`) ist damit auch nicht global.
+ */
+export function ablageAus(lage) {
+    if (lage.fassung === null)
+        return null;
+    const p = lage.system === "win32" ? win32 : posix;
+    const npm = lage.system === "win32"
+        ? p.join(p.dirname(lage.node), "node_modules", "npm", "bin", "npm-cli.js") // kein-anzeigetext: Pfad
+        : p.join(p.dirname(p.dirname(lage.node)), "lib", "node_modules", "npm", "bin", "npm-cli.js"); // kein-anzeigetext: Pfad
+    const teile = lage.kimal3.split(/[\\/]/);
+    const i = teile.indexOf("node_modules");
+    const global = i > 0 && teile.lastIndexOf("node_modules") === i && teile[i + 1] === "kimal3" && !teile.includes("_npx")
+        && !lage.gibtEs(p.join(teile.slice(0, i).join(p.sep), "package.json"));
+    return {
+        fassung: lage.fassung,
+        node: lage.node,
+        npm: global && lage.gibtEs(npm) ? npm : "",
+        kimal3: lage.kimal3,
+        kimal3Ordner: p.join(lage.heim, ".kimal3"), // kein-anzeigetext: Ordnername
+    };
+}
+/** Die Ablage dieses Rechners, im laufenden `kimal3` gemessen (Bauplan 2026-10-23, Tabelle in 1.1). */
+export function ablageWerte() {
+    return ablageAus({
+        fassung: eigeneVersion(),
+        node: process.execPath,
+        kimal3: fileURLToPath(new URL("./kimal3.js", import.meta.url)), // kein-anzeigetext: Dateiname
+        heim: homedir(),
+        system: platform(),
+        gibtEs: existsSync,
+    });
+}
 /**
  * 🔴 NIE EIN HALBER ORDNER (Durchsicht-Funde 2 und 9): Claudes Einstellungen zeigen auf `katalogOrdner()`,
  * und eine laufende Claude-Sitzung hat den Mod daraus geladen. Deshalb:
- *   1. Sprache setzen, BEVOR irgendetwas angefasst wird -- fehlt die Zeile, bleibt alles, wie es war.
+ *   1. Sprache und Ablage setzen, BEVOR irgendetwas angefasst wird -- fehlt eine der Zeilen, bleibt alles, wie es war.
  *   2. Steht schon genau das da, was entstehen soll: nichts anfassen (Lage P-8). Das ist auch der Normalfall
  *      eines zweiten Laufs, und so kommt er gar nicht erst in die Nähe der Windows-Sperren unten.
  *   3. Den neuen Ordner daneben fertig bauen (`….neu`), dann tauschen: alten Ordner wegschieben, neuen an
@@ -46,7 +101,8 @@ export function logoAblegen(sprache) {
     const neu = `${ziel}.neu`; // kein-anzeigetext: Ordnername
     const modDatei = (ordner) => join(ordner, "kimal3-logo", "hooks", "register.tsx");
     try {
-        const text = mitSprache(readFileSync(modDatei(quelle), "utf8"), sprache);
+        const mitSpr = mitSprache(readFileSync(modDatei(quelle), "utf8"), sprache);
+        const text = mitSpr === null ? null : mitAblage(mitSpr, ablageWerte());
         if (text === null)
             return { ok: false, detail: modDatei(quelle) };
         if (stehtSchonDa(quelle, ziel, text)) {
@@ -102,7 +158,7 @@ export function frischeLogoAuf(s) {
     else if (ablage.stand === "alt")
         console.log(t.logoNotRefreshed);
 }
-/** Gleiche Dateien, gleicher Inhalt -- der Mod mit der Sprache des Kontos, alles andere wie im Paket. */
+/** Gleiche Dateien, gleicher Inhalt -- der Mod mit Sprache und Ablage, alles andere wie im Paket. */
 function stehtSchonDa(quelle, ziel, modText) {
     if (!existsSync(ziel))
         return false;

package/dist/texte/wache.js

@@ -2,8 +2,8 @@ const de = {
     accessExpired: (login) => "🔴🔴🔴 kimal3: Dein Zugang ist abgelaufen — zum Beispiel nach einem neuen Passwort " +
         `oder einer längeren Pause. Melde dich neu an mit:  ${login}  🔴🔴🔴`,
     messageFromKimal3: (text) => `Nachricht von kimal3: „${text}“`,
-    newVersion: (neu, eigene) => `🟡🟡🟡 kimal3: Es gibt eine neuere Version: ${neu} (du hast ${eigene}). ` +
-        `Holen mit:  ! npm install -g kimal3@${neu}  🟡🟡🟡`,
+    newVersion: (neu, eigene, skill) => `🟡🟡🟡 kimal3: Es gibt eine neuere Version: ${neu} (du hast ${eigene}). ` +
+        `Holen mit:  ! npm install -g kimal3@${neu}  — danach:  ${skill}  🟡🟡🟡`,
     skillsOld: (befehl) => "🟡🟡🟡 kimal3: Deine /k3-Befehle in Claude sind veraltet oder in einer anderen Sprache als dein Konto. " +
         `Auffrischen:  ${befehl}  🟡🟡🟡`,
     instructionToClaude: "Anweisung an Claude: Gib die Zeilen oben dem Menschen als ERSTE Zeilen deiner nächsten " +
@@ -20,8 +20,8 @@ const en = {
     accessExpired: (login) => "🔴🔴🔴 kimal3: Your sign-in has expired, for example after a new password " +
         `or a long break. Sign in again with:  ${login}  🔴🔴🔴`,
     messageFromKimal3: (text) => `Message from kimal3: “${text}”`,
-    newVersion: (neu, eigene) => `🟡🟡🟡 kimal3: A newer version is available: ${neu} (you have ${eigene}). ` +
-        `Install it with:  ! npm install -g kimal3@${neu}  🟡🟡🟡`,
+    newVersion: (neu, eigene, skill) => `🟡🟡🟡 kimal3: A newer version is available: ${neu} (you have ${eigene}). ` +
+        `Install it with:  ! npm install -g kimal3@${neu}  — then:  ${skill}  🟡🟡🟡`,
     skillsOld: (befehl) => "🟡🟡🟡 kimal3: Your /k3 commands in Claude are out of date or in a different language from your account. " +
         `Update them:  ${befehl}  🟡🟡🟡`,
     instructionToClaude: "Instruction to Claude: Show the lines above to the person verbatim, in bold, as the FIRST lines of " +

package/dist/wache-rechnung.js

@@ -49,7 +49,9 @@ export function wacheBefunde(lage, s) {
         istAelter(lage.eigeneVersion, lage.neuesteVersion)) {
         befunde.push({
             art: "version",
-            zeile: T.newVersion(lage.neuesteVersion, lage.eigeneVersion),
+            // Zwei Befehle GETRENNT, nie mit `&&` verbunden: Die Windows-PowerShell 5.1 kennt `&&` nicht, und
+            // ohne `skill install` bleiben Claudes /k3-Befehle auf der alten Fassung (Spec Update in der Leiste, E-4).
+            zeile: T.newVersion(lage.neuesteVersion, lage.eigeneVersion, tippen("skill install", s)), // kein-anzeigetext: Befehlsname
         });
     }
     if (lage.skillVeraltet) {

package/package.json

@@ -1,30 +1,30 @@
-{
-  "name": "kimal3",
-  "version": "0.6.3",
-  "description": "Trag deine KI-Projekte dort ein, wo sie entstehen: im Terminal. · Log your AI projects where they happen: in the terminal.",
-  "type": "module",
-  "bin": {
-    "kimal3": "dist/kimal3.js"
-  },
-  "files": [
-    "dist",
-    "skill",
-    "claude-plugins",
-    "coach",
-    "zeigen",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "scripts": {
-    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "kimal3",
-    "cli"
-  ],
-  "homepage": "https://app.kimal3.de/pro",
-  "license": "SEE LICENSE IN README.md"
-}
+{
+  "name": "kimal3",
+  "version": "0.6.5",
+  "description": "Trag deine KI-Projekte dort ein, wo sie entstehen: im Terminal. · Log your AI projects where they happen: in the terminal.",
+  "type": "module",
+  "bin": {
+    "kimal3": "dist/kimal3.js"
+  },
+  "files": [
+    "dist",
+    "skill",
+    "claude-plugins",
+    "coach",
+    "zeigen",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "kimal3",
+    "cli"
+  ],
+  "homepage": "https://app.kimal3.de/pro",
+  "license": "SEE LICENSE IN README.md"
+}

package/skill/commands/k3kurs.md

@@ -1,41 +1,41 @@
----
-description: Zurück in den Mini-Kurs — da weiter, wo du aufgehört hast
----
-
-<!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
-     jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
-     behalten will, kopiert die Datei unter einem anderen Namen. -->
-# Kurs
-
-> Zurück in den Mini-Kurs: „Wo war ich nochmal?" — macht da weiter, wo du aufgehört hast.
-> Den Stand holt `kimal3 kurs` frisch von kimal3 — dieselben Haken, die der Mensch im Browser unter
-> https://app.kimal3.de/kurs sieht.
-
-Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: Deutsch, freundlich, ein Schritt
-nach dem anderen, das Warum vor dem Wie, null Vorwissen vorausgesetzt.
-
-## 1. Den Stand holen
-- Führ `kimal3 kurs` aus (unter Windows so, wie es `SKILL.md` beschreibt).
-- Rückgabewert **2**: Der Mensch ist nicht angemeldet. Zeig ihm `kimal3 login`, lass ihn selbst im Browser bestätigen
-  und nenn **keinen** Kursstand.
-- Rückgabewert **3**: Der Stand ist gerade nicht abrufbar. Sag es in einem Satz und **erzähl den Kurs nicht aus dem
-  Gedächtnis**.
-- Kennt das Programm den Befehl nicht, ist es zu alt: Nenn `npm install -g kimal3@latest`, danach `kimal3 skill install`.
-
-## 2. Stand in einem Satz sagen
-- Sag in **einem** Satz, wo ihr im Kurs steht — aus der Ausgabe (Zeile `Kurs:`), nichts dazuerfinden. Kein Vortrag.
-
-## 3. Als Nächstes führen
-- Die Zeile `Als Nächstes:` nennt den nächsten Schritt. Führ **einen** Schritt nach dem anderen: zeigen, machen lassen,
-  verstehen. Nie die ganze Liste auf einmal.
-- Steht dahinter **„(du hakst ab)"** und hat der Mensch den Schritt offensichtlich schon getan (zum Beispiel „Claude ganz
-  beendet und neu geöffnet" — er sitzt ja gerade in Claude), führ ihn nicht noch einmal: Frag kurz nach und bitte ihn,
-  den Schritt unter https://app.kimal3.de/kurs abzuhaken.
-- Steht dahinter **„(setzt Claude)"** und ist er offen, lass die Einrichtung noch einmal laufen — über die Anleitung
-  `https://app.kimal3.de/einrichten` (lade sie wie der Kurs-Satz und folge ihr), **nicht** mit einem frei aufgerufenen
-  `kimal3 einrichten`. Bleibt der Schritt danach offen, nenn den Grund aus der Ausgabe von `einrichten` und schlag
-  keinen dritten Lauf vor.
-
-## 4. Abgeschlossen
-- Steht in der Ausgabe `Kurs: abgeschlossen`, gratuliere kurz und frag mit einem Vorschlag, woran er hier arbeiten
-  möchte. Kein Kurs-Gerede mehr.
+---
+description: Zurück in den Mini-Kurs — da weiter, wo du aufgehört hast
+---
+
+<!-- kimal3:erzeugt — diese Datei wird von `kimal3 skill install` gepflegt und bei
+     jedem Update ueberschrieben. Eigene Aenderungen gehen dabei verloren; wer sie
+     behalten will, kopiert die Datei unter einem anderen Namen. -->
+# Kurs
+
+> Zurück in den Mini-Kurs: „Wo war ich nochmal?" — macht da weiter, wo du aufgehört hast.
+> Den Stand holt `kimal3 kurs` frisch von kimal3 — dieselben Haken, die der Mensch im Browser unter
+> https://app.kimal3.de/kurs sieht.
+
+Führe die Schritte der Reihe nach aus. Bleib im Coaching-Ton: Deutsch, freundlich, ein Schritt
+nach dem anderen, das Warum vor dem Wie, null Vorwissen vorausgesetzt.
+
+## 1. Den Stand holen
+- Führ `kimal3 kurs` aus (unter Windows so, wie es `SKILL.md` beschreibt).
+- Rückgabewert **2**: Der Mensch ist nicht angemeldet. Zeig ihm `kimal3 login`, lass ihn selbst im Browser bestätigen
+  und nenn **keinen** Kursstand.
+- Rückgabewert **3**: Der Stand ist gerade nicht abrufbar. Sag es in einem Satz und **erzähl den Kurs nicht aus dem
+  Gedächtnis**.
+- Kennt das Programm den Befehl nicht, ist es zu alt: Nenn `npm install -g kimal3@latest`, danach `kimal3 skill install`.
+
+## 2. Stand in einem Satz sagen
+- Sag in **einem** Satz, wo ihr im Kurs steht — aus der Ausgabe (Zeile `Kurs:`), nichts dazuerfinden. Kein Vortrag.
+
+## 3. Als Nächstes führen
+- Die Zeile `Als Nächstes:` nennt den nächsten Schritt. Führ **einen** Schritt nach dem anderen: zeigen, machen lassen,
+  verstehen. Nie die ganze Liste auf einmal.
+- Steht dahinter **„(du hakst ab)"** und hat der Mensch den Schritt offensichtlich schon getan (zum Beispiel „Claude ganz
+  beendet und neu geöffnet" — er sitzt ja gerade in Claude), führ ihn nicht noch einmal: Frag kurz nach und bitte ihn,
+  den Schritt unter https://app.kimal3.de/kurs abzuhaken.
+- Steht dahinter **„(setzt Claude)"** und ist er offen, lass die Einrichtung noch einmal laufen — über die Anleitung
+  `https://app.kimal3.de/einrichten` (lade sie wie der Kurs-Satz und folge ihr), **nicht** mit einem frei aufgerufenen
+  `kimal3 einrichten`. Bleibt der Schritt danach offen, nenn den Grund aus der Ausgabe von `einrichten` und schlag
+  keinen dritten Lauf vor.
+
+## 4. Abgeschlossen
+- Steht in der Ausgabe `Kurs: abgeschlossen`, gratuliere kurz und frag mit einem Vorschlag, woran er hier arbeiten
+  möchte. Kein Kurs-Gerede mehr.

package/skill/en/commands/k3course.md

@@ -1,41 +1,41 @@
----
-description: Back into the Mini course — pick up where you left off
----
-
-<!-- kimal3:erzeugt — this file is maintained by `kimal3 skill install` and
-     overwritten on every update. Your own changes will be lost; if you want
-     to keep them, copy the file under a different name. -->
-# Course
-
-> Back into the Mini course: “Where was I again?” — picks up where you left off.
-> `kimal3 course` fetches the status fresh from kimal3 — the same ticks the person sees in the browser at
-> https://app.kimal3.de/kurs.
-
-Carry out the steps in order. Stay in the coaching tone: English, friendly, one step at a
-time, the why before the how, no prior knowledge assumed.
-
-## 1. Fetch the status
-- Run `kimal3 course` (on Windows the way `SKILL.md` describes).
-- Exit code **2**: the person is not signed in. Show them `kimal3 login`, let them confirm in the browser themselves
-  and name **no** course status.
-- Exit code **3**: the status can't be fetched right now. Say so in one sentence and **do not retell the course from
-  memory**.
-- If the program doesn't know the command, it is too old: name `npm install -g kimal3@latest`, then `kimal3 skill install`.
-
-## 2. Say where you stand in one sentence
-- Say in **one** sentence where you are in the course — from the output (the `Course:` line), invent nothing. No lecture.
-
-## 3. Lead on with what comes next
-- The line `Next:` names the next step. Lead on **one** step at a time: show, let them do it, make sure they understand.
-  Never the whole list at once.
-- If it says **“(you tick it off)”** after it and the person has obviously already done the step (for example “closed
-  Claude completely and reopened it” — they are sitting in Claude right now), don't lead it again: ask briefly and
-  ask them to tick it off at https://app.kimal3.de/kurs.
-- If it says **“(Claude sets it)”** and it is open, run the setup once more — through the guide
-  `https://app.kimal3.de/setup` (load it the way the course sentence does and follow it), **not** with a freely called
-  `kimal3 setup`. If the step is still open afterwards, name the reason from the output of `setup` and don't suggest
-  a third run.
-
-## 4. Finished
-- If the output says `Course: complete`, congratulate them briefly and ask, with a suggestion, what they would like to
-  work on here. No more course talk.
+---
+description: Back into the Mini course — pick up where you left off
+---
+
+<!-- kimal3:erzeugt — this file is maintained by `kimal3 skill install` and
+     overwritten on every update. Your own changes will be lost; if you want
+     to keep them, copy the file under a different name. -->
+# Course
+
+> Back into the Mini course: “Where was I again?” — picks up where you left off.
+> `kimal3 course` fetches the status fresh from kimal3 — the same ticks the person sees in the browser at
+> https://app.kimal3.de/kurs.
+
+Carry out the steps in order. Stay in the coaching tone: English, friendly, one step at a
+time, the why before the how, no prior knowledge assumed.
+
+## 1. Fetch the status
+- Run `kimal3 course` (on Windows the way `SKILL.md` describes).
+- Exit code **2**: the person is not signed in. Show them `kimal3 login`, let them confirm in the browser themselves
+  and name **no** course status.
+- Exit code **3**: the status can't be fetched right now. Say so in one sentence and **do not retell the course from
+  memory**.
+- If the program doesn't know the command, it is too old: name `npm install -g kimal3@latest`, then `kimal3 skill install`.
+
+## 2. Say where you stand in one sentence
+- Say in **one** sentence where you are in the course — from the output (the `Course:` line), invent nothing. No lecture.
+
+## 3. Lead on with what comes next
+- The line `Next:` names the next step. Lead on **one** step at a time: show, let them do it, make sure they understand.
+  Never the whole list at once.
+- If it says **“(you tick it off)”** after it and the person has obviously already done the step (for example “closed
+  Claude completely and reopened it” — they are sitting in Claude right now), don't lead it again: ask briefly and
+  ask them to tick it off at https://app.kimal3.de/kurs.
+- If it says **“(Claude sets it)”** and it is open, run the setup once more — through the guide
+  `https://app.kimal3.de/setup` (load it the way the course sentence does and follow it), **not** with a freely called
+  `kimal3 setup`. If the step is still open afterwards, name the reason from the output of `setup` and don't suggest
+  a third run.
+
+## 4. Finished
+- If the output says `Course: complete`, congratulate them briefly and ask, with a suggestion, what they would like to
+  work on here. No more course talk.