04. Capabilities
This chapter defines the extension mechanism of RUML: the Capabilities System.
Capabilities enable enriching RUML files with optional or proprietary functionalities without modifying the core specification. Parsers can safely reject unknown capabilities (if required) or ignore them (if optional) — silent data loss or unnoticed corruption is excluded.
Sections of This Chapter
| Section | Content |
|---|---|
| 4.1 Concept | Motivation, design philosophy, delivery modes |
| 4.2 Capability Declaration | Root-level declaration, entry format, parser obligations |
| 4.3 Capability Data at Nodes | Node-level extension data, referential integrity |
| Moved to Chapter 7 | |
| 4.4 Namespaces | Capability ID conventions, prefix table, syntax rules |
| 4.5 RUML-EXT Format | Sidecar file .ruml-ext, $base reference, hash verification |
| 4.6 Parser Obligations | Parse order and requirements for validation tools |
4.7 ruml:datapoints | Typed data point definitions as capability |
4.8 ruml:query | Data-based query expressions as capability |
4.9 ruml:ai-query | AI-powered decisions as capability |
4.10 ruml:actions | Actions as capability |
4.11 ruml:context | Context materials as capability |
4.12 ruml:text-reference | Normative text references as capability |
4.13 ruml:protocol | Evaluation protocol (audit trail) as capability |
4.14 ruml:expression | Combination expression for the DELEGATED operator |
4.15 ruml:tree-reference | References to nodes and subtrees of other RUML files as capability |
4.16 ruml:tree-include | Evaluation of a node of another RUML file in place of a leaf node |