Skip to main content

stave trend oscillation

Classify violation oscillation patterns across assessment history

Usage

stave trend oscillation [flags]

Description

Classify control-asset pairs into oscillation patterns (chronic, deploy-time, or random) by analyzing state transitions across a sequence of assessment files.

Chronic patterns indicate persistent violations (>80%% failure rate). Deploy-time patterns indicate violations that toggle with deployments. Random patterns indicate no discernible oscillation pattern.

Inputs: --history Directory of out.v0.1 assessment files --files Comma-separated assessment files --min-oscillations Minimum state transitions for deploy-time (default: 3) --format Output format: table or json (default: table)

Exit Codes: 0 Analysis complete 2 Invalid input or insufficient data

Offline-only: reads local files; makes zero network connections; no cloud credentials.

Flags

FlagTypeDescription
--filesstringComma-separated assessment files in chronological order
-f, --formatstringOutput format: table or json (default: table)
--historystringDirectory of out.v0.1 assessment files
--min-oscillationsintMinimum state transitions for deploy-time classification (default: 3)

Examples

stave trend oscillation --history ./assessments/
stave trend oscillation --history ./assessments/ --min-oscillations 5
stave trend oscillation --history ./assessments/ --format json