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(growth): build developer acquisition satellites

nirholas9816dce9d227
diff --git a/.github/DISCUSSION_TEMPLATE/show-and-tell.yml b/.github/DISCUSSION_TEMPLATE/show-and-tell.yml
new file mode 100644
index 000000000..17146dfc3
--- /dev/null
+++ b/.github/DISCUSSION_TEMPLATE/show-and-tell.yml
@@ -0,0 +1,65 @@
+title: "[Show and tell] "
+body:
+ - type: markdown
+ attributes:
+ value: |
+ Show the community what you built with three.ws. Finished products, experiments, integrations, and useful works in progress are welcome.
+ - type: input
+ id: project
+ attributes:
+ label: Project name
+ placeholder: My animated support agent
+ validations:
+ required: true
+ - type: textarea
+ id: outcome
+ attributes:
+ label: What did you build?
+ description: Explain what a user can do and which three.ws surface made it possible.
+ placeholder: Visitors can ask our site guide questions and see the answer performed by a 3D character.
+ validations:
+ required: true
+ - type: input
+ id: live_url
+ attributes:
+ label: Live URL
+ description: Add a public demo when one is available.
+ placeholder: https://example.com/demo
+ - type: input
+ id: source_url
+ attributes:
+ label: Source repository
+ description: Link the code when it is public.
+ placeholder: https://github.com/owner/repository
+ - type: dropdown
+ id: surface
+ attributes:
+ label: Main three.ws surface used
+ options:
+ - agent-3d web component
+ - 3D generation or rigging
+ - Model inspection or diff
+ - MCP server or tool
+ - SDK or package
+ - World or spatial experience
+ - Another three.ws surface
+ validations:
+ required: true
+ - type: textarea
+ id: lesson
+ attributes:
+ label: What did you learn?
+ description: Share one implementation detail that would help the next builder.
+ validations:
+ required: true
+ - type: textarea
+ id: media
+ attributes:
+ label: Screenshot or short recording
+ description: Drag an image, GIF, or video here so people can understand the result quickly.
+ - type: checkboxes
+ id: feature_permission
+ attributes:
+ label: Community feature
+ options:
+ - label: three.ws may link to this project from community channels with attribution.
diff --git a/STRUCTURE.md b/STRUCTURE.md
index 778f9b1ef..cba947e5b 100644
--- a/STRUCTURE.md
+++ b/STRUCTURE.md
@@ -143,6 +143,7 @@ bottom.
| Premium vanity inventory (sell pre-ground addresses) | [public/vanity/premium/](public/vanity/premium/index.html) `→ /vanity/premium`, batch grinder [workers/vanity-grinder/](workers/vanity-grinder), store [api/_lib/vanity-inventory-store.js](api/_lib/vanity-inventory-store.js), sell [api/x402/vanity-premium.js](api/x402/vanity-premium.js), replenish [api/cron/vanity-inventory-replenish.js](api/cron/vanity-inventory-replenish.js) | In-repo · GCP spot CPU | Long (4–5+ char) brandable Solana addresses ground ahead of time on cheap spot CPU, sealed at rest (AES-256-GCM or GCP-KMS envelope, [api/_lib/vanity-vault.js](api/_lib/vanity-vault.js)), and sold from stock via x402 — priced by rarity ($1–$50) on `vanity-premium`, or by fixed 4–5 char tiers ($2.50/$10) directly through [`/api/x402/vanity`](docs/vanity.md#tier-1--live-grinder) (instant delivery, `source:"inventory"`) and the [pump-launch vanity upsell](docs/pump-launcher.md) — delivered exactly once, ciphertext destroyed on delivery. An hourly cron watches stock and fires a fresh grind batch (Cloud Run Job) when low. Free `vanity_premium` MCP browse tool. Runbook: [docs/ops/gcp-credits.md](docs/ops/gcp-credits.md) |
| Embed examples | [examples/](examples) | In-repo | `embed-test.html`, `web-component.html`, `two-agents.html`, `minimal.html`, [agent-native-3d/](examples/agent-native-3d) (below). Also: [skills/](examples/skills) (six installable skill bundles), [three-concierge/](examples/three-concierge) (Trinity, reference agent for manifest spec agent-manifest/0.2), [monicas-apartment/](examples/monicas-apartment) (walkable first-person Three.js scene demo, added 2026-07-17), [agenc-task-roundtrip/](examples/agenc-task-roundtrip) (end-to-end AgenC task flow on Solana devnet), [metamask-agent-wallet/](examples/metamask-agent-wallet) (single-page demo giving an agent a server-side MetaMask wallet), [pump-fun-agent/](examples/pump-fun-agent) (example manifest composing the four production pump.fun skills), [paid-mcp-server/](examples/paid-mcp-server) (an MCP server whose tools charge per call in USDC on Solana over x402: one free orientation tool, one paid glTF/GLB inspector, 15 tests, added 2026-07-30) |
| Examples satellite repo (public developer front door) | Exporter [scripts/export-satellites.mjs](scripts/export-satellites.mjs) (`npm run export:satellites`), runbook [docs/ops/examples-repo-export.md](docs/ops/examples-repo-export.md), curated source [examples/](examples) + the published `@three-ws/*` SDKs | Built and gated in-repo; publishing is owner-gated (the `three-ws` GitHub org does not exist yet) | Assembles the public `three-ws/examples` repo from this monorepo as a strictly ONE-WAY export: the monorepo is the only source of truth, the satellite history is disposable, and it is never pulled, fetched, or merged from (same rule as the retired 3D-Agent mirror). No CI is involved (GitHub Actions are unavailable here), so the export runs locally from the push routine. Every relative reference is resolved against its real location and routed by where it lands rather than regex-swept: to the shipped file, to another exported unit (so an agent manifest's skill `uri` still resolves), to the published package on jsDelivr, to the live docs page, or to a monorepo permalink. A four-stage smoke gate then aborts the export on any failure, because a broken public example is anti-marketing: structure (no reference escapes or dangles, no `file:` dep survives), registry (every pinned `@three-ws/*` version exists on npm), install (`npm install` plus each example's own check command), and links (every `https://three.ws` URL reachable). On success it stamps a single-parent git history into the staging tree and prints the org-creation and push commands; it never touches a remote. Examples referencing a crypto project other than $THREE are held out of the manifest under the CLAUDE.md commit gate (`pump-fun-agent`, `three-concierge`, `agenc-task-roundtrip`). |
+| Product-led growth satellites | Canonical source [satellites/](satellites), exporter [scripts/export-growth-satellites.mjs](scripts/export-growth-satellites.mjs) (`npm run export:growth-satellites`), runbook [docs/ops/growth-satellite-export.md](docs/ops/growth-satellite-export.md) | Built and gated in-repo; destination repositories require the `nirholas` owner identity | Two focused acquisition surfaces whose first experience is deliberately smaller than this monorepo: [satellites/agent-starter/](satellites/agent-starter) is a responsive, Codespaces-ready live `<agent-3d>` page with real motion, speech, a keyless create command, a ten-minute learning path, and a structural check; [satellites/glb-quality-gate/](satellites/glb-quality-gate) is a Node 20 GitHub Action that discovers changed GLBs through the pull-request API, reads base/head bytes without a checkout, runs the published `@three-ws/glb-diff` engine, upserts a PR report, writes the workflow summary, and gates at a configurable severity. The exporter installs locked dependencies, runs real tests, builds the committed Action bundle, copies Apache legal files, and stamps one clean history per destination. The monorepo remains the only source of truth. |
| Agent-native 3D + embeddable distribution | MCP tool [api/_mcp/tools/agents.js](api/_mcp/tools/agents.js) (`attach_avatar_to_agent`); shared oEmbed provider [api/agent-oembed.js](api/agent-oembed.js) `→ /api/oembed` + builder [api/_lib/embed.js](api/_lib/embed.js) (`forgeEmbedTarget`, shared by `get_embed_code` in [api/_mcp/tools/embed.js](api/_mcp/tools/embed.js)); Forge share page oEmbed discovery [api/forge-share.js](api/forge-share.js) `→ /forge/share/:id`; distribution snippet builders [src/forge-embed-snippets.js](src/forge-embed-snippets.js) + panel [src/forge-embed-panel.js](src/forge-embed-panel.js); autonomous demo [examples/agent-native-3d/](examples/agent-native-3d) | In-repo | Closes the loop: create → own → discover/remix → **use everywhere**. `attach_avatar_to_agent` gives a registered agent identity a persistent body (chains into `register_agent` for on-chain identity + `anchor_provenance` for a signed authenticity credential). Any Forge creation now unfurls via real oEmbed (paste `/forge/share/:id` into Notion/Discord/Slack) with the same `type:rich` iframe payload `get_embed_code` returns via MCP. The Forge "Embed this model" panel hands out five real distribution flavours from one GLB — iframe, `<model-viewer>`, `<agent-3d>`, a `@three-ws/page-agent` talking guide, and a `@three-ws/walk` companion — all built from one shared, pure snippet module so every surface stays byte-identical. `examples/agent-native-3d/run.mjs` drives the full agent-native chain live against `/api/mcp-studio` (mesh_forge → rig_mesh → create_agent_persona → persona_say → get_agent_persona → every distribution snippet) with zero mocks and a documented, logged fallback if the shared free-tier generation lane is rate-limited at run time. Spec: [specs/EMBED_SPEC.md](specs/EMBED_SPEC.md#share-routes-on-chain-agents). Docs: [docs/mcp.md#attach_avatar_to_agent](docs/mcp.md#attach_avatar_to_agent). Roadmap prompt 10 (closes the roadmap campaign). |
| Animation pipeline | [public/animations/](public/animations) + [scripts/build-animations.mjs](scripts/build-animations.mjs) | In-repo | Mixamo source FBX + GLB retargeting pipeline · see [docs/3d-asset-pipeline.md](docs/3d-asset-pipeline.md) |
| Procedural animation (runtime IK layers) | [src/procedural/](src/procedural) — analytic two-bone IK [two-bone-ik.js](src/procedural/two-bone-ik.js), gaze [look-at.js](src/procedural/look-at.js), terrain foot planting [foot-plant.js](src/procedural/foot-plant.js), drift-free re-application [pose-baseline.js](src/procedural/pose-baseline.js) | Live | Post-mixer layers that do what no baked clip can: the chest/neck/head chain turns toward a world point, and each foot lands on its own patch of uneven ground. Rig-agnostic via `canonicalNodeMapFromObject`; an unsupported rig reports `enabled === false` and no-ops. Wired into the corner companion ([walk-sdk/src/companion.js](walk-sdk/src/companion.js) `_updateGaze`), the walkaround world ([src/walk.js](src/walk.js) `rebuildFootPlant`), and agent avatars ([src/agent-avatar.js](src/agent-avatar.js) `_applyLookTarget` — which is what finally makes `setLookTarget()` and the `LOOK_AT` action move the rig). Ambient idle motion (breathing/blink/saccade/weight-shift) stays in [src/idle-animation.js](src/idle-animation.js). Docs: [docs/procedural-animation.md](docs/procedural-animation.md). Tests: [tests/procedural-anim.test.js](tests/procedural-anim.test.js), [tests/agent-avatar-look-target.test.js](tests/agent-avatar-look-target.test.js) |
diff --git a/data/changelog.json b/data/changelog.json
index 05e681c4b..0bc0ef7b1 100644
--- a/data/changelog.json
+++ b/data/changelog.json
@@ -1,6 +1,15 @@
{
"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security. `link` is optional and must be a live three.ws path.",
"entries": [
+ {
+ "date": "2026-09-15",
+ "title": "Show and tell now captures projects people can actually try",
+ "summary": "The GitHub community showcase now asks builders for the outcome, live demo, source, three.ws surface used, one useful lesson, and visual proof. That structure makes each submission easier to understand, reproduce, feature, and turn into an honest adopter story. Two compact developer front doors are also fully built and exportable: a Codespaces starter that opens on a live animated agent, and a GLB pull-request quality gate powered by the same model-diff engine as three.ws.",
+ "tags": [
+ "improvement",
+ "docs"
+ ]
+ },
{
"date": "2026-09-15",
"title": "three.ws is ready for Solana's new 4 KiB transactions",
diff --git a/docs/ops/growth-satellite-export.md b/docs/ops/growth-satellite-export.md
new file mode 100644
index 000000000..5f3012284
--- /dev/null
+++ b/docs/ops/growth-satellite-export.md
@@ -0,0 +1,65 @@
+# Growth satellite export and publication
+
+The agent starter and GLB Quality Gate are intentionally small public front doors. Their
+canonical source stays in this monorepo under [`satellites/`](../../satellites), and a one-way
+export creates standalone Git histories ready for their own repositories.
+
+## Build and verify
+
+```bash
+npm run export:growth-satellites
+```
+
+The exporter:
+
+1. replaces only `dist/growth-satellites/`;
+2. copies each curated source plus the root Apache-2.0 license and notice;
+3. installs locked dependencies;
+4. runs each satellite's real tests;
+5. builds the committed JavaScript Action bundle;
+6. creates a clean, single-commit `main` history for each repository;
+7. writes `manifest.json` with the exact commit and file count.
+
+For a structural export without network-dependent installs:
+
+```bash
+npm run export:growth-satellites -- --offline
+```
+
+Build only one tree with `--target agent-starter` or `--target glb-quality-gate`. A custom
+`--out` is allowed only beneath this repository's `dist/` directory.
+
+## Publish
+
+The destination repositories are:
+
+- `https://github.com/nirholas/threews-agent-starter`
+- `https://github.com/nirholas/glb-quality-gate`
+
+Create each as a public, empty repository. The exporter prints the exact `remote add` and
+`push` commands for the generated tree. Never pull, fetch, or merge a satellite into the
+monorepo; rebuild it from source for every release.
+
+After publishing the starter, mark it as a template repository in GitHub settings and verify
+that a fresh Codespace opens port 4173 with the live agent visible.
+
+After publishing the Action:
+
+1. create annotated tag `v1.0.0`;
+2. point major tag `v1` at the same commit;
+3. create a GitHub release;
+4. open `action.yml` on GitHub and choose **Publish this Action to the GitHub Marketplace**;
+5. accept the Marketplace terms and select the continuous-integration category;
+6. install `nirholas/glb-quality-gate@v1` in a real repository containing a changed GLB.
+
+Marketplace publication requires a separate public repository with one root action metadata
+file. The release tag is the install contract, so move `v1` only after the exported tests and
+bundle pass.
+
+## Update the monorepo after publication
+
+- Replace planned repository links in `marketing/growth/opportunities.csv` with live URLs.
+- Record the template and Marketplace release in `data/changelog.json`.
+- Add dedicated campaign IDs before linking from a directory submission or announcement.
+- Record template uses, Codespaces starts, Action installations, weekly runs, and referred
+ sessions in the marketing scorecard.
diff --git a/marketing/growth/README.md b/marketing/growth/README.md
index 212debcab..4a58154b8 100644
--- a/marketing/growth/README.md
+++ b/marketing/growth/README.md
@@ -18,6 +18,8 @@ This directory is the operational layer above the repo's deeper source material:
targets, official intake paths, and the big-brand engagement ladder.
- [GitHub and ecosystem growth surfaces](./github-growth-surfaces.md): the starter-template,
Marketplace Action, curated-directory, adopter-story, and startup-program acquisition loops.
+- [External directory submission kit](./submissions/README.md): verified listing copy,
+ evidence, and dispatch instructions for the first two high-intent directories.
- [90-day campaigns](./campaigns.csv): one row per campaign, with channel, CTA, partner ask,
KPI, date, and status.
- [Opportunity tracker](./opportunities.csv): the machine-readable pipeline. This is where
diff --git a/marketing/growth/github-growth-surfaces.md b/marketing/growth/github-growth-surfaces.md
index b36448798..e057595cc 100644
--- a/marketing/growth/github-growth-surfaces.md
+++ b/marketing/growth/github-growth-surfaces.md
@@ -174,6 +174,26 @@ Each month, choose one adjacent open-source 3D or agent project. Build the small
integration, contribute it upstream, and publish a two-sided demo. Start with maintainers who
already use or mention three.ws; expand to cold targets only after the format works.
+## Implementation status
+
+The first owned surfaces are built in the canonical repository:
+
+- [`satellites/agent-starter`](../../satellites/agent-starter) contains the live responsive
+ demo, Codespaces configuration, ten-minute guide, contribution guide, and structural test.
+- [`satellites/glb-quality-gate`](../../satellites/glb-quality-gate) contains the complete
+ GitHub Action, real serialized-GLB tests, bundled runtime build, usage docs, and release
+ contract.
+- [`scripts/export-growth-satellites.mjs`](../../scripts/export-growth-satellites.mjs) builds,
+ tests, licenses, bundles, and stamps standalone repository histories for both.
+- [The directory submission kit](./submissions/README.md) contains copy and verification
+ packets for the two curated-list pull requests.
+- [The Show and tell discussion form](../../.github/DISCUSSION_TEMPLATE/show-and-tell.yml)
+ collects a project outcome, live/source links, the three.ws surface used, one lesson, media,
+ and optional feature permission.
+
+Publication requires GitHub authentication as the `nirholas` owner because both planned
+destinations live in that personal namespace. Do not publish them under a different account.
+
## Decision sequence
| By | Decision or deliverable | Evidence |
diff --git a/marketing/growth/opportunities.csv b/marketing/growth/opportunities.csv
index bf779483c..88a2cd976 100644
--- a/marketing/growth/opportunities.csv
+++ b/marketing/growth/opportunities.csv
@@ -23,12 +23,12 @@
"P0","18","VS Code Marketplace: three.ws 3D","installable-distribution","ready_to_package","Resolve publisher identity; package, test, inspect, and publish","Engineering+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-15"
"P1","17","Comfy Registry and Manager","installable-distribution","metadata_needed","Add pyproject metadata; create publisher identity; package and publish","Engineering+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-15"
"P1","16","Blender Extensions","installable-distribution","compliance_needed","Honor online-access setting; add manifest; package and submit","Engineering+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-15"
-"P0","20","three.ws agent starter template and Codespaces","owned-product-loop","not_started","Create a tiny template repository with one command one demo and a dev container","Owner","2026-09-21","packages/create-agent","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-15"
-"P0","19","three.ws GLB Quality Gate GitHub Action","owned-install-surface","not_started","Create a single-purpose Action repository and recruit five design partners","Owner","2026-09-23","packages/glb-diff","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-15"
-"P0","19","Awesome MCP Servers listing","new-directory","verified_absent","Submit one narrow installable open-source 3D server in the required format","Owner","2026-09-25","mcp-server","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-15"
-"P0","18","GitHub Show and tell monthly feature","owned-community","seeded_inactive","Publish a submission template and feature the first community build","Community","2026-09-30","GitHub Discussions Show and tell","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"
+"P0","20","three.ws agent starter template and Codespaces","owned-product-loop","built_export_ready","Publish the prepared satellite as nirholas/threews-agent-starter and enable template mode","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-15"
+"P0","19","three.ws GLB Quality Gate GitHub Action","owned-install-surface","built_export_ready","Publish the prepared satellite tag v1 and complete the Marketplace form","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-15"
+"P0","19","Awesome MCP Servers listing","new-directory","submission_ready","Dispatch the verified listing in marketing/growth/submissions/awesome-mcp-servers.md","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-15"
+"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"
-"P1","16","Awesome Three.js listing","new-directory","verified_absent","Submit one web component or GLB tool with a tiny live demo","Owner","2026-10-02","packages/glb-diff","A focused open-source tool for the existing Three.js builder audience","Accepted external PR URL plus referred sessions and package installs","https://github.com/AxiomeCG/awesome-threejs","2026-09-15"
+"P1","16","Awesome Three.js listing","new-directory","submission_ready","Dispatch the verified listing in marketing/growth/submissions/awesome-threejs.md","Owner","2026-10-02","marketing/growth/submissions/awesome-threejs.md","A focused open-source tool for the existing Three.js builder audience","Accepted external PR URL plus referred sessions and package installs","https://github.com/AxiomeCG/awesome-threejs","2026-09-15"
"P1","16","GitHub Community Exchange starter listing","education-channel","eligibility_check","Add LEARN.md and collaborator issues to the starter then submit if owner is Education-eligible","Community","2026-10-09","planned starter repository","A complete visual Learn and Collaborate project for students","Accepted listing URL student forks and first-time contributors","https://docs.github.com/en/education/contribute-with-github-community-exchange/submitting-your-repository-to-github-community-exchange","2026-09-15"
"P2","15","DigitalOcean Startups distribution route","new-program","eligibility_check","Confirm eligibility and product fit then apply with a marketplace and customer-story plan","Owner","2026-10-16","marketplace-ready developer tool","A useful AI developer product and reproducible startup implementation","Acceptance marketplace placement or provider-owned co-marketing URL","https://www.digitalocean.com/startups","2026-09-15"
"P2","14","MongoDB for Startups GTM route","new-program","architecture_and_eligibility_check","Verify production usage and current stage requirements before applying","Owner","2026-10-16","production data architecture","A genuine production implementation with a visual AI customer outcome","Acceptance assigned support and provider-owned GTM placement","https://www.mongodb.com/solutions/startups","2026-09-15"
diff --git a/marketing/growth/submissions/README.md b/marketing/growth/submissions/README.md
new file mode 100644
index 000000000..cd1e08122
--- /dev/null
+++ b/marketing/growth/submissions/README.md
@@ -0,0 +1,10 @@
+# External directory submission kit
+
+These are source-backed, copy-ready submissions for high-intent open-source directories. Use
+one narrow product per submission and preserve each directory's current format.
+
+- [`awesome-mcp-servers.md`](./awesome-mcp-servers.md)
+- [`awesome-threejs.md`](./awesome-threejs.md)
+
+Before dispatch, rerun the install command, open the live demo, and re-check the target's
+contribution guide. Record the pull request URL and campaign ID in the opportunity tracker.
diff --git a/marketing/growth/submissions/awesome-mcp-servers.md b/marketing/growth/submissions/awesome-mcp-servers.md
new file mode 100644
index 000000000..456f9306f
--- /dev/null
+++ b/marketing/growth/submissions/awesome-mcp-servers.md
@@ -0,0 +1,32 @@
+# Awesome MCP Servers submission
+
+Target: [punkpeye/awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers)
+
+## Listing line
+
+Add alphabetically to the section for developer tools or 3D/media tools, following the exact
+format present at submission time:
+
+```markdown
+- [three.ws 3D MCP Server](https://github.com/nirholas/three.ws/tree/main/mcp-server) - Open-source tools for inspecting, generating, rigging, animating, and embedding glTF/GLB models from MCP clients.
+```
+
+## Pull request title
+
+```text
+Add three.ws 3D MCP Server
+```
+
+If the directory's automated-agent fast-track remains available, append its documented marker
+to the title only when an automated agent actually opens the pull request.
+
+## Verification packet
+
+- Public source: <https://github.com/nirholas/three.ws/tree/main/mcp-server>
+- Package: <https://www.npmjs.com/package/@three-ws/mcp-server>
+- License: Apache-2.0
+- Install: `npx @three-ws/mcp-server`
+- Product documentation: <https://three.ws/docs/mcp>
+
+Do not list the hosted endpoint as if it were the installable server. The target directory
+requires a public server people can install and run themselves.
diff --git a/marketing/growth/submissions/awesome-threejs.md b/marketing/growth/submissions/awesome-threejs.md
new file mode 100644
index 000000000..feca9100a
--- /dev/null
+++ b/marketing/growth/submissions/awesome-threejs.md
@@ -0,0 +1,28 @@
+# Awesome Three.js submission
+
+Target: [AxiomeCG/awesome-threejs](https://github.com/AxiomeCG/awesome-threejs)
+
+## Listing line
+
+Add under **Tools**, near model inspection or optimization tooling, matching the current list
+style:
+
+```markdown
+- [three.ws Model Diff](https://three.ws/diff): A browser and CLI structural diff for glTF/GLB files that explains geometry, material, skeleton, hierarchy, and animation changes instead of comparing binary bytes. Open source at [nirholas/three.ws](https://github.com/nirholas/three.ws/tree/main/packages/glb-diff).
+```
+
+## Pull request title
+
+```text
+Add three.ws Model Diff
+```
+
+## Verification packet
+
+- Live tool: <https://three.ws/diff>
+- Public source: <https://github.com/nirholas/three.ws/tree/main/packages/glb-diff>
+- Package: <https://www.npmjs.com/package/@three-ws/glb-diff>
+- License: Apache-2.0
+- Install: `npm install @three-ws/glb-diff`
+
+Lead with the model-diff outcome. Do not submit the entire platform as one entry.
diff --git a/package.json b/package.json
index 81ec2d00b..c3095dca8 100644
--- a/package.json
+++ b/package.json
@@ -266,6 +266,7 @@
"check:erc7710": "node scripts/check-erc7710-addresses.js",
"check:relayer-balances": "node scripts/check-relayer-balances.mjs",
"export:satellites": "node scripts/export-satellites.mjs",
+ "export:growth-satellites": "node scripts/export-growth-satellites.mjs",
"guard:hidden": "node scripts/inject-hidden-guard.mjs --write",
"check:images": "node scripts/audit-image-loading.mjs --strict",
"audit:web": "node scripts/page-audit.mjs",
diff --git a/satellites/README.md b/satellites/README.md
new file mode 100644
index 000000000..2e0aa7fcd
--- /dev/null
+++ b/satellites/README.md
@@ -0,0 +1,19 @@
+# three.ws satellite repositories
+
+This directory is the canonical source for focused repositories exported from the three.ws
+monorepo. Each child is complete, independently testable, and intentionally smaller than the
+main repository.
+
+| Satellite | Purpose | Export target |
+| --- | --- | --- |
+| [`agent-starter`](./agent-starter) | One-click Codespaces introduction to an animated 3D agent | `nirholas/threews-agent-starter` |
+| [`glb-quality-gate`](./glb-quality-gate) | GitHub Action that reviews changed GLB files in pull requests | `nirholas/glb-quality-gate` |
+
+Build both publishable trees with:
+
+```bash
+npm run export:growth-satellites
+```
+
+The exporter is one-way. The monorepo is always the source of truth; exported repositories
+must never be merged back into it.
diff --git a/satellites/agent-starter/.devcontainer/devcontainer.json b/satellites/agent-starter/.devcontainer/devcontainer.json
new file mode 100644
index 000000000..f2c37c3f3
--- /dev/null
+++ b/satellites/agent-starter/.devcontainer/devcontainer.json
@@ -0,0 +1,18 @@
+{
+ "name": "three.ws agent starter",
+ "image": "mcr.microsoft.com/devcontainers/javascript-node:1-22-bookworm",
+ "forwardPorts": [4173],
+ "portsAttributes": {
+ "4173": {
+ "label": "three.ws agent",
+ "onAutoForward": "openBrowser"
+ }
+ },
+ "postCreateCommand": "npm ci",
+ "postStartCommand": "nohup npm run dev > /tmp/threews-agent-starter.log 2>&1 &",
+ "customizations": {
+ "codespaces": {
+ "openFiles": ["README.md", "index.html", "app.js"]
+ }
+ }
+}
diff --git a/satellites/agent-starter/.gitignore b/satellites/agent-starter/.gitignore
new file mode 100644
index 000000000..eff0b4b0a
--- /dev/null
+++ b/satellites/agent-starter/.gitignore
@@ -0,0 +1,3 @@
+node_modules/
+.DS_Store
+npm-debug.log*
diff --git a/satellites/agent-starter/CONTRIBUTING.md b/satellites/agent-starter/CONTRIBUTING.md
new file mode 100644
index 000000000..c6be6b819
--- /dev/null
+++ b/satellites/agent-starter/CONTRIBUTING.md
@@ -0,0 +1,12 @@
+# Contributing
+
+This starter optimizes for the shortest honest path from opening a repository to seeing a live
+3D agent. Changes should preserve that focus.
+
+1. Fork the repository and create a focused branch.
+2. Run `npm ci` and `npm test`.
+3. Exercise the page at 320px, 768px, and a desktop width.
+4. Open a pull request describing the learner outcome that improved.
+
+Do not add account requirements, private credentials, generated secrets, fake API responses,
+or a framework build step. Examples must call public, documented three.ws surfaces.
diff --git a/satellites/agent-starter/LEARN.md b/satellites/agent-starter/LEARN.md
new file mode 100644
index 000000000..616320b42
--- /dev/null
+++ b/satellites/agent-starter/LEARN.md
@@ -0,0 +1,59 @@
+# Build an animated agent in 10 minutes
+
+This guide begins with the working character already visible in the starter. Each step changes
+one thing and keeps the page runnable.
+
+## 1. Understand the two tags
+
+Open `index.html`. The module script registers the `agent-3d` web component. The element below
+it supplies a model URL and a display name. No framework or bundler is involved.
+
+## 2. Change the agent's identity
+
+Change the element's `name` to a role that belongs on your site. Update the introduction in
+`app.js` to match. Refresh the page and press **Introduce yourself**.
+
+## 3. Create a model
+
+From the terminal, describe one full-body character in a neutral pose:
+
+```bash
+npm create @three-ws/agent "a friendly museum guide in a navy uniform"
+```
+
+Generation and rigging normally take one to three minutes. The command reports real elapsed
+time, downloads the finished GLB, and prints its hosted URL.
+
+## 4. Put the model on the page
+
+Replace the `body` value in `index.html` with that hosted URL. To serve the downloaded model
+from the starter instead, copy `agent.glb` beside `index.html` and use:
+
+```html
+<agent-3d body="./agent.glb" name="Museum Guide"></agent-3d>
+```
+
+## 5. Add behavior
+
+The starter waits for the component to load before enabling controls. Add another button and
+call one documented method, such as:
+
+```js
+await agent.playClip('idle', { userInitiated: true });
+agent.speak('What would you like to explore?');
+```
+
+Use `userInitiated: true` only in response to a real user gesture. Ambient animation should
+respect reduced-motion preferences.
+
+## 6. Ship it
+
+The starter is static. Any host that serves `index.html`, `app.js`, `styles.css`, and the model
+can run it. Before publishing, run:
+
+```bash
+npm test
+```
+
+Share the finished URL in the
+[three.ws Show and tell discussion](https://github.com/nirholas/three.ws/discussions/categories/show-and-tell).
diff --git a/satellites/agent-starter/README.md b/satellites/agent-starter/README.md
new file mode 100644
index 000000000..800f0ac2a
--- /dev/null
+++ b/satellites/agent-starter/README.md
@@ -0,0 +1,54 @@
+# Your first three.ws agent
+
+A one-click starting point for putting a live, animated 3D agent on a web page. Open the
+repository in GitHub Codespaces and the demo starts automatically.
+
+## Start in Codespaces
+
+Use **Code > Codespaces > Create codespace on main**. When the forwarded port opens, the page
+shows a real `<agent-3d>` component using the production three.ws CDN.
+
+For a local checkout:
+
+```bash
+npm ci
+npm run dev
+```
+
+Open <http://localhost:4173>.
+
+## Make the character yours
+
+Run this in the terminal:
+
+```bash
+npm create @three-ws/agent "a friendly robot guide"
+```
+
+The command uses the public generation lane, downloads the finished GLB, and creates a working
+page. No three.ws account or API key is required. Replace the `body` URL in `index.html` with
+the generated model URL or a path to the downloaded `agent.glb`.
+
+## The whole integration
+
+```html
+<script type="module" src="https://three.ws/agent-3d/latest/agent-3d.js"></script>
+<agent-3d body="https://three.ws/avatars/default.glb" name="Nova"></agent-3d>
+```
+
+`app.js` adds two real interactions: it finds a wave in the live animation catalog and calls
+`playClip()`, and it calls `speak()` for a talking gesture.
+
+## Verify
+
+```bash
+npm test
+```
+
+Continue with [LEARN.md](./LEARN.md), then explore the
+[web component API](https://three.ws/docs/web-component) and the
+[visual creator](https://three.ws/create).
+
+## License
+
+Apache-2.0
diff --git a/satellites/agent-starter/app.js b/satellites/agent-starter/app.js
new file mode 100644
index 000000000..75fc61602
--- /dev/null
+++ b/satellites/agent-starter/app.js
@@ -0,0 +1,58 @@
+const agent = document.querySelector('#agent');
+const controls = [...document.querySelectorAll('[data-action]')];
+const copyButton = document.querySelector('[data-copy]');
+const copyStatus = document.querySelector('#copy-status');
+const command = document.querySelector('#create-command');
+
+function report(message) {
+ copyStatus.textContent = message;
+}
+
+async function copyCommand() {
+ try {
+ await navigator.clipboard.writeText(command.textContent);
+ copyButton.textContent = 'Copied';
+ report('Copied. Paste it into the terminal to create your own rigged character.');
+ } catch {
+ const selection = window.getSelection();
+ const range = document.createRange();
+ range.selectNodeContents(command);
+ selection.removeAllRanges();
+ selection.addRange(range);
+ report('The command is selected. Copy it, then paste it into the terminal.');
+ }
+}
+
+async function findWaveClip() {
+ const response = await fetch('https://three.ws/animations/manifest.json');
+ if (!response.ok) throw new Error(`animation catalog answered ${response.status}`);
+ const clips = await response.json();
+ return clips.find((clip) => /wave/i.test(clip.name))?.name || null;
+}
+
+async function wave() {
+ const clip = await findWaveClip();
+ if (clip) await agent.playClip(clip, { userInitiated: true });
+ else agent.speak('Hello from three dot w s!');
+}
+
+customElements.whenDefined('agent-3d').then(() => {
+ for (const control of controls) control.disabled = false;
+ report('The live component is ready. Try a control or make your own character.');
+});
+
+copyButton.addEventListener('click', copyCommand);
+
+document.querySelector('[data-action="wave"]').addEventListener('click', async () => {
+ try {
+ await wave();
+ report('That motion came from the live three.ws animation catalog.');
+ } catch (error) {
+ report(`The animation could not load: ${error.message}. Try again.`);
+ }
+});
+
+document.querySelector('[data-action="speak"]').addEventListener('click', () => {
+ agent.speak('Hi, I am Nova. Replace my model URL with the character you create.');
+ report('The avatar is speaking with its built-in talking gesture.');
+});
diff --git a/satellites/agent-starter/index.html b/satellites/agent-starter/index.html
new file mode 100644
index 000000000..8527c9158
--- /dev/null
+++ b/satellites/agent-starter/index.html
@@ -0,0 +1,62 @@
+<!doctype html>
+<html lang="en">
+ <head>
+ <meta charset="UTF-8" />
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
+ <meta
+ name="description"
+ content="Put an animated three.ws 3D agent on a web page, then make a character of your own."
+ />
+ <title>Your first three.ws agent</title>
+ <link rel="stylesheet" href="./styles.css" />
+ <script type="module" src="https://three.ws/agent-3d/latest/agent-3d.js"></script>
+ <script type="module" src="./app.js"></script>
+ </head>
+ <body>
+ <main>
+ <section class="copy" aria-labelledby="title">
+ <a class="eyebrow" href="https://three.ws" target="_blank" rel="noreferrer">three.ws starter</a>
+ <h1 id="title">Give your website a body.</h1>
+ <p class="lede">
+ This page is already running a real animated 3D agent. Make it react, inspect the tiny
+ integration, then generate a character that is yours.
+ </p>
+
+ <div class="actions" aria-label="Agent controls">
+ <button type="button" data-action="wave" disabled>Wave hello</button>
+ <button type="button" class="secondary" data-action="speak" disabled>Introduce yourself</button>
+ </div>
+
+ <div class="command-card">
+ <div>
+ <span class="step">Make your own</span>
+ <code id="create-command">npm create @three-ws/agent "a friendly robot guide"</code>
+ </div>
+ <button type="button" class="copy-button" data-copy aria-describedby="copy-status">Copy</button>
+ </div>
+ <p id="copy-status" class="status" role="status" aria-live="polite">
+ Run the command in this Codespace terminal. No account or API key is required.
+ </p>
+
+ <nav aria-label="Next steps">
+ <a href="./LEARN.md">Follow the 10-minute guide</a>
+ <a href="https://three.ws/docs/web-component" target="_blank" rel="noreferrer">Read the component API</a>
+ <a href="https://three.ws/create" target="_blank" rel="noreferrer">Open the creator</a>
+ </nav>
+ </section>
+
+ <section class="stage" aria-label="Live 3D agent preview">
+ <div class="live-pill"><span aria-hidden="true"></span> Live component</div>
+ <agent-3d
+ id="agent"
+ body="https://three.ws/avatars/default.glb"
+ name="Nova"
+ camera="fullbody"
+ background="transparent"
+ style="width: 100%; height: 100%"
+ ></agent-3d>
+ <p class="stage-caption">One script. One element. A full 3D character.</p>
+ </section>
+ </main>
+ </body>
+</html>
diff --git a/satellites/agent-starter/package-lock.json b/satellites/agent-starter/package-lock.json
new file mode 100644
index 000000000..e82fee933
--- /dev/null
+++ b/satellites/agent-starter/package-lock.json
@@ -0,0 +1,1061 @@
+{
+ "name": "threews-agent-starter",
+ "version": "1.0.0",
+ "lockfileVersion": 3,
+ "requires": true,
+ "packages": {
+ "": {
+ "name": "threews-agent-starter",
+ "version": "1.0.0",
+ "license": "Apache-2.0",
+ "devDependencies": {
+ "serve": "^14.2.4"
+ },
+ "engines": {
+ "node": ">=20"
+ }
+ },
+ "node_modules/@zeit/schemas": {
+ "version": "2.36.0",
+ "resolved": "https://registry.npmjs.org/@zeit/schemas/-/schemas-2.36.0.tgz",
+ "integrity": "sha512-7kjMwcChYEzMKjeex9ZFXkt1AyNov9R5HZtjBKVsmVpw7pa7ZtlCGvCBC2vnnXctaYN+aRI61HjIqeetZW5ROg==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/ajv": {
+ "version": "8.18.0",
+ "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.18.0.tgz",
+ "integrity": "sha512-PlXPeEWMXMZ7sPYOHqmDyCJzcfNrUr3fGNKtezX14ykXOEIvyK81d+qydx89KY5O71FKMPaQ2vBfBFI5NHR63A==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "fast-deep-equal": "^3.1.3",
+ "fast-uri": "^3.0.1",
+ "json-schema-traverse": "^1.0.0",
+ "require-from-string": "^2.0.2"
+ },
+ "funding": {
+ "type": "github",
+ "url": "https://github.com/sponsors/epoberezkin"
+ }
+ },
+ "node_modules/ansi-align": {
+ "version": "3.0.1",
+ "resolved": "https://registry.npmjs.org/ansi-align/-/ansi-align-3.0.1.tgz",
+ "integrity": "sha512-IOfwwBF5iczOjp/WeY4YxyjqAFMQoZufdQWDd19SEExbVLNXqvpzSJ/M7Za4/sCPmQ0+GRquoA7bGcINcxew6w==",
+ "dev": true,
+ "license": "ISC",
+ "dependencies": {
+ "string-width": "^4.1.0"
+ }
+ },
+ "node_modules/ansi-align/node_modules/ansi-regex": {
+ "version": "5.0.1",
+ "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+ "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/ansi-align/node_modules/emoji-regex": {
+ "version": "8.0.0",
+ "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+ "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/ansi-align/node_modules/string-width": {
+ "version": "4.2.3",
+ "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+ "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "emoji-regex": "^8.0.0",
+ "is-fullwidth-code-point": "^3.0.0",
+ "strip-ansi": "^6.0.1"
+ },
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/ansi-align/node_modules/strip-ansi": {
+ "version": "6.0.1",
+ "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+ "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "ansi-regex": "^5.0.1"
+ },
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/ansi-regex": {
+ "version": "6.3.0",
+ "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.3.0.tgz",
+ "integrity": "sha512-WpDfL7NO6j7tH88IDBNVdUJxDh9nmCteAVW9dsep846XdwF4naCBK+/tGLX3KJgcpgMRXCFlTM2hKGoK9FsdrQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=12"
+ },
+ "funding": {
+ "url": "https://github.com/chalk/ansi-regex?sponsor=1"
+ }
+ },
+ "node_modules/ansi-styles": {
+ "version": "6.2.3",
+ "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz",
+ "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=12"
+ },
+ "funding": {
+ "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+ }
+ },
+ "node_modules/arch": {
+ "version": "2.2.0",
+ "resolved": "https://registry.npmjs.org/arch/-/arch-2.2.0.tgz",
+ "integrity": "sha512-Of/R0wqp83cgHozfIYLbBMnej79U/SVGOOyuB3VVFv1NRM/PSFMK12x9KVtiYzJqmnU5WR2qp0Z5rHb7sWGnFQ==",
+ "dev": true,
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/feross"
+ },
+ {
+ "type": "patreon",
+ "url": "https://www.patreon.com/feross"
+ },
+ {
+ "type": "consulting",
+ "url": "https://feross.org/support"
+ }
+ ],
+ "license": "MIT"
+ },
+ "node_modules/arg": {
+ "version": "5.0.2",
+ "resolved": "https://registry.npmjs.org/arg/-/arg-5.0.2.tgz",
+ "integrity": "sha512-PYjyFOLKQ9y57JvQ6QLo8dAgNqswh8M1RMJYdQduT6xbWSgK36P/Z/v+p888pM69jMMfS8Xd8F6I1kQ/I9HUGg==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/balanced-match": {
+ "version": "1.0.2",
+ "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+ "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/boxen": {
+ "version": "7.0.0",
+ "resolved": "https://registry.npmjs.org/boxen/-/boxen-7.0.0.tgz",
+ "integrity": "sha512-j//dBVuyacJbvW+tvZ9HuH03fZ46QcaKvvhZickZqtB271DxJ7SNRSNxrV/dZX0085m7hISRZWbzWlJvx/rHSg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "ansi-align": "^3.0.1",
+ "camelcase": "^7.0.0",
+ "chalk": "^5.0.1",
+ "cli-boxes": "^3.0.0",
+ "string-width": "^5.1.2",
+ "type-fest": "^2.13.0",
+ "widest-line": "^4.0.1",
+ "wrap-ansi": "^8.0.1"
+ },
+ "engines": {
+ "node": ">=14.16"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/brace-expansion": {
+ "version": "1.1.21",
+ "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.21.tgz",
+ "integrity": "sha512-9zeA+KLZNNzglF2TPKRQEDyx6Yby7daAkuy8MiPzpXPsYDWi/DRM8jmwUDxokQjYqBpv5DgPiwD4h4ZZSy1Ujw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "balanced-match": "^1.0.0",
+ "concat-map": "0.0.1"
+ }
+ },
+ "node_modules/bytes": {
+ "version": "3.1.2",
+ "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
+ "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.8"
+ }
+ },
+ "node_modules/camelcase": {
+ "version": "7.0.1",
+ "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-7.0.1.tgz",
+ "integrity": "sha512-xlx1yCK2Oc1APsPXDL2LdlNP6+uu8OCDdhOBSVT279M/S+y75O30C2VuD8T2ogdePBBl7PfPF4504tnLgX3zfw==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=14.16"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/chalk": {
+ "version": "5.0.1",
+ "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.0.1.tgz",
+ "integrity": "sha512-Fo07WOYGqMfCWHOzSXOt2CxDbC6skS/jO9ynEcmpANMoPrD+W1r1K6Vx7iNm+AQmETU1Xr2t+n8nzkV9t6xh3w==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": "^12.17.0 || ^14.13 || >=16.0.0"
+ },
+ "funding": {
+ "url": "https://github.com/chalk/chalk?sponsor=1"
+ }
+ },
+ "node_modules/chalk-template": {
+ "version": "0.4.0",
+ "resolved": "https://registry.npmjs.org/chalk-template/-/chalk-template-0.4.0.tgz",
+ "integrity": "sha512-/ghrgmhfY8RaSdeo43hNXxpoHAtxdbskUHjPpfqUWGttFgycUhYPGx3YZBCnUCvOa7Doivn1IZec3DEGFoMgLg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "chalk": "^4.1.2"
+ },
+ "engines": {
+ "node": ">=12"
+ },
+ "funding": {
+ "url": "https://github.com/chalk/chalk-template?sponsor=1"
+ }
+ },
+ "node_modules/chalk-template/node_modules/ansi-styles": {
+ "version": "4.3.0",
+ "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+ "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "color-convert": "^2.0.1"
+ },
+ "engines": {
+ "node": ">=8"
+ },
+ "funding": {
+ "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+ }
+ },
+ "node_modules/chalk-template/node_modules/chalk": {
+ "version": "4.1.2",
+ "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
+ "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "ansi-styles": "^4.1.0",
+ "supports-color": "^7.1.0"
+ },
+ "engines": {
+ "node": ">=10"
+ },
+ "funding": {
+ "url": "https://github.com/chalk/chalk?sponsor=1"
+ }
+ },
+ "node_modules/cli-boxes": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/cli-boxes/-/cli-boxes-3.0.0.tgz",
+ "integrity": "sha512-/lzGpEWL/8PfI0BmBOPRwp0c/wFNX1RdUML3jK/RcSBA9T8mZDdQpqYBKtCFTOfQbwPqWEOpjqW+Fnayc0969g==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=10"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/clipboardy": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/clipboardy/-/clipboardy-3.0.0.tgz",
+ "integrity": "sha512-Su+uU5sr1jkUy1sGRpLKjKrvEOVXgSgiSInwa/qeID6aJ07yh+5NWc3h2QfjHjBnfX4LhtFcuAWKUsJ3r+fjbg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "arch": "^2.2.0",
+ "execa": "^5.1.1",
+ "is-wsl": "^2.2.0"
+ },
+ "engines": {
+ "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/color-convert": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+ "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "color-name": "~1.1.4"
+ },
+ "engines": {
+ "node": ">=7.0.0"
+ }
+ },
+ "node_modules/color-name": {
+ "version": "1.1.4",
+ "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+ "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/compressible": {
+ "version": "2.0.18",
+ "resolved": "https://registry.npmjs.org/compressible/-/compressible-2.0.18.tgz",
+ "integrity": "sha512-AF3r7P5dWxL8MxyITRMlORQNaOA2IkAFaTr4k7BUumjPtRpGDTZpl0Pb1XCO6JeDCBdp126Cgs9sMxqSjgYyRg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "mime-db": ">= 1.43.0 < 2"
+ },
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
+ "node_modules/compression": {
+ "version": "1.8.1",
+ "resolved": "https://registry.npmjs.org/compression/-/compression-1.8.1.tgz",
+ "integrity": "sha512-9mAqGPHLakhCLeNyxPkK4xVo746zQ/czLH1Ky+vkitMnWfWZps8r0qXuwhwizagCRttsL4lfG4pIOvaWLpAP0w==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "bytes": "3.1.2",
+ "compressible": "~2.0.18",
+ "debug": "2.6.9",
+ "negotiator": "~0.6.4",
+ "on-headers": "~1.1.0",
+ "safe-buffer": "5.2.1",
+ "vary": "~1.1.2"
+ },
+ "engines": {
+ "node": ">= 0.8.0"
+ }
+ },
+ "node_modules/concat-map": {
+ "version": "0.0.1",
+ "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
+ "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/content-disposition": {
+ "version": "0.5.2",
+ "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.2.tgz",
+ "integrity": "sha512-kRGRZw3bLlFISDBgwTSA1TMBFN6J6GWDeubmDE3AF+3+yXL8hTWv8r5rkLbqYXY4RjPk/EzHnClI3zQf1cFmHA==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
+ "node_modules/cross-spawn": {
+ "version": "7.0.6",
+ "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
+ "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "path-key": "^3.1.0",
+ "shebang-command": "^2.0.0",
+ "which": "^2.0.1"
+ },
+ "engines": {
+ "node": ">= 8"
+ }
+ },
+ "node_modules/debug": {
+ "version": "2.6.9",
+ "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
+ "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "ms": "2.0.0"
+ }
+ },
+ "node_modules/deep-extend": {
+ "version": "0.6.0",
+ "resolved": "https://registry.npmjs.org/deep-extend/-/deep-extend-0.6.0.tgz",
+ "integrity": "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=4.0.0"
+ }
+ },
+ "node_modules/eastasianwidth": {
+ "version": "0.2.0",
+ "resolved": "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz",
+ "integrity": "sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/emoji-regex": {
+ "version": "9.2.2",
+ "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz",
+ "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/execa": {
+ "version": "5.1.1",
+ "resolved": "https://registry.npmjs.org/execa/-/execa-5.1.1.tgz",
+ "integrity": "sha512-8uSpZZocAZRBAPIEINJj3Lo9HyGitllczc27Eh5YYojjMFMn8yHMDMaUHE2Jqfq05D/wucwI4JGURyXt1vchyg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "cross-spawn": "^7.0.3",
+ "get-stream": "^6.0.0",
+ "human-signals": "^2.1.0",
+ "is-stream": "^2.0.0",
+ "merge-stream": "^2.0.0",
+ "npm-run-path": "^4.0.1",
+ "onetime": "^5.1.2",
+ "signal-exit": "^3.0.3",
+ "strip-final-newline": "^2.0.0"
+ },
+ "engines": {
+ "node": ">=10"
+ },
+ "funding": {
+ "url": "https://github.com/sindresorhus/execa?sponsor=1"
+ }
+ },
+ "node_modules/fast-deep-equal": {
+ "version": "3.1.3",
+ "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
+ "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/fast-uri": {
+ "version": "3.1.8",
+ "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.8.tgz",
+ "integrity": "sha512-GZMtZUTNRpOVIECoXwLNZS5xUGE+mVNbTB8h/7Rwh2TFWcBQiPzTgyZi05BF9UMZKkLJv8XBRJTlU7zg8+ZfMg==",
+ "dev": true,
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/fastify"
+ },
+ {
+ "type": "opencollective",
+ "url": "https://opencollective.com/fastify"
+ }
+ ],
+ "license": "BSD-3-Clause"
+ },
+ "node_modules/get-stream": {
+ "version": "6.0.1",
+ "resolved": "https://registry.npmjs.org/get-stream/-/get-stream-6.0.1.tgz",
+ "integrity": "sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=10"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/has-flag": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
+ "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/human-signals": {
+ "version": "2.1.0",
+ "resolved": "https://registry.npmjs.org/human-signals/-/human-signals-2.1.0.tgz",
+ "integrity": "sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "engines": {
+ "node": ">=10.17.0"
+ }
+ },
+ "node_modules/ini": {
+ "version": "1.3.8",
+ "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.8.tgz",
+ "integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==",
+ "dev": true,
+ "license": "ISC"
+ },
+ "node_modules/is-docker": {
+ "version": "2.2.1",
+ "resolved": "https://registry.npmjs.org/is-docker/-/is-docker-2.2.1.tgz",
+ "integrity": "sha512-F+i2BKsFrH66iaUFc0woD8sLy8getkwTwtOBjvs56Cx4CgJDeKQeqfz8wAYiSb8JOprWhHH5p77PbmYCvvUuXQ==",
+ "dev": true,
+ "license": "MIT",
+ "bin": {
+ "is-docker": "cli.js"
+ },
+ "engines": {
+ "node": ">=8"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/is-fullwidth-code-point": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
+ "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/is-port-reachable": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/is-port-reachable/-/is-port-reachable-4.0.0.tgz",
+ "integrity": "sha512-9UoipoxYmSk6Xy7QFgRv2HDyaysmgSG75TFQs6S+3pDM7ZhKTF/bskZV+0UlABHzKjNVhPjYCLfeZUEg1wXxig==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/is-stream": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/is-stream/-/is-stream-2.0.1.tgz",
+ "integrity": "sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=8"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/is-wsl": {
+ "version": "2.2.0",
+ "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-2.2.0.tgz",
+ "integrity": "sha512-fKzAra0rGJUUBwGBgNkHZuToZcn+TtXHpeCgmkMJMMYx1sQDYaCSyjJBSCa2nH1DGm7s3n1oBnohoVTBaN7Lww==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "is-docker": "^2.0.0"
+ },
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/isexe": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
+ "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
+ "dev": true,
+ "license": "ISC"
+ },
+ "node_modules/json-schema-traverse": {
+ "version": "1.0.0",
+ "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+ "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/merge-stream": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/merge-stream/-/merge-stream-2.0.0.tgz",
+ "integrity": "sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/mime-db": {
+ "version": "1.54.0",
+ "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.54.0.tgz",
+ "integrity": "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
+ "node_modules/mime-types": {
+ "version": "2.1.18",
+ "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.18.tgz",
+ "integrity": "sha512-lc/aahn+t4/SWV/qcmumYjymLsWfN3ELhpmVuUFjgsORruuZPVSwAQryq+HHGvO/SI2KVX26bx+En+zhM8g8hQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "mime-db": "~1.33.0"
+ },
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
+ "node_modules/mime-types/node_modules/mime-db": {
+ "version": "1.33.0",
+ "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.33.0.tgz",
+ "integrity": "sha512-BHJ/EKruNIqJf/QahvxwQZXKygOQ256myeN/Ew+THcAa5q+PjyTTMMeNQC4DZw5AwfvelsUrA6B67NKMqXDbzQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
+ "node_modules/mimic-fn": {
+ "version": "2.1.0",
+ "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-2.1.0.tgz",
+ "integrity": "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=6"
+ }
+ },
+ "node_modules/minimatch": {
+ "version": "3.1.5",
+ "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz",
+ "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==",
+ "dev": true,
+ "license": "ISC",
+ "dependencies": {
+ "brace-expansion": "^1.1.7"
+ },
+ "engines": {
+ "node": "*"
+ }
+ },
+ "node_modules/minimist": {
+ "version": "1.2.8",
+ "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz",
+ "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==",
+ "dev": true,
+ "license": "MIT",
+ "funding": {
+ "url": "https://github.com/sponsors/ljharb"
+ }
+ },
+ "node_modules/ms": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
+ "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/negotiator": {
+ "version": "0.6.4",
+ "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.4.tgz",
+ "integrity": "sha512-myRT3DiWPHqho5PrJaIRyaMv2kgYf0mUVgBNOYMuCH5Ki1yEiQaf/ZJuQ62nvpc44wL5WDbTX7yGJi1Neevw8w==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
+ "node_modules/npm-run-path": {
+ "version": "4.0.1",
+ "resolved": "https://registry.npmjs.org/npm-run-path/-/npm-run-path-4.0.1.tgz",
+ "integrity": "sha512-S48WzZW777zhNIrn7gxOlISNAqi9ZC/uQFnRdbeIHhZhCA6UqpkOT8T1G7BvfdgP4Er8gF4sUbaS0i7QvIfCWw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "path-key": "^3.0.0"
+ },
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/on-headers": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/on-headers/-/on-headers-1.1.0.tgz",
+ "integrity": "sha512-737ZY3yNnXy37FHkQxPzt4UZ2UWPWiCZWLvFZ4fu5cueciegX0zGPnrlY6bwRg4FdQOe9YU8MkmJwGhoMybl8A==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.8"
+ }
+ },
+ "node_modules/onetime": {
+ "version": "5.1.2",
+ "resolved": "https://registry.npmjs.org/onetime/-/onetime-5.1.2.tgz",
+ "integrity": "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "mimic-fn": "^2.1.0"
+ },
+ "engines": {
+ "node": ">=6"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/path-is-inside": {
+ "version": "1.0.2",
+ "resolved": "https://registry.npmjs.org/path-is-inside/-/path-is-inside-1.0.2.tgz",
+ "integrity": "sha512-DUWJr3+ULp4zXmol/SZkFf3JGsS9/SIv+Y3Rt93/UjPpDpklB5f1er4O3POIbUuUJ3FXgqte2Q7SrU6zAqwk8w==",
+ "dev": true,
+ "license": "(WTFPL OR MIT)"
+ },
+ "node_modules/path-key": {
+ "version": "3.1.1",
+ "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
+ "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/path-to-regexp": {
+ "version": "3.3.0",
+ "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-3.3.0.tgz",
+ "integrity": "sha512-qyCH421YQPS2WFDxDjftfc1ZR5WKQzVzqsp4n9M2kQhVOo/ByahFoUNJfl58kOcEGfQ//7weFTDhm+ss8Ecxgw==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/range-parser": {
+ "version": "1.2.0",
+ "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.0.tgz",
+ "integrity": "sha512-kA5WQoNVo4t9lNx2kQNFCxKeBl5IbbSNBl1M/tLkw9WCn+hxNBAW5Qh8gdhs63CJnhjJ2zQWFoqPJP2sK1AV5A==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
+ "node_modules/rc": {
+ "version": "1.2.8",
+ "resolved": "https://registry.npmjs.org/rc/-/rc-1.2.8.tgz",
+ "integrity": "sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw==",
+ "dev": true,
+ "license": "(BSD-2-Clause OR MIT OR Apache-2.0)",
+ "dependencies": {
+ "deep-extend": "^0.6.0",
+ "ini": "~1.3.0",
+ "minimist": "^1.2.0",
+ "strip-json-comments": "~2.0.1"
+ },
+ "bin": {
+ "rc": "cli.js"
+ }
+ },
+ "node_modules/registry-auth-token": {
+ "version": "3.3.2",
+ "resolved": "https://registry.npmjs.org/registry-auth-token/-/registry-auth-token-3.3.2.tgz",
+ "integrity": "sha512-JL39c60XlzCVgNrO+qq68FoNb56w/m7JYvGR2jT5iR1xBrUA3Mfx5Twk5rqTThPmQKMWydGmq8oFtDlxfrmxnQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "rc": "^1.1.6",
+ "safe-buffer": "^5.0.1"
+ }
+ },
+ "node_modules/registry-url": {
+ "version": "3.1.0",
+ "resolved": "https://registry.npmjs.org/registry-url/-/registry-url-3.1.0.tgz",
+ "integrity": "sha512-ZbgR5aZEdf4UKZVBPYIgaglBmSF2Hi94s2PcIHhRGFjKYu+chjJdYfHn4rt3hB6eCKLJ8giVIIfgMa1ehDfZKA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "rc": "^1.0.1"
+ },
+ "engines": {
+ "node": ">=0.10.0"
+ }
+ },
+ "node_modules/require-from-string": {
+ "version": "2.0.2",
+ "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+ "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=0.10.0"
+ }
+ },
+ "node_modules/safe-buffer": {
+ "version": "5.2.1",
+ "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
+ "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
+ "dev": true,
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/feross"
+ },
+ {
+ "type": "patreon",
+ "url": "https://www.patreon.com/feross"
+ },
+ {
+ "type": "consulting",
+ "url": "https://feross.org/support"
+ }
+ ],
+ "license": "MIT"
+ },
+ "node_modules/serve": {
+ "version": "14.2.6",
+ "resolved": "https://registry.npmjs.org/serve/-/serve-14.2.6.tgz",
+ "integrity": "sha512-QEjUSA+sD4Rotm1znR8s50YqA3kYpRGPmtd5GlFxbaL9n/FdUNbqMhxClqdditSk0LlZyA/dhud6XNRTOC9x2Q==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@zeit/schemas": "2.36.0",
+ "ajv": "8.18.0",
+ "arg": "5.0.2",
+ "boxen": "7.0.0",
+ "chalk": "5.0.1",
+ "chalk-template": "0.4.0",
+ "clipboardy": "3.0.0",
+ "compression": "1.8.1",
+ "is-port-reachable": "4.0.0",
+ "serve-handler": "6.1.7",
+ "update-check": "1.5.4"
+ },
+ "bin": {
+ "serve": "build/main.js"
+ },
+ "engines": {
+ "node": ">= 14"
+ }
+ },
+ "node_modules/serve-handler": {
+ "version": "6.1.7",
+ "resolved": "https://registry.npmjs.org/serve-handler/-/serve-handler-6.1.7.tgz",
+ "integrity": "sha512-CinAq1xWb0vR3twAv9evEU8cNWkXCb9kd5ePAHUKJBkOsUpR1wt/CvGdeca7vqumL1U5cSaeVQ6zZMxiJ3yWsg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "bytes": "3.0.0",
+ "content-disposition": "0.5.2",
+ "mime-types": "2.1.18",
+ "minimatch": "3.1.5",
+ "path-is-inside": "1.0.2",
+ "path-to-regexp": "3.3.0",
+ "range-parser": "1.2.0"
+ }
+ },
+ "node_modules/serve-handler/node_modules/bytes": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.0.0.tgz",
+ "integrity": "sha512-pMhOfFDPiv9t5jjIXkHosWmkSyQbvsgEVNkz0ERHbuLh2T/7j4Mqqpz523Fe8MVY89KC6Sh/QfS2sM+SjgFDcw==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.8"
+ }
+ },
+ "node_modules/shebang-command": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
+ "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "shebang-regex": "^3.0.0"
+ },
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/shebang-regex": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
+ "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/signal-exit": {
+ "version": "3.0.7",
+ "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz",
+ "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==",
+ "dev": true,
+ "license": "ISC"
+ },
+ "node_modules/string-width": {
+ "version": "5.1.2",
+ "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz",
+ "integrity": "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "eastasianwidth": "^0.2.0",
+ "emoji-regex": "^9.2.2",
+ "strip-ansi": "^7.0.1"
+ },
+ "engines": {
+ "node": ">=12"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/strip-ansi": {
+ "version": "7.2.0",
+ "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.2.0.tgz",
+ "integrity": "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "ansi-regex": "^6.2.2"
+ },
+ "engines": {
+ "node": ">=12"
+ },
+ "funding": {
+ "url": "https://github.com/chalk/strip-ansi?sponsor=1"
+ }
+ },
+ "node_modules/strip-final-newline": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/strip-final-newline/-/strip-final-newline-2.0.0.tgz",
+ "integrity": "sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=6"
+ }
+ },
+ "node_modules/strip-json-comments": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-2.0.1.tgz",
+ "integrity": "sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=0.10.0"
+ }
+ },
+ "node_modules/supports-color": {
+ "version": "7.2.0",
+ "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
+ "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "has-flag": "^4.0.0"
+ },
+ "engines": {
+ "node": ">=8"
+ }
+ },
+ "node_modules/type-fest": {
+ "version": "2.19.0",
+ "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-2.19.0.tgz",
+ "integrity": "sha512-RAH822pAdBgcNMAfWnCBU3CFZcfZ/i1eZjwFU/dsLKumyuuP3niueg2UAukXYF0E2AAoc82ZSSf9J0WQBinzHA==",
+ "dev": true,
+ "license": "(MIT OR CC0-1.0)",
+ "engines": {
+ "node": ">=12.20"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/update-check": {
+ "version": "1.5.4",
+ "resolved": "https://registry.npmjs.org/update-check/-/update-check-1.5.4.tgz",
+ "integrity": "sha512-5YHsflzHP4t1G+8WGPlvKbJEbAJGCgw+Em+dGR1KmBUbr1J36SJBqlHLjR7oob7sco5hWHGQVcr9B2poIVDDTQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "registry-auth-token": "3.3.2",
+ "registry-url": "3.1.0"
+ }
+ },
+ "node_modules/vary": {
+ "version": "1.1.2",
+ "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
+ "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.8"
+ }
+ },
+ "node_modules/which": {
+ "version": "2.0.2",
+ "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
+ "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
+ "dev": true,
+ "license": "ISC",
+ "dependencies": {
+ "isexe": "^2.0.0"
+ },
+ "bin": {
+ "node-which": "bin/node-which"
+ },
+ "engines": {
+ "node": ">= 8"
+ }
+ },
+ "node_modules/widest-line": {
+ "version": "4.0.1",
+ "resolved": "https://registry.npmjs.org/widest-line/-/widest-line-4.0.1.tgz",
+ "integrity": "sha512-o0cyEG0e8GPzT4iGHphIOh0cJOV8fivsXxddQasHPHfoZf1ZexrfeA21w2NaEN1RHE+fXlfISmOE8R9N3u3Qig==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "string-width": "^5.0.1"
+ },
+ "engines": {
+ "node": ">=12"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/sindresorhus"
+ }
+ },
+ "node_modules/wrap-ansi": {
+ "version": "8.1.0",
+ "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz",
+ "integrity": "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "ansi-styles": "^6.1.0",
+ "string-width": "^5.0.1",
+ "strip-ansi": "^7.0.1"
+ },
+ "engines": {
+ "node": ">=12"
+ },
+ "funding": {
+ "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+ }
+ }
+ }
+}
diff --git a/satellites/agent-starter/package.json b/satellites/agent-starter/package.json
new file mode 100644
index 000000000..2028627b3
--- /dev/null
+++ b/satellites/agent-starter/package.json
@@ -0,0 +1,19 @@
+{
+ "name": "threews-agent-starter",
+ "version": "1.0.0",
+ "private": true,
+ "description": "A one-click starter for putting an animated three.ws 3D agent on the web.",
+ "type": "module",
+ "scripts": {
+ "dev": "serve . -l 4173 --no-clipboard",
+ "check": "node scripts/check.mjs",
+ "test": "npm run check"
+ },
+ "devDependencies": {
+ "serve": "^14.2.4"
+ },
+ "engines": {
+ "node": ">=20"
+ },
+ "license": "Apache-2.0"
+}
diff --git a/satellites/agent-starter/scripts/check.mjs b/satellites/agent-starter/scripts/check.mjs
new file mode 100644
index 000000000..190806d69
--- /dev/null
+++ b/satellites/agent-starter/scripts/check.mjs
@@ -0,0 +1,26 @@
+import { access, readFile } from 'node:fs/promises';
+
+const required = [
+ 'index.html',
+ 'app.js',
+ 'styles.css',
+ 'README.md',
+ 'LEARN.md',
+ 'CONTRIBUTING.md',
+ '.devcontainer/devcontainer.json',
+];
+
+await Promise.all(required.map((file) => access(new URL(`../${file}`, import.meta.url))));
+
+const html = await readFile(new URL('../index.html', import.meta.url), 'utf8');
+const app = await readFile(new URL('../app.js', import.meta.url), 'utf8');
+const devcontainer = JSON.parse(await readFile(new URL('../.devcontainer/devcontainer.json', import.meta.url), 'utf8'));
+
+for (const expected of ['<agent-3d', 'https://three.ws/agent-3d/latest/agent-3d.js', 'data-action="wave"']) {
+ if (!html.includes(expected)) throw new Error(`index.html is missing ${expected}`);
+}
+if (!app.includes('customElements.whenDefined')) throw new Error('app.js does not wait for the component');
+if (!devcontainer.forwardPorts?.includes(4173)) throw new Error('the dev container does not forward port 4173');
+if (!String(devcontainer.postStartCommand).includes('npm run dev')) throw new Error('the dev container does not start the demo');
+
+console.log(`agent starter: ${required.length} required files and the live component wiring are valid`);
diff --git a/satellites/agent-starter/styles.css b/satellites/agent-starter/styles.css
new file mode 100644
index 000000000..d9db14cba
--- /dev/null
+++ b/satellites/agent-starter/styles.css
@@ -0,0 +1,250 @@
+:root {
+ color-scheme: dark;
+ font-family:
+ Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+ background: #09090f;
+ color: #f7f7fb;
+}
+
+* {
+ box-sizing: border-box;
+}
+
+body {
+ margin: 0;
+ min-width: 320px;
+ min-height: 100vh;
+ background:
+ radial-gradient(circle at 78% 18%, rgba(120, 72, 255, 0.24), transparent 32rem),
+ radial-gradient(circle at 14% 88%, rgba(0, 214, 170, 0.12), transparent 28rem), #09090f;
+}
+
+main {
+ display: grid;
+ grid-template-columns: minmax(0, 1fr) minmax(320px, 0.8fr);
+ gap: clamp(2rem, 7vw, 8rem);
+ align-items: center;
+ width: min(1180px, calc(100% - 2rem));
+ min-height: 100vh;
+ margin: 0 auto;
+ padding: 3rem 0;
+}
+
+.copy {
+ display: grid;
+ gap: 1.35rem;
+}
+
+.eyebrow,
+.step {
+ color: #9f87ff;
+ font-size: 0.78rem;
+ font-weight: 750;
+ letter-spacing: 0.12em;
+ text-transform: uppercase;
+}
+
+.eyebrow {
+ width: fit-content;
+ text-decoration: none;
+}
+
+h1 {
+ max-width: 10ch;
+ margin: 0;
+ font-size: clamp(3.2rem, 8vw, 6.8rem);
+ font-weight: 750;
+ letter-spacing: -0.075em;
+ line-height: 0.9;
+}
+
+.lede {
+ max-width: 57ch;
+ margin: 0;
+ color: #b8b7c4;
+ font-size: clamp(1rem, 2vw, 1.18rem);
+ line-height: 1.7;
+}
+
+.actions,
+nav {
+ display: flex;
+ flex-wrap: wrap;
+ gap: 0.75rem;
+}
+
+button,
+nav a {
+ border: 1px solid transparent;
+ border-radius: 999px;
+ font: inherit;
+ font-weight: 700;
+ transition:
+ transform 160ms ease,
+ background 160ms ease,
+ border-color 160ms ease;
+}
+
+button {
+ padding: 0.78rem 1.1rem;
+ background: #f7f7fb;
+ color: #11111a;
+ cursor: pointer;
+}
+
+button.secondary {
+ border-color: #373642;
+ background: #17161f;
+ color: #f7f7fb;
+}
+
+button:hover:not(:disabled),
+nav a:hover {
+ transform: translateY(-2px);
+}
+
+button:active:not(:disabled),
+nav a:active {
+ transform: translateY(0);
+}
+
+button:focus-visible,
+a:focus-visible {
+ outline: 3px solid #9f87ff;
+ outline-offset: 3px;
+}
+
+button:disabled {
+ cursor: progress;
+ opacity: 0.5;
+}
+
+.command-card {
+ display: flex;
+ gap: 1rem;
+ align-items: center;
+ justify-content: space-between;
+ padding: 1rem 1.1rem;
+ border: 1px solid #2d2c36;
+ border-radius: 1.1rem;
+ background: rgba(20, 19, 28, 0.78);
+ box-shadow: 0 1.5rem 4rem rgba(0, 0, 0, 0.22);
+}
+
+.command-card > div {
+ display: grid;
+ gap: 0.45rem;
+ min-width: 0;
+}
+
+code {
+ overflow-wrap: anywhere;
+ color: #f1efff;
+ font-size: 0.88rem;
+}
+
+.copy-button {
+ flex: none;
+}
+
+.status {
+ min-height: 1.4em;
+ margin: -0.65rem 0 0;
+ color: #8c8b98;
+ font-size: 0.86rem;
+}
+
+nav a {
+ padding: 0.55rem 0.8rem;
+ color: #c9c4df;
+ font-size: 0.86rem;
+ text-decoration: none;
+}
+
+.stage {
+ position: relative;
+ height: min(74vh, 680px);
+ min-height: 480px;
+ overflow: hidden;
+ border: 1px solid rgba(255, 255, 255, 0.11);
+ border-radius: 2rem;
+ background: linear-gradient(145deg, rgba(255, 255, 255, 0.08), rgba(255, 255, 255, 0.025));
+ box-shadow: 0 2rem 6rem rgba(0, 0, 0, 0.42);
+}
+
+.live-pill,
+.stage-caption {
+ position: absolute;
+ z-index: 2;
+ left: 1.25rem;
+ border: 1px solid rgba(255, 255, 255, 0.12);
+ background: rgba(9, 9, 15, 0.72);
+ backdrop-filter: blur(14px);
+}
+
+.live-pill {
+ top: 1.25rem;
+ display: flex;
+ gap: 0.55rem;
+ align-items: center;
+ padding: 0.55rem 0.75rem;
+ border-radius: 999px;
+ font-size: 0.76rem;
+ font-weight: 700;
+}
+
+.live-pill span {
+ width: 0.55rem;
+ height: 0.55rem;
+ border-radius: 50%;
+ background: #27e4aa;
+ box-shadow: 0 0 0.9rem #27e4aa;
+}
+
+.stage-caption {
+ right: 1.25rem;
+ bottom: 1.25rem;
+ margin: 0;
+ padding: 0.8rem 1rem;
+ border-radius: 0.9rem;
+ color: #d0ceda;
+ font-size: 0.8rem;
+ text-align: center;
+}
+
+@media (max-width: 820px) {
+ main {
+ grid-template-columns: 1fr;
+ padding: 3rem 0 1rem;
+ }
+
+ h1 {
+ max-width: 12ch;
+ }
+
+ .stage {
+ order: -1;
+ height: 52vh;
+ min-height: 390px;
+ }
+}
+
+@media (max-width: 480px) {
+ .command-card {
+ align-items: stretch;
+ flex-direction: column;
+ }
+
+ .copy-button {
+ width: 100%;
+ }
+}
+
+@media (prefers-reduced-motion: reduce) {
+ *,
+ *::before,
+ *::after {
+ scroll-behavior: auto !important;
+ transition-duration: 0.01ms !important;
+ }
+}
diff --git a/satellites/glb-quality-gate/.gitignore b/satellites/glb-quality-gate/.gitignore
new file mode 100644
index 000000000..eff0b4b0a
--- /dev/null
+++ b/satellites/glb-quality-gate/.gitignore
@@ -0,0 +1,3 @@
+node_modules/
+.DS_Store
+npm-debug.log*
diff --git a/satellites/glb-quality-gate/CONTRIBUTING.md b/satellites/glb-quality-gate/CONTRIBUTING.md
new file mode 100644
index 000000000..ef8d75722
--- /dev/null
+++ b/satellites/glb-quality-gate/CONTRIBUTING.md
@@ -0,0 +1,12 @@
+# Contributing
+
+Changes must preserve the Action's central contract: one report, one deterministic severity,
+and a useful failure message.
+
+1. Run `npm ci`.
+2. Run `npm test` and `npm run build`.
+3. Commit source and the resulting `dist/index.js` together.
+4. Describe the GLB lifecycle or structural case covered by the pull request.
+
+Never log the GitHub token or model bytes. Test behavioral changes against real serialized GLB
+documents, not mocked diff responses.
diff --git a/satellites/glb-quality-gate/README.md b/satellites/glb-quality-gate/README.md
new file mode 100644
index 000000000..f3968f996
--- /dev/null
+++ b/satellites/glb-quality-gate/README.md
@@ -0,0 +1,87 @@
+# three.ws GLB Quality Gate
+
+A GitHub Action that explains what changed inside every `.glb` modified by a pull request. It
+distinguishes harmless re-exports from changed materials, geometry, hierarchy, skeletons, and
+animation clips, then comments the result and writes the same report to the workflow summary.
+
+## Use it
+
+```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
+```
+
+No checkout step is required. The Action reads both model versions through the GitHub API,
+which also avoids incomplete shallow-clone comparisons.
+
+## Severity
+
+| Level | Meaning |
+| --- | --- |
+| `none` | The models are structurally identical. |
+| `cosmetic` | Metadata changed without an observable rendering change. |
+| `minor` | Appearance changed while the model's structure remained usable. |
+| `major` | Geometry or hierarchy changed and dependent content should be checked. |
+| `breaking` | A named mesh, material, joint, or animation dependency disappeared. |
+
+Added files are `minor`; removed files are `breaking`. Renames compare the previous path with
+the new path. The default threshold fails only at `breaking`.
+
+## Inputs and outputs
+
+| Name | Default | Purpose |
+| --- | --- | --- |
+| `github-token` | `github.token` | Reads the base/head files and creates or updates the report comment. |
+| `fail-on` | `breaking` | First severity that fails the job. |
+| `max-files` | `20` | Review cap for a single pull request, from 1 to 100. |
+| output `severity` | | Highest severity across reviewed models. |
+| output `files-checked` | | Number of GLB files included in the report. |
+
+Pull requests from forks may receive a read-only token. The Action still writes the workflow
+summary and applies the gate; it emits a warning when GitHub refuses the comment.
+
+## Development
+
+```bash
+npm ci
+npm test
+npm run build
+```
+
+`dist/index.js` is committed because JavaScript Actions execute the bundled file. The diff
+engine is the published [`@three-ws/glb-diff`](https://www.npmjs.com/package/@three-ws/glb-diff)
+package, the same engine used by the [visual model diff](https://three.ws/diff).
+
+## Release
+
+After tests and the bundle pass, tag a release and move the stable major tag:
+
+```bash
+git tag -a v1.0.0 -m "three.ws GLB Quality Gate v1.0.0"
+git tag -f v1 v1.0.0
+git push origin v1.0.0
+git push --force origin v1
+```
+
+The dedicated public repository and root `action.yml` make it eligible for publication in the
+[GitHub Marketplace](https://docs.github.com/en/actions/how-tos/create-and-publish-actions/publish-in-github-marketplace).
+
+## License
+
+Apache-2.0
diff --git a/satellites/glb-quality-gate/action.yml b/satellites/glb-quality-gate/action.yml
new file mode 100644
index 000000000..93bddcbc6
--- /dev/null
+++ b/satellites/glb-quality-gate/action.yml
@@ -0,0 +1,27 @@
+name: three.ws GLB Quality Gate
+description: Explain structural GLB changes in pull requests and stop breaking model regressions.
+author: three.ws
+branding:
+ icon: box
+ color: purple
+inputs:
+ github-token:
+ description: Token used to read model versions and write the pull request report.
+ required: true
+ default: ${{ github.token }}
+ fail-on:
+ description: Lowest severity that fails the check (none, cosmetic, minor, major, or breaking).
+ required: false
+ default: breaking
+ max-files:
+ description: Maximum number of changed GLB files reviewed in one pull request.
+ required: false
+ default: "20"
+outputs:
+ severity:
+ description: Highest severity found across every changed GLB file.
+ files-checked:
+ description: Number of changed GLB files included in the report.
+runs:
+ using: node20
+ main: dist/index.js
diff --git a/satellites/glb-quality-gate/package-lock.json b/satellites/glb-quality-gate/package-lock.json
new file mode 100644
index 000000000..e1cd1ab05
--- /dev/null
+++ b/satellites/glb-quality-gate/package-lock.json
@@ -0,0 +1,367 @@
+{
+ "name": "three-ws-glb-quality-gate",
+ "version": "1.0.0",
+ "lockfileVersion": 3,
+ "requires": true,
+ "packages": {
+ "": {
+ "name": "three-ws-glb-quality-gate",
+ "version": "1.0.0",
+ "license": "Apache-2.0",
+ "dependencies": {
+ "@actions/core": "^1.11.1",
+ "@actions/github": "^6.0.1",
+ "@three-ws/glb-diff": "^0.1.0"
+ },
+ "devDependencies": {
+ "@gltf-transform/core": "^4.4.0",
+ "@vercel/ncc": "^0.38.3"
+ },
+ "engines": {
+ "node": ">=20"
+ }
+ },
+ "node_modules/@actions/core": {
+ "version": "1.11.1",
+ "resolved": "https://registry.npmjs.org/@actions/core/-/core-1.11.1.tgz",
+ "integrity": "sha512-hXJCSrkwfA46Vd9Z3q4cpEpHB1rL5NG04+/rbqW9d3+CSvtB1tYe8UTpAlixa1vj0m/ULglfEK2UKxMGxCxv5A==",
+ "license": "MIT",
+ "dependencies": {
+ "@actions/exec": "^1.1.1",
+ "@actions/http-client": "^2.0.1"
+ }
+ },
+ "node_modules/@actions/exec": {
+ "version": "1.1.1",
+ "resolved": "https://registry.npmjs.org/@actions/exec/-/exec-1.1.1.tgz",
+ "integrity": "sha512-+sCcHHbVdk93a0XT19ECtO/gIXoxvdsgQLzb2fE2/5sIZmWQuluYyjPQtrtTHdU1YzTZ7bAPN4sITq2xi1679w==",
+ "license": "MIT",
+ "dependencies": {
+ "@actions/io": "^1.0.1"
+ }
+ },
+ "node_modules/@actions/github": {
+ "version": "6.0.1",
+ "resolved": "https://registry.npmjs.org/@actions/github/-/github-6.0.1.tgz",
+ "integrity": "sha512-xbZVcaqD4XnQAe35qSQqskb3SqIAfRyLBrHMd/8TuL7hJSz2QtbDwnNM8zWx4zO5l2fnGtseNE3MbEvD7BxVMw==",
+ "license": "MIT",
+ "dependencies": {
+ "@actions/http-client": "^2.2.0",
+ "@octokit/core": "^5.0.1",
+ "@octokit/plugin-paginate-rest": "^9.2.2",
+ "@octokit/plugin-rest-endpoint-methods": "^10.4.0",
+ "@octokit/request": "^8.4.1",
+ "@octokit/request-error": "^5.1.1",
+ "undici": "^5.28.5"
+ }
+ },
+ "node_modules/@actions/http-client": {
+ "version": "2.2.3",
+ "resolved": "https://registry.npmjs.org/@actions/http-client/-/http-client-2.2.3.tgz",
+ "integrity": "sha512-mx8hyJi/hjFvbPokCg4uRd4ZX78t+YyRPtnKWwIl+RzNaVuFpQHfmlGVfsKEJN8LwTCvL+DfVgAM04XaHkm6bA==",
+ "license": "MIT",
+ "dependencies": {
+ "tunnel": "^0.0.6",
+ "undici": "^5.25.4"
+ }
+ },
+ "node_modules/@actions/io": {
+ "version": "1.1.3",
+ "resolved": "https://registry.npmjs.org/@actions/io/-/io-1.1.3.tgz",
+ "integrity": "sha512-wi9JjgKLYS7U/z8PPbco+PvTb/nRWjeoFlJ1Qer83k/3C5PHQi28hiVdeE2kHXmIL99mQFawx8qt/JPjZilJ8Q==",
+ "license": "MIT"
+ },
+ "node_modules/@fastify/busboy": {
+ "version": "2.1.1",
+ "resolved": "https://registry.npmjs.org/@fastify/busboy/-/busboy-2.1.1.tgz",
+ "integrity": "sha512-vBZP4NlzfOlerQTnba4aqZoMhE/a9HY7HRqoOPaETQcSQuWEIyZMHGfVu6w9wGtGK5fED5qRs2DteVCjOH60sA==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=14"
+ }
+ },
+ "node_modules/@gltf-transform/core": {
+ "version": "4.5.0",
+ "resolved": "https://registry.npmjs.org/@gltf-transform/core/-/core-4.5.0.tgz",
+ "integrity": "sha512-JlvShvnB4AtfGZqjnESS/wfPJbpVnyHhTwJBbWN4qXqkB3C5HIoxxpu/orwGBge6Pc0zObeWj70lVf+4gbuu0A==",
+ "license": "MIT",
+ "dependencies": {
+ "property-graph": "^4.1.0"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/donmccurdy"
+ }
+ },
+ "node_modules/@gltf-transform/extensions": {
+ "version": "4.5.0",
+ "resolved": "https://registry.npmjs.org/@gltf-transform/extensions/-/extensions-4.5.0.tgz",
+ "integrity": "sha512-J4cKzrmEr75YkrtdI4cKosBg2vDC4rT56aq/QoijW7GT1Y9gSEMJbqyFO9xcFO3FNpZaZiDrHWUqE5Okrl5nOQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@gltf-transform/core": "^4.5.0",
+ "ktx-parse": "^1.1.0"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/donmccurdy"
+ }
+ },
+ "node_modules/@octokit/auth-token": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/@octokit/auth-token/-/auth-token-4.0.0.tgz",
+ "integrity": "sha512-tY/msAuJo6ARbK6SPIxZrPBms3xPbfwBrulZe0Wtr/DIY9lje2HeV1uoebShn6mx7SjCHif6EjMvoREj+gZ+SA==",
+ "license": "MIT",
+ "engines": {
+ "node": ">= 18"
+ }
+ },
+ "node_modules/@octokit/core": {
+ "version": "5.2.2",
+ "resolved": "https://registry.npmjs.org/@octokit/core/-/core-5.2.2.tgz",
+ "integrity": "sha512-/g2d4sW9nUDJOMz3mabVQvOGhVa4e/BN/Um7yca9Bb2XTzPPnfTWHWQg+IsEYO7M3Vx+EXvaM/I2pJWIMun1bg==",
+ "license": "MIT",
+ "dependencies": {
+ "@octokit/auth-token": "^4.0.0",
+ "@octokit/graphql": "^7.1.0",
+ "@octokit/request": "^8.4.1",
+ "@octokit/request-error": "^5.1.1",
+ "@octokit/types": "^13.0.0",
+ "before-after-hook": "^2.2.0",
+ "universal-user-agent": "^6.0.0"
+ },
+ "engines": {
+ "node": ">= 18"
+ }
+ },
+ "node_modules/@octokit/endpoint": {
+ "version": "9.0.6",
+ "resolved": "https://registry.npmjs.org/@octokit/endpoint/-/endpoint-9.0.6.tgz",
+ "integrity": "sha512-H1fNTMA57HbkFESSt3Y9+FBICv+0jFceJFPWDePYlR/iMGrwM5ph+Dd4XRQs+8X+PUFURLQgX9ChPfhJ/1uNQw==",
+ "license": "MIT",
+ "dependencies": {
+ "@octokit/types": "^13.1.0",
+ "universal-user-agent": "^6.0.0"
+ },
+ "engines": {
+ "node": ">= 18"
+ }
+ },
+ "node_modules/@octokit/graphql": {
+ "version": "7.1.1",
+ "resolved": "https://registry.npmjs.org/@octokit/graphql/-/graphql-7.1.1.tgz",
+ "integrity": "sha512-3mkDltSfcDUoa176nlGoA32RGjeWjl3K7F/BwHwRMJUW/IteSa4bnSV8p2ThNkcIcZU2umkZWxwETSSCJf2Q7g==",
+ "license": "MIT",
+ "dependencies": {
+ "@octokit/request": "^8.4.1",
+ "@octokit/types": "^13.0.0",
+ "universal-user-agent": "^6.0.0"
+ },
+ "engines": {
+ "node": ">= 18"
+ }
+ },
+ "node_modules/@octokit/openapi-types": {
+ "version": "24.2.0",
+ "resolved": "https://registry.npmjs.org/@octokit/openapi-types/-/openapi-types-24.2.0.tgz",
+ "integrity": "sha512-9sIH3nSUttelJSXUrmGzl7QUBFul0/mB8HRYl3fOlgHbIWG+WnYDXU3v/2zMtAvuzZ/ed00Ei6on975FhBfzrg==",
+ "license": "MIT"
+ },
+ "node_modules/@octokit/plugin-paginate-rest": {
+ "version": "9.2.2",
+ "resolved": "https://registry.npmjs.org/@octokit/plugin-paginate-rest/-/plugin-paginate-rest-9.2.2.tgz",
+ "integrity": "sha512-u3KYkGF7GcZnSD/3UP0S7K5XUFT2FkOQdcfXZGZQPGv3lm4F2Xbf71lvjldr8c1H3nNbF+33cLEkWYbokGWqiQ==",
+ "license": "MIT",
+ "dependencies": {
+ "@octokit/types": "^12.6.0"
+ },
+ "engines": {
+ "node": ">= 18"
+ },
+ "peerDependencies": {
+ "@octokit/core": "5"
+ }
+ },
+ "node_modules/@octokit/plugin-paginate-rest/node_modules/@octokit/openapi-types": {
+ "version": "20.0.0",
+ "resolved": "https://registry.npmjs.org/@octokit/openapi-types/-/openapi-types-20.0.0.tgz",
+ "integrity": "sha512-EtqRBEjp1dL/15V7WiX5LJMIxxkdiGJnabzYx5Apx4FkQIFgAfKumXeYAqqJCj1s+BMX4cPFIFC4OLCR6stlnA==",
+ "license": "MIT"
+ },
+ "node_modules/@octokit/plugin-paginate-rest/node_modules/@octokit/types": {
+ "version": "12.6.0",
+ "resolved": "https://registry.npmjs.org/@octokit/types/-/types-12.6.0.tgz",
+ "integrity": "sha512-1rhSOfRa6H9w4YwK0yrf5faDaDTb+yLyBUKOCV4xtCDB5VmIPqd/v9yr9o6SAzOAlRxMiRiCic6JVM1/kunVkw==",
+ "license": "MIT",
+ "dependencies": {
+ "@octokit/openapi-types": "^20.0.0"
+ }
+ },
+ "node_modules/@octokit/plugin-rest-endpoint-methods": {
+ "version": "10.4.1",
+ "resolved": "https://registry.npmjs.org/@octokit/plugin-rest-endpoint-methods/-/plugin-rest-endpoint-methods-10.4.1.tgz",
+ "integrity": "sha512-xV1b+ceKV9KytQe3zCVqjg+8GTGfDYwaT1ATU5isiUyVtlVAO3HNdzpS4sr4GBx4hxQ46s7ITtZrAsxG22+rVg==",
+ "license": "MIT",
+ "dependencies": {
+ "@octokit/types": "^12.6.0"
+ },
+ "engines": {
+ "node": ">= 18"
+ },
+ "peerDependencies": {
+ "@octokit/core": "5"
+ }
+ },
+ "node_modules/@octokit/plugin-rest-endpoint-methods/node_modules/@octokit/openapi-types": {
+ "version": "20.0.0",
+ "resolved": "https://registry.npmjs.org/@octokit/openapi-types/-/openapi-types-20.0.0.tgz",
+ "integrity": "sha512-EtqRBEjp1dL/15V7WiX5LJMIxxkdiGJnabzYx5Apx4FkQIFgAfKumXeYAqqJCj1s+BMX4cPFIFC4OLCR6stlnA==",
+ "license": "MIT"
+ },
+ "node_modules/@octokit/plugin-rest-endpoint-methods/node_modules/@octokit/types": {
+ "version": "12.6.0",
+ "resolved": "https://registry.npmjs.org/@octokit/types/-/types-12.6.0.tgz",
+ "integrity": "sha512-1rhSOfRa6H9w4YwK0yrf5faDaDTb+yLyBUKOCV4xtCDB5VmIPqd/v9yr9o6SAzOAlRxMiRiCic6JVM1/kunVkw==",
+ "license": "MIT",
+ "dependencies": {
+ "@octokit/openapi-types": "^20.0.0"
+ }
+ },
+ "node_modules/@octokit/request": {
+ "version": "8.4.1",
+ "resolved": "https://registry.npmjs.org/@octokit/request/-/request-8.4.1.tgz",
+ "integrity": "sha512-qnB2+SY3hkCmBxZsR/MPCybNmbJe4KAlfWErXq+rBKkQJlbjdJeS85VI9r8UqeLYLvnAenU8Q1okM/0MBsAGXw==",
+ "license": "MIT",
+ "dependencies": {
+ "@octokit/endpoint": "^9.0.6",
+ "@octokit/request-error": "^5.1.1",
+ "@octokit/types": "^13.1.0",
+ "universal-user-agent": "^6.0.0"
+ },
+ "engines": {
+ "node": ">= 18"
+ }
+ },
+ "node_modules/@octokit/request-error": {
+ "version": "5.1.1",
+ "resolved": "https://registry.npmjs.org/@octokit/request-error/-/request-error-5.1.1.tgz",
+ "integrity": "sha512-v9iyEQJH6ZntoENr9/yXxjuezh4My67CBSu9r6Ve/05Iu5gNgnisNWOsoJHTP6k0Rr0+HQIpnH+kyammu90q/g==",
+ "license": "MIT",
+ "dependencies": {
+ "@octokit/types": "^13.1.0",
+ "deprecation": "^2.0.0",
+ "once": "^1.4.0"
+ },
+ "engines": {
+ "node": ">= 18"
+ }
+ },
+ "node_modules/@octokit/types": {
+ "version": "13.10.0",
+ "resolved": "https://registry.npmjs.org/@octokit/types/-/types-13.10.0.tgz",
+ "integrity": "sha512-ifLaO34EbbPj0Xgro4G5lP5asESjwHracYJvVaPIyXMuiuXLlhic3S47cBdTb+jfODkTE5YtGCLt3Ay3+J97sA==",
+ "license": "MIT",
+ "dependencies": {
+ "@octokit/openapi-types": "^24.2.0"
+ }
+ },
+ "node_modules/@three-ws/glb-diff": {
+ "version": "0.1.0",
+ "resolved": "https://registry.npmjs.org/@three-ws/glb-diff/-/glb-diff-0.1.0.tgz",
+ "integrity": "sha512-WR2ohbzgGmq9p9QAEhHhoQJ1KjCaQw3TrFw0Poh+43MzOHyUTA6z919RJg6a+/ZMY+r8EMvSvU85FJWfNi1ltg==",
+ "license": "Apache-2.0",
+ "dependencies": {
+ "@gltf-transform/core": "^4.4.0",
+ "@gltf-transform/extensions": "^4.4.0"
+ },
+ "bin": {
+ "glb-diff": "src/cli.js"
+ },
+ "engines": {
+ "node": ">=18"
+ },
+ "peerDependencies": {
+ "meshoptimizer": "^1.1.1"
+ },
+ "peerDependenciesMeta": {
+ "meshoptimizer": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/@vercel/ncc": {
+ "version": "0.38.4",
+ "resolved": "https://registry.npmjs.org/@vercel/ncc/-/ncc-0.38.4.tgz",
+ "integrity": "sha512-8LwjnlP39s08C08J5NstzriPvW1SP8Zfpp1BvC2sI35kPeZnHfxVkCwu4/+Wodgnd60UtT1n8K8zw+Mp7J9JmQ==",
+ "dev": true,
+ "license": "MIT",
+ "bin": {
+ "ncc": "dist/ncc/cli.js"
+ }
+ },
+ "node_modules/before-after-hook": {
+ "version": "2.2.3",
+ "resolved": "https://registry.npmjs.org/before-after-hook/-/before-after-hook-2.2.3.tgz",
+ "integrity": "sha512-NzUnlZexiaH/46WDhANlyR2bXRopNg4F/zuSA3OpZnllCUgRaOF2znDioDWrmbNVsuZk6l9pMquQB38cfBZwkQ==",
+ "license": "Apache-2.0"
+ },
+ "node_modules/deprecation": {
+ "version": "2.3.1",
+ "resolved": "https://registry.npmjs.org/deprecation/-/deprecation-2.3.1.tgz",
+ "integrity": "sha512-xmHIy4F3scKVwMsQ4WnVaS8bHOx0DmVwRywosKhaILI0ywMDWPtBSku2HNxRvF7jtwDRsoEwYQSfbxj8b7RlJQ==",
+ "license": "ISC"
+ },
+ "node_modules/ktx-parse": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/ktx-parse/-/ktx-parse-1.1.0.tgz",
+ "integrity": "sha512-mKp3y+FaYgR7mXWAbyyzpa/r1zDWeaunH+INJO4fou3hb45XuNSwar+7llrRyvpMWafxSIi99RNFJ05MHedaJQ==",
+ "license": "MIT"
+ },
+ "node_modules/once": {
+ "version": "1.4.0",
+ "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
+ "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==",
+ "license": "ISC",
+ "dependencies": {
+ "wrappy": "1"
+ }
+ },
+ "node_modules/property-graph": {
+ "version": "4.1.0",
+ "resolved": "https://registry.npmjs.org/property-graph/-/property-graph-4.1.0.tgz",
+ "integrity": "sha512-AvPcP7XECNWy4LGmFQ77k7un4lSKM4eS29PTvW4ck95uYeLxXPWJM7hLuBqK91FaHqCcgJvIUCuNJjjxKE7VKQ==",
+ "license": "MIT"
+ },
+ "node_modules/tunnel": {
+ "version": "0.0.6",
+ "resolved": "https://registry.npmjs.org/tunnel/-/tunnel-0.0.6.tgz",
+ "integrity": "sha512-1h/Lnq9yajKY2PEbBadPXj3VxsDDu844OnaAo52UVmIzIvwwtBPIuNvkjuzBlTWpfJyUbG3ez0KSBibQkj4ojg==",
+ "license": "MIT",
+ "engines": {
+ "node": ">=0.6.11 <=0.7.0 || >=0.7.3"
+ }
+ },
+ "node_modules/undici": {
+ "version": "5.29.0",
+ "resolved": "https://registry.npmjs.org/undici/-/undici-5.29.0.tgz",
+ "integrity": "sha512-raqeBD6NQK4SkWhQzeYKd1KmIG6dllBOTt55Rmkt4HtI9mwdWtJljnrXjAFUBLTSN67HWrOIZ3EPF4kjUw80Bg==",
+ "license": "MIT",
+ "dependencies": {
+ "@fastify/busboy": "^2.0.0"
+ },
+ "engines": {
+ "node": ">=14.0"
+ }
+ },
+ "node_modules/universal-user-agent": {
+ "version": "6.0.1",
+ "resolved": "https://registry.npmjs.org/universal-user-agent/-/universal-user-agent-6.0.1.tgz",
+ "integrity": "sha512-yCzhz6FN2wU1NiiQRogkTQszlQSlpWaw8SvVegAc+bDxbzHgh1vX8uIe8OYyMH6DwH+sdTJsgMl36+mSMdRJIQ==",
+ "license": "ISC"
+ },
+ "node_modules/wrappy": {
+ "version": "1.0.2",
+ "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
+ "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
+ "license": "ISC"
+ }
+ }
+}
diff --git a/satellites/glb-quality-gate/package.json b/satellites/glb-quality-gate/package.json
new file mode 100644
index 000000000..21a504b58
--- /dev/null
+++ b/satellites/glb-quality-gate/package.json
@@ -0,0 +1,25 @@
+{
+ "name": "three-ws-glb-quality-gate",
+ "version": "1.0.0",
+ "private": true,
+ "description": "A GitHub Action that explains structural changes to GLB files in pull requests.",
+ "type": "module",
+ "scripts": {
+ "build": "ncc build src/index.js -o dist --minify --source-map",
+ "check": "node --check src/index.js && node --check src/report.js",
+ "test": "node --test"
+ },
+ "dependencies": {
+ "@actions/core": "^1.11.1",
+ "@actions/github": "^6.0.1",
+ "@three-ws/glb-diff": "^0.1.0"
+ },
+ "devDependencies": {
+ "@gltf-transform/core": "^4.4.0",
+ "@vercel/ncc": "^0.38.3"
+ },
+ "engines": {
+ "node": ">=20"
+ },
+ "license": "Apache-2.0"
+}
diff --git a/satellites/glb-quality-gate/src/index.js b/satellites/glb-quality-gate/src/index.js
new file mode 100644
index 000000000..393352758
--- /dev/null
+++ b/satellites/glb-quality-gate/src/index.js
@@ -0,0 +1,110 @@
+import * as core from '@actions/core';
+import * as github from '@actions/github';
+import { atLeast, diffModels, formatMarkdown } from '@three-ws/glb-diff';
+import {
+ COMMENT_MARKER,
+ aggregateSeverity,
+ buildReport,
+ selectGlbChanges,
+ severityForStatus,
+ validateFailOn,
+ validateMaxFiles,
+} from './report.js';
+
+function requirePullRequest() {
+ const pull = github.context.payload.pull_request;
+ if (!pull) throw new Error('three.ws GLB Quality Gate runs on pull_request events');
+ return pull;
+}
+
+function encodedPath(path) {
+ return path.split('/').map(encodeURIComponent).join('/');
+}
+
+async function fetchFile({ owner, repo, path, ref, token }) {
+ const url = `https://api.github.com/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/contents/${encodedPath(path)}?ref=${encodeURIComponent(ref)}`;
+ const response = await fetch(url, {
+ headers: {
+ accept: 'application/vnd.github.raw',
+ authorization: `Bearer ${token}`,
+ 'user-agent': 'three-ws-glb-quality-gate',
+ 'x-github-api-version': '2022-11-28',
+ },
+ });
+ if (!response.ok) throw new Error(`GitHub could not read ${path} at ${ref.slice(0, 8)} (${response.status})`);
+ return new Uint8Array(await response.arrayBuffer());
+}
+
+async function inspectChange(change, context) {
+ if (change.status === 'added') {
+ return { ...change, severity: severityForStatus(change.status), outcome: 'New model added', markdown: '' };
+ }
+ if (change.status === 'removed') {
+ return { ...change, severity: severityForStatus(change.status), outcome: 'Model removed', markdown: '' };
+ }
+
+ const [before, after] = await Promise.all([
+ fetchFile({ ...context, path: change.basePath, ref: context.baseRef }),
+ fetchFile({ ...context, path: change.path, ref: context.headRef }),
+ ]);
+ const changes = await diffModels(before, after, { nameA: change.basePath, nameB: change.path });
+ return {
+ ...change,
+ severity: changes.severity,
+ outcome: changes.identical ? 'Structurally identical' : `${changes.summary.changed} structural changes`,
+ markdown: formatMarkdown(changes),
+ };
+}
+
+async function writeOrUpdateComment(octokit, owner, repo, issueNumber, body) {
+ try {
+ const comments = await octokit.paginate(octokit.rest.issues.listComments, {
+ owner,
+ repo,
+ issue_number: issueNumber,
+ per_page: 100,
+ });
+ const previous = comments.find(
+ (comment) => comment.user?.type === 'Bot' && String(comment.body).includes(COMMENT_MARKER),
+ );
+ if (previous) {
+ await octokit.rest.issues.updateComment({ owner, repo, comment_id: previous.id, body });
+ } else {
+ await octokit.rest.issues.createComment({ owner, repo, issue_number: issueNumber, body });
+ }
+ } catch (error) {
+ core.warning(`The report could not be written as a pull request comment: ${error.message}`);
+ }
+}
+
+async function run() {
+ const pull = requirePullRequest();
+ const token = core.getInput('github-token', { required: true });
+ const failOn = validateFailOn(core.getInput('fail-on'));
+ const maxFiles = validateMaxFiles(core.getInput('max-files'));
+ const { owner, repo } = github.context.repo;
+ const octokit = github.getOctokit(token);
+ const files = await octokit.paginate(octokit.rest.pulls.listFiles, {
+ owner,
+ repo,
+ pull_number: pull.number,
+ per_page: 100,
+ });
+ const selected = selectGlbChanges(files, maxFiles);
+ const context = { owner, repo, token, baseRef: pull.base.sha, headRef: pull.head.sha };
+ const results = [];
+ for (const change of selected.changes) results.push(await inspectChange(change, context));
+
+ const severity = aggregateSeverity(results);
+ const report = buildReport({ results, omitted: selected.omitted, failOn });
+ core.setOutput('severity', severity);
+ core.setOutput('files-checked', results.length);
+ await core.summary.addRaw(report).write();
+ await writeOrUpdateComment(octokit, owner, repo, pull.number, report);
+
+ if (results.length && atLeast(severity, failOn)) {
+ core.setFailed(`GLB changes reached ${severity}, which meets the ${failOn} failure threshold`);
+ }
+}
+
+run().catch((error) => core.setFailed(error instanceof Error ? error.message : String(error)));
diff --git a/satellites/glb-quality-gate/src/report.js b/satellites/glb-quality-gate/src/report.js
new file mode 100644
index 000000000..ce59922bc
--- /dev/null
+++ b/satellites/glb-quality-gate/src/report.js
@@ -0,0 +1,90 @@
+import { maxSeverity } from '@three-ws/glb-diff';
+
+export const COMMENT_MARKER = '<!-- three-ws-glb-quality-gate -->';
+export const SEVERITIES = ['none', 'cosmetic', 'minor', 'major', 'breaking'];
+
+export function validateFailOn(value) {
+ const normalized = String(value || '').trim().toLowerCase();
+ if (!SEVERITIES.includes(normalized)) {
+ throw new Error(`fail-on must be one of: ${SEVERITIES.join(', ')}`);
+ }
+ return normalized;
+}
+
+export function validateMaxFiles(value) {
+ const parsed = Number.parseInt(String(value), 10);
+ if (!Number.isInteger(parsed) || parsed < 1 || parsed > 100) {
+ throw new Error('max-files must be an integer from 1 to 100');
+ }
+ return parsed;
+}
+
+export function selectGlbChanges(files, maxFiles) {
+ const changes = files
+ .filter((file) => file.filename.toLowerCase().endsWith('.glb'))
+ .map((file) => ({
+ path: file.filename,
+ basePath: file.status === 'renamed' ? file.previous_filename : file.filename,
+ status: file.status,
+ }));
+ return { changes: changes.slice(0, maxFiles), omitted: Math.max(0, changes.length - maxFiles) };
+}
+
+export function severityForStatus(status) {
+ if (status === 'removed') return 'breaking';
+ if (status === 'added') return 'minor';
+ return 'none';
+}
+
+export function aggregateSeverity(results) {
+ return maxSeverity(results.map((result) => result.severity));
+}
+
+function safeCode(value) {
+ return `\`${String(value).replaceAll('`', 'ˋ').replaceAll('|', '\\|')}\``;
+}
+
+function icon(severity) {
+ return {
+ none: '✅',
+ cosmetic: '🟦',
+ minor: '🟨',
+ major: '🟧',
+ breaking: '🛑',
+ }[severity];
+}
+
+export function buildReport({ results, omitted = 0, failOn }) {
+ const severity = aggregateSeverity(results);
+ const summary = results.length
+ ? `Reviewed **${results.length}** changed GLB file${results.length === 1 ? '' : 's'}. Highest severity: **${severity}**.`
+ : 'No changed GLB files were found in this pull request.';
+ const rows = results.map(
+ (result) => `| ${icon(result.severity)} ${safeCode(result.path)} | **${result.severity}** | ${result.outcome} |`,
+ );
+ const details = results
+ .filter((result) => result.markdown)
+ .map(
+ (result) =>
+ `<details>\n<summary>${icon(result.severity)} ${safeCode(result.path)} details</summary>\n\n${result.markdown}\n\n</details>`,
+ )
+ .join('\n\n');
+ const omittedNote = omitted
+ ? `\n\n> ${omitted} additional GLB file${omitted === 1 ? ' was' : 's were'} omitted by the configured limit.`
+ : '';
+
+ return [
+ COMMENT_MARKER,
+ '## three.ws GLB Quality Gate',
+ '',
+ summary,
+ '',
+ '| File | Severity | Result |',
+ '| --- | --- | --- |',
+ ...(rows.length ? rows : ['| No GLB changes | **none** | Nothing to review |']),
+ omittedNote,
+ details ? `\n${details}` : '',
+ '',
+ `Gate threshold: **${failOn}**. [Inspect models visually](https://three.ws/diff) or [use the CLI](https://www.npmjs.com/package/@three-ws/glb-diff).`,
+ ].join('\n');
+}
diff --git a/satellites/glb-quality-gate/test/report.test.js b/satellites/glb-quality-gate/test/report.test.js
new file mode 100644
index 000000000..405c6db8d
--- /dev/null
+++ b/satellites/glb-quality-gate/test/report.test.js
@@ -0,0 +1,74 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { Document, NodeIO } from '@gltf-transform/core';
+import { diffModels } from '@three-ws/glb-diff';
+import {
+ COMMENT_MARKER,
+ aggregateSeverity,
+ buildReport,
+ selectGlbChanges,
+ severityForStatus,
+ validateFailOn,
+ validateMaxFiles,
+} from '../src/report.js';
+
+function model({ mesh = 'Body', x = 0 } = {}) {
+ const document = new Document();
+ const buffer = document.createBuffer();
+ const position = document
+ .createAccessor()
+ .setType('VEC3')
+ .setArray(new Float32Array([x, 0, 0, 1, 0, 0, 0, 1, 0]))
+ .setBuffer(buffer);
+ const primitive = document.createPrimitive().setAttribute('POSITION', position);
+ const node = document.createNode('Root').setMesh(document.createMesh(mesh).addPrimitive(primitive));
+ document.createScene('Scene').addChild(node);
+ return new NodeIO().writeBinary(document);
+}
+
+test('validates user inputs', () => {
+ assert.equal(validateFailOn('Major'), 'major');
+ assert.equal(validateMaxFiles('20'), 20);
+ assert.throws(() => validateFailOn('urgent'), /fail-on/);
+ assert.throws(() => validateMaxFiles('0'), /max-files/);
+});
+
+test('selects GLB files and preserves rename paths', () => {
+ const selected = selectGlbChanges(
+ [
+ { filename: 'models/new.glb', status: 'renamed', previous_filename: 'models/old.glb' },
+ { filename: 'README.md', status: 'modified' },
+ { filename: 'models/second.GLB', status: 'added' },
+ ],
+ 1,
+ );
+ assert.deepEqual(selected.changes, [
+ { path: 'models/new.glb', basePath: 'models/old.glb', status: 'renamed' },
+ ]);
+ assert.equal(selected.omitted, 1);
+});
+
+test('classifies lifecycle changes and aggregates severity', () => {
+ assert.equal(severityForStatus('added'), 'minor');
+ assert.equal(severityForStatus('removed'), 'breaking');
+ assert.equal(
+ aggregateSeverity([
+ { severity: 'minor' },
+ { severity: 'major' },
+ ]),
+ 'major',
+ );
+});
+
+test('runs the real GLB engine and renders an idempotent report', async () => {
+ const changes = await diffModels(await model(), await model({ x: 0.5 }), { nameA: 'before', nameB: 'after' });
+ assert.equal(changes.severity, 'major');
+ const report = buildReport({
+ results: [{ path: 'avatar.glb', severity: changes.severity, outcome: '1 structural change', markdown: 'Changed.' }],
+ omitted: 0,
+ failOn: 'breaking',
+ });
+ assert.ok(report.startsWith(COMMENT_MARKER));
+ assert.match(report, /avatar\.glb/);
+ assert.match(report, /Highest severity: \*\*major\*\*/);
+});
diff --git a/scripts/export-growth-satellites.mjs b/scripts/export-growth-satellites.mjs
new file mode 100644
index 000000000..ac05fc1d7
--- /dev/null
+++ b/scripts/export-growth-satellites.mjs
@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+
+import {
+ cpSync,
+ existsSync,
+ mkdirSync,
+ readdirSync,
+ readFileSync,
+ rmSync,
+ statSync,
+ writeFileSync,
+} from 'node:fs';
+import { execFileSync } from 'node:child_process';
+import { dirname, join, relative, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+const REPO = resolve(HERE, '..');
+const DEFAULT_OUT = join(REPO, 'dist', 'growth-satellites');
+const argv = process.argv.slice(2);
+const valueAfter = (flag) => {
+ const index = argv.indexOf(flag);
+ return index === -1 ? null : argv[index + 1];
+};
+const OUT = resolve(valueAfter('--out') || DEFAULT_OUT);
+const OFFLINE = argv.includes('--offline');
+const ONLY = valueAfter('--target');
+
+const TARGETS = [
+ {
+ name: 'agent-starter',
+ source: 'satellites/agent-starter',
+ repository: 'https://github.com/nirholas/threews-agent-starter.git',
+ build: false,
+ },
+ {
+ name: 'glb-quality-gate',
+ source: 'satellites/glb-quality-gate',
+ repository: 'https://github.com/nirholas/glb-quality-gate.git',
+ build: true,
+ },
+];
+
+function assertSafeOutput(path) {
+ const relativePath = relative(REPO, path);
+ if (!relativePath || relativePath === '..' || relativePath.startsWith(`..${process.platform === 'win32' ? '\\' : '/'}`)) {
+ throw new Error(`refusing to replace output outside the repository: ${path}`);
+ }
+ if (!relativePath.startsWith(`dist${process.platform === 'win32' ? '\\' : '/'}`)) {
+ throw new Error(`output must stay under dist/: ${path}`);
+ }
+}
+
+function run(command, args, cwd) {
+ execFileSync(command, args, { cwd, stdio: 'inherit' });
+}
+
+function copyProject(target) {
+ const source = join(REPO, target.source);
+ const destination = join(OUT, target.name);
+ cpSync(source, destination, {
+ recursive: true,
+ filter: (path) => !['node_modules', '.git'].includes(path.split('/').at(-1)),
+ });
+ for (const legal of ['LICENSE', 'NOTICE']) {
+ const sourceFile = join(REPO, legal);
+ if (existsSync(sourceFile)) cpSync(sourceFile, join(destination, legal));
+ }
+ const packageJson = JSON.parse(readFileSync(join(destination, 'package.json'), 'utf8'));
+ if (!packageJson.license) throw new Error(`${target.name} package.json has no license`);
+ if (!existsSync(join(destination, 'README.md'))) throw new Error(`${target.name} has no README.md`);
+ if (!existsSync(join(destination, '.gitignore'))) throw new Error(`${target.name} has no .gitignore`);
+ return destination;
+}
+
+function verifyProject(target, destination) {
+ if (OFFLINE) return;
+ run('npm', ['ci', '--ignore-scripts'], destination);
+ run('npm', ['test'], destination);
+ if (target.build) {
+ run('npm', ['run', 'build'], destination);
+ if (!existsSync(join(destination, 'dist', 'index.js'))) {
+ throw new Error(`${target.name} build did not produce dist/index.js`);
+ }
+ }
+}
+
+function initHistory(target, destination) {
+ run('git', ['init', '-b', 'main'], destination);
+ run('git', ['add', '--all'], destination);
+ run(
+ 'git',
+ [
+ '-c',
+ 'user.name=three.ws release builder',
+ '-c',
+ 'commit',
+ '-m',
+ `feat: publish ${target.name}`,
+ ],
+ destination,
+ );
+}
+
+function countFiles(path) {
+ let count = 0;
+ for (const entry of readdirSync(path, { withFileTypes: true })) {
+ if (entry.name === '.git' || entry.name === 'node_modules') continue;
+ const child = join(path, entry.name);
+ count += entry.isDirectory() ? countFiles(child) : statSync(child).isFile() ? 1 : 0;
+ }
+ return count;
+}
+
+const selected = ONLY ? TARGETS.filter((target) => target.name === ONLY) : TARGETS;
+if (!selected.length) throw new Error(`unknown target: ${ONLY}`);
+assertSafeOutput(OUT);
+rmSync(OUT, { recursive: true, force: true });
+mkdirSync(OUT, { recursive: true });
+
+const manifest = [];
+for (const target of selected) {
+ const destination = copyProject(target);
+ verifyProject(target, destination);
+ initHistory(target, destination);
+ manifest.push({
+ name: target.name,
+ repository: target.repository.replace(/\.git$/, ''),
+ commit: execFileSync('git', ['rev-parse', 'HEAD'], { cwd: destination, encoding: 'utf8' }).trim(),
+ files: countFiles(destination),
+ });
+}
+
+writeFileSync(join(OUT, 'manifest.json'), `${JSON.stringify({ generatedAt: new Date().toISOString(), targets: manifest }, null, 2)}\n`);
+
+console.log('\nPublishable satellite trees:');
+for (const item of manifest) {
+ const target = TARGETS.find((entry) => entry.name === item.name);
+ console.log(`\n${item.name}: ${item.files} files, commit ${item.commit.slice(0, 12)}`);
+ console.log(`git -C ${join(OUT, item.name)} remote add origin ${target.repository}`);
+ console.log(`git -C ${join(OUT, item.name)} push -u origin main`);
+}