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

package/README.md

@@ -1,46 +1,17 @@
-# @utopia-studio-design/design-system-cli
+# Ceramic Design System CLI
 
-CLI for installing, inspecting, and validating the Utopia Studio design system. The CLI doubles as an AI-agent entrypoint: it creates agent docs, prints token data, installs component templates, and checks whether component manifests include the props, anatomy, states, slots, examples, and agent contract fields required for safe UI generation.
+The same structured API powers terminal output, JSON automation, generated agent instructions, and the stdio MCP server.
 
 ```sh
-npx @utopia-studio-design/design-system-cli init
-npx @utopia-studio-design/design-system-cli add button
-npx @utopia-studio-design/design-system-cli tokens
-npx @utopia-studio-design/design-system-cli agent-docs
-npx @utopia-studio-design/design-system-cli doctor
+npm install -D @utopia-studio-design/design-system-cli
+npx utopia-ds init
+npx utopia-ds search "Arabic data table" --json
+npx utopia-ds component DataTable --json
+npx utopia-ds template template-saas-solution-homepage --copy ./saas-website
+npx utopia-ds template template-saas-solution-homepage --theme dextrum --copy ./dextrum-website
+npx utopia-ds theme create nova
+npx utopia-ds manifest --json
+npx utopia-ds mcp
 ```
 
-The binary name is `utopia-ds`.
-
-## Doctor Checks
-
-`utopia-ds doctor` verifies dependencies, CSS tokens, square-radius compliance, component manifest completeness, component `agentContract` completeness, theme manifest completeness, source-example docs, and the AI entrypoint:
-
-AI docs checks:
-
-- `docs/design-system/examples.md`
-- `public/llms.txt` references `docs/design-system/examples.md`
-
-Component checks:
-
-- `props`
-- `anatomy`
-- `states`
-- `slots`
-- `examples`
-- `aiRules`
-
-Agent contract checks:
-
-- `useWhen`
-- `avoidWhen`
-- `fallbackToShadcn`
-- `requiredTokens`
-- `neverInvent`
-- `validationChecklist`
-
-Theme checks:
-
-- `defaultTheme`
-- `semanticRoles`
-- default theme values for every semantic role
+Programmatic consumers can import `@utopia-studio-design/design-system-cli/api`.

package/bin/utopia-ds-mcp.mjs

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import {
+  capabilityManifest, getComponent, getDoc, getTemplate, getTheme,
+  listComponents, listDocs, listTemplates, listThemes, repositoryDoctor, search,
+} from '../lib/api.mjs'
+
+const tools = [
+  ['search', 'Search components, docs, templates, and themes.', { query: { type: 'string' } }, ({ query }) => search(query)],
+  ['list_components', 'List every Ceramic component contract.', {}, () => listComponents()],
+  ['get_component', 'Get one component including imports, tokens, usage, and Arabic rules.', { name: { type: 'string' } }, ({ name }) => getComponent(name)],
+  ['list_templates', 'List Ceramic starter templates.', {}, () => listTemplates()],
+  ['get_template', 'Get a template contract and sections.', { id: { type: 'string' } }, ({ id }) => getTemplate(id)],
+  ['list_themes', 'List themes that implement the semantic contract.', {}, () => listThemes()],
+  ['get_theme', 'Get a theme policy and semantic mappings.', { id: { type: 'string' } }, ({ id }) => getTheme(id)],
+  ['list_docs', 'List AI-readable design-system documents.', {}, () => listDocs()],
+  ['get_docs', 'Read one design-system document.', { topic: { type: 'string' } }, ({ topic }) => getDoc(topic)],
+  ['doctor', 'Validate the Ceramic source of truth.', {}, () => repositoryDoctor()],
+]
+
+function reply(id, result) {
+  process.stdout.write(`${JSON.stringify({ jsonrpc: '2.0', id, result })}\n`)
+}
+
+function error(id, code, message) {
+  process.stdout.write(`${JSON.stringify({ jsonrpc: '2.0', id, error: { code, message } })}\n`)
+}
+
+let buffer = ''
+process.stdin.setEncoding('utf8')
+process.stdin.on('data', (chunk) => {
+  buffer += chunk
+  let index
+  while ((index = buffer.indexOf('\n')) >= 0) {
+    const line = buffer.slice(0, index).trim()
+    buffer = buffer.slice(index + 1)
+    if (!line) continue
+    try {
+      const request = JSON.parse(line)
+      if (request.method === 'initialize') reply(request.id, { protocolVersion: '2025-03-26', capabilities: { tools: {} }, serverInfo: { name: 'ceramic-design-system', version: capabilityManifest().version } })
+      else if (request.method === 'notifications/initialized') continue
+      else if (request.method === 'ping') reply(request.id, {})
+      else if (request.method === 'tools/list') reply(request.id, { tools: tools.map(([name, description, properties]) => ({ name, description, inputSchema: { type: 'object', properties, required: Object.keys(properties) } })) })
+      else if (request.method === 'tools/call') {
+        const tool = tools.find(([name]) => name === request.params?.name)
+        if (!tool) error(request.id, -32602, `Unknown tool ${request.params?.name}`)
+        else {
+          const data = tool[3](request.params?.arguments ?? {})
+          reply(request.id, { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], structuredContent: data, isError: data == null })
+        }
+      } else error(request.id, -32601, `Method not found: ${request.method}`)
+    } catch (cause) {
+      error(null, -32700, cause instanceof Error ? cause.message : 'Parse error')
+    }
+  }
+})