synthesisui 0.16.443 → 0.16.444

package/dist/commands/import.js

@@ -3656,7 +3656,14 @@ async function askName(suggested) {
  * Never blocks without a person: no TTY means the caller's `--scheme` or the
  * measured default stands.
  */
-async function askScheme(suggested) {
+async function askScheme(suggested, 
+/** Quem pergunta por outro motivo traz o seu - ver `askFaceFromEvidence`. */
+cabecalho = {
+    titulo: "Your ladder reaches both ends",
+    linhas: [
+        "Both schemes get built from tokens you already declare. Pick the default.",
+    ],
+}) {
     if (!process.stdin.isTTY || !process.stdout.isTTY)
         return suggested;
     const options = ["dark", "light"];
@@ -3664,8 +3671,9 @@ async function askScheme(suggested) {
     if (at < 0)
         at = 0;
     console.log("");
-    console.log(section("Your ladder reaches both ends"));
-    console.log(body(paint.faint("Both schemes get built from tokens you already declare. Pick the default.")));
+    console.log(section(cabecalho.titulo));
+    for (const linha of cabecalho.linhas)
+        console.log(body(paint.faint(linha)));
     console.log("");
     const render = (first) => {
         if (!first)
@@ -3726,6 +3734,48 @@ async function askScheme(suggested) {
         stdin.on("data", onData);
     });
 }
+/**
+ * A FACE PERGUNTADA COM A EVIDÊNCIA NA FRENTE - decidido por ele em 2026-09-20.
+ *
+ * O QUE ACONTECIA: um projeto que escreve tema em UTILITÁRIO (`dark:bg-…`) e não em token por
+ * escopo caía inteiro em `mustNotGuessPolarity` - a esteira ficava calada, o censo ia sem face, e
+ * o sistema nascia com a face nativa da semente. Medido no `codelevel-monorepo` em 20/09: 255
+ * utilitários dark em 50 arquivos, 0 tokens declarados por escopo, e um sistema `light` no fim.
+ *
+ * POR QUE ISTO NÃO REABRE A PORTA QUE 28/08 FECHOU: aquele portão recusa o palpite por
+ * LUMINÂNCIA - deduzir a face contando quão escuros são os neutros. Aqui não se deduz nada: um
+ * número medido é mostrado e a pessoa responde. Sem TTY, continua sem resposta, que é o ponto.
+ *
+ * E OS DOIS LADOS VÃO JUNTOS. A evidência que abre a pergunta é dark; a página base pode pintar
+ * claro, e isso aparece na mesma tela. Mostrar só a metade que motivou a pergunta seria conduzir
+ * a resposta.
+ */
+export function faceQuestion(census) {
+    const t = census.signals?.theme;
+    if (!t || t.darkUtilities <= 0)
+        return null;
+    const linhas = [
+        `${t.darkUtilities} dark utilit${t.darkUtilities === 1 ? "y" : "ies"} across ${t.darkFiles} file${t.darkFiles === 1 ? "" : "s"} - a second scheme is real here, and no token of yours says which face opens.`,
+    ];
+    const base = (t.page ?? []).find((p) => p.scheme === "light");
+    if (base)
+        linhas.push(`Your light page paints \`${base.token}\` on ${base.source.replace(/-/g, " ")} - the other half of the same question.`);
+    linhas.push("Nothing is guessed from this. You answer, and we write it down.");
+    return { titulo: "Which face does this project open in", linhas };
+}
+/**
+ * E A PERGUNTA SÓ ACONTECE COM ALGUÉM NA FRENTE. Sem TTY não há resposta, e seguir sem ela é o
+ * comportamento que `mustNotGuessPolarity` garante desde 28/08 - o que muda é que agora existe
+ * uma pergunta a fazer quando há alguém para responder.
+ */
+export async function askFaceFromEvidence(census) {
+    const pergunta = faceQuestion(census);
+    if (!pergunta)
+        return undefined;
+    if (!process.stdin.isTTY || !process.stdout.isTTY)
+        return undefined;
+    return await askScheme("dark", pergunta);
+}
 /**
  * Which end to offer first when both are available.
  *
@@ -3788,19 +3838,13 @@ export function defaultScheme(declared) {
 }
 /** On a dry run there is nobody to ask, so say what was measured. */
 /**
- * A TELA DO `inspect`, E O ARQUIVO QUE CARREGA O RESTO (dono, 18/09).
+ * O QUE SOBRA DA LEITURA NA TELA, e os dois comandos mostram a MESMA coisa.
  *
- * O QUE O CLIENTE GANHA: ele decide sem rolar. Ficam na tela os quatro blocos que MUDAM o que ele
- * vai fazer em seguida - quanto foi lido, se o root tem mais de um app, o que não resolve, e onde
- * está a leitura inteira. Medido na saída dele em 18/09: 250 linhas, 94 delas a mesma frase sobre
- * nome de parte. Nada se perde: o texto inteiro está no relatório, escrito pela MESMA esteira.
- *
- * A FRASE DO CONTRATO MUDA, E É A ÚNICA COISA QUE MUDA: era "nothing was written, and nothing was
- * sent". Passa a dizer a verdade - nada enviado, um arquivo escrito, e aqui está ele. Uma frase que
- * promete silêncio enquanto o comando escreve um arquivo é pior que o arquivo.
+ * O número que diz o quanto entrou, e as duas seções que mudam o comando seguinte. Elas saem do
+ * transcrito em vez de serem reescritas: a régua que as produziu é a mesma, então a tela nunca
+ * diverge do relatório.
  */
-async function mostrarInspecao(c, root, transcrito) {
-    const secoes = secoesDe(transcrito);
+function mostrarLeitura(c, secoes, titulos = DECIDEM) {
     const valores = c.values?.classes;
     const decisoes = valores ? valores.seen - valores.structure : 0;
     const pct = valores && decisoes > 0
@@ -3808,8 +3852,70 @@ async function mostrarInspecao(c, root, transcrito) {
         : null;
     const lidos = c.coverage?.read ?? 0;
     const total = c.coverage?.components ?? 0;
+    console.log(section("What came out of your files"));
+    console.log(body(`${paint.strong(`${lidos} of ${total}`)} components came out with a blueprint${pct === null
+        ? ""
+        : `, and ${paint.strong(`${pct}%`)} of your ${decisoes} style decisions carry your own vocabulary`}.`));
+    /**
+     * TODAS as ocorrências, e não a primeira: um import com dois escopos declara a organização de
+     * CADA um, e `find` mostraria `packages/ui` e engoliria `packages/charts` - a segunda lacuna
+     * viraria silêncio, que é exatamente o que `INV-COB-08` existe para impedir.
+     */
+    for (const titulo of titulos) {
+        for (const achada of secoes.filter((s) => s.titulo === titulo)) {
+            console.log(section(titulo));
+            for (const linha of achada.linhas)
+                console.log(linha);
+        }
+    }
+}
+/**
+ * O RELATÓRIO DO `import`, ESCRITO SEM PERGUNTAR - e a diferença com o `inspect` é de contrato.
+ *
+ * `INV-INSPECT-01` promete que o `inspect` não toca no repositório, e por isso lá o arquivo só
+ * nasce depois de um sim. O `import` já escreveu o censo, o `not-expressed.md`, o `.gitignore` e
+ * a pasta `ds/` antes de chegar aqui: parar para perguntar por um HTML seria cerimônia, não
+ * proteção. Quem quer olhar antes de escrever tem `--dry` e `inspect`.
+ */
+async function escreverRelatorio(c, root, secoes) {
+    if (secoes.length === 0)
+        return;
     const arquivo = join(root, "_synthesisui", "report.html");
-    const html = () => relatorioHtml({
+    try {
+        await mkdir(dirname(arquivo), { recursive: true });
+        await writeGovernanceIgnore(root).catch(() => null);
+        await writeFile(arquivo, relatorioDe(c, root, secoes), "utf8");
+    }
+    catch (error) {
+        /* O relatório é o resto da leitura, não o trabalho: um disco cheio no fim de um import que
+           deu certo não pode terminar como falha. Diz o que não deu e devolve o terminal. */
+        console.log("");
+        console.log(body(`The full report was not written: ${error instanceof Error ? error.message : String(error)}`));
+        return;
+    }
+    console.log("");
+    console.log(section("The whole reading, in one file"));
+    console.log(body(`${secoes.length} sections did not print here - every value, every fragment, every part.`));
+    console.log(body(`    ${paint.strong(relative(root, arquivo))}`));
+    console.log(body(`    ${paint.dim(`file://${arquivo}`)}`));
+    console.log("");
+}
+/**
+ * O RELATÓRIO, MONTADO NUM LUGAR SÓ E LIDO POR DOIS COMANDOS.
+ *
+ * O `inspect` e o `import` cortam a mesma tela e guardam o mesmo resto. Duas montagens do mesmo
+ * documento divergiriam no dia em que uma fosse editada - e a esteira de captura existe
+ * exatamente para que cada medição tenha UMA redação.
+ */
+function relatorioDe(c, root, secoes) {
+    const valores = c.values?.classes;
+    const decisoes = valores ? valores.seen - valores.structure : 0;
+    const pct = valores && decisoes > 0
+        ? Math.round((valores.interpreted / decisoes) * 100)
+        : null;
+    const lidos = c.coverage?.read ?? 0;
+    const total = c.coverage?.components ?? 0;
+    return relatorioHtml({
         cabecalho: {
             repo: c.measured?.repo ?? basename(root),
             medidoEm: c.measured?.at ?? "",
@@ -3864,22 +3970,24 @@ async function mostrarInspecao(c, root, transcrito) {
         muda: oQueMuda(c),
         passos: passos(),
     });
-    console.log(section("What came out of your files"));
-    console.log(body(`${paint.strong(`${lidos} of ${total}`)} components came out with a blueprint${pct === null
-        ? ""
-        : `, and ${paint.strong(`${pct}%`)} of your ${decisoes} style decisions carry your own vocabulary`}.`));
-    /**
-     * OS DOIS BLOCOS QUE MUDAM O QUE ELE FAZ EM SEGUIDA, e eles saem do transcrito em vez de serem
-     * reescritos: a régua que os produziu é a mesma, então a tela nunca diverge do relatório.
-     */
-    for (const titulo of DECIDEM) {
-        const achada = secoes.find((s) => s.titulo === titulo);
-        if (!achada)
-            continue;
-        console.log(section(titulo));
-        for (const linha of achada.linhas)
-            console.log(linha);
-    }
+}
+/**
+ * A TELA DO `inspect`, E O ARQUIVO QUE CARREGA O RESTO (dono, 18/09).
+ *
+ * O QUE O CLIENTE GANHA: ele decide sem rolar. Ficam na tela os quatro blocos que MUDAM o que ele
+ * vai fazer em seguida - quanto foi lido, se o root tem mais de um app, o que não resolve, e onde
+ * está a leitura inteira. Medido na saída dele em 18/09: 250 linhas, 94 delas a mesma frase sobre
+ * nome de parte. Nada se perde: o texto inteiro está no relatório, escrito pela MESMA esteira.
+ *
+ * A FRASE DO CONTRATO MUDA, E É A ÚNICA COISA QUE MUDA: era "nothing was written, and nothing was
+ * sent". Passa a dizer a verdade - nada enviado, um arquivo escrito, e aqui está ele. Uma frase que
+ * promete silêncio enquanto o comando escreve um arquivo é pior que o arquivo.
+ */
+async function mostrarInspecao(c, root, transcrito) {
+    const secoes = secoesDe(transcrito);
+    const arquivo = join(root, "_synthesisui", "report.html");
+    const html = () => relatorioDe(c, root, secoes);
+    mostrarLeitura(c, secoes);
     /**
      * O ARQUIVO SÓ NASCE SE ELE PEDIR (dono, 18/09) - e é isto que mantém `INV-INSPECT-01` de pé.
      *
@@ -3955,6 +4063,18 @@ const DECIDEM = [
     "This root holds several projects",
     "These resolve to nothing",
 ];
+/**
+ * E O `import` CARREGA UMA A MAIS: como o projeto está organizado.
+ *
+ * `INV-COB-08` promete essa seção no terminal de quem importa - é ali que uma organização que
+ * esta versão não sabe nomear se declara, com o número medido, em vez de sumir. Ela cabe porque
+ * em 20/09 as 120 linhas de nome de parte saíram de dentro dela e ganharam seção própria; sem
+ * essa separação, honrar o invariante custaria o despejo inteiro de volta.
+ */
+const NA_TELA_DO_IMPORT = [
+    "How this project is organised",
+    ...DECIDEM,
+];
 function sayReach(c) {
     const reach = ladderReach(c.declared);
     console.log("");
@@ -4424,8 +4544,17 @@ quiet = false) {
     }
     const authored = Object.keys(read).length;
     const total = authored || Object.keys(census.looks ?? {}).length;
+    /**
+     * A ANATOMIA GANHA CABEÇALHO PRÓPRIO - e antes de 20/09 ela não tinha nenhum.
+     *
+     * Sem régua, estas linhas pertenciam à última seção aberta, que é "How this project is
+     * organised". Na saída medida do `codelevel-monorepo` isso deu uma seção de 124 linhas em que
+     * as quatro primeiras falavam de organização e as outras 120 falavam de nome de parte. Quem
+     * lia não estava lendo uma seção longa: estava lendo duas coladas por acidente de parser.
+     */
     if (named > 0 || shaped > 0) {
         say("");
+        say(section("What your components are made of"));
         say(body(
         // "Your reading" only when there WAS one - otherwise the names came off
         // their own markup, and claiming otherwise credits somebody's absent work.
@@ -4444,8 +4573,17 @@ quiet = false) {
         say(body(`${libs.size} librar${libs.size === 1 ? "y" : "ies"} your components need (${named_}) - ${libs.size === 1 ? "it does" : "they do"} not render here, and what to know about ${libs.size === 1 ? "it" : "them"} travels as rules`));
     }
     // NO SILENT FIX. A correction made quietly is a lie about what they wrote.
-    for (const n of notes)
-        say(body(n));
+    /**
+     * E ELAS SÃO UMA SEÇÃO, não um rodapé da anterior: são 94 linhas na saída medida dele, uma
+     * por parte cujo nome colidiu. O fato de cada uma é verdadeiro e nenhuma muda o passo
+     * seguinte - é exatamente o material do relatório.
+     */
+    if (notes.size > 0) {
+        say("");
+        say(section("Names your own classes produced"));
+        for (const n of notes)
+            say(body(n));
+    }
 }
 export async function runImport(opts) {
     const root = opts.root ?? process.cwd();
@@ -4568,15 +4706,20 @@ export async function runImport(opts) {
             phase(1, 3, "Measuring the repository");
         console.log(section("Reading your project"));
         /**
-         * A PARTIR DAQUI O `inspect` GUARDA EM VEZ DE IMPRIMIR - ver `transcript.ts`.
+         * A PARTIR DAQUI OS DOIS GUARDAM EM VEZ DE IMPRIMIR - ver `transcript.ts`.
          *
          * As dezessete seções continuam sendo escritas exatamente como sempre foram; o que muda é o
-         * destino. Elas vão para o relatório, e o terminal fica com os quatro blocos que uma pessoa
-         * usa para DECIDIR. Medido na saída do `codelevel-monorepo` em 18/09: 250 linhas, das quais 94
-         * eram a mesma frase sobre nome de parte - 40% do relatório num detalhe sem ação possível.
+         * destino. Elas vão para o relatório, e o terminal fica com os blocos que uma pessoa usa para
+         * DECIDIR. Medido na saída do `codelevel-monorepo` em 18/09: 250 linhas, das quais 94 eram a
+         * mesma frase sobre nome de parte - 40% do relatório num detalhe sem ação possível.
+         *
+         * O `import` ENTROU AQUI EM 20/09, e a régua é dele: *"a mesma tela do `inspect`"*. O corte
+         * existia desde 18/09 e valia só para o comando que NÃO escreve - então quem importava de
+         * verdade, que é quem mais precisa entender o que aconteceu, continuava recebendo o despejo.
+         * Medido na saída dele naquele dia: 485 linhas, 42.645 caracteres, 23 seções, e três frases
+         * ocupando 116 das 393 linhas com conteúdo.
          */
-        if (opts.inspect)
-            ligarCaptura();
+        ligarCaptura();
         /**
          * UMA MEDIÇÃO POR ESCOPO, E DEPOIS A FUSÃO.
          *
@@ -4697,6 +4840,15 @@ export async function runImport(opts) {
         await mostrarInspecao(census, root, transcrito);
         return;
     }
+    /**
+     * O QUE O `import` GUARDOU, e ele segue - a leitura acabou, o envio não começou.
+     *
+     * O `inspect` termina aqui porque a leitura ERA o comando. O `import` continua, então a tela
+     * ganha o mesmo resumo e o transcrito espera: o relatório só é escrito no fim, quando as
+     * seções do sistema criado já tiverem entrado nele.
+     */
+    const relatorio = secoesDe(desligarCaptura());
+    mostrarLeitura(census, relatorio, NA_TELA_DO_IMPORT);
     const out = opts.census ?? join(root, "_synthesisui", "census.json");
     await mkdir(dirname(out), { recursive: true });
     await writeFile(out, `${JSON.stringify(census, null, 2)}\n`, "utf8");
@@ -4725,6 +4877,9 @@ export async function runImport(opts) {
         /* `printComponents` subiu para antes de `summarize` e vale para todo caminho - repetir
            aqui imprimiria os componentes duas vezes na mesma execução. */
         printAgentContract();
+        /* O `--dry` já escreveu o censo nesta pasta; guardar a leitura ao lado dele é o mesmo gesto,
+           e sem isso quem pede para olhar antes de enviar sai sem a tela E sem o arquivo. */
+        await escreverRelatorio(census, root, relatorio);
         console.log("");
         return;
     }
@@ -4746,7 +4901,7 @@ export async function runImport(opts) {
             ? read.has[0]
             : (observedPolarity(census) ??
                 (mustNotGuessPolarity(census)
-                    ? undefined
+                    ? await askFaceFromEvidence(census)
                     : reach.light && reach.dark
                         ? await askScheme(defaultScheme(census.declared))
                         : reach.dark
@@ -4908,8 +5063,18 @@ export async function runImport(opts) {
      */
     if (payload?.group)
         console.log(body(paint.dim(`In the group ${payload.group}.`)));
-    for (const note of payload?.notes ?? [])
-        console.log(body(paint.dim(note)));
+    /**
+     * AS NOTAS DO QUE FOI MAPEADO VÃO PARA O RELATÓRIO (dono, 20/09).
+     *
+     * São 57 linhas na saída medida dele - cada token que chegou, cada um que esperou, cada papel
+     * que ficou com o nome dele. Nada disso muda o comando seguinte, e todas juntas empurram para
+     * fora da tela as três linhas que mudam: onde o sistema está, o que falta instalar e a URL.
+     */
+    if ((payload?.notes ?? []).length > 0)
+        relatorio.push({
+            titulo: "What your system carries",
+            linhas: (payload?.notes ?? []).map((note) => `  ${note}`),
+        });
     /**
      * A NOTA COM QUE O SISTEMA DELE NASCEU, e as três lentes - ver `baseline-craft.ts`.
      *
@@ -4934,8 +5099,13 @@ export async function runImport(opts) {
         console.log("");
         console.log(section("What a v2 would normalize"));
         console.log(body(`${paint.strong(String(n.decisions))} colour decision${n.decisions === 1 ? "" : "s"} to settle - ${paint.strong(String(n.governs ?? n.retires ?? 0))} uses would come under a name.`));
-        for (const line of n.lines ?? [])
-            console.log(body(paint.dim(line)));
+        /* O NÚMERO fica na tela e a lista vai para o arquivo: a decisão é aprovar ou não, e ela se
+           toma com "27 decisões, 112 usos". Qual hex absorve qual é a leitura de quem já disse sim. */
+        if ((n.lines ?? []).length > 0)
+            relatorio.push({
+                titulo: "What a v2 would normalize",
+                linhas: (n.lines ?? []).map((line) => `  ${line}`),
+            });
         console.log("");
         console.log(body("Nothing was changed. You approve it there:"));
     }
@@ -5016,4 +5186,11 @@ export async function runImport(opts) {
             console.log("");
         }
     }
+    /**
+     * E O RESTO DA LEITURA, POR ÚLTIMO - depois de tudo que ele PRECISA fazer.
+     *
+     * O caminho do arquivo é a última linha de propósito: quem vai agir já leu o que agir, e quem
+     * quer entender o que a medição encontrou sai daqui com um endereço em vez de um scroll.
+     */
+    await escreverRelatorio(census, root, relatorio);
 }

package/package.json

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