ENGINE: Added File Headers and Guidance in AGENTS.md

Data/Engine/Unit_Tests/__init__.py

@@ -1 +1,8 @@
+# ======================================================
+# Data\Engine\Unit_Tests\__init__.py
+# Description: Package marker for Engine unit and smoke tests.
+#
+# API Endpoints (if applicable): None
+# ======================================================
+
 """Unit and smoke tests for the Borealis Engine runtime."""

Data/Engine/Unit_Tests/conftest.py

@@ -1,3 +1,10 @@
+# ======================================================
+# Data\Engine\Unit_Tests\conftest.py
+# Description: Pytest fixtures that seed the Engine app, SQLite schema, TLS materials, and WebUI assets.
+#
+# API Endpoints (if applicable): None
+# ======================================================
+
 from __future__ import annotations
 
 import json

Data/Engine/Unit_Tests/test_core_api.py

@@ -1,3 +1,10 @@
+# ======================================================
+# Data\Engine\Unit_Tests\test_core_api.py
+# Description: Validates the Engine /health endpoint wiring.
+#
+# API Endpoints (if applicable): None
+# ======================================================
+
 from __future__ import annotations
 
 

Data/Engine/Unit_Tests/test_devices_api.py

@@ -1,3 +1,9 @@
+# ======================================================
+# Data\Engine\Unit_Tests\test_devices_api.py
+# Description: Exercises device management endpoints covering lists, views, site workflows, and approvals.
+#
+# API Endpoints (if applicable): None
+# ======================================================
 
 from __future__ import annotations
 

Data/Engine/Unit_Tests/test_enrollment_api.py

@@ -1,3 +1,10 @@
+# ======================================================
+# Data\Engine\Unit_Tests\test_enrollment_api.py
+# Description: Covers device enrollment request and poll flows including cryptographic proof handling.
+#
+# API Endpoints (if applicable): None
+# ======================================================
+
 from __future__ import annotations
 
 import base64

Data/Engine/Unit_Tests/test_tokens_api.py

@@ -1,3 +1,10 @@
+# ======================================================
+# Data\Engine\Unit_Tests\test_tokens_api.py
+# Description: Validates refresh token issuance, expiry handling, and error cases.
+#
+# API Endpoints (if applicable): None
+# ======================================================
+
 from __future__ import annotations
 
 import hashlib

Data/Engine/Unit_Tests/test_web_ui.py

@@ -1,3 +1,10 @@
+# ======================================================
+# Data\Engine\Unit_Tests\test_web_ui.py
+# Description: Ensures Engine WebUI static routing and SPA fallback respond as expected.
+#
+# API Endpoints (if applicable): None
+# ======================================================
+
 from __future__ import annotations