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.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
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.jsonindex 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.jsonindex 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.mdindex 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.mdindex 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