hmon: add logic monitor by arkjedrz · Pull Request #95 · eclipse-score/lifecycle

arkjedrz · 2026-02-27T11:50:54Z

Add logic monitor to HMON.

Resolved #15

github-actions · 2026-02-27T11:51:38Z

License Check Results

🚀 The license check job ran with the Bazel command:

bazel run --lockfile_mode=error //:license-check

Status: ⚠️ Needs Review

Click to expand output

[License Check Output]
Extracting Bazel installation...
Starting local Bazel server (8.4.2) and connecting to it...
INFO: Invocation ID: 3de1ce5a-d144-40bb-b6a3-4565bfbeb42a
Computing main repo mapping: 
Computing main repo mapping: 
Computing main repo mapping: 
WARNING: For repository 'score_rust_policies', the root module requires module version score_rust_policies@0.0.3, but got score_rust_policies@0.0.5 in the resolved dependency graph. Please update the version in your MODULE.bazel or set --check_direct_dependencies=off
Loading: 
Loading: 0 packages loaded
Loading: 0 packages loaded
Loading: 0 packages loaded
    currently loading: 
Loading: 0 packages loaded
    currently loading: 
Loading: 0 packages loaded
    currently loading: 
Loading: 0 packages loaded
    currently loading: 
Analyzing: target //:license-check (1 packages loaded, 0 targets configured)
Analyzing: target //:license-check (1 packages loaded, 0 targets configured)

Analyzing: target //:license-check (37 packages loaded, 9 targets configured)

Analyzing: target //:license-check (89 packages loaded, 9 targets configured)

Analyzing: target //:license-check (89 packages loaded, 9 targets configured)

Analyzing: target //:license-check (145 packages loaded, 2642 targets configured)

Analyzing: target //:license-check (153 packages loaded, 5247 targets configured)

Analyzing: target //:license-check (154 packages loaded, 5922 targets configured)

Analyzing: target //:license-check (160 packages loaded, 7852 targets configured)

Analyzing: target //:license-check (160 packages loaded, 7852 targets configured)

Analyzing: target //:license-check (160 packages loaded, 7852 targets configured)

Analyzing: target //:license-check (163 packages loaded, 9737 targets configured)

Analyzing: target //:license-check (163 packages loaded, 9737 targets configured)

Analyzing: target //:license-check (164 packages loaded, 9861 targets configured)

Analyzing: target //:license-check (169 packages loaded, 9913 targets configured)

INFO: Analyzed target //:license-check (170 packages loaded, 10039 targets configured).
[12 / 16] [Sched] JavaToolchainCompileClasses external/rules_java+/toolchains/platformclasspath_classes
[14 / 16] JavaToolchainCompileBootClasspath external/rules_java+/toolchains/platformclasspath.jar; 0s disk-cache, processwrapper-sandbox
[15 / 16] Building license.check.license_check.jar (); 0s disk-cache, multiplex-worker
INFO: Found 1 target...
Target //:license.check.license_check up-to-date:
  bazel-bin/license.check.license_check
  bazel-bin/license.check.license_check.jar
INFO: Elapsed time: 30.365s, Critical Path: 2.64s
INFO: 16 processes: 12 internal, 3 processwrapper-sandbox, 1 worker.
INFO: Build completed successfully, 16 total actions
INFO: Running command line: bazel-bin/license.check.license_check ./formatted.txt <args omitted>
usage: org.eclipse.dash.licenses.cli.Main [-batch <int>] [-cd <url>]
       [-confidence <int>] [-ef <url>] [-excludeSources <sources>] [-help] [-lic
       <url>] [-project <shortname>] [-repo <url>] [-review] [-summary <file>]
       [-timeout <seconds>] [-token <token>]

Copilot

Pull request overview

This PR extends the health monitoring library with new monitor types (heartbeat + logic) and refactors the worker/supervisor client plumbing so the worker can evaluate multiple monitor kinds and report typed evaluation errors across Rust + C++/FFI.

Changes:

Add new HeartbeatMonitor (state + evaluator + FFI + C++ wrapper) and LogicMonitor (state-transition validator).
Refactor monitor evaluation to pass an HMON starting Instant and to report typed MonitorEvaluationError variants (deadline/heartbeat/logic).
Move supervisor API client implementations into a feature-gated supervisor_api_client/ module and adjust build config defaults/features.

Reviewed changes

Copilot reviewed 25 out of 26 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
src/health_monitoring_lib/rust/worker.rs	Updates monitoring loop to pass a shared starting `Instant` and log typed monitor errors; removes in-file supervisor client impls.
src/health_monitoring_lib/rust/tag.rs	Adds `StateTag` newtype for logic monitor states; updates tag tests.
src/health_monitoring_lib/rust/supervisor_api_client/stub_supervisor_api_client.rs	Adds stub supervisor client implementation behind feature gate.
src/health_monitoring_lib/rust/supervisor_api_client/score_supervisor_api_client.rs	Adds SCORE supervisor client implementation (monitor_rs-backed).
src/health_monitoring_lib/rust/supervisor_api_client/mod.rs	Introduces `SupervisorAPIClient` trait and feature-gated implementations.
src/health_monitoring_lib/rust/logic/mod.rs	Adds logic module exports.
src/health_monitoring_lib/rust/logic/logic_monitor.rs	Implements logic monitor state machine + evaluator + tests.
src/health_monitoring_lib/rust/lib.rs	Integrates deadline/heartbeat/logic monitors into `HealthMonitorBuilder` + `HealthMonitor`; changes build/start to return `Result`.
src/health_monitoring_lib/rust/heartbeat/mod.rs	Adds heartbeat module wiring and FFI submodule.
src/health_monitoring_lib/rust/heartbeat/heartbeat_state.rs	Adds compact atomic heartbeat state representation (+ loom-aware atomics).
src/health_monitoring_lib/rust/heartbeat/heartbeat_monitor.rs	Adds heartbeat monitor implementation + builder validation + tests.
src/health_monitoring_lib/rust/heartbeat/ffi.rs	Adds FFI for heartbeat monitor builder/monitor and tests.
src/health_monitoring_lib/rust/ffi.rs	Extends core FFI to build/start using `Result`, adds heartbeat builder/get FFI, and maps `HealthMonitorError` to `FFICode`.
src/health_monitoring_lib/rust/deadline/mod.rs	Re-exports `DeadlineEvaluationError` for typed evaluation errors.
src/health_monitoring_lib/rust/deadline/deadline_monitor.rs	Refactors deadline monitor to use typed `DeadlineEvaluationError` and updated evaluator signature.
src/health_monitoring_lib/rust/common.rs	Introduces `HasEvalHandle`, typed `MonitorEvaluationError`, shared evaluation signature, and time conversion helpers.
src/health_monitoring_lib/cpp/tests/health_monitor_test.cpp	Extends C++ test to build/get/use heartbeat monitor.
src/health_monitoring_lib/cpp/include/score/hm/heartbeat/heartbeat_monitor.h	Adds C++ API surface for heartbeat monitor + builder.
src/health_monitoring_lib/cpp/include/score/hm/health_monitor.h	Adds heartbeat monitor APIs to C++ `HealthMonitor(Builder)`.
src/health_monitoring_lib/cpp/heartbeat_monitor.cpp	Implements C++ heartbeat monitor wrapper calling Rust FFI.
src/health_monitoring_lib/cpp/health_monitor.cpp	Wires heartbeat builder/get calls through Rust FFI.
src/health_monitoring_lib/Cargo.toml	Adds features (default stub; optional score uses monitor_rs) and loom dependency config.
src/health_monitoring_lib/BUILD	Adds heartbeat C++ sources/headers and adjusts crate feature flags for Bazel targets.
examples/rust_supervised_app/src/main.rs	Updates example to handle `build()`/`start()` returning `Result`.
Cargo.toml	Sets workspace `default-members` and adds `cfg(loom)` lint configuration.
Cargo.lock	Adds new dependency entries (loom + transitive deps).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

src/health_monitoring_lib/rust/heartbeat/heartbeat_monitor.rs

Copilot · 2026-02-27T11:56:02Z

src/health_monitoring_lib/rust/logic/logic_monitor.rs

+        match value {
+            value if value == LogicEvaluationError::InvalidState as u8 => LogicEvaluationError::InvalidState,
+            value if value == LogicEvaluationError::InvalidTransition as u8 => LogicEvaluationError::InvalidTransition,
+            _ => panic!("Invalid underlying value of logic evaluation error."),


impl From<u8> for LogicEvaluationError panics on unknown values. Since this conversion is used when interpreting AtomicU8 state during evaluate, an unexpected value would crash the monitoring thread/process instead of reporting an error. Please make this conversion non-panicking (e.g., map unknown values to InvalidState or return Option/Result) and handle that path in evaluate.

Suggested change

_ => panic!("Invalid underlying value of logic evaluation error."),

_ => LogicEvaluationError::InvalidState,

src/health_monitoring_lib/rust/supervisor_api_client/score_supervisor_api_client.rs

src/health_monitoring_lib/rust/lib.rs

src/health_monitoring_lib/rust/heartbeat/heartbeat_state.rs

github-actions · 2026-02-27T11:58:49Z

The created documentation from the pull request is available at: docu-html

Copilot

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated 4 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.

src/health_monitoring_lib/rust/logic/logic_monitor.rs

src/health_monitoring_lib/rust/tag.rs

src/health_monitoring_lib/rust/logic/logic_monitor.rs

pawelrutkaq

Stopped as my comment will probably simplify more code

src/health_monitoring_lib/rust/logic/logic_monitor.rs

src/health_monitoring_lib/rust/tag.rs

src/health_monitoring_lib/rust/logic/logic_monitor.rs

paulquiring · 2026-03-06T09:31:09Z

src/health_monitoring_lib/cpp/include/score/hm/deadline/deadline_monitor.h


  protected:
-    std::optional<internal::FFIHandle> __drop_by_rust_impl()
+    std::optional<internal::FFIHandle> _drop_by_rust_impl()


_drop_by_rust_impl -> drop_by_rust_impl

Compilers like GCC, Clang, and MSVC often use leading underscores for internal macros or system-level functions. If a future update to your compiler introduces a macro or an internal header named _drop_by_rust_impl, your code will fail to compile—or worse, behave unpredictably—and it will be considered your fault, not the compiler’s, because you used a reserved naming pattern.

__ and _ is just considered not a good style. They are reserved.

That one's fine. It was previously double underscore, and that's actually an issue.
https://devblogs.microsoft.com/oldnewthing/20230109-00/?p=107685

Yes one underscore flowed by a lower letter is not and issue. One underscore followed by a capital letter is also reserved. From the link you shared:

It is best practice to use the namespace detail or internal to indicate to user to not use it directly.

paulquiring · 2026-03-06T09:59:40Z

The rust part looks like it supports monitoring from multiple threads. I could not find any hint how to set this up correctly form the cpp side.

src/health_monitoring_lib/rust/logic/logic_state.rs

src/health_monitoring_lib/rust/logic/logic_monitor.rs

pawelrutkaq · 2026-03-06T16:16:51Z

src/health_monitoring_lib/rust/logic/logic_monitor.rs

+                current_state_node.tag, target_state
+            );
+            let error = LogicEvaluationError::InvalidTransition;
+            let _ = self.logic_state.update(|mut current_state| {


since the handle is only reading the values, you can simply use store or swap, no need to use update

Please recheck.

src/health_monitoring_lib/rust/logic/logic_monitor.rs

pawelrutkaq · 2026-03-06T16:17:54Z

src/health_monitoring_lib/rust/logic/logic_monitor.rs

+
+        // Find index of target state, then change current state.
+        let target_state_index = self.find_index_by_tag(target_state)?;
+        let _ = self.logic_state.update(|mut current_state| {


no update needed as above

src/health_monitoring_lib/rust/logic/logic_monitor.rs

pawelrutkaq · 2026-03-12T11:26:08Z

@paulquiring any more comments or fine for You ?

Add logic monitor to HMON.

- Add const constructor to `StateTag`. - Atomic `LogicState` containing current state index and monitor status. - Updated logic monitor API. - Reworked internal of logic monitor.

- Move `loom` imports to `common`. - Remove `Sync` from `LogicMonitor`. - `PhantomUnsync` added to `common`. - `LogicEvaluationError` -> replace `From` with `TryFrom`. - Replace `monitor_status` and `set_monitor_status` type. - From `u8` to `LogicEvaluationError`. - Replace `update` with `swap` in `LogicState`.

pawelrutkaq · 2026-03-13T07:37:03Z

@paulquiring if some issues are still there that you forsee please leave comments and we will adress them in follow up PR. Thanks

arkjedrz requested review from Copilot and pawelrutkaq February 27, 2026 11:50

arkjedrz self-assigned this Feb 27, 2026

arkjedrz had a problem deploying to workflow-approval February 27, 2026 11:50 — with GitHub Actions Failure

arkjedrz had a problem deploying to workflow-approval February 27, 2026 11:50 — with GitHub Actions Error

Copilot started reviewing on behalf of arkjedrz February 27, 2026 11:51 View session

Copilot AI reviewed Feb 27, 2026

View reviewed changes

arkjedrz force-pushed the arkjedrz_logic-monitor branch from 38a2bdf to 07352fd Compare March 2, 2026 07:34

arkjedrz temporarily deployed to workflow-approval March 2, 2026 07:34 — with GitHub Actions Inactive

arkjedrz force-pushed the arkjedrz_logic-monitor branch from 07352fd to f96e585 Compare March 3, 2026 13:07

arkjedrz temporarily deployed to workflow-approval March 3, 2026 13:07 — with GitHub Actions Inactive

arkjedrz force-pushed the arkjedrz_logic-monitor branch from f96e585 to 4ab21c9 Compare March 4, 2026 14:50

arkjedrz requested a deployment to workflow-approval March 4, 2026 14:50 — with GitHub Actions Waiting

arkjedrz requested a review from NicolasFussberger March 5, 2026 07:58

arkjedrz force-pushed the arkjedrz_logic-monitor branch from 4ab21c9 to 743411c Compare March 5, 2026 10:32

arkjedrz requested a deployment to workflow-approval March 5, 2026 10:32 — with GitHub Actions Waiting

arkjedrz marked this pull request as ready for review March 5, 2026 10:45

arkjedrz requested a review from Copilot March 5, 2026 10:46

Copilot started reviewing on behalf of arkjedrz March 5, 2026 10:46 View session

Copilot AI reviewed Mar 5, 2026

View reviewed changes

pawelrutkaq requested changes Mar 5, 2026

View reviewed changes

src/health_monitoring_lib/rust/logic/logic_monitor.rs Show resolved Hide resolved

src/health_monitoring_lib/rust/tag.rs Show resolved Hide resolved

src/health_monitoring_lib/rust/logic/logic_monitor.rs Outdated Show resolved Hide resolved

arkjedrz force-pushed the arkjedrz_logic-monitor branch from 743411c to 4686fb0 Compare March 5, 2026 13:58

arkjedrz requested a deployment to workflow-approval March 5, 2026 13:58 — with GitHub Actions Waiting

paulquiring reviewed Mar 6, 2026

View reviewed changes

arkjedrz force-pushed the arkjedrz_logic-monitor branch from 4686fb0 to 6247d38 Compare March 6, 2026 12:58

arkjedrz temporarily deployed to workflow-approval March 6, 2026 12:58 — with GitHub Actions Inactive

arkjedrz force-pushed the arkjedrz_logic-monitor branch from 6247d38 to 48bc6f2 Compare March 6, 2026 13:28

arkjedrz temporarily deployed to workflow-approval March 6, 2026 13:28 — with GitHub Actions Inactive

pawelrutkaq requested changes Mar 6, 2026

View reviewed changes

src/health_monitoring_lib/rust/logic/logic_monitor.rs Show resolved Hide resolved

arkjedrz temporarily deployed to workflow-approval March 9, 2026 13:04 — with GitHub Actions Inactive

arkjedrz requested a review from pawelrutkaq March 9, 2026 14:06

pawelrutkaq approved these changes Mar 12, 2026

View reviewed changes

arkjedrz added 3 commits March 12, 2026 13:20

hmon: add logic monitor

62ca16c

Add logic monitor to HMON.

hmon: reworked logic monitor

8a7d788

- Add const constructor to `StateTag`. - Atomic `LogicState` containing current state index and monitor status. - Updated logic monitor API. - Reworked internal of logic monitor.

arkjedrz force-pushed the arkjedrz_logic-monitor branch from fb1c854 to 9e81eb0 Compare March 12, 2026 12:20

arkjedrz had a problem deploying to workflow-approval March 12, 2026 12:20 — with GitHub Actions Error

arkjedrz had a problem deploying to workflow-approval March 12, 2026 12:20 — with GitHub Actions Failure

arkjedrz temporarily deployed to workflow-approval March 12, 2026 12:23 — with GitHub Actions Inactive

arkjedrz temporarily deployed to workflow-approval March 12, 2026 12:27 — with GitHub Actions Inactive

pawelrutkaq merged commit 63df054 into eclipse-score:main Mar 13, 2026
19 of 22 checks passed

arkjedrz deleted the arkjedrz_logic-monitor branch March 13, 2026 07:38

	_ => panic!("Invalid underlying value of logic evaluation error."),
	_ => LogicEvaluationError::InvalidState,

Conversation

arkjedrz commented Feb 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Feb 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

License Check Results

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Copilot AI Feb 27, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Feb 27, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

pawelrutkaq left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

paulquiring Mar 6, 2026

Choose a reason for hiding this comment

Uh oh!

paulquiring Mar 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

arkjedrz Mar 6, 2026

Choose a reason for hiding this comment

Uh oh!

paulquiring Mar 6, 2026

Choose a reason for hiding this comment

Uh oh!

paulquiring commented Mar 6, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

pawelrutkaq Mar 6, 2026

Choose a reason for hiding this comment

Uh oh!

arkjedrz Mar 9, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

pawelrutkaq Mar 6, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

pawelrutkaq commented Mar 12, 2026

Uh oh!

pawelrutkaq commented Mar 13, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

arkjedrz commented Feb 27, 2026 •

edited

Loading

github-actions bot commented Feb 27, 2026 •

edited

Loading

paulquiring Mar 6, 2026 •

edited

Loading