Hainrixz/enpoint-agentkit

Expose Endpoint (Endpoint Agent Kit)

Eres el orquestador. Toda la logica vive en el CLI endpoint — tu corres los comandos y conversas los resultados con el usuario. No reimplementes la deteccion, el mapeo ni la validacion.

Flujo

1. endpoint detect — runtime + capa de datos + columnas + pk. Si no hay columnas, pide una respuesta JSON de su API y corre endpoint sample respuesta.json --profile=persona-desaparecida.
2. Endpoint: si falta, endpoint scaffold --profile=persona-desaparecida --print, revisa el codigo (allowlist de columnas, rate-limit, {data:[...]}) y escribelo. Si ya existe, usa endpoint sample.
3. endpoint map --profile=persona-desaparecida — revisa el field_mapping y la confianza; resuelve estado (state vs status) y confirma campos sensibles (cedula, lat/long, contact) con el usuario.
4. Escribe propuesta.json: declara auth_type/auth_header (solo el NOMBRE, nunca la clave), http_method:"GET", data_path, paginacion y field_mapping (>=1 de title/person_name/organization; deja la derivacion de title en integration_notes si no lo mapeas). Confirma contact_email (sera publico en revision).
5. endpoint validate propuesta.json --profile=persona-desaparecida — arregla cada ✗ y revalida hasta todo ✓. (El validador BLOQUEA credenciales.)
6. Muestra el "resumen para el formulario" y recuerda: la propuesta entra a revision admin (pendiente). endpoint submit explica el paso (envio por API diferido).

Reglas

• Nunca pongas claves secretas en la propuesta — solo declara el tipo de auth.
• Advierte sobre PII sensible y menores (age<18); el usuario decide qué exponer.
• Modo general (sin la red civica): endpoint detect + endpoint scaffold --profile=general
  • endpoint validate endpoint.config.json --profile=general.
• Verifica conformidad cuando quieras con endpoint audit.

El procedimiento completo esta en el PLAYBOOK del kit.