synthesisui 0.16.220 → 0.16.225

package/dist/commands/align.js

@@ -7,6 +7,7 @@ import { readToken, resolveRegistry } from "../config.js";
 import { unsentEvents } from "../doctor/ledger.js";
 import { CHECKER_SINCE, installedBehind, MATERIALISER_SINCE, READER_SINCE, } from "../install-marks.js";
 import { measuredScope } from "../measured-scope.js";
+import { SKILLS } from "../skills.js";
 /**
  * QUAL CLI MEDIU O CENSO EM DISCO - e era o `reader`, um inteiro, até 11/08.
  *
@@ -150,6 +151,36 @@ opts = {}) {
              */
             run: "npx synthesisui sync",
         });
+    /**
+     * A SKILL QUE ESTE CLI TEM E ESTE REPO NÃO - e sem isto ela nunca chegaria.
+     *
+     * `connect` é idempotente e atualiza sozinho, mas ninguém roda um comando de novo sem motivo: uma
+     * skill nova ficava esperando o acaso. Aqui ela vira uma linha do alinho, que é a única coisa que
+     * fala com a pessoa sem ela pedir.
+     *
+     * Compara o CONTEÚDO e não só a existência: uma skill velha descreve um fluxo que este CLI já não
+     * tem, e isso é pior que não ter skill nenhuma - quem lê não tem como perceber.
+     */
+    const installedSkills = await Promise.all(SKILLS.map((skill) => readFile(join(root, skill.path), "utf8").catch(() => null)));
+    /**
+     * E SÓ FALA COM QUEM JÁ TEM ALGUMA - senão isto vira o alarme que ensina uma palavra nova a quem
+     * não pediu.
+     *
+     * Um repositório sem skill nenhuma nunca ligou o agente, e pode nem usar Claude Code. Dizer a essa
+     * pessoa que "uma skill está faltando" é nomear uma ausência que ela escolheu, e `align` é a única
+     * superfície que fala sem ser chamada - a regra dela é ficar calada no estado saudável.
+     *
+     * Com uma instalada, o silêncio passa a ser o erro: ela ligou o agente, e uma skill nova ficaria
+     * esperando o acaso de alguém rodar `connect` de novo.
+     */
+    const staleSkills = SKILLS.filter((skill, i) => installedSkills[i] !== skill.source).map((skill) => skill.label);
+    if (installedSkills.some((have) => have != null) && staleSkills.length > 0)
+        out.push({
+            says: staleSkills.length === 1
+                ? `${staleSkills[0]} is missing or older than this CLI - it is a skill your agent can invoke, and it is not here.`
+                : `${staleSkills.length} skills are missing or older than this CLI (${staleSkills.join(", ")}) - your agent can invoke them, and they are not here.`,
+            run: "npx synthesisui connect",
+        });
     /**
      * SÓ O QUE NÃO SUBIU - ver `unsentEvents`. Isto contava o arquivo inteiro, e como o ledger é
      * append-only e o `sync` manda tudo (a plataforma deduplica), a linha nunca mais saía da tela e o

package/dist/commands/connect.js

@@ -6,8 +6,7 @@ import { resolveRegistry } from "../config.js";
 import { body, paint, section, snippet } from "../output.js";
 import { readShellAnswer, rememberShellNo } from "../shell-answer.js";
 import { existingRc, hasHook, pinnedInHook, rcPathFor, shellFrom, shellSnippet, withHook, } from "../shell-hook.js";
-import { IMPORT_SKILL, IMPORT_SKILL_PATH } from "../skill-import.js";
-import { INIT_SKILL, INIT_SKILL_PATH } from "../skill-init.js";
+import { SKILLS } from "../skills.js";
 import { add } from "./add.js";
 import { reportWhatIsLeft } from "./align.js";
 import { ci } from "./ci.js";
@@ -293,24 +292,19 @@ export async function connect(opts) {
      * something change" - so nobody has to remember a second command.
      */
     /**
-     * AS DUAS SKILLS, e o `/sui-init` é a que importa mais aqui: é a PRIMEIRA CORRIDA, e uma skill que
+     * AS TRÊS SKILLS, e o `/sui-init` é a que importa mais aqui: é a PRIMEIRA CORRIDA, e uma skill que
      * só aparece depois de reiniciar o editor não serve para a primeira corrida de ninguém. Ela vem no
-     * mesmo `connect` que ainda vai pedir o reinício - então quando a pessoa reabre, as duas existem.
+     * mesmo `connect` que ainda vai pedir o reinício - então quando a pessoa reabre, as três existem.
+     *
+     * A TERCEIRA É DE MANUTENÇÃO, e ela é de outra natureza: as duas primeiras são de ENTRADA e rodam
+     * uma vez. `/sui-adapt` responde a pergunta do dia seguinte - *"isso aqui está de acordo com o meu
+     * design system?"* -, apontando para um componente, toda semana ou depois de mexer em alguma coisa.
+     *
+     * Ela quase ficou de fora daqui, e teria sido o erro de sempre: uma skill que só existe no NOSSO
+     * repositório é uma skill que só nós rodamos, e o caso de uso inteiro dela é o cliente rodando
+     * sozinho. Meia jornada não é meio valor.
      */
-    const skills = [
-        {
-            path: INIT_SKILL_PATH,
-            source: INIT_SKILL,
-            label: "/sui-init",
-            what: "the first run, start to finish",
-        },
-        {
-            path: IMPORT_SKILL_PATH,
-            source: IMPORT_SKILL,
-            label: "/sui-import-ds",
-            what: "the import, orchestrated",
-        },
-    ];
+    const skills = SKILLS;
     /**
      * A PASTA VELHA SAI, e isto é obrigatório numa renomeação de skill distribuída.
      *

package/dist/commands/doctor.js

@@ -11,6 +11,7 @@ import { findFrozenBindings } from "../doctor/frozen.js";
 import { appendEvent, COVERAGE_RULE, readEvents, suggestionsFrom, summarize, } from "../doctor/ledger.js";
 import { bindingsFromDocument, countComponents, findOverrides, } from "../doctor/overrides.js";
 import { checkableName, readRequests, verifyAndCloseRequests, } from "../doctor/requests.js";
+import { DEFAULT_ROOT_PX, rootSizeOf, saidOfRoot, } from "../doctor/root-size.js";
 import { diagnose, scanSource, siblingTokens, } from "../doctor/scan.js";
 import { findSelfConflicts, forbiddenProps, isReset, propMatchesLabel, } from "../doctor/self-conflict.js";
 import { buildTable, EMPTY_TABLE, nearestToken, } from "../doctor/tokens.js";
@@ -130,7 +131,34 @@ export async function* walkAll(roots) {
  *  and the recipes `add` put next to them in `design-system.json`. Those
  *  recipes are why the component pass can exist at all - a linter has no idea
  *  what `ds-button` promised. */
-export async function loadSystem(root) {
+/**
+ * COMO CADA PEDIDO SE LÊ NUMA LINHA - e o `else` desta expressão mentia.
+ *
+ * Ela dizia `component "<nome>"` para tudo que não fosse token, então um pedido de REGRA aparecia no
+ * doctor como se fosse um componente pedido. Uma tela que rotula errado é pior que uma que não
+ * rotula: quem lê decide em cima do rótulo.
+ */
+function requestLabel(r) {
+    if (r.kind === "token")
+        return `token ${r.value} as ${r.name}`;
+    if (r.kind === "rule")
+        return `rule "${r.name}"`;
+    return `component "${r.name}"`;
+}
+export async function loadSystem(root, 
+/**
+ * A RAIZ JÁ MEDIDA, quando quem chama já varreu as folhas de estilo.
+ *
+ * O `doctor` mede (ele já anda no repositório inteiro) e passa. O `hook` NÃO mede, e isso é uma
+ * escolha declarada: ele roda depois de cada escrita com orçamento de ~50ms, e varrer css a cada
+ * edição trocaria um relatório instantâneo por um que a pessoa desliga.
+ *
+ * A consequência, dita em voz alta: num projeto que redefine a raiz (`html { font-size: 62.5% }`),
+ * o hook compara px e rem por 16 e deixa de sugerir algumas trocas que o `doctor` sugere. Ele erra
+ * para o lado de oferecer MENOS, nunca de oferecer a troca errada - e o `--fix`, que é quem escreve,
+ * vem sempre do `doctor`.
+ */
+measured) {
     const dsDir = join(root, "_synthesisui", "ds");
     let slugs;
     try {
@@ -248,7 +276,12 @@ export async function loadSystem(root) {
         }
     }
     return {
-        table: buildTable({ css, lock, source: adopted ? "adopted" : "installed" }),
+        table: buildTable({
+            css,
+            lock,
+            source: adopted ? "adopted" : "installed",
+            ...(measured ? { rootPx: measured.px, rootFrom: measured.from } : {}),
+        }),
         recipes,
         documents,
         requires,
@@ -269,6 +302,19 @@ export async function loadSystem(root) {
  * Reads stylesheets only, and only when nothing of ours is installed, so the
  * common path pays nothing for it.
  */
+/** As folhas de estilo dele, para a medição da raiz. Só css - nada de `.tsx`. */
+async function sheetsIn(roots) {
+    const out = [];
+    for await (const file of walkAll(roots)) {
+        if (!/\.(css|scss|sass|less)$/i.test(file))
+            continue;
+        const css = await readFile(file, "utf8").catch(() => "");
+        /** Só carrega adiante o que pode conter a declaração - o resto é peso à toa. */
+        if (/(?:html|:root)[^{]*\{[^}]*font-size/i.test(css))
+            out.push({ file: relative(roots[0] ?? file, file) || file, css });
+    }
+    return out;
+}
 async function harvestOwnTokens(roots) {
     let css = "";
     for await (const file of walkAll(roots)) {
@@ -469,7 +515,18 @@ export async function doctor(opts) {
     const fullRun = (opts.scopes ?? []).length === 0;
     /** A intenção ordena o relatório, e a precedência é flag > config > default. */
     const intent = intentOf(await readProjectConfig(root), opts.intent);
-    const installed = await loadSystem(root);
+    /**
+     * A RAIZ, MEDIDA ANTES DE COMPARAR VALOR NENHUM - ver `rootSizeOf`.
+     *
+     * `4px` e `0.25rem` só são o mesmo valor se alguém disser quantos pixels vale 1rem AQUI, e supor 16
+     * num projeto que escreve `html { font-size: 62.5% }` erraria em todos os lugares de uma vez, com a
+     * confiança de quem acertou. Uma passada barata: só folhas de estilo, e só o bloco `html`/`:root`.
+     */
+    const rootSize = rootSizeOf(await sheetsIn(scopes.length > 0 ? scopes : [root]));
+    const installed = await loadSystem(root, {
+        px: rootSize.ambiguous ? DEFAULT_ROOT_PX : rootSize.px,
+        from: rootSize.from,
+    });
     const { recipes, documents } = installed;
     let table = installed.table;
     // Nothing of ours here does not mean nothing to measure against. Fall back
@@ -600,6 +657,18 @@ export async function doctor(opts) {
         const said = measured.from === "census" ? describeScope(measured) : null;
         console.log(body(said ?? `scope: ${relScopes.join(", ")}`));
     }
+    /**
+     * A RAIZ QUE ESTA RODADA USOU - e ela é impressa SEMPRE, inclusive quando é o padrão.
+     *
+     * Pedido do dono em 13/08: *"analisar antes se tem algo que interfere no size, e deixar registrado
+     * como uma regra que está sendo usada"*. É o que transforma uma suposição nossa num fato que ele
+     * pode conferir: `4px` e `0.25rem` só são o mesmo valor por causa deste número, e ele decide quantas
+     * trocas o comando oferece.
+     *
+     * Impressa mesmo no caso padrão porque é aí que ela é mais fácil de esquecer - e um relatório que só
+     * fala quando é exceção ensina que o silêncio significa "não olhei".
+     */
+    console.log(body(saidOfRoot(rootSize)));
     /**
      * E A INTENÇÃO, em toda rodada, com a data e o jeito de inverter.
      *
@@ -941,7 +1010,7 @@ export async function doctor(opts) {
             console.log("");
             console.log(section("What your agent asked for"));
             for (const r of requests.slice(0, 8)) {
-                console.log(body(`  ${r.id}  ${r.kind === "token" ? `token ${r.value} as ${r.name}` : `component "${r.name}"`}${r.area === "platform" ? "  [platform]" : ""}`));
+                console.log(body(`  ${r.id}  ${requestLabel(r)}${r.area === "platform" ? "  [platform]" : ""}`));
                 console.log(body(`          for: ${r.purpose}`));
                 if (r.considered)
                     console.log(body(`          considered: ${r.considered}`));

package/dist/commands/mcp.js

@@ -200,6 +200,29 @@ const TOOLS = [
             required: ["value", "name", "purpose"],
         },
     },
+    {
+        name: "request_rule",
+        description: "File a rule request when this component does something the system's doctrine does not cover, and you had to decide alone. Read `system_doctrine` first: if a rule already answers it, follow it instead of filing. This is for the case with no rule - what the rule would say, and the case that asked for it. Do NOT invent a convention and move on; a decision that lives only in one file is not a decision of the system.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "What the rule would say, in one line: 'a card that opens a dialog carries the trigger, never the panel'",
+                },
+                purpose: {
+                    type: "string",
+                    description: "The case that asked for it - what you were building when no rule answered.",
+                },
+                considered: {
+                    type: "string",
+                    description: "Which existing rules you read and why they did not answer.",
+                },
+                file: { type: "string", description: "Where the case lives." },
+            },
+            required: ["name", "purpose"],
+        },
+    },
 ];
 /**
  * QUANTAS FERRAMENTAS ESTE SERVIDOR SERVE, lido da lista.
@@ -1037,6 +1060,24 @@ cli) {
                 ? `Filed as ${r.id} and routed to the synthesisui platform team - the system's contract already promises this and the shipped css does not deliver it. No one needs to act: it closes itself when an update lands. Keep the quiet base meanwhile.`
                 : `Filed as ${r.id}. Do not add the token yourself - the request shows up in \`synthesisui doctor\` for a person to decide.`);
         }
+        case "request_rule": {
+            /**
+             * SEM TRIAGEM AUTOMÁTICA, e de propósito.
+             *
+             * `request_token` sabe rotear para a plataforma quando o contrato do sistema já promete o
+             * nome - é uma pergunta que a máquina responde. "Isto deveria ser uma regra?" não é: ela é a
+             * decisão de quem é dono do sistema, e roteá-la sozinho seria inventar a resposta em vez de
+             * abrir a pergunta.
+             */
+            const r = await fileRequest(root, {
+                kind: "rule",
+                name: String(args.name ?? ""),
+                purpose: String(args.purpose ?? ""),
+                considered: args.considered ? String(args.considered) : undefined,
+                file: args.file ? String(args.file) : undefined,
+            });
+            return text(`Filed as ${r.id}. Do not adopt the convention as if it were a rule - it shows up in \`synthesisui doctor\` and travels to the system's queue, for the owner to make it a rule or decline it.`);
+        }
         default:
             return text(`No tool named ${name}.`, true);
     }

package/dist/commands/request.js

@@ -1,5 +1,5 @@
 import { resolve } from "node:path";
-import { closeRequest, fileRequest, readRequests } from "../doctor/requests.js";
+import { closeRequest, fileRequest, KINDS, readRequests, } from "../doctor/requests.js";
 import { body, section } from "../output.js";
 /**
  * `synthesisui request` - the queue of what the agent needed and was refused.
@@ -12,6 +12,12 @@ import { body, section } from "../output.js";
  * Closing is deliberately explicit. A request nobody got to is still a
  * request; nothing here expires.
  */
+/** Como cada tipo se lê numa linha - um lugar, três telas. */
+const labelOf = (r) => r.kind === "token"
+    ? `token ${r.value} as ${r.name}`
+    : r.kind === "rule"
+        ? `rule "${r.name}"`
+        : `component "${r.name}"`;
 export async function request(opts) {
     const root = resolve(opts.dir ?? process.cwd());
     if (opts.done) {
@@ -29,7 +35,7 @@ export async function request(opts) {
             return;
         }
         for (const r of all) {
-            console.log(body(`  ${r.id}  ${r.kind === "token" ? `token ${r.value} as ${r.name}` : `component "${r.name}"`}`));
+            console.log(body(`  ${r.id}  ${labelOf(r)}`));
             console.log(body(`          for: ${r.purpose}`));
             if (r.considered)
                 console.log(body(`          considered: ${r.considered}`));
@@ -40,14 +46,23 @@ export async function request(opts) {
         console.log(body("Close one: synthesisui request --done <id>"));
         return;
     }
-    if (opts.kind !== "component" && opts.kind !== "token") {
-        console.log(`Unknown kind "${opts.kind}" - component or token.`);
+    if (!KINDS.has(opts.kind)) {
+        console.log(`Unknown kind "${opts.kind}" - component, token or rule.`);
         return;
     }
+    /**
+     * UMA REGRA PRECISA DO CASO, e é por isso que ela exige `--for` como as outras.
+     *
+     * "Isto deveria ser uma regra" sem o caso que a motivou é uma opinião. Com o caso, quem decidir do
+     * outro lado tem o que a doutrina não cobria e onde isso apareceu - que é a diferença entre uma
+     * fila que vira decisão e uma que vira backlog.
+     */
     if (!opts.name || !opts.purpose || (opts.kind === "token" && !opts.value)) {
         console.log(opts.kind === "token"
             ? "A token request needs --value, --name and --for."
-            : "A component request needs --name and --for.");
+            : opts.kind === "rule"
+                ? "A rule request needs --name and --for - what the rule would say, and the case that asked for it."
+                : "A component request needs --name and --for.");
         return;
     }
     const r = await fileRequest(root, {

package/dist/commands/sync.js

@@ -16,11 +16,26 @@ import { resolveReadParts, siblingProjects, takeCensus } from "./import.js";
  * after `closeRequest` runs here, so the person knows what happened and what
  * (if anything) is theirs to do next.
  */
-export function decisionLine(d, slug) {
+export function decisionLine(d, slug, 
+/** Onde o sistema dele vive - o `publish` mora lá, e sem o endereço a frase manda procurar. */
+base) {
     const note = d.note ? ` - "${d.note}"` : "";
     switch (d.status) {
+        /**
+         * AUTORIZAR ESCREVE O RASCUNHO, e esta linha dizia o contrário.
+         *
+         * `authorPersonalToken` termina em `writeDraft`, e o registry serve a última PUBLICADA - por lei,
+         * desde 29/07: se o rascunho fluísse para o repo, o botão Publish não seguraria nada.
+         *
+         * Então "Get it: upgrade" mandava a pessoa rodar um comando que responde `already at the latest
+         * version` e não traz o token. Ela seguiu a instrução, não recebeu nada, e fica sem saber se
+         * autorizou errado ou se a ferramenta falhou - que é o pior lugar para deixar alguém que acabou
+         * de fazer exatamente o que a gente pediu (dono, 13/08, vendo isso no terminal dele).
+         *
+         * A frase agora nomeia os DOIS passos, na ordem, e o primeiro é dele.
+         */
         case "authored":
-            return `  ✓ ${d.id} authored on the platform${note}. Get it: npx synthesisui@latest upgrade ${slug}`;
+            return `  ✓ ${d.id} authored into your draft${note}. It reaches this repo once you publish${base ? `: ${base}/dashboard/mine/${slug}/publish` : ""}\n      then: npx synthesisui@latest upgrade ${slug}`;
         case "declined":
             return `  ✕ ${d.id} declined${note}. Now a RULE of the system - it travels with the next upgrade, and agents obey it.`;
         case "platform":
@@ -150,7 +165,7 @@ export async function sync(opts) {
         console.log(body("Answered on the platform, closed here:"));
         for (const d of decisions) {
             await closeRequest(root, d.id);
-            console.log(body(decisionLine(d, slug)));
+            console.log(body(decisionLine(d, slug, base)));
         }
     }
     console.log("");
@@ -276,6 +291,49 @@ export async function remeasure(args) {
     if (stored.reading)
         census.reading = stored.reading;
     await resolveReadParts(census, root, !args.full).catch(() => { });
+    /**
+     * O QUE A RE-MEDIÇÃO NÃO MEDE, ELA NÃO PODE APAGAR - e apagava quatro campos de uma vez.
+     *
+     * O `sync` mede o CÓDIGO dele de novo. Ele não mede polaridade, não pergunta escopo e não refaz a
+     * leitura do agente: esses três são respostas que alguém já deu, e `runImport` é quem as grava.
+     * Escrever por cima com um censo que não os tem não é re-medir - é esquecer.
+     *
+     * O que isso custava, medido no censo do dono em 13/08 (`scope`, `usage`, `scheme` e `reading`
+     * ausentes depois de um sync):
+     *
+     *     scheme    `censusToPatch` lê `reading.themes.default ?? census.scheme ?? "light"`. Sem os
+     *               dois primeiros ele cai em CLARO - e o sistema dele abre ESCURO. Uma
+     *               re-interpretação a partir desse censo aterra a face errada, no servidor, sem
+     *               ninguém tocar em nada
+     *     scope     o próprio comentário de `takeCensus` chama isso de veneno de ação lenta: a
+     *               primeira re-medição parece perfeita e a segunda mede o repositório inteiro
+     *     reading   a leitura que o agente autorou, que é justamente o que o `sync` promete não mexer
+     *
+     * Complemento, nunca correção: o que a medição de hoje TEM continua ganhando. Isto só recoloca o
+     * que ela não tinha como saber.
+     */
+    const before = await readFile(join(root, "_synthesisui", "census.json"), "utf8")
+        .then((raw) => JSON.parse(raw))
+        .catch(() => null);
+    const fresh = census;
+    /** `scope` e `usage` o `sync` SABE - ele acabou de resolvê-los. Os outros vêm do que já existia. */
+    if (scope)
+        fresh.scope = scope;
+    if (usage.length > 0)
+        fresh.usage = usage;
+    for (const key of ["scheme", "reading"])
+        if (fresh[key] == null && before?.[key] != null)
+            fresh[key] = before[key];
+    /**
+     * E A POLARIDADE VEM DA PLATAFORMA quando nem a medição nem o arquivo a têm.
+     *
+     * Carregar do arquivo anterior conserta quem ainda não perdeu. Quem já perdeu - o censo do dono,
+     * medido em 13/08 - ficaria sem polaridade para sempre, porque o `sync` não a mede: ela é uma
+     * resposta dada no import. O documento guardado sabe (`meta.scheme`), então a rota devolve e isto
+     * recoloca. O próximo `sync` de quem estava furado repara o censo dele.
+     */
+    if (fresh.scheme == null && stored.scheme)
+        fresh.scheme = stored.scheme;
     /**
      * O CENSO FRESCO TAMBÉM FICA NO DISCO.
      *

package/dist/doctor/requests.js

@@ -22,6 +22,8 @@ import { join } from "node:path";
  * how a team shares a queue.
  */
 export const REQUESTS_FILE = "requests.jsonl";
+/** Os tipos que a fila aceita, num lugar só - ver `GapRequest.kind`. */
+export const KINDS = new Set(["component", "token", "rule"]);
 const path = (root) => join(root, "_synthesisui", REQUESTS_FILE);
 /** Stable-enough id from content: 6 chars, collision-safe at queue scale. */
 function idOf(kind, name, at) {
@@ -65,7 +67,14 @@ export async function readRequests(root) {
             continue;
         try {
             const r = JSON.parse(line);
-            if (r?.id && r.name && (r.kind === "component" || r.kind === "token"))
+            /**
+             * O FILTRO DA LEITURA - e ele é um dos três lugares onde um tipo novo some CALADO.
+             *
+             * Uma linha com `kind` desconhecido é descartada aqui sem erro, então acrescentar um tipo sem
+             * passar por este ponto produz um pedido que o agente arquiva, o arquivo guarda, e ninguém
+             * nunca lê.
+             */
+            if (r?.id && r.name && KINDS.has(r.kind))
                 out.push(r);
         }
         catch {

package/dist/doctor/root-size.js

@@ -0,0 +1,101 @@
+/**
+ * QUAL É A RAIZ DESTE PROJETO - medida antes de comparar valor nenhum.
+ *
+ * `4px` e `0.25rem` são o mesmo valor, e o comparador tratava os dois como textos diferentes. Medido
+ * no repo real em 13/08: 1320 literais em px que um token `--ds-*` já nomeia em rem, em 364 arquivos,
+ * contra 253 trocas que o doctor conseguia oferecer no repositório inteiro. A maior parte do trabalho
+ * fácil estava escondida atrás de uma comparação de string.
+ *
+ * A conversão exige uma raiz, e `1rem = 16px` é o padrão do navegador - mas é só o padrão. Um projeto
+ * que escreve `html { font-size: 62.5% }` tem raiz de 10px, e converter por 16 ali erraria em todos os
+ * lugares de uma vez, com a confiança de quem acertou.
+ *
+ * Então a raiz não é suposta: é MEDIDA no css dele, e DITA em voz alta no relatório (dono, 13/08:
+ * *"analisar antes se tem algo que interfere no size, e deixar registrado como uma regra que está
+ * sendo usada"*). Uma suposição escondida num comentário do nosso código não é lida por ninguém; um
+ * fato impresso no cabeçalho é conferível por quem conhece o projeto.
+ *
+ * E QUANDO NÃO DÁ PARA SABER, NÃO CONVERTE. Duas raízes diferentes, um `calc()`, um `var()`: a
+ * resposta é dizer que não sabe. Deixar de oferecer uma troca custa uma troca; oferecer a errada em
+ * 1320 lugares custa a confiança no comando.
+ */
+/** O padrão do navegador, e o que vale quando ninguém redefine. */
+export const DEFAULT_ROOT_PX = 16;
+/** `html`/`:root` com uma declaração de `font-size` dentro - o bloco inteiro, para ler o valor. */
+const ROOT_BLOCK = /(?:^|[},;])\s*(html|:root)\s*(?:,[^{]*)?\{([^}]*)\}/gi;
+const FONT_SIZE = /(?:^|;)\s*font-size\s*:\s*([^;}]+)/i;
+/**
+ * O valor de uma declaração de raiz em pixels, ou `null` quando não dá para saber.
+ *
+ * `%` e `em` na RAIZ são relativos ao padrão do navegador, que é o único ancestral que ela tem - por
+ * isso `62.5%` é 10px e não uma incógnita. `rem` na raiz é a mesma coisa, e é como alguns projetos
+ * escrevem `1rem` só para deixar explícito.
+ */
+export function rootPxOf(raw) {
+    const v = raw.trim().toLowerCase();
+    const m = /^(\d*\.?\d+)(px|%|r?em)$/.exec(v);
+    if (!m)
+        return null;
+    const n = Number.parseFloat(m[1]);
+    if (!Number.isFinite(n) || n <= 0)
+        return null;
+    if (m[2] === "px")
+        return n;
+    if (m[2] === "%")
+        return (n / 100) * DEFAULT_ROOT_PX;
+    return n * DEFAULT_ROOT_PX;
+}
+/**
+ * A raiz deste projeto, lida das folhas de estilo dele.
+ *
+ * Recebe os arquivos já lidos porque quem varre é o comando - esta função não sabe andar em disco, e
+ * é isso que a torna testável com um objeto em vez de um diretório temporário.
+ */
+export function rootSizeOf(sheets) {
+    /** Valor em px → onde ele foi declarado pela primeira vez. */
+    const seen = new Map();
+    const unreadable = [];
+    for (const sheet of sheets) {
+        ROOT_BLOCK.lastIndex = 0;
+        for (const block of sheet.css.matchAll(ROOT_BLOCK)) {
+            const decl = FONT_SIZE.exec(block[2]);
+            if (!decl)
+                continue;
+            const px = rootPxOf(decl[1]);
+            if (px == null) {
+                unreadable.push(`${decl[1].trim()} (${sheet.file})`);
+                continue;
+            }
+            if (!seen.has(px))
+                seen.set(px, `${block[1]}, ${sheet.file}`);
+        }
+    }
+    /**
+     * UM VALOR ILEGÍVEL SÓ CONTAMINA SE FOR O ÚNICO SINAL - ou se discordar do que foi lido.
+     *
+     * Um `font-size: var(--app-root)` ao lado de um `10px` declarado não torna o projeto ambíguo: o
+     * que se sabe continua sabido. O que torna é não haver resposta, ou haver duas.
+     */
+    if (seen.size > 1)
+        return {
+            px: DEFAULT_ROOT_PX,
+            from: null,
+            ambiguous: {
+                saw: [...seen.entries()].map(([px, at]) => `${px}px (${at})`),
+            },
+        };
+    if (seen.size === 0 && unreadable.length > 0)
+        return { px: DEFAULT_ROOT_PX, from: null, ambiguous: { saw: unreadable } };
+    const only = [...seen.entries()][0];
+    return only
+        ? { px: only[0], from: only[1] }
+        : { px: DEFAULT_ROOT_PX, from: null };
+}
+/** A linha do relatório - o fato, e de onde ele veio. Nunca um número pelado. */
+export function saidOfRoot(root) {
+    if (root.ambiguous)
+        return `root font-size: not one answer (${root.ambiguous.saw.slice(0, 3).join(" · ")}) - px and rem are not compared here`;
+    return root.from
+        ? `root font-size: ${root.px}px (${root.from}) - px and rem are compared against this`
+        : `root font-size: ${DEFAULT_ROOT_PX}px (browser default - nothing here redefines it)`;
+}

package/dist/doctor/scan.js

@@ -316,7 +316,7 @@ function scanCore(file, source, table) {
                  * e é por VALOR, não por nome: `--color-ocean-500` e `--ds-color-ocean-500` só são a mesma
                  * decisão porque os dois seguram `#059aed`.
                  */
-                ...(table.byValue.has(normalizeValue(value))
+                ...(table.byValue.has(normalizeValue(value, table.rootPx))
                     ? { mirrored: true }
                     : null),
             });

package/dist/doctor/tokens.js

@@ -11,6 +11,17 @@
  * Pure and dependency-free on purpose: every function here takes text and
  * returns data, so the whole diagnosis is testable without a filesystem.
  */
+/**
+ * Where the vocabulary being measured against came from.
+ *
+ * `"installed"` is a system we wrote. `"yours"` is the project's OWN custom
+ * properties, harvested from its stylesheets - the case that matters most,
+ * because the people who feel this problem hardest already have a design
+ * system and had no reason to adopt ours before seeing a number.
+ */
+/** `"adopted"` is theirs too, but described by `adopt` and therefore NAMED -
+ *  it must not be offered a system to install, having just adopted one. */
+import { DEFAULT_ROOT_PX } from "./root-size.js";
 export const EMPTY_TABLE = {
     source: null,
     name: null,
@@ -18,6 +29,8 @@ export const EMPTY_TABLE = {
     version: null,
     byName: new Map(),
     byValue: new Map(),
+    rootPx: DEFAULT_ROOT_PX,
+    rootFrom: null,
     declared: new Set(),
     keyframes: new Set(),
 };
@@ -90,8 +103,30 @@ function args(body) {
  *
  * Anything that is not a colour passes through lowercased and collapsed.
  */
-export function normalizeValue(raw) {
+export function normalizeValue(raw, rootPx) {
     const v = raw.trim().toLowerCase().replace(/\s+/g, " ");
+    /**
+     * COMPRIMENTO CAI EM PIXELS, pelo mesmo motivo que tempo cai em milissegundos logo abaixo.
+     *
+     * `--ds-radius-xs: 0.25rem` e um `borderRadius: "4px"` no código dele são o MESMO valor, e o
+     * comparador os tratava como textos diferentes. Medido no repo real (13/08): 1320 literais em px
+     * que um token já nomeia em rem, contra 253 trocas que o comando conseguia oferecer no repositório
+     * inteiro.
+     *
+     * `rootPx` é obrigatório de propósito. O padrão do navegador é 16, mas um projeto que escreve
+     * `html { font-size: 62.5% }` tem raiz de 10 - e converter por 16 ali erra em todos os lugares de
+     * uma vez. Quem chama tem que dizer qual raiz mediu; ver `rootSizeOf`.
+     *
+     * A FAMÍLIA CONTINUA MANDANDO: `4px` passa a casar com `--ds-radius-xs` E com `--ds-spacing-3xs`,
+     * e é `tokenMatch` quem escolhe pelo `kind` - um raio não vira espaçamento dentro de um `gap`.
+     */
+    const len = /^(-?\d*\.?\d+)(px|rem)$/.exec(v);
+    if (len) {
+        const n = Number.parseFloat(len[1]);
+        const px = len[2] === "rem" ? n * rootPx : n;
+        /** Arredonda o rastro binário: `0.35rem * 16` é 5.6000000000000005. */
+        return `${Math.round(px * 1e4) / 1e4}px`;
+    }
     // Time lands on milliseconds: `.3s`, `0.3s` and `300ms` are one value, the
     // same way every colour lands on 8-digit hex. Without this, a system that
     // authors `--ds-motion-durations-base: 0.3s` never names an author's `300ms`.
@@ -353,6 +388,7 @@ export function parseRootTokens(css) {
 }
 export function buildTable(input) {
     const source = input.source ?? "installed";
+    const rootPx = input.rootPx ?? DEFAULT_ROOT_PX;
     const byName = source === "installed"
         ? parseTokens(input.css)
         : parseRootTokens(input.css);
@@ -377,7 +413,7 @@ export function buildTable(input) {
     const isAlias = (name) => /^var\(/.test((raw.get(name) ?? "").trim());
     const byValue = new Map();
     for (const [name, value] of resolved) {
-        const key = normalizeValue(value);
+        const key = normalizeValue(value, rootPx);
         const list = byValue.get(key);
         if (!list)
             byValue.set(key, [name]);
@@ -393,6 +429,8 @@ export function buildTable(input) {
         version: input.lock?.version ?? null,
         byName,
         byValue,
+        rootPx,
+        rootFrom: input.rootFrom ?? null,
         declared: parseDeclaredNames(input.css),
         keyframes: new Set([...input.css.matchAll(/@keyframes\s+([a-zA-Z0-9_-]+)/g)].map((m) => m[1])),
     };
@@ -480,7 +518,7 @@ const FAMILY = {
  * `family`.
  */
 export function tokenMatch(table, literal, kind) {
-    const hit = table.byValue.get(normalizeValue(literal));
+    const hit = table.byValue.get(normalizeValue(literal, table.rootPx));
     if (!hit || hit.length === 0)
         return null;
     const prefix = kind ? FAMILY[kind] : undefined;

package/dist/install-marks.js

@@ -90,7 +90,13 @@ export const MATERIALISER_SINCE = "0.16.220";
  * agente dele que o fundo do `card` deveria apontar para `foreground` - o papel do TEXTO -, e é
  * exatamente uma verificação que o pinado faz diferente.
  */
-export const CHECKER_SINCE = "0.16.219";
+/**
+ * 0.16.219 -> 0.16.223 em 13/08: `px` e `rem` viraram o mesmo valor na comparação. O hook roda a
+ * mesma varredura depois de cada escrita, e um pin anterior lê o mesmo arquivo e diz "o sistema não
+ * tem nome para isto" sobre um valor que o sistema dela nomeia - medido no repo real, 243 trocas
+ * viraram 764 sobre os mesmos 4433 valores à mão.
+ */
+export const CHECKER_SINCE = "0.16.223";
 /**
  * A ÚLTIMA VERSÃO EM QUE OS LEITORES PASSARAM A PRODUZIR UM CENSO DIFERENTE.
  *

package/dist/skill-adapt.js

@@ -0,0 +1,262 @@
+/**
+ * A SKILL DE MANUTENÇÃO, como o CLI a distribui.
+ *
+ * Mesmo motivo do `skill-init.ts` e do `skill-import.ts`: o build é `tsc` e nada mais, então um `.md`
+ * precisaria de um passo de cópia que pode silenciosamente não rodar. Um módulo TypeScript não pode
+ * falhar em ser empacotado.
+ *
+ * ESTA É A FONTE. A cópia em `.claude/skills/` é o que o nosso editor lê, e o spec assere que as duas
+ * são idênticas.
+ *
+ * E ela é a TERCEIRA que o `connect` instala - as outras duas são de ENTRADA (primeira corrida,
+ * import). Esta responde a pergunta do dia seguinte, apontando para uma tela: *"isso aqui está de
+ * acordo com o meu design system?"*. Deixá-la fora do `connect` faria dela uma skill nossa, e o caso
+ * de uso que a motivou é o cliente rodando sozinho toda semana.
+ */
+export const ADAPT_SKILL = `---
+name: sui-adapt
+description: Confronta UM componente (ou uma página, ou uma pasta) contra o design system instalado e adapta o que der - cobertura de token medida, conserto mecânico proposto antes de escrever, e o que sobra classificado em "regra nova" ou "conserto local". Use quando alguém aponta para uma peça e pergunta se ela está de acordo com o sistema (ex. "/sui-adapt components/ui/card", "analisa esse componente aqui", "isso aqui segue o meu design system?"), como rotina semanal, ou logo depois de criar/alterar um componente. Mede antes de propor, propõe antes de escrever, e nunca arquiva pedido em nome de ninguém.
+---
+
+# Adaptar uma peça ao sistema
+
+**Seu primeiro comando é a medição.** Não leia \`.mcp.json\`, não abra o censo, não liste
+arquivo: \`check_file\` ou \`doctor <alvo>\` responde tudo isso em um passo, e é o que o resto
+desta skill consome. Um agente que sai explorando antes gasta a paciência de quem pediu e
+chega ao mesmo lugar.
+
+O propósito do produto, que decide todo empate abaixo: **ler o repositório do cliente e
+devolver receitas com paridade visual, semântica e funcional, sem supor e sem inventar
+nada.**
+
+Esta skill é a ponta de manutenção. As outras duas que o cliente tem são de ENTRADA -
+\`sui-init\` e \`sui-import-ds\` transformam o repositório dele em sistema. Esta responde a
+pergunta do dia seguinte, que ele faz apontando para uma tela: *"isso aqui está de acordo
+com o meu design system?"*.
+
+\`CLAUDE.md\` manda. Quando os dois divergirem, este arquivo é que está velho.
+
+---
+
+## 0. O QUE ESTA SKILL NÃO FAZ
+
+Três limites, e cada um existe por um motivo que já custou alguma coisa:
+
+\`\`\`
+não escreve sem propor    é o repositório DELE. \`--fix --write\` sem confirmação é
+                          outra categoria de confiança, e uma skill que perde essa
+                          confiança não é rodada uma segunda vez
+não arquiva pedido        \`request\` fila uma decisão na plataforma. A skill MOSTRA o
+                          comando; quem roda é ele
+não inventa token, nome   um agente que cala um relatório fazendo o sistema crescer é
+nem regra                 pior que a deriva que ele veio medir
+\`\`\`
+
+## 1. O ALVO, E POR QUE O ESCOPO É DECISÃO DA SKILL
+
+Componente quase nunca é um arquivo. \`Card.tsx\` costuma vir com \`Card.css\`, \`Card.stories.tsx\`
+e às vezes um \`index.ts\` - e medir só o \`.tsx\` produz um número que mente por omissão: o css
+ao lado é justamente onde os valores à mão se escondem.
+
+\`\`\`
+1. resolva o alvo   o que ele apontou, ou o arquivo aberto, ou o que ele acabou de mexer
+2. suba para a PASTA quando o irmão existir (mesmo nome, extensão diferente)
+3. DIGA qual escopo você usou, com o número de arquivos
+\`\`\`
+
+Nunca meça os dois e escolha o maior. Diga o que mediu.
+
+**O alvo fora da pasta importada é o caso COMUM, e não um erro.** O sistema nasceu de uma
+pasta (o \`scope\` no \`.lock\`), e uma tela de app que consome o DS está fora dela - é
+literalmente o pedido *"conserta essa página pro meu design system"*. Ali a cobertura de
+token vale igual, porque a camada de token é global; o que não existe é receita daquele
+componente. Diga isso em uma linha e siga - e quando faltar uma peça, o destino é
+\`request component\`.
+
+## 2. MEÇA - e a medida é determinística, não sua
+
+Duas portas, mesma resposta. Use a que a sessão tiver:
+
+\`\`\`
+MCP        check_file { path }
+terminal   npx synthesisui doctor <alvo>
+\`\`\`
+
+O que volta, medido num componente real (\`ArticleCard\`, 13/08):
+
+\`\`\`
+  SignalUI v7 - 181 tokens, 1 file read
+  scope: packages/ui/src/lib/SignalUI/organisms/ArticleCard/ArticleCard.tsx
+
+  Token coverage  ░░░░░░░░░░░░░░░░░░░░░░░░    0%
+                  0 from the system, 2 by hand
+                  50% is one command away - 1 of those have a name waiting
+\`\`\`
+
+Três números, e eles já vêm separados por natureza:
+
+\`\`\`
+from the system   já usa o vocabulário. Nada a fazer
+have a name waiting   o sistema JÁ nomeia esse valor -> mecânico, é o passo 3
+no name for it        o sistema não nomeia -> DECISÃO dele, é o passo 5
+\`\`\`
+
+Não recalcule nada disso de cabeça. O número que você reporta é o que o comando disse.
+
+## 3. MONTE A FILA, E CONTE OS ITENS ANTES DE COMEÇAR
+
+Aqui é onde esta skill se ganha ou se perde. Despejar tudo de uma vez - duas regras, quatro
+decisões, dez trocas - não é um relatório, é uma parede. Quem lê não tem como agir; só
+concordar ou fechar a aba.
+
+Junte tudo o que você achou (o mecânico do passo 2, as regras do passo 4, o que sobrou do
+passo 5) numa fila ÚNICA, e **ordene por custo**:
+
+\`\`\`
+1º  não muda um pixel      troca por token de mesmo valor
+2º  muda o pixel           colapsar um passo, adotar um token semântico
+3º  não é troca, é pedido  token novo, peça nova, regra nova
+\`\`\`
+
+Assim ele despacha o barato primeiro e para quando quiser, sem ficar devendo nada.
+
+Anuncie o tamanho antes do primeiro item, sempre:
+
+\`\`\`
+7 itens nesta fila: 2 sem mudar pixel, 3 que mudam, 2 pedidos.
+\`\`\`
+
+## 4. UM ITEM POR VEZ, COM OPÇÕES - e espere a resposta
+
+Nunca apresente o item 2 antes de ele responder o 1. O cabeçalho carrega a posição, para
+ele saber onde está e quanto falta:
+
+\`\`\`
+item 1 de 7 · radius 4px · 2 lugares · não muda um pixel
+
+  DeliveredBox/index.tsx:76   borderRadius: "4px"  ->  var(--ds-radius-xs)
+  TotalSentBox/index.tsx:71   borderRadius: "4px"  ->  var(--ds-radius-xs)
+
+  [aplicar]  [pular]  [ver o diff]  [parar por aqui]
+\`\`\`
+
+Quatro opções, e nenhuma a mais:
+
+\`\`\`
+aplicar        você roda o comando ou faz a edição, e confirma em uma linha
+pular          segue para o próximo, e ele entra no resumo como não mexido
+ver o diff     mostre e volte a perguntar - não conte isso como resposta
+parar por aqui fecha o resumo com o que andou até aqui. É sempre legítimo
+\`\`\`
+
+Para um item mecânico o "aplicar" é \`npx synthesisui doctor <alvo> --fix --write\`. Para os
+outros é edição, e você mostra exatamente as linhas antes.
+
+## 5. AS REGRAS, QUE É A METADE QUE NENHUM COMANDO FAZ
+
+O passo 2 é determinístico e sai de graça. Este não: o sistema carrega uma doutrina em
+prosa, e **nada a verifica mecanicamente**. É aqui que você trabalha.
+
+\`\`\`
+MCP        system_doctrine
+terminal   as regras viajam no documento instalado (_synthesisui/ds/<slug>/doctrine.json)
+\`\`\`
+
+Leia as regras e confronte o componente com cada uma. Três respostas possíveis por regra,
+e a terceira é a que interessa:
+
+\`\`\`
+cumpre           some do relatório. Diga só o total no fim
+NÃO cumpre       vira um ITEM da fila, com arquivo, linha e a troca proposta
+a regra não fala sobre isto   vira um item de PEDIDO - \`request rule\`
+\`\`\`
+
+Uma regra que você teve que interpretar para aplicar não é "cumpre". É o terceiro caso.
+
+E nunca escreva "3 de 5 cumpridas". Isso lê como boletim, e as 2 que faltam são justamente
+as que TÊM conserto pronto - é a melhor notícia do relatório vestida como a pior.
+
+## 6. OS PEDIDOS - você mostra o comando, ele roda
+
+Três destinos, e todos existem:
+
+\`\`\`
+valor sem nome no sistema
+  -> npx synthesisui request token --value "<valor>" --name "<como se chamaria>" --for "<o caso>"
+peça que falta
+  -> npx synthesisui request component --name "<nome>" --for "<o caso>"
+a doutrina não cobre este caso
+  -> npx synthesisui request rule --name "<o que a regra diria>" --for "<o caso que pediu>"
+\`\`\`
+
+**Arquivar em nome dele seria decidir por ele** - e tirar dele a chance de dizer "não, isso
+fica local mesmo". Antes de propor \`request rule\`, leia a doutrina inteira: uma regra que já
+existe e você não achou vira duplicata na fila, e a fila perde valor na terceira.
+
+## 6b. A RÉGUA É O ALCANÇÁVEL, E O TETO SE DIZ JUNTO
+
+**100% quase nunca é alcançável hoje, e isso não é falha dele.** Se o sistema não tem nome
+para \`#555\`, ninguém chega a 100% sem antes decidir criar esse nome. Um medidor que mostra
+0% contra um teto imaginário faz trabalho completo parecer trabalho pela metade.
+
+Os números para a conta certa já vêm do comando:
+
+\`\`\`
+3 valores à mão
+2 o sistema já nomeia   -> alcançável hoje: 67%
+1 o sistema não nomeia  -> precisa de uma decisão dele
+\`\`\`
+
+Então o teto de hoje é 67%, e aplicar as duas trocas é **chegar no teto** - 100% do que dá
+para fazer com o vocabulário que existe.
+
+## 6c. FECHE PELO QUE ANDOU, E MOSTRE O CAMINHO ATÉ 100%
+
+\`\`\`
+<Componente>   <n> arquivos
+
+alcançável hoje   67%   é o que o vocabulário do sistema cobre
+aplicado          67%   ✓ no teto - nada mecânico ficou para trás
+pulado             8    espaçamentos que mudam layout (item 5, quando quiser)
+na sua fila        1    #555, que o sistema ainda não nomeia
+\`\`\`
+
+Nunca "0% -> 0%". Se nada era mecânico, o teto era zero, e a frase é *"não havia nada que
+o vocabulário de hoje resolvesse - o que existe são N decisões suas"*.
+
+E quando sobrou pedido, termine com o caminho, porque ele é de dois passos e o primeiro é
+dele:
+
+\`\`\`
+para chegar a 100%, faltam dois passos:
+  1. autorize o pedido no dashboard   (ele já está na fila; \`sync\` o levou)
+  2. publique, e rode \`npx synthesisui upgrade\` aqui
+     depois disso, /sui-adapt neste componente fecha em 100%
+\`\`\`
+
+Autorizar escreve o RASCUNHO, e o repo recebe a última PUBLICADA - por isso os dois passos,
+e por isso o \`sync\` também diz isso quando a decisão volta. Prometer que \`upgrade\` sozinho
+traz o token é mandar a pessoa rodar um comando que responde "already at the latest version".
+
+Se a fila esvaziou, o fim é uma linha só:
+
+\`\`\`
+alcançável hoje  100%
+aplicado         100%   ✓ este componente está inteiro no sistema
+\`\`\`
+
+## 7. ROTINA
+
+Ela foi desenhada para duas horas do dia, e a segunda é a que mais rende:
+
+\`\`\`
+semanal          "roda o sui-adapt no dashboard" - pega deriva antes de virar hábito
+depois de mexer  componente novo, ou alteração grande: rode ANTES do commit, enquanto a
+                 decisão ainda está quente e o conserto ainda é barato
+\`\`\`
+
+O hook (\`PostToolUse\`) já roda a metade determinística a cada escrita, calado quando não há
+o que dizer. Esta skill é o passo deliberado: ela junta o hook, a doutrina e a fila numa
+conversa só, e termina com o cliente decidindo - não com um relatório.
+`;
+export const ADAPT_SKILL_PATH = ".claude/skills/sui-adapt/SKILL.md";

package/dist/skills.js

@@ -0,0 +1,39 @@
+import { ADAPT_SKILL, ADAPT_SKILL_PATH } from "./skill-adapt.js";
+import { IMPORT_SKILL, IMPORT_SKILL_PATH } from "./skill-import.js";
+import { INIT_SKILL, INIT_SKILL_PATH } from "./skill-init.js";
+/**
+ * AS SKILLS QUE O CLI DISTRIBUI, numa lista só - e ela existe porque DOIS comandos precisam dela.
+ *
+ * `connect` escreve; `align` cobra o que falta. Enquanto a lista morava dentro do `connect`, o
+ * `align` não tinha como saber que existia uma terceira - e uma skill nova só chegava a quem, por
+ * conta própria, rodasse `connect` de novo. Ninguém roda um comando de novo sem motivo.
+ *
+ * É a lei 8 no caso mais barato dela: a lacuna existe, a gente sabe qual é, e dizer custa uma linha.
+ */
+export const SKILLS = [
+    {
+        path: INIT_SKILL_PATH,
+        source: INIT_SKILL,
+        label: "/sui-init",
+        what: "the first run, start to finish",
+    },
+    {
+        path: IMPORT_SKILL_PATH,
+        source: IMPORT_SKILL,
+        label: "/sui-import-ds",
+        what: "the import, orchestrated",
+    },
+    /**
+     * A DE MANUTENÇÃO, e ela é de outra natureza que as duas acima.
+     *
+     * As duas primeiras são de ENTRADA: rodam uma vez, e depois nunca mais. Esta responde a pergunta do
+     * dia seguinte, apontando para uma tela - *"isso aqui está de acordo com o meu design system?"* -,
+     * toda semana ou depois de mexer em alguma coisa. É a primeira que uma pessoa roda mais de uma vez.
+     */
+    {
+        path: ADAPT_SKILL_PATH,
+        source: ADAPT_SKILL,
+        label: "/sui-adapt",
+        what: "one component against the system, and what to do about it",
+    },
+];

package/package.json

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