@cmpose/mcp 0.4.0 → 0.5.0

package/README.md

@@ -76,6 +76,13 @@ saving, deep links, and in-app review and update check.
 - **IDs:** `ids` takes your real AdMob (`admob`), RevenueCat (`revenueCat`) and Play Games +
   Game Center (`gameServices`) IDs, each group with its flag; `game_describe` lists the fields.
   A group you leave out keeps the test IDs / placeholders and is reported as a warning.
+- **Look (`theme`):** one of the template's style families (`bright`, `neon`, `pastel`, `bold`,
+  `nature`, `clean`; palette, shapes, motion and a font pair), listed by `game_describe` under
+  `themes` with what each suits. `theme: { family, primary, accent, fontPair }`, every field
+  optional: `primary` and `accent` (`#RRGGBB`) recolour the family with their lightness shifted
+  until text and buttons keep their contrast; a colour that still cannot pass keeps the
+  family's and is reported as a warning. Without `theme` the project gets `clean`, exactly as
+  the template ships it.
 - **Your names everywhere:** package (application identifier), company name, app name, min SDK
   (25 to 36) and iOS deployment target (15.0 to 26.2).
 
@@ -98,14 +105,18 @@ as one Docker container behind nginx. `sharing` adds spaces, roles and invitatio
   It returns the project path, the template version it used, warnings (e.g. test ad IDs to
   replace) and next steps.
 - `game_describe`: the Unity game generator's engine and editor version, template types,
-  renders, flags and their dependencies, ID groups, defaults and limits. Agents call it first.
+  renders, flags and their dependencies, ID groups, defaults, limits and the pinned template's
+  theme families (`themes`: `default` and each family's `id`, `title`, `suits` and `fontPairs`;
+  the first call downloads the template). Agents call it first.
 - `game_generate`: creates the game. Required: `projectName` (1 to 30 letters or digits,
   starting with a letter), `appName` (up to 30 characters), `packageName` (e.g.
   `com.acme.skyhopper`, at least 3 segments, up to 50 characters) and an absolute `outputDir`.
   Optional: `companyName` (like `projectName`; by default the package's second segment,
   capitalized), `templateType`, `render`, `flags`, `features` (module names: 1 to 20 lowercase
   letters or digits, starting with a letter), `minSdk` (25 to 36), `iosVersion` (15.0 to 26.2,
-  written as `major.minor`), `ids`, `templateRef`. It never overwrites a non-empty folder.
+  written as `major.minor`), `ids`, `theme`, `templateRef`. It never overwrites a non-empty
+  folder. The result names the applied theme (`theme`) and lists colour fallbacks among the
+  warnings.
 - `backend_describe`: the backend generator's options, `appName` rules, the project anatomy and
   the conventions to follow when adding code (protected routes, the 404 rule, where features
   go, the security checklist, the local runner and the deploy parts). Agents call it first.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmpose/mcp",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "mcpName": "io.github.Keremturker/cmpose",
   "description": "MCP server that generates buildable Compose Multiplatform (Android + iOS) projects and Unity game projects locally from any AI agent",
   "license": "MIT",
@@ -43,7 +43,7 @@
     "test": "node --test test/*.test.js"
   },
   "dependencies": {
-    "@cmpose/core": "0.4.0",
+    "@cmpose/core": "0.5.0",
     "@modelcontextprotocol/sdk": "1.32.1",
     "fs-extra": "^11.3.2",
     "zod": "3.25.76"

package/src/gameGenerate.js

@@ -59,12 +59,14 @@ async function runGameGenerate(args, { cacheDir, remoteUrl, onProgress = () => {
             render: summary.render,
             flags: summary.flags,
             features: summary.features,
+            theme: summary.theme,
             warnings: summary.warnings,
             nextSteps: NEXT_STEPS_GAME
         };
         const text = [
             `Generated ${value.projectName} at ${target}`,
             `Template: ${source.repo}@${source.ref} (${String(source.commit).slice(0, 7)})`,
+            ...(result.theme ? [`Theme: ${result.theme.family} (${result.theme.fontPair})`] : []),
             ...result.warnings.map((w) => `Warning: ${w}`),
             'Next steps:', ...NEXT_STEPS_GAME.map((s) => `- ${s}`)
         ].join('\n');
@@ -75,4 +77,21 @@ async function runGameGenerate(args, { cacheDir, remoteUrl, onProgress = () => {
     }
 }
 
-module.exports = { runGameGenerate, NEXT_STEPS_GAME };
+// game_describe with the pinned template's theme families (fetched into the cache on first use).
+// A template that cannot be fetched or read still describes the generator: no families, and why.
+async function runGameDescribe({ cacheDir, remoteUrl } = {}) {
+    let themes = null;
+    let unavailable = null;
+    try {
+        const cache = await core.templateCache.ensure({ ...core.pins.game, cacheDir, remoteUrl });
+        themes = await core.game.readThemes(cache.dir);
+    } catch (err) {
+        if (!(err instanceof core.TemplateFetchError || err instanceof TypeError || err instanceof core.game.ThemesFileError)) throw err;
+        unavailable = `Theme families unavailable: ${err.message}`;
+    }
+    const facts = core.game.describeGame({ themes });
+    if (unavailable) facts.themes.unavailable = unavailable;
+    return { content: [{ type: 'text', text: JSON.stringify(facts, null, 2) }], structuredContent: facts };
+}
+
+module.exports = { runGameGenerate, runGameDescribe, NEXT_STEPS_GAME };

package/src/server.js

@@ -7,7 +7,7 @@ const core = require('@cmpose/core');
 const pkg = require('../package.json');
 const { describe } = require('./describe');
 const { runGenerate } = require('./generate');
-const { runGameGenerate } = require('./gameGenerate');
+const { runGameGenerate, runGameDescribe } = require('./gameGenerate');
 const { runBackendGenerate } = require('./backendGenerate');
 
 const GENERATE_DESCRIPTION = 'Generate a Compose Multiplatform (Android + iOS) project on this machine. ' +
@@ -17,6 +17,11 @@ const GENERATE_DESCRIPTION = 'Generate a Compose Multiplatform (Android + iOS) p
 const GAME_GENERATE_DESCRIPTION = 'Generate a Unity 6 (Android + iOS) mobile game project on this machine. ' +
     'Call game_describe first for the flags, defaults and validation rules. ' +
     'showcase has every flag on; flags and features apply to blank only. ' +
+    'theme picks one of the style families game_describe lists under themes (palette, shapes, motion, fonts; ' +
+    'match the family whose suits fits the game) and optionally a fontPair of that family. primary and accent ' +
+    '(#RRGGBB) recolour the family: their lightness is shifted until text and buttons keep their contrast, and a ' +
+    'colour that still cannot pass falls back to the family default with a warning. Without theme the template ' +
+    'default family (clean) is used. ' +
     'Writes <outputDir>/<projectName>; never overwrites an existing non-empty folder.';
 
 const BACKEND_GENERATE_DESCRIPTION = 'Generate a standalone Kotlin/Ktor backend (Docker-ready) on this machine. ' +
@@ -70,12 +75,9 @@ function createServer({ cacheDir, remoteUrl, backendTemplateDir = process.env.CM
     }));
 
     server.registerTool('game_describe', {
-        description: 'Describe the Unity game generator: engine and editor version, template types, renders, flags and their dependencies, ID groups, defaults, validation limits and the pinned game template.',
+        description: 'Describe the Unity game generator: engine and editor version, template types, renders, flags and their dependencies, ID groups, defaults, validation limits, the pinned game template and its theme families (themes: default, and each family\'s id, title, suits and fontPairs).',
         inputSchema: {}
-    }, async () => {
-        const facts = core.game.describeGame();
-        return { content: [{ type: 'text', text: JSON.stringify(facts, null, 2) }], structuredContent: facts };
-    });
+    }, async () => runGameDescribe({ cacheDir, remoteUrl }));
 
     server.registerTool('game_generate', {
         description: GAME_GENERATE_DESCRIPTION,
@@ -96,6 +98,14 @@ function createServer({ cacheDir, remoteUrl, backendTemplateDir = process.env.CM
             ids: z.record(z.string(), z.record(z.string(), z.string())).optional()
                 .describe('Real IDs by group (admob, revenueCat, gameServices; fields in game_describe), each needing its flag. ' +
                     'A group left out keeps the test IDs / placeholders, reported as a warning'),
+            // passthrough: unknown fields reach validateGame, which refuses them by name
+            theme: z.object({
+                family: z.string().optional().describe('A family id from game_describe themes.families (default: themes.default)'),
+                primary: z.string().optional().describe('#RRGGBB primary colour; lightness is adjusted to keep contrast'),
+                accent: z.string().optional().describe('#RRGGBB accent colour; lightness is adjusted to keep contrast'),
+                fontPair: z.string().optional().describe("One of the family's fontPairs (default: its first)")
+            }).passthrough().optional()
+                .describe('Style family and optional colour shifts; without it the template default family is used'),
             templateRef: z.string().optional().describe('Override the pinned game template tag')
         }
     }, async (args, extra) => runGameGenerate(args, {