Pedagogical analytics event pipeline

[satra]

Summary

Build the pedagogical analytics event pipeline so session logs capture reading position, timestamps, pedagogical behaviors, scaffolding, wait time, motivational prompts, and student engagement signals.

Scope

• store normalized session events separate from derived summaries
• log pedagogical events such as question type, scaffolding, contingent follow-ups, and wait time
• log engagement signals such as response length, latency, and participation trends
• attach reading position context to relevant events
• make the pipeline reusable across KIVA flows

Deliverables

• event ingestion and persistence pipeline
• pedagogical and engagement event taxonomy
• session artifact format updates
• basic analytics extractors over normalized events

Testing

• event persistence tests
• taxonomy coverage tests over replay traces
• integration tests for session artifact generation

Dependencies

• depends on contracts
• should align with reading state and policy engine work