synthesisui 0.16.382 → 0.16.384

package/dist/baseline-craft.js

@@ -27,9 +27,30 @@ export function craftLines(craft) {
     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.`),
-    ];
+    /**
+     * O DENOMINADOR EM PALAVRAS, e ele existe para a nota não subir calada.
+     *
+     * Um componente sem receita nenhuma sai da média desde 06/09 - ninguém o escreveu ainda, e
+     * contá-lo como zero afirma que o código dele é ruim onde não há código. Mas uma nota que
+     * melhora sem explicação lê como régua afrouxada, então a frase diz sobre QUANTOS ela foi
+     * tirada.
+     *
+     * SÓ QUANDO EXISTE, e `unwritten` ausente é diferente de zero: um servidor anterior a esta
+     * versão não manda o campo, e afirmar "todos têm receita" ali seria inventar.
+     */
+    const plural = craft.authored === 1 ? "" : "s";
+    const written = craft.unwritten === undefined ? null : craft.authored - craft.unwritten;
+    const apart = written !== null && craft.unwritten ? craft.unwritten : 0;
+    const lines = bodyWrapped(`${paint.strong(`${craft.score}/100`)} on ${apart ? `${written} of your ${craft.authored}` : `your ${craft.authored}`} component${plural} - never on our kit, never on a demo.`).map(body);
+    /**
+     * A LINHA PRÓPRIA, e não uma oração dentro da primeira.
+     *
+     * Escrita junto, a frase ocupava três linhas no terminal e o fato principal - a nota - ficava
+     * enterrado no meio da ressalva. A nota é o que ele veio ver; por que ela é sobre 49 e não 62 é
+     * a segunda pergunta, e ela merece a segunda linha.
+     */
+    if (apart)
+        lines.push(...bodyWrapped(`${apart} have no recipe yet: counted apart, never against you.`).map((l) => body(paint.dim(l))));
     /**
      * 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á.

package/dist/commands/import.js

@@ -35,7 +35,7 @@ import { parseSchemeBlocks } from "../doctor/scheme-blocks.js";
 import { describeSignals, emptySignals, finishSignals, readSignalsInto, } from "../doctor/signals.js";
 import { sketchOf } from "../doctor/sketch.js";
 import { describeForeign, readStyleIslands, } from "../doctor/style-island.js";
-import { buildLedger, describeLedger, } from "../doctor/style-ledger.js";
+import { buildLedger, describeLedger, sampledForUpload, } from "../doctor/style-ledger.js";
 import { MUI_DEFAULT_SPACING, readStyledComponents, spacingOf, } from "../doctor/style-props.js";
 import { buildTable } from "../doctor/tokens.js";
 import { definitionSpan, parseClass, readInlineStyle, rootClasses, rootTag, transcribe, } from "../doctor/transcribe.js";
@@ -2802,7 +2802,10 @@ export async function takeCensus(root, opts) {
          * A PROCEDÊNCIA, GRAVADA - ver `measured` no tipo. `basename` e não o caminho: o nome da pasta
          * distingue dois monorepos parecidos sem mandar o diretório pessoal dele para o nosso servidor.
          */
-        measured: { repo: repoNameOf(root, scopeLabel), at: new Date().toISOString() },
+        measured: {
+            repo: repoNameOf(root, scopeLabel),
+            at: new Date().toISOString(),
+        },
         ...(scopeLabel ? { scope: scopeLabel } : {}),
         /**
          * O DENOMINADOR DO FORA - ver `outside-scope.ts`.
@@ -4492,8 +4495,17 @@ export async function runImport(opts) {
          * ler `_synthesisui/ds/<slug>/.lock`, que num import não existe de qualquer forma. Todo campo do
          * payload é opcional, então o que falta simplesmente não viaja - em vez de o conjunto todo faltar.
          */
+        /**
+         * O QUE SOBE É AMOSTRA; O QUE FICA NO REPOSITÓRIO DELE É INTEIRO - `INV-COLETA-18`.
+         *
+         * `sampledForUpload` aplica o teto AQUI, depois de o censo já ter sido gravado em
+         * `_synthesisui/census.json`. O tamanho deste corpo não muda em byte nenhum - é o mesmo 4 096
+         * de sempre -, e o que muda é que o arquivo dele deixou de ser podado por um limite nosso.
+         */
         body: JSON.stringify({
-            census,
+            census: census.ledger
+                ? { ...census, ledger: sampledForUpload(census.ledger) }
+                : census,
             name: chosen,
             ...(opts.group ? { group: opts.group } : {}),
             ...(repoAtImport ? { repo: repoAtImport } : {}),

package/dist/commands/sync.js

@@ -6,6 +6,7 @@ import { readToken, resolveRegistry } from "../config.js";
 import { inherit, readDeclaredForms, } from "../doctor/declared-forms.js";
 import { markSent, readEvents } from "../doctor/ledger.js";
 import { checkableName, closeRequest, readRequests, verifyAndCloseRequests, } from "../doctor/requests.js";
+import { sampledForUpload } from "../doctor/style-ledger.js";
 import { describeDelta, fingerprintReadings, readSyncMark, writeSyncMark, } from "../last-sync.js";
 import { measuredScope, rememberScope } from "../measured-scope.js";
 import { fromCensus } from "../memory/observation.js";
@@ -556,7 +557,18 @@ export async function remeasure(args) {
             "content-type": "application/json",
             Authorization: `Bearer ${token}`,
         },
-        body: JSON.stringify({ census }),
+        /**
+         * O QUE SOBE É AMOSTRA; O QUE FICA NO REPOSITÓRIO DELE É INTEIRO - `INV-COLETA-18`.
+         *
+         * A gravação em `_synthesisui/census.json` acontece acima, e ela leva o ledger COMPLETO: é dali
+         * que `gaps` e a skill `sui-reader` tiram a forma, o lugar e o texto de cada declaração que
+         * nenhum leitor entendeu. O teto vale só para o nosso lado, e o tamanho deste corpo não muda.
+         */
+        body: JSON.stringify({
+            census: census.ledger
+                ? { ...census, ledger: sampledForUpload(census.ledger) }
+                : census,
+        }),
     }).catch(() => null);
     if (!res?.ok) {
         console.log(body(res

package/dist/doctor/style-ledger.js

@@ -291,12 +291,11 @@ declared) {
              * declarado e um teto silencioso. Inverter as duas linhas devolve o defeito.
              */
             group.distinctTexts.add(f.text);
-            if (group.unreadable.length < DISTINCT_CAP)
-                group.unreadable.push({
-                    file: f.file,
-                    line: f.line,
-                    text: f.text.replace(/\s+/g, " ").trim().slice(0, 400),
-                });
+            group.unreadable.push({
+                file: f.file,
+                line: f.line,
+                text: f.text.replace(/\s+/g, " ").trim().slice(0, 400),
+            });
         }
         groups.set(key, group);
     }
@@ -413,17 +412,27 @@ values) {
          *
          * O QUE ELA NÃO FAZ é prometer o desfecho - mesma correção que `shape-not-read` recebeu em
          * 24/08. Ela diz quantos textos viajam e o que isso significa para um leitor que a gente
-         * publique depois; para onde vai o resto depende de uma decisão de tamanho de censo que não é
-         * do cliente e ainda não foi tomada.
+         * publique depois.
+         *
+         * ─────────────────────────────────────────────────────────────────────────
+         * E EM 06/09 ELA TROCOU DE SENTIDO, porque o teto trocou de lado - `INV-COLETA-18`.
+         *
+         * A frase antiga dizia *"de N textos, 4096 viajam"* sobre um arquivo que TAMBÉM estava podado:
+         * o corte acontecia na construção, então o `census.json` dele levava os mesmos 4096. Agora o
+         * arquivo dele leva todos, e o que é amostrado é só o que sobe para nós.
+         *
+         * A CONDIÇÃO PASSOU A SER O TETO, e não `unreadable.length`: aquele campo agora vale `distinct`
+         * sempre, então a comparação antiga nunca seria verdadeira e a frase sumiria em silêncio - uma
+         * lacuna declarada virando lacuna calada por efeito colateral, que é o oposto da lei 8.
          */
-        if (g.distinct !== undefined && g.distinct > g.unreadable.length)
+        if (g.distinct !== undefined && g.distinct > DISTINCT_CAP)
             lines.push(
             /**
              * `census` ERA O NOSSO NOME NA TELA DELE - trocado por "the measurement we already have",
              * que é o que a palavra significa do lado dele. Pego pela régua de `INV-VOC-05` no dia em
              * que `doctor/` entrou nela (03/09).
              */
-            `      of ${g.distinct} distinct texts here, ${g.unreadable.length} travel with the measurement we already have - a reader we publish later reaches those without you running this again, and the remaining ${g.distinct - g.unreadable.length} need another scan`);
+            `      all ${g.distinct} distinct texts stay in the measurement file in your repository - the ${g.distinct - DISTINCT_CAP} past the first ${DISTINCT_CAP} did not travel to us, so a reader we publish later reaches those only after another scan`);
         for (const e of g.examples)
             lines.push(`      ${e.file}:${e.line}  ${e.text.slice(0, 80)}`);
     }
@@ -445,3 +454,39 @@ export function describeValueRuler(values) {
         `Of the ${values.seen} class declarations on your components, ${values.structure} are structure (layout plumbing, not design decisions). Of the ${decisions} design decisions, ${closed} are interpreted${values.answered > 0 ? ` (${values.answered} of them answered by you)` : ""} - ${percent}%.`,
     ];
 }
+/**
+ * O CORTE, APLICADO DEPOIS DA BIFURCAÇÃO - fecha o `pending` de `INV-COLETA-18`.
+ *
+ * A REGRA, do dono (05/09): *"coisas que a gente não interpreta a gente continua enviando para o
+ * usuário, para o agente saber o que fazer"*. Falhar em ler degrada a NOSSA metade; nunca o insumo
+ * dele.
+ *
+ * O QUE ACONTECIA. `buildLedger` cortava em `DISTINCT_CAP` durante a CONSTRUÇÃO, e o objeto podado
+ * era o mesmo que ia para os dois lados: gravado em `_synthesisui/census.json` na máquina dele E
+ * enviado ao nosso banco. Um teto que existe pelo NOSSO custo de armazenamento estava podando o
+ * arquivo de onde o agente DELE tira a forma, o lugar e o texto. Medido em 03/09, com o teto solto:
+ *
+ *     web-subscribe            component-not-admitted   9 722 distintos, 4 096 viajavam   58% fora
+ *     web-subscribe            shape-not-read           8 016 distintos, 4 096 viajavam   49% fora
+ *     frontend-hub/dashboard   component-not-admitted   6 394 distintos, 4 096 viajavam   36% fora
+ *
+ * AGORA A CONSTRUÇÃO GUARDA TUDO e quem chama decide. O disco dele recebe o ledger inteiro; o corpo
+ * do POST passa por aqui. O tamanho do que sobe não muda em byte nenhum - é o mesmo 4 096 de antes.
+ *
+ * E `distinct` NÃO É RECALCULADO aqui, de propósito: ele conta os distintos que a MEDIÇÃO viu, e é
+ * exatamente a diferença entre ele e `unreadable.length` que diz ao servidor que a lista recebida é
+ * amostra. Recalcular apagaria a única evidência do corte - o defeito que `INV-COB-14` protege.
+ *
+ * O TETO DAS FORMAS entra junto porque responde à mesma pergunta e ao mesmo custo: `formsTotal`
+ * continua dizendo quantas existem.
+ */
+export function sampledForUpload(ledger) {
+    return {
+        ...ledger,
+        unread: ledger.unread.map((group) => ({
+            ...group,
+            unreadable: group.unreadable.slice(0, DISTINCT_CAP),
+            ...(group.forms ? { forms: group.forms.slice(0, FORM_CAP) } : {}),
+        })),
+    };
+}

package/dist/install-marks.js

@@ -680,7 +680,18 @@ export const CHECKER_SINCE = "0.16.378";
  * posição de conteúdo. Um censo medido antes desta versão conta como deriva o que a folha do app
  * nem alcança - e o número do cliente é a promessa.
  */
-export const READER_SINCE = "0.16.381";
+/**
+ * 0.16.381 -> 0.16.383 em 06/09: o censo produzido MUDA, e do lado DELE. `DISTINCT_CAP` cortava os
+ * textos durante a construção do ledger, então o mesmo objeto podado era gravado em
+ * `_synthesisui/census.json` na máquina dele e enviado para nós - um teto que existe pelo NOSSO
+ * custo podando o insumo DELE (`INV-COLETA-18`). Agora `buildLedger` guarda tudo e o corte é
+ * aplicado só no corpo do POST. Um censo medido antes desta versão tem o arquivo dele podado em
+ * todo grupo acima de 4 096 textos distintos, e só um `sync` traz o resto.
+ * QUEM NÃO É AFETADO: quem não tem nenhum grupo acima de 4 096 - o `sync` daquele repositório não
+ * muda um byte. Medido em 06/09: `frontend-hub/apps/web-dashboard` tem UM grupo acima (6 393), e
+ * `packages/ui` e `apps/web-review` nenhum.
+ */
+export const READER_SINCE = "0.16.383";
 /**
  * O QUE ESTÁ INSTALADO AQUI FICOU PARA TRÁS - e as DUAS condições que fazem isso ser verdade.
  *

package/package.json

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