summer-engine 1.2.1 → 1.3.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Summer Engine
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -32,9 +32,14 @@ Verify:
 summer doctor
 ```
 
-Then open your agent and try the verification prompt:
+Then open your agent and try one of the slash commands:
 
-> Use Summer Engine MCP. First call `summer_get_project_context` and `summer_get_agent_playbook`, then add a `DirectionalLight3D` and `Camera3D` to the main scene, save it, and check diagnostics.
+| Command | What it does |
+|---|---|
+| `/debug` | Triage and fix a bug end-to-end (reads engine errors, locates code, proposes fix) |
+| `/play` | Run the game and report state (clean run, warnings, or crash) |
+
+Or just describe what you want — the specialist skills (FPS controller, lighting, GDScript patterns, scene composition, UI, asset strategy) auto-trigger on natural language: "make me an FPS", "add lighting", "I need a HUD".
 
 ## Commands
 

package/dist/bin/summer.js

@@ -14,13 +14,18 @@ import { skillsCommand } from "../commands/skills.js";
 import { orchestratorCommand } from "../commands/orchestrator.js";
 import { setupCommand } from "../commands/setup.js";
 import { doctorCommand } from "../commands/doctor.js";
+import { getBanner } from "../lib/banner.js";
+import { c, sym } from "../lib/format.js";
 const require = createRequire(import.meta.url);
 const { version } = require("../../package.json");
 const program = new Command();
 program
     .name("summer")
     .description("CLI and MCP tools for Summer Engine — the AI-native game engine")
-    .version(version);
+    .version(version)
+    .action(() => {
+    printIntro(version);
+});
 program.addCommand(installCommand);
 program.addCommand(loginCommand);
 program.addCommand(logoutCommand);
@@ -38,3 +43,21 @@ program.parseAsync().catch((err) => {
     console.error(err instanceof Error ? err.message : String(err));
     process.exit(1);
 });
+function printIntro(version) {
+    console.log("");
+    console.log(getBanner());
+    console.log("");
+    console.log(`     ${sym.arrow()} ${c.bold("Summer Engine")} ${c.dim("v" + version)}  ${c.dim("·")}  AI-native game engine`);
+    console.log("");
+    console.log(`     ${c.bold("Get started")}`);
+    console.log(`     ${c.dim("$")} summer setup claude-code      ${c.dim("Configure Claude Code (or codex/cursor/windsurf)")}`);
+    console.log(`     ${c.dim("$")} summer create 3d-basic my-game ${c.dim("Start a project")}`);
+    console.log(`     ${c.dim("$")} summer doctor                  ${c.dim("Check setup")}`);
+    console.log("");
+    console.log(`     ${c.bold("Slash commands")} ${c.dim("(in your AI agent)")}`);
+    console.log(`     ${c.brand("/debug")}   ${c.dim("Triage and fix a bug end-to-end")}`);
+    console.log(`     ${c.brand("/play")}    ${c.dim("Run the game and report state")}`);
+    console.log("");
+    console.log(`     ${c.dim("Docs:")} https://summerengine.com/docs`);
+    console.log("");
+}

package/dist/commands/doctor.js

@@ -5,6 +5,7 @@ import { platform } from "os";
 import { Command } from "commander";
 import { getAuthToken, getUserInfo } from "../lib/auth.js";
 import { checkEngineHealth, getApiPort, getApiToken } from "../lib/engine.js";
+import { brandLine, c, pad, sym, tildeify } from "../lib/format.js";
 const require = createRequire(import.meta.url);
 const { version } = require("../../package.json");
 const MAC_ENGINE_PATHS = [
@@ -17,11 +18,17 @@ const WIN_ENGINE_PATHS = [
     `${process.env.PROGRAMFILES}\\Summer Engine\\Summer.exe`,
 ];
 export const doctorCommand = new Command("doctor")
-    .description("Run setup and connection diagnostics")
+    .description("Diagnose Node, login, engine, local API, and MCP boot")
     .option("--json", "Print diagnostics as JSON")
-    .option("--human", "Print diagnostics in a human-readable format")
     .action(async (opts) => {
-    const result = await runDoctor({ json: opts.json || !opts.human });
+    if (!opts.json) {
+        const { createRequire: req } = await import("node:module");
+        const ver = req(import.meta.url)("../../package.json").version;
+        console.log("");
+        console.log(brandLine(ver));
+        console.log("");
+    }
+    const result = await runDoctor({ json: Boolean(opts.json) });
     if (!result.ok) {
         process.exit(1);
     }
@@ -33,7 +40,7 @@ export async function runDoctor(options = {}) {
         id: "cli-version",
         label: "Summer CLI",
         status: "ok",
-        message: `summer-engine CLI v${version}`,
+        message: `v${version}`,
     });
     checks.push(await checkLogin());
     checks.push(checkEngineInstall());
@@ -57,14 +64,14 @@ function checkNodeVersion() {
             id: "node-version",
             label: "Node.js",
             status: "ok",
-            message: `Node ${process.version}`,
+            message: process.version,
         };
     }
     return {
         id: "node-version",
         label: "Node.js",
         status: "fail",
-        message: `Node ${process.version} found; Summer CLI requires Node 18 or newer.`,
+        message: `${process.version} (need 18+)`,
     };
 }
 async function checkLogin() {
@@ -75,32 +82,34 @@ async function checkLogin() {
             id: "login",
             label: "Login",
             status: "warning",
-            message: "Not logged in. Run: summer login",
+            message: "not signed in (run: summer login)",
         };
     }
     return {
         id: "login",
         label: "Login",
         status: "ok",
-        message: user ? `Logged in as ${user.email}` : "Auth token found.",
+        message: user ? user.email : "signed in",
     };
 }
 function checkEngineInstall() {
     const binary = findEngineBinary();
     if (binary) {
+        // Shorten /Applications/Summer.app/Contents/MacOS/Summer -> /Applications/Summer.app
+        const display = binary.replace(/\/Contents\/MacOS\/Summer$/, "");
         return {
             id: "engine-install",
-            label: "Engine Install",
+            label: "Engine",
             status: "ok",
-            message: `Summer Engine binary found at ${binary}`,
+            message: tildeify(display),
             details: { path: binary },
         };
     }
     return {
         id: "engine-install",
-        label: "Engine Install",
+        label: "Engine",
         status: "warning",
-        message: "Summer Engine binary was not found in the default install locations.",
+        message: "not installed (run: summer install)",
     };
 }
 async function checkLocalApi() {
@@ -111,7 +120,7 @@ async function checkLocalApi() {
             id: "local-api",
             label: "Local API",
             status: "warning",
-            message: "Engine API token not found; Summer Engine is probably not running.",
+            message: "engine not running",
             details: { port },
         };
     }
@@ -121,7 +130,7 @@ async function checkLocalApi() {
             id: "local-api",
             label: "Local API",
             status: "warning",
-            message: `API token found, but Summer Engine is not responding on port ${port}.`,
+            message: `not responding on :${port}`,
             details: { port },
         };
     }
@@ -129,7 +138,7 @@ async function checkLocalApi() {
         id: "local-api",
         label: "Local API",
         status: "ok",
-        message: `Summer Engine API is responding on port ${port}.`,
+        message: `:${port}`,
         details: {
             port,
             version: health.version,
@@ -182,7 +191,7 @@ async function checkMcpBoot() {
                     id: "mcp-boot",
                     label: "MCP Server",
                     status: "ok",
-                    message: "MCP stdio server starts successfully.",
+                    message: "ready",
                 });
             }
         });
@@ -225,12 +234,27 @@ function summarizeChecks(checks) {
     };
 }
 export function printDoctorResult(result) {
-    console.log("Summer Doctor\n");
+    console.log(c.bold("Doctor"));
+    console.log("");
+    const labelWidth = 14;
     for (const check of result.checks) {
-        const mark = check.status === "ok" ? "OK" : check.status === "warning" ? "WARN" : "FAIL";
-        console.log(`  ${mark.padEnd(4)} ${check.label}: ${check.message}`);
+        const mark = check.status === "ok"
+            ? sym.ok()
+            : check.status === "warning"
+                ? sym.warn()
+                : sym.fail();
+        console.log(`  ${mark}  ${pad(c.bold(check.label), labelWidth)}${c.dim(check.message)}`);
+    }
+    console.log("");
+    if (result.summary.failures > 0) {
+        console.log(c.red(`${result.summary.failures} ${result.summary.failures === 1 ? "issue" : "issues"} to fix.`));
+    }
+    else if (result.summary.warnings > 0) {
+        console.log(c.yellow(`${result.summary.warnings} ${result.summary.warnings === 1 ? "warning" : "warnings"}, ${result.summary.ok} OK.`));
+    }
+    else {
+        console.log(c.green("Everything's wired up."));
     }
-    console.log(`\n${result.summary.ok} ok, ${result.summary.warnings} warnings, ${result.summary.failures} failures`);
 }
 function findEngineBinary() {
     const paths = platform() === "darwin" ? MAC_ENGINE_PATHS : WIN_ENGINE_PATHS;

package/dist/commands/setup.js

@@ -1,7 +1,17 @@
 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: "Windsurf",
+};
 export const setupCommand = new Command("setup")
     .description("Configure Summer Engine for an AI agent and run diagnostics")
     .argument("[agent]", `Agent to configure: ${supportedAgents.join(", ")}`)
@@ -109,20 +119,81 @@ function skillInstallInvocation(agent) {
 function printSetupResult(config, skills, doctor) {
     if (config.print) {
         console.log(config.snippet.trimEnd());
+        return;
     }
-    else if (config.dryRun) {
-        console.log(`Would update ${config.path} for ${config.agent} (${config.scope}).`);
+    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(`Configured Summer Engine MCP for ${config.agent} (${config.scope}) at ${config.path}.`);
+        console.log(`  ${sym.ok()}  Linked to ${c.bold(agentLabel)}  ${c.dim(tildeify(config.path))}`);
     }
     else {
-        console.log(`Summer Engine MCP already configured for ${config.agent} (${config.scope}) at ${config.path}.`);
+        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.warn(`Warning: ${warning}`);
+        console.log(`  ${sym.warn()}  ${c.yellow(warning)}`);
     }
-    console.log(`Skills: ${skills.message}`);
     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/skills.js

@@ -4,6 +4,7 @@ import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 import { homedir } 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));
 // Resolve skills dir: from dist/commands/skills.js -> ../../skills
 const skillsDir = join(__dirname, "..", "..", "skills");
@@ -13,7 +14,7 @@ function getBuiltinSkills() {
     for (const entry of SKILL_REGISTRY) {
         if (!entry.public)
             continue;
-        const skillPath = join(skillsDir, entry.name, "SKILL.md");
+        const skillPath = join(skillsDir, entry.category, entry.name, "SKILL.md");
         if (!existsSync(skillPath))
             continue;
         const frontmatter = parseSkillFrontmatter(skillPath);
@@ -48,13 +49,19 @@ function getSkillMeta(name) {
     return getBuiltinSkills().find((skill) => skill.name === name) ?? null;
 }
 function getSkillPath(name) {
-    const path = join(skillsDir, name);
+    const entry = SKILL_REGISTRY.find((s) => s.name === name);
+    if (!entry)
+        return null;
+    const path = join(skillsDir, entry.category, entry.name);
     if (!existsSync(path) || !existsSync(join(path, "SKILL.md")))
         return null;
     return path;
 }
 function getSkillBody(name) {
-    const skillPath = join(skillsDir, name, "SKILL.md");
+    const entry = SKILL_REGISTRY.find((s) => s.name === name);
+    if (!entry)
+        throw new Error(`Unknown skill: ${name}`);
+    const skillPath = join(skillsDir, entry.category, entry.name, "SKILL.md");
     const content = readFileSync(skillPath, "utf-8");
     return content.replace(/^---\s*\n[\s\S]*?\n---\s*\n/, "").trim();
 }
@@ -236,15 +243,16 @@ function escapeRegExp(value) {
 }
 function printInstallSummary(count, agent, scope, location) {
     const label = agentLabel(agent);
+    const tildeified = tildeify(location.path);
     console.log(`\n${count} skill${count === 1 ? "" : "s"} ready for ${label} (${scope} scope).`);
     if (location.kind === "skill-dir") {
-        console.log(`${label} can read skills from ${location.path}/<skill>/SKILL.md`);
+        console.log(`${label} can read skills from ${tildeified}/<skill>/SKILL.md`);
     }
     else if (location.kind === "cursor-rule-dir") {
-        console.log(`Cursor rules are in ${location.path}/summer-<skill>.mdc`);
+        console.log(`Cursor rules are in ${tildeified}/summer-<skill>.mdc`);
     }
     else {
-        console.log(`Windsurf rules are in ${location.path}`);
+        console.log(`Windsurf rules are in ${tildeified}`);
     }
 }
 export const skillsCommand = new Command("skills")

package/dist/lib/format.d.ts

@@ -0,0 +1,23 @@
+export declare function useColor(): boolean;
+export declare const c: {
+    bold: (s: string) => string;
+    dim: (s: string) => string;
+    red: (s: string) => string;
+    green: (s: string) => string;
+    yellow: (s: string) => string;
+    cyan: (s: string) => string;
+    brand: (s: string) => string;
+};
+export declare const sym: {
+    ok: () => string;
+    warn: () => string;
+    fail: () => string;
+    arrow: () => string;
+};
+export declare function tildeify(path: string | undefined | null): string;
+export declare function brandLine(version: string): string;
+export declare function stripAnsi(s: string): string;
+/**
+ * Pad a string to a visible width, accounting for ANSI codes.
+ */
+export declare function pad(s: string, width: number): string;

package/dist/lib/format.js

@@ -0,0 +1,60 @@
+import { homedir } from "os";
+const ANSI = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+    red: "\x1b[31m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    cyan: "\x1b[36m",
+    // Summer brand orange (matches banner.ts mid gradient)
+    brand: "\x1b[38;2;255;143;23m",
+};
+export function useColor() {
+    if (process.env.NO_COLOR)
+        return false;
+    if (process.env.FORCE_COLOR)
+        return true;
+    return Boolean(process.stdout.isTTY);
+}
+function paint(code, s) {
+    return useColor() ? `${code}${s}${ANSI.reset}` : s;
+}
+export const c = {
+    bold: (s) => paint(ANSI.bold, s),
+    dim: (s) => paint(ANSI.dim, s),
+    red: (s) => paint(ANSI.red, s),
+    green: (s) => paint(ANSI.green, s),
+    yellow: (s) => paint(ANSI.yellow, s),
+    cyan: (s) => paint(ANSI.cyan, s),
+    brand: (s) => paint(ANSI.brand, s),
+};
+export const sym = {
+    ok: () => c.green("✓"),
+    warn: () => c.yellow("⚠"),
+    fail: () => c.red("✗"),
+    arrow: () => c.brand("▶"),
+};
+export function tildeify(path) {
+    if (!path)
+        return "";
+    const home = homedir();
+    if (path === home)
+        return "~";
+    if (path.startsWith(home + "/"))
+        return "~" + path.slice(home.length);
+    return path;
+}
+export function brandLine(version) {
+    return `${sym.arrow()} ${c.bold("Summer Engine")} ${c.dim("v" + version)}`;
+}
+export function stripAnsi(s) {
+    return s.replace(/\x1b\[[0-9;]*m/g, "");
+}
+/**
+ * Pad a string to a visible width, accounting for ANSI codes.
+ */
+export function pad(s, width) {
+    const visLen = stripAnsi(s).length;
+    return s + " ".repeat(Math.max(0, width - visLen));
+}

package/dist/lib/format.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/format.test.js

@@ -0,0 +1,36 @@
+import { homedir } from "os";
+import { describe, expect, it } from "vitest";
+import { stripAnsi, tildeify } from "./format.js";
+describe("tildeify", () => {
+    it("replaces home directory prefix with ~", () => {
+        const home = homedir();
+        expect(tildeify(home + "/.claude.json")).toBe("~/.claude.json");
+        expect(tildeify(home + "/projects/foo")).toBe("~/projects/foo");
+    });
+    it("returns ~ when path is the home directory exactly", () => {
+        expect(tildeify(homedir())).toBe("~");
+    });
+    it("does not touch non-home paths", () => {
+        expect(tildeify("/Applications/Summer.app")).toBe("/Applications/Summer.app");
+        expect(tildeify("/tmp/foo")).toBe("/tmp/foo");
+    });
+    it("does not partial-match (e.g. /Users/Mat vs /Users/MathiasWork)", () => {
+        const home = homedir();
+        const sibling = home.slice(0, -2) + "Other";
+        expect(tildeify(sibling + "/file")).toBe(sibling + "/file");
+    });
+    it("handles empty/null/undefined input", () => {
+        expect(tildeify(undefined)).toBe("");
+        expect(tildeify(null)).toBe("");
+        expect(tildeify("")).toBe("");
+    });
+});
+describe("stripAnsi", () => {
+    it("removes ANSI color codes", () => {
+        expect(stripAnsi("\x1b[31mhello\x1b[0m")).toBe("hello");
+        expect(stripAnsi("\x1b[1;32mbold green\x1b[0m text")).toBe("bold green text");
+    });
+    it("leaves clean strings untouched", () => {
+        expect(stripAnsi("hello")).toBe("hello");
+    });
+});

package/dist/lib/skills-registry.d.ts

@@ -1,67 +1,89 @@
 export declare const AGENT_CLIENTS: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
 export type AgentClient = (typeof AGENT_CLIENTS)[number];
-export type SkillCategory = "workflow" | "scripting" | "scene" | "gameplay" | "lighting" | "assets" | "ui";
+export declare const SKILL_CATEGORIES: readonly ["_meta", "character-controllers", "gameplay-mechanics", "scripting-patterns", "scene-and-project", "rendering-and-lighting", "shaders", "visual-effects", "post-processing", "animation", "audio", "physics", "multiplayer-and-networking", "ai-and-npcs", "level-design", "performance", "ui-and-ux", "asset-pipeline", "input-and-controls", "debugging", "deployment"];
+export type SkillCategory = (typeof SKILL_CATEGORIES)[number];
 export interface SkillRegistryEntry {
     name: string;
-    public: boolean;
     category: SkillCategory;
+    public: boolean;
     clients: readonly AgentClient[];
     recommended: boolean;
     requiresMcpTools: readonly string[];
     testScenario: string;
 }
+/**
+ * Skills with `status: HAVE` in catalog.yaml. The catalog is the planning source
+ * of truth (~85 skills); this TS registry is the install-time list (only skills
+ * with shippable content). When a NEXT skill ships, mirror it here.
+ */
 export declare const SKILL_REGISTRY: readonly [{
+    readonly name: "debug";
+    readonly category: "debugging";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: true;
+    readonly requiresMcpTools: readonly ["summer_get_console", "summer_get_debugger_errors", "summer_get_script_errors", "summer_get_diagnostics", "summer_clear_console", "summer_play", "summer_stop", "summer_inspect_node"];
+    readonly testScenario: "Triage a runtime crash end-to-end: read errors, locate code, propose fix, apply on approval, verify.";
+}, {
+    readonly name: "play";
+    readonly category: "scene-and-project";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: true;
+    readonly requiresMcpTools: readonly ["summer_is_running", "summer_play", "summer_stop", "summer_clear_console", "summer_get_diagnostics", "summer_get_debugger_errors", "summer_get_script_errors"];
+    readonly testScenario: "Run the game from a clean state, wait for first frame, report whether it runs cleanly or has errors.";
+}, {
     readonly name: "gdscript-patterns";
+    readonly category: "scripting-patterns";
     readonly public: true;
-    readonly category: "scripting";
     readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
     readonly recommended: true;
-    readonly requiresMcpTools: readonly ["summer_set_prop", "summer_connect_signal", "summer_input_map_bind", "summer_get_script_errors"];
-    readonly testScenario: "Create a typed GDScript with a signal, attach it to a node, connect the signal, and verify script errors.";
+    readonly requiresMcpTools: readonly ["summer_get_script_errors"];
+    readonly testScenario: "Write a typed GDScript with a signal, attach it to a node, connect the signal, and verify script errors.";
 }, {
     readonly name: "scene-composition";
+    readonly category: "scene-and-project";
     readonly public: true;
-    readonly category: "scene";
     readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
     readonly recommended: true;
     readonly requiresMcpTools: readonly ["summer_create_scene", "summer_open_scene", "summer_get_scene_tree", "summer_add_node", "summer_instantiate_scene", "summer_save_scene"];
     readonly testScenario: "Build a small reusable player scene, instantiate it in a main scene, and save both scenes through Summer tools.";
 }, {
     readonly name: "fps-controller";
+    readonly category: "character-controllers";
     readonly public: true;
-    readonly category: "gameplay";
     readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
     readonly recommended: true;
     readonly requiresMcpTools: readonly ["summer_add_node", "summer_set_prop", "summer_set_resource_property", "summer_input_map_bind"];
     readonly testScenario: "Create a CharacterBody3D player with collision, camera, input actions, and a host-edited controller script.";
 }, {
     readonly name: "3d-lighting";
+    readonly category: "rendering-and-lighting";
     readonly public: true;
-    readonly category: "lighting";
     readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
     readonly recommended: true;
     readonly requiresMcpTools: readonly ["summer_add_node", "summer_set_prop", "summer_set_resource_property"];
     readonly testScenario: "Add sun, fill lighting, WorldEnvironment, and shadow settings to a simple 3D scene.";
 }, {
     readonly name: "ui-basics";
+    readonly category: "ui-and-ux";
     readonly public: true;
-    readonly category: "ui";
     readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
     readonly recommended: true;
     readonly requiresMcpTools: readonly ["summer_add_node", "summer_set_prop", "summer_connect_signal"];
     readonly testScenario: "Create a HUD CanvasLayer with labels, a ProgressBar, and a connected Button signal.";
 }, {
     readonly name: "asset-strategy";
+    readonly category: "asset-pipeline";
     readonly public: true;
-    readonly category: "assets";
     readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
     readonly recommended: true;
     readonly requiresMcpTools: readonly ["summer_search_assets", "summer_import_asset", "summer_import_from_url", "summer_generate_image", "summer_generate_3d", "summer_generate_audio"];
     readonly testScenario: "Choose library, generated, or primitive assets for a small level and import one asset into the project.";
 }, {
     readonly name: "make-game";
+    readonly category: "scene-and-project";
     readonly public: true;
-    readonly category: "workflow";
     readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
     readonly recommended: false;
     readonly requiresMcpTools: readonly ["summer_get_agent_playbook", "summer_get_project_context", "summer_create_scene", "summer_open_scene", "summer_save_scene", "summer_add_node", "summer_set_prop", "summer_set_resource_property", "summer_instantiate_scene", "summer_play", "summer_stop", "summer_get_diagnostics"];