synthesisui 0.16.197 → 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synthesisui",
-  "version": "0.16.197",
+  "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": {