Add client-side database sync infrastructure (#418)

Add openlifu.cloud module for bidirectional sync between local OpenLIFU
databases and the cloud API (api.openwater.health). Introduces a REST
API client layer with typed DTOs for all entity types (subjects,
sessions, protocols, systems, transducers, volumes, runs, solutions,
users, photoscans). Sync engine uses a component tree
(AbstractComponent) with per-entity-type subclasses, a debounced worker
thread (SyncThread), filesystem watching via watchdog, and
WebSocket-based push notifications for real-time cloud-to-local
updates. Volumes and photoscans are download-only (pulled from cloud
then deleted server-side); all other entities sync bidirectionally.
Adds watchdog and python-socketio[client] dependencies.

Squashed commit of the following:

commit c11402d
Author: Pavel Osnova <pvosnova@gmail.com>
Date:   Mon Feb 23 10:43:55 2026 +0200

    fix: endless sync loop

commit 3894d67
Author: dev-et <dev-et>
Date:   Fri Feb 20 18:15:26 2026 -0800

    Set daemon to false

commit 565ef1c
Author: Pavel Osnova <pvosnova@gmail.com>
Date:   Fri Feb 20 18:12:35 2026 +0200

    fix: don't delete photoscans on cloud

commit 871188e
Author: Pavel Osnova <pvosnova@gmail.com>
Date:   Fri Feb 20 13:10:32 2026 +0200

    fix: download only finished photoscans

commit 7f490c2
Author: Pavel Osnova <pvosnova@gmail.com>
Date:   Fri Feb 20 12:51:23 2026 +0200

    fix: don't sync photocollections and don't upload volumes to cloud

commit 54cb278
Author: dev-et <dev-et>
Date:   Thu Feb 19 21:59:55 2026 -0800

    Disable daemon for sync thread

commit 6e91aa4
Author: Pavel Osnova <pvosnova@gmail.com>
Date:   Thu Feb 19 15:36:55 2026 +0200

    fix: getting MAC address on Windows

commit f3c104e
Author: Pavel Osnova <pvosnova@gmail.com>
Date:   Thu Feb 19 10:27:20 2026 +0200

    fix: disable photocollections sync

commit 63c2900
Author: dev-et <dev-et>
Date:   Wed Feb 18 10:08:06 2026 -0800

    Add temporary hardcoded mac address

commit 2b07ec9
Author: Pavel Osnova <pvosnova@gmail.com>
Date:   Wed Feb 18 13:57:25 2026 +0200

    fix: resolve lint errors

commit 9d41092
Author: Pavel Osnova <pvosnova@gmail.com>
Date:   Wed Feb 18 13:17:29 2026 +0200

    fix: resolve lint errors

commit 1edb8a5
Author: dev-et <dev-et>
Date:   Mon Feb 16 21:03:25 2026 -0800

    Add exception handling for errorous files

commit 7d4e84b
Author: dev-et <dev-et>
Date:   Mon Feb 16 01:37:06 2026 -0800

    Bug fixes, add additional logging, fix deadlock in sync_thread

commit d8f2894
Author: Pavel Osnova <pvosnova@gmail.com>
Date:   Fri Feb 13 15:19:33 2026 +0200

    One way sync for volumes, photocollections and photoscans and delete them on cloud after sync.

commit 174ba08
Author: Pavel Osnova <pvosnova@gmail.com>
Date:   Fri Feb 13 12:07:48 2026 +0200

    Fixes photocollection sync when photo added locally

commit 366ef47
Author: Pavel Osnova <pvosnova@gmail.com>
Date:   Fri Feb 13 11:50:10 2026 +0200

    Don't block the main thread when stopping the cloud

commit a28c622
Author: Pavel Osnova <pvosnova@gmail.com>
Date:   Thu Feb 12 13:34:54 2026 +0200

    Fixes sync error

commit 20da259
Author: dev-et <dev-et>
Date:   Mon Feb 9 13:09:39 2026 -0800

    Fix NameError: name 'AbstractComponent' is not defined exception

commit 08731b8
Author: Pavel Osnova <pvosnova@gmail.com>
Date:   Fri Feb 6 16:51:15 2026 +0200

    Don't delete database owner automatically when sync library stops

commit 20d7a48
Author: Pavel Osnova <pvosnova@gmail.com>
Date:   Fri Feb 6 15:10:06 2026 +0200

    Photoscans sync

commit 253dc32
Author: Pavel Osnova <pvosnova@gmail.com>
Date:   Fri Feb 6 12:47:46 2026 +0200

    Synchronization fixes

commit d84c2d0
Author: Pavel Osnova <pvosnova@gmail.com>
Date:   Thu Feb 5 18:25:17 2026 +0200

    Synchronization of sessions, volumes, photocollections, runs and solutions

commit 75103b3
Author: Pavel Osnova <pvosnova@gmail.com>
Date:   Mon Feb 2 11:17:32 2026 +0200

    update API URL

commit 8c01179
Author: Pavel Osnova <pvosnova@gmail.com>
Date:   Fri Jan 30 12:21:45 2026 +0200

    initial cloud library

Author: arhowe00

pyproject.toml

@@ -51,6 +51,8 @@ dependencies = [
   "embreex; platform_machine=='x86_64' or platform_machine=='AMD64'",
   "onnxruntime==1.18.0",
   "pydicom",
+  "watchdog",
+  "python-socketio[client]"
 ]
 
 [project.optional-dependencies]

src/openlifu/cloud/__init__.py

@@ -0,0 +1,74 @@
+from __future__ import annotations
+
+from openlifu.cloud.api.databases_api import DatabasesApi
+from openlifu.cloud.api.photoscans_api import PhotoscansApi
+from openlifu.cloud.api.protocols_api import ProtocolsApi
+from openlifu.cloud.api.request import Request
+from openlifu.cloud.api.runs_api import RunsApi
+from openlifu.cloud.api.sessions_api import SessionsApi
+from openlifu.cloud.api.solutions_api import SolutionsApi
+from openlifu.cloud.api.subjects_api import SubjectsApi
+from openlifu.cloud.api.systems_api import SystemsApi
+from openlifu.cloud.api.transducers_api import TransducersApi
+from openlifu.cloud.api.users_api import UsersApi
+from openlifu.cloud.api.volumes_api import VolumesApi
+
+
+class Api:
+
+    def __init__(self):
+        self._request = Request()
+        self._request.debug_log = True
+        self._databases = DatabasesApi(self._request)
+        self._protocols = ProtocolsApi(self._request)
+        self._users = UsersApi(self._request)
+        self._systems = SystemsApi(self._request)
+        self._transducers = TransducersApi(self._request)
+        self._subjects = SubjectsApi(self._request)
+        self._volumes = VolumesApi(self._request)
+        self._sessions = SessionsApi(self._request)
+        self._runs = RunsApi(self._request)
+        self._solutions = SolutionsApi(self._request)
+        self._photoscans = PhotoscansApi(self._request)
+
+    def authenticate(self, token: str):
+        self._request.headers = {
+            "Authorization": f"Bearer {token}",
+            "Content-Type": "application/json"
+        }
+
+    def logout(self):
+        self._request.headers = {}
+
+    def databases(self) -> DatabasesApi:
+        return self._databases
+
+    def protocols(self) -> ProtocolsApi:
+        return self._protocols
+
+    def users(self) -> UsersApi:
+        return self._users
+
+    def systems(self) -> SystemsApi:
+        return self._systems
+
+    def transducers(self) -> TransducersApi:
+        return self._transducers
+
+    def subjects(self) -> SubjectsApi:
+        return self._subjects
+
+    def volumes(self) -> VolumesApi:
+        return self._volumes
+
+    def sessions(self) -> SessionsApi:
+        return self._sessions
+
+    def runs(self) -> RunsApi:
+        return self._runs
+
+    def solutions(self) -> SolutionsApi:
+        return self._solutions
+
+    def photoscans(self) -> PhotoscansApi:
+        return self._photoscans

src/openlifu/cloud/api/__init__.py

@@ -0,0 +1,25 @@
+from __future__ import annotations
+
+from openlifu.cloud.api.dto import ClaimDbDto, DatabaseDto, DatabaseSyncRequestDto
+from openlifu.cloud.api.request import Request
+from openlifu.cloud.utils import from_json
+
+
+class DatabasesApi:
+
+    def __init__(self, request: Request):
+        self._request = request
+
+    def claim_database(self, dto: ClaimDbDto) -> DatabaseDto:
+        response = self._request.put("/databases/claim", dto)
+        return from_json(DatabaseDto, response)
+
+    def release_database(self, database_id: int):
+        self._request.delete(f"/databases/{database_id}/owner")
+
+    def get_database(self, database_id: int) -> DatabaseDto:
+        response = self._request.get(f"/databases/{database_id}")
+        return from_json(DatabaseDto, response)
+
+    def update_database_sync_date(self, database_id: int, dto: DatabaseSyncRequestDto):
+        self._request.put(f"/databases/{database_id}/sync", dto)