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(ops): record what filming the product for the X queue found

nirholas979b44927506
diff --git a/docs/ops/README.md b/docs/ops/README.md
index 276fd0952..32c5f3ea1 100644
--- a/docs/ops/README.md
+++ b/docs/ops/README.md
@@ -24,6 +24,7 @@ Start with [gcp-production.md](gcp-production.md); it is the complete operationa
| [solana-rpc-lanes.md](solana-rpc-lanes.md) | The Solana RPC tier end to end: one-sweep diagnosis, per-lane method capability, what must rotate vs fail, config traps, recovery. |
| [llm-lanes.md](llm-lanes.md) | The LLM provider chain end to end: which rungs serve, why the paid ones are dead, how spend is metered, the one-command Claude rollout, and per-lane probes. |
| [page-audit.md](page-audit.md) | `scripts/page-audit.mjs`: authed Chromium sweep of every public page, console-error gated. |
+| [x-story-findings-2026-09-30.md](x-story-findings-2026-09-30.md) | What filming every feature for the X queue found: features that could not be announced because they do not work, and the defects seen on the ones that do. |
| [guard-wiring.md](guard-wiring.md) | Every `check:*` / `audit:*` script classified: what it checks, its measured exit code and runtime, and whether it runs in `gate`, on the deploy path, in the pre-push hook, or only by hand. |
| [swarm-100-audit.md](swarm-100-audit.md) | Reconciles the `prompts/swarm-100/` self-deleting work-order ledger against git history and measures every still-open order. |
| [avatar-asset-orphans.md](avatar-asset-orphans.md) | Avatar rows whose model or thumbnail is gone from the bucket: why they happened, how to find and repair them. |
diff --git a/docs/ops/x-story-findings-2026-09-30.md b/docs/ops/x-story-findings-2026-09-30.md
new file mode 100644
index 000000000..2b58a2ff8
--- /dev/null
+++ b/docs/ops/x-story-findings-2026-09-30.md
@@ -0,0 +1,52 @@
+# What filming the product found: 2026-09-29 to 2026-09-30
+
+Ten authors wrote stories for the @trythreews queue by using each feature end to end against
+production and filming the run ([how that works](../x-story-authoring.md)). A story only exists
+when the feature passed. The features that did not pass, and the defects seen along the way, are
+listed here so they get fixed rather than announced. Every item was observed against the live site
+on the dates above; re-check before acting, because some may have moved.
+
+Third-party project names are left out on purpose; the pages named below carry them.
+
+## Features that could not be announced because they do not work
+
+| Surface | What happens | What was expected |
+|---|---|---|
+| `/capture` | Video to point cloud answers `503 unconfigured`: `GCP_VIDEO2SCENE_URL` is not set on the API service and no `model-video2scene` Cloud Run service exists. `docs/capture.md` says the worker is not deployed. | The page's headline feature. |
+| `/cosmos` | `POST /api/cosmos` answers `503 lane_unavailable`. The stage avatar renders in a T-pose with its head out of frame. | A world generated behind the avatar. |
+| `/tty` | The command on the page, `curl three.ws/tty`, prints nothing: the load balancer answers 301 to https with an empty body. After any browser visit, `curl https://three.ws/tty` gets the HTML page from the CDN for about half an hour, because the HTML variant is cached without `Vary: Accept`. In a browser the live panel never animates: the stream is brotli-compressed and fully buffered (time to first byte 5.66 s on a 5.68 s stream). The renderer itself works. | An avatar streamed into a terminal. |
+| `/stream` | The progressive panel renders layer 0 correctly and then explodes into a spike ball after layer 1, for every avatar. The summary line reports "0.5x faster to first frame" when the stream is slower. The CLI on the page fails with `ERR_MODULE_NOT_FOUND` for an undeclared dependency in the published 0.1.0. | A progressively refined avatar. |
+| `/validation` | The Inspect tab fails with "React is not defined". | The validator's inspect view. |
+| `/concierge` | About one ask in five comes back empty ("I could not come up with an answer just now"): measured 7 of 36. In `api/concierge.js`, when the first model rung streams no content the handler sends `done` instead of falling to the next rung. The sentence splitter also speaks "[https://three." when an answer contains a link. | A grounded answer every time. |
+| `/embed-doctor` | Four of four correct embeds are reported "Broken": the tutorial's canonical snippet is served a 404 page inside the sandbox, a plain GLB snippet is failed on a benign decoder abort, and live-page mode fails on the site's own pages. The findings also order a fix "above" that is printed below. | A Healthy verdict for a working embed. |
+| `/nvidia` | The fleet table does not match production: one GPU service is not ready (startup probe timing out), one lane has failed every job for three days ("task orphaned: no progress within 30 minutes"), and three listed workers are not deployed as GPU services. | An accurate fleet page. |
+| `/diorama`, `/world-lines`, `/crews` | Empty in production: no public dioramas, no active quests in any region, one test crew. | Something to show. |
+| `/herald` (burst) | With the 3D body, five messages sent at once are all counted as delivered in 0.2 s and only the summary bubble is ever readable. The walk companion is persistent on every page and its `announce()` resolves as soon as the line is up, so Herald's one-at-a-time delivery never waits. Fix in `herald-sdk/src/presenters/avatar.js` (hold for `dwellMs` when the companion is persistent) or in the walk SDK (resolve after the hold). | One message at a time, each readable. |
+
+## Defects on surfaces that were announced or are otherwise fine
+
+- **`/herald`:** the documented import `import { createHerald, pollSource } from 'https://three.ws/herald.js'` has no exports in the served file; only `window.threeHerald` works. The page says the card presenter takes over under reduced motion; it does not (only without WebGL). The playground cannot show dedupe because each send gets a fresh id. The companion introduces itself with a random guest name about 9.6 s after load; the name list includes a word that reads as an exchange name.
+- **`/docs/world`:** pressing `/` opens both the Docs World search and the site-wide command palette on top of it. "Shift+Enter has the world walk you there" lays a trail but the avatar does not move (the tour, the tooltip and `docs/docs-world.md` all overstate it). The social description says 14 sections; the index has 15. The Top Down camera shows only the hub, not the ring.
+- **`/drive`:** `/api/tts/edge` answers 401 before the fallback succeeds, a console error on every turn. The model reply is uncontrolled and once volunteered a third-party launchpad; re-films need their frames checked.
+- **`/glance`:** the SVG card in an `<img>` shows a broken-image icon where the agent thumbnail should be (an external image cannot load inside an SVG used as an image; it needs a data URI). The card prints a raw event name ("last: load-end 3d ago"). Of 600 published agents none has "Moves today" above 0, because chats do not count as moves. At 720 px the 480 px card overflows its panel. `/api/glance/token` returns 401 on every signed-out load. `?agent=` links leave the Agent dropdown on the featured agent.
+- **`/3d`:** the live badge is stuck on "CHECKING…" (i18n rewrites `#liveBadge` after `setLive` runs). `footer.foot` renders `position:absolute` over the stats cards on the first screen.
+- **`/inspect`:** "Non-collapsed bounds" reports raw quantized units for meshopt models, not world units.
+- **`/render-lab`:** the default model is a crypto personality likeness; one model appears twice in the chips; the sheet button leaves a doubled tooltip.
+- **`/avatar-sdk`:** the hero viewer shows a bind-pose T-pose, which the operating rules say never to ship, and the playground offers a real person's likeness.
+- **`/avatar-engines`:** the sticky filter bar is translucent and family headings bleed through it while scrolling.
+- **`/characters`:** user cards show wallet dollar values, launchpad descriptions, a public QA test account, and T-pose thumbnails.
+- **`/widgets`, `/integrations`, `/timeline`:** name third-party coins, exchanges and launchpads in chips, cards and milestones, so none can be filmed under the coin gate.
+- **`/wardrobe`:** the page's intro names a stablecoin above the fold; the reel starts below it.
+
+## Pipeline defects found and fixed during the run
+
+- The camera's clock pause had a 50 ms window that a busy WebGL page overran ("Cannot fast-forward to the past"); the margin is now generous with retries.
+- The fact checker crashed on a page whose body had not mounted; it now reads an empty page and fails the check.
+- The walk companion was hidden as chrome on every page, including the one whose subject it is; a scenario can now `show` it.
+- A tap-only `press` could not walk a character; a key can now be held for a filmed stretch.
+- A loose control-name match clicked "Clear search" for "Search"; exact names are matched first.
+- The caption bar clamps at two lines; captions over about 90 characters were cut off, and the validator now refuses them.
+
+## Surfaces judged not to be stories
+
+`/login`, `/register`, `/pricing`, `/sitemap`, `/features/scan` (a marketing page with a stock sample), `/companion` (marketing when signed out), `/smart-home` and its subpages (sign-in walls with no demo house), `/voice/home` (needs a microphone), `/irl` (camera and location gates by design), `/app` (the viewer with "Sign in to save").