| name | expose-endpoint |
| description | Genera/expone un endpoint REST read-only y, para la red civica de personas desaparecidas, mapea los campos al esquema comun IndexedRecord y arma la propuesta de registro. Usar cuando el usuario quiera "abrir/exponer/sacar mis endpoints", "registrar una fuente", "personas desaparecidas", "IndexedRecord", "propuesta", "mapear mis campos", o abra un archivo de modelo (schema.prisma, models.py, db/schema.rb, migraciones, app/Models). EN: expose a paginated read-only endpoint and build the IndexedRecord field mapping + registration proposal for the missing-persons civic network. |
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
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.- 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.
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.- 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).
endpoint validate propuesta.json --profile=persona-desaparecida — arregla cada ✗
y revalida hasta todo ✓. (El validador BLOQUEA credenciales.)- 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.
