YAML language support

[selfagency]

Summary

Adds comprehensive YAML language support to srgn, enabling syntax-aware manipulation of .yaml and .yml configuration files.

Changes

• Package: Added tree-sitter-yaml v0.7.2 (1,813,985 downloads, official tree-sitter grammar)
• 8 Working PreparedQuery variants:
  • Scalar values: string-scalar, integer-scalar, float-scalar, boolean-scalar
  • Structure: block-sequence, block-mapping, flow-sequence, flow-mapping
• CLI Integration: --yaml, --yaml-query, --yaml-query-file
• Test Coverage: 8 snapshot-based tests for all prepared queries
• All tests passing: 501 unit + 195 module + 59 CLI + 2 regression

Why This Matters

YAML is the most popular configuration format across:

• DevOps & CI/CD pipelines (GitHub Actions, GitLab CI, CircleCI)
• Kubernetes configs and Helm charts
• Application configuration files
• Data serialization and API specs

This enables srgn to work effectively with the most widely-used configuration format in the ecosystem.

Example Usage

# Extract string values from YAML config
cat config.yaml | srgn --yaml string-scalar -- your-replacement

# Find all integer values
cat config.yaml | srgn --yaml integer-scalar -- resize

# Target block mappings
cat config.yaml | srgn --yaml block-mapping update-all

# Interactive replacement with scope awareness
cat config.yaml | srgn --yaml boolean-scalar toggle-features

Implementation Quality

• 100% coverage - All 8 defined variants work correctly
• Compatible - Native tree-sitter 0.25.10 compatibility (no version conflicts)
• Production ready - Fully tested and integrated

[Copilot]

Pull request overview

Adds YAML language scoping to srgn using tree-sitter-yaml, wiring it into the CLI and test suite so YAML files (.yaml / .yml) can be scoped via prepared queries or custom tree-sitter queries.

Changes:

• Add a new YAML language scoper (src/scoping/langs/yaml.rs) with 8 prepared query variants.
• Integrate YAML scoping into the CLI (--yaml, --yaml-query, --yaml-query-file) and documentation output.
• Add YAML fixture + snapshot tests covering the prepared queries.

Reviewed changes

Copilot reviewed 15 out of 16 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
Cargo.toml	Adds the tree-sitter-yaml dependency.
Cargo.lock	Locks tree-sitter-yaml and updates dependency graph.
src/scoping/langs.rs	Exposes the new yaml language module.
src/scoping/langs/yaml.rs	Implements YAML CompiledQuery + prepared query variants and file detection (yaml/yml).
src/main.rs	Adds CLI flags and scope-group wiring for YAML queries.
README.md	Documents the new YAML CLI options and prepared query values.
tests/langs/mod.rs	Adds YAML prepared-query snapshots and a custom-query language-selection test case.
tests/langs/yaml/base.yaml	Adds a YAML fixture used by the snapshot tests.
tests/langs/snapshots/r#mod__langs__base.yaml_string_scalar.snap	Snapshot for --yaml string-scalar.
tests/langs/snapshots/r#mod__langs__base.yaml_integer_scalar.snap	Snapshot for --yaml integer-scalar.
tests/langs/snapshots/r#mod__langs__base.yaml_float_scalar.snap	Snapshot for --yaml float-scalar.
tests/langs/snapshots/r#mod__langs__base.yaml_boolean_scalar.snap	Snapshot for --yaml boolean-scalar.
tests/langs/snapshots/r#mod__langs__base.yaml_block_sequence.snap	Snapshot for --yaml block-sequence.
tests/langs/snapshots/r#mod__langs__base.yaml_block_mapping.snap	Snapshot for --yaml block-mapping.
tests/langs/snapshots/r#mod__langs__base.yaml_flow_sequence.snap	Snapshot for --yaml flow-sequence.
tests/langs/snapshots/r#mod__langs__base.yaml_flow_mapping.snap	Snapshot for --yaml flow-mapping.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.