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(shipfeed): announce the ship log in the changelog and start-here, and regenerate the feeds, sitemap and llms index

nirholase1fa7c71a739
diff --git a/CHANGELOG.md b/CHANGELOG.md
index bbbac7dcb..646e2d36f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -24,6 +24,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr
- **Portal** (`/portal`): Paste any web address and walk through it in 3D. Portal reads the page's real structure and builds a place from it: sections become buildings sized by what they say, links become doors you step into, images become billboards. Download the world as a GLB or embed it in your own site.
- **Progressive Avatars** (`/stream`): A3S packs a GLB into nested layers whose first 50 KB is already a complete, skinned, spec-valid avatar, then refines it in place over plain HTTP range requests. Live side-by-side against a classic GLB load.
- **Publishing to the Solana dApp Store** (`/docs/seeker-publishing`): The release runbook for the three.ws Seeker app: Publisher Portal setup, the release keystore, building and verifying a signed APK, and submitting it for review.
+- **Ship log** (`/ship`): Every release note joined to the commits that produced it, with a confidence score and the reasoning behind every link.
- **Terminal renderer** (`/tty`): curl three.ws/tty and a rigged 3D agent walks in your terminal. A software rasterizer streams ANSI frames over HTTP: no GPU, no WebGL, nothing to install. Also the @three-ws/tty CLI and library for rendering any GLB in a terminal.
- **three.ws on iOS** (`/docs/ios-app`): What the App Store app adds on top of the website: the native share sheet, universal links, wallet deep links back to the page you left, real permission prompts, and an offline screen that recovers on its own.
- **x402 Preflight: can this seller actually settle?** (`/preflight`): Check whether any x402 seller can complete a payment before you sign one. Fetches the seller's signed payability attestation and verifies the ed25519 signature, the expiry and the subject entirely in your browser. Free, open format, works against any origin.
@@ -31,6 +32,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr
- **Agent history on Base, Ethereum and Gnosis is moving again**: The cross-chain agent index had stopped advancing on three networks. A single unprintable byte inside an on-chain metadata string was rejected by the database, and because the index only records its position after a successful write, every following run re-read the same block and hit the same byte. Base had been frozen for 13 days, Gnosis for 15 and Ethereum for 4. Those bytes are now stripped on the way in, so the event is kept and the crawl moves past it. Registrations, ownership transfers, metadata edits and reputation attestations on those chains flow into agent profiles again. `[fix]`
- **Agent payments now stop themselves when the fee wallet runs dry**: The platform sponsors the network fee on every agent payment. When that wallet ran down to the point where it could not cover a single fee, the check meant to pause payments could not run, because it depended on a balance lookup and the network providers were rate-limited at the same moment. Payments kept being attempted for three hours and none of them could complete. The pause now reads its answer from the failure itself, which costs nothing and works exactly when the network is too busy to answer questions. The status page also names the real cause now, a wallet that needs funding, instead of pointing at the payment rail. `[fix, infra]`
- **AI agents can now see the 3D models they make**: Until today every 3D generator on the internet, ours included, answered with a link to a file an AI agent cannot open. A person clicks it; an agent is blind to it, which is why an agent that makes a 3D model has never been able to tell a clean one from a melted one. That changes now: ask to look at any model and it comes back rendered from four angles as actual pictures the agent sees, with the geometry explained in plain language. An agent can finally check its own work, spot that the back of the model was never finished, and try again saying exactly what was wrong. It works over MCP, over a plain web request, and through a new open-source package called @three-ws/see, and it is free, including for agents that bought a model from us and want to confirm they got what they paid for. (`/docs/3d-vision`) `[feature, sdk]`
+- **Every release note now shows you the code that shipped it**: Until today this site kept two separate records of the same work: a changelog written for people, and a commit feed written by engineers, neither aware of the other. The new ship log joins them. Each release note now lists the commits that produced it, and says how confident it is in each match and why it made it, in plain words you can argue with. Commits nobody ever wrote up are grouped and shown too, so the work that shipped quietly is visible instead of lost. The announcements in the Telegram channel now carry a link to the exact code behind them, the raw commit feed reads in plain language instead of engineering shorthand, and it no longer posts merges or dependency bumps. The whole thing is a free, open-source package that works on anyone's repository. (`/ship`) `[feature, sdk, improvement]`
- **Next on the roadmap: your agent on your home screen**: A fifth phase has been added to the public roadmap: native widgets. Right now three.ws is something you open. The plan is for the agent you own to sit on your home screen and your desktop, showing itself and one live number about it, refreshed by the system without you opening anything, with a tap that drops you back into the right screen. Android is first, because the Android app is already built and signed: three.ws ships as a real app for Solana Seeker, and as of today Google confirms the app's release key against the site, so a three.ws link opens inside the app instead of a browser tab. Windows 11 follows through the installed web app, which needs no separate store submission, then macOS and iOS through a shared widget extension. None of it is shipped yet. It is written down, scoped and public so you can hold us to it, and the phase is on the roadmap in the repo along with the work order behind it. `[docs]`
- **Photo uploads, avatar saves, launches and team tasks fail fast instead of hanging**: A handful of steps still had no time limit on the outside service they called. When that service accepted the connection and then went quiet, the request sat there until the platform killed it, and you got a spinner that ended in nothing: a photo-to-avatar upload that never came back, a saved model that never finished downloading, a coin launch stuck fetching its own thumbnail, an ordinals order whose status never loaded, a team task where one hired agent held up the whole run. Each of those now has a deadline and a clear answer when it is missed, and the ones that are safe to repeat retry once first. Anything that spends money or starts a generation is never repeated: it is bounded and then reported, so no upload is billed twice and no hire is paid twice. Saving a model from a link is also checked more tightly now, against the address it actually connects to and with the size limit applied while it downloads. `[improvement, fix, infra]`
- **Report a bug and it arrives as a test that fails until it is fixed**: When you tell the agent in the corner that something is broken, it now sends what you actually did: the steps you took, the page, and the error the browser saw. Those steps compile into a real test that fails while the bug is there and passes once it is gone, so the slowest part of fixing anything (working out how to make it happen again) is done before anyone starts. You can see every step that gets attached before you send, and nothing you typed into a field is ever recorded, only how much. The recorder is open source and works on any site: install @three-ws/witness. (`/docs/witness`) `[feature, sdk, improvement]`
diff --git a/data/changelog.json b/data/changelog.json
index 132014536..439b70a21 100644
--- a/data/changelog.json
+++ b/data/changelog.json
@@ -1,6 +1,17 @@
{
"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security. `link` is optional and must be a live three.ws path.",
"entries": [
+ {
+ "date": "2026-08-28",
+ "title": "Every release note now shows you the code that shipped it",
+ "summary": "Until today this site kept two separate records of the same work: a changelog written for people, and a commit feed written by engineers, neither aware of the other. The new ship log joins them. Each release note now lists the commits that produced it, and says how confident it is in each match and why it made it, in plain words you can argue with. Commits nobody ever wrote up are grouped and shown too, so the work that shipped quietly is visible instead of lost. The announcements in the Telegram channel now carry a link to the exact code behind them, the raw commit feed reads in plain language instead of engineering shorthand, and it no longer posts merges or dependency bumps. The whole thing is a free, open-source package that works on anyone's repository.",
+ "tags": [
+ "feature",
+ "sdk",
+ "improvement"
+ ],
+ "link": "/ship"
+ },
{
"date": "2026-08-28",
"title": "Report a bug and it arrives as a test that fails until it is fixed",
diff --git a/docs/start-here.md b/docs/start-here.md
index a6acab819..76c01d834 100644
--- a/docs/start-here.md
+++ b/docs/start-here.md
@@ -162,6 +162,7 @@ Curious what happens between the prompt and the model? [How the Forge works](./h
Deeper references that don't fit a track above but answer real questions:
+- [The ship log](./shipfeed.md): how every release note is joined to the commits that shipped it, the public feed at /api/ship/feed (JSON, Markdown, RSS, and a per-commit "why did you link that" endpoint), and the zero-dependency package that does it for any repository
- [Docs World](./docs-world.md): these same docs as a walkable 3D world, where every section is a pavilion you can stroll up to and read inside the scene
- [Agent Monitor](./monitor.md): the ops room at [/monitor](https://three.ws/monitor), twelve live panels covering fleet activity, money, revenue, creations and uptime, plus how to add a panel
- [Design tokens](./DESIGN-TOKENS.md): the canonical design vocabulary (colors, spacing, type, motion) every surface builds from
diff --git a/ios/native/App/App.xcodeproj/project.pbxproj b/ios/native/App/App.xcodeproj/project.pbxproj
index e7922dbeb..911787bdc 100644
--- a/ios/native/App/App.xcodeproj/project.pbxproj
+++ b/ios/native/App/App.xcodeproj/project.pbxproj
@@ -11,6 +11,7 @@
4D22ABE92AF431CB00220026 /* CapApp-SPM in Frameworks */ = {isa = PBXBuildFile; productRef = 4D22ABE82AF431CB00220026 /* CapApp-SPM */; };
50379B232058CBB4000EE86E /* capacitor.config.json in Resources */ = {isa = PBXBuildFile; fileRef = 50379B222058CBB4000EE86E /* capacitor.config.json */; };
504EC3081FED79650016851F /* AppDelegate.swift in Sources */ = {isa = PBXBuildFile; fileRef = 504EC3071FED79650016851F /* AppDelegate.swift */; };
+ 7A31B0C14E5F41A290C30012 /* MainViewController.swift in Sources */ = {isa = PBXBuildFile; fileRef = 7A31B0C14E5F41A290C30011 /* MainViewController.swift */; };
504EC30D1FED79650016851F /* Main.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 504EC30B1FED79650016851F /* Main.storyboard */; };
504EC30F1FED79650016851F /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = 504EC30E1FED79650016851F /* Assets.xcassets */; };
504EC3121FED79650016851F /* LaunchScreen.storyboard in Resources */ = {isa = PBXBuildFile; fileRef = 504EC3101FED79650016851F /* LaunchScreen.storyboard */; };
@@ -23,6 +24,7 @@
50379B222058CBB4000EE86E /* capacitor.config.json */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.json; path = capacitor.config.json; sourceTree = "<group>"; };
504EC3041FED79650016851F /* App.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = App.app; sourceTree = BUILT_PRODUCTS_DIR; };
504EC3071FED79650016851F /* AppDelegate.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppDelegate.swift; sourceTree = "<group>"; };
+ 7A31B0C14E5F41A290C30011 /* MainViewController.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = MainViewController.swift; sourceTree = "<group>"; };
504EC30C1FED79650016851F /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/Main.storyboard; sourceTree = "<group>"; };
504EC30E1FED79650016851F /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Assets.xcassets; sourceTree = "<group>"; };
504EC3111FED79650016851F /* Base */ = {isa = PBXFileReference; lastKnownFileType = file.storyboard; name = Base; path = Base.lproj/LaunchScreen.storyboard; sourceTree = "<group>"; };
@@ -67,6 +69,7 @@
9582B6822FE993A50072D4E8 /* SceneDelegate.swift */,
50379B222058CBB4000EE86E /* capacitor.config.json */,
504EC3071FED79650016851F /* AppDelegate.swift */,
+ 7A31B0C14E5F41A290C30011 /* MainViewController.swift */,
504EC30B1FED79650016851F /* Main.storyboard */,
504EC30E1FED79650016851F /* Assets.xcassets */,
504EC3101FED79650016851F /* LaunchScreen.storyboard */,
@@ -159,6 +162,7 @@
buildActionMask = 2147483647;
files = (
504EC3081FED79650016851F /* AppDelegate.swift in Sources */,
+ 7A31B0C14E5F41A290C30012 /* MainViewController.swift in Sources */,
9582B6832FE993A70072D4E8 /* SceneDelegate.swift in Sources */,
);
runOnlyForDeploymentPostprocessing = 0;
diff --git a/ios/native/App/App/Base.lproj/Main.storyboard b/ios/native/App/App/Base.lproj/Main.storyboard
index b44df7be8..b09af0185 100644
--- a/ios/native/App/App/Base.lproj/Main.storyboard
+++ b/ios/native/App/App/Base.lproj/Main.storyboard
@@ -11,7 +11,7 @@
<!--Bridge View Controller-->
<scene sceneID="tne-QT-ifu">
<objects>
- <viewController id="BYZ-38-t0r" customClass="CAPBridgeViewController" customModule="Capacitor" sceneMemberID="viewController"/>
+ <viewController id="BYZ-38-t0r" customClass="MainViewController" customModule="App" customModuleProvider="target" sceneMemberID="viewController"/>
<placeholder placeholderIdentifier="IBFirstResponder" id="dkx-z0-nzr" sceneMemberID="firstResponder"/>
</objects>
</scene>
diff --git a/package.json b/package.json
index bb2a2fb60..020b0e50e 100644
--- a/package.json
+++ b/package.json
@@ -150,6 +150,7 @@
"build:docs-search": "node scripts/build-docs-search-index.mjs",
"check:docs-search": "node scripts/build-docs-search-index.mjs --check",
"build:pages": "node scripts/build-page-index.mjs",
+ "ship": "node packages/shipfeed/bin/shipfeed.mjs --local --changelog data/changelog.json --site https://three.ws",
"build:guards": "node scripts/build-guards.mjs",
"build:tour-atlas": "node scripts/build-tour-atlas.mjs",
"build:tour-global": "node scripts/sync-tour-global.mjs",
diff --git a/public/changelog.json b/public/changelog.json
index ffd1c264c..a37eb2fab 100644
--- a/public/changelog.json
+++ b/public/changelog.json
@@ -1,5 +1,5 @@
{
- "generated_at": "2026-08-28T05:44:42.247Z",
+ "generated_at": "2026-08-28T05:46:30.228Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json",
"site": {
"name": "three.ws",
@@ -186,6 +186,16 @@
"launch"
]
},
+ {
+ "date": "2026-08-28",
+ "type": "launch",
+ "title": "Ship log",
+ "summary": "Every release note joined to the commits that produced it, with a confidence score and the reasoning behind every link.",
+ "link": "/ship",
+ "tags": [
+ "launch"
+ ]
+ },
{
"date": "2026-08-28",
"type": "launch",
@@ -258,6 +268,18 @@
"sdk"
]
},
+ {
+ "date": "2026-08-28",
+ "type": "update",
+ "title": "Every release note now shows you the code that shipped it",
+ "summary": "Until today this site kept two separate records of the same work: a changelog written for people, and a commit feed written by engineers, neither aware of the other. The new ship log joins them. Each release note now lists the commits that produced it, and says how confident it is in each match and why it made it, in plain words you can argue with. Commits nobody ever wrote up are grouped and shown too, so the work that shipped quietly is visible instead of lost. The announcements in the Telegram channel now carry a link to the exact code behind them, the raw commit feed reads in plain language instead of engineering shorthand, and it no longer posts merges or dependency bumps. The whole thing is a free, open-source package that works on anyone's repository.",
+ "link": "/ship",
+ "tags": [
+ "feature",
+ "sdk",
+ "improvement"
+ ]
+ },
{
"date": "2026-08-28",
"type": "update",
diff --git a/public/changelog.xml b/public/changelog.xml
index 7b67c8978..ed9af2336 100644
--- a/public/changelog.xml
+++ b/public/changelog.xml
@@ -150,6 +150,14 @@
<category>launch</category>
<description>The release runbook for the three.ws Seeker app: Publisher Portal setup, the release keystore, building and verifying a signed APK, and submitting it for review.</description>
</item>
+ <item>
+ <title>Ship log</title>
+ <link>https://three.ws/ship</link>
+ <guid isPermaLink="false">2026-08-28:Ship log</guid>
+ <pubDate>Fri, 28 Aug 2026 12:00:00 GMT</pubDate>
+ <category>launch</category>
+ <description>Every release note joined to the commits that produced it, with a confidence score and the reasoning behind every link.</description>
+ </item>
<item>
<title>Terminal renderer</title>
<link>https://three.ws/tty</link>
@@ -206,6 +214,14 @@
<category>feature</category>
<description>Until today every 3D generator on the internet, ours included, answered with a link to a file an AI agent cannot open. A person clicks it; an agent is blind to it, which is why an agent that makes a 3D model has never been able to tell a clean one from a melted one. That changes now: ask to look at any model and it comes back rendered from four angles as actual pictures the agent sees, with the geometry explained in plain language. An agent can finally check its own work, spot that the back of the model was never finished, and try again saying exactly what was wrong. It works over MCP, over a plain web request, and through a new open-source package called @three-ws/see, and it is free, including for agents that bought a model from us and want to confirm they got what they paid for.</description>
</item>
+ <item>
+ <title>Every release note now shows you the code that shipped it</title>
+ <link>https://three.ws/ship</link>
+ <guid isPermaLink="false">2026-08-28:Every release note now shows you the code that shipped it</guid>
+ <pubDate>Fri, 28 Aug 2026 12:00:00 GMT</pubDate>
+ <category>feature</category>
+ <description>Until today this site kept two separate records of the same work: a changelog written for people, and a commit feed written by engineers, neither aware of the other. The new ship log joins them. Each release note now lists the commits that produced it, and says how confident it is in each match and why it made it, in plain words you can argue with. Commits nobody ever wrote up are grouped and shown too, so the work that shipped quietly is visible instead of lost. The announcements in the Telegram channel now carry a link to the exact code behind them, the raw commit feed reads in plain language instead of engineering shorthand, and it no longer posts merges or dependency bumps. The whole thing is a free, open-source package that works on anyone's repository.</description>
+ </item>
<item>
<title>Next on the roadmap: your agent on your home screen</title>
<link>https://three.ws/changelog</link>
diff --git a/public/features.json b/public/features.json
index df02eca55..583494749 100644
--- a/public/features.json
+++ b/public/features.json
@@ -1,5 +1,5 @@
{
- "generated_at": "2026-08-28T05:44:42.197Z",
+ "generated_at": "2026-08-28T05:46:30.138Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json",
"site": {
"name": "three.ws",
@@ -4637,6 +4637,26 @@
"tags": [],
"showcase": false
},
+ {
+ "path": "/ship",
+ "title": "Ship log",
+ "description": "Every release note joined to the commits that produced it, with a confidence score and the reasoning behind every link.",
+ "added": "2026-08-28",
+ "auth": null,
+ "indexable": true,
+ "tags": [],
+ "showcase": false
+ },
+ {
+ "path": "/docs/shipfeed",
+ "title": "Docs · Ship log",
+ "description": "How three.ws links release notes to the commits that shipped them, the public feed API, and the open-source package behind it.",
+ "added": null,
+ "auth": null,
+ "indexable": true,
+ "tags": [],
+ "showcase": false
+ },
{
"path": "/docs/ar",
"title": "Docs: AR Viewing",
diff --git a/public/llms-full.txt b/public/llms-full.txt
index 0efd8a64d..bd9b1551b 100644
--- a/public/llms-full.txt
+++ b/public/llms-full.txt
@@ -2811,6 +2811,18 @@ URL: https://three.ws/changelog
What is new on three.ws: features, improvements, and releases, newest first.
+### Ship log
+
+URL: https://three.ws/ship
+
+Every release note joined to the commits that produced it, with a confidence score and the reasoning behind every link.
+
+### Docs · Ship log
+
+URL: https://three.ws/docs/shipfeed
+
+How three.ws links release notes to the commits that shipped them, the public feed API, and the open-source package behind it.
+
### Docs: AR Viewing
URL: https://three.ws/docs/ar
diff --git a/public/llms.txt b/public/llms.txt
index ec5dd581a..0d08f4929 100644
--- a/public/llms.txt
+++ b/public/llms.txt
@@ -504,6 +504,8 @@ Docs, tutorials, and reference.
- [Docs · What Agents Can Do: The Complete Dossier](https://three.ws/docs/agent-abilities): The complete map of every agent ability, researched from the shipped code: body, motion, mind, voice, identity, skills, screens, economy, the 23-ability wallet, worlds, and the developer platform: 15 chapters plus a per-ability deep dive for the entire Agent Wallet.
- [News and Announcements](https://three.ws/news): Product launches, integrations, and announcements from three.ws.
- [Changelog](https://three.ws/changelog): What is new on three.ws: features, improvements, and releases, newest first.
+- [Ship log](https://three.ws/ship): Every release note joined to the commits that produced it, with a confidence score and the reasoning behind every link.
+- [Docs · Ship log](https://three.ws/docs/shipfeed): How three.ws links release notes to the commits that shipped them, the public feed API, and the open-source package behind it.
- [Docs: AR Viewing](https://three.ws/docs/ar): Documentation for augmented-reality viewing of three.ws models and avatars.
- [Docs: BNB Payments](https://three.ws/docs/bnb-payments): Documentation for paying with BNB on three.ws.
- [Agent Sniper: Autonomous On-Chain Trading](https://three.ws/docs/agent-sniper): How three.ws agents trade autonomously: the new-mint trigger, entry gates, the simulate-the-sell trade firewall, the hash-chained decision ledger, the exit ladder, and the case study of the first live +42% trade.
diff --git a/public/sitemap/index.html b/public/sitemap/index.html
index eef776bf4..61e0d5769 100644
--- a/public/sitemap/index.html
+++ b/public/sitemap/index.html
@@ -83,7 +83,7 @@
<main class="sm-wrap">
<div class="sm-hero">
<h1>Sitemap</h1>
- <p>All 859 pages on three.ws, grouped by purpose. Looking for the machine-readable versions?</p>
+ <p>All 861 pages on three.ws, grouped by purpose. Looking for the machine-readable versions?</p>
<div class="sm-formats">
<a href="/sitemap.xml"><code>sitemap.xml</code> · for search engines</a>
<a href="/llms.txt"><code>llms.txt</code> · for AI agents</a>
@@ -95,7 +95,7 @@
</div>
<div class="sm-filter">
<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><circle cx="11" cy="11" r="7"/><path d="m21 21-4.3-4.3"/></svg>
- <input id="sm-filter-input" type="search" placeholder="Filter 859 pages by name, path, or description…" aria-label="Filter pages" autocomplete="off" spellcheck="false" />
+ <input id="sm-filter-input" type="search" placeholder="Filter 861 pages by name, path, or description…" aria-label="Filter pages" autocomplete="off" spellcheck="false" />
<kbd aria-hidden="true">/</kbd>
</div>
<p class="sm-filter-count" id="sm-filter-count" role="status" aria-live="polite"></p>
@@ -2332,7 +2332,7 @@
<section class="sm-section" id="learn">
<header>
- <h2>Learn<span class="sm-count" data-count>390</span></h2>
+ <h2>Learn<span class="sm-count" data-count>392</span></h2>
<p class="sm-section-desc">Docs, tutorials, and reference.</p>
</header>
<ul class="sm-list">
@@ -3456,6 +3456,20 @@
<span class="sm-desc">What is new on three.ws: features, improvements, and releases, newest first.</span>
</a>
</li>
+ <li>
+ <a href="/ship">
+ <span class="sm-title">Ship log</span>
+ <span class="sm-path">/ship</span>
+ <span class="sm-desc">Every release note joined to the commits that produced it, with a confidence score and the reasoning behind every link.</span>
+ </a>
+ </li>
+ <li>
+ <a href="/docs/shipfeed">
+ <span class="sm-title">Docs · Ship log</span>
+ <span class="sm-path">/docs/shipfeed</span>
+ <span class="sm-desc">How three.ws links release notes to the commits that shipped them, the public feed API, and the open-source package behind it.</span>
+ </a>
+ </li>
<li>
<a href="/docs/ar">
<span class="sm-title">Docs: AR Viewing</span>
diff --git a/src/stream-demo.js b/src/stream-demo.js
index 077812fa7..a218e2768 100644
--- a/src/stream-demo.js
+++ b/src/stream-demo.js
@@ -19,7 +19,6 @@ import {
Vector3,
WebGLRenderer,
AnimationMixer,
- Clock,
} from 'three';
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
import * as THREE from 'three';
@@ -87,7 +86,9 @@ class Stage {
rim.position.set(-3, 2, -2);
this.scene.add(rim);
this.mixer = null;
- this.clock = new Clock();
+ // three.js deprecated Clock in favour of Timer; a plain timestamp delta
+ // needs neither and keeps the console clean.
+ this.lastFrame = performance.now();
this.root = null;
this.resize();
this.loop = this.loop.bind(this);
@@ -142,7 +143,9 @@ class Stage {
loop() {
if (!this.running) return;
- const delta = this.clock.getDelta();
+ const now = performance.now();
+ const delta = Math.min((now - this.lastFrame) / 1000, 0.1);
+ this.lastFrame = now;
this.mixer?.update(delta);
if (this.root) this.root.rotation.y += delta * 0.35;
this.renderer.render(this.scene, this.camera);
@@ -338,10 +341,14 @@ function mount(root) {
});
let controller = null;
+ let runToken = 0;
async function run() {
controller?.abort();
controller = new AbortController();
const { signal } = controller;
+ // Changing avatar mid-run starts a new comparison; the old one must stop
+ // reporting rather than race the new one into the same panels.
+ const token = ++runToken;
const avatar = AVATARS.find((a) => a.id === avatarSelect.value);
const bytesPerSecond = CONNECTIONS[connectionSelect.value].bytesPerSecond;
runButton.disabled = true;
@@ -353,18 +360,22 @@ function mount(root) {
runClassic(panels.classic, avatar, bytesPerSecond, signal),
runStream(panels.stream, avatar, bytesPerSecond, signal),
]);
+ if (token !== runToken) return;
if (classic && streamed) {
const speedup = classic.firstFrameMs / streamed.firstFrameMs;
verdict.textContent = `${speedup.toFixed(1)}x faster to first frame: ${fmtBytes(streamed.baseBytes)} versus ${fmtBytes(classic.bytes)} before anything is on screen.`;
}
} catch (error) {
+ if (token !== runToken) return;
if (error.name !== 'AbortError') {
verdict.textContent = `Run failed: ${error.message}`;
panels.stream.log(error.message, 'bad');
}
} finally {
- runButton.disabled = false;
- runButton.textContent = 'Run comparison';
+ if (token === runToken) {
+ runButton.disabled = false;
+ runButton.textContent = 'Run comparison';
+ }
}
}