@praxisui/manual-form 8.0.0-beta.7 → 8.0.0-beta.71

package/README.md

@@ -368,6 +368,32 @@ Modo dinâmico (sem host tipado):
 - Métodos públicos:
   - `tryOpenFieldEditor(fieldName: string)`: tenta abrir o editor do campo, respeitando `enableCustomization` (no‑op quando `false`).
 
+## Contrato agentic de authoring
+
+`PRAXIS_MANUAL_FORM_AUTHORING_MANIFEST` e o contrato AI executavel do pacote.
+
+O manifesto governa a orquestracao do formulario manual:
+
+- `manualField.add`
+- `manualField.remove`
+- `manualField.label.set`
+- `layout.configure`
+- `toolbar.configure`
+- `autosave.enabled.set`
+- `submitBehavior.set`
+- `metadataBridge.configure`
+
+Regras de fronteira:
+
+- `ManualFormInstance` e a superficie runtime do pacote: config, mapa de metadata, `FormGroup` e persistencia devem permanecer coerentes
+- as operacoes escrevem nos paths reais do runtime (`currentConfig`, `currentFieldMetadata`, `form`, inputs como `enableCustomization`, `enableAutoSave`, `autoSaveDebounceMs`, `persistenceOptions`, e outputs como `submitted`, `saved`, `resetEvent`)
+- IDs de campo manual sao nomes estaveis de campo, nunca indice de array
+- remocao de campo exige confirmacao explicita
+- autosave deve declarar debounce seguro e chave de persistencia deterministica
+- toolbar de campo e metadata bridge sao entry points de runtime controlados por `enableCustomization`; nao existe objeto persistido `toolbar.*` ou `metadataBridge.*`
+- edicoes profundas de `FieldMetadata` sao delegadas ao `@praxisui/metadata-editor`
+- authoring avancado de `FormConfig` pertence ao `@praxisui/dynamic-form`
+
 ## Header e Actions
 
 - `<praxis-manual-form-header>`: recebe `instance`, `title`, `description`, `saveLabel`, `resetLabel` e emite `save/reset`.
@@ -471,7 +497,10 @@ Apache-2.0 — consulte `LICENSE` neste pacote ou no repositório raiz.
 
 ## Notas adicionais
 
-- Quando `enableCustomization` estiver ativo, o container renderiza o assistente AI (Praxis AI) no header do formulario.
+- Quando `enableCustomization` estiver ativo, o container abre o shell compartilhado `PraxisAiAssistantShellComponent` e registra sessao global minimizavel em vez de embutir o assistente legado.
+- O contexto do assistente e seguro e semantico: identidade do formulario, `formId`, contagem de campos/secoes/acoes, nomes de campos, referencia ao `PRAXIS_MANUAL_FORM_AUTHORING_MANIFEST` e hints de governanca.
+- Prompts de regra, politica, compliance, publicacao, materializacao ou enforcement seguem para handoff governado `domain-rules/intake` e nao sao aplicados como patch local do formulario.
+- Patches JSON livres vindos do backend sao rejeitados. O apply local permanece bloqueado ate existir `componentEditPlan` compilado e validado pelo manifesto canonico.
 - `componentInstanceId` ajuda a compor a chave de persistencia (com `formId` e `persistenceOptions`), evitando conflito entre instancias da mesma tela.
 
 ## Comparativo — Manual vs Dinâmico (JSON)