Skip to main content

stave forge lint

Static analysis for control YAML files

Usage

stave forge lint [flags]

Description

Validate control YAML files for schema correctness, CEL predicate syntax, and completeness. With --semantic, performs additional checks for always-firing predicates and impossible conditions.

Exit Codes: 0 No errors, no warnings 1 Warnings only (errors with --strict) 2 Errors present 4 Internal error

Flags

FlagTypeDescription
--controlstringcontrol YAML file or directory (required)
-f, --formatstringoutput format: text | json (default: text)
--semanticboolenable semantic analysis (always-firing, never-firing)
--strictbooltreat warnings as errors

Examples

stave forge lint --control controls/ad/CTL.AD.PASS.MINLEN.001.yaml
stave forge lint --control controls/ --semantic --strict