akua / cli / diff

akua diff

Shipped

Structural diff between two package versions, or between a local package and a published version.

akua diff <a> <b> [flags]
akua diff <ref>                    # diff local HEAD against published ref

Flags

flagdescription
`--format=<structural\yaml\both>`diff level (default: structural)
`--scope=<schema\sources\manifests\all>`what to compare (default: all)
--filter=<pattern>only show diffs matching pattern

Exit codes

0 if no structural changes, 1 if changes present. Useful for CI gates: non-zero = upgrade is breaking.

JSON output

{
  "schema": {
    "added": ["adminEmail"],
    "removed": [],
    "type_changed": [],
    "default_changed": [{"path": "replicas", "from": 3, "to": 5}]
  },
  "sources": {
    "added": [],
    "removed": [],
    "version_changed": [{"name": "cnpg", "from": "0.20.0", "to": "0.21.0"}]
  },
  "manifests": {
    "added": 2,
    "removed": 0,
    "modified": 4
  },
  "policy_compat": "allow"
}