Skip to main content

stave catalog gaps

Compare catalog against an external checklist

Usage

stave catalog gaps <checklist-file> [flags]

Description

Gaps loads an external YAML checklist and reports which items have matching controls in the catalog (COVERED) and which do not (UNCOVERED). Ambiguous matches (multiple controls match) are marked with "?".

Checklist format: checks: - id: iam-mfa-root service: IAM description: "Root account has MFA enabled" reference: "CIS 1.5"

Matching logic: same service + keyword overlap on description. Use --strict for exact control-ID matching only.

Inputs: Path to the YAML checklist (positional, required) --format F text (default) | json --strict Exact ID match only, no fuzzy matching --controls DIR Control catalog directory (default: controls)

Exit codes: 0 Success 2 Invalid input (bad checklist file) 4 Internal error

Flags

FlagTypeDescription
-i, --controlsstringcontrol catalog directory (default: controls)
-f, --formatstringoutput format: text | json (default: text)
--strictboolexact control-ID match only, no fuzzy matching

Examples

stave catalog gaps checklist.yaml
stave catalog gaps cis-benchmark.yaml --strict
stave catalog gaps prowler-checks.yaml --format json