# Changelog

## Score

- CAI 53 → 59 (+5.8)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

## Lenses

- Code Health 58 → 58 (-0.1)
- Architecture 68 → 69 (+0.8)
- Maturity 48 → 78 (+29.8)
- Readiness 52 → 54 (+2.1)
- Security 74 → 66 (-7.8)
- Performance 71 → 85 (+13.7)

## Resolved (74)

- BaseChatModelSetup.chat (cognitive 21) (python/flink_agents/api/chat_models/chat_model.py)
- DecisionModelAction.processDecisionRequest (cognitive 16) (plan/src/main/java/org/apache/flink/agents/plan/actions/DecisionModelAction.java)
- Duplicated block (10 lines × 2) (integrations/chat-models/gemini/src/main/java/org/apache/flink/agents/integrations/chatmodels/gemini/GeminiChatUtils.java)
- Duplicated block (12–13 lines × 3) (runtime/src/main/java/org/apache/flink/agents/runtime/operator/ActionExecutionOperator.java)
- Duplicated block (14–15 lines × 2) (examples/src/main/java/org/apache/flink/agents/examples/WorkflowSingleAgentExample.java)
- Duplicated block (17 lines × 3) (examples/src/main/java/org/apache/flink/agents/examples/ModelRoutingExample.java)
- Duplicated block (5 lines × 2) (integrations/chat-models/ollama/src/main/java/org/apache/flink/agents/integrations/chatmodels/ollama/OllamaChatModelConnection.java)
- Duplicated block (7 lines × 2) (python/flink_agents/api/events/chat_event.py)
- Duplicated block (7 lines × 2) (runtime/src/main/java/org/apache/flink/agents/runtime/subagent/DeferredSubagentFuture.java)
- Duplicated block (8 lines × 2) (plan/src/main/java/org/apache/flink/agents/plan/actions/ToolCallAction.java)
- LlmJudgeRoutingExecutor.selectWithinBudget (cognitive 17) (plan/src/main/java/org/apache/flink/agents/plan/routing/LlmJudgeRoutingExecutor.java)
- Members sharing a duplicated core (4 members, 50+ identical tokens) (integrations/chat-models/anthropic/src/main/java/org/apache/flink/agents/integrations/chatmodels/anthropic/AnthropicChatUtils.java)
- No assertions: agentRunBeginEventJavaSnapshotIsStable (api/src/test/java/org/apache/flink/agents/api/CrossLanguageEventSnapshotTest.java)
- No assertions: anInternalHandleSeparatedByADeferredOneIsRefused (runtime/src/test/java/org/apache/flink/agents/runtime/subagent/SubagentFutureGroupMixedBatchTest.java)
- No assertions: buildSkillsSupportsAllUrlSourceSecurityOptions (api/src/test/java/org/apache/flink/agents/api/yaml/YamlLoaderBuildersTest.java)
- No assertions: chatRequestEventJavaSnapshotIsStable (api/src/test/java/org/apache/flink/agents/api/CrossLanguageEventSnapshotTest.java)
- No assertions: chatResponseEventJavaSnapshotIsStable (api/src/test/java/org/apache/flink/agents/api/CrossLanguageEventSnapshotTest.java)
- No assertions: classifiesBareEventTypes (plan/src/test/java/org/apache/flink/agents/plan/condition/TriggerConditionTest.java)
- No assertions: classifiesNonEventTypesAsExpressions (plan/src/test/java/org/apache/flink/agents/plan/condition/TriggerConditionTest.java)
- No assertions: classifiesReservedExpressionCandidates (plan/src/test/java/org/apache/flink/agents/plan/condition/TriggerConditionTest.java)
- …and 54 more

## New (51)

- AgentPlan.validateDecisionModel (cognitive 17) (plan/src/main/java/org/apache/flink/agents/plan/AgentPlan.java)
- AgentPlan.validateDecisionModel (cyclomatic 16) (plan/src/main/java/org/apache/flink/agents/plan/AgentPlan.java)
- AgentPlan.validateRoutingStrategies (cognitive 18) (plan/src/main/java/org/apache/flink/agents/plan/AgentPlan.java)
- AgentPlan.validateRoutingStrategies (cyclomatic 16) (plan/src/main/java/org/apache/flink/agents/plan/AgentPlan.java)
- AgentTraceSpans.buildExecutionSpan (cognitive 44) (integrations/observability/otel/src/main/java/org/apache/flink/agents/integrations/observability/otel/AgentTraceSpans.java)
- AgentTraceSpans.buildExecutionSpan (cyclomatic 27) (integrations/observability/otel/src/main/java/org/apache/flink/agents/integrations/observability/otel/AgentTraceSpans.java)
- ClassTooLong: PgVectorVectorStore (integrations/vector-stores/pgvector/src/main/java/org/apache/flink/agents/integrations/vectorstores/pgvector/PgVectorVectorStore.java)
- DecisionModelInvoker.decideWithRetries (cognitive 18) (plan/src/main/java/org/apache/flink/agents/plan/actions/DecisionModelInvoker.java)
- DecisionModelRoutingExecutor.renderInput (cognitive 33) (plan/src/main/java/org/apache/flink/agents/plan/routing/DecisionModelRoutingExecutor.java)
- DecisionModelRoutingExecutor.renderInput (cyclomatic 19) (plan/src/main/java/org/apache/flink/agents/plan/routing/DecisionModelRoutingExecutor.java)
- Duplicated block (12 lines × 2) (python/flink_agents/api/events/chat_event.py)
- Duplicated block (13–14 lines × 3) (runtime/src/main/java/org/apache/flink/agents/runtime/operator/ActionExecutionOperator.java)
- Duplicated block (16–17 lines × 2) (examples/src/main/java/org/apache/flink/agents/examples/WorkflowSingleAgentExample.java)
- Duplicated block (17–18 lines × 3) (examples/src/main/java/org/apache/flink/agents/examples/ModelRoutingExample.java)
- Duplicated block (27–28 lines × 2) (examples/src/main/java/org/apache/flink/agents/examples/openai/OpenAiDecisionRoutingExample.java)
- Duplicated block (7 lines × 2) (examples/src/main/java/org/apache/flink/agents/examples/openai/OpenAiDecisionRoutingExample.java)
- Duplicated block (8 lines × 2) (integrations/vector-stores/milvus/src/main/java/org/apache/flink/agents/integrations/vectorstores/milvus/MilvusVectorStore.java)
- Duplicated block (8 lines × 2) (plan/src/main/java/org/apache/flink/agents/plan/routing/DecisionModelRoutingExecutor.java)
- Duplicated block (8 lines × 2) (python/flink_agents/api/events/chat_event.py)
- FileTooLong: pgvector/PgVectorVectorStore.java (integrations/vector-stores/pgvector/src/main/java/org/apache/flink/agents/integrations/vectorstores/pgvector/PgVectorVectorStore.java)
- …and 31 more

## Changes since last survey

- 32 commits — 22 feature/other, 10 fixes

## By area

- runtime/src — 10 commits
- integrations/chat-models — 5 commits
- python/flink_agents — 5 commits
- .github/workflows — 4 commits
- (root) — 1 commit
- dist/src — 1 commit
- docs/config.toml — 1 commit
- docs/content — 1 commit
- examples/src — 1 commit
- integrations/observability — 1 commit
- plan/src — 1 commit
- python/NOTICE — 1 commit

## Notable commits

- fix: [hotfix][api][java] Move ResourceContext lookup factory to test utilities (#1349)
- fix: [hotfix][ci] Cancel superseded CI runs for the same PR (#1359)
- fix: [hotfix][ci] Finalize PyArrow 11 on exit in Flink 1.20 tests (#1343)
- fix: [hotfix][ci] Reduce test logs and update Java IT and ReAct tests (#1323)
- fix: [hotfix][docs] Apply review guidance during development (#1358)
- fix: [hotfix][docs] Centralize stable release versions in setup examples (#1321)
- fix: [hotfix][docs] Finalize Flink Agents 0.4.0 release defaults (#1339)
- fix: [hotfix][python] Include NOTICE in Python distributions
- fix: [hotfix][runtime] Initialize output identity in routing recovery tests (#1371)
- fix: [runtime] Fix action-state key collisions between event occurrences with identical attributes (#1342)
- change: Update docs config for release-0.4
- change: Update version to 1.0-SNAPSHOT
- change: [api][java][python] Propagate user context from request events to responses (#1352)
- change: [api][plan][java] Add a decision-model routing strategy for MODEL_ROUTER (#1330)
- change: [docs] Standardize Alibaba Cloud Model Studio naming (#1329)
- change: [integration][java] Send user images and documents through the OpenAI Responses API (#1275)
- change: [integration][java] Send user images, audio, video and documents to Gemini (#1326)
- change: [integration][observability] Add OpenTelemetry GenAI exporter for Agent Traces (Phase 1) (#1160)
- change: [integrations][java] Add PostgreSQL pgvector vector store (#1143)
- change: [integrations][java][docs] Send images and documents in tool results through the OpenAI Responses API (#1364)
- …and 12 more

## Architecture

- Containers 0 added · 0 removed · contexts 1 added · 0 removed · edges 0 added · 0 removed

## Added bounded contexts (1)

- flink-agents-integrations-observability-otel
