blun-king-cli 9.1.602 → 9.1.604

package/CHANGELOG.md

@@ -1,101 +1,120 @@
 # BLUN King Changelog
 
-## 9.1.602
-
-- Give historical tool-output recovery its own private storage root, so existing ordinary tool-output folders with inherited permissions do not silently disable lossless context reduction. Existing files and permissions remain unchanged.
-- Retain complete archived output, read-permission checks, integrity verification, and fallback to full context when recovery is unavailable. Bundled AgentSpine and Language Guard versions are unchanged from 9.1.601.
-
-## 9.1.601
-
-- Keep terminal input queued when background work wins admission, preserving order and showing each input only once.
-- Replace eligible older tool outputs with verified private-file references in model requests while preserving complete history and current-turn results.
-- Retain full output when recovery is unavailable, denied, altered, or no longer matches the active context.
-- Require source and compiled-program checks for recovery, permission boundaries, and retained-history accounting.
-- Retry one rate-limited native response review using the persisted provider cooldown and the unchanged candidate; never replay completed tools or release unchecked text.
-- Reserve up to 2,048 output tokens for input-estimation differences without shrinking the model context window or changing smaller explicit output caps. Larger differences remain subject to bounded context-error recovery.
-
-## 9.1.600
-
-- Bound each response-review attempt to 120 seconds while retaining the 30-second default for generic reviewers and the existing maximum of two outer attempts.
-- Allow up to 90 seconds for first meaningful native-review text once per attempt, then renew a 30-second idle budget on meaningful text and ordered release and verification stages without extending the absolute deadline.
-- Preserve cancellation, exact response binding, receipt expiry, and authorization; these changes do not establish a fix for live HTTP 502 errors.
-- Pin AgentSpine 0.73.0 and Translate Native 6.155.0; keep the guard protocol at 6.20.0.
-
-## 9.1.599
-
-- Show localized personal-memory actions and complete previews of settings changes or remembered text, with terminal control characters escaped.
-- Offer one-shot approval for valid memory changes and rejection only for invalid inputs.
-- Prevent session-wide approval from automatically accepting queued requests that require individual approval.
-
-## 9.1.598
-
-- Distinguish lower-bound input counts from exact counts in upstream context rejections.
-- Reduce the output allowance once for a lower-bound rejection without discarding messages or tools; retain cancellation and bounded retry behavior.
-- Verify moving tokenization thresholds and exact-count counterexamples in the compiled program.
-- Include the previously missing package notes for 9.1.595 through 9.1.597.
-- Restore the original 150 rotating activity words without additional model requests.
-- Keep media payloads out of AgentSpine's text-only hook input while preserving complete model attachments and policy checks.
-
-## 9.1.597
-
-- Classify explicit context-limit errors wrapped in HTTP 502 and allow one corrected request with a smaller output allowance.
-- Preserve messages, tools, cancellation, and the rule against replaying an already-started response.
-- Known limitation: this initial correction treated lower-bound input counts as exact. The additional correction is included in 9.1.598.
-
-## 9.1.596
-
-- Distinguish owner cancellation from automatic turn interruption.
-
-## 9.1.595
-
-- Defer tool and skill descriptions until they are needed, while keeping discovery available.
-- Bound greeting context without deleting saved task history or weakening permissions.
-
-## 9.1.594
-
-- Preserve private Telegram replies while group messages wait, and retain slash-command routing.
-- Honor long Retry-After delays and restore remaining cooldowns after resuming a session.
-- Continue one settled tool step after rejected narration without publishing that narration or weakening final-answer review.
-- Restore bounded write-continuation recovery, shell timeouts, task controls and session recovery.
-- Keep input, quota rows, activity, task expansion and source-labelled tool output visible during streaming and history navigation.
-- Require complete console regression evidence before packaging and verify matching public update metadata.
-
-## 9.1.593
-
-- Keep the input and both status rows visible after delayed startup messages, without clearing terminal scrollback.
-
-## 9.1.592
-
-- Preserve explicit startup permissions and remember deliberate permission selections for new sessions.
-- Prevent overlapping session selections from closing the session being resumed.
-- Restore rotating activity words, cumulative usage, step number and local date/time alongside live timing and token estimates.
-- Allow protected-source reads redirected to literal null sinks without removing protected-write checks.
-- Include the bounded startup and reload corrections prepared in 9.1.591.
-
-## 9.1.591
-
-- Finish the managed model refresh before opening a session, with a bounded catalog request.
-- Reopen continued sessions through one reload so an overdue loop cannot race a second reload.
-- Preserve additional workspace directories through the reload path.
-- Keep the existing input, footer, quota rows, loop countdown and compaction display unchanged.
-
-## 9.1.590
-
-- Retain complete bounded instructions without the extra 8 KiB AgentSpine rejection.
-- Keep routine AgentSpine preparation out of the visible transcript while retaining source and receipt checks.
-- Preserve the active King profile when unrelated host settings are inherited.
-- Restore the loop countdown and replace the previous recurring loop when scheduling a new one.
-- Retain the approved compaction display and queued reload behavior.
-
-## 9.1.589
-
-- Bundle reviewed AgentSpine and Translate Native sources with verified update manifests.
-- Preserve the active King profile when loading agent context.
-- Keep required response-review tools available and record generated-response usage even when review rejects the response.
-- Apply mention-required group routing in the managed channel integration.
-- Show compaction activity and effective thresholds in the terminal.
-- Preserve the early-compaction working budget and request-boundary safety margin across updates.
-- Use the selected language throughout the startup update dialog, progress and queued-update messages.
-- Keep technical integration identifiers and licenses intact while neutralizing visible runtime error messages.
-
-Installation does not restart existing sessions. A running session loads the new code on its next start.
+## 9.1.604
+
+- Add request diagnostics to /context doctor, /context-doctor and /tokens: separate serialized request bytes from token estimates and attribute supported prompt files, memory, skills and tool definitions to their actual rendered contributions. Unknown provenance remains unknown.
+- Generate a fresh x-request-id for each HTTP attempt and retain it in transport diagnostics. Preserve caller-supplied IDs; do not log their arbitrary values or change billing behavior.
+- Defer medium-sized tool catalogs through the existing search and disclosure mechanism. Keep tools discoverable and executable without reducing the model context window.
+- Add session-scoped /queue controls for steer, followup, collect and interrupt, with debounce and batch settings. Preserve excess queued input and forum-topic routing. Ordinary queued messages no longer use the former automatic 30-second interruption.
+- Resolve /session and explicit startup targets by exact ID or title, then unambiguous ID prefix. Keep ambiguous choices in the existing picker and preserve queue ownership across session transitions.
+- Preserve multiline input as message content, retain pending questions when their dialog is collapsed, and offer /question to reopen them.
+- Add session-persisted usage display modes, include response-review usage in the turn footer, and discard diagnostic results after a session change.
+- Add local display controls to /settings, show the bound agent and session in the footer, coalesce tool-progress repaints, and stop formatting unused private thinking payloads.
+- Suppress repeated unchanged blocked-Cron warnings and recheck cleanup deadlines after early timer wakes without extending the cleanup budget.
+- Keep the pinned AgentSpine and Translate Native component versions unchanged. These changes do not establish lower provider bills, faster live responses, a repaired external Guard service, or complete OpenClaw feature parity.
+
+## 9.1.603
+
+- Open a native Windows folder chooser when selecting a different startup workspace. Keep explicit path entry available, return to the workspace menu on cancellation, and fall back to path entry when a desktop dialog is unavailable.
+- Offer the user's home folder instead of an inherited or previously remembered Windows system directory such as System32. Explicitly entered workspace paths still use the existing validation.
+- Preserve exact prompt and bundled-component fixture bytes across Windows checkouts, and require folder-selection regression checks in the release gate. Bundled AgentSpine and Language Guard versions are unchanged from 9.1.602.
+
+## 9.1.602
+
+- Give historical tool-output recovery its own private storage root, so existing ordinary tool-output folders with inherited permissions do not silently disable lossless context reduction. Existing files and permissions remain unchanged.
+- Retain complete archived output, read-permission checks, integrity verification, and fallback to full context when recovery is unavailable. Bundled AgentSpine and Language Guard versions are unchanged from 9.1.601.
+
+## 9.1.601
+
+- Keep terminal input queued when background work wins admission, preserving order and showing each input only once.
+- Replace eligible older tool outputs with verified private-file references in model requests while preserving complete history and current-turn results.
+- Retain full output when recovery is unavailable, denied, altered, or no longer matches the active context.
+- Require source and compiled-program checks for recovery, permission boundaries, and retained-history accounting.
+- Retry one rate-limited native response review using the persisted provider cooldown and the unchanged candidate; never replay completed tools or release unchecked text.
+- Reserve up to 2,048 output tokens for input-estimation differences without shrinking the model context window or changing smaller explicit output caps. Larger differences remain subject to bounded context-error recovery.
+
+## 9.1.600
+
+- Bound each response-review attempt to 120 seconds while retaining the 30-second default for generic reviewers and the existing maximum of two outer attempts.
+- Allow up to 90 seconds for first meaningful native-review text once per attempt, then renew a 30-second idle budget on meaningful text and ordered release and verification stages without extending the absolute deadline.
+- Preserve cancellation, exact response binding, receipt expiry, and authorization; these changes do not establish a fix for live HTTP 502 errors.
+- Pin AgentSpine 0.73.0 and Translate Native 6.155.0; keep the guard protocol at 6.20.0.
+
+## 9.1.599
+
+- Show localized personal-memory actions and complete previews of settings changes or remembered text, with terminal control characters escaped.
+- Offer one-shot approval for valid memory changes and rejection only for invalid inputs.
+- Prevent session-wide approval from automatically accepting queued requests that require individual approval.
+
+## 9.1.598
+
+- Distinguish lower-bound input counts from exact counts in upstream context rejections.
+- Reduce the output allowance once for a lower-bound rejection without discarding messages or tools; retain cancellation and bounded retry behavior.
+- Verify moving tokenization thresholds and exact-count counterexamples in the compiled program.
+- Include the previously missing package notes for 9.1.595 through 9.1.597.
+- Restore the original 150 rotating activity words without additional model requests.
+- Keep media payloads out of AgentSpine's text-only hook input while preserving complete model attachments and policy checks.
+
+## 9.1.597
+
+- Classify explicit context-limit errors wrapped in HTTP 502 and allow one corrected request with a smaller output allowance.
+- Preserve messages, tools, cancellation, and the rule against replaying an already-started response.
+- Known limitation: this initial correction treated lower-bound input counts as exact. The additional correction is included in 9.1.598.
+
+## 9.1.596
+
+- Distinguish owner cancellation from automatic turn interruption.
+
+## 9.1.595
+
+- Defer tool and skill descriptions until they are needed, while keeping discovery available.
+- Bound greeting context without deleting saved task history or weakening permissions.
+
+## 9.1.594
+
+- Preserve private Telegram replies while group messages wait, and retain slash-command routing.
+- Honor long Retry-After delays and restore remaining cooldowns after resuming a session.
+- Continue one settled tool step after rejected narration without publishing that narration or weakening final-answer review.
+- Restore bounded write-continuation recovery, shell timeouts, task controls and session recovery.
+- Keep input, quota rows, activity, task expansion and source-labelled tool output visible during streaming and history navigation.
+- Require complete console regression evidence before packaging and verify matching public update metadata.
+
+## 9.1.593
+
+- Keep the input and both status rows visible after delayed startup messages, without clearing terminal scrollback.
+
+## 9.1.592
+
+- Preserve explicit startup permissions and remember deliberate permission selections for new sessions.
+- Prevent overlapping session selections from closing the session being resumed.
+- Restore rotating activity words, cumulative usage, step number and local date/time alongside live timing and token estimates.
+- Allow protected-source reads redirected to literal null sinks without removing protected-write checks.
+- Include the bounded startup and reload corrections prepared in 9.1.591.
+
+## 9.1.591
+
+- Finish the managed model refresh before opening a session, with a bounded catalog request.
+- Reopen continued sessions through one reload so an overdue loop cannot race a second reload.
+- Preserve additional workspace directories through the reload path.
+- Keep the existing input, footer, quota rows, loop countdown and compaction display unchanged.
+
+## 9.1.590
+
+- Retain complete bounded instructions without the extra 8 KiB AgentSpine rejection.
+- Keep routine AgentSpine preparation out of the visible transcript while retaining source and receipt checks.
+- Preserve the active King profile when unrelated host settings are inherited.
+- Restore the loop countdown and replace the previous recurring loop when scheduling a new one.
+- Retain the approved compaction display and queued reload behavior.
+
+## 9.1.589
+
+- Bundle reviewed AgentSpine and Translate Native sources with verified update manifests.
+- Preserve the active King profile when loading agent context.
+- Keep required response-review tools available and record generated-response usage even when review rejects the response.
+- Apply mention-required group routing in the managed channel integration.
+- Show compaction activity and effective thresholds in the terminal.
+- Preserve the early-compaction working budget and request-boundary safety margin across updates.
+- Use the selected language throughout the startup update dialog, progress and queued-update messages.
+- Keep technical integration identifiers and licenses intact while neutralizing visible runtime error messages.
+
+Installation does not restart existing sessions. A running session loads the new code on its next start.

package/LIESMICH.txt

@@ -1,57 +1,74 @@
-BLUN King für macOS und Windows
-===============================
-
-Voraussetzung
--------------
-Node.js 24.15 oder neuer muss installiert sein.
-
-Installation
-------------
-Die geprüfte Version exakt global installieren:
-
-  npm install -g blun-king-cli@9.1.601
-
-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.
+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.604
+
+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.

package/README.md

@@ -1,90 +1,133 @@
-# blun-king-cli — npm-Distribution
-
-Dieses Verzeichnis ist das Gerüst des öffentlichen npm-Pakets `blun-king-cli`
-(Erstveröffentlichung 8.0.0, 06.07.2026, Account `blunking`).
-
-## Installation
-
-Voraussetzung ist Node.js 24.15 oder neuer. Die geprüfte Version wird exakt
-installiert:
+# blun-king-cli — npm-Distribution
+
+Dieses Verzeichnis ist das Gerüst des öffentlichen npm-Pakets `blun-king-cli`
+(Erstveröffentlichung 8.0.0, 06.07.2026, Account `blunking`).
+
+## Installation
+
+Voraussetzung ist Node.js 24.15 oder neuer. Die geprüfte Version wird exakt
+installiert:
+
+```powershell
+npm install -g blun-king-cli@9.1.604
+```
+
+### Windows: Node.js, npm und Git Bash
+
+Node.js ab Version 24.15 ist erforderlich; npm wird mit Node.js installiert. Unter Windows benötigt die Konsole außerdem Git Bash aus Git for Windows. Nach der Installation ein neues Terminal öffnen und prüfen:
 
 ```powershell
-npm install -g blun-king-cli@9.1.601
+node --version
+npm --version
+git --version
 ```
 
-## Reproduzierbares Staging und Packen
-
-Der Schritt baut nichts, installiert nichts und veröffentlicht nichts. Vorher müssen
-`apps/blun-king/dist/main.mjs`, `dist-web`, die Darwin- und Windows-Natives sowie
-`plugins/telegram/dist` bereits frisch gebaut sein.
-
-Das Staging landet standardmäßig
-unter `.stage/package`, das Tarball unter `.stage/artifacts`.
-`BLUN_NPM_STAGE_DIR` und `BLUN_NPM_ARTIFACT_DIR` können beide Ziele überschreiben;
-beim direkten Skriptaufruf stehen zusätzlich `--output` und `--artifacts` bereit.
-
-Der Schritt validiert alle Pflichtartefakte vor dem Leeren des alten Stagings. Er
-kopiert nur die Paket-Hülle, `blun.mjs`, `dist-web`, `native`, Telegrams
-`dist`/Manifest/Commands und die Repo-Skills.
-
-## Startmodi
-
-`blun` startet die lokale Konsole, ohne Telegram automatisch anzubinden. `king`
-startet dieselbe Konsole und bindet den eingerichteten Telegram-Kanal automatisch
-an. Version, Konto, Modell und Befehle sind ansonsten identisch. Der Unterschied
-gilt nur für den laufenden Prozess; die gespeicherte
-Plugin-Konfiguration wird nicht umgeschrieben.
-
-Beim ersten Start werden das Telegram-Plugin und die mitgelieferten Skills
-eingerichtet. Die Anmeldung erfolgt anschließend in der
-Konsole mit `/login` über den BLUN-OAuth-Server. Das Paket erzeugt keine
-statische Anbieter- oder API-Key-Konfiguration.
+Wird `npm` nicht gefunden, zuerst die Node.js-Installation und den Suchpfad prüfen. Meldet die Konsole `Git Bash not found`, Git for Windows installieren oder `BLUN_SHELL_PATH` auf die vorhandene `bash.exe` setzen. Die Variable muss auf die Datei zeigen, nicht nur auf ihren Ordner.
 
-## Persönliches Gedächtnis
+Beim Start lässt sich ein anderer Arbeitsordner über den Windows-Ordnerdialog auswählen. Ist kein Desktopdialog verfügbar, bleibt die manuelle Pfadeingabe möglich. Ein geerbter Windows-Systemordner wie `C:\Windows\System32` wird nicht als vorgeschlagener Arbeitsordner übernommen.
 
-Seit Version 9.1.599 zeigt BLUN King Freigaben für das persönliche Gedächtnis mit übersetzten Aktionstiteln und vollständigen Vorschauen der tatsächlichen Einstellungsänderungen oder des zu speichernden Textes. Gültige Änderungen lassen sich nur einmalig freigeben, ungültige Eingaben nur ablehnen. Eine Sitzungsfreigabe genehmigt solche wartenden Anfragen nicht automatisch. Steuerzeichen werden sichtbar maskiert; der Originalinhalt bleibt unverändert.
+## Kontext, Werkzeuge und Sitzungssteuerung ab 9.1.604
 
-## Zeitgrenzen für die Antwortprüfung
+Die folgenden Befehle ergänzen die vorhandene Konsole. Sie ändern weder das Modell noch dessen Kontextfenster.
 
-Version 9.1.600 begrenzt die Antwortprüfung pro äußerem Prüfversuch auf insgesamt 120 Sekunden. Allgemeine Prüfer behalten die bisherige Frist von 30 Sekunden. Bei der nativen Sprachprüfung stehen nach dem bestätigten Start einmalig bis zu 90 Sekunden für den ersten inhaltlichen Text bereit; auch dabei gilt die Gesamtgrenze. Inhaltlicher Text innerhalb der zulässigen Ausgabelänge sowie die geordneten Übergänge zur Freigabe und zur Belegprüfung setzen die Wartefrist jeweils auf 30 Sekunden zurück, ohne die Gesamtgrenze zu verlängern. Es bleibt bei höchstens zwei äußeren Prüfversuchen.
+| Befehl | Wirkung |
+| --- | --- |
+| `/context doctor`, `/context-doctor`, `/tokens` | Zeigt die ausführliche Kontextdiagnose der aktiven Sitzung. |
+| `/queue` | Zeigt die aktuelle Warteschlangenregel. |
+| `/queue steer` | Übergibt neue Eingaben am nächsten geeigneten Übergabepunkt; ist das nicht möglich, warten sie auf den nächsten Zug. |
+| `/queue followup` | Verarbeitet neue Eingaben nach dem laufenden Zug. |
+| `/queue collect debounce:500ms batch:10` | Bündelt zusammengehörige Eingaben; weitere Eingaben bleiben in der Warteschlange. |
+| `/queue interrupt` | Unterbricht für neue Eingaben den laufenden Zug. |
+| `/queue reset`, `/queue default` | Entfernt die sitzungsspezifische Warteschlangenregel. |
+| `/session <ID oder Titel>` | Wählt eine Sitzung im aktuellen Arbeitsbereich. Eindeutige ID-Präfixe werden ebenfalls erkannt; bei Mehrdeutigkeit öffnet sich die Auswahl. |
+| `/question` | Öffnet noch ausstehende Rückfragen erneut. Das Einklappen beantwortet oder verwirft sie nicht. |
+| `/usage off`, `/usage tokens`, `/usage full` | Speichert den Anzeigemodus für den Verbrauch in dieser Sitzung. |
+| `/usage reset` | Entfernt den sitzungsspezifischen Anzeigemodus. `inherit`, `clear` und `default` sind gleichwertig. |
+| `/settings` | Öffnet die Einstellungen einschließlich der lokalen Anzeigeoptionen. |
 
-Abbruch, exakte Bindung an den Antworttext, Belegablauf und Autorisierung bleiben unverändert. Damit ist keine Behebung von HTTP-502-Fehlern im Live-Betrieb nachgewiesen.
+Bei `/queue` sind `debounce:0ms` bis `debounce:60s` und `batch:1` bis `batch:100` zulässig. `batch` begrenzt die Bündelgröße und löscht keine überschüssigen Nachrichten. Es gibt keine `cap:`- oder `drop:`-Option. Die Warteschlangenregel und der Verbrauchsmodus bleiben beim Fortsetzen derselben Sitzung erhalten. Gewöhnliche neue Kanalnachrichten lösen nicht mehr automatisch nach 30 Sekunden einen Abbruch aus; ausdrücklich angeforderte Unterbrechungen bleiben möglich.
 
-## Festgelegte Komponentenstände
+Die Kontextdiagnose unterscheidet den gespeicherten Verlauf, geschätzte Tokenzahlen und die tatsächlich serialisierten Anfrage-Bytes. Für die letzte erfasste Anfrage weist sie bekannte Beiträge von AGENTS-Regeln, Mistake-Dateien, eingebundenem Gedächtnis, Skills und Werkzeugdefinitionen getrennt aus. Fehlende Herkunftsdaten bedeuten nicht null Byte. Anfrage-Bytes sind weder Tokenzahlen noch eine Rechnung.
 
-- AgentSpine 0.73.0, Commit `38cb94760b19e3a82e7efdf12538a1adf5324964`.
-- Translate Native 6.155.0, Commit `21efc66da8f77992c8c63ac0f145a106c31e7eb2`.
-- Guard-Protokoll unverändert auf 6.20.0.
+Größere Werkzeugkataloge werden über die vorhandene Werkzeugsuche nach Bedarf eingeblendet. Die Schwelle liegt bei 8.000 geschätzten Schema-Token; notwendige Werkzeuge können darüber liegen. Werkzeuge werden dadurch nicht entfernt, und das Modellfenster wird nicht verkleinert.
 
-## Nachweisbare Arbeitsabläufe
+Das Transportprotokoll erhält für jeden HTTP-Versuch eine eigene `x-request-id`. Bereits vorgegebene Kennungen bleiben unverändert und werden nicht als beliebiger Fremdtext protokolliert. Damit lassen sich Client- und Servermessungen zuordnen; die Kennung ist kein Abrechnungsschlüssel.
 
-Version 9.1.0 enthält sieben zusätzliche, getrennt nutzbare Befehlsgruppen:
+Die Verbrauchsanzeige berücksichtigt auch die Antwortprüfung. `/usage cost` mit Tages- oder Monatskosten gehört nicht zu dieser Fassung. Eine geringere Rechnung oder kürzere Antwortzeit im Live-Betrieb ist durch die lokalen Prüfungen nicht belegt.
 
-- `proof` belegt Prüfungen und Artefakte mit SHA-256.
-- `brief` erstellt einen versionierten Projektauftrag.
-- `handoff` übergibt eine Sitzung zwischen CLI, Desktop und Web.
-- `replay` erzeugt einen bereinigten Arbeitsverlauf.
-- `guard` prüft Belegintegrität und aktuelle Artefakte.
-- `demo` erzeugt eine bereinigte statische Projektdemo.
-- `workspace` verwaltet isolierte Git-Arbeitsbereiche.
-
-Sie stehen unter `blun` und `king` identisch zur Verfügung.
-
-## Aktualisieren
-
-`blun update`, `king update` und die jeweilige Variante `upgrade` verwenden
-denselben abgesicherten Updater. Er bleibt im installierten Stable- oder
-Next-Kanal, verhindert Rückstufungen und übergibt npm ausschließlich eine zuvor
-aufgelöste exakte Paketversion.
-
-## Absturzdiagnose unter Windows
-
-Startfehler und unbehandelte Ausnahmen werden im begrenzten, bereinigten Protokoll `BLUN_HOME/diagnostics/runtime-exits.jsonl` erfasst. Die Diagnose startet keinen neuen Prozess und ändert beim Start keine Windows-Registrywerte.
-
-Ausführliche Node-Berichte sind optional. Nur `BLUN_NODE_CRASH_REPORTS=1` aktiviert sie für den gestarteten Prozess. Die Berichte liegen unter `BLUN_HOME/diagnostics/crash-dumps`. Umgebungsvariablen und Netzwerkinformationen werden ausgeschlossen; Programmargumente, Dateipfade und weitere sensible Prozessdaten können trotzdem enthalten sein. Berichte vor einer Weitergabe prüfen.
-
-Drei gemeinsam reservierte Plätze begrenzen die Anzahl dieser Node-Berichte, nicht deren Dateigröße. Ein ordentlich beendeter Prozess gibt seine Reservierung frei; ein späterer Prozess kann den Bericht dieses Platzes ersetzen. Aktive oder unklar verwaiste Reservierungen werden nicht automatisch entfernt. Sind alle Plätze belegt oder liegen alte Berichte mit Zufallskennung vor, bleiben neue Detailberichte aus, bis der Betreiber diese Dateien ausdrücklich geprüft und bereinigt hat. Der normale Start und das kleine Fehlerprotokoll bleiben davon unabhängig. Sitzungen und fremde Dateien werden nicht entfernt.
-
-Native Windows-Dumps sind davon getrennt. Der mitgelieferte Helfer `bin/windows-node-crash-dump.cjs` bietet `--query-wer` für eine reine Abfrage. Eine Änderung erfordert ausdrücklich `--configure-wer --confirm-system-wide`, ein gesetztes `BLUN_HOME` und ausreichende Windows-Rechte. Sie betrifft alle Prozesse namens `node.exe`, nicht nur BLUN: drei Minidumps im angegebenen Diagnoseordner. Bei einem Teilfehler nennt die JSON-Ausgabe die bereits gesetzten Werte. Der normale Start ruft diesen Befehl niemals auf.
-
-Node-Berichte erfassen unterstützte Node-Fehler; sie sind kein Beleg dafür, dass jeder native Windows-Abbruch erfasst wird. Die Funktion lässt den ursprünglichen Fehler und den vorgesehenen Prozessabbruch bestehen.
+## Reproduzierbares Staging und Packen
+
+Der Schritt baut nichts, installiert nichts und veröffentlicht nichts. Vorher müssen
+`apps/blun-king/dist/main.mjs`, `dist-web`, die Darwin- und Windows-Natives sowie
+`plugins/telegram/dist` bereits frisch gebaut sein.
+
+Das Staging landet standardmäßig
+unter `.stage/package`, das Tarball unter `.stage/artifacts`.
+`BLUN_NPM_STAGE_DIR` und `BLUN_NPM_ARTIFACT_DIR` können beide Ziele überschreiben;
+beim direkten Skriptaufruf stehen zusätzlich `--output` und `--artifacts` bereit.
+
+Der Schritt validiert alle Pflichtartefakte vor dem Leeren des alten Stagings. Er
+kopiert nur die Paket-Hülle, `blun.mjs`, `dist-web`, `native`, Telegrams
+`dist`/Manifest/Commands und die Repo-Skills.
+
+## Startmodi
+
+`blun` startet die lokale Konsole, ohne Telegram automatisch anzubinden. `king`
+startet dieselbe Konsole und bindet den eingerichteten Telegram-Kanal automatisch
+an. Version, Konto, Modell und Befehle sind ansonsten identisch. Der Unterschied
+gilt nur für den laufenden Prozess; die gespeicherte
+Plugin-Konfiguration wird nicht umgeschrieben.
+
+Beim ersten Start werden das Telegram-Plugin und die mitgelieferten Skills
+eingerichtet. Die Anmeldung erfolgt anschließend in der
+Konsole mit `/login` über den BLUN-OAuth-Server. Das Paket erzeugt keine
+statische Anbieter- oder API-Key-Konfiguration.
+
+## Persönliches Gedächtnis
+
+Seit Version 9.1.599 zeigt BLUN King Freigaben für das persönliche Gedächtnis mit übersetzten Aktionstiteln und vollständigen Vorschauen der tatsächlichen Einstellungsänderungen oder des zu speichernden Textes. Gültige Änderungen lassen sich nur einmalig freigeben, ungültige Eingaben nur ablehnen. Eine Sitzungsfreigabe genehmigt solche wartenden Anfragen nicht automatisch. Steuerzeichen werden sichtbar maskiert; der Originalinhalt bleibt unverändert.
+
+## Zeitgrenzen für die Antwortprüfung
+
+Version 9.1.600 begrenzt die Antwortprüfung pro äußerem Prüfversuch auf insgesamt 120 Sekunden. Allgemeine Prüfer behalten die bisherige Frist von 30 Sekunden. Bei der nativen Sprachprüfung stehen nach dem bestätigten Start einmalig bis zu 90 Sekunden für den ersten inhaltlichen Text bereit; auch dabei gilt die Gesamtgrenze. Inhaltlicher Text innerhalb der zulässigen Ausgabelänge sowie die geordneten Übergänge zur Freigabe und zur Belegprüfung setzen die Wartefrist jeweils auf 30 Sekunden zurück, ohne die Gesamtgrenze zu verlängern. Es bleibt bei höchstens zwei äußeren Prüfversuchen.
+
+Abbruch, exakte Bindung an den Antworttext, Belegablauf und Autorisierung bleiben unverändert. Damit ist keine Behebung von HTTP-502-Fehlern im Live-Betrieb nachgewiesen.
+
+## Festgelegte Komponentenstände
+
+- AgentSpine 0.73.0, Commit `38cb94760b19e3a82e7efdf12538a1adf5324964`.
+- Translate Native 6.155.0, Commit `21efc66da8f77992c8c63ac0f145a106c31e7eb2`.
+- Guard-Protokoll unverändert auf 6.20.0.
+
+## Nachweisbare Arbeitsabläufe
+
+Version 9.1.0 enthält sieben zusätzliche, getrennt nutzbare Befehlsgruppen:
+
+- `proof` belegt Prüfungen und Artefakte mit SHA-256.
+- `brief` erstellt einen versionierten Projektauftrag.
+- `handoff` übergibt eine Sitzung zwischen CLI, Desktop und Web.
+- `replay` erzeugt einen bereinigten Arbeitsverlauf.
+- `guard` prüft Belegintegrität und aktuelle Artefakte.
+- `demo` erzeugt eine bereinigte statische Projektdemo.
+- `workspace` verwaltet isolierte Git-Arbeitsbereiche.
+
+Sie stehen unter `blun` und `king` identisch zur Verfügung.
+
+## Aktualisieren
+
+`blun update`, `king update` und die jeweilige Variante `upgrade` verwenden
+denselben abgesicherten Updater. Er bleibt im installierten Stable- oder
+Next-Kanal, verhindert Rückstufungen und übergibt npm ausschließlich eine zuvor
+aufgelöste exakte Paketversion.
+
+## Absturzdiagnose unter Windows
+
+Startfehler und unbehandelte Ausnahmen werden im begrenzten, bereinigten Protokoll `BLUN_HOME/diagnostics/runtime-exits.jsonl` erfasst. Die Diagnose startet keinen neuen Prozess und ändert beim Start keine Windows-Registrywerte.
+
+Ausführliche Node-Berichte sind optional. Nur `BLUN_NODE_CRASH_REPORTS=1` aktiviert sie für den gestarteten Prozess. Die Berichte liegen unter `BLUN_HOME/diagnostics/crash-dumps`. Umgebungsvariablen und Netzwerkinformationen werden ausgeschlossen; Programmargumente, Dateipfade und weitere sensible Prozessdaten können trotzdem enthalten sein. Berichte vor einer Weitergabe prüfen.
+
+Drei gemeinsam reservierte Plätze begrenzen die Anzahl dieser Node-Berichte, nicht deren Dateigröße. Ein ordentlich beendeter Prozess gibt seine Reservierung frei; ein späterer Prozess kann den Bericht dieses Platzes ersetzen. Aktive oder unklar verwaiste Reservierungen werden nicht automatisch entfernt. Sind alle Plätze belegt oder liegen alte Berichte mit Zufallskennung vor, bleiben neue Detailberichte aus, bis der Betreiber diese Dateien ausdrücklich geprüft und bereinigt hat. Der normale Start und das kleine Fehlerprotokoll bleiben davon unabhängig. Sitzungen und fremde Dateien werden nicht entfernt.
+
+Native Windows-Dumps sind davon getrennt. Der mitgelieferte Helfer `bin/windows-node-crash-dump.cjs` bietet `--query-wer` für eine reine Abfrage. Eine Änderung erfordert ausdrücklich `--configure-wer --confirm-system-wide`, ein gesetztes `BLUN_HOME` und ausreichende Windows-Rechte. Sie betrifft alle Prozesse namens `node.exe`, nicht nur BLUN: drei Minidumps im angegebenen Diagnoseordner. Bei einem Teilfehler nennt die JSON-Ausgabe die bereits gesetzten Werte. Der normale Start ruft diesen Befehl niemals auf.
+
+Node-Berichte erfassen unterstützte Node-Fehler; sie sind kein Beleg dafür, dass jeder native Windows-Abbruch erfasst wird. Die Funktion lässt den ursprünglichen Fehler und den vorgesehenen Prozessabbruch bestehen.