package combat_semantics import ( "fmt" "strings" "unicode/utf8" "gitea.maximumdirect.net/eric/notarius/internal/framework/contracts" "gitea.maximumdirect.net/eric/notarius/internal/modules/dnd" ) const ( ReasonCodeActiveCombatNotClassified = "scene_active_combat_not_classified" ReasonCodeCombatClassificationUnsupported = "scene_combat_classification_unsupported" maximumExplanationRunes = 512 ) type classificationResponse struct { Classification string `json:"classification"` Explanation string `json:"explanation"` } func interpretResponse(response classificationResponse, proposedKind dnd.SceneKind) (contracts.ValidationResult, error) { explanation, err := validateExplanation(response.Explanation) if err != nil { return contracts.ValidationResult{}, err } switch response.Classification { case "combat": if proposedKind == dnd.SceneKindCombat { return contracts.ValidationResult{Approved: true}, nil } return contracts.ValidationResult{ Approved: false, ReasonCode: ReasonCodeActiveCombatNotClassified, Message: "The current chunk contains substantive active combat that is not classified as combat.", CorrectionGuidance: "Return kind: combat for this scene. " + explanation, }, nil case "non_combat": if proposedKind != dnd.SceneKindCombat { return contracts.ValidationResult{Approved: true}, nil } return contracts.ValidationResult{ Approved: false, ReasonCode: ReasonCodeCombatClassificationUnsupported, Message: "The current chunk does not support a combat classification.", CorrectionGuidance: "Choose the appropriate narrative, recap, or meta kind for this scene. " + explanation, }, nil default: return contracts.ValidationResult{}, validatorErrorf("unsupported combat-semantics classification %q", response.Classification) } } func validateExplanation(value string) (string, error) { if !utf8.ValidString(value) { return "", validatorErrorf("validator explanation must be valid UTF-8") } trimmed := strings.TrimSpace(value) if trimmed == "" { return "", validatorErrorf("validator explanation must not be blank") } if utf8.RuneCountInString(trimmed) > maximumExplanationRunes { return "", validatorErrorf("validator explanation exceeds %d Unicode code points", maximumExplanationRunes) } return trimmed, nil } func validatorErrorf(format string, args ...any) error { return fmt.Errorf("scene combat-semantics validator: "+format, args...) }