SIENTIAPDE-1646

Update requirements and enhance OPC communication handling

- Updated `requirements-local.txt` to use the latest versions of `sientia-dataops-library` (1.12.1) and `sientia-model-library` (0.10.0).
- Improved documentation in `opc-communication.md` to clarify the transition from async to sync implementation and added details on error classification and reconnection behavior.
- Refactored `init_opc` method in `opc.py` to enhance connection handling and logging, ensuring independent server initialization.
- Enhanced validation and writing methods in `opc.py` to provide better feedback and error handling for OPC server operations.
- Updated `opc_repository.py` to improve error payload construction and session management metrics.

laborious/utils/repository/opc_repository.py

@@ -4,7 +4,7 @@ Synchronous OPC UA client repository using asyncua ``sync`` API.
 ``asyncua.sync.Client`` runs the asyncio stack on a background thread so Temporal
 activities and other callers stay blocking while preserving the same session
 lifecycle, security policy, reconnect semantics, and write error classification
-as the async ``origin/main`` implementation.
+as the async ``main`` implementation at ``fcc8920a8be4`` (async → sync/thread conversion).
 """
 
 import json
@@ -169,7 +169,7 @@ class OpcRepository(SientiaMonitoring):
     Synchronous OPC UA repository for connect/disconnect and typed writes.
 
     Uses ``asyncua.sync.Client`` with the same session metrics, Tier-1 Bad* reconnect,
-    and structured write error payloads as the async repository on ``origin/main``.
+    and structured write error payloads as the async repository on ``main``.
     """
 
     def __init__(
@@ -194,10 +194,10 @@ class OpcRepository(SientiaMonitoring):
         self.private_key_path = private_key_path
         self.server_cert_path = server_cert_path
         self.reconnection_interval = reconnection_interval
-        self.last_reconnection_time: datetime | None = None
+        self.last_reconnection_time: None | datetime = None
         self.disconnection_interval = 10.0
         self.notification_handler = notification_handler
-        self.client: Client | None = None
+        self.client: None | Client = None
 
         SientiaMonitoring.__init__(self, logger, notification_handler, metrics_controller)
 
@@ -214,6 +214,15 @@ class OpcRepository(SientiaMonitoring):
         self._allow_reconnect = True
 
     def _opc_debug_tags(self, session_id: str) -> dict[str, str]:
+        """
+        Build Prometheus/log label tags for OPC session-scoped metrics.
+
+        Args:
+            session_id (str): OPC UA session token string.
+
+        Return:
+            dict[str, str]: Labels pod_id, server_name, runtime, opc_server_id, session_id.
+        """
         return {
             'pod_id': str(getattr(self, 'pod_id', 'unknown')),
             'server_name': self.server_name,
@@ -251,6 +260,12 @@ class OpcRepository(SientiaMonitoring):
         ).total_seconds() > self.reconnection_interval
 
     def _not_connected_error(self) -> dict[str, Any]:
+        """
+        Build the standard error payload when validate_connection finds no open protocol.
+
+        Return:
+            dict[str, Any]: Notification fields for OPC_CONNECTION_NOT_READY.
+        """
         return {
             'notification_id': f'OPC_CONNECTION_NOT_READY_{self.id}',
             'message': f'OPC server {self.id} is not connected',