Files

rUv 9bbe95648c feat: ADR-024 Contrastive CSI Embedding Model — all 7 phases (#52 )

Full implementation of Project AETHER — Contrastive CSI Embedding Model.

## Phases Delivered
1. ProjectionHead (64→128→128) + L2 normalization
2. CsiAugmenter (5 physically-motivated augmentations)
3. InfoNCE contrastive loss + SimCLR pretraining
4. FingerprintIndex (4 index types: env, activity, temporal, person)
5. RVF SEG_EMBED (0x0C) + CLI integration
6. Cross-modal alignment (PoseEncoder + InfoNCE)
7. Deep RuVector: MicroLoRA, EWC++, drift detection, hard-negative mining, SEG_LORA

## Stats
- 276 tests passing (191 lib + 51 bin + 16 rvf + 18 vitals)
- 3,342 additions across 8 files
- Zero unsafe/unwrap/panic/todo stubs
- ~55KB INT8 model for ESP32 edge deployment

Also fixes deprecated GitHub Actions (v3→v4) and adds feat/* branch CI triggers.

Closes #50

2026-03-01 01:44:38 -05:00

2.7 KiB

Raw Blame History

wifi-densepose-api

REST and WebSocket API layer for the WiFi-DensePose pose estimation system.

Overview

wifi-densepose-api provides the HTTP service boundary for WiFi-DensePose. Built on axum, it exposes REST endpoints for pose queries, CSI frame ingestion, and model management, plus a WebSocket feed for real-time pose streaming to frontend clients.

Status: This crate is currently a stub. The intended API surface is documented below.

Planned Features

REST endpoints -- CRUD for scan zones, pose queries, model configuration, and health checks.
WebSocket streaming -- Real-time pose estimate broadcasts with per-client subscription filters.
Authentication -- Token-based auth middleware via tower layers.
Rate limiting -- Configurable per-route limits to protect hardware-constrained deployments.
OpenAPI spec -- Auto-generated documentation via utoipa.
CORS -- Configurable cross-origin support for browser-based dashboards.
Graceful shutdown -- Clean connection draining on SIGTERM.

Quick Start

// Intended usage (not yet implemented)
use wifi_densepose_api::Server;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let server = Server::builder()
        .bind("0.0.0.0:3000")
        .with_websocket("/ws/poses")
        .build()
        .await?;

    server.run().await
}

Planned Endpoints

Method	Path	Description
`GET`	`/api/v1/health`	Liveness and readiness probes
`GET`	`/api/v1/poses`	Latest pose estimates
`POST`	`/api/v1/csi`	Ingest raw CSI frames
`GET`	`/api/v1/zones`	List scan zones
`POST`	`/api/v1/zones`	Create a scan zone
`WS`	`/ws/poses`	Real-time pose stream
`WS`	`/ws/vitals`	Real-time vital sign stream

Crate	Role
`wifi-densepose-core`	Shared types and traits
`wifi-densepose-config`	Configuration loading
`wifi-densepose-db`	Database persistence
`wifi-densepose-nn`	Neural network inference
`wifi-densepose-signal`	CSI signal processing
`wifi-densepose-sensing-server`	Lightweight sensing UI server

License

MIT OR Apache-2.0

2.7 KiB Raw Blame History