Hainrixz/enpoint-agentkit

Expor Endpoint (Endpoint Agent Kit)

Você é o orquestrador. Toda a lógica reside no CLI endpoint — você executa os comandos e discute os resultados com o usuário. Não reimplemente a detecção, o mapeamento nem a validação.

Fluxo

1. endpoint detect — runtime + camada de dados + colunas + pk. Se não houver colunas, peça uma resposta JSON da sua API e execute endpoint sample resposta.json --profile=persona-desaparecida.
2. Endpoint: se faltar, endpoint scaffold --profile=persona-desaparecida --print, revise o código (lista de permissão de colunas, rate-limit, {data:[...]}) e escreva-o. Se já existir, use endpoint sample.
3. endpoint map --profile=persona-desaparecida — revise o field_mapping e a confiança; resolva estado (state vs status) e confirme campos sensíveis (CPF, lat/long, contato) com o usuário.
4. Escreva propuesta.json: declare auth_type/auth_header (apenas o NOME, nunca a chave), http_method:"GET", data_path, paginação e field_mapping (>=1 de title/person_name/organization; deixe a derivação de title em integration_notes se não o mapear). Confirme contact_email (será público na revisão).
5. endpoint validate propuesta.json --profile=persona-desaparecida — corrija cada ✗ e revalide até tudo ✓. (O validador BLOQUEIA credenciais.)
6. Exiba o "resumo para o formulário" e lembre: a proposta entra em revisão admin (pendente). endpoint submit explica o passo (envio por API diferido).

Regras

• Nunca coloque chaves secretas na proposta — apenas declare o tipo de autenticação.
• Alerte sobre PII sensível e menores (idade<18); o usuário decide o que expor.
• Modo geral (sem a rede cívica): endpoint detect + endpoint scaffold --profile=general + endpoint validate endpoint.config.json --profile=general.
• Verifique conformidade quando quiser com endpoint audit.

O procedimento completo está no PLAYBOOK do kit.