BLUN King für macOS und Windows
===============================

Voraussetzung
-------------
Node.js 24.15 oder neuer muss installiert sein. npm gehört zur Node.js-Installation.
Unter Windows wird zusätzlich Git Bash aus Git for Windows benötigt.
Nach der Installation ein neues Terminal öffnen und mit node --version,
npm --version und git --version prüfen, ob die Programme gefunden werden.

Bei "Git Bash not found" Git for Windows installieren oder BLUN_SHELL_PATH
auf die vorhandene bash.exe setzen. Bei einem unbekannten npm-Befehl zuerst
die Node.js-Installation und den Suchpfad prüfen.

Kontext- und Sitzungsbefehle ab 9.1.604
-------------------------------------
/context doctor zeigt die ausführliche Kontextdiagnose, /queue die
Warteschlangenregel. /question öffnet noch ausstehende Rückfragen erneut.
/usage off, /usage tokens und /usage full ändern den Verbrauchsanzeigemodus.
/session wählt eine Sitzung aus, /settings öffnet die Einstellungen.

Die vollständige Syntax, Grenzen und Voraussetzungen stehen in README.md.
Anfrage-Bytes sind keine Tokenzahlen und kein Abrechnungsnachweis.

Installation
------------
Die geprüfte Version exakt global installieren:

  npm install -g blun-king-cli@9.1.605

Start
-----

  blun    Dieselbe CLI, ohne Telegram automatisch anzubinden
  king    Dieselbe CLI, mit automatisch angebundenem Telegram-Kanal

Beide Startbefehle verwenden dieselbe Version, dasselbe Konto, dasselbe Modell
und dieselben Befehle.

Nachweisbare Arbeitsabläufe
---------------------------

  blun proof       Prüfergebnisse und Artefakte mit SHA-256 belegen
  blun brief       Einen versionierten Projektauftrag anlegen
  blun handoff     Eine Sitzung zwischen CLI, Desktop und Web übergeben
  blun replay      Einen bereinigten Arbeitsverlauf erzeugen
  blun guard       Belegintegrität und aktuelle Artefakte prüfen
  blun demo        Eine bereinigte statische Projektdemo erzeugen
  blun workspace   Isolierte Git-Arbeitsbereiche verwalten

Alle Befehle funktionieren identisch mit `king`.

Aktualisieren
-------------

  blun update

`king update` und `upgrade` sind gleichwertig. Der Updater bleibt im installierten
Stable- oder Next-Kanal, verhindert Rückstufungen und installiert nur eine zuvor
aufgelöste exakte Paketversion.

Beim ersten Start in der Konsole /login eingeben. Der Browser öffnet den
BLUN-OAuth-Login.
Ein API-Schlüssel wird weder abgefragt noch in die Konfiguration geschrieben.

Telegram einrichten
--------------------
1. Einen Bot bei BotFather anlegen.
2. Den Bot-Token in dieser Datei eintragen:

   ~/.blun/channels/telegram/.env

3. `king` starten und den angezeigten Pairing-Code mit
   /telegram:access pair CODE bestätigen.