mxrb 0.1.0

data/docs/pt-BR/ruby-first-roadmap.md

@@ -0,0 +1,239 @@
+# MXRB: Ruby acima de tudo
+
+**Português** · [English](../en-US/ruby-first-roadmap.md) · [Deutsch](../de-DE/ruby-first-roadmap.md)
+
+## Princípio arquitetural
+
+Ruby é a única linguagem pública do MXRB.
+
+- O modelo Mendix é lido, criado, alterado e analisado por APIs e DSLs Ruby.
+- A CLI é apenas uma camada fina sobre essas APIs.
+- Não haverá MDL, parser de uma linguagem paralela ou sintaxe própria concorrendo com Ruby.
+- Recursos sem abstração concisa continuam sem perdas e editáveis nos Hashes
+  Ruby gerados por `native_unit`.
+- Studio Pro e MxBuild são validadores externos importantes, mas não são dependências do núcleo Ruby.
+
+## Capacidades
+
+### Disponível
+
+- Leitura e escrita profunda de MPR v1 e v2.
+- Exportação de MPR para projeto Ruby editável.
+- Geração, validação e comparação estrutural.
+- Índice semântico de módulos, entidades, atributos, associações e documentos.
+- Consultas Ruby de referências, chamadores, chamadas e impacto transitivo.
+- Comandos CLI `refs`, `callers`, `callees` e `impact`, todos delegando à API Ruby.
+- Renomeação profunda com prévia Ruby e aplicação explícita.
+- Análise estática Ruby de ciclos, alvos ausentes, referências externas,
+  artefatos não referenciados e acoplamento entre módulos.
+- Regras de lint personalizadas escritas como objetos chamáveis Ruby.
+- Diff semântico tipado em Ruby, com mudanças `added`, `removed` e `changed`.
+- Navegação estrutural por busca, descrição de relações e árvore semântica.
+- Avaliações executáveis de modelo em Ruby, com checks reutilizáveis, severidade,
+  score e extensão por blocos Ruby.
+- Testes funcionais de microflows definidos em Ruby, instrumentados numa cópia
+  descartável e executados pelo runtime Mendix sem JUnit.
+- Execução local ou Docker de `mx check`, pacote portátil e runtime, com seleção
+  automática da família Java do projeto.
+- Gate nativo de cobertura: 100% de linhas e 100% de branches no CI,
+  com default local mais estrito de 100/100 quando os limites são omitidos.
+
+Projetos graváveis mantêm um cache do índice semântico identificado por
+fingerprint. `mxrb cache status`, `warm` e `clear` expõem métricas e manutenção;
+a troca usa upsert antes da limpeza da entrada antiga.
+
+A validação nativa exata do Mendix 5 continua dependente de Windows/Studio Pro.
+Ela fica documentada como limitação legada remota e não é um gate atual de
+entrega.
+
+Perfis de navegação agora leem e escrevem documentos nativos Mendix, incluindo
+homes por papel e menus recursivos. Assets de tema e código fazem round-trip
+com manifesto de checksums; tokens possuem inventário, lint, métricas de
+contraste e migração de literais com preview.
+
+## API semântica
+
+```ruby
+Mxrb.open("app.mpr") do |project|
+  order = project.find_artifact("Sales.Order")
+  refs = project.references_to(order)
+  callers = project.callers_of("Sales.Recalculate")
+  callees = project.callees_of("Sales.Checkout")
+  impact = project.impact_of("Sales.Order")
+
+  impact.artifacts.each do |artifact|
+    puts "#{artifact.kind}: #{artifact.qualified_name}"
+  end
+end
+```
+
+Os resultados são objetos Ruby imutáveis: `Mxrb::Semantic::Artifact`,
+`Mxrb::Semantic::Reference` e `Mxrb::Semantic::Impact`.
+
+Projetos abertos para escrita persistem no MPR um cache do índice semântico com
+fingerprint. Aberturas somente leitura podem reutilizá-lo, mas nunca alteram o
+projeto.
+
+Uma renomeação é sempre inspecionável antes da escrita:
+
+```ruby
+Mxrb.open("app.mpr", readonly: false) do |project|
+  plan = project.plan_rename("Sales.Order", to: "Invoice")
+  plan.changes.each { |change| puts change.inspect }
+  plan.apply!
+end
+```
+
+Na CLI, `mxrb rename app.mpr Sales.Order Invoice` apenas mostra a prévia.
+Acrescente `--apply` para efetivar a alteração.
+
+## Remoção segura
+
+Units independentes, como microflows e páginas, podem ser inspecionadas antes
+da remoção:
+
+```ruby
+Mxrb.open("app.mpr", readonly: false) do |project|
+  plano = project.plan_remove("Sales.FluxoSemUso")
+  plano.apply! if plano.safe?
+end
+```
+
+O plano é bloqueado enquanto houver referências recebidas ou units filhas.
+Elementos embutidos no domínio exigem sua mutação tipada. Na CLI,
+`mxrb remove app.mpr Sales.FluxoSemUso` mostra a prévia e `--apply` só grava
+um plano seguro.
+
+## Movimentação segura no módulo
+
+Units independentes podem ser movidas para um módulo ou pasta sem alterar seu
+nome qualificado nem suas referências:
+
+```ruby
+Mxrb.open("app.mpr", readonly: false) do |project|
+  plano = project.plan_move("Sales.Processar", to: "Sales.Automacao")
+  plano.apply!
+end
+```
+
+O plano preserva o tipo nativo de contenção e bloqueia elementos embutidos do
+domínio, destinos que não são containers, ciclos de pastas e movimentos entre
+módulos. `mxrb move app.mpr Sales.Processar Sales.Automacao` mostra os IDs dos
+containers; `--apply` executa a transação.
+
+## Análise estática
+
+```ruby
+report = Mxrb.open("app.mpr", &:analyze)
+
+report.errors.each { warn _1.message }
+report.unreferenced.each { puts _1.qualified_name }
+report.call_cycles.each { puts _1.artifacts.map(&:qualified_name) }
+report.module_dependencies.each { puts "#{_1.from} -> #{_1.to}" }
+```
+
+Integrações externas desconhecidas geram aviso; um alvo ausente dentro de um
+módulo existente gera erro. Referências `System.*` são reconhecidas como parte
+da plataforma Mendix.
+
+## Diff semântico
+
+```ruby
+result = Mxrb.diff("before.mpr", "after.mpr")
+
+result.added.each { puts _1.path }
+result.removed.each { puts _1.path }
+result.changed.each { puts "#{_1.before} -> #{_1.after}" }
+```
+
+`mxrb diff before.mpr after.mpr` imprime uma mudança tipada por linha, adequada
+para logs e revisão em Git. `mxrb compare` continua compatível com a saída
+textual anterior.
+
+## Navegação
+
+```ruby
+project.search_artifacts("checkout", kind: :microflow)
+project.describe_artifact("Sales.Checkout")
+```
+
+Os comandos equivalentes são `mxrb find`, `mxrb describe` e `mxrb tree`.
+
+## Avaliações de modelo
+
+```ruby
+result = Mxrb.open("app.mpr") do |project|
+  project.evaluate do
+    artifact "Sales.Order", kind: :entity
+    no_call_cycles
+    no_missing_internal_references
+    maximum_unreferenced 20, severity: :warning
+    forbid_dependency from: :Domain, to: :Presentation
+  end
+end
+
+abort result.errors.map(&:message).join("\n") unless result.passed?
+```
+
+Arquivos de avaliação são Ruby comum e rodam com
+`mxrb evaluate app.mpr evaluation.rb`; não existe linguagem de regras paralela.
+
+## Marketplace oficial Mendix
+
+Esta família permanece separada de `mxrb module`, que instala módulos Ruby do
+catálogo interno. O formato entregue é:
+
+```sh
+mxrb marketplace search "Community Commons"
+mxrb marketplace show 170
+mxrb marketplace versions 170 --mendix-version 11.12.1
+mxrb marketplace pull 170 --mpr App.mpr
+mxrb marketplace update 170 --mpr App.mpr
+mxrb marketplace update 170 --mpr App.mpr --apply
+mxrb marketplace remove CommunityCommons --mpr App.mpr
+mxrb marketplace remove CommunityCommons --mpr App.mpr --apply
+mxrb marketplace pull github:mendix/CommunityCommons
+mxrb marketplace import ./CommunityCommons.mpk --mpr App.mpr
+mxrb marketplace login --pat-file .env
+mxrb marketplace audit
+```
+
+Capacidades entregues:
+
+1. API oficial: pesquisar conteúdo público/privado, resolver versões compatíveis,
+   baixar pelo `downloadURL` e auditar vulnerabilidades e atualizações.
+2. GitHub: resolver releases públicas, baixar `.mpk` ou arquivo da release,
+   extrair com proteção contra caminhos inseguros e registrar versão, origem e
+   checksum em lockfile.
+3. MPK local: ler o MPR interno e importar diretamente todas as units e assets
+   no MPR de destino via Ruby/SQLite/BSON, sem ferramentas Mendix.
+4. PAT Mendix: validar e armazenar com permissões restritas, exigindo o escopo
+   `mx:marketplace-content:read` e enviando-o somente ao host oficial da API.
+5. Lifecycle transacional: `update` e `remove` são prévias por padrão, preservam
+   IDs referenciados externamente, recusam assets alterados e protegem MPR,
+   `mprcontents`, cache, lock e assets antes de `--apply` explícito.
+6. Dependências oficiais: `marketplace dependencies` lê referências no MPR
+   interno, resolve recursivamente, confirma a identidade real em cada MPK,
+   reconhece módulos do próprio projeto, instala folhas primeiro e faz rollback.
+7. Export/rebuild autenticado: os grafos Kafka passaram em 10.24 e 11.12, com
+   assets, checksums e diagnósticos fonte/reconstrução preservados.
+8. Frontend oficial: DataWidgets 3.11.3 foi importado com Content ID 116540 e
+   Version ID `e7b6d703-8e47-42f4-bb92-934e3601e71b`; o Combo box é o componente
+   oficial independente Widget/clientModule 219304, versão 2.9.0, Version ID
+   `dce845f4-d051-4161-847c-016c01703caa`. A instalação faz backup e substitui
+   o asset 2.6.x antes pertencente ao Atlas Core (Content ID 117187).
+9. Aceitação reproduzível: `script/frontend_acceptance` bloqueia drift de
+   modelo, assets, checksums ou proveniência do lock/cache/originais. O renderer
+   nativo tem zero achados de preflight na origem e reconstrução das fixtures
+   aceitas de 10.24 e 11.12.
+10. Migração segura: `mxrb frontend migrate App.mpr` mostra a prévia e somente
+    `--apply` grava um plano transacional considerado seguro.
+
+GitHub não cobre módulos sem fonte ou release pública; MPK local continua útil
+como rota offline. A integração oficial usa somente o contrato OpenAPI publicado.
+A trilha de migração está concluída em toda a matriz de frontend suportada. O
+oráculo MxBuild externo e opcional retorna zero erros na origem e reconstrução
+de 10.24 e 11.12; `mx check` também preserva diagnósticos observáveis dos
+pacotes byte a byte em cada round-trip. O MXRB permanece independente: `mx` e
+MxBuild são somente oráculos de validação, nunca geradores, mutadores ou
+dependências de runtime.

data/docs/pt-BR/scaffolds.md

@@ -0,0 +1,104 @@
+# Scaffolds de projeto
+
+**Português** · [English](../en-US/scaffolds.md) · [Deutsch](../de-DE/scaffolds.md)
+
+Todos os comandos aceitam `--target DIR`, recusam sobrescrever arquivos e
+conectam automaticamente os agregadores `evaluate`/`evaluate_dir`. Use
+`mxrb <comando> --help` para ver uso, destino e opções.
+
+`--dry-run` mostra arquivos e agregadores sem gravar; `--json` produz saída
+para automação. `mxrb scaffold list` lista geradores e instâncias registradas.
+`mxrb scaffold destroy <kind:name>` remove somente arquivos que ainda possuem
+o hash criado pelo gerador, protegendo edições posteriores.
+
+| Comando | Resultado principal |
+| --- | --- |
+| `mxrb init App` | Projeto, módulo principal, perfil Responsive e página Home |
+| `mxrb module new Billing` | Novo módulo conectado ao projeto |
+| `mxrb entity new App.Customer` | `domain/entities/customer.rb` |
+| `mxrb enumeration new App.Status` | `domain/enumerations/status.rb` |
+| `mxrb constant new App.ApiUrl` | `domain/constants/api_url.rb` |
+| `mxrb use-case new App.ACT_Create` | `application/use_cases/act_create.rb` |
+| `mxrb validation new App.VAL_Customer` | `application/validations/val_customer.rb` |
+| `mxrb query new App.QRY_Customers` | `application/queries/qry_customers.rb` |
+| `mxrb repository new App.CustomerRepository` | Contrato e adaptador inicial |
+| `mxrb scheduled-event new App.Cleanup` | Evento agendado e microflow |
+| `mxrb presentation init App` | Pastas e agregador de apresentação |
+| `mxrb page new App.CustomerOverview` | Página mínima com layout, título e roles comentados |
+| `mxrb page templates` | Árvore de modelos de página auditados |
+| `mxrb page new App.Dashboard --template dashboard` | Página baseada em modelo |
+| `mxrb page new App.Order --chain page:nanoflow:microflow` | Fatia vertical executável |
+| `mxrb nanoflow new App.NAN_OpenCustomer` | Nanoflow cliente |
+| `mxrb security init App` | Papéis, `CheckEverything` no projeto e orientação de acesso |
+| `mxrb integration new App.PetApi` | Adaptador de integração |
+| `mxrb published-rest new App.CustomersApi` | Handler editável para REST publicado |
+| `mxrb consumed-rest new App.ExternalPets` | Adaptador REST consumido |
+| `mxrb java-action new App.ParseDocument` | Adaptador para Java Action |
+| `mxrb functional-test new App.ACT_Create` | Definição de teste de runtime |
+| `mxrb evaluation new architecture` | Avaliação estática do modelo |
+| `mxrb design init` | Design system do projeto |
+| `mxrb ci init github` | Workflow GitHub Actions |
+
+Entidades começam vazias e apontam para o [guia completo da DSL](entity-dsl.md).
+REST publicado e Java Action geram adaptadores Ruby: o documento/ação nativo
+ainda deve vir do baseline exportado ou do Studio Pro. Os demais itens tipados
+geram diretamente a DSL suportada pelo mxrb.
+
+O gerador cria estrutura e conexão, não inventa regras de negócio. Atributos,
+fluxos, widgets, permissões efetivas, URLs e credenciais continuam sendo
+decisões do projeto. Páginas são esqueletos nativos mínimos; roles e conteúdo
+ficam comentados até serem definidos. `init` cria o perfil Responsive e uma
+página Home mínima para que o scaffold possa ser verificado e compilado
+oficialmente. Outras páginas e itens de menu podem ser escritos na DSL Ruby.
+
+`mxrb page new App.Order --chain ...` transforma o scaffold mínimo de página
+em uma fatia vertical executável: gera entidade de amostra, microflow de data
+source, formulário com campos e ações, página e item no perfil Responsive. Há
+três cadeias de ação Mendix explícitas:
+
+```sh
+mxrb page new App.Order --chain page:microflow
+mxrb page generate App.Order --chain page:nanoflow
+mxrb page g App.Order --chain page:nanoflow:microflow
+```
+
+`page:microflow` chama o Runtime diretamente; `page:nanoflow` mantém a ação no
+cliente; `page:nanoflow:microflow` usa o nanoflow como orquestrador cliente e
+chama o microflow no Runtime. Todas criam `ACT_LoadOrder` para o data source;
+as cadeias que terminam em microflow criam também `ACT_RefreshOrder`. Sem
+`--chain`, `page new` preserva o esqueleto mínimo. `page generate` e `page g`
+são aliases de `page new`. Cada cadeia é materializada em um MPR válido, serve
+como ponto de partida removível e exercita o preflight do compilador; arquivos
+existentes nunca são sobrescritos.
+
+## Modelos de página
+
+No Mendix, page templates são pontos de partida: sua estrutura é copiada para
+uma página comum e editável. O catálogo do MXRB expõe somente padrões que o
+compilador e o Runtime já auditam:
+
+```sh
+mxrb page templates
+mxrb page templates --json
+mxrb page new App.Landing --template starter
+mxrb page new App.Empty --template blank
+mxrb page new App.Operations --template dashboard
+mxrb page new App.Order_NewEdit --template form-vertical
+```
+
+`form-vertical` cria também entidade de amostra e `ACT_Load...` para o DataView.
+Qualquer modelo pode receber `--chain`; por exemplo,
+`--template dashboard --chain page:nanoflow` adiciona a ação cliente ao
+dashboard. Esses nomes são contratos estáveis do MXRB inspirados nos padrões
+Mendix, não uma promessa de importar silenciosamente todo template instalado
+por Atlas ou Marketplace. Veja a [documentação oficial de páginas](https://docs.mendix.com/refguide/pages/).
+
+Para um checkout local durante desenvolvimento:
+
+```sh
+mxrb init VetClinic --mxrb-path /caminho/para/mxrb
+cd VetClinic
+bundle install
+bundle exec mxrb generate project.rb
+bundle exec mxrb validate VetClinic.mpr
+```

data/docs/pt-BR/semantic-refactoring.md

@@ -0,0 +1,55 @@
+# Refatoração semântica
+
+**Português** · [English](../en-US/semantic-refactoring.md) · [Deutsch](../de-DE/semantic-refactoring.md)
+
+O índice semântico combina artefatos tipados e referências BSON.
+`Project.Navigation` participa de impacto, rename e segurança de remoção.
+
+```ruby
+Mxrb.open("Shop.mpr", readonly: false) do |project|
+  plan = project.plan_rename("Sales.Home", to: "Landing")
+  plan.changes.each { puts _1.inspect }
+  plan.apply!
+end
+```
+
+Todo refactoring segue plano, preview e `apply!`. Um rename atualiza BSON e
+`_MxrbArchitecture` na mesma transação. Remove bloqueia referências e unidades
+filhas; move, extract, inline e mutações de domínio expõem mudanças antes de
+gravar.
+
+O analyzer encontra alvos ausentes, perfis sem home, nomes duplicados, user
+roles desconhecidas, homes sem acesso, tokens não resolvidos e contraste
+insuficiente. O cache semântico usa fingerprint das unidades; `mxrb cache
+status`, `warm` e `clear` expõem métricas e manutenção.
+
+`project.semantic_search_artifacts("criar pedido", limit: 5)` oferece ranking
+determinístico em Ruby. A gem opcional `sqlite-vec` acelera a busca em MPRs
+graváveis com um índice KNN identificado por backend, dimensão e fingerprint
+do modelo. A primeira busca preenche os vetores antes de registrar o índice
+como pronto; projetos somente leitura e plataformas sem a extensão mantêm a
+mesma API em memória. A adaptação legada é
+`mxrb find app.mpr "criar pedido" --semantic`. O comando dedicado também
+expõe backend, limite e distância cosseno:
+
+```sh
+bundle exec mxrb search "pagamento" App.mpr
+bundle exec mxrb search "criar pedido" App.mpr --backend onnx --limit 5
+```
+
+O resultado tabular contém rank, distância, nome qualificado e tipo; `--json`
+oferece a mesma informação para automação.
+
+Para desenvolvimento ONNX local, use `BUNDLE_WITH=onnx bundle install`.
+`backend: :onnx` e o backend automático passam a usar o pipeline documentado
+`embedding` do Informers com `sentence-transformers/all-MiniLM-L6-v2`. Um job
+dedicado do CI ativa `MXRB_ONNX=1` e executa smoke test real de 384 dimensões;
+a instalação e a suíte comuns não baixam o modelo.
+
+O smoke test nativo do sqlite-vec usa um arquivo de dependências próprio para
+plataformas suportadas: `BUNDLE_GEMFILE=Gemfile.sqlite-vec bundle install` e
+depois `MXRB_SQLITE_VEC=1 BUNDLE_GEMFILE=Gemfile.sqlite-vec bundle exec rspec
+spec/semantic_search_spec.rb`. Assim o lockfile principal continua portátil,
+mas o CI testa a extensão real.
+
+[Voltar ao índice](README.md)

data/docs/pt-BR/team-server.md

@@ -0,0 +1,59 @@
+# Team Server
+
+O MXRB integra diretamente com o Team Server Git e com a App Repository API.
+Nenhum comando usa `mx`, Studio Pro ou o Model SDK como intermediário.
+
+```bash
+mxrb team-server login --pat-file /caminho/seguro/team-server.env
+mxrb team-server projects --pat-file /caminho/seguro/team-server.env
+mxrb team-server info a9e4af8a-2776-4b10-a471-8c42df8f5f43
+mxrb team-server branches a9e4af8a-2776-4b10-a471-8c42df8f5f43
+mxrb team-server clone \
+  https://git.api.mendix.com/a9e4af8a-2776-4b10-a471-8c42df8f5f43.git \
+  ./app
+mxrb team-server pull ./app
+mxrb team-server push ./app --branch main
+```
+
+`projects` pagina a Projects API oficial e retorna todos os projetos da empresa.
+O cliente preserva o PAT apenas no mesmo host HTTPS e corrige com segurança o
+redirect HTTP anunciado pelo serviço somente quando origem e destino têm o
+mesmo host HSTS.
+
+## Credenciais
+
+O modo recomendado armazena somente o caminho absoluto do arquivo informado em
+`~/.config/mxrb/credentials`. O arquivo pode ser texto puro, JSON com
+`team_server_pat`, ou `.env`:
+
+```dotenv
+MXRB_TEAM_SERVER_PAT=seu_pat
+```
+
+Também é possível definir `MXRB_TEAM_SERVER_PAT_FILE` sem executar `login`.
+Se nenhum arquivo for configurado, operações Git usam o credential helper do
+próprio usuário. A App Repository API exige um arquivo PAT.
+
+O PAT nunca é incluído na URL, nos argumentos do processo ou no `.git/config`.
+Durante operações Git ele é entregue por um `GIT_ASKPASS` temporário, apagado
+imediatamente ao final.
+
+Escopos:
+
+- leitura: `mx:modelrepository:repo:read`;
+- push: `mx:modelrepository:repo:write`.
+
+## Limites oficiais
+
+A Mendix informa que clones feitos fora do Studio Pro não recebem todo o
+pós-processamento e metadados de revisão adicionados pelo Studio Pro. O MXRB
+valida estruturalmente cada MPR após clone e pull, mas commits externos ainda
+podem não conter metadados exigidos pelo deploy no Mendix Cloud. O compilador e
+runtime próprios do MXRB não dependem desses metadados de Cloud.
+
+## Aceitação real
+
+O repositório `a9e4af8a-2776-4b10-a471-8c42df8f5f43` foi consultado pela App
+Repository API e clonado por HTTPS. O MXRB validou `MyFirstModule.mpr`, detectou
+a branch `main` e confirmou que o remote permaneceu sem PAT embutido. O arquivo
+temporário usado na aceitação foi destruído ao final.

data/docs/pt-BR/validation-matrix.md

@@ -0,0 +1,86 @@
+# Matriz de validação do MXRB
+
+**Português** · [English](../en-US/validation-matrix.md) · [Deutsch](../de-DE/validation-matrix.md)
+
+Última atualização: 5 de agosto de 2026.
+
+O pipeline validado é:
+
+```text
+MPR original → validate → export → generate → validate → compare
+```
+
+Os originais nunca são modificados.
+
+| Projeto | Mendix | Formato | Resultado |
+|---|---:|---|---|
+| QueryApiBlogPost | 7.17.0-rc5 | v1 | passou |
+| Sudoku | 11.12.1 | v2 | passou; 409 `.mxunit` |
+| MendixApp | 9.6.1 | v1 | passou |
+| ConnectorKitDemo | 7.5.0 | v1 | passou |
+| TreeviewDemo | 5.21.4 | v1 | passou |
+| GridViewPlayground | 6.10.8 | v1 | passou |
+
+## Cobertura profunda editável
+
+O comparador cobre metadados, segurança, árvore de units, entidades, access
+rules, associações, páginas, widgets, eventos, menus e corpos completos de
+microflows/nanoflows. UUIDs e coordenadas visuais são normalizados.
+
+Os 264 corpos de flows da matriz são emitidos como Ruby tipado. As 133 páginas
+contêm 1.304 nós de 25 tipos; estruturas profundas permanecem hashes Ruby
+editáveis. Toda unit nativa mantém o baseline JSON e também é expandida em
+`.mxrb/native_units.rb`, inclusive conteúdo sem DSL concisa.
+
+## Validação oficial 11.12.1
+
+- `mx show-version` reconheceu o MPR reconstruído;
+- `mx check` terminou com **0 erros**;
+- original e reconstruído: **23 warnings, 1 depreciação e 6 recomendações**;
+- `mxbuild --target=package`: **BUILD SUCCEEDED**;
+- MDA atual: 11.941.148 bytes, SHA-256
+  `fc4fb7a2ea2b4ad7cdb0fcd3296a5dbb5c4d148371aad997ab0032d2c5c0cf33`.
+
+## Validação oficial Mendix 5–9
+
+O projeto 6.10 gerou MDA no original e reconstruído. As versões 7.5 e 7.17
+chegaram à compilação Java com os mesmos erros de dependências dos originais.
+O 9.6.1 manteve paridade de 896 diagnósticos. O 5.21 exato depende de WPF e
+Windows; sua paridade foi verificada pelo conversor oficial 6.10 em memória.
+
+## Limite de confiança
+
+A matriz prova os cenários inspecionados, não compatibilidade universal com
+todo metamodelo Mendix. Encodings `.mxunit` desconhecidos são rejeitados em vez
+de adivinhados. A validação exata do 5.21 em Studio Pro/Windows continua sendo
+um limite explícito.
+
+## Índice semântico
+
+Os seis MPRs produziram **1.778 artefatos** e **3.387 referências**. Consultas
+de referências, callers, callees, impacto, lint e diff tipado foram exercitadas
+sem MDL.
+
+## Avaliações, cobertura e runtime
+
+- 1.039 exemplos, zero falhas;
+- 100% das linhas: 17.224/17.224;
+- 100% dos branches: 6.811/6.811;
+- avaliação Sudoku: 7/7 checks;
+- testes funcionais Sudoku: 3/3 localmente em 34,16 s;
+- testes funcionais Sudoku: 3/3 no Docker em 39,52 s.
+
+Asserções Ruby verificam retorno e contagens XPath persistidas: Games 1/2/3 e
+Cells 81/162/243. JUnit XML é apenas relatório opcional gerado em Ruby.
+
+O gate 11.12.1 agora inclui navegador Chromium autenticado: login, navegação
+Home/Orders, captura determinística de DOM/layout/estilo/ARIA, screenshots,
+comparação SHA-256 com baseline explícito, detecção de erros de widget/Runtime
+e logout real. Os scaffolds `page --chain` também materializam e passam
+preflight nos três caminhos suportados; `page --template` foi exercitado em
+Runtime para dashboard e formulário vertical com CSS computado auditado.
+
+`script/validate_matrix` repetiu os seis round-trips, 1.506 units, em 14,760 s.
+`script/benchmark` mediu o pipeline Sudoku completo em 6,8463 s. O fuzzing
+determinístico cobre 250 documentos BSON aninhados e 50 arquivos `.mxunit`
+atômicos, inclusive valores binários.

data/docs/pt-BR/vetclinic-acceptance.md

@@ -0,0 +1,50 @@
+# Aceitação end-to-end do VetClinic
+
+O projeto de aceitação foi removido e recriado do zero com `mxrb init`. Todos
+os geradores foram exercitados antes do preenchimento das regras de negócio:
+entidades, enumerações, use cases, validações, queries, repository, constante,
+scheduled event, apresentação, página, nanoflow, segurança, integrações, REST,
+Java Action, design, CI, teste funcional e avaliação arquitetural.
+
+## Resultado dos gates
+
+- validação estrutural MXRB: aprovada;
+- lint semântico: 0 erros e 0 avisos;
+- avaliação arquitetural: 100%;
+- `mx check` oficial Mendix 11.12.1: 0 erros;
+- `mxbuild`: build concluído e pacote MDA gerado;
+- Runtime Mendix sincronizado: teste funcional `ACT_CreateAnimal` aprovado;
+- regressão do MXRB: 622 exemplos, 0 falhas;
+- cobertura: 100% de linhas e 100% de branches;
+- RuboCop: 0 infrações.
+
+O modelo cobre enumerações, seis entidades de negócio, generalização de
+`System.User`, membros de sistema, regras de acesso, índices simples e
+compostos, associações N:1, N:N e 1:1, microflows, nanoflow, página, navegação e
+scheduled event.
+
+## Trabalho que continua intencionalmente manual
+
+Scaffold é estrutura, não especificação de negócio. Foi necessário escrever
+atributos, regras, ações dos fluxos, valores de enumeração, permissões, teste e
+avaliação. O VetClinic original teve a navegação conectada no `project.rb`;
+depois desse aceite, `init` passou a criar perfil, layout e Home mínimos. Itens
+de menu adicionais ainda não têm comando próprio. Página, integrações e
+endpoints também exigem conteúdo real.
+
+`published-rest`, `consumed-rest` e `java-action` produzem adaptadores de
+microflow compiláveis. Um documento REST publicado/consumido ou Java Action
+nativo ainda requer um baseline exportado ou Studio Pro. Isso não impede a
+validade e o build do MPR aceito, mas delimita honestamente o alcance atual
+desses três scaffolds.
+
+## Correções orientadas pelo aceite
+
+O ciclo oficial revelou e corrigiu serialização moderna de projeto, módulo,
+domain model, entidades, atributos, enumerações, associações, acesso, índices,
+navegação, páginas, flows, scheduled events e textos; também corrigiu colisão
+entre artefatos homônimos, referências de enum, role administrativa mínima,
+cache/índice semântico e marcação de entry points. O writer passou a partir de
+um seed oficial versionado e preserva os metadados obrigatórios do Mendix.
+Um smoke test independente confirmou que o scaffold vazio atual também passa
+em `mx check` e MxBuild sem edição manual.