Implement runner retries and raw validation

internal/framework/contracts/contracts.go

@@ -203,6 +203,32 @@ type RawPayload struct {
 	Warnings  []Warning      `json:"warnings,omitempty"`
 }
 
+type RawValidationRequest struct {
+	Stage      string                 `json:"stage"`
+	LaneID     string                 `json:"lane_id,omitempty"`
+	ModuleKey  string                 `json:"module_key"`
+	Source     *source.SourceDocument `json:"-"`
+	SourceID   string                 `json:"source_id,omitempty"`
+	ChunkID    string                 `json:"chunk_id,omitempty"`
+	ChunkIndex int                    `json:"chunk_index,omitempty"`
+	Schema     ResponseSchema         `json:"schema,omitempty"`
+	Payload    RawPayload             `json:"payload"`
+	Metadata   map[string]any         `json:"metadata,omitempty"`
+}
+
+type RawValidationResult struct {
+	Approved               bool      `json:"approved"`
+	ReasonCode             string    `json:"reason_code,omitempty"`
+	Message                string    `json:"message,omitempty"`
+	DiagnosticArtifactPath string    `json:"diagnostic_artifact_path,omitempty"`
+	Warnings               []Warning `json:"warnings,omitempty"`
+}
+
+type RawValidator interface {
+	Name() string
+	ValidateRaw(ctx context.Context, req RawValidationRequest) (RawValidationResult, error)
+}
+
 type ResponseSchema struct {
 	ID      string `json:"id,omitempty"`
 	Name    string `json:"name,omitempty"`