kami
d26f20c316
Root Child DOX Index assembled, plus a per-module AGENTS.md across the tree (core/*, infrastructure/*, apps/*, testing/*, and docs/examples/frontend/etc), each following the DOX section shape: Purpose, Ownership, Local Contracts, Work Guidance, Verification, Child DOX Index.
1.8 KiB
1.8 KiB
core/sessions — AGENTS.md
Purpose
Session lifecycle management: defines session state, status transitions, approval mode, bound profile/workspace, and the projector/reducer/repository stack for tracking active and historical sessions.
Ownership
CORREX kernel team.
Local Contracts
Session— core session domain type with id, status, bound profile and workspace.SessionStaterebuilt fromSessionEventsviaDefaultSessionReducer+SessionProjector.DefaultSessionRepositorywrapsEventReplayer<SessionState>.SessionStatus— enum of lifecycle states (e.g. PENDING, RUNNING, COMPLETE, FAILED).ApprovalMode— per-session approval policy binding (AUTO, MANUAL, etc.).BoundAgentInstructions/BoundProfile/BoundProjectProfile/BoundWorkspace— types capturing what was bound to the session at launch time; these are immutable once set.SessionSummary/SessionSummaryProjector— lightweight projection for listing sessions without full state replay.SessionCounterProjection/SessionCounterState— cross-session counter projection.TransitionResult— outcome type for session state transitions.
Work Guidance
- Follow the standard Events→State→Reducer→Projector→Repository pattern (see
core/AGENTS.md). DefaultSessionReduceronly doesstate.copy(...). No lifecycle decision logic in the reducer.- Bound types (
BoundProfile,BoundWorkspace, etc.) are immutable once written to the event log. Do not mutate them post-bind.
Verification
./gradlew :core:sessions:test --rerun-tasks
Tests in testing/projections/ (DefaultSessionReducerTest) and testing/replay/ (SessionReplayTest, SessionEmptyReplayTest).
Child DOX Index
No child AGENTS.md (leaf module).