summer-engine 2.3.0 → 2.6.0

package/.claude-plugin/marketplace.json

@@ -7,8 +7,8 @@
     {
       "name": "summer",
       "source": "./",
-      "version": "2.3.0",
-      "description": "Superpowers for AI game dev. 60 auto-trigger skills under summer: namespace, MCP bridge to the local Summer Engine, session-start + pre-commit hooks.",
+      "version": "2.5.1",
+      "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 44-tool MCP bridge to the local desktop app.",
       "author": { "name": "Summer Engine", "email": "founders@summerengine.com" },
       "category": "game-development",
       "tags": ["game-dev", "godot", "ai-game-engine"],

package/.claude-plugin/plugin.json

@@ -1,15 +1,15 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "summer",
-  "version": "2.3.0",
-  "description": "Superpowers for AI game dev. 60 auto-trigger skills + lifecycle hooks + MCP bridge to the local Summer Engine — the AI-native game engine.",
+  "version": "2.5.1",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 44-tool MCP bridge to the local desktop app.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",
     "url": "https://summerengine.com"
   },
   "homepage": "https://summerengine.com",
-  "repository": "https://github.com/SummerEngine/summer",
+  "repository": "https://github.com/SummerEngine/summer-engine-agent",
   "license": "MIT",
   "keywords": [
     "game-dev",
@@ -26,10 +26,21 @@
     "performance"
   ],
   "skills": [
-    "./skills/_meta/using-summer/",
-    "./skills/_meta/skill-create/",
-    "./skills/_meta/skill-improve/",
-    "./skills/_meta/skill-test/",
+    "./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/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/",
@@ -38,7 +49,9 @@
     "./skills/scene-and-project/make-game/",
     "./skills/debugging/debug/",
     "./skills/gameplay-mechanics/design-mechanic/",
+    "./skills/gameplay-mechanics/auto-fire-targeting/",
     "./skills/level-design/design-level/",
+    "./skills/level-design/scene-to-level/",
     "./skills/rendering-and-lighting/art-direction/",
     "./skills/rendering-and-lighting/3d-lighting/",
     "./skills/audio/audio-direction/",
@@ -60,6 +73,9 @@
     "./skills/2d-assets/tileable-texture/",
     "./skills/2d-assets/sprite-sheet/",
     "./skills/2d-assets/skybox-panorama/",
+    "./skills/2d-assets/create-asset-sheet/",
+    "./skills/2d-assets/instantiate-asset-pack/",
+    "./skills/2d-assets/use-widget-asset/",
     "./skills/3d-assets/prop-model/",
     "./skills/3d-assets/character-model/",
     "./skills/3d-assets/environment-kit/",
@@ -93,7 +109,7 @@
     "enable_pre_commit_doctor": {
       "type": "boolean",
       "title": "Run summer doctor before commits",
-      "description": "Block git commits when the Summer Engine setup has FAIL diagnostics. Off by default.",
+      "description": "Block git commits when the Summer Engine setup needs attention. Off by default.",
       "default": false
     }
   }

package/.codex-plugin/plugin.json

@@ -1,24 +1,35 @@
 {
   "name": "summer",
-  "version": "2.3.0",
-  "description": "Superpowers for AI game dev. 60 auto-trigger skills, MCP bridge to the local Summer Engine, lifecycle hooks. Build games by talking.",
+  "version": "2.5.1",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 44-tool MCP bridge. Build games by talking.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",
     "url": "https://summerengine.com"
   },
   "homepage": "https://summerengine.com",
-  "repository": "https://github.com/SummerEngine/summer",
+  "repository": "https://github.com/SummerEngine/summer-engine-agent",
   "license": "MIT",
   "keywords": [
     "game-dev", "godot", "ai-game-engine", "skills",
     "workflow", "level-design", "vfx", "multiplayer"
   ],
   "skills": [
-    "./skills/_meta/using-summer/",
-    "./skills/_meta/skill-create/",
-    "./skills/_meta/skill-improve/",
-    "./skills/_meta/skill-test/",
+    "./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/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/",
@@ -81,7 +92,7 @@
   "interface": {
     "displayName": "Summer",
     "shortDescription": "Superpowers for AI game dev. Build games by talking.",
-    "longDescription": "Summer turns Codex into a game-dev studio for Summer Engine — the AI-native game engine. 60 auto-trigger skills covering brainstorm, design, build, play, debug, ship — plus a using-summer meta-skill that establishes workflow priority on session start. The MCP bridge talks to the local Summer Engine for scene mutation, asset import, render, play, and diagnostics — 38 focused tools across scene/debug/project/asset/generate, with file/git/shell/grep deferred to the host agent. Summer Engine is compatible with Godot 4.5 — write code in GDScript, drive the engine via MCP. Session-start orients the session. Pre-commit doctor (opt-in) blocks bad commits.",
+    "longDescription": "Summer turns Codex into a game-dev studio for Summer Engine, the AI-native game engine. It adds game-dev skills, a using-summer workflow skill, lifecycle hooks, and a 44-tool MCP bridge for scene editing, asset import, play mode, diagnostics, and generation. File, git, shell, and grep stay with the host agent. Summer Engine is compatible with Godot 4.5. Write code in GDScript and drive the engine through MCP. Session-start orients the session. Pre-commit doctor (opt-in) blocks bad commits.",
     "developerName": "Summer Engine",
     "category": "Coding",
     "capabilities": ["Interactive", "Read", "Write"],

package/.cursor-plugin/plugin.json

@@ -2,12 +2,12 @@
   "$schema": "https://cursor.com/schemas/cursor-plugin/plugin.json",
   "name": "summer",
   "displayName": "Summer",
-  "version": "2.3.0",
-  "description": "Superpowers for AI game dev. 60 auto-trigger skills + lifecycle hooks + MCP bridge to the local Summer Engine — the AI-native game engine.",
+  "version": "2.5.1",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 44-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",
+  "repository": "https://github.com/SummerEngine/summer-engine-agent",
   "license": "MIT",
   "category": "developer-tools",
   "keywords": [
@@ -17,10 +17,21 @@
   ],
   "tags": ["game-dev", "ai", "godot", "creative", "design"],
   "skills": [
-    "./skills/_meta/using-summer/",
-    "./skills/_meta/skill-create/",
-    "./skills/_meta/skill-improve/",
-    "./skills/_meta/skill-test/",
+    "./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/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/",

package/.factory-plugin/plugin.json

@@ -1,14 +1,14 @@
 {
   "name": "summer",
-  "description": "Superpowers for AI game dev. 24 auto-trigger skills + lifecycle hooks + MCP bridge to the local Summer Engine — the AI-native game engine.",
-  "version": "2.0.1",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 44-tool MCP bridge to the local desktop app.",
+  "version": "2.5.1",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",
     "url": "https://summerengine.com"
   },
   "homepage": "https://summerengine.com",
-  "repository": "https://github.com/SummerEngine/summer",
+  "repository": "https://github.com/SummerEngine/summer-engine-agent",
   "license": "MIT",
   "keywords": [
     "game-dev",

package/.opencode/INSTALL.md

@@ -63,7 +63,7 @@ The model should auto-invoke the `summer:fps-controller` skill before writing an
 |---|---|
 | No orientation banner appears | Verify `plugin` array in `opencode.json` and that `summer-engine` is installed in `node_modules/`. |
 | MCP tools return "not connected" | Run `summer run` to launch the engine. The MCP server lazy-connects on the first tool call. |
-| `summer` command not found | `npm install -g summer-engine` for the global CLI. |
+| `summer` command not found | Use `npx -y summer-engine@latest <command>` or install the CLI globally only if you want a persistent `summer` command. |
 | Skills don't auto-trigger | The using-summer skill loads on first user message; if that message is empty (e.g. a startup probe), they'll trigger on the second. |
 
 ## Uninstall

package/AGENTS.md

@@ -22,13 +22,15 @@ This file is for any AI agent that loads context from `AGENTS.md` (Codex CLI, Fa
 
 ## MCP tool palette (engine on `localhost:6550`)
 
-37 tools total. Categories:
+44 tools total. Categories:
 
-- Scene: `summer_add_node`, `summer_set_prop`, `summer_set_resource_property`, `summer_remove_node`, `summer_save_scene`, `summer_open_scene`, `summer_replace_node`, `summer_inspect_node`, `summer_inspect_resource`, `summer_get_scene_tree`, `summer_batch`, `summer_select_node`, `summer_instantiate_scene`, `summer_connect_signal`.
-- Diagnostics: `summer_get_script_errors`, `summer_get_diagnostics`, `summer_get_console`, `summer_clear_console`, `summer_get_debugger_errors`.
+- Scene: `summer_get_scene_tree`, `summer_open_scene`, `summer_create_scene`, `summer_add_node`, `summer_set_prop`, `summer_set_resource_property`, `summer_remove_node`, `summer_save_scene`, `summer_instantiate_scene`, `summer_replace_node`, `summer_select_node`, `summer_inspect_node`, `summer_inspect_resource`, `summer_connect_signal`, `summer_batch`.
+- Diagnostics: `summer_get_script_errors`, `summer_get_diagnostics`, `summer_get_console`, `summer_clear_console`, `summer_get_debugger_errors`, `summer_get_debugger_warnings`.
 - Runtime: `summer_play`, `summer_stop`, `summer_is_running`.
 - Project: `summer_get_project_context`, `summer_open_main_scene`, `summer_project_setting`, `summer_input_map_bind`, `summer_get_agent_playbook`.
-- Assets: `summer_search_assets`, `summer_import_asset`, `summer_import_from_url`, `summer_import_from_url_batch`, `summer_generate_image`, `summer_generate_3d`, `summer_generate_audio`, `summer_generate_video`, `summer_check_job`.
+- Assets: `summer_search_assets`, `summer_list_my_assets`, `summer_get_asset`, `summer_get_asset_download_url`, `summer_import_asset`, `summer_import_asset_by_id`, `summer_import_from_url`, `summer_import_from_url_batch`.
+- Generation: `summer_generate_image`, `summer_generate_3d`, `summer_generate_audio`, `summer_generate_video`, `summer_generate_motion`, `summer_check_job`.
+- Meta: `summer_start_game_task`.
 
 File ops, git, shell, and grep are NOT exposed — use the host's native tools.
 

package/CHANGELOG.md

@@ -2,13 +2,52 @@
 
 All notable changes to summer-engine will be documented here. Following [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and [Semantic Versioning](https://semver.org/).
 
+## [2.6.0] — 2026-06-10 — "Summer Cloud"
+
+### Added
+- `summer cloud` command group: `init`, `status`, `push`, `pull`, `restore`, `checkpoints` — content-addressed project sync against Summer Cloud (R2-backed). Code stays in git; big assets sync by hash with three-way merge, conflict sets, and SummerGit checkpoints before any destructive apply.
+- Matching MCP tools: `summer_cloud_init`, `summer_cloud_status`, `summer_cloud_push`, `summer_cloud_pull`, `summer_cloud_restore`, `summer_cloud_checkpoints`, `summer_cloud_conflicts`.
+- `.summercloudignore` support plus built-in hard excludes (`.env*`, `.summer/local/`, `node_modules/`, OS junk) so secrets and machine-local state never upload.
+
+### Safety
+- Pulls stage to a temp dir and verify every blob hash before an atomic rename; mass-delete guardrails, edit-beats-delete conflict rule, and case-only rename handling for macOS/Windows volumes.
+
+## [2.5.1] — 2026-05-27 — "README Polish"
+
+### Changed
+- Removed the pseudo-JSON status example from the npm README because npm syntax highlighting made normal setup statuses look like alarming errors.
+
+### Fixed
+- MCP generation requests now include client/tool attribution headers and surface provider 422 validation details instead of opaque `[Object]` failures.
+
+## [2.5.0] — 2026-05-27 — "Project Memory"
+
+Note: `2.1.0` through `2.4.0` were internal package/plugin snapshots in the engine repo. npm `latest` was still `2.3.0` before this release, so `2.5.0` is the public catch-up release for the memory, setup, and MCP reliability work.
+
+### Added
+- `summer memory` — read-only CLI view of `.summer` project memory, with `--json`, `show <file>`, and `path` subcommands.
+- `projectMemory` in `summer_get_project_context` — lightweight summary of `.summer` canonical files and structured memory for agents.
+- `.summer/memory/` convention for locked project facts such as voice IDs, world canon, provider bindings, and cross-session decisions.
+- Project-memory checks in `summer status` and `summer doctor`.
+- First-class `summer setup github-copilot` and `summer setup vscode-copilot` targets for Copilot CLI and GitHub Copilot in VS Code.
+- Copy-paste setup prompt docs: users can paste "Install Summer Engine and let's make a game." into their AI environment instead of starting with npm commands.
+
+### Changed
+- `/summer:voice-line` now writes locked cast assignments to `.summer/memory/casting/voices.md`, while still reading legacy `.summer/voice-cast.md`.
+- Agent playbook and `using-summer` now require agents to read relevant project memory before creative/audio/dialogue/level/character work.
+- CLI and docs now link directly to the public source repo: `https://github.com/SummerEngine/summer-engine-agent`.
+
+### Fixed
+- MCP project context now falls back to engine health fields for project path, project name, and current scene.
+- Mutating MCP tools now surface failure terminal states and no-results failure envelopes instead of masking them as success.
+
 ## [2.0.0] — 2026-05-09 — "Superpowers"
 
 The plugin rebrand. Summer is now positioned as superpowers for AI game dev — installable in Claude Code, Codex (CLI + App), Cursor, Factory Droid, Gemini CLI, OpenCode, GitHub Copilot CLI, and Windsurf with one canonical command per harness.
 
 ### Added
 - **`summer:using-summer`** meta-skill — establishes workflow priority, red-flag list, and skill-invocation discipline. Auto-loads on session start. Modeled on `superpowers:using-superpowers`.
-- **`summer:debug`** skill — the missing flagship skill. Disciplined script-errors → console → debugger → hypothesize → propose → fix → verify loop. Honors all 4 cases in `_tests/specs/debug.md`.
+- **`summer:debug`** skill — the missing flagship skill. Disciplined script-errors → console → debugger → hypothesize → propose → fix → verify loop. Honors all 4 cases in `tests/specs/debug.md`.
 - **Manifest validator** (`src/lib/plugin-manifests.test.ts`) — vitest test that walks every plugin manifest and verifies each referenced skill resolves to a real `SKILL.md` on disk. Also enforces the "Use when…" auto-trigger pattern in every skill's description.
 - **`AGENTS.md`** + **`GEMINI.md`** at repo root — context primer for harnesses that read AGENTS-style files (Codex, Factory) and the Gemini extension.
 - **`.opencode/INSTALL.md`** — explicit OpenCode setup guide.
@@ -18,7 +57,7 @@ The plugin rebrand. Summer is now positioned as superpowers for AI game dev —
 ### Changed
 - **Brand:** "Summer" replaces "Summer Engine CLI" across all plugin descriptions, READMEs, and orientation banners. The npm package stays `summer-engine` (continuity).
 - **README** rewritten in superpowers-homepage style — install matrix per harness, philosophy section, basic workflow walkthrough.
-- **MCP_STRATEGY.md** updated: documents the deliberate decision to NOT ship file/git/shell/grep tools (host agents have those natively). 37 tools shipped.
+- **MCP_STRATEGY.md** updated: documents the deliberate decision to NOT ship file/git/shell/grep tools (host agents have those natively). The then-current tool surface shipped.
 - All 22 user-facing skill descriptions audited and rewritten to lead with "Use when X" for tighter auto-trigger.
 - `.codex-plugin/plugin.json` `longDescription` rewritten — accurate skill count, mentions the host-native tool exclusion.
 - `.opencode/plugins/summer.js` orientation banner updated to 22 skills with explicit process / discipline / build priority.
@@ -36,10 +75,10 @@ The plugin rebrand. Summer is now positioned as superpowers for AI game dev —
 
 ### Fixed
 - `summer_input_map_bind` syntax aligned across `fps-controller` SKILL.md and its behavioral test spec.
-- `_meta/skill-test` static linter relaxed to allow forward-reference `See also` links to other SKILL.md files (warn instead of fail).
+- `workflow/skill-test` static linter relaxed to allow forward-reference `See also` links to other SKILL.md files (warn instead of fail).
 
 ### Added
-- `_shared/summer-folder.md` — canonical `.summer/` folder convention (documents files written by `/summer:brainstorm-game`, `/summer:art-direction`, etc.).
+- `references/summer-folder.md` — canonical `.summer/` folder convention (documents files written by `/summer:brainstorm-game`, `/summer:art-direction`, etc.).
 - `CHANGELOG.md` — retroactive v1.0.0 → v1.3.1 history.
 
 ## [1.3.1] — 2026-05-05
@@ -64,9 +103,9 @@ The plugin rebrand. Summer is now positioned as superpowers for AI game dev —
 
 ### Added
 - 20-category skill library scaffold with descriptive folder names (`character-controllers`, `gameplay-mechanics`, `scripting-patterns`, etc.).
-- `_shared/` directory with 5 canonical references (godot-version, mcp-tools-reference, collaborative-protocol, template-registry, gd-style).
-- `_meta/` directory with 3 meta-skills (skill-test linter, skill-create bootstrap, skill-improve eval harness).
-- `_tests/specs/` directory with per-skill behavioral test specs (fps-controller as canonical format).
+- `references/` directory with 5 canonical references (godot-version, mcp-tools-reference, collaborative-protocol, template-registry, gd-style).
+- `workflow/` directory with 3 meta-skills (skill-test linter, skill-create bootstrap, skill-improve eval harness).
+- `tests/specs/` directory with per-skill behavioral test specs (fps-controller as canonical format).
 - `catalog.yaml` — 85-skill roadmap with HAVE / NEXT / LATER status.
 
 ### Changed

package/CLAUDE.md

@@ -1,5 +1,5 @@
 # Summer — Claude context
 
-This file primes Claude Code on Summer when it loads from this repo. The full agent workflow lives in `skills/_meta/using-summer/SKILL.md`; activate that skill on every fresh session.
+This file primes Claude Code on Summer when it loads from this repo. The full agent workflow lives in `skills/workflow/using-summer/SKILL.md`; activate that skill on every fresh session.
 
-@./skills/_meta/using-summer/SKILL.md
+@./skills/workflow/using-summer/SKILL.md

package/GEMINI.md

@@ -1,6 +1,6 @@
 # Summer — Context Primer for Gemini
 
-Summer is the AI game-dev studio for **Summer Engine** — the AI-native game engine. When you see this file in a session, it means the user has installed the Summer Gemini extension and you have access to the `summer-engine` MCP server plus 24 skills under the `summer:` namespace.
+Summer is the AI game-dev studio for **Summer Engine** — the AI-native game engine. When you see this file in a session, it means the user has installed the Summer Gemini extension and you have access to the `summer-engine` MCP server plus Summer skills under the `summer:` namespace.
 
 ## What Summer Engine is
 
@@ -20,11 +20,11 @@ The single most important skill to know is `summer:using-summer` — it explains
 
 ## MCP tools (when the engine is running on `localhost:6550`)
 
-The `summer-engine` MCP server exposes 37 focused tools. The most important:
+The `summer-engine` MCP server exposes 44 focused tools. The most important:
 
 - **Scene mutation**: `summer_add_node`, `summer_set_prop`, `summer_set_resource_property`, `summer_remove_node`, `summer_save_scene`, `summer_replace_node`, `summer_batch`.
 - **Scene inspection**: `summer_get_scene_tree`, `summer_inspect_node`, `summer_inspect_resource`.
-- **Diagnostics**: `summer_get_script_errors` (cheapest), `summer_get_diagnostics`, `summer_get_console`, `summer_get_debugger_errors`.
+- **Diagnostics**: `summer_get_script_errors` (cheapest), `summer_get_diagnostics`, `summer_get_console`, `summer_get_debugger_errors`, `summer_get_debugger_warnings`.
 - **Run game**: `summer_play`, `summer_stop`, `summer_is_running`.
 - **Project**: `summer_get_project_context`, `summer_open_main_scene`, `summer_project_setting`, `summer_input_map_bind`.
 - **Assets**: `summer_search_assets`, `summer_import_asset`, `summer_import_from_url`, `summer_generate_image`, `summer_generate_3d`, `summer_generate_audio`, `summer_generate_video`, `summer_check_job`.
@@ -51,6 +51,5 @@ Tools return "Summer Engine is not running." Tell the user to run `summer run` (
 
 If skills aren't loading or the MCP server fails:
 
-- `npm install -g summer-engine` — global CLI.
-- `summer setup gemini --yes` — writes the right MCP config.
-- `summer doctor` — reports auth, engine, port, skill state.
+- `npx -y summer-engine@latest setup gemini --yes --force` — writes the right MCP config.
+- `npx -y summer-engine@latest doctor` — reports auth, engine, port, project memory, and skill state.