paperclip-plugin-autopilot-ops 0.1.8 → 0.1.9

package/dist/manifest.js

@@ -1,6 +1,6 @@
 // src/manifest.ts
 var PLUGIN_ID = "alephoo.autopilot-ops";
-var PLUGIN_VERSION = "0.1.8";
+var PLUGIN_VERSION = "0.1.9";
 var DB_NAMESPACE_SLUG = "autopilot_ops";
 var PAGE_ROUTE = "autopilot";
 var TOOL_NAMES = {
@@ -149,7 +149,7 @@ var manifest = {
     {
       name: TOOL_NAMES.publicarTablero,
       displayName: "Publicar tablero",
-      description: "Publica o actualiza un tablero de gesti\xF3n para la direcci\xF3n del hospital, armado sobre datos reales de Alephoo (turnos, facturaci\xF3n, internaci\xF3n, producci\xF3n). `clave` identifica el tablero de forma estable (min\xFAsculas y guiones; volver a publicar con la misma clave lo actualiza en el lugar). `widgets` es la lista de piezas que se muestran, en orden: {tipo:'indicador', etiqueta, valor, unidad?, contexto?, tono?: neutro|ambar|senal|corte} \xB7 {tipo:'barras', titulo, unidad?, series:[{etiqueta, valor}]} \xB7 {tipo:'linea', titulo, unidad?, puntos:[{x, y}]} \xB7 {tipo:'tabla', titulo, columnas:[\u2026], filas:[[\u2026]]} \xB7 {tipo:'texto', titulo?, texto}. Cada widget admite `ancho` 1, 2 o 3 (columnas de 3). `fuentes` lista qu\xE9 se consult\xF3 (p. ej. 'Alephoo \xB7 api-consultas \xB7 turnos 01/09\u201330/09'). Si el pedido vino de una tarea, pasar `issueId`.",
+      description: "Publica o actualiza un tablero de gesti\xF3n para la direcci\xF3n del hospital, armado sobre datos reales de Alephoo (turnos, facturaci\xF3n, internaci\xF3n, producci\xF3n). `clave` identifica el tablero de forma estable (min\xFAsculas y guiones; volver a publicar con la misma clave lo actualiza en el lugar). `widgets` es la lista de piezas que se muestran, en orden: {tipo:'indicador', etiqueta, valor, unidad?, contexto?, tono?: neutro|ambar|senal|corte} \xB7 {tipo:'barras', titulo, unidad?, series:[{etiqueta, valor}]} \xB7 {tipo:'linea', titulo, unidad?, puntos:[{x, y}]} \xB7 {tipo:'tabla', titulo, columnas:[\u2026], filas:[[\u2026]]} \xB7 {tipo:'texto', titulo?, texto}. Cada widget admite `ancho` 1, 2 o 3 (columnas de 3). **N\xFAmeros oficiales:** cada indicador, barras, l\xEDnea o tabla calculado con calcular.mjs lleva `calculo` = el bloque `calculo` que devuelve calcular.mjs, tal cual (cat\xE1logo, m\xE9tricas con versi\xF3n, par\xE1metros, huella, consulta); el plugin lo valida contra el cat\xE1logo de m\xE9tricas y marca el widget como certificado, propuesta (m\xE9trica sin aprobar) o exploratorio (sin `calculo`). Controles que frenan la publicaci\xF3n: una tabla con fila \xABTOTAL\xBB tiene que sumar ese total en cada columna num\xE9rica (las filas \xABSubtotal \u2026\xBB no suman); un desglose con `calculo` y `por` lleva la fila TOTAL; un porcentaje (`unidad` '%' o columna con '%') va de 0 a 100 salvo que el t\xEDtulo diga variaci\xF3n, diferencia o cumplimiento de meta. `fuentes` lista qu\xE9 se consult\xF3 (p. ej. 'Alephoo \xB7 base \xB7 semantica_turnos \xB7 turnos 01/09\u201330/09'). Si el pedido vino de una tarea, pasar `issueId`.",
       parametersSchema: {
         type: "object",
         properties: {
@@ -277,6 +277,14 @@ var manifest = {
       capability: "api.routes.register",
       companyResolution: { from: "body", key: "companyId" }
     },
+    {
+      routeKey: "metricas",
+      method: "GET",
+      path: "/metricas",
+      auth: "board",
+      capability: "api.routes.register",
+      companyResolution: { from: "query", key: "companyId" }
+    },
     {
       routeKey: "tableros",
       method: "GET",

package/dist/ui/index.js

@@ -8,7 +8,7 @@ import {
 
 // src/manifest.ts
 var PLUGIN_ID = "alephoo.autopilot-ops";
-var PLUGIN_VERSION = "0.1.8";
+var PLUGIN_VERSION = "0.1.9";
 var DB_NAMESPACE_SLUG = "autopilot_ops";
 var PAGE_ROUTE = "autopilot";
 var TOOL_NAMES = {
@@ -157,7 +157,7 @@ var manifest = {
     {
       name: TOOL_NAMES.publicarTablero,
       displayName: "Publicar tablero",
-      description: "Publica o actualiza un tablero de gesti\xF3n para la direcci\xF3n del hospital, armado sobre datos reales de Alephoo (turnos, facturaci\xF3n, internaci\xF3n, producci\xF3n). `clave` identifica el tablero de forma estable (min\xFAsculas y guiones; volver a publicar con la misma clave lo actualiza en el lugar). `widgets` es la lista de piezas que se muestran, en orden: {tipo:'indicador', etiqueta, valor, unidad?, contexto?, tono?: neutro|ambar|senal|corte} \xB7 {tipo:'barras', titulo, unidad?, series:[{etiqueta, valor}]} \xB7 {tipo:'linea', titulo, unidad?, puntos:[{x, y}]} \xB7 {tipo:'tabla', titulo, columnas:[\u2026], filas:[[\u2026]]} \xB7 {tipo:'texto', titulo?, texto}. Cada widget admite `ancho` 1, 2 o 3 (columnas de 3). `fuentes` lista qu\xE9 se consult\xF3 (p. ej. 'Alephoo \xB7 api-consultas \xB7 turnos 01/09\u201330/09'). Si el pedido vino de una tarea, pasar `issueId`.",
+      description: "Publica o actualiza un tablero de gesti\xF3n para la direcci\xF3n del hospital, armado sobre datos reales de Alephoo (turnos, facturaci\xF3n, internaci\xF3n, producci\xF3n). `clave` identifica el tablero de forma estable (min\xFAsculas y guiones; volver a publicar con la misma clave lo actualiza en el lugar). `widgets` es la lista de piezas que se muestran, en orden: {tipo:'indicador', etiqueta, valor, unidad?, contexto?, tono?: neutro|ambar|senal|corte} \xB7 {tipo:'barras', titulo, unidad?, series:[{etiqueta, valor}]} \xB7 {tipo:'linea', titulo, unidad?, puntos:[{x, y}]} \xB7 {tipo:'tabla', titulo, columnas:[\u2026], filas:[[\u2026]]} \xB7 {tipo:'texto', titulo?, texto}. Cada widget admite `ancho` 1, 2 o 3 (columnas de 3). **N\xFAmeros oficiales:** cada indicador, barras, l\xEDnea o tabla calculado con calcular.mjs lleva `calculo` = el bloque `calculo` que devuelve calcular.mjs, tal cual (cat\xE1logo, m\xE9tricas con versi\xF3n, par\xE1metros, huella, consulta); el plugin lo valida contra el cat\xE1logo de m\xE9tricas y marca el widget como certificado, propuesta (m\xE9trica sin aprobar) o exploratorio (sin `calculo`). Controles que frenan la publicaci\xF3n: una tabla con fila \xABTOTAL\xBB tiene que sumar ese total en cada columna num\xE9rica (las filas \xABSubtotal \u2026\xBB no suman); un desglose con `calculo` y `por` lleva la fila TOTAL; un porcentaje (`unidad` '%' o columna con '%') va de 0 a 100 salvo que el t\xEDtulo diga variaci\xF3n, diferencia o cumplimiento de meta. `fuentes` lista qu\xE9 se consult\xF3 (p. ej. 'Alephoo \xB7 base \xB7 semantica_turnos \xB7 turnos 01/09\u201330/09'). Si el pedido vino de una tarea, pasar `issueId`.",
       parametersSchema: {
         type: "object",
         properties: {
@@ -285,6 +285,14 @@ var manifest = {
       capability: "api.routes.register",
       companyResolution: { from: "body", key: "companyId" }
     },
+    {
+      routeKey: "metricas",
+      method: "GET",
+      path: "/metricas",
+      auth: "board",
+      capability: "api.routes.register",
+      companyResolution: { from: "query", key: "companyId" }
+    },
     {
       routeKey: "tableros",
       method: "GET",

package/dist/worker.js

@@ -39932,7 +39932,7 @@ function startWorkerRpcHost(options) {
 
 // src/manifest.ts
 var PLUGIN_ID = "alephoo.autopilot-ops";
-var PLUGIN_VERSION = "0.1.8";
+var PLUGIN_VERSION = "0.1.9";
 var DB_NAMESPACE_SLUG = "autopilot_ops";
 var PAGE_ROUTE = "autopilot";
 var TOOL_NAMES = {
@@ -40081,7 +40081,7 @@ var manifest = {
     {
       name: TOOL_NAMES.publicarTablero,
       displayName: "Publicar tablero",
-      description: "Publica o actualiza un tablero de gesti\xF3n para la direcci\xF3n del hospital, armado sobre datos reales de Alephoo (turnos, facturaci\xF3n, internaci\xF3n, producci\xF3n). `clave` identifica el tablero de forma estable (min\xFAsculas y guiones; volver a publicar con la misma clave lo actualiza en el lugar). `widgets` es la lista de piezas que se muestran, en orden: {tipo:'indicador', etiqueta, valor, unidad?, contexto?, tono?: neutro|ambar|senal|corte} \xB7 {tipo:'barras', titulo, unidad?, series:[{etiqueta, valor}]} \xB7 {tipo:'linea', titulo, unidad?, puntos:[{x, y}]} \xB7 {tipo:'tabla', titulo, columnas:[\u2026], filas:[[\u2026]]} \xB7 {tipo:'texto', titulo?, texto}. Cada widget admite `ancho` 1, 2 o 3 (columnas de 3). `fuentes` lista qu\xE9 se consult\xF3 (p. ej. 'Alephoo \xB7 api-consultas \xB7 turnos 01/09\u201330/09'). Si el pedido vino de una tarea, pasar `issueId`.",
+      description: "Publica o actualiza un tablero de gesti\xF3n para la direcci\xF3n del hospital, armado sobre datos reales de Alephoo (turnos, facturaci\xF3n, internaci\xF3n, producci\xF3n). `clave` identifica el tablero de forma estable (min\xFAsculas y guiones; volver a publicar con la misma clave lo actualiza en el lugar). `widgets` es la lista de piezas que se muestran, en orden: {tipo:'indicador', etiqueta, valor, unidad?, contexto?, tono?: neutro|ambar|senal|corte} \xB7 {tipo:'barras', titulo, unidad?, series:[{etiqueta, valor}]} \xB7 {tipo:'linea', titulo, unidad?, puntos:[{x, y}]} \xB7 {tipo:'tabla', titulo, columnas:[\u2026], filas:[[\u2026]]} \xB7 {tipo:'texto', titulo?, texto}. Cada widget admite `ancho` 1, 2 o 3 (columnas de 3). **N\xFAmeros oficiales:** cada indicador, barras, l\xEDnea o tabla calculado con calcular.mjs lleva `calculo` = el bloque `calculo` que devuelve calcular.mjs, tal cual (cat\xE1logo, m\xE9tricas con versi\xF3n, par\xE1metros, huella, consulta); el plugin lo valida contra el cat\xE1logo de m\xE9tricas y marca el widget como certificado, propuesta (m\xE9trica sin aprobar) o exploratorio (sin `calculo`). Controles que frenan la publicaci\xF3n: una tabla con fila \xABTOTAL\xBB tiene que sumar ese total en cada columna num\xE9rica (las filas \xABSubtotal \u2026\xBB no suman); un desglose con `calculo` y `por` lleva la fila TOTAL; un porcentaje (`unidad` '%' o columna con '%') va de 0 a 100 salvo que el t\xEDtulo diga variaci\xF3n, diferencia o cumplimiento de meta. `fuentes` lista qu\xE9 se consult\xF3 (p. ej. 'Alephoo \xB7 base \xB7 semantica_turnos \xB7 turnos 01/09\u201330/09'). Si el pedido vino de una tarea, pasar `issueId`.",
       parametersSchema: {
         type: "object",
         properties: {
@@ -40209,6 +40209,14 @@ var manifest = {
       capability: "api.routes.register",
       companyResolution: { from: "body", key: "companyId" }
     },
+    {
+      routeKey: "metricas",
+      method: "GET",
+      path: "/metricas",
+      auth: "board",
+      capability: "api.routes.register",
+      companyResolution: { from: "query", key: "companyId" }
+    },
     {
       routeKey: "tableros",
       method: "GET",
@@ -41669,6 +41677,32 @@ function errorParaAgente(err) {
   return { error: `error_interno: ${message2}`, data: { codigo: "error_interno" } };
 }
 
+// src/metricas.ts
+var CATALOGO_VERSION = "2026-10-15.1";
+var METRICAS = [
+  { id: "turnos_dados", version: 1, estado: "validada", nombre: "Turnos dados", unidad: "turnos", definicion: "Turnos agendados en el per\xEDodo que no fueron cancelados ni bloqueados (incluye atendidos, ausentes y los que siguen pendientes)." },
+  { id: "turnos_atendidos", version: 1, estado: "validada", nombre: "Turnos atendidos", unidad: "turnos", definicion: "Turnos en los que hubo atenci\xF3n: en atenci\xF3n, atendido o revisado por el profesional." },
+  { id: "ausencias", version: 1, estado: "validada", nombre: "Ausencias", unidad: "turnos", definicion: "Turnos marcados como \xABno asisti\xF3\xBB." },
+  { id: "ausentismo", version: 1, estado: "validada", nombre: "Ausentismo", unidad: "%", definicion: "Ausencias sobre turnos dados. Las cancelaciones no cuentan como ausencia. Los turnos que nadie cerr\xF3 no figuran como ausencia, as\xED que con muchos turnos sin cerrar el ausentismo real es mayor." },
+  { id: "turnos_sin_cerrar", version: 1, estado: "propuesta", nombre: "Turnos sin cerrar", unidad: "turnos", definicion: "Turnos con fecha ya pasada que siguen en \xABpendiente\xBB o \xABanunciado\xBB: nadie los cerr\xF3 como atendidos ni como ausentes." },
+  { id: "cancelaciones", version: 1, estado: "validada", nombre: "Cancelaciones", unidad: "turnos", definicion: "Turnos cancelados del per\xEDodo." },
+  { id: "cancelaciones_mismo_dia", version: 1, estado: "validada", nombre: "Cancelaciones del mismo d\xEDa", unidad: "turnos", definicion: "Turnos cancelados el mismo d\xEDa del turno (el cupo ya casi no se puede reutilizar). Es una aproximaci\xF3n: Alephoo no guarda la fecha de cancelaci\xF3n y se usa la \xFAltima modificaci\xF3n del turno." },
+  { id: "tasa_cancelacion", version: 1, estado: "validada", nombre: "Tasa de cancelaci\xF3n", unidad: "%", definicion: "Cancelaciones sobre lo agendado (turnos dados m\xE1s cancelados)." },
+  { id: "turnos_agendados", version: 1, estado: "validada", nombre: "Turnos agendados", unidad: "turnos", definicion: "Turnos dados m\xE1s cancelados: todo lo que se agend\xF3 en el per\xEDodo, sin los cupos bloqueados." },
+  { id: "facturado", version: 1, estado: "validada", nombre: "Facturado", unidad: "$", definicion: "Importe de las facturas emitidas en el per\xEDodo, sin las anuladas, con IVA, por fecha de emisi\xF3n (la de AFIP en las electr\xF3nicas)." },
+  { id: "facturas_emitidas", version: 1, estado: "validada", nombre: "Facturas emitidas", unidad: "facturas", definicion: "Cantidad de facturas emitidas en el per\xEDodo, sin las anuladas." },
+  { id: "notas_credito", version: 1, estado: "validada", nombre: "Notas de cr\xE9dito", unidad: "$", definicion: "Notas de cr\xE9dito no anuladas sobre las facturas emitidas en el per\xEDodo (se asignan al mes de la factura). Incluyen d\xE9bitos de financiadores, anulaciones parciales y ajustes propios: no son lo mismo que \xABd\xE9bitos\xBB." },
+  { id: "notas_debito", version: 1, estado: "validada", nombre: "Notas de d\xE9bito", unidad: "$", definicion: "Notas de d\xE9bito no anuladas sobre las facturas emitidas en el per\xEDodo." },
+  { id: "cobrado_de_lo_facturado", version: 1, estado: "validada", nombre: "Cobrado de lo facturado", unidad: "$", definicion: "Lo cobrado (recibos no anulados aplicados) sobre las facturas emitidas en el per\xEDodo, cualquiera sea la fecha del cobro." },
+  { id: "deuda_pendiente", version: 1, estado: "validada", nombre: "Deuda pendiente", unidad: "$", definicion: "Saldo sin cobrar de las facturas emitidas en el per\xEDodo que siguen pendientes (facturado menos notas de cr\xE9dito, m\xE1s notas de d\xE9bito, menos lo cobrado)." },
+  { id: "bonos_pendientes_de_facturar", version: 1, estado: "validada", nombre: "Bonos pendientes de facturar", unidad: "bonos", definicion: "Prestaciones (bonos) del per\xEDodo todav\xEDa no confirmadas o confirmadas y sin prefacturar ni facturar." },
+  { id: "monto_pendiente_de_facturar", version: 1, estado: "validada", nombre: "Monto pendiente de facturar", unidad: "$", definicion: "Importe de los bonos pendientes de facturar del per\xEDodo, por fecha de la prestaci\xF3n." },
+  { id: "debitos_financiador", version: 1, estado: "a_definir", nombre: "D\xE9bitos de financiadores", unidad: "$", definicion: "Sin definir: el hospital tiene que decidir si cuenta todas las notas de cr\xE9dito o solo las que responden a un d\xE9bito del financiador. Hasta entonces no se publica como n\xFAmero oficial." }
+];
+function metricaPorId(id) {
+  return METRICAS.find((m) => m.id === id) ?? null;
+}
+
 // src/tableros.ts
 import { randomUUID as randomUUID2 } from "node:crypto";
 var TIPOS = ["indicador", "barras", "linea", "tabla", "texto"];
@@ -41715,6 +41749,79 @@ function numero2(v, campo, problemas) {
 function ancho(v) {
   return v === 1 || v === 2 || v === 3 ? v : void 0;
 }
+function aNumero(v) {
+  if (typeof v === "number") return Number.isFinite(v) ? v : null;
+  if (typeof v !== "string") return null;
+  let s = v.trim().replace(/[$\s%]/g, "");
+  if (s === "") return null;
+  if (s.includes(",")) s = s.replace(/\./g, "").replace(",", ".");
+  else if (/^-?\d{1,3}(\.\d{3})+$/.test(s)) s = s.replace(/\./g, "");
+  const n = Number(s);
+  return Number.isFinite(n) ? n : null;
+}
+var ES_VARIACION = /varia|cambio|crec|difer|dif\.|Δ|meta|cumpl|\bvs\b|versus/i;
+function controlarPorcentaje(valor, donde, problemas) {
+  const n = aNumero(valor);
+  if (n !== null && (n < 0 || n > 100)) problemas.push(`${donde} es un porcentaje y vale ${n}: tiene que estar entre 0 y 100 (si es una variaci\xF3n o un cumplimiento sobre meta, decirlo en el t\xEDtulo)`);
+}
+var MAX_CONSULTA = 8e3;
+function leerCalculo(v, ref, problemas) {
+  if (v === void 0 || v === null) return { origen: "exploratorio" };
+  if (typeof v !== "object" || Array.isArray(v)) {
+    problemas.push(`${ref}.calculo tiene que ser el bloque \xABcalculo\xBB que devuelve calcular.mjs`);
+    return { origen: "exploratorio" };
+  }
+  const o = v;
+  const lista = arr(o.metricas);
+  if (lista.length === 0) problemas.push(`${ref}.calculo.metricas est\xE1 vac\xEDo`);
+  let propuesta = false;
+  const metricas = [];
+  lista.slice(0, 12).forEach((m, j) => {
+    const mo = m && typeof m === "object" ? m : {};
+    const id = typeof mo.id === "string" ? mo.id : "";
+    const version2 = Number(mo.version);
+    const def2 = metricaPorId(id);
+    if (!def2) {
+      problemas.push(`${ref}.calculo.metricas[${j}]: \xAB${id}\xBB no est\xE1 en el cat\xE1logo de m\xE9tricas; un n\xFAmero fuera del cat\xE1logo se publica sin calculo (queda como exploratorio)`);
+      return;
+    }
+    if (def2.version !== version2) problemas.push(`${ref}.calculo.metricas[${j}]: \xAB${id}\xBB versi\xF3n ${Number.isFinite(version2) ? version2 : "?"} no es la vigente (${def2.version}): recalcular con calcular.mjs`);
+    if (def2.estado === "a_definir") problemas.push(`${ref}.calculo.metricas[${j}]: \xAB${id}\xBB todav\xEDa no tiene definici\xF3n aprobada y no se publica como n\xFAmero oficial`);
+    if (def2.estado === "propuesta") propuesta = true;
+    metricas.push({ id, version: def2.version });
+  });
+  const huella = typeof o.huella === "string" && /^[0-9a-f]{16}$/.test(o.huella) ? o.huella : "";
+  if (!huella) problemas.push(`${ref}.calculo.huella falta o no tiene la forma de calcular.mjs (16 caracteres hexadecimales)`);
+  const parametros = o.parametros && typeof o.parametros === "object" && !Array.isArray(o.parametros) ? o.parametros : {};
+  if (JSON.stringify(parametros).length > 2e3) problemas.push(`${ref}.calculo.parametros es demasiado largo`);
+  const consulta = typeof o.consulta === "string" && o.consulta.trim() ? o.consulta.slice(0, MAX_CONSULTA) : void 0;
+  const catalogo = typeof o.catalogo === "string" ? o.catalogo.slice(0, 40) : "";
+  return { calculo: { catalogo, metricas, parametros, huella, ...consulta ? { consulta } : {} }, origen: propuesta ? "propuesta" : "certificado" };
+}
+var esTotal = (c) => typeof c === "string" && /^total\b/i.test(c.trim());
+var esSubtotal = (c) => typeof c === "string" && /^subtotal\b/i.test(c.trim());
+function controlarTabla(ref, columnas, filas, problemas) {
+  columnas.forEach((col, j) => {
+    if (!col.includes("%") || ES_VARIACION.test(col)) return;
+    filas.forEach((f, i) => controlarPorcentaje(f[j], `${ref}.filas[${i}] \xAB${col}\xBB`, problemas));
+  });
+  const totales = filas.filter((f) => esTotal(f[0]));
+  if (totales.length !== 1) return;
+  const total = totales[0];
+  const detalle = filas.filter((f) => !esTotal(f[0]) && !esSubtotal(f[0]));
+  if (detalle.length === 0) return;
+  for (let j = 1; j < columnas.length; j += 1) {
+    if (columnas[j].includes("%")) continue;
+    const esperado = aNumero(total[j]);
+    if (esperado === null) continue;
+    const valores = detalle.map((f) => f[j]);
+    if (valores.some((x) => x !== null && x !== "" && aNumero(x) === null)) continue;
+    const suma = valores.reduce((acc, x) => acc + (aNumero(x) ?? 0), 0);
+    if (Math.abs(suma - esperado) > Math.max(0.011, Math.abs(esperado) * 1e-6)) {
+      problemas.push(`${ref}: la columna \xAB${columnas[j]}\xBB suma ${Math.round(suma * 100) / 100} y la fila TOTAL dice ${esperado}`);
+    }
+  }
+}
 function validarWidgets(entrada) {
   const problemas = [];
   const lista = Array.isArray(entrada) ? entrada : [];
@@ -41736,39 +41843,38 @@ function validarWidgets(entrada) {
         const valor = typeof o.valor === "number" && Number.isFinite(o.valor) ? o.valor : texto2(o.valor, 40, `${ref}.valor`, problemas, true) ?? "";
         const tono = typeof o.tono === "string" && TONOS.includes(o.tono) ? o.tono : void 0;
         if (o.tono !== void 0 && !tono) problemas.push(`${ref}.tono debe ser uno de ${TONOS.join(", ")}`);
-        salida.push({ tipo, etiqueta, valor, unidad: texto2(o.unidad, 16, `${ref}.unidad`, problemas), contexto: texto2(o.contexto, 160, `${ref}.contexto`, problemas), tono, ancho: a });
+        const unidad = texto2(o.unidad, 16, `${ref}.unidad`, problemas);
+        if (unidad === "%" && !ES_VARIACION.test(etiqueta)) controlarPorcentaje(valor, `${ref}.valor`, problemas);
+        const { calculo, origen } = leerCalculo(o.calculo, ref, problemas);
+        salida.push({ tipo, etiqueta, valor, unidad, contexto: texto2(o.contexto, 160, `${ref}.contexto`, problemas), tono, ancho: a, ...calculo ? { calculo } : {}, origen });
         break;
       }
       case "barras": {
         const titulo = texto2(o.titulo, 120, `${ref}.titulo`, problemas, true) ?? "";
         const series = arr(o.series);
         if (series.length === 0 || series.length > 40) problemas.push(`${ref}.series debe tener entre 1 y 40 barras`);
-        salida.push({
-          tipo,
-          titulo,
-          unidad: texto2(o.unidad, 16, `${ref}.unidad`, problemas),
-          series: series.slice(0, 40).map((s, j) => {
-            const so = s && typeof s === "object" ? s : {};
-            return { etiqueta: texto2(so.etiqueta, 60, `${ref}.series[${j}].etiqueta`, problemas, true) ?? "", valor: numero2(so.valor, `${ref}.series[${j}].valor`, problemas) };
-          }),
-          ancho: a
+        const unidad = texto2(o.unidad, 16, `${ref}.unidad`, problemas);
+        const barras = series.slice(0, 40).map((s, j) => {
+          const so = s && typeof s === "object" ? s : {};
+          return { etiqueta: texto2(so.etiqueta, 60, `${ref}.series[${j}].etiqueta`, problemas, true) ?? "", valor: numero2(so.valor, `${ref}.series[${j}].valor`, problemas) };
         });
+        if (unidad === "%" && !ES_VARIACION.test(titulo)) barras.forEach((b, j) => controlarPorcentaje(b.valor, `${ref}.series[${j}].valor`, problemas));
+        const { calculo, origen } = leerCalculo(o.calculo, ref, problemas);
+        salida.push({ tipo, titulo, unidad, series: barras, ancho: a, ...calculo ? { calculo } : {}, origen });
         break;
       }
       case "linea": {
         const titulo = texto2(o.titulo, 120, `${ref}.titulo`, problemas, true) ?? "";
         const puntos = arr(o.puntos);
         if (puntos.length === 0 || puntos.length > 400) problemas.push(`${ref}.puntos debe tener entre 1 y 400 puntos`);
-        salida.push({
-          tipo,
-          titulo,
-          unidad: texto2(o.unidad, 16, `${ref}.unidad`, problemas),
-          puntos: puntos.slice(0, 400).map((p, j) => {
-            const po = p && typeof p === "object" ? p : {};
-            return { x: texto2(po.x, 40, `${ref}.puntos[${j}].x`, problemas, true) ?? "", y: numero2(po.y, `${ref}.puntos[${j}].y`, problemas) };
-          }),
-          ancho: a
+        const unidad = texto2(o.unidad, 16, `${ref}.unidad`, problemas);
+        const serie2 = puntos.slice(0, 400).map((p, j) => {
+          const po = p && typeof p === "object" ? p : {};
+          return { x: texto2(po.x, 40, `${ref}.puntos[${j}].x`, problemas, true) ?? "", y: numero2(po.y, `${ref}.puntos[${j}].y`, problemas) };
         });
+        if (unidad === "%" && !ES_VARIACION.test(titulo)) serie2.forEach((p, j) => controlarPorcentaje(p.y, `${ref}.puntos[${j}].y`, problemas));
+        const { calculo, origen } = leerCalculo(o.calculo, ref, problemas);
+        salida.push({ tipo, titulo, unidad, puntos: serie2, ancho: a, ...calculo ? { calculo } : {}, origen });
         break;
       }
       case "tabla": {
@@ -41778,17 +41884,18 @@ function validarWidgets(entrada) {
         const filas = arr(o.filas);
         if (filas.length > 200) problemas.push(`${ref}.filas admite hasta 200 filas`);
         const cols = columnas.slice(0, 12).map((c, j) => texto2(c, 60, `${ref}.columnas[${j}]`, problemas, true) ?? "");
-        salida.push({
-          tipo,
-          titulo,
-          columnas: cols,
-          filas: filas.slice(0, 200).map((f, j) => {
-            const celdas = arr(f);
-            if (celdas.length !== cols.length) problemas.push(`${ref}.filas[${j}] tiene ${celdas.length} celdas y la tabla ${cols.length} columnas`);
-            return celdas.slice(0, cols.length).map((c) => typeof c === "number" && Number.isFinite(c) ? c : c === null || c === void 0 ? null : String(c).slice(0, 200));
-          }),
-          ancho: a
+        const celdasTabla = filas.slice(0, 200).map((f, j) => {
+          const celdas = arr(f);
+          if (celdas.length !== cols.length) problemas.push(`${ref}.filas[${j}] tiene ${celdas.length} celdas y la tabla ${cols.length} columnas`);
+          return celdas.slice(0, cols.length).map((c) => typeof c === "number" && Number.isFinite(c) ? c : c === null || c === void 0 ? null : String(c).slice(0, 200));
         });
+        controlarTabla(ref, cols, celdasTabla, problemas);
+        const { calculo, origen } = leerCalculo(o.calculo, ref, problemas);
+        const por = calculo && Array.isArray(calculo.parametros.por) ? calculo.parametros.por : [];
+        if (calculo && por.length > 0 && !celdasTabla.some((f) => esTotal(f[0]))) {
+          problemas.push(`${ref}: una tabla con desglose de m\xE9tricas del cat\xE1logo lleva la fila TOTAL que devuelve calcular.mjs (primera celda \xABTOTAL\xBB)`);
+        }
+        salida.push({ tipo, titulo, columnas: cols, filas: celdasTabla, ancho: a, ...calculo ? { calculo } : {}, origen });
         break;
       }
       case "texto": {
@@ -42120,13 +42227,15 @@ async function manejarApi(ctx, input2) {
       return respuesta(200, await transicionar(ctx, { companyId, casoId: input2.params.casoId ?? "", via: "no_corresponde", motivo: motivoConPersona(str2(body.motivo)), datos: conPersona(obj(body.datos)), idempotencyKey: str2(body.idempotencyKey), actor }));
     }
     case "version":
-      return respuesta(200, { version: manifest_default.version, capacidades: ["carga-manual", "recupero-turnos", "ofrecer-primero", "cuenta-completa"], workflows: listarWorkflows().map((w) => w.clave) });
+      return respuesta(200, { version: manifest_default.version, capacidades: ["carga-manual", "recupero-turnos", "ofrecer-primero", "cuenta-completa", "metricas-certificadas"], workflows: listarWorkflows().map((w) => w.clave) });
     case "politicas":
       return respuesta(200, { politicas: await listarPoliticas(ctx, companyId) });
     case "serie":
       return respuesta(200, await serie(ctx, companyId, numOrNull(qs("dias"))));
     case "historial-politicas":
       return respuesta(200, { cambios: await historialPoliticas(ctx, companyId, numOrNull(qs("limit"))) });
+    case "metricas":
+      return respuesta(200, { version: CATALOGO_VERSION, metricas: METRICAS });
     case "tableros":
       return respuesta(200, { tableros: await listarTableros(ctx, companyId) });
     case "tablero-publicado": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paperclip-plugin-autopilot-ops",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "type": "module",
   "description": "Autopilot Care · operación autónoma gobernada para instituciones de salud: workflows determinísticos, validaciones, registro de negocio, políticas (observa/propone/ejecuta/corte) y tablero del director, como plugin de Paperclip.",
   "files": [