blun-king-cli 9.1.420 → 9.1.421

package/LIESMICH.txt

@@ -97,6 +97,15 @@ erzeugen dadurch keine leeren Folgezüge. Beim nächsten Ereignis wird der
 gespeicherte Auslöser erneut eingeordnet. Sofortige Ziele und ältere Ziele ohne
 Checkpoint laufen unverändert weiter.
 
+Ab BLUN King 9.1.421 muss ein wartendes Ziel mit Zeit-Trigger einen genauen
+`dueAt`-Zeitpunkt speichern. Der Zeitpunkt wird auf UTC normalisiert. Bei einem
+natürlichen Sitzungsstart im Auto- oder God-Modus wartet das Ziel vor diesem
+Zeitpunkt weiter und startet, sobald der Zeitpunkt erreicht oder überschritten
+ist. Der erste Fortsetzungszug erhält die gespeicherte Fälligkeit als
+ausdrücklichen Trigger-Beleg. Andere Trigger-Arten dürfen kein `dueAt`
+enthalten. Ein Laufzeit-Wecker für eine durchgehend geöffnete Sitzung ist in
+diesem Release noch nicht enthalten.
+
 Zuverlässiger King-Start
 -----------------------
 Bei einer ausdrücklich als wiederholbar gekennzeichneten Serverüberlastung

package/README.md

@@ -116,6 +116,15 @@ erzeugen dadurch keine leeren Folgezüge. Beim nächsten Ereignis wird der
 gespeicherte Auslöser erneut eingeordnet. Sofortige Ziele und ältere Ziele ohne
 Checkpoint laufen unverändert weiter.
 
+Ab BLUN King 9.1.421 muss ein wartendes Ziel mit Zeit-Trigger einen genauen
+`dueAt`-Zeitpunkt speichern. Der Zeitpunkt wird auf UTC normalisiert. Bei einem
+natürlichen Sitzungsstart im Auto- oder God-Modus wartet das Ziel vor diesem
+Zeitpunkt weiter und startet, sobald der Zeitpunkt erreicht oder überschritten
+ist. Der erste Fortsetzungszug erhält die gespeicherte Fälligkeit als
+ausdrücklichen Trigger-Beleg. Andere Trigger-Arten dürfen kein `dueAt`
+enthalten. Ein Laufzeit-Wecker für eine durchgehend geöffnete Sitzung ist in
+diesem Release noch nicht enthalten.
+
 ## Zuverlässiger King-Start
 
 Bei einer vom Server ausdrücklich als wiederholbar gekennzeichneten

package/bin/cognitive-action-checkpoint.cjs

@@ -20,11 +20,12 @@ const PROBLEM_FRAME_KEYS = new Set([
   'successCriterion', 'missingKnowledge', 'candidateActions', 'selectedAction',
   'selectionReason', 'supportChoice', 'risk', 'reversibility',
 ]);
-const NEXT_TRIGGER_KEYS = new Set(['kind', 'condition']);
+const NEXT_TRIGGER_KEYS = new Set(['kind', 'condition', 'dueAt']);
 const EVIDENCE_INPUT_KEYS = new Set([
   'turnId', 'toolCallId', 'toolName', 'decision', 'outcome', 'durationMs',
 ]);
 const EVIDENCE_DIGEST_RE = /^[a-f0-9]{16}$/u;
+const ISO_TIMESTAMP_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,9})?(?:Z|[+-]\d{2}(?::?\d{2})?)$/u;
 
 function bounded(value, field, max = 512) {
   const text = String(value ?? '')
@@ -35,9 +36,12 @@ function bounded(value, field, max = 512) {
   return text.length <= max ? text : `${text.slice(0, max - 3).trimEnd()}...`;
 }
 
-function normalizedTimestamp(value) {
+function normalizedTimestamp(value, field = 'updatedAt', requireIsoString = false) {
+  if (requireIsoString && (typeof value !== 'string' || !ISO_TIMESTAMP_RE.test(value))) {
+    throw new TypeError(`${field} must be an ISO timestamp`);
+  }
   const date = new Date(value);
-  if (!Number.isFinite(date.getTime())) throw new TypeError('updatedAt must be an ISO timestamp');
+  if (!Number.isFinite(date.getTime())) throw new TypeError(`${field} must be an ISO timestamp`);
   return date.toISOString();
 }
 
@@ -96,10 +100,18 @@ function normalizeNextTrigger(input, phase) {
   if (phase !== 'wait' && kind !== 'immediate') {
     throw new TypeError('non-wait phase requires an immediate nextTrigger');
   }
-  return Object.freeze({
+  if (kind === 'time' && input.dueAt === undefined) {
+    throw new TypeError('time nextTrigger requires dueAt');
+  }
+  if (kind !== 'time' && input.dueAt !== undefined) {
+    throw new TypeError('dueAt is only valid for a time nextTrigger');
+  }
+  const trigger = {
     kind,
     condition: bounded(input.condition, 'nextTrigger condition'),
-  });
+  };
+  if (kind === 'time') trigger.dueAt = normalizedTimestamp(input.dueAt, 'nextTrigger dueAt', true);
+  return Object.freeze(trigger);
 }
 
 function normalizedEvidenceBasis(value, allowLegacy = false) {
@@ -287,6 +299,7 @@ function projectActionCheckpoint(checkpoint) {
   lines.push(`Expected evidence: ${value.expectedEvidence}`);
   if (value.nextTrigger !== undefined) {
     lines.push(`Next trigger: ${value.nextTrigger.kind.replaceAll('_', ' ')} - ${value.nextTrigger.condition}`);
+    if (value.nextTrigger.dueAt !== undefined) lines.push(`Due at: ${value.nextTrigger.dueAt}`);
   }
   if (value.problemFrame !== undefined) {
     const frame = value.problemFrame;

package/bin/cognitive-goal-autostart-policy.cjs

@@ -2,23 +2,35 @@
 
 const AUTONOMOUS_PERMISSION_MODES = new Set(['auto', 'yolo']);
 const ACTIVE_PHASES = new Set(['orient', 'plan', 'act', 'verify', 'learn']);
+const ISO_TIMESTAMP_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,9})?(?:Z|[+-]\d{2}(?::?\d{2})?)$/u;
 const START = Object.freeze({ kind: 'start', trigger: 'immediate' });
 const WAIT = Object.freeze({ kind: 'wait' });
 const CONTINUE = Object.freeze({ kind: 'continue' });
 const YIELD = Object.freeze({ kind: 'yield' });
 
-function goalAutostartDecision({ goal, permissionMode } = {}) {
+function goalAutostartDecision({ goal, permissionMode, now = new Date() } = {}) {
   if (!goal || typeof goal !== 'object' || Array.isArray(goal)) return WAIT;
   if (goal.status !== 'active' || !AUTONOMOUS_PERMISSION_MODES.has(permissionMode)) return WAIT;
 
   const checkpoint = goal.actionCheckpoint;
   if (!checkpoint || typeof checkpoint !== 'object' || Array.isArray(checkpoint)) return WAIT;
-  if (!ACTIVE_PHASES.has(checkpoint.phase)) return WAIT;
   const trigger = checkpoint.nextTrigger;
   if (!trigger || typeof trigger !== 'object' || Array.isArray(trigger)) return WAIT;
-  if (trigger.kind !== 'immediate') return WAIT;
   if (typeof trigger.condition !== 'string' || trigger.condition.trim().length === 0) return WAIT;
-  return START;
+  if (ACTIVE_PHASES.has(checkpoint.phase) && trigger.kind === 'immediate') return START;
+  if (checkpoint.phase !== 'wait' || trigger.kind !== 'time') return WAIT;
+
+  const dueAt = String(trigger.dueAt ?? '');
+  if (!ISO_TIMESTAMP_RE.test(dueAt)) return WAIT;
+  const dueAtMs = new Date(dueAt).getTime();
+  const nowMs = new Date(now).getTime();
+  if (!Number.isFinite(dueAtMs) || !Number.isFinite(nowMs) || dueAtMs > nowMs) return WAIT;
+  return Object.freeze({
+    kind: 'start',
+    trigger: 'time',
+    dueAt,
+    observation: `The checkpointed time trigger became due at ${dueAt}.`,
+  });
 }
 
 function goalContinuationDecision({ goal } = {}) {

package/blun.mjs

@@ -245769,7 +245769,8 @@ var init_events$1 = __esmMin((() => {
 			expectedEvidence: string(),
 			nextTrigger: object({
 				kind: _enum(["immediate", "external_event", "time", "dependency", "user_decision"]),
-				condition: string()
+				condition: string(),
+				dueAt: string().optional()
 			}).strict().optional(),
 			problemFrame: object({
 				successCriterion: string(),
@@ -260288,8 +260289,26 @@ function createActionCheckpointInputSchema(problemFrameSchema, requireProblemFra
 		expectedEvidence: string().min(1).max(512),
 		nextTrigger: object({
 			kind: _enum(["immediate", "external_event", "time", "dependency", "user_decision"]),
-			condition: string().min(1).max(512)
-		}).strict(),
+			condition: string().min(1).max(512),
+			dueAt: string().min(1).max(64).optional()
+		}).strict().superRefine((value, ctx) => {
+			if (value.kind === "time") {
+				if (value.dueAt === void 0) ctx.addIssue({
+					code: "custom",
+					path: ["dueAt"],
+					message: "time nextTrigger requires dueAt"
+				});
+				else if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,9})?(?:Z|[+-]\d{2}(?::?\d{2})?)$/u.test(value.dueAt) || !Number.isFinite(new Date(value.dueAt).getTime())) ctx.addIssue({
+					code: "custom",
+					path: ["dueAt"],
+					message: "dueAt must be an ISO timestamp"
+				});
+			} else if (value.dueAt !== void 0) ctx.addIssue({
+				code: "custom",
+				path: ["dueAt"],
+				message: "dueAt is only valid for a time nextTrigger"
+			});
+		}),
 		problemFrame: requireProblemFrame ? problemFrameSchema : problemFrameSchema.optional()
 	}).strict();
 }
@@ -262782,7 +262801,7 @@ var init_outcome_prompts = __esmMin((() => {}));
 //#region ../../packages/agent-core/src/tools/builtin/goal/update-goal.md?raw
 var update_goal_default;
 var init_update_goal$1 = __esmMin((() => {
-	update_goal_default = "Update the current autonomous goal. Set `status` only for a lifecycle change. After a coherent work slice, save `actionCheckpoint` with a monotone revision, the last verified result, exact next action, expected evidence, exact `nextTrigger`, and an explicit evidence basis. Persist the exact `nextTrigger` that releases `nextAction`: use `immediate` outside the `wait` phase; while waiting, name the external event, time, dependency, or user decision instead of pretending work can continue. Use `runtime_tool` only when a successful tool in this turn measured the result; use `user_statement` for a direct user assertion, `external_report` for a report not independently measured here, and `carried_forward` only when the last verified text is unchanged. Classify knowledge as `verified`, `credible_unverified`, `hypothesis`, `uncertain_memory`, `stale`, or `unknown`; never present a weaker state as verified, and preserve the state on carry-forward. Start at revision 1 and increment the currently projected revision by exactly one; stale writers fail closed. This is durable progress state, not permission, and should change only when the facts change. A checkpoint-only call keeps the goal active.\n\n- `active` — resume a paused or blocked goal when the user explicitly asks you to work on that goal.\n- `complete` — the objective is fully satisfied, all files are written, all tests pass, and any stated validation has passed. When the goal has a completion criterion, first save a `verify` checkpoint with `runtime_tool`, `verified`, and a successful runtime evidence receipt.\n- `blocked` — a genuine external condition or required user decision prevents progress.\n- `paused` — set the goal aside for now.\n\nDo not mark complete after a plan or partial result. If useful work remains, checkpoint it and continue. Do not ask for permission merely to execute an already authorized checkpoint; ask only at a real rights boundary or missing user decision.\n";
+	update_goal_default = "Update the current autonomous goal. Set `status` only for a lifecycle change. After a coherent work slice, save `actionCheckpoint` with a monotone revision, the last verified result, exact next action, expected evidence, exact `nextTrigger`, and an explicit evidence basis. Persist the exact `nextTrigger` that releases `nextAction`: use `immediate` outside the `wait` phase; while waiting, name the external event, time, dependency, or user decision instead of pretending work can continue. A `time` trigger must include the exact ISO timestamp in `dueAt`; no other trigger kind may include `dueAt`. Use `runtime_tool` only when a successful tool in this turn measured the result; use `user_statement` for a direct user assertion, `external_report` for a report not independently measured here, and `carried_forward` only when the last verified text is unchanged. Classify knowledge as `verified`, `credible_unverified`, `hypothesis`, `uncertain_memory`, `stale`, or `unknown`; never present a weaker state as verified, and preserve the state on carry-forward. Start at revision 1 and increment the currently projected revision by exactly one; stale writers fail closed. This is durable progress state, not permission, and should change only when the facts change. A checkpoint-only call keeps the goal active.\n\n- `active` — resume a paused or blocked goal when the user explicitly asks you to work on that goal.\n- `complete` — the objective is fully satisfied, all files are written, all tests pass, and any stated validation has passed. When the goal has a completion criterion, first save a `verify` checkpoint with `runtime_tool`, `verified`, and a successful runtime evidence receipt.\n- `blocked` — a genuine external condition or required user decision prevents progress.\n- `paused` — set the goal aside for now.\n\nDo not mark complete after a plan or partial result. If useful work remains, checkpoint it and continue. Do not ask for permission merely to execute an already authorized checkpoint; ask only at a real rights boundary or missing user decision.\n";
 	update_goal_default += "\nFor a non-trivial or unfamiliar problem, preserve `problemFrame` with the success criterion, missing knowledge, bounded candidate actions, selected action and reason, support choice, risk, and reversibility. The selected action must match one candidate. Problem framing is descriptive state and never grants permission.\n";
 }));
 //#endregion
@@ -516673,9 +516692,11 @@ var BlunTUI = class {
 		const sessionId = session.id;
 		const autostart = goalAutostartDecision({
 			goal,
-			permissionMode: this.state.appState.permissionMode
+			permissionMode: this.state.appState.permissionMode,
+			now: new Date()
 		});
 		if (autostart.kind === "start") {
+			const autostartPrompt = autostart.observation === void 0 ? GOAL_CONTINUATION_PROMPT : `${GOAL_CONTINUATION_PROMPT}\n\n${autostart.observation}`;
 			this.startupGoalPromptedSessionId = sessionId;
 			this.beginSessionRequest();
 			this.setAppState({
@@ -516683,7 +516704,7 @@ var BlunTUI = class {
 				modelFallbackAllowed: false
 			});
 			try {
-				const result = await session.promptAccepted(GOAL_CONTINUATION_PROMPT);
+				const result = await session.promptAccepted(autostartPrompt);
 				if (!result.accepted && this.session?.id === sessionId) {
 					this.setAppState({ streamingPhase: "idle" });
 					this.resetLivePane();

package/package.json

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