synthesisui 0.16.196 → 0.16.198

package/dist/commands/align.js

@@ -188,6 +188,43 @@ opts = {}) {
  * Melhor esforço: offline, sem sessão, ou registry fora do ar não produzem linha nenhuma. Uma
  * verificação de abertura não pode transformar um voo sem internet num aviso.
  */
+/**
+ * O QUE DIZER QUANDO A PLATAFORMA ENDIREITOU ALGO - e como voltar ao que se estava fazendo.
+ *
+ * O pedido do dono, em 10/08: o agente checa se mudou alguma coisa, diz o comando, e devolve a linha
+ * que retoma a sessão de onde ela parou. A retomada não é conforto - sem ela, a pessoa roda o
+ * comando, perde o contexto do que estava fazendo, e o custo do conserto passa a ser a tarefa que ela
+ * estava no meio.
+ */
+const REPAIR_SAID = {
+    spacing: "spacing values in your system were connected to the steps your own scale declares",
+    orphans: "recipes your measured scope no longer declares were removed",
+    roles: "colour roles were pointed at the ramps your repository declares",
+    reground: "the foundation was rebuilt from your census",
+    interpretation: "your census was re-read with a newer interpretation",
+};
+export function repairSaid(body, lock) {
+    if (!lock.slug)
+        return null;
+    if (!body.repairedAt)
+        return null;
+    /**
+     * SEM CARIMBO LOCAL, SILÊNCIO. Um repo instalado antes de `installedAt` existir não tem com o que
+     * comparar, e avisar sempre transformaria este aviso em ruído permanente - que é como um aviso
+     * deixa de ser lido.
+     */
+    if (!lock.fetchedAt)
+        return null;
+    if (Date.parse(body.repairedAt) <= Date.parse(lock.fetchedAt))
+        return null;
+    const what = body.repaired ? REPAIR_SAID[body.repaired] : undefined;
+    return {
+        says: `Something was put right in "${lock.slug}" on the platform after this repo installed it${what ? `: ${what}` : ""}. The files here still hold what was measured before that.`,
+        run: `npx synthesisui upgrade ${lock.slug}`,
+        /** E o caminho de volta para o que ela estava fazendo. */
+        then: "claude --continue --dangerously-skip-permissions",
+    };
+}
 export async function versionBehind(root, opts = {}) {
     const locks = (await locksIn(root)).filter((l) => l.slug && !l.adopted);
     const lock = locks[0];
@@ -210,6 +247,24 @@ export async function versionBehind(root, opts = {}) {
     const body = (await res.json().catch(() => null));
     if (!body?.version)
         return null;
+    /**
+     * ALGO FOI ENDIREITADO NA PLATAFORMA DESDE QUE ESTE REPO INSTALOU.
+     *
+     * `version` responde "publicaram algo mais novo". O Apply do Studio não publica - ele escreve o
+     * rascunho -, então a versão fica parada e este comando ficava mudo sobre uma mudança real no
+     * design system dele (dono, 10/08). Quem descobre por acaso duas semanas depois é quem deixa de
+     * confiar no que a esteira diz.
+     *
+     * A frase é escrita AQUI, com o texto de hoje: só a data e a chave viajam pela rede. Uma frase que
+     * atravessa a rede congela na versão que a mandou.
+     *
+     * E ela vem ANTES do teste de versão de propósito: quando os dois são verdade, o reparo é a causa e
+     * a versão é a consequência - dizer a consequência primeiro manda a pessoa rodar o comando sem
+     * saber por quê.
+     */
+    const repaired = repairSaid(body, lock);
+    if (repaired)
+        return repaired;
     if (body.version > lock.version)
         return {
             says: `v${body.version} of "${lock.slug}" is published and this repo is on v${lock.version}. The CSS here and the rules your agent reads are both v${lock.version} - they move together, which is why this is worth saying rather than applying.`,
@@ -273,7 +328,8 @@ from = "session") {
             : from === "shell"
                 ? "This repo is out of alignment with the design system that governs it:"
                 : "Before this session starts, this environment is out of alignment with the design system that governs it:",
-        ...items.map((m) => `  - ${m.says}${m.run ? `\n      ${m.run}` : ""}`),
+        /** O `then` sai numa linha própria e rotulada: um segundo comando solto lê como parte do primeiro. */
+        ...items.map((m) => `  - ${m.says}${m.run ? `\n      ${m.run}` : ""}${m.then ? `\n      then, to pick up where you left off:\n      ${m.then}` : ""}`),
     ].join("\n");
 }
 /**

package/dist/commands/sync.js

@@ -352,7 +352,15 @@ export async function remeasure(args) {
     const mark = {
         at: new Date().toISOString(),
         components: out.written ?? 0,
-        declarations: countDeclarations(census),
+        /**
+         * LIDO DO CENSO, e não recontado aqui - ver `coverage.declarations`.
+         *
+         * A primeira versão contava por conta própria e deu 165 onde o relatório diz 519: ela somava só o
+         * `base` de cada look, e a conta do produto soma `base`, `dark` e os estados. Dois números sobre
+         * um fato só é como uma tela passa a se contradizer, e a única defesa é não ter o segundo.
+         */
+        declarations: census.coverage
+            ?.declarations ?? 0,
         seen: sum(led?.counted),
         interpreted: sum(led?.interpreted),
     };
@@ -361,28 +369,6 @@ export async function remeasure(args) {
     if (!args.full)
         console.log(body(paint.faint("everything the reader saw:  npx synthesisui sync --full")));
 }
-/** Quantas declarações de estilo as receitas carregam - o número que a tela mostra ao lado da nota. */
-function countDeclarations(census) {
-    const looks = census.looks ?? {};
-    let n = 0;
-    const walk = (node) => {
-        if (Array.isArray(node)) {
-            for (const item of node)
-                walk(item);
-            return;
-        }
-        if (!node || typeof node !== "object")
-            return;
-        for (const value of Object.values(node))
-            if (typeof value === "string")
-                n += 1;
-            else
-                walk(value);
-    };
-    for (const look of Object.values(looks))
-        walk(look.base);
-    return n;
-}
 /**
  * Pergunta uma vez, e só num terminal de verdade.
  *

package/package.json

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