metheus-governance-mcp-cli 0.2.211 → 0.2.212

package/cli.mjs

@@ -2764,6 +2764,62 @@ function sessionAllowsConversationResponder(sessionRaw, responderSelectorRaw = "
   return allowedResponders.includes(responderSelector);
 }
 
+function shouldBypassRunnerStartupLoopForContractFollowup({
+  selectedRecord,
+  bot,
+  conversationSessionFacts = null,
+}) {
+  const parsed = safeObject(selectedRecord?.parsedArchive);
+  if (String(parsed.kind || "").trim().toLowerCase() !== "bot_reply") {
+    return false;
+  }
+  const currentBotSelector = normalizeTelegramMentionUsername(bot?.username || bot?.name);
+  if (!currentBotSelector) {
+    return false;
+  }
+  const conversationID = String(parsed.conversationID || "").trim();
+  if (!conversationID) {
+    return false;
+  }
+  const executionContractType = String(parsed.executionContractType || "").trim().toLowerCase();
+  if (executionContractType !== "delegation") {
+    return false;
+  }
+  const senderBotSelector = normalizeTelegramMentionUsername(
+    parsed.botUsername
+    || parsed.botName
+    || parsed.username
+    || parsed.sender,
+  );
+  if (!senderBotSelector || senderBotSelector === currentBotSelector) {
+    return false;
+  }
+  const assignmentTargets = ensureArray(parsed.executionContractAssignments)
+    .map((item) => normalizeTelegramMentionUsername(safeObject(item).targetBot || safeObject(item).target_bot))
+    .filter(Boolean);
+  const nextResponders = ensureArray(parsed.executionContractNextResponders)
+    .map((item) => normalizeTelegramMentionUsername(item))
+    .filter(Boolean);
+  const conversationTargetBot = normalizeTelegramMentionUsername(parsed.conversationTargetBotUsername);
+  const currentBotIsExpectedResponder = assignmentTargets.includes(currentBotSelector)
+    || nextResponders.includes(currentBotSelector)
+    || conversationTargetBot === currentBotSelector;
+  if (!currentBotIsExpectedResponder) {
+    return false;
+  }
+  const sessionFacts = safeObject(conversationSessionFacts);
+  const sessionExpectedResponders = ensureArray(sessionFacts.next_expected_responders)
+    .map((item) => normalizeTelegramMentionUsername(item))
+    .filter(Boolean);
+  if (sessionExpectedResponders.length > 0 && !sessionExpectedResponders.includes(currentBotSelector)) {
+    return false;
+  }
+  if (sessionFacts.any_closed === true && sessionFacts.any_open !== true) {
+    return false;
+  }
+  return true;
+}
+
 function findRunnerRequestsForMessageID(state, normalizedRoute, selectors = {}) {
   const chatID = String(selectors.chatID || "").trim();
   const messageID = intFromRawAllowZero(selectors.messageID, 0);
@@ -7707,6 +7763,13 @@ async function maybeHandleRunnerStartupLoopCandidate({
   }
   const conversationID = String(parsed.conversationID || "").trim();
   const conversationSessionFacts = collectBotRunnerConversationSessionFacts(normalizedRoute, conversationID);
+  if (shouldBypassRunnerStartupLoopForContractFollowup({
+    selectedRecord,
+    bot,
+    conversationSessionFacts,
+  })) {
+    return null;
+  }
   const adjudication = await resolveRunnerStartupLoopAdjudication({
     selectedRecord,
     pendingOrdered,
@@ -15488,6 +15551,7 @@ TELEGRAM_BOT_REVIEW_TOKEN=review-token
     selectRunnerPendingWork,
     processRunnerSelectedRecord,
     resolveRunnerStartupLoopAdjudication,
+    shouldBypassRunnerStartupLoopForContractFollowup,
     claimRunnerRequestForHumanComment,
     markRunnerRequestLifecycle,
     resolveRunnerContinuationRequestForBotReply,

package/lib/selftest-runner-scenarios.mjs

@@ -118,16 +118,17 @@ export async function runSelftestRunnerScenarios(push, deps) {
   const safeObject = requireDependency(deps, "safeObject");
   const normalizeRunnerTriggerPolicy = requireDependency(deps, "normalizeRunnerTriggerPolicy");
   const evaluateTelegramRunnerTrigger = requireDependency(deps, "evaluateTelegramRunnerTrigger");
-  const resolveRunnerResponderAdjudication = requireDependency(deps, "resolveRunnerResponderAdjudication");
-  const selectPendingArchiveComments = requireDependency(deps, "selectPendingArchiveComments");
-  const selectRunnerPendingWork = requireDependency(deps, "selectRunnerPendingWork");
-  const processRunnerSelectedRecord = requireDependency(deps, "processRunnerSelectedRecord");
-  const resolveRunnerStartupLoopAdjudication = requireDependency(deps, "resolveRunnerStartupLoopAdjudication");
-  const runRunnerAIExecution = requireDependency(deps, "runRunnerAIExecution");
-  const formatBotReplyArchiveComment = requireDependency(deps, "formatBotReplyArchiveComment");
-  const findArchivedBotReplyRecord = requireDependency(deps, "findArchivedBotReplyRecord");
-  const parseArchivedChatComment = requireDependency(deps, "parseArchivedChatComment");
-  const validateWorkspaceArtifacts = requireDependency(deps, "validateWorkspaceArtifacts");
+  const resolveRunnerResponderAdjudication = requireDependency(deps, "resolveRunnerResponderAdjudication");
+  const selectPendingArchiveComments = requireDependency(deps, "selectPendingArchiveComments");
+  const selectRunnerPendingWork = requireDependency(deps, "selectRunnerPendingWork");
+  const processRunnerSelectedRecord = requireDependency(deps, "processRunnerSelectedRecord");
+  const resolveRunnerStartupLoopAdjudication = requireDependency(deps, "resolveRunnerStartupLoopAdjudication");
+  const shouldBypassRunnerStartupLoopForContractFollowup = requireDependency(deps, "shouldBypassRunnerStartupLoopForContractFollowup");
+  const runRunnerAIExecution = requireDependency(deps, "runRunnerAIExecution");
+  const formatBotReplyArchiveComment = requireDependency(deps, "formatBotReplyArchiveComment");
+  const findArchivedBotReplyRecord = requireDependency(deps, "findArchivedBotReplyRecord");
+  const parseArchivedChatComment = requireDependency(deps, "parseArchivedChatComment");
+  const validateWorkspaceArtifacts = requireDependency(deps, "validateWorkspaceArtifacts");
   const buildLocalBotPrompt = requireDependency(deps, "buildLocalBotPrompt");
 
   try {
@@ -367,13 +368,53 @@ export async function runSelftestRunnerScenarios(push, deps) {
         && adjudication?.startup_facts?.repeated_same_delegation_without_new_human === true,
       `decision=${String(adjudication?.decision || "")} action=${String(adjudication?.action || "")} imported=${String(adjudication?.startup_facts?.imported_on_current_poll)} repeated_delegation=${String(adjudication?.startup_facts?.repeated_same_delegation_without_new_human)}`,
     );
-  } catch (err) {
-    push(
-      "runner_loop_adjudication_detects_repeated_same_delegation_without_new_human_input",
-      false,
-      String(err?.message || err),
-    );
-  }
+  } catch (err) {
+    push(
+      "runner_loop_adjudication_detects_repeated_same_delegation_without_new_human_input",
+      false,
+      String(err?.message || err),
+    );
+  }
+
+  try {
+    const shouldBypass = shouldBypassRunnerStartupLoopForContractFollowup({
+      selectedRecord: {
+        id: "bot-reply-4",
+        parsedArchive: {
+          kind: "bot_reply",
+          messageID: 52,
+          senderIsBot: true,
+          botUsername: "@bot-a",
+          conversationID: "conv-4",
+          executionContractType: "delegation",
+          executionContractAssignments: [
+            { targetBot: "@bot-b", task: "say hello" },
+          ],
+          executionContractNextResponders: ["@bot-b"],
+          conversationTargetBotUsername: "@bot-b",
+        },
+      },
+      bot: {
+        username: "@bot-b",
+      },
+      conversationSessionFacts: {
+        any_open: true,
+        any_closed: false,
+        next_expected_responders: ["bot-b"],
+      },
+    });
+    push(
+      "runner_startup_loop_bypasses_expected_delegation_followup_for_target_bot",
+      shouldBypass === true,
+      `should_bypass=${String(shouldBypass)}`,
+    );
+  } catch (err) {
+    push(
+      "runner_startup_loop_bypasses_expected_delegation_followup_for_target_bot",
+      false,
+      String(err?.message || err),
+    );
+  }
 
   try {
     const pendingSelection = selectPendingArchiveComments(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "metheus-governance-mcp-cli",
-  "version": "0.2.211",
+  "version": "0.2.212",
   "description": "Metheus Governance MCP CLI (setup + stdio proxy)",
   "type": "module",
   "files": [