hvp-shared 13.5.0 → 13.7.0

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

@@ -109,7 +109,7 @@ exports.STANDARD_V3 = {
     dimensions: [
         {
             id: "branch",
-            weight: 12,
+            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.',
         },
@@ -139,9 +139,9 @@ exports.STANDARD_V3 = {
         },
         {
             id: "scheduler",
-            weight: 8,
+            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". Permite reportar productividad por persona.',
+            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",

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

@@ -99,6 +99,24 @@ 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;
+    /**
+     * Raw event description as it appears in Google Calendar — unprocessed,
+     * line-break-preserved. Used by the dashboard's detail view to show what
+     * recepción actually typed (vs. the inferred fields). Null if empty.
+     */
+    rawDescription: string | null;
+    /**
+     * Raw GCal colorId — numeric string like "11" (Tomato) or "9" (Blueberry).
+     * Used by the dashboard's detail view to disambiguate visually similar
+     * tones. Null if event uses the default color.
+     */
+    colorId: string | null;
 }
 /**
  * Excluded event — does not have a score.
@@ -147,6 +165,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.5.0",
+  "version": "13.7.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",