Cairn Documentation
Entity Types 11
The data model primitives that make up every Cairn project.
Core building block โ system, subsystem, assembly, part, or external actor. Properties bag supports engineering params, evaluation status, the brief and the narrative.
idnametypedescriptionparentIdpropertiespositionsortOrdercreatedByFunctional, performance, interface, safety, environmental, or constraint requirement scoped to a node.
idnodeIdtitledescriptiontypepriorityrationaleacceptanceCriteriasortOrderConnection between two nodes carrying typed signals with protocol, rate, and simulation metadata.
idnamesourceNodeIdtargetNodeIdsignalsprotocoldescriptionBehavioral state in a node's state machine. Supports timing annotations for simulation.
idnametypedescriptionnodeIdpositiontypicalDurationdurationUnitState transition with guard condition, action, and optional timing parameters.
idnodeIdsourceStateIdtargetStateIdtriggerguardactiontypicalDurationTest, analysis, demonstration, or inspection record linked to a requirement.
idrequirementIdmethodtitledescriptionstatusresultsTraceability relationship: satisfies, implements, verifies, derives, depends_on, or custom.
idtypesourceIdtargetIdsourceKindtargetKindrationaleconfidencestatusOperational scenario with actors, preconditions, postconditions, and ordered steps. An actor is a name, linked to the external actor it matches; a requirement comes from a use case through a derives trace link.
idnodeIdtitledescriptionactorspreconditionspostconditionsstepsKey-value engineering parameter with units, category, and source. Stored in node.properties.params[].
keylabelvalueunitIdcategorysourcedescriptionOptional dendritic evaluation on a node, in its parameters: whether it was chosen, is open or was set aside, and why.
evaluationStatusdecisionTypepruneReasonfirstPrincipleevaluationPhasealternativeTocrossDependenciesOptional technology maturity on a node, in its parameters: a stage from concept to mature (or deprecated), a confidence and the evidence.
maturity_stagematurity_confidencematurity_notes