Reference

The exact surface: commands, configuration, file formats, and contracts.

• CLI — Every chops-search subcommand and flag. Defaults are stated inline; --help says the same things.
• Configuration — Every chops-search.toml key with its default, and how config discovery and path resolution work.
• Artifacts — Every file build emits, its loading discipline, its cache policy, and what changes when.
• Indexing rules — Exactly which pages get indexed, how URLs are reconstructed from Zola's conventions, and the documented gaps.
• queries.toml — The labelled query set format that eval reads: fields, kinds, and how expectations are scored.
• Browser runtime — The overlay and inline modes, the element and attribute contract, the keyboard map, and the CSS theming surface.