synthesisui 0.16.176 → 0.16.178

package/dist/claude-md.js

@@ -412,6 +412,7 @@ export async function syncClaudeMd(projectRoot) {
     const installed = await readInstalled(projectRoot);
     const region = await renderRegion(projectRoot, installed);
     let createdAny = false;
+    const changed = [];
     for (const home of HOMES) {
         const path = join(projectRoot, home.path);
         let existing = null;
@@ -435,6 +436,7 @@ export async function syncClaudeMd(projectRoot) {
             await mkdir(dirname(path), { recursive: true }).catch(() => { });
             await writeFile(path, `${home.frontmatter ?? ""}${region}\n`, "utf8");
             createdAny = true;
+            changed.push(home.path);
             continue;
         }
         const startIdx = existing.indexOf(START);
@@ -450,10 +452,12 @@ export async function syncClaudeMd(projectRoot) {
             const sep = existing.endsWith("\n") ? "\n" : "\n\n";
             next = `${existing}${sep}${region}\n`;
         }
-        if (next !== existing)
+        if (next !== existing) {
             await writeFile(path, next, "utf8");
+            changed.push(home.path);
+        }
     }
-    return { created: createdAny, count: installed.length };
+    return { created: createdAny, count: installed.length, changed };
 }
 /**
  * Onde o bloco JÁ está, para o `connect` poder dizer isso em vez de ficar calado.

package/dist/commands/add.js

@@ -39,6 +39,8 @@ async function writeGovernanceIgnore(projectRoot) {
         "# both are rewritten in full on every run and would conflict on every merge.\n" +
         "census.json\n" +
         "ledger.jsonl\n" +
+        /** O cursor de envio descreve ESTE clone, não o repositório - ver `markSent`. */
+        ".ledger-sent\n" +
         "not-expressed.md\n", "utf8");
 }
 /**

package/dist/commands/align.js

@@ -2,7 +2,7 @@ import { readdir, readFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { join, resolve } from "node:path";
 import { readToken, resolveRegistry } from "../config.js";
-import { readEvents } from "../doctor/ledger.js";
+import { unsentEvents } from "../doctor/ledger.js";
 import { measuredScope } from "../measured-scope.js";
 import { READER } from "../reader-version.js";
 /**
@@ -124,7 +124,12 @@ opts = {}) {
              */
             run: "npx synthesisui sync",
         });
-    const events = await readEvents(root).catch(() => []);
+    /**
+     * SÓ O QUE NÃO SUBIU - ver `unsentEvents`. Isto contava o arquivo inteiro, e como o ledger é
+     * append-only e o `sync` manda tudo (a plataforma deduplica), a linha nunca mais saía da tela e o
+     * número só crescia.
+     */
+    const events = await unsentEvents(root).catch(() => []);
     if (events.length > 0)
         out.push({
             says: `${events.length} checked write${events.length === 1 ? "" : "s"} recorded here and not sent - the platform is scoring this repo on older evidence.`,

package/dist/commands/connect.js

@@ -173,7 +173,7 @@ export async function connect(opts) {
     const wired = await wireAgent(root, opts.version, want);
     // The block reads the settings we just wrote, so it must be regenerated
     // after them, not before.
-    await syncClaudeMd(root);
+    const contract = await syncClaudeMd(root);
     console.log(section("Connected"));
     /**
      * O QUE ESTE CLI REESCREVEU NA PASTA DO SISTEMA - dito primeiro, porque é o que a pessoa não sabia
@@ -231,8 +231,18 @@ export async function connect(opts) {
      * qual ferramenta ela usa. Dizer os nomes é o que faz um time descobrir que a governança já chegou
      * no editor dele: até 05/08 ela só alcançava quem usa Claude Code, e ninguém tinha como saber.
      */
-    for (const home of await blockHomes(root))
-        console.log(body(`✓ ${home.padEnd(22)} ${home === "CLAUDE.md" ? "rewritten for what is installed" : "the same rules, where this agent reads them"}`));
+    /**
+     * `✓` SÓ PARA O QUE MUDOU - ver `syncClaudeMd.changed`. Esta linha era a única do bloco que
+     * marcava mudança sempre, e um `connect` seguido dizia "rewritten" sobre um arquivo intocado.
+     */
+    for (const home of await blockHomes(root)) {
+        const moved = contract.changed.includes(home);
+        console.log(body(`${moved ? "✓" : "·"} ${home.padEnd(22)} ${moved
+            ? home === "CLAUDE.md"
+                ? "rewritten for what is installed"
+                : "the same rules, where this agent reads them"
+            : "already says what is installed"}`));
+    }
     /**
      * The fourth layer, and the one that had no installer at all: the import
      * skill existed only in our own repo, so the only way to get it was to clone

package/dist/commands/sync.js

@@ -1,7 +1,7 @@
 import { readdir, readFile, writeFile } from "node:fs/promises";
 import { join, resolve } from "node:path";
 import { readToken, resolveRegistry } from "../config.js";
-import { readEvents } from "../doctor/ledger.js";
+import { markSent, readEvents } from "../doctor/ledger.js";
 import { checkableName, closeRequest, readRequests, verifyAndCloseRequests, } from "../doctor/requests.js";
 import { measuredScope, rememberScope } from "../measured-scope.js";
 import { body, paint, section, snippet } from "../output.js";
@@ -114,6 +114,11 @@ export async function sync(opts) {
         console.log(body(err.message ?? `The registry answered ${res.status}.`));
         return;
     }
+    /**
+     * O QUE SUBIU, ANOTADO - senão o `align` continua pedindo o envio do que acabou de ser enviado.
+     * Depois da resposta OK, e nunca antes: marcar um envio que falhou perderia os eventos de vez.
+     */
+    await markSent(root, events);
     const out = (await res.json());
     console.log(section("Sync"));
     console.log(body(`${out.eventsReceived} checks sent, ${out.eventsNew} new. ${out.requestsNow} open request${out.requestsNow === 1 ? "" : "s"}.`));

package/dist/doctor/ledger.js

@@ -46,6 +46,55 @@ export async function appendEvent(root, event) {
         // is a ledger that gets the hook uninstalled.
     }
 }
+/**
+ * ATÉ ONDE ESTE REPO JÁ MANDOU - e a ausência disto fazia o `align` mentir para sempre.
+ *
+ * O ledger é APPEND-ONLY e o `sync` manda o arquivo inteiro; a plataforma deduplica (em 07/08 uma
+ * rodada reportou "6 checks sent, 1 new"). Só que o `align` contava TODAS as linhas e dizia "6
+ * checked writes recorded here and not sent" - sobre cinco que tinham subido minutos antes. O número
+ * só crescia, então aquela linha nunca mais sairia da tela, e um aviso permanente é um aviso que a
+ * pessoa aprende a pular (dono, 07/08: *"quer apostar que você vai achar algo errado?"*).
+ *
+ * A CONTAGEM E A HORA, as duas: a contagem responde sozinha enquanto o arquivo só cresce, e a hora
+ * dá como perceber que ele foi trocado por outro - aí a contagem antiga não vale mais nada.
+ */
+const SENT_FILE = ".ledger-sent";
+const sentPath = (root) => join(root, "_synthesisui", SENT_FILE);
+export async function readSent(root) {
+    const raw = await readFile(sentPath(root), "utf8").catch(() => "");
+    if (!raw)
+        return { count: 0 };
+    try {
+        const v = JSON.parse(raw);
+        return {
+            count: typeof v.count === "number" && v.count >= 0 ? v.count : 0,
+            ...(typeof v.at === "string" ? { at: v.at } : {}),
+        };
+    }
+    catch {
+        return { count: 0 };
+    }
+}
+export async function markSent(root, events) {
+    const last = events[events.length - 1]?.at;
+    await writeFile(sentPath(root), `${JSON.stringify({ count: events.length, ...(last ? { at: last } : {}) })}\n`, "utf8").catch(() => {
+        /** O registro nunca pode custar o envio: o pior caso é o aviso reaparecer uma vez. */
+    });
+}
+/**
+ * Os eventos que este repo ainda não mandou.
+ *
+ * Se a contagem gravada é maior que o arquivo, alguém o trocou ou apagou - e aí a marca não descreve
+ * mais este arquivo. Contar tudo de novo é a leitura honesta: um envio a mais custa nada, e a
+ * plataforma deduplica.
+ */
+export async function unsentEvents(root) {
+    const all = await readEvents(root);
+    const { count } = await readSent(root);
+    if (count <= 0 || count > all.length)
+        return all;
+    return all.slice(count);
+}
 export async function readEvents(root) {
     const raw = await readFile(ledgerPath(root), "utf8").catch(() => "");
     if (!raw)

package/package.json

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