Turn Summaries

Done2026-10-30Jean Mertz

tracking-rfd: 126type: tracking

Tracking ticket for RFD 126.

Implementation plan

• Add TurnStart summary field and stream accessors: Turns TurnStart into a struct with an optional summary that is omitted from JSON when None. Adds Turn::id(), Turn::summary() and ConversationStream::set_turn_summary, with tests for serde round-trips, legacy JSON and setter lookup by EventId. Independent, can merge on its own.
• Add turn summary configuration: Adds TurnSummaryConfig and TurnSummaryGenerateConfig (auto, batch_size, model) under ConversationConfig in jp_config, with the config traits implemented and tests for loading, --cfg assignment and deltas. Independent, can merge in parallel with Phase 1.
• Build the turn summarizer in jp_llm: Adds jp_llm::turn_summary with the model fallback chain, the stripped standalone transcript builder, turn fingerprints, turn-granular packing, the structured output schema and prompt with ID filtering, and mechanical_turn_summary. Covers these with unit tests, including compacted candidates, oversized turns and unrequested IDs. Depends on Phases 1 and 2.
• Add TurnSummaryTask and wire into jp query: Implements TurnSummaryTask: run generates summaries under a cancellation select!, and sync locks the conversation, drops results whose fingerprint changed, writes the rest with set_turn_summary and flushes. Spawns it from jp query when auto && persist, updates the --events long help, and adds integration tests for lagged summarization and for edits between spawn and sync. Depends on Phase 3.