Agents and developers sometimes write RST-style double backtick markup ( foo ) in docstrings when single backticks should be used. This project uses Markdown-compatible docstrings, not RST.

New hook: hooks/check-docstring-substrings.py

General-purpose prek hook that parses Python files with ast, extracts only docstring nodes, and checks them for forbidden substrings. Accepts --forbidden args and file paths:

- id: check-docstring-substrings
  entry: uv run --frozen --offline hooks/check-docstring-substrings.py
  args: ["--forbidden", "``"]
  types: [python]

Multiple forbidden substrings supported via repeated --forbidden flags.

Existing violations fixed

Converted all ... → `...` in docstrings across 12 files in src/ and hooks/. One triple-backtick code fence in imports.py converted to an indented code block to avoid false positives.