Documentation

The Cascade Protocol provides a modular ontology framework for representing personal health and wellness data using Linked Data standards. This documentation covers the semantic vocabularies and SDK.

Semantic Vocabularies

The Cascade Protocol uses modular RDF vocabularies built on W3C standards. Each vocabulary can be versioned independently while maintaining interoperability.

Core Vocabulary v1.0 Stable

Namespace: https://ns.cascadeprotocol.org/core/v1#
Prefix: cascade:

Cross-application vocabulary for schema versioning, data provenance, and user identity. Used by all Cascade Protocol applications.

View Documentation Download TTL

Clinical Vocabulary v1.4 Stable

Namespace: https://ns.cascadeprotocol.org/clinical/v1#
Prefix: clinical:

Vocabulary for clinical documents and structured health records imported from EHR systems via Apple HealthKit. Supports medications, allergies, lab results, conditions, immunizations, procedures, vital signs, medication use episodes, supplements, and longitudinal lab tracking with FHIR alignment.

View Documentation Download TTL

Health Vocabulary v1.4 Stable

Namespace: https://ns.cascadeprotocol.org/health/v1#
Prefix: health:

Consumer wellness and device-generated health data — vital signs, activity, sleep, with SNOMED CT and LOINC standard code mappings for all metrics.

View Documentation Download TTL

POTS Vocabulary v1.2 Stable

Namespace: https://ns.cascadeprotocol.org/pots/v1#
Prefix: pots:

Domain-specific vocabulary for POTS home screening checks using the NASA Lean Test protocol. Supports age-adjusted thresholds, symptom logging, and blood pressure analysis.

View Documentation Download TTL

Checkup Vocabulary v1.4 Stable

Namespace: https://ns.cascadeprotocol.org/checkup/v1#
Prefix: checkup:

Vocabulary for patient intake forms and pre-visit health data aggregation. Combines EHR-imported data, HealthKit wellness data, supplements, and manually entered information into comprehensive patient profiles.

View Documentation Download TTL

Diabetes Vocabulary Draft

Namespace: https://ns.cascadeprotocol.org/diabetes/v1#
Prefix: diabetes:

Unified vocabulary for diabetes and pre-diabetes management. Aggregates data from CGMs, glucose meters, insulin pumps, and lifestyle tracking devices into a coherent format with Time-in-Range metrics and pattern detection.

View Documentation Download TTL

ECG Vocabulary Coming Soon

Namespace: https://ns.cascadeprotocol.org/ecg/v1#
Prefix: ecg:

Electrocardiogram data from Apple Watch and medical devices. Planned for v2.0.

Interactive Guide

Explore the Cascade Protocol documentation interactively. Ask questions, get explanations, and learn about the vocabularies through conversation.

Powered by Google NotebookLM. Requires a Google account to access.

Open in Google NotebookLM

Quick Start

Here's a minimal example showing how the vocabularies work together:

@prefix cascade: <https://ns.cascadeprotocol.org/core/v1#> .
@prefix pots: <https://ns.cascadeprotocol.org/pots/v1#> .
@prefix prov: <http://www.w3.org/ns/prov#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

<#pots-check-abc123> a pots:POTSCheckResult ;
    # Core vocabulary properties
    cascade:schemaVersion "1.2" ;
    cascade:dataProvenance cascade:ConsumerGenerated ;

    # POTS-specific properties
    pots:date "2025-12-05T14:30:00Z"^^xsd:dateTime ;
    pots:protocol "nasaLean" ;
    pots:potsThresholdMet "true"^^xsd:boolean ;

    # Provenance tracking
    prov:wasAttributedTo <https://id.cascadeprotocol.org/users/abc123> .

Design Principles

  • Modularity: Core concepts are stable and versioned independently from domain vocabularies. New health apps can be added without breaking existing data.
  • Interoperability: All vocabularies align with healthcare standards (FHIR, SNOMED CT, LOINC) and use standard W3C formats.
  • Privacy-First: Designed for local-first storage in Solid Pods with WebID-based access control.
  • Consumer Wellness Focus: Data is classified as consumer-generated wellness information (non-diagnostic).
  • Provenance Tracking: All data includes comprehensive provenance metadata using W3C PROV-O.

SDK (Coming Soon)

The Cascade Protocol SDK for Swift is currently in development. It provides:

  • Local encrypted Pod storage with AES-256-GCM
  • Automatic RDF/Turtle serialization and deserialization
  • HealthKit integration for Apple Watch data
  • WebID-based identity and access control
  • Audit logging and provenance tracking

Contact us for early access to the SDK.

Resources