@utopia-studio-design/design-system-cli 0.2.0 → 0.3.0

package/bin/utopia-ds.mjs

@@ -4,7 +4,7 @@ import { dirname, join, resolve } from 'node:path'
 import { spawn } from 'node:child_process'
 import {
   capabilityManifest, envelope, getComponent, getDoc, getTemplate, getTheme,
-  listComponents, listDocs, listTemplates, listThemes, repositoryDoctor, search,
+  listComponents, listDocs, listTemplates, listThemes, mcpLaunch, repositoryDoctor, search,
 } from '../lib/api.mjs'
 
 const args = process.argv.slice(2)
@@ -166,7 +166,7 @@ function init() {
   write(join(target, '.cursor/rules/ceramic-design-system.mdc'), `---\ndescription: Ceramic Design System rules\nalwaysApply: true\n---\n\n${rules}`)
   write(join(target, '.github/copilot-instructions.md'), rules)
   write(join(target, '.ceramic/config.json'), `${JSON.stringify({ apiVersion: 1, theme, arabicFriendly: true, source: '@utopia-studio-design/design-system' }, null, 2)}\n`)
-  write(join(target, '.mcp.json'), `${JSON.stringify({ mcpServers: { ceramic: { command: 'npx', args: ['-y', '@utopia-studio-design/design-system-cli', 'mcp'] } } }, null, 2)}\n`)
+  write(join(target, '.mcp.json'), `${JSON.stringify({ mcpServers: { ceramic: mcpLaunch } }, null, 2)}\n`)
   output('init-result', { ok: true, target, theme, files: ['AGENTS.md', 'CLAUDE.md', '.cursor/rules/ceramic-design-system.mdc', '.github/copilot-instructions.md', '.ceramic/config.json', '.mcp.json'] },
     (data) => `Ceramic initialized in ${data.target}.\nCreated ${data.files.join(', ')}.`)
 }
@@ -207,10 +207,10 @@ function copyTemplateProject(entry) {
   const workspaceCli = resolve(process.cwd(), 'packages/design-system-cli')
   const designSystemDependency = existsSync(join(workspacePackage, 'package.json'))
     ? `file:${workspacePackage}`
-    : '^0.2.0'
+    : '^0.3.0'
   const cliDependency = existsSync(join(workspaceCli, 'package.json'))
     ? `file:${workspaceCli}`
-    : '^0.2.0'
+    : '^0.3.0'
   write(join(target, 'package.json'), `${JSON.stringify({
     name: packageName,
     private: true,

package/data/docs/ai-platform-plan.md

@@ -37,7 +37,7 @@ Every authoring command must support `--json`, `--dry-run`, deterministic output
 The generated `.mcp.json` works for clients that support project-local MCP configuration. Codex CLI can register the same stdio server explicitly:
 
 ```sh
-codex mcp add ceramic -- npx -y @utopia-studio-design/design-system-cli mcp
+codex mcp add ceramic -- npx -y --package @utopia-studio-design/design-system-cli utopia-ds mcp
 ```
 
 The server exposes read-only design-system discovery. File-writing operations remain CLI commands with dry-run and explicit user control.

package/data/docs/quick-start-ai.md

@@ -88,7 +88,7 @@ The MCP server exposes the same API as the CLI. A generated `.mcp.json` uses:
   "mcpServers": {
     "ceramic": {
       "command": "npx",
-      "args": ["-y", "@utopia-studio-design/design-system-cli", "mcp"]
+      "args": ["-y", "--package", "@utopia-studio-design/design-system-cli", "utopia-ds", "mcp"]
     }
   }
 }

package/data/manifests/catalog.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://utopia-studio.co/design-system/catalog.schema.json",
   "name": "Utopia Design System Catalog",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "purpose": "Standalone source of truth for the Utopia Design System home, docs, component catalog, templates, themes, and AI agent workflow.",
   "topLevelAreas": [
     {
@@ -13,8 +13,9 @@
           "id": "guide",
           "label": "Guide",
           "items": [
-            "Getting Started",
-            "Quick Start with AI",
+          "Getting Started",
+          "MCP Playground",
+          "Quick Start with AI",
             "Working with AI",
             "Principles",
             "Theme System",

package/data/manifests/theme-utopia-default.json

@@ -52,7 +52,7 @@
   "semanticMappings": {
     "--background": "Special Black",
     "--foreground": "White",
-    "--primary": "Brick Red",
+    "--primary": "Accessible Brick Red action tone (#B8472C); preserve #CC5536 as the brand primitive",
     "--secondary": "Light Grey",
     "--radius-control": "Square geometry",
     "--radius-surface": "Square geometry",

package/data/manifests/themes.json

@@ -126,7 +126,7 @@
         "--foreground": "#FFFFFF",
         "--card": "#FFFFFF",
         "--card-foreground": "#3C3235",
-        "--primary": "#CC5536",
+        "--primary": "#B8472C",
         "--primary-foreground": "#FFFFFF",
         "--secondary": "#EEEEEE",
         "--secondary-foreground": "#3C3235",
@@ -134,7 +134,7 @@
         "--muted-foreground": "#BDB7B9",
         "--border": "rgba(255,255,255,0.18)",
         "--input": "rgba(255,255,255,0.24)",
-        "--ring": "#CC5536",
+        "--ring": "#D77A59",
         "--radius": "0px",
         "--radius-control": "0px",
         "--radius-surface": "0px",

package/lib/api.mjs

@@ -8,7 +8,11 @@ const packagedDataRoot = join(packageRoot, 'data')
 const hasWorkspaceSource = existsSync(join(workspaceRoot, 'packages/design-system/src/manifests/components.json'))
 
 export const apiVersion = 1
-export const cliVersion = '0.2.0'
+export const cliVersion = '0.3.0'
+export const mcpLaunch = {
+  command: 'npx',
+  args: ['-y', '--package', '@utopia-studio-design/design-system-cli', 'utopia-ds', 'mcp'],
+}
 
 export function paths(root = hasWorkspaceSource ? workspaceRoot : packagedDataRoot) {
   return {
@@ -118,8 +122,7 @@ export function capabilityManifest() {
       { name: 'mcp', args: [], flags: [], responseType: 'stdio-server' },
     ],
     mcp: {
-      command: 'npx',
-      args: ['-y', '@utopia-studio-design/design-system-cli', 'mcp'],
+      ...mcpLaunch,
       tools: ['search', 'list_components', 'get_component', 'list_templates', 'get_template', 'list_themes', 'get_theme', 'list_docs', 'get_docs', 'doctor'],
     },
   }
@@ -139,7 +142,10 @@ export function repositoryDoctor() {
       components: listComponents().length,
       templates: listTemplates().length,
       themes: listThemes().length,
-      mcp: existsSync(join(packageRoot, 'bin/utopia-ds-mcp.mjs')),
+      mcp: existsSync(join(packageRoot, 'bin/utopia-ds-mcp.mjs'))
+        && mcpLaunch.command === 'npx'
+        && mcpLaunch.args.includes('utopia-ds')
+        && mcpLaunch.args.at(-1) === 'mcp',
     },
     missing,
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utopia-studio-design/design-system-cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "AI-readable CLI and MCP server for Ceramic Design System",
   "type": "module",
   "license": "MIT",
@@ -13,11 +13,20 @@
     "./api": "./lib/api.mjs",
     "./mcp": "./bin/utopia-ds-mcp.mjs"
   },
-  "files": ["bin", "lib", "data", "README.md"],
+  "files": [
+    "bin",
+    "lib",
+    "data",
+    "README.md"
+  ],
   "scripts": {
     "sync-data": "node scripts/sync-data.mjs",
     "prepack": "npm run sync-data"
   },
-  "publishConfig": { "access": "public" },
-  "engines": { "node": ">=20" }
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  }
 }