Culsma Documentation
These guides cover Culsma 1.0.9: executable laboratory protocol source, validation, plan lowering, runtime artifacts, and replay.
This site is organized as a reader path: run a representative protocol, understand the language surface, then inspect the generated execution artifacts and release boundary.
Start Here
| Goal | Page |
|---|---|
| Install the CLI. | Install Culsma |
| Write and run the first protocol. | Getting Started |
| Learn the core protocol, content, container, operation, and replay concepts. | Core Concepts |
| Check what this release does and does not claim. | Scope and Limitations |
Execution Path
SourceValidationPlanRuntimeReplay
Culsma source is parsed, compiled, validated, typechecked, lowered to a plan, executed by the runtime, and replayed from emitted events. The execution pages describe the artifacts and diagnostics produced along that path.
| Topic | Page |
|---|---|
| Pipeline stages and their outputs. | Execution Pipeline |
| JSON artifacts written by a run. | Artifacts |
| Stage-owned diagnostic families. | Diagnostics |
| Reconstructing state from runtime events. | Replay |
Language Guide
Read the language guide in order when learning the authoring surface. For normative syntax, semantics, diagnostics, and conformance requirements, use the Culsma Language Reference.
| Section | Pages |
|---|---|
| Foundations | Protocols and Bindings, Containers and Content, Units, Groups and Plate Selectors |
| Protocol operations | Material Mutation and Transfer, Agitation, Environment Application, Separation and Fractionation, Readout, Control Flow and Schedule |
Release Reference
- Language Reference is the normative public baseline for language and execution semantics.
- CLI Reference lists the public commands.
- Reproducibility records the public execution-kernel reproduction path.
- Paper and Citation connects the docs, release, and citation record.