summer-engine 2.8.2 → 3.1.0

package/hooks/pre-commit-doctor.sh

@@ -1,49 +1,55 @@
 #!/usr/bin/env bash
 # Summer Engine — Pre-commit doctor hook (OPT-IN)
 #
-# Event:    PreToolUse (matcher: Bash, if: "Bash(git commit*)")
-# Purpose:  Run `summer doctor` before any git commit Claude is about to make.
-#           Block the commit on FAIL. Allow with warnings on WARN.
+# Event:    PreToolUse (matcher: "Bash", if: "Bash(git commit*)") — registered
+#           in hooks/hooks.json (Claude Code) and hooks/hooks-cursor.json.
+# Purpose:  Run `summer doctor` before any git commit the agent is about to
+#           make. Block the commit on fail. Allow with warnings on warning.
 #
-# Status:   OPT-IN. Not registered in the Summer plugin manifest by default.
-#
-# To enable, add to ~/.claude/settings.json (or .claude/settings.json):
-#
-#   {
-#     "hooks": {
-#       "PreToolUse": [
-#         {
-#           "matcher": "Bash",
-#           "hooks": [
-#             {
-#               "type": "command",
-#               "command": "${CLAUDE_PLUGIN_ROOT}/hooks/pre-commit-doctor.sh",
-#               "if": "Bash(git commit*)",
-#               "timeout": 15
-#             }
-#           ]
-#         }
-#       ]
-#     }
-#   }
-#
-# Then: chmod +x ${CLAUDE_PLUGIN_ROOT}/hooks/pre-commit-doctor.sh
+# Status:   OPT-IN. The hook is always registered but exits 0 immediately
+#           unless one of these is set:
+#             CLAUDE_PLUGIN_OPTION_ENABLE_PRE_COMMIT_DOCTOR=true
+#               Claude Code exports every plugin userConfig value to hook
+#               processes as CLAUDE_PLUGIN_OPTION_<KEY>; this is the
+#               `enable_pre_commit_doctor` toggle from plugin.json.
+#             SUMMER_PRE_COMMIT_DOCTOR=1
+#               Manual / other-host opt-in (also the envVar Gemini's
+#               gemini-extension.json `settings` entry maps to).
 #
 # Input:    JSON on stdin: { tool_name, tool_input: { command, ... }, ... }
-# Output:   On FAIL: stderr explanation, exit 2 (blocks commit).
-#           On WARN: stderr warnings, exit 0 (allows commit).
-#           On PASS or no `summer` CLI: silent, exit 0.
+# Output:   On fail: stderr explanation, exit 2 (blocks commit).
+#           On warning: stderr warnings, exit 0 (allows commit).
+#           On ok, opt-in unset, or no `summer` CLI on PATH: silent, exit 0.
+#           (No npx fallback: a cold `npx summer-engine` download would blow
+#           the 30s hook budget mid-commit. Install the CLI to use this hook.)
+#
+# Doctor JSON shape (src/core/capabilities/doctor.ts):
+#   { ok, checks: [{ id, label, status: "ok"|"warning"|"fail", message }], summary }
 #
 # Portability: bash 3.2+, POSIX-friendly. jq optional.
 
 set +e
 
+# ---------- Opt-in gate ----------
+is_truthy() {
+    case "$(printf '%s' "$1" | tr '[:upper:]' '[:lower:]')" in
+        1|true|yes|on) return 0 ;;
+        *) return 1 ;;
+    esac
+}
+if ! is_truthy "${CLAUDE_PLUGIN_OPTION_ENABLE_PRE_COMMIT_DOCTOR:-}" \
+   && ! is_truthy "${SUMMER_PRE_COMMIT_DOCTOR:-}"; then
+    cat >/dev/null
+    exit 0
+fi
+
 INPUT=$(cat)
 
 # ---------- Parse the command ----------
 COMMAND=""
 if command -v jq >/dev/null 2>&1; then
-    COMMAND=$(printf '%s' "$INPUT" | jq -r '.tool_input.command // empty' 2>/dev/null)
+    # Claude Code PreToolUse: .tool_input.command; Cursor beforeShellExecution: .command
+    COMMAND=$(printf '%s' "$INPUT" | jq -r '.tool_input.command // .command // empty' 2>/dev/null)
 fi
 if [ -z "$COMMAND" ]; then
     COMMAND=$(printf '%s' "$INPUT" \
@@ -77,23 +83,23 @@ WARN_MSGS=""
 
 if command -v jq >/dev/null 2>&1; then
     FAIL_MSGS=$(printf '%s' "$DOCTOR_OUT" \
-        | jq -r '.checks[]? | select(.status == "FAIL") | "  - " + (.name // "?") + ": " + (.message // "")' 2>/dev/null)
+        | jq -r '.checks[]? | select((.status // "" | ascii_downcase) == "fail") | "  - " + (.label // .name // "?") + ": " + (.message // "")' 2>/dev/null)
     WARN_MSGS=$(printf '%s' "$DOCTOR_OUT" \
-        | jq -r '.checks[]? | select(.status == "WARN") | "  - " + (.name // "?") + ": " + (.message // "")' 2>/dev/null)
+        | jq -r '.checks[]? | select((.status // "" | ascii_downcase) | IN("warning", "warn")) | "  - " + (.label // .name // "?") + ": " + (.message // "")' 2>/dev/null)
     [ -n "$FAIL_MSGS" ] && HAS_FAIL=1
     [ -n "$WARN_MSGS" ] && HAS_WARN=1
 else
     # Fallback: substring sniffing
-    if printf '%s' "$DOCTOR_OUT" | grep -q '"status"[[:space:]]*:[[:space:]]*"FAIL"'; then
+    if printf '%s' "$DOCTOR_OUT" | grep -q '"status"[[:space:]]*:[[:space:]]*"(FAIL|fail)"'; then
         HAS_FAIL=1
         FAIL_MSGS=$(printf '%s' "$DOCTOR_OUT" \
-            | grep -oE '"status"[[:space:]]*:[[:space:]]*"FAIL"[^}]*"message"[[:space:]]*:[[:space:]]*"[^"]*"' \
+            | grep -oE '"status"[[:space:]]*:[[:space:]]*"(FAIL|fail)"[^}]*"message"[[:space:]]*:[[:space:]]*"[^"]*"' \
             | sed -E 's/.*"message"[[:space:]]*:[[:space:]]*"([^"]*)"/  - \1/')
     fi
-    if printf '%s' "$DOCTOR_OUT" | grep -q '"status"[[:space:]]*:[[:space:]]*"WARN"'; then
+    if printf '%s' "$DOCTOR_OUT" | grep -q '"status"[[:space:]]*:[[:space:]]*"(WARN|warn|warning)"'; then
         HAS_WARN=1
         WARN_MSGS=$(printf '%s' "$DOCTOR_OUT" \
-            | grep -oE '"status"[[:space:]]*:[[:space:]]*"WARN"[^}]*"message"[[:space:]]*:[[:space:]]*"[^"]*"' \
+            | grep -oE '"status"[[:space:]]*:[[:space:]]*"(WARN|warn|warning)"[^}]*"message"[[:space:]]*:[[:space:]]*"[^"]*"' \
             | sed -E 's/.*"message"[[:space:]]*:[[:space:]]*"([^"]*)"/  - \1/')
     fi
 fi
@@ -101,11 +107,11 @@ fi
 # ---------- FAIL: block ----------
 if [ "$HAS_FAIL" -eq 1 ]; then
     {
-        echo "=== Summer doctor: FAIL — commit blocked ==="
+        echo "=== Summer doctor: fail — commit blocked ==="
         echo "$FAIL_MSGS"
         echo ""
         echo "Fix the failures above, or run: summer doctor"
-        echo "To bypass once: disable the pre-commit-doctor hook in settings.json."
+        echo "To bypass: turn off the plugin option enable_pre_commit_doctor (or unset SUMMER_PRE_COMMIT_DOCTOR)."
         echo "============================================"
     } >&2
     exit 2
@@ -114,7 +120,7 @@ fi
 # ---------- WARN: allow with notice ----------
 if [ "$HAS_WARN" -eq 1 ]; then
     {
-        echo "=== Summer doctor: WARN — commit allowed ==="
+        echo "=== Summer doctor: warning — commit allowed ==="
         echo "$WARN_MSGS"
         echo "============================================"
     } >&2

package/hooks/run-hook.cmd

@@ -1,23 +1,30 @@
-#!/usr/bin/env bash
-# Cross-platform hook dispatcher.
-# Usage: run-hook.cmd <hook-name>
-# Reads stdin, forwards to <plugin-root>/hooks/<hook-name>.sh
-# On Windows, Claude Code / Cursor / Codex invoke this via Git-Bash.
-
-HOOK_NAME="$1"
-shift || true
-
-HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-HOOK_SCRIPT="$HOOK_DIR/$HOOK_NAME.sh"
-
-if [ ! -f "$HOOK_SCRIPT" ]; then
-  # Missing hook = no-op (don't break the host).
-  exit 0
-fi
-
-if [ ! -x "$HOOK_SCRIPT" ]; then
-  # Not executable yet (likely fresh checkout). Fall back to bash invocation.
-  exec bash "$HOOK_SCRIPT" "$@"
-fi
-
-exec "$HOOK_SCRIPT" "$@"
+:; exec bash "$(dirname "$0")/run-hook.sh" "$@"
+@echo off
+rem Summer Engine hook dispatcher — bash / cmd.exe polyglot.
+rem
+rem   bash (macOS, Linux, Git Bash): line 1 is a no-op ":" followed by an exec
+rem   into run-hook.sh; nothing below it is ever parsed. No shebang on purpose:
+rem   bash falls back to running a shebang-less file as a script, and cmd.exe
+rem   would otherwise print an error for the "#!" line.
+rem   cmd.exe / PowerShell (Windows without a bash hook shell): line 1 is a
+rem   label and is skipped; the batch below locates Git Bash and forwards, or
+rem   exits 0 so a missing bash never blocks the host.
+rem
+rem Usage: run-hook.cmd <hook-name>   (stdin is forwarded untouched)
+setlocal
+set "HOOK_DIR=%~dp0"
+where bash >nul 2>nul
+if %errorlevel%==0 (
+  bash "%HOOK_DIR%run-hook.sh" %*
+  exit /b %errorlevel%
+)
+if exist "%ProgramFiles%\Git\bin\bash.exe" (
+  "%ProgramFiles%\Git\bin\bash.exe" "%HOOK_DIR%run-hook.sh" %*
+  exit /b %errorlevel%
+)
+if exist "%LocalAppData%\Programs\Git\bin\bash.exe" (
+  "%LocalAppData%\Programs\Git\bin\bash.exe" "%HOOK_DIR%run-hook.sh" %*
+  exit /b %errorlevel%
+)
+echo Summer hooks need Git Bash on Windows; skipping hook. 1>&2
+exit /b 0

package/hooks/run-hook.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+# Cross-platform hook dispatcher (bash side).
+# Usage: run-hook.sh <hook-name>
+# Reads stdin, forwards to <plugin-root>/hooks/<hook-name>.sh
+# Hosts reference run-hook.cmd, a bash/cmd.exe polyglot that lands here on
+# every platform that has bash (macOS, Linux, Git Bash / WSL on Windows).
+
+HOOK_NAME="$1"
+shift || true
+
+HOOK_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+HOOK_SCRIPT="$HOOK_DIR/$HOOK_NAME.sh"
+
+if [ ! -f "$HOOK_SCRIPT" ]; then
+  # Missing hook = no-op (don't break the host).
+  exit 0
+fi
+
+# Always go through bash: fresh checkouts / npm tarballs may drop the exec bit.
+exec bash "$HOOK_SCRIPT" "$@"

package/hooks/session-start.sh

@@ -25,10 +25,17 @@ PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
 LINES=()
 
 # Line 1: Summer ready + skill count
+# The count is the number of Summer skills actually loaded by THIS host — the
+# plugin's bundled library when running as a plugin. Outside a plugin root we
+# cannot tell Summer skills from the user's own, so the number is dropped
+# rather than reporting the whole library as if it were installed.
 SKILL_COUNT=""
-if command -v summer >/dev/null 2>&1; then
-    # `summer skills count` is best-effort; ignore failure
-    SKILL_COUNT=$(summer skills count 2>/dev/null | grep -oE '[0-9]+' | head -1)
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-${CURSOR_PLUGIN_ROOT:-}}"
+if [ -n "$PLUGIN_ROOT" ] && [ -d "${PLUGIN_ROOT}/library/skills" ]; then
+    SKILL_COUNT=$(find "${PLUGIN_ROOT}/library/skills" -mindepth 2 -maxdepth 2 -name SKILL.md 2>/dev/null | grep -c .)
+    case "$SKILL_COUNT" in
+        ''|0|*[!0-9]*) SKILL_COUNT="" ;;
+    esac
 fi
 if [ -n "$SKILL_COUNT" ]; then
     LINES+=("Summer ready. ${SKILL_COUNT} skills.")
@@ -57,18 +64,22 @@ if [ -f "${PROJECT_DIR}/project.godot" ]; then
     fi
 fi
 
-# Line 3: doctor FAIL one-liner (only on FAIL — silent on PASS/WARN)
+# Line 3: doctor fail one-liner (only on status "fail" — silent on ok/warning).
+# Doctor JSON (src/core/capabilities/doctor.ts): checks[].status is lowercase
+# "ok" | "warning" | "fail". Only runs when a `summer` CLI is on PATH: the
+# documented npx install never puts one there, and a cold `npx summer-engine`
+# fetch would exceed the 10s SessionStart budget, so we degrade silently.
 if command -v summer >/dev/null 2>&1; then
     DOCTOR_OUT=$(summer doctor --json 2>/dev/null)
     if [ -n "$DOCTOR_OUT" ]; then
         FAIL_REASON=""
         if command -v jq >/dev/null 2>&1; then
             FAIL_REASON=$(printf '%s' "$DOCTOR_OUT" \
-                | jq -r 'first(.checks[]? | select(.status == "FAIL") | .message) // empty' 2>/dev/null)
+                | jq -r 'first(.checks[]? | select((.status // "" | ascii_downcase) == "fail") | .message) // empty' 2>/dev/null)
         else
-            # Crude fallback: first "message" near a "FAIL"
+            # Crude fallback: first "message" near a "fail"
             FAIL_REASON=$(printf '%s' "$DOCTOR_OUT" \
-                | grep -oE '"status"[[:space:]]*:[[:space:]]*"FAIL"[^}]*"message"[[:space:]]*:[[:space:]]*"[^"]*"' \
+                | grep -oE '"status"[[:space:]]*:[[:space:]]*"(FAIL|fail)"[^}]*"message"[[:space:]]*:[[:space:]]*"[^"]*"' \
                 | head -1 \
                 | grep -oE '"message"[[:space:]]*:[[:space:]]*"[^"]*"' \
                 | sed 's/.*"message"[[:space:]]*:[[:space:]]*"//;s/"$//')

package/integrations/README.md

@@ -0,0 +1,99 @@
+# integrations/ — the complete, honest map of agent support
+
+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.
+
+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.
+
+`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.
+
+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.
+
+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).
+
+| 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-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) |
+| 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) |
+
+Source of truth for the setup paths: `src/installer/agent-config.ts` and
+`src/cli/commands/skills.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
+documents the folder but not the file names), Pi (no MCP by design), Aider,
+ChatGPT desktop, Replit, Perplexity, JetBrains AI Assistant and Android Studio
+(UI-only MCP), Continue.dev (shut down), Void (archived), Cody (enterprise only).
+Grok Build also reads `~/.claude.json` and `.cursor/mcp.json`, so a Claude Code or
+Cursor setup already covers it; `summer setup grok-build` writes its own file too.

package/integrations/amp/README.md

@@ -0,0 +1,12 @@
+# Amp integration
+
+No manifest file is generated in this repo for Amp — `manifest-target.json`
+is intentionally empty. Support is delivered at install time by
+`summer setup amp` (aliases: `sourcegraph-amp`, `ampcode`), which writes:
+
+- MCP config: `~/.config/amp/settings.json`; Windows `%APPDATA%/amp/settings.json` (user); user scope only (project requests fall back with a warning).
+  Shape: `"amp.mcpServers".summer-engine = { command, args }`.
+- Skills: `~/.config/amp/skills` (user) or `.agents/skills` (project) as `<skill>/SKILL.md`.
+- After: Restart Amp so it reloads settings.json.
+
+Source of truth: `src/installer/agent-table.ts` (one row per agent).

package/integrations/amp/manifest-target.json

@@ -0,0 +1,3 @@
+{
+  "targets": []
+}

package/integrations/antigravity/README.md

@@ -0,0 +1,12 @@
+# Antigravity integration
+
+No manifest file is generated in this repo for Antigravity — `manifest-target.json`
+is intentionally empty. Support is delivered at install time by
+`summer setup antigravity` (aliases: `agy`, `google-antigravity`), which writes:
+
+- MCP config: `~/.gemini/config/mcp_config.json`; Windows `%USERPROFILE%/.gemini/config/mcp_config.json` (user); `.agents/mcp_config.json` (project).
+  Shape: `mcpServers.summer-engine = { command, args }`.
+- Skills: `~/.gemini/config/skills` (user) or `.agents/skills` (project) as `<skill>/SKILL.md`.
+- After: In Antigravity open the agent panel's MCP servers view and refresh; summer-engine appears in the list (IDE and CLI share this file).
+
+Source of truth: `src/installer/agent-table.ts` (one row per agent).

package/integrations/antigravity/manifest-target.json

@@ -0,0 +1,3 @@
+{
+  "targets": []
+}

package/integrations/claude/README.md

@@ -0,0 +1,19 @@
+# Claude Code integration
+
+Generated by `scripts/generate-registry` from `library/**/resource.yaml`:
+
+- `registry/generated/plugin.claude.json` -> `.claude-plugin/plugin.json`
+  (plugin manifest: full skill list at `./library/skills/<slug>/`, hooks,
+  MCP pointer, userConfig; version stamped from `package.json`).
+- `registry/generated/marketplace.claude.json` -> `.claude-plugin/marketplace.json`
+  (marketplace listing wrapper).
+
+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/claude/manifest-target.json

@@ -0,0 +1,16 @@
+{
+  "targets": [
+    {
+      "generated": "plugin.claude.json",
+      "destination": ".claude-plugin/plugin.json"
+    },
+    {
+      "generated": "marketplace.claude.json",
+      "destination": ".claude-plugin/marketplace.json"
+    },
+    {
+      "generated": "mcp.json",
+      "destination": ".mcp.json"
+    }
+  ]
+}

package/integrations/claude-desktop/README.md

@@ -0,0 +1,12 @@
+# Claude Desktop integration
+
+No manifest file is generated in this repo for Claude Desktop — `manifest-target.json`
+is intentionally empty. Support is delivered at install time by
+`summer setup claude-desktop` (aliases: `claude-app`, `claudedesktop`), which writes:
+
+- MCP config: `~/Library/Application Support/Claude/claude_desktop_config.json`; Linux `~/.config/Claude/claude_desktop_config.json`; Windows `%APPDATA%/Claude/claude_desktop_config.json` (user); user scope only (project requests fall back with a warning).
+  Shape: `mcpServers.summer-engine = { command, args }`.
+- Skills: none. Claude Desktop has no skills folder. The MCP server ships summer_get_agent_playbook, so the model can pull Summer guidance in-chat.
+- After: Quit and reopen Claude Desktop; the summer-engine tools appear under the tools menu in a new chat.
+
+Source of truth: `src/installer/agent-table.ts` (one row per agent).

package/integrations/claude-desktop/manifest-target.json

@@ -0,0 +1,3 @@
+{
+  "targets": []
+}

package/integrations/cline/README.md

@@ -0,0 +1,12 @@
+# Cline (VS Code) integration
+
+No manifest file is generated in this repo for Cline (VS Code) — `manifest-target.json`
+is intentionally empty. Support is delivered at install time by
+`summer setup cline` (aliases: `cline-vscode`), which writes:
+
+- MCP config: `~/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` (user); user scope only (project requests fall back with a warning).
+  Shape: `mcpServers.summer-engine = { command, args }`.
+- Skills: `~/.cline/skills` (user) or `.cline/skills` (project) as `<skill>/SKILL.md`.
+- After: Restart VS Code so Cline reloads its MCP config.
+
+Source of truth: `src/installer/agent-table.ts` (one row per agent).

package/integrations/cline/manifest-target.json

@@ -0,0 +1,3 @@
+{
+  "targets": []
+}

package/integrations/cline-cli/README.md

@@ -0,0 +1,12 @@
+# Cline CLI integration
+
+No manifest file is generated in this repo for Cline CLI — `manifest-target.json`
+is intentionally empty. Support is delivered at install time by
+`summer setup cline-cli` (aliases: `clinecli`), which writes:
+
+- MCP config: `~/.cline/data/settings/cline_mcp_settings.json`; Windows `%USERPROFILE%/.cline/data/settings/cline_mcp_settings.json` (user); user scope only (project requests fall back with a warning).
+  Shape: `mcpServers.summer-engine = { command, args }`.
+- Skills: `~/.cline/skills` (user) or `.cline/skills` (project) as `<skill>/SKILL.md`.
+- After: Restart the Cline CLI so it reloads its MCP settings.
+
+Source of truth: `src/installer/agent-table.ts` (one row per agent).

package/integrations/cline-cli/manifest-target.json

@@ -0,0 +1,3 @@
+{
+  "targets": []
+}

package/integrations/codex/README.md

@@ -0,0 +1,15 @@
+# Codex integration
+
+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`).
+
+The MCP pointer `./.mcp.json` these manifests reference is generated as
+well (`registry/generated/mcp.json -> .mcp.json`, owned by the claude target).
+
+Never edit the destination file by hand — edit `library/` resources or
+`scripts/generate-registry/manifests.ts`, then run
+`npm run generate:registry`. CI `--check` fails on any drift.

package/integrations/codex/manifest-target.json

@@ -0,0 +1,5 @@
+{
+  "targets": [
+    { "generated": "plugin.codex.json", "destination": ".codex-plugin/plugin.json" }
+  ]
+}

package/integrations/copilot-jetbrains/README.md

@@ -0,0 +1,12 @@
+# GitHub Copilot in JetBrains IDEs integration
+
+No manifest file is generated in this repo for GitHub Copilot in JetBrains IDEs — `manifest-target.json`
+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.
+- 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.
+
+Source of truth: `src/installer/agent-table.ts` (one row per agent).

package/integrations/copilot-jetbrains/manifest-target.json

@@ -0,0 +1,3 @@
+{
+  "targets": []
+}

package/integrations/crush/README.md

@@ -0,0 +1,12 @@
+# Crush integration
+
+No manifest file is generated in this repo for Crush — `manifest-target.json`
+is intentionally empty. Support is delivered at install time by
+`summer setup crush` (aliases: `charm-crush`), which writes:
+
+- MCP config: `~/.config/crush/crushrc`; Windows `%USERPROFILE%/.config/crush/crushrc` (user); `.crushrc` (project).
+  Shape: `mcp.summer-engine = { type: "stdio", command, args }`.
+- Skills: `~/.config/crush/skills` (user) or `.crush/skills` (project) as `<skill>/SKILL.md`.
+- After: Restart Crush so it reloads crushrc.
+
+Source of truth: `src/installer/agent-table.ts` (one row per agent).

package/integrations/crush/manifest-target.json

@@ -0,0 +1,3 @@
+{
+  "targets": []
+}

package/integrations/cursor/README.md

@@ -0,0 +1,16 @@
+# Cursor integration
+
+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`).
+
+The MCP pointer `./.mcp.json` these manifests reference is generated as
+well (`registry/generated/mcp.json -> .mcp.json`, owned by the claude target).
+
+Never edit the destination file by hand — edit `library/` resources or
+`scripts/generate-registry/manifests.ts`, then run
+`npm run generate:registry`. CI `--check` fails on any drift.

package/integrations/cursor/manifest-target.json

@@ -0,0 +1,5 @@
+{
+  "targets": [
+    { "generated": "plugin.cursor.json", "destination": ".cursor-plugin/plugin.json" }
+  ]
+}

package/integrations/factory/README.md

@@ -0,0 +1,26 @@
+# Factory (Droid) integration
+
+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`).
+
+There is no `summer setup factory` target (`summer setup` rejects `factory`).
+Install through the plugin marketplace instead:
+
+```
+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.
+
+Never edit the destination file by hand — edit `library/` resources or
+`scripts/generate-registry/manifests.ts`, then run
+`npm run generate:registry`. CI `--check` fails on any drift.

package/integrations/factory/manifest-target.json

@@ -0,0 +1,5 @@
+{
+  "targets": [
+    { "generated": "plugin.factory.json", "destination": ".factory-plugin/plugin.json" }
+  ]
+}