create-threenative 0.2.3 → 0.2.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +53 -2
- package/agent-docs/references/assertion-reference.md +173 -6
- package/agent-docs/references/capability-reference.md +1303 -99
- package/agent-docs/references/capture-the-frame.md +7 -0
- package/agent-docs/references/creating-creatures.md +215 -0
- package/agent-docs/references/ctx-cookbook.md +69 -0
- package/agent-docs/references/debug-surface.md +8 -3
- package/agent-docs/references/dream-loop.md +150 -0
- package/agent-docs/references/finding-assets.md +70 -2
- package/agent-docs/references/sculpt-from-a-reference.md +3 -2
- package/agent-docs/references/trace-a-slow-frame.md +99 -0
- package/agent-docs/references/visual-baseline.md +41 -0
- package/agent-files/.agents/skills/file-engine-bug/SKILL.md +59 -0
- package/agent-files/.agents/skills/prd-creator/SKILL.md +40 -0
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +45 -0
- package/agent-files/.agents/skills/threenative-builder/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +27 -0
- package/agent-files/.agents/skills/threenative-context/SKILL.md +57 -0
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +42 -0
- package/agent-files/.agents/skills/threenative-playtest/SKILL.md +44 -0
- package/agent-files/.agents/skills/threenative-ui/SKILL.md +20 -0
- package/agent-files/.agents/skills/threenative-verifier/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-visuals/SKILL.md +41 -0
- package/agent-files/.claude/skills/file-engine-bug/SKILL.md +59 -0
- package/agent-files/.claude/skills/prd-creator/SKILL.md +40 -0
- package/agent-files/.claude/skills/threenative-assets/SKILL.md +45 -0
- package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +27 -0
- package/agent-files/.claude/skills/threenative-context/SKILL.md +57 -0
- package/agent-files/.claude/skills/threenative-performance/SKILL.md +42 -0
- package/agent-files/.claude/skills/threenative-playtest/SKILL.md +44 -0
- package/agent-files/.claude/skills/threenative-ui/SKILL.md +20 -0
- package/agent-files/.claude/skills/threenative-visuals/SKILL.md +41 -0
- package/agent-files/scripts/reference.mjs +705 -0
- package/agent-files/scripts/visual-loop.mjs +382 -0
- package/capabilities.json +1881 -131
- package/dist/index.d.ts +39 -6
- package/dist/index.js +297 -32
- package/dist/threenative.js +822 -105
- package/package.json +30 -5
- package/template-assets/loading.ts +12 -2
- package/template-assets/patches/three@0.185.1.patch +249 -14
- package/template-assets/worldEnvironment.ts +758 -0
- package/templates/action-rpg/.codex/config.toml +4 -0
- package/templates/action-rpg/.cursor/mcp.json +32 -0
- package/templates/action-rpg/.gemini/settings.json +32 -0
- package/templates/action-rpg/.mcp.json +15 -3
- package/templates/action-rpg/.vscode/mcp.json +36 -0
- package/templates/action-rpg/.zed/settings.json +36 -0
- package/templates/action-rpg/AGENTS.md +69 -378
- package/templates/action-rpg/CLAUDE.md +69 -378
- package/templates/action-rpg/opencode.json +41 -0
- package/templates/action-rpg/package.json +7 -7
- package/templates/action-rpg/playtests/combat.playtest.json +9 -0
- package/templates/action-rpg/playtests/performance.playtest.json +24 -7
- package/templates/action-rpg/playtests/survives.playtest.json +27 -0
- package/templates/action-rpg/playtests/touch-controls.playtest.json +42 -0
- package/templates/action-rpg/src/conventions.ts +35 -0
- package/templates/action-rpg/src/entities/Enemy.ts +2 -3
- package/templates/action-rpg/src/entities/Player.ts +20 -3
- package/templates/action-rpg/src/render/camera.ts +7 -2
- package/templates/action-rpg/src/render/lighting.ts +5 -3
- package/templates/action-rpg/src/render/loading.ts +12 -2
- package/templates/action-rpg/src/render/materials.ts +11 -0
- package/templates/action-rpg/src/render/palette.ts +10 -3
- package/templates/action-rpg/src/render/postprocessing.ts +21 -58
- package/templates/action-rpg/src/render/quality.ts +170 -0
- package/templates/action-rpg/src/render/shapes.ts +185 -26
- package/templates/action-rpg/src/render/touch-controls.ts +185 -0
- package/templates/action-rpg/src/render/vfx.ts +257 -0
- package/templates/action-rpg/src/render/worldEnvironment.ts +208 -33
- package/templates/action-rpg/src/scenes/Play.ts +43 -6
- package/templates/action-rpg/src/style.css +20 -0
- package/templates/action-rpg/threenative.config.ts +7 -0
- package/templates/defense/.codex/config.toml +4 -0
- package/templates/defense/.cursor/mcp.json +32 -0
- package/templates/defense/.gemini/settings.json +32 -0
- package/templates/defense/.mcp.json +15 -3
- package/templates/defense/.vscode/mcp.json +36 -0
- package/templates/defense/.zed/settings.json +36 -0
- package/templates/defense/AGENTS.md +62 -385
- package/templates/defense/CLAUDE.md +62 -385
- package/templates/defense/opencode.json +41 -0
- package/templates/defense/package.json +7 -7
- package/templates/defense/playtests/performance.playtest.json +24 -7
- package/templates/defense/playtests/pointer-placement.playtest.json +87 -20
- package/templates/defense/playtests/scan.playtest.json +1 -1
- package/templates/defense/playtests/survive.playtest.json +14 -0
- package/templates/defense/src/attackers/Attacker.ts +4 -4
- package/templates/defense/src/board/Route.ts +22 -8
- package/templates/defense/src/conventions.ts +18 -0
- package/templates/defense/src/entities/Player.ts +11 -3
- package/templates/defense/src/game.ts +2 -3
- package/templates/defense/src/physics.ts +9 -39
- package/templates/defense/src/placement/Buildable.ts +4 -4
- package/templates/defense/src/render/camera.ts +9 -3
- package/templates/defense/src/render/loading.ts +12 -2
- package/templates/defense/src/render/materials.ts +9 -0
- package/templates/defense/src/render/palette.ts +12 -5
- package/templates/defense/src/render/postprocessing.ts +21 -58
- package/templates/defense/src/render/quality.ts +170 -0
- package/templates/defense/src/render/shapes.ts +142 -23
- package/templates/defense/src/render/sky.ts +2 -2
- package/templates/defense/src/render/worldEnvironment.ts +208 -33
- package/templates/defense/src/scenes/Boot.ts +2 -2
- package/templates/defense/src/scenes/Defense.ts +13 -6
- package/templates/defense/src/style.css +20 -0
- package/templates/defense/src/towers/Tower.ts +11 -12
- package/templates/defense/src/towers/targeting.ts +1 -1
- package/templates/defense/src/ui/App.tsx +2 -2
- package/templates/defense/threenative.config.ts +7 -0
- package/templates/minimal/.codex/config.toml +4 -0
- package/templates/minimal/.cursor/mcp.json +32 -0
- package/templates/minimal/.gemini/settings.json +32 -0
- package/templates/minimal/.mcp.json +15 -3
- package/templates/minimal/.vscode/mcp.json +36 -0
- package/templates/minimal/.zed/settings.json +36 -0
- package/templates/minimal/AGENTS.md +76 -485
- package/templates/minimal/CLAUDE.md +76 -485
- package/templates/minimal/opencode.json +41 -0
- package/templates/minimal/package.json +6 -6
- package/templates/minimal/playtests/play.playtest.json +2 -1
- package/templates/minimal/playtests/survives.playtest.json +48 -4
- package/templates/minimal/playtests/touch-controls.playtest.json +42 -0
- package/templates/minimal/src/conventions.ts +18 -0
- package/templates/minimal/src/entities/Player.ts +39 -6
- package/templates/minimal/src/main.ts +14 -4
- package/templates/minimal/src/render/materials.ts +7 -0
- package/templates/minimal/src/render/palette.ts +3 -3
- package/templates/minimal/src/render/postprocessing.ts +17 -56
- package/templates/minimal/src/render/quality.ts +162 -0
- package/templates/minimal/src/render/sky.ts +23 -9
- package/templates/minimal/src/render/touch-controls.ts +165 -0
- package/templates/minimal/src/render/worldEnvironment.ts +208 -33
- package/templates/minimal/src/scenes/Play.ts +47 -11
- package/templates/minimal/src/style.css +20 -0
- package/templates/minimal/threenative.config.ts +7 -0
- package/templates/platformer/.codex/config.toml +4 -0
- package/templates/platformer/.cursor/mcp.json +32 -0
- package/templates/platformer/.gemini/settings.json +32 -0
- package/templates/platformer/.mcp.json +15 -3
- package/templates/platformer/.vscode/mcp.json +36 -0
- package/templates/platformer/.zed/settings.json +36 -0
- package/templates/platformer/AGENTS.md +70 -430
- package/templates/platformer/CLAUDE.md +70 -430
- package/templates/platformer/opencode.json +41 -0
- package/templates/platformer/package.json +7 -7
- package/templates/platformer/playtests/oneway.playtest.json +29 -2
- package/templates/platformer/playtests/performance.playtest.json +2 -1
- package/templates/platformer/playtests/survives.playtest.json +31 -0
- package/templates/platformer/playtests/terminal-loop-fail.playtest.json +3 -0
- package/templates/platformer/playtests/touch-controls-web.playtest.json +15 -4
- package/templates/platformer/src/conventions.ts +18 -0
- package/templates/platformer/src/entities/Character.ts +63 -1
- package/templates/platformer/src/game.ts +3 -1
- package/templates/platformer/src/level/Platform.ts +13 -1
- package/templates/platformer/src/render/lighting.ts +7 -4
- package/templates/platformer/src/render/loading.ts +12 -2
- package/templates/platformer/src/render/palette.ts +4 -1
- package/templates/platformer/src/render/postprocessing.ts +32 -57
- package/templates/platformer/src/render/quality.ts +170 -0
- package/templates/platformer/src/render/worldEnvironment.ts +208 -33
- package/templates/platformer/src/scenes/Level.ts +52 -12
- package/templates/platformer/src/style.css +20 -0
- package/templates/platformer/threenative.config.ts +7 -0
- package/templates/puzzle/.codex/config.toml +19 -0
- package/templates/puzzle/.cursor/mcp.json +32 -0
- package/templates/puzzle/.gemini/settings.json +32 -0
- package/templates/puzzle/.mcp.json +32 -0
- package/templates/puzzle/.vscode/mcp.json +36 -0
- package/templates/puzzle/.zed/settings.json +36 -0
- package/templates/puzzle/AGENTS.md +96 -0
- package/templates/puzzle/CLAUDE.md +98 -0
- package/templates/puzzle/README.md +43 -0
- package/templates/puzzle/index.html +12 -0
- package/templates/puzzle/kit.json +7 -0
- package/templates/puzzle/opencode.json +41 -0
- package/templates/puzzle/package.json +50 -0
- package/templates/puzzle/playtests/carry.playtest.json +71 -0
- package/templates/puzzle/playtests/performance.playtest.json +23 -0
- package/templates/puzzle/playtests/survives.playtest.json +51 -0
- package/templates/puzzle/playtests/swing.playtest.json +38 -0
- package/templates/puzzle/public/favicon.svg +5 -0
- package/templates/puzzle/src/conventions.ts +25 -0
- package/templates/puzzle/src/entities/Ball.ts +70 -0
- package/templates/puzzle/src/entities/Crate.ts +76 -0
- package/templates/puzzle/src/entities/Gripper.ts +69 -0
- package/templates/puzzle/src/entities/Pendulum.ts +89 -0
- package/templates/puzzle/src/game.ts +48 -0
- package/templates/puzzle/src/main.ts +15 -0
- package/templates/puzzle/src/physics.ts +19 -0
- package/templates/puzzle/src/render/camera.ts +37 -0
- package/templates/puzzle/src/render/lighting.ts +55 -0
- package/templates/puzzle/src/render/loading.ts +325 -0
- package/templates/puzzle/src/render/materials.ts +28 -0
- package/templates/puzzle/src/render/palette.ts +31 -0
- package/templates/puzzle/src/render/postprocessing.ts +34 -0
- package/templates/puzzle/src/render/quality.ts +170 -0
- package/templates/puzzle/src/render/shapes.ts +134 -0
- package/templates/puzzle/src/render/sky.ts +16 -0
- package/templates/puzzle/src/render/touch-controls.ts +185 -0
- package/templates/puzzle/src/render/worldEnvironment.ts +758 -0
- package/templates/puzzle/src/room.ts +83 -0
- package/templates/puzzle/src/scenes/Boot.ts +12 -0
- package/templates/puzzle/src/scenes/Puzzle.ts +158 -0
- package/templates/puzzle/src/state.ts +30 -0
- package/templates/puzzle/src/style.css +96 -0
- package/templates/puzzle/src/ui/App.tsx +22 -0
- package/templates/puzzle/src/ui/GameUi.tsx +20 -0
- package/templates/puzzle/src/ui/Hud.tsx +57 -0
- package/templates/puzzle/src/ui/Menu.tsx +7 -0
- package/templates/puzzle/src/ui/main.tsx +14 -0
- package/templates/puzzle/tailwind.config.ts +1 -0
- package/templates/puzzle/threenative.config.ts +49 -0
- package/templates/puzzle/tsconfig.json +17 -0
- package/templates/puzzle/vite.config.ts +38 -0
- package/templates/racing/.codex/config.toml +4 -0
- package/templates/racing/.cursor/mcp.json +32 -0
- package/templates/racing/.gemini/settings.json +32 -0
- package/templates/racing/.mcp.json +15 -3
- package/templates/racing/.vscode/mcp.json +36 -0
- package/templates/racing/.zed/settings.json +36 -0
- package/templates/racing/AGENTS.md +63 -379
- package/templates/racing/CLAUDE.md +63 -379
- package/templates/racing/native-playtests/survives.playtest.json +43 -0
- package/templates/racing/opencode.json +41 -0
- package/templates/racing/package.json +8 -7
- package/templates/racing/playtests/performance.playtest.json +24 -7
- package/templates/racing/playtests/survives.playtest.json +36 -4
- package/templates/racing/playtests/touch-controls.playtest.json +41 -0
- package/templates/racing/src/conventions.ts +6 -0
- package/templates/racing/src/entities/RacingCar.ts +16 -4
- package/templates/racing/src/entities/Rival.ts +5 -2
- package/templates/racing/src/render/camera.ts +7 -4
- package/templates/racing/src/render/lighting.ts +22 -13
- package/templates/racing/src/render/loading.ts +12 -2
- package/templates/racing/src/render/materials.ts +54 -4
- package/templates/racing/src/render/palette.ts +23 -6
- package/templates/racing/src/render/postprocessing.ts +21 -58
- package/templates/racing/src/render/quality.ts +170 -0
- package/templates/racing/src/render/shapes.ts +537 -26
- package/templates/racing/src/render/sky.ts +5 -2
- package/templates/racing/src/render/touch-controls.ts +185 -0
- package/templates/racing/src/render/worldEnvironment.ts +208 -33
- package/templates/racing/src/scenes/Race.ts +17 -2
- package/templates/racing/src/style.css +20 -0
- package/templates/racing/src/track/Track.ts +270 -31
- package/templates/racing/threenative.config.ts +7 -0
- package/templates/runner/.codex/config.toml +19 -0
- package/templates/runner/.cursor/mcp.json +32 -0
- package/templates/runner/.gemini/settings.json +32 -0
- package/templates/runner/.mcp.json +32 -0
- package/templates/runner/.vscode/mcp.json +36 -0
- package/templates/runner/.zed/settings.json +36 -0
- package/templates/runner/AGENTS.md +96 -0
- package/templates/runner/CLAUDE.md +98 -0
- package/templates/runner/README.md +43 -0
- package/templates/runner/index.html +12 -0
- package/templates/runner/kit.json +7 -0
- package/templates/runner/opencode.json +41 -0
- package/templates/runner/package.json +50 -0
- package/templates/runner/playtests/performance.playtest.json +23 -0
- package/templates/runner/playtests/streams.playtest.json +38 -0
- package/templates/runner/playtests/survives.playtest.json +51 -0
- package/templates/runner/public/favicon.svg +5 -0
- package/templates/runner/src/conventions.ts +24 -0
- package/templates/runner/src/entities/Runner.ts +135 -0
- package/templates/runner/src/game.ts +50 -0
- package/templates/runner/src/main.ts +15 -0
- package/templates/runner/src/physics.ts +13 -0
- package/templates/runner/src/render/camera.ts +39 -0
- package/templates/runner/src/render/dust.ts +131 -0
- package/templates/runner/src/render/lighting.ts +57 -0
- package/templates/runner/src/render/loading.ts +325 -0
- package/templates/runner/src/render/materials.ts +27 -0
- package/templates/runner/src/render/palette.ts +30 -0
- package/templates/runner/src/render/postprocessing.ts +34 -0
- package/templates/runner/src/render/quality.ts +170 -0
- package/templates/runner/src/render/shapes.ts +68 -0
- package/templates/runner/src/render/sky.ts +51 -0
- package/templates/runner/src/render/touch-controls.ts +185 -0
- package/templates/runner/src/render/worldEnvironment.ts +758 -0
- package/templates/runner/src/scenes/Boot.ts +12 -0
- package/templates/runner/src/scenes/Run.ts +142 -0
- package/templates/runner/src/state.ts +29 -0
- package/templates/runner/src/style.css +96 -0
- package/templates/runner/src/track.ts +176 -0
- package/templates/runner/src/ui/App.tsx +22 -0
- package/templates/runner/src/ui/GameUi.tsx +20 -0
- package/templates/runner/src/ui/Hud.tsx +55 -0
- package/templates/runner/src/ui/Menu.tsx +7 -0
- package/templates/runner/src/ui/main.tsx +14 -0
- package/templates/runner/tailwind.config.ts +1 -0
- package/templates/runner/threenative.config.ts +49 -0
- package/templates/runner/tsconfig.json +17 -0
- package/templates/runner/vite.config.ts +38 -0
- package/templates/sailing/.codex/config.toml +4 -0
- package/templates/sailing/.cursor/mcp.json +32 -0
- package/templates/sailing/.gemini/settings.json +32 -0
- package/templates/sailing/.mcp.json +15 -3
- package/templates/sailing/.vscode/mcp.json +36 -0
- package/templates/sailing/.zed/settings.json +36 -0
- package/templates/sailing/AGENTS.md +62 -355
- package/templates/sailing/CLAUDE.md +62 -355
- package/templates/sailing/README.md +12 -9
- package/templates/sailing/native-playtests/float.playtest.json +55 -0
- package/templates/sailing/native-playtests/survives.playtest.json +20 -3
- package/templates/sailing/opencode.json +41 -0
- package/templates/sailing/package.json +8 -8
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +75 -0
- package/templates/sailing/playtests/float.playtest.json +59 -0
- package/templates/sailing/playtests/performance.playtest.json +21 -6
- package/templates/sailing/playtests/survives.playtest.json +8 -0
- package/templates/sailing/playtests/touch-controls.playtest.json +48 -0
- package/templates/sailing/src/conventions.ts +8 -0
- package/templates/sailing/src/entities/Ship.ts +150 -13
- package/templates/sailing/src/render/camera.ts +15 -8
- package/templates/sailing/src/render/lighting.ts +10 -5
- package/templates/sailing/src/render/loading.ts +12 -2
- package/templates/sailing/src/render/materials.ts +24 -8
- package/templates/sailing/src/render/ocean.ts +179 -0
- package/templates/sailing/src/render/palette.ts +14 -21
- package/templates/sailing/src/render/postprocessing.ts +23 -22
- package/templates/sailing/src/render/props.ts +584 -34
- package/templates/sailing/src/render/quality.ts +140 -0
- package/templates/sailing/src/render/sky.ts +8 -3
- package/templates/sailing/src/render/touch-controls.ts +142 -0
- package/templates/sailing/src/render/worldEnvironment.ts +206 -38
- package/templates/sailing/src/scenes/Sailing.ts +43 -16
- package/templates/sailing/src/style.css +20 -0
- package/templates/sailing/threenative.config.ts +7 -1
- package/templates/shooter/.codex/config.toml +4 -0
- package/templates/shooter/.cursor/mcp.json +32 -0
- package/templates/shooter/.gemini/settings.json +32 -0
- package/templates/shooter/.mcp.json +15 -3
- package/templates/shooter/.vscode/mcp.json +36 -0
- package/templates/shooter/.zed/settings.json +36 -0
- package/templates/shooter/AGENTS.md +76 -415
- package/templates/shooter/CLAUDE.md +76 -415
- package/templates/shooter/kit.json +2 -2
- package/templates/shooter/opencode.json +41 -0
- package/templates/shooter/package.json +7 -7
- package/templates/shooter/playtests/combat.playtest.json +48 -0
- package/templates/shooter/playtests/input-control.playtest.json +165 -35
- package/templates/shooter/playtests/per-item.playtest.json +3 -3
- package/templates/shooter/playtests/performance.playtest.json +24 -7
- package/templates/shooter/playtests/shooter.playtest.json +13 -7
- package/templates/shooter/playtests/survives.playtest.json +27 -0
- package/templates/shooter/playtests/touch-controls.playtest.json +42 -0
- package/templates/shooter/playtests/weapon-cycle.playtest.json +164 -0
- package/templates/shooter/src/combat/damage.ts +1 -2
- package/templates/shooter/src/conventions.ts +51 -0
- package/templates/shooter/src/entities/Player.ts +235 -18
- package/templates/shooter/src/entities/Target.ts +2 -2
- package/templates/shooter/src/game.ts +13 -4
- package/templates/shooter/src/render/camera.ts +49 -39
- package/templates/shooter/src/render/decals.ts +211 -0
- package/templates/shooter/src/render/lighting.ts +7 -3
- package/templates/shooter/src/render/loading.ts +12 -2
- package/templates/shooter/src/render/materials.ts +56 -3
- package/templates/shooter/src/render/palette.ts +6 -3
- package/templates/shooter/src/render/postprocessing.ts +21 -58
- package/templates/shooter/src/render/quality.ts +170 -0
- package/templates/shooter/src/render/scale.ts +22 -0
- package/templates/shooter/src/render/shapes.ts +343 -62
- package/templates/shooter/src/render/sky.ts +5 -1
- package/templates/shooter/src/render/touch-controls.ts +305 -0
- package/templates/shooter/src/render/ui.css +85 -0
- package/templates/shooter/src/render/ui.ts +19 -3
- package/templates/shooter/src/render/vfx.ts +215 -0
- package/templates/shooter/src/render/worldEnvironment.ts +208 -33
- package/templates/shooter/src/scenes/Play.ts +171 -56
- package/templates/shooter/src/state.ts +5 -0
- package/templates/shooter/src/style.css +20 -0
- package/templates/shooter/src/ui/Crosshair.tsx +25 -0
- package/templates/shooter/src/ui/GameUi.tsx +2 -0
- package/templates/shooter/src/ui/Hud.tsx +7 -1
- package/templates/shooter/src/weapons/Hitscan.ts +3 -4
- package/templates/shooter/src/weapons/Projectile.ts +8 -3
- package/templates/shooter/src/weapons/Viewmodel.ts +275 -0
- package/templates/shooter/threenative.config.ts +7 -0
- package/templates/starter/.codex/config.toml +4 -0
- package/templates/starter/.cursor/mcp.json +32 -0
- package/templates/starter/.gemini/settings.json +32 -0
- package/templates/starter/.mcp.json +15 -3
- package/templates/starter/.vscode/mcp.json +36 -0
- package/templates/starter/.zed/settings.json +36 -0
- package/templates/starter/AGENTS.md +70 -527
- package/templates/starter/CLAUDE.md +70 -527
- package/templates/starter/native-playtests/render-chain.playtest.json +73 -4
- package/templates/starter/opencode.json +41 -0
- package/templates/starter/package.json +7 -7
- package/templates/starter/playtests/boot-failure.playtest.json +45 -0
- package/templates/starter/playtests/look.playtest.json +110 -6
- package/templates/starter/playtests/play.playtest.json +3 -2
- package/templates/starter/playtests/survives.playtest.json +21 -0
- package/templates/starter/playtests/touch-controls.playtest.json +42 -0
- package/templates/starter/src/conventions.ts +18 -0
- package/templates/starter/src/entities/Goal.ts +18 -3
- package/templates/starter/src/entities/Player.ts +72 -9
- package/templates/starter/src/game.ts +2 -0
- package/templates/starter/src/render/adaptiveQuality.ts +195 -0
- package/templates/starter/src/render/camera.ts +1 -1
- package/templates/starter/src/render/coast.ts +199 -0
- package/templates/starter/src/render/hero.ts +88 -0
- package/templates/starter/src/render/implicitSurface.ts +199 -0
- package/templates/starter/src/render/kuwahara.ts +174 -0
- package/templates/starter/src/render/lighting.ts +4 -4
- package/templates/starter/src/render/loading.ts +12 -2
- package/templates/starter/src/render/materials.ts +25 -6
- package/templates/starter/src/render/outline.ts +141 -0
- package/templates/starter/src/render/painterly.ts +86 -0
- package/templates/starter/src/render/palette.ts +15 -6
- package/templates/starter/src/render/postprocessing.ts +87 -36
- package/templates/starter/src/render/quality.ts +185 -0
- package/templates/starter/src/render/rockRidge.ts +198 -0
- package/templates/starter/src/render/rockRidge.worker.ts +77 -0
- package/templates/starter/src/render/scenery.ts +16 -59
- package/templates/starter/src/render/textureLifetime.ts +53 -0
- package/templates/starter/src/render/touch-controls.ts +165 -0
- package/templates/starter/src/render/water.ts +38 -0
- package/templates/starter/src/render/watercolor.ts +85 -0
- package/templates/starter/src/render/worldEnvironment.ts +208 -33
- package/templates/starter/src/scenes/Play.ts +103 -16
- package/templates/starter/src/style.css +27 -7
- package/templates/starter/threenative.config.ts +7 -7
- package/agent-docs/asset-mcp-loop.md +0 -33
- package/agent-docs/ctx-surface.md +0 -69
- package/agent-docs/engine-capabilities.md +0 -4
- package/agent-docs/framework-blocks-you.md +0 -60
- package/agent-docs/look-at-it-and-budget-the-look.md +0 -27
- package/agent-docs/performance-default.md +0 -42
- package/agent-docs/pixel-budget.md +0 -20
- package/agent-docs/playtest-fail-closed.md +0 -23
- package/agent-docs/sculpt-loop.md +0 -16
- package/templates/action-rpg/src/physics.ts +0 -40
- package/templates/defense/public/icon.png +0 -0
- package/templates/minimal/public/icon.png +0 -0
- package/templates/platformer/public/icon.png +0 -0
- package/templates/racing/public/icon.png +0 -0
- package/templates/sailing/public/icon.png +0 -0
- package/templates/sailing/src/render/water-material.ts +0 -14
- package/templates/sailing/src/render/water-shaders.ts +0 -12
- package/templates/sailing/src/render/wave-nodes.ts +0 -10
- package/templates/shooter/public/icon.png +0 -0
- package/templates/shooter/src/physics.ts +0 -49
- package/templates/starter/public/icon.png +0 -0
- /package/{templates/action-rpg/public → template-assets}/icon.png +0 -0
|
@@ -0,0 +1,382 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
import { createHash, randomUUID } from "node:crypto";
|
|
4
|
+
import { open, readFile, realpath, rename, rm, stat } from "node:fs/promises";
|
|
5
|
+
import path from "node:path";
|
|
6
|
+
|
|
7
|
+
const SCHEMA_VERSION = 1;
|
|
8
|
+
const DECISIONS = new Set([
|
|
9
|
+
"continue",
|
|
10
|
+
"replan",
|
|
11
|
+
"accepted",
|
|
12
|
+
"stalled",
|
|
13
|
+
"budget-exhausted",
|
|
14
|
+
"unavailable",
|
|
15
|
+
]);
|
|
16
|
+
|
|
17
|
+
class InputError extends Error {
|
|
18
|
+
constructor(message) {
|
|
19
|
+
super(message);
|
|
20
|
+
this.name = "InputError";
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
function fail(message) {
|
|
25
|
+
throw new InputError(message);
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
function sha256(bytes) {
|
|
29
|
+
return createHash("sha256").update(bytes).digest("hex");
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
function safeRelative(root, candidate, label) {
|
|
33
|
+
const resolved = path.resolve(candidate);
|
|
34
|
+
const relative = path.relative(root, resolved);
|
|
35
|
+
if (
|
|
36
|
+
relative === "" ||
|
|
37
|
+
relative === ".." ||
|
|
38
|
+
relative.startsWith(`..${path.sep}`) ||
|
|
39
|
+
path.isAbsolute(relative)
|
|
40
|
+
)
|
|
41
|
+
fail(`${label} escapes its declared artifact root`);
|
|
42
|
+
return resolved;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
async function assertInside(root, candidate, label) {
|
|
46
|
+
const resolved = safeRelative(root, candidate, label);
|
|
47
|
+
const existing = await realpath(resolved).catch(() => undefined);
|
|
48
|
+
if (existing !== undefined) safeRelative(root, existing, label);
|
|
49
|
+
else {
|
|
50
|
+
const parent = await realpath(path.dirname(resolved)).catch(() => undefined);
|
|
51
|
+
if (parent !== undefined && parent !== root) safeRelative(root, parent, label);
|
|
52
|
+
}
|
|
53
|
+
return resolved;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
async function atomicWriteJson(file, value) {
|
|
57
|
+
const temporary = `${file}.${process.pid}.${randomUUID()}.tmp`;
|
|
58
|
+
const handle = await open(temporary, "wx");
|
|
59
|
+
try {
|
|
60
|
+
await handle.writeFile(`${JSON.stringify(value, null, 2)}\n`, "utf8");
|
|
61
|
+
await handle.sync();
|
|
62
|
+
} finally {
|
|
63
|
+
await handle.close();
|
|
64
|
+
}
|
|
65
|
+
await rename(temporary, file);
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
async function acquireLock(recordFile) {
|
|
69
|
+
const lockFile = `${recordFile}.lock`;
|
|
70
|
+
for (let attempt = 0; attempt < 2; attempt += 1) {
|
|
71
|
+
try {
|
|
72
|
+
const handle = await open(lockFile, "wx");
|
|
73
|
+
await handle.writeFile(
|
|
74
|
+
`${JSON.stringify({ pid: process.pid, startedAt: new Date().toISOString() })}\n`,
|
|
75
|
+
"utf8",
|
|
76
|
+
);
|
|
77
|
+
await handle.close();
|
|
78
|
+
return async () => rm(lockFile, { force: true });
|
|
79
|
+
} catch (error) {
|
|
80
|
+
if (error?.code !== "EEXIST") throw error;
|
|
81
|
+
const owner = JSON.parse(await readFile(lockFile, "utf8").catch(() => "{}"));
|
|
82
|
+
const pid = Number(owner.pid);
|
|
83
|
+
let live = false;
|
|
84
|
+
if (Number.isInteger(pid) && pid > 0) {
|
|
85
|
+
try {
|
|
86
|
+
process.kill(pid, 0);
|
|
87
|
+
live = true;
|
|
88
|
+
} catch {
|
|
89
|
+
live = false;
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
if (live) throw new InputError("run is locked by another writer");
|
|
93
|
+
await rm(lockFile, { force: true });
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
throw new InputError("could not acquire run lock");
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
function parseArgs(argv) {
|
|
100
|
+
if (argv.includes("--help")) return { help: true };
|
|
101
|
+
if (argv.length !== 2 || argv[0] !== "--record" || argv[1] === "")
|
|
102
|
+
fail("usage: node scripts/visual-loop.mjs --record RUN.json");
|
|
103
|
+
return { record: argv[1] };
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
function ensureRecord(record) {
|
|
107
|
+
if (
|
|
108
|
+
!record ||
|
|
109
|
+
record.schemaVersion !== SCHEMA_VERSION ||
|
|
110
|
+
typeof record.runId !== "string" ||
|
|
111
|
+
typeof record.projectRoot !== "string"
|
|
112
|
+
)
|
|
113
|
+
fail("record schemaVersion, runId and projectRoot are required");
|
|
114
|
+
if (!path.isAbsolute(record.projectRoot)) fail("record projectRoot must be absolute");
|
|
115
|
+
if (typeof record.builderIdentity !== "string" || record.builderIdentity === "")
|
|
116
|
+
fail("record builderIdentity is required");
|
|
117
|
+
if (
|
|
118
|
+
!record.limits ||
|
|
119
|
+
!Number.isInteger(record.limits.maxRounds) ||
|
|
120
|
+
record.limits.maxRounds < 1 ||
|
|
121
|
+
!Number.isInteger(record.limits.maxImageRequests) ||
|
|
122
|
+
record.limits.maxImageRequests < 1
|
|
123
|
+
)
|
|
124
|
+
fail("record limits.maxRounds and limits.maxImageRequests are required");
|
|
125
|
+
if (!record.limits.deadlineAt || Number.isNaN(Date.parse(record.limits.deadlineAt)))
|
|
126
|
+
fail("record limits.deadlineAt is required");
|
|
127
|
+
if (
|
|
128
|
+
!record.target ||
|
|
129
|
+
typeof record.target.path !== "string" ||
|
|
130
|
+
!/^[a-f0-9]{64}$/u.test(record.target.sha256 ?? "")
|
|
131
|
+
)
|
|
132
|
+
fail("record target path and SHA-256 are required");
|
|
133
|
+
if (!Array.isArray(record.rounds)) fail("record rounds must be an array");
|
|
134
|
+
record.requests ??= {};
|
|
135
|
+
for (const key of ["pending", "completed", "unknown", "failed"]) {
|
|
136
|
+
if (!Array.isArray(record.requests[key])) fail(`record requests.${key} must be an array`);
|
|
137
|
+
}
|
|
138
|
+
return record;
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
function recordRoots(record, recordFile) {
|
|
142
|
+
const projectRoot = path.resolve(record.projectRoot);
|
|
143
|
+
const artifactRoot = path.resolve(
|
|
144
|
+
projectRoot,
|
|
145
|
+
record.artifactRoot ?? path.relative(projectRoot, path.dirname(recordFile)),
|
|
146
|
+
);
|
|
147
|
+
if (artifactRoot !== projectRoot) safeRelative(projectRoot, artifactRoot, "artifactRoot");
|
|
148
|
+
return { projectRoot, artifactRoot };
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
function countRequests(record) {
|
|
152
|
+
return (
|
|
153
|
+
record.requests.pending.length +
|
|
154
|
+
record.requests.completed.length +
|
|
155
|
+
record.requests.unknown.length
|
|
156
|
+
);
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
async function fileHash(root, relativePath, label) {
|
|
160
|
+
const file = await assertInside(root, path.resolve(root, relativePath), label);
|
|
161
|
+
const bytes = await readFile(file).catch(() => {
|
|
162
|
+
throw new InputError(`${label} is missing: ${relativePath}`);
|
|
163
|
+
});
|
|
164
|
+
if (bytes.length === 0) fail(`${label} is empty: ${relativePath}`);
|
|
165
|
+
return { file, sha256: sha256(bytes) };
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
function scoreFor(review) {
|
|
169
|
+
const categories = {
|
|
170
|
+
framing: review.framing,
|
|
171
|
+
lighting: review.lighting,
|
|
172
|
+
material: review.material,
|
|
173
|
+
finish: review.finish,
|
|
174
|
+
};
|
|
175
|
+
const bounds = { framing: 3, lighting: 3, material: 3, finish: 1 };
|
|
176
|
+
for (const [name, maximum] of Object.entries(bounds)) {
|
|
177
|
+
if (!Number.isInteger(categories[name]) || categories[name] < 0 || categories[name] > maximum)
|
|
178
|
+
fail(`critic score '${name}' must be an integer from 0 to ${maximum}`);
|
|
179
|
+
}
|
|
180
|
+
return categories.framing + categories.lighting + categories.material + categories.finish;
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
function normalizedGaps(gaps) {
|
|
184
|
+
return JSON.stringify(
|
|
185
|
+
(Array.isArray(gaps) ? gaps : [])
|
|
186
|
+
.map((gap) => (typeof gap === "string" ? gap : JSON.stringify(gap)))
|
|
187
|
+
.sort(),
|
|
188
|
+
);
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
function allAssertionsPassed(functional) {
|
|
192
|
+
if (!functional || !Array.isArray(functional.assertions) || functional.assertions.length === 0)
|
|
193
|
+
return false;
|
|
194
|
+
return functional.assertions.every(
|
|
195
|
+
(assertion) => assertion?.passed === true || assertion?.status === "passed",
|
|
196
|
+
);
|
|
197
|
+
}
|
|
198
|
+
|
|
199
|
+
function performancePassed(performance) {
|
|
200
|
+
if (!performance || !Number.isFinite(performance.targetFps) || performance.targetFps <= 0)
|
|
201
|
+
return false;
|
|
202
|
+
if (!Number.isFinite(performance.displayMaxFps) || performance.displayMaxFps <= 0) return false;
|
|
203
|
+
if (!Array.isArray(performance.windows) || performance.windows.length === 0) return false;
|
|
204
|
+
return performance.windows.every(
|
|
205
|
+
(window) => Number.isFinite(window?.fps) && window.fps >= performance.targetFps,
|
|
206
|
+
);
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
async function validateRound(record, round, roots) {
|
|
210
|
+
if (
|
|
211
|
+
!round ||
|
|
212
|
+
typeof round.round !== "number" ||
|
|
213
|
+
!Number.isInteger(round.round) ||
|
|
214
|
+
round.round < 1
|
|
215
|
+
)
|
|
216
|
+
fail("round number is invalid");
|
|
217
|
+
const target = await fileHash(roots.projectRoot, record.target.path, "target");
|
|
218
|
+
if (target.sha256 !== record.target.sha256)
|
|
219
|
+
return { accepted: false, decision: "unavailable", reason: "target-hash-mismatch" };
|
|
220
|
+
if (
|
|
221
|
+
!round.capture ||
|
|
222
|
+
typeof round.capture.path !== "string" ||
|
|
223
|
+
!/^[a-f0-9]{64}$/u.test(round.capture.sha256 ?? "")
|
|
224
|
+
)
|
|
225
|
+
return { accepted: false, decision: "unavailable", reason: "capture-receipt-missing" };
|
|
226
|
+
const capture = await fileHash(roots.projectRoot, round.capture.path, "capture");
|
|
227
|
+
if (capture.sha256 !== round.capture.sha256)
|
|
228
|
+
return { accepted: false, decision: "unavailable", reason: "capture-hash-mismatch" };
|
|
229
|
+
if (round.capture.targetSha256 !== record.target.sha256)
|
|
230
|
+
return { accepted: false, decision: "unavailable", reason: "capture-target-stale" };
|
|
231
|
+
if (
|
|
232
|
+
record.currentSourceSha256 !== undefined &&
|
|
233
|
+
round.capture.sourceSha256 !== record.currentSourceSha256
|
|
234
|
+
)
|
|
235
|
+
return { accepted: false, decision: "unavailable", reason: "capture-source-stale" };
|
|
236
|
+
if (!round.platform || !round.adapter)
|
|
237
|
+
return { accepted: false, decision: "unavailable", reason: "capture-platform-missing" };
|
|
238
|
+
if (!allAssertionsPassed(round.functional))
|
|
239
|
+
return { accepted: false, decision: "unavailable", reason: "functional-observation-missing" };
|
|
240
|
+
if (!round.review || !["PASS", "REQUEST_CHANGES", "NOT_OBSERVED"].includes(round.review.status))
|
|
241
|
+
return { accepted: false, decision: "unavailable", reason: "independent-review-missing" };
|
|
242
|
+
if (
|
|
243
|
+
round.review.criticIdentity === undefined ||
|
|
244
|
+
round.review.criticIdentity === record.builderIdentity
|
|
245
|
+
)
|
|
246
|
+
return {
|
|
247
|
+
accepted: false,
|
|
248
|
+
decision: "unavailable",
|
|
249
|
+
reason: "independent-review-identity-missing",
|
|
250
|
+
};
|
|
251
|
+
if (
|
|
252
|
+
round.review.targetSha256 !== record.target.sha256 ||
|
|
253
|
+
round.review.captureSha256 !== round.capture.sha256
|
|
254
|
+
)
|
|
255
|
+
return { accepted: false, decision: "unavailable", reason: "reviewed-artifact-stale" };
|
|
256
|
+
const score = scoreFor(round.review);
|
|
257
|
+
if (!performancePassed(round.performance))
|
|
258
|
+
return {
|
|
259
|
+
accepted: false,
|
|
260
|
+
decision: "unavailable",
|
|
261
|
+
reason: "performance-observation-missing",
|
|
262
|
+
score,
|
|
263
|
+
};
|
|
264
|
+
if (round.review.status !== "PASS")
|
|
265
|
+
return {
|
|
266
|
+
accepted: false,
|
|
267
|
+
decision: "continue",
|
|
268
|
+
reason:
|
|
269
|
+
round.review.status === "NOT_OBSERVED"
|
|
270
|
+
? "independent-review-not-observed"
|
|
271
|
+
: "critic-requested-changes",
|
|
272
|
+
score,
|
|
273
|
+
gaps: round.review.gaps ?? [],
|
|
274
|
+
};
|
|
275
|
+
if (score < 8)
|
|
276
|
+
return {
|
|
277
|
+
accepted: false,
|
|
278
|
+
decision: "continue",
|
|
279
|
+
reason: "visual-score-below-8",
|
|
280
|
+
score,
|
|
281
|
+
gaps: round.review.gaps ?? [],
|
|
282
|
+
};
|
|
283
|
+
if ((round.review.blockers ?? []).length > 0)
|
|
284
|
+
return {
|
|
285
|
+
accepted: false,
|
|
286
|
+
decision: "continue",
|
|
287
|
+
reason: "visual-blocker-present",
|
|
288
|
+
score,
|
|
289
|
+
gaps: round.review.gaps ?? [],
|
|
290
|
+
};
|
|
291
|
+
return {
|
|
292
|
+
accepted: true,
|
|
293
|
+
decision: "accepted",
|
|
294
|
+
reason: "all-required-evidence-observed",
|
|
295
|
+
score,
|
|
296
|
+
gaps: round.review.gaps ?? [],
|
|
297
|
+
};
|
|
298
|
+
}
|
|
299
|
+
|
|
300
|
+
function reconcilePending(record) {
|
|
301
|
+
if (record.requests.pending.length === 0) return false;
|
|
302
|
+
const now = new Date().toISOString();
|
|
303
|
+
for (const pending of record.requests.pending.splice(0))
|
|
304
|
+
record.requests.unknown.push({ ...pending, finishedAt: now, category: "interrupted" });
|
|
305
|
+
return true;
|
|
306
|
+
}
|
|
307
|
+
|
|
308
|
+
function boundedDecision(record, result) {
|
|
309
|
+
if (result.accepted) return result;
|
|
310
|
+
if (countRequests(record) >= record.limits.maxImageRequests)
|
|
311
|
+
return { ...result, decision: "budget-exhausted", reason: "image-request-limit" };
|
|
312
|
+
if (record.rounds.length >= record.limits.maxRounds)
|
|
313
|
+
return { ...result, decision: "budget-exhausted", reason: "round-limit" };
|
|
314
|
+
if (Date.now() >= Date.parse(record.limits.deadlineAt))
|
|
315
|
+
return { ...result, decision: "budget-exhausted", reason: "deadline" };
|
|
316
|
+
return result;
|
|
317
|
+
}
|
|
318
|
+
|
|
319
|
+
function applyGapStall(record, result) {
|
|
320
|
+
if (
|
|
321
|
+
!result.gaps ||
|
|
322
|
+
result.gaps.length === 0 ||
|
|
323
|
+
record.rounds.length < 2 ||
|
|
324
|
+
result.decision !== "continue"
|
|
325
|
+
)
|
|
326
|
+
return result;
|
|
327
|
+
const previous = record.rounds.at(-2);
|
|
328
|
+
if (normalizedGaps(previous?.review?.gaps) !== normalizedGaps(result.gaps)) return result;
|
|
329
|
+
const latestRound = record.rounds.at(-1).round;
|
|
330
|
+
if (record.replanUsed === true && record.replanRound === latestRound)
|
|
331
|
+
return { ...result, decision: "replan", reason: "repeated-gaps-require-one-replan" };
|
|
332
|
+
if (record.replanUsed === true)
|
|
333
|
+
return { ...result, decision: "stalled", reason: "replan-did-not-improve-repeated-gaps" };
|
|
334
|
+
record.replanUsed = true;
|
|
335
|
+
record.replanRound = latestRound;
|
|
336
|
+
return { ...result, decision: "replan", reason: "repeated-gaps-require-one-replan" };
|
|
337
|
+
}
|
|
338
|
+
|
|
339
|
+
async function main() {
|
|
340
|
+
const options = parseArgs(process.argv.slice(2));
|
|
341
|
+
if (options.help) {
|
|
342
|
+
console.log("Usage: node scripts/visual-loop.mjs --record RUN.json");
|
|
343
|
+
return;
|
|
344
|
+
}
|
|
345
|
+
const recordFile = path.resolve(process.cwd(), options.record);
|
|
346
|
+
const record = ensureRecord(JSON.parse(await readFile(recordFile, "utf8")));
|
|
347
|
+
const roots = recordRoots(record, recordFile);
|
|
348
|
+
const release = await acquireLock(recordFile);
|
|
349
|
+
try {
|
|
350
|
+
const reconciled = reconcilePending(record);
|
|
351
|
+
const latest = record.rounds.at(-1);
|
|
352
|
+
let result =
|
|
353
|
+
latest === undefined
|
|
354
|
+
? { decision: "continue", reason: "no-round-evidence", gaps: [] }
|
|
355
|
+
: await validateRound(record, latest, roots);
|
|
356
|
+
result = applyGapStall(record, result);
|
|
357
|
+
result = boundedDecision(record, result);
|
|
358
|
+
if (reconciled && result.decision === "continue") {
|
|
359
|
+
result = { ...result, decision: "unavailable", reason: "interrupted-request-reconciled" };
|
|
360
|
+
}
|
|
361
|
+
if (!DECISIONS.has(result.decision)) fail(`invalid decision '${result.decision}'`);
|
|
362
|
+
const decision = { at: new Date().toISOString(), round: latest?.round ?? 0, ...result };
|
|
363
|
+
record.decision = decision;
|
|
364
|
+
record.decisionHistory.push(decision);
|
|
365
|
+
await atomicWriteJson(recordFile, record);
|
|
366
|
+
console.log(JSON.stringify(decision));
|
|
367
|
+
} finally {
|
|
368
|
+
await release();
|
|
369
|
+
}
|
|
370
|
+
}
|
|
371
|
+
|
|
372
|
+
main().catch((error) => {
|
|
373
|
+
console.log(
|
|
374
|
+
JSON.stringify({
|
|
375
|
+
action: "failed",
|
|
376
|
+
decision: "unavailable",
|
|
377
|
+
category: "invalid-input",
|
|
378
|
+
message: error instanceof Error ? error.message : "invalid record",
|
|
379
|
+
}),
|
|
380
|
+
);
|
|
381
|
+
process.exitCode = 2;
|
|
382
|
+
});
|