synthesisui 0.16.421 → 0.16.422

package/dist/sheet-needed.js

@@ -1,317 +0,0 @@
-import { readFile } from "node:fs/promises";
-import { join } from "node:path";
-import { TAILWIND_THEME_VARS } from "./tailwind-theme-vars.js";
-/**
- * AS CLASSES QUE A FOLHA COMPILADA DECLARA COMO RECEITA - o nome, não o prefixo.
- *
- * A convenção viaja com o sistema (`ds-`, `sui-`, o que o projeto dele usa), então perguntar pelo
- * prefixo seria fixar a forma de um repositório. O que é estrutural é onde a regra MORA: o
- * compilador emite uma regra por receita dentro de `@layer components`, e é só essa camada que a
- * folha traz e o projeto dele não tem.
- *
- * A PRIMEIRA VERSÃO VARRIA O TEXTO INTEIRO, e a revisão do fecho mediu o preço na folha viva do
- * `codelevel` (143.409 bytes, versão instalada): **147 nomes extraídos, 3 deles não são receita** -
- * `dark`, que é a classe DELE em `@layer base`; `layer-3d`, um utilitário DELE espelhado em
- * `@layer utilities`; e `background`, que aparecia como VALOR de uma declaração e nem seletor era.
- * Rodada sobre o repositório dele, a função devolvia `["layer-3d", "dark"]` - duas classes DELE
- * sustentando a cobrança da NOSSA folha. É o defeito de 07/09 voltando pela porta do balde novo, e
- * o oposto exato do que esta medição existe para permitir.
- *
- * O ESCAPE CONTA como parte do nome, porque no CSS ele é como se escreve um caractere que o
- * seletor não aceita cru: `.ds-w-\[10px\]` é a classe `ds-w-[10px]`, e `.sm\:ds-hero` é a variante
- * `sm:` da classe `ds-hero` - que é como o código dele a escreve. Truncar no `\` produziria os
- * nomes `ds-w-` e `sm`, que ninguém escreve: uma dependência real deixaria de ser contada, e esse é
- * o único lado do erro que o cabeçalho deste módulo declara inaceitável.
- */
-export function classesTheSheetDeclares(css) {
-    const out = new Set();
-    for (const body of layerBodies(css, "components"))
-        for (const prelude of selectorPreludes(body))
-            for (const m of prelude.matchAll(/\.((?:\\.|[\w-])+)/g)) {
-                const bare = m[1].replace(/\\(.)/g, "$1");
-                /** A MESMA normalização que `classesIn` aplica ao que ele ESCREVE - `sm:ds-hero` é `ds-hero`. */
-                out.add((bare.split(":").pop() ?? bare).replace(/^[!-]/, ""));
-            }
-    return [...out];
-}
-/** O corpo de cada `@layer <nome> { … }`, com as chaves de dentro contadas. */
-function layerBodies(css, name) {
-    const out = [];
-    for (const m of css.matchAll(new RegExp(`@layer\\s+${name}\\s*\\{`, "g"))) {
-        let depth = 1;
-        let i = (m.index ?? 0) + m[0].length;
-        const start = i;
-        for (; i < css.length && depth > 0; i += 1) {
-            const c = css[i];
-            if (c === "{")
-                depth += 1;
-            else if (c === "}")
-                depth -= 1;
-        }
-        out.push(css.slice(start, i - 1));
-    }
-    return out;
-}
-/**
- * O PRELÚDIO DE CADA REGRA - o texto entre o fim da regra anterior e a `{` desta.
- *
- * É o que separa um SELETOR de um valor de declaração: `background: p.background` mora depois da
- * `{`, e nunca chega aqui. Um prelúdio que começa com `@` é uma regra de agrupamento (`@media`,
- * `@supports`) e não declara classe nenhuma - o corpo dela é varrido pela mesma volta do laço.
- */
-function selectorPreludes(body) {
-    const out = [];
-    const parts = body.split("{");
-    for (const part of parts.slice(0, -1)) {
-        const tail = part.slice(part.lastIndexOf("}") + 1).trim();
-        if (tail && !tail.startsWith("@"))
-            out.push(tail);
-    }
-    return out;
-}
-/** `--animate-shimmer` no `@theme` -> o nome `shimmer`, que é o que uma classe carrega. */
-function themeNames(themeCss) {
-    const out = new Set();
-    for (const block of themeCss.matchAll(/@theme[^{]*\{([\s\S]*?)\n\}/g))
-        for (const m of block[1].matchAll(/^\s*--([a-z]+)-([a-zA-Z0-9_-]+)\s*:/gm))
-            out.add(m[2]);
-    return [...out];
-}
-/**
- * O VALOR DE UM ATRIBUTO DE CLASSE, QUANDO ELE É UMA EXPRESSÃO - e a regra é o ATRIBUTO, não a
- * função.
- *
- * O DEFEITO, medido em 08/09 nas duas árvores do `frontend-hub`: o leitor via `className="…"` e o
- * template direto, e não via `className={cn("…")}`.
- *
- * ```
- *                            packages/ui/src   apps/web-dashboard
- * className=" literal              346              2639
- * className={cn( ou {clsx(          66               239     <- invisíveis
- * ```
- *
- * São **305 sítios** onde o projeto dele escreve classe e a pergunta *"algo aqui precisa da nossa
- * folha?"* era respondida sobre um texto que não continha a resposta. E o erro caía para o lado
- * ERRADO: o cabeçalho deste módulo declara que *"o lado seguro do erro é PRECISA"*, porque um falso
- * positivo mantém o setup sendo pedido e um falso NEGATIVO entrega um componente sem a animação que
- * ele veste. `cn()` é o idioma de quem parte do shadcn, então a metade que faltava era a maior parte
- * de quem chega.
- *
- * POR QUE A REGRA NÃO É O NOME DA FUNÇÃO. Casar `cn|clsx|twMerge` seria a lista dos casos de hoje: o
- * próximo cliente chama a dele de `classes`, `cx` ou nada - passa um ternário direto. O que é
- * estrutural é o ATRIBUTO: dentro do valor de um `class`/`className`, toda string literal é
- * candidata a classe, seja ela argumento de função, ramo de ternário ou pedaço de template.
- *
- * O QUE ISTO NÃO ALCANÇA, e está declarado com o número: a tabela de variantes que mora numa const
- * separada - `cva(...)` e `tv(...)`, medidos em 08/09 como **4 + 41 e 0 + 85** nas duas árvores. Ali
- * as classes chegam ao atributo por VARIÁVEL, e cobri-las exige seguir a variável até a declaração:
- * é outra frente, e o erro dela continua caindo para o lado de cobrar.
- */
-function attributeExpressions(source) {
-    const out = [];
-    const ATTR = /class(?:Name)?=\{/g;
-    for (const m of source.matchAll(ATTR)) {
-        let depth = 0;
-        let i = (m.index ?? 0) + m[0].length - 1;
-        const start = i;
-        /** Aspas contam para NÃO deixar uma chave dentro de string fechar a expressão cedo. */
-        let quote = null;
-        for (; i < source.length; i += 1) {
-            const c = source[i];
-            if (quote) {
-                if (c === "\\")
-                    i += 1;
-                else if (c === quote)
-                    quote = null;
-                continue;
-            }
-            if (c === '"' || c === "'" || c === "`")
-                quote = c;
-            else if (c === "{")
-                depth += 1;
-            else if (c === "}") {
-                depth -= 1;
-                if (depth === 0)
-                    break;
-            }
-        }
-        if (depth === 0)
-            out.push(source.slice(start + 1, i));
-    }
-    return out;
-}
-/**
- * A DECLARAÇÃO DE UMA CONST QUE O ATRIBUTO USA - o salto que faltava, e a mesma regra do atributo.
- *
- * O QUE FICAVA DE FORA, e estava declarado no contrato com o número: a tabela de variantes mora
- * numa const separada e chega ao atributo por VARIÁVEL. O caso real, medido no `frontend-hub`:
- *
- * ```
- * const buttonVariants = cva("… rounded-[var(--radius-md)] …", { variants: { … } });
- * …
- * className={twUtils.cn(buttonVariants({ variant, size, className }))}
- * ```
- *
- * As classes estão na declaração, não no atributo - então o leitor de 08/09, que já colhia toda
- * string DENTRO da expressão, via `buttonVariants(...)` e não via nenhuma classe. Medido nas duas
- * árvores: **4 + 41** declarações `cva(` e **0 + 85** `tv(`.
- *
- * A REGRA CONTINUA SENDO A MESMA, um salto adiante: o atributo diz quais identificadores importam,
- * e a declaração daqueles identificadores é lida no mesmo arquivo. Nada aqui conhece `cva`, `tv` ou
- * `cn` - o próximo cliente escreve a tabela dele num objeto pelado, e cai na mesma regra.
- *
- * E O ERRO CONTINUA CAINDO PARA O LADO SEGURO: uma const que não é classe - um rótulo, uma
- * mensagem - entrega palavras que o `@theme` não declara, então elas somem na peneira final. O
- * cabeçalho deste módulo diz que entre errar cobrando e errar calando, cobrar é o erro que a pessoa
- * percebe.
- */
-function declarationsBehind(source, exprs) {
-    /**
-     * TODO IDENTIFICADOR DA EXPRESSÃO, e não só os que ela CHAMA.
-     *
-     * A primeira versão pegava `nome(`, e o objeto pelado - `pick(byTone, tone)` - passa a tabela
-     * como ARGUMENTO. O que decide é o atributo mencionar o identificador; se ele é chamado ou
-     * passado é sintaxe, e sintaxe é o que muda de projeto para projeto.
-     */
-    const names = new Set();
-    for (const expr of exprs)
-        for (const m of expr.matchAll(/\b([A-Za-z_$][\w$]*)\b/g))
-            names.add(m[1]);
-    if (names.size === 0)
-        return [];
-    const out = [];
-    for (const name of names) {
-        /** `const <nome> = ` - e o valor vai até a linha que fecha no MESMO nível de indentação. */
-        const at = source.search(new RegExp(`\\b(?:const|let|var)\\s+${name}\\s*=`));
-        if (at < 0)
-            continue;
-        let depth = 0;
-        let i = source.indexOf("=", at);
-        let quote = null;
-        let started = false;
-        for (; i < source.length; i += 1) {
-            const c = source[i];
-            if (quote) {
-                if (c === "\\")
-                    i += 1;
-                else if (c === quote)
-                    quote = null;
-                continue;
-            }
-            if (c === '"' || c === "'" || c === "`")
-                quote = c;
-            else if (c === "(" || c === "{" || c === "[") {
-                depth += 1;
-                started = true;
-            }
-            else if (c === ")" || c === "}" || c === "]") {
-                depth -= 1;
-                if (started && depth <= 0)
-                    break;
-            }
-            else if (c === ";" && !started)
-                break;
-        }
-        out.push(source.slice(at, i + 1));
-    }
-    return out;
-}
-/** As classes escritas no código - `hover:animate-shimmer` conta como `animate-shimmer`. */
-function classesIn(source) {
-    const out = new Set();
-    const collect = (body) => {
-        for (const raw of body.split(/\s+/)) {
-            if (!raw)
-                continue;
-            const bare = raw.split(":").pop() ?? raw;
-            out.add(bare.replace(/^[!-]/, ""));
-        }
-    };
-    for (const m of source.matchAll(/class(?:Name)?=(?:"([^"]*)"|'([^']*)'|\{`([^`]*)`\}|\{"([^"]*)"\})/g))
-        collect(m[1] ?? m[2] ?? m[3] ?? m[4] ?? "");
-    /**
-     * E TODA STRING DENTRO DA EXPRESSÃO - ver `attributeExpressions`. As três formas de escrever uma
-     * string em JS/TS, porque quem escolhe a aspa é o formatador dele, não a gente.
-     */
-    const exprs = attributeExpressions(source);
-    const strings = (text) => {
-        for (const lit of text.matchAll(/"([^"]*)"|'([^']*)'|`([^`]*)`/g))
-            collect(lit[1] ?? lit[2] ?? lit[3] ?? "");
-    };
-    for (const expr of exprs)
-        strings(expr);
-    /** E a declaração de quem o atributo chama - ver `declarationsBehind`. */
-    for (const decl of declarationsBehind(source, exprs))
-        strings(decl);
-    return out;
-}
-/**
- * O QUE, NESTE TEXTO, SÓ A FOLHA RESOLVE.
- *
- * Puro de propósito: quem varre o disco é quem chama, e um spec precisa poder afirmar a regra sem
- * um diretório temporário.
- */
-export function whatOnlyTheSheetResolves(input) {
-    const variables = [
-        ...new Set([...input.source.matchAll(/var\(\s*(--ds-[a-zA-Z0-9_-]+)/g)].map((m) => m[1])),
-    ];
-    /**
-     * `--animate-shimmer` declarado por ele -> o nome `shimmer` sai da conta.
-     *
-     * E O QUE O PRÓPRIO TAILWIND DECLARA sai junto, pela mesma razão e pela lista que já existe:
-     * `animate-pulse` existe em qualquer projeto que importe o Tailwind, e acusá-la de exigir a nossa
-     * folha é o mesmo aviso falso que `TAILWIND_THEME_VARS` foi escrito para acabar. Medido no
-     * `codelevel` (07/09): sem esta linha, `animate-pulse` era a ÚNICA coisa sustentando a cobrança
-     * do import naquele repositório.
-     */
-    const theirs = new Set();
-    for (const name of [...TAILWIND_THEME_VARS, ...(input.theirNames ?? [])]) {
-        const m = /^--[a-z]+-(.+)$/.exec(name.toLowerCase());
-        if (m)
-            theirs.add(m[1]);
-    }
-    const names = themeNames(input.themeCss).filter((n) => !theirs.has(n));
-    const written = classesIn(input.source);
-    const classes = [
-        ...new Set([...written].filter((c) => names.some((n) => c === n || c.endsWith(`-${n}`)))),
-    ];
-    /** As classes que a folha declara e que ESTE texto veste - ver `recipeClasses`. */
-    const declared = new Set(classesTheSheetDeclares(input.sheetCss));
-    const recipeClasses = [
-        ...new Set([...written].filter((c) => declared.has(c))),
-    ];
-    return {
-        variables,
-        classes,
-        recipeClasses,
-        needed: variables.length > 0 || classes.length > 0 || recipeClasses.length > 0,
-    };
-}
-/** A folha compilada da versão instalada - as receitas moram nela, não no `theme.css`. */
-export async function installedTokensCss(root, slug) {
-    return installedSheet(root, slug, "tokens.css");
-}
-/** O `theme.css` da versão instalada - a folha da raiz é um re-export de uma linha. */
-export async function installedThemeCss(root, slug) {
-    return installedSheet(root, slug, "theme.css");
-}
-/**
- * UM ARQUIVO DA VERSÃO PINADA - o `.lock` diz qual é, e a folha da raiz é um re-export de uma linha.
- *
- * Uma leitura só para as duas folhas: duas cópias da mesma decisão de versão é a forma de uma delas
- * ficar atrás no dia em que o formato do `.lock` mudar.
- */
-async function installedSheet(root, slug, filename) {
-    const dir = join(root, "_synthesisui", "ds", slug);
-    const lock = await readFile(join(dir, ".lock"), "utf8").catch(() => null);
-    let version = 0;
-    if (lock) {
-        try {
-            version = JSON.parse(lock).version ?? 0;
-        }
-        catch {
-            version = 0;
-        }
-    }
-    return readFile(join(dir, `v${version}`, filename), "utf8").catch(() => "");
-}

package/dist/skill-configure.js

@@ -1,13 +0,0 @@
-/**
- * O STUB DA SKILL - o corpo é SERVIDO, não embarcado (R1, dono 16/08).
- *
- * Mesma doutrina das outras quatro: o frontmatter fica inteiro aqui, porque é a `description` que
- * faz a skill ser invocada e ela não é segredo; a esteira mora em `apps/web/src/lib/ds/playbooks.ts`
- * e chega pelo catalogue autenticado.
- *
- * O QUE ELA RESOLVE: um sistema instalado e sincronizado pode não mudar um pixel na tela dele. Até
- * uma folha de estilo importar os tokens e um elemento carregar `data-ds`, nada chega ao navegador -
- * e essa era a única parte da instalação que ninguém escrevia, só imprimia.
- */
-export const CONFIGURE_SKILL_PATH = ".claude/skills/sui-configure-ds/SKILL.md";
-export const CONFIGURE_SKILL = '---\nname: sui-configure-ds\ndescription: Set up an installed design system in the app so its tokens actually reach the browser - the stylesheet import, the data-ds scope, and the type. Use when a system is installed and the app does not look themed, when `doctor` reports "installed - but this project does not load it yet", or when somebody asks to set up / connect / configure the design system in their app ("configura o design system aqui", "why aren\'t the tokens working", "/sui-configure-ds"). Asks the doctor first and does nothing when the three checks already pass.\n---\n\n# Setting the system up in the app - served live\n\nThis playbook is served from the platform, not shipped in this file - it is\nalways current, and your context only carries the step you are on.\n\n1. Call the `playbook` tool on the `synthesisui` MCP server with\n   { "skill": "configure" } - you get the framing and a table of contents.\n2. Fetch ONLY the chapter for the step you are on:\n   { "skill": "configure", "section": "<id from the toc>" }. Never fetch more\n   than the current step needs.\n3. Follow it exactly. When the step is done, fetch the next chapter.\n\nStart by running `npx synthesisui doctor`: the three lines it prints are what\ndecide the work, and three ticks means there is nothing to do.\n\nIf the tool answers that you are not signed in, run `npx synthesisui login`\nin the terminal and call it again. If the `synthesisui` MCP server is not\navailable at all, run `npx synthesisui connect`, restart the session, and\ninvoke this skill again.\n';

package/dist/wiring-read.js

@@ -1,212 +0,0 @@
-import { readFile } from "node:fs/promises";
-import { join } from "node:path";
-import { walk } from "./commands/doctor.js";
-import { FAMILY_SEAM_PREFIX } from "./fonts.js";
-import { detectAppDirs, sheetChainOf } from "./global-sheet.js";
-/**
- * A FIAÇÃO DESTE PROJETO, MEDIDA - e a mesma medição para todos os comandos que a citam.
- *
- * O QUE O CLIENTE VIA (medido em 08/09, nos dois apps do ato 2B): ele colou os dois `@import` no
- * `globals.css`, pôs `data-ds="codelevel"` no `<body>`, mapeou as quatro famílias - e o
- * `component` terminou imprimindo **One-time setup**, com os passos 1 e 2 para colar de novo. O
- * comando media "este arquivo PRECISA da folha?" (`sheet-needed.ts`) e nunca "a folha JÁ está
- * aqui?".
- *
- * As duas perguntas são diferentes e as duas importam: a primeira decide se o setup é necessário, e
- * a segunda decide se ele ainda está PENDENTE. Cobrar o que já foi feito gasta a confiança de quem
- * fez - ele fica sem saber se errou algo, e o texto que deveria orientar passa a ser ruído.
- *
- * POR QUE ESTE MÓDULO EXISTE, em vez de o `component` medir por conta: esta leitura já existia
- * dentro do `doctor`, com o histórico inteiro dela. Uma segunda medição da mesma coisa é uma
- * segunda medição livre de discordar da primeira - dois comandos dizendo coisas opostas sobre o
- * mesmo repositório é exatamente o defeito que este PR conserta.
- */
-/**
- * Wiring is a property of the PROJECT, never of the scope being read.
- *
- * This ran inside the scoped walk, so `doctor app/login` read only that folder
- * - and the import lives in `app/globals.css`. It concluded "installed, but not
- * wired up yet" about a project that was perfectly wired (my-test4, 27/07).
- *
- * Which would be a mild annoyance, except the managed block now tells the agent
- * to run `doctor <the file you just wrote>` after every edit. The false alarm
- * fires on every loop, and an agent that believes the system is unwired starts
- * repairing wiring that was already correct - editing the one file we most need
- * it to leave alone.
- *
- * The system itself was always resolved from the root. So is this now.
- */
-/**
- * O QUE NOS ESCREVEMOS NAO E' FIACAO DELE - e isto era um FALSO SILENCIO, o pior dos dois.
- *
- * MEDIDO EM 10/09: o cabecalho que `component-codegen.ts` poe em todo `.tsx` materializado diz,
- * em comentario, *"Global setup (once per app): import _synthesisui/ds/<slug>/tokens.css"* e
- * *"put data-ds=<slug> on a root element"*. A varredura abaixo procura exatamente essas duas
- * strings em QUALQUER arquivo do repositorio - entao, a partir do primeiro componente que nos
- * mesmos escrevemos, ela passava a responder `imported: true` e `scoped: true` sobre um projeto
- * que nao importa nada e nao tem escopo nenhum.
- *
- * O QUE O CLIENTE VIVIA: ele traz um componente, a tela diz *"This project already imports
- * <slug>'s tokens.css and carries data-ds - nothing to set up"*, ele cola o componente na pagina,
- * e ve' um bloco sem cor, sem tipografia e sem sombra. O comando acabou de garantir que estava
- * tudo certo. O `doctor` le' pela mesma porta, entao dizia o mesmo.
- *
- * A instrucao que ESTE arquivo carrega e' uma instrucao, nao um cumprimento dela. Um comentario
- * nosso nunca prova nada sobre o projeto dele.
- */
-const OURS = "Generated by SynthesisUI";
-export async function readWiring(root, slug) {
-    const w = {
-        imported: false,
-        /**
-         * O ADAPTADOR DO TAILWIND, e ele é uma pergunta SEPARADA de `imported`.
-         *
-         * O DEFEITO QUE ISTO CONSERTA, apontado na revisão deste PR: `imported` olha só o
-         * `tokens.css`, e o bloco que consulta esta leitura fala dos UTILITÁRIOS - que só o `@theme`
-         * do `theme.css` gera. Num projeto com um import e não o outro, o comando nomeava a falta
-         * (`what needs it: the bg-canvas utility`) e na linha seguinte declarava que não faltava nada.
-         *
-         * Um falso silêncio é pior que o falso alarme que este PR veio consertar: o cliente cola o
-         * componente, vê um bloco sem tipografia e sem sombra, e o comando acabou de dizer que estava
-         * tudo certo.
-         */
-        themed: false,
-        scoped: false,
-        /** `init` wrote a fonts file for this project (Next targets only). */
-        fontsWritten: false,
-        /** …and the stylesheet actually maps it onto the system's type tokens. */
-        fontsMapped: false,
-        /**
-         * THE FEATURE NOBODY KNEW WE SHIPPED.
-         *
-         * Every system compiles a `shadcn.css` mapping shadcn's whole variable
-         * contract onto its own tokens, so shadcn components wear the system instead
-         * of shadcn's defaults. It has been generated into every project since it
-         * was built, and until 28/07 nothing mentioned it: not `add`, not the
-         * managed block, not the GUIDE except as a filename in a list. The only
-         * documentation was a comment inside the file, which is the same as none.
-         *
-         * The person it mattered most to is the one who asked "I don't get the use
-         * case, I can just build a design system with shadcn" - and the answer was
-         * sitting unimported in his own repo.
-         *
-         * Reported only when the project HAS shadcn. Telling everybody about a
-         * bridge they will never use is how a report earns the skim.
-         */
-        hasShadcn: false,
-        bridged: false,
-    };
-    if (!slug)
-        return w;
-    w.hasShadcn = await readFile(join(root, "components.json"), "utf8").then(() => true, () => false);
-    for await (const file of walk(root)) {
-        const src = await readFile(file, "utf8").catch(() => "");
-        if (!src)
-            continue;
-        /** Ver `OURS`: o nosso proprio cabecalho respondia por ele. */
-        if (src.slice(0, 300).includes(OURS))
-            continue;
-        if (src.includes(`_synthesisui/ds/${slug}/tokens.css`))
-            w.imported = true;
-        if (src.includes(`_synthesisui/ds/${slug}/theme.css`))
-            w.themed = true;
-        if (src.includes(`_synthesisui/ds/${slug}/shadcn.css`))
-            w.bridged = true;
-        if (src.includes(`data-ds="${slug}"`))
-            w.scoped = true;
-        // The requirement that stayed invisible. `init` writes a fonts file and
-        // asks for two more edits; an agent told to check only the first two did
-        // exactly that, stopped, and left the project rendering in the framework's
-        // default face (my-test2, 27/07). What the checker checks is what gets done.
-        if (src.includes("--font-ds-") && /next\/font/.test(src))
-            w.fontsWritten = true;
-        /** O prefixo vem da const única da costura - um literal aqui divergiria em silêncio (26/08). */
-        if (new RegExp(`${FAMILY_SEAM_PREFIX}\\w+\\s*:\\s*var\\(\\s*--font-ds-`).test(src))
-            w.fontsMapped = true;
-        // The bridge joins the early exit, otherwise the walk can stop before the
-        // stylesheet that imports it and report a wired project as unbridged.
-        if (w.imported &&
-            w.themed &&
-            w.scoped &&
-            w.fontsMapped &&
-            (!w.hasShadcn || w.bridged))
-            break;
-    }
-    return w;
-}
-/**
- * A FIAÇÃO DE CADA APP, e num monorepo é ela que decide - `readWiring` acima não decide.
- *
- * O QUE O CLIENTE VIA: `readWiring` varre da RAIZ e responde "existe, em algum lugar daqui". Num
- * monorepo com dois apps servidos, um fiado e outro não, o fiado respondia pelo outro: a pessoa
- * abria o app que não carrega nada e o comando dizia que estava tudo certo. O contrato já declarava
- * isso como lacuna (`INV-VOLTA-12`, "a resposta é do PROJETO, e num monorepo ela não decide") e o
- * comando dizia o que mediu em vez de afirmar - honesto, e ainda a resposta errada.
- *
- * COMO A RESPOSTA CERTA É ENCONTRADA, e cada metade vem de onde ela mora:
- *
- *     os `@import`   seguindo a CADEIA de folhas a partir da folha daquele app (`sheetChainOf`).
- *                    A folha que carrega os tokens quase nunca é a do app: num monorepo é a do
- *                    pacote compartilhado, e os dois apps chegam nela - então varrer pasta daria
- *                    "não" para os dois, e varrer a raiz dá "sim" para todos
- *     o `data-ds`    na árvore DAQUELE app, porque o escopo mora no layout dele
- *     as fontes      idem - `init` escreve o arquivo de fonte por app
- *
- * O QUE ESTA FUNÇÃO NÃO GENERALIZA, declarado com o N de hoje (medido em 09/09):
- *
- *     `detectAppDirs` só procura em `apps/` e `packages/`   cobre 4 de 4 monorepos medidos;
- *                                                           `pnpm-workspace.yaml` aparece em 0 de 10
- *     e só reconhece app pelo `layout` do App Router        cobre 7 de 7 raízes de app medidas;
- *                                                           `vite` aparece só em PACOTE de
- *                                                           biblioteca, corretamente ignorado
- *
- * As duas são estreitezas REAIS e as duas têm N=0 de evidência contrária hoje. Generalizá-las sem
- * uma população que as exija seria dimensionar pela imaginação - o erro que `INV-GERAL-07` nomeia
- * pelo avesso. Quando aparecer um repositório que caia fora, o número dele é que abre a frente.
- */
-export async function readWiringPerApp(root, slug, pagesDir) {
-    if (!slug)
-        return [];
-    const apps = await detectAppDirs(root, pagesDir);
-    const out = [];
-    const hasShadcn = await readFile(join(root, "components.json"), "utf8").then(() => true, () => false);
-    for (const app of apps) {
-        const w = {
-            imported: false,
-            themed: false,
-            scoped: false,
-            fontsWritten: false,
-            fontsMapped: false,
-            hasShadcn,
-            bridged: false,
-        };
-        /** Os imports: a cadeia daquele app, e não a pasta dele. */
-        for (const sheet of await sheetChainOf(root, `${app}/globals.css`)) {
-            const css = await readFile(join(root, sheet), "utf8").catch(() => "");
-            if (!css)
-                continue;
-            if (css.includes(`_synthesisui/ds/${slug}/tokens.css`))
-                w.imported = true;
-            if (css.includes(`_synthesisui/ds/${slug}/theme.css`))
-                w.themed = true;
-            if (css.includes(`_synthesisui/ds/${slug}/shadcn.css`))
-                w.bridged = true;
-        }
-        /** O escopo e as fontes: a árvore DAQUELE app - é onde o layout dele mora. */
-        for await (const file of walk(join(root, app))) {
-            const src = await readFile(file, "utf8").catch(() => "");
-            if (!src)
-                continue;
-            if (src.includes(`data-ds="${slug}"`))
-                w.scoped = true;
-            if (src.includes("--font-ds-") && /next\/font/.test(src))
-                w.fontsWritten = true;
-            if (new RegExp(`${FAMILY_SEAM_PREFIX}\\w+\\s*:\\s*var\\(\\s*--font-ds-`).test(src))
-                w.fontsMapped = true;
-            if (w.scoped && w.fontsMapped)
-                break;
-        }
-        out.push({ app, wiring: w });
-    }
-    return out;
-}