docs: AGENTS.md — сводный репозиторный гайд по фактам дерева #95

Merged
pjandro merged 2 commits from docs/agents-md-consolidate into main 2026-11-07 23:10:17 +03:00
Collaborator

Пересобран корневой AGENTS.md по результатам параллельного исследования репозитория (core src, tests, build/config, app/web/docs).

Что сделано

  • Сохранены все разделы и критические инварианты предыдущей версии.
  • Уточнены точные счётчики (классы, тесты, фикстуры, шрифты) и добавлены недостающие детали: идиомы загрузки фикстур по модулям (core — classloader без слэша, app — class-relative со слэшем), жизненный цикл тестов, разница mvn test vs mvn clean verify, карта HTTP-контракта, правила PMD/JaCoCo.
  • Раздел Important Files вынесен из docs/agent/repo-map.md в корневой файл — теперь гайд самодостаточен.

Исправлен фактический дрейф в соседних справках (docs/agent/* объявлены авторитетными наравне с AGENTS.md):

  • счётчики тестов: 891 → 893 (core 848 → 849, app 43 → 44; ApiExceptionHandlerTest = 5, не 4);
  • internal/chart: 17 → 18 классов; public ещё и ChartImageHandler (инстанцируется из WordPdfConverter);
  • wordpdf-app: 10 → 11 классов (5 классов исключений);
  • константа STEP: 8 → 9 из 10 rewrite-нормализаторов (есть у HiddenTextNormalizer, нет только у RubyNormalizer);
  • docs/standards: шесть → восемь каталогов; в перечне docs/agent/ добавлен repo-map.

Проверка: mvn clean verify — 893 теста, PMD (includeTests=true) и гейты JaCoCo (LINE 0.90 обоих модулей, BRANCH 0.85 core) зелёные.

Пересобран корневой `AGENTS.md` по результатам параллельного исследования репозитория (core src, tests, build/config, app/web/docs). **Что сделано** - Сохранены все разделы и критические инварианты предыдущей версии. - Уточнены точные счётчики (классы, тесты, фикстуры, шрифты) и добавлены недостающие детали: идиомы загрузки фикстур по модулям (core — classloader без слэша, app — class-relative со слэшем), жизненный цикл тестов, разница `mvn test` vs `mvn clean verify`, карта HTTP-контракта, правила PMD/JaCoCo. - Раздел **Important Files** вынесен из `docs/agent/repo-map.md` в корневой файл — теперь гайд самодостаточен. **Исправлен фактический дрейф** в соседних справках (`docs/agent/*` объявлены авторитетными наравне с `AGENTS.md`): - счётчики тестов: 891 → **893** (core 848 → 849, app 43 → 44; `ApiExceptionHandlerTest` = 5, не 4); - `internal/chart`: 17 → **18** классов; public ещё и `ChartImageHandler` (инстанцируется из `WordPdfConverter`); - `wordpdf-app`: 10 → **11** классов (5 классов исключений); - константа `STEP`: 8 → **9 из 10** rewrite-нормализаторов (есть у `HiddenTextNormalizer`, нет только у `RubyNormalizer`); - `docs/standards`: шесть → **восемь** каталогов; в перечне `docs/agent/` добавлен `repo-map`. **Проверка**: `mvn clean verify` — 893 теста, PMD (`includeTests=true`) и гейты JaCoCo (LINE 0.90 обоих модулей, BRANCH 0.85 core) зелёные.
ai added 1 commit 2026-11-07 06:19:15 +03:00
docs: AGENTS.md — сводный репозиторный гайд по фактам дерева
PR checks / web (pull_request) Successful in 38s
PR checks / java (pull_request) Failing after 1m56s
3dd770c542
Пересобран корневой AGENTS.md по результатам параллельного исследования
(core src, tests, build/config, app/web/docs). Сохранены все разделы и
инварианты, добавлены точные счётчики и недостающие детали, полезные
AI-ассистенту (идиомы загрузки фикстур по модулям, жизненный цикл тестов,
правила PMD/JaCoCo, карта HTTP-контракта).

Исправлен фактический дрейф в соседних справках (docs/agent/* объявлены
авторитетными наравне с AGENTS.md):
- счётчики тестов: 891 → 893 (core 848 → 849, app 43 → 44; ApiExceptionHandlerTest = 5);
- internal/chart: 17 → 18 классов, public ещё и ChartImageHandler;
- wordpdf-app: 10 → 11 классов (5 классов исключений);
- константа STEP: 8 → 9 из 10 rewrite-нормализаторов (есть у HiddenTextNormalizer);
- docs/standards: шесть → восемь каталогов; в перечне docs/agent добавлен repo-map.

Проверено: mvn clean verify — 893 теста, PMD (includeTests) и гейты JaCoCo
(LINE 0.90 обоих модулей, BRANCH 0.85 core) зелёные.

Покрытие (JaCoCo)

Модуль Строки Ветви Порог строк
wordpdf-core 95.0% 85.4% 90%
wordpdf-app 94.0% 86.2% 90%
<!-- jacoco-coverage --> ## Покрытие (JaCoCo) | Модуль | Строки | Ветви | Порог строк | |---|---|---|---| | wordpdf-core | 95.0% | 85.4% | 90% | | wordpdf-app | 94.0% | 86.2% | 90% |
ai added 1 commit 2026-11-07 23:00:12 +03:00
test(app): двухтакное заполнение очереди — фикс гонки submit/take в тесте сатурации
PR checks / web (pull_request) Successful in 31s
PR checks / java (pull_request) Successful in 1m11s
Main: tests, deploy, autotests / web (push) Successful in 31s
Main: tests, deploy, autotests / java (push) Successful in 1m5s
Main: tests, deploy, autotests / images-web (push) Successful in 45s
Main: tests, deploy, autotests / images-app (push) Successful in 48s
Main: tests, deploy, autotests / deploy (push) Successful in 2m26s
Main: tests, deploy, autotests / autotests (push) Successful in 39s
Main: tests, deploy, autotests / rollback (push) Has been skipped
2dce945614
pjandro merged commit 2dce945614 into main 2026-11-07 23:10:17 +03:00
pjandro deleted branch docs/agents-md-consolidate 2026-11-07 23:10:17 +03:00
Sign in to join this conversation.
No Reviewers
No Label
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: pjandro/java-word-pdf#95