synthesisui 0.16.259 → 0.16.260

package/dist/doctor/architecture.js

@@ -115,6 +115,38 @@ export function architectureRule(a) {
         evidence: `${a.evidence.join("/")} under ${a.root}, holding ${a.files} component file${a.files === 1 ? "" : "s"}`,
     };
 }
+/**
+ * A ESTRUTURA, ESCRITA - as pastas que a forma tem, na ordem em que ela as usa.
+ *
+ * Uma opção que diz só o nome da forma e um número não é uma escolha de
+ * organização: "escada atômica, 6 arquivos" não diz a ninguém o que ele está
+ * escolhendo. O dono leu duas opções assim e a pergunta ficou ilegível (19/08).
+ * Então cada opção mostra a árvore, e ela é medida - `evidence` são os diretórios
+ * que fizeram a leitura.
+ */
+export function describeShape(a) {
+    return `${a.root}/${a.evidence.length > 0 ? `{${a.evidence.join(", ")}}` : ""}`;
+}
+/**
+ * QUAIS FORMAS SÃO OPÇÃO, E QUAIS SÃO NOTA DE PÉ - decidido pela escala.
+ *
+ * Duas formas só são uma escolha quando as duas governam código de verdade. No
+ * monorepo do dono a segunda tinha 6 arquivos contra 780 da primeira - duas ordens
+ * de magnitude -, e oferecê-las lado a lado transformou um fato ("existe um canto
+ * organizado assim") numa pergunta que sugere que as duas disputam o repositório.
+ *
+ * O corte é um DÉCIMO da dominante: abaixo dele a forma continua verdadeira e é
+ * dita, mas não pede decisão. Um décimo e não um número redondo qualquer porque é
+ * a fronteira entre "convive" e "um canto".
+ */
+export const MINOR_SHARE = 0.1;
+export function splitByWeight(found) {
+    if (found.length === 0)
+        return { options: [], notes: [] };
+    const top = found[0].files;
+    const options = found.filter((a) => a.files >= top * MINOR_SHARE);
+    return { options, notes: found.filter((a) => !options.includes(a)) };
+}
 /**
  * One line naming what was found, and the choice it leaves open.
  *
@@ -125,10 +157,17 @@ export function describeChoice(found) {
     if (found.length === 0)
         return null;
     if (found.length === 1) {
-        return `One shape, read off your directories: ${found[0].kind} under \`${found[0].root}\`.`;
+        return `One shape, read off your directories: ${found[0].kind} in \`${describeShape(found[0])}\`.`;
+    }
+    const { options, notes } = splitByWeight(found);
+    const say = (a) => `${a.kind} in \`${describeShape(a)}\` (${a.files} files)`;
+    /**
+     * Uma dominante e o resto em cantos: isto não é uma pergunta sobre o retrato, é
+     * uma pergunta sobre a REGRA daqui em diante - e a skill é quem a faz.
+     */
+    if (options.length === 1) {
+        return `One shape governs this code: ${say(options[0])}. Also here, and staying true without deciding anything: ${notes.map(say).join(", ")}.`;
     }
-    const list = found
-        .map((a) => `${a.kind} under \`${a.root}\` (${a.files} files)`)
-        .join(", ");
-    return `${found.length} shapes, and none of them is a mistake: ${list}. A library organised atomically inside a monorepo whose apps are organised by feature is two true answers. Pick which one has PRIORITY - it becomes the rule every prompt reads, and the others stay true without deciding.`;
+    const list = options.map(say).join(", ");
+    return `${options.length} shapes govern real code, and none of them is a mistake: ${list}.${notes.length > 0 ? ` Smaller corners, reported and not asked about: ${notes.map(say).join(", ")}.` : ""} Pick which one has PRIORITY - it becomes the rule every prompt reads, and the others stay true without deciding.`;
 }

package/package.json

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