{"ok":true,"message":"Knowledge Base & Infra Inventory API","portal":"https://kb-portal.creditotal.online","endpoints":{"health":"/health","catalog":"/api/v1/catalog","requests":"/api/v1/requests","docs":"/api/v1/docs","infra":"/api/v1/infra/tasks (desactivado: usar Gestión)","desarrollo":"/api/v1/desarrollo/tasks (desactivado: usar Gestión)","requerimientos":"/api/v1/requerimientos (desactivado: usar Gestión)","changelog":"/api/v1/changelog","responsables":"/api/v1/responsables","estado":"/api/v1/estado","liberaciones":"/api/v1/liberaciones","preferences":"/api/v1/preferences/:email","dudas":"/api/v1/dudas","agent":"/api/v1/agent/requerimientos (desactivado: usar Gestión)","config":"/api/v1/config","pagos":"/api/v1/pagos","gestion":"/api/v1/gestion/:col (tareas|eventos|pases|config|visitas|documentos|proyectos|prefs), /catalogo, /kb-adjunto/:origen/:a/:b/:aid, /kb-documentos, /cambios, /assets, /presencia, /tareas-parecidas?t=&d=, /reglas-tareas"},"reglasParaIA":{"dondeCrear":"Las tareas nuevas se crean en Gestión: PUT /api/v1/gestion/tareas/N-<id> con {data:{...}}.","antesDeCrear":"Consulta GET /api/v1/gestion/tareas-parecidas?t=<título>&d=<descripción>. Si hay parecidas, muéstraselas con su enlace a la persona y pregúntale si es la misma antes de crear.","reglasVigentes":"Las reglas vigentes (campos obligatorios, recomendados, umbral de parecido y mensajes) las configuran los administradores: consúltalas en GET /api/v1/gestion/reglas-tareas antes de crear.","titulo":"El título se redacta según reglas-tareas.msg.tituloIA (GET /api/v1/gestion/reglas-tareas): reformula lo que te pidieron en una frase corta y profesional que diga qué se quiere lograr, con verbo en infinitivo, sin paréntesis, fechas ni nombres. Es solo para la IA: no se le exige a quien crea a mano.","obligatorios":"Por omisión, para crear: t (título), r (responsable), pri (prioridad), et (etapa), spr (sprint) y pj (proyecto). Si la persona no los dio, pregúntaselos; no los inventes.","recomendados":"Por omisión, pide también, en la misma pregunta: estimado (est en días o estR), tipo, categoría (ct), módulo (mod), inicio (ini) y fin del plan (fin, AAAA-MM-DD), de qué se trata (q) y qué hay que hacer (h). No son obligatorios: si no los tiene, crea la tarea igual y recuérdale que los complete luego. Valores válidos en GET /api/v1/gestion/config/catalogos (tipo, ct, mod, rang).","dondeActualizar":"Las tareas existentes se leen y actualizan solo en Gestión (/api/v1/gestion/tareas/<id>), nunca en /requerimientos, /desarrollo, /infra ni /agent. PATCH {data:{...}} mezcla campos; x-actor = tu correo, no tu nombre.","etapas":"et: back=Backlog, pend=Pendiente, cur=En curso, dev=Devuelta, qa=QA, cert=Certificación, prod=Producción, cancel=Cancelada. «Listo para pasar a» es el campo sig (ej. sig:\"prod\"). Si una tarea tiene data.del con motivo «Se unió con otra», usa el id N-… del motivo.","modulosAnteriores":"Este módulo está desactivado para evitar errores. Las tareas se consultan y actualizan solo en Gestión: GET /api/v1/gestion/catalogo y /api/v1/gestion/tareas/<id>; cambiar etapa: PATCH /api/v1/gestion/tareas/<id> con {\"data\":{\"et\":\"qa\"}} y headers x-admin-key y x-actor (tu correo). Si de verdad necesitas consultar algo de este módulo, pídele a la persona que lo active en Gestión › ⚙ Configuración › Módulos anteriores (o, solo si ella te lo pide explícitamente, PUT /api/v1/gestion/config/modulos-viejos con su correo en x-actor) y que lo vuelva a desactivar al terminar.","duplicado":"Si la API responde 409 POSIBLE_DUPLICADO, muestra las parecidas; solo si la persona confirma que es otra tarea, reenvía con data.dupOk=true y data.rel=[ids parecidas]."}}