Skip to content
cccskills
FreePublished on GitHub

ruview-verify

Verify RuView changes with Rust and Python tests, output hashes that detect processing changes, and firmware hash records. Packages test logs and audit evidence into a witness bundle that recipients can check with a single command.

OriginalShow the original description

Verify a RuView build — full Rust workspace tests, the deterministic Python pipeline proof (SHA-256 Trust Kill Switch), firmware hash manifest, and the ADR-028 witness bundle with one-command self-verification. Use after any significant change, before merging a PR, or to produce an attestation bundle for a recipient.

ruvnet/RuView
See how to install

Good for

  • Verify a RuView build after significant changes
  • Check tests and documentation before merging a PR
  • Prepare a verification bundle for a recipient
  • Detect changes in Python pipeline output

Files included (1)

  • SKILL.md4.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

RuView Verification & Witness Bundle

The trust pipeline for RuView. Run this after meaningful changes and before merging.

1. Rust workspace tests

cd v2
cargo test --workspace --no-default-features        # must be 1,400+ passed, 0 failed (~2 min)

Single-crate checks (no GPU): cargo check -p wifi-densepose-train --no-default-features, cargo test -p wifi-densepose-signal --no-default-features, etc.

2. Deterministic Python proof (Trust Kill Switch)

Feeds a reference CSI signal through the production pipeline and hashes the output. Any behavioural drift changes the hash.

cd ..
python archive/v1/data/proof/verify.py              # must print VERDICT: PASS

If it fails on a hash mismatch after a legitimate numpy/scipy bump:

python archive/v1/data/proof/verify.py --generate-hash
python archive/v1/data/proof/verify.py

Artifacts: archive/v1/data/proof/verify.py, expected_features.sha256, sample_csi_data.json (1,000 synthetic frames, seed=42).

3. Python test suite (v1)

cd archive/v1 && python -m pytest tests/ -x -q

4. Generate the witness bundle (ADR-028)

bash scripts/generate-witness-bundle.sh

Produces dist/witness-bundle-ADR028-<sha>.tar.gz containing:

  • WITNESS-LOG-028.md — 33-row attestation matrix, evidence per capability
  • ADR-028-esp32-capability-audit.md — full audit findings
  • proof/verify.py + expected_features.sha256 — the deterministic proof
  • test-results/rust-workspace-tests.log — full cargo test output
  • firmware-manifest/source-hashes.txt — SHA-256 of all 7 ESP32 firmware files
  • crate-manifest/versions.txt — all 15 crates + versions
  • VERIFY.sh — one-command self-verification for recipients

5. Self-verify the bundle

cd dist/witness-bundle-ADR028-*/
bash VERIFY.sh                                       # must be 7/7 PASS

Pre-merge checklist (from CLAUDE.md)

  1. Rust tests pass (1,400+, 0 fail)
  2. Python proof passes (VERDICT: PASS)
  3. README.md updated if scope changed (platform/crate/hardware tables, feature summaries)
  4. CLAUDE.md updated if scope changed (crate table, ADR list, module tables, version)
  5. CHANGELOG.md — entry under [Unreleased]
  6. docs/user-guide.md updated if new data sources / CLI flags / setup steps
  7. ADR index — bump ADR count in README docs table if a new ADR was added
  8. Witness bundle regenerated if tests or proof hash changed
  9. Docker Hub image rebuilt only if Dockerfile / deps / runtime behaviour changed
  10. Crate publishing only if a published crate's public API changed (publish in dependency order — see CLAUDE.md)
  11. .gitignore updated for new build artifacts/binaries
  12. Security review for new modules touching hardware/network boundaries

Security scan

npx @claude-flow/cli@latest security scan            # after security-related changes

Also see docs/security-audit-wasm-edge-vendor.md, docs/qe-reports/, ADR-080 (QE remediation plan), ADR-093 (dashboard gap analysis).

QEMU firmware CI (ADR-061)

11-job workflow ("Firmware QEMU Tests"). Local QEMU helpers: scripts/qemu-esp32s3-test.sh, qemu-mesh-test.sh, qemu-chaos-test.sh, qemu-snapshot-test.sh, install-qemu.sh. Notes: espressif/idf:v5.4 container needs source $IDF_PATH/export.sh before pip; QEMU needs esptool merge_bin --fill-flash-size 8MB; WARNs (no real WiFi) are treated as OK in CI.

Reference

  • docs/WITNESS-LOG-028.md, docs/adr/ADR-028-esp32-capability-audit.md
  • scripts/generate-witness-bundle.sh, archive/v1/data/proof/verify.py
  • CLAUDE.md → "Validation & Witness Verification" + "Pre-Merge Checklist"
  • CLAUDE.local.md → QEMU CI pipeline fixes

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

AgentDB Advanced Features

FreeSummary

Build advanced AgentDB workflows with database synchronization, multiple databases, and search that combines meaning with attribute filters. Covers similarity measures, diverse search results, and operational patterns for distributed AI applications.

  • Sharing stored patterns across multiple AgentDB instances
  • Filtering semantic search by date or category
  • Separating knowledge and conversation databases
ruvnet/RuView98.7KUpdated Oct 18, 2026

AgentDB Learning Plugins

FreeSummary

Create AgentDB learning plugins that use recorded experience to improve agent decisions. Choose a learning method, store states, actions, and rewards, train models, and evaluate suggested actions through CLI and API workflows.

  • Train agents from historical experience
  • Build decision-making for games and navigation
  • Combine experience from multiple agents for training
ruvnet/RuView98.7KUpdated Oct 18, 2026

AgentDB Memory Patterns

FreeSummary

Build AI agents that retain conversation history, user preferences, and useful interaction patterns with AgentDB. The skill covers persistent storage, meaning memories survive between sessions, plus retrieval, context management, and ReasoningBank integration.

  • Add conversation history to a chat system
  • Remember user preferences across sessions
  • Reuse patterns from successful interactions
ruvnet/RuView98.7KUpdated Oct 18, 2026

AgentDB Performance Optimization

FreeSummary

Tune AgentDB memory use and search speed through quantization, which stores vectors more compactly, search indexes, caching, and batch operations. Includes configuration examples and benchmarks to help balance accuracy, speed, and storage as datasets grow.

  • Reduce memory use in an AgentDB application
  • Tune search speed while preserving accuracy
  • Plan settings for millions of vectors
ruvnet/RuView98.7KUpdated Oct 18, 2026

AgentDB Vector Search

FreeSummary

Build document search with AgentDB that finds related content by meaning. Store documents as numerical representations, combine similarity search with metadata filters, and retrieve relevant passages for systems that generate answers using source material.

  • Build answers grounded in retrieved documents
  • Add meaning-based search to a knowledge base
  • Find documents with similar content
ruvnet/RuView98.7KUpdated Oct 18, 2026

browser

FreeSummary

Automate browser tasks with agent-browser, using snapshots that label page elements for the agent. Handle login flows, fill and submit forms, extract page information, and capture screenshots through a repeatable navigation and interaction workflow.

  • Automating login flows
  • Filling and submitting web forms
  • Extracting product names, prices, and links
ruvnet/RuView98.7KUpdated Oct 18, 2026

See all skills by ruvnet

Report a problem with this skill