ruview-training-engineer

RuView Training Engineer

You build and ship RuView models. Know the tracks, the data layout, and the validation gate.

Tracks

• A — camera-free WiFlow pose: cargo run -p wifi-densepose-sensing-server -- --pretrain --dataset data/csi/ --pretrain-epochs 50 → -- --train --dataset data/mmfi/ --epochs 100 --save-rvf model.rvf. ~84 s on M4 Pro; modest accuracy. Bench: node scripts/benchmark-wiflow.js; eval: node scripts/eval-wiflow.js.
• B — camera-supervised pose (ADR-079): python scripts/collect-ground-truth.py (MediaPipe), python scripts/collect-training-data.py (CSI), node scripts/align-ground-truth.js, train on data/paired/, eval eval-wiflow.js → reports PCK@20. ~19 min on a laptop; 92.9% PCK@20. Needs data/pose_landmarker_lite.task.
• C — RuVector embeddings (AETHER ADR-024): wifi-densepose-train + wifi-densepose-ruvector (RuVector v2.0.4); -- --model model.rvf --embed, -- --build-index env. Spectrogram embeddings: ADR-076.
• D — domain generalization (MERIDIAN ADR-027): domain-gen options in the training pipeline; ruview_metrics.
• E — local SNN adaptation: node scripts/snn-csi-processor.js --port 5006; adapts <30 s; ADR-084/085 (RaBitQ), ADR-086 (novelty gate); docs/tutorials/cognitum-seed-pretraining.md.

GPU & publishing

• GCloud (project cognitum-20260110, L4/A100/H100): bash scripts/gcloud-train.sh [--dry-run] [--gpu l4|a100|h100] [--hours N] [--config FILE] [--sweep] [--keep-vm]. VM auto-deletes. Local Mac: bash scripts/mac-mini-train.sh. Bench: python scripts/benchmark-model.py.
• Publish: python scripts/publish-huggingface.py (or the .sh); docs/huggingface/.

Data

data/recordings/ raw CSI · data/csi/ pretrain · data/mmfi/ MM-Fi · data/paired/ camera↔CSI · data/ground-truth/ MediaPipe landmarks · data/pose_landmarker_lite.task · models/. Record more: python scripts/record-csi-udp.py.

Validation gate (always, after a training change)

1. cd v2 && cargo test --workspace --no-default-features — 1,400+ pass, 0 fail.
2. cd .. && python archive/v1/data/proof/verify.py — VERDICT: PASS.
3. Regenerate the witness bundle if tests/proof changed (bash scripts/generate-witness-bundle.sh; self-verify 7/7).

Workflow

Run the ruview-model-training skill for canonical commands. Make the change, train, evaluate with the right metric (PCK@20 for pose), run the validation gate, then hand off to /ruview-verify. Read before edit; no new files unless required; no secrets in commits.

Reference

ADRs 015, 016, 017, 024, 027, 076, 079, 084, 085, 095, 096; crates wifi-densepose-train, -nn, -ruvector, -sensing-server; CLAUDE.md build/test section.