synthesisui 0.16.163 → 0.16.165

package/dist/commands/add.js

@@ -1,4 +1,4 @@
-import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import { access, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 import { syncClaudeMd } from "../claude-md.js";
 import { readProjectConfig, resolveRegistry } from "../config.js";
@@ -41,6 +41,33 @@ async function writeGovernanceIgnore(projectRoot) {
         "ledger.jsonl\n" +
         "not-expressed.md\n", "utf8");
 }
+/**
+ * APAGA A PROSA QUE ESTA VERSÃO DEIXOU DE ESCREVER.
+ *
+ * `rules.md` e `philosophy.md` eram materializados só pelo `add`, então quem instalou antes disto
+ * tem dois arquivos que nada mais atualiza - e um deles se apresenta como "Max authority - follow
+ * these first". Um arquivo que afirma autoridade máxima sobre a regra de uma versão qualquer do
+ * passado é pior que arquivo nenhum, e deixá-lo lá esperando alguém lembrar de apagar é exatamente
+ * a administração manual que esta esteira existe para não pedir (dono, 06/08).
+ *
+ * É a NOSSA pasta - o `.gitignore` que este mesmo comando escreve já a declara gerenciada -, então
+ * isto não toca em código dele. E é dito na saída, porque apagar em silêncio é a outra metade do
+ * mesmo erro.
+ */
+async function retireMaterializedDoctrine(slugDir) {
+    const gone = [];
+    for (const name of ["rules.md", "philosophy.md"]) {
+        const path = join(slugDir, name);
+        try {
+            await access(path);
+        }
+        catch {
+            continue;
+        }
+        await rm(path).then(() => gone.push(name), () => { });
+    }
+    return gone;
+}
 async function readRootLock(path) {
     try {
         return JSON.parse(await readFile(path, "utf8"));
@@ -114,7 +141,8 @@ export async function add(slug, opts) {
     };
     await writeFile(rootLockPath, `${JSON.stringify(lock, null, 2)}\n`, "utf8");
     await writeGovernanceIgnore(projectRoot);
-    // 5b. governance rules (personal DS) → rules.md at the slug root (stable path,
+    const retired = await retireMaterializedDoctrine(slugDir);
+    // 5b. governance rules (personal DS) → doctrine.json at the slug root (stable path,
     //     highest authority; the GUIDE tells the agent to read it first)
     /**
      * The structured set wins when the registry sent one, because only this side
@@ -216,6 +244,9 @@ export async function add(slug, opts) {
     ];
     if (doctrine.length > 0)
         console.log(`  ${doctrine.join(" and ")} → your agent reads them with \`system_doctrine\`, pinned to v${v}`);
+    /** Nomeado, nunca em silêncio: apagar arquivo no repo de alguém se diz em voz alta. */
+    if (retired.length > 0)
+        console.log(`  removed ${retired.join(" and ")} - nothing rewrote them after an install, so they stated an older version's rules as current`);
     console.log(`  CLAUDE.md ${claudeMd.created ? "created" : "updated"} (${claudeMd.count} system(s) installed)`);
     if (opts.setupHints === false)
         return;

package/dist/commands/mcp.js

@@ -3,6 +3,7 @@ import { readdir, readFile } from "node:fs/promises";
 import { join, relative, resolve } from "node:path";
 import { pinnedHookVersion } from "../agent-wiring.js";
 import { readToken, resolveRegistry } from "../config.js";
+import { readEvents } from "../doctor/ledger.js";
 import { fileRequest } from "../doctor/requests.js";
 import { diagnose, scanSource } from "../doctor/scan.js";
 import { nearestToken, tokenFor } from "../doctor/tokens.js";
@@ -293,36 +294,57 @@ async function systemDoctrine(root) {
             : "",
         ...rules.map((r) => `- ${r}`),
     ].filter(Boolean);
-    const behind = await newerVersion(root, pinned);
+    const pulse = await sessionPulse(root, pinned);
     return [
         ...head,
         ...(parts.length > 0 ? ["", "# Philosophy", "", ...parts] : []),
-        ...(behind ? ["", behind] : []),
+        ...(pulse.length > 0 ? ["", ...pulse] : []),
     ].join("\n");
 }
 /**
- * Existe versão publicada acima da instalada?
+ * O PULSO DE UMA SESSÃO LONGA.
  *
- * Melhor esforço e nunca bloqueante: offline, sem sessão, ou registry fora do ar devolvem `null` e a
- * doutrina responde igual. Dizer "não consegui checar" a cada chamada seria ruído numa ferramenta que
- * o agente chama antes de cada trabalho.
+ * A verificação de abertura (`align`) roda UMA vez, no minuto zero. Numa sessão de seis horas tudo o
+ * que ela achou é uma foto: a sessão expira na hora três, um colega publica na hora quatro, e o
+ * registro local cresce a tarde inteira sem subir. Nada disso volta a ser dito (dono, 06/08).
+ *
+ * Esta ferramenta é o lugar certo para o pulso porque o agente a chama ANTES de construir - que é
+ * exatamente o momento em que a consistência importa. Um `setInterval` avisaria no meio de outra
+ * coisa; isto avisa na fronteira de uma decisão.
+ *
+ * SÓ FALA QUANDO HÁ O QUE DIZER. Uma linha que aparece em toda chamada vira papel de parede numa
+ * ferramenta chamada dezenas de vezes por sessão, e aí ela não serve para a vez que importa.
  */
-async function newerVersion(root, pinned) {
-    if (pinned == null)
-        return null;
+async function sessionPulse(root, pinned) {
+    const out = [];
     const slug = await installedSlug(root);
     const token = await readToken();
-    if (!slug || !token)
-        return null;
-    const res = await fetch(`${resolveRegistry()}/api/registry/ds/${slug}`, {
-        headers: { Authorization: `Bearer ${token}` },
-    }).catch(() => null);
-    if (!res?.ok)
-        return null;
-    const body = (await res.json().catch(() => null));
-    if (!body?.version || body.version <= pinned)
-        return null;
-    return `> v${body.version} of this system has been published and this project is on v${pinned}. These rules are v${pinned}'s, and so are the tokens on disk - the two move together. \`npx synthesisui upgrade ${slug}\` brings both.`;
+    if (slug && token && pinned != null) {
+        const res = await fetch(`${resolveRegistry()}/api/registry/ds/${slug}`, {
+            headers: { Authorization: `Bearer ${token}` },
+        }).catch(() => null);
+        /**
+         * 401 é a sessão que morreu no meio da sessão de trabalho, e é o pior silêncio possível: daqui
+         * em diante toda ferramenta falha e nenhuma diz por quê. Offline não produz linha - `res` nulo
+         * não distingue "sem rede" de "servidor fora", e nenhum dos dois é problema da pessoa.
+         */
+        if (res?.status === 401)
+            out.push("> Your session on this machine has expired, so anything that needs the platform will fail from here on. A person has to run `npx synthesisui login` once in the terminal - I cannot complete it. What is on disk still governs: the rules above are the installed version's.");
+        else if (res?.ok) {
+            const body = (await res.json().catch(() => null));
+            if (body?.version && body.version > pinned)
+                out.push(`> v${body.version} of this system has been published and this project is on v${pinned}. These rules are v${pinned}'s, and so are the tokens on disk - the two move together. \`npx synthesisui upgrade ${slug}\` brings both.`);
+        }
+    }
+    /**
+     * O REGISTRO QUE NÃO SUBIU. Ele cresce a cada escrita verificada e só o `sync` o manda, então uma
+     * tarde inteira de trabalho fica invisível para a plataforma - e a tela do dono pontua o repo com
+     * evidência de ontem. Cinquenta é onde uma sessão de verdade chega; abaixo disso é ruído.
+     */
+    const events = await readEvents(root).catch(() => []);
+    if (events.length >= 50)
+        out.push(`> ${events.length} checked writes are recorded here and have not been sent, so this repo is being scored on older evidence. \`npx synthesisui sync\` ships them.`);
+    return out;
 }
 async function listComponents(root) {
     const { documents } = await loadSystem(root);

package/dist/commands/use.js

@@ -53,7 +53,7 @@ export async function use(slug, intent, opts) {
     const hasDoctrine = await exists(join(slugDir, "doctrine.json"));
     const readFirst = [
         hasDoctrine
-            ? "- Call `system_doctrine` first — this system's rules and philosophy, pinned to the installed version; obey them above everything else"
+            ? "- Call `system_doctrine` first — this system's rules and philosophy, pinned to the installed version; obey them above everything else. Without MCP, the same data is `doctrine.json` and the `philosophy` of `design-system.json`"
             : "",
         `- ${base}/v${version}/GUIDE.md — how to apply the system, the recipes and the token vocabulary`,
     ].filter(Boolean);

package/dist/guide.js

@@ -438,7 +438,7 @@ own entry below says so.
         ? [
             `**Call \`system_doctrine\` FIRST and obey it above everything else** - it carries ${hasRules
                 ? "this system's accumulated, project-specific rules"
-                : "this system's mission, principles, voice and motion doctrine"}${hasRules && hasPhilosophy ? " and its philosophy" : ""}, pinned to the version installed here. On any conflict they win.`,
+                : "this system's mission, principles, voice and motion doctrine"}${hasRules && hasPhilosophy ? " and its philosophy" : ""}, pinned to the version installed here. On any conflict they win. **Without that tool, read \`_synthesisui/ds/${slug}/doctrine.json\` and the \`philosophy\` of \`design-system.json\` beside it** - the same data, and the reason it stays on disk.`,
         ]
         : [];
     const rulesNote = readFirst.length > 0

package/dist/skill-import.js

@@ -390,6 +390,7 @@ Open the project and answer the questions below. Then add a \`reading\` object t
   "fonts": { "display": "Inter", "body": "Inter" },
   "typeRoles": { "base": "body-m", "display": "h1", "xs": "caption" },
   "concept": "one paragraph on what this product is",
+  "mood": ["focused", "dense", "technical"],
   "rules": [
     {
       "text": "A RootWrapper is what makes the app-shell components position correctly - never render a Sidebar or Topbar outside one",
@@ -470,6 +471,21 @@ Open the project and answer the questions below. Then add a \`reading\` object t
 
 Every field is optional. Leave out what you did not establish.
 
+**\`concept\` and \`mood\` - the words the system opens with.**
+
+The guide, the vitrine and every page the platform writes about this system lead with these. Until
+07/08 nothing filled them, so a real import shipped with the seed's line - *"A calm grayscale
+starting point to make your own"* - as the first sentence of somebody's own design system. A sentence
+of ours at the top of their system says, in the first line, that nothing was read.
+
+\`concept\` is one paragraph on what this product IS, in their words where you can find them: the
+README, the docs site, the introduction their library ships with. \`mood\` is two to six words for how
+the product FEELS - \`focused\`, \`dense\`, \`editorial\`, \`playful\`. It is a judgement and it is yours to
+make, which is exactly why the arithmetic cannot: no reader infers a mood from a hex.
+
+Leave \`mood\` out when you did not form one. The seed's three words stay and the import SAYS they are
+ours, which is honest - three words you picked to fill a field are not.
+
 **\`themes\` - which themes the product actually ships, and which one it opens in.**
 
 This is the field that matters most and the one only you can fill. The ladder can say which

package/package.json

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