summer-engine 2.8.2 → 3.1.0

package/dist/lib/agent-config.js

@@ -1,626 +0,0 @@
-import { existsSync } from "fs";
-import { mkdir, readFile, writeFile } from "fs/promises";
-import { dirname, join, resolve } from "path";
-import { fileURLToPath } from "url";
-import { homedir, platform } from "os";
-export const SUMMER_MCP_SERVER_NAME = "summer-engine";
-export const supportedAgents = [
-    "codex",
-    "claude-code",
-    "cursor",
-    "windsurf",
-    "cline",
-    "roo-code",
-    "kilo-code",
-    "gemini",
-    "github-copilot",
-    "vscode-copilot",
-    "opencode",
-    "lm-studio",
-];
-const agentAliases = {
-    claude: "claude-code",
-    "claude-code": "claude-code",
-    codex: "codex",
-    cursor: "cursor",
-    windsurf: "windsurf",
-    devin: "windsurf",
-    "devin-desktop": "windsurf",
-    devindesktop: "windsurf",
-    cline: "cline",
-    "roo-code": "roo-code",
-    roo: "roo-code",
-    roocode: "roo-code",
-    kilo: "kilo-code",
-    kilocode: "kilo-code",
-    "kilo-code": "kilo-code",
-    gemini: "gemini",
-    "gemini-cli": "gemini",
-    copilot: "github-copilot",
-    "copilot-cli": "github-copilot",
-    "github-copilot": "github-copilot",
-    "github-copilot-cli": "github-copilot",
-    vscode: "vscode-copilot",
-    "vs-code": "vscode-copilot",
-    "vscode-copilot": "vscode-copilot",
-    "vs-code-copilot": "vscode-copilot",
-    "github-copilot-vscode": "vscode-copilot",
-    opencode: "opencode",
-    "open-code": "opencode",
-    lmstudio: "lm-studio",
-    "lm-studio": "lm-studio",
-    "lm_studio": "lm-studio",
-};
-export function parseAgent(value) {
-    if (!value)
-        return null;
-    return agentAliases[value.trim().toLowerCase()] ?? null;
-}
-export function parseScope(value) {
-    if (!value)
-        return "user";
-    const normalized = value.trim().toLowerCase();
-    if (normalized === "user" || normalized === "project")
-        return normalized;
-    return null;
-}
-export async function configureAgentMcp(options) {
-    const env = options.env ?? process.env;
-    const cwd = resolve(options.cwd ?? process.cwd());
-    const server = createSummerMcpServerConfig(Boolean(options.localDev));
-    const target = resolveConfigTarget(options.agent, options.scope, cwd, env);
-    const snippet = renderConfigSnippet(options.agent, server);
-    const dryRun = Boolean(options.dryRun);
-    const print = Boolean(options.print);
-    const shouldWrite = !dryRun && !print;
-    const update = print
-        ? { changed: true }
-        : target.format === "toml"
-            ? await upsertCodexConfig(target.path, server, shouldWrite)
-            : target.format === "json-opencode"
-                ? await upsertOpencodeConfig(target.path, server, shouldWrite)
-                : target.format === "json-copilot"
-                    ? await upsertCopilotConfig(target.path, server, shouldWrite)
-                    : target.format === "json-vscode"
-                        ? await upsertVsCodeMcpConfig(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,
-        path: target.path,
-        serverName: SUMMER_MCP_SERVER_NAME,
-        server,
-        format: target.format,
-        snippet,
-        changed: update.changed,
-        wrote: shouldWrite && update.changed,
-        dryRun,
-        print,
-        localDev: Boolean(options.localDev),
-        warnings: target.warnings,
-        nextSteps: createNextSteps(options.agent, options.scope, target.path),
-    };
-}
-export function createSummerMcpServerConfig(localDev, platform = process.platform) {
-    if (localDev) {
-        // node is a real executable on every platform; spawn("node") resolves fine.
-        return {
-            command: "node",
-            args: [resolveLocalCliPath(), "mcp"],
-        };
-    }
-    // On Windows, npx is a .cmd/.ps1 shim, and Node's spawn() does not do PATHEXT
-    // resolution — hosts that spawn("npx") directly (Claude Code, Kimi Code,
-    // Cursor, ...) fail with ENOENT even though npx works in a terminal. Route
-    // through cmd.exe so the shim resolves. (User-reported: Imitater967, 2026-09-01.)
-    if (platform === "win32") {
-        return {
-            command: "cmd.exe",
-            args: ["/c", "npx", "-y", "summer-engine@latest", "mcp"],
-        };
-    }
-    return {
-        command: "npx",
-        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 === "github-copilot") {
-        return (JSON.stringify({
-            mcpServers: {
-                [SUMMER_MCP_SERVER_NAME]: copilotServerEntry(server),
-            },
-        }, null, 2) + "\n");
-    }
-    if (agent === "vscode-copilot") {
-        return (JSON.stringify({
-            servers: {
-                [SUMMER_MCP_SERVER_NAME]: vsCodeServerEntry(server),
-            },
-        }, null, 2) + "\n");
-    }
-    if (agent === "gemini") {
-        return (JSON.stringify(geminiExtensionManifest(server), null, 2) + "\n");
-    }
-    return (JSON.stringify({
-        mcpServers: {
-            [SUMMER_MCP_SERVER_NAME]: server,
-        },
-    }, null, 2) + "\n");
-}
-function resolveLocalCliPath() {
-    const thisFile = fileURLToPath(import.meta.url);
-    return resolve(dirname(thisFile), "..", "bin", "summer.js");
-}
-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" || agent === "lm-studio")) {
-            warnings.push(`${agent} MCP config has no project scope today; treating as user scope.`);
-        }
-        return {
-            path: resolve(override),
-            format: agent === "codex"
-                ? "toml"
-                : agent === "opencode"
-                    ? "json-opencode"
-                    : agent === "github-copilot"
-                        ? "json-copilot"
-                        : agent === "vscode-copilot"
-                            ? "json-vscode"
-                            : "json",
-            warnings,
-        };
-    }
-    if (agent === "codex") {
-        return {
-            path: scope === "user"
-                ? join(homedir(), ".codex", "config.toml")
-                : join(cwd, ".codex", "config.toml"),
-            format: "toml",
-            warnings,
-        };
-    }
-    if (agent === "claude-code") {
-        return {
-            path: scope === "user"
-                ? join(homedir(), ".claude.json")
-                : join(cwd, ".mcp.json"),
-            format: "json",
-            warnings,
-        };
-    }
-    if (agent === "cursor") {
-        return {
-            path: scope === "user"
-                ? join(homedir(), ".cursor", "mcp.json")
-                : join(cwd, ".cursor", "mcp.json"),
-            format: "json",
-            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 === "kilo-code") {
-        return {
-            path: scope === "user"
-                ? vsCodeGlobalStoragePath(env, "kilocode.kilo-code", "mcp_settings.json")
-                : join(cwd, ".kilocode", "mcp.json"),
-            format: "json",
-            warnings,
-        };
-    }
-    if (agent === "lm-studio") {
-        if (scope === "project") {
-            warnings.push("LM Studio's MCP config is app-global (~/.lmstudio/mcp.json); treating as user scope.");
-        }
-        return {
-            path: join(homedir(), ".lmstudio", "mcp.json"),
-            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 === "github-copilot") {
-        return {
-            path: scope === "user"
-                ? join(homedir(), ".copilot", "mcp-config.json")
-                : join(cwd, ".mcp.json"),
-            format: "json-copilot",
-            warnings,
-        };
-    }
-    if (agent === "vscode-copilot") {
-        return {
-            path: scope === "user"
-                ? vsCodeUserMcpPath(env)
-                : join(cwd, ".vscode", "mcp.json"),
-            format: "json-vscode",
-            warnings,
-        };
-    }
-    if (agent === "opencode") {
-        return {
-            path: scope === "user"
-                ? opencodeUserConfigPath(env)
-                : join(cwd, "opencode.json"),
-            format: "json-opencode",
-            warnings,
-        };
-    }
-    if (scope === "project") {
-        warnings.push("Devin Desktop (formerly Windsurf) documents MCP configuration as user-scoped; project scope writes .windsurf/mcp_config.json for teams that load workspace config.");
-    }
-    return {
-        path: scope === "user"
-            ? join(homedir(), ".codeium", "windsurf", "mcp_config.json")
-            : join(cwd, ".windsurf", "mcp_config.json"),
-        format: "json",
-        warnings,
-    };
-}
-function vsCodeGlobalStoragePath(env, extensionId, fileName = "cline_mcp_settings.json") {
-    const os = platform();
-    if (os === "win32") {
-        const appData = env.APPDATA ?? join(homedir(), "AppData", "Roaming");
-        return join(appData, "Code", "User", "globalStorage", extensionId, "settings", fileName);
-    }
-    if (os === "darwin") {
-        return join(homedir(), "Library", "Application Support", "Code", "User", "globalStorage", extensionId, "settings", fileName);
-    }
-    // Linux and other Unix
-    const xdg = env.XDG_CONFIG_HOME ?? join(homedir(), ".config");
-    return join(xdg, "Code", "User", "globalStorage", extensionId, "settings", fileName);
-}
-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 vsCodeUserMcpPath(env) {
-    const os = platform();
-    if (os === "win32") {
-        const appData = env.APPDATA ?? join(homedir(), "AppData", "Roaming");
-        return join(appData, "Code", "User", "mcp.json");
-    }
-    if (os === "darwin") {
-        return join(homedir(), "Library", "Application Support", "Code", "User", "mcp.json");
-    }
-    const xdg = env.XDG_CONFIG_HOME ?? join(homedir(), ".config");
-    return join(xdg, "Code", "User", "mcp.json");
-}
-function getConfigPathOverride(agent, env) {
-    if (agent === "codex")
-        return env.SUMMER_CODEX_CONFIG_FILE;
-    if (agent === "claude-code")
-        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 === "kilo-code")
-        return env.SUMMER_KILO_CODE_CONFIG_FILE;
-    if (agent === "lm-studio")
-        return env.SUMMER_LM_STUDIO_CONFIG_FILE;
-    if (agent === "gemini")
-        return env.SUMMER_GEMINI_CONFIG_FILE;
-    if (agent === "github-copilot")
-        return env.SUMMER_GITHUB_COPILOT_CONFIG_FILE;
-    if (agent === "vscode-copilot")
-        return env.SUMMER_VSCODE_COPILOT_CONFIG_FILE;
-    if (agent === "opencode")
-        return env.SUMMER_OPENCODE_CONFIG_FILE;
-    return env.SUMMER_WINDSURF_MCP_CONFIG_FILE;
-}
-async function upsertJsonMcpConfig(path, server, write) {
-    const current = await readJsonConfig(path);
-    const next = copyJsonObject(current);
-    next.mcpServers = mergeMcpServers(next.mcpServers, server);
-    const currentRendered = renderJsonFile(current);
-    const nextRendered = renderJsonFile(next);
-    const changed = currentRendered !== nextRendered;
-    if (write && changed) {
-        await writeTextFile(path, nextRendered);
-    }
-    return { changed };
-}
-function mergeMcpServers(value, server) {
-    if (value !== undefined && !isJsonObject(value)) {
-        throw new Error("Existing mcpServers value must be a JSON object.");
-    }
-    return {
-        ...(isJsonObject(value) ? value : {}),
-        [SUMMER_MCP_SERVER_NAME]: server,
-    };
-}
-async function readJsonConfig(path) {
-    if (!existsSync(path))
-        return {};
-    let content;
-    try {
-        content = await readFile(path, "utf-8");
-    }
-    catch (error) {
-        throw new Error(`Could not read ${path}: ${formatError(error)}`);
-    }
-    if (content.trim() === "")
-        return {};
-    let parsed;
-    try {
-        parsed = JSON.parse(content);
-    }
-    catch (error) {
-        throw new Error(`Could not parse JSON in ${path}: ${formatError(error)}`);
-    }
-    if (!isJsonObject(parsed)) {
-        throw new Error(`Expected ${path} to contain a JSON object.`);
-    }
-    return parsed;
-}
-async function upsertCodexConfig(path, server, write) {
-    const current = await readTextFileIfExists(path);
-    const next = upsertTomlTable(current, renderCodexServerTable(server));
-    const changed = current !== next;
-    if (write && changed) {
-        await writeTextFile(path, next);
-    }
-    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 upsertCopilotConfig(path, server, write) {
-    const current = await readJsonConfig(path);
-    const next = copyJsonObject(current);
-    next.mcpServers = mergeNamedObject(next.mcpServers, SUMMER_MCP_SERVER_NAME, copilotServerEntry(server), "mcpServers");
-    const currentRendered = renderJsonFile(current);
-    const nextRendered = renderJsonFile(next);
-    const changed = currentRendered !== nextRendered;
-    if (write && changed) {
-        await writeTextFile(path, nextRendered);
-    }
-    return { changed };
-}
-async function upsertVsCodeMcpConfig(path, server, write) {
-    const current = await readJsonConfig(path);
-    const next = copyJsonObject(current);
-    next.servers = mergeNamedObject(next.servers, SUMMER_MCP_SERVER_NAME, vsCodeServerEntry(server), "servers");
-    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 copilotServerEntry(server) {
-    const entry = {
-        type: "local",
-        command: server.command,
-        args: server.args,
-        tools: ["*"],
-    };
-    if (server.env && Object.keys(server.env).length > 0) {
-        entry.env = { ...server.env };
-    }
-    return entry;
-}
-function vsCodeServerEntry(server) {
-    const entry = {
-        type: "stdio",
-        command: server.command,
-        args: server.args,
-    };
-    if (server.env && Object.keys(server.env).length > 0) {
-        entry.env = { ...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 "";
-    try {
-        return await readFile(path, "utf-8");
-    }
-    catch (error) {
-        throw new Error(`Could not read ${path}: ${formatError(error)}`);
-    }
-}
-function upsertTomlTable(content, table) {
-    const lines = content.split(/\r?\n/);
-    const serverHeader = /^\s*\[mcp_servers\.(?:"summer-engine"|summer-engine)(?:\.|\])/;
-    const start = lines.findIndex((line) => /^\s*\[mcp_servers\.(?:"summer-engine"|summer-engine)\]\s*(?:#.*)?$/.test(line));
-    if (start === -1) {
-        const trimmed = content.endsWith("\n") || content === "" ? content : `${content}\n`;
-        return `${trimmed}${trimmed === "" ? "" : "\n"}${table}`;
-    }
-    let end = lines.length;
-    for (let index = start + 1; index < lines.length; index += 1) {
-        if (/^\s*\[/.test(lines[index]) && !serverHeader.test(lines[index])) {
-            end = index;
-            break;
-        }
-    }
-    const replacement = table.trimEnd().split("\n");
-    if (lines[end] && lines[end].trim() !== "") {
-        replacement.push("");
-    }
-    const nextLines = [
-        ...lines.slice(0, start),
-        ...replacement,
-        ...lines.slice(end),
-    ];
-    return ensureTrailingNewline(nextLines.join("\n"));
-}
-function renderCodexServerTable(server) {
-    const lines = [
-        `[mcp_servers.${SUMMER_MCP_SERVER_NAME}]`,
-        `command = ${tomlString(server.command)}`,
-        `args = [${server.args.map(tomlString).join(", ")}]`,
-    ];
-    if (server.env && Object.keys(server.env).length > 0) {
-        lines.push(`env = { ${Object.entries(server.env)
-            .map(([key, value]) => `${key} = ${tomlString(value)}`)
-            .join(", ")} }`);
-    }
-    return `${lines.join("\n")}\n`;
-}
-function tomlString(value) {
-    return JSON.stringify(value);
-}
-function renderJsonFile(value) {
-    return `${JSON.stringify(value, null, 2)}\n`;
-}
-function copyJsonObject(value) {
-    return JSON.parse(JSON.stringify(value));
-}
-function mergeNamedObject(value, key, entry, label) {
-    if (value !== undefined && !isJsonObject(value)) {
-        throw new Error(`Existing ${label} value must be a JSON object.`);
-    }
-    return {
-        ...(isJsonObject(value) ? value : {}),
-        [key]: entry,
-    };
-}
-function isJsonObject(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-async function writeTextFile(path, content) {
-    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
-    await writeFile(path, content, { encoding: "utf-8", mode: 0o600 });
-}
-function ensureTrailingNewline(value) {
-    return value.endsWith("\n") ? value : `${value}\n`;
-}
-function createNextSteps(agent, scope, path) {
-    const restart = agent === "claude-code"
-        ? "Restart Claude Code or run /mcp in a new session."
-        : agent === "codex"
-            ? "Restart Codex or run /mcp in a new session."
-            : agent === "cursor"
-                ? "Restart Cursor and enable the summer-engine MCP server if prompted."
-                : 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 === "kilo-code"
-                            ? "Restart VS Code so Kilo Code reloads its MCP config."
-                            : agent === "lm-studio"
-                                ? "Open LM Studio, toggle on the summer-engine MCP server in the Program tab, and raise the loaded model's context length to 32k or higher."
-                                : agent === "gemini"
-                                    ? "Run `gemini extensions enable summer-engine` (if not already enabled), then restart Gemini CLI."
-                                    : agent === "github-copilot"
-                                        ? "Restart Copilot CLI, or run /mcp reload and /skills reload in the active session."
-                                        : agent === "vscode-copilot"
-                                            ? "Restart VS Code or run MCP: List Servers, then start summer-engine in Copilot Agent mode."
-                                            : agent === "opencode"
-                                                ? "Restart OpenCode so it reloads opencode.json."
-                                                : "Restart Devin Desktop (formerly Windsurf) and refresh MCP servers from the agent settings.";
-    const projectTrust = scope === "project" && agent === "codex"
-        ? "Codex only loads project .codex/config.toml from trusted projects."
-        : null;
-    return [projectTrust, `Updated ${path}.`, restart].filter((step) => Boolean(step));
-}
-function formatError(error) {
-    return error instanceof Error ? error.message : String(error);
-}

package/dist/lib/banner.d.ts

@@ -1,4 +0,0 @@
-export declare function getBanner(version?: string): string;
-export declare function getWelcome(version: string): string;
-export declare function printBanner(version?: string): void;
-export declare function printWelcome(version: string): void;