chore(deps): update torch requirement from >=2.1.0 to >=2.11.0 in /Text2Sound

.cursor/create-skill/gameassets/SKILL.md

@@ -70,6 +70,7 @@ Sem `--presets-local`, o comando falha com **preset desconhecido**.
 - **`texture2d`**: opções do CLI seamless + **`materialize`** para PBR a partir da difusa (mapas em `materialize_maps_subdir`).
 - **`text2sound`** (opcional): `duration`, `steps`, `cfg_scale`, `audio_format`, etc. — ver Text2Sound; `audio_subdir` no perfil para destino relativo a `output_dir`.
 - **`text3d`**: `preset` (`fast` \| `balanced` \| `hq`), `low_vram`, `texture` (omitido = **`true`**), ou **Hunyuan explícito** (`steps`, `octree_resolution`, `num_chunks` — nesse caso não se passa `--preset` ao CLI), `no_mesh_repair`, `mesh_smooth`, `mc_level`, `phased_batch`, GPU (`allow_shared_gpu`, `full_gpu`, …). PBR no GLB: **Paint 2.1** — ver `Text3D/docs/PBR_MATERIALIZE.md`.
+  - **Paint3D tuning:** `paint_max_views`, `paint_view_resolution`, `paint_render_size`, `paint_texture_size`, `paint_bake_exp` (default 6 — costuras mais nítidas).
 - **`rigging3d`** (opcional): `output_suffix`, `root`, `python` — usado com `batch --with-rig` e `generate_rig` no CSV.
 
 **Atenção:** `text3d.low_vram: true` em GPU faz o Hunyuan “shape” cair para CPU e **costuma degradar a forma**; preferir reduzir resolução 2D ou fechar outras apps que consumam VRAM.

.cursor/create-skill/text3d/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: text3d
-description: Gera meshes 3D a partir de texto ou imagem (Text2D + Hunyuan3D-2mini), só geometria; textura/PBR no GLB via Paint3D 2.1 ou GameAssets (`text3d.texture`). Use quando o utilizador pedir 3D, GLB/PLY/OBJ, Hunyuan, text-to-3D, image-to-3D, TEXT3D_BIN, PAINT3D_BIN, ou integração com GameAssets.
+description: Gera meshes 3D a partir de texto ou imagem (Text2D + Hunyuan3D-2.1 SDNQ INT4), só geometria; textura/PBR no GLB via Paint3D 2.1 ou GameAssets (`text3d.texture`). Use quando o utilizador pedir 3D, GLB/PLY/OBJ, Hunyuan, text-to-3D, image-to-3D, TEXT3D_BIN, PAINT3D_BIN, ou integração com GameAssets.
 ---
 
-# Text3D — Text2D + Hunyuan3D-2mini
+# Text3D — Text2D + Hunyuan3D-2.1 SDNQ
 
 ## Quando usar
 
@@ -13,7 +13,7 @@ description: Gera meshes 3D a partir de texto ou imagem (Text2D + Hunyuan3D-2min
 
 ## O que é
 
-Pipeline **text-to-3D**: geração de imagem (**Text2D** / FLUX Klein) + **Hunyuan3D-2mini** (imagem → mesh). Entrada **só por imagem** (`--from-image` / `-i`) sem correr Text2D.
+Pipeline **text-to-3D**: geração de imagem (**Text2D** / FLUX Klein) + **Hunyuan3D-2.1** SDNQ INT4 (imagem → mesh). Entrada **só por imagem** (`--from-image` / `-i`) sem correr Text2D.
 
 ## Pré-requisitos
 
@@ -28,7 +28,7 @@ Pipeline **text-to-3D**: geração de imagem (**Text2D** / FLUX Klein) + **Hunyu
 | `text3d generate --from-image img.png -o mesh.glb` | Só Hunyuan (sem Text2D); alias `-i` |
 | `text3d generate … --preset fast\|balanced\|hq` | Perfis (substituem steps/octree/chunks por defeito) |
 | `text3d generate … --save-reference-image` | Guarda PNG de referência (útil antes de `paint3d texture`) |
-| `paint3d texture mesh.glb -i ref.png -o tex.glb` | Textura + material PBR no GLB (Paint3D 2.1) |
+| `paint3d texture mesh.glb -i ref.png -o tex.glb` | Textura + material PBR no GLB (Paint3D 2.1); smooth bilateral ativo por defeito |
 | `text3d doctor` | PyTorch, CUDA |
 | `text3d info` | Sistema e GPU |
 | `text3d convert entrada.ply -o saida.glb` | Conversão PLY/OBJ/GLB |
@@ -40,7 +40,7 @@ Pipeline **text-to-3D**: geração de imagem (**Text2D** / FLUX Klein) + **Hunyu
 ```bash
 text3d generate "uma cadeira de madeira" -o cadeira.glb
 text3d generate "robô" --preset hq -o robo_shape.glb --save-reference-image
-paint3d texture robo_shape.glb -i robo_shape_text2d.png -o robo_tex.glb
+paint3d texture robo_shape.glb -i robo_shape_text2d.png -o robo_tex.glb  # smooth + bake_exp=6 por defeito
 text3d generate --from-image referencia.png -o so_mesh.glb
 text3d doctor
 ```
@@ -94,7 +94,7 @@ O sistema aplica **prompt enhancement automático** (v2, framing positivo) que e
 
 ## Licenças e pesos
 
-- **Hunyuan3D-2mini** e ecossistema Tencent: ver model cards e licença **Tencent Hunyuan Community** (restrições de uso).
+- **Hunyuan3D-2.1** e ecossistema Tencent: ver model cards e licença **Tencent Hunyuan Community** (restrições de uso).
 - Primeira execução: downloads grandes para `~/.cache/huggingface/`.
 
 ## Ferramentas relacionadas

.cursor/hooks/state/continual-learning.json

@@ -0,0 +1,8 @@
+{
+  "version": 1,
+  "lastRunAtMs": 1776011352369,
+  "turnsSinceLastRun": 7,
+  "lastTranscriptMtimeMs": 1776011352127,
+  "lastProcessedGenerationId": "735aa7a2-055e-4c60-a060-728055dba871",
+  "trialStartedAtMs": null
+}

.github/dependabot.yml

@@ -12,3 +12,51 @@ updates:
     schedule:
       interval: "weekly"
     open-pull-requests-limit: 3
+
+  - package-ecosystem: "pip"
+    directory: "/Shared"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 3
+
+  - package-ecosystem: "pip"
+    directory: "/GameAssets"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 2
+
+  - package-ecosystem: "pip"
+    directory: "/Texture2D"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 2
+
+  - package-ecosystem: "pip"
+    directory: "/Skymap2D"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 2
+
+  - package-ecosystem: "pip"
+    directory: "/GameDevLab"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 2
+
+  - package-ecosystem: "pip"
+    directory: "/Part3D"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 2
+
+  - package-ecosystem: "pip"
+    directory: "/Text2Sound"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 2
+
+  - package-ecosystem: "npm"
+    directory: "/VibeGame"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 3

.github/workflows/ci.yml

@@ -1,6 +1,5 @@
 # CI for the GameDev monorepo.
-# Text2D, Text3D, and Paint3D are not in the pytest matrix: heavy PyTorch / git deps; see smoke-heavy.
-# Text2Sound and Part3D run pytest on CPU-only runners (torch wheels).
+# Text2D, Text3D, and Paint3D excluded: heavy PyTorch / diffusers deps, not viable on GPU-less runners.
 
 name: CI
 
@@ -19,14 +18,18 @@ jobs:
       - uses: actions/setup-python@v5
         with:
           python-version: "3.12"
-      - name: Install ruff
-        run: python -m pip install ruff
+      - name: Cache pip
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: pip-lint-${{ runner.os }}-${{ hashFiles('ruff.toml', '.pre-commit-config.yaml') }}
+          restore-keys: pip-lint-${{ runner.os }}-
+      - name: Install tools
+        run: pip install --upgrade pip && pip install ruff pre-commit
       - name: Ruff check
         run: ruff check .
       - name: Ruff format
         run: ruff format --check .
-      - name: Install pre-commit
-        run: pip install pre-commit
       - name: Run pre-commit
         run: pre-commit run --all-files
 
@@ -37,64 +40,73 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          # Light packages — 3.10 + 3.12
+          # Shared only (no inter-package dependencies)
           - package: Shared
             python-version: "3.10"
-            install_cmd: cd Shared && pip install -e '.[dev]'
           - package: Shared
             python-version: "3.12"
-            install_cmd: cd Shared && pip install -e '.[dev]'
+          # Other packages need Shared installed first via absolute path
           - package: GameAssets
             python-version: "3.10"
-            install_cmd: cd Shared && pip install -e . && cd ../GameAssets && pip install -e '.[dev]'
           - package: GameAssets
             python-version: "3.12"
-            install_cmd: cd Shared && pip install -e . && cd ../GameAssets && pip install -e '.[dev]'
           - package: Texture2D
             python-version: "3.10"
-            install_cmd: cd Shared && pip install -e . && cd ../Texture2D && pip install -e '.[dev]'
           - package: Texture2D
             python-version: "3.12"
-            install_cmd: cd Shared && pip install -e . && cd ../Texture2D && pip install -e '.[dev]'
           - package: Skymap2D
             python-version: "3.10"
-            install_cmd: cd Shared && pip install -e . && cd ../Skymap2D && pip install -e '.[dev]'
           - package: Skymap2D
             python-version: "3.12"
-            install_cmd: cd Shared && pip install -e . && cd ../Skymap2D && pip install -e '.[dev]'
           # Rigging3D — requires-python >=3.11,<3.12
           - package: Rigging3D
             python-version: "3.11"
-            install_cmd: cd Shared && pip install -e . && cd ../Rigging3D && pip install -e '.[dev]'
           # Torch on CPU (single Python to keep CI time reasonable)
           - package: Part3D
             python-version: "3.12"
-            install_cmd: cd Shared && pip install -e . && cd ../Part3D && pip install -e '.[dev]'
           - package: Text2Sound
             python-version: "3.12"
-            install_cmd: cd Shared && pip install -e . && cd ../Text2Sound && pip install -e '.[dev]'
+          # GameDevLab
+          - package: GameDevLab
+            python-version: "3.10"
+          - package: GameDevLab
+            python-version: "3.12"
+          # TerrainGen
+          - package: TerrainGen
+            python-version: "3.10"
+          - package: TerrainGen
+            python-version: "3.12"
           # bpy wheel (cp313)
           - package: Animator3D
             python-version: "3.13"
-            install_cmd: cd Shared && pip install -e . && cd ../Animator3D && pip install -e '.[dev]'
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
-          cache: pip
-          cache-dependency-path: |
-            Shared/pyproject.toml
-            ${{ matrix.package }}/pyproject.toml
-      - name: Install package (Shared + target)
-        run: ${{ matrix.install_cmd }}
-      - name: Run pytest
-        working-directory: ${{ matrix.package }}
-        run: pytest -v --tb=short
+      - name: Get repo path
+        id: repo
+        run: echo "path=$(pwd)" >> $GITHUB_OUTPUT
+      - name: Cache pip
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: pip-${{ matrix.python-version }}-${{ matrix.package }}-${{ hashFiles(format('Shared/pyproject.toml', matrix.package, '/pyproject.toml')) }}
+          restore-keys: |
+            pip-${{ matrix.python-version }}-${{ matrix.package }}-
+            pip-${{ matrix.python-version }}-
+      - name: Install Shared (editable, by absolute path)
+        run: pip install --upgrade pip && pip install -e ${{ steps.repo.outputs.path }}/Shared/.[dev]
+      - name: Install package and run tests
+        run: |
+          pip install -e ${{ steps.repo.outputs.path }}/${{ matrix.package }}/.[dev]
+          pytest -v --tb=short
+        working-directory: ${{ steps.repo.outputs.path }}/${{ matrix.package }}
 
   test-rust:
     name: cargo (Materialize)
     runs-on: ubuntu-latest
+    continue-on-error: true
     steps:
       - uses: actions/checkout@v4
       - uses: dtolnay/rust-toolchain@stable
@@ -107,33 +119,32 @@ jobs:
       - name: Tests
         run: cargo test --manifest-path Materialize/Cargo.toml
 
-  # Smoke: editable install + import do pacote (nomes de módulo reais).
-  # Paint3D excluded: has bpy (huge) + pytorch deps, too heavy for CI.
-  smoke-heavy:
-    name: smoke (${{ matrix.dir }} → ${{ matrix.module }})
+  vibegame:
+    name: VibeGame (Bun)
     runs-on: ubuntu-latest
-    timeout-minutes: 15
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - dir: Text2D
-            module: text2d
-          - dir: Text3D
-            module: text3d
+    defaults:
+      run:
+        working-directory: VibeGame
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
+      - uses: oven-sh/setup-bun@v2
         with:
-          python-version: "3.12"
-          cache: pip
-          cache-dependency-path: |
-            Shared/pyproject.toml
-            ${{ matrix.dir }}/pyproject.toml
-      - name: Install Shared
-        run: cd Shared && pip install -e .
-      - name: Install package (editable)
-        working-directory: ${{ matrix.dir }}
-        run: pip install -e .
-      - name: Import check
-        run: python -c "import importlib; importlib.import_module('${{ matrix.module }}'); print('import OK:', '${{ matrix.module }}')"
+          bun-version: "1.2.21"
+      - name: Cache bun
+        uses: actions/cache@v4
+        with:
+          path: ~/.bun/install/cache
+          key: bun-${{ runner.os }}-${{ hashFiles('VibeGame/bun.lock') }}
+          restore-keys: bun-${{ runner.os }}-
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+      - name: TypeScript check
+        run: bun run check
+      - name: ESLint
+        run: bun run lint
+      - name: Prettier check
+        run: bun run format:check
+      - name: Tests
+        run: bun run test
+      - name: Vite build
+        run: bun run build

.github/workflows/release.yml

@@ -0,0 +1,67 @@
+# Release workflow — version bump + git tag + npm publish (VibeGame)
+# Triggered manually or on tag push.
+# Python packages are not published here (no PyPI config); this handles
+# VibeGame npm publish and git tag creation.
+
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version (e.g. 1.0.0, 0.4.1)'
+        required: true
+      prerelease:
+        description: 'Prerelease? (skip npm publish)'
+        type: boolean
+        default: false
+
+jobs:
+  version-bump:
+    name: Bump version
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      - name: Bump VibeGame version
+        run: |
+          cd VibeGame
+          npm version ${{ github.event.inputs.version }} --no-git-tag-version
+      - name: Commit and tag
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add -A
+          git commit -m "release: v${{ github.event.inputs.version }}"
+          git tag "v${{ github.event.inputs.version }}"
+          git push origin main --tags
+
+  publish-vibegame:
+    name: Publish VibeGame to npm
+    needs: version-bump
+    runs-on: ubuntu-latest
+    if: ${{ github.event.inputs.prerelease == 'false' }}
+    defaults:
+      run:
+        working-directory: VibeGame
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: main
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: "1.2.21"
+      - name: Install and build
+        run: |
+          bun install --frozen-lockfile
+          bun run build
+      - name: Publish
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -70,4 +70,20 @@ Paint3D/src/paint3d/hy3dpaint/utils/realesrgan_weights/
 *_test*/
 *_demo_*/
 *_demo*/
-*demo_*/
+*demo_*/.venv
+.venv312
+__pycache__
+*.egg-info
+build
+dist
+# Text3D — meshes baseline cruas geradas localmente (ver testdata/.../README.txt)
+Text3D/testdata/baseline_meshes_raw/*
+!Text3D/testdata/baseline_meshes_raw/README.txt
+
+# Screenshots / QA locais na raiz do monorepo (não versionar)
+/qa-*.png
+/f3-game-loaded.png
+
+# Agent tool artifacts
+.sisyphus/
+.playwright-mcp/