ai_orchestrator/docs/architecture/07_error_model.md

Error Model

Error Families

ValidationError

Некорректный вход, schema mismatch, invalid command envelope.

PolicyError

Действие запрещено текущей конфигурацией или требует manual/confirm остановки.

RetryableInfrastructureError

Временная ошибка транспорта, timeout, transient upstream failure.

NonRetryableInfrastructureError

Постоянная ошибка конфигурации, unsupported capability, broken contract.

ExecutionError

Ошибка бизнес-исполнения конкретного node.

CancellationError

Task или node остановлены по explicit cancel.

User-Facing Behavior

• validation и policy ошибки должны быть ясными и краткими;
• infra ошибки должны сохранять technical details в logs/events;
• task итог должен различать failed и waiting for action.