refactor(roadmap): insert Phase 6 for driver lifecycle contract and shift phases

Introduce a dedicated Phase 6 to formalize driver lifecycle states and resolver
responsibility, enforcing lazy initialization and side-effect-free resolution.

Phase 5.5 is shifted to Phase 7, and all subsequent phases are renumbered
accordingly with no scope changes.

Author: megyptm

roadmap.json

@@ -189,8 +189,58 @@
         "examples": { "tasks": [], "outputs": [] }
       }
     },
+
+
     {
-      "id": "phase5_5",
+      "id": "phase6",
+      "title": "Driver Lifecycle & Resolver Responsibility Contract",
+      "version": "1.0.0",
+      "status": "pending",
+      "summary": "Formalize driver lifecycle states and strictly define resolver responsibilities to eliminate side effects, duplicated initialization, and implicit infrastructure access.",
+      "tracks": {
+        "core": {
+          "tasks": [
+            "Define driver lifecycle states (uninitialized / ready / failed)",
+            "Introduce explicit initialization contract in AbstractSecurityGuardDriver",
+            "Ensure resolver never triggers side-effectful initialization",
+            "Move all connection logic behind lazy initialization barrier",
+            "Guarantee drivers do not auto-connect in constructors",
+            "Ensure all public driver methods are safe before initialization",
+            "Unify lifecycle behavior across Redis, MySQL, and Mongo drivers"
+          ],
+          "outputs": [
+            "src/Drivers/AbstractSecurityGuardDriver.php",
+            "src/Drivers/RedisSecurityGuard.php",
+            "src/Drivers/MySQL/MySQLSecurityGuard.php",
+            "src/Drivers/Mongo/MongoSecurityGuard.php"
+          ]
+        },
+        "tests": {
+          "tasks": [
+            "Add lifecycle unit tests for all drivers",
+            "Ensure resolver tests do not require real infrastructure",
+            "Validate resolver is side-effect free",
+            "Ensure initialization occurs only on first real operation",
+            "Add explicit failure semantics for initialization failures"
+          ],
+          "outputs": [
+            "tests/Drivers/Lifecycle/",
+            "tests/Resolver/LifecycleTest.php"
+          ]
+        },
+        "examples": { "tasks": [], "outputs": [] }
+      },
+      "rules": [
+        "Resolver must be side-effect free",
+        "Drivers must be lazy-initialized",
+        "Initialization logic must exist in exactly one place per driver",
+        "Public driver API must be safe before initialization",
+        "No real infrastructure access during resolver tests"
+      ]
+    },
+
+    {
+      "id": "phase7",
       "title": "IntegrationV2 Stabilization",
       "version": "1.0.1",
       "status": "in_progress",
@@ -369,7 +419,7 @@
     },
 
     {
-      "id": "phase6",
+      "id": "phase8",
       "title": "Config Normalization & DTO Injection Layer",
       "version": "1.1.0",
       "status": "pending",
@@ -410,7 +460,7 @@
     },
 
     {
-      "id": "phase7",
+      "id": "phase9",
       "title": "Global Rate Limiter Overlay Enforcement",
       "version": "1.1.1",
       "status": "pending",
@@ -443,7 +493,7 @@
     },
 
     {
-      "id": "phase8",
+      "id": "phase10",
       "title": "Backoff Policy Hardening & banTime Integration",
       "version": "1.1.2",
       "status": "pending",
@@ -476,7 +526,7 @@
     },
 
     {
-      "id": "phase9",
+      "id": "phase11",
       "title": "Phase 5 Coverage Completion & Validation",
       "version": "1.1.3",
       "status": "pending",
@@ -508,7 +558,7 @@
     },
 
     {
-      "id": "phase10",
+      "id": "phase12",
       "title": "Internal API Freeze (No Public Release)",
       "version": "1.2.0",
       "status": "pending",
@@ -544,7 +594,7 @@
     },
 
     {
-      "id": "phase11",
+      "id": "phase13",
       "title": "Rate Limiter Bridge",
       "version": "1.0.0",
       "status": "pending",
@@ -579,7 +629,7 @@
     },
 
     {
-      "id": "phase12",
+      "id": "phase14",
       "title": "Audit DTO & Storage",
       "version": "1.0.0",
       "status": "pending",
@@ -602,7 +652,7 @@
     },
 
     {
-      "id": "phase13",
+      "id": "phase15",
       "title": "Mongo Audit Forwarding",
       "version": "1.0.0",
       "status": "pending",
@@ -624,7 +674,7 @@
     },
 
     {
-      "id": "phase14",
+      "id": "phase16",
       "title": "Audit History API",
       "version": "1.0.0",
       "status": "pending",
@@ -646,7 +696,7 @@
     },
 
     {
-      "id": "phase15",
+      "id": "phase17",
       "title": "Audit Filters & Indexes",
       "version": "1.0.0",
       "status": "pending",
@@ -668,7 +718,7 @@
     },
 
     {
-      "id": "phase16",
+      "id": "phase18",
       "title": "PSR Logger Integration",
       "version": "1.0.0",
       "status": "pending",
@@ -690,7 +740,7 @@
     },
 
     {
-      "id": "phase17",
+      "id": "phase19",
       "title": "Telegram Alerts",
       "version": "1.0.0",
       "status": "pending",
@@ -712,7 +762,7 @@
     },
 
     {
-      "id": "phase18",
+      "id": "phase20",
       "title": "Webhook Dispatcher",
       "version": "1.0.0",
       "status": "pending",
@@ -734,7 +784,7 @@
     },
 
     {
-      "id": "phase19",
+      "id": "phase21",
       "title": "Retry Engine & Delivery Tests",
       "version": "1.0.0",
       "status": "pending",
@@ -759,7 +809,7 @@
     },
 
     {
-      "id": "phase20",
+      "id": "phase22",
       "title": "Monitoring APIs",
       "version": "1.0.0",
       "status": "pending",
@@ -781,7 +831,7 @@
     },
 
     {
-      "id": "phase21",
+      "id": "phase23",
       "title": "Unit Consistency Tests",
       "version": "1.0.0",
       "status": "pending",
@@ -802,7 +852,7 @@
     },
 
     {
-      "id": "phase22",
+      "id": "phase24",
       "title": "Attack Simulations",
       "version": "1.0.0",
       "status": "pending",
@@ -823,7 +873,7 @@
     },
 
     {
-      "id": "phase23",
+      "id": "phase25",
       "title": "Redis & Mongo Stress",
       "version": "1.0.0",
       "status": "pending",
@@ -844,7 +894,7 @@
     },
 
     {
-      "id": "phase24",
+      "id": "phase26",
       "title": "Coverage Hardening",
       "version": "1.0.0",
       "status": "pending",
@@ -865,7 +915,7 @@
     },
 
     {
-      "id": "phase25",
+      "id": "phase27",
       "title": "Documentation & Packagist Release",
       "version": "1.0.0",
       "status": "pending",