synthesisui 0.16.485 → 0.16.487

package/dist/commands/hook.js

@@ -5,6 +5,7 @@ import { readAutoSync, startSync } from "../auto-sync.js";
 import { changedSince } from "../changed-files.js";
 import { emptyTally, exportedNames, internalSpecifiers, scanComponentsInto, tallyToInventory, } from "../doctor/components-scan.js";
 import { checkContracts } from "../doctor/contract-check.js";
+import { componentOf } from "../doctor/component-of.js";
 import { appendEvent, ledgerPath } from "../doctor/ledger.js";
 import { describeOffScale, diagnose, nameToWrite, scanSource } from "../doctor/scan.js";
 import { declarados, falaDaPrateleira, naPrateleira } from "../doctor/shelf.js";
@@ -317,12 +318,16 @@ async function report(root, filePath, mode) {
     // just flagged is the evidence the agent read the report and acted. Without
     // the clean lines the record could only ever say "found", never "fixed",
     // which is the half we could not answer when asked (28/07).
+    const component = componentOf(rel, documents);
     await appendEvent(root, {
         kind: "hook",
         at: new Date().toISOString(),
         file: rel,
         named: named.length,
         phantoms: phantoms.length,
+        unnamed: unnamed.length,
+        offScale: d.files.reduce((n, f) => n + (f.offScale?.length ?? 0), 0),
+        ...(component ? { component } : {}),
     });
     /** O bloqueio de CONSUMIR é a única saída que recusa, e ele acompanha o relatório seja qual for. */
     const block = mode === "consume" && composed.length > 0;

package/dist/doctor/component-of.js

@@ -0,0 +1,68 @@
+import { basename, dirname } from "node:path";
+/**
+ * DE QUAL COMPONENTE É ESTE ARQUIVO - a ponte que o documento já tem, e nenhuma outra (E01, 30/09).
+ *
+ * A receita diz onde o componente mora (`components.<Nome>.source.file`), escrito pela leitura do
+ * import. O arquivo que a checagem olha pode ser esse mesmo, ou o estilo ao lado dele:
+ * `components/Card.module.css` é do `Card` cujo arquivo é `components/Card.tsx` - mesma pasta, mesmo
+ * nome antes do primeiro ponto.
+ *
+ * E A PASTA DO COMPONENTE É DELE (medido no `codelevel` em 30/09, na E03): `packages/ui/src/CourseCover/motion.ts` é
+ * do `course-cover`, porque a pasta tem o nome do arquivo do componente. `components/`, que é de todos, não vira de
+ * ninguém: ali só o arquivo e o estilo com o mesmo nome.
+ *
+ * DUAS RECEITAS NO MESMO ARQUIVO: fica a que tem o nome dele. O `codelevel` tem `course-cover` e `covers` em
+ * `CourseCover.tsx`, e a regra antiga ("duas reclamam, nenhuma") deixava sem componente as 21 checagens do
+ * componente mais checado do sistema. Se nenhuma tem o nome, continua nenhuma.
+ *
+ * SEM RECEITA, SEM COMPONENTE. Um `app/page.module.css` que nenhuma receita reclama não vira "Page":
+ * o palpite pelo nome contaria checagens para um componente que não existe no sistema dele, e é
+ * dessa contagem que os degraus do jogo vão sair. E se duas receitas diferentes reclamam o mesmo
+ * arquivo, também não há resposta - escolher uma seria o mesmo palpite com outra roupa.
+ */
+export function componentOf(file, documents) {
+    const exact = new Map();
+    const sibling = new Map();
+    const folder = new Map();
+    const dir = dirname(file);
+    const stem = stemOf(file);
+    for (const doc of documents) {
+        const components = doc?.components;
+        if (!components || typeof components !== "object")
+            continue;
+        for (const [name, recipe] of Object.entries(components)) {
+            const at = recipe?.source
+                ?.file;
+            if (typeof at !== "string" || at === "")
+                continue;
+            if (at === file)
+                exact.set(name, at);
+            else if (dirname(at) !== dir)
+                continue;
+            else if (stemOf(at) === stem)
+                sibling.set(name, at);
+            else if (basename(dir) === stemOf(at))
+                folder.set(name, at);
+        }
+    }
+    const found = [exact, sibling, folder].find((m) => m.size > 0);
+    if (!found)
+        return undefined;
+    if (found.size === 1)
+        return [...found.keys()][0];
+    const named = [...found].filter(([name, at]) => name === kebab(stemOf(at)));
+    return named.length === 1 ? named[0]?.[0] : undefined;
+}
+/**
+ * `CourseCover` -> `course-cover`: a chave que a plataforma dá à receita - cópia de `contractName`
+ * (apps/web/src/lib/ds/exclusive-contract.ts), porque o CLI é publicado sozinho e não importa de lá.
+ */
+const kebab = (name) => name
+    .split(".")
+    .join("-")
+    .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+    .toLowerCase()
+    .replace(/[^a-z0-9-]/g, "-")
+    .replace(/-+/g, "-")
+    .replace(/^-|-$/g, "");
+const stemOf = (path) => basename(path).split(".")[0] ?? "";

package/dist/install-marks.js

@@ -515,7 +515,19 @@ export const COUNTED_DIFFERENTLY = "this run counts a value as named only when Y
  * de propósito, avisa a grade que divide a altura da tela no celular, propõe os nomes numa pergunta só e termina pedindo
  * o resumo por último. Um hook anterior diz outra coisa sobre o mesmo turno.
  */
-export const CHECKER_SINCE = "0.16.485";
+/**
+ * 0.16.485 -> 0.16.486 em 30/09, e o passo 1 dá **SIM** (o jogo dos envios, E01): a linha que o hook grava no ledger
+ * passa a dizer quantos valores sem nome e quantos fora da escala a checagem achou, e de qual componente é o arquivo. Um
+ * hook anterior grava "limpo" sobre o arquivo que acabou de acusar, e é dessas linhas que os degraus de cada componente
+ * vão ser contados - quem está atrás vê o componente amadurecer com checagens que não foram limpas.
+ */
+/**
+ * 0.16.486 -> 0.16.487 em 30/09, e o passo 1 dá **SIM** (o jogo dos envios, E03): a ponte arquivo -> componente passa a
+ * dar dono ao arquivo da pasta do componente (`CourseCover/motion.ts`) e, quando duas receitas reclamam o mesmo arquivo,
+ * à que tem o nome dele. Medido no `codelevel`: 33 checagens do componente mais checado chegavam sem componente. Um
+ * hook anterior continua mandando essas checagens sem dono, e elas não contam para o degrau.
+ */
+export const CHECKER_SINCE = "0.16.487";
 /**
  * A ÚLTIMA VERSÃO EM QUE OS LEITORES PASSARAM A PRODUZIR UM CENSO DIFERENTE.
  *

package/package.json

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