synthesisui 0.16.227 → 0.16.231

package/dist/skill-adapt.js

@@ -38,16 +38,46 @@ com o meu design system?"*.
 
 ---
 
-## 0. O QUE ESTA SKILL NÃO FAZ
+## 0. COMO VOCÊ FALA COM ELE
+
+**Ele quer saber o que está no projeto DELE. Nada do que está do nosso lado interessa.**
+
+Esta seção vale acima de qualquer outra abaixo, porque uma medição perfeita escrita na
+nossa língua é uma medição que ele não lê. Palavras que **nunca** aparecem para ele:
+
+\`\`\`
+ledger · census · scope · reading as ADOPTION · refresh_system · check_file
+system_doctrine · carrier · alcançável · o número da versão do CLI · --fix --write
+cobertura de token · o nome de qualquer comando ou ferramenta nossa
+\`\`\`
+
+A tradução é sempre a mesma: fale do **arquivo**, da **propriedade**, do **valor** e da
+**variável dele**.
+
+\`\`\`
+em vez de                          diga
+o ledger.cli está em 0.16.229      sua ferramenta está em dia
+o scope do sistema é packages/ui   este arquivo fica fora da pasta de onde o
+                                   seu design system nasceu, e isso é normal
+1em → var(--ds-spacing-md)         o seu projeto já chama esse valor de \`--spacing-md\`
+cobertura de token: 0%             nenhum destes valores vem do seu design system
+rode doctor --fix --write          eu troco para você, se você quiser
+\`\`\`
+
+**A variável que você oferece é a DELE.** O comando já devolve o nome do vocabulário dele
+quando o repositório tem um - \`--color-lightgray-700\`, e não \`--ds-color-gray-400\`. Nunca
+reescreva a sugestão para o nosso prefixo: renomear a variável dele não é adotar o sistema.
+
+## 0b. 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
+não escreve sem propor    é o repositório DELE. Escrever 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 arquiva pedido        um pedido fila uma decisão na plataforma. A skill
+                          PERGUNTA; quem decide é 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
 \`\`\`
@@ -64,14 +94,14 @@ ao lado é justamente onde os valores à mão se escondem.
 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.
+Nunca meça os dois e escolha o maior. Diga o que mediu - **com os nomes dos arquivos**, não
+com a palavra "escopo".
 
 **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\`.
+pasta, e uma tela de app que consome o DS está fora dela - é literalmente o pedido
+*"conserta essa página pro meu design system"*. Ali as variáveis valem igual, porque elas
+são globais; o que não existe é receita daquele componente. Diga isso em uma linha, sem a
+palavra "escopo", e siga.
 
 ## 2. MEÇA - e a medida é determinística, não sua
 
@@ -82,75 +112,96 @@ MCP        check_file { path }
 terminal   npx synthesisui doctor <alvo>
 \`\`\`
 
-O que volta, medido num componente real (\`ArticleCard\`, 13/08):
+Não recalcule nada de cabeça. O número que você reporta é o que o comando disse.
+
+**A abertura tem três linhas e nenhuma a mais.** Ela responde "está em dia?", "o que você
+leu?" e "como estou?", nesta ordem:
 
 \`\`\`
-  SignalUI v7 - 181 tokens, 1 file read
-  scope: packages/ui/src/lib/SignalUI/organisms/ArticleCard/ArticleCard.tsx
+sua ferramenta está em dia
 
-  Token coverage  ░░░░░░░░░░░░░░░░░░░░░░░░    0%
-                  0 from the system, 2 by hand
-                  50% is one command away - 1 of those have a name waiting
+li OverviewHeaderInformation - o componente e a folha de estilo dele, 2 arquivos
+
+17 valores estão escritos à mão aqui, e nenhum vem do seu design system
 \`\`\`
 
-Três números, e eles já vêm separados por natureza:
+Se a ferramenta NÃO estiver em dia, essa primeira linha vira o primeiro item da fila, com o
+comando à vista - uma medição feita com a versão velha responde outra coisa.
+
+Os três grupos que o comando separa, e o que cada um vira:
 
 \`\`\`
-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
+já usa uma variável       nada a fazer
+o projeto já nomeia       é uma troca - vira item, com a variável DELE ao lado
+ninguém nomeia            é uma decisão dele - vira item, com as três saídas
 \`\`\`
 
-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**:
+Junte tudo o que você achou 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
+1º  não muda um pixel      troca por uma variável de mesmo valor
+2º  pode mudar o pixel     \`em\` que segue a fonte, um degrau que colapsa
+3º  não é troca, é pedido  variável nova, 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:
+Anuncie o tamanho antes do primeiro item, sempre, e em uma frase que ele leia:
 
 \`\`\`
-7 itens nesta fila: 2 sem mudar pixel, 3 que mudam, 2 pedidos.
+achei 8 coisas. 2 não mudam nada na tela, 4 podem mudar, e 2 são decisão sua.
 \`\`\`
 
-## 4. UM ITEM POR VEZ, COM OPÇÕES - e espere a resposta
+## 4. UM ITEM POR VEZ, COM AS TRÊS SAÍDAS - 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:
+ele saber onde está e quanto falta. O corpo fala do componente dele, e termina numa
+pergunta:
 
 \`\`\`
-item 1 de 7 · radius 4px · 2 lugares · não muda um pixel
+item 1 de 8
+
+  OverviewHeaderInformation espaça com \`1em\` em 4 lugares, e esse valor não está
+  ligado ao seu design system.
+
+    styles.module.scss    padding: 1em 0
+                          padding-right: 1em
+                          margin-left: 1em
+                          margin-right: 0.5em
+
+  O que você quer fazer?
 
-  DeliveredBox/index.tsx:76   borderRadius: "4px"  ->  var(--ds-radius-xs)
-  TotalSentBox/index.tsx:71   borderRadius: "4px"  ->  var(--ds-radius-xs)
+    1  deixar como está
+    2  usar \`--spacing-md\`, que o seu projeto já tem
+       ⚠ \`em\` segue a fonte do elemento, então isto pode mudar o espaçamento na tela
+    3  criar um nome novo para este valor no seu design system
 
-  [aplicar]  [pular]  [ver o diff]  [parar por aqui]
+  [1] [2] [3]   ou me diga outra coisa · [parar por aqui]
 \`\`\`
 
-Quatro opções, e nenhuma a mais:
+As três saídas são sempre as mesmas, porque são as três que existem de verdade:
 
 \`\`\`
-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
+1  deixar como está    ele segue para o próximo, e o item entra no resumo como não mexido
+2  usar uma variável   você faz a edição e confirma em uma linha
+                       SE a troca puder mudar a tela, isso vem escrito NA OPÇÃO, não depois
+3  criar um nome novo  vira um pedido, e é ele quem manda - ver o passo 6
 \`\`\`
 
-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.
+E \`parar por aqui\` fecha o resumo com o que andou. É sempre legítimo.
+
+**Quando ele pedir para ver antes**, mostre as linhas e volte a perguntar - isso não conta
+como resposta.
+
+**Na opção 2, liste as variáveis dele quando houver mais de uma candidata.** Ele não decora
+o vocabulário do próprio projeto, e escolher entre dois nomes é mais fácil que lembrar de
+um.
 
 ## 5. AS REGRAS, QUE É A METADE QUE NENHUM COMANDO FAZ
 
@@ -167,8 +218,8 @@ 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\`
+NÃO cumpre       vira um ITEM da fila, com arquivo, linha e as três saídas
+a regra não fala sobre isto   vira um item de decisão - uma regra nova
 \`\`\`
 
 Uma regra que você teve que interpretar para aplicar não é "cumpre". É o terceiro caso.
@@ -178,22 +229,25 @@ as que TÊM conserto pronto - é a melhor notícia do relatório vestida como a
 
 ## 6. OS PEDIDOS - você mostra o comando, ele roda
 
-Três destinos, e todos existem:
+Quando ele escolhe a saída 3, existem três destinos, e todos existem de verdade:
 
 \`\`\`
-valor sem nome no sistema
+um valor sem nome no sistema
   -> npx synthesisui request token --value "<valor>" --name "<como se chamaria>" --for "<o caso>"
-peça que falta
+uma peça que falta
   -> npx synthesisui request component --name "<nome>" --for "<o caso>"
-a doutrina não cobre este caso
+o sistema não tem regra sobre 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á
+fica local mesmo". Antes de propor uma regra nova, 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
+E o nome que você propõe para a variável nova segue a convenção DELE. Se o projeto escreve
+\`--color-lightgray-700\`, o valor novo não vira \`--ds-color-neutral-4\`.
+
+## 6b. A RÉGUA É O QUE DÁ PARA FAZER HOJE, 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
@@ -203,46 +257,77 @@ 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
+2 o projeto já nomeia   -> alcançável hoje: 67%
+1 ninguém nomeia        -> precisa de uma decisão dele
+\`\`\`
+
+Então o teto de hoje é 67% - e ao falar com ele, isso não se chama "alcançável", se chama
+*"o máximo que dá para resolver sem você decidir nada novo"*.
+
+## 6b-2. O ÚLTIMO ITEM DA FILA É MANDAR O REGISTRO
+
+Cada escrita fica gravada numa fila local, e ela **nunca toca a rede** sozinha - essa
+divisão é o que mantém a verificação instalada. Uma skill que mandasse por conta própria
+seria a verificação ligando para casa.
+
+Então o envio é um item como os outros, o último, e ele só acontece se ele mandar:
+
+\`\`\`
+item 8 de 8
+
+  você mudou 3 coisas nesta conversa. A plataforma ainda está pontuando este
+  repositório pelo que ela viu da última vez.
+
+  [mandar agora]  [depois]        npx synthesisui sync --record-only
+\`\`\`
+
+**\`--record-only\`, e não \`sync\` puro.** O \`sync\` completo re-mede tudo e reescreve as
+receitas no RASCUNHO - fazer isso no fim de uma revisão move o chão de quem está revisando.
+
+O \`sync\` COMPLETO é outro item, e só aparece quando algum item mexeu em FUNDAÇÃO (uma cor,
+um degrau, uma variável nova). Aí a plataforma precisa reler, e a skill diz isso sem jargão:
+
+\`\`\`
+isto mexeu numa das bases do seu design system, então a plataforma precisa reler o
+seu repositório. Você vê o resultado antes de publicar - ele reescreve as receitas no rascunho.
+  [rodar agora]  [depois]     npx synthesisui sync
 \`\`\`
 
-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.
+Se nada foi escrito, não ofereça nem um nem outro. Um item que não tem o que mandar é ruído.
 
 ## 6c. FECHE PELO QUE ANDOU, E MOSTRE O CAMINHO ATÉ 100%
 
 \`\`\`
-<Componente>   <n> arquivos
+OverviewHeaderInformation   2 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
+dá para resolver hoje   82%   é o que o seu vocabulário já cobre
+resolvido               82%   ✓ nada mecânico ficou para trás
+deixado como estava      12   os \`em\`, que podem mexer no layout
+esperando você            3   valores que ainda não têm nome
 \`\`\`
 
 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"*.
+o seu 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)
+  1. autorize o pedido no painel   (ele já está na fila)
   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".
+Autorizar escreve o RASCUNHO, e o repo recebe a última PUBLICADA - por isso os dois passos.
+Prometer que \`upgrade\` sozinho traz a variável é 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
+dá para resolver hoje  100%
+resolvido              100%   ✓ este componente está inteiro no seu design system
 \`\`\`
 
 ## 7. ROTINA
@@ -255,8 +340,8 @@ depois de mexer  componente novo, ou alteração grande: rode ANTES do commit, e
                  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.
+A verificação automática já roda a metade determinística a cada escrita, calada quando não
+há o que dizer. Esta skill é o passo deliberado: ela junta a verificação, 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/package.json

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