agent foundation

lib/Service/Access/AuthorizationDecision.php

@@ -2,6 +2,9 @@
 
 namespace MintyPHP\Service\Access;
 
+// Immutable value object returned by every authorization policy.
+// The $attributes bag lets policies carry extra computed data to the caller
+// (e.g. the capabilities map built during the user-edit context check).
 class AuthorizationDecision
 {
     public function __construct(