chore(release): prepare v0.12.0 with AGPL metadata, mixed-bus docs/examples, and line-ending policy

Author: CameronBrooks11

.gitattributes

@@ -0,0 +1,15 @@
+# Normalize text files in this repository to LF to avoid cross-platform churn.
+* text=auto eol=lf
+
+# Windows-native scripts keep CRLF.
+*.bat text eol=crlf
+*.cmd text eol=crlf
+*.ps1 text eol=crlf
+
+# Binary assets should never be line-normalized.
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.pdf binary
+*.zip binary

CHANGELOG.md

@@ -8,34 +8,56 @@ All notable changes to CRUMBS are documented in this file.
 
 ### Added
 
-- **ESP32 CI build validation** — `[env:esp32dev]` added to all eight example `platformio.ini`
-  files; eight matching `esp32dev` build steps added to the `platformio` CI job. Validates that
-  all examples compile cleanly for ESP32 (espressif32 platform, Arduino framework).
-- `docs/platform-setup.md` — added ESP32 `platformio.ini` snippet with I²C pin note.
+- **Raw I2C helper APIs** (`src/crumbs.h`, `src/core/crumbs_i2c_helpers.c`)
+  - `crumbs_i2c_dev_write`, `crumbs_i2c_dev_read`, `crumbs_i2c_dev_write_then_read`
+  - register helpers: `read_reg_ex` / `write_reg_ex`, plus `u8` and `u16be` wrappers
+  - standardized `CRUMBS_I2C_DEV_E_*` return codes
+- **Candidate-address CRUMBS scanner**
+  - `crumbs_controller_scan_for_crumbs_candidates(...)` for mixed-bus safe probing without broad sweeps
+- **HAL combined transfer support**
+  - `crumbs_linux_write_then_read(...)`
+  - `crumbs_arduino_write_then_read(...)`
+- **Mixed-bus validation examples**
+  - Linux: `examples/core_usage/linux/mixed_bus_controller/`
+  - Arduino: `examples/core_usage/arduino/mixed_bus_controller/`
+  - includes CRUMBS candidate scanning + non-CRUMBS sensor register I/O flow
+- **Coverage for new helpers**
+  - `tests/test_i2c_helpers.c`
+- **Core Arduino example consistency**
+  - added simple `LED_BUILTIN` heartbeat across core Arduino examples
+  - standardized `config.h` usage in core Arduino examples
+- **ESP32 CI build validation**
+  - `[env:esp32dev]` coverage added across PlatformIO examples and CI workflow steps
+- `docs/platform-setup.md` ESP32 PlatformIO snippet with I2C pin guidance
 
 ### Fixed
 
-- **`examples/handlers_usage/linux/mock_controller/mock_controller.c`** — updated all
-  `mock_query_*` / `mock_send_*` call sites to the `crumbs_device_t *dev` API introduced in
-  0.11.0; replaced deprecated `crumbs_linux_read_message` + manual parse with `mock_get_*()`
-  combined helpers. Fixes Linux CI compile failure.
-
-- **`examples/handlers_usage/platformio/mock_controller/src/main.cpp`** — same migration for
-  the Arduino/PlatformIO mock controller: added `crumbs_device_t dev` global, rewrote
-  `query_and_print()` to use `mock_get_*()`, updated `cmd_echo / cmd_heartbeat / cmd_toggle`
-  to pass `&dev`. Fixes PlatformIO CI compile failure.
-
-- **`LED_BUILTIN` fallback for ESP32** — added `#ifndef LED_BUILTIN / #define LED_BUILTIN 2`
-  guards to `simple_peripheral/src/main.cpp` and `mock_peripheral/src/main.cpp`; the
-  `espressif32` platform does not define `LED_BUILTIN` for `esp32dev`, causing a compile error
-  on ESP32 CI builds. GPIO 2 is the standard onboard LED for ESP32 DevKit boards.
+- Linux mixed-bus controller parser and CLI path issues for `read-ex`/`write-ex` handling
+- Linux HAL portability by defining `_DEFAULT_SOURCE` for `usleep()` under `-std=c11`
+- handlers_usage mock controller examples updated to `crumbs_device_t` APIs and query helpers (Linux + PlatformIO), resolving CI compile failures
+- `LED_BUILTIN` fallback for ESP32 examples (`#ifndef LED_BUILTIN ... #define LED_BUILTIN 2`)
+- API reference scan behavior documentation corrections
 
 ### Changed
 
-- Post-release docs sweep (`0649205`): corrected stale `0.10.3` version references in all
-  eight `platformio.ini` examples, `CONTRIBUTING.md`, `docs/index.md`, and
-  `docs/api-reference.md`; fixed hardcoded `MINOR`/`PATCH` values in `test_version.c`.
-- README badge layout revised; `.gitignore` extended with `*.log` pattern.
+- **Mixed-bus Arduino controller flow** (`examples/core_usage/arduino/mixed_bus_controller/`)
+  - startup validation pass + periodic status pass (default 5s)
+  - CRUMBS query reply printout for discovered devices
+  - BMP/BME chip-id + raw sample byte printout per configured sensor
+- **Core docs and examples updated for mixed-bus usage**
+  - explicit min/max topology guidance
+  - unique address guidance for CRUMBS peripherals
+  - candidate-address scanning pattern documented
+- **License posture aligned to AGPL**
+  - repository license is GNU AGPL v3
+  - metadata/docs references updated to AGPL-3.0-or-later
+- **Repository line ending policy added**
+  - `.gitattributes` now enforces LF for text and CRLF for Windows scripts to reduce cross-platform churn
+- **Code quality**
+  - read-helper bounds checks use explicit `size_t` casts in `crumbs_message_helpers.h` to avoid conversion/sign-compare warning noise
+- Post-0.11.0 version/docs sweep:
+  - stale version references corrected across examples/docs
+  - README badge/layout cleanup and `.gitignore` log pattern expansion
 
 ---
 
@@ -184,18 +206,6 @@ All notable changes to CRUMBS are documented in this file.
 
 ---
 
-## [Unreleased] - Code Quality
-
-### Changed
-
-- **Read helper bounds checks now use explicit `size_t` casts** (`crumbs_message_helpers.h`)
-  - `crumbs_msg_read_u16`, `crumbs_msg_read_u32`, `crumbs_msg_read_float`, `crumbs_msg_read_bytes`
-  - Arithmetic in bounds checks now cast to `size_t` before addition, matching the existing style of the `add_*` helpers
-  - Eliminates potential `-Wconversion`/`-Wsign-compare` warnings (particularly the `read_float` case where `int` was previously compared against `size_t` from `sizeof`)
-  - No functional change — semantics were already correct due to C integer promotion rules
-
----
-
 ## [0.10.3] - Examples Improvements
 
 ### Added

CMakeLists.txt

@@ -1,7 +1,7 @@
 cmake_minimum_required(VERSION 3.13)
 
 project(CRUMBS
-    VERSION 0.11.0
+    VERSION 0.12.0
     LANGUAGES C
 )
 

CONTRIBUTING.md

@@ -84,7 +84,7 @@ CRUMBS is designed to work seamlessly with Arduino IDE and PlatformIO:
 ```ini
 # platformio.ini
 lib_deps =
-    cameronbrooks11/CRUMBS@^0.11.0
+    cameronbrooks11/CRUMBS@^0.12.0
 ```
 
 Or for local development (see [Local Development](#local-development-with-platformio) below).
@@ -229,7 +229,7 @@ When developing changes to CRUMBS itself, test locally before publishing:
    ```ini
    # Change from registry version
    lib_deps =
-       cameronbrooks11/CRUMBS@^0.11.0
+       cameronbrooks11/CRUMBS@^0.12.0
 
    # To local symlink
    lib_deps =
@@ -249,7 +249,7 @@ When developing changes to CRUMBS itself, test locally before publishing:
 
    ```ini
    lib_deps =
-       cameronbrooks11/CRUMBS@^0.11.0
+       cameronbrooks11/CRUMBS@^0.12.0
    ```
 
 **Path explanation:**

README.md

@@ -13,7 +13,7 @@ CRUMBS (Communications Router and Unified Message Broker System) is a small, por
 [![Language](https://img.shields.io/badge/language-C%20%7C%20C%2B%2B-00599C)](./)
 [![CMake](https://img.shields.io/badge/build-CMake-064F8C)](https://cmake.org/)
 
-[![License: GPL-3.0-or-later](https://img.shields.io/badge/License-GPL--3.0--or--later-blue.svg)](./LICENSE)
+[![License: AGPL-3.0-or-later](https://img.shields.io/badge/License-AGPL--3.0--or--later-blue.svg)](./LICENSE)
 [![PlatformIO Registry](https://badges.registry.platformio.org/packages/cameronbrooks11/library/CRUMBS.svg)](https://registry.platformio.org/libraries/cameronbrooks11/CRUMBS)
 
 ## Features
@@ -54,7 +54,7 @@ Upload [hello examples](examples/core_usage/arduino/hello_peripheral/) to two Ar
 
 ```ini
 [env]
-lib_deps = cameronbrooks11/CRUMBS@^0.11.0
+lib_deps = cameronbrooks11/CRUMBS@^0.12.0
 ```
 
 **Arduino IDE:** Tools → Manage Libraries → "CRUMBS" → Install, or copy to `~/Arduino/libraries/`
@@ -117,5 +117,5 @@ Details: [platform-setup.md](docs/platform-setup.md)
 
 ## License
 
-GPL-3.0 - see [LICENSE](LICENSE) file for details.
+AGPL-3.0-or-later - see [LICENSE](LICENSE) file for details.
 

docs/api-reference.md

@@ -63,7 +63,7 @@ typedef struct crumbs_context_t {
 #define CRUMBS_MAX_PAYLOAD      27    // Maximum payload bytes
 #define CRUMBS_MESSAGE_MAX_SIZE 31    // Maximum serialized frame size
 #define CRUMBS_CMD_SET_REPLY    0xFE  // Reserved opcode for SET_REPLY command
-#define CRUMBS_VERSION          1100  // Library version (1100 = v0.11.0, formula: major*10000 + minor*100 + patch)
+#define CRUMBS_VERSION          1100  // Library version (1100 = v0.12.0, formula: major*10000 + minor*100 + patch)
 ```
 
 ### Bound-Device Handle

docs/index.md

@@ -225,7 +225,7 @@ Historical and technical deep-dive documents are in [archive/](archive/):
 
 ---
 
-**Version**: 0.11.0  
+**Version**: 0.12.0  
 **Author**: Cameron K. Brooks  
 **Dependencies**: Wire library (Arduino), linux-wire (Linux HAL)  
-**License**: GPL-3.0-or-later
+**License**: AGPL-3.0-or-later

docs/platform-setup.md

@@ -160,7 +160,7 @@ board = nanoatmega328new
 framework = arduino
 
 lib_deps =
-    cameronbrooks11/CRUMBS@^0.11.0
+    cameronbrooks11/CRUMBS@^0.12.0
 
 build_flags =
     -DCRUMBS_MAX_HANDLERS=8  ; optional: reduce handler table size
@@ -175,7 +175,7 @@ board = esp32dev
 framework = arduino
 
 lib_deps =
-    cameronbrooks11/CRUMBS@^0.11.0
+    cameronbrooks11/CRUMBS@^0.12.0
 
 build_flags =
     -DCRUMBS_MAX_HANDLERS=8  ; optional

examples/families_usage/controller_discovery/README.md

@@ -72,9 +72,9 @@ make
 ```sh
 lhwit> scan
 Scanning for CRUMBS devices...
-Found Calculator at 0x10 (CRUMBS 0.11.0, Module 1.0.0) - Compatible
-Found LED Array at 0x20 (CRUMBS 0.11.0, Module 1.0.0) - Compatible
-Found Servo Controller at 0x30 (CRUMBS 0.11.0, Module 1.0.0) - Compatible
+Found Calculator at 0x10 (CRUMBS 0.12.0, Module 1.0.0) - Compatible
+Found LED Array at 0x20 (CRUMBS 0.12.0, Module 1.0.0) - Compatible
+Found Servo Controller at 0x30 (CRUMBS 0.12.0, Module 1.0.0) - Compatible
 
 Found 3 CRUMBS device(s):
   [0] Address 0x10, Type 0x03 (Calculator)

library.json

@@ -1,6 +1,6 @@
 {
   "name": "CRUMBS",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "CRUMBS: a small, portable C-based protocol for controller/peripheral I2C messaging (Arduino + Linux HALs).",
   "keywords": "i2c,crumbs,crc,arduino,linux,protocol",
   "repository": {
@@ -14,7 +14,7 @@
       "maintainer": true
     }
   ],
-  "license": "GPL-3.0-or-later",
+  "license": "AGPL-3.0-or-later",
   "frameworks": [
     "arduino"
   ],
@@ -31,4 +31,4 @@
     "examples/handlers_usage/platformio/mock_controller",
     "examples/handlers_usage/platformio/mock_peripheral"
   ]
-}
+}