Language Reference

SODL has six top-level constructs: template, system, interface, module, policy, and pipeline.

All constructs support nested blocks for configuration, constraints, and documentation.

Quick reference

Construct	Purpose
`template`	Reusable base with shared stack and policies
`system`	Main system definition; extends a template
`interface`	Data contracts and method signatures
`module`	Groups related functionality with ownership
`policy`	Enforceable rules with severity levels
`pipeline`	Ordered steps for code generation or deployment

step is a block nested inside pipeline, not a top-level construct.

File structure

A SODL file typically follows this order:

# 1. Templates (reusable bases)
template "Base":
  stack: ...
  policy ...: ...

# 2. Interfaces (contracts)
interface MyInterface:
  method render() -> str

# 3. System definition
system "MySystem" extends "Base":
  version = "1.0.0"
  stack: ...
  intent: ...

  # 4. Nested interfaces (scoped to system)
  interface InnerInterface extends MyInterface:
    ...

  # 5. Modules (within system)
  module MyModule:
    ...

  # 6. Pipelines
  pipeline "Production":
    step Build: ...

See the detailed pages for each construct: