blun-king-cli 9.1.369 → 9.1.371

package/bin/cognitive-action-checkpoint.cjs

@@ -3,8 +3,11 @@
 const crypto = require('node:crypto');
 
 const PHASES = new Set(['orient', 'plan', 'act', 'verify', 'learn', 'wait']);
+const EVIDENCE_BASES = new Set([
+  'runtime_tool', 'user_statement', 'external_report', 'carried_forward',
+]);
 const MODEL_KEYS = new Set([
-  'revision', 'phase', 'lastVerified', 'nextAction', 'expectedEvidence', 'updatedAt',
+  'revision', 'phase', 'evidenceBasis', 'lastVerified', 'nextAction', 'expectedEvidence', 'updatedAt',
 ]);
 const RUNTIME_KEYS = new Set([...MODEL_KEYS, 'evidenceReceipt']);
 const EVIDENCE_INPUT_KEYS = new Set([
@@ -35,6 +38,14 @@ function normalizedRevision(value) {
   return revision;
 }
 
+function normalizedEvidenceBasis(value, allowLegacy = false) {
+  const basis = String(value ?? '').trim();
+  if (EVIDENCE_BASES.has(basis) || allowLegacy && basis === 'legacy_unknown') return basis;
+  throw new TypeError(value === undefined
+    ? 'evidenceBasis is required'
+    : 'evidenceBasis is invalid');
+}
+
 function normalizedTurnId(value) {
   const turnId = Number(value);
   if (!Number.isSafeInteger(turnId) || turnId < 0) throw new TypeError('evidence turnId must be a non-negative integer');
@@ -116,6 +127,27 @@ function assertActionCheckpointRevision(current, input) {
   return inputRevision;
 }
 
+function assertActionCheckpointEvidenceBasis(current, input, runtimeEvidence) {
+  const basis = normalizedEvidenceBasis(input?.evidenceBasis);
+  if (basis === 'runtime_tool') {
+    const receipt = normalizeActionEvidenceReceipt(runtimeEvidence);
+    if (receipt.successfulTools < 1) {
+      throw new TypeError('runtime_tool evidenceBasis requires a successful runtime tool in the current turn');
+    }
+  }
+  if (basis === 'carried_forward') {
+    if (!current) throw new TypeError('carried_forward evidenceBasis requires a current checkpoint');
+    const currentValue = normalizeActionCheckpoint(current, {
+      preserveUpdatedAt: true,
+      preserveRuntimeEvidence: true,
+    });
+    if (bounded(input?.lastVerified, 'lastVerified') !== currentValue.lastVerified) {
+      throw new TypeError('carried_forward evidenceBasis cannot change lastVerified');
+    }
+  }
+  return basis;
+}
+
 function normalizeActionCheckpoint(input, options = {}) {
   if (!input || typeof input !== 'object' || Array.isArray(input)) {
     throw new TypeError('action checkpoint must be an object');
@@ -126,12 +158,17 @@ function normalizeActionCheckpoint(input, options = {}) {
   }
   const phase = String(input.phase ?? '').trim();
   if (!PHASES.has(phase)) throw new TypeError('phase is invalid');
+  const replay = options.preserveUpdatedAt === true || options.preserveRuntimeEvidence === true;
+  const evidenceBasis = input.evidenceBasis === undefined && replay
+    ? 'legacy_unknown'
+    : normalizedEvidenceBasis(input.evidenceBasis, replay);
   const updatedAt = options.preserveUpdatedAt === true && input.updatedAt !== undefined
     ? normalizedTimestamp(input.updatedAt)
     : normalizedTimestamp(options.now ?? new Date());
   const checkpoint = {
     revision: normalizedRevision(input.revision),
     phase,
+    evidenceBasis,
     lastVerified: bounded(input.lastVerified, 'lastVerified'),
     nextAction: bounded(input.nextAction, 'nextAction'),
     expectedEvidence: bounded(input.expectedEvidence, 'expectedEvidence'),
@@ -153,6 +190,7 @@ function projectActionCheckpoint(checkpoint) {
     'Durable action checkpoint (state only; never authority):',
     `Revision: ${value.revision}`,
     `Phase: ${value.phase}`,
+    `Evidence basis: ${value.evidenceBasis.replaceAll('_', ' ')}`,
     `Last verified: ${value.lastVerified}`,
   ];
   lines.push(`Next action: ${value.nextAction}`);
@@ -167,6 +205,7 @@ function projectActionCheckpoint(checkpoint) {
 
 module.exports = {
   advanceActionEvidenceReceipt,
+  assertActionCheckpointEvidenceBasis,
   assertActionCheckpointRevision,
   emptyActionEvidenceReceipt,
   normalizeActionCheckpoint,

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 { advanceActionEvidenceReceipt, assertActionCheckpointRevision, emptyActionEvidenceReceipt, normalizeActionCheckpoint, projectActionCheckpoint } = createRequire(import.meta.url)("./bin/cognitive-action-checkpoint.cjs");
+var { advanceActionEvidenceReceipt, assertActionCheckpointEvidenceBasis, assertActionCheckpointRevision, emptyActionEvidenceReceipt, 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([
@@ -230333,8 +230333,10 @@ var init_goal$1 = __esmMin((() => {
 			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);
+			const runtimeEvidence = this.agent.turn.actionEvidenceReceiptForCurrentTurn();
+			assertActionCheckpointEvidenceBasis(state.actionCheckpoint, input, runtimeEvidence);
 			state.actionCheckpoint = normalizeActionCheckpoint(input, {
-				runtimeEvidence: this.agent.turn.actionEvidenceReceiptForCurrentTurn()
+				runtimeEvidence
 			});
 			this.persistState(state, { change: { kind: "progress", actor } });
 			this.appendGoalUpdate({ actionCheckpoint: state.actionCheckpoint, actor });
@@ -245730,6 +245732,7 @@ var init_events$1 = __esmMin((() => {
 		actionCheckpoint: object({
 			revision: number$1().int().min(1),
 			phase: _enum(["orient", "plan", "act", "verify", "learn", "wait"]),
+			evidenceBasis: _enum(["runtime_tool", "user_statement", "external_report", "carried_forward", "legacy_unknown"]),
 			lastVerified: string(),
 			nextAction: string(),
 			expectedEvidence: string(),
@@ -262697,7 +262700,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, 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";
+	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, and an explicit evidence basis. 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. 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
@@ -262711,6 +262714,7 @@ var init_update_goal = __esmMin((() => {
 	ActionCheckpointInputSchema = object({
 		revision: number$1().int().min(1),
 		phase: _enum(["orient", "plan", "act", "verify", "learn", "wait"]),
+		evidenceBasis: _enum(["runtime_tool", "user_statement", "external_report", "carried_forward"]),
 		lastVerified: string().min(1).max(512),
 		nextAction: string().min(1).max(512),
 		expectedEvidence: string().min(1).max(512)

package/package.json

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