ENGINE: Added File Headers and Guidance in AGENTS.md

Data/Engine/services/API/access_management/__init__.py

@@ -0,0 +1,7 @@
+# ======================================================
+# Data\Engine\services\API\access_management\__init__.py
+# Description: Namespace for access-management endpoints consumed by the Engine auth group.
+#
+# API Endpoints (if applicable): None
+# ======================================================
+

Data/Engine/services/API/access_management/credentials.py

@@ -1 +1,8 @@
+# ======================================================
+# Data\Engine\services\API\access_management\credentials.py
+# Description: Placeholder for future credential management endpoints (not yet implemented).
+#
+# API Endpoints (if applicable): None
+# ======================================================
+
 """Placeholder for credentials API module."""

Data/Engine/services/API/access_management/login.py

@@ -1,3 +1,14 @@
+# ======================================================
+# Data\Engine\services\API\access_management\login.py
+# Description: Primary authentication blueprint used by the Engine auth group for sessions, MFA, and logout.
+#
+# API Endpoints (if applicable):
+# - POST /api/auth/login (No Authentication) - Authenticates operator credentials and starts a session token.
+# - POST /api/auth/logout (Token Authenticated) - Clears the active operator session and authentication cookie.
+# - POST /api/auth/mfa/verify (Token Authenticated (MFA pending)) - Verifies TOTP codes during multifactor setup or login.
+# - GET /api/auth/me (Token Authenticated) - Returns the currently authenticated operator profile.
+# ======================================================
+
 """Authentication endpoints for the Borealis Engine API."""
 from __future__ import annotations
 

Data/Engine/services/API/access_management/security/tokens.py

@@ -1 +1,8 @@
+# ======================================================
+# Data\Engine\services\API\access_management\security\tokens.py
+# Description: Placeholder for token lifecycle endpoints within access management.
+#
+# API Endpoints (if applicable): None
+# ======================================================
+
 """Placeholder for tokens API module."""

Data/Engine/services/API/access_management/users.py

@@ -1 +1,8 @@
+# ======================================================
+# Data\Engine\services\API\access_management\users.py
+# Description: Placeholder for operator user management endpoints (not yet implemented).
+#
+# API Endpoints (if applicable): None
+# ======================================================
+
 """Placeholder for users API module."""