diff --git a/README.es.md b/README.es.md
index da46d68..495a8bf 100644
--- a/README.es.md
+++ b/README.es.md
@@ -8,9 +8,12 @@
 
 [![CI](https://github.com/DataDave-Dev/becwright/actions/workflows/ci.yml/badge.svg)](https://github.com/DataDave-Dev/becwright/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/becwright?logo=npm)](https://www.npmjs.com/package/becwright)
+[![npm downloads](https://img.shields.io/npm/dm/becwright?logo=npm&label=descargas)](https://www.npmjs.com/package/becwright)
 [![PyPI](https://img.shields.io/pypi/v/becwright?logo=pypi&logoColor=white)](https://pypi.org/project/becwright/)
+[![Versiones de Python](https://img.shields.io/pypi/pyversions/becwright?logo=python&logoColor=white)](https://pypi.org/project/becwright/)
+[![Licencia: MIT](https://img.shields.io/badge/licencia-MIT-green)](LICENSE)
 
-**La capa de enforcement para agentes de IA.**
+**La capa de enforcement para agentes de IA.** <sub>(se pronuncia *bec-ráit* — un "wright" es un artesano, como en *playwright*)</sub>
 
 Reglas que se ejecutan, no notas que se ignoran. Tu `CLAUDE.md` es un *cartel*;
 becwright es el *guardia* — corre tus reglas sobre el código y frena el commit
@@ -29,7 +32,7 @@ Se publica.
 Con becwright, el commit no llega a existir:
 
 <p align="center">
-  <img src="assets/becwright-demo.svg" alt="becwright frenando un commit que hardcodea un secreto y usa eval" width="640">
+  <img src="assets/becwright-demo-animated.svg" alt="becwright frenando un commit en vivo: corre git commit, dos reglas blocking se disparan con su porqué, el commit se detiene" width="640">
 </p>
 
 > **Velo vos mismo en 5 segundos** — sin configurar nada, sin git, sin tocar tu
diff --git a/README.md b/README.md
index 8fe5ee0..fbc0c55 100644
--- a/README.md
+++ b/README.md
@@ -8,9 +8,12 @@
 
 [![CI](https://github.com/DataDave-Dev/becwright/actions/workflows/ci.yml/badge.svg)](https://github.com/DataDave-Dev/becwright/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/becwright?logo=npm)](https://www.npmjs.com/package/becwright)
+[![npm downloads](https://img.shields.io/npm/dm/becwright?logo=npm&label=downloads)](https://www.npmjs.com/package/becwright)
 [![PyPI](https://img.shields.io/pypi/v/becwright?logo=pypi&logoColor=white)](https://pypi.org/project/becwright/)
+[![Python versions](https://img.shields.io/pypi/pyversions/becwright?logo=python&logoColor=white)](https://pypi.org/project/becwright/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 
-**The enforcement layer for AI coding agents.**
+**The enforcement layer for AI coding agents.** <sub>(*bec-wright* — a "wright" is a maker, as in *playwright*)</sub>
 
 Rules that run, not notes that get ignored. Your `CLAUDE.md` is a *sign*;
 becwright is the *guard* — it runs your rules against the code and blocks the
@@ -28,7 +31,7 @@ string — and leaves a note to *"clean this up later."* Nobody does. It ships.
 With becwright, the commit never happens:
 
 <p align="center">
-  <img src="assets/becwright-demo.svg" alt="becwright blocking a commit that hardcodes a secret and calls eval" width="640">
+  <img src="assets/becwright-demo-animated.svg" alt="becwright blocking a commit live: git commit runs, two blocking rules fire with their why, the commit is stopped" width="640">
 </p>
 
 > **See it yourself in 5 seconds** — no setup, no git, nothing on your machine is
diff --git a/SECURITY.md b/SECURITY.md
index 9c2b468..f3530c6 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -2,13 +2,13 @@
 
 ## Supported versions
 
-becwright is pre-1.0 and ships fixes on the latest release only. Please make
-sure you are on the most recent version before reporting.
+becwright ships fixes on the latest release only. Please make sure you are on
+the most recent version before reporting.
 
 | Version | Supported |
 | ------- | --------- |
-| latest `0.x` | ✅ |
-| older `0.x` | ❌ |
+| latest `1.x` | ✅ |
+| older releases | ❌ |
 
 ## Reporting a vulnerability
 
diff --git a/assets/becwright-demo-animated.svg b/assets/becwright-demo-animated.svg
new file mode 100644
index 0000000..5f7bf7a
--- /dev/null
+++ b/assets/becwright-demo-animated.svg
@@ -0,0 +1,55 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 760 470" width="760" height="470" role="img" aria-label="becwright blocking a commit live: git commit runs, two blocking rules fire, the commit is stopped" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="14">
+  <style>
+    .l { opacity: 0; animation: reveal .01s steps(1) forwards; }
+    @keyframes reveal { to { opacity: 1; } }
+    .type {
+      clip-path: inset(0 100% 0 0);
+      animation: typing 1.4s steps(34, end) .4s forwards;
+    }
+    @keyframes typing { to { clip-path: inset(0 0 0 0); } }
+    .cursor { opacity: 0; animation: reveal .01s steps(1) 6.6s forwards, blink 1.1s steps(1) 6.6s infinite; }
+    @keyframes blink { 50% { opacity: 0; } }
+    .d20 { animation-delay: 2.0s; }
+    .d26 { animation-delay: 2.6s; }
+    .d28 { animation-delay: 2.8s; }
+    .d30 { animation-delay: 3.0s; }
+    .d40 { animation-delay: 4.0s; }
+    .d42 { animation-delay: 4.2s; }
+    .d44 { animation-delay: 4.4s; }
+    .d56 { animation-delay: 5.6s; }
+    .d66 { animation-delay: 6.6s; }
+  </style>
+
+  <!-- window -->
+  <rect x="0" y="0" width="760" height="470" rx="12" fill="#111827"/>
+  <rect x="0" y="0" width="760" height="36" rx="12" fill="#1F2937"/>
+  <rect x="0" y="24" width="760" height="12" fill="#1F2937"/>
+  <circle cx="22" cy="18" r="5" fill="#EF4444"/>
+  <circle cx="42" cy="18" r="5" fill="#F59E0B"/>
+  <circle cx="62" cy="18" r="5" fill="#22C55E"/>
+  <text x="380" y="22" text-anchor="middle" fill="#9CA3AF">git commit — guarded by becwright</text>
+
+  <!-- $ git commit (typed) -->
+  <text x="24" y="68"><tspan fill="#BEF264" font-weight="700">$</tspan><tspan class="type" fill="#F9FAFB"> git commit -m "checkout: promo discounts"</tspan></text>
+
+  <!-- BEC banner -->
+  <text x="24" y="104" class="l d20" fill="#F9FAFB" font-weight="700">BEC -- 1 file(s) against 2 rule(s)</text>
+
+  <!-- BLOCK 1 -->
+  <text x="24" y="140" class="l d26"><tspan fill="#F87171" font-weight="700">  BLOCK</tspan><tspan fill="#E5E7EB">  no-hardcoded-secrets  </tspan><tspan fill="#F87171" font-weight="700">(blocking)</tspan></text>
+  <text x="24" y="162" class="l d28" fill="#9CA3AF">        Why it matters: a secret stays in git history forever.</text>
+  <text x="24" y="184" class="l d30"><tspan fill="#9CA3AF">        checkout.py:2  </tspan><tspan fill="#E5E7EB">&gt; api_key = "x7Kp2mQ9vT4nB8wL"</tspan></text>
+
+  <!-- BLOCK 2 -->
+  <text x="24" y="220" class="l d40"><tspan fill="#F87171" font-weight="700">  BLOCK</tspan><tspan fill="#E5E7EB">  no-dangerous-eval     </tspan><tspan fill="#F87171" font-weight="700">(blocking)</tspan></text>
+  <text x="24" y="242" class="l d42" fill="#9CA3AF">        Why it matters: eval on untrusted input is remote code execution.</text>
+  <text x="24" y="264" class="l d44"><tspan fill="#9CA3AF">        checkout.py:4  </tspan><tspan fill="#E5E7EB">&gt; discount = eval(rule)</tspan></text>
+
+  <!-- verdict -->
+  <text x="24" y="308" class="l d56" fill="#F87171" font-weight="700">&gt;&gt;&gt; Commit BLOCKED: becwright caught it before it shipped.</text>
+
+  <!-- closing prompt -->
+  <text x="24" y="352" class="l d66" fill="#9CA3AF">Rules that run, not notes that get ignored.</text>
+  <text x="24" y="392" class="l d66"><tspan fill="#BEF264" font-weight="700">$</tspan><tspan fill="#F9FAFB"> npx becwright demo</tspan><tspan fill="#9CA3AF">   # try it — nothing installed, nothing touched</tspan></text>
+  <text x="24" y="430"><tspan class="l d66" fill="#BEF264" font-weight="700">$ </tspan><tspan class="cursor" fill="#BEF264" font-weight="700">▊</tspan></text>
+</svg>