Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

chore(guards): register the interactive-state ratchet the gate already runs

nirholase975ddcf169c
diff --git a/data/guards.json b/data/guards.json
index 79a9afa11..1b0e32b4b 100644
--- a/data/guards.json
+++ b/data/guards.json
@@ -558,6 +558,27 @@
"expect": "design-token drift increased"
}
},
+ {
+ "id": "audit-interactive-states",
+ "script": "scripts/audit-interactive-states.mjs",
+ "npm": "audit:states",
+ "title": "Interactive-state ratchet",
+ "protects": "A selector that declares cursor:pointer cannot ship without a hover rule behind it.",
+ "why": "public/tokens.css gives every control a focus floor and a disabled floor, but hover is component-specific and a blanket rule would stack on top of components that already style their own. So hover is audited instead: cursor:pointer promises the thing is clickable, and with no :hover rule in the same stylesheet the pointer changes shape and nothing else happens, which reads as a dead control. Counting against a committed baseline and failing only when the count rises makes the debt strictly decreasing, the same contract as the design-token ratchet beside it.",
+ "stages": [
+ "gate"
+ ],
+ "needs": "none",
+ "proof": {
+ "summary": "A stylesheet declaring a clickable selector with no hover rule for it.",
+ "violation": {
+ "write": {
+ "public/guard-proof-hover.css": ".proof-clickable { cursor: pointer; color: var(--fg); }\n.proof-other { cursor: pointer; color: var(--fg); }\n"
+ }
+ },
+ "expect": "interactive-state gaps increased"
+ }
+ },
{
"id": "check-browser-graph",
"script": "scripts/check-browser-graph.mjs",
diff --git a/docs/guards.md b/docs/guards.md
index 2c603bbc4..69846c7a5 100644
--- a/docs/guards.md
+++ b/docs/guards.md
@@ -96,6 +96,7 @@ Run `npm run audit:guards` to print the current count and per-stage breakdown. T
| The guard registry | `npm run audit:guards` | Every guard is registered and every stage claim is true. |
| One `<model-viewer>` build | `npm run check:model-viewer` | Every `<model-viewer>` reference in tracked source names one version, no version is served under two integrity hashes, and the vendored copy matches. |
| Design-token ratchet | `npm run audit:tokens` | Hardcoded colour hexes cannot creep back past a committed baseline. |
+| Interactive-state ratchet | `npm run audit:states` | A selector that declares cursor:pointer cannot ship without a hover rule behind it. |
| Credential material | `npm run check:secrets` | No dotenv file, private key, keystore, or downloaded cloud credential becomes a tracked file, and no added line carries a provider-issued key. |
| Python worker dependencies | `npm run audit:deps` | No pinned Python dependency in `workers/`, `services/` or `packages/` carries a known vulnerability in the OSV database. Needs network, so it runs on demand rather than in the gate. |
| iOS app icon | `npm run check:ios-icons` | The committed iOS icon and launch images are exactly what the current brand mark produces, and the icon carries no alpha channel. |
diff --git a/public/guards.json b/public/guards.json
index 79a9afa11..1b0e32b4b 100644
--- a/public/guards.json
+++ b/public/guards.json
@@ -558,6 +558,27 @@
"expect": "design-token drift increased"
}
},
+ {
+ "id": "audit-interactive-states",
+ "script": "scripts/audit-interactive-states.mjs",
+ "npm": "audit:states",
+ "title": "Interactive-state ratchet",
+ "protects": "A selector that declares cursor:pointer cannot ship without a hover rule behind it.",
+ "why": "public/tokens.css gives every control a focus floor and a disabled floor, but hover is component-specific and a blanket rule would stack on top of components that already style their own. So hover is audited instead: cursor:pointer promises the thing is clickable, and with no :hover rule in the same stylesheet the pointer changes shape and nothing else happens, which reads as a dead control. Counting against a committed baseline and failing only when the count rises makes the debt strictly decreasing, the same contract as the design-token ratchet beside it.",
+ "stages": [
+ "gate"
+ ],
+ "needs": "none",
+ "proof": {
+ "summary": "A stylesheet declaring a clickable selector with no hover rule for it.",
+ "violation": {
+ "write": {
+ "public/guard-proof-hover.css": ".proof-clickable { cursor: pointer; color: var(--fg); }\n.proof-other { cursor: pointer; color: var(--fg); }\n"
+ }
+ },
+ "expect": "interactive-state gaps increased"
+ }
+ },
{
"id": "check-browser-graph",
"script": "scripts/check-browser-graph.mjs",