Add yaml-language-server: comment to YAML sample config

[Repiteo]

Summary

Many IDEs feature automatic schema recognition of common YAML files, including .pre-commit-config.yaml. However, the schema loaded by default for these files is for base pre-commit, which this project has already diverged from. We already manually assign the schema used for TOML, but no equivalent exists for YAML. While no official schema specification syntax exists, the most commonly recognized one by far is # yaml-language-server: $schema=....

This PR adds the above comment to the sample config for YAML files, making prek's schema IDE-aware regardless of which format is selected.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 93.60%. Comparing base (1126236) to head (3743937).

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #2486   +/-   ##
=======================================
  Coverage   93.60%   93.60%           
=======================================
  Files         131      131           
  Lines       28215    28215           
=======================================
+ Hits        26410    26411    +1     
+ Misses       1805     1804    -1     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[prek-ci-bot]

📦 Cargo Bloat Comparison

Binary size change: +0.00% (29.6 MiB → 29.6 MiB)

Expand for cargo-bloat output

Head Branch Results

 File  .text     Size             Crate Name
 1.1%   2.3% 332.0KiB        aws_lc_sys aws_lc_0_43_0_aes_gcm_encrypt_avx512
 1.1%   2.3% 332.0KiB        aws_lc_sys aws_lc_0_43_0_aes_gcm_decrypt_avx512
 0.2%   0.5%  70.9KiB              prek <prek::cli::Command as clap_builder::derive::Subcommand>::augment_subcommands
 0.2%   0.4%  58.0KiB              prek <<prek::config::Config as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
 0.2%   0.4%  56.6KiB              prek prek::run::{closure#0}
 0.2%   0.3%  49.4KiB annotate_snippets annotate_snippets::renderer::render::render
 0.1%   0.3%  38.4KiB              prek prek::cli::run::run::run::{closure#0}
 0.1%   0.2%  34.3KiB              prek <prek::cli::RunOptions as clap_builder::derive::Args>::augment_args
 0.1%   0.2%  33.5KiB              prek <prek::languages::ruby::installer::RubyInstaller>::install::{closure#0}
 0.1%   0.2%  30.1KiB     granit_parser <granit_parser::scanner::Scanner<granit_parser::input::str::StrInput>>::fetch_more_tokens
 0.1%   0.2%  29.4KiB              prek <<prek::config::RemoteHook as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
 0.1%   0.2%  28.9KiB    cargo_metadata <&mut serde_json::de::Deserializer<serde_json::read::StrRead> as serde_core::de::Deserializer>::deserialize_struct::<<cargo_metadata::Package as serde_core::de::Deserialize>::deserialize::__Visitor>
 0.1%   0.2%  28.7KiB              prek <prek::languages::node::installer::NodeInstaller>::install::{closure#0}
 0.1%   0.2%  28.0KiB        aws_lc_sys aws_lc_0_43_0_edwards25519_scalarmuldouble_alt
 0.1%   0.2%  27.5KiB        aws_lc_sys aws_lc_0_43_0_edwards25519_scalarmuldouble
 0.1%   0.2%  26.9KiB              prek <prek::languages::deno::installer::DenoInstaller>::download::{closure#0}
 0.1%   0.2%  25.7KiB              prek prek::cli::try_repo::try_repo::{closure#0}
 0.1%   0.2%  25.6KiB              prek <<prek::config::LocalHook as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
 0.1%   0.2%  25.2KiB              prek <<prek::config::UpdateOptions as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
 0.1%   0.2%  24.9KiB               xml <xml::reader::parser::PullParser>::dispatch_token
42.3%  88.2%  12.5MiB                   And 26309 smaller methods. Use -n N to show more.
47.9% 100.0%  14.2MiB                   .text section size, the file size is 29.6MiB

Base Branch Results

 File  .text     Size             Crate Name
 1.1%   2.3% 332.0KiB        aws_lc_sys aws_lc_0_43_0_aes_gcm_encrypt_avx512
 1.1%   2.3% 332.0KiB        aws_lc_sys aws_lc_0_43_0_aes_gcm_decrypt_avx512
 0.2%   0.5%  70.9KiB              prek <prek::cli::Command as clap_builder::derive::Subcommand>::augment_subcommands
 0.2%   0.4%  58.0KiB              prek <<prek::config::Config as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
 0.2%   0.4%  56.6KiB              prek prek::run::{closure#0}
 0.2%   0.3%  49.4KiB annotate_snippets annotate_snippets::renderer::render::render
 0.1%   0.3%  38.4KiB              prek prek::cli::run::run::run::{closure#0}
 0.1%   0.2%  34.3KiB              prek <prek::cli::RunOptions as clap_builder::derive::Args>::augment_args
 0.1%   0.2%  33.5KiB              prek <prek::languages::ruby::installer::RubyInstaller>::install::{closure#0}
 0.1%   0.2%  30.1KiB     granit_parser <granit_parser::scanner::Scanner<granit_parser::input::str::StrInput>>::fetch_more_tokens
 0.1%   0.2%  29.4KiB              prek <<prek::config::RemoteHook as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
 0.1%   0.2%  28.9KiB    cargo_metadata <&mut serde_json::de::Deserializer<serde_json::read::StrRead> as serde_core::de::Deserializer>::deserialize_struct::<<cargo_metadata::Package as serde_core::de::Deserialize>::deserialize::__Visitor>
 0.1%   0.2%  28.7KiB              prek <prek::languages::node::installer::NodeInstaller>::install::{closure#0}
 0.1%   0.2%  28.0KiB        aws_lc_sys aws_lc_0_43_0_edwards25519_scalarmuldouble_alt
 0.1%   0.2%  27.5KiB        aws_lc_sys aws_lc_0_43_0_edwards25519_scalarmuldouble
 0.1%   0.2%  26.9KiB              prek <prek::languages::deno::installer::DenoInstaller>::download::{closure#0}
 0.1%   0.2%  25.7KiB              prek prek::cli::try_repo::try_repo::{closure#0}
 0.1%   0.2%  25.6KiB              prek <<prek::config::LocalHook as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
 0.1%   0.2%  25.2KiB              prek <<prek::config::UpdateOptions as serde_core::de::Deserialize>::deserialize::__Visitor as serde_core::de::Visitor>::visit_map::<<serde_saphyr::de::deserializer::YamlDeserializer as serde_core::de::Deserializer>::deserialize_map::MA>
 0.1%   0.2%  24.9KiB               xml <xml::reader::parser::PullParser>::dispatch_token
42.3%  88.2%  12.5MiB                   And 26309 smaller methods. Use -n N to show more.
47.9% 100.0%  14.2MiB                   .text section size, the file size is 29.6MiB

[prek-ci-bot]

⚡️ Hyperfine Benchmarks

Summary: 0 regressions, 0 improvements above the 10% threshold.

Environment

• OS: Linux 6.17.0-1020-azure
• CPU: 4 cores
• prek version: prek 0.4.12+6 (ab437fd 2026-08-05)
• Rust version: rustc 1.97.1 (8bab26f4f 2026-07-14)
• Hyperfine version: hyperfine 1.20.0

CLI Commands

Benchmarking basic commands in the main repo:

prek --version

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base --version	2.4 ± 0.1	2.3	2.9	1.00
prek-head --version	2.5 ± 0.1	2.3	2.7	1.01 ± 0.05

prek list

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base list	10.3 ± 0.3	9.7	11.1	1.01 ± 0.04
prek-head list	10.2 ± 0.3	9.6	11.0	1.00

prek validate-config .pre-commit-config.yaml

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base validate-config .pre-commit-config.yaml	3.5 ± 0.1	3.4	3.7	1.02 ± 0.03
prek-head validate-config .pre-commit-config.yaml	3.5 ± 0.1	3.3	3.6	1.00

prek sample-config

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base sample-config	2.7 ± 0.1	2.6	2.9	1.00
prek-head sample-config	2.7 ± 0.1	2.6	2.9	1.00 ± 0.03

Cold vs Warm Runs

Comparing first run (cold) vs subsequent runs (warm cache):

prek run --all-files (cold - no cache)

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run --all-files	39.3 ± 1.2	36.9	40.7	1.00
prek-head run --all-files	39.7 ± 1.5	37.2	42.0	1.01 ± 0.05

prek run --all-files (warm - with cache)

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run --all-files	39.4 ± 1.2	37.3	41.4	1.00
prek-head run --all-files	39.7 ± 1.2	37.6	41.1	1.01 ± 0.04

Full Hook Suite

Running the builtin hook suite on the benchmark workspace:

prek run --all-files (full builtin hook suite)

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run --all-files	39.5 ± 1.3	36.7	42.5	1.01 ± 0.04
prek-head run --all-files	39.0 ± 1.0	36.0	41.2	1.00

Individual Hook Performance

Benchmarking each hook individually on the test repo:

prek run trailing-whitespace --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run trailing-whitespace --all-files	13.6 ± 0.4	13.0	14.5	1.00
prek-head run trailing-whitespace --all-files	13.8 ± 0.5	13.2	15.0	1.02 ± 0.05

prek run end-of-file-fixer --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run end-of-file-fixer --all-files	12.0 ± 0.4	11.4	13.1	1.00
prek-head run end-of-file-fixer --all-files	12.1 ± 0.5	11.2	13.7	1.00 ± 0.05

prek run check-json --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run check-json --all-files	8.8 ± 0.3	8.2	9.3	1.02 ± 0.05
prek-head run check-json --all-files	8.6 ± 0.3	8.1	9.1	1.00

prek run check-yaml --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run check-yaml --all-files	8.2 ± 0.1	8.0	8.4	1.00
prek-head run check-yaml --all-files	8.3 ± 0.2	8.1	8.8	1.01 ± 0.03

prek run check-toml --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run check-toml --all-files	8.4 ± 0.3	8.0	9.3	1.00
prek-head run check-toml --all-files	8.5 ± 0.3	8.2	9.2	1.01 ± 0.05

prek run check-xml --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run check-xml --all-files	8.7 ± 0.3	8.2	9.6	1.01 ± 0.06
prek-head run check-xml --all-files	8.6 ± 0.4	7.9	9.4	1.00

prek run detect-private-key --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run detect-private-key --all-files	11.9 ± 0.4	11.2	12.8	1.00
prek-head run detect-private-key --all-files	12.1 ± 0.8	11.3	14.5	1.01 ± 0.07

prek run fix-byte-order-marker --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run fix-byte-order-marker --all-files	13.5 ± 0.8	12.3	15.6	1.00
prek-head run fix-byte-order-marker --all-files	13.6 ± 1.0	12.3	16.3	1.01 ± 0.09

Installation Performance

Benchmarking hook installation (fast path hooks skip Python setup):

prek install-hooks (cold - no cache)

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base install-hooks	5.0 ± 0.1	4.9	5.2	1.00
prek-head install-hooks	5.1 ± 0.1	5.0	5.1	1.01 ± 0.03

prek install-hooks (warm - with cache)

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base install-hooks	5.0 ± 0.1	4.9	5.1	1.00
prek-head install-hooks	5.0 ± 0.0	5.0	5.1	1.00 ± 0.02

File Filtering/Scoping Performance

Testing different file selection modes:

prek run (staged files only)

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run	26.2 ± 0.5	25.6	27.0	1.00
prek-head run	26.2 ± 0.3	25.6	27.2	1.00 ± 0.02

prek run --files '*.json' (specific file type)

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run --files '*.json'	5.7 ± 0.1	5.6	5.8	1.00
prek-head run --files '*.json'	5.7 ± 0.1	5.6	5.8	1.00 ± 0.02

Workspace Discovery & Initialization

Benchmarking hook discovery and initialization overhead:

prek run --dry-run --all-files (measures init overhead)

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run --dry-run --all-files	7.8 ± 0.3	7.5	8.6	1.00 ± 0.04
prek-head run --dry-run --all-files	7.8 ± 0.1	7.6	8.0	1.00

Meta Hooks Performance

Benchmarking meta hooks separately:

prek run check-hooks-apply --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run check-hooks-apply --all-files	9.2 ± 0.1	9.0	9.3	1.00 ± 0.02
prek-head run check-hooks-apply --all-files	9.2 ± 0.1	9.0	9.4	1.00

prek run check-useless-excludes --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run check-useless-excludes --all-files	9.2 ± 0.1	9.0	9.5	1.00
prek-head run check-useless-excludes --all-files	9.3 ± 0.3	9.0	9.9	1.02 ± 0.03

prek run identity --all-files

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
prek-base run identity --all-files	8.2 ± 0.1	8.1	8.4	1.01 ± 0.02
prek-head run identity --all-files	8.1 ± 0.1	7.9	8.5	1.00

[j178]

Thanks!