71 lines
2.5 KiB
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...)
|
|
}
|