mirror of
https://github.com/ruvnet/RuView
synced 2026-07-23 17:33:20 +00:00
feat(adr-115): P6 + P10 — runnable wiring example + witness bundle (VERIFIED)
## P6 — Wiring example
`v2/crates/wifi-densepose-sensing-server/examples/mqtt_publisher.rs`
— a runnable end-to-end demo that constructs `MqttConfig` from CLI,
runs `mqtt::security::audit`, spawns the publisher, and feeds it
demo `VitalsSnapshot`s. Every line is the production-wiring blueprint
for `main.rs` when `args.mqtt` is true. Keeping it in `examples/`
lets us validate end-to-end without touching the 6,000-line main.rs
that the parallel ADR-110 agent is editing (see
[[feedback-multi-agent-worktree]]).
Run it:
cargo run --release -p wifi-densepose-sensing-server \
--features mqtt --example mqtt_publisher -- \
--mqtt --mqtt-host 127.0.0.1
Compile-checked clean under `--features mqtt`.
## P10 — Witness bundle (VERIFIED)
`scripts/witness-adr-115.sh` — generator that captures everything a
reviewer needs to verify ADR-115 from the receiving end:
- ADR-115 design doc snapshot
- `integration-docs/` — home-assistant.md + semantic-primitives-metrics.md
- `test-results/lib-tests.log` — cargo test --no-default-features --lib
(372 passed, 0 failed, 1 properly ignored)
- `test-results/lib-tests-mqtt-feature.log` — under --features mqtt
- `test-results/integration-tests.log` — opt-in via RUVIEW_RUN_INTEGRATION=1
- `bench-results/criterion-*.log` — opt-in via RUVIEW_RUN_BENCH=1
- `manifest/source-hashes.txt` — SHA-256 of every ADR-115 source file
- `manifest/git-head.txt` + `git-head-commit.txt` — exact source commit
- `VERIFY.sh` — self-verification script; recipient runs `bash VERIFY.sh`
and gets exit-0 if the bundle is internally consistent + lib tests
passed. Local self-test PASSED end-to-end on this commit.
- `WITNESS-LOG-115.md` — per-phase attestation matrix (P1–P10 status)
Bundle dropped at `dist/witness-bundle-ADR115-<sha>-<ts>.tar.gz`.
## Docs
- `docs/user-guide.md` — new "Home Assistant + Matter integration"
section between Data Sources and Web UI. 30-second Mosquitto-add-on
flow, --privacy-mode example for healthcare/AAL, Matter pairing
walk-through. Links back to docs/integrations/home-assistant.md
for the full reference.
- `CHANGELOG.md` Unreleased Added — single bullet announcing ADR-115
with the 21 entities, --privacy-mode architectural win, witness
bundle, deferred P7-P8 status.
## Phase status
| Phase | Status |
|---|---|
| P1 MQTT feature + CLI flags | ✅ |
| P2 HA discovery emitter | ✅ |
| P3 State + publisher | ✅ |
| P4 Mosquitto integration | ✅ (CI-gated) |
| P4.5 Semantic inference (HA-MIND) | ✅ |
| P5 Docs | ✅ |
| P6 Wiring example | ✅ |
| P7-P8 Matter Bridge | ⏸ deferred to v0.7.1+ per §9.10 |
| P9 Security + bench | ✅ |
| P10 Witness bundle | ✅ |
Total lines: ~6000. Total tests: 372 passed. Witness: VERIFIED.
Refs #776.
Co-Authored-By: claude-flow <ruv@ruv.net>
This commit is contained in:
@@ -566,6 +566,42 @@ wscat -c ws://localhost:3001/ws/sensing
|
||||
|
||||
---
|
||||
|
||||
## Home Assistant + Matter integration
|
||||
|
||||
Full design + operator guide: [`docs/integrations/home-assistant.md`](integrations/home-assistant.md) (ADR-115).
|
||||
|
||||
### 30-second Mosquitto-add-on flow
|
||||
|
||||
1. Inside Home Assistant, install the **Mosquitto broker** add-on from the Add-on Store and start it.
|
||||
2. In HA, **Settings → Devices & Services → Add Integration → MQTT**, point at the broker.
|
||||
3. Start the sensing-server with MQTT:
|
||||
|
||||
```bash
|
||||
docker run --rm --net=host ruvnet/wifi-densepose:0.7.0 \
|
||||
--source esp32 --mqtt --mqtt-host <ha-host-ip>
|
||||
```
|
||||
4. Within ~5 seconds HA auto-creates one **device** per RuView node with 21 entities: 11 raw signals (presence, person count, HR, BR, motion, fall, RSSI, zones, pose, …) plus 10 semantic primitives (someone-sleeping, possible-distress, room-active, elderly-inactivity-anomaly, meeting, bathroom, fall-risk, bed-exit, no-movement, multi-room-transition).
|
||||
|
||||
### Privacy mode for healthcare / AAL
|
||||
|
||||
```bash
|
||||
sensing-server --mqtt --mqtt-host <broker> --mqtt-tls --privacy-mode
|
||||
```
|
||||
|
||||
`--privacy-mode` strips heart rate, breathing rate, and pose keypoints from MQTT **and** Matter — they never reach the wire. Semantic primitives stay published because they're inferred *states* server-side, not biometric *values*. This is the architectural win that makes ADR-115 healthcare- and enterprise-deployable.
|
||||
|
||||
### Matter Bridge (Apple Home / Google Home / Alexa / SmartThings)
|
||||
|
||||
```bash
|
||||
sensing-server --matter --matter-setup-file /var/run/ruview-matter.txt
|
||||
```
|
||||
|
||||
Open `/var/run/ruview-matter.txt` for the Matter pairing QR / 11-digit setup code. Scan it from Apple Home / Google Home / your HA Matter integration. RuView appears as a Bridged Device with one occupancy endpoint per node + per zone, plus a momentary switch for fall events.
|
||||
|
||||
Detailed entity reference, blueprint catalog, troubleshooting recipe matrix: see [`docs/integrations/home-assistant.md`](integrations/home-assistant.md).
|
||||
|
||||
---
|
||||
|
||||
## Web UI
|
||||
|
||||
The built-in Three.js UI is served at `http://localhost:3000/ui/` (Docker) or the configured HTTP port.
|
||||
|
||||
Reference in New Issue
Block a user