2026-09-24 01:57:25 +00:00
|
|
|
package structuredoutput
|
|
|
|
|
|
2026-09-24 17:01:19 +00:00
|
|
|
import (
|
|
|
|
|
"errors"
|
|
|
|
|
|
2026-10-11 01:40:38 +00:00
|
|
|
"gitea.maximumdirect.net/eric/audita/v3/internal/framework/outcomes"
|
2026-09-24 17:01:19 +00:00
|
|
|
)
|
2026-09-24 01:57:25 +00:00
|
|
|
|
|
|
|
|
// FailureKind separates invalid generated content from operational failures.
|
|
|
|
|
type FailureKind string
|
|
|
|
|
|
|
|
|
|
const (
|
|
|
|
|
FailureMalformedOutput FailureKind = "malformed_output"
|
|
|
|
|
FailureRuntime FailureKind = "runtime"
|
|
|
|
|
)
|
|
|
|
|
|
2026-11-16 14:27:54 +00:00
|
|
|
// Failure exposes an operator-facing message and retains the typed cause.
|
2026-09-24 01:57:25 +00:00
|
|
|
type Failure struct {
|
2026-09-24 17:01:19 +00:00
|
|
|
Class FailureClass
|
|
|
|
|
Reason outcomes.ReasonCode
|
2026-09-24 01:57:25 +00:00
|
|
|
Message string
|
|
|
|
|
Cause error
|
|
|
|
|
}
|
|
|
|
|
|
2026-09-24 17:01:19 +00:00
|
|
|
// FailureClass determines whether domain processing may safely skip a model
|
|
|
|
|
// operation or must stop the run. Parent cancellation always stops the run.
|
2026-11-16 14:27:54 +00:00
|
|
|
type FailureClass = outcomes.FailureClass
|
2026-09-24 17:01:19 +00:00
|
|
|
|
|
|
|
|
const (
|
2026-11-16 14:27:54 +00:00
|
|
|
FailureRecoverable = outcomes.FailureRecoverable
|
|
|
|
|
FailureFatal = outcomes.FailureFatal
|
|
|
|
|
FailureCanceled = outcomes.FailureCanceled
|
2026-09-24 17:01:19 +00:00
|
|
|
)
|
|
|
|
|
|
2026-09-24 01:57:25 +00:00
|
|
|
func (f *Failure) Error() string { return f.Message }
|
|
|
|
|
func (f *Failure) Unwrap() error { return f.Cause }
|
|
|
|
|
|
2026-09-24 17:01:19 +00:00
|
|
|
func IsRecoverable(err error) bool {
|
|
|
|
|
var failure *Failure
|
|
|
|
|
return errors.As(err, &failure) && failure.Class == FailureRecoverable
|
|
|
|
|
}
|
|
|
|
|
|
2026-11-16 14:27:54 +00:00
|
|
|
// RecordFailure retains the error chain for processing and sets the compact
|
|
|
|
|
// reason used by reports. An absent reason does not change recoverability.
|
|
|
|
|
func RecordFailure(operation *outcomes.Operation, err error) {
|
|
|
|
|
operation.Cause = err
|
|
|
|
|
operation.FailureClass = FailureFatal
|
|
|
|
|
operation.FailureReason = outcomes.ReasonInternalFailure
|
|
|
|
|
var failure *Failure
|
|
|
|
|
if errors.As(err, &failure) {
|
|
|
|
|
operation.FailureClass = failure.Class
|
|
|
|
|
if failure.Reason != "" {
|
|
|
|
|
operation.FailureReason = failure.Reason
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2026-09-24 01:57:25 +00:00
|
|
|
func IsMalformedError(err error) bool {
|
|
|
|
|
var failure *Failure
|
2026-11-16 14:27:54 +00:00
|
|
|
return errors.As(err, &failure) && failure.Reason == outcomes.ReasonInvalidOutputExhausted
|
2026-09-24 01:57:25 +00:00
|
|
|
}
|