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(x-content): hold flagship posts for weekdays, when the $THREE pool trades a third more and a post moves twice the dollars

nirholas9c7bab3adb15
diff --git a/api/_lib/x-content/schedule.js b/api/_lib/x-content/schedule.js
index b4b17e1da..7d8045d44 100644
--- a/api/_lib/x-content/schedule.js
+++ b/api/_lib/x-content/schedule.js
@@ -89,6 +89,14 @@ const atMinutes = (at) => {
return h * 60 + (m || 0);
};
+// Saturday and Sunday, by the UTC day a slot belongs to. The $THREE pool trades
+// about two thirds of its weekday volume on a weekend, and the hour after a post
+// moves less than half the dollars, though a post is just as likely to get a
+// reaction. A flagship post is worth the most on a weekday, so with
+// `flagshipWeekdaysOnly` the T1 slot does not open on a weekend and T1 posts are
+// not spent in the lower slots either: they wait for Monday.
+export const isWeekend = (timestamp) => [0, 6].includes(new Date(timestamp).getUTCDay());
+
// Every slot opening from yesterday through tomorrow, in time order, so the
// slot spanning midnight (22:00 until the next morning) is found too.
export function slotOpenings(now, cadence = DEFAULT_CADENCE, seed = null) {
@@ -99,6 +107,7 @@ export function slotOpenings(now, cadence = DEFAULT_CADENCE, seed = null) {
for (const offset of [-1, 0, 1]) {
const day = today + offset * DAY;
slots.forEach((slot, index) => {
+ if (cadence.flagshipWeekdaysOnly && Number(slot.tier) === 1 && isWeekend(day)) return;
const key = `${dayKey(day)}#${index}`;
openings.push({ key, tier: Number(slot.tier), opensAt: day + (atMinutes(slot.at) + jitterMinutes(`slot:${key}`, window, seed)) * MINUTE });
});
@@ -177,7 +186,9 @@ export function pickDue({
const lastDay = published.filter((row) => now - Date.parse(row.publishedAt) < DAY).length;
if (lastDay >= cadence.dailyCap) return { item: null, reason: `daily cap of ${cadence.dailyCap} reached` };
- const ready = unpublished.filter((item) => !exclude.has(item.id) && Date.parse(item.notBefore) <= now);
+ // On a weekend a flagship post waits for Monday instead of filling a lower slot.
+ const holdFlagship = Boolean(cadence.flagshipWeekdaysOnly) && isWeekend(slot.opensAt);
+ const ready = unpublished.filter((item) => !exclude.has(item.id) && Date.parse(item.notBefore) <= now && !(holdFlagship && tierOf(item) === 1));
const context = { lifts, published, quality, reviews, now };
const readyByTier = new Map(TIERS.map((tier) => [tier, ready.filter((item) => tierOf(item) === tier).length]));
for (const tier of tierOrder(slot.tier, readyByTier)) {
diff --git a/data/x-content/queue.json b/data/x-content/queue.json
index cac51dd4e..733bf95d4 100644
--- a/data/x-content/queue.json
+++ b/data/x-content/queue.json
@@ -5,6 +5,7 @@
"windowMinutes": 30,
"minimumMinutesApart": 180,
"dailyCap": 3,
+ "flagshipWeekdaysOnly": true,
"quietHoursUtc": [
"02:00",
"07:00"
diff --git a/docs/x-content-pipeline.md b/docs/x-content-pipeline.md
index 35e2d9dc7..d7028039c 100644
--- a/docs/x-content-pipeline.md
+++ b/docs/x-content-pipeline.md
@@ -109,7 +109,7 @@ Cadence lives at the top of the file: `slots` (each `{ tier, at }` in UTC), `win
## How the next post is chosen
-**When:** three slots a day, one per tier, all inside 12:00 to 20:00 UTC (8 AM to 4 PM New York): T3 at 12:30, T1 at 16:00 (noon New York), T2 at 19:30. The volume study measured every original post against 1-minute candles of the $THREE pool: a post inside that window was followed by a volume response about 1.7 times as often as one outside it, and it is also when the pool trades most. Each slot opens at a minute only the production seed can reproduce (up to `windowMinutes` late), and stays open for three hours (`slotOpenMinutes`), so a missed run or a deploy still posts, but no slot is ever spent twice. Slots are at least `minimumMinutesApart` apart even at their latest opening, so an earlier post never blocks a later slot. Quiet hours are 02:00 to 07:00 UTC.
+**When:** three slots a day, one per tier, all inside 12:00 to 20:00 UTC (8 AM to 4 PM New York): T3 at 12:30, T1 at 16:00 (noon New York), T2 at 19:30. The volume study measured every original post against 1-minute candles of the $THREE pool: a post inside that window was followed by a volume response about 1.7 times as often as one outside it, and it is also when the pool trades most. Each slot opens at a minute only the production seed can reproduce (up to `windowMinutes` late), and stays open for three hours (`slotOpenMinutes`), so a missed run or a deploy still posts, but no slot is ever spent twice. Slots are at least `minimumMinutesApart` apart even at their latest opening, so an earlier post never blocks a later slot. Quiet hours are 02:00 to 07:00 UTC. With `flagshipWeekdaysOnly` (on), the T1 slot does not open on Saturday or Sunday and T1 posts do not fill the lower slots either: the pool trades about two thirds of its weekday volume on a weekend and the hour after a post moves less than half the dollars, so a flagship post waits for Monday.
**What:** the slot's own tier first, highest priority first. Priority leads with **volume**, not engagement: [`data/x-content/volume-model.json`](../data/x-content/volume-model.json) is a logistic model fitted on every original post moment, and it gives each draft a chance of being followed by a volume response on the pool (the first hour after the post running at least twice the hour before). Pool volume is what pays creator rewards, so it outranks attention. The model rewards what the data rewarded: announcing something shipped, partner or recognition language, naming a tier-1 company, more than 180 characters, and a thread rather than a single post. `npm run x:content -- plan` prints each post's chance and the attributes found on it. If the model file is missing, the older engagement estimate takes over. Refit and re-export it from the study repo with `node analyze/volume-chart.mjs --asset three --export-model <this repo>/data/x-content/volume-model.json --export-exclude cryptoNative`. An empty tier falls to the next tier down, so the best available post always gets the best time. A higher tier only fills a lower slot when it has more than one post ready, so the last flagship post is kept for prime time. When nothing is ready, nothing posts: three a day is a ceiling, not a quota.
diff --git a/tests/x-content.test.js b/tests/x-content.test.js
index 443bc2ca5..21d697261 100644
--- a/tests/x-content.test.js
+++ b/tests/x-content.test.js
@@ -196,6 +196,8 @@ describe('schedule', () => {
});
});
+const tierOfPick = (pick) => Number(pick.item.tier);
+
describe('priority', () => {
const lifts = loadLifts(root);
const post = (text, over = {}) => ({ id: 'x', kind: 'post', lane: 'l', pattern: 'p', notBefore: '2026-09-17T00:00:00Z', posts: [{ text, media: [{ path: 'public/x.webp' }] }], ...over });
@@ -254,6 +256,27 @@ describe('priority', () => {
}
});
+ it('keeps flagship posts off the weekend, when the pool trades a third less', () => {
+ const cadence = { ...loadQueue(root).cadence, quietHoursUtc: null };
+ expect(cadence.flagshipWeekdaysOnly).toBe(true);
+ const saturday = Date.parse('2026-09-19T16:20:00Z');
+ const monday = Date.parse('2026-09-21T16:45:00Z');
+ const tiersOn = (day) => slotOpenings(day, cadence, 'seed').filter((slot) => slot.key.startsWith(new Date(day).toISOString().slice(0, 10))).map((slot) => slot.tier);
+ expect(tiersOn(saturday)).toEqual([3, 2]);
+ expect(tiersOn(monday)).toEqual([3, 1, 2]);
+
+ // Two flagship posts ready: a surplus that would normally fill a lower slot.
+ const flagship = (id) => ({ id, status: 'approved', kind: 'post', tier: 1, lane: id, pattern: id, notBefore: '2026-09-01T00:00:00Z', posts: [{ text: `${id} is now live: three.ws/x`, media: [] }] });
+ const feature = { id: 'feature', status: 'approved', kind: 'post', tier: 2, lane: 'f', pattern: 'f', notBefore: '2026-09-01T00:00:00Z', posts: [{ text: 'A feature: three.ws/x', media: [] }] };
+ const items = [flagship('one'), flagship('two'), feature];
+ const pick = (now) => pickDue({ items, state: { published: [] }, now, cadence, quality: {}, seed: 'seed', lifts: null, reviews: new Map(), exclude: new Set() });
+ const weekendSlot = slotOpenings(saturday, cadence, 'seed').find((slot) => slot.key.startsWith('2026-09-19') && slot.tier === 2);
+ const weekendPick = pick(weekendSlot.opensAt + 60_000);
+ expect(weekendPick.item.id).toBe('feature');
+ const mondaySlot = slotOpenings(monday, cadence, 'seed').find((slot) => slot.key.startsWith('2026-09-21') && slot.tier === 1);
+ expect(tierOfPick(pick(mondaySlot.opensAt + 60_000))).toBe(1);
+ });
+
it('adds owner boost, timeliness, waiting, and review; penalizes repetition; drops expired posts', () => {
const now = Date.parse('2026-09-20T00:00:00Z');
const base = scoreItem(post('A plain update about avatars: three.ws/x'), { lifts, now });