@utopia-studio-design/design-system-cli 0.8.2 → 0.8.3

package/data/docs/ux-pattern-publish-2026-09-13.md

@@ -20,3 +20,12 @@ allowance was exhausted. No Rams score is claimed.
 
 Production authentication/backend environment settings are preserved. This
 release does not deploy Convex or include unrelated local room/auth changes.
+
+## Concurrent release reconciliation
+
+A separate Brandbook task published CLI 0.8.1 during this release without the
+UX APIs. CLI 0.8.2 combines both releases: all UX APIs and source bundles,
+Brandbook validation, and version-pinned generated MCP launch configuration.
+CLI tests passed again; public 0.8.2 tarball verification covers UX discovery,
+Brandbook tool retention and validation, all 59 examples, and nine templates.
+Final versions: design-system 0.11.0, design-system-cli 0.8.2.

package/lib/api.mjs

@@ -1,4 +1,5 @@
 import { existsSync, readFileSync, readdirSync } from 'node:fs'
+import { execFileSync } from 'node:child_process'
 import { dirname, join, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import {
@@ -22,6 +23,34 @@ export const mcpLaunch = {
   args: ['-y', '--package', `${packageMetadata.name}@${cliVersion}`, 'utopia-ds', 'mcp'],
 }
 
+let registryVersionCache
+
+function compareVersions(left, right) {
+  const a = String(left).split('.').map(Number)
+  const b = String(right).split('.').map(Number)
+  for (let index = 0; index < Math.max(a.length, b.length); index += 1) {
+    if ((a[index] || 0) !== (b[index] || 0)) return (a[index] || 0) - (b[index] || 0)
+  }
+  return 0
+}
+
+function registryVersionStatus() {
+  if (registryVersionCache) return registryVersionCache
+  try {
+    const output = execFileSync('npm', ['view', packageMetadata.name, 'dist-tags.latest', '--json'], {
+      encoding: 'utf8',
+      timeout: 5000,
+      stdio: ['ignore', 'pipe', 'ignore'],
+    }).trim()
+    const latest = JSON.parse(output)
+    const upToDate = compareVersions(cliVersion, latest) >= 0
+    registryVersionCache = { current: cliVersion, latest, upToDate, checked: true }
+  } catch {
+    registryVersionCache = { current: cliVersion, latest: null, upToDate: null, checked: false }
+  }
+  return registryVersionCache
+}
+
 export function paths(root = hasWorkspaceSource ? workspaceRoot : packagedDataRoot) {
   return {
     root,
@@ -467,6 +496,7 @@ export function capabilityManifest() {
 }
 
 export function repositoryDoctor() {
+  const registry = registryVersionStatus()
   const required = [
     'catalog.json', 'components.json', 'blocks.json', 'composition-registry.json', 'templates.json', 'themes.json', 'motion-profiles.json', 'logo-skills.json', 'ux-patterns.json', 'brandbook-skill.json',
   ].map((name) => join(paths().manifests, name))
@@ -515,7 +545,14 @@ export function repositoryDoctor() {
         && mcpLaunch.command === 'npx'
         && mcpLaunch.args.includes('utopia-ds')
         && mcpLaunch.args.at(-1) === 'mcp',
+      cliVersion: registry.current,
+      registryLatest: registry.latest,
+      cliUpToDate: registry.upToDate,
     },
     missing: [...missing, ...contractIssues],
+    warnings: [
+      ...(!registry.checked ? [{ code: 'REGISTRY_CHECK_UNAVAILABLE', message: 'Could not read the npm registry latest tag; verify the pinned MCP package version manually.' }] : []),
+      ...(registry.checked && !registry.upToDate ? [{ code: 'CLI_OUTDATED', message: `Ceramic CLI ${registry.current} is older than npm latest ${registry.latest}. Update the project MCP package pin and restart the client.` }] : []),
+    ],
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utopia-studio-design/design-system-cli",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "description": "AI-readable CLI and MCP server for Ceramic Design System",
   "ceramic": {
     "designSystem": "^0.11.0"