normik 0.1.0__tar.gz

normik-0.1.0/.gitignore

@@ -0,0 +1,50 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual environments
+.venv/
+.env
+.env.staging
+.env.prod
+
+# IDE
+.vscode/
+.idea/
+
+# Python tooling
+.poetry/
+.mypy_cache/
+.pytype/
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Собранный сайт документации
+site/
+
+# Build
+build/
+dist/
+*.egg-info/
+
+# OS
+.DS_Store
+
+# Docker
+*.log
+
+# Local overrides
+*.local.*
+local/
+
+# Claude
+.claude/worktrees/
+.claude/agent-memory/
+
+# Ruff
+.ruff_cache/
+
+# Кэш сборки документации
+.cache/

normik-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arkadii Artamonov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

normik-0.1.0/Makefile

@@ -0,0 +1,25 @@
+.PHONY: lint format test check docs docs-serve
+
+package ?= src tests
+
+lint:
+	uv run ruff check $(package)
+	uv run ruff format --check $(package)
+	uv run ty check $(package)
+
+format:
+	uv run ruff check --fix $(package)
+	uv run ruff format $(package)
+
+test:
+	uv run pytest
+
+check: lint test
+
+docs:
+	uv run nk rules docs
+	uv run --group docs properdocs build --strict
+
+docs-serve:
+	uv run nk rules docs
+	uv run --group docs properdocs serve

normik-0.1.0/PKG-INFO

@@ -0,0 +1,140 @@
+Metadata-Version: 2.5
+Name: normik
+Version: 0.1.0
+Summary: Проверка работ на соответствие ГОСТ
+Project-URL: Homepage, https://trum-ok.github.io/normik/
+Project-URL: Documentation, https://trum-ok.github.io/normik/
+Project-URL: Repository, https://github.com/Trum-ok/normik
+Project-URL: Issues, https://github.com/Trum-ok/normik/issues
+Author-email: Arkadii Artamonov <artamarkan@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: gost,latex,linter,гост,нир
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: Natural Language :: Russian
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Text Processing :: Markup :: LaTeX
+Classifier: Typing :: Typed
+Requires-Python: >=3.13.4
+Requires-Dist: rich>=14.0.0
+Requires-Dist: typer>=0.20.0
+Description-Content-Type: text/markdown
+
+# normik
+
+[![ci](https://github.com/Trum-ok/normik/actions/workflows/ci.yaml/badge.svg)](https://github.com/Trum-ok/normik/actions/workflows/ci.yaml)
+
+`nk` — линтер оформления отчёта о НИР по ГОСТ 7.32-2017 для исходников LaTeX.
+
+**Документация: <https://trum-ok.github.io/normik/>**
+
+Принимает `.tex` и выдаёт список нарушений с указанием пункта стандарта, файла
+и строки.
+
+```bash
+uv run nk check report.tex
+```
+
+```text
+report.tex
+  1:17  warning  G732-6.5.1-reference-word
+    Нарушение: В ссылке на иллюстрацию использовано сокращение «рис.».
+    Требуется: При ссылке пишут слово «рисунок» полностью и его номер.
+    Исправить: Заменить «рис.» на «рисунок» в нужном падеже.
+    > 1 | Как показано на рис.~\ref{fig:speed}, зависимость линейная.
+      2 | 
+      3 | \begin{figure}[h]
+
+  5:5  error  G732-6.5.7-caption-dot
+    Нарушение: Наименование рисунка заканчивается точкой.
+    Требуется: Наименование рисунка приводят с прописной буквы без точки в конце.
+    Исправить: \caption{Зависимость скорости от нагрузки}
+      3 | \begin{figure}[h]
+      4 |     \includegraphics{plot.png}
+    > 5 |     \caption{Зависимость скорости от нагрузки.}
+      6 |     \label{fig:speed}
+      7 | \end{figure}
+
+Итого: 1 error, 1 warning, 0 info.
+Машинный вывод: --format json, вывод для агента: --format agent
+```
+
+## Установка
+
+```bash
+uv sync
+```
+
+## Примеры запуска
+
+Проверить весь каталог с исходниками:
+
+```bash
+uv run nk check chapters
+```
+
+Получить вывод, который можно скопировать в Claude Code без пояснений:
+
+```bash
+uv run nk check chapters --format agent
+```
+
+Проверить по профилю кафедры, показывая только ошибки:
+
+```bash
+uv run nk check report.tex --profile profiles/example-university.toml --severity error
+```
+
+Починить то, что чинится механически — сначала посмотреть, потом применить:
+
+```bash
+uv run nk check chapters --diff
+uv run nk check chapters --fix
+```
+
+Включить линтер на готовой работе: зафиксировать текущие нарушения снимком
+и дальше видеть только новые:
+
+```bash
+uv run nk check chapters --write-baseline .nk-baseline.json
+uv run nk check chapters --baseline .nk-baseline.json
+```
+
+## Команды
+
+| Команда | Назначение |
+|---|---|
+| `nk check PATH...` | проверить исходники |
+| `nk rules list` | перечень правил |
+| `nk rules show RULE_ID` | подробности по правилу |
+| `nk rules docs` | пересобрать страницы правил в `docs/rules/` |
+| `nk profile show` | итоговый набор правил после применения профиля |
+
+Ключи `check`, коды возврата и форматы вывода — на странице
+[Использование](https://trum-ok.github.io/normik/usage/).
+
+## Документация
+
+| Страница | О чём |
+|---|---|
+| [Использование](https://trum-ok.github.io/normik/usage/) | команды, ключи, форматы вывода, автоисправление, подавления, снимок |
+| [Профили](https://trum-ok.github.io/normik/profiles/) | подстройка набора правил под кафедру |
+| [Правила](https://trum-ok.github.io/normik/rules/) | страница на каждое правило: почему, пример, настройка |
+| [Интеграции](https://trum-ok.github.io/normik/integrations/) | CI, хук, передача вывода агенту |
+| [Как добавить правило](https://trum-ok.github.io/normik/contributing/) | руководство для соавторов |
+
+Исходники документации — в каталоге
+[`docs/`](https://github.com/Trum-ok/normik/tree/master/docs); каталог
+[`docs/rules/`](https://github.com/Trum-ok/normik/tree/master/docs/rules)
+генерируется командой `uv run nk rules docs` и руками не редактируется.
+
+## Разработка
+
+```bash
+make check      # ruff, ty, pytest
+make docs       # перегенерировать правила и собрать сайт
+make docs-serve # локальный просмотр на http://127.0.0.1:8000
+```

normik-0.1.0/README.md

@@ -0,0 +1,115 @@
+# normik
+
+[![ci](https://github.com/Trum-ok/normik/actions/workflows/ci.yaml/badge.svg)](https://github.com/Trum-ok/normik/actions/workflows/ci.yaml)
+
+`nk` — линтер оформления отчёта о НИР по ГОСТ 7.32-2017 для исходников LaTeX.
+
+**Документация: <https://trum-ok.github.io/normik/>**
+
+Принимает `.tex` и выдаёт список нарушений с указанием пункта стандарта, файла
+и строки.
+
+```bash
+uv run nk check report.tex
+```
+
+```text
+report.tex
+  1:17  warning  G732-6.5.1-reference-word
+    Нарушение: В ссылке на иллюстрацию использовано сокращение «рис.».
+    Требуется: При ссылке пишут слово «рисунок» полностью и его номер.
+    Исправить: Заменить «рис.» на «рисунок» в нужном падеже.
+    > 1 | Как показано на рис.~\ref{fig:speed}, зависимость линейная.
+      2 | 
+      3 | \begin{figure}[h]
+
+  5:5  error  G732-6.5.7-caption-dot
+    Нарушение: Наименование рисунка заканчивается точкой.
+    Требуется: Наименование рисунка приводят с прописной буквы без точки в конце.
+    Исправить: \caption{Зависимость скорости от нагрузки}
+      3 | \begin{figure}[h]
+      4 |     \includegraphics{plot.png}
+    > 5 |     \caption{Зависимость скорости от нагрузки.}
+      6 |     \label{fig:speed}
+      7 | \end{figure}
+
+Итого: 1 error, 1 warning, 0 info.
+Машинный вывод: --format json, вывод для агента: --format agent
+```
+
+## Установка
+
+```bash
+uv sync
+```
+
+## Примеры запуска
+
+Проверить весь каталог с исходниками:
+
+```bash
+uv run nk check chapters
+```
+
+Получить вывод, который можно скопировать в Claude Code без пояснений:
+
+```bash
+uv run nk check chapters --format agent
+```
+
+Проверить по профилю кафедры, показывая только ошибки:
+
+```bash
+uv run nk check report.tex --profile profiles/example-university.toml --severity error
+```
+
+Починить то, что чинится механически — сначала посмотреть, потом применить:
+
+```bash
+uv run nk check chapters --diff
+uv run nk check chapters --fix
+```
+
+Включить линтер на готовой работе: зафиксировать текущие нарушения снимком
+и дальше видеть только новые:
+
+```bash
+uv run nk check chapters --write-baseline .nk-baseline.json
+uv run nk check chapters --baseline .nk-baseline.json
+```
+
+## Команды
+
+| Команда | Назначение |
+|---|---|
+| `nk check PATH...` | проверить исходники |
+| `nk rules list` | перечень правил |
+| `nk rules show RULE_ID` | подробности по правилу |
+| `nk rules docs` | пересобрать страницы правил в `docs/rules/` |
+| `nk profile show` | итоговый набор правил после применения профиля |
+
+Ключи `check`, коды возврата и форматы вывода — на странице
+[Использование](https://trum-ok.github.io/normik/usage/).
+
+## Документация
+
+| Страница | О чём |
+|---|---|
+| [Использование](https://trum-ok.github.io/normik/usage/) | команды, ключи, форматы вывода, автоисправление, подавления, снимок |
+| [Профили](https://trum-ok.github.io/normik/profiles/) | подстройка набора правил под кафедру |
+| [Правила](https://trum-ok.github.io/normik/rules/) | страница на каждое правило: почему, пример, настройка |
+| [Интеграции](https://trum-ok.github.io/normik/integrations/) | CI, хук, передача вывода агенту |
+| [Как добавить правило](https://trum-ok.github.io/normik/contributing/) | руководство для соавторов |
+
+Исходники документации — в каталоге
+[`docs/`](https://github.com/Trum-ok/normik/tree/master/docs); каталог
+[`docs/rules/`](https://github.com/Trum-ok/normik/tree/master/docs/rules)
+генерируется командой `uv run nk rules docs` и руками не редактируется.
+
+## Разработка
+
+```bash
+make check      # ruff, ty, pytest
+make docs       # перегенерировать правила и собрать сайт
+make docs-serve # локальный просмотр на http://127.0.0.1:8000
+```

normik-0.1.0/docs/contributing.md

@@ -0,0 +1,328 @@
+# Как добавить правило
+
+Добавление правила — это один новый файл в `src/nk/rules/` и один каталог
+в `tests/fixtures/`. Ничего больше править не нужно: реестр находит правило
+по декоратору, тесты — по имени каталога.
+
+## Рецепт
+
+1. Найти пункт ГОСТ 7.32-2017, который проверяете, и выписать его номер.
+2. Придумать идентификатор: `G732-<пункт>-<мнемоника>`, например
+   `G732-6.5.7-caption-dot`. Мнемоника нужна потому, что на один пункт
+   приходится несколько независимых проверок.
+3. Создать файл в подпапке по разделу стандарта:
+   - `rules/structure/` — разделы 4 и 5: состав и требования к структурным элементам;
+   - `rules/layout/` — подразделы 6.2 и 6.4: построение отчёта и нумерация рубрик;
+   - `rules/elements/` — подразделы 6.5–6.9, 6.12, 6.16, 6.17: иллюстрации,
+     таблицы, формулы, ссылки, реферат, источники, приложения.
+4. Создать `tests/fixtures/<id>/bad.tex` и `tests/fixtures/<id>/good.tex`.
+5. Написать докстринг правила — из него собирается страница документации.
+6. Прогнать `make check` и `uv run nk rules docs`.
+
+## Полный пример
+
+`src/nk/rules/elements/figure_caption_dot.py`:
+
+```python
+"""Точка в конце наименования рисунка."""
+
+from collections.abc import Iterable
+
+from nk.core.document import Document
+from nk.core.finding import Finding, Severity
+from nk.core.rule import rule
+from nk.rules._shared import FIGURE_ENVIRONMENTS, caption_text, captions, one_line
+
+
+@rule(
+    id="G732-6.5.7-caption-dot",
+    clause="6.5.7",
+    severity=Severity.ERROR,
+    title="Наименование рисунка заканчивается точкой",
+)
+def figure_caption_dot(doc: Document) -> Iterable[Finding]:
+    r"""Проверяет наименование рисунка на точку в конце. Точка внутри
+    наименования нарушением не является.
+
+    ## Почему это нарушение
+
+    Наименование рисунка приводят с прописной буквы без точки в конце.
+
+    ## Как исправить
+
+    Убрать точку в конце `\caption`.
+    """
+    for environment in doc.structure.find_environments(*FIGURE_ENVIRONMENTS):
+        for command in captions(environment):
+            text = caption_text(command)
+            if not text.endswith("."):
+                continue
+            yield figure_caption_dot.finding(
+                doc,
+                command.span,
+                message="Наименование рисунка заканчивается точкой.",
+                requirement="Наименование рисунка приводят с прописной буквы без точки в конце.",
+                suggestion=f"\\{command.name}{{{one_line(text[:-1])}}}",
+                col=command.col,
+            )
+```
+
+Разбор по частям:
+
+- **Декоратор** объявляет метаданные один раз. `id`, `clause`, `severity` и `title`
+  больше нигде повторять не нужно.
+- **Докстринг** — источник страницы правила в документации, см.
+  [ниже](#описание-правила).
+- **Сигнатура** фиксирована протоколом `Rule` и проверяется `ty`: правило принимает
+  `Document` и возвращает `Iterable[Finding]`.
+- **Правило — чистая функция.** Никакого ввода-вывода, никакого состояния между
+  вызовами, никакого чтения файлов помимо того, что уже в `Document`.
+- **`figure_caption_dot.finding(...)`** — обращение правила к самому себе по имени.
+  Оно разрешается в момент вызова, когда декоратор уже отработал. Метод сам
+  проставляет `rule_id`, `clause`, `severity` с учётом профиля, `excerpt` и `context`.
+- **Позиция.** Первым позиционным аргументом идёт `Line` или `Span`; `col`
+  указывается отдельно, если известна колонка.
+
+## Что видит правило
+
+`Document` хранит два представления одного исходника.
+
+**Построчное** — для проверок, где важен текст строки:
+
+```python
+for line in doc.iter_lines():
+    line.raw       # исходная строка
+    line.stripped  # без комментария (% с учётом экранированного \%)
+    line.lineno    # номер строки, с единицы
+    line.path      # файл, а не файл-агрегатор
+```
+
+**Структурное** — для проверок, где важна вложенность:
+
+```python
+doc.structure.find_environments("figure", "table")  # окружения по именам
+doc.structure.find_commands("caption", "label")     # команды по именам
+doc.structure.enclosing(path, lineno)               # самое внутреннее окружение
+environment.children                                # вложенные окружения
+environment.commands                                # команды непосредственно внутри
+environment.all_commands()                          # включая вложенные окружения
+```
+
+Готовые помощники — в `src/nk/rules/_shared.py`: наборы имён окружений, извлечение
+текста подписи, метки и ссылки, наименования структурных элементов. Прежде чем
+писать свой разбор, посмотрите, нет ли там нужного.
+
+## Описание правила
+
+Докстринг функции правила — источник его страницы в документации. Он пишется
+на Markdown и попадает на страницу как есть, поэтому заголовки в нём — второго
+уровня.
+
+```python
+def figure_caption_dot(doc: Document) -> Iterable[Finding]:
+    """Проверяет наименование рисунка на точку в конце. Точка внутри
+    наименования нарушением не является.
+
+    ## Почему это нарушение
+
+    Наименование рисунка приводят с прописной буквы без точки в конце: оно
+    образует с номером единую подпись, а не предложение.
+
+    ## Как исправить
+
+    Убрать точку в конце `\caption`.
+    """
+```
+
+- **Первый абзац** — что правило ищет и чего не трогает. Сюда же выносятся
+  известные ограничения: случаи, в которых по исходникам решить нельзя.
+- **«Почему это нарушение»** — смысл требования своими словами. Не «так
+  написано в стандарте», а что ломается, если сделать иначе.
+- **«Как исправить»** — что сделать в исходнике.
+
+Если в докстринге есть обратная косая — а она есть, как только появляется
+пример LaTeX, — объявляйте его сырым: `r"""`.
+
+Пример нарушения и правильного оформления на страницу подставляются из фикстур
+правила, писать их отдельно не нужно. Показывается файл целиком; если он
+длинный, покажите его часть, обрамив её метками:
+
+```latex
+% DOC-BEGIN
+\begin{figure}
+  \includegraphics{img/setup.png}
+  \caption{Схема экспериментальной установки}
+\end{figure}
+% DOC-END
+```
+
+## Правка для `--fix`
+
+Если исправление однозначно, правило может объявить машинную правку — тогда
+`nk check --fix` применит её сам. Частый случай: `suggestion` и есть готовая
+замена, тогда достаточно указать заменяемый регион:
+
+```python
+yield figure_caption_dot.finding(
+    doc,
+    command.span,
+    message="Наименование рисунка заканчивается точкой.",
+    requirement="Наименование рисунка приводят с прописной буквы без точки в конце.",
+    suggestion=f"\\{command.name}{{{one_line(text[:-1])}}}",
+    col=command.col,
+    fix=command.region,          # заменить команду целиком текстом suggestion
+)
+```
+
+`command.region` — точные границы команды вместе с аргументами, включая
+многострочные. Правило с правками объявляется с `fixable=True`; тест сверяет
+объявление с действительностью, поэтому соврать не получится.
+
+Когда заменяемый текст отличается от подсказки — например подсказка говорит
+«убрать двоеточие», а заменить нужно один символ на пустую строку, — передаётся
+готовый `Fix`:
+
+```python
+fix=Fix(Region.in_line(line.path, line.lineno, colon, colon + 1), "")
+```
+
+Точный кусок исходника под регионом даёт `doc.slice(region)` — им удобно строить
+замену «то же самое, но без чего-то»:
+
+```python
+fix=Fix(command.region, doc.slice(command.region).replace("\\-", ""))
+```
+
+**Правку объявляют, только когда замена однозначна.** «Перенести подпись ниже
+рисунка», «добавить ссылку в текст», «заменить «рис.» на «рисунок»» правками не
+являются: в первых двух нужно решение о структуре, в третьем — согласование
+падежа. Такие правила ограничиваются `suggestion`.
+
+Тест на фикстурах проверяет правки сам: применяет их к `bad.tex` в несколько
+проходов и требует, чтобы находки с правками исчезли и новых не появилось.
+
+## Требования к тексту находки
+
+Это самая частая точка деградации, поэтому требование проверяется на ревью.
+Находка должна быть самодостаточна: по ней нарушение исправляется руками или
+передачей вывода `--format agent` в Claude Code, без дополнительных пояснений.
+Читающий не обязан открывать ГОСТ или `docs/RULES.md`.
+
+- **`message`** — что не так, одной фразой, про конкретное место.
+  Плохо: `Нарушение п. 6.5.7`. Хорошо: `Наименование рисунка заканчивается точкой.`
+- **`requirement`** — что требуется, **своими словами**. Цитировать стандарт нельзя:
+  ГОСТ 7.32-2017 не является общественным достоянием, и его текста в репозитории нет.
+  Плохо: `См. п. 6.5.7`. Хорошо: `Наименование рисунка приводят с прописной буквы
+  без точки в конце.`
+- **`suggestion`** — конкретное действие или готовый фрагмент на замену.
+  Плохо: `Исправьте оформление`. Хорошо: `\caption{Схема экспериментальной установки}`.
+
+`suggestion` обязателен. Если исправление принципиально неоднозначно, объявите
+правило с `allow_missing_suggestion=True` — тест это проверяет.
+
+## Фикстуры
+
+`bad.tex` — файл с нарушениями. Каждая строка, где правило обязано сработать,
+помечается комментарием `% EXPECT`:
+
+```latex
+\begin{figure}
+  \includegraphics{img/setup.png}
+  \caption{Схема экспериментальной установки.} % EXPECT
+\end{figure}
+```
+
+Сопоставление строгое в обе стороны: множество строк с находками должно совпадать
+с множеством помеченных строк. Лишняя находка и пропущенная пометка одинаково
+роняют тест.
+
+Если конструкция занимает несколько строк, пометка ставится на ту строку, куда
+указывает находка, — то есть на начало команды:
+
+```latex
+\caption{Зависимость погрешности от числа % EXPECT
+  измерений.}
+```
+
+Комментарий вырезается парсером и на разбор не влияет.
+
+`good.tex` — файл, на котором правило не должно сработать ни разу. Это не формальность:
+именно сюда складываются пограничные случаи, на которых легко получить ложное
+срабатывание. Хороший `good.tex` содержит конструкции, похожие на нарушение, но
+нарушением не являющиеся — точку внутри наименования, подпись таблицы там, где
+правило проверяет рисунки, многозначное число в начале заголовка.
+
+Оба файла обязаны разбираться парсером без замечаний.
+
+## Параметры
+
+Если у правила есть порог, который кафедра захочет изменить, объявите его
+параметром со значением по умолчанию:
+
+```python
+@rule(
+    id="G732-5.3.2.1-keywords-count",
+    clause="5.3.2.1",
+    severity=Severity.ERROR,
+    title="Число ключевых слов вне допустимого диапазона",
+    params={"keywords_min": 5, "keywords_max": 15},
+)
+def keywords_count(doc: Document) -> Iterable[Finding]:
+    params = keywords_count.params(doc)
+    lower = int(params["keywords_min"])
+```
+
+Профиль переопределяет параметр так:
+
+```toml
+[rules."G732-5.3.2.1-keywords-count".params]
+keywords_max = 20
+```
+
+## Проверки
+
+```bash
+make check
+```
+
+Прогоняет `ruff check`, `ruff format --check`, `ty check` и `pytest`. Всё должно
+проходить полностью. Отдельно:
+
+```bash
+make lint
+make test
+make format
+```
+
+## Что проверяет тест автоматически
+
+- правило сработало на `bad.tex` ровно на помеченных строках;
+- правило не сработало на `good.tex` ни разу;
+- у каждой находки непустые `message`, `requirement` и `context`;
+- `clause` находки совпадает с объявленным в декораторе;
+- `suggestion` есть, если правило не объявлено с `allow_missing_suggestion=True`;
+- у каждого правила есть каталог фикстур, у каждого каталога — правило.
+
+Последние два пункта не дают репозиторию расползтись, поэтому обойти их нельзя.
+
+## После добавления правила
+
+Перегенерируйте страницы документации:
+
+```bash
+uv run nk rules docs
+```
+
+Каталог `docs/rules/` руками не редактируется: он собирается из реестра, а тест
+проверяет, что записанное на диске совпадает со сгенерированным.
+
+## Чего в правилах не делаем
+
+- Не вызываем LLM: инструмент детерминирован.
+- Не читаем PDF: источник данных — только исходники `.tex`. Проверки, требующие
+  скомпилированного документа (поля, гарнитуры, кегль, колонцифры), в область
+  видимости не входят.
+- Не цитируем ГОСТ 7.32-2017 ни в коде, ни в тестах, ни в документации.
+  Допустимы только номера пунктов и собственные краткие формулировки.
+- Не правим файлы отчёта наугад. Правка объявляется только там, где замена
+  однозначна; во всех остальных случаях правило ограничивается `suggestion`.