summer-engine 2.5.0 → 2.6.1

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.
Files changed (83) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/.claude-plugin/plugin.json +5 -4
  3. package/.codex-plugin/plugin.json +5 -4
  4. package/.cursor-plugin/plugin.json +4 -3
  5. package/.factory-plugin/plugin.json +3 -3
  6. package/AGENTS.md +6 -4
  7. package/CHANGELOG.md +20 -2
  8. package/GEMINI.md +3 -3
  9. package/README.md +113 -100
  10. package/dist/bin/summer.js +6 -1
  11. package/dist/commands/cloud.d.ts +2 -0
  12. package/dist/commands/cloud.js +80 -0
  13. package/dist/commands/doctor.js +19 -0
  14. package/dist/commands/login.js +4 -1
  15. package/dist/commands/logout.js +1 -1
  16. package/dist/commands/open.js +1 -1
  17. package/dist/commands/plan.d.ts +2 -0
  18. package/dist/commands/plan.js +60 -0
  19. package/dist/commands/run.js +132 -35
  20. package/dist/lib/api-client.js +4 -1
  21. package/dist/lib/auth.d.ts +2 -0
  22. package/dist/lib/auth.js +13 -0
  23. package/dist/lib/cloud/api.d.ts +79 -0
  24. package/dist/lib/cloud/api.js +107 -0
  25. package/dist/lib/cloud/apply.d.ts +32 -0
  26. package/dist/lib/cloud/apply.js +294 -0
  27. package/dist/lib/cloud/checkpoint.d.ts +26 -0
  28. package/dist/lib/cloud/checkpoint.js +142 -0
  29. package/dist/lib/cloud/conflicts.d.ts +55 -0
  30. package/dist/lib/cloud/conflicts.js +131 -0
  31. package/dist/lib/cloud/containment.d.ts +8 -0
  32. package/dist/lib/cloud/containment.js +52 -0
  33. package/dist/lib/cloud/diff.d.ts +39 -0
  34. package/dist/lib/cloud/diff.js +138 -0
  35. package/dist/lib/cloud/engine-bridge.d.ts +21 -0
  36. package/dist/lib/cloud/engine-bridge.js +105 -0
  37. package/dist/lib/cloud/hash-cache.d.ts +23 -0
  38. package/dist/lib/cloud/hash-cache.js +44 -0
  39. package/dist/lib/cloud/hash.d.ts +10 -0
  40. package/dist/lib/cloud/hash.js +111 -0
  41. package/dist/lib/cloud/http.d.ts +17 -0
  42. package/dist/lib/cloud/http.js +47 -0
  43. package/dist/lib/cloud/lock-path.d.ts +1 -0
  44. package/dist/lib/cloud/lock-path.js +5 -0
  45. package/dist/lib/cloud/lock.d.ts +14 -0
  46. package/dist/lib/cloud/lock.js +143 -0
  47. package/dist/lib/cloud/manifest.d.ts +6 -0
  48. package/dist/lib/cloud/manifest.js +41 -0
  49. package/dist/lib/cloud/paths.d.ts +20 -0
  50. package/dist/lib/cloud/paths.js +90 -0
  51. package/dist/lib/cloud/project-godot-merge.d.ts +32 -0
  52. package/dist/lib/cloud/project-godot-merge.js +185 -0
  53. package/dist/lib/cloud/rules.d.ts +39 -0
  54. package/dist/lib/cloud/rules.js +159 -0
  55. package/dist/lib/cloud/sync.d.ts +21 -0
  56. package/dist/lib/cloud/sync.js +518 -0
  57. package/dist/lib/cloud/transfer.d.ts +23 -0
  58. package/dist/lib/cloud/transfer.js +184 -0
  59. package/dist/lib/cloud/types.d.ts +62 -0
  60. package/dist/lib/cloud/types.js +1 -0
  61. package/dist/lib/cloud/validate-path.d.ts +23 -0
  62. package/dist/lib/cloud/validate-path.js +103 -0
  63. package/dist/lib/engine.d.ts +6 -0
  64. package/dist/lib/engine.js +36 -1
  65. package/dist/lib/game-task-plan.d.ts +42 -0
  66. package/dist/lib/game-task-plan.js +376 -0
  67. package/dist/mcp/server.js +2 -0
  68. package/dist/mcp/tools/asset-tools.js +265 -45
  69. package/dist/mcp/tools/cloud-tools.d.ts +2 -0
  70. package/dist/mcp/tools/cloud-tools.js +42 -0
  71. package/dist/mcp/tools/generate-tools.js +101 -13
  72. package/dist/mcp/tools/project-tools.js +59 -16
  73. package/gemini-extension.json +3 -3
  74. package/package.json +16 -5
  75. package/skills/3d-assets/character-model/SKILL.md +27 -5
  76. package/skills/3d-assets/environment-kit/SKILL.md +7 -2
  77. package/skills/3d-assets/organic-model/SKILL.md +4 -3
  78. package/skills/3d-assets/prop-model/SKILL.md +16 -8
  79. package/skills/3d-assets/vehicle-model/SKILL.md +4 -3
  80. package/skills/animation/animation-tree/SKILL.md +2 -0
  81. package/skills/animation/generate-motion/SKILL.md +25 -4
  82. package/skills/asset-pipeline/asset-strategy/SKILL.md +3 -2
  83. package/skills/workflow/mcpupdate/SKILL.md +134 -0
@@ -7,8 +7,8 @@
7
7
  {
8
8
  "name": "summer",
9
9
  "source": "./",
10
- "version": "2.5.0",
11
- "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.",
10
+ "version": "2.5.1",
11
+ "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 44-tool MCP bridge to the local desktop app.",
12
12
  "author": { "name": "Summer Engine", "email": "founders@summerengine.com" },
13
13
  "category": "game-development",
14
14
  "tags": ["game-dev", "godot", "ai-game-engine"],
@@ -1,15 +1,15 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
3
3
  "name": "summer",
4
- "version": "2.5.0",
5
- "description": "Superpowers for AI game dev. 60 auto-trigger skills + lifecycle hooks + MCP bridge to the local Summer Engine — the AI-native game engine.",
4
+ "version": "2.5.1",
5
+ "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 44-tool MCP bridge to the local desktop app.",
6
6
  "author": {
7
7
  "name": "Summer Engine",
8
8
  "email": "founders@summerengine.com",
9
9
  "url": "https://summerengine.com"
10
10
  },
11
11
  "homepage": "https://summerengine.com",
12
- "repository": "https://github.com/SummerEngine/summer",
12
+ "repository": "https://github.com/SummerEngine/summer-engine-agent",
13
13
  "license": "MIT",
14
14
  "keywords": [
15
15
  "game-dev",
@@ -31,6 +31,7 @@
31
31
  "./skills/workflow/skill-improve/",
32
32
  "./skills/workflow/skill-test/",
33
33
  "./skills/workflow/gameskill/",
34
+ "./skills/workflow/mcpupdate/",
34
35
  "./skills/workflow/brainstorming/",
35
36
  "./skills/workflow/investigating-bugs/",
36
37
  "./skills/workflow/verification-before-completion/",
@@ -108,7 +109,7 @@
108
109
  "enable_pre_commit_doctor": {
109
110
  "type": "boolean",
110
111
  "title": "Run summer doctor before commits",
111
- "description": "Block git commits when the Summer Engine setup has FAIL diagnostics. Off by default.",
112
+ "description": "Block git commits when the Summer Engine setup needs attention. Off by default.",
112
113
  "default": false
113
114
  }
114
115
  }
@@ -1,14 +1,14 @@
1
1
  {
2
2
  "name": "summer",
3
- "version": "2.5.0",
4
- "description": "Superpowers for AI game dev. 60 auto-trigger skills, MCP bridge to the local Summer Engine, lifecycle hooks. Build games by talking.",
3
+ "version": "2.5.1",
4
+ "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 44-tool MCP bridge. Build games by talking.",
5
5
  "author": {
6
6
  "name": "Summer Engine",
7
7
  "email": "founders@summerengine.com",
8
8
  "url": "https://summerengine.com"
9
9
  },
10
10
  "homepage": "https://summerengine.com",
11
- "repository": "https://github.com/SummerEngine/summer",
11
+ "repository": "https://github.com/SummerEngine/summer-engine-agent",
12
12
  "license": "MIT",
13
13
  "keywords": [
14
14
  "game-dev", "godot", "ai-game-engine", "skills",
@@ -20,6 +20,7 @@
20
20
  "./skills/workflow/skill-improve/",
21
21
  "./skills/workflow/skill-test/",
22
22
  "./skills/workflow/gameskill/",
23
+ "./skills/workflow/mcpupdate/",
23
24
  "./skills/workflow/brainstorming/",
24
25
  "./skills/workflow/investigating-bugs/",
25
26
  "./skills/workflow/verification-before-completion/",
@@ -91,7 +92,7 @@
91
92
  "interface": {
92
93
  "displayName": "Summer",
93
94
  "shortDescription": "Superpowers for AI game dev. Build games by talking.",
94
- "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.",
95
+ "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.",
95
96
  "developerName": "Summer Engine",
96
97
  "category": "Coding",
97
98
  "capabilities": ["Interactive", "Read", "Write"],
@@ -2,12 +2,12 @@
2
2
  "$schema": "https://cursor.com/schemas/cursor-plugin/plugin.json",
3
3
  "name": "summer",
4
4
  "displayName": "Summer",
5
- "version": "2.5.0",
6
- "description": "Superpowers for AI game dev. 60 auto-trigger skills + lifecycle hooks + MCP bridge to the local Summer Engine — the AI-native game engine.",
5
+ "version": "2.5.1",
6
+ "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 44-tool MCP bridge to the local desktop app.",
7
7
  "author": { "name": "Summer Engine", "email": "founders@summerengine.com" },
8
8
  "publisher": "summer-engine",
9
9
  "homepage": "https://summerengine.com",
10
- "repository": "https://github.com/SummerEngine/summer",
10
+ "repository": "https://github.com/SummerEngine/summer-engine-agent",
11
11
  "license": "MIT",
12
12
  "category": "developer-tools",
13
13
  "keywords": [
@@ -22,6 +22,7 @@
22
22
  "./skills/workflow/skill-improve/",
23
23
  "./skills/workflow/skill-test/",
24
24
  "./skills/workflow/gameskill/",
25
+ "./skills/workflow/mcpupdate/",
25
26
  "./skills/workflow/brainstorming/",
26
27
  "./skills/workflow/investigating-bugs/",
27
28
  "./skills/workflow/verification-before-completion/",
@@ -1,14 +1,14 @@
1
1
  {
2
2
  "name": "summer",
3
- "description": "Superpowers for AI game dev. 60 auto-trigger skills + lifecycle hooks + MCP bridge to the local Summer Engine — the AI-native game engine.",
4
- "version": "2.5.0",
3
+ "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 44-tool MCP bridge to the local desktop app.",
4
+ "version": "2.5.1",
5
5
  "author": {
6
6
  "name": "Summer Engine",
7
7
  "email": "founders@summerengine.com",
8
8
  "url": "https://summerengine.com"
9
9
  },
10
10
  "homepage": "https://summerengine.com",
11
- "repository": "https://github.com/SummerEngine/summer",
11
+ "repository": "https://github.com/SummerEngine/summer-engine-agent",
12
12
  "license": "MIT",
13
13
  "keywords": [
14
14
  "game-dev",
package/AGENTS.md CHANGED
@@ -22,13 +22,15 @@ This file is for any AI agent that loads context from `AGENTS.md` (Codex CLI, Fa
22
22
 
23
23
  ## MCP tool palette (engine on `localhost:6550`)
24
24
 
25
- 37 tools total. Categories:
25
+ 44 tools total. Categories:
26
26
 
27
- - 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`.
28
- - Diagnostics: `summer_get_script_errors`, `summer_get_diagnostics`, `summer_get_console`, `summer_clear_console`, `summer_get_debugger_errors`.
27
+ - 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`.
28
+ - Diagnostics: `summer_get_script_errors`, `summer_get_diagnostics`, `summer_get_console`, `summer_clear_console`, `summer_get_debugger_errors`, `summer_get_debugger_warnings`.
29
29
  - Runtime: `summer_play`, `summer_stop`, `summer_is_running`.
30
30
  - Project: `summer_get_project_context`, `summer_open_main_scene`, `summer_project_setting`, `summer_input_map_bind`, `summer_get_agent_playbook`.
31
- - 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`.
31
+ - 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`.
32
+ - Generation: `summer_generate_image`, `summer_generate_3d`, `summer_generate_audio`, `summer_generate_video`, `summer_generate_motion`, `summer_check_job`.
33
+ - Meta: `summer_start_game_task`.
32
34
 
33
35
  File ops, git, shell, and grep are NOT exposed — use the host's native tools.
34
36
 
package/CHANGELOG.md CHANGED
@@ -2,6 +2,24 @@
2
2
 
3
3
  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/).
4
4
 
5
+ ## [2.6.0] — 2026-06-10 — "Summer Cloud"
6
+
7
+ ### Added
8
+ - `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.
9
+ - Matching MCP tools: `summer_cloud_init`, `summer_cloud_status`, `summer_cloud_push`, `summer_cloud_pull`, `summer_cloud_restore`, `summer_cloud_checkpoints`, `summer_cloud_conflicts`.
10
+ - `.summercloudignore` support plus built-in hard excludes (`.env*`, `.summer/local/`, `node_modules/`, OS junk) so secrets and machine-local state never upload.
11
+
12
+ ### Safety
13
+ - 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.
14
+
15
+ ## [2.5.1] — 2026-05-27 — "README Polish"
16
+
17
+ ### Changed
18
+ - Removed the pseudo-JSON status example from the npm README because npm syntax highlighting made normal setup statuses look like alarming errors.
19
+
20
+ ### Fixed
21
+ - MCP generation requests now include client/tool attribution headers and surface provider 422 validation details instead of opaque `[Object]` failures.
22
+
5
23
  ## [2.5.0] — 2026-05-27 — "Project Memory"
6
24
 
7
25
  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.
@@ -17,7 +35,7 @@ Note: `2.1.0` through `2.4.0` were internal package/plugin snapshots in the engi
17
35
  ### Changed
18
36
  - `/summer:voice-line` now writes locked cast assignments to `.summer/memory/casting/voices.md`, while still reading legacy `.summer/voice-cast.md`.
19
37
  - Agent playbook and `using-summer` now require agents to read relevant project memory before creative/audio/dialogue/level/character work.
20
- - CLI and docs now link directly to the public source repo: `https://github.com/SummerEngine/summer`.
38
+ - CLI and docs now link directly to the public source repo: `https://github.com/SummerEngine/summer-engine-agent`.
21
39
 
22
40
  ### Fixed
23
41
  - MCP project context now falls back to engine health fields for project path, project name, and current scene.
@@ -39,7 +57,7 @@ The plugin rebrand. Summer is now positioned as superpowers for AI game dev —
39
57
  ### Changed
40
58
  - **Brand:** "Summer" replaces "Summer Engine CLI" across all plugin descriptions, READMEs, and orientation banners. The npm package stays `summer-engine` (continuity).
41
59
  - **README** rewritten in superpowers-homepage style — install matrix per harness, philosophy section, basic workflow walkthrough.
42
- - **MCP_STRATEGY.md** updated: documents the deliberate decision to NOT ship file/git/shell/grep tools (host agents have those natively). 37 tools shipped.
60
+ - **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.
43
61
  - All 22 user-facing skill descriptions audited and rewritten to lead with "Use when X" for tighter auto-trigger.
44
62
  - `.codex-plugin/plugin.json` `longDescription` rewritten — accurate skill count, mentions the host-native tool exclusion.
45
63
  - `.opencode/plugins/summer.js` orientation banner updated to 22 skills with explicit process / discipline / build priority.
package/GEMINI.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Summer — Context Primer for Gemini
2
2
 
3
- 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.
3
+ 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.
4
4
 
5
5
  ## What Summer Engine is
6
6
 
@@ -20,11 +20,11 @@ The single most important skill to know is `summer:using-summer` — it explains
20
20
 
21
21
  ## MCP tools (when the engine is running on `localhost:6550`)
22
22
 
23
- The `summer-engine` MCP server exposes 37 focused tools. The most important:
23
+ The `summer-engine` MCP server exposes 44 focused tools. The most important:
24
24
 
25
25
  - **Scene mutation**: `summer_add_node`, `summer_set_prop`, `summer_set_resource_property`, `summer_remove_node`, `summer_save_scene`, `summer_replace_node`, `summer_batch`.
26
26
  - **Scene inspection**: `summer_get_scene_tree`, `summer_inspect_node`, `summer_inspect_resource`.
27
- - **Diagnostics**: `summer_get_script_errors` (cheapest), `summer_get_diagnostics`, `summer_get_console`, `summer_get_debugger_errors`.
27
+ - **Diagnostics**: `summer_get_script_errors` (cheapest), `summer_get_diagnostics`, `summer_get_console`, `summer_get_debugger_errors`, `summer_get_debugger_warnings`.
28
28
  - **Run game**: `summer_play`, `summer_stop`, `summer_is_running`.
29
29
  - **Project**: `summer_get_project_context`, `summer_open_main_scene`, `summer_project_setting`, `summer_input_map_bind`.
30
30
  - **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`.