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
docs(x-content): document the every-other-day Article slot and show it in the plan output
nirholasf760e8def21b
diff --git a/docs/x-article-author-brief.md b/docs/x-article-author-brief.mdindex 7d9689dd1..4a8d90224 100644--- a/docs/x-article-author-brief.md+++ b/docs/x-article-author-brief.md@@ -2,8 +2,9 @@An author is given one or two topics and this page. An X Article is the long form of @trythreews:a full piece with a title, a cover, headings and images, published natively on X and quoted by a-short post. Articles fill the T1 (flagship) slot, one a day at most, and are released by the owner-after they pass review. Everything a post needs (the voice contract, claims with evidence, live+short post. Articles have their own slot, one every second evening at 22:30 UTC, and are released+by the queue's policy once they pass review on the editor's own verdict, so an article must be+right without anyone reading it before it goes out. It must tag no one anywhere in its body. Everything a post needs (the voice contract, claims with evidence, liveverification) applies to an article too, across every sentence of its body.Several authors work at once, each in their own files, and an integrator adopts and reviews whatdiff --git a/docs/x-content-pipeline.md b/docs/x-content-pipeline.mdindex 1987af5f0..aee522d66 100644--- a/docs/x-content-pipeline.md+++ b/docs/x-content-pipeline.md@@ -34,7 +34,7 @@ pipeline, enforced before anything is sent:| Silent autoplay | `prepare-video` burns captions into the clip, because most of the feed watches muted. || Hype copy | [api/_lib/x-content/quality.js](../api/_lib/x-content/quality.js) rejects launch openers ("Introducing", "We're excited"), hype vocabulary, hashtags, emoji, stacked exclamation marks, all-caps shouting, and en or em dashes. || Repeats | A head that reads too much like another queued item, or like anything @trythreews already posted (the scraped archive in `data/archives/` plus everything this pipeline published), is rejected. |-| Clockwork timing | Three slots a day inside US hours, every day, each opening at a jittered minute, with a minimum gap and a daily cap. |+| Clockwork timing | Three slots a day inside US hours, every day, plus an X Article every second evening, each opening at a jittered minute, with a minimum gap and a daily cap. || A schedule anyone can read off the repository | The slot jitter is an HMAC under `X_CONTENT_SCHEDULE_SEED` (production only), and which post fills a slot is decided at the moment it opens. Unset, the jitter falls back to a public hash, and `plan` says its minutes are placeholders. || A link that cannot be checked | Every link is resolved before a post can be approved, and again seconds before it is sent. npm answers 403 to any non-browser client, so a package page is resolved against `registry.npmjs.org`, which is the authoritative record of whether that package exists and answers any client. || A broken post stalling the feed | A post that cannot go out (a link is down, a feature probe fails, X rejects the content) is held with the reason and a backoff, and the slot goes to the next-best post in the same run. |@@ -125,7 +125,7 @@ X Articles require the posting account to be on X Premium.- `textFrom` is optional. When set, `check` fails if the inline text differs from that announcement-pack file, so the copy that was reviewed is the copy that ships.- An `article` item carries `"article": { "title", "body", "cover": { "path" } }`, and its optional `posts` quote the published Article. The body is copy like any post: its prose (headings, paragraphs, lists and quotes; code blocks and tables are literal samples and exempt) goes through the same language lint and claims ledger, so a number in the fourth section needs evidence like one in the title, its links are resolved at review, and its words are spell-checked. Replacing an inline image makes the review stale, the same as editing the Markdown.-Cadence lives at the top of the file: `slots` (each `{ tier, at }` in UTC), `windowMinutes` (how far a slot's opening may be jittered), `minimumMinutesApart`, `dailyCap`, and `quietHoursUtc` (a `["HH:MM", "HH:MM"]` pair, which may wrap midnight). `quality` sets the similarity limits, the maximum same-lane and same-pattern runs, and `maximumLength`: the longest a post may be, in weighted characters. @trythreews is on X Premium, so the queue sets it above the standard 280; a value under 280 is ignored. `approval` is the policy described below.+Cadence lives at the top of the file: `slots` (each `{ tier, at }` in UTC, or a kind slot `{ kind, at, everyDays, from }`, below), `windowMinutes` (how far a slot's opening may be jittered), `minimumMinutesApart`, `dailyCap`, and `quietHoursUtc` (a `["HH:MM", "HH:MM"]` pair, which may wrap midnight). `quality` sets the similarity limits, the maximum same-lane and same-pattern runs, and `maximumLength`: the longest a post may be, in weighted characters. @trythreews is on X Premium, so the queue sets it above the standard 280; a value under 280 is ignored. `approval` is the policy described below.**What the cap counts:** `dailyCap` limits scheduled posts in the last 24 hours, and a scheduled post is one the scheduler placed in a slot. A post an operator sends by hand (`run --id`) carries no slot and does not count toward it, because counting those let four owner-requested posts on one afternoon hold every slot shut the following morning. Hand-sent posts do still count toward `minimumMinutesApart`, which measures from the last post of any kind, so the schedule never fires minutes after a manual post. To fill an open slot by hand and keep the schedule's bookkeeping right, run a scheduler tick (`npm run x:content -- run`, no `--id`): it takes the same lock as the cron, picks the post the cron would, and records the slot so the cron sees it as used.@@ -133,6 +133,15 @@ Cadence lives at the top of the file: `slots` (each `{ tier, at }` in UTC), `win**When:** three slots a day, one per tier, every day of the week, all inside 12:00 to 20:00 UTC: T2 at 12:00, T1 at 15:30, T3 at 19:00 (8:00, 11:30 and 15:00 in New York). The volume study measured every original post against the $THREE pool's candles and found a post in that window was followed by a volume response about 1.7 times as often as one outside it, one of the two strongest effects in the model. The owner's 2026-09-20 cadence spread the three slots eight hours apart (04:00, 12:00, 20:00), which put two of them outside the window; on 2026-10-01 the owner made pool volume the goal, so all three moved inside it, three and a half hours apart. 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. There are no quiet hours: the fixed slots already say when the account posts. `flagshipWeekdaysOnly` would withhold the T1 slot on Saturday and Sunday and keep T1 posts out of the lower slots too; the queue no longer sets it, and it is the one lever that would return the account to weekdays-only flagships.+**One X Article every two days** (owner, 2026-10-08) has its own slot: `{ "kind": "article", "at": "22:30", "everyDays": 2, "from": "2026-10-08" }`, which opens at 22:30 UTC (18:30 in New York) on 2026-10-08 and every second day after it. 22:30 is the earliest time that is still `minimumMinutesApart` after the latest the T3 slot can open, so an Article never blocks a daily post or waits on one. A kind slot works like this:++- It takes only items of its kind, ranked across every tier at once. The daily slots never take an item whose kind owns a slot, so an Article is never spent on a daily slot and the Article slot never spends a post.+- It sits outside `dailyCap`, and the Article it sends (recorded with `slotKind` in the ledger) is not counted toward the cap either. Its own cadence limits it, and a cap shared with the three daily posts would let an Article evening hold the next morning's slot shut.+- It obeys `minimumMinutesApart`, the veto-yield rule below, the missed-slot alerts, and the stock alert. Stock counts approved Articles as `everyDays` days each, so one Article in stock is two days and raises the low-stock alert.+- With no Article ready, the slot stays empty and alerts. It does not fall back to a post, because that would make a fourth post that day.++Drop the slot from `slots` and Articles go back to being ordinary tier 1 items.+**Three a day is a quota** (owner, 2026-09-30), so a slot is never left empty while an approved postcould fill it. When the usual order finds nothing, the slot takes, in turn:@@ -247,6 +256,15 @@ says which one stopped it:| It tags no one | A tag puts a partner's name next to ours. A person decides that. || The review passed on the editor's own verdict | An `editorOverride` is a person's judgment, so it needs a person. |+X Articles have their own switch, `"articles": true` (set since 2026-10-08, so the Article slot+fills without the owner). An Article is long-form writing about how something works and rarely+has a reel to film, so the review stands in for the reel: it re-ran every probe the Article+declares against production, resolved every link, and held every sentence of the body to the+claims ledger. With the switch on, an Article is not held back by its tier or by having no+scenario; it must still tag no one (title, quote posts, and the whole body are checked), pass on+the editor's own verdict, carry a current proof if it does have a scenario, and wait out+`vetoHours`. The switch does nothing for a post.+`npm run x:content -- advance --ship` is the whole line in one command: it films what needsfilming, reviews it, releases what the policy allows, and publishes every approved post as abundle.diff --git a/scripts/x-content.mjs b/scripts/x-content.mjsindex 9bed44228..cdf2c220e 100644--- a/scripts/x-content.mjs+++ b/scripts/x-content.mjs@@ -33,9 +33,9 @@ import { spawnSync } from 'node:child_process';import { fileURLToPath } from 'node:url';import { QUEUE_PATH, loadQueue, validateItem, validateQueue } from '../api/_lib/x-content/queue.js';-import { DEFAULT_CADENCE, TIERS, currentSlot, pickDue, slotOpenings, tierOf } from '../api/_lib/x-content/schedule.js';+import { DEFAULT_CADENCE, TIERS, currentSlot, pickDue, reservedKinds, slotLabel, slotOpenings, tierOf } from '../api/_lib/x-content/schedule.js';import { loadLifts, rankItems } from '../api/_lib/x-content/priority.js';-import { activeHolds, inventory } from '../api/_lib/x-content/runner.js';+import { activeHolds, inventory, stockLabel } from '../api/_lib/x-content/runner.js';import { runTick } from '../api/_lib/x-content/runner.js';import { dbStore, memoryStore } from '../api/_lib/x-content/state.js';import { MAX_SPEED, VIDEO_LIMITS, mediaType, parseFfmpegProbe, videoFilterChain } from '../api/_lib/x-content/media.js';@@ -119,22 +119,28 @@ async function plan() {const holds = activeHolds(state, queue.items, root, now);console.log(`ledger: ${s.label}${seed ? '' : ' (slot minutes are placeholders here: X_CONTENT_SCHEDULE_SEED only exists in production)'}\n`);- console.log('Slots (T1 flagship, T2 features, T3 proof of work):');+ console.log('Slots (T1 flagship, T2 features, T3 proof of work, article every few days):');const openings = slotOpenings(now, cadence, seed).filter((slot) => slot.opensAt > now - DAY && slot.opensAt < now + DAY);const openKey = currentSlot(now, cadence, seed).slot?.key;for (const slot of openings) {const used = [...published.values()].find((row) => row.slot === slot.key);const state_ = used ? `used by ${used.id}` : slot.key === openKey ? 'OPEN NOW' : slot.opensAt <= now ? 'passed' : 'upcoming';- console.log(` ${new Date(slot.opensAt).toISOString().slice(0, 16)}Z T${slot.tier} ${state_}`);+ console.log(` ${new Date(slot.opensAt).toISOString().slice(0, 16)}Z ${slotLabel(slot)} ${state_}`);}console.log('\nStock (approved, ready, not held), one slot per tier per day:');- for (const row of inventory(queue.items.filter((item) => !problems[item.id].length), state, root, now)) console.log(` T${row.tier}: ${row.days} day(s)${row.low ? ' LOW' : ''}`);-- for (const tier of TIERS) {- const waiting = queue.items.filter((item) => tierOf(item) === tier && !published.has(item.id));+ for (const row of inventory(queue.items.filter((item) => !problems[item.id].length), state, root, now, cadence)) console.log(` ${stockLabel(row)}${row.low ? ' LOW' : ''}`);++ // Items a kind slot owns are ranked for that slot, not for their tier.+ const reserved = reservedKinds(cadence);+ const groups = [+ ...TIERS.map((tier) => ({ label: `T${tier}`, match: (item) => !reserved.has(item.kind) && tierOf(item) === tier })),+ ...[...reserved].map((kind) => ({ label: `${kind} slot`, match: (item) => item.kind === kind })),+ ];+ for (const group of groups) {+ const waiting = queue.items.filter((item) => group.match(item) && !published.has(item.id));if (!waiting.length) continue;- console.log(`\nT${tier} by priority:`);+ console.log(`\n${group.label} by priority:`);const ranked = rankItems(waiting, { lifts, published: state.published || [], quality: queue.quality, reviews, now });for (const row of ranked) {const item = row.item;@@ -160,7 +166,7 @@ async function plan() {const publishable = queue.items.filter((item) => !problems[item.id].length);const next = pickDue({ items: publishable, state, now, cadence: queue.cadence, quality: queue.quality, seed, lifts, reviews, exclude: holds });- console.log(`\nnow: ${next.item ? `${next.item.id} would fill slot ${next.slot.key} (T${next.tier}${next.filledDown ? `, filling a T${next.slot.tier} slot` : ''}, score ${next.score})` : next.reason}`);+ console.log(`\nnow: ${next.item ? `${next.item.id} would fill slot ${next.slot.key} (${next.slot.kind ? `${next.slot.kind}, T${next.tier}` : `T${next.tier}`}${next.filledDown ? `, filling a T${next.slot.tier} slot` : ''}, score ${next.score})` : next.reason}`);}async function run() {@@ -532,7 +538,7 @@ async function advance() {const quality = queue.quality || {};const items = queue.items.filter((item) => (id ? item.id === id : ['draft', 'review'].includes(item.status)));if (!items.length) fail(id ? `${id} is not in the queue` : 'nothing to advance: no draft or review items');- console.log(`approval: ${policy.mode === 'auto' ? `by policy for tier ${policy.tiers.join(', ')}, embargoed ${policy.vetoHours} h` : 'by the owner'}`);+ console.log(`approval: ${policy.mode === 'auto' ? `by policy for tier ${policy.tiers.join(', ')}${policy.articles ? ' and for articles' : ''}, embargoed ${policy.vetoHours} h` : 'by the owner'}`);if (!dryRun) hydrateReviewEnv();const rows = [];