summer-engine 3.4.0 → 3.5.0

package/dist/mcp/tools/library-tools.d.ts

@@ -3,7 +3,8 @@
  * librarian. Behavior lives in src/core/library-search.ts and
  * src/core/library-read.ts; `summer tool search-library|read-library`
  * (src/core/capabilities/tool-dispatch.ts) calls the same functions.
- * Engine-free: both read the library shipped with this package.
+ * Engine-free: both read the library shipped with this package; a hosted
+ * skill's body comes from the hosted Summer Engine MCP when signed in.
  */
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 export declare const SEARCH_LIBRARY_DESCRIPTION: string;

package/dist/mcp/tools/library-tools.js

@@ -15,6 +15,7 @@ export const READ_LIBRARY_DESCRIPTION = "Load one library entry by id (<kind>/<s
     "Skills: the SKILL.md body plus metadata (status, use_when, related) and how to invoke the skill in your host (bare slug). " +
     "Tools: how to call it (MCP name, `summer tool <slug> --args`, engine requirement, authority) plus the descriptor. " +
     "Templates: the pinned repo @ commit and tree digest (or built-in) and the `summer create <slug>` command. References: the markdown body. " +
+    "Hosted skills (publish-your-game, store-listing, store-art, grow-analytics; also by their summer://skills/<slug> URI): the current text from the hosted Summer Engine MCP with the store sign-in, else the local summary plus why and how to load the rest. " +
     "Linked files: a body ends with its relative links and the id that loads each; a file an entry links loads by <entry id>/<link as written> " +
     "(e.g. skill/spatial-placement/references/kit-placement-tools.md), by the relative path alone when one entry ships it, inside library/ only. " +
     "part: 'skill' = body only, 'resource' = the resource.yaml descriptor only, 'all' (default) = both. " +

package/dist/mcp/tools/navigation-tools.d.ts

@@ -2,6 +2,6 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 /**
  * summer_open — the MCP face of `summer open`. Same behavior as the CLI
  * (src/core/capabilities/navigation/open.ts runOpen); this file only supplies
- * the engine client and the browser launcher. Design: docs/design/NAVIGATION-DESIGN.md §3.
+ * the engine client and the browser launcher.
  */
 export declare function registerNavigationTools(server: McpServer): void;

package/dist/mcp/tools/navigation-tools.js

@@ -6,7 +6,7 @@ import { openArgsShape, runOpen } from "../../core/capabilities/navigation/open.
 /**
  * summer_open — the MCP face of `summer open`. Same behavior as the CLI
  * (src/core/capabilities/navigation/open.ts runOpen); this file only supplies
- * the engine client and the browser launcher. Design: docs/design/NAVIGATION-DESIGN.md §3.
+ * the engine client and the browser launcher.
  */
 export function registerNavigationTools(server) {
     server.tool("summer_open", `Open the exact summerengine.com page or Summer Engine editor surface the user wants to LOOK at, by intent name — or, with open:false, return the URL / engine op without opening anything. The result ALWAYS carries the resolved url or op, also after opening, so you can tell the user where they landed.

package/dist/mcp/tools/spatial-tools.js

@@ -16,7 +16,7 @@ const NODE_PATH_LIMIT_BYTES = 256;
 const MIN_PLACEMENT_FLOOR_DISTANCE = 0.001;
 /** Mirrors the engine's SnapToSurface direction guard (length² > 1e-5). */
 const MIN_SNAP_DIRECTION_LENGTH_SQUARED = 0.00001;
-/** Starcast's own ceilings (engine spatial_ops.cpp starcast_3d): the engine
+/** Starcast's own ceilings in the engine: the engine
  *  measures the compact receipt as UTF-8 JSON, downgrades full -> summary
  *  above 12 KiB, and strips secondary paths above 5 KiB, so a receipt past the
  *  ceiling for its returnedDetail is one this CLI does not understand. Unlike

package/dist/mcp/tools/visual-tools.js

@@ -353,8 +353,8 @@ Static frame only — one moment, not motion. For a SEQUENCE of frames over time
                     if (snap.sceneHadLight === false) {
                         warnings.push("WARNING: this scene has no light — lit materials may appear black when played.");
                     }
-                    // The engine ALWAYS synthesizes the preview camera (preview_ops.cpp
-                    // sets used_synthetic_camera unconditionally) — the flag says nothing
+                    // The engine ALWAYS synthesizes the preview camera (it sets
+                    // used_synthetic_camera unconditionally) — the flag says nothing
                     // about the scene's own cameras. sceneHasCamera above is the
                     // authoritative "does this scene have a camera" answer.
                     if (snap.usedSyntheticCamera) {

package/dist/mcp/tools/with-engine.d.ts

@@ -41,8 +41,7 @@ export interface WithEngineOptions<T> {
 }
 /**
  * An auth failure is the ONE class of thrown error that is provably pre-apply:
- * the engine rejects on the Bearer-token check (tool_net_thread.cpp::_validate_auth)
- * BEFORE the op is queued or applied, so reconnecting with the fresh api-token and
+ * the engine rejects on the Bearer-token check BEFORE the op is queued or applied, so reconnecting with the fresh api-token and
  * retrying cannot double-apply a mutation. This is exactly the stale-token case
  * after the engine rotates its api-token on relaunch.
  *

package/dist/mcp/tools/with-engine.js

@@ -30,8 +30,7 @@ function readClassifiers(result) {
 }
 /**
  * An auth failure is the ONE class of thrown error that is provably pre-apply:
- * the engine rejects on the Bearer-token check (tool_net_thread.cpp::_validate_auth)
- * BEFORE the op is queued or applied, so reconnecting with the fresh api-token and
+ * the engine rejects on the Bearer-token check BEFORE the op is queued or applied, so reconnecting with the fresh api-token and
  * retrying cannot double-apply a mutation. This is exactly the stale-token case
  * after the engine rotates its api-token on relaunch.
  *

package/gemini-extension.json

@@ -1,7 +1,7 @@
 {
   "_generated": "GENERATED from integrations/gemini — do not edit; npm run generate:registry",
   "name": "summer",
-  "version": "3.4.0",
+  "version": "3.5.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.",
   "contextFileName": "GEMINI.md",
   "mcpServers": {
@@ -68,6 +68,7 @@
     "./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/",
@@ -90,6 +91,7 @@
     "./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/remote-deploy/",
     "./library/skills/retarget/",
@@ -107,6 +109,8 @@
     "./library/skills/sound-effect/",
     "./library/skills/spatial-placement/",
     "./library/skills/sprite-sheet/",
+    "./library/skills/store-art/",
+    "./library/skills/store-listing/",
     "./library/skills/summer-analytics/",
     "./library/skills/summer-friends/",
     "./library/skills/summer-leaderboards/",

package/hooks/session-start.sh

@@ -3,8 +3,8 @@
 #
 # Event:    SessionStart (matcher: startup|clear|compact)
 # Purpose:  Orient Claude on every fresh Summer-enabled session.
-#           Detect Summer project + GameSoul + doctor health, surface a one-line
-#           Bob-style greeting as additional context.
+#           Detect Summer project + GameSoul + doctor health and surface a short
+#           greeting as additional context.
 #
 # Input:    JSON on stdin with { session_id, source, model, cwd, ... }
 #           Common Claude Code env vars: $CLAUDE_PROJECT_DIR, $CLAUDE_PLUGIN_ROOT

package/integrations/README.md

@@ -1,94 +1,88 @@
-# integrations/ — the complete, honest map of agent support
+# integrations/: which agents Summer supports
 
-One folder per supported client. This directory is the single place that
-says which agents Summer supports and how each one consumes the library.
-Adding a new agent = one row in `src/installer/agent-table.ts` + one folder
-here + an empty entry in `scripts/generate-registry/targets.ts` (plus, if it
-has a manifest file, a builder in `scripts/generate-registry/manifests.ts`) +
-`npm run generate:registry` — never hand-editing root files. Tests fail when
-the table, this directory, and targets.ts disagree.
+One folder per supported client. Each folder says how that client consumes
+the library.
+
+Adding an agent: one row in `src/installer/agent-table.ts`, one folder here,
+an empty entry in `scripts/generate-registry/targets.ts` (plus a builder in
+`scripts/generate-registry/manifests.ts` if the client has a manifest file),
+then `npm run generate:registry`. Never hand-edit root files. Tests fail when
+the table, this directory and `targets.ts` disagree.
 
 Each folder contains:
 
-- `README.md` — what gets generated where, or (for clients with no manifest
-  file in this repo) exactly what `summer setup <client>` writes at install
-  time: MCP config path and skills destination.
+- `README.md`: what gets generated where, or (for clients with no manifest
+  file in this repo) what `summer setup <client>` writes at install time.
+- `manifest-target.json`: generated file -> repo-root destination (empty when
+  nothing is generated). Mirrors `scripts/generate-registry/targets.ts`; a test
+  fails if they drift.
 
-`summer setup <client>` (default `--scope user`) writes the MCP config AND
-installs every skill (`skills install --all`, preview included; `--stable-only`
-skips preview) in the SAME scope,
-so a user-scope MCP config never ends up beside project-scope skills.
-`--scope project` moves both; `--recommended` installs only the recommended
-subset. Clients whose MCP config is user-only (see the table) fall back to user
-scope with a warning. `.mcp.json` at the repo root
-(the MCP pointer the claude / codex / cursor / factory manifests share) is
-generated too — `registry/generated/mcp.json -> .mcp.json`.
-- `manifest-target.json` — mapping of generated file -> repo-root destination
-  (empty when nothing is generated). Mirrors
-  `scripts/generate-registry/targets.ts`; a test fails if they drift.
+`summer setup <client>` (default `--scope user`) writes the MCP config and
+installs every skill (`skills install --all`, preview included;
+`--stable-only` skips preview) in the same scope, so a user-scope MCP config
+never sits beside project-scope skills. `--scope project` moves both;
+`--recommended` installs only the recommended subset. Clients whose MCP config
+is user-only fall back to user scope with a warning.
 
-Generated root dot-files (`.claude-plugin/plugin.json`, `gemini-extension.json`,
-…) are build artifacts of `integrations/<agent>` + `library/` — their
-`_generated` banner says so ("GENERATED from integrations/<agent> — do not
-edit; npm run generate:registry"). CI `--check` fails on any drift between
-`library/`, `registry/generated/`, and the applied root files.
+Generated root files (`.claude-plugin/plugin.json`, `gemini-extension.json`,
+`.mcp.json`, …) are build artifacts of `integrations/<agent>` + `library/`.
+Their `_generated` banner says so. CI `--check` fails on any drift between
+`library/`, `registry/generated/` and the applied root files.
 
 How the plugin manifests reference skills, and what is verified:
 
-- **Claude Code** — the plugin-manifest `skills` field accepts a string or an
-  array of `./`-relative directory paths and *extends* the default `skills/`
-  scan (Claude Code plugins reference, "Plugin manifest schema"). The
-  generated `.claude-plugin/plugin.json` lists one entry per skill
-  (`./library/skills/<slug>/`). The docs do not say whether a listed
-  directory is loaded as one skill or scanned for skill subfolders, and this
-  repo has not yet loaded the generated manifest through the real plugin
-  path (the smoke tests exercise the `summer setup` install path, not the
-  marketplace one) — treat the marketplace install as unverified until that
-  run exists.
-- **Codex** — `.codex-plugin/plugin.json` carries the same per-skill `skills`
-  array. Whether Codex reads that field, and with which type, is
-  **unverified**; the v2 manifest carried it and nobody has confirmed a load.
-- **Factory** — reads skills only from a root `skills/` directory; the
-  manifest's `skills` array is not read (open gap, see the table).
+- **Claude Code**: the plugin-manifest `skills` field accepts a string or an
+  array of `./`-relative directory paths and extends the default `skills/`
+  scan. The generated `.claude-plugin/plugin.json` lists one entry per skill
+  (`./library/skills/<slug>/`). The docs do not say whether a listed directory
+  loads as one skill or is scanned for skill subfolders, and the smoke tests
+  cover the `summer setup` path, not the marketplace one. Treat the
+  marketplace install as unverified.
+- **Codex**: `.codex-plugin/plugin.json` carries the same `skills` array.
+  Whether Codex reads that field is **unverified**.
+- **Factory**: a plugin install reads skills only from a root `skills/`
+  directory, so it exposes no skills. `summer setup factory` installs them.
+
+Paths below are for macOS; `~` is `%USERPROFILE%` on Windows. Other OS paths
+are listed where they differ.
 
 | Client | Manifest generated in this repo | `summer setup` writes |
 |---|---|---|
-| claude | `.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json`, `.mcp.json` | MCP: `~/.claude.json`; Windows `%USERPROFILE%/.claude.json` / `.mcp.json`; skills: `~/.claude/skills` / `.claude/skills` (`<skill>/SKILL.md`) |
+| claude | `.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json`, `.mcp.json` | MCP: `~/.claude.json`; project `.mcp.json`; skills: `~/.claude/skills`; project `.claude/skills` (`<skill>/SKILL.md`) |
 | claude-desktop | — | MCP: `~/Library/Application Support/Claude/claude_desktop_config.json`; Linux `~/.config/Claude/claude_desktop_config.json`; Windows `%APPDATA%/Claude/claude_desktop_config.json`; no skills folder (MCP only) |
-| codex | `.codex-plugin/plugin.json` | MCP: `~/.codex/config.toml`; Windows `%USERPROFILE%/.codex/config.toml` / `.codex/config.toml`; skills: `~/.agents/skills` / `.agents/skills` (`<skill>/SKILL.md`) |
-| cursor | `.cursor-plugin/plugin.json` | MCP: `~/.cursor/mcp.json`; Windows `%USERPROFILE%/.cursor/mcp.json` / `.cursor/mcp.json`; skills: `~/.cursor/skills` / `.cursor/skills` (`<skill>/SKILL.md`) |
-| windsurf | — | MCP: `~/.codeium/windsurf/mcp_config.json`; Windows `%USERPROFILE%/.codeium/windsurf/mcp_config.json`; skills: `~/.codeium/windsurf/skills` / `.windsurf/skills` (`<skill>/SKILL.md`) |
-| antigravity | — | MCP: `~/.gemini/config/mcp_config.json`; Windows `%USERPROFILE%/.gemini/config/mcp_config.json` / `.agents/mcp_config.json`; skills: `~/.gemini/config/skills` / `.agents/skills` (`<skill>/SKILL.md`) |
-| gemini (legacy) | `gemini-extension.json` | MCP: `~/.gemini/extensions/summer-engine/gemini-extension.json`; Windows `%USERPROFILE%/.gemini/extensions/summer-engine/gemini-extension.json`; skills: `~/.gemini/extensions/summer-engine/skills` (`<skill>/SKILL.md`) |
-| cline | — | MCP: `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`; Linux `~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`; Windows `%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`; skills: `~/.cline/skills` / `.cline/skills` (`<skill>/SKILL.md`) |
-| cline-cli | — | MCP: `~/.cline/data/settings/cline_mcp_settings.json`; Windows `%USERPROFILE%/.cline/data/settings/cline_mcp_settings.json`; skills: `~/.cline/skills` / `.cline/skills` (`<skill>/SKILL.md`) |
-| roo-code (legacy) | — | MCP: `~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json`; Linux `~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json`; Windows `%APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json`; skills: `~/Documents/Roo/Rules` / `.clinerules` (rule files `summer-<skill>.md`) |
-| kilo-code | — | MCP: `~/.config/kilo/kilo.json`; Windows `%APPDATA%/kilo/kilo.json` / `kilo.json`; skills: `~/.kilo/skills` / `.kilo/skills` (`<skill>/SKILL.md`) |
-| github-copilot | — | MCP: `~/.copilot/mcp-config.json`; Windows `%USERPROFILE%/.copilot/mcp-config.json` / `.mcp.json`; skills: `~/.copilot/skills` / `.github/skills` (`<skill>/SKILL.md`) |
-| vscode-copilot | — | MCP: `~/Library/Application Support/Code/User/mcp.json`; Linux `~/.config/Code/User/mcp.json`; Windows `%APPDATA%/Code/User/mcp.json` / `.vscode/mcp.json`; skills: `~/.copilot/skills` / `.github/skills` (`<skill>/SKILL.md`) |
-| visual-studio | — | MCP: `~/.mcp.json`; Windows `%USERPROFILE%/.mcp.json` / `.mcp.json`; no skills folder (MCP only) |
+| codex | `.codex-plugin/plugin.json` | MCP: `~/.codex/config.toml`; project `.codex/config.toml`; skills: `~/.agents/skills`; project `.agents/skills` (`<skill>/SKILL.md`) |
+| cursor | `.cursor-plugin/plugin.json` | MCP: `~/.cursor/mcp.json`; project `.cursor/mcp.json`; skills: `~/.agents/skills`; project `.agents/skills` (`<skill>/SKILL.md`) |
+| windsurf | — | MCP: `~/.codeium/windsurf/mcp_config.json`; skills: `~/.agents/skills`; project `.agents/skills` (`<skill>/SKILL.md`) |
+| antigravity | — | MCP: `~/.gemini/config/mcp_config.json`; project `.agents/mcp_config.json`; skills: `~/.gemini/config/skills`; project `.agents/skills` (`<skill>/SKILL.md`) |
+| gemini (legacy) | `gemini-extension.json` | MCP: `~/.gemini/extensions/summer-engine/gemini-extension.json`; skills: `~/.gemini/extensions/summer-engine/skills` (`<skill>/SKILL.md`) |
+| cline | — | MCP: `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`; Linux `~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`; Windows `%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`; skills: `~/.cline/skills`; project `.cline/skills` (`<skill>/SKILL.md`) |
+| cline-cli | — | MCP: `~/.cline/data/settings/cline_mcp_settings.json`; skills: `~/.cline/skills`; project `.cline/skills` (`<skill>/SKILL.md`) |
+| roo-code (legacy) | — | MCP: `~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json`; Linux `~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json`; Windows `%APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json`; skills: `~/Documents/Roo/Rules`; project `.clinerules` (rule files `summer-<skill>.md`) |
+| kilo-code | — | MCP: `~/.config/kilo/kilo.json`; Windows `%APPDATA%/kilo/kilo.json`; project `kilo.json`; skills: `~/.kilo/skills`; project `.kilo/skills` (`<skill>/SKILL.md`) |
+| github-copilot | — | MCP: `~/.copilot/mcp-config.json`; project `.mcp.json`; skills: `~/.copilot/skills`; project `.github/skills` (`<skill>/SKILL.md`) |
+| vscode-copilot | — | MCP: `~/Library/Application Support/Code/User/mcp.json`; Linux `~/.config/Code/User/mcp.json`; Windows `%APPDATA%/Code/User/mcp.json`; project `.vscode/mcp.json`; skills: `~/.agents/skills`; project `.agents/skills` (`<skill>/SKILL.md`) |
+| visual-studio | — | MCP: `~/.mcp.json`; project `.mcp.json`; no skills folder (MCP only) |
 | copilot-jetbrains | — | MCP: `~/.config/github-copilot/intellij/mcp.json`; Windows `%APPDATA%/github-copilot/intellij/mcp.json`; no skills folder (MCP only) |
-| opencode | — | MCP: `~/.config/opencode/opencode.json`; Windows `%APPDATA%/opencode/opencode.json` / `opencode.json`; skills: `~/.config/opencode/skills` / `.opencode/skills` (`<skill>/SKILL.md`) |
-| zed | — | MCP: `~/.config/zed/settings.json`; Windows `%APPDATA%/zed/settings.json`; skills: `~/.agents/skills` / `.agents/skills` (`<skill>/SKILL.md`) |
-| kiro | — | MCP: `~/.kiro/settings/mcp.json`; Windows `%USERPROFILE%/.kiro/settings/mcp.json` / `.kiro/settings/mcp.json`; skills: `~/.kiro/skills` / `.kiro/skills` (`<skill>/SKILL.md`) |
-| goose | — | MCP: `~/.config/goose/config.yaml`; Windows `%APPDATA%/Block/goose/config/config.yaml`; skills: `~/.config/agents/skills` / `.agents/skills` (`<skill>/SKILL.md`) |
-| hermes | — | MCP: `~/.hermes/config.yaml`; Windows `%USERPROFILE%/.hermes/config.yaml`; skills: `~/.hermes/skills` / `.hermes/skills` (`<skill>/SKILL.md`) |
-| trae | — | MCP: `.trae/mcp.json` / `.trae/mcp.json`; no skills folder (MCP only) |
-| qwen-code | — | MCP: `~/.qwen/settings.json`; Windows `%USERPROFILE%/.qwen/settings.json` / `.qwen/settings.json`; skills: `~/.qwen/skills` / `.qwen/skills` (`<skill>/SKILL.md`) |
-| kimi-code | — | MCP: `~/.kimi-code/mcp.json`; Windows `%USERPROFILE%/.kimi-code/mcp.json` / `.kimi-code/mcp.json`; skills: `~/.kimi-code/skills` / `.kimi-code/skills` (`<skill>/SKILL.md`) |
-| crush | — | MCP: `~/.config/crush/crushrc`; Windows `%USERPROFILE%/.config/crush/crushrc` / `.crushrc`; skills: `~/.config/crush/skills` / `.crush/skills` (`<skill>/SKILL.md`) |
-| amp | — | MCP: `~/.config/amp/settings.json`; Windows `%APPDATA%/amp/settings.json`; skills: `~/.config/amp/skills` / `.agents/skills` (`<skill>/SKILL.md`) |
-| factory | `.factory-plugin/plugin.json` | MCP: `~/.factory/mcp.json`; Windows `%USERPROFILE%/.factory/mcp.json` / `.factory/mcp.json`; skills: `~/.factory/skills` / `.factory/skills` (`<skill>/SKILL.md`) |
-| junie | — | MCP: `~/.junie/mcp/mcp.json`; Windows `%USERPROFILE%/.junie/mcp/mcp.json` / `.junie/mcp/mcp.json`; no skills folder (MCP only) |
-| warp | — | MCP: `~/.warp/.mcp.json`; Windows `%USERPROFILE%/.warp/.mcp.json` / `.warp/.mcp.json`; skills: `~/.warp/skills` / `.warp/skills` (`<skill>/SKILL.md`) |
-| rovo-dev | — | MCP: `~/.rovodev/mcp.json`; Windows `%USERPROFILE%/.rovodev/mcp.json`; skills: `~/.rovodev/skills` / `.rovodev/skills` (`<skill>/SKILL.md`) |
-| qoder | — | MCP: `~/.qoder/settings.json`; Windows `%USERPROFILE%/.qoder/settings.json` / `.mcp.json`; skills: `~/.qoder/skills` / `.qoder/skills` (`<skill>/SKILL.md`) |
-| grok-build | — | MCP: `~/.grok/config.toml`; Windows `%USERPROFILE%/.grok/config.toml` / `.grok/config.toml`; skills: `~/.grok/skills` / `.grok/skills` (`<skill>/SKILL.md`) |
-| mistral-vibe | — | MCP: `~/.vibe/config.toml`; Windows `%USERPROFILE%/.vibe/config.toml` / `.vibe/config.toml`; skills: `~/.vibe/skills` / `.vibe/skills` (`<skill>/SKILL.md`) |
-| lm-studio | — | MCP: `~/.lmstudio/mcp.json`; Windows `%USERPROFILE%/.lmstudio/mcp.json`; no skills folder (MCP only) |
+| opencode | — | MCP: `~/.config/opencode/opencode.json`; Windows `%APPDATA%/opencode/opencode.json`; project `opencode.json`; skills: `~/.agents/skills`; project `.agents/skills` (`<skill>/SKILL.md`) |
+| zed | — | MCP: `~/.config/zed/settings.json`; Windows `%APPDATA%/zed/settings.json`; skills: `~/.agents/skills`; project `.agents/skills` (`<skill>/SKILL.md`) |
+| kiro | — | MCP: `~/.kiro/settings/mcp.json`; project `.kiro/settings/mcp.json`; skills: `~/.kiro/skills`; project `.kiro/skills` (`<skill>/SKILL.md`) |
+| goose | — | MCP: `~/.config/goose/config.yaml`; Windows `%APPDATA%/Block/goose/config/config.yaml`; skills: `~/.config/agents/skills`; project `.agents/skills` (`<skill>/SKILL.md`) |
+| hermes | — | MCP: `~/.hermes/config.yaml`; skills: `~/.hermes/skills`; project `.agents/skills` (`<skill>/SKILL.md`) |
+| trae | — | MCP: `.trae/mcp.json` (project only); no skills folder (MCP only) |
+| qwen-code | — | MCP: `~/.qwen/settings.json`; project `.qwen/settings.json`; skills: `~/.qwen/skills`; project `.qwen/skills` (`<skill>/SKILL.md`) |
+| kimi-code | — | MCP: `~/.kimi-code/mcp.json`; project `.kimi-code/mcp.json`; skills: `~/.agents/skills`; project `.agents/skills` (`<skill>/SKILL.md`) |
+| crush | — | MCP: `~/.config/crush/crushrc`; project `.crushrc`; skills: `~/.agents/skills`; project `.agents/skills` (`<skill>/SKILL.md`) |
+| amp | — | MCP: `~/.config/amp/settings.json`; Windows `%APPDATA%/amp/settings.json`; skills: `~/.agents/skills`; project `.agents/skills` (`<skill>/SKILL.md`) |
+| factory | `.factory-plugin/plugin.json` | MCP: `~/.factory/mcp.json`; project `.factory/mcp.json`; skills: `~/.agents/skills`; project `.agents/skills` (`<skill>/SKILL.md`) |
+| junie | — | MCP: `~/.junie/mcp/mcp.json`; project `.junie/mcp/mcp.json`; no skills folder (MCP only) |
+| warp | — | MCP: `~/.warp/.mcp.json`; project `.warp/.mcp.json`; skills: `~/.agents/skills`; project `.agents/skills` (`<skill>/SKILL.md`) |
+| rovo-dev | — | MCP: `~/.rovodev/mcp.json`; skills: `~/.agents/skills`; project `.agents/skills` (`<skill>/SKILL.md`) |
+| qoder | — | MCP: `~/.qoder/settings.json`; project `.mcp.json`; skills: `~/.qoder/skills`; project `.qoder/skills` (`<skill>/SKILL.md`) |
+| grok-build | — | MCP: `~/.grok/config.toml`; project `.grok/config.toml`; skills: `~/.agents/skills`; project `.agents/skills` (`<skill>/SKILL.md`) |
+| mistral-vibe | — | MCP: `~/.vibe/config.toml`; project `.vibe/config.toml`; skills: `~/.vibe/skills`; project `.agents/skills` (`<skill>/SKILL.md`) |
+| lm-studio | — | MCP: `~/.lmstudio/mcp.json`; no skills folder (MCP only) |
 
-Source of truth for the setup paths: `src/installer/agent-config.ts` and
-`src/cli/commands/skills.ts`.
+Source of truth for the setup paths: `src/installer/agent-table.ts`.
 
 Not supported on purpose (checked 2026-09-11): OpenHands CLI (its `[mcp] stdio_servers`
 inline-table array has a known upstream write bug), Xcode's agent folders (Apple

package/integrations/claude/README.md

@@ -11,9 +11,6 @@ Generated by `scripts/generate-registry` from `library/**/resource.yaml`:
 The MCP pointer `./.mcp.json` these manifests reference is generated as
 well (`registry/generated/mcp.json -> .mcp.json`, owned by the claude target).
 
-The MCP pointer `./.mcp.json` these manifests reference is generated as
-well (`registry/generated/mcp.json -> .mcp.json`).
-
 Never edit the destination files by hand — edit `library/` resources or the
 manifest builders in `scripts/generate-registry/manifests.ts`, then run
 `npm run generate:registry`. CI `--check` fails on any drift.

package/integrations/codex/README.md

@@ -4,8 +4,7 @@ Generated by `scripts/generate-registry` from `library/**/resource.yaml`:
 
 - `registry/generated/plugin.codex.json` -> `.codex-plugin/plugin.json`
   (plugin manifest with the Codex app-store `interface` block; full skill
-  list at `./library/skills/<slug>/` — the pre-v3 four-skill gap was a bug and
-  is fixed by generation; version stamped from `package.json`).
+  list at `./library/skills/<slug>/`; version stamped from `package.json`).
 
 The MCP pointer `./.mcp.json` these manifests reference is generated as
 well (`registry/generated/mcp.json -> .mcp.json`, owned by the claude target).

package/integrations/copilot-jetbrains/README.md

@@ -5,7 +5,7 @@ is intentionally empty. Support is delivered at install time by
 `summer setup copilot-jetbrains` (aliases: `jetbrains-copilot`, `intellij-copilot`, `copilot-intellij`), which writes:
 
 - MCP config: `~/.config/github-copilot/intellij/mcp.json`; Windows `%APPDATA%/github-copilot/intellij/mcp.json` (user); user scope only (project requests fall back with a warning).
-  Shape: undefined.
+  Shape: `servers.summer-engine = { command, args }`.
 - Skills: none. Copilot in JetBrains documents no skills folder; the MCP server ships summer_get_agent_playbook for in-chat guidance.
 - After: Restart the JetBrains IDE and open Copilot Chat in Agent mode; summer-engine shows in the tools list.
 

package/integrations/cursor/README.md

@@ -5,8 +5,7 @@ Generated by `scripts/generate-registry` from `library/**/resource.yaml`:
 - `registry/generated/plugin.cursor.json` -> `.cursor-plugin/plugin.json`
   (Cursor plugin manifest: displayName/publisher/category, cursor-specific
   hooks file `./hooks/hooks-cursor.json`, full skill list at
-  `./library/skills/<slug>/` — the pre-v3 four-skill gap was a bug and is fixed
-  by generation; version stamped from `package.json`).
+  `./library/skills/<slug>/`; version stamped from `package.json`).
 
 The MCP pointer `./.mcp.json` these manifests reference is generated as
 well (`registry/generated/mcp.json -> .mcp.json`, owned by the claude target).

package/integrations/factory/README.md

@@ -1,25 +1,29 @@
-# Factory (Droid) integration
+# Factory Droid integration
+
+`summer setup factory` (aliases: `droid`, `factory-droid`) writes:
+
+- MCP config: `~/.factory/mcp.json`; Windows `%USERPROFILE%/.factory/mcp.json` (user); `.factory/mcp.json` (project).
+  Shape: `mcpServers.summer-engine = { type: "stdio", command, args }`.
+- Skills: `~/.agents/skills` (user) or `.agents/skills` (project) as `<skill>/SKILL.md`.
+- After: Restart droid or run /mcp in the active session.
 
 Generated by `scripts/generate-registry` from `library/**/resource.yaml`:
 
 - `registry/generated/plugin.factory.json` -> `.factory-plugin/plugin.json`
-  (metadata manifest, now including the full skill list at
-  `./library/skills/<slug>/` — the pre-v3 manifest listed zero skills, which
-  was a bug fixed by generation; version stamped from `package.json`).
+  (metadata manifest with the full skill list at
+  `./library/skills/<slug>/`; version stamped from `package.json`).
 
-There is no `summer setup factory` target (`summer setup` rejects `factory`).
-Install through the plugin marketplace instead:
+The plugin marketplace is an alternative install:
 
 ```
 droid plugin marketplace add https://github.com/summerengine/summer
 droid plugin install summer@summer-engine --scope user
 ```
 
-Factory reads MCP servers from the plugin's root `.mcp.json` (generated) and
-skills ONLY from a root `skills/<name>/SKILL.md` directory; it has no `skills`
-manifest field, so the array in `plugin.factory.json` is inert and this package
-(skills under `library/skills/`) currently exposes no skills to Factory. Open
-gap; fix is a root `skills/` layout, not a setup target.
+A plugin install reads MCP servers from the root `.mcp.json` (generated) and
+skills only from a root `skills/<name>/SKILL.md` directory. Factory has no
+`skills` manifest field, so the array in `plugin.factory.json` is inert and the
+plugin install exposes no skills. Use `summer setup factory` to get the skills.
 
 Never edit the destination file by hand — edit `library/` resources or
 `scripts/generate-registry/manifests.ts`, then run

package/integrations/mistral-vibe/README.md

@@ -5,7 +5,7 @@ is intentionally empty. Support is delivered at install time by
 `summer setup mistral-vibe` (aliases: `vibe`, `mistral`), which writes:
 
 - MCP config: `~/.vibe/config.toml`; Windows `%USERPROFILE%/.vibe/config.toml` (user); `.vibe/config.toml` (project).
-  Shape: undefined.
+  Shape: a `[[mcp_servers]]` entry with `name`, `transport`, `command`, `args` (TOML).
 - Skills: `~/.vibe/skills` (user) or `.agents/skills` (project) as `<skill>/SKILL.md`.
 - After: Restart Vibe so it reloads config.toml.
 

package/integrations/opencode/README.md

@@ -6,7 +6,7 @@ is intentionally empty. Support is delivered at install time by
 
 - MCP config: `~/.config/opencode/opencode.json`; Windows `%APPDATA%/opencode/opencode.json` (user); `opencode.json` (project).
   Shape: `mcp.summer-engine = { type: "local", command: [npx, ...], enabled: true }`.
-- Skills: `~/.agents/skills` (user) or `.agents/skills` (project) as `<skill>/SKILL.md`. OpenCode loads skills from this folder on the next session. Summer 3.0 wrote markdown under agents/summer and 3.1.0 wrote opencode/skills; `--force` removes both.
+- Skills: `~/.agents/skills` (user) or `.agents/skills` (project) as `<skill>/SKILL.md`. OpenCode loads skills from this folder on the next session. `--force` also removes skill copies that older Summer versions wrote under `opencode/agents/summer` and `opencode/skills`.
 - After: Restart OpenCode so it reloads opencode.json.
 
 Source of truth: `src/installer/agent-table.ts` (one row per agent).

package/integrations/roo-code/README.md

@@ -1,6 +1,6 @@
 # Roo Code integration
 
-> **Legacy.** Roo Code shut down on 2026-05-15. The extension may still run, but it is no longer maintained; consider Cline or Kilo Code.
+> **Legacy.** Roo Code is no longer maintained. The target still works; consider Cline or Kilo Code.
 
 No manifest file is generated in this repo for Roo Code — `manifest-target.json`
 is intentionally empty. Support is delivered at install time by

package/integrations/rovo-dev/README.md

@@ -5,7 +5,7 @@ is intentionally empty. Support is delivered at install time by
 `summer setup rovo-dev` (aliases: `rovodev`, `rovo`, `atlassian-rovo-dev`), which writes:
 
 - MCP config: `~/.rovodev/mcp.json`; Windows `%USERPROFILE%/.rovodev/mcp.json` (user); user scope only (project requests fall back with a warning).
-  Shape: undefined.
+  Shape: `mcpServers.summer-engine = { command, args, transport: "stdio" }`.
 - Skills: `~/.agents/skills` (user) or `.agents/skills` (project) as `<skill>/SKILL.md`.
 - After: Restart Rovo Dev CLI so it reconnects its MCP servers.
 

package/integrations/trae/README.md

@@ -4,7 +4,7 @@ No manifest file is generated in this repo for Trae — `manifest-target.json`
 is intentionally empty. Support is delivered at install time by
 `summer setup trae` (aliases: `trae-ide`, `bytedance-trae`), which writes:
 
-- MCP config: `.trae/mcp.json` (user); `.trae/mcp.json` (project).
+- MCP config: `.trae/mcp.json` (project only; Trae manages user-level servers in its UI, so a user-scope request writes the project file with a warning).
   Shape: `mcpServers.summer-engine = { command, args }`.
 - Skills: none. Trae documents no skills folder; the MCP server ships summer_get_agent_playbook for in-chat guidance.
 - After: Restart Trae and open the MCP settings; summer-engine should show as connected.

package/integrations/windsurf/README.md

@@ -1,12 +1,12 @@
-# Devin Desktop (formerly Windsurf) integration
+# Devin Desktop integration
 
-No manifest file is generated in this repo for Devin Desktop (formerly Windsurf) — `manifest-target.json`
+No manifest file is generated in this repo for Devin Desktop — `manifest-target.json`
 is intentionally empty. Support is delivered at install time by
 `summer setup windsurf` (aliases: `devin`, `devin-desktop`, `devindesktop`), which writes:
 
 - MCP config: `~/.codeium/windsurf/mcp_config.json`; Windows `%USERPROFILE%/.codeium/windsurf/mcp_config.json` (user); user scope only (project requests fall back with a warning).
   Shape: `mcpServers.summer-engine = { command, args }`.
 - Skills: `~/.agents/skills` (user) or `.agents/skills` (project) as `<skill>/SKILL.md`.
-- After: Restart Devin Desktop (formerly Windsurf) and refresh MCP servers from the agent settings. Devin's docs say mcp_config.json configures the Cascade agent; for the Devin agent add the server in the app's MCP settings with the same command.
+- After: Restart Devin Desktop and refresh MCP servers from the agent settings. Devin's docs say mcp_config.json configures the Cascade agent; for the Devin agent add the server in the app's MCP settings with the same command.
 
 Source of truth: `src/installer/agent-table.ts` (one row per agent).

package/library/references/collaborative-protocol/collaborative-protocol.md

@@ -1,6 +1,6 @@
 # Collaborative Protocol — "May I write?"
 
-> Every Summer skill must follow this. The agent works *with* the user, not around them.
+> Every Summer skill follows this rule.
 
 ## The rule
 
@@ -13,7 +13,7 @@ This applies to:
 - Setting up project-wide settings (`project.godot`)
 - Installing tools, libraries, or templates
 
-Reading is unconditional. Inspection, scene-tree walks, diagnostics — never need permission.
+Reading needs no permission: inspection, scene-tree walks and diagnostics run without asking.
 
 ## Phrasing
 
@@ -42,9 +42,9 @@ Plain, short, action-first. Examples:
 
 ## Linter check
 
-The `workflow/skill-test/SKILL.md` static linter looks for the phrases:
-- "May I" / "May I write" / "May I create" / "May I attach"
+The `skill-test` skill's static check looks for one of these phrases:
+- "May I"
 - "I'm about to"
 - "Continue?" / "OK?" / "Proceed?"
 
-A skill that mutates files but never says any of these fails the linter.
+A skill that triggers user-visible writes but never says any of these fails the check. Read-only skills are exempt.

package/library/references/gd-style/gd-style.md

@@ -1,6 +1,6 @@
 # GDScript Style — Summer Conventions
 
-> The bar for GDScript in Summer. Skills should produce code that matches this. Where Godot's official style guide is silent, this is the tiebreaker.
+> Skills produce GDScript that matches this. Where the upstream GDScript style guide is silent, this file decides.
 
 ## File structure
 
@@ -43,7 +43,7 @@ func _physics_process(delta: float) -> void:
 func _input(event: InputEvent) -> void:
     pass
 
-# 7. Public API (PascalCase or snake_case methods, snake_case for funcs)
+# 7. Public API (snake_case)
 func take_damage(amount: int) -> void:
     pass
 
@@ -115,7 +115,5 @@ tween.tween_property(self, "modulate", Color.WHITE, 0.3)
 
 ## See also
 
-- [Official Godot GDScript style guide](https://docs.godotengine.org/en/stable/tutorials/scripting/gdscript/gdscript_styleguide.html)
-- `scripting-patterns/gdscript-patterns/SKILL.md` — patterns and idioms
-- `scripting-patterns/signal-patterns/SKILL.md` — signal usage
-- `scripting-patterns/state-machine-patterns/SKILL.md` — state machine patterns
+- [Upstream GDScript style guide](https://docs.godotengine.org/en/stable/tutorials/scripting/gdscript/gdscript_styleguide.html)
+- The `gdscript-patterns` skill: patterns and idioms, including signals

package/library/references/godot-version/godot-version.md

@@ -18,8 +18,8 @@ running engine also reports its measured technical version:
 <engineBinaryPath> --version      # e.g. 4.6.1.stable.mono.custom_build.<hash>
 ```
 
-Get `engineBinaryPath` from `summer_get_project_context`. Prefer live
-inspection to a copied version string. Creator onboarding and headlines should
+Get `engineBinaryPath` from `summer_get_project_context`. Prefer the live
+version to a copied version string. Creator onboarding and headlines should
 say Summer Engine, Summer game, Summer SDK, and GDScript. Use the upstream name
 only where technical compatibility, migration, extension APIs, contribution
 routing, attribution, or licensing requires it.
@@ -40,7 +40,7 @@ routing, attribution, or licensing requires it.
 ## Summer-specific deltas from the upstream engine
 
 - Local API server runs on `localhost:6550` by default (the port increments when several editors are open; each live editor publishes its port in `~/.summer/instances/<id>.json`, and the shared token lives in `~/.summer/api-token`).
-- Engine ships a webview module in `modules/1summer_engine/`. Do not assume the
+- The editor carries Summer's own modules (including a webview). Do not assume the
   unmodified upstream editor for UI patches.
 - Project root contains `.summer/` for project memory; do not delete it.
 

package/library/references/headless-routing/headless-routing.md

@@ -15,12 +15,12 @@ Only file, import, scene-read, and game run/stop/logs/screenshot operations work
 ## Ships dark
 
 - Enabled by `SUMMER_HEADLESS_ROUTING=1`. Unset, the module is not loaded at all and nothing changes.
-- Requires an engine build that ships the worker mode and process registry (Summer 4.7.x line). On older builds, leave the flag off.
+- Requires an engine build that ships the worker mode and process registry. On builds without it, leave the flag off.
 - With the flag on and an editor open, the editor path is used unchanged — caching, credential-drift reconnects, and identity binding all behave as before.
 
 ## What an agent should expect
 
-- Errors from this layer are prefixed `[headless:<stage>]` where stage is one of `connect`, `auth`, `op`, `spawn`, so you can tell "could not reach the worker" from "the worker went quiet mid-import".
+- Errors from this layer are prefixed `[headless:<stage>]` where stage is one of `connect`, `auth`, `op`, `spawn`, so "could not reach the worker" and "the worker went quiet mid-import" read differently.
 - A first call with no editor and no worker can take up to two minutes while the worker starts and imports the project. Later calls are fast.
 - **No blind retries.** If a mutating operation (write, import, run, stop) times out or the worker connection drops, the outcome is reported as UNKNOWN and the connection is quarantined. Inspect the target (read the file, check the scene) before retrying. There is deliberately no automatic reconnect or replay.
 - Worker error strings start with a snake_case classifier (`sha256_mismatch`, `already_exists`, `needs_display`). `needs_display` on a screenshot means the machine has no display; open the project in the editor for screenshots.

package/library/references/mcp-fresh-chat-playbook/mcp-fresh-chat-playbook.md

@@ -4,10 +4,10 @@ The minimum safe workflow for AI agents building in a Summer Engine project.
 
 ## Build flow (default)
 
-1. **Understand** the request, then outline a brief plan. Proceed once it's clearly right.
+1. **Understand** the request and outline a short plan.
 2. **Call `summer_get_project_context` first** so you don't guess scene paths or the project language and so the MCP session binds to the open project. Use `projectMemory` to decide which `.summer` files to read.
 3. **Edit through identity-bound Summer tools.** Use `summer_read_file`, `summer_replace_text`, and guarded `summer_write_file` for `.gd`, `.tscn`, `.tres`, `.cs`, `.json`, docs, and config. Write GDScript by default; use C# only if the project already uses it.
-4. **Play and iterate.** After writing code, **play the scene you just made** and read `summer_get_diagnostics`; fix and repeat until it launches clean — don't wait for the user to navigate to the feature before the first error shows.
+4. **Play and iterate.** After writing code, **play the scene you just made** and read `summer_get_diagnostics`; fix and repeat until it launches clean. Do not wait for the user to find the first error.
 
 ## When to use Summer MCP (the live engine)