Skip to main content

stave report

Generate executive security posture report

Usage

stave report [flags]

Description

Aggregate all assessment dimensions into a single structured report document: posture score, findings summary, SLA compliance, top findings, active chains, ATT&CK coverage, framework readiness, team attribution, and executive summary.

Consumers render the report however needed — Jinja template, Python script, Pandoc, or direct API consumption.

Inputs: --history PATH History directory (required) --snapshot PATH Snapshot to assess (required) --sla-profile-file PATH SLA policy --team-manifest PATH Team manifest --format STRING json (default) | markdown --title STRING Report title --period STRING Reporting period label

Exit Codes: 0 Report generated 2 Invalid input 4 Internal error

Flags

FlagTypeDescription
--chainsstringchains directory (default: chains)
-i, --controlsstringcontrols directory (default: controls)
-f, --formatstringoutput format: json | markdown (default: json)
--historystringhistory directory (required)
--periodstringreporting period label
--sla-profile-filestringSLA policy file
--snapshotstringsnapshot to assess (required)
--team-breakdownboolInclude per-team findings breakdown in report
--team-manifeststringteam manifest
--titlestringreport title (default: Security Posture Report)

Examples

stave report --history ./history --snapshot latest.json
stave report --history ./history --snapshot latest.json \
--sla-profile-file sla.yaml --team-manifest teams.yaml \
--format markdown > report.md