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

truthound_dashboard/api/reports.py

@@ -206,8 +206,6 @@ async def generate_validation_report(
                 "text/html": {},
                 "text/csv": {},
                 "application/json": {},
-                "text/markdown": {},
-                "application/pdf": {},
             },
         },
         404: {"description": "Validation not found"},
@@ -237,7 +235,7 @@ async def download_validation_report(
     Args:
         service: Injected validation service.
         validation_id: Validation to generate report for.
-        format: Report format (html, csv, json, markdown).
+        format: Report format (html, csv, json).
         theme: Visual theme for the report.
         locale: Report language code.
         include_samples: Include sample problematic values.
@@ -250,8 +248,8 @@ async def download_validation_report(
         HTTPException: 404 if validation not found.
         HTTPException: 400 if format or locale is not supported.
     """
-    # Get validation
-    validation = await service.get_validation(validation_id)
+    # Get validation with source eagerly loaded (required for report generation)
+    validation = await service.get_validation(validation_id, with_source=True)
     if validation is None:
         raise HTTPException(status_code=404, detail="Validation not found")
 
@@ -295,7 +293,6 @@ async def download_validation_report(
                 "text/html": {},
                 "text/csv": {},
                 "application/json": {},
-                "text/markdown": {},
             },
         },
         404: {"description": "Validation not found"},
@@ -320,7 +317,7 @@ async def preview_validation_report(
     Args:
         service: Injected validation service.
         validation_id: Validation to generate report for.
-        format: Report format (html, csv, json, markdown).
+        format: Report format (html, csv, json).
         theme: Visual theme for the report.
         locale: Report language code.
 
@@ -331,8 +328,8 @@ async def preview_validation_report(
         HTTPException: 404 if validation not found.
         HTTPException: 400 if format or locale is not supported.
     """
-    # Get validation
-    validation = await service.get_validation(validation_id)
+    # Get validation with source eagerly loaded (required for report generation)
+    validation = await service.get_validation(validation_id, with_source=True)
     if validation is None:
         raise HTTPException(status_code=404, detail="Validation not found")
 
@@ -393,7 +390,7 @@ async def list_report_history(
         source_id: Filter by source ID.
         validation_id: Filter by validation ID.
         reporter_id: Filter by reporter ID.
-        format: Filter by format (html, pdf, csv, json, markdown, junit, excel).
+        format: Filter by format (html, csv, json).
         status: Filter by status (pending, generating, completed, failed, expired).
         include_expired: Include expired reports (default: false).
         search: Search by report name.
@@ -602,8 +599,6 @@ async def delete_report_record(
                 "text/html": {},
                 "text/csv": {},
                 "application/json": {},
-                "text/markdown": {},
-                "application/pdf": {},
             },
         },
         404: {"description": "Report not found or file missing"},
@@ -645,12 +640,8 @@ async def download_saved_report(
     # Build filename
     ext_map = {
         "html": ".html",
-        "pdf": ".pdf",
         "csv": ".csv",
         "json": ".json",
-        "markdown": ".md",
-        "junit": ".xml",
-        "excel": ".xlsx",
     }
     fmt = report.format.value if hasattr(report.format, "value") else report.format
     ext = ext_map.get(fmt, ".html")

truthound_dashboard/api/router.py

@@ -9,6 +9,7 @@ from . import (
     # Phase 1-4
     alerts,
     drift,
+    drift_monitor,
     health,
     history,
     maintenance,
@@ -16,6 +17,7 @@ from . import (
     notifications,
     notifications_advanced,
     profile,
+    quality_reporter,
     reports,
     rules,
     scan,
@@ -34,6 +36,7 @@ from . import (
     # Schema Evolution & Rule Suggestions
     rule_suggestions,
     schema_evolution,
+    schema_watcher,
     # Phase 9: Plugin System
     plugins,
     # Phase 10: ML & Lineage
@@ -42,6 +45,12 @@ from . import (
     model_monitoring,
     # Cross-Feature Integration
     cross_alerts,
+    # Storage Tiering (truthound 1.2.10+)
+    tiering,
+    # Enterprise Sampling (truthound 1.2.10+)
+    enterprise_sampling,
+    # Observability (truthound store observability)
+    observability,
 )
 
 api_router = APIRouter()
@@ -102,6 +111,12 @@ api_router.include_router(
     tags=["drift"],
 )
 
+# Drift monitoring endpoints
+api_router.include_router(
+    drift_monitor.router,
+    tags=["drift-monitor"],
+)
+
 # PII scan endpoints
 api_router.include_router(
     scan.router,
@@ -279,3 +294,54 @@ api_router.include_router(
     plugins.router,
     tags=["plugins"],
 )
+
+# =============================================================================
+# Storage Tiering (truthound 1.2.10+)
+# =============================================================================
+
+# Storage tiering endpoints (tiers, policies, configs, migrations)
+api_router.include_router(
+    tiering.router,
+    tags=["tiering"],
+)
+
+# =============================================================================
+# Quality Reporter (truthound 1.2.10+)
+# =============================================================================
+
+# Quality scoring and reporting endpoints
+api_router.include_router(
+    quality_reporter.router,
+    tags=["quality-reporter"],
+)
+
+# =============================================================================
+# Schema Watcher (truthound 1.2.10+)
+# =============================================================================
+
+# Schema watcher endpoints for continuous schema monitoring
+api_router.include_router(
+    schema_watcher.router,
+    tags=["schema-watcher"],
+)
+
+# =============================================================================
+# Enterprise Sampling (truthound 1.2.10+)
+# =============================================================================
+
+# Enterprise sampling endpoints (block, multi-stage, column-aware, progressive)
+api_router.include_router(
+    enterprise_sampling.router,
+    tags=["enterprise-sampling"],
+)
+
+# =============================================================================
+# Observability (truthound store observability)
+# =============================================================================
+
+# Observability endpoints (audit, metrics, tracing)
+api_router.include_router(
+    observability.router,
+    prefix="/observability",
+    tags=["observability"],
+)

truthound_dashboard/api/rule_suggestions.py

@@ -72,7 +72,7 @@ async def suggest_rules(
         Rule suggestion response with single-column and cross-column suggestions.
     """
     # Verify source exists
-    source = await source_service.get(source_id)
+    source = await source_service.get_by_id(source_id)
     if not source:
         raise HTTPException(
             status_code=status.HTTP_404_NOT_FOUND,
@@ -100,7 +100,7 @@ async def suggest_rules(
             )
 
     # Get schema (optional)
-    schema = await schema_service.get_active(source_id)
+    schema = await schema_service.get_schema(source_id)
 
     # Generate suggestions with advanced options including cross-column
     result = await generator_service.generate_suggestions(
@@ -144,7 +144,7 @@ async def apply_rule_suggestions(
         Apply rules response.
     """
     # Verify source exists
-    source = await source_service.get(source_id)
+    source = await source_service.get_by_id(source_id)
     if not source:
         raise HTTPException(
             status_code=status.HTTP_404_NOT_FOUND,
@@ -200,7 +200,7 @@ async def export_rules(
         Export response with content.
     """
     # Verify source exists
-    source = await source_service.get(source_id)
+    source = await source_service.get_by_id(source_id)
     if not source:
         raise HTTPException(
             status_code=status.HTTP_404_NOT_FOUND,
@@ -250,7 +250,7 @@ async def download_exported_rules(
         Plain text response with file content.
     """
     # Verify source exists
-    source = await source_service.get(source_id)
+    source = await source_service.get_by_id(source_id)
     if not source:
         raise HTTPException(
             status_code=status.HTTP_404_NOT_FOUND,

truthound_dashboard/api/scan.py

@@ -27,24 +27,27 @@ router = APIRouter()
     "/sources/{source_id}/scan",
     response_model=PIIScanResponse,
     summary="Run PII scan",
-    description="Scan data source for personally identifiable information (PII)",
+    description="""
+Scan data source for personally identifiable information (PII).
+
+Note: truthound's th.scan() does not support configuration parameters.
+The scan runs on all columns with default settings.
+""",
 )
 async def run_pii_scan(
     service: PIIScanServiceDep,
     source_id: Annotated[str, Path(description="Source ID to scan")],
-    request: PIIScanRequest,
+    request: PIIScanRequest | None = None,
 ) -> PIIScanResponse:
     """Run PII scan on a data source.
 
-    Supports all th.scan() parameters for maximum flexibility:
-    - columns: Specific columns to scan
-    - regulations: Privacy regulations to check (gdpr, ccpa, lgpd)
-    - min_confidence: Confidence threshold for PII detection
+    Note: truthound's th.scan() does not support configuration parameters.
+    The scan runs on all columns with default settings.
 
     Args:
         service: Injected PII scan service.
         source_id: Source to scan.
-        request: Scan options.
+        request: Optional request body (not used, kept for API compatibility).
 
     Returns:
         PII scan result with findings and violations.
@@ -53,12 +56,7 @@ async def run_pii_scan(
         HTTPException: 404 if source not found.
     """
     try:
-        scan = await service.run_scan(
-            source_id,
-            columns=request.columns,
-            regulations=request.regulations,
-            min_confidence=request.min_confidence,
-        )
+        scan = await service.run_scan(source_id)
         return PIIScanResponse.from_model(scan)
     except ValueError as e:
         raise HTTPException(status_code=404, detail=str(e))
@@ -134,15 +132,15 @@ async def list_source_pii_scans(
 
 @router.get(
     "/sources/{source_id}/scans/latest",
-    response_model=PIIScanResponse,
+    response_model=PIIScanResponse | None,
     summary="Get latest PII scan",
-    description="Get the most recent PII scan for a source",
+    description="Get the most recent PII scan for a source, or null if no scans exist",
 )
 async def get_latest_pii_scan(
     service: PIIScanServiceDep,
     source_service: SourceServiceDep,
     source_id: Annotated[str, Path(description="Source ID")],
-) -> PIIScanResponse:
+) -> PIIScanResponse | None:
     """Get the most recent PII scan for a source.
 
     Args:
@@ -151,10 +149,10 @@ async def get_latest_pii_scan(
         source_id: Source to get latest scan for.
 
     Returns:
-        Latest PII scan result.
+        Latest PII scan result, or null if no scans exist.
 
     Raises:
-        HTTPException: 404 if source or scan not found.
+        HTTPException: 404 if source not found.
     """
     # Verify source exists
     source = await source_service.get_by_id(source_id)
@@ -163,6 +161,6 @@ async def get_latest_pii_scan(
 
     scan = await service.get_latest_for_source(source_id)
     if scan is None:
-        raise HTTPException(status_code=404, detail="No PII scans found for source")
+        return None
 
     return PIIScanResponse.from_model(scan)

truthound_dashboard/api/schedules.py

@@ -1,6 +1,11 @@
 """Schedule management API endpoints.
 
 Provides CRUD endpoints for validation schedules.
+
+API Design: Direct Response Style
+- Single resources return the resource directly
+- List endpoints return PaginatedResponse with data, total, offset, limit
+- Errors are handled via HTTPException
 """
 
 from __future__ import annotations
@@ -11,11 +16,14 @@ from fastapi import APIRouter, Depends, HTTPException, Query
 
 from truthound_dashboard.core import ScheduleService, ValidationService
 from truthound_dashboard.schemas import (
+    MessageResponse,
     ScheduleActionResponse,
     ScheduleCreate,
     ScheduleListResponse,
+    ScheduleResponse,
     ScheduleUpdate,
 )
+from truthound_dashboard.schemas.schedule import ScheduleListItem
 
 from .deps import SessionDep
 
@@ -30,25 +38,49 @@ async def get_schedule_service(session: SessionDep) -> ScheduleService:
 ScheduleServiceDep = Annotated[ScheduleService, Depends(get_schedule_service)]
 
 
-def _schedule_to_response(schedule) -> dict:
-    """Convert schedule model to response dict."""
-    return {
-        "id": schedule.id,
-        "name": schedule.name,
-        "source_id": schedule.source_id,
-        "cron_expression": schedule.cron_expression,
-        "is_active": schedule.is_active,
-        "notify_on_failure": schedule.notify_on_failure,
-        "last_run_at": (
+def _schedule_to_response(schedule) -> ScheduleResponse:
+    """Convert schedule model to response schema."""
+    return ScheduleResponse(
+        id=schedule.id,
+        name=schedule.name,
+        source_id=schedule.source_id,
+        cron_expression=schedule.cron_expression,
+        trigger_type=getattr(schedule, "trigger_type", None) or "cron",
+        trigger_config=getattr(schedule, "trigger_config", None),
+        is_active=schedule.is_active,
+        notify_on_failure=schedule.notify_on_failure,
+        last_run_at=(
             schedule.last_run_at.isoformat() if schedule.last_run_at else None
         ),
-        "next_run_at": (
+        next_run_at=(
             schedule.next_run_at.isoformat() if schedule.next_run_at else None
         ),
-        "config": schedule.config,
-        "created_at": schedule.created_at.isoformat() if schedule.created_at else None,
-        "updated_at": schedule.updated_at.isoformat() if schedule.updated_at else None,
-    }
+        config=schedule.config,
+        created_at=schedule.created_at,
+        updated_at=schedule.updated_at,
+    )
+
+
+def _schedule_to_list_item(schedule) -> ScheduleListItem:
+    """Convert schedule model to list item schema."""
+    return ScheduleListItem(
+        id=schedule.id,
+        name=schedule.name,
+        source_id=schedule.source_id,
+        cron_expression=schedule.cron_expression,
+        trigger_type=getattr(schedule, "trigger_type", None) or "cron",
+        trigger_config=getattr(schedule, "trigger_config", None),
+        is_active=schedule.is_active,
+        notify_on_failure=schedule.notify_on_failure,
+        last_run_at=(
+            schedule.last_run_at.isoformat() if schedule.last_run_at else None
+        ),
+        next_run_at=(
+            schedule.next_run_at.isoformat() if schedule.next_run_at else None
+        ),
+        created_at=schedule.created_at,
+        updated_at=schedule.updated_at,
+    )
 
 
 @router.get(
@@ -61,6 +93,7 @@ async def list_schedules(
     service: ScheduleServiceDep,
     source_id: str | None = Query(None, description="Filter by source ID"),
     active_only: bool = Query(False, description="Only return active schedules"),
+    offset: int = Query(0, ge=0, description="Offset for pagination"),
     limit: int = Query(100, ge=1, le=500, description="Maximum results"),
 ) -> ScheduleListResponse:
     """List validation schedules.
@@ -69,10 +102,11 @@ async def list_schedules(
         service: Schedule service.
         source_id: Optional source ID filter.
         active_only: Only return active schedules.
+        offset: Offset for pagination.
         limit: Maximum results.
 
     Returns:
-        List of schedules.
+        Paginated list of schedules.
     """
     schedules = await service.list_schedules(
         source_id=source_id,
@@ -81,15 +115,16 @@ async def list_schedules(
     )
 
     return ScheduleListResponse(
-        success=True,
-        data=[_schedule_to_response(s) for s in schedules],
+        data=[_schedule_to_list_item(s) for s in schedules],
         total=len(schedules),
+        offset=offset,
+        limit=limit,
     )
 
 
 @router.post(
     "/schedules",
-    response_model=dict,
+    response_model=ScheduleResponse,
     status_code=201,
     summary="Create schedule",
     description="Create a new validation schedule.",
@@ -97,7 +132,7 @@ async def list_schedules(
 async def create_schedule(
     request: ScheduleCreate,
     service: ScheduleServiceDep,
-) -> dict:
+) -> ScheduleResponse:
     """Create a new schedule.
 
     Args:
@@ -112,14 +147,12 @@ async def create_schedule(
             source_id=request.source_id,
             name=request.name,
             cron_expression=request.cron_expression,
+            trigger_type=request.trigger_type,
+            trigger_config=request.trigger_config,
             notify_on_failure=request.notify_on_failure,
             config=request.config,
         )
-
-        return {
-            "success": True,
-            "data": _schedule_to_response(schedule),
-        }
+        return _schedule_to_response(schedule)
     except ValueError as e:
         raise HTTPException(status_code=400, detail=str(e))
     except Exception as e:
@@ -128,14 +161,14 @@ async def create_schedule(
 
 @router.get(
     "/schedules/{schedule_id}",
-    response_model=dict,
+    response_model=ScheduleResponse,
     summary="Get schedule",
     description="Get a specific schedule by ID.",
 )
 async def get_schedule(
     schedule_id: str,
     service: ScheduleServiceDep,
-) -> dict:
+) -> ScheduleResponse:
     """Get a schedule by ID.
 
     Args:
@@ -149,15 +182,12 @@ async def get_schedule(
     if schedule is None:
         raise HTTPException(status_code=404, detail="Schedule not found")
 
-    return {
-        "success": True,
-        "data": _schedule_to_response(schedule),
-    }
+    return _schedule_to_response(schedule)
 
 
 @router.put(
     "/schedules/{schedule_id}",
-    response_model=dict,
+    response_model=ScheduleResponse,
     summary="Update schedule",
     description="Update an existing schedule.",
 )
@@ -165,7 +195,7 @@ async def update_schedule(
     schedule_id: str,
     request: ScheduleUpdate,
     service: ScheduleServiceDep,
-) -> dict:
+) -> ScheduleResponse:
     """Update a schedule.
 
     Args:
@@ -188,24 +218,21 @@ async def update_schedule(
         if schedule is None:
             raise HTTPException(status_code=404, detail="Schedule not found")
 
-        return {
-            "success": True,
-            "data": _schedule_to_response(schedule),
-        }
+        return _schedule_to_response(schedule)
     except ValueError as e:
         raise HTTPException(status_code=400, detail=str(e))
 
 
 @router.delete(
     "/schedules/{schedule_id}",
-    response_model=dict,
+    response_model=MessageResponse,
     summary="Delete schedule",
     description="Delete a schedule.",
 )
 async def delete_schedule(
     schedule_id: str,
     service: ScheduleServiceDep,
-) -> dict:
+) -> MessageResponse:
     """Delete a schedule.
 
     Args:
@@ -219,7 +246,7 @@ async def delete_schedule(
     if not deleted:
         raise HTTPException(status_code=404, detail="Schedule not found")
 
-    return {"success": True, "message": "Schedule deleted"}
+    return MessageResponse(message="Schedule deleted")
 
 
 @router.post(
@@ -246,7 +273,6 @@ async def pause_schedule(
         raise HTTPException(status_code=404, detail="Schedule not found")
 
     return ScheduleActionResponse(
-        success=True,
         message="Schedule paused",
         schedule=_schedule_to_response(schedule),
     )
@@ -276,15 +302,25 @@ async def resume_schedule(
         raise HTTPException(status_code=404, detail="Schedule not found")
 
     return ScheduleActionResponse(
-        success=True,
         message="Schedule resumed",
         schedule=_schedule_to_response(schedule),
     )
 
 
+from pydantic import BaseModel
+
+
+class ScheduleRunResponse(BaseModel):
+    """Response for schedule run action."""
+
+    message: str
+    validation_id: str
+    passed: bool | None = None
+
+
 @router.post(
     "/schedules/{schedule_id}/run",
-    response_model=dict,
+    response_model=ScheduleRunResponse,
     summary="Run schedule now",
     description="Trigger immediate execution of a scheduled validation.",
 )
@@ -292,7 +328,7 @@ async def run_schedule_now(
     schedule_id: str,
     service: ScheduleServiceDep,
     session: SessionDep,
-) -> dict:
+) -> ScheduleRunResponse:
     """Run a scheduled validation immediately.
 
     Args:
@@ -319,11 +355,10 @@ async def run_schedule_now(
             auto_schema=config.get("auto_schema", False),
         )
 
-        return {
-            "success": True,
-            "message": "Validation triggered",
-            "validation_id": validation.id,
-            "passed": validation.passed,
-        }
+        return ScheduleRunResponse(
+            message="Validation triggered",
+            validation_id=validation.id,
+            passed=validation.passed,
+        )
     except Exception as e:
         raise HTTPException(status_code=500, detail=str(e))

truthound_dashboard/api/schema_evolution.py

@@ -51,7 +51,7 @@ async def list_schema_versions(
         List of schema versions.
     """
     # Verify source exists
-    source = await source_service.get(source_id)
+    source = await source_service.get_by_id(source_id)
     if not source:
         raise HTTPException(
             status_code=status.HTTP_404_NOT_FOUND,
@@ -93,7 +93,7 @@ async def get_schema_version(
         Schema version details.
     """
     # Verify source exists
-    source = await source_service.get(source_id)
+    source = await source_service.get_by_id(source_id)
     if not source:
         raise HTTPException(
             status_code=status.HTTP_404_NOT_FOUND,
@@ -136,7 +136,7 @@ async def list_schema_changes(
         List of schema changes.
     """
     # Verify source exists
-    source = await source_service.get(source_id)
+    source = await source_service.get_by_id(source_id)
     if not source:
         raise HTTPException(
             status_code=status.HTTP_404_NOT_FOUND,
@@ -178,7 +178,7 @@ async def detect_schema_changes(
         Schema evolution detection result.
     """
     # Verify source exists
-    source = await source_service.get(source_id)
+    source = await source_service.get_by_id(source_id)
     if not source:
         raise HTTPException(
             status_code=status.HTTP_404_NOT_FOUND,
@@ -186,7 +186,7 @@ async def detect_schema_changes(
         )
 
     # Get current schema
-    schema = await schema_service.get_active(source_id)
+    schema = await schema_service.get_schema(source_id)
     if not schema:
         raise HTTPException(
             status_code=status.HTTP_404_NOT_FOUND,
@@ -221,7 +221,7 @@ async def get_evolution_summary(
         Evolution summary.
     """
     # Verify source exists
-    source = await source_service.get(source_id)
+    source = await source_service.get_by_id(source_id)
     if not source:
         raise HTTPException(
             status_code=status.HTTP_404_NOT_FOUND,