blun-king-cli 9.1.624 → 9.1.626

package/README.md

@@ -1,133 +1,90 @@
-# 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.624
-```
-
-### 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:
+# 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
-node --version
-npm --version
-git --version
+npm install -g blun-king-cli@9.1.600
 ```
 
-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.
+## Reproduzierbares Staging und Packen
 
-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.
+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.
 
-## Kontext, Werkzeuge und Sitzungssteuerung ab 9.1.604
+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.
 
-Die folgenden Befehle ergänzen die vorhandene Konsole. Sie ändern weder das Modell noch dessen Kontextfenster.
+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.
 
-| 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. |
+## Startmodi
 
-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.
+`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.
 
-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.
+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.
 
-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.
+## Persönliches Gedächtnis
 
-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.
+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.
 
-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.
+## Zeitgrenzen für die Antwortprüfung
 
-## 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.
+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.

package/agent-spine-plugin/scripts/check-install.js

@@ -215,7 +215,7 @@ async function prepareInstalledChannelWake(pluginRoot, projectRoot, stateRoot) {
     const graph = await import(pathToFileURL(join(pluginRoot, "src/lib/graph.js")).href);
     const channel = await import(pathToFileURL(join(pluginRoot, "src/lib/channel-runtime.js")).href);
     await graph.upsertEntity({
-      root: projectRoot, id: "agent:install-channel", kind: "agent", displayName: "ExampleAgent",
+      root: projectRoot, id: "agent:install-channel", kind: "agent", displayName: "Franz",
       attributes: { language: "de-DE", voice: { warmth: "warm", directness: "clear", length: "concise" } },
       privacy: "shared"
     });
@@ -261,7 +261,7 @@ async function invokeInstalledChannelWake(pluginRoot, projectRoot, stateRoot, ho
     agent_spine_channel_event: { event_id: event.eventId, provider: event.provider }
   }, { extraEnv: { AGENTSPINE_INSTALL_CHANNEL_SECRET: secret } });
   if (result.channelEvent?.eventId !== event.eventId || result.channelEvent?.chatId !== event.chatId
-    || result.channelEvent?.threadId !== event.threadId || result.voiceBrief?.displayName !== "ExampleAgent"
+    || result.channelEvent?.threadId !== event.threadId || result.voiceBrief?.displayName !== "Franz"
     || result.voiceBrief?.profile?.warmth !== "warm") {
     throw new Error(`${host} installed hook did not inject the exact channel event and voice brief`);
   }
@@ -288,8 +288,8 @@ async function invokeInstalledGateway(pluginRoot, projectRoot, stateRoot) {
       bindings: [{
         id: "persona-binding:installed-gateway", authenticator: "host-manifest", issuer: "host:installed",
         tenantId: "tenant:installed-gateway", host: "codex", profileId: "profile:installed-gateway",
-        subjectId: "subject:installed-gateway", kind: "agent", displayName: "Installed ExampleAgent",
-        sourceBinding: ".codex/agents/installed-example-agent.md", groupId: "group:installed-gateway"
+        subjectId: "subject:installed-gateway", kind: "agent", displayName: "Installed Franz",
+        sourceBinding: ".codex/agents/installed-franz.md", groupId: "group:installed-gateway"
       }, {
         id: "persona-binding:installed-peer", authenticator: "host-manifest", issuer: "host:installed",
         tenantId: "tenant:installed-gateway", host: "codex", profileId: "profile:installed-gateway",

package/agent-spine-plugin/src/hook.js

@@ -431,10 +431,6 @@ async function runHookCore(input, payload, options) {
       }
       if (payload) return { blocked: false, context, briefing, preflight, signal, attentionEvent, channelEvent, lessonRecall, catalogPath };
       const output = hookOutput(event, context, process.env, sourceWarning);
-      if (preflight?.instructionNotice) {
-        output.hookSpecificOutput.message = [output.hookSpecificOutput.message, preflight.instructionNotice]
-          .filter(Boolean).join("\n");
-      }
       const handoff = await writeContextOutput(output, process.env.BLUN_PLUGIN_ROOT ? "king"
         : process.env.PLUGIN_ROOT ? "codex" : process.env.CLAUDE_PLUGIN_ROOT ? "claude" : scope.host);
       if (event === "UserPromptSubmit" && briefingOrigin) {

package/agent-spine-plugin/src/lib/documents.js

@@ -86,7 +86,7 @@ export async function indexExplicitDocuments(entries) {
       if (!metadata.isFile() || metadata.isSymbolicLink()) throw new Error(`source is not a regular non-symlink file: ${entry.id}`);
       buffer = await readFile(path);
     }
-    if (buffer.byteLength > (entry.maxBytes || 8 * 1024 * 1024)) throw new Error(`source exceeds its byte limit: ${entry.id}`);
+    if (buffer.byteLength > (entry.maxBytes || 4 * 1024 * 1024)) throw new Error(`source exceeds its byte limit: ${entry.id}`);
     const classification = classify(entry.id);
     const document = {
       path,

package/agent-spine-plugin/src/lib/hook-context.js

@@ -44,7 +44,6 @@ return null;
 
 export function hostContextLimit(preflight) {
 if (preflight?.receipt?.instructionHost === "codex") return 32768 + Buffer.byteLength(JSON.stringify(preflight.briefing || {}));
-if (preflight?.briefing?.instructions?.length) return 32768 + Buffer.byteLength(JSON.stringify(preflight.briefing));
 const mode = preflight?.receipt?.instructionBudget?.mode;
 if (mode === "claude-required-overflow") return MAX_CLAUDE_OVERFLOW_CONTEXT_BYTES;
 return STANDARD_HOST_CONTEXT_BYTES;

package/agent-spine-plugin/src/lib/host-instruction-budget.js

@@ -4,7 +4,8 @@ const KING_TOTAL = 8388608;
 export const isKingHost = (env = process.env) => !!(env.BLUN_PLUGIN_ROOT && env.BLUN_HOME);
 
 export function instructionBudget(host, usedBytes = 0, env = process.env) {
-  const hardLimitBytes = KING_TOTAL;
+  const hardLimitBytes = host === "codex" && isKingHost(env) ? KING_TOTAL
+    : host === "claude" ? 16384 : host === "codex" ? 32768 : STANDARD;
   return { mode: usedBytes > STANDARD ? `${host}-required-overflow` : "standard",
     standardBytes: STANDARD, hardLimitBytes, usedBytes, overflowBytes: Math.max(0, usedBytes - STANDARD) };
 }

package/agent-spine-plugin/src/lib/preflight.js

@@ -1,14 +1,13 @@
 import { createHash, createHmac, randomBytes, randomUUID, timingSafeEqual } from "node:crypto";
 import { constants as fsConstants } from "node:fs";
 import { spawn } from "node:child_process";
-import { StringDecoder } from "node:string_decoder";
 import { lstat, mkdir, open, readFile, realpath, stat, unlink, writeFile } from "node:fs/promises";
 import { basename, dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { isFileLockContention, replaceFileWithRetry } from "./filesystem-retry.js";
 import { ancestorsBetween, isInside, stateRoot } from "./paths.js";
 import { preflightDeliveryId } from "./preflight-delivery-id.js";
 import { resolveHostSourceCatalog } from "./source-roots.js";
-import { instructionBudget, isKingHost } from "./host-instruction-budget.js";
+import { instructionBudget } from "./host-instruction-budget.js";
 
 export const PREFLIGHT_SCHEMA = "agentspine.preflight/v2";
 export const PREFLIGHT_POLICY_SCHEMA = "agentspine.preflight-policy/v1";
@@ -327,7 +326,7 @@ async function assertNoSymlinkParents(path, allowedRoot) {
   }
   return { root, target };
 }
-async function safeReadRequired(path, allowedRoot, maximum = STANDARD_REQUIRED_INSTRUCTIONS_BYTES, fileHooks = null, contentLimit = null) {
+async function safeReadRequired(path, allowedRoot, maximum = STANDARD_REQUIRED_INSTRUCTIONS_BYTES, fileHooks = null) {
   const checked = await assertNoSymlinkParents(path, allowedRoot);
   const flags = fsConstants.O_RDONLY | (fsConstants.O_NOFOLLOW || 0);
   const handle = await open(checked.target, flags);
@@ -354,10 +353,7 @@ async function safeReadRequired(path, allowedRoot, maximum = STANDARD_REQUIRED_I
       || current.size !== before.size || current.mtimeMs !== before.mtimeMs || current.ctimeMs !== before.ctimeMs) {
       throw new Error(`required instruction ${basename(path)} was replaced during preflight`);
     }
-    const decoder = new StringDecoder("utf8");
-    const content = contentLimit === null ? buffer.toString("utf8") : decoder.write(buffer.subarray(0, contentLimit));
-    const readBytes = Buffer.byteLength(content);
-    return { content, bytes: buffer.length, readBytes, omittedBytes: buffer.length - readBytes, sha256: sha256(buffer),
+    return { content: buffer.toString("utf8"), bytes: buffer.length, sha256: sha256(buffer),
       identity: sha256(`${before.dev}\0${before.ino}\0${before.size}\0${before.mtimeMs}\0${before.ctimeMs}`) };
   } finally { await handle.close(); }
 }
@@ -496,19 +492,16 @@ export async function runPreflight({ input, scope, resolvedSources, prompt, now
   const requiredInstructions = [];
   let instructionBytes = 0;
   const maximumInstructionBytes = instructionBudget(instructionHost, 0, env).hardLimitBytes;
-  const kingInstructions = instructionHost === "codex" && isKingHost(env);
-  const contentBudget = kingInstructions ? 900000 : 32768;
   for (const document of documents) {
     const allowedRoot = document.sourceScope === "user" ? resolvedSources.hostHome : resolvedSources.projectRoot;
-    const snapshot = await safeReadRequired(document.path, allowedRoot, maximumInstructionBytes, fileHooks, Math.max(0, contentBudget - instructionBytes));
+    const snapshot = await safeReadRequired(document.path, allowedRoot, maximumInstructionBytes, fileHooks);
     if (snapshot.sha256 !== document.sha256 || snapshot.bytes !== document.bytes) throw new Error(`required instruction changed after source resolution: ${document.relativePath}`);
-    instructionBytes += snapshot.readBytes;
+    instructionBytes += snapshot.bytes;
     if (instructionBytes > maximumInstructionBytes) {
       throw new Error(`required host instructions total ${instructionBytes} bytes; mandatory limit is ${maximumInstructionBytes} bytes`);
     }
     requiredInstructions.push({ path: document.path, displayPath: document.relativePath, scope: document.sourceScope,
-      bytes: snapshot.bytes, readBytes: snapshot.readBytes, omittedBytes: snapshot.omittedBytes,
-      sha256: snapshot.sha256, identity: snapshot.identity, content: snapshot.content });
+      bytes: snapshot.bytes, sha256: snapshot.sha256, identity: snapshot.identity, content: snapshot.content });
   }
   const appliedInstructionBudget = instructionBudget(instructionHost, instructionBytes, env);
   const memoryState = validateMemories(await readJson(paths.memories, MAX_STATE_BYTES, emptyMemories));
@@ -555,7 +548,6 @@ export async function runPreflight({ input, scope, resolvedSources, prompt, now
   const key = await signingKey(paths); const bodyDigest = digestObject(receiptBody);
   const receipt = { id: `preflight:${bodyDigest.slice(0, 32)}`, ...receiptBody, bodyDigest,
     signature: createHmac("sha256", key).update(bodyDigest).digest("hex") };
-  let instructionNotice = null;
   await withLock(paths, async () => {
     const state = await readVerifiedState(paths);
     state.receipts = state.receipts.filter((item) => new Date(item.receipt?.expiresAt || 0).getTime() >= new Date(createdAt).getTime() - RECEIPT_TTL_MS);
@@ -565,25 +557,6 @@ export async function runPreflight({ input, scope, resolvedSources, prompt, now
     const envelope = { receipt, consumedAt: null, invalidatedAt: null, stateSignature: "" };
     envelope.stateSignature = createHmac("sha256", key).update(envelopeBody(envelope)).digest("hex");
     state.receipts.push(envelope); state.revision += 1;
-    if (requiredInstructions.length > 0) {
-      const notices = [];
-      for (const item of requiredInstructions.filter((instruction) => instruction.bytes > 8192)) {
-        const sessionDigest = sha256(`${exactScope.sessionId}\0${item.path}`);
-        if (state.history.some((event) => event.event === "instruction-notice" && event.sessionDigest === sessionDigest)) continue;
-        state.history.push({ event: "instruction-notice", sessionDigest, at: createdAt, authority: "diagnostic-only" });
-        notices.push(`${item.displayPath}: ${item.bytes} bytes; ${item.readBytes} read; ${item.omittedBytes} omitted.`);
-      }
-      const totalBytes = requiredInstructions.reduce((sum, item) => sum + item.bytes, 0);
-      const omittedBytes = totalBytes - instructionBytes;
-      if (omittedBytes > 0) {
-        const totalDigest = sha256(`${exactScope.sessionId}\0instruction-total`);
-        if (!state.history.some((event) => event.event === "instruction-notice" && event.sessionDigest === totalDigest)) {
-          state.history.push({ event: "instruction-notice", sessionDigest: totalDigest, at: createdAt, authority: "diagnostic-only" });
-          notices.push(`Instruction total: ${totalBytes} bytes; ${instructionBytes} read; ${omittedBytes} omitted.`);
-        }
-      }
-      instructionNotice = notices.join("\n") || null;
-    }
     state.lastTurn = { status: "ready", receiptId: receipt.id, at: createdAt, host: exactScope.host,
       instructionHost, instructionFiles: receipt.instructionFiles.length, recall: receipt.providerQueries.map((item) => ({
         providerId: item.providerId, status: item.status, rejected: item.rejected
@@ -591,7 +564,7 @@ export async function runPreflight({ input, scope, resolvedSources, prompt, now
     state.history.push({ event: "ready", receiptId: receipt.id, at: createdAt, authority: "preflight-proof-only" });
     await writeJson(paths.state, state);
   });
-  return { receipt, briefing, instructionNotice, policy: { configured: Boolean(profile), requiredProviderIds } };
+  return { receipt, briefing, policy: { configured: Boolean(profile), requiredProviderIds } };
 }
 
 export async function verifyPreflightReceipt({ receipt, input, scope, resolvedSources, prompt, now = new Date(), env = process.env, consume = false }) {
@@ -634,14 +607,12 @@ export async function verifyPreflightReceipt({ receipt, input, scope, resolvedSo
       || currentDocuments.some((document, index) => document.path !== receipt.instructionFiles[index]?.path)) return false;
     let instructionBytes = 0;
     const maximumInstructionBytes = instructionBudget(receipt.instructionHost, 0, env).hardLimitBytes;
-    const kingInstructions = receipt.instructionHost === "codex" && isKingHost(env);
-    const contentBudget = kingInstructions ? 900000 : 32768;
     for (const instruction of receipt.instructionFiles) {
       const allowedRoot = instruction.scope === "user" ? freshSources.hostHome : freshSources.projectRoot;
-      const currentSnapshot = await safeReadRequired(instruction.path, allowedRoot, maximumInstructionBytes, null, Math.max(0, contentBudget - instructionBytes));
+      const currentSnapshot = await safeReadRequired(instruction.path, allowedRoot, maximumInstructionBytes);
       if (currentSnapshot.sha256 !== instruction.sha256 || currentSnapshot.bytes !== instruction.bytes
         || currentSnapshot.identity !== instruction.identity) return false;
-      instructionBytes += currentSnapshot.readBytes;
+      instructionBytes += currentSnapshot.bytes;
     }
     if (instructionBytes > maximumInstructionBytes
       || canonical(receipt.instructionBudget) !== canonical(instructionBudget(receipt.instructionHost, instructionBytes, env))) return false;

package/agent-spine-plugin/src/lib/source-roots.js

@@ -376,7 +376,7 @@ export async function resolveHostSourceCatalog({ host, cwd = process.cwd(), inpu
     const codexHome = isKingHost(env) ? env.BLUN_HOME : env.CODEX_HOME || env.BLUN_HOME || join(homedir(), ".codex");
     hostHome = await existingDirectory(resolve(codexHome)) || resolve(codexHome);
     const config = await codexConfig(hostHome);
-    config.maxBytes = KING_SOURCE_BYTES;
+    if (isKingHost(env)) config.maxBytes = KING_SOURCE_BYTES;
     if (env.AGENTSPINE_ROOT) projectRoot = await canonicalPath(env.AGENTSPINE_ROOT);
     else ({ root: projectRoot, resolution: rootResolution } = await findRoot(canonicalCwd, config.rootMarkers));
     sources = await codexSources({ cwd: canonicalCwd, projectRoot, codexHome: hostHome, config });