From 39becd333ca18674f7bcfc4d9f13028803abd045 Mon Sep 17 00:00:00 2001
From: luisllaver <94252605+luisllaver@users.noreply.github.com>
Date: Wed, 20 May 2026 21:26:30 -0300
Subject: [PATCH] Add opt-in AURA trust-check adapter (integrations/aura)

---
 integrations/aura/README.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/integrations/aura/README.md b/integrations/aura/README.md
index ca2b25ec..62a33efe 100644
--- a/integrations/aura/README.md
+++ b/integrations/aura/README.md
@@ -38,9 +38,13 @@ print(v.ok)        # True for trusted/caution
 
 # v.dimensions tells you *which* axis is weak, not just the aggregate:
 if v.dimensions and v.dimensions.get("financial_integrity", 1) < 0.4:
-    require_manual_review()
+    require_manual_review()   # placeholder for your own policy
 ```
 
+> `v.ok` reflects the *verdict class* (True for `trusted`/`caution`), not the
+> outcome of `require_trust()` — the gate's default `allow` also lets `new`
+> through. Use the gate's return/raise for the decision, `v.ok` for display.
+
 ## Verdicts
 
 | verdict | meaning | `ok` |