Add LLM-assisted NPC normalization

internal/modules/dnd/normalize/npcs/context_material.go

@@ -16,8 +16,9 @@ import (
 const semanticContextRadius = 2
 
 type normalizeContextMaterials struct {
-	Candidates contracts.LLMInputMaterial
-	Transcript contracts.LLMInputMaterial
+	Candidates         contracts.LLMInputMaterial
+	Transcript         contracts.LLMInputMaterial
+	candidatePositions []int
 }
 
 type normalizeCandidateInput struct {
@@ -81,11 +82,12 @@ func buildNormalizeContextMaterials(doc *source.SourceDocument, records []dnd.NP
 
 	index := source.NewDocumentIndex(doc)
 	candidates := make([]normalizeCandidate, 0, len(records))
+	candidatePositions := make([]int, 0, len(records))
 	intervals := make([]sourceInterval, 0)
 	cited := make([]bool, len(doc.Units))
 	seenKeys := make(map[string]struct{}, len(records))
 
-	for _, record := range records {
+	for position, record := range records {
 		key := identity.ComparisonKey(record.Name)
 		if key == "" || len(record.SourceRefs) == 0 {
 			continue
@@ -100,6 +102,7 @@ func buildNormalizeContextMaterials(doc *source.SourceDocument, records []dnd.NP
 		}
 		seenKeys[key] = struct{}{}
 		candidates = append(candidates, normalizeCandidate{Name: record.Name, SourceRefs: references})
+		candidatePositions = append(candidatePositions, position)
 		for _, interval := range recordIntervals {
 			for position := interval.start; position <= interval.end; position++ {
 				cited[position] = true
@@ -127,8 +130,9 @@ func buildNormalizeContextMaterials(doc *source.SourceDocument, records []dnd.NP
 		return normalizeContextMaterials{}, false, fmt.Errorf("build NPC normalization context: encode transcript: %w", err)
 	}
 	return normalizeContextMaterials{
-		Candidates: newNormalizeInputMaterial("candidates", candidateContent),
-		Transcript: newNormalizeInputMaterial("transcript", transcriptContent),
+		Candidates:         newNormalizeInputMaterial("candidates", candidateContent),
+		Transcript:         newNormalizeInputMaterial("transcript", transcriptContent),
+		candidatePositions: candidatePositions,
 	}, true, nil
 }