Iter 52. PR-readiness pivot iter #3. Closes pre-merge checklist item #6
(user-guide.md update for new setup steps / CLI flags / integrations).
Adds a BFLD subsection inside the existing HA chapter so operators
already reading about HA-DISCO discover BFLD as the natural next layer.
Notes on iter context:
- Local branch was hard-reset earlier in the session (working tree
showed only iters 1-3 state); remote origin/feat/adr-118-bfld-impl
retained the full chain plus a sibling agent's ADR-124 commit
(12586d31a, RUVIEW-POLICY layer + Q4 cache + multi-modal vision).
Recovered local via git reset --hard origin/feat/adr-118-bfld-impl
before this iter. No work lost.
- User redirected to "finish BFLD first" mid-iter, so the ADR-124
pivot (scaffolding tools/ruview-mcp BFLD tool handlers) was stopped.
ADR-124 work remains in the sibling agent's lane on this branch.
Added (in docs/user-guide.md):
- New ### BFLD — privacy-gated WiFi BFI sensing layer (ADR-118)
subsection inside the "Home Assistant + Matter integration" chapter.
- Covers:
* Three structural invariants (I1/I2/I3)
* Minimal + worker-thread runnable example commands
* Production publish lifecycle code snippet
(publish_availability_online → publish_discovery →
BfldPipelineHandle::spawn → handle.send)
* 4 HA entities per node + class-2-only identity_risk note
* Three operator HA blueprints (presence-lighting, motion-hvac,
identity-risk-anomaly) with import path
* Privacy class deployment matrix table (Raw / Derived / Anonymous /
Restricted) with use cases
* MQTT topic tree with all 7 documented topics
* `mqtt` feature gate + rumqttc::connect_with_lwt LWT pre-config note
* Pointers to crate README + research dossier + ADR-118 chain
Added (in v2/crates/wifi-densepose-bfld/tests/user_guide_section.rs):
- 8 named tests via include_str! validating the user-guide section:
user_guide_documents_bfld_section_in_ha_chapter
user_guide_bfld_section_names_three_structural_invariants
user_guide_bfld_section_shows_both_runnable_examples
user_guide_bfld_section_documents_publish_lifecycle (4 symbol checks)
user_guide_bfld_section_documents_four_privacy_classes
user_guide_bfld_section_lists_three_operator_blueprints
user_guide_bfld_section_documents_mqtt_topic_tree (3 topic checks)
user_guide_bfld_section_points_at_companion_artifacts
ADR-124 status (iter step 0 sibling check):
- docs/adr/ADR-124-rvagent-mcp-ruvector-npm-integration.md present.
Sibling agent landed a follow-on commit 12586d31a touching
ADR-124 ("RUVIEW-POLICY layer + Q4 cache resolution + multi-modal
vision"). Scope continues to be orthogonal to BFLD core.
ACs progressed:
- Pre-merge checklist item #6 (CLAUDE.md) — user-guide.md updated.
Operators encountering wifi-densepose for the first time and
reading the canonical user guide now see the BFLD layer documented
alongside HA + Matter, not as a separate document they have to
hunt for.
Test config:
- cargo test --no-default-features → 101 passed (user_guide_section cfg-out)
- cargo test → 345 passed (337 + 8)
Out of scope (next iter target):
- Pre-merge checklist remaining: witness bundle regeneration (#8).
External-resource-gated work (KIT BFId, Pi5/Nexmon) still skipped.
Co-Authored-By: claude-flow <ruv@ruv.net>
f51a045215