@ssolis-ti/mcp-compra-agil 1.0.2 → 2.1.0

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)}`);
         }
     });
 }

package/dist/resources/documentacion.js.map

@@ -1 +1 @@
-{"version":3,"file":"documentacion.js","sourceRoot":"","sources":["../../src/resources/documentacion.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"documentacion.js","sourceRoot":"","sources":["../../src/resources/documentacion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;AAElC;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAAC,MAAiB;IAC7D,qEAAqE;IACrE,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,wCAAwC,EAAE;QAC9E,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,IAAI,CAAC;gBACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC7B,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC9C,CAAC;gBAED,MAAM,KAAK,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;gBAE1C,OAAO;oBACL,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;wBAC5B,GAAG,EAAE,+BAA+B,kBAAkB,CAAC,IAAI,CAAC,EAAE;wBAC9D,IAAI,EAAE,IAAI;wBACV,QAAQ,EAAE,YAAY,EAAE,uFAAuF;wBAC/G,WAAW,EAAE,iCAAiC,IAAI,EAAE;qBACrD,CAAC,CAAC;iBACJ,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,KAAK,CAAC,CAAC;gBACnE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;YAC3B,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,gBAAgB,CACrB,qBAAqB,EACrB,QAAQ,EACR;QACE,WAAW,EAAE,iHAAiH;QAC9H,QAAQ,EAAE,YAAY;KACvB,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,kBAAkB,CAAC,SAAS,CAAC,QAAkB,CAAC,CAAC;YAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAE/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,cAAc,QAAQ,iCAAiC,CAAC,CAAC;YAC3E,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;YACjD,IAAI,IAAI,GAAG,EAAE,CAAC;YAEd,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;gBACzC,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC9C,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;gBACvC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC3C,CAAC;YAED,OAAO;gBACL,QAAQ,EAAE,CAAC;wBACT,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;wBACnB,QAAQ,EAAE,YAAY;wBACtB,IAAI,EAAE,IAAI;qBACX,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,kCAAkC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"estados.d.ts","sourceRoot":"","sources":["../../src/resources/estados.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmCpE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgB/D"}
+{"version":3,"file":"estados.d.ts","sourceRoot":"","sources":["../../src/resources/estados.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkDpE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgB/D"}

package/dist/resources/estados.js

@@ -4,47 +4,61 @@
  * Catálogo de estados válidos de una Compra Ágil con descripciones
  * y notas sobre comportamiento real de la API.
  */
+/**
+ * Catálogo de estados con el comportamiento REAL medido contra la API
+ * (julio 2026, re-verificado en septiembre 2026 con idéntico resultado).
+ * La documentación oficial difiere en dos puntos importantes,
+ * verificados empíricamente y anotados abajo.
+ */
 const ESTADOS = [
     {
         codigo: 'publicada',
         descripcion: 'La Compra Ágil está abierta y recibiendo cotizaciones de proveedores.',
-        nota: null,
+        funciona: true,
+        nota: 'Es el estado a usar para buscar oportunidades vigentes.',
     },
     {
         codigo: 'cerrada',
         descripcion: 'El plazo de cotización finalizó. El organismo está evaluando las ofertas.',
-        nota: null,
+        funciona: true,
+        nota: 'En la muestra observada, los procesos "cerrada" de primer llamado NO exponen sus cotizaciones (proveedores_cotizando viene vacío).',
     },
     {
         codigo: 'desierta',
         descripcion: 'No se recibieron ofertas válidas para este proceso.',
-        nota: null,
+        funciona: true,
+        nota: 'Contraintuitivo pero útil: los procesos desiertos SÍ suelen exponer las cotizaciones que recibieron (y por qué fueron declaradas inadmisibles). Es la mejor fuente de precios de mercado disponible en la API.',
     },
     {
         codigo: 'cancelada',
         descripcion: 'El proceso fue cancelado por el organismo comprador.',
-        nota: 'El motivo de cancelación está disponible en el campo motivos.motivo_cancelacion del detalle.',
+        funciona: true,
+        nota: 'El motivo está en motivos.motivo_cancelacion del detalle.',
     },
     {
         codigo: 'proveedor_seleccionado',
-        descripcion: 'Se seleccionó al proveedor ganador. INCLUYE también las Compras Ágiles que ya tienen OC emitida.',
-        nota: 'Este estado agrupa tanto los procesos con proveedor elegido como los que ya tienen Orden de Compra. Para distinguirlos, usa la herramienta "verificar_orden_compra".',
+        descripcion: 'Documentado como "se seleccionó al proveedor ganador".',
+        funciona: false,
+        nota: '⚠ LIMITACIÓN VERIFICADA (julio 2026, re-confirmada en septiembre 2026): la API acepta este filtro pero devuelve SIEMPRE 0 resultados. Además, en 45 procesos inspeccionados con 52 cotizaciones, el campo proveedor_seleccionado valió 0 en el 100% de los casos y ningún proceso traía id_orden_compra. CONCLUSIÓN: la API no expone procesos adjudicados. No bases análisis en este estado. Para precios de mercado usa "analizar_precios_mercado", que se apoya en cotizaciones reales. Nota sobre la guía oficial: el Ejemplo 8.6 de la Guía v3.0 propone detectar OCs emitidas recorriendo este estado — es irrealizable, porque el primer paso devuelve una lista vacía.',
     },
     {
         codigo: 'oc_emitida',
-        descripcion: 'Se emitió una Orden de Compra (definido en el modelo de la API).',
-        nota: '⚠ LIMITACIÓN CONOCIDA: Este estado NO aparece en la práctica en las respuestas de la API. Los procesos con OC emitida se listan bajo "proveedor_seleccionado". Usa la herramienta "verificar_orden_compra" para detectar si un proceso tiene OC real.',
+        descripcion: 'Documentado como "se emitió una Orden de Compra".',
+        funciona: false,
+        nota: '⚠ LIMITACIÓN VERIFICADA: enviar este valor devuelve HTTP 400 (Parámetros de consulta inválidos). No es un filtro válido, pese a estar documentado.',
     },
 ];
+/** Advertencia general que acompaña al catálogo. */
+const ADVERTENCIA = 'Estados verificados contra la API real en julio de 2026 y re-confirmados en septiembre de 2026 (sin cambios). Solo publicada, cerrada, desierta y cancelada devuelven datos. proveedor_seleccionado devuelve 0 resultados y oc_emitida da error 400, pese a estar ambos documentados oficialmente.';
 export function registerEstadosResource(server) {
     server.registerResource('estados', 'compra-agil://estados', {
-        description: 'Catálogo de estados válidos de una Compra Ágil con descripciones y notas sobre limitaciones conocidas de la API. Consulta este recurso antes de filtrar por estado para entender qué significa cada valor.',
+        description: 'Catálogo de estados de una Compra Ágil con su comportamiento REAL verificado contra la API. Consúltalo antes de filtrar por estado: dos de los estados documentados oficialmente (proveedor_seleccionado y oc_emitida) NO funcionan en la práctica.',
         mimeType: 'application/json',
     }, async () => ({
         contents: [{
                 uri: 'compra-agil://estados',
                 mimeType: 'application/json',
-                text: JSON.stringify(ESTADOS, null, 2),
+                text: JSON.stringify({ _advertencia: ADVERTENCIA, estados: ESTADOS }, null, 2),
             }],
     }));
 }

package/dist/resources/estados.js.map

@@ -1 +1 @@
-{"version":3,"file":"estados.js","sourceRoot":"","sources":["../../src/resources/estados.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,OAAO,GAAG;IACd;QACE,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,uEAAuE;QACpF,IAAI,EAAE,IAAI;KACX;IACD;QACE,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,2EAA2E;QACxF,IAAI,EAAE,IAAI;KACX;IACD;QACE,MAAM,EAAE,UAAU;QAClB,WAAW,EAAE,qDAAqD;QAClE,IAAI,EAAE,IAAI;KACX;IACD;QACE,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,sDAAsD;QACnE,IAAI,EAAE,8FAA8F;KACrG;IACD;QACE,MAAM,EAAE,wBAAwB;QAChC,WAAW,EAAE,kGAAkG;QAC/G,IAAI,EAAE,sKAAsK;KAC7K;IACD;QACE,MAAM,EAAE,YAAY;QACpB,WAAW,EAAE,kEAAkE;QAC/E,IAAI,EAAE,uPAAuP;KAC9P;CACF,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,gBAAgB,CACrB,SAAS,EACT,uBAAuB,EACvB;QACE,WAAW,EAAE,4MAA4M;QACzN,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,QAAQ,EAAE,CAAC;gBACT,GAAG,EAAE,uBAAuB;gBAC5B,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;aACvC,CAAC;KACH,CAAC,CACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"estados.js","sourceRoot":"","sources":["../../src/resources/estados.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;GAKG;AACH,MAAM,OAAO,GAAG;IACd;QACE,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,uEAAuE;QACpF,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,yDAAyD;KAChE;IACD;QACE,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,2EAA2E;QACxF,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,oIAAoI;KAC3I;IACD;QACE,MAAM,EAAE,UAAU;QAClB,WAAW,EAAE,qDAAqD;QAClE,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,gNAAgN;KACvN;IACD;QACE,MAAM,EAAE,WAAW;QACnB,WAAW,EAAE,sDAAsD;QACnE,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,2DAA2D;KAClE;IACD;QACE,MAAM,EAAE,wBAAwB;QAChC,WAAW,EAAE,wDAAwD;QACrE,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,gpBAAgpB;KACvpB;IACD;QACE,MAAM,EAAE,YAAY;QACpB,WAAW,EAAE,mDAAmD;QAChE,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,oJAAoJ;KAC3J;CACF,CAAC;AAEF,oDAAoD;AACpD,MAAM,WAAW,GAAG,oSAAoS,CAAC;AAEzT,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,gBAAgB,CACrB,SAAS,EACT,uBAAuB,EACvB;QACE,WAAW,EAAE,qPAAqP;QAClQ,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,QAAQ,EAAE,CAAC;gBACT,GAAG,EAAE,uBAAuB;gBAC5B,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;aAC/E,CAAC;KACH,CAAC,CACH,CAAC;AACJ,CAAC"}