hvp-shared 13.4.1 → 13.6.0

package/dist/constants/google-calendar.constants.d.ts

@@ -22,11 +22,25 @@ import type { AppointmentBranch, AppointmentStandard } from "../contracts/google
  * Weights sum to 100. An event is "compliant" when its score >= 80.
  */
 export declare const STANDARD_V2: AppointmentStandard;
+/**
+ * Multi-factor appointment standard v3.
+ *
+ * Twelve dimensions. Compared to V2:
+ * - `title` is split into 3 dimensions: `title_service_code`, `title_pet_name`,
+ *   `title_format` — so each aspect of "well-formed title" gets its own weight.
+ * - `discount_format` added: auto-passes when no discount mentioned, but if
+ *   a `%` is present in the description, must follow `\d+% <razón>` format.
+ * - Weights rebalanced: title + branch weighted higher (12 each); owner +
+ *   context downgraded to 8; raza/edad downgraded to 4. Discount = 4.
+ *
+ * Weights sum to 100. An event is "compliant" when its score >= 80.
+ */
+export declare const STANDARD_V3: AppointmentStandard;
 /**
  * Backward-compatible alias for existing code/tests that imported `STANDARD_V1`.
- * Always points to the current standard.
+ * Always points to the current standard (V3 as of 13.5.0).
  *
- * @deprecated Use `STANDARD_V2` (or whatever the current version is) explicitly.
+ * @deprecated Use `STANDARD_V3` (or whatever the current version is) explicitly.
  */
 export declare const STANDARD_V1: AppointmentStandard;
 /**

package/dist/constants/google-calendar.constants.js

@@ -13,7 +13,7 @@
  * runs remain reproducible.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HVP_EVENT_PROP_KEYS = exports.KNOWN_BREEDS = exports.PET_AGE_REGEX = exports.SCHEDULER_WITH_DATE_REGEX = exports.SCHEDULER_REGEX = exports.PHONE_REGEX = exports.QVET_ID_REGEX = exports.CANCELLED_TITLE_REGEX = exports.REMINDER_TITLE_REGEX = exports.PREFERRED_VET_REGEX = exports.EXCLUDED_TITLE_PREFIXES = exports.SERVICE_CODE_SYNONYMS = exports.CANONICAL_SERVICE_CODES = exports.EXCLUDED_COLOR_IDS = exports.CANCELLED_COLOR_ID = exports.COLOR_ID_TO_BRANCH = exports.BRANCH_COLOR_IDS = exports.STANDARD_V1 = exports.STANDARD_V2 = void 0;
+exports.HVP_EVENT_PROP_KEYS = exports.KNOWN_BREEDS = exports.PET_AGE_REGEX = exports.SCHEDULER_WITH_DATE_REGEX = exports.SCHEDULER_REGEX = exports.PHONE_REGEX = exports.QVET_ID_REGEX = exports.CANCELLED_TITLE_REGEX = exports.REMINDER_TITLE_REGEX = exports.PREFERRED_VET_REGEX = exports.EXCLUDED_TITLE_PREFIXES = exports.SERVICE_CODE_SYNONYMS = exports.CANONICAL_SERVICE_CODES = exports.EXCLUDED_COLOR_IDS = exports.CANCELLED_COLOR_ID = exports.COLOR_ID_TO_BRANCH = exports.BRANCH_COLOR_IDS = exports.STANDARD_V1 = exports.STANDARD_V3 = exports.STANDARD_V2 = void 0;
 // ─── Standard v1 ─────────────────────────────────────────────────────────────
 /**
  * Multi-factor appointment standard v2.
@@ -90,13 +90,104 @@ exports.STANDARD_V2 = {
         },
     ],
 };
+/**
+ * Multi-factor appointment standard v3.
+ *
+ * Twelve dimensions. Compared to V2:
+ * - `title` is split into 3 dimensions: `title_service_code`, `title_pet_name`,
+ *   `title_format` — so each aspect of "well-formed title" gets its own weight.
+ * - `discount_format` added: auto-passes when no discount mentioned, but if
+ *   a `%` is present in the description, must follow `\d+% <razón>` format.
+ * - Weights rebalanced: title + branch weighted higher (12 each); owner +
+ *   context downgraded to 8; raza/edad downgraded to 4. Discount = 4.
+ *
+ * Weights sum to 100. An event is "compliant" when its score >= 80.
+ */
+exports.STANDARD_V3 = {
+    version: "3.0",
+    minimumCompliantScore: 80,
+    dimensions: [
+        {
+            id: "branch",
+            weight: 8,
+            label: "Sucursal",
+            description: 'Sucursal detectada por colorId del evento: 11 (Tomato/rojo) = Urban, 9 (Blueberry/azul) = Harbor, 3 (Grape/morado) = Montejo. Si el evento usa el color por defecto, falla esta dimensión. Atención: hay tonos parecidos en GCal — fíjate en el colorId exacto en el drawer si dudas.',
+        },
+        {
+            id: "title_service_code",
+            weight: 12,
+            label: "Código de servicio",
+            description: 'El título empieza con un código del diccionario: C (consulta), SC (sin cita), CS (consulta seguimiento), V/VAC (vacuna), CX (cirugía), CERT (certificado), USG, RX, ECO, OVH, TM (toma de muestras), AM/AP/APL (aplicación de medicamento), D (desparasitación), MC (microchip), CU (corte de uñas), PROFILAXIS, etc.',
+        },
+        {
+            id: "title_pet_name",
+            weight: 12,
+            label: "Nombre de la mascota (título)",
+            description: 'Nombre de la mascota detectable en el título (después del código de servicio, antes de iniciales del vet). Ej: "C MILO RGL*" → mascota = MILO. Soporta multi-mascota: "V CUBA, TEQUILA Y WHISKY".',
+        },
+        {
+            id: "title_format",
+            weight: 12,
+            label: "Formato del título",
+            description: 'Longitud ≤ 40 caracteres, sin info clínica verbosa, asterisco solo al final (médico preferido — nunca doble ni en medio), iniciales del vet al final si están presentes. "MANEJO INTRAHOSPITALARIO MINNIE" o "DUTTON FPO**" fallan.',
+        },
+        {
+            id: "scheduling_date",
+            weight: 8,
+            label: "Fecha en que se agendó",
+            description: 'Fecha de la anotación de quién agendó, junto a sus iniciales. Ejemplos: "AGENDO XZA 16 MAYO", "AG YMP 14.05.26", "AGENDADO POR SLR 02/12/25". Permite medir el lead time entre cuándo se agendó y cuándo es la cita.',
+        },
+        {
+            id: "scheduler",
+            weight: 12,
+            label: "Iniciales de quien agendó",
+            description: 'Iniciales (col_code) del colaborador que agendó la cita, dentro de la descripción. Formatos válidos: "AGENDO XZA", "AG YMP", "AGENDADO POR SLR". Crítico para rastrear responsable de la calidad de la agenda.',
+        },
+        {
+            id: "context",
+            weight: 8,
+            label: "Motivo / contexto",
+            description: 'La descripción tiene contexto clínico relevante (motivo de la visita, síntomas, antecedentes) más allá del nombre y teléfono. Mínimo 20 caracteres tras descontar nombre, teléfono y Q{id}.',
+        },
+        {
+            id: "owner_name",
+            weight: 8,
+            label: "Nombre del tutor",
+            description: 'Nombre del cliente/tutor. Auto-pasa si hay Q{id} en la descripción (cliente linkeado a QVET) o si el teléfono matchea un cliente QVET existente. Si no, busca nombre completo del tutor en la descripción (mínimo 2 palabras, mayúsculas/minúsculas con letras).',
+        },
+        {
+            id: "owner_phone",
+            weight: 8,
+            label: "Teléfono del tutor",
+            description: 'Teléfono del tutor en cualquier formato común (con o sin +52, con o sin separadores). Auto-pasa si hay Q{id} (sabemos el teléfono del registro QVET). Necesario para confirmar la cita y avisar de cambios.',
+        },
+        {
+            id: "pet_age",
+            weight: 4,
+            label: "Edad de la mascota",
+            description: 'Edad anotada en la descripción: "4 meses", "1 año y 4 meses", "8 semanas", "2 años". Importante para vacunación, dosis y diagnóstico.',
+        },
+        {
+            id: "pet_breed",
+            weight: 4,
+            label: "Raza de la mascota",
+            description: 'Raza detectada en la descripción contra un diccionario de razas comunes: Yorkie, Shih Tzu, Cocker Spaniel, French Bulldog, Chihuahua, Schnauzer, Golden Retriever, Labrador, Persa, Siamés, mestizo, etc. Útil para protocolos clínicos y dosificación.',
+        },
+        {
+            id: "discount_format",
+            weight: 4,
+            label: "Formato de descuento",
+            description: 'Si la descripción menciona un descuento (contiene un patrón \\d+%), debe seguir el formato "<porcentaje>% <razón>" — ejemplos: "15% recordatorio", "10% nuevo cliente", "30% primera vez", "50% cortesía". Si no hay descuento mencionado, esta dimensión pasa automáticamente.',
+        },
+    ],
+};
 /**
  * Backward-compatible alias for existing code/tests that imported `STANDARD_V1`.
- * Always points to the current standard.
+ * Always points to the current standard (V3 as of 13.5.0).
  *
- * @deprecated Use `STANDARD_V2` (or whatever the current version is) explicitly.
+ * @deprecated Use `STANDARD_V3` (or whatever the current version is) explicitly.
  */
-exports.STANDARD_V1 = exports.STANDARD_V2;
+exports.STANDARD_V1 = exports.STANDARD_V3;
 // ─── ColorId → Branch mapping ────────────────────────────────────────────────
 /**
  * Google Calendar colorId values mapped to HVP branches.

package/dist/contracts/google-calendar/responses.d.ts

@@ -5,9 +5,15 @@
  * See: resources/notes/google-calendar/standard-v1.md
  */
 /**
- * One of the six dimensions of the appointment standard.
+ * Dimensions of the appointment standard.
+ *
+ * V3 (current): 12 dimensions — title split into 3, discount_format added.
+ * V2 (frozen): 10 dimensions — `title` and `pet_name` used instead of the V3 split.
+ *
+ * All IDs from both versions are kept in the union so historical V2 results
+ * remain typeable.
  */
-export type AppointmentStandardDimensionId = 'branch' | 'title' | 'pet_name' | 'pet_age' | 'pet_breed' | 'owner_name' | 'owner_phone' | 'context' | 'scheduler' | 'scheduling_date';
+export type AppointmentStandardDimensionId = 'branch' | 'title_format' | 'title_service_code' | 'title_pet_name' | 'title' | 'pet_name' | 'pet_age' | 'pet_breed' | 'owner_name' | 'owner_phone' | 'context' | 'scheduler' | 'scheduling_date' | 'discount_format';
 /**
  * One of the three branches.
  */
@@ -93,6 +99,12 @@ export interface DiagnosticResult {
     isPreferredVet: boolean;
     /** True iff event has extendedProperties.private (HVP-created). */
     isHvpCreated: boolean;
+    /**
+     * GCal event creation timestamp (ISO datetime, UTC) — ground truth of when
+     * the appointment was actually scheduled, independent of any text annotation
+     * like "AGENDO XYZ 16 MAYO" in the description. Null if missing from API.
+     */
+    eventCreatedAt: string | null;
 }
 /**
  * Excluded event — does not have a score.
@@ -141,6 +153,16 @@ export interface DiagnoseAppointmentsResponse {
         preferredCount: number;
         avgScore: number;
     }>;
+    /**
+     * Per-scheduler breakdown — col_code of the colaborador who annotated the
+     * appointment (`AGENDO XYZ ...`). The `unknown` bucket captures events with
+     * no scheduler annotation — typically the largest, and the most actionable
+     * gap to close.
+     */
+    bySchedule: Record<string, {
+        count: number;
+        avgScore: number;
+    }>;
     /** Detailed results per evaluated event (paginated by caller — capped at 500 in response for now). */
     results: DiagnosticResult[];
     /** Detailed excluded events (capped at 100). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hvp-shared",
-  "version": "13.4.1",
+  "version": "13.6.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",