From 9c759f26db9368327bed879c240a96e3ad5d5f74 Mon Sep 17 00:00:00 2001
From: ruv <ruv@ruv.net>
Date: Sun, 1 Mar 2026 15:54:14 -0500
Subject: [PATCH] docs: add ADR-028 audit overview to README + collapsed
 section

- New collapsed section before Installation linking to witness log,
  ADR-028, and bundle generator
- Shows test counts, proof hash, and 3-command verification steps

Co-Authored-By: claude-flow <ruv@ruv.net>
---
 README.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/README.md b/README.md
index 914b52d..baea509 100644
--- a/README.md
+++ b/README.md
@@ -332,6 +332,42 @@ See [`docs/adr/ADR-027-cross-environment-domain-generalization.md`](docs/adr/ADR
 
 ---
 
+<details>
+<summary><strong>🔍 Independent Capability Audit (ADR-028)</strong> — 1,031 tests, SHA-256 proof, self-verifying witness bundle</summary>
+
+A [3-agent parallel audit](docs/adr/ADR-028-esp32-capability-audit.md) independently verified every claim in this repository — ESP32 hardware, signal processing, neural networks, training pipeline, deployment, and security. Results:
+
+```
+Rust tests:     1,031 passed, 0 failed
+Python proof:   VERDICT: PASS (SHA-256: 8c0680d7...)
+Bundle verify:  7/7 checks PASS
+```
+
+**33-row attestation matrix:** 31 capabilities verified YES, 2 not measured at audit time (benchmark throughput, Kubernetes deploy).
+
+**Verify it yourself** (no hardware needed):
+```bash
+# Run all tests
+cd rust-port/wifi-densepose-rs && cargo test --workspace --no-default-features
+
+# Run the deterministic proof
+python v1/data/proof/verify.py
+
+# Generate + verify the witness bundle
+bash scripts/generate-witness-bundle.sh
+cd dist/witness-bundle-ADR028-*/ && bash VERIFY.sh
+```
+
+| Document | What it contains |
+|----------|-----------------|
+| [ADR-028](docs/adr/ADR-028-esp32-capability-audit.md) | Full audit: ESP32 specs, signal algorithms, NN architectures, training phases, deployment infra |
+| [Witness Log](docs/WITNESS-LOG-028.md) | 11 reproducible verification steps + 33-row attestation matrix with evidence per row |
+| [`generate-witness-bundle.sh`](scripts/generate-witness-bundle.sh) | Creates self-contained tar.gz with test logs, proof output, firmware hashes, crate versions, VERIFY.sh |
+
+</details>
+
+---
+
 ## 📦 Installation
 
 <details>