summer-engine 3.8.0 → 4.2.0

package/library/tools/wait-for-event/GUIDE.md

@@ -0,0 +1,11 @@
+# summer_wait_for_event
+
+Block until the engine emits a matching EVENT, or a bounded timeout elapses — the replacement for sleeping and re-polling. Use it right after summer_play to wait for play.started (the game actually booting), after a long op (import, script, save) to wait for op.applied / op.failed by requestId instead of guessing a delay, and during a playtest to catch script.error the moment it fires.
+
+Event kinds (v1): op.applied, op.failed, script.error, play.started, play.stopped, scene.saved, scene.opened, import.completed, selection.changed, snapshot.published. Each event is {seq, kind, ts, data}; seq is a monotonic cursor.
+
+CURSOR DISCIPLINE: events are delivered live from `since` (omitted = from now). An event that fired BEFORE this call is NOT delivered, so when the moment may come fast, take a cursor first: summer_recent_events returns next_seq — pass it as since BEFORE triggering the action (summer_recent_events -> summer_play -> summer_wait_for_event since:<next_seq> kinds:['play.started']). Every result carries next_seq: pass it as since on the next call to keep waiting with no gap.
+
+match.requestId narrows op.applied / op.failed to one request (other kinds pass through). The call long-polls the engine in slices of at most 25 s until a match or timeout_seconds (default 30, max 120) elapses.
+
+Returns {ok, matched, events, next_seq, since, timed_out, waited_ms, polls}. timed_out:true means NO matching event arrived — it is not evidence the thing did not happen (verify with summer_is_running / summer_get_diagnostics) and you must never claim an event you did not receive. A `gap` field means events between since and the oldest retained were evicted — re-read state instead of trusting the stream. On an engine build without the events channel (no capabilities.events in /api/health) the result is a structured engine_lacks_events failure and nothing is sent: fall back to polling the state.

package/library/tools/world-snapshot/GUIDE.md

@@ -0,0 +1,9 @@
+# summer_world_snapshot
+
+Compact structured snapshot of the whole EDITED scene — the cheap read to run BEFORE and AFTER every mutation batch. Per node: path, class, transform (pos/rot/scale as Godot literal strings, 3-decimal floats), world AABB (3D visuals), visibility, and 8-hex resource fingerprints (script/materials — detect-change markers, never content). Plus a light summary, camera list, environment fingerprint, and per-class counts.
+
+THE LOOP: summer_world_snapshot (note snapshot_id) -> mutate (summer_run_script / scene tools / imports) -> summer_snapshot_diff from_id:<that id> -> summer_screenshot. The diff proves exactly what changed structurally; the screenshot proves it looks right. This is how you catch a node that silently vanished on save, a transform that landed at the origin, or an AABB clipping through the floor.
+
+Node lists are path-sorted and truncated DETERMINISTICALLY (result carries total_nodes + truncated) so two snapshots stay diffable without phantom adds/removes. The engine retains the last 8 snapshots per session, keyed by snapshot_id. Use this instead of summer_get_scene_tree when you need transforms/AABBs/fingerprints or a diffable baseline; the tree read remains the hierarchy-shaped view. On an engine build that predates GetWorldSnapshot the result is a structured engine_lacks_op failure naming the fallback.
+
+KEEP IT SMALL (about 250 bytes per node): at most 200 nodes are listed by default. path_prefix reads one subtree ('House3', 'Lane2/Props'), classes keeps some node classes, fields keeps some per-node fields (e.g. ['pos','aabb']), offset/next_offset page the list. A filtered read adds matched_nodes and matched_counts (class counts of the subtree). counts and total_nodes always describe the whole scene, and snapshot_id always covers the whole scene, so summer_snapshot_diff still sees every change.

package/library/tools/write-file/GUIDE.md

@@ -0,0 +1,5 @@
+# summer_write_file
+
+Create or safely overwrite a complete text file through the identity-bound engine.
+
+For a new file, set create_only:true. For an existing file, first call summer_read_file and pass its sha256 as expected_sha256. Exactly one guard is required; unguarded writes fail closed. Supports scripts, .tscn scenes, .tres resources, JSON, docs, and project config.

package/library/tools/zoom/GUIDE.md

@@ -0,0 +1,5 @@
+# summer_zoom
+
+High-resolution close look at part of a frame: region [x, y, w, h] (fractions of the frame) or mark N from a marks render of the same pose. The camera renders the EXACT sub-frustum of that region at full output resolution, so you see real texture detail, seams, gaps and floating pieces, not upscaled pixels. A region is honoured exactly (no pad by default, never widened to an aspect ratio: the image takes the region's own aspect, with dark bars only for extreme shapes); a mark gets pad 0.15.
+
+Use after a sheet or debug view shows something suspicious. view picks beauty or a debug view. Returns the zoomed image + caption (the real zoom factor, the rendered region, widened_because when it is larger than asked, mark -> node path and a warning when that node is hidden). Read-only: the scene file, the open tab and the undo history are never touched (the render is an offscreen copy of the SAVED scene). The image arrives inline; the caption carries poses, labels and numbers. Failures are structured (failure_reason), never a silent fallback.

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "summer-engine",
-  "version": "3.8.0",
-  "description": "Local Summer CLI and MCP server for Summer Engine. Install and run the engine, connect Claude Code, Cursor, Codex, Gemini, and other agents, and build real games with bundled skills, hooks, and plugins.",
+  "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": [
     "summer-engine",
     "summer-cli",
@@ -43,6 +44,7 @@
     "library/",
     "registry/generated/",
     "registry/schemas/",
+    "registry/operations/",
     "integrations/",
     "commands/",
     "hooks/",
@@ -59,8 +61,7 @@
     "NOTICE",
     "CHANGELOG.md",
     "AGENTS.md",
-    "GEMINI.md",
-    "CLAUDE.md"
+    "GEMINI.md"
   ],
   "scripts": {
     "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
@@ -76,8 +77,10 @@
     "test:watch": "vitest",
     "prepublishOnly": "npm run build && npm test",
     "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": 125,
+    "skill": 128,
     "template": 19,
     "tool": 119
   },
-  "total": 272
+  "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": "3.8.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": {
@@ -40,7 +40,6 @@
     "./library/skills/brainstorming/",
     "./library/skills/browse-templates/",
     "./library/skills/camera-rigs/",
-    "./library/skills/celeste-momentum-platforming/",
     "./library/skills/character-animation-wiring/",
     "./library/skills/character-model/",
     "./library/skills/character-movement/",
@@ -49,6 +48,7 @@
     "./library/skills/combat-basics/",
     "./library/skills/compatibility-renderer-traps/",
     "./library/skills/concept-art/",
+    "./library/skills/concept-to-level/",
     "./library/skills/create-asset-sheet/",
     "./library/skills/debug/",
     "./library/skills/debugging-game-feel/",
@@ -67,13 +67,11 @@
     "./library/skills/gameskill/",
     "./library/skills/gdscript-patterns/",
     "./library/skills/generate-motion/",
-    "./library/skills/godogen-visual-proof-game-generation/",
     "./library/skills/grow-analytics/",
     "./library/skills/headless-scripting/",
     "./library/skills/in-game-purchases/",
     "./library/skills/instantiate-asset-pack/",
     "./library/skills/investigating-bugs/",
-    "./library/skills/lumera-single-image-scene-reconstruction/",
     "./library/skills/make-game/",
     "./library/skills/multiplayer/",
     "./library/skills/multiplayer-movement/",
@@ -90,9 +88,7 @@
     "./library/skills/playtesting-a-feature/",
     "./library/skills/procedural-animation/",
     "./library/skills/prop-model/",
-    "./library/skills/psx-retro-rendering/",
     "./library/skills/publish-your-game/",
-    "./library/skills/realtime-wet-surfaces/",
     "./library/skills/release-readiness/",
     "./library/skills/remote-deploy/",
     "./library/skills/retarget/",
@@ -102,10 +98,6 @@
     "./library/skills/scene-hierarchy-design/",
     "./library/skills/scene-scripting/",
     "./library/skills/scene-to-level/",
-    "./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/",
@@ -115,6 +107,8 @@
     "./library/skills/summer-analytics/",
     "./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/",
@@ -147,7 +141,6 @@
     "./library/skills/web-and-touch-input/",
     "./library/skills/web-compatibility-look/",
     "./library/skills/world-building-3d/",
-    "./library/skills/writing-plans/",
-    "./library/skills/writing-skills/"
+    "./library/skills/writing-plans/"
   ]
 }