truthound-dashboard 1.4.4__py3-none-any.whl → 1.5.0__py3-none-any.whl

truthound_dashboard/schemas/validators/registry.py

@@ -1,6 +1,11 @@
 """Validator registry.
 
 Central registry combining all validator categories with metadata and lookup functions.
+
+This module aggregates all 21 validator categories from truthound, providing:
+- Complete validator definitions with parameters
+- Category metadata for UI display
+- Search and filter utilities
 """
 
 from __future__ import annotations
@@ -10,23 +15,44 @@ from typing import Literal
 
 from .base import ValidatorCategory, ValidatorDefinition
 
-# Import all validator category modules
+# Import all validator category modules (21 categories)
+# Core validators
 from .schema_validators import SCHEMA_VALIDATORS
 from .completeness_validators import COMPLETENESS_VALIDATORS
 from .uniqueness_validators import UNIQUENESS_VALIDATORS
 from .distribution_validators import DISTRIBUTION_VALIDATORS
+
+# Format validators
 from .string_validators import STRING_VALIDATORS
 from .datetime_validators import DATETIME_VALIDATORS
+
+# Statistical validators
 from .aggregate_validators import AGGREGATE_VALIDATORS
+from .drift_validators import DRIFT_VALIDATORS
+from .anomaly_validators import ANOMALY_VALIDATORS
+
+# Relational validators
 from .cross_table_validators import CROSS_TABLE_VALIDATORS
 from .multi_column_validators import MULTI_COLUMN_VALIDATORS
 from .query_validators import QUERY_VALIDATORS
+
+# Domain validators
 from .table_validators import TABLE_VALIDATORS
 from .geospatial_validators import GEOSPATIAL_VALIDATORS
-from .drift_validators import DRIFT_VALIDATORS
-from .anomaly_validators import ANOMALY_VALIDATORS
 from .privacy_validators import PRIVACY_VALIDATORS
 
+# Business validators (new)
+from .business_rule_validators import BUSINESS_RULE_VALIDATORS
+from .profiling_validators import PROFILING_VALIDATORS
+from .localization_validators import LOCALIZATION_VALIDATORS
+
+# ML validators (new)
+from .ml_feature_validators import ML_FEATURE_VALIDATORS
+
+# Advanced validators (new)
+from .timeseries_validators import TIMESERIES_VALIDATORS
+from .referential_validators import REFERENTIAL_VALIDATORS
+
 
 @dataclass
 class CategoryInfo:
@@ -41,7 +67,7 @@ class CategoryInfo:
     validator_count: int = 0
 
 
-# Category metadata with UI information
+# Category metadata with UI information (21 categories)
 CATEGORY_INFO: list[CategoryInfo] = [
     # Core validators (no extra dependencies)
     CategoryInfo(
@@ -151,31 +177,90 @@ CATEGORY_INFO: list[CategoryInfo] = [
     CategoryInfo(
         value="privacy",
         label="Privacy",
-        description="PII detection and compliance (GDPR, CCPA)",
+        description="PII detection and compliance (GDPR, CCPA, LGPD)",
         icon="shield",
         color="#dc2626",  # red-600
     ),
+    # Business validators (new in truthound 2.x)
+    CategoryInfo(
+        value="business_rule",
+        label="Business Rule",
+        description="Domain-specific rules: checksums, IBAN, VAT, credit cards",
+        icon="briefcase",
+        color="#7c3aed",  # violet-600
+    ),
+    CategoryInfo(
+        value="profiling",
+        label="Profiling",
+        description="Cardinality, entropy, and value frequency analysis",
+        icon="activity",
+        color="#0891b2",  # cyan-600
+    ),
+    CategoryInfo(
+        value="localization",
+        label="Localization",
+        description="Regional identifier formats (Korean, Japanese, Chinese)",
+        icon="globe",
+        color="#059669",  # emerald-600
+    ),
+    # ML validators (new in truthound 2.x)
+    CategoryInfo(
+        value="ml_feature",
+        label="ML Feature",
+        description="Feature quality: null impact, scale, correlation, leakage",
+        icon="cpu",
+        color="#7c2d12",  # orange-900
+    ),
+    # Advanced validators (new in truthound 2.x)
+    CategoryInfo(
+        value="timeseries",
+        label="Time Series",
+        description="Gap detection, monotonicity, seasonality, trend analysis",
+        icon="clock",
+        color="#4338ca",  # indigo-700
+    ),
+    CategoryInfo(
+        value="referential",
+        label="Referential",
+        description="Foreign keys, orphan detection, hierarchy integrity",
+        icon="git-merge",
+        color="#be185d",  # pink-700
+    ),
 ]
 
 
 def _build_registry() -> list[ValidatorDefinition]:
-    """Build the complete validator registry from all categories."""
+    """Build the complete validator registry from all 21 categories."""
     return [
+        # Core validators
         *SCHEMA_VALIDATORS,
         *COMPLETENESS_VALIDATORS,
         *UNIQUENESS_VALIDATORS,
         *DISTRIBUTION_VALIDATORS,
+        # Format validators
         *STRING_VALIDATORS,
         *DATETIME_VALIDATORS,
+        # Statistical validators
         *AGGREGATE_VALIDATORS,
+        *DRIFT_VALIDATORS,
+        *ANOMALY_VALIDATORS,
+        # Relational validators
         *CROSS_TABLE_VALIDATORS,
         *MULTI_COLUMN_VALIDATORS,
         *QUERY_VALIDATORS,
+        # Domain validators
         *TABLE_VALIDATORS,
         *GEOSPATIAL_VALIDATORS,
-        *DRIFT_VALIDATORS,
-        *ANOMALY_VALIDATORS,
         *PRIVACY_VALIDATORS,
+        # Business validators (new)
+        *BUSINESS_RULE_VALIDATORS,
+        *PROFILING_VALIDATORS,
+        *LOCALIZATION_VALIDATORS,
+        # ML validators (new)
+        *ML_FEATURE_VALIDATORS,
+        # Advanced validators (new)
+        *TIMESERIES_VALIDATORS,
+        *REFERENTIAL_VALIDATORS,
     ]
 
 

truthound_dashboard/schemas/validators/timeseries_validators.py

@@ -0,0 +1,389 @@
+"""Time series validators.
+
+Validators for time series data properties including gaps, monotonicity,
+seasonality, and trend analysis.
+
+Import path in truthound: `from truthound.validators.timeseries import *`
+"""
+
+from .base import (
+    ParameterDefinition,
+    ParameterType,
+    ValidatorCategory,
+    ValidatorDefinition,
+)
+
+TIMESERIES_VALIDATORS: list[ValidatorDefinition] = [
+    ValidatorDefinition(
+        name="TimeSeriesGap",
+        display_name="Time Series Gap Detection",
+        category=ValidatorCategory.TIMESERIES,
+        description="Detects unexpected gaps in time series data.",
+        parameters=[
+            ParameterDefinition(
+                name="timestamp_column",
+                label="Timestamp Column",
+                type=ParameterType.COLUMN,
+                required=True,
+                description="Column containing timestamps",
+            ),
+            ParameterDefinition(
+                name="expected_interval",
+                label="Expected Interval",
+                type=ParameterType.STRING,
+                required=True,
+                description="Expected time interval (e.g., '1h', '1d', '5m')",
+                placeholder="1h",
+            ),
+            ParameterDefinition(
+                name="tolerance",
+                label="Tolerance",
+                type=ParameterType.FLOAT,
+                default=0.1,
+                min_value=0,
+                max_value=1,
+                description="Tolerance ratio for interval variation (0-1)",
+            ),
+        ],
+        tags=["timeseries", "gap", "missing", "interval"],
+        severity_default="high",
+    ),
+    ValidatorDefinition(
+        name="TimeSeriesInterval",
+        display_name="Time Series Interval Regularity",
+        category=ValidatorCategory.TIMESERIES,
+        description="Validates that time series has regular intervals.",
+        parameters=[
+            ParameterDefinition(
+                name="timestamp_column",
+                label="Timestamp Column",
+                type=ParameterType.COLUMN,
+                required=True,
+                description="Column containing timestamps",
+            ),
+            ParameterDefinition(
+                name="interval",
+                label="Expected Interval",
+                type=ParameterType.STRING,
+                required=True,
+                description="Expected time interval (e.g., '1h', '1d', '5m')",
+            ),
+            ParameterDefinition(
+                name="strict",
+                label="Strict Mode",
+                type=ParameterType.BOOLEAN,
+                default=False,
+                description="If true, all intervals must match exactly",
+            ),
+        ],
+        tags=["timeseries", "interval", "regularity", "frequency"],
+        severity_default="medium",
+    ),
+    ValidatorDefinition(
+        name="TimeSeriesDuplicate",
+        display_name="Time Series Duplicate Timestamp",
+        category=ValidatorCategory.TIMESERIES,
+        description="Detects duplicate timestamps in time series data.",
+        parameters=[
+            ParameterDefinition(
+                name="timestamp_column",
+                label="Timestamp Column",
+                type=ParameterType.COLUMN,
+                required=True,
+                description="Column containing timestamps",
+            ),
+            ParameterDefinition(
+                name="group_columns",
+                label="Group Columns",
+                type=ParameterType.COLUMN_LIST,
+                description="Additional columns to group by (for multi-series data)",
+            ),
+        ],
+        tags=["timeseries", "duplicate", "timestamp", "unique"],
+        severity_default="high",
+    ),
+    ValidatorDefinition(
+        name="TimeSeriesMonotonic",
+        display_name="Time Series Monotonicity",
+        category=ValidatorCategory.TIMESERIES,
+        description="Validates that timestamps are strictly monotonic (always increasing).",
+        parameters=[
+            ParameterDefinition(
+                name="timestamp_column",
+                label="Timestamp Column",
+                type=ParameterType.COLUMN,
+                required=True,
+                description="Column containing timestamps",
+            ),
+            ParameterDefinition(
+                name="direction",
+                label="Direction",
+                type=ParameterType.SELECT,
+                options=[
+                    {"value": "increasing", "label": "Increasing"},
+                    {"value": "decreasing", "label": "Decreasing"},
+                ],
+                default="increasing",
+                description="Expected monotonicity direction",
+            ),
+            ParameterDefinition(
+                name="strict",
+                label="Strictly Monotonic",
+                type=ParameterType.BOOLEAN,
+                default=True,
+                description="If true, no equal consecutive values allowed",
+            ),
+        ],
+        tags=["timeseries", "monotonic", "order", "sequence"],
+        severity_default="high",
+    ),
+    ValidatorDefinition(
+        name="TimeSeriesOrder",
+        display_name="Time Series Order",
+        category=ValidatorCategory.TIMESERIES,
+        description="Validates that timestamps are in chronological order.",
+        parameters=[
+            ParameterDefinition(
+                name="timestamp_column",
+                label="Timestamp Column",
+                type=ParameterType.COLUMN,
+                required=True,
+                description="Column containing timestamps",
+            ),
+            ParameterDefinition(
+                name="allow_equal",
+                label="Allow Equal Timestamps",
+                type=ParameterType.BOOLEAN,
+                default=False,
+                description="Whether equal consecutive timestamps are allowed",
+            ),
+        ],
+        tags=["timeseries", "order", "chronological", "sequence"],
+        severity_default="medium",
+    ),
+    ValidatorDefinition(
+        name="Seasonality",
+        display_name="Seasonality Validation",
+        category=ValidatorCategory.TIMESERIES,
+        description="Validates expected seasonal patterns in time series data.",
+        parameters=[
+            ParameterDefinition(
+                name="timestamp_column",
+                label="Timestamp Column",
+                type=ParameterType.COLUMN,
+                required=True,
+                description="Column containing timestamps",
+            ),
+            ParameterDefinition(
+                name="value_column",
+                label="Value Column",
+                type=ParameterType.COLUMN,
+                required=True,
+                description="Column containing the time series values",
+            ),
+            ParameterDefinition(
+                name="period",
+                label="Seasonal Period",
+                type=ParameterType.SELECT,
+                options=[
+                    {"value": "daily", "label": "Daily (24h)"},
+                    {"value": "weekly", "label": "Weekly (7d)"},
+                    {"value": "monthly", "label": "Monthly"},
+                    {"value": "quarterly", "label": "Quarterly"},
+                    {"value": "yearly", "label": "Yearly"},
+                ],
+                required=True,
+                description="Expected seasonal period",
+            ),
+            ParameterDefinition(
+                name="min_strength",
+                label="Minimum Seasonality Strength",
+                type=ParameterType.FLOAT,
+                default=0.3,
+                min_value=0,
+                max_value=1,
+                description="Minimum acceptable seasonality strength (0-1)",
+            ),
+        ],
+        tags=["timeseries", "seasonality", "pattern", "periodic"],
+        severity_default="medium",
+    ),
+    ValidatorDefinition(
+        name="Trend",
+        display_name="Trend Validation",
+        category=ValidatorCategory.TIMESERIES,
+        description="Validates expected trend direction in time series data.",
+        parameters=[
+            ParameterDefinition(
+                name="timestamp_column",
+                label="Timestamp Column",
+                type=ParameterType.COLUMN,
+                required=True,
+                description="Column containing timestamps",
+            ),
+            ParameterDefinition(
+                name="value_column",
+                label="Value Column",
+                type=ParameterType.COLUMN,
+                required=True,
+                description="Column containing the time series values",
+            ),
+            ParameterDefinition(
+                name="expected_trend",
+                label="Expected Trend",
+                type=ParameterType.SELECT,
+                options=[
+                    {"value": "increasing", "label": "Increasing"},
+                    {"value": "decreasing", "label": "Decreasing"},
+                    {"value": "stable", "label": "Stable"},
+                ],
+                required=True,
+                description="Expected trend direction",
+            ),
+            ParameterDefinition(
+                name="significance",
+                label="Significance Level",
+                type=ParameterType.FLOAT,
+                default=0.05,
+                min_value=0.001,
+                max_value=0.5,
+                description="Statistical significance level for trend detection",
+            ),
+        ],
+        tags=["timeseries", "trend", "direction", "growth"],
+        severity_default="medium",
+    ),
+    ValidatorDefinition(
+        name="TrendBreak",
+        display_name="Trend Break Detection",
+        category=ValidatorCategory.TIMESERIES,
+        description="Detects unexpected trend breaks or structural changes in time series.",
+        parameters=[
+            ParameterDefinition(
+                name="timestamp_column",
+                label="Timestamp Column",
+                type=ParameterType.COLUMN,
+                required=True,
+                description="Column containing timestamps",
+            ),
+            ParameterDefinition(
+                name="value_column",
+                label="Value Column",
+                type=ParameterType.COLUMN,
+                required=True,
+                description="Column containing the time series values",
+            ),
+            ParameterDefinition(
+                name="sensitivity",
+                label="Sensitivity",
+                type=ParameterType.FLOAT,
+                default=0.5,
+                min_value=0,
+                max_value=1,
+                description="Detection sensitivity (higher = more sensitive)",
+            ),
+        ],
+        tags=["timeseries", "trend", "break", "change_point"],
+        severity_default="medium",
+    ),
+    ValidatorDefinition(
+        name="TimeSeriesCompleteness",
+        display_name="Time Series Completeness",
+        category=ValidatorCategory.TIMESERIES,
+        description="Validates that time series covers the expected date range completely.",
+        parameters=[
+            ParameterDefinition(
+                name="timestamp_column",
+                label="Timestamp Column",
+                type=ParameterType.COLUMN,
+                required=True,
+                description="Column containing timestamps",
+            ),
+            ParameterDefinition(
+                name="start_date",
+                label="Expected Start Date",
+                type=ParameterType.DATE,
+                description="Expected start date of the series",
+            ),
+            ParameterDefinition(
+                name="end_date",
+                label="Expected End Date",
+                type=ParameterType.DATE,
+                description="Expected end date of the series",
+            ),
+            ParameterDefinition(
+                name="min_completeness",
+                label="Minimum Completeness",
+                type=ParameterType.FLOAT,
+                default=0.95,
+                min_value=0,
+                max_value=1,
+                description="Minimum required completeness ratio (0-1)",
+            ),
+        ],
+        tags=["timeseries", "completeness", "coverage", "range"],
+        severity_default="high",
+    ),
+    ValidatorDefinition(
+        name="TimeSeriesDateRange",
+        display_name="Time Series Date Range",
+        category=ValidatorCategory.TIMESERIES,
+        description="Validates that all timestamps fall within an expected date range.",
+        parameters=[
+            ParameterDefinition(
+                name="timestamp_column",
+                label="Timestamp Column",
+                type=ParameterType.COLUMN,
+                required=True,
+                description="Column containing timestamps",
+            ),
+            ParameterDefinition(
+                name="min_date",
+                label="Minimum Date",
+                type=ParameterType.DATE,
+                description="Earliest acceptable date",
+            ),
+            ParameterDefinition(
+                name="max_date",
+                label="Maximum Date",
+                type=ParameterType.DATE,
+                description="Latest acceptable date",
+            ),
+        ],
+        tags=["timeseries", "date_range", "bounds", "validation"],
+        severity_default="medium",
+    ),
+    ValidatorDefinition(
+        name="TimeSeriesValueCompleteness",
+        display_name="Time Series Value Completeness",
+        category=ValidatorCategory.TIMESERIES,
+        description="Validates that values are present for all expected time points.",
+        parameters=[
+            ParameterDefinition(
+                name="timestamp_column",
+                label="Timestamp Column",
+                type=ParameterType.COLUMN,
+                required=True,
+                description="Column containing timestamps",
+            ),
+            ParameterDefinition(
+                name="value_column",
+                label="Value Column",
+                type=ParameterType.COLUMN,
+                required=True,
+                description="Column containing the time series values",
+            ),
+            ParameterDefinition(
+                name="max_null_ratio",
+                label="Maximum Null Ratio",
+                type=ParameterType.FLOAT,
+                default=0.05,
+                min_value=0,
+                max_value=1,
+                description="Maximum acceptable ratio of null values",
+            ),
+        ],
+        tags=["timeseries", "completeness", "null", "missing"],
+        severity_default="medium",
+    ),
+]

truthound_dashboard/schemas/versioning.py

@@ -34,7 +34,6 @@ class VersionInfoResponse(BaseSchema):
 class VersionListResponse(BaseSchema):
     """Response for listing versions."""
 
-    success: bool = Field(default=True)
     data: list[VersionInfoResponse] = Field(..., description="List of versions")
     total: int = Field(..., description="Total number of versions")
     source_id: str = Field(..., description="Source ID for these versions")
@@ -81,7 +80,6 @@ class VersionCompareRequest(BaseSchema):
 class VersionHistoryResponse(BaseSchema):
     """Response for version history chain."""
 
-    success: bool = Field(default=True)
     data: list[VersionInfoResponse] = Field(..., description="Version history chain")
     depth: int = Field(..., description="Depth of history returned")
 
@@ -101,8 +99,7 @@ class CreateVersionRequest(BaseSchema):
 class CreateVersionResponse(BaseSchema):
     """Response after creating a version."""
 
-    success: bool = Field(default=True)
-    data: VersionInfoResponse = Field(..., description="Created version info")
+    version: VersionInfoResponse = Field(..., description="Created version info")
     message: str = Field(..., description="Success message")
 
 
@@ -120,7 +117,6 @@ class RollbackRequest(BaseSchema):
 class RollbackResponse(BaseSchema):
     """Response after a rollback operation."""
 
-    success: bool = Field(default=True)
     source_id: str = Field(..., description="Source ID that was rolled back")
     from_version: VersionInfoResponse | None = Field(
         None, description="Version rolled back from"
@@ -138,7 +134,6 @@ class RollbackResponse(BaseSchema):
 class RollbackAvailabilityResponse(BaseSchema):
     """Response for checking rollback availability."""
 
-    success: bool = Field(default=True)
     can_rollback: bool = Field(..., description="Whether rollback is available")
     current_version_id: str | None = Field(
         None, description="Current active version ID"

truthound_dashboard/static/index.html

@@ -6,8 +6,8 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="description" content="Truthound Dashboard - Open-source data quality monitoring" />
     <title>Truthound Dashboard</title>
-    <script type="module" crossorigin src="/assets/index-DkU82VsU.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-C6JSrkHo.css">
+    <script type="module" crossorigin src="/assets/index-BnWMZ9K7.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DDRuhd95.css">
   </head>
   <body>
     <div id="root"></div>