Files

T

kami 2c459da009 feat(router): implement Epic 14 — core:router module

Implements the full conversational router facade: RouterState, RouterReducer,
RouterProjector, RouterRepository, RouterContextBuilder, RouterFacade, protocol
types, WebSocket wiring, infrastructure factory, and deterministic test suite.

Also fixes spec divergences found in post-implementation review:
- Add SteeringNote domain object to core:context (epic prerequisite)
- Rename RouterFacade.handleChat → onUserInput per spec interface contract
- Add in-memory ConcurrentHashMap conversation history to DefaultRouterFacade
- Make RouterRepository.getRouterState suspend
- Rename RouterConfig.keepLast → conversationKeepLast, fix defaults (6, 4096)
- Refactor InfrastructureModule.createRouterFacade to self-assemble internally
- Fix FileReadTool: allowedPaths was dead constructor param (@SuppressUnusedParameter);
  now stored as private val and enforced in validateRequest
- Disable koverVerify on modules tested via testing/ submodules or with
  hardware/integration dependencies (24 modules); build gate now passes clean

2026-05-21 15:06:20 +04:00

1.9 KiB

Raw Blame History

task-009

status: done

goal

Implement RouterReducer — reduces RouterState from SteeringNoteAddedEvent and workflow lifecycle events (started, completed, failed, paused, resumed, stage completed, stage failed).

target artifact

core/router/src/main/kotlin/com/correx/core/router/RouterReducer.kt

execution steps

Create RouterReducer interface in core/router module matching the convention (reduce(state: RouterState, event: StoredEvent): RouterState)
Implement DefaultRouterReducer class implementing RouterReducer
Handle SteeringNoteAddedEvent — append a USER-role RouterTurn to conversationHistory
Handle WorkflowStartedEvent — set workflowStatus = RUNNING, set currentStageId from startStageId
Handle WorkflowCompletedEvent — set workflowStatus = COMPLETED, clear currentStageId
Handle WorkflowFailedEvent — set workflowStatus = FAILED, clear currentStageId
Handle OrchestrationPausedEvent — set workflowStatus = PAUSED
Handle OrchestrationResumedEvent — set workflowStatus = RUNNING
Handle StageCompletedEvent — append a RouterL2Entry with StageOutcomeKind.SUCCESS to l2Memory
Handle StageFailedEvent — append a RouterL2Entry with StageOutcomeKind.FAILURE to l2Memory, clear currentStageId
Return unchanged state for any unknown event types (catch-all else branch)

changed artifacts

core/router/src/main/kotlin/com/correx/core/router/RouterReducer.kt — new file

blockers

none

notes

Handler methods that don't need payload data (handleWorkflowCompleted, handleWorkflowFailed, handleOrchestrationPaused, handleOrchestrationResumed) take only state parameter to avoid detekt UnusedParameter warnings
All state mutations use state.copy(...) per core architecture pattern — state is never mutated in place
Timestamps come from event.metadata.timestamp to preserve the original event ordering

1.9 KiB Raw Blame History