synthesisui 0.16.363 → 0.16.364

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