diff --git a/evidence/review-trns-depth-2026-11-06/RESULTS.md b/evidence/review-trns-depth-2026-11-06/RESULTS.md new file mode 100644 index 00000000..7f55aaef --- /dev/null +++ b/evidence/review-trns-depth-2026-11-06/RESULTS.md @@ -0,0 +1,102 @@ +# Исправление PNG tRNS после второго ревью ЛР5 + +Исходный snapshot: `6e97bdbe9638c5a53951337fce639a1a0db7f92e`. +Исправлен единственный назначенный major: прозрачность grayscale 2/4 бита и RGB16. +Этап выполнен в основном репозитории с существующим Python 3.14 / Pillow 13.0.0. +Docker, установка окружений, нагрузка, публикация и фоновые процессы не запускались. +Это заметки для отдельного REPORT и повторного ревью, а не итоговая динамическая квалификация. + +## Причина и исправление + +Для grayscale 2/4 Pillow переводит значения в шкалу 0..255, сохраняя исходный tRNS. +Теперь ключ переводится в ту же шкалу до обычного наложения прозрачности. Для RGB16 +старшие и младшие байты декодируются отдельно штатным zip-декодером Pillow. Пересечение +масок равенства всех шести байтов определяет прозрачность без потери точности. +Непрозрачный `(12346, 23456, 34567)` остаётся цветным рядом с прозрачным +`(12345, 23456, 34567)`. Затем применяются белый фон, EXIF orientation и прежний рендер. + +Основание: [PNG tRNS](https://www.w3.org/TR/png-3/#11tRNS) требует сравнения полных +16-битных значений. Документация tile descriptor получена через Context7 +`/python-pillow/pillow/13.0.0` и [Pillow image plugins](https://pillow.readthedocs.io/en/stable/handbook/writing-your-own-image-plugin.html). +Выбор байтов и одинаковая глубина 48 бит подтверждены в +[Unpack.c Pillow 13.0.0](https://github.com/python-pillow/Pillow/blob/13.0.0/src/libImaging/Unpack.c#L574-L595). +Интерпретация `RGB;16L` здесь намеренно извлекает младшие байты big-endian PNG; +фильтры и Adam7 остаются штатными. + +## Выполненные проверки + +Все команды выполняются из корня репозитория. `--confcutdir` / `--noconftest` исключают +общий conftest, который поднимает Docker; запускать обычный полный `make student-test` +в этом этапе было запрещено пользователем. + +| Команда | Наблюдение | Файл | +| --- | --- | --- | +| `PYTHONPATH=src:student-tests .venv/bin/python -m pytest --confcutdir=student-tests/unit student-tests/unit/test_png_transparency.py -k review -q --tb=short` до исправления | 6 failed, 140 deselected: `(85,85,85)` и `(48,91,134)` вместо белого; это ожидаемое воспроизведение, не PASS | `regressions-before.txt` | +| Та же команда без `-k review` после исправления | 146 passed | `regressions-after.txt` | +| `PYTHONPATH=src:student-tests make student-test PYTEST_ARGS='--confcutdir=student-tests/unit student-tests/unit/test_png_transparency.py student-tests/unit/test_renderer.py student-tests/unit/test_image_inspection.py student-tests/unit/test_png_upload.py student-tests/unit/test_worker_delivery.py student-tests/unit/test_pipeline_domain.py -q --tb=short'` | 430 passed, включая финальные fixtures с точным соседом 12346 | `offline-tests.txt` | +| `PYTHONPATH=src:student-tests .venv/bin/python -m pytest --noconftest student-tests/api/test_bounded_contexts.py -q --tb=short` | 20 passed | `boundaries.txt` | +| `zsh evidence/review-trns-depth-2026-11-06/compatibility-command.txt` | 19 изображений × 2 версии × 3 варианта = 114 побайтно одинаковых вариантов с исходным snapshot | `unchanged-rendering.json` | +| `make check` | PASS структуры/синтаксиса; приложение этим не тестируется | `check.txt` | +| `make validate` | PASS OpenAPI 3.1 / JSON Schema | `validate.txt` | +| `make lint` перед коммитом | PASS ruff check/format, ty | `lint.txt` | +| `openspec validate --all --strict` до архивации | 23 passed | `openspec-before-archive.txt` | +| `openspec validate --all --strict` после архивации | 22 passed | `openspec-after-archive.txt` | +| `openspec list --json` после архивации | Активных changes нет | `active-changes-after.json` | +| `git diff --check` | exit 0 | `diff.txt` | + +146 новых регрессий сравнивают все байты thumbnail/crop/optimized v1/v2 с независимым +RGB-эталоном, собранным из исходных integer samples. Покрыты все ключи grayscale 1/2/4, +выбранные ключи 8/16, младшие/старшие биты всех каналов RGB16, крайние значения ключа, +пять фильтров PNG, Adam7, IDAT по 7 байт, нечётные/малые размеры и EXIF orientation 6. +Первый отдельный прогон был до добавления точного соседнего значения 12346 в генератор; +финальный набор из 430 тестов и сравнение 114 вариантов выполнены после этого дополнения. + +Первый `git diff --cached --check` вернул exit 2 из-за пробелов в pytest-логе и пустых +строк в конце файлов (`staged-diff-before.txt`). Удалены только концевые пробелы и лишние +пустые строки; значения и результаты не менялись. Финальная проверка индекса — exit 0. + +Хеши кода, тестов и результатов — `checks.json`. В `fixtures/` сохранены три PNG с tRNS +и три независимо сформированных RGB-эталона с белым фоном; хеши — `fixtures.json`. +Это синтетические данные. Исходник приложения изменён только в `images.py`. + +## Обязательные проверки финального этапа + +Перечисленные ниже проверки здесь **НЕ выполнялись**. OpenSpec закрывает исправление и +offline-проверки; операции apply/archive с требованием стенда уступают прямому запрету +пользователя на Docker в этой фазе. + +1. На разрешённом стенде через LB `http://127.0.0.1:18085` загрузить `gray2.png`, `gray4.png` + и `rgb16.png`: `202 queued → ready`, исходные bytes/SHA-256 сохранены, метаданные и хеши + всех трёх скачанных вариантов совпадают с фактическими файлами. Для v1 и v2 сравнить + скачанные bytes с рендером соответствующего `*-white.png` той же версии. Проверить белую + левую часть и цветной `(12346,23456,34567)` справа. До v2 дождаться ready v1. +2. Повторить адресно вариант RGB16+tRNS с Adam7/filter=4/EXIF orientation=6, используя + `png_trns_fixtures.png_with_trns(16, (12345,23456,34567), size=(65,63), interlace=1, + filtering=4, orientation=6)`. Проверить ориентацию, размеры и отсутствие метаданных. +3. Проверить новые пути на 40 Мпикс под Linux со штатными `RENDER_MEMORY_MB=448` и + `RENDER_TIMEOUT_SECONDS=30`, в пределах лимита upload, а также принудительные ошибки + времени/памяти и последующую обработку обычного задания. RGB16+tRNS добавляет второе + декодирование и маски: пределы и производительность offline-матрицей не доказаны. +4. Адресно проверить повтор доставки и публикацию v1 → v2 для этих PNG: один набор + вариантов на ключ эффекта и отсутствие отката ready. SQL/outbox/ack не менялись; + прежние пригодные fault-injection и нагрузочные серии автоматически не аннулируются. +5. Сохраняются ранее назначенные проверки из + `../review-fixes-2026-11-06/RESULTS.md`: реальный RabbitMQ 4.1.8 с policy + `delivery-limit=-1`, более 10 инфраструктурных ошибок после публикации outbox, + восстановление БД без replay, неизменная DLQ, retry-exhaustion/replay и затронутые + сценарии COMMIT/ack. Эта правка их не исполняет и не заменяет свидетельством offline. + +Финальный агент сохраняет команды, условия совместного использования Docker и фактические +остановки своего project; повторяет только отсутствующие/затронутые/непригодные серии. + +## Ограничения для REPORT + +Пять прежних minor сохранены в `findings.json` без исправлений: crash_publish_confirm +проверяет окно после confirm; старый limits exit 1 не является PASS; reconcile_track +ожидает семантику ЛР4; failed upgrade v2 отдельно не повторяется при ready v1; +спорные длительности track2 исключены из выводов о производительности. + +RGB16+tRNS зависит от tile rawmode Pillow; обновление зависимости требует регрессий. +Маски вычисляются операциями Pillow, без Python-цикла по пикселям. Дополнительное +декодирование применяется только к RGB16 с tRNS. Уже опубликованные ready-вложения +автоматически не переписываются; исправление действует на новые задания. diff --git a/evidence/review-trns-depth-2026-11-06/active-changes-after.json b/evidence/review-trns-depth-2026-11-06/active-changes-after.json new file mode 100644 index 00000000..c1f7be3b --- /dev/null +++ b/evidence/review-trns-depth-2026-11-06/active-changes-after.json @@ -0,0 +1,7 @@ +{ + "changes": [], + "root": { + "path": "/Users/artemkostylev/projects/learning/HL/labs/mtusi2026lab5", + "source": "nearest" + } +} diff --git a/evidence/review-trns-depth-2026-11-06/archive.txt b/evidence/review-trns-depth-2026-11-06/archive.txt new file mode 100644 index 00000000..c73a44f6 --- /dev/null +++ b/evidence/review-trns-depth-2026-11-06/archive.txt @@ -0,0 +1,7 @@ +Task status: ✓ Complete + +Specs to update: + lab5-image-variants: update +Totals: + 0, ~ 0, - 0, → 0 +Specs already in sync; no files changed. +Change 'fix-png-trns-source-depth' archived as '2026-11-06-fix-png-trns-source-depth'. diff --git a/evidence/review-trns-depth-2026-11-06/boundaries.txt b/evidence/review-trns-depth-2026-11-06/boundaries.txt new file mode 100644 index 00000000..a1069d6c --- /dev/null +++ b/evidence/review-trns-depth-2026-11-06/boundaries.txt @@ -0,0 +1,2 @@ +.................... [100%] +20 passed in 0.17s diff --git a/evidence/review-trns-depth-2026-11-06/check.txt b/evidence/review-trns-depth-2026-11-06/check.txt new file mode 100644 index 00000000..9a553306 --- /dev/null +++ b/evidence/review-trns-depth-2026-11-06/check.txt @@ -0,0 +1,2 @@ +python3 scripts/check_contract.py +PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. diff --git a/evidence/review-trns-depth-2026-11-06/checks.json b/evidence/review-trns-depth-2026-11-06/checks.json new file mode 100644 index 00000000..50c8680f --- /dev/null +++ b/evidence/review-trns-depth-2026-11-06/checks.json @@ -0,0 +1,128 @@ +{ + "baseline_sha": "6e97bdbe9638c5a53951337fce639a1a0db7f92e", + "recorded_at": "2026-11-06T20:51:22.362592+00:00", + "python": "3.14.5", + "pillow": "13.0.0", + "scope": "offline only; no Docker, load, installation or publication", + "checks": [ + { + "command": "pytest --confcutdir=student-tests/unit student-tests/unit/test_png_transparency.py -k review -q --tb=short (before fix)", + "exit_code": 1, + "result": "6 failed, 140 deselected; expected defect reproduction", + "log": "regressions-before.txt" + }, + { + "command": "pytest --confcutdir=student-tests/unit student-tests/unit/test_png_transparency.py -q --tb=short", + "exit_code": 0, + "result": "146 passed before exact 12346 fixture extension", + "log": "regressions-after.txt" + }, + { + "command": "PYTHONPATH=src:student-tests make student-test PYTEST_ARGS='--confcutdir=student-tests/unit student-tests/unit/test_png_transparency.py student-tests/unit/test_renderer.py student-tests/unit/test_image_inspection.py student-tests/unit/test_png_upload.py student-tests/unit/test_worker_delivery.py student-tests/unit/test_pipeline_domain.py -q --tb=short'", + "exit_code": 0, + "result": "430 passed with final fixtures", + "log": "offline-tests.txt" + }, + { + "command": "PYTHONPATH=src:student-tests .venv/bin/python -m pytest --noconftest student-tests/api/test_bounded_contexts.py -q --tb=short", + "exit_code": 0, + "result": "20 passed", + "log": "boundaries.txt" + }, + { + "command": "zsh evidence/review-trns-depth-2026-11-06/compatibility-command.txt", + "exit_code": 0, + "result": "114 identical variants, 19 fixtures", + "log": "unchanged-rendering.json" + }, + { + "command": "make check", + "exit_code": 0, + "log": "check.txt" + }, + { + "command": "make validate", + "exit_code": 0, + "log": "validate.txt" + }, + { + "command": "make lint", + "exit_code": 0, + "log": "lint.txt" + }, + { + "command": "openspec validate --all --strict (before archive)", + "exit_code": 0, + "log": "openspec-before-archive.txt" + }, + { + "command": "openspec archive fix-png-trns-source-depth --yes", + "exit_code": 0, + "log": "archive.txt" + }, + { + "command": "openspec validate --all --strict (after archive)", + "exit_code": 0, + "log": "openspec-after-archive.txt" + }, + { + "command": "openspec list --json", + "exit_code": 0, + "log": "active-changes-after.json" + }, + { + "command": "git diff --check", + "exit_code": 0, + "log": "diff.txt" + }, + { + "command": "git diff --cached --check (initial staging)", + "exit_code": 2, + "result": "trailing whitespace in evidence and Markdown, then normalized", + "log": "staged-diff-before.txt" + }, + { + "command": "git diff --cached --check (final staging)", + "exit_code": 0, + "log": "diff.txt" + } + ], + "sha256": { + "evidence/review-trns-depth-2026-11-06/RESULTS.md": "1dc297dd094fbcc7e6afa6a5e8409f15e5d042fdcf10a759ad1662e8271678f2", + "evidence/review-trns-depth-2026-11-06/active-changes-after.json": "b00cf723b88fd2254414abeb7b15015c4fb94a28303b44b59ea542fc57bbdcda", + "evidence/review-trns-depth-2026-11-06/archive.txt": "99757ad145b9ed6aad77b916af9f323354eefaeecfcf662c5e02ac48446ca7b0", + "evidence/review-trns-depth-2026-11-06/boundaries.txt": "a4d0778a9ba058ff75b48cb3a145ac59e8c7ae9f3764db8fb6a0425c242bf8d2", + "evidence/review-trns-depth-2026-11-06/check.txt": "5f42d25d7cd8c1d2fb31ccf28a2872fbb91d38ed094024181e5ace9671667ee6", + "evidence/review-trns-depth-2026-11-06/compatibility-command.txt": "95ba9053755205121bb9682c43a3ed3133576c925e7057d61cfdf46763a90629", + "evidence/review-trns-depth-2026-11-06/diff.txt": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", + "evidence/review-trns-depth-2026-11-06/findings.json": "d04edc436e8b49203921c01256d887153a198362e276131aec35bd1ed5334546", + "evidence/review-trns-depth-2026-11-06/fixtures.json": "cab4b1fd18b190d9f4ceaad6c86489b4a202ab268a5f8dfc8bd8d872c95c3885", + "evidence/review-trns-depth-2026-11-06/fixtures/gray2-white.png": "e7fb8f48857222f73ff511b4c154debdb412160f57934e9d689f6effa11876e2", + "evidence/review-trns-depth-2026-11-06/fixtures/gray2.png": "80754a3aa0c8a6014dc7a282b2009d49d064a5c02ed48e634d05d01c0aa3df6b", + "evidence/review-trns-depth-2026-11-06/fixtures/gray4-white.png": "b0134c845a567491cd53a9bec3ebe8696ff1174b74b8112d6854fea3067c5cff", + "evidence/review-trns-depth-2026-11-06/fixtures/gray4.png": "d0ed5b64b3b875be881dd286bedb7948fd06570f9ef1d2cfe41b665a838e426b", + "evidence/review-trns-depth-2026-11-06/fixtures/rgb16-white.png": "735cd3ea79092d8372f203c00ab6c4d4e8d8ae77b9a2d0c100cb96a275e260fb", + "evidence/review-trns-depth-2026-11-06/fixtures/rgb16.png": "e8e5f64cf3a0312b17549aed29f062e3cb03d0c1bf327396c6a25c4b88dec89f", + "evidence/review-trns-depth-2026-11-06/lint-initial.txt": "f85474c18597cb45db0a26970c5af0dfe57c184e7c1c83a938738400613a3edb", + "evidence/review-trns-depth-2026-11-06/lint.txt": "f85474c18597cb45db0a26970c5af0dfe57c184e7c1c83a938738400613a3edb", + "evidence/review-trns-depth-2026-11-06/offline-tests.txt": "575d3f2d3c7e38ddbf0828973649808436411268707a8fc0dd37d325c6e4877a", + "evidence/review-trns-depth-2026-11-06/openspec-after-archive.txt": "b185f34cf979a6739249722b3df8000dcfbd0618b424dae99130e059d7cd20c7", + "evidence/review-trns-depth-2026-11-06/openspec-before-archive.txt": "1cdcfb042fddf70093f6370e0a253eac7f8c2aeae60c69b671577f948af41a4f", + "evidence/review-trns-depth-2026-11-06/regressions-after.txt": "baa3a9c25a43343f5d6b627ef218bce4ba9996cf7a0b83131021391d3e4665c5", + "evidence/review-trns-depth-2026-11-06/regressions-before.txt": "a2b54cc35e5429210a9bea1845546c990d0a39ebc04c86b5ad60198d2f33c75e", + "evidence/review-trns-depth-2026-11-06/staged-diff-before.txt": "992f54889c56c5f13736ccab6bcec4febae09bad279a9fc0cbefee2e72484579", + "evidence/review-trns-depth-2026-11-06/unchanged-rendering.json": "a3d3a30a7c410708bfd3bd4546e23d6f1b0db73dabfbc9766d445b09a1db8f6a", + "evidence/review-trns-depth-2026-11-06/validate.txt": "422aec45ba93e5567e0de199fa32116a48c970ca3b82738b40f0ed7681ef621f", + "openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/.openspec.yaml": "42fbead5cdbd3e909d4fb714c4e8f9cf79c38c118b1efc7f0fbcfb2628fa6a2b", + "openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/design.md": "52f3afbd1cbd0d7fe25457e3313111a17c9b08708f7ac6936a53f38249f52d88", + "openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/proposal.md": "3810677c8b7bb6f013475418cf71ad260f3b4a3846a5d7b4cf6992bd9c133451", + "openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/specs/lab5-image-variants/spec.md": "7097ec082eeccbb1102e8fe44b29a42f041d44e58d61e88e003779e86310b945", + "openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/tasks.md": "08a0ff877ce46322365a3d900865b460b2214234e5263e62726411b5a22b1322", + "openspec/specs/lab5-image-variants/spec.md": "458a59857c2ce45fadb3c73190b5b835cfc5cad657c589792ae280964e64179b", + "src/messenger/attachments/infrastructure/images.py": "537359101ad6266cc74f8373364ae492675aef984844a07950681cf5032f7de9", + "student-tests/png_trns_fixtures.py": "d8c85786dc8ac581858742cd054235cdbec59cc99b4ed4b163cd3bb73ebecb5c", + "student-tests/unit/test_png_transparency.py": "a994a4a3542c0b69a1b5191d3669a0181d216573cb9c61d09a910db73c3a2fba" + }, + "pending_dynamic_checks": "RESULTS.md: Обязательные проверки финального этапа", + "retained_minor_findings": "findings.json" +} diff --git a/evidence/review-trns-depth-2026-11-06/compatibility-command.txt b/evidence/review-trns-depth-2026-11-06/compatibility-command.txt new file mode 100644 index 00000000..ac15c76b --- /dev/null +++ b/evidence/review-trns-depth-2026-11-06/compatibility-command.txt @@ -0,0 +1,64 @@ +PYTHONPATH=src:student-tests .venv/bin/python - <<'PY' +import hashlib +import json +import subprocess +import sys +import types +from io import BytesIO +from pathlib import Path +from PIL import Image, __version__ +from messenger.attachments.infrastructure import images +from pictures import SAMPLE, chunk +from png_trns_fixtures import png_with_trns + +baseline = "6e97bdbe9638c5a53951337fce639a1a0db7f92e" +name = "messenger.attachments.infrastructure.before_trns_depth" +old = types.ModuleType(name) +sys.modules[name] = old +source = subprocess.run( + ["git", "show", baseline + ":src/messenger/attachments/infrastructure/images.py"], + check=True, capture_output=True, text=True, +).stdout +exec(compile(source, name, "exec"), old.__dict__) + +def encoded(image, kind="PNG", **options): + buffer = BytesIO() + image.save(buffer, kind, **options) + return buffer.getvalue() + +gradient = Image.linear_gradient("L").resize((320, 200)) +fixtures = {"sample": SAMPLE} +for mode in ("RGB", "CMYK"): + fixtures[mode + "-jpeg"] = encoded(gradient.convert(mode), "JPEG") +for mode in ("RGB", "L", "I;16", "P", "RGBA", "LA", "1"): + fixtures[mode + "-png"] = encoded(gradient.convert(mode)) +fixtures["P-trns"] = encoded(gradient.convert("P"), transparency=0) +fixtures["P-alpha-table"] = encoded(gradient.convert("P"), transparency=bytes([0, 128, 255])) +for mode, key in [("RGB", (32, 96, 160)), ("L", 85), ("I;16", 12345), ("1", 0)]: + fixtures[mode + "-trns"] = encoded(Image.new(mode, (64, 64), key), transparency=key) +for depth, key in [(2, (1,)), (4, (5,)), (16, (12345, 23456, 34567))]: + data, _ = png_with_trns(depth, key) + trns = chunk(b"tRNS", b"".join(value.to_bytes(2, "big") for value in key)) + fixtures[str(depth) + "-no-trns-" + str(len(key))] = data.replace(trns, b"") + +limits = images.RenderLimits(10_485_760, 40_000_000) +rows = [] +for name, data in fixtures.items(): + for version in (1, 2): + before = old.render_variants(data, limits, version) + after = images.render_variants(data, limits, version) + assert before == after, (name, version) + rows.append({ + "fixture": name, "source_sha256": hashlib.sha256(data).hexdigest(), + "version": version, + "variants": {v.name: hashlib.sha256(v.data).hexdigest() for v in after}, + }) +report = { + "baseline_sha": baseline, "pillow": __version__, "fixtures": len(fixtures), + "identical_variants": len(rows) * 3, "results": rows, +} +Path("evidence/review-trns-depth-2026-11-06/unchanged-rendering.json").write_text( + json.dumps(report, indent=2) + "\n" +) +print(json.dumps({key: value for key, value in report.items() if key != "results"})) +PY diff --git a/evidence/review-trns-depth-2026-11-06/diff.txt b/evidence/review-trns-depth-2026-11-06/diff.txt new file mode 100644 index 00000000..e69de29b diff --git a/evidence/review-trns-depth-2026-11-06/findings.json b/evidence/review-trns-depth-2026-11-06/findings.json new file mode 100644 index 00000000..2d42a030 --- /dev/null +++ b/evidence/review-trns-depth-2026-11-06/findings.json @@ -0,0 +1,27 @@ +[ + { + "severity": "minor", + "file": "src/messenger/attachments/application/pipeline.py:230", + "problem": "Сохранено из ревью 544b9c78d39d0e9dd07f841894c390895896605a: after_publish_before_confirm вызывается после publish(), уже проверившего Basic.Ack. crash_publish_confirm доказывает сбой после confirm до COMMIT outbox, а не потерю подтверждения." + }, + { + "severity": "minor", + "file": "scripts/limits.py:10", + "problem": "Сохранено из первого ревью: S3_CLIENT_SECRETS не отсортирован, сравнение с sorted(secrets) даёт ложные FAIL. evidence/sqlalchemy-2026-11-06/grade3/limits.txt содержит exit_code=1; этот запуск нельзя обозначать PASS." + }, + { + "severity": "minor", + "file": "scripts/reconcile_track.py:396", + "problem": "Сохранено из первого ревью: демонстратор ожидает upload 201 и attachments/, поэтому непригоден для квалификации ЛР5 с 202 queued. Текущие pipeline evidence его не используют." + }, + { + "severity": "minor", + "file": "src/messenger/attachments/application/pipeline.py:333", + "problem": "Сохранено из первого ревью: failed upgrade v2 при опубликованной ready v1 нельзя отдельно повторить через replay/reprocess. V1 остаётся доступной; подтверждение исходного ревью — test_failed_new_version_keeps_ready_original." + }, + { + "severity": "minor", + "file": "evidence/forward-final-2026-11-06/clock-observation.json", + "problem": "Сохранено из первого ревью: в повторах 2/3 UTC-интервалы расходятся с elapsed (1161.195/186.458 с и 571.513/180.259 с). Причина не установлена; длительности исключены из выводов о производительности." + } +] diff --git a/evidence/review-trns-depth-2026-11-06/fixtures.json b/evidence/review-trns-depth-2026-11-06/fixtures.json new file mode 100644 index 00000000..638ef059 --- /dev/null +++ b/evidence/review-trns-depth-2026-11-06/fixtures.json @@ -0,0 +1,26 @@ +[ + { + "file": "evidence/review-trns-depth-2026-11-06/fixtures/gray2.png", + "sha256": "80754a3aa0c8a6014dc7a282b2009d49d064a5c02ed48e634d05d01c0aa3df6b" + }, + { + "file": "evidence/review-trns-depth-2026-11-06/fixtures/gray2-white.png", + "sha256": "e7fb8f48857222f73ff511b4c154debdb412160f57934e9d689f6effa11876e2" + }, + { + "file": "evidence/review-trns-depth-2026-11-06/fixtures/gray4.png", + "sha256": "d0ed5b64b3b875be881dd286bedb7948fd06570f9ef1d2cfe41b665a838e426b" + }, + { + "file": "evidence/review-trns-depth-2026-11-06/fixtures/gray4-white.png", + "sha256": "b0134c845a567491cd53a9bec3ebe8696ff1174b74b8112d6854fea3067c5cff" + }, + { + "file": "evidence/review-trns-depth-2026-11-06/fixtures/rgb16.png", + "sha256": "e8e5f64cf3a0312b17549aed29f062e3cb03d0c1bf327396c6a25c4b88dec89f" + }, + { + "file": "evidence/review-trns-depth-2026-11-06/fixtures/rgb16-white.png", + "sha256": "735cd3ea79092d8372f203c00ab6c4d4e8d8ae77b9a2d0c100cb96a275e260fb" + } +] diff --git a/evidence/review-trns-depth-2026-11-06/fixtures/gray2-white.png b/evidence/review-trns-depth-2026-11-06/fixtures/gray2-white.png new file mode 100644 index 00000000..0623e2f1 Binary files /dev/null and b/evidence/review-trns-depth-2026-11-06/fixtures/gray2-white.png differ diff --git a/evidence/review-trns-depth-2026-11-06/fixtures/gray2.png b/evidence/review-trns-depth-2026-11-06/fixtures/gray2.png new file mode 100644 index 00000000..be076588 Binary files /dev/null and b/evidence/review-trns-depth-2026-11-06/fixtures/gray2.png differ diff --git a/evidence/review-trns-depth-2026-11-06/fixtures/gray4-white.png b/evidence/review-trns-depth-2026-11-06/fixtures/gray4-white.png new file mode 100644 index 00000000..9f99172f Binary files /dev/null and b/evidence/review-trns-depth-2026-11-06/fixtures/gray4-white.png differ diff --git a/evidence/review-trns-depth-2026-11-06/fixtures/gray4.png b/evidence/review-trns-depth-2026-11-06/fixtures/gray4.png new file mode 100644 index 00000000..41fd5445 Binary files /dev/null and b/evidence/review-trns-depth-2026-11-06/fixtures/gray4.png differ diff --git a/evidence/review-trns-depth-2026-11-06/fixtures/rgb16-white.png b/evidence/review-trns-depth-2026-11-06/fixtures/rgb16-white.png new file mode 100644 index 00000000..5946a4f7 Binary files /dev/null and b/evidence/review-trns-depth-2026-11-06/fixtures/rgb16-white.png differ diff --git a/evidence/review-trns-depth-2026-11-06/fixtures/rgb16.png b/evidence/review-trns-depth-2026-11-06/fixtures/rgb16.png new file mode 100644 index 00000000..61b98b91 Binary files /dev/null and b/evidence/review-trns-depth-2026-11-06/fixtures/rgb16.png differ diff --git a/evidence/review-trns-depth-2026-11-06/lint-initial.txt b/evidence/review-trns-depth-2026-11-06/lint-initial.txt new file mode 100644 index 00000000..d0c39bea --- /dev/null +++ b/evidence/review-trns-depth-2026-11-06/lint-initial.txt @@ -0,0 +1,6 @@ +.venv/bin/ruff check src student-tests scripts/capture_evidence.py alembic scripts/scaling.py tools scripts/probe.py scripts/limits.py scripts/lab4_scenarios.py scripts/lab4_seed.py scripts/upload_memory.py scripts/reconcile_check.py scripts/reconcile_track.py scripts/make_images.py scripts/pipeline_suite.py scripts/pipeline_evidence.py +All checks passed! +.venv/bin/ruff format --check src student-tests scripts/capture_evidence.py alembic scripts/scaling.py tools scripts/probe.py scripts/limits.py scripts/lab4_scenarios.py scripts/lab4_seed.py scripts/upload_memory.py scripts/reconcile_check.py scripts/reconcile_track.py scripts/make_images.py scripts/pipeline_suite.py scripts/pipeline_evidence.py +197 files already formatted +.venv/bin/ty check src student-tests alembic +All checks passed! diff --git a/evidence/review-trns-depth-2026-11-06/lint.txt b/evidence/review-trns-depth-2026-11-06/lint.txt new file mode 100644 index 00000000..d0c39bea --- /dev/null +++ b/evidence/review-trns-depth-2026-11-06/lint.txt @@ -0,0 +1,6 @@ +.venv/bin/ruff check src student-tests scripts/capture_evidence.py alembic scripts/scaling.py tools scripts/probe.py scripts/limits.py scripts/lab4_scenarios.py scripts/lab4_seed.py scripts/upload_memory.py scripts/reconcile_check.py scripts/reconcile_track.py scripts/make_images.py scripts/pipeline_suite.py scripts/pipeline_evidence.py +All checks passed! +.venv/bin/ruff format --check src student-tests scripts/capture_evidence.py alembic scripts/scaling.py tools scripts/probe.py scripts/limits.py scripts/lab4_scenarios.py scripts/lab4_seed.py scripts/upload_memory.py scripts/reconcile_check.py scripts/reconcile_track.py scripts/make_images.py scripts/pipeline_suite.py scripts/pipeline_evidence.py +197 files already formatted +.venv/bin/ty check src student-tests alembic +All checks passed! diff --git a/evidence/review-trns-depth-2026-11-06/offline-tests.txt b/evidence/review-trns-depth-2026-11-06/offline-tests.txt new file mode 100644 index 00000000..149eecb9 --- /dev/null +++ b/evidence/review-trns-depth-2026-11-06/offline-tests.txt @@ -0,0 +1,8 @@ +.venv/bin/pytest --confcutdir=student-tests/unit student-tests/unit/test_png_transparency.py student-tests/unit/test_renderer.py student-tests/unit/test_image_inspection.py student-tests/unit/test_png_upload.py student-tests/unit/test_worker_delivery.py student-tests/unit/test_pipeline_domain.py -q --tb=short +........................................................................ [ 16%] +........................................................................ [ 33%] +........................................................................ [ 50%] +........................................................................ [ 66%] +........................................................................ [ 83%] +...................................................................... [100%] +430 passed in 1.23s diff --git a/evidence/review-trns-depth-2026-11-06/openspec-after-archive.txt b/evidence/review-trns-depth-2026-11-06/openspec-after-archive.txt new file mode 100644 index 00000000..57b14b1f --- /dev/null +++ b/evidence/review-trns-depth-2026-11-06/openspec-after-archive.txt @@ -0,0 +1,24 @@ +- Validating... +✓ spec/lab1-event-publication +✓ spec/lab1-messenger-chats +✓ spec/lab1-messenger-history +✓ spec/lab1-messenger-identity +✓ spec/lab1-service-operability +✓ spec/lab2-auth-sessions +✓ spec/lab2-dependency-failures +✓ spec/lab2-history-index +✓ spec/lab2-persistent-storage +✓ spec/lab2-session-cache +✓ spec/lab3-failover-operations +✓ spec/lab3-idempotent-messages +✓ spec/lab3-load-balancing +✓ spec/lab4-attachments +✓ spec/lab4-object-storage +✓ spec/lab4-storage-reconciler +✓ spec/lab4-upload-resilience +✓ spec/lab5-attachment-pipeline +✓ spec/lab5-image-variants +✓ spec/lab5-job-delivery +✓ spec/lab5-job-recovery +✓ spec/lab5-versioned-pipeline +Totals: 22 passed, 0 failed (22 items) diff --git a/evidence/review-trns-depth-2026-11-06/openspec-before-archive.txt b/evidence/review-trns-depth-2026-11-06/openspec-before-archive.txt new file mode 100644 index 00000000..1f32a9f5 --- /dev/null +++ b/evidence/review-trns-depth-2026-11-06/openspec-before-archive.txt @@ -0,0 +1,25 @@ +- Validating... +✓ change/fix-png-trns-source-depth +✓ spec/lab1-event-publication +✓ spec/lab1-messenger-chats +✓ spec/lab1-messenger-history +✓ spec/lab1-messenger-identity +✓ spec/lab1-service-operability +✓ spec/lab2-auth-sessions +✓ spec/lab2-dependency-failures +✓ spec/lab2-history-index +✓ spec/lab2-persistent-storage +✓ spec/lab2-session-cache +✓ spec/lab3-failover-operations +✓ spec/lab3-idempotent-messages +✓ spec/lab3-load-balancing +✓ spec/lab4-attachments +✓ spec/lab4-object-storage +✓ spec/lab4-storage-reconciler +✓ spec/lab4-upload-resilience +✓ spec/lab5-attachment-pipeline +✓ spec/lab5-image-variants +✓ spec/lab5-job-delivery +✓ spec/lab5-job-recovery +✓ spec/lab5-versioned-pipeline +Totals: 23 passed, 0 failed (23 items) diff --git a/evidence/review-trns-depth-2026-11-06/regressions-after.txt b/evidence/review-trns-depth-2026-11-06/regressions-after.txt new file mode 100644 index 00000000..b757ec03 --- /dev/null +++ b/evidence/review-trns-depth-2026-11-06/regressions-after.txt @@ -0,0 +1,4 @@ +........................................................................ [ 49%] +........................................................................ [ 98%] +.. [100%] +146 passed in 0.69s diff --git a/evidence/review-trns-depth-2026-11-06/regressions-before.txt b/evidence/review-trns-depth-2026-11-06/regressions-before.txt new file mode 100644 index 00000000..a6441bf5 --- /dev/null +++ b/evidence/review-trns-depth-2026-11-06/regressions-before.txt @@ -0,0 +1,58 @@ +FFFFFF [100%] +=================================== FAILURES =================================== +________ test_review_samples_have_white_transparency[2-transparent0-1] _________ +student-tests/unit/test_png_transparency.py:28: in test_review_samples_have_white_transparency + assert image.getpixel((5, image.height // 2)) == (255, 255, 255), variant.name +E AssertionError: thumbnail +E assert (85, 85, 85) == (255, 255, 255) +E +E At index 0 diff: 85 != 255 +E Use -v to get more diff +________ test_review_samples_have_white_transparency[2-transparent0-2] _________ +student-tests/unit/test_png_transparency.py:28: in test_review_samples_have_white_transparency + assert image.getpixel((5, image.height // 2)) == (255, 255, 255), variant.name +E AssertionError: thumbnail +E assert (85, 85, 85) == (255, 255, 255) +E +E At index 0 diff: 85 != 255 +E Use -v to get more diff +________ test_review_samples_have_white_transparency[4-transparent1-1] _________ +student-tests/unit/test_png_transparency.py:28: in test_review_samples_have_white_transparency + assert image.getpixel((5, image.height // 2)) == (255, 255, 255), variant.name +E AssertionError: thumbnail +E assert (85, 85, 85) == (255, 255, 255) +E +E At index 0 diff: 85 != 255 +E Use -v to get more diff +________ test_review_samples_have_white_transparency[4-transparent1-2] _________ +student-tests/unit/test_png_transparency.py:28: in test_review_samples_have_white_transparency + assert image.getpixel((5, image.height // 2)) == (255, 255, 255), variant.name +E AssertionError: thumbnail +E assert (85, 85, 85) == (255, 255, 255) +E +E At index 0 diff: 85 != 255 +E Use -v to get more diff +________ test_review_samples_have_white_transparency[16-transparent2-1] ________ +student-tests/unit/test_png_transparency.py:28: in test_review_samples_have_white_transparency + assert image.getpixel((5, image.height // 2)) == (255, 255, 255), variant.name +E AssertionError: thumbnail +E assert (48, 91, 134) == (255, 255, 255) +E +E At index 0 diff: 48 != 255 +E Use -v to get more diff +________ test_review_samples_have_white_transparency[16-transparent2-2] ________ +student-tests/unit/test_png_transparency.py:28: in test_review_samples_have_white_transparency + assert image.getpixel((5, image.height // 2)) == (255, 255, 255), variant.name +E AssertionError: thumbnail +E assert (48, 91, 134) == (255, 255, 255) +E +E At index 0 diff: 48 != 255 +E Use -v to get more diff +=========================== short test summary info ============================ +FAILED student-tests/unit/test_png_transparency.py::test_review_samples_have_white_transparency[2-transparent0-1] +FAILED student-tests/unit/test_png_transparency.py::test_review_samples_have_white_transparency[2-transparent0-2] +FAILED student-tests/unit/test_png_transparency.py::test_review_samples_have_white_transparency[4-transparent1-1] +FAILED student-tests/unit/test_png_transparency.py::test_review_samples_have_white_transparency[4-transparent1-2] +FAILED student-tests/unit/test_png_transparency.py::test_review_samples_have_white_transparency[16-transparent2-1] +FAILED student-tests/unit/test_png_transparency.py::test_review_samples_have_white_transparency[16-transparent2-2] +6 failed, 140 deselected in 0.15s diff --git a/evidence/review-trns-depth-2026-11-06/staged-diff-before.txt b/evidence/review-trns-depth-2026-11-06/staged-diff-before.txt new file mode 100644 index 00000000..ca5409c4 --- /dev/null +++ b/evidence/review-trns-depth-2026-11-06/staged-diff-before.txt @@ -0,0 +1,14 @@ +evidence/review-trns-depth-2026-11-06/compatibility-command.txt:65: new blank line at EOF. +evidence/review-trns-depth-2026-11-06/regressions-before.txt:8: trailing whitespace. ++E +evidence/review-trns-depth-2026-11-06/regressions-before.txt:16: trailing whitespace. ++E +evidence/review-trns-depth-2026-11-06/regressions-before.txt:24: trailing whitespace. ++E +evidence/review-trns-depth-2026-11-06/regressions-before.txt:32: trailing whitespace. ++E +evidence/review-trns-depth-2026-11-06/regressions-before.txt:40: trailing whitespace. ++E +evidence/review-trns-depth-2026-11-06/regressions-before.txt:48: trailing whitespace. ++E +openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/specs/lab5-image-variants/spec.md:31: new blank line at EOF. diff --git a/evidence/review-trns-depth-2026-11-06/unchanged-rendering.json b/evidence/review-trns-depth-2026-11-06/unchanged-rendering.json new file mode 100644 index 00000000..f3446a95 --- /dev/null +++ b/evidence/review-trns-depth-2026-11-06/unchanged-rendering.json @@ -0,0 +1,388 @@ +{ + "baseline_sha": "6e97bdbe9638c5a53951337fce639a1a0db7f92e", + "pillow": "13.0.0", + "fixtures": 19, + "identical_variants": 114, + "results": [ + { + "fixture": "sample", + "source_sha256": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "version": 1, + "variants": { + "thumbnail": "7bc40bf315c8e18e907889b23514d978be213a44223d64b737290188ee808594", + "crop": "97bf1400b30a28c19420a30161c944f57b5e7d613533b76afe6ab2531cba0143", + "optimized": "1090d84ed8411226010ae498b08e1b9e6d81c8eee02ee77143a0dc327b894beb" + } + }, + { + "fixture": "sample", + "source_sha256": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "version": 2, + "variants": { + "thumbnail": "fa0db661078d4da91b241edc8b416de7755db9c9c79ae704a620ca7ad534e308", + "crop": "5b6fb2a66216f8ca038542acdd8482fca9d1ad79193d60ae74de3989048ec0a4", + "optimized": "fe520c978bd45fc8f1b85863dc9dc6fc98954b45d7fe803e8e4c6b681ddc1957" + } + }, + { + "fixture": "RGB-jpeg", + "source_sha256": "e61f9f15dd12ecd761dfab09101dd7add5c8a54ba05fd57c9d5df298683d4b1a", + "version": 1, + "variants": { + "thumbnail": "c937dfed819a51173c41a4c2e09b607a793fa37c99a212f25f19bdc7d6656568", + "crop": "2f59ee8f67e75fd3e658f530071dadfe83b8fbeff0c8a3747491c7c3c80fabbc", + "optimized": "6a6eb69835b1b2298b36f8246d0f6b23e882faee89f8e129ec4a2c96ae2f622d" + } + }, + { + "fixture": "RGB-jpeg", + "source_sha256": "e61f9f15dd12ecd761dfab09101dd7add5c8a54ba05fd57c9d5df298683d4b1a", + "version": 2, + "variants": { + "thumbnail": "a2d87e5d4bdffe09fd48f26a94a4f6370feadbc2415fe37e48d1c03c45268a29", + "crop": "ce9ca159c2610fa3d5dbb873b035d5b54bda2aaf3298db7fad8d5fd3c226ef95", + "optimized": "03b7ce2b76c0cda14decb81dc2488895806ee652fbdccff2de2471736e150ff4" + } + }, + { + "fixture": "CMYK-jpeg", + "source_sha256": "58645199defb60a3710f2635b17279aa44085df1b186b0d115f1643dd7a96a1c", + "version": 1, + "variants": { + "thumbnail": "c937dfed819a51173c41a4c2e09b607a793fa37c99a212f25f19bdc7d6656568", + "crop": "2f59ee8f67e75fd3e658f530071dadfe83b8fbeff0c8a3747491c7c3c80fabbc", + "optimized": "6a6eb69835b1b2298b36f8246d0f6b23e882faee89f8e129ec4a2c96ae2f622d" + } + }, + { + "fixture": "CMYK-jpeg", + "source_sha256": "58645199defb60a3710f2635b17279aa44085df1b186b0d115f1643dd7a96a1c", + "version": 2, + "variants": { + "thumbnail": "a2d87e5d4bdffe09fd48f26a94a4f6370feadbc2415fe37e48d1c03c45268a29", + "crop": "ce9ca159c2610fa3d5dbb873b035d5b54bda2aaf3298db7fad8d5fd3c226ef95", + "optimized": "03b7ce2b76c0cda14decb81dc2488895806ee652fbdccff2de2471736e150ff4" + } + }, + { + "fixture": "RGB-png", + "source_sha256": "93d6a13c1c9dae20690433b3ad4fca505aabb8720a6b70b2930a1de30a323569", + "version": 1, + "variants": { + "thumbnail": "046f700e149b7ebc5745ce8af2e55d712a6a3ecc0e826ef65b2309f64ff295a5", + "crop": "9b0cb030337fc2c9cf90e5454154d91c496fbc01c55cd39db8dcf27a6f0b11d5", + "optimized": "4fc20a195c4819310251a2ce68a4515ba4e65f8c4db41b9a56425ba4dc7f1b43" + } + }, + { + "fixture": "RGB-png", + "source_sha256": "93d6a13c1c9dae20690433b3ad4fca505aabb8720a6b70b2930a1de30a323569", + "version": 2, + "variants": { + "thumbnail": "f597f8199bb94bbd7ac46ad1f2ed0c1867137dcf64aab8cd5d53a178c537625f", + "crop": "de3e877834087a2542ff966b11af1de3a418f303f1fbe5e995778b4f9159d671", + "optimized": "22c3af91f0e927d21fd7e447fd3535ba06845d792cba87a2acf9ea73a7c9ef3e" + } + }, + { + "fixture": "L-png", + "source_sha256": "122f867287d6c27391679489d1dda616a13f326c839db0037c7bc56cb30f7f4a", + "version": 1, + "variants": { + "thumbnail": "046f700e149b7ebc5745ce8af2e55d712a6a3ecc0e826ef65b2309f64ff295a5", + "crop": "9b0cb030337fc2c9cf90e5454154d91c496fbc01c55cd39db8dcf27a6f0b11d5", + "optimized": "4fc20a195c4819310251a2ce68a4515ba4e65f8c4db41b9a56425ba4dc7f1b43" + } + }, + { + "fixture": "L-png", + "source_sha256": "122f867287d6c27391679489d1dda616a13f326c839db0037c7bc56cb30f7f4a", + "version": 2, + "variants": { + "thumbnail": "f597f8199bb94bbd7ac46ad1f2ed0c1867137dcf64aab8cd5d53a178c537625f", + "crop": "de3e877834087a2542ff966b11af1de3a418f303f1fbe5e995778b4f9159d671", + "optimized": "22c3af91f0e927d21fd7e447fd3535ba06845d792cba87a2acf9ea73a7c9ef3e" + } + }, + { + "fixture": "I;16-png", + "source_sha256": "7b7f9df7a7fd7faa1ad3ef94aa0bb1e7ffcf516d986ef7e5aba86ea446976836", + "version": 1, + "variants": { + "thumbnail": "cdadbef863c5819a1bd7a03bb67c8fa22be4b26fe3709fb66006429459585e41", + "crop": "4fb3b365a5278998ed1e11afc2d4d5deca2c06ebd5c45b28eaeebb56619343b4", + "optimized": "292ee17f29c203733ba10623a751d1a786befeb84dd8d53c48b30b1964dc58df" + } + }, + { + "fixture": "I;16-png", + "source_sha256": "7b7f9df7a7fd7faa1ad3ef94aa0bb1e7ffcf516d986ef7e5aba86ea446976836", + "version": 2, + "variants": { + "thumbnail": "96ea77f747af17185f3b8ff64c0d4280df4130c5b64f7ed6af18b56ab6c97409", + "crop": "4703e8731b7d52cf95d7e6db1ba2c000aa9a0f9aa3b851b31a24a7be4bcf7281", + "optimized": "4126871c04e218d2219b8db7a1aa1f650fcb0869d563d8dc8b2170369002b1a0" + } + }, + { + "fixture": "P-png", + "source_sha256": "b4ffc9ea7353d6a9c8ec2777b3d564e1d71a35fda1d34c53730ccc899b34df75", + "version": 1, + "variants": { + "thumbnail": "046f700e149b7ebc5745ce8af2e55d712a6a3ecc0e826ef65b2309f64ff295a5", + "crop": "9b0cb030337fc2c9cf90e5454154d91c496fbc01c55cd39db8dcf27a6f0b11d5", + "optimized": "4fc20a195c4819310251a2ce68a4515ba4e65f8c4db41b9a56425ba4dc7f1b43" + } + }, + { + "fixture": "P-png", + "source_sha256": "b4ffc9ea7353d6a9c8ec2777b3d564e1d71a35fda1d34c53730ccc899b34df75", + "version": 2, + "variants": { + "thumbnail": "f597f8199bb94bbd7ac46ad1f2ed0c1867137dcf64aab8cd5d53a178c537625f", + "crop": "de3e877834087a2542ff966b11af1de3a418f303f1fbe5e995778b4f9159d671", + "optimized": "22c3af91f0e927d21fd7e447fd3535ba06845d792cba87a2acf9ea73a7c9ef3e" + } + }, + { + "fixture": "RGBA-png", + "source_sha256": "318608d6c261a2a51862520193187b3b141e29a638d67e05099b96891bc446e3", + "version": 1, + "variants": { + "thumbnail": "046f700e149b7ebc5745ce8af2e55d712a6a3ecc0e826ef65b2309f64ff295a5", + "crop": "9b0cb030337fc2c9cf90e5454154d91c496fbc01c55cd39db8dcf27a6f0b11d5", + "optimized": "4fc20a195c4819310251a2ce68a4515ba4e65f8c4db41b9a56425ba4dc7f1b43" + } + }, + { + "fixture": "RGBA-png", + "source_sha256": "318608d6c261a2a51862520193187b3b141e29a638d67e05099b96891bc446e3", + "version": 2, + "variants": { + "thumbnail": "f597f8199bb94bbd7ac46ad1f2ed0c1867137dcf64aab8cd5d53a178c537625f", + "crop": "de3e877834087a2542ff966b11af1de3a418f303f1fbe5e995778b4f9159d671", + "optimized": "22c3af91f0e927d21fd7e447fd3535ba06845d792cba87a2acf9ea73a7c9ef3e" + } + }, + { + "fixture": "LA-png", + "source_sha256": "de702d9aa832ed7b1dfdb38bd9043374608507d1ebb4cdd2b97e79fb5d32aa99", + "version": 1, + "variants": { + "thumbnail": "046f700e149b7ebc5745ce8af2e55d712a6a3ecc0e826ef65b2309f64ff295a5", + "crop": "9b0cb030337fc2c9cf90e5454154d91c496fbc01c55cd39db8dcf27a6f0b11d5", + "optimized": "4fc20a195c4819310251a2ce68a4515ba4e65f8c4db41b9a56425ba4dc7f1b43" + } + }, + { + "fixture": "LA-png", + "source_sha256": "de702d9aa832ed7b1dfdb38bd9043374608507d1ebb4cdd2b97e79fb5d32aa99", + "version": 2, + "variants": { + "thumbnail": "f597f8199bb94bbd7ac46ad1f2ed0c1867137dcf64aab8cd5d53a178c537625f", + "crop": "de3e877834087a2542ff966b11af1de3a418f303f1fbe5e995778b4f9159d671", + "optimized": "22c3af91f0e927d21fd7e447fd3535ba06845d792cba87a2acf9ea73a7c9ef3e" + } + }, + { + "fixture": "1-png", + "source_sha256": "3f6c0276133975027aca1dc90484c5d4fafec461c3ad59a082cbf17731e6637e", + "version": 1, + "variants": { + "thumbnail": "0aeedb3af94a749ed9029c174a52dc653c0c5bbe30a0dd2ca97bcc4d71898b6c", + "crop": "e986c95644b19806716da9df1453ed75d3b2ca5296bcd32a4b70e9fbfb662b0f", + "optimized": "493f13b0f6db5a7bfd6e7dc80e060599b826c54b07f030a1d583fc412bcb20b0" + } + }, + { + "fixture": "1-png", + "source_sha256": "3f6c0276133975027aca1dc90484c5d4fafec461c3ad59a082cbf17731e6637e", + "version": 2, + "variants": { + "thumbnail": "3610c9884da7bf7bf0a33d5fd44139369af768a94e988cdcf3be81d425527ca4", + "crop": "bb673f75e5474b8bcb2a80f9b0d31e7a60cc00f1c6804e692779bcccfdee7bae", + "optimized": "ed1a0b66017e3e44940fc88d78ceef2f9d65c7ad43026f0a70a6c3a6f3bbd501" + } + }, + { + "fixture": "P-trns", + "source_sha256": "424af860cc4de7f4cc706ac8c84e02fa2ab5151b4666e260adba6897d70af49b", + "version": 1, + "variants": { + "thumbnail": "755e7e74b82c132b7ff7e39d4c1e75043e482c12df41a819c5b67b706e49cbe9", + "crop": "a9431b710a3e2dbf2d10d6a7da096958c10432f526dc266c1a22d377abb9ef08", + "optimized": "f40f1b9e3b35d476c4bc3e619d483fc4827fe25a244863b268312b8ba54977da" + } + }, + { + "fixture": "P-trns", + "source_sha256": "424af860cc4de7f4cc706ac8c84e02fa2ab5151b4666e260adba6897d70af49b", + "version": 2, + "variants": { + "thumbnail": "269d5bd9c6df97a527ca5aaa8b1f84ccffd6f63440bbeee23510df566beb91c3", + "crop": "2490927048d406a541a6355ed563963f003f9bd5396ce13ace7a6dd328a7c8c3", + "optimized": "5a375e3380a3b9999d2889801e6e7deda751d8da9d9a672a28ad93cdc015e41a" + } + }, + { + "fixture": "P-alpha-table", + "source_sha256": "d47c5fafffc5739d92e9a2c4d3332ee01ccdb700701beb38afa2ecabf46d55a1", + "version": 1, + "variants": { + "thumbnail": "bece9e4da7cc1323c394c0499048af5a75e42814f8d27d8e291809340023c1dc", + "crop": "eb87880e2a848b26f665559672894a78bef00f524bb0d8cd5976a46a6e5791fc", + "optimized": "1223f24c4e0b2cfd7611ef6752525d7c100f279be467ff6caf6d78b7e02bcb63" + } + }, + { + "fixture": "P-alpha-table", + "source_sha256": "d47c5fafffc5739d92e9a2c4d3332ee01ccdb700701beb38afa2ecabf46d55a1", + "version": 2, + "variants": { + "thumbnail": "58105b023f68b66f66ba1cbd2b789499365cd865045b5b9ee2f79ee759a09a78", + "crop": "3efb633ea26c2f6644e74eba802b8a47f8a0aa439ab109b6b43f4d74c043b58f", + "optimized": "59cb0d421eebd45de28dd4abf2bd65292ba56f84edad82cd4ba1a66c5b0d2eeb" + } + }, + { + "fixture": "RGB-trns", + "source_sha256": "42206c43b4cc32080b16cdd79fe0469d724f9f8f5efc72abea9c269afe80548b", + "version": 1, + "variants": { + "thumbnail": "c5745603d7848377a38bb5228f7817f5d4d4f5af26dadd7d3b2fb97b6a598a8e", + "crop": "1b88218fd7e3ff00d6fa3e4bb732411617126591b2b6837aecdcaef426327eda", + "optimized": "315ce3f53ac2012226bbeb906c7d37997a7f6fabb3d0ede23a797e66fe4b51ee" + } + }, + { + "fixture": "RGB-trns", + "source_sha256": "42206c43b4cc32080b16cdd79fe0469d724f9f8f5efc72abea9c269afe80548b", + "version": 2, + "variants": { + "thumbnail": "19305cfd18dc8f3e504d6ef5667ddd7be788836e16317dba5b2c6f590b6a2667", + "crop": "45eac1bd54dba273142a01a3f01a1530787db5a9fe04aa2483862256dbf16132", + "optimized": "8c5e7cc56874d00f7d5731a6a89461b264ef4e3b450899b63f4608231180b5aa" + } + }, + { + "fixture": "L-trns", + "source_sha256": "f94b702f3cd2cc8b1580750dd259e5d21a8edf9be38dcf4efb5bfdf6311489f7", + "version": 1, + "variants": { + "thumbnail": "c5745603d7848377a38bb5228f7817f5d4d4f5af26dadd7d3b2fb97b6a598a8e", + "crop": "1b88218fd7e3ff00d6fa3e4bb732411617126591b2b6837aecdcaef426327eda", + "optimized": "315ce3f53ac2012226bbeb906c7d37997a7f6fabb3d0ede23a797e66fe4b51ee" + } + }, + { + "fixture": "L-trns", + "source_sha256": "f94b702f3cd2cc8b1580750dd259e5d21a8edf9be38dcf4efb5bfdf6311489f7", + "version": 2, + "variants": { + "thumbnail": "19305cfd18dc8f3e504d6ef5667ddd7be788836e16317dba5b2c6f590b6a2667", + "crop": "45eac1bd54dba273142a01a3f01a1530787db5a9fe04aa2483862256dbf16132", + "optimized": "8c5e7cc56874d00f7d5731a6a89461b264ef4e3b450899b63f4608231180b5aa" + } + }, + { + "fixture": "I;16-trns", + "source_sha256": "3afd48625a2b59a221645e4600ad3188f10c3842f8b04626bc977a1bc85cd5e0", + "version": 1, + "variants": { + "thumbnail": "c5745603d7848377a38bb5228f7817f5d4d4f5af26dadd7d3b2fb97b6a598a8e", + "crop": "1b88218fd7e3ff00d6fa3e4bb732411617126591b2b6837aecdcaef426327eda", + "optimized": "315ce3f53ac2012226bbeb906c7d37997a7f6fabb3d0ede23a797e66fe4b51ee" + } + }, + { + "fixture": "I;16-trns", + "source_sha256": "3afd48625a2b59a221645e4600ad3188f10c3842f8b04626bc977a1bc85cd5e0", + "version": 2, + "variants": { + "thumbnail": "19305cfd18dc8f3e504d6ef5667ddd7be788836e16317dba5b2c6f590b6a2667", + "crop": "45eac1bd54dba273142a01a3f01a1530787db5a9fe04aa2483862256dbf16132", + "optimized": "8c5e7cc56874d00f7d5731a6a89461b264ef4e3b450899b63f4608231180b5aa" + } + }, + { + "fixture": "1-trns", + "source_sha256": "f8136450eaca3db2207bf1539b71e1ab4c6daf068635b3497bee4159b6adf287", + "version": 1, + "variants": { + "thumbnail": "c5745603d7848377a38bb5228f7817f5d4d4f5af26dadd7d3b2fb97b6a598a8e", + "crop": "1b88218fd7e3ff00d6fa3e4bb732411617126591b2b6837aecdcaef426327eda", + "optimized": "315ce3f53ac2012226bbeb906c7d37997a7f6fabb3d0ede23a797e66fe4b51ee" + } + }, + { + "fixture": "1-trns", + "source_sha256": "f8136450eaca3db2207bf1539b71e1ab4c6daf068635b3497bee4159b6adf287", + "version": 2, + "variants": { + "thumbnail": "19305cfd18dc8f3e504d6ef5667ddd7be788836e16317dba5b2c6f590b6a2667", + "crop": "45eac1bd54dba273142a01a3f01a1530787db5a9fe04aa2483862256dbf16132", + "optimized": "8c5e7cc56874d00f7d5731a6a89461b264ef4e3b450899b63f4608231180b5aa" + } + }, + { + "fixture": "2-no-trns-1", + "source_sha256": "f505462cc6d52d9857644e00bbd15382c9fad995e0eb36b64da85fcb62cb6c57", + "version": 1, + "variants": { + "thumbnail": "3fc6e7b177700724086b561088438a13d7d698e8d13ddce0880e1341f89a6a71", + "crop": "8e7f44c7ba5186f8dc8dde4848634f9306e4634fd9c1ba0352e5194fca15b4e6", + "optimized": "447d894c28a230e38554c30f4def59d578c68bba95e70e9bc020c1ca7a5f4c20" + } + }, + { + "fixture": "2-no-trns-1", + "source_sha256": "f505462cc6d52d9857644e00bbd15382c9fad995e0eb36b64da85fcb62cb6c57", + "version": 2, + "variants": { + "thumbnail": "a8de36f06146335e892285d217c10eb9805dbca62799dd03a1a780980063b0b3", + "crop": "ce06d0bffe8b9ad7b5c8fe39c9af6e2690a381eb2e3df078ccec828ad4b65cfb", + "optimized": "5bd48b02df4bf359a5a8d94a6805eae88cee1af5c087fcb0b696b4518a44c8a9" + } + }, + { + "fixture": "4-no-trns-1", + "source_sha256": "e51e55c3c4277c43cb788e9ef72a0b4ccc4fdbd8eb168fa3fb9cc3d85e08546f", + "version": 1, + "variants": { + "thumbnail": "2b19fee04cab740c4ab1faa87e25ede55853a150e23629b438de155e0c81a9ad", + "crop": "8e152ebc8bd9b5b832d188b03f41b9d8613458a41ac36f2dba948251f3831d27", + "optimized": "ed2d892c6c0ac0fdf1661a97cb9fc4c8cc8d9115e8a0887e68c50e77f3c3f8a0" + } + }, + { + "fixture": "4-no-trns-1", + "source_sha256": "e51e55c3c4277c43cb788e9ef72a0b4ccc4fdbd8eb168fa3fb9cc3d85e08546f", + "version": 2, + "variants": { + "thumbnail": "945cbecb076ed784fc277f4a8e7afdbfe60af8ee9c22062343fb2ccd1fdbb4ea", + "crop": "19978947de39de6005bf371deec63d04ca95b6162900fb9eeb246924cd0ed90d", + "optimized": "56a49594e8ee41965d9f07ce4d84f7a35b8a5fe552048ba7124a0a9e5e39c30a" + } + }, + { + "fixture": "16-no-trns-3", + "source_sha256": "5ec6d9fedbf0ca7732928b61034e9f5646ed8fb29a2da0b9439d6815e12f268e", + "version": 1, + "variants": { + "thumbnail": "39cdc3ca979a1c7bd202dc1c9761184360609d6c28aff9c8584dbe1980a6d370", + "crop": "ab44186a4f90368f138c012118e3df5f4b8f7886cf52135b85c74262962ec3e4", + "optimized": "c084f69a22112d272f6eaeeedb8ed7459957511adb1729c7b81e87272b80cf62" + } + }, + { + "fixture": "16-no-trns-3", + "source_sha256": "5ec6d9fedbf0ca7732928b61034e9f5646ed8fb29a2da0b9439d6815e12f268e", + "version": 2, + "variants": { + "thumbnail": "2aac3e5c34013e8c2a261ef60a4653edbc2cd5b89f76aff50d73a6c4e7f4d90d", + "crop": "d0fa976c81f7d84b1e9811762b8b4d9836406a43a8a5879b85eaaaa64fbc362b", + "optimized": "aa58ab40ab0fb1b4dcbe34f9777a5d94343488cfce6463752b20c77bcbe35688" + } + } + ] +} diff --git a/evidence/review-trns-depth-2026-11-06/validate.txt b/evidence/review-trns-depth-2026-11-06/validate.txt new file mode 100644 index 00000000..37e81884 --- /dev/null +++ b/evidence/review-trns-depth-2026-11-06/validate.txt @@ -0,0 +1,2 @@ +.venv/bin/python scripts/validate_openapi.py +PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested. diff --git a/openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/.openspec.yaml b/openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/.openspec.yaml new file mode 100644 index 00000000..549f1970 --- /dev/null +++ b/openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/.openspec.yaml @@ -0,0 +1,4 @@ +schema: spec-driven +created: 2026-11-06 +archived: 2026-11-06 +lab: 5 diff --git a/openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/design.md b/openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/design.md new file mode 100644 index 00000000..7df24401 --- /dev/null +++ b/openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/design.md @@ -0,0 +1,43 @@ +## Context + +См. `proposal.md`. Pillow 13.0.0 возвращает grayscale 2/4 как `L` с масштабированными +пикселями, но исходным tRNS. RGB16 возвращается как RGB8; младшие байты теряются. +[PNG §11.3.1.1](https://www.w3.org/TR/png-3/#11tRNS) требует сравнивать полные 16 бит. + +## Goals / Non-Goals + +Точное определение прозрачности без нового декодера и зависимостей. Порт `VariantRenderer`, +адаптер `ProcessVariantRenderer` и сборка attachments остаются прежними; новые функции живут +только в infrastructure зоны. Исходные байты в S3 не изменяются. Ключ эффекта, lease/fencing, +COMMIT и ack не затронуты. + +## Decisions + +1. До EXIF transpose нормализовать ключ tRNS grayscale 2/4 в диапазон 0..255. + Это взаимно однозначное преобразование; информацию о прозрачности оно сохраняет. +2. Для RGB16+tRNS два штатных zip-декодирования Pillow: `RGB;16B` сохраняет старшие байты, + `RGB;16L` — младшие. Оба используют 48 бит на пиксель, одинаковые фильтры и Adam7. + Маска равенства обоих RGB-триплетов эквивалентна сравнению исходных трёх 16-битных чисел. + Младший RGB закрывается до обработки старшего. Белый фон накладывается по общей маске; + затем применяется обычная EXIF orientation и прежний рендер. +3. Маски формируются операциями Pillow, без Python-цикла по пикселям. Собственная реализация + PNG unfilter/Adam7 увеличила бы площадь ошибок и стоимость обработки; сравнение только + старших байтов делало бы соседние непрозрачные цвета прозрачными. +4. Регрессии создают PNG из исходных integer samples независимо от производственного + декодера, проверяют приём инспектором и сравнивают все байты вариантов с RGB-эталоном. + +## Risks / Trade-offs + +- Дополнительное декодирование и маски только для RGB16+tRNS → прежние лимиты байтов/пикселей + применяются до декодирования; process timeout и Linux RLIMIT_AS сохраняются. Предел 40 Мпикс + проверяет финальный агент, текущий этап не заявляет результатов памяти/производительности. +- Зависимость от tile rawmode Pillow → закреплённый `uv.lock`, регрессии всех PNG-фильтров, + Adam7, разбиения IDAT и цветов, отличающихся младшим битом каждого канала. +- Уже опубликованные ready-вложения автоматически не перезаписываются: сохраняется + монотонная публикация и идемпотентность. Исправление применяется к новым заданиям. + +## Migration Plan + +Схема БД и конфигурация брокера не меняются. Финальный этап собирает образ и выполняет +адресную проверку upload → ready → content в v1/v2 и Linux-лимиты. Offline evidence хранится +отдельно от прежней динамической квалификации; остальные пригодные серии сохраняются. diff --git a/openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/proposal.md b/openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/proposal.md new file mode 100644 index 00000000..1418e6b2 --- /dev/null +++ b/openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/proposal.md @@ -0,0 +1,36 @@ +## Why + +Повторное ревью snapshot `6e97bdbe9638c5a53951337fce639a1a0db7f92e` обнаружило major: +PNG grayscale 2/4 бита и RGB16 с tRNS получают цветной фон вместо белого. Это нарушает +`contracts/README.md:59`, обязательный thumbnail уровня «3», варианты уровня «4» и обе +версии pipeline трека 2 уровня «5». + +## What Changes + +- Учитывать исходную глубину grayscale при сравнении tRNS. +- Для RGB16 учитывать оба байта каждого канала, сохраняя непрозрачным соседний цвет, + который отличается только младшими битами. +- Проверить все варианты v1/v2, фильтры PNG, Adam7 и EXIF offline; сохранить доказательства + и перечень обязательных динамических проверок для финального агента. + +## Capabilities + +### New Capabilities + +Нет. + +### Modified Capabilities + +- `lab5-image-variants`: уточнить точность сравнения PNG tRNS до потери глубины цвета. + +## Impact + +Изменяются только адаптер рендера зоны attachments, собственные тесты, OpenSpec и evidence. +Зависимости, API, PostgreSQL и брокер не меняются. Доказательства для будущей строки REPORT +«thumbnail/crop/optimized: прозрачность на белом» сохраняются в +`evidence/review-trns-depth-2026-11-06/`; сам REPORT оформляет отдельный этап. + +## Non-goals + +Out of scope из `openspec/config.yaml` сохраняется. Minor-находки, Docker, нагрузка, +публикация, нормативные файлы и другие лабораторные не входят в это исправление. diff --git a/openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/specs/lab5-image-variants/spec.md b/openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/specs/lab5-image-variants/spec.md new file mode 100644 index 00000000..8c4904bc --- /dev/null +++ b/openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/specs/lab5-image-variants/spec.md @@ -0,0 +1,30 @@ +## MODIFIED Requirements + +### Requirement: Crop и optimized + +Worker SHALL строить для каждого задания, кроме `thumbnail`, вариант `crop` — JPEG, центрированный квадрат 128×128 после применения EXIF orientation, с увеличением маленьких исходников, — и вариант `optimized` — WebP, вписанный в 1280×1280 с сохранением пропорций, без увеличения, размеры округлены вниз и не меньше 1 px. Прозрачность (альфа-канал и PNG tRNS) во всех вариантах обеих версий pipeline SHALL компоноваться на белый фон согласно `contracts/README.md` («Вложения»). Варианты SHALL NOT содержать EXIF, ICC и XMP; параметры кодирования SHALL быть документированы (`crop` — JPEG `quality` 85, `optimized` — WebP с потерями `quality` 80, `method` 4). Метаданные каждого варианта (`content_type`, `size_bytes`, `width`, `height`, `sha256`) SHALL совпадать с байтами, которые отдаёт `/content?variant=<имя>`. + +#### Scenario: Fixture 320×200 + +- **WHEN** обработана `tests/fixtures/sample.png` +- **THEN** у вложения варианты `crop` 128×128 `image/jpeg`, `optimized` 320×200 `image/webp` и `thumbnail` 256×160, каждый `/content?variant=<имя>` отдаёт настоящий файл этого формата длиной `size_bytes` с SHA-256 из метаданных и реальными размерами из метаданных + +#### Scenario: Большой и вытянутый исходник + +- **WHEN** обработаны JPEG 4000×3000 и PNG 3000×2 +- **THEN** `optimized` 1280×960 и 1280×1 соответственно, `crop` в обоих случаях 128×128 + +#### Scenario: Ориентация и прозрачность + +- **WHEN** обработаны JPEG 400×200 с EXIF orientation 6 и PNG RGBA с прозрачным фоном +- **THEN** `optimized` первого 200×400, прозрачные области `crop` и `optimized` второго белые, ни в одном варианте нет EXIF + +#### Scenario: Прозрачность tRNS без альфа-канала + +- **WHEN** загружен допустимый PNG RGB, L, 1-битный или 16-битный grayscale с tRNS +- **THEN** прозрачные пиксели `thumbnail`, `crop` и `optimized` белые, непрозрачные сохраняют цвет с учётом кодирования; соседнее непрозрачное значение 16-битного grayscale не становится прозрачным при округлении до 8 бит + +#### Scenario: Исходная глубина tRNS + +- **WHEN** обрабатываются допустимые PNG grayscale 2/4 бита с ненулевым tRNS или RGB16 с tRNS, включая фильтры 0–4, Adam7 и EXIF orientation +- **THEN** во всех вариантах v1/v2 прозрачные области белые, а пиксели, отличающиеся от tRNS только младшим битом любого канала RGB16, остаются непрозрачными; ориентация, размеры и цвета соответствуют исходнику с явно наложенной на белый фон прозрачностью diff --git a/openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/tasks.md b/openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/tasks.md new file mode 100644 index 00000000..847ff6c2 --- /dev/null +++ b/openspec/changes/archive/2026-11-06-fix-png-trns-source-depth/tasks.md @@ -0,0 +1,14 @@ +## 1. Прозрачность thumbnail уровня «3» + +- [x] 1.1 Воспроизвести три входных PNG ревью offline и сохранить неуспешный pytest-лог. +- [x] 1.2 Исправить адаптер attachments: grayscale 2/4 и точное RGB16 tRNS; проверить thumbnail. + +## 2. Варианты уровня «4» и версии трека «5» + +- [x] 2.1 Проверить crop/optimized обеих версий, соседние цвета всех RGB-каналов, фильтры 0–4, Adam7, EXIF и малые размеры отдельными offline-тестами. +- [x] 2.2 Выполнить offline renderer/image-inspection/pipeline/consumer и boundary-тесты; проверить побайтную совместимость прежних путей рендера. + +## 3. Evidence и завершение + +- [x] 3.1 Сохранить команды, реальные результаты, хеши файлов и перечень затронутых динамических проверок для финального агента; перенести прежние minor в ограничения. +- [x] 3.2 Выполнить make check, make validate, make lint и строгую валидацию OpenSpec; синхронизировать спецификацию и архивировать change. diff --git a/openspec/specs/lab5-image-variants/spec.md b/openspec/specs/lab5-image-variants/spec.md index ded025ed..bb254bf8 100644 --- a/openspec/specs/lab5-image-variants/spec.md +++ b/openspec/specs/lab5-image-variants/spec.md @@ -27,6 +27,11 @@ Worker SHALL строить для каждого задания, кроме `th - **WHEN** загружен допустимый PNG RGB, L, 1-битный или 16-битный grayscale с tRNS - **THEN** прозрачные пиксели `thumbnail`, `crop` и `optimized` белые, непрозрачные сохраняют цвет с учётом кодирования; соседнее непрозрачное значение 16-битного grayscale не становится прозрачным при округлении до 8 бит +#### Scenario: Исходная глубина tRNS + +- **WHEN** обрабатываются допустимые PNG grayscale 2/4 бита с ненулевым tRNS или RGB16 с tRNS, включая фильтры 0–4, Adam7 и EXIF orientation +- **THEN** во всех вариантах v1/v2 прозрачные области белые, а пиксели, отличающиеся от tRNS только младшим битом любого канала RGB16, остаются непрозрачными; ориентация, размеры и цвета соответствуют исходнику с явно наложенной на белый фон прозрачностью + ### Requirement: Пределы обработки изображения в worker Worker SHALL ограничивать обработку одного задания: размер оригинала — `MAX_UPLOAD_BYTES`, число пикселей по заголовку до декодирования — `MAX_IMAGE_PIXELS`, время рендера — `RENDER_TIMEOUT_SECONDS`, адресное пространство процесса рендера — `RENDER_MEMORY_MB`; рендер SHALL выполняться в отдельном процессе, число одновременных рендеров SHALL не превышать `WORKER_CONCURRENCY`, а процесс worker SHALL иметь предел памяти контейнера не меньше суммы пределов рендеров и собственной памяти. Превышение предела SHALL переводить вложение в `failed` с `processing_failed` без повторов; процесс, превысивший время, SHALL принудительно завершаться. Падение процесса рендера по внешней причине SHALL считаться временной ошибкой. Worker SHALL продолжать обрабатывать другие задания после любого из этих исходов. diff --git a/src/messenger/attachments/infrastructure/images.py b/src/messenger/attachments/infrastructure/images.py index 81d40e65..fef1f456 100644 --- a/src/messenger/attachments/infrastructure/images.py +++ b/src/messenger/attachments/infrastructure/images.py @@ -8,7 +8,8 @@ from concurrent.futures.process import BrokenProcessPool from dataclasses import dataclass from io import BytesIO -from PIL import Image, ImageOps +from PIL import Image, ImageChops, ImageOps +from PIL.PngImagePlugin import PngImageFile from messenger.attachments.application.ports import Rendition from messenger.attachments.domain.errors import ( @@ -39,6 +40,7 @@ JPEG = {1: {"quality": 85, "optimize": True}, 2: {"quality": 90, "optimize": Tru WEBP = {1: {"quality": 80, "method": 4}, 2: {"quality": 85, "method": 4}} ENCODINGS = {"JPEG": (ImageKind.JPEG.value, "jpg"), "WEBP": ("image/webp", "webp")} REDUCING_GAP = 3.0 +PNG_WIDE_DEPTH = 16 @dataclass(frozen=True, slots=True) @@ -86,6 +88,32 @@ class PillowImageInspector: return ImageInfo(kind, width, height) +def rgb_mask(image: Image.Image, color: tuple[int, ...]) -> Image.Image: + mask = Image.new("L", image.size, 255) + for channel, value in zip("RGB", color, strict=True): + mask = ImageChops.multiply( + mask, image.getchannel(channel).point([255 if i == value else 0 for i in range(256)]) + ) + return mask + + +def apply_png_transparency(image: PngImageFile, data: bytes) -> None: + if (transparent := image.info.get("transparency")) is None: + return + depth = read_png_header(data)[2] + if image.mode == "L" and depth in (2, 4): + image.info["transparency"] = transparent * 255 // ((1 << depth) - 1) + elif image.mode == "RGB" and depth == PNG_WIDE_DEPTH: + with PngImageFile(BytesIO(data)) as low: + low.tile = [tile._replace(args="RGB;16L") for tile in low.tile] + mask = rgb_mask(low, tuple(value & 255 for value in transparent)) + mask = ImageChops.multiply( + mask, rgb_mask(image, tuple(value >> 8 for value in transparent)) + ) + image.paste((255, 255, 255), mask=mask) + image.info.pop("transparency") + + def flatten(image: Image.Image) -> Image.Image: if image.mode in WIDE_MODES: image = image.convert("I") @@ -122,6 +150,8 @@ def decoded(data: bytes, max_pixels: int) -> tuple[Image.Image, int, int]: width, height = image.size if width * height > max_pixels: raise UnreadableImage("изображение больше допустимого числа пикселей") + if isinstance(image, PngImageFile): + apply_png_transparency(image, data) image.draft(None, fit(width, height, OPTIMIZED_BOX)) stored = image.size ImageOps.exif_transpose(image, in_place=True) diff --git a/student-tests/png_trns_fixtures.py b/student-tests/png_trns_fixtures.py new file mode 100644 index 00000000..30f8e6d3 --- /dev/null +++ b/student-tests/png_trns_fixtures.py @@ -0,0 +1,104 @@ +import struct +import zlib +from io import BytesIO + +from PIL import Image + +from pictures import SIGNATURE, chunk + +PASSES = ( + (0, 0, 8, 8), + (4, 0, 8, 8), + (0, 4, 4, 8), + (2, 0, 4, 4), + (0, 2, 2, 4), + (1, 0, 2, 2), + (0, 1, 1, 2), +) + + +def packed(samples: list[int], depth: int) -> bytes: + if depth >= 8: + return b"".join(value.to_bytes(depth // 8, "big") for value in samples) + per_byte = 8 // depth + padded = samples + [0] * (-len(samples) % per_byte) + return bytes( + sum(value << (8 - depth * (i + 1)) for i, value in enumerate(padded[j : j + per_byte])) + for j in range(0, len(padded), per_byte) + ) + + +def filtered(row: bytes, previous: bytes, bpp: int, method: int) -> bytes: + result = bytearray([method]) + for i, value in enumerate(row): + left = row[i - bpp] if i >= bpp else 0 + above = previous[i] + corner = previous[i - bpp] if i >= bpp else 0 + estimate = left + above - corner + paeth = min((left, above, corner), key=lambda candidate: abs(estimate - candidate)) + predictor = (0, left, above, (left + above) // 2, paeth)[method] + result.append((value - predictor) % 256) + return bytes(result) + + +def png_with_trns( + depth: int, + transparent: tuple[int, ...], + *, + size: tuple[int, int] = (64, 64), + filtering: int = 0, + interlace: int = 0, + orientation: int = 1, +) -> tuple[bytes, bytes]: + width, height = size + neighbors = [ + tuple(value ^ (1 << bit) if i == channel else value for i, value in enumerate(transparent)) + for bit in ([0, 8] if depth == 16 else [0]) + for channel in range(len(transparent)) + ] + neighbors.insert(0, ((transparent[0] + 1) % (1 << depth), *transparent[1:])) + pixels = [ + [ + transparent if x < (width + 1) // 2 else neighbors[(y // 8) % len(neighbors)] + for x in range(width) + ] + for y in range(height) + ] + raw = bytearray() + for x0, y0, dx, dy in PASSES if interlace else ((0, 0, 1, 1),): + columns = range(x0, width, dx) + if not columns: + continue + previous = bytes((len(columns) * len(transparent) * depth + 7) // 8) + for y in range(y0, height, dy): + row = packed([value for x in columns for value in pixels[y][x]], depth) + raw.extend(filtered(row, previous, max(1, len(transparent) * depth // 8), filtering)) + previous = row + header = struct.pack( + ">IIBBBBB", width, height, depth, 0 if len(transparent) == 1 else 2, 0, 0, interlace + ) + exif = Image.Exif() + exif[0x0112] = orientation + compressed = zlib.compress(raw) + data = ( + SIGNATURE + + chunk(b"IHDR", header) + + chunk(b"tRNS", b"".join(value.to_bytes(2, "big") for value in transparent)) + + chunk(b"eXIf", exif.tobytes()[6:]) + + b"".join(chunk(b"IDAT", compressed[i : i + 7]) for i in range(0, len(compressed), 7)) + + chunk(b"IEND", b"") + ) + expected = bytearray() + for row in pixels: + for pixel in row: + channels = tuple( + v >> 8 if depth == 16 else v * 255 // ((1 << depth) - 1) for v in pixel + ) + expected.extend( + (255, 255, 255) + if pixel == transparent + else channels * (3 if len(channels) == 1 else 1) + ) + buffer = BytesIO() + Image.frombytes("RGB", size, expected).save(buffer, "PNG", exif=exif) + return data, buffer.getvalue() diff --git a/student-tests/unit/test_png_transparency.py b/student-tests/unit/test_png_transparency.py new file mode 100644 index 00000000..b72185dc --- /dev/null +++ b/student-tests/unit/test_png_transparency.py @@ -0,0 +1,67 @@ +from io import BytesIO + +import pytest +from PIL import Image + +from messenger.attachments.domain.values import ImageKind +from messenger.attachments.infrastructure.images import ( + PillowImageInspector, + RenderLimits, + render_variants, +) +from png_trns_fixtures import png_with_trns + +LIMITS = RenderLimits(10_485_760, 40_000_000) + + +@pytest.mark.parametrize("version", [1, 2]) +@pytest.mark.parametrize("depth,transparent", [(2, (1,)), (4, (5,)), (16, (12345, 23456, 34567))]) +async def test_review_samples_have_white_transparency( + version: int, depth: int, transparent: tuple[int, ...] +) -> None: + data, reference = png_with_trns(depth, transparent) + info = await PillowImageInspector(LIMITS.max_pixels, 1).inspect(data, ImageKind.PNG) + assert (info.width, info.height) == (64, 64) + variants = render_variants(data, LIMITS, version) + for variant in variants: + with Image.open(BytesIO(variant.data)) as image: + assert image.getpixel((5, image.height // 2)) == (255, 255, 255), variant.name + assert variants == render_variants(reference, LIMITS, version) + + +@pytest.mark.parametrize("version", [1, 2]) +@pytest.mark.parametrize( + "depth,key", + [(depth, key) for depth in (1, 2, 4) for key in range(1 << depth)] + + [(8, 0), (8, 85), (8, 255), (16, 0), (16, 12345), (16, 65535)], +) +def test_grayscale_keys_preserve_opaque_neighbors(version: int, depth: int, key: int) -> None: + data, reference = png_with_trns(depth, (key,)) + assert render_variants(data, LIMITS, version) == render_variants(reference, LIMITS, version) + + +@pytest.mark.parametrize("version", [1, 2]) +@pytest.mark.parametrize("interlace", [0, 1]) +@pytest.mark.parametrize("filtering", range(5)) +@pytest.mark.parametrize("depth,transparent", [(2, (1,)), (4, (5,)), (16, (12345, 23456, 34567))]) +async def test_png_filters_and_adam7_preserve_exact_samples( + version: int, interlace: int, filtering: int, depth: int, transparent: tuple[int, ...] +) -> None: + data, reference = png_with_trns( + depth, transparent, size=(65, 63), interlace=interlace, filtering=filtering + ) + info = await PillowImageInspector(LIMITS.max_pixels, 1).inspect(data, ImageKind.PNG) + assert (info.width, info.height) == (65, 63) + assert render_variants(data, LIMITS, version) == render_variants(reference, LIMITS, version) + + +@pytest.mark.parametrize("version", [1, 2]) +@pytest.mark.parametrize("size", [(1, 1), (1, 9), (9, 1), (65, 63)]) +@pytest.mark.parametrize("transparent", [(0, 0, 0), (123, 234, 45), (65535, 65535, 65535)]) +def test_rgb16_small_passes_orientation_and_key_extremes( + version: int, size: tuple[int, int], transparent: tuple[int, ...] +) -> None: + data, reference = png_with_trns( + 16, transparent, size=size, interlace=1, filtering=4, orientation=6 + ) + assert render_variants(data, LIMITS, version) == render_variants(reference, LIMITS, version)