Skip to main content
cops release policy validate checks the release gate configuration in cops.project.json for structural errors before you run cops release check. Use it after editing cops.project.json to catch issues like duplicate gate IDs, unsupported gate types, invalid parameters, and expired waivers.

Usage

cops release policy validate [flags]

Flags

--project
string
Validate only the named project from the projects map. When omitted, all projects in the config are validated.
--output
string
default:"table"
Output format: table, json, or markdown.

Output columns

project, check, status, details
CheckDescription
gates_definedpass when at least one gate is configured; warn when no gates are defined
gate_id_uniquefail when a gate ID is duplicated within a project
gate_type_supportedfail when a gate type is not in the supported list
gate_schemafail when a gate is missing required params for its type
sla_hours_validfail when slaHours is set to a non-positive value
owner_present_for_ticketwarn when ticket is set but owner is missing
waiver_expiry_formatfail when waiverExpires is not a valid ISO datetime
waiver_expiry_futurewarn when waiverExpires is in the past
waiver_expiry_presentwarn when waiver is set but waiverExpires is missing (waiver never expires)

Exit codes

CodeMeaning
0All checks passed
10One or more warnings found (e.g. no gates configured, expired waiver)
30One or more validation failures or cops.project.json not found

Examples

cops release policy validate
project     check              status  details
──────────  ─────────────────  ──────  ───────────────────────────────────
my-service  gates_defined      pass    7 gates configured
my-service  gate_id_unique     pass
my-service  gate_type_supported pass
my-service  gate_schema        pass
Run cops release policy validate after editing cops.project.json and before running cops release check to catch configuration errors early without making API calls.

cops release check

Run the validated gates against live product APIs.

Configuration guide

Full reference for cops.project.json structure and gate fields.

Build docs developers (and LLMs) love