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
fix(audit-console): re-run a failing route serially before calling it broken
nirholasc9deecba3fe9
diff --git a/docs/guards.md b/docs/guards.mdindex ec324a56b..ce6438545 100644--- a/docs/guards.md+++ b/docs/guards.md@@ -148,7 +148,8 @@ Run `npm run audit:guards` to print the current count and per-stage breakdown. T|---|---|---|| CSP-safe inline markup | `npm run audit:inline-handlers` | No served HTML carries an inline event handler attribute or a `javascript:` URL. || Live CSP sweep | `npm run audit:csp` | No page violates the Content-Security-Policy the server sends with it, and every response carries the security headers `vercel.json` declares. `--headers-only --base https://three.ws` checks the header half against a live origin with no browser. |-| Console sweep | `npm run audit:console` | A clean browser console on every route, desktop and mobile. |+| Console sweep | `npm run audit:console` | A clean browser console on every route, desktop and mobile. Any route that fails in the parallel pass is re-run once serially and the second reading is the one reported, because this worktree is shared and a page that misses its settle window beside somebody else's full build has not failed. The report names how many cleared that way. |+| Hosted IBM page | `npm run audit:ibm-hosted` | The publish-once partnership page still works from a domain that is not three.ws: the live update applies, i18n mounts, and the x402 widget binds. See [ops/ibm-hosted-page-audit.md](ops/ibm-hosted-page-audit.md). || `/play` failure modes | `npm run audit:play-failures` | `/play` stays usable when its dependencies fail, and hostile deep-link params never execute. || Overlapping fixed overlays | `npm run audit:overlays` | No persistent floating widget can cover another one's controls. || Image loading attributes | `npm run check:images` | Every JS-rendered image sets `loading` and `decoding`. |diff --git a/scripts/audit-console.mjs b/scripts/audit-console.mjsindex 827fbf566..1bcc2fd8d 100644--- a/scripts/audit-console.mjs+++ b/scripts/audit-console.mjs@@ -10,6 +10,13 @@* A clean console is part of the Definition of Done (CLAUDE.md). This is the* lasting, npm-able check — wired as `npm run audit:console`.*+ * Any route that fails in the parallel pass is re-run once, serially, and that+ * second reading is what the report carries. This worktree is shared with other+ * agents and a sweep routinely runs beside somebody else's full build; a page+ * that misses its settle window at load 100+ has not failed. A real defect+ * reproduces on the quiet retry, so nothing is excused, only re-measured, and+ * the report says how many routes cleared that way.+ ** Usage:* node scripts/audit-console.mjs # every HTML route, both viewports* node scripts/audit-console.mjs / /forge /play # specific routes only@@ -455,6 +462,8 @@ let browser = await launchBrowser();// results[viewportKey] = array of per-route result objectsconst results = {};+// retries[viewportKey] = { attempted, recovered } for the serial re-run below+const retries = {};for (const vpKey of viewportKeys) {const vp = VIEWPORTS[vpKey];@@ -497,6 +506,41 @@ for (const vpKey of viewportKeys) {);return r;});+ // A route that failed once on a saturated box has not necessarily failed.+ // This worktree is shared with several agents, and a sweep routinely runs+ // beside somebody else's full build: at load 100+ a page can miss its settle+ // window, and the run then reports hundreds of "failures" that reproduce on+ // exactly none of them when checked alone. On 2026-09-04 one sweep called 550+ // of 780 routes broken for that reason and every route sampled from it was+ // clean in isolation, which makes the whole measurement worthless.+ //+ // So re-run every failing route once, serially, and keep the second reading:+ // contention disappears when nothing else is competing, and a real defect+ // fails again. Nothing is excused, only re-measured. The count is printed and+ // carried into the report so a run that leaned on this is visible rather than+ // quietly smoothed.+ const failed = res.map((r, i) => [r, i]).filter(([r]) => totalErrors(r) > 0);+ let recovered = 0;+ if (failed.length) {+ console.log(C.y(`\n re-running ${failed.length} failing route(s) serially\n`));+ for (const [r, i] of failed) {+ let again;+ try {+ again = await checkRoute(context, base, r.route);+ } catch (e) {+ if (!BROWSER_GONE.test(e?.message || '')) throw e;+ await recycle();+ again = await checkRoute(context, base, r.route);+ }+ const errs = totalErrors(again);+ if (errs === 0) recovered++;+ res[i] = again;+ process.stdout.write(+ ` retry ${errs === 0 ? C.g('✓') : C.r(`✗ ${errs}`)} ${C.c(r.route.path)}\n`,+ );+ }+ retries[vpKey] = { attempted: failed.length, recovered };+ }results[vpKey] = res;await context.close();}@@ -578,6 +622,22 @@ if (wantReport) {lines.push('');lines.push(`**Result:** ${failing.length === 0 ? '✅ all routes clean' : `❌ ${failing.length} route(s) with errors`}. ${grandErrors} total error(s).`);lines.push('');+ // Say out loud how much of the result came from the serial re-run. A sweep+ // that recovered most of its failures that way was measured on a box under+ // heavy contention, and the reader should weigh it accordingly.+ const retried = Object.entries(retries).filter(([, v]) => v.attempted > 0);+ if (retried.length) {+ lines.push(+ 'Routes that failed in the parallel pass are re-run once, serially, and the ' ++ 'second reading is the one reported: ' ++ retried+ .map(([k, v]) => `${k} ${v.recovered}/${v.attempted} cleared on the retry`)+ .join(', ') ++ '. A route that cleared was losing its settle window to load on a shared box, ' ++ 'not failing.',+ );+ lines.push('');+ }lines.push('## Per-route');lines.push('');const head = ['Route', 'Section', ...viewportKeys.flatMap((k) => [`${k} err`, `${k} warn`])];