blun-king-cli 9.1.361 → 9.1.363

package/bin/cognitive-effective-view.cjs

@@ -14,13 +14,21 @@ function compareVariants(left, right) {
 
 function resolveCognitiveEvidenceGroup(entries) {
   if (!Array.isArray(entries) || entries.length === 0) return null;
-  const ordered = [...entries].sort((left, right) => left.occurredAt - right.occurredAt
+  const withdrawals = entries.filter((item) => Boolean(item.withdraws));
+  const deletionCutoff = withdrawals.length > 0
+    ? Math.max(...withdrawals.map((item) => item.occurredAt)) : Number.NEGATIVE_INFINITY;
+  const evidence = entries.filter((item) => !item.withdraws && item.occurredAt > deletionCutoff);
+  const superseded = new Set(evidence.map((item) => item.supersedes).filter(Boolean));
+  const active = evidence.filter((item) => !superseded.has(item.observationId));
+  if (active.length === 0) return null;
+  const ordered = [...active].sort((left, right) => left.occurredAt - right.occurredAt
     || left.index - right.index);
   const latest = ordered.at(-1);
+  const corrected = ordered.some((item) => Boolean(item.supersedes));
   const distinctValues = new Set(ordered.map((item) => item.value));
-  if (distinctValues.size === 1) return { ...latest, revised: false, contested: false, conflict: false };
+  if (distinctValues.size === 1) return { ...latest, revised: false, corrected, contested: false, conflict: false };
   if (CANONICAL_LATEST_DOMAINS.has(latest.domain)) {
-    return { ...latest, revised: true, contested: false, conflict: false };
+    return { ...latest, revised: true, corrected, contested: false, conflict: false };
   }
 
   const variants = new Map();
@@ -50,6 +58,7 @@ function resolveCognitiveEvidenceGroup(entries) {
       confidence: strongest.maxConfidence,
       occurredAt: strongest.latestOccurredAt,
       revised: false,
+      corrected,
       contested: true,
       conflict: false,
     };
@@ -59,6 +68,7 @@ function resolveCognitiveEvidenceGroup(entries) {
     confidence: strongest.maxConfidence,
     occurredAt: Math.max(...ranked.map((item) => item.latestOccurredAt)),
     revised: false,
+    corrected,
     contested: false,
     conflict: true,
   };

package/bin/cognitive-focus-projection.cjs

@@ -46,6 +46,11 @@ function buildCognitiveFocusProjection(state, { focusScopes, maxItems = 6, maxCh
     const key = clean(item?.key, 128);
     const value = clean(item?.value, 512);
     const scope = clean(item?.scope, 128);
+    const observationId = clean(item?.observation_id, 128);
+    const supersedes = item?.supersedes === null || item?.supersedes === undefined
+      ? null : clean(item.supersedes, 128);
+    const withdraws = item?.withdraws === null || item?.withdraws === undefined
+      ? null : clean(item.withdraws, 128);
     const confidence = Number(item?.confidence);
     const occurredAt = Date.parse(String(item?.occurred_at ?? ''));
     if (!FOCUS_DOMAINS.has(domain) || !key || !value || !scope || scope === 'runtime'
@@ -53,7 +58,7 @@ function buildCognitiveFocusProjection(state, { focusScopes, maxItems = 6, maxCh
         || !Number.isFinite(occurredAt)) return;
     const groupKey = `${scope}\0${domain}\0${key}`;
     const existing = groups.get(groupKey) ?? [];
-    existing.push({ domain, key, value, scope, confidence, occurredAt, index });
+    existing.push({ domain, key, value, scope, observationId, supersedes, withdraws, confidence, occurredAt, index });
     groups.set(groupKey, existing);
   });
 
@@ -76,7 +81,8 @@ function buildCognitiveFocusProjection(state, { focusScopes, maxItems = 6, maxCh
   const selected = ranked.slice(0, maxItems);
   const lines = selected.map((item) => {
     if (item.conflict) return `- Conflict: ${item.key} has incompatible evidence; verify before relying on it.`;
-    const marker = item.contested ? ' [contested; stronger evidence]' : item.revised ? ' [revised]' : '';
+    const marker = item.corrected ? ' [corrected]'
+      : item.contested ? ' [contested; stronger evidence]' : item.revised ? ' [revised]' : '';
     return `- ${LABELS.get(item.domain)}: ${item.value}${marker}`;
   });
   while ([`Current durable focus (${lines.length} items):`, ...lines, SAFETY_LINE].join('\n').length > maxChars

package/bin/cognitive-state-store.cjs

@@ -52,7 +52,7 @@ function normalizeSource(source) {
 }
 
 function normalizeObservation(value) {
-  const allowed = new Set(['observation_id', 'domain', 'key', 'value', 'confidence', 'scope']);
+  const allowed = new Set(['observation_id', 'domain', 'key', 'value', 'confidence', 'scope', 'supersedes', 'withdraws']);
   if (!exactKeys(value, allowed) || hasForbiddenKey(value)) fail('COGNITIVE_FORBIDDEN_FIELD');
   const observation = {
     observation_id: safeId(value.observation_id),
@@ -68,6 +68,17 @@ function normalizeObservation(value) {
     fail('COGNITIVE_INVALID_EVENT');
   }
   if (FORBIDDEN_KEY_RE.test(observation.key)) fail('COGNITIVE_FORBIDDEN_FIELD');
+  if (value.supersedes !== undefined && value.supersedes !== null) {
+    observation.supersedes = safeId(value.supersedes);
+    if (!observation.supersedes || observation.confidence !== 1) fail('COGNITIVE_INVALID_CORRECTION');
+  }
+  if (value.withdraws !== undefined && value.withdraws !== null) {
+    observation.withdraws = safeId(value.withdraws);
+    if (!observation.withdraws || observation.confidence !== 1 || observation.value !== 'withdrawn') {
+      fail('COGNITIVE_INVALID_WITHDRAWAL');
+    }
+  }
+  if (observation.supersedes && observation.withdraws) fail('COGNITIVE_INVALID_EVENT');
   return observation;
 }
 
@@ -143,7 +154,9 @@ function initialize(db) {
       confidence REAL NOT NULL,
       scope TEXT NOT NULL,
       source_json TEXT NOT NULL,
-      occurred_at TEXT NOT NULL
+      occurred_at TEXT NOT NULL,
+      supersedes_observation_id TEXT,
+      withdraws_observation_id TEXT
     );
     CREATE INDEX IF NOT EXISTS cognitive_observations_stream
       ON cognitive_observations (tenant_id, agent_id, occurred_at, observation_id);
@@ -167,6 +180,13 @@ function initialize(db) {
       PRIMARY KEY (tenant_id, receipt_id)
     );
   `);
+  const observationColumns = db.prepare('PRAGMA table_info(cognitive_observations)').all();
+  if (!observationColumns.some((column) => column.name === 'supersedes_observation_id')) {
+    db.exec('ALTER TABLE cognitive_observations ADD COLUMN supersedes_observation_id TEXT');
+  }
+  if (!observationColumns.some((column) => column.name === 'withdraws_observation_id')) {
+    db.exec('ALTER TABLE cognitive_observations ADD COLUMN withdraws_observation_id TEXT');
+  }
 }
 
 function openCognitiveStateStore({ home } = {}) {
@@ -198,12 +218,27 @@ function openCognitiveStateStore({ home } = {}) {
         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`)
         .run(normalized.event_id, normalized.tenant_id, normalized.agent_id, actualVersion, newVersion, normalized.occurred_at, payload, previousHash, eventHash);
       const insertObservation = db.prepare(`INSERT INTO cognitive_observations
-        (observation_id, event_id, tenant_id, agent_id, domain, fact_key, value_text, confidence, scope, source_json, occurred_at)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+        (observation_id, event_id, tenant_id, agent_id, domain, fact_key, value_text, confidence, scope, source_json, occurred_at, supersedes_observation_id, withdraws_observation_id)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
       const sourceJson = JSON.stringify(normalized.source);
       for (const observation of normalized.observations) {
+        if (observation.supersedes) {
+          const target = db.prepare(`SELECT tenant_id, agent_id, domain, fact_key, scope
+            FROM cognitive_observations WHERE observation_id = ?`).get(observation.supersedes);
+          if (!target || target.tenant_id !== normalized.tenant_id || target.agent_id !== normalized.agent_id
+              || target.domain !== observation.domain || target.fact_key !== observation.key
+              || target.scope !== observation.scope) fail('COGNITIVE_INVALID_CORRECTION');
+        }
+        if (observation.withdraws) {
+          const target = db.prepare(`SELECT tenant_id, agent_id, domain, fact_key, scope
+            FROM cognitive_observations WHERE observation_id = ?`).get(observation.withdraws);
+          if (!target || target.tenant_id !== normalized.tenant_id || target.agent_id !== normalized.agent_id
+              || target.domain !== observation.domain || target.fact_key !== observation.key
+              || target.scope !== observation.scope) fail('COGNITIVE_INVALID_WITHDRAWAL');
+        }
         insertObservation.run(observation.observation_id, normalized.event_id, normalized.tenant_id, normalized.agent_id,
-          observation.domain, observation.key, observation.value, observation.confidence, observation.scope, sourceJson, normalized.occurred_at);
+          observation.domain, observation.key, observation.value, observation.confidence, observation.scope, sourceJson,
+          normalized.occurred_at, observation.supersedes ?? null, observation.withdraws ?? null);
       }
       db.prepare(`INSERT INTO cognitive_streams (tenant_id, agent_id, version, updated_at) VALUES (?, ?, ?, ?)
         ON CONFLICT(tenant_id, agent_id) DO UPDATE SET version = excluded.version, updated_at = excluded.updated_at`)
@@ -221,7 +256,8 @@ function openCognitiveStateStore({ home } = {}) {
     const agent = safeId(agentId);
     if (!tenant || !agent) fail('COGNITIVE_INVALID_EVENT');
     const stream = db.prepare('SELECT version, updated_at FROM cognitive_streams WHERE tenant_id = ? AND agent_id = ?').get(tenant, agent);
-    const rows = db.prepare(`SELECT domain, fact_key, value_text, confidence, scope, source_json, occurred_at, observation_id
+    const rows = db.prepare(`SELECT domain, fact_key, value_text, confidence, scope, source_json, occurred_at, observation_id,
+      supersedes_observation_id, withdraws_observation_id
       FROM cognitive_observations WHERE tenant_id = ? AND agent_id = ? ORDER BY occurred_at, rowid`).all(tenant, agent);
     return {
       version: Number(stream?.version ?? 0),
@@ -235,6 +271,8 @@ function openCognitiveStateStore({ home } = {}) {
         scope: row.scope,
         source: JSON.parse(row.source_json),
         occurred_at: row.occurred_at,
+        supersedes: row.supersedes_observation_id ?? null,
+        withdraws: row.withdraws_observation_id ?? null,
       })),
     };
   }

package/package.json

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