Simplify references and output instructions in LLM prompts

internal/framework/validators/llm_models.go

@@ -17,16 +17,17 @@ type StructuredCompletionRequest = structuredoutput.Request
 type StructuredCompletionResponse = structuredoutput.Response
 type StructuredLLMClient = structuredoutput.Client
 
-// LLMValidationItem is one candidate correction payload passed to LLM validators.
+// LLMValidationItem retains the internal proposal index until prompt encoding.
+// BuildValidationVariables substitutes a one-based reference for each batch.
 type LLMValidationItem struct {
 	CorrectionIndex      int                    `json:"correction_index"`
-	SegmentID            int                    `json:"id"`
+	SegmentID            int                    `json:"-"`
 	OriginalText         string                 `json:"original_text"`
 	CorrectedText        string                 `json:"corrected_text"`
 	OriginalSegmentText  string                 `json:"original_segment_text"`
 	CorrectedSegmentText string                 `json:"corrected_segment_text"`
 	Categories           []string               `json:"categories,omitempty"`
-	NeighboringSegments  []schema.Segment       `json:"neighboring_segments,omitempty"`
+	NeighboringSegments  []NeighboringSegment   `json:"neighboring_segments,omitempty"`
 	GlossaryEntries      []schema.GlossaryEntry `json:"glossary_entries,omitempty"`
 }
 
@@ -41,6 +42,7 @@ type LLMValidationRequest struct {
 	Items             []LLMValidationItem `json:"corrections"`
 }
 
+// LLMValidationDecision contains a request-local correction_index, not a proposal index.
 type LLMValidationDecision struct {
 	CorrectionIndex int     `json:"correction_index"`
 	Approved        bool    `json:"approved"`
@@ -51,3 +53,11 @@ type LLMValidationDecision struct {
 type LLMValidationResponse struct {
 	Validations []LLMValidationDecision `json:"validations"`
 }
+
+// NeighboringSegment carries semantic context without internal transcript identity.
+type NeighboringSegment struct {
+	Position   string   `json:"position"`
+	Speaker    string   `json:"speaker"`
+	Text       string   `json:"text"`
+	Categories []string `json:"categories,omitempty"`
+}