summer-engine 2.8.2 → 3.1.0

package/dist/commands/setup.js

@@ -1,217 +0,0 @@
-import { spawnSync } from "child_process";
-import { createRequire } from "node:module";
-import { Command } from "commander";
-import { configureAgentMcp, parseAgent, parseScope, supportedAgents, } from "../lib/agent-config.js";
-import { printDoctorResult, runDoctor } from "./doctor.js";
-import { brandLine, c, sym, tildeify } from "../lib/format.js";
-const requireFromHere = createRequire(import.meta.url);
-const { version: cliVersion } = requireFromHere("../../package.json");
-const AGENT_LABEL = {
-    "claude-code": "Claude Code",
-    codex: "Codex",
-    cursor: "Cursor",
-    windsurf: "Devin Desktop (Windsurf)",
-    cline: "Cline",
-    "roo-code": "Roo Code",
-    "kilo-code": "Kilo Code",
-    gemini: "Gemini CLI",
-    "github-copilot": "GitHub Copilot CLI",
-    "vscode-copilot": "GitHub Copilot in VS Code",
-    opencode: "OpenCode",
-    "lm-studio": "LM Studio",
-};
-export const setupCommand = new Command("setup")
-    .description("Configure Summer Engine for an AI agent and run diagnostics")
-    .argument("[agent]", `Agent to configure: ${supportedAgents.join(", ")}`)
-    .option("--agent <agent>", `Agent to configure: ${supportedAgents.join(", ")}`)
-    .option("--scope <scope>", "Configuration scope: user or project", "user")
-    .option("--dry-run", "Show planned changes without writing files")
-    .option("--print", "Print the MCP config snippet instead of writing files")
-    .option("--yes", "Apply practical setup steps without prompting")
-    .option("--json", "Print setup result as JSON")
-    .option("--force", "Overwrite existing skill content (passes --force through to skills install)")
-    .action(async (agentArg, opts) => {
-    const agent = resolveAgent(agentArg, opts.agent);
-    const scope = resolveScope(opts.scope);
-    const config = await configureAgentMcp({
-        agent,
-        scope,
-        dryRun: opts.dryRun,
-        print: opts.print,
-    });
-    const skills = setupRecommendedSkills(agent, {
-        dryRun: Boolean(opts.dryRun || opts.print),
-        yes: Boolean(opts.yes),
-        force: Boolean(opts.force),
-    });
-    const doctor = await runDoctor({ quiet: true });
-    if (opts.json) {
-        console.log(JSON.stringify({
-            ok: doctor.ok && skills.status !== "failed",
-            config,
-            skills,
-            doctor,
-        }, null, 2));
-    }
-    else {
-        printSetupResult(config, skills, doctor);
-    }
-    if (!doctor.ok || skills.status === "failed") {
-        process.exit(1);
-    }
-});
-function resolveAgent(agentArg, agentOpt) {
-    if (agentArg && agentOpt && parseAgent(agentArg) !== parseAgent(agentOpt)) {
-        throw new Error("Specify the agent either positionally or with --agent, not both.");
-    }
-    const parsed = parseAgent(agentOpt ?? agentArg);
-    if (!parsed) {
-        throw new Error(`Specify an agent: ${supportedAgents.join(", ")}`);
-    }
-    return parsed;
-}
-function resolveScope(scopeOpt) {
-    const parsed = parseScope(scopeOpt);
-    if (!parsed) {
-        throw new Error("Invalid --scope. Use user or project.");
-    }
-    return parsed;
-}
-function setupRecommendedSkills(agent, options) {
-    if (agent === "lm-studio") {
-        return {
-            status: "skipped",
-            message: "LM Studio has no rules or skills folder. The MCP server ships summer_get_agent_playbook, so the model can pull Summer guidance in-chat.",
-        };
-    }
-    const invocation = skillInstallInvocation(agent, { force: options.force });
-    if (!invocation) {
-        return {
-            status: "skipped",
-            message: "No automatic skill installer is available for this agent yet. Run `summer skills install --all` and point the agent at the installed SKILL.md files.",
-        };
-    }
-    if (options.dryRun || !options.yes) {
-        return {
-            status: "planned",
-            command: invocation.display,
-            message: `Recommended skills can be installed with: ${invocation.display.join(" ")}`,
-        };
-    }
-    const result = spawnSync(invocation.command, invocation.args, {
-        env: process.env,
-        encoding: "utf-8",
-    });
-    if (result.status === 0) {
-        return {
-            status: "installed",
-            command: invocation.display,
-            message: "Recommended Summer skills installed.",
-            stdout: result.stdout.trim(),
-            stderr: result.stderr.trim(),
-        };
-    }
-    return {
-        status: "failed",
-        command: invocation.display,
-        message: `Recommended skill install failed with exit code ${result.status ?? "unknown"}.`,
-        stdout: result.stdout.trim(),
-        stderr: result.stderr.trim(),
-    };
-}
-function skillInstallInvocation(agent, opts = { force: false }) {
-    const cliPath = process.argv[1];
-    if (!cliPath)
-        return null;
-    const command = cliPath.endsWith(".js") ? process.execPath : cliPath;
-    const prefix = cliPath.endsWith(".js") ? [cliPath] : [];
-    const baseArgs = ["skills", "install", "--recommended", "--agent", agent];
-    if (opts.force)
-        baseArgs.push("--force");
-    return {
-        command,
-        args: [...prefix, ...baseArgs],
-        display: [cliPath, ...baseArgs],
-    };
-}
-function printSetupResult(config, skills, doctor) {
-    if (config.print) {
-        console.log(config.snippet.trimEnd());
-        return;
-    }
-    console.log("");
-    console.log(brandLine(cliVersion));
-    console.log("");
-    const agentLabel = AGENT_LABEL[config.agent] ?? config.agent;
-    if (config.dryRun) {
-        console.log(`  ${c.dim("(dry run)")}  Would link to ${agentLabel}  ${c.dim(tildeify(config.path))}`);
-    }
-    else if (config.wrote) {
-        console.log(`  ${sym.ok()}  Linked to ${c.bold(agentLabel)}  ${c.dim(tildeify(config.path))}`);
-    }
-    else {
-        console.log(`  ${sym.ok()}  Already linked to ${c.bold(agentLabel)}  ${c.dim(tildeify(config.path))}`);
-    }
-    if (skills.status === "installed") {
-        const installed = parseInstalledSkills(skills.stdout);
-        if (installed.length > 0) {
-            const where = parseSkillTargetDir(skills.stdout);
-            console.log(`  ${sym.ok()}  Installed ${c.bold(String(installed.length) + " skills")}  ${where ? c.dim(tildeify(where)) : ""}`);
-            const grouped = installed.reduce((rows, name, i) => {
-                const row = Math.floor(i / 3);
-                rows[row] = rows[row] ?? [];
-                rows[row].push(name);
-                return rows;
-            }, []);
-            for (const row of grouped) {
-                console.log(`     ${c.dim(row.join(" · "))}`);
-            }
-        }
-        else {
-            console.log(`  ${sym.ok()}  Installed recommended skills`);
-        }
-    }
-    else if (skills.status === "planned" || skills.status === "skipped") {
-        console.log(`  ${sym.warn()}  Skills: ${c.dim(skills.message)}`);
-    }
-    else if (skills.status === "failed") {
-        console.log(`  ${sym.fail()}  Skills install failed`);
-        if (skills.stderr)
-            console.log(`     ${c.dim(skills.stderr)}`);
-    }
-    for (const warning of config.warnings) {
-        console.log(`  ${sym.warn()}  ${c.yellow(warning)}`);
-    }
-    console.log("");
-    printDoctorResult(doctor);
-    if (doctor.ok && skills.status !== "failed" && !config.dryRun) {
-        console.log("");
-        console.log(`${c.dim("Try it:")} open ${AGENT_LABEL[config.agent] ?? config.agent} and ask: ${c.bold("\"add a DirectionalLight3D and Camera3D to my scene\"")}`);
-    }
-}
-function parseInstalledSkills(stdout) {
-    if (!stdout)
-        return [];
-    // Lines look like: "  Installed fps-controller -> /path/.../fps-controller"
-    const names = [];
-    for (const line of stdout.split("\n")) {
-        const m = line.match(/^\s*Installed\s+([a-z0-9-]+)\s+->/i);
-        if (m)
-            names.push(m[1]);
-    }
-    return names;
-}
-function parseSkillTargetDir(stdout) {
-    if (!stdout)
-        return null;
-    for (const line of stdout.split("\n")) {
-        const m = line.match(/^\s*Installed\s+[a-z0-9-]+\s+->\s+(.+)$/i);
-        if (m) {
-            const path = m[1].trim();
-            // Strip trailing /<skill-name> to get the parent dir
-            const parent = path.replace(/\/[a-z0-9-]+$/i, "/");
-            return parent;
-        }
-    }
-    return null;
-}

package/dist/commands/status.js

@@ -1,46 +0,0 @@
-import { Command } from "commander";
-import { getAuthToken, getUserInfo } from "../lib/auth.js";
-import { getApiToken, getApiPort, checkEngineHealth } from "../lib/engine.js";
-import { getProjectMemorySummary } from "../lib/project-memory.js";
-import { formatStatusMemoryLine } from "./memory.js";
-export const statusCommand = new Command("status")
-    .description("Check Summer Engine status, connection, and auth state")
-    .action(async () => {
-    console.log("Summer Engine Status\n");
-    const authToken = await getAuthToken();
-    const userInfo = await getUserInfo();
-    if (authToken) {
-        console.log(`  Auth: Logged in${userInfo ? ` as ${userInfo.email}` : ""}`);
-    }
-    else {
-        console.log("  Auth: Not logged in");
-        console.log("        Run: npx summer-engine login");
-        console.log("        Or: https://www.summerengine.com/login");
-    }
-    const apiToken = await getApiToken();
-    const port = await getApiPort();
-    if (!apiToken) {
-        console.log("  Engine: Not running (no api-token found)");
-        console.log("\n  To start: summer run");
-        return;
-    }
-    console.log(`  API Token: Found (~/.summer/api-token)`);
-    console.log(`  Port: ${port}`);
-    const health = await checkEngineHealth(port);
-    if (!health) {
-        console.log("  Engine: Not responding (may have closed since last launch)");
-        console.log("\n  To start: summer run");
-        return;
-    }
-    console.log(`  Engine: Running (v${health.version})`);
-    if (health.project_name) {
-        console.log(`  Project: ${health.project_name}`);
-    }
-    if (health.project_path) {
-        console.log(`  Path: ${health.project_path}`);
-        console.log(`  ${formatStatusMemoryLine(getProjectMemorySummary(health.project_path))}`);
-    }
-    if (health.scene) {
-        console.log(`  Scene: ${health.scene}`);
-    }
-});

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

@@ -1,39 +0,0 @@
-export declare const SUMMER_MCP_SERVER_NAME = "summer-engine";
-export declare const supportedAgents: readonly ["codex", "claude-code", "cursor", "windsurf", "cline", "roo-code", "kilo-code", "gemini", "github-copilot", "vscode-copilot", "opencode", "lm-studio"];
-export type SupportedAgent = (typeof supportedAgents)[number];
-export type ConfigScope = "user" | "project";
-export interface StdioMcpServerConfig {
-    command: string;
-    args: string[];
-    env?: Record<string, string>;
-}
-export interface AgentConfigOptions {
-    agent: SupportedAgent;
-    scope: ConfigScope;
-    dryRun?: boolean;
-    print?: boolean;
-    localDev?: boolean;
-    cwd?: string;
-    env?: NodeJS.ProcessEnv;
-}
-export interface AgentConfigResult {
-    agent: SupportedAgent;
-    scope: ConfigScope;
-    path: string;
-    serverName: string;
-    server: StdioMcpServerConfig;
-    format: "json" | "toml" | "json-opencode" | "json-copilot" | "json-vscode";
-    snippet: string;
-    changed: boolean;
-    wrote: boolean;
-    dryRun: boolean;
-    print: boolean;
-    localDev: boolean;
-    warnings: string[];
-    nextSteps: string[];
-}
-export declare function parseAgent(value: string | undefined): SupportedAgent | null;
-export declare function parseScope(value: string | undefined): ConfigScope | null;
-export declare function configureAgentMcp(options: AgentConfigOptions): Promise<AgentConfigResult>;
-export declare function createSummerMcpServerConfig(localDev: boolean, platform?: NodeJS.Platform): StdioMcpServerConfig;
-export declare function renderConfigSnippet(agent: SupportedAgent, server: StdioMcpServerConfig): string;