blun-king-cli 9.1.603 → 9.1.604

package/CHANGELOG.md

@@ -1,12 +1,25 @@
 # BLUN King Changelog
 
-## 9.1.603
+## 9.1.604
 
-- 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.
+- 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.602
+## 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.

package/LIESMICH.txt

@@ -3,13 +3,30 @@ BLUN King für macOS und Windows
 
 Voraussetzung
 -------------
-Node.js 24.15 oder neuer muss installiert sein.
+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.601
+  npm install -g blun-king-cli@9.1.604
 
 Start
 -----

package/README.md

@@ -9,10 +9,53 @@ Voraussetzung ist Node.js 24.15 oder neuer. Die geprüfte Version wird exakt
 installiert:
 
 ```powershell
-npm install -g blun-king-cli@9.1.601
+npm install -g blun-king-cli@9.1.604
 ```
 
-## Reproduzierbares Staging und Packen
+### 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
+node --version
+npm --version
+git --version
+```
+
+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.
+
+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.
+
+## Kontext, Werkzeuge und Sitzungssteuerung ab 9.1.604
+
+Die folgenden Befehle ergänzen die vorhandene Konsole. Sie ändern weder das Modell noch dessen Kontextfenster.
+
+| 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. |
+
+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.
+
+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.
+
+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.
+
+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.
+
+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.
+
+## 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

package/bin/verify-bundled-agent-sources.cjs

@@ -15,7 +15,10 @@ const GUARD_RESPONSE_PAYLOADS = Object.freeze([
   'standard-skills/translate-native/scripts/blun_language_guard.py',
   'standard-tools/language-guard/blun_language_guard.py',
 ]);
-const REQUIRED = [
+const REQUIRED = [
+  'agent-spine-plugin/package.json',
+  'standard-skills/translate-native/VERSION', 'standard-skills/translate-native/provenance.json',
+  'standard-tools/language-guard/VERSION', 'standard-tools/language-guard/provenance.json',
   'agent-spine-plugin/blun.plugin.json', 'agent-spine-plugin/src/hook.js',
   'agent-spine-plugin/src/mcp.js', 'agent-spine-plugin/skills/agent-spine/SKILL.md',
   'standard-skills/translate-native/SKILL.md', ...GUARD_RESPONSE_PAYLOADS,
@@ -53,10 +56,29 @@ function verifyBundledAgentSources(root, pins) {
   }
   const expectedNames = Object.keys(receipt.files).sort();
   if (JSON.stringify(Object.keys(actual).sort()) !== JSON.stringify(expectedNames)) throw new Error('Bundled source inventory mismatch');
-  for (const file of expectedNames) {
-    if (!/^[a-f0-9]{64}$/.test(receipt.files[file]) || actual[file] !== receipt.files[file]) throw new Error('Bundled source digest mismatch: ' + file);
-  }
-  // Bind the semantic repair independently of the self-reported file inventory.
+  for (const file of expectedNames) {
+    if (!/^[a-f0-9]{64}$/.test(receipt.files[file]) || actual[file] !== receipt.files[file]) throw new Error('Bundled source digest mismatch: ' + file);
+  }
+  for (const name of ['agentSpine', 'translateNative']) {
+    const version = receipt.versions?.[name];
+    if (typeof version !== 'string' || !version || version.trim() !== version) {
+      throw new Error('Invalid bundled component version: ' + name);
+    }
+  }
+  const spine = JSON.parse(fs.readFileSync(path.join(root, 'agent-spine-plugin/package.json'), 'utf8'));
+  if (spine.version !== receipt.versions.agentSpine) throw new Error('Bundled component version mismatch: agentSpine');
+  for (const prefix of ['standard-skills/translate-native/', 'standard-tools/language-guard/']) {
+    if (fs.readFileSync(path.join(root, prefix, 'VERSION'), 'utf8').trim() !== receipt.versions.translateNative) {
+      throw new Error('Bundled component version mismatch: ' + prefix);
+    }
+    const provenance = JSON.parse(fs.readFileSync(path.join(root, prefix, 'provenance.json'), 'utf8'));
+    if (provenance?.name !== 'translate-native' || provenance.version !== receipt.versions.translateNative
+      || provenance.sourceCommit !== receipt.sources.translateNative.commit
+      || provenance.sourceRepository !== receipt.sources.translateNative.repository) {
+      throw new Error('Bundled component provenance mismatch: ' + prefix);
+    }
+  }
+  // Bind the semantic repair independently of the self-reported file inventory.
   const patch = receipt.localPatches?.guardResponseProfile;
   if (!patch || typeof patch !== 'object' || Array.isArray(patch)
     || Object.keys(patch).length !== Object.keys(GUARD_RESPONSE_PROFILE).length