Initial mw::com-based implementation of ilmcontrol interface

MODULE.bazel

@@ -100,6 +100,15 @@ use_repo(llvm, "llvm_toolchain", "llvm_toolchain_llvm")
 
 # UTs on QNX
 bazel_dep(name = "score_qnx_unit_tests", version = "0.2.0", dev_dependency = True)
+
+# TODO: drop this override once a version > 0.2.0 is published.
+# Latest release (0.2.0) does not support CLI args when running tests on QNX
+git_override(
+    module_name = "score_qnx_unit_tests",
+    commit = "79cc6598268d1f21cbfa75da4993facccf01edbd",
+    remote = "https://github.com/eclipse-score/qnx_unit_tests.git",
+)
+
 bazel_dep(name = "score_rules_imagefs", version = "0.0.4", dev_dependency = True)
 
 imagefs = use_extension("@score_rules_imagefs//extensions:imagefs.bzl", "imagefs", dev_dependency = True)
@@ -182,6 +191,7 @@ oci.pull(
 use_repo(oci, "debian-test-runtime", "debian-test-runtime_linux_amd64")
 
 bazel_dep(name = "score_baselibs", version = "0.2.12")
+bazel_dep(name = "score_communication", version = "0.4.0")
 
 # Hedron's Compile Commands Extractor for Bazel
 # https://github.com/hedronvision/bazel-compile-commands-extractor

score/launch_manager/src/daemon/src/common/log.hpp

@@ -33,8 +33,8 @@ namespace mw::lifecycle
 namespace internal
 {
 
-/// @brief Function to access global logging context, for Launch Manager.
-/// Launch Manager (LM) daemon, uses a single global logging context.
+/// @brief Function to access global logging context, for Launch Manager and its libraries.
+/// Launch Manager (LM) daemon and libraries use a single global logging context.
 /// This context is stored as a static variable inside this function and used all over LM daemon implementation.
 /// Please note that code should not call this function directly, but should use a set of wrapper macros.
 /// More information can be found in docs/architecture/concepts/logging/logging.rst file.

score/launch_manager/src/execution_error.h

@@ -39,7 +39,11 @@ enum class ExecErrc : score::result::ErrorCode
     kInTransitionToSameState = 11,  ///< Transition to the requested Process Group state failed because transition to
                                     ///< requested state is already in progress
     kNoTimeStamp = 12,              ///< DeterministicClient time stamp information is not available
-    kCycleOverrun = 13              ///< Deterministic activation cycle time exceeded
+    kCycleOverrun = 13,             ///< Deterministic activation cycle time exceeded
+    kActivationInProgress =
+        14,  ///< A Run Target activation is already in progress; no single Run Target is currently active
+    kRequestQueueIsFull = 15,   ///< The activation request queue is full; the request was discarded
+    kRunTargetDoesntExist = 16  ///< The requested Run Target name does not exist in the current configuration
 };
 
 class ExecErrorDomain final : public score::result::ErrorDomain
@@ -77,18 +81,24 @@ class ExecErrorDomain final : public score::result::ErrorDomain
                 return "DeterministicClient time stamp information is not available";
             case ExecErrc::kCycleOverrun:
                 return "Deterministic activation cycle time exceeded";
+            case ExecErrc::kActivationInProgress:
+                return "A Run Target activation is already in progress; no single Run Target is currently active";
+            case ExecErrc::kRequestQueueIsFull:
+                return "The activation request queue is full; the request was discarded";
+            case ExecErrc::kRunTargetDoesntExist:
+                return "The requested Run Target name does not exist in the current configuration";
             default:
                 return "Unknown error";
         }
     }
 };
 
-constexpr ExecErrorDomain g_ExecErrorDomain{};
+/// @brief The single ExecErrorDomain instance every ExecErrc-based Error refers to.
+inline constexpr ExecErrorDomain g_ExecErrorDomain{};
 
 constexpr score::result::Error MakeError(ExecErrc code, const std::string_view user_message = "") noexcept
 {
     return score::result::Error{static_cast<score::result::ErrorCode>(code), g_ExecErrorDomain, user_message};
-    ;
 }
 
 }  // namespace score::mw::lifecycle

score/launch_manager/src/lm_control/BUILD

@@ -0,0 +1,70 @@
+# *******************************************************************************
+# Copyright (c) 2026 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Apache License Version 2.0 which is available at
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# SPDX-License-Identifier: Apache-2.0
+# *******************************************************************************
+load("@rules_cc//cc:defs.bzl", "cc_library")
+load("//tests/utils/bazel:unit_test.bzl", "lm_cc_test")
+
+cc_library(
+    name = "lm_control",
+    srcs = [
+        "src/details/ilm_control.cpp",
+    ],
+    hdrs = [
+        "src/details/lm_control_impl.hpp",
+        "src/details/lm_control_service.h",
+        "src/fixed_string.hpp",
+        "src/ilm_control.hpp",
+        "src/run_target_activation_source.hpp",
+    ],
+    include_prefix = "score/mw/lifecycle",
+    strip_include_prefix = "/score/launch_manager/src/lm_control/src",
+    visibility = [
+        "//score:__subpackages__",
+        "//tests:__subpackages__",
+    ],
+    deps = [
+        "//score/launch_manager:error",
+        "//score/launch_manager/src/daemon/src/common:log",
+        "@score_baselibs//score/language/futurecpp",
+        "@score_baselibs//score/language/safecpp/scoped_function:copyable_scoped_function",
+        "@score_baselibs//score/language/safecpp/scoped_function:scope",
+        "@score_baselibs//score/result",
+        "@score_communication//score/mw/com",
+    ],
+)
+
+lm_cc_test(
+    name = "lm_control_impl_UT",
+    srcs = ["src/details/lm_control_impl_UT.cpp"],
+    deps = [
+        ":lm_control",
+        "//score/launch_manager:error",
+        "@googletest//:gtest_main",
+        "@score_baselibs//score/result",
+        "@score_communication//score/mw/com",
+    ],
+)
+
+lm_cc_test(
+    name = "ilm_control_UT",
+    srcs = ["src/details/ilm_control_UT.cpp"],
+    args = [
+        "--service_instance_manifest",
+        "$(rootpath src/details/test_lmcontrol_mw_com_config.json)",
+    ],
+    data = ["src/details/test_lmcontrol_mw_com_config.json"],
+    deps = [
+        ":lm_control",
+        "@googletest//:gtest",
+        "@score_communication//score/mw/com",
+    ],
+)

score/launch_manager/src/lm_control/src/details/ilm_control.cpp

@@ -0,0 +1,31 @@
+/********************************************************************************
+ * Copyright (c) 2026 Contributors to the Eclipse Foundation
+ *
+ * See the NOTICE file(s) distributed with this work for additional
+ * information regarding copyright ownership.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Apache License Version 2.0 which is available at
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ ********************************************************************************/
+
+#include "score/mw/lifecycle/ilm_control.hpp"
+#include "score/mw/lifecycle/details/lm_control_impl.hpp"
+
+namespace score::mw::lifecycle
+{
+
+score::Result<std::unique_ptr<ILmControl>> ILmControl::Create(std::string_view instance_specifier)
+{
+    auto instance = std::make_unique<internal::LmControlImpl>();
+    const auto init_result = instance->init(instance_specifier);
+    if (!init_result.has_value())
+    {
+        return score::MakeUnexpected<std::unique_ptr<ILmControl>>(init_result.error());
+    }
+    return instance;
+}
+
+}  // namespace score::mw::lifecycle

score/launch_manager/src/lm_control/src/details/ilm_control_UT.cpp

@@ -0,0 +1,73 @@
+/********************************************************************************
+ * Copyright (c) 2026 Contributors to the Eclipse Foundation
+ *
+ * See the NOTICE file(s) distributed with this work for additional
+ * information regarding copyright ownership.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Apache License Version 2.0 which is available at
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ ********************************************************************************/
+
+#include <gtest/gtest.h>
+
+#include <string>
+#include <string_view>
+
+#include "score/mw/com/runtime.h"
+#include "score/mw/lifecycle/ilm_control.hpp"
+
+namespace score::mw::lifecycle
+{
+namespace
+{
+
+constexpr std::string_view kValidSpecifier = "StateManager/LaunchManager/Instance";
+
+class ILmControlUT : public ::testing::Test
+{
+  protected:
+    void SetUp() override
+    {
+        RecordProperty("TestType", "interface-test");
+        RecordProperty("DerivationTechnique", "equivalence-classes");
+
+        // The following two equivalence classes are tested here:
+        // * Return a valid instance
+        // * Return an error
+        // The different error cases are tested in the underlying impl class LmControlImpl unit tests
+    }
+};
+
+TEST_F(ILmControlUT, ReturnsValidInstance)
+{
+    RecordProperty("Description", "ILmControl::Create returns a valid instance for a valid instance specifier.");
+
+    auto result = ILmControl::Create(std::string{kValidSpecifier});
+
+    ASSERT_TRUE(result.has_value());
+    EXPECT_NE(result.value(), nullptr);
+}
+
+TEST_F(ILmControlUT, ReturnsInitErrorForInvalidSpecifier)
+{
+    RecordProperty(
+        "Description", "ILmControl::Create returns kInvalidArguments error for an invalid instance specifier.");
+
+    auto result = ILmControl::Create("");
+
+    ASSERT_FALSE(result.has_value());
+    EXPECT_EQ(result.error(), ExecErrc::kInvalidArguments);
+}
+
+}  // namespace
+}  // namespace score::mw::lifecycle
+
+int main(int argc, char** argv)
+{
+    ::testing::InitGoogleTest(&argc, argv);
+    score::mw::com::runtime::InitializeRuntime(argc, const_cast<const char**>(argv));
+    return RUN_ALL_TESTS();
+}