@softize/opus 12.0.1 → 12.1.0

package/CHANGELOG.md

@@ -7,6 +7,18 @@ Depois de qualquer bump, rode os gates (`typecheck` · `test` · `opus check` ·
 `opus copy --check` · `base copy check` · `manifest:check`) — eles apontam o que a
 mudança cobra do seu código.
 
+## 12.1.0 — 2026-08-22
+
+Interfaces que combinam copy fixa com nomes, contagens ou opções vindas da aplicação não
+precisam mais excluir o arquivo inteiro do inventário. `base.json.copy.dynamic` classifica um
+diagnóstico exato como `runtime-data` ou `message-template`, com motivo e referência
+auditáveis. Dados de runtime ficam fora da política editorial; o texto-modelo de mensagens
+interpoladas entra no inventário com seu papel semântico, sem alterar o conteúdo renderizado.
+
+Cada declaração precisa corresponder a um único caminho, linha e campo. Quando o código muda
+e o seletor fica órfão ou ambíguo, `opus copy` reprova e orienta a revisão. O inventário expõe
+essas classificações em `dynamicSurfaces`, e o resumo do CLI informa sua quantidade.
+
 ## 12.0.1 — 2026-08-22
 
 `Split` volta a atender layouts que precisam preservar uma medida física e a preferência da

package/bin/cli.mjs

@@ -254,7 +254,8 @@ async function cmdCopy(dir, flags) {
   const coverage = result.inventory.coverage
   const summary =
     `${coverage.analyzedFiles} arquivo(s) analisado(s), ` +
-    `${coverage.coveredSources} fonte(s) com copy, ${coverage.extractedEntries} texto(s)`
+    `${coverage.coveredSources} fonte(s) com copy, ${coverage.extractedEntries} texto(s), ` +
+    `${result.inventory.dynamicSurfaces.length} superfície(s) dinâmica(s) declarada(s)`
   if (flags.check) log('success', `✓ opus copy: ${location} está atualizado (${summary}).`)
   else if (result.changed) log('success', `✓ opus copy: ${location} gerado atomicamente (${summary}).`)
   else log('success', `✓ opus copy: ${location} já estava atualizado (${summary}).`)

package/bin/lib/copy.mjs

@@ -52,6 +52,13 @@ const IGNORED_FILE = /(?:\.d|\.spec|\.test|\.stories)\.[cm]?[jt]sx?$/u
 // O Opus garante somente o namespace e o shape do identificador. O catálogo de regras,
 // inclusive adições futuras, pertence à versão instalada da Base.
 const COPY_RULE_ID = /^COPY\d{3}$/u
+const COPY_DYNAMIC_KINDS = new Set(['message-template', 'runtime-data'])
+const COPY_ROLES = new Set([
+  'badge', 'breadcrumb', 'button', 'description', 'dialog-body', 'empty-state', 'error',
+  'heading', 'helper-text', 'kicker', 'label', 'menu-item', 'message', 'notification',
+  'placeholder', 'success', 'tab', 'title', 'warning',
+])
+const AUDIT_REFERENCE = /^(?:https?:\/\/\S+|[a-z][a-z0-9-]*:\S+|(?:[A-Za-z0-9._-]+\/)+[A-Za-z0-9._#/-]+|[A-Za-z0-9._-]+\.(?:md|json|ya?ml)(?:#[^\s]+)?)$/u
 const CONTRACT_MODULES = new Set(['@softize/opus', '@softize/opus/core'])
 const CONTRACT_FACTORIES = new Set(['defineAction', 'defineContract'])
 const ACTION_BINDING_KEYS = new Set(['authorize', 'background', 'emits', 'handler', 'idempotency', 'loads'])
@@ -839,10 +846,12 @@ function lineOf(sourceFile, node) {
   return sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile)).line + 1
 }
 
-function diagnostic(file, sourceFile, node, field) {
+function diagnostic(file, sourceFile, node, field, category = 'content') {
   return {
     source: file,
     line: lineOf(sourceFile, node),
+    field,
+    category,
     message:
       `não foi possível extrair \`${field}\` estaticamente; use texto literal, concatenação ` +
       'de literais, constante local ou I18nRef com `default` literal.',
@@ -929,13 +938,13 @@ export function extractCopyFromSource(file, sourceText) {
   const optionItems = (object, prefix) => {
     const kind = property(object, 'kind', sourceFile, checker)
     if (kind.opaque !== undefined) {
-      diagnostics.push(diagnostic(file, sourceFile, kind.opaque, `${prefix}kind`))
+      diagnostics.push(diagnostic(file, sourceFile, kind.opaque, `${prefix}kind`, 'structure'))
       return
     }
     if (kind.candidate === undefined) return
     const kindText = staticText(propertyValue(kind.candidate), checker)?.text
     if (kindText === undefined) {
-      diagnostics.push(diagnostic(file, sourceFile, propertyValue(kind.candidate), `${prefix}kind`))
+      diagnostics.push(diagnostic(file, sourceFile, propertyValue(kind.candidate), `${prefix}kind`, 'structure'))
       return
     }
     if (kindText !== 'static') return
@@ -1075,7 +1084,7 @@ export function extractCopyFromSource(file, sourceText) {
     const key = `${node.pos}:${node.end}:${field}`
     if (transformDiagnostics.has(key)) return
     transformDiagnostics.add(key)
-    diagnostics.push(diagnostic(file, sourceFile, node, field))
+    diagnostics.push(diagnostic(file, sourceFile, node, field, 'transform'))
   }
 
   function tailwindTransform(token) {
@@ -1502,13 +1511,13 @@ export function extractCopyFromSource(file, sourceText) {
     if (component !== 'Select') return null
     const native = attribute(opening.attributes, 'native')
     if (native.opaque !== undefined) {
-      diagnostics.push(diagnostic(file, sourceFile, native.opaque, '<Select>.native'))
+      diagnostics.push(diagnostic(file, sourceFile, native.opaque, '<Select>.native', 'structure'))
       return 'opaque'
     }
     if (native.candidate === undefined) return 'custom'
     const value = attributeBoolean(native)
     if (value === null) {
-      diagnostics.push(diagnostic(file, sourceFile, attributeValue(native) ?? opening, '<Select>.native'))
+      diagnostics.push(diagnostic(file, sourceFile, attributeValue(native) ?? opening, '<Select>.native', 'structure'))
       return 'opaque'
     }
     return value ? 'native' : 'custom'
@@ -1547,7 +1556,15 @@ export function extractCopyFromSource(file, sourceText) {
       if (slot.opaque !== undefined) diagnostics.push(diagnostic(file, sourceFile, slot.opaque, `<${component}>.${name}`))
       else if (slot.candidate !== undefined) {
         const raw = attributeValue(slot)
-        if (raw === null || !noRenderedValue(raw)) diagnostics.push(diagnostic(file, sourceFile, raw ?? opening, `<${component}>.${name}`))
+        if (raw === null || !noRenderedValue(raw)) {
+          diagnostics.push(diagnostic(
+            file,
+            sourceFile,
+            raw ?? opening,
+            `<${component}>.${name}`,
+            raw === null ? 'missing-content' : 'content',
+          ))
+        }
       }
     }
 
@@ -1594,8 +1611,16 @@ export function extractCopyFromSource(file, sourceText) {
             }
           }
         } else {
-          const value = attributeText(item)
-          if (value === null) diagnostics.push(diagnostic(file, sourceFile, raw ?? opening, `<${component}>.${name}`))
+          const value = raw === null ? null : attributeText(item)
+          if (value === null) {
+            diagnostics.push(diagnostic(
+              file,
+              sourceFile,
+              raw ?? opening,
+              `<${component}>.${name}`,
+              raw === null ? 'missing-content' : 'content',
+            ))
+          }
           else {
             const entry = { source: file, line: lineOf(sourceFile, value.node), role, text: value.text }
             if (transformed.uppercase) entry.transform = 'uppercase'
@@ -1613,7 +1638,7 @@ export function extractCopyFromSource(file, sourceText) {
           inheritedFor('className', 'style'),
         )
         if (transformed.uppercase) {
-          diagnostics.push(diagnostic(file, sourceFile, opening, '<ActionTrigger>.label herdado do contrato sob uppercase'))
+          diagnostics.push(diagnostic(file, sourceFile, opening, '<ActionTrigger>.label herdado do contrato sob uppercase', 'transform'))
         }
       }
     }
@@ -1625,7 +1650,15 @@ export function extractCopyFromSource(file, sourceText) {
         const raw = attributeValue(item)
         const object = raw === null ? null : resolveBinding(raw, checker)
         if (object?.kind === ts.SyntaxKind.NullKeyword || (ts.isIdentifier(object) && object.text === 'undefined')) continue
-        if (!ts.isObjectLiteralExpression(object)) diagnostics.push(diagnostic(file, sourceFile, raw ?? opening, `<${component}>.${name}`))
+        if (!ts.isObjectLiteralExpression(object)) {
+          diagnostics.push(diagnostic(
+            file,
+            sourceFile,
+            raw ?? opening,
+            `<${component}>.${name}`,
+            raw === null ? 'structure' : 'content',
+          ))
+        }
         else for (const [nestedName, role] of nestedRoles) addProperty(object, nestedName, role, `<${component}>.${name}.`)
       }
     }
@@ -1636,7 +1669,15 @@ export function extractCopyFromSource(file, sourceText) {
       else if (item.candidate !== undefined) {
         const raw = attributeValue(item)
         const listed = raw === null ? { values: [], opaque: [opening] } : objects(raw, checker)
-        for (const opaque of listed.opaque) diagnostics.push(diagnostic(file, sourceFile, opaque, `<${component}>.${name}`))
+        for (const opaque of listed.opaque) {
+          diagnostics.push(diagnostic(
+            file,
+            sourceFile,
+            opaque,
+            `<${component}>.${name}`,
+            raw === null ? 'structure' : 'content',
+          ))
+        }
         for (const [index, option] of listed.values.entries()) {
           for (const [optionName, role] of optionRoles) {
             if (mode === 'native' && !['label', 'group'].includes(optionName)) continue
@@ -1668,8 +1709,17 @@ export function extractCopyFromSource(file, sourceText) {
     if (ariaLabelAttribute.opaque !== undefined) {
       diagnostics.push(diagnostic(file, sourceFile, ariaLabelAttribute.opaque, `<${component}>.aria-label`))
     } else if (ariaLabelAttribute.candidate !== undefined) {
-      const ariaLabel = attributeText(ariaLabelAttribute)
-      if (ariaLabel === null) diagnostics.push(diagnostic(file, sourceFile, attributeValue(ariaLabelAttribute) ?? opening, `<${component}>.aria-label`))
+      const raw = attributeValue(ariaLabelAttribute)
+      const ariaLabel = raw === null ? null : attributeText(ariaLabelAttribute)
+      if (ariaLabel === null) {
+        diagnostics.push(diagnostic(
+          file,
+          sourceFile,
+          raw ?? opening,
+          `<${component}>.aria-label`,
+          raw === null ? 'missing-content' : 'content',
+        ))
+      }
       if (ariaLabel !== null) {
         hasStaticAriaLabel = true
         entries.push({ source: file, line: lineOf(sourceFile, ariaLabel.node), role: 'label', text: ariaLabel.text })
@@ -1692,7 +1742,7 @@ export function extractCopyFromSource(file, sourceText) {
         if (children.opaque !== undefined) return { kind: 'opaque', node: children.opaque }
         if (children.candidate === undefined) return { kind: 'decorative' }
         const raw = attributeValue(children)
-        return raw === null ? { kind: 'opaque', node: opening } : childExpression(raw, inheritedUppercase)
+        return raw === null ? { kind: 'decorative' } : childExpression(raw, inheritedUppercase)
       }
       const inheritedUppercase = component === 'ActionFormDialog'
         ? false
@@ -1710,7 +1760,9 @@ export function extractCopyFromSource(file, sourceText) {
       }
       if (value.kind === 'opaque') diagnostics.push(diagnostic(file, sourceFile, value.node, `<${component}> children`))
       else if (value.kind === 'decorative') {
-        if (!hasStaticAriaLabel && !OPTIONAL_CHILD_COMPONENTS.has(component)) diagnostics.push(diagnostic(file, sourceFile, element, `<${component}> children`))
+        if (!hasStaticAriaLabel && !OPTIONAL_CHILD_COMPONENTS.has(component)) {
+          diagnostics.push(diagnostic(file, sourceFile, element, `<${component}> children`, 'missing-content'))
+        }
       } else {
         const texts = value.kind === 'text' ? [value] : value.values
         for (const text of texts) {
@@ -1727,11 +1779,11 @@ export function extractCopyFromSource(file, sourceText) {
     if (ts.isCallExpression(node) && factory !== null && node.arguments.length > 0) {
       hasContract = true
       if (!stableFactoryResult(node, checker, new Set())) {
-        diagnostics.push(diagnostic(file, sourceFile, node, `${factory}(...) result`))
+        diagnostics.push(diagnostic(file, sourceFile, node, `${factory}(...) result`, 'structure'))
       } else {
         const object = resolveBinding(node.arguments[0], checker)
         if (ts.isObjectLiteralExpression(object)) extractContract(object)
-        else diagnostics.push(diagnostic(file, sourceFile, node.arguments[0], `${factory}(...)`))
+        else diagnostics.push(diagnostic(file, sourceFile, node.arguments[0], `${factory}(...)`, 'structure'))
       }
     }
     if (ts.isJsxElement(node) || ts.isJsxSelfClosingElement(node)) extractJsx(node)
@@ -1834,6 +1886,7 @@ function copyConfiguration(root) {
       inventoryPath,
       exemptions: [],
       transforms: [],
+      dynamic: [],
       exclude: [],
     }
   }
@@ -1854,6 +1907,7 @@ function copyConfiguration(root) {
     inventoryPath: target,
     exemptions: config?.exemptions ?? [],
     transforms: config?.transforms ?? [],
+    dynamic: config?.dynamic ?? [],
     exclude: config?.exclude ?? [],
   }
 }
@@ -1914,7 +1968,118 @@ function findEntry(entries, selector) {
     )
 }
 
+function canonicalSource(value) {
+  return (
+    typeof value === 'string' &&
+    value !== '' &&
+    value.trim() === value &&
+    value === value.normalize('NFC') &&
+    !value.includes('\\') &&
+    !path.posix.isAbsolute(value) &&
+    !path.win32.isAbsolute(value) &&
+    !/^[A-Za-z]:/u.test(value) &&
+    value !== '.' &&
+    value !== '..' &&
+    path.posix.normalize(value) === value &&
+    value.split('/').every((part) => part !== '' && part !== '.' && part !== '..')
+  )
+}
+
+function applyDynamicMetadata(config, entries, diagnostics) {
+  const surfaces = []
+  if (!Array.isArray(config.dynamic)) {
+    diagnostics.push(selectorDiagnostic('copy.dynamic deve ser uma lista.'))
+    return surfaces
+  }
+  const consumed = new Set()
+  for (const [index, declaration] of config.dynamic.entries()) {
+    const template = declaration?.kind === 'message-template'
+    const allowedFields = new Set([
+      'source', 'line', 'field', 'kind', 'reason', 'reference',
+      ...(template ? ['role', 'text'] : []),
+    ])
+    const normalizedReason = typeof declaration?.reason === 'string' ? declaration.reason.trim() : ''
+    const normalizedReference = typeof declaration?.reference === 'string' ? declaration.reference.trim() : ''
+    if (
+      declaration === null ||
+      typeof declaration !== 'object' ||
+      Array.isArray(declaration) ||
+      Object.keys(declaration).some((field) => !allowedFields.has(field)) ||
+      !canonicalSource(declaration.source) ||
+      !Number.isInteger(declaration.line) ||
+      declaration.line < 1 ||
+      typeof declaration.field !== 'string' ||
+      declaration.field.trim() === '' ||
+      !COPY_DYNAMIC_KINDS.has(declaration.kind) ||
+      typeof declaration.reason !== 'string' ||
+      normalizedReason.length < 12 ||
+      normalizedReason.length > 500 ||
+      /[\r\n]/u.test(declaration.reason) ||
+      typeof declaration.reference !== 'string' ||
+      normalizedReference.length < 8 ||
+      normalizedReference.length > 500 ||
+      !AUDIT_REFERENCE.test(normalizedReference) ||
+      (template && (
+        typeof declaration.text !== 'string' ||
+        declaration.text.trim() === '' ||
+        declaration.text !== declaration.text.trim() ||
+        /[\r\n]/u.test(declaration.text) ||
+        !COPY_ROLES.has(declaration.role)
+      )) ||
+      (!template && (declaration.text !== undefined || declaration.role !== undefined))
+    ) {
+      diagnostics.push(selectorDiagnostic(
+        `copy.dynamic[${index}] exige seletor, kind, reason e reference válidos` +
+        (template ? ', além de text e role para message-template.' : '.'),
+      ))
+      continue
+    }
+    const matches = diagnostics
+      .map((item, diagnosticIndex) => ({ item, diagnosticIndex }))
+      .filter(({ item, diagnosticIndex }) =>
+        !consumed.has(diagnosticIndex) &&
+        item.category === 'content' &&
+        item.source === declaration.source &&
+        item.line === declaration.line &&
+        item.field === declaration.field,
+      )
+    if (matches.length !== 1) {
+      diagnostics.push(selectorDiagnostic(
+        `copy.dynamic[${index}] deve selecionar exatamente um diagnóstico de extração; encontrou ${matches.length}.`,
+      ))
+      continue
+    }
+    consumed.add(matches[0].diagnosticIndex)
+    const surface = {
+      source: declaration.source,
+      line: declaration.line,
+      field: declaration.field,
+      kind: declaration.kind,
+      reason: normalizedReason,
+      reference: normalizedReference,
+    }
+    if (template) {
+      surface.role = declaration.role
+      surface.text = declaration.text
+      entries.push({
+        source: declaration.source,
+        line: declaration.line,
+        role: declaration.role,
+        text: declaration.text,
+        dynamic: { kind: declaration.kind, field: declaration.field, reference: normalizedReference },
+      })
+    }
+    surfaces.push(surface)
+  }
+  if (consumed.size > 0) {
+    const remaining = diagnostics.filter((_, index) => !consumed.has(index))
+    diagnostics.splice(0, diagnostics.length, ...remaining)
+  }
+  return surfaces
+}
+
 function applyProjectMetadata(config, entries, diagnostics) {
+  const dynamicSurfaces = applyDynamicMetadata(config, entries, diagnostics)
   if (!Array.isArray(config.exemptions)) {
     diagnostics.push(selectorDiagnostic('copy.exemptions deve ser uma lista.'))
   } else {
@@ -1993,6 +2158,7 @@ function applyProjectMetadata(config, entries, diagnostics) {
       entries[entryIndex].transform = transform.transform
     }
   }
+  return dynamicSurfaces
 }
 
 export function extractCopyInventory(root) {
@@ -2050,7 +2216,7 @@ export function extractCopyInventory(root) {
       'nenhum arquivo JavaScript/TypeScript elegível foi analisado; o inventário v2 exige ao menos uma fonte rastreável.',
     ))
   }
-  applyProjectMetadata(config, entries, diagnostics)
+  const dynamicSurfaces = applyProjectMetadata(config, entries, diagnostics)
 
   const coveredSources = new Set(entries.map((entry) => entry.source)).size
 
@@ -2066,6 +2232,7 @@ export function extractCopyInventory(root) {
       },
       sources,
       entries,
+      dynamicSurfaces,
     },
     diagnostics,
   }

package/docs/code-style.md

@@ -131,6 +131,23 @@ autoral da interface. Arrays, objetos ou discriminadores dinâmicos falham visiv
 inequívoca; entidades JSX são decodificadas antes do inventário. Fragmentos cuja concatenação
 exigiria adivinhar espaços continuam reprovando.
 
+Quando o diagnóstico corresponde a dados reais da aplicação ou a uma mensagem interpolada,
+`copy.dynamic` permite classificar somente aquela superfície sem excluir o arquivo. Cada item
+seleciona exatamente um diagnóstico por `source`, `line` e `field`, registra `reason` e
+`reference` auditáveis e usa um destes contratos:
+
+- `runtime-data` reconhece nomes, contagens, status ou opções fornecidos em runtime. Nenhuma
+  entrada editorial é fabricada;
+- `message-template` exige `role` e `text`. O texto-modelo entra no inventário e passa pela
+  política da Base, mas não substitui nem altera o conteúdo renderizado.
+
+As declarações aparecem em `dynamicSurfaces` no inventário. Se o source mudar e o seletor não
+encontrar exatamente um diagnóstico, `opus copy` falha. Assim, a classificação permanece
+estreita e revisável, sem transformar metadata em uma exclusão silenciosa. O mecanismo aceita
+somente diagnósticos de conteúdo; incerteza estrutural, `className`, `style`, transformação ou
+modo de renderização continua bloqueante. Superfície vazia também não pode ser reclassificada
+como dado de runtime.
+
 Um `opus copy --check` verde **não significa que toda a copy do produto foi coberta**. Ficam
 fora, deliberadamente:
 
@@ -138,7 +155,7 @@ fora, deliberadamente:
   seu papel semântico;
 - texto vindo de API, banco, catálogo i18n importado ou variável de runtime em superfícies
   que o Opus não classifica. Quando esse conteúdo ocupa uma prop ou filho mapeado, a extração
-  falha e pede um fallback estático;
+  falha e pede copy estática ou uma declaração estreita em `copy.dynamic`;
 - props ou componentes de terceiros sem contrato Opus;
 - copy escondida em CSS ou pseudo-elemento. Para uma transformação conhecida que o AST não
   enxerga globalmente, use `copy.transforms`; em componente Opus mapeado, `className` opaco

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softize/opus",
-  "version": "12.0.1",
+  "version": "12.1.0",
   "description": "End-to-end action protocol for TypeScript. Single package with subpath exports (core + adapters).",
   "license": "MIT",
   "type": "module",

package/registry/skills/build-opus-ui/SKILL.md

@@ -31,8 +31,11 @@ existentes, mantendo navegação observável e componentes reutilizáveis sem la
 
 Rodar `opus check`, testes focados, typecheck e build da superfície. Se a interface alterou
 copy em contrato ou componente Opus mapeado, regenerar com `opus copy` e executar
-`base copy check`. Copy dinâmica numa superfície mapeada precisa de fallback estático ou de
-uma decisão explícita de arquitetura; não contorne o diagnóstico com `aria-label` paralelo.
+`base copy check`. Quando uma superfície mapeada recebe dados da aplicação, usar
+`copy.dynamic` com seletor exato, motivo e referência: `runtime-data` para valores sem autoria
+editorial; `message-template` com `role` e texto-modelo para mensagens interpoladas. Não excluir
+o arquivo inteiro nem contornar o diagnóstico com `aria-label` paralelo. Revisar cada declaração
+dinâmica como fronteira de cobertura, mesmo com os gates verdes.
 Inspecionar visualmente a rota real e validar navegação por URL quando aplicável.
 
 ## Limites

package/src/ui/docs/content/communication.md

@@ -60,6 +60,43 @@ visual que o protocolo não representa com segurança.
 `ActionTrigger.itemLabel` é conteúdo de domínio em runtime (o nome do registro alvo), não
 é copy editorial estável; `label` e `confirm.*` são as superfícies editoriais cobertas.
 
+Quando uma prop mapeada recebe dados da aplicação, declare a superfície em
+`base.json.copy.dynamic` em vez de excluir o arquivo inteiro. O seletor usa o caminho, a
+linha e o campo exibido pelo diagnóstico. `runtime-data` registra valores como nomes,
+contagens e opções vindas de API sem transformá-los em copy editorial. `message-template`
+acrescenta ao inventário um texto-modelo com papel semântico, para que a parte autoral de uma
+mensagem interpolada continue passando pela política da Base. As declarações não alteram o
+que o React renderiza; um seletor que deixa de corresponder a um único diagnóstico reprova o
+gate e precisa ser revisto. Diagnósticos estruturais ou de transformação visual não podem ser
+dispensados por `copy.dynamic`; ausência de conteúdo também continua bloqueante.
+
+```json
+{
+  "copy": {
+    "dynamic": [
+      {
+        "source": "src/sessions.tsx",
+        "line": 42,
+        "field": "<Select>.options",
+        "kind": "runtime-data",
+        "reason": "As opções são nomes de sessões retornados pela aplicação.",
+        "reference": "domain:sessions"
+      },
+      {
+        "source": "src/sessions.tsx",
+        "line": 58,
+        "field": "<DialogDescription> children",
+        "kind": "message-template",
+        "role": "dialog-body",
+        "text": "Excluir {nome}?",
+        "reason": "O nome identifica a sessão selecionada na confirmação.",
+        "reference": "domain:sessions"
+      }
+    ]
+  }
+}
+```
+
 O mapeamento completo, o limite de cobertura e os comandos do gate estão em
 `docs/code-style.md` do pacote.