mirror of
https://github.com/ruvnet/RuView
synced 2026-07-20 17:03:24 +00:00
f5d787ccde
Per ADR-115 §9.4 (maintainer ACK on #776), v0.7.0 ships **3 starter blueprints**. This commit goes further: all **8** of the catalog proposed in §3.12.2 land as standalone YAML files under `examples/ha-blueprints/`, ready to import into HA. ## Blueprints 1. Notify on possible distress → possible_distress 2. Dim hallway when sleeping → someone_sleeping 3. Wake routine on bed exit → bed_exit (time-window-gated) 4. Alert on elderly inactivity → elderly_inactivity_anomaly (with optional escalation chain) 5. Meeting lights + presence mode → meeting_in_progress (activates a HA scene) 6. Bathroom fan while occupied → bathroom_occupied (privacy-mode-safe; zone-derived) 7. Escalate on fall-risk crossing → fall_risk_elevated (numeric_state trigger) 8. Auto-arm security when not active → group(room_active) + no_movement (composed; multi-room sense) Each blueprint: - Uses HA's blueprint schema (https://www.home-assistant.io/docs/blueprint/schema/) - Declares typed `selector:` for every input (entity-domain-constrained where applicable) - Carries a `source_url` for HACS-style re-import - Includes `mode: single` + `max_exceeded: silent` where appropriate so transient retriggers don't spam - Includes a `cooldown_minutes` / `confirm_minutes` / `ack_timeout_min` parameter where time-debouncing matters ## Validator (`scripts/validate-ha-blueprints.py`) Pure-Python validator that: - Registers no-op constructors for HA's `!input` and `!secret` YAML tags (PyYAML doesn't know them) - Asserts every file has a top-level `blueprint:` mapping with `name`/`description`/`domain` - Asserts `domain` is `automation` or `script` - Asserts at least one declared `input` - Asserts at least one of `trigger`/`action`/`sequence` is present Exits 0 only when all 8 validate. Local run: python scripts/validate-ha-blueprints.py All 8 HA Blueprints validate OK ## CI integration `.github/workflows/mqtt-integration.yml` gains a new `Validate HA Blueprints` step that runs the Python validator before the cargo test phases — fails the workflow on any malformed blueprint in a PR. ## Privacy-mode coverage table 5 of 8 blueprints are unconditionally privacy-mode-safe (no biometric dependency in the state derivation). The other 3 depend on inferred states that themselves derive from biometrics — the inferred state still publishes under `--privacy-mode` (per ADR §3.12.3) but the operator should audit the use case in regulated contexts. Full table in `examples/ha-blueprints/README.md`. Refs #776, PR #778. Co-Authored-By: claude-flow <ruv@ruv.net>
111 lines
3.8 KiB
YAML
111 lines
3.8 KiB
YAML
name: ADR-115 MQTT integration tests
|
|
|
|
# Runs the Mosquitto-broker-backed integration tests for ADR-115's MQTT
|
|
# publisher. These prove the publisher reaches a real broker, emits the
|
|
# expected HA-discovery topic shape, and honours --privacy-mode at the
|
|
# wire boundary (not just in unit-test logic).
|
|
#
|
|
# Default `cargo test --workspace` does not run these tests because they
|
|
# require a broker and pull rumqttc into the build. This workflow opts
|
|
# into both by setting --features mqtt and RUVIEW_RUN_INTEGRATION=1.
|
|
|
|
on:
|
|
pull_request:
|
|
paths:
|
|
- 'v2/crates/wifi-densepose-sensing-server/src/mqtt/**'
|
|
- 'v2/crates/wifi-densepose-sensing-server/tests/mqtt_integration.rs'
|
|
- 'v2/crates/wifi-densepose-sensing-server/Cargo.toml'
|
|
- '.github/workflows/mqtt-integration.yml'
|
|
push:
|
|
branches: [main]
|
|
paths:
|
|
- 'v2/crates/wifi-densepose-sensing-server/src/mqtt/**'
|
|
workflow_dispatch: {}
|
|
|
|
jobs:
|
|
mqtt-integration:
|
|
runs-on: ubuntu-latest
|
|
timeout-minutes: 20
|
|
|
|
# NB: we don't use a `services:` mosquitto container here because the
|
|
# eclipse-mosquitto:2.x image rejects anonymous connections by default
|
|
# and GH Actions `services` doesn't easily support mounting a custom
|
|
# config file. We start mosquitto manually in a step below with an
|
|
# inline `allow_anonymous true` config.
|
|
|
|
env:
|
|
RUVIEW_RUN_INTEGRATION: "1"
|
|
RUVIEW_TEST_MQTT_PORT: "11883"
|
|
CARGO_TERM_COLOR: always
|
|
RUST_BACKTRACE: 1
|
|
|
|
steps:
|
|
- uses: actions/checkout@v4
|
|
|
|
- name: Install mosquitto + clients and start with allow_anonymous
|
|
run: |
|
|
sudo apt-get update -qq
|
|
sudo apt-get install -y mosquitto mosquitto-clients
|
|
sudo systemctl stop mosquitto || true
|
|
# Inline config: anon listener on 11883 only — no TLS, no auth,
|
|
# OK for CI because we test the wire shape, not security.
|
|
# Production deployments enable mTLS per ADR-115 §3.9.
|
|
cat > /tmp/mosquitto-ci.conf <<'EOF'
|
|
listener 11883
|
|
allow_anonymous true
|
|
persistence false
|
|
log_dest stdout
|
|
EOF
|
|
mosquitto -c /tmp/mosquitto-ci.conf -d
|
|
for i in {1..20}; do
|
|
if mosquitto_pub -h 127.0.0.1 -p 11883 -t healthcheck -m ok -q 0 2>/dev/null; then
|
|
echo "mosquitto reachable on 11883"; exit 0
|
|
fi
|
|
sleep 2
|
|
done
|
|
echo "mosquitto never became reachable" >&2
|
|
tail -50 /var/log/mosquitto/*.log 2>/dev/null || true
|
|
exit 1
|
|
|
|
- name: Install Rust toolchain
|
|
uses: dtolnay/rust-toolchain@stable
|
|
with:
|
|
toolchain: stable
|
|
|
|
- name: Cache cargo registry + build
|
|
uses: Swatinem/rust-cache@v2
|
|
with:
|
|
workspaces: v2 -> target
|
|
|
|
- name: Validate HA Blueprints
|
|
run: |
|
|
python -m pip install --quiet pyyaml
|
|
python scripts/validate-ha-blueprints.py
|
|
|
|
- name: Verify unit tests still pass under --features mqtt
|
|
working-directory: v2
|
|
# `cargo test` accepts a single TESTNAME filter, so we run the
|
|
# whole --lib suite here. That gives us the full 410-test green
|
|
# bar under --features mqtt (which is more reassuring than
|
|
# filtering anyway).
|
|
run: >-
|
|
cargo test -p wifi-densepose-sensing-server
|
|
--features mqtt --no-default-features
|
|
--lib
|
|
--no-fail-fast
|
|
|
|
- name: Run integration tests against mosquitto
|
|
working-directory: v2
|
|
run: >-
|
|
cargo test -p wifi-densepose-sensing-server
|
|
--features mqtt --no-default-features
|
|
--test mqtt_integration
|
|
--no-fail-fast
|
|
-- --test-threads=1 --nocapture
|
|
|
|
- name: Dump broker logs on failure
|
|
if: failure()
|
|
run: |
|
|
docker ps -a
|
|
docker logs $(docker ps -aqf "ancestor=eclipse-mosquitto:2.0.18") || true
|