Expand module contracts for references and normalizer LLM access

internal/framework/contracts/contracts.go

@@ -58,6 +58,7 @@ type SourceChunk struct {
 
 type ChunkRequest struct {
 	Source     *source.SourceDocument `json:"-"`
+	References ReferenceSet           `json:"references,omitempty"`
 	LLMClient  StructuredLLMClient    `json:"-"`
 	LLMProfile string                 `json:"llm_profile,omitempty"`
 	Options    map[string]any         `json:"options,omitempty"`
@@ -71,6 +72,7 @@ type ChunkResult struct {
 
 type Chunker interface {
 	Key() string
+	ReferenceSlots() []ReferenceSlot
 	Chunk(ctx context.Context, req ChunkRequest) (ChunkResult, error)
 }
 
@@ -165,6 +167,8 @@ type NormalizeRequest struct {
 	Source     *source.SourceDocument        `json:"-"`
 	LaneID     string                        `json:"lane_id"`
 	Candidates []artifacts.ArtifactCandidate `json:"candidates"`
+	References ReferenceSet                  `json:"references,omitempty"`
+	LLMClient  StructuredLLMClient           `json:"-"`
 	LLMProfile string                        `json:"llm_profile,omitempty"`
 	Options    map[string]any                `json:"options,omitempty"`
 	Metadata   map[string]any                `json:"metadata,omitempty"`
@@ -177,6 +181,7 @@ type NormalizeResult struct {
 
 type Normalizer interface {
 	Key() string
+	ReferenceSlots() []ReferenceSlot
 	Normalize(ctx context.Context, req NormalizeRequest) (NormalizeResult, error)
 }