Files
notarius/internal/modules/dnd/validate/scenedescriptions/combat_semantics/interpretation.go

71 lines
2.5 KiB
Go

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...)
}