synthesisui 0.16.363 → 0.16.365

package/dist/baseline-craft.js

@@ -0,0 +1,42 @@
+/**
+ * A NOTA DO SISTEMA DELE E AS TRÊS LENTES QUE A COMPÕEM, no fim de um import.
+ *
+ * O QUE O CLIENTE GANHA: ele fecha o import sabendo em que pé o sistema dele nasceu - a nota, e as
+ * três lentes que dizem POR QUE ela é aquela - sem abrir o navegador. Quem apaga e recria um
+ * sistema para comparar antes e depois tinha de abrir a tela ou rodar um script sobre o banco, e o
+ * número que mais interessa naquele momento é exatamente esse.
+ *
+ * OS NÚMEROS SÃO IMPRESSOS, NUNCA COMPOSTOS - e a razão foi medida duas vezes em 24/08, quando o
+ * resumo escrito pelo agente derrubou justamente a metade que tinha acabado de entrar. Este módulo
+ * não calcula nada: ele formata o que o servidor devolveu, pela mesma função que desenha a tela
+ * pós-import. Um número calculado em dois lugares tem duas chances de discordar de si mesmo.
+ *
+ * E TODA LINHA CARREGA O SEU DENOMINADOR. "Token Discipline 62" sozinho não é auditável; "62, on 41
+ * of your 62 components" é - e é a mesma frase que a tela mostra embaixo de cada barra.
+ */
+import { body, bodyWrapped, paint } from "./output.js";
+/**
+ * AS LINHAS DO BLOCO, ou vazio quando não há nota para dar.
+ *
+ * Vazio e não uma linha vazia: quem chama decide se imprime o título, e um bloco com cabeçalho e
+ * nada embaixo é pior que bloco nenhum.
+ */
+export function craftLines(craft) {
+    if (!craft)
+        return [];
+    if (craft.score === null) {
+        return bodyWrapped("No component of yours was read yet, so there is no line to draw. Your tokens came through - the components are next.").map(body);
+    }
+    const lines = [
+        body(`${paint.strong(`${craft.score}/100`)} on your ${craft.authored} component${craft.authored === 1 ? "" : "s"} - never on our kit, never on a demo.`),
+    ];
+    /**
+     * OS RÓTULOS ALINHADOS PELO MAIS LONGO, e a largura é medida e não estimada: os nomes chegam do
+     * servidor, então um padding fixo desalinharia no dia em que uma lente for renomeada lá.
+     */
+    const width = Math.max(...craft.lenses.map((l) => l.label.length));
+    for (const lens of craft.lenses) {
+        lines.push(body(`  ${lens.label.padEnd(width)}  ${paint.strong(String(lens.score).padStart(3))}  ${paint.dim(`on ${lens.measuredOn} of them`)}`));
+    }
+    return lines;
+}

package/dist/commands/align.js

@@ -10,6 +10,7 @@ import { readRequests } from "../doctor/requests.js";
 import { declaredReference } from "../group-role.js";
 import { CHECKER_SINCE, installedBehind, MATERIALISER_SINCE, READER_SINCE, } from "../install-marks.js";
 import { fmt, say } from "../lang.js";
+import { mcpAwaitingApproval } from "../mcp-approval.js";
 import { measuredScope } from "../measured-scope.js";
 import { body, bodyWrapped, paint, section, snippet } from "../output.js";
 import { SKILLS } from "../skills.js";
@@ -96,6 +97,25 @@ export async function localMisalignments(root,
 opts = {}) {
     const { cli, home = homedir() } = opts;
     const out = [];
+    /**
+     * O PORTÃO QUE MATOU UM IMPORT INTEIRO, dito na sessão em que ele está fechado.
+     *
+     * Medido em 03/09: o agente mediu 262 arquivos, leu 78 componentes, descreveu a paleta dele - e
+     * parou, porque o playbook do import é servido pelo MCP e a aprovação estava pendente. Isto vem
+     * ANTES de qualquer outro desalinho porque é o único que impede a jornada principal de começar:
+     * um repo sem sistema não está desalinhado, e um repo cujas ferramentas ninguém aprovou não pode
+     * nem medir de volta.
+     *
+     * `/mcp` e não um comando de terminal: quem aprova é o agente, e um `npx` aqui mandaria a pessoa
+     * ao lugar errado. Ver `mcp-approval.ts` para de onde o estado é lido, e para o silêncio quando
+     * não há como saber.
+     */
+    if ((await mcpAwaitingApproval(root, home).catch(() => null)) === true)
+        out.push({
+            says: "The system's tools are declared here and still waiting for your approval - until you give it, I cannot reach the import playbook, only measure your files.",
+            run: "/mcp",
+            then: "then say: import my design system",
+        });
     const locks = (await locksIn(root)).filter((l) => l.slug && !l.adopted);
     /** Sem sistema instalado não há alinho a cobrar - não é desalinho, é um repo sem DS. */
     if (locks.length === 0)

package/dist/commands/import.js

@@ -3,6 +3,7 @@ import { basename, dirname, join, relative, resolve, sep } from "node:path";
 import { anatomyFromSketch } from "../anatomy-from-sketch.js";
 import { applyAnatomyPatch, hasEdits, } from "../anatomy-patch.js";
 import { resolveAnatomy, resolveFlatParts, safePartName, } from "../anatomy-read.js";
+import { craftLines } from "../baseline-craft.js";
 import { PAGES_MAX, pageCompositionOf } from "../census-pages.js";
 import { readCredentials, readToken, resolveRegistry, sameRegistry, } from "../config.js";
 import { declaredElsewhere } from "../declared-elsewhere.js";
@@ -4524,6 +4525,22 @@ export async function runImport(opts) {
         console.log(body(paint.dim(`In the group ${payload.group}.`)));
     for (const note of payload?.notes ?? [])
         console.log(body(paint.dim(note)));
+    /**
+     * A NOTA COM QUE O SISTEMA DELE NASCEU, e as três lentes - ver `baseline-craft.ts`.
+     *
+     * AQUI E NÃO DEPOIS DO v2, porque o v2 argumenta com estes mesmos números: uma proposta que
+     * promete melhorar a disciplina de token precisa que a disciplina de hoje já esteja na tela.
+     * É a ordem que a tela pós-import usa, e ela é deliberada lá pelo mesmo motivo.
+     *
+     * O bloco cala sozinho quando não há nota - servidor anterior a esta versão, ou análise que não
+     * pôde rodar. Um cabeçalho sem número embaixo seria pior que o silêncio.
+     */
+    const craft = craftLines(payload?.quality);
+    if (craft.length > 0) {
+        console.log(section("The line your system starts on"));
+        for (const line of craft)
+            console.log(line);
+    }
     // What a v2 would be worth, in their own values. Said here because this is
     // where the person is standing, and because a number they can check beats an
     // invitation they have to trust.

package/dist/mcp-approval.js

@@ -0,0 +1,79 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+/**
+ * AS FERRAMENTAS DECLARADAS E ESPERANDO APROVAÇÃO - o portão que matou um import inteiro.
+ *
+ * O QUE O CLIENTE GANHA: a sessão em que a aprovação está pendente é a sessão que lhe diz isso.
+ * Antes ele descobria no meio do import, quando o agente já tinha medido o repositório e não tinha
+ * como continuar.
+ *
+ * MEDIDO em 03/09, no segundo import real do dono. Ele rodou `import my design system`, o agente
+ * mediu 262 arquivos, leu 78 componentes, descreveu a paleta dele - e parou:
+ *
+ *     synthesisui: npx synthesisui@latest mcp - ⏸ Pending approval
+ *
+ * O playbook do import é SERVIDO pelo MCP, então sem aprovação não há import: só medição. E o
+ * `connect` avisa - em uma linha cinza, a terceira de um bloco secundário. Um portão que interrompe
+ * a jornada principal não pode ser anunciado como nota de pé de página.
+ *
+ * A ORIGEM DO DADO. O Claude Code guarda a decisão no `~/.claude.json`, por projeto:
+ *
+ *     enabledMcpjsonServers    aprovados
+ *     disabledMcpjsonServers   recusados
+ *
+ * Um servidor declarado no `.mcp.json` que não está em nenhuma das duas listas está PENDENTE - e é
+ * exatamente o estado dele. Medido: as duas listas vazias, para aquele projeto.
+ *
+ * SÓ LEITURA, NUNCA ESCRITA. Aquele arquivo é a configuração pessoal dele e vale para todos os
+ * projetos dele - a mesma fronteira do `.zshrc`, que este produto só atravessa perguntando.
+ * Escrever a aprovação por ele seria decidir em nome dele sobre um portão de segurança.
+ *
+ * E CALA QUANDO NÃO SABE. Arquivo ausente, JSON que não parseia, projeto sem entrada, formato
+ * diferente do que a gente conhece: em todos, resposta `null` e nenhuma linha na tela. Um aviso
+ * baseado num formato que mudou é pior que silêncio, porque manda a pessoa procurar um botão que
+ * talvez não exista mais.
+ */
+/** O nome do nosso servidor no `.mcp.json` - ver `wireMcpAt`. */
+const SERVER = "synthesisui";
+/**
+ * `true` quando o nosso servidor está declarado no repositório e a decisão dele ainda não foi
+ * tomada. `null` quando não há como saber - e aí quem chama não diz nada.
+ */
+export async function mcpAwaitingApproval(root, home) {
+    const declared = await readFile(join(root, ".mcp.json"), "utf8").then((raw) => {
+        try {
+            const j = JSON.parse(raw);
+            return Boolean(j.mcpServers && SERVER in j.mcpServers);
+        }
+        catch {
+            return null;
+        }
+    }, () => false);
+    /** Sem declaração não há aprovação pendente: o caso é OUTRO, e o `connect` já o cobre. */
+    if (declared !== true)
+        return declared === null ? null : false;
+    const raw = await readFile(join(home, ".claude.json"), "utf8").catch(() => null);
+    if (raw == null)
+        return null;
+    let conf;
+    try {
+        conf = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    const entry = conf.projects?.[root];
+    /**
+     * SEM ENTRADA PARA ESTE PROJETO a pessoa provavelmente nunca abriu o agente aqui - e aí não há
+     * aprovação pendente, há uma sessão que ainda não aconteceu. Dizer "aprove" a quem não foi
+     * perguntado é inventar um estado.
+     */
+    if (!entry)
+        return null;
+    const enabled = entry.enabledMcpjsonServers;
+    const disabled = entry.disabledMcpjsonServers;
+    /** Formato diferente do que a gente conhece: silêncio, nunca um palpite. */
+    if (!Array.isArray(enabled) || !Array.isArray(disabled))
+        return null;
+    return !enabled.includes(SERVER) && !disabled.includes(SERVER);
+}

package/package.json

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