@praxisui/dynamic-form 10.0.0-rc.40 → 10.0.0-rc.42

package/README.md

@@ -747,13 +747,87 @@ das abas. Acima desse limite, reaparece a navegação por abas. O Settings Panel
 organiza título, expandir e fechar em uma grade até 599px; a prévia, quando
 suportada, ocupa a linha seguinte. Nenhum documento ou protocolo de Save é alterado.
 
+### Filhos de páginas governadas
+
+Consulte [o adapter nativo de página](docs/governed-page-widget-adapter.md) para reconstrução sem defaults, presença exata, identidade derivada e execução sem preferências concorrentes.
+
+### Schema-backed custom fields
+
+Core expands an object marked `x-ui.customFieldsContainer: true` (or the inline
+`customFields` object) into fields named `customFields.<key>`. Dynamic Form uses
+those names as nested reactive-form paths and keeps the wire payload nested:
+`{ "customFields": { "numero_calcado": 38, "data_exame": "2026-10-27" } }`.
+The `customField`, `customFieldKey` and `customFieldScope` metadata identifies
+schema-backed fields; it does not make them local/transient authoring fields.
+Saved containers colliding with the server's expanded namespace are replaced by
+its direct children, including a container previously marked `source: 'local'`.
+Noncolliding local fields and existing child placement remain. Restrictive parent
+flags remain restrictive in children; they do not create a submit omission policy.
+
+Date controls hydrate nested API values without mutating the input. Submit applies
+the same date/lookup serialization, required/dirty handling and omission policies
+to flat and dotted names. Missing nested values do not create containers. Filter
+Form preserves supported nested values during same-context metadata rebuilds,
+unless the new field has an explicit default (reset). A removed server field can
+remain as metadata for layout continuity, but becomes disabled and omitted from
+applicable payloads. Hidden alone is not omission: explicit local and legitimate
+hidden fields keep their published semantics. No host adapter is needed for the
+supported nested value paths.
+
+Temporal normalization is metadata-aware: legacy date tuples and local datetime
+strings are transformed only on declared temporal fields, including collection
+item schemas. Numeric/unknown arrays such as `[2026, 10, 27]` remain arrays;
+ordinary/unknown strings retain their spaces and date-like text. The `DateInput`
+control follows date-only serialization. A same-context metadata rebuild can
+restore nested dirty/touched control paths, including collection items, without
+marking unrelated controls touched. This does not preserve a draft across every
+reset, identity switch or retry.
+
+Scalar arrays use the operation schema's `fieldMetadata[].items`, separately
+from object collections' `array.itemSchema.fields`. Core's shared normalizer turns
+valid UI tokens into declared strings, safe integers, finite numbers or exact
+booleans and enforces the item enum after conversion. Date/date-time item formats
+use that same contract. An invalid/null item rejects the entire projection rather
+than silently dropping it; an optional null container and an empty array remain
+distinct valid inputs. Form validation and prepared submit must agree, so a token
+such as `12.5` cannot be submitted as an integer. This subset does not promise
+integer precision beyond JavaScript's safe range or an object-array editor.
+
+Record paths do not traverse array intermediates in computed-rule contexts;
+collection submit uses its own item-schema pipeline. The canonical Metadata key
+policy rejects reserved control names such as `constructor`, `toString` and
+`hasOwnProperty`; payload helper support does not relax that policy. Existing
+stored definitions with such keys require a backend migration.
+
+Read-only/disabled does not automatically mean omission from `getRawValue()`.
+The canonical backend command request projection excludes read-only custom fields
+from properties and required, while response schemas retain them for display.
+Use the exact operation request schema; merging response fields into commands or
+adding an unimplemented `x-ui.submitPolicy` adapter would break that boundary.
+Reconciliation treats a successful empty schema as authoritative. Removed
+server-backed fields become hidden, disabled and `submitPolicy: 'omit'`, including
+manual sync and Filter; explicit local fields remain local. Reappearance restores
+the current server constraints rather than stale saved required/type/enum/items.
+
+Each fresh schema-loading cycle revalidates HTTP and normalizes its body; compiled
+L1 is not a readiness shortcut. A matching 304 can reuse the cached representation.
+Status 0, denied access, malformed schema and failed saved-config reconciliation
+cannot make the old form ready. Authorization errors show access feedback without
+a generic retry action; timeout/transport failures retain their retry surface.
+Schema loading/error or a known unconfirmed enterprise context blocks submit.
+Context changes cancel obsolete reads, revalidate metadata and invalidate the old
+initial-value seed; retry is not a general cross-context autosave guarantee.
+
+The confirmed enterprise context supplies effective tenant/locale and context
+version. Explicit schema URLs conflicting with that context are rejected. Identity
+visible only to cookies/interceptors still requires a captured context version or
+complete cache/session invalidation by the host; backend authorization is always
+required. See the [enterprise review](https://github.com/codexrodrigues/praxis-ui-angular/pull/658)
+for source, candidate gates, host proof and remaining adoption limits.
+
 <!-- praxis-npm-catalog-links:start -->
 ## Official documentation and examples
 
 - [Canonical technical overview: Overview](https://praxisui.dev/docs/components/praxis-dynamic-form)
 - [Praxis Angular public catalog](https://praxisui.dev/angular)
 <!-- praxis-npm-catalog-links:end -->
-
-### Filhos de páginas governadas
-
-Consulte [o adapter nativo de página](docs/governed-page-widget-adapter.md) para reconstrução sem defaults, presença exata, identidade derivada e execução sem preferências concorrentes.

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-10-26T18:09:20.136Z",
+  "generatedAt": "2026-11-01T13:59:56.156Z",
   "packageName": "@praxisui/dynamic-form",
-  "packageVersion": "10.0.0-rc.40",
+  "packageVersion": "10.0.0-rc.42",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,
@@ -71,11 +71,23 @@
         },
         {
           "name": "schemaSource",
-          "type": "'resource' | 'filter'",
+          "type": "'resource' | 'filter' | 'action'",
           "required": false,
           "description": "Fonte do schema de campos",
           "default": "resource"
         },
+        {
+          "name": "actionId",
+          "type": "string | null",
+          "required": false,
+          "description": "Identificador canônico da ação de workflow ou comando governado associado ao formulário"
+        },
+        {
+          "name": "operationId",
+          "type": "string | null",
+          "required": false,
+          "description": "OperationId canônico publicado pelo catálogo de ações ou surfaces para execução do comando"
+        },
         {
           "name": "schemaUrl",
           "type": "string | null",
@@ -9418,9 +9430,9 @@
         {
           "chunkIndex": 0,
           "chunkKind": "summary",
-          "content": "Component ID: praxis-dynamic-form\nSelector: praxis-dynamic-form\nFriendly Name: Praxis Dynamic Form\nDescription: Formulario dinamico com layout por secoes/linhas/colunas e campos renderizados por metadados.\nCategory: form\nLib/Package: @praxisui/dynamic-form\nTags: widget, form, configurable, hasWizard, stable\nInputs:\n  - resourcePath (string)\n  - resourceId (string | number | null)\n  - initialValue (Record<string, unknown> | null)\n  - emptyState (PraxisDynamicFormEmptyState | null)\n  - editorialContext (Record<string, unknown> | null)\n  - mode ('create' | 'edit' | 'view' | 'presentation' | 'dossier')\n  - config (FormConfig)\n  - actions (FormConfig['actions'] | null)\n  - schemaSource ('resource' | 'filter')\n  - schemaUrl (string | null)\n  - readUrl (string | null)\n  - apiEndpointKey (ApiEndpoint | string | null)\n  - apiUrlEntry (ApiUrlEntry | null)\n  - submitUrl (string | null)\n  - submitMethod ('post' | 'put' | 'patch' | null)\n  - submitIdempotencyKey (string | null)\n  - submitCorrelationId (string | null)\n  - submitResourceVersion (string | number | null)\n  - submitResourceVersionTargetResourceKey (string | null)\n  - submitResourceVersionTargetIdField (string | null)\n  - responseSchemaUrl (string | null)\n  - enableCustomization (boolean)\n  - showAiAssistant (boolean)\n  - formId (string)\n  - componentInstanceId (string)\n  - configPersistenceStrategy ('local-first' | 'input-first' | 'volatile')\n  - layout (FormLayout)\n  - generatedLayoutPreset ('default' | 'compactPresentation')\n  - layoutPolicy (DynamicFormLayoutPolicy | null)\n  - backConfig (BackConfig)\n  - hooks (FormHooksLayout)\n  - removeEmptyContainersOnSave (boolean)\n  - reactiveValidation (boolean | null)\n  - reactiveValidationDebounceMs (number | null)\n  - notifyIfOutdated ('inline' | 'snackbar' | 'both' | 'none')\n  - snoozeMs (number)\n  - autoOpenSettingsOnOutdated (boolean)\n  - readonlyModeGlobal (boolean | null)\n  - disabledModeGlobal (boolean | null)\n  - presentation (DynamicFormPresentationSnapshot | null)\n  - presentationPreset (FormPresentationPreset)\n  - presentationModeGlobal (boolean | null)\n  - fieldIconPolicy ('all' | 'presentation-only' | 'none')\n  - visibleGlobal (boolean | null)\n  - customEndpoints (EndpointConfig)\nOutputs:\n  - formSubmit (FormSubmitEvent)\n  - formCancel (void)\n  - formReset (void)\n  - configChange (FormConfig)\n  - configPatchChange (DynamicFormConfigPatchChangeEvent)\n  - formReady (FormReadyEvent)\n  - valueChange (FormValueChangeEvent)\n  - payloadPreviewChange (FormPayloadPreviewEvent)\n  - syncCompleted (SyncResult)\n  - initializationError (FormInitializationError)\n  - enableCustomizationChange (boolean)\n  - customAction (FormCustomActionEvent)\n  - actionConfirmation (FormActionConfirmationEvent)\n  - schemaStatusChange ({ outdated: boolean; serverHash?: string; lastVerifiedAt?: string; formId?: string })\n  - reactiveDeterminationExecuted (ReactiveDeterminationExecutionEvent)\n  - reactiveDeterminationPendingChange (boolean)\n",
+          "content": "Component ID: praxis-dynamic-form\nSelector: praxis-dynamic-form\nFriendly Name: Praxis Dynamic Form\nDescription: Formulario dinamico com layout por secoes/linhas/colunas e campos renderizados por metadados.\nCategory: form\nLib/Package: @praxisui/dynamic-form\nTags: widget, form, configurable, hasWizard, stable\nInputs:\n  - resourcePath (string)\n  - resourceId (string | number | null)\n  - initialValue (Record<string, unknown> | null)\n  - emptyState (PraxisDynamicFormEmptyState | null)\n  - editorialContext (Record<string, unknown> | null)\n  - mode ('create' | 'edit' | 'view' | 'presentation' | 'dossier')\n  - config (FormConfig)\n  - actions (FormConfig['actions'] | null)\n  - schemaSource ('resource' | 'filter' | 'action')\n  - actionId (string | null)\n  - operationId (string | null)\n  - schemaUrl (string | null)\n  - readUrl (string | null)\n  - apiEndpointKey (ApiEndpoint | string | null)\n  - apiUrlEntry (ApiUrlEntry | null)\n  - submitUrl (string | null)\n  - submitMethod ('post' | 'put' | 'patch' | null)\n  - submitIdempotencyKey (string | null)\n  - submitCorrelationId (string | null)\n  - submitResourceVersion (string | number | null)\n  - submitResourceVersionTargetResourceKey (string | null)\n  - submitResourceVersionTargetIdField (string | null)\n  - responseSchemaUrl (string | null)\n  - enableCustomization (boolean)\n  - showAiAssistant (boolean)\n  - formId (string)\n  - componentInstanceId (string)\n  - configPersistenceStrategy ('local-first' | 'input-first' | 'volatile')\n  - layout (FormLayout)\n  - generatedLayoutPreset ('default' | 'compactPresentation')\n  - layoutPolicy (DynamicFormLayoutPolicy | null)\n  - backConfig (BackConfig)\n  - hooks (FormHooksLayout)\n  - removeEmptyContainersOnSave (boolean)\n  - reactiveValidation (boolean | null)\n  - reactiveValidationDebounceMs (number | null)\n  - notifyIfOutdated ('inline' | 'snackbar' | 'both' | 'none')\n  - snoozeMs (number)\n  - autoOpenSettingsOnOutdated (boolean)\n  - readonlyModeGlobal (boolean | null)\n  - disabledModeGlobal (boolean | null)\n  - presentation (DynamicFormPresentationSnapshot | null)\n  - presentationPreset (FormPresentationPreset)\n  - presentationModeGlobal (boolean | null)\n  - fieldIconPolicy ('all' | 'presentation-only' | 'none')\n  - visibleGlobal (boolean | null)\n  - customEndpoints (EndpointConfig)\nOutputs:\n  - formSubmit (FormSubmitEvent)\n  - formCancel (void)\n  - formReset (void)\n  - configChange (FormConfig)\n  - configPatchChange (DynamicFormConfigPatchChangeEvent)\n  - formReady (FormReadyEvent)\n  - valueChange (FormValueChangeEvent)\n  - payloadPreviewChange (FormPayloadPreviewEvent)\n  - syncCompleted (SyncResult)\n  - initializationError (FormInitializationError)\n  - enableCustomizationChange (boolean)\n  - customAction (FormCustomActionEvent)\n  - actionConfirmation (FormActionConfirmationEvent)\n  - schemaStatusChange ({ outdated: boolean; serverHash?: string; lastVerifiedAt?: string; formId?: string })\n  - reactiveDeterminationExecuted (ReactiveDeterminationExecutionEvent)\n  - reactiveDeterminationPendingChange (boolean)\n",
           "sourcePointer": "projects/praxis-dynamic-form/src/lib/praxis-dynamic-form.metadata.ts",
-          "contentHash": "c23522b0ae4de2b4f759620ac16675455e6d0fe9e97b630e7248b82a8a3d463c",
+          "contentHash": "97e0c3da46840798955442e4cb38ad5e4946c2fa4f5eb841b85182993a83a59e",
           "sourceKind": "component_definition",
           "sourceId": "praxis-dynamic-form",
           "corpusVersion": "1.0.0"

package/docs/custom-fields-enterprise-review.md

@@ -0,0 +1,229 @@
+---
+title: "Custom fields: revisão de adoção corporativa"
+slug: "dynamic-form-custom-fields-enterprise-review"
+description: "Registro de achados, fontes, provas e pendências da adoção de custom fields no Core e Dynamic Form."
+doc_type: "reference"
+document_kind: "governance-reference"
+component: "dynamic-form"
+category: "architecture"
+audience:
+  - "frontend"
+  - "host"
+  - "architect"
+  - "platform-team"
+level: "advanced"
+status: "active"
+owner: "praxis-ui"
+last_updated: "2026-10-27"
+toc: true
+sidebar: false
+source_of_truth:
+  - "projects/praxis-core/src/lib/services/schema-normalization-kernel.ts"
+  - "projects/praxis-core/src/lib/models/form/materialize-custom-fields-layout.ts"
+  - "projects/praxis-core/src/lib/services/dynamic-form.service.ts"
+  - "projects/praxis-core/src/lib/schema/schema-metadata-client.ts"
+  - "projects/praxis-core/src/lib/services/generic-crud.service.ts"
+  - "projects/praxis-dynamic-form/src/lib/praxis-dynamic-form.ts"
+  - "projects/praxis-dynamic-form/src/lib/utils/prepare-submit-payload.ts"
+  - "projects/praxis-dynamic-form/src/lib/services/form-rules.service.ts"
+---
+
+# Custom fields: revisão de adoção corporativa
+
+## Escopo e baseline
+
+A [Issue 657](https://github.com/codexrodrigues/praxis-ui-angular/issues/657) e o
+[PR 658](https://github.com/codexrodrigues/praxis-ui-angular/pull/658) materializam
+custom fields no runtime oficial. A revisão atual parte de Angular `48b004c9e` e
+Metadata `368d96266b`. Os PRs 658/304 permanecem sem merge. A revisão da fonte e os gates focais desta rodada estão concluídos, com as
+exceções preexistentes e pendências downstream registradas abaixo. Fonte candidata e provas
+não certificam publicação, deploy, release ou adoção corporativa irrestrita.
+
+A revisão anterior partiu de Angular `6598ef221f0708c6628b02380c0e27110fa4a1ae`
+e skills `59c64169fe062de69c83b886c75b681d4e7ee967`; seus achados motivaram esta
+rodada. O backend é dono da definição, autorização e validação. Core projeta,
+reconcilia e transporta; Form/Table materializam controles e payloads. A landing
+publica essa fonte, e não uma semântica alternativa.
+
+Classificação: `contrato-publico`, com correções de semântica já suportada e mal
+materializada em Core/Form/Table e alinhamento canônico backend. Consumidores:
+Form schema-driven/salvo, Filter standalone/integrado/avançado, discovery e
+GenericCrud. Derivados: READMEs, JSON API, dois guias Table, vendor docs da landing
+e skills existentes. Não há nova rota pública para este relatório, nem alteração
+de endpoint, corpus HTTP ou recipe pela documentação.
+
+## Achados, tratamento e fontes
+
+| Cenário / origem | Correção na fonte candidata | Gate / limite |
+| --- | --- | --- |
+| Container salvo ou local colidente substituía filhos e podia perder a subárvore no payload. | `materialize-custom-fields-layout`, reconciliadores e sync migram pai direto para filhos schema-backed, preservando posições, rich content e locais não colidentes; diagnostics persistem a correção. | Integração normalizer/reconcile/FormGroup/submit nos três caminhos; não transferir omit/defaults/validadores escalares do pai. |
+| Restrições e identidade eram relaxadas por metadata antiga. | Pisos disabled/readOnly/formHidden do container; identidade customField/key/scope e constraints items/enum server-owned. FieldAccess ausente é herdado; policies equivalentes por sets são aceitas, conflito exige policy leaf efetiva do backend. | Conflito de normalização bloqueia inicialização, incluindo configuração salva; listas OR não implementam AND arbitrário. |
+| Cache/deduplicação/replay e getters podiam cruzar tenant, autenticação ou recurso por chamada. | `schema-request-key`, `schema-request-context`, `schema-fetch`, SchemaMetadataClient, GenericCrud e Discovery capturam contexto/headers, isolam representação e deduplicam só trabalho em andamento. GenericCrud só publica derivados do recurso configurado; callbacks obsoletos não publicam. | Snapshot antes de await/subscription e retry304 igual; provider/hook/aliases inválidos falham antes do request. Getters singleton não são mapa de resultados por chamada. |
+| L1, cache status0 ou configuração salva podiam parecer schema autorizado atual. | Novo ciclo HTTP revalida e normaliza; L1 compilado não estabelece readiness. Corpo cacheado só após 304 correspondente; status0/401/403/normalização inválida não recuperam silenciosamente o form. | Sem modo offline. Discovery não usa resumo do catálogo ou schema response para substituir request vazio/negado. Fallback de indisponibilidade conhecido só nas trilhas equivalentes já suportadas. |
+| Remover o último campo gerava defs=[] ignorado; sync/filter conservavam órfãos aplicáveis/required. | Schema vazio bem-sucedido é autoritativo. Reconcile Form/Filter e sync manual marcam órfãos não locais hidden+disabled+omit; reaparecimento usa required/type/items/enum atuais. | Hidden legítimo e `source: local` explícito conservam sua semântica; raw draft pode manter diagnóstico, mas não é payload aplicável. |
+| Request publicava read-only que o backend recusava; nomes admitidos colidiam com controles. | Metadata PR304 exclui read-only de comando properties/required e mantém leitura/filtro apropriados; política de chaves rejeita nomes reservados exatos. | Consumir schema da operação; não mesclar response em comando nem inventar x-ui.submitPolicy local. Definições antigas exigem migração explícita. |
+| Arrays IN/enum perdiam tipo e diferentes fronteiras emitiam valores incompatíveis. | FieldDefinition/Metadata `items: FieldScalarItemsSchema`; parser Core único `normalizeScalarArrayValue`, validators e projeção Form/Table. Modal Apply/Save usa payload do child; merge de shortcut reprojeta omit. | Rejeição inteira de item inválido/null, sem descarte parcial; bloqueio pending/invalid inclui debounce anterior. Zero filtros ativos DISABLED permite limpar. |
+| Regras computed liam alias pontuado antigo. | Contexto JSON Logic aninhado via helper interno; `fieldValues` continua mapa plano de target IDs. | Cadeia em ordem inversa, condições true/false e imutabilidade. Arrays intermediários não são record paths suportados. |
+| Heurística temporal alterava strings e arrays numéricos; rebuild perdia estado aninhado. | Normalização metadata-aware de datas e item schemas, DateInput date-only e snapshot dirty/touched por leaf/FormArray. Campos planos escrevem draft privado, sem clone raiz por campo. | Arrays numéricos/unknown e strings não temporais preservados; não é autosave entre contextos/resets. |
+| Erro de acesso parecia conexão/retry e submit podia usar estado não pronto. | Form distingue acesso, contexto não confirmado, projeção inválida e transporte. Loading/erro/known nonready bloqueiam submit; preview scalar inválido emite formData:null/isValid:false com raw intacto. | 401/403 não oferecem retry genérico. Troca confirmada invalida seed anterior e revalida; não restaura draft de outro tenant. |
+
+## Contratos e limites ainda exigidos do host
+
+A fonte backend inspecionada é o candidato PR304, docs em `99b75a2dde`:
+[spec canônica](https://github.com/codexrodrigues/praxis-metadata-starter/blob/99b75a2dde/docs/spec/custom-fields-and-resource-facts.md).
+A política rejeita exatamente `constructor`, `prototype`, `hasOwnProperty`,
+`isPrototypeOf`, `propertyIsEnumerable`, `toLocaleString`, `toString` e `valueOf`,
+com comparação sensível a maiúsculas. `__proto__` já é inválido pelo formato da
+chave. Não corrigir dados antigos com aliases silenciosos de frontend.
+
+Read-only/disabled/hidden não significam omissão universal. Na escrita, a projeção
+canônica exclui custom fields read-only; filtros podem mantê-los como operandos de
+busca e respostas como leitura. Campos contextuais legítimos continuam sujeitos
+ao contrato da operação. `rawFormData`/`getRawValue()` são diagnósticos, não uma
+instrução para ignorar o payload projetado.
+
+A chave de representação usa URL real, identidade semântica e tenant/locale
+capturados; headers adicionais selecionam um token opaco por sessão/página.
+O lookup de headers é limitado e fica só em memória: credenciais/fingerprints não
+são persistidos em chaves ou metadata. Isso não redige corpos arbitrários do
+servidor. Contexto enterprise confirmado fornece tenant/locale/version; GenericCrud,
+Discovery e Form bloqueiam um snapshot conhecido não pronto. O cliente standalone
+SchemaMetadataClient captura o hook e não descobre o serviço DI por conta própria. Parâmetros explícitos conflitantes falham.
+
+Cookies/interceptors que alterem identidade depois do snapshot não são observáveis
+pelo cache. O host precisa materializar a versão confirmada nos headers capturados
+ou invalidar todo o escopo de cache/sessão; recriar somente um cliente sobre o
+mesmo armazenamento não basta. Tenant nunca substitui autorização por principal.
+GenericCrud mantém getters do recurso configurado: overrides por chamada devolvem
+seus resultados, sem transformar esses getters em uma API multiscope.
+
+Scalar `items` cobre string/integer/number/boolean e formatos date/date-time
+suportados. Inteiros precisam ser seguros no JavaScript; números finitos seguem
+sintaxe JSON e booleans são exatos. Enum é aplicado depois da conversão. `null`
+container/ausente e `[]` não equivalem a item null; required continua independente.
+Não anunciar arbitrary JSON Schema items, editor object-array, precisão int64 ou
+record paths de regras através de arrays intermediários.
+
+## UX e progresso
+
+| Situação | Comportamento / limite comunicável |
+| --- | --- |
+| Schema loading, timeout e transporte | SchemaMetadataClient aplica deadline; leituras supersedidas são canceladas. Falha recuperável oferece retry. Não é modo offline ou promessa de recuperar todo rascunho. |
+| Acesso negado ou contexto não confirmado | Form não monta controles cacheados como prontos nem permite submit; acesso tem feedback próprio sem retry genérico. Recuperação depende de contexto/autorização do host. |
+| Config salva, defs vazias ou projeção inválida | Vazio bem-sucedido reconcilia; erro não mantém configuração antiga pronta. FieldAccess conflitante é erro de metadata, não autorização alternativa de host. |
+| Troca de tenant/registro | Cancela geração antiga, invalida seed anterior e revalida. Não comunica continuidade de dados entre identidades. |
+| Campo removido/reaparecido | Órfão server-backed pode manter metadata/layout/raw diagnóstico, mas fica disabled/omit. Ao voltar usa constraints do schema atual. |
+| Rebuild do filtro | Valores suportados do mesmo contexto podem ser restaurados; default explícito pode resetar. Hidden/local legítimo não é removido por uma política genérica. |
+| Valor scalar inválido | Permanece corrigível no raw/control com feedback; nenhuma emissão aplicável/submit/shortcut ou preview com formData utilizável. |
+| Narrow viewport | Ações/labels devem permanecer acessíveis por scroll sem overflow horizontal. Densidade da toolbar não prova campo acima da dobra ou conformidade de teclado/AXE. |
+
+## Evidências da rodada atual
+
+- Core: 471 casos distintos na campanha atual. Quatro falhas de fixture/guard foram
+  corrigidas; rerun focal de contexto/discovery 61/61 aprovado. Não somar 471+61.
+- Comandos de build Core e Form com closure de 13 libs aprovados. Core precedeu
+  o último guard; a closure final Form recompilou Core/Form/Table e cobre a fonte
+  final de produção. Pureza e MatSelect zero-debt também passaram.
+- Form: 406 casos distintos aprovados, com rerun focal das três fixtures
+  corrigidas. Deltas posteriores ao build são apenas testes.
+- Browser: seis casos distintos aprovados (quatro Form e dois Table). Os quatro
+  Form cobrem editor desktop/resize, abertura narrow inicial, warm-cache seguido
+  de403 e formulário público scalar/enum. O último caso passou em rerun após
+  corrigir uma corrida do teste ao observar a ação ficar disabled. Table cobre
+  toolbar/gerenciador de campos/avançado/modal, sem prova de query IN por browser.
+- Table: **224/224 aprovados** após o alinhamento das quatro fixtures year/month
+  ao contrato introduzido em `6de618805`. O runtime e o registry preservam
+  inlineYearRange/inlineMonthRange como wrappers numéricos; não são aliases de
+  inlinePeriodRange. Os testes agora verificam IDs, modo range, imutabilidade,
+  hidratação em controle real e payload numérico no submit. O resultado anterior
+  220/224 é histórico e foi substituído pela execução focal completa aprovada.
+- Dynamic Fields: **10/10 aprovados** nos componentes inline-year-range,
+  inline-month-range e inline-period-range. A prova distingue limites numéricos
+  de identificadores de períodos, sem alterar a semântica de produção.
+- Quickstart: revisão cruzada confirmou 25 casos distintos sem falha no candidato
+  backend e a prova HTTP Neon coordenada no trabalho backend. Três pilotos
+  históricos (EventosFolha, MetadataMigration e OpenApiGroupResolution), além do
+  verify integral e do pin de artefato público, permanecem pendentes no Draft482;
+  não inferir adoção completa a partir do piloto. Fontes brutas e fingerprint estão no registro
+  backend `docs/technical/ISSUE-303-EXECUTION.md` e no PR304.
+- Frontmatter incremental dos documentos desta rodada validado. Skills867
+  publicado em `d351c44`; landing docs no PR270 em `cfc0212`. Validação canônica
+  de skills e gates documentais aprovados. O fechamento documental corrigiu também as
+  cinco cópias vendor antigas: List, Metadata Editor, Page Builder, Table API e
+  Visual Builder. Os dois guias Dynamic Fields foram alinhados ao contrato de
+  ranges; o link prospectivo do Page Builder aponta à fonte GitHub existente.
+  Full vendor freshness passou para os 75 documentos, assim como docs25,
+  published-guides146 e sitemap. Nenhuma sincronização instalada ou merge.
+
+A E2E ampliada `surface-open-form-demo.playwright.spec.ts` cobre o editor,
+abertura narrow inicial, leitura autorizada seguida de403 sem reaproveitar
+campos prontos, e formulário público com items/enum, bloqueio de token inválido e
+submit nested tipado. Esses casos passaram na execução final e usam
+schema/HTTP mockado; não substituem prova backend Neon. Não há prova AXE,
+teclado completo, tema claro, filtro IN por browser ou persistência real pelo E2E.
+
+A coordenação inspecionou screenshots desktop e narrow estabilizados: labels e
+quadros acessíveis, sem overflow horizontal; a toolbar estreita continua densa e
+o campo pode exigir scroll. O rerun Playwright pode limpar `test-results`, então
+este registro não publica links para screenshots transitórios. Logs em
+`/tmp/praxis-658-e2e-form-final.log`, `praxis-658-e2e-scalar-rerun.log` e
+`praxis-658-e2e-table-final.log` pertencem à campanha local coordenada.
+
+O receipt `/tmp/praxis-658-source-freeze.json` vincula as provas à árvore de
+44 arquivos fonte/teste alterados contra48b004, fingerprint SHA256
+`f99a2bdde6f3fa9f05cd56025e1d375c24c6bcffa2fef5e541e155d6c2650bda`.
+O lockfile não mudou. O commit Angular final é registrado no PR658 após o freeze
+documental; o fingerprint distingue a fonte validada das edições de relatório.
+
+## Evidência histórica anterior
+
+A rodada anterior passou 313 casos Core distintos (311+duas novas em rerun70),
+324 Form e build closure13. Um E2E mockado passou em1280×720 e após resize390×844,
+com screenshots finais inspecionados pela coordenação: sem overflow, tabs para
+select, ações sticky e campo narrow atingível por scroll, abaixo da dobra. Essa
+execução não cobria abertura narrow inicial nem submit real. Capturas ignoradas
+pelo Git em `test-results/surface-open-form-demo.pla-6e87b-the-employee-drawer-surface-chromium/`.
+Esses resultados não são somados aos gates da árvore atual.
+
+## Publicação e guidance
+
+O [PR skills867](https://github.com/codexrodrigues/praxis-codex-skills/pull/867)
+pertence ao incremento Angular Core/Form/Table; o
+[PR skills868](https://github.com/codexrodrigues/praxis-codex-skills/pull/868)
+pertence ao backend e tem escritor próprio. Integração canônica e sincronização
+instalada são estados separados e permanecem pendentes enquanto os PRs não forem
+integrados. O [PR270 da landing](https://github.com/codexrodrigues/praxis-ui-landing-page/pull/270)
+usa o fluxo vendor oficial em worktree isolado. Este registro
+não cria nova rota, manifesto, endpoint, corpus ou assets públicos.
+
+
+## Fechamento Table e documentação — 27/10/2026
+
+Escopo autorizado: corrigir as quatro falhas preexistentes da Table e as cinco
+cópias documentais divergentes enquanto a campanha financeira Quickstart segue
+em outro chat. Classificação transversal: testes e documentação, sem modificação
+de runtime, API, dependências, rotas ou configuração de build. Inventário
+`ja-suportado-mal-nomeado-ou-mal-materializado`: contrato e implementação já
+concordavam; expectativas e guias ainda ensinavam a conversão antiga.
+
+A auditoria das cinco cópias vendor encontrou versões históricas exatas das fontes
+Angular, sem conteúdo exclusivo novo a preservar. A correção usa o sync oficial
+com `PRAXIS_UI_ANGULAR_ROOT` apontando ao worktree revisado. O ajuste dos dois guias
+Dynamic Fields é derivado do mesmo diagnóstico; não cria controles ou DTOs.
+
+A revisão independente confrontou o patch dos quatro testes, os wrappers e
+registry, o contrato runtime e o histórico. O coordenador revisou os guias e a
+projeção vendor. Evidências locais: `/tmp/praxis-658-table-alignment.log` (224),
+`/tmp/praxis-658-range-contracts.log` (10) e
+`/tmp/praxis-658-alignment-docs.log`. A bateria Table inclui componente, host e projeção; Dynamic Fields cobre os três
+componentes de range, com `tools/karma/karma.headless.conf.cjs`. Não foi repetido build
+ou E2E porque este incremento altera somente specs/documentação. Os builds e E2E
+da fonte de produção `f5880172f` continuam válidos.
+
+Skills: `atualizar-existente` para `praxis-fields-inline-overlay-runtime`, com a
+distinção de valores numéricos/períodos e provas de promoção; `existente-adequada`
+para publicação na landing, que já determina owner-first, sync oficial e gates
+completos. A atualização canônica segue no PR867; integração e sync instalado
+aguardam a revisão sem merge. Os commits finais deste fechamento estão nos PRs
+658/270/867. Pilotos financeiros, verify integral e pin público do Quickstart
+continuam sob coordenação exclusiva do outro chat; este incremento não os aprova.