@utopia-studio-design/design-system-cli 0.7.1 → 0.7.2

package/bin/utopia-ds-mcp.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import {
-  capabilityManifest, getBlock, getBlockDefinition, getComponent, getDoc, getLogoSkill, getMotionProfile, getRoomContext, getTemplate, getTheme,
+  capabilityManifest, getBlock, getBlockDefinition, getBrandbookSkill, getComponent, getDoc, getLogoSkill, getMotionProfile, getRoomContext, getTemplate, getTheme,
   listBlockDefinitions, listBlocks, listComponents, listDocs, listLogoSkills, listMotionProfiles, listTemplates, listThemes, prepareLogoMakerRun,
-  repositoryDoctor, search, validateAgentMutation, validateLayout,
+  prepareBrandbookRun, repositoryDoctor, search, validateAgentMutation, validateLayout,
 } from '../lib/api.mjs'
 
 const tools = [
@@ -25,6 +25,8 @@ const tools = [
   ['list_logo_skills', 'List the established Logo Maker skill structures and their governed guidance.', {}, () => listLogoSkills()],
   ['get_logo_skill', 'Read one Logo Maker skill contract by id or name.', { id: { type: 'string' } }, ({ id }) => getLogoSkill(id)],
   ['prepare_logo_maker_run', 'Prepare a Brand Room-aware Logo Maker chat run using the same skill contract as Ceramic UI. This does not approve or publish the result.', { skillId: { type: 'string' }, brandName: { type: 'string' }, brief: { type: 'string' }, referenceIds: { type: 'array', items: { type: 'string' }, maxItems: 3 } }, (input) => prepareLogoMakerRun(input)],
+  ['get_brandbook_skill', 'Read the Ceramic Brandbook workflow, GitHub source contract, provider rule, and Solution application rules.', {}, () => getBrandbookSkill()],
+  ['prepare_brandbook_run', 'Prepare a Brand Room-aware Ceramic Brandbook run. Returns the required A/B/C direction phase and one-BRAND.md handoff prompt; it does not generate, save, or publish a release.', { brandName: { type: 'string' }, brief: { type: 'string', minLength: 12, maxLength: 4000 } }, (input) => prepareBrandbookRun(input)],
   ['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()],

package/data/docs/ceramic-release-2026-09-06.md

@@ -9,3 +9,5 @@ Development validation: Vitest 13 files / 79 tests passed; CLI generation and MC
 Rams quick_review was attempted but the workspace review credits were exhausted. The pre-commit review_files attempt failed at the provider transport; no score was obtained.
 
 This release does not mark independent QA reports closed. Server Designer Agent activation remains disabled under the existing production configuration.
+
+Published: `@utopia-studio-design/design-system@0.9.1` and `@utopia-studio-design/design-system-cli@0.7.1`. CLI 0.7.0 was superseded immediately after the public-tarball check detected an omitted standalone runtime. The 0.7.1 package bundles that runtime directly. All nine public template generation commands, route/page counts and documented tokens pass. The Chat Workspace consumer installs exclusively from npm and builds successfully. Merge integration auth/footer checks: 8 passed.

package/data/docs/create-a-brandbook.md

@@ -0,0 +1,79 @@
+# Create a Brandbook
+
+Create the brandbook before authoring a Ceramic theme. The brandbook turns a brief, optional logo, references, and existing imagery into one governed `BRAND.md`. That file becomes the input for semantic color, typography, imagery, motion, Marketing, and Solution decisions in the design system.
+
+## Connect the GitHub skill
+
+Connect Ceramic MCP first. Then call `get_brandbook_skill`. The response identifies the canonical GitHub repository, approved branch, pinned revision, and `SKILL.md` path. Resolve that exact source before starting the workflow. Private repository access uses the active GitHub account; do not place access tokens in prompts or project files.
+
+```text
+get_brandbook_skill {}
+```
+
+```bash
+git clone --branch main https://github.com/The-Utopia-Studio/Ceramic-Brandbook.git
+```
+
+The source of truth is `skills/ceramic-brandbook/SKILL.md` in that repository. The MCP response pins a reviewed commit so an agent does not silently use a different workflow.
+
+## Prepare the direction session
+
+Call `prepare_brandbook_run` with a brand name and useful brief. A logo is optional. Include the audience, offer, character, constraints, existing assets, required locales, and intended Marketing or Solution uses when they are known.
+
+```json
+{
+  "name": "prepare_brandbook_run",
+  "arguments": {
+    "brandName": "Your brand",
+    "brief": "Audience, offer, character, constraints, and desired outcome"
+  }
+}
+```
+
+This call prepares work; it does not generate, save, or publish a release.
+
+## Present A, B, and C
+
+Before producing a final brandbook, present exactly three materially different directions labeled A, B, and C. Each direction must compare:
+
+- positioning and verbal character;
+- Latin and Arabic typography;
+- semantic color architecture;
+- photographic subject, light, composition, and treatment;
+- Ceramic motion personality;
+- Marketing expression and example assets;
+- Solution or product expression and example applications;
+- fit, risk, and tradeoff.
+
+The user chooses one direction. Refine it with the user until its palette, type, imagery, motion, and application choices are clear. Do not build or save the final brandbook before this refinement is complete.
+
+## Produce one `BRAND.md`
+
+The approved brandbook has one editorial source:
+
+```text
+BRAND.md
+assets/manifest.json
+assets/generated/
+validation.json
+```
+
+`BRAND.md` must define strategy, voice, logo rules, semantic color roles, Latin and Arabic type, layout, photography, motion, Marketing, Solution, accessibility, and implementation guidance. English and Arabic must have equal content coverage, visual hierarchy, and usable LTR/RTL behavior unless the user explicitly changes the locale scope.
+
+Use the active chat's native image generator by default. Record the provider, prompt or operation, source assets, and generated output in the asset manifest. Provider choice stays outside the brand contract so the same workflow can run in ChatGPT, another capable client, or a named external provider.
+
+For Solution, choose one to three applications from phone, desktop, and environment according to the brand and available assets. Generate a dedicated scene for every photographic desktop or environment mockup. Place the resulting mockups directly on the semantic brand canvas without generic backing panels, white or translucent plates, or explanatory text over the image.
+
+## Validate and hand off
+
+Validate the source and built release, then save the versioned bundle in the brand's Brand Room. The approved `BRAND.md` becomes the only brandbook input to **Create a Theme**. The theme maps its decisions to Ceramic semantic roles; it does not reinterpret the chosen direction.
+
+Release checks:
+
+- GitHub repository, branch, revision, and skill path are recorded.
+- The selected A/B/C direction and refinement decision are recorded.
+- English and Arabic content and visuals have parity.
+- Image provenance and rights metadata are present.
+- Marketing and Solution applications reflect the selected direction.
+- Brandbook validation passes before theme authoring begins.
+

package/data/docs/dextrum-document-family.md

@@ -0,0 +1,47 @@
+# Dextrum: v2 product theme and 07 Sep document ruling
+
+## Ownership and precedence
+
+Product surfaces use Ceramic's Dextrum v2 two-mode contract: neutral charcoal Dark (default) and cool-neutral Light. Documents, decks and one-pagers follow the frozen 07 Sep 2026 document rulings until superseded. HTML is a delivery format; an HTML presentation retains the document ruling and its animation/accessibility requirements. Animated HTML remains the default output. PPTX/PDF require an explicit request.
+
+The owner-supplied exemplar is `2026-09-07_dextrum_onepager-totalenergies-tier1-v1_1.pptx`. Its slide XML confirms light blue `#C9E0F5` strips and steel-blue `#5B87AD` bands. Client-specific text and logos in that file are not reusable brand-kit content. The file is not redistributed with the package.
+
+## Shared document-family contract
+
+Core registers `venture-document` and these opt-in composition slots. Every venture may map the same semantic roles through its theme, without adopting Dextrum colors.
+
+| Slot | Dextrum document treatment |
+| --- | --- |
+| `.uds-document-strip` | Light blue `#C9E0F5`, ink `#192B39` text |
+| `.uds-document-eyebrow` | Ocean Blue `#3E8ECC` accent |
+| `.uds-document-chip` | White background, ink text |
+| `.uds-document-band` | Steel blue `#5B87AD`, white text |
+| `.uds-document-logo-container` | Separate white rounded container; existing surface radius and spacing tokens |
+
+Use `--document-*` roles registered in `theme-dextrum.json` and mapped in `dextrum.css`. These roles are independent of product light/dark mode. The rounded geometry uses the existing surface contract; no exact numeric corner radius was specified in the owner's ruling.
+
+`logo-on-band` is approved for both identity marks on document bands. Keep each transparent logo unchanged inside its separate white rounded container. Do not recolor, distort or bake a background into an SVG. Generic no-backing guidance continues to reject unregistered treatments on product surfaces; it must not reject this explicitly approved document treatment.
+
+## Identity custody
+
+Canonical source: owner-supplied `dextrum-jamal-brand-kit.zip`, not a recreated repository mark. BLUE v2, TEAL BLUE, GREY and BLUE v2 with tagline are mirrored byte for byte:
+
+- Web: `public/brand/dextrum/{blue-v2,teal,grey,tagline-blue-v2}.svg`
+- npm: `src/themes/assets/dextrum/` in the design-system package
+- `public/brand/dextrum-logo.svg` mirrors BLUE v2 exactly.
+- `ceramic.assets.json` beside the variants records source filenames and SHA-256 hashes.
+
+The original asset repository remains available for photography. Its identity guidance cannot override these owner-supplied canonical SVGs.
+
+## Retired v1 data
+
+The kit's 01 Sep `dextrum-design-language.md` uses historical `#192B39`/`#2F3F4C` structural surfaces. It is not the v2 product-token authority. `theme-dextrum.json` and `dextrum.css` already contained two modes; the stale `themes.json` summary still exposed v1 values. The summary now derives its default values from the v2 dark mapping, while the docs expose both modes and the document roles. `#192B39` remains legitimate brand ink in light mode and documents; it is not the product's dark canvas.
+
+## Validation (09 Sep 2026)
+
+- 28 targeted tests passed: v2 registry parity, docs token discovery, canonical SVG hashes, and localized presentation boundaries.
+- Design-system and app builds passed; semantic page ownership audit passed.
+- Chromium computed styles confirmed product backgrounds switch between `#F7F7F5` and `#0E1215` while document strips remain `#C9E0F5`, bands `#5B87AD`, and logo containers white.
+- npm pack dry-run includes all four canonical SVGs; CLI data regenerated from source.
+- Rams quick_review was requested but unavailable because the workspace's 30 review credits were exhausted.
+- This source update has not yet been published to npm or deployed to the production site.

package/data/docs/guide.md

@@ -6,6 +6,8 @@ Guide pages are the operating layer of Ceramic. They define how humans and AI ag
 
 - `Getting Started`: installation, theme CSS, first component, examples, CLI discovery, Arabic-friendly entrypoint.
 - `What's New`: release notes for package, manifest, theme, and docs changes.
+- `Connect MCP`: connect a supported agent to Ceramic's machine-readable contracts.
+- `Create a Brandbook`: resolve the reviewed GitHub skill, compare A/B/C directions, refine one with the user, and produce the single `BRAND.md` input for theme authoring.
 - `Create a Theme`: scaffold a theme, define brand primitives, map Ceramic semantic roles, document visual policy, and verify compatibility.
 - `Use Templates`: discover a reviewed starter, inspect its contract, copy it with a theme, connect product-owned data, and validate the standalone result.
 - `Arabic Friendly`: RTL-first layout, Arabic typography, mixed-script resilience, localization readiness, and icon/motion mirroring.

package/data/docs/presentation-asset-repository.md

@@ -51,3 +51,8 @@ assets when relevant. It does not force imagery into data or evidence slides,
 repeat one image as decoration, or mix an asset into a theme that is not listed.
 The final handoff records the repository path, commit SHA, crop or
 transformation, credit, license, and slide numbers for every used asset.
+
+
+## Venture document rulings
+
+Product surfaces remain Ceramic-owned. Documents, decks and one-pagers follow their venture’s approved document ruling; an HTML delivery format does not erase that boundary. Dextrum uses the [07 Sep document family](dextrum-document-family.md), including registered white rounded logo-on-band containers. Canonical transparent SVG variants are mirrored in `public/brand/dextrum/` and the design-system package. Preserve the requested output format.

package/data/manifests/brandbook-skill.json

@@ -0,0 +1,33 @@
+{
+  "version": 1,
+  "id": "ceramic-brandbook",
+  "name": "Ceramic Brandbook",
+  "repository": "https://github.com/The-Utopia-Studio/Ceramic-Brandbook",
+  "branch": "main",
+  "revision": "8b4e0fe9bbf33c0e9e2aee9a17d48b9e47d31108",
+  "skillPath": "skills/ceramic-brandbook/SKILL.md",
+  "sourceDocument": "BRAND.md",
+  "workflow": [
+    "read-room-context-and-assets",
+    "present-three-directions-a-b-c",
+    "refine-selected-direction-with-user",
+    "write-one-brand-md",
+    "produce-or-register-assets",
+    "validate-and-build",
+    "save-versioned-room-bundle"
+  ],
+  "rules": {
+    "logoOptional": true,
+    "requiredDirectionCount": 3,
+    "defaultLocales": ["en", "ar"],
+    "imageProvider": "Use the active chat's native image generator by default. Use another provider only when the user names it or the operation requires it.",
+    "solution": {
+      "minimumShowcases": 1,
+      "maximumShowcases": 3,
+      "types": ["phone", "desktop", "environment"],
+      "selection": "Choose only applications that fit the brand and supplied assets.",
+      "imagery": "Generate a dedicated scene for every photographic desktop or environment application with the active image skill; do not reuse general brand photography.",
+      "presentation": "Place mockups directly on the semantic brand canvas. Do not add generic backing panels or caption overlays."
+    }
+  }
+}

package/data/manifests/catalog.json

@@ -16,6 +16,7 @@
             "Getting Started",
             "What's New",
             "Connect MCP",
+            "Create a Brandbook",
             "Create a Theme",
             "Create a Logo",
             "Use Templates",

package/data/manifests/patterns.json

@@ -313,6 +313,34 @@
         "touch controls"
       ],
       "rtl": "Placement uses logical reading order while registered column and span values remain deterministic."
+    },
+    {
+      "id": "venture-document",
+      "title": "Venture document family and logo-on-band",
+      "source": "packages/design-system/src/core.css",
+      "contract": "Documents, decks and one-pagers use the venture document ruling. Product surfaces retain the product theme. An explicit approved logo-on-band treatment permits separate rounded containers without changing transparent logo geometry. HTML decks retain their delivery/motion contract while using the document-family visual ruling.",
+      "slots": [
+        "uds-document-strip",
+        "uds-document-eyebrow",
+        "uds-document-chip",
+        "uds-document-band",
+        "uds-document-logo-container"
+      ],
+      "tokens": [
+        "--document-strip-background",
+        "--document-strip-foreground",
+        "--document-eyebrow-foreground",
+        "--document-chip-background",
+        "--document-chip-foreground",
+        "--document-band-background",
+        "--document-band-foreground",
+        "--document-logo-container-background",
+        "--document-logo-container-radius"
+      ],
+      "states": [
+        "document",
+        "logo-on-band"
+      ]
     }
   ]
 }

package/data/manifests/theme-dextrum.json

@@ -12,12 +12,42 @@
   "motionProfile": "swift",
   "brandPrimitives": {
     "colors": {
-      "darkBlue": { "value": "#192B39", "token": "--dx-brand-dark-blue", "immutable": true, "use": "Light text and structural brand surfaces" },
-      "oceanBlue": { "value": "#3E8ECC", "token": "--dx-brand-ocean-blue", "immutable": true, "use": "Dark primary actions, links, focus, and current navigation" },
-      "oceanHover": { "value": "#4A9AD4", "token": "--dx-brand-ocean-hover", "immutable": true, "use": "Dark primary hover" },
-      "oceanDeep": { "value": "#26689A", "token": "--dx-brand-ocean-deep", "immutable": true, "use": "Light primary and Dark primary active" },
-      "logoTeal": { "value": "#063946", "token": "--dx-brand-logo-teal", "immutable": true, "use": "Logo and explicit brand expression only" },
-      "timidWhite": { "value": "#EAEAEA", "token": "--dx-brand-timid-white", "immutable": true, "use": "Dark foreground" },
+      "darkBlue": {
+        "value": "#192B39",
+        "token": "--dx-brand-dark-blue",
+        "immutable": true,
+        "use": "Light text and structural brand surfaces"
+      },
+      "oceanBlue": {
+        "value": "#3E8ECC",
+        "token": "--dx-brand-ocean-blue",
+        "immutable": true,
+        "use": "Dark primary actions, links, focus, and current navigation"
+      },
+      "oceanHover": {
+        "value": "#4A9AD4",
+        "token": "--dx-brand-ocean-hover",
+        "immutable": true,
+        "use": "Dark primary hover"
+      },
+      "oceanDeep": {
+        "value": "#26689A",
+        "token": "--dx-brand-ocean-deep",
+        "immutable": true,
+        "use": "Light primary and Dark primary active"
+      },
+      "logoTeal": {
+        "value": "#063946",
+        "token": "--dx-brand-logo-teal",
+        "immutable": true,
+        "use": "Logo and explicit brand expression only"
+      },
+      "timidWhite": {
+        "value": "#EAEAEA",
+        "token": "--dx-brand-timid-white",
+        "immutable": true,
+        "use": "Dark foreground"
+      },
       "charcoal950": "#0E1215",
       "charcoal925": "#11161A",
       "charcoal900": "#171C20",
@@ -45,12 +75,36 @@
       },
       "arabicFamily": "Readex Pro",
       "weights": {
-        "clashGrotesk": [300, 400, 500, 600, 700],
-        "satoshi": [400, 500, 700],
-        "manrope": [300, 400, 500, 600, 700, 800],
-        "jetBrainsMono": [400, 500, 600]
+        "clashGrotesk": [
+          300,
+          400,
+          500,
+          600,
+          700
+        ],
+        "satoshi": [
+          400,
+          500,
+          700
+        ],
+        "manrope": [
+          300,
+          400,
+          500,
+          600,
+          700,
+          800
+        ],
+        "jetBrainsMono": [
+          400,
+          500,
+          600
+        ]
       },
-      "arabicWeights": [300, 500],
+      "arabicWeights": [
+        300,
+        500
+      ],
       "headlineCasing": "sentence",
       "headlineTracking": "-0.03em to -0.05em",
       "arabicDisplayFamily": "Readex Pro",
@@ -153,14 +207,31 @@
     "--sidebar-width-collapsed": "Owned by core; remains 4rem"
   },
   "governanceStatus": {
-    "success": { "dark": "#79B98E", "light": "#3F7953" },
-    "warning": { "dark": "#D2A363", "light": "#916026" },
-    "critical": { "dark": "#C86E64", "light": "#A94F47" },
-    "surfaceAlpha": { "dark": "12%", "light": "9%" },
+    "success": {
+      "dark": "#79B98E",
+      "light": "#3F7953"
+    },
+    "warning": {
+      "dark": "#D2A363",
+      "light": "#916026"
+    },
+    "critical": {
+      "dark": "#C86E64",
+      "light": "#A94F47"
+    },
+    "surfaceAlpha": {
+      "dark": "12%",
+      "light": "9%"
+    },
     "rule": "Status colors communicate governance state only; never use them as decorative accents."
   },
   "visualPolicy": {
-    "tone": ["precise", "technical", "calm", "confident"],
+    "tone": [
+      "precise",
+      "technical",
+      "calm",
+      "confident"
+    ],
     "allow": [
       "neutral charcoal dark workspaces",
       "plain cool-neutral light canvases with white cards",
@@ -183,8 +254,16 @@
   "iconPolicy": {
     "system": "lucide",
     "description": "Dextrum uses standard Lucide icons in product UI and keeps the Dextrum mark for brand surfaces.",
-    "allow": ["lucide icons in components", "monochrome currentColor icons", "directional mirroring in RTL"],
-    "avoid": ["Utopia Phosphor icon policy", "emoji", "mixed icon families in one surface"],
+    "allow": [
+      "lucide icons in components",
+      "monochrome currentColor icons",
+      "directional mirroring in RTL"
+    ],
+    "avoid": [
+      "Utopia Phosphor icon policy",
+      "emoji",
+      "mixed icon families in one surface"
+    ],
     "coreNote": "Icon policy is theme-owned. Core components remain icon-system neutral."
   },
   "translations": {
@@ -193,7 +272,11 @@
       "iconPolicy": {
         "system": "Lucide",
         "description": "يستخدم Dextrum أيقونات Lucide القياسية داخل واجهة المنتج، مع إبقاء علامة Dextrum لأسطح العلامة.",
-        "allow": ["أيقونات Lucide في المكونات", "أيقونات أحادية بلون currentColor", "عكس الاتجاه في RTL"]
+        "allow": [
+          "أيقونات Lucide في المكونات",
+          "أيقونات أحادية بلون currentColor",
+          "عكس الاتجاه في RTL"
+        ]
       }
     }
   },
@@ -210,6 +293,34 @@
     "Use Manrope for Latin app UI, Satoshi for supporting labels, and JetBrains Mono for evidence identifiers.",
     "Use Clash Grotesk for explicit marketing display only.",
     "Keep Arabic on Readex Pro tokens (body 300, display 500).",
-    "Do not import Utopia brand primitives into Dextrum-themed surfaces."
-  ]
+    "Do not import Utopia brand primitives into Dextrum-themed surfaces.",
+    "For documents, decks and one-pagers, apply documentFamily before product surface or generic presentation defaults.",
+    "Use canonical BLUE v2, TEAL, GREY and tagline transparent SVG assets; the public logo mirrors BLUE v2 byte for byte."
+  ],
+  "revision": "v2",
+  "documentFamily": {
+    "id": "venture-document",
+    "rulingDate": "2026-09-07",
+    "exemplar": "2026-09-07_dextrum_onepager-totalenergies-tier1-v1_1.pptx",
+    "scope": [
+      "documents",
+      "decks",
+      "one-pagers"
+    ],
+    "tokens": {
+      "--document-strip-background": "#C9E0F5",
+      "--document-strip-foreground": "#192B39",
+      "--document-eyebrow-foreground": "#3E8ECC",
+      "--document-chip-background": "#FFFFFF",
+      "--document-chip-foreground": "#192B39",
+      "--document-band-background": "#5B87AD",
+      "--document-band-foreground": "#FFFFFF",
+      "--document-logo-container-background": "#FFFFFF",
+      "--document-logo-container-radius": "var(--radius-surface)"
+    },
+    "logoTreatment": "logo-on-band: preserve transparent logo assets inside separate white rounded containers behind both logos on colored bands. Never edit the mark.",
+    "precedence": "Product surfaces use Ceramic v2. Documents, decks and one-pagers follow the 07 Sep document rulings until superseded; HTML is a delivery format, not a reason to discard the document ruling.",
+    "identityManifest": "public/brand/dextrum/ceramic.assets.json",
+    "legacyNote": "The 01 Sep design-language document in the supplied kit is historical v1, not the current product token authority."
+  }
 }

package/data/manifests/themes.json

@@ -229,7 +229,7 @@
       ],
       "principles": [
         "calm technical hierarchy",
-        "blue-led product surfaces",
+        "neutral charcoal Dark and cool-neutral Light product surfaces",
         "Manrope product typography",
         "Lucide icon system"
       ],
@@ -237,7 +237,8 @@
         "kind": "logo",
         "src": "/brand/dextrum-logo.svg",
         "alt": "Dextrum",
-        "usage": "Use only on Dextrum-branded surfaces."
+        "usage": "Canonical owner-supplied BLUE v2 transparent SVG. Preserve aspect ratio and colors. Document logo-on-band permits separate white rounded containers behind both logos on colored bands; do not bake a background into the SVG.",
+        "presentationSrc": "/brand/dextrum/blue-v2.svg"
       },
       "translations": {
         "ar": {
@@ -262,18 +263,18 @@
       "iconSystem": "lucide",
       "motionProfile": "swift",
       "values": {
-        "--background": "#192B39",
+        "--background": "#0E1215",
         "--foreground": "#EAEAEA",
-        "--card": "#2F3F4C",
+        "--card": "#171C20",
         "--card-foreground": "#EAEAEA",
         "--primary": "#3E8ECC",
-        "--primary-foreground": "#EAEAEA",
-        "--secondary": "#2F3F4C",
+        "--primary-foreground": "#101619",
+        "--secondary": "#1B2126",
         "--secondary-foreground": "#EAEAEA",
-        "--muted": "#243746",
-        "--muted-foreground": "#9BA6AE",
-        "--border": "rgba(234,234,234,0.14)",
-        "--input": "rgba(234,234,234,0.20)",
+        "--muted": "#171C20",
+        "--muted-foreground": "#909BA2",
+        "--border": "rgb(238 240 241 / 10%)",
+        "--input": "rgb(238 240 241 / 15%)",
         "--ring": "#3E8ECC",
         "--loading-background": "#192B39",
         "--loading-accent": "#3E8ECC",
@@ -321,9 +322,55 @@
         "--sidebar-rail-size": "8px",
         "--button-height": "40px",
         "--card-padding": "24px",
-        "--overlay": "color-mix(in srgb, #192B39 84%, transparent)",
-        "--modal-surface": "#2F3F4C",
-        "--popover-surface": "#2F3F4C"
+        "--overlay": "rgb(5 8 10 / 78%)",
+        "--modal-surface": "#1B2126",
+        "--popover-surface": "#1B2126",
+        "--foreground-muted": "#ADB4B8",
+        "--foreground-subtle": "#7F898F",
+        "--popover": "#1B2126",
+        "--popover-foreground": "#EAEAEA",
+        "--primary-hover": "#4A9AD4",
+        "--primary-active": "#26689A",
+        "--accent": "#20272C",
+        "--accent-foreground": "#EAEAEA",
+        "--surface": "rgb(255 255 255 / 2.8%)",
+        "--surface-strong": "rgb(255 255 255 / 5%)",
+        "--surface-elevated": "#1B2126",
+        "--surface-hover": "rgb(255 255 255 / 7%)",
+        "--sidebar": "#11161A",
+        "--sidebar-foreground": "#EAEAEA",
+        "--sidebar-primary": "#3E8ECC",
+        "--sidebar-primary-foreground": "#101619",
+        "--sidebar-accent": "rgb(62 142 204 / 12%)",
+        "--sidebar-accent-foreground": "#EAEAEA",
+        "--sidebar-border": "rgb(238 240 241 / 8%)",
+        "--sidebar-ring": "#3E8ECC"
+      },
+      "revision": "v2",
+      "documentFamily": {
+        "id": "venture-document",
+        "rulingDate": "2026-09-07",
+        "exemplar": "2026-09-07_dextrum_onepager-totalenergies-tier1-v1_1.pptx",
+        "scope": [
+          "documents",
+          "decks",
+          "one-pagers"
+        ],
+        "tokens": {
+          "--document-strip-background": "#C9E0F5",
+          "--document-strip-foreground": "#192B39",
+          "--document-eyebrow-foreground": "#3E8ECC",
+          "--document-chip-background": "#FFFFFF",
+          "--document-chip-foreground": "#192B39",
+          "--document-band-background": "#5B87AD",
+          "--document-band-foreground": "#FFFFFF",
+          "--document-logo-container-background": "#FFFFFF",
+          "--document-logo-container-radius": "var(--radius-surface)"
+        },
+        "logoTreatment": "logo-on-band: preserve transparent logo assets inside separate white rounded containers behind both logos on colored bands. Never edit the mark.",
+        "precedence": "Product surfaces use Ceramic v2. Documents, decks and one-pagers follow the 07 Sep document rulings until superseded; HTML is a delivery format, not a reason to discard the document ruling.",
+        "identityManifest": "public/brand/dextrum/ceramic.assets.json",
+        "legacyNote": "The 01 Sep design-language document in the supplied kit is historical v1, not the current product token authority."
       }
     },
     {
@@ -334,29 +381,107 @@
       "role": "Visual theme",
       "description": "Black-and-white theme with a spectral accent.",
       "motionProfile": "swift",
-      "bestFor": ["AI products", "Creative tools"],
-      "principles": ["monochrome first", "spectral color with purpose", "crisp geometry", "fast direct feedback", "accessible color-independent states"],
+      "bestFor": [
+        "AI products",
+        "Creative tools"
+      ],
+      "principles": [
+        "monochrome first",
+        "spectral color with purpose",
+        "crisp geometry",
+        "fast direct feedback",
+        "accessible color-independent states"
+      ],
       "preview": {
         "label": "PRISM / MONO",
         "foreground": "#090909",
         "background": "radial-gradient(circle at 78% 22%, rgba(66,133,244,.95), transparent 22%), radial-gradient(circle at 64% 70%, rgba(52,168,83,.9), transparent 24%), radial-gradient(circle at 34% 70%, rgba(251,188,4,.9), transparent 23%), radial-gradient(circle at 22% 22%, rgba(234,67,53,.9), transparent 24%), #f8f8f6"
       },
-      "translations": {"ar": {"name": "Prism Mono", "role": "ثيم بصري", "description": "ثيم أبيض وأسود مع تدرج طيفي.", "bestFor": ["منتجات الذكاء الاصطناعي", "الأدوات الإبداعية"], "principles": ["الأبيض والأسود أولاً", "لون طيفي هادف", "هندسة واضحة", "استجابة سريعة", "حالات لا تعتمد على اللون وحده"]}},
+      "translations": {
+        "ar": {
+          "name": "Prism Mono",
+          "role": "ثيم بصري",
+          "description": "ثيم أبيض وأسود مع تدرج طيفي.",
+          "bestFor": [
+            "منتجات الذكاء الاصطناعي",
+            "الأدوات الإبداعية"
+          ],
+          "principles": [
+            "الأبيض والأسود أولاً",
+            "لون طيفي هادف",
+            "هندسة واضحة",
+            "استجابة سريعة",
+            "حالات لا تعتمد على اللون وحده"
+          ]
+        }
+      },
       "policyManifest": "packages/design-system/src/manifests/theme-prism-mono.json",
       "css": "packages/design-system/src/themes/prism-mono.css",
       "iconSystem": "lucide",
       "values": {
-        "--background": "#F8F8F6", "--foreground": "#090909", "--card": "#FFFFFF", "--card-foreground": "#090909",
-        "--primary": "#090909", "--primary-foreground": "#FFFFFF", "--secondary": "#ECECEA", "--secondary-foreground": "#090909",
-        "--muted": "#E4E4E0", "--muted-foreground": "#5F5F5A", "--border": "#CACAC5", "--input": "#A9A9A3", "--ring": "#1A73E8",
-        "--loading-background": "#F8F8F6", "--loading-accent": "#1A73E8", "--loading-foreground": "#090909",
-        "--radius": "14px", "--radius-control": "999px", "--radius-surface": "24px", "--radius-chat-bubble": "20px", "--radius-chat-composer": "28px", "--radius-chat-token": "14px",
-        "--shadow-control": "0 1px 0 rgba(0,0,0,.08)", "--motion-duration-press": "90ms", "--motion-duration-page": "180ms", "--motion-duration-expand": "180ms", "--motion-duration-reveal": "220ms", "--motion-duration-icon": "280ms",
-        "--motion-ease-standard": "cubic-bezier(0.2,0,0,1)", "--motion-ease-emphasized": "cubic-bezier(0.16,1,0.3,1)", "--motion-ease-icon": "cubic-bezier(0.16,1,0.3,1)", "--motion-press-scale": ".98", "--motion-distance-page": "6px", "--motion-distance-reveal": "8px",
-        "--font-sans": "TWK Lausanne", "--font-display": "TWK Lausanne", "--font-ui-support": "TWK Lausanne", "--font-marketing-display": "TWK Lausanne", "--font-arabic": "IBM Plex Sans Arabic", "--font-arabic-body": "IBM Plex Sans Arabic", "--font-arabic-display": "IBM Plex Sans Arabic",
-        "--font-weight-arabic-body": "400", "--font-weight-arabic-display": "700", "--font-size-display": "clamp(2.75rem,7vw,5.75rem)", "--font-size-arabic-body": "16px", "--font-size-arabic-body-lg": "19px", "--font-size-arabic-display": "clamp(2.6rem,6.6vw,5.4rem)", "--line-height-arabic": "1.75", "--line-height-arabic-body": "1.75", "--line-height-arabic-display": "1.16", "--tracking-arabic": "0", "--tracking-arabic-display": "0",
-        "--sidebar-width": "17rem", "--control-height-sm": "2rem", "--sidebar-width-collapsed": "4rem", "--sidebar-min-block-size": "30rem", "--sidebar-rail-size": "8px", "--button-height": "40px", "--card-padding": "24px",
-        "--overlay": "rgb(9 9 9 / 82%)", "--modal-surface": "#FFFFFF", "--popover-surface": "#FFFFFF", "--prism-spectrum": "linear-gradient(90deg,#EA4335,#FBBC04,#34A853,#4285F4)"
+        "--background": "#F8F8F6",
+        "--foreground": "#090909",
+        "--card": "#FFFFFF",
+        "--card-foreground": "#090909",
+        "--primary": "#090909",
+        "--primary-foreground": "#FFFFFF",
+        "--secondary": "#ECECEA",
+        "--secondary-foreground": "#090909",
+        "--muted": "#E4E4E0",
+        "--muted-foreground": "#5F5F5A",
+        "--border": "#CACAC5",
+        "--input": "#A9A9A3",
+        "--ring": "#1A73E8",
+        "--loading-background": "#F8F8F6",
+        "--loading-accent": "#1A73E8",
+        "--loading-foreground": "#090909",
+        "--radius": "14px",
+        "--radius-control": "999px",
+        "--radius-surface": "24px",
+        "--radius-chat-bubble": "20px",
+        "--radius-chat-composer": "28px",
+        "--radius-chat-token": "14px",
+        "--shadow-control": "0 1px 0 rgba(0,0,0,.08)",
+        "--motion-duration-press": "90ms",
+        "--motion-duration-page": "180ms",
+        "--motion-duration-expand": "180ms",
+        "--motion-duration-reveal": "220ms",
+        "--motion-duration-icon": "280ms",
+        "--motion-ease-standard": "cubic-bezier(0.2,0,0,1)",
+        "--motion-ease-emphasized": "cubic-bezier(0.16,1,0.3,1)",
+        "--motion-ease-icon": "cubic-bezier(0.16,1,0.3,1)",
+        "--motion-press-scale": ".98",
+        "--motion-distance-page": "6px",
+        "--motion-distance-reveal": "8px",
+        "--font-sans": "TWK Lausanne",
+        "--font-display": "TWK Lausanne",
+        "--font-ui-support": "TWK Lausanne",
+        "--font-marketing-display": "TWK Lausanne",
+        "--font-arabic": "IBM Plex Sans Arabic",
+        "--font-arabic-body": "IBM Plex Sans Arabic",
+        "--font-arabic-display": "IBM Plex Sans Arabic",
+        "--font-weight-arabic-body": "400",
+        "--font-weight-arabic-display": "700",
+        "--font-size-display": "clamp(2.75rem,7vw,5.75rem)",
+        "--font-size-arabic-body": "16px",
+        "--font-size-arabic-body-lg": "19px",
+        "--font-size-arabic-display": "clamp(2.6rem,6.6vw,5.4rem)",
+        "--line-height-arabic": "1.75",
+        "--line-height-arabic-body": "1.75",
+        "--line-height-arabic-display": "1.16",
+        "--tracking-arabic": "0",
+        "--tracking-arabic-display": "0",
+        "--sidebar-width": "17rem",
+        "--control-height-sm": "2rem",
+        "--sidebar-width-collapsed": "4rem",
+        "--sidebar-min-block-size": "30rem",
+        "--sidebar-rail-size": "8px",
+        "--button-height": "40px",
+        "--card-padding": "24px",
+        "--overlay": "rgb(9 9 9 / 82%)",
+        "--modal-surface": "#FFFFFF",
+        "--popover-surface": "#FFFFFF",
+        "--prism-spectrum": "linear-gradient(90deg,#EA4335,#FBBC04,#34A853,#4285F4)"
       }
     },
     {
@@ -377,7 +502,11 @@
         "independent brand and color mode",
         "restrained detector and assurance signals"
       ],
-      "preview": {"label": "BARRIER / INTELLIGENCE", "foreground": "#D2AC6C", "background": "radial-gradient(circle at 76% 20%, rgba(210,172,108,.24), transparent 32%), linear-gradient(145deg,#050505,#16120c 68%,#050505)"},
+      "preview": {
+        "label": "BARRIER / INTELLIGENCE",
+        "foreground": "#D2AC6C",
+        "background": "radial-gradient(circle at 76% 20%, rgba(210,172,108,.24), transparent 32%), linear-gradient(145deg,#050505,#16120c 68%,#050505)"
+      },
       "translations": {
         "ar": {
           "name": "Barrier Intelligence",
@@ -487,21 +616,106 @@
       "role": "Visual theme",
       "description": "Early-web theme with rounded geometry and pastel colors.",
       "motionProfile": "swift",
-      "bestFor": ["Youth and culture products", "Community and campaign pages"],
-      "principles": ["cute but legible", "bubble geometry", "pastel energy", "tactile offset depth", "nostalgia with modern accessibility"],
-      "preview": {"label": "Y2K ✦ POP", "foreground": "#35144F", "background": "radial-gradient(circle at 25% 22%,#fff 0 7%,transparent 8%), radial-gradient(circle at 78% 28%,#B6FF64 0 13%,transparent 14%), radial-gradient(circle at 30% 78%,#76E5FF 0 18%,transparent 19%), linear-gradient(135deg,#FFB9E8,#C8B6FF 55%,#FFF49A)"},
-      "translations": {"ar": {"name": "Y2K Pop", "role": "ثيم بصري", "description": "ثيم مستوحى من الويب المبكر بهندسة مستديرة وألوان باستيل.", "bestFor": ["منتجات الشباب والثقافة", "صفحات المجتمع والحملات"], "principles": ["لطيف وواضح", "هندسة فقاعية", "طاقة الباستيل", "عمق ملموس", "حنين مع وصول حديث"]}},
+      "bestFor": [
+        "Youth and culture products",
+        "Community and campaign pages"
+      ],
+      "principles": [
+        "cute but legible",
+        "bubble geometry",
+        "pastel energy",
+        "tactile offset depth",
+        "nostalgia with modern accessibility"
+      ],
+      "preview": {
+        "label": "Y2K ✦ POP",
+        "foreground": "#35144F",
+        "background": "radial-gradient(circle at 25% 22%,#fff 0 7%,transparent 8%), radial-gradient(circle at 78% 28%,#B6FF64 0 13%,transparent 14%), radial-gradient(circle at 30% 78%,#76E5FF 0 18%,transparent 19%), linear-gradient(135deg,#FFB9E8,#C8B6FF 55%,#FFF49A)"
+      },
+      "translations": {
+        "ar": {
+          "name": "Y2K Pop",
+          "role": "ثيم بصري",
+          "description": "ثيم مستوحى من الويب المبكر بهندسة مستديرة وألوان باستيل.",
+          "bestFor": [
+            "منتجات الشباب والثقافة",
+            "صفحات المجتمع والحملات"
+          ],
+          "principles": [
+            "لطيف وواضح",
+            "هندسة فقاعية",
+            "طاقة الباستيل",
+            "عمق ملموس",
+            "حنين مع وصول حديث"
+          ]
+        }
+      },
       "policyManifest": "packages/design-system/src/manifests/theme-y2k-pop.json",
       "css": "packages/design-system/src/themes/y2k-pop.css",
       "iconSystem": "lucide-rounded",
       "values": {
-        "--background": "#FFF6FD", "--foreground": "#35144F", "--card": "#FFFFFF", "--card-foreground": "#35144F",
-        "--primary": "#6C2BD9", "--primary-foreground": "#FFFFFF", "--secondary": "#FFD4F0", "--secondary-foreground": "#35144F", "--muted": "#EFE5FA", "--muted-foreground": "#725E81", "--border": "#8B68A5", "--input": "#8B68A5", "--ring": "#6C2BD9",
-        "--loading-background": "#FFF6FD", "--loading-accent": "#6C2BD9", "--loading-foreground": "#35144F",
-        "--radius": "22px", "--radius-control": "999px", "--radius-surface": "32px", "--radius-chat-bubble": "26px", "--radius-chat-composer": "32px", "--radius-chat-token": "18px", "--shadow-control": "3px 3px 0 #35144F",
-        "--motion-duration-press": "90ms", "--motion-duration-page": "180ms", "--motion-duration-expand": "200ms", "--motion-duration-reveal": "240ms", "--motion-duration-icon": "300ms", "--motion-ease-standard": "cubic-bezier(.2,0,0,1)", "--motion-ease-emphasized": "cubic-bezier(.2,1.35,.4,1)", "--motion-ease-icon": "cubic-bezier(.2,1.35,.4,1)", "--motion-press-scale": ".96", "--motion-distance-page": "8px", "--motion-distance-reveal": "12px",
-        "--font-sans": "TWK Lausanne", "--font-display": "TWK Lausanne", "--font-ui-support": "TWK Lausanne", "--font-marketing-display": "TWK Lausanne", "--font-arabic": "IBM Plex Sans Arabic", "--font-arabic-body": "IBM Plex Sans Arabic", "--font-arabic-display": "IBM Plex Sans Arabic", "--font-weight-arabic-body": "400", "--font-weight-arabic-display": "700", "--font-size-display": "clamp(2.75rem,7.4vw,6rem)", "--font-size-arabic-body": "16px", "--font-size-arabic-body-lg": "19px", "--font-size-arabic-display": "clamp(2.6rem,7vw,5.6rem)", "--line-height-arabic": "1.75", "--line-height-arabic-body": "1.75", "--line-height-arabic-display": "1.18", "--tracking-arabic": "0", "--tracking-arabic-display": "0",
-        "--sidebar-width": "17rem", "--control-height-sm": "2rem", "--sidebar-width-collapsed": "4rem", "--sidebar-min-block-size": "30rem", "--sidebar-rail-size": "8px", "--button-height": "42px", "--card-padding": "24px", "--overlay": "rgb(53 20 79 / 74%)", "--modal-surface": "#FFFFFF", "--popover-surface": "#FFFFFF"
+        "--background": "#FFF6FD",
+        "--foreground": "#35144F",
+        "--card": "#FFFFFF",
+        "--card-foreground": "#35144F",
+        "--primary": "#6C2BD9",
+        "--primary-foreground": "#FFFFFF",
+        "--secondary": "#FFD4F0",
+        "--secondary-foreground": "#35144F",
+        "--muted": "#EFE5FA",
+        "--muted-foreground": "#725E81",
+        "--border": "#8B68A5",
+        "--input": "#8B68A5",
+        "--ring": "#6C2BD9",
+        "--loading-background": "#FFF6FD",
+        "--loading-accent": "#6C2BD9",
+        "--loading-foreground": "#35144F",
+        "--radius": "22px",
+        "--radius-control": "999px",
+        "--radius-surface": "32px",
+        "--radius-chat-bubble": "26px",
+        "--radius-chat-composer": "32px",
+        "--radius-chat-token": "18px",
+        "--shadow-control": "3px 3px 0 #35144F",
+        "--motion-duration-press": "90ms",
+        "--motion-duration-page": "180ms",
+        "--motion-duration-expand": "200ms",
+        "--motion-duration-reveal": "240ms",
+        "--motion-duration-icon": "300ms",
+        "--motion-ease-standard": "cubic-bezier(.2,0,0,1)",
+        "--motion-ease-emphasized": "cubic-bezier(.2,1.35,.4,1)",
+        "--motion-ease-icon": "cubic-bezier(.2,1.35,.4,1)",
+        "--motion-press-scale": ".96",
+        "--motion-distance-page": "8px",
+        "--motion-distance-reveal": "12px",
+        "--font-sans": "TWK Lausanne",
+        "--font-display": "TWK Lausanne",
+        "--font-ui-support": "TWK Lausanne",
+        "--font-marketing-display": "TWK Lausanne",
+        "--font-arabic": "IBM Plex Sans Arabic",
+        "--font-arabic-body": "IBM Plex Sans Arabic",
+        "--font-arabic-display": "IBM Plex Sans Arabic",
+        "--font-weight-arabic-body": "400",
+        "--font-weight-arabic-display": "700",
+        "--font-size-display": "clamp(2.75rem,7.4vw,6rem)",
+        "--font-size-arabic-body": "16px",
+        "--font-size-arabic-body-lg": "19px",
+        "--font-size-arabic-display": "clamp(2.6rem,7vw,5.6rem)",
+        "--line-height-arabic": "1.75",
+        "--line-height-arabic-body": "1.75",
+        "--line-height-arabic-display": "1.18",
+        "--tracking-arabic": "0",
+        "--tracking-arabic-display": "0",
+        "--sidebar-width": "17rem",
+        "--control-height-sm": "2rem",
+        "--sidebar-width-collapsed": "4rem",
+        "--sidebar-min-block-size": "30rem",
+        "--sidebar-rail-size": "8px",
+        "--button-height": "42px",
+        "--card-padding": "24px",
+        "--overlay": "rgb(53 20 79 / 74%)",
+        "--modal-surface": "#FFFFFF",
+        "--popover-surface": "#FFFFFF"
       }
     },
     {

package/lib/api.mjs

@@ -168,6 +168,41 @@ export function prepareLogoMakerRun({ skillId, brandName, brief, referenceIds =
   }
 }
 
+export function getBrandbookSkill() {
+  return readJson(join(paths().manifests, 'brandbook-skill.json'))
+}
+
+export function prepareBrandbookRun({ brandName, brief }, root = process.cwd()) {
+  const room = getRoomContext(root)
+  const resolvedBrandName = String(brandName || room?.brandName || '').trim()
+  const resolvedBrief = String(brief || '').trim()
+  if (!resolvedBrandName) return { ok: false, code: 'BRAND_NAME_REQUIRED', message: 'Provide brandName or connect a Ceramic Brand Room.' }
+  if (resolvedBrief.length < 12) return { ok: false, code: 'BRIEF_TOO_SHORT', message: 'Provide at least 12 characters of brand intent.' }
+  const skill = getBrandbookSkill()
+  const prompt = [
+    `Create a Ceramic brand-book direction session for ${resolvedBrandName}.`, resolvedBrief, '',
+    'Follow the Ceramic Brandbook skill contract:',
+    '- Read available Brand Room context and supplied assets; a logo is optional.',
+    '- Present exactly three materially different directions labeled A, B, and C.',
+    '- Compare typography, semantic color roles, imagery, motion, Marketing expression, Solution expression, fit, and tradeoff.',
+    '- Refine the selected route with the user before writing the final BRAND.md.',
+    '- Produce exactly one editorial source, BRAND.md, with complete English and Arabic parity unless the user changes the language scope.',
+    '- Use the active chat image generator by default; keep provider choice outside the brand contract and record actual provenance.',
+    '- Choose one to three brand-fit Solution applications from phone, desktop, and environment.',
+    '- Generate a dedicated scene for every photographic desktop or environment application with the active image skill; do not reuse general brand photography.',
+    '- Put mockups directly on the semantic brand canvas without generic backing panels or caption overlays.',
+  ].join('\n')
+  return { ok: true, toolId: skill.id, phase: 'direction-proposals', room,
+    input: { brandName: resolvedBrandName, brief: resolvedBrief }, prompt,
+    workflow: skill.workflow, rules: skill.rules,
+    source: {
+      provider: 'github', repository: skill.repository, branch: skill.branch, revision: skill.revision,
+      skillPath: skill.skillPath, sourceDocument: skill.sourceDocument,
+      instruction: 'Resolve the pinned GitHub revision and read SKILL.md before presenting directions.',
+    },
+    nextAction: 'Present A, B, and C for user refinement. Do not build or save the final brand book yet.' }
+}
+
 export function listDocs() {
   return readdirSync(paths().docs)
     .filter((name) => name.endsWith('.md'))
@@ -200,6 +235,7 @@ export function search(query) {
     ...listThemes().map((item) => ({ kind: 'theme', id: item.id, title: item.name, summary: item.role, item })),
     ...listMotionProfiles().map((item) => ({ kind: 'motion-profile', id: item.id, title: item.label, summary: `${item.description} ${item.rules.join(' ')}`, item })),
     ...listLogoSkills().map((item) => ({ kind: 'logo-skill', id: item.id, title: item.name, summary: `${item.tagline} ${item.description} ${item.guidance}`, item })),
+    { kind: 'brandbook-skill', id: getBrandbookSkill().id, title: getBrandbookSkill().name, summary: 'Brand identity BRAND.md three directions A B C marketing solution mockups image generation Arabic', item: getBrandbookSkill() },
     ...listDocs().map((topic) => ({ kind: 'docs', id: topic, title: topic, summary: getDoc(topic)?.content.slice(0, 500) ?? '', item: { topic } })),
   ]
   return results
@@ -238,14 +274,14 @@ export function capabilityManifest() {
     ],
     mcp: {
       ...mcpLaunch,
-      tools: ['get_room_context', 'search', 'list_components', 'get_component', 'list_block_definitions', 'get_block_definition', 'validate_layout', 'validate_agent_layout_mutation', 'list_blocks', 'get_block', 'list_templates', 'get_template', 'list_themes', 'get_theme', 'list_motion_profiles', 'get_motion_profile', 'list_logo_skills', 'get_logo_skill', 'prepare_logo_maker_run', 'list_docs', 'get_docs', 'doctor'],
+      tools: ['get_room_context', 'search', 'list_components', 'get_component', 'list_block_definitions', 'get_block_definition', 'validate_layout', 'validate_agent_layout_mutation', 'list_blocks', 'get_block', 'list_templates', 'get_template', 'list_themes', 'get_theme', 'list_motion_profiles', 'get_motion_profile', 'list_logo_skills', 'get_logo_skill', 'prepare_logo_maker_run', 'get_brandbook_skill', 'prepare_brandbook_run', 'list_docs', 'get_docs', 'doctor'],
     },
   }
 }
 
 export function repositoryDoctor() {
   const required = [
-    'catalog.json', 'components.json', 'blocks.json', 'composition-registry.json', 'templates.json', 'themes.json', 'motion-profiles.json', 'logo-skills.json',
+    'catalog.json', 'components.json', 'blocks.json', 'composition-registry.json', 'templates.json', 'themes.json', 'motion-profiles.json', 'logo-skills.json', 'brandbook-skill.json',
   ].map((name) => join(paths().manifests, name))
   const docs = ['quick-start-ai', 'arabic-friendly', 'theme-authoring', 'composition-registry'].map((name) => join(paths().docs, `${name}.md`))
   const missing = [...required, ...docs].filter((path) => !existsSync(path))

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@utopia-studio-design/design-system-cli",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "AI-readable CLI and MCP server for Ceramic Design System",
   "ceramic": {
-    "designSystem": "^0.9.1"
+    "designSystem": "^0.10.0"
   },
   "type": "module",
   "license": "MIT",