feat: replace compile-time ENABLE_HARDWARE with runtime mock:// gating, bump to v0.2.4

Architecture change: aligns bread with the ezo provider pattern.

Previously: ANOLIS_PROVIDER_BREAD_ENABLE_HARDWARE=ON/OFF at compile time.
The release binary shipped with HARDWARE=OFF (non-functional no-op).

Now: one binary per platform. Hardware capability is always compiled in
on Linux. Runtime behavior is determined by bus_path in config:
  - bus_path: mock://...  => config-seeded inventory (no hardware needed)
  - bus_path: /dev/i2c-1 => opens CRUMBS bus, runs discovery

Changes:
- Remove ANOLIS_PROVIDER_BREAD_ENABLE_HARDWARE option from CMakeLists.txt
- Replace #if ANOLIS_PROVIDER_BREAD_HAS_CRUMBS guards with #if defined(__linux__)
  in linux_transport.hpp/cpp and runtime_state.cpp
- Add is_mock_mode() runtime check in runtime_state.cpp
- Remove hardware.require_live_session config field (superseded by bus_path)
- Add config/ci.test.yaml with mock://ci-test for CI/dev use
- shell_test and proto_smoke_test now use mock://test-stub / ci.test.yaml
- CMakePresets.json: remove ENABLE_HARDWARE from all presets; rename
  linux-hardware-base -> linux-base; remove *-hardware-* presets
- linux-wire: set(BUILD_SHARED_LIBS OFF) before add_subdirectory to ensure
  static archive regardless of parent CMake context
- CRUMBS_ENABLE_LINUX_HAL now always ON on Linux, OFF on other platforms
- Workflow: add linux-wire checkout (feastorg/linux-wire@v0.1.2);
  remove explicit -DCRUMBS_DIR/-DBREAD_CONTRACTS_DIR cmake overrides
  (preset linux-base sets these via sourceDir/../ pattern)

Author: CameronBrooks11

.github/workflows/release.yml

@@ -42,6 +42,13 @@ jobs:
           ref: v0.4.2
           path: bread-crumbs-contracts
 
+      - name: Checkout linux-wire
+        uses: actions/checkout@v4
+        with:
+          repository: feastorg/linux-wire
+          ref: v0.1.2
+          path: linux-wire
+
       - name: Install system dependencies
         run: |
           sudo apt-get update
@@ -59,10 +66,7 @@ jobs:
 
       - name: Configure
         working-directory: anolis-provider-bread
-        run: |
-          cmake --preset ci-linux-release \
-            "-DCRUMBS_DIR=${{ github.workspace }}/CRUMBS" \
-            "-DBREAD_CONTRACTS_DIR=${{ github.workspace }}/bread-crumbs-contracts"
+        run: cmake --preset ci-linux-release
 
       - name: Build
         working-directory: anolis-provider-bread

CHANGELOG.md

@@ -13,6 +13,36 @@ commit messages only.
 
 ## [Unreleased]
 
+## [0.2.4] - 2026-04-24
+
+### Changed
+
+- Replaced compile-time `ANOLIS_PROVIDER_BREAD_ENABLE_HARDWARE` flag with runtime
+  gating via `bus_path` prefix. `bus_path: mock://...` produces a config-seeded
+  inventory without requiring any hardware; any other path opens a live CRUMBS
+  session. This aligns bread with the ezo provider pattern: one binary per
+  platform, behavior determined by config at runtime.
+- Removed `hardware.require_live_session` config field. The same intent is now
+  expressed by using a real bus path (e.g. `/dev/i2c-1`) — if the bus cannot be
+  opened, startup throws. Configs with `require_live_session` will be rejected
+  at load time as an unknown key.
+- Added `config/ci.test.yaml` with `bus_path: mock://ci-test` for CI and dev
+  testing without hardware.
+- `linux-wire` is now always compiled into the provider on Linux (no flag required).
+  `set(BUILD_SHARED_LIBS OFF)` added before the linux-wire subdirectory to ensure
+  a static archive regardless of the parent CMake context.
+- Removed `dev-linux-hardware-debug`, `dev-linux-hardware-release`, and
+  `ci-linux-hardware-release` presets (superseded by `dev-debug`, `dev-release`,
+  and `ci-linux-release` which now always include hardware capability on Linux).
+- Renamed hidden `linux-hardware-base` preset to `linux-base`.
+
+### CI
+
+- Release workflow: added linux-wire checkout (`feastorg/linux-wire@v0.1.2`).
+- Release workflow: removed explicit `-DCRUMBS_DIR` / `-DBREAD_CONTRACTS_DIR`
+  cmake overrides; these are now set by the `linux-base` preset via
+  `${sourceDir}/../CRUMBS` and `${sourceDir}/../bread-crumbs-contracts`.
+
 ## [0.2.3] - 2026-04-23
 
 ### CI

CMakeLists.txt

@@ -1,9 +1,8 @@
 cmake_minimum_required(VERSION 3.20)
 
-option(ANOLIS_PROVIDER_BREAD_ENABLE_HARDWARE "Enable CRUMBS/Linux hardware integration" ${UNIX})
 option(ANOLIS_PROVIDER_BREAD_WARNINGS_AS_ERRORS "Treat first-party compiler warnings as errors" OFF)
 
-project(anolis_provider_bread VERSION 0.2.3 LANGUAGES C CXX)
+project(anolis_provider_bread VERSION 0.2.4 LANGUAGES C CXX)
 
 set(CMAKE_CXX_STANDARD 17)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)
@@ -57,30 +56,21 @@ if(NOT ADPP_PROTOS)
     )
 endif()
 
-if(ANOLIS_PROVIDER_BREAD_ENABLE_HARDWARE)
-    if(NOT CMAKE_SYSTEM_NAME STREQUAL "Linux")
-        message(FATAL_ERROR
-            "ANOLIS_PROVIDER_BREAD_ENABLE_HARDWARE requires a Linux host build.\n"
-            "Use a Linux hardware preset (dev-linux-hardware-debug, dev-linux-hardware-release)\n"
-            "or configure with ANOLIS_PROVIDER_BREAD_ENABLE_HARDWARE=OFF on other platforms."
-        )
-    endif()
-
+if(CMAKE_SYSTEM_NAME STREQUAL "Linux")
     if(NOT DEFINED LINUX_WIRE_DIR)
         set(LINUX_WIRE_DIR "${CMAKE_CURRENT_SOURCE_DIR}/../linux-wire" CACHE PATH "Path to linux-wire repository")
     endif()
     get_filename_component(LINUX_WIRE_DIR_ABS "${LINUX_WIRE_DIR}" ABSOLUTE BASE_DIR "${CMAKE_CURRENT_SOURCE_DIR}")
 
-    if(EXISTS "${LINUX_WIRE_DIR_ABS}/CMakeLists.txt")
-        set(LINUX_WIRE_BUILD_EXAMPLES OFF CACHE BOOL "" FORCE)
-        add_subdirectory("${LINUX_WIRE_DIR_ABS}" "${CMAKE_BINARY_DIR}/linux_wire_subbuild")
-        message(STATUS "Using linux-wire source tree: ${LINUX_WIRE_DIR_ABS}")
-    else()
-        message(STATUS
-            "LINUX_WIRE_DIR not found at '${LINUX_WIRE_DIR_ABS}'. "
-            "CRUMBS will rely on installed linux_wire package visibility if Linux HAL is enabled."
-        )
+    if(NOT EXISTS "${LINUX_WIRE_DIR_ABS}/CMakeLists.txt")
+        message(FATAL_ERROR
+            "linux-wire not found at: ${LINUX_WIRE_DIR_ABS}\n"
+            "Set LINUX_WIRE_DIR to the root of the linux-wire repository.")
     endif()
+    set(BUILD_SHARED_LIBS OFF)
+    set(LINUX_WIRE_BUILD_EXAMPLES OFF CACHE BOOL "" FORCE)
+    add_subdirectory("${LINUX_WIRE_DIR_ABS}" "${CMAKE_BINARY_DIR}/linux_wire_subbuild")
+    message(STATUS "Using linux-wire source tree: ${LINUX_WIRE_DIR_ABS}")
 endif()
 
 # CRUMBS: find_package by default; set CRUMBS_DIR to use a source-tree override.
@@ -91,7 +81,11 @@ if(DEFINED CRUMBS_DIR AND NOT CRUMBS_DIR STREQUAL "")
             "CRUMBS not found at: ${CRUMBS_DIR_ABS}\n"
             "Set CRUMBS_DIR to the root of the CRUMBS repository.")
     endif()
-    set(CRUMBS_ENABLE_LINUX_HAL "${ANOLIS_PROVIDER_BREAD_ENABLE_HARDWARE}" CACHE BOOL "" FORCE)
+    if(CMAKE_SYSTEM_NAME STREQUAL "Linux")
+        set(CRUMBS_ENABLE_LINUX_HAL ON CACHE BOOL "" FORCE)
+    else()
+        set(CRUMBS_ENABLE_LINUX_HAL OFF CACHE BOOL "" FORCE)
+    endif()
     set(CRUMBS_BUILD_EXAMPLES OFF CACHE BOOL "" FORCE)
     set(CRUMBS_ENABLE_TESTS OFF CACHE BOOL "" FORCE)
     add_subdirectory("${CRUMBS_DIR_ABS}" "${CMAKE_BINARY_DIR}/crumbs_subbuild")
@@ -168,14 +162,11 @@ target_compile_definitions(anolis_provider_bread_crumbs PUBLIC
 )
 anolis_provider_bread_apply_warnings(anolis_provider_bread_crumbs)
 
-if(ANOLIS_PROVIDER_BREAD_ENABLE_HARDWARE)
+if(CMAKE_SYSTEM_NAME STREQUAL "Linux")
     target_sources(anolis_provider_bread_crumbs PRIVATE
         src/crumbs/linux_transport.cpp
     )
     target_link_libraries(anolis_provider_bread_crumbs PUBLIC crumbs::crumbs)
-    target_compile_definitions(anolis_provider_bread_crumbs PUBLIC
-        ANOLIS_PROVIDER_BREAD_HAS_CRUMBS=1
-    )
 endif()
 
 add_library(anolis_provider_bread_core STATIC

CMakePresets.json

@@ -28,7 +28,7 @@
       }
     },
     {
-      "name": "linux-hardware-base",
+      "name": "linux-base",
       "hidden": true,
       "inherits": "base",
       "cacheVariables": {
@@ -39,57 +39,30 @@
     },
     {
       "name": "dev-debug",
-      "inherits": "base",
+      "inherits": "linux-base",
       "cacheVariables": {
-        "CMAKE_BUILD_TYPE": "Debug",
-        "ANOLIS_PROVIDER_BREAD_ENABLE_HARDWARE": "OFF"
+        "CMAKE_BUILD_TYPE": "Debug"
       }
     },
     {
       "name": "dev-release",
-      "inherits": "base",
+      "inherits": "linux-base",
       "cacheVariables": {
-        "CMAKE_BUILD_TYPE": "Release",
-        "ANOLIS_PROVIDER_BREAD_ENABLE_HARDWARE": "OFF"
+        "CMAKE_BUILD_TYPE": "Release"
       }
     },
     {
       "name": "dev-windows-debug",
       "inherits": "base-windows-msvc",
       "cacheVariables": {
-        "CMAKE_BUILD_TYPE": "Debug",
-        "ANOLIS_PROVIDER_BREAD_ENABLE_HARDWARE": "OFF"
+        "CMAKE_BUILD_TYPE": "Debug"
       }
     },
     {
       "name": "dev-windows-release",
       "inherits": "base-windows-msvc",
       "cacheVariables": {
-        "CMAKE_BUILD_TYPE": "Release",
-        "ANOLIS_PROVIDER_BREAD_ENABLE_HARDWARE": "OFF"
-      }
-    },
-    {
-      "name": "dev-linux-hardware-debug",
-      "inherits": "linux-hardware-base",
-      "cacheVariables": {
-        "CMAKE_BUILD_TYPE": "Debug",
-        "ANOLIS_PROVIDER_BREAD_ENABLE_HARDWARE": "ON"
-      }
-    },
-    {
-      "name": "dev-linux-hardware-release",
-      "inherits": "linux-hardware-base",
-      "cacheVariables": {
-        "CMAKE_BUILD_TYPE": "Release",
-        "ANOLIS_PROVIDER_BREAD_ENABLE_HARDWARE": "ON"
-      }
-    },
-    {
-      "name": "ci-linux-hardware-release",
-      "inherits": "dev-linux-hardware-release",
-      "cacheVariables": {
-        "ANOLIS_PROVIDER_BREAD_WARNINGS_AS_ERRORS": "ON"
+        "CMAKE_BUILD_TYPE": "Release"
       }
     },
     {
@@ -104,7 +77,6 @@
       "inherits": "base-windows-msvc",
       "cacheVariables": {
         "CMAKE_BUILD_TYPE": "Release",
-        "ANOLIS_PROVIDER_BREAD_ENABLE_HARDWARE": "OFF",
         "ANOLIS_PROVIDER_BREAD_WARNINGS_AS_ERRORS": "ON"
       }
     }
@@ -128,18 +100,6 @@
       "configurePreset": "dev-windows-release",
       "configuration": "Release"
     },
-    {
-      "name": "dev-linux-hardware-debug",
-      "configurePreset": "dev-linux-hardware-debug"
-    },
-    {
-      "name": "dev-linux-hardware-release",
-      "configurePreset": "dev-linux-hardware-release"
-    },
-    {
-      "name": "ci-linux-hardware-release",
-      "configurePreset": "ci-linux-hardware-release"
-    },
     {
       "name": "ci-linux-release",
       "configurePreset": "ci-linux-release"
@@ -181,27 +141,6 @@
         "outputOnFailure": true
       }
     },
-    {
-      "name": "dev-linux-hardware-debug",
-      "configurePreset": "dev-linux-hardware-debug",
-      "output": {
-        "outputOnFailure": true
-      }
-    },
-    {
-      "name": "dev-linux-hardware-release",
-      "configurePreset": "dev-linux-hardware-release",
-      "output": {
-        "outputOnFailure": true
-      }
-    },
-    {
-      "name": "ci-linux-hardware-release",
-      "configurePreset": "ci-linux-hardware-release",
-      "output": {
-        "outputOnFailure": true
-      }
-    },
     {
       "name": "ci-linux-release",
       "configurePreset": "ci-linux-release",

config/ci.test.yaml

@@ -0,0 +1,22 @@
+provider:
+  name: bread-ci-test
+
+hardware:
+  bus_path: mock://ci-test
+  query_delay_us: 10000
+  timeout_ms: 100
+  retry_count: 2
+
+discovery:
+  mode: manual
+  addresses: [0x08, 0x09]
+
+devices:
+  - id: rlht0
+    type: rlht
+    label: Left Heater (CI test)
+    address: 0x08
+  - id: dcmt0
+    type: dcmt
+    label: Conveyor Drive (CI test)
+    address: 0x09

src/config/provider_config.cpp

@@ -199,15 +199,11 @@ ProviderConfig load_config(const std::string &path) {
   }
   ensure_map(hardware_node, "hardware");
   reject_unknown_keys(hardware_node, "hardware",
-                      {"bus_path", "require_live_session", "query_delay_us",
+                      {"bus_path", "query_delay_us",
                        "timeout_ms", "retry_count"});
 
   config.bus_path =
       require_scalar(hardware_node["bus_path"], "hardware.bus_path");
-  if (hardware_node["require_live_session"]) {
-    config.require_live_session = parse_bool_value(
-        hardware_node["require_live_session"], "hardware.require_live_session");
-  }
   if (hardware_node["query_delay_us"]) {
     config.query_delay_us = parse_int_value(hardware_node["query_delay_us"],
                                             "hardware.query_delay_us", false);
@@ -325,8 +321,6 @@ std::string summarize_config(const ProviderConfig &config) {
   // the effective config without dumping the full YAML file.
   out << "provider.name=" << config.provider_name
       << ", hardware.bus_path=" << config.bus_path
-      << ", hardware.require_live_session="
-      << (config.require_live_session ? "true" : "false")
       << ", hardware.query_delay_us=" << config.query_delay_us
       << ", hardware.timeout_ms=" << config.timeout_ms
       << ", hardware.retry_count=" << config.retry_count

src/config/provider_config.hpp

@@ -44,14 +44,12 @@ struct DeviceSpec {
  * @brief Fully resolved provider configuration after YAML parsing.
  *
  * The provider may either scan the bus or probe the explicitly listed manual
- * addresses. `require_live_session` forces startup to fail on no-hardware
- * builds instead of falling back to config-seeded inventory.
+ * addresses.
  */
 struct ProviderConfig {
   std::string config_file_path;
   std::string provider_name = "anolis-provider-bread";
   std::string bus_path;
-  bool require_live_session = false;
   int query_delay_us = 10000;
   int timeout_ms = 100;
   int retry_count = 2;