Compare two YAML documents structurally — key order doesn't matter, values are normalized by type, and lists can be matched by position or by a chosen identity key. Useful for Kubernetes manifests, Helm values, CI workflows, and any config drift hunt.
Both documents are parsed into a normalized tree of maps, lists, and scalars. The diff walks both trees in parallel, reporting any path where A and B disagree. By default lists are compared positionally — turn on compare as sets for tag/label arrays where order is meaningless, or set a list identity key (like name) to align list items by that field, the same way kubectl matches container entries across manifests. The parser handles flow-style ({} and []), block style, anchors &ref with aliases *ref, multi-line strings (| and >), and common scalar types (bool, int, float, null, dates as strings).