Interface declaration for a permission evaluator. It defines a single method Explain that takes an ActorIdentity and a permission string and returns a PermissionExplanation. It documents that unknown permissions are denied and that no default implementation is provided.
namespace SboxSuperuser.Engine.Permissions;
// T05 boundary: bridge host identity to engine-independent policy evaluation.
// Unknown permissions deny; this declaration supplies no default implementation.
internal interface IPermissionEvaluator
{
PermissionExplanation Explain( ActorIdentity actor, string permission );
}