feat: introduce module system and extract address book as first module (MODULAR-MONOLITH-V1-001)

Add a module kernel (ModuleManifest, ModuleRegistry) that allows modules to
contribute routes, UI slots, search providers, layout context, session
lifecycle, and permissions. Modules are activated via config/modules.php or
APP_ENABLED_MODULES env variable. Conflicts (duplicate routes, permissions,
slot keys) cause a fail-fast with a clear error message.

Extract the address book from hardcoded Core integration points into the
first module (modules/addressbook/). The module provides:
- Aside icon-bar tab + People panel via UI slot system
- Global search resource via AddressBookSearchProvider
- Layout context data via AddressBookLayoutProvider
- Session lifecycle via AddressBookSessionProvider

Core cleanup removes address-book hardcodings from SearchSqlResourceProvider,
SearchUiMetaProvider, SearchItemMapperProvider, appBuildLayoutNavContext(),
and the aside templates. Permissions (ADDRESS_BOOK_VIEW) and business logic
(AddressBookService) remain in Core as they gate general user visibility.

Includes 38 new tests (894 total), PHPStan level 5 clean, and architecture
tests verifying zero hardcoded address-book references in search/templates.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

lib/Module/AddressBook/Providers/AddressBookLayoutProvider.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace MintyPHP\Module\AddressBook\Providers;
+
+use MintyPHP\App\AppContainer;
+use MintyPHP\App\Module\Contracts\LayoutContextProvider;
+
+/**
+ * Provides address book data for the layout navigation context.
+ *
+ * Contributes the 'addressBook' key to $layoutNav with URL, active filters,
+ * and people groups from the session.
+ */
+final class AddressBookLayoutProvider implements LayoutContextProvider
+{
+    public function provide(array $session, AppContainer $container): array
+    {
+        // Read query params for active filter state
+        $query = [];
+        try {
+            $query = requestInput()->queryAll();
+        } catch (\Throwable) {
+            // fail-open: may not be available in CLI context
+        }
+
+        return [
+            'addressBook' => [
+                'url' => lurl('address-book'),
+                'activeSearch' => trim((string) ($query['search'] ?? '')),
+                'activeTenants' => appNormalizeStringList($query['tenants'] ?? ''),
+                'activeDepartments' => appNormalizePositiveIntList($query['departments'] ?? ''),
+                'activeRoles' => appNormalizePositiveIntList($query['roles'] ?? ''),
+                'activeCustomFilters' => appNormalizeAddressBookCustomFilterQuery($query),
+                'peopleGroups' => is_array($session['available_departments_by_tenant'] ?? null)
+                    ? $session['available_departments_by_tenant']
+                    : [],
+            ],
+        ];
+    }
+}