@the-cascade-protocol/cli 0.2.0

package/src/shapes/core.ttl

@@ -0,0 +1,603 @@
+@prefix cascade: <https://ns.cascadeprotocol.org/core/v1#> .
+@prefix owl: <http://www.w3.org/2002/07/owl#> .
+@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
+@prefix dct: <http://purl.org/dc/terms/> .
+@prefix prov: <http://www.w3.org/ns/prov#> .
+@prefix foaf: <http://xmlns.com/foaf/0.1/> .
+@prefix vcard: <http://www.w3.org/2006/vcard/ns#> .
+
+# ============================================================================
+# Ontology Metadata
+# ============================================================================
+
+<https://ns.cascadeprotocol.org/core/v1#> a owl:Ontology ;
+    dct:title "Cascade Protocol Core Vocabulary"@en ;
+    dct:description "Core vocabulary for schema versioning, data provenance, identity management, and patient demographics across all Cascade Protocol applications"@en ;
+    dct:creator "Cascade Agentic Labs" ;
+    dct:created "2025-10-31"^^xsd:date ;
+    dct:modified "2026-02-22"^^xsd:date ;
+    owl:versionInfo "2.3" ;
+    rdfs:comment "This vocabulary defines cross-cutting concepts used by all Cascade Protocol health data applications: schema versioning, data provenance, patient demographics (PatientProfile), and supporting identity classes (Address, PharmacyInfo, AdvanceDirectives). Domain-specific vocabularies (e.g., pots:, ecg:, glucose:) import this core vocabulary."@en ;
+    rdfs:seeAlso <https://cascadeprotocol.org/docs/core/v1.0/> .
+
+# ============================================================================
+# Data Provenance Classes
+# ============================================================================
+
+cascade:DataProvenance a owl:Class ;
+    rdfs:label "Data Provenance"@en ;
+    rdfs:comment "Classification of how health data was generated or collected"@en ;
+    rdfs:subClassOf prov:Entity .
+
+# --- Broad DataProvenance Categories (promoted from individuals to classes) ---
+
+cascade:ConsumerGenerated a owl:Class ;
+    rdfs:subClassOf cascade:DataProvenance ;
+    rdfs:label "Consumer-Generated"@en ;
+    rdfs:comment "Data generated directly by the user through personal devices (non-clinical setting)."@en ;
+    owl:disjointWith cascade:ClinicalGenerated .
+
+cascade:ClinicalGenerated a owl:Class ;
+    rdfs:subClassOf cascade:DataProvenance ;
+    rdfs:label "Clinical-Generated"@en ;
+    rdfs:comment "Data generated in a clinical setting under healthcare provider supervision."@en ;
+    owl:disjointWith cascade:ConsumerGenerated .
+
+# --- ConsumerGenerated Subclasses ---
+
+cascade:DeviceGenerated a owl:Class ;
+    rdfs:subClassOf cascade:ConsumerGenerated ;
+    rdfs:label "Device-Generated"@en ;
+    rdfs:comment "Data generated by a consumer health device (Apple Watch, blood pressure cuff, etc.) without clinical supervision."@en .
+
+cascade:SelfReported a owl:Class ;
+    rdfs:subClassOf cascade:ConsumerGenerated ;
+    rdfs:label "Self-Reported"@en ;
+    rdfs:comment "Data manually entered by the patient (symptom logs, medication adherence, intake form fields)."@en .
+
+cascade:ConsumerWellness a owl:Class ;
+    rdfs:subClassOf cascade:ConsumerGenerated ;
+    rdfs:label "Consumer Wellness"@en ;
+    rdfs:comment "Aggregated wellness data from consumer platforms (Apple Health, Google Fit)."@en .
+
+# --- ClinicalGenerated Subclasses ---
+
+cascade:EHRVerified a owl:Class ;
+    rdfs:subClassOf cascade:ClinicalGenerated ;
+    rdfs:label "EHR-Verified"@en ;
+    rdfs:comment "Data imported from a verified Electronic Health Record system (Epic MyChart, Cerner, etc.)."@en .
+
+cascade:ScannedDocument a owl:Class ;
+    rdfs:subClassOf cascade:ClinicalGenerated ;
+    rdfs:label "Scanned Document"@en ;
+    rdfs:comment "Data extracted from a scanned or photographed clinical document."@en .
+
+cascade:AIExtracted a owl:Class ;
+    rdfs:subClassOf cascade:ClinicalGenerated ;
+    rdfs:label "AI-Extracted"@en ;
+    rdfs:comment "Data extracted from clinical documents using AI/NLP processing."@en .
+
+# ============================================================================
+# Data Properties
+# ============================================================================
+
+# Schema Versioning
+cascade:schemaVersion a owl:DatatypeProperty ;
+    rdfs:label "Schema Version"@en ;
+    rdfs:comment "Semantic version of the ontology schema used to serialize this data (format: major.minor.patch)"@en ;
+    rdfs:range xsd:string ;
+    rdfs:seeAlso <https://semver.org/> .
+
+# Data Provenance
+cascade:dataProvenance a owl:ObjectProperty ;
+    rdfs:label "Data Provenance"@en ;
+    rdfs:comment "Classification of how this data was generated (consumer vs clinical)"@en ;
+    rdfs:range cascade:DataProvenance .
+
+# Identity
+cascade:creatorWebID a owl:ObjectProperty ;
+    rdfs:label "Creator WebID"@en ;
+    rdfs:comment "Solid WebID URI of the user who created this data"@en ;
+    rdfs:subPropertyOf prov:wasAttributedTo ;
+    rdfs:range rdfs:Resource ;
+    rdfs:seeAlso <https://www.w3.org/TR/webid/> .
+
+# ============================================================================
+# Data Source Identity (v1.1)
+# ============================================================================
+
+# Design rationale: DataSource is placed in core: (not health:) because source
+# identity is cross-cutting infrastructure — it applies equally to clinical data
+# (which EHR system, which lab) and consumer wellness data (which device, which app).
+# Subclasses prov:Agent per W3C PROV-O: sources are agents that produce entities.
+#
+# Relationship to FHIR Device: FHIR Device is for clinical device registries with
+# regulatory identifiers. cascade:DataSource is broader — it covers apps, manual entry,
+# EHR systems, and consumer devices. When FHIR interop is needed, a DataSource can
+# reference a FHIR Device via rdfs:seeAlso.
+#
+# Reconciliation strategy (what happens when two sources disagree on the same metric)
+# is deferred to post-MVP. For now, source attribution is displayed per-metric and
+# users can view which source produced each reading.
+#
+# Future extension point: cascade:sourceTransitionEvent for tracking device migrations
+# (e.g., Fitbit → Apple Watch) including date ranges and data continuity notes.
+
+cascade:DataSource a owl:Class ;
+    rdfs:label "Data Source"@en ;
+    rdfs:comment "Identity and reliability metadata for a data-producing device, app, or system. Examples: Apple Watch, MyChart EHR, manual user entry."@en ;
+    rdfs:subClassOf prov:Agent .
+
+cascade:sourceName a owl:DatatypeProperty ;
+    rdfs:label "Source Name"@en ;
+    rdfs:comment "Human-readable name: 'Apple Watch Series 10', 'MyChart', 'Manual Entry'"@en ;
+    rdfs:domain cascade:DataSource ;
+    rdfs:range xsd:string .
+
+cascade:sourceBundleId a owl:DatatypeProperty ;
+    rdfs:label "Source Bundle Identifier"@en ;
+    rdfs:comment "App bundle identifier (e.g., 'com.apple.health'). Maps to HKSource.bundleIdentifier on Apple platforms."@en ;
+    rdfs:domain cascade:DataSource ;
+    rdfs:range xsd:string .
+
+cascade:sourceReliabilityTier a owl:DatatypeProperty ;
+    rdfs:label "Source Reliability Tier"@en ;
+    rdfs:comment "Reliability classification: 'clinical' (lab equipment, EHR), 'medical_device' (FDA-cleared BP cuff), 'consumer_device' (smartwatch, fitness tracker), 'self_reported' (manual entry). Tiers inform display and conflict resolution — they do not imply clinical validity."@en ;
+    rdfs:domain cascade:DataSource ;
+    rdfs:range xsd:string .
+
+cascade:sourceMetricCoverage a owl:ObjectProperty ;
+    rdfs:label "Source Metric Coverage"@en ;
+    rdfs:comment "A wellness metric this source provides. Use multiple triples for multiple metrics (e.g., two triples linking to health:restingHeartRate and health:heartRateVariability). Preferred over comma-separated strings for proper RDF graph traversal."@en ;
+    rdfs:domain cascade:DataSource .
+
+# ============================================================================
+# ============================================================================
+# Provenance Detail Properties (v2.3)
+# ============================================================================
+
+cascade:sourceOrganization a owl:DatatypeProperty ;
+    rdfs:label "Source Organization"@en ;
+    rdfs:comment "Organization that provided this record (e.g., 'Kaiser Permanente', 'Mayo Clinic'). Populated from FHIR meta.source or contained Organization reference during clinical record import."@en ;
+    rdfs:range xsd:string .
+
+cascade:sourceDeviceName a owl:DatatypeProperty ;
+    rdfs:label "Source Device Name"@en ;
+    rdfs:comment "Device or app that recorded this measurement (e.g., 'Apple Watch Series 9', 'Omron BP Monitor'). Populated from HealthKit HKSource contributing app/device name."@en ;
+    rdfs:range xsd:string .
+
+# Vocabulary Organization (v1.3)
+# ============================================================================
+
+cascade:subConcern a owl:AnnotationProperty ;
+    rdfs:label "Sub-Concern"@en ;
+    rdfs:comment "Classifies a vocabulary class by its functional role within a vocabulary. Values are vocabulary-specific strings (e.g., 'summary', 'intake', 'analytics', 'identity', 'app-config', 'structural', 'deprecated'). Used for documentation generation, migration planning, and vocabulary organization."@en ;
+    rdfs:domain owl:Class ;
+    rdfs:range xsd:string .
+
+# ============================================================================
+# Schema Metadata Annotations (v2.1 — PF1-R)
+# ============================================================================
+
+cascade:addedInSchemaVersion a owl:AnnotationProperty ;
+    rdfs:label "Added in Schema Version"@en ;
+    rdfs:comment "Records which schema version introduced this data element. Used by serializers to annotate when a class or property was first emitted."@en ;
+    rdfs:range xsd:string .
+
+cascade:cascadeUri a owl:DatatypeProperty ;
+    rdfs:label "Cascade URI"@en ;
+    rdfs:comment "Stable identifier URI for a Cascade data element. Used across vocabularies to mint persistent identifiers for supplements, medications, and other resources."@en ;
+    rdfs:range xsd:anyURI .
+
+# ============================================================================
+# Shared Preference Properties (v1.3)
+# ============================================================================
+# Cross-app user preferences. These properties are used in /settings/shared/
+# preferences.ttl for preferences that apply across all Cascade apps.
+# App-specific settings use their own namespace (e.g., checkup:, pots:).
+
+cascade:notificationsEnabled a owl:DatatypeProperty ;
+    rdfs:label "Notifications Enabled"@en ;
+    rdfs:comment "Whether the user has enabled push notifications across Cascade apps."@en ;
+    rdfs:range xsd:boolean .
+
+cascade:preferredUnits a owl:DatatypeProperty ;
+    rdfs:label "Preferred Units"@en ;
+    rdfs:comment "User's preferred unit system: 'metric' or 'imperial'."@en ;
+    rdfs:range xsd:string .
+
+# ============================================================================
+# Patient Profile (v2.0)
+# ============================================================================
+# Health-specific patient demographics, designed to complement a Solid-compatible
+# foaf:Agent identity profile. The general identity profile (/profile/card.ttl)
+# uses foaf:/vcard:/dct: vocabularies. This health profile (/profile/health.ttl)
+# uses cascade: for health-relevant demographics that are always private.
+#
+# Two-document profile model (Solid WebID Profile pattern):
+#   /profile/card.ttl  -- foaf:Agent with foaf:givenName, foaf:familyName,
+#                          vcard:hasEmail, vcard:hasTelephone, dct:language
+#                          (linked via rdfs:seeAlso to health profile)
+#   /profile/health.ttl -- cascade:PatientProfile with health-specific data
+#
+# Design rationale: Separate documents enable different access control policies.
+# The general profile may be shared; the health profile is always private.
+# See Schema Refactoring Plan WS6 for full architectural discussion.
+
+cascade:PatientProfile a owl:Class ;
+    rdfs:label "Patient Profile"@en ;
+    rdfs:comment "Health-specific patient demographics and identity extensions. Designed to complement a Solid-compatible foaf:Agent identity profile (linked via rdfs:seeAlso). Stored at /profile/health.ttl. Contains health-relevant demographic data that is always private."@en .
+
+# --- PatientProfile Properties ---
+
+cascade:dateOfBirth a owl:DatatypeProperty ;
+    rdfs:label "Date of Birth"@en ;
+    rdfs:comment "Patient date of birth for age calculation and screening eligibility. FHIR-aligned: fhir:Patient.birthDate."@en ;
+    rdfs:domain cascade:PatientProfile ;
+    rdfs:range xsd:date .
+
+cascade:genderIdentity a owl:DatatypeProperty ;
+    rdfs:label "Gender Identity"@en ;
+    rdfs:comment "Patient-reported gender identity. Values: woman, man, non_binary, other, prefer_not_to_say. SNOMED CT mapped via US Core genderIdentity extension."@en ;
+    rdfs:domain cascade:PatientProfile ;
+    rdfs:range xsd:string .
+
+cascade:biologicalSex a owl:DatatypeProperty ;
+    rdfs:label "Biological Sex"@en ;
+    rdfs:comment "Biological sex for clinical calculations and screening recommendations. Values: male, female, intersex."@en ;
+    rdfs:domain cascade:PatientProfile ;
+    rdfs:range xsd:string .
+
+cascade:ageGroup a owl:DatatypeProperty ;
+    rdfs:label "Age Group"@en ;
+    rdfs:comment "Computed demographic classification for screening recommendations. Values: pediatric (0-17), young_adult (18-39), adult (40-64), senior (65+). Computed from dateOfBirth at serialization time."@en ;
+    rdfs:domain cascade:PatientProfile ;
+    rdfs:range xsd:string .
+
+cascade:emergencyContactName a owl:DatatypeProperty ;
+    rdfs:label "Emergency Contact Name"@en ;
+    rdfs:comment "Full name of the patient's emergency contact person."@en ;
+    rdfs:domain cascade:PatientProfile ;
+    rdfs:range xsd:string .
+
+cascade:emergencyContactRelationship a owl:DatatypeProperty ;
+    rdfs:label "Emergency Contact Relationship"@en ;
+    rdfs:comment "Relationship of emergency contact to the patient. Values: spouse, parent, child, sibling, partner, friend, caregiver, other."@en ;
+    rdfs:domain cascade:PatientProfile ;
+    rdfs:range xsd:string .
+
+cascade:emergencyContactPhone a owl:DatatypeProperty ;
+    rdfs:label "Emergency Contact Phone"@en ;
+    rdfs:comment "Phone number of the patient's emergency contact person."@en ;
+    rdfs:domain cascade:PatientProfile ;
+    rdfs:range xsd:string .
+
+cascade:hasAddress a owl:ObjectProperty ;
+    rdfs:label "Has Address"@en ;
+    rdfs:comment "Links to a structured postal address. Used by PatientProfile and PharmacyInfo."@en ;
+    rdfs:range cascade:Address .
+
+cascade:maritalStatus a owl:DatatypeProperty ;
+    rdfs:label "Marital Status"@en ;
+    rdfs:comment "Patient's marital status. Values: single, married, domesticPartnership, divorced, separated, widowed, preferNotToSay. FHIR-mapped via HL7 v3 MaritalStatus value set (MaritalStatus.fromFHIR())."@en ;
+    rdfs:domain cascade:PatientProfile ;
+    rdfs:range xsd:string .
+
+cascade:raceEthnicity a owl:DatatypeProperty ;
+    rdfs:label "Race/Ethnicity"@en ;
+    rdfs:comment "Patient's self-reported race/ethnicity using OMB standard categories. Multi-value: each selected value becomes a separate RDF triple with the same predicate (e.g. cascade:raceEthnicity \"asian\", \"white\"). Values: americanIndianAlaskaNative, asian, blackAfricanAmerican, hispanicLatino, nativeHawaiianPacificIslander, white, other, preferNotToSay. Elevated PHI sensitivity. FHIR-mapped via US Core race/ethnicity OMB category codes."@en ;
+    rdfs:domain cascade:PatientProfile ;
+    rdfs:range xsd:string .
+
+cascade:hasPreferredPharmacy a owl:ObjectProperty ;
+    rdfs:label "Has Preferred Pharmacy"@en ;
+    rdfs:comment "Links to the patient's preferred pharmacy for prescriptions. Deprecated v2.2 — use cascade:preferredPharmacy (blank-node linking) instead."@en ;
+    owl:deprecated true ;
+    rdfs:domain cascade:PatientProfile ;
+    rdfs:range cascade:PharmacyInfo .
+
+cascade:hasAdvanceDirectives a owl:ObjectProperty ;
+    rdfs:label "Has Advance Directives"@en ;
+    rdfs:comment "Links to the patient's advance directive declarations. Elevated PHI sensitivity. Deprecated v2.2 — use cascade:advanceDirectives (blank-node linking) instead."@en ;
+    owl:deprecated true ;
+    rdfs:domain cascade:PatientProfile ;
+    rdfs:range cascade:AdvanceDirectives .
+
+# PatientProfile additional properties (v2.2, Phase 3.5 ONT2)
+
+cascade:computedAge a owl:DatatypeProperty ;
+    rdfs:label "Computed Age"@en ;
+    rdfs:comment "Patient age in years, computed from dateOfBirth at serialization time. App-layer convenience property."@en ;
+    rdfs:domain cascade:PatientProfile ;
+    rdfs:range xsd:integer .
+
+cascade:profileId a owl:DatatypeProperty ;
+    rdfs:label "Profile ID"@en ;
+    rdfs:comment "Unique identifier (UUID) for the patient profile instance. Used for traceability and deduplication."@en ;
+    rdfs:domain cascade:PatientProfile ;
+    rdfs:range xsd:string .
+
+cascade:pharmacyAddress a owl:DatatypeProperty ;
+    rdfs:label "Pharmacy Address"@en ;
+    rdfs:comment "Pharmacy address as a single text string. Simplified alternative to using a nested cascade:Address blank node for PharmacyInfo."@en ;
+    rdfs:domain cascade:PharmacyInfo ;
+    rdfs:range xsd:string .
+
+cascade:EmergencyContact a owl:Class ;
+    rdfs:label "Emergency Contact"@en ;
+    rdfs:comment "A patient's emergency contact person. Used as a blank node within cascade:PatientProfile. Properties: cascade:contactName, cascade:contactRelationship, cascade:contactPhone."@en .
+
+cascade:contactName a owl:DatatypeProperty ;
+    rdfs:label "Contact Name"@en ;
+    rdfs:comment "Full name of a contact person. Used within cascade:EmergencyContact blank nodes."@en ;
+    rdfs:domain cascade:EmergencyContact ;
+    rdfs:range xsd:string .
+
+cascade:contactRelationship a owl:DatatypeProperty ;
+    rdfs:label "Contact Relationship"@en ;
+    rdfs:comment "Relationship of the contact to the patient: spouse, parent, child, sibling, partner, friend, caregiver, other."@en ;
+    rdfs:domain cascade:EmergencyContact ;
+    rdfs:range xsd:string .
+
+cascade:contactPhone a owl:DatatypeProperty ;
+    rdfs:label "Contact Phone"@en ;
+    rdfs:comment "Phone number for a contact person. Used within cascade:EmergencyContact blank nodes and also for general contact use on PatientProfile."@en ;
+    rdfs:range xsd:string .
+
+cascade:emergencyContact a owl:ObjectProperty ;
+    rdfs:label "Emergency Contact"@en ;
+    rdfs:comment "Links a PatientProfile to an EmergencyContact blank node."@en ;
+    rdfs:domain cascade:PatientProfile ;
+    rdfs:range cascade:EmergencyContact .
+
+cascade:advanceDirectives a owl:ObjectProperty ;
+    rdfs:label "Advance Directives"@en ;
+    rdfs:comment "Links a PatientProfile to an AdvanceDirectives blank node."@en ;
+    rdfs:domain cascade:PatientProfile ;
+    rdfs:range cascade:AdvanceDirectives .
+
+cascade:preferredPharmacy a owl:ObjectProperty ;
+    rdfs:label "Preferred Pharmacy"@en ;
+    rdfs:comment "Links a PatientProfile to a PharmacyInfo blank node."@en ;
+    rdfs:domain cascade:PatientProfile ;
+    rdfs:range cascade:PharmacyInfo .
+
+cascade:address a owl:ObjectProperty ;
+    rdfs:label "Address"@en ;
+    rdfs:comment "Links an entity to an Address blank node. Used by PatientProfileSerializer."@en ;
+    rdfs:domain cascade:PatientProfile ;
+    rdfs:range cascade:Address .
+
+cascade:preferredLanguage a owl:DatatypeProperty ;
+    rdfs:label "Preferred Language"@en ;
+    rdfs:comment "Patient's preferred language for medical communication. NOTE: In the two-document Solid WebID Profile model, this should be emitted as dct:language in /profile/card.ttl (IdentityProfileSerializer), NOT in /profile/health.ttl (PatientProfileSerializer). This property is defined for backward compatibility but SER1 will remove it from PatientProfileSerializer."@en ;
+    rdfs:domain cascade:PatientProfile ;
+    rdfs:range xsd:string .
+
+# ============================================================================
+# Address (v2.0)
+# ============================================================================
+# Structured postal address. Reuses FHIR Address semantics.
+# Used by PatientProfile (home address) and PharmacyInfo (pharmacy location).
+
+cascade:Address a owl:Class ;
+    rdfs:label "Address"@en ;
+    rdfs:comment "Structured postal address reusing FHIR Address semantics. Used by PatientProfile and PharmacyInfo."@en .
+
+cascade:streetAddress a owl:DatatypeProperty ;
+    rdfs:label "Street Address"@en ;
+    rdfs:comment "Street line(s) of the address. Simplified alias of cascade:addressLine for flat serialization patterns."@en ;
+    rdfs:domain cascade:Address ;
+    rdfs:range xsd:string .
+
+cascade:city a owl:DatatypeProperty ;
+    rdfs:label "City"@en ;
+    rdfs:comment "City name. Simplified alias of cascade:addressCity for flat serialization patterns."@en ;
+    rdfs:domain cascade:Address ;
+    rdfs:range xsd:string .
+
+cascade:state a owl:DatatypeProperty ;
+    rdfs:label "State"@en ;
+    rdfs:comment "State or province. Simplified alias of cascade:addressState for flat serialization patterns."@en ;
+    rdfs:domain cascade:Address ;
+    rdfs:range xsd:string .
+
+cascade:postalCode a owl:DatatypeProperty ;
+    rdfs:label "Postal Code"@en ;
+    rdfs:comment "ZIP or postal code. Simplified alias of cascade:addressPostalCode for flat serialization patterns."@en ;
+    rdfs:domain cascade:Address ;
+    rdfs:range xsd:string .
+
+cascade:country a owl:DatatypeProperty ;
+    rdfs:label "Country"@en ;
+    rdfs:comment "Country name or ISO 3166-1 code. Simplified alias of cascade:addressCountry for flat serialization patterns."@en ;
+    rdfs:domain cascade:Address ;
+    rdfs:range xsd:string .
+
+# FHIR-aligned Address properties (v2.2, Phase 3.5 ONT1)
+# These mirror the FHIR Address datatype fields used by the SDK Address struct.
+# The simpler properties (streetAddress, city, state, postalCode, country) are
+# retained as aliases for CheckupSerializer backward compatibility.
+
+cascade:addressUse a owl:DatatypeProperty ;
+    rdfs:label "Address Use"@en ;
+    rdfs:comment "Purpose of the address: home, work, temp, old. Aligns with FHIR Address.use."@en ;
+    rdfs:domain cascade:Address ;
+    rdfs:range xsd:string .
+
+cascade:addressType a owl:DatatypeProperty ;
+    rdfs:label "Address Type"@en ;
+    rdfs:comment "Type of address: postal, physical, both. Aligns with FHIR Address.type."@en ;
+    rdfs:domain cascade:Address ;
+    rdfs:range xsd:string .
+
+cascade:addressText a owl:DatatypeProperty ;
+    rdfs:label "Address Text"@en ;
+    rdfs:comment "Full address as a single text string. Aligns with FHIR Address.text."@en ;
+    rdfs:domain cascade:Address ;
+    rdfs:range xsd:string .
+
+cascade:addressLine a owl:DatatypeProperty ;
+    rdfs:label "Address Line"@en ;
+    rdfs:comment "Street address line. Repeatable for multi-line addresses. Aligns with FHIR Address.line."@en ;
+    rdfs:domain cascade:Address ;
+    rdfs:range xsd:string .
+
+cascade:addressCity a owl:DatatypeProperty ;
+    rdfs:label "Address City"@en ;
+    rdfs:comment "City name. FHIR-aligned equivalent of cascade:city. Aligns with FHIR Address.city."@en ;
+    rdfs:domain cascade:Address ;
+    rdfs:range xsd:string .
+
+cascade:addressDistrict a owl:DatatypeProperty ;
+    rdfs:label "Address District"@en ;
+    rdfs:comment "District or county. Aligns with FHIR Address.district."@en ;
+    rdfs:domain cascade:Address ;
+    rdfs:range xsd:string .
+
+cascade:addressState a owl:DatatypeProperty ;
+    rdfs:label "Address State"@en ;
+    rdfs:comment "State or province. FHIR-aligned equivalent of cascade:state. Aligns with FHIR Address.state."@en ;
+    rdfs:domain cascade:Address ;
+    rdfs:range xsd:string .
+
+cascade:addressPostalCode a owl:DatatypeProperty ;
+    rdfs:label "Address Postal Code"@en ;
+    rdfs:comment "Postal or ZIP code. FHIR-aligned equivalent of cascade:postalCode. Aligns with FHIR Address.postalCode."@en ;
+    rdfs:domain cascade:Address ;
+    rdfs:range xsd:string .
+
+cascade:addressCountry a owl:DatatypeProperty ;
+    rdfs:label "Address Country"@en ;
+    rdfs:comment "Country name or ISO code. FHIR-aligned equivalent of cascade:country. Aligns with FHIR Address.country."@en ;
+    rdfs:domain cascade:Address ;
+    rdfs:range xsd:string .
+
+# ============================================================================
+# Pharmacy Info (v2.0)
+# ============================================================================
+# Preferred pharmacy for prescriptions. Manual entry only (no Apple import source).
+
+cascade:PharmacyInfo a owl:Class ;
+    rdfs:label "Pharmacy Info"@en ;
+    rdfs:comment "Preferred pharmacy for prescriptions. Manual entry only (no Apple Health import source). Linked from PatientProfile via cascade:hasPreferredPharmacy."@en .
+
+cascade:pharmacyName a owl:DatatypeProperty ;
+    rdfs:label "Pharmacy Name"@en ;
+    rdfs:comment "Name of the pharmacy."@en ;
+    rdfs:domain cascade:PharmacyInfo ;
+    rdfs:range xsd:string .
+
+cascade:pharmacyPhone a owl:DatatypeProperty ;
+    rdfs:label "Pharmacy Phone"@en ;
+    rdfs:comment "Phone number of the pharmacy."@en ;
+    rdfs:domain cascade:PharmacyInfo ;
+    rdfs:range xsd:string .
+
+# Note: PharmacyInfo reuses cascade:hasAddress for its location.
+
+# ============================================================================
+# Advance Directives (v2.0)
+# ============================================================================
+# Patient-reported advance directive declarations. Elevated PHI sensitivity.
+
+cascade:AdvanceDirectives a owl:Class ;
+    rdfs:label "Advance Directives"@en ;
+    rdfs:comment "Patient-reported advance directive declarations. Elevated PHI sensitivity. Linked from PatientProfile via cascade:hasAdvanceDirectives."@en .
+
+cascade:hasLivingWill a owl:DatatypeProperty ;
+    rdfs:label "Has Living Will"@en ;
+    rdfs:comment "Whether the patient has a living will on file."@en ;
+    rdfs:domain cascade:AdvanceDirectives ;
+    rdfs:range xsd:boolean .
+
+cascade:hasPowerOfAttorney a owl:DatatypeProperty ;
+    rdfs:label "Has Power of Attorney"@en ;
+    rdfs:comment "Whether the patient has a healthcare power of attorney on file."@en ;
+    rdfs:domain cascade:AdvanceDirectives ;
+    rdfs:range xsd:boolean .
+
+cascade:hasDNR a owl:DatatypeProperty ;
+    rdfs:label "Has DNR"@en ;
+    rdfs:comment "Whether the patient has a do-not-resuscitate order on file."@en ;
+    rdfs:domain cascade:AdvanceDirectives ;
+    rdfs:range xsd:boolean .
+
+cascade:advanceDirectiveNotes a owl:DatatypeProperty ;
+    rdfs:label "Advance Directive Notes"@en ;
+    rdfs:comment "Optional free-text notes about advance directives."@en ;
+    rdfs:domain cascade:AdvanceDirectives ;
+    rdfs:range xsd:string .
+
+# ============================================================================
+# Alignment with W3C PROV-O
+# ============================================================================
+
+# Cascade Protocol extends PROV-O for provenance tracking
+# All health data entities are prov:Entity instances
+# creatorWebID links to prov:Agent (the user)
+# Generation activities tracked via prov:wasGeneratedBy
+
+# Example usage:
+# <#pots-check-123> a pots:POTSCheckResult ;
+#     cascade:schemaVersion "1.2" ;
+#     cascade:dataProvenance cascade:ConsumerGenerated ;
+#     prov:wasAttributedTo <https://id.cascadeprotocol.org/users/abc123> ;
+#     prov:wasGeneratedBy [
+#         a prov:Activity ;
+#         prov:wasAssociatedWith <https://id.cascadeprotocol.org/users/abc123> ;
+#         prov:startedAtTime "2025-10-31T10:00:00Z"^^xsd:dateTime
+#     ] .
+
+# ============================================================================
+# Changelog
+# ============================================================================
+# v2.2 (2026-02-18): FHIR-aligned Address expansion and PatientProfile
+#     completeness (Phase 3.5 ONT1 + ONT2).
+#     ONT1: Added 9 FHIR Address.* aligned properties (addressUse, addressType,
+#     addressText, addressLine, addressCity, addressDistrict, addressState,
+#     addressPostalCode, addressCountry). Existing simple properties (streetAddress,
+#     city, state, postalCode, country) retained as aliases. Updated simple
+#     property comments to note alias relationship.
+#     ONT2: Added PatientProfile properties emitted by SDK serializer:
+#     computedAge, profileId, pharmacyAddress, preferredLanguage. Added
+#     EmergencyContact class with contactName, contactRelationship, contactPhone.
+#     Added object properties: emergencyContact, advanceDirectives,
+#     preferredPharmacy, address (blank-node linking variants used by
+#     PatientProfileSerializer).
+# v2.1 (2026-02-17): Added cascade:addedInSchemaVersion annotation property
+#     and cascade:cascadeUri datatype property. Previously dark vocabulary
+#     emitted by CheckupSerializer (supplement section). Part of Schema
+#     Refactoring Plan Phase 3 (PF1-R).
+# v1.0 (2025-10-31): Initial release. Schema versioning, data provenance
+#     (ConsumerGenerated / ClinicalGenerated), identity (creatorWebID),
+#     W3C PROV-O alignment.
+# v1.1 (2026-02-01): DataSource class — device/app/system identity with
+#     reliability tiers (clinical, medical_device, consumer_device,
+#     self_reported), bundle identifier, and metric coverage. Subclasses
+#     prov:Agent. Reconciliation strategy deferred to post-MVP.
+# v2.0 (2026-02-17): Patient demographics and identity classes. Added
+#     cascade:PatientProfile class with 12 properties (dateOfBirth,
+#     genderIdentity, biologicalSex, ageGroup, emergencyContactName,
+#     emergencyContactRelationship, emergencyContactPhone, hasAddress,
+#     maritalStatus, raceEthnicity, hasPreferredPharmacy,
+#     hasAdvanceDirectives). Added 4 supporting classes: Address (5 properties),
+#     PharmacyInfo (2 properties + reuses hasAddress), AdvanceDirectives
+#     (4 properties). Designed as Solid WebID Profile extension with
+#     two-document model (foaf:Agent card.ttl + cascade:PatientProfile
+#     health.ttl linked via rdfs:seeAlso). Added foaf: and vcard: prefix
+#     declarations. Part of Schema Refactoring Plan Phase 3 (WS6a).
+# v1.3 (2026-02-17): Added cascade:subConcern annotation property for
+#     classifying vocabulary classes by functional role (summary, intake,
+#     analytics, identity, app-config, structural, deprecated). Added shared
+#     preference properties: notificationsEnabled, preferredUnits. Part of
+#     Schema Refactoring Plan Phase 1 (WS2 + WS5).
+# v1.2 (2026-02-10): Promoted ConsumerGenerated and ClinicalGenerated from
+#     OWL individuals to owl:Class subclasses of DataProvenance. Added 6
+#     DataProvenance subclasses: DeviceGenerated, SelfReported,
+#     ConsumerWellness (under ConsumerGenerated); EHRVerified, ScannedDocument,
+#     AIExtracted (under ClinicalGenerated). Aligns with SDK DataProvenance
+#     enum (6 cases). Backward-compatible: existing data using
+#     cascade:ConsumerGenerated/ClinicalGenerated remains valid.