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(glb-quality-gate): add the exact v1.0.0 tag, release, and Marketplace runbook and record both satellites as verified
nirholas02a104101001
diff --git a/marketing/growth/opportunities.csv b/marketing/growth/opportunities.csvindex d34886e64..5831a11ff 100644--- a/marketing/growth/opportunities.csv+++ b/marketing/growth/opportunities.csv@@ -23,8 +23,8 @@"P0","18","VS Code Marketplace: three.ws 3D","installable-distribution","ready_to_publish","Publisher threews already exists and is verified; packaged vsix (15 files, 694 KB) passes 71 tests and installs into VS Code 1.138. Owner: create a Marketplace Manage PAT, vsce login threews, npm run publish:marketplace, then OVSX_PAT=<token> npm run publish:openvsx (packages/vscode-3d/PUBLISHING.md)","Owner","2026-09-25","packages/vscode-3d","A complete 3D workflow inside a Microsoft-owned developer surface","Live Marketplace URL and activated install","https://code.visualstudio.com/api/working-with-extensions/publishing-extension","2026-09-17""P1","17","Comfy Registry and Manager","installable-distribution","submission_ready","Owner: create Registry publisher `threews` and API key, then run `comfy node publish` from integrations/comfyui/three_ws_nodes (steps in integrations/comfyui/SUBMITTING.md)","Owner","2026-10-02","integrations/comfyui","Working Forge nodes available through the native manager","Live Registry URL and first completed generation","https://docs.comfy.org/registry/publishing","2026-09-17""P1","16","Blender Extensions","installable-distribution","submission_ready","Owner: sign in with Blender ID, build with `blender --command extension build` in integrations/blender/three_ws, upload at extensions.blender.org/submit, add screenshots, answer review (steps in integrations/blender/SUBMITTING.md)","Owner","2026-10-09","integrations/blender","A working Forge add-on on Blender's own discovery surface","Live Extension URL and first completed generation","https://developer.blender.org/docs/handbook/extensions/addon_guidelines/","2026-09-17"-"P0","20","three.ws agent starter template and Codespaces","owned-product-loop","live_template_unverified","Live at https://github.com/nirholas/threews-agent-starter as a template; open a fresh Codespace and confirm port 4173 renders the live agent before linking it from campaigns","Owner","2026-09-21","satellites/agent-starter","A first avatar rendered before a newcomer must clone or understand the monorepo","Live template URL plus template uses Codespaces starts and successful first renders","https://docs.github.com/en/codespaces/developing-in-a-codespace/creating-a-codespace-from-a-template","2026-09-16"-"P0","19","three.ws GLB Quality Gate GitHub Action","owned-install-surface","published_untagged","Repo is live at https://github.com/nirholas/glb-quality-gate with source identical to the monorepo but no tags; create v1.0.0 and v1, cut a release, then complete the Marketplace form so the documented @v1 install resolves","Owner","2026-09-23","satellites/glb-quality-gate","A useful structural and visual model review inside every adopter pull request","Marketplace URL plus unique installing repositories weekly runs and referral sessions","https://docs.github.com/en/actions/how-tos/create-and-publish-actions/publish-in-github-marketplace","2026-09-16"+"P0","20","three.ws agent starter template and Codespaces","owned-product-loop","live_template_verified","Verified 2026-09-17: the published repo matches satellites/agent-starter (plus exporter LICENSE and NOTICE); a devcontainers CLI build of it ran npm ci, kept the dev server alive after postStartCommand, and Playwright saw the live avatar painted on port 4173 with wave and speak working and no console errors; re-export to ship the stage caption fix, then link from campaigns with a campaign ID","Owner","2026-09-21","satellites/agent-starter","A first avatar rendered before a newcomer must clone or understand the monorepo","Live template URL plus template uses Codespaces starts and successful first renders","https://docs.github.com/en/codespaces/developing-in-a-codespace/creating-a-codespace-from-a-template","2026-09-17"+"P0","19","three.ws GLB Quality Gate GitHub Action","owned-install-surface","release_ready","Verified 2026-09-17: tests pass, committed dist matches a clean build, and a read-only local run reviewed a real pull request; the public repo still carries the older bundle, so follow satellites/glb-quality-gate/RELEASE.md to push the export, tag v1.0.0 and v1, publish the release to the Marketplace, and prove @v1 in a scratch pull request","Owner","2026-09-23","satellites/glb-quality-gate","A useful structural and visual model review inside every adopter pull request","Marketplace URL plus unique installing repositories weekly runs and referral sessions","https://docs.github.com/en/actions/how-tos/create-and-publish-actions/publish-in-github-marketplace","2026-09-17""P0","19","Awesome MCP Servers listing","new-directory","submission_ready","Dispatch the verified listing in marketing/growth/submissions/awesome-mcp-servers.md (checked 2026-09-16: absent from README, no PR or issue mentioning three.ws)","Owner","2026-09-25","marketing/growth/submissions/awesome-mcp-servers.md","A verifiable public MCP server with concise install and tool documentation","Accepted external PR URL plus referred sessions and installs","https://github.com/punkpeye/awesome-mcp-servers/blob/main/CONTRIBUTING.md","2026-09-16""P0","18","GitHub Show and tell monthly feature","owned-community","form_built","Merge the category form then feature the first qualifying community build","Community","2026-09-30",".github/DISCUSSION_TEMPLATE/show-and-tell.yml","Recognition README exposure and a direct maintainer feedback loop","Qualified submissions featured project clicks and contributor conversion","https://github.com/nirholas/three.ws/discussions/categories/show-and-tell","2026-09-15""P1","17","Verified adopter case study","organic-adopter","research_complete","Offer Bowyer an upstream improvement then request a short implementation interview","Owner","2026-09-28","GitHub code-search adoption audit","A maintainer-approved implementation story and useful upstream contribution","Merged contribution interview permission and published case-study URL","https://github.com/BowyerApp/bowyer","2026-09-15"diff --git a/satellites/glb-quality-gate/RELEASE.md b/satellites/glb-quality-gate/RELEASE.mdnew file mode 100644index 000000000..ff6cd42e8--- /dev/null+++ b/satellites/glb-quality-gate/RELEASE.md@@ -0,0 +1,222 @@+# Releasing three.ws GLB Quality Gate++This is the release runbook for `nirholas/glb-quality-gate`. The source of truth is+`satellites/glb-quality-gate` in the three.ws monorepo, and the public repository is a one-way+export of it. The repository owner runs every command below. Nothing here runs automatically.++## v1.0.0 release notes++**three.ws GLB Quality Gate v1.0.0** explains what changed inside every `.glb` file a pull+request touches, and fails the check when a change would break content that depends on it.++- **Finds every changed GLB in the pull request** through the pull request files API. No+ checkout step is needed, and a shallow clone can never produce a half-compared model.+- **Reads both versions byte for byte** from the base and head commits and compares them with+ [`@three-ws/glb-diff`](https://www.npmjs.com/package/@three-ws/glb-diff), the engine behind+ the [three.ws visual model diff](https://three.ws/diff).+- **Understands structure, not bytes.** A re-export that only rewrote the binary layout is+ reported as identical. Changes to meshes, materials, textures, node hierarchy, skeletons, and+ animation clips are reported one by one, with git-style rename and move detection.+- **Reads meshopt-compressed models.** `EXT_meshopt_compression` is decoded before comparison,+ so optimized web avatars and scenes are reviewed like any other model.+- **Classifies every file** as `none`, `cosmetic`, `minor`, `major`, or `breaking`. Added files+ are `minor`, removed files are `breaking`, and renamed files are compared with their previous+ path.+- **Keeps one report per pull request.** The comment is created once and updated in place on+ every push, and the same report is written to the workflow job summary.+- **Works on fork pull requests.** When GitHub gives the workflow a read-only token, the Action+ still writes the job summary and applies the gate, and warns instead of failing on the+ comment.+- **Fails at your threshold.** `fail-on` (default `breaking`) sets the first severity that fails+ the check. `max-files` (default `20`, at most `100`) caps very large pull requests and notes+ how many files were left out.+- **Exposes outputs** `severity` and `files-checked` for later steps.+- **Runs on the Node 24 Actions runtime** from one committed bundle, with no install step.++```yaml+name: Review 3D models++on:+ pull_request:+ paths:+ - "**/*.glb"++permissions:+ contents: read+ pull-requests: write++jobs:+ glb-quality:+ runs-on: ubuntu-latest+ steps:+ - uses: nirholas/glb-quality-gate@v1+ with:+ fail-on: breaking+```++## 0. Build and verify the export++From the monorepo. The exporter installs the locked dependencies, runs the tests, rebuilds the+bundle, and stops if the rebuilt `dist/` differs from the committed one.++```bash+cd /workspaces/three.ws+npm run export:growth-satellites -- --target glb-quality-gate+```++A passing run ends with a line like `glb-quality-gate: 16 files, commit <sha>` and leaves the+tree in `/workspaces/three.ws/dist/growth-satellites/glb-quality-gate`.++## 1. Push the export to the public repository++The public repository already has one commit (`d6edb36`, "feat: publish glb-quality-gate").+The new export goes on top of it as an ordinary commit, so no force push is needed.++This codespace's default `GITHUB_TOKEN` belongs to an account without write access to+`nirholas/*`, so every command that talks to GitHub runs without it, as the `nirholas` account.++```bash+gh auth switch --user nirholas+rm -rf /workspaces/glb-quality-gate-release+env -u GITHUB_TOKEN git -c credential.helper= -c 'credential.helper=!gh auth git-credential' \+ clone https://github.com/nirholas/glb-quality-gate.git /workspaces/glb-quality-gate-release+rsync -a --delete --exclude .git --exclude node_modules \+ /workspaces/three.ws/dist/growth-satellites/glb-quality-gate/ /workspaces/glb-quality-gate-release/+cd /workspaces/glb-quality-gate-release+git status --short+```++`git status --short` should list `RELEASE.md`, `action.yml`, `package.json`,+`package-lock.json`, `scripts/build.mjs`, `test/report.test.js`, and the rebuilt `dist/` files+(`dist/384.index.js` removed, `dist/515.index.js` added). Then:++```bash+git add --all+git commit -m "fix: decode meshopt-compressed models, run on Node 24, and add the release runbook"+env -u GITHUB_TOKEN git -c credential.helper= -c 'credential.helper=!gh auth git-credential' \+ push origin main+```++## 2. Tag v1.0.0 and the major tag v1++```bash+cd /workspaces/glb-quality-gate-release+git tag -a v1.0.0 -m "three.ws GLB Quality Gate v1.0.0"+git tag -a v1 -m "three.ws GLB Quality Gate v1" "v1.0.0^{commit}"+env -u GITHUB_TOKEN git -c credential.helper= -c 'credential.helper=!gh auth git-credential' \+ push origin v1.0.0 v1+```++For every later `v1.x.y`, tag the new version the same way, then move `v1` onto it:++```bash+git tag -a v1.0.1 -m "three.ws GLB Quality Gate v1.0.1"+git tag -fa v1 -m "three.ws GLB Quality Gate v1" "v1.0.1^{commit}"+env -u GITHUB_TOKEN git -c credential.helper= -c 'credential.helper=!gh auth git-credential' \+ push origin v1.0.1+env -u GITHUB_TOKEN git -c credential.helper= -c 'credential.helper=!gh auth git-credential' \+ push --force origin v1+```++## 3. Create the release and publish to the Marketplace++Marketplace publication is a checkbox on the release form, so create this first release in the+browser, not with `gh release create`.++Once per account: two-factor authentication must be on for `nirholas`, and the GitHub+Marketplace Developer Agreement must be accepted (the release form asks the first time). The+repository must stay public, keep its single `action.yml` at the root, and contain no workflow+files.++1. Open <https://github.com/nirholas/glb-quality-gate/releases/new?tag=v1.0.0>.+2. Tick **Publish this Action to the GitHub Marketplace**. GitHub validates `action.yml` and+ previews the listing: name **three.ws GLB Quality Gate**, icon **box**, color **purple**,+ all read from `action.yml`.+3. **Primary category:** Code review. **Secondary category:** Continuous integration.+4. **Release title:** `v1.0.0`.+5. **Description:** paste the "v1.0.0 release notes" section above, from "three.ws GLB Quality+ Gate v1.0.0 explains" through the YAML example.+6. Leave **Set as the latest release** ticked and choose **Publish release**.++The listing name was checked on 2026-09-17: Marketplace searches for `GLB`, `GLB Quality Gate`,+and `three.ws` return no Actions, and+<https://github.com/marketplace/actions/three-ws-glb-quality-gate> is unclaimed.++## 4. Verify the release++Tags, metadata, release, and listing resolve:++```bash+git ls-remote --tags https://github.com/nirholas/glb-quality-gate.git+env -u GITHUB_TOKEN gh api "repos/nirholas/glb-quality-gate/contents/action.yml?ref=v1" --jq .name+env -u GITHUB_TOKEN gh release view v1.0.0 --repo nirholas/glb-quality-gate+curl -s -o /dev/null -w "%{http_code}\n" https://github.com/marketplace/actions/three-ws-glb-quality-gate+```++Expect `refs/tags/v1^{}` and `refs/tags/v1.0.0^{}` on the same commit, `action.yml`, the+release, and `200`.++Then prove `@v1` in a real pull request. The fine-grained token on this machine cannot create+repositories, so first create an empty **private** repository named+`glb-quality-gate-smoke` under `nirholas` in the GitHub UI (no README), and add it to the+token's repository access if the token is scoped to selected repositories. The model change is+real: the baseline is the three.ws default avatar, which is meshopt-compressed, and the change+replaces it with a different three.ws avatar.++```bash+rm -rf /workspaces/glb-quality-gate-smoke+mkdir -p /workspaces/glb-quality-gate-smoke/.github/workflows /workspaces/glb-quality-gate-smoke/models+cd /workspaces/glb-quality-gate-smoke+git init -b main+cat > .github/workflows/glb.yml <<'YAML'+name: Review 3D models+on:+ pull_request:+ paths:+ - "**/*.glb"+permissions:+ contents: read+ pull-requests: write+jobs:+ glb-quality:+ runs-on: ubuntu-latest+ steps:+ - id: gate+ uses: nirholas/glb-quality-gate@v1+ with:+ fail-on: breaking+ - if: always()+ run: echo "severity=${{ steps.gate.outputs.severity }} files=${{ steps.gate.outputs.files-checked }}"+YAML+curl -sfL -o models/avatar.glb https://three.ws/avatars/default.glb+git add .github/workflows/glb.yml models/avatar.glb+git commit -m "Add the GLB quality gate and a baseline avatar"+git remote add origin https://github.com/nirholas/glb-quality-gate-smoke.git+env -u GITHUB_TOKEN git -c credential.helper= -c 'credential.helper=!gh auth git-credential' \+ push -u origin main+git switch -c swap-avatar+curl -sfL -o models/avatar.glb https://three.ws/avatars/cz.glb+git commit -am "Swap the avatar model"+env -u GITHUB_TOKEN git -c credential.helper= -c 'credential.helper=!gh auth git-credential' \+ push -u origin swap-avatar+env -u GITHUB_TOKEN gh pr create --repo nirholas/glb-quality-gate-smoke --head swap-avatar \+ --title "Swap the avatar model" --body "Verifies nirholas/glb-quality-gate@v1."+env -u GITHUB_TOKEN gh pr checks swap-avatar --repo nirholas/glb-quality-gate-smoke --watch+env -u GITHUB_TOKEN gh pr view swap-avatar --repo nirholas/glb-quality-gate-smoke --comments+```++Expected: the `glb-quality` job resolves `nirholas/glb-quality-gate@v1`, fails with+`GLB changes reached breaking, which meets the breaking failure threshold`, prints+`severity=breaking files=1`, and the pull request has exactly one report comment listing+`models/avatar.glb` with its structural changes. Push one more commit to `swap-avatar` and+confirm the same comment is edited rather than a second one added. The same avatar pair was+diffed locally with the release bundle's engine and reports `breaking`.++Delete the scratch repository in the GitHub UI afterwards (Settings, Danger Zone), since the+token cannot delete repositories either.++## After release++In the three.ws monorepo, update the GLB Quality Gate row in+`marketing/growth/opportunities.csv` with the Marketplace URL and add a `data/changelog.json`+entry announcing the Action.