@ssolis-ti/mcp-compra-agil 1.0.3 → 2.3.0

package/dist/reports/templates/radar-oportunidades.js

@@ -0,0 +1,170 @@
+/**
+ * Template: Informe de Radar de Oportunidades.
+ *
+ * Recibe datos ya recolectados (no consulta la API) — así el mismo dataset
+ * alimenta tanto la respuesta JSON de la tool como este informe.
+ */
+import { renderDocumento } from '../render.js';
+import { portada, kpiRow, tabla, badge, callout, barChartSVG, pieDoc, esc, } from '../components.js';
+import { clp, numero, fecha, fechaLarga, horasRestantes } from '../format.js';
+import { TOKENS, PAPEL, FORMATO_POR_DEFECTO } from '../theme.js';
+/** Clasifica el hot score en un tono semántico. Máximo teórico: 105 pts. */
+export function tonoScore(score) {
+    if (score >= 80)
+        return { tono: 'critico', glosa: 'Muy caliente' };
+    if (score >= 55)
+        return { tono: 'alerta', glosa: 'Caliente' };
+    if (score >= 30)
+        return { tono: 'neutro', glosa: 'Templada' };
+    return { tono: 'neutro', glosa: 'Fría' };
+}
+function colorScore(score) {
+    if (score >= 80)
+        return TOKENS.color.critico;
+    if (score >= 55)
+        return TOKENS.color.alerta;
+    return TOKENS.color.marca;
+}
+export function renderRadarInforme(data) {
+    const { filtros } = data;
+    const formato = data.formato ?? FORMATO_POR_DEFECTO;
+    // Orden defensivo: aunque `recolectarDatosRadar` ya entrega los datos rankeados,
+    // el template no debe confiar en el orden de su entrada — un gráfico "Top N"
+    // desordenado es un error visible y silencioso. Ordenar aquí es O(n log n) sobre
+    // decenas de filas y hace al template correcto ante cualquier llamador.
+    const ops = [...data.oportunidades].sort((a, b) => b.puntuacion_caliente - a.puntuacion_caliente);
+    // ── KPIs de cabecera ──
+    const sinOferentes = ops.filter((o) => o.ofertas_recibidas === 0).length;
+    const cierran24h = ops.filter((o) => o.horas_restantes <= 24).length;
+    const montoTotal = ops.reduce((acc, o) => acc + (o.presupuesto_disponible || 0), 0);
+    const kpis = kpiRow([
+        { label: 'Oportunidades', valor: numero(ops.length), nota: `de ${numero(data.totalAnalizadas)} analizadas` },
+        { label: 'Sin oferentes', valor: numero(sinOferentes), nota: 'competencia cero' },
+        { label: 'Cierran en 24h', valor: numero(cierran24h), nota: 'requieren acción' },
+        { label: 'Monto en juego', valor: clp(montoTotal), nota: 'presupuesto sumado' },
+    ]);
+    // ── Filtros aplicados ──
+    const filtrosTexto = [
+        filtros.region ? `Región ${filtros.region}` : 'Todas las regiones',
+        filtros.q ? `Búsqueda: “${filtros.q}”` : 'Sin filtro de rubro',
+        filtros.presupuestoMinimo ? `Presupuesto ≥ ${clp(filtros.presupuestoMinimo)}` : 'Sin mínimo de presupuesto',
+        `${filtros.paginasEscaneadas} página(s) escaneada(s)`,
+    ].join(' · ');
+    // ── Gráfico: top 10 por puntuación ──
+    const top = ops.slice(0, 10);
+    const grafico = top.length > 0
+        ? barChartSVG(top.map((o) => ({
+            etiqueta: o.nombre,
+            valor: o.puntuacion_caliente,
+            valorTexto: `${o.puntuacion_caliente} pts`,
+            color: colorScore(o.puntuacion_caliente),
+        })))
+        : '';
+    // ── Tabla principal ──
+    const tablaOps = tabla(ops, [
+        {
+            header: '#',
+            ancho: '6mm',
+            celda: (_o, i) => `<span class="num">${i + 1}</span>`,
+        },
+        {
+            header: 'Código',
+            ancho: '28mm',
+            celda: (o) => `<span class="mono">${esc(o.codigo)}</span>`,
+        },
+        {
+            header: 'Proceso',
+            celda: (o) => `${esc(o.nombre)}<br><small>${esc(o.organismo)}</small>`,
+        },
+        {
+            header: 'Región',
+            ancho: '20mm',
+            celda: (o) => esc(o.region),
+        },
+        {
+            header: 'Presupuesto',
+            ancho: '22mm',
+            numerica: true,
+            celda: (o) => clp(o.presupuesto_disponible),
+        },
+        {
+            header: 'Ofertas',
+            ancho: '14mm',
+            numerica: true,
+            celda: (o) => o.ofertas_recibidas === 0
+                ? badge('0', 'exito')
+                : `${numero(o.ofertas_recibidas)}`,
+        },
+        {
+            header: 'Cierra en',
+            ancho: '18mm',
+            numerica: true,
+            celda: (o) => {
+                const txt = horasRestantes(o.horas_restantes);
+                return o.horas_restantes <= 12 ? badge(txt, 'critico') : esc(txt);
+            },
+        },
+        {
+            header: 'Score',
+            ancho: '22mm',
+            numerica: true,
+            celda: (o) => {
+                const { tono, glosa } = tonoScore(o.puntuacion_caliente);
+                return `${badge(`${o.puntuacion_caliente} · ${glosa}`, tono)}`;
+            },
+        },
+    ]);
+    // ── Fichas detalladas del top 3 ──
+    const fichas = ops.slice(0, 3).map((o, i) => {
+        const { tono } = tonoScore(o.puntuacion_caliente);
+        const cuerpo = `
+      <p style="margin-bottom:2mm"><b>${esc(o.organismo)}</b> — ${esc(o.region)}<br>
+      <span class="mono">${esc(o.codigo)}</span></p>
+      <p style="margin-bottom:2mm">
+        Presupuesto <b>${clp(o.presupuesto_disponible)}</b> ·
+        Ofertas recibidas: <b>${numero(o.ofertas_recibidas)}</b> ·
+        Cierra el <b>${fecha(o.fecha_cierre)}</b> (${esc(horasRestantes(o.horas_restantes))})
+      </p>
+      <div><small>Factores de puntuación:</small>
+        <ul style="margin:1mm 0 0;padding-left:4mm">
+          ${o.factores_calificacion.map((f) => `<li><small>${esc(f)}</small></li>`).join('')}
+        </ul>
+      </div>`;
+        return callout(`${i + 1}. ${o.nombre} — ${o.puntuacion_caliente} pts`, cuerpo, tono === 'exito' ? 'neutro' : tono);
+    }).join('');
+    // ── Ensamblado ──
+    const cuerpo = `
+${portada({
+        eyebrow: 'Mercado Público · Compra Ágil',
+        titulo: 'Radar de Oportunidades',
+        subtitulo: 'Procesos activos priorizados por facilidad de adjudicación',
+        meta: [
+            { label: 'Generado', valor: fechaLarga(data.generadoEn) },
+            { label: 'Alcance', valor: filtros.region ? `Región ${filtros.region}` : 'Nacional' },
+            { label: 'Oportunidades', valor: String(ops.length) },
+        ],
+    })}
+
+${kpis}
+
+<p><small>${esc(filtrosTexto)}</small></p>
+
+${ops.length === 0 ? callout('Sin resultados', '<p>No se encontraron Compras Ágiles activas que coincidan con los filtros aplicados.</p>', 'alerta') : ''}
+
+${top.length > 0 ? `<h2>Top ${top.length} por puntuación</h2>${grafico}` : ''}
+
+${fichas ? `<h2>Oportunidades destacadas</h2>${fichas}` : ''}
+
+${ops.length > 0 ? `<h2>Listado completo</h2>${tablaOps}` : ''}
+
+${callout('Cómo se calcula la puntuación', `<p style="margin:0">Fórmula ponderada sobre 105 puntos: baja competencia (hasta 50 pts) + urgencia de cierre (hasta 30 pts) + tamaño de presupuesto (hasta 20 pts) + ausencia de bases adjuntas (5 pts). Una puntuación alta indica un proceso con pocos oferentes, cierre próximo y monto atractivo.</p>`)}
+
+${pieDoc(`Informe generado automáticamente por mcp-compra-agil el ${fecha(data.generadoEn.toISOString())} a partir de datos públicos de la API Compra Ágil v2 de Mercado Público (ChileCompra). Los datos reflejan el estado al momento de la consulta y pueden variar. · Formato de impresión: ${PAPEL[formato].glosa}`)}
+`.trim();
+    return renderDocumento({
+        titulo: `Radar de Oportunidades — ${fechaLarga(data.generadoEn)}`,
+        cuerpo,
+        formato,
+    });
+}
+//# sourceMappingURL=radar-oportunidades.js.map

package/dist/reports/templates/radar-oportunidades.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"radar-oportunidades.js","sourceRoot":"","sources":["../../../src/reports/templates/radar-oportunidades.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EACL,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,GAEjE,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9E,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAqB,MAAM,aAAa,CAAC;AA8BpF,4EAA4E;AAC5E,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IACnE,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAC9D,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAC9D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;IAC7C,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;IAC5C,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAsB;IACvD,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACzB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,mBAAmB,CAAC;IAEpD,iFAAiF;IACjF,6EAA6E;IAC7E,iFAAiF;IACjF,wEAAwE;IACxE,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,mBAAmB,GAAG,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAElG,yBAAyB;IACzB,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IACzE,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACrE,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,sBAAsB,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEpF,MAAM,IAAI,GAAG,MAAM,CAAC;QAClB,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,aAAa,EAAE;QAC5G,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE;QACjF,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE;QAChF,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE;KAChF,CAAC,CAAC;IAEH,0BAA0B;IAC1B,MAAM,YAAY,GAAG;QACnB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,oBAAoB;QAClE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,qBAAqB;QAC9D,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,iBAAiB,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,2BAA2B;QAC3G,GAAG,OAAO,CAAC,iBAAiB,yBAAyB;KACtD,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEd,uCAAuC;IACvC,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC;QAC5B,CAAC,CAAC,WAAW,CACT,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACd,QAAQ,EAAE,CAAC,CAAC,MAAM;YAClB,KAAK,EAAE,CAAC,CAAC,mBAAmB;YAC5B,UAAU,EAAE,GAAG,CAAC,CAAC,mBAAmB,MAAM;YAC1C,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC;SACzC,CAAC,CAAC,CACJ;QACH,CAAC,CAAC,EAAE,CAAC;IAEP,wBAAwB;IACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,EAAE;QAC1B;YACE,MAAM,EAAE,GAAG;YACX,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,qBAAqB,CAAC,GAAG,CAAC,SAAS;SACtD;QACD;YACE,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,sBAAsB,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS;SAC3D;QACD;YACE,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU;SACvE;QACD;YACE,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;SAC5B;QACD;YACE,MAAM,EAAE,aAAa;YACrB,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,sBAAsB,CAAC;SAC5C;QACD;YACE,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,CAAC,CAAC,iBAAiB,KAAK,CAAC;gBACvB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC;gBACrB,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,EAAE;SACvC;QACD;YACE,MAAM,EAAE,WAAW;YACnB,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE;gBACX,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;gBAC9C,OAAO,CAAC,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACpE,CAAC;SACF;QACD;YACE,MAAM,EAAE,OAAO;YACf,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE;gBACX,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;gBACzD,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,mBAAmB,MAAM,KAAK,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;YACjE,CAAC;SACF;KACF,CAAC,CAAC;IAEH,oCAAoC;IACpC,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC1C,MAAM,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG;wCACqB,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;2BACpD,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;;yBAEf,GAAG,CAAC,CAAC,CAAC,sBAAsB,CAAC;gCACtB,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC;uBACpC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;;;;YAI/E,CAAC,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;;aAE/E,CAAC;QACV,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,mBAAmB,MAAM,EAAE,MAAM,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACrH,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEZ,mBAAmB;IACnB,MAAM,MAAM,GAAG;EACf,OAAO,CAAC;QACR,OAAO,EAAE,+BAA+B;QACxC,MAAM,EAAE,wBAAwB;QAChC,SAAS,EAAE,4DAA4D;QACvE,IAAI,EAAE;YACJ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE;YACzD,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE;YACrF,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;SACtD;KACF,CAAC;;EAEA,IAAI;;YAEM,GAAG,CAAC,YAAY,CAAC;;EAE3B,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,0FAA0F,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;;EAEvJ,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,MAAM,uBAAuB,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE;;EAE3E,MAAM,CAAC,CAAC,CAAC,oCAAoC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE;;EAE1D,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE;;EAE5D,OAAO,CACP,+BAA+B,EAC/B,2SAA2S,CAC5S;;EAEC,MAAM,CAAC,2DAA2D,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,0LAA0L,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;CACxT,CAAC,IAAI,EAAE,CAAC;IAEP,OAAO,eAAe,CAAC;QACrB,MAAM,EAAE,4BAA4B,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE;QACjE,MAAM;QACN,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/reports/theme.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Design system de los informes — print-first.
+ *
+ * Decisiones de diseño:
+ * - El papel es blanco: no hay modo oscuro. Se optimiza contraste, no "look".
+ * - Se evitan fondos de página completos (gasto de tinta); el color se usa
+ *   como acento semántico y en superficies pequeñas (badges, cabeceras de tabla).
+ * - Toda la escala (tipografía, espaciado, color) vive aquí: un template nunca
+ *   debe inventar un color o un tamaño suelto.
+ * - Unidades en mm/pt para impresión; rem solo para texto.
+ */
+/**
+ * Formatos de papel soportados.
+ *
+ * OJO con el Oficio: en Chile mide 216 × 330 mm. NO equivale al `legal` de CSS
+ * (216 × 356 mm, que es el US Legal) — usarlo agregaría 26 mm de alto y descuadraría
+ * la caja de texto. Por eso se declara con dimensiones explícitas.
+ *
+ * Carta es el formato de oficina más habitual en Chile; A4 es el estándar ISO
+ * y el default de la mayoría de impresoras; Oficio/Folio se usa en documentos
+ * oficiales y legales.
+ */
+export type FormatoPapel = 'a4' | 'carta' | 'oficio';
+export interface DefinicionPapel {
+    /** Valor para la regla CSS `@page { size: ... }`. */
+    size: string;
+    ancho: string;
+    alto: string;
+    glosa: string;
+    /** Dimensiones en mm para exportadores (ej. Puppeteer width/height). */
+    mm: {
+        ancho: number;
+        alto: number;
+    };
+}
+export declare const PAPEL: Record<FormatoPapel, DefinicionPapel>;
+export declare const FORMATO_POR_DEFECTO: FormatoPapel;
+export declare const TOKENS: {
+    readonly color: {
+        readonly tinta: "#12263a";
+        readonly tintaSuave: "#5b6b7c";
+        readonly tintaTenue: "#8a97a5";
+        readonly marca: "#1b4965";
+        readonly marcaClara: "#e7eef4";
+        readonly borde: "#d6dee6";
+        readonly exito: "#1b6b4a";
+        readonly exitoFondo: "#e6f4ec";
+        readonly alerta: "#8a5a00";
+        readonly alertaFondo: "#fdf2dd";
+        readonly critico: "#9b2226";
+        readonly criticoFondo: "#fbe9e9";
+        readonly papel: "#ffffff";
+    };
+    readonly fuente: {
+        readonly familia: "'Segoe UI', -apple-system, 'Helvetica Neue', Arial, sans-serif";
+        readonly mono: "'Cascadia Mono', 'SF Mono', Consolas, monospace";
+        readonly cuerpo: "10.5pt";
+        readonly micro: "7.5pt";
+        readonly pequena: "8.5pt";
+        readonly h3: "11pt";
+        readonly h2: "13pt";
+        readonly h1: "18pt";
+        readonly portada: "26pt";
+    };
+    readonly espacio: {
+        readonly xs: "2mm";
+        readonly sm: "3mm";
+        readonly md: "5mm";
+        readonly lg: "8mm";
+        readonly xl: "12mm";
+    };
+    readonly pagina: {
+        readonly margen: "16mm 15mm 18mm 15mm";
+    };
+};
+/**
+ * Hoja de estilos base del informe. Se inyecta inline en el HTML
+ * (los informes deben ser un único archivo autocontenido y portable).
+ *
+ * @param formato Tamaño de papel. Por defecto Carta (el más usado en oficinas chilenas).
+ */
+export declare function baseCSS(formato?: FormatoPapel): string;
+//# sourceMappingURL=theme.d.ts.map

package/dist/reports/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/reports/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,EAAE,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACrC;AAED,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE,eAAe,CAuBvD,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,YAAsB,CAAC;AAEzD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCT,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,YAAkC,GAAG,MAAM,CAwM3E"}

package/dist/reports/theme.js

@@ -0,0 +1,284 @@
+/**
+ * Design system de los informes — print-first.
+ *
+ * Decisiones de diseño:
+ * - El papel es blanco: no hay modo oscuro. Se optimiza contraste, no "look".
+ * - Se evitan fondos de página completos (gasto de tinta); el color se usa
+ *   como acento semántico y en superficies pequeñas (badges, cabeceras de tabla).
+ * - Toda la escala (tipografía, espaciado, color) vive aquí: un template nunca
+ *   debe inventar un color o un tamaño suelto.
+ * - Unidades en mm/pt para impresión; rem solo para texto.
+ */
+export const PAPEL = {
+    a4: {
+        size: 'A4',
+        ancho: '210mm',
+        alto: '297mm',
+        glosa: 'A4 (210 × 297 mm)',
+        mm: { ancho: 210, alto: 297 },
+    },
+    carta: {
+        size: 'letter',
+        ancho: '216mm',
+        alto: '279mm',
+        glosa: 'Carta (216 × 279 mm)',
+        mm: { ancho: 216, alto: 279 },
+    },
+    oficio: {
+        // Oficio/Folio chileno: dimensiones explícitas, NO el `legal` de CSS.
+        size: '216mm 330mm',
+        ancho: '216mm',
+        alto: '330mm',
+        glosa: 'Oficio / Folio (216 × 330 mm)',
+        mm: { ancho: 216, alto: 330 },
+    },
+};
+export const FORMATO_POR_DEFECTO = 'carta';
+export const TOKENS = {
+    // Paleta institucional sobria — azul pizarra + acentos semánticos
+    color: {
+        tinta: '#12263a', // texto principal
+        tintaSuave: '#5b6b7c', // texto secundario
+        tintaTenue: '#8a97a5', // metadatos
+        marca: '#1b4965', // primario (encabezados, líneas)
+        marcaClara: '#e7eef4', // superficies suaves
+        borde: '#d6dee6',
+        exito: '#1b6b4a',
+        exitoFondo: '#e6f4ec',
+        alerta: '#8a5a00',
+        alertaFondo: '#fdf2dd',
+        critico: '#9b2226',
+        criticoFondo: '#fbe9e9',
+        papel: '#ffffff',
+    },
+    // Escala tipográfica modular (ratio ~1.25) anclada a 10.5pt de cuerpo
+    fuente: {
+        familia: "'Segoe UI', -apple-system, 'Helvetica Neue', Arial, sans-serif",
+        mono: "'Cascadia Mono', 'SF Mono', Consolas, monospace",
+        cuerpo: '10.5pt',
+        micro: '7.5pt',
+        pequena: '8.5pt',
+        h3: '11pt',
+        h2: '13pt',
+        h1: '18pt',
+        portada: '26pt',
+    },
+    espacio: {
+        xs: '2mm',
+        sm: '3mm',
+        md: '5mm',
+        lg: '8mm',
+        xl: '12mm',
+    },
+    pagina: {
+        margen: '16mm 15mm 18mm 15mm',
+    },
+};
+/**
+ * Hoja de estilos base del informe. Se inyecta inline en el HTML
+ * (los informes deben ser un único archivo autocontenido y portable).
+ *
+ * @param formato Tamaño de papel. Por defecto Carta (el más usado en oficinas chilenas).
+ */
+export function baseCSS(formato = FORMATO_POR_DEFECTO) {
+    const t = TOKENS;
+    const papel = PAPEL[formato];
+    return `
+@page {
+  size: ${papel.size};
+  margin: ${t.pagina.margen};
+}
+
+* { box-sizing: border-box; }
+
+html, body {
+  margin: 0;
+  padding: 0;
+  background: ${t.color.papel};
+  color: ${t.color.tinta};
+  font-family: ${t.fuente.familia};
+  font-size: ${t.fuente.cuerpo};
+  line-height: 1.45;
+  -webkit-print-color-adjust: exact;
+  print-color-adjust: exact;
+}
+
+/* ── Tipografía ────────────────────────────────────────────── */
+h1, h2, h3 {
+  color: ${t.color.marca};
+  margin: 0 0 ${t.espacio.sm} 0;
+  line-height: 1.2;
+  break-after: avoid;
+  page-break-after: avoid;
+}
+h1 { font-size: ${t.fuente.h1}; }
+h2 {
+  font-size: ${t.fuente.h2};
+  margin-top: ${t.espacio.lg};
+  padding-bottom: ${t.espacio.xs};
+  border-bottom: 1.5pt solid ${t.color.marca};
+}
+h3 { font-size: ${t.fuente.h3}; margin-top: ${t.espacio.md}; }
+p { margin: 0 0 ${t.espacio.sm} 0; orphans: 3; widows: 3; }
+strong { color: ${t.color.tinta}; }
+small { font-size: ${t.fuente.pequena}; color: ${t.color.tintaSuave}; }
+
+/* ── Portada ───────────────────────────────────────────────── */
+.portada {
+  border-top: 4pt solid ${t.color.marca};
+  padding-top: ${t.espacio.md};
+  margin-bottom: ${t.espacio.lg};
+}
+.portada .eyebrow {
+  font-size: ${t.fuente.micro};
+  letter-spacing: 0.12em;
+  text-transform: uppercase;
+  color: ${t.color.tintaTenue};
+  margin-bottom: ${t.espacio.xs};
+}
+.portada .titulo {
+  font-size: ${t.fuente.portada};
+  font-weight: 600;
+  color: ${t.color.marca};
+  line-height: 1.15;
+  margin: 0 0 ${t.espacio.sm} 0;
+}
+.portada .subtitulo {
+  font-size: ${t.fuente.h3};
+  color: ${t.color.tintaSuave};
+  font-weight: 400;
+  margin: 0;
+}
+.portada .meta {
+  margin-top: ${t.espacio.md};
+  padding-top: ${t.espacio.sm};
+  border-top: 0.5pt solid ${t.color.borde};
+  font-size: ${t.fuente.pequena};
+  color: ${t.color.tintaSuave};
+  display: flex;
+  flex-wrap: wrap;
+  gap: ${t.espacio.md};
+}
+.portada .meta b { color: ${t.color.tinta}; font-weight: 600; }
+
+/* ── KPIs ──────────────────────────────────────────────────── */
+.kpi-row {
+  display: flex;
+  gap: ${t.espacio.sm};
+  margin: ${t.espacio.md} 0;
+  break-inside: avoid;
+  page-break-inside: avoid;
+}
+.kpi {
+  flex: 1;
+  border: 0.5pt solid ${t.color.borde};
+  border-left: 2.5pt solid ${t.color.marca};
+  border-radius: 1mm;
+  padding: ${t.espacio.sm};
+  background: ${t.color.marcaClara};
+}
+.kpi .label {
+  font-size: ${t.fuente.micro};
+  text-transform: uppercase;
+  letter-spacing: 0.06em;
+  color: ${t.color.tintaSuave};
+  margin-bottom: 1mm;
+}
+.kpi .valor {
+  font-size: ${t.fuente.h2};
+  font-weight: 600;
+  color: ${t.color.marca};
+  line-height: 1.1;
+}
+.kpi .nota { font-size: ${t.fuente.micro}; color: ${t.color.tintaTenue}; margin-top: 0.5mm; }
+
+/* ── Tablas ────────────────────────────────────────────────── */
+table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: ${t.fuente.pequena};
+  margin: ${t.espacio.sm} 0;
+}
+thead { display: table-header-group; } /* repite cabecera al saltar de página */
+tr { break-inside: avoid; page-break-inside: avoid; }
+th {
+  background: ${t.color.marca};
+  color: #fff;
+  text-align: left;
+  padding: 1.8mm 2mm;
+  font-size: ${t.fuente.micro};
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  font-weight: 600;
+}
+td {
+  padding: 1.8mm 2mm;
+  border-bottom: 0.5pt solid ${t.color.borde};
+  vertical-align: top;
+}
+tbody tr:nth-child(even) td { background: #fafbfc; }
+.num { text-align: right; font-variant-numeric: tabular-nums; white-space: nowrap; }
+.mono { font-family: ${t.fuente.mono}; font-size: ${t.fuente.micro}; }
+
+/* ── Badges ────────────────────────────────────────────────── */
+.badge {
+  display: inline-block;
+  padding: 0.6mm 1.6mm;
+  border-radius: 1mm;
+  font-size: ${t.fuente.micro};
+  font-weight: 600;
+  white-space: nowrap;
+}
+.badge-exito   { background: ${t.color.exitoFondo};   color: ${t.color.exito}; }
+.badge-alerta  { background: ${t.color.alertaFondo};  color: ${t.color.alerta}; }
+.badge-critico { background: ${t.color.criticoFondo}; color: ${t.color.critico}; }
+.badge-neutro  { background: ${t.color.marcaClara};   color: ${t.color.marca}; }
+
+/* ── Callouts ──────────────────────────────────────────────── */
+.callout {
+  border-left: 2.5pt solid ${t.color.marca};
+  background: ${t.color.marcaClara};
+  padding: ${t.espacio.sm};
+  margin: ${t.espacio.sm} 0;
+  border-radius: 0 1mm 1mm 0;
+  break-inside: avoid;
+  page-break-inside: avoid;
+  font-size: ${t.fuente.pequena};
+}
+.callout .titulo { font-weight: 600; color: ${t.color.marca}; margin-bottom: 1mm; }
+.callout-alerta  { border-left-color: ${t.color.alerta};  background: ${t.color.alertaFondo}; }
+.callout-alerta .titulo { color: ${t.color.alerta}; }
+.callout-critico { border-left-color: ${t.color.critico}; background: ${t.color.criticoFondo}; }
+.callout-critico .titulo { color: ${t.color.critico}; }
+
+/* ── Gráficos ──────────────────────────────────────────────── */
+.chart { margin: ${t.espacio.md} 0; break-inside: avoid; page-break-inside: avoid; }
+.chart svg { width: 100%; height: auto; }
+
+/* ── Utilidades de paginación ──────────────────────────────── */
+.salto-pagina { break-before: page; page-break-before: always; }
+.no-cortar { break-inside: avoid; page-break-inside: avoid; }
+
+/* ── Pie de documento ──────────────────────────────────────── */
+.pie-doc {
+  margin-top: ${t.espacio.lg};
+  padding-top: ${t.espacio.sm};
+  border-top: 0.5pt solid ${t.color.borde};
+  font-size: ${t.fuente.micro};
+  color: ${t.color.tintaTenue};
+}
+
+/* ── Solo pantalla: simula la hoja al abrir en el navegador ── */
+/* El ancho sigue al formato real (${papel.glosa}) para que lo que se ve
+   en pantalla coincida con lo que sale impreso. */
+@media screen {
+  body {
+    max-width: ${papel.ancho};
+    margin: 8mm auto;
+    padding: 16mm 15mm;
+    box-shadow: 0 0 0 1px #e5e7eb, 0 4px 24px rgba(0,0,0,.07);
+  }
+}
+`.trim();
+}
+//# sourceMappingURL=theme.js.map

package/dist/reports/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/reports/theme.ts"],"names":[],"mappings":"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"}

package/dist/resources/compras-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compras-template.d.ts","sourceRoot":"","sources":["../../src/resources/compras-template.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGhE,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAoCjG"}
+{"version":3,"file":"compras-template.d.ts","sourceRoot":"","sources":["../../src/resources/compras-template.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAIhE,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAoCjG"}

package/dist/resources/compras-template.js

@@ -6,6 +6,7 @@
  */
 import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { CompraAgilApiError } from '../utils/error-handler.js';
+import { safeError } from '../utils/redact.js';
 export function registerComprasTemplateResource(server, client) {
     // Crear plantilla de URI para compra-agil://compras/{codigo}
     const template = new ResourceTemplate('compra-agil://compras/{codigo}', {
@@ -32,7 +33,7 @@ export function registerComprasTemplateResource(server, client) {
         catch (error) {
             const message = error instanceof CompraAgilApiError
                 ? error.actionableMessage
-                : `Error al leer recurso de Compra Ágil: ${String(error)}`;
+                : `Error al leer recurso de Compra Ágil: ${safeError(error)}`;
             throw new Error(message);
         }
     });

package/dist/resources/compras-template.js.map

@@ -1 +1 @@
-{"version":3,"file":"compras-template.js","sourceRoot":"","sources":["../../src/resources/compras-template.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAa,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAEtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,UAAU,+BAA+B,CAAC,MAAiB,EAAE,MAAwB;IACzF,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,gCAAgC,EAAE;QACtE,IAAI,EAAE,SAAS,EAAE,kFAAkF;KACpG,CAAC,CAAC;IAEH,MAAM,CAAC,gBAAgB,CACrB,yBAAyB,EACzB,QAAQ,EACR;QACE,WAAW,EAAE,uIAAuI;QACpJ,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,SAAS,CAAC,MAAgB,CAAC;YAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;YACnE,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC7C,OAAO;gBACL,QAAQ,EAAE,CAAC;wBACT,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;wBACnB,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;qBACvC,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,kBAAkB;gBACjD,CAAC,CAAC,KAAK,CAAC,iBAAiB;gBACzB,CAAC,CAAC,yCAAyC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"compras-template.js","sourceRoot":"","sources":["../../src/resources/compras-template.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAa,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAEtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,UAAU,+BAA+B,CAAC,MAAiB,EAAE,MAAwB;IACzF,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,gCAAgC,EAAE;QACtE,IAAI,EAAE,SAAS,EAAE,kFAAkF;KACpG,CAAC,CAAC;IAEH,MAAM,CAAC,gBAAgB,CACrB,yBAAyB,EACzB,QAAQ,EACR;QACE,WAAW,EAAE,uIAAuI;QACpJ,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,SAAS,CAAC,MAAgB,CAAC;YAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;YACnE,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC7C,OAAO;gBACL,QAAQ,EAAE,CAAC;wBACT,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;wBACnB,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;qBACvC,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,kBAAkB;gBACjD,CAAC,CAAC,KAAK,CAAC,iBAAiB;gBACzB,CAAC,CAAC,yCAAyC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/resources/documentacion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"documentacion.d.ts","sourceRoot":"","sources":["../../src/resources/documentacion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAoCtF;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsErE"}
+{"version":3,"file":"documentacion.d.ts","sourceRoot":"","sources":["../../src/resources/documentacion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAStF;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkErE"}

package/dist/resources/documentacion.js

@@ -1,37 +1,10 @@
 import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
 import fs from 'fs';
 import path from 'path';
-import { fileURLToPath } from 'url';
 import { PDFParse } from 'pdf-parse';
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const packageDocsDir = path.resolve(__dirname, '../../docs');
-const cwdDocsDir = path.resolve(process.cwd(), 'docs');
-let DOCS_DIR = cwdDocsDir;
-if (fs.existsSync(packageDocsDir) && fs.readdirSync(packageDocsDir).some(f => f.toLowerCase().endsWith('.pdf'))) {
-    DOCS_DIR = packageDocsDir;
-}
-/**
- * Obtiene de forma recursiva todos los archivos dentro de un directorio,
- * retornando sus rutas relativas formateadas con barras diagonales (/).
- */
-function getRelativeFilesRecursively(dir, baseDir = dir) {
-    let results = [];
-    if (!fs.existsSync(dir))
-        return [];
-    const list = fs.readdirSync(dir);
-    for (const file of list) {
-        const filePath = path.join(dir, file);
-        const stat = fs.statSync(filePath);
-        if (stat && stat.isDirectory()) {
-            results = results.concat(getRelativeFilesRecursively(filePath, baseDir));
-        }
-        else {
-            const relativePath = path.relative(baseDir, filePath).replace(/\\/g, '/');
-            results.push(relativePath);
-        }
-    }
-    return results;
-}
+import { resolveDocsDir, listSupportedDocs } from '../utils/docs-locator.js';
+import { safeError } from '../utils/redact.js';
+const DOCS_DIR = resolveDocsDir();
 /**
  * Registra el recurso dinámico para consultar manuales y guías locales (PDF/TXT/MD).
  */
@@ -43,11 +16,7 @@ export function registerDocumentacionResource(server) {
                 if (!fs.existsSync(DOCS_DIR)) {
                     fs.mkdirSync(DOCS_DIR, { recursive: true });
                 }
-                const files = getRelativeFilesRecursively(DOCS_DIR).filter(file => {
-                    const ext = path.extname(file).toLowerCase();
-                    const name = path.basename(file).toLowerCase();
-                    return (ext === '.pdf' || ext === '.txt' || ext === '.md') && name !== 'readme.md';
-                });
+                const files = listSupportedDocs(DOCS_DIR);
                 return {
                     resources: files.map(file => ({
                         uri: `compra-agil://documentacion/${encodeURIComponent(file)}`,
@@ -93,7 +62,7 @@ export function registerDocumentacionResource(server) {
             };
         }
         catch (error) {
-            throw new Error(`Error al leer el manual local: ${error.message || String(error)}`);
+            throw new Error(`Error al leer el manual local: ${safeError(error)}`);
         }
     });
 }