fix(shell): zsh-Pflicht im Installer durchsetzen und benennen

Der Installer installiert zsh bei Bedarf selbst (apt-get, dnf, pacman, zypper, apk) und sagt das im Kopf und in der Ausgabe. Ohne zsh bricht der Shell-Teil jetzt VOR dem ersten Schreibzugriff ab (Exit 1, Befehl genannt, ~/.zshrc unangetastet), statt einen wirkungslosen Prompt-Eintrag zu hinterlassen. install_zsh meldet Erfolg nur bei echtem Fund im PATH, chsh-Fehler werden gemeldet, Abschlusszeile nennt Exit-Status.

CHANGELOG.md

@@ -4,6 +4,17 @@ Format: Datum — was — warum. Die CI beginnt versioniert am 2026-10-23; davor
 sie verstreut (Marke in `brand/`, Dokument-CSS im Open-WebUI-Skill) und wurde nicht
 versioniert.
 
+## 1.3.1 — 2026-11-02
+
+- **zsh ist Pflicht, und das Skript sagt es jetzt auch.** `shell/install.sh` installiert zsh
+  bei Bedarf selbst (apt-get, dnf, pacman, zypper, apk) und schreibt das in den Kopf und in
+  die Ausgabe. Geht es nicht — kein Paketmanager oder `sudo` ohne Passwort — bricht der
+  Shell-Teil **vor dem ersten Schreibzugriff** ab, nennt den genauen Befehl und endet mit
+  Exit 1; `~/.zshrc` bleibt unangetastet, statt einen wirkungslosen Prompt-Eintrag zu
+  hinterlassen. Ein `chsh`-Fehlschlag wird gemeldet statt verschluckt, und die Abschlusszeile
+  nennt Exit-Status und naechsten Schritt.
+- `install_zsh` meldet Erfolg nur noch, wenn `zsh` danach wirklich im `PATH` liegt.
+
 ## 1.3.0 — 2026-11-02
 
 - **Die CI reicht bis in die Shell.** `shell/prompt.zsh` rendert einen zweizeiligen Prompt
@@ -11,6 +22,9 @@ versioniert.
   `themes/kalina-ci-dark.json`: Tinte `#0B0F14`, Knochenweiß `#F5F5EF`, Markenrot `#C1121F`
   nur als Grafik, Text-Rot `#E0454F` (4,70:1), Salbei `#7FA88C` nur an Git. Ausgerollt auf vier
   Maschinen (Arbeitsplatz, Laptop, iMac, Gast-VM); die Pixelprobe zeigt auf jeder `#0B0F14`.
+- **Die Startseite traegt Vorschaubild und Marke.** `assets/vorschau.png` (1200 × 630) zeigt
+  Deckblatt, Prompt und Token in einem Bild; `assets/vorschau-shell.png` steht im Shell-Abschnitt,
+  `assets/logo-platte.png` ist die Marke auf Knochenweiss (lesbar auf hellem wie dunklem Gitea).
 - **`shell/install.sh` richtet weitere Maschinen ohne meinen Zugriff ein.** Idempotent, sichert
   jede Datei nach `.vor-kalina-ci-<stempel>`, erkennt foot, qterminal, xfce4-terminal und xterm
   und prüft anschließend mit `zsh -n`, `foot --check-config` und `xrdb`-Query. Aufruf per

README.md

@@ -1,3 +1,5 @@
+![KALINA](assets/logo-platte.png)
+
 # KALINA CI
 
 Corporate Identity der KALINA als versioniertes Artefakt: eine Satzvorlage (CSS),
@@ -6,10 +8,12 @@ die alle drei Wege bedient — und seit 1.3.0 dieselbe Farbwelt für Shell und T
 **Ein Dokument, das nach KALINA aussehen soll, nimmt diese Dateien — keine nachgebauten
 Farben, kein selbst gezeichnetes Logo.**
 
+![Vorschau: Deckblatt aus der Vorlage, Prompt in der Shell, Token in der Fußlinie](assets/vorschau.png)
+
 ```
 css/kalina-ci.css          Satzvorlage: @page A4, Kopfleiste, Tabellen, Plakette, Fußlinie
 templates/                 report.html · page.html · bild-mit-prompt.html
-assets/                    kalina-mark.svg · kalina-wordmark.svg · kalina-logo-combined.svg · favicon/
+assets/                    Marke als SVG (mark · wordmark · combined · favicon) + Vorschaubilder
 scripts/stamp_existing_pdf.py   fremdes PDF mit Deckblatt/Marke/Fußzeile versehen
 shell/install.sh           Shell-Prompt und Terminal-Palette auf einer Maschine einrichten
 shell/prompt.zsh           zsh-Prompt als eigenständiges Modul (kein oh-my-zsh, kein p10k)
@@ -51,6 +55,14 @@ Prompt, Terminal-Palette, ein Skript für beides.
 └─ ❯
 ```
 
+![Der Prompt in einem Terminal mit CI-Palette](assets/vorschau-shell.png)
+
+> **zsh ist Pflicht.** Der Prompt ist ein zsh-Modul; in bash passiert nichts. Das Skript
+> installiert zsh selbst — `apt-get`, `dnf`, `pacman`, `zypper` oder `apk`, je nach System.
+> Fehlt der Paketmanager oder verlangt `sudo` ein Passwort, **bricht der Shell-Teil ab**, nennt
+> den genauen Befehl und lässt `~/.zshrc` unangetastet: lieber kein Prompt als ein stummer.
+> Danach einmal neu einloggen (oder `exec zsh`), sonst greift die Login-Shell-Änderung nicht.
+
 ```bash
 curl -fsSLo install.sh https://gitea.m-m.bio/mm/kalina-ci/raw/branch/main/shell/install.sh
 bash install.sh --dry-run   # zeigt, was passieren würde
@@ -59,7 +71,7 @@ bash install.sh             # führt es aus
 
 Kein Token nötig — das Repo ist öffentlich lesbar. Das Skript ist idempotent, sichert jede
 Datei nach `.vor-kalina-ci-<stempel>` und erkennt **foot**, **qterminal**, **xfce4-terminal**
-und **xterm**; zsh installiert es über den vorhandenen Paketmanager. Schalter:
+und **xterm**. Schalter:
 `--shell-only`, `--terminal-only`, `--no-chsh`. Details und die Fallen beim Ausrollen stehen in
 [`shell/README.md`](shell/README.md).
 

SKILL.md

@@ -2,7 +2,7 @@
 name: kalina-ci
 description: Use when a PDF, page or slide must carry the KALINA corporate identity. One CSS, one CLI, one source.
 metadata:
-  version: "1.3.0"
+  version: "1.3.1"
   stand: "2026-11-02"
 ---
 
@@ -164,6 +164,11 @@ curl -fsSLo install.sh https://gitea.m-m.bio/mm/kalina-ci/raw/branch/main/shell/
 bash install.sh --dry-run && bash install.sh
 ```
 
+**zsh ist Pflicht** — der Prompt ist ein zsh-Modul. Das Skript installiert zsh bei Bedarf
+selbst; kann es das nicht (kein Paketmanager, `sudo` ohne Passwort), bricht der Shell-Teil mit
+Exit 1 ab und nennt den Befehl, statt einen wirkungslosen `~/.zshrc`-Eintrag zu hinterlassen.
+Danach `exec zsh` oder neu einloggen, sonst greift die Login-Shell nicht.
+
 Das Skript ist idempotent, sichert jede Datei und erkennt foot, qterminal, xfce4-terminal
 sowie xterm. Die Paletten sind gemessen, nicht geraten — die drei Fallen (qtermwidget6
 kennt kein Benutzerverzeichnis, xfconf überstimmt `terminalrc`, foot will `[colors-dark]`)

assets/VORSCHAU.md

@@ -0,0 +1,44 @@
+# Vorschaubilder
+
+Die Bilder auf der Startseite sind **erzeugt, nicht gemalt**. Wer sie erneuert, baut sie neu —
+und prüft dabei die Farben, statt sie zu behaupten.
+
+## `vorschau.png` (1200 × 630)
+
+Zusammengesetzt aus zwei echten Erzeugnissen dieses Repos:
+
+1. **Deckblatt** — `templates/report.html` mit ausgefüllten Platzhaltern, gebaut über
+   `tools/kalina-pdf build bericht.html -o bericht.pdf` (die Prüfung muss grün sein), dann
+   `pdftoppm -png -r 140 -f 1 -l 1 bericht.pdf ber`.
+2. **Terminal** — ein echter `qterminal` mit dem CI-Schema auf einem eigenen Display:
+   `Xvfb :77`, `XDG_DATA_DIRS=$HOME/.local/share/qterminal-ci:…`, Fenster per `xdotool`
+   beschriften, `xwd` dumpen, die 20 px Menüleiste oben abschneiden.
+
+Danach beide Bilder in ein HTML im Maß 1200 × 630 px setzen (Grund `#0B0F14`, Wortmarke
+`assets/kalina-wordmark.svg`, Fußlinie mit den Token-Werten) und über WeasyPrint rendern:
+
+```bash
+weasyprint vorschau.html vorschau.pdf && pdftoppm -png -r 96 vorschau.pdf v
+```
+
+## `vorschau-shell.png` (880 px breit)
+
+Nur das Terminal-Bild, gleicher Weg. Gezeigt wird der Prompt aus `shell/prompt.zsh` mit dem
+Zeitsegment (dauert eine Eingabe ≥ 2 s, erscheint `· 2.4s`).
+
+## `logo-platte.png`
+
+`assets/logo.png` auf `#F5F5EF` gesetzt (`-trim`, 22 px Rand). Nötig, weil die Marke in Tinte
+gezeichnet ist und auf einem dunklen Theme sonst verschwindet — die Platte trägt sie auf beiden.
+
+## Gegenprobe
+
+Nach dem Erzeugen nicht auf das Auge verlassen, sondern zählen:
+
+```bash
+convert vorschau-shell.png -format %c -depth 8 histogram:info:- | sort -rn | head -3
+```
+
+Der Grund muss `#0B0F14` sein (über 85 % der Fläche), der Text `#F5F5EF`, Rot `#C1121F`
+beziehungsweise `#E0454F` nur als Akzent. Erscheint Weiß oder Schwarz als häufigste Farbe,
+ist die Palette nicht geladen — dann nicht abschneiden, sondern die Ursache suchen.

shell/README.md

@@ -19,6 +19,31 @@ kein oh-my-zsh und kein powerlevel10k noetig.
 | Steel | `#3A4250` | Linien |
 | Muted | `#8A94A2` | Hostname |
 
+## zsh ist Pflicht
+
+Der Prompt ist zsh-Syntax in `~/.zshrc`. In bash, fish oder sh passiert nichts — auch dann
+nicht, wenn die Datei korrekt geschrieben wurde. Deshalb:
+
+1. **Fehlt zsh, installiert `install.sh` ihn selbst** — `apt-get`, `dnf`, `pacman`, `zypper`
+   oder `apk`, je nach System. Der Versuch steht als erste Zeile im Shell-Teil.
+2. **Geht das nicht** (kein bekannter Paketmanager, oder `sudo` verlangt ein Passwort ohne
+   `-n`), bricht der Shell-Teil **vor** dem ersten Schreibzugriff ab, nennt den genauen Befehl
+   und endet mit Exit 1. `~/.zshrc` bleibt dann unangetastet — ein Eintrag dort waere in bash
+   ohnehin wirkungslos.
+3. **Login-Shell**: `chsh -s <zsh>` laeuft am Ende (abschaltbar mit `--no-chsh`). Wirksam wird
+   es erst in der naechsten Sitzung: `exec zsh` fuer sofort, sonst neu einloggen.
+
+Wer zsh von Hand nachzieht:
+
+```sh
+sudo apt-get install -y zsh     # Debian/Ubuntu
+sudo dnf install -y zsh         # Fedora
+sudo pacman -S --needed zsh     # Arch
+sudo zypper install -y zsh      # openSUSE
+sudo apk add zsh                # Alpine
+bash install.sh                 # danach erneut
+```
+
 ## Installation auf einer neuen Maschine
 
 ```sh
@@ -38,7 +63,7 @@ und laesst sich in Teilen fahren:
 | `--dry-run` | nichts schreiben, nur anzeigen |
 | `--shell-only` | nur zsh + Prompt |
 | `--terminal-only` | nur Terminal-Palette |
-| `--no-chsh` | Login-Shell nicht umstellen |
+| `--no-chsh` | Login-Shell nicht umstellen (Prompt bleibt, bis du `zsh` startest) |
 
 Erkannt und eingerichtet werden: **foot** (`~/.config/foot/foot.ini`,
 `[colors-dark]`), **qterminal** (`~/.local/share/qterminal-ci/…/KalinaCI.colorscheme`

shell/install.sh

@@ -10,6 +10,12 @@
 #   ./install.sh --terminal-only # nur Terminal-Palette
 #   ./install.sh --no-chsh       # Login-Shell nicht anfassen
 #
+# zsh ist Pflicht: der Prompt ist ein zsh-Modul, in bash wirkt er nicht. Fehlt zsh,
+# installiert dieses Skript ihn selbst (apt-get, dnf, pacman, zypper, apk). Geht das
+# nicht — kein Paketmanager oder sudo ohne Passwort — bricht der Shell-Teil ab und
+# nennt den genauen Befehl zum Nachholen. Ein halb eingerichtetes ~/.zshrc hilft
+# niemandem, deshalb lieber kein Prompt als ein stummer.
+#
 # Grundsaetze: jede Datei wird vorher gesichert (.vor-kalina-ci-<stempel>),
 # jeder Block ist an einem Marker erkennbar und wird nicht doppelt geschrieben,
 # jede veraenderte Datei wird anschliessend mit dem passenden Pruefer getestet.
@@ -26,6 +32,7 @@ SRC_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 RAW="${KALINA_CI_RAW:-https://gitea.m-m.bio/mm/kalina-ci/raw/branch/main/shell}"
 
 DRY=0; DO_SHELL=1; DO_TERM=1; DO_CHSH=1
+ZSH_OK=0   # 1 = zsh vorhanden oder installiert; 0 = Prompt kann nicht greifen
 for arg in "$@"; do
   case "$arg" in
     --dry-run)       DRY=1 ;;
@@ -58,6 +65,11 @@ fi
 
 install_zsh() {
   command -v zsh >/dev/null && { ok "zsh vorhanden: $(zsh --version)"; return 0; }
+  if [ "$DRY" = 1 ]; then
+    say "  zsh fehlt — ein echter Lauf wuerde ihn jetzt installieren (ohne zsh kein Prompt)."
+  else
+    say "  zsh fehlt — wird jetzt installiert (ohne zsh kein Prompt)."
+  fi
   local pm=""
   for c in apt-get dnf pacman zypper apk; do command -v "$c" >/dev/null && pm="$c" && break; done
   [ -n "$pm" ] || { warn "kein bekannter Paketmanager — zsh bitte von Hand installieren"; return 1; }
@@ -76,10 +88,15 @@ install_zsh() {
     apt-get) run $SUDO env DEBIAN_FRONTEND=noninteractive apt-get install -y zsh ;;
     dnf)     run $SUDO dnf install -y zsh ;;
     pacman)  run $SUDO pacman -S --needed --noconfirm zsh ;;
-    zypper)  run $SUDO zypper --non-interactive install zsh ;;
-    apk)     run $SUDO apk add zsh ;;
+    zypper)  $SUDO zypper --non-interactive install zsh ;;
+    apk)     $SUDO apk add zsh ;;
   esac
-  command -v zsh >/dev/null && ok "zsh installiert: $(zsh --version)" || warn "zsh weiterhin nicht auffindbar"
+  if command -v zsh >/dev/null; then
+    ok "zsh installiert: $(zsh --version)"
+    return 0
+  fi
+  warn "zsh ist nach der Installation nicht auffindbar — PATH pruefen"
+  return 1
 }
 
 # Block mit Markern an eine Datei anhaengen (nicht doppelt)
@@ -101,7 +118,17 @@ append_block() {
 # ------------------------------------------------------------------ Shell
 do_shell() {
   step "Shell (zsh + Kalina-CI-Prompt)"
-  install_zsh || true
+
+  # Ohne zsh gibt es keinen Prompt: das Modul ist zsh-Syntax in ~/.zshrc. Wer in bash
+  # sitzt, sieht davon nichts — also erst zsh, dann alles andere.
+  if ! command -v zsh >/dev/null && [ "$DRY" = 1 ]; then
+    install_zsh || true
+    warn "Trockenlauf: ein echter Lauf wuerde zsh zuerst installieren, sonst gaebe es keinen Prompt"
+  elif ! install_zsh; then
+    warn "Shell-Teil abgebrochen — ohne zsh wirkt der Prompt nicht (kein ~/.zshrc-Eintrag geschrieben)."
+    warn "zsh nachholen (Befehl oben), dann dieses Skript erneut starten."
+    return 1
+  fi
 
   run mkdir -p "$CONF_DIR"
   if [ -f "$SRC_DIR/prompt.zsh" ]; then
@@ -170,13 +197,26 @@ RC
   fi
 
   # Login-Shell
-  local cur; cur="$(getent passwd "$(id -un)" | cut -d: -f7)"
-  if [ "$cur" = "$(command -v zsh 2>/dev/null)" ]; then
+  local cur zshbin; cur="$(getent passwd "$(id -un)" | cut -d: -f7)"
+  zshbin="$(command -v zsh 2>/dev/null)"
+  if [ -z "$zshbin" ]; then
+    warn "zsh nicht gefunden — Login-Shell bleibt $cur, Prompt erscheint nicht"
+    return 0
+  fi
+  ZSH_OK=1
+  if [ "$cur" = "$zshbin" ]; then
     ok "Login-Shell ist bereits zsh"
   elif [ "$DO_CHSH" = 0 ]; then
-    warn "Login-Shell bleibt $cur (--no-chsh); Start mit 'exec zsh' oder 'chsh -s $(command -v zsh)'"
+    warn "Login-Shell bleibt $cur (--no-chsh). Bis du zsh startest, siehst du den Prompt nicht:"
+    say "    exec zsh        # nur diese Sitzung"
+    say "    chsh -s $zshbin   # dauerhaft"
   else
-    run $SUDO chsh -s "$(command -v zsh)" "$(id -un)" && ok "Login-Shell auf zsh gestellt (greift beim naechsten Login)"
+    if run $SUDO chsh -s "$zshbin" "$(id -un)"; then
+      ok "Login-Shell auf zsh gestellt — greift beim naechsten Login (nicht in dieser Sitzung)"
+    else
+      warn "chsh fehlgeschlagen; Login-Shell bleibt $cur. Von Hand: chsh -s $zshbin"
+      warn "Sofort testen: exec zsh"
+    fi
   fi
 }
 
@@ -446,10 +486,20 @@ XRES
 say "Kalina CI — Installation auf $(hostname), Ziel $HOME"
 [ "$DRY" = 1 ] && say "(Probelauf: es wird nichts geschrieben)"
 
-[ "$DO_SHELL" = 1 ] && do_shell
+RC=0
+[ "$DO_SHELL" = 1 ] && { do_shell || RC=1; }
 [ "$DO_TERM" = 1 ] && do_terminal
 
+say ""
 step "Fertig"
-say "  Prompt pruefen:   zsh -i   (oder neue Terminal-Sitzung)"
+if [ "$RC" = 0 ] && [ "$ZSH_OK" = 1 ]; then
+  ok "neu starten: exec zsh — oder einmal neu einloggen (Login-Shell greift erst dann)"
+elif [ "$RC" = 0 ]; then
+  warn "ohne zsh kein Prompt — im echten Lauf bricht der Shell-Teil hier ab"
+else
+  warn "mit Fehlern beendet (Exit 1) — oben steht, was fehlt; erneut starten, sobald es da ist"
+fi
+say "  Prompt pruefen:   zsh -i"
 say "  Abschalten:       KALINA_CI_PROMPT=0 zsh -i"
 say "  Palette pruefen:  Terminal neu starten; nach environment.d-Aenderung einmal neu anmelden"
+exit "$RC"