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.

fix(timeline): ship the milestones file with the build so /timeline loads in production, and keep helper widgets off its controls

nirholas9ff3e931c3fe
diff --git a/data/changelog.json b/data/changelog.json
index a3898df3c..e274bdb61 100644
--- a/data/changelog.json
+++ b/data/changelog.json
@@ -25510,16 +25510,6 @@
"fix"
],
"link": "/terminal"
- },
- {
- "date": "2026-09-01",
- "title": "Documentation sweep: 164 docs re-checked against the code they describe",
- "summary": "Every doc the freshness gate flagged as describing code that had moved since it was written (174 of them, from the UX flow walkthroughs and the Oracle model write-up to the ops runbooks, tutorials, and the agent-abilities chapters) was re-read against the current code. 164 were corrected or extended: renamed routes now point at /agents/:id, retired model names and provider ladders are current, counts and thresholds match what ships, and the resilience work of the last month (last-good caches, typed 503s with Retry-After, the RPC read guards) is described where it applies. Along the way three things the docs promised were made true in the product: the Herald posting scope can now be minted from the dashboard key form, the translation script defaults to a Groq model that still exists, and the home page OpenAPI link opens the spec directly.",
- "tags": [
- "docs",
- "fix"
- ],
- "link": "/docs/freshness"
}
]
}
diff --git a/data/timeline.json b/data/timeline.json
index cb169adea..931ab1e80 100644
--- a/data/timeline.json
+++ b/data/timeline.json
@@ -58,6 +58,7 @@
{ "id": "2026-07-10-nemotron-pipeline", "date": "2026-07-10", "title": "NVIDIA forum: Nemotron models power the text-to-3D pipeline", "category": "press", "summary": "An NVIDIA Developer Forums post explains how small Nemotron models act as validators and safety/reasoning layers in front of the Microsoft TRELLIS text-to-3D generator on NVIDIA NIM: 12-13 second generations, ~340ms content-safety latency.", "source_url": "https://forums.developer.nvidia.com/t/how-nemotron-made-three-ws-text-to-3d-pipeline-usable/376445", "importance": 3 },
{ "id": "2026-07-11-ibm-community-corner", "date": "2026-07-11", "title": "IBM corner/community launch", "category": "partnership", "summary": "three.ws's dedicated corner/community space launches on IBM Community.", "source_url": "https://community.ibm.com/community/user/usergroup?CommunityKey=e71510cc-d953-408f-9a1c-019f5c0a7016", "importance": 3 },
{ "id": "2026-07-13-huggingface", "date": "2026-07-13", "title": "Hugging Face PRO listing, #1 trending", "category": "listing", "summary": "three.ws lists on Hugging Face PRO and reaches #1 trending.", "source_url": null, "importance": 4 },
+ { "id": "2026-07-13-huggingface-bodies-wallets", "date": "2026-07-13", "title": "First Hugging Face article: giving AI agents bodies and wallets", "category": "press", "summary": "three.ws publishes its first Hugging Face community article, Giving AI Agents Bodies and Wallets. It opens on the thesis the platform runs on: most AI agents are a chat window, and ours walk around and pay each other.", "source_url": "https://huggingface.co/blog/three-ws/giving-ai-agents-bodies-and-wallets", "importance": 3 },
{ "id": "2026-07-14-ibm-user-group", "date": "2026-07-14", "title": "IBM launches the three.ws User Group", "category": "press", "summary": "IBM Community announces the three.ws User Group, a space for developers building 3D AI agents, covering generative 3D, spatial reasoning, and agentic pipelines.", "source_url": "https://community.ibm.com/community/user/blogs/jessica-swanson/2026/07/14/welcome-to-the-threews-user-group-building-ai-agen", "importance": 3 },
{ "id": "2026-07-14-ibm-platform-tour", "date": "2026-07-14", "title": "IBM discussion: full platform tour", "category": "press", "summary": "An IBM Community post gives a full tour of three.ws: free text-to-3D at /forge, auto-rigging across Mixamo/VRM/Avaturn/MakeHuman, the <agent-3d> embed component, and a multiplayer world at /play.", "source_url": "https://community.ibm.com/community/user/discussion/welcome-to-the-threews-ibm-community-a-full-tour-of-the-platform-start-here", "importance": 2 },
{ "id": "2026-07-15-openai-partner-network", "date": "2026-07-15", "title": "OpenAI Partner Network + ChatGPT 3D Studio", "category": "partnership", "summary": "three.ws joins the OpenAI Partner Network alongside its ChatGPT 3D Studio GPT presence.", "source_url": null, "importance": 4 },
@@ -71,6 +72,13 @@
{ "id": "2026-07-19-nvidia-i18n-pipeline", "date": "2026-07-19", "title": "NVIDIA forum: 100+ language i18n pipeline detailed", "category": "press", "summary": "An NVIDIA Developer Forums post details the localization pipeline behind the July 16 launch: NVIDIA NIM running Llama 3.3 70B Instruct with sentinel masking, incremental diffing, and explicit right-to-left handling.", "source_url": "https://forums.developer.nvidia.com/t/how-three-ws-translates-a-web-app-into-100-languages-with-nvidia-nim-an-llm-powered-i18n-pipeline/377379", "importance": 3 },
{ "id": "2026-07-20-quicknode-followup", "date": "2026-07-20", "title": "QuickNode Startup Program (follow-up post)", "category": "product", "summary": "@trythreews posts a follow-up on the QuickNode Startup Program relationship first established June 9.", "source_url": null, "importance": 1 },
{ "id": "2026-07-24-500-props", "date": "2026-07-24", "title": "500+ free 3D props library milestone", "category": "milestone", "summary": "three.ws's free 3D props library surpasses 500 items.", "source_url": null, "importance": 2 },
- { "id": "2026-07-25-openai-select-partner", "date": "2026-07-25", "title": "Named an OpenAI Select Partner", "category": "partnership", "summary": "three.ws is named an OpenAI Select Partner within the OpenAI Partner Network, alongside the free 3D Studio MCP connector that brings keyless 3D generation into ChatGPT.", "source_url": "https://three.ws/openai", "importance": 3 }
+ { "id": "2026-07-25-openai-select-partner", "date": "2026-07-25", "title": "Named an OpenAI Select Partner", "category": "partnership", "summary": "three.ws is named an OpenAI Select Partner within the OpenAI Partner Network, alongside the free 3D Studio MCP connector that brings keyless 3D generation into ChatGPT.", "source_url": "https://three.ws/openai", "importance": 3 },
+ { "id": "2026-08-19-3d-ar-studio-package", "date": "2026-08-19", "title": "AR Studio ships as an open-source package", "category": "product", "summary": "The multi-model AR surface behind three.ws becomes a standalone open-source package, 3d-ar-studio on npm, with a hosted demo. One script tag gives any web page a working augmented-reality viewer.", "source_url": "https://github.com/nirholas/3D-AR-Studio", "importance": 3 },
+ { "id": "2026-08-27-seeker-home-screen", "date": "2026-08-27", "title": "Seeker app gets its own home screen and a verified badge", "category": "product", "summary": "The three.ws app on Solana Seeker opens on a home screen of its own at /seeker: one tap signs you in with Seed Vault, your agents are right there, and Seeker owners can carry a verified badge.", "source_url": "https://three.ws/seeker", "importance": 2 },
+ { "id": "2026-08-28-android-app", "date": "2026-08-28", "title": "three.ws ships as an Android app", "category": "launch", "summary": "The signed three.ws app (v1.0.0) is published on GitHub and installs on any phone from Android 6 up: one-tap Solana wallet sign-in (Seed Vault on a Seeker), selfie to rigged 3D avatar, share-sheet intake, and agent minting on Solana mainnet from the phone. The Solana dApp Store listing is submitted the same day.", "source_url": "https://github.com/nirholas/three.ws/releases", "importance": 4 },
+ { "id": "2026-08-28-glance", "date": "2026-08-28", "title": "Glance: your agent as a home-screen card", "category": "product", "summary": "Every agent gets a live card with its name, what it did in the last 24 hours, and when it last acted. It pins to the Windows 11 widgets board, renders in a GitHub README, and prints in a terminal.", "source_url": "https://three.ws/glance", "importance": 3 },
+ { "id": "2026-08-29-android-widget", "date": "2026-08-29", "title": "Android 1.1: the agent on the home screen", "category": "product", "summary": "The Android app ships a home-screen widget showing your agent, its name, and how many moves it made today, refreshing in the background about every half hour without opening the app.", "source_url": "https://github.com/nirholas/three.ws/releases", "importance": 2 },
+ { "id": "2026-08-29-coinmarketcap-android", "date": "2026-08-29", "title": "CoinMarketCap article announces three.ws for Android", "category": "press", "summary": "A CoinMarketCap community article covers the Android launch: what the app does that the mobile site cannot, and how the Solana-native sign-in works.", "source_url": "https://coinmarketcap.com/community/articles/6a926390b8e239054a8f42e6/", "importance": 2 },
+ { "id": "2026-08-29-huggingface-end-to-end", "date": "2026-08-29", "title": "Second Hugging Face article: Building 3D AI Agents End to End", "category": "press", "summary": "The whole stack in one piece, written to be checked: every 3D generation lane and where it runs, rigging and animation for any humanoid, the multi-model brain and its guard chain, agent payments, and every program and partner behind the platform, with a live rigged avatar embedded in the article.", "source_url": "https://huggingface.co/blog/three-ws/building-3d-ai-agents-end-to-end", "importance": 3 }
]
}
diff --git a/pages/timeline.html b/pages/timeline.html
index 2609c0c44..051d4bd70 100644
--- a/pages/timeline.html
+++ b/pages/timeline.html
@@ -43,7 +43,7 @@
.tl-header .sub { font-size: 0.72rem; color: rgba(255, 255, 255, 0.45); margin-left: auto; display: none; }
@media (min-width: 720px) { .tl-header .sub { display: inline; } }
- #timeline-root { flex: 1; min-height: 0; position: relative; }
+ #timeline-root { flex: 1; min-height: 0; position: relative; overflow: hidden; }
.tl-boot {
position: absolute; inset: 0; display: flex; flex-direction: column; align-items: center; justify-content: center;
diff --git a/prompts/swarm-100/route-timeline.md b/prompts/swarm-100/route-timeline.md
deleted file mode 100644
index 98c749181..000000000
--- a/prompts/swarm-100/route-timeline.md
+++ /dev/null
@@ -1,119 +0,0 @@
-# Route audit: /timeline (The Story So Far)
-
-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==='/timeline')console.log(JSON.stringify(g,null,2))"
-
-2. Find the serving implementation: grep "/timeline" 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/timeline
-
-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: /timeline ("The Story So Far", section "main").
-Declared purpose: three.ws's history as an explorable 3D scene: every launch, partnership, listing, and milestone laid out along a path you can orbit in 360° or walk end to end, with a synced scrubber and source links.
-
-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/timeline. 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 /timeline: 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-timeline.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/public/nav.js b/public/nav.js
index afb1b0bfc..9423767a2 100644
--- a/public/nav.js
+++ b/public/nav.js
@@ -840,7 +840,7 @@ const WALK_AUTO_KEY = 'walk:companion:auto';
// second WebGL avatar there hurts more than it helps. (walk-sdk keeps its own
// exclusion list too; this is the conservative outer gate.)
const WALK_AUTO_SKIP =
- /^\/(play|walk|club|tour|world|scan|arena|pose|splat|capture)(\/|$)|^\/create\/(selfie|video)/;
+ /^\/(play|walk|club|tour|world|scan|arena|pose|splat|capture|timeline)(\/|$)|^\/create\/(selfie|video)/;
function initCompanionAutoStart() {
// Every check lives inside the deferred callback: boot() can run while this
diff --git a/scripts/check-dist.mjs b/scripts/check-dist.mjs
index 8dc974f56..4607ccaf2 100644
--- a/scripts/check-dist.mjs
+++ b/scripts/check-dist.mjs
@@ -9,6 +9,10 @@ const required = [
'dist/agent-3d/latest/agent-3d.js',
'dist/agent-3d/latest/agent-3d.umd.cjs',
'dist/agent-3d/versions.json',
+ // The one runtime fetch behind /timeline (copied by vite.config.js's
+ // copy-timeline-data hook). It was missing from every production build
+ // until 2026-09-01, which left the page on its error state.
+ 'dist/data/timeline.json',
];
let ok = true;
diff --git a/src/timeline.js b/src/timeline.js
index b0b9fad14..661dd2e14 100644
--- a/src/timeline.js
+++ b/src/timeline.js
@@ -15,7 +15,6 @@ import {
BufferGeometry,
CanvasTexture,
CatmullRomCurve3,
- Clock,
Color,
CylinderGeometry,
DirectionalLight,
@@ -36,6 +35,7 @@ import {
ACESFilmicToneMapping,
Sprite,
SpriteMaterial,
+ Timer,
Vector2,
Vector3,
WebGLRenderer,
@@ -61,8 +61,14 @@ const boot = document.getElementById('timeline-boot');
// ── Styles (injected once; keeps pages/timeline.html to a plain shell) ─────
function injectStyles() {
+ if (document.getElementById('tl-styles')) return;
const css = `
.tl-canvas { position: absolute; inset: 0; display: block; width: 100%; height: 100%; touch-action: none; outline: none; }
+ .tl-canvas:focus-visible { outline: 2px solid rgba(154, 208, 255, 0.7); outline-offset: -3px; }
+ .tl-mode-btn:focus-visible, .tl-filter-chip:focus-visible, .tl-nav-btn:focus-visible, .tl-tick:focus-visible,
+ .tl-panel-close:focus-visible, .tl-panel-src:focus-visible, .tl-error button:focus-visible {
+ outline: 2px solid #9ad0ff; outline-offset: 2px;
+ }
.tl-topbar {
position: absolute; top: 0.85rem; left: 50%; transform: translateX(-50%);
@@ -90,7 +96,16 @@ function injectStyles() {
z-index: 20; display: flex; flex-direction: column; padding: 1.3rem 1.25rem;
color: #eef2fa; overflow-y: auto;
}
- .tl-panel.is-open { transform: translateX(0); }
+ /* Open, the panel is a surface the visitor asked for, so it sits above
+ the ambient bottom-right helper stack (language pill, discovery card)
+ on the ladder public/corner-stack.js publishes; on a phone that stack
+ otherwise lands squarely on the milestone text in the sheet. */
+ .tl-panel.is-open { transform: translateX(0); z-index: var(--z-overlay-modal, 2147483600); }
+ /* The open panel owns the right edge, so the scrubber bar (a later
+ sibling) gives up that column: Next and Play stay clickable while a
+ milestone is being read instead of sitting under the panel. */
+ .tl-panel.is-open ~ .tl-bottombar { right: min(380px, 100%); }
+ .tl-panel.is-open ~ .tl-hint { display: none; }
.tl-panel-close {
position: absolute; top: 0.8rem; right: 0.8rem; width: 30px; height: 30px; border-radius: 50%;
background: rgba(255,255,255,0.08); border: none; color: #fff; font-size: 1rem; cursor: pointer;
@@ -109,6 +124,7 @@ function injectStyles() {
font: 600 0.84rem system-ui, sans-serif; margin-top: auto; padding-top: 0.6rem;
}
.tl-panel-src:hover { text-decoration: underline; }
+ .tl-panel-src[hidden] { display: none; }
.tl-panel-counter { font: 600 0.72rem system-ui, sans-serif; color: rgba(255,255,255,0.4); margin-top: 0.4rem; }
.tl-bottombar {
@@ -133,7 +149,7 @@ function injectStyles() {
}
.tl-tick:hover { opacity: 0.9; }
.tl-tick.is-active { height: 30px; opacity: 1; transform: translateY(-4px); }
- .tl-tick.is-dim { opacity: 0.12; }
+ .tl-tick.is-dim { opacity: 0.12; cursor: default; }
.tl-scrub-label { text-align: center; font: 600 0.7rem system-ui, sans-serif; color: rgba(255,255,255,0.5); }
.tl-hint {
@@ -145,14 +161,20 @@ function injectStyles() {
.tl-error button { font: 650 0.82rem system-ui, sans-serif; background: #7aa2ff; color: #06080f; border: none; border-radius: 999px; padding: 0.55rem 1.2rem; cursor: pointer; }
@media (max-width: 640px) {
- .tl-panel { width: 100%; height: min(62vh, 420px); top: auto; bottom: 0; right: 0;
- transform: translateY(100%); border-left: none; border-top: 1px solid rgba(255,255,255,0.1); border-radius: 16px 16px 0 0; }
+ /* Bottom sheet, parked ABOVE the scrubber bar (its measured height is
+ published as --tl-bar-h) so prev / next / play stay reachable while
+ a milestone is open, and the bar keeps its full width. */
+ .tl-panel { width: 100%; height: min(56vh, 400px); top: auto; bottom: var(--tl-bar-h, 108px); right: 0;
+ background: rgba(8, 10, 18, 0.97);
+ transform: translateY(calc(100% + var(--tl-bar-h, 108px))); border-left: none; border-top: 1px solid rgba(255,255,255,0.1); border-radius: 16px 16px 0 0; }
.tl-panel.is-open { transform: translateY(0); }
+ .tl-panel.is-open ~ .tl-bottombar { right: 0; }
.tl-bottombar { padding-bottom: 0.7rem; }
.tl-hint { display: none; }
}
`;
const tag = document.createElement('style');
+ tag.id = 'tl-styles';
tag.textContent = css;
document.head.appendChild(tag);
}
@@ -263,24 +285,35 @@ function showError(message, onRetry) {
root.appendChild(wrap);
}
+const EMPTY_MESSAGE = 'No milestones have been published yet. Check back soon.';
+const OFFLINE_MESSAGE = 'Could not load the timeline. Check your connection and try again.';
+
async function loadData() {
- const res = await fetch(DATA_URL, { cache: 'force-cache' });
+ // Default HTTP caching, not force-cache: the file changes with every
+ // deploy and the server already sets a bounded max-age on it.
+ const res = await fetch(DATA_URL);
if (!res.ok) throw new Error(`HTTP ${res.status} loading timeline data`);
const json = await res.json();
if (!json || !Array.isArray(json.events) || json.events.length === 0) {
- throw new Error('Timeline data is empty');
+ const err = new Error('Timeline data is empty');
+ err.code = 'EMPTY';
+ throw err;
}
return json;
}
+function loadErrorMessage(err) {
+ return err?.code === 'EMPTY' ? EMPTY_MESSAGE : OFFLINE_MESSAGE;
+}
+
async function boot_() {
injectStyles();
if (!supportsWebGL()) {
try {
const data = await loadData();
renderFallback(data.events, 'Your browser can’t run the 3D scene.');
- } catch {
- showError('Could not load the timeline. Check your connection and try again.', () => location.reload());
+ } catch (err) {
+ showError(loadErrorMessage(err), () => location.reload());
}
return;
}
@@ -290,7 +323,7 @@ async function boot_() {
mountTimeline(root, data);
} catch (err) {
log.warn('[timeline] load failed:', err?.message);
- showError('Could not load the timeline. Check your connection and try again.', boot_);
+ showError(loadErrorMessage(err), boot_);
}
}
@@ -521,7 +554,10 @@ function mountTimeline(container, data) {
m.beam.material.opacity = dim ? 0.06 : 0.35;
m.label.material.opacity = dim ? 0.15 : 1;
const tick = scrubTicks[m.index];
- if (tick) tick.classList.toggle('is-dim', dim);
+ if (tick) {
+ tick.classList.toggle('is-dim', dim);
+ tick.setAttribute('aria-disabled', String(dim));
+ }
});
}
@@ -539,9 +575,10 @@ function mountTimeline(container, data) {
<div class="tl-panel-date" id="tl-panel-date"></div>
<h2 class="tl-panel-title" id="tl-panel-title"></h2>
<p class="tl-panel-summary" id="tl-panel-summary"></p>
- <a class="tl-panel-src" id="tl-panel-src" target="_blank" rel="noopener noreferrer" style="display:none">Read the source ↗</a>
+ <a class="tl-panel-src" id="tl-panel-src" target="_blank" rel="noopener noreferrer" hidden>Read the source ↗</a>
<div class="tl-panel-counter" id="tl-panel-counter"></div>
`;
+ panel.inert = true;
container.appendChild(panel);
panel.querySelector('.tl-panel-close').addEventListener('click', () => setPanelOpen(false));
@@ -549,6 +586,9 @@ function mountTimeline(container, data) {
state.panelOpen = open;
panel.classList.toggle('is-open', open);
panel.setAttribute('aria-hidden', open ? 'false' : 'true');
+ // A closed panel is off-screen; keep its close button and source link
+ // out of the tab order so keyboard users never focus something invisible.
+ panel.inert = !open;
if (open && state.mode === 'orbit') controls.autoRotate = false;
}
@@ -577,8 +617,11 @@ function mountTimeline(container, data) {
const tick = document.createElement('button');
tick.className = 'tl-tick';
tick.style.background = categories[m.event.category]?.color || '#7aa2ff';
- tick.setAttribute('aria-label', `${m.event.date} — ${m.event.title}`);
+ tick.setAttribute('aria-label', `${m.event.date}: ${m.event.title}`);
tick.addEventListener('click', () => {
+ // Same rule as clicking a marker: a filtered-out milestone is not a
+ // destination until its category is switched back on.
+ if (!state.visibleCategories.has(m.event.category)) return;
togglePlay(false);
focusEvent(m.index, { fly: true });
});
@@ -659,9 +702,10 @@ function mountTimeline(container, data) {
const srcLink = panel.querySelector('#tl-panel-src');
if (m.event.source_url) {
srcLink.href = m.event.source_url;
- srcLink.style.display = 'inline-flex';
+ srcLink.hidden = false;
} else {
- srcLink.style.display = 'none';
+ srcLink.removeAttribute('href');
+ srcLink.hidden = true;
}
panel.querySelector('#tl-panel-counter').textContent = `Milestone ${index + 1} of ${events.length}`;
setPanelOpen(true);
@@ -730,12 +774,37 @@ function mountTimeline(container, data) {
ro.observe(container);
resize();
+ // ── keep the shared bottom-right helper stack off the scrubber ──
+ // public/corner-stack.js lifts itself over a page's own bottom chrome by
+ // probing for position:fixed boxes. This bar is absolute inside the scene
+ // root, so it is invisible to that probe and the "Getting started" pill
+ // landed on the auto-play button. Reserve the bar's live footprint the way
+ // the concierge demo does, and re-measure whenever the bar changes size.
+ const CORNER_KEY = 'timeline-scrubber';
+ function syncCornerReserve() {
+ if (state.destroyed) return;
+ const r = bottombar.getBoundingClientRect();
+ container.style.setProperty('--tl-bar-h', `${Math.ceil(r.height)}px`);
+ const stack = window.twsCornerStack;
+ if (!stack?.reserve) return;
+ if (!r.height) {
+ stack.release(CORNER_KEY);
+ return;
+ }
+ stack.reserve(CORNER_KEY, { height: Math.max(0, Math.ceil(window.innerHeight - r.top)) });
+ }
+ const barRo = new ResizeObserver(syncCornerReserve);
+ barRo.observe(bottombar);
+ window.addEventListener('tws-corner-stack:ready', syncCornerReserve);
+ syncCornerReserve();
+
// ── render loop ──
- const clock = new Clock();
+ const timer = new Timer();
let raf = 0;
function tick() {
if (state.destroyed) return;
- guideAnim?.update(clock.getDelta());
+ timer.update();
+ guideAnim?.update(timer.getDelta());
if (state.mode === 'walk') {
const t = currentWalkT();
@@ -787,6 +856,9 @@ function mountTimeline(container, data) {
cancelAnimationFrame(raf);
clearTimeout(state.playTimer);
ro.disconnect();
+ barRo.disconnect();
+ window.removeEventListener('tws-corner-stack:ready', syncCornerReserve);
+ window.twsCornerStack?.release?.(CORNER_KEY);
canvas.removeEventListener('pointerdown', onPointerDown);
window.removeEventListener('keydown', onKeydown);
controls.dispose();
diff --git a/src/walk-companion.js b/src/walk-companion.js
index c59eb8a8d..cfe0fac01 100644
--- a/src/walk-companion.js
+++ b/src/walk-companion.js
@@ -39,7 +39,10 @@ const walk = createWalkCompanion({
// is a persistent live stage of THIS user's agent, so the corner mascot is a
// second copy of the same body, and its 218px corner reservation pushed the
// stack's chips into the middle of the editing panel at 320px.
- excludedRoutes: [...DEFAULT_EXCLUDED_PREFIXES, '/concierge', '/agent-studio'],
+ // /timeline is a full-screen 3D scene with its own idle-animated guide
+ // walking the path, and its bottom-right corner is the auto-play button:
+ // the corner mascot sat exactly on top of it and swallowed the click.
+ excludedRoutes: [...DEFAULT_EXCLUDED_PREFIXES, '/concierge', '/agent-studio', '/timeline'],
});
// public/nav.js drives the companion through this global (toggle from the nav
diff --git a/tests/timeline-data.test.js b/tests/timeline-data.test.js
new file mode 100644
index 000000000..9840a5696
--- /dev/null
+++ b/tests/timeline-data.test.js
@@ -0,0 +1,81 @@
+/**
+ * /timeline dataset integrity tests.
+ *
+ * The 3D history timeline (src/timeline.js) renders straight from
+ * data/timeline.json, so the data IS the product: marker order, color,
+ * scale, and every "Read the source" link come from these fields. These
+ * tests guard the invariants the page relies on and the production wiring
+ * that once silently broke it (the file must reach dist/, see vite.config.js
+ * and scripts/check-dist.mjs).
+ */
+
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { describe, it, expect } from 'vitest';
+
+const root = resolve(import.meta.dirname, '..');
+const data = JSON.parse(readFileSync(resolve(root, 'data/timeline.json'), 'utf8'));
+const ISO_DAY = /^\d{4}-\d{2}-\d{2}$/;
+const HEX_COLOR = /^#[0-9a-f]{6}$/i;
+
+describe('timeline dataset', () => {
+ it('declares categories with a label and a hex color', () => {
+ const entries = Object.entries(data.categories);
+ expect(entries.length).toBeGreaterThan(0);
+ for (const [key, meta] of entries) {
+ expect(key, 'category key').toMatch(/^[a-z]+$/);
+ expect(meta.label.trim().length, `${key} label`).toBeGreaterThan(0);
+ expect(meta.color, `${key} color`).toMatch(HEX_COLOR);
+ }
+ });
+
+ it('has a non-empty, chronologically ordered event list', () => {
+ expect(Array.isArray(data.events)).toBe(true);
+ expect(data.events.length).toBeGreaterThan(0);
+ for (let i = 1; i < data.events.length; i++) {
+ const prev = data.events[i - 1];
+ const cur = data.events[i];
+ expect(cur.date >= prev.date, `${cur.id} (${cur.date}) sorts before ${prev.id} (${prev.date})`).toBe(true);
+ }
+ });
+
+ it('gives every event a unique id, an ISO date, copy, a known category, and a 1-5 importance', () => {
+ const seen = new Set();
+ for (const e of data.events) {
+ expect(typeof e.id, 'id').toBe('string');
+ expect(seen.has(e.id), `duplicate id ${e.id}`).toBe(false);
+ seen.add(e.id);
+ expect(e.date, `${e.id} date`).toMatch(ISO_DAY);
+ expect(e.id.startsWith(e.date), `${e.id} should be prefixed by its date`).toBe(true);
+ expect(e.title.trim().length, `${e.id} title`).toBeGreaterThan(0);
+ expect(e.summary.trim().length, `${e.id} summary`).toBeGreaterThan(0);
+ expect(data.categories[e.category], `${e.id} category ${e.category}`).toBeDefined();
+ expect(Number.isInteger(e.importance) && e.importance >= 1 && e.importance <= 5, `${e.id} importance`).toBe(true);
+ }
+ });
+
+ it('links sources over https or explicitly declares none', () => {
+ for (const e of data.events) {
+ expect('source_url' in e, `${e.id} must declare source_url`).toBe(true);
+ if (e.source_url !== null) {
+ expect(e.source_url, `${e.id} source_url`).toMatch(/^https:\/\/[^\s"]+$/);
+ }
+ }
+ });
+
+ it('never carries the banned dash characters into the page', () => {
+ for (const e of data.events) {
+ for (const field of ['title', 'summary']) {
+ expect(/[\u2013\u2014]/.test(e[field]), `${e.id} ${field} uses a banned dash`).toBe(false);
+ }
+ }
+ });
+
+ it('is copied into dist/ by the build and required by check:dist', () => {
+ const vite = readFileSync(resolve(root, 'vite.config.js'), 'utf8');
+ const checkDist = readFileSync(resolve(root, 'scripts/check-dist.mjs'), 'utf8');
+ expect(vite).toContain("name: 'copy-timeline-data'");
+ expect(vite).toContain("'dist/data/timeline.json'");
+ expect(checkDist).toContain("'dist/data/timeline.json'");
+ });
+});
diff --git a/vite.config.js b/vite.config.js
index b7ab22f74..fed226822 100644
--- a/vite.config.js
+++ b/vite.config.js
@@ -3,9 +3,11 @@ import { resolve } from 'path';
import {
readFileSync,
readdirSync,
+ copyFileSync,
cpSync,
createReadStream,
existsSync,
+ mkdirSync,
statSync,
rmSync,
} from 'fs';
@@ -2853,6 +2855,19 @@ const appConfig = {
}
},
},
+ {
+ // /timeline fetches its milestones from /data/timeline.json at runtime.
+ // The dev server resolves that against the repo root, but production
+ // serves dist/ alone, so without this copy the page shipped for weeks
+ // with a working shell and a 404 behind its one fetch: every visitor
+ // landed on the "Could not load the timeline" state. check:dist now
+ // refuses a build that lacks the copy.
+ name: 'copy-timeline-data',
+ closeBundle() {
+ mkdirSync(resolve(__dirname, 'dist/data'), { recursive: true });
+ copyFileSync(resolve(__dirname, 'data/timeline.json'), resolve(__dirname, 'dist/data/timeline.json'));
+ },
+ },
{
// The IBM × three.ws x402 demo (pages/ibm/x402-demo.html) is a hand-
// authored, self-contained partner artifact — inline CSS+JS, self-hosted