synthesisui 0.16.178 → 0.16.179

package/dist/commands/add.js

@@ -25,23 +25,45 @@ import { detectStack } from "../stack.js";
  *
  * Escrito uma vez e nunca reescrito: um arquivo que alguém ajustou é decisão dele.
  */
+/**
+ * O que NÃO é do repositório: a medição e o registro local. Ambos são reescritos por inteiro a cada
+ * rodada e conflitariam em todo merge; o `.ledger-sent` descreve este clone e mais nada.
+ */
+const IGNORED = [
+    "census.json",
+    "ledger.jsonl",
+    ".ledger-sent",
+    "not-expressed.md",
+];
+const IGNORE_HEADER = "# Managed by synthesisui. The identity and the CSS are committed so a fresh\n" +
+    "# clone is governed; the measurement and the local record are not, because\n" +
+    "# both are rewritten in full on every run and would conflict on every merge.\n";
 async function writeGovernanceIgnore(projectRoot) {
     const path = join(projectRoot, "_synthesisui", ".gitignore");
-    try {
-        await access(path);
+    const existing = await readFile(path, "utf8").catch(() => null);
+    /**
+     * O ARQUIVO DIZ "Managed by synthesisui", E ELE PRECISA SER.
+     *
+     * Isto saía na primeira linha quando o arquivo já existia, então ele era escrito UMA vez e nunca
+     * mais. A consequência aparece na primeira vez que a gente acrescenta um registro local: em 07/08
+     * nasceu o `.ledger-sent`, e todo repositório que já tinha o `.gitignore` passaria a commitar um
+     * cursor que descreve a máquina de UMA pessoa. Um arquivo que se declara gerenciado e não é
+     * reconciliado é uma promessa quebrada com o time de alguém.
+     *
+     * ACRESCENTA, NUNCA REMOVE: uma linha que a pessoa escreveu ali é decisão dela, e some no dia em
+     * que a gente reescrevesse o arquivo inteiro. E só grava quando falta algo - um comando que sempre
+     * produz diff é um comando que o time para de rodar.
+     */
+    if (existing == null) {
+        await writeFile(path, `${IGNORE_HEADER}${IGNORED.map((l) => `${l}\n`).join("")}`, "utf8");
         return;
     }
-    catch {
-        // não existe - escrever
-    }
-    await writeFile(path, "# Managed by synthesisui. The identity and the CSS are committed so a fresh\n" +
-        "# clone is governed; the measurement and the local record are not, because\n" +
-        "# 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");
+    const lines = new Set(existing.split("\n").map((l) => l.trim()));
+    const missing = IGNORED.filter((l) => !lines.has(l));
+    if (missing.length === 0)
+        return;
+    const sep = existing.endsWith("\n") ? "" : "\n";
+    await writeFile(path, `${existing}${sep}${missing.map((l) => `${l}\n`).join("")}`, "utf8");
 }
 /**
  * APAGA A PROSA QUE ESTA VERSÃO DEIXOU DE ESCREVER.

package/package.json

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