blun-king-cli 9.1.371 → 9.1.372

package/bin/cognitive-action-checkpoint.cjs

@@ -6,8 +6,11 @@ const PHASES = new Set(['orient', 'plan', 'act', 'verify', 'learn', 'wait']);
 const EVIDENCE_BASES = new Set([
   'runtime_tool', 'user_statement', 'external_report', 'carried_forward',
 ]);
+const EPISTEMIC_STATES = new Set([
+  'verified', 'credible_unverified', 'hypothesis', 'uncertain_memory', 'stale', 'unknown',
+]);
 const MODEL_KEYS = new Set([
-  'revision', 'phase', 'evidenceBasis', 'lastVerified', 'nextAction', 'expectedEvidence', 'updatedAt',
+  'revision', 'phase', 'evidenceBasis', 'epistemicState', 'lastVerified', 'nextAction', 'expectedEvidence', 'updatedAt',
 ]);
 const RUNTIME_KEYS = new Set([...MODEL_KEYS, 'evidenceReceipt']);
 const EVIDENCE_INPUT_KEYS = new Set([
@@ -46,6 +49,14 @@ function normalizedEvidenceBasis(value, allowLegacy = false) {
     : 'evidenceBasis is invalid');
 }
 
+function normalizedEpistemicState(value, allowLegacy = false) {
+  const state = String(value ?? '').trim();
+  if (EPISTEMIC_STATES.has(state) || allowLegacy && state === 'legacy_unknown') return state;
+  throw new TypeError(value === undefined
+    ? 'epistemicState is required'
+    : 'epistemicState 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');
@@ -129,11 +140,18 @@ function assertActionCheckpointRevision(current, input) {
 
 function assertActionCheckpointEvidenceBasis(current, input, runtimeEvidence) {
   const basis = normalizedEvidenceBasis(input?.evidenceBasis);
+  const epistemicState = normalizedEpistemicState(input?.epistemicState);
   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 (epistemicState !== 'verified') {
+      throw new TypeError('runtime_tool evidenceBasis requires verified epistemicState');
+    }
+  }
+  if (basis === 'external_report' && epistemicState === 'verified') {
+    throw new TypeError('external_report evidenceBasis cannot claim verified epistemicState');
   }
   if (basis === 'carried_forward') {
     if (!current) throw new TypeError('carried_forward evidenceBasis requires a current checkpoint');
@@ -144,6 +162,9 @@ function assertActionCheckpointEvidenceBasis(current, input, runtimeEvidence) {
     if (bounded(input?.lastVerified, 'lastVerified') !== currentValue.lastVerified) {
       throw new TypeError('carried_forward evidenceBasis cannot change lastVerified');
     }
+    if (epistemicState !== currentValue.epistemicState) {
+      throw new TypeError('carried_forward evidenceBasis cannot change epistemicState');
+    }
   }
   return basis;
 }
@@ -162,6 +183,9 @@ function normalizeActionCheckpoint(input, options = {}) {
   const evidenceBasis = input.evidenceBasis === undefined && replay
     ? 'legacy_unknown'
     : normalizedEvidenceBasis(input.evidenceBasis, replay);
+  const epistemicState = input.epistemicState === undefined && replay
+    ? 'legacy_unknown'
+    : normalizedEpistemicState(input.epistemicState, replay);
   const updatedAt = options.preserveUpdatedAt === true && input.updatedAt !== undefined
     ? normalizedTimestamp(input.updatedAt)
     : normalizedTimestamp(options.now ?? new Date());
@@ -169,6 +193,7 @@ function normalizeActionCheckpoint(input, options = {}) {
     revision: normalizedRevision(input.revision),
     phase,
     evidenceBasis,
+    epistemicState,
     lastVerified: bounded(input.lastVerified, 'lastVerified'),
     nextAction: bounded(input.nextAction, 'nextAction'),
     expectedEvidence: bounded(input.expectedEvidence, 'expectedEvidence'),
@@ -191,6 +216,7 @@ function projectActionCheckpoint(checkpoint) {
     `Revision: ${value.revision}`,
     `Phase: ${value.phase}`,
     `Evidence basis: ${value.evidenceBasis.replaceAll('_', ' ')}`,
+    `Epistemic state: ${value.epistemicState.replaceAll('_', ' ')}`,
     `Last verified: ${value.lastVerified}`,
   ];
   lines.push(`Next action: ${value.nextAction}`);

package/blun.mjs

@@ -245733,6 +245733,7 @@ var init_events$1 = __esmMin((() => {
 			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"]),
+			epistemicState: _enum(["verified", "credible_unverified", "hypothesis", "uncertain_memory", "stale", "unknown", "legacy_unknown"]),
 			lastVerified: string(),
 			nextAction: string(),
 			expectedEvidence: string(),
@@ -262700,7 +262701,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, 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";
+	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. 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.\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
@@ -262715,6 +262716,7 @@ var init_update_goal = __esmMin((() => {
 		revision: number$1().int().min(1),
 		phase: _enum(["orient", "plan", "act", "verify", "learn", "wait"]),
 		evidenceBasis: _enum(["runtime_tool", "user_statement", "external_report", "carried_forward"]),
+		epistemicState: _enum(["verified", "credible_unverified", "hypothesis", "uncertain_memory", "stale", "unknown"]),
 		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.371",
+  "version": "9.1.372",
   "description": "BLUN CLI - your own AI agent with a Telegram channel. Get it done. With BLUN.",
   "license": "MIT",
   "bin": {