Knowledge Base updated: 2026-11-19
Knowledge Base Index
Orientation
ruvnet/ruview is a multi-surface WiFi sensing, spatial intelligence, governance, and Homecore automation repository. The highest-level flow is: hardware/CSI capture and scripts feed WiFi DensePose/Ruview processing, which surfaces results through Rust runtimes, Python bindings, dashboards, integrations, and deployment/observability assets.
Main parts:
v2/Rust workspace — Homecore, Ruview governance/spatial intelligence, WiFi DensePose processing, runtime apps, and neural/model crates.python/— Python package and Rust extension bindings.dashboard/andui/— TypeScript/Vite and legacy browser UIs for live data, control, and visualization.scripts/,tools/,benchmarks/,data/— collection, training, replay, benchmark, proof, release, and operational flows.firmware/and hardware harnesses — embedded ESP32/OpenWrt/PrivShield targets and validation paths.integrations/,plugins/,monitoring/,logging/,wifi-veil/— external integrations, plugin packaging, observability/deployment, and a standalone subproject.
Critical state is mostly file/workspace based in this repository: datasets and generated fixtures under data/, aether-arena/fixtures/, and benchmark artifacts; model/training and replay inputs under scripts/, benchmarks/, and v2/examples/; operational configuration under monitoring/, logging/, docker/, and integration/plugin directories.
Architecture diagrams
flowchart TD
subgraph Hardware
FW[firmware]
Harness[harness]
end
subgraph Processing
DensePose[v2 wifi-densepose crates]
Ruview[ruview kernel and spatial crates]
Homecore[homecore crates]
end
subgraph Apps
Runtime[CLI desktop server WASM]
Python[python bindings]
Dashboard[dashboard]
LegacyUI[ui]
end
subgraph Ops
Scripts[scripts tools benchmarks]
Integrations[integrations plugins]
Observability[monitoring logging docker]
WifiVeil[wifi-veil]
end
FW --> Harness
Harness --> DensePose
Scripts --> DensePose
DensePose --> Ruview
Ruview --> Homecore
DensePose --> Runtime
Ruview --> Runtime
Runtime --> Python
Runtime --> Dashboard
Runtime --> LegacyUI
Runtime --> Integrations
Observability --> Runtime
WifiVeil --> Ops
flowchart LR
CSI[CSI and RF inputs] --> Firmware[ESP32 OpenWrt PrivShield firmware]
Firmware --> Capture[scripts capture relay replay]
Capture --> Signal[v2 wifi-densepose signal core engine]
Signal --> Inference[pose occupancy vitals models]
Inference --> RuviewState[ruview tracks spatial memory evidence]
RuviewState --> Apps[servers UI Python integrations]
flowchart TD
Evidence[observations and evidence] --> Kernel[ruview-kernel]
Kernel --> Auth[auth attest certify witness]
Kernel --> Policy[policy scorecard]
Kernel --> Spatial[fusion track memory twin]
Policy --> Unified[ruview-unified]
Spatial --> Unified
Unified --> Consumers[Homecore apps dashboards integrations]
flowchart LR
Scripts[collection training scripts] --> Data[data benchmarks fixtures]
Data --> Train[v2 train nn occworld]
Train --> Runtime[wifi-densepose runtime crates]
Runtime --> Web[dashboard and ui]
Runtime --> Python[python package]
Runtime --> Deploy[integrations plugins monitoring]
Glossary
- Ruview — the repository’s core sensing, evidence, governance, and spatial-intelligence system.
- WiFi DensePose — WiFi/RF-based sensing stack for pose, occupancy, vitals, calibration, and related inference.
- Homecore — automation/server/plugin platform crates in
v2/crates/homecore*. - PrivShield — privacy-preserving hardware/firmware and DensePose subsystem used across firmware and
wifi-densepose-privshieldpaths. - Aether Arena — calibration/space/ledger assets under
aether-arena/and related DensePose/Ruview support paths.
Codebase-wide invariants
- The primary Rust workspace is organized under v2/Cargo.toml with member crates in
v2/crates/**; separate Rust package surfaces also exist under python/Cargo.toml and wifi-veil/Cargo.toml. - Browser-facing code is split between a Vite/TypeScript app in
dashboard/(dashboard/package.json,dashboard/src/**) and a legacy/static UI inui/(ui/app.js,ui/components/**,ui/services/**). - Operational flows are script-first and live mostly under
scripts/**, with root orchestration helpers inMakefile, install.sh, deploy.sh, andverify. - Embedded and hardware-specific code is separated from desktop/server runtimes under
firmware/**, with validation and QEMU helpers in scripts/qemu*.sh, scripts/qemu_swarm.py, and ESP32-related scripts.
Routing table
-
v2/Cargo.toml, v2/Cargo.lock, v2/rust-toolchain.toml -> docs/v2-homecore-platform.md
-
v2/crates/homecore*/**-> docs/v2-homecore-platform.md -
v2/crates/cog-*/**-> docs/v2-homecore-platform.md -
v2/crates/nvsim*/**-> docs/v2-homecore-platform.md -
harness/homecore/**,harness/ruview-umbrella/**-> docs/v2-homecore-platform.md -
examples/**, tests/test_invariant_Cargo.py -> docs/v2-homecore-platform.md -
any Homecore server, API, automation, plugin, recorder, HAP/Matter, assist, migration, or simulation change -> docs/v2-homecore-platform.md
-
v2/crates/ruview-kernel/**,v2/crates/ruview-kernel-napi/**-> docs/v2-ruview-kernel-governance.md -
v2/crates/ruview-auth/**,v2/crates/ruview-attest/**,v2/crates/ruview-certify/**-> docs/v2-ruview-kernel-governance.md -
v2/crates/ruview-evidence/**,v2/crates/ruview-witness/**,v2/crates/ruview-policy/**,v2/crates/ruview-scorecard/**-> docs/v2-ruview-kernel-governance.md -
v2/crates/ruview-unified/**,v2/crates/ruview-hal/**-> docs/v2-ruview-kernel-governance.md -
harness/ruview-kernel/**,harness/ruview/**, PROOF.md -> docs/v2-ruview-kernel-governance.md -
any Ruview trust, policy, proof, evidence, witness, or certification change -> docs/v2-ruview-kernel-governance.md
-
v2/crates/ruview-fusion/**,v2/crates/ruview-track/**-> docs/v2-ruview-spatial-intelligence.md -
v2/crates/ruview-spatial-memory/**,v2/crates/ruview-spatial-evidence/**,v2/crates/ruview-ontology/**,v2/crates/ruview-twin/**-> docs/v2-ruview-spatial-intelligence.md -
v2/crates/ruview-memory/**,v2/crates/ruview-active/**,v2/crates/ruview-infogain/**,v2/crates/ruview-survey/**,v2/crates/ruview-placement/**-> docs/v2-ruview-spatial-intelligence.md -
v2/crates/ruview-offaxis/**,v2/crates/ruview-ood/**,v2/crates/ruview-counterfactual/**,v2/crates/ruview-cognitum-spaces/**,v2/crates/worldgraph/**-> docs/v2-ruview-spatial-intelligence.md -
any observation-to-track, spatial memory, world graph, twin, survey, placement, or active sensing change -> docs/v2-ruview-spatial-intelligence.md
-
v2/crates/wifi-densepose-core/**,v2/crates/wifi-densepose-signal/**,v2/crates/wifi-densepose-engine/**-> docs/v2-wifi-densepose-core-pipeline.md -
v2/crates/wifi-densepose-physics/**,v2/crates/wifi-densepose-calibration/**,v2/crates/wifi-densepose-hardware/**,v2/crates/wifi-densepose-wifiscan/**-> docs/v2-wifi-densepose-core-pipeline.md -
v2/crates/wifi-densepose-mat/**,v2/crates/wifi-densepose-pointcloud/**,v2/crates/wifi-densepose-vitals/**,v2/crates/wifi-densepose-privshield/**-> docs/v2-wifi-densepose-core-pipeline.md -
v2/crates/wifi-densepose-sar/**,v2/crates/wifi-densepose-bfld/**,v2/crates/wifi-densepose-rufield/**,v2/crates/wifi-densepose-ruvector/**,v2/crates/wifi-densepose-aether/**-> docs/v2-wifi-densepose-core-pipeline.md -
harness/wifi-densepose-privshield/**,harness/wifi-densepose-sar/**-> docs/v2-wifi-densepose-core-pipeline.md -
any CSI/RF signal ingestion, calibration, feature extraction, pose/occupancy/vitals inference, or DensePose privacy/SAR pipeline change -> docs/v2-wifi-densepose-core-pipeline.md
-
v2/crates/wifi-densepose-cli/**,v2/crates/wifi-densepose-desktop/**,v2/crates/wifi-densepose-sensing-server/**-> docs/v2-wifi-densepose-runtime-apps.md -
v2/crates/wifi-densepose-wasm/**,v2/crates/wifi-densepose-wasm-edge/**-> docs/v2-wifi-densepose-runtime-apps.md -
v2/crates/wifi-densepose-train/**,v2/crates/wifi-densepose-nn/**,v2/crates/wifi-densepose-occworld-candle/**,v2/crates/wifi-densepose-mtk-bridge/**-> docs/v2-wifi-densepose-runtime-apps.md -
v2/crates/ruv-neural/**,v2/crates/ruview-fann-head/**-> docs/v2-wifi-densepose-runtime-apps.md -
v2/docs/**,v2/examples/**,v2/patches/**-> docs/v2-wifi-densepose-runtime-apps.md -
any WiFi DensePose executable, model training/loading, MTK bridge, server protocol, WASM, desktop, or CLI change -> docs/v2-wifi-densepose-runtime-apps.md
-
python/Cargo.toml, python/Cargo.lock, python/pyproject.toml, python/README.md -> docs/python-bindings-package.md
-
python/src/**,python/ruview-meta/**,python/wifi_densepose/**,python/examples/**,python/tests/**,python/bench/**,python/tombstone/**-> docs/python-bindings-package.md -
wifi_densepose/**, pyproject.toml, requirements*.txt -> docs/python-bindings-package.md -
any Python API, Rust/Python binding, package build, Python example, or Python benchmark change -> docs/python-bindings-package.md
-
dashboard/package.json, dashboard/package-lock.json, dashboard/index.html, dashboard/vite.config.ts, dashboard/tsconfig.json, dashboard/playwright.config.ts -> docs/dashboard-web-app.md
-
dashboard/src/**,dashboard/public/**,dashboard/tests/**-> docs/dashboard-web-app.md -
any Vite dashboard component, store, transport, API/WebSocket, or Playwright test change -> docs/dashboard-web-app.md
-
ui/index.html, ui/app.js, ui/style.css, ui/manifest.json, ui/sw.js, ui/*.html, ui/*.mjs -> docs/legacy-ui-and-observatory.md
-
ui/components/**,ui/services/**,ui/utils/**,ui/config/**,ui/icons/**-> docs/legacy-ui-and-observatory.md -
ui/mobile/**,ui/observatory/**,ui/pose-fusion/**,ui/tests/**, ui/README.md, ui/TEST_REPORT.md -> docs/legacy-ui-and-observatory.md -
any legacy UI tab/component/service worker, streaming/WebSocket service, observatory, pose-fusion, mobile, or visualization change -> docs/legacy-ui-and-observatory.md
-
scripts/**,tools/**,benchmarks/**,data/**,templates/**-> docs/scripts-data-training-operations.md -
benchmark_baseline.json,
Makefile, install.sh, deploy.sh,verify-> docs/scripts-data-training-operations.md -
any data collection, replay, training, benchmarking, proof verification, QEMU helper, release helper, cloud helper, or operational script change -> docs/scripts-data-training-operations.md
-
firmware/**-> docs/firmware-and-hardware-targets.md -
docker/**-> docs/firmware-and-hardware-targets.md -
scripts/firmware-release-guard.sh, scripts/validate-esp32-mqtt.sh, scripts/esp32_*.py, scripts/generate_nvs_matrix.py -> docs/firmware-and-hardware-targets.md
-
scripts/install-qemu.sh, scripts/qemu*.sh, scripts/qemu_swarm.py, scripts/validate_qemu_output.py -> docs/firmware-and-hardware-targets.md
-
any ESP32 CSI, OpenWrt, PrivShield firmware, hardware telemetry protocol, embedded build/deploy, or hardware validation change -> docs/firmware-and-hardware-targets.md
-
integrations/**,plugins/**-> docs/integrations-plugins-and-deployment.md -
monitoring/**,logging/**,semconv/**,releases/**,archive/**,references/**-> docs/integrations-plugins-and-deployment.md -
.github/**,.dockerignore,docker/**, CHANGELOG.md,NOTICE,LICENSE-> docs/integrations-plugins-and-deployment.md -
any external integration, plugin packaging, observability, deployment metadata, release, or repository automation change -> docs/integrations-plugins-and-deployment.md
-
wifi-veil/**-> docs/wifi-veil-subproject.md -
any WiFi Veil Rust crate, firmware, harness, scripts, UI, docs, or subproject CI/config change -> docs/wifi-veil-subproject.md