[Senate] Schema validation engine — validate artifact metadata against schemas

Goal

Build a validation engine that checks artifact metadata against registered schemas at
registration time. Invalid metadata is rejected (for required fields) or warned (for
optional fields). This prevents schema drift and ensures data integrity.

Acceptance Criteria

☐ validate_artifact_metadata(artifact_type, metadata) function

☐ Uses JSON Schema validation (jsonschema library)

☐ Integrated into register_artifact() — validates before insert

☐ Validation modes: strict (reject invalid), warn (log but allow), skip (no validation)

☐ Default mode: warn during rollout, switch to strict once schemas stabilize

☐ Validation errors logged with details (which fields failed, why)

☐ Batch validation: validate_all_artifacts(artifact_type) — audit existing data

☐ API: GET /api/schemas/{type}/validate — validate a payload without inserting

☐ Dashboard: schema compliance percentage per artifact type

Dependencies

sen-sg-01-SREG — Schemas must be registered for validation

Dependents

sen-sg-04-MIGR — Migrations must produce schema-valid output

Work Log

Tasks using this spec (1)

[Senate] Schema validation engine — validate artifact metada

Schema Governance done P85

File: sen-sg-03-VALD_schema_validation_engine_spec.md

Modified: 2026-04-28 21:29

Size: 1.3 KB