Strengthen validation retries and checkpoint safety

internal/modules/dnd/validate/spells/catalog/validator.go

@@ -98,7 +98,7 @@ func rejection(unknown []unknownSpell) contracts.ValidationResult {
 		issues = append(issues, issue)
 	}
 	message := rejectionMessage(issues, len(unknown)-len(issues))
-	return contracts.ValidationResult{Approved: false, ReasonCode: ReasonCode, Message: message}
+	return contracts.ValidationResult{Approved: false, ReasonCode: ReasonCode, Message: message, CorrectionGuidance: "Use recognized D&D spell names supported by the supplied transcript evidence, and omit any candidate that is not a spell cast."}
 }
 
 func truncateDisplayedName(name string) string {

internal/modules/dnd/validate/spells/catalog/validator_test.go

@@ -54,6 +54,9 @@ func TestValidatorRejectsMultipleUnknownCastsInStableOrder(t *testing.T) {
 	if result.Approved || result.ReasonCode != ReasonCode {
 		t.Fatalf("Validate() = %#v, want unknown-spell rejection", result)
 	}
+	if err := contracts.ValidateValidationResult(result); err != nil {
+		t.Fatalf("ValidateValidationResult() error = %v for %#v", err, result)
+	}
 	if want := `spell_casts[0].spell "Unknown First", spell_casts[2].spell "Unknown Second"`; !strings.Contains(result.Message, want) {
 		t.Fatalf("message = %q, want %q", result.Message, want)
 	}

internal/modules/dnd/validate/spells/shape/validator.go

@@ -75,5 +75,5 @@ func DecodeOptions(options map[string]any) (Options, error) {
 }
 func validateOptions(options map[string]any) error { _, err := DecodeOptions(options); return err }
 func rejection(message string) contracts.ValidationResult {
-	return contracts.ValidationResult{Approved: false, ReasonCode: ReasonCode, Message: message}
+	return contracts.ValidationResult{Approved: false, ReasonCode: ReasonCode, Message: message, CorrectionGuidance: "Return a complete spell-cast list with a nonblank spell name and caster plus valid source references for every cast."}
 }

internal/modules/dnd/validate/spells/source_refs/validator.go

@@ -111,5 +111,5 @@ func DecodeOptions(options map[string]any) (Options, error) {
 }
 func validateOptions(options map[string]any) error { _, err := DecodeOptions(options); return err }
 func rejection(message string) contracts.ValidationResult {
-	return contracts.ValidationResult{Approved: false, ReasonCode: ReasonCode, Message: message}
+	return contracts.ValidationResult{Approved: false, ReasonCode: ReasonCode, Message: message, CorrectionGuidance: "Return spell casts whose source references identify valid transcript ranges within the supplied extraction chunk and directly support the named spell and caster."}
 }