summer-engine 2.0.0 → 2.3.0

package/dist/commands/skills.js

@@ -2,7 +2,7 @@ import { Command } from "commander";
 import { existsSync, mkdirSync, readFileSync, cpSync, writeFileSync, } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
-import { homedir } from "os";
+import { homedir, platform } from "os";
 import { AGENT_CLIENTS, SKILL_REGISTRY, } from "../lib/skills-registry.js";
 import { tildeify } from "../lib/format.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -102,8 +102,12 @@ function resolveAgent(opts) {
 function resolveScope(agent, opts) {
     if (opts.scope)
         return parseScope(opts.scope);
-    if (agent === "cursor" || agent === "windsurf")
+    if (agent === "cursor" ||
+        agent === "windsurf" ||
+        agent === "cline" ||
+        agent === "roo-code") {
         return "project";
+    }
     return "user";
 }
 function agentLabel(agent) {
@@ -116,6 +120,14 @@ function agentLabel(agent) {
             return "Cursor";
         case "windsurf":
             return "Windsurf";
+        case "cline":
+            return "Cline";
+        case "roo-code":
+            return "Roo Code";
+        case "gemini":
+            return "Gemini CLI";
+        case "opencode":
+            return "OpenCode";
         case "summer":
             return "Summer";
     }
@@ -128,6 +140,15 @@ function resolveInstallLocation(agent, scope) {
         if (agent === "windsurf") {
             return { kind: "windsurf-rule-file", path: join(overrideDir, ".windsurfrules") };
         }
+        if (agent === "cline" || agent === "roo-code") {
+            return { kind: "cline-rule-dir", path: overrideDir };
+        }
+        if (agent === "gemini") {
+            return { kind: "gemini-skill-dir", path: overrideDir };
+        }
+        if (agent === "opencode") {
+            return { kind: "opencode-skill-dir", path: overrideDir };
+        }
         return { kind: "skill-dir", path: overrideDir };
     }
     const root = scope === "user" ? homedir() : process.cwd();
@@ -140,10 +161,55 @@ function resolveInstallLocation(agent, scope) {
             return { kind: "cursor-rule-dir", path: join(root, ".cursor", "rules") };
         case "windsurf":
             return { kind: "windsurf-rule-file", path: join(root, ".windsurfrules") };
+        case "cline":
+            return {
+                kind: "cline-rule-dir",
+                path: scope === "user"
+                    ? clineUserRulesDir()
+                    : join(process.cwd(), ".clinerules"),
+            };
+        case "roo-code":
+            return {
+                kind: "cline-rule-dir",
+                path: scope === "user"
+                    ? rooCodeUserRulesDir()
+                    : join(process.cwd(), ".clinerules"),
+            };
+        case "gemini":
+            return {
+                kind: "gemini-skill-dir",
+                path: join(homedir(), ".gemini", "extensions", "summer-engine", "skills"),
+            };
+        case "opencode":
+            return {
+                kind: "opencode-skill-dir",
+                path: scope === "user"
+                    ? opencodeUserAgentsDir()
+                    : join(process.cwd(), ".opencode", "agents", "summer"),
+            };
         case "summer":
             return { kind: "skill-dir", path: join(root, ".summer", "skills") };
     }
 }
+function clineUserRulesDir() {
+    // Cline reads global rules from the user's Documents/Cline/Rules folder.
+    return join(homedir(), "Documents", "Cline", "Rules");
+}
+function rooCodeUserRulesDir() {
+    // Roo Code reads global rules from the user's Documents/Roo/Rules folder.
+    return join(homedir(), "Documents", "Roo", "Rules");
+}
+function opencodeUserAgentsDir() {
+    // OpenCode's user-scope agent definition directory varies by OS.
+    // On Windows, OpenCode reads from %APPDATA%/opencode/agents/summer.
+    // On Linux/macOS, it reads from $XDG_CONFIG_HOME or ~/.config/opencode/agents/summer.
+    if (platform() === "win32") {
+        const appData = process.env.APPDATA ?? join(homedir(), "AppData", "Roaming");
+        return join(appData, "opencode", "agents", "summer");
+    }
+    const xdg = process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config");
+    return join(xdg, "opencode", "agents", "summer");
+}
 function selectSkills(name, opts) {
     if (opts.all && opts.recommended) {
         die("Use only one bulk option: --all or --recommended.");
@@ -189,6 +255,12 @@ function installSkill(skill, agent, location) {
             return writeCursorRule(skill, location.path);
         case "windsurf-rule-file":
             return upsertWindsurfRule(skill, location.path);
+        case "cline-rule-dir":
+            return writeClineRule(skill, location.path);
+        case "gemini-skill-dir":
+            return writeGeminiSkill(skill, location.path);
+        case "opencode-skill-dir":
+            return writeOpencodeSkill(skill, location.path);
     }
 }
 function copySkillDirectory(skill, targetDir) {
@@ -219,6 +291,35 @@ function upsertWindsurfRule(skill, rulePath) {
     writeFileSync(rulePath, next, "utf-8");
     return { action: "Generated", path: rulePath };
 }
+function writeClineRule(skill, rulesDir) {
+    // Cline + Roo Code read project rules from .clinerules/ and global rules
+    // from Documents/Cline (or Roo)/Rules. Both expect plain markdown files.
+    // SKILL.md isn't recognized as a special filename, so we name files <skill>.md.
+    mkdirSync(rulesDir, { recursive: true });
+    const rulePath = join(rulesDir, `summer-${skill.name}.md`);
+    writeFileSync(rulePath, renderRuleBody(skill) + "\n", "utf-8");
+    return { action: "Generated", path: rulePath };
+}
+function writeGeminiSkill(skill, skillsDir) {
+    // Gemini extensions support a contextFileName, but skill discovery for
+    // arbitrary markdown is not standardized. We drop each SKILL.md alongside
+    // the extension so the agent can reference them by path; the install
+    // summary surfaces this so the user knows where to point Gemini.
+    mkdirSync(skillsDir, { recursive: true });
+    const rulePath = join(skillsDir, `${skill.name}.md`);
+    writeFileSync(rulePath, renderRuleBody(skill) + "\n", "utf-8");
+    return { action: "Generated", path: rulePath };
+}
+function writeOpencodeSkill(skill, skillsDir) {
+    // OpenCode supports agent markdown definitions; the exact discovery
+    // convention for ad-hoc skills isn't fully documented. We write each skill
+    // as a markdown file under agents/summer/ so OpenCode can reference them
+    // directly. The install summary shows the path.
+    mkdirSync(skillsDir, { recursive: true });
+    const rulePath = join(skillsDir, `${skill.name}.md`);
+    writeFileSync(rulePath, renderRuleBody(skill) + "\n", "utf-8");
+    return { action: "Generated", path: rulePath };
+}
 function renderCursorRule(skill) {
     const description = `Summer skill ${skill.name}: ${skill.description}`;
     return `---\ndescription: ${JSON.stringify(description)}\nglobs: []\nalwaysApply: false\n---\n\n${renderRuleBody(skill)}\n`;
@@ -251,6 +352,18 @@ function printInstallSummary(count, agent, scope, location) {
     else if (location.kind === "cursor-rule-dir") {
         console.log(`Cursor rules are in ${tildeified}/summer-<skill>.mdc`);
     }
+    else if (location.kind === "cline-rule-dir") {
+        console.log(`${label} rules are in ${tildeified}/summer-<skill>.md`);
+        console.log("Restart VS Code to pick up new rules.");
+    }
+    else if (location.kind === "gemini-skill-dir") {
+        console.log(`Skill files are in ${tildeified}/<skill>.md`);
+        console.log("Reference them from Gemini by path, or run `gemini extensions enable summer-engine` to load the bundled context.");
+    }
+    else if (location.kind === "opencode-skill-dir") {
+        console.log(`Skill files are in ${tildeified}/<skill>.md`);
+        console.log("Restart OpenCode so it picks up the new agent definitions.");
+    }
     else {
         console.log(`Windsurf rules are in ${tildeified}`);
     }

package/dist/lib/agent-config.d.ts

@@ -1,5 +1,5 @@
 export declare const SUMMER_MCP_SERVER_NAME = "summer-engine";
-export declare const supportedAgents: readonly ["codex", "claude-code", "cursor", "windsurf"];
+export declare const supportedAgents: readonly ["codex", "claude-code", "cursor", "windsurf", "cline", "roo-code", "gemini", "opencode"];
 export type SupportedAgent = (typeof supportedAgents)[number];
 export type ConfigScope = "user" | "project";
 export interface StdioMcpServerConfig {
@@ -22,7 +22,7 @@ export interface AgentConfigResult {
     path: string;
     serverName: string;
     server: StdioMcpServerConfig;
-    format: "json" | "toml";
+    format: "json" | "toml" | "json-opencode";
     snippet: string;
     changed: boolean;
     wrote: boolean;

package/dist/lib/agent-config.js

@@ -2,13 +2,17 @@ import { existsSync } from "fs";
 import { mkdir, readFile, writeFile } from "fs/promises";
 import { dirname, join, resolve } from "path";
 import { fileURLToPath } from "url";
-import { homedir } from "os";
+import { homedir, platform } from "os";
 export const SUMMER_MCP_SERVER_NAME = "summer-engine";
 export const supportedAgents = [
     "codex",
     "claude-code",
     "cursor",
     "windsurf",
+    "cline",
+    "roo-code",
+    "gemini",
+    "opencode",
 ];
 const agentAliases = {
     claude: "claude-code",
@@ -16,6 +20,14 @@ const agentAliases = {
     codex: "codex",
     cursor: "cursor",
     windsurf: "windsurf",
+    cline: "cline",
+    "roo-code": "roo-code",
+    roo: "roo-code",
+    roocode: "roo-code",
+    gemini: "gemini",
+    "gemini-cli": "gemini",
+    opencode: "opencode",
+    "open-code": "opencode",
 };
 export function parseAgent(value) {
     if (!value)
@@ -43,7 +55,11 @@ export async function configureAgentMcp(options) {
         ? { changed: true }
         : target.format === "toml"
             ? await upsertCodexConfig(target.path, server, shouldWrite)
-            : await upsertJsonMcpConfig(target.path, server, shouldWrite);
+            : target.format === "json-opencode"
+                ? await upsertOpencodeConfig(target.path, server, shouldWrite)
+                : options.agent === "gemini"
+                    ? await upsertGeminiExtension(target.path, server, shouldWrite)
+                    : await upsertJsonMcpConfig(target.path, server, shouldWrite);
     return {
         agent: options.agent,
         scope: options.scope,
@@ -70,13 +86,24 @@ export function createSummerMcpServerConfig(localDev) {
     }
     return {
         command: "npx",
-        args: ["summer-engine", "mcp"],
+        args: ["-y", "summer-engine@latest", "mcp"],
     };
 }
 export function renderConfigSnippet(agent, server) {
     if (agent === "codex") {
         return renderCodexServerTable(server);
     }
+    if (agent === "opencode") {
+        return (JSON.stringify({
+            $schema: "https://opencode.ai/config.json",
+            mcp: {
+                [SUMMER_MCP_SERVER_NAME]: opencodeServerEntry(server),
+            },
+        }, null, 2) + "\n");
+    }
+    if (agent === "gemini") {
+        return (JSON.stringify(geminiExtensionManifest(server), null, 2) + "\n");
+    }
     return (JSON.stringify({
         mcpServers: {
             [SUMMER_MCP_SERVER_NAME]: server,
@@ -91,9 +118,17 @@ function resolveConfigTarget(agent, scope, cwd, env) {
     const override = getConfigPathOverride(agent, env);
     const warnings = [];
     if (override) {
+        if (scope === "project" &&
+            (agent === "cline" || agent === "roo-code" || agent === "gemini")) {
+            warnings.push(`${agent} MCP config has no project scope today; treating as user scope.`);
+        }
         return {
             path: resolve(override),
-            format: agent === "codex" ? "toml" : "json",
+            format: agent === "codex"
+                ? "toml"
+                : agent === "opencode"
+                    ? "json-opencode"
+                    : "json",
             warnings,
         };
     }
@@ -124,6 +159,45 @@ function resolveConfigTarget(agent, scope, cwd, env) {
             warnings,
         };
     }
+    if (agent === "cline") {
+        if (scope === "project") {
+            warnings.push("Cline MCP config has no project scope today; writing to user-scope global VS Code storage instead.");
+        }
+        return {
+            path: vsCodeGlobalStoragePath(env, "saoudrizwan.claude-dev"),
+            format: "json",
+            warnings,
+        };
+    }
+    if (agent === "roo-code") {
+        if (scope === "project") {
+            warnings.push("Roo Code MCP config has no project scope today; writing to user-scope global VS Code storage instead.");
+        }
+        return {
+            path: vsCodeGlobalStoragePath(env, "rooveterinaryinc.roo-cline"),
+            format: "json",
+            warnings,
+        };
+    }
+    if (agent === "gemini") {
+        if (scope === "project") {
+            warnings.push("Gemini extensions are user-scoped today; writing to ~/.gemini/extensions/summer-engine/ instead of project.");
+        }
+        return {
+            path: join(homedir(), ".gemini", "extensions", "summer-engine", "gemini-extension.json"),
+            format: "json",
+            warnings,
+        };
+    }
+    if (agent === "opencode") {
+        return {
+            path: scope === "user"
+                ? opencodeUserConfigPath(env)
+                : join(cwd, "opencode.json"),
+            format: "json-opencode",
+            warnings,
+        };
+    }
     if (scope === "project") {
         warnings.push("Windsurf documents MCP configuration as user-scoped; project scope writes .windsurf/mcp_config.json for teams that load workspace config.");
     }
@@ -135,6 +209,28 @@ function resolveConfigTarget(agent, scope, cwd, env) {
         warnings,
     };
 }
+function vsCodeGlobalStoragePath(env, extensionId) {
+    const os = platform();
+    if (os === "win32") {
+        const appData = env.APPDATA ?? join(homedir(), "AppData", "Roaming");
+        return join(appData, "Code", "User", "globalStorage", extensionId, "settings", "cline_mcp_settings.json");
+    }
+    if (os === "darwin") {
+        return join(homedir(), "Library", "Application Support", "Code", "User", "globalStorage", extensionId, "settings", "cline_mcp_settings.json");
+    }
+    // Linux and other Unix
+    const xdg = env.XDG_CONFIG_HOME ?? join(homedir(), ".config");
+    return join(xdg, "Code", "User", "globalStorage", extensionId, "settings", "cline_mcp_settings.json");
+}
+function opencodeUserConfigPath(env) {
+    const os = platform();
+    if (os === "win32") {
+        const appData = env.APPDATA ?? join(homedir(), "AppData", "Roaming");
+        return join(appData, "opencode", "opencode.json");
+    }
+    const xdg = env.XDG_CONFIG_HOME ?? join(homedir(), ".config");
+    return join(xdg, "opencode", "opencode.json");
+}
 function getConfigPathOverride(agent, env) {
     if (agent === "codex")
         return env.SUMMER_CODEX_CONFIG_FILE;
@@ -142,6 +238,14 @@ function getConfigPathOverride(agent, env) {
         return env.SUMMER_CLAUDE_CONFIG_FILE;
     if (agent === "cursor")
         return env.SUMMER_CURSOR_MCP_CONFIG_FILE;
+    if (agent === "cline")
+        return env.SUMMER_CLINE_CONFIG_FILE;
+    if (agent === "roo-code")
+        return env.SUMMER_ROO_CODE_CONFIG_FILE;
+    if (agent === "gemini")
+        return env.SUMMER_GEMINI_CONFIG_FILE;
+    if (agent === "opencode")
+        return env.SUMMER_OPENCODE_CONFIG_FILE;
     return env.SUMMER_WINDSURF_MCP_CONFIG_FILE;
 }
 async function upsertJsonMcpConfig(path, server, write) {
@@ -198,6 +302,60 @@ async function upsertCodexConfig(path, server, write) {
     }
     return { changed };
 }
+async function upsertOpencodeConfig(path, server, write) {
+    const current = await readJsonConfig(path);
+    const next = copyJsonObject(current);
+    if (typeof next.$schema !== "string") {
+        next.$schema = "https://opencode.ai/config.json";
+    }
+    const existingMcp = isJsonObject(next.mcp) ? next.mcp : {};
+    next.mcp = {
+        ...existingMcp,
+        [SUMMER_MCP_SERVER_NAME]: opencodeServerEntry(server),
+    };
+    const currentRendered = renderJsonFile(current);
+    const nextRendered = renderJsonFile(next);
+    const changed = currentRendered !== nextRendered;
+    if (write && changed) {
+        await writeTextFile(path, nextRendered);
+    }
+    return { changed };
+}
+async function upsertGeminiExtension(path, server, write) {
+    const current = await readJsonConfig(path);
+    const next = geminiExtensionManifest(server, current);
+    const currentRendered = renderJsonFile(current);
+    const nextRendered = renderJsonFile(next);
+    const changed = currentRendered !== nextRendered;
+    if (write && changed) {
+        await writeTextFile(path, nextRendered);
+    }
+    return { changed };
+}
+function opencodeServerEntry(server) {
+    const entry = {
+        type: "local",
+        command: [server.command, ...server.args],
+    };
+    if (server.env && Object.keys(server.env).length > 0) {
+        entry.environment = { ...server.env };
+    }
+    return entry;
+}
+function geminiExtensionManifest(server, base = {}) {
+    const manifest = { ...base };
+    manifest.name = "summer";
+    manifest.description =
+        "Superpowers for AI game dev. MCP bridge to the local Summer Engine plus a context primer that teaches Gemini the Summer skills.";
+    manifest.contextFileName = "GEMINI.md";
+    manifest.mcpServers = {
+        [SUMMER_MCP_SERVER_NAME]: {
+            command: server.command,
+            args: server.args,
+        },
+    };
+    return manifest;
+}
 async function readTextFileIfExists(path) {
     if (!existsSync(path))
         return "";
@@ -273,7 +431,15 @@ function createNextSteps(agent, scope, path) {
             ? "Restart Codex or run /mcp in a new session."
             : agent === "cursor"
                 ? "Restart Cursor and enable the summer-engine MCP server if prompted."
-                : "Restart Windsurf and refresh MCP servers from Cascade settings.";
+                : agent === "cline"
+                    ? "Restart VS Code so Cline reloads its MCP config."
+                    : agent === "roo-code"
+                        ? "Restart VS Code so Roo Code reloads its MCP config."
+                        : agent === "gemini"
+                            ? "Run `gemini extensions enable summer-engine` (if not already enabled), then restart Gemini CLI."
+                            : agent === "opencode"
+                                ? "Restart OpenCode so it reloads opencode.json."
+                                : "Restart Windsurf and refresh MCP servers from Cascade settings.";
     const projectTrust = scope === "project" && agent === "codex"
         ? "Codex only loads project .codex/config.toml from trusted projects."
         : null;