import pytest from pydantic import ValidationError from tht.evidence import ( CuratedEvidence, dump_curated_markdown, load_curated_tree, parse_curated_markdown, ) COMMON = { "schema_version": 1, "id": "evidence:fascia-pediatrica", "title": "Fascia pediatrica", "purposes": ["sql_generation"], "applies_to": { "concepts": ["fascia pediatrica"], "tables": ["clinical.patient"], "columns": ["clinical.patient.birth_date"], }, "language": "it", "provenance": { "source_file": "source/domain/patient.md", "source_sha256": "sha256:" + "a" * 64, "supporting_excerpts": ["I pazienti sotto i 18 anni sono pediatrici."], }, "review_items": [], } def test_formula_requires_its_typed_payload(): with pytest.raises(ValidationError): CuratedEvidence.model_validate({ **COMMON, "kind": "formula", "payload": {"concept": "fascia pediatrica"}, }) def test_reference_rejects_formula_payload(): with pytest.raises(ValidationError): CuratedEvidence.model_validate({ **COMMON, "kind": "reference", "payload": { "concept": "fascia pediatrica", "columns": ["clinical.patient.birth_date"], "sql": "CASE WHEN true THEN 1 END", }, }) @pytest.mark.parametrize(("kind", "payload"), [ ("glossary", { "definition": "Un paziente con età inferiore a 18 anni.", "synonyms": ["minore"], "variants": ["pediatrico"], }), ("domain", {"rule": "L'età è calcolata alla data di ricovero."}), ("enum", { "column": "clinical.episode.discharge_status", "values": {"D": "dimesso"}, }), ("example", { "question": "Come riconosco un paziente pediatrico?", "interpretation": "Applicare la formula della fascia pediatrica.", }), ("mapping", { "concept": "fascia pediatrica", "tables": ["clinical.patient"], "columns": ["clinical.patient.birth_date"], }), ("normalization", { "input": "PEDS", "output": "pediatrico", "rule": "Converte il codice abbreviato nella forma canonica.", }), ("formula", { "concept": "fascia pediatrica", "columns": ["clinical.patient.birth_date"], "sql": "CASE WHEN age < 18 THEN 'pediatrica' ELSE 'adulta' END", }), ("reference", { "url": "https://example.test/linea-guida", "label": "Linea guida", "description": "Criteri clinici di riferimento.", }), ]) def test_every_kind_requires_a_typed_payload(kind, payload): evidence = CuratedEvidence.model_validate({ **COMMON, "kind": kind, "payload": payload, }) assert evidence.kind == kind def test_canonical_evidence_rejects_unknown_envelope_and_payload_fields(): with pytest.raises(ValidationError): CuratedEvidence.model_validate({ **COMMON, "kind": "domain", "payload": {"rule": "Una regola", "unknown": "no"}, "unknown": "no", }) @pytest.mark.parametrize("purpose", ["disambiguation", "rewriting", "schema_linking", "sql_generation"]) def test_all_public_evidence_purposes_are_accepted(purpose): evidence = CuratedEvidence.model_validate({ **COMMON, "kind": "domain", "purposes": [purpose], "payload": {"rule": "Una regola di dominio."}, }) assert evidence.purposes == (purpose,) @pytest.mark.parametrize("field, value", [ ("id", "formula:fascia-pediatrica"), ("purposes", ["memory"]), ("provenance", { **COMMON["provenance"], "source_sha256": "sha256:not-a-digest", }), ("provenance", { **COMMON["provenance"], "supporting_excerpts": [], }), ("provenance", { **COMMON["provenance"], "supporting_excerpts": ["x" * 1001], }), ]) def test_common_evidence_constraints_reject_invalid_values(field, value): with pytest.raises(ValidationError): CuratedEvidence.model_validate({ **COMMON, field: value, "kind": "domain", "payload": {"rule": "Una regola di dominio."}, }) def test_provenance_is_immutable_after_validation(): evidence = CuratedEvidence.model_validate({ **COMMON, "kind": "domain", "payload": {"rule": "Una regola di dominio."}, }) with pytest.raises(ValidationError): evidence.provenance.source_file = "source/other.md" @pytest.mark.parametrize("sql", [ "SELECT clinical.patient.birth_date FROM clinical.patient", "WITH patients AS (SELECT 1) SELECT * FROM patients", "DELETE FROM clinical.patient", "CREATE TABLE scratch (id integer)", "TRUNCATE TABLE clinical.patient", "GRANT SELECT ON clinical.patient TO reader", "VALUES (1)", "TABLE clinical.patient", "SET search_path = clinical", "CASE WHEN age < 18 THEN 'pediatrica' ELSE 'adulta' END; SELECT 1", ]) def test_formula_rejects_complete_sql_statements(sql): with pytest.raises(ValidationError): CuratedEvidence.model_validate({ **COMMON, "kind": "formula", "payload": { "concept": "fascia pediatrica", "columns": ["clinical.patient.birth_date"], "sql": sql, }, }) def test_formula_accepts_one_composable_postgresql_expression(): evidence = CuratedEvidence.model_validate({ **COMMON, "kind": "formula", "payload": { "concept": "fascia pediatrica", "columns": ["clinical.patient.birth_date"], "sql": "CASE WHEN age < 18 THEN 'pediatrica' ELSE 'adulta' END", }, }) assert evidence.payload.sql.startswith("CASE WHEN") def _formula_evidence() -> CuratedEvidence: return CuratedEvidence.model_validate({ **COMMON, "kind": "formula", "payload": { "concept": "fascia pediatrica", "columns": ["clinical.patient.birth_date"], "sql": "CASE WHEN age < 18 THEN 'pediatrica' ELSE 'adulta' END", }, }) def _domain_evidence_v2() -> CuratedEvidence: return CuratedEvidence.model_validate({ **COMMON, "schema_version": 2, "title": "Dominio Ablazione", "kind": "domain", "payload": { "rule": ( "Il dominio Ablazione rappresenta la procedura transcatetere.\n\n" "La fact centrale è `clinical.fact_ablazione`." ), }, }) def _domain_evidence_v3() -> CuratedEvidence: return CuratedEvidence.model_validate({ **COMMON, "schema_version": 3, "title": "Dominio Ablazione", "kind": "domain", "purposes": ["disambiguation", "schema_linking", "rewriting"], "applies_to": { "concepts": ["ablazione", "studio elettrofisiologico", "SEE"], "tables": ["clinical.fact_ablazione"], "columns": ["clinical.fact_ablazione.patient_id"], }, "payload": { "rule": ( "Il dominio Ablazione rappresenta la procedura transcatetere.\n\n" "La fact centrale è `clinical.fact_ablazione`." ), }, }) def test_v3_curated_markdown_replaces_frontmatter_tables_with_readable_sections(tmp_path): evidence = _domain_evidence_v3() path = tmp_path / "curated" / "domain" / "dominio-ablazione.md" text = dump_curated_markdown(evidence) parsed = parse_curated_markdown(text, path=path) assert text.startswith("