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.

docs(freshness): re-verify 12 stale docs, fix trenches and embody drift, ratchet maxStale to 121

nirholas8ef2b01fccc7
diff --git a/data/docs-freshness-budget.json b/data/docs-freshness-budget.json
index 08e218cef..6d1e5b372 100644
--- a/data/docs-freshness-budget.json
+++ b/data/docs-freshness-budget.json
@@ -1,7 +1,7 @@
{
"$doc": "/docs/freshness",
"$comment": "Ratchet for `npm run check:docs-freshness`. maxStale is the number of docs allowed to be describing code that moved after they were written. It goes DOWN as docs are refreshed and never up without a reason recorded below, which is what stops drift from being permanently normal.",
- "maxStale": 130,
+ "maxStale": 121,
"history": [
{
"date": "2026-07-31",
@@ -22,6 +22,11 @@
"date": "2026-10-23",
"maxStale": 130,
"reason": "Raised from 5 under work order 402 (restore a green gate): 30 docs were re-verified and committed (157 stale down to 127), but the corpus drifted well past the 2026-09-17 baseline after a month of fast shipping. 130 is the measured 127 plus 3 headroom. The remaining backlog is owned by order 403 (prompts/finish/403-auto-drain-docs-freshness.md), which ratchets this back down to 5."
+ },
+ {
+ "date": "2026-10-23",
+ "maxStale": 121,
+ "reason": "Order 403 drain, batch 1: 12 docs reviewed against code (118 stale measured plus 3 headroom)."
}
]
}
diff --git a/data/docs-freshness-reviews.json b/data/docs-freshness-reviews.json
index 478555a0c..fb4574d82 100644
--- a/data/docs-freshness-reviews.json
+++ b/data/docs-freshness-reviews.json
@@ -21,13 +21,13 @@
"note": "full sweep: read against the drifted commits and corrected where wrong"
},
"docs/agent-abilities/ABILITIES.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
},
"docs/agent-abilities/FULL-ARTICLE.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
@@ -99,7 +99,7 @@
"note": "dated record, kept as written"
},
"docs/apps.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
@@ -123,7 +123,7 @@
"note": "full sweep: read against the drifted commits and corrected where wrong"
},
"docs/avatar-thumbnails.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
@@ -159,13 +159,13 @@
"note": "full sweep: read against the drifted commits and corrected where wrong"
},
"docs/clash.md": {
- "commit": "53f2a200f",
+ "commit": "1396077cf",
"kind": "verified",
"by": "agent",
- "note": "full sweep: read against the drifted commits and corrected where wrong"
+ "note": "read against code drift; fixed where it differed"
},
"docs/coin-pages.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
@@ -182,6 +182,12 @@
"by": "agent",
"note": "full sweep: read against the drifted commits and corrected where wrong"
},
+ "docs/crawl.md": {
+ "commit": "1396077cf",
+ "kind": "verified",
+ "by": "agent",
+ "note": "read against code drift; fixed where it differed"
+ },
"docs/crews.md": {
"commit": "53f2a200f",
"kind": "verified",
@@ -195,7 +201,7 @@
"note": "full sweep: read against the drifted commits and corrected where wrong"
},
"docs/demo-routes.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
@@ -219,10 +225,16 @@
"note": "full sweep: read against the drifted commits and corrected where wrong"
},
"docs/economy-solver.md": {
- "commit": "53f2a200f",
+ "commit": "1396077cf",
"kind": "verified",
"by": "agent",
- "note": "full sweep: read against the drifted commits and corrected where wrong"
+ "note": "read against code drift; fixed where it differed"
+ },
+ "docs/embody.md": {
+ "commit": "1396077cf",
+ "kind": "verified",
+ "by": "agent",
+ "note": "read against code drift; fixed where it differed"
},
"docs/event-readiness/01-play-first-impression.md": {
"commit": "53f2a200f",
@@ -254,6 +266,12 @@
"by": "agent",
"note": "full sweep: read against the drifted commits and corrected where wrong"
},
+ "docs/feedback.md": {
+ "commit": "1396077cf",
+ "kind": "verified",
+ "by": "agent",
+ "note": "read against code drift; fixed where it differed"
+ },
"docs/financial-controls.md": {
"commit": "53f2a200f",
"kind": "verified",
@@ -333,10 +351,10 @@
"note": "recipe handoff re-checked against the rebuilt /launch page"
},
"docs/lipsync.md": {
- "commit": "53f2a200f",
+ "commit": "1396077cf",
"kind": "verified",
"by": "agent",
- "note": "full sweep: read against the drifted commits and corrected where wrong"
+ "note": "read against code drift; fixed where it differed"
},
"docs/mcp-safety.md": {
"commit": "53f2a200f",
@@ -369,10 +387,10 @@
"note": "full sweep: read against the drifted commits and corrected where wrong"
},
"docs/object-library.md": {
- "commit": "53f2a200f",
+ "commit": "1396077cf",
"kind": "verified",
"by": "agent",
- "note": "full sweep: read against the drifted commits and corrected where wrong"
+ "note": "read against code drift; fixed where it differed"
},
"docs/onboarding-tier.md": {
"commit": "53f2a200f",
@@ -399,7 +417,7 @@
"note": "full sweep: read against the drifted commits and corrected where wrong"
},
"docs/ops/gcp-credits.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
@@ -441,11 +459,17 @@
"note": "full sweep: read against the drifted commits and corrected where wrong"
},
"docs/oracle-trading-mcp-plan.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
},
+ "docs/oracle.md": {
+ "commit": "1396077cf",
+ "kind": "verified",
+ "by": "agent",
+ "note": "read against code drift; fixed where it differed"
+ },
"docs/overlay-audit.md": {
"commit": "53f2a200f",
"kind": "verified",
@@ -465,7 +489,7 @@
"note": "full sweep: read against the drifted commits and corrected where wrong"
},
"docs/prompts/03-mcp-tool-policy-skill.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
@@ -483,19 +507,19 @@
"note": "full sweep: read against the drifted commits and corrected where wrong"
},
"docs/research/3d-landscape-2026-10.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "snapshot",
"by": "agent",
"note": "dated record, kept as written"
},
"docs/research/competitor-teardown-2026-09.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "snapshot",
"by": "agent",
"note": "dated record, kept as written"
},
"docs/risk-acknowledgment.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
@@ -531,7 +555,7 @@
"note": "full sweep: read against the drifted commits and corrected where wrong"
},
"docs/site-performance.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
@@ -543,7 +567,7 @@
"note": "full sweep: read against the drifted commits and corrected where wrong"
},
"docs/social-layer.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
@@ -585,11 +609,17 @@
"note": "full sweep: read against the drifted commits and corrected where wrong"
},
"docs/trading-copilot.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
},
+ "docs/trenches.md": {
+ "commit": "1396077cf",
+ "kind": "verified",
+ "by": "agent",
+ "note": "read against code drift; fixed where it differed"
+ },
"docs/tutorials/mine-vanity-address.md": {
"commit": "53f2a200f",
"kind": "verified",
@@ -627,73 +657,73 @@
"note": "full sweep: read against the drifted commits and corrected where wrong"
},
"docs/ux-flows/01-onboarding-creation.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
},
"docs/ux-flows/02-forge-text-to-3d.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
},
"docs/ux-flows/03-3d-editing-viewer.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
},
"docs/ux-flows/04-embed-widget-studio.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
},
"docs/ux-flows/05-discovery-social.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
},
"docs/ux-flows/06-marketplace-skills.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
},
"docs/ux-flows/07-crypto-trading-analytics.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
},
"docs/ux-flows/08-coin-launch-wallets.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
},
"docs/ux-flows/09-x402-agent-commerce.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
},
"docs/ux-flows/10-chat-brain-labs.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
},
"docs/ux-flows/11-account-dashboard.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
},
"docs/ux-flows/12-home-and-content.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
@@ -711,11 +741,17 @@
"note": "full sweep: read against the drifted commits and corrected where wrong"
},
"docs/workbench.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
},
+ "docs/world-lines.md": {
+ "commit": "1396077cf",
+ "kind": "verified",
+ "by": "agent",
+ "note": "read against code drift; fixed where it differed"
+ },
"docs/x-accounts.md": {
"commit": "53f2a200f",
"kind": "verified",
@@ -723,13 +759,13 @@
"note": "full sweep: read against the drifted commits and corrected where wrong"
},
"docs/x-content-pipeline.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
},
"docs/x-posts/claims-ledger-thread.md": {
- "commit": "c1390cb7d",
+ "commit": "a3524e6f6",
"kind": "verified",
"by": "agent",
"note": "freshness sweep: checked against the drifted commits"
diff --git a/docs/embody.md b/docs/embody.md
index 123cec7ee..780544c75 100644
--- a/docs/embody.md
+++ b/docs/embody.md
@@ -35,7 +35,7 @@ Response (`200`):
```json
{
"agent_id": "persona_8f2a1c9d4be6f70a1b2c",
- "glb_url": "https://…/personas/persona_8f2a1c9d4be6f70a1b2c.glb",
+ "glb_url": "https://three.ws/cdn/personas/persona_8f2a1c9d4be6f70a1b2c.glb",
"viewer_url": "https://three.ws/viewer?src=…",
"profile_url": "https://three.ws/embodiment/embed?persona=persona_8f2a1c9d4be6f70a1b2c&glb=…&name=Nova+Scout&state=idle",
"embed_html": "<iframe src=\"https://three.ws/embodiment/embed?persona=persona_8f2a1c9d4be6f70a1b2c&glb=…&name=Nova+Scout&state=idle\" width=\"480\" height=\"640\" …></iframe>",
diff --git a/docs/trenches.md b/docs/trenches.md
index 21b1e5490..6cb8fbefd 100644
--- a/docs/trenches.md
+++ b/docs/trenches.md
@@ -8,7 +8,7 @@ Live market intelligence for the Solana and Robinhood Chain trenches: every pump
|---|---|---|
| Pulse service | [services/pulse](../services/pulse) | Always-on Node process: Solana firehose over WebSocket, scheduler, Hono API, its own dashboard on one port. PGlite by default, Postgres/Timescale via `DATABASE_URL`. |
| Proxy | [api/trenches.js](../api/trenches.js) `-> /api/trenches?view=overview\|health\|tokens\|launches\|wallets` | Allowlisted read-only proxy. Unset or failing upstream is `503 pulse_offline`, never fabricated data. Env: `PULSE_URL`. |
-| Page | [pages/trenches.html](../pages/trenches.html) + [src/trenches.js](../src/trenches.js) `-> /trenches` | Counters, hottest tokens, launch feed, wallet scores, 15 s polling that pauses on hidden tabs, designed offline state. Token text is untrusted and is written with `textContent`. |
+| Page | [pages/trenches.html](../pages/trenches.html) + [src/trenches.js](../src/trenches.js) `-> /trenches` | Counters, hottest tokens, launch feed, wallet scores, 15 s polling that pauses on hidden tabs and backs off (30 s, 60 s, then every 2 min) while Pulse is failing, probing `health` alone first so an offline upstream costs one request per cycle, designed offline state. Token text is untrusted and is written with `textContent`. |
## Run locally