Simplify references and output instructions in LLM prompts

internal/framework/validators/llm_context.go

@@ -8,8 +8,8 @@ import (
 // validationContext supplies adjacent source segments within the current chunk
 // and glossary definitions mentioned in the candidate or that local context.
 // These fields travel in each item so batching accounts for their size.
-func validationContext(req Request, segmentID int, corrected string) ([]schema.Segment, []schema.GlossaryEntry) {
-	var neighbors []schema.Segment
+func validationContext(req Request, segmentID int, corrected string) ([]NeighboringSegment, []schema.GlossaryEntry) {
+	var neighbors []NeighboringSegment
 	var source string
 	if req.WorkingTranscript != nil {
 		segments := req.WorkingTranscript.Segments
@@ -19,10 +19,10 @@ func validationContext(req Request, segmentID int, corrected string) ([]schema.S
 			}
 			source = segment.Text
 			if i > 0 {
-				neighbors = append(neighbors, segments[i-1])
+				neighbors = append(neighbors, neighboringSegment("preceding", segments[i-1]))
 			}
 			if i+1 < len(segments) {
-				neighbors = append(neighbors, segments[i+1])
+				neighbors = append(neighbors, neighboringSegment("following", segments[i+1]))
 			}
 			break
 		}
@@ -66,3 +66,7 @@ func fitValidationContext(item LLMValidationItem, budget int, estimator chunking
 		}
 	}
 }
+
+func neighboringSegment(position string, segment schema.Segment) NeighboringSegment {
+	return NeighboringSegment{Position: position, Speaker: segment.Speaker, Text: segment.Text, Categories: segment.Categories}
+}