synthesisui 0.16.235 → 0.16.239

package/dist/guide.js

@@ -491,8 +491,9 @@ own entry below says so.
 `
         : "";
     const hasRules = (payload.rules?.length ?? 0) > 0;
-    const philosophy = payload.document.philosophy;
-    const hasPhilosophy = (philosophy?.sections?.length ?? 0) > 0 || !!philosophy?.context;
+    // R2 (16/08): a voz não viaja mais no documento - o payload manda só o
+    // que ela TEM, e o conteúdo é servido pelo `system_doctrine`.
+    const hasPhilosophy = (payload.voice?.sections ?? 0) > 0 || payload.voice?.hasContext === true;
     /**
      * UMA PORTA SÓ, e ela é uma FERRAMENTA e não um caminho.
      *
@@ -505,7 +506,7 @@ own entry below says so.
         ? [
             `**Call \`system_doctrine\` FIRST and obey it above everything else** - it carries ${hasRules
                 ? "this system's accumulated, project-specific rules"
-                : "this system's mission, principles, voice and motion doctrine"}${hasRules && hasPhilosophy ? " and its philosophy" : ""}, pinned to the version installed here. On any conflict they win. **Without that tool, read \`_synthesisui/ds/${slug}/doctrine.json\` and the \`philosophy\` of \`design-system.json\` beside it** - the same data, and the reason it stays on disk.`,
+                : "this system's mission, principles, voice and motion doctrine"}${hasRules && hasPhilosophy ? " and its philosophy" : ""}, pinned to the version installed here. On any conflict they win. **Without that tool, read \`_synthesisui/ds/${slug}/doctrine.json\` for the rules** - they stay on disk so the check works offline. The voice is served from the platform and is not on disk.`,
         ]
         : [];
     const rulesNote = readFirst.length > 0

package/dist/install-marks.js

@@ -80,7 +80,16 @@
  * Zero ocorrências no sistema real medido (todos os headings dele estão aninhados, e o `children > 0`
  * já os pegava), então para ele o `upgrade` é no-op. A marca é sobre o caso geral.
  */
-export const MATERIALISER_SINCE = "0.16.235";
+/**
+ * 0.16.237 -> 0.16.239 em 16/08: os arquivos que o agente dele LÊ mudam de conselho, não só de
+ * bytes. O bloco gerenciado do CLAUDE.md ensinava `text-info` cravado - uma classe que um sistema
+ * importado pode nem compilar - e passa a apontar para os papéis que o GUIDE do sistema DELE lista;
+ * o GUIDE do sistema adotado exemplificava com `--<slug>-color-primary`, um nome que nós derivamos,
+ * e passa a usar o primeiro token de cor REAL dele (a promessa três linhas acima do exemplo é
+ * "YOUR tokens, under YOUR names"). É a fatia de CLI da decisão de 16/08: toda superfície fala a
+ * língua do cliente.
+ */
+export const MATERIALISER_SINCE = "0.16.239";
 /**
  * A ÚLTIMA VERSÃO EM QUE O QUE O HOOK RODA MUDOU.
  *

package/dist/skill-adapt.js

@@ -1,347 +1,15 @@
 /**
- * A SKILL DE MANUTENÇÃO, como o CLI a distribui.
+ * O STUB DA SKILL - o corpo é SERVIDO, não embarcado (R1, dono 16/08).
  *
- * 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.
+ * O playbook inteiro morava aqui (13 KB) e, por consequência, no tarball
+ * público do npm e no repo de cada cliente em texto plano. Ele mudou para a
+ * plataforma (apps/web/src/lib/ds/playbooks.ts, gêmeo por spec do
+ * `.claude/skills/sui-adapt/SKILL.md`) e é servido pelo catalogue autenticado -
+ * a mesma doutrina de sempre: SERVED, NOT SHIPPED. O agente busca o sumário
+ * e depois SÓ o capítulo do passo em que está (a dieta de contexto).
  *
- * 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.
+ * O frontmatter fica INTEIRO no stub: é a description que faz a skill ser
+ * invocada, e ela não é segredo - a esteira é.
  */
-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. 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. 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        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
-\`\`\`
-
-## 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 - **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, 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
-
-Duas portas, mesma resposta. Use a que a sessão tiver:
-
-\`\`\`
-MCP        check_file { path }
-terminal   npx synthesisui doctor <alvo>
-\`\`\`
-
-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:
-
-\`\`\`
-sua ferramenta está em dia
-
-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
-\`\`\`
-
-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:
-
-\`\`\`
-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
-\`\`\`
-
-## 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 numa fila ÚNICA e **ordene por custo**:
-
-\`\`\`
-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, e em uma frase que ele leia:
-
-\`\`\`
-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 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. O corpo fala do componente dele, e termina numa
-pergunta:
-
-\`\`\`
-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?
-
-    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
-
-  [1] [2] [3]   ou me diga outra coisa · [parar por aqui]
-\`\`\`
-
-As três saídas são sempre as mesmas, porque são as três que existem de verdade:
-
-\`\`\`
-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
-\`\`\`
-
-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
-
-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 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.
-
-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
-
-Quando ele escolhe a saída 3, existem três destinos, e todos existem de verdade:
-
-\`\`\`
-um valor sem nome no sistema
-  -> npx synthesisui request token --value "<valor>" --name "<como se chamaria>" --for "<o caso>"
-uma peça que falta
-  -> npx synthesisui request component --name "<nome>" --for "<o 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 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.
-
-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
-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 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
-\`\`\`
-
-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%
-
-\`\`\`
-OverviewHeaderInformation   2 arquivos
-
-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 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 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.
-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ó:
-
-\`\`\`
-dá para resolver hoje  100%
-resolvido              100%   ✓ este componente está inteiro no seu design system
-\`\`\`
-
-## 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
-\`\`\`
-
-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";
+export const ADAPT_SKILL = '---\nname: sui-adapt\ndescription: Confronta UM componente (ou uma p\u00e1gina, ou uma pasta) contra o design system instalado e adapta o que der - cobertura de token medida, conserto mec\u00e2nico proposto antes de escrever, e o que sobra classificado em "regra nova" ou "conserto local". Use quando algu\u00e9m aponta para uma pe\u00e7a e pergunta se ela est\u00e1 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\u00f5e antes de escrever, e nunca arquiva pedido em nome de ningu\u00e9m.\n---\n\n# Adaptar uma pe\u00e7a ao sistema - 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": "adapt" } - you get the framing and a table of contents.\n2. Fetch ONLY the chapter for the step you are on:\n   { "skill": "adapt", "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\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';