diff --git a/evidence/README.md b/evidence/README.md index 07fc1615..8020c003 100644 --- a/evidence/README.md +++ b/evidence/README.md @@ -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`. diff --git a/evidence/png-header-fix/NOTES.md b/evidence/png-header-fix/NOTES.md index d6ecf15c..34a04be0 100644 --- a/evidence/png-header-fix/NOTES.md +++ b/evidence/png-header-fix/NOTES.md @@ -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. diff --git a/evidence/png-header-fix/check-final.txt b/evidence/png-header-fix/check-final.txt new file mode 100644 index 00000000..9a553306 --- /dev/null +++ b/evidence/png-header-fix/check-final.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/png-header-fix/lint-final.txt b/evidence/png-header-fix/lint-final.txt new file mode 100644 index 00000000..593113ec --- /dev/null +++ b/evidence/png-header-fix/lint-final.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 +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! diff --git a/evidence/png-header-fix/manifest.json b/evidence/png-header-fix/manifest.json new file mode 100644 index 00000000..74269d62 --- /dev/null +++ b/evidence/png-header-fix/manifest.json @@ -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" +} diff --git a/evidence/png-header-fix/openspec-final.txt b/evidence/png-header-fix/openspec-final.txt new file mode 100644 index 00000000..401b6b9c --- /dev/null +++ b/evidence/png-header-fix/openspec-final.txt @@ -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) diff --git a/evidence/png-header-fix/specs-sync.txt b/evidence/png-header-fix/specs-sync.txt new file mode 100644 index 00000000..401b6b9c --- /dev/null +++ b/evidence/png-header-fix/specs-sync.txt @@ -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) diff --git a/openspec/changes/fix-png-header-consistency/.openspec.yaml b/openspec/changes/archive/2026-11-06-fix-png-header-consistency/.openspec.yaml similarity index 58% rename from openspec/changes/fix-png-header-consistency/.openspec.yaml rename to openspec/changes/archive/2026-11-06-fix-png-header-consistency/.openspec.yaml index 8a94d769..b831b2c0 100644 --- a/openspec/changes/fix-png-header-consistency/.openspec.yaml +++ b/openspec/changes/archive/2026-11-06-fix-png-header-consistency/.openspec.yaml @@ -1,2 +1,4 @@ schema: spec-driven created: 2026-11-06 +archived: 2026-11-06 +lab: 4 diff --git a/openspec/changes/fix-png-header-consistency/design.md b/openspec/changes/archive/2026-11-06-fix-png-header-consistency/design.md similarity index 100% rename from openspec/changes/fix-png-header-consistency/design.md rename to openspec/changes/archive/2026-11-06-fix-png-header-consistency/design.md diff --git a/openspec/changes/fix-png-header-consistency/proposal.md b/openspec/changes/archive/2026-11-06-fix-png-header-consistency/proposal.md similarity index 100% rename from openspec/changes/fix-png-header-consistency/proposal.md rename to openspec/changes/archive/2026-11-06-fix-png-header-consistency/proposal.md diff --git a/openspec/changes/fix-png-header-consistency/specs/lab4-attachments/spec.md b/openspec/changes/archive/2026-11-06-fix-png-header-consistency/specs/lab4-attachments/spec.md similarity index 100% rename from openspec/changes/fix-png-header-consistency/specs/lab4-attachments/spec.md rename to openspec/changes/archive/2026-11-06-fix-png-header-consistency/specs/lab4-attachments/spec.md diff --git a/openspec/changes/fix-png-header-consistency/tasks.md b/openspec/changes/archive/2026-11-06-fix-png-header-consistency/tasks.md similarity index 95% rename from openspec/changes/fix-png-header-consistency/tasks.md rename to openspec/changes/archive/2026-11-06-fix-png-header-consistency/tasks.md index 221dfb95..a187cda7 100644 --- a/openspec/changes/fix-png-header-consistency/tasks.md +++ b/openspec/changes/archive/2026-11-06-fix-png-header-consistency/tasks.md @@ -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. diff --git a/openspec/specs/lab4-attachments/spec.md b/openspec/specs/lab4-attachments/spec.md index 65b0f549..24abc3b9 100644 --- a/openspec/specs/lab4-attachments/spec.md +++ b/openspec/specs/lab4-attachments/spec.md @@ -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 использоваться только для отображения и возвращаться без изменений.