synthesisui 0.16.362 → 0.16.363

package/dist/commands/gaps.js

@@ -15,12 +15,12 @@
 import { readdir, readFile } from "node:fs/promises";
 import { join } from "node:path";
 import { describeTriage, triageLedger } from "../doctor/gap-triage.js";
-import { body, section } from "../output.js";
+import { body, bodyWrapped, paint, section } from "../output.js";
 export async function gaps(opts) {
     const root = opts.dir ?? process.cwd();
     const path = opts.census ?? join(root, "_synthesisui", "census.json");
     const raw = await readFile(path, "utf8").catch(() => null);
-    console.log(section("What this pipeline did not read"));
+    console.log(section(opts.brief ? "What we read" : "What this pipeline did not read"));
     if (!raw) {
         console.log(body(`No measurement at ${path}. Run \`synthesisui import --dry\` first - that is what measures your files, and it writes the result there.`));
         return;
@@ -46,6 +46,8 @@ export async function gaps(opts) {
         console.log(body(`This measurement was written by a tool version that did not count style fragments yet, so the numbers do not exist rather than being zero. Run \`synthesisui import --dry\` again with ${opts.cli} to measure.`));
         return;
     }
+    if (opts.brief)
+        return brief(ledger, values);
     for (const line of describeTriage(triageLedger(ledger, opts.cli), values))
         console.log(body(line));
     /**
@@ -91,6 +93,47 @@ export async function gaps(opts) {
  * vazia. Em qualquer um dos três não há nada a dizer, e uma frase que aparece sempre é uma frase que
  * ninguém lê.
  */
+/**
+ * O RESULTADO E UMA AÇÃO - o fechamento de um import.
+ *
+ * TRÊS DECISÕES DE DESENHO, e cada uma responde a algo que o dono viu na tela em 03/09:
+ *
+ *   O PERCENTUAL EM AZUL. `paint.blue` é a cor que este produto reserva para o que está VIVO - a
+ *   barra de cobertura, os comandos, os links. A cobertura é o número que resume a entrega, e num
+ *   bloco de prosa cinza ela desaparecia ("deixe com um tom de outra cor").
+ *
+ *   A LACUNA EM UMA LINHA, COM ENDEREÇO. Ela continua dita - quantos fragmentos, em quantos
+ *   lugares - e a LISTA mora no comando sem `--brief`. Uma lacuna sem número seria silêncio; uma
+ *   lista no momento da entrega é pedir desculpa quando era hora de mostrar o resultado.
+ *
+ *   UMA CTA, COM O QUE ELA GANHA. O v2 já existe como rascunho; o que faltava era dizer o que
+ *   aprová-lo FAZ - agrupar cores quase iguais, nomear valor que carrega peso e não tem nome,
+ *   resolver o valor que carrega dois nomes dele. Um link sem consequência dita é um link que
+ *   espera para sempre.
+ */
+async function brief(ledger, values) {
+    const places = ledger.unread.length;
+    if (!values)
+        return;
+    const decisions = values.seen - values.structure;
+    const closed = values.interpreted + values.answered;
+    const pct = decisions > 0 ? Math.round((closed / decisions) * 100) : 0;
+    console.log(bodyWrapped(`${paint.blue(paint.strong(`${pct}%`))} of your design decisions are in the system - ${closed} of ${decisions}.`).join("\n"));
+    /**
+     * O QUE FALTA, NA MESMA UNIDADE DA LINHA DE CIMA - e a primeira versão desta função errou
+     * exatamente nisso.
+     *
+     * Ela dizia "222 fragments are not", ao lado de "920 de 1008": quem lê subtrai 88 e vê 222. É o
+     * mesmo defeito de duas unidades vizinhas que este PR conserta duas linhas acima, e eu o
+     * reintroduzi na frase nova. O resto vai em PONTOS PERCENTUAIS, que é a unidade que a pessoa
+     * acabou de ler, e o número de LUGARES é endereço e não contagem concorrente.
+     *
+     * E cala em 100%: "the other 0%" é uma linha que faz o leitor procurar o que não existe.
+     */
+    if (pct >= 100 || places === 0)
+        return;
+    console.log(bodyWrapped(paint.dim(`The other ${100 - pct}% sits in ${places} ${places === 1 ? "place" : "places"} - \`synthesisui gaps\` lists each one with the file and the line.`)).join("\n"));
+}
 async function carriedByGlobals(root) {
     const dir = join(root, "_synthesisui", "ds");
     const slugs = await readdir(dir).catch(() => []);

package/dist/index.js

@@ -347,6 +347,8 @@ async function main() {
              */
             await gaps({
                 dir,
+                /** `--brief`: o fechamento de um import - o resultado e UMA ação. Ver `gaps.ts`. */
+                ...(boolFlag(flags, "brief") ? { brief: true } : {}),
                 census: typeof flags.census === "string" ? flags.census : undefined,
                 cli: CLI_VERSION,
             });

package/package.json

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