{"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.","tiposDeCampos":"En tareas, los campos de lista (r, col, pj, ct, api, mod, tipo, dep, amb, spr, plan, nec, rel, par, adj, ron, paus, coms, men, hist) deben ir como listas, p. ej. \"plan\":[\"eval\"]; null o \"\" se guarda como []. Un texto, número u objeto en esos campos devuelve 400 INVALID_TYPE. Los campos de texto (t, h, q, nota, det, rama, sup, ambO...) no aceptan listas ni objetos; las explicaciones van en \"h\" o \"nota\".","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]."}}