story: autoria fiscal assistida a partir de amostras + Excel + XSD

[elson-vinicius-lopes]

Objetivo

Gerar transformação fiscal TCL + XSL/XSLT a partir de um pacote que contém amostras de origem, layout estrutural, planilha de especificação, XSD oficial e gabarito opcional.

Decisão arquitetural

Fluxo human-in-the-loop em duas etapas:

1. normalizar os insumos e produzir MappingDraftRule estruturada, com source/target, condição, operação, evidência, confiança, limitações e perguntas;
2. somente após aceite/edição humana, gerar TCL e XSL/XSLT e submetê-los a execução, validação XSD/fiscal, diff e cobertura.

Fronteira obrigatória

• autoria e geração: TCL e XSL/XSLT;
• Sysmiddle: somente execução e explicação; nenhuma mutação, conversão ou publicação;
• IA não publica nem promove versão;
• lacuna de evidência vira needs_input, nunca mapping silencioso.

Aceite da feature

• schema intermediário versionado e auditável;
• sugestão referencia célula/artefato/XSD que a sustenta;
• revisão otimista e decisões humanas auditadas;
• geração usa apenas regras aceitas;
• saída passa por validação determinística e retorna correlation ID;
• fixtures sanitizadas incluem o cenário FIAT NF-e 4.00;
• custo/timeout do modelo CPU-only é medido;
• nenhum dado fiscal é enviado a provedor externo sem política explícita.

Dependências e decomposição

Relaciona-se a #94 (governança), #226 (explicação) e às issues filhas de pacote, Draft e Test Lab.

[elson-vinicius-lopes]

Handoff do consumidor LayoutParserReact

O front refinou o objetivo final de autoria fiscal:

1. versionar amostras + layout + Excel + XSD/gabarito;
2. receber MappingDraftRule com evidência, confiança, limitações e perguntas;
3. registrar aceite/edição/rejeição humana;
4. gerar e testar somente TCL/XSL/XSLT;
5. manter Sysmiddle permanentemente read-only, inclusive no servidor.

Issues filhas: #229–#232. Consumidor: LayoutParserReact#201–#206. O contrato proposto está em
docs/contracts/fiscal-workspace-and-mapping-explanation-api.md no front. Não considerar a feature
aceita até o piloto FIAT passar XSD, diff, cobertura, provenance e zero mutação Sysmiddle.