blun-king-cli 9.1.215 → 9.1.217

package/bin/validated-learning-signal.cjs

@@ -1,5 +1,12 @@
 'use strict';
 
+const crypto = require('node:crypto');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const CANDIDATE_TTL_MS = 24 * 60 * 60 * 1000;
+const SCHEMA_VERSION = 1;
+
 const COMMAND_TOOLS = new Set([
   'bash',
   'command',
@@ -101,7 +108,190 @@ function detectValidatedLearningSignal(history) {
   return signal;
 }
 
+function profileKey(value) {
+  const normalized = typeof value === 'string' ? value.trim() : '';
+  return (normalized || 'default').replace(/[^a-z0-9._-]/giu, '_').slice(0, 64);
+}
+
+function candidateDirectory(homeDir, profile) {
+  return path.join(
+    path.resolve(homeDir),
+    'self-improvement',
+    'validated-learning',
+    profileKey(profile),
+  );
+}
+
+function atomicCreate(filePath, value) {
+  fs.mkdirSync(path.dirname(filePath), { mode: 0o700, recursive: true });
+  const temporary = `${filePath}.${process.pid}.${crypto.randomBytes(8).toString('hex')}.tmp`;
+  fs.writeFileSync(temporary, `${JSON.stringify(value)}\n`, { encoding: 'utf8', mode: 0o600 });
+  try {
+    fs.linkSync(temporary, filePath);
+    return true;
+  } catch (error) {
+    if (error?.code !== 'EEXIST') throw error;
+    return false;
+  } finally {
+    fs.rmSync(temporary, { force: true });
+  }
+}
+
+function statusMarker(filePath, status) {
+  return `${filePath}.${status}`;
+}
+
+function readCandidate(filePath) {
+  try {
+    const candidate = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    for (const status of ['recorded', 'expired']) {
+      const markerPath = statusMarker(filePath, status);
+      if (!fs.existsSync(markerPath)) continue;
+      const marker = JSON.parse(fs.readFileSync(markerPath, 'utf8'));
+      return { ...candidate, ...marker, filePath };
+    }
+    return { ...candidate, filePath };
+  } catch {
+    return null;
+  }
+}
+
+function readValidatedLearningCandidates(options = {}) {
+  const homeDir = typeof options.homeDir === 'string' ? options.homeDir.trim() : '';
+  if (!homeDir) return [];
+  const directory = candidateDirectory(homeDir, options.profile);
+  try {
+    return fs.readdirSync(directory, { withFileTypes: true })
+      .filter((entry) => entry.isFile() && entry.name.endsWith('.json'))
+      .map((entry) => readCandidate(path.join(directory, entry.name)))
+      .filter(Boolean)
+      .sort((left, right) => Date.parse(left.createdAt) - Date.parse(right.createdAt));
+  } catch {
+    return [];
+  }
+}
+
+function successfulMistakeRecordCandidateIds(history) {
+  const calls = new Map();
+  const candidateIds = new Set();
+  for (const message of currentUserTurn(history)) {
+    for (const call of toolCallsFrom(message)) {
+      if (typeof call?.id === 'string' && String(call.name).toLowerCase() === 'mistakerecord') {
+        const args = parseArguments(call.arguments);
+        calls.set(call.id, typeof args?.candidateId === 'string' ? args.candidateId.trim() : '');
+      }
+    }
+    if (message?.role === 'tool'
+      && typeof message.toolCallId === 'string'
+      && calls.get(message.toolCallId)
+      && message.isError !== true) {
+      candidateIds.add(calls.get(message.toolCallId));
+    }
+  }
+  return candidateIds;
+}
+
+function newestPending(candidates) {
+  for (let index = candidates.length - 1; index >= 0; index -= 1) {
+    if (candidates[index].status === 'pending') return candidates[index];
+  }
+  return null;
+}
+
+function markCandidate(candidate, status, nowIso) {
+  if (!candidate?.filePath) return;
+  atomicCreate(statusMarker(candidate.filePath, status), {
+    resolvedAt: nowIso,
+    status,
+  });
+}
+
+function createCandidate(signal, options, nowIso) {
+  const profile = profileKey(options.profile);
+  const commandHash = crypto.createHash('sha256').update(signal.command).digest('hex');
+  const digest = crypto.createHash('sha256').update([
+    profile,
+    commandHash,
+    signal.failedToolCallId,
+    signal.successfulToolCallId,
+  ].join('\0')).digest('hex').slice(0, 32);
+  const id = `vl-${digest}`;
+  const filePath = path.join(candidateDirectory(options.homeDir, profile), `${id}.json`);
+  atomicCreate(filePath, {
+    schemaVersion: SCHEMA_VERSION,
+    id,
+    type: 'validated_red_green',
+    status: 'pending',
+    profile,
+    verification: {
+      toolName: signal.toolName,
+      commandHash,
+    },
+    evidence: {
+      failedToolCallId: signal.failedToolCallId,
+      successfulToolCallId: signal.successfulToolCallId,
+    },
+    createdAt: nowIso,
+  });
+  return readCandidate(filePath);
+}
+
+function syncValidatedLearningCandidate(history, options = {}) {
+  const signal = detectValidatedLearningSignal(history);
+  const homeDir = typeof options.homeDir === 'string' ? options.homeDir.trim() : '';
+  if (!homeDir) {
+    return signal === null ? null : {
+      ...signal,
+      source: 'current_turn',
+      status: 'pending',
+    };
+  }
+
+  const nowMs = (options.now || Date.now)();
+  const nowIso = new Date(nowMs).toISOString();
+  try {
+    let candidates = readValidatedLearningCandidates({
+      homeDir,
+      profile: options.profile,
+    });
+    const recordedCandidateIds = successfulMistakeRecordCandidateIds(history);
+    for (const candidateId of recordedCandidateIds) {
+      const candidate = candidates.find((item) => (
+        item.id === candidateId && item.status === 'pending'
+      ));
+      markCandidate(candidate, 'recorded', nowIso);
+    }
+    if (recordedCandidateIds.size > 0) {
+      candidates = readValidatedLearningCandidates({ homeDir, profile: options.profile });
+    }
+    if (signal !== null) {
+      return {
+        ...createCandidate(signal, { homeDir, profile: options.profile }, nowIso),
+        source: 'current_turn',
+      };
+    }
+
+    for (const candidate of candidates) {
+      if (candidate.status !== 'pending') continue;
+      if (nowMs - Date.parse(candidate.createdAt) >= CANDIDATE_TTL_MS) {
+        markCandidate(candidate, 'expired', nowIso);
+      }
+    }
+    candidates = readValidatedLearningCandidates({ homeDir, profile: options.profile });
+    const pending = newestPending(candidates);
+    return pending === null ? null : { ...pending, source: 'persisted' };
+  } catch {
+    return signal === null ? null : {
+      ...signal,
+      source: 'current_turn',
+      status: 'pending',
+    };
+  }
+}
+
 module.exports = {
   detectValidatedLearningSignal,
   normalizeCommand,
+  readValidatedLearningCandidates,
+  syncValidatedLearningCandidate,
 };

package/blun.mjs

@@ -232137,30 +232137,37 @@ var init_repeated_assistant_response = __esmMin((() => {
 function isValidatedLearningSignalReminder(message) {
 	return message.origin?.kind === "injection" && message.origin.variant === "validated_learning_signal";
 }
-function buildValidatedLearningSignalReminder() {
-	return [
+function buildValidatedLearningSignalReminder(signal) {
+	const lines = [
 		"<validated-learning-signal>",
 		"The same verification command failed and now succeeds in this user turn.",
 		"Use MistakeRecord only when the red-to-green result exposes a reusable lesson.",
 		"Do not record transient environment failures, raw command output, or a success with no general repetition guard.",
-		"If there is a reusable lesson, record the incorrect assumption, the measured correction, and the concrete condition that would cause it again.",
-		"</validated-learning-signal>"
-	].join("\n");
+		"If there is a reusable lesson, record the incorrect assumption, the measured correction, and the concrete condition that would cause it again."
+	];
+	if (typeof signal?.id === "string" && signal.id.length > 0) {
+		lines.push(`When recording this lesson, pass candidateId "${signal.id}" so only this candidate is resolved.`);
+	}
+	lines.push("</validated-learning-signal>");
+	return lines.join("\n");
 }
-var ValidatedLearningSignalInjector, detectValidatedLearningSignal;
+var ValidatedLearningSignalInjector, syncValidatedLearningCandidate;
 var init_validated_learning_signal = __esmMin((() => {
 	init_injector();
-	({ detectValidatedLearningSignal } = createRequire(import.meta.url)("./bin/validated-learning-signal.cjs"));
+	({ syncValidatedLearningCandidate } = createRequire(import.meta.url)("./bin/validated-learning-signal.cjs"));
 	ValidatedLearningSignalInjector = class extends DynamicInjector {
 		injectionVariant = "validated_learning_signal";
 		async inject() {
-			const signal = detectValidatedLearningSignal(this.agent.context.history);
+			const signal = syncValidatedLearningCandidate(this.agent.context.history, {
+				homeDir: process.env["BLUN_SHARED_HOME"] ?? process.env["BLUN_HOME"] ?? "",
+				profile: process.env["BLUN_PROFILE"] ?? "default"
+			});
 			const existing = this.agent.context.history.filter(isValidatedLearningSignalReminder);
 			if (signal === null) {
 				if (existing.length > 0) this.agent.context.removeSystemRemindersMatching(isValidatedLearningSignalReminder);
 				return;
 			}
-			const injection = buildValidatedLearningSignalReminder();
+			const injection = buildValidatedLearningSignalReminder(signal);
 			const expected = `<system-reminder>\n${injection}\n</system-reminder>`;
 			if (existing.length === 1 && reminderText(existing[0]) === expected) return;
 			this.agent.context.removeSystemRemindersMatching(isValidatedLearningSignalReminder);
@@ -263282,7 +263289,8 @@ var init_mistake_record = __esmMin((() => {
 		about: string().min(1).describe("Who made the original claim (agent name, or \"me\" for yourself)."),
 		claim: string().min(1).describe("What was claimed — one sentence."),
 		measurement: string().min(1).describe("What was actually measured — one sentence."),
-		condition: string().min(1).describe("Under what condition this mistake will happen again. Required — without it the entry is discarded by A2.")
+		condition: string().min(1).describe("Under what condition this mistake will happen again. Required — without it the entry is discarded by A2."),
+		candidateId: string().optional().describe("Optional validated-learning candidate ID. Pass the exact ID from the current reminder so only that candidate is resolved.")
 	}).strict();
 	MistakeRecordTool = class {
 		agent;

package/package.json

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