feat(agent): add executor gatekeeper hook

src/test/java/com/superbiz/agent/service/ChatServiceSequentialAgentTest.java

@@ -8,6 +8,7 @@ import com.superbiz.agent.agent.tool.QueryLogsTools;
 import com.superbiz.agent.agent.tool.QueryMetricsTools;
 import com.superbiz.agent.domain.entity.AgentStep;
 import com.superbiz.agent.domain.entity.DiagnosisSession;
+import com.superbiz.agent.domain.entity.ToolInvocation;
 import com.superbiz.agent.repository.AgentStepRepository;
 import com.superbiz.agent.repository.DiagnosisSessionRepository;
 import com.superbiz.agent.repository.ToolInvocationRepository;
@@ -21,6 +22,7 @@ import org.springframework.ai.chat.model.Generation;
 import org.springframework.ai.chat.prompt.Prompt;
 import org.springframework.ai.tool.ToolCallback;
 import org.springframework.test.util.ReflectionTestUtils;
+import org.mockito.ArgumentCaptor;
 
 import java.util.List;
 import java.util.Map;
@@ -33,6 +35,8 @@ import static org.junit.jupiter.api.Assertions.assertSame;
 import static org.junit.jupiter.api.Assertions.assertTrue;
 import static org.mockito.ArgumentMatchers.any;
 import static org.mockito.ArgumentMatchers.anyString;
+import static org.mockito.ArgumentMatchers.isNull;
+import static org.mockito.Mockito.verify;
 import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.when;
 
@@ -330,6 +334,63 @@ class ChatServiceSequentialAgentTest {
         assertFalse(result.answer().contains("executor_evidence_v2"));
     }
 
+    @Test
+    void executeChatComplexPersistsGatekeeperResultInVerifierEvaluation() throws Exception {
+        ChatService chatService = createChatService();
+        SelfEvaluationMergeService mergeService =
+                (SelfEvaluationMergeService) ReflectionTestUtils.getField(chatService, "selfEvaluationMergeService");
+        ToolInvocationRepository invocationRepository =
+                (ToolInvocationRepository) ReflectionTestUtils.getField(chatService, "toolInvocationRepository");
+        when(invocationRepository.findBySessionIdOrderByIdAsc("sequential-gatekeeper-persist-session"))
+                .thenReturn(List.of(ToolInvocation.builder()
+                        .id(101L)
+                        .sessionId("sequential-gatekeeper-persist-session")
+                        .toolName("query_metrics")
+                        .build()));
+        ScriptedChatModel chatModel = new ScriptedChatModel();
+        chatModel.executorOutput = """
+                {
+                  "answer_version": "executor_evidence_v2",
+                  "claims": [
+                    {
+                      "claim_id": "claim-1",
+                      "claim_type": "symptom",
+                      "claim_text": "连接池 active 达到上限",
+                      "support_level": "direct",
+                      "evidence_bindings": [
+                        {
+                          "source_type": "tool_trace",
+                          "source_id": "trace-1",
+                          "tool_name": "query_metrics",
+                          "source_invocation_ids": [101],
+                          "evidence_excerpt": "active=50 max=50"
+                        }
+                      ]
+                    }
+                  ],
+                  "hypotheses": [],
+                  "recommended_actions": [],
+                  "missing_info": []
+                }
+                """;
+
+        chatService.executeChatComplex(
+                chatModel,
+                new ToolCallback[0],
+                "请分析 MySQL 连接池耗尽",
+                List.of(),
+                "sequential-gatekeeper-persist-session"
+        );
+
+        ArgumentCaptor<Map<String, Object>> captor = ArgumentCaptor.forClass(Map.class);
+        verify(mergeService).mergeVerifierEvaluation(isNull(), captor.capture());
+        Map<String, Object> verifierEvaluation = captor.getValue();
+        assertTrue(verifierEvaluation.containsKey("gatekeeper_result"));
+        @SuppressWarnings("unchecked")
+        Map<String, Object> gatekeeperResult = (Map<String, Object>) verifierEvaluation.get("gatekeeper_result");
+        assertEquals("pass", gatekeeperResult.get("status"));
+    }
+
     @Test
     void buildMethodToolsArrayIncludesLogsAndMetricsWhenAvailable() {
         ChatService chatService = new ChatService();
@@ -432,6 +493,7 @@ class ChatServiceSequentialAgentTest {
         when(toolTraceSummaryService.buildVerifierTraceSummary(anyString(), anyString())).thenReturn(List.of());
         SelfEvaluationMergeService selfEvaluationMergeService = mock(SelfEvaluationMergeService.class);
         when(selfEvaluationMergeService.mergeVerifierEvaluation(any(), any())).thenReturn("{}");
+        ExecutorGatekeeperService executorGatekeeperService = new ExecutorGatekeeperService(toolInvocationRepository);
 
         ReflectionTestUtils.setField(chatService, "dateTimeTools", new DateTimeTools());
         ReflectionTestUtils.setField(chatService, "lookupKnowledgeTool", new LookupKnowledgeTool());
@@ -444,6 +506,7 @@ class ChatServiceSequentialAgentTest {
         ReflectionTestUtils.setField(chatService, "knowledgeDomainService", knowledgeDomainService);
         ReflectionTestUtils.setField(chatService, "toolTraceSummaryService", toolTraceSummaryService);
         ReflectionTestUtils.setField(chatService, "selfEvaluationMergeService", selfEvaluationMergeService);
+        ReflectionTestUtils.setField(chatService, "executorGatekeeperService", executorGatekeeperService);
         ReflectionTestUtils.setField(chatService, "verifierLowConfidenceThreshold", 0.5d);
         ReflectionTestUtils.setField(chatService, "chatPlannerPrompt", "PLANNER_TEST_PROMPT");
         ReflectionTestUtils.setField(chatService, "chatExecutorPrompt", "EXECUTOR_TEST_PROMPT");