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
test(crews): drive Crew HQ end to end in a browser and retire its route audit
nirholasedefec94a413
diff --git a/prompts/swarm-100/route-crews.md b/prompts/swarm-100/route-crews.mddeleted file mode 100644index 56bd594bd..000000000--- a/prompts/swarm-100/route-crews.md+++ /dev/null@@ -1,119 +0,0 @@-# Route audit: /crews (Crew HQ)--How to run: paste this file's repo path into a fresh Claude Code chat in this-repository and say "run this work order". This file is fully self-contained:-it depends on no other prompt file anywhere. If neighboring files in-prompts/swarm-100/ are gone, that work is done; if present, ignore them.-Every claim below rots; step 0 re-measures, and what you measure wins.--## Operating clause (binding)--- Read CLAUDE.md first. Its rules override everything, including this file.-- Finish 100% in this session. Never end the turn with a question, an option- list, or an unexecuted plan. A judgment call goes in one line of the final- report; it never becomes a question that halts work.-- The only permitted stops are the CLAUDE.md stop-and-ask gates: spending real- funds or any irreversible on-chain write, git push or a production deploy,- committing content that references a crypto project other than $THREE, and- destroying unrecoverable data.-- No mocks, no fake data, no placeholder stubs, no unfinished-work markers, no- commented-out code. Real APIs and real integrations only.-- The em-dash and en-dash characters are banned in everything you write.-- Concurrent agents share this worktree: stage explicit paths only (never a- bare add-everything), and commit finished work promptly.-- Before committing, run: npm run check:rules -- --paths <files you touched>.- It must exit 0.--## Step 0: re-derive the current state--1. This route's declared entry (path, description, added date):-- node -e "const p=require('./data/pages.json');for(const s of p.sections)for(const g of s.pages)if(g.path==='/crews')console.log(JSON.stringify(g,null,2))"--2. Find the serving implementation: grep "/crews" in vercel.json (the live- route table server/index.mjs boots from), then list matching files in- pages/ and src/. STRUCTURE.md maps every surface to its directory if the- grep is ambiguous.-3. Production right now:-- curl -so /dev/null -w '%{http_code}\n' https://three.ws/crews--4. Start (or reuse) the local dev server: npm run dev (vite, port 3000).--## Task: audit this one route end to end, then fix everything found--Route: /crews ("Crew HQ", section "main").-Declared purpose: Found a crew, invite your people, and watch the whole roster stand in one 3D headquarters. Every member appears as their own agent, lit when they are live in the world.--Drive the page in a real headless browser. Playwright is already a dev-dependency; keep your probe script in the session scratchpad, never in the-repo.--1. Load http://localhost:3000/crews. Record the HTTP status, every console- error and warning, and every failed network request.-2. Exercise it like a first-time user: click the primary actions, run the- primary flow if one exists, follow the page's internal links. Every button- must do something real; every link must resolve. If the page renders data,- prove in the network log that it came from a live endpoint, not a baked-in- fallback array.-3. States: verify populated, empty, loading, and error states are designed and- reachable. Block the page's primary fetch in Playwright and confirm an- actionable error state appears, not a blank void or a raw exception.-4. Responsive: render at 320, 768, and 1440 px. No horizontal page scroll, no- overlapping or clipped controls.-5. Accessibility basics: one h1; interactive elements are real buttons or- links with visible focus states; images carry alt text; form fields have- labels.-6. Head: a specific title tag and meta description that match the declared- purpose above.-7. Fix every defect at its root in the page's real source files and re-run the- probe until clean. Defects in shared modules are in scope when this route- exercises them.--## Definition of done--- [ ] Local load of /crews: HTTP 200, zero console errors, zero unhandled- failed requests (a third-party outage must land in a designed fallback,- not a broken page).-- [ ] No dead interactive element on the page: no stub href="#", no button- without a handler, no link to a missing path.-- [ ] Empty, loading, error, and populated states verified.-- [ ] 320 / 768 / 1440 px renders verified clean.-- [ ] Title and meta description present and specific.-- [ ] npm test passes; npm run check:rules -- --paths <touched files> exits 0.-- [ ] Production status from step 0 recorded in the report; if production- needs a deploy to pick up a fix, the report says so (deploys stay- owner-gated).--## Never blocked--| Blocker | Resolution (act, do not ask) |-|---|---|-| Missing env var or credential | Check .env and .env.local, then the Cloud Run service env, then Secret Manager (the CLAUDE.md self-unblock playbook has the exact commands). If it truly exists nowhere, wire the code fully behind the env var, prove the wiring with a dry run, and name the single missing var in the report. |-| gcloud not on PATH | Run: export PATH="$HOME/google-cloud-sdk/bin:$PATH" |-| Dev server port 3000 busy | Another agent may be serving this repo; probe it and reuse if so. Otherwise start your own on a free port: npx vite --port 3101 |-| Playwright browser missing | npx playwright install chromium |-| A surface needs a signed-in user | Register a fresh account through the real /register flow against the real API and use it. Never mock the session. |-| A defect sits in code you did not touch | Fix it if it blocks a Definition of done line (root cause it, never mask it). Otherwise note it in the report and continue. |-| An unrelated test is red | Same rule. Never pipe npm test through tail; it masks exit codes. |--## Close out (required)--1. Verify every Definition of done line with the actual command output in- front of you. Never claim a line you did not verify.-2. Commit with explicit paths and a subject that describes the diff (house- style: type(scope): what changed and why a reader cares).-3. Delete this prompt file in that same commit:-- git rm prompts/swarm-100/route-crews.md-- The shrinking directory is this campaign's only progress ledger; there is- no progress log to update.-4. Final report: what step 0 measured, what changed (file list), evidence per- Definition of done line, and any one-line judgment calls. No trailing- questions, no unexecuted plans.--If a line genuinely cannot pass inside this session (an external party must-respond, or an owner-gated action is the final step), finish everything else,-leave this file in place, and state exactly which line remains and who owns-it. Never delete this file on a partial.diff --git a/tests/e2e/crews-hq.spec.js b/tests/e2e/crews-hq.spec.jsnew file mode 100644index 000000000..28c6032cf--- /dev/null+++ b/tests/e2e/crews-hq.spec.js@@ -0,0 +1,130 @@+// /crews (Crew HQ): the route audit's findings, each of which reproduces on the+// pre-fix page.+//+// 1. /crews/<TAG> had no dev route at all, so every directory card and every+// shared crew link 404'd locally while working in production. Half the page+// (the public-crew view) could not be opened without deploying it first.+//+// 2. A signed-out visitor's first paint fired GET /api/crews, which is 401 by+// design, and printed a red error in the console of a public page. The+// session now resolves through /api/auth/me, which answers 200 for everyone.+//+// 3. The presence poll re-rendered the whole room every 20 seconds, destroying+// and rebuilding every <agent-3d>: new WebGL contexts four times a minute+// against a browser cap of roughly sixteen. Presence is now written into the+// figures already standing.+//+// The crew data is live, so every assertion is about structure and behaviour+// rather than a particular crew being present.++import { test, expect } from '@playwright/test';++async function topCrewTag(request) {+ const res = await request.get('/api/crews/directory?limit=24');+ expect(res.ok()).toBe(true);+ const { data } = await res.json();+ return data?.crews?.[0]?.tag || '';+}++// Fire one presence poll now instead of waiting out PRESENCE_POLL_MS: the page+// polls on visibilitychange as well as on the interval, and both run the same+// tick.+async function pollNow(page) {+ await page.evaluate(() => document.dispatchEvent(new Event('visibilitychange')));+ await page.waitForTimeout(2500);+}++test('/crews serves a signed-out visitor the directory with a clean console', async ({ page }) => {+ const errors = [];+ page.on('console', (m) => {+ // The Vite dev client's HMR socket cannot reach a Codespace port that is+ // not forwarded; that is the harness, not the page.+ if (m.type() === 'error' && !/websocket/i.test(m.text())) errors.push(m.text());+ });++ await page.goto('/crews', { waitUntil: 'domcontentloaded', timeout: 60_000 });+ await expect(page.locator('h1')).toHaveText('Crew HQ');+ await expect(page.locator('#cw-signedout')).toBeVisible();+ // The founding form belongs to someone who can submit it.+ await expect(page.locator('#cw-found-panel')).toBeHidden();+ await expect(page.locator('#cw-dir-panel')).toBeVisible();+ await page.waitForFunction(() => !/Loading crews/.test(document.getElementById('cw-dir').textContent));++ expect(errors, `console errors on a public page: ${errors.join(' | ')}`).toEqual([]);+});++test('/crews/<TAG> opens a crew headquarters and keeps its figures across a poll', async ({+ page,+ request,+}) => {+ const tag = await topCrewTag(request);+ test.skip(!tag, 'no crew exists to open');++ const res = await page.goto(`/crews/${tag}`, { waitUntil: 'domcontentloaded', timeout: 60_000 });+ expect(res.status(), '/crews/<TAG> must resolve in dev, not only in production').toBe(200);++ await page.waitForSelector('.cw-standee', { timeout: 60_000 });+ await expect(page.locator('#cw-room')).toBeVisible();+ await expect(page.locator('#cw-roster-panel')).toBeVisible();+ await expect(page).toHaveTitle(new RegExp(`\\(${tag}\\) · Crew HQ`));+ // The directory must not card the crew whose page this is.+ await expect(page.locator(`.cw-dir-card[href="/crews/${tag}"]`)).toHaveCount(0);++ // Every standee carries the member it stands for, which is what lets a poll+ // update it instead of replacing it.+ const standees = await page.locator('.cw-standee').count();+ expect(standees).toBeGreaterThan(0);+ expect(await page.locator('.cw-standee[data-member]').count()).toBe(standees);++ await page.evaluate(() =>+ document.querySelectorAll('.cw-standee').forEach((el, i) => {+ el.dataset.pinned = String(i);+ }),+ );+ await pollNow(page);++ // Same nodes, and no skeleton flashed over a room that was already standing.+ expect(await page.locator('.cw-standee[data-pinned]').count()).toBe(standees);+ await expect(page.locator('.cw-skeleton')).toHaveCount(0);+});++test('/crews/<TAG> offers a free tag only to someone who can take it', async ({ page }) => {+ await page.goto('/crews/ZZQQZ', { waitUntil: 'domcontentloaded', timeout: 60_000 });++ const error = page.locator('#cw-error');+ await expect(error).toContainText('No crew flies the tag ZZQQZ');+ await expect(error.locator('#cw-retry')).toBeVisible();+ // Signed out: the founding form would only 401, so the way in is offered.+ await expect(page.locator('#cw-found-panel')).toBeHidden();+ await expect(page.locator('#cw-signedout')).toBeVisible();+ await expect(page.locator('#cw-room')).toBeHidden();+});++test('/crews says what happened when the crew service is unreachable', async ({ page, request }) => {+ const tag = (await topCrewTag(request)) || 'ZZQQZ';+ await page.route('**/api/crews/**', (r) => r.abort('failed'));+ await page.goto(`/crews/${tag}`, { waitUntil: 'domcontentloaded', timeout: 60_000 });++ const error = page.locator('#cw-error');+ // The browser's own "Failed to fetch" tells a visitor nothing.+ await expect(error).toContainText('could not be reached');+ await expect(error).not.toContainText('Failed to fetch');+ await expect(error.locator('#cw-retry')).toBeVisible();+ // And the loading skeleton is gone: it promises something that is not coming.+ await expect(page.locator('.cw-skeleton')).toHaveCount(0);+ await expect(page.locator('#cw-dir')).toContainText('The directory did not load');++ await page.unroute('**/api/crews/**');+ await error.locator('#cw-retry').click();+ await expect(page.locator('#cw-error')).toBeHidden({ timeout: 60_000 });+});++test('/crews fits a 320px phone', async ({ page }) => {+ await page.setViewportSize({ width: 320, height: 800 });+ await page.goto('/crews', { waitUntil: 'domcontentloaded', timeout: 60_000 });+ await page.waitForSelector('#cw-dir-panel:not([hidden])');+ const overflow = await page.evaluate(+ () => document.documentElement.scrollWidth > document.documentElement.clientWidth + 1,+ );+ expect(overflow, 'the page must not scroll sideways on a phone').toBe(false);+});