slogen

Overview ¶

slogen turns a devedge service's API contract into reliability artifacts (WS-025): it derives GOOD default OpenSLO SLOs from an enriched OpenAPI doc, lints them through the fail-loud three-layer classifier, and renders them to Prometheus/Cortex rules, Grafana dashboards, or Loki LogQL rules.

It is the standalone tool `de slo` orchestrates via a pinned `go run` (the WS-023 hermetic pattern). The CLI contract below is STABLE — `de` depends on it.

Verbs:

slogen generate --openapi <path> [--service <name>] [--out slo.yaml]
slogen lint <file...> [--format json]
slogen render --target prometheus|grafana|loki --in <slo.yaml> --out <dir> [--preset-dir <dir>]
slogen kpis