agent foundation

lib/App/registerContainer.php

@@ -12,15 +12,17 @@ use MintyPHP\App\Container\Registrars\UserRegistrar;
 
 $container = new AppContainer();
 
+// Order matters: RepositoryFactoryRegistrar and ServiceFactoryRegistrar must run first
+// because later registrars pull concrete services from those factories.
 $registrars = [
-    new RepositoryFactoryRegistrar(),
-    new ServiceFactoryRegistrar(),
-    new AccessRegistrar(),
-    new AuthRegistrar(),
-    new DirectoryRegistrar(),
-    new UserRegistrar(),
-    new SettingsRegistrar(),
-    new AppServicesRegistrar(),
+    new RepositoryFactoryRegistrar(),   // raw repository factories (no deps)
+    new ServiceFactoryRegistrar(),      // service factories wired with their repo/gateway deps
+    new AccessRegistrar(),              // RBAC: permissions, roles, authorization
+    new AuthRegistrar(),               // authentication, SSO, tokens
+    new DirectoryRegistrar(),           // tenants, departments, scope
+    new UserRegistrar(),               // user services and repositories
+    new SettingsRegistrar(),           // settings, branding
+    new AppServicesRegistrar(),        // leaf services (stats, search, mail, scheduler, ...)
 ];
 
 foreach ($registrars as $registrar) {