Documentation

Semantic Vocabularies

Seven interlinked OWL vocabularies covering core identity, health device data, clinical records, patient summaries, specialized screening protocols, insurance coverage, and chronic disease management. Every vocabulary includes SHACL validation shapes, JSON-LD contexts, and human-readable documentation.

Vocabulary Specification

The authoritative source for all Cascade Protocol ontologies — OWL class definitions, SHACL validation shapes, and JSON-LD contexts for every vocabulary. Versioned using MAJOR.MINOR with backward compatibility guarantees within a major version.

Conformance Suite

Fixture-based test suite for validating SDK implementations against the specification. Covers all data types across clinical v1.7, coverage v1.3, and core v2.8 with both positive (happy path) and negative (constraint violation) cases. Used to verify that serialized Turtle output is SHACL-valid.

Serialization Spec

Formal specification for RDF/Turtle serialization format, required namespace prefixes, and canonical ordering rules.

Pod Structure

Directory layout, file naming conventions, storage organization, and discovery conventions for Cascade data pods.

TypeScript SDK

Full SDK for building Cascade Protocol applications in TypeScript and JavaScript. Includes typed models for all 21 health record types, RDF/Turtle serialization, SHACL validation, and Pod management.

npm install @the-cascade-protocol/sdk

Python SDK

Python library for reading and writing Cascade Protocol Pods. Includes Turtle serialization, RDF deserialization, SHACL validation, and pandas integration for data analysis and research workflows.

pip install cascade-protocol

CLI

Command-line interface for managing Pods, validating data against SHACL shapes, converting FHIR records to Turtle, and running a local MCP agent server. The foundation all other tools build on.

npm install -g @the-cascade-protocol/cli

Cascade Agent

Natural language interface for the Cascade Protocol CLI. Describe what you want in plain English — the agent plans and executes the right sequence of CLI commands, streaming results in real time, with the option to use local LLMs.

npm install -g @the-cascade-protocol/cli

Swift SDK Early Access

Native Swift SDK for iOS, watchOS, and macOS. Provides local encrypted Pod storage with AES-256-GCM, automatic RDF/Turtle serialization, HealthKit data ingestion, WebID-based identity, and audit logging. Currently in active development.

How It Works

Agents access Cascade Pods through the MCP server interface provided by the CLI. All queries are consent-gated, executed locally, and audit-logged. The agent sees a structured graph of typed health records — medications linked to conditions, lab results to reference ranges, diagnoses to clinical codes — not a flat document.

Working Examples

Three end-to-end examples with full agent prompts, expected outputs, and security documentation: medication interaction review (correlating ACE inhibitor + potassium supplement + K+ lab value), health trend analysis (blood pressure patterns over 3 months), and visit preparation (aggregating clinical, wellness, and patient-reported data).

Security & Compliance Guide

Covers encryption at rest, consent-gated agent access, audit logging, PHI handling, provenance model, threat model, and regulatory considerations including HIPAA and the 21st Century Cures Act.

Cascade vs FHIR, HealthKit, OpenEHR, Ad-hoc JSON

Side-by-side comparison table, code examples for the same data in each format, and an honest assessment of where Cascade excels and where established alternatives remain the better choice.

POTS Check — Cascade Protocol in Production

How POTS Check (App Store, December 2025) uses the full Cascade Protocol stack: pots: vocabulary, HealthKit data ingestion, per-record provenance tracking, AES-256-GCM encrypted Pod storage, and Solid-compatible Pod export. One app, one condition, end-to-end proof of concept.

Ontology Explorer

Visualize relationships between all Cascade Protocol vocabularies interactively. Explore the three-layer architecture, class hierarchies, and cross-vocabulary links as graphs and sortable tables.

Interactive Guide

Ask questions, get explanations, and explore the vocabularies through conversation. Powered by Google NotebookLM — a Google account is required to access.

Standards References

• W3C RDF Specification
• W3C OWL Web Ontology Language
• W3C PROV-O Provenance Ontology
• Solid Project
• HL7 FHIR R4

CLI Reference

Complete reference for every Cascade CLI command, flag, and subcommand. Covers Pod management, SHACL validation, FHIR conversion, MCP server, and conformance testing.

Multi-Source EHR Import

How to import and merge health records from multiple EHR sources (Apple Health, FHIR R4, C-CDA) into a single Cascade Pod, including deduplication and provenance tracking.

Deterministic IDs (CDP-UUID)

How Cascade Protocol generates stable, collision-resistant record identifiers from content hashes, enabling safe deduplication and cross-source merging without a central registry.