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(release): publish the monthly changelog as a GitHub Release so watchers see what shipped
nirholas10429958a216
diff --git a/docs/changelog.md b/docs/changelog.mdindex 5d53923c7..1eb55f561 100644--- a/docs/changelog.md+++ b/docs/changelog.md@@ -34,6 +34,25 @@ and both are served with `cache-control: public, max-age=600`.`three.ws/changelog` itself paints from the small feed and fetches the full oneonly when a reader filters or asks for older updates.+### GitHub Releases++Once a month the changelog also goes out as a [GitHub Release](https://github.com/nirholas/three.ws/releases),+which reaches every watcher and stargazer of the repository through GitHub's own feed.+`scripts/github-release.mjs` builds the notes from `data/changelog.json` as it stood at the+commit production runs (read `GET /api/version` for it), keeps only entries that pass the X+lane's public filter (`data/changelog-x-filter.json`), and drops any entry naming a `$TICKER`+other than `$THREE`:++```bash+node scripts/github-release.mjs --from 2026-08-29 --to 2026-09-30 \+ --tag v1.5.2 --target 774ca7287 --title "1.5.2, September 2026" # preview+# add --apply to publish; --exclude-terms <file> takes a JSON array of project+# names to leave out, kept outside the repo so no committed file names them+```++The first one, [v1.5.2](https://github.com/nirholas/three.ws/releases/tag/v1.5.2), covers+2026-08-29 to 2026-09-30. Start the next window the day after the previous one ended.+---## Versioning Policydiff --git a/scripts/github-release.mjs b/scripts/github-release.mjsnew file mode 100644index 000000000..3d9ae73db--- /dev/null+++ b/scripts/github-release.mjs@@ -0,0 +1,141 @@+#!/usr/bin/env node+// Publish a GitHub Release for nirholas/three.ws built from the public changelog.+//+// A release reaches every watcher and stargazer through GitHub's own feed, so+// it is the cheapest distribution channel the repo has. The notes are the+// changelog entries dated inside the window, read from data/changelog.json AT+// THE TARGET COMMIT (the one production runs), and passed through the same+// public-feed filter the X lane uses (data/changelog-x-filter.json): no wallet+// or payment internals, no security work, no gated project names, no bare fixes.+//+// node scripts/github-release.mjs --from 2026-08-29 --to 2026-09-30 \+// --tag v1.5.2 --target 774ca7287 --title "September 2026" # preview+// ... --apply # publish+//+// Entries naming a $TICKER other than $THREE are always left out. To leave out+// projects written by name, pass --exclude-terms <file> (JSON array of names)+// kept outside the repo: naming them in a committed file would itself put the+// commit under the other-coin gate, which is why data/announce-gate-terms.json+// stays empty unless the owner fills it.+//+// Auth for --apply: GITHUB_TOKEN, else the gh CLI's stored token+// (~/.config/gh/hosts.yml). The token needs the `repo` scope.++import { execFileSync } from 'node:child_process';+import { readFileSync, existsSync } from 'node:fs';+import { homedir } from 'node:os';+import { join } from 'node:path';+import { loadXFilter, xFilterReason } from '../api/_lib/changelog-push.js';++const REPO = 'nirholas/three.ws';+const SITE = 'https://three.ws';+const SECTIONS = [+ ['feature', 'New'],+ ['improvement', 'Improved'],+ ['sdk', 'SDKs and packages'],+];++function parseArgs(argv) {+ const args = { apply: false };+ for (let i = 0; i < argv.length; i++) {+ const a = argv[i];+ if (a === '--apply') args.apply = true;+ else if (a.startsWith('--')) args[a.slice(2)] = argv[++i];+ }+ for (const k of ['from', 'to', 'tag', 'target', 'title']) {+ if (!args[k]) throw new Error(`missing --${k}`);+ }+ return args;+}++function feedAt(commit) {+ const raw = execFileSync('git', ['show', `${commit}:data/changelog.json`], { encoding: 'utf8', maxBuffer: 256 * 1024 * 1024 });+ const feed = JSON.parse(raw);+ return Array.isArray(feed) ? feed : feed.entries;+}++function firstSentence(text) {+ const m = text.match(/^.*?[.!?](\s|$)/);+ return (m ? m[0] : text).trim();+}++function entryLine(e) {+ const link = e.link ? ` [Open](${e.link.startsWith('http') ? e.link : SITE + e.link})` : '';+ return `- **${e.title}.** ${firstSentence(e.summary)}${link}`;+}++function otherProjectMatcher(termsFile) {+ const escape = (t) => t.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');+ const terms = termsFile ? JSON.parse(readFileSync(termsFile, 'utf8')) : [];+ const byName = terms.length ? new RegExp(`\\b(${terms.map(escape).join('|')})\\b`, 'i') : null;+ const ticker = /\$(?!THREE\b)[A-Z][A-Z0-9]{1,9}\b/;+ return (e) => {+ const text = `${e.title}\n${e.summary}`;+ return ticker.test(text) || (byName ? byName.test(text) : false);+ };+}++function buildNotes(entries, { from, to, title, 'exclude-terms': termsFile }) {+ const filter = loadXFilter();+ const namesOtherProject = otherProjectMatcher(termsFile);+ const inWindow = entries.filter((e) => e.date >= from && e.date <= to);+ const kept = inWindow.filter((e) => !xFilterReason(e, filter) && !namesOtherProject(e));+ const seen = new Set();+ const parts = [+ `Everything three.ws shipped from ${from} to ${to}, taken from the public changelog. ${kept.length} user-facing changes.`,+ '',+ `Try it at [three.ws](${SITE}), read the [docs](${SITE}/docs), follow the [full changelog](${SITE}/changelog) ([RSS](${SITE}/changelog.xml)), or connect your assistant to the 3D Studio MCP server at [three.ws/connect](${SITE}/connect).`,+ ];+ for (const [tag, heading] of SECTIONS) {+ const rows = kept.filter((e) => (e.tags || []).includes(tag) && !seen.has(e)).sort((a, b) => b.date.localeCompare(a.date));+ if (!rows.length) continue;+ rows.forEach((e) => seen.add(e));+ parts.push('', `## ${heading}`, '', ...rows.map(entryLine));+ }+ parts.push('', '---', '', `Apache-2.0. Issues and discussions are open: [contribute](https://github.com/${REPO}/blob/main/CONTRIBUTING.md).`);+ return { body: parts.join('\n'), kept: kept.length, total: inWindow.length, name: `three.ws ${title}` };+}++function githubToken() {+ if (process.env.GITHUB_TOKEN) return process.env.GITHUB_TOKEN;+ const hosts = join(homedir(), '.config', 'gh', 'hosts.yml');+ if (existsSync(hosts)) {+ const m = readFileSync(hosts, 'utf8').match(/oauth_token:\s*(\S+)/);+ if (m) return m[1];+ }+ throw new Error('no GitHub token: set GITHUB_TOKEN or run `gh auth login`');+}++async function github(path, init = {}) {+ const res = await fetch(`https://api.github.com${path}`, {+ ...init,+ headers: { Authorization: `token ${githubToken()}`, Accept: 'application/vnd.github+json', 'Content-Type': 'application/json' },+ });+ const json = await res.json().catch(() => ({}));+ if (!res.ok) throw new Error(`GitHub ${init.method || 'GET'} ${path} -> ${res.status}: ${json.message || ''}`);+ return json;+}++async function main() {+ const args = parseArgs(process.argv.slice(2));+ const sha = execFileSync('git', ['rev-parse', args.target], { encoding: 'utf8' }).trim();+ const notes = buildNotes(feedAt(sha), args);+ if (notes.body.length > 120_000) throw new Error(`release body is ${notes.body.length} chars, over GitHub's limit`);+ console.log(`${notes.name} (${args.tag} at ${sha.slice(0, 9)}): ${notes.kept} of ${notes.total} entries pass the public filter, ${notes.body.length} chars\n`);+ if (!args.apply) {+ console.log(notes.body);+ console.log('\nPreview only. Re-run with --apply to publish.');+ return;+ }+ await github(`/repos/${REPO}/commits/${sha}`);+ const release = await github(`/repos/${REPO}/releases`, {+ method: 'POST',+ body: JSON.stringify({ tag_name: args.tag, target_commitish: sha, name: notes.name, body: notes.body, make_latest: 'true' }),+ });+ console.log(`published: ${release.html_url}`);+}++main().catch((err) => {+ console.error(`[github-release] ${err.message}`);+ process.exit(1);+});