Containerfile.test получает ARG SUREFIRE_OS_NAME (пусто — прежнее
поведение), pr.yml — job macos-sim: тот же mvn clean verify с
-Dos.name='Mac OS X' (docx4j PhysicalFonts читает os.name и уходит в
MicrosoftFontsRegistry). Регрессия strictOoxml ловится до мержа.
Документация: AGENTS.md, docs/agent/ci-cd.md.
На macOS PhysicalFonts.getBoldForm для имён бандл-шрифтов ('Tinos Regular',
'Carlito Regular', ...) уходит в MicrosoftFontsRegistry, где у этих записей
Mac-имя файла null, и возвращает null; docx4j строит simulate-style fopconf
(все начертания на regular-TTF), FOP теряет реальные Bold/Italic — метрики и
кернинг ломают переносы (strictOoxml: 'таблица' -> 'таблиц а').
BundledFontMapper переопределяет три variant-form метода: семейство опознаётся
по embeddedURI regular-варианта, начертание берётся реальным из бандла; вне
бандла / без init() — родительская логика без изменений.
Тест: BundledFontMapperTest#variantForms_resolveBundleSibling (красный на macOS
без override); регрессии: WordPdfConverterTest#strictOoxml_convertsNotRejected,
#ruPlain_regularRunsUseRegularFont (проверены под -Dos.name='Mac OS X').
docs/agent/pipeline.md: абзац о macOS-ветке.
DrawingFoundException с enum Kind удалён: каждый error-флаг бросает свой
тип-наследник ConversionException с фиксированным сообщением. App-слой
сохраняет один DrawingRejectedException (422) — маппинг по типу в
ConversionService.doConvert, тексты ответа не изменились (контракт с
фронтом). Обновлены тесты и документация.
Хостовые Setup JDK/Maven/кеш~/.m2 и mvn на раннере убраны: полный
mvn clean verify (тесты + PMD + JaCoCo) исполняется только в образе
Containerfile.test (без libfontconfig и /etc/fonts). Отчёты JaCoCo
извлекаются из образа docker create/cp (отсутствие отчёта — пустая
сводка, не падение). mise verify остаётся сырым mvn без docker/podman.
checkDocxContainer получает бюджеты параметром; validate считает их из
ConvertOptions.maxMb()/maxPages(): clamp(maxMb×10MiB + maxPages×64KiB, 16MiB,
MAX_DECOMPRESSED_MB) и clamp(maxMb×4MiB + maxPages×32KiB, 4MiB,
MAX_DECOMPRESSED_XML_MB) (коэффициенты/полы — package-private константы
WordPdfConverter, compile-time инлайн — WordPdfValidator по-прежнему без
зависимости от docx4j). Константы WordPdfSettings — жёсткие крышки (публичный
API, защита JAXB DOM). Сообщения печатают вычисленный бюджет. Тесты: пол
(16 МБ при maxMb=1), масштабирование и крышка (64 МБ при maxMb=10); доки
синхронизированы.
Публичный convert() теперь безопасен из нескольких потоков: секция после
валидации (мост .doc + convertToStream) выполняется под монитором класса —
общая FopFactory (per-render disableFontCache, имиджевые кеши) и её сброс в
finally больше не могут пересечься с параллельным рендером. warmup()
синхронизирован тем же монитором (реентельно). WordPdfValidator остаётся
до монитора: stateless, вызывается параллельно HTTP-потоками.
Регрессия — WordPdfConverterTest#concurrentConversions_twoThreadsBothSucceed.
Комментарии ConversionService/AGENTS/repo-map приведены к новому контракту.
ChartImageHandler: для не-JPEG без кропа с ppi <= threshold (или без
размера в макете) PictureCompression.compress всегда возвращает null,
но сначала декодирует полный растр ImageIO — решение принимается по
26 байтам заголовка (PNG/GIF/BMP), растр не декодируется вовсе; JPEG
остаётся на штатном пути CR-029 (перекодировка «для размера» сохранена).
OleObjectNormalizer: детект <w:object — потоковым поиском окном 8 KiB
с перекрытием, без readAllBytes()+new String на каждую word/*.xml.
Heap: ENTRYPOINT -Xms2g -Xmx2g (вместо -XX:MaxRAMPercentage=70),
mem_limit 2g -> 3g (compose.yml, compose.dev.yml, прод-heredoc
main.yml) — фиксированный heap + запас под metaspace/native.
Отменённая ветка: переиспользование общей FopFactory между прогонами
копит шрифтовые данные форка FOP на каждый render (замер 2026-11:
после 30 конвертаций ~1,4 ГБ живых byte[] против 17 МБ при
per-conversion сборке, рост live-кучи, Full GC) — фабрика остаётся
per-conversion, инвариант зафиксирован комментарием.
GC-замер (java -jar, -Xms2g -Xmx2g, 30 конвертаций фикстур): young
5 против 7 на main, паузы 12,2 мс против 18,7 мс, Full GC нет на обоих.
Тесты: ChartImageHandlerTest +5 (PNG/GIF/BMP/JPEG/выше порога),
OleObjectNormalizerTest +1 (маркер через границу окна).
Мост .doc → .docx (internal/doc) и javadoc-контракты переводятся на
ConversionException; WordPdfValidator.checkPageCountDoc оборачивает отказ
моста в ValidationException с сохранением текста (вердикт «вход
некорректен» выносит только валидатор; глубина, ловимая лишь при
конвертации, становится 500 — как у .docx). Проверки ConvertController
переезжают на новый app-класс BadRequestException (400 с теми же
текстами), ApiExceptionHandler получает хендлер. Тесты моста доказывают
ровно тип (assertSame(ConversionException.class, ...)); новый регрессивный
WordPdfValidatorTest#checkPageCountDoc_brokenBridge_wrappedAsValidation.
Документация (AGENTS.md, docs/agent/doc-bridge.md) синхронизирована.
DrawingPreRenderer.swapForPicture вставляет media-часть вручную
(newPartForContentType → setBinaryData → rels.addPart, имена
/word/media/chart-*): createImagePart писал temp-файл и декодировал
PNG обратно ради mime/размеров, которые нам и так известны.
ChartImageHandler (foSettings.setImageHandler) возвращает null из
compressedVariant для chart-* — «Compress Pictures» не ресемплит и не
декодирует наши 300-dpi растры; медиа документов остаются в штатном
docx4j-режиме. Замер (25 фикстур × 6 прогонов): chart-types.docx
657→507 МБ alloc (тёплый), суммарно 11640→10604 МБ, прочие 23 файла
±0%; ретеншн не изменился (144 MiB после GC), temp-файлов 0.
Регрессии: chartMedia_notDownsampled, DrawingPreRendererTest,
ChartImageHandlerTest.