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.

feat(announce): give every drafted announcement a tier, a feature probe and a link the checker can resolve

ni3aa195cd45835b
diff --git a/api/_lib/announce/draft.js b/api/_lib/announce/draft.js
index f04b1e128..be503c787 100644
--- a/api/_lib/announce/draft.js
+++ b/api/_lib/announce/draft.js
@@ -60,10 +60,12 @@ Hard rules, each enforced by a machine after you answer:
- @mentions only for an account the surface genuinely runs on, at most two, each with the reason recorded. The brief's partner field is a suggestion, not a licence: drop it if the brief does not show the surface really runs on them.
- Alt text describes what is in the image for someone who cannot see it, at least 60 characters, and does not repeat the post or open with "image of".
+Declare at least one feature probe in \`probes\`, and prove the feature works rather than that its page loads. An \`api\` probe is the cheap one and the only kind re-run seconds before publishing: {"type":"api","name":"what it proves","url":"https://three.ws/api/...","expect":{"json":{"path":"a.b","min":1}}}, drawn from the brief's \`endpoints\` list. A \`browser\` probe drives the live route: {"type":"browser","name":"what it proves","steps":[{"goto":"the brief's url"},{"click":"visible button text"},{"expect":"text that only appears once it worked"}]}. Use only routes and endpoints the brief names.
+
The same announcement also goes to the community Telegram channel, which has no character limit and a slightly longer register. Write that version too: two to four sentences, the same facts, no hashtags, no emoji, no dashes, and the same link.
Respond with a single JSON object and nothing else:
-{"post":"...","thread":["optional reply","optional reply"],"telegram":"...","alt":"...","claims":[{"says":"exact words from your post","evidence":[{...one of the brief's evidenceCandidates, copied exactly...}]}],"mentions":{"@handle":"why the tag is true"},"why":"two sentences for the approver: what the post leads on and why that is the strongest true thing about this surface","headline":"a five to nine word title for the announcement pack"}`;
+{"post":"...","thread":["optional reply","optional reply"],"telegram":"...","alt":"...","probes":[{"type":"api","name":"...","url":"..."}],"claims":[{"says":"exact words from your post","evidence":[{...one of the brief's evidenceCandidates, copied exactly...}]}],"mentions":{"@handle":"why the tag is true"},"why":"two sentences for the approver: what the post leads on and why that is the strongest true thing about this surface","headline":"a five to nine word title for the announcement pack"}`;
export function buildDraftRequest(brief, { voice = null, findings = [], previous = null } = {}) {
const guidance = [
@@ -104,6 +106,7 @@ export function parseDraft(raw) {
draft.thread = Array.isArray(draft.thread) ? draft.thread.filter((row) => String(row || '').trim()) : [];
draft.telegram = String(draft.telegram || '').trim();
draft.claims = Array.isArray(draft.claims) ? draft.claims : [];
+ draft.probes = Array.isArray(draft.probes) ? draft.probes.filter((probe) => probe && probe.type) : [];
draft.mentions = draft.mentions && typeof draft.mentions === 'object' ? draft.mentions : {};
return draft;
}
@@ -130,6 +133,10 @@ export function itemFor(brief, draft, { mediaPath, probe = null, status = 'draft
],
claims: draft.claims,
mentions: draft.mentions,
+ // The review bar refuses an item with no feature probe, so the drafter
+ // declares one and it travels into the item. Without this every pack the
+ // factory produced failed review for the same missing field.
+ probes: Array.isArray(draft.probes) ? draft.probes : [],
};
}
diff --git a/api/_lib/x-content/verify.js b/api/_lib/x-content/verify.js
index cb7d9e075..c221dd8cc 100644
--- a/api/_lib/x-content/verify.js
+++ b/api/_lib/x-content/verify.js
@@ -44,15 +44,26 @@ async function fetchWithTimeout(url, init = {}, ms = 20_000) {
}
}
+// npm answers 403 to every non-browser user agent on a package page, so a post
+// linking a package we publish could never pass the link check. The registry is
+// the authoritative record of whether that package page exists, and it answers
+// any client, so an npm package link is resolved there instead.
+export function linkProbeUrl(url) {
+ const match = /^https?:\/\/(?:www\.)?npmjs\.com\/package\/((?:@[^/]+\/)?[^/?#]+)/i.exec(url);
+ return match ? `https://registry.npmjs.org/${match[1].replace('/', '%2F')}` : url;
+}
+
// Links must answer 2xx after redirects. Runs in production too, right before
// a post is sent, because a page can break between review and publish.
export async function linkChecks(texts) {
const checks = [];
for (const url of linksIn(texts)) {
try {
- const response = await fetchWithTimeout(url);
+ const probe = linkProbeUrl(url);
+ const response = await fetchWithTimeout(probe);
const ok = response.status >= 200 && response.status < 300;
- checks.push({ kind: 'link', target: url, ok, detail: ok ? `HTTP ${response.status}${response.url !== url ? ` via ${response.url}` : ''}` : `HTTP ${response.status}` });
+ const via = probe !== url ? ` via the npm registry` : response.url !== url ? ` via ${response.url}` : '';
+ checks.push({ kind: 'link', target: url, ok, detail: ok ? `HTTP ${response.status}${via}` : `HTTP ${response.status}${via}` });
} catch (err) {
checks.push({ kind: 'link', target: url, ok: false, detail: `unreachable: ${err.message}` });
}
diff --git a/data/announce-deferred.json b/data/announce-deferred.json
index 2be7e0f57..a5e30de02 100644
--- a/data/announce-deferred.json
+++ b/data/announce-deferred.json
@@ -3,13 +3,14 @@
"deferred": {
"/genome": "Captured 2026-09-04 for the first pack batch and deferred: the page sells a stud market with nothing listed in it, so the frame advertises an empty room. Revisit once genome listings are live.",
"/portfolio": "Captured 2026-09-04 for the first pack batch and deferred: the page is an address input with no state until a wallet is pasted, so there is no frame that shows the product working. Revisit once a demo address or a signed-in default lands.",
- "/alpha-copilot": "Held under the operating rules' commit gate on content referencing a crypto project other than $THREE: the page's whole subject is reading live third-party launches, and any honest frame of it is a wall of other projects' names and tickers. Owner approval on the frame and the copy releases it.",
+ "/alpha-copilot": "Held under the operating rules' commit gate on content referencing a crypto project other than $THREE: the page's whole subject is reading live third-party launches, so any honest frame of it is a wall of other projects' names and tickers. Owner approval on the frame and the copy releases it.",
"/autopilot": "Held under the operating rules' commit gate on content referencing a crypto project other than $THREE: the cockpit is pointed at a third-party coin, so the frame and the copy both name one. Owner approval releases it.",
- "/agenc/room": "Held under the operating rules' commit gate on content referencing a crypto project other than $THREE: the room is the AgenC protocol (a third-party on-chain marketplace) shown live. Owner approval on naming AgenC releases it, along with the rest of the AgenC surfaces.",
- "/agenc/embodied": "Held under the operating rules' commit gate on content referencing a crypto project other than $THREE: the same AgenC protocol, embodied. Release it with /agenc/room.",
- "@three-ws/agenc-mcp": "Held under the operating rules' commit gate on content referencing a crypto project other than $THREE: the package exists to speak to AgenC, so no pack can avoid naming it. Release it with /agenc/room.",
- "@three-ws/agora-mcp": "Held under the operating rules' commit gate on content referencing a crypto project other than $THREE: Agora's job board is AgenC tasks plus x402 services, so the pack names AgenC. Release it with /agenc/room.",
- "@three-ws/agent-sniper": "Held under the operating rules' commit gate on content referencing a crypto project other than $THREE: the package is a pump.fun sniper engine, named in its own title. Owner approval on naming pump.fun releases it, along with the other pump.fun packages.",
- "@three-ws/alerts-mcp": "Held under the operating rules' commit gate on content referencing a crypto project other than $THREE: the package manages pump.fun alert rules, named in its own title. Release it with @three-ws/agent-sniper."
+ "/agenc/room": "Held under the operating rules' commit gate on content referencing a crypto project other than $THREE: the room shows a third-party on-chain coordination protocol running live, and no honest pack can avoid naming it. Owner approval on naming that protocol releases this surface and the three below it.",
+ "/agenc/embodied": "Held under the operating rules' commit gate on content referencing a crypto project other than $THREE: the same third-party protocol, embodied. Release it with /agenc/room.",
+ "@three-ws/agenc-mcp": "Held under the operating rules' commit gate on content referencing a crypto project other than $THREE: the package exists to speak to that third-party protocol, which its own title carries. Release it with /agenc/room.",
+ "@three-ws/agora-mcp": "Held under the operating rules' commit gate on content referencing a crypto project other than $THREE: its job board is fed by that same third-party protocol alongside our own x402 services. Release it with /agenc/room.",
+ "@three-ws/agent-sniper": "Held under the operating rules' commit gate on content referencing a crypto project other than $THREE: the package is built for a third-party launchpad, named in its own title. Owner approval on naming that launchpad releases this package and the one below it.",
+ "@three-ws/alerts-mcp": "Held under the operating rules' commit gate on content referencing a crypto project other than $THREE: the package manages alert rules for that same third-party launchpad, named in its own title. Release it with @three-ws/agent-sniper.",
+ "/mocap-studio": "Captured 2026-09-20 and deferred: the page drives an avatar's face from your webcam, and the capture rig is a headless browser with no camera, so every frame of it shows the studio waiting rather than working. Revisit with a recorded clip shot on a real machine."
}
}
diff --git a/data/announce-media.json b/data/announce-media.json
index 29ce73ddb..3f2bb304e 100644
--- a/data/announce-media.json
+++ b/data/announce-media.json
@@ -161,18 +161,6 @@
"description": "three.ws live discovery surface from any AI agent, trending agents and coins, the $THREE holder leaderboard with tiers, and the site-wide activity ticker. Read-only over the live public API. No key, no signer, no payment."
}
},
- {
- "id": "mocap-studio-hero",
- "surface": "/mocap-studio",
- "url": "/mocap-studio",
- "alt": "The Mocap Studio page with a 3D avatar mirroring a face from the webcam preview beside it, the record controls under the viewer and the saved-clips row empty below.",
- "caption": "Captured from the live /mocap-studio route for the mocap-studio announcement.",
- "settle": 9000,
- "motion": {
- "seconds": 5,
- "fps": 12
- }
- },
{
"id": "knock-hero",
"surface": "/knock",
@@ -196,7 +184,7 @@
"id": "assistant-hero",
"surface": "/assistant",
"url": "/assistant",
- "alt": "The assistant configurator with the option columns on the left and the floating launcher open in the corner showing a 3D avatar over the live page preview.",
+ "alt": "The assistant builder page: a Configure column with avatar, background, mode, name and greeting fields on the left, the one-line script snippet on the right, and the widget's round launcher button in the bottom corner.",
"caption": "Captured from the live /assistant route for the assistant announcement.",
"settle": 9000,
"motion": {
@@ -208,13 +196,15 @@
"id": "awesome-hero",
"surface": "/awesome",
"url": "/awesome",
- "alt": "The Awesome 3D Agents page on three.ws: a heading reading Everything you need to give an AI agent a body, counters for 152 entries, 15 sections, 121 free to use and 97 tags, a row of tag filters, and a grid of cards for projects such as TRELLIS, Hunyuan3D 2 and three.ws Text to 3D, each with a one sentence description.",
- "caption": "Captured from the live /awesome route for the awesome announcement.",
- "settle": 9000,
- "motion": {
- "seconds": 5,
- "fps": 12
- }
+ "alt": "The Awesome 3D Agents page on three.ws: a heading reading Everything you need to give an AI agent a body, counters for 152 entries, 15 sections, 121 free to use and 97 tags, a row of tag filters, and a grid of cards for projects such as TRELLIS, Hunyuan3D 2 and TripoSR, each with a one sentence description.",
+ "caption": "Captured from the live /awesome route for the awesome announcement."
+ },
+ {
+ "id": "galaxy-hero",
+ "surface": "/galaxy",
+ "url": "/galaxy",
+ "alt": "The Agent Galaxy page with hundreds of labelled agent stars clustered in 3D space and the natural-language search box over them.",
+ "caption": "Captured from the live /galaxy route for the galaxy announcement."
}
]
}
diff --git a/data/changelog.json b/data/changelog.json
index 3de6b0f01..373aea66a 100644
--- a/data/changelog.json
+++ b/data/changelog.json
@@ -28498,6 +28498,45 @@
"docs"
],
"link": "/docs/agent-skills"
+ },
+ {
+ "date": "2026-09-20",
+ "title": "Every perpetual on /derivatives now opens a full contract page",
+ "summary": "The perps table told you a contract's price, funding rate and open interest, and then dead-ended: rows went nowhere. Each one now opens its own page. It puts the mark price next to the index the contract settles against and states the basis between them, turns the funding rate into money by letting you type a position size and reading back what it pays per interval, per day and per year, and ranks the contract's open interest and volume against every other venue listing the same underlying. Below that sits the spot chart for the underlying, a cross-venue funding table with the contract you came from pinned in place, and four callouts that answer the question the table never could: the cheapest venue to hold a long, the best paid venue to hold a short, how far funding spreads across venues, and how far their prices disagree. Those four ignore venues trading under a million dollars a day, because a dormant book sets the widest number every time and is nowhere anyone should act. The same page is reachable from the contracts table on any derivatives venue's exchange profile.",
+ "tags": [
+ "feature",
+ "improvement"
+ ],
+ "link": "/derivatives"
+ },
+ {
+ "date": "2026-09-20",
+ "title": "Derivatives venue profiles show their contracts again",
+ "summary": "Opening a futures venue from the exchange rankings could land on a profile that said it had no markets at all, even for venues listing hundreds of contracts and clearing billions a day. The market-data source keeps an empty placeholder record for some of those venues alongside the real one, and the page was reading the placeholder. It now recognises an empty record for what it is and serves the real venue: open interest, perpetual and futures pair counts, and the contract table. Those tables are also ranked by 24h volume before they are cut to fifty rows, so the biggest contracts lead instead of whatever happened to come first alphabetically, and every contract links to its own detail page.",
+ "tags": [
+ "fix",
+ "improvement"
+ ],
+ "link": "/exchanges"
+ },
+ {
+ "date": "2026-09-20",
+ "title": "Awesome 3D Agents joins the announcement queue, and the machine stops skipping pages like it",
+ "summary": "The machinery that writes announcements from the backlog rebuilds its inventory from the site map on every run, and it was reading only the product sections. Five pages filed under Learn are products rather than documents, so it had never seen them: the curated Awesome 3D Agents list among them, live since the 7th of September and never posted about. They are in the backlog now. Three smaller things landed with it. A page can be asked for next, by name and with the reason recorded, instead of waiting for its score to come round. A post can quote the counters a page puts on screen, such as the 152 entries and 15 sections on the list itself, which the fact harvester used to throw away because they are not sentences. And a frame that was meant to be a five second loop is now shipped as a single picture when the capture finds the page does not actually move.",
+ "tags": [
+ "improvement"
+ ],
+ "link": "/awesome"
+ },
+ {
+ "date": "2026-09-20",
+ "title": "Light mode on the market pages now clears the contrast floor",
+ "summary": "Every green number in a market table, and the coloured score badges on the exchange pages, were being drawn in the same hue used for chart fills. On white that reads at around 3:1, under the 4.5:1 the platform holds itself to, so gains in a table and the figures inside a trust badge were harder to read than they should have been for anyone with low vision or a bright screen. They now use the darker text shade of the same colours, which the design system already carried for exactly this. Dark mode is unchanged. Checked with the same automated WCAG rule sets the site gates on: the perpetual markets table, the new contract page, the exchange rankings and an exchange profile all report zero violations in both themes.",
+ "tags": [
+ "fix",
+ "improvement"
+ ],
+ "link": "/derivatives"
}
]
}
diff --git a/data/x-content/queue.json b/data/x-content/queue.json
index b507169a5..a20dad6d6 100644
--- a/data/x-content/queue.json
+++ b/data/x-content/queue.json
@@ -27,6 +27,8 @@
"maximumSameLaneInARow": 2,
"maximumSamePatternInARow": 1,
"glossary": [
+ "Hunyuan",
+ "Tripo",
"GLB",
"glTF",
"three.ws",
@@ -1257,7 +1259,42 @@
]
}
],
- "mentions": {}
+ "mentions": {},
+ "probes": [
+ {
+ "type": "api",
+ "name": "the trending ranking the server reads is live and populated",
+ "url": "https://three.ws/api/trending",
+ "expect": {
+ "json": {
+ "path": "agents",
+ "min": 1
+ }
+ }
+ },
+ {
+ "type": "api",
+ "name": "the $THREE holder leaderboard the server reads is live and populated",
+ "url": "https://three.ws/api/leaderboard",
+ "expect": {
+ "json": {
+ "path": "holders",
+ "min": 1
+ }
+ }
+ },
+ {
+ "type": "api",
+ "name": "the activity feed the server reads is live and populated",
+ "url": "https://three.ws/api/feed",
+ "expect": {
+ "json": {
+ "path": "events",
+ "min": 1
+ }
+ }
+ }
+ ]
},
{
"id": "avatar-mcp",
@@ -1320,61 +1357,118 @@
]
}
],
- "mentions": {}
+ "mentions": {},
+ "probes": [
+ {
+ "type": "api",
+ "name": "the public avatar list the server resolves against is live",
+ "url": "https://three.ws/api/avatars/public",
+ "expect": {
+ "json": {
+ "path": "avatars",
+ "min": 1
+ }
+ }
+ },
+ {
+ "type": "api",
+ "name": "the preview image the tool falls back to really renders",
+ "url": "https://three.ws/api/avatar/render?avatar=63444cc6-fbfc-44f3-9c61-e7bc0b19f2c0",
+ "expect": {
+ "status": 200
+ }
+ }
+ ]
},
{
- "id": "mocap-studio",
- "status": "draft",
+ "id": "awesome",
+ "status": "review",
"kind": "post",
"tier": 2,
"lane": "community",
- "pattern": "clip",
+ "pattern": "mechanism",
"notBefore": "2026-09-21T12:00:00Z",
"source": {
- "path": "docs/announcements/mocap-studio.md",
- "url": "https://three.ws/mocap-studio"
+ "path": "docs/announcements/awesome.md",
+ "url": "https://three.ws/awesome"
},
"posts": [
{
- "text": "Your webcam drives an avatar's face in the browser: 52 ARKit blendshapes and 478 landmarks per frame, recorded as a clip you can replay and save. three.ws/mocap-studio",
- "textFrom": "docs/announcements/mocap-studio.post.txt",
+ "text": "Giving an agent a body means stitching a dozen fields together. Awesome 3D Agents is the map: 152 entries across 15 sections, 121 of them free to use. three.ws/awesome",
+ "textFrom": "docs/announcements/awesome.post.txt",
"media": [
{
- "path": "public/announce/img/mocap-studio-hero.webp",
- "alt": "The Mocap Studio page with a 3D avatar mirroring a face from the webcam preview beside it, the record controls under the viewer and the saved-clips row empty below."
+ "path": "public/announce/img/awesome-hero.webp",
+ "alt": "The Awesome 3D Agents page on three.ws: a heading reading Everything you need to give an AI agent a body, counters for 152 entries, 15 sections, 121 free to use and 97 tags, a row of tag filters, and a grid of cards for projects such as TRELLIS, Hunyuan3D 2 and TripoSR, each with a one sentence description."
}
]
},
{
- "text": "Calibrate to your neutral face, record a clip, replay it, and save it. Saved clips can be private, unlisted, or public."
- },
- {
- "text": "The engine is FaceMocap, built on Google's MediaPipe Face Landmarker, a newer model than the FaceMesh that older browser-rigging libraries use."
+ "text": "Each entry says in one sentence what the thing does and why you would reach for it instead of the alternative. The same list is published in the standard awesome list format on GitHub, so it can be forked and added to."
}
],
"claims": [
{
- "says": "52 ARKit blendshapes and 478 landmarks per frame",
+ "says": "152 entries across 15 sections",
"evidence": [
{
- "type": "file",
- "path": "docs/mocap-studio.md",
- "contains": "Per frame it outputs 52 ARKit blendshape scores, 478 3-D face landmarks (including iris), and a 4x4 facial transformation matrix for head pose in camera space."
+ "type": "page",
+ "url": "https://three.ws/awesome",
+ "contains": "152 entries across 15 sections"
}
]
},
{
- "says": "Calibrate to your neutral face, record a clip, replay it, and save it.",
+ "says": "121 of them free to use",
"evidence": [
{
- "type": "file",
- "path": "docs/mocap-studio.md",
- "contains": "Calibrate to your neutral face, record a clip, replay it, and save it."
+ "type": "page",
+ "url": "https://three.ws/awesome",
+ "contains": "FREE TO USE 121"
}
]
}
],
- "mentions": {}
+ "mentions": {},
+ "probes": [
+ {
+ "type": "api",
+ "name": "the published list serves 152 entries across 15 sections",
+ "url": "https://three.ws/awesome.json",
+ "expect": {
+ "json": {
+ "path": "counts.items",
+ "min": 152
+ }
+ }
+ },
+ {
+ "type": "api",
+ "name": "every entry ships the sentence that says why it is on the list",
+ "url": "https://three.ws/awesome.json",
+ "expect": {
+ "contains": "Structured latent generation that emits meshes"
+ }
+ },
+ {
+ "type": "browser",
+ "name": "the page renders the counters, the tag filters and the Markdown copy",
+ "steps": [
+ {
+ "goto": "https://three.ws/awesome"
+ },
+ {
+ "expect": "152 entries across 15 sections"
+ },
+ {
+ "expect": "Copy as Markdown"
+ },
+ {
+ "expect": "TRELLIS"
+ }
+ ]
+ }
+ ]
},
{
"id": "knock",
@@ -1448,11 +1542,36 @@
]
}
],
- "mentions": {}
+ "mentions": {},
+ "probes": [
+ {
+ "type": "api",
+ "name": "the open-door directory answers with real doors, cheapest first",
+ "url": "https://three.ws/api/knock/directory",
+ "expect": {
+ "json": {
+ "path": "doors",
+ "min": 1
+ }
+ }
+ },
+ {
+ "type": "browser",
+ "name": "a visitor reaches a real door and its price from the page",
+ "steps": [
+ {
+ "goto": "https://three.ws/knock"
+ },
+ {
+ "expect": "Everyone reachable right now, cheapest first."
+ }
+ ]
+ }
+ ]
},
{
"id": "assistant",
- "status": "draft",
+ "status": "review",
"kind": "post",
"tier": 2,
"lane": "developer",
@@ -1469,7 +1588,7 @@
"media": [
{
"path": "public/announce/img/assistant-hero.webp",
- "alt": "The assistant configurator with the option columns on the left and the floating launcher open in the corner showing a 3D avatar over the live page preview."
+ "alt": "The assistant builder page: a Configure column with avatar, background, mode, name and greeting fields on the left, the one-line script snippet on the right, and the widget's round launcher button in the bottom corner."
}
]
},
@@ -1502,7 +1621,128 @@
]
}
],
- "mentions": {}
+ "mentions": {},
+ "probes": [
+ {
+ "type": "api",
+ "name": "the one script tag the post promises is live and serves the widget",
+ "url": "https://three.ws/assistant/v1.js",
+ "expect": {
+ "contains": "three-assistant"
+ }
+ },
+ {
+ "type": "browser",
+ "name": "the configurator page really mounts its live preview",
+ "steps": [
+ {
+ "goto": "https://three.ws/assistant"
+ },
+ {
+ "expect": "Live preview running in the corner."
+ }
+ ]
+ }
+ ]
+ },
+ {
+ "id": "galaxy",
+ "status": "review",
+ "kind": "post",
+ "tier": 1,
+ "lane": "labs",
+ "pattern": "walkthrough",
+ "notBefore": "2026-09-22T20:00:00Z",
+ "source": {
+ "path": "docs/announcements/galaxy.md",
+ "url": "https://three.ws/galaxy"
+ },
+ "posts": [
+ {
+ "text": "Agent Galaxy is a 3D star-map of every published agent, placed by meaning. Type what you want in plain language and the map flies to the closest ones. three.ws/galaxy",
+ "textFrom": "docs/announcements/galaxy.post.txt",
+ "media": [
+ {
+ "path": "public/announce/img/galaxy-hero.webp",
+ "alt": "The Agent Galaxy page with hundreds of labelled agent stars clustered in 3D space and the natural-language search box over them."
+ }
+ ]
+ },
+ {
+ "text": "Proximity is similarity: agents that do similar things sit near each other, so browsing the map is browsing by meaning rather than by keyword."
+ },
+ {
+ "text": "Instead of guessing keywords, you describe what you want in plain language and the same embedding model that placed the stars finds the closest ones."
+ }
+ ],
+ "claims": [
+ {
+ "says": "a 3D star-map of every published agent, placed by meaning",
+ "evidence": [
+ {
+ "type": "file",
+ "path": "docs/galaxy.md",
+ "contains": "Agent Galaxy is an explorable 3D star-map of every published agent on three.ws, positioned in space by what each agent *means*."
+ }
+ ]
+ },
+ {
+ "says": "Type what you want in plain language and the map flies to the closest ones.",
+ "evidence": [
+ {
+ "type": "file",
+ "path": "docs/galaxy.md",
+ "contains": "Type a natural-language query and the galaxy flies to the agents closest to your intent."
+ }
+ ]
+ },
+ {
+ "says": "Proximity is similarity: agents that do similar things sit near each other",
+ "evidence": [
+ {
+ "type": "file",
+ "path": "docs/galaxy.md",
+ "contains": "Agent Galaxy turns the whole population into a spatial map where proximity is similarity: agents that do similar things sit near each other, and browsing the map is browsing by meaning."
+ }
+ ]
+ },
+ {
+ "says": "Instead of guessing keywords, you describe what you want in plain language and the same embedding model that placed the stars finds the closest ones.",
+ "evidence": [
+ {
+ "type": "file",
+ "path": "docs/galaxy.md",
+ "contains": "Instead of guessing keywords, you describe what you want in plain language and the same embedding model that placed the stars finds the closest ones."
+ }
+ ]
+ }
+ ],
+ "mentions": {},
+ "probes": [
+ {
+ "type": "api",
+ "name": "semantic search really ranks the live corpus and returns matches",
+ "url": "https://three.ws/api/galaxy",
+ "method": "POST",
+ "body": {
+ "query": "a 3D artist agent"
+ },
+ "expect": {
+ "json": {
+ "path": "results",
+ "min": 1
+ }
+ }
+ },
+ {
+ "type": "api",
+ "name": "the map itself is built from live published agents",
+ "url": "https://three.ws/api/galaxy?limit=600",
+ "expect": {
+ "status": 200
+ }
+ }
+ ]
}
]
}
diff --git a/data/x-content/reviews/activity-mcp.json b/data/x-content/reviews/activity-mcp.json
new file mode 100644
index 000000000..92f8f0fc4
--- /dev/null
+++ b/data/x-content/reviews/activity-mcp.json
@@ -0,0 +1,93 @@
+{
+ "id": "activity-mcp",
+ "contentHash": "e33edcf62bb1351adf922f530bd1d6becf842454f110072adfc233c8259603b3",
+ "reviewedAt": "2026-09-20T07:06:48.422Z",
+ "passed": true,
+ "blockers": [],
+ "texts": [
+ "Any MCP client can read the live discovery surface: trending agents, the $THREE holder board with tiers, the site activity ticker. Five tools, free: npmjs.com/package/@three-ws/activity-mcp",
+ "Every ranking, tier, and event comes straight from the public three.ws API, so the model reads the same numbers the site is showing at that moment.",
+ "No key, no signer, no payment. Install it, point it at the public API, and ask."
+ ],
+ "lint": [],
+ "verification": {
+ "ok": true,
+ "checks": [
+ {
+ "claim": "Five tools",
+ "kind": "evidence:file",
+ "target": "packages/activity-mcp/README.md",
+ "ok": true,
+ "detail": "file supports the claim"
+ },
+ {
+ "claim": "Every ranking, tier, and event comes straight from the public three.ws API",
+ "kind": "evidence:file",
+ "target": "packages/activity-mcp/README.md",
+ "ok": true,
+ "detail": "file supports the claim"
+ },
+ {
+ "kind": "probe:api",
+ "target": "the trending ranking the server reads is live and populated",
+ "ok": true,
+ "detail": "HTTP 200, expectations met"
+ },
+ {
+ "kind": "probe:api",
+ "target": "the $THREE holder leaderboard the server reads is live and populated",
+ "ok": true,
+ "detail": "HTTP 200, expectations met"
+ },
+ {
+ "kind": "probe:api",
+ "target": "the activity feed the server reads is live and populated",
+ "ok": true,
+ "detail": "HTTP 200, expectations met"
+ },
+ {
+ "kind": "link",
+ "target": "https://npmjs.com/package/@three-ws/activity-mcp",
+ "ok": true,
+ "detail": "HTTP 200 via the npm registry"
+ },
+ {
+ "kind": "link",
+ "target": "https://three.ws",
+ "ok": true,
+ "detail": "HTTP 200 via https://three.ws/"
+ }
+ ]
+ },
+ "editor": {
+ "verdict": "publish",
+ "scores": {
+ "accuracy": 5,
+ "clarity": 5,
+ "specificity": 5,
+ "voice": 5,
+ "professionalism": 5,
+ "visual": 5
+ },
+ "issues": [],
+ "rewrite": {
+ "posts": [
+ "Any MCP client can read the live discovery surface: trending agents, the $THREE holder board with tiers, the site activity ticker. Five tools, free: npmjs.com/package/@three-ws/activity-mcp",
+ "Every ranking, tier, and event comes straight from the public three.ws API, so the model reads the same numbers the site is showing at that moment.",
+ "No key, no signer, no payment. Install it, point it at the public API, and ask."
+ ],
+ "altText": [
+ "A dark title card headed at three-ws slash activity-mcp, with the package description under it, the claude mcp add install command in a monospace row, and chips naming get_trending_agents, get_trending_coins, get_holder_leaderboard, get_tier_info and get_feed_events."
+ ]
+ },
+ "summary": "Both factual claims are verified against the README, the three API probes confirm the live surfaces the post names, and the screenshot shows the exact five tools the copy claims. Voice, length, link, alt text, and image all meet contract; ship as written.",
+ "model": "nvidia:moonshotai/kimi-k3",
+ "fallbacks": [
+ "No GCP credentials found. Set GCP_SERVICE_ACCOUNT_JSON, run `gcloud auth application-default login`, or run on GCE/Cloud Run.",
+ "openrouter 402: {\"error\":{\"message\":\"Insufficient credits. Add more using https://openrouter.ai/settings/credits\",\"code\":402,\"metadata\":{\"limit_source\":\"openrouter_credits\",\"remedy_hint\":\"Add credits at https://openr",
+ "openai 429: {\n \"error\": {\n \"message\": \"Your account is not active, please check your billing details on our website.\",\n \"type\": \"billing_not_active\",\n \"param\": null,\n \"code\": \"billi"
+ ],
+ "rewriteFindings": []
+ },
+ "editorError": null
+}
diff --git a/data/x-content/reviews/assistant.json b/data/x-content/reviews/assistant.json
new file mode 100644
index 000000000..5191ac320
--- /dev/null
+++ b/data/x-content/reviews/assistant.json
@@ -0,0 +1,102 @@
+{
+ "id": "assistant",
+ "contentHash": "3d6fd934ff3071e38098c874ccedd594ec596211ef309ecfbd91f8254fc80934",
+ "reviewedAt": "2026-09-20T07:28:26.183Z",
+ "passed": true,
+ "blockers": [],
+ "texts": [
+ "One script tag puts a 3D avatar assistant in the corner of any site. Pick a body, a background, and what it knows about your page. three.ws/assistant",
+ "The live preview runs in the corner of the page while you configure it, and every change above re-mounts it.",
+ "Use a built-in body, any three.ws avatar id, a GLB URL, or an agent's body. It answers in chat, or speaks what you type in a speech bubble."
+ ],
+ "lint": [],
+ "verification": {
+ "ok": true,
+ "checks": [
+ {
+ "claim": "The live preview runs in the corner of the page while you configure it, and every change above re-mounts it.",
+ "kind": "evidence:page",
+ "target": "https://three.ws/assistant",
+ "ok": true,
+ "detail": "live page shows \"Live preview running in the corner. Every change above re-mounts it.\""
+ },
+ {
+ "claim": "Use a built-in body, any three.ws avatar id, a GLB URL, or an agent's body.",
+ "kind": "evidence:page",
+ "target": "https://three.ws/assistant",
+ "ok": true,
+ "detail": "live page shows \"Use a built-in body, any three.ws avatar id (make one in Forge), a GLB URL, or an agent's body via data-agent.\""
+ },
+ {
+ "kind": "probe:api",
+ "target": "the one script tag the post promises is live and serves the widget",
+ "ok": true,
+ "detail": "HTTP 200, expectations met"
+ },
+ {
+ "kind": "probe:browser",
+ "target": "the configurator page really mounts its live preview",
+ "ok": true,
+ "detail": "2 steps passed"
+ },
+ {
+ "kind": "link",
+ "target": "https://three.ws/assistant",
+ "ok": true,
+ "detail": "HTTP 200"
+ },
+ {
+ "kind": "link",
+ "target": "https://three.ws",
+ "ok": true,
+ "detail": "HTTP 200 via https://three.ws/"
+ }
+ ]
+ },
+ "editor": {
+ "verdict": "publish",
+ "scores": {
+ "accuracy": 5,
+ "clarity": 5,
+ "specificity": 4,
+ "voice": 5,
+ "professionalism": 5,
+ "visual": 5
+ },
+ "issues": [
+ {
+ "severity": "minor",
+ "area": "specificity",
+ "quote": "It answers in chat, or speaks what you type in a speech bubble.",
+ "problem": "The 'answers in chat' half is vague about where answers come from; the live page names a free model chain (Groq, OpenRouter, NVIDIA), which is a stronger, checkable mechanism.",
+ "fix": "Optional: 'It answers in chat from a free model chain, or speaks what you type out loud in a speech bubble.' Do not sacrifice length or clarity to force it."
+ },
+ {
+ "severity": "minor",
+ "area": "visual",
+ "quote": "posts 2 and 3 (thread continuation)",
+ "problem": "The house contract says every post ships an image; only post 1 carries the frame. For a thread the single hero image on the lead is standard practice, but the rule is stated absolutely.",
+ "fix": "Accept as is for a thread, or explicitly annotate the pack that media attaches to post 1 only."
+ }
+ ],
+ "rewrite": {
+ "posts": [
+ "One script tag puts a 3D avatar assistant in the corner of any site. Pick a body, a background, and what it knows about your page. three.ws/assistant",
+ "The live preview runs in the corner of the page while you configure it, and every change above re-mounts it.",
+ "Use a built-in body, any three.ws avatar id, a GLB URL, or an agent's body. It answers in chat, or speaks what you type in a speech bubble."
+ ],
+ "altText": [
+ "The assistant builder page: a Configure column with avatar, background, mode, name and greeting fields on the left, the one-line script snippet on the right, and the widget's round launcher button in the bottom corner."
+ ]
+ },
+ "summary": "Ship it. Every claim matches the live page verbatim, the script tag and preview behave as promised, the screenshot matches the copy exactly, and the voice is clean; the only notes are optional polish on specificity of the model chain and a judgment call on thread media.",
+ "model": "nvidia:moonshotai/kimi-k3",
+ "fallbacks": [
+ "No GCP credentials found. Set GCP_SERVICE_ACCOUNT_JSON, run `gcloud auth application-default login`, or run on GCE/Cloud Run.",
+ "openrouter 402: {\"error\":{\"message\":\"Insufficient credits. Add more using https://openrouter.ai/settings/credits\",\"code\":402,\"metadata\":{\"limit_source\":\"openrouter_credits\",\"remedy_hint\":\"Add credits at https://openr",
+ "openai 429: {\n \"error\": {\n \"message\": \"Your account is not active, please check your billing details on our website.\",\n \"type\": \"billing_not_active\",\n \"param\": null,\n \"code\": \"billi"
+ ],
+ "rewriteFindings": []
+ },
+ "editorError": null
+}
diff --git a/data/x-content/reviews/avatar-mcp.json b/data/x-content/reviews/avatar-mcp.json
new file mode 100644
index 000000000..2f1b31d2b
--- /dev/null
+++ b/data/x-content/reviews/avatar-mcp.json
@@ -0,0 +1,96 @@
+{
+ "id": "avatar-mcp",
+ "contentHash": "7be5020d79e928a289a42a932cd1fa8e27a6aa4fedd4cde5bbde1416a9513f41",
+ "reviewedAt": "2026-09-20T07:10:30.368Z",
+ "passed": true,
+ "blockers": [],
+ "texts": [
+ "Ask your assistant for an avatar and it renders in the chat: live, rotatable, idling, with a paste-anywhere embed beside it. npmjs.com/package/@three-ws/avatar-mcp",
+ "The avatar is live in the conversation: rotate it, zoom it, watch it idle, without leaving the chat. All three tools are free and read-only.",
+ "Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed, so the tool degrades gracefully everywhere."
+ ],
+ "lint": [],
+ "verification": {
+ "ok": true,
+ "checks": [
+ {
+ "claim": "All three tools are free and read-only",
+ "kind": "evidence:file",
+ "target": "packages/threews-avatar-mcp/README.md",
+ "ok": true,
+ "detail": "file supports the claim"
+ },
+ {
+ "claim": "The avatar is live in the conversation: rotate it, zoom it, watch it idle, without leaving the chat.",
+ "kind": "evidence:file",
+ "target": "packages/threews-avatar-mcp/README.md",
+ "ok": true,
+ "detail": "file supports the claim"
+ },
+ {
+ "claim": "Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed, so the tool degrades gracefully everywhere.",
+ "kind": "evidence:file",
+ "target": "packages/threews-avatar-mcp/README.md",
+ "ok": true,
+ "detail": "file supports the claim"
+ },
+ {
+ "kind": "probe:api",
+ "target": "the public avatar list the server resolves against is live",
+ "ok": true,
+ "detail": "HTTP 200, expectations met"
+ },
+ {
+ "kind": "probe:api",
+ "target": "the preview image the tool falls back to really renders",
+ "ok": true,
+ "detail": "HTTP 200, expectations met"
+ },
+ {
+ "kind": "link",
+ "target": "https://npmjs.com/package/@three-ws/avatar-mcp",
+ "ok": true,
+ "detail": "HTTP 200 via the npm registry"
+ }
+ ]
+ },
+ "editor": {
+ "verdict": "publish",
+ "scores": {
+ "accuracy": 5,
+ "clarity": 4,
+ "specificity": 5,
+ "voice": 5,
+ "professionalism": 5,
+ "visual": 4
+ },
+ "issues": [
+ {
+ "severity": "minor",
+ "area": "visual",
+ "quote": "avatar-mcp-hero.webp",
+ "problem": "The frame shows the package title card, install command, and tool chips, which supports the claim, but it does not show the avatar rendered inside a chat, which is the central visual promise of the post.",
+ "fix": "Optional: capture a frame showing render_avatar's interactive MCP App output inside a chat window for a stronger demonstration. The current shot is accurate and from the live route, so this is not required."
+ }
+ ],
+ "rewrite": {
+ "posts": [
+ "Ask your assistant for an avatar and it renders in the chat: live, rotatable, idling, with a paste-anywhere embed beside it. npmjs.com/package/@three-ws/avatar-mcp",
+ "The avatar is live in the conversation: rotate it, zoom it, watch it idle, without leaving the chat. All three tools are free and read-only.",
+ "Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed, so the tool degrades gracefully everywhere."
+ ],
+ "altText": [
+ "A dark title card headed at three-ws slash avatar-mcp, with the package description under it, the claude mcp add install command in a monospace row, and chips naming render_avatar, avatar_embed_code and get_avatar."
+ ]
+ },
+ "summary": "All three claims are verified word-for-word against the package README, the live probes pass, and the npm link resolves; the frame matches the copy and the alt text accurately describes it. Voice is clean with no banned openings, dashes, hashtags, or emoji; ship with the package unchanged.",
+ "model": "nvidia:moonshotai/kimi-k3",
+ "fallbacks": [
+ "No GCP credentials found. Set GCP_SERVICE_ACCOUNT_JSON, run `gcloud auth application-default login`, or run on GCE/Cloud Run.",
+ "openrouter 402: {\"error\":{\"message\":\"Insufficient credits. Add more using https://openrouter.ai/settings/credits\",\"code\":402,\"metadata\":{\"limit_source\":\"openrouter_credits\",\"remedy_hint\":\"Add credits at https://openr",
+ "openai 429: {\n \"error\": {\n \"message\": \"Your account is not active, please check your billing details on our website.\",\n \"type\": \"billing_not_active\",\n \"param\": null,\n \"code\": \"billi"
+ ],
+ "rewriteFindings": []
+ },
+ "editorError": null
+}
diff --git a/data/x-content/reviews/galaxy.json b/data/x-content/reviews/galaxy.json
new file mode 100644
index 000000000..7cb742b7d
--- /dev/null
+++ b/data/x-content/reviews/galaxy.json
@@ -0,0 +1,95 @@
+{
+ "id": "galaxy",
+ "contentHash": "baa1b95fe120e328eee1b2f2312d14182c0eafd8e3c31da69e14f72daa68e896",
+ "reviewedAt": "2026-09-20T07:15:37.315Z",
+ "passed": true,
+ "blockers": [],
+ "texts": [
+ "Agent Galaxy is a 3D star-map of every published agent, placed by meaning. Type what you want in plain language and the map flies to the closest ones. three.ws/galaxy",
+ "Proximity is similarity: agents that do similar things sit near each other, so browsing the map is browsing by meaning rather than by keyword.",
+ "Instead of guessing keywords, you describe what you want in plain language and the same embedding model that placed the stars finds the closest ones."
+ ],
+ "lint": [],
+ "verification": {
+ "ok": true,
+ "checks": [
+ {
+ "claim": "a 3D star-map of every published agent, placed by meaning",
+ "kind": "evidence:file",
+ "target": "docs/galaxy.md",
+ "ok": true,
+ "detail": "file supports the claim"
+ },
+ {
+ "claim": "Type what you want in plain language and the map flies to the closest ones.",
+ "kind": "evidence:file",
+ "target": "docs/galaxy.md",
+ "ok": true,
+ "detail": "file supports the claim"
+ },
+ {
+ "claim": "Proximity is similarity: agents that do similar things sit near each other",
+ "kind": "evidence:file",
+ "target": "docs/galaxy.md",
+ "ok": true,
+ "detail": "file supports the claim"
+ },
+ {
+ "claim": "Instead of guessing keywords, you describe what you want in plain language and the same embedding model that placed the stars finds the closest ones.",
+ "kind": "evidence:file",
+ "target": "docs/galaxy.md",
+ "ok": true,
+ "detail": "file supports the claim"
+ },
+ {
+ "kind": "probe:api",
+ "target": "semantic search really ranks the live corpus and returns matches",
+ "ok": true,
+ "detail": "HTTP 200, expectations met"
+ },
+ {
+ "kind": "probe:api",
+ "target": "the map itself is built from live published agents",
+ "ok": true,
+ "detail": "HTTP 200, expectations met"
+ },
+ {
+ "kind": "link",
+ "target": "https://three.ws/galaxy",
+ "ok": true,
+ "detail": "HTTP 200"
+ }
+ ]
+ },
+ "editor": {
+ "verdict": "publish",
+ "scores": {
+ "accuracy": 5,
+ "clarity": 5,
+ "specificity": 5,
+ "voice": 5,
+ "professionalism": 5,
+ "visual": 5
+ },
+ "issues": [],
+ "rewrite": {
+ "posts": [
+ "Agent Galaxy is a 3D star-map of every published agent, placed by meaning. Type what you want in plain language and the map flies to the closest ones. three.ws/galaxy",
+ "Proximity is similarity: agents that do similar things sit near each other, so browsing the map is browsing by meaning rather than by keyword.",
+ "Instead of guessing keywords, you describe what you want in plain language and the same embedding model that placed the stars finds the closest ones."
+ ],
+ "altText": [
+ "The Agent Galaxy page with hundreds of labelled agent stars clustered in 3D space and the natural-language search box over them."
+ ]
+ },
+ "summary": "All four claims are verified word-for-word against docs/galaxy.md, both API probes pass, the link returns 200, and the screenshot matches the copy (600 agents, no contradicted numbers). Voice, length, alt text, and visual all comply with the house contract; ship as is.",
+ "model": "nvidia:moonshotai/kimi-k3",
+ "fallbacks": [
+ "No GCP credentials found. Set GCP_SERVICE_ACCOUNT_JSON, run `gcloud auth application-default login`, or run on GCE/Cloud Run.",
+ "openrouter 402: {\"error\":{\"message\":\"Insufficient credits. Add more using https://openrouter.ai/settings/credits\",\"code\":402,\"metadata\":{\"limit_source\":\"openrouter_credits\",\"remedy_hint\":\"Add credits at https://openr",
+ "openai 429: {\n \"error\": {\n \"message\": \"Your account is not active, please check your billing details on our website.\",\n \"type\": \"billing_not_active\",\n \"param\": null,\n \"code\": \"billi"
+ ],
+ "rewriteFindings": []
+ },
+ "editorError": null
+}
diff --git a/data/x-content/reviews/knock.json b/data/x-content/reviews/knock.json
new file mode 100644
index 000000000..fcd14966d
--- /dev/null
+++ b/data/x-content/reviews/knock.json
@@ -0,0 +1,95 @@
+{
+ "id": "knock",
+ "contentHash": "bc34177fe6dd1740bca69bfc788c3c9b05fc4b741c591fc912764187343ded60",
+ "reviewedAt": "2026-09-20T06:50:08.567Z",
+ "passed": true,
+ "blockers": [],
+ "texts": [
+ "Put a price on reaching you. A stranger pays it, your 3D companion walks on and says who is at the door and what they paid, and the USDC is already yours. three.ws/knock",
+ "A person pays with the wallet in their browser. An agent pays over x402 with no human in the loop.",
+ "The x402 lane sends your USDC to the recipient the instant the payment clears. Your price, your wallet, and everything that comes through it stays private to your account."
+ ],
+ "lint": [],
+ "verification": {
+ "ok": true,
+ "checks": [
+ {
+ "claim": "says who is at the door and what they paid",
+ "kind": "evidence:page",
+ "target": "https://three.ws/knock",
+ "ok": true,
+ "detail": "live page shows \"Your companion walks on wherever you are on the site and says who is at the door and what they paid.\""
+ },
+ {
+ "claim": "A person pays with the wallet in their browser. An agent pays over x402 with no human in the loop.",
+ "kind": "evidence:page",
+ "target": "https://three.ws/knock",
+ "ok": true,
+ "detail": "live page shows \"A person pays with the wallet in their browser. An agent pays over x402 with no human in the loop.\""
+ },
+ {
+ "claim": "The x402 lane sends your USDC to the recipient the instant the payment clears.",
+ "kind": "evidence:file",
+ "target": "docs/knock.md",
+ "ok": true,
+ "detail": "file supports the claim"
+ },
+ {
+ "claim": "Your price, your wallet, and everything that comes through it stays private to your account.",
+ "kind": "evidence:page",
+ "target": "https://three.ws/knock",
+ "ok": true,
+ "detail": "live page shows \"Your price, your wallet, and everything that comes through it stays private to your account.\""
+ },
+ {
+ "kind": "probe:api",
+ "target": "the open-door directory answers with real doors, cheapest first",
+ "ok": true,
+ "detail": "HTTP 200, expectations met"
+ },
+ {
+ "kind": "probe:browser",
+ "target": "a visitor reaches a real door and its price from the page",
+ "ok": true,
+ "detail": "2 steps passed"
+ },
+ {
+ "kind": "link",
+ "target": "https://three.ws/knock",
+ "ok": true,
+ "detail": "HTTP 200"
+ }
+ ]
+ },
+ "editor": {
+ "verdict": "publish",
+ "scores": {
+ "accuracy": 5,
+ "clarity": 5,
+ "specificity": 5,
+ "voice": 5,
+ "professionalism": 5,
+ "visual": 5
+ },
+ "issues": [],
+ "rewrite": {
+ "posts": [
+ "Put a price on reaching you. A stranger pays it, your 3D companion walks on and says who is at the door and what they paid, and the USDC is already yours. three.ws/knock",
+ "A person pays with the wallet in their browser. An agent pays over x402 with no human in the loop.",
+ "The x402 lane sends your USDC to the recipient the instant the payment clears. Your price, your wallet, and everything that comes through it stays private to your account."
+ ],
+ "altText": [
+ "The Knock page on three.ws: the headline and its description, three numbered cards reading Set your price, They pay it and You hear it in person, and the signed-out door panel below them."
+ ]
+ },
+ "summary": "Every claim in the thread is verified verbatim against the live /knock page or docs/knock.md, and the screenshot matches the live page exactly, including the same card copy the quotes come from. Voice, length, link, and alt text all conform to the house contract with no blocking or major issues.",
+ "model": "nvidia:moonshotai/kimi-k3",
+ "fallbacks": [
+ "No GCP credentials found. Set GCP_SERVICE_ACCOUNT_JSON, run `gcloud auth application-default login`, or run on GCE/Cloud Run.",
+ "openrouter 402: {\"error\":{\"message\":\"Insufficient credits. Add more using https://openrouter.ai/settings/credits\",\"code\":402,\"metadata\":{\"limit_source\":\"openrouter_credits\",\"remedy_hint\":\"Add credits at https://openr",
+ "openai 429: {\n \"error\": {\n \"message\": \"Your account is not active, please check your billing details on our website.\",\n \"type\": \"billing_not_active\",\n \"param\": null,\n \"code\": \"billi"
+ ],
+ "rewriteFindings": []
+ },
+ "editorError": null
+}
diff --git a/docs/announcements/activity-mcp.md b/docs/announcements/activity-mcp.md
index f56f410b7..bacdd16cc 100644
--- a/docs/announcements/activity-mcp.md
+++ b/docs/announcements/activity-mcp.md
@@ -2,7 +2,7 @@
**Surface:** [`@three-ws/activity-mcp`](https://three.ws) · **Stage:** drafted · **Slot:** 2026-09-21 · **Announced externally:** never
-Ranked 33 of 329 never-announced surfaces by `npm run announce:rank` (score 67). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/activity-mcp.json`](../../data/announce-plan/briefs/activity-mcp.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.
+Ranked 33 of 330 never-announced surfaces by `npm run announce:rank` (score 67). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/activity-mcp.json`](../../data/announce-plan/briefs/activity-mcp.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.
---
diff --git a/docs/announcements/assistant.md b/docs/announcements/assistant.md
index 1f4006c0b..84ea6e2ef 100644
--- a/docs/announcements/assistant.md
+++ b/docs/announcements/assistant.md
@@ -2,7 +2,7 @@
**Surface:** [`/assistant`](https://three.ws/assistant) · **Stage:** drafted · **Slot:** 2026-09-22 · **Announced externally:** never
-Ranked 46 of 324 never-announced surfaces by `npm run announce:rank` (score 66). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/assistant.json`](../../data/announce-plan/briefs/assistant.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.
+Ranked 48 of 330 never-announced surfaces by `npm run announce:rank` (score 66). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/assistant.json`](../../data/announce-plan/briefs/assistant.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.
---
@@ -58,7 +58,7 @@ Captured from the live route by `npm run announce:media`, which drives the real
**Alt text, required on the post:**
-> The assistant configurator with the option columns on the left and the floating launcher open in the corner showing a 3D avatar over the live page preview.
+> The assistant builder page: a Configure column with avatar, background, mode, name and greeting fields on the left, the one-line script snippet on the right, and the widget's round launcher button in the bottom corner.
## The post
diff --git a/docs/announcements/avatar-mcp.md b/docs/announcements/avatar-mcp.md
index 35eb7607f..3c0e0e8a6 100644
--- a/docs/announcements/avatar-mcp.md
+++ b/docs/announcements/avatar-mcp.md
@@ -2,7 +2,7 @@
**Surface:** [`@three-ws/avatar-mcp`](https://three.ws) · **Stage:** drafted · **Slot:** 2026-09-21 · **Announced externally:** never
-Ranked 38 of 329 never-announced surfaces by `npm run announce:rank` (score 67). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/avatar-mcp.json`](../../data/announce-plan/briefs/avatar-mcp.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.
+Ranked 38 of 330 never-announced surfaces by `npm run announce:rank` (score 67). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/avatar-mcp.json`](../../data/announce-plan/briefs/avatar-mcp.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.
---
diff --git a/docs/announcements/galaxy.md b/docs/announcements/galaxy.md
new file mode 100644
index 000000000..20c3a2687
--- /dev/null
+++ b/docs/announcements/galaxy.md
@@ -0,0 +1,104 @@
+# Announcement pack: Browse every agent by meaning, in 3D
+
+**Surface:** [`/galaxy`](https://three.ws/galaxy) · **Stage:** drafted · **Slot:** 2026-09-22 · **Announced externally:** never
+
+Ranked 143 of 330 never-announced surfaces by `npm run announce:rank` (score 51). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/galaxy.json`](../../data/announce-plan/briefs/galaxy.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.
+
+---
+
+## At a glance
+
+| Field | Value |
+|---|---|
+| Pack id | `galaxy` |
+| Publish slot | 2026-09-22. The minute is decided at send time from the production schedule seed, so it is not knowable from this repository |
+| Lane and pattern | labs / walkthrough |
+| Audience | People who follow the experimental surfaces |
+| Primary channel | X, @trythreews, through the reviewed content queue |
+| Secondary channels | Telegram (@three_ws), the surface's own docs page |
+| Proof | https://three.ws/galaxy |
+| Tracked links | Telegram `https://three.ws/galaxy?utm_source=telegram&utm_medium=community&utm_campaign=announce-galaxy&utm_content=announcement`. The X post links the bare URL on purpose: X wraps every link in t.co and the queue's own ledger records the send, so a tagged link buys nothing and reads like marketing. |
+| The single CTA | Open /galaxy and use it |
+| Media | `galaxy-hero`, still frame |
+| KPI | route sessions that reach the second step of the flow |
+
+## Why this one, and why now
+
+The ranker scored it on signals measured against our own archive, not on taste:
+
+- **reach (12)**: sitemap priority 0.60, which is what we already decided this surface is worth
+- **visual (14)**: renders something worth a frame
+- **partner (12)**: names a partner the surface genuinely runs on, so a tag is defensible
+- **depth (13)**: documented in the tree, so there is enough to write a mechanism about and link proof for
+
+The changelog has 6 entries about it, the most recent from 2026-09-08: "Agent Galaxy no longer strands you when the star map cannot be built".
+
+## The claim, and where it is checked
+
+> Agent Galaxy is a 3D star-map of every published agent, placed by meaning. Type what you want in plain language and the map flies to the closest ones. three.ws/galaxy
+
+Every checkable part of that is declared as a claim in the queue item, and the verifier re-checks each one against the live surface before the post can be approved:
+
+| Claim | Checked against |
+|---|---|
+| a 3D star-map of every published agent, placed by meaning | `docs/galaxy.md` contains "Agent Galaxy is an explorable 3D star-map of every published agent on three.ws, positioned" |
+| Type what you want in plain language and the map flies to the closest ones. | `docs/galaxy.md` contains "Type a natural-language query and the galaxy flies to the agents closest to your intent." |
+| Proximity is similarity: agents that do similar things sit near each other | `docs/galaxy.md` contains "Agent Galaxy turns the whole population into a spatial map where proximity is similarity: " |
+| Instead of guessing keywords, you describe what you want in plain language and the same embedding model that placed the stars finds the closest ones. | `docs/galaxy.md` contains "Instead of guessing keywords, you describe what you want in plain language and the same em" |
+
+## Media
+
+Captured from the live route by `npm run announce:media`, which drives the real page in a real Chromium and writes provenance (route, commit, time, sha256) beside the pixels in [`public/announce/media-manifest.json`](../../public/announce/media-manifest.json).
+
+| Shot | File | Notes |
+|---|---|---|
+| `galaxy-hero` | `/announce/img/galaxy-hero.webp` | Still frame of the live route. |
+
+**Alt text, required on the post:**
+
+> The Agent Galaxy page with hundreds of labelled agent stars clustered in 3D space and the natural-language search box over them.
+
+## The post
+
+Pattern: walkthrough. **174 weighted characters**, inside the 100 to 179 band that measured a 3.0x lift. Postable file: [`galaxy.post.txt`](./galaxy.post.txt), which is the byte-for-byte source the queue item points at.
+
+```text
+Agent Galaxy is a 3D star-map of every published agent, placed by meaning. Type what you want in plain language and the map flies to the closest ones. three.ws/galaxy
+```
+
+### Why it is written that way
+
+The post leads on the one move that makes the surface obvious: describe what you want and watch the map fly to it. The embedding provider is deliberately not named, because the live map is currently built by the fallback lane rather than the preferred one.
+
+### Thread
+
+2/ (142)
+
+```text
+Proximity is similarity: agents that do similar things sit near each other, so browsing the map is browsing by meaning rather than by keyword.
+```
+
+3/ (149)
+
+```text
+Instead of guessing keywords, you describe what you want in plain language and the same embedding model that placed the stars finds the closest ones.
+```
+
+## Telegram (@three_ws)
+
+The same facts in the channel's longer register. The changelog cron posts release notes there automatically; this is the announcement register, sent by hand or queued alongside the post.
+
+```text
+Agent Galaxy turns every published agent on three.ws into an explorable 3D star-map, positioned by what each agent means rather than by name. Agents that do similar things sit near each other, so browsing the map is browsing by meaning. Instead of guessing keywords, you describe what you want in plain language and the same embedding model that placed the stars finds the closest ones. three.ws/galaxy
+```
+
+## Ship it
+
+```bash
+npm run announce:media -- --only galaxy-hero # capture the frame from the live route
+npm run x:content -- review galaxy # lint, live fact checks, AI editor
+npm run x:content -- run --dry-run --id galaxy # exactly what would be sent to X
+```
+
+The queue item is `galaxy` in [`data/x-content/queue.json`](../../data/x-content/queue.json), at status `draft`. It becomes eligible to publish when a passing review record exists and the owner sets its status to `approved`; the Cloud Scheduler tick then sends it at its slot. Nothing here posts on its own.
+
diff --git a/docs/announcements/galaxy.post.txt b/docs/announcements/galaxy.post.txt
new file mode 100644
index 000000000..acbe4322e
--- /dev/null
+++ b/docs/announcements/galaxy.post.txt
@@ -0,0 +1 @@
+Agent Galaxy is a 3D star-map of every published agent, placed by meaning. Type what you want in plain language and the map flies to the closest ones. three.ws/galaxy
diff --git a/docs/announcements/knock.md b/docs/announcements/knock.md
index e46d1aa1b..a9691f377 100644
--- a/docs/announcements/knock.md
+++ b/docs/announcements/knock.md
@@ -2,7 +2,7 @@
**Surface:** [`/knock`](https://three.ws/knock) · **Stage:** drafted · **Slot:** 2026-09-21 · **Announced externally:** never
-Ranked 31 of 329 never-announced surfaces by `npm run announce:rank` (score 70). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/knock.json`](../../data/announce-plan/briefs/knock.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.
+Ranked 31 of 330 never-announced surfaces by `npm run announce:rank` (score 70). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/knock.json`](../../data/announce-plan/briefs/knock.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.
---
diff --git a/docs/announcements/mocap-studio.md b/docs/announcements/mocap-studio.md
deleted file mode 100644
index 1b928d327..000000000
--- a/docs/announcements/mocap-studio.md
+++ /dev/null
@@ -1,106 +0,0 @@
-# Announcement pack: Facial capture in the browser, from the webcam you have
-
-**Surface:** [`/mocap-studio`](https://three.ws/mocap-studio) · **Stage:** drafted · **Slot:** 2026-09-21 · **Announced externally:** never
-
-Ranked 45 of 324 never-announced surfaces by `npm run announce:rank` (score 67). Drafted by hand and packed by `npm run announce:kit`, from the evidence brief in [`data/announce-plan/briefs/mocap-studio.json`](../../data/announce-plan/briefs/mocap-studio.json), against [the announcement voice](../announce-voice.md). Every fact below comes from that brief; nothing in this pack was written from memory.
-
----
-
-## At a glance
-
-| Field | Value |
-|---|---|
-| Pack id | `mocap-studio` |
-| Publish slot | 2026-09-21. The minute is decided at send time from the production schedule seed, so it is not knowable from this repository |
-| Lane and pattern | community / clip |
-| Audience | People who use three.ws and hold $THREE |
-| Primary channel | X, @trythreews, through the reviewed content queue |
-| Secondary channels | Telegram (@three_ws), the surface's own docs page |
-| Proof | https://three.ws/mocap-studio |
-| Tracked links | Telegram `https://three.ws/mocap-studio?utm_source=telegram&utm_medium=community&utm_campaign=announce-mocap-studio&utm_content=announcement`. The X post links the bare URL on purpose: X wraps every link in t.co and the queue's own ledger records the send, so a tagged link buys nothing and reads like marketing. |
-| The single CTA | Open /mocap-studio and use it |
-| Media | `mocap-studio-hero`, motion loop |
-| KPI | loop completions and profile visits, then route sessions on the day |
-
-## Why this one, and why now
-
-The ranker scored it on signals measured against our own archive, not on taste:
-
-- **reach (14)**: sitemap priority 0.70, which is what we already decided this surface is worth
-- **visual (25)**: a showcase surface, so its frame can be a motion loop
-- **novelty (20)**: on the coverage audit's hand-picked shortlist of strongest candidates
-- **depth (8)**: documented in the tree, so there is enough to write a mechanism about and link proof for
-
-The coverage audit's note on it: Replace yourself in any video with your avatar; webcam motion capture as an API. Extremely screenshotable.
-
-It shipped on 2026-07-01 and has never been posted about.
-
-The changelog has 6 entries about it, the most recent from 2026-08-14: "The 3D viewer no longer starts up blank when its box has not been measured yet".
-
-## The claim, and where it is checked
-
-> Your webcam drives an avatar's face in the browser: 52 ARKit blendshapes and 478 landmarks per frame, recorded as a clip you can replay and save. three.ws/mocap-studio
-
-Every checkable part of that is declared as a claim in the queue item, and the verifier re-checks each one against the live surface before the post can be approved:
-
-| Claim | Checked against |
-|---|---|
-| 52 ARKit blendshapes and 478 landmarks per frame | `docs/mocap-studio.md` contains "Per frame it outputs 52 ARKit blendshape scores, 478 3-D face landmarks (including iris), " |
-| Calibrate to your neutral face, record a clip, replay it, and save it. | `docs/mocap-studio.md` contains "Calibrate to your neutral face, record a clip, replay it, and save it." |
-
-## Media
-
-Captured from the live route by `npm run announce:media`, which drives the real page in a real Chromium and writes provenance (route, commit, time, sha256) beside the pixels in [`public/announce/media-manifest.json`](../../public/announce/media-manifest.json).
-
-| Shot | File | Notes |
-|---|---|---|
-| `mocap-studio-hero` | `/announce/img/mocap-studio-hero.webp` | Motion loop of the live route. |
-
-**Alt text, required on the post:**
-
-> The Mocap Studio page with a 3D avatar mirroring a face from the webcam preview beside it, the record controls under the viewer and the saved-clips row empty below.
-
-## The post
-
-Pattern: clip. **169 weighted characters**, inside the 100 to 179 band that measured a 3.0x lift. Postable file: [`mocap-studio.post.txt`](./mocap-studio.post.txt), which is the byte-for-byte source the queue item points at.
-
-```text
-Your webcam drives an avatar's face in the browser: 52 ARKit blendshapes and 478 landmarks per frame, recorded as a clip you can replay and save. three.ws/mocap-studio
-```
-
-### Why it is written that way
-
-The post leads on the numbers that separate this from a webcam gimmick: 52 blendshapes and 478 landmarks a frame is studio-grade signal running in a tab. The recorded clip is the payoff, so the copy ends where the reader can act.
-
-### Thread
-
-2/ (119)
-
-```text
-Calibrate to your neutral face, record a clip, replay it, and save it. Saved clips can be private, unlisted, or public.
-```
-
-3/ (143)
-
-```text
-The engine is FaceMocap, built on Google's MediaPipe Face Landmarker, a newer model than the FaceMesh that older browser-rigging libraries use.
-```
-
-## Telegram (@three_ws)
-
-The same facts in the channel's longer register. The changelog cron posts release notes there automatically; this is the announcement register, sent by hand or queued alongside the post.
-
-```text
-Mocap Studio turns the camera you already have into a facial capture rig. It reads 52 ARKit blendshape scores and 478 face landmarks per frame and drives your avatar's face with them, live in the browser. Calibrate to your neutral face, record a clip, replay it, and save it as private, unlisted, or public. three.ws/mocap-studio
-```
-
-## Ship it
-
-```bash
-npm run announce:media -- --only mocap-studio-hero # capture the frame from the live route
-npm run x:content -- review mocap-studio # lint, live fact checks, AI editor
-npm run x:content -- run --dry-run --id mocap-studio # exactly what would be sent to X
-```
-
-The queue item is `mocap-studio` in [`data/x-content/queue.json`](../../data/x-content/queue.json), at status `draft`. It becomes eligible to publish when a passing review record exists and the owner sets its status to `approved`; the Cloud Scheduler tick then sends it at its slot. Nothing here posts on its own.
-
diff --git a/docs/announcements/mocap-studio.post.txt b/docs/announcements/mocap-studio.post.txt
deleted file mode 100644
index 2e4ab0952..000000000
--- a/docs/announcements/mocap-studio.post.txt
+++ /dev/null
@@ -1 +0,0 @@
-Your webcam drives an avatar's face in the browser: 52 ARKit blendshapes and 478 landmarks per frame, recorded as a clip you can replay and save. three.ws/mocap-studio
diff --git a/docs/x-content-pipeline.md b/docs/x-content-pipeline.md
index 50acde03a..98a3bc9d1 100644
--- a/docs/x-content-pipeline.md
+++ b/docs/x-content-pipeline.md
@@ -27,6 +27,7 @@ pipeline, enforced before anything is sent:
| Repeats | A head that reads too much like another queued item, or like anything @trythreews already posted (the scraped archive in `data/archives/` plus everything this pipeline published), is rejected. |
| Clockwork timing | Three slots a day, eight hours apart, every day, each opening at a jittered minute, with a minimum gap and a daily cap. |
| A schedule anyone can read off the repository | The slot jitter is an HMAC under `X_CONTENT_SCHEDULE_SEED` (production only), and which post fills a slot is decided at the moment it opens. Unset, the jitter falls back to a public hash, and `plan` says its minutes are placeholders. |
+| A link that cannot be checked | Every link is resolved before a post can be approved, and again seconds before it is sent. npm answers 403 to any non-browser client, so a package page is resolved against `registry.npmjs.org`, which is the authoritative record of whether that package exists and answers any client. |
| A broken post stalling the feed | A post that cannot go out (a link is down, a feature probe fails, X rejects the content) is held with the reason and a backoff, and the slot goes to the next-best post in the same run. |
| Same format on repeat | Lane (audience) and pattern (post shape) rotate. A due item waits if it would repeat the previous lane or pattern too many times, unless it has been waiting a full day. |
| Retry double-posts | Every created media id, post id, and Article id is written to the ledger the moment X returns it. A crash mid-thread resumes at the next unposted reply. |
diff --git a/public/announce/img/assistant-hero.webp b/public/announce/img/assistant-hero.webp
new file mode 100644
index 000000000..9b3abe2cf
Binary files /dev/null and b/public/announce/img/assistant-hero.webp differ
diff --git a/public/announce/img/galaxy-hero.webp b/public/announce/img/galaxy-hero.webp
new file mode 100644
index 000000000..8f13b31e8
Binary files /dev/null and b/public/announce/img/galaxy-hero.webp differ
diff --git a/public/announce/media-manifest.json b/public/announce/media-manifest.json
index f578d181a..6c15cdf82 100644
--- a/public/announce/media-manifest.json
+++ b/public/announce/media-manifest.json
@@ -1,6 +1,6 @@
{
"generatedBy": "scripts/capture-doc-media.mjs",
- "generatedAt": "2026-09-20T06:09:35.981Z",
+ "generatedAt": "2026-09-20T07:23:11.414Z",
"shots": {
"activity-hero": {
"id": "activity-hero",
@@ -55,6 +55,24 @@
"width": 1800,
"height": 1013
},
+ "assistant-hero": {
+ "id": "assistant-hero",
+ "src": "/announce/img/assistant-hero.webp",
+ "alt": "The assistant builder page: a Configure column with avatar, background, mode, name and greeting fields on the left, the one-line script snippet on the right, and the widget's round launcher button in the bottom corner.",
+ "caption": "Captured from the live /assistant route for the assistant announcement.",
+ "route": "/assistant",
+ "viewport": "wide",
+ "animated": false,
+ "authenticated": false,
+ "capturedAt": "2026-09-20T07:22:41.106Z",
+ "capturedFrom": "https://three.ws",
+ "commit": "41632745c",
+ "sha256": "42090a7235f6e34dba68a8cda1b4464ce84a2a7681c5021d1594d3f065342f60",
+ "bytes": 83520,
+ "width": 1800,
+ "height": 1013,
+ "still": "the route did not change between two frames a second apart"
+ },
"avatar-mcp-hero": {
"id": "avatar-mcp-hero",
"src": "/announce/img/avatar-mcp-hero.webp",
@@ -72,6 +90,24 @@
"width": 1800,
"height": 1013
},
+ "awesome-hero": {
+ "id": "awesome-hero",
+ "src": "/announce/img/awesome-hero.webp",
+ "alt": "The Awesome 3D Agents page on three.ws: a heading reading Everything you need to give an AI agent a body, counters for 152 entries, 15 sections, 121 free to use and 97 tags, a row of tag filters, and a grid of cards for projects such as TRELLIS, Hunyuan3D 2 and TripoSR, each with a one sentence description.",
+ "caption": "Captured from the live /awesome route for the awesome announcement.",
+ "route": "/awesome",
+ "viewport": "wide",
+ "animated": false,
+ "authenticated": false,
+ "capturedAt": "2026-09-20T06:51:08.404Z",
+ "capturedFrom": "https://three.ws",
+ "commit": "41632745c",
+ "sha256": "247f534ca9ed4302de490958bb6530c629c0d24d2664cf765b546f1de7e93b4d",
+ "bytes": 78116,
+ "width": 1800,
+ "height": 1013,
+ "still": "the route did not change between two frames a second apart"
+ },
"aws-builder-center-authorization-spine": {
"id": "aws-builder-center-authorization-spine",
"src": "/announce/img/aws-builder-center-authorization-spine.webp",
@@ -128,6 +164,23 @@
"width": 1800,
"height": 1013
},
+ "galaxy-hero": {
+ "id": "galaxy-hero",
+ "src": "/announce/img/galaxy-hero.webp",
+ "alt": "The Agent Galaxy page with hundreds of labelled agent stars clustered in 3D space and the natural-language search box over them.",
+ "caption": "Captured from the live /galaxy route for the galaxy announcement.",
+ "route": "/galaxy",
+ "viewport": "wide",
+ "animated": false,
+ "authenticated": false,
+ "capturedAt": "2026-09-20T06:22:48.316Z",
+ "capturedFrom": "https://three.ws",
+ "commit": "41632745c",
+ "sha256": "86cc6f01586b093e7dda16407d9d063467c515286dd0dec83fa69e826c154d54",
+ "bytes": 52624,
+ "width": 1800,
+ "height": 1013
+ },
"genesis-hero": {
"id": "genesis-hero",
"src": "/announce/img/genesis-hero.webp",
diff --git a/scripts/check-announce.mjs b/scripts/check-announce.mjs
index 9386d1d8d..32b6f6877 100644
--- a/scripts/check-announce.mjs
+++ b/scripts/check-announce.mjs
@@ -40,6 +40,8 @@ import { readFileSync, existsSync, readdirSync } from 'node:fs';
import { resolve, dirname, join, basename } from 'node:path';
import { fileURLToPath } from 'node:url';
+import { hasUrl } from '../api/_lib/x-content/quality.js';
+
const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
const PACK_DIR = join(root, 'docs/announcements');
const MEDIA_SPEC = join(root, 'data/announce-media.json');
@@ -162,7 +164,9 @@ for (const file of packs) {
if (BANNED_DASHES.test(post) || BANNED_DASHES.test(body)) {
fail(name, 'contains an em-dash or en-dash, which the house style bans');
}
- if (!/https?:\/\/|three\.ws\//.test(post)) fail(name, 'post links nothing; a reader cannot reach the feature');
+ // The same notion of a link the publisher uses, so a package page on npm
+ // counts exactly as a three.ws route does. X wraps both in t.co.
+ if (!hasUrl(post)) fail(name, 'post links nothing; a reader cannot reach the feature');
for (const re of BANNED_OPENINGS) {
if (re.test(post)) fail(name, `post opens with a banned construction: ${re.source}`);
diff --git a/tests/x-content.test.js b/tests/x-content.test.js
index 4fc6f04c0..968309f92 100644
--- a/tests/x-content.test.js
+++ b/tests/x-content.test.js
@@ -7,6 +7,7 @@ import { copyProblems, weightedLength } from '../api/_lib/x-content/quality.js';
import { attachmentProblems, mediaProblems, parseFfmpegProbe } from '../api/_lib/x-content/media.js';
import { markdownToContentState, attachArticleMedia } from '../api/_lib/x-content/articles.js';
import { DEFAULT_SLOTS, currentSlot, inQuietHours, jitterMinutes, pickDue, slotOpenings, tierOrder } from '../api/_lib/x-content/schedule.js';
+import { linkProbeUrl } from '../api/_lib/x-content/verify.js';
import { engagementSignals, loadLifts, loadVolumeModel, rankItems, scoreItem, volumeScore } from '../api/_lib/x-content/priority.js';
import { activeHolds, inventory, isPostSpecific, placeHold, runTick } from '../api/_lib/x-content/runner.js';
import { memoryStore } from '../api/_lib/x-content/state.js';
@@ -613,3 +614,11 @@ describe('review', () => {
});
+
+describe('npm package links', () => {
+ it('checks an npm package page against the registry, which answers a non-browser client', () => {
+ expect(linkProbeUrl('https://npmjs.com/package/@three-ws/activity-mcp')).toBe('https://registry.npmjs.org/@three-ws%2Factivity-mcp');
+ expect(linkProbeUrl('https://www.npmjs.com/package/three')).toBe('https://registry.npmjs.org/three');
+ expect(linkProbeUrl('https://three.ws/knock')).toBe('https://three.ws/knock');
+ });
+});