mirror of https://github.com/ruvnet/RuView synced 2026-08-11 20:41:44 +00:00

Files

T

Claude 18060b9c77 Add per-deployment adaptive optimization + VEIL npm metaharness (ADR-289)

Two additions on top of the hyper-optimized VEIL shield.

1) Adaptive optimization (v2/crates/wifi-densepose-privshield/src/optimize.rs):
   - optimal_bits_across_snr / model_optimal_bits_for_snr: the throughput-
     optimal feedback resolution shifts with SNR (unconstrained optimum 4 bits
     at 5-10 dB, 3 bits at 20-40 dB); within the spec {5,7,9} set it stays 5,
     which is why the shipped shield is SNR-stable.
   - adaptive_shield / min_passes_for_n: derive a shield for a specific
     deployment. Finding: the collapse budget is N-independent in this model
     (48 passes collapses N in {8,64} alike) — it is set by the fine-subspace
     dimension, not the candidate count. Defaults unchanged, so the proof
     witness is untouched. 38 tests + doctest pass; clippy -D warnings clean.

2) npm metaharness harness/wifi-densepose-privshield/ (ADR-289), mirroring
   wifi-densepose-sar-harness (ADR-286) with two improvements:
   - @metaharness/* imported dynamically inside the commands that need them, so
     `guidance` and `--help` run with ZERO dependencies installed (offline / pre
     `npm install`).
   - a dependency-free VEIL `guidance` command: a source-cited, evidence-
     labelled, read-only capability map (topics: overview, threat,
     countermeasure, compliance, optimization, experiment).
   Standard router + flywheel (SYNTHETIC) + Darwin wiring, tailored to VEIL
   task axes and policy levers. Tests: smoke + router + flywheel (need install)
   and guidance (offline). .harness manifest generated with real per-file
   hashes. Validated offline: cli syntax, --help, guidance topics, exit codes,
   graceful degradation when deps are absent.

Docs: research bundle 08 gains a per-deployment adaptivity section; 07 and the
crate README point at the harness; ADR-289 added and indexed.

Co-Authored-By: claude-flow <ruv@ruv.net>
Claude-Session: https://claude.ai/code/session_01WEXNqzs7UsfNFBcP5yW21p

2026-08-09 14:23:12 +00:00

3.1 KiB

Raw Blame History

wifi-densepose-privshield-harness

Harness for wifi-densepose-privshield (VEIL — the compliant-waveform WiFi-sensing privacy shield, ADR-288). This package is defined by ADR-289.

Advanced Coding harness · domain: software-engineering. Modeled on the wifi-densepose-sar-harness scaffold (ADR-286), generated with create-agent-harness.

Behavioral rules

Use the harness's tools for orchestration; memory and routing are handled by the kernel.
Defer destructive operations to the user.
Never present WiFi sensing as camera-grade, and never relabel VEIL's SYNTHETIC/L0 results as MEASURED — a hardware witness is required first (CLAUDE.md hardware rule; ADR-282 ladder). The harness is a development aid; it does not run a radio and cannot emit RF.
VEIL uses compliant waveform controls only — never jamming. Do not add, suggest, or scaffold interference-based "defenses."

Commands

init — boot the kernel + host adapter.
doctor — verify the install end-to-end (kernel, host, guidance map).
guidance --topic <t> [--query <q>] — read-only VEIL capability map (dependency-free; topics: overview, threat, countermeasure, compliance, optimization, experiment). Source-cited and evidence-labelled; navigation only, not authority.
route <e0> <e1> <e2> <e3> — cost-optimal model routing via @metaharness/router (needs npm run build).
flywheel [generations] — SYNTHETIC self-improvement demo via @metaharness/flywheel (needs npm run build).

Architecture

Uses @metaharness/kernel (Rust-compiled WASM with a NAPI-RS native fallback) so the same code runs on every platform. The @metaharness/* packages are imported dynamically inside the commands that need them, so guidance/--help work with no dependencies installed.

Darwin, router, flywheel

Darwin Mode (@metaharness/darwin, devDependency) — npm run evolve / evolve:dry mutates the harness's own config and keeps only measurable improvements.
Router (@metaharness/router) — src/router.ts wires a real cost-optimal Router (qualityBar: 0.8) over two model tiers. Its labelled examples are illustrative seed data (see the file's honesty note), not measured eval-log observations.
Flywheel (@metaharness/flywheel) — src/flywheel.ts wires the real promotion loop (propose → evaluate → gate → promote, Ed25519-signed, independently replayable) with a SYNTHETIC proposer/evaluator (dataSource: 'SYNTHETIC', no model call). A LIVE run needs a real Proposer and Evaluator supplied by the operator — see the file's comments.

Relationship to the crate

This harness assists development on the VEIL crate; it does not replace the crate's own gates. The authoritative validation for a VEIL change is still:

cargo test -p wifi-densepose-privshield --no-default-features
cargo clippy -p wifi-densepose-privshield --all-targets -- -D warnings

3.1 KiB Raw Blame History