# yqr

> yqr is a jq-style query and editing tool for YAML written in Rust. Reads are byte-preserving by default; the write tier performs surgical edits that change only the targeted bytes. This site serves the usage documentation and the full feature/bug/architecture spec tree.

## yqr Demo

- [yqr Demo](/yqr/demo): A runnable showcase of yqr, a jq-style query & transform tool for YAML.

## yqr Specs

- [Architecture Specs](/yqr/specs/architecture): Cross-cutting design documents (yqr-aNNN-*), such as the fidelity surgical-edit architecture.
- [Architecture a001 — Fidelity-First, Surgical-Edit Model](/yqr/specs/architecture/yqr-a001-fidelity-surgical-edit): Status: Accepted Owner: yqr maintainers Last updated: 2026-06-26 Supersedes: open questions in yqr-r001 §8 (number mode…
- [Bug Specs](/yqr/specs/bugs): Bug reports and resolutions (yqr-bNNN-*). yqr-b000-bug-status.md tracks every bug and its current state.
- [Bug Status Tracker](/yqr/specs/bugs/yqr-b000-bug-status): Single source of truth for the state of every yqr-bNNN bug. Update this file in the same change that opens, advances, o…
- [Bug b001 — Round-trip through `rust-yaml` discards whitespace, comments, and formatting](/yqr/specs/bugs/yqr-b001-roundtrip-discards-whitespace-and-formatting): Status: Resolved for the default read (yqr-f009, 2026-07-11). Byte fidelity is now the default: yqr '.' f is byte-for-b…
- [Bug b002 — noyalib CST deficiencies: span boundaries, duplicate-key policy, and the string-only key model](/yqr/specs/bugs/yqr-b002-noyalib-cst-span-and-key-model-deficiencies): Status: Resolved — all seven fixes are now in the upstream noyalib 0.0.14 release (2.1 shipped in 0.0.13; 2.2–2.7 folde…
- [Bug b003 — rust-yaml fork `RoundTripDocument::parse_all` errors on a trailing `...` after a block collection](/yqr/specs/bugs/yqr-b003-rustyaml-roundtrip-trailing-doc-end-marker): Status: Resolved — moot (2026-07-10). The rust-yaml fork RoundTripDocument backend was removed when yqr consolidated on…
- [Bug b004 — noyalib CST mutation-API gaps: comment editing, key rename, sequence reorder, nested/multi-line delete](/yqr/specs/bugs/yqr-b004-noyalib-cst-mutation-api-gaps): Status: Resolved (2026-08-02) — every gap below ships in noyalib 0.0.18 (crates.io 2026-07-31, GitHub release v0.0.18 t…
- [Bug b005 — `cargo audit` fails on `crossbeam-epoch` advisory (via `criterion`)](/yqr/specs/bugs/yqr-b005-crossbeam-epoch-advisory-via-criterion): Status: Resolved Severity: Low Related: yqr-m001 (CI/release), .agent/skills/dep-upgrade
- [Bug b006 — Structural delete mishandles comments, blank lines, and same-column sequences](/yqr/specs/bugs/yqr-b006-structural-delete-trivia-and-fidelity): Status: Resolved Severity: High Related: yqr-f007 (structural delete — the shipped code these defects live in), yqr-b00…

## Optional

- [RSS Feed](/yqr/feed.xml): Subscribe to content updates
- [Sitemap](/yqr/sitemap.xml): Full site map for crawlers