Complete Phase 10 LLM validators

internal/framework/validators/models.go

@@ -29,14 +29,18 @@ type Request struct {
 	ReplacementPolicy proposals.ReplacementPolicy            `json:"replacement_policy"`
 	Glossary          *schema.Glossary                       `json:"-"`
 	Config            *config.Config                         `json:"-"`
+	LLMClient         StructuredLLMClient                    `json:"-"`
+	Scheduler         ValidationScheduler                    `json:"-"`
+	DiagnosticsWriter InteractionDiagnosticsWriter           `json:"-"`
 }
 
 // Decision is one validator decision for one proposal index.
 type Decision struct {
-	ProposalIndex int    `json:"proposal_index"`
-	Approved      bool   `json:"approved"`
-	ReasonCode    string `json:"reason_code"`
-	Message       string `json:"message"`
+	ProposalIndex          int    `json:"proposal_index"`
+	Approved               bool   `json:"approved"`
+	ReasonCode             string `json:"reason_code"`
+	Message                string `json:"message"`
+	DiagnosticArtifactPath string `json:"diagnostic_artifact_path,omitempty"`
 }
 
 // Result is one validator output containing exactly one decision per proposal index.
@@ -45,6 +49,22 @@ type Result struct {
 	Decisions     []Decision `json:"decisions"`
 }
 
+// ValidationScheduler provides bounded execution for validator LLM calls.
+type ValidationScheduler interface {
+	Run(ctx context.Context, fn func(context.Context) error) error
+}
+
+type InteractionDiagnosticsWriter interface {
+	WriteInteraction(stage string, requestMetadata any, requestPayload any, responsePayload any, errorPayload any) (InteractionArtifacts, error)
+}
+
+type InteractionArtifacts struct {
+	RequestMetadataPath string `json:"request_metadata_path,omitempty"`
+	RequestPayloadPath  string `json:"request_payload_path,omitempty"`
+	ResponsePayloadPath string `json:"response_payload_path,omitempty"`
+	ErrorPayloadPath    string `json:"error_payload_path,omitempty"`
+}
+
 // Validator is the deterministic runtime validator interface.
 type Validator interface {
 	Name() string