observability-toolkit 2.0.0 → 2.1.0

package/dist/lib/quality/quality-views.d.ts

@@ -0,0 +1,966 @@
+/**
+ * Role-Specific Views (G7) and Progressive Disclosure (G3)
+ *
+ * Projects dashboard summary data into role-specific views (executive, operator, auditor)
+ * and provides progressive disclosure with metric detail drill-downs.
+ *
+ * @see quality-metrics.ts for core types
+ */
+import { z } from 'zod';
+import { type EvaluationResult } from '../../backends/index.js';
+import { type QualityDashboardSummary, type QualityMetricConfig, qualityMetricResultSchema } from './quality-metrics.js';
+import { type RoleType } from './quality-constants.js';
+/** Per-metric name/status summary item (used in executive view heatmap). */
+export declare const metricStatusItemSchema: z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    status: z.ZodString;
+}, z.core.$strip>;
+/** Top-issue item: worst-status metric with alert count. */
+export declare const topIssueItemSchema: z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    status: z.ZodString;
+    alertCount: z.ZodNumber;
+}, z.core.$strip>;
+/** Degrading trend item: metric name with full trend breakdown. */
+export declare const degradingTrendItemSchema: z.ZodObject<{
+    metricName: z.ZodString;
+    trend: z.ZodObject<{
+        direction: z.ZodEnum<{
+            improving: "improving";
+            degrading: "degrading";
+            stable: "stable";
+        }>;
+        delta: z.ZodNumber;
+        percentChange: z.ZodNullable<z.ZodNumber>;
+        previousValue: z.ZodNumber;
+        currentValue: z.ZodNumber;
+        aggregation: z.ZodEnum<{
+            avg: "avg";
+            min: "min";
+            max: "max";
+            count: "count";
+            p50: "p50";
+            p95: "p95";
+            p99: "p99";
+        }>;
+        lowSampleWarning: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Executive view: high-level summary with posture heatmap data.
+ * Minimal detail, focused on overall status and trends.
+ */
+export declare const executiveViewSchema: z.ZodObject<{
+    role: z.ZodLiteral<"executive">;
+    overallStatus: z.ZodEnum<{
+        warning: "warning";
+        critical: "critical";
+        healthy: "healthy";
+        no_data: "no_data";
+    }>;
+    summary: z.ZodObject<{
+        totalMetrics: z.ZodInt;
+        healthyMetrics: z.ZodInt;
+        warningMetrics: z.ZodInt;
+        criticalMetrics: z.ZodInt;
+        noDataMetrics: z.ZodInt;
+    }, z.core.$strip>;
+    metricStatuses: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        status: z.ZodString;
+    }, z.core.$strip>>;
+    alertCounts: z.ZodObject<{
+        info: z.ZodNumber;
+        warning: z.ZodNumber;
+        critical: z.ZodNumber;
+    }, z.core.$strip>;
+    topIssues: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        status: z.ZodString;
+        alertCount: z.ZodNumber;
+    }, z.core.$strip>>;
+    slaCompliantCount: z.ZodOptional<z.ZodNumber>;
+    slaTotalCount: z.ZodOptional<z.ZodNumber>;
+    cqi: z.ZodOptional<z.ZodObject<{
+        featureVersion: z.ZodString;
+        value: z.ZodNumber;
+        weights: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        contributions: z.ZodArray<z.ZodObject<{
+            metric: z.ZodString;
+            rawScore: z.ZodNumber;
+            normalizedScore: z.ZodNumber;
+            weight: z.ZodNumber;
+            contribution: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ExecutiveView = z.infer<typeof executiveViewSchema>;
+/**
+ * Operator view: actionable alerts with remediation guidance.
+ * Prioritized queue of alerts with full context.
+ */
+export declare const operatorViewSchema: z.ZodObject<{
+    role: z.ZodLiteral<"operator">;
+    overallStatus: z.ZodEnum<{
+        warning: "warning";
+        critical: "critical";
+        healthy: "healthy";
+        no_data: "no_data";
+    }>;
+    prioritizedAlerts: z.ZodArray<z.ZodObject<{
+        severity: z.ZodEnum<{
+            info: "info";
+            warning: "warning";
+            critical: "critical";
+        }>;
+        message: z.ZodString;
+        aggregation: z.ZodEnum<{
+            avg: "avg";
+            min: "min";
+            max: "max";
+            count: "count";
+            p50: "p50";
+            p95: "p95";
+            p99: "p99";
+        }>;
+        threshold: z.ZodNumber;
+        actualValue: z.ZodNumber;
+        direction: z.ZodEnum<{
+            above: "above";
+            below: "below";
+        }>;
+        affectedCount: z.ZodOptional<z.ZodInt>;
+        remediationHints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        relatedMetrics: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        isCompound: z.ZodOptional<z.ZodBoolean>;
+        divergenceDetails: z.ZodOptional<z.ZodObject<{
+            entropy: z.ZodNumber;
+            entropyThreshold: z.ZodNumber;
+            bins: z.ZodInt;
+            histogram: z.ZodArray<z.ZodInt>;
+        }, z.core.$strip>>;
+        metricName: z.ZodString;
+    }, z.core.$strip>>;
+    alertingMetrics: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        values: z.ZodRecord<z.ZodEnum<{
+            avg: "avg";
+            min: "min";
+            max: "max";
+            count: "count";
+            p50: "p50";
+            p95: "p95";
+            p99: "p99";
+        }>, z.ZodNullable<z.ZodNumber>>;
+        sampleCount: z.ZodInt;
+        alerts: z.ZodArray<z.ZodObject<{
+            severity: z.ZodEnum<{
+                info: "info";
+                warning: "warning";
+                critical: "critical";
+            }>;
+            message: z.ZodString;
+            aggregation: z.ZodEnum<{
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count: "count";
+                p50: "p50";
+                p95: "p95";
+                p99: "p99";
+            }>;
+            threshold: z.ZodNumber;
+            actualValue: z.ZodNumber;
+            direction: z.ZodEnum<{
+                above: "above";
+                below: "below";
+            }>;
+            affectedCount: z.ZodOptional<z.ZodInt>;
+            remediationHints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            relatedMetrics: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            isCompound: z.ZodOptional<z.ZodBoolean>;
+            divergenceDetails: z.ZodOptional<z.ZodObject<{
+                entropy: z.ZodNumber;
+                entropyThreshold: z.ZodNumber;
+                bins: z.ZodInt;
+                histogram: z.ZodArray<z.ZodInt>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        status: z.ZodEnum<{
+            warning: "warning";
+            critical: "critical";
+            healthy: "healthy";
+            no_data: "no_data";
+        }>;
+        period: z.ZodOptional<z.ZodObject<{
+            start: z.ZodISODateTime;
+            end: z.ZodISODateTime;
+        }, z.core.$strip>>;
+        worstExplanation: z.ZodOptional<z.ZodObject<{
+            score: z.ZodNumber;
+            explanation: z.ZodOptional<z.ZodString>;
+            traceId: z.ZodOptional<z.ZodString>;
+            timestamp: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        trend: z.ZodOptional<z.ZodObject<{
+            direction: z.ZodEnum<{
+                improving: "improving";
+                degrading: "degrading";
+                stable: "stable";
+            }>;
+            delta: z.ZodNumber;
+            percentChange: z.ZodNullable<z.ZodNumber>;
+            previousValue: z.ZodNumber;
+            currentValue: z.ZodNumber;
+            aggregation: z.ZodEnum<{
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count: "count";
+                p50: "p50";
+                p95: "p95";
+                p99: "p99";
+            }>;
+            lowSampleWarning: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        confidence: z.ZodOptional<z.ZodObject<{
+            level: z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+            }>;
+            sampleCount: z.ZodInt;
+            scoreStdDev: z.ZodNullable<z.ZodNumber>;
+            evaluatorCount: z.ZodInt;
+            evaluatorAgreement: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    degradingTrends: z.ZodArray<z.ZodObject<{
+        metricName: z.ZodString;
+        trend: z.ZodObject<{
+            direction: z.ZodEnum<{
+                improving: "improving";
+                degrading: "degrading";
+                stable: "stable";
+            }>;
+            delta: z.ZodNumber;
+            percentChange: z.ZodNullable<z.ZodNumber>;
+            previousValue: z.ZodNumber;
+            currentValue: z.ZodNumber;
+            aggregation: z.ZodEnum<{
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count: "count";
+                p50: "p50";
+                p95: "p95";
+                p99: "p99";
+            }>;
+            lowSampleWarning: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type OperatorView = z.infer<typeof operatorViewSchema>;
+/**
+ * Auditor view: evidence trails with full provenance.
+ * Complete data for compliance and audit reporting.
+ */
+export declare const auditorViewSchema: z.ZodObject<{
+    role: z.ZodLiteral<"auditor">;
+    metrics: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        values: z.ZodRecord<z.ZodEnum<{
+            avg: "avg";
+            min: "min";
+            max: "max";
+            count: "count";
+            p50: "p50";
+            p95: "p95";
+            p99: "p99";
+        }>, z.ZodNullable<z.ZodNumber>>;
+        sampleCount: z.ZodInt;
+        alerts: z.ZodArray<z.ZodObject<{
+            severity: z.ZodEnum<{
+                info: "info";
+                warning: "warning";
+                critical: "critical";
+            }>;
+            message: z.ZodString;
+            aggregation: z.ZodEnum<{
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count: "count";
+                p50: "p50";
+                p95: "p95";
+                p99: "p99";
+            }>;
+            threshold: z.ZodNumber;
+            actualValue: z.ZodNumber;
+            direction: z.ZodEnum<{
+                above: "above";
+                below: "below";
+            }>;
+            affectedCount: z.ZodOptional<z.ZodInt>;
+            remediationHints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            relatedMetrics: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            isCompound: z.ZodOptional<z.ZodBoolean>;
+            divergenceDetails: z.ZodOptional<z.ZodObject<{
+                entropy: z.ZodNumber;
+                entropyThreshold: z.ZodNumber;
+                bins: z.ZodInt;
+                histogram: z.ZodArray<z.ZodInt>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        status: z.ZodEnum<{
+            warning: "warning";
+            critical: "critical";
+            healthy: "healthy";
+            no_data: "no_data";
+        }>;
+        period: z.ZodOptional<z.ZodObject<{
+            start: z.ZodISODateTime;
+            end: z.ZodISODateTime;
+        }, z.core.$strip>>;
+        worstExplanation: z.ZodOptional<z.ZodObject<{
+            score: z.ZodNumber;
+            explanation: z.ZodOptional<z.ZodString>;
+            traceId: z.ZodOptional<z.ZodString>;
+            timestamp: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        trend: z.ZodOptional<z.ZodObject<{
+            direction: z.ZodEnum<{
+                improving: "improving";
+                degrading: "degrading";
+                stable: "stable";
+            }>;
+            delta: z.ZodNumber;
+            percentChange: z.ZodNullable<z.ZodNumber>;
+            previousValue: z.ZodNumber;
+            currentValue: z.ZodNumber;
+            aggregation: z.ZodEnum<{
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count: "count";
+                p50: "p50";
+                p95: "p95";
+                p99: "p99";
+            }>;
+            lowSampleWarning: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        confidence: z.ZodOptional<z.ZodObject<{
+            level: z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+            }>;
+            sampleCount: z.ZodInt;
+            scoreStdDev: z.ZodNullable<z.ZodNumber>;
+            evaluatorCount: z.ZodInt;
+            evaluatorAgreement: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    alerts: z.ZodArray<z.ZodObject<{
+        severity: z.ZodEnum<{
+            info: "info";
+            warning: "warning";
+            critical: "critical";
+        }>;
+        message: z.ZodString;
+        aggregation: z.ZodEnum<{
+            avg: "avg";
+            min: "min";
+            max: "max";
+            count: "count";
+            p50: "p50";
+            p95: "p95";
+            p99: "p99";
+        }>;
+        threshold: z.ZodNumber;
+        actualValue: z.ZodNumber;
+        direction: z.ZodEnum<{
+            above: "above";
+            below: "below";
+        }>;
+        affectedCount: z.ZodOptional<z.ZodInt>;
+        remediationHints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        relatedMetrics: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        isCompound: z.ZodOptional<z.ZodBoolean>;
+        divergenceDetails: z.ZodOptional<z.ZodObject<{
+            entropy: z.ZodNumber;
+            entropyThreshold: z.ZodNumber;
+            bins: z.ZodInt;
+            histogram: z.ZodArray<z.ZodInt>;
+        }, z.core.$strip>>;
+        metricName: z.ZodString;
+    }, z.core.$strip>>;
+    slaCompliance: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        sla: z.ZodObject<{
+            metric: z.ZodString;
+            aggregation: z.ZodEnum<{
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count: "count";
+                p50: "p50";
+                p95: "p95";
+                p99: "p99";
+            }>;
+            target: z.ZodNumber;
+            direction: z.ZodEnum<{
+                above: "above";
+                below: "below";
+            }>;
+            window: z.ZodOptional<z.ZodEnum<{
+                "7d rolling": "7d rolling";
+                "14d rolling": "14d rolling";
+                "30d rolling": "30d rolling";
+                "60d rolling": "60d rolling";
+                "90d rolling": "90d rolling";
+                "calendar day": "calendar day";
+                "calendar week": "calendar week";
+                "calendar month": "calendar month";
+                "calendar quarter": "calendar quarter";
+                "calendar year": "calendar year";
+            }>>;
+        }, z.core.$strip>;
+        compliant: z.ZodBoolean;
+        status: z.ZodEnum<{
+            compliant: "compliant";
+            non_compliant: "non_compliant";
+            no_data: "no_data";
+            metric_not_found: "metric_not_found";
+        }>;
+        actualValue: z.ZodNullable<z.ZodNumber>;
+        gap: z.ZodNullable<z.ZodNumber>;
+        marginPercent: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    timestamp: z.ZodString;
+    totalEvaluationCount: z.ZodNumber;
+}, z.core.$strip>;
+export type AuditorView = z.infer<typeof auditorViewSchema>;
+/** Discriminated union of all role-specific views. */
+export declare const roleViewSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    role: z.ZodLiteral<"executive">;
+    overallStatus: z.ZodEnum<{
+        warning: "warning";
+        critical: "critical";
+        healthy: "healthy";
+        no_data: "no_data";
+    }>;
+    summary: z.ZodObject<{
+        totalMetrics: z.ZodInt;
+        healthyMetrics: z.ZodInt;
+        warningMetrics: z.ZodInt;
+        criticalMetrics: z.ZodInt;
+        noDataMetrics: z.ZodInt;
+    }, z.core.$strip>;
+    metricStatuses: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        status: z.ZodString;
+    }, z.core.$strip>>;
+    alertCounts: z.ZodObject<{
+        info: z.ZodNumber;
+        warning: z.ZodNumber;
+        critical: z.ZodNumber;
+    }, z.core.$strip>;
+    topIssues: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        status: z.ZodString;
+        alertCount: z.ZodNumber;
+    }, z.core.$strip>>;
+    slaCompliantCount: z.ZodOptional<z.ZodNumber>;
+    slaTotalCount: z.ZodOptional<z.ZodNumber>;
+    cqi: z.ZodOptional<z.ZodObject<{
+        featureVersion: z.ZodString;
+        value: z.ZodNumber;
+        weights: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        contributions: z.ZodArray<z.ZodObject<{
+            metric: z.ZodString;
+            rawScore: z.ZodNumber;
+            normalizedScore: z.ZodNumber;
+            weight: z.ZodNumber;
+            contribution: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    role: z.ZodLiteral<"operator">;
+    overallStatus: z.ZodEnum<{
+        warning: "warning";
+        critical: "critical";
+        healthy: "healthy";
+        no_data: "no_data";
+    }>;
+    prioritizedAlerts: z.ZodArray<z.ZodObject<{
+        severity: z.ZodEnum<{
+            info: "info";
+            warning: "warning";
+            critical: "critical";
+        }>;
+        message: z.ZodString;
+        aggregation: z.ZodEnum<{
+            avg: "avg";
+            min: "min";
+            max: "max";
+            count: "count";
+            p50: "p50";
+            p95: "p95";
+            p99: "p99";
+        }>;
+        threshold: z.ZodNumber;
+        actualValue: z.ZodNumber;
+        direction: z.ZodEnum<{
+            above: "above";
+            below: "below";
+        }>;
+        affectedCount: z.ZodOptional<z.ZodInt>;
+        remediationHints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        relatedMetrics: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        isCompound: z.ZodOptional<z.ZodBoolean>;
+        divergenceDetails: z.ZodOptional<z.ZodObject<{
+            entropy: z.ZodNumber;
+            entropyThreshold: z.ZodNumber;
+            bins: z.ZodInt;
+            histogram: z.ZodArray<z.ZodInt>;
+        }, z.core.$strip>>;
+        metricName: z.ZodString;
+    }, z.core.$strip>>;
+    alertingMetrics: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        values: z.ZodRecord<z.ZodEnum<{
+            avg: "avg";
+            min: "min";
+            max: "max";
+            count: "count";
+            p50: "p50";
+            p95: "p95";
+            p99: "p99";
+        }>, z.ZodNullable<z.ZodNumber>>;
+        sampleCount: z.ZodInt;
+        alerts: z.ZodArray<z.ZodObject<{
+            severity: z.ZodEnum<{
+                info: "info";
+                warning: "warning";
+                critical: "critical";
+            }>;
+            message: z.ZodString;
+            aggregation: z.ZodEnum<{
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count: "count";
+                p50: "p50";
+                p95: "p95";
+                p99: "p99";
+            }>;
+            threshold: z.ZodNumber;
+            actualValue: z.ZodNumber;
+            direction: z.ZodEnum<{
+                above: "above";
+                below: "below";
+            }>;
+            affectedCount: z.ZodOptional<z.ZodInt>;
+            remediationHints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            relatedMetrics: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            isCompound: z.ZodOptional<z.ZodBoolean>;
+            divergenceDetails: z.ZodOptional<z.ZodObject<{
+                entropy: z.ZodNumber;
+                entropyThreshold: z.ZodNumber;
+                bins: z.ZodInt;
+                histogram: z.ZodArray<z.ZodInt>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        status: z.ZodEnum<{
+            warning: "warning";
+            critical: "critical";
+            healthy: "healthy";
+            no_data: "no_data";
+        }>;
+        period: z.ZodOptional<z.ZodObject<{
+            start: z.ZodISODateTime;
+            end: z.ZodISODateTime;
+        }, z.core.$strip>>;
+        worstExplanation: z.ZodOptional<z.ZodObject<{
+            score: z.ZodNumber;
+            explanation: z.ZodOptional<z.ZodString>;
+            traceId: z.ZodOptional<z.ZodString>;
+            timestamp: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        trend: z.ZodOptional<z.ZodObject<{
+            direction: z.ZodEnum<{
+                improving: "improving";
+                degrading: "degrading";
+                stable: "stable";
+            }>;
+            delta: z.ZodNumber;
+            percentChange: z.ZodNullable<z.ZodNumber>;
+            previousValue: z.ZodNumber;
+            currentValue: z.ZodNumber;
+            aggregation: z.ZodEnum<{
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count: "count";
+                p50: "p50";
+                p95: "p95";
+                p99: "p99";
+            }>;
+            lowSampleWarning: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        confidence: z.ZodOptional<z.ZodObject<{
+            level: z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+            }>;
+            sampleCount: z.ZodInt;
+            scoreStdDev: z.ZodNullable<z.ZodNumber>;
+            evaluatorCount: z.ZodInt;
+            evaluatorAgreement: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    degradingTrends: z.ZodArray<z.ZodObject<{
+        metricName: z.ZodString;
+        trend: z.ZodObject<{
+            direction: z.ZodEnum<{
+                improving: "improving";
+                degrading: "degrading";
+                stable: "stable";
+            }>;
+            delta: z.ZodNumber;
+            percentChange: z.ZodNullable<z.ZodNumber>;
+            previousValue: z.ZodNumber;
+            currentValue: z.ZodNumber;
+            aggregation: z.ZodEnum<{
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count: "count";
+                p50: "p50";
+                p95: "p95";
+                p99: "p99";
+            }>;
+            lowSampleWarning: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    role: z.ZodLiteral<"auditor">;
+    metrics: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        values: z.ZodRecord<z.ZodEnum<{
+            avg: "avg";
+            min: "min";
+            max: "max";
+            count: "count";
+            p50: "p50";
+            p95: "p95";
+            p99: "p99";
+        }>, z.ZodNullable<z.ZodNumber>>;
+        sampleCount: z.ZodInt;
+        alerts: z.ZodArray<z.ZodObject<{
+            severity: z.ZodEnum<{
+                info: "info";
+                warning: "warning";
+                critical: "critical";
+            }>;
+            message: z.ZodString;
+            aggregation: z.ZodEnum<{
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count: "count";
+                p50: "p50";
+                p95: "p95";
+                p99: "p99";
+            }>;
+            threshold: z.ZodNumber;
+            actualValue: z.ZodNumber;
+            direction: z.ZodEnum<{
+                above: "above";
+                below: "below";
+            }>;
+            affectedCount: z.ZodOptional<z.ZodInt>;
+            remediationHints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            relatedMetrics: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            isCompound: z.ZodOptional<z.ZodBoolean>;
+            divergenceDetails: z.ZodOptional<z.ZodObject<{
+                entropy: z.ZodNumber;
+                entropyThreshold: z.ZodNumber;
+                bins: z.ZodInt;
+                histogram: z.ZodArray<z.ZodInt>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        status: z.ZodEnum<{
+            warning: "warning";
+            critical: "critical";
+            healthy: "healthy";
+            no_data: "no_data";
+        }>;
+        period: z.ZodOptional<z.ZodObject<{
+            start: z.ZodISODateTime;
+            end: z.ZodISODateTime;
+        }, z.core.$strip>>;
+        worstExplanation: z.ZodOptional<z.ZodObject<{
+            score: z.ZodNumber;
+            explanation: z.ZodOptional<z.ZodString>;
+            traceId: z.ZodOptional<z.ZodString>;
+            timestamp: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        trend: z.ZodOptional<z.ZodObject<{
+            direction: z.ZodEnum<{
+                improving: "improving";
+                degrading: "degrading";
+                stable: "stable";
+            }>;
+            delta: z.ZodNumber;
+            percentChange: z.ZodNullable<z.ZodNumber>;
+            previousValue: z.ZodNumber;
+            currentValue: z.ZodNumber;
+            aggregation: z.ZodEnum<{
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count: "count";
+                p50: "p50";
+                p95: "p95";
+                p99: "p99";
+            }>;
+            lowSampleWarning: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        confidence: z.ZodOptional<z.ZodObject<{
+            level: z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+            }>;
+            sampleCount: z.ZodInt;
+            scoreStdDev: z.ZodNullable<z.ZodNumber>;
+            evaluatorCount: z.ZodInt;
+            evaluatorAgreement: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    alerts: z.ZodArray<z.ZodObject<{
+        severity: z.ZodEnum<{
+            info: "info";
+            warning: "warning";
+            critical: "critical";
+        }>;
+        message: z.ZodString;
+        aggregation: z.ZodEnum<{
+            avg: "avg";
+            min: "min";
+            max: "max";
+            count: "count";
+            p50: "p50";
+            p95: "p95";
+            p99: "p99";
+        }>;
+        threshold: z.ZodNumber;
+        actualValue: z.ZodNumber;
+        direction: z.ZodEnum<{
+            above: "above";
+            below: "below";
+        }>;
+        affectedCount: z.ZodOptional<z.ZodInt>;
+        remediationHints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        relatedMetrics: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        isCompound: z.ZodOptional<z.ZodBoolean>;
+        divergenceDetails: z.ZodOptional<z.ZodObject<{
+            entropy: z.ZodNumber;
+            entropyThreshold: z.ZodNumber;
+            bins: z.ZodInt;
+            histogram: z.ZodArray<z.ZodInt>;
+        }, z.core.$strip>>;
+        metricName: z.ZodString;
+    }, z.core.$strip>>;
+    slaCompliance: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        sla: z.ZodObject<{
+            metric: z.ZodString;
+            aggregation: z.ZodEnum<{
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count: "count";
+                p50: "p50";
+                p95: "p95";
+                p99: "p99";
+            }>;
+            target: z.ZodNumber;
+            direction: z.ZodEnum<{
+                above: "above";
+                below: "below";
+            }>;
+            window: z.ZodOptional<z.ZodEnum<{
+                "7d rolling": "7d rolling";
+                "14d rolling": "14d rolling";
+                "30d rolling": "30d rolling";
+                "60d rolling": "60d rolling";
+                "90d rolling": "90d rolling";
+                "calendar day": "calendar day";
+                "calendar week": "calendar week";
+                "calendar month": "calendar month";
+                "calendar quarter": "calendar quarter";
+                "calendar year": "calendar year";
+            }>>;
+        }, z.core.$strip>;
+        compliant: z.ZodBoolean;
+        status: z.ZodEnum<{
+            compliant: "compliant";
+            non_compliant: "non_compliant";
+            no_data: "no_data";
+            metric_not_found: "metric_not_found";
+        }>;
+        actualValue: z.ZodNullable<z.ZodNumber>;
+        gap: z.ZodNullable<z.ZodNumber>;
+        marginPercent: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    timestamp: z.ZodString;
+    totalEvaluationCount: z.ZodNumber;
+}, z.core.$strip>], "role">;
+export type RoleView = z.infer<typeof roleViewSchema>;
+/** Options for role-specific view computation */
+export declare const roleViewOptionsSchema: z.ZodObject<{
+    topIssuesLimit: z.ZodOptional<z.ZodNumber>;
+    minActionableSampleCount: z.ZodOptional<z.ZodNumber>;
+    cqiWeights: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        relevance: "relevance";
+        task_completion: "task_completion";
+        tool_correctness: "tool_correctness";
+        hallucination: "hallucination";
+        evaluation_latency: "evaluation_latency";
+        faithfulness: "faithfulness";
+        coherence: "coherence";
+        explanation_quality: "explanation_quality";
+        handoff_correctness: "handoff_correctness";
+    }> & z.core.$partial, z.ZodNumber>>;
+}, z.core.$strip>;
+export type RoleViewOptions = z.infer<typeof roleViewOptionsSchema>;
+/**
+ * Project dashboard summary data into a role-specific view.
+ *
+ * @param dashboard - Full dashboard summary
+ * @param role - Role type to project for
+ * @param options - Optional configuration for view limits and filtering
+ * @returns Role-specific view of the dashboard data
+ */
+export declare function computeRoleView(dashboard: QualityDashboardSummary, role: RoleType, options?: RoleViewOptions): RoleView;
+/** Single bucket in a score distribution histogram. */
+export declare const scoreDistributionEntrySchema: z.ZodObject<{
+    bucket: z.ZodString;
+    count: z.ZodNumber;
+}, z.core.$strip>;
+/** Snapshot of a single evaluation for worst/best lists. */
+export declare const evaluationSnapshotSchema: z.ZodObject<{
+    timestamp: z.ZodISODateTime;
+    evaluator: z.ZodOptional<z.ZodString>;
+    traceId: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    explanation: z.ZodOptional<z.ZodString>;
+    scoreValue: z.ZodNonOptional<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+/**
+ * Level 3 detail fields added on top of QualityMetricResult.
+ * Defined separately to avoid circular import with qualityMetricResultSchema
+ * (quality-metrics re-exports from this module).
+ */
+export declare const metricDetailFieldsSchema: z.ZodObject<{
+    scoreDistribution: z.ZodArray<z.ZodObject<{
+        bucket: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>;
+    worstEvaluations: z.ZodArray<z.ZodObject<{
+        timestamp: z.ZodISODateTime;
+        evaluator: z.ZodOptional<z.ZodString>;
+        traceId: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodString>;
+        explanation: z.ZodOptional<z.ZodString>;
+        scoreValue: z.ZodNonOptional<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>>;
+    bestEvaluations: z.ZodArray<z.ZodObject<{
+        timestamp: z.ZodISODateTime;
+        evaluator: z.ZodOptional<z.ZodString>;
+        traceId: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodString>;
+        explanation: z.ZodOptional<z.ZodString>;
+        scoreValue: z.ZodNonOptional<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Level 3: Detailed metric result with score distribution and evaluation breakdown.
+ * Runtime type is QualityMetricResult & MetricDetailFields.
+ */
+export interface MetricDetailResult extends z.infer<typeof qualityMetricResultSchema>, z.infer<typeof metricDetailFieldsSchema> {
+}
+/**
+ * Level 4: Individual evaluation detail with full provenance.
+ * Derived from evaluationResultSchema (backend-schemas) via pick + extend
+ * to stay aligned with the canonical EvaluationResult shape.
+ */
+export declare const evaluationDetailResultSchema: z.ZodObject<{
+    timestamp: z.ZodISODateTime;
+    evaluationName: z.ZodString;
+    scoreLabel: z.ZodOptional<z.ZodString>;
+    evaluator: z.ZodOptional<z.ZodString>;
+    traceId: z.ZodOptional<z.ZodString>;
+    spanId: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    explanation: z.ZodOptional<z.ZodString>;
+    scoreValue: z.ZodOptional<z.ZodNumber>;
+    evaluatorType: z.ZodOptional<z.ZodEnum<{
+        llm: "llm";
+        human: "human";
+        rule: "rule";
+        classifier: "classifier";
+        seed: "seed";
+        canary: "canary";
+    }>>;
+    inputHash: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type EvaluationDetailResult = z.infer<typeof evaluationDetailResultSchema>;
+/** Options for computeMetricDetail */
+export declare const metricDetailOptionsSchema: z.ZodObject<{
+    topN: z.ZodOptional<z.ZodNumber>;
+    period: z.ZodOptional<z.ZodObject<{
+        start: z.ZodISODateTime;
+        end: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    bucketCount: z.ZodOptional<z.ZodNumber>;
+    previousValues: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        avg: "avg";
+        min: "min";
+        max: "max";
+        count: "count";
+        p50: "p50";
+        p95: "p95";
+        p99: "p99";
+    }>, z.ZodNullable<z.ZodNumber>>>;
+}, z.core.$strip>;
+export type MetricDetailOptions = z.infer<typeof metricDetailOptionsSchema>;
+/**
+ * Compute Level 3 metric detail with distribution and worst/best evaluations.
+ *
+ * @param evaluations - All evaluations for this metric
+ * @param config - Metric configuration
+ * @param options - Optional configuration for detail computation
+ * @returns Metric detail with score distribution, worst/best evaluations
+ */
+export declare function computeMetricDetail(evaluations: EvaluationResult[], config: QualityMetricConfig, options?: MetricDetailOptions): MetricDetailResult;
+/**
+ * Convert an EvaluationResult to a Level 4 EvaluationDetailResult.
+ *
+ * @param eval_ - Source evaluation result
+ * @returns Flattened evaluation detail for individual display
+ */
+export declare function toEvaluationDetail(eval_: EvaluationResult): EvaluationDetailResult;
+//# sourceMappingURL=quality-views.d.ts.map