synthesisui 0.16.281 → 0.16.282

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/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.282",
   "description": "Bring SynthesisUI design systems into any project - tokens, typed components, whole pages and an agent-ready CLAUDE.md manifest.",
   "type": "module",
   "bin": {