# eclipse-score/lifecycle architecture

> Architecture diagram of the GitHub repository eclipse-score/lifecycle, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/eclipse-score/lifecycle
- Repository: https://github.com/eclipse-score/lifecycle

## Overview

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: [`score/launch_manager/src/daemon/src/process_group_manager/process_group_manager.cpp`](https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/process_group_manager/process_group_manager.cpp) (Process Group Manager), [`score/health_monitor/src/cpp/health_monitor.cpp`](https://github.com/eclipse-score/lifecycle/blob/main/score/health_monitor/src/cpp/health_monitor.cpp) (Health Monitoring API), [`score/health_monitor/src/rust/worker.rs`](https://github.com/eclipse-score/lifecycle/blob/main/score/health_monitor/src/rust/worker.rs) (Monitor Worker), [`score/launch_manager/src/daemon/src/alive_monitor/details/daemon/SupervisionManager.cpp`](https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/alive_monitor/details/daemon/SupervisionManager.cpp) (Supervision Manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Application APIs"]
  node_lifecycle_api["Lifecycle API"]
  node_alive_api["Alive API<br/>[alive.cpp]"]
  node_control_api["Control API<br/>[ilm_control.cpp]"]
end

subgraph group_health["Health Supervision"]
  node_health_api["Health Monitoring API<br/>[health_monitor.cpp]"]
  node_heartbeat["Heartbeat Supervision"]
  node_deadline["Deadline Supervision"]
  node_logic["Logical Supervision<br/>[logic_monitor.rs]"]
  node_health_worker["Monitor Worker<br/>[worker.rs]"]
  node_supervisor_client["Supervisor API Client"]
end

subgraph group_daemon["Launch Manager"]
  node_daemon["Launch Manager Daemon<br/>[main.cpp]"]
  node_process_groups["Process Group Manager"]
  node_process_launcher["Process Launcher"]
  node_recovery_client["Recovery Client"]
  node_daemon_log["Daemon Logging<br/>[log.hpp]"]
end

subgraph group_alive["Alive Monitoring"]
  node_alive_monitor["Alive Monitor"]
  node_supervision_manager["Supervision Manager"]
  node_alive_factory["Alive Worker Factory"]
  node_ipc_client["Alive IPC Client<br/>[IpcClient.hpp]"]
  node_ipc_socket["Shared-Memory Socket<br/>[socket.hpp]"]
  node_ringbuffer["Ring Buffer<br/>[ringbuffer.hpp]"]
end

subgraph group_config["Configuration"]
  node_config_loader["Config Loader"]
  node_config_mapping["Lifecycle Config Mapping"]
end

node_application(("Application"))
node_state_manager(("State Manager"))
node_watchdog["External Watchdog"]

node_application -->|"reports running"| node_lifecycle_api
node_application -->|"reports alive"| node_alive_api
node_application -->|"uses supervision"| node_health_api
node_state_manager -->|"requests Run Target"| node_control_api
node_control_api -.->|"requests activation"| node_process_groups
node_config_mapping -.->|"produces config"| node_config_loader
node_config_loader -.->|"provides configuration"| node_process_groups
node_daemon -.->|"runs lifecycle"| node_process_groups
node_process_groups -.->|"launches processes"| node_process_launcher
node_process_groups -->|"starts monitoring"| node_alive_monitor
node_process_groups -->|"initializes watchdog"| node_watchdog
node_process_groups -.->|"uses recovery client"| node_recovery_client
node_health_api -->|"offers"| node_heartbeat
node_health_api -->|"offers"| node_deadline
node_health_api -->|"offers"| node_logic
node_heartbeat -.->|"evaluated by"| node_health_worker
node_deadline -.->|"evaluated by"| node_health_worker
node_logic -.->|"evaluated by"| node_health_worker
node_health_worker -.->|"notifies alive"| node_supervisor_client
node_supervisor_client -.->|"sends notification"| node_alive_api
node_alive_api -->|"reports status"| node_alive_monitor
node_alive_monitor -.->|"evaluates supervision"| node_supervision_manager
node_supervision_manager -->|"constructs workers"| node_alive_factory
node_alive_factory -.->|"creates IPC interfaces"| node_ipc_client
node_ipc_client -->|"connects channel"| node_ipc_socket
node_ipc_socket -->|"uses buffer"| node_ringbuffer
node_supervision_manager -->|"logs events"| node_daemon_log
node_alive_factory -->|"logs events"| node_daemon_log

click node_lifecycle_api "https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/lifecycle_client/src/lifecyclemanager.cpp"
click node_alive_api "https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/alive/src/alive.cpp"
click node_control_api "https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/lm_control/src/details/ilm_control.cpp"
click node_health_api "https://github.com/eclipse-score/lifecycle/blob/main/score/health_monitor/src/cpp/health_monitor.cpp"
click node_heartbeat "https://github.com/eclipse-score/lifecycle/blob/main/score/health_monitor/src/rust/heartbeat/heartbeat_monitor.rs"
click node_deadline "https://github.com/eclipse-score/lifecycle/blob/main/score/health_monitor/src/rust/deadline/deadline_monitor.rs"
click node_logic "https://github.com/eclipse-score/lifecycle/blob/main/score/health_monitor/src/rust/logic/logic_monitor.rs"
click node_health_worker "https://github.com/eclipse-score/lifecycle/blob/main/score/health_monitor/src/rust/worker.rs"
click node_supervisor_client "https://github.com/eclipse-score/lifecycle/blob/main/score/health_monitor/src/rust/supervisor_api_client/score_supervisor_api_client.rs"
click node_daemon "https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/main.cpp"
click node_process_groups "https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/process_group_manager/process_group_manager.cpp"
click node_config_loader "https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/configuration/details/flatbuffer_config_loader.cpp"
click node_config_mapping "https://github.com/eclipse-score/lifecycle/blob/main/scripts/config_mapping/lifecycle_config.py"
click node_process_launcher "https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/process_group_manager/details/process_launcher.cpp"
click node_recovery_client "https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/recovery_client/recovery_client.cpp"
click node_alive_monitor "https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/alive_monitor/details/daemon/AliveMonitorImpl.cpp"
click node_supervision_manager "https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/alive_monitor/details/daemon/SupervisionManager.cpp"
click node_alive_factory "https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/alive_monitor/details/factory/AliveWorkerFactory.cpp"
click node_ipc_client "https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/alive_monitor/details/ipc/IpcClient.hpp"
click node_ipc_socket "https://github.com/eclipse-score/lifecycle/blob/main/externals/ipc_dropin/include/ipc_dropin/socket.hpp"
click node_ringbuffer "https://github.com/eclipse-score/lifecycle/blob/main/externals/ipc_dropin/include/ipc_dropin/ringbuffer.hpp"
click node_daemon_log "https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/common/log.hpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_lifecycle_api,node_alive_api,node_control_api toneBlue
class node_health_api,node_heartbeat,node_deadline,node_logic,node_health_worker,node_supervisor_client toneAmber
class node_daemon,node_process_groups,node_process_launcher,node_recovery_client,node_daemon_log toneMint
class node_alive_monitor,node_supervision_manager,node_alive_factory,node_ipc_client,node_ipc_socket,node_ringbuffer toneRose
class node_config_loader,node_config_mapping,node_application,node_state_manager,node_watchdog toneIndigo
```

## Components

### Application APIs

- [Lifecycle API](https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/lifecycle_client/src/lifecyclemanager.cpp): `score/launch_manager/src/lifecycle_client/src/lifecyclemanager.cpp`
- [Alive API](https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/alive/src/alive.cpp): `score/launch_manager/src/alive/src/alive.cpp`
- [Control API](https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/lm_control/src/details/ilm_control.cpp): `score/launch_manager/src/lm_control/src/details/ilm_control.cpp`

### Health Supervision

- [Health Monitoring API](https://github.com/eclipse-score/lifecycle/blob/main/score/health_monitor/src/cpp/health_monitor.cpp): `score/health_monitor/src/cpp/health_monitor.cpp`
- [Heartbeat Supervision](https://github.com/eclipse-score/lifecycle/blob/main/score/health_monitor/src/rust/heartbeat/heartbeat_monitor.rs): `score/health_monitor/src/rust/heartbeat/heartbeat_monitor.rs`
- [Deadline Supervision](https://github.com/eclipse-score/lifecycle/blob/main/score/health_monitor/src/rust/deadline/deadline_monitor.rs): `score/health_monitor/src/rust/deadline/deadline_monitor.rs`
- [Logical Supervision](https://github.com/eclipse-score/lifecycle/blob/main/score/health_monitor/src/rust/logic/logic_monitor.rs): `score/health_monitor/src/rust/logic/logic_monitor.rs`
- [Monitor Worker](https://github.com/eclipse-score/lifecycle/blob/main/score/health_monitor/src/rust/worker.rs): `score/health_monitor/src/rust/worker.rs`
- [Supervisor API Client](https://github.com/eclipse-score/lifecycle/blob/main/score/health_monitor/src/rust/supervisor_api_client/score_supervisor_api_client.rs): `score/health_monitor/src/rust/supervisor_api_client/score_supervisor_api_client.rs`

### Launch Manager

- [Launch Manager Daemon](https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/main.cpp): `score/launch_manager/src/daemon/src/main.cpp`
- [Process Group Manager](https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/process_group_manager/process_group_manager.cpp): `score/launch_manager/src/daemon/src/process_group_manager/process_group_manager.cpp`
- [Process Launcher](https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/process_group_manager/details/process_launcher.cpp): `score/launch_manager/src/daemon/src/process_group_manager/details/process_launcher.cpp`
- [Recovery Client](https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/recovery_client/recovery_client.cpp): `score/launch_manager/src/daemon/src/recovery_client/recovery_client.cpp`
- [Daemon Logging](https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/common/log.hpp): `score/launch_manager/src/daemon/src/common/log.hpp`

### Alive Monitoring

- [Alive Monitor](https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/alive_monitor/details/daemon/AliveMonitorImpl.cpp): `score/launch_manager/src/daemon/src/alive_monitor/details/daemon/AliveMonitorImpl.cpp`
- [Supervision Manager](https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/alive_monitor/details/daemon/SupervisionManager.cpp): `score/launch_manager/src/daemon/src/alive_monitor/details/daemon/SupervisionManager.cpp`
- [Alive Worker Factory](https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/alive_monitor/details/factory/AliveWorkerFactory.cpp): `score/launch_manager/src/daemon/src/alive_monitor/details/factory/AliveWorkerFactory.cpp`
- [Alive IPC Client](https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/alive_monitor/details/ipc/IpcClient.hpp): `score/launch_manager/src/daemon/src/alive_monitor/details/ipc/IpcClient.hpp`
- [Shared-Memory Socket](https://github.com/eclipse-score/lifecycle/blob/main/externals/ipc_dropin/include/ipc_dropin/socket.hpp): `externals/ipc_dropin/include/ipc_dropin/socket.hpp`
- [Ring Buffer](https://github.com/eclipse-score/lifecycle/blob/main/externals/ipc_dropin/include/ipc_dropin/ringbuffer.hpp): `externals/ipc_dropin/include/ipc_dropin/ringbuffer.hpp`

### Configuration

- [Config Loader](https://github.com/eclipse-score/lifecycle/blob/main/score/launch_manager/src/daemon/src/configuration/details/flatbuffer_config_loader.cpp): `score/launch_manager/src/daemon/src/configuration/details/flatbuffer_config_loader.cpp`
- [Lifecycle Config Mapping](https://github.com/eclipse-score/lifecycle/blob/main/scripts/config_mapping/lifecycle_config.py): `scripts/config_mapping/lifecycle_config.py`

### Other components

- **Application**
- **State Manager**
- **External Watchdog**

## Connections

- Application → Lifecycle API: reports running (evidence: `README.md`)
- Application → Alive API: reports alive (evidence: `README.md`)
- Application → Health Monitoring API: uses supervision (evidence: `README.md`)
- State Manager → Control API: requests Run Target (evidence: `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 (evidence: `score/launch_manager/src/daemon/src/process_group_manager/process_group_manager.cpp`)
- Process Group Manager → External Watchdog: initializes watchdog (evidence: `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 (evidence: `README.md`)
- Health Monitoring API → Deadline Supervision: offers (evidence: `README.md`)
- Health Monitoring API → Logical Supervision: offers (evidence: `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 (evidence: `README.md`)
- Alive Monitor → Supervision Manager: evaluates supervision
- Supervision Manager → Alive Worker Factory: constructs workers (evidence: `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 (evidence: `score/launch_manager/src/daemon/src/alive_monitor/details/ipc/IpcClient.hpp`)
- Shared-Memory Socket → Ring Buffer: uses buffer (evidence: `externals/ipc_dropin/include/ipc_dropin/socket.hpp`)
- Supervision Manager → Daemon Logging: logs events (evidence: `score/launch_manager/src/daemon/src/alive_monitor/details/daemon/SupervisionManager.cpp`)
- Alive Worker Factory → Daemon Logging: logs events (evidence: `score/launch_manager/src/daemon/src/alive_monitor/details/factory/AliveWorkerFactory.cpp`)
