blun-king-cli 9.1.602 → 9.1.603

package/bin/agentspine-king-goal-inbox.mjs

@@ -1,127 +1,127 @@
-import { open, lstat, mkdir, readFile, rename, writeFile } from 'node:fs/promises';
-import path from 'node:path';
-import { createHash } from 'node:crypto';
-
-import { ingestGoalInstruction, parseGoalInstruction } from './agentspine-king-goal-intake.mjs';
-
-const CHECKPOINT_SCHEMA = 'blun.king-goal-queue-checkpoint/v1';
-const MAX_READ_BYTES = 4 * 1024 * 1024;
-
-function queueIdentity(metadata) {
-  return `${metadata.dev}:${metadata.ino}:${metadata.birthtimeMs}`;
-}
-
-async function readCheckpoint(filePath) {
-  try {
-    const value = JSON.parse(await readFile(filePath, 'utf8'));
-    if (value?.schema === CHECKPOINT_SCHEMA && typeof value.fileId === 'string'
-      && Number.isSafeInteger(value.offset) && value.offset >= 0 && Array.isArray(value.accepted)
-      && value.accepted.length <= 512 && value.accepted.every(item => item && /^[a-f0-9]{64}$/.test(item.sha256)
-        && typeof item.goalId === 'string' && item.goalId.length > 0)) return value;
-    throw new Error('GOAL_QUEUE_CHECKPOINT_INVALID');
-  } catch (error) {
-    if (error?.code !== 'ENOENT') throw error;
-  }
-  return { schema: CHECKPOINT_SCHEMA, fileId: '', offset: 0, lastMessageId: null, accepted: [] };
-}
-
-async function writeCheckpoint(filePath, value) {
-  await mkdir(path.dirname(filePath), { recursive: true });
-  const temporary = `${filePath}.${process.pid}.${Date.now()}.tmp`;
-  await writeFile(temporary, `${JSON.stringify(value, null, 2)}\n`, {
-    encoding: 'utf8', flag: 'wx', mode: 0o600,
-  });
-  await rename(temporary, filePath);
-}
-
-function parseQueueLine(line) {
-  let envelope;
-  try { envelope = JSON.parse(line); } catch { return null; }
-  if (!envelope || typeof envelope.text !== 'string' || !envelope.meta || Array.isArray(envelope.meta)
-    || typeof envelope.meta !== 'object') return null;
-  return envelope;
-}
-
-function isAuthorizedInstruction(envelope, input) {
-  const addressed = envelope.meta.addressed === true || envelope.meta.addressed === 'true';
-  const threads = ['thread_id', 'telegram_thread_id', 'message_thread_id']
-    .map(key => envelope.meta[key]).filter(value => value !== null && value !== undefined && value !== '').map(String);
-  const thread = input.instructionThreadId === null || input.instructionThreadId === undefined ? null : String(input.instructionThreadId);
-  return addressed && String(envelope.meta.user_id) === String(input.instructionSenderId)
-    && String(envelope.meta.chat_id) === String(input.instructionChatId)
-    && (threads.length > 0 ? threads.every(value => value === thread) : thread === null);
-}
-
-async function queueChunk(filePath, checkpoint) {
-  const metadata = await lstat(filePath);
-  if (!metadata.isFile() || metadata.isSymbolicLink()) throw new Error('GOAL_QUEUE_NOT_REGULAR');
-  const fileId = queueIdentity(metadata);
-  const offset = checkpoint.fileId === fileId && metadata.size >= checkpoint.offset ? checkpoint.offset : 0;
-  const bytes = Math.min(MAX_READ_BYTES, metadata.size - offset);
-  if (bytes <= 0) return { fileId, offset, lines: [] };
-  const handle = await open(filePath, 'r');
-  try {
-    const buffer = Buffer.alloc(bytes);
-    const { bytesRead } = await handle.read(buffer, 0, bytes, offset);
-    const content = buffer.subarray(0, bytesRead);
-    const lastNewline = content.lastIndexOf(10);
-    if (lastNewline < 0) {
-      if (bytesRead >= MAX_READ_BYTES) throw new Error('GOAL_QUEUE_LINE_TOO_LARGE');
-      return { fileId, offset, lines: [] };
-    }
-    const complete = content.subarray(0, lastNewline + 1);
-    return { fileId, offset, lines: complete.toString('utf8').split('\n').slice(0, -1) };
-  } finally { await handle.close(); }
-}
-
-async function ingestGoalInbox(input) {
-  const checkpoint = await readCheckpoint(input.checkpointFile);
-  let cursor = checkpoint.offset;
-  const results = [];
-  const chunk = await queueChunk(input.queueFile, checkpoint);
-  if (chunk.offset !== checkpoint.offset || chunk.fileId !== checkpoint.fileId) cursor = chunk.offset;
-  for (const line of chunk.lines) {
-    cursor += Buffer.byteLength(line, 'utf8') + 1;
-    const envelope = parseQueueLine(line);
-    if (!envelope || !isAuthorizedInstruction(envelope, input)
-      || !/\bZIEL-[A-Za-z0-9._-]+\.json\b/u.test(envelope.text)) continue;
-    try {
-      const instruction = parseGoalInstruction(envelope.text);
-      const accepted = checkpoint.accepted.find((item) => item.sha256 === instruction.sha256);
-      if (accepted) {
-        results.push({ status: 'duplicate', messageId: String(envelope.meta.message_id),
-          sha256: instruction.sha256, goal: { goalId: accepted.goalId } });
-        continue;
-      }
-      const ingested = await ingestGoalInstruction({ ...input, instructionText: envelope.text });
-      results.push({ status: ingested.duplicate ? 'duplicate' : 'ingested',
-        messageId: String(envelope.meta.message_id), ...ingested });
-      checkpoint.accepted.push({ sha256: ingested.sha256, goalId: ingested.goal.goalId });
-      checkpoint.accepted = checkpoint.accepted.slice(-512);
-    } catch (error) {
-      results.push({ status: 'rejected', messageId: String(envelope.meta.message_id),
-        error: String(error?.message || error).slice(0, 200) });
-    }
-    const result = results.at(-1);
-    result.eventId = createHash('sha256').update(line).digest('hex');
-    // Keep status persistence outside the ingestion catch and before advancing the durable cursor.
-    await input.recordResult?.(result);
-  }
-  await writeCheckpoint(input.checkpointFile, {
-    schema: CHECKPOINT_SCHEMA,
-    fileId: chunk.fileId,
-    offset: cursor,
-    lastMessageId: results.at(-1)?.messageId || checkpoint.lastMessageId || null,
-    accepted: checkpoint.accepted,
-    updatedAt: new Date().toISOString(),
-  });
-  return results;
-}
-
-export {
-  CHECKPOINT_SCHEMA,
-  ingestGoalInbox,
-  isAuthorizedInstruction,
-  parseQueueLine,
-  queueIdentity,
-};
+import { open, lstat, mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+
+import { ingestGoalInstruction, parseGoalInstruction } from './agentspine-king-goal-intake.mjs';
+
+const CHECKPOINT_SCHEMA = 'blun.king-goal-queue-checkpoint/v1';
+const MAX_READ_BYTES = 4 * 1024 * 1024;
+
+function queueIdentity(metadata) {
+  return `${metadata.dev}:${metadata.ino}:${metadata.birthtimeMs}`;
+}
+
+async function readCheckpoint(filePath) {
+  try {
+    const value = JSON.parse(await readFile(filePath, 'utf8'));
+    if (value?.schema === CHECKPOINT_SCHEMA && typeof value.fileId === 'string'
+      && Number.isSafeInteger(value.offset) && value.offset >= 0 && Array.isArray(value.accepted)
+      && value.accepted.length <= 512 && value.accepted.every(item => item && /^[a-f0-9]{64}$/.test(item.sha256)
+        && typeof item.goalId === 'string' && item.goalId.length > 0)) return value;
+    throw new Error('GOAL_QUEUE_CHECKPOINT_INVALID');
+  } catch (error) {
+    if (error?.code !== 'ENOENT') throw error;
+  }
+  return { schema: CHECKPOINT_SCHEMA, fileId: '', offset: 0, lastMessageId: null, accepted: [] };
+}
+
+async function writeCheckpoint(filePath, value) {
+  await mkdir(path.dirname(filePath), { recursive: true });
+  const temporary = `${filePath}.${process.pid}.${Date.now()}.tmp`;
+  await writeFile(temporary, `${JSON.stringify(value, null, 2)}\n`, {
+    encoding: 'utf8', flag: 'wx', mode: 0o600,
+  });
+  await rename(temporary, filePath);
+}
+
+function parseQueueLine(line) {
+  let envelope;
+  try { envelope = JSON.parse(line); } catch { return null; }
+  if (!envelope || typeof envelope.text !== 'string' || !envelope.meta || Array.isArray(envelope.meta)
+    || typeof envelope.meta !== 'object') return null;
+  return envelope;
+}
+
+function isAuthorizedInstruction(envelope, input) {
+  const addressed = envelope.meta.addressed === true || envelope.meta.addressed === 'true';
+  const threads = ['thread_id', 'telegram_thread_id', 'message_thread_id']
+    .map(key => envelope.meta[key]).filter(value => value !== null && value !== undefined && value !== '').map(String);
+  const thread = input.instructionThreadId === null || input.instructionThreadId === undefined ? null : String(input.instructionThreadId);
+  return addressed && String(envelope.meta.user_id) === String(input.instructionSenderId)
+    && String(envelope.meta.chat_id) === String(input.instructionChatId)
+    && (threads.length > 0 ? threads.every(value => value === thread) : thread === null);
+}
+
+async function queueChunk(filePath, checkpoint) {
+  const metadata = await lstat(filePath);
+  if (!metadata.isFile() || metadata.isSymbolicLink()) throw new Error('GOAL_QUEUE_NOT_REGULAR');
+  const fileId = queueIdentity(metadata);
+  const offset = checkpoint.fileId === fileId && metadata.size >= checkpoint.offset ? checkpoint.offset : 0;
+  const bytes = Math.min(MAX_READ_BYTES, metadata.size - offset);
+  if (bytes <= 0) return { fileId, offset, lines: [] };
+  const handle = await open(filePath, 'r');
+  try {
+    const buffer = Buffer.alloc(bytes);
+    const { bytesRead } = await handle.read(buffer, 0, bytes, offset);
+    const content = buffer.subarray(0, bytesRead);
+    const lastNewline = content.lastIndexOf(10);
+    if (lastNewline < 0) {
+      if (bytesRead >= MAX_READ_BYTES) throw new Error('GOAL_QUEUE_LINE_TOO_LARGE');
+      return { fileId, offset, lines: [] };
+    }
+    const complete = content.subarray(0, lastNewline + 1);
+    return { fileId, offset, lines: complete.toString('utf8').split('\n').slice(0, -1) };
+  } finally { await handle.close(); }
+}
+
+async function ingestGoalInbox(input) {
+  const checkpoint = await readCheckpoint(input.checkpointFile);
+  let cursor = checkpoint.offset;
+  const results = [];
+  const chunk = await queueChunk(input.queueFile, checkpoint);
+  if (chunk.offset !== checkpoint.offset || chunk.fileId !== checkpoint.fileId) cursor = chunk.offset;
+  for (const line of chunk.lines) {
+    cursor += Buffer.byteLength(line, 'utf8') + 1;
+    const envelope = parseQueueLine(line);
+    if (!envelope || !isAuthorizedInstruction(envelope, input)
+      || !/\bZIEL-[A-Za-z0-9._-]+\.json\b/u.test(envelope.text)) continue;
+    try {
+      const instruction = parseGoalInstruction(envelope.text);
+      const accepted = checkpoint.accepted.find((item) => item.sha256 === instruction.sha256);
+      if (accepted) {
+        results.push({ status: 'duplicate', messageId: String(envelope.meta.message_id),
+          sha256: instruction.sha256, goal: { goalId: accepted.goalId } });
+        continue;
+      }
+      const ingested = await ingestGoalInstruction({ ...input, instructionText: envelope.text });
+      results.push({ status: ingested.duplicate ? 'duplicate' : 'ingested',
+        messageId: String(envelope.meta.message_id), ...ingested });
+      checkpoint.accepted.push({ sha256: ingested.sha256, goalId: ingested.goal.goalId });
+      checkpoint.accepted = checkpoint.accepted.slice(-512);
+    } catch (error) {
+      results.push({ status: 'rejected', messageId: String(envelope.meta.message_id),
+        error: String(error?.message || error).slice(0, 200) });
+    }
+    const result = results.at(-1);
+    result.eventId = createHash('sha256').update(line).digest('hex');
+    // Keep status persistence outside the ingestion catch and before advancing the durable cursor.
+    await input.recordResult?.(result);
+  }
+  await writeCheckpoint(input.checkpointFile, {
+    schema: CHECKPOINT_SCHEMA,
+    fileId: chunk.fileId,
+    offset: cursor,
+    lastMessageId: results.at(-1)?.messageId || checkpoint.lastMessageId || null,
+    accepted: checkpoint.accepted,
+    updatedAt: new Date().toISOString(),
+  });
+  return results;
+}
+
+export {
+  CHECKPOINT_SCHEMA,
+  ingestGoalInbox,
+  isAuthorizedInstruction,
+  parseQueueLine,
+  queueIdentity,
+};

package/bin/agentspine-king-goal-intake.mjs

@@ -1,106 +1,106 @@
-import { createHash } from 'node:crypto';
-import { lstat, readFile, realpath } from 'node:fs/promises';
-import path from 'node:path';
-
-const ASSIGNMENT_SCHEMA = 'blun.king-goal-assignment/v1';
-const INSTRUCTION_RE = /(ZIEL-[A-Za-z0-9._-]+\.json)\b[^\r\n]{0,200}?\bsha256\b\s*[=:]?\s*([a-f0-9]{64})(?:\s|[),.;]|$)/iu;
-
-function digest(value) {
-  return createHash('sha256').update(value).digest('hex');
-}
-
-function parseGoalInstruction(text) {
-  const match = String(text || '').match(INSTRUCTION_RE);
-  if (!match) throw new Error('GOAL_INSTRUCTION_REQUIRES_FILE_AND_SHA256');
-  return Object.freeze({ fileName: match[1], sha256: match[2].toLowerCase() });
-}
-
-function assignmentInput(value) {
-  if (!value || value.schema !== ASSIGNMENT_SCHEMA || typeof value.goalId !== 'string'
-    || typeof value.logicalPersonaId !== 'string' || typeof value.successCriterion !== 'string'
-    || !Array.isArray(value.steps) || value.steps.length === 0) {
-    throw new Error('GOAL_ASSIGNMENT_INVALID');
-  }
-  assertTerminalGoalGate(value.steps);
-  return value;
-}
-
-function assertTerminalGoalGate(steps) {
-  const ids = new Set(steps.map((step) => step?.stepId));
-  if (ids.size !== steps.length || ids.has(undefined)) throw new Error('GOAL_PLAN_STEP_IDS_INVALID');
-  const dependedOn = new Set(steps.flatMap((step) => Array.isArray(step.dependsOn) ? step.dependsOn : []));
-  const terminalSteps = steps.filter((step) => !dependedOn.has(step.stepId));
-  if (terminalSteps.length !== 1 || !terminalSteps[0].execution?.verification) {
-    throw new Error('GOAL_PLAN_TERMINAL_GATE_REQUIRED');
-  }
-  const terminalId = terminalSteps[0].stepId;
-  const byId = new Map(steps.map((step) => [step.stepId, step]));
-  const reachesGate = (stepId, seen = new Set()) => {
-    if (stepId === terminalId) return true;
-    if (seen.has(stepId)) return false;
-    seen.add(stepId);
-    return steps.some((candidate) => Array.isArray(candidate.dependsOn)
-      && candidate.dependsOn.includes(stepId) && reachesGate(candidate.stepId, new Set(seen)));
-  };
-  if ([...byId.keys()].some((stepId) => !reachesGate(stepId))) {
-    throw new Error('GOAL_PLAN_TERMINAL_GATE_MUST_DEPEND_ON_ALL_STEPS');
-  }
-}
-
-function inside(directory, candidate) {
-  const relative = path.relative(directory, candidate);
-  return relative !== '..' && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative);
-}
-
-async function readVerifiedGoalFile(exchangeDirectory, instruction) {
-  const exchange = await realpath(path.resolve(exchangeDirectory));
-  const candidate = path.resolve(exchange, instruction.fileName);
-  if (!inside(exchange, candidate)) throw new Error('GOAL_FILE_OUTSIDE_EXCHANGE');
-  const metadata = await lstat(candidate);
-  if (!metadata.isFile() || metadata.isSymbolicLink() || metadata.size > 1024 * 1024) {
-    throw new Error('GOAL_FILE_NOT_REGULAR');
-  }
-  const canonical = await realpath(candidate);
-  if (!inside(exchange, canonical)) throw new Error('GOAL_FILE_OUTSIDE_EXCHANGE');
-  const payload = await readFile(canonical);
-  if (digest(payload) !== instruction.sha256) throw new Error('GOAL_FILE_SHA256_MISMATCH');
-  let value;
-  try { value = JSON.parse(payload.toString('utf8')); }
-  catch { throw new Error('GOAL_FILE_INVALID_JSON'); }
-  return { assignment: assignmentInput(value), filePath: canonical, sha256: instruction.sha256 };
-}
-
-async function ingestGoalInstruction(input) {
-  const instruction = parseGoalInstruction(input.instructionText);
-  const verified = await readVerifiedGoalFile(input.exchangeDirectory, instruction);
-  const value = verified.assignment;
-  if (value.logicalPersonaId !== input.logicalPersonaId) throw new Error('GOAL_PERSONA_MISMATCH');
-  if (value.projectId !== input.projectId) throw new Error('GOAL_PROJECT_MISMATCH');
-  if (value.groupId !== input.groupId || value.ownerSubjectId !== input.ownerSubjectId) {
-    throw new Error('GOAL_AUTHORITY_MISMATCH');
-  }
-  if (value.snapshotSha256 !== input.snapshot.snapshotSha256) throw new Error('GOAL_SNAPSHOT_MISMATCH');
-  const result = await input.assignGoal({
-    root: input.snapshot.root,
-    goalId: value.goalId,
-    agentId: input.runtimePersonaId,
-    ownerSubjectId: value.ownerSubjectId,
-    projectId: value.projectId,
-    groupId: value.groupId,
-    priority: value.priority ?? 70,
-    successCriterion: value.successCriterion,
-    nextSafeStep: value.nextSafeStep ?? null,
-    steps: value.steps,
-    deadline: value.deadline ?? null,
-    confirmation: 'local-owner-confirmed',
-  });
-  return Object.freeze({ ...verified, duplicate: result.duplicate === true, goal: result.goal });
-}
-
-export {
-  ASSIGNMENT_SCHEMA,
-  assertTerminalGoalGate,
-  ingestGoalInstruction,
-  parseGoalInstruction,
-  readVerifiedGoalFile,
-};
+import { createHash } from 'node:crypto';
+import { lstat, readFile, realpath } from 'node:fs/promises';
+import path from 'node:path';
+
+const ASSIGNMENT_SCHEMA = 'blun.king-goal-assignment/v1';
+const INSTRUCTION_RE = /(ZIEL-[A-Za-z0-9._-]+\.json)\b[^\r\n]{0,200}?\bsha256\b\s*[=:]?\s*([a-f0-9]{64})(?:\s|[),.;]|$)/iu;
+
+function digest(value) {
+  return createHash('sha256').update(value).digest('hex');
+}
+
+function parseGoalInstruction(text) {
+  const match = String(text || '').match(INSTRUCTION_RE);
+  if (!match) throw new Error('GOAL_INSTRUCTION_REQUIRES_FILE_AND_SHA256');
+  return Object.freeze({ fileName: match[1], sha256: match[2].toLowerCase() });
+}
+
+function assignmentInput(value) {
+  if (!value || value.schema !== ASSIGNMENT_SCHEMA || typeof value.goalId !== 'string'
+    || typeof value.logicalPersonaId !== 'string' || typeof value.successCriterion !== 'string'
+    || !Array.isArray(value.steps) || value.steps.length === 0) {
+    throw new Error('GOAL_ASSIGNMENT_INVALID');
+  }
+  assertTerminalGoalGate(value.steps);
+  return value;
+}
+
+function assertTerminalGoalGate(steps) {
+  const ids = new Set(steps.map((step) => step?.stepId));
+  if (ids.size !== steps.length || ids.has(undefined)) throw new Error('GOAL_PLAN_STEP_IDS_INVALID');
+  const dependedOn = new Set(steps.flatMap((step) => Array.isArray(step.dependsOn) ? step.dependsOn : []));
+  const terminalSteps = steps.filter((step) => !dependedOn.has(step.stepId));
+  if (terminalSteps.length !== 1 || !terminalSteps[0].execution?.verification) {
+    throw new Error('GOAL_PLAN_TERMINAL_GATE_REQUIRED');
+  }
+  const terminalId = terminalSteps[0].stepId;
+  const byId = new Map(steps.map((step) => [step.stepId, step]));
+  const reachesGate = (stepId, seen = new Set()) => {
+    if (stepId === terminalId) return true;
+    if (seen.has(stepId)) return false;
+    seen.add(stepId);
+    return steps.some((candidate) => Array.isArray(candidate.dependsOn)
+      && candidate.dependsOn.includes(stepId) && reachesGate(candidate.stepId, new Set(seen)));
+  };
+  if ([...byId.keys()].some((stepId) => !reachesGate(stepId))) {
+    throw new Error('GOAL_PLAN_TERMINAL_GATE_MUST_DEPEND_ON_ALL_STEPS');
+  }
+}
+
+function inside(directory, candidate) {
+  const relative = path.relative(directory, candidate);
+  return relative !== '..' && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative);
+}
+
+async function readVerifiedGoalFile(exchangeDirectory, instruction) {
+  const exchange = await realpath(path.resolve(exchangeDirectory));
+  const candidate = path.resolve(exchange, instruction.fileName);
+  if (!inside(exchange, candidate)) throw new Error('GOAL_FILE_OUTSIDE_EXCHANGE');
+  const metadata = await lstat(candidate);
+  if (!metadata.isFile() || metadata.isSymbolicLink() || metadata.size > 1024 * 1024) {
+    throw new Error('GOAL_FILE_NOT_REGULAR');
+  }
+  const canonical = await realpath(candidate);
+  if (!inside(exchange, canonical)) throw new Error('GOAL_FILE_OUTSIDE_EXCHANGE');
+  const payload = await readFile(canonical);
+  if (digest(payload) !== instruction.sha256) throw new Error('GOAL_FILE_SHA256_MISMATCH');
+  let value;
+  try { value = JSON.parse(payload.toString('utf8')); }
+  catch { throw new Error('GOAL_FILE_INVALID_JSON'); }
+  return { assignment: assignmentInput(value), filePath: canonical, sha256: instruction.sha256 };
+}
+
+async function ingestGoalInstruction(input) {
+  const instruction = parseGoalInstruction(input.instructionText);
+  const verified = await readVerifiedGoalFile(input.exchangeDirectory, instruction);
+  const value = verified.assignment;
+  if (value.logicalPersonaId !== input.logicalPersonaId) throw new Error('GOAL_PERSONA_MISMATCH');
+  if (value.projectId !== input.projectId) throw new Error('GOAL_PROJECT_MISMATCH');
+  if (value.groupId !== input.groupId || value.ownerSubjectId !== input.ownerSubjectId) {
+    throw new Error('GOAL_AUTHORITY_MISMATCH');
+  }
+  if (value.snapshotSha256 !== input.snapshot.snapshotSha256) throw new Error('GOAL_SNAPSHOT_MISMATCH');
+  const result = await input.assignGoal({
+    root: input.snapshot.root,
+    goalId: value.goalId,
+    agentId: input.runtimePersonaId,
+    ownerSubjectId: value.ownerSubjectId,
+    projectId: value.projectId,
+    groupId: value.groupId,
+    priority: value.priority ?? 70,
+    successCriterion: value.successCriterion,
+    nextSafeStep: value.nextSafeStep ?? null,
+    steps: value.steps,
+    deadline: value.deadline ?? null,
+    confirmation: 'local-owner-confirmed',
+  });
+  return Object.freeze({ ...verified, duplicate: result.duplicate === true, goal: result.goal });
+}
+
+export {
+  ASSIGNMENT_SCHEMA,
+  assertTerminalGoalGate,
+  ingestGoalInstruction,
+  parseGoalInstruction,
+  readVerifiedGoalFile,
+};