blun-king-cli 9.1.504 → 9.1.505

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 9.1.505 - 2026-08-30
+
+- Preserves Telegram messages that arrive after a TUI claims channel ownership but before the delayed channel activation finishes.
+- Captures the queue boundary at ownership start, keeps a valid durable checkpoint authoritative, and consumes a replaced queue from byte zero.
+- Adds a regression for the measured update handoff where message 63456 arrived after ownership began and was skipped one second later as historical backlog.
+
 ## 9.1.504 - 2026-08-30
 
 - Starts an automatically queued Telegram message as a fresh model turn when King is idle instead of waiting forever for an already active turn.

package/LIESMICH.txt

@@ -9,7 +9,7 @@ Installation
 ------------
 Die geprüfte Version exakt global installieren:
 
-  npm install -g blun-king-cli@9.1.504
+  npm install -g blun-king-cli@9.1.505
 
 Start
 -----
@@ -69,6 +69,11 @@ Version 9.1.504 startet eine automatisch eingereihte Telegram-Nachricht im
 Leerlauf als neuen Modellzug. Sie wartet damit nicht mehr auf einen bereits
 laufenden Zug, der im Leerlauf definitionsgemaess nie entstehen kann.
 
+Version 9.1.505 bewahrt Telegram-Nachrichten, die waehrend der kurzen
+Kanal-Uebergabe nach dem Eigentumsanspruch, aber vor der Aktivierung eintreffen.
+Der Startstand der Queue wird eingefroren; nur der bereits davor vorhandene
+Altbestand darf ohne gueltigen Checkpoint uebersprungen werden.
+
 Version 9.1.503 ergaenzt die isolierte Wartungsnachricht um das vom Anbieterpfad
 erwartete leere toolCalls-Feld. Dadurch erreicht der Wartungsschritt das Modell,
 statt in der Nachrichten-Normalisierung mit einem TypeError abzubrechen.

package/README.md

@@ -9,7 +9,7 @@ Voraussetzung ist Node.js 24.15 oder neuer. Die geprüfte Version wird exakt
 installiert:
 
 ```powershell
-npm install -g blun-king-cli@9.1.504
+npm install -g blun-king-cli@9.1.505
 ```
 
 ## Reproduzierbares Staging und Packen

package/bin/telegram-queue-handoff-policy.cjs

@@ -0,0 +1,49 @@
+'use strict';
+
+function queueFileIdentity(stats) {
+  if (!stats) return '';
+  return `${stats.dev}:${stats.ino}:${stats.birthtimeMs}`;
+}
+
+function captureTelegramQueueBaseline(stats) {
+  const fileId = queueFileIdentity(stats);
+  const offset = Number(stats?.size);
+  if (!fileId || !Number.isSafeInteger(offset) || offset < 0) {
+    return { fileId: '', offset: 0 };
+  }
+  return { fileId, offset };
+}
+
+function validCheckpoint(checkpoint, queueFileId, queueSize) {
+  return checkpoint?.version === 1
+    && checkpoint.fileId === queueFileId
+    && Number.isSafeInteger(checkpoint.offset)
+    && checkpoint.offset >= 0
+    && checkpoint.offset <= queueSize;
+}
+
+function resolveTelegramQueueActivationOffset(input) {
+  const queueFileId = String(input?.queueFileId ?? '');
+  const queueSize = Number(input?.queueSize);
+  const baseline = input?.baseline;
+  if (!queueFileId || !Number.isSafeInteger(queueSize) || queueSize < 0) {
+    return { offset: 0, reason: 'queue_unavailable' };
+  }
+  if (validCheckpoint(input?.checkpoint, queueFileId, queueSize)) {
+    return { offset: input.checkpoint.offset, reason: 'checkpoint' };
+  }
+  if (
+    baseline?.fileId === queueFileId
+    && Number.isSafeInteger(baseline.offset)
+    && baseline.offset >= 0
+    && baseline.offset <= queueSize
+  ) {
+    return { offset: baseline.offset, reason: 'ownership_baseline' };
+  }
+  return { offset: 0, reason: 'queue_replaced' };
+}
+
+module.exports = {
+  captureTelegramQueueBaseline,
+  resolveTelegramQueueActivationOffset,
+};

package/blun.mjs

@@ -419615,6 +419615,7 @@ var { createDirectFocusController, createDirectReplyTurnStop, enqueueTelegramDir
 var { enqueueTelegramAddressed } = createRequire(import.meta.url)("./bin/telegram-addressed-priority.cjs");
 var { enqueueTelegramBotPriority, telegramBotPriorityMessage } = createRequire(import.meta.url)("./bin/telegram-bot-priority.cjs");
 var { createAddressedChannelFocusStore } = createRequire(import.meta.url)("./bin/telegram-addressed-focus.cjs");
+var { captureTelegramQueueBaseline, resolveTelegramQueueActivationOffset } = createRequire(import.meta.url)("./bin/telegram-queue-handoff-policy.cjs");
 var { removeQueuedReloadCommands, removeQueuedSlashCommands } = createRequire(import.meta.url)("./bin/reload-queue-policy.cjs");
 const MAX_BUFFERED_CONTEXT_MESSAGES = 20;
 const MAX_BUFFERED_CONTEXT_CHARS = 24e3;
@@ -419928,6 +419929,7 @@ var TelegramChannelController = class {
 	offset = 0;
 	checkpointOffset = 0;
 	queueFileId = "";
+	queueClaimBaseline = { fileId: "", offset: 0 };
 	remainder = Buffer.alloc(0);
 	pendingQueueLines = [];
 	started = false;
@@ -419985,6 +419987,11 @@ var TelegramChannelController = class {
 		try {
 			mkdirSync(this.dir, { recursive: true });
 		} catch {}
+		try {
+			this.queueClaimBaseline = captureTelegramQueueBaseline(statSync(this.queueFile));
+		} catch {
+			this.queueClaimBaseline = { fileId: "", offset: 0 };
+		}
 		if (!this.claimOwnership()) return;
 		this.ownershipTimer = setInterval(() => this.checkOwnership(), this.ownershipPollMs);
 		this.ownershipTimer.unref();
@@ -420004,11 +420011,14 @@ var TelegramChannelController = class {
 			const stats = statSync(this.queueFile);
 			this.queueFileId = queueIdentity(stats);
 			const checkpoint = this.readQueueCheckpoint();
-			if (checkpoint?.fileId === this.queueFileId && checkpoint.offset >= 0 && checkpoint.offset <= stats.size) this.offset = checkpoint.offset;
-			else {
-				this.offset = stats.size;
-				this.writeQueueCheckpoint(this.offset);
-			}
+			const activation = resolveTelegramQueueActivationOffset({
+				queueFileId: this.queueFileId,
+				queueSize: stats.size,
+				checkpoint,
+				baseline: this.queueClaimBaseline
+			});
+			this.offset = activation.offset;
+			if (activation.reason !== "checkpoint") this.writeQueueCheckpoint(this.offset);
 			this.checkpointOffset = this.offset;
 		} catch {
 			this.offset = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blun-king-cli",
-  "version": "9.1.504",
+  "version": "9.1.505",
   "description": "BLUN CLI - your own AI agent with a Telegram channel. Get it done. With BLUN.",
   "license": "MIT",
   "bin": {