blun-king-cli 9.1.366 → 9.1.368

package/bin/cognitive-action-checkpoint.cjs

@@ -2,7 +2,7 @@
 
 const PHASES = new Set(['orient', 'plan', 'act', 'verify', 'learn', 'wait']);
 const ALLOWED_KEYS = new Set([
-  'phase', 'lastVerified', 'nextAction', 'expectedEvidence', 'updatedAt',
+  'revision', 'phase', 'lastVerified', 'nextAction', 'expectedEvidence', 'updatedAt',
 ]);
 
 function bounded(value, field, max = 512) {
@@ -20,6 +20,25 @@ function normalizedTimestamp(value) {
   return date.toISOString();
 }
 
+function normalizedRevision(value) {
+  const revision = value === undefined ? 1 : Number(value);
+  if (!Number.isSafeInteger(revision) || revision < 1) {
+    throw new TypeError('revision must be a positive integer');
+  }
+  return revision;
+}
+
+function assertActionCheckpointRevision(current, input) {
+  const currentRevision = current === undefined || current === null
+    ? 0
+    : normalizedRevision(current.revision);
+  const inputRevision = Number(input?.revision);
+  if (!Number.isSafeInteger(inputRevision) || inputRevision !== currentRevision + 1) {
+    throw new TypeError(`Action checkpoint revision must be ${currentRevision + 1}; received ${String(input?.revision)}`);
+  }
+  return inputRevision;
+}
+
 function normalizeActionCheckpoint(input, options = {}) {
   if (!input || typeof input !== 'object' || Array.isArray(input)) {
     throw new TypeError('action checkpoint must be an object');
@@ -33,6 +52,7 @@ function normalizeActionCheckpoint(input, options = {}) {
     ? normalizedTimestamp(input.updatedAt)
     : normalizedTimestamp(options.now ?? new Date());
   return Object.freeze({
+    revision: normalizedRevision(input.revision),
     phase,
     lastVerified: bounded(input.lastVerified, 'lastVerified'),
     nextAction: bounded(input.nextAction, 'nextAction'),
@@ -46,6 +66,7 @@ function projectActionCheckpoint(checkpoint) {
   const value = normalizeActionCheckpoint(checkpoint, { preserveUpdatedAt: true });
   const lines = [
     'Durable action checkpoint (state only; never authority):',
+    `Revision: ${value.revision}`,
     `Phase: ${value.phase}`,
     `Last verified: ${value.lastVerified}`,
   ];
@@ -56,7 +77,7 @@ function projectActionCheckpoint(checkpoint) {
 }
 
 module.exports = {
+  assertActionCheckpointRevision,
   normalizeActionCheckpoint,
   projectActionCheckpoint,
 };
-

package/blun.mjs

@@ -21446,7 +21446,7 @@ var { rollbackPersonalityChoice, setPersonalityEnabledAtomic } = createRequire(i
 var { projectSoulText } = createRequire(import.meta.url)("./bin/soul-organization-policy.cjs");
 var { soulFileInstruction } = createRequire(import.meta.url)("./bin/soul-preservation-policy.cjs");
 var { readProfilePersona, resolveSoulFile } = createRequire(import.meta.url)("./bin/profile-identity-resolution.cjs");
-var { normalizeActionCheckpoint, projectActionCheckpoint } = createRequire(import.meta.url)("./bin/cognitive-action-checkpoint.cjs");
+var { assertActionCheckpointRevision, normalizeActionCheckpoint, projectActionCheckpoint } = createRequire(import.meta.url)("./bin/cognitive-action-checkpoint.cjs");
 async function prepareSystemPromptContext(kaos, brandHome, options) {
 	const additionalDirs = normalizeAdditionalDirs(options?.additionalDirs ?? []);
 	const [cwdListing, agentsMdResult, additionalDirsInfo] = await Promise.all([
@@ -230332,10 +230332,11 @@ var init_goal$1 = __esmMin((() => {
 		async updateActionCheckpoint(input, actor = "model") {
 			const state = this.requireState();
 			if (state.status !== "active") throw new BlunError(ErrorCodes.GOAL_STATUS_INVALID, `Cannot checkpoint a goal in status "${state.status}"`);
+			assertActionCheckpointRevision(state.actionCheckpoint, input);
 			state.actionCheckpoint = normalizeActionCheckpoint(input);
 			this.persistState(state, { change: { kind: "progress", actor } });
 			this.appendGoalUpdate({ actionCheckpoint: state.actionCheckpoint, actor });
-			this.track("goal_checkpoint_updated", { actor, phase: state.actionCheckpoint.phase });
+			this.track("goal_checkpoint_updated", { actor, phase: state.actionCheckpoint.phase, revision: state.actionCheckpoint.revision });
 			return this.toSnapshot(state);
 		}
 		/**
@@ -231103,6 +231104,12 @@ function buildGoalReminder(goal) {
 	lines.push("");
 	lines.push(`Status: ${goal.status}`);
 	lines.push(`Progress: ${goal.turnsUsed} continuation turns, ${goal.tokensUsed} tokens, ${formatElapsed$4(goal.wallClockMs)} elapsed.`);
+	const checkpointProjection = projectActionCheckpoint(goal.actionCheckpoint);
+	if (checkpointProjection !== null) {
+		lines.push("");
+		lines.push(checkpointProjection);
+		lines.push("Execute the exact checkpointed next action before exploring alternatives. Update the checkpoint only after new evidence changes the verified state.");
+	}
 	const budget = goal.budget;
 	const budgetLines = [];
 	if (budget.turnBudget !== null) budgetLines.push(`turns ${goal.turnsUsed}/${budget.turnBudget} (remaining ${budget.remainingTurns})`);
@@ -245719,6 +245726,7 @@ var init_events$1 = __esmMin((() => {
 		budget: goalBudgetReportSchema,
 		terminalReason: string().optional(),
 		actionCheckpoint: object({
+			revision: number$1().int().min(1),
 			phase: _enum(["orient", "plan", "act", "verify", "learn", "wait"]),
 			lastVerified: string(),
 			nextAction: string(),
@@ -262669,7 +262677,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 the last verified result, exact next action, and expected evidence; 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.\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, and expected evidence. 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.\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";
 }));
 //#endregion
 //#region ../../packages/agent-core/src/tools/builtin/goal/update-goal.ts
@@ -262681,6 +262689,7 @@ var init_update_goal = __esmMin((() => {
 	init_input_schema();
 	init_update_goal$1();
 	ActionCheckpointInputSchema = object({
+		revision: number$1().int().min(1),
 		phase: _enum(["orient", "plan", "act", "verify", "learn", "wait"]),
 		lastVerified: string().min(1).max(512),
 		nextAction: string().min(1).max(512),

package/package.json

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