synthesisui 0.16.281 → 0.16.283

package/dist/commands/mcp.js

@@ -184,14 +184,14 @@ const TOOLS = [
     },
     {
         name: "playbook",
-        description: "The skill playbooks (init, import, adapt, compose) - SERVED, not shipped, so they are always current and your context only carries the step you are on. Call with { skill } to get the framing and a table of contents; then fetch ONLY the chapter for your current step with { skill, section }. Never fetch more than the step needs. `compose` is the hierarchy to walk when this system has no recipe for what you were asked to build - the layers it DOES have, in order.",
+        description: "The skill playbooks (init, import, adapt, compose, configure) - SERVED, not shipped, so they are always current and your context only carries the step you are on. Call with { skill } to get the framing and a table of contents; then fetch ONLY the chapter for your current step with { skill, section }. Never fetch more than the step needs. `compose` is the hierarchy to walk when this system has no recipe for what you were asked to build - the layers it DOES have, in order.",
         inputSchema: {
             type: "object",
             properties: {
                 skill: {
                     type: "string",
-                    enum: ["init", "import", "adapt", "compose"],
-                    description: "Which playbook. `compose` is the one for building something this system has no recipe for.",
+                    enum: ["init", "import", "adapt", "compose", "configure"],
+                    description: "Which playbook. `compose` is the one for building something this system has no recipe for; `configure` is the one for wiring an installed system into the app when its tokens are not reaching the browser.",
                 },
                 section: {
                     type: "string",

package/dist/guide.js

@@ -262,6 +262,23 @@ export function buildGuide(payload) {
     const { document: doc, slug, name, version } = payload;
     const { meta, foundations, motion, components } = doc;
     const semanticRoles = Object.keys(foundations.color.semantic);
+    /**
+     * O NOME QUE ELE DÁ AO PAPEL, quando o documento sabe qual é - `semanticNames`.
+     *
+     * O guia listava `info, faint, muted, scrim, accent, border, canvas, danger, raised, overlay,
+     * primary, success, surface, warning` e chamava isso de vocabulário do sistema DELE. Nenhuma dessas
+     * palavras está no código dele: `canvas` é `paper`, `primary` é `brand-blue`, `danger` é
+     * `feedback-error`. Este arquivo é o que o agente dele LÊ antes de escrever, então a nossa língua
+     * aqui vira o código dele.
+     *
+     * A missão de 16/08 tirou o nosso identificador das telas e da saída de texto do CLI; o guia é
+     * artefato e escapou da varredura. Medido em 22/08 no `codelevel-ui`: 14 papéis listados, 12 com
+     * nome dele guardado no documento e nenhum aparecendo.
+     *
+     * Sem `semanticNames` o papel sai como está - é o caso de um sistema que NASCEU aqui, e aí o nome
+     * é nosso mesmo.
+     */
+    const theirRole = (role) => foundations.color.semanticNames?.[role] ?? role;
     /**
      * AS CORES QUE ELE NOMEIA POR PROPÓSITO, no arquivo que o agente lê primeiro.
      *
@@ -679,7 +696,10 @@ ${hasTailwind
   The token names below are the source vocabulary - every utility derives from them.`
         : ""}
 - **Always use semantic tokens**, never raw values nor primitives directly.
-  Color: \`var(--ds-color-semantic-<role>)\`${hasTailwind ? " (utility: `bg-<role>`/`text-<role>`)" : ""}. The roles are: ${list(semanticRoles)}.
+  Color: \`var(--ds-color-semantic-<role>)\`${hasTailwind ? " (utility: `bg-<role>`/`text-<role>`)" : ""}. The roles are: ${list(semanticRoles.map((r) => {
+        const theirs = theirRole(r);
+        return theirs === r ? r : `${r} (${theirs} in your code)`;
+    }))}.
 - Primitives (\`--ds-color-<palette>-<step>\`) exist but should **not** be referenced directly -
   they feed the semantic roles.${namedColours.length > 0
         ? `\n- **Yours by name** → \`var(--ds-color-<name>)\`: ${namedColours.length} colour${namedColours.length === 1 ? "" : "s"} your code names by PURPOSE rather than by step, so no scale could hold ${namedColours.length === 1 ? "it" : "them"} - ${list(namedColours.slice(0, 8))}${namedColours.length > 8 ? ", …" : ""}. These are yours: reach for them when the purpose matches, and prefer a semantic role when it does not.`

package/dist/install-marks.js

@@ -128,7 +128,7 @@
  * é sempre o bump deste PR - nunca o número que o `package.json` já carrega, porque alguém pode
  * publicar no meio.
  */
-export const MATERIALISER_SINCE = "0.16.281";
+export const MATERIALISER_SINCE = "0.16.283";
 /**
  * A ÚLTIMA VERSÃO EM QUE O QUE O HOOK RODA MUDOU.
  *

package/dist/skill-configure.js

@@ -0,0 +1,13 @@
+/**
+ * O STUB DA SKILL - o corpo é SERVIDO, não embarcado (R1, dono 16/08).
+ *
+ * Mesma doutrina das outras quatro: o frontmatter fica inteiro aqui, porque é a `description` que
+ * faz a skill ser invocada e ela não é segredo; a esteira mora em `apps/web/src/lib/ds/playbooks.ts`
+ * e chega pelo catalogue autenticado.
+ *
+ * O QUE ELA RESOLVE: um sistema instalado e sincronizado pode não mudar um pixel na tela dele. Até
+ * uma folha de estilo importar os tokens e um elemento carregar `data-ds`, nada chega ao navegador -
+ * e essa era a única parte da instalação que ninguém escrevia, só imprimia.
+ */
+export const CONFIGURE_SKILL_PATH = ".claude/skills/sui-configure-ds/SKILL.md";
+export const CONFIGURE_SKILL = '---\nname: sui-configure-ds\ndescription: Wire an installed design system into the app so its tokens actually reach the browser - the stylesheet import, the data-ds scope, and the type. Use when a system is installed and the app does not look themed, when `doctor` reports "installed - but not wired up yet", or when somebody asks to set up / connect / configure the design system in their app ("configura o design system aqui", "why aren\'t the tokens working", "/sui-configure-ds"). Asks the doctor first and does nothing when the three checks already pass.\n---\n\n# Wiring the system into the app - served live\n\nThis playbook is served from the platform, not shipped in this file - it is\nalways current, and your context only carries the step you are on.\n\n1. Call the `playbook` tool on the `synthesisui` MCP server with\n   { "skill": "configure" } - you get the framing and a table of contents.\n2. Fetch ONLY the chapter for the step you are on:\n   { "skill": "configure", "section": "<id from the toc>" }. Never fetch more\n   than the current step needs.\n3. Follow it exactly. When the step is done, fetch the next chapter.\n\nStart by running `npx synthesisui doctor`: the three lines it prints are what\ndecide the work, and three ticks means there is nothing to do.\n\nIf the tool answers that you are not signed in, run `npx synthesisui login`\nin the terminal and call it again. If the `synthesisui` MCP server is not\navailable at all, run `npx synthesisui connect`, restart the session, and\ninvoke this skill again.\n';

package/dist/skills.js

@@ -1,5 +1,6 @@
 import { ADAPT_SKILL, ADAPT_SKILL_PATH } from "./skill-adapt.js";
 import { COMPOSE_SKILL, COMPOSE_SKILL_PATH } from "./skill-compose.js";
+import { CONFIGURE_SKILL, CONFIGURE_SKILL_PATH } from "./skill-configure.js";
 import { IMPORT_SKILL, IMPORT_SKILL_PATH } from "./skill-import.js";
 import { INIT_SKILL, INIT_SKILL_PATH } from "./skill-init.js";
 /**
@@ -53,4 +54,19 @@ export const SKILLS = [
         label: "/sui-compose",
         what: "build what the system does not have, layer by layer",
     },
+    /**
+     * A DE LIGAR O SISTEMA NO APP, e ela é a única aqui que fecha um passo que a esteira já sabia
+     * diagnosticar e não sabia resolver.
+     *
+     * O `add` IMPRIME a fiação, o `doctor` CONFERE a fiação com três ✓/✗, e nada a ESCREVE. Enquanto
+     * ela falta, os tokens não chegam ao navegador e o `doctor --fix` fica recusado de propósito - um
+     * fix num projeto sem fiação trocou 210 literais por variáveis que o navegador não resolvia e mudou
+     * a página (06/08).
+     */
+    {
+        path: CONFIGURE_SKILL_PATH,
+        source: CONFIGURE_SKILL,
+        label: "/sui-configure-ds",
+        what: "the system wired into the app, so the tokens reach the browser",
+    },
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synthesisui",
-  "version": "0.16.281",
+  "version": "0.16.283",
   "description": "Bring SynthesisUI design systems into any project - tokens, typed components, whole pages and an agent-ready CLAUDE.md manifest.",
   "type": "module",
   "bin": {