From 44b9c30dbc5e59d5d07d29ff153a463bb7b7a5ef Mon Sep 17 00:00:00 2001
From: ruv <ruv@ruv.net>
Date: Sun, 1 Mar 2026 00:56:41 -0500
Subject: [PATCH] =?UTF-8?q?fix:=20Docker=20port=20mismatch=20=E2=80=94=20s?=
 =?UTF-8?q?erver=20now=20binds=203000/3001=20as=20documented?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The sensing server defaults to HTTP :8080 and WS :8765, but Docker
exposes :3000/:3001. Added --http-port 3000 --ws-port 3001 to CMD
in both Dockerfile.rust and docker-compose.yml.

Verified both images build and run:
- Rust: 133 MB, all endpoints responding (health, sensing/latest,
  vital-signs, pose/current, info, model/info, UI)
- Python: 569 MB, all packages importable (websockets, fastapi)
- RVF file: 13 KB, valid RVFS magic bytes

Also fixed README Quick Start endpoints to match actual routes:
- /api/v1/health → /health
- /api/v1/sensing → /api/v1/sensing/latest
- Added /api/v1/pose/current and /api/v1/info examples
- Added port mapping note for Docker vs local dev

Co-Authored-By: claude-flow <ruv@ruv.net>
---
 README.md                 | 12 ++++++++++--
 docker/Dockerfile.rust    |  2 +-
 docker/docker-compose.yml |  2 +-
 3 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index f179a52..7173833 100644
--- a/README.md
+++ b/README.md
@@ -271,13 +271,19 @@ system.stop()
 
 ```bash
 # Health check
-curl http://localhost:3000/api/v1/health
+curl http://localhost:3000/health
 
 # Latest sensing frame
-curl http://localhost:3000/api/v1/sensing
+curl http://localhost:3000/api/v1/sensing/latest
 
 # Vital signs
 curl http://localhost:3000/api/v1/vital-signs
+
+# Pose estimation
+curl http://localhost:3000/api/v1/pose/current
+
+# Server info
+curl http://localhost:3000/api/v1/info
 ```
 
 ### 4. Real-time WebSocket
@@ -942,6 +948,8 @@ POST /api/v1/model/sona/activate  # Activate SONA profile
 
 WebSocket: `ws://localhost:8765/ws/sensing` (real-time sensing + vital signs)
 
+> Default ports: HTTP 8080, WS 8765. Docker images remap to 3000/3001 via `--http-port` / `--ws-port`.
+
 </details>
 
 <details>
diff --git a/docker/Dockerfile.rust b/docker/Dockerfile.rust
index 603cd1b..cb6e781 100644
--- a/docker/Dockerfile.rust
+++ b/docker/Dockerfile.rust
@@ -43,4 +43,4 @@ EXPOSE 5005/udp
 ENV RUST_LOG=info
 
 ENTRYPOINT ["/app/sensing-server"]
-CMD ["--source", "simulated", "--tick-ms", "100", "--ui-path", "/app/ui"]
+CMD ["--source", "simulated", "--tick-ms", "100", "--ui-path", "/app/ui", "--http-port", "3000", "--ws-port", "3001"]
diff --git a/docker/docker-compose.yml b/docker/docker-compose.yml
index 311ba66..1932667 100644
--- a/docker/docker-compose.yml
+++ b/docker/docker-compose.yml
@@ -12,7 +12,7 @@ services:
       - "5005:5005/udp"  # ESP32 UDP
     environment:
       - RUST_LOG=info
-    command: ["--source", "simulated", "--tick-ms", "100", "--ui-path", "/app/ui"]
+    command: ["--source", "simulated", "--tick-ms", "100", "--ui-path", "/app/ui", "--http-port", "3000", "--ws-port", "3001"]
 
   python-sensing:
     build: