aeat.core.storage_route_guidance module

Operator-facing guidance for storage route refusals.

This module centralises recovery text that several boundaries attach to fail-closed storage-route diagnostics. The string is used when an explicit AEAT_DATABASE_URL leaves the effective StorageRouteKind as EXPLICIT_DATABASE_URL and profile-bound code must refuse instead of deriving an active bucket database.

The module is text-only by design. Route classification remains in core.config.classify_storage_route(), runtime readiness remains in aeat.adapters.persistence.storage.runtime, and write-policy decisions remain in aeat.application.storage_write_policy. Keeping this recovery hint in core lets those layers share one operator message without exposing database paths, bucket identifiers, profile identifiers, or key material.