Reference

§ 1

Vocabularies

Vocabularies

Each namespace is https://ns.cascadeprotocol.org/<name>/v1# and resolves to its page below. Every page lists its classes, properties, SHACL shapes and standard mappings, with the Turtle file to download.

Ratified

• corev3.12Identity, provenance and pod structure. Every other vocabulary builds on it.
• clinicalv1.21EHR records: medications, conditions, allergies, labs, immunizations, encounters, documents.
• healthv2.12Wellness and device data from wearables and home devices.
• coveragev1.6Insurance plans, claims, benefits, denials and appeals.
• checkupv3.3Patient-facing summaries built from the records above.
• potsv1.4Home orthostatic screening results, used by POTS Check.

Drafts · may change without a major version

• advisory1.0-draft.0.2Clinical advisories.
• diabetes1.0-draft.0.2Chronic disease management, starting with diabetes.
• evidence1.0-draft.0.3Grounding answers in evidence and sources.
• genomics1.0-draft.0.5Genetic test results.
• workbench1.0-draft.0.7Investigation workspaces for Cascade Workbench.

All vocabularies on one page · Ontology explorer · Every schema in one file (for agents)

§ 2

Specification

Specification

Normative documents, synced from the spec repository. Where a document and an implementation disagree, the document wins.

• SerializationnormativeHow each record is written in Turtle.
• Pod structurenormativeThe folder layout of a pod, and exports.
• Pod encryptiondraft 1.1Encryption at rest: file format, keys, and its stated limits.
• Validation profilenormativeHow SHACL shapes are evaluated, so every validator agrees.
• VersioningpolicyWhat a version number promises, and how to handle terms you don't know.
• Decision recordsGitHub ↗Each design decision, dated, with its reasoning.
• Conformance suiteGitHub ↗Fixtures and test vectors for checking an implementation.

§ 3

CLI and SDKs

CLI and SDKs

Open source under Apache 2.0. They move fast, and the SDKs trail the newest vocabulary versions; the status page has the details.

• CLI guide0.28.0Import FHIR, C-CDA and Apple Health; validate, query, amend, encrypt.
• CLI command referencegeneratedEvery command and flag, generated from the CLI itself; also as JSON.
• TypeScript SDK3.0.0Typed records, Turtle serialization, validation; runs in Node and the browser.
• Python SDK3.0.0Open pods, query records, load into pandas. Python 3.10+.
• Agents and MCP1.2.0Plain-English commands and a local MCP server. A cloud model sees what an agent reads.

§ 4

Guides

Guides and examples

• Importing from several sourcesguideBring records from more than one health system into one pod.
• CLI worked examplesguideC-CDA, FHIR, reconciliation and narrative extraction, step by step.
• Encrypted podsguideHow to implement the encryption spec and run its test vectors.
• Agent examples3 examplesMedication review, trend analysis and visit prep on a reference patient.
• Playgroundin browserTurn JSON into Cascade Turtle and see the result.
• Deterministic IDssupersededKept for reference; replaced by the canonical-layer decision.

§ 5

Background

Background

• Security and privacyguideWhat is protected, by what, and the limits.
• Compared with othersguideCascade next to FHIR, HealthKit, openEHR and ad-hoc JSON, weaknesses included.
• POTS Check case studycase studyOne app built on Cascade, end to end.
• Build notesblogWhy RDF, provenance, and keeping the data layer local.

Standards Cascade builds on: FHIR · RDF · OWL · SHACL · PROV-O · Solid