synthesisui 0.16.469 → 0.16.471

package/dist/commands/add.js

@@ -20,6 +20,7 @@ import { detectStack } from "../stack.js";
 import { onlyWhatMatched } from "../their-theme.js";
 import { tongueOf } from "../their-tongue.js";
 import { pointTokensAtTheirNames } from "../their-vars.js";
+import { resolveDeps } from "../stack.js";
 import { tracksAnyOf } from "../tracked.js";
 /**
  * QUAL METADE DESTA PASTA UM TIME COMMITA.
@@ -177,6 +178,43 @@ const exists = (path) => access(path).then(() => true, () => false);
  * eram duas leituras, o terminal dizia a verdade (só citava para quem tem) e a escrita plantava o
  * arquivo em todo mundo - a pior combinação, porque a prosa parecia certa.
  */
+/**
+ * O PROJETO USA TAILWIND? - pela dependência, ou pela folha de entrada que o importa (`@import "tailwindcss"`,
+ * `@tailwind base`). Só o que a frase do alinhamento precisa: ela não existe num projeto sem Tailwind (28/09).
+ */
+async function familiesHeNames(root, families) {
+    const { access } = await import("node:fs/promises");
+    const imported = await access(join(root, "_synthesisui", "census.json")).then(() => true, () => false);
+    if (!imported)
+        return families;
+    const { readTheirCss } = await import("../doctor/requests.js");
+    const css = (await readTheirCss(root)).toLowerCase();
+    if (!css.trim())
+        return families;
+    const kept = Object.entries(families).filter(([, v]) => {
+        if (typeof v !== "string")
+            return true;
+        const first = v.split(",")[0]?.trim().replace(/^["']|["']$/g, "") ?? "";
+        return !first || /^var\(/.test(first) || css.includes(first.toLowerCase());
+    });
+    return Object.fromEntries(kept);
+}
+async function projectWearsTailwind(root) {
+    const deps = await resolveDeps(root).catch(() => ({}));
+    if (Object.keys(deps).some((d) => d === "tailwindcss" || d.startsWith("@tailwindcss/")))
+        return true;
+    const { readdir, readFile } = await import("node:fs/promises");
+    for (const dir of ["", "app", "src", "src/app", "styles", "src/styles"]) {
+        for (const name of await readdir(join(root, dir)).catch(() => [])) {
+            if (!/\.(css|scss)$/i.test(name))
+                continue;
+            const text = await readFile(join(root, dir, name), "utf8").catch(() => "");
+            if (/@import\s+["']tailwindcss["']|@tailwind\s+(base|components|utilities)/.test(text))
+                return true;
+        }
+    }
+    return false;
+}
 async function wearsShadcn(root) {
     return access(join(root, "components.json")).then(() => true, () => false);
 }
@@ -591,7 +629,13 @@ export async function add(slug, opts) {
      * A linha diz quantos utilitários do Tailwind ficaram apontando para a decisão dele e quantos
      * saíram por serem nossos, com os primeiros nomes. Quem lê pode discordar de qualquer um.
      */
-    if (!opts.themeFollows && (aligned.dropped.length > 0 || aligned.own.length > 0)) {
+    /**
+     * A FRASE DO TAILWIND SÓ EXISTE ONDE HÁ TAILWIND - rodadas 12 a 14 do refinamento, 28/09. "Your code declares no
+     * Tailwind names of its own yet" saía no Vite e no Sass, que não têm Tailwind, e no Tailwind com 24 nomes no
+     * `@theme` - vinte linhas depois de "100% of your 59 style decisions carry your own vocabulary".
+     */
+    const wearsTailwind = await projectWearsTailwind(projectRoot);
+    if (wearsTailwind && !opts.themeFollows && (aligned.dropped.length > 0 || aligned.own.length > 0)) {
         console.log(line(
         /**
          * A LINHA DIZ QUE FICARAM DE FORA - e nao AFIRMA por que, porque ela nao sabe.
@@ -614,7 +658,7 @@ export async function add(slug, opts) {
          * Com ZERO, a frase falava de decisões que um projeto novo não tem - rodada 1 do refinamento,
          * 27/09: "0 Tailwind utilities now point at your own decisions", num Next recém-criado.
          */
-        `  ${aligned.kept > 0 ? `${aligned.kept} Tailwind utilit${aligned.kept === 1 ? "y" : "ies"} now point at your own decisions` : "Your code declares no Tailwind names of its own yet"}${aligned.own.length > 0 ? `; ${aligned.own.length} more name${aligned.own.length === 1 ? "s a utility" : " utilities"} only this system has (${aligned.own.slice(0, 3).join(", ")}${aligned.own.length > 3 ? ", …" : ""}), so they are declared here` : ""}${aligned.dropped.length > 0 ? `; ${aligned.dropped.length} were left as ${aligned.dropped.length === 1 ? "it is" : "they are"} (${aligned.dropped.slice(0, 3).join(", ")}${aligned.dropped.length > 3 ? ", …" : ""}) - your classes keep meaning what they mean today` : ""}.`));
+        `  ${aligned.kept > 0 ? `${aligned.kept} Tailwind utilit${aligned.kept === 1 ? "y" : "ies"} now point at your own decisions` : "None of your Tailwind names needed re-pointing - they already say what they mean"}${aligned.own.length > 0 ? `; ${aligned.own.length} more name${aligned.own.length === 1 ? "s a utility" : " utilities"} only this system has (${aligned.own.slice(0, 3).join(", ")}${aligned.own.length > 3 ? ", …" : ""}), so they are declared here` : ""}${aligned.dropped.length > 0 ? `; ${aligned.dropped.length} were left as ${aligned.dropped.length === 1 ? "it is" : "they are"} (${aligned.dropped.slice(0, 3).join(", ")}${aligned.dropped.length > 3 ? ", …" : ""}) - your classes keep meaning what they mean today` : ""}.`));
     }
     /**
      * O CICLO RECUSADO É DITO, e não engolido - senão o cliente lê um número menor sem saber por quê.
@@ -661,9 +705,18 @@ export async function add(slug, opts) {
      * ausente do diretório de trabalho, o que ninguém faz de propósito. A linha passa a dizer isso e o
      * comando de volta.
      */
+    /**
+     * "updated" SÓ QUANDO MUDOU - rodada 12, 28/09. Sem agente ligado, nada é escrito (a escolha dele autoriza cada
+     * casa), e a linha dizia "CLAUDE.md updated - your file is intact, with our block inside it" sobre um arquivo que
+     * o `git diff` mostrava intocado.
+     */
     console.log(claudeMd.created
         ? `  CLAUDE.md created - there was none here (${claudeMd.count} system(s) indexed). If your repo has one in git, it is missing from your working tree: \`git checkout -- CLAUDE.md\` and run this again to keep both.`
-        : `  CLAUDE.md updated - your file is intact, with our block inside it (${claudeMd.count} system(s) indexed)`);
+        : claudeMd.changed.length > 0
+            ? `  ${claudeMd.changed.join(" and ")} updated - your file is intact, with our block inside it (${claudeMd.count} system(s) indexed)`
+            : (await agentsToMaintain(projectRoot)).length === 0
+                ? "  your agent's instructions were not touched - no agent is connected here yet. `npx synthesisui connect` writes the block"
+                : `  CLAUDE.md already current - nothing to rewrite (${claudeMd.count} system(s) indexed)`);
     if (opts.setupHints === false)
         return;
     // ── DX: concrete paths + copy-pasteable snippets, with breathing room ──
@@ -704,7 +757,12 @@ export async function add(slug, opts) {
     //    Next apps get fonts.ts MATERIALIZED (deterministic does, not teaches):
     //    next/font = self-hosted + preloaded + adjusted fallback, no FOUT
     //    "blink". The Google Fonts <link> stays as the framework-agnostic path.
-    const families = payload.document.foundations.typography.families;
+    /**
+     * NUM SISTEMA IMPORTADO, SÓ AS FAMÍLIAS QUE O CÓDIGO DELE NOMEIA - rodada 13, 28/09: o link pedia JetBrains Mono,
+     * a mono da semente, num projeto que só declara Inter e Lora. Num fork ou num projeto novo (sem censo), as
+     * fontes do sistema escolhido são as dele e continuam todas.
+     */
+    const families = await familiesHeNames(projectRoot, payload.document.foundations.typography.families);
     const fontsHref = googleFontsHref(families);
     /**
      * OS PESOS QUE AS FAMÍLIAS TÊM NO PROJETO DELE - ver `next-font-weights.ts`.
@@ -712,7 +770,15 @@ export async function add(slug, opts) {
      * Lido UMA vez e passado adiante: o manifesto tem 1942 famílias, e reabri-lo por app de um
      * monorepo seria a mesma leitura repetida com liberdade de discordar de si mesma.
      */
-    const fontPlan = projectConfig.target === "next"
+    /**
+     * O next/font SÓ ONDE HÁ NEXT - rodada 13, 28/09: num projeto Vite o `add` dizia "next/font: app/fonts.ts was NOT
+     * written - this project's next/font manifest is not readable" e mandava editar `app/layout.tsx`. O `target` do
+     * config nasce `next` por padrão; a dependência é o fato.
+     */
+    const stackDeps = await resolveDeps(projectRoot).catch(() => ({}));
+    const onNext = projectConfig.target === "next" && "next" in stackDeps;
+    const headHome = onNext ? "app/layout.tsx" : "vite" in stackDeps ? "index.html" : "your root HTML";
+    const fontPlan = onNext
         ? nextFontSnippet({
             families,
             appDir,
@@ -836,7 +902,7 @@ export async function add(slug, opts) {
     }
     else if (fontsHref) {
         console.log("");
-        console.log(line("3. Load the type - this system ships font NAMES, not the fonts. Add to your app's <head> (e.g. app/layout.tsx) so the families resolve (else they fall back and the look is lost):"));
+        console.log(line(`3. Load the type - this system ships font NAMES, not the fonts. Add to your app's <head> (e.g. ${headHome}) so the families resolve (else they fall back and the look is lost):`));
         console.log("");
         console.log(snippet([
             `<link rel="preconnect" href="https://fonts.googleapis.com" />`,
@@ -844,7 +910,7 @@ export async function add(slug, opts) {
             `<link rel="stylesheet" href="${fontsHref}" />`,
         ]));
         console.log("");
-        console.log(line(`   Prefer next/font or self-hosting? Fine - just register these exact families: ${customFontFamilies(families).join(", ")}.`));
+        console.log(line(`   Prefer ${onNext ? "next/font or " : ""}self-hosting? Fine - just register these exact families: ${customFontFamilies(families).join(", ")}.`));
     }
     console.log(section("Next"));
     // FIRST, and before anything that assumes the setup worked. The block above

package/dist/commands/align.js

@@ -23,6 +23,24 @@ import { SKILLS } from "../skills.js";
  * `null` para censo que não diz quem o mediu: um censo assim não prova nada, e supor que ele é
  * velho faria toda pessoa que ainda não re-mediu ver o aviso para sempre.
  */
+/**
+ * O CENSO DIZ QUE MEDIU O REPOSITÓRIO INTEIRO - `measured` com a procedência e nenhum `scope`, que por contrato é
+ * "o repositório inteiro" (`Census.scope`). Sem isto, todo import sem `--scope` terminava em "does not record where
+ * it was measured" sobre um sistema que tinha vindo dali (rodadas 11 a 14, 28/09).
+ */
+async function wholeRepoMeasured(root) {
+    const raw = await readFile(join(root, "_synthesisui", "census.json"), "utf8").catch(() => null);
+    if (!raw)
+        return false;
+    try {
+        const c = JSON.parse(raw);
+        const narrowed = (typeof c.scope === "string" && c.scope.trim() !== "") || (Array.isArray(c.scopes) && c.scopes.length > 0);
+        return c.measured != null && typeof c.measured === "object" && !narrowed;
+    }
+    catch {
+        return false;
+    }
+}
 async function censusMeasuredBy(root) {
     const raw = await readFile(join(root, "_synthesisui", "census.json"), "utf8").catch(() => null);
     if (!raw)
@@ -210,7 +228,7 @@ opts = {}) {
      * sistema de 36).
      */
     const scope = await measuredScope(root, lock.slug);
-    if (!scope.system && scope.usage.length === 0 && lock.reading !== "none")
+    if (!scope.system && scope.usage.length === 0 && lock.reading !== "none" && !(await wholeRepoMeasured(root)))
         out.push({
             says: `"${lock.slug}" does not record where it was measured, so a re-measure would read this whole repo instead of the folder the system came from. Sync asks once and remembers the answer.`,
             /**

package/dist/commands/component.js

@@ -278,7 +278,9 @@ export async function component(slug, name, opts) {
          * A saída oferecida é a mesma que o `upgrade` oferece, e é a que ele já tem na mão: `--force`.
          */
         const slugDir = join(root, "_synthesisui", "ds", slug);
-        const editedHere = await editedSinceWritten((await readWritten(slugDir))[local], join(root, config.componentsDir, local));
+        const editedHere = await editedSinceWritten((await readWritten(slugDir))[local], join(root, config.componentsDir, local), 
+        /** ele está pedindo o componente: o arquivo que apagou não é trabalho dele a proteger */
+        { missingIsEdit: false });
         if (editedHere && editedHere.length > 0 && !opts.force) {
             console.log(section("You edited this one"));
             console.log(body(`${editedHere.join(", ")} in ${config.componentsDir}/${local} changed after we wrote ${editedHere.length === 1 ? "it" : "them"} - kept YOUR file(s).`));

package/dist/commands/gaps.js

@@ -28,10 +28,13 @@ export async function gaps(opts) {
     let ledger;
     /** A régua única - ver `describeValueRuler`. Ausente num censo medido antes de 0.16.308. */
     let values;
+    /** A cobertura por componente - existe em todo estilo, inclusive os que não vestem classe. */
+    let coverage;
     try {
         const census = JSON.parse(raw);
         ledger = census.ledger;
         values = census.values?.classes ?? undefined;
+        coverage = census.coverage ?? undefined;
     }
     catch {
         console.log(body(`${path} is not readable JSON.`));
@@ -47,7 +50,7 @@ export async function gaps(opts) {
         return;
     }
     if (opts.brief)
-        return brief(ledger, values);
+        return brief(ledger, values, coverage);
     for (const line of describeTriage(triageLedger(ledger, opts.cli), values))
         console.log(body(line));
     /**
@@ -111,10 +114,23 @@ export async function gaps(opts) {
  *   resolver o valor que carrega dois nomes dele. Um link sem consequência dita é um link que
  *   espera para sempre.
  */
-async function brief(ledger, values) {
+async function brief(ledger, values, coverage) {
     const places = ledger.unread.length;
-    if (!values)
+    /**
+     * SEM A CONTA POR CLASSE, A COBERTURA POR COMPONENTE - rodadas 8 e 9, 27/09.
+     *
+     * `values` só existe quando algum componente veste classe. CSS Modules, `style={{ }}` e SCSS não
+     * vestem, e o `brief` saía com o título e mais nada. `coverage` existe nos três, e é a mesma
+     * pergunta ("quanto do que você escreveu chegou") numa unidade que eles têm.
+     */
+    if (!values) {
+        console.log(bodyWrapped(coverage && coverage.components > 0
+            ? `We read ${paint.blue(paint.strong(`${coverage.read} of your ${coverage.components} components`))} - ${coverage.declarations} style ${coverage.declarations === 1 ? "declaration" : "declarations"} between them.`
+            : "This measurement carries no coverage number, so there is none to show rather than a zero.").join("\n"));
+        if (places > 0)
+            console.log(bodyWrapped(paint.dim(`What we did not read sits in ${places} ${places === 1 ? "place" : "places"} - \`synthesisui gaps\` lists each one with the file and the line.`)).join("\n"));
         return;
+    }
     const decisions = values.seen - values.structure;
     const closed = values.interpreted + values.answered;
     const pct = decisions > 0 ? Math.round((closed / decisions) * 100) : 0;

package/dist/commands/hook.js

@@ -582,16 +582,43 @@ round) {
         said.push(...refusals);
         block = true;
     }
-    if (rest.length > 0)
+    if (rest.length > 0) {
+        /**
+         * OS QUE PASSARAM DO CORTE SÃO CHECADOS TAMBÉM - rodadas 12 a 14 do refinamento, 28/09.
+         *
+         * A frase era "were not checked here", e o agente ia conferir a pasta à mão em todo turno. O relatório
+         * continua em três - trinta numa resposta é o ruído que faz alguém desinstalar -, mas a varredura dos outros
+         * é barata, e o que ela acha sai como UMA linha: os que escrevem valor à mão, pelo nome, ou "nothing to name".
+         */
+        const { table } = await loadSystem(root).catch(() => ({ table: null }));
+        const dirty = [];
+        let measured = 0;
+        for (const { rel } of rest.slice(0, REFUSAL_CEILING)) {
+            const src = table ? await readFile(join(root, rel), "utf8").catch(() => null) : null;
+            if (src == null || !table)
+                continue;
+            measured += 1;
+            const n = diagnose([scanSource(rel, src, table)]).findings.length;
+            if (n > 0)
+                dirty.push(`${rel} (${n} by hand)`);
+        }
+        const unmeasured = rest.length - measured;
         said.push([
-            `${rest.length} more file${rest.length === 1 ? "" : "s"} changed in this ${round} and ${rest.length === 1 ? "was" : "were"} not checked here: ${rest
-                .slice(0, 10)
-                .map((c) => c.rel)
-                .join(", ")}${rest.length > 10 ? `, +${rest.length - 10} more` : ""}.`,
+            measured === 0
+                ? `${rest.length} more file${rest.length === 1 ? "" : "s"} changed in this ${round} and ${rest.length === 1 ? "was" : "were"} not checked here: ${rest
+                    .slice(0, 10)
+                    .map((c) => c.rel)
+                    .join(", ")}${rest.length > 10 ? `, +${rest.length - 10} more` : ""}.`
+                : dirty.length === 0
+                    ? `${measured} more file${measured === 1 ? "" : "s"} changed in this ${round}, checked too - nothing to name.${unmeasured > 0 ? ` ${unmeasured} more past the ceiling were not read.` : ""}`
+                    : `${measured} more file${measured === 1 ? "" : "s"} changed in this ${round}, checked too: ${dirty
+                        .slice(0, 10)
+                        .join(", ")}${dirty.length > 10 ? `, +${dirty.length - 10} more` : ""}.${unmeasured > 0 ? ` ${unmeasured} more past the ceiling were not read.` : ""}`,
             round === "turn"
                 ? "Run `npx synthesisui doctor` to see them - they are checked again the next turn one of them changes."
                 : "Run `npx synthesisui doctor` to see them, or write one of them again and this will check it.",
         ].join("\n"));
+    }
     return { said, block };
 }
 /**

package/dist/commands/import.js

@@ -9,13 +9,13 @@ import { craftLines } from "../baseline-craft.js";
 import { PAGES_MAX, pageCompositionOf } from "../census-pages.js";
 import { readCredentials, readProjectConfig, readToken, resolveRegistry, sameRegistry, } from "../config.js";
 import { declaredElsewhere } from "../declared-elsewhere.js";
-import { architectureGap, architectureRule, componentHome, describeArchitecture, describeChoice, describeGap, detectArchitectures, homeLine, packagingOf, proposeNewHome, resolvesAs, } from "../doctor/architecture.js";
+import { architectureGap, architectureRule, componentHome, describeArchitecture, describeChoice, describeGap, detectArchitectures, homeLine, packagingOf, proposeNewHome, resolvesAs, countsAsOrganization, } from "../doctor/architecture.js";
 import { findBrokenRefs } from "../doctor/broken-refs.js";
 import { nestingRules, propRules, readDefinitionProps, readNesting, readRuntime, } from "../doctor/call-sites.js";
 import { asCatalogueTable, describeFallback, fetchCatalogue, } from "../doctor/catalogue-fetch.js";
 import { describeClassStyle, detectClassStyle, } from "../doctor/class-style.js";
 import { isNearDuplicate, isNeutral, lightness, } from "../doctor/color-distance.js";
-import { describeGate, gateComponent, groupSkips, SCREENS_FOR_SYSTEM, } from "../doctor/component-gate.js";
+import { describeGate, gateComponent, groupSkips, SCREENS_FOR_SYSTEM, livesInSharedFolder, } from "../doctor/component-gate.js";
 import { emptyTally, internalSpecifiers, scanComponentsInto, tallyToInventory, } from "../doctor/components-scan.js";
 import { countShape, describeCoverage, summarizeCoverage, } from "../doctor/coverage.js";
 import { classifyAside, crosswalk, floorSize, isLibrary, observedRules, useLiveCatalogue, } from "../doctor/crosswalk.js";
@@ -781,7 +781,7 @@ export async function takeCensus(root, opts) {
          * número que a organização declara é o que ele confere na mão, então ele conta o que ele
          * conta quando confere.
          */
-        if (/\.(tsx|jsx|vue|svelte)$/i.test(rel) && !SHOWS_A_COMPONENT.test(rel)) {
+        if (countsAsOrganization(rel) && !SHOWS_A_COMPONENT.test(rel)) {
             const parts = rel.split("/");
             // Every ancestor learns the name of the child directly under it, which is all
             // the shape detector needs and is one pass rather than a tree walk.
@@ -1538,7 +1538,8 @@ export async function takeCensus(root, opts) {
                 continue;
             }
             const screens = screensOf.get(d.name)?.size ?? 0;
-            if (screens >= SCREENS_FOR_SYSTEM) {
+            /** A pasta compartilhada é compartilhada por onde mora - ver `livesInSharedFolder` (r11, 28/09). */
+            if (screens >= SCREENS_FOR_SYSTEM || livesInSharedFolder(d.file)) {
                 keep.push(d);
                 continue;
             }
@@ -4990,6 +4991,8 @@ export async function runImport(opts) {
     await writeFile(out, `${JSON.stringify(census, null, 2)}\n`, "utf8");
     const token = await readToken();
     if (!token) {
+        /** A medição está salva, e o sistema não existe: quem chamou não pode ler "enviado". */
+        process.exitCode = 1;
         console.log("");
         console.log(body("To turn this into a system on your account:"));
         console.log(body(`    ${paint.strong("synthesisui login")}`));
@@ -5002,6 +5005,7 @@ export async function runImport(opts) {
     // a 401 that describes the wrong problem entirely.
     const creds = await readCredentials();
     if (creds && !sameRegistry(creds.registry, base)) {
+        process.exitCode = 1;
         console.log("");
         console.log(body(`You are logged in to ${paint.strong(creds.registry ?? "another registry")}, and this would go to ${paint.strong(base)}.`));
         console.log(body(`Your measurement is saved at ${out}. Either name the one you meant:`));
@@ -5055,6 +5059,14 @@ export async function runImport(opts) {
         }),
     }).catch(() => null);
     if (!res || !res.ok) {
+        /**
+         * NADA FOI CRIADO, e o código de saída tem que dizer isso - rodadas 6 a 10, 27/09.
+         *
+         * Os quatro ramos abaixo (sessão vencida, limite do plano, recusa, rede) terminavam em `return`
+         * e o processo saía com 0. Um agente que confia no código de saída lia "enviado". Fica aqui, uma
+         * vez, antes dos ramos, para que um ramo novo não nasça esquecendo.
+         */
+        process.exitCode = 1;
         const refusal = res
             ? await res
                 .json()
@@ -5122,7 +5134,12 @@ export async function runImport(opts) {
     if (inheritedHere > 0) {
         console.log(body(`${inheritedHere} form${inheritedHere === 1 ? "" : "s"} your team already taught the pipeline apply here too - the next measurement reads them without you declaring anything.`));
     }
-    console.log(body(`${paint.strong(payload?.name ?? "Your system")} - v1 mirrors your tokens exactly, nothing improved yet.`));
+    console.log(body(
+    /**
+     * NÃO "ESPELHA EXATAMENTE" - rodadas 11 e 13, 28/09: a v1 trazia um `display` de 4rem e uma mono JetBrains que
+     * o projeto nunca declarou, e a frase dizia o contrário. As fundações vêm da semente onde ele não nomeia nada.
+     */
+    `${paint.strong(payload?.name ?? "Your system")} - v1 is your tokens, nothing improved yet; where your code names nothing, it keeps the starting point's value (listed in the report).`));
     /**
      * ONDE ELE NASCEU, dito pela plataforma e não pelo que foi pedido.
      *

package/dist/commands/mcp.js

@@ -385,7 +385,19 @@ async function checkFile(root, path) {
     }
     if (reports.length === 0)
         return fromContract(`Nothing readable at ${path}.`);
-    const d = diagnose(reports);
+    /** As folhas do projeto que declaram nomes - só como vocabulário, ver `diagnose`. */
+    const seen = new Set(reports.map((r) => r.file));
+    const context = [];
+    for await (const file of walkAll([root])) {
+        const rel = relative(root, file);
+        if (seen.has(rel) || !/\.(css|scss|sass|less)$/i.test(rel))
+            continue;
+        const src = await readFile(file, "utf8").catch(() => "");
+        const report = src ? scanSource(rel, src, table) : null;
+        if (report?.ownDeclared?.length)
+            context.push(report);
+    }
+    const d = diagnose(reports, context);
     /**
      * `0%` DEIXOU DE RESPONDER POR TRÊS COISAS - ver `Reach` em `scan.ts`.
      *

package/dist/commands/status.js

@@ -51,6 +51,30 @@ export async function status(opts) {
         // sem _synthesisui: tratado abaixo
     }
     console.log(section("Status"));
+    /**
+     * A CONTA, ANTES DE TUDO - rodadas 6 a 10, 27/09. Este comando só falava dela quando NÃO havia
+     * login, e o agente ia ler `~/.synthesisui/credentials.json` para saber em qual conta estava. O
+     * arquivo não guarda conta nenhuma: quem sabe é o servidor, pelo mesmo bearer. O token não aparece.
+     */
+    const token = await readToken();
+    const base = resolveRegistry(opts.registry);
+    if (!token) {
+        console.log(body(paint.dim("Not logged in, so this is the local half. `synthesisui login` adds what the platform knows.")));
+    }
+    else {
+        const who = await fetch(`${base}/api/auth/get-session`, {
+            headers: { Authorization: `Bearer ${token}` },
+        })
+            .then(async (r) => r.ok ? (await r.json()) : null)
+            .then((j) => ({ reached: true, email: j?.user?.email ?? null }))
+            .catch(() => ({ reached: false, email: null }));
+        console.log(body(who.email
+            ? `Logged in as ${paint.strong(who.email)} on ${base}.`
+            : who.reached
+                ? `The saved login is no longer accepted by ${base}. \`synthesisui login\` signs in again.`
+                : `Logged in on ${base}, and the account could not be confirmed - the registry did not answer.`));
+    }
+    console.log("");
     if (installed.length === 0) {
         /**
          * NADA INSTALADO NÃO SIGNIFICA NADA A OFERECER, e mandar `list` era o conselho da outra pessoa.
@@ -128,13 +152,8 @@ export async function status(opts) {
      * A ÚNICA PERGUNTA QUE O DISCO NÃO SABE: existe medição mais nova do que a minha? Sem login isso
      * simplesmente não é dito - e não é um erro, porque tudo acima continua verdadeiro.
      */
-    const token = await readToken();
-    if (!token) {
-        console.log("");
-        console.log(body(paint.dim("Not logged in, so this is the local half. `synthesisui login` adds what the platform knows.")));
+    if (!token)
         return;
-    }
-    const base = resolveRegistry(opts.registry);
     const owned = installed.find((ds) => !ds.adopted);
     if (!owned)
         return;

package/dist/commands/sync.js

@@ -13,6 +13,7 @@ import { measuredScope, rememberScope } from "../measured-scope.js";
 import { fromCensus } from "../memory/observation.js";
 import { reportMeasurement } from "../memory/report.js";
 import { mergeCensus } from "../merge-census.js";
+import { describeGrowth, whatGrew } from "../what-grew.js";
 import { body, paint, section, snippet } from "../output.js";
 import { repoStateOf } from "../repo-state.js";
 import { reportWhatIsLeft } from "./align.js";
@@ -602,6 +603,26 @@ export async function remeasure(args) {
             return null;
         }
     }
+    /**
+     * O QUE O CÓDIGO DELE GANHOU, ANTES DE IR - itens 4 e 4b da triagem das rodadas 11 a 14 (28/09).
+     *
+     * *"Componente novo nunca entra nem sai do sistema calado"*, e passa pela engine: cada um que nasceu desde o último
+     * envio vem com a medida de cor e espaçamento (a régua do `doctor`), e o que sumiu do código é nomeado. Num
+     * terminal, a pessoa diz se vai; sem terminal (o agente), vai, e a lista fica na saída para ele repassar.
+     */
+    {
+        const grown = await whatGrew(root, census, (await readSyncMark(root))?.readings ?? null);
+        const growth = describeGrowth(grown);
+        if (growth.length > 0) {
+            console.log(section("What your code grew"));
+            for (const l of growth)
+                console.log(body(l));
+            if (!(await askToSendGrowth())) {
+                console.log(body("Nothing was sent. Your draft is untouched - run `npx synthesisui sync` again when you want them in."));
+                return null;
+            }
+        }
+    }
     /**
      * O QUE ELE MUDOU NO DESIGN SYSTEM INSTALADO, lido do disco e sem rede.
      *
@@ -908,6 +929,23 @@ export async function remeasure(args) {
  * Sem TTY a resposta é NÃO: uma invocação por script que sobrescreve trabalho de alguém porque
  * ninguém estava lá para dizer não é o pior default possível. `--yes` é o caminho explícito.
  */
+/** Sem terminal, vai - o agente repassa a lista. Com terminal, a pessoa responde, e Enter é sim. */
+async function askToSendGrowth() {
+    if (!process.stdin.isTTY || !process.stdout.isTTY)
+        return true;
+    const { createInterface } = await import("node:readline/promises");
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const answer = await rl.question("  send them to your system's draft? [Y/n]: ");
+        return !/^n(o)?$/i.test(answer.trim());
+    }
+    catch {
+        return true;
+    }
+    finally {
+        rl.close();
+    }
+}
 async function askToOverwrite() {
     if (!process.stdin.isTTY || !process.stdout.isTTY)
         return false;

package/dist/doctor/architecture.js

@@ -64,6 +64,17 @@ const SHAPES = [
         describe: (a, where) => `Every component sits directly under \`${flatFolder(where, a.evidence[0])}\`, one folder deep. It is the shape that stays legible longest while a system is small, and the one to revisit when the folder passes about forty names.`,
     },
 ];
+/**
+ * O ARQUIVO DA ROTA NÃO É COMPONENTE - rodadas 11, 12 e 14 do refinamento, 28/09.
+ *
+ * `page.tsx` e `layout.tsx` contavam como componentes na medida da organização, e um `app/` só com rotas virava
+ * "Components sit BESIDE THE ROUTE" - a regra ficava somada à que o dono escolheu. As convenções de arquivo do
+ * Next (app e pages) são do framework: dizem onde a tela mora, não onde um componente nasce.
+ */
+const ROUTE_FILE = /(^|\/)(page|layout|loading|error|global-error|not-found|template|default|route|head|_app|_document|_error)\.(tsx|jsx|ts|js)$/i;
+export function countsAsOrganization(rel) {
+    return /\.(tsx|jsx|vue|svelte)$/i.test(rel) && !ROUTE_FILE.test(rel);
+}
 /**
  * O MESMO NOME, MÓDULO CAIXA E SEPARADOR - a única normalização deste arquivo.
  *

package/dist/doctor/class-style.js

@@ -40,6 +40,31 @@ export const UTILITY = /\b(?:bg|text|border|p|px|py|m|mx|my|gap|flex|grid|rounde
  * would rename everything we compile on the strength of three sightings.
  */
 const MIN_GLOBAL_DECLS = 20;
+/** O piso quando a folha é BEM de verdade (`__` e `--` na maioria das classes) - ver `detectClassStyle`. */
+const MIN_BEM_DECLS = 6;
+/**
+ * O BEM ANINHADO DO SASS, escrito por extenso - `.button { &--primary {} &__icon {} }` são `button--primary` e
+ * `button__icon`. O `CLASS_DECL` só via `.classe {` no começo da linha, e uma casa BEM em Sass quase nunca
+ * escreve assim (rodada 14, 28/09).
+ */
+function nestedBem(source) {
+    const out = [];
+    const stack = [];
+    for (const line of source.split("\n")) {
+        const own = /^\s*\.([a-zA-Z][\w-]*)\s*\{/.exec(line)?.[1];
+        const child = /^\s*&(__|--)([\w-]+)\s*[{,:]/.exec(line);
+        const parent = [...stack].reverse().find((c) => c != null) ?? null;
+        if (child && parent)
+            out.push(`${parent}${child[1]}${child[2]}`);
+        for (const ch of line) {
+            if (ch === "{")
+                stack.push(own ?? (child && parent ? `${parent}${child[1]}${child[2]}` : null));
+            else if (ch === "}")
+                stack.pop();
+        }
+    }
+    return out;
+}
 /**
  * Prefixes worth honouring have to be shared by most of what they declare.
  * A project with `app-header` and `admin-nav` has two words, not a prefix.
@@ -60,6 +85,8 @@ export function detectClassStyle(files) {
             // Only a non-module stylesheet can hold a class anybody else must match.
             for (const m of source.matchAll(CLASS_DECL))
                 globalDecls.push(m[1]);
+            if (/\.(scss|sass|less)$/i.test(file))
+                globalDecls.push(...nestedBem(source));
             continue;
         }
         utilities += source.match(UTILITY)?.length ?? 0;
@@ -71,7 +98,14 @@ export function detectClassStyle(files) {
     // threshold with no convention between them, and we would have renamed every
     // class we compile to match vendor CSS (dono, 01/08). Many global classes with
     // nothing in common is not a house style, it is a stylesheet.
-    if (globalDecls.length >= MIN_GLOBAL_DECLS) {
+    /**
+     * UMA CASA BEM PEQUENA TAMBÉM É CASA - rodada 14, 28/09. Quatro blocos com `--modificador` e `__parte` são
+     * uma convenção inequívoca, e a régua de 20 existe para a folha sem forma (o tema de syntax-highlighting
+     * abaixo), não para esta. A forma é exigida do mesmo jeito: só baixa o piso quando a folha é BEM de verdade.
+     */
+    const bemShaped = globalDecls.filter((c) => /__|--/.test(c)).length;
+    const floor = bemShaped >= MIN_BEM_DECLS && bemShaped / Math.max(1, globalDecls.length) > 0.4 ? MIN_BEM_DECLS : MIN_GLOBAL_DECLS;
+    if (globalDecls.length >= floor) {
         const shape = shapeOf(globalDecls);
         if (shape) {
             return {

package/dist/doctor/component-gate.js

@@ -203,8 +203,32 @@ function adapterFor(source, internal) {
  * caller passes the counts only when it has them, and absent means the test is skipped.
  */
 export const SCREENS_FOR_SYSTEM = 2;
+/**
+ * A PASTA QUE O PRODUTO COMPARTILHA - `components/`, `ui/`, o pacote de ui de um monorepo. O que mora ali já é,
+ * pelo lugar, uma decisão compartilhada, e a regra das duas telas não se aplica: no r11 (28/09) ela tirou o
+ * Button, o Input e o Label de `components/ui` depois de três telas. O que mora DENTRO da árvore de rotas
+ * (`app/`, `pages/`) continua passando pela régua.
+ */
+export function livesInSharedFolder(file) {
+    const parts = file.split(/[/\\]/).slice(0, -1).map((p) => p.toLowerCase());
+    if (parts.some((p) => p === "app" || p === "pages" || p === "routes"))
+        return false;
+    return parts.some((p) => p === "components" || p === "ui" || p === "atoms" || p === "molecules" || p === "organisms");
+}
 export function gateComponent(input) {
     const { name, file, source } = input;
+    /**
+     * A RAIZ QUE O VITE (E O CREATE-REACT-APP) MONTA - `src/App.tsx` é a tela inteira, o que a `page` é no Next.
+     * No r13 (28/09) ela entrou no sistema como o componente `app`. Só na raiz do escopo ou de `src/`: um `App`
+     * dentro de uma pasta de componentes é outra coisa.
+     */
+    if (/^(src[/\\])?App\.[jt]sx?$/.test(file)) {
+        return {
+            ok: false,
+            why: "route",
+            because: `\`${file}\` is the root the app mounts - the whole screen, not a component somebody can import`,
+        };
+    }
     if (RESERVED_FILE.test(file) || RESERVED_FILE_OTHER.test(file)) {
         return {
             ok: false,
@@ -296,7 +320,7 @@ export function gateComponent(input) {
             because: `\`${name}\` is a capitalised export in a file with no markup - a constant, a config object or a helper`,
         };
     }
-    if (input.screens != null && input.screens < SCREENS_FOR_SYSTEM) {
+    if (input.screens != null && input.screens < SCREENS_FOR_SYSTEM && !livesInSharedFolder(file)) {
         return {
             ok: false,
             why: "feature",

package/dist/doctor/components-scan.js

@@ -436,9 +436,20 @@ internal = []) {
         }
     }
 }
+/**
+ * A PEÇA DO FRAMEWORK - `StrictMode`, `Suspense`, `Link`, `Form`, `Image`. É encanamento que o React e o Next dão
+ * a todo mundo, e não interface de ninguém: nas rodadas 11, 13 e 14 (28/09) `next/link`, `next/form` e o
+ * `StrictMode` entraram no sistema como componentes do projeto. Uma biblioteca de INTERFACE (`@mui/material`,
+ * `@radix-ui/*`) continua contando - é ela que se cruza com a nossa.
+ */
+const FRAMEWORK_PIECE = /^(react|react-dom(\/.*)?|next\/(link|form|image|script|head|dynamic|navigation|router)|react-router(-dom)?|@remix-run\/react|@tanstack\/react-router)$/;
+export function isFrameworkPiece(origin) {
+    return Boolean(origin && FRAMEWORK_PIECE.test(origin));
+}
 /** The inventory, commonest first. */
 export function tallyToInventory(tally, max = 80) {
     return [...tally.entries()]
+        .filter(([key]) => !isFrameworkPiece(key.slice(key.indexOf("\u0000") + 1) || undefined))
         .map(([key, v]) => ({
         /** A chave carrega a origem para separar as linhas - o nome é a primeira metade dela. */
         name: key.split("\u0000")[0],

package/dist/doctor/requests.js

@@ -172,13 +172,22 @@ export function declaresName(installedCss, name) {
  * ENTREGA o valor pedido. Sem valor comparável ele fica aberto e quem decide é a pessoa, no cartão -
  * um pedido aberto custa uma linha numa tela, um fechamento falso custa o bug.
  */
-export function satisfiedRequests(requests, installedCss) {
+export function satisfiedRequests(requests, installedCss, 
+/**
+ * AS FOLHAS DELE - quando vêm, o nome tem de estar NELAS (rodada 11, 28/09). O css instalado mora em
+ * `_synthesisui/ds/`, que o app dele não importa: `text-display` existia no nosso `theme.css`, o pedido fechou
+ * como "delivered", e o hero dele continuou sem o tamanho.
+ */
+theirCss) {
     const declared = declaredValues(installedCss);
+    const theirs = theirCss == null ? null : declaredValues(theirCss);
     return requests.filter((r) => {
         const name = checkableName(r);
         if (!name)
             return false;
-        const present = candidatesFor(name).filter((c) => declared.has(c.toLowerCase()));
+        if (theirs && !theirs.has(`--${name}`.toLowerCase()))
+            return false;
+        const present = candidatesFor(name).filter((c) => declared.has(c.toLowerCase()) || Boolean(theirs?.has(c.toLowerCase())));
         if (present.length === 0)
             return false;
         if (!r.existed)
@@ -190,6 +199,29 @@ export function satisfiedRequests(requests, installedCss) {
         return present.some((c) => resolved(declared, declared.get(c.toLowerCase()) ?? "") === asked);
     });
 }
+/** As folhas do projeto dele - fora de `_synthesisui/`, `node_modules` e das saídas de build. Sass pela lente. */
+export async function readTheirCss(root) {
+    const { readStyleSheet } = await import("./scss-lens.js");
+    const SKIP = new Set(["node_modules", "_synthesisui", ".next", "dist", "build", "out", ".git", "coverage"]);
+    let css = "";
+    let files = 0;
+    const walk = async (dir) => {
+        for (const e of await readdir(dir, { withFileTypes: true }).catch(() => [])) {
+            if (files > 400)
+                return;
+            if (e.isDirectory()) {
+                if (!SKIP.has(e.name) && !e.name.startsWith("."))
+                    await walk(join(dir, e.name));
+            }
+            else if (/\.(css|scss|sass)$/i.test(e.name)) {
+                files += 1;
+                css += `\n${await readStyleSheet(join(dir, e.name))}`;
+            }
+        }
+    };
+    await walk(root);
+    return css;
+}
 export async function readInstalledCss(root) {
     const dsDir = join(root, "_synthesisui", "ds");
     let css = "";
@@ -231,7 +263,7 @@ export async function verifyAndCloseRequests(root) {
     const css = await readInstalledCss(root);
     if (!css)
         return [];
-    const satisfied = satisfiedRequests(requests, css);
+    const satisfied = satisfiedRequests(requests, css, await readTheirCss(root));
     for (const r of satisfied)
         await closeRequest(root, r.id);
     return satisfied;

package/dist/doctor/scan.js

@@ -9,6 +9,7 @@
  * Text in, findings out. No filesystem, no AST, no network - a diagnosis that
  * takes eight seconds and needs a build step is a diagnosis nobody runs.
  */
+import { propertyAt, roleFits } from "./their-names.js";
 import { utilitiesOn } from "./idiom-names.js";
 import { normalizeValue, tokenMatch } from "./tokens.js";
 /**
@@ -490,7 +491,8 @@ export function scanSource(file, source, table) {
     return scanCore(file, source, table);
 }
 /** `--color-ocean-500: #059aed;` - uma declaração de custom property no CSS dele. */
-const DECLARES = /^\s*(--[a-z0-9-]+)\s*:\s*([^;]+);/i;
+/** Cada declaração `--x: valor;` da linha, quantas houver - ver o laço em `scanCore`. */
+const DECLARES_ALL = /(?:^|[\s{;])(--[a-z0-9-]+)\s*:\s*([^;{}]+);/gi;
 function scanCore(file, source, table) {
     const findings = [];
     const phantoms = [];
@@ -570,8 +572,13 @@ function scanCore(file, source, table) {
          * Os dois são coletados aqui e cruzados no fim: uma variável pode ser usada num arquivo e
          * declarada em outro, então a resposta não existe enquanto a varredura não terminar.
          */
-        const declaredHere = DECLARES.exec(line);
-        if (declaredHere && !declaredHere[1].toLowerCase().startsWith("--ds-")) {
+        /**
+         * TODAS AS DECLARAÇÕES DA LINHA - `:root { --line: #dde5e8; --gap-2: 8px; }` numa linha só contava nenhuma, porque
+         * a régua lia um `--x:` por linha e no começo dela (28/09). O jeito de projeto pequeno escrever token.
+         */
+        for (const declaredHere of line.matchAll(DECLARES_ALL)) {
+            if (declaredHere[1].toLowerCase().startsWith("--ds-"))
+                continue;
             const value = declaredHere[2].trim();
             ownDeclared.push({
                 name: declaredHere[1].toLowerCase(),
@@ -683,7 +690,9 @@ function scanCore(file, source, table) {
              * A chave carrega o `kind` porque o valor sozinho não decide: `4px` é `--radius-xs` e
              * `--spacing` no vocabulário dele, e qual dos dois está certo depende de onde o literal está.
              */
-            const theirs = table.aliases.get(`${kind}:${normalizeValue(literal, table.rootPx)}`);
+            const aliased = table.aliases.get(`${kind}:${normalizeValue(literal, table.rootPx)}`);
+            /** O valor igual não basta - o papel também, ver `roleFits` (r13 e r14, 28/09). */
+            const theirs = aliased && roleFits(propertyAt(line, col), aliased.name) ? aliased : undefined;
             /** A procedência do `token`, lida da tabela que o achou - ver `tokenIsTheirs`. */
             const tableIsTheirs = table.source !== null && table.source !== "installed";
             findings.push({
@@ -868,7 +877,15 @@ function scanCore(file, source, table) {
             : null),
     };
 }
-export function diagnose(files) {
+export function diagnose(files, 
+/**
+ * AS FOLHAS QUE DECLARAM O VOCABULÁRIO DELE, quando a varredura é de um arquivo só - rodada 13, 28/09.
+ *
+ * `ownUses` só existia para o nome declarado DENTRO do que foi varrido: o `check_file` de um `.module.css`
+ * que escreve `var(--space-1)` respondia "nothing here carries a design value", com o `--space-1` declarado
+ * em `src/styles/tokens.css`. O contexto só ensina os NOMES; nada dele entra na conta.
+ */
+context = []) {
     const flat = files.flatMap((f) => f.findings.map((x) => ({ ...x, file: f.file })));
     const counts = {
         color: 0,
@@ -892,7 +909,7 @@ export function diagnose(files) {
      * `var(--algo)` que ninguém declara continua fora da conta, porque ele não pinta nada.
      */
     const ownDeclared = new Map();
-    for (const f of files)
+    for (const f of [...files, ...context])
         for (const d of f.ownDeclared ?? [])
             if (!ownDeclared.has(d.name))
                 ownDeclared.set(d.name, d.value);

package/dist/doctor/scss-lens.js

@@ -16,14 +16,112 @@
  */
 const DECL = /^\s*\$([A-Za-z_][\w-]*)\s*:\s*([^;]+?)\s*(?:!default|!global)?\s*;/;
 const USE = /\$([A-Za-z_][\w-]*)/g;
-/** As declarações do nível de fora, na ordem, sem seguir aliases. */
+/** As vírgulas do nível de fora - `rgba(14, 20, 40, 0.08)` é um valor só. */
+function splitTop(body) {
+    const out = [];
+    let depth = 0;
+    let quote = null;
+    let cur = "";
+    for (const ch of body) {
+        if (quote) {
+            if (ch === quote)
+                quote = null;
+        }
+        else if (ch === '"' || ch === "'")
+            quote = ch;
+        else if (ch === "(")
+            depth += 1;
+        else if (ch === ")")
+            depth -= 1;
+        else if (ch === "," && depth === 0) {
+            out.push(cur);
+            cur = "";
+            continue;
+        }
+        cur += ch;
+    }
+    out.push(cur);
+    return out.map((p) => p.trim()).filter(Boolean);
+}
+const unquote = (k) => k.trim().replace(/^["']|["']$/g, "");
+/** Os mapas do nível de fora, de uma ou várias linhas, com as posições no texto. */
+function topLevelMaps(scss) {
+    const out = [];
+    const HEAD = /(^|\n)[ \t]*\$([A-Za-z_][\w-]*)\s*:\s*\(/g;
+    let depthAt = 0;
+    let scanned = 0;
+    for (let m = HEAD.exec(scss); m; m = HEAD.exec(scss)) {
+        for (const ch of scss.slice(scanned, m.index)) {
+            if (ch === "{")
+                depthAt += 1;
+            else if (ch === "}")
+                depthAt = Math.max(0, depthAt - 1);
+        }
+        scanned = m.index;
+        if (depthAt > 0)
+            continue;
+        const open = m.index + m[0].length - 1;
+        let depth = 0;
+        let close = -1;
+        for (let i = open; i < scss.length; i += 1) {
+            if (scss[i] === "(")
+                depth += 1;
+            else if (scss[i] === ")") {
+                depth -= 1;
+                if (depth === 0) {
+                    close = i;
+                    break;
+                }
+            }
+        }
+        if (close < 0)
+            continue;
+        const semi = scss.indexOf(";", close);
+        if (semi < 0 || scss.slice(close + 1, semi).replace(/!default|!global/g, "").trim())
+            continue;
+        const entries = [];
+        for (const part of splitTop(scss.slice(open + 1, close))) {
+            const at = part.search(/:\s/) >= 0 ? part.search(/:\s/) : part.indexOf(":");
+            if (at <= 0)
+                continue;
+            const key = unquote(part.slice(0, at));
+            const value = part.slice(at + 1).trim();
+            /** um mapa dentro do mapa não é uma decisão de uma linha - fica de fora, como um `@mixin` */
+            if (!/^[\w-]+$/.test(key) || value.startsWith("("))
+                continue;
+            entries.push({ key, value });
+        }
+        out.push({ name: m[2], entries, from: m.index + m[1].length, to: semi + 1 });
+        HEAD.lastIndex = semi + 1;
+    }
+    return out;
+}
+/** `@function color($name) { @return map-get($semantic, $name); }` -> `color` lê o mapa `semantic`. */
+function accessors(scss) {
+    const out = new Map();
+    const FN = /@function\s+([A-Za-z_][\w-]*)\s*\(\s*\$([\w-]+)\s*\)\s*\{\s*@return\s+map-get\(\s*\$([\w-]+)\s*,\s*\$\2\s*\)\s*;?\s*\}/g;
+    for (let m = FN.exec(scss); m; m = FN.exec(scss))
+        out.set(m[1], m[3]);
+    return out;
+}
+/** `map-get($m, "k")` e `color("k")` escritos como o `var()` do nome que alcançam. */
+function readMapAccess(text, fns) {
+    let out = text.replace(/map-get\(\s*\$([\w-]+)\s*,\s*["']?([\w-]+)["']?\s*\)/g, (_w, map, key) => `var(--${map}-${key})`);
+    if (fns.size > 0)
+        out = out.replace(/(?<![\w$@-])([A-Za-z_][\w-]*)\(\s*["']?([\w-]+)["']?\s*\)/g, (whole, fn, key) => {
+            const map = fns.get(fn);
+            return map ? `var(--${map}-${key})` : whole;
+        });
+    return out;
+}
+/** As declarações do nível de fora, na ordem, sem seguir aliases - os mapas saem por `topLevelMaps`. */
 function topLevel(scss) {
     const out = [];
     let depth = 0;
     scss.split("\n").forEach((text, line) => {
         if (depth === 0) {
             const m = DECL.exec(text);
-            if (m)
+            if (m && !m[2].trim().startsWith("("))
                 out.push({ name: m[1], value: m[2].trim(), line });
         }
         for (const ch of text) {
@@ -35,38 +133,83 @@ function topLevel(scss) {
     });
     return out;
 }
-/** `$nome` -> o valor, com os aliases dele seguidos (`$accent: $teal-500` -> `#0e9f91`). */
+/** `$nome` -> o valor, com os aliases dele seguidos (`$accent: $teal-500` -> `#0e9f91`). Cada chave de mapa é `$mapa-chave`. */
 export function scssVariables(scss) {
     const raw = new Map(topLevel(scss).map((d) => [`$${d.name}`, d.value]));
+    for (const map of topLevelMaps(scss))
+        for (const { key, value } of map.entries)
+            raw.set(`$${map.name}-${key}`, value);
+    const fns = accessors(scss);
+    const toAlias = (value) => readMapAccess(value, fns).replace(/^var\(--([\w-]+)\)$/, (_w, n) => `$${n}`);
     const out = new Map();
     for (const name of raw.keys()) {
         const seen = new Set([name]);
-        let value = raw.get(name);
+        let value = toAlias(raw.get(name));
         for (let ref = /^\$([A-Za-z_][\w-]*)$/.exec(value); ref; ref = /^\$([A-Za-z_][\w-]*)$/.exec(value)) {
             const next = raw.get(`$${ref[1]}`);
             if (next === undefined || seen.has(`$${ref[1]}`))
                 break;
             seen.add(`$${ref[1]}`);
-            value = next;
+            value = toAlias(next);
         }
         out.set(name, value);
     }
     return out;
 }
+/**
+ * COMO O NOME SE ESCREVE NO SASS DELE - o caminho de volta do mapa (`scss-speech.ts`).
+ *
+ * `--semantic-brand` é `color("brand")` quando existe a função de acesso, e `map-get($semantic, "brand")`
+ * quando não; uma `$variável` simples é ela mesma.
+ */
+export function scssSpeech(scss) {
+    const out = new Map();
+    for (const d of topLevel(scss))
+        out.set(d.name, `$${d.name}`);
+    const byMap = new Map();
+    for (const [fn, map] of accessors(scss))
+        if (!byMap.has(map))
+            byMap.set(map, fn);
+    for (const map of topLevelMaps(scss))
+        for (const { key } of map.entries) {
+            const fn = byMap.get(map.name);
+            const k = /^\d+$/.test(key) ? key : `"${key}"`;
+            out.set(`${map.name}-${key}`, fn ? `${fn}(${k})` : `map-get($${map.name}, ${k})`);
+        }
+    return out;
+}
 /** A folha como o leitor de CSS a entende - ver o cabeçalho. Sem `$`, ela volta byte a byte. */
-export function scssAsCustomProperties(scss) {
-    if (!scss.includes("$"))
+export function scssAsCustomProperties(scss, context = "") {
+    if (!scss.includes("$") && !context && !/(^|[ \t])\/\//.test(scss))
         return scss;
-    const decls = new Map(topLevel(scss).map((d) => [d.line, d]));
-    return scss
+    const fns = new Map([...accessors(context), ...accessors(scss)]);
+    /**
+     * O `//` DO SASS SAI - para o leitor de CSS ele não é comentário, e `// Beacon - design tokens` na linha
+     * de cima virava parte do seletor do bloco seguinte, que era descartado inteiro (o `$palette` do r14, 28/09).
+     * Só fora de string e com espaço ou começo de linha antes: `url(https://...)` fica.
+     */
+    let text = scss.replace(/(^|[ \t])\/\/[^\n]*/g, (whole, lead, at) => {
+        const before = scss.slice(scss.lastIndexOf("\n", at) + 1, at);
+        return (before.match(/["']/g)?.length ?? 0) % 2 === 1 ? whole : lead;
+    });
+    for (const map of topLevelMaps(text).reverse()) {
+        const block = map.entries
+            .map(({ key, value }) => `--${map.name}-${key}: ${readMapAccess(value, fns).replace(USE, "var(--$1)")};`)
+            .join(" ");
+        text = `${text.slice(0, map.from)}:root { ${block} }${text.slice(map.to)}`;
+    }
+    const decls = new Map(topLevel(text).map((d) => [d.line, d]));
+    return text
         .split("\n")
-        .map((text, line) => {
-        const d = decls.get(line);
+        .map((line, i) => {
+        const d = decls.get(i);
         if (d)
-            return `:root { --${d.name}: ${d.value.replace(USE, "var(--$1)")}; }`;
-        if (/^\s*@(use|forward|import)\b/.test(text))
-            return text;
-        return text.replace(USE, "var(--$1)");
+            return `:root { --${d.name}: ${readMapAccess(d.value, fns).replace(USE, "var(--$1)")}; }`;
+        if (/^\s*@(use|forward|import)\b/.test(line))
+            return line;
+        if (/^\s*:root \{ --/.test(line))
+            return line;
+        return readMapAccess(line, fns).replace(USE, "var(--$1)");
     })
         .join("\n");
 }
@@ -78,5 +221,32 @@ export function scssAsCustomProperties(scss) {
 export async function readStyleSheet(file) {
     const { readFile } = await import("node:fs/promises");
     const text = await readFile(file, "utf8").catch(() => "");
-    return /\.(scss|sass)$/i.test(file) ? scssAsCustomProperties(text) : text;
+    if (!/\.(scss|sass)$/i.test(file))
+        return text;
+    return scssAsCustomProperties(text, await usedSheets(file, text));
+}
+/**
+ * AS FOLHAS QUE ELA `@use`/`@import` - é lá que moram as funções de acesso (`color()`, `space()`). Sem elas,
+ * `background: color("brand")` no `globals.scss` não seria lido como o `--semantic-brand` que é.
+ */
+async function usedSheets(file, text) {
+    const { readFile } = await import("node:fs/promises");
+    const { dirname, join } = await import("node:path");
+    const out = [];
+    for (const m of text.matchAll(/^\s*@(?:use|import|forward)\s+["']([^"']+)["']/gm)) {
+        const spec = m[1];
+        if (/^(sass:|https?:)/.test(spec))
+            continue;
+        const base = join(dirname(file), spec);
+        const dir = dirname(base);
+        const name = base.slice(dir.length + 1).replace(/\.(scss|sass)$/i, "");
+        for (const candidate of [`${name}.scss`, `_${name}.scss`, `${name}.sass`, `_${name}.sass`]) {
+            const got = await readFile(join(dir, candidate), "utf8").catch(() => null);
+            if (got != null) {
+                out.push(got);
+                break;
+            }
+        }
+    }
+    return out.join("\n");
 }

package/dist/doctor/their-names.js

@@ -258,3 +258,34 @@ export function theirNames(ours, theirs) {
 export function withTheirNames(ours, theirs) {
     return { ...ours, aliases: theirNames(ours, theirs) };
 }
+/**
+ * O PAPEL DO NOME CABE NA PROPRIEDADE? - rodadas 13 e 14 do refinamento, 28/09.
+ *
+ * O valor igual não basta: `#fff` no texto do botão de perigo não é `--color-surface` (no escuro ela vira o fundo
+ * escuro e o texto some), e `1rem` num `line-height` não é o tamanho de fonte `md`. A régua lê só o que o nome DIZ -
+ * uma palavra de fundo, de texto ou de tamanho de fonte -, e um nome que não diz nada disso continua valendo.
+ */
+const BACKGROUND_WORD = /(^|[-_$])(bg|background|surface|canvas|page|paper|base)([-_]|$)/i;
+const TEXT_WORD = /(^|[-_$])(text|ink|fg|foreground)([-_]|$)|(^|[-_$])on-/i;
+const FONT_SIZE_WORD = /(^|[-_$])(text-size|font-size|type-scale|fontsize)([-_(]|$)/i;
+export function roleFits(property, name) {
+    if (!property)
+        return true;
+    const p = property.trim().toLowerCase();
+    const n = name.replace(/^--/, "").replace(/^(colou?r[-_])/i, "");
+    if (p === "color" || p === "fill" || p === "stroke" || p === "caret-color")
+        return !BACKGROUND_WORD.test(n) || TEXT_WORD.test(n);
+    if (p === "background" || p === "background-color")
+        return !TEXT_WORD.test(n) || BACKGROUND_WORD.test(n);
+    if (FONT_SIZE_WORD.test(name))
+        return p === "font-size" || p === "font";
+    return true;
+}
+/** A propriedade que governa a posição `col` de uma linha de CSS ou de um objeto `style` - `null` quando não há. */
+export function propertyAt(line, col) {
+    const before = col >= 0 ? line.slice(0, col) : line;
+    const m = /([A-Za-z-]+)["']?\s*:\s*[^:;{}]*$/.exec(before);
+    if (!m)
+        return null;
+    return m[1].replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`);
+}

package/dist/fonts.js

@@ -54,7 +54,11 @@ export function customFontFamilies(families) {
     const names = [];
     for (const slot of familySlots(families)) {
         const name = firstFamily(families[slot] ?? "");
-        if (!name)
+        /**
+         * UMA VARIÁVEL NÃO É FAMÍLIA - `var(--font-geist-sans)` é o next/font dele já carregando a fonte, e saía como
+         * `family=var(--font-geist-sans)` na URL do Google Fonts (rodada 12, 28/09).
+         */
+        if (!name || /^var\(|^--/.test(name.trim()))
             continue;
         const key = name.toLowerCase();
         if (GENERIC_FAMILIES.has(key) || seen.has(key))

package/dist/install-marks.js

@@ -289,7 +289,13 @@
  * Na mesma versão, o componente sai na FORMA do projeto dele: `.module.(s)css` com `styles.root` onde ele usa
  * CSS Modules, a classe sem o nosso `ds-` onde ele usa folha global (a linha do dono, 28/09 00:49).
  */
-export const MATERIALISER_SINCE = "0.16.469";
+/**
+ * 0.16.469 -> 0.16.471 em 28/09, e o passo 1 dá **SIM**: num projeto Sass com BEM aninhado (`&--x`, `&__x`) o
+ * componente sai em BEM, e não em classes do Tailwind que ali não pintam nada; e a chave de um mapa do Sass volta
+ * escrita como a função dele (`color("brand")`), nunca `$semantic-brand` (rodada 14 do refinamento). Um
+ * componente escrito antes num projeto desses está sem estilo.
+ */
+export const MATERIALISER_SINCE = "0.16.471";
 /**
  * A ÚLTIMA VERSÃO EM QUE O QUE O HOOK RODA MUDOU.
  *
@@ -456,7 +462,12 @@ export const COUNTED_DIFFERENTLY = "this run counts a value as named only when Y
  * arquivos do turno, e não só os três que relata - rodada 5: o leigo-5 escreveu sete e o painel recebeu
  * três. Um hook anterior segue mandando ao painel um turno pela metade.
  */
-export const CHECKER_SINCE = "0.16.467";
+/**
+ * 0.16.467 -> 0.16.471 em 28/09, e o passo 1 dá **SIM**: a lente do Sass que o fim do turno usa lê os mapas
+ * (`$palette`, `color("brand")`) - rodada 14 do refinamento. Um hook anterior acusa como valor à mão toda cor
+ * que o projeto guarda num mapa.
+ */
+export const CHECKER_SINCE = "0.16.471";
 /**
  * A ÚLTIMA VERSÃO EM QUE OS LEITORES PASSARAM A PRODUZIR UM CENSO DIFERENTE.
  *
@@ -915,7 +926,13 @@ export const CHECKER_SINCE = "0.16.467";
  * em TypeScript como o vocabulário dele, e a classe escolhida em tempo de execução pela união que tipa a prop
  * (rodadas 7 a 10 do refinamento). Um censo lido antes guardou `declared: {}` para esses projetos.
  */
-export const READER_SINCE = "0.16.469";
+/**
+ * 0.16.469 -> 0.16.471 em 28/09, e o passo 1 dá **SIM** (rodadas 11 a 14 do refinamento): o censo lê os mapas do
+ * Sass (0 -> 18 cores no r14), o BEM aninhado como BEM, tira da organização o arquivo de rota (`page`, `layout`), e
+ * não põe no sistema a peça do framework (`StrictMode`, `next/link`) nem a raiz do Vite (`src/App.tsx`); e o que
+ * mora na pasta compartilhada de componentes nunca vira "feature". Um censo lido antes guardou tudo isso errado.
+ */
+export const READER_SINCE = "0.16.471";
 /**
  * O QUE ESTÁ INSTALADO AQUI FICOU PARA TRÁS - e as DUAS condições que fazem isso ser verdade.
  *

package/dist/scss-speech.js

@@ -1,6 +1,7 @@
 import { readdir, readFile } from "node:fs/promises";
 import { join, relative } from "node:path";
-import { scssVariables } from "./doctor/scss-lens.js";
+import { scssSpeech, scssVariables } from "./doctor/scss-lens.js";
+import { roleFits } from "./doctor/their-names.js";
 const SKIP = new Set(["node_modules", ".next", "dist", "build", "out", "_synthesisui", "coverage"]);
 /** O vocabulário SCSS do projeto: a folha que declara mais `$variáveis` no nível de fora. */
 export async function scssVocabularyOf(root) {
@@ -13,9 +14,10 @@ export async function scssVocabularyOf(root) {
             if (entry.isDirectory())
                 await walk(path);
             else if (/\.(scss|sass)$/i.test(entry.name) && !/\.module\./i.test(entry.name)) {
-                const vars = scssVariables(await readFile(path, "utf8").catch(() => ""));
+                const text = await readFile(path, "utf8").catch(() => "");
+                const vars = scssVariables(text);
                 if (vars.size > (best?.vars.size ?? 0))
-                    best = { vars, tokensFile: relative(root, path).split("\\").join("/") };
+                    best = { vars, speak: scssSpeech(text), tokensFile: relative(root, path).split("\\").join("/") };
             }
         }
     };
@@ -31,10 +33,12 @@ function usePath(tokensFile, compDir) {
 export function inScssSpeech(files, vocab, compDir) {
     if (!vocab || vocab.vars.size === 0)
         return files;
+    /** Como cada nome se escreve - `$nome`, ou a chamada que alcança a chave do mapa. */
+    const said = (name) => vocab.speak?.get(name.replace(/^\$/, "")) ?? name;
     const byValue = new Map();
     for (const [name, value] of vocab.vars) {
         const k = value.trim().toLowerCase();
-        byValue.set(k, [...(byValue.get(k) ?? []), name]);
+        byValue.set(k, [...(byValue.get(k) ?? []), said(name)]);
     }
     const renamed = new Map();
     const out = files.map((f) => {
@@ -43,10 +47,11 @@ export function inScssSpeech(files, vocab, compDir) {
         const filename = f.filename.replace(/\.css$/, ".scss");
         renamed.set(f.filename, filename);
         const body = f.content
-            .replace(/var\(\s*--([A-Za-z_][\w-]*)\s*\)/g, (whole, n) => vocab.vars.has(`$${n}`) ? `$${n}` : whole)
-            .replace(/:\s*([^;{}]+?)\s*;/g, (whole, value) => {
-            const hits = byValue.get(value.trim().toLowerCase());
-            return hits && hits.length === 1 ? `: ${hits[0]};` : whole;
+            .replace(/var\(\s*--([A-Za-z_][\w-]*)\s*\)/g, (whole, n) => vocab.vars.has(`$${n}`) ? said(`$${n}`) : whole)
+            .replace(/([\w-]+)(\s*):\s*([^;{}]+?)\s*;/g, (whole, prop, gap, value) => {
+            /** O valor igual e o papel também - `line-height: 1rem` não é o tamanho de fonte `md` (r14, 28/09). */
+            const hits = byValue.get(value.trim().toLowerCase())?.filter((h) => roleFits(prop, h));
+            return hits && hits.length === 1 ? `${prop}${gap}: ${hits[0]};` : whole;
         });
         return { ...f, filename, content: `@use "${usePath(vocab.tokensFile, compDir)}" as *;\n\n${body}` };
     });

package/dist/what-grew.js

@@ -0,0 +1,58 @@
+import { readFile } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { loadSystem, walkAll } from "./commands/doctor.js";
+import { diagnose, scanSource } from "./doctor/scan.js";
+export async function whatGrew(root, census, 
+/** As leituras do último envio (`SyncMark.readings`) - `null` quando nunca houve um, e aí nada "nasceu". */
+before) {
+    if (!before)
+        return { born: [], gone: [] };
+    const now = (census.components ?? []).filter((c) => typeof c.name === "string");
+    const names = new Set(now.map((c) => c.name));
+    const gone = Object.keys(before).filter((n) => !names.has(n));
+    const fresh = now.filter((c) => !(c.name in before) && typeof c.api?.file === "string");
+    if (fresh.length === 0)
+        return { born: [], gone };
+    const { table } = await loadSystem(root).catch(() => ({ table: null }));
+    const context = [];
+    if (table) {
+        for await (const file of walkAll([root])) {
+            const rel = relative(root, file);
+            if (!/\.(css|scss|sass|less)$/i.test(rel))
+                continue;
+            const src = await readFile(file, "utf8").catch(() => "");
+            const report = src ? scanSource(rel, src, table) : null;
+            if (report?.ownDeclared?.length)
+                context.push(report);
+        }
+    }
+    const born = [];
+    for (const c of fresh) {
+        const file = c.api?.file;
+        const src = table ? await readFile(join(root, file), "utf8").catch(() => null) : null;
+        if (src == null || !table) {
+            born.push({ name: c.name, file, fromSystem: 0, of: 0, byHand: [] });
+            continue;
+        }
+        const d = diagnose([scanSource(file, src, table)], context);
+        born.push({
+            name: c.name,
+            file,
+            fromSystem: d.reach.measured ? d.reach.uses : 0,
+            of: d.reach.measured ? d.reach.of : 0,
+            byHand: [...new Set(d.findings.map((f) => f.literal))],
+        });
+    }
+    return { born, gone };
+}
+/** As linhas do bloco, ou nada. Uma por componente: o nome, o arquivo, a medida e o que ficou à mão. */
+export function describeGrowth(grown) {
+    const out = [];
+    for (const b of grown.born)
+        out.push(b.of === 0
+            ? `${b.name} (${b.file}) - no colour or spacing of its own to measure`
+            : `${b.name} (${b.file}) - ${b.fromSystem} of ${b.of} values from your system${b.byHand.length > 0 ? `; by hand: ${b.byHand.slice(0, 4).join(", ")}${b.byHand.length > 4 ? ", …" : ""}` : ""}`);
+    for (const g of grown.gone)
+        out.push(`${g} is no longer in your code - it leaves the draft with this send`);
+    return out;
+}

package/dist/written.js

@@ -43,7 +43,12 @@ export async function recordWritten(slugDir, entry, files) {
  * do mesmo jeito. Devolve vazio quando nada divergiu (nosso para regenerar) e `null` quando não
  * há fingerprint gravado (install legado - o chamador mantém o comportamento de sempre).
  */
-export async function editedSinceWritten(recorded, dir) {
+export async function editedSinceWritten(recorded, dir, 
+/**
+ * O ARQUIVO QUE SUMIU CONTA COMO EDIÇÃO? Sim por padrão - no `upgrade` ninguém pediu o arquivo de volta. Não no
+ * `component`, que é ele PEDINDO o componente: lá "kept YOUR file(s)" sobre um arquivo apagado era falso (r14, 28/09).
+ */
+opts = {}) {
     if (!recorded)
         return null;
     const edited = [];
@@ -54,7 +59,8 @@ export async function editedSinceWritten(recorded, dir) {
                 edited.push(filename);
         }
         catch {
-            edited.push(filename);
+            if (opts.missingIsEdit !== false)
+                edited.push(filename);
         }
     }
     return edited;

package/package.json

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