Summary
Three REST interfaces are missing core OpenAPI annotations that all other REST endpoints have.
What to add
| Interface |
File |
What's missing |
IRestUserConversationStore |
engine/triggermanagement/IRestUserConversationStore.java |
@Operation on all 3 methods |
IRestHtmlChatResource |
ui/IRestHtmlChatResource.java |
@Operation on both methods |
ILogoutEndpoint |
engine/api/ILogoutEndpoint.java |
@Tag class-level annotation (methods already have @Operation) |
Pattern
@Operation — add a summary field:
@Operation(summary = "Read user conversation", description = "...")
@Tag:
@Tag(name = "Authentication")
Tags should match an entry in src/main/java/ai/labs/eddi/configs/OpenApiConfig.java. If no matching tag exists, add one there too.
Verify before starting: Confirm these annotations are still missing — the codebase may have been updated since this issue was filed.
Acceptance criteria
Summary
Three REST interfaces are missing core OpenAPI annotations that all other REST endpoints have.
What to add
IRestUserConversationStoreengine/triggermanagement/IRestUserConversationStore.java@Operationon all 3 methodsIRestHtmlChatResourceui/IRestHtmlChatResource.java@Operationon both methodsILogoutEndpointengine/api/ILogoutEndpoint.java@Tagclass-level annotation (methods already have@Operation)Pattern
@Operation— add asummaryfield:@Tag:Tags should match an entry in
src/main/java/ai/labs/eddi/configs/OpenApiConfig.java. If no matching tag exists, add one there too.Acceptance criteria
IRestUserConversationStore: all 3 methods have@OperationIRestHtmlChatResource: both methods have@OperationILogoutEndpoint: has class-level@Tag./mvnw compilepasses