chore: limpar artefactos e assets duplicados no simple-rpg

Remove .playwright-mcp, .sisyphus e estado .cursor/hooks do tracking;
deduplica GLB/PNG em public (só models/textures + áudio/céu/terreno);
.gitignore para meshes/images locais e screenshots; normaliza gameassets_handoff.json;
handoff ignora cópia quando origem=destino; teste em GameAssets.

Made-with: Cursor

Author: maikramer

.gitignore

@@ -88,3 +88,13 @@ Text3D/testdata/baseline_meshes_raw/*
 # Agent tool artifacts
 .sisyphus/
 .playwright-mcp/
+
+# Cursor — estado local dos hooks (não versionar)
+.cursor/hooks/
+
+# VibeGame simple-rpg — saída intermédia do batch (duplica models/textures)
+VibeGame/examples/simple-rpg/public/assets/meshes/
+VibeGame/examples/simple-rpg/public/assets/images/
+
+# Screenshots de teste no exemplo
+VibeGame/examples/simple-rpg/screenshot*.png

GameAssets/src/gameassets/handoff_export.py

@@ -23,6 +23,11 @@ def _safe_public_id(row_id: str) -> str:
 
 
 def _install_file(src: Path, dst: Path, *, copy: bool) -> None:
+    try:
+        if src.resolve() == dst.resolve():
+            return
+    except OSError:
+        pass
     dst.parent.mkdir(parents=True, exist_ok=True)
     if dst.exists() or dst.is_symlink():
         dst.unlink()

GameAssets/tests/test_handoff_export.py

@@ -0,0 +1,15 @@
+"""Tests for handoff_export helpers."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from gameassets.handoff_export import _install_file
+
+
+def test_install_file_noop_when_src_and_dst_identical(tmp_path: Path) -> None:
+    """When output_dir is under public/, audio source and handoff dest can be the same path."""
+    p = tmp_path / "clip.wav"
+    p.write_bytes(b"wavdata")
+    _install_file(p, p, copy=True)
+    assert p.read_bytes() == b"wavdata"

VibeGame/examples/context.md

@@ -26,7 +26,7 @@ examples/
     ├── index.html
     ├── src/main.ts
     ├── public/assets/  # After handoff / batch
-    └── sample-gameassets/  # Optional gameassets dream + batch profile
+    └── sample-gameassets/  # game.yaml + manifest (sem GLB/PNG; saída em public/assets/)
 ```
 
 ## Deterministic terrain placement (entity-centric)

VibeGame/examples/simple-rpg/README.md

@@ -55,11 +55,13 @@ The scene layout and assets were generated by **`gameassets dream`** (dry-run, n
 ```
 sample-gameassets/
   dream_plan.json   # LLM-generated plan (or fallback)
-  game.yaml         # GameAssets batch profile
+  game.yaml         # GameAssets batch profile (output_dir → ../public/assets/)
   manifest.csv      # Asset list (ids, prompts, flags)
   world.xml         # VibeGame scene (for reference)
   main.ts           # Bootstrap code (for reference)
   index.html        # Full page (for reference)
+# GLB/PNG/WAV gerados pelo batch: `public/assets/{meshes,images,audio}/` (local; não versionados no Git).
+# No repositório mantêm-se só `public/assets/{models,textures,audio,sky,terrain}/`.
 ```
 
 ### 2. Generate assets (requires GPU)
@@ -72,8 +74,8 @@ cd VibeGame/examples/simple-rpg/sample-gameassets
 # 2D images + 3D meshes + PBR textures + rigging
 gameassets batch --profile game.yaml --manifest manifest.csv --with-3d --with-rig
 
-# Sky (separate CLI)
-skymap2d generate "bright blue sky with soft clouds over green plains, equirectangular 360" -o sky.png
+# Sky (separate CLI) — escrever directamente em public/assets/sky/
+skymap2d generate "bright blue sky with soft clouds over green plains, equirectangular 360" -o ../public/assets/sky/sky.png
 ```
 
 ### 3. Handoff into public/
@@ -85,19 +87,19 @@ gameassets handoff \
   --public-dir ../public \
   --with-textures
 
-# Copy sky manually (not part of handoff yet)
-mkdir -p ../public/assets/sky
-cp sky.png ../public/assets/sky/sky.png
+# Se usaste -o sky.png na pasta antiga, move: mkdir -p ../public/assets/sky && mv sky.png ../public/assets/sky/
 ```
 
-This creates:
+This creates (or refreshes):
 
 ```
 public/
   assets/
-    models/hero.glb, wooden_crate.glb, crystal_blue.glb, stone_pillar.glb, tree_lowpoly.glb
-    audio/bgm_field.wav, sfx_jump.wav, sfx_save.wav, sfx_load.wav
-    textures/hero.png, ...  (optional diffuse images)
+    meshes/     # saída intermédia do batch (GLB por id) — só local, .gitignore
+    images/     # PNG 2D do Text2D — só local, .gitignore
+    models/     # GLB servidos pelo Vite (handoff)
+    textures/   # PNG difusos (handoff)
+    audio/      # WAV do Text2Sound
     sky/sky.png
     gameassets_handoff.json
 ```