Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
docs(research): rank the 3D repos and platforms that beat three.ws and queue 21 work orders to adopt or out-build them
nirholasa0394cccac44
diff --git a/docs/research/3d-landscape-2026-10.md b/docs/research/3d-landscape-2026-10.mdnew file mode 100644index 000000000..049a35a5e--- /dev/null+++ b/docs/research/3d-landscape-2026-10.md@@ -0,0 +1,179 @@+# The 3D landscape, October 2026: who beats three.ws, and what to take++Research date: 2026-10-09. Four parallel sweeps (open-source AI generation, web engines and viewers, avatar and companion stacks, commercial platforms), every star count, push date and license read from the GitHub API or the LICENSE file itself on the research date, then checked against this repository to see what three.ws already ships. Commercial vendors are placeholders (Vendor A, B, ...) by the owner's standing directive; open-source projects are named because we depend on them and credit them.++Companions: [oss-adoption-2026-09.md](../oss-adoption-2026-09.md) (the September sweep; two of its Tier 1 items are still open and reappear here), [popular-3d-github-repos.md](../popular-3d-github-repos.md) (the raw star table), [avatar-engines.md](../avatar-engines.md) (the avatar engine atlas).++**Status (2026-10-09):** every item below is a work order in `prompts/finish/` (067 to 083 runnable, 932 to 935 owner-gated). Start from [the campaign context](../../prompts/finish/_context/best3d-00-CONTEXT.md).++## Bottom line++1. **Nobody beats three.ws on breadth.** No repo or vendor combines generation, rigging, a shared animation library, an LLM brain, voice, a wallet and a one-tag embed. The two web-avatar incumbents were absorbed within sixty days of each other (one shut down on 2026-01-31, the other was bought by a game-engine company in February); the biggest open companion project (50k stars) is desktop-first and wallet-less; the biggest agent framework has no body. The lane is open.+2. **Several repos beat us on depth, one lane at a time.** The MIT TRELLIS.2 family beats our geometry and PBR lane. VAST's MIT rigging stack rigs anything, ours rigs humanoids. three-vrm renders VRM properly, our loader does not. NVIDIA's Audio2Face-3D produces a facial performance, we estimate visemes from audio energy. Spark 2.3 and the splat tooling around it do more than our splat viewer. Every one of these is permissively licensed and is a lane swap, not a rebuild.+3. **One compliance fix is urgent.** The production image-to-3D default, Hunyuan3D 2.1, ships under a license that excludes the European Union, the United Kingdom and South Korea, for the model and for its output (`Territory` clause, Section 5.c). three.ws serves users there. TRELLIS.2 (MIT, higher resolution, PBR with transparency) is both the upgrade and the fix. Order 067.+4. **Commercial vendors win on packaging.** Multi-image input, a polycount slider, quad topology at generation time, engine bridges for Unity, Unreal and Godot, batch generation and team workspaces are table stakes everywhere else and missing or partial here. None of that is research; it is product work on lanes we already run.+5. **Five things nobody does well** are ours to take: prompt-to-clip animation on arbitrary rigs with a retarget preview, true LOD chains with engine-ready QA, edits that keep topology, UVs and rig across versions, portable ownership with signed provenance, and readable pricing. Four of the five are extensions of things we already have (Animation Studio, Simulation readiness, the remix lineage, content credentials).++## What three.ws already has (do not rebuild)++Measured in this repository on 2026-10-09.++| Capability | Where | Model or library |+|---|---|---|+| Image to 3D | `workers/model-hunyuan3d`, `workers/model-trellis`, `workers/model-triposg`, `workers/model-triposr` | Hunyuan3D 2.0 and 2.1, TRELLIS (v1), TripoSG, TripoSR |+| Rigging | `workers/rig` | Make-It-Animatable plus UniRig, humanoid only, ARKit-52 blendshapes |+| PBR texturing and region retexture | `workers/texture` | SDXL inpainting in UV space |+| Quad remesh, decimation, format conversion | `workers/remesh` | QuadriFlow |+| Part segmentation | `workers/segment` | SAM-based, CPU |+| Text to motion | `workers/model-text2motion` | MDM (MIT) |+| Video to motion, selfie to avatar, video to scene, garments, CAD | `workers/model-video2motion`, `workers/avatar-reconstruction`, `workers/model-video2scene`, `workers/garment-forge`, `workers/cad-forge` | |+| Universal retargeting (no rig allowlist) | `src/glb-canonicalize.js`, `src/animation-retarget.js` | |+| Splat viewer | `src/splat-stage.js` | Spark 2.2 |+| Scene Studio | `src/scene-studio/` | vendored three.js editor |+| Webcam face capture | `src/face-mocap.js`, `src/avatar-face-capture.js` | MediaPipe Face Landmarker |+| In-browser TTS and STT, barge-in | `src/runtime/neural-tts.js` (Kokoro), `src/runtime/whisper-stt.js`, `src/voice/` | |+| USDZ export | `src/usdz-pipeline.js`, `src/usdz-animated.js` | |+| glTF tooling | `packages/glb-diff`, `packages/glb-tools`, Rig Doctor, Model Diff | gltf-transform 4.5 |+| Physics, BVH | `src/physics/physics-world.js` | Rapier 0.19, three-mesh-bvh 0.9 |+| MCP servers, Blender MCP, remix lineage, content credentials, Simulation readiness | `packages/*-mcp`, `packages/blender-mcp`, `specs/SIM_READINESS.md` | |++Gaps confirmed by grep on the same day: no WebGPU or TSL in product code (only inside the vendored editor), no `KHR_materials_variants` handling, no annotation hotspots on `<agent-3d>`, no AR attributes on `<agent-3d>` (the `/ar` page loads a third-party viewer from a CDN instead), no LOD generation, no Unity, Unreal or Godot bridge, no user-facing batch generation, no spring bones, MToon, expression presets or `.vrma` support in the VRM path, no `.vrma` anywhere, no Audio2Face lane.++## Sweep 1: open-source AI 3D generation++| Repo | Stars | Pushed | License | Why it matters |+|---|---|---|---|---|+| [microsoft/TRELLIS.2](https://github.com/microsoft/TRELLIS.2) | 11.5k | 2026-07 | MIT | Current open state of the art: 4B flow transformer on sparse "O-Voxels", arbitrary topology, PBR GLB including transparency, up to 1536 cubed. 24 GB VRAM; about 3 s at 512 cubed and 17 s at 1024 cubed on an H100. Weights MIT on Hugging Face. Supersedes TRELLIS v1, which we run. |+| [TencentARC/Pixal3D](https://github.com/TencentARC/Pixal3D) | 2.4k | 2026-09 | MIT | TRELLIS.2 backbone that back-projects pixel features: near-reconstruction fidelity to the input photo, single or multi-view, PBR GLB. The "looks exactly like my picture" lane. |+| [Tencent-Hunyuan/Hunyuan3D-2.1](https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1) | 4.1k | 2025-10 | Tencent Hunyuan 3D 2.1 Community License | Our production default. License excludes EU, UK and South Korea for the works **and the output**, caps at 1M MAU, requires a Notice file. 2.5, 3.0 and PolyGen have no public weights. **Usable only with territory enforcement.** |+| [Tencent-Hunyuan/Hunyuan3D-Omni](https://github.com/Tencent-Hunyuan/Hunyuan3D-Omni), [Hunyuan3D-Part](https://github.com/Tencent-Hunyuan/Hunyuan3D-Part), [HunyuanWorld-1.0](https://github.com/Tencent-Hunyuan/HunyuanWorld-1.0) | 0.6k to 2.9k | 2025-10 to 2026-04 | same family | Pose, bbox and point-cloud conditioning; native part segmentation; text to explorable 360 world. Same territory problem. Reference only. |+| [DreamTechAI/Direct3D-S2](https://github.com/DreamTechAI/Direct3D-S2) | 1.3k | 2025-09 | MIT | 1024 cubed geometry, geometry only. |+| [stepfun-ai/Step1X-3D](https://github.com/stepfun-ai/Step1X-3D) | 0.9k | 2025-09 | Apache-2.0 | Shape plus texture, controllable (symmetry LoRA), training code. |+| [VAST-AI-Research/TripoSG](https://github.com/VAST-AI-Research/TripoSG), TripoSF, TripoSR, [TripoSplat](https://github.com/VAST-AI-Research/TripoSplat) | 0.8k to 7.0k | 2025-04 to 2026-08 | MIT | We run TripoSG and TripoSR. TripoSplat (image to Gaussian splats) is new and fits the splat viewer. |+| [facebookresearch/sam-3d-objects](https://github.com/facebookresearch/sam-3d-objects) | 7.5k | 2026-06 | SAM License (commercial allowed, gated weights, sanctions clause) | Every object in a cluttered real photo, with layout. The "photo of my room to placeable objects" feature. Needs a license acceptance. |+| [wgsxm/PartCrafter](https://github.com/wgsxm/PartCrafter), [HoloPart](https://github.com/VAST-AI-Research/HoloPart), [MIDI-3D](https://github.com/VAST-AI-Research/MIDI-3D) | 0.7k to 2.5k | 2026-04 | MIT, MIT, Apache-2.0 | One image to individually editable parts; amodal completion of hidden parts; one image to a multi-object scene. |+| [VAST-AI-Research/UniRig](https://github.com/VAST-AI-Research/UniRig), [SkinTokens](https://github.com/VAST-AI-Research/SkinTokens), [AniGen](https://github.com/VAST-AI-Research/AniGen) | 0.5k to 1.8k | 2026-05 to 2026-07 | MIT (all three LICENSE files read) | Skeleton plus skin weights for arbitrary rigs (animals, props); SkinTokens claims roughly double the skinning accuracy; AniGen is image to rigged asset in one pass. |+| [jasongzy/Make-It-Animatable](https://github.com/jasongzy/Make-It-Animatable) | 0.5k | 2026-09 | MIT | Already in our rig lane. Also rigs Gaussian splats. |+| [Seed3D/Puppeteer](https://github.com/Seed3D/Puppeteer), [MagicArticulate](https://github.com/Seed3D/MagicArticulate) | 0.4k | 2025-09 | Apache-2.0 | Rig then animate from a video prompt, FBX export. |+| [3DTopia/MaterialAnything](https://github.com/3DTopia/MaterialAnything) | 0.4k | 2025-12 | MIT | PBR materials (albedo, roughness, metallic, bump) for any mesh, including untextured scans. Needs Blender in the loop. |+| [huanngzh/MV-Adapter](https://github.com/huanngzh/MV-Adapter) | 1.3k | 2025 | Apache-2.0 | Multi-view consistent image generation for texturing and multi-view conditioning. |+| MeshAnything V2, Roblox Cube, Sparc3D, SF3D and SPAR3D | | | non-commercial, research-only, no license, revenue-capped | Reference only. There is still no open quad retopology competitive with the closed vendors; QuadriFlow remains the best we can ship. |++## Sweep 2: web engines, viewers and tooling++| Project | Stars | License | What to take |+|---|---|---|---|+| [three.js](https://github.com/mrdoob/three.js) r186 | 116k | MIT | `WebGPURenderer` with TSL node materials is now the primary path; native `GaussianSplat` object with splat raycasting (r186, WebGPU); `BatchedMesh` for crowds. We are on r184 with the WebGL renderer everywhere. |+| [Babylon.js](https://github.com/BabylonJS/Babylon.js) 9.30 | 26k | Apache-2.0 | Inspector v2 (extensible panes, splat stream diagnostics), Node Material Editor, Flow Graph editor exporting `KHR_interactivity`. Engine mismatch, so reference for UI, rebuilt on TSL. |+| [PlayCanvas engine](https://github.com/playcanvas/engine), [SuperSplat](https://github.com/playcanvas/supersplat), [supersplat-viewer](https://github.com/playcanvas/supersplat-viewer) | 17k, 10k | MIT | The editor frontend is MIT but talks to a closed backend. SuperSplat Studio: up to 25 annotation hotspots with saved camera views, camera timeline, video export, SOG compressed format. |+| [google/model-viewer](https://github.com/google/model-viewer) 4.3 | 8.3k | Apache-2.0 | The AR export contract: `ar-modes="webxr scene-viewer quick-look"`, on-device USDZ, `ar-placement` floor or wall, `variant-name`, hotspot slots, poster and skeleton loading. Our `/ar` page loads it from a CDN; `<agent-3d>` has none of it. |+| [gltf-transform](https://github.com/donmccurdy/glTF-Transform) 4.5.1 | 2.0k | MIT | Already a dependency. `inspect()`, `simplify`, `palette`, `instance`, the variants API and `@gltf-transform/view` are unused. |+| [Spark](https://github.com/sparkjsdev/spark) 2.3.1 | 3.7k | MIT | We run 2.2. LoD Splat Tree, streamable format, memory paging for 100M+ splats, Rust decoders, dyno shader graph for GPU-side splat editing, skeletal-animated splats. |+| [pixiv/three-vrm](https://github.com/pixiv/three-vrm) 3.5 | 2.2k | MIT | VRM 0.x and 1.0, MToon, spring bones, constraints, look-at, 18 expression presets, `.vrma` animation loader, WebGPU. Our `src/game/vrm-loader.js` documents that it does none of this. |+| [three-mesh-bvh](https://github.com/gkjohnson/three-mesh-bvh) 0.9.16 | 3.5k | MIT | Already a dependency; `three-mesh-bvh/webgpu` compute queries are new. |+| [8thwall/8thwall](https://github.com/8thwall/8thwall) | 0.5k | MIT since 2026-03 | Face effects, image targets, coaching overlay, unsupported-device landing page. SLAM is binary-only; hosted services ended 2026-02-28. |+| [Theatre.js](https://github.com/theatre-js/theatre) | 12.7k | Apache-2.0, unmaintained since 2024 | The keyframe timeline UX reference for Animation Studio. UI patterns only; never a dependency. |+| react-three-fiber, drei, uikit, pmndrs/xr, Threlte, A-Frame 1.8 | 3k to 33k | MIT | A-Frame's keyboard-toggled in-page inspector is the pattern for a debug overlay on any embed. |+| Needle Engine, Spline V2, Wonderland | | closed or source-available with EULA | Reference only. Spline V2's in-editor agent tab plus MCP server (an agent reads the scene, calls tools, screenshots to verify, per-prompt version history) is where browser editors are heading; we already have `packages/scene-mcp` to build it on. |++## Sweep 3: avatars, virtual humans, companions++Market facts: the largest cross-game avatar SDK (Vendor R) was acquired on 2025-12-19 and its hosted creator and every public endpoint went offline on 2026-01-31; exported GLBs still load, and every embed that depended on it is orphaned. The leading parametric body-model company was acquired by a game-engine company in February 2026. A long-running free animation library is online and unmaintained. The dominant mobile viseme SDK reached end of life in April 2026.++| Project | Stars | License | What to take |+|---|---|---|---|+| [met4citizen/TalkingHead](https://github.com/met4citizen/TalkingHead), [HeadTTS](https://github.com/met4citizen/HeadTTS), [HeadAudio](https://github.com/met4citizen/HeadAudio) | 1.6k | MIT | Rule-based viseme timing from TTS word timestamps in six languages plus Azure viseme passthrough, mood system, emoji to expression, gestures, gaze. HeadTTS runs Kokoro in-browser with visemes. HeadAudio is an audio-worklet viseme detector for audio with no transcript. |+| [moeru-ai/airi](https://github.com/moeru-ai/airi) | 50k | MIT | The scale leader in companions: VRM and Live2D bodies, auto-blink and idle eyes, Discord and Telegram bodies, WebGPU local inference. Desktop-first, no wallet. |+| [semperai/amica](https://github.com/semperai/amica) | 1.6k | MIT | Closest architectural cousin to our embed: three-vrm, emotion engine, vision, in-browser Whisper plus Silero VAD, many TTS backends. |+| [NVIDIA/Audio2Face-3D](https://github.com/NVIDIA/Audio2Face-3D) and SDK | 0.5k | NVIDIA Open Model License (weights), MIT (SDK) | Audio to 52 ARKit blendshapes plus emotion. Exactly the rig our avatars already carry. Was Tier 1 in the September sweep and is still unbuilt. |+| [google-ai-edge/mediapipe](https://github.com/google-ai-edge/mediapipe) Face Landmarker | 37k | Apache-2.0 | Already in `src/face-mocap.js`. |+| Open-LLM-VTuber (14k), Utsuwa, avtr-1 | | custom frontend license, AGPL, custom | Reference only: barge-in turn-taking, relationship and mood memory, "active listening" idle reactions while the user speaks. Reimplement, never vendor. |+| [elizaOS/eliza](https://github.com/elizaOS/eliza) | 20k | MIT | No first-party 3D or VRM plugin exists; the only 3D starter is a dead fork on a GPL world engine. The agent-with-wallet ecosystem has no body. |+| Text to motion: [MoMask](https://github.com/EricGuo5513/momask-codes), [MotionGPT](https://github.com/OpenMotionLab/MotionGPT), [MDM](https://github.com/GuyTevet/motion-diffusion-model) | 1.3k to 4.1k | MIT | We run MDM. MoMask is the stronger MIT baseline. HY-Motion 1.0 (Tencent, 2.6k) is the quality leader but carries the same EU, UK and Korea exclusion as Hunyuan3D, so it stays reference-only. MotionLCM is non-commercial. |+| Video to motion: 4D-Humans, WHAM, TRAM | 0.6k to 1.7k | MIT | All emit SMPL parameters, whose body model is non-commercial; commercial output inherits that problem. Our video2motion lane already avoids it. |+| makehumancommunity/mpfb2 | 0.6k | GPL code, CC0 assets | The CC0 base meshes and targets are a legal parametric body library. |+| Vendor S (selfie to avatar SaaS), Vendor T (streamed-blendshape conversational character SaaS) | | closed | Reference: iframe avatar SDK with outfit catalog; server-streamed 52 blendshapes at 60 fps. |++## Sweep 4: commercial platforms (reference only)++Twenty-six vendors were surveyed. Pricing from the vendor pages where fetchable, otherwise from aggregators, which disagree with each other on nearly every vendor.++| Vendor | Shape | What users get that we do not |+|---|---|---|+| Vendor A, the market leader (reported 15M users, 100M models, roughly $100M ARR) | credits, free tier with CC-BY output | Multi-image input (1 to 4), batch image-to-3D, a chat-driven 3D agent, texture edit, "smart" vs standard topology, auto split to parts, humanoid and quadruped rig with 500+ presets, scene compose, Blender, Unity, Unreal and Godot bridges, an official MCP server with 24 tools. |+| Vendor B, 20B-parameter generator (reported 6.5M creators) | credits | Quad retopology in about 2 s, part segmentation, rig and retarget and a mocap library over the API, plugins for five engines plus ComfyUI, MCP in alpha. |+| Vendor C, quad-native generator | free to generate, pay on download | Face-count slider 500 to 1M, bbox constraint, T or A pose, baked normals from high-poly, geometry and material redos, 8K HDRI remix. |+| Vendor D, parametric plus AI | the only unlimited tier | LOD, UVs, custom art styles, skybox generation, print-slicer plugins, runtime generation inside a game engine. |+| Vendor E, parts generator | credits | Image segmentation to parts with auto-assembly, adaptive polycount. |+| Vendor F, browser design tool | credits | Agent tab plus MCP server driving the editor, per-prompt version history, web and app export. |+| Vendor G, print-first modeler | credits | Node canvas, SDF editor, integrated full-color 3D print ordering. |+| Vendor H, model-agnostic hub | credits | 65+ models behind one API, custom LoRA training, team workspaces. |+| Vendor I, world generator | tiers | Text, image or panorama to an explorable world with splat, collider and mesh export. |+| Closed Studio tier of the Hunyuan3D family | per generation | 4 or 8 views, 1536 cubed, 4K PBR, quad or tri, low-poly, part mode, rig, UV, baking. |++**The fifteen features every serious vendor has:** multi-image input; quad or smart topology at generation time; polycount slider with bbox and pose controls; UV-preserving PBR retexture of any upload; auto-rig for humanoids and quadrupeds with a large retargeted library; split to parts with auto-assembly; free-to-generate pricing or an unlimited tier; an official MCP server and `llms.txt`; first-party Blender, Unity, Unreal and Godot bridges; batch generation with concurrency tiers; a community gallery with remix lineage; a chat-driven agent or node canvas; scene or world generation with real export; a print-ready pipeline; team workspaces with SSO and audit. We have eight of the fifteen in full or in part (retexture, humanoid rig, parts, MCP, Blender, remix lineage, chat agent, Diorama).++**White space (nobody does this well):** prompt-to-clip animation on arbitrary rigs with a retarget preview; true LOD chains with draw-call, texel-density and collider QA; edits that keep topology, UVs, rig and animations across versions; portable ownership (signed exports, on-chain provenance, CC licensing by default); readable per-task pricing with a cost preview before you spend.++## Take: ranked by leverage over effort++Status is the grep above. "Build" is the smallest change that closes the gap. Licenses: **use** means the project becomes a dependency or a lane as-is; **vendor** means we copy the pattern or a module under its license; **reference** means the license or the closed source forbids reuse and we build a better version from scratch.++### Tier 1: lane swaps on permissive licenses, each a visible quality jump++| # | What | From | License | Order |+|---|---|---|---|---|+| 1 | TRELLIS.2 becomes the default image-to-3D lane: PBR with transparency, 1536 cubed. Hunyuan3D 2.1 drops to a territory-gated fallback or retires. | TRELLIS.2 | MIT, use | 067 |+| 2 | Pixal3D "match my photo" fidelity lane, multi-view input (1 to 4 images) in Forge | Pixal3D, MV-Adapter | MIT, Apache-2.0, use | 068 |+| 3 | Rig anything: SkinTokens plus UniRig for quadrupeds, creatures and props; AniGen image-to-rigged in one pass | SkinTokens, UniRig, AniGen | MIT, use | 069 |+| 4 | Editable parts: PartCrafter and HoloPart behind the segment lane; recolor, swap and regenerate one part in Restyle Studio | PartCrafter, HoloPart | MIT, use | 070 |+| 5 | Real VRM: three-vrm for spring bones, MToon, expression presets, look-at, `.vrma`; an import landing for orphaned avatars from the shut-down SDK | three-vrm | MIT, use | 075 |+| 6 | Facial performance: Audio2Face-3D worker emitting ARKit-52 tracks, with the current viseme path as the fallback rung | Audio2Face-3D | NVIDIA Open Model License (weights), MIT (SDK), use | 076 |+| 7 | Splat viewer parity: Spark 2.3 LoD tree and paging, annotation hotspots with saved cameras, camera timeline, video export, skeletal splats, TripoSplat image-to-splat | Spark, SuperSplat (patterns), TripoSplat | MIT, use and vendor | 081 |++### Tier 2: packaging the vendors have and we lack++| # | What | Reference | Order |+|---|---|---|---|+| 8 | `<agent-3d>` AR and viewer contract: `ar-modes`, on-device USDZ, `ar-placement`, `variant-name` with `KHR_materials_variants`, hotspot slots, poster skeleton; retire the CDN viewer on `/ar` | model-viewer (Apache-2.0, vendor the attribute API and USDZ path) | 073 |+| 9 | WebGPU path: opt-in `WebGPURenderer` with WebGL2 fallback across the viewer and Scene Studio, TSL materials behind Restyle, native `GaussianSplat` on r186, `three-mesh-bvh/webgpu` | three.js r186 (MIT, use) | 074 |+| 10 | LOD chains plus engine-ready QA: gltf-transform `simplify` and `palette` chain, `MSFT_lod`, texel density, draw-call and collider report inside Simulation readiness and Rig Doctor; watertight STL for print | gltf-transform (MIT, use); Vendors D and G (reference) | 071 |+| 11 | Engine bridges: Unity package, Unreal plugin, Godot addon that browse the catalog and pull generations through the public API, sharing one contract with the Blender MCP | Vendors A, B, C (reference) | 072 |+| 12 | Generation controls: polycount slider, bbox constraint, T or A pose on every generation lane; batch generation with concurrency tiers in Forge and the API | Vendors A, C (reference) | 083 |+| 13 | Scene Studio: inspector pane, TSL material graph, agent tab driven by `packages/scene-mcp` with screenshot verification and per-prompt version history | Babylon Inspector v2 and NME (Apache-2.0, reference), Vendor F (reference) | 080 |++### Tier 3: the white space++| # | What | Order |+|---|---|---|+| 14 | Prompt-to-clip on any rig with a retarget preview: MoMask rung beside MDM, Puppeteer video prompts, Theatre.js-grade timeline in Animation Studio | 077 |+| 15 | Keep the rig: retexture, part edits and regenerations that preserve topology, UVs, skeleton and animations across versions, with lineage in Model Diff | 078 |+| 16 | Companion presence: mood system, emoji to expression, LLM-composable gestures, active-listening idle, multi-language viseme timing, energy-based fallback | 082 |+| 17 | Portable ownership: signed GLB exports with content credentials and the provenance record on every download, by default | 079 |++### Owner-gated (band 900)++| # | What | Gate | Order |+|---|---|---|---|+| 18 | Pricing: public per-task cost preview before any spend; free-to-generate, pay-to-keep on Forge | pricing is the owner's | 932 |+| 19 | SAM 3D Objects lane: a photo of a room to placeable objects in AR Studio | license acceptance (gated weights, sanctions clause) | 933 |+| 20 | "Bring your orphaned avatar" campaign for users of the shut-down SDK | names another company; external posting | 934 |+| 21 | Publish the engine bridges to the Unity Asset Store, Unreal Marketplace, Godot Asset Library and Blender Extensions | external publishing | 935 |++## License traps found in this sweep++- **Tencent community licenses** (Hunyuan3D 2.x, Omni, Part, HunyuanWorld, HY-Motion): worldwide **excluding** the EU, UK and South Korea, for the works and their output; 1M MAU cap (100M for HY-Motion); Notice file. We serve those regions, so every Tencent lane needs territory enforcement or retirement. Order 067 decides.+- **NVIDIA Open Model License** (Audio2Face-3D weights): commercial use allowed, not redistributable as open source, usage restrictions apply. Fine for a worker; never bundle the weights in a package.+- **SAM License** (SAM 3D Objects): commercial use allowed, gated download form, sanctions clause. An owner accepts it once.+- **Stability Community License** (SF3D, SPAR3D): free under $1M revenue with registration. Both projects are dead; not worth it.+- **Non-commercial or copyleft**: MeshAnything V2, SMPL-X and everything that emits SMPL parameters, MotionLCM, Roblox Cube, GVHMR, SMPLer-X, Hyperfy (GPL), Utsuwa (AGPL), the Open-LLM-VTuber frontend. Reference only.+- **Make-It-Animatable** is MIT in the repository; the Hugging Face Space says CC-BY-NC. The repository governs, and we already use it.++## Re-running this sweep++ # Verify a repo's license, stars and activity from the source, not a blog.+ gh api repos/<owner>/<name> --jq '[.full_name,.stargazers_count,.pushed_at[:10],.license.spdx_id]|@tsv'+ # NOASSERTION means GitHub could not classify it; read the file.+ gh api repos/<owner>/<name>/contents/LICENSE --jq .content | base64 -d | head -30+ # Does three.ws already use it anywhere that matters?+ grep -rli '<name>' src api workers packages services --include=*.js --include=*.py --include=*.md | grep -v node_modulesdiff --git a/prompts/README.md b/prompts/README.mdindex 5fc866c7d..9e39b23d1 100644--- a/prompts/README.md+++ b/prompts/README.md@@ -82,6 +82,7 @@ directory, never this table. For the order to run them in, see [RUN-ORDER.md](RU| `integrate-` | Bringing the owner's other repositories into three.ws, from a 2026-10-08 survey of all 389 of them: one staged mirror-sync mechanism and drift ports (500 to 504), pump.fun claims, events, receipts and the native-lane anti-snipe fee (505 to 515), native ports of the keyless x402-suite services and stronger spend policy (516 to 523), skill import from OpenAPI and Anchor IDL, persona templates, llms.txt and W3AG fixes, MCP registry hygiene (524 to 531), X, news and market data (532 to 538), and 3D, rescue and Robinhood Chain items (539 to 549). Context: [finish/_context/integrate-00-CONTEXT.md](finish/_context/integrate-00-CONTEXT.md). || `openai-pr-` | The OpenAI Apps SDK submission pack. Briefs 01 to 05 shipped; 06 (the tool count drifted to 11 across the kit) and 07 (the go/no-go, never run) remain, with the portal submit owner-only. || `parity-` | Closing the gaps a teardown of a leading agent launchpad found ("Competitor X", [docs/research/competitor-teardown-2026-09.md](../docs/research/competitor-teardown-2026-09.md)): per-agent creator earnings, `/analytics`, an earnings leaderboard, selling a whole agent over x402, `/experiments`, `/stories`, the $THREE fee flow, MCP use cases and safe paid retries (015 to 022, runnable), plus shipping, the npm publish, directory listings, a comparison page, a builder competition, pricing levers and an X mention bot (919 to 925, owner-gated). Shared facts: [finish/_context/parity-00-CONTEXT.md](finish/_context/parity-00-CONTEXT.md). |+| `best3d-` | Closing the gaps found by the 2026-10-09 sweep of open-source and commercial 3D ([docs/research/3d-landscape-2026-10.md](../docs/research/3d-landscape-2026-10.md)): TRELLIS.2 default lane with Hunyuan territory enforcement, Pixal3D and multi-view, non-humanoid rigging, editable parts, LOD and engine QA, engine bridges, the `<agent-3d>` AR contract, WebGPU, three-vrm, Audio2Face-3D, prompt-to-clip, keep-the-rig, signed exports, Scene Studio agent tab, splat parity, companion presence and generation controls (067 to 083, runnable), plus pricing preview, SAM 3D Objects, an orphaned-avatar campaign and store publishing (932 to 935, owner-gated). Shared facts: [finish/_context/best3d-00-CONTEXT.md](finish/_context/best3d-00-CONTEXT.md). || `production-100-` | The run-to-100% campaign: a master index sequencing every open work order toward a mechanically checkable "production ready, roadmap complete" end state, a standing ship-readiness order, closeout orders for residuals no other campaign owned (stranded custodial funds, master-key hygiene, verdict tuning), and the batched owner-action list. Its map was re-measured against code and production on 2026-09-01; start there. || `quality-bar-` | The GCP-credit quality campaign. Six open orders (fleet scale, PBR materials, forge UX, design system, mobile, avatar likeness); the reference pipeline, flagship lane, viewers and eval harness shipped. || `roadmap-` | Five runnable orders for existing surfaces (generation suite, creation consolidation, parametric avatar editor, developer resources, native home-screen widgets), plus the strategy layer ([the playbook](../docs/internal/fable-playbook.md)) that decides what to run next and [the reuse map](finish/roadmap-REUSE-MAP.md) for license-vetted OSS. |diff --git a/prompts/RUN-ORDER.md b/prompts/RUN-ORDER.mdindex c485c170a..01eb9748f 100644--- a/prompts/RUN-ORDER.md+++ b/prompts/RUN-ORDER.md@@ -11,11 +11,12 @@ so you can open one, run it, and open the next without consulting anything. Ever| `001` to `014` | Runnable right now, no gate. Highest value first. Start at `001`. | 14 || `015` to `022` | The `parity-` campaign, added 2026-09-30. Runnable, no gate except where an order names one step. Run 015 before 017 (017 ranks 015's data); 919 ships them. | 8 || `023` to `066` | The `x-grok-` campaign, added 2026-10-08: Grok Bot as an MCP client, xAI as a provider, and the X mention bot (dry run). Runnable; lane C ships nothing live. Run 023 first, 045 before 049, 046 to 049 before 050. | 44 |+| `067` to `083` | The `best3d-` campaign, added 2026-10-09 from the 3D landscape sweep. Runnable, no gate. Run 067 first (compliance fix), 068 and 069 after it, 070 before 078, 074 before the TSL part of 080. Shared facts: [finish/_context/best3d-00-CONTEXT.md](finish/_context/best3d-00-CONTEXT.md). | 17 || `100` to `248` | The route-audit swarm, ordered by measured defect class. Parallel-safe. | 149 || `300` to `313` | The unbuilt Home campaign, in numeric order (04 gates 05 and 06, 11 gates 20). | 14 || `400` to `499` | Written by the evolve scout lane ([docs/ops/evolve.md](../docs/ops/evolve.md)), each from a dated measurement. Runnable, no gate. | varies || `500` to `549` | The `integrate-` campaign, added 2026-10-08: bringing the owner's other GitHub repositories into three.ws (ports, failover rungs, consolidations, mirror hygiene). Runnable; gated steps are named per order. Run 500 and 501 before any mirror push, 505 before 506 and 507, 524 before 525, 529 before 530 and 531, and 015 before 510. Shared facts: [finish/_context/integrate-00-CONTEXT.md](finish/_context/integrate-00-CONTEXT.md). | 50 |-| `900` and up | Blocked: the last step is an owner action or an outside party. Read before running. | 20 |+| `900` and up | Blocked: the last step is an owner action or an outside party. Read before running. (Includes 932 to 935 of the `best3d-` campaign.) | 24 |The number is a position, not an identity. When an order retires its file is deleted and a gapis left rather than renumbering the folder, so a link to `003-...` keeps meaning the same order.diff --git a/prompts/finish/067-best3d-01-trellis2-default-lane.md b/prompts/finish/067-best3d-01-trellis2-default-lane.mdnew file mode 100644index 000000000..90d5fb0de--- /dev/null+++ b/prompts/finish/067-best3d-01-trellis2-default-lane.md@@ -0,0 +1,58 @@+# best3d 01: TRELLIS.2 becomes the default image-to-3D lane; Hunyuan3D 2.1 is territory-gated or retired++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now, no gate.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this matters++The production default, Hunyuan3D 2.1, ships under a license that excludes the EU, the UK and South Korea for the model and its output (Territory clause, Section 5.c) and caps at 1M MAU. three.ws serves those regions. TRELLIS.2 (microsoft/TRELLIS.2, MIT, 4B flow transformer, PBR with transparency, up to 1536 cubed, 24 GB VRAM) is both the upgrade and the compliance fix. This is the most urgent order in the campaign.++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Step 0: re-derive the current state++ ls workers | grep model-; sed -n 60,80p workers/model-hunyuan3d/README.md+ grep -rn "hunyuan" api/_lib --include=*.js -il | head -20+ gh api repos/microsoft/TRELLIS.2 --jq '[.stargazers_count,.pushed_at[:10],.license.spdx_id]|@tsv'++## Tasks++1. Create `workers/model-trellis2/` on the pattern of `workers/model-trellis` (own Dockerfile, `cloudbuild.yaml` pinned to the `three-ws-build@` service account, vendored shared modules checked by `npm run check:vendored`, weights staged from `gs://three-ws-model-weights`, GPU class from `docs/ops/gcp-credits-plan.md`). Emit a PBR GLB with alpha preserved, meshopt-compressed through the existing gltfpack step.+2. Register the lane in the Forge lane registry and make it the default for image-to-3D, with the existing failover chain behind it (TRELLIS v1, TripoSG, TripoSR). Expose the resolution tier (512, 1024, 1536) as a request option.+3. Hunyuan3D 2.1 decision: add territory enforcement (country of the requester resolved server side; EU, UK and South Korea never routed to a Tencent lane) and keep it as an explicit lane for other regions, or retire it if TRELLIS.2 quality is at least equal on the Forge benchmark set. Record the measured comparison and the decision in the PROGRESS log.+4. Add the Notice file Hunyuan requires for any region where it stays, and update `workers/model-hunyuan3d/README.md` License section with the territory rule.+5. Write `workers/model-trellis2/README.md`, a `data/changelog.json` entry, and a STRUCTURE.md row.++## Definition of done++- [ ] `node --test` or vitest coverage for the territory router: EU, UK and KR requests never select a Tencent lane.+- [ ] A real generation through the new worker returns a valid GLB (validated with `packages/glb-tools`) and its forge_creations row shows backend trellis2.+- [ ] `npm run check:vendored` passes.+- [ ] `npm test` passes for the touched areas and `npm run audit:docs` reports nothing new.+- [ ] Docs, STRUCTURE.md row where a surface or directory landed, and a `data/changelog.json` entry (then `npm run build:pages`).++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/067-best3d-01-trellis2-default-lane.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/068-best3d-02-pixal3d-multiview.md b/prompts/finish/068-best3d-02-pixal3d-multiview.mdnew file mode 100644index 000000000..f0fe55afa--- /dev/null+++ b/prompts/finish/068-best3d-02-pixal3d-multiview.md@@ -0,0 +1,57 @@+# best3d 02: Pixal3D fidelity lane and 1 to 4 image multi-view input in Forge++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now, no gate.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this matters++Multi-image input is table stakes at every serious vendor and Forge takes one image. TencentARC/Pixal3D (MIT) back-projects pixel features so the result matches the input photo; MV-Adapter (Apache-2.0) generates consistent extra views.++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Step 0: re-derive the current state++ gh api repos/TencentARC/Pixal3D --jq '[.stargazers_count,.pushed_at[:10],.license.spdx_id]|@tsv'+ grep -rn "image_url\|imageUrl" api/forge* api/_lib/forge* -l 2>/dev/null | head+ ls workers/model-trellis2 2>/dev/null++## Tasks++1. Run Pixal3D inside the `workers/model-trellis2` image as a second entrypoint (they share the backbone) or as its own worker if dependencies conflict.+2. Extend the Forge request schema with `images: [url...]` (1 to 4) plus an optional view label (front, back, left, right). Validate count and dimensions at the boundary. Single image keeps working unchanged.+3. Add MV-Adapter as the optional view-synthesis rung: when only one image is given and the user picks "fill in the other sides", synthesize views first, then reconstruct.+4. Forge UI: a multi-image drop zone with view labels, the fidelity lane named "Match my photo", real progress from the worker.+5. Docs: api-reference.md Forge section, changelog entry, worker README.++## Definition of done++- [ ] A 3-image request returns a GLB and the forge_creations row records all input URLs.+- [ ] Single-image requests are byte-for-byte the same path as before (existing tests green).+- [ ] `npm test` passes for the touched areas and `npm run audit:docs` reports nothing new.+- [ ] Docs, STRUCTURE.md row where a surface or directory landed, and a `data/changelog.json` entry (then `npm run build:pages`).++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/068-best3d-02-pixal3d-multiview.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/069-best3d-03-rig-anything.md b/prompts/finish/069-best3d-03-rig-anything.mdnew file mode 100644index 000000000..765c56c72--- /dev/null+++ b/prompts/finish/069-best3d-03-rig-anything.md@@ -0,0 +1,56 @@+# best3d 03: Rig non-humanoids: SkinTokens, UniRig and AniGen++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now, no gate.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this matters++`workers/rig` rigs humanoids only. VAST's SkinTokens, UniRig and AniGen (all MIT, LICENSE files read 2026-10-09) rig quadrupeds, creatures and props, and AniGen goes image to rigged asset in one pass.++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Step 0: re-derive the current state++ sed -n 1,60p workers/rig/README.md+ for r in SkinTokens UniRig AniGen; do gh api repos/VAST-AI-Research/$r --jq '[.full_name,.pushed_at[:10],.license.spdx_id]|@tsv'; done++## Tasks++1. Add a non-humanoid branch to `workers/rig`: classify the mesh (humanoid vs other) and route non-humanoids to UniRig skeleton prediction plus SkinTokens skinning. Keep Make-It-Animatable for humanoids.+2. Add AniGen as an image-to-rigged-asset lane in Forge (Forge option "rigged at generation").+3. Output must load in the viewer and survive `src/glb-canonicalize.js`; a rig that cannot map to the canonical set still plays its own clips and falls back per the existing `supportsCanonicalClips()` gate.+4. Rig Doctor: add a non-humanoid report (joint count, max influences, unweighted vertices).+5. Docs, README, changelog.++## Definition of done++- [ ] A real quadruped GLB rigs end to end and plays a clip in the viewer.+- [ ] Humanoid rigging output is unchanged on the existing rig tests.+- [ ] `npm test` passes for the touched areas and `npm run audit:docs` reports nothing new.+- [ ] Docs, STRUCTURE.md row where a surface or directory landed, and a `data/changelog.json` entry (then `npm run build:pages`).++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/069-best3d-03-rig-anything.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/070-best3d-04-editable-parts.md b/prompts/finish/070-best3d-04-editable-parts.mdnew file mode 100644index 000000000..ae98179f3--- /dev/null+++ b/prompts/finish/070-best3d-04-editable-parts.md@@ -0,0 +1,54 @@+# best3d 04: Editable parts: PartCrafter and HoloPart behind the segment lane++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now, no gate.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this matters++Vendor E sells image to parts with auto-assembly. PartCrafter (MIT) generates individually editable parts from one image and HoloPart (MIT) completes hidden parts.++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Step 0: re-derive the current state++ sed -n 1,50p workers/segment/README.md+ grep -rln "restyle" src pages | head++## Tasks++1. Add a parts mode: image to part-separated GLB (named nodes per part) via PartCrafter; HoloPart completes occluded parts of an existing mesh already segmented by SAM.+2. Restyle Studio: select a part, recolor, swap or regenerate just that part, then reassemble.+3. Keep node names stable so Order 078 (keep the rig) can preserve them.+4. Docs, worker README, changelog.++## Definition of done++- [ ] A real image yields at least 3 named part nodes and one part is retextured without touching the others.+- [ ] `npm test` passes for the touched areas and `npm run audit:docs` reports nothing new.+- [ ] Docs, STRUCTURE.md row where a surface or directory landed, and a `data/changelog.json` entry (then `npm run build:pages`).++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/070-best3d-04-editable-parts.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/071-best3d-05-lod-and-engine-qa.md b/prompts/finish/071-best3d-05-lod-and-engine-qa.mdnew file mode 100644index 000000000..714e82157--- /dev/null+++ b/prompts/finish/071-best3d-05-lod-and-engine-qa.md@@ -0,0 +1,54 @@+# best3d 05: LOD chains and engine-ready QA++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now, no gate.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this matters++Vendor D offers LOD; nobody ships draw-call, texel-density and collider QA. We already have gltf-transform 4.5 (`simplify`, `palette`, `instance` unused) and Simulation readiness (specs/SIM_READINESS.md).++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Step 0: re-derive the current state++ sed -n 1,40p specs/SIM_READINESS.md; ls packages/glb-tools packages/glb-diff++## Tasks++1. `packages/glb-tools`: a `buildLodChain(glb, {levels})` using gltf-transform `simplify` that emits LOD0..N and writes `MSFT_lod` (and separate files for engines that want them).+2. Engine QA report: draw calls, triangle budget per level, texel density, material count, collider suitability, with pass/fail thresholds in one config.+3. Surface the report in Simulation readiness and Rig Doctor; add a watertight check and STL export for print.+4. API: add `lods` to the export options. Docs, README, changelog.++## Definition of done++- [ ] A real GLB produces 3 LOD levels whose triangle counts decrease and the report renders in the UI.+- [ ] Unit tests cover the chain builder and each QA check.+- [ ] `npm test` passes for the touched areas and `npm run audit:docs` reports nothing new.+- [ ] Docs, STRUCTURE.md row where a surface or directory landed, and a `data/changelog.json` entry (then `npm run build:pages`).++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/071-best3d-05-lod-and-engine-qa.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/072-best3d-06-engine-bridges.md b/prompts/finish/072-best3d-06-engine-bridges.mdnew file mode 100644index 000000000..52a7a4de7--- /dev/null+++ b/prompts/finish/072-best3d-06-engine-bridges.md@@ -0,0 +1,53 @@+# best3d 06: Unity, Unreal and Godot bridges++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now, no gate.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this matters++Vendors A, B and C ship engine plugins. We have a Blender MCP and a public API; the engines can use the same contract.++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Step 0: re-derive the current state++ ls packages | grep -i "blender\|unity\|godot\|unreal"; sed -n 1,40p packages/blender-mcp/README.md++## Tasks++1. Write the shared bridge contract in `specs/ENGINE_BRIDGE.md`: auth, catalog browse, generate, poll, download GLB, import settings.+2. Build `packages/unity-bridge` (UPM package, glTFast import), `packages/godot-bridge` (addon, native glTF), `packages/unreal-bridge` (plugin, Interchange glTF). Each calls only the public API.+3. Each package gets a README with install and a runnable example. Publishing to stores is order 935 (owner-gated).+4. Docs page, changelog.++## Definition of done++- [ ] Each bridge pulls a real generation from the live API in a headless engine smoke test where the engine is installable, and the contract doc is complete otherwise with the untestable engine named in the report.+- [ ] `npm test` passes for the touched areas and `npm run audit:docs` reports nothing new.+- [ ] Docs, STRUCTURE.md row where a surface or directory landed, and a `data/changelog.json` entry (then `npm run build:pages`).++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/072-best3d-06-engine-bridges.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/073-best3d-07-agent3d-ar-viewer-contract.md b/prompts/finish/073-best3d-07-agent3d-ar-viewer-contract.mdnew file mode 100644index 000000000..62cc84442--- /dev/null+++ b/prompts/finish/073-best3d-07-agent3d-ar-viewer-contract.md@@ -0,0 +1,54 @@+# best3d 07: The <agent-3d> AR and viewer contract++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now, no gate.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this matters++model-viewer (Apache-2.0) defines the contract the market expects: ar-modes, on-device USDZ, ar-placement, variant-name, hotspots, poster and skeleton loading. `<agent-3d>` has none, and `/ar` loads a third-party viewer from a CDN.++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Step 0: re-derive the current state++ grep -n "model-viewer" -r pages src public --include=*.html --include=*.js | head; sed -n 1,40p src/usdz-pipeline.js++## Tasks++1. Add attributes: `ar`, `ar-modes`, `ar-placement`, `variant-name` (KHR_materials_variants via the gltf-transform variants API), `poster`, and hotspot slots with saved camera views.+2. AR launch: WebXR where available, Quick Look via on-device USDZ from `src/usdz-pipeline.js`, Scene Viewer intent on Android.+3. Retire the CDN viewer on `/ar`; use the element.+4. Spec the attributes in `specs/`; update embed docs; add tests; changelog.++## Definition of done++- [ ] `/ar` makes no request to a third-party viewer CDN.+- [ ] Variant switching works on a real KHR_materials_variants GLB.+- [ ] `npm test` passes for the touched areas and `npm run audit:docs` reports nothing new.+- [ ] Docs, STRUCTURE.md row where a surface or directory landed, and a `data/changelog.json` entry (then `npm run build:pages`).++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/073-best3d-07-agent3d-ar-viewer-contract.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/074-best3d-08-webgpu-tsl-path.md b/prompts/finish/074-best3d-08-webgpu-tsl-path.mdnew file mode 100644index 000000000..81f9aa17b--- /dev/null+++ b/prompts/finish/074-best3d-08-webgpu-tsl-path.md@@ -0,0 +1,54 @@+# best3d 08: Opt-in WebGPU renderer with TSL materials++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now, no gate.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this matters++three.js r186 treats WebGPURenderer and TSL as primary; we use WebGL everywhere and run r184.++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Step 0: re-derive the current state++ grep -n '"three"' package.json; grep -rln "WebGPU" src | head++## Tasks++1. Bump three to the latest stable that the dependency audit allows, verify the viewer and Scene Studio.+2. Add a renderer factory: WebGPU when supported and opted in (`?renderer=webgpu` and an agent-3d attribute), WebGL2 fallback otherwise. Same visual output on both.+3. Move Restyle material effects to TSL node materials behind the factory; adopt native GaussianSplat and `three-mesh-bvh/webgpu` where they exist.+4. Perf numbers measured on both paths and recorded in docs; changelog.++## Definition of done++- [ ] Viewer renders the same model on both paths with no console errors.+- [ ] Fallback proven by forcing WebGPU unavailable.+- [ ] `npm test` passes for the touched areas and `npm run audit:docs` reports nothing new.+- [ ] Docs, STRUCTURE.md row where a surface or directory landed, and a `data/changelog.json` entry (then `npm run build:pages`).++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/074-best3d-08-webgpu-tsl-path.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/075-best3d-09-three-vrm.md b/prompts/finish/075-best3d-09-three-vrm.mdnew file mode 100644index 000000000..cc445c55e--- /dev/null+++ b/prompts/finish/075-best3d-09-three-vrm.md@@ -0,0 +1,55 @@+# best3d 09: Real VRM: three-vrm integration and orphaned-avatar import++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now, no gate.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this matters++`src/game/vrm-loader.js` documents that it does no spring bones, MToon, expressions or look-at. pixiv/three-vrm (MIT) does all of it and loads `.vrma`. The largest cross-game avatar SDK shut down on 2026-01-31, orphaning every embed that used it.++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Step 0: re-derive the current state++ sed -n 1,60p src/game/vrm-loader.js; grep -n "three-vrm" package.json++## Tasks++1. Add `@pixiv/three-vrm` and replace the hand loader: MToon, spring bones, constraints, look-at, the 18 expression presets, VRM 0.x and 1.0.+2. Map expression presets onto the ARKit-52 driver so voice and face capture drive VRM avatars.+3. Load `.vrma` clips into the animation library through the retargeter.+4. Import landing: accept an avatar GLB or VRM exported from the shut-down SDK, repair its rig through `glb-canonicalize`, and save it to the user's account. The outreach campaign is order 934 (owner-gated).+5. Update docs/avatar-engines.md and tests/glb-canonicalize cases.++## Definition of done++- [ ] A real VRM 1.0 file shows spring-bone motion and an expression change in the viewer.+- [ ] A .vrma clip plays on a VRM and on a non-VRM humanoid.+- [ ] `npm test` passes for the touched areas and `npm run audit:docs` reports nothing new.+- [ ] Docs, STRUCTURE.md row where a surface or directory landed, and a `data/changelog.json` entry (then `npm run build:pages`).++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/075-best3d-09-three-vrm.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/076-best3d-10-audio2face-worker.md b/prompts/finish/076-best3d-10-audio2face-worker.mdnew file mode 100644index 000000000..68d596946--- /dev/null+++ b/prompts/finish/076-best3d-10-audio2face-worker.md@@ -0,0 +1,53 @@+# best3d 10: Audio2Face-3D facial performance worker++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now, no gate.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this matters++Our lip sync estimates visemes from audio energy. NVIDIA Audio2Face-3D emits 52 ARKit blendshapes plus emotion from speech, matching the rig our avatars carry. Weights are under the NVIDIA Open Model License (worker use allowed, never bundle in a package); the SDK is MIT.++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Step 0: re-derive the current state++ sed -n 1,40p docs/nvidia-ngc-listing.md; sed -n 1,40p src/runtime/neural-tts.js++## Tasks++1. `workers/audio2face`: audio in, ARKit-52 track out (JSON and a baked animation clip), emotion channel included. Weights staged from `gs://three-ws-model-weights` after confirming the license terms in the worker README.+2. Wire into the TTS path: after speech synthesis, request a track and play it on the avatar; keep the existing viseme path as the fallback rung when the worker is unavailable or cold.+3. Docs, README, changelog.++## Definition of done++- [ ] A real audio clip produces a 52-channel track that visibly drives an avatar.+- [ ] Killing the worker falls back to visemes with no error.+- [ ] `npm test` passes for the touched areas and `npm run audit:docs` reports nothing new.+- [ ] Docs, STRUCTURE.md row where a surface or directory landed, and a `data/changelog.json` entry (then `npm run build:pages`).++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/076-best3d-10-audio2face-worker.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/077-best3d-11-prompt-to-clip.md b/prompts/finish/077-best3d-11-prompt-to-clip.mdnew file mode 100644index 000000000..4b6b2ff68--- /dev/null+++ b/prompts/finish/077-best3d-11-prompt-to-clip.md@@ -0,0 +1,53 @@+# best3d 11: Prompt-to-clip on any rig with a retarget preview and timeline++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now, no gate.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this matters++Nobody does text to animation on arbitrary rigs well. We run MDM; MoMask (MIT) is the stronger MIT baseline. HY-Motion is reference only (EU, UK, Korea exclusion).++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Step 0: re-derive the current state++ sed -n 1,40p workers/model-text2motion/README.md; ls src | grep -i anim++## Tasks++1. Add a MoMask rung beside MDM in `workers/model-text2motion`, selectable and benchmarked.+2. Animation Studio: prompt box, retarget preview onto the chosen avatar before saving, and a keyframe timeline (Theatre.js UX as reference, never a dependency) with clip trim, blend and loop.+3. Save to the user's clip library for any canonical rig.+4. Docs, changelog.++## Definition of done++- [ ] A prompt produces a clip previewed on a non-default avatar and saved to the library.+- [ ] `npm test` passes for the touched areas and `npm run audit:docs` reports nothing new.+- [ ] Docs, STRUCTURE.md row where a surface or directory landed, and a `data/changelog.json` entry (then `npm run build:pages`).++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/077-best3d-11-prompt-to-clip.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/078-best3d-12-keep-the-rig.md b/prompts/finish/078-best3d-12-keep-the-rig.mdnew file mode 100644index 000000000..2e5cb2296--- /dev/null+++ b/prompts/finish/078-best3d-12-keep-the-rig.md@@ -0,0 +1,52 @@+# best3d 12: Edits that keep topology, UVs, rig and animations++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now, no gate.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this matters++Retexture, part edits and regenerations currently produce a new asset. Preserving topology, UVs, skeleton and clips across versions is white space.++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Step 0: re-derive the current state++ sed -n 1,40p workers/texture/README.md; ls packages/glb-diff++## Tasks++1. Define a "preserve" contract: an edit operation declares which of topology, UVs, skeleton, skin and clips it keeps; the worker verifies after the edit with `packages/glb-diff` and refuses to report success if a preserved property changed.+2. Apply to retexture and part edits first; record lineage in the remix graph and show it in Model Diff.+3. Docs, changelog.++## Definition of done++- [ ] A rigged, animated GLB is retextured and the diff proves skeleton, skin, UVs and clips are identical.+- [ ] `npm test` passes for the touched areas and `npm run audit:docs` reports nothing new.+- [ ] Docs, STRUCTURE.md row where a surface or directory landed, and a `data/changelog.json` entry (then `npm run build:pages`).++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/078-best3d-12-keep-the-rig.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/079-best3d-13-signed-exports-provenance.md b/prompts/finish/079-best3d-13-signed-exports-provenance.mdnew file mode 100644index 000000000..0e0013440--- /dev/null+++ b/prompts/finish/079-best3d-13-signed-exports-provenance.md@@ -0,0 +1,52 @@+# best3d 13: Signed exports and provenance by default++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now, no gate.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this matters++Portable ownership is white space. We have content credentials and a provenance record; they are not on every download.++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Step 0: re-derive the current state++ grep -rln "content-credentials\|c2pa\|provenance" api src packages | head++## Tasks++1. Attach signed content credentials and the provenance record to every GLB download and API export, with an opt-out only for the owner.+2. Show a verified badge on asset pages and a verify endpoint any third party can call.+3. Docs, spec update, changelog.++## Definition of done++- [ ] A downloaded GLB verifies with the public verify endpoint and tampering fails verification.+- [ ] `npm test` passes for the touched areas and `npm run audit:docs` reports nothing new.+- [ ] Docs, STRUCTURE.md row where a surface or directory landed, and a `data/changelog.json` entry (then `npm run build:pages`).++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/079-best3d-13-signed-exports-provenance.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/080-best3d-14-scene-studio-agent.md b/prompts/finish/080-best3d-14-scene-studio-agent.mdnew file mode 100644index 000000000..7cdd04d25--- /dev/null+++ b/prompts/finish/080-best3d-14-scene-studio-agent.md@@ -0,0 +1,53 @@+# best3d 14: Scene Studio inspector, TSL graph and scene-mcp agent tab++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now, no gate.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this matters++Vendor F pairs an editor with an agent tab and an MCP server. We already have `packages/scene-mcp`. Babylon Inspector v2 and the Node Material Editor (Apache-2.0) are UI references.++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Step 0: re-derive the current state++ ls src/scene-studio packages/scene-mcp; sed -n 1,30p packages/scene-mcp/README.md++## Tasks++1. Inspector pane: tree, properties, material, stats.+2. Agent tab in Scene Studio driving `packages/scene-mcp`: the agent reads the scene, calls tools, screenshots to verify, and every prompt creates a version the user can step back through.+3. TSL material graph editor for node materials (depends on order 074).+4. Docs, changelog.++## Definition of done++- [ ] An agent prompt edits a real scene, a screenshot verification is shown, and undo restores the prior version.+- [ ] `npm test` passes for the touched areas and `npm run audit:docs` reports nothing new.+- [ ] Docs, STRUCTURE.md row where a surface or directory landed, and a `data/changelog.json` entry (then `npm run build:pages`).++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/080-best3d-14-scene-studio-agent.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/081-best3d-15-splat-parity.md b/prompts/finish/081-best3d-15-splat-parity.mdnew file mode 100644index 000000000..0f718d922--- /dev/null+++ b/prompts/finish/081-best3d-15-splat-parity.md@@ -0,0 +1,54 @@+# best3d 15: Splat viewer parity: Spark 2.3, hotspots, timeline, TripoSplat++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now, no gate.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this matters++SuperSplat Studio and Spark 2.3 do more than `src/splat-stage.js` (Spark 2.2): LoD tree, paging for huge scenes, annotation hotspots with saved cameras, camera timeline, video export. TripoSplat (MIT) generates splats from an image.++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Step 0: re-derive the current state++ grep -n "spark" package.json; sed -n 1,40p src/splat-stage.js++## Tasks++1. Upgrade Spark to 2.3.x and enable LoD tree and paging for large scenes.+2. Up to 25 annotation hotspots with saved camera views, a camera timeline, and in-browser video export.+3. TripoSplat worker: image to splat as a Forge lane, loaded in the viewer.+4. Docs, changelog.++## Definition of done++- [ ] A real splat file with hotspots and a camera path exports a video.+- [ ] TripoSplat returns a splat from a real image.+- [ ] `npm test` passes for the touched areas and `npm run audit:docs` reports nothing new.+- [ ] Docs, STRUCTURE.md row where a surface or directory landed, and a `data/changelog.json` entry (then `npm run build:pages`).++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/081-best3d-15-splat-parity.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/082-best3d-16-companion-presence.md b/prompts/finish/082-best3d-16-companion-presence.mdnew file mode 100644index 000000000..95a835520--- /dev/null+++ b/prompts/finish/082-best3d-16-companion-presence.md@@ -0,0 +1,53 @@+# best3d 16: Companion presence++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now, no gate.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this matters++Open companion projects (TalkingHead, airi, amica) ship mood systems, emoji to expression, gestures, gaze and active-listening idle. Reimplement, referencing their patterns (TalkingHead is MIT and may be vendored with attribution; others are reference only).++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Step 0: re-derive the current state++ grep -rln "mood\|gesture" src/runtime src/voice | head++## Tasks++1. Mood state machine that biases expression, idle and gesture choice; emoji in agent text maps to expression.+2. LLM-composable gesture tool so an agent can request a gesture by name.+3. Active-listening idle reactions while the user speaks; multi-language viseme timing from TTS word timestamps with the energy-based path as fallback.+4. Docs, changelog.++## Definition of done++- [ ] Mood, emoji and gesture each visibly change a real avatar in the browser.+- [ ] `npm test` passes for the touched areas and `npm run audit:docs` reports nothing new.+- [ ] Docs, STRUCTURE.md row where a surface or directory landed, and a `data/changelog.json` entry (then `npm run build:pages`).++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/082-best3d-16-companion-presence.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/083-best3d-17-generation-controls-batch.md b/prompts/finish/083-best3d-17-generation-controls-batch.mdnew file mode 100644index 000000000..908f91315--- /dev/null+++ b/prompts/finish/083-best3d-17-generation-controls-batch.md@@ -0,0 +1,53 @@+# best3d 17: Polycount, bbox and pose controls plus batch generation++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now, no gate.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this matters++Polycount slider, bbox constraint, T or A pose and batch generation are standard at Vendors A and C; Forge lacks all four.++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Step 0: re-derive the current state++ grep -rn "polycount\|face_count\|batch" api/_lib/forge* workers/remesh | head++## Tasks++1. Add `target_faces`, `bbox` and `pose` (t, a, none) to the generation schema and wire each into the lanes that can honor it; lanes that cannot say so in the lane capability table rather than ignoring it.+2. Batch: submit up to N prompts or images in one call with concurrency tiers by plan; poll as a group.+3. Forge UI controls and a batch queue view. API docs, changelog.++## Definition of done++- [ ] A request with target_faces returns a mesh within 10 percent of the target.+- [ ] A 4-item batch completes and is retrievable as a group.+- [ ] `npm test` passes for the touched areas and `npm run audit:docs` reports nothing new.+- [ ] Docs, STRUCTURE.md row where a surface or directory landed, and a `data/changelog.json` entry (then `npm run build:pages`).++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/083-best3d-17-generation-controls-batch.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/932-best3d-05-pricing-preview-pay-to-keep.md b/prompts/finish/932-best3d-05-pricing-preview-pay-to-keep.mdnew file mode 100644index 000000000..e96f03567--- /dev/null+++ b/prompts/finish/932-best3d-05-pricing-preview-pay-to-keep.md@@ -0,0 +1,46 @@+# best3d 05: Public cost preview and pay-to-keep on Forge (owner-gated)++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Blocked on one owner action; do everything else first.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this is gated++Pricing is the owner's call. Vendors show a cost before spend; one lets users generate free and pay on download.++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Tasks++1. Build the cost-preview API and UI fully wired (no spend). Prepare the pay-to-keep flow behind a flag. Stop and ask the owner for the price points and whether pay-to-keep ships.+2. Wire everything so the remaining owner step is one command or one yes.++## Definition of done++- [ ] Everything buildable is built, verified and committed.+- [ ] The single owner action is stated with exactly what to approve.++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/932-best3d-05-pricing-preview-pay-to-keep.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/933-best3d-06-sam-3d-objects.md b/prompts/finish/933-best3d-06-sam-3d-objects.mdnew file mode 100644index 000000000..8758e1b8b--- /dev/null+++ b/prompts/finish/933-best3d-06-sam-3d-objects.md@@ -0,0 +1,46 @@+# best3d 06: SAM 3D Objects lane for AR Studio (owner-gated)++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Blocked on one owner action; do everything else first.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this is gated++The SAM License has gated weights and a sanctions clause; an owner accepts it once.++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Tasks++1. Build the worker and AR Studio flow wired behind the weights path; ask the owner to accept the license and stage the weights.+2. Wire everything so the remaining owner step is one command or one yes.++## Definition of done++- [ ] Everything buildable is built, verified and committed.+- [ ] The single owner action is stated with exactly what to approve.++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/933-best3d-06-sam-3d-objects.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/934-best3d-07-orphaned-avatar-campaign.md b/prompts/finish/934-best3d-07-orphaned-avatar-campaign.mdnew file mode 100644index 000000000..821860f87--- /dev/null+++ b/prompts/finish/934-best3d-07-orphaned-avatar-campaign.md@@ -0,0 +1,46 @@+# best3d 07: Bring your orphaned avatar campaign (owner-gated)++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Blocked on one owner action; do everything else first.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this is gated++It names another company and posts externally.++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Tasks++1. Draft the landing copy and post set in docs/, neutral wording, positive framing; the owner approves wording and posting.+2. Wire everything so the remaining owner step is one command or one yes.++## Definition of done++- [ ] Everything buildable is built, verified and committed.+- [ ] The single owner action is stated with exactly what to approve.++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/934-best3d-07-orphaned-avatar-campaign.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/935-best3d-08-engine-store-publishing.md b/prompts/finish/935-best3d-08-engine-store-publishing.mdnew file mode 100644index 000000000..fe163f431--- /dev/null+++ b/prompts/finish/935-best3d-08-engine-store-publishing.md@@ -0,0 +1,46 @@+# best3d 08: Publish engine bridges to the stores (owner-gated)++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Blocked on one owner action; do everything else first.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/best3d-00-CONTEXT.md](_context/best3d-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: irreversible spend, git push or deploy, external posting, committing content that names a crypto project other than $THREE, destroying unrecoverable data. Batch every such ask into ONE message at the end.+- Commercial vendors are "Vendor A, B..." in every committed file. Open-source projects are named and credited.+- Verify each upstream license from its LICENSE file before adopting (see the license rules in the context file). Reference-only means build our own, never copy code.+- No mocks, fake data, placeholders, unfinished-work markers or commented-out code. The em-dash and en-dash characters are banned.+- Concurrent agents share this worktree: stage explicit paths only and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this is gated++External publishing under the owner's accounts.++Source of the finding: [docs/research/3d-landscape-2026-10.md](../../docs/research/3d-landscape-2026-10.md).++## Tasks++1. Package and validate each bridge for the store; the owner submits.+2. Wire everything so the remaining owner step is one command or one yes.++## Definition of done++- [ ] Everything buildable is built, verified and committed.+- [ ] The single owner action is stated with exactly what to approve.++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| Missing credential or env var | Follow the credential row of the CLAUDE.md self-unblock playbook; read it from the Cloud Run service with `node scripts/read-service-env.mjs`. |+| GPU quota | File the increase, route to another region or class, continue. |+| Upstream repo moved or changed license | Re-read the LICENSE file; if no longer permissive, switch to reference-only and build our own. |+| Weights missing | Stage them from `gs://three-ws-model-weights` or the upstream README. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (`type(scope): what changed and why a reader cares`).+3. If every line passes, delete this file in that commit (`git rm prompts/finish/935-best3d-08-engine-store-publishing.md`) and append a dated entry to [_context/best3d-PROGRESS.md](_context/best3d-PROGRESS.md) with the commit SHAs. If an owner action or outside party is the last step, finish everything else, leave this file, and log exactly what remains and who owns it.+4. Final report: what step 0 measured; what changed (files and SHAs); evidence per Definition of done line; the single batched owner message if any; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/_context/best3d-00-CONTEXT.md b/prompts/finish/_context/best3d-00-CONTEXT.mdnew file mode 100644index 000000000..5f7458e7c--- /dev/null+++ b/prompts/finish/_context/best3d-00-CONTEXT.md@@ -0,0 +1,53 @@+# best3d: shared context for every `best3d-` work order++Not a work order. Never run this file; read it when an order names it.++## What the campaign is++On 2026-10-09 we swept the open-source and commercial 3D landscape to find what beats three.ws and what to take. The findings, license verdicts and ranking are in [docs/research/3d-landscape-2026-10.md](../../../docs/research/3d-landscape-2026-10.md). The rule the owner set: take a feature where the license allows, and where it does not, build a better original feature using the project only as reference.++## License rules (apply to every order)++| Verdict | Meaning | Examples |+|---|---|---|+| use | Becomes a dependency or a worker lane as-is. MIT, Apache-2.0, BSD. Keep the notice. | TRELLIS.2, Pixal3D, UniRig, SkinTokens, AniGen, PartCrafter, HoloPart, three-vrm, Spark, gltf-transform, MoMask |+| vendor | Copy a module or pattern under its license, with attribution. | TalkingHead, model-viewer attribute API |+| reference | License or closed source forbids reuse. Build our own; copy no code or assets. | all commercial vendors, Theatre.js (UI only), Babylon editors (UI only), Open-LLM-VTuber, HY-Motion, MotionLCM, SMPL-based models |+| gated | Usable only after an owner action or with enforcement. | Hunyuan3D family (EU, UK, South Korea excluded, 1M MAU cap, Notice file), NVIDIA Open Model License weights (never bundle in a package), SAM License (gated download, sanctions clause) |++Always re-read the upstream LICENSE file on the day you adopt: `gh api repos/<owner>/<name>/contents/LICENSE --jq .content | base64 -d | head -30`. `NOASSERTION` from the API means read the file.++## Facts every order relies on++- Commercial vendors are written "Vendor A, B..." in committed files (owner directive). Open-source projects are named.+- Solana first (CLAUDE.md). Generation lanes are chain-agnostic, but any payment, ownership or provenance step is built on Solana first.+- GPU workers deploy from their own `workers/<name>/cloudbuild.yaml` pinned to the `three-ws-build@` service account. Each worker needs a README. Shared worker code is vendored and checked by `npm run check:vendored`.+- Caller-supplied glTF is meshopt-decoded before it is read (`gltf_meshopt.decode_if_meshopt`).+- Avatar animation stays universal: no rig allowlist (CLAUDE.md stack notes).+- Weights live in `gs://three-ws-model-weights`.+- Existing capability map: the "What three.ws already has" table in the research doc. Do not rebuild it.++## Order map++| Order | Item |+|---|---|+| 067 | TRELLIS.2 default lane, Hunyuan territory enforcement (compliance fix, run first) |+| 068 | Pixal3D and multi-view input |+| 069 | Rig non-humanoids |+| 070 | Editable parts |+| 071 | LOD chains and engine QA |+| 072 | Unity, Unreal, Godot bridges |+| 073 | `<agent-3d>` AR and viewer contract |+| 074 | WebGPU and TSL path |+| 075 | three-vrm and orphaned-avatar import |+| 076 | Audio2Face-3D worker |+| 077 | Prompt-to-clip and timeline |+| 078 | Keep the rig |+| 079 | Signed exports and provenance |+| 080 | Scene Studio agent tab |+| 081 | Splat viewer parity |+| 082 | Companion presence |+| 083 | Generation controls and batch |+| 932 to 935 | Owner-gated: pricing preview, SAM 3D Objects, orphaned-avatar campaign, engine-store publishing |++Run 067 first. 068 and 069 build on 067's worker. 070 before 078. 074 before the TSL part of 080.diff --git a/prompts/finish/_context/best3d-PROGRESS.md b/prompts/finish/_context/best3d-PROGRESS.mdnew file mode 100644index 000000000..2643e6764--- /dev/null+++ b/prompts/finish/_context/best3d-PROGRESS.md@@ -0,0 +1,5 @@+# best3d progress log++Append a dated entry per closed order, with commit SHAs.++- 2026-10-09: campaign written from [docs/research/3d-landscape-2026-10.md](../../../docs/research/3d-landscape-2026-10.md). Orders 067 to 083 and 932 to 935 created; none started.