synthesisui 0.16.428 → 0.16.429

package/dist/claude-md.js

@@ -184,14 +184,29 @@ best reasoning you produce.`;
  * A checagem é LOCAL e grátis: o censo grava qual CLI o mediu (`ledger.cli`) e o servidor MCP É o CLI,
  * então comparar as duas versões é aritmética em disco. Nada aqui telefona para casa - é a mesma
  * decisão que mantém o hook instalado.
+ *
+ * O TEXTO DEIXOU DE DIZER "IT COSTS NOTHING" em 16/09, e a correção é de fidelidade, não de estilo.
+ * Medido: `remeasure` não recusa por versão - ele mede e ENVIA em toda chamada, e a comparação de
+ * versões só imprime um aviso. Então a frase antiga descrevia um comportamento que o código nunca
+ * teve, e a cota diária do plano grátis transformou essa imprecisão em consequência: o agente
+ * gastaria o teto da pessoa seguindo uma instrução nossa, escrita no repositório dela, dizendo que
+ * não custava nada.
+ *
+ * O que o bloco diz agora é o que a régua do plano diz: PERGUNTAR é livre, ENVIAR tem teto - e
+ * quando o teto chega, o agente repassa a frase em vez de tentar de novo.
  */
 const REFRESH = `
 
 **Call \`refresh_system\` once before you write UI here, or before you describe what
-this system holds.** Not "if you think the measurement is stale" - always, once per
-session. It costs nothing when nothing changed: the tool holds both versions and
-refuses politely when there is nothing to refresh, so calling it is cheaper than
-deciding whether to.
+this system holds** - once per session, not once per file, and never in a loop.
+
+It is an UPDATE and not a question: it re-measures this repository and sends it. On
+the free plan that counts against the updates the plan covers per day, and when the
+day's updates are used up the tool says so and nothing is lost - the measurement
+stays on disk, and every question you ask about this system keeps being answered.
+Asking is always free; it is sending that has a ceiling. If it says the ceiling was
+reached, say that to the person and carry on with what you already know - do not
+retry it.
 
 It re-measures this repo with the current reader, reuses what was already written
 about this app, and sends it - a newer reader sees styles the old one could not, and

package/dist/commands/mcp.js

@@ -1790,13 +1790,27 @@ cli) {
             const token = await readToken();
             if (!token)
                 return fromContract("Not signed in, so nothing could be sent. A person has to run `synthesisui login` once in the terminal - it opens a browser, and I cannot complete it for them.");
-            const { out } = await capturing(() => remeasure({
+            const { out, value: refused } = await capturing(() => remeasure({
                 root,
                 base: resolveRegistry(),
                 token,
                 slug,
                 cli: VERSION,
             }));
+            /**
+             * O TETO DO PLANO CHEGA AO AGENTE COMO RESPOSTA, e não como silêncio.
+             *
+             * Esta ferramenta é uma ATUALIZAÇÃO, não uma consulta: ela re-mede o repositório e envia.
+             * Então ela conta contra o teto diário do plano grátis, e quando o teto é atingido o envio
+             * não acontece. Sem esta linha o agente receberia a saída capturada sem a recusa dentro
+             * dela - `remeasure` devolve o motivo em vez de imprimi-lo, para o `sync` poder dizê-lo por
+             * último no terminal - e concluiria que a medição subiu.
+             *
+             * A frase vem do servidor inteira, com o endereço junto, porque aqui não há terminal para
+             * quebrar linha: quem lê é o agente, e ele precisa do endereço para repassar à pessoa.
+             */
+            if (refused)
+                return fromContract(`${refused.message}${refused.url ? `\n\n  ${refused.url}` : ""}\n\nNothing was lost: the measurement is on disk and every question you ask about this system keeps being answered. Say this to the person instead of retrying.`);
             /**
              * E A DEFASAGEM DO HOOK, EM TRÊS LINHAS - não num parágrafo.
              *

package/dist/commands/sync.js

@@ -168,8 +168,20 @@ export async function sync(opts) {
      * Então: a plataforma devolve o que já foi decidido (o escopo e a leitura), o CLI mede com o leitor
      * ATUAL, funde a leitura no censo fresco, AVISA o que seria reescrito, e envia. Sem entrevista.
      */
-    if (!opts.recordOnly)
-        await remeasure({
+    /**
+     * A RECUSA É GUARDADA PARA O FIM, e essa é a diferença entre informar e enganar.
+     *
+     * O comando continua depois da medição: ele fecha pedidos, manda o registro de checagens e
+     * termina imprimindo "N checks sent". Uma recusa dita no meio disso rola para cima, e a ÚLTIMA
+     * linha da tela anuncia sucesso para uma rodada em que o design system dela não foi atualizado.
+     *
+     * O registro de checagens SOBE mesmo assim, e isso é deliberado: é outra rota, é o que alimenta
+     * "você está na v2 e existe a v4", e não é o envio pesado que a cota governa. Dizer as duas
+     * coisas na ordem em que aconteceram é mais honesto que abortar tudo.
+     */
+    const refused = opts.recordOnly
+        ? null
+        : await remeasure({
             root,
             base,
             token,
@@ -206,6 +218,7 @@ export async function sync(opts) {
     if (emptyLedger && !repo && forms.length === 0) {
         console.log(section("Sync"));
         console.log(body("Nothing recorded yet. The record fills as the hook checks writes and doctor runs."));
+        sayRefused(refused);
         return;
     }
     const res = await fetch(`${base}/api/ledger`, {
@@ -308,21 +321,29 @@ export async function sync(opts) {
      * nada, que é o caso normal.
      */
     await reportWhatIsLeft(root);
+    sayRefused(refused);
 }
 /**
- * MEDE DE NOVO, AVISA, E ENVIA - o corpo do `sync` que faz um leitor novo chegar num sistema.
+ * O QUE NÃO FOI ENVIADO, DITO POR ÚLTIMO - e o "por último" é o desenho, não um detalhe.
  *
- * A ordem é a lei aqui, e cada passo existe por um caso real:
+ * A pessoa lê a última seção da tela e é ela que decide o que ela conclui do comando. O registro
+ * de checagens subiu de verdade, então a linha "N checks sent" é verdadeira e fica; o que não
+ * pode é ela ser a ÚLTIMA coisa numa rodada em que o design system não foi atualizado.
  *
- *   1. a plataforma devolve o ESCOPO e a LEITURA já gravados. Sem isto, o `sync` teria que
- *      perguntar de novo o que já foi decidido, e um agente reescreveria 261 anatomias.
- *   2. mede com o leitor ATUAL - é o único passo que precisa estar nesta máquina, porque o fonte
- *      dele não sai daqui.
- *   3. funde a leitura gravada no censo fresco. A anatomia é do agente; a medição é nossa.
- *   4. AVISA antes de enviar o que seria reescrito, e pergunta. Avisar depois de escrever não é
- *      avisar.
- *   5. envia para a rota que atualiza o RASCUNHO pelo slug - nada publicado se move.
+ * NÃO SE LÊ COMO ERRO: a frase vem do servidor, que é quem conhece o teto, a contagem e a hora em
+ * que a próxima libera. E o endereço vai em linha própria, indentado, como toda ação que o
+ * terminal oferece - prosa quebra em 66 colunas e um endereço no meio de um parágrafo não se
+ * distingue do parágrafo.
  */
+function sayRefused(refused) {
+    if (!refused)
+        return;
+    console.log("");
+    console.log(section("Your system was not updated"));
+    console.log(body(refused.message));
+    if (refused.url)
+        console.log(body(`    ${paint.blue(refused.url)}`));
+}
 export async function remeasure(args) {
     const { root, base, token, slug } = args;
     const head = await fetch(`${base}/api/registry/ds/${slug}/reading`, {
@@ -333,7 +354,7 @@ export async function remeasure(args) {
         console.log(body(head
             ? `The registry answered ${head.status} for this system's reading, so nothing was re-measured. The record below still travels.`
             : "Could not reach the registry, so nothing was re-measured. The record below still travels."));
-        return;
+        return null;
     }
     const stored = (await head.json());
     /**
@@ -343,7 +364,7 @@ export async function remeasure(args) {
     if (!stored.hasCensus) {
         console.log(section("Sync"));
         console.log(body(`"${slug}" did not come from an import, so there is no measurement to refresh. Import it first: npx synthesisui import`));
-        return;
+        return null;
     }
     /**
      * A DISTÂNCIA ATÉ O CLI PUBLICADO, dita onde ele já está.
@@ -461,7 +482,7 @@ export async function remeasure(args) {
         : null;
     if (!census) {
         console.log(body("The measurement failed, so nothing was sent."));
-        return;
+        return null;
     }
     /** A LEITURA GRAVADA ENTRA NO CENSO FRESCO - ver a rota `reading`. */
     if (stored.reading)
@@ -564,7 +585,7 @@ export async function remeasure(args) {
             .join(" · "))));
         if (!(await askToOverwrite())) {
             console.log(body("Nothing was sent. Your draft is untouched."));
-            return;
+            return null;
         }
     }
     /**
@@ -634,11 +655,33 @@ export async function remeasure(args) {
                 : {}),
         }),
     }).catch(() => null);
+    /**
+     * O TETO DE ATUALIZAÇÕES DO PLANO GRÁTIS - e ele NÃO se lê como um erro, porque não é um.
+     *
+     * O QUE ELA VIVE: o envio parou porque o plano dela atualiza um número de vezes por dia, e a
+     * frase diz quantas já foram, que a medição continua no disco dela, que as perguntas do agente
+     * seguem respondendo, e a HORA em que a próxima libera. O endereço do plano vai em linha
+     * própria, indentado, como toda ação que o terminal oferece - prosa quebra em 66 colunas e um
+     * endereço enterrado no meio de um parágrafo não se distingue do parágrafo.
+     *
+     * A FRASE VEM DO SERVIDOR e não é escrita aqui: é ele quem conhece o teto, a contagem e o
+     * horário. Uma segunda redação deste texto no CLI é o dia em que alguém muda a cota e o
+     * terminal continua anunciando a antiga - e o terminal é onde a pessoa está parada.
+     */
+    if (res?.status === 429) {
+        const door = (await res.json().catch(() => null));
+        return {
+            kind: "quota",
+            message: door?.message ??
+                "Your free plan has reached its updates for today, so your design system was not updated.",
+            url: door?.url ?? null,
+        };
+    }
     if (!res?.ok) {
         console.log(body(res
             ? `The registry answered ${res.status}. Nothing was written.`
             : "Could not reach the registry. Nothing was written."));
-        return;
+        return null;
     }
     const out = (await res.json());
     console.log("");
@@ -842,6 +885,8 @@ export async function remeasure(args) {
         console.log(body(paint.faint(`${work.measured} declared piece${work.measured === 1 ? "" : "s"} of work re-checked against this measurement`)));
     if (!args.full)
         console.log(body(paint.faint("everything the reader saw:  npx synthesisui sync --full")));
+    /** Chegou até aqui: a medição foi enviada e escrita. Nada a recusar. */
+    return null;
 }
 /**
  * Pergunta uma vez, e só num terminal de verdade.

package/dist/install-marks.js

@@ -235,7 +235,7 @@
  * chama `wireAgent`, então rodar o comando é o caminho de volta - e ele só alarga a string que era
  * nossa, nunca um filtro que uma pessoa escreveu.
  */
-export const MATERIALISER_SINCE = "0.16.424";
+export const MATERIALISER_SINCE = "0.16.429";
 /**
  * A ÚLTIMA VERSÃO EM QUE O QUE O HOOK RODA MUDOU.
  *

package/package.json

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