Provedores e guarda-corpos

ContractForge AI pode usar provedores de modelo, mas a saída do provedor é consultiva até ele passa na validação determinística. O objetivo é melhorar a produtividade sem deixando o modelo inventar ContractForge APIs ou suporte de plataforma.

Deterministic before provider

Todo fluxo de trabalho apoiado pelo provedor segue esta ordem:

1. Deterministic intent extraction.
2. Planejamento determinístico de projetos.
3. Validação do contrato principal.
4. Validação de planejamento do adaptador quando adaptadores são solicitados.
5. Explicação ou enriquecimento opcional do fornecedor.
6. Validação determinística da saída do provedor.

O provedor nunca possui status de suporte.

Routing providers

Use route-task antes de escolher um modelo:

contractforge-ai route-task \
  --intent "Explain adapter warnings for this generated Supabase project." \
  --prefer-http-only \
  --format markdown

Tarefas de consultoria de baixo risco podem preferir provedores somente HTTP para reduzir a dependência e custo de tempo de execução. Tarefas de maior risco, como geração de projetos e o enriquecimento do contrato, deverá exigir um apoio estrito aos resultados estruturados.

Regras de enriquecimento

Provider output may suggest:

• descrições e anotações;
• projetos de regras de qualidade;
• transformar e moldar rascunhos;
• rascunhos de metadados de operações;
• review questions;
• explanatory summaries.

A saída do provedor não pode mudar silenciosamente:

• conector;
• caminho de origem;
• catálogo/esquema/tabela de destino;
• layer;
• modo de gravação;
• mesclar chaves ou política de hash;
• schedule;
• environment artifact destinations;
• secret values;
• platform support status.

Se um provedor propor um campo de mudança de comportamento, ContractForge AI pode preservar o rascunho para revisão, mas registra o campo como necessário para revisão.

Exemplo de enriquecimento protegido

contractforge-ai guided-project \
  --intent "Create a USGS GeoJSON medallion project. Extract event_id, magnitude, place and coordinates. Add quality checks." \
  --schema schemas/usgs-events.json \
  --target contractforge-yaml \
  --with-ai \
  --provider openai \
  --allow-review-required \
  --output-dir generated/usgs

Se o provedor sugerir shape.parse_json ou uma expressão de qualidade, o relatório mostra isso como um comportamento de rascunho. O revisor deve aprová-lo antes de tratar o projeto como pronto para produção.

Rejecting unsafe output

ContractForge AI rejeita ou sinaliza a saída do provedor quando:

• includes raw secrets;
• changes deterministic identity fields;
• grava configurações de implementação do adaptador em contratos de ingestão;
• afirma que a semântica não suportada é suportada;
• remove decisões necessárias;
• inventa campos fora do modelo de contrato público ContractForge.

As propostas rejeitadas são registadas no relatório de revisão em vez de serem silenciosamente discarded.

Cost-aware usage

Use fornecedores menores ou mais baratos apenas para tarefas que não reduzam a qualidade:

Task	Provider strategy
Resumir a saída de validação	Low-cost provider is acceptable.
Translate report prose	O fornecedor de baixo custo é aceitável se os rótulos e identificadores permanecerem inalterados.
Gerar especificações do projeto	Use o modelo de saída estruturada mais forte disponível.
Decisões de segurança, arquitetura ou lançamento	Use o modelo disponível mais forte e testes determinísticos.
Adapter support status	Não pergunte ao provedor; use planejadores de adaptadores.

O provedor é um assistente dos sistemas determinísticos, não do sistema de record.