summer-engine 4.0.0 → 4.2.0

package/library/skills/voice-line/SKILL.md

@@ -304,3 +304,19 @@ Print the call (text, voice id, params, target path). User runs via the Summer d
 - `audio-direction` — Voice bus and ducking rules
 - `sound-effect` — non-verbal vocal SFX (grunt, scream)
 - `adaptive-music` — ducking integration
+
+<!-- shell-commands: generated from the operation catalog by npm run generate:registry; do not edit by hand -->
+## From a shell
+
+No Summer MCP tools in this session? Run each one as a command; when `summer --version` is missing or below 4.0, use `npx -y summer-engine@latest` in place of `summer`. Fields are flags in kebab-case (`--scene-path res://main.tscn`) or one `--input '<json>'`, and `summer ops describe <op>` prints the exact input. The `summer-cli` skill has the rest.
+
+| In this skill | Command |
+|---|---|
+| `assets.generate_audio`, `summer_assets_generate_audio` | `summer assets generate-audio` |
+| `summer_assets_search` | `summer assets search` |
+| `summer_add_node` | `summer engine add-node` |
+| `summer_import_from_url` | `summer engine import-from-url` |
+| `summer_inspect_node` | `summer engine inspect-node` |
+| `summer_run_script` | `summer engine run-script` |
+| `summer_set_prop` | `summer engine set-prop` |
+<!-- /shell-commands -->

package/library/skills/web-and-touch-input/SKILL.md

@@ -36,3 +36,22 @@ Add a `TouchControls` CanvasLayer (layer 10) and show it only when `DisplayServe
 ## 4. Verify
 
 Run the game and check the keyboard controls and the title screen's first click. Set `input_devices/pointing/emulate_touch_from_mouse` on temporarily to try the touch buttons with the mouse, then turn it off again.
+
+<!-- shell-commands: generated from the operation catalog by npm run generate:registry; do not edit by hand -->
+## From a shell
+
+No Summer MCP tools in this session? Run each one as a command; when `summer --version` is missing or below 4.0, use `npx -y summer-engine@latest` in place of `summer`. Fields are flags in kebab-case (`--scene-path res://main.tscn`) or one `--input '<json>'`, and `summer ops describe <op>` prints the exact input. The `summer-cli` skill has the rest.
+
+| In this skill | Command |
+|---|---|
+| `summer_add_node` | `summer engine add-node` |
+| `summer_batch` | `summer engine batch` |
+| `summer_get_diagnostics` | `summer engine get-diagnostics` |
+| `summer_input_map_bind` | `summer engine input-map-bind` |
+| `summer_play` | `summer engine play` |
+| `summer_save_scene` | `summer engine save-scene` |
+| `summer_screenshot` | `summer engine screenshot` |
+| `summer_set_prop` | `summer engine set-prop` |
+| `summer_stop` | `summer engine stop` |
+| `summer_write_file` | `summer engine write-file` |
+<!-- /shell-commands -->

package/library/skills/web-compatibility-look/SKILL.md

@@ -60,3 +60,23 @@ Glow and some environment adjustments depend on the engine version. If you use t
 ## Verify
 
 Run the game, take one screenshot in the web preview, and compare it to the palette and the look. A grey, blank or default-looking capture means the look is not there yet, or a Forward+-only feature was used: fix it before moving on.
+
+<!-- shell-commands: generated from the operation catalog by npm run generate:registry; do not edit by hand -->
+## From a shell
+
+No Summer MCP tools in this session? Run each one as a command; when `summer --version` is missing or below 4.0, use `npx -y summer-engine@latest` in place of `summer`. Fields are flags in kebab-case (`--scene-path res://main.tscn`) or one `--input '<json>'`, and `summer ops describe <op>` prints the exact input. The `summer-cli` skill has the rest.
+
+| In this skill | Command |
+|---|---|
+| `summer_add_node` | `summer engine add-node` |
+| `summer_batch` | `summer engine batch` |
+| `summer_get_diagnostics` | `summer engine get-diagnostics` |
+| `summer_get_scene_tree` | `summer engine get-scene-tree` |
+| `summer_play` | `summer engine play` |
+| `summer_project_setting` | `summer engine project-setting` |
+| `summer_save_scene` | `summer engine save-scene` |
+| `summer_screenshot` | `summer engine screenshot` |
+| `summer_set_prop` | `summer engine set-prop` |
+| `summer_set_resource_property` | `summer engine set-resource-property` |
+| `summer_stop` | `summer engine stop` |
+<!-- /shell-commands -->

package/library/skills/world-building-3d/SKILL.md

@@ -110,3 +110,31 @@ unavailable physics, or missing bounds by guessing. Fix the scene structure or
 choose a clearly labeled manual fallback, then verify it.
 
 Do not retry a mutation after an oversized or ambiguous result unless the receipt explicitly says it is retry-safe; the first mutation may already have landed.
+
+<!-- shell-commands: generated from the operation catalog by npm run generate:registry; do not edit by hand -->
+## From a shell
+
+No Summer MCP tools in this session? Run each one as a command; when `summer --version` is missing or below 4.0, use `npx -y summer-engine@latest` in place of `summer`. Fields are flags in kebab-case (`--scene-path res://main.tscn`) or one `--input '<json>'`, and `summer ops describe <op>` prints the exact input. The `summer-cli` skill has the rest.
+
+| In this skill | Command |
+|---|---|
+| `summer_align_distribute_3d` | `summer engine align-distribute-3d` |
+| `summer_attach_to_surface` | `summer engine attach-to-surface` |
+| `summer_connect_ports` | `summer engine connect-ports` |
+| `summer_get_scene_tree` | `summer engine get-scene-tree` |
+| `summer_inspect_asset` | `summer engine inspect-asset` |
+| `summer_inspect_node` | `summer engine inspect-node` |
+| `summer_instantiate_scene` | `summer engine instantiate-scene` |
+| `summer_measure` | `summer engine measure` |
+| `summer_navigation_probe` | `summer engine navigation-probe` |
+| `summer_open_scene` | `summer engine open-scene` |
+| `summer_place_adjacent` | `summer engine place-adjacent` |
+| `summer_play` | `summer engine play` |
+| `summer_raycast` | `summer engine raycast` |
+| `summer_repeat_along` | `summer engine repeat-along` |
+| `summer_screenshot` | `summer engine screenshot` |
+| `summer_set_prop` | `summer engine set-prop` |
+| `summer_snap_to_surface` | `summer engine snap-to-surface` |
+| `summer_starcast` | `summer engine starcast` |
+| `summer_test_placement` | `summer engine test-placement` |
+<!-- /shell-commands -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "summer-engine",
-  "version": "4.0.0",
+  "version": "4.2.0",
   "description": "MCP server, CLI and skills for Summer Engine, the game engine built for AI. Connect Claude Code, Cursor, Codex and other agents to build, test and publish full games to summer.games.",
   "mcpName": "io.github.SummerEngine/summer",
   "keywords": [
@@ -79,7 +79,8 @@
     "generate:registry": "node scripts/generate-registry/cli.ts",
     "generate:tool-guides": "UPDATE_TOOL_GUIDES=1 vitest run src/mcp/tool-guides.test.ts",
     "generate:product-map": "npm run build && node scripts/navigation/render-product-map.ts",
-    "sync:web-routes": "npm run build && node scripts/navigation/sync-web-routes.ts"
+    "sync:web-routes": "npm run build && node scripts/navigation/sync-web-routes.ts",
+    "sync:catalog": "node scripts/sync-public-catalog.ts"
   },
   "engines": {
     "node": ">=20"

package/registry/generated/counts.json

@@ -4,9 +4,9 @@
     "collection": 0,
     "example": 0,
     "reference": 9,
-    "skill": 127,
+    "skill": 128,
     "template": 19,
     "tool": 119
   },
-  "total": 274
+  "total": 275
 }

package/registry/generated/gemini-extension.json

@@ -1,8 +1,8 @@
 {
   "_generated": "GENERATED from integrations/gemini — do not edit; npm run generate:registry",
   "name": "summer",
-  "version": "4.0.0",
-  "description": "Agent tooling for Summer Engine: MCP bridge, context primer, and game-dev skills. Use with the npm CLI for skill files on disk.",
+  "version": "4.2.0",
+  "description": "The game engine built for AI. Any agent makes a multiplayer game and publishes it. The Summer Engine MCP server, context primer and game-dev skills.",
   "contextFileName": "GEMINI.md",
   "mcpServers": {
     "summer-engine": {
@@ -108,6 +108,7 @@
     "./library/skills/summer-apps/",
     "./library/skills/summer-apps-design/",
     "./library/skills/summer-assets/",
+    "./library/skills/summer-cli/",
     "./library/skills/summer-friends/",
     "./library/skills/summer-leaderboards/",
     "./library/skills/summer-match-results/",