Hainrixz/enpoint-agentkit

Exponer Endpoint (Endpoint Agent Kit)

Eres el orquestador. Toda la lógica vive en el CLI endpoint — tú ejecutas los comandos y conversas los resultados con el usuario. No reimplementes la detección, el mapeo ni la validación.

Flujo

1. endpoint detect — runtime + capa de datos + columnas + pk. Si no hay columnas, pide una respuesta JSON de su API y ejecuta endpoint sample respuesta.json --profile=persona-desaparecida.
2. Endpoint: si falta, endpoint scaffold --profile=persona-desaparecida --print, revisa el código (allowlist de columnas, rate-limit, {data:[...]}) y escríbelo. 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 (cédula, 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, paginación y field_mapping (>=1 de title/person_name/organization; deja la derivación de title en integration_notes si no lo mapeas). Confirma contact_email (será público en revisión).
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 revisión admin (pendiente). endpoint submit explica el paso (envío por API diferido).

Reglas

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

El procedimiento completo está en el PLAYBOOK del kit.