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 two awesome-list guards the gate was already running

nirholasd721a859e4ac
diff --git a/data/guards.json b/data/guards.json
index dd670f10d..79a9afa11 100644
--- a/data/guards.json
+++ b/data/guards.json
@@ -1,5 +1,5 @@
{
- "updated": "2026-09-07",
+ "updated": "2026-09-08",
"summary": "Every mechanical guard that protects this repository, and the stage each one runs in. This file is the single source of truth: scripts/audit-guards.mjs proves every entry is real and every stage claim is true, docs/guards.md explains them, and /guards renders them.",
"stages": [
{
@@ -1203,6 +1203,43 @@
"expect": "guard-proof.example.com"
}
},
+ {
+ "id": "check-awesome",
+ "script": "scripts/build-awesome.mjs",
+ "npm": "check:awesome",
+ "title": "Awesome list freshness",
+ "protects": "awesome/README.md and public/awesome.json match data/awesome.json, which is the single source both are generated from.",
+ "why": "The list is published in two places that people read separately, the GitHub README and the /awesome page. Editing either by hand, or adding an entry to the source without regenerating, ships two versions of the same list that disagree about what is on it.",
+ "stages": [
+ "gate"
+ ],
+ "needs": "none",
+ "proof": {
+ "summary": "A generated output edited by hand, so it no longer matches data/awesome.json.",
+ "violation": {
+ "write": {
+ "awesome/README.md": "# Awesome 3D Agents\n\nHand-edited inside the guard sandbox, so this no longer matches data/awesome.json.\n"
+ }
+ },
+ "expect": "out of date"
+ }
+ },
+ {
+ "id": "check-awesome-links",
+ "script": "scripts/check-awesome-links.mjs",
+ "npm": "awesome:links",
+ "title": "Awesome list link health",
+ "protects": "Every url in the Awesome 3D Agents list (data/awesome.json) still answers, and no url is listed twice.",
+ "why": "An awesome list is only worth publishing if its links resolve, and they rot silently as projects move or disappear. Deliberately manual: it calls a hundred-odd third-party hosts, so a flaky CDN must never turn somebody else's deploy red. It separates a bot-filter 403 from a genuinely dead link, because those need different reactions.",
+ "stages": [
+ "manual"
+ ],
+ "needs": "network",
+ "proof": {
+ "kind": "live",
+ "reason": "Fetches every listed url from the real hosts, so only the live answer distinguishes a moved link, a bot filter and a dead one. A static fixture cannot produce any of the three."
+ }
+ },
{
"id": "audit-seo",
"script": "scripts/audit-seo.mjs",
diff --git a/docs/guards.md b/docs/guards.md
index 131b7935d..2c603bbc4 100644
--- a/docs/guards.md
+++ b/docs/guards.md
@@ -114,6 +114,8 @@ Run `npm run audit:guards` to print the current count and per-stage breakdown. T
| The `[hidden]` guard | `npm run audit:hidden-guard` | Every page resolves the CSS that makes `hidden` actually hide. |
| Site link integrity | `npm run audit:links` | Every navigable target resolves to a real route or file. |
| On-page SEO | `npm run audit:seo` | Across the pages we ask Google to index: no duplicate title or description, every canonical self-referential, no sitemap entry answering noindex or a non-200, and structured data that parses. Reads a live origin, so `--base` points it at a preview. |
+| Awesome list freshness | `npm run check:awesome` | `awesome/README.md` and `public/awesome.json` still match `data/awesome.json`, the source both are generated from. |
+| Awesome list link health | `npm run awesome:links` | Every url in the Awesome 3D Agents list still answers, and none is listed twice. Manual on purpose: it calls a hundred-odd third-party hosts, and it tells a bot-filter 403 apart from a dead link. |
### Docs and contracts
diff --git a/public/guards.json b/public/guards.json
index dd670f10d..79a9afa11 100644
--- a/public/guards.json
+++ b/public/guards.json
@@ -1,5 +1,5 @@
{
- "updated": "2026-09-07",
+ "updated": "2026-09-08",
"summary": "Every mechanical guard that protects this repository, and the stage each one runs in. This file is the single source of truth: scripts/audit-guards.mjs proves every entry is real and every stage claim is true, docs/guards.md explains them, and /guards renders them.",
"stages": [
{
@@ -1203,6 +1203,43 @@
"expect": "guard-proof.example.com"
}
},
+ {
+ "id": "check-awesome",
+ "script": "scripts/build-awesome.mjs",
+ "npm": "check:awesome",
+ "title": "Awesome list freshness",
+ "protects": "awesome/README.md and public/awesome.json match data/awesome.json, which is the single source both are generated from.",
+ "why": "The list is published in two places that people read separately, the GitHub README and the /awesome page. Editing either by hand, or adding an entry to the source without regenerating, ships two versions of the same list that disagree about what is on it.",
+ "stages": [
+ "gate"
+ ],
+ "needs": "none",
+ "proof": {
+ "summary": "A generated output edited by hand, so it no longer matches data/awesome.json.",
+ "violation": {
+ "write": {
+ "awesome/README.md": "# Awesome 3D Agents\n\nHand-edited inside the guard sandbox, so this no longer matches data/awesome.json.\n"
+ }
+ },
+ "expect": "out of date"
+ }
+ },
+ {
+ "id": "check-awesome-links",
+ "script": "scripts/check-awesome-links.mjs",
+ "npm": "awesome:links",
+ "title": "Awesome list link health",
+ "protects": "Every url in the Awesome 3D Agents list (data/awesome.json) still answers, and no url is listed twice.",
+ "why": "An awesome list is only worth publishing if its links resolve, and they rot silently as projects move or disappear. Deliberately manual: it calls a hundred-odd third-party hosts, so a flaky CDN must never turn somebody else's deploy red. It separates a bot-filter 403 from a genuinely dead link, because those need different reactions.",
+ "stages": [
+ "manual"
+ ],
+ "needs": "network",
+ "proof": {
+ "kind": "live",
+ "reason": "Fetches every listed url from the real hosts, so only the live answer distinguishes a moved link, a bot filter and a dead one. A static fixture cannot produce any of the three."
+ }
+ },
{
"id": "audit-seo",
"script": "scripts/audit-seo.mjs",