synthesisui 0.16.358 → 0.16.360

package/dist/agent-wiring.js

@@ -1,7 +1,12 @@
 import { access, mkdir, readFile, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 const HOOK_MATCHER = "Write|Edit|MultiEdit";
-const exists = (p) => access(p).then(() => true, () => false);
+/**
+ * Exportado porque a REGRA é uma só: a pasta de uma ferramenta é a evidência de que ela é usada, e
+ * a mesma evidência decide o MCP daqui e a casa do bloco em `claude-md.ts`. Duas cópias deste
+ * predicado seriam duas chances de as duas decisões divergirem.
+ */
+export const exists = (p) => access(p).then(() => true, () => false);
 async function readJson(path) {
     const raw = await readFile(path, "utf8").catch(() => "");
     if (!raw.trim())

package/dist/claude-md.js

@@ -1,6 +1,6 @@
 import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
-import { hasHook } from "./agent-wiring.js";
+import { exists, hasHook } from "./agent-wiring.js";
 import { declaredReference } from "./group-role.js";
 import { recallAvailable } from "./memory/availability.js";
 const START = "<!-- synthesisui:start -->";
@@ -573,10 +573,11 @@ _Block managed by the CLI - do not edit by hand; run \`synthesisui ${onlyAdopted
  */
 const HOMES = [
     { path: "CLAUDE.md" },
-    { path: "AGENTS.md" },
+    { path: "AGENTS.md", bornWhen: ".codex" },
     {
         path: ".cursor/rules/synthesisui.mdc",
         frontmatter: "---\ndescription: Design system rules - read before writing UI\nalwaysApply: true\n---\n\n",
+        bornWhen: ".cursor",
     },
 ];
 export async function syncClaudeMd(projectRoot) {
@@ -594,15 +595,18 @@ export async function syncClaudeMd(projectRoot) {
             existing = null;
         }
         /**
-         * O ARQUIVO NOVO SÓ NASCE PARA O CLAUDE.md.
+         * O ARQUIVO NOVO NASCE QUANDO O REPOSITÓRIO JÁ MOSTROU QUEM ELE USA - ver `bornWhen`.
          *
-         * Criar `AGENTS.md` num repo que nunca teve um é decidir por outra pessoa qual agente ela usa, e
-         * um arquivo que apareceu sozinho na raiz é a primeira coisa que alguém apaga com raiva. Nos
-         * outros dois a regra é: se o arquivo existe, o bloco entra e se mantém atualizado; se não
-         * existe, não inventamos um.
+         * `CLAUDE.md` sem condição, porque é a casa que a gente cria num repo que não tem nenhuma. Os
+         * outros dois só quando a pasta da ferramenta está lá: criar `AGENTS.md` num repo que só usa
+         * Claude Code continua sendo decidir por outra pessoa qual agente ela usa, e um arquivo que
+         * apareceu sozinho na raiz é a primeira coisa que alguém apaga com raiva.
          */
         if (existing === null) {
-            if (home.path !== "CLAUDE.md")
+            const authorised = home.path === "CLAUDE.md" ||
+                (home.bornWhen != null &&
+                    (await exists(join(projectRoot, home.bornWhen))));
+            if (!authorised)
                 continue;
             await mkdir(dirname(path), { recursive: true }).catch(() => { });
             await writeFile(path, `${home.frontmatter ?? ""}${region}\n`, "utf8");
@@ -636,6 +640,37 @@ export async function syncClaudeMd(projectRoot) {
  * Um repo com `AGENTS.md` e `.cursor/` ganhou governança nos três lugares e não tinha como saber -
  * e o que não se diz não é adotado.
  */
+/**
+ * O COMANDO QUE ABRE CADA AGENTE - derivado de qual casa do bloco existe, nunca de uma lista fixa.
+ *
+ * O QUE O CLIENTE GANHA: o fim de um comando mostra o comando literal que abre o agente DELE, então
+ * "abra uma sessão nova" deixa de ser uma instrução que ele precisa traduzir (dono, 03/09: "seria
+ * legal ter os comandos para abrir, apenas para ficar fácil").
+ *
+ * MORA AO LADO DE `HOMES` de propósito. A mesma tabela que sabe onde o bloco vive é a que sabe como
+ * aquele agente abre - um agente novo entra em UM lugar. Se as duas listas morassem separadas, a
+ * segunda envelheceria calada no dia em que a primeira crescesse.
+ *
+ * O CURSOR NÃO TEM LINHA AQUI, e a ausência é a resposta certa: ele é um editor que se abre, não um
+ * comando de terminal. Inventar um `cursor .` mandaria alguém rodar o que talvez não exista no PATH
+ * dele.
+ *
+ * AS FLAGS SÃO AS QUE DISPENSAM APROVAR CADA ESCRITA, e o import escreve muito. Elas são DITAS na
+ * saída - o que a flag dispensa aparece em uma linha ao lado -, porque um comando cujo próprio nome
+ * carrega "dangerously" impresso sem uma palavra seria a gente escondendo o que ele faz.
+ */
+const OPENS = {
+    "CLAUDE.md": "claude --dangerously-skip-permissions",
+    "AGENTS.md": "codex --yolo",
+};
+/**
+ * Os comandos que abrem os agentes que ESTE repositório mostra ter - vazio quando nenhum deles
+ * carrega o bloco, e aí a saída não fala de abrir nada.
+ */
+export async function agentOpenCommands(projectRoot) {
+    const homes = await blockHomes(projectRoot);
+    return homes.map((h) => OPENS[h]).filter((c) => Boolean(c));
+}
 export async function blockHomes(projectRoot) {
     const found = [];
     for (const home of HOMES) {

package/dist/commands/align.js

@@ -2,6 +2,7 @@ import { readdir, readFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { join, resolve } from "node:path";
 import { pinnedHookVersion } from "../agent-wiring.js";
+import { agentOpenCommands } from "../claude-md.js";
 import { isOlderCli } from "../cli-version.js";
 import { readToken, resolveRegistry } from "../config.js";
 import { unsentEvents } from "../doctor/ledger.js";
@@ -633,7 +634,8 @@ export async function nextStepFor(root) {
         }
         : {
             sentence: 'This repo has no design system contract yet. Ask me: "import my design system."',
-            headline: "Open a new agent session in this repo and say:",
+            headline: "Open a new agent session in this repo",
+            open: await agentOpenCommands(root).catch(() => []),
             say: "import my design system",
             why: "I read what is already in your code - the colours, the type, the shapes, the components. Nothing is invented.",
         };
@@ -646,12 +648,36 @@ export async function nextStepFor(root) {
  * traz as linhas em branco de graça, que é o "respiro" pedido.
  */
 export function renderNextStep(next, freshSession) {
-    const lines = [section("Do this next"), body(next.headline), ""];
-    if (next.say)
+    const lines = [section("Do this next")];
+    /**
+     * NUMERA SÓ QUANDO SÃO DOIS PASSOS. Abrir o agente e falar com ele são duas coisas, e sem o "1" e
+     * o "2" a pessoa lê dois blocos azuis e não sabe se escolhe um ou faz os dois. Com um passo só, o
+     * número seria decoração.
+     */
+    const numbered = Boolean(next.open?.length && next.say);
+    if (next.open?.length) {
+        lines.push(body(numbered ? `1  ${next.headline}` : next.headline), "");
+        lines.push(paint.blue(snippet(next.open)), "");
+    }
+    if (next.say) {
+        if (next.open?.length)
+            lines.push(body(numbered ? "2  and say" : "and say"), "");
+        else
+            lines.push(body(`${next.headline} and say:`), "");
         lines.push(paint.blue(snippet([next.say])), "");
-    if (next.run?.length)
+    }
+    if (next.run?.length) {
+        lines.push(body(next.headline), "");
         lines.push(paint.blue(snippet(next.run)), "");
+    }
     lines.push(...bodyWrapped(next.why).map(paint.dim));
+    /** O que a flag dispensa, dito - ver `OPENS` em `claude-md.ts`. E concordando: um repo com um
+     *  agente só recebe uma linha no singular, porque "those flags" sobre um comando lê como se a
+     *  pessoa tivesse perdido uma opção da tela. */
+    if (next.open?.length)
+        lines.push(...bodyWrapped(next.open.length === 1
+            ? "That flag lets it write without asking each time. Drop it to approve every change yourself."
+            : "Those flags let it write without asking each time. Drop them to approve every change yourself.").map(paint.dim));
     if (freshSession)
         lines.push(...bodyWrapped(freshSession.mcp
             ? "A new session is what loads the skills and tools just installed, and the project's tools ask for approval once - say yes."

package/dist/install-marks.js

@@ -152,7 +152,17 @@
  * comentou vinha sendo escrito na pasta dele como componente de verdade. Medido em 14 arquivos
  * das duas populações o nó fantasma era a RAIZ - o elemento cujas classes viram a `base`.
  */
-export const MATERIALISER_SINCE = "0.16.349";
+/**
+ * 0.16.349 -> 0.16.360 em 03/09: a casa do bloco de governança passa a NASCER da pasta da
+ * ferramenta. Um repositório com `.codex/` recebe `AGENTS.md`, e um com `.cursor/` recebe
+ * `.cursor/rules/synthesisui.mdc` - dois arquivos que o materializador antes só atualizava se a
+ * pessoa já os tivesse escrito à mão. São bytes NOVOS na pasta dele, então esta é a primeira vez em
+ * seis cobranças que o passo 1 dá SIM.
+ *
+ * O que o cliente ganha ao rodar `upgrade`: as regras do sistema passam a existir no arquivo que o
+ * agente DELE lê, em vez de só no do Claude Code.
+ */
+export const MATERIALISER_SINCE = "0.16.360";
 /**
  * A ÚLTIMA VERSÃO EM QUE O QUE O HOOK RODA MUDOU.
  *

package/package.json

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