Archive the PNG header consistency change

This commit is contained in:
Artyom
2026-11-06 21:34:36 +03:00
parent 7c8a1a6489
commit 7a0ebac2aa
13 changed files with 88 additions and 2 deletions
+8
View File
@@ -1,3 +1,11 @@
# Повторный IHDR: второе исправление PNG
Код: `7c8a1a64899dc0a1b5fa0949c0992ef40722eacf`.
[Причина, 407 offline-тестов и обязательные финальные проверки](png-header-fix/NOTES.md).
Повторный IHDR отклоняется до распаковки и записи; размеры, лимит и проверка строк используют
один заголовок. Динамические проверки обоих PNG-фиксов остаются финальному агенту и выполняются
одним прогоном на итоговом коде. SHA и blob-хеши — в `png-header-fix/manifest.json`.
# Исправление PNG после независимого ревью
Код: `9387c3d82ab77ea376eecce19a36a22803d35efb`.
+4 -1
View File
@@ -1,8 +1,10 @@
# Исправление major: повторный IHDR в PNG
Исходный snapshot: `7342d5d97a5e50659a6c44c56d5a87e62aa87c1f`.
OpenSpec proposal: `bcbd4ebc02bfb6233a998e983377c0fc655be8bf`.
Код и тесты: `7c8a1a64899dc0a1b5fa0949c0992ef40722eacf`.
Среда: существующая `.venv`, Python 3.14.5, Pillow 13.0.0, macOS. Окружения не устанавливались.
SHA реализации и Git blob-хеши изменённых файлов фиксируются в `manifest.json` при архивации; архивный коммит меняет только документы и evidence.
SHA реализации и Git blob-хеши семи изменённых файлов зафиксированы в `manifest.json`; архивный коммит меняет только документы и evidence. Цикл синхронизирован и закрыт в `openspec/changes/archive/2026-11-06-fix-png-header-consistency/`.
## Причина и результат
@@ -27,6 +29,7 @@ SHA реализации и Git blob-хеши изменённых файлов
| `make validate` | PASS: OpenAPI 3.1 и JSON Schema | `validate.txt` |
| `make lint` | PASS: ruff check/format (166 файлов), ty | `lint.txt` |
| `openspec validate --all --strict --no-interactive` до архивации | 19 passed, 0 failed | `openspec.txt` |
| `openspec validate --all --strict --no-interactive` после синхронизации и архивации | 18 passed, 0 failed | `openspec-final.txt` |
| Прямые вызовы функций `test_*` через `runpy.run_path('student-tests/api/test_bounded_contexts.py')` | 19 статических проверок границ PASS; pytest-fixture БД не вызывалась | `boundaries.txt` |
Новые проверки покрывают одинаковый IHDR, изменение размеров/глубины/цвета/interlace, повтор до, между и после IDAT, заголовок не первым чанком и неверную длину. Существующая матрица PNG/Adam7, фильтров, лимита 40 MP и ограниченных Python-аллокаций проходит. Это не замер RSS/cgroup и не проверка реальных PostgreSQL/RustFS/LB.
+2
View File
@@ -0,0 +1,2 @@
python3 scripts/check_contract.py
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
+6
View File
@@ -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
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
166 files already formatted
.venv/bin/ty check src student-tests alembic
All checks passed!
+22
View File
@@ -0,0 +1,22 @@
{
"source_sha": "7342d5d97a5e50659a6c44c56d5a87e62aa87c1f",
"proposal_sha": "bcbd4ebc02bfb6233a998e983377c0fc655be8bf",
"implementation_sha": "7c8a1a64899dc0a1b5fa0949c0992ef40722eacf",
"files": {
"src/messenger/attachments/infrastructure/images.py": "ad42b3f0a6cbce20f2a96c47f788720048180b23",
"src/messenger/attachments/infrastructure/png.py": "1e38495678224e15f02ff7af3b98f42294f837d6",
"student-tests/api/test_attachments.py": "ca64f2ce73d6a707736c395f1b00c67cc87e9216",
"student-tests/pictures.py": "4cd6a9e892a9c29b9efd3f7b2244ea0e8c5907d4",
"student-tests/stack/test_attachment_faults.py": "22a6ca91a6496345e22e8a2b1a453e6811da70af",
"student-tests/unit/test_image_inspection.py": "dfacb272391ebdfb572178f5dc76a07b4de5b8fb",
"student-tests/unit/test_png_upload.py": "bf026762eda2bc5d4b1b99c70ed699f2cded407a"
},
"environment": {
"python": "3.14.5",
"pillow": "13.0.0",
"environment_installed": false,
"docker_executed": false
},
"evidence": "NOTES.md",
"archive": "openspec/changes/archive/2026-11-06-fix-png-header-consistency"
}
@@ -0,0 +1,19 @@
✓ 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-evidence-runs
✓ spec/lab4-object-storage
✓ spec/lab4-storage-reconciler
✓ spec/lab4-upload-resilience
Totals: 18 passed, 0 failed (18 items)
+19
View File
@@ -0,0 +1,19 @@
✓ 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-evidence-runs
✓ spec/lab4-object-storage
✓ spec/lab4-storage-reconciler
✓ spec/lab4-upload-resilience
Totals: 18 passed, 0 failed (18 items)
@@ -1,2 +1,4 @@
schema: spec-driven
created: 2026-11-06
archived: 2026-11-06
lab: 4
@@ -8,4 +8,4 @@
- [x] 2.1 Выполнить unit-suite, статические границы зон, make check, make validate, make lint и строгую OpenSpec validation; сохранить реальные выводы.
- [x] 2.2 Записать область применимости прежних evidence и обязательные динамические проверки финального этапа без их запуска; сохранить известный minor в заметках.
- [ ] 2.3 Синхронизировать спецификацию, архивировать цикл и зафиксировать английские коммиты после make lint.
- [x] 2.3 Синхронизировать спецификацию, архивировать цикл и зафиксировать английские коммиты после make lint.
+5
View File
@@ -90,6 +90,11 @@
- **WHEN** участник загружает корректный PNG в пределах лимитов, в том числе Adam7, с разрешёнными глубиной цвета и фильтрами, а IDAT разделён на несколько чанков
- **THEN** ответ `201 ready`, скачивание другим участником возвращает исходные байты
#### Scenario: Неоднозначный заголовок PNG
- **WHEN** участник отправляет PNG с повторным IHDR до IEND, даже при одинаковых размерах и корректных CRC, или с IHDR не первым чанком
- **THEN** `POST /api/v1/chats/{chat_id}/attachments` отвечает `415` с кодом `unsupported_media_type`, `X-Request-Id` и `X-Instance-Id`; строка вложения и объект не создаются
### Requirement: Безопасное отображаемое имя
`filename` SHALL быть обязательным параметром длиной 1–255 Unicode code points после percent-декодирования, SHALL NOT состоять только из пробельных символов и SHALL NOT содержать `/`, `\`, NUL и другие управляющие символы. Нарушение SHALL давать `400` с кодом `invalid_request`. Имя SHALL использоваться только для отображения и возвращаться без изменений.