Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
feat(announce): harvest page stats as facts, and let the owner pin the next surface
ni3adf8b49506955
diff --git a/api/_lib/announce/brief.js b/api/_lib/announce/brief.jsindex 4b91c1b94..045f5cf82 100644--- a/api/_lib/announce/brief.js+++ b/api/_lib/announce/brief.js@@ -151,6 +151,40 @@ export function harvestFacts(pageText, limit = 24) {return unique.sort((left, right) => weight(right) - weight(left)).slice(0, limit);}+// The counters a page leads with, which harvestFacts cannot offer. It takes+// whole sentences only, because a clipped card caption fails the very check it+// was picked for, and that rule also throws away the single strongest fact on+// any page built around numbers: /awesome renders "ENTRIES 152" as a tile and+// "152 entries across 15 sections" as a summary line, and neither ends in a+// full stop. The `number` pattern exists to lead on exactly those, so they are+// harvested separately here. Both forms survive as literal substrings of the+// rendered page once whitespace is collapsed, which is what verify.js matches.+const STAT_LABEL = /^[A-Za-z][A-Za-z0-9 .&'/]{1,26}$/;+const STAT_VALUE = /^\$?\d[\d,.]*\s?(?:%|k|m|b|x|\+)?$/i;+const COUNTED_LINE = /^\$?\d[\d,.]*\s+[a-z][A-Za-z0-9 %+,./']{6,96}$/;+const STAT_JUNK = /^(?:home|docs|menu|search|sign in|sign up|console|chat|walk|build|discover|show everything|skip to|cookie|page|step|version|v\d)/i;++export function harvestStats(pageText, limit = 8) {+ const lines = String(pageText || '')+ .split('\n')+ .map((line) => line.replace(/\s+/g, ' ').trim());+ const out = [];+ const add = (candidate) => {+ if (!DASHED.test(candidate) && !out.includes(candidate)) out.push(candidate);+ };+ for (let index = 0; index < lines.length; index++) {+ const line = lines[index];+ if (!line || STAT_JUNK.test(line)) continue;+ // "152 entries across 15 sections": a countable statement the page+ // writes as a line of its own rather than as a sentence.+ if (COUNTED_LINE.test(line) && !/[.!?]$/.test(line)) add(line);+ // A tile: its label, then its value on the next line.+ const value = lines[index + 1];+ if (value && STAT_LABEL.test(line) && STAT_VALUE.test(value)) add(`${line} ${value}`);+ }+ return out.slice(0, limit);+}+export function closestPriorPosts(root, text, limit = 3) {return loadHistory(root).map((prior) => ({ text: prior.replace(/\s+/g, ' ').trim(), similarity: copySimilarity(text, prior) }))@@ -165,11 +199,16 @@ export async function buildBrief(slot, { root, ledgerEntry = {}, pages = null, sconst readme = dir && existsSync(join(dir, 'README.md')) ? read(join(dir, 'README.md')) : '';let liveFacts = [];+ let liveStats = [];let liveStatus = null;if (url && pages) {- const { status, text, raw } = await pages.text(url);+ const { status, text, raw, main } = await pages.text(url);liveStatus = status;- liveFacts = harvestFacts(raw || text);+ // The surface's own text when the reader could isolate it, so a fact+ // never comes out of the header menu or the footer of every other page.+ const body = main || raw || text;+ liveFacts = harvestFacts(body);+ liveStats = harvestStats(body);}const readmePath = ledgerEntry.dir ? `${ledgerEntry.dir}/README.md` : null;@@ -178,7 +217,10 @@ export async function buildBrief(slot, { root, ledgerEntry = {}, pages = null, s...(readme && readmePath ? [{ path: readmePath, lines: quotableLines(readme) }] : []),].filter((row) => row.lines.length);+ // Counters first: a post that can cite the page's own number is the one the+ // engagement report measured as the strongest shape we publish.const evidence = [+ ...liveStats.map((fact) => ({ type: 'page', url, contains: fact })),...liveFacts.slice(0, 12).map((fact) => ({ type: 'page', url, contains: fact })),...fileFacts.flatMap((row) => row.lines.map((line) => ({ type: 'file', path: row.path, contains: line }))),].filter((row) => row.contains && !DASHED.test(row.contains));@@ -206,7 +248,7 @@ export async function buildBrief(slot, { root, ledgerEntry = {}, pages = null, sreadme: readme ? { path: readmePath, paragraphs: paragraphs(readme), endpoints: endpointsIn(readme) } : null,changelog: changelogFor(root, { url: slot.url, title: ledgerEntry.title }),endpoints: [...new Set([...docs.flatMap((doc) => doc.endpoints), ...(readme ? endpointsIn(readme) : [])])].slice(0, 8),- live: { status: liveStatus, facts: liveFacts },+ live: { status: liveStatus, stats: liveStats, facts: liveFacts },fileFacts,evidenceCandidates: evidence,avoid: closestPriorPosts(root, `${ledgerEntry.title || ''} ${ledgerEntry.description || ''}`),diff --git a/api/_lib/announce/ledger.js b/api/_lib/announce/ledger.jsindex 884c37870..6b3457d80 100644--- a/api/_lib/announce/ledger.js+++ b/api/_lib/announce/ledger.js@@ -33,10 +33,22 @@ export function loadQueueFile(root) {}// Surfaces under the `crypto` section render live third-party market data, so a-// frame of one carries the operating rules' coin gate.+// frame of one carries the operating rules' coin gate. The section holds most+// of them but not all: /crypto and /crypto-api are filed under `learn` and+// render the same live launches, prices and pairs, so the path namespace gates+// too. Without that, admitting showcase pages from a content section would+// hand the factory two surfaces whose frames it must not commit unreviewed.+const CRYPTO_NAMESPACE = /^\/crypto(?:$|[/-])/;+export function cryptoPaths(root) {const pages = JSON.parse(readFileSync(resolve(root, 'data/pages.json'), 'utf8'));- return new Set(pages.sections.filter((section) => section.id === 'crypto').flatMap((section) => section.pages.map((page) => page.path)));+ const paths = new Set();+ for (const section of pages.sections) {+ for (const page of section.pages) {+ if (section.id === 'crypto' || CRYPTO_NAMESPACE.test(page.path)) paths.add(page.path);+ }+ }+ return paths;}// Ids that are already spoken for: queued, or carrying a pack.@@ -62,6 +74,20 @@ export function deferrals(root) {return new Map(Object.entries(deferred));}+// The mirror image of the deferrals: surfaces somebody asked for next. The+// ledger scores what it can measure from a description, a route and a+// directory, which is why a surface can be worth posting now and still sit 90+// slots down the calendar. A key here is sequenced ahead of the rest of the+// backlog, inside the slot its own tier owns, so a pin moves the order and+// never the cadence. Committed for the same reason the deferrals are: a+// regenerated ledger cannot re-derive a judgement a person made.+export function priorities(root) {+ const path = resolve(root, 'data/announce-priority.json');+ if (!existsSync(path)) return new Map();+ const { priority = {} } = JSON.parse(readFileSync(path, 'utf8'));+ return new Map(Object.entries(priority));+}+export function backlogOf(root, { ledger = null, queue = null } = {}) {const source = ledger || loadLedger(root);const taken = takenIds(root, queue || loadQueueFile(root));@@ -73,10 +99,10 @@ export function backlogOf(root, { ledger = null, queue = null } = {}) {.filter((entry) => !deferred.has(entry.key));}-export function planFor(root, { start, ledger = null } = {}) {+export function planFor(root, { start, ledger = null, holdGated = false } = {}) {const queue = loadQueueFile(root);const entries = backlogOf(root, { ledger, queue });- const plan = buildPlan(entries, { cadence: queue.cadence, quality: queue.quality, start, cryptoPaths: cryptoPaths(root) });+ const plan = buildPlan(entries, { cadence: queue.cadence, quality: queue.quality, start, cryptoPaths: cryptoPaths(root), holdGated, pinned: priorities(root) });plan.deferred = [...deferrals(root)].map(([key, why]) => ({ key, why }));return plan;}@@ -90,10 +116,16 @@ export function writePlan(root, plan, calendar) {// The written plan, so a batch drafted last week keeps its dates. Rebuilt only// when there is none, or when the caller asks for a fresh start date.-export function loadOrBuildPlan(root, { start = null, refresh = false } = {}) {+export function loadOrBuildPlan(root, { start = null, refresh = false, holdGated = false } = {}) {const path = resolve(root, PLAN_PATH);- if (!refresh && !start && existsSync(path)) return JSON.parse(readFileSync(path, 'utf8'));- const plan = planFor(root, { start: start || new Date(Date.now() + 86_400_000).toISOString().slice(0, 10) });+ if (!refresh && !start && existsSync(path)) {+ const cached = JSON.parse(readFileSync(path, 'utf8'));+ // A plan built with gated surfaces held out dates a different set of+ // surfaces than one built with them in, so a cached plan answers only+ // the question it was built for.+ if (Boolean(cached.holdGated) === Boolean(holdGated)) return cached;+ }+ const plan = planFor(root, { start: start || new Date(Date.now() + 86_400_000).toISOString().slice(0, 10), holdGated });mkdirSync(dirname(path), { recursive: true });writeFileSync(path, `${JSON.stringify(plan, null, '\t')}\n`);return plan;diff --git a/api/_lib/announce/plan.js b/api/_lib/announce/plan.jsindex de1e55f38..621aac509 100644--- a/api/_lib/announce/plan.js+++ b/api/_lib/announce/plan.js@@ -22,6 +22,10 @@// scheduler in api/_lib/x-content/schedule.js enforces this at// publish time by *skipping* an item, so a calendar that ignores// it would stall itself.+// pins data/announce-priority.json: surfaces somebody asked for+// next. They enter the sequencer first and take the earliest+// slot their own tier owns; the pin buys position, never a+// different cadence, lane rule or shape rule.// the coin gate a frame captured from a surface under the `crypto` section of// data/pages.json bakes live third-party tickers into a// committed file, which the operating rules gate on owner@@ -215,23 +219,42 @@ export function sequence(entries, { maximumSameLaneInARow = 2, maximumSamePatterreturn placed;}-export function buildPlan(entries, { cadence = {}, quality = {}, start, cryptoPaths = new Set(), perDay = null } = {}) {+export function buildPlan(entries, { cadence = {}, quality = {}, start, cryptoPaths = new Set(), perDay = null, holdGated = false, pinned = new Map() } = {}) {const table = slotTable(cadence).slice(0, perDay || Infinity);const times = table.map((slot) => slot.at);const day0 = Date.parse(`${start}T00:00:00Z`);if (!Number.isFinite(day0)) throw new Error(`start must be a YYYY-MM-DD date, got ${start}`);+ // A gated surface is one nobody can pack without the owner clearing its+ // frame, so dating it into a near slot promises a post the factory cannot+ // produce and pushes every surface it could have produced weeks out.+ // `holdGated` lifts them out of the calendar and reports them instead.+ const gatedOf = (entry) => Boolean(entry.url && cryptoPaths.has(entry.url));+ const held = holdGated ? entries.filter(gatedOf) : [];+ const plannable = holdGated ? entries.filter((entry) => !gatedOf(entry)) : entries;++ // A pinned surface is one somebody judged worth posting ahead of its score,+ // so it enters the sequencer first and takes the earliest slot its own tier+ // owns. Everything else keeps the ledger's order behind it. The pin buys+ // position only: tier, lane rotation and shape rotation all still apply,+ // because those are what keep the account readable.+ const pinRank = (entry) => {+ const index = [...pinned.keys()].indexOf(entry.key);+ return index < 0 ? Infinity : index;+ };+ const pinnable = [...plannable].sort((left, right) => pinRank(left) - pinRank(right));+// Each position is sequenced against the tier of the slot it will land in,// so a flagship takes the flagship slot instead of whichever minute came// next in the list, while lane and shape still rotate inside that tier.- const ordered = sequence(entries, quality, { tierAt: (position) => table[position % table.length].tier });+ const ordered = sequence(pinnable, quality, { tierAt: (position) => table[position % table.length].tier });const slots = ordered.map((row, index) => {const day = Math.floor(index / table.length);const { at: time, tier: slotTier } = table[index % table.length];const notBefore = new Date(day0 + day * 1440 * MINUTE + minutesOf(time) * MINUTE).toISOString().replace('.000Z', 'Z');const slug = slugFor(row.entry.key);- const gated = Boolean(row.entry.url && cryptoPaths.has(row.entry.url));+ const gated = gatedOf(row.entry);return {position: index + 1,id: slug,@@ -251,6 +274,7 @@ export function buildPlan(entries, { cadence = {}, quality = {}, start, cryptoPashot: `${slug}-hero`,motion: row.pattern === 'clip',mediaGate: gated ? 'owner-approval' : null,+ pinned: pinned.get(row.entry.key) || null,pack: `docs/announcements/${slug}.md`,};});@@ -259,11 +283,23 @@ export function buildPlan(entries, { cadence = {}, quality = {}, start, cryptoPageneratedAt: new Date().toISOString(),start,times,+ holdGated: Boolean(holdGated),+ held: held.map((entry) => ({+ key: entry.key,+ id: slugFor(entry.key),+ url: entry.url || null,+ lane: laneFor(entry),+ tier: tierFor(entry),+ score: entry.score,+ why: 'the frame is captured from a surface rendering live third-party market data, which needs owner approval before it can be committed',+ })).sort((left, right) => right.score - left.score),perDay: times.length,days: Math.ceil(slots.length / times.length),totals: {slots: slots.length,- gated: slots.filter((slot) => slot.mediaGate).length,+ pinned: slots.filter((slot) => slot.pinned).length,+ gated: slots.filter((slot) => slot.mediaGate).length + held.length,+ held: held.length,byTier: Object.fromEntries(TIERS.map((tier) => [tier, slots.filter((slot) => slot.tier === tier).length])),byLane: Object.fromEntries(LANES.map((lane) => [lane, slots.filter((slot) => slot.lane === lane).length])),byPattern: Object.fromEntries(PATTERNS.map((pattern) => [pattern, slots.filter((slot) => slot.pattern === pattern).length])),diff --git a/api/_lib/x-content/editorial.js b/api/_lib/x-content/editorial.jsindex 649b9c666..10237a5c3 100644--- a/api/_lib/x-content/editorial.js+++ b/api/_lib/x-content/editorial.js@@ -59,12 +59,19 @@ export const SLANG_TERMS = [/\bbased\b/i, /\bwe'?re so back\b/i, /\bcooking\b/i, /\bfam\b/i, /\bIYKYK\b/i, /\blowkey\b/i, /\bngl\b/i, /\btbh\b/i,];+// "awesome" is filler when it is an adjective and a proper noun when it is not:+// an awesome list is a named format on GitHub, and Awesome 3D Agents is the+// name of a surface this account has to be able to announce. Banning the word+// outright would have made the one post about that page unwritable, so the+// adjective is what is banned.+const AWESOME_AS_FILLER = /\bawesome\b(?![\s-]+(?:lists?\b|3D Agents\b))/i;+export const FILLER_TERMS = [/\bvery\b/i, /\breally\b/i, /\bsimply\b/i, /\bliterally\b/i, /\bactually\b/i, /\bbasically\b/i, /\btruly\b/i,/\bincredibly\b/i, /\bsuper (?!app)\w+/i, /\bpowerful\b/i, /\bcutting[- ]edge\b/i, /\bstate[- ]of[- ]the[- ]art\b/i,/\brobust\b/i, /\binnovative\b/i, /\bworld[- ]class\b/i, /\bbest[- ]in[- ]class\b/i, /\bleverag(?:e|es|ing)\b/i,/\bempower(?:s|ing)?\b/i, /\bunleash(?:es|ing)?\b/i, /\belevat(?:e|es|ing)\b/i, /\bharness(?:es|ing)?\b/i,- /\bjourney\b/i, /\bsynerg(?:y|ies)\b/i, /\bparadigm\b/i, /\bgroundbreaking\b/i, /\bawesome\b/i, /\bamazing\b/i,+ /\bjourney\b/i, /\bsynerg(?:y|ies)\b/i, /\bparadigm\b/i, /\bgroundbreaking\b/i, AWESOME_AS_FILLER, /\bamazing\b/i,];export const PUSHY_CTAS = [diff --git a/api/_lib/x-content/verify.js b/api/_lib/x-content/verify.jsindex b1845883e..cb7d9e075 100644--- a/api/_lib/x-content/verify.js+++ b/api/_lib/x-content/verify.js@@ -90,9 +90,15 @@ export function createPageReader() {).catch(() => {});const text = await page.evaluate(() => document.body.innerText);+ // The page without its shell. A claim check matches against the+ // whole body, correctly, because that is what a reader sees; but+ // a fact harvested for an announcement must come from the surface+ // itself, and the site's mega-menu puts three hundred lines of+ // other products' copy above every page's own first word.+ const main = await page.evaluate(() => document.querySelector('main')?.innerText || '');// `text` is normalized for substring checks; `raw` keeps the line// breaks and casing the announcement brief harvests facts from.- const result = { status, text: normalize(text), raw: text };+ const result = { status, text: normalize(text), raw: text, main };cache.set(url, result);return result;} finally {diff --git a/data/announce-deferred.json b/data/announce-deferred.jsonindex 3e2ca5a56..2be7e0f57 100644--- a/data/announce-deferred.json+++ b/data/announce-deferred.json@@ -2,6 +2,14 @@"$comment": "Surfaces held out of the announcement calendar, with the reason. The ledger (data/announcements.json) is regenerated from the repository on every run and cannot re-derive a judgement made by looking at a captured frame, so the judgement lives here instead. Remove an entry when the surface is worth posting again; `npm run announce:plan` picks it up on the next run.","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."+ "/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.",+ "/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."}}diff --git a/data/announce-media.json b/data/announce-media.jsonindex ffad4f657..d178525ad 100644--- a/data/announce-media.json+++ b/data/announce-media.json@@ -148,6 +148,73 @@"url": "/materialize","alt": "The three.ws Materialize page: a drop area for any .glb beside models fresh from the Forge, over three columns explaining that the price is measured from the repaired mesh, that checkout is USDC on Solana, and that agents can order over x402.","caption": "Captured from the live /materialize route for the materialize announcement."+ },+ {+ "id": "activity-mcp-hero",+ "surface": "@three-ws/activity-mcp",+ "viewport": "wide",+ "alt": "A dark title card reading at three ws slash activity dash mcp, with the package description underneath and the install command in a monospace row at the bottom.",+ "caption": "Title card for @three-ws/activity-mcp, typeset from its README and package.json.",+ "card": {+ "dir": "packages/activity-mcp",+ "title": "@three-ws/activity-mcp",+ "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",+ "url": "/knock",+ "alt": "The Knock page showing a door with its price and greeting, the message box under it, and the open-doors directory listing handles and prices beside it.",+ "caption": "Captured from the live /knock route for the knock announcement."+ },+ {+ "id": "avatar-mcp-hero",+ "surface": "@three-ws/avatar-mcp",+ "viewport": "wide",+ "alt": "A dark title card naming the three ws avatar MCP package, its one-line description underneath, and the npx install command in a monospace row at the bottom.",+ "caption": "Title card for @three-ws/avatar-mcp, typeset from its README and package.json.",+ "card": {+ "dir": "packages/threews-avatar-mcp",+ "title": "@three-ws/avatar-mcp",+ "description": "MCP server for three.ws 3D avatars by three.ws, render a live, rotatable on-chain avatar inline (interactive MCP App), get a paste-anywhere embed iframe, or fetch avatar metadata. Free, no API key."+ }+ },+ {+ "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.",+ "caption": "Captured from the live /assistant route for the assistant announcement.",+ "settle": 9000,+ "motion": {+ "seconds": 5,+ "fps": 12+ }+ },+ {+ "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+ }}]}diff --git a/data/announce-priority.json b/data/announce-priority.jsonnew file mode 100644index 000000000..8d6362cfa--- /dev/null+++ b/data/announce-priority.json@@ -0,0 +1,6 @@+{+ "$comment": "Surfaces the owner asked for next, with the reason. The mirror image of data/announce-deferred.json: the ledger is rebuilt from the repository on every run and scores a surface only on what it can measure from a description, a route and a directory, so it cannot know that somebody looked at a surface and decided it should go out ahead of its score. A key listed here is sequenced before the rest of the backlog, still inside the slot its own tier owns, so a pin changes the order and never the cadence. `npm run announce:plan` picks it up on the next run. Remove the entry once the surface is packed, since a packed surface leaves the plan anyway.",+ "priority": {+ "/awesome": "Owner asked for it on 2026-09-20. Awesome 3D Agents is the only map of the whole give-an-agent-a-body pipeline: 152 link-checked projects across 15 sections, published both as a filterable page and in the standard awesome-list format on GitHub, so it is shareable by construction and earns links from people who build in the field rather than impressions from people scrolling past."+ }+}diff --git a/data/x-content/queue.json b/data/x-content/queue.jsonindex a99ef33d2..cafcda5bf 100644--- a/data/x-content/queue.json+++ b/data/x-content/queue.json@@ -297,245 +297,6 @@],"note": "Announced by hand on 2026-09-10 (see data/x-content/external.json). Never post again."},- {- "id": "three-token-mcp",- "status": "approved",- "kind": "post",- "lane": "token",- "pattern": "mechanism",- "notBefore": "2026-09-18T16:00:00Z",- "source": {- "path": "docs/announcements/three-token-mcp.md"- },- "posts": [- {- "text": "An MCP server that lets an AI burn $THREE on @solana. three_burn is flagged irreversible and by default won't sign without confirm: true. three.ws/mcp-tools?server=three-token-mcp",- "textFrom": "docs/announcements/three-token-mcp.post.txt",- "media": [- {- "path": "public/announce/img/three-token-mcp-hero.webp",- "alt": "The three.ws MCP Tool Catalog filtered to the @three-ws/three-token-mcp server: 3 of 321 tools, with three_balance and three_price labelled read-only and three_burn labelled irreversible, all free"- }- ]- }- ],- "claims": [- {- "says": "burn $THREE on @solana",- "evidence": [- {- "type": "page",- "url": "https://three.ws/mcp-tools?server=three-token-mcp&tool=three_burn",- "contains": "Burn $THREE on-chain"- },- {- "type": "page",- "url": "https://three.ws/mcp-tools?server=three-token-mcp&tool=three_burn",- "contains": "signs and broadcasts on Solana mainnet"- },- {- "type": "file",- "path": "packages/three-token-mcp/src/lib/token.js",- "contains": "export function assertCanonicalThree(config)"- }- ]- },- {- "says": "flagged irreversible",- "evidence": [- {- "type": "page",- "url": "https://three.ws/mcp-tools?server=three-token-mcp&tool=three_burn",- "contains": "Irreversible. Cannot be undone once it runs."- },- {- "type": "file",- "path": "packages/three-token-mcp/src/tools/three-burn.js",- "contains": "destructiveHint: true"- }- ]- },- {- "says": "by default won't sign without confirm: true",- "evidence": [- {- "type": "page",- "url": "https://three.ws/mcp-tools?server=three-token-mcp&tool=three_burn",- "contains": "IRREVERSIBLE: pass confirm:true"- },- {- "type": "file",- "path": "packages/three-token-mcp/src/tools/three-burn.js",- "contains": "if (REQUIRE_CONFIRM && confirm !== true)"- },- {- "type": "file",- "path": "packages/three-token-mcp/src/config.js",- "contains": "if (raw === undefined) return true;"- }- ]- }- ],- "mentions": {- "@solana": "three_burn signs and broadcasts one Solana mainnet transaction (packages/three-token-mcp/src/lib/token.js); $THREE is an SPL token and Solana is the platform's home chain."- },- "tier": 1,- "probes": [- {- "type": "command",- "name": "three_burn refuses to sign without confirm: true",- "argv": [- "node",- "--test",- "packages/three-token-mcp/test/burn-policy.test.mjs"- ]- },- {- "type": "api",- "name": "the package is published on npm",- "url": "https://registry.npmjs.org/@three-ws%2fthree-token-mcp",- "expect": {- "json": {- "path": "dist-tags.latest",- "exists": true- }- }- },- {- "type": "api",- "name": "the live tool catalog lists three_burn",- "url": "https://three.ws/mcp-catalog.json",- "expect": {- "contains": "\"three_burn\""- }- }- ]- },- {- "id": "forge-max",- "status": "approved",- "kind": "post",- "lane": "developer",- "pattern": "number",- "notBefore": "2026-09-18T23:00:00Z",- "source": {- "path": "docs/announcements/forge-max.md",- "url": "https://three.ws/forge-max"- },- "posts": [- {- "text": "three.ws/forge-max opens the Forge with its top tier already pinned: 200k-poly geometry, 4K PBR textures, and the engine picked by what you asked for.",- "textFrom": "docs/announcements/forge-max.post.txt",- "media": [- {- "path": "public/announce/img/forge-max-hero.webp",- "alt": "The three.ws Forge Max page: the quality row has High pinned with a $THREE badge above the engine list, and the page subtitle reads 200k-poly geometry, 4K PBR textures, subject-aware engine routing."- }- ]- }- ],- "claims": [- {- "says": "200k-poly geometry, 4K PBR textures",- "evidence": [- {- "type": "page",- "url": "https://three.ws/forge-max",- "contains": "The highest-quality lane: 200k-poly geometry, 4K PBR textures, subject-aware engine routing. A $THREE holder perk."- }- ]- }- ],- "mentions": {},- "tier": 2,- "probes": [- {- "type": "api",- "name": "the High tier is a real gated lane at 200k poly + PBR",- "url": "https://three.ws/api/forge",- "method": "POST",- "body": {- "prompt": "a plain wooden stool",- "tier": "high"- },- "expect": {- "status": 402,- "contains": "200k poly + PBR"- }- },- {- "type": "browser",- "name": "/forge-max opens the Forge with the High tier pinned",- "steps": [- {- "goto": "https://three.ws/forge-max"- },- {- "expect": "Forge Max"- },- {- "expect": "200k-poly geometry, 4K PBR textures"- }- ]- },- {- "type": "api",- "name": "the Forge Max page is served",- "url": "https://three.ws/forge-max",- "expect": {- "status": 200- }- }- ]- },- {- "id": "materialize",- "status": "review",- "kind": "post",- "lane": "developer",- "pattern": "mechanism",- "notBefore": "2026-09-19T23:00:00Z",- "source": {- "path": "docs/announcements/materialize.md",- "url": "https://three.ws/materialize"- },- "posts": [- {- "text": "Materialize prices a 3D print from the repaired mesh: it measures the true solid volume and charges that volume in your material, paid in USDC on Solana: three.ws/materialize",- "textFrom": "docs/announcements/materialize.post.txt",- "media": [- {- "path": "public/announce/img/materialize-hero.webp",- "alt": "The three.ws Materialize page: a drop area for any .glb beside models fresh from the Forge, over three columns explaining that the price is measured from the repaired mesh, that checkout is USDC on Solana, and that agents can order over x402."- }- ]- }- ],- "claims": [- {- "says": "measures the true solid volume and charges that volume in your material",- "evidence": [- {- "type": "page",- "url": "https://three.ws/materialize",- "contains": "Every quote comes from the mesh itself: the analyzer computes the true solid volume of the repaired model, and the price is that volume in the material you picked. Nothing is estimated from a bounding box."- }- ]- },- {- "says": "paid in USDC on Solana",- "evidence": [- {- "type": "page",- "url": "https://three.ws/materialize",- "contains": "There is no card processor. You pay the exact quoted amount in USDC on Solana, the order is opened against a signed quote, and the price can never move between the quote and the charge."- }- ]- }- ],- "mentions": {},- "tier": 2- },{"id": "embed-30-seconds","status": "approved",@@ -876,20 +637,134 @@]},{- "id": "ai-3d-skills",- "status": "paused",+ "id": "three-token-mcp",+ "status": "approved","kind": "post",- "tier": 2,- "lane": "creation",- "pattern": "proof",- "notBefore": "2026-09-18T17:00:00Z",+ "lane": "token",+ "pattern": "mechanism",+ "notBefore": "2026-09-18T16:00:00Z","source": {- "path": "docs/agent-skills.md"+ "path": "docs/announcements/three-token-mcp.md"},"posts": [{- "text": "Your AI can make 3D now.\n\nInstall our free 3D skills for Claude, then ask it for a chair.\n\nIt checks 3,500+ free 3D assets first. If nothing fits, it makes a new model from your words.\n\nNo account. No API key.\n\nthree.ws/docs/agent-skills",- "textFrom": "docs/announcements/ai-3d-skills.post.txt",+ "text": "An MCP server that lets an AI burn $THREE on @solana. three_burn is flagged irreversible and by default won't sign without confirm: true. three.ws/mcp-tools?server=three-token-mcp",+ "textFrom": "docs/announcements/three-token-mcp.post.txt",+ "media": [+ {+ "path": "public/announce/img/three-token-mcp-hero.webp",+ "alt": "The three.ws MCP Tool Catalog filtered to the @three-ws/three-token-mcp server: 3 of 321 tools, with three_balance and three_price labelled read-only and three_burn labelled irreversible, all free"+ }+ ]+ }+ ],+ "claims": [+ {+ "says": "burn $THREE on @solana",+ "evidence": [+ {+ "type": "page",+ "url": "https://three.ws/mcp-tools?server=three-token-mcp&tool=three_burn",+ "contains": "Burn $THREE on-chain"+ },+ {+ "type": "page",+ "url": "https://three.ws/mcp-tools?server=three-token-mcp&tool=three_burn",+ "contains": "signs and broadcasts on Solana mainnet"+ },+ {+ "type": "file",+ "path": "packages/three-token-mcp/src/lib/token.js",+ "contains": "export function assertCanonicalThree(config)"+ }+ ]+ },+ {+ "says": "flagged irreversible",+ "evidence": [+ {+ "type": "page",+ "url": "https://three.ws/mcp-tools?server=three-token-mcp&tool=three_burn",+ "contains": "Irreversible. Cannot be undone once it runs."+ },+ {+ "type": "file",+ "path": "packages/three-token-mcp/src/tools/three-burn.js",+ "contains": "destructiveHint: true"+ }+ ]+ },+ {+ "says": "by default won't sign without confirm: true",+ "evidence": [+ {+ "type": "page",+ "url": "https://three.ws/mcp-tools?server=three-token-mcp&tool=three_burn",+ "contains": "IRREVERSIBLE: pass confirm:true"+ },+ {+ "type": "file",+ "path": "packages/three-token-mcp/src/tools/three-burn.js",+ "contains": "if (REQUIRE_CONFIRM && confirm !== true)"+ },+ {+ "type": "file",+ "path": "packages/three-token-mcp/src/config.js",+ "contains": "if (raw === undefined) return true;"+ }+ ]+ }+ ],+ "mentions": {+ "@solana": "three_burn signs and broadcasts one Solana mainnet transaction (packages/three-token-mcp/src/lib/token.js); $THREE is an SPL token and Solana is the platform's home chain."+ },+ "tier": 1,+ "probes": [+ {+ "type": "command",+ "name": "three_burn refuses to sign without confirm: true",+ "argv": [+ "node",+ "--test",+ "packages/three-token-mcp/test/burn-policy.test.mjs"+ ]+ },+ {+ "type": "api",+ "name": "the package is published on npm",+ "url": "https://registry.npmjs.org/@three-ws%2fthree-token-mcp",+ "expect": {+ "json": {+ "path": "dist-tags.latest",+ "exists": true+ }+ }+ },+ {+ "type": "api",+ "name": "the live tool catalog lists three_burn",+ "url": "https://three.ws/mcp-catalog.json",+ "expect": {+ "contains": "\"three_burn\""+ }+ }+ ]+ },+ {+ "id": "ai-3d-skills",+ "status": "paused",+ "kind": "post",+ "tier": 2,+ "lane": "creation",+ "pattern": "proof",+ "notBefore": "2026-09-18T17:00:00Z",+ "source": {+ "path": "docs/agent-skills.md"+ },+ "posts": [+ {+ "text": "Your AI can make 3D now.\n\nInstall our free 3D skills for Claude, then ask it for a chair.\n\nIt checks 3,500+ free 3D assets first. If nothing fits, it makes a new model from your words.\n\nNo account. No API key.\n\nthree.ws/docs/agent-skills",+ "textFrom": "docs/announcements/ai-3d-skills.post.txt","media": [{"path": "public/x-media/ai-3d-skills/card.png",@@ -987,6 +862,131 @@}]},+ {+ "id": "forge-max",+ "status": "approved",+ "kind": "post",+ "lane": "developer",+ "pattern": "number",+ "notBefore": "2026-09-18T23:00:00Z",+ "source": {+ "path": "docs/announcements/forge-max.md",+ "url": "https://three.ws/forge-max"+ },+ "posts": [+ {+ "text": "three.ws/forge-max opens the Forge with its top tier already pinned: 200k-poly geometry, 4K PBR textures, and the engine picked by what you asked for.",+ "textFrom": "docs/announcements/forge-max.post.txt",+ "media": [+ {+ "path": "public/announce/img/forge-max-hero.webp",+ "alt": "The three.ws Forge Max page: the quality row has High pinned with a $THREE badge above the engine list, and the page subtitle reads 200k-poly geometry, 4K PBR textures, subject-aware engine routing."+ }+ ]+ }+ ],+ "claims": [+ {+ "says": "200k-poly geometry, 4K PBR textures",+ "evidence": [+ {+ "type": "page",+ "url": "https://three.ws/forge-max",+ "contains": "The highest-quality lane: 200k-poly geometry, 4K PBR textures, subject-aware engine routing. A $THREE holder perk."+ }+ ]+ }+ ],+ "mentions": {},+ "tier": 2,+ "probes": [+ {+ "type": "api",+ "name": "the High tier is a real gated lane at 200k poly + PBR",+ "url": "https://three.ws/api/forge",+ "method": "POST",+ "body": {+ "prompt": "a plain wooden stool",+ "tier": "high"+ },+ "expect": {+ "status": 402,+ "contains": "200k poly + PBR"+ }+ },+ {+ "type": "browser",+ "name": "/forge-max opens the Forge with the High tier pinned",+ "steps": [+ {+ "goto": "https://three.ws/forge-max"+ },+ {+ "expect": "Forge Max"+ },+ {+ "expect": "200k-poly geometry, 4K PBR textures"+ }+ ]+ },+ {+ "type": "api",+ "name": "the Forge Max page is served",+ "url": "https://three.ws/forge-max",+ "expect": {+ "status": 200+ }+ }+ ]+ },+ {+ "id": "materialize",+ "status": "review",+ "kind": "post",+ "lane": "developer",+ "pattern": "mechanism",+ "notBefore": "2026-09-19T23:00:00Z",+ "source": {+ "path": "docs/announcements/materialize.md",+ "url": "https://three.ws/materialize"+ },+ "posts": [+ {+ "text": "Materialize prices a 3D print from the repaired mesh: it measures the true solid volume and charges that volume in your material, paid in USDC on Solana: three.ws/materialize",+ "textFrom": "docs/announcements/materialize.post.txt",+ "media": [+ {+ "path": "public/announce/img/materialize-hero.webp",+ "alt": "The three.ws Materialize page: a drop area for any .glb beside models fresh from the Forge, over three columns explaining that the price is measured from the repaired mesh, that checkout is USDC on Solana, and that agents can order over x402."+ }+ ]+ }+ ],+ "claims": [+ {+ "says": "measures the true solid volume and charges that volume in your material",+ "evidence": [+ {+ "type": "page",+ "url": "https://three.ws/materialize",+ "contains": "Every quote comes from the mesh itself: the analyzer computes the true solid volume of the repaired model, and the price is that volume in the material you picked. Nothing is estimated from a bounding box."+ }+ ]+ },+ {+ "says": "paid in USDC on Solana",+ "evidence": [+ {+ "type": "page",+ "url": "https://three.ws/materialize",+ "contains": "There is no card processor. You pay the exact quoted amount in USDC on Solana, the order is opened against a signed quote, and the price can never move between the quote and the charge."+ }+ ]+ }+ ],+ "mentions": {},+ "tier": 2+ },{"id": "free-objects","status": "approved",@@ -1205,6 +1205,250 @@]}]+ },+ {+ "id": "activity-mcp",+ "status": "draft",+ "kind": "post",+ "tier": 3,+ "lane": "developer",+ "pattern": "mechanism",+ "notBefore": "2026-09-21T04:00:00Z",+ "source": {+ "path": "docs/announcements/activity-mcp.md"+ },+ "posts": [+ {+ "text": "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",+ "textFrom": "docs/announcements/activity-mcp.post.txt",+ "media": [+ {+ "path": "public/announce/img/activity-mcp-hero.webp",+ "alt": "A dark title card reading at three ws slash activity dash mcp, with the package description underneath and the install command in a monospace row at the bottom."+ }+ ]+ },+ {+ "text": "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."+ },+ {+ "text": "No key, no signer, no payment. Install it, point it at the public API, and ask."+ }+ ],+ "claims": [+ {+ "says": "Five tools",+ "evidence": [+ {+ "type": "file",+ "path": "packages/activity-mcp/README.md",+ "contains": "All five tools read live data: rankings, the holder board, and the feed all move between calls, so none are idempotent."+ }+ ]+ },+ {+ "says": "Every ranking, tier, and event comes straight from the public three.ws API",+ "evidence": [+ {+ "type": "file",+ "path": "packages/activity-mcp/README.md",+ "contains": "Every ranking, tier, and event comes straight from the public three.ws API."+ }+ ]+ }+ ],+ "mentions": {}+ },+ {+ "id": "mocap-studio",+ "status": "draft",+ "kind": "post",+ "tier": 2,+ "lane": "community",+ "pattern": "clip",+ "notBefore": "2026-09-21T12:00:00Z",+ "source": {+ "path": "docs/announcements/mocap-studio.md",+ "url": "https://three.ws/mocap-studio"+ },+ "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",+ "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."+ }+ ]+ },+ {+ "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."+ }+ ],+ "claims": [+ {+ "says": "52 ARKit blendshapes and 478 landmarks per frame",+ "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."+ }+ ]+ },+ {+ "says": "Calibrate to your neutral face, record a clip, replay it, and save it.",+ "evidence": [+ {+ "type": "file",+ "path": "docs/mocap-studio.md",+ "contains": "Calibrate to your neutral face, record a clip, replay it, and save it."+ }+ ]+ }+ ],+ "mentions": {}+ },+ {+ "id": "knock",+ "status": "draft",+ "kind": "post",+ "tier": 1,+ "lane": "token",+ "pattern": "walkthrough",+ "notBefore": "2026-09-21T20:00:00Z",+ "source": {+ "path": "docs/announcements/knock.md",+ "url": "https://three.ws/knock"+ },+ "posts": [+ {+ "text": "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",+ "textFrom": "docs/announcements/knock.post.txt",+ "media": [+ {+ "path": "public/announce/img/knock-hero.webp",+ "alt": "The Knock page showing a door with its price and greeting, the message box under it, and the open-doors directory listing handles and prices beside it."+ }+ ]+ },+ {+ "text": "A person pays with the wallet in their browser. An agent pays over x402 with no human in the loop."+ },+ {+ "text": "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."+ }+ ],+ "claims": [+ {+ "says": "says who is at the door and what they paid",+ "evidence": [+ {+ "type": "page",+ "url": "https://three.ws/knock",+ "contains": "Your companion walks on wherever you are on the site and says who is at the door and what they paid."+ }+ ]+ },+ {+ "says": "A person pays with the wallet in their browser. An agent pays over x402 with no human in the loop.",+ "evidence": [+ {+ "type": "page",+ "url": "https://three.ws/knock",+ "contains": "A person pays with the wallet in their browser. An agent pays over x402 with no human in the loop."+ }+ ]+ },+ {+ "says": "The x402 lane sends your USDC to the recipient the instant the payment clears.",+ "evidence": [+ {+ "type": "file",+ "path": "docs/knock.md",+ "contains": "The x402 lane sends your USDC to the recipient the instant the payment clears."+ }+ ]+ },+ {+ "says": "Your price, your wallet, and everything that comes through it stays private to your account.",+ "evidence": [+ {+ "type": "page",+ "url": "https://three.ws/knock",+ "contains": "Your price, your wallet, and everything that comes through it stays private to your account."+ }+ ]+ }+ ],+ "mentions": {}+ },+ {+ "id": "avatar-mcp",+ "status": "draft",+ "kind": "post",+ "tier": 3,+ "lane": "developer",+ "pattern": "mechanism",+ "notBefore": "2026-09-22T04:00:00Z",+ "source": {+ "path": "docs/announcements/avatar-mcp.md"+ },+ "posts": [+ {+ "text": "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",+ "textFrom": "docs/announcements/avatar-mcp.post.txt",+ "media": [+ {+ "path": "public/announce/img/avatar-mcp-hero.webp",+ "alt": "A dark title card naming the three ws avatar MCP package, its one-line description underneath, and the npx install command in a monospace row at the bottom."+ }+ ]+ },+ {+ "text": "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."+ },+ {+ "text": "Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed, so the tool degrades gracefully everywhere."+ }+ ],+ "claims": [+ {+ "says": "All three tools are free and read-only",+ "evidence": [+ {+ "type": "file",+ "path": "packages/threews-avatar-mcp/README.md",+ "contains": "All three tools are free, read-only, and annotated (`readOnlyHint`, `idempotentHint`, `openWorldHint`) so hosts can run them without confirmation prompts."+ }+ ]+ },+ {+ "says": "The avatar is live in the conversation: rotate it, zoom it, watch it idle, without leaving the chat.",+ "evidence": [+ {+ "type": "file",+ "path": "packages/threews-avatar-mcp/README.md",+ "contains": "The avatar is live in the conversation: rotate it, zoom it, watch it idle, without leaving the chat."+ }+ ]+ },+ {+ "says": "Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed, so the tool degrades gracefully everywhere.",+ "evidence": [+ {+ "type": "file",+ "path": "packages/threews-avatar-mcp/README.md",+ "contains": "Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed, so the tool degrades gracefully everywhere."+ }+ ]+ }+ ],+ "mentions": {}}]}diff --git a/docs/announcement-factory.md b/docs/announcement-factory.mdindex 94c021fb8..5bdf4bb62 100644--- a/docs/announcement-factory.md+++ b/docs/announcement-factory.md@@ -30,6 +30,7 @@ npm run announce:rank -- --probe --write # rebuild the ledger and probe everynpm run announce:plan # print the next 30 slotsnpm run announce:plan -- --write # data/announce-plan/plan.json + CALENDAR.mdnpm run announce:plan -- --batch 3 # one week's batch in full+npm run announce:plan -- --hold-gated # date only what the factory can pack on its own```[`scripts/announce-plan.mjs`](../scripts/announce-plan.mjs) turns the ranked backlog into dated@@ -38,14 +39,22 @@ publishing rather than chosen here:| Decision | Where it comes from ||---|---|-| How many posts a day, and at what times | The `cadence` block of [`data/x-content/queue.json`](../data/x-content/queue.json): daily cap, minimum gap, quiet hours. A slot whose jitter window could land inside quiet hours is dropped rather than promised. |+| How many posts a day, at what times, and which tier owns each one | The `cadence.slots` table of [`data/x-content/queue.json`](../data/x-content/queue.json), which is the same table the publisher fills from: T3 at 04:00 UTC, T2 at 12:00, T1 at 20:00. With no table declared, the times are derived from the daily cap, minimum gap and quiet hours instead, and a slot whose jitter window could land inside quiet hours is dropped rather than promised. || What order, and which shape | The ledger's scores, then rotation: no more than `maximumSameLaneInARow` of one audience, no more than `maximumSamePatternInARow` of one post shape, from the same queue file. |+| Which tier a surface is | What it is: a flagship (T1) is a `token`-lane surface or one that legitimately names a partner, proof of work (T3) is a package, worker or service, whose frame is a typeset card rather than a route, and everything with a page behind it is a feature (T2). The tier travels into the queue item, because the publisher gives each tier a slot of its own and an item with no tier is treated as a T2 feature. || Which ones need owner approval first | Any surface in the `crypto` section of [`data/pages.json`](../data/pages.json) renders live third-party market data, so a frame of it falls under the operating rules' coin gate. Those slots carry `mediaGate: "owner-approval"` and the factory skips them unless asked. |The plan is a pure function of the ledger and the start date, so it is regenerated rather thanmaintained. A surface already queued, already carrying a pack, or listed in[`data/announce-deferred.json`](../data/announce-deferred.json) is dropped from it.+**Gated surfaces are held out of the dated calendar.** `--hold-gated` (which `announce:kit` passes+for you unless you ask for `--include-gated`) lifts every owner-gated surface out of the schedule+and lists it in a "Held for owner approval" table in `CALENDAR.md` instead. Dating them promises+slots the factory cannot fill on its own, and because the gated surfaces score highest they take+the flagship slot every day, which is how the packable backlog ended up weeks behind slots it+could have had. Clearing a frame puts that surface back in the next plan.+**Deferrals.** The ledger is rebuilt from the repository on every run, so it cannot remember ajudgement someone made by looking at a captured frame. `data/announce-deferred.json` is where thatjudgement lives, with the reason, and it is committed for exactly that reason.diff --git a/docs/announcements/activity-mcp.md b/docs/announcements/activity-mcp.mdnew file mode 100644index 000000000..31b896b7d--- /dev/null+++ b/docs/announcements/activity-mcp.md@@ -0,0 +1,103 @@+# Announcement pack: Live three.ws discovery inside any MCP client++**Surface:** [`@three-ws/activity-mcp`](https://three.ws) · **Stage:** drafted · **Slot:** 2026-09-21 · **Announced externally:** never++Ranked 31 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/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.++---++## At a glance++| Field | Value |+|---|---|+| Pack id | `activity-mcp` |+| 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 | developer / mechanism |+| Audience | Engineers who will read the code |+| Primary channel | X, @trythreews, through the reviewed content queue |+| Secondary channels | Telegram (@three_ws), the surface's own docs page |+| Proof | https://three.ws |+| Tracked links | Telegram `https://three.ws?utm_source=telegram&utm_medium=community&utm_campaign=announce-activity-mcp&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 https://three.ws and use it |+| Media | `activity-mcp-hero`, still frame |+| KPI | route sessions and docs reads on the day of the post |++## 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+- **token (18)**: touches $THREE or the agent economy, the topic band that measured highest in our own archive+- **partner (12)**: names a partner the surface genuinely runs on, so a tag is defensible+- **depth (11)**: documented in the tree, so there is enough to write a mechanism about and link proof for++The changelog has 1 entry about it, the most recent from 2026-06-24: "AI agents can now see what's hot on three.ws over MCP, trending agents and coins, the $THREE holder board, and the live activity ticker".++## The claim, and where it is checked++> 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 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 |+|---|---|+| Five tools | `packages/activity-mcp/README.md` contains "All five tools read live data: rankings, the holder board, and the feed all move between c" |+| Every ranking, tier, and event comes straight from the public three.ws API | `packages/activity-mcp/README.md` contains "Every ranking, tier, and event comes straight from the public three.ws API." |++## 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 |+|---|---|---|+| `activity-mcp-hero` | `/announce/img/activity-mcp-hero.webp` | Still frame of the live route. |++**Alt text, required on the post:**++> A dark title card reading at three ws slash activity dash mcp, with the package description underneath and the install command in a monospace row at the bottom.++## The post++Pattern: mechanism. **172 weighted characters**, inside the 100 to 179 band that measured a 3.0x lift. Postable file: [`activity-mcp.post.txt`](./activity-mcp.post.txt), which is the byte-for-byte source the queue item points at.++```text+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+```++### Why it is written that way++The post leads on the mechanism a developer can act on: five read-only tools that put the platform's live discovery data inside any MCP client. That is the strongest true thing here because the package needs no key, no signer and no payment, so the distance between reading the post and running the thing is one install.++### Thread++2/ (162)++```text+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.+```++3/ (79)++```text+No key, no signer, no payment. Install it, point it at the public API, and ask.+```++## 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+The three.ws live discovery surface is now readable from any MCP client. Five tools cover trending agents, the $THREE holder leaderboard with its tiers, and the site-wide activity ticker. Every ranking, tier, and event comes straight from the public three.ws API, so your assistant sees what the site sees. It is read-only and free: npmjs.com/package/@three-ws/activity-mcp+```++## Ship it++```bash+npm run announce:media -- --only activity-mcp-hero # capture the frame from the live route+npm run x:content -- review activity-mcp # lint, live fact checks, AI editor+npm run x:content -- run --dry-run --id activity-mcp # exactly what would be sent to X+```++The queue item is `activity-mcp` 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/activity-mcp.post.txt b/docs/announcements/activity-mcp.post.txtnew file mode 100644index 000000000..27d33778d--- /dev/null+++ b/docs/announcements/activity-mcp.post.txt@@ -0,0 +1 @@+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-mcpdiff --git a/docs/announcements/avatar-mcp.md b/docs/announcements/avatar-mcp.mdnew file mode 100644index 000000000..eb2948a3b--- /dev/null+++ b/docs/announcements/avatar-mcp.md@@ -0,0 +1,104 @@+# Announcement pack: A live 3D avatar rendered inside the chat++**Surface:** [`@three-ws/avatar-mcp`](https://three.ws) · **Stage:** drafted · **Slot:** 2026-09-22 · **Announced externally:** never++Ranked 36 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/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.++---++## At a glance++| Field | Value |+|---|---|+| Pack id | `avatar-mcp` |+| 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 | developer / mechanism |+| Audience | Engineers who will read the code |+| Primary channel | X, @trythreews, through the reviewed content queue |+| Secondary channels | Telegram (@three_ws), the surface's own docs page |+| Proof | https://three.ws |+| Tracked links | Telegram `https://three.ws?utm_source=telegram&utm_medium=community&utm_campaign=announce-avatar-mcp&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 https://three.ws and use it |+| Media | `avatar-mcp-hero`, still frame |+| KPI | route sessions and docs reads on the day of the post |++## 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+- **token (18)**: touches $THREE or the agent economy, the topic band that measured highest in our own archive+- **partner (12)**: names a partner the surface genuinely runs on, so a tag is defensible+- **depth (11)**: documented in the tree, so there is enough to write a mechanism about and link proof for++The changelog has 1 entry about it, the most recent from 2026-06-25: "three.ws Claude Code plugin marketplace, install agents, wallet, 3D, and pump.fun tools in one command".++## The claim, and where it is checked++> 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++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 |+|---|---|+| All three tools are free and read-only | `packages/threews-avatar-mcp/README.md` contains "All three tools are free, read-only, and annotated (`readOnlyHint`, `idempotentHint`, `ope" |+| The avatar is live in the conversation: rotate it, zoom it, watch it idle, without leaving the chat. | `packages/threews-avatar-mcp/README.md` contains "The avatar is live in the conversation: rotate it, zoom it, watch it idle, without leaving" |+| Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed, so the tool degrades gracefully everywhere. | `packages/threews-avatar-mcp/README.md` contains "Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed" |++## 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 |+|---|---|---|+| `avatar-mcp-hero` | `/announce/img/avatar-mcp-hero.webp` | Still frame of the live route. |++**Alt text, required on the post:**++> A dark title card naming the three ws avatar MCP package, its one-line description underneath, and the npx install command in a monospace row at the bottom.++## The post++Pattern: mechanism. **148 weighted characters**, inside the 100 to 179 band that measured a 3.0x lift. Postable file: [`avatar-mcp.post.txt`](./avatar-mcp.post.txt), which is the byte-for-byte source the queue item points at.++```text+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+```++### Why it is written that way++The post leads on the thing a reader can picture immediately: a 3D avatar rendered inside the chat window rather than linked from it. The free, read-only note removes the two objections (cost and permissions) that stop people trying an MCP server.++### Thread++2/ (140)++```text+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.+```++3/ (135)++```text+Hosts without MCP Apps support still get a rendered preview image and a one-tap live embed, so the tool degrades gracefully everywhere.+```++## 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+The three.ws avatar MCP server renders a live, rotatable 3D avatar inside the conversation, hands back a paste-anywhere embed iframe, or returns the avatar's metadata. All three tools are free, read-only, and annotated so hosts can run them without confirmation prompts. Hosts without MCP Apps support still get a rendered preview and a one-tap live embed. npmjs.com/package/@three-ws/avatar-mcp+```++## Ship it++```bash+npm run announce:media -- --only avatar-mcp-hero # capture the frame from the live route+npm run x:content -- review avatar-mcp # lint, live fact checks, AI editor+npm run x:content -- run --dry-run --id avatar-mcp # exactly what would be sent to X+```++The queue item is `avatar-mcp` 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/avatar-mcp.post.txt b/docs/announcements/avatar-mcp.post.txtnew file mode 100644index 000000000..354fb95d3--- /dev/null+++ b/docs/announcements/avatar-mcp.post.txt@@ -0,0 +1 @@+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-mcpdiff --git a/docs/announcements/knock.md b/docs/announcements/knock.mdnew file mode 100644index 000000000..6bdbcbe3f--- /dev/null+++ b/docs/announcements/knock.md@@ -0,0 +1,106 @@+# Announcement pack: Charge for your attention, delivered out loud++**Surface:** [`/knock`](https://three.ws/knock) · **Stage:** drafted · **Slot:** 2026-09-21 · **Announced externally:** never++Ranked 29 of 324 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.++---++## At a glance++| Field | Value |+|---|---|+| Pack id | `knock` |+| 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 | token / walkthrough |+| Audience | People who follow the agent economy and $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/knock |+| Tracked links | Telegram `https://three.ws/knock?utm_source=telegram&utm_medium=community&utm_campaign=announce-knock&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 /knock and use it |+| Media | `knock-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 (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+- **token (18)**: touches $THREE or the agent economy, the topic band that measured highest in our own archive+- **depth (13)**: documented in the tree, so there is enough to write a mechanism about and link proof for++It shipped on 2026-08-28 and has never been posted about.++The changelog has 1 entry about it, the most recent from 2026-08-28: "Knock: put a price on reaching you, and hear what gets through in person".++## The claim, and where it is checked++> 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++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 |+|---|---|+| says who is at the door and what they paid | live page shows "Your companion walks on wherever you are on the site and says who is at the door and what they paid." |+| A person pays with the wallet in their browser. An agent pays over x402 with no human in the loop. | live page shows "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. | `docs/knock.md` contains "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. | live page shows "Your price, your wallet, and everything that comes through it stays private to your account." |++## 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 |+|---|---|---|+| `knock-hero` | `/announce/img/knock-hero.webp` | Still frame of the live route. |++**Alt text, required on the post:**++> The Knock page showing a door with its price and greeting, the message box under it, and the open-doors directory listing handles and prices beside it.++## The post++Pattern: walkthrough. **178 weighted characters**, inside the 100 to 179 band that measured a 3.0x lift. Postable file: [`knock.post.txt`](./knock.post.txt), which is the byte-for-byte source the queue item points at.++```text+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+```++### Why it is written that way++The post leads on the moment the product is worth describing: a paid message arriving as a companion that walks on and speaks it, with the money already settled. It is the clearest paid-attention surface we run, and it works for an agent paying over x402 as well as a person clicking a wallet.++### Thread++2/ (98)++```text+A person pays with the wallet in their browser. An agent pays over x402 with no human in the loop.+```++3/ (171)++```text+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.+```++## 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+Knock puts a price on reaching you. Anyone, a person or an agent, can pay it to get exactly one message through. Your 3D companion walks on wherever you are on the site and says who is at the door and what they paid. A person pays with the wallet in their browser; an agent pays over x402 with no human in the loop, and the USDC settles straight to your wallet. three.ws/knock+```++## Ship it++```bash+npm run announce:media -- --only knock-hero # capture the frame from the live route+npm run x:content -- review knock # lint, live fact checks, AI editor+npm run x:content -- run --dry-run --id knock # exactly what would be sent to X+```++The queue item is `knock` 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/knock.post.txt b/docs/announcements/knock.post.txtnew file mode 100644index 000000000..9463d8786--- /dev/null+++ b/docs/announcements/knock.post.txt@@ -0,0 +1 @@+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/knockdiff --git a/docs/announcements/mocap-studio.md b/docs/announcements/mocap-studio.mdnew file mode 100644index 000000000..1b928d327--- /dev/null+++ b/docs/announcements/mocap-studio.md@@ -0,0 +1,106 @@+# 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.txtnew file mode 100644index 000000000..2e4ab0952--- /dev/null+++ b/docs/announcements/mocap-studio.post.txt@@ -0,0 +1 @@+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-studiodiff --git a/public/announce/img/avatar-mcp-hero.webp b/public/announce/img/avatar-mcp-hero.webpnew file mode 100644index 000000000..b63b187caBinary files /dev/null and b/public/announce/img/avatar-mcp-hero.webp differdiff --git a/public/announce/img/knock-hero.webp b/public/announce/img/knock-hero.webpnew file mode 100644index 000000000..115e90582Binary files /dev/null and b/public/announce/img/knock-hero.webp differdiff --git a/public/announce/media-manifest.json b/public/announce/media-manifest.jsonindex f32ffde4d..7e32d212c 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-17T19:36:30.512Z",+ "generatedAt": "2026-09-20T05:56:28.175Z","shots": {"activity-hero": {"id": "activity-hero",@@ -38,6 +38,40 @@"frames": 60,"fps": 12},+ "activity-mcp-hero": {+ "id": "activity-mcp-hero",+ "src": "/announce/img/activity-mcp-hero.webp",+ "alt": "A dark title card reading at three ws slash activity dash mcp, with the package description underneath and the install command in a monospace row at the bottom.",+ "caption": "Title card for @three-ws/activity-mcp, typeset from its README and package.json.",+ "route": "card:packages/activity-mcp",+ "viewport": "wide",+ "animated": false,+ "authenticated": false,+ "capturedAt": "2026-09-20T05:37:08.173Z",+ "capturedFrom": "https://three.ws",+ "commit": "9b0113316",+ "sha256": "3a1f060d02f858d24dea90d34c4cf3246706c2aab61a133c33ea164ff97e808f",+ "bytes": 73908,+ "width": 1800,+ "height": 1013+ },+ "avatar-mcp-hero": {+ "id": "avatar-mcp-hero",+ "src": "/announce/img/avatar-mcp-hero.webp",+ "alt": "A dark title card naming the three ws avatar MCP package, its one-line description underneath, and the npx install command in a monospace row at the bottom.",+ "caption": "Title card for @three-ws/avatar-mcp, typeset from its README and package.json.",+ "route": "card:packages/threews-avatar-mcp",+ "viewport": "wide",+ "animated": false,+ "authenticated": false,+ "capturedAt": "2026-09-20T05:56:28.058Z",+ "capturedFrom": "https://three.ws",+ "commit": "9b0113316",+ "sha256": "c35a98629fa3ac9ea231db1fa4da12aaac796e2f3e7734741a52327f807148c1",+ "bytes": 63016,+ "width": 1800,+ "height": 1013+ },"aws-builder-center-authorization-spine": {"id": "aws-builder-center-authorization-spine","src": "/announce/img/aws-builder-center-authorization-spine.webp",@@ -114,6 +148,23 @@"width": 1800,"height": 1013},+ "knock-hero": {+ "id": "knock-hero",+ "src": "/announce/img/knock-hero.webp",+ "alt": "The Knock page showing a door with its price and greeting, the message box under it, and the open-doors directory listing handles and prices beside it.",+ "caption": "Captured from the live /knock route for the knock announcement.",+ "route": "/knock",+ "viewport": "wide",+ "animated": false,+ "authenticated": false,+ "capturedAt": "2026-09-20T05:56:19.492Z",+ "capturedFrom": "https://three.ws",+ "commit": "9b0113316",+ "sha256": "adaa69bb3ab287c69a57132de362479b1274d6e2f679755a69c6806575c25e3a",+ "bytes": 62098,+ "width": 1800,+ "height": 1013+ },"materialize-hero": {"id": "materialize-hero","src": "/announce/img/materialize-hero.webp",diff --git a/scripts/announce-kit.mjs b/scripts/announce-kit.mjsindex e94ba4fb1..96a3cde7f 100644--- a/scripts/announce-kit.mjs+++ b/scripts/announce-kit.mjs@@ -91,7 +91,11 @@ try {throw error;}-const plan = loadOrBuildPlan(root, { start: option('start'), refresh: flag('refresh') });+// Without --include-gated the factory can only pack ungated surfaces, so it+// plans against that same reality: gated surfaces are held out of the calendar+// rather than dated into slots nobody can fill, which is what kept the packable+// backlog weeks behind the slots it could have had.+const plan = loadOrBuildPlan(root, { start: option('start'), refresh: flag('refresh'), holdGated: !includeGated });const wanted = (() => {const id = option('id');if (id) {diff --git a/scripts/announce-plan.mjs b/scripts/announce-plan.mjsindex 0a7552e36..fb3ca0307 100644--- a/scripts/announce-plan.mjs+++ b/scripts/announce-plan.mjs@@ -13,12 +13,15 @@// the order comes from the ledger's scores. Re-running with the same start date// produces the same plan, so a batch that is already drafted keeps its dates.// Surfaces already queued, already packed, or listed in-// data/announce-deferred.json are dropped: the plan covers what is left.+// data/announce-deferred.json are dropped: the plan covers what is left, and a+// surface listed in data/announce-priority.json takes the earliest slot its own+// tier owns rather than waiting for its score to come round.//// node scripts/announce-plan.mjs # the next 30 slots// node scripts/announce-plan.mjs --batch 1 # one week's batch in full// node scripts/announce-plan.mjs --write # plan.json + CALENDAR.md// node scripts/announce-plan.mjs --start 2026-10-01 # anchor the calendar+// node scripts/announce-plan.mjs --hold-gated # date only what the factory can pack alone// node scripts/announce-plan.mjs --json # machine-readable//// Wired as `npm run announce:plan`. It never drafts, never writes into the@@ -41,7 +44,7 @@ const start = option('--start', new Date(Date.now() + 86_400_000).toISOString().let plan;try {- plan = planFor(root, { start });+ plan = planFor(root, { start, holdGated: flag('--hold-gated') });} catch (error) {if (error instanceof MissingLedgerError) {console.error(error.message);@@ -72,6 +75,31 @@ function calendarMarkdown() {'```','',];+ const pins = plan.slots.filter((slot) => slot.pinned);+ if (pins.length) {+ lines.push(+ `## Asked for next (${pins.length})`,+ '',+ 'Listed in `data/announce-priority.json`, so each one enters the sequencer ahead of the backlog and takes the earliest slot its own tier owns. The pin buys position only: tier, lane rotation and shape rotation are unchanged, and nothing here skips review or approval.',+ '',+ '| Surface | Slot (UTC) | Why |',+ '|---|---|---|',+ );+ for (const slot of pins) lines.push(`| \`${slot.key}\` | ${slot.notBefore.slice(0, 16).replace('T', ' ')} | ${slot.pinned} |`);+ lines.push('');+ }+ if (plan.held?.length) {+ lines.push(+ `## Held for owner approval (${plan.held.length})`,+ '',+ 'Each of these captures its frame from a surface that renders live third-party market data, so committing that frame is the operating rules\' coin gate rather than a normal capture. They are out of the dated calendar on purpose: dating them would promise slots the factory cannot fill on its own and push everything it can produce weeks later. Clearing a frame moves that surface back into the next plan.',+ '',+ '| Surface | Tier | Lane | Score |',+ '|---|---|---|---|',+ );+ for (const row of plan.held) lines.push(`| \`${row.key}\` | T${row.tier} | ${row.lane} | ${row.score} |`);+ lines.push('');+ }if (plan.deferred?.length) {lines.push('## Deferred', '', '| Surface | Why |', '|---|---|');for (const row of plan.deferred) lines.push(`| \`${row.key}\` | ${row.why} |`);@@ -87,7 +115,7 @@ function calendarMarkdown() {lines.push('|---|---|---|---|---|---|---|');}lines.push(- `| ${slot.notBefore.slice(0, 16).replace('T', ' ')} | T${slot.tier}${slot.tier === slot.slotTier ? '' : ` (in the T${slot.slotTier} slot)`} | \`${slot.key}\` | ${slot.lane} | ${slot.pattern} | \`${slot.shot}\`${slot.motion ? ' (motion)' : ''} | ${slot.mediaGate || ''} |`,+ `| ${slot.notBefore.slice(0, 16).replace('T', ' ')} | T${slot.tier}${slot.tier === slot.slotTier ? '' : ` (in the T${slot.slotTier} slot)`} | \`${slot.key}\`${slot.pinned ? ' (pinned)' : ''} | ${slot.lane} | ${slot.pattern} | \`${slot.shot}\`${slot.motion ? ' (motion)' : ''} | ${slot.mediaGate || ''} |`,);}return `${lines.join('\n')}\n`;@@ -110,12 +138,12 @@ console.log(`${plan.totals.slots} unannounced surfaces, ${plan.perDay}/day at ${plan.times.join(', ')} UTC from ${plan.start}: ${plan.days} days, ${Math.ceil(plan.days / 7)} batches.`,);console.log(- `tiers ${Object.entries(plan.totals.byTier).map(([tier, count]) => `T${tier}:${count}`).join(' ')} lanes ${Object.entries(plan.totals.byLane).map(([lane, count]) => `${lane}:${count}`).join(' ')} patterns ${Object.entries(plan.totals.byPattern).map(([pattern, count]) => `${pattern}:${count}`).join(' ')} owner-gated media ${plan.totals.gated} deferred ${plan.deferred?.length || 0}\n`,+ `tiers ${Object.entries(plan.totals.byTier).map(([tier, count]) => `T${tier}:${count}`).join(' ')} lanes ${Object.entries(plan.totals.byLane).map(([lane, count]) => `${lane}:${count}`).join(' ')} patterns ${Object.entries(plan.totals.byPattern).map(([pattern, count]) => `${pattern}:${count}`).join(' ')} owner-gated media ${plan.totals.gated}${plan.totals.held ? ` (${plan.totals.held} held out of the calendar)` : ''} pinned ${plan.totals.pinned || 0} deferred ${plan.deferred?.length || 0}\n`,);console.log(`${'when'.padEnd(17)} ${'tier'.padEnd(5)} ${'surface'.padEnd(32)} ${'lane'.padEnd(10)} ${'pattern'.padEnd(11)} gate`);for (const slot of rows) {console.log(- `${slot.notBefore.slice(0, 16).replace('T', ' ').padEnd(17)} ${`T${slot.tier}`.padEnd(5)} ${slot.key.padEnd(32)} ${slot.lane.padEnd(10)} ${slot.pattern.padEnd(11)} ${slot.mediaGate || ''}`,+ `${slot.notBefore.slice(0, 16).replace('T', ' ').padEnd(17)} ${`T${slot.tier}`.padEnd(5)} ${slot.key.padEnd(32)} ${slot.lane.padEnd(10)} ${slot.pattern.padEnd(11)} ${slot.mediaGate || (slot.pinned ? 'pinned' : '')}`,);}if (!only) console.log(`\n... ${Math.max(0, plan.totals.slots - rows.length)} more. Full calendar: npm run announce:plan -- --write`);diff --git a/scripts/announce-rank.mjs b/scripts/announce-rank.mjsindex dd69e5e0d..db71ff136 100644--- a/scripts/announce-rank.mjs+++ b/scripts/announce-rank.mjs@@ -78,13 +78,23 @@ const clean = (text) => String(text || '').replace(DASHES, ', ').trim();// would drown the real features. 'legal' is boilerplate.const PRODUCT_SECTIONS = new Set(['main', 'build', 'labs', 'crypto', 'agent-tools', 'account', 'machine']);+// A product surface does not always live in a product section. Five pages+// filed under 'learn' carry `showcase: true`, and every one of them is a+// product rather than a document: /awesome, /3d, /crypto, /crypto-api and+// /docs/world. Skipping their section wholesale is what kept them out of this+// ledger, and therefore out of the calendar, the factory and the queue, since+// the ledger was first built. `showcase` is already the flag pages.json uses+// for "put this in front of someone", so it is the admission rule here: a+// content page carrying it is inventory, a content page without it is content.+const inInventory = (section, page) => PRODUCT_SECTIONS.has(section.id) || page.showcase === true;+function pageInventory() {const { sections } = JSON.parse(readFileSync(join(root, 'data/pages.json'), 'utf8'));const out = [];for (const section of sections) {- if (!PRODUCT_SECTIONS.has(section.id)) continue;for (const page of section.pages) {if (page.indexable === false) continue;+ if (!inInventory(section, page)) continue;out.push({key: page.path,kind: 'page',diff --git a/tests/announce-factory.test.js b/tests/announce-factory.test.jsindex fcacecff0..3f7756a97 100644--- a/tests/announce-factory.test.js+++ b/tests/announce-factory.test.js@@ -85,6 +85,34 @@ describe('plan', () => {expect(plan.slots.map((slot) => [slot.tier, slot.slotTier])).toEqual([[1, 3], [1, 1]]);});+ it('holds an owner-gated surface out of the calendar instead of dating a slot nobody can fill', () => {+ const args = {+ cadence: { ...CADENCE, slots: [{ tier: 3, at: '04:00' }, { tier: 2, at: '12:00' }, { tier: 1, at: '20:00' }] },+ quality: QUALITY,+ start: '2026-10-01',+ cryptoPaths: new Set(['/vaults']),+ };+ const entries = [+ entry('/vaults', { section: 'crypto' }),+ entry('/alpha-copilot', { partner: '@pumpfun' }),+ entry('/mocap-studio', { section: 'labs' }),+ entry('@three-ws/alerts-mcp', { kind: 'package', section: 'package' }),+ ];+ const dated = buildPlan(entries, args);+ expect(dated.slots.find((slot) => slot.key === '/vaults').notBefore).toBe('2026-10-01T20:00:00Z');+ expect(dated.held).toEqual([]);+ expect(dated.holdGated).toBe(false);++ const held = buildPlan(entries, { ...args, holdGated: true });+ expect(held.slots.map((slot) => slot.key)).not.toContain('/vaults');+ expect(held.held.map((row) => row.key)).toEqual(['/vaults']);+ expect(held.totals.held).toBe(1);+ expect(held.holdGated).toBe(true);+ // The flagship slot the gated surface was occupying now goes to the+ // flagship the factory can actually pack.+ expect(held.slots.find((slot) => slot.slotTier === 1).key).toBe('/alpha-copilot');+ });+it('drops a slot whose jitter window would run into quiet hours', () => {expect(slotTimes({ ...CADENCE, quietHoursUtc: ['00:00', '12:00'], dailyCap: 3, minimumMinutesApart: 600 })).toEqual(['13:00']);});