How eclipse-score/lifecycle works
Lifecycle & Health is S-CORE’s process lifecycle and supervision feature. Applications report readiness through the Lifecycle API, while a State Manager requests Run Targets through the Control API; the Launch Manager resolves component dependencies, starts/stops processes, handles failures, and can coordinate watchdogs. Applications can also report alive status directly or use Heartbeat, Deadline, and Logical supervision, whose results feed Launch Manager supervision. The graph includes documented but unsampled capabilities; those links are marked unverified where source evidence was not provided.
Main entry points: process_group_manager.cpp Process Group Manager · health_monitor.cpp Health Monitoring API · worker.rs Monitor Worker · SupervisionManager.cpp Supervision Manager
Components 25
Application APIs
- Lifecycle API
score/launch_manager/src/lifecycle_client/src/lifecyclemanager.cpp - Alive API
score/launch_manager/src/alive/src/alive.cpp - Control API
score/launch_manager/src/lm_control/src/details/ilm_control.cpp
Health Supervision
- Health Monitoring API
score/health_monitor/src/cpp/health_monitor.cpp - Heartbeat Supervision
score/health_monitor/src/rust/heartbeat/heartbeat_monitor.rs - Deadline Supervision
score/health_monitor/src/rust/deadline/deadline_monitor.rs - Logical Supervision
score/health_monitor/src/rust/logic/logic_monitor.rs - Monitor Worker
score/health_monitor/src/rust/worker.rs - Supervisor API Client
score/health_monitor/src/rust/supervisor_api_client/score_supervisor_api_client.rs
Launch Manager
- Launch Manager Daemon
score/launch_manager/src/daemon/src/main.cpp - Process Group Manager
score/launch_manager/src/daemon/src/process_group_manager/process_group_manager.cpp - Process Launcher
score/launch_manager/src/daemon/src/process_group_manager/details/process_launcher.cpp - Recovery Client
score/launch_manager/src/daemon/src/recovery_client/recovery_client.cpp - Daemon Logging
score/launch_manager/src/daemon/src/common/log.hpp
Alive Monitoring
- Alive Monitor
score/launch_manager/src/daemon/src/alive_monitor/details/daemon/AliveMonitorImpl.cpp - Supervision Manager
score/launch_manager/src/daemon/src/alive_monitor/details/daemon/SupervisionManager.cpp - Alive Worker Factory
score/launch_manager/src/daemon/src/alive_monitor/details/factory/AliveWorkerFactory.cpp - Alive IPC Client
score/launch_manager/src/daemon/src/alive_monitor/details/ipc/IpcClient.hpp - Shared-Memory Socket
externals/ipc_dropin/include/ipc_dropin/socket.hpp - Ring Buffer
externals/ipc_dropin/include/ipc_dropin/ringbuffer.hpp
Configuration
- Config Loader
score/launch_manager/src/daemon/src/configuration/details/flatbuffer_config_loader.cpp - Lifecycle Config Mapping
scripts/config_mapping/lifecycle_config.py
Other components
- Application
- State Manager
- External Watchdog
Connections 28
- Application → Lifecycle API: reports running
README.md - Application → Alive API: reports alive
README.md - Application → Health Monitoring API: uses supervision
README.md - State Manager → Control API: requests Run Target
README.md - Control API → Process Group Manager: requests activation
- Lifecycle Config Mapping → Config Loader: produces config
- Config Loader → Process Group Manager: provides configuration
- Launch Manager Daemon → Process Group Manager: runs lifecycle
- Process Group Manager → Process Launcher: launches processes
- Process Group Manager → Alive Monitor: starts monitoring
score/launch_manager/src/daemon/src/process_group_manager/process_group_manager.cpp - Process Group Manager → External Watchdog: initializes watchdog
score/launch_manager/src/daemon/src/process_group_manager/process_group_manager.cpp - Process Group Manager → Recovery Client: uses recovery client
- Health Monitoring API → Heartbeat Supervision: offers
README.md - Health Monitoring API → Deadline Supervision: offers
README.md - Health Monitoring API → Logical Supervision: offers
README.md - Heartbeat Supervision → Monitor Worker: evaluated by
- Deadline Supervision → Monitor Worker: evaluated by
- Logical Supervision → Monitor Worker: evaluated by
- Monitor Worker → Supervisor API Client: notifies alive
- Supervisor API Client → Alive API: sends notification
- Alive API → Alive Monitor: reports status
README.md - Alive Monitor → Supervision Manager: evaluates supervision
- Supervision Manager → Alive Worker Factory: constructs workers
score/launch_manager/src/daemon/src/alive_monitor/details/daemon/SupervisionManager.cpp - Alive Worker Factory → Alive IPC Client: creates IPC interfaces
- Alive IPC Client → Shared-Memory Socket: connects channel
score/launch_manager/src/daemon/src/alive_monitor/details/ipc/IpcClient.hpp - Shared-Memory Socket → Ring Buffer: uses buffer
externals/ipc_dropin/include/ipc_dropin/socket.hpp - Supervision Manager → Daemon Logging: logs events
score/launch_manager/src/daemon/src/alive_monitor/details/daemon/SupervisionManager.cpp - Alive Worker Factory → Daemon Logging: logs events
score/launch_manager/src/daemon/src/alive_monitor/details/factory/AliveWorkerFactory.cpp