vrr/Ruview
2
0
Fork 0
mirror of https://github.com/ruvnet/RuView.git synced 2026-04-28 05:59:32 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 10

chore(repo): move v1/ → archive/v1/ + add archive/README.md (#430)

Browse source 
The Rust port at v2/ has been the primary codebase since the rename
in #427. The Python implementation at v1/ is no longer the active
target; the only load-bearing path is the deterministic proof bundle
at v1/data/proof/ (per ADR-011 / ADR-028 witness verification).

Move the whole Python tree into archive/v1/ and document the policy
in archive/README.md: no new features, bug fixes only when they affect
a still-load-bearing path (currently just the proof), CI continues to
verify the proof on every push and PR.

Path references updated in 26 files via path-pattern sed (only
matches v1/<known-child> patterns, never bare v1 or API URLs like
/api/v1/). Two double-prefix typos (archive/archive/v1/) caught and
hand-fixed in verify-pipeline.yml and ADR-011.

Validated:
- Python proof verify.py imports cleanly at archive/v1/data/proof/
  (numpy/scipy still required; CI installs requirements-lock.txt
  from archive/v1/ now)
- cargo test --workspace --no-default-features → 1,539 passed,
  0 failed, 8 ignored (unaffected by Python tree relocation)
- ESP32-S3 on COM7 untouched (no firmware paths changed)

After-merge: contributors should re-run any local `python v1/...`
commands as `python archive/v1/...` (CLAUDE.md and CHANGELOG already
updated).
This commit is contained in:
rUv 2026-04-25 23:07:52 -04:00 • committed by GitHub
parent 74233cfb23
commit 81cc241b9e
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
183 changed files with 290 additions and 216 deletions
Download patch file Download diff file Expand all files Collapse all files

24
docs/build-guide.md
View file

@ -29,7 +29,7 @@ This runs three phases:
1. **Environment checks** -- confirms Python, numpy, scipy, and proof files are present.
2. **Proof pipeline replay** -- feeds a published reference signal through the full signal processing chain (noise filtering, Hamming windowing, amplitude normalization, FFT-based Doppler extraction, power spectral density via scipy.fft) and computes a SHA-256 hash of the output.
3. **Production code integrity scan** -- scans `v1/src/` for `np.random.rand` / `np.random.randn` calls in production code (test helpers are excluded).
3. **Production code integrity scan** -- scans `archive/v1/src/` for `np.random.rand` / `np.random.randn` calls in production code (test helpers are excluded).
Exit codes:
- `0` PASS -- pipeline hash matches the published expected hash
@ -51,7 +51,7 @@ make verify-audit
If the expected hash file is missing, regenerate it:
```bash
python3 v1/data/proof/verify.py --generate-hash
python3 archive/v1/data/proof/verify.py --generate-hash
```
### Minimal dependencies for verification only
@ -63,7 +63,7 @@ pip install numpy==1.26.4 scipy==1.14.1
Or install the pinned set that guarantees hash reproducibility:
```bash
pip install -r v1/requirements-lock.txt
pip install -r archive/v1/requirements-lock.txt
```
The lock file pins: `numpy==1.26.4`, `scipy==1.14.1`, `pydantic==2.10.4`, `pydantic-settings==2.7.1`.
@ -82,7 +82,7 @@ The Python pipeline lives under `v1/` and provides the full API server, signal p
### Install (verification-only -- lightweight)
```bash
pip install -r v1/requirements-lock.txt
pip install -r archive/v1/requirements-lock.txt
```
This installs only the four packages needed for deterministic pipeline verification.
@ -98,7 +98,7 @@ This pulls in FastAPI, uvicorn, torch, OpenCV, SQLAlchemy, Redis client, and all
### Verify the pipeline
```bash
python3 v1/data/proof/verify.py
python3 archive/v1/data/proof/verify.py
```
Same as `./verify` but calls the Python script directly, skipping the bash wrapper's codebase scan phase.
@ -124,7 +124,7 @@ uvicorn v1.src.api.main:app --host 0.0.0.0 --port 8000 --reload
### Run with commodity WiFi (RSSI sensing -- no custom hardware)
The commodity sensing module (`v1/src/sensing/`) extracts presence and motion features from standard Linux WiFi metrics (RSSI, noise floor, link quality) without any hardware modification. See [ADR-013](adr/ADR-013-feature-level-sensing-commodity-gear.md) for full design details.
The commodity sensing module (`archive/v1/src/sensing/`) extracts presence and motion features from standard Linux WiFi metrics (RSSI, noise floor, link quality) without any hardware modification. See [ADR-013](adr/ADR-013-feature-level-sensing-commodity-gear.md) for full design details.
Requirements:
- Any Linux machine with a WiFi interface (laptop, Raspberry Pi, etc.)
@ -667,13 +667,13 @@ python3 -m http.server 3000 --directory ui
|------|---------|
| `./verify` | Trust kill switch -- one-command pipeline proof |
| `Makefile` | `make verify`, `make verify-verbose`, `make verify-audit` |
| `v1/requirements-lock.txt` | Pinned Python deps for hash reproducibility |
| `archive/v1/requirements-lock.txt` | Pinned Python deps for hash reproducibility |
| `requirements.txt` | Full Python deps (API server, torch, etc.) |
| `v1/data/proof/verify.py` | Python verification script |
| `v1/data/proof/sample_csi_data.json` | Deterministic reference signal |
| `v1/data/proof/expected_features.sha256` | Published expected hash |
| `v1/src/api/main.py` | FastAPI application entry point |
| `v1/src/sensing/` | Commodity WiFi sensing module (RSSI) |
| `archive/v1/data/proof/verify.py` | Python verification script |
| `archive/v1/data/proof/sample_csi_data.json` | Deterministic reference signal |
| `archive/v1/data/proof/expected_features.sha256` | Published expected hash |
| `archive/v1/src/api/main.py` | FastAPI application entry point |
| `archive/v1/src/sensing/` | Commodity WiFi sensing module (RSSI) |
| `v2/Cargo.toml` | Rust workspace root |
| `ui/viz.html` | Three.js 3D visualization |
| `Dockerfile` | Multi-stage Docker build (dev/prod/test/security) |