summer-engine 2.8.2 → 3.1.0

package/.cursor-plugin/plugin.json

@@ -1,97 +1,133 @@
 {
   "$schema": "https://cursor.com/schemas/cursor-plugin/plugin.json",
+  "_generated": "GENERATED from integrations/cursor — do not edit; npm run generate:registry",
   "name": "summer",
   "displayName": "Summer",
-  "version": "2.5.1",
-  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 58-tool MCP bridge to the local desktop app.",
-  "author": { "name": "Summer Engine", "email": "founders@summerengine.com" },
+  "version": "3.1.0",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 86-tool MCP bridge to the local desktop app.",
+  "author": {
+    "name": "Summer Engine",
+    "email": "founders@summerengine.com"
+  },
   "publisher": "summer-engine",
   "homepage": "https://summerengine.com",
-  "repository": "https://github.com/SummerEngine/summer-engine-agent",
+  "repository": "https://github.com/summerengine/summer",
   "license": "MIT",
   "category": "developer-tools",
   "keywords": [
-    "game-dev", "godot", "ai-game-engine", "skills",
-    "workflow", "level-design", "art-direction", "vfx",
-    "multiplayer", "performance"
+    "game-dev",
+    "godot",
+    "ai-game-engine",
+    "skills",
+    "workflow",
+    "level-design",
+    "art-direction",
+    "vfx",
+    "multiplayer",
+    "performance"
+  ],
+  "tags": [
+    "game-dev",
+    "ai",
+    "godot",
+    "creative",
+    "design"
   ],
-  "tags": ["game-dev", "ai", "godot", "creative", "design"],
   "skills": [
-    "./skills/workflow/using-summer/",
-    "./skills/workflow/skill-create/",
-    "./skills/workflow/skill-improve/",
-    "./skills/workflow/skill-test/",
-    "./skills/workflow/gameskill/",
-    "./skills/workflow/mcpupdate/",
-    "./skills/workflow/brainstorming/",
-    "./skills/workflow/investigating-bugs/",
-    "./skills/workflow/verification-before-completion/",
-    "./skills/workflow/writing-plans/",
-    "./skills/workflow/dispatching-parallel-agents/",
-    "./skills/workflow/writing-skills/",
-    "./skills/workflow/playtesting-a-feature/",
-    "./skills/workflow/headless-scripting/",
-    "./skills/workflow/debugging-game-feel/",
-    "./skills/workflow/diagnosing-perf-regressions/",
-    "./skills/scene-and-project/brainstorm-game/",
-    "./skills/scene-and-project/new-project/",
-    "./skills/scene-and-project/browse-templates/",
-    "./skills/scene-and-project/play/",
-    "./skills/scene-and-project/scene-composition/",
-    "./skills/scene-and-project/summer-cloud/",
-    "./skills/scene-and-project/make-game/",
-    "./skills/debugging/debug/",
-    "./skills/gameplay-mechanics/design-mechanic/",
-    "./skills/level-design/design-level/",
-    "./skills/rendering-and-lighting/art-direction/",
-    "./skills/rendering-and-lighting/3d-lighting/",
-    "./skills/audio/audio-direction/",
-    "./skills/visual-effects/game-feel/",
-    "./skills/performance/tune-performance/",
-    "./skills/ai-and-npcs/design-npc/",
-    "./skills/multiplayer-and-networking/setup-multiplayer/",
-    "./skills/multiplayer-and-networking/host-authoritative-state/",
-    "./skills/multiplayer-and-networking/peer-to-peer-multiplayer/",
-    "./skills/deployment/export-and-ship/",
-    "./skills/deployment/remote-deploy/",
-    "./skills/character-controllers/fps-controller/",
-    "./skills/scripting-patterns/gdscript-patterns/",
-    "./skills/ui-and-ux/ui-basics/",
-    "./skills/asset-pipeline/asset-strategy/",
-    "./skills/2d-assets/concept-art/",
-    "./skills/2d-assets/character-portrait/",
-    "./skills/2d-assets/pixel-art/",
-    "./skills/2d-assets/ui-graphics/",
-    "./skills/2d-assets/tileable-texture/",
-    "./skills/2d-assets/sprite-sheet/",
-    "./skills/2d-assets/create-asset-sheet/",
-    "./skills/2d-assets/skybox-panorama/",
-    "./skills/3d-assets/prop-model/",
-    "./skills/3d-assets/character-model/",
-    "./skills/3d-assets/environment-kit/",
-    "./skills/3d-assets/vehicle-model/",
-    "./skills/3d-assets/organic-model/",
-    "./skills/animation/generate-motion/",
-    "./skills/animation/retarget/",
-    "./skills/animation/animation-tree/",
-    "./skills/animation/procedural-animation/",
-    "./skills/animation/facial-and-lipsync/",
-    "./skills/audio/sound-effect/",
-    "./skills/audio/music-track/",
-    "./skills/audio/ambient-bed/",
-    "./skills/audio/voice-line/",
-    "./skills/audio/adaptive-music/",
-    "./skills/video/cinematic-cutscene/",
-    "./skills/video/trailer-shot/",
-    "./skills/video/animated-loop/",
-    "./skills/visual-effects/recipes/fire/",
-    "./skills/visual-effects/recipes/muzzle-flash/",
-    "./skills/visual-effects/recipes/water-ripple/",
-    "./skills/visual-effects/recipes/lightning/",
-    "./skills/visual-effects/recipes/dissolve/",
-    "./skills/visual-effects/recipes/smoke/",
-    "./skills/visual-effects/recipes/hit-spark/",
-    "./skills/visual-effects/recipes/magic-glow/"
+    "./library/skills/3d-lighting/",
+    "./library/skills/adaptive-music/",
+    "./library/skills/agent-playtesting/",
+    "./library/skills/ambient-bed/",
+    "./library/skills/animated-loop/",
+    "./library/skills/animation-tree/",
+    "./library/skills/art-direction/",
+    "./library/skills/asset-strategy/",
+    "./library/skills/audio-direction/",
+    "./library/skills/auto-fire-targeting/",
+    "./library/skills/brainstorm-game/",
+    "./library/skills/brainstorming/",
+    "./library/skills/browse-templates/",
+    "./library/skills/celeste-momentum-platforming/",
+    "./library/skills/character-animation-wiring/",
+    "./library/skills/character-model/",
+    "./library/skills/character-portrait/",
+    "./library/skills/cinematic-cutscene/",
+    "./library/skills/concept-art/",
+    "./library/skills/create-asset-sheet/",
+    "./library/skills/debug/",
+    "./library/skills/debugging-game-feel/",
+    "./library/skills/design-level/",
+    "./library/skills/design-mechanic/",
+    "./library/skills/design-npc/",
+    "./library/skills/diagnosing-perf-regressions/",
+    "./library/skills/dispatching-parallel-agents/",
+    "./library/skills/driving-the-editor-ui/",
+    "./library/skills/environment-kit/",
+    "./library/skills/export-and-ship/",
+    "./library/skills/fabricating-assets/",
+    "./library/skills/facial-and-lipsync/",
+    "./library/skills/fps-controller/",
+    "./library/skills/game-feel/",
+    "./library/skills/gameskill/",
+    "./library/skills/gdscript-patterns/",
+    "./library/skills/generate-motion/",
+    "./library/skills/godogen-visual-proof-game-generation/",
+    "./library/skills/headless-scripting/",
+    "./library/skills/host-authoritative-state/",
+    "./library/skills/instantiate-asset-pack/",
+    "./library/skills/investigating-bugs/",
+    "./library/skills/lumera-single-image-scene-reconstruction/",
+    "./library/skills/make-game/",
+    "./library/skills/music-track/",
+    "./library/skills/navigate-summer/",
+    "./library/skills/new-project/",
+    "./library/skills/organic-model/",
+    "./library/skills/peer-to-peer-multiplayer/",
+    "./library/skills/pixel-art/",
+    "./library/skills/play/",
+    "./library/skills/playtesting-a-feature/",
+    "./library/skills/procedural-animation/",
+    "./library/skills/prop-model/",
+    "./library/skills/psx-retro-rendering/",
+    "./library/skills/realtime-wet-surfaces/",
+    "./library/skills/remote-deploy/",
+    "./library/skills/retarget/",
+    "./library/skills/running-in-the-cloud/",
+    "./library/skills/scene-composition/",
+    "./library/skills/scene-hierarchy-design/",
+    "./library/skills/scene-scripting/",
+    "./library/skills/scene-to-level/",
+    "./library/skills/setup-multiplayer/",
+    "./library/skills/skill-create/",
+    "./library/skills/skill-improve/",
+    "./library/skills/skill-test/",
+    "./library/skills/skintokens-auto-rigging/",
+    "./library/skills/skybox-panorama/",
+    "./library/skills/sound-effect/",
+    "./library/skills/spatial-placement/",
+    "./library/skills/sprite-sheet/",
+    "./library/skills/tileable-texture/",
+    "./library/skills/trailer-shot/",
+    "./library/skills/tune-performance/",
+    "./library/skills/ui-basics/",
+    "./library/skills/ui-graphics/",
+    "./library/skills/use-widget-asset/",
+    "./library/skills/using-summer/",
+    "./library/skills/vehicle-model/",
+    "./library/skills/verification-before-completion/",
+    "./library/skills/verifying-scenes/",
+    "./library/skills/vfx-dissolve/",
+    "./library/skills/vfx-fire/",
+    "./library/skills/vfx-hit-spark/",
+    "./library/skills/vfx-lightning/",
+    "./library/skills/vfx-magic-glow/",
+    "./library/skills/vfx-muzzle-flash/",
+    "./library/skills/vfx-smoke/",
+    "./library/skills/vfx-water-ripple/",
+    "./library/skills/voice-line/",
+    "./library/skills/world-building-3d/",
+    "./library/skills/writing-plans/",
+    "./library/skills/writing-skills/"
   ],
   "hooks": "./hooks/hooks-cursor.json",
   "mcpServers": "./.mcp.json"

package/.factory-plugin/plugin.json

@@ -1,14 +1,15 @@
 {
+  "_generated": "GENERATED from integrations/factory — do not edit; npm run generate:registry",
   "name": "summer",
-  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 52-tool MCP bridge to the local desktop app.",
-  "version": "2.5.1",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 86-tool MCP bridge to the local desktop app.",
+  "version": "3.1.0",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",
     "url": "https://summerengine.com"
   },
   "homepage": "https://summerengine.com",
-  "repository": "https://github.com/SummerEngine/summer-engine-agent",
+  "repository": "https://github.com/summerengine/summer",
   "license": "MIT",
   "keywords": [
     "game-dev",
@@ -16,5 +17,101 @@
     "ai-game-engine",
     "skills",
     "mcp"
+  ],
+  "skills": [
+    "./library/skills/3d-lighting/",
+    "./library/skills/adaptive-music/",
+    "./library/skills/agent-playtesting/",
+    "./library/skills/ambient-bed/",
+    "./library/skills/animated-loop/",
+    "./library/skills/animation-tree/",
+    "./library/skills/art-direction/",
+    "./library/skills/asset-strategy/",
+    "./library/skills/audio-direction/",
+    "./library/skills/auto-fire-targeting/",
+    "./library/skills/brainstorm-game/",
+    "./library/skills/brainstorming/",
+    "./library/skills/browse-templates/",
+    "./library/skills/celeste-momentum-platforming/",
+    "./library/skills/character-animation-wiring/",
+    "./library/skills/character-model/",
+    "./library/skills/character-portrait/",
+    "./library/skills/cinematic-cutscene/",
+    "./library/skills/concept-art/",
+    "./library/skills/create-asset-sheet/",
+    "./library/skills/debug/",
+    "./library/skills/debugging-game-feel/",
+    "./library/skills/design-level/",
+    "./library/skills/design-mechanic/",
+    "./library/skills/design-npc/",
+    "./library/skills/diagnosing-perf-regressions/",
+    "./library/skills/dispatching-parallel-agents/",
+    "./library/skills/driving-the-editor-ui/",
+    "./library/skills/environment-kit/",
+    "./library/skills/export-and-ship/",
+    "./library/skills/fabricating-assets/",
+    "./library/skills/facial-and-lipsync/",
+    "./library/skills/fps-controller/",
+    "./library/skills/game-feel/",
+    "./library/skills/gameskill/",
+    "./library/skills/gdscript-patterns/",
+    "./library/skills/generate-motion/",
+    "./library/skills/godogen-visual-proof-game-generation/",
+    "./library/skills/headless-scripting/",
+    "./library/skills/host-authoritative-state/",
+    "./library/skills/instantiate-asset-pack/",
+    "./library/skills/investigating-bugs/",
+    "./library/skills/lumera-single-image-scene-reconstruction/",
+    "./library/skills/make-game/",
+    "./library/skills/music-track/",
+    "./library/skills/navigate-summer/",
+    "./library/skills/new-project/",
+    "./library/skills/organic-model/",
+    "./library/skills/peer-to-peer-multiplayer/",
+    "./library/skills/pixel-art/",
+    "./library/skills/play/",
+    "./library/skills/playtesting-a-feature/",
+    "./library/skills/procedural-animation/",
+    "./library/skills/prop-model/",
+    "./library/skills/psx-retro-rendering/",
+    "./library/skills/realtime-wet-surfaces/",
+    "./library/skills/remote-deploy/",
+    "./library/skills/retarget/",
+    "./library/skills/running-in-the-cloud/",
+    "./library/skills/scene-composition/",
+    "./library/skills/scene-hierarchy-design/",
+    "./library/skills/scene-scripting/",
+    "./library/skills/scene-to-level/",
+    "./library/skills/setup-multiplayer/",
+    "./library/skills/skill-create/",
+    "./library/skills/skill-improve/",
+    "./library/skills/skill-test/",
+    "./library/skills/skintokens-auto-rigging/",
+    "./library/skills/skybox-panorama/",
+    "./library/skills/sound-effect/",
+    "./library/skills/spatial-placement/",
+    "./library/skills/sprite-sheet/",
+    "./library/skills/tileable-texture/",
+    "./library/skills/trailer-shot/",
+    "./library/skills/tune-performance/",
+    "./library/skills/ui-basics/",
+    "./library/skills/ui-graphics/",
+    "./library/skills/use-widget-asset/",
+    "./library/skills/using-summer/",
+    "./library/skills/vehicle-model/",
+    "./library/skills/verification-before-completion/",
+    "./library/skills/verifying-scenes/",
+    "./library/skills/vfx-dissolve/",
+    "./library/skills/vfx-fire/",
+    "./library/skills/vfx-hit-spark/",
+    "./library/skills/vfx-lightning/",
+    "./library/skills/vfx-magic-glow/",
+    "./library/skills/vfx-muzzle-flash/",
+    "./library/skills/vfx-smoke/",
+    "./library/skills/vfx-water-ripple/",
+    "./library/skills/voice-line/",
+    "./library/skills/world-building-3d/",
+    "./library/skills/writing-plans/",
+    "./library/skills/writing-skills/"
   ]
 }

package/.mcp.json

@@ -1,8 +1,13 @@
 {
+  "_generated": "GENERATED from integrations/claude — do not edit; npm run generate:registry",
   "mcpServers": {
     "summer-engine": {
       "command": "npx",
-      "args": ["summer-engine", "mcp"]
+      "args": [
+        "-y",
+        "summer-engine@latest",
+        "mcp"
+      ]
     }
   }
 }

package/.opencode/INSTALL.md

@@ -26,7 +26,7 @@ OpenCode resolves `summer-engine` via the package's `main` field, which points t
 }
 ```
 
-Restart OpenCode. The orientation banner ("Summer Engine is loaded. N skills available…") will appear at the top of every new session, and skills will auto-discover from `node_modules/summer-engine/skills/`.
+Restart OpenCode. The orientation primer ("Summer Engine is loaded. …") is prepended to the first user message of every new session, and the plugin registers `node_modules/summer-engine/library/skills/` in `skills.paths` so every `summer:<slug>` skill is discoverable.
 
 ## What this gives you
 
@@ -40,22 +40,25 @@ Add this block to your `opencode.json` so OpenCode launches the MCP server on de
 
 ```json
 {
+  "$schema": "https://opencode.ai/config.json",
   "mcp": {
     "summer-engine": {
-      "command": "npx",
-      "args": ["summer-engine", "mcp"]
+      "type": "local",
+      "command": ["npx", "-y", "summer-engine@latest", "mcp"]
     }
   }
 }
 ```
 
+This is exactly what `npx -y summer-engine@latest setup opencode --yes` writes (to `~/.config/opencode/opencode.json`, or `./opencode.json` with `--scope project`). OpenCode's local MCP entries take `type: "local"` and an array `command`; the older `{ "command": "npx", "args": [...] }` shape is not accepted.
+
 ## Verify
 
 In a fresh OpenCode session, ask:
 
 > Let's make an FPS in Summer Engine.
 
-The model should auto-invoke the `summer:fps-controller` skill before writing any code. If it doesn't, the plugin isn't loaded — check `opencode.json` and your `node_modules/summer-engine/` install.
+The model should load the `summer:fps-controller` skill (via its `skill` tool) before writing any code. If it doesn't, the plugin isn't loaded — check `opencode.json` and your `node_modules/summer-engine/` install.
 
 ## Troubleshooting
 

package/.opencode/plugins/summer.js

@@ -1,52 +1,65 @@
 /**
  * Summer Engine plugin for OpenCode.ai
  *
- * Registers the skills directory and injects a one-line session-start
- * orientation into the first user message of each session.
+ * Registers the bundled skill library directory and injects a one-line
+ * session-start orientation into the first user message of each session.
+ *
+ * Plugin shape follows @opencode-ai/plugin: an exported async function
+ * `({ client, directory, ... }) => Hooks`. Every export of this module is
+ * invoked by OpenCode, so this file has exactly one export (the plugin
+ * function); constants hang off it for tests.
  */
 
 import path from 'path';
 import { fileURLToPath } from 'url';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const skillsDir = path.resolve(__dirname, '../../skills');
+
+/**
+ * The skill library ships at <package>/library/skills/<slug>/SKILL.md, which is
+ * the `<dir>/<name>/SKILL.md` layout OpenCode's `skills.paths` expects.
+ */
+const SKILLS_DIR = path.resolve(__dirname, '../../library/skills');
+
+/** Sentinel line: the transform checks for it so the primer is injected once. */
+const ORIENTATION_MARKER = 'Summer Engine is loaded.';
 
 const ORIENTATION = `<EXTREMELY_IMPORTANT>
-Summer is loaded. Summer skills are available under the summer: namespace.
+${ORIENTATION_MARKER} Summer skills are available under the summer: namespace.
 
 Activate summer:using-summer FIRST in any Summer Engine session — it sets workflow priority and the red-flag list.
 
 Process skills (run before building): brainstorm-game, debug, play.
 Discipline skills (shape what you build): gdscript-patterns, scene-composition, art-direction, audio-direction, asset-strategy.
-Build skills (produce artifacts): fps-controller, design-mechanic, design-level, setup-multiplayer, host-authoritative-state, peer-to-peer-multiplayer, design-npc, 3d-lighting, ui-basics, vfx, tune-performance, export-and-ship, make-game.
+Build skills (produce artifacts): fps-controller, design-mechanic, design-level, setup-multiplayer, host-authoritative-state, peer-to-peer-multiplayer, design-npc, 3d-lighting, ui-basics, game-feel, vfx-fire, vfx-smoke, vfx-lightning, vfx-hit-spark, tune-performance, export-and-ship, make-game.
 
-Always check for a relevant skill before responding. The summer-engine MCP server (npx summer-engine mcp) provides identity-bound project file mutations plus scene, asset, render, play, and diagnostics tools. Git, shell, and grep remain native; do not bypass Summer's file guards when MCP is available.
+Always check for a relevant skill before responding. The summer-engine MCP server (npx -y summer-engine@latest mcp) provides identity-bound project file mutations plus scene, asset, render, play, and diagnostics tools. Git, shell, and grep remain native; do not bypass Summer's file guards when MCP is available.
 </EXTREMELY_IMPORTANT>`;
 
-export const SummerPlugin = async ({ client, directory }) => {
+export const SummerPlugin = async (_input) => {
   return {
-    name: "summer",
+    name: 'summer',
 
     config: async (config) => {
       config.skills = config.skills || {};
       config.skills.paths = config.skills.paths || [];
-      if (!config.skills.paths.includes(skillsDir)) {
-        config.skills.paths.push(skillsDir);
+      if (!config.skills.paths.includes(SKILLS_DIR)) {
+        config.skills.paths.push(SKILLS_DIR);
       }
     },
 
     'experimental.chat.messages.transform': async (_input, output) => {
-      if (!output.messages?.length) return;
-      const firstUser = output.messages.find((m) => m.info.role === 'user');
+      if (!output?.messages?.length) return;
+      const firstUser = output.messages.find((m) => m.info?.role === 'user');
       if (!firstUser?.parts?.length) return;
-      if (firstUser.parts.some((p) => p.type === 'text' && p.text.includes('Summer Engine is loaded'))) return;
+      if (firstUser.parts.some((p) => p.type === 'text' && typeof p.text === 'string' && p.text.includes(ORIENTATION_MARKER))) return;
       const ref = firstUser.parts[0];
       firstUser.parts.unshift({ ...ref, type: 'text', text: ORIENTATION });
     },
-
-    'session.created': async () => {
-      // No-op placeholder; full session-start work runs in CLI hook on Claude Code.
-      // OpenCode users get the orientation via the message transform above.
-    }
   };
 };
+
+// Exposed for tests without adding module exports OpenCode would try to invoke.
+SummerPlugin.SKILLS_DIR = SKILLS_DIR;
+SummerPlugin.ORIENTATION = ORIENTATION;
+SummerPlugin.ORIENTATION_MARKER = ORIENTATION_MARKER;