hvp-shared 13.3.0 → 13.4.1

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

@@ -13,10 +13,21 @@
  */
 import type { AppointmentBranch, AppointmentStandard } from "../contracts/google-calendar/responses";
 /**
- * Multi-factor appointment standard v1.
+ * Multi-factor appointment standard v2.
+ *
+ * Ten dimensions covering everything a recepción needs to capture to make an
+ * appointment actionable: branch, title format, pet identity (name/age/breed),
+ * tutor identity (name/phone), motive, and scheduling provenance (who and when).
  *
  * Weights sum to 100. An event is "compliant" when its score >= 80.
  */
+export declare const STANDARD_V2: AppointmentStandard;
+/**
+ * Backward-compatible alias for existing code/tests that imported `STANDARD_V1`.
+ * Always points to the current standard.
+ *
+ * @deprecated Use `STANDARD_V2` (or whatever the current version is) explicitly.
+ */
 export declare const STANDARD_V1: AppointmentStandard;
 /**
  * Google Calendar colorId values mapped to HVP branches.
@@ -107,6 +118,32 @@ export declare const PHONE_REGEX: RegExp;
  *   "AGENDADO POR SLR 02/12/25"
  */
 export declare const SCHEDULER_REGEX: RegExp;
+/**
+ * Captures the "agendado por" col_code AND the date annotation that often follows it.
+ *
+ *   "AGENDO XZA 16 MAYO"            → groups: XZA, "16 MAYO"
+ *   "AG YMP 14.05.26"               → groups: YMP, "14.05.26"
+ *   "AGENDADA POR SLR 02/12/25"     → groups: SLR, "02/12/25"
+ *   "AGENDADO POR SLR"              → groups: SLR, undefined
+ */
+export declare const SCHEDULER_WITH_DATE_REGEX: RegExp;
+/**
+ * Captures pet age expressions in Spanish from descriptions.
+ *
+ *   "YORKIE 4 MESES"             → "4 MESES"
+ *   "11 MESES, COCKER SPANIEL"    → "11 MESES"
+ *   "1 año y 4 meses"            → "1 año y 4 meses"
+ *   "8 semanas"                  → "8 semanas"
+ *   "2 AÑOS"                     → "2 AÑOS"
+ */
+export declare const PET_AGE_REGEX: RegExp;
+/**
+ * Common dog/cat breeds observed in HVP descriptions. Used by the parser to
+ * detect a breed mention. Match is case-insensitive whole-word.
+ *
+ * NOT exhaustive — extend as new breeds appear in real data.
+ */
+export declare const KNOWN_BREEDS: readonly string[];
 /**
  * Keys used in Google Calendar `extendedProperties.private` for events created
  * from HVP. Phase 2 writes these; Phase 1 reads them for full attribution.

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

@@ -13,25 +13,90 @@
  * runs remain reproducible.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HVP_EVENT_PROP_KEYS = 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 = 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_V2 = void 0;
 // ─── Standard v1 ─────────────────────────────────────────────────────────────
 /**
- * Multi-factor appointment standard v1.
+ * Multi-factor appointment standard v2.
+ *
+ * Ten dimensions covering everything a recepción needs to capture to make an
+ * appointment actionable: branch, title format, pet identity (name/age/breed),
+ * tutor identity (name/phone), motive, and scheduling provenance (who and when).
  *
  * Weights sum to 100. An event is "compliant" when its score >= 80.
  */
-exports.STANDARD_V1 = {
-    version: "1.0",
+exports.STANDARD_V2 = {
+    version: "2.0",
     minimumCompliantScore: 80,
     dimensions: [
-        { id: "branch", weight: 15, label: "Sucursal" },
-        { id: "service", weight: 20, label: "Servicio" },
-        { id: "pet", weight: 15, label: "Paciente" },
-        { id: "client", weight: 25, label: "Cliente (linkable a QVET)" },
-        { id: "context", weight: 10, label: "Motivo / contexto" },
-        { id: "vet", weight: 15, label: "Atribución del vet" },
+        {
+            id: "branch",
+            weight: 10,
+            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",
+            weight: 10,
+            label: "Título bien formado",
+            description: 'El título empieza con un código de servicio reconocible 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), AP/APL/AM (aplicación), D (desparasitación), etc.',
+        },
+        {
+            id: "pet_name",
+            weight: 10,
+            label: "Nombre de la mascota",
+            description: 'Nombre de la mascota detectable en el título (después del código de servicio y antes de las iniciales del vet). Ej: "C. MILO RGL*" → mascota = MILO.',
+        },
+        {
+            id: "pet_age",
+            weight: 8,
+            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 — sin edad, no se puede protocolizar.',
+        },
+        {
+            id: "pet_breed",
+            weight: 8,
+            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: "owner_name",
+            weight: 12,
+            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: 12,
+            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: "context",
+            weight: 10,
+            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: "scheduler",
+            weight: 10,
+            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". Permite reportar productividad por persona.',
+        },
+        {
+            id: "scheduling_date",
+            weight: 10,
+            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.',
+        },
     ],
 };
+/**
+ * Backward-compatible alias for existing code/tests that imported `STANDARD_V1`.
+ * Always points to the current standard.
+ *
+ * @deprecated Use `STANDARD_V2` (or whatever the current version is) explicitly.
+ */
+exports.STANDARD_V1 = exports.STANDARD_V2;
 // ─── ColorId → Branch mapping ────────────────────────────────────────────────
 /**
  * Google Calendar colorId values mapped to HVP branches.
@@ -243,6 +308,108 @@ exports.PHONE_REGEX = /(?:\+?52\s?1?\s?)?(?:\d{3}[\s-]?\d{3}[\s-]?\d{4}|\d{10})/
  *   "AGENDADO POR SLR 02/12/25"
  */
 exports.SCHEDULER_REGEX = /\b(?:AG|AGENDO|AGENDAD[OA]\s+POR)\s+([A-Z]{2,4})\b/i;
+/**
+ * Captures the "agendado por" col_code AND the date annotation that often follows it.
+ *
+ *   "AGENDO XZA 16 MAYO"            → groups: XZA, "16 MAYO"
+ *   "AG YMP 14.05.26"               → groups: YMP, "14.05.26"
+ *   "AGENDADA POR SLR 02/12/25"     → groups: SLR, "02/12/25"
+ *   "AGENDADO POR SLR"              → groups: SLR, undefined
+ */
+exports.SCHEDULER_WITH_DATE_REGEX = /\b(?:AG|AGENDO|AGENDAD[OA]\s+POR)\s+([A-Z]{2,4})(?:\s+(\d{1,2}[./\-]\d{1,2}(?:[./\-]\d{2,4})?|\d{1,2}\s+(?:ENE|FEB|MAR|ABR|MAY|JUN|JUL|AGO|SEP|OCT|NOV|DIC|ENERO|FEBRERO|MARZO|ABRIL|MAYO|JUNIO|JULIO|AGOSTO|SEPTIEMBRE|OCTUBRE|NOVIEMBRE|DICIEMBRE)))?\b/i;
+// ─── Pet age detection ───────────────────────────────────────────────────────
+/**
+ * Captures pet age expressions in Spanish from descriptions.
+ *
+ *   "YORKIE 4 MESES"             → "4 MESES"
+ *   "11 MESES, COCKER SPANIEL"    → "11 MESES"
+ *   "1 año y 4 meses"            → "1 año y 4 meses"
+ *   "8 semanas"                  → "8 semanas"
+ *   "2 AÑOS"                     → "2 AÑOS"
+ */
+exports.PET_AGE_REGEX = /\b\d+\s*(?:años?|añoss?|meses?|semanas?|días?|años?\s+y\s+\d+\s+meses?)\b/i;
+// ─── Pet breed detection ────────────────────────────────────────────────────
+/**
+ * Common dog/cat breeds observed in HVP descriptions. Used by the parser to
+ * detect a breed mention. Match is case-insensitive whole-word.
+ *
+ * NOT exhaustive — extend as new breeds appear in real data.
+ */
+exports.KNOWN_BREEDS = [
+    // Perros
+    "yorkie",
+    "yorkshire",
+    "shih tzu",
+    "shihtzu",
+    "schnauzer",
+    "schnauzer mini",
+    "cocker spaniel",
+    "cocker",
+    "golden retriever",
+    "golden",
+    "labrador",
+    "labrador retriever",
+    "chihuahua",
+    "bulldog",
+    "bulldog frances",
+    "bulldog francés",
+    "bulldog ingles",
+    "bulldog inglés",
+    "french bulldog",
+    "poodle",
+    "french poodle",
+    "caniche",
+    "bichon",
+    "bichón",
+    "bichon maltes",
+    "maltes",
+    "maltés",
+    "border collie",
+    "border",
+    "pug",
+    "carlino",
+    "pastor aleman",
+    "pastor alemán",
+    "pastor",
+    "husky",
+    "husky siberiano",
+    "boxer",
+    "boxer aleman",
+    "pitbull",
+    "pit bull",
+    "american bully",
+    "doberman",
+    "rottweiler",
+    "dachshund",
+    "salchicha",
+    "beagle",
+    "dalmata",
+    "dalmata",
+    "san bernardo",
+    "akita",
+    "shar pei",
+    "sharpei",
+    "mestizo",
+    "criollo",
+    "xolo",
+    "xoloitzcuintle",
+    "chow chow",
+    // Gatos
+    "persa",
+    "siames",
+    "siamés",
+    "british shorthair",
+    "maine coon",
+    "ragdoll",
+    "bengala",
+    "esfinge",
+    "sphynx",
+    "mestizo",
+    "domestic shorthair",
+    "domestic short hair",
+    "domestico",
+    "doméstico",
+];
 // ─── HVP-created extendedProperties keys ─────────────────────────────────────
 /**
  * Keys used in Google Calendar `extendedProperties.private` for events created

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

@@ -1,21 +1,38 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const google_calendar_constants_1 = require("./google-calendar.constants");
-describe("STANDARD_V1", () => {
+describe("STANDARD_V2", () => {
     it("has weights that sum to 100", () => {
-        const total = google_calendar_constants_1.STANDARD_V1.dimensions.reduce((sum, d) => sum + d.weight, 0);
+        const total = google_calendar_constants_1.STANDARD_V2.dimensions.reduce((sum, d) => sum + d.weight, 0);
         expect(total).toBe(100);
     });
-    it("declares exactly the six expected dimensions", () => {
-        const ids = google_calendar_constants_1.STANDARD_V1.dimensions.map((d) => d.id).sort();
-        expect(ids).toEqual(["branch", "client", "context", "pet", "service", "vet"]);
+    it("declares the ten expected dimensions", () => {
+        const ids = google_calendar_constants_1.STANDARD_V2.dimensions.map((d) => d.id).sort();
+        expect(ids).toEqual([
+            "branch",
+            "context",
+            "owner_name",
+            "owner_phone",
+            "pet_age",
+            "pet_breed",
+            "pet_name",
+            "scheduler",
+            "scheduling_date",
+            "title",
+        ]);
+    });
+    it("every dimension has a label and a description (used by the dashboard tooltip)", () => {
+        for (const dim of google_calendar_constants_1.STANDARD_V2.dimensions) {
+            expect(dim.label.length).toBeGreaterThan(0);
+            expect(dim.description.length).toBeGreaterThan(0);
+        }
     });
     it("has a sensible compliance threshold", () => {
-        expect(google_calendar_constants_1.STANDARD_V1.minimumCompliantScore).toBeGreaterThanOrEqual(50);
-        expect(google_calendar_constants_1.STANDARD_V1.minimumCompliantScore).toBeLessThanOrEqual(100);
+        expect(google_calendar_constants_1.STANDARD_V2.minimumCompliantScore).toBeGreaterThanOrEqual(50);
+        expect(google_calendar_constants_1.STANDARD_V2.minimumCompliantScore).toBeLessThanOrEqual(100);
     });
-    it("has a non-empty version string", () => {
-        expect(google_calendar_constants_1.STANDARD_V1.version).toMatch(/^\d+\.\d+$/);
+    it("uses semver-like version 2.x", () => {
+        expect(google_calendar_constants_1.STANDARD_V2.version).toMatch(/^2\.\d+$/);
     });
 });
 describe("Branch ↔ colorId mapping", () => {
@@ -112,4 +129,50 @@ describe("Description regexes", () => {
             expect(match?.[1]?.toUpperCase()).toBe(expected);
         }
     });
+    it("SCHEDULER_WITH_DATE_REGEX captures both col_code and date annotation", () => {
+        const cases = [
+            ["AGENDO XZA 16 MAYO", "XZA", "16 MAYO"],
+            ["AG YMP 14.05.26", "YMP", "14.05.26"],
+            ["AGENDADA POR SLR 02/12/25", "SLR", "02/12/25"],
+            ["AGENDADO POR SCP", "SCP", undefined],
+        ];
+        for (const [text, codeExp, dateExp] of cases) {
+            const match = text.match(google_calendar_constants_1.SCHEDULER_WITH_DATE_REGEX);
+            expect(match?.[1]?.toUpperCase()).toBe(codeExp);
+            if (dateExp) {
+                expect(match?.[2]?.toUpperCase()).toBe(dateExp.toUpperCase());
+            }
+            else {
+                expect(match?.[2]).toBeUndefined();
+            }
+        }
+    });
+});
+describe("PET_AGE_REGEX", () => {
+    it("detects age in months / years / weeks", () => {
+        expect("YORKIE 4 MESES".match(google_calendar_constants_1.PET_AGE_REGEX)?.[0]?.toUpperCase()).toBe("4 MESES");
+        expect("11 MESES, COCKER SPANIEL".match(google_calendar_constants_1.PET_AGE_REGEX)?.[0]?.toUpperCase()).toBe("11 MESES");
+        expect("Shih tzu 1 año y 4 meses".match(google_calendar_constants_1.PET_AGE_REGEX)?.[0]?.toLowerCase()).toContain("1 año");
+        expect("8 semanas".match(google_calendar_constants_1.PET_AGE_REGEX)?.[0]).toBe("8 semanas");
+        expect("2 AÑOS".match(google_calendar_constants_1.PET_AGE_REGEX)?.[0]).toBe("2 AÑOS");
+    });
+    it("does not match arbitrary numbers", () => {
+        expect("Peso: 8.7 Kg".match(google_calendar_constants_1.PET_AGE_REGEX)).toBeNull();
+        expect("Cytopoint 30MG".match(google_calendar_constants_1.PET_AGE_REGEX)).toBeNull();
+    });
+});
+describe("KNOWN_BREEDS", () => {
+    it("includes common breeds observed in the discovery data", () => {
+        const lower = google_calendar_constants_1.KNOWN_BREEDS.map((b) => b.toLowerCase());
+        expect(lower).toContain("yorkie");
+        expect(lower).toContain("shih tzu");
+        expect(lower).toContain("cocker spaniel");
+        expect(lower).toContain("french bulldog");
+        expect(lower).toContain("chihuahua");
+    });
+    it("includes both dog and cat breeds", () => {
+        const lower = google_calendar_constants_1.KNOWN_BREEDS.map((b) => b.toLowerCase());
+        expect(lower.some((b) => b.includes("persa"))).toBe(true);
+        expect(lower.some((b) => b.includes("maine"))).toBe(true);
+    });
 });

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

@@ -7,7 +7,7 @@
 /**
  * One of the six dimensions of the appointment standard.
  */
-export type AppointmentStandardDimensionId = 'branch' | 'service' | 'pet' | 'client' | 'context' | 'vet';
+export type AppointmentStandardDimensionId = 'branch' | 'title' | 'pet_name' | 'pet_age' | 'pet_breed' | 'owner_name' | 'owner_phone' | 'context' | 'scheduler' | 'scheduling_date';
 /**
  * One of the three branches.
  */
@@ -28,6 +28,8 @@ export interface AppointmentStandard {
         weight: number;
         /** Display label in Spanish. */
         label: string;
+        /** One-sentence explanation of what the dimension evaluates (shown as a tooltip in the frontend). */
+        description: string;
     }>;
     /** Threshold above which an event is considered "compliant". */
     minimumCompliantScore: number;
@@ -71,10 +73,18 @@ export interface DiagnosticResult {
     inferredService: string | null;
     /** Inferred pet name from the title. */
     inferredPetName: string | null;
+    /** Pet age detected from description (e.g. "4 meses", "1 año"). Null if not found. */
+    inferredPetAge: string | null;
+    /** Pet breed detected from description (e.g. "YORKIE", "SHIH TZU"). Null if not found. */
+    inferredPetBreed: string | null;
+    /** Tutor (client) full name as detected from description. */
+    inferredOwnerName: string | null;
     /** col_code of the attending vet, when detectable. */
     inferredVetColCode: string | null;
     /** col_code of the person who scheduled, when detectable in description. */
     inferredSchedulerColCode: string | null;
+    /** Date string near the scheduler annotation (e.g. "16 MAYO", "02/12/25"). Null if not found. */
+    inferredSchedulingDate: string | null;
     /** Q{id} or null. */
     inferredQvetClientId: string | null;
     /** Last 10 digits of phone, normalized. Null if not found. */

package/package.json

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