From 276dbdad8a34da4c5b57fbf1879ca169b581d75b Mon Sep 17 00:00:00 2001 From: Mikhail Verkovykh Date: Thu, 10 Sep 2026 18:01:35 +0300 Subject: [PATCH 01/52] =?UTF-8?q?=D0=9F=D0=BE=D0=B4=D0=B3=D0=BE=D1=82?= =?UTF-8?q?=D0=BE=D0=B2=D0=B8=D1=82=D1=8C=20skeleton=20=D0=BB=D0=B0=D0=B1?= =?UTF-8?q?=D0=BE=D1=80=D0=B0=D1=82=D0=BE=D1=80=D0=BD=D0=BE=D0=B9=205=20?= =?UTF-8?q?=D0=BF=D0=BE=20=D0=BC=D0=B5=D1=81=D1=81=D0=B5=D0=BD=D0=B4=D0=B6?= =?UTF-8?q?=D0=B5=D1=80=D1=83?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .dockerignore | 20 + .env.example | 25 + .github/pull_request_template.md | 18 + .github/workflows/contracts.yml | 16 + .gitignore | 32 + CONTRIBUTING.md | 19 + COURSE.md | 53 + Dockerfile.example | 8 + MAINTAINERS.md | 38 + Makefile | 30 + README.md | 105 + REPORT.md | 37 + compose.example.yaml | 14 + contracts/README.md | 61 + contracts/attachment-states.md | 21 + contracts/examples.json | 60 + contracts/infrastructure.json | 62 + contracts/jobs.schema.json | 63 + contracts/openapi.json | 3512 ++++++++++++++++++++++++++++++ evidence/README.md | 5 + examples/requests.http | 53 + infra/README.md | 7 + lab.json | 8 + requirements-dev.txt | 2 + scripts/check_contract.py | 54 + scripts/restart.example.sh | 10 + scripts/stop-one.example.sh | 10 + scripts/validate_openapi.py | 23 + tests/README.md | 57 + tests/client.py | 217 ++ tests/fixtures/README.md | 9 + tests/fixtures/sample.png | Bin 0 -> 111817 bytes tests/image_probe.py | 26 + tests/load.py | 58 + tests/resilience.py | 129 ++ tests/smoke.py | 82 + 36 files changed, 4944 insertions(+) create mode 100644 .dockerignore create mode 100644 .env.example create mode 100644 .github/pull_request_template.md create mode 100644 .github/workflows/contracts.yml create mode 100644 .gitignore create mode 100644 CONTRIBUTING.md create mode 100644 COURSE.md create mode 100644 Dockerfile.example create mode 100644 MAINTAINERS.md create mode 100644 Makefile create mode 100644 README.md create mode 100644 REPORT.md create mode 100644 compose.example.yaml create mode 100644 contracts/README.md create mode 100644 contracts/attachment-states.md create mode 100644 contracts/examples.json create mode 100644 contracts/infrastructure.json create mode 100644 contracts/jobs.schema.json create mode 100644 contracts/openapi.json create mode 100644 evidence/README.md create mode 100644 examples/requests.http create mode 100644 infra/README.md create mode 100644 lab.json create mode 100644 requirements-dev.txt create mode 100644 scripts/check_contract.py create mode 100755 scripts/restart.example.sh create mode 100755 scripts/stop-one.example.sh create mode 100644 scripts/validate_openapi.py create mode 100644 tests/README.md create mode 100644 tests/client.py create mode 100644 tests/fixtures/README.md create mode 100644 tests/fixtures/sample.png create mode 100644 tests/image_probe.py create mode 100644 tests/load.py create mode 100644 tests/resilience.py create mode 100644 tests/smoke.py diff --git a/.dockerignore b/.dockerignore new file mode 100644 index 00000000..bc16e556 --- /dev/null +++ b/.dockerignore @@ -0,0 +1,20 @@ +.git +.github +.env +.env.* +!.env.example +secrets +certs +volumes +data +backups +*.key +*.pem +*.p12 +*.pfx +*.jks +.venv +__pycache__ +node_modules +evidence +.DS_Store diff --git a/.env.example b/.env.example new file mode 100644 index 00000000..119384b5 --- /dev/null +++ b/.env.example @@ -0,0 +1,25 @@ +# Copy to .env for your LOCAL synthetic test environment; never commit .env. +# These are logical interface suggestions; map actual framework names in REPORT.md. +APP_HOST=0.0.0.0 +APP_PORT=8080 +APP_ENV=lab +SESSION_TTL_SECONDS=3600 +# Choose credentials locally. File paths contain no secret values. +DATABASE_URL_FILE=/run/secrets/database_url +# Optional on 3, required use on 4 in lab2; Redis OR Valkey: +SESSION_STORE=postgres +CACHE_URL_FILE=/run/secrets/cache_url +API_REPLICAS=2 +IDEMPOTENCY_TTL_SECONDS=86400 +S3_ENDPOINT=http://s3:9000 +S3_REGION=us-east-1 +S3_BUCKET=messenger-attachments +S3_ACCESS_KEY_ID_FILE=/run/secrets/s3_access_key_id +S3_SECRET_ACCESS_KEY_FILE=/run/secrets/s3_secret_access_key +MAX_UPLOAD_BYTES=10485760 +MAX_IMAGE_PIXELS=40000000 +BROKER_URL_FILE=/run/secrets/broker_url +WORKER_CONCURRENCY=2 +JOB_MAX_ATTEMPTS=5 +JOB_TIMEOUT_SECONDS=60 +STAGING_RETENTION_SECONDS=86400 diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md new file mode 100644 index 00000000..7d1ff4a4 --- /dev/null +++ b/.github/pull_request_template.md @@ -0,0 +1,18 @@ +## Лабораторная 5 + +Автор / группа: TODO +Целевая оценка (3/4/5): TODO +Трек 5, если заявлен: TODO + +Что реализовано и что перенесено: TODO +Команды запуска из чистого clone: TODO +Результаты проверок и ссылка на REPORT.md: TODO +Ограничения / известные ошибки: TODO +Источники и использование ИИ: TODO + +- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. +- [ ] Контракт и публичные тесты не ослаблены. +- [ ] make check и make test выполнены; приложен реальный вывод. +- [ ] Сценарии отказов/безопасности своего уровня воспроизведены. +- [ ] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. +- [ ] README задания сохранён, REPORT.md содержит инструкцию именно моего решения. diff --git a/.github/workflows/contracts.yml b/.github/workflows/contracts.yml new file mode 100644 index 00000000..11cf289f --- /dev/null +++ b/.github/workflows/contracts.yml @@ -0,0 +1,16 @@ +name: Skeleton contracts +on: [push, pull_request] +permissions: + contents: read +jobs: + contracts: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-python@v5 + with: + python-version: '3.12' + - run: python -m pip install -r requirements-dev.txt + - run: make check validate PYTHON=python +# This job validates the skeleton, not a student solution. +# Add build, readiness and make test in a separate application job. diff --git a/.gitignore b/.gitignore new file mode 100644 index 00000000..b5a71896 --- /dev/null +++ b/.gitignore @@ -0,0 +1,32 @@ +# Local/private state +.env +.env.* +!.env.example +secrets/ +certs/private/ +*.key +*.p12 +*.pfx +*.jks +*.pem +*.tfstate* +volumes/ +data/ +backups/ +# Runtime/build artifacts +.venv/ +__pycache__/ +*.py[cod] +node_modules/ +dist/ +build/ +target/ +bin/ +obj/ +coverage/ +*.log +.DS_Store +.idea/ +.vscode/ +# Keep small, sanitized evidence summaries in evidence/ under version control. +# Inspect git diff --cached: ignore rules are not a secret scanner. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 00000000..ee5533d1 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,19 @@ +# Работа через fork и pull request + +1. После публикации преподавателем сделайте fork репозитория **текущей** лабораторной в своём аккаунте и clone своего fork. URL преподаватель выдаёт отдельно. +2. Создайте ветку `solution/-` от исходной ветки skeleton. Ветка преподавателя и файлы контракта остаются основой проверки. +3. Для lab2–7 перенесите из своей предыдущей лабы только исходники, миграции, собственные тесты, Dockerfile и нужные конфигурации. Не копируйте `.git`, `.env`, credentials, volumes, `README.md`, `COURSE.md`, публичные `tests/` и `contracts/` поверх новой версии. Сначала сравните изменения API в `COURSE.md`. +4. Реализуйте задание, добавьте свою инструкцию запуска и заполните `REPORT.md`. Публичные проверки дополняйте отдельными тестами, не ослабляйте assertions. +5. Выполните `make check`, запустите свой стенд, затем `make test`. Выполните сценарии отказов текущей лабы. Их запуск всегда явный: scaffold сам не останавливает контейнеры. +6. Commit и push делайте в свой fork. Откройте PR в исходный репозиторий преподавателя, заголовок: `ЛР N — Группа — Фамилия — на 3/4/5`. Выберите правильную базовую ветку и заполните шаблон. +7. После замечаний обновляйте тот же PR. Чужие решения не переносите без указания источника и согласованных правил курса. + +Платформа может называть PR «merge request» — процесс тот же. `.github/` содержит необязательные удобства для GitHub; проверки локально от платформы не зависят. Инициализация и публикация исходных Git-репозиториев выполняются преподавателем отдельно. + +## Правила изменения skeleton + +Не удаляйте обязательные endpoint, поля, рубрику и публичные проверки. Изменение контракта согласуйте отдельным комментарием/PR; обход тестов не является решением. Код приложения размещайте в `src/` либо в принятой для языка структуре. Собственные тесты — `student-tests/` или штатный каталог фреймворка. Ссылки на результаты проверки и команды запуска должны переживать clone на другой машине. + +## CI + +Готовый GitHub workflow проверяет целостность контракта и синтаксис Python-проверок. Он **не запускает отсутствующее приложение** и **не подтверждает оценку**. Студент добавляет сборку своего приложения, запуск/готовность стенда и `make test` в отдельный job. Не используйте `pull_request_target` для запуска кода из fork, не выдавайте CI секреты или доступ к общему Docker-host. diff --git a/COURSE.md b/COURSE.md new file mode 100644 index 00000000..b02172bb --- /dev/null +++ b/COURSE.md @@ -0,0 +1,53 @@ +# Сквозной проект: мессенджер под нагрузкой + +Семь самостоятельных репозиториев содержат задания и проверяемые контракты одной системы. Вы переносите собственную реализацию между лабораторными. Язык, фреймворк и библиотеки выбираете сами. Web UI, WebSocket, редактирование/удаление сообщений, публичный поиск пользователей и Kubernetes не входят в обязательный минимум: достаточно REST API. + +| Лаба | Новая инженерная задача | Что появляется в системе | +| --- | --- | --- | +| 1 | Контракт, процессы и контейнер | In-memory API, Dockerfile, HTTP smoke | +| 2 | Сохранность и идентификация | PostgreSQL, Basic → сессия; Redis/Valkey на 4 | +| 3 | Горизонтальное масштабирование | Балансировщик, ≥2 API-реплики, общие сессии, идемпотентность | +| 4 | Бинарные данные | Приватное S3-совместимое хранилище и вложения | +| 5 | Фоновая работа | Брокер, worker, состояния вложений и преобразование изображений | +| 6 | Диагностика | OTel Collector, хранилища сигналов, Grafana | +| 7 | Защита и эксплуатация | Argon2id, TLS/mTLS, OpenBao, минимальные привилегии | + +## Как оценивать + +Оценки накопительные **внутри лабораторной**: 4 = весь уровень 3 + весь уровень 4; 5 = весь уровень 4 + **один** полностью выполненный трек 5 на выбор. Несколько недоделанных треков не заменяют один завершённый. Условие «весь уровень» включает реализацию, проверку и объяснение на защите. Красивые схемы и дополнительные технологии не компенсируют неработающий обязательный сценарий. + +Для начала следующей лабы достаточно обязательного минимума предыдущей. Сохраняются предыдущие обязательные возможности, с явно описанными переходами API ниже. Не требуется сначала получить 5 за все ранние лабы. Можно исправлять свою базу по ходу курса; такие исправления выделяйте в PR. Реализация на 3 работоспособна, но не претендует на промышленную готовность. Даже 5 в lab7 — учебная доказанная защита в заявленной модели угроз, а не сертификат полной безопасности. + +На 3 студент самостоятельно собирает рабочую систему. На 4 показывает практики, ожидаемые от стажёра/джуна в команде: воспроизводимость, диагностику, обработку ошибок и проверки отказов. На 5 формулирует гипотезу, ставит эксперимент, приводит измерения и обсуждает границы решения — это предмет конкретной похвалы магистранту. + +## Контракт и совместимость + +`contracts/openapi.json` — OpenAPI 3.1.0, `contracts/README.md` — нормативная семантика. Контракт каждого репозитория самодостаточен; соседние папки на машине преподавателя не нужны. `tests/` — публичные проверки, а не эталонное решение. Контракт, рубрика и публичные тесты имеют приоритет над случайным поведением библиотек. При противоречии создайте вопрос преподавателю; не подгоняйте тест под приложение. + +Три объявленных изменения обязательного API: + +1. **1 → 2:** регистрация требует `password`; `X-User-Id` заменяется Bearer. Basic используется только при создании сессии. +2. **2 → 3:** `Idempotency-Key` обязателен для отправки сообщения; ответы API содержат `X-Instance-Id`. +3. **4 → 5:** загрузка вложения возвращает `202` вместо `201`, состояние становится асинхронным. Клиент опрашивает метаданные. Старое текстовое сообщение остаётся валидным: `attachment_ids` по умолчанию `[]`. + +У lab7 меняется транспорт на HTTPS, бизнес-эндпоинты остаются прежними. Внутреннее mTLS не заменяет пользовательскую сессию. Новые возможности на 4/5 добавляйте обратно совместимо, в отдельном `contracts/extensions.openapi.json` или документе; обязательный контракт сохраняйте. + +## Общая предметная модель + +Пользователь (`username`, `display_name`) состоит в чатах. Список участников задаётся при создании чата и в обязательном API не изменяется. В чате отправляются сообщения, с lab4 — со ссылками на вложения этого чата. Сервер назначает UUID и время. Порядок истории — `(created_at, id)` по возрастанию. Для защиты достаточно показать взаимодействие нескольких API-клиентов; фронтенд не требуется. + +С lab2 данные PostgreSQL — источник истины. Сессии могут храниться в PostgreSQL или Redis/Valkey, если выполняют контракт срока жизни и перезапуска. Файлы с lab4 живут в S3, метаданные — в PostgreSQL. Redis и Valkey — альтернативы: оба одновременно не нужны. Аналогично выбирается одно S3-хранилище, один брокер и один основной путь оркестрации. + +## Воспроизводимость и честные измерения + +- Укажите версии runtime и контейнерных образов, аппаратную конфигурацию, CPU/RAM-лимиты, команду запуска и время прогрева. Для образов используйте явный тег версии или digest, не `latest`. +- Все тестовые пользователи и изображения синтетические. `make test` создаёт данные: запускайте его на учебном стенде. Не публикуйте пароли, токены, приватные ключи, персональные данные или подписанные URL. +- Минимальный отчёт о нагрузке: длительность, конкуренция/интенсивность, успешные RPS, доля ошибок, p50/p95/p99, CPU/RAM, размер набора данных. Универсального проходного RPS для разных ноутбуков нет. +- Сравнивайте одинаковые запросы при одинаковых ресурсах. Успешный `/health/live` не доказывает сохранность сообщений, а HTTP `202` — окончание обработки. +- Один Docker-host не обеспечивает отказоустойчивость к потере этого host. Несколько API-процессов не делают единственную БД или LB высокодоступными. Отдельно называйте, какие отказы выдерживает эксперимент. + +## Что сдавать + +Исходники, Dockerfile, нужные манифесты и конфигурации, миграции, собственные тесты, заполненный `REPORT.md`, сведения об использовании внешнего кода и ИИ. Уметь объяснить и изменить своё решение на защите обязательно. Приложите команды и текстовые результаты; скриншоты — дополнение, а не единственное доказательство. + +PR должен собираться из чистого clone по инструкции автора. Секреты создаются отдельно; тестовые fixtures и открытые конфигурации хранятся в репозитории. Перенос кода между лабами описан в [CONTRIBUTING.md](CONTRIBUTING.md). diff --git a/Dockerfile.example b/Dockerfile.example new file mode 100644 index 00000000..e333a12e --- /dev/null +++ b/Dockerfile.example @@ -0,0 +1,8 @@ +# Teaching outline, not a runnable Dockerfile. Implement your own Dockerfile. +# 1. Choose a runtime/toolchain version and pin the base image tag/digest. +# 2. Copy dependency manifests first; install from the language lockfile. +# 3. Copy source and build. For compiled languages use a separate runtime stage. +# 4. Run the HTTP process as PID 1; listen on 0.0.0.0:8080. +# 5. Add non-root, signals and healthcheck according to the current rubric. +# 6. Pass runtime config/secrets at startup, never COPY .env or secret files. +# This file deliberately has no FROM/CMD: selecting/implementing them is the task. diff --git a/MAINTAINERS.md b/MAINTAINERS.md new file mode 100644 index 00000000..85601aee --- /dev/null +++ b/MAINTAINERS.md @@ -0,0 +1,38 @@ +# Памятка преподавателю — лабораторная 5 + +## Что подготовлено + +Язык реализации не задан. README содержит накопительные уровни 3/4/5, сценарий защиты и вопросы. В каждой лабе собственная полная версия OpenAPI, поэтому fork не зависит от соседних каталогов. Публичный HTTP smoke не содержит реализации сервера; Dockerfile.example и compose.example.yaml (если есть) — задания/ориентиры, не готовый deployment. + +## Перед публикацией + +1. Выберите GitHub/GitLab и организацию, опубликуйте каждый каталог как отдельный template/skeleton repository, сообщите студентам URL и правила именования PR/MR. Эти материалы не публикуют репозитории автоматически. +2. Задайте default branch, защиту исходных материалов и правила приёма. `.github/` уже содержит шаблон PR и CI контракта; в GitLab перенесите эквивалентные настройки, локальные Makefile-команды одинаковы. +3. Сообщите, индивидуальная работа или командная, сроки, правила использования стороннего кода/ИИ и ресурсы демонстрационного стенда. Эти организационные решения намеренно не выдуманы в задании. +4. Уточните ограничения площадки (например доступна ли виртуализация/несколько узлов). Для 5 предусмотрено по два трека: один можно выполнить без настоящего multi-node cloud. Универсальный проходной RPS не установлен. + +## Что проверять + +| Проверка | Что подтверждает | Чего не подтверждает | +| --- | --- | --- | +| make check | Структура файлов, JSON, локальные refs, синтаксис Python | Реализация/запуск API | +| make validate | Полная OpenAPI 3.1, JSON Schema и примеры | Поведение сервера | +| make test | Один сквозной контрактный сценарий текущей лабы | Все ошибки, persistence, HA, security | +| test-persistence (lab2+) | Данные/прежний токен после вызова restart hook | Реальный перезапуск, если hook — no-op | +| test-failover (lab3+) | Смена обслуживающей реплики, сохранность, retry без дубля | Несколько физических узлов, HA DB/LB | +| test-security (lab7) | Доверенный HTTPS и отказ недоверенного CA | Внутреннее mTLS/identity/ACL/OpenBao | +| Защита и тесты студента | Реальность инфраструктуры и критерии выбранного уровня | Неограниченная промышленная безопасность | + +Проверяйте реальные контейнеры/логи процессов и данные до/после отказа: одного X-Instance-Id недостаточно. Для 4 требуются все пункты 3+4, для 5 — все пункты 3+4 и один **завершённый** трек 5. Сравнивайте подтверждённые результаты со сформулированными критериями, а не количество установленных сервисов. + +## Приём PR + +Проверка запускается на изолированном учебном окружении с синтетическими secrets, не на общей production БД. Студенческие Dockerfile/hooks/CI — выполняемый код: обычный fork workflow без секретов и без доступа к общему Docker socket. Не запускайте PR через pull_request_target с привилегиями преподавателя. + +Исходные README/контракт/публичные tests сохраняются, реализация переносится студентом между лабами через собственные исходники и миграции. Исправление общей спецификации публикуйте отдельным изменением, объясняя влияние на все затронутые лабораторные. + +## Проверка этой версии skeleton + +На 2026-09-10 выполнены структурные проверки и полная валидация всех семи OpenAPI/JSON Schema, проверка локальных Markdown-ссылок/YAML и декодирование PNG fixture. HTTP-клиенты проверены на временном изолированном тестовом стенде: позитивный smoke 1–7, отрицательные варианты неправильного sender, pagination, ACL, logout, bytes и пустого API; также пути persistence/failover/load и внешнего TLS. + +Временный стенд не включён в студенческие каталоги и не является эталонным решением. Реальное приложение, Compose, PostgreSQL/S3/broker и mTLS/OpenBao в skeleton отсутствуют: их работоспособность не заявляется. Docker CLI в среде подготовки не был доступен. Это проверка материалов и тестовых драйверов, не приёмка будущих решений студентов. diff --git a/Makefile b/Makefile new file mode 100644 index 00000000..5d86d171 --- /dev/null +++ b/Makefile @@ -0,0 +1,30 @@ +PYTHON ?= python3 +BASE_URL ?= http://localhost:8080 +CA_FILE ?= +ACTION_SCRIPT ?= +TLS_ARGS = $(if $(CA_FILE),--ca-file "$(CA_FILE)",) + +.PHONY: help check validate test load test-persistence test-failover + +help: + @echo "check: offline structure; validate: full OpenAPI (requirements-dev.txt); test: running API; load: synthetic writes" + +check: + $(PYTHON) scripts/check_contract.py + +validate: + $(PYTHON) scripts/validate_openapi.py + +test: + $(PYTHON) tests/smoke.py --base-url "$(BASE_URL)" $(TLS_ARGS) + +load: + $(PYTHON) tests/load.py --base-url "$(BASE_URL)" $(TLS_ARGS) + +test-persistence: + @test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable restart hook"; exit 2) + $(PYTHON) tests/resilience.py --mode persistence --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS) + +test-failover: + @test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable stop-one hook"; exit 2) + $(PYTHON) tests/resilience.py --mode failover --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS) diff --git a/README.md b/README.md new file mode 100644 index 00000000..009d6997 --- /dev/null +++ b/README.md @@ -0,0 +1,105 @@ +# Лабораторная 5. Очереди и асинхронная обработка изображений + +Отделить приём файла от тяжёлой обработки, корректно переживать повторную доставку и остановку worker. + +Это **skeleton**, а не готовый сервер. Здесь есть задание, контракт и публичные проверки. Реализацию приложения, Dockerfile и требуемую инфраструктуру пишет студент. Язык и framework свободные; UI не обязателен. + +[Карта курса](COURSE.md) · [Процесс fork/PR](CONTRIBUTING.md) · [OpenAPI](contracts/openapi.json) · [Семантика API](contracts/README.md) · [Проверки](tests/README.md) · [Отчёт](REPORT.md) · [Примеры JSON](contracts/examples.json) · [Памятка преподавателю](MAINTAINERS.md) + +## Откуда начинаем + +Нужен минимум lab4. POST upload теперь возвращает 202 queued, а готовность выясняется через метаданные. В HTTP upload клиент по-прежнему передаёт все байты. + +**Архитектура:** API → устойчивый staging + запись задания → брокер → worker → конечный S3 + PostgreSQL. Клиент опрашивает статус. + +## Что сделать + +1. Выберите RabbitMQ, Redis/Valkey Streams, NATS JetStream или другой брокер с persistence и подтверждениями. Обычный Pub/Sub без хранения не подходит. +2. Разделите приём, durable staging, публикацию задания, обработку и фиксацию результата. Прочитайте contracts/attachment-states.md. +3. Реализуйте worker отдельно от API: публикация оригинала в конечный S3-prefix и thumbnail 256×256 по правилам контракта. +4. Добавьте конечные состояния, ограниченные повторы и идемпотентную запись результатов. Не помещайте bytes или credentials в сообщения брокера. +5. Остановите worker, загрузите файл, перезапустите API/worker, убедитесь в завершении принятой задачи. Затем проверьте повторную доставку. + +## Оценка «3»: работающий минимум + +- Весь минимум lab4 сохранён с переходом upload 201 → 202. API возвращает 202 только после устойчивого приёма оригинала и сохранения задания; остановка API после ответа не теряет работу. +- В общем Compose/Swarm есть отдельные broker и worker. Сообщения durable, доставка at least once, подтверждение только после устойчивого эффекта. Недоступность worker не заставляет API выполнять resize синхронно. +- Состояния queued/processing/ready/failed доступны в API. Worker сохраняет оригинал и один thumbnail; original неизменен, thumbnail соответствует контракту. Публичный smoke проходит. +- Есть ограниченный retry (конкретное число попыток в конфигурации, например 5), финальное failed с безопасным error_code. Повтор одной job не создаёт второго набора вариантов. +- Демонстрация: worker остановлен → upload 202 → сообщение с вложением создано → API перезапущен → worker запущен → ready и доступный thumbnail. Принятое задание не исчезает при рестарте broker с volume. + +## Оценка «4»: уровень стажёра/джуна + +Весь уровень 3 **и все** пункты ниже: + +- Добавлены crop 128×128 и optimized WebP по контракту, параметры качества/удаления метаданных описаны. Невалидные/огромные изображения ограничены по bytes, пикселям, времени и памяти worker. +- Разрыв между PostgreSQL и broker закрыт transactional outbox или другой доказанной схемой восстановления намерения. Внедрён crash между COMMIT и publish; после восстановления задача доходит до ready без ручного создания нового задания. +- Retry использует backoff с jitter, различает постоянные/временные ошибки; есть DLQ/реестр failed и безопасный явный replay. «Повторить» не означает безусловно исполнить дубль уже успешной job. +- Проверена остановка worker после записи объекта, но до ack; повтор завершает тот же результат. Есть timeout/lease для зависшего processing, ограниченная конкуренция/prefetch и очистка staging после безопасной фиксации. + +## Оценка «5»: исследование и доказанный результат + +Весь уровень 4 **и один законченный трек на выбор**. Приведите гипотезу, повторяемую методику, результаты и ограничения. + +**Трек 1. Очередь под перегрузкой.** Сравните ≥3 настройки concurrency/prefetch на разных размерах изображений. Измерьте throughput, queue lag, p95 времени до ready и RSS; покажите backpressure и ограничение количества принятой работы. Докажите восстановление после перегрузки, объясните компромисс latency/ресурсы. + +**Трек 2. Доказанная идемпотентность pipeline.** Постройте versioned pipeline и автоматический fault-injection для дубля, reorder, crash до/после side effect и устаревшей job после новой версии. Зафиксируйте инварианты, покажите отсутствие потери подтверждённых задач и перезаписи нового результата старым. Обсудите почему это не exactly-once доставка. + +## Как начать и проверить + +```sh +# Работает прямо в skeleton, Python 3.9+; приложение не запускается: +make check + +# После реализации запустите свой сервер/стенд по REPORT.md. +# По умолчанию тест использует http://localhost:8080. +make test +``` + +`.env.example`, `compose.example.yaml` и `contracts/infrastructure.json` описывают настройки и роли компонентов. **compose.example.yaml — список ролей с пустым services, не запускаемый стенд.** Реализуйте свой `compose.yaml`/`stack.yaml`, закрепите версии образов, заполните локальный `.env` и опишите bootstrap/миграции. Все зависимости поднимаются из этого репозитория; ссылка «у меня БД уже установлена» не заменяет воспроизводимость. + +```sh +# Compose-вариант после реализации: +docker compose --env-file .env config --quiet +docker compose --env-file .env up -d --build +# Дождитесь /health/ready; затем make test. +# Для Swarm укажите эквивалентные build/push/deploy-команды в REPORT.md. +``` + + +Примеры запросов доступны в `examples/requests.http`, примеры JSON — в `contracts/examples.json`. Для полной проверки схемы (по желанию локально; CI делает её автоматически): + +```sh +python3 -m venv .venv +.venv/bin/python -m pip install -r requirements-dev.txt +make validate PYTHON=.venv/bin/python +``` + +Smoke не выставляет оценку автоматически. Проверку сохранности/отказов запускайте явно по [tests/README.md](tests/README.md), остальные доказательства приведите в отчёте. + +## Сценарий защиты + +1. Запустить make test: API возвращает 202, GET доходит до ready, оригинал и настоящий JPEG thumbnail проверяются. +2. Остановить worker своим скриптом, загрузить файл, убедиться, что content отвечает 409, а другие сообщения продолжают работать. +3. Перезапустить API/broker с сохранением volumes, запустить worker; та же запись должна стать ready. Зафиксировать порядок действий и ID без токенов. +4. Для 4: воспроизвести crash после side effect до ack, разрыв COMMIT/publish и replay failed; для 5 — выбранный эксперимент. + +## Что должно быть в PR + +Worker, брокер в общем стенде, схема jobs, migrations/outbox по уровню, конфигурация retry, тесты сбоев и отчёт. + +Заполните `REPORT.md` и [шаблон PR](.github/pull_request_template.md), укажите целевую оценку/трек. Не меняйте обязательный контракт и публичные tests ради зелёного результата. Сохраняйте возможности предыдущих лабораторных в пределах [объявленных переходов](COURSE.md). + +## Вопросы на защите + +- Чем publisher confirm отличается от consumer ack? +- Что именно уже сохранено в момент 202? +- Почему повторная доставка нормальна и где находится ключ идемпотентности job? +- Как отличить зависший worker от долго работающего и не запустить два неконтролируемых дубля? + +## Первичные материалы + +- [RabbitMQ reliability](https://www.rabbitmq.com/docs/reliability) +- [Publisher confirms and acknowledgements](https://www.rabbitmq.com/docs/confirms) +- [Redis Streams](https://redis.io/docs/latest/develop/data-types/streams/) +- [NATS JetStream](https://docs.nats.io/nats-concepts/jetstream) diff --git a/REPORT.md b/REPORT.md new file mode 100644 index 00000000..e98f75e9 --- /dev/null +++ b/REPORT.md @@ -0,0 +1,37 @@ +# Отчёт — лабораторная 5 + +- Автор, группа: TODO +- Целевая оценка; выбранный трек 5, если нужен: TODO +- Commit/PR: TODO после публикации +- Использованные источники, библиотеки и помощь ИИ: TODO + +## Запуск из чистого clone + +TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных. + +## Архитектура и решения + +TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab4, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. + +## Доказательства критериев + +| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | +| --- | --- | --- | --- | +| Публичный smoke | make test | TODO | TODO | +| Остальные пункты уровня 3 | TODO | TODO | TODO | +| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | +| Выбранный трек 5, если заявлен | TODO | TODO | TODO | + +TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены. + +## Эксперименты и отказы + +TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения. + +| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | +| --- | --- | --- | --- | +| TODO | TODO | TODO | TODO | + +## Ограничения и следующие шаги + +TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. diff --git a/compose.example.yaml b/compose.example.yaml new file mode 100644 index 00000000..792b3f4e --- /dev/null +++ b/compose.example.yaml @@ -0,0 +1,14 @@ +# Topology worksheet, deliberately NOT a runnable stack (no application supplied). +# Implement compose.yaml or stack.yaml; do not submit this empty file as deployment. +# Service names below are logical roles, not imposed container names. +x-lab-number: 5 +x-required-roles: + - api + - postgres + - load_balancer + - s3 + - broker + - worker +# TODO: implement real images/builds, network wiring, volumes, healthchecks, +# credentials and bootstrap. Details: contracts/infrastructure.json and README.md. +services: {} diff --git a/contracts/README.md b/contracts/README.md new file mode 100644 index 00000000..8c58b32f --- /dev/null +++ b/contracts/README.md @@ -0,0 +1,61 @@ +# Семантика API + +Этот текст дополняет [openapi.json](openapi.json). Обязательный API соответствует уровню 3 текущей лабораторной. Факультативный crop или rate limiting не становятся обязательными только из-за наличия допустимого имени варианта или кода ошибки в схеме. + +## Формат и ошибки + +- JSON — UTF-8, `Content-Type: application/json`. UUID — строка; время — RFC 3339 UTC с `Z`, назначается сервером. Часы не считаются уникальным ID. +- Каждый ответ API, включая ошибки и health, содержит непустой `X-Request-Id`. Тело ошибки: `{"error":{"code":"invalid_request","message":"...","request_id":"..."}}`; `request_id` совпадает с заголовком. Сообщение ошибки не раскрывает stack trace, SQL, credentials или наличие чужого объекта. +- Обязательные строки не состоят только из пробельных символов. `username` строго `[a-z0-9_]{3,32}`, уникален; `display_name` — 1–100 Unicode code points. JSON с лишними полями или неверными типами — `400`; malformed JSON также `400`. +- `400 invalid_request` — неверные поля, UUID, cursor, limit; `401 unauthorized` — нет действительной идентификации/сессии; `404 not_found` — объекта нет или он чужой; `409 conflict` — username занят, повторный ключ с другим сообщением, объект ещё не готов; `413 payload_too_large`; `415 unsupported_media_type`; `429 rate_limited`; `503 unavailable`. Неожиданное исключение — `500 internal_error` без внутренних деталей. +- Сначала аутентификация, затем доступ к конкретному ресурсу. Любой аутентифицированный участник чата может читать его историю и вложения и писать в него; посторонний получает `404`. Списки содержат только доступные объекты. Не используйте `403` для раскрытия существования чужого чата. +- `GET /health/live` проверяет только жизнь процесса, возвращает `200 {"status":"ok"}`. `GET /health/ready` возвращает 200, если приложение может безопасно обслуживать обязательный синхронный путь; иначе 503 в общем формате ошибки. Какие зависимости критичны, зафиксируйте в отчёте; недоступность Grafana не должна останавливать API. + +## Пользователи, чаты и сообщения + +- `POST /users` публичен; возвращает `201 User`. Пароль/его hash и сессионные данные никогда не входят в User. +- `POST /chats` принимает title и явный список существующих `member_ids`, включая вызывающего. Дубликаты, неизвестные участники и отсутствие вызывающего — 400. Чат создаётся атомарно. GET списка чатов сортируется по `(created_at, id)` по возрастанию. +- Отправитель сообщения выводится из текущей идентификации, поле `sender_id` в запросе не принимается. Текст — до 4000 Unicode code points. Нельзя отправить пустой/пробельный текст без вложений. +- История использует keyset cursor: `(created_at, id)`, по возрастанию; `limit` — целое 1–100, по умолчанию 50. Ответ `{"items":[...],"next_cursor":null}`. Непустой cursor — непрозрачная для клиента строка; последний элемент предыдущей страницы не повторяется. Cursor привязан к ресурсу/запросу: от другого чата — 400. Изменять `limit` при продолжении можно. +- `next_cursor` равен null, если на момент чтения следующей записи нет. Гарантируется отсутствие повторов при обходе неизменной истории; snapshot изоляция между несколькими HTTP-запросами не требуется. При конкурентных вставках опишите выбранную семантику и ограничения часов. +- Подтверждённое сообщение видно следующему чтению через любую API-реплику. Допускается кэш, но он не должен возвращать устаревшую историю после успешной записи. Удаление и изменение участников в обязательный API не входят. + +## Идентификация и сессии + +**Lab1:** защищённые endpoint требуют `X-User-Id: `; отсутствие/неизвестный ID — 401. Это учебный выбор пользователя: любой клиент может выдать себя за другого. + +**Lab2–7:** `POST /auth/sessions` принимает только `Authorization: Basic `, без JSON body. Username ограничен ASCII; пароль кодируется UTF-8, 12–128 code points, двоеточие в пароле допустимо. Неверные credentials — одинаковый 401 и `WWW-Authenticate: Basic realm="messenger", charset="UTF-8"`. + +Вход возвращает `201 {"token":"...","token_type":"Bearer","expires_at":"...Z","user":{...}}`. Токен — непрозрачное случайное значение, не username/UUID и не обязательный JWT; энтропия не менее 256 бит. Храните серверную сессию с expiry; TTL задаётся `SESSION_TTL_SECONDS`, по умолчанию 3600 (в тесте истечения можно 2). В обычном smoke TTL должен быть не менее 300. + +Все защищённые endpoint принимают только `Authorization: Bearer `. Истёкший/отозванный/неизвестный токен — 401 с `WWW-Authenticate: Bearer realm="messenger"`. Basic на бизнес-endpoint — 401. `X-User-Id` с lab2 игнорируется: он не меняет владельца сессии и сам по себе не даёт доступ. `DELETE /auth/sessions/current` отзывает текущий токен и возвращает 204 без тела; повтор с отозванным токеном — 401. + +Пользователи, чаты, сообщения и ещё действительные сессии переживают перезапуск приложения и используемых хранилищ с сохранёнными volumes. TTL не продлевается из-за рестарта. Пароли уже с lab2 хешируются библиотечным password KDF (Argon2id, scrypt или bcrypt с учётом ограничений библиотеки), не SHA-256 и не plaintext. Если bcrypt не поддерживает весь диапазон UTF-8 паролей без усечения, выберите другую библиотечную схему. В lab7 обязателен Argon2id. + +Basic — это кодирование, не шифрование. HTTP lab1–6 допускается только для локального изолированного стенда с синтетическими данными; для удалённой демонстрации нужен TLS. Lab7 использует HTTPS обязательно. См. [RFC 7617](https://www.rfc-editor.org/info/rfc7617/). + +## Балансировка и повторная отправка (с lab3) + +- Каждый ответ, созданный API, содержит `X-Instance-Id`; значение стабильно для жизни процесса. Ошибки соединения, созданные самим LB, могут не иметь этого заголовка. В lab7 используйте случайный alias реплики без раскрытия hostname/IP. +- Для POST сообщения обязателен `Idempotency-Key` (ASCII `[A-Za-z0-9._:-]{1,128}`). Нет/неверный ключ — 400. Область уникальности: текущий пользователь + HTTP-метод + путь чата + ключ. +- При повторе того же валидного JSON в течение 24 часов сервер возвращает тот же код 201 и то же Message. Порядок ключей JSON и отсутствующий `attachment_ids` вместо `[]` семантически равны. Другой body при том же ключе — 409. Разные пользователи/чаты могут использовать одинаковый ключ независимо. +- Одновременные повторы через разные реплики создают ровно одно сообщение. Повтор снова проверяет действительность сессии и доступ. Транзиентные 5xx не фиксируются как окончательный результат; побочный эффект и запись результата должны быть атомарны. +- Ключ обязателен только для сообщений. Самостоятельный retry загрузки файла или создания чата может создать ещё один объект; не добавляйте прозрачные повторы этих POST без расширения контракта. + +## Вложения (с lab4) + +- `POST /chats/{chat_id}/attachments?filename=photo.png`: сырые bytes одного PNG/JPEG; `Content-Type: image/png` или `image/jpeg`. Не multipart. Максимум **10 MiB = 10 485 760 байт**. MIME проверяется по содержимому; заведомо повреждённые/чужие форматы — 415, превышение bytes — 413. Не более 40 миллионов декодированных пикселей (превышение — 413). Устанавливайте лимит до полной распаковки изображения. +- `filename` — отображаемое имя (1–255 code points). Не используйте его как путь/ключ S3. Имя с `/`, `\`, NUL или управляющими символами — 400. Bucket приватен; object key генерирует сервер. Оригинал возвращается побайтно, его lowercase SHA-256 и размер соответствуют исходному файлу. +- Lab4 возвращает `201 Attachment` со `status=ready`, `variants=[]`, `error_code=null` только после сохранения оригинала и метаданных. Lab5–7 возвращают `202 Attachment` со снимком `status=queued`; готовность определяется последующим GET метаданных. Быстрый worker может закончить до первого GET — это нормально. +- Файл заранее привязан к чату. В POST сообщения добавляется `attachment_ids` (0–10 уникальных ID, по умолчанию []). Можно отправить `text=""` с хотя бы одним вложением. Все вложения должны принадлежать этому чату; чужое/неизвестное — 404. Любой участник может ссылаться на доступное вложение чата. Failed-вложение прикреплять нельзя (409); queued/processing с lab5 можно. +- `GET /attachments/{id}` и `/content` доступны только участникам чата. Download возвращает байты с истинным Content-Type, через авторизованный API, **без redirect** в обязательном контракте. Приватный bucket сам по себе не заменяет эту проверку. `variant` по умолчанию original. Для queued/processing content — 409; для failed — 409. Отсутствующий вариант ready-объекта — 404. +- В ready-метаданных `error_code=null`. В failed — краткий машинный код (например `invalid_image`, `processing_failed`, `retry_exhausted`), без stack trace. `size_bytes`, `sha256`, `content_type` всегда описывают оригинал; у вариантов отдельные поля. Публичный API не раскрывает ключи бакета, внутренние адреса и credentials. +- Прямой upload/download по временной подписи — факультативное расширение. Его дополняют ограничение срока/размера, уникальный ключ и подтверждение реально загруженного объекта; он не заменяет стандартный endpoint. Особенности подписанных URL: [S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-presigned-url.html). + +## Фоновая обработка (с lab5) + +До 202 все байты приняты в **устойчивый staging**, а намерение обработать файл надёжно сохранено. HTTP-передача клиента не исчезает и не становится мгновенной. Staging — приватный S3-prefix либо общий persistent volume, доступный worker; локальная память/API ephemeral disk не подходит. Worker асинхронно переносит/публикует оригинал в конечный S3-prefix и создаёт варианты; если staging уже в S3, опишите эту границу честно. + +Обязательный thumbnail: JPEG, изображение вписано в 256×256 с сохранением пропорций, без увеличения маленьких исходников, EXIF orientation применяется; alpha компонуется на белый. Размеры округляются вниз, минимум 1 px. Fixture 320×200 должен дать 256×160. Статус ready ставится после сохранения оригинала и thumbnail. Crop на 4: JPEG, центрированный квадрат 128×128 (для маленьких исходников допускается увеличение). Optimized на 4: WebP, вписан в 1280×1280 без увеличения, параметры качества и удаления EXIF документируются; не обещайте уменьшение каждого маленького файла. + +Допустимые состояния и события описаны в `jobs.schema.json` и `attachment-states.md`. Доставка — at least once; обработка идемпотентна, повторы не размножают варианты. Финальные ошибки наблюдаемы, бесконечный немой retry недопустим. Обязательный smoke ждёт ready до 60 секунд; это бюджет локального smoke для одного файла при свободном worker, не универсальный production SLA. В очередь идут ссылки/ID, не бинарное содержимое. diff --git a/contracts/attachment-states.md b/contracts/attachment-states.md new file mode 100644 index 00000000..9e0eb163 --- /dev/null +++ b/contracts/attachment-states.md @@ -0,0 +1,21 @@ +# Состояния вложения и договор между producer/worker + +Сообщение broker соответствует [jobs.schema.json](jobs.schema.json). Можно применять native headers брокера для trace context, но семантика carrier сохраняется; для проверки покажите отображение полей. `job_id` идентифицирует одну логическую работу и не меняется при redelivery; `attempt` начинается с 1 и отражает управляемую попытку обработки (broker redelivery сам по себе не создаёт новый job_id). Ключ эффекта — `(attachment_id, pipeline_version, variant)`. + +| Переход | Условие | Что устойчиво сохранено | +| --- | --- | --- | +| нет → queued | Принимаем upload; только после durable handoff отвечаем 202 | Полный проверенный оригинал в staging, метаданные, намерение обработки | +| queued → processing | Worker захватил/арендовал работу | Попытка, lease/deadline или эквивалентная защита | +| processing → queued | Временная ошибка и остались попытки | Причина без секретов, время следующей попытки | +| processing → ready | Все обязательные объекты записаны и результат атомарно опубликован | Оригинал, thumbnail (на 4 ещё crop/optimized), метаданные/checksums | +| processing → failed | Ошибка постоянная или попытки исчерпаны | error_code и запись, доступная оператору | +| processing → queued | Истёк lease после смерти worker | Восстановленная работа, без дублирования эффектов | +| failed → queued | Явный операторский replay, доступен на 4 | Audit, новая попытка, прежний логический эффект защищён от дубля | + +Повторная доставка уже ready-задачи — no-op с ack после проверки завершённого эффекта. Конкурентные попытки не перезаписывают более новый pipeline_version. Основной курс использует pipeline_version=1; версионирование нескольких pipeline — трек 5. Заявляйте готовность только когда все обещанные уровнем варианты доступны. Нельзя откатывать ready в processing из-за старого дубля. + +**Окна отказа для защиты:** после staging до записи задания; после COMMIT до publish; после publish до confirm; после записи S3 до COMMIT результата; после COMMIT результата до ack. На 3 покажите сохранность успешно принятой работы и повторную доставку; на 4 автоматическое восстановление разрыва DB/broker (outbox/эквивалент) и зависшего processing. + +Staging не удаляется до безопасной публикации результатов. Неуспешные/непривязанные исходники имеют документированный retention и cleanup; он не удаляет текущую работу. Broker принимает только ID/служебные данные, не произвольный URL для скачивания и не путь из клиентского filename. Worker берёт доверенные storage metadata из БД. + +Ack подтверждает устойчивую обработку, publisher confirm — приём брокером; это разные границы. См. [RabbitMQ reliability](https://www.rabbitmq.com/docs/reliability). At-least-once + идемпотентный эффект не означает exactly-once доставку. diff --git a/contracts/examples.json b/contracts/examples.json new file mode 100644 index 00000000..060abd0f --- /dev/null +++ b/contracts/examples.json @@ -0,0 +1,60 @@ +{ + "CreateUser": { + "username": "alice", + "display_name": "Алиса", + "password": "Example-only-not-a-real-secret-123" + }, + "User": { + "id": "11111111-1111-4111-8111-111111111111", + "username": "alice", + "display_name": "Алиса", + "created_at": "2026-09-01T12:00:00Z" + }, + "CreateChat": { + "title": "Проект по ВНП", + "member_ids": [ + "11111111-1111-4111-8111-111111111111", + "22222222-2222-4222-8222-222222222222" + ] + }, + "Chat": { + "title": "Проект по ВНП", + "member_ids": [ + "11111111-1111-4111-8111-111111111111", + "22222222-2222-4222-8222-222222222222" + ], + "id": "33333333-3333-4333-8333-333333333333", + "created_at": "2026-09-01T12:00:00Z" + }, + "CreateMessage": { + "text": "Привет, Боб!" + }, + "Message": { + "id": "44444444-4444-4444-8444-444444444444", + "chat_id": "33333333-3333-4333-8333-333333333333", + "sender_id": "11111111-1111-4111-8111-111111111111", + "text": "Привет, Боб!", + "created_at": "2026-09-01T12:00:00Z", + "attachment_ids": [] + }, + "MessagePage": { + "items": [ + { + "id": "44444444-4444-4444-8444-444444444444", + "chat_id": "33333333-3333-4333-8333-333333333333", + "sender_id": "11111111-1111-4111-8111-111111111111", + "text": "Привет, Боб!", + "created_at": "2026-09-01T12:00:00Z", + "attachment_ids": [] + } + ], + "next_cursor": null + }, + "Error": { + "error": { + "code": "not_found", + "message": "Объект не найден", + "request_id": "example-request-id" + } + } +} diff --git a/contracts/infrastructure.json b/contracts/infrastructure.json new file mode 100644 index 00000000..a4cfcb7b --- /dev/null +++ b/contracts/infrastructure.json @@ -0,0 +1,62 @@ +{ + "lab": 5, + "kind": "requirements, not runnable deployment", + "required_for_grade_3": [ + { + "role": "api", + "count_min": 2, + "student_implements": true, + "persistent_local_state": false + }, + { + "role": "postgres", + "purpose": "users/chats/membership/messages/metadata", + "persistent_volume": true + }, + { + "role": "load_balancer", + "public_entrypoint": true, + "backend_readiness": true + }, + { + "role": "s3", + "choose_one": [ + "MinIO", + "SeaweedFS", + "RustFS" + ], + "private_bucket": true, + "persistent_volume": true + }, + { + "role": "broker", + "choose_one": [ + "RabbitMQ", + "Redis Streams", + "Valkey Streams", + "NATS JetStream", + "documented durable equivalent" + ], + "persistent_volume": true, + "delivery": "at-least-once" + }, + { + "role": "worker", + "separate_process": true + } + ], + "optional_components": [ + { + "role": "redis_or_valkey", + "required_for_lab2_grade4": true, + "note": "Choose one; if only store of sessions, configure durable persistence." + } + ], + "rules": [ + "Choose Compose or Swarm for lab3+; do not need both.", + "Never publish internal API replica ports in bypass of LB from lab3.", + "Versions/digests must be fixed in implementation.", + "Do not remove volumes in restart/failover checks.", + "Document service names, healthchecks, bootstrap/migrations and credentials." + ] +} diff --git a/contracts/jobs.schema.json b/contracts/jobs.schema.json new file mode 100644 index 00000000..2e9aa484 --- /dev/null +++ b/contracts/jobs.schema.json @@ -0,0 +1,63 @@ +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "$id": "urn:mtusi:messenger:attachment-job:v1", + "title": "Durable attachment processing job v1", + "type": "object", + "additionalProperties": false, + "required": [ + "schema_version", + "job_id", + "type", + "attachment_id", + "pipeline_version", + "attempt", + "created_at" + ], + "properties": { + "schema_version": { + "const": 1 + }, + "job_id": { + "type": "string", + "format": "uuid" + }, + "type": { + "const": "attachment.process.v1" + }, + "attachment_id": { + "type": "string", + "format": "uuid" + }, + "pipeline_version": { + "type": "integer", + "minimum": 1 + }, + "attempt": { + "type": "integer", + "minimum": 1 + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "traceparent": { + "type": "string", + "pattern": "^00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$" + }, + "tracestate": { + "type": "string", + "maxLength": 512 + } + }, + "examples": [ + { + "schema_version": 1, + "job_id": "11111111-1111-4111-8111-111111111111", + "type": "attachment.process.v1", + "attachment_id": "22222222-2222-4222-8222-222222222222", + "pipeline_version": 1, + "attempt": 1, + "created_at": "2026-09-01T12:00:00Z" + } + ] +} diff --git a/contracts/openapi.json b/contracts/openapi.json new file mode 100644 index 00000000..4face909 --- /dev/null +++ b/contracts/openapi.json @@ -0,0 +1,3512 @@ +{ + "openapi": "3.1.0", + "info": { + "title": "MTUSI Messenger — лабораторная 5", + "version": "1.5.0", + "description": "Нормативный минимум на 3. Семантика: contracts/README.md. Расширения на 4/5 не должны менять этот API. Наличие кода ошибки в схеме не требует реализовать факультативную причину его выдачи." + }, + "servers": [ + { + "url": "http://localhost:8080", + "description": "Локальный учебный стенд" + } + ], + "security": [ + { + "bearerAuth": [] + } + ], + "paths": { + "/health/live": { + "get": { + "operationId": "liveness", + "summary": "Процесс жив", + "responses": { + "200": { + "description": "Успех", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Health" + } + } + } + }, + "500": { + "description": "Неожиданная ошибка без внутренних деталей", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + }, + "security": [] + } + }, + "/health/ready": { + "get": { + "operationId": "readiness", + "summary": "Готов принимать трафик", + "responses": { + "200": { + "description": "Успех", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Health" + } + } + } + }, + "503": { + "description": "Зависимость недоступна", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "500": { + "description": "Неожиданная ошибка без внутренних деталей", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + }, + "security": [] + } + }, + "/api/v1/users": { + "post": { + "operationId": "registerUser", + "summary": "Создать пользователя", + "responses": { + "201": { + "description": "Успех", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/User" + } + } + } + }, + "400": { + "description": "Неверный запрос", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "409": { + "description": "Конфликт", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "429": { + "description": "Ограничение частоты запросов", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "Retry-After": { + "description": "Положительное число секунд.", + "schema": { + "type": "integer", + "minimum": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "503": { + "description": "Зависимость недоступна", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "500": { + "description": "Неожиданная ошибка без внутренних деталей", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + }, + "security": [], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/CreateUser" + } + } + } + } + } + }, + "/api/v1/users/me": { + "get": { + "operationId": "currentUser", + "summary": "Текущий пользователь", + "responses": { + "200": { + "description": "Успех", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/User" + } + } + } + }, + "400": { + "description": "Неверный запрос", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Нет действительной аутентификации", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "WWW-Authenticate": { + "description": "Basic realm=\"messenger\", charset=\"UTF-8\" для входа; Bearer realm=\"messenger\" для защищённого API lab2+.", + "schema": { + "type": "string" + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Объект отсутствует или недоступен", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "409": { + "description": "Конфликт", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "429": { + "description": "Ограничение частоты запросов", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "Retry-After": { + "description": "Положительное число секунд.", + "schema": { + "type": "integer", + "minimum": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "503": { + "description": "Зависимость недоступна", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "500": { + "description": "Неожиданная ошибка без внутренних деталей", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/api/v1/chats": { + "post": { + "operationId": "createChat", + "summary": "Создать чат; вызывающий должен входить в member_ids", + "responses": { + "201": { + "description": "Успех", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Chat" + } + } + } + }, + "400": { + "description": "Неверный запрос", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Нет действительной аутентификации", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "WWW-Authenticate": { + "description": "Basic realm=\"messenger\", charset=\"UTF-8\" для входа; Bearer realm=\"messenger\" для защищённого API lab2+.", + "schema": { + "type": "string" + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Объект отсутствует или недоступен", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "409": { + "description": "Конфликт", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "429": { + "description": "Ограничение частоты запросов", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "Retry-After": { + "description": "Положительное число секунд.", + "schema": { + "type": "integer", + "minimum": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "503": { + "description": "Зависимость недоступна", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "500": { + "description": "Неожиданная ошибка без внутренних деталей", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + }, + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/CreateChat" + } + } + } + } + }, + "get": { + "operationId": "listChats", + "summary": "Чаты текущего пользователя", + "responses": { + "200": { + "description": "Успех", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ChatPage" + } + } + } + }, + "400": { + "description": "Неверный запрос", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Нет действительной аутентификации", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "WWW-Authenticate": { + "description": "Basic realm=\"messenger\", charset=\"UTF-8\" для входа; Bearer realm=\"messenger\" для защищённого API lab2+.", + "schema": { + "type": "string" + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Объект отсутствует или недоступен", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "409": { + "description": "Конфликт", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "429": { + "description": "Ограничение частоты запросов", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "Retry-After": { + "description": "Положительное число секунд.", + "schema": { + "type": "integer", + "minimum": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "503": { + "description": "Зависимость недоступна", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "500": { + "description": "Неожиданная ошибка без внутренних деталей", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + }, + "parameters": [ + { + "name": "limit", + "in": "query", + "schema": { + "type": "integer", + "minimum": 1, + "maximum": 100, + "default": 50 + } + }, + { + "name": "cursor", + "in": "query", + "schema": { + "type": "string", + "minLength": 1 + } + } + ] + } + }, + "/api/v1/chats/{chat_id}": { + "get": { + "operationId": "getChat", + "summary": "Получить доступный чат", + "responses": { + "200": { + "description": "Успех", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Chat" + } + } + } + }, + "400": { + "description": "Неверный запрос", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Нет действительной аутентификации", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "WWW-Authenticate": { + "description": "Basic realm=\"messenger\", charset=\"UTF-8\" для входа; Bearer realm=\"messenger\" для защищённого API lab2+.", + "schema": { + "type": "string" + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Объект отсутствует или недоступен", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "409": { + "description": "Конфликт", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "429": { + "description": "Ограничение частоты запросов", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "Retry-After": { + "description": "Положительное число секунд.", + "schema": { + "type": "integer", + "minimum": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "503": { + "description": "Зависимость недоступна", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "500": { + "description": "Неожиданная ошибка без внутренних деталей", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + }, + "parameters": [ + { + "name": "chat_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "format": "uuid" + } + } + ] + } + }, + "/api/v1/chats/{chat_id}/messages": { + "post": { + "operationId": "createMessage", + "summary": "Отправить сообщение", + "responses": { + "201": { + "description": "Успех", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Message" + } + } + } + }, + "400": { + "description": "Неверный запрос", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Нет действительной аутентификации", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "WWW-Authenticate": { + "description": "Basic realm=\"messenger\", charset=\"UTF-8\" для входа; Bearer realm=\"messenger\" для защищённого API lab2+.", + "schema": { + "type": "string" + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Объект отсутствует или недоступен", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "409": { + "description": "Конфликт", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "429": { + "description": "Ограничение частоты запросов", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "Retry-After": { + "description": "Положительное число секунд.", + "schema": { + "type": "integer", + "minimum": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "503": { + "description": "Зависимость недоступна", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "500": { + "description": "Неожиданная ошибка без внутренних деталей", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + }, + "parameters": [ + { + "name": "chat_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "format": "uuid" + } + }, + { + "name": "Idempotency-Key", + "in": "header", + "required": true, + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 128, + "pattern": "^[A-Za-z0-9._:-]+$" + }, + "description": "Обязателен с lab3. Область: пользователь + метод + путь + ключ; хранить результат не менее 24 ч. Повтор того же JSON возвращает исходный 201 и то же сообщение, другой JSON — 409." + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/CreateMessage" + } + } + } + } + }, + "get": { + "operationId": "listMessages", + "summary": "Сообщения по (created_at, id) по возрастанию", + "responses": { + "200": { + "description": "Успех", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/MessagePage" + } + } + } + }, + "400": { + "description": "Неверный запрос", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Нет действительной аутентификации", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "WWW-Authenticate": { + "description": "Basic realm=\"messenger\", charset=\"UTF-8\" для входа; Bearer realm=\"messenger\" для защищённого API lab2+.", + "schema": { + "type": "string" + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Объект отсутствует или недоступен", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "409": { + "description": "Конфликт", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "429": { + "description": "Ограничение частоты запросов", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "Retry-After": { + "description": "Положительное число секунд.", + "schema": { + "type": "integer", + "minimum": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "503": { + "description": "Зависимость недоступна", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "500": { + "description": "Неожиданная ошибка без внутренних деталей", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + }, + "parameters": [ + { + "name": "chat_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "format": "uuid" + } + }, + { + "name": "limit", + "in": "query", + "schema": { + "type": "integer", + "minimum": 1, + "maximum": 100, + "default": 50 + } + }, + { + "name": "cursor", + "in": "query", + "schema": { + "type": "string", + "minLength": 1 + } + } + ] + } + }, + "/api/v1/auth/sessions": { + "post": { + "operationId": "createSession", + "summary": "Вход: Basic username:password; выдаёт сессию", + "responses": { + "201": { + "description": "Успех", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Session" + } + } + } + }, + "400": { + "description": "Неверный запрос", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Нет действительной аутентификации", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "WWW-Authenticate": { + "description": "Basic realm=\"messenger\", charset=\"UTF-8\" для входа; Bearer realm=\"messenger\" для защищённого API lab2+.", + "schema": { + "type": "string" + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "429": { + "description": "Ограничение частоты запросов", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "Retry-After": { + "description": "Положительное число секунд.", + "schema": { + "type": "integer", + "minimum": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "503": { + "description": "Зависимость недоступна", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "500": { + "description": "Неожиданная ошибка без внутренних деталей", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + }, + "security": [ + { + "basicAuth": [] + } + ] + } + }, + "/api/v1/auth/sessions/current": { + "delete": { + "operationId": "revokeSession", + "summary": "Отозвать текущую сессию", + "responses": { + "204": { + "description": "Успех", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + } + }, + "401": { + "description": "Нет действительной аутентификации", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "WWW-Authenticate": { + "description": "Basic realm=\"messenger\", charset=\"UTF-8\" для входа; Bearer realm=\"messenger\" для защищённого API lab2+.", + "schema": { + "type": "string" + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "429": { + "description": "Ограничение частоты запросов", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "Retry-After": { + "description": "Положительное число секунд.", + "schema": { + "type": "integer", + "minimum": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "503": { + "description": "Зависимость недоступна", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "500": { + "description": "Неожиданная ошибка без внутренних деталей", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + } + } + }, + "/api/v1/chats/{chat_id}/attachments": { + "post": { + "operationId": "uploadAttachment", + "summary": "Принять один PNG/JPEG, до 10 MiB", + "responses": { + "202": { + "description": "Успех", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Attachment" + } + } + } + }, + "400": { + "description": "Неверный запрос", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Нет действительной аутентификации", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "WWW-Authenticate": { + "description": "Basic realm=\"messenger\", charset=\"UTF-8\" для входа; Bearer realm=\"messenger\" для защищённого API lab2+.", + "schema": { + "type": "string" + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Объект отсутствует или недоступен", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "413": { + "description": "Превышен лимит", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "415": { + "description": "Неподдерживаемый тип", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "429": { + "description": "Ограничение частоты запросов", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "Retry-After": { + "description": "Положительное число секунд.", + "schema": { + "type": "integer", + "minimum": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "503": { + "description": "Зависимость недоступна", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "500": { + "description": "Неожиданная ошибка без внутренних деталей", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + }, + "parameters": [ + { + "name": "chat_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "format": "uuid" + } + }, + { + "name": "filename", + "in": "query", + "required": true, + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 255 + } + } + ], + "requestBody": { + "required": true, + "description": "Сырые байты изображения, НЕ multipart и НЕ JSON/base64.", + "content": { + "image/png": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "image/jpeg": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + } + } + }, + "/api/v1/attachments/{attachment_id}": { + "get": { + "operationId": "getAttachment", + "summary": "Метаданные вложения, доступ участникам чата", + "responses": { + "200": { + "description": "Успех", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Attachment" + } + } + } + }, + "400": { + "description": "Неверный запрос", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Нет действительной аутентификации", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "WWW-Authenticate": { + "description": "Basic realm=\"messenger\", charset=\"UTF-8\" для входа; Bearer realm=\"messenger\" для защищённого API lab2+.", + "schema": { + "type": "string" + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Объект отсутствует или недоступен", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "409": { + "description": "Конфликт", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "429": { + "description": "Ограничение частоты запросов", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "Retry-After": { + "description": "Положительное число секунд.", + "schema": { + "type": "integer", + "minimum": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "503": { + "description": "Зависимость недоступна", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "500": { + "description": "Неожиданная ошибка без внутренних деталей", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + }, + "parameters": [ + { + "name": "attachment_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "format": "uuid" + } + } + ] + } + }, + "/api/v1/attachments/{attachment_id}/content": { + "get": { + "operationId": "downloadAttachment", + "summary": "Скачать байты через авторизованный API", + "responses": { + "200": { + "description": "Успех", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "image/png": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "image/jpeg": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "image/webp": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "400": { + "description": "Неверный запрос", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "401": { + "description": "Нет действительной аутентификации", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "WWW-Authenticate": { + "description": "Basic realm=\"messenger\", charset=\"UTF-8\" для входа; Bearer realm=\"messenger\" для защищённого API lab2+.", + "schema": { + "type": "string" + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "404": { + "description": "Объект отсутствует или недоступен", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "409": { + "description": "Конфликт", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "429": { + "description": "Ограничение частоты запросов", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "Retry-After": { + "description": "Положительное число секунд.", + "schema": { + "type": "integer", + "minimum": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "503": { + "description": "Зависимость недоступна", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + }, + "500": { + "description": "Неожиданная ошибка без внутренних деталей", + "headers": { + "X-Request-Id": { + "description": "Непустой идентификатор запроса; обязателен во всех ответах.", + "schema": { + "type": "string", + "minLength": 1 + } + }, + "X-Instance-Id": { + "description": "Идентификатор обслужившей API-реплики; стабилен в пределах жизни процесса. В lab7 используйте непрозрачный alias, без hostname/IP.", + "schema": { + "type": "string", + "minLength": 1 + } + } + }, + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Error" + } + } + } + } + }, + "parameters": [ + { + "name": "attachment_id", + "in": "path", + "required": true, + "schema": { + "type": "string", + "format": "uuid" + } + }, + { + "name": "variant", + "in": "query", + "schema": { + "type": "string", + "enum": [ + "original", + "thumbnail", + "crop", + "optimized" + ], + "default": "original" + } + } + ] + } + } + }, + "components": { + "securitySchemes": { + "basicAuth": { + "type": "http", + "scheme": "basic" + }, + "bearerAuth": { + "type": "http", + "scheme": "bearer", + "bearerFormat": "opaque session token" + } + }, + "schemas": { + "Error": { + "type": "object", + "properties": { + "error": { + "type": "object", + "properties": { + "code": { + "type": "string", + "enum": [ + "invalid_request", + "unauthorized", + "not_found", + "conflict", + "payload_too_large", + "unsupported_media_type", + "rate_limited", + "unavailable", + "internal_error" + ] + }, + "message": { + "type": "string", + "minLength": 1 + }, + "request_id": { + "type": "string", + "minLength": 1 + } + }, + "required": [ + "code", + "message", + "request_id" + ], + "additionalProperties": false + } + }, + "required": [ + "error" + ], + "additionalProperties": false, + "examples": [ + { + "error": { + "code": "not_found", + "message": "Объект не найден", + "request_id": "example-request-id" + } + } + ] + }, + "Health": { + "type": "object", + "properties": { + "status": { + "type": "string", + "enum": [ + "ok" + ] + } + }, + "required": [ + "status" + ], + "additionalProperties": false + }, + "User": { + "type": "object", + "properties": { + "id": { + "type": "string", + "format": "uuid" + }, + "username": { + "type": "string", + "pattern": "^[a-z0-9_]{3,32}$" + }, + "display_name": { + "type": "string", + "minLength": 1, + "maxLength": 100 + }, + "created_at": { + "type": "string", + "format": "date-time" + } + }, + "required": [ + "id", + "username", + "display_name", + "created_at" + ], + "additionalProperties": false, + "examples": [ + { + "id": "11111111-1111-4111-8111-111111111111", + "username": "alice", + "display_name": "Алиса", + "created_at": "2026-09-01T12:00:00Z" + } + ] + }, + "CreateUser": { + "type": "object", + "properties": { + "username": { + "type": "string", + "pattern": "^[a-z0-9_]{3,32}$" + }, + "display_name": { + "type": "string", + "minLength": 1, + "maxLength": 100 + }, + "password": { + "type": "string", + "minLength": 12, + "maxLength": 128, + "writeOnly": true + } + }, + "required": [ + "username", + "display_name", + "password" + ], + "additionalProperties": false, + "examples": [ + { + "username": "alice", + "display_name": "Алиса", + "password": "Example-only-not-a-real-secret-123" + } + ] + }, + "Chat": { + "type": "object", + "properties": { + "id": { + "type": "string", + "format": "uuid" + }, + "title": { + "type": "string", + "minLength": 1, + "maxLength": 100 + }, + "member_ids": { + "type": "array", + "items": { + "type": "string", + "format": "uuid" + }, + "minItems": 1, + "maxItems": 100, + "uniqueItems": true + }, + "created_at": { + "type": "string", + "format": "date-time" + } + }, + "required": [ + "id", + "title", + "member_ids", + "created_at" + ], + "additionalProperties": false, + "examples": [ + { + "title": "Проект по ВНП", + "member_ids": [ + "11111111-1111-4111-8111-111111111111", + "22222222-2222-4222-8222-222222222222" + ], + "id": "33333333-3333-4333-8333-333333333333", + "created_at": "2026-09-01T12:00:00Z" + } + ] + }, + "CreateChat": { + "type": "object", + "properties": { + "title": { + "type": "string", + "minLength": 1, + "maxLength": 100 + }, + "member_ids": { + "type": "array", + "items": { + "type": "string", + "format": "uuid" + }, + "minItems": 1, + "maxItems": 100, + "uniqueItems": true + } + }, + "required": [ + "title", + "member_ids" + ], + "additionalProperties": false, + "examples": [ + { + "title": "Проект по ВНП", + "member_ids": [ + "11111111-1111-4111-8111-111111111111", + "22222222-2222-4222-8222-222222222222" + ] + } + ] + }, + "Message": { + "type": "object", + "properties": { + "id": { + "type": "string", + "format": "uuid" + }, + "chat_id": { + "type": "string", + "format": "uuid" + }, + "sender_id": { + "type": "string", + "format": "uuid" + }, + "text": { + "type": "string", + "maxLength": 4000 + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "attachment_ids": { + "type": "array", + "items": { + "type": "string", + "format": "uuid" + }, + "maxItems": 10, + "uniqueItems": true + } + }, + "required": [ + "id", + "chat_id", + "sender_id", + "text", + "created_at", + "attachment_ids" + ], + "additionalProperties": false, + "anyOf": [ + { + "properties": { + "text": { + "minLength": 1 + } + } + }, + { + "properties": { + "attachment_ids": { + "minItems": 1 + } + } + } + ], + "examples": [ + { + "id": "44444444-4444-4444-8444-444444444444", + "chat_id": "33333333-3333-4333-8333-333333333333", + "sender_id": "11111111-1111-4111-8111-111111111111", + "text": "Привет, Боб!", + "created_at": "2026-09-01T12:00:00Z", + "attachment_ids": [] + } + ] + }, + "CreateMessage": { + "type": "object", + "properties": { + "text": { + "type": "string", + "maxLength": 4000 + }, + "attachment_ids": { + "type": "array", + "items": { + "type": "string", + "format": "uuid" + }, + "maxItems": 10, + "uniqueItems": true, + "default": [] + } + }, + "required": [ + "text" + ], + "additionalProperties": false, + "anyOf": [ + { + "properties": { + "text": { + "minLength": 1 + } + } + }, + { + "properties": { + "attachment_ids": { + "minItems": 1 + } + }, + "required": [ + "attachment_ids" + ] + } + ], + "examples": [ + { + "text": "Привет, Боб!" + } + ] + }, + "ChatPage": { + "type": "object", + "properties": { + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/Chat" + } + }, + "next_cursor": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "items", + "next_cursor" + ], + "additionalProperties": false + }, + "MessagePage": { + "type": "object", + "properties": { + "items": { + "type": "array", + "items": { + "$ref": "#/components/schemas/Message" + } + }, + "next_cursor": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "items", + "next_cursor" + ], + "additionalProperties": false, + "examples": [ + { + "items": [ + { + "id": "44444444-4444-4444-8444-444444444444", + "chat_id": "33333333-3333-4333-8333-333333333333", + "sender_id": "11111111-1111-4111-8111-111111111111", + "text": "Привет, Боб!", + "created_at": "2026-09-01T12:00:00Z", + "attachment_ids": [] + } + ], + "next_cursor": null + } + ] + }, + "Session": { + "type": "object", + "properties": { + "token": { + "type": "string", + "minLength": 32 + }, + "token_type": { + "type": "string", + "const": "Bearer" + }, + "expires_at": { + "type": "string", + "format": "date-time" + }, + "user": { + "$ref": "#/components/schemas/User" + } + }, + "required": [ + "token", + "token_type", + "expires_at", + "user" + ], + "additionalProperties": false + }, + "Variant": { + "type": "object", + "properties": { + "name": { + "type": "string", + "enum": [ + "thumbnail", + "crop", + "optimized" + ] + }, + "content_type": { + "type": "string", + "enum": [ + "image/jpeg", + "image/png", + "image/webp" + ] + }, + "size_bytes": { + "type": "integer", + "minimum": 1 + }, + "width": { + "type": "integer", + "minimum": 1 + }, + "height": { + "type": "integer", + "minimum": 1 + }, + "sha256": { + "type": "string", + "pattern": "^[a-f0-9]{64}$" + } + }, + "required": [ + "name", + "content_type", + "size_bytes", + "width", + "height", + "sha256" + ], + "additionalProperties": false + }, + "Attachment": { + "type": "object", + "properties": { + "id": { + "type": "string", + "format": "uuid" + }, + "chat_id": { + "type": "string", + "format": "uuid" + }, + "owner_id": { + "type": "string", + "format": "uuid" + }, + "filename": { + "type": "string", + "minLength": 1, + "maxLength": 255 + }, + "content_type": { + "type": "string", + "enum": [ + "image/png", + "image/jpeg" + ] + }, + "size_bytes": { + "type": "integer", + "minimum": 1, + "maximum": 10485760 + }, + "sha256": { + "type": "string", + "pattern": "^[a-f0-9]{64}$" + }, + "status": { + "type": "string", + "enum": [ + "queued", + "processing", + "ready", + "failed" + ] + }, + "variants": { + "type": "array", + "items": { + "$ref": "#/components/schemas/Variant" + } + }, + "error_code": { + "type": [ + "string", + "null" + ] + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + } + }, + "required": [ + "id", + "chat_id", + "owner_id", + "filename", + "content_type", + "size_bytes", + "sha256", + "status", + "variants", + "error_code", + "created_at", + "updated_at" + ], + "additionalProperties": false + } + } + } +} diff --git a/evidence/README.md b/evidence/README.md new file mode 100644 index 00000000..8df70015 --- /dev/null +++ b/evidence/README.md @@ -0,0 +1,5 @@ +# Доказательства + +Храните небольшие обезличенные результаты: команды и stdout проверок, JSON/CSV агрегатов нагрузки, EXPLAIN, dashboard JSON, текст разбора отказа. Укажите дату, commit, аппаратные лимиты и профиль нагрузки. + +Не добавляйте .env, session tokens, cookies, приватные ключи, credentials, реальные сообщения, raw dumps и signed URLs. Для скриншотов скрывайте секреты. Большие логи/бинарные traces сохраняйте отдельно по правилам преподавателя; одного скриншота без методики недостаточно. diff --git a/examples/requests.http b/examples/requests.http new file mode 100644 index 00000000..052497b1 --- /dev/null +++ b/examples/requests.http @@ -0,0 +1,53 @@ +# Optional HTTP-client worksheet; no extension is required by the course. +# Replace IDs/token locally from real responses; do not commit filled-in credentials. +# Canonical API: contracts/openapi.json and contracts/README.md. +@baseUrl = http://localhost:8080 +@aliceId = REPLACE_WITH_CREATED_ALICE_UUID +@bobId = REPLACE_WITH_CREATED_BOB_UUID +@chatId = REPLACE_WITH_CREATED_CHAT_UUID +@sessionToken = REPLACE_LOCALLY_DO_NOT_COMMIT + +### Liveness +GET {{baseUrl}}/health/live + +### Register Alice (repeat with username bob/display_name Боб) +POST {{baseUrl}}/api/v1/users +Content-Type: application/json + +{ + "username": "alice", + "display_name": "Алиса", + "password": "Example-only-not-a-real-secret-123" +} + +### Create session: generate the Base64 value locally, do not commit credentials +# Base64 of UTF-8 username:password; only this endpoint accepts Basic. +POST {{baseUrl}}/api/v1/auth/sessions +Authorization: Basic REPLACE_WITH_LOCAL_BASE64_CREDENTIAL + + +### Create chat; both UUIDs must be real registered users +POST {{baseUrl}}/api/v1/chats +Authorization: Bearer {{sessionToken}} +Content-Type: application/json + +{"title":"Проект по ВНП","member_ids":["{{aliceId}}","{{bobId}}"]} + +### Send message +POST {{baseUrl}}/api/v1/chats/{{chatId}}/messages +Authorization: Bearer {{sessionToken}} +Idempotency-Key: example-message-001 +Content-Type: application/json + +{"text":"Привет, Боб!"} + +### Read first page +GET {{baseUrl}}/api/v1/chats/{{chatId}}/messages?limit=50 +Authorization: Bearer {{sessionToken}} + +### Binary upload; HTTP file-client syntax for reading local fixture +POST {{baseUrl}}/api/v1/chats/{{chatId}}/attachments?filename=sample.png +Authorization: Bearer {{sessionToken}} +Content-Type: image/png + +< ../tests/fixtures/sample.png diff --git a/infra/README.md b/infra/README.md new file mode 100644 index 00000000..5a39e862 --- /dev/null +++ b/infra/README.md @@ -0,0 +1,7 @@ +# Инфраструктура студента + +Здесь разместите конфигурации выбранных сервисов; основную топологию — в корневом compose.yaml/stack.yaml. `compose.example.yaml` — только worksheet ролей и намеренно не запускается. `contracts/infrastructure.json` задаёт минимальные роли, не готовые образы/пароли. + +В REPORT.md сопоставьте роль → service name → версия/digest → health/readiness → volume → сеть/порт → способ передачи credentials. Приведите bootstrap (schema, bucket, broker topology, а с lab6 provisioning) и безопасное повторение этих команд. + +Приложение строится из исходников. Не используйте заранее существующий образ преподавательского сервера вместо своей реализации. Restart hook перезапускает все соответствующие stores с volumes; failover hook останавливает только заданную API-реплику. diff --git a/lab.json b/lab.json new file mode 100644 index 00000000..db0c9c35 --- /dev/null +++ b/lab.json @@ -0,0 +1,8 @@ +{ + "number": 5, + "title": "Очереди и асинхронная обработка изображений", + "contract_version": "1.5.0", + "default_base_url": "http://localhost:8080", + "grading": "3; 4 includes 3; 5 includes 4 plus one completed research track", + "scaffold_has_application": false +} diff --git a/requirements-dev.txt b/requirements-dev.txt new file mode 100644 index 00000000..6b103ddb --- /dev/null +++ b/requirements-dev.txt @@ -0,0 +1,2 @@ +# Only for full OpenAPI/JSON Schema validation; HTTP tests use stdlib. +openapi-spec-validator==0.7.2 diff --git a/scripts/check_contract.py b/scripts/check_contract.py new file mode 100644 index 00000000..dcb34dfa --- /dev/null +++ b/scripts/check_contract.py @@ -0,0 +1,54 @@ +#!/usr/bin/env python3 +"""Offline structural checks; full schema validation is a separate target.""" +import ast +import json +from pathlib import Path +import re + +ROOT = Path(__file__).resolve().parents[1] + +def main(): + lab = json.loads((ROOT/'lab.json').read_text())['number'] + spec = json.loads((ROOT/'contracts/openapi.json').read_text()) + assert spec['openapi']=='3.1.0' + assert spec['info']['version']=='1.%d.0'%lab + operation_ids = set() + def walk(value): + if isinstance(value,dict): + if '$ref' in value: + pointer = value['$ref'] + assert pointer.startswith('#/'), 'unexpected external reference' + target = spec + for part in pointer[2:].split('/'): + target = target[part.replace('~1','/').replace('~0','~')] + for v in value.values(): + walk(v) + elif isinstance(value,list): + for v in value: + walk(v) + walk(spec) + for route,methods in spec['paths'].items(): + placeholders = set(re.findall(r'\{([^}]+)\}',route)) + for method,op in methods.items(): + assert op['operationId'] not in operation_ids, 'duplicate operationId' + operation_ids.add(op['operationId']) + params = {p['name'] for p in op.get('parameters',[]) if p['in']=='path' and p.get('required')} + assert placeholders==params, 'path parameter mismatch: '+route + for response in op['responses'].values(): + assert 'X-Request-Id' in response['headers'] + if lab>=3: + assert 'X-Instance-Id' in response['headers'] + assert ('/api/v1/auth/sessions' in spec['paths']) == (lab>=2) + assert ('/api/v1/attachments/{attachment_id}' in spec['paths']) == (lab>=4) + for file in list((ROOT/'tests').glob('*.py'))+list((ROOT/'scripts').glob('*.py')): + ast.parse(file.read_text(),filename=str(file)) + for file in ROOT.rglob('*.json'): + if any(part in {'.git','.venv','node_modules','vendor','output'} for part in file.parts): + continue + json.loads(file.read_text()) + for required in ('README.md','COURSE.md','CONTRIBUTING.md','REPORT.md','contracts/README.md','tests/smoke.py','tests/README.md'): + assert (ROOT/required).is_file(), 'missing '+required + print('PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.') + +if __name__=='__main__': + main() diff --git a/scripts/restart.example.sh b/scripts/restart.example.sh new file mode 100755 index 00000000..967e9512 --- /dev/null +++ b/scripts/restart.example.sh @@ -0,0 +1,10 @@ +#!/bin/sh +set -eu +# TODO: copy to restart.sh and implement using YOUR compose/stack services. +# Restart API and ALL used state stores (DB, sessions, S3, broker as applicable). +# Preserve persistent volumes and schema/data; never down -v / flush / re-seed. +# Allow operator unseal if required in lab7; do not print credentials. +# Exit 0 only after the intended action; test waits for API readiness separately. +printf '%s +' 'TODO: implement restart.sh for your infrastructure' >&2 +exit 2 diff --git a/scripts/stop-one.example.sh b/scripts/stop-one.example.sh new file mode 100755 index 00000000..ae149e89 --- /dev/null +++ b/scripts/stop-one.example.sh @@ -0,0 +1,10 @@ +#!/bin/sh +set -eu +# TODO: copy to stop-one.sh, map TARGET_INSTANCE_ID to ONE API container/task. +# Stop that instance and leave it stopped; no stop of DB/LB/volumes. +# Return quickly (within 10 s); the test sends requests during this script. +# Restore the replica explicitly after the test. Never print credentials. +: "${TARGET_INSTANCE_ID:?test provides target API instance alias}" +printf '%s +' 'TODO: implement stop-one.sh for your infrastructure' >&2 +exit 2 diff --git a/scripts/validate_openapi.py b/scripts/validate_openapi.py new file mode 100644 index 00000000..1dfe4a98 --- /dev/null +++ b/scripts/validate_openapi.py @@ -0,0 +1,23 @@ +#!/usr/bin/env python3 +"""Full OpenAPI and JSON Schema checks; install requirements-dev.txt first.""" +import json +from pathlib import Path +from openapi_spec_validator import validate +from jsonschema import Draft202012Validator + +root = Path(__file__).resolve().parents[1] +spec = json.loads((root/'contracts/openapi.json').read_text()) +validate(spec) +from referencing import Registry, Resource +# The base URI resolves local #/components references inside examples. +resource = dict(spec, **{'$schema': 'https://json-schema.org/draft/2020-12/schema'}) +registry = Registry().with_resource('urn:mtusi:openapi', Resource.from_contents(resource)) +for name, example in json.loads((root/'contracts/examples.json').read_text()).items(): + schema = {'$ref': 'urn:mtusi:openapi#/components/schemas/' + name} + Draft202012Validator(schema, registry=registry).validate(example) +for path in (root/'contracts').glob('*.schema.json'): + schema = json.loads(path.read_text()) + Draft202012Validator.check_schema(schema) + for example in schema.get('examples',[]): + Draft202012Validator(schema).validate(example) +print('PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested.') diff --git a/tests/README.md b/tests/README.md new file mode 100644 index 00000000..0dfa3f89 --- /dev/null +++ b/tests/README.md @@ -0,0 +1,57 @@ +# Публичные проверки + +Python **3.9+**, стандартная библиотека. Сервер уже должен быть запущен; проверки не создают готовое приложение и сами не управляют Docker. `make check` можно выполнить на исходном skeleton, `make test` — только после реализации API. Полная OpenAPI-валидация отдельно: `make validate` после установки `requirements-dev.txt` в venv. + +```sh +make check +make test BASE_URL=http://localhost:8080 +# без make: +python3 tests/smoke.py --base-url http://localhost:8080 +``` + +`smoke.py` выполняет **один сквозной сценарий**, автоматически выбирая профиль из `lab.json`: health → три пользователя → вход с lab2 → чат → сообщения → пагинация → ошибки доступа → идемпотентность с lab3 → файл с lab4 → thumbnail с lab5 → logout. Он проверяет JSON по используемому подмножеству схемы, коды/headers, Unicode, SHA-256 оригинала и фактические JPEG-размеры thumbnail. Это публичный минимум, не полный fuzz/security/load suite. + +Каждый запуск создаёт уникальных синтетических пользователей, чат и сообщения. Данные автоматически не удаляются: в API курса нет delete. Для чистого повтора используйте отдельный тестовый стенд/volume и осознанный сброс своего окружения. Session tokens хранятся только в памяти процесса и не печатаются/не сохраняются. + +## Проверка сохранности, lab2+ + +Скопируйте `scripts/restart.example.sh` в `scripts/restart.sh`, реализуйте перезапуск **API и всех используемых хранилищ** с сохранением volumes и задайте executable bit. Скрипт может опираться на ваш compose.yaml или stack.yaml. Он не должен удалять volumes, повторно seed-ить БД или менять тестовые данные. + +```sh +chmod +x scripts/restart.sh +make test-persistence ACTION_SCRIPT=scripts/restart.sh +``` + +Тест создаёт данные и сессию, запускает указанный файл без shell interpolation, ожидает готовности и проверяет те же данные **с прежним токеном**. В lab4+ также проверяется исходный файл. Hook может работать до 90 секунд, готовность затем ожидается до 90 секунд. TTL сессии для этого теста — минимум 300 секунд. Успех не доказывает, что hook действительно перезапустил БД: приложите команды/состояния контейнеров до и после. + +## Проверка отказа, lab3+ + +Реализуйте `scripts/stop-one.sh` на основе примера. `TARGET_INSTANCE_ID` в окружении содержит alias обслужившей тест API-реплики: сопоставьте его своему контейнеру/Swarm task и остановите именно его. Скрипт должен быстро вернуть 0 и **оставить эту реплику остановленной**; восстановление выполняйте отдельно. Swarm может создать новую task с другим ID — это допустимо. + +```sh +chmod +x scripts/stop-one.sh +make test-failover ACTION_SCRIPT=scripts/stop-one.sh +``` + +Перед отказом тест наблюдает ≥2 API-реплики; 15 секунд отправляет сообщения параллельно выполнению hook, повторяет неопределённый POST с тем же ключом, проверяет восстановление записи за ≤10 секунд, отсутствие остановленной реплики в последних ответах, сохранность подтверждённых сообщений и отсутствие дублей. Ошибки переходного периода учитываются. Затем восстановите реплику и повторите для другой. Скрипт — проверка одного отказа API, не гарантия HA БД/LB/host. Вывод hook скрыт, чтобы не утекли секреты; отлаживайте его отдельно с безопасным выводом. + +## Нагрузка + +```sh +python3 tests/load.py --duration 30 --concurrency 4 --output evidence/load.json +``` + +Это простой **closed-loop** генератор POST сообщений; он ограничен производительностью клиента и страдает coordinated omission. Он выдаёт successful RPS, ошибки и p50/p95/p99 **только успешных запросов**. Во время нагрузки нет прозрачных retry; timeout мог скрыть совершённую запись, поэтому это throughput HTTP-подтверждений, не точный счётчик COMMIT. Изменение размера истории входит в профиль. Для серьёзного исследования используйте k6/Locust/wrk либо свой обоснованный генератор, а не выводите максимальную пропускную способность из одного запуска этого скрипта. Для нагрузки pipeline изображений нужен отдельный сценарий студента. + +## HTTPS, lab7 + +```sh +make test BASE_URL=https://localhost:8443 CA_FILE=/absolute/path/to/ca.crt +make test-security BASE_URL=https://localhost:8443 CA_FILE=/absolute/path/to/ca.crt +``` + +Все скрипты принимают `--ca-file`/`CA_FILE` и проверяют серверный сертификат и hostname. `--insecure` отсутствует. TLS-тест сначала проверяет рабочее доверенное соединение, затем намеренно пустой trust store и именно ошибку проверки сертификата; network timeout не засчитывается как правильный отказ. **Внутреннее mTLS, identity/authorization, OpenBao policy и hardening проверяют отдельные тесты студента** по trust matrix. Клиентский сертификат внешнему учебному REST-клиенту не требуется: mTLS находится на внутренних связях. + +## Что ещё остаётся доказать + +Smoke не доказывает persistence, число реальных контейнеров, durability брокера, outbox, отсутствие утечек/уязвимостей, полноту telemetry или выполнение уровня 4/5. Конкурентные/нагрузочные/негативные проверки своего решения добавляйте отдельно. Список защиты текущей лабы находится в README.md. Проверки рассчитаны на localhost-стенд, не на production. diff --git a/tests/client.py b/tests/client.py new file mode 100644 index 00000000..f0499a29 --- /dev/null +++ b/tests/client.py @@ -0,0 +1,217 @@ +"""HTTP helpers for public black-box tests; Python 3.9+, standard library only.""" +import base64 +import datetime as dt +import hashlib +import json +import os +from pathlib import Path +import re +import ssl +import time +import urllib.error +import urllib.request +import uuid + +ROOT = Path(__file__).resolve().parents[1] +LAB = json.loads((ROOT / 'lab.json').read_text())['number'] +SPEC = json.loads((ROOT / 'contracts/openapi.json').read_text()) + +class Failure(AssertionError): + pass + +def check(condition, message): + if not condition: + raise Failure(message) + +def timestamp(value): + check(isinstance(value, str) and value.endswith('Z'), 'timestamp must be UTC ending in Z') + try: + return dt.datetime.fromisoformat(value[:-1] + '+00:00') + except ValueError as exc: + raise Failure('invalid RFC3339 timestamp') from exc + +def validate(value, schema, where='response'): + """Validate the JSON Schema subset used by the supplied contract, not arbitrary OpenAPI.""" + if '$ref' in schema: + target = SPEC + for part in schema['$ref'].split('/')[1:]: + target = target[part] + return validate(value, target, where) + kinds = schema.get('type', []) + if isinstance(kinds, str): + kinds = [kinds] + matches = {'null':value is None, 'boolean':isinstance(value,bool), 'integer':isinstance(value,int) and not isinstance(value,bool), 'number':isinstance(value,(int,float)) and not isinstance(value,bool), 'string':isinstance(value,str), 'array':isinstance(value,list), 'object':isinstance(value,dict)} + if kinds: + check(any(matches.get(k,False) for k in kinds), where + ': incorrect type') + if 'enum' in schema: + check(value in schema['enum'], where + ': invalid enum') + if 'const' in schema: + check(value == schema['const'], where + ': invalid const') + if isinstance(value,dict): + props = schema.get('properties',{}) + check(all(k in value for k in schema.get('required',[])), where + ': missing required fields') + if schema.get('additionalProperties') is False: + check(not set(value).difference(props), where + ': unexpected fields') + for key, sub in props.items(): + if key in value: + validate(value[key], sub, where + '.' + key) + if isinstance(value,list): + check(len(value) >= schema.get('minItems',0), where + ': too few items') + check(len(value) <= schema.get('maxItems',float('inf')), where + ': too many items') + if schema.get('uniqueItems'): + encoded = [json.dumps(x,sort_keys=True) for x in value] + check(len(encoded)==len(set(encoded)), where + ': duplicate items') + if 'items' in schema: + for item in value: + validate(item, schema['items'], where + '[]') + if isinstance(value,str): + check(len(value) >= schema.get('minLength',0), where + ': too short') + check(len(value) <= schema.get('maxLength',float('inf')), where + ': too long') + if 'pattern' in schema: + check(re.search(schema['pattern'], value) is not None, where + ': pattern mismatch') + if schema.get('format') == 'uuid': + try: + uuid.UUID(value) + except ValueError as exc: + raise Failure(where + ': invalid UUID') from exc + if schema.get('format') == 'date-time': + timestamp(value) + if isinstance(value,(int,float)) and not isinstance(value,bool): + check(value >= schema.get('minimum',-float('inf')), where + ': below minimum') + check(value <= schema.get('maximum',float('inf')), where + ': above maximum') + if 'anyOf' in schema: + for alternative in schema['anyOf']: + try: + validate(value, alternative, where) + break + except Failure: + pass + else: + raise Failure(where + ': no anyOf branch matches') + +def shape(value, name): + validate(value, SPEC['components']['schemas'][name]) + return value + +class NoRedirect(urllib.request.HTTPRedirectHandler): + def redirect_request(self, req, fp, code, msg, headers, newurl): + return None + +class Client: + def __init__(self, base_url=None, ca_file=None, timeout=10): + self.base = (base_url or os.environ.get('BASE_URL') or ('https://localhost:8443' if LAB==7 else 'http://localhost:8080')).rstrip('/') + check(self.base.startswith(('http://','https://')), 'BASE_URL must be HTTP(S)') + check(LAB != 7 or self.base.startswith('https://'), 'lab7 requires HTTPS') + self.timeout = timeout + context = ssl.create_default_context(cafile=ca_file or os.environ.get('CA_FILE') or None) + self.opener = urllib.request.build_opener(NoRedirect(), urllib.request.HTTPSHandler(context=context)) + + def call(self, method, path, expected=200, body=None, actor=None, headers=None, raw=None, schema=None): + h = {'Accept':'application/json'} + if actor: + h['X-User-Id' if LAB==1 else 'Authorization'] = actor['id'] if LAB==1 else 'Bearer ' + actor['token'] + if body is not None: + raw = json.dumps(body,ensure_ascii=False).encode('utf-8') + h['Content-Type'] = 'application/json' + h.update(headers or {}) + req = urllib.request.Request(self.base + path, data=raw, headers=h, method=method) + start = time.monotonic() + try: + response = self.opener.open(req, timeout=self.timeout) + except urllib.error.HTTPError as error: + response = error + except (urllib.error.URLError,TimeoutError,OSError) as exc: + # Do not print URL query, headers, request body, or credentials. + raise Failure(method + ' ' + path.split('?')[0] + ': connection/TLS failure (' + type(exc).__name__ + ')') from None + with response: + status = response.code + rh = response.headers + data = response.read(16*1024*1024 + 1) + check(len(data) <= 16*1024*1024, 'response exceeds test safety limit') + allowed = [expected] if isinstance(expected,int) else expected + check(status in allowed, method + ' ' + path.split('?')[0] + ': expected ' + str(allowed) + ', received ' + str(status)) + check(bool(rh.get('X-Request-Id')), 'missing X-Request-Id') + if LAB>=3: + check(bool(rh.get('X-Instance-Id')), 'missing X-Instance-Id') + payload = None + if schema or status>=400: + check(rh.get_content_type()=='application/json', 'expected application/json') + try: + payload = json.loads(data) + except (ValueError,UnicodeError): + raise Failure('invalid response JSON') from None + shape(payload, 'Error' if status>=400 else schema) + if status>=400: + check(payload['error']['request_id']==rh.get('X-Request-Id'),'error request_id differs from header') + if status==401 and LAB>=2: + scheme = 'Basic' if path=='/api/v1/auth/sessions' else 'Bearer' + check(rh.get('WWW-Authenticate','').lower().startswith(scheme.lower()), 'incorrect WWW-Authenticate challenge') + if status==204: + check(not data, '204 must not contain body') + return {'status':status,'headers':rh,'json':payload,'bytes':data,'elapsed':time.monotonic()-start} + + def user(self, label): + username = 'u_' + label + '_' + uuid.uuid4().hex[:12] + password = 'T3st-' + uuid.uuid4().hex + body = {'username':username,'display_name':'Студент ' + label} + if LAB>=2: + body['password'] = password + user = self.call('POST','/api/v1/users',201,body=body,schema='User')['json'] + check(user['username']==username,'username changed') + actor = {'id':user['id'],'user':user,'registration':body} + if LAB>=2: + credential = base64.b64encode((username+':'+password).encode()).decode() + session = self.call('POST','/api/v1/auth/sessions',201,headers={'Authorization':'Basic '+credential},schema='Session')['json'] + check(session['user']==user,'session user mismatch') + check(timestamp(session['expires_at']) > dt.datetime.now(dt.timezone.utc),'session already expired') + actor['token'] = session['token'] + return actor + + def bootstrap(self): + self.call('GET','/health/live',schema='Health') + self.call('GET','/health/ready',schema='Health') + alice, bob, eve = (self.user(label) for label in ('alice','bob','eve')) + chat = self.call('POST','/api/v1/chats',201,actor=alice,body={'title':'Контрактный тест','member_ids':[alice['id'],bob['id']]},schema='Chat')['json'] + check(set(chat['member_ids'])=={alice['id'],bob['id']},'chat member mismatch') + return alice,bob,eve,chat + + def message(self, actor, chat, text, key=None, attachments=None): + body = {'text':text} + if attachments is not None: + body['attachment_ids'] = attachments + headers = {'Idempotency-Key':key or uuid.uuid4().hex} if LAB>=3 else {} + return self.call('POST','/api/v1/chats/'+chat['id']+'/messages',201,actor=actor,body=body,headers=headers,schema='Message') + + def attachment(self, actor, chat): + content = (ROOT / 'tests/fixtures/sample.png').read_bytes() + att = self.call('POST','/api/v1/chats/'+chat['id']+'/attachments?filename=sample.png',201 if LAB==4 else 202,actor=actor,raw=content,headers={'Content-Type':'image/png'},schema='Attachment')['json'] + check(att['status']==('ready' if LAB==4 else 'queued'),'incorrect upload status') + check(att['chat_id']==chat['id'] and att['owner_id']==actor['id'],'attachment ownership mismatch') + check(att['sha256']==hashlib.sha256(content).hexdigest() and att['size_bytes']==len(content),'original checksum/size mismatch') + return att,content + + def wait_ready(self, actor, att, wait_seconds=60): + deadline = time.monotonic()+wait_seconds + while time.monotonic()|3C0bDCg50hY&IhVa-}PAeB?jayAv^IER`~Iyjp-)LWvQLWRh=OeBYm zoGEFQvV&768SgUXUB9RA@1NcF=XKp~yIqgH?$_f%K51_)Dx@g1Wy==Pw!jr)^g?I<%@C1k??w5p=(q(7=5 z`O)3FZPp38c>W(UJfUrpsC1dH4|d6t6J5HOg!bOh-6L~LXiXxo=aMmpV`1f-lBN^-U^$ZC)OrursoPQL4nqDJjNOl@^j=pB-ybDDfPPX79G`*_N^9O*vMc%u6}|94&9p<2h~vcw#jcs+B+ z9RC-(0KXC<)T!ZAe6>F%@sZGTDL>tfqpVh;=h8E}8;4n#l!F#7o}7ks&}Vq+H1}nwTAdz zJ?%HQ6(uesSdI6XQ$vX(>|9kIG~FKTb)7_(v5z6FtAo*=Rl(KlV8kQK5JZ>@vZDME z){Ra?y{is3z*Q|)Z9`?t6}!Z^O;}mE6B7reT}$q*oF--rI=hxUScxH~4u+%JYw*rR z_g6ym7OL>>MU^Y@d2&@>)zB_+HwH^km&g=X-}0u`40E;<;jW>8|wQ>v%}NXE9kt7HAQ>0s*7r)G6t&&cLqP9&Q?*ar)${eh_xEh zp_B9^l!}v)^RN@QA;a1Qk5X|q@}eUVITUS|VOJvudM;ZB;ZQ?5N{`Po6?QSNSux8S zqsX~*R;_5}3Dec{3~J)7=4#lcc@)>qx)o9GgF#JH{=;~ijz>|q2QRvG>V9-?^rj0T zbm=HWjcZ3eo3HUGJq=~<#BJnR(koHs&fGTM5xOVhi%YGXl1r#d<8k^~?)?mX)RTuB zC*mKiDCNyO+^~aygr zUO(t_UcVt#(KYG8VYyfnc|}{%TMed@ubIJ-DV1d<0)7^|j)>k!{a`{EXvIQB+D#Ra|??I2ITFD2k7h?qZK|x)sGINL9fP zxrSLICMtDh^E*VX&tp$mL{A*Cuo1Nm3D)!s39ewti-yq~6|-NB+gn_kIBa1pIv&}v zc(1HE6|ML*L)xUIin}{Yo8oLz@{ntiRY@^6x$uhN!@14Y%L)p?TXWjj_^gGHjzfXs z#Iin$$zO%$b>m>OTFG3+h&QCP zzMX9Qtc&M5yf~Id$2q67oK5TzuT1RU7+UlmVEc-$oum5o@+B&&OfFwfy-m24nr4bG zXE|~UQr{}h2a~+Z8n;L34lhh)tJZ@6(TvM*&F z44!_#wdUsbm74x3=elzX`@Sh&eM7a_DC0V0T|KwqwNXK=?7M2Z^zwW{>|_Y3Z zcRb)Tu5(In-P@ zx`cxq`h@pdFvCF(eZu=K@Z%tdVtwy5SB^ps73VL0eN+KCWbLP%|7kOaI46|dKS2(C zp?dajQHC7C)x9=4)(<(9t%j?6Lxda(EXY=h-OQmyWOek-QOF@(=pDCE#+Bd-4w z_oIL;bICB@;$|K_lCW$3Dl~FF+0z8+?vGz5qG2Fog4) zSce>1AQabs+03D6^5}gW&GcW4k;_ehQ4fs915glKf*x{ec3p=(29c``m%9&0aFY)6!WKcRjwFv zC?@>PdiyBkQ1R8z8#W7&L&f`J|I|e1`wEBNJ!*PaVcbfYFLmpyYnq{av7%T3Zho?s5tTh+dr1x579uLBJBs*Wf8(Syr7E+Yt{Vc`d&j+7498z~O$d0Brv%=~ zWBU$y5o;4TA}z+_zA=X56I(=(1~`Sq(7Tj`I`;M?ZAJV5bATPZJge@e+IbgyOeMBml8p%3ly{5tp1C*ayL`NR zN05J80z$wo!&Sgdi8RwCNXSYM7mYv74CIm%97N;KGNZXE36BM)6g&(t@{C~r+=LOf z4WE}ts3|Xx_l~(w;JGQUnD>z>F3_s5;ka>nIVkD5{D$ks*~s?p8PO$)tMVJKn0^9( zW&g@gpIi1zYR~lamo|O4b0iu4xxmo2Kua&6uqvd-h$S>;c|f|8d?;Bdw<}7<(a0=fdh6J2~oSHGfg)J`pU@z&+L{0qx>362mZ5D@n1Paygra* zr$SgcIWajKpjCJqKW#Z8sg-R)yh)xfPa)sZ%EnBbXu(YM(Tud-WdzzGgUXA^Kg*NI z*;@W=(!_vekhG6&3_`mAKQVh;%R#oX0RMXSoR))JP{G%;P3;55^ix`6n7HhLXnLI1 z*uJ=g0TuRAnknHf zImAw6FR@rYl#ovTVmG}j^^W{m_EG8Hzx|S0)_0I+RohV=9Hpc81tr>}kJKlt->Va0;d#(K2@%^*y>;uw6cD06$PPKa*-_d?+ znM;J&#s{-Cq*W;nw(;lL#?qw}1KV2D#!=e;8oOynr3-CCW&Q3j2!xt}dfFSU=SJ&~ z2ENnQw5}Sqjm+k-wQ~;^ZqR4z+52+e+x-cTO5^p;mTLXoyWYy{pS92ZduRI0)Hbgw zNBv;g7{~s^fbJImo$rtM2xs%VlVm@iTGrpL-Xd{|F>*vtO1L`ZgZ^pt){`E3`b%mk z$`AdebBzhX!9)W}mL5jdPH!oUs7m>r@t@vO1a}KXFe6D%C6p^cNy~U3E8ff)X0v3^ zXE#LNOR3N^k<-^}X^Ct}aVvkEf|1Q`9Ct&8u&~14^jhSU^iSB4Ksgo|O_fta7v*QK9f%1$- zmo;c)yg#B!tWN2aMK?#bQG0swWb2y79sX^Ne4MgXwoZ~y-#aAWdde4?zp#a#cLYno zXtKvpc%P^IpM%*A*q7`*lzrqv{f`8$8>NCSPYKk|ZYCAVM{qAtE_xL0T52KX)7$m! zWpefGpTMQL7>%%FgpKv4HI^PnmZtpH$L|Ve9TpZpRiJbB6p7KJA*+JOIaLrAke$*` zmzJIPEC^y9=iW@I)W-(~bkgte%a%Uo710;y!m@rXynpB^gd6mH{Z0bcm3xOym-TDq zrIKE;r6@M~otht?P>0$3WoHoIPkDp~q@?5#@={*Qer#P%@CamC2&40Y5%N|)_Fa0Z;olkgK^a%Yc+MTVuBzlDjo{JWDd|Mk4?NBIcX;FCTZRqLd#$ZBp zMB#77wENef=&OZ-4E#yt=~e&2GzQ+qmPQ!zOhsF8K*jy6im(=` zM`10E#LTQGY!9XWx4}Ub&ldeFDnuDr-CEglo4l4;<^(K~#tcLmeH>Xj@=dCc8-hI_XKZzrce8l`pw+Z|AG4XcR z5FLT3Ya!-kT`7N_RTC!CK+KX4=6EV4g?eiXyq70%{-?Ary$qB3mO9b5{Fj(Kasy-i zw&VD8=&EdC>pP@=9|IW@T{QBZMk;K5-_bk2ome^29{MpXy1d|Ybkm3qrZVFkrt*D3 z07r#bpY=O*I)bzHu#)&Y(u+P@qoKZDj7lT7iZt98suUfHN0&4hz3Ia%Ib>9Z;=?!! zN~>X0dJXHfBMYJC2EGmJtr23BcqOYGVtyKDsH{7?t7FG%gt8H%d4Q*(g z=+javq~~LvFc{}ob-9m6B0{f(tnTMN8&M4nZ(gt94a|>Wt~RdM@J8k@6h41Ht@fv3 zy>jGv=pX$*jcu>ypJOh*ecUB>-bL^ZpU))GA8V-W(R1PCn*>f5q9o~mV)23rJCrTO zE<{UEXoo-hUlhFkLRm)4Chb!CV8G?HOSsToin!^a0FAUPE9taL`=|R^orHsFzxU(2 zSPAT1X@dLlG*(%8b#E^c6HTHf-O)fIKQZ?Rj#vo`>MJ9^-OUUBb~h_25ZQw0$6-eg z?-%@LB`Bz@+||u3&rKQ?dx~8|*+-JfdvlQ`diF%p!`@fO67*;!VCxV87^yY)#!NN;pqWaRy%8sxvy|0#Qa z^S_o9LOUe*1}8tu#2GQVB?RB>rydrGH5~5F5=;G?qk+th!49(Q*k{vPu^q2j!A5;7 zk2DVQqgLPkjt?wlG41sI${**J!_%bcyVG)&?TJ`d+i2{EZV|z?^h?Uq3(PBm;yZAp z@oo#Tvl*wvR4y#1Ct1@2#m??8;4q2YIEL9*N+|{*1CV=151pX)_YL-&)jkZH>bB)>~Ab} zsG9$RW5v^PZ=e?8-jq*3EtIEdq+H#y_hdAyeTU_udQ@W}#bYIt*cvciG2#ev?`# zx<1}>KrP?d=jHgkfm)tYr|7%nfLhS0RO-h~YM}(6!(%q7g%x#g$Po?H(%wOzdxQpR zLH9pJE&#QBoco6U9tqU)X$75su^p(Tt>|l1#t=};&?od+Dp1Q8wz=F|JL%9kJqfK6 z1=JG7ZJ=0t1GPjOy{9APfLgqVV~xf(sYTAAozzE<&o>qJHvh6>mJih8-MP4;nGe*G zZ_pl3-=vm&icja#CbbM{qVt~uwS0@ZJ#^6&-)c z-aswUZ6D^oqk&qy|9o08$OmfiUW!?-AMy#;Z%9*ooiq>Bf|pmZ6~EPRVDbl(6q&M6 zRw6h9)FOT(?E{{s&b|IW#s{Dl@s$3TKrJgCGn^6?pca+26~+so78>WH${H7_WsLJj zMSK~kN=^wyZe~tpe17FInX7&H-w{mwe`$#wzodYELn_r*g*PfLfSbs~m$kpq9A!w;Wv+pq4neo7fznmIG)mb#jwha)$7o zoK0#;n^SQk0ky<=d}Cb}2Wn9<|9AOD8c>Uh`H$t>X+SM1Q~&c=0BT_dRHWId0JR(l zHns3bq%P6#dXNJ8VA(EAy)QZJ+QQL zKH>6YmAQ%P(<)Bya=@>K|Zk9d*k<>_*>>c zEn~mT*Zu`+`L`{9?5H_Vi}~8mwwy7b7W1{WxNBoTE#~4s-hHzX68UG>-d=kesiFf%f7SCm196HrTM(C-+)>st^HK< z*MVACoD-_<>p(5Psqgx?r~G57*LCO z1UIf`45($S(Y${hsAVm#eQbX`P|L55p@k3TKrQClzl+#FE%VV&a}>;hT7FT-`u{Um zk@%N;HzzF~s3ji%l_RMN)Dl1Z)2M%wT2!Mi53d5X4EDb=FX0-^0JW5k{fZymq?S^H zU-1J#EiV>^%>B4PEh7tr()!;(EuW&vWB1L0T7G-auPT=UwZ!YKHTD3t4ECQ_{r(%M zh086=$%zMQ;c}~U#^QlmmK&$~ajHNqs!EqbSAbeR1yXVznFF=_-soFsH3w?>z0tjZ zDFteY|MPWKt`w*xK74JxeGI6j^y;sTp-pNj-GBMdm*{*yVdUMTqIdbnt%|oC-C}%A z^XryaKI~R+7Jrpom$*c_;UO9S)-8?4w%yx$LHs%ye@L=H1gK@(lsGl0OQ1ZU>)AGp z5Kzlb>cy_h+kjexsaL!BwgI&Wks`Y+wgI&W;Pw2QucZlAnW=Z(*qSW_)UsoIZ`Z_D zpq8!gwqvz`T0*aJwzUWYwd@!-+OiF(g?|xw*XCLsJNcTn0A2^E<>s|Y0lYp?OXjr? z+b)O$wdgY6ZXMeR)MCI~-)gV}s6~Fc{MrFNpccW7-TvRV0JUuWB|y~!YRTB*EV=p*tNr3fm--Pc1B*lrbHXx(z|V1ev?|%nJ=zYYy)Z$BiVF$@d34L z%NE6=fm-6b-t&Ew1Zpv6`fU9!2Gk;iHDlhq=1gz7_KI(K2T;qtuFG4O#Fwx6UlZiR z%K)_?n5->1+kskS{V!ZI+X~dOy+Fy|_Zm>k))KL0+iUAvLu9wdW0=uffm*i58!>IR z0<~=Q6XTue0&3YRCm4SKsAc4u%{H_sP|JR1)3xv0fm-DJP>a>I$6KfPfm*gR?qO1GV_Q_|HN`0;uKWizEvbDWDdU*#Nb|6g(cNMJ-!|=#oBPZk2vZEn5tz zMQlQgW~2txVu6$^_euX*Zjqj?CIQrb3uMa@qLs6}W! z>V^9epcdga?Ccjcpq5l`si<==fLhe@Q{uIOTAoP^S=8h&`zr+0qCGo${cq|tVrrXpm7_+mWQ?PBqGWfb|IYnKKJ2jH z?oN{YY_+VhT|HC6ilKi*@1Gs#l0RsiR?j(Usi(1|_Avd2#*zY1i#)MDJxd*^MSV$` zSeg#hqQ0ccy_OEtqOOAEUQY*Vkrbye^w=!P^V#W-O6K=F_PJ2 zpcW+-b;mb#pceI*%xgPYHYHkLk3WbCc9eFfdbT`L1<0?paIm9LApST zRtIXKkgm{#)qz@$cI+XHr31A{8ju$yCf1xpVSg3oe0=1a*H0;=Sbdy@rv3uE7=|C+SAEmfc=@s;X^gxYl3Q&tG_h?j7P*KrL1zY>$Q{P>WT8 za)5m@P>baJ(E>T37MJ8o4ZL)~71|ws$vMWB`o!)J_U z$UrRyeJk?11fUi|Z8rBxra0}6ylNkB4^T_4d}$v~52%GA9}-wg0cuHaH0paG57c7x zgvL+=YKa|=AY4%bYPmeDN(iR_wdl-`8C@jTYD_S-L{ zWp)lFUrI*>{Fi)53#dhFS~s8~Im;?H`I7duHc-p+lNMD@*SJYH>~+-T8Dk zP|GnAp(j@gsO326e9tQ>pq66{{eZP(pcbi;;^m@bpcbi;(&fZtpq8BmCm6;+EyNxh zsh{>hEqCrlBo0XdwH%8)lUO4K)FSO&?0+aRgx0nFjh6gPpcZWR_3dx8fm-Yg^}4fm zZc>X>wk;L~)H0vky1T;^s6~s#NajcZwP<%7U@7keYLWh!x4e`rO~03%D{X%qsKo|* zpgVIrP>b|*KJ(9Z@f}(u!)}Y6KrK5}?3a%v0=4Wst6h)_)MA;~wsT$+s3nj2Y5Umj zg3^YwhkJsg&GUg;j`YY$ciseQxw$--T)!Krt!-fi!|DXXWs+V zvh$X<#|@yCJpb6lHEE!h-8{o?>zzO?yLl$vK|6t3c6${1`y~D#SR`ic#ApJw*fwZ( zPbCAjNMFfaexD4~BK_xjq*o76%g(FzJewY%mYuEI8wY?|ta}bh|H%Vtap)=D`PYuB zTg`9pSn*)oX|dd1NF(KTkJN>Xr#eM4b<0kZHmu4WmIdl38oi*^qVrOwz4C=+N%^r; z4}e;9zEn;d1GN~=`RXX$2Wq)Dy?@SJ2dL%#^uf8UIzTP=@z^;v9iSFxm0L}x278?+ zkvG^cWUTK4wcHE7&0dswWcfuV%n6wb)PkWCb>7_vYPq*quuTW3#VN*qLKCRv$e^@y z$xWb^6NApqCAWZDjt++Fv{wSPIAe}JO@ANoV^Fs zQpoONWG5~6+mT{;gY0)=snhHCa z7p}D31Zr{WELgdJQwQKtqkIsvuVG~($Q zGP?AKGBwT}r9drO^fVpw6F@Dy>6JR>Hb5=v^mj5}oPb)KLTwv$fLhLE=<7Ur0Mt^v zQh0Ob0Z>cnO4`l$PCzXu)}sggoPb(v+78Tp*8ysA`g41w{w7e1(~|9a#GubP{m4{B z)1+HKEqmn^hDB~Q7*CEcPe-QYm-z}DwAj@n;+XnjFHL>m`dP*S3#}CqtG>NJErT8h zIVB1}EedOcj6FatyEz{f)&_uD3^;!j#9sil?BR4Phz|g@+~GE4j_g$_DVt9hu|A7M z0kx=G42f6=0ks4L=dub!fLau?hsM!BEov71A}@eiZk9!-q7{Hz_LdZI?_~nD>@B&& zZOH^`*?VD#aR8{LHZv#)uMO1Fk+~4mu?wgrppUZm=P*!95%-_WXU0G+XBP`uO(H-o zd%bV79*X>D`B%g}Nd7udi(&6$1%Wd_Eu)6Jdw(bZwHS*GMFwuRTGBH$jI#%UTFf~5 z3K1hfEdy8#hnfl0q7X4gvW8a6Xy(N;9s7Y=bU3q_&U=Ac_S%mbY5=u-6j?h%JqXmI zpfbFC5?U>8scFXee}Gy%Qr{}fp9X5V5fGjlrvTJ)hJ@=iR+tZ}J$0S?HgoI@P|I~L zJ=5R}P|KNkGmfqTP|F#(n;)4#Eym~pstHibx6Glvow-0QzNvExZl{4-&Uh5F{u2Re zQ7|7~cHC^WD435dpW1A-C`_I8$Ome<9uSynrvTJq96Hco3e@r?bLR902B_tC=E2j` zw}4ul`$~=f`~%eD)%Q)|>KIVV4enUx)iXdXxx}EptHw)%=M$nQtIS%EPpfi!Uj)oI zBo|kNi)p9nb|8O5@yxbK&ZkFxy`>?0Jlmvy$!zb9g*{QX%+@4aM}L{E4Fk0dx4DlV zH3MofTN`b2*le|!t&PPU+HAF$iI2t|gI3F{qO`ftTdT`RQ|npm-hM|jpcXUFc`Od7 z1!rA|?4Jc{86kRSUoZn|F~iLtf>uiL+4yfgy)ybmDIiQvs&0eER zWmZ;%TBW<7-GBP@PcnGKk)&I(@WWeZP&`4s@*nB)1s3oPyU_M?4sAbQ>keS~A zP>cQoyQqEvsO5I_@zMKcKrIX2w^oabfLfyT#v0XuT2TF;k>3}9S_ZfQ**Q@_Ed$(h z*<(>aEiW1|0MK9PsqnWebP%ZJcA!o6BQv0ug$=ERRx_ZMg$=cZCq+OlQGbe7^NWC5 zqQb}4FF~s%r|9bZhAvP`Y0>`ZKZVimzQW#jkLuq=0JUs8y0saoWm~K;mfxF&sB-Tz zkVtPhqJKL}kg0BWgWzU3d&0cxpduJar0 z0c!DBE>Aol4AdgmanJwzHlP;%U$WHNO={WZE=zp~)bhORHNSuiP>WtUt~NiF5f7l{=@KrLvJO}CdYP>WEuKDKU?TDsp0e{=+DX=eKHe@6qg zps;Psn~6XziLZo*_W-rDc3tLQG5~5x5ERC{0JXR>S=(}CfLh%AFC>`p1GUH$c=`Ko zwp#d0(95<7>--_IGVxEC(fmLyGVzT}8-Ab`em^wt#Ad67UrsLm*(S9l+6bZbfm+&` zO^M%SfLh%B;}Q`3KrQ@ka-`>*)RG`B9PhG8EeQ_7@ot;clJJ;+3IWt2!|?EThE~ha zHZP%2eV~@7%zgaN^?_PCnd1Dd2%r|1<%PuOGC(bEk(at>gn?RQHkz4!{6H--)2Eha z65BI8nNp_bcRm7YxoLQ!KvORuzsjpehb2^R`Aq5xv|2RFrP}k-t(?^L8!thtMKj}{ zGtg>rZMrgWzy_$rX34e55n3(B2cFq1Id4+Sz<)L>CpW2OAjw9>38eh5=v(=(GhK{q}Y_({P8N?liR!h%6a(Q1*0ku$PH8n5g1GVT+ zw9?LK0=3+vHql%)fm$@{&_;JRsf8S3BZ2~I@g^K2f3X2-xh3z$?vvW27ESA0NY_nj z8Spys(G#e}IVyC3s0q|!^U-%D`yZed&F`qVi_mIu8W_;5yb08jSL91Ly4h;cT+$_8 zg;t9V-h*8x1=J!Xo=>{BNi9;%Hp4nVE#QZ>Okpo2?ej{Ji+eO=^)EvZ>tz)Pib!O8cz| z)N&%;gIys7)N&%;lie%@)N-O$zp)OerHs}mRd@oZGC>2&hHqT*?RC)9UpnUG#K;S~7m?l;L==-9NYB^pblRjAIvwFx57g4k z{wKpm7pSFU1ml~AcGP>W+gSV}Ac zs0D#>W4HjdH1*sP^3nxrspHwvBXogU>UkFQFa%JG>qZ;f00GqEI_=9{%K&OY{H^7= zZ?;+x7u_~m*>w+PspjV=e~o{(kc<7?TP5CXt{3pe`opit&%FrW%ab+Y&*3G}l(oy> zgV~>YucjyD@bRQ4_P+aFr}UwCbA>YfLHzifhN#uC-psFGl|`G?P1mI#jF@x~3U9-Tf!FHzmY9HMne6l4#(+x%V$$s z_jI^UKZq>q;RU>yYc+12tA249giyi8;NuRIq|;Gl6!-#p8N8(L_tKYgf61islgM%KID-juc60U zrVjB%rp}#um<8>;lpNjoBdnv1$62{TrB1vS(ot5kP^mMogLIg6_Wy<_9komZzn4rX z;=N4AL#8SJd%75Zy)Mb3yO6EVAE8UK?zV5V>24Rgpi6S-sAux=tD<F+Y`J?m4iPze5Rpw94 zq=1`aO?JjJm#_MtA2O`zov6>`Uns?@;HvT)3fJH9r8SCa}QFU z7yPI^Yw!u`J^3dJk@s*=?1*!9jfu;h@`@8S_aD8K6s(SM{U7SGWYyPudtDUB9%ss% zng?C19@$#evHcM#dt6;m=UtHMVy?u33^Yni&c_v5R$iE~RGyZh;d+SfSYDY?;rg%B zgx9~0Z{6pNP`}B4P&uw~MT1+}q&)2^yyM&<;y;6jQGzu{_0)&>Q*$~f2SjBx-e*n$ zl}0vpEx8{>&1j~Zp+;SaB^j%9eiYip=m_14O+e&VQC;X~*ii`gDykFR6(%Ncs$gCc zOSqTu#dZ2FVe%^0b51@l(Dmb z**=JN*ADHE?%ae7ao70W=5AbahJ))BEpzwvltBYmct*LcXAMTU!ZXT!J!w$Y_0R4r zZtIjmKi5B6SKQar1`nYA%3Q79@R~b_`s*6P7gFnL&GA)SlZ`c9sv!Dh{jj{8C2E41 zWE}fiNxYgR7>qw@GR3eAbj}*FjLy{*isF)K=kd0I za#?AVI>nrEhF##r2@B2*#WL=m31`lP;-zz6^?wD!C`A7MwjllIvG%=Nh#jfYCPh^N zcd^HNcZnvMibz_R7S*z3L@P61nH1HrL_~XOw-rZU8hUfyvXNN}=kX4lb@sL_x%0>} zt~#-?&&I^}A$Kpatxwm)x0;J0KJE)K@vY(FjGQ<>6eGs5pAX7E3dl@tR1BBdcaD0h zS6?w4(Rxn4GN2=MC!sv`y{YZX$TX^R?`ctI6I;Z^a|I6qo~9}g9;BX93<~M+nyw&b z_gyj_MNDEHIPqD+w9ATe=e_R{8$HU2)qTHB(b7Yv=6AV=vvg@EvT97~rg+y=Jwr_J zwJb@|5IRoui)rZiauvz8m!nuR-ryMea`|3rr3qfYWMa8Cb-@I0;5*)Ms+XeZD`gN8 zZ^e<#@}gt1>d(j9aV|7kaK0$cjPo9lY&h=~XC|o5UtjX-`aUSmNPiF6IK)X)JSe3a zvSG=oR5X_^4dET>%~$M{@(bY|?QK=;l%5IU9q!FhydrflglE-TuXsiJc?i#VU!pw4txdGmkN&T`b5sDQ^f`3*&sS~FNBLq@_9%V{ zEpM(KJzL&33MJdmp_-mwLMtjBWnUZ&a~3E!`qk);+_w8z-KGV>zLD{hYcsJ}E}X1(wXw;=Sns4}{9 zl%H*0EF6n|+2)})(dM%7A1n0XaXmvpkwI`iM|C>K@zq zAiAAVwi;U;u^8{%aepd^j)kJku?Oveug3&g-A#W}{rU!g%1%ihITw{`5A!8X2Pkz@gNNu^^VF_`O$ zwRsA|qAH;c68F0Y{j<6)Xk`N8#tb@>RbJDrA#%Z(;q$K{>E2;^{E2@}NG;vI0+%S} zFbaXu$>tWMQ6Ssc@DMVBxt&j2QGSp8Uc(n%{(Kg&1<_W*(z~kJCVZ7j*xoKf;)8@{ z5s`hQC)j>wo4}Ycsgv5pOcAh_?>Ocix-6BHuh?Ph9lk7-ryw8UpI8vgyug<$GOe~`V)(X8hR>Pq zBk(|>AlyH-;GF-h?zaNpW!L130+)T0qWMKfjj=P#ZN$><6ahH}Z@pXc-shLEBn{D` zlEmfX$C*NnFPW&M8d3Apcc&Ej#Fa?2F3-l%uK)2ViGUazFH;k=MM7l?MeygCI(!b4 zAQ5~B(~J+CSR@p)T%M3m8xrs{qSBdejU&t&0Y77^&sRg<)9!sDojM=)@}6{G6j_pK z7wHU%Z0%m7{T4WA$Sdp4q4f(KG~!h!jL{YZIt`caC&0l(7p@&F>L7XDrFn+T~*@scRfEE=AZlcbHVh`?8oxDfy=f_Ax$M!5lsmL zsai_p|7@2cR<`5{X7p(l7KEN}x*Z(elrnHj%Zogv^}ZlDq`Wvd;)qe%oyA=y(oc8x zChOqtG}tn9)E~k2knX=Nzbktm zF_A27CnBSLTmCemfviTTBInu_5!f!oJLFe(MFE5Y>?_(St<*xiS5e@KckaS%yq~xK z%8^_RTi@MiOdNT@#?Ds@y)Q0hK-bP!vknuNH4tLwt9|rN$H!SwE$jaTE9^3jjHYN= zY%S@1g;YB25gQ}TvCZ6PblBE}*iJsKwIp%zPC+OkgIvu;hoD6W2>Em3RXc2PuB0(ETmNG`<|Eo)4OEl37P{tNcwpJ?=>xgeNp;q0V9y@ zz|AK=x7!G0`!!=4=$^59OJ|4?j&IoJvTKh$941>CT?7kC7VV1cS}W-qozE(eVyB0B z%&;|SW%LkiDA2*Bgz2?B9=C64z3XvOKStsX{|8v4$SCW3$c74MV_zhObT>08T}QNq z%TkWfWTk|Q_3z1soRN*D2zu#Ro@;FK2;@o-tLVLY7aB>_#q-=9ln;6rM*^lG1G4swkq@yW zJ)dMp8w_oW&aw1_d-Y57M;l3X^i{nQ19Staj4ml_ASLJ3L1W*SHIUBt>gZwT$<|A` zdv)}&AIsKDYv}t%a0Mt8f08C-`#j`BSVxJuDTVse1eP1IFoh`F=T)#v%ai({XSeXh z^!@s_PYmfjF2wwlbFvS-3e?Ve7MvkIp|{fy$S!zvykUDErmX6Xwo(sG2NBEYRBN@IgtZF9rN9sywhV?BI0Yp1Xh zT}#-(lQh`#imf0#=1CgufkvKip?*g&OOx9~ch?JVq`HPS^B&UQ=!MJe*Xs=Dic%sn zTJ<`^xXP6MbTs9==X4nN0JoDau6HGvtHEugJLp|G&obt=r5NbNpJTyVASFUCK7<8p zffQA}jbN5Gw>ia6Z{s{`AGbZ_px)QUjkXYPWw9`0vI`9SoB24* zn4BD=V|;!`p&XeK=1W+0D$FMjh4}`oo+xxD*M#{7u6h=}A>Y8%x5g!nIR5PpRtgNw zd`zsM4)l#+!W)S-)R8`{5+}@7LON_ZJn)~a{j_2XJXr~W52-_aCQ7fuh9!){hMUaZ z&wpU66h?=B42iD0I}(Rkc<;Syskv=@UcHb)mnyUg`xp^@+ar8+YoYi%Z#B1f-e;m8 zkEDf8dIoX=lyVpzx>IjGA_9}L;4L>srInkUl|{(S(hkF);hf`UW(9@egE%lF$Qr@; zws8L;y`9&^v@)hqPu|AAo)5vaQj{@%t?Q{H`{-VnnJ4SnBgKULk&9tVPu5FFGxLI& zgDvYfc#L^%%)!Up+q~&MIZS5@7bcE<`!Jo4xiE3;6USU>;pXz*_8DNVJmwbiKJ=+# zelmE@8)rBXN`D!=H+7<48{CxBE}2bxO~z7ldM_(aN&isBL^8$$G#X2L|5H|BE+3j; z1W2dZDPyEZl%GU0UIst~H$X`+Ou0q+oAMqp7eVFZ`9l|BkYZ&mc#H3Sf`(WW6Ss`y zsYi|v9A4Zd)tE#(93)uX>v_9(n$;~P?1-yHPGRwu$j{4$X+B65^iv$ZCtzP1I7^x} zF1Z(+CCz&O*SUt)MGj0t0{?Fbg8ah73WBqU*+)i}CxNpFCLu*G7+Q+NMm8lmBa2Y> z(UDJ+jFBSJK{)JCcVrqk3$o0Zs66?cJ9j9lRX9ZiaRM+Ww|Dq(Wm{vMjEc~M3KsPvxV6L() z(a?2z&i_u*C$Y2Xx5dty6@6OZWb$vUWV;s_gO&$9O-z+*JVVS7cw029@+VM*)$EDC9Qscd@l=}B`soqd_T*+ zafsC}c5#2aL&x`JzBEr^v566SC08>eD2FHW308>!#AdYu@ z<1156@HviWx3R<&7rcbr(D@U!+?sS1x$$LE;KHez?4f7gOZuOmPWR7sqQ8)Tp_Qni zi%mBeV{?Dd;*oK8gTFSBhaR8{$@6G0YUrmX*bOyhQJ$dRk$<9PV_Eq2nc~i?ix6l4OPzyS$k)dFIjZnWYu~{FFUDZs-ti6?L)LxPl=x zT3pV@M}^f?I0Vizq~X&u2hK87;qx=w{#t}J)*J=`+=^2P9+=r6wMK+L*OjvvDmnhA#fJ7L5x|?95_pUKDA?V z4xA<5o!aqo4xAa~^#3t+ zC;m{c@BhHF@4K-MLTKzmX=oZnQrRkm>?DfHpc*w~HyB1C%AhDz3TYW9$ueV*$Z1nK znZ;JAW@s7Z)bEidA8nSMrRhfTELO*7t zXo9n7c7%)`PrXND&LAtl|3$T!PpW;iY^_Q98DgE%IXDy5PM_IR`Tc%~>ACyFo|$ax z08)i@KxfFuMMKRyFKC1bhOzaF!eiDi?oY5d;4DSVP%JyDVPcxIL(`{|un)`S1Zj?S z5+Fqo)lsAw+O;O^_;TSRE9-lOhpoepEnj#9&hqGGXg7NioaNEI&~9#0)5OeTXyyIT zZnL*1mNOqIg{H5;9bYbZ+~rk~*F7j3fsrGC0o@P^@R{p(n~*r^tOCO1qUoMqD|E}heJS896f5lAFW@ZSCI(!CmB3k)3Zn}b`D$3|JUGix|7xY|P2en>s0(a$C2$rj^%GlO z37kcLbkTNF=q!}Elh`q#vrsfoBH2P`VR~T0-V2?DX@L!UCv+BOJT~kDILqJMulh%M zLTC9HNzQNA2WLs8z3R8p2WLsunv3kp2WQEDv&nN2oaJf%ekETlI7@2PY~)}0;4Jw; z`mv|LS-AKT=BZ7ih%cBiE|CJxqOW-}WEz}>gTKoBxe1(Q6OP5-LIG!?T*u!0CMeC{ z7mvj*uvL`6S(H9(O5lOBjP!H$YkA--i@eMEO;~UiKCdNz4hzo0YkSpSqz}$=ipbz< zP{3IzttW|(!CCsbAM~eq;4F{0Z}g}5;4F)Ro6LXo!C6kN^lQT@&=9b^ZkpFKY>|rAqKTd;o>-_W$Co7M&Hf|<`;~=23ahf|B0OdW~r+f z)2RbyNzjH1sdE=B%mTBpm$ujOfLY!x#nn9^0<#dme8rO~z$}#LG~^sG%Uh-l z&ie~6%XD-pr56Xxg7f}{FQfpo;Jm-%^C-Y92C>UppM=aZmYh~QCuEi}xwH}t+DVlGe>hE*b-784F13o&{!MFCD8pDgb7gSvp+zSpdwk zOnfC zfLYR3*wGXUFbnS2H$H`O`rp?*BJs~GqDbs1shS6VI>C4B6e5ii32bTE<<&*0x*ln7l@xmN5n`)YP)EPVyR?Hg~W)MKC(?YrpG+Os|T1xL`iPK1ehhh$5`~Z959PCVgF`v zU>12oN>7*wFbf1iAaEkgfwYU1$N{q$uyR(JNdmLT+OF+kt#XANh?x||1eoRaswOFn zF)+)4j1EzGC14gaR;S3A95BmjR<4M!2gfm!5j9ec`G0keoSN>u3s zvuH=`?Rg~v%py)zr-6K#Q6>{!<_ zu8ZN+FTS|2N=b^a2AIXV=f^5tQD7E19wEa_6qrR6tIfK)3YbL{tIO(K1*hm!X*evskgNi-gMovq%e0_G}OZW|0*f?>Qj~%p%&Yn|PuJm_@`{S`gU-%p&3} zBRH4=%p%e)&5OwZW)bO@;T_HZW)Vr3=0#@!vxub2@ZvLoSwwzGx0wO6w5~cWB{1uG zxaBab^v?U7Nef_>BZFx!pLBs)3~p^1%rgXLartDhm{AJMVpyG%paaaJf6Hy~oFOoa z;hUT|U0@ai7nw_W^Q&(wpOiKRX31-FnJ`4+cS&!^(d^UQLh?53Q$9m-U1R8!zuoo4 zu*7RbZC&(<+AdbAefMuy$))fLZdePWxL+AGp;ir@124 zfLRPU6Uxk7U=}633rWotm?c+BJt~o87!^kRv+N^1b)~8Rv)I#v4D<4VS=1IM zOXqTdS(F$1N{wBBSrk)u40^Z%vnZvy4O+MYvnZx|4aU0yv*dN*rWFi@%;HLxK|27m zG%9b%rhQKVj#EsJ%4S`t^w4!hjWgBekVxNm%;*yWm}LV8 zr}DiRn1wR2I;x)p%%bw0LfA|fbK{b{j2w!AStt`mQIANle@i-Sbh{Xsg>rH0F5?vC zed3!SjiRn+9H_D&U4mJgrQ2J?Dq8K*BpsQvovw0Ly2kjjN_>pU5=qM4a;tWGVW1i? zOB}u5=y(Aziw>Ve`o{>E#YkUUMFp6}SYNL_fd01L2l610Hxb4_5^}gkz%1?7>60~^GHHwQ5o2(r3=jBn^SE(sS3;zoP$>xa0h1D zM%&bPSsIwd*t5je1ehft=b%cXJ21<(Dg^#G9hgOBZfn;DPDn3l$!L@U%%X{pq`RpA zv#3;V>v9HW!E(e@49LJNWSTkWJxR%}`HpE{zlweVFiTMzt}jm-n8gUI&n}SGWi(3r zY$KQhvz(V6+eWYkX33SVHtx~_W=Wz47#%49W+@UJqQ5i(W-;p4=NFTJS&X{%_%)=B zjGLs-+a~pZS<>lBM(J9>EO@$)QMwK=OKOgd5m6hM5ZELSPo%dvjI)RF9Hje2qrqon|tW!-Ef`aT_)r8sr#$PqL!3z|YM zr~+m|Q%YW00JE5Fo6=&^fmxUshXFhqm?fI3%%y7qv!EpzT1a3P9qzPN6CIdEgZo7* zmJZB9#_uJw(ZDQp?1tG?G%yRj%XXGj1ZZ6);P5n99;{6);P5nA+0oDqt3L zD<#!+1ej%BD>{l?49tQWc#J+$0L)@FK-1zz1G7X=>PPP(1GAt_nN_O5EEWT|wVp-; zvqX;+I&K7JsjW(mdaIj!Gh!qaJ;wxQDeAPHt*4QdYF<|k zFpFwfRpQn@U=|sh9fX5@z$`MY+X*p!z$`MYI|zsSKF|kqUYd0o3YjG(3oSEX3d~Z@ zniapd2AJhsL`W822ADtA_m}OMFOwDr#FiSYz$`a%j+zn8fLScq_hn9)0khQcvU3bffmx`$vYa|oV3t}|k$AW%FiQ=q zT71eBn5B-DFYas#%tB>Via#_3W~pUS#80ULv+U%Z$U3dMQvFQQJLtOi@Pj?TERB<9 zGuu^RUa*Dky``IawXB1fFi0~o-a4@R4Kr?ovlwUTo-f0GNyKsRi3-ncP}b_4={^Y zYT&Rn3Yf)L|IDr6;ZODM!^XZwz$~%D4Zh!Y0<-KG-@rhlfLTx_Uigqg5spCJ>@o%o z%(AC&3reyHn57Zp$UvchS*~CwsAn%L6WV*#Wb>FMoNt%K?~W|L_Ojx1~a6abi@dNBaV^?8GM*2JZo8@jzQM1nO#Z zy86AQs&ZhK*uo)H<7Hr$ooFk@7j=6&tak4i^#*1!o1vC}Z=_mOC4~(yqkviVSbKJ^ z1!h?@^LP38CSaB(;_8`f6fg@a;7Ul%;wAMvFD?@>3}X~93+hGFL@6*!U?I~Ndj^=L zoHL~Ea|M{CjPpu;>9h%oBSpZO?IZc17>p zF02}u#g6+``{68{Z`t*EHPS@kwjQ$iOPFp?>P+2V&6Y4?`sFl z5>s_9@+7RY9LNjOj*SIoDZ_gYoU$K9j9_fID`a36ZOsEA<-jaw@dpQf+5@xL<4XCx zWDEK*`MTZBQNb=)XR*Ul*=OYA8Gp%tuum8SX0hz&YS#_|vkde0=QY^@vkdVP^5*P- zSq9r2`-`-JSz?JM+;ik$#$9sj0iqQ!i!t|u_S7ISiv{MDF5-Tw7uayU8 zv0JHO*UA4ra3?eQ#kI2JRw^)y?{R2U>3yWLzajHFpHc6YT`C9OBcKfZY2lIB6k<{FpDK2r8i6hm<7Th5H=BJK-wirEPz?USvjI+8o(^( zw#_{(QD7EPGfm7DA+v}!X<{0L%#zt5D{lkL(!}bN7_$IoxyZ_ua90Or3E`d1s?-2x z3F8%J1!w@Xgz_$Az0?3^u_UDR>dFe4MN`W+B0;##B5}kz(L=b+A~Ar_3I}EhWPKAY zlLcn6wC(IE7X@aKXhc+n0kZ@}?CpIe0nDOK_2s?IN|ultwZJ?SGD~l+geC%*MLlF6 z?-wlpE@mmI6Wf4UZn3UqU6;f80keoIX%a32v)t_YA*w42%woYKWSYqWv&dqDSXV`X zS!A)ntWHs27TE-AUX*Z~MIszUy8_H|gLPdZ+ya9$u23cShbHVZ66SBZ8vfaUn zCxqK963%M{k-}{j31^hxpm3W-qI)ebM!3x)(T(CA7H+dhq_5>g3%6M$(owv4;WmrJ zueEJWLS_*?ttn{gdFXbSb@tBt^2zH$W*JJ``6(EfCH&Twp*#~{mYtu%7c=Q!MhZwc>uFiX!%7Y!Zu4>L74}2kC0gko_bJs1G99{ zgG}-&fmwVPC(q7R0JH2`>^p0`6PU$1b;pp02QZ6Gs@sr-2QZ6us@G7w2QbUIuI_0C z6CtyBkWr982WC;-P)WNYWENHKPO=R!izWV4!44B(mUC4hQ9EIq<)-S>ot`$pESBi& z(+g*TS$2-1Qjfwmi^*ICH5{0wb-M3t(N18Noz_;Vr(v5Vbx3L_E)bX{D9L~5xru=} zFiSzc2X+rIOF&dwfr1GzO9i2eu4V$vVp40#_Y-cjnABSFLxkHbCJvQ^b|JHzZ7rYN z1I)5_@%h=-3SgFU;)7{j6JVAK;{EB3CcrEvQ&ye#h0Jo+pnRoG$Sh~;%2#d+nMF0c zTyRUsEUHuGg1bUyQFSgCvl3Yn$gp~s3ZXX=(iB5bpmfAR-r zxhH(S{su5h>%_&V{z70D#P?QME(T^P^fGt20nE}mQ6KfF5SRtFgm2#fW@)|Xx61;U zMdAS@QPlM;0uc+cC79-{;NI)3qKhs~vXQXOf;cN%V{sV~AA?vblnSui8q|I*&{xPT zjDGXuSAkjf@kxdMm;j$YIfLSc`L)!yjo5csRAdoc?MnDpBx#qwu0hmjD1qfgk zbNOqwG+>t7eM1QEtH3Nb`raW%n}Jz^*e$aC7Qif52}c-9=D;k?gh+-80+=PB>oVsG z0+=PBtDaMV0A>m3YUJEO0JB(xh4b?Yh0KB&@Y4zwGD~i?#pE6#v*h9t0|CG+dub2) zF3SS5Sa{yFy&`0m+=Gb50AQBARsQ(n!fh7BoL|>HV3xuq^U+pdmH>Pt!wmtq+TEZ5t*`|@OgS;hR}7FnOYglj@( zksaGhxG7{7*=mcfKq0d*0?dzG1!lP}IK+5q4$NZS9mX#%1ZFYs4&~Pr0<#o;-a8p8 zWEO^!d3vCbSr|U%>HCDtA`A!w37IALs5voM$Sk=A<|~0hW)Uv^?-Mc$?D{WU1!lS4 zH--3hm3P!%mzHm>NUYQO6x{)2}s&J6DyvK+pqeB<-| zm&fk^mZQ8m_TXlCnCyF0bL+*-xaNyzvIb-?kQ!w#pyF;`%#FKxu_Eh*?CZ5Hao5{w z`o76-B$dc+MER*7*SO~5b?IhXk*)d#S*zT;w9S_qlx0Klmt1@+69Z7 zdnbI@>t$OJ|02Sgcqbv1q9A+Jk5JZE&9IU^>QAWdd&AhAdtz;uFMBmQkgc5SigPZZp@q!rHA$%mWPZQC7nHPh0XNTmrt|j_! zVZ_UZ1@Q8+Qlq-FBxK+E@y-!~dtD?xuO$R@HL=np4Aus&(Xa@tkGPrzTYFguS)5|<}styWJrcCc94%RV9d zP}6zs%5Jug>|N3g+4Q}ne`B{Vtm{}5YT&C z_8aMe>^IazD=TA@Zg((h>Uq#bZOejN}wcoZ{zl#lqU}-PJGtl16^`GlkpTEL9Pq{+G?|&Rk#X7t&I%?r(0rd)&+I1paEF zzPYt8zH|O+ePyAA-xrO5YqXti1{G8NZ6L!Z|;0U&qiH z*bbkutmyEECt-Fi*AG|vbz9ChQ?D-~Dq62K6TBE7%-`-p`-}v%Z)Q}Rzg0bYJ+PUh zhk$sspRj}kQACeIc=%cRw?l-f-31y+AVO>Iyr*;D47|fz5$~6NE$K#JQ__RsF~4+Z zvsu0}-0F8kIsE!$b5hyxQTl;Dtt2zwIZ_qQ*H(5gG}`?cW9I3*+r1J3_}2@k{8p@g z?cz5T>X{!e3^o6?hkvi|H2nzT_cehJLm&QM;1ECkk-IEJ;#-;<`O3x58JBdFo)TyS z##qGZ#mqxkZ!VuBUTk)#)=_QVA8Ky8)SU-a19{tYbmHTTE*y$$ywsVeQGX?Gua2;rq`m&ez;T^7 z@e8Y+4lP{XJw6fCth2uOuL0}6Cvk^vuX_z4kdke2DU4j5O~u^qONms@DT z{k96<<7fesP3&|9r8q6?ZE;#xBg^xo7_K_o;~O>`hk9Y@&1 z-CA5m_tmL;As`P7W$84l?-HY^7`(2 zzP|#rkq|=rb#-P7mUT4Z2)_OBM5cn=`mP4Hu#M#Vdg8^%Gl4CU1$kF=&J_sDNd&w4 zp>cxit`iWy5=gAa7Z3QXhp^kan=b|D2ZZ$`51$Dt1{9!;M0fp>zXin;E&Sl(se>zF zD;N3h#m)yOjP4#11ohkK+%5R1lm47noj1iW(E0VO&9xsgZvEjpzh3Yt6F1o53cn9d z7=Jr7(G>YGPi&t_L=ED3ihg~^Ul_l+NGGM2sX5KUV2ArV>^@|}QeX}99X9MwTgduj zFI3ImwcJ?RU(-bLJyzSuP0@=b*&m}`;U?%EqdPi{KF8OVEV+e3!^yLk)@|ByGlUL0- z@8FP&Pse3yZqjx&H9dW)P1?nDb28Fv-=324{LFi3VQP4SZ!g*7_l~yJeS_XVj4Mtj z=V_kInfj)ZFsGYO#)Ctya?SP9QobPqJ}fjX>D0U|{N>d8H1)x#2uHGJ!~3osbB{S1 zHTT|kdCh%{x(K}^Z?7hoYPBSjMlU&ic9K5vL93CgulK$1XUb$NS46L$A+2Y8jQltM zB4Il-PA@uzj8OVO*vf2h(pTfAkYA#=2p`1M^LbBgPCiT6Irr45Zrm|w*PMEd?=hT3 z?Ndjuxs)2%v#RMx8GQlC>Me6cPT_wq->PazzBw9@(tWLgvtFLzuF92Jhj~k9RBE=ML3C#yaKZ`0~|J z*pwLk>g4=%8G4WADxDtw-MNK$Be`MJ%juy?^|AEpOB-vZiVRYIH7}Xz1=IKHIe!qi zF&)}NnXOLgPxiBDuGn6PZoXB0gh9M^StEl4e@O z5NsrGhnSjzr>c)O;dPI_q^X=vRaC^a%veV9|H+(WzLErS(ISlZcu0n6B+HMi=M`oK zDD3Szz&nspG&u{4QfRMxWbp`RBAr?QXX`}S7rjjIG&&fDpP^2i>bMg=bMeY@4 zntrmyHx+CVhEq)QF3>)#etS5nYUq^bTZ>QjkN}bLRMdn|)$1IGr?WYRWer{>Xve+S zghiDy$_1h)+1~N(w0IdjEaizi7*$`egM(7@sU{52_is`2_4HiNZy}7**Qq`Af=`xS zBX;OFblCD&v$;SRqCbi%Dd;o}L-Vf<6~6TBKC-A#wnQhE$$54kT!gxSps~}l9J+mg-ed|N9ZX+T3r6VBAD|X~ zK`>00QQM2p~{dn2K3oDPOKXa7I zPG6Xegl`Qoi#BDat5@6?9F|*$etUjWIpy`qzH@3?q(ikWxA2gLV*9R8Xo5VtwufjY9=xme1}c-pci*U)Au2z7U2z{k+DQuq(uggDjfc zhaKZA*WYBE)c6n#FW>D;*x%mHFs;AJIG|A-oM5Hqa2h`fuUmcTNG#5ccRMZj zGKluJZxuc}SJ!HCKl=c_C^y(@@&Nld`bnRj#;4o1+vV@t())JFozSD-w^HmNP#C8e zX&RsJ2{IV$s2s)_4fi18F6@5%Z3bF{S(tByi{kGtq7>jYn8DNtK9mD6%&a_b+wQ=| zun)?O1y)(cMHc2>)u=^`1yvo0{3{pMH*~DGn6#aZ}Z9+R#Dd( zbymNk@YNGX_yI)^gH}RUBKbZ=8!Z6@Eq}%Ej~4wV{iE^wj-ZaQDXJBI65oTd5&oig zckg~YVCZnI$n`Mt05?(BouuPXavNV>+`vFPl-$8ni@DGf;(dGf(`{Dxv&F9+yzk-* zG0z7MI{4g6&BHvM4RRQ}8{|%fu8``vSJ?1pcY?+ar2T0xDNb;>`)cdDJFi9#Bv)H) z^{Bp)aQE)3fo*QVx*rp6-y7eOa(jFzFRGzq*Woya6y4CA$o|`rui6+A4oKZLcA?y1 zf&)=EQ~Ge&e*0V6Mf3v!)mI;TPCLj|Yre5`t9a~@aJ=JHXvm?C{Kt{t3W6y3JH_b^H{0qwczVb6B-^MMYIqwdoL&wGG>x1p;fK^Gu5 zp(~DSqH9y+=rH@5z!>x=PRa-i2-L~BL7@mT0(0ol~&O*Ua_2)M$J+nsb z6SKlV3VfhCe6wx&(qkyGDW(XUNuV=eKnDs*{tKgU?RDX8m;~ZMu7$2H{Uv06CiZi6 z+g}abbLj5iKM?c|P#n^4b-E?oS?+ioo^V9%&Ea2%mNryBEOJixbuc;qPX+}_Ne(X= zw7-E;lHVPj?hAK1$7a*3r51MfD4Jh$#L%}K!#8L5Baxq2(!2Y6&nT88CEmsi^tLOO zBqw%ZdV32L4>>iPcqi?8(>tW-tP;R~{(KxW!rr9#8S&k*YlY5&1bWs~>blu`b1SyccvOyGakrjkt9&8>QIjMA(a+`#*V; zs*fztm26GDu4z^bn%Ns7)ruiJk7UFvhMy4R^@FbTODImIz#CI<*e>~>G4RIJ94{^3 z028uCV`B&>@oGQlNVqC}R#>H$ZKFq=iO3eb z?%gI;jU*a7Y!tlcJ)zjG>5LJK_xdQ_Bi;C~j0AM0KV0wEEDv-A%1AyX!WYaWL1q6# zyf3m)qjOnKybJHoFC1)O(^ozuHN(W|ahtC!57m;7>zQv8%$&e)=s#LW;YI z5P~;kiQtq;%3adrp1?H`0k#tMXR;*-XqaPps%^Rxp&_#0R@sQzXm08aV<94r;!OyM z2`TuSko+O?auwWmdXDvc?OBBvOEgYYOYERY&=52Q7+=Ldt@)zwu3v!Z(#fZSvDuR>o6o&&NqbV~s zV<@XfJ;I#VLQt%d^pt{Cm>$ar2Ut`QA*c{!;NObKtZ3`1)+|J8W^4A*446L>MFghs zyVnho?iPb*F2$y#oL9j=6qaft3f5z!0x}G;U`%BhN37?y3&aD(h_bL5lkv4Dwg<)z zmIuoMe&sq7(g~v7D%F`sGe2j*|B)U_j}J?u9kHUlA_3EB_QR})nQ$=lIQQzYyxZkg ztnC_XJV}3 zmk%+c)Z9lPBb5Q23*7ov+G{sw&6hOV-Y+NcHANpn<&`(kXyXho>mwTXXtd{y!`4SM z#X=|99B)mK5lz<+`D1waD|jSpHKLQ!CcE6A0CbbYI zW{j;3jxASd%_Vg`lCd_>^q~>|W^C028L_TC&LQhNMF*`L@5ASSzp7@U z?iPWJScj$X&lZ70Bz;T3=~8#+^zTC7X%VHQN=|*q43uc(sF`-z6fN*x;uqmQ3Nsq z6=4ZU{NjlPPO#=wryy*F#c|hk?wmA&BAQn-HrDqFK3bnXwp{%PWW@S+N@xEJq|#=> zt$!b1rc8WX46pp%IcfauugSTjhmXXLm_#Tco@0@mOMhXW^+)O}eoxG4X0x{|xu;_G zA-U{8C1xrnjLKqfRa(F4nW|Z8^GEi6B{&&2QD^xn6p)ckwKMz#3do55*jGX=6J&() z75m~lw2Xfdw$o5RMxcVm;X51;UnYj5<0*%+ez(603ulx-MwDv6F`eXuEjZtwxczCt zkqQoB_3{{Uwti~o5!#u1{8GE<(Hkg0Bl@QZ zT_aqe5oVZvD{mq=1hPPsH0&2dz^VB;wvG}U7Wy}r5+CFPjVNt6NgL`18d17;lJ>YC zXe56lcJf_hsn$XyDgToGCnwU0Q^;AqJ_Tq5`}Q+mgaS13rv+sFMWNcx*p+#<83kyB;(Tg_!F6c=huf-udP#6!(9f;YKS6+{hSZfu+$sIvD)%@2 z`oMRl0F6+7Vn2N+^jsHTXsEwHaV5e(kRO;4CL0GdLPWmft~CG}AtFC;F$O>*MCyD) zBL!&0;7%HKfeSQ3c}lGPv;;IV)UHn1 zu>Qhc=B0@neMvntHW+KES{Ituh_gTQ(~=mr(4h{}&42Yc7I=P4A7`_a+ByHOqjJmw zf<^&9x`ty741nixKbC0&OyGIS2V%(Q=nPsfvlw?|5#K>$FmK?FEaC5K&2tqEPW;eX zBl%N{6WvU?ugLiam%rQv!5@hGeE&)8nM*|X&26u1AmY~QFFL-S)2aiW#~JXKo5$dv zOdU7Po3{)_n{#D2(;ro9Y8UypDX~OPjW1{h)6W2S{{N(k3_8+;2{C>>rIOfXIV-68 zz(p9e{%C=snGd)ro}i>#n=9m5}n(6+$BvuDJU*|!z{@Uqj`MtAmE*}?A z=#RrKw!dZq&l|)OiSMIt1kOc2_+Rr3{|cp*n4lc~b7DTai~>AwF!e()$^@P_aQ-0} zn$u{1J~xIt&F}O|_`ZC7Y>N2H`WJ7xX-p3X->GrG7nkpi0ngX{{;@JPr{Df^4p;Xx zO`m5WBGufi!75z^JTIasmq^Gk-deoMT@qss^G4MwrXOIzhH#{3Nfd?-$rjDF^gs19+eCDw5{xcLCTO&!_Gr|{ z^z0Q0mP$~&SbsR#72%Ian8UMB5 zu-rr%GN1+LxI&fW$X5L}X#&1ykDmn8%-qX>b4BEoc$Xz>ral%zMy=9tu4wbFWu%G1 zxgs^M$+{pMLPT!LLCuT^CvVjTNgAr>G3VT>dy+J(o{v!x85>0>wIfQkkP+K6E{O=w z6)B_!uQmhD716f_yv&S#1}Vc>tV9;hm9?z-45*_)C`l35uo^_*ToEl%!WgpPVcZNK z$ttagvjp>=ry{j7wn4VSM3ESrD{{70JzrMA&gH5O(Gf-A{%lW?NSG{~D{2u(G6F=q zblNy~GFqjG#w;w_nU$4sR1(e=y~Ice{lK{*CrIy65`}X`%vy%Fjs>{@R$+#LB%CV} zg0(&GSHZa=+9Ja{m;qZ;8DB+ka&WE~^;C*<%fh*$7ZIJ|B?9M)7*UsXe-)f7qAOag zri@_viwtL}6%&?2`zBVa$Z0t^SBzP8A}7S*T#;C@U`>g@xgz#Um-jH^6#Z?+Pti|G zgw@UB$ol$yBv%(WSMo5HbhaU!D=tWFPO~zcD=tV~4ow-(6&I>j{Q=TG&Sm90u2dvP z9e;@Q)TLH`Q67I_u*0QR?^X%MY`W8MOb*T!-CJRUKMdhqG1SdXK;9~d)43HiIBN*! zieYeWg5E7JQsG_0*ST>9_1W`U^}f<3TVpTfJ#m>g{0lNi+I_NcuDD>>y;J4^AzFQM z?0o61T8s6iy9Wc;7~aqGbUk3C6qM72*^j#B5~g}9c<>YF@6t^!VH%4`#2JE(xPFntdy(SZek;GsrQztS@UA3X*GYBG0lWt(*mY8aa~y3;*Mqbedb_+L zdJX-Fvd~6c73ETW2Ej%QKPxS79%M&t9Xw;`o(ndjo|H0(HiX&L6{os5UJ5p1$jqlI zFT!j7gJ!Ot^5`8{1m~UdSWcCtmM~Fd2sV;ir4eLE?DTn8RjVQLG>5a-@BZl1y{7@3i zw1(;OeBVJUD50ry{iT{zJ)yt&vh-mt*oeyFSm{O=uo0JEh{eyPU?YaV6_&#XH$@#C zOf&qRk5%3)TC!`mRiB{>*oZMwgUyqMYm7<>Ingf%Y(%A`I58v#Y(&MIyvyFj3cn}k zwTgF1Vj*UI-$4~03Ly_;&k0f)D}lR=8h?^B=LR-X9B32uFA3^Kgv~T16I<66Pgq7R zk*u~t(#Ys;$%Ltk+Z$oo4CTp|6!H^Pmg=RBUC@B@MLIM`*nr~(Hljk6Cb0_Tj0q|$ z(wWl6Ve05Yt)ewiFG&aKp3^EtBu#fqH-EZ^(eWa<*yyyo(;pdujci*$@C!*`BPy+h z6J{>q_+vTgDmM!fZ_FF8|B`;`4mLtcjLxYx0vjnvjL&&v1U9mbX53e!0yi9$yscU~ zY_O3N^hlM@1%y_b4d-7K0}>{L{9hpr*oaX{3C5HY$WNrZ8{u^LXtXs)KvFXT8zBky z=M<>GRmTXc$38DzCSmMZV7tDrgVQPf)X0-!>pDWVwdh-r1{*Pgyw4SBuo38?A(-@C zSFs2y5}c%OFajGfwk8P<(7{GjG`A7WIPgp^>9hOFYK~Dm=1=_$*og5>k|2^UY@MMP zwUofkXHDM)>AG!TBW{5P><($L5n&YQx-{6xpVk?+Zo6aOJ(cbv-UESQA4Mg-kmi<9 zEJ&t@8-a}&|I*>#Bf%BO=$AI$oesef`a`2%dVGWSjhu%nzl&(@3&rr0_(hVc-`RsU zzsA6<*>(&cNA8b8>T{)c8xNd8mlWb}V@wCy(IrLrE{x$o0s7DY+>e3F!_^mE%}CJi$c@wP@E>^r zMBN;x+Yky#Vz3dk6Ju9YipC*%2plyO*+x}C;OH)Gb)K3SIs_jn|6c>nNKw=_bo3ee zf{uOh`2y?#l_gHqmF7aIm=R`-JfgpmQiDbwxs6plhze8bxJR>_^+*4t!#%iU+-6`s z8f+vwL=!4zz(&wV$ar5e*a-SaF+Q05hS8&Sf=;s^SdGRElxn#~3vHyt(Q(TH6!LeIpQE8YgdV8IeX0d( z-dZ1`i5gsZkeh51O+-XzLl$U2t2zp7geh*7SW{cY$@%%N-){0(< zfm!`(NW(*GFm}DWWlA)dYcLMIc$pGSvo#p>mdE0-c_MSj4CB~~;ye>?GQnfycnlGSP}dBoitA|K>H;7D0P&0*&RCQ@yDU1UcN6+If7YZ6sgXIfZ$vP^ht;zpi?-F<5#EzjnJ zsx`{kpE0vk4WqWH`$O^vYG_X25BBNH*mw{+=g+qV^jWCFXlvSK9$6<2qpi#j6Pju7 zo%+*RA5=r?A~I-(P%m?2XJQA_oH?doZU#6-L{g7$!;q>@pcsQy6V` z@=~&5RXsI4ZB2TgiNk2C>gi#-sTVf6dt1ai)L^vT&Wp;bRE5!YO;t6kLcGo2ZKL%{oe-6$XN=d%tu31cFd(jrR5I zF`3glXkH0Eg805ERTyoz3u629WMH(F`MpzcqVF{QQ_gSG6&tpG`v!J*&QCS{?dBp) z&CTaHrRp%+q7*&wghCi?)!iF0<_s8Z)tQYLYX*$A>Sm42=j&m#b^EAp)&!&N10}I9l-E5lx`D@wv7qrZlw;xXgj_Y;4;DqpiBP?Bzs8E~-mCy>N35%4Vnb z6|&peTk*r|VoVpy-G+;N&()jHn4s=o0blWYWjqsu0$+iAQL5YUTh4HKz?FqE@D(Sw zhw3jcgRl7DLkmCng0Ebrp&4E%@RiH7^^C(P@D<<5Gn`TNY&uKbb&tH4&{sCjw3UCq z48Bsi_^Vv$GWg167U#UzY4$GjxS1uFn7<6^;6;!P^ z-?MNiOBg1)0KO7Zco5at1isQ(RS|W(5PSs{=E>hvSP3;W$-Z4@InT=xtyhSfW^_^D zD=5v&M0@a+kL7ZZ_W@rC8~*N_UJAZKP1-Sh1qHr>3b?#t3%+8`a7XQJ0$({B8)DsVoi>-r|_1YeyfG}o}F<-u3%spt4#$lxpXwH5pYGWd%2 z*keN2z>?cPjZXJYc(0Tqfa+)1ngJS0^*%##D8l-*mQDRyiT!Z8{ z9H60qSI)`bJ3zAnUWv%tXg7Htc!e6dJ@1mX@ER10Jjbsk!!^k6Z5=<84A-DPO*F!5 z5O`KNkhQKQYWS;|7RlqCe{ZF-Phu|92UoP)!57(eawpRUL zqdvoM4Jv~IngF}53+{se=iT$AiI_!-oZS$2IYO##yt{VgM=xdVYmj> z{HdFPYmhy$ntfj$u0eJyRqQ4*T!YBYu`4FPE1S5j+NU20uR+{8?GyXq8Wgi)!JX2E zYmoh~YW_nqT!Y9z?LLhWR$mvVHq`GcaZQ42&@9H1$##TmP!jSyw;2i7pd@59mxhFE zP!hGO;XnyogOGQUsZ`*VLnTj>YHNX44vcmr)z$#7n9X%Mjy-~FP<2Nbw9>#e$WeDD zfeO5Gp(AK?))B5jj=?htH630hg?Ala&&1UMuT(YoDw+VV%nGwca1F{o4_Tukxg?BZ zX+J`9miJ%vP1oAka(j&(qc6SHy0fh zGRk)}n+C%_vowTMONPyp8G;kj-qBQUw(4y3p%U0UacrEas*TR8Iv>5ag1q>;z`oh1Rud%Mp43HiY0$y`Y3(qk%Yo+Mk3EPIc_=85Cf*z%T9wP43w7`xT;0T*1$q6IvDCUN! zHA}^>arZVe@2q#eS}Y3X9#;(=#g@=bWQX zjGj*ZRhdkgs7?+a{nt@xx*|i)&(9)pd**x26VZGGrmIJ#ep{xo9MYc^hxg2kmO}=> z=Ny+zHMwV&yF93V7msI_$${`&CGP8eDhI-EN!Z)lAqT>*j=jf9l>p(Fdtnjy5WeZO zMKokV#7MbuzVZ>u&8z#eG!bOk0VCAJorrz5YN@^TEQW-~Zhr{v(prN+W; z-mNTHJdrqs=&FYgJTbl3VGa06KuGAt@XUBwSUl0B-R$`)0gETHlYy*8QCK{Yo!rN| zD+-Gz5}(#4#%6AbO3XBr$kPxmo`fa__MVc3FFh87)4fu%uy`U{Vu`uN%H~|kYLF{I zVfJD}cxSRG8nAd`f$3)DWWnNzEG{S_Dsu-1Qazf4#-9DXqQ0`8R`AK^X3uR=D5O!g zmm4v+z25^1`Jy%&gsVM|qP#OZCBjg=L%oGBWxK<8#aT=Al`J{g?jRnNCqlkx3MIHn zXk`ggKD6zY*0js4zyAb{EM(II6R!mNvl>LN%faFas;#l7Ndgv6BwlC=THp&%k!ZMv z;98F)|5#?RgaZN=PppMmAX!*E`I7~bg~b!OU;mG(J8_44|NqB-PBqln3WIEwLdIUw z&}6G9l-&Qe*jD1c~qi8`XODIHHXUr1Ha$1a%%&4?TGxUzm>D~D~Ue5dT zyS{(Ixvtyw?BRZ1_qhkcx6`jU-!pque%_h-Dq>`&t4w&1ZV7zEjhX4H@V|mgmQJ$% zLBoe9GINIQJyRK#ilp4UC|!92k04EdQIjH_2_K$pB_GMHa)u9249GFL)6VeW$yPEk z_p&a0c;fubgdCR(AD-wQGE6zu4fVTs)uLZBbpP{>@p*KfY^yhp#^7Tu1Et}YQeriV*9+aX+W4)(kk&=29t`Q6UJ zz7Vc7L$!!d0^y2Lici0dE`%#C-weqIb0J(&9J|oojf5+?8ZHywNVt+4;4YB}*+3t~7A|QoMEn!W9qEpkl}c2vXeT%}CC@xqXc8%b*b}f%==FrTrKs) zDy(G#QE9X#?@6toGY?W0?EPBeXYBnNh*_{Lbq;@H;f1LisX;qqtYuo!{+MrA_=^bh z80+`XOsUP!9<`siGyiyc^gACtviI1?mTiBgwJwSu#3#QdC7)>Tn42?n-cnJYbI;jS z{n*Qj14s6Le~gVaH1u3L-L-)+(<83GPXBP&z7g$ie{%FzW;f6v6us??3YDGtDt?G0K(o*K0Ek4b==AYNtM-c|K;rfnKb$=!QE}5C0(%v&IOx z8ny=KE&61=xEg&@#S2^RFEqx$WJI0#JNoNw(&hGMb_cdRSO`DTfsXXXHM0RLW)jLG z82r`TWJ72;>T6E2A*C^M(QwI*>c?`zPy<=|qNiw^x~T=UWv(f9>0V|dcFCXW z#d?pv?=8L~@Mqme-zT*1nXM-gvN{Z5S0qHJfcfPobR)WD*%FpqvS3#Y`?HJPh55DV zS3PX=r2DjoXxY-Dc83)z=g0-X!!k1gAeu4 z1`66sK)qH@AdKw!<~`!_yYe@c)5_m`M%?Vv&FzGC$O4VZ9%XqSoGbjD>>%8qRizAe z(3q@RwoBIXB#x%B>%WsYCSJ%S&XOn&m67RgzlDe*Y~8PXL&wX^(Z1pO+MAhJ6afox zJV~vYWHc{7TG`bdnWg#Fmy2#hHfQ9B_t+YkNtmQD-zW6`-z<$d30g+wdUM_sCalmv z^>u4`1*sZQgZ{caGs87PHDmBMLW{0v(lPkT(1y}mp-2}9DvJh`K!}S zx#BCP4xro&DE?usk;*o8Vymn{?gBc*eW{WSKVHZ7K@$uEH^0DA4+sa*W4Q$7?pjh8 zdyMlL{lGX<<1jlK};4OYDG6UOb|jbp(| zWff90(zmX`g&<=w%BnRV>R~JftYBVyClE%#%BTwpN@Lu}!HT!M zkCp2?u<~yIg(`2bvb=}`Ry+yEZ-bQ!7o7ucZZ`4ySo_TztY9+o-1luE!u-sBZ?IzS zxUZpd?ae$ahER)GA-Cp{v0%m9)t!7N53z!6Bv>7I2UZ3&d?s(qgB2(MwcSQ0jOLRr zB;Q7?q%a3QV!_Jo@`||X0kDGoNjY3Pk~I9UTqLQ;V|Y{RMPMaw*qhow1S?!77WTHl3O521;0;!41=Ylk z0kARRitc*}9dBqlB zB?`Z9x<(zWSX^z8$QFW?LgO9x|3u!E@aV!=3$S8we@tLMJ+2N`Dyp*McYu}SxR5@S zI#@aWpSe8U>dCOGAse_f{l)yd*Ie1s( zTr7;9BkzjvfSlWLihp=(q=ikL#HtXisE3R!Rr0_J&j(6DU?qxrV0us;tXOo{lDl|d zMI9NOfl`pM+{tLcZ6R36UbN_J6vDfb&9I=>3&BeEum!at46Go7Gk+rQN?(LrfCX5I z5>$tE@W2W$NIf|ku_BQ!w2k_CV0Lt=nHORKR-P_(@VeB&O4P(HiD@BNDNK+4=``Kr zpBSq3Jn92(zY|z-iq(?-j9Bp?IPKN~E7tN)$?Zj8#k%OvQ9C|ZDRQ({|BP6f#$Dlm zMy#Y%4izVWl~4G6Gd0#=CE;qrg6tKra>Y3D{-4OZ5*d9ZHUX?8+#egapBc9XD^*oR z@rhvNBQAuGvIZ+3Kh#eXwZMwj>x6_ccvqf{x=1I06;K31B5b{<)Pa ze1_mKv;Rs}0$8!eT&W!bD_&#AKY$gadUOk{eEjq+0jy|c6uCQXA!-pm>`wqI=8jGc zRcmh+VYLXK5G&-?BC<7DNpKw@-zh?@ST~MY9hd%k3k@Ke9D4!KQA(>Izt~4jK7T`Ty_KfR#_w12coxUBrI7+E&fE6ed z(fAr*#f(zPDwYK+>Ui!{jTBf}E)>zg3Nl)=4c?W(&}dq$ELf4fzf-`P8kefQ5`MiZ zBVG=ytjE3SMM;5`^&euUh%3R$%Ga_9JK5$-#Wseu(p4PRZ~Y_k1>`ZrmyvN9uM#BK|5B|&Y! z>sUbLq+$$N2vYjW9dnJP*ON~M9m5gCo>It}4*u6}t z?rrd{@OmRw2FQXHbwNaE2MesQf~1l)z{*LnG|g5Wte7t~vqEIS%J!uWR+ki5QJ;tu zo6^7vEnVX$f2zkZF|_!3R4M+^5wLP3wph9h4^|G39obzBR`e9Mr?mHj6+Onb@!q#! zrQcCcqYMvL=5b2=vSVO{T$x+!T5fdtGLFls(Stb{*YXo0StYQdWPGq?8yT$ZjaG_v zZNYqTZP_`>;*9InT?xNe)gOQGs=oCl{F}EZJyT`XOS3Wa#A2|5l!11RgO%~YEw1pp zK(60+j1M0HD;zr|nyah|d{?l;{4octaP})zxd!TB^^}!rbHR$k&ahH7V^^h%YhIlN zE5gfS*S|z@#Tor0N45})38k*C)jHd)ct=j$TYIw~TTHmD306{C`^kFz{AkxhW+`|2 zKmVfT>NV^%@8^J(T#bVhM?_$SygxnMAlD$xOPUtObuAkn>3SD=Yo~ulVuaf z=D|w;qHFibd9c#Ya7~Mu2P^%uUeC54VC8K@ae!-@;r+`K5pf;4U?n$5 zFR2WElJ2BPTFLhE5?GNm=Z3ic1S^t`+%COeYtt_aB1NW3U_~jtY>Ch5(fhS%oBuq@ z5C4b=SctJO6a!f9`i&8H=K~fMg=R`S7qF->?g@HDfQ9R*q7i^#k>F(b0e}VR6crl* z7JnR>&#|W?(eQy;E69Eg`PKIU#Sd3&_%^tG>3wyszl@VZp z?on+PV6krt^#d$27g4V=H=8t1`HPJJOMV7-gt&zWog!DGYMo{rk9gwl+M8T#KEWTb z+@rK|q5hK}ZFH!Ka)*mxQE6y1>t_R&|Fw+FVRA;M%@4sMOp;0V11v2hX4Xd)z~WaL z7FL}FSXAbak`Z9ZZ#K3$LN2<_McPGVz(VfkqErCOVd{j)As?{hyBL|YwgVQ)fqb{a z)Rzvekw*Avp_L3^Q3-AmS7rg0EFTr$0Kno;>1PkB02ZUpsIaaqz@jqQB(BZ^Ecqt` zCXPt}3wP0|`=kW0a2ZBvF%rPS9X3ikK?W=$rb^GfCBPzz$PX|AEdCP_#1D3nu2_&$A=@p3eQf176VpdWLwQ2^S}ykzeZIISg};rs4WC5 zd)mSTU`6Ai+^cM`B77;10V`!0PevlP5X%Sx*BG#3#fv!6y!Pf3Y#HGtVkM>Z3E2{? z#2ji$x$^|EV%gAU-p>Oog&MIFN2cLn;dyJc2@osONgBxl#0r^N_|X!q2uj1ks|&%3 zfKlf{_slM7(w2_q&gW&x}`8IDOi5f4`0Gc9}WArH&@2|7ly>Z!_qA2DD1KXD=!6+)213=MI-&y5}((Tlo(2X9)-g{3Ii)) zv2^KOV1?{A7PgxXR^%1pDeZk=MV=8S=oNyMK1X?tU0~(27$?o&1y+z%m|{(^VvXan zYUII+X8GKdtTb4WHr8s1L*5npXz5r@u%g+LJi=m)%hz3*ZmQ~w*8(e6_%}k7JXo=s zorOXWSfRhxOiG4#B|$K_NfWGSeoqt(hk+HA9Wp(mvPV-k(d;n`tg!Y=S80M3d1dKZ znoHL577keXcMHcP9@)YHEA))Mk+3a9IsxaZS*;U~nv41QHYGXTS=sR2W)K11s`#%lk51 zBYLxz&0A8@^**|mjfm7xIzvM0Kw!m+IstVcutImyG)aVaMJPT%ceA3tv~P{n#DAW$ zk_IdC!6b1d4Xn_7CaAYfv7nXm)-I?V^Dd`AL$vng&*2ZD!(w7_9UyYIeiY zjHIHEp_v9tGm@IVVa>ET5?B#3<$L0gcSRThqcvc~dg48)g9cV;LGnqvz{>y4&&-m= z&9o3ruo5rspmoWE6>GuFl&LgWkxt*W#Ao#!N(^N_k7~z1Ito^f#xkWl5G#krj_ziH z6%&Q{l=eZeV#0_U?|lbW1|3Z_IuI-KI8}ZJVuf6pUmOTl9^$y%8WXS*SUx9`RRt@m z#z8G{$h)#HS~WHhtOT|skFvPqCSc`W)nI%OSb2bd^A1*GlvN+h&dw8=V1@ZQFew?{ zm4xv@-9WGs_&sra_$XN6+Nsh4!3s1#%pb$grLejCRjUHQ3Y^BZ`C!E%IjkM5s9uzL zm9^O)# z<{+E5aIg&0gKR`_u*}4D528%K$^+`eI|n9MVY&pGB*MEQoIk*Hdq91;uQf6d|5;?E z3RX;lNs`KZu#)cseG#zokkZc`GyyAtou7zZ`C!Flk|e2yzKAjNWXHq@O_^Oq)XvmUm2(o;c)Pc^AP92m~t+C*H?(^b?KzPc%6J|{!9NNIE8(#W=~S>H@f!=@ z%>XOf3Ja8WK3LIa%nN#_!3y6|TO$>*BEc!}Q^AUuR7o$!gOyV_ZeNWySowDi2COI; z?{1k#-jzMk3bA;wf^S(IVfBq`gO$5g{P^8qB?bRx8l??ZQf6l*LGM`-qaapq<_=~E0j`UST!B2XwNM!o#BHOM)Pi) zw{WlU>AP)2aIegeyZI<>u#!TZn08=*6^0AmIPfEDdv zvAB{BR_H$3zNuj46s5m!P#dg3^(3r|4py`$#o}r@SYez@o%n#&a%$o|xq}W?=t0^^sfZP!w1Vv^up$vR(?jrJ zWkK9Q@6rYmX8^0{f*4Pa%1@#&U% z7X@<;U#o0`VGHx%QfxvVbLlqUQ*eGwPWq_4Ei(yM(Wy3{8EW(aIY+H(b#~MAJmB%hySMH zo=}5(R1z+!mh%OBEo#LD5FN4ow1E1MK#QYeqW$|eSSd?N%bVUHX)Y0wcX^H4RRBUZ@7 zoMH#Cl8w{l)NBGP4&~aSg0)~}t?`}~G`uT@dq1y@bpR_4EefNXIOChZ%DwPM@q55Z z7T)$PY7w5ZU6yG-2d7q=DM6`YunBuRz%;|CZ9#D zkO?^-H-VM2rR$(70#-K7A>|XW@<;O?8|Ap7&__t?1nw2pxU@&8O<*O9ibv*XIHEt0 zIU2ZE*3I|-;g&_UhJeKZuOWJ{7OZRvUM(T!fR!AdO}=!nl1(w-3~mA|4xQ>SPy<#r zO|F(iCinrVaOs&RgcD9yGiwdT-zV z5#Rt;vL{sHQggscPSB<#I$}jcUu&Ck;h;qORvPHvyccnmJsG|c`biNk~Od(&{$nITD(*Y|wvV~?w zkgw>lAFZy^0W0fDR!5x$EB1`gySMOLiQvlGD7|Mwwg`%As$zQG|O%m7K;wtph9j zsCW@O2dw0{=$I5D?~0^9$88_g8uAq#yoT_>YOt~{I7du83s%nhtn+mOD~=Qc_TW0O zqSL7!cKR$>SvQ#@jyMZea!xu;sKLE*g0ra8y#el(Fb+c}O%v{wo7TVSLe8dWwSWrv^D?FSouf`m#5X-fv3)H}hnsInb9`dd@epZVmf)!#5V{{X5 z+#IYlhd+)F2P<5>?R%6tSmDlULQw>)l)fe=G2mS(7&p`-f)(QT!f{i`S2pr`)o4Vp zLX<5uH-dachxbUWiU?NBOVpwYz{(y*7zeDV`O5Bsd?jDV6BEHosr_TKh%KU00>_mI zR;=_Qw42u+eOy~g;2~C05+9Sz!3yzEPD<=!#EN+X!`uM!mAC?p@CjwOS9E#L)Y>?R zmFe$LKtZgK2~ZOOE1c4G;SmL3#e9zO!|pLyDQyn7QI0PPeM}FxQG|O%H6E#nfE6wk z4>b|6QtCo9DMa3th5k}EF4Y?H6(U|^`hgl)F%Qm>5DUOcfseT_AFS{w2E0LYutMxq z4?kT1R?H`JBoPH*rSv3!LJjVf6OR{(-5cOu346>SrfI^xa{TcyF-;rp6`l7?^PW89 zU3ve$G=K)Noj1<8nB{E z#S7X0Pd5aAPTYUiO_yp7`HCXGZ0f-(u(D>kZ~|5`eb)HugB3lB0c&s#SW)b}42==6 zvSxC>I3g3Qz|71;Z9nW{4tKaS^9xcC7&`dIIKD<0`PSDqVj`pVf09ajN8b z)D8Sr$X5)HekqZ@g;+Vf^JrHISTRs=NudmY6$6Iz_(sTA{;i21R_5E4`L_@&WMW>i zCs?V*>2hlfz=~)2RZ)R5SW!0iYH>#1m3^O;V?Du&XN%kDChoWaSh*KI5bp(6ZsKj< z!90wz>do2mc~J>iDS7Rg$st=Cs^_PesJ6r@|BI;US*mmSb^q;xe??mI^0Lf zRi0pFc>@QmIJkw~04vJA=v|PnxCpDoo?xZKe!%SL77+~2xO##WE4`yv;a(Z2Eg@7R zR#FlN$Od4=^U(g3*a5_fL4%vQ0pu%jc^Y05C6KS^a-S(f2L(opMBkN@Zy;94guIUi zVC6>XIbuW}STUG$`(X#IllqcoFPjp$R|e=_Hs|49VaBBmpbWsuO)CB!y9C~q5*JUC zgYd4Lo9{1iyGgZ%e8m%ACVHR@Rt$poONe=3CC>-?B4DMOV!$0V04tuImx-tIz>2}- zen|xMMedZGyfsmZ+$#f%p551wdu4#(nO2V6D+9xxX;+bZ z6BpxB^T0}8kU`Qd#EOWnY+DWQ$^l7yUWg}RMUtA=WdK&H1x!(+GFVYgzqO>#?Kz$} zRq#CO2!1Q%D~91;3Zx^!O26OE@U8-|vR+}3Lg9gx^^5_*M#xvfc#i8eA`vT+c3FNT zSb0PuW*2V*D-k%|zMA!5<=+_?up(=`y=4G-SN43Cjok)TwzUk8Z0Z|d4_5Am^WwLI zm7{puY1DeKa&)#_A}RnY1+TXy4a2+gSYWt$8(7)){fWR7@|BH!y|T1zU}c-^6Eh>o zS9JOw$yRLxE9*;Sqq4z@{cz|JumY`=U68K~PDO~fft3P#o>}-7Q32tI>$Ym0L7ZOr zRk&ApwFQI-urfeN(wIT4 zEI`*}2C+gW78S>VmG?MZevK7ai7UT4U7!h8G>zk129S5f>9b~R99W5K86MrlAGZQ4 z&Ed#2jK1|dyzLCi3aq@FEng6ogO&2vaY@7Qu0TUXKMt(KeSb1;3i--Ley=7i4y?q< zJ~20fd_{-28B>b0W0P9LuQd%MCF9Hu5n<+ zN-y#%+$%%1<%IW$m6XIGvK3f~JM<_eb_lV8v`-8mUx_Qyh@U7y?iKzs&9=9QmFe%A z$!`%WWJ1wLE3opm^jvsE5m>RB8~$N81Xf^##-;@Bl_7e(&3U+2mPcr;z{)!+euiBR zR?1!COr9X`%0hp++dHZ?F>1o&n@tnR#Cx z5C>M?Ph5;oEdnb=K~_mKh?Qx&rtN#giX^@$Bo476NiFKK0xRzY%;`o=u%ekhv!u`O zNlBc_d>*BYzYY0HUFergX;rXd;MW$~l?hg09fm?-ffW=3E4Ys2D=bHphALPI5Vx=3 ztAdrSBw|J}8my=w6EG;Sf-Vo9Dp&zlRv62)VBuY1}kV;W3zh5 zS1NlSt*AnS6;#QJs0^1ZUpv!KWw5fs_xBFSR}80A#AvXRY0qkcd?k~h?24||F~n7e z1~2d5!1xSU!BP@gWE5CIAKFTZWg%8j4W?!_NWPMxAv56(_sY%QXDiy2!HO@8&m=2@ z6(bTM<0A^JD3^MKMr42$)ST&(9Sf{vHp8F{+$$`)jEyJUD+E#+3xxtJ7;5JfI}@yA zx}Z&r;a%|%_h-6cs1G4u`FC0dte}Fo!n6!n$?!q>s)Ci}`UwiGpga9TPiKG?)Z|ui zLda&@WR8PIn3_ybwl?h)` zY6e)z2tp;Pf|Zad`U+bWuwo#N&j>+-6+>}qMi&aKs0avCjVr*)|BcTiPMv=qRf4|_ z`AXf9FXyG1h?T=_N4m~~6y6IVrQ^& z5qA@+CSb+6JXlnq2v!u0U0Sg4uGH=QtQhMIR-9W*M=Lnvx?tsAcz?VLSh;}jd5h8o zD;H)1=SAni%K6vMNv80w7>(C$aRw{S-;Ku`Az!)9=~bjTgB534WAl2*S1LJ=6sw%U z3e-}f-~$$42h*?;u%hU@rUUX7L*YfSGgvuq-`@oJ3e-(poxzG#^^st>SNdzu6D}fF zQWE>28Im9Ed}wP*?D7XJx(%l0HAuelzXFQ+P0lmLwi3jO=(}Qa31Wpz$o;4bR!T}e zpe+JcbmvT=e*#v{H@nz)!@bgv6i?t@A;hKiqjbT_1!^aCB~DoSvhJQ&`_R4=xSX zV4l?yzhJckxqJ3r!M?ad?80heKM^ENSnXis6BZwQZJt~$rRA6(*U={?kQ>gq>w|AV z^9dEXxC*qsukZ#I#P|wJpe~UWA!>nwMAr7&k-(PQ4uja1TJ|MTJ+`I6p$rRXYDc=! zTD7Dk45;B2`QY2~W^xbt;Cu2^y(JE056mutM1)OR7gQ&>llQs~9+`S#BepURhKsP@ z?+|;i-&I%Enl+(mwPsKXVUJ*C>mYBbL@!rR(zhZN6z6kN&K)KD_qznp{$QT-{61OL zWjoiPv0OvhwRpEuaz3w8IWNyr?uf;)uQe81FZ}24Q?}Z}>B8~l+KJMC4b|LPy=eF) z4~%S0=rL3uM~rs#HoKSUK}Snh?9=3JR5$el9ejIg-`&nk z45rhYH7L4(4!$$hiVjvi>D_cM(+AUOFj+hG1wC04+Un;ee2IQ@hjhg+M3{}<>AQ55 z(!*B3{%m3&B*tfL@L3{fUCVJZ{8`T)HvH)TD>ej7T99z3=oPxBPW(4IZLO`Z*b8M# zXxjJFlhufcxibY@HmG!OaU==~a_C>RQ(w_ZIqBG?w#yMV-s^v)A!N6)PV>$9Zfmt%ngPjF+;jkJ&+1g83fSX>=qO z)DV`=u%$6JTW*u?v+0MZwUKa_5~XEmR#> zJu4d1T?b$qNi=pL8b%rof7%J@=$*Mw(6*jSciC>7TWDLar3Y+N4inwuxzx%&$!SCP zcrA5hZs5Sbh@Rr+OkLhNL&2tB9?+uvM|oDcLwVM> z$%z$wQ?F@2{qLHIkfX-rGXpDqUicn%(!6o6VSwfX!>!0f%_;2Xd?~B~A?55qwrKwa zry9KfJ9ClW1%3@Kn7c-_7gOk6enWI*)Q@X`y?px^_K?r0EB83|a=r@IzZMs?&ybv* zx80}wrYHtBYhGZ7e8^V^)Mx5C?cQZ!O%+w^Vyfm9FEH~4y@MO>-5E#{p)Y*#Npc_e z2&}nR?0kFH=;7_z+IwXKb$gRBgt~UeeF{kb!yDa1R$;pH?DlQdtIhG|U=`2RmO?q@T)qSM z28(fg#KE+=1c(DH+5wqjsZHg~99(ytGDE2Brl9{KkmE`3S zd^)Q|i7@GP0qa{s@#?%Oip6}r?PvVrc3|Cn(1p*OQx`P6Pk6(wbjUkttgZKh12Mio z&J8ep(sXQmeq0(D_DS2+?fv7zK%-CE=5C)KR|dZN{M?x4Eh)~s<`c87=k}5h*B1k0 zjXpmsL~a=P&38V;j@=M$k<-uT zsUI30*}KP!T$>%Ce&{Lu12;0_+4oW1KX<#uzq2*@@fIyFmS<~T;6kQR>ZZ>q=i2?k zH42%>I=us{C2@tZJMJqHj>RV*};`<**5BbMZtD?wA%Hs>)G&&{@I(d%)p=2x`VC_g z8qyQla^eLgpBJ!WQt!kVh0fcxV^VkSh2JPHxJt*n@G>ve;?uvQIFlU;F>*yx1e(6y zG4YO7>JH`}dv0uc@kfq#-xj$`*@4RHdeK{VcypEIymq)gH4Az?Lb}Ggq#l|3_YRxu z68l1hHBsevBw>Z{uaWwO=S!u$2gIv9{tlZ8a<|`g$$>(*kD>QS`%Nalm1v=w-9;-c3Ts*tDCP5{Z*MU)R(AT(OiM^ zobj+`yhtg)`Oc87i^j;AI1i`ITKXSxhb>-^^NRGWFXwqBT0A9RE_z>?Rdmt%(AcPR zdBwD=R^&%qKzUVFE7B*q)y(^0Z90-tF$8}U}Gxpl+n=$^p3X=|GL?z5v-wmFTx}uQ?v(jTfGKLfqPbk6w z&5ecdD{!$K;0efTFu z$y(_jmb{inYC^1ky|}yQXVr9w);}MSks86Ba7Izrse_@k9pAUN_ptm$ztN=C>ydSt zN1;J9X$_c~j}n{F{v-QBRZdp>gm^Vgj(bjuv5nHgg5z0=v7OYJp~T6RQeThj@9nR= zo8cvEVLswr9(DZ^?A2JP8q2m=kRE3Eiey(ts^bQG$3>be@5q%$PvL1hhIUdiSTb_3 zy=f`nP3cORVwmeYCqe^gUpN@4R~oaSO;zoGhU(MI1cwvM1Kk-C!<0tJ69;>sHS#2v_vg7v>@ZI6hHT~ z++?WOkp{P}+$2%#OKZ!0B{vx+K155-?U3`8E!uf|_4DfyVr|+(Gug{h#Zi>6B#oF~ba$9tEnDyI5Y*fw4=$CR{>0{3A^U=8>_j9~Ob(0E zXbNi7k*PhIQjr=|!IY*Xhvg(^69IprM~cZbH#N9&)u?|?c}c0}-IB8jC!J$)rJ{_? z#q}98vPPIeS^UW<)JoI5cT&D;l>Xj95oTqhI^{|4XOY}WL%I5G;%drZ?<=WE^Ctg# z^Y#~09Z)*?kJL`JiDTm3l5UoQY}zqWu^>jgnYKaW=U!@*csuQy1{}D@#fG#Hjh~Lx zXz?!E8;vFVpU0;3SK4X_bkfYlbs2Z0U|w2dsjv5%6pUX<{n{pO%g_>SSox3o(r_>Q z#B=Y7m8r6`JEB&U)!)6=|KEcz6s1e?BTz0$ZY^!@Q{Zf78z3yY7^Q2;@ z(wMD97AYnDRR^^<7wt$X&z(M4zVVR7=p)Vny+bO62g_lTCAV7St@OmTJfiZ!v9QXU zxla$aC`Ojzo^lTB4XMnO9*Y$PD$QJ~CwKSDxCS4a*CF5Sx70H=PpN5t{PvyRtIIL^ z4QAt$N2H6jxEJ(xT{_!8RGHu3px1G!(>Y-$xfKRxzO5a*+&;9|O{r_|Nu|@S-*$|; zecSnO?}QVowA?#!mEHMo?}T$qDcrSSht;9Llk-x=J1=)0n24EIDQ>$Ae;1vYmoHAf z-03nAdyg2`d0^jdy&c7irO&d${sk0ud$c!3XI)M1 z0X2djXo`GKV<CNOgx!Od{ zn-|A(@x_cXD*G+-=jKKp#77cq{31jtN~Wb052KxT z*&G+WV3o#F%5zS%9{fF2>UW%YA$KP?KyT7gQk46gSlHjH_h!d~L-ji!u--Zr!>aVb zw9xrI#bum`;tiL63f}6Ayo#?~`Z@7dRpe3}a_Q&Gw>w1v#cwYCoa88ooRn-YEsb+j zB>A}^2V-_f%9dVpHt7AbfKk1j5@v4C!P&L{lrD{N()D0e4@xM4aAM}PUzeaN> zVIQwol%WzGP`_FJp5K^=r2x8<$o+fXz{;hN%@J23%EY^C6%Fjr29BNR7__4al^#I z1>@jQi9^0>ZocvTyOdn63-_psX`A2$aThGEd{^1!H@mf=MbNKfl%x`5l+-GCBJ!#1 z$f`3A46mTKzhEb-obvymdn({VctvAYT4hhx?@*^2jh?%H24xyWrm5leQ5M^@r8@t~7VPW^O{ðy=(TIZ6WiN zD=V{jxcoTzV*4A>N|g;QOMhJFj;n0Ak8{E=Z`T|yH++8>nk7mqGx;c$Yb{G9+$_=Y z{9(VqBjmeT>Ms8_OI*0yWQGGMEOtKeK^8_O_@4M4h0Cr}32qiYr1Y_!W$KLJZ|8gB z`&r3G^(xUu4XsNJ+(cp*S59T8Kh>=h+9mlL{3o_p2K;;^;;Y!MyXOD%v1mr6XKjf8 z&jHbxO3%7C{y&FAiz@Jkv;R^*dsyXuPKeRZsIa;$SeI7$)g-=^1#=QvJw`uc!{|tv zMCDgAjCI~?dd1e3NxgHq*D`80GCW$pT=*S zsta%vymgl9d7EQ3k4_)c;OB(LYDO+l%Jg%TVlD5boPSchFTCuQAcojngL@vaz3kR_ zjETP>=J-NF*&WV$%i)%ki%*)lR+a&;@MG^&EThU#POs2Vec8T0Fs7=o&?P1iYtl@9 zP) zJfYO~YI%%iPBHn_ZGqa!J?m=ap73^CCWHyhV*M=VUeoU%k^ z#d+nrH!A-8lgAMz=(6J2i8oNN-dDE6xo6JLunj|+0Z^alXyS<|Dcsd&Su`m3H3x~^w#{;n!$ElO= zWh_IKmzQVGKVfnWEkjy=Tz)df)vzSI3_QAUP;&7}TWoiDe5+r0_?^P!*m|YUu`x|| zM|r8D(;6EDOCvlzn4od8w7Dd}N(|ndlYNA2LA}=5BK5Tz_w3j86FCvY&Ykr*CD($oj%CMiO zaCH7IynQ*cJyWcC)ku98o*Sk_hl~YAXz)+M;z!wGF7#WwVswW{lp~?52i9%9XyW@~OF#ust*Tx#`-6ucR}58S>J(EO|Ok^Ao95ZH{!d@0`3- z?(&Gt=g{)@N!GuEH0|T8e+OyWU$eC2k&a0FD|;@BBAw^1bxeMad|jq5<700e>8nkP zmbH8k{c7pdNU|DEmb;gJu1^rA<4G^pjF6A_z?IK7CHP^yG!G@hJWqmopYXJNgmtOz zT(bBKO(w1V=IwOwAt%5S!b zr$`^RrVa@`?>-hT$cK=YD*fh2S$#~+ZlhrGQf=RuW;c`sU~C6Vhm1wD`-@nM4jGGd zv{vWm&?|mlLus@^`AMa(yOw%cba~6%C-OFN;=44+SmbTu#SdtZvB-DFiCbxqvB-DF zi@W+DW06mfTWaoujD_A~J@H8l8B3q7=C6;WGQphKl%Bq8V$(13Qe)pgn(#A3nsZ6* zd|~h{y{3HizaI$R?1PLYe`V0KBo8Oex0Ma~v>;6#`9yMQ{wb4B`BEnG$>g*7kg=#b zJ;1%>LdK%Xe}JES2N?^qF!1Wz`6Hu(cLpY9?J?LxiQ|vo9XBbpY61gfLG8U5)WO7|TWGp6gB=W6%$XHCUCcF;!v!5K| z$qbnwH4`YOblDrWa!@6oM#4+{c$CQ9cXmcQK=e<`2+?g;bdU~Q== zu6FRa$*uhLCST*tpK>8%$(Ihqe-Lf5S8Wc$&k~C$9B!3~cDy;^alE8GUqA4%s!SmM zqsTxNG8U7oW$!?)O;~qzV~}szzW;g5)aY4OiO4CgJXZm?X)$d`1ve$0iY( zFA1V>I?lxI`xFcitGr@4*FYTz@m3Yk$75C|ou_z?&)|?eW#zODI zKU;7Qu@IBm>6`Hu%1)pG79|4Z*w+dg9WoZ!GU?qDIm+EbP8CXHvQssM9;yVehuiX=R zCl*O``mWs*x^v&%C1#T}9dCup^i=!@wm9@u6MmvYA(m0(G*+drNBOo}N_&s_X!u+6 z@1;43Z`I|1Tq$F z8?m^84jBubfv3(Qzv4k3##85nkg?Dk@zgIu$XMuK@zk#p$XNK-@V{os`Ab~bD``9R z^We`pi2@`26#Q&r>hfMma!xvad9MUA7DmVJIZ69i-J01dUYgDKMGqIvscAcyBYCz? z`p50h)1ez6V>zw)zUnFiG8RVPX-#2O1@2G2hfUFUasloIpKQZeOv%KJMsB{Q{{w&6 z;(JQou%1m>p4b1!)V=sK-T!d|56Ss7XNHi&9L5NvwaT%a&xb5Bg-T_prdG+>FbPpa zQBmaBVag?kZH_r~RJm$4hfY^*bk&rr?)UoLkH>xg2R&+iKJWMQ`+a?1C+(NhE>3{4 zOq|F2eShg$J-h5(8^3~!tmby!5k^WD>sc#!G>>!zVmVCwD*>G`2*#pU@iXCL{Uv(8 z#|b?hN~%iOk9Tuoc&7q1{{D}53tY3QzZak3Tlp_t2p^Z7YB!(!hWP8`H~z~P@mr?e zF0QE+J1LLIJSoq2e7b0jnOT&qH9Sc})SsmB9iI<^u@q}lX5MkZSc)SlGatBMEXA8B zGw-=zEXCAfK3+vwnKHw5QO{9$k~`0Rb28y)D&;W)3s*!>;Rkv9-vFQ2zAdd`!u|Tbf#Zvope322p_TQE22{4w4#gjekWw-X3Md@0r6-q=m zXE~&{b%nC4dp70TL%~p@umU?gBu`!pI<>zUT&JgfvfJd%cmA1Tg_DVh zs*{vCZmb>{%Sp-tH$@MOarq<@j1K7X0adyPhqAvDBUx ztUg(UwwuLh{O@mFF00(-=-S^a@Hy6%nSWA>C;mF+!(L!NNhhVIgRzLvWXP0WFcuMQaU6<0Tu15+ z61A6_4zAW}i|BnKYOii7dRLZwyf>6nm>$0lXU=}fsZPHoR-?`9USl_|khCpbMvSll zEk9}8Yb1hJtq`Z%BE#EF!J)WS?GL&a3nn z;-56zD&Fa|`StdQ{LKF)BC!^!kp!J1N!xp`h~(zaig>I=Y9^Iw=p=dfwu`XxKZ?yL zvRP}uSj1)!?B{F1Sj1+O*yC%!Sj2)w3l%O)+NGoy}k4x3`B4KMOC^kGtOmAIBv1EVb6s4PswMYxDlg-($Mczu$cQ#A4+4nwx z+{wQp_G_m#*qiyM(iKE08oNuUk?i_4dJ+OxiWa+bO|68$nWD*VS`#fHaQ|OziNxx* zRSjMPRF=#boRSh8=)EO!TKS>Gs<5&IKJzT{TUv0eSBF!Z{(If36|}9Hvp=Vw5dAE- zUo^L|Jv#3{m!}AcEUdNbKZ;;1`X6$zScX1lQZYBXQN6AwL6O5#^vFsurOA?l^XgrY zhBP@6VTkKev))(srRm%beLuA#ml{OJj-l(Er)M8I*Qj-LB`9_59eUz&7ZIO@vz?33 zpHN%OO4M1JIlGwMNII1#<4n-t7?4PL_WEck(ha%=V_yGNPJ&5`pcq}@jmO~EHCHi zEvw*YFgJ9zp7HK%tTRmx<4e%vxuM8J#)=ks|5V zsDE4Wd)8#OQon3WHvO31EB#An4{i7JmVBQp>zqR*4w>#j+9>TC+M(Zhw#(GnS3V-A znTpbH$f;IKzF(=d)T3zYGKTn`OJ2{&)YnDGVm2`b^cV6xoN-#5cEuECw_W5 zU(YDjuaR!|$LVk`C>A(d$VbHP7>aknt0&(GS6f;+Yn4R_uu$kSnDf$)R%^|o*v%c# zk5)gNMbJzR83JR`e=EP@JM@g`lXpk|ja<8LvqHN*gQW<@;zCj63@BDH78Lce1y}}r z(ok4mf@7%vsV@;YG2nr-;@fNieolcicy>$ns^gp*-)kt^<&fM;m0%hB)~dtYX?^&7y#BG=8Rg`|;mTO&qW=s&>0LRGUEhC3X}?FKp*+>!p}$W_ zUMbfdYvKHt$-@_Y>J zRU6zB)%dsb;7yr4OT!x7_HwKt=YrA%m3$X#Lj0Jw=#H~;E?PDuD9-jvg0UFh&QIEr z1;(O;E}pb^-b8ZC`ljUM`p&ckx=ch3Qq^`Dq!vwD_J`D+U^E#F_gB!ZN{h#`_0N=hE?NF#R-q%!&4z6@ezYk|Y zm=m$92$ zWkYu*ZeIR&Ltkp8+nAdYDVbqI4Drs#+Hr2@Jz*B+eRr$Wj5$x=(l4f@TgW@RJL{#A zF3s8lhnSs`EOx6jUvMMi`jwRy3dEIa3VFd<*_`*16RzPZF(ihTmjPaz-<9XZ?8uw& zpy+c7h-nN}rD&?4gKWfUQi?7R+$S4yM)H~rdQfkuf}@OM1}$m_44R90hq8_kPiDzM zFA3SNTW>Z~QqO&QgT05qw0}?uuT<+Uu;^b@>QRh#7nt?GQ0h^7>n=d|e^)xKxW#=H z#hFmLmltjDON(@X0mh>AJ5LbLfLe+_g(ak1fyw_0OQ4p5zKK(lccT7cFJ}KI_1NDU zU@REQ|DPh1^Vv(xccN$6p+#i?_$7M{$x7z;)>kH5PxcWvw#jh|HL$SKh%W|1wx zSgcrFOidmbOCEnuVFMA2Wsq#ls?#WleIAZjepxxe1Y==R@Cz~+FqYVsyp_N)FcwU7 z(aO#-FcwT0i=Ya|5;}G-wnrI^MH%quSS%PzY+_zJ28`uD4Lydy8jQt}<$=M|z*si2 z;xYJQFcuqD7^a5?#`34Pq!^3^v)~7vC15Ow@$0!B{ZA zi&mn?pzdbuZ_IbbjP{GQzW%Wf*ZwpCV%eUwJL8oU5DVg|Pf}6_5Q~(&m%kMd%lf`q zDcW`*mJ960wH_uwELCiJ)}RRxOJ!R?e<=cp#RO**Qh#AdlFacuO zPLAvEL;$hun0A`&lA7@H=dP|*-$1tpV&OpWgm4asB_d-~`L+)bOUdPv8S+v1!{!Rjl2moazO{Qp5X@^hGya>cn zljPc8A_c@EHMjv;1;m2ylao5+om5J9?6Z_QBd`lfA0eS)=Af8_+J z&pR&57@oP%>nS7_Whbe>vuY~OPWowVkYzHm0{XEr29L8!;nUM80UN5T+q{8T5WYTG zOCT1**^^Rn#y~87ysa4$%D4@cyN_n%Dg&`>AaCr8l>%as()HuHW~>mmWtb@A%7Iv% z`fR1tjKZtiSm&}Pj45a!7K_1U`Q0}e*VyWHjl2IfD#9|^?-V_ixl3AmzDvjV>$5B8mD0x4UD>a8Rq~dW6 z>jcCytulBGhX-O|lobWmlmW3|=TWGtt3WJ1FD>Txp@3LWk=JpXfmqx}Y=dgbfmnP; zo}(sw(xRwZiw*Sk&`1Kr(vVQfIi~`|5=f{KHkoj!D*ptfZUhxTDnKl#L)%HQR3H}Ap&g_HR3H}A=k26;Di90G48>~j&${UBMe>v0rGbKc3KfXu z(&HWPuYYA^m7N+{55#i4Fpz~(F1cP^X5)3Cz+ir^3?eF(=aTo2>_Y*upuTuvY=Kx# zQzZg%l^p#(mChhsH4w`NW<5&R3y8&wPo|m#0Fa1;Y6TN|0wlF17cyAyUUw#0!I0%TvN7!Hz1jHh2Flh|}V)5bcqJ9YiV)0%H8mSEe zV!66%H~+j0h$ZM($F={E|*GBj<&eXj|`VpDU0-&_d9Vsm$#e2BGd^Ax*fKwJ|& z2E>AOsgkYO1H^KEc1iZ2EfC9|gxV`EIW*1))S0XYVli@gA^W!t5KDZw6W2}?h{ZOl zq8<84>W;DSnm^-!SmKdqNxNCl55Usb%#8zLiAR=@_ORg9N)|?QFb;@iBFROV7TIuU zJjp93(iVtiBFQ6XlPwU-xc{&Nyc4P}-U2HEL_AZ{T)n){X+Pj0z|$bsHd- zctQ#PS|JdNP0vL>G@2AR*tCq%&45^hu@Z_25R37^E7>n`KrHdoXQ7$|h(!}W#EZ#+ z_bGFVZ79`1Ec z;psRamiRxNB|t1Te>zK`nWFH4?dM^-Lz7fB5R2ot2_TlU++L_80b-eNtm3kfKrAW9 z^Yu}*A9dSk11ZQ7AQqd!07u$55R3gF$+36>hy@d0Uu`lE#4?`dId1F-#FAn^nznO% zq0VjmyrbU)5KGDOSatk75KC$25n-yN0*J*CJw%G30kJr~nxk(3V(CCuEGAR|u^4## zMCv31u`IkR6LSP&alF6q?mQ67=EY}@t;0YpRm=CQH>UuxqWvCWih>4ECq-q zMSj?EBM=L2F|XP%1&AeuHtc8*#B!3Rojg+s#F9dbOrE(2#BzeRDS74s5X&)|Cpe6X zur_6;)J5H0-Zr;fNGyw~$@d*MWAqzpZHItZ9P6t|-flhk38}CM#4^lJpbaJiu_WVaxcSIsW(Lx4foulE zl1htDwis#00>Uqr1Y((| zY+Bsp2*lzD;S&cS7W`liQac5RWrDwrrjP=}l0qrta*;qRDU|cvWh4+w3Z@AtY_@yCM$6BJQDri~wTUmE_&mE)K*Z zGvm)@i2||6%mlKZivqF8%mlEJ z9EgPgbtZc1KrB1iouaksKr9jLCedhhAeKn>1JSqYKrG?BhKw!hKrAT1fxcVfKrHI3 z_3T=4AQti8W`bjVKr9)*)mB@9Sen?MGfqfSvxh{b{woL}z+#9~Pz40FAJSS(&P&h0P)V)3d8?AS33#B%PD zXH6&&OF+lo;U``|EM>UPxdAVli?m-xC>b=A#z83D1BQSQtgFalyJBSa*J3*sSgnK&KlB1(DOWKPA3_46H#Ty3X0*n-E7%Td{Y~tB zsxV%H44dbNz|W<*BcR+QB&{QXFpmncztM36duJprq$YH4%2eIR`H-3@;e=ZrADR|g z4pYm`#9i}UAvIxcMaxa}%T$>r*qsS(Rc7cL9N33cE5fGk3TIriS7B3Es4%yfIfa}t zgS#js^;TV^Dx5DNQM=~tLf|(OnzpNaa}!WY*vp2Io)B1{n~?tVy=Jfyg~;DXPAG>l z*UTf>v10^Am-5(~$VevrcS`Ep)7bLU$iatN1_nC=JvHV2arP`Y9)F;I0`R-Dkp4QnR z8M`uq`V;#QGl*_Pl+r1wZBj8(CFDC<^sK8{!F!ClL!G0X^+$}xP%($3mOYy*qd6If zXe+)P`%lg)0m?0$o~6?=M}tq!Huk1uWA2&_x2lE zkBkyge0BbT|63r$kIdiXITOKwvL(cC3w|r&x7q{GnO&S3#CNJNz{RgcDCEKaEi?XG z#BcKu(NO;Yw>~9lnu-SsyK`HJ_+Z|C>6_-*&~0)7L473Y{isGuTA07bwq4=?HmcQE z*?Ytr@{UXUhCmKxA15_iPNn7w&wI*$HbQzLbb9;7&}rA0pzOuG6xEsr9wqw`LtNS_ zm|W6dz%-J!3Ly(qB*BC$m%B35q<2DuqPm@ra7f28W0>%60+-2P3fZ?3gfy=!U9?SG*9#_+gV zci1d6h^Q-=Qv7FKq+xTH)(aKnWq7#hiJw&c8Z;R#>u>Gfw_ZGxsVMHEDjQ@?DD>x5 zLJ~z+yjcdjCBYbgt+*5i#Kt8^D9teA`=|dxMWbSUf>lRb#uw4yrQX*?(CMLY8iZ6CG2LxH4YSr6g)R; z2@s}6AO>>Cf6Co0l2lKv3f{_mRCkH`&CIFsovG7}Pt6?#BP|@Y@_RSCedhn+$d@0x z+3mI0VQSZ2h4N!f-5y_q(^^M<2EVb=^k{b;3H6%QilvInUc(Wfj-!;@d)VNH% zOxP}R7h9IynXp==3%pAjWaiv zj`4FxwuJn;wsg4NYyMFAiQvzwKZ8GqtrU-laW0RznEeh}sog0R?&78@=aGO7L|&Us zkPERx8s6O3*fJX~XXol8H@L6y+LgQ5C>I^MBX-s6eV-SuS#y~zJ)H*@()QO;eCyPU(m^qeZUO>+O(rA|%; zq&}XGh*dAz#kABq{ES@1dd<|)`XX!(IaK$6rK|PjIl1`V4SrP7_kG>bxIg)heQ^67 zpoDV`p)=(Fb)O7umCM`+vE7Zb&#b-S(-F=Cv0Co?$%Mkk);k9@iRa$Q!)BU-xIXXoJ8_~}NEo46~qR7jx#|ke@jX+|=0zXCf<|Y@_QYSVx zPqqaPEOKPzqW23t2VQWr<(f7&Kj+;N_zry6IyKqm-u$f1ci_0(7V4iENoGzFu{7tA z*4>0vx7C}ZCe}f%dj)Sdex9TUalddBicare_2RxIRmK|hVAo)~)Be1RPP8Y&CKFOO&B^J*2Vt0z zyFtg~Bi8Nd6VlD`A5MPC4IdLPLqkbCHOFbF$GfoLZD$e57yl(AGJ~ zEOI*ZSVYI6;HcB9kMAzm*T1{k**Oj|6YBq>A(!qIY)XA|V;OzvZ`Wg&HmAP1wX8c8 zwD_0PmnUft$y*mQo%9|92R>hE8}~@Xnf-Y8uBpD3_KTQKJL9zOy@o~3JB^#Mm9$x6 z7Hu%K@F}0JaV_>Xl(4g?P+{`1@^UOEruu41$GAzVuhO3=$P*`+TaNfXaon}o$#J|i z@sYA^v4CTA$?9YEmCg++P@8hW$?nR>jj3agW2C)uZw*XgBK>ol2A=S#yd!I!oOMdb zAs)?!QzcaI!2?doI@zWlE9+xhXlYL73m*xWmycXJoab<)=UU2@aTr;g)ZY`Dmv`}N z#*LgRK2V}5mzP~G>AhbKr_`lf7@v3AqFVbtT$nb2GGeEmr~GnSE7QR#^nLg(ZY2K_ z?aPtX%dth_O|h3~|2myg+45cxF}O}gn`x|5btG|Wr9cp}7<%b->LK-q?`N*0G>k(# zvD5FTD;47pndnOoj(nc#3j6e=D|&H@6AUX(3h!6L7Ed2H+AXFUB8!Y+Zzq+Vsh113 zODb%PyL|sltlU#YJ2_L~V?R8jpYFYK(myrhD0% z>n2p>5kZ?d`}k> zyJU~5LVL(F_Q7?B)sJa(KVk1$_W&X%Cp5ZWvp3f@^qr7<6VE%vPw$hE!|#Em{U9$U zvsi;1{1r3#V(S*M|CnpU#N=dcAkmGne%fm-Ho%k=E7sK5$0lJ$dK1KAWeZigvV{)T zeZ7nUC@$F}%z_xyY!sCBK@P<5x>j{u()~W@kzH5oAjs%bXL_xRw#N?a-eI~fB-2)I zzcaL^RPOCnIWGdal-+kPi@ZpWXRFR?OUh=gGvMDmGrg6#UiHG67qWBfqyy}&2YU%( z%d(+k4)k6&bde|?)}oBEoih&?9Fs-c(5KlCIGZ!QWYKnl9zicVcik2n7;YJCo6J$U zQ)YPEw*FpEvDyMFS;{`Pxma|;VcBMzwpYFPIGe;EJJQ#y)&9KKN$jKCs_7{kUgsIP zb@o)Bb@tlRM4mdosqfahdzv%oQ?~R0wr}Rcf-SPY_CZ0(=>lPu$xLig>vVk5!@kq9 zx{4BVx;BE=zTbtOy~buYE3y5I5{{{|M^)o~jz+*E*CWb<7aR5WU&M~PS}NaR@{K=K zHXh(WFhJN&lE_gBn1FVYk5xFI>O&o8hHbrTP+AvpqjN8fwewlVRh5bRmyo2E;brfd z!yOmsy>r>dRyJwvbjI8@V=LRVu6(Mw_eO`QepfHjwfs=y78}wX2%KmsLtq3FAe?o7 z`b``z(udc2&se;=kZ`yzGoMyhIy`Rtpz@R1Axv7+@N4fk=+D+^4Z{z-k1GG|^UXT# z-tY-mztZm)yC>%Ulg?CS4a?bEMfA5>d@fV+F9eQky8O=gjDBqPDWF&5bWXc4?yx&2o zQqsqj6QbOn&u}%fQEt63J}KBx99#q#rq_ZnAJtp-!#h}rq&#?VDvDR|5XGln&&GJG%b zPX1x$G2>f&j;|BHTjdsoIJ0{gNbRacW8WcmCa`6Bjj zqF6zEI4)@8ZSr|$r=>lj$kM)j`YFeeLnv5`z`Z5flFl$?ETi`Di6lsmSVqP1lVw!H z!V?Z%$<98{@szn`LD)OHf9h4gom$JCq)YTS{c>ur!V}C7-A*bM52r`m?wow%EFq)g zW>Rp;@@V^X$PAGmT5vC-d)G`1-?!jc#3$qXk)LAthYG&u)u?^BL#}21Wd1MO!Gza1 z|MZ5;222e)N6Y+Y0lTw>>}~6z{@oZxzrW0Yg{-=v1uib;YW5)0RHojtu-!Veu+#cY z|5_Pk1@4A|QcHXciAsLV2~w-QD=4hoPrAr_uLg^A1mz7!MlD*!DuVKoBU@l}B|O-2 z{C1<%-*quD=f#7<)e>cB*)KEH2r@OLuYuT+96w99Wwvqn*GH-_yZ5KMMDU0sU$DvY7y4J5pn>_&;+N&oh?#?=V&-4OTIPRhzuU=Mk+;c1 zoQG<^JIzF1H#QQvlG+~B`b6Zx`kO_uu6Ekb4k8cK=QQr)VzuuiK2;lh-56WnQUm~O z@7qD@C<=1jtljXc`S9{a()~y4>?hjNt|ufcTU5orPTZjNS{N;Pl)~t;pXf~Mc@)PH ztx|v0J+#2&AgU@}b&oB~+ncqtP0hH=Xj?MN?RUPUkFcKA-6=YdNI1ZCBK=jQop`%_ zDs(1+YpmTy>P(2Q|Eoye-ihjKzv=ZSVrLVbxp2$=aA(>B`oO{^`!5|YeNyke99a0< z{)^J)gKrKj&T8GXMnde_qCR3?(G~lg zml|mIX~=wR*9K*=cYm!B8{4cAAKP6dWpAv@+F@_WMw3Q5`ECk2LMQoZD}_s@@l*eBWn)Wubk&Epgf&sog1lkZzCDZk2rN zzT5D&QhwM$hCM?2#!zB+oZ-EIypAGA`-NAP@ts6rqe=9=l^pVug-Cn#SCq)^*p!k- zOnc}ien}vv+<5ezDPh0m_Dabks3Nwncu6?49K^p+q-r1f3aW@>xL(@PFQND~HnzOz znSGDy+n0hjECu`Ld3WrezYIUj_28El)e5600f`-uI8m#5m=}HU(4DSF3rG1?k96#h zy@GDym}S4J(=S&eKXr7yUeK*N!NgbnJoqbiIUSp@eD=}lgTLa#M34FhFyXB!fE7pV zt8F0?04wr0H({RxtUT!>$?tarSUKiDxNVmNz=}@w9D9!hz>2)@k?^-dSjm+`*31H| zOwLBgPaFkUIXcaV3Caan(WzPFQE~xRWO47Y0Ukf+083m8m8Vup%rp zDbEC0k$8cnKNrG^gabB#3$QZP=OfPsSQ+1TLP7@#u!1~#bebuIm4Qf|Hw!{o8Q7%r zW*%VWb6f7f108@Br|uV!?EqN8QYL3z{-jRyjtcTJ0aheV>U>QBSV^*;>{~AZup;52 zBbx%SlEkabERhFTK^7jhW&x~>L&8KEDTEcI?@>Y40Km$hS`i_v4D6F{*aWb$$VVCCavoRW0N@&GHDz1!XatT^TAY>*Eu zaU?(5_8DMBA_X~i#Cif?C07R7^H~Th1NV^VRDhMiS%cgH9e|Y-I%7647hnZ>>K)H8 z7hna6PNB~TVMW3m*_;Zn(%<*L#E5{^XC~341F!OsQ@bjv$gWSlL1!dlkN>{mIqjo|GsH;5MX6;RzLT* z)9S>Hwceq@`o-&uRXj>ON<)U>OzCh+vxsncx}n(cKnct#dvrR`@bs|+myf%Eb9-v& zXY@fCw&eVE3{A#`I(?EF$$o14M&pZ$KKXEzFwz(+uC^o*l0Hd^)K1T$m(dI9)y?#b zMBlsXBdO-Yp>rW~&+6>b{Q_Z49+ zX53;NWB{OWd^za4s&~F$*MBztth71*ME=h_xMdib3>R0csVZ_MIg1kfRsZL?|Au}M z*EpU-HX2>vLzv1j9t_wg&UqRSP`Mk^8Hg4b(Q)2)AY^U2i{i;Wg z0R}V@cHK-zDdUyIL5(QT?Li zm3NH+_X)>^W5|i+OSKn<`%=vChGA#ThhdwUtC$O$gS|Idwd>+)D8=KH->&%R)eM!}@B?ATyqIrAKH2Rd`QN>O9u*5KG8PSZlMD_NnX_rr`KlA=$ zY+;Cy&SG6xy;eO|znn&!-=yRE=V2Fo3zmFT=YgqyR+USq; z=8sD-m5!DYYCbK&R62hH{ow)Dr}}f8g z>R>7rhJ=#gpPj+HhDN85x<;wy1p8wz`}e|BIvR>@g>IOHf0nc=Ufl2YC45<0S8U2hm8ntEM9dbe(A^@g{ib)91S@lv;Sp(2s8gT`$I@o{(INgB+|VCm`c^Z-=|M7 zVJcNuxKAE(gQ=7`fYv3gG`{0@w2q!a|11zeOWa4!CAVpCk{d^3(76RlXuTB2$MZ0i zj!vNm=}2={7xGJT#%O+S%(;SLbWIY*?N8Rn?*aT0j$j@!Q`KQACE&hr#MNOcC3Jrx z<`kUsCp4nt?oVcY?oVi0hikko}R&ix?d-n&MqZjDjZVO9x z6Z;4TERy*53&2ItZ<5<5ncyPo1q6$u{1);A6QS<4tJ?~n#J^Hd zOrTicN$q3IWOZ;6LQ7KD<9TqAis<{RBlGb4sAwXz99_937@z-+KAqI%-h8BMeExU^ zxCr6br{v60aFNkR=zDa5+v*2mQ^7&>-GaA-Pf6`hnBXGnr|%0!ncyM?f1|(Ar_H~0 zO@HC&se_BC=Mq*wa<<$#i3IkntOB@*?)XyD-CS^yTw`76sPU-&IEzzQ zJdt3G<|SRpEx-{h(EOwuxuZD3=XQ>C@uSUmdDDS}_w7(Mjf=9}d7_)ey`$Tz{NhA+ zU#xa9xQOoICCOrN5#84(KC#>D-_2d=%thm7i?8O6iL$)f|#3b5_sESB1)2VmP(@WNUA z%Y$uqAXgW^#Di^jz(!$oGn^#L^nR{qF>JfIQ}6la#jx$-T9)XqxUlUOzdfs0)4^Dom=OM=cpIb8>;kFLXs8O|(hyScY?@20_#vfMT>;Hv=JE^hTbw9vq|3w<@y z+?dws#h8b=r*TL{iOt9*UTf~}ZqHu4`Aq??e-X}=T92R2AC}=B@E--uAD7`=nJA^yd|HNcW$_07!%yM4Qh%n{mICL>59}y3&cL~XzbHufz=d#2}n2!uZaR2b?Q|19)A&@LcI^oj8Sua|JK)138xh=SoWBL<}Cz6};ZEFO%gc!-Esl8Y?8jmH;K)tUaoql zd)XuXf!K`U@pW{EUZ{vs|6hDZ1U@+@qASna-s|C3n|@O4o6K~ytR&W&eK|doc{bfe zOkM^{D3lb0_m+t0sn?6rk{NpoH~1Djn!ImK(`8eevPeYSr%feoV9Jb@z*u(@b};oBYs=VNhH2tq~e9#J8`&# zL^9K3dbf9LS<6?h^>$O^-APaDbuJSdm%=)*yVs~Li&;qWj;F&VB=SbO&ARtB=hB)2 zQ44uq3)!mo+!`-2xP&BmG3mvka0yAZS@bTgflElVMUrmAhDXHd(d$;t*e^I$=}n?7 z@`76eH2b^AX-T?!vm71G{*exskmxUDl1pz9F{t;E$i20232E&2(70-nYcC^uI;Et%XZSd|HoPyGDZ1wn^owO8%=a85QHGrKKjy$Cq_K4MtVu3hLNaOl^M2^VC6o)XqC!Qu zg!IRyNk{YC>qvRV`cP8iQLWACR$R=5OGuIwlULvjmyi@`U*4!QLAQfLJ^RSzuH?%= zf@Vj^P?IxULb=_>b9eON63Xq?-&1uKE+PHH()nlM64HO2`$-YzRh7DwJhVPsLe4W< zoV$u}2|3Sba#|GscKxon*?C5XqdR5G_)Gt@4C&$j;ycpt$vJs`5~O$F63Y6d-4P9g z>(-$&`V!f231uO*lEa5)iLOI~&NSH-x`t|U>JUbMkP0<5xz&ova0#hEH;suiTtYcy zGsY8rxP)B1WiXo=olqh(kxSNx;q{uLRc@tH-3DPb&ISFAS8}bL$EEj4n_ty=Eaez! zeO3Fh%nFs~vQB^CYzf&8!begUs1}d~T0Wa?np>@$d}t_5-)tc_T#@syBH+ABw<<9v z4{%;zEjt{^*~O2_GtxhwLyrCv3W7jTI0ZqB$eY*4tJY={l#=%j!8oh`PdR*f92lo#jM#aqAqKii{OzP* zM!jKZ5xKBYt^GJ7*6_KaouRIJdnn@-N04{K;CT@lUZmvgQ1YXZsg3IVr;`5~RvY^k zPp!{6v}x~ z5>iB}|4aTT9a8^a@<-`@{%57*uJld)o9p7UP8iOp&z|CM&5|(0sa%23;_R$su`8@N z`O^->hk5@o)APh28HEj(&Bt!!wB^AYD0#(hNKHNoW5#)x7i&OMh6vHBdw0F=|r zN&2}~8vIH6G#KIxue(>O#T?IqHAktYnCF}YIIk2%vo>_zVXE|0($+A+8JcmbRi{)! zT{qP!lkVBP4IoSeUBB#bKttC~f(3jQLFl&S0U0 z(^%;-*sKNPie=otm4hr8S6Dc7+^tF&S1=zL&Dt=o5XVZ1HAom&tQKxyJ`BRRqFcYM z(3S|}3JYrvg)=a&U@kHev|wC0RJcs6)`M|nJu4f7roySA>zE7c3Z8^p7(6ZJY>#%Ogxh2xm}3>a7PNe2pF z6JcD*BgGd!Ai}s3`!$brtnh^EgvNIk-HP=e=ZuB|i)`u+(IVCWMmHbE73I#uW2Z1M zu3#isNEH}Y5Ge^`F&G$EFnR@$G2#+~$EGlY3>a6KNWB#2F&I|@3x|bKA2*yP_l5?< zeB8Z@FqW*Z8ZfR9aeCZr4H#F5-N;z?!gKz_Mob)QGD~+L&(Zuks<{$kM+=F4m502o z7R>vLH5sz8?wn_pq_GWgW*wES%&}OtI%JCPSQloI*;uI;yRGm=Y`6ZKLVjprHs+1m z7e=^BEU6H19&?@%uEjmc-&Uv)OHtv*@^=*O#hf1$1XI*f+{Vf=ThyZ&t2PT^n1^a_ z83fgoBV&N`n1{tHE@O7YgJVZ9F9ufwR#lc4E47J-RH}%FXkA7uE6xjz$k@b!_Fb!L zu^xq&FsIZ{GX%D*Xv{CQ2gFabb`w@qyA|t~#%~68y*vx6!hNgpn^~T&92&fX?Ai}F zFIDUtZa0gm+u8p?s@Nyo<*7HB(7#jaKmk|zITY2*Lhd8W#0cj&i>iz24^n>Wmvj-k zd0Xb%_zl>gjowM28J)@-5k<-ycT8^VbL7mdT{OaO*=9@HmLa1|C}R^zJ2JeK3Fp~M zS*l?h5^LJr`pzoM!E$T7Afu==fPVsn;74%@28#gPb>XN8I+B#>eDl z>9{qly`-GFV=`ps9Q*m&dq(tKGbQZtwa1L!8Q(W~SHk|h7I0qbvrkfV2C#{gt~bv= z0|Ee$-NBvX1x%U5yv_O#0bg-O$a`Z=XLn;Z%uZ$vAmr5z5%}{-d-?~Njal`|v>n*c zLN6?SHY-b6Vc_c8Qe|ApZYtTPFG#A!msePMaraJWqp4AyFe2moWTc{0tc=KxeT8d{ zu59pE9`n8|wfRg*QmAuKxYR#czWpyVAb1qjAC^^Xyer5>tw`@A)4qpNzr4&u8k!r=E#;K~&IjsV>exRL>w2f`S&(j3M^58~C3@MN zz~^d%4b7z;heiPBQGT9j$s<9of0Z>{Z>;5PBps)&Lyd1IT~DawG^@lnBy7-XNH|xw zj|!rO8uucdqQ-GDRMfB2O_@w#IOsavf;o>eZ`uA5x3{1Sa2^$Tt=nw=S>2J51A$Rh zOHQPdBiey?cf1URzLo1`+tWG|DmqS%$fGtOQ_GD zQ$DGFQ-;jHQ2=Z~GgX`(6~K96a_5Q)yr!$7&_LcWUti}p(u4YW?UU8ItH{b^|B*i8 z_K_>7+-pd*`&Ej?{7@O-Jj$a1S(@CeQISj;kwOWP4Q1RwHejmo_fQ)GahEun7(3=| zl_xWVtzDXKUs$`5uRTV^Cm?KufYyfnjA9n3_Ua?-Jt9DnNRpw)^{(Q(*;xJsI^1MS5*#Xc*99Z0h&9%mm5 zI}n$od0;Q>Koj96v40oB4rE(X#-A&M9Z1vfk^hzf*nwo_Y^qCUVFwzB&>SC!9cX-V zgUb_H*nw=TD`r<^VFwbXg93732hv18N{WCl`h*fn+S6ESny>@e-W?%_uwVx&e6gq7 zo(nrrp~IfU(stN^xIUUCeAt0ve-`T4zz$@SIzDOS0y~f}^mBd|b|7Ksr~FFQyP7K= zIS*`M2a2OR3_v}My22i^^?-{e>_D2j!dkg7S7l{vx@%_PJ=vUlHWp*NyJVArI@to-Zu2*zZ5sw2 z%L2~ZP%3BZWdY}HEJoXK0}Y(cLUYIw3A+CO;+dO;O}3}ZdqxE(S$Z}gwYDvzbUe41 z(@?l2e&#Hxe!7g5!m`vnrSvdv`eICE&Oe-cvYTu^jqx4`3)xYuE_q56IeB^t?sPz95+nXMbSpmQpayP7ArkV4xLC#9M`Ig8|NlJ zABl)W)^_@i-*<#C*#Zu=IPB=B^lx&_#rjh;cd7alWI;Ts2w4c)qe4QaM;sUDs;g3>Xw(%)wK?+UL2b?>V_ zSuN)tZZ{wNj69JHxS#xKg6~HY|7sZ45~JVwB5z_?7oz7L`E3-AP4r9%G4NqP{rNZ`kyE~&ym?^n&f`Q)@?vE zUKRUbtKk%VYpJM@Ots;-Wm43cWtol2>MHcMUN>>HT7?SzcJE&3m=7np^(}};swARX zEZ{5gA>yrSw`8J%cn}4GY!7^t-ly*_hn3-=>e^T3_8{XQnWLuD0jXw_U0W+e;qi|6 zATp7EAF92ArzWn@3Sj2;2r!7u8glKmT&ECX5H1REPg%DLQzJH2C~7bj&j#N$;rW`|6o-$6G) zIAo4g0anB_Gh+I-cki@DSE_ish4SuXr1d$M$&910_t@Q{s>?DKro7{409M4`n6ukc?c58~N<~D&*!{i2AItJp8$UEGL9Js!qm9ulxPxr8%1G{-U@Lp8Ls&2O z!e~315a|BI22Pgqq$thBiYae`KP!7LA(#aNiw)Y6+hK#Y>ij=^oryn`i`)NC3$hJj z#x_Wul(D6vAyiZ4z;L_MH9LxM3)td)=H$#{Z+K@m zSW4VEb`wSx;*6blX%GBjc8=wamLP9J%7xu?Cl14dNcl+)#Z?&uOBbynt)&a*+uXsj zw3cqbi!N_s=e!ONUYnI=as&>_FtzMd*XP~X2|t>y&#petcf!k%H%d3m;TAlLc2aXp zs(Zk(+{(;0dDH_V?oR7mllwhDm|MK=0*4uRbFNJ5^j#*qv70nD$xu^zxHso?un+ z%)T?jlM;zZC1|NCk4TX%j29Az2|J#~8Il7;csM2Z_VtGKaYxa%H6AH>r`sDP?z`-; z>Z$f{PH506*fQgcukBbt>&sU2-$=Mu@gez~5bP{;PLO1lN+`MrFDBS9UP|N=XwNz# z4&LiPqjBg5=+^_d0iDPvYpwFoM09m^8|Ju3kjNR41@Y%`cjD^emJc}{ARRby0Ow4& zPPp#kkn{$fgLa07h-f0`w#2YA?Ra%9zf59Z4N{Agpo&9^MVN}{7^GMvNWtBOR@u>u z4w7@#8F%LFLAL&@CcjBEx$xtK^>M{GVKXvCqgS2V7tpJk->WBUCBD~qP=)1jS9FB6 zad4MGq(x`sWc$Q1yEcjQpUXq8BtRNT;=GQT1LpwOBjJLAdMV$5lGi~;tC!T(;7@QI zB{H2s>6G({32g0ZgAA9*xH!mz{CeDZV1K)|#Bp@FHr}mWS)xzDSKF^*GC(AqVIl#Y zBQ6KzDMfKhXwscKm45dj_aTWU-K}FWB@7%RD?2dUoe8-*&n!9FTwH=4y6HsZW50)W z=^afHwQ|F_XU8=an&gLd0&45xJ5(9z5~euX(e~cbtT%8NT?a!hSkzEX1kp_i6XS{U}0dLQNYzLH1Jm4E8Km=N$ zwUVy~KboK6j)x)1#0Md_I;JJw%b^o=6mSv*5u@EAPvaucN*zuf+QiB>OvYN5*z!qp zj?M;!YZ4QRH=yC9bQ8J?X*dx{AU>>fA`*nLLI(~~HBux02_18n?}gORpo1KQw~*h9 z#B(QMc1Jq*d_ulLkTdO20D)%5*&_jKFWSO0?H5HL8;f4OJLxL|gEV^e{$zy6m85;> z)q9h{B5=e*;yZy~3_q4!s5bk$eWdF3`szol7~HZ8QUma)2^vP!e?>vZ$h0O-22HIr zBTdWUKBa6SsNY-k%VsD2hRY;G6?Fa0jm+Lwfp=sc<(@@LI~A02ohY|cUJ(jPxVDs> zltf&g^Wc$!veNpLFv4!R*-E@SQv`QA#Rqr0isryPggZ~FMoL8<1Ze7?jB4)EaXO=2 zb7J&_w@x+^1{tdes9IE^JnZ^(wsGh;32=eG)){ULiaEI^@`t0MPL$8$BaWvZeNdTR(O zy4X$@HH+edF5dgH?H@!R`_l!9cR0aT)5(=*U5ZYv+eIs|6`|L=a=*5BIw4JV3nA@<;c2Flp)(VY<`HaVKFXS-egt5&4>z_c$8oKD5+iD?(yo|IZb(23?#)0lcB_wl~s-;~JMfA@^QctjB7 zr$EPu=65GSZpw24TSt@;R1`ZaKbE2gc{rqsZ&-vAGETt9CRa5F&HoMO} zs84`E!?a56K;%8zF)y3+hr8h`!uf!*`iHFZjK?aqufEzHAA?v()9}avo;1Wl)QraO za(o7l()Cn=-VB@?zh9D?IA%1i`P6^zKIgdfJEoh;{7^_{;-y0}(#z-ODnSW9FbP8FNH5H zB2UqER7B4!ZHC&C`<}E!IWp9is2o18w1wrbRPOmKQJh?wcof=3@;2Z1&%5vWG*Ov+ zKk<}`?|FD0`4^N^T3I4-D(-KDw^?xEN9Fx%VGb*Se1pYQc|SxusQcz;pkpB^g@sl@ zr$0zkxh?8OZ&8u*^sj?H5f4f0_^S3-{Gy)~C(;Y4N35zf2d}3PRCXdElIkI%f3-h6 ziYh4Stj8))2%xg>rLdj_mtIu%_^sOVU=JeQ-GB8M@37!8%T8s_`SHz7{^R!rs?wl$ zc1PEGwj{#o7nPWo{Dwq$4ynYv;LMr*r)2UCD}r13O!uCW@$s=1?COY%$HG(eO?F63)vsd zj{9DwJnNGWM?xW#M;W4~#|J47@OJDErhNlY$Y*11rRMv|@7KP;K_a`^^mfuxctI_1 zt(x7TT@d~tRq!?!8tD&3CHL7}Xp+tS@QgHzHmy}~`4CXqklhE1bA^H7O>d&oY0k43 z{%&oL+zag>UrqPUJv%U7QC60bA3m;Y`hj+c{m|4jbu2u5kkXQ|_n?c~yYTVKvKE>R z`J7&61kqV6$a;>B%>aRQmZPjuzvP}axb0HTZO(*1A zGxl3o@Gi@JNV@Q=>52Md*7vszJ0`s`wJ9VNY9z^As2OZ_{#i9*ZMtu0C0XbMog>8` zKW-r_hywgg;`+{*8(R3=86gj%<6=m?8N11T7<`F~b5Xw2b_J z8%Ekh&wus}xe^aEi|Bb(vw=yNS)kTMos7&Z?R05%PncO=PCANa8pF)u%O}ROm0@Pt z6B!pPFAXz`@jzRfwkXUj%J_F}%Azo{DEs+M2CRdbMN~xSQW^kqU7uGEEdQTdsI|Q709BJ=i~7-7RVBN3hG6GEGh-QA+7BqaiZ=< z!rSdY7SZ>+g*oj&7N`|@ZwzEHqV-IM#sgW}(W2=12eB%**Su?M5tZ^(sgtVS?IFp& zdcJKJkVSgEsO7qa)ED~$HW>n0M0c)hjH_${$Omj9(; z#2Cnu^(`OBvg6d)RIC<|CBNEhQ8o+6VyhmsxFHM3qLsNbsu5N%&9m6I&HBy)Svuuy z3;ei1mSj<_)Wm9ms2N8pLdqqS$Hi%#ISSLuGM4l zkYU@@{;YW0)<&5##)6dOb}e`_(n`Fg6hywJbnZWyk)(R9|71q;{K&s2cWT{Fs?@rF zD=&zgn0Jnx(>ba&o7Ai|d#eCa9(Ouj>{@-0o7{`7;ONdC!;#PTDy7D@9BOQjE+kD$++oI)TlLr{zHt&?nKVo|qnnrpK z29?TI+2v?eY3-BMxJ~j3eb@>85uKT~F#%BiS=lMAwQtu7Ea^_=YCYfC>=+#wn$_8> z^(5(`){|SSEC%da$-mDZ3F5*r=Hz1A)c`K6Rwci;T@B*O2+EV6+pY$Zp*Di?Tlfl@Txp{B??%y>pS<`dD3!7btL_)oQn+kaJyIQDbv zF_{fScWkg=z2vsj_@e~@C9w%7bqjFE8$zBY?9wgJ?t3&a&@qZpNeAbVhIHFB{kZ=xj-!)Iu=X9PorHN@mu3<)DW?e~}`~-y5+EZ}l$5UXJ8hnbh9dn8l zAP7vgVVw9+vLmB{Nb+>7uQ**%a%w>D+4*+a`y$=YDbf_8OT(B+E{G#FCyo5pBwYq( zqhuw~8}7BbZfE$X-eW#s$}p&yVIt`~rH~jb*pjN@ij)>n;+g%r@GYuNc#m1D3$M?v z<7X)iOg(ZH{F^~i z!Vg`jTh#sBRLAZ(Q>EpRZ}hdH`FSriUFAOxRQFrjM5*gFHI}K5s=)WmaEvqSPPt&u zEp5-Y9y2@qx*@8%mlrUk$R0CmXF)n-N9!sK>vh)n&phuL3xwAZs>XWx~x@CHhG`aD-(HDZj$X8lo0P5&0~XCv&#G*OU?tr{OFC1({V)nGWz z+Fv>2Y6%Q#SV>QZZ{1KeQvZ$xEk>&Q zMunsBY1>8h`Ka(6OM`2#dSz5N#)2w<^ecg@zFy@c-d<1A&5gglHCnS5ny%>os6o>e zzWNJ)KUFL_UTugHnMAi@dZJ_^BCpY(a*t50P0ZfHNA4oJmzw%)T`PWqBaS*A9`ZYW z^uRi?ay*_;Ff$o0=8MOlESSDi65pVWc`8jlW-dD}Dy0A0Bdp zuA;d28G~~V<(kxuJu}ajpt__~VVlB7x;T&`q8p>eOrISled3$?zJKfq6E6KLYA+rp zT*y1e=VM{QHK8%vAEIEw#fDQtTH;~C6?=yr|8S>;*4_RNszO3)=QxuVV&-b_DM4*~ zVR8)>CS0t=XTBU2CR~(8n2<(?377g0*5U(Sd+Z6m2B(rM=;?|JL+d%j7qDRT_onRn_A;&3<#-07aN^^;KH%!-rtPOeotxuoDS~SG zPgMx07DYGG_&lhVH;48pMmz=85=w!{00~qJjn;q2UJ+D_;&Mx58=_irWm=*ch-&F( zlPu;zwG4aj%e8+BswHBjvD=pfswHgYS+^nyR0|C|7ka%LQ7!ssD25}TT3$1EDAL_P zwYa5)8omY9GQ`9y^4vhRxY>ppj)H1=!`!X-$_-SDTTiIT7^oIV0pu>Z>C1+%Jm?-K zfocg^x!?VS1geFke{rR$8&pfTw|;I5s214zucSG-y&fRV=}%nn-0&)4ntV^v6|YZH zEJ|Izwy-%w?kT7ieKK6GcB&4&(fq;|u?>C5Q$vsc1xd5sqV&z76rW-W4UTAKg z_SFZ~LR)<~?V=B=#Vshbc@$L3n`z_R_cTx~v)oIHV{TCC8ZO96Ep`LdazT)v`rZvx zOSm96^|>3U7MgIFc|{*oi~hxy5gxhLRlbg`@-1roJ)&CJZ`Eb~1l2O)r3Tl?LAA^X zLNcu*LACrDd6Qjc4yq-}Y=}ou2i0O;G|4$A1FFRwI!IEepjy{DvPx zR11}*-uD-%mRU};jAA6HmMFh@j-`xZ6sQ)qjoF!xpjvu()9ST+P%T|vHkl89rUn9d z^$*#gTGVTozP^)q0`Y->h5C3lNL+Q(-)Nn5khsv(HvX}sf!1rKDD&hJNZh{$dg+Dg zAaQ?&24q0uLTF&%l@)A&)BjOd=Yzz3!K1^Oagewl1%{cKmq6nFHPX+^QU{4^Zt+E+ zoCy-w%wjArj8j-ogibhTjnV>!d$82Pmd_#hjvVc*l_$T$DDI%gV{B8khs(lE3PKG z%IvIqs7wO!OZ}h3zd+&+@KiF-n}ftPkC_s9WrD;t58?}Nu|eXhKmSvh%?62^nQs>K z6(sIov|ipGb&$AG!U_6C8IZWH9%9QpKS{r~70DQn7HcNzOD>Z>E0t!aTmQ&;fga4P&`%9hL6X`Y`3NL-7IzbFNn zAaOOe3C#v)LE;umM;CFIK;rhlx?BX6B9xr|M2r5fqeq}tq#kNTjOAum%-+w6Km~~p z1S6jf%pS7vCw=B^)X4qYPZJ3bfPN=w*DMacwARr8i3`mmexGle8>-&t~_JTKD5}IIu?CV5Y^HT&!OUX(GwpU;5jt=4*tKR;5oEp@oyK& z#KIC}2U4ifW}kU-8t@#lP+t?Mmcd_k$wq}QFy z0~TlAQVqUEGiN=D;W<=Hk47z4H(lzT>49}rrUUbH?$pPCxO*&`K7Q=I>_*L}r zWfQBOKTW!!WCWf=8cWeV%k}#Q*i{y1mIUw|V&_{-EY>?9|dOd~1K3@7&U5xs|lbS{5hkyL^9U4c=HB z(;#TTbLeulpnm9Q;fS?`#aFo2{TiA_idP`t%Hi2)xUY_6D8!T=^B)H zNCjTEjk6|WgM$lJd9vacYcc%c*ODOtS9wr9!WP48PA0Fh-?&XIK$d^=DvY>mi`4nh zDU#B#)>ta?V%uTp6-kF)k-B8O!Q{#sgAF52yCp}=CKJ{eNI3AgzvQl`?cOg*LDB;x zxyfS`!quELr$ylU22_tg;|Pqn>qv^ftO3=su2E({vrU@Ix~jHrLIDB<+LL-~f~7}J zjbrL;+Q!yRXg(GFjN$iP1=X@<0TpTAcIi;&)#ZQ7Nci8cLU_QzOktAqOXm8yE$Y&I z;#KxKGtIw6=M*O)2mn1LMJT@QRgk!Aie&hfR~4C8;WCGm1plQ)w8^B-8Zj~K=0s5} zCM2>=j(oPwagDVYb_+`ss~8g9CQc@|9bL0ctYGtf(E?1!Z*9tCAIJ;%h~;gW5zSNd zh`A~fx8{sA|MXQ*Eo&yE_|8`o$Vj`$1gh?!uJq5v|AnMuSJ7*3{^H-Ja(ch{WXl?9 zPtnG;HBx?(+wQ0iND7Pi>qOVkuP&r+_rUHD&r2b!X+XjT)hGwi3Q^&H=oYcN`uJz# zh=l~7aurkyRF4RC+u(EeFYcm3T-#y6g{yXJjKxMaH;Im5CiAa?YFQhj5pt;wRLhzx z62h=HP%Ue&ND42tfol0*ibhb5Ue9H}QQ^k>2FJaOSWVPMF=~Z8_qr^o7E7!;H%S&$ zi)MxdB|ORN;2*N=M7;jN%arIOdCMZD#a}6*FGMx%#iJhJ^`<^(_HT%~kJmX%zwS#7 z__a@b6hGChnV+;|S){QTcirw#1B3+5C@q%C8tJ1bN0V%<8f9}6Xl4wwW{rYNf}e6J zAqf_&WCJZ5r77t&W5xwd*-}{FJorsk&2oHGkkqK*l$~ZUrqFU?x|yi=VNAOfTCwPZm(=`0&)A#B)}J0`2H;0ZK*3G$f&qRl(Q5sNvtkOcx~0H`cl^Ch|W~k z^`;QZr<#9UUl8ASR(7Y@ln=0$v+9+oi&H95mm{BL=A44 ztOgY+qaj-*^;<^kw{8%4C)HX8D7aHc6v$yodgSv-fts!2kbu;mTGo6*McQc=%dhXF z!XYS?#V6OFQ&+84l^1KTU!jg`eivT}e(}Q+ZoFI0qnfu(P1I>kZZP_qT6g6doY&p( zcnemE17NvkDu+r&z|z5y%Sb}N!l~F`Z4F>a4M8eK04&z9QlBgbV6hI6g^CdX%jP0= zL0S@kWwUWwOx$EOHAOk@gG#3p9UxR<4J@fZ%(Q%s~V!Ka&FhmUKSx8hZTtmy<+~ChpIepNa+af3JdAMFz_LYDj-CWyA!7}b0W5M2Nl^^T z>I{d&6^9Y9c-mciEC+XXkw5|E8h}O4_#jd-!cE=aj#P{QSgzU08CwHb4v%0s`AGnl z%`qC3OAG*u+!Z8D0AP{3k}A9eIq71#A1T5J2AtPT`f+&GfC~*q-1($So9EO0*Jc1% zl)kY6EJ==gS+Rxy7IuX^@46Czg^X3_B`E<|3^P(F;b{OCB{mDMe;B}$CQmL>S^}{2 zh#J}_BVd{NVA!98fW?QN=gS7LB#+`}nhgOgUi&7xDF&zO5>jE^509X!xQ&J-XSkgufXY33CEaZueOG9}8 z7Pw*i%zOsG(i3F3kcNO|X+Ce60bogra_=cJ1h5z`WUlN_1F#sXX9$j@0a%nWnUQ8J z083hoVNn_a7TyP?eg*;--ind|1Hh7GxPx^^2?2{&>&CE<9smoHE?@&#SXgvecn|Eh z^iT}h?1D{NtOA9w&>jFw&pE?#Hh_gyfcCnW24G2xGMr%pSa@%gYMBUFc)d!&OaKd$ zh~<4z0GeuA9(;4AK6`L02VUK zFe?whvMco#8^EIEo#vkgU@;tG5LLYZEW9!$4K@N6FRQeEGJqvX;GI@W2C%S46uiRH z04!;NhONm6SZ0z>>TY-1CDBU?IIt;!MR+M-j06EEoZ>{NI9+*ES&malDNHmTh=VPO>^IumW@S4{IqKTmW{@?krz7vEZ5TIi}I0)g|i}Va0I|&Gh)U`5H~mmU|FC0 zD{c1y083oAJn059vBc$wpWX^!IX<9uU~D~rMV^%Vi#UKqzR`X_vmL;4O-+8{CNi;b z^u&Yh04zCmHXUQ~02Zy!IsCqB02c9u%?*j}0I+l%72mcEz@k-<6Y^UJfTiPXXi}-{s-#HGz62}yuI1XU3tJ7^?Tn}K0LyO;B@86+v+R~iUA};Nz)wr?77Qj-H zKVSo3krx%GUjwjs7VJ0*U=eS)7S&-{ecVB-LJPo>=V2H3SRBCe-vuMazY2BR0W9m? zwS>5K085;mxbZds3*-bQ^Z!j1gk1XX#t{IE_!S!=w2d%|#eW(b@o(dw#b{2`K;;g}@Vyb_iIQ7qqV<6U(7*3Th_+ zEViSD({|bbmJ<`dFAm)VuxPj3eP%ulVCf3dUa$qQWG~L&T)qonITGdGRiq7I(O$4$ z*`ESn(N;e$IFbTjQOLX(X~qPwq{L_!*#cOKxgQkz?;`8n+!Y0by8xCWhC7&d6cDhS zZ2dhnqzk~(<*7|A2e917W`~A%0a&^y+U#-w3v`c!hIRp1kjjyA0L%S?Z1Tkv082`g z_Dnf(Qy%w?LhU^O%MEU?LhwBR%ROQN_lp96MWOqIu04R|F7XDEI;bwW_xfaOK1?jf zbf&v*Hieu(G6w(_By#{@fvywC91ydi>!cjOqTrq4p8{afMoLFuVkzd9DQJ`fSZm6H8)_@@a1XOW%N&)tD53 zWfv)TjWU2`S7ZNxCLO?%rnYP1CNi<`^pt~p5wO(Tu*P-)SbRR`2>Q|hEXoUgk@hSA zOWLyc=UXtb6binlL52Xp0>vMhX8|lo@duQCX#VXpmy48sB!5@_S^5EBQ7-D|TP6Zn zq}J_{>iP*5o{qAZFM!1dn?s3Y0a#d$%GSOB79VUbC7K0bVI76q5de!%K@R0N7Jvm} z13tb07N5La&zMA!IOQ|F{L_g57UhW^zH=ggC6TE-(Fb7Zt<$A1NB(aJZa{8=ie z51aE^l%+j=8X*t>U@6NV>;|wv*9kohz~WV4*a=`!Zb*w_SyuNs_*D2HVDYp|e5?#$ zQMTyfQxaifQ8qp+)P;MesZ#DfLL42yl4z%F>i3MO${?R3jU;$Xte)y~!@Bl2l`Ls(r=X?Fv_5oP1-(~?UFC6!>V@&`o zvlUsq>sSCwD7J`~gaxpeWOPx&GXN}D_6%O%8o-hvA6k@$Oe}q(Cia~OSY|(%^uIvB z;!7{^odvLTj^byVO#m#RMa4^T1ptdtJ-`uw+D;%*+Bkz5wLh!W%P#vSY8OcGipNtEVCmwy}~j8EE$0&t(^#1W|vK# z%pzb}DlgbKi-2Y6Nx}131T0In1y^PPES)RCeLq40ETQv#&D&-to@xEhrjf^zSRyj9 z#F~nrv;i#DZ5)w|?EscjlND>N6#*{0S^3|aR3&HqBDFb z6-jB3FxHK{*bZQcONU|+m{@8jS40f916XuMo=ql*7~lXbYmpQI;#gw4B}tCR#1fk$ zavBX_f$kBg909OMl3acf0kB9m8Vr;mjwMb_a>5BFmdZ&zkzhRli*ub#`$CMek<@ z0KgK97P-0Bzg^|@fj=f&M5H}2jS@Awev;*PTnBUjERv!k^tgr83J=l_Z2*f%1Cl$a z)_1^EU;r#c54+gMKPyKpaC}NEfCaiogw=>+S?i7wK0q8xteuFlB7g-m;yjrj2Vjwi zaSyrF4qy?vf)j?d16V|0JNr^QfaQN_8qo)^Z2XoBVA<~2!ie1pV9BjG$-TZ2z;X3dtp~qtR67P>(H*UyvfBz^IW}=(ap-pd%hr~g&;CFhOJ~s51zi9O zVR8QV<(mMO?NRQXMOy(ZTNeyg_9p{awyNt3jwAzEHfCl=K0_Q!a?I8uT>y(a_ru2i zn*bIU?#f1kn*f&WhINcP8xgSBw4MkJ=>)KJdTyoW0$6gegwXI#081xjD?1m!l2hOm z8rlh9={&c!JQu){Q$QeJOa`zdM{S+SC2k^e-)yYS2Cz7Cdp8DW!^DzJByqoN1h8!E zKBj8`V7WQWZPV%s6U))6sjlCfLXJJ%`p56E;eXa)r!Iiy7;9_R@0CQt zPMur10G5s3$^OXzmaRiKiLNlQxO2-ui33F=};jKRmpXr5Ybc@%0V>zS_oJIbC7`D@{vFZ zK(nEI1nbTeClnEL-w^}y_80l}M&>#uoq17F_7A{4oL%Tvx| z&$>h%$c7&bF5e}}Gh311$m1gQA}?{Lle!Eu10$jy)gYuEL&d5(D z<KV7zm2!L^I1!N*-ego#t$5fqo~ z2$v}PZ1_Gzm~ip#$HA|LFyTJEj$pQ3{Q;MQQ?D$|jBHF{KZtymvhCn|+}{MjSu`+) zVCKf$MS#p}6?X-9rhoBLFxhb-eqBEcCC{M4H%3>#Kgu=IM{XOUaI3 zuHKfy`$x$LYIO3^xT>aBHBXspc54QxPAs1Rn zM>;xaW4_M#363keRjALfE zLSAaEjxJ7Dr#dAVH}1-Lf{xkNTFa+OT&d=76NDu|%;0W=B1}D33Z$Di}LPKJa@`cdKJY!Zj&J!c{u}!XkcE z{M`xVI%ZY{m34(34GKjM@32fH`UoKqJ7J1Q=sShnh(p>(^a%rJ4v0~1#dV`eCGfP% zj>~|C5r0a0+3lBpd@YL_S9joXG!JHdZ_1%H~Ol;DNVkmvnB5fpI=_Y=ZL9WIP23HOu2 zrya@U-#hj|BMBaYCV0E{e2M$1$`U@fynArEJI+L62A8*OMu&LEqa^MSxjt^IL=KLq zm7_x}@wgX9AU}>Xk{H4f%j;ObC8#O{Inj;=Kp2GMD)AlzKbtbXTf#zepu~F@VQj}2 zGPOen4V@r2ghY;hLh<%-y|3GaP6rOfZgvtW)*eup>u~VE2}!YA14J_73>0V`Cnq7E z60L11awCq|?y}kOI_`zS3?xnxpxc5FT^3T?5sds=T!ir*8tCu8#yAU8JKWLG8tWpY zc3hVDp>Rce)s?eP;s?QhZB>P%4KoJ!RZ*-0@4!5OLt!2hUOQ5fQea00hjO7@OWAVB z4gHtXYnQ?OyPXD)FdcCj7!x=4U?x-O$u-uBtB(2#xE=__H>{!bT^ z{nPui~$K~{;vee{7K656fq~@ z*9k*QCLO0Pm-!&lmdV2vL59Svl6*6z{5yRR$F9Iug%&8)E}qNouYmo$^2MlZgNkTJ zTZfh3yK)Jwo6itdZg&k6jw@t2wU&fFg7@+VUFUEUPKIth4u&V0y66TGLXV@N3)9Td zow*h*NzmPxO3-zzcVh0WCov_^I)v(tRfKBCdS|9-w$V`4_?^(QE<18Vmmco@iIt|2 z2a9Ui3lF0015U2AcF8yeDeiTOsR%9a%4D!{5tXY4r-SOPndLYfPNC$1&^F<|rDCGQ zN#-n07b!W3F6lrQNw^=n!?lrnkmSU`wQhuf%Axx^72T_JopNwhT-EGLgqW(uy@Efw zG@QOyEN&Atbh$fyf3Ubm(9*TfY5wF&xzJ|%J?@9&3gkw85IqSq zLSiSB*hEPq(p?VR^iH%fY8)OoK)TNfm3Hxi=iI%LGEqO;>7U&rg}cKs!{r*o zDRRjlDG>QwR$t4CDSggbqax;y{k3KoPvl9fP?J=RChk%ySe{&;bh^<*DaV2%8W_LIT1lJSgRMdy~Ns&&_HljYvzot~lIVxSY+w3omj3NAC z9xPG9hgcHvzj=d+fLV(w5{MoI)$>3fZ0ezh2)+3>ch zM5LOlSiEr~{dC9fJQa&!4{_J{GLEEl4SzRMapIohV0Bk>h@X9A_g$5p z>CM8^UM2OfiRkx!<5dFJ^!LdNM&IuUtkd@;7aM&q6}Y6sQ^@Fh38k2|kLj-RV@R0E zy7KsTo2mcnm-WRN|1j5>qFz(3XT%>0RJ#z4E#<*FRR;Y6wuE=Y(Z$+a?XL^FWu-6d zeo48RQN}bh&3F@4(8ptno7%sQ`n`|EJzH2l7f`z7H0b2JtFRY>BYGE_UXGsjRULGm zJ!fh^9F>Sa>ASbk_k)?Mb$VEMK^4zTZ8lXh9EqF2nNgc?(u1-;GEm%|YPp|imTcIs zQd7IIpZ$ibqBi_-?rvEF?YOUEq1y$x{(s@?!01U|2r&9;6kfgnRcjYe111i$n;?hM zZW=sba&Ww2NvqK60!n_*Cv43UM(s(;SonAi52Y57(h@%Ykf*M;oboLkiJhn+v6Hj` zL0yJ5#7@*-31}JH7)R9XKPuhhRsINR>@zfFf5dKMeTqIkyUP@gyMKs2Gb?H8t{@-Y zdUwgYur|r%LhF5K2$5(0S{OW6P#u<%_aN+c#-0ndio3#*pb0zRfEs*pcw=baGhDx) zZK;;ZAgkGg>%OVC)g7+4WFJ$jV)(0_53hbxf800yFVj79;}v09Bh_K4eNVz+ZuuB( zJ=Ua%qd8zR%5c-(a)r=RrYbMhfasg{j4>k`Dt3CG^*V zW|Yl{DOSyWE+nCxJ}fsUJaNr*vs!&d?ZMJ5Z*F|(VGf&07T)W7AUr&Krttm8)#K5% zOJarlKCT{JtzJ?reEtzyV{4XV3crQJ#PV|GN#B+5?^VO=jUCEzV*io)Y=GJkawj%k z3ajg{TH!S*yAIy4q_9Dg8`fE;JQe+@ToHUH*3a+Gjo30NtX_s;NOe0;O5Nc2j>yvX zEGc8mHdQmGhkSf_%6-v%<$$2N1iy22+3iE3V@XY-_PZjVw(nxx5*<@E>z*7H^)K+6 zB(0lO#=Da|CN0+~D$}5XWb(wiFVf+%xyrQhHnb?baw*UG{UTa}8CIeV?ccVpka7E6^j+pKQH&x>VCn`s_aiG10% zeVzS3)H3M|L;TPr-f&{_m1wacvdTHRB7joHC99vqeA=@qe>)uRK|Lfn`661+HPsYzqO|Ks=m~^`?3Af#17+0C1J-^9kX?qWH2`({)*DL zFW+8}+x}eoyBFWROsg(g<+1H&U-A{o)#P<{*t1*@$FYNI^3*)M6V`_tB5$3CKk?eg zvH##@d1;7^q}yV>xqg(iWG_2)-^EBuT&KKU(b-4!_|YkCXc#dg>^2(hIUAOxchDy5 zp>31#=;21AsN0>d?20t|c8~T=ozm(zcI08@XK&;C87q)EQM^ri!GN{^`P|z`p$M&q zF|Adzg958~5GC0`c}!z59&4H2n$xY>HOf5ek_AV3v&?P3?uKe2<5Bim_pE;oUddW# zi`s2+gcKZF*QsiYlG}6pS?82P7M;t3q^5Ny`c7YGqPW}~BN`9AJ&rUV>yiu`%I>RqS2{(xA>p4;QU8t0Fb z7xl7&Qy*%*H(aUdTxJ+&E#$AZOjI@t%l9R zQ%|&>L)2uoeJWGy%Eo>9tIVldEohC+U!_l3WL-&lZu>oOQ6uZeZKGJd*A?EL`y{`m zuG7W(aW+YcrM|^{B;pyclDtEb>Wc5^xKUb@@Ehi%tKTMQGCRxJE@_?WrHef;z^AfP z<#mhv1iz-HGdnT%@Q=W)EUjevVDeo9G*3fRr2a9}xbz|Om2OdxK#Fpoc@fk9D6%O* zWtNB^?uf$lDJl|a109Dja65!Zdu@41QVqf;`cFa<5|FTo>FKKpRZOISWT4a1mr}^o z$F!XOPp?RQ`Og*+3(U9E&{Xb<^`P8g9^n3#8m~9uK}n(wa_unG(^##bCj2;84-qvk<-bSJkP<1SZwI=Ywp39~KbDCT_~ev}Kl zz1-cB!Kd@|eTaGIJaZDDZe)g-ciyuoFW56SApwI)W@2)PM1Rj)#30Xvglvp+@*B($ zk$B#-kg4)XFQ^Xw^jh_!TnxleqFn1%V6HqC<_q6(H89JkR!^>a3xZRB z5LbsEhzFD%)>Hj9I^vG?;O$ox8^se}H#xFdn#QoCIf@@=$r)!TTnK#K;Q0RVy1{|N zTU4z_@u#s~JYqh3)a*=w$I`+4ZKDCY$D5*3dbN!0(RP8x4Wr{el7laObn+htHpvAB z7WpiN=ldq@3T$eK%IR$ge2r(bnvMG!D6O=%pHUO!+%xN*@!PSvP5KR#=5(C^*xGzF zI4BxG(yOVbJWM}sY?}Hh;9~vg8=pOc?|fwP%>$uHG4N~s=&;Ye!S^%2ucy?~`dR-NtJeu&)t9wF zRc0*mpqW3oKfXSamOj{H(V;(86m8a&5h{fvp}(hYZ_i zY>eHTR#GD0%$$ds5EDn+M=OcFoyO%!mB!_xk*`?chIE##YC}K|rqPhiBB?GhqE#gW zbQ|lB=r+|eSSM7w8KJ5=0o9H5$Eus^S*+8lp8|%6!C~>e>Bf7KdySurKn!J!T-6&9 z(0YE!yuNqloAJK7X1C9ED!#``vEjE#FQ$>+B))m4k%R*X1Y^XKhSy)EsgWNfQi zJXUutkX|oHkameQj#iCLH#p?C<&oT&@Yt`$Csc3slA;3}>Q21{$r3RCc;#X50%O_u zO5I9XZ!x3a_)7gsRquPog7J^K=Kh&tu0j5lu~qiW^NV&KVn+TZBmIbC5fd}Tzd#gA zyeSGr0mahO&Ov2_fMWS{rzrk!6et#yiV408Q7mF?Q?ouqu~4^}nsp+Ig?iP*+HAz!rT0#e(X)5KzCH}lxcqk~A*}7DE4GI(s>Jt9*2T&|u>N4rAC{QdYF+6q- z6w3t1gSrO~iX}WUi(Y~P#iE9ah)j(K#exco2%*MO;p>&Vpj0s$zq}L9tw zgd-e%YB3%Z3tss802368Sh2|fcCI7D!&Ep9ibX6V-T+JM2%Fry0Sk&n>_+?uC>F|f z(-&A!EYt-0OHeGlkXm}M8Yq?sVLV+!4HU~oVJh8S4HQd+kV?Od0>xsoI>ys^SPi{a?6{|-XV%5_Y0|LdNDxJ zsE_iWh6)4y5K2jEDhU(|g;JUNRUZ@!i8RlJBRVNnr10=HilA6Xq)$ly1lKgzjdbw> zD3*v(y0?8UD3;vIq^}o1u|$}(P4CYI#iB3P@~j41H}@u@_To#8z`0wE4RCc-9WLBS~;PQx5k*dXEt zTUW!NSl%<&DoVP6VsX=@)V~JBGR~Ax)NupF;s)V~A*N}r(NN3yWN2A8D3)$L{r91u zSUxVQzGBYm z>w30?!1^~R7RmRACPA@0O(HS$L9wL1J~RW0rA3#NqYsKD_mW%8Cq%JyYmmOrA&RBj zo%H=9qFB23k>228!jkfSLMcHYgUh zv%2dgP%OWh_3}QbgJStDU{;`;>3azj3pLCfiJMSjsgmZTDMYbQZOj{&L9xtmLSH3Yb#q_{nBrsST23$)z`8?v9N#UKz^-R#*gr% z)j_eCPfSrN*q~T4>E;t$M6poE%*Q#1VxhK}kMj`4Lj7iLHi;+}s+_v|S5Pdk>0avU z%b-|3aE?NF1W_zs@hl!O6BJ9P{iSFYqF6HfFGaT_iiMqP*7_MyEKn%XIuD9vN+6w? zWe$qP{P+_8J{1%Tv{Lv)<>}3NW>A~eL9wV~B8hXLSU!6uQ}3yRVo`UFBz^$J^2IZq z`dED^s=9uHCz`2h4vNJ*NFdB%gJQ{Ch>RXa6bpOVJZ2IU3rAp;xz`*N%U4=AZ<{(O z7Illi90YeZyrKK5LoQ{9S)RJZvWNIsJdYzOQ^PkCs;`xCPZ_Y9()NGeNPKf1easXM$oe|IQV-WP)Nb|IVQlvq7<_|M)7*WMBE?cAJI& z>&5!wOi(Nqs6Q#!GeNOvT!_YU5yg^8zl`O8Vi~qJ*ZAu)D3;5+7b!P0L9sx*B&whv z6pMxZpHaW}gJLNz7Y0DQWbn1`uHxRypja+9Esnkg#WFN|&cc2f6w52$y~VyOW@DgO zq69eOM3X+2{gDZZMI-kctpiak8fur@5XGV~{P)}xD3(57#bUS1 zpja+{<&VAs#WLorQGEF_D3;48zR3WhSo+&7g886W=9aXItuBLN`G%ce!f1eEi5{Ql zp)^3TM2~;rscV2@i5_3z{U>jd#uwCOf@1kMZ^AgDVgI+%^iRdoZ)m~(8x+g8|5MhT zxI?}8e;?1jFJmx_F&ZK}6EP%}CB>jfQj-`8QPyglrm`FRRuRflNywIjrZC37PMuRu zsTf-aWrmKXIGy{g@Av-Q*Y&&m54tYbc+Au1{drN}&YM_6V);(}FfU;ZiG})NX7zLl zB$g{L=2kD1Kw>EgR++YQfZ+zZ*s%u~?h)CO$!8S&B>>eM*JI@`Ktt{|rt`-cesHuL_hv zVkuGkG4a=CVi`SYy@v~lh0A@Il`3OjX>Gk)_I)gIs_QGaRR&&gj8Qwq3rn2u`i9^^ zVzE|NYsjjzV{81K^Boe4wM5DN(JEfgym!gRACOppePN^FdiVll~yc`68rMR9U%%OycbEDDofwtN$W#Dbdqx#d6SCO&pC$pVmAr2czu zvR|08qoZ=mW?~V@6eE~HVzHil#aAK*iN$bomG6`&Bo;q6ttn zbGHP==tE+WJ|?Iy0Eva~oA8DiB$oAmrpMWh^e#PhTF8|xv$q8`WsJOz(c1W;t`(4V*$p4>gDZ8%h z3>&P%N?)`SJ#W1ycuCm_YC_m161Jt;!nM4az>UX_98`hYOM8 zv{$ypxDiQ~A=3*tBJDL@oIRgpWi<1h9hZ$tqHE8eiWfc3HNDjWuQk z!3~5p3Ty0&7=Fi09?l_=y08bHIVaK@a6Ktp+#P8ykp_tccSnY6Lql~Z$QmV5ESP%# zxft2aw8QH#Rd8C#@Ya{40>zc#>{s3C*(SCl;;=+9Q=A=XJAz!bH56?%o>6Zg%;aV} z*%~4TZEHnacg*NESk4q?2iw+49QM0Hlfs!Ljc+qc9+zW3l7+;A`yj?WPy5DfmR(Nf zZDn3;(10_Ni%Gl#R1DdZ=4!K~c-iJEx>3#zakg(1z7k*XO)#~+ihU_}@xb;O6z=3y z;#Zi!XqWfx)Aq-#=;b63ZO`B$xEE;ZcFN_tFT@(mnNM*qkROwIIA#{^s@$Gro+h&n zcNN*5%+p}LkcGrzvjNZG$^M(f`}nW=>q>?2b{aGmb*vJ%lm?9jv1n(tja>#S4KO*S z&dw=6&-@Ls=n%3My+1^rTS|< z?)d&dg|Z6?X65G+Ua1#jrzFGABwR#{q=sE&qUY_b%-PY1Q54FKZp^kvz$(2R-ITme zgT{g|%A(jap|K!#?YCn>V?oqqjO&mC!cQg`BHH%D>oXlbA<6<0;AQX$)(E%_+5W>p zN!HgVVITX4XuQURtS_wv&u~U0?N`z|pJ{BxfD;sjr}p&SY*oav{3Uz(F7|H3vcfle z`X06b0^R~+k3n#!XwXm+FEuL9mXKS8&S8PVgM5oTB!#SA85uF40-%cMiVV`f3e{iyJF?=qs%|!5c77$ zD&cnu)WY{M6A`GCZbZHv2_1gx7&hFVc?02@@(1FL9Z3cLgXl$#5L!K+q19l)xG5TH zPdO2i!Es5rq(R@_Y){$45J5DjsUob?>rEK&e1hmRb*h~2({UvC73~Hs^^nF@#lvZp z5*p>o+*R7mdJRiNJMELWQMnqP#=9@7u^%x_JC(AHjK-&Br`2i5BL+l0xXuaB5ic@0 zw|UkK8N}6eP9D#KVT8Dv!71YHW~d?7?0N1R3RBCX|Jw1)tHdym_dhCF@18h?kzMU5 z5b3r$_Isw+_Bk9L-e%ZsWi^MuXUSjid!6RB=ZpZ$_{`k`hiQg1iGyI6Lb zskFU2P~Rmp+%a7X@1o%BXPU;c+AqP{vAQGcfCtn4b!5dhxEwsdc)K|@mgeWgW8nnb3-opU1^Kt zs1(-D{qQE|{aH%8{orK_eqU2q=KJ@s_VmOk!4$aMn_eZ%bdnM@7X0~CylIbdcx3t% z9v*3`ZZVkqj9;cjKWNdLdyijEiLPrgn)?T@M*Ch$(Vn9f$n;X}tkA0s1zEjRoAmVW z{_qFlk{>erdzFxWA?e{{YWf2|E95l1s5gDyk1jiHkH_^m;k`4tsg#{P!Fca1{9$4$ zcR%b_z#D?_72Q;mxhTBG+)%+|@`z%(#rC<0f>q{5fdttwz4d^8X6v@Omj#2&l>$9- zZF;L?O(twbzb#lK|9(sj4ni{UW+}t?W+p|i=N;UETq4s|rgt|O^sM8pX$>crXk1@d zjm65^&QpSCSqe&eYM4h7(5sINjuTHR;fD)KdYckdU!{DvCwfxw{}k*SGO|}P zNmcIMaNLG}Rp6CQqN?7d9qy@24J9vSaL=VfW5HjgasASvvEZ+!aD&sKvEYBwV2q-K zU8i)dm$$vAJ=}RRVdq)R38Sf>?3e@*Ei3J*&hm>4OEH;)6nOZ1YDz5Y0Oej~QN1_g zhnNa2NlZo4N_UFIE=cIrA{cgZ*$IN%wFo-<{K6yR+~rIUhE)X?mU_j_i5;hH9*G3r zF3kumnrsq$u$^FAe5>?i++(@o+x0ybVx!I!Zw53LF(V@7FasKkn2|FqPKbniF$R&| zIUIOslaVQw!#Nx7%m_wabR730<(E3e)r!HIjo5G7KHVyX2fIsM<6emUfU^+cZAt|` z*)7(clY-{kl+@1?!`$P_#FA2qkdm%pP7G))Vxg`S2L?2j|K6Q+UlCh&&XHckz> zvF)l02bL<38(LRgISz4G#D2Bdsrt+vG<;pS$DWjCTjaV0>1m84mvH* zy*Ri0V5+PX57t!tQQm_K^H%x8fV@rRzIK4o06JfMXLQ z!voR218HvF`i2Lig9g@gcF_jiyzi`}UWdlwc9EEJ9U2QPR5ZE|jIi6}Pr5}p|7Uo@ ze)QMO#1*%%&MeojuK2Cp9rDmvbc7$Y;JRhQ{ZfnEB%SfZiDEJ(^@Q68-SbY-mj`ya zeSqbP=t~2a-9G4jaf-e+AmRou405zkpY767Lu6IJCdIT)iL8dZ^{t2_0}p=2vvhjy zDHV~6mHxlO6XF4`TWY>LUESN6dpz}xJ5fH*jh;h}NQH+rQ-gFq5-m;+9k4KgSqj*r z7&&NRK5K>FGaGkZ!rf3V&E4=|tLf~H2CLcB>w50Ba@Fp&2V2c%+vIn?elVU*_Dgl% zJOR=9;K*$rFJ#}AU#_6IhB$Grrpma5pmw=Y3&;Vf&{%XX-sf%WKHso?_JNL`jzU?* zhW`DVZm9i^CbRQ82EGrX+^*)lRPc6$qm&gVL`6CrrL@Z(956k7Qyq2cfwtRqoho*b z{AG7)5qlT+N~)UMMgbchkV`$~wo%A7=Uz_T0Bz zOFLofbgZ(>0Hwb2c7scg?GCK2^dN=Oqp<_4vv8&+zu{_+aJg^Ke&wtIN)thAxAa&@xA08h&9dku#q!fhN0pBU1ZuoJLon$2OL;^#;7nlt zRE=anKux$yPo&A6d@eP7Uyp=|_jQ=2KiK1B(mXo8k93o}lJ4nGcO%_s@Z0ZCKTgWy zzD>Wq81 zo=tiKI}*O-1=puCB=bz*Wl|=@LEf33zsUQ0ZYc+xE;cBD|8A@De9Cuals~B;Jm*+3 z{BQ3o=cmjnd-{`Zh2J=KJKVYFiSnD%l?~QiNs=liA#z0~A^mWH^0fQ4xSOm1^vF9Y4amabQP<@?*(Xo~3P0+0Y?{kN)FDQ|~09v6yURPxVSd zV=>vtoq8h)jm2am$M;kcG#2HbBOKSHYmW;%EP{U@XgxIojm1J{DEiPyy#43m3lZ4d zRd}3tq$?7evwGmLdBF4Hza!0Lr6SD+qK}L~W3k8@4ku+oW3g}<3U|xwVb5S5%mn66 zA7Pm~JjM*ey@)|%(*VoTL4{@38)V@!8lFTjad?Iam?i8A$cT)%Q?yDihQ<=Hd1X=z zjU~dn@bQ%qX?A0A{ybfM{sz0MST$08{ttFx@te7&>yIC|7&_!*PDa8`R^-<{mWczb zVmXvxu0(!C{uBA@3}kEgmCR0y^L==`iGt}0jBTVO(tKX&&h*Ve`Ao{_b{O|1;u`;1%-acN6aH#P$m&0 zLl%1TA)Uo=buw(>IyBn4b)HcS58xI%MHmjZ67@%0)!}%gnz>LM98o*mYUq&hw}siv zc!6Kuc(I>T=FwaUA z3P&kbJgwdjn2&Qj7i!6LGG@;l@8Cx9bUvnij_15_XF3bB9&dD)oqcE%cVwEaajW_FF787NNHa zgzAnzg@TLSITLa73Rb5`hd7Kllmh)2$&K@Jb9O>DUx7}aR1ks}VJa*glZBm%H}dpm zp9gW!ScKZ-KOKizPw!HP*gHb-l0u;$@}EwWmV7$pvo{tV5rO*?Ny9MPSZFN#<_b#3 zeF|DyJ2?DL<>?+1M>%V8m*na06CRu|ao^I+G==)v*S=W1YPc z*0}wO)W*rmIM;tf?n=R2XXbP5Tf6iM3@Q6#sppiXEk zoeDypiX_dWD3W{Fxy}nhXKRe=%Q|}ap|S9v5T|=go@;p0u}kQK0S6w{p8SVjO@7?) zqCBs@V}u_Xi^P&H=U^-}mQGiRqvEGzv_sUAJ(W zzPi4WLb}9N&D^-4&YHc3FANXKYfBvIHWyk`mD z4UMH@=85L68_-zvSoiJT$ib|q+-}FO`p{SmSr69G0Tu2#w`t z%R}av95fcqr2Llqn~f#+X+Hh#W@E{{luv)K*;sPFvGn&kT6;rd zX`IQ^bhxqESWc3ODGi#?STye#a)~L>STye#acxqdvB(+SptNo_md%Ti=g?RlGF3FS z@}aTZEI7I{oC}R5*TiW=*WyI|OmS|c6EqelL+#djXe=!=xw%eG&{&*mwObpZv9!$; z<_0^}>Oo^kkQN64jPN*2OaMD6lg4R%lW)gXe@W(jO5}?Xe=bMXNs#M zG#1CJ#~a`^-8`Xe{}>yUZ7I&{!NdPO?kn{=K;~wz}qU z^}s(>@U{8SY^(?N$Siynx^bb(>fR=AJ+R)h2oE63QLnmzA0F^)s5<1x>|qc1XnD9Y zuA5oC`QxIn{b;zG0#p`{VmJFdUHIl)9eC7!6|O~YdNfs)Ur+$y>bg|3zv_Zoj6HWUeaOT6_~~_BFm4r{KA=|xZt*zXt9y7Bei!N1 zJ!*8n0iQ1(Q4h<572sz^_qQXg$ElE76s}Z#I$^(u)t<`dAz4GtZh4W~=`nF=ler4! z9{8qIpo?x2texC|Uq@B+=L5T{Ha}u!-+O#;pM@VA-Q~KKSY4h*b$r&( z!`gcmz7^eYJ!(<)OS&HE56K}4pcmacwd`BE@Egg4OI0vB!i7(nZYK{qsT+QBbiJ$D zf9pbU@t_~>p3#Lb(H_L=m0?}@V&pMW6LIv$W1;F|_t^n?VrbuQ&%Kkh>}J9c(S(gX(C6J^7s1MB&wy@i6iwkj!kV>Phs2>&(k3qx@i+18sA{J z+Mi7flCSV6aG_QhKW9jao1_xOP4xQ8w^sL6Y<(7o5w}KJD9pHJpV)`Z@!V%E^j$$- zR!D(bR+=5hD5u4hi>K;n8#-!hKP~qucoxVyz*XsBco2? zsz#M|O;vp%W1&2WQ7B$kf3xyYeI}z#d@%)%ShRUZ_t~-z?DG?HmN!)xmN)erv)Sjw za@-dzbWXlW;j?^`=h(h|4y=Rw0)$S=M=89QkMiW)W-QywB<@yNa~nUgQOa>h+@rJM zwNd`R4p5Y8!f3zlPNu}KdGLxDAOB6>BcFcA*sW6=f4oyk$WH;jgDVgZaUR6AGe3&| zJZyZpa~s~PQ(nkjfrxyiFm%Y+y;C25q7#!CsQ{lv3WkSxb&SL~ag+|JChY(2k$BQz zT}OxXC@kYxb=Ymj-{R)93~_UviJGvqxRyua%{t>SB{Tle=hrLNJvwfjDu#|m5LCRi3A;ZJ;Fud8< zokg;jP%yC9Q+VXjbeMIt$(`kGFQTAozg^+BN7P}KN0dA3WcMZAcGT`8Ye)WcIvvW5 zA5io7d2c0vn>JvryIutk=2c@#BT5JMk?RL=y2(`-t)%J=kJ(V&YyYbKJOno-2Ndoy z0~P#^qa1F@Xka}ylpp8;W0BrA@azG2Qb*P zb?qDc9I_rT+n?}J+alSYT{nR=Aj6?xoW(E{47s1kREO_VC*BLxgMu1n%02BKEnwfnNd3(+G9y4IDn-zh#B;bNv*zw>eq+`~8Y zWbM4Fo*PK4!r$tdQBUl-j&={)ICAfG!G6Ev8GkVY(654rO7VC5?%^LN>7yG{L(q-E zePvUTIqtTGQms2@5YanlUS*%Mklw0U`IPZhd4sK)SYV9i4WIymJmdNHu3y5UY`U0G~W z=uT7l3{%tBV|KRgETV0sl!0lJ{3Fw**JJx_Pq18UFH5PKM#;l@$?GwDTThm=?Io#? zK^xv*$Hv|Lj53~g%b>6Q&dcj5={7>I2QF1Nlzgg#9hO+MNJ=LP8*M=)TEF*iE?>6VeQhR%M^dIOH#^Y z=aAgvokJ{w=QJD=P4j2`dzPeK8NN9_0Z>j zmEn0k!|11hw0Bj$MML|Ub15^^k|OVIyCQ~o-@MywPSIh+~nbizhz#UyrugB@&2lN&hY^B?Vt-4$dbQ^ zbtds6>FRkSLza!7`g9xr>Z{dA&K$LOQEiQyd7a}h^GA-W!&OxwyM1t`pndOdy>|KC z%1p9lYMPv-dbSN&5Pr>iwooT{hns-Cf8+Nv0Ph(Y3K#Q zz3KW)4R&RwpJnDE0q3$nxIf*LX~M1RffGf4GnKYEeiEN~AWOtdDZj(V1`ZDFgpn#6!kYvS9fXEr+=be(m01;sml|C{+#;9|rw5eugE>y|01@Fql^P#_h<|-!XPp#4M5*R%ePJg+ zq_a@i7a(%3KC`n;7$72yR^q+hYs>1}>nGqW2@sJqH6LT_bz%+d4Hh^j2@sKNG9T;Q z>%i*Y8z68}5+EWOWzM_2!lTMop#YIUPHyL*FhE4OPMLllAQHs6+4)WwAR@f1Ob-Q!1afjZdxZfa z!X?Vo^8k^c$s4h6gaIOa-7#kYBC$_};jE-yl5XOo5|*$zdGaB~h+m*ARz_G|13T_d z;?EOv28i4uhOGGI0YtR&3W;X`BECEB_aD&$h&Wf^Z@u;hi1dHeGARIv+!_i|PfG!a zq%3Jg6aYj_a|Z3sBLO1F@5C8%fQTtKF~vp;AflC8sC@@aw!6c6j}wW(E9-*{Z3j&MF5dP`k9rset<~-39Zl~fJh-dVC6+W zK&0P6ORWeXQb;|s(wYJgN%7S3E&_;X$s?=8oIh!OC^RM(Fm`Z963zic#73EykuOAv z30l?#v>}R5TDX|LRue$PAK%cOWdIO4Mm&qZ)eR8ozOLx*1rTX2=pi3Z1BfWTIx*w} z5b?)9PSjTfh$uFm=<@}Lys|NrXf*(c7|cA*{%FH@c#MHk6!!v%9Me8qR*(n~Nz7Gr z^wK^D5b17IY;OXH1T@gQ#T5Y}ih3tD-m(EA-BpU!UI39}H9-iNK6wj^CpEzUkx*DO z2{izSz;?+P^S_fN2KoRI{if!z9-9-ak_$#te z8bIXNtwT3JL~;GtQZPUyG(4s|RuLegn0yR#79et->zUT>wF!|fhNy&w0YJncy}|f3 z1J2ACf)dw`14PbEslksXK*WI9VEhNe6#t$fDPdv&5HT2PAiQD2Uq$L{Zv{5CRZ6J5`W4tq2fNbnzmb1Be83i@R490V0Yu-(C0YrwGW_y~yryL-gJRJ5n1BjTpza^dq zh`c?6E($sa5c!iBY7##T5E&jaYa9oN{MmP2BRK;gqS6{N(+m)Kk~6yhstQ0v<Zqsnf4zt0x8!zVoBEu_YdgB0*KWjo(gNpznX4P+N&HzMw zA6Gb!14Q1{_&u&228d(`o4t4f5NTwM??~53Gl0nWlHcRHVSvamypH%SK;#{U99cOG z5E(vo?&q0b5K++xNpAv(G~;`Ej;R1dRFEMXL7NcCxE4Ze0*Ex@yL*nP07T#qIYUi& zr=ezi?;NQJAW|d|@-rA9GHh>#`hOcD0Fhx2GtYMbk+-CP$mhcVkzr>u^LGF0ElGxnPt8Mh`c47o^Hwjhzv)XjlKhjyruiE zHVy+shJ(%O-T_43(oe584+BJoFPkmD1Bkq(`mZ(&14M=c%u3z?MBY+PPd~{hp!nG~ zl)W8GI6wVJsw+uHUu8LD+zd1ImJ>pMI+fP3KX5ueqc2nBB0$8~CK(_ijoh^{zF9=N z?n&oa07MAHzl?8m0Ys96FclX7B6G&iyCkInBGM+i`q%)GxvkIQG134L)tQLwcThy$ z?6Vg6t_l!QrB0P*#{)#-%cWB-03rnKze=yizm%RHAm}e{E?uNVNDuC+nFNT;)Hin3 zsRBd@H4F8HT>z1;Lg^`h$mjaZt~P0ah%}nOdksaTZ=autGX@}nF}*a#fFd%mFIeOp z1|WiIx-`}aMWlaUfXGP9tsb*+=wiy2c5c$g|KmNTmKty`YVtg4O@@Xl05c!L9v+JESKty`kg1!t8`NYZT>XinFNS9bpzW_x3 zn!FMJMj9X@&>gz~5Q%>(Eh$n_kD*8U>MBBtWE< zxU}Mz4-hfTYa`A9M5cD!A3S0R5II>9e(UvS5gGhyXwm`@X&qWpPfG)cq%9dnv;ah+ zat7_sqW~hP@1&Va0FfweVw#O1K*TV$O?wU?GF5&r&CSs9S-ReIW6hw^Nq|VJ{&Hj7 zAV6erz_9%yK!n{`HF(w#AYvHYmM{nq8MHK9Yy*fq3!G%1KmkNh87ED{0V0vC33~|? zKm_&ZWK%dmB$D;PUIYaYf#dk7aDYf8>wWhnLx2crE$Yv~%_1_WcJk-UCPW6U4cFTM zBF`|B5v79wkwKhcavMP8*~TBUp@y3f34;@m11Nw9%8!(O0U&Y--`QPa2oQP3>+QBf z0Yp&lB;o~t$R&JNHxUI8K}C{AE&xO>wRX(58=}P9NHY-)|1%Z>5NRXLMm!k=hzwpZ zeDe$-(l#*@v3b|QZf+Z&BR@+6h@}16?9f~5Fj#m!Z7q1K%|X6zw%-bATsD+sP+sX(ng(I zX-xx&q8KLdyu%A=|zoMF18&6rfch~SPSeg=q0jCNl}y$~fO7+SZ`CMZ5x;bK-= zUjZUB_=euB-2f2^aRGm;7a-Dm9qS$q5Lqke@jIRc5W&8>JTwUqnZZ9!*2e-wu#K1d zrZypBYbevY8z8cKW;OdG6p^tm6jnSMAVSezC@V+?h$QD?9iz2B14Mcoe@$9w&o|I} z#jyYptls5~x0^+zw+dSw4G^K!{Dr^*M6ipLnni%fa#?J0=x%_BmFe0T6N<=?ZKRBW z6+pzQX>F_ripYrVWf@f~fQVJp+E_Ofkzw0QG9RM>BAoG8enwdU5$v_Eyu4n32zH&a zvP7-E@A;9*wASDXMo5e_fGFR79fIE zi>59CL>9QWdgrkK5v+GK=mjqn_howDlYexYhS;E#Y{sxGw zu*MybY5)E$U24{Svd+289jC7=iD!dsA*8szXC+o@IAfoT5Bdn z4N2YjYZD?_*Qms=0FgC(ckdB3fQZ_!6Aq`LHGJ-2WdX?`6xhS)Y;m6eS!@T$vS750FfWmnbn3-fXHZob;&wFYxSc9%V-my@=zoU>30T5BG zcj;*31BmdU1$kyrM6~x#Z*k@ai13@rjHyEr(cQba5bVV1Q3y{ckOt=2StQWL=d9{MFbOeprecriU{8|Dc*^W zO^EQPiyH5MB4XK5u*FXRAR<5%E01EZ*3@MQ`SumBO|$s;kZ_y8h&qe50{01+jQ zTgMit_D07Z>yyF9i@GT3`)c_(&oWmWxd;k%?5+N!UAfi0!5%Y$R%y!sn&i*Jk!U-?!n!JibDEoKW4NhD%crn3Pe zxV$8yB0vPO<8*?p0X zw)-Ia-DXAxAR@`Nr`g~DBDmBfZAE|xqTHY6hI33#*F!dj^cmR#L=yGY8g2Sg%ia10 zaP86n5xK^*eP?k15nOPRUElHYi+z^3#Uy}8a-b~xovf7oUD*selkEL ziKGy5p>HSoT;B!Un`D4U(u90OWS;?!-JCS8NWM%{B?r(>;w~mb5lI?Hk+0DN*giB{ zoOCikB#EHNrqGaVf0{eaB^e-+WQAIx_DQhGeNH%|WPnH#U2)~NJ{9(vz7x1mxLNs< zL`SV$?Gs`9_Br6xk^v$~RK=BO8j5|I=85x828iIU%bpc={)GFGWNcHw5a${us4@`e zMU9y2vM)q!5^&ZDGzMjo7A~f)l@1V*$A>esGyo!YL^R%uIiqgRypC|U2Z&@AXp!I2 z03wK24nwj45qW%Mf<6Kuf@pN;LjXifY~W-?10bR?la{>)iij}-g%Gy~h}dbP%Z??m z%k2_!5svoSs`y$Wvk}pr4n+jjKxK*}03rxIhYd?8B96=|M72FY#I8mefdGiW4M~j( zKt!!nSOh=>k!*)S14OXgH?(&9O^9ePXrdY# z01=J!6k{_eBG!xq(QEqwBC1m*qVVz+xjYSGit$b;BD)#sq9z&u5sje~f;kkCJ?uD` z(jaLog&$_Zl?LrTBHx~b1&AnzdobZjgZ2dR#-5}G5K#(uXAUEt+QEYWz9$ksBLE_Z zi}vHH01*}6Qwjed03rx!djbX^f}T2-FpU6+AYAMTssIrcE{VAcLn~@oB%Njg&n(Tg_EH0I!_Pi||m-PbSyaoOpw0E(qwegAjKUj-30RR91 literal 0 HcmV?d00001 diff --git a/tests/image_probe.py b/tests/image_probe.py new file mode 100644 index 00000000..0a96d179 --- /dev/null +++ b/tests/image_probe.py @@ -0,0 +1,26 @@ +"""Read JPEG SOF dimensions without external libraries; not a full image decoder.""" +from client import Failure, check + +def jpeg_size(data): + check(data[:2]==b'\xff\xd8','thumbnail is not JPEG') + i = 2 + sof = {0xc0,0xc1,0xc2,0xc3,0xc5,0xc6,0xc7,0xc9,0xca,0xcb,0xcd,0xce,0xcf} + while i < len(data): + check(data[i]==0xff,'invalid JPEG marker') + while i=2 and i+length<=len(data),'invalid JPEG segment length') + if marker in sof: + check(length>=8,'invalid JPEG SOF') + return (int.from_bytes(data[i+5:i+7],'big'),int.from_bytes(data[i+3:i+5],'big')) + i += length + raise Failure('JPEG dimensions not found') diff --git a/tests/load.py b/tests/load.py new file mode 100644 index 00000000..ad81d596 --- /dev/null +++ b/tests/load.py @@ -0,0 +1,58 @@ +#!/usr/bin/env python3 +"""Small closed-loop HTTP write benchmark; not an open-loop capacity proof.""" +from concurrent.futures import ThreadPoolExecutor +import json +import math +from pathlib import Path +import threading +import time +from client import Client, Failure, LAB, arguments, check, run + + +def main(): + def configure(p): + p.add_argument('--duration',type=float,default=30) + p.add_argument('--concurrency',type=int,default=4) + p.add_argument('--output',default=None,help='Optional JSON metrics, no session tokens') + args = arguments('Synthetic POST message load, closed loop; creates users/messages',configure) + check(1<=args.duration<=3600,'duration must be 1..3600 seconds') + check(1<=args.concurrency<=128,'concurrency must be 1..128') + c = Client(args.base_url,args.ca_file) + alice,bob,eve,chat = c.bootstrap() + barrier = threading.Barrier(args.concurrency) + def worker(worker_id): + local = Client(args.base_url,args.ca_file,timeout=5) + barrier.wait() + deadline = time.monotonic()+args.duration + latencies,errors = [],0 + index = 0 + while time.monotonic()=2,'persistence requires lab2+') + check(args.mode!='failover' or LAB>=3,'failover requires lab3+') + script = Path(args.action_script).expanduser().resolve() + check(script.is_file() and os.access(script,os.X_OK),'action script must exist and be executable (chmod +x)') + check('.example.' not in script.name,'copy and implement the example hook first') + c = Client(args.base_url,args.ca_file,timeout=2) + alice,bob,eve,chat = c.bootstrap() + sent = c.message(alice,chat,'Сохранить при отказе') + original = sent['json'] + target = sent['headers'].get('X-Instance-Id','') + attachment = content = None + if LAB>=4: + attachment,content = c.attachment(alice,chat) + if LAB>=5: + attachment = c.wait_ready(alice,attachment) + env = dict(os.environ) + env['TARGET_INSTANCE_ID'] = target + observed = set() + if args.mode=='failover': + for _ in range(40): + observed.add(c.call('GET','/api/v1/users/me',actor=alice,schema='User')['headers']['X-Instance-Id']) + check(len(observed)>=2,'less than two API instances observed before failure; verify LB/session affinity') + print('Executing explicit '+args.mode+' hook; hook output suppressed to avoid leaking secrets.') + # No shell interpolation and no Docker commands in this test. + proc = subprocess.Popen([str(script)],env=env,stdout=subprocess.DEVNULL,stderr=subprocess.DEVNULL) + started = time.monotonic() + successes,failures,after_instances = [],0,[] + try: + if args.mode=='persistence': + try: + code = proc.wait(timeout=90) + except subprocess.TimeoutExpired: + raise Failure('restart hook exceeded 90 seconds') from None + check(code==0,'restart hook failed (inspect your script locally)') + deadline = time.monotonic()+90 + while True: + try: + c.call('GET','/health/ready',schema='Health') + c.call('GET','/api/v1/users/me',actor=alice,schema='User') + break + except Failure: + check(time.monotonic()=5,'too few successful writes after stop') + check(target not in after_instances[-5:],'target replica still serves requests; hook must leave it stopped') + print(json.dumps({'observed_instances_before':len(observed),'successful_writes':len(successes),'failed_attempts':failures,'first_recovery_seconds':round(first_recovery,3)},ensure_ascii=False)) + # Existing token, no re-login. Read all confirmations and reject duplicates. + messages = history(c,bob,chat) + ids = [m['id'] for m in messages] + check(len(ids)==len(set(ids)),'duplicated message IDs in history') + check(any(m==original for m in messages),'confirmed pre-failure message lost or altered') + for msg in successes: + check(any(m==msg for m in messages),'confirmed in-flight message lost or altered') + # Bodies are unique in this scenario: an uncertain request may exist once, never twice. + texts = [m['text'] for m in messages] + check(len(texts)==len(set(texts)),'uncertain retry created duplicate message') + if attachment: + c.call('GET','/api/v1/attachments/'+attachment['id'],actor=bob,schema='Attachment') + downloaded = c.call('GET','/api/v1/attachments/'+attachment['id']+'/content',actor=bob) + check(downloaded['bytes']==content,'attachment lost or changed across failure') + print('PASS: '+args.mode+' preserved confirmed data and existing session. Hook scope needs operator evidence.') + finally: + if proc.poll() is None: + proc.terminate() + try: + proc.wait(timeout=5) + except subprocess.TimeoutExpired: + proc.kill() + proc.wait() + +if __name__=='__main__': + run(main) diff --git a/tests/smoke.py b/tests/smoke.py new file mode 100644 index 00000000..4cbfa558 --- /dev/null +++ b/tests/smoke.py @@ -0,0 +1,82 @@ +#!/usr/bin/env python3 +"""One complete public acceptance scenario, cumulative by lab number.""" +import base64 +import hashlib +import uuid +from client import Client, LAB, arguments, check, run, timestamp + + +def main(): + args = arguments('Messenger public smoke; creates synthetic users and messages') + c = Client(args.base_url,args.ca_file) + alice,bob,eve,chat = c.bootstrap() + path = '/api/v1/chats/'+chat['id'] + c.call('POST','/api/v1/users',409,body=alice['registration']) + c.call('GET','/api/v1/users/me',401) + c.call('GET',path,404,actor=eve) + me = c.call('GET','/api/v1/users/me',actor=alice,schema='User')['json'] + check(me==alice['user'],'current user mismatch') + listed = c.call('GET','/api/v1/chats?limit=100',actor=bob,schema='ChatPage')['json'] + check(any(x['id']==chat['id'] for x in listed['items']),'member cannot list chat') + hidden = c.call('GET','/api/v1/chats?limit=100',actor=eve,schema='ChatPage')['json'] + check(all(x['id']!=chat['id'] for x in hidden['items']),'chat leaks to outsider') + key = uuid.uuid4().hex + first = c.message(alice,chat,'Привет, мир 👋',key=key)['json'] + second = c.message(bob,chat,'Сообщение Боба')['json'] + check(first['sender_id']==alice['id'] and second['sender_id']==bob['id'],'sender was not derived from actor') + check(first['chat_id']==second['chat_id']==chat['id'],'wrong chat in message') + check(first['text']=='Привет, мир 👋' and second['text']=='Сообщение Боба','message text changed') + page1 = c.call('GET',path+'/messages?limit=1',actor=bob,schema='MessagePage')['json'] + check(len(page1['items'])==1 and page1['next_cursor'],'first page must have one item and cursor') + from urllib.parse import quote + page2 = c.call('GET',path+'/messages?limit=1&cursor='+quote(page1['next_cursor'],safe=''),actor=alice,schema='MessagePage')['json'] + check(len(page2['items'])==1 and page2['next_cursor'] is None,'second page must finish history') + ordered = sorted([first,second],key=lambda x:(timestamp(x['created_at']),uuid.UUID(x['id']).int)) + check(page1['items']+page2['items']==ordered,'pagination lost, duplicated or reordered a message') + h = {'Idempotency-Key':uuid.uuid4().hex} if LAB>=3 else {} + c.call('POST',path+'/messages',400,actor=alice,body={'text':''},headers=h) + c.call('POST',path+'/messages',404,actor=eve,body={'text':'чужое'},headers=h) + c.call('GET',path+'/messages?limit=0',400,actor=alice) + if LAB>=2: + bad = base64.b64encode((alice['registration']['username']+':wrong-password').encode()).decode() + c.call('POST','/api/v1/auth/sessions',401,headers={'Authorization':'Basic '+bad}) + good = base64.b64encode((alice['registration']['username']+':'+alice['registration']['password']).encode()).decode() + c.call('GET','/api/v1/users/me',401,headers={'Authorization':'Basic '+good}) + c.call('GET','/api/v1/users/me',401,headers={'X-User-Id':alice['id']}) + me = c.call('GET','/api/v1/users/me',actor=alice,headers={'X-User-Id':eve['id']},schema='User')['json'] + check(me['id']==alice['id'],'X-User-Id overrode bearer identity') + if LAB>=3: + replay = c.message(alice,chat,first['text'],key=key)['json'] + check(replay==first,'idempotency replay differs') + c.call('POST',path+'/messages',409,actor=alice,body={'text':'другой body'},headers={'Idempotency-Key':key}) + c.call('POST',path+'/messages',400,actor=alice,body={'text':'без ключа'}) + if LAB>=4: + att,content = c.attachment(alice,chat) + # A queued attachment must already be linkable to its own chat. + attached = c.message(alice,chat,'',attachments=[att['id']])['json'] + check(attached['attachment_ids']==[att['id']],'message lost attachment') + ready = c.wait_ready(bob,att) if LAB>=5 else att + check(ready['error_code'] is None,'ready attachment has an error') + download = c.call('GET','/api/v1/attachments/'+att['id']+'/content',actor=bob) + check(download['bytes']==content,'download differs from original') + check(download['headers'].get_content_type()=='image/png','original content type mismatch') + for suffix in ('','/content'): + c.call('GET','/api/v1/attachments/'+att['id']+suffix,404,actor=eve) + if LAB>=5: + variants = [x for x in ready['variants'] if x['name']=='thumbnail'] + check(len(variants)==1,'expected exactly one thumbnail') + v = variants[0] + check((v['width'],v['height'])==(256,160),'thumbnail metadata has wrong dimensions') + thumb = c.call('GET','/api/v1/attachments/'+att['id']+'/content?variant=thumbnail',actor=bob) + check(thumb['headers'].get_content_type()=='image/jpeg','thumbnail content type mismatch') + check(len(thumb['bytes'])==v['size_bytes'] and hashlib.sha256(thumb['bytes']).hexdigest()==v['sha256'],'thumbnail checksum mismatch') + from image_probe import jpeg_size + check(jpeg_size(thumb['bytes'])==(256,160),'actual JPEG dimensions mismatch') + if LAB>=2: + c.call('DELETE','/api/v1/auth/sessions/current',204,actor=alice) + c.call('GET','/api/v1/users/me',401,actor=alice) + c.call('DELETE','/api/v1/auth/sessions/current',401,actor=alice) + print('PASS: lab%d public API scenario; infrastructure and grading evidence remain separate.' % LAB) + +if __name__=='__main__': + run(main) -- 2.54.0 From 1210dd899c33dbf09517ecb3ef500e46d64f8334 Mon Sep 17 00:00:00 2001 From: Artyom Date: Thu, 29 Oct 2026 00:32:37 +0300 Subject: [PATCH 02/52] Carry over the agent context and openspec history from lab 4 Bring the Claude Code settings, the lint hook, the opsx commands and skills, the architecture notes, the lab 1 to lab 4 specs and the archived lab 1 to lab 4 changes into the lab 5 skeleton, so lab 5 continues the same spec history instead of starting from scratch. The files come from the lab 4 solution commit d2744bc. Rewrite AGENTS.md and the openspec context and rules for lab 5: upload answers 202 queued after the original is in a private staging prefix and the attachment, the job and the outbox row are committed in one transaction, a separate relay publishes the outbox to RabbitMQ with publisher confirms, a separate worker built from the same image consumes the queue through FastStream with a manual ack after the result commit, PostgreSQL stays the source of truth for job states, Out of scope moves to labs 6-7, track 1 and broker HA, and the rules add the failure windows between PostgreSQL and the broker, the effect key and the lease to specs and designs. Co-Authored-By: Claude Opus 5.5 (1M context) --- .claude/commands/opsx/apply.md | 181 +++++++++ .claude/commands/opsx/archive.md | 225 +++++++++++ .claude/commands/opsx/explore.md | 193 ++++++++++ .claude/commands/opsx/propose.md | 145 ++++++++ .claude/commands/opsx/sync.md | 258 +++++++++++++ .claude/commands/opsx/update.md | 87 +++++ .claude/hooks/lint-python.sh | 45 +++ .claude/settings.json | 17 + .claude/skills/openspec-apply-change/SKILL.md | 185 ++++++++++ .../skills/openspec-archive-change/SKILL.md | 182 +++++++++ .claude/skills/openspec-explore/SKILL.md | 308 ++++++++++++++++ .claude/skills/openspec-propose/SKILL.md | 149 ++++++++ .claude/skills/openspec-sync-specs/SKILL.md | 262 +++++++++++++ .../skills/openspec-update-change/SKILL.md | 91 +++++ .gitignore | 8 + AGENTS.md | 61 +++ .../.openspec.yaml | 4 + .../2026-09-29-add-lab1-messenger/design.md | 177 +++++++++ .../2026-09-29-add-lab1-messenger/proposal.md | 38 ++ .../specs/lab1-event-publication/spec.md | 102 +++++ .../specs/lab1-inmemory-capacity/spec.md | 60 +++ .../specs/lab1-messenger-chats/spec.md | 85 +++++ .../specs/lab1-messenger-history/spec.md | 106 ++++++ .../specs/lab1-messenger-identity/spec.md | 84 +++++ .../specs/lab1-service-operability/spec.md | 164 ++++++++ .../2026-09-29-add-lab1-messenger/tasks.md | 94 +++++ .../.openspec.yaml | 5 + .../design.md | 66 ++++ .../proposal.md | 37 ++ .../tasks.md | 47 +++ .../.openspec.yaml | 5 + .../design.md | 104 ++++++ .../proposal.md | 39 ++ .../specs/lab1-event-publication/spec.md | 48 +++ .../specs/lab1-inmemory-capacity/spec.md | 16 + .../specs/lab1-messenger-chats/spec.md | 32 ++ .../specs/lab1-messenger-history/spec.md | 21 ++ .../specs/lab1-messenger-identity/spec.md | 58 +++ .../specs/lab1-service-operability/spec.md | 56 +++ .../specs/lab2-auth-sessions/spec.md | 123 ++++++ .../specs/lab2-persistent-storage/spec.md | 76 ++++ .../tasks.md | 52 +++ .../.openspec.yaml | 4 + .../design.md | 62 ++++ .../proposal.md | 34 ++ .../specs/lab2-dependency-failures/spec.md | 37 ++ .../specs/lab2-history-index/spec.md | 24 ++ .../specs/lab2-session-cache/spec.md | 56 +++ .../tasks.md | 38 ++ .../.openspec.yaml | 4 + .../design.md | 83 +++++ .../proposal.md | 34 ++ .../specs/lab1-service-operability/spec.md | 21 ++ .../specs/lab2-dependency-failures/spec.md | 21 ++ .../specs/lab3-failover-operations/spec.md | 85 +++++ .../tasks.md | 35 ++ .../.openspec.yaml | 4 + .../design.md | 102 +++++ .../proposal.md | 33 ++ .../specs/lab1-messenger-history/spec.md | 43 +++ .../specs/lab1-service-operability/spec.md | 64 ++++ .../specs/lab2-persistent-storage/spec.md | 58 +++ .../specs/lab3-idempotent-messages/spec.md | 81 ++++ .../specs/lab3-load-balancing/spec.md | 84 +++++ .../tasks.md | 43 +++ .../.openspec.yaml | 4 + .../design.md | 155 ++++++++ .../proposal.md | 36 ++ .../specs/lab1-messenger-history/spec.md | 108 ++++++ .../specs/lab2-persistent-storage/spec.md | 34 ++ .../specs/lab3-idempotent-messages/spec.md | 40 ++ .../specs/lab3-load-balancing/spec.md | 10 + .../specs/lab4-attachments/spec.md | 153 ++++++++ .../specs/lab4-object-storage/spec.md | 47 +++ .../tasks.md | 56 +++ .../.openspec.yaml | 4 + .../design.md | 103 ++++++ .../proposal.md | 32 ++ .../specs/lab4-attachments/spec.md | 15 + .../specs/lab4-object-storage/spec.md | 39 ++ .../specs/lab4-upload-resilience/spec.md | 80 ++++ .../tasks.md | 40 ++ openspec/config.yaml | 180 +++++++++ .../notes/architecture-patterns-python.md | 349 ++++++++++++++++++ openspec/specs/lab1-event-publication/spec.md | 102 +++++ openspec/specs/lab1-messenger-chats/spec.md | 85 +++++ openspec/specs/lab1-messenger-history/spec.md | 141 +++++++ .../specs/lab1-messenger-identity/spec.md | 50 +++ .../specs/lab1-service-operability/spec.md | 175 +++++++++ openspec/specs/lab2-auth-sessions/spec.md | 123 ++++++ .../specs/lab2-dependency-failures/spec.md | 43 +++ openspec/specs/lab2-history-index/spec.md | 24 ++ .../specs/lab2-persistent-storage/spec.md | 86 +++++ openspec/specs/lab2-session-cache/spec.md | 56 +++ .../specs/lab3-failover-operations/spec.md | 85 +++++ .../specs/lab3-idempotent-messages/spec.md | 91 +++++ openspec/specs/lab3-load-balancing/spec.md | 84 +++++ openspec/specs/lab4-attachments/spec.md | 153 ++++++++ openspec/specs/lab4-object-storage/spec.md | 52 +++ openspec/specs/lab4-upload-resilience/spec.md | 80 ++++ 100 files changed, 8061 insertions(+) create mode 100644 .claude/commands/opsx/apply.md create mode 100644 .claude/commands/opsx/archive.md create mode 100644 .claude/commands/opsx/explore.md create mode 100644 .claude/commands/opsx/propose.md create mode 100644 .claude/commands/opsx/sync.md create mode 100644 .claude/commands/opsx/update.md create mode 100755 .claude/hooks/lint-python.sh create mode 100644 .claude/settings.json create mode 100644 .claude/skills/openspec-apply-change/SKILL.md create mode 100644 .claude/skills/openspec-archive-change/SKILL.md create mode 100644 .claude/skills/openspec-explore/SKILL.md create mode 100644 .claude/skills/openspec-propose/SKILL.md create mode 100644 .claude/skills/openspec-sync-specs/SKILL.md create mode 100644 .claude/skills/openspec-update-change/SKILL.md create mode 100644 AGENTS.md create mode 100644 openspec/changes/archive/2026-09-29-add-lab1-messenger/.openspec.yaml create mode 100644 openspec/changes/archive/2026-09-29-add-lab1-messenger/design.md create mode 100644 openspec/changes/archive/2026-09-29-add-lab1-messenger/proposal.md create mode 100644 openspec/changes/archive/2026-09-29-add-lab1-messenger/specs/lab1-event-publication/spec.md create mode 100644 openspec/changes/archive/2026-09-29-add-lab1-messenger/specs/lab1-inmemory-capacity/spec.md create mode 100644 openspec/changes/archive/2026-09-29-add-lab1-messenger/specs/lab1-messenger-chats/spec.md create mode 100644 openspec/changes/archive/2026-09-29-add-lab1-messenger/specs/lab1-messenger-history/spec.md create mode 100644 openspec/changes/archive/2026-09-29-add-lab1-messenger/specs/lab1-messenger-identity/spec.md create mode 100644 openspec/changes/archive/2026-09-29-add-lab1-messenger/specs/lab1-service-operability/spec.md create mode 100644 openspec/changes/archive/2026-09-29-add-lab1-messenger/tasks.md create mode 100644 openspec/changes/archive/2026-10-12-typed-boundary-schemas/.openspec.yaml create mode 100644 openspec/changes/archive/2026-10-12-typed-boundary-schemas/design.md create mode 100644 openspec/changes/archive/2026-10-12-typed-boundary-schemas/proposal.md create mode 100644 openspec/changes/archive/2026-10-12-typed-boundary-schemas/tasks.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/.openspec.yaml create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/design.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/proposal.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/specs/lab1-event-publication/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/specs/lab1-inmemory-capacity/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/specs/lab1-messenger-chats/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/specs/lab1-messenger-history/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/specs/lab1-messenger-identity/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/specs/lab1-service-operability/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/specs/lab2-auth-sessions/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/specs/lab2-persistent-storage/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-postgres-sessions/tasks.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-session-cache-and-resilience/.openspec.yaml create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-session-cache-and-resilience/design.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-session-cache-and-resilience/proposal.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-session-cache-and-resilience/specs/lab2-dependency-failures/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-session-cache-and-resilience/specs/lab2-history-index/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-session-cache-and-resilience/specs/lab2-session-cache/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab2-session-cache-and-resilience/tasks.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab3-failover-operations/.openspec.yaml create mode 100644 openspec/changes/archive/2026-10-28-add-lab3-failover-operations/design.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab3-failover-operations/proposal.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab3-failover-operations/specs/lab1-service-operability/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab3-failover-operations/specs/lab2-dependency-failures/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab3-failover-operations/specs/lab3-failover-operations/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab3-failover-operations/tasks.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab3-load-balanced-replicas/.openspec.yaml create mode 100644 openspec/changes/archive/2026-10-28-add-lab3-load-balanced-replicas/design.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab3-load-balanced-replicas/proposal.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab3-load-balanced-replicas/specs/lab1-messenger-history/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab3-load-balanced-replicas/specs/lab1-service-operability/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab3-load-balanced-replicas/specs/lab2-persistent-storage/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab3-load-balanced-replicas/specs/lab3-idempotent-messages/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab3-load-balanced-replicas/specs/lab3-load-balancing/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab3-load-balanced-replicas/tasks.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab4-image-attachments/.openspec.yaml create mode 100644 openspec/changes/archive/2026-10-28-add-lab4-image-attachments/design.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab4-image-attachments/proposal.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab4-image-attachments/specs/lab1-messenger-history/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab4-image-attachments/specs/lab2-persistent-storage/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab4-image-attachments/specs/lab3-idempotent-messages/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab4-image-attachments/specs/lab3-load-balancing/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab4-image-attachments/specs/lab4-attachments/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab4-image-attachments/specs/lab4-object-storage/spec.md create mode 100644 openspec/changes/archive/2026-10-28-add-lab4-image-attachments/tasks.md create mode 100644 openspec/changes/archive/2026-10-29-add-lab4-upload-resilience/.openspec.yaml create mode 100644 openspec/changes/archive/2026-10-29-add-lab4-upload-resilience/design.md create mode 100644 openspec/changes/archive/2026-10-29-add-lab4-upload-resilience/proposal.md create mode 100644 openspec/changes/archive/2026-10-29-add-lab4-upload-resilience/specs/lab4-attachments/spec.md create mode 100644 openspec/changes/archive/2026-10-29-add-lab4-upload-resilience/specs/lab4-object-storage/spec.md create mode 100644 openspec/changes/archive/2026-10-29-add-lab4-upload-resilience/specs/lab4-upload-resilience/spec.md create mode 100644 openspec/changes/archive/2026-10-29-add-lab4-upload-resilience/tasks.md create mode 100644 openspec/config.yaml create mode 100644 openspec/notes/architecture-patterns-python.md create mode 100644 openspec/specs/lab1-event-publication/spec.md create mode 100644 openspec/specs/lab1-messenger-chats/spec.md create mode 100644 openspec/specs/lab1-messenger-history/spec.md create mode 100644 openspec/specs/lab1-messenger-identity/spec.md create mode 100644 openspec/specs/lab1-service-operability/spec.md create mode 100644 openspec/specs/lab2-auth-sessions/spec.md create mode 100644 openspec/specs/lab2-dependency-failures/spec.md create mode 100644 openspec/specs/lab2-history-index/spec.md create mode 100644 openspec/specs/lab2-persistent-storage/spec.md create mode 100644 openspec/specs/lab2-session-cache/spec.md create mode 100644 openspec/specs/lab3-failover-operations/spec.md create mode 100644 openspec/specs/lab3-idempotent-messages/spec.md create mode 100644 openspec/specs/lab3-load-balancing/spec.md create mode 100644 openspec/specs/lab4-attachments/spec.md create mode 100644 openspec/specs/lab4-object-storage/spec.md create mode 100644 openspec/specs/lab4-upload-resilience/spec.md diff --git a/.claude/commands/opsx/apply.md b/.claude/commands/opsx/apply.md new file mode 100644 index 00000000..31c4fa24 --- /dev/null +++ b/.claude/commands/opsx/apply.md @@ -0,0 +1,181 @@ +--- +name: "OPSX: Apply" +description: "Implement tasks from an OpenSpec change (Experimental)" +allowed-tools: Bash(openspec:*) +category: "Workflow" +tags: ["workflow", "artifacts", "experimental"] +--- + +Implement tasks from an OpenSpec change. + +**Store selection:** If the user names a store (a store is a standalone OpenSpec repo registered on this machine) or the work lives in one, run `openspec store list --json` to discover registered store ids, then pass `--store ` on the commands that read or write specs and changes (`new change`, `status`, `instructions`, `list`, `show`, `validate`, `archive`, `doctor`, `context`, `view`). Once selected, treat `--store ` as sticky for the rest of the workflow. Every unscoped example of those commands below is shorthand: before running it, append the flag. For example, run `openspec status --change "" --json --store ""`, not the unscoped form shown below. Other commands do not take the flag. Hints printed by commands already carry the flag; keep it on follow-ups. Without a store, commands act on the nearest local `openspec/` root. + +**Input**: Optionally specify a change name (e.g., `/opsx:apply add-auth`). If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes. + +**Steps** + +1. **Select the change** + + If a name is provided, use it. Otherwise: + - Infer from conversation context if the user mentioned a change + - Auto-select if only one active change exists + - If ambiguous, run `openspec list --json` to get available changes and ask the user to select one + + Always announce: "Using change: " and how to override (e.g., `/opsx:apply `). + +2. **Check status to understand the schema** + ```bash + openspec status --change "" --json + ``` + Parse the JSON to understand: + - `schemaName`: The workflow being used (e.g., "spec-driven") + - `planningHome`, `changeRoot`, and `actionContext`: planning scope and edit constraints + - Which artifact contains the tasks (typically "tasks" for spec-driven, check status for others) + +3. **Get apply instructions** + + ```bash + openspec instructions apply --change "" --json + ``` + + This returns: + - `contextFiles`: artifact ID -> array of concrete file paths (varies by schema - could be proposal/specs/design/tasks or spec/tests/implementation/docs) + - Progress (total, complete, remaining) + - Task list with status + - Dynamic instruction based on current state + - Optional `context`: current required project instruction input from the selected root + - Optional `operationGuidance`: current advisory guidance for apply + + **Handle states:** + - If `state: "blocked"` (missing artifacts): show message, suggest using `/opsx:continue` (if it is not installed, run `openspec status --change "" --json` to see the next artifact and `openspec instructions --change "" --json` for how to create it) + - If `state: "all_done"`: congratulate, suggest archive + - Otherwise: proceed to implementation + + Treat `context` as a required prompt-level input. Read and consider it, and + apply relevant project facts, conventions, and constraints while implementing. + Treat `operationGuidance` as optional additive advice. Read and consider every + entry, and follow entries that are applicable and compatible with the built-in + workflow. + + Keep both fields separate from CLI-returned state, missing artifacts, tasks, + progress, `contextFiles`, and the built-in `instruction`. They are not + evidence of task completion, do not replace the built-in instruction, and do + not permit bypassing a blocked state. If context conflicts with the built-in + instruction, an explicit user choice, or a CLI-controlled value, report the + conflict and preserve the controlling value. If guidance is inapplicable or + conflicts with those controlling inputs, do not follow it and explain why. + These are prompt-level behavior contracts, not enforceable checks. + +4. **Read context files** + + Read every file path listed under `contextFiles` from the apply instructions output. + The files depend on the schema being used: + - **spec-driven**: proposal, specs, design, tasks + - Other schemas: follow the contextFiles from CLI output + + Do not copy `context` or `operationGuidance` verbatim into implementation + files or planning artifacts unless the user separately asks for that content. + +5. **Show current progress** + + Display: + - Schema being used + - Progress: "N/M tasks complete" + - Remaining tasks overview + - Dynamic instruction from CLI + +6. **Implement tasks (loop until done or blocked)** + + For each pending task: + - Show which task is being worked on + - Make the code changes required + - Keep changes minimal and focused + - Mark task complete in the tasks file: `- [ ]` → `- [x]` + - Continue to next task + + **Pause if:** + - Task is unclear → ask for clarification + - Implementation reveals a design issue → suggest updating artifacts + - Error or blocker encountered → report and wait for guidance + - User interrupts + +7. **On completion or pause, show status** + + Display: + - Tasks completed this session + - Overall progress: "N/M tasks complete" + - If all done: suggest archive + - If paused: explain why and wait for guidance + +**Output During Implementation** + +``` +## Implementing: (schema: ) + +Working on task 3/7: +[...implementation happening...] +✓ Task complete + +Working on task 4/7: +[...implementation happening...] +✓ Task complete +``` + +**Output On Completion** + +``` +## Implementation Complete + +**Change:** +**Schema:** +**Progress:** 7/7 tasks complete ✓ + +### Completed This Session +- [x] Task 1 +- [x] Task 2 +... + +All tasks complete! You can archive this change with `/opsx:archive`. +``` + +**Output On Pause (Issue Encountered)** + +``` +## Implementation Paused + +**Change:** +**Schema:** +**Progress:** 4/7 tasks complete + +### Issue Encountered + + +**Options:** +1. !RO#B0(pJk4!*pH%648$;{y>V ze~2NPg&5NK5aa%(@%=;&d@Y&<7SSxE)t5}BsxMiY+%Hoi?;%9Z$0V8sBGD`)5zQhK z(X28N%?1rq7L|!9i$TMbMNX3kcgo^68$%m>P-O$f%3Wb|xa=9o2{8=h%;BApweROKro#<}M!3Py7-F1UL*uY@Ap<#~x`CWh-J?hc4W>k8VjySG zU`k9G?op%@F?KzXEyOToF%iR*MTud`Vu6M!iwU7ji3Sa(M9^SLj7(0hDe>M1s{NfK zK&2U(Ykx=PD$UA7`+LyP{;o{4zXuKN@0=#u-$RVFzqi>Knjh3K3ZpcPh8S+w2{GKR z6JoesXHvEGzTxxdu3sos4t&k~DlELOpuzh}Y;likVvF1?GLf5ACWd(i4Hj!X;mVXbSZ~g}d4|y_#W2rsgQ3x&!O#dA42_Y=@fqehY-4Ei z!Rak-pm6X7iZz)Xe4}UwU%BDn3mOi-k;(Bn`0@e0`}Rb$`Itnr(nB;08lu_AL^KOA z+=(7KQf?h%(Xe(1Do^&`Zv`jHdaU161pG(KoNxDW3O2>WqE8lRwHys!+B#t$0$ zl99=3i!^=>9gB7NBR4C5Sgb)qZdRGFSO*Qc*+M2P*8Qa21Z;@m;W863*09LU!VNQH z;fA{`CVrY33o%Z}%-E3|LnC|*qfp&_6hjQAM2NwZ2r)E_dLl3-f`*1sf(BC}K|{kR zGO?Dskcqjk;RaJ8L4zqV#IVQ~VlX8_j1yu?^y6E;*8a|?X~QVFf%bQlqSCBPw7&-p zmF7Yw+TRmGjV4wm4|t_{(8ds|3<9V!2qdDKlqf7riJ)OpBGJQBKN2)N^`kQJ)Q>^K zltpFYsUL#|?<=PX?`w$RsUIPRr+$POp87EdtIN+z467eS!&+|9Fl7-m7#azo42@(O z42{Typ;4JIGzN{6ZfM-HF7)F}i4i_iA}0bk-626A+}00#87F57;8hu>c?bCRzHRt zD$NEBm1fXTX^u>8xn$t>8$+8Pw86cBV&$%|h|67JA%=$0BqwW`*x(*+*x*jkkj4)& zG>k$F7nqkA)^dx6G(Ko(7$wutFiHs3Fse*6j0O!2qsqht?4V%+Hm8ZcMDx@|*e3#)Q0RC0q{N`1TC7Y| zi-U%0F{g>#Y=|K@3o%@K5@M(p=U{d1Nr~awlcHhDqG*_a4H^uMgiwY?G7W}CWWvy> zOc)x221BDVVQ35*$I;L@WL?O?=imzh!(mgbg~i-g&~WfoCJw$q<2W9C?0_(@#N zUEu`{xnv*=@fg#J z&LsnbhW2-4;^xC4h9`!U7%qS+8V_3gdz+1+!AHX=Y1o5Cm7zgE*#9DnHRp?lQ5d3O zw6BphLs+bl35&HdaZ$jaVJ){Z@kF*kgZGuwg!eVXu=){VtUD2&$Tr-t`Vnqe{TO2K zzCsN5xP}-eU?&@2nHj507#cx?p^>1$&`8iQGZvYgI78!*jiJrwYanL>#h$sZ#6WXj zAqG<-F_0-ynHb0^8cd0xVag&Q)RaX+s40ue#C;Tl22-LkvB)-PFeP%DFeQc<7TH1! zi)M*Wn%k#(6IfzkjYbLuO6(RL2P~H$di}f%un@Od2OCQNTOK?!_bIK z_81z2#?sI@YGY{hB_a)mR%;V#REr^oyTT@7tTc=kGI3Yfa6`42pdpPPVwhqLG4v%v z3{$KEYUw0gWj!8TE=OF~o4~ zNr>UvlMqA0XwF}YY$b-=tZ2y1iUw06XfP!bLS1{3Ov55uWMTrgGI3?fpkd0QGGS;8 z8Vrq`CJc=s216snU}%IG$Jx;M&OiLsPk(4T?@#>L(|>#JrPp7cbFjZf zUTYW?A`PQKgDDZ2xLs$6;dY%8!=yyfU`hlHrbL3q6HJLggDFv&FeL^JrbKE_ro<3~ zDG_2YB|?njY)U+T?)rtk)dOFvGz*LNchJ!Oo}^Kw8Dbo-nf$&n(X42QWXDs7%~P5j0F$G-#Nz7&KIik%=jb zA%-c75`*_uH127&*nenV>q{on)0Z4#C;>tYB|wOwFWJ*v2~aeY0E31Spg}{!C}?OH zjZBmPA;w*4fB*VhAAMxKF!bb^Z+z*y-~QS+AAe{+lM#^?P`fK^pBPMu5<^5P8cd0x zVfCX2x7Ck9!<0p3V)bLtV6je`Vaj46#?6}pFP^^=aE3FBFRB&;n!Ccn4Y^q)BR8u| m 1 else 'resource-probe.py')).read_text(), 'fixtures': {p.name: base64.b64encode(p.read_bytes()).decode() for p in (folder / 'fixtures').glob('*.png')}} +result = subprocess.run(['docker', 'compose', 'exec', '-T', 'worker', 'python', '-c', bootstrap], input=json.dumps(payload), text=True, check=False) +raise SystemExit(result.returncode) diff --git a/evidence/final-validation-2026-11-07/openspec.txt b/evidence/final-validation-2026-11-07/openspec.txt new file mode 100644 index 00000000..96290197 --- /dev/null +++ b/evidence/final-validation-2026-11-07/openspec.txt @@ -0,0 +1,28 @@ +date: 2026-11-06T21:15:53Z commit: b30e2f6a84419d1ca64525ffb40df92183cccaef +environment: {} +$ openspec validate --all --strict +- 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) +exit_code: 0 elapsed_seconds: 0.889 diff --git a/evidence/final-validation-2026-11-07/png-http.json b/evidence/final-validation-2026-11-07/png-http.json new file mode 100644 index 00000000..933a5add --- /dev/null +++ b/evidence/final-validation-2026-11-07/png-http.json @@ -0,0 +1,742 @@ +{ + "mode": "png-http", + "source_sha": "b30e2f6a84419d1ca64525ffb40df92183cccaef", + "started_at": "2026-11-06T21:20:30.802260Z", + "cases": [ + { + "name": "gray2", + "started_at": "2026-11-06T21:20:31.867669Z", + "observed": { + "attachment_id": "01a1b2bc-107e-76d1-b857-f8a847a893d8", + "input_sha256": "80754a3aa0c8a6014dc7a282b2009d49d064a5c02ed48e634d05d01c0aa3df6b", + "input_bytes": 189, + "versions": [ + { + "version": 1, + "variants": [ + { + "name": "crop", + "sha256": "def030bc04042aa23362c895a36b18d1d9748360df045decaf68eaeb0aa68deb", + "bytes": 1324, + "dimensions": [ + 128, + 128 + ] + }, + { + "name": "optimized", + "sha256": "fd49dc2d33e7b7963cd8f8f6ef0f0b80117e2c4a7dfb4fd2ee79285e47ff789a", + "bytes": 98, + "dimensions": [ + 64, + 64 + ] + }, + { + "name": "thumbnail", + "sha256": "1b6f714677aa69673da7ed9eefba73376b8df42eae70a3d91002d2aab7272d9e", + "bytes": 332, + "dimensions": [ + 64, + 64 + ] + } + ] + }, + { + "version": 2, + "variants": [ + { + "name": "crop", + "sha256": "d14b6cc6fe415bd8c4fef55402a4fb196bc4f39d493ee505d536594b28841697", + "bytes": 1489, + "dimensions": [ + 128, + 128 + ] + }, + { + "name": "optimized", + "sha256": "c8f23e1adbf1add646f23531e270dc25d5108453d50947dec3e73700b0d6741f", + "bytes": 96, + "dimensions": [ + 64, + 64 + ] + }, + { + "name": "thumbnail", + "sha256": "93107a3ba1a8aba475f8993dfb0d03658cef12a416c08a230653370921dcc00b", + "bytes": 335, + "dimensions": [ + 64, + 64 + ] + } + ] + } + ], + "stale_and_duplicate_noop": true + }, + "result": "PASS", + "elapsed_seconds": 4.952 + }, + { + "name": "gray4", + "started_at": "2026-11-06T21:20:36.820264Z", + "observed": { + "attachment_id": "01a1b2bc-23d7-7757-bd08-e78831dce1a6", + "input_sha256": "d0ed5b64b3b875be881dd286bedb7948fd06570f9ef1d2cfe41b665a838e426b", + "input_bytes": 263, + "versions": [ + { + "version": 1, + "variants": [ + { + "name": "crop", + "sha256": "43323e552e3c79e1a1688478d72c2ce370c21e55f1560958f9f6a225bc32f909", + "bytes": 1034, + "dimensions": [ + 128, + 128 + ] + }, + { + "name": "optimized", + "sha256": "dbc0ec3736c18df42f26b8f396b2eb243a18c6a0f5b6bbef8bf4ff7e563032c3", + "bytes": 90, + "dimensions": [ + 64, + 64 + ] + }, + { + "name": "thumbnail", + "sha256": "d594ebb80ca7939643379ba54392070444eb900ca40bec9c6beee75175fd81ab", + "bytes": 330, + "dimensions": [ + 64, + 64 + ] + } + ] + }, + { + "version": 2, + "variants": [ + { + "name": "crop", + "sha256": "16e27d4c1df7aac7185381a1f4c8c9cceb05647e98f941c41e38f4dfe4c5ec75", + "bytes": 1197, + "dimensions": [ + 128, + 128 + ] + }, + { + "name": "optimized", + "sha256": "cd31de25056767d9050108c4475d4b72ccd1ab3c36c1c96159b104019e4e3493", + "bytes": 92, + "dimensions": [ + 64, + 64 + ] + }, + { + "name": "thumbnail", + "sha256": "86afdaf8b40f77c2426ebf10c8d603535d75caa4fc720462be9acc43e39d4fbd", + "bytes": 330, + "dimensions": [ + 64, + 64 + ] + } + ] + } + ], + "stale_and_duplicate_noop": true + }, + "result": "PASS", + "elapsed_seconds": 4.607 + }, + { + "name": "rgb16", + "started_at": "2026-11-06T21:20:41.427922Z", + "observed": { + "attachment_id": "01a1b2bc-35d8-7442-a3b7-1cd166d552cc", + "input_sha256": "e8e5f64cf3a0312b17549aed29f062e3cb03d0c1bf327396c6a25c4b88dec89f", + "input_bytes": 724, + "versions": [ + { + "version": 1, + "variants": [ + { + "name": "crop", + "sha256": "6386114c3d0b89c4df88745eec318b5db1a779d488e1b08f34ac34138c7feb99", + "bytes": 671, + "dimensions": [ + 128, + 128 + ] + }, + { + "name": "optimized", + "sha256": "fed7e1bf230e91296a5ea9a85b51d190152639bb2963b661f872029d852cc4ad", + "bytes": 94, + "dimensions": [ + 64, + 64 + ] + }, + { + "name": "thumbnail", + "sha256": "af0a65a6596a0905a79403a9a6ef32a1301671a98ae3c8b5c3d6ced2d20a1009", + "bytes": 332, + "dimensions": [ + 64, + 64 + ] + } + ] + }, + { + "version": 2, + "variants": [ + { + "name": "crop", + "sha256": "dedcbac123226e3012a4dbd178b7aae7a7aba4f2c44c91be274c86804238b208", + "bytes": 696, + "dimensions": [ + 128, + 128 + ] + }, + { + "name": "optimized", + "sha256": "bc09a1696563daae4385190d2c52afac8230e18fff4b5eba701a42f0facde043", + "bytes": 94, + "dimensions": [ + 64, + 64 + ] + }, + { + "name": "thumbnail", + "sha256": "218bc7fd6fa995a3c4cf725016714408073699d13f39d0d364ffe3595856d272", + "bytes": 333, + "dimensions": [ + 64, + 64 + ] + } + ] + } + ], + "stale_and_duplicate_noop": true + }, + "result": "PASS", + "elapsed_seconds": 4.02 + }, + { + "name": "gray1", + "started_at": "2026-11-06T21:20:45.448396Z", + "observed": { + "attachment_id": "01a1b2bc-458d-73f1-9c76-b2f5f360400e", + "input_sha256": "1bf59ee41fbd12bf572ac294e0505cc00b904363dd479d643b43062199dd67e3", + "input_bytes": 154, + "versions": [ + { + "version": 1, + "variants": [ + { + "name": "crop", + "sha256": "1b88218fd7e3ff00d6fa3e4bb732411617126591b2b6837aecdcaef426327eda", + "bytes": 380, + "dimensions": [ + 128, + 128 + ] + }, + { + "name": "optimized", + "sha256": "315ce3f53ac2012226bbeb906c7d37997a7f6fabb3d0ede23a797e66fe4b51ee", + "bytes": 66, + "dimensions": [ + 64, + 64 + ] + }, + { + "name": "thumbnail", + "sha256": "c5745603d7848377a38bb5228f7817f5d4d4f5af26dadd7d3b2fb97b6a598a8e", + "bytes": 308, + "dimensions": [ + 64, + 64 + ] + } + ] + }, + { + "version": 2, + "variants": [ + { + "name": "crop", + "sha256": "45eac1bd54dba273142a01a3f01a1530787db5a9fe04aa2483862256dbf16132", + "bytes": 380, + "dimensions": [ + 128, + 128 + ] + }, + { + "name": "optimized", + "sha256": "8c5e7cc56874d00f7d5731a6a89461b264ef4e3b450899b63f4608231180b5aa", + "bytes": 66, + "dimensions": [ + 64, + 64 + ] + }, + { + "name": "thumbnail", + "sha256": "19305cfd18dc8f3e504d6ef5667ddd7be788836e16317dba5b2c6f590b6a2667", + "bytes": 308, + "dimensions": [ + 64, + 64 + ] + } + ] + } + ], + "stale_and_duplicate_noop": true + }, + "result": "PASS", + "elapsed_seconds": 3.992 + }, + { + "name": "gray8", + "started_at": "2026-11-06T21:20:49.441526Z", + "observed": { + "attachment_id": "01a1b2bc-5527-75fa-ace8-6f2de9678922", + "input_sha256": "31cb54aacd9e1c324b14e38377f83a21d4084dc134aa3d3e1e5c40e3d9c5dd2f", + "input_bytes": 286, + "versions": [ + { + "version": 1, + "variants": [ + { + "name": "crop", + "sha256": "14a6e4afbe7e4cf766330007adda1c14168f16957f9409f402a8699a0e5de62f", + "bytes": 621, + "dimensions": [ + 128, + 128 + ] + }, + { + "name": "optimized", + "sha256": "d35d7d59302099ea5fea9e91a405f4ebf8823aae1f53a59f88a09015619136fa", + "bytes": 74, + "dimensions": [ + 64, + 64 + ] + }, + { + "name": "thumbnail", + "sha256": "d8fac3c82defab08dbb276681b1a7fb2545d883830dae5f965349474897373c7", + "bytes": 324, + "dimensions": [ + 64, + 64 + ] + } + ] + }, + { + "version": 2, + "variants": [ + { + "name": "crop", + "sha256": "dba34622f93edcd2d3449e217eb9605b1fac739c7c873a875af5d88d8e76bf2e", + "bytes": 637, + "dimensions": [ + 128, + 128 + ] + }, + { + "name": "optimized", + "sha256": "3d4823a2da9971a444b16cf060be5f0b2b7a16bf50a26e7343283d48b562d105", + "bytes": 76, + "dimensions": [ + 64, + 64 + ] + }, + { + "name": "thumbnail", + "sha256": "d9d4ed6ef383acdf227745e511acaffddf6e90c4f100d0f6ea117f5783581d29", + "bytes": 324, + "dimensions": [ + 64, + 64 + ] + } + ] + } + ], + "stale_and_duplicate_noop": true + }, + "result": "PASS", + "elapsed_seconds": 4.022 + }, + { + "name": "gray16", + "started_at": "2026-11-06T21:20:53.463983Z", + "observed": { + "attachment_id": "01a1b2bc-64df-7694-8365-6ba2803fa169", + "input_sha256": "f7fbc2506997045f18891037f3cde42cf1e3b55461948f790779817317574f77", + "input_bytes": 344, + "versions": [ + { + "version": 1, + "variants": [ + { + "name": "crop", + "sha256": "e49a69181bafd0ebb4348db7030ad2cbf632b296a65f0ba05fe984b3d2b1ccdc", + "bytes": 632, + "dimensions": [ + 128, + 128 + ] + }, + { + "name": "optimized", + "sha256": "751dc647784804af94b6cda23248840f73cab0cfe03227c4568b75195c00603a", + "bytes": 80, + "dimensions": [ + 64, + 64 + ] + }, + { + "name": "thumbnail", + "sha256": "1bc87b25d02a179dc0cf5a883fb624fda094ba042ed9476c883ae1c12da6f1b6", + "bytes": 322, + "dimensions": [ + 64, + 64 + ] + } + ] + }, + { + "version": 2, + "variants": [ + { + "name": "crop", + "sha256": "a94faef9b08b5ab6ab239b6618c0e92b0ab92abca889acd714d6d9179dde90ef", + "bytes": 662, + "dimensions": [ + 128, + 128 + ] + }, + { + "name": "optimized", + "sha256": "b22468814595a3ae63a9b326ed55fefb9a833a0e621be5f366b113ad6cf18a12", + "bytes": 72, + "dimensions": [ + 64, + 64 + ] + }, + { + "name": "thumbnail", + "sha256": "d2267d9adb990db045e8c186737a4bdf66aa4e8d82d785c0bb3d8e87c34c5072", + "bytes": 323, + "dimensions": [ + 64, + 64 + ] + } + ] + } + ], + "stale_and_duplicate_noop": true + }, + "result": "PASS", + "elapsed_seconds": 3.952 + }, + { + "name": "rgb8", + "started_at": "2026-11-06T21:20:57.416228Z", + "observed": { + "attachment_id": "01a1b2bc-7451-70a2-83ed-869d99c81f3f", + "input_sha256": "8c27c74500758b1a24ccc96261334265e304d55530780aefc7ef4a1109c11852", + "input_bytes": 385, + "versions": [ + { + "version": 1, + "variants": [ + { + "name": "crop", + "sha256": "c36bf54d185cfcf7abddd219a5e586e11b0c4d10007df5db55978f74ddcad2d0", + "bytes": 1069, + "dimensions": [ + 128, + 128 + ] + }, + { + "name": "optimized", + "sha256": "7b78675ebd18218e82922e75072a801eea74b4d5f26cde2b5810407c86509b88", + "bytes": 116, + "dimensions": [ + 64, + 64 + ] + }, + { + "name": "thumbnail", + "sha256": "f6e37a29401efe000eb8deb1490975d745f621f2ab229f4d85162945189e1791", + "bytes": 385, + "dimensions": [ + 64, + 64 + ] + } + ] + }, + { + "version": 2, + "variants": [ + { + "name": "crop", + "sha256": "fd82664e5924528cd7916b3b9e30b71517fa13c2763a8705e750fd4293f3027c", + "bytes": 1184, + "dimensions": [ + 128, + 128 + ] + }, + { + "name": "optimized", + "sha256": "a05ef5a9f1305b2941cc99ab594eb3671bb87babe35d28ac97127791881137bb", + "bytes": 120, + "dimensions": [ + 64, + 64 + ] + }, + { + "name": "thumbnail", + "sha256": "3cac9f1ca274bcac1dc05cf186cd88eb622fd947fb1a7958a1175e77623a96d6", + "bytes": 392, + "dimensions": [ + 64, + 64 + ] + } + ] + } + ], + "stale_and_duplicate_noop": true + }, + "result": "PASS", + "elapsed_seconds": 4.545 + }, + { + "name": "rgb16-adam7-filter4-exif6", + "started_at": "2026-11-06T21:21:01.962099Z", + "observed": { + "attachment_id": "01a1b2bc-8615-7763-b117-c00aacaebeb6", + "input_sha256": "b9c1cb1e309024e4578d1f17bf6bb0f0645aad4d8973e16098b65c54cfd4930a", + "input_bytes": 1297, + "versions": [ + { + "version": 1, + "variants": [ + { + "name": "crop", + "sha256": "f257bf8fa4f30f0e4df6672de140799375cebd2bf735a656432cf702663414a1", + "bytes": 601, + "dimensions": [ + 128, + 128 + ] + }, + { + "name": "optimized", + "sha256": "cb92af5a047068048eba212d944513edb2c454f64e124339820d46c24e69ea45", + "bytes": 112, + "dimensions": [ + 63, + 65 + ] + }, + { + "name": "thumbnail", + "sha256": "110cf7571f07d2db04821e8ef1861f74b5a16978851a4b0082ca60aedc1d29e4", + "bytes": 419, + "dimensions": [ + 63, + 65 + ] + } + ] + }, + { + "version": 2, + "variants": [ + { + "name": "crop", + "sha256": "0a7fea5640c5877026100e65e39848e7b15ee5eebb93897ebbeb95d441e8d652", + "bytes": 675, + "dimensions": [ + 128, + 128 + ] + }, + { + "name": "optimized", + "sha256": "9d4b7431a72adfc10284e4443c4e56b4cd19a67c0729979041fc8b0bc2c6ca34", + "bytes": 116, + "dimensions": [ + 63, + 65 + ] + }, + { + "name": "thumbnail", + "sha256": "529ceb55a8675e5ed870ed7917d7f1a5753c898b689f3e431e403b9b3682a732", + "bytes": 440, + "dimensions": [ + 63, + 65 + ] + } + ] + } + ], + "stale_and_duplicate_noop": true + }, + "result": "PASS", + "elapsed_seconds": 4.577 + } + ], + "conditions": { + "host_load": [ + 5.10693359375, + 3.61181640625, + 2.75048828125 + ], + "containers": [ + "mtusi2026lab5-api-1 fc7d65385119 running Up 3 minutes (healthy)", + "mtusi2026lab5-api-2 a5411e55f06d running Up 3 minutes (healthy)", + "mtusi2026lab5-broker-1 a38bbcf03870 running Up 3 minutes (healthy)", + "mtusi2026lab5-lb-1 f0d01200b1f8 running Up 3 minutes (healthy)", + "mtusi2026lab5-migrate-1 feca425ac0ae exited Exited (0) 2 minutes ago", + "mtusi2026lab5-postgres-1 9f62ea9d176b running Up 11 seconds (healthy)", + "mtusi2026lab5-relay-1 4153c8488753 running Up 3 minutes (healthy)", + "mtusi2026lab5-s3-1 9a7684ef147a running Up 3 minutes (healthy)", + "mtusi2026lab5-s3-init-1 e5825f3eeafb exited Exited (0) 2 minutes ago", + "mtusi2026lab5-valkey-1 e37f783f9d50 running Up 3 minutes (healthy)", + "mtusi2026lab5-worker-1 ee8f9d678c2c running Up 24 seconds (healthy)" + ], + "running": "mtusi2026lab5-api-1 Up 3 minutes (healthy)\nmtusi2026lab5-relay-1 Up 3 minutes (healthy)\nmtusi2026lab5-api-2 Up 3 minutes (healthy)\nmtusi2026lab5-worker-1 Up 24 seconds (healthy)\nmtusi2026lab5-broker-1 Up 3 minutes (healthy)\nmtusi2026lab5-postgres-1 Up 11 seconds (healthy)\nmtusi2026lab5-lb-1 Up 3 minutes (healthy)\nmtusi2026lab5-s3-1 Up 3 minutes (healthy)\nmtusi2026lab5-valkey-1 Up 3 minutes (healthy)\n", + "worker_limits": "448\n30\n2\n" + }, + "invariants": [ + { + "id": "terminal", + "statement": "every 202 reaches its expected terminal state", + "result": "PASS", + "details": { + "accepted": 8 + } + }, + { + "id": "single_effect", + "statement": "one variant set per (attachment_id, pipeline_version, variant)", + "result": "PASS", + "details": { + "rows": 0 + } + }, + { + "id": "no_ready_rollback", + "statement": "ready never returns to queued or processing", + "result": "PASS", + "details": { + "traced": 8 + } + }, + { + "id": "monotonic_publication", + "statement": "published_version only moves forward", + "result": "PASS", + "details": { + "sampled": 8 + } + }, + { + "id": "bytes_match_metadata", + "statement": "sha256, size and real dimensions match served bytes", + "result": "PASS", + "details": { + "verified": 8 + } + }, + { + "id": "bounded_attempts", + "statement": "attempt <= JOB_MAX_ATTEMPTS", + "result": "PASS", + "details": { + "rows": 0 + } + }, + { + "id": "no_orphans", + "statement": "no pending outbox, messages, dead letters, staging, objects", + "result": "PASS", + "details": { + "queues": { + "attachments.process": [ + 0, + 0 + ], + "attachments.process.dlq": [ + 15, + 0 + ] + }, + "s3_objects": 56, + "scoped_attachments": 8 + } + }, + { + "id": "no_lost_202", + "statement": "every 202 is present in PostgreSQL and the API", + "result": "PASS", + "details": { + "accepted": 8 + } + } + ], + "accepted_ids": [ + "01a1b2bc-107e-76d1-b857-f8a847a893d8", + "01a1b2bc-23d7-7757-bd08-e78831dce1a6", + "01a1b2bc-35d8-7442-a3b7-1cd166d552cc", + "01a1b2bc-458d-73f1-9c76-b2f5f360400e", + "01a1b2bc-5527-75fa-ace8-6f2de9678922", + "01a1b2bc-64df-7694-8365-6ba2803fa169", + "01a1b2bc-7451-70a2-83ed-869d99c81f3f", + "01a1b2bc-8615-7763-b117-c00aacaebeb6" + ], + "finished_at": "2026-11-06T21:21:18.474212Z", + "result": "PASS" +} diff --git a/evidence/final-validation-2026-11-07/png-http.txt b/evidence/final-validation-2026-11-07/png-http.txt new file mode 100644 index 00000000..908483bd --- /dev/null +++ b/evidence/final-validation-2026-11-07/png-http.txt @@ -0,0 +1,12 @@ +date: 2026-11-06T21:20:30Z commit: b30e2f6a84419d1ca64525ffb40df92183cccaef +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-validation"} +$ .venv/bin/python evidence/final-validation-2026-11-07/targeted.py png-http +gray2 PASS +gray4 PASS +rgb16 PASS +gray1 PASS +gray8 PASS +gray16 PASS +rgb8 PASS +rgb16-adam7-filter4-exif6 PASS +exit_code: 0 elapsed_seconds: 47.846 diff --git a/evidence/final-validation-2026-11-07/png-limits.json b/evidence/final-validation-2026-11-07/png-limits.json new file mode 100644 index 00000000..bf4e8ef9 --- /dev/null +++ b/evidence/final-validation-2026-11-07/png-limits.json @@ -0,0 +1,242 @@ +{ + "mode": "png-limits", + "source_sha": "b30e2f6a84419d1ca64525ffb40df92183cccaef", + "started_at": "2026-11-06T21:21:18.724252Z", + "cases": [ + { + "name": "gray2-40mp", + "started_at": "2026-11-06T21:21:20.277013Z", + "result": "FAIL", + "error": "{\"attachment_id\": \"01a1b2bc-cdc1-7315-82e0-39f3e53d87db\", \"input_bytes\": 35759, \"input_sha256\": \"e1238de6a5be9dbce36abee904f7233f8ff7be59e405b528671940630cce11f6\", \"pixels\": 40000000, \"status\": \"failed\", \"error_code\": \"processing_failed\", \"jobs\": [{\"job_id\": \"01a1b2bc-cdc9-7157-b245-f357f81b4d6c\", \"pipeline_version\": 1, \"status\": \"failed\", \"attempt\": 1}], \"memory_peak\": \"541655040\", \"memory_max\": \"1073741824\"}", + "elapsed_seconds": 1.066 + }, + { + "name": "gray4-40mp", + "started_at": "2026-11-06T21:21:21.343296Z", + "result": "FAIL", + "error": "{\"attachment_id\": \"01a1b2bc-d211-7337-bd57-0ca1f3e33a0d\", \"input_bytes\": 46441, \"input_sha256\": \"64e665928c08ac3721324af4f8e2e9d2e98230dc1be389dde7bbf365650b08cd\", \"pixels\": 40000000, \"status\": \"failed\", \"error_code\": \"processing_failed\", \"jobs\": [{\"job_id\": \"01a1b2bc-d21b-72a6-b463-0fa58bd353a2\", \"pipeline_version\": 1, \"status\": \"failed\", \"attempt\": 1}], \"memory_peak\": \"541655040\", \"memory_max\": \"1073741824\"}", + "elapsed_seconds": 1.168 + }, + { + "name": "gray16-40mp", + "started_at": "2026-11-06T21:21:22.511903Z", + "result": "FAIL", + "error": "{\"attachment_id\": \"01a1b2bc-d744-77c1-8352-989f80848cab\", \"input_bytes\": 103565, \"input_sha256\": \"b59784ae916d50b41b15afa4bdd474a8699f099da55efd53580d3f97180f3800\", \"pixels\": 40000000, \"status\": \"failed\", \"error_code\": \"processing_failed\", \"jobs\": [{\"job_id\": \"01a1b2bc-d74e-7582-a9f8-fa827d36c9fe\", \"pipeline_version\": 1, \"status\": \"failed\", \"attempt\": 1}], \"memory_peak\": \"638119936\", \"memory_max\": \"1073741824\"}", + "elapsed_seconds": 0.955 + }, + { + "name": "rgb16-40mp", + "started_at": "2026-11-06T21:21:23.467422Z", + "result": "FAIL", + "error": "{\"attachment_id\": \"01a1b2bc-dc37-7249-b7c3-f8901fb298de\", \"input_bytes\": 385445, \"input_sha256\": \"3c4418a6f6a7676298b30b70ebbde9d12929f1345152f4fae979caf5ba1cb3f7\", \"pixels\": 40000000, \"status\": \"failed\", \"error_code\": \"processing_failed\", \"jobs\": [{\"job_id\": \"01a1b2bc-dc3f-7724-a737-43ad5584c8c7\", \"pipeline_version\": 1, \"status\": \"failed\", \"attempt\": 1}], \"memory_peak\": \"640196608\", \"memory_max\": \"1073741824\"}", + "elapsed_seconds": 2.242 + }, + { + "name": "forced-timeout", + "started_at": "2026-11-06T21:21:26.091820Z", + "observed": { + "attachment_id": "01a1b2bc-f161-7119-986f-bc7c8fd99bf0", + "error_code": "processing_failed", + "worker": "running" + }, + "result": "PASS", + "elapsed_seconds": 4.233 + }, + { + "name": "forced-memory", + "started_at": "2026-11-06T21:21:30.325405Z", + "observed": { + "attachment_id": "01a1b2bd-0192-70e7-a174-3275ca516e11", + "error_code": "processing_failed", + "worker": "running" + }, + "result": "PASS", + "elapsed_seconds": 4.766 + }, + { + "name": "normal-after-limits", + "started_at": "2026-11-06T21:21:38.218266Z", + "observed": { + "attachment_id": "01a1b2bd-13b0-712a-9275-1d3cdd2eb49a", + "variants": [ + "crop", + "optimized", + "thumbnail" + ] + }, + "result": "PASS", + "elapsed_seconds": 1.618 + } + ], + "conditions": { + "host_load": [ + 4.66455078125, + 3.70458984375, + 2.83203125 + ], + "containers": [ + "mtusi2026lab5-api-1 fc7d65385119 running Up 4 minutes (healthy)", + "mtusi2026lab5-api-2 a5411e55f06d running Up 4 minutes (healthy)", + "mtusi2026lab5-broker-1 a38bbcf03870 running Up 4 minutes (healthy)", + "mtusi2026lab5-lb-1 f0d01200b1f8 running Up 4 minutes (healthy)", + "mtusi2026lab5-migrate-1 feca425ac0ae exited Exited (0) 3 minutes ago", + "mtusi2026lab5-postgres-1 9f62ea9d176b running Up 59 seconds (healthy)", + "mtusi2026lab5-relay-1 4153c8488753 running Up 4 minutes (healthy)", + "mtusi2026lab5-s3-1 9a7684ef147a running Up 4 minutes (healthy)", + "mtusi2026lab5-s3-init-1 e5825f3eeafb exited Exited (0) 3 minutes ago", + "mtusi2026lab5-valkey-1 e37f783f9d50 running Up 4 minutes (healthy)", + "mtusi2026lab5-worker-1 ee8f9d678c2c running Up About a minute (healthy)" + ], + "running": "mtusi2026lab5-api-1 Up 4 minutes (healthy)\nmtusi2026lab5-relay-1 Up 4 minutes (healthy)\nmtusi2026lab5-api-2 Up 4 minutes (healthy)\nmtusi2026lab5-worker-1 Up About a minute (healthy)\nmtusi2026lab5-broker-1 Up 4 minutes (healthy)\nmtusi2026lab5-postgres-1 Up 59 seconds (healthy)\nmtusi2026lab5-lb-1 Up 4 minutes (healthy)\nmtusi2026lab5-s3-1 Up 4 minutes (healthy)\nmtusi2026lab5-valkey-1 Up 4 minutes (healthy)\n", + "worker_limits": "448\n30\n2\n" + }, + "large_observations": [ + { + "attachment_id": "01a1b2bc-cdc1-7315-82e0-39f3e53d87db", + "input_bytes": 35759, + "input_sha256": "e1238de6a5be9dbce36abee904f7233f8ff7be59e405b528671940630cce11f6", + "pixels": 40000000, + "status": "failed", + "error_code": "processing_failed", + "jobs": [ + { + "job_id": "01a1b2bc-cdc9-7157-b245-f357f81b4d6c", + "pipeline_version": 1, + "status": "failed", + "attempt": 1 + } + ], + "memory_peak": "541655040", + "memory_max": "1073741824" + }, + { + "attachment_id": "01a1b2bc-d211-7337-bd57-0ca1f3e33a0d", + "input_bytes": 46441, + "input_sha256": "64e665928c08ac3721324af4f8e2e9d2e98230dc1be389dde7bbf365650b08cd", + "pixels": 40000000, + "status": "failed", + "error_code": "processing_failed", + "jobs": [ + { + "job_id": "01a1b2bc-d21b-72a6-b463-0fa58bd353a2", + "pipeline_version": 1, + "status": "failed", + "attempt": 1 + } + ], + "memory_peak": "541655040", + "memory_max": "1073741824" + }, + { + "attachment_id": "01a1b2bc-d744-77c1-8352-989f80848cab", + "input_bytes": 103565, + "input_sha256": "b59784ae916d50b41b15afa4bdd474a8699f099da55efd53580d3f97180f3800", + "pixels": 40000000, + "status": "failed", + "error_code": "processing_failed", + "jobs": [ + { + "job_id": "01a1b2bc-d74e-7582-a9f8-fa827d36c9fe", + "pipeline_version": 1, + "status": "failed", + "attempt": 1 + } + ], + "memory_peak": "638119936", + "memory_max": "1073741824" + }, + { + "attachment_id": "01a1b2bc-dc37-7249-b7c3-f8901fb298de", + "input_bytes": 385445, + "input_sha256": "3c4418a6f6a7676298b30b70ebbde9d12929f1345152f4fae979caf5ba1cb3f7", + "pixels": 40000000, + "status": "failed", + "error_code": "processing_failed", + "jobs": [ + { + "job_id": "01a1b2bc-dc3f-7724-a737-43ad5584c8c7", + "pipeline_version": 1, + "status": "failed", + "attempt": 1 + } + ], + "memory_peak": "640196608", + "memory_max": "1073741824" + } + ], + "invariants": [ + { + "id": "terminal", + "statement": "every 202 reaches its expected terminal state", + "result": "PASS", + "details": { + "accepted": 7 + } + }, + { + "id": "single_effect", + "statement": "one variant set per (attachment_id, pipeline_version, variant)", + "result": "PASS", + "details": { + "rows": 0 + } + }, + { + "id": "no_ready_rollback", + "statement": "ready never returns to queued or processing", + "result": "PASS", + "details": { + "traced": 7 + } + }, + { + "id": "monotonic_publication", + "statement": "published_version only moves forward", + "result": "PASS", + "details": { + "sampled": 0 + } + }, + { + "id": "bytes_match_metadata", + "statement": "sha256, size and real dimensions match served bytes", + "result": "PASS", + "details": { + "verified": 1 + } + }, + { + "id": "bounded_attempts", + "statement": "attempt <= JOB_MAX_ATTEMPTS", + "result": "PASS", + "details": { + "rows": 0 + } + }, + { + "id": "no_orphans", + "statement": "no pending outbox, messages, dead letters, staging, objects", + "result": "FAIL", + "details": "staging kept after ready: [{'id': '01a1b2bd-13b0-712a-9275-1d3cdd2eb49a'}]" + }, + { + "id": "no_lost_202", + "statement": "every 202 is present in PostgreSQL and the API", + "result": "PASS", + "details": { + "accepted": 7 + } + } + ], + "accepted_ids": [ + "01a1b2bc-cdc1-7315-82e0-39f3e53d87db", + "01a1b2bc-d211-7337-bd57-0ca1f3e33a0d", + "01a1b2bc-d744-77c1-8352-989f80848cab", + "01a1b2bc-dc37-7249-b7c3-f8901fb298de", + "01a1b2bc-f161-7119-986f-bc7c8fd99bf0", + "01a1b2bd-0192-70e7-a174-3275ca516e11", + "01a1b2bd-13b0-712a-9275-1d3cdd2eb49a" + ], + "finished_at": "2026-11-06T21:21:42.105495Z", + "result": "FAIL" +} diff --git a/evidence/final-validation-2026-11-07/png-limits.txt b/evidence/final-validation-2026-11-07/png-limits.txt new file mode 100644 index 00000000..e2eabb66 --- /dev/null +++ b/evidence/final-validation-2026-11-07/png-limits.txt @@ -0,0 +1,11 @@ +date: 2026-11-06T21:21:18Z commit: b30e2f6a84419d1ca64525ffb40df92183cccaef +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-validation"} +$ .venv/bin/python evidence/final-validation-2026-11-07/targeted.py png-limits +gray2-40mp FAIL {"attachment_id": "01a1b2bc-cdc1-7315-82e0-39f3e53d87db", "input_bytes": 35759, "input_sha256": "e1238de6a5be9dbce36abee904f7233f8ff7be59e405b528671940630cce11f6", "pixels": 40000000, "status": "failed", "error_code": "processing_failed", "jobs": [{"job_id": "01a1b2bc-cdc9-7157-b245-f357f81b4d6c", "pipeline_version": 1, "status": "failed", "attempt": 1}], "memory_peak": "541655040", "memory_max": "1073741824"} +gray4-40mp FAIL {"attachment_id": "01a1b2bc-d211-7337-bd57-0ca1f3e33a0d", "input_bytes": 46441, "input_sha256": "64e665928c08ac3721324af4f8e2e9d2e98230dc1be389dde7bbf365650b08cd", "pixels": 40000000, "status": "failed", "error_code": "processing_failed", "jobs": [{"job_id": "01a1b2bc-d21b-72a6-b463-0fa58bd353a2", "pipeline_version": 1, "status": "failed", "attempt": 1}], "memory_peak": "541655040", "memory_max": "1073741824"} +gray16-40mp FAIL {"attachment_id": "01a1b2bc-d744-77c1-8352-989f80848cab", "input_bytes": 103565, "input_sha256": "b59784ae916d50b41b15afa4bdd474a8699f099da55efd53580d3f97180f3800", "pixels": 40000000, "status": "failed", "error_code": "processing_failed", "jobs": [{"job_id": "01a1b2bc-d74e-7582-a9f8-fa827d36c9fe", "pipeline_version": 1, "status": "failed", "attempt": 1}], "memory_peak": "638119936", "memory_max": "1073741824"} +rgb16-40mp FAIL {"attachment_id": "01a1b2bc-dc37-7249-b7c3-f8901fb298de", "input_bytes": 385445, "input_sha256": "3c4418a6f6a7676298b30b70ebbde9d12929f1345152f4fae979caf5ba1cb3f7", "pixels": 40000000, "status": "failed", "error_code": "processing_failed", "jobs": [{"job_id": "01a1b2bc-dc3f-7724-a737-43ad5584c8c7", "pipeline_version": 1, "status": "failed", "attempt": 1}], "memory_peak": "640196608", "memory_max": "1073741824"} +forced-timeout PASS +forced-memory PASS +normal-after-limits PASS +exit_code: 1 elapsed_seconds: 23.549 diff --git a/evidence/final-validation-2026-11-07/policy.txt b/evidence/final-validation-2026-11-07/policy.txt new file mode 100644 index 00000000..13a44440 --- /dev/null +++ b/evidence/final-validation-2026-11-07/policy.txt @@ -0,0 +1,7 @@ +date: 2026-11-06T21:17:55Z commit: b30e2f6a84419d1ca64525ffb40df92183cccaef +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-validation"} +$ docker compose exec -T broker rabbitmqctl -q list_policies -p messenger +vhost name pattern apply-to definition priority +messenger attachments-process ^attachments\.process$ queues {"dead-letter-exchange":"attachments.dlx","dead-letter-strategy":"at-least-once","delivery-limit":-1,"overflow":"reject-publish"} 10 +messenger attachments-dlq ^attachments\.process\.dlq$ queues {"max-length":100000,"overflow":"reject-publish"} 10 +exit_code: 0 elapsed_seconds: 0.598 diff --git a/evidence/final-validation-2026-11-07/postgres-outage-retry.json b/evidence/final-validation-2026-11-07/postgres-outage-retry.json new file mode 100644 index 00000000..faef9a49 --- /dev/null +++ b/evidence/final-validation-2026-11-07/postgres-outage-retry.json @@ -0,0 +1,199 @@ +{ + "mode": "postgres-outage-retry", + "source_sha": "b30e2f6a84419d1ca64525ffb40df92183cccaef", + "started_at": "2026-11-06T21:20:02.998079Z", + "cases": [ + { + "name": "published_outbox_database_outage", + "started_at": "2026-11-06T21:20:04.036200Z", + "observed": { + "attachment_id": "01a1b2bb-aa23-72ec-98b1-63582184109f", + "jobs_before": [ + { + "job_id": "01a1b2bb-aa2a-72d3-ad8b-623a79fcbed4", + "pipeline_version": 1, + "status": "queued", + "attempt": 1 + } + ], + "jobs_after": [ + { + "job_id": "01a1b2bb-aa2a-72d3-ad8b-623a79fcbed4", + "pipeline_version": 1, + "status": "done", + "attempt": 1 + } + ], + "requeues": 12, + "queues_during": { + "attachments.process": [ + 0, + 1 + ], + "attachments.process.dlq": [ + 15, + 0 + ] + }, + "queues_after": { + "attachments.process": [ + 0, + 0 + ], + "attachments.process.dlq": [ + 15, + 0 + ] + }, + "replay": false, + "stopped_containers": [ + "mtusi2026lab5-api-1 fc7d65385119 running Up 3 minutes (healthy)", + "mtusi2026lab5-api-2 a5411e55f06d running Up 3 minutes (healthy)", + "mtusi2026lab5-broker-1 a38bbcf03870 running Up 3 minutes (healthy)", + "mtusi2026lab5-lb-1 f0d01200b1f8 running Up 3 minutes (healthy)", + "mtusi2026lab5-migrate-1 feca425ac0ae exited Exited (0) About a minute ago", + "mtusi2026lab5-postgres-1 9f62ea9d176b exited Exited (0) Less than a second ago", + "mtusi2026lab5-relay-1 4153c8488753 running Up 3 minutes (healthy)", + "mtusi2026lab5-s3-1 9a7684ef147a running Up 3 minutes (healthy)", + "mtusi2026lab5-s3-init-1 e5825f3eeafb exited Exited (0) About a minute ago", + "mtusi2026lab5-valkey-1 e37f783f9d50 running Up 3 minutes (healthy)", + "mtusi2026lab5-worker-1 ee8f9d678c2c exited Exited (0) 1 second ago" + ] + }, + "result": "PASS", + "elapsed_seconds": 21.815 + } + ], + "conditions": { + "host_load": [ + 3.986328125, + 3.29931640625, + 2.619140625 + ], + "containers": [ + "mtusi2026lab5-api-1 fc7d65385119 running Up 3 minutes (healthy)", + "mtusi2026lab5-api-2 a5411e55f06d running Up 3 minutes (healthy)", + "mtusi2026lab5-broker-1 a38bbcf03870 running Up 3 minutes (healthy)", + "mtusi2026lab5-lb-1 f0d01200b1f8 running Up 3 minutes (healthy)", + "mtusi2026lab5-migrate-1 feca425ac0ae exited Exited (0) About a minute ago", + "mtusi2026lab5-postgres-1 9f62ea9d176b running Up About a minute (healthy)", + "mtusi2026lab5-relay-1 4153c8488753 running Up 3 minutes (healthy)", + "mtusi2026lab5-s3-1 9a7684ef147a running Up 3 minutes (healthy)", + "mtusi2026lab5-s3-init-1 e5825f3eeafb exited Exited (0) About a minute ago", + "mtusi2026lab5-valkey-1 e37f783f9d50 running Up 3 minutes (healthy)", + "mtusi2026lab5-worker-1 ee8f9d678c2c running Up About a minute (healthy)" + ], + "running": "mtusi2026lab5-api-1 Up 3 minutes (healthy)\nmtusi2026lab5-relay-1 Up 3 minutes (healthy)\nmtusi2026lab5-api-2 Up 3 minutes (healthy)\nmtusi2026lab5-worker-1 Up About a minute (healthy)\nmtusi2026lab5-broker-1 Up 3 minutes (healthy)\nmtusi2026lab5-postgres-1 Up About a minute (healthy)\nmtusi2026lab5-lb-1 Up 3 minutes (healthy)\nmtusi2026lab5-s3-1 Up 3 minutes (healthy)\nmtusi2026lab5-valkey-1 Up 3 minutes (healthy)\n", + "worker_limits": "448\n30\n2\n" + }, + "outage_checkpoint": { + "attachment_id": "01a1b2bb-aa23-72ec-98b1-63582184109f", + "jobs_before": [ + { + "job_id": "01a1b2bb-aa2a-72d3-ad8b-623a79fcbed4", + "pipeline_version": 1, + "status": "queued", + "attempt": 1 + } + ], + "dlq_before": [ + 15, + 0 + ], + "stopped_containers": [ + "mtusi2026lab5-api-1 fc7d65385119 running Up 3 minutes (healthy)", + "mtusi2026lab5-api-2 a5411e55f06d running Up 3 minutes (healthy)", + "mtusi2026lab5-broker-1 a38bbcf03870 running Up 3 minutes (healthy)", + "mtusi2026lab5-lb-1 f0d01200b1f8 running Up 3 minutes (healthy)", + "mtusi2026lab5-migrate-1 feca425ac0ae exited Exited (0) About a minute ago", + "mtusi2026lab5-postgres-1 9f62ea9d176b exited Exited (0) Less than a second ago", + "mtusi2026lab5-relay-1 4153c8488753 running Up 3 minutes (healthy)", + "mtusi2026lab5-s3-1 9a7684ef147a running Up 3 minutes (healthy)", + "mtusi2026lab5-s3-init-1 e5825f3eeafb exited Exited (0) About a minute ago", + "mtusi2026lab5-valkey-1 e37f783f9d50 running Up 3 minutes (healthy)", + "mtusi2026lab5-worker-1 ee8f9d678c2c exited Exited (0) 1 second ago" + ] + }, + "invariants": [ + { + "id": "terminal", + "statement": "every 202 reaches its expected terminal state", + "result": "PASS", + "details": { + "accepted": 1 + } + }, + { + "id": "single_effect", + "statement": "one variant set per (attachment_id, pipeline_version, variant)", + "result": "PASS", + "details": { + "rows": 0 + } + }, + { + "id": "no_ready_rollback", + "statement": "ready never returns to queued or processing", + "result": "PASS", + "details": { + "traced": 1 + } + }, + { + "id": "monotonic_publication", + "statement": "published_version only moves forward", + "result": "PASS", + "details": { + "sampled": 0 + } + }, + { + "id": "bytes_match_metadata", + "statement": "sha256, size and real dimensions match served bytes", + "result": "PASS", + "details": { + "verified": 1 + } + }, + { + "id": "bounded_attempts", + "statement": "attempt <= JOB_MAX_ATTEMPTS", + "result": "PASS", + "details": { + "rows": 0 + } + }, + { + "id": "no_orphans", + "statement": "no pending outbox, messages, dead letters, staging, objects", + "result": "PASS", + "details": { + "queues": { + "attachments.process": [ + 0, + 0 + ], + "attachments.process.dlq": [ + 15, + 0 + ] + }, + "s3_objects": 4, + "scoped_attachments": 1 + } + }, + { + "id": "no_lost_202", + "statement": "every 202 is present in PostgreSQL and the API", + "result": "PASS", + "details": { + "accepted": 1 + } + } + ], + "accepted_ids": [ + "01a1b2bb-aa23-72ec-98b1-63582184109f" + ], + "finished_at": "2026-11-06T21:20:30.164434Z", + "result": "PASS" +} diff --git a/evidence/final-validation-2026-11-07/postgres-outage-retry.txt b/evidence/final-validation-2026-11-07/postgres-outage-retry.txt new file mode 100644 index 00000000..f91fb102 --- /dev/null +++ b/evidence/final-validation-2026-11-07/postgres-outage-retry.txt @@ -0,0 +1,5 @@ +date: 2026-11-06T21:20:02Z commit: b30e2f6a84419d1ca64525ffb40df92183cccaef +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-validation"} +$ .venv/bin/python evidence/final-validation-2026-11-07/targeted.py postgres-outage-retry +published_outbox_database_outage PASS +exit_code: 0 elapsed_seconds: 27.330 diff --git a/evidence/final-validation-2026-11-07/postgres-outage.json b/evidence/final-validation-2026-11-07/postgres-outage.json new file mode 100644 index 00000000..8ddcdbe6 --- /dev/null +++ b/evidence/final-validation-2026-11-07/postgres-outage.json @@ -0,0 +1,146 @@ +{ + "mode": "postgres-outage", + "source_sha": "b30e2f6a84419d1ca64525ffb40df92183cccaef", + "started_at": "2026-11-06T21:18:09.131834Z", + "cases": [ + { + "name": "published_outbox_database_outage", + "started_at": "2026-11-06T21:18:10.870080Z", + "result": "FAIL", + "error": "timeout 90s waiting for 12 real database failures", + "elapsed_seconds": 97.081 + } + ], + "conditions": { + "host_load": [ + 3.3544921875, + 3.0048828125, + 2.4365234375 + ], + "containers": [ + "mtusi2026lab5-api-1 fc7d65385119 running Up About a minute (healthy)", + "mtusi2026lab5-api-2 a5411e55f06d running Up About a minute (healthy)", + "mtusi2026lab5-broker-1 a38bbcf03870 running Up About a minute (healthy)", + "mtusi2026lab5-lb-1 f0d01200b1f8 running Up About a minute (healthy)", + "mtusi2026lab5-migrate-1 feca425ac0ae exited Exited (0) About a minute ago", + "mtusi2026lab5-postgres-1 9f62ea9d176b running Up About a minute (healthy)", + "mtusi2026lab5-relay-1 4153c8488753 running Up About a minute (healthy)", + "mtusi2026lab5-s3-1 9a7684ef147a running Up About a minute (healthy)", + "mtusi2026lab5-s3-init-1 e5825f3eeafb exited Exited (0) About a minute ago", + "mtusi2026lab5-valkey-1 e37f783f9d50 running Up About a minute (healthy)", + "mtusi2026lab5-worker-1 ee8f9d678c2c running Up About a minute (healthy)" + ], + "running": "mtusi2026lab5-api-1 Up About a minute (healthy)\nmtusi2026lab5-relay-1 Up About a minute (healthy)\nmtusi2026lab5-api-2 Up About a minute (healthy)\nmtusi2026lab5-worker-1 Up About a minute (healthy)\nmtusi2026lab5-broker-1 Up About a minute (healthy)\nmtusi2026lab5-postgres-1 Up About a minute (healthy)\nmtusi2026lab5-lb-1 Up About a minute (healthy)\nmtusi2026lab5-s3-1 Up About a minute (healthy)\nmtusi2026lab5-valkey-1 Up About a minute (healthy)\nmtusi-lab5-test-valkey-a93cc36b Up About a minute\nmtusi-lab5-test-1de81872 Up About a minute\nmtusi-lab5-test-rustfs-62f3a9c3 Up About a minute\nmtusi-lab5-test-rabbitmq-675a32e8 Up 2 minutes\n", + "worker_limits": "448\n30\n2\n" + }, + "outage_checkpoint": { + "attachment_id": "01a1b2b9-f033-76be-ba05-897b08873abd", + "jobs_before": [ + { + "job_id": "01a1b2b9-f043-72e8-970c-647fc4a1f2e3", + "pipeline_version": 1, + "status": "queued", + "attempt": 1 + } + ], + "dlq_before": [ + 15, + 0 + ], + "stopped_containers": [ + "mtusi2026lab5-api-1 fc7d65385119 running Up About a minute (healthy)", + "mtusi2026lab5-api-2 a5411e55f06d running Up About a minute (healthy)", + "mtusi2026lab5-broker-1 a38bbcf03870 running Up About a minute (healthy)", + "mtusi2026lab5-lb-1 f0d01200b1f8 running Up About a minute (healthy)", + "mtusi2026lab5-migrate-1 feca425ac0ae exited Exited (0) About a minute ago", + "mtusi2026lab5-postgres-1 9f62ea9d176b exited Exited (0) Less than a second ago", + "mtusi2026lab5-relay-1 4153c8488753 running Up About a minute (healthy)", + "mtusi2026lab5-s3-1 9a7684ef147a running Up About a minute (healthy)", + "mtusi2026lab5-s3-init-1 e5825f3eeafb exited Exited (0) About a minute ago", + "mtusi2026lab5-valkey-1 e37f783f9d50 running Up About a minute (healthy)", + "mtusi2026lab5-worker-1 ee8f9d678c2c exited Exited (0) 1 second ago" + ] + }, + "invariants": [ + { + "id": "terminal", + "statement": "every 202 reaches its expected terminal state", + "result": "PASS", + "details": { + "accepted": 1 + } + }, + { + "id": "single_effect", + "statement": "one variant set per (attachment_id, pipeline_version, variant)", + "result": "PASS", + "details": { + "rows": 0 + } + }, + { + "id": "no_ready_rollback", + "statement": "ready never returns to queued or processing", + "result": "PASS", + "details": { + "traced": 1 + } + }, + { + "id": "monotonic_publication", + "statement": "published_version only moves forward", + "result": "PASS", + "details": { + "sampled": 0 + } + }, + { + "id": "bytes_match_metadata", + "statement": "sha256, size and real dimensions match served bytes", + "result": "PASS", + "details": { + "verified": 1 + } + }, + { + "id": "bounded_attempts", + "statement": "attempt <= JOB_MAX_ATTEMPTS", + "result": "PASS", + "details": { + "rows": 0 + } + }, + { + "id": "no_orphans", + "statement": "no pending outbox, messages, dead letters, staging, objects", + "result": "PASS", + "details": { + "queues": { + "attachments.process": [ + 0, + 0 + ], + "attachments.process.dlq": [ + 15, + 0 + ] + }, + "s3_objects": 4, + "scoped_attachments": 1 + } + }, + { + "id": "no_lost_202", + "statement": "every 202 is present in PostgreSQL and the API", + "result": "PASS", + "details": { + "accepted": 1 + } + } + ], + "accepted_ids": [ + "01a1b2b9-f033-76be-ba05-897b08873abd" + ], + "finished_at": "2026-11-06T21:19:52.189137Z", + "result": "FAIL" +} diff --git a/evidence/final-validation-2026-11-07/postgres-outage.txt b/evidence/final-validation-2026-11-07/postgres-outage.txt new file mode 100644 index 00000000..50ce3160 --- /dev/null +++ b/evidence/final-validation-2026-11-07/postgres-outage.txt @@ -0,0 +1,5 @@ +date: 2026-11-06T21:18:08Z commit: b30e2f6a84419d1ca64525ffb40df92183cccaef +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-validation"} +$ .venv/bin/python evidence/final-validation-2026-11-07/targeted.py postgres-outage +published_outbox_database_outage FAIL timeout 90s waiting for 12 real database failures +exit_code: 1 elapsed_seconds: 103.241 diff --git a/evidence/final-validation-2026-11-07/probe-copy-fixtures.txt b/evidence/final-validation-2026-11-07/probe-copy-fixtures.txt new file mode 100644 index 00000000..6e8d2d23 --- /dev/null +++ b/evidence/final-validation-2026-11-07/probe-copy-fixtures.txt @@ -0,0 +1,6 @@ +date: 2026-11-06T21:25:54Z commit: b30e2f6a84419d1ca64525ffb40df92183cccaef +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-validation"} +$ docker compose cp evidence/final-validation-2026-11-07/fixtures worker:/tmp/validation-fixtures + mtusi2026lab5-worker-1 copy evidence/final-validation-2026-11-07/fixtures to mtusi2026lab5-worker-1:/tmp/validation-fixtures Copying +Error response from daemon: container rootfs is marked read-only +exit_code: 1 elapsed_seconds: 0.081 diff --git a/evidence/final-validation-2026-11-07/probe-copy-script.txt b/evidence/final-validation-2026-11-07/probe-copy-script.txt new file mode 100644 index 00000000..2b63302c --- /dev/null +++ b/evidence/final-validation-2026-11-07/probe-copy-script.txt @@ -0,0 +1,6 @@ +date: 2026-11-06T21:25:54Z commit: b30e2f6a84419d1ca64525ffb40df92183cccaef +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-validation"} +$ docker compose cp evidence/final-validation-2026-11-07/resource-probe.py worker:/tmp/resource-probe.py + mtusi2026lab5-worker-1 copy evidence/final-validation-2026-11-07/resource-probe.py to mtusi2026lab5-worker-1:/tmp/resource-probe.py Copying +Error response from daemon: container rootfs is marked read-only +exit_code: 1 elapsed_seconds: 0.073 diff --git a/evidence/final-validation-2026-11-07/queues.txt b/evidence/final-validation-2026-11-07/queues.txt new file mode 100644 index 00000000..6f3b27d2 --- /dev/null +++ b/evidence/final-validation-2026-11-07/queues.txt @@ -0,0 +1,7 @@ +date: 2026-11-06T21:17:55Z commit: b30e2f6a84419d1ca64525ffb40df92183cccaef +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-validation"} +$ docker compose exec -T broker rabbitmqctl -q list_queues -p messenger name type durable policy effective_policy_definition messages_ready messages_unacknowledged +name type durable policy effective_policy_definition messages_ready messages_unacknowledged +attachments.process quorum true attachments-process [{<<"dead-letter-exchange">>, attachments.dlx}, {<<"dead-letter-strategy">>, at-least-once}, {<<"delivery-limit">>, -1}, {<<"overflow">>, reject-publish}] 0 0 +attachments.process.dlq quorum true attachments-dlq [{<<"max-length">>, 100000}, {<<"overflow">>, reject-publish}] 15 0 +exit_code: 0 elapsed_seconds: 0.578 diff --git a/evidence/final-validation-2026-11-07/recheck-cleanup.py b/evidence/final-validation-2026-11-07/recheck-cleanup.py new file mode 100644 index 00000000..1bf43116 --- /dev/null +++ b/evidence/final-validation-2026-11-07/recheck-cleanup.py @@ -0,0 +1,22 @@ +import json +import sys +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[2] +sys.path.insert(0, str(ROOT / 'scripts')) +import pipeline_suite as ps + +stack = ps.Stack(ps.arguments()) +report = json.loads(Path(__file__).with_name('png-limits.json').read_text()) +ids = report['accepted_ids'] +array = '{' + ','.join(ids) + '}' +rows = {name: stack.sql(name, ids=array) for name in ('pending_outbox', 'staging_left', 'nonterminal', 'duplicate_effects', 'object_keys')} +keys = {row['key'] for row in rows.pop('object_keys')} +objects = stack.objects(ids) +assert not any(rows.values()), rows +assert objects == keys, {'extra': sorted(objects - keys), 'missing': sorted(keys - objects)} +queues = stack.queues() +assert queues[ps.QUEUE] == (0, 0), queues +result = {'source_sha': ps.run(['git', 'rev-parse', 'HEAD']).strip(), 'at': ps.now(), 'result': 'PASS', 'accepted_ids': ids, 'rows': rows, 's3_objects': len(objects), 'queues': queues, 'reason': 'Read-only recheck after scheduled staging sweep; no scenario rerun. Initial no_orphans ran before the sweep.'} +Path(__file__).with_name('cleanup-recheck.json').write_text(json.dumps(result, indent=2) + '\n') +print(json.dumps(result, indent=2)) diff --git a/evidence/final-validation-2026-11-07/resource-probe-retry.txt b/evidence/final-validation-2026-11-07/resource-probe-retry.txt new file mode 100644 index 00000000..39aa9c15 --- /dev/null +++ b/evidence/final-validation-2026-11-07/resource-probe-retry.txt @@ -0,0 +1,12 @@ +date: 2026-11-06T21:26:09Z commit: b30e2f6a84419d1ca64525ffb40df92183cccaef +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-validation"} +$ python3 evidence/final-validation-2026-11-07/invoke-probe.py +{"file": "gray16-40mp.png", "transparency": true, "input_sha256": "b59784ae916d50b41b15afa4bdd474a8699f099da55efd53580d3f97180f3800", "limit_bytes": 469762048, "variants": ["thumbnail", "crop", "optimized"], "result": "ready", "max_rss_kib": 424820} +{"file": "gray16-40mp.png", "transparency": false, "input_sha256": "e3f239d818da5f02cd7b5d1cc4a2c542ed4fc4a7fbc604598500e7810e246e2f", "limit_bytes": 469762048, "variants": ["thumbnail", "crop", "optimized"], "result": "ready", "max_rss_kib": 429016} +{"file": "gray2-40mp.png", "transparency": true, "input_sha256": "e1238de6a5be9dbce36abee904f7233f8ff7be59e405b528671940630cce11f6", "limit_bytes": 469762048, "variants": ["thumbnail", "crop", "optimized"], "result": "ready", "max_rss_kib": 429148} +{"file": "gray2-40mp.png", "transparency": false, "input_sha256": "05c65f9a86b01f05b914b6f3f15fcfaf93b2ee4383bef3c3a60c19df1f5b5135", "limit_bytes": 469762048, "variants": ["thumbnail", "crop", "optimized"], "result": "ready", "max_rss_kib": 429148} +{"file": "gray4-40mp.png", "transparency": true, "input_sha256": "64e665928c08ac3721324af4f8e2e9d2e98230dc1be389dde7bbf365650b08cd", "limit_bytes": 469762048, "variants": ["thumbnail", "crop", "optimized"], "result": "ready", "max_rss_kib": 429148} +{"file": "gray4-40mp.png", "transparency": false, "input_sha256": "ff963c27cc6fdff1757fc9fa135b7b24ec2af67e042582024ebb88f2066ffaf5", "limit_bytes": 469762048, "variants": ["thumbnail", "crop", "optimized"], "result": "ready", "max_rss_kib": 429148} +{"file": "rgb16-40mp.png", "transparency": true, "input_sha256": "3c4418a6f6a7676298b30b70ebbde9d12929f1345152f4fae979caf5ba1cb3f7", "limit_bytes": 469762048, "error_type": "MemoryError", "frames": [{"function": "probe", "file": "resource-probe.py", "line": 26}, {"function": "render_variants", "file": "images.py", "line": 172}, {"function": "decoded", "file": "images.py", "line": 154}, {"function": "apply_png_transparency", "file": "images.py", "line": 111}, {"function": "rgb_mask", "file": "images.py", "line": 95}, {"function": "getchannel", "file": "Image.py", "line": 2823}], "max_rss_kib": 433500} +{"file": "rgb16-40mp.png", "transparency": false, "input_sha256": "f8082d24114c279ab0f9cab2a743e87147a322b7ad50eb402e689640b0761501", "limit_bytes": 469762048, "variants": ["thumbnail", "crop", "optimized"], "result": "ready", "max_rss_kib": 433500} +exit_code: 0 elapsed_seconds: 2.774 diff --git a/evidence/final-validation-2026-11-07/resource-probe-worker.py b/evidence/final-validation-2026-11-07/resource-probe-worker.py new file mode 100644 index 00000000..a9f75141 --- /dev/null +++ b/evidence/final-validation-2026-11-07/resource-probe-worker.py @@ -0,0 +1,42 @@ +import hashlib +import json +import resource +import traceback +import gc +import struct +from pathlib import Path + +from messenger.attachments.infrastructure.images import RenderLimits, render_variants + +import messenger.worker + +resource.setrlimit(resource.RLIMIT_AS, (448 << 20, 448 << 20)) +def without_trns(data): + result = data[:8] + offset = 8 + while offset < len(data): + size = struct.unpack('>I', data[offset:offset + 4])[0] + 12 + if data[offset + 4:offset + 8] != b'tRNS': + result += data[offset:offset + size] + offset += size + return result + + +def probe(path, data, transparency): + row = {'file': path.name, 'transparency': transparency, 'input_sha256': hashlib.sha256(data).hexdigest(), 'limit_bytes': 448 << 20} + try: + row['variants'] = [r.name for r in render_variants(data, RenderLimits(10485760, 40000000))] + row['result'] = 'ready' + except Exception as error: + row['error_type'] = type(error).__name__ + row['frames'] = [{'function': f.name, 'file': Path(f.filename).name, 'line': f.lineno} for f in traceback.extract_tb(error.__traceback__)] + row['max_rss_kib'] = resource.getrusage(resource.RUSAGE_SELF).ru_maxrss + print(json.dumps(row), flush=True) + + +for path in sorted(Path('/tmp/validation-fixtures').glob('*.png')): + data = path.read_bytes() + probe(path, data, True) + gc.collect() + probe(path, without_trns(data), False) + gc.collect() diff --git a/evidence/final-validation-2026-11-07/resource-probe-worker.txt b/evidence/final-validation-2026-11-07/resource-probe-worker.txt new file mode 100644 index 00000000..2d2235e7 --- /dev/null +++ b/evidence/final-validation-2026-11-07/resource-probe-worker.txt @@ -0,0 +1,12 @@ +date: 2026-11-06T21:26:40Z commit: b30e2f6a84419d1ca64525ffb40df92183cccaef +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-validation"} +$ python3 evidence/final-validation-2026-11-07/invoke-probe.py resource-probe-worker.py +{"file": "gray16-40mp.png", "transparency": true, "input_sha256": "b59784ae916d50b41b15afa4bdd474a8699f099da55efd53580d3f97180f3800", "limit_bytes": 469762048, "error_type": "MemoryError", "frames": [{"function": "probe", "file": "resource-probe.py", "line": 28}, {"function": "render_variants", "file": "images.py", "line": 172}, {"function": "decoded", "file": "images.py", "line": 160}, {"function": "flatten", "file": "images.py", "line": 124}, {"function": "point", "file": "Image.py", "line": 2038}], "max_rss_kib": 426640} +{"file": "gray16-40mp.png", "transparency": false, "input_sha256": "e3f239d818da5f02cd7b5d1cc4a2c542ed4fc4a7fbc604598500e7810e246e2f", "limit_bytes": 469762048, "error_type": "MemoryError", "frames": [{"function": "probe", "file": "resource-probe.py", "line": 28}, {"function": "render_variants", "file": "images.py", "line": 172}, {"function": "decoded", "file": "images.py", "line": 160}, {"function": "flatten", "file": "images.py", "line": 124}, {"function": "point", "file": "Image.py", "line": 2038}], "max_rss_kib": 426640} +{"file": "gray2-40mp.png", "transparency": true, "input_sha256": "e1238de6a5be9dbce36abee904f7233f8ff7be59e405b528671940630cce11f6", "limit_bytes": 469762048, "error_type": "MemoryError", "frames": [{"function": "probe", "file": "resource-probe.py", "line": 28}, {"function": "render_variants", "file": "images.py", "line": 172}, {"function": "decoded", "file": "images.py", "line": 160}, {"function": "flatten", "file": "images.py", "line": 128}, {"function": "new", "file": "Image.py", "line": 3254}], "max_rss_kib": 426640} +{"file": "gray2-40mp.png", "transparency": false, "input_sha256": "05c65f9a86b01f05b914b6f3f15fcfaf93b2ee4383bef3c3a60c19df1f5b5135", "limit_bytes": 469762048, "variants": ["thumbnail", "crop", "optimized"], "result": "ready", "max_rss_kib": 426640} +{"file": "gray4-40mp.png", "transparency": true, "input_sha256": "64e665928c08ac3721324af4f8e2e9d2e98230dc1be389dde7bbf365650b08cd", "limit_bytes": 469762048, "error_type": "MemoryError", "frames": [{"function": "probe", "file": "resource-probe.py", "line": 28}, {"function": "render_variants", "file": "images.py", "line": 172}, {"function": "decoded", "file": "images.py", "line": 160}, {"function": "flatten", "file": "images.py", "line": 128}, {"function": "new", "file": "Image.py", "line": 3254}], "max_rss_kib": 426640} +{"file": "gray4-40mp.png", "transparency": false, "input_sha256": "ff963c27cc6fdff1757fc9fa135b7b24ec2af67e042582024ebb88f2066ffaf5", "limit_bytes": 469762048, "variants": ["thumbnail", "crop", "optimized"], "result": "ready", "max_rss_kib": 426640} +{"file": "rgb16-40mp.png", "transparency": true, "input_sha256": "3c4418a6f6a7676298b30b70ebbde9d12929f1345152f4fae979caf5ba1cb3f7", "limit_bytes": 469762048, "error_type": "MemoryError", "frames": [{"function": "probe", "file": "resource-probe.py", "line": 28}, {"function": "render_variants", "file": "images.py", "line": 172}, {"function": "decoded", "file": "images.py", "line": 154}, {"function": "apply_png_transparency", "file": "images.py", "line": 111}, {"function": "rgb_mask", "file": "images.py", "line": 95}, {"function": "getchannel", "file": "Image.py", "line": 2814}, {"function": "load", "file": "ImageFile.py", "line": 370}, {"function": "load_prepare", "file": "PngImagePlugin.py", "line": 1010}, {"function": "load_prepare", "file": "ImageFile.py", "line": 451}], "max_rss_kib": 426640} +{"file": "rgb16-40mp.png", "transparency": false, "input_sha256": "f8082d24114c279ab0f9cab2a743e87147a322b7ad50eb402e689640b0761501", "limit_bytes": 469762048, "variants": ["thumbnail", "crop", "optimized"], "result": "ready", "max_rss_kib": 426640} +exit_code: 0 elapsed_seconds: 2.418 diff --git a/evidence/final-validation-2026-11-07/resource-probe.py b/evidence/final-validation-2026-11-07/resource-probe.py new file mode 100644 index 00000000..4be3d56c --- /dev/null +++ b/evidence/final-validation-2026-11-07/resource-probe.py @@ -0,0 +1,40 @@ +import hashlib +import json +import resource +import traceback +import gc +import struct +from pathlib import Path + +from messenger.attachments.infrastructure.images import RenderLimits, render_variants + +resource.setrlimit(resource.RLIMIT_AS, (448 << 20, 448 << 20)) +def without_trns(data): + result = data[:8] + offset = 8 + while offset < len(data): + size = struct.unpack('>I', data[offset:offset + 4])[0] + 12 + if data[offset + 4:offset + 8] != b'tRNS': + result += data[offset:offset + size] + offset += size + return result + + +def probe(path, data, transparency): + row = {'file': path.name, 'transparency': transparency, 'input_sha256': hashlib.sha256(data).hexdigest(), 'limit_bytes': 448 << 20} + try: + row['variants'] = [r.name for r in render_variants(data, RenderLimits(10485760, 40000000))] + row['result'] = 'ready' + except Exception as error: + row['error_type'] = type(error).__name__ + row['frames'] = [{'function': f.name, 'file': Path(f.filename).name, 'line': f.lineno} for f in traceback.extract_tb(error.__traceback__)] + row['max_rss_kib'] = resource.getrusage(resource.RUSAGE_SELF).ru_maxrss + print(json.dumps(row), flush=True) + + +for path in sorted(Path('/tmp/validation-fixtures').glob('*.png')): + data = path.read_bytes() + probe(path, data, True) + gc.collect() + probe(path, without_trns(data), False) + gc.collect() diff --git a/evidence/final-validation-2026-11-07/resource-probe.txt b/evidence/final-validation-2026-11-07/resource-probe.txt new file mode 100644 index 00000000..c04c5ac4 --- /dev/null +++ b/evidence/final-validation-2026-11-07/resource-probe.txt @@ -0,0 +1,5 @@ +date: 2026-11-06T21:25:54Z commit: b30e2f6a84419d1ca64525ffb40df92183cccaef +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-validation"} +$ docker compose exec -T worker python /tmp/resource-probe.py +python: can't open file '/tmp/resource-probe.py': [Errno 2] No such file or directory +exit_code: 2 elapsed_seconds: 0.107 diff --git a/evidence/final-validation-2026-11-07/retained-volumes.txt b/evidence/final-validation-2026-11-07/retained-volumes.txt new file mode 100644 index 00000000..0353e8a1 --- /dev/null +++ b/evidence/final-validation-2026-11-07/retained-volumes.txt @@ -0,0 +1,8 @@ +date: 2026-11-06T21:27:03Z commit: b30e2f6a84419d1ca64525ffb40df92183cccaef +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-validation"} +$ docker volume ls --filter label=com.docker.compose.project=mtusi2026lab5 --format '{{.Name}}' +mtusi2026lab5_broker-data +mtusi2026lab5_pgdata +mtusi2026lab5_s3data +mtusi2026lab5_valkeydata +exit_code: 0 elapsed_seconds: 0.017 diff --git a/evidence/final-validation-2026-11-07/running-containers-after.txt b/evidence/final-validation-2026-11-07/running-containers-after.txt new file mode 100644 index 00000000..64aab809 --- /dev/null +++ b/evidence/final-validation-2026-11-07/running-containers-after.txt @@ -0,0 +1,4 @@ +date: 2026-11-06T21:27:03Z commit: b30e2f6a84419d1ca64525ffb40df92183cccaef +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-validation"} +$ docker ps --format '{{.Names}} {{.Status}}' +exit_code: 0 elapsed_seconds: 0.018 diff --git a/evidence/final-validation-2026-11-07/runtime-containers.json b/evidence/final-validation-2026-11-07/runtime-containers.json new file mode 100644 index 00000000..332e542b --- /dev/null +++ b/evidence/final-validation-2026-11-07/runtime-containers.json @@ -0,0 +1,167 @@ +[ + { + "name": "/mtusi2026lab5-api-1", + "id": "fc7d65385119449e1e81f5158ddcb2970a4d15a8f0dcc592b7f4cc5d975b4a94", + "image": "sha256:9293b3138e99506510e947ba0cfc77ed4301f96344dd937d51d03e8c258121f2", + "limits": { + "Memory": 536870912, + "NanoCpus": 1000000000, + "PortBindings": {} + }, + "mounts": [] + }, + { + "name": "/mtusi2026lab5-relay-1", + "id": "4153c8488753a4557fdd65b30243cfe772d1d0cc89abfd443a7f92de2f62d183", + "image": "sha256:9293b3138e99506510e947ba0cfc77ed4301f96344dd937d51d03e8c258121f2", + "limits": { + "Memory": 201326592, + "NanoCpus": 500000000, + "PortBindings": {} + }, + "mounts": [] + }, + { + "name": "/mtusi2026lab5-api-2", + "id": "a5411e55f06d7b51a6570392751f230afb401748d8da638d2e374d30d70efbe5", + "image": "sha256:9293b3138e99506510e947ba0cfc77ed4301f96344dd937d51d03e8c258121f2", + "limits": { + "Memory": 536870912, + "NanoCpus": 1000000000, + "PortBindings": {} + }, + "mounts": [] + }, + { + "name": "/mtusi2026lab5-worker-1", + "id": "ee8f9d678c2c7e910adef08271f9327710a82050e22358b802a3fa5c207f4453", + "image": "sha256:9293b3138e99506510e947ba0cfc77ed4301f96344dd937d51d03e8c258121f2", + "limits": { + "Memory": 1073741824, + "NanoCpus": 2000000000, + "PortBindings": {} + }, + "mounts": [] + }, + { + "name": "/mtusi2026lab5-migrate-1", + "id": "feca425ac0ae5529007e3cb975c873bef4f882ad5aa71abdb1e198397f403e50", + "image": "sha256:9293b3138e99506510e947ba0cfc77ed4301f96344dd937d51d03e8c258121f2", + "limits": { + "Memory": 268435456, + "NanoCpus": 500000000, + "PortBindings": {} + }, + "mounts": [] + }, + { + "name": "/mtusi2026lab5-s3-init-1", + "id": "e5825f3eeafb6c2412d36cde84cfdbf2d69ff02649403e5978557239f854c36c", + "image": "sha256:ab024bfebee49a750ce886b4c70963ccd9ddaa03f491704a90710641d7a26699", + "limits": { + "Memory": 67108864, + "NanoCpus": 500000000, + "PortBindings": {} + }, + "mounts": [] + }, + { + "name": "/mtusi2026lab5-broker-1", + "id": "a38bbcf038702b1a8063120379ca2341868f0982f70d62f3113046aab641d209", + "image": "sha256:54ef5ff505352c1beef05a97ee9bd6ab95b3559a76629ba0119b1d63d8d6e4b2", + "limits": { + "Memory": 536870912, + "NanoCpus": 1000000000, + "PortBindings": { + "15672/tcp": [ + { + "HostIp": "127.0.0.1", + "HostPort": "25086" + } + ] + } + }, + "mounts": [ + { + "name": "mtusi2026lab5_broker-data", + "type": "volume", + "destination": "/var/lib/rabbitmq" + } + ] + }, + { + "name": "/mtusi2026lab5-postgres-1", + "id": "9f62ea9d176b033a9a2218fe15bda597484114af3dc26bc7fdc576b4094d79bd", + "image": "sha256:266d3c257594e195b309ae9d1805e54c788f1d7b375f56bf6c367aac6c917e7b", + "limits": { + "Memory": 1073741824, + "NanoCpus": 2000000000, + "PortBindings": {} + }, + "mounts": [ + { + "name": "mtusi2026lab5_pgdata", + "type": "volume", + "destination": "/var/lib/postgresql/data" + } + ] + }, + { + "name": "/mtusi2026lab5-lb-1", + "id": "f0d01200b1f88a204c983e37cc078fcc08e54fda9151ca82a3630cd714b2d6f9", + "image": "sha256:5893840576071e6217cd52ebdcc14f454c6f7a631056fa6f4e0f40d3cac4215b", + "limits": { + "Memory": 134217728, + "NanoCpus": 1000000000, + "PortBindings": { + "8080/tcp": [ + { + "HostIp": "127.0.0.1", + "HostPort": "18085" + } + ], + "8404/tcp": [ + { + "HostIp": "127.0.0.1", + "HostPort": "25085" + } + ] + } + }, + "mounts": [] + }, + { + "name": "/mtusi2026lab5-s3-1", + "id": "9a7684ef147aace715f79446f6e490b40df0c105f1f4d529f5aef9270540aedb", + "image": "sha256:ed9210d6411d77ffceb70d94b964a3cb7d225983368bc25bebe01e995293dcc2", + "limits": { + "Memory": 536870912, + "NanoCpus": 1000000000, + "PortBindings": {} + }, + "mounts": [ + { + "name": "mtusi2026lab5_s3data", + "type": "volume", + "destination": "/data" + } + ] + }, + { + "name": "/mtusi2026lab5-valkey-1", + "id": "e37f783f9d5014b4f9d96260df10abf1faa26d6373fb6b2487f15340715e9a64", + "image": "sha256:2602ace2be6569bc2bbb06f873776516ab9089821525be34f4305c67eb9db02a", + "limits": { + "Memory": 134217728, + "NanoCpus": 500000000, + "PortBindings": {} + }, + "mounts": [ + { + "name": "mtusi2026lab5_valkeydata", + "type": "volume", + "destination": "/data" + } + ] + } +] diff --git a/evidence/final-validation-2026-11-07/scan-secrets.py b/evidence/final-validation-2026-11-07/scan-secrets.py new file mode 100644 index 00000000..43d20147 --- /dev/null +++ b/evidence/final-validation-2026-11-07/scan-secrets.py @@ -0,0 +1,46 @@ +import json +import re +import subprocess +from pathlib import Path + +ROOT = Path.cwd() +files = set(subprocess.check_output(['git', 'ls-files', '-z']).decode().split('\0')) - {''} +files.update(str(p) for p in Path('evidence/final-validation-2026-11-07').rglob('*') if p.is_file()) +patterns = { + 'private_key': r'-----BEGIN (?:RSA |EC |OPENSSH )?PRIVATE KEY-----', + 'github_token': r'\b(?:gh[pousr]_[A-Za-z0-9]{30,}|github_pat_[A-Za-z0-9_]{50,})\b', + 'openai_token': r'\bsk-(?:proj-)?[A-Za-z0-9_-]{35,}\b', + 'aws_key': r'\b(?:AKIA|ASIA)[A-Z0-9]{16}\b', + 'telegram_token': r'\b[0-9]{8,12}:[A-Za-z0-9_-]{35}\b', + 'bearer_literal': r'Bearer [A-Za-z0-9_-]{24,}', + 'credential_url': r'\b(?:amqps?|postgres(?:ql)?|redis|https?)://[^\s\"\'{}$<>:/]+:[^\s\"\'{}$<>@/]+@', + 'secret_literal': r'''["'](?:password|secret|token|access_token|secret_access_key)["']\s*:\s*["'][A-Za-z0-9_+/=-]{24,}["']''', +} +allow = { + ('contracts/examples.json', 5, 'secret_literal'): 'unchanged skeleton example placeholder', + ('contracts/openapi.json', 3096, 'secret_literal'): 'unchanged skeleton example placeholder', + ('examples/requests.http', 20, 'secret_literal'): 'unchanged skeleton example placeholder', + ('scripts/broker-secrets.sh', 17, 'credential_url'): 'printf format; no credential literal', + ('student-tests/api/test_operability.py', 131, 'credential_url'): 'synthetic unavailable endpoint u:p', + ('student-tests/api/test_operability.py', 143, 'credential_url'): 'synthetic unavailable endpoint u:p', + ('student-tests/conftest.py', 141, 'credential_url'): 'ephemeral test database literal', +} +findings = [] +for name in sorted(files): + if re.search(r'(^|/)(?:\.env|secrets|volumes)(?:/|$)', name): + findings.append({'file': name, 'rule': 'forbidden_path'}) + try: + text = Path(name).read_text() + except (UnicodeDecodeError, OSError): + continue + for rule, pattern in patterns.items(): + for match in re.finditer(pattern, text): + line = text.count('\n', 0, match.start()) + 1 + item = {'file': name, 'line': line, 'rule': rule} + if (name, line, rule) in allow: + item['reviewed_non_secret'] = allow[name, line, rule] + findings.append(item) +report = {'files_scanned': len(files), 'patterns': list(patterns), 'candidates': findings, 'unresolved': sum('reviewed_non_secret' not in f for f in findings)} +Path('evidence/final-validation-2026-11-07/secret-scan.json').write_text(json.dumps(report, indent=2) + '\n') +print(json.dumps(report, indent=2)) +raise SystemExit(bool(report['unresolved'])) diff --git a/evidence/final-validation-2026-11-07/secret-scan.json b/evidence/final-validation-2026-11-07/secret-scan.json new file mode 100644 index 00000000..ca2bc84f --- /dev/null +++ b/evidence/final-validation-2026-11-07/secret-scan.json @@ -0,0 +1,58 @@ +{ + "files_scanned": 739, + "patterns": [ + "private_key", + "github_token", + "openai_token", + "aws_key", + "telegram_token", + "bearer_literal", + "credential_url", + "secret_literal" + ], + "candidates": [ + { + "file": "contracts/examples.json", + "line": 5, + "rule": "secret_literal", + "reviewed_non_secret": "unchanged skeleton example placeholder" + }, + { + "file": "contracts/openapi.json", + "line": 3096, + "rule": "secret_literal", + "reviewed_non_secret": "unchanged skeleton example placeholder" + }, + { + "file": "examples/requests.http", + "line": 20, + "rule": "secret_literal", + "reviewed_non_secret": "unchanged skeleton example placeholder" + }, + { + "file": "scripts/broker-secrets.sh", + "line": 17, + "rule": "credential_url", + "reviewed_non_secret": "printf format; no credential literal" + }, + { + "file": "student-tests/api/test_operability.py", + "line": 131, + "rule": "credential_url", + "reviewed_non_secret": "synthetic unavailable endpoint u:p" + }, + { + "file": "student-tests/api/test_operability.py", + "line": 143, + "rule": "credential_url", + "reviewed_non_secret": "synthetic unavailable endpoint u:p" + }, + { + "file": "student-tests/conftest.py", + "line": 141, + "rule": "credential_url", + "reviewed_non_secret": "ephemeral test database literal" + } + ], + "unresolved": 0 +} diff --git a/evidence/final-validation-2026-11-07/sha256.json b/evidence/final-validation-2026-11-07/sha256.json new file mode 100644 index 00000000..12b4f2f7 --- /dev/null +++ b/evidence/final-validation-2026-11-07/sha256.json @@ -0,0 +1,55 @@ +{ + "evidence/final-validation-2026-11-07/targeted.py": "0ef9974190761b0226f0c87ba3196f360fa0cb7f9761da14790da0747200b871", + "evidence/final-validation-2026-11-07/student-test.txt": "299662f32cd80c0c69e1b4f281b97a38c9d81c44be2501dda6a3be02df692ab8", + "evidence/final-validation-2026-11-07/targeted-initial.py": "5ccd725d3d07f82d53b8ee2f7f3614cd22f354891b6c220cb5572f8eb94b64dc", + "evidence/final-validation-2026-11-07/audit.json": "6f1202bc4c225513a3cf65f4661f57dff02fa03eb1d3b30e15221096e31b4344", + "evidence/final-validation-2026-11-07/final-containers.txt": "eca334ad0581d40039451984bbd5a294adb3367a605f75366b8dddd946006be4", + "evidence/final-validation-2026-11-07/down.txt": "994c14a80ffafc46a7a51b16af856cbfdfe4bc518ade4b0d85a1809ed4cf446f", + "evidence/final-validation-2026-11-07/stopped-containers.txt": "5e32c5318af95dd450c8bd7420c8cd87e7c63a54cfef0e87d1e62aeef4b73771", + "evidence/final-validation-2026-11-07/resource-probe-worker.py": "e0fd41c717ef20143f9b7433197ec4007c23bcb047a20d6f884eda7ba47735f8", + "evidence/final-validation-2026-11-07/postgres-outage.json": "6ef2b1a692692d073d5095e308633a57b3f8b77c907ef2a005c3de7405bd03b2", + "evidence/final-validation-2026-11-07/recheck-cleanup.py": "d976b607d40be26b2fc9d2ed1a330bc517b099ffce10eff0756629f85ab30a44", + "evidence/final-validation-2026-11-07/png-limits.txt": "ec52bf98f582f1db46a573ab2c8f9097108adb55ec8c5ebab653fb22a45ad216", + "evidence/final-validation-2026-11-07/postgres-outage.txt": "03ae2413b4d24ca545fe7118dfbca42e19c787df082085be09b57881e8c6ef3b", + "evidence/final-validation-2026-11-07/resource-probe-retry.txt": "d2ce23c775e6b460c16ef30fb9ade683508c05a5cfbf700cb2f8f2b5f30ded47", + "evidence/final-validation-2026-11-07/postgres-outage-worker.log": "860a8f2c3a41efa2068cd2c0f614c02e605af50b12f13118c0b4f8bba5d0949d", + "evidence/final-validation-2026-11-07/final-doc-audit.json": "ed0950f9a15a0a42ae8c2165d6189a158561949e7f1347d4ced82fd2ccf4d72b", + "evidence/final-validation-2026-11-07/invoke-probe.py": "fb4a472315b5b08fa8b312868241902cb3ca827ca4af8fdaf7aabac57722476d", + "evidence/final-validation-2026-11-07/runtime-containers.json": "85da009405a52ea1654d6cb396ef9b7a16cd50c37a09888f3ff9c3a358255b4b", + "evidence/final-validation-2026-11-07/png-http.txt": "bf399ba45062574f2c7295dfb5255cde84065b2c621d34e91c0682c96ce88c8f", + "evidence/final-validation-2026-11-07/build.txt": "12dd0f1dcb5aab6a5ef66aa8aa88466f35ed5d4e6b46c01c4048ef269d260d1f", + "evidence/final-validation-2026-11-07/up.txt": "8089a2eacd964d323f040fabee30988d68287b86bffdfb107b7a231b63b4b914", + "evidence/final-validation-2026-11-07/probe-copy-fixtures.txt": "f0e163372b70e3550047572dc5d293c73fb971fcb22e84570983a98d41c21297", + "evidence/final-validation-2026-11-07/policy.txt": "f47b54dd4b522870ddd464d62a0076bd4fdd7793506834af83167af4d75738b2", + "evidence/final-validation-2026-11-07/running-containers-after.txt": "aea44e7b644394fe4dffc8d50afe64ae3189f9c0d1221530e6320e095ee9bd1b", + "evidence/final-validation-2026-11-07/cleanup-recheck.json": "dc6162f26b2aa3ec219c2a323bd38fecb7700e10fc1ac26db3b73c6df56c8442", + "evidence/final-validation-2026-11-07/checks-final.txt": "c3c7720032cb1ddd357056fb5ceffd481d5b918ca2c618570fef2276341713c4", + "evidence/final-validation-2026-11-07/probe-copy-script.txt": "b41b5bbc44740bf143c6a7b3ecd0a11b5278be0c7949085c329c124837a1dc31", + "evidence/final-validation-2026-11-07/postgres-outage-retry.txt": "48191931290985ab5ee3a4f606f5871e751af74d92262d9a95375f845a8e528b", + "evidence/final-validation-2026-11-07/png-limits.json": "ead7292827f5da0bf87e7d2209c5db26738361b61332b5ae2dd1855a3220f89f", + "evidence/final-validation-2026-11-07/delivery-targeted.json": "087921045c843d5ef6b9519ad23ccc4e35fbafa8d0b526fd17b57f2dcc89f2b8", + "evidence/final-validation-2026-11-07/delivery-targeted.txt": "ab62360225b4cff3cd99f51abbccd637101699070c4237d672cb198b77a5f9f0", + "evidence/final-validation-2026-11-07/findings.json": "1bee1d38c4975c2a5b282131de001a7406751e2373ce29908ad49baf64754f83", + "evidence/final-validation-2026-11-07/RESULTS.md": "4d918715650d58f320e0884b17c1d9e32276f07c741d515f2c10ee5f18c583cc", + "evidence/final-validation-2026-11-07/secret-scan.json": "c2ffa9e63666c64f1d2e11fc0058c462636a65db0d4466fcce56750b569cbae9", + "evidence/final-validation-2026-11-07/scan-secrets.py": "de87d9de67d0d8addab791b45725b8afe96dfb3bf84fa1d6bec46b7850494e79", + "evidence/final-validation-2026-11-07/cleanup-recheck.txt": "238e1c1d2eb739b105f621198c1cce3614d1cbf5f7a01ebaf30a9edbfc84fa93", + "evidence/final-validation-2026-11-07/retained-volumes.txt": "dfa358841d4bd6258e01a9d19756596ccfafcc64338a2f1336be41db557ea1ff", + "evidence/final-validation-2026-11-07/env.sh": "06cc16c51f3ea5fe5bc703a1c4c44901a1c079a452c4df57e723f0f30f7b666a", + "evidence/final-validation-2026-11-07/queues.txt": "269a2934d5b03d25c1028b1677dc7a57b7444bba646ffbb46d374473858cde9e", + "evidence/final-validation-2026-11-07/resource-probe-worker.txt": "d3e1e5cfef280cbaddbd915ffee91a109ddf2e19e7fc4771333b79826b95e587", + "evidence/final-validation-2026-11-07/resource-probe.txt": "5c4dc9697e8bbfcfd897375ec346c48ade105bdabc4a068406785eac89056df0", + "evidence/final-validation-2026-11-07/historical-hashes.json": "865452375e881103a36f9991388a33ae20ca957718222e474f50778bedca53b7", + "evidence/final-validation-2026-11-07/openspec.txt": "87a9b001f1780bca8d822372eb43d8b1b6225b66380a235c573a8c12f235f033", + "evidence/final-validation-2026-11-07/checks.txt": "f04184507396267b800955824155b4adc52fc561ca7c4427b195b0a28ef0a78d", + "evidence/final-validation-2026-11-07/active-changes.txt": "f75e218e916653ad195abc458a187238930ee0cb74b3dff3bceff633f63b3a2f", + "evidence/final-validation-2026-11-07/postgres-outage-retry.json": "efd5a60a6d8ac1f0b927f8e4dae35183444c887b12bbc76efc589d4b60b3b608", + "evidence/final-validation-2026-11-07/smoke.txt": "f667f89d95ccfc52ac942cae11c2cdd6bfc8d1a192eb9cdf1b24f3ba02a8888d", + "evidence/final-validation-2026-11-07/image-runtime.txt": "89b07842b945ac8873e6077a51782be7642b9f36e3fc45bacf5e2811ef1bd90d", + "evidence/final-validation-2026-11-07/resource-probe.py": "5ac1b3087a22ce8c9b0d3e988b78a8c5ae385436ef5b8cdf2ccb57fe1a0a0359", + "evidence/final-validation-2026-11-07/png-http.json": "8871e5adc7c030edaf8357807597e8f38045d24ca6e20825e73864392451596d", + "evidence/final-validation-2026-11-07/fixtures/rgb16-40mp.png": "3c4418a6f6a7676298b30b70ebbde9d12929f1345152f4fae979caf5ba1cb3f7", + "evidence/final-validation-2026-11-07/fixtures/gray4-40mp.png": "64e665928c08ac3721324af4f8e2e9d2e98230dc1be389dde7bbf365650b08cd", + "evidence/final-validation-2026-11-07/fixtures/gray2-40mp.png": "e1238de6a5be9dbce36abee904f7233f8ff7be59e405b528671940630cce11f6", + "evidence/final-validation-2026-11-07/fixtures/gray16-40mp.png": "b59784ae916d50b41b15afa4bdd474a8699f099da55efd53580d3f97180f3800" +} diff --git a/evidence/final-validation-2026-11-07/smoke.txt b/evidence/final-validation-2026-11-07/smoke.txt new file mode 100644 index 00000000..5811fcfc --- /dev/null +++ b/evidence/final-validation-2026-11-07/smoke.txt @@ -0,0 +1,6 @@ +date: 2026-11-06T21:17:56Z commit: b30e2f6a84419d1ca64525ffb40df92183cccaef +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-validation"} +$ make test +python3 tests/smoke.py --base-url "http://127.0.0.1:18085" +PASS: lab5 public API scenario; infrastructure and grading evidence remain separate. +exit_code: 0 elapsed_seconds: 1.723 diff --git a/evidence/final-validation-2026-11-07/stopped-containers.txt b/evidence/final-validation-2026-11-07/stopped-containers.txt new file mode 100644 index 00000000..bc486ec9 --- /dev/null +++ b/evidence/final-validation-2026-11-07/stopped-containers.txt @@ -0,0 +1,4 @@ +date: 2026-11-06T21:27:02Z commit: b30e2f6a84419d1ca64525ffb40df92183cccaef +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-validation"} +$ docker ps -a --filter label=com.docker.compose.project=mtusi2026lab5 --format '{{.Names}} {{.Status}}' +exit_code: 0 elapsed_seconds: 0.020 diff --git a/evidence/final-validation-2026-11-07/student-test.txt b/evidence/final-validation-2026-11-07/student-test.txt new file mode 100644 index 00000000..16c93297 --- /dev/null +++ b/evidence/final-validation-2026-11-07/student-test.txt @@ -0,0 +1,20 @@ +date: 2026-11-06T21:15:34Z commit: b30e2f6a84419d1ca64525ffb40df92183cccaef +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-validation"} +$ make student-test 'PYTEST_ARGS=-q --tb=short' +.venv/bin/pytest -q --tb=short +........................................................................ [ 7%] +........................................................................ [ 14%] +........................................................................ [ 22%] +........................................................................ [ 29%] +........................................................................ [ 36%] +........................................................................ [ 44%] +........................................................................ [ 51%] +........................................................................ [ 58%] +........................................................................ [ 66%] +........................................................................ [ 73%] +........................................................................ [ 80%] +........................................................................ [ 88%] +.................................................................s...... [ 95%] +............................................. [100%] +980 passed, 1 skipped, 19 deselected in 180.75s (0:03:00) +exit_code: 0 elapsed_seconds: 182.490 diff --git a/evidence/final-validation-2026-11-07/targeted-initial.py b/evidence/final-validation-2026-11-07/targeted-initial.py new file mode 100644 index 00000000..bec906c2 --- /dev/null +++ b/evidence/final-validation-2026-11-07/targeted-initial.py @@ -0,0 +1,177 @@ +import hashlib +import json +import os +import struct +import sys +import time +import zlib +from io import BytesIO +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[2] +sys.path[:0] = [str(ROOT / 'scripts'), str(ROOT / 'student-tests')] +import pipeline_suite as ps +from PIL import Image +from messenger.attachments.infrastructure.images import RenderLimits, render_variants +from pictures import SIGNATURE, chunk +from png_trns_fixtures import png_with_trns + +MODE = sys.argv.pop(1) +OUT = Path(__file__).parent / (MODE + '.json') +if OUT.exists(): + raise SystemExit('Result exists; do not repeat completed evidence') +SUITE = ps.Suite(ps.arguments()) +STACK = SUITE.stack +REPORT = {'mode': MODE, 'source_sha': ps.run(['git', 'rev-parse', 'HEAD']).strip(), 'started_at': ps.now(), 'cases': []} +LIMITS = RenderLimits(10485760, 40000000) + + +def save(): + OUT.write_text(json.dumps(REPORT, ensure_ascii=False, indent=2) + '\n') + + +def case(name, function): + row = {'name': name, 'started_at': ps.now()} + REPORT['cases'].append(row) + save() + began = time.monotonic() + try: + row['observed'] = function() + row['result'] = 'PASS' + except Exception as error: + row.update(result='FAIL', error=str(error)) + row['elapsed_seconds'] = round(time.monotonic() - began, 3) + save() + print(name, row['result'], row.get('error', ''), flush=True) + + +def containers(): + return STACK.dc('ps', '-a', '--format', '{{.Name}} {{.ID}} {{.State}} {{.Status}}').splitlines() + + +def outage(): + SUITE.drained() + before_dlq = STACK.queues()[ps.DLQ] + STACK.stop('worker') + att = SUITE.api.fixture() + ident = att['id'] + ps.poll(lambda: all(r['published'] for r in STACK.sql('outbox', id=ident)), 30, 'published outbox') + jobs = STACK.sql('jobs', id=ident) + REPORT['outage_checkpoint'] = {'attachment_id': ident, 'jobs_before': jobs, 'dlq_before': before_dlq} + save() + STACK.stop('postgres') + REPORT['outage_checkpoint']['stopped_containers'] = containers() + save() + since = ps.now() + STACK.dc('start', 'worker') + def requeues(): + logs = STACK.dc('logs', '--no-color', '--since', since, 'worker') + rows = [line for line in logs.splitlines() if 'job.requeued' in line and jobs[0]['job_id'] in line] + return rows if len(rows) >= 12 else None + try: + lines = ps.poll(requeues, 90, '12 real database failures', 1) + Path(__file__).with_name('postgres-outage-worker.log').write_text('\n'.join(lines) + '\n') + during = STACK.queues() + finally: + STACK.up('postgres') + ps.poll(lambda: ps.http_ready(SUITE.args.base_url), 30, 'API after PostgreSQL') + ready = SUITE.api.wait(ident) + SUITE.verify(ready) + SUITE.drained() + after = STACK.sql('jobs', id=ident) + assert after[0]['job_id'] == jobs[0]['job_id'] and after[0]['attempt'] == jobs[0]['attempt'] == 1 + assert after[0]['status'] == 'done' + assert STACK.queues()[ps.DLQ] == before_dlq + assert len(STACK.sql('variants', id=ident)) == 3 + return {'attachment_id': ident, 'jobs_before': jobs, 'jobs_after': after, 'requeues': len(lines), 'queues_during': during, 'queues_after': STACK.queues(), 'replay': False, 'stopped_containers': REPORT['outage_checkpoint']['stopped_containers']} + + +def png(name, data, reference): + att = SUITE.api.upload(data, name=name + '.png') + ident = att['id'] + results = [] + for version in (1, 2): + if version == 2: + STACK.admin('reprocess', '--attachment-id', ident, '--pipeline-version', '2') + ps.poll(lambda: SUITE.record(ident)['published_version'] == 2, 90, 'published v2') + ready = SUITE.api.wait(ident) + SUITE.verify(ready) + assert SUITE.api.content(ident)['bytes'] == data + expected = {r.name: r for r in render_variants(reference, LIMITS, version)} + variants = [] + for variant in ready['variants']: + content = SUITE.api.content(ident, variant['name'])['bytes'] + assert content == expected[variant['name']].data, variant['name'] + ' differs from independent white reference' + with Image.open(BytesIO(content)) as image: + assert not image.getexif() + assert not any(key in image.info for key in ('icc_profile', 'xmp', 'transparency')) + variants.append({'name': variant['name'], 'sha256': hashlib.sha256(content).hexdigest(), 'bytes': len(content), 'dimensions': [variant['width'], variant['height']]}) + results.append({'version': version, 'variants': variants}) + before = SUITE.snapshot(ident) + STACK.publish(SUITE.payload(ident, 1)) + STACK.publish(SUITE.payload(ident, 2)) + SUITE.drained() + assert SUITE.snapshot(ident) == before + assert len(STACK.sql('variants', id=ident)) == 6 + return {'attachment_id': ident, 'input_sha256': hashlib.sha256(data).hexdigest(), 'input_bytes': len(data), 'versions': results, 'stale_and_duplicate_noop': True} + + +def large_png(depth, rgb): + transparent = (12345, 23456, 34567) if rgb else (1 if depth < 16 else 12345,) + neighbor = (transparent[0] + 1, *transparent[1:]) + def block(pixel): + if depth < 8: + value = sum(pixel[0] << shift for shift in range(0, 8, depth)) + return bytes([value]) * (4000 * depth // 8) + return b''.join(v.to_bytes(depth // 8, 'big') for v in pixel) * 4000 + row = b'\0' + block(transparent) + block(neighbor) + compressor = zlib.compressobj() + compressed = b''.join(compressor.compress(row) for _ in range(5000)) + compressor.flush() + return SIGNATURE + chunk(b'IHDR', struct.pack('>IIBBBBB', 8000, 5000, depth, 2 if rgb else 0, 0, 0, 0)) + chunk(b'tRNS', b''.join(v.to_bytes(2, 'big') for v in transparent)) + chunk(b'IDAT', compressed) + chunk(b'IEND', b'') + + +def large(name, data): + assert len(data) < LIMITS.max_bytes + att = SUITE.api.upload(data, name=name + '.png', final=('ready', 'failed')) + ready = SUITE.api.wait(att['id'], ('ready', 'failed')) + row = {'attachment_id': att['id'], 'input_bytes': len(data), 'input_sha256': hashlib.sha256(data).hexdigest(), 'pixels': 40000000, 'status': ready['status'], 'error_code': ready['error_code'], 'jobs': STACK.sql('jobs', id=att['id']), 'memory_peak': STACK.cgroup('worker', 'memory.peak'), 'memory_max': STACK.cgroup('worker', 'memory.max')} + REPORT['large_observations'] = REPORT.get('large_observations', []) + [row] + save() + assert ready['status'] == 'ready', json.dumps(row) + SUITE.verify(ready) + assert int(row['memory_peak']) < int(row['memory_max']) + return row + + +try: + SUITE.detect_api() + SUITE.api = ps.Api(SUITE.args) + dead_before = STACK.queues()[ps.DLQ][0] + REPORT['conditions'] = {'host_load': os.getloadavg(), 'containers': containers(), 'running': ps.run(['docker', 'ps', '--format', '{{.Names}} {{.Status}}']), 'worker_limits': STACK.dc('exec', '-T', 'worker', 'printenv', 'RENDER_MEMORY_MB', 'RENDER_TIMEOUT_SECONDS', 'WORKER_CONCURRENCY')} + save() + if MODE == 'postgres-outage': + case('published_outbox_database_outage', outage) + elif MODE == 'png-http': + folder = ROOT / 'evidence/review-trns-depth-2026-11-06/fixtures' + for name in ('gray2', 'gray4', 'rgb16'): + case(name, lambda name=name: png(name, (folder / (name + '.png')).read_bytes(), (folder / (name + '-white.png')).read_bytes())) + for name, depth, color in [('gray1', 1, (0,)), ('gray8', 8, (85,)), ('gray16', 16, (12345,)), ('rgb8', 8, (255, 0, 0))]: + case(name, lambda name=name, depth=depth, color=color: png(name, *png_with_trns(depth, color))) + case('rgb16-adam7-filter4-exif6', lambda: png('adam7', *png_with_trns(16, (12345, 23456, 34567), size=(65, 63), interlace=1, filtering=4, orientation=6))) + elif MODE == 'png-limits': + for name, depth, rgb in [('gray2-40mp', 2, False), ('gray4-40mp', 4, False), ('gray16-40mp', 16, False), ('rgb16-40mp', 16, True)]: + case(name, lambda name=name, depth=depth, rgb=rgb: large(name, large_png(depth, rgb))) + data = large_png(16, True) + case('forced-timeout', lambda: SUITE.limited(data, FAULT_RENDER_TIMEOUT_SECONDS='0.01')) + case('forced-memory', lambda: SUITE.limited(data, FAULT_RENDER_MEMORY_MB='200')) + STACK.restore() + case('normal-after-limits', SUITE.smoke_pipeline) + REPORT['invariants'] = SUITE.invariants(dead_before) +finally: + STACK.up('postgres') + STACK.restore() + REPORT['accepted_ids'] = SUITE.api.accepted if SUITE.api else [] + REPORT['finished_at'] = ps.now() + REPORT['result'] = 'PASS' if REPORT['cases'] and all(x.get('result') == 'PASS' for x in REPORT['cases'] + REPORT.get('invariants', [])) else 'FAIL' + save() +raise SystemExit(0 if REPORT['result'] == 'PASS' else 1) diff --git a/evidence/final-validation-2026-11-07/targeted.py b/evidence/final-validation-2026-11-07/targeted.py new file mode 100644 index 00000000..970081ac --- /dev/null +++ b/evidence/final-validation-2026-11-07/targeted.py @@ -0,0 +1,179 @@ +import hashlib +import json +import os +import struct +import sys +import time +import zlib +from io import BytesIO +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[2] +sys.path[:0] = [str(ROOT / 'scripts'), str(ROOT / 'student-tests')] +import pipeline_suite as ps +from PIL import Image +from messenger.attachments.infrastructure.images import RenderLimits, render_variants +from pictures import SIGNATURE, chunk +from png_trns_fixtures import png_with_trns + +MODE = sys.argv.pop(1) +OUT = Path(__file__).parent / (MODE + '.json') +if OUT.exists(): + raise SystemExit('Result exists; do not repeat completed evidence') +SUITE = ps.Suite(ps.arguments()) +STACK = SUITE.stack +REPORT = {'mode': MODE, 'source_sha': ps.run(['git', 'rev-parse', 'HEAD']).strip(), 'started_at': ps.now(), 'cases': []} +LIMITS = RenderLimits(10485760, 40000000) + + +def save(): + OUT.write_text(json.dumps(REPORT, ensure_ascii=False, indent=2) + '\n') + + +def case(name, function): + row = {'name': name, 'started_at': ps.now()} + REPORT['cases'].append(row) + save() + began = time.monotonic() + try: + row['observed'] = function() + row['result'] = 'PASS' + except Exception as error: + row.update(result='FAIL', error=str(error)) + row['elapsed_seconds'] = round(time.monotonic() - began, 3) + save() + print(name, row['result'], row.get('error', ''), flush=True) + + +def containers(): + return STACK.dc('ps', '-a', '--format', '{{.Name}} {{.ID}} {{.State}} {{.Status}}').splitlines() + + +def outage(): + SUITE.drained() + before_dlq = STACK.queues()[ps.DLQ] + STACK.stop('worker') + att = SUITE.api.fixture() + ident = att['id'] + ps.poll(lambda: all(r['published'] for r in STACK.sql('outbox', id=ident)), 30, 'published outbox') + jobs = STACK.sql('jobs', id=ident) + REPORT['outage_checkpoint'] = {'attachment_id': ident, 'jobs_before': jobs, 'dlq_before': before_dlq} + save() + STACK.stop('postgres') + REPORT['outage_checkpoint']['stopped_containers'] = containers() + save() + since = ps.now() + worker_id = STACK.dc('ps', '-aq', 'worker').strip() + assert worker_id + ps.run(['docker', 'start', worker_id]) + def requeues(): + logs = STACK.dc('logs', '--no-color', '--since', since, 'worker') + rows = [line for line in logs.splitlines() if 'job.requeued' in line and jobs[0]['job_id'] in line] + return rows if len(rows) >= 12 else None + try: + lines = ps.poll(requeues, 90, '12 real database failures', 1) + Path(__file__).with_name('postgres-outage-worker.log').write_text('\n'.join(lines) + '\n') + during = STACK.queues() + finally: + STACK.up('postgres') + ps.poll(lambda: ps.http_ready(SUITE.args.base_url), 30, 'API after PostgreSQL') + ready = SUITE.api.wait(ident) + SUITE.verify(ready) + SUITE.drained() + after = STACK.sql('jobs', id=ident) + assert after[0]['job_id'] == jobs[0]['job_id'] and after[0]['attempt'] == jobs[0]['attempt'] == 1 + assert after[0]['status'] == 'done' + assert STACK.queues()[ps.DLQ] == before_dlq + assert len(STACK.sql('variants', id=ident)) == 3 + return {'attachment_id': ident, 'jobs_before': jobs, 'jobs_after': after, 'requeues': len(lines), 'queues_during': during, 'queues_after': STACK.queues(), 'replay': False, 'stopped_containers': REPORT['outage_checkpoint']['stopped_containers']} + + +def png(name, data, reference): + att = SUITE.api.upload(data, name=name + '.png') + ident = att['id'] + results = [] + for version in (1, 2): + if version == 2: + STACK.admin('reprocess', '--attachment-id', ident, '--pipeline-version', '2') + ps.poll(lambda: SUITE.record(ident)['published_version'] == 2, 90, 'published v2') + ready = SUITE.api.wait(ident) + SUITE.verify(ready) + assert SUITE.api.content(ident)['bytes'] == data + expected = {r.name: r for r in render_variants(reference, LIMITS, version)} + variants = [] + for variant in ready['variants']: + content = SUITE.api.content(ident, variant['name'])['bytes'] + assert content == expected[variant['name']].data, variant['name'] + ' differs from independent white reference' + with Image.open(BytesIO(content)) as image: + assert not image.getexif() + assert not any(key in image.info for key in ('icc_profile', 'xmp', 'transparency')) + variants.append({'name': variant['name'], 'sha256': hashlib.sha256(content).hexdigest(), 'bytes': len(content), 'dimensions': [variant['width'], variant['height']]}) + results.append({'version': version, 'variants': variants}) + before = SUITE.snapshot(ident) + STACK.publish(SUITE.payload(ident, 1)) + STACK.publish(SUITE.payload(ident, 2)) + SUITE.drained() + assert SUITE.snapshot(ident) == before + assert len(STACK.sql('variants', id=ident)) == 6 + return {'attachment_id': ident, 'input_sha256': hashlib.sha256(data).hexdigest(), 'input_bytes': len(data), 'versions': results, 'stale_and_duplicate_noop': True} + + +def large_png(depth, rgb): + transparent = (12345, 23456, 34567) if rgb else (1 if depth < 16 else 12345,) + neighbor = (transparent[0] + 1, *transparent[1:]) + def block(pixel): + if depth < 8: + value = sum(pixel[0] << shift for shift in range(0, 8, depth)) + return bytes([value]) * (4000 * depth // 8) + return b''.join(v.to_bytes(depth // 8, 'big') for v in pixel) * 4000 + row = b'\0' + block(transparent) + block(neighbor) + compressor = zlib.compressobj() + compressed = b''.join(compressor.compress(row) for _ in range(5000)) + compressor.flush() + return SIGNATURE + chunk(b'IHDR', struct.pack('>IIBBBBB', 8000, 5000, depth, 2 if rgb else 0, 0, 0, 0)) + chunk(b'tRNS', b''.join(v.to_bytes(2, 'big') for v in transparent)) + chunk(b'IDAT', compressed) + chunk(b'IEND', b'') + + +def large(name, data): + assert len(data) < LIMITS.max_bytes + att = SUITE.api.upload(data, name=name + '.png', final=('ready', 'failed')) + ready = SUITE.api.wait(att['id'], ('ready', 'failed')) + row = {'attachment_id': att['id'], 'input_bytes': len(data), 'input_sha256': hashlib.sha256(data).hexdigest(), 'pixels': 40000000, 'status': ready['status'], 'error_code': ready['error_code'], 'jobs': STACK.sql('jobs', id=att['id']), 'memory_peak': STACK.cgroup('worker', 'memory.peak'), 'memory_max': STACK.cgroup('worker', 'memory.max')} + REPORT['large_observations'] = REPORT.get('large_observations', []) + [row] + save() + assert ready['status'] == 'ready', json.dumps(row) + SUITE.verify(ready) + assert int(row['memory_peak']) < int(row['memory_max']) + return row + + +try: + SUITE.detect_api() + SUITE.api = ps.Api(SUITE.args) + dead_before = STACK.queues()[ps.DLQ][0] + REPORT['conditions'] = {'host_load': os.getloadavg(), 'containers': containers(), 'running': ps.run(['docker', 'ps', '--format', '{{.Names}} {{.Status}}']), 'worker_limits': STACK.dc('exec', '-T', 'worker', 'printenv', 'RENDER_MEMORY_MB', 'RENDER_TIMEOUT_SECONDS', 'WORKER_CONCURRENCY')} + save() + if MODE.startswith('postgres-outage'): + case('published_outbox_database_outage', outage) + elif MODE == 'png-http': + folder = ROOT / 'evidence/review-trns-depth-2026-11-06/fixtures' + for name in ('gray2', 'gray4', 'rgb16'): + case(name, lambda name=name: png(name, (folder / (name + '.png')).read_bytes(), (folder / (name + '-white.png')).read_bytes())) + for name, depth, color in [('gray1', 1, (0,)), ('gray8', 8, (85,)), ('gray16', 16, (12345,)), ('rgb8', 8, (255, 0, 0))]: + case(name, lambda name=name, depth=depth, color=color: png(name, *png_with_trns(depth, color))) + case('rgb16-adam7-filter4-exif6', lambda: png('adam7', *png_with_trns(16, (12345, 23456, 34567), size=(65, 63), interlace=1, filtering=4, orientation=6))) + elif MODE == 'png-limits': + for name, depth, rgb in [('gray2-40mp', 2, False), ('gray4-40mp', 4, False), ('gray16-40mp', 16, False), ('rgb16-40mp', 16, True)]: + case(name, lambda name=name, depth=depth, rgb=rgb: large(name, large_png(depth, rgb))) + data = large_png(16, True) + case('forced-timeout', lambda: SUITE.limited(data, FAULT_RENDER_TIMEOUT_SECONDS='0.01')) + case('forced-memory', lambda: SUITE.limited(data, FAULT_RENDER_MEMORY_MB='200')) + STACK.restore() + case('normal-after-limits', SUITE.smoke_pipeline) + REPORT['invariants'] = SUITE.invariants(dead_before) +finally: + STACK.up('postgres') + STACK.restore() + REPORT['accepted_ids'] = SUITE.api.accepted if SUITE.api else [] + REPORT['finished_at'] = ps.now() + REPORT['result'] = 'PASS' if REPORT['cases'] and all(x.get('result') == 'PASS' for x in REPORT['cases'] + REPORT.get('invariants', [])) else 'FAIL' + save() +raise SystemExit(0 if REPORT['result'] == 'PASS' else 1) diff --git a/evidence/final-validation-2026-11-07/up.txt b/evidence/final-validation-2026-11-07/up.txt new file mode 100644 index 00000000..bf99f14e --- /dev/null +++ b/evidence/final-validation-2026-11-07/up.txt @@ -0,0 +1,94 @@ +date: 2026-11-06T21:16:39Z commit: b30e2f6a84419d1ca64525ffb40df92183cccaef +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-validation"} +$ docker compose up -d --wait + Network mtusi2026lab5_backend Creating + Network mtusi2026lab5_backend Created + Network mtusi2026lab5_edge Creating + Network mtusi2026lab5_edge Created + Container mtusi2026lab5-postgres-1 Creating + Container mtusi2026lab5-valkey-1 Creating + Container mtusi2026lab5-lb-1 Creating + Container mtusi2026lab5-s3-1 Creating + Container mtusi2026lab5-broker-1 Creating + Container mtusi2026lab5-valkey-1 Created + Container mtusi2026lab5-s3-1 Created + Container mtusi2026lab5-s3-init-1 Creating + Container mtusi2026lab5-broker-1 Created + Container mtusi2026lab5-lb-1 Created + Container mtusi2026lab5-postgres-1 Created + Container mtusi2026lab5-migrate-1 Creating + Container mtusi2026lab5-s3-init-1 Created + Container mtusi2026lab5-migrate-1 Created + Container mtusi2026lab5-worker-1 Creating + Container mtusi2026lab5-api-2 Creating + Container mtusi2026lab5-api-1 Creating + Container mtusi2026lab5-relay-1 Creating + Container mtusi2026lab5-api-2 Created + Container mtusi2026lab5-relay-1 Created + Container mtusi2026lab5-worker-1 Created + Container mtusi2026lab5-api-1 Created + Container mtusi2026lab5-valkey-1 Starting + Container mtusi2026lab5-broker-1 Starting + Container mtusi2026lab5-s3-1 Starting + Container mtusi2026lab5-lb-1 Starting + Container mtusi2026lab5-postgres-1 Starting + Container mtusi2026lab5-valkey-1 Started + Container mtusi2026lab5-s3-1 Started + Container mtusi2026lab5-s3-1 Waiting + Container mtusi2026lab5-postgres-1 Started + Container mtusi2026lab5-postgres-1 Waiting + Container mtusi2026lab5-lb-1 Started + Container mtusi2026lab5-broker-1 Started + Container mtusi2026lab5-postgres-1 Healthy + Container mtusi2026lab5-migrate-1 Starting + Container mtusi2026lab5-migrate-1 Started + Container mtusi2026lab5-s3-1 Healthy + Container mtusi2026lab5-s3-init-1 Starting + Container mtusi2026lab5-s3-init-1 Started + Container mtusi2026lab5-s3-init-1 Waiting + Container mtusi2026lab5-broker-1 Waiting + Container mtusi2026lab5-migrate-1 Waiting + Container mtusi2026lab5-migrate-1 Waiting + Container mtusi2026lab5-broker-1 Waiting + Container mtusi2026lab5-migrate-1 Waiting + Container mtusi2026lab5-s3-init-1 Waiting + Container mtusi2026lab5-s3-init-1 Waiting + Container mtusi2026lab5-migrate-1 Exited + Container mtusi2026lab5-migrate-1 Exited + Container mtusi2026lab5-migrate-1 Exited + Container mtusi2026lab5-s3-init-1 Exited + Container mtusi2026lab5-s3-init-1 Exited + Container mtusi2026lab5-api-1 Starting + Container mtusi2026lab5-broker-1 Healthy + Container mtusi2026lab5-relay-1 Starting + Container mtusi2026lab5-broker-1 Healthy + Container mtusi2026lab5-s3-init-1 Exited + Container mtusi2026lab5-worker-1 Starting + Container mtusi2026lab5-api-1 Started + Container mtusi2026lab5-api-2 Starting + Container mtusi2026lab5-worker-1 Started + Container mtusi2026lab5-relay-1 Started + Container mtusi2026lab5-api-2 Started + Container mtusi2026lab5-broker-1 Waiting + Container mtusi2026lab5-lb-1 Waiting + Container mtusi2026lab5-relay-1 Waiting + Container mtusi2026lab5-postgres-1 Waiting + Container mtusi2026lab5-s3-init-1 Waiting + Container mtusi2026lab5-migrate-1 Waiting + Container mtusi2026lab5-s3-1 Waiting + Container mtusi2026lab5-api-1 Waiting + Container mtusi2026lab5-api-2 Waiting + Container mtusi2026lab5-valkey-1 Waiting + Container mtusi2026lab5-worker-1 Waiting + Container mtusi2026lab5-valkey-1 Healthy + Container mtusi2026lab5-migrate-1 Exited + Container mtusi2026lab5-s3-init-1 Exited + Container mtusi2026lab5-postgres-1 Healthy + Container mtusi2026lab5-s3-1 Healthy + Container mtusi2026lab5-broker-1 Healthy + Container mtusi2026lab5-api-1 Healthy + Container mtusi2026lab5-api-2 Healthy + Container mtusi2026lab5-worker-1 Healthy + Container mtusi2026lab5-relay-1 Healthy + Container mtusi2026lab5-lb-1 Healthy +exit_code: 0 elapsed_seconds: 10.322 diff --git a/evidence/load-validation.md b/evidence/load-validation.md new file mode 100644 index 00000000..67d7b22a --- /dev/null +++ b/evidence/load-validation.md @@ -0,0 +1,42 @@ +# Аудит применимости измерений ЛР5 + +Фаза validation, 2026-11-07. Исходный HEAD `b30e2f6a84419d1ca64525ffb40df92183cccaef`, runtime прошёл review на `42575281b352d35bda17ee7601bae5548a996e91` (R). Diff R → HEAD содержит только REPORT, AGENTS и два документа evidence. Реализация в этой фазе не меняется; push запрещён. + +Выбран трек 2 README — идемпотентность pipeline. Матрица throughput/prefetch и SLO относятся к невыбранному треку 1; новые SLO не вводятся. + +## Принятые серии + +Основная база D: `0e921116610d289716af0a40ec823376eb8bbcbc`, каталог [forward-final-2026-11-06](forward-final-2026-11-06/RESULTS.md). + +| Серия | Решение и основание | +| --- | --- | +| Track run1/2/3: по 13 сценариев, 8 инвариантов, 13 ID, 58 объектов | Принимаются функциональные результаты всех трёх повторов. Все обязательные повторы уже выполнены. SQL/outbox/lease/fencing/versioning не изменены. Старый sample PNG входит в побайтную проверку совместимости renderer. Влияние новой policy проверяется адресно. Полный track2 повторно не запускается. | +| Level4: 17 сценариев, 8 инвариантов, 33 ID, 116 объектов | Принимаются незатронутые результаты; адресно дополняются delivery/ack/retry и новые PNG. | +| Smoke/persistence/failover | Принимаются сохранность данных, сессий и отказ реплики: их реализация и конфигурация не менялись. Новый smoke служит проверкой собранного стенда. Полные persistence/failover повторно не запускаются. | +| Network regressions, upload-negative, cache-outage, HAProxy errors | Принимаются: входная валидация, кэш и LB не менялись. | +| 819 student tests / 1 skip | Исторический результат D. Полный набор запускается на R для новых регрессий и real-broker тестов. | +| 430 offline + 20 boundaries, 114 идентичных вариантов | Принимаются для R; не заменяют HTTP/Linux и реальный отказ PostgreSQL. | + +Условия D: Darwin arm64, Docker 28.3.2, 16 CPU / 8 217 190 400 байт VM RAM; основной изолированный project `mtusi2026lab5`, API 18085, stats/UI 25085/25086. Compose, Dockerfile и uv.lock не изменены. API ×2 по 1 CPU/512 MiB; worker 2 CPU/1 GiB, concurrency/prefetch=2, renderer 448 MiB/30 с. Fault override: lease 5 с, stall 15 с, backoff 1 с, poll 0.5 с. Синтетический dataset: sample 320×200, матрица 26 изображений, 40 Мп fixture. Volumes сохранялись. Срезы условий не показывают других работающих проектов, но непрерывного контроля нагрузки хоста нет. + +Run2/3 имеют несогласованные UTC/elapsed: функциональный результат сохранён, время исключено из performance-выводов. Повторять корректные сценарии из-за неприменимого времени не требуется. Старые корневые evidence до SQLAlchemy, промежуточные FAIL и прерванные серии не используются как PASS. + +## Недостающие и затронутые проверки + +1. RabbitMQ 4.1.8: применение policy на сохранённом volume; настоящий отказ PostgreSQL после опубликованного outbox, >10 nack, ready без replay, неизменные job/attempt/DLQ. +2. HTTP tRNS grayscale/RGB разных глубин, точный сосед RGB16, Adam7/filter/EXIF, v1/v2 и повтор старой job. Linux 40 Мп, штатные и принудительные лимиты, последующее обычное задание. +3. Адресная suite: duplicate/reorder/fencing, COMMIT/ack, malformed/DLQ, retry-exhaustion/replay. Причина — изменённая policy доставки; весь baseline и три track2 повтора не повторяются. +4. Текущие check/validate/lint/student-test, OpenSpec, SHA и отсутствие секретов в tracked файлах. + +Результаты и команды этой фазы сохраняются в `final-validation-2026-11-07/`. Завершённые результаты не перезаписываются. Итог: **validation blocked, 1 major** — четыре 40 Мп PNG tRNS не достигают ready при штатном лимите памяти. Подробности и завершённые проверки — [RESULTS](final-validation-2026-11-07/RESULTS.md), [findings](final-validation-2026-11-07/findings.json). Runtime не изменён, публикация запрещена. Повторять после fix только ресурсные/tRNS проверки и сценарии, которые затронет фактический diff. + + +## Итог адресной квалификации + +- Реальный PostgreSQL outage: 12 nack/requeue, восстановление без replay, job/attempt/DLQ сохранены; 8 инвариантов PASS. +- HTTP PNG: 8 fixtures, 48 сравнений вариантов v1/v2 с независимым эталоном, stale/duplicate noop; 8 инвариантов PASS. +- Delivery subset: 12 сценариев, 8 инвариантов, 11 ID / 47 объектов PASS. Одна новая запись DLQ ожидаема от malformed message. +- Linux 40 Мп tRNS: 4 FAIL (processing_failed); принудительные лимиты и последующая обычная работа PASS. MemoryError подтверждён отдельным пробником. Эти результаты не заменяют PASS старого обычного PNG 40 Мп и не позволяют обещать готовность новых путей на границе. +- Check/validate/lint PASS; student-test 980 passed / 1 Linux-only skip; OpenSpec 22 PASS, changes=[]; 64 исторических хеша сверены. Код и нормативные файлы неизменны. + +Сохранены также непригодный первый outage (обвязка автоматически запустила БД), неуспешный docker cp диагностических файлов и ранний no_orphans до sweep. Повторён только неверно выполненный outage, перенос пробника и read-only проверка cleanup; результаты успешных серий не перезаписывались. Диагностика памяти повторяет только выявленные неуспешные пути, чтобы установить причину. -- 2.54.0 From fb682bc38476d785d02d4611ba4913e5f37bed62 Mon Sep 17 00:00:00 2001 From: Artyom Date: Sat, 7 Nov 2026 00:31:13 +0300 Subject: [PATCH 47/52] Include raw PostgreSQL outage log in validation evidence --- .../final-validation-2026-11-07/final-doc-audit.json | 5 +++-- .../postgres-outage-worker.log | 12 ++++++++++++ .../final-validation-2026-11-07/secret-scan.json | 2 +- evidence/final-validation-2026-11-07/sha256.json | 4 ++-- 4 files changed, 18 insertions(+), 5 deletions(-) create mode 100644 evidence/final-validation-2026-11-07/postgres-outage-worker.log diff --git a/evidence/final-validation-2026-11-07/final-doc-audit.json b/evidence/final-validation-2026-11-07/final-doc-audit.json index c55342fe..55b95635 100644 --- a/evidence/final-validation-2026-11-07/final-doc-audit.json +++ b/evidence/final-validation-2026-11-07/final-doc-audit.json @@ -2,7 +2,7 @@ "runtime_review_equal": true, "normative_files_equal_skeleton": true, "new_python_syntax": "PASS", - "allowed_changed_files": 56, + "allowed_changed_files": 58, "local_markdown_links": 173, "links": [ { @@ -697,5 +697,6 @@ "from": "evidence/final-validation-2026-11-07/RESULTS.md", "target": "secret-scan.json" } - ] + ], + "all_link_targets_tracked": true } diff --git a/evidence/final-validation-2026-11-07/postgres-outage-worker.log b/evidence/final-validation-2026-11-07/postgres-outage-worker.log new file mode 100644 index 00000000..5b743301 --- /dev/null +++ b/evidence/final-validation-2026-11-07/postgres-outage-worker.log @@ -0,0 +1,12 @@ +worker-1 | {"job_id":"01a1b2bb-aa2a-72d3-ad8b-623a79fcbed4","error":"Unavailable","event":"job.requeued","level":"warning","ts":"2026-11-06T21:20:07.790580Z"} +worker-1 | {"job_id":"01a1b2bb-aa2a-72d3-ad8b-623a79fcbed4","error":"Unavailable","event":"job.requeued","level":"warning","ts":"2026-11-06T21:20:08.807054Z"} +worker-1 | {"job_id":"01a1b2bb-aa2a-72d3-ad8b-623a79fcbed4","error":"Unavailable","event":"job.requeued","level":"warning","ts":"2026-11-06T21:20:09.821718Z"} +worker-1 | {"job_id":"01a1b2bb-aa2a-72d3-ad8b-623a79fcbed4","error":"Unavailable","event":"job.requeued","level":"warning","ts":"2026-11-06T21:20:10.835176Z"} +worker-1 | {"job_id":"01a1b2bb-aa2a-72d3-ad8b-623a79fcbed4","error":"Unavailable","event":"job.requeued","level":"warning","ts":"2026-11-06T21:20:11.846077Z"} +worker-1 | {"job_id":"01a1b2bb-aa2a-72d3-ad8b-623a79fcbed4","error":"Unavailable","event":"job.requeued","level":"warning","ts":"2026-11-06T21:20:12.851565Z"} +worker-1 | {"job_id":"01a1b2bb-aa2a-72d3-ad8b-623a79fcbed4","error":"Unavailable","event":"job.requeued","level":"warning","ts":"2026-11-06T21:20:13.864230Z"} +worker-1 | {"job_id":"01a1b2bb-aa2a-72d3-ad8b-623a79fcbed4","error":"Unavailable","event":"job.requeued","level":"warning","ts":"2026-11-06T21:20:14.879944Z"} +worker-1 | {"job_id":"01a1b2bb-aa2a-72d3-ad8b-623a79fcbed4","error":"Unavailable","event":"job.requeued","level":"warning","ts":"2026-11-06T21:20:15.885607Z"} +worker-1 | {"job_id":"01a1b2bb-aa2a-72d3-ad8b-623a79fcbed4","error":"Unavailable","event":"job.requeued","level":"warning","ts":"2026-11-06T21:20:16.901272Z"} +worker-1 | {"job_id":"01a1b2bb-aa2a-72d3-ad8b-623a79fcbed4","error":"Unavailable","event":"job.requeued","level":"warning","ts":"2026-11-06T21:20:17.919394Z"} +worker-1 | {"job_id":"01a1b2bb-aa2a-72d3-ad8b-623a79fcbed4","error":"Unavailable","event":"job.requeued","level":"warning","ts":"2026-11-06T21:20:18.933422Z"} diff --git a/evidence/final-validation-2026-11-07/secret-scan.json b/evidence/final-validation-2026-11-07/secret-scan.json index ca2bc84f..3e4ea123 100644 --- a/evidence/final-validation-2026-11-07/secret-scan.json +++ b/evidence/final-validation-2026-11-07/secret-scan.json @@ -1,5 +1,5 @@ { - "files_scanned": 739, + "files_scanned": 740, "patterns": [ "private_key", "github_token", diff --git a/evidence/final-validation-2026-11-07/sha256.json b/evidence/final-validation-2026-11-07/sha256.json index 12b4f2f7..897bce68 100644 --- a/evidence/final-validation-2026-11-07/sha256.json +++ b/evidence/final-validation-2026-11-07/sha256.json @@ -13,7 +13,7 @@ "evidence/final-validation-2026-11-07/postgres-outage.txt": "03ae2413b4d24ca545fe7118dfbca42e19c787df082085be09b57881e8c6ef3b", "evidence/final-validation-2026-11-07/resource-probe-retry.txt": "d2ce23c775e6b460c16ef30fb9ade683508c05a5cfbf700cb2f8f2b5f30ded47", "evidence/final-validation-2026-11-07/postgres-outage-worker.log": "860a8f2c3a41efa2068cd2c0f614c02e605af50b12f13118c0b4f8bba5d0949d", - "evidence/final-validation-2026-11-07/final-doc-audit.json": "ed0950f9a15a0a42ae8c2165d6189a158561949e7f1347d4ced82fd2ccf4d72b", + "evidence/final-validation-2026-11-07/final-doc-audit.json": "1bb59e2139b15012e1050a5f67c9cbbb0be886173e7201f3c612c48f8158e0ae", "evidence/final-validation-2026-11-07/invoke-probe.py": "fb4a472315b5b08fa8b312868241902cb3ca827ca4af8fdaf7aabac57722476d", "evidence/final-validation-2026-11-07/runtime-containers.json": "85da009405a52ea1654d6cb396ef9b7a16cd50c37a09888f3ff9c3a358255b4b", "evidence/final-validation-2026-11-07/png-http.txt": "bf399ba45062574f2c7295dfb5255cde84065b2c621d34e91c0682c96ce88c8f", @@ -31,7 +31,7 @@ "evidence/final-validation-2026-11-07/delivery-targeted.txt": "ab62360225b4cff3cd99f51abbccd637101699070c4237d672cb198b77a5f9f0", "evidence/final-validation-2026-11-07/findings.json": "1bee1d38c4975c2a5b282131de001a7406751e2373ce29908ad49baf64754f83", "evidence/final-validation-2026-11-07/RESULTS.md": "4d918715650d58f320e0884b17c1d9e32276f07c741d515f2c10ee5f18c583cc", - "evidence/final-validation-2026-11-07/secret-scan.json": "c2ffa9e63666c64f1d2e11fc0058c462636a65db0d4466fcce56750b569cbae9", + "evidence/final-validation-2026-11-07/secret-scan.json": "e8d73dbc0b91a8545907368c8e99b5bd16dc0ed6e89a9c46c03b59bdbb9fc95b", "evidence/final-validation-2026-11-07/scan-secrets.py": "de87d9de67d0d8addab791b45725b8afe96dfb3bf84fa1d6bec46b7850494e79", "evidence/final-validation-2026-11-07/cleanup-recheck.txt": "238e1c1d2eb739b105f621198c1cce3614d1cbf5f7a01ebaf30a9edbfc84fa93", "evidence/final-validation-2026-11-07/retained-volumes.txt": "dfa358841d4bd6258e01a9d19756596ccfafcc64338a2f1336be41db557ea1ff", -- 2.54.0 From 429f12d0bc9765bba8f4e80fea87f8f96784653c Mon Sep 17 00:00:00 2001 From: Artyom Date: Sat, 7 Nov 2026 00:41:52 +0300 Subject: [PATCH 48/52] Propose bounded PNG rendering memory as an OpenSpec change --- .../fix-lab5-png-memory/.openspec.yaml | 2 + .../changes/fix-lab5-png-memory/design.md | 56 +++++++++++++++++++ .../changes/fix-lab5-png-memory/proposal.md | 39 +++++++++++++ .../specs/lab5-image-variants/spec.md | 30 ++++++++++ openspec/changes/fix-lab5-png-memory/tasks.md | 14 +++++ 5 files changed, 141 insertions(+) create mode 100644 openspec/changes/fix-lab5-png-memory/.openspec.yaml create mode 100644 openspec/changes/fix-lab5-png-memory/design.md create mode 100644 openspec/changes/fix-lab5-png-memory/proposal.md create mode 100644 openspec/changes/fix-lab5-png-memory/specs/lab5-image-variants/spec.md create mode 100644 openspec/changes/fix-lab5-png-memory/tasks.md diff --git a/openspec/changes/fix-lab5-png-memory/.openspec.yaml b/openspec/changes/fix-lab5-png-memory/.openspec.yaml new file mode 100644 index 00000000..e582ee4a --- /dev/null +++ b/openspec/changes/fix-lab5-png-memory/.openspec.yaml @@ -0,0 +1,2 @@ +schema: spec-driven +created: 2026-11-07 diff --git a/openspec/changes/fix-lab5-png-memory/design.md b/openspec/changes/fix-lab5-png-memory/design.md new file mode 100644 index 00000000..5477dfa9 --- /dev/null +++ b/openspec/changes/fix-lab5-png-memory/design.md @@ -0,0 +1,56 @@ +## Context + +Причина и исходные FAIL — в proposal.md. Pillow 13.0.0 хранит RGB в четырёх байтах +на пиксель. Контекст `with Image.open(...)` закрывает файл, но оставляет pixel core: +это подтверждено Context7 `/python-pillow/pillow/13.0.0`, +[Image lifecycle](https://github.com/python-pillow/pillow/blob/13.0.0/docs/reference/open_files.rst). +Поэтому два RGB-декодирования, несколько L-масок, RGBA и RGB-фон одновременно +переполняют бюджет. Для grayscale16 дополнительно создаётся полноразмерный I. + +## Goals / Non-Goals + +Сохранить исходные пиксели и результат кодирования при меньшем пике памяти. +Не менять размеры/качество вариантов, лимиты и поведение ошибок. +Исправление принадлежит infrastructure зоны attachments, за портом VariantRenderer; +ProcessVariantRenderer собирается в attachments/entrypoints/ioc.py для worker. +Домен, shared, SQLAlchemy/Alembic и инфраструктура стенда не меняются. + +## Decisions + +1. Выполнять точечные преобразования цвета и построение RGB-маски небольшими + плитками. Полноразмерными остаются исходник, выходной RGB либо L-маска. + Получаем ограниченную рабочую память; цена — несколько сотен вызовов Pillow. + Масштабирование и фильтрация выполняются после сборки, поэтому швов нет. + Уменьшение изображения до сравнения tRNS отвергнуто: потеряется точность + соседних 16-битных значений и изменятся варианты. +2. Последовательно декодировать младшие и старшие байты RGB16. Между проходами + закрывать core низких байтов через close(); после пересечения масок освобождать + обе маски перед EXIF/resize. Получаем отсутствие двух полноразмерных RGB + одновременно; сохраняем штатные PNG-фильтры и Adam7 декодера Pillow. +3. Сохранить ограничения по байтам до декодирования и пикселям по заголовку; + RLIMIT_AS=448 MiB и timeout=30 с остаются в дочернем процессе, concurrency=2. + При 40 Мп grayscale16 исходник занимает около 80 MB, выходной RGB — 160 MB, + временные плитки ограничены. RGB16 требует 160 MB изображения и до трёх + 40 MB масок при пересечении, вместо двух изображений и масок. Это расчёт + pixel buffers, а не измерение всего адресного пространства Linux worker. +4. Проверить пиксели и освобождение core offline, сохранить Linux-тест с реальными + импортами worker для следующего этапа. Увеличение лимитов и зависимости не нужны. + +## Risks / Trade-offs + +- Ошибка границ плиток или потеря info/transparency → сравнение полных пикселей + и вариантов с независимым эталоном на нескольких плитках, нечётных размерах, + фильтрах, Adam7, EXIF и обеих версиях pipeline. +- Разные расходы адресного пространства macOS/Linux → финальный агент обязан + повторить Linux RLIMIT_AS и HTTP 40 Мп; offline PASS этого не заменяет. +- Исторический design указывает upload 201 → применяется нормативный 202 ЛР5. + S3 staging → COMMIT attachment/job/outbox, fencing и ack после COMMIT сохраняются. +- Рекомендации apply/archive требуют полного стенда → прямой запрет пользователя + ограничивает фазу offline-проверками и передачей затронутых проверок. + +## Migration Plan + +Миграций нет. После независимого review финальный агент пересобирает только образ +назначенного стенда и повторяет PNG/ресурсные сценарии. Старые FAIL сохраняются. +Откат — возврат изменения renderer; он возвращает известный major, поэтому релиз +до новых Linux/HTTP доказательств не квалифицируется. diff --git a/openspec/changes/fix-lab5-png-memory/proposal.md b/openspec/changes/fix-lab5-png-memory/proposal.md new file mode 100644 index 00000000..5b2270cb --- /dev/null +++ b/openspec/changes/fix-lab5-png-memory/proposal.md @@ -0,0 +1,39 @@ +## Why + +Граничный PNG 8000×5000 обязан становиться ready при штатных лимитах worker. На snapshot +`fb682bc38476d785d02d4611ba4913e5f37bed62` четыре tRNS-изображения вместо этого дают +MemoryError и processing_failed: `evidence/final-validation-2026-11-07/png-limits.json` +и `resource-probe-worker.txt`. Нарушен уровень «4»: пределы обработки и варианты; +в REPORT это строка граничного PNG и блокирующий major финальной validation. + +## What Changes + +- Ограничить размер временных буферов наложения прозрачности и сравнения RGB16; + явно освобождать Pillow core до следующего полного декодирования. +- Сохранить точное сравнение tRNS, белый фон, EXIF и варианты v1/v2. +- Добавить offline-регрессии управления памятью, сохранить evidence и конкретный + список обязательных адресных Linux/HTTP проверок финальному агенту. + +## Capabilities + +### New Capabilities + +Нет. + +### Modified Capabilities + +- `lab5-image-variants`: уточнить граничный сценарий для grayscale 2/4/16 и RGB16 + с tRNS при 448 MiB/30 с, в том числе повторную обработку обеими версиями pipeline. + +## Impact + +Только адаптер Pillow зоны attachments, собственные тесты, OpenSpec и evidence. +Лимиты, зависимости, API, PostgreSQL/SQLAlchemy/Alembic, S3, outbox и брокер сохраняются. +Upload по нормативному контракту остаётся `202 queued` после COMMIT. + +## Non-goals + +Out of scope из `openspec/config.yaml` сохраняется. Minor не исправляются. +Docker, нагрузка, установка окружений, push и Telegram запрещены этой фазе. +Нормативные файлы и старые FAIL не меняются; полная динамическая квалификация +не заявляется по результатам offline-проверок. diff --git a/openspec/changes/fix-lab5-png-memory/specs/lab5-image-variants/spec.md b/openspec/changes/fix-lab5-png-memory/specs/lab5-image-variants/spec.md new file mode 100644 index 00000000..9daff088 --- /dev/null +++ b/openspec/changes/fix-lab5-png-memory/specs/lab5-image-variants/spec.md @@ -0,0 +1,30 @@ +## MODIFIED Requirements + +### 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 продолжать обрабатывать другие задания после любого из этих исходов. + +#### Scenario: Рендер дольше предела + +- **WHEN** worker запущен с `RENDER_TIMEOUT_SECONDS` меньше времени рендера загруженного изображения +- **THEN** вложение становится `failed` с `processing_failed` после первой попытки, процесс worker продолжает работать, следующая загрузка становится `ready` + +#### Scenario: Рендер больше предела памяти + +- **WHEN** worker запущен с `RENDER_MEMORY_MB` меньше пика рендера изображения 40 Мпикс +- **THEN** вложение становится `failed` с `processing_failed`, процесс worker продолжает работать + +#### Scenario: Изображение на пределе пикселей + +- **WHEN** со штатными пределами загружен PNG 8000×5000 +- **THEN** вложение становится `ready` с тремя вариантами, пик памяти контейнера worker ниже его предела + +#### Scenario: Прозрачный PNG на пределе пикселей + +- **WHEN** последовательно обработаны PNG 8000×5000 grayscale 2/4/16 и RGB16 с tRNS при штатных 448 MiB адресного пространства рендера и 30 с на задание, затем запрошена версия pipeline 2 +- **THEN** каждый upload отвечает `202 queued`, обе версии становятся `ready` с тремя вариантами и неизменным оригиналом; прозрачные области белые, соседний непрозрачный цвет сохраняется, worker остаётся работоспособным и обрабатывает следующее обычное задание + +#### Scenario: Пиксели сверх предела по заголовку + +- **WHEN** worker получает задание на оригинал, у которого по заголовку больше `MAX_IMAGE_PIXELS` пикселей +- **THEN** изображение не декодируется, вложение становится `failed` с `invalid_image` diff --git a/openspec/changes/fix-lab5-png-memory/tasks.md b/openspec/changes/fix-lab5-png-memory/tasks.md new file mode 100644 index 00000000..4a3f5a15 --- /dev/null +++ b/openspec/changes/fix-lab5-png-memory/tasks.md @@ -0,0 +1,14 @@ +## 1. Адаптер attachments: уровни «3» и «4» + +- [ ] 1.1 Ограничить временные изображения наложения прозрачности и RGB16-масок плитками, освободить core между проходами без изменения лимитов. +- [ ] 1.2 Проверить thumbnail/crop/optimized offline: точное tRNS, белый фон, границы плиток, EXIF, ошибки и обе версии pipeline. + +## 2. Регрессии и доказательства + +- [ ] 2.1 Добавить тест освобождения памяти на малых данных и Linux-регрессию реальных четырёх 40 Мп fixtures с импортами worker для финальной фазы. +- [ ] 2.2 Выполнить целевые offline-тесты, границы зон, make check/validate/lint и OpenSpec strict; сохранить команды, результаты и хеши. +- [ ] 2.3 Сохранить список обязательных финальных Linux/HTTP PNG и ресурсных проверок, ограничения применимости evidence и прежние minor. + +## 3. Завершение + +- [ ] 3.1 Синхронизировать спецификацию и архивировать change; проверить чистоту нормативных файлов и сделать английские коммиты после make lint. -- 2.54.0 From 1a8020524909ebc5e2e43303436c9d1ce3c1a87b Mon Sep 17 00:00:00 2001 From: Artyom Date: Sat, 7 Nov 2026 00:47:22 +0300 Subject: [PATCH 49/52] Bound PNG transparency buffers within worker memory limits --- .../review-png-memory-2026-11-07/RESULTS.md | 111 +++++ .../boundaries.txt | 2 + .../review-png-memory-2026-11-07/check.txt | 2 + .../review-png-memory-2026-11-07/checks.json | 21 + .../compatibility-command.txt | 65 +++ .../compatibility.txt | 1 + .../findings.json | 32 ++ .../lint-implementation.txt | 6 + .../offline-tests.txt | 7 + .../openspec-before-archive.txt | 25 + .../regression-before-command.txt | 15 + .../regression-before.txt | 28 ++ .../static-audit.json | 10 + .../unchanged-rendering.json | 448 ++++++++++++++++++ .../review-png-memory-2026-11-07/validate.txt | 2 + openspec/changes/fix-lab5-png-memory/tasks.md | 10 +- .../attachments/infrastructure/images.py | 46 +- student-tests/unit/test_png_memory.py | 108 +++++ 18 files changed, 928 insertions(+), 11 deletions(-) create mode 100644 evidence/review-png-memory-2026-11-07/RESULTS.md create mode 100644 evidence/review-png-memory-2026-11-07/boundaries.txt create mode 100644 evidence/review-png-memory-2026-11-07/check.txt create mode 100644 evidence/review-png-memory-2026-11-07/checks.json create mode 100644 evidence/review-png-memory-2026-11-07/compatibility-command.txt create mode 100644 evidence/review-png-memory-2026-11-07/compatibility.txt create mode 100644 evidence/review-png-memory-2026-11-07/findings.json create mode 100644 evidence/review-png-memory-2026-11-07/lint-implementation.txt create mode 100644 evidence/review-png-memory-2026-11-07/offline-tests.txt create mode 100644 evidence/review-png-memory-2026-11-07/openspec-before-archive.txt create mode 100644 evidence/review-png-memory-2026-11-07/regression-before-command.txt create mode 100644 evidence/review-png-memory-2026-11-07/regression-before.txt create mode 100644 evidence/review-png-memory-2026-11-07/static-audit.json create mode 100644 evidence/review-png-memory-2026-11-07/unchanged-rendering.json create mode 100644 evidence/review-png-memory-2026-11-07/validate.txt create mode 100644 student-tests/unit/test_png_memory.py diff --git a/evidence/review-png-memory-2026-11-07/RESULTS.md b/evidence/review-png-memory-2026-11-07/RESULTS.md new file mode 100644 index 00000000..5e359ca5 --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/RESULTS.md @@ -0,0 +1,111 @@ +# Исправление памяти PNG tRNS + +Исходный snapshot: `fb682bc38476d785d02d4611ba4913e5f37bed62`. +Исправляется назначенный major: четыре PNG 8000×5000 не помещались в адресное +пространство рендера 448 MiB. Исходные HTTP FAIL и Linux MemoryError остаются в +[png-limits.json](../final-validation-2026-11-07/png-limits.json) и +[resource-probe-worker.txt](../final-validation-2026-11-07/resource-probe-worker.txt). + +Это фаза исправления с offline-проверками на Darwin arm64, Python 3.14 и Pillow 13.0.0. +Docker, нагрузка, установка окружений, push и Telegram не выполнялись. Нет новых +измерений Linux RSS/RLIMIT_AS, HTTP-прогонов или заявления о готовности к публикации. +REPORT, AGENTS, нормативные файлы, настройки лимитов и историческое evidence сохранены. + +## Причина и изменение + +Pillow хранит RGB в четырёх байтах на пиксель. Прежний renderer держал два полноразмерных +RGB для старших/младших байтов RGB16 вместе с масками; grayscale мог держать исходник, +I/RGBA, маску и белый RGB-фон. Выход из контекста PngImageFile не освобождает pixel core. +Это подтверждено Context7 `/python-pillow/pillow/13.0.0`, +[Image lifecycle](https://github.com/python-pillow/pillow/blob/13.0.0/docs/reference/open_files.rst). + +Точечные преобразования и RGB-маски теперь вычисляются плитками 256×256. После сборки +полного RGB выполняются прежние resize/fit, поэтому фильтры не создают границ плиток. +Low-byte core явно закрывается до декодирования high-byte RGB; три маски закрываются +до EXIF/resize. Исходный grayscale закрывается после сборки RGB. Точное сравнение всех +16 бит, белый фон, фильтры PNG, Adam7, EXIF и настройки кодирования v1/v2 сохраняются. +Runtime изменён только в `src/messenger/attachments/infrastructure/images.py`. + +## Выполненные проверки + +Команды выполняются из корня репозитория через существующее `.venv`. +`--confcutdir=student-tests/unit` и `--noconftest` исключают общий Docker-conftest. + +| Команда | Реальный результат | Файл | +| --- | --- | --- | +| `zsh evidence/review-png-memory-2026-11-07/regression-before-command.txt` | На исходном renderer 4 failed, 1 deselected: превышение бюджета живых pixel buffers. Это ожидаемый FAIL регрессии, а не повтор Linux MemoryError | [regression-before.txt](regression-before.txt) | +| `PYTHONPATH=src:student-tests make student-test PYTEST_ARGS='--confcutdir=student-tests/unit student-tests/unit/test_png_memory.py student-tests/unit/test_png_transparency.py student-tests/unit/test_renderer.py student-tests/unit/test_render_pool.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 -s --tb=short'` | 440 passed, 2 Linux-only skipped; полный интеграционный student-test не запускался | [offline-tests.txt](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](boundaries.txt) | +| `zsh evidence/review-png-memory-2026-11-07/compatibility-command.txt` | 22 изображения, 132 побайтно одинаковых варианта относительно исходного snapshot | [unchanged-rendering.json](unchanged-rendering.json) | +| `make check` | PASS структуры, синтаксиса и локальных ссылок skeleton | [check.txt](check.txt) | +| `make validate` | PASS OpenAPI 3.1 и JSON Schema | [validate.txt](validate.txt) | +| `make lint` перед коммитом реализации | PASS ruff check/format и ty | [lint-implementation.txt](lint-implementation.txt) | +| `openspec validate --all --strict` до архивации | 23 passed | [openspec-before-archive.txt](openspec-before-archive.txt) | + +Регрессия на изображениях 1025×769 учитывает одновременно живущие Pillow core, +уникальные по identity, через weakref и перехват выделений. Размер пиксельных буферов: + +| PNG | До, байт | После, байт | +| --- | ---: | ---: | +| grayscale2 tRNS | 7 882 250 | 4 596 485 | +| grayscale4 tRNS | 7 882 250 | 4 596 485 | +| grayscale16 tRNS | 7 882 250 | 5 384 710 | +| RGB16 tRNS | 9 458 700 | 5 517 575 | + +Это счётчик pixel buffers на малых данных, **не** RSS, виртуальная память процесса, +бенчмарк или доказательство Linux 448 MiB. Для 40 Мп верхняя оценка одновременно +удерживаемых полноразмерных буферов RGB16 — 160 MB RGB + три L-маски по 40 MB; +grayscale16 — 80 MB исходника + 160 MB RGB. Дополнительно нужны память интерпретатора, +импортов worker, аллокатора, декодера и небольших плиток — их проверяет следующий этап. + +Сравнение с независимым RGB-эталоном в новой регрессии покрывает непрозрачных соседей +и границы нескольких плиток. Матрица совместимости включает 555×333 RGB/L/I;16/P/RGBA/LA/1, +JPEG RGB/CMYK, palette alpha-table и 513×259 tRNS с Adam7/filter=4/EXIF=6. +Существующие тесты покрывают все ключи grayscale 1/2/4, фильтры 0–4, младшие биты +RGB16, отрицательные пути и обе версии pipeline. Процессные тесты проверили timeout, +crash, MemoryError, отмену и последующее задание; их дочерние процессы завершены. + +При разработке новой обвязки два первых запуска не прошли из-за отсутствующих runtime +атрибутов `Image.core.ImagingCore` и `ImagingCore.id` в Pillow 13.0.0. Исправлен только +счётчик: проверка DeferredError/None и Python identity core. Затем обнаружены и устранены +ruff SIM117/E501 и лишняя пустая строка delta-spec. Эти промежуточные ошибки не являются +FAIL приложения и не включены в итоговые PASS. + +## Обязательные проверки финального этапа + +Все пункты ниже здесь **не выполнялись**. Сначала требуется независимое review нового SHA. + +1. В Linux с реальными импортами worker и закреплённым Pillow выполнить + `PYTHONPATH=src:student-tests .venv/bin/python -m pytest --confcutdir=student-tests/unit student-tests/unit/test_png_memory.py::test_boundary_pngs_fit_worker_address_space -q -s`. + Тест задаёт RLIMIT_AS=448 MiB и 30 с на каждый рендер четырёх сохранённых fixtures, + проверяет v1/v2, три варианта, белые/непрозрачные области и обычное задание после них. + Для контейнера без pytest допустим эквивалентный пробник из тела теста, с сохранением + команды, хешей, импортов worker и результатов; облегчённый импорт images недостаточен. + Повторить также grayscale16 без tRNS, который раньше превышал память. +2. Через LB загрузить ровно сохранённые `gray2-40mp.png`, `gray4-40mp.png`, + `gray16-40mp.png`, `rgb16-40mp.png` из предыдущей validation: `202 queued → ready` + при 448 MiB/30 с/concurrency=2. Проверить неизменный оригинал и SHA-256, + metadata/bytes всех вариантов, точную прозрачность, повторный reprocess v2, + отсутствие второго набора вариантов и отката ready. Зафиксировать память контейнера, + фактические настройки и фон; среди адресных заданий проверить одновременные рендеры. +3. Повторить PNG HTTP subset (прежние 8 fixtures, 48 сравнений v1/v2) с независимыми + белыми эталонами, включая RGB16/Adam7/filter=4/EXIF=6. Преобразование цвета изменилось, + поэтому прежний PASS не выдаётся за проверку нового renderer. +4. Повторить принудительный timeout, сниженный memory limit и обычную загрузку после + каждого отказа: expected failed/processing_failed, worker жив, следующее задание ready. + После штатного sweep проверить отсутствие staging/pending outbox/дублей для новых ID; + не повторять прежний слишком ранний `no_orphans` до очистки. + +Новые результаты писать в новый каталог, не перезаписывать прежние JSON. Старый +`targeted.py` содержит защиту от перезаписи; для повторов нужен новый output path. +Полные пригодные серии track2, PostgreSQL outage и delivery subset автоматически +не повторяются: изменение затрагивает только renderer. Полная квалификация «5» +остаётся за финальным агентом после review и этих адресных проверок. + +## Сохранённые замечания + +Шесть minor перенесены без исправлений в [findings.json](findings.json): окно confirm, +порядок secrets в limits.py, старый демонстратор ЛР4, replay failed upgrade при ready v1, +расхождение часов прежних измерений и `201` в design-правиле config. Они уже отражены +в REPORT. Закрытие назначенного major на уровне реализации не превращает исходные +FAIL в PASS; итоговый вердикт требует Linux/HTTP evidence нового SHA. diff --git a/evidence/review-png-memory-2026-11-07/boundaries.txt b/evidence/review-png-memory-2026-11-07/boundaries.txt new file mode 100644 index 00000000..a1069d6c --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/boundaries.txt @@ -0,0 +1,2 @@ +.................... [100%] +20 passed in 0.17s diff --git a/evidence/review-png-memory-2026-11-07/check.txt b/evidence/review-png-memory-2026-11-07/check.txt new file mode 100644 index 00000000..9a553306 --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/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-png-memory-2026-11-07/checks.json b/evidence/review-png-memory-2026-11-07/checks.json new file mode 100644 index 00000000..76d6c81e --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/checks.json @@ -0,0 +1,21 @@ +{ + "baseline_sha": "fb682bc38476d785d02d4611ba4913e5f37bed62", + "sha256": { + "src/messenger/attachments/infrastructure/images.py": "97c6e9c1ef13c8854be9cd2cc11e4279d1d340ba3ab360dfa3e05772923ea743", + "student-tests/unit/test_png_memory.py": "49d9fa001d82a2fd495e11da5793ec7f42dfdeb7b0929866e6a0ef94a35f440d", + "evidence/review-png-memory-2026-11-07/RESULTS.md": "2f4e5da18f110420170ad6adf97982797670775d62bb31fb549ab36804a99e01", + "evidence/review-png-memory-2026-11-07/boundaries.txt": "a4d0778a9ba058ff75b48cb3a145ac59e8c7ae9f3764db8fb6a0425c242bf8d2", + "evidence/review-png-memory-2026-11-07/check.txt": "5f42d25d7cd8c1d2fb31ccf28a2872fbb91d38ed094024181e5ace9671667ee6", + "evidence/review-png-memory-2026-11-07/compatibility-command.txt": "09d5bbe4568422aa69917031cf1e6ba8ccc3cf7f241ac88343812f8bf231176d", + "evidence/review-png-memory-2026-11-07/compatibility.txt": "bd3bf1841e476fcc62d6266123bfcf21dc259bf89160a4dda31ba301f429c57d", + "evidence/review-png-memory-2026-11-07/findings.json": "449ab0c9fc33060b54310c622684287525c5508204a47e7aacda1e44dc77b037", + "evidence/review-png-memory-2026-11-07/lint-implementation.txt": "4d6c5ac9c907f1066911fd027b328c8d9038ef46ded69c392c54d9f8d27d4865", + "evidence/review-png-memory-2026-11-07/offline-tests.txt": "9efe9e43fc7e9d7a2bde18e3d54efdeeb2387a1081457ef8b2615451f2583fe9", + "evidence/review-png-memory-2026-11-07/openspec-before-archive.txt": "360f59e3eb964da51f37ce7c00637e41e835670a5c657b2055a496f2f36a76f9", + "evidence/review-png-memory-2026-11-07/regression-before-command.txt": "b3a571ede4d8fe5239bb3a3f4bcb1a1d9ce257d1e580f4aac64cdcb178cc41be", + "evidence/review-png-memory-2026-11-07/regression-before.txt": "02649ec20f6bbd4ec299d457f704d3c1473eda82b6da7b9808a733fdce947123", + "evidence/review-png-memory-2026-11-07/static-audit.json": "4c6b5bb3e410c6df9a21037313828cea2b0393de610b94646f27bde3c22b9cf7", + "evidence/review-png-memory-2026-11-07/unchanged-rendering.json": "f5bf484467198d9cec40affd97c42cfcd0a37c40c49a20ea604ce14babc292e8", + "evidence/review-png-memory-2026-11-07/validate.txt": "422aec45ba93e5567e0de199fa32116a48c970ca3b82738b40f0ed7681ef621f" + } +} diff --git a/evidence/review-png-memory-2026-11-07/compatibility-command.txt b/evidence/review-png-memory-2026-11-07/compatibility-command.txt new file mode 100644 index 00000000..6f00020c --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/compatibility-command.txt @@ -0,0 +1,65 @@ +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 = "fb682bc38476d785d02d4611ba4913e5f37bed62" +name = "messenger.attachments.infrastructure.before_png_memory" +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((555, 333)) +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, size=(513, 259), interlace=1, filtering=4, orientation=6) + fixtures[str(depth) + "-trns-" + str(len(key))] = data + 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-png-memory-2026-11-07/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-png-memory-2026-11-07/compatibility.txt b/evidence/review-png-memory-2026-11-07/compatibility.txt new file mode 100644 index 00000000..eab55fed --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/compatibility.txt @@ -0,0 +1 @@ +{"baseline_sha": "fb682bc38476d785d02d4611ba4913e5f37bed62", "pillow": "13.0.0", "fixtures": 22, "identical_variants": 132} diff --git a/evidence/review-png-memory-2026-11-07/findings.json b/evidence/review-png-memory-2026-11-07/findings.json new file mode 100644 index 00000000..169dc0ca --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/findings.json @@ -0,0 +1,32 @@ +[ + { + "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 с). Причина не установлена; длительности исключены из выводов о производительности." + }, + { + "severity": "minor", + "file": "openspec/config.yaml:130", + "problem": "Сохранена документационная неточность: design требует upload 201 вместо нормативного 202 ЛР5; конфиг вне scope validation." + } +] diff --git a/evidence/review-png-memory-2026-11-07/lint-implementation.txt b/evidence/review-png-memory-2026-11-07/lint-implementation.txt new file mode 100644 index 00000000..d8519183 --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/lint-implementation.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 +198 files already formatted +.venv/bin/ty check src student-tests alembic +All checks passed! diff --git a/evidence/review-png-memory-2026-11-07/offline-tests.txt b/evidence/review-png-memory-2026-11-07/offline-tests.txt new file mode 100644 index 00000000..9f0143b4 --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/offline-tests.txt @@ -0,0 +1,7 @@ +.venv/bin/pytest --confcutdir=student-tests/unit student-tests/unit/test_png_memory.py student-tests/unit/test_png_transparency.py student-tests/unit/test_renderer.py student-tests/unit/test_render_pool.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 -s --tb=short +{"depth": 2, "key": [1], "pixel_buffer_peak_bytes": 4596485} +.{"depth": 4, "key": [5], "pixel_buffer_peak_bytes": 4596485} +.{"depth": 16, "key": [12345], "pixel_buffer_peak_bytes": 5384710} +.{"depth": 16, "key": [12345, 23456, 34567], "pixel_buffer_peak_bytes": 5517575} +.s.....................................................................................................................................................................................s............................................................................................................................................................................................................................................................... +440 passed, 2 skipped in 9.57s diff --git a/evidence/review-png-memory-2026-11-07/openspec-before-archive.txt b/evidence/review-png-memory-2026-11-07/openspec-before-archive.txt new file mode 100644 index 00000000..6b536d1f --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/openspec-before-archive.txt @@ -0,0 +1,25 @@ +- Validating... +✓ change/fix-lab5-png-memory +✓ 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-png-memory-2026-11-07/regression-before-command.txt b/evidence/review-png-memory-2026-11-07/regression-before-command.txt new file mode 100644 index 00000000..71a41c10 --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/regression-before-command.txt @@ -0,0 +1,15 @@ +PYTHONPATH=src:student-tests .venv/bin/python - <<'PYTHON' +import subprocess +import pytest +from messenger.attachments.infrastructure import images +baseline = "fb682bc38476d785d02d4611ba4913e5f37bed62" +source = subprocess.run( + ["git", "show", baseline + ":src/messenger/attachments/infrastructure/images.py"], + check=True, capture_output=True, text=True, +).stdout +exec(compile(source, images.__file__, "exec"), images.__dict__) +raise SystemExit(pytest.main([ + "--confcutdir=student-tests/unit", "student-tests/unit/test_png_memory.py", + "-k", "live_pixel_buffers", "-q", "-s", "--tb=short", +])) +PYTHON diff --git a/evidence/review-png-memory-2026-11-07/regression-before.txt b/evidence/review-png-memory-2026-11-07/regression-before.txt new file mode 100644 index 00000000..d522a0af --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/regression-before.txt @@ -0,0 +1,28 @@ +FFFF +=================================== FAILURES =================================== +_________________ test_live_pixel_buffers_are_bounded[2-key0] __________________ +student-tests/unit/test_png_memory.py:57: in test_live_pixel_buffers_are_bounded + assert peak < size[0] * size[1] * 8 + 2**20, peak +E AssertionError: 7882250 +E assert 7882250 < (((1025 * 769) * 8) + (2 ** 20)) +_________________ test_live_pixel_buffers_are_bounded[4-key1] __________________ +student-tests/unit/test_png_memory.py:57: in test_live_pixel_buffers_are_bounded + assert peak < size[0] * size[1] * 8 + 2**20, peak +E AssertionError: 7882250 +E assert 7882250 < (((1025 * 769) * 8) + (2 ** 20)) +_________________ test_live_pixel_buffers_are_bounded[16-key2] _________________ +student-tests/unit/test_png_memory.py:57: in test_live_pixel_buffers_are_bounded + assert peak < size[0] * size[1] * 8 + 2**20, peak +E AssertionError: 7882250 +E assert 7882250 < (((1025 * 769) * 8) + (2 ** 20)) +_________________ test_live_pixel_buffers_are_bounded[16-key3] _________________ +student-tests/unit/test_png_memory.py:57: in test_live_pixel_buffers_are_bounded + assert peak < size[0] * size[1] * 8 + 2**20, peak +E AssertionError: 9458700 +E assert 9458700 < (((1025 * 769) * 8) + (2 ** 20)) +=========================== short test summary info ============================ +FAILED student-tests/unit/test_png_memory.py::test_live_pixel_buffers_are_bounded[2-key0] +FAILED student-tests/unit/test_png_memory.py::test_live_pixel_buffers_are_bounded[4-key1] +FAILED student-tests/unit/test_png_memory.py::test_live_pixel_buffers_are_bounded[16-key2] +FAILED student-tests/unit/test_png_memory.py::test_live_pixel_buffers_are_bounded[16-key3] +4 failed, 1 deselected in 3.19s diff --git a/evidence/review-png-memory-2026-11-07/static-audit.json b/evidence/review-png-memory-2026-11-07/static-audit.json new file mode 100644 index 00000000..c598796a --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/static-audit.json @@ -0,0 +1,10 @@ +{ + "baseline_sha": "fb682bc38476d785d02d4611ba4913e5f37bed62", + "python": "3.14.5", + "platform": "macOS-15.1-arm64-arm-64bit-Mach-O", + "pillow": "13.0.0", + "source_and_test_ast": "PASS", + "linux_probe_syntax": "PASS, not executed", + "fixture_paths": "PASS, 4 PNG and ordinary sample", + "protected_files_unchanged": true +} diff --git a/evidence/review-png-memory-2026-11-07/unchanged-rendering.json b/evidence/review-png-memory-2026-11-07/unchanged-rendering.json new file mode 100644 index 00000000..24ba8ae2 --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/unchanged-rendering.json @@ -0,0 +1,448 @@ +{ + "baseline_sha": "fb682bc38476d785d02d4611ba4913e5f37bed62", + "pillow": "13.0.0", + "fixtures": 22, + "identical_variants": 132, + "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": "8ce495e7ce3efab731ce95978ffe0d03b8017a1f598dbd8e9fe07f910846c6d0", + "version": 1, + "variants": { + "thumbnail": "cc393e207528b0bc4eb025a5ac0c249f346a61812652716adb0fe5ce41e82c7e", + "crop": "72c821568951b8d23097600fc2c316cef5bbc95ee43ec20ee59242159732befb", + "optimized": "e86f001d60f1602658dabf8dfd8e5b683ea1db98b405b00a3facab4420aa24bf" + } + }, + { + "fixture": "RGB-jpeg", + "source_sha256": "8ce495e7ce3efab731ce95978ffe0d03b8017a1f598dbd8e9fe07f910846c6d0", + "version": 2, + "variants": { + "thumbnail": "f598561889f4a3a9811ff41cfd1da30130d6c6531d31cc1d90a99d19b080a2cd", + "crop": "bea08ed3c14e81a70cfbabbacbbc30822374588929750ef4e287e92fc137fda3", + "optimized": "dd367aecab47830dde829cf16dfcd1abc01944f7428e28cfbeedcf5c7f3f2360" + } + }, + { + "fixture": "CMYK-jpeg", + "source_sha256": "e0e32d7e20e827d7cd911c2a4c9cfa3c257be88432adfae639c8ebbeccc11386", + "version": 1, + "variants": { + "thumbnail": "cc393e207528b0bc4eb025a5ac0c249f346a61812652716adb0fe5ce41e82c7e", + "crop": "72c821568951b8d23097600fc2c316cef5bbc95ee43ec20ee59242159732befb", + "optimized": "e86f001d60f1602658dabf8dfd8e5b683ea1db98b405b00a3facab4420aa24bf" + } + }, + { + "fixture": "CMYK-jpeg", + "source_sha256": "e0e32d7e20e827d7cd911c2a4c9cfa3c257be88432adfae639c8ebbeccc11386", + "version": 2, + "variants": { + "thumbnail": "f598561889f4a3a9811ff41cfd1da30130d6c6531d31cc1d90a99d19b080a2cd", + "crop": "bea08ed3c14e81a70cfbabbacbbc30822374588929750ef4e287e92fc137fda3", + "optimized": "dd367aecab47830dde829cf16dfcd1abc01944f7428e28cfbeedcf5c7f3f2360" + } + }, + { + "fixture": "RGB-png", + "source_sha256": "feeb8dbde85f7520d2c9213a6691c16ec129b9f5d2fb5ee45983b7893f5e9af5", + "version": 1, + "variants": { + "thumbnail": "aecd5101bce160c1335e37d91cd0e01521fca6f696a1b0a66f8df0d94e42a75d", + "crop": "90db9175216decf0caf0697a91e7d39d32a65886c3aefc50c4f5e0458e3d61a2", + "optimized": "2d545b8f979631fd67af2ebbd5959d968ce20b47644d69b494ad793051476997" + } + }, + { + "fixture": "RGB-png", + "source_sha256": "feeb8dbde85f7520d2c9213a6691c16ec129b9f5d2fb5ee45983b7893f5e9af5", + "version": 2, + "variants": { + "thumbnail": "f2fe106fb85647b5ad1bbcc8e2cf0cdaf64f969e6c6d5f2ec892d23df79b2901", + "crop": "442978cb3b8fdb2426666a97c7c7a38a630c943bb233ddb4530fcef8d553776c", + "optimized": "ef7c08146a310e4581b8110df04fc3660cb1570398ee0b66a03a756b50f75935" + } + }, + { + "fixture": "L-png", + "source_sha256": "5e83c10aaaf43adc9b73c09bc6e071cf4f435ca0d2932b9221b0a147e4082339", + "version": 1, + "variants": { + "thumbnail": "aecd5101bce160c1335e37d91cd0e01521fca6f696a1b0a66f8df0d94e42a75d", + "crop": "90db9175216decf0caf0697a91e7d39d32a65886c3aefc50c4f5e0458e3d61a2", + "optimized": "2d545b8f979631fd67af2ebbd5959d968ce20b47644d69b494ad793051476997" + } + }, + { + "fixture": "L-png", + "source_sha256": "5e83c10aaaf43adc9b73c09bc6e071cf4f435ca0d2932b9221b0a147e4082339", + "version": 2, + "variants": { + "thumbnail": "f2fe106fb85647b5ad1bbcc8e2cf0cdaf64f969e6c6d5f2ec892d23df79b2901", + "crop": "442978cb3b8fdb2426666a97c7c7a38a630c943bb233ddb4530fcef8d553776c", + "optimized": "ef7c08146a310e4581b8110df04fc3660cb1570398ee0b66a03a756b50f75935" + } + }, + { + "fixture": "I;16-png", + "source_sha256": "0701a95057454a4371725066f1c0a06491bc70bfbc59967cce4e1f9d99429873", + "version": 1, + "variants": { + "thumbnail": "31384be35c8aaed3d9bce4ea346c4bf8aa54621f8f0e45bfe44d2bbc1e184c34", + "crop": "4fb3b365a5278998ed1e11afc2d4d5deca2c06ebd5c45b28eaeebb56619343b4", + "optimized": "3ca4dd6676b5d1c43afdbcd6ab508465177795bc7b7cf7a24214817f5821da2a" + } + }, + { + "fixture": "I;16-png", + "source_sha256": "0701a95057454a4371725066f1c0a06491bc70bfbc59967cce4e1f9d99429873", + "version": 2, + "variants": { + "thumbnail": "9bb6abc772935c86a8ffa052d2838cf202bd302131b645d6d3216a6d546fc84b", + "crop": "4703e8731b7d52cf95d7e6db1ba2c000aa9a0f9aa3b851b31a24a7be4bcf7281", + "optimized": "f4527aa387b64fdccd971111e87dec62797c260673aba80b64611a230556e0e8" + } + }, + { + "fixture": "P-png", + "source_sha256": "606f57a8a99b652e1045215db7db615f519ba23f6281b41e481026f394de72d3", + "version": 1, + "variants": { + "thumbnail": "aecd5101bce160c1335e37d91cd0e01521fca6f696a1b0a66f8df0d94e42a75d", + "crop": "90db9175216decf0caf0697a91e7d39d32a65886c3aefc50c4f5e0458e3d61a2", + "optimized": "2d545b8f979631fd67af2ebbd5959d968ce20b47644d69b494ad793051476997" + } + }, + { + "fixture": "P-png", + "source_sha256": "606f57a8a99b652e1045215db7db615f519ba23f6281b41e481026f394de72d3", + "version": 2, + "variants": { + "thumbnail": "f2fe106fb85647b5ad1bbcc8e2cf0cdaf64f969e6c6d5f2ec892d23df79b2901", + "crop": "442978cb3b8fdb2426666a97c7c7a38a630c943bb233ddb4530fcef8d553776c", + "optimized": "ef7c08146a310e4581b8110df04fc3660cb1570398ee0b66a03a756b50f75935" + } + }, + { + "fixture": "RGBA-png", + "source_sha256": "e12bca1addecaa12048f3436f5bfe48e94fe637aa76c377057c4978e36cab786", + "version": 1, + "variants": { + "thumbnail": "aecd5101bce160c1335e37d91cd0e01521fca6f696a1b0a66f8df0d94e42a75d", + "crop": "90db9175216decf0caf0697a91e7d39d32a65886c3aefc50c4f5e0458e3d61a2", + "optimized": "2d545b8f979631fd67af2ebbd5959d968ce20b47644d69b494ad793051476997" + } + }, + { + "fixture": "RGBA-png", + "source_sha256": "e12bca1addecaa12048f3436f5bfe48e94fe637aa76c377057c4978e36cab786", + "version": 2, + "variants": { + "thumbnail": "f2fe106fb85647b5ad1bbcc8e2cf0cdaf64f969e6c6d5f2ec892d23df79b2901", + "crop": "442978cb3b8fdb2426666a97c7c7a38a630c943bb233ddb4530fcef8d553776c", + "optimized": "ef7c08146a310e4581b8110df04fc3660cb1570398ee0b66a03a756b50f75935" + } + }, + { + "fixture": "LA-png", + "source_sha256": "21e95eee77122f61f667d12359157d74d3fe208541e40b75495056240572f251", + "version": 1, + "variants": { + "thumbnail": "aecd5101bce160c1335e37d91cd0e01521fca6f696a1b0a66f8df0d94e42a75d", + "crop": "90db9175216decf0caf0697a91e7d39d32a65886c3aefc50c4f5e0458e3d61a2", + "optimized": "2d545b8f979631fd67af2ebbd5959d968ce20b47644d69b494ad793051476997" + } + }, + { + "fixture": "LA-png", + "source_sha256": "21e95eee77122f61f667d12359157d74d3fe208541e40b75495056240572f251", + "version": 2, + "variants": { + "thumbnail": "f2fe106fb85647b5ad1bbcc8e2cf0cdaf64f969e6c6d5f2ec892d23df79b2901", + "crop": "442978cb3b8fdb2426666a97c7c7a38a630c943bb233ddb4530fcef8d553776c", + "optimized": "ef7c08146a310e4581b8110df04fc3660cb1570398ee0b66a03a756b50f75935" + } + }, + { + "fixture": "1-png", + "source_sha256": "6053ff2a88e1e6dfed26db2605c35a7c11ee87f0aa47104d45099bee5809b8de", + "version": 1, + "variants": { + "thumbnail": "cff135476f68964e2da3ccfeb8455379d2eff042ee5b339ea2146af8f3d681b8", + "crop": "344c2b576900616a178eb9549227e57c2702d2063abe3e4b5384736eaf6b0066", + "optimized": "1ddddfbfff2b2e2569916afb15f859ad7047f99cfbcf3453b5e3030fa8c699ee" + } + }, + { + "fixture": "1-png", + "source_sha256": "6053ff2a88e1e6dfed26db2605c35a7c11ee87f0aa47104d45099bee5809b8de", + "version": 2, + "variants": { + "thumbnail": "83cadf70d6c62047241c4ca2a4fdf5a6253e4ba5f6f32ae9c168242e3a01bb9c", + "crop": "3ed068f5ebdf1f174ac8b668e393630628adaf961cb2d0804906e1512b0ffbf9", + "optimized": "ef5969585ab32986a3afec7837c0879cc511e492df43d778f9fd6c559d00cbf8" + } + }, + { + "fixture": "P-trns", + "source_sha256": "fceab1b967c186e67f707cfea1999b5f5e2a8c19705589ab7b13e666123dafc3", + "version": 1, + "variants": { + "thumbnail": "c8854181b22b8b6347399393ab137bc9a2f80c8b1407757c72c82f5860d79456", + "crop": "980f0a09c18eddbf55397afb9e4cec6c1d0746a3970a27b621a736f19788765a", + "optimized": "b1752fb7bb423ad812328ff10c481a05afe1b071d13f83f1cb1010558b69fd8f" + } + }, + { + "fixture": "P-trns", + "source_sha256": "fceab1b967c186e67f707cfea1999b5f5e2a8c19705589ab7b13e666123dafc3", + "version": 2, + "variants": { + "thumbnail": "d012001f897cfb1548342a411901c07d0b7f99345baacebd5e374f53914dd0b7", + "crop": "597b9512d1bd52d0339e7caa592d1e8d5c7bf0f883d0ed44c96c789f06c0e308", + "optimized": "85c5274013bf991d7c9a4ec81e8fa36fddf481db9146df8530ed7cee48117c2e" + } + }, + { + "fixture": "P-alpha-table", + "source_sha256": "dc85f4c64d4113f2d410500639c1d937f3d0c663fb6c1a65cea71039d63639b8", + "version": 1, + "variants": { + "thumbnail": "3c6650637d6191abca6d32f77530997c6137323b29af71244d301ffe064c2143", + "crop": "69db75fe55439539f246538700b633d0d21fe19c03b28f33fc47983bbfb2ccba", + "optimized": "a92ae6a95ee0d7256fafe388a442f77a9c6af55cae7e9d612a664ecfff22fd16" + } + }, + { + "fixture": "P-alpha-table", + "source_sha256": "dc85f4c64d4113f2d410500639c1d937f3d0c663fb6c1a65cea71039d63639b8", + "version": 2, + "variants": { + "thumbnail": "5fff1b8f7154ce92cccb47b447c06972d7f597ebb59a207f09a7818659e0003e", + "crop": "1b0e050078451a859e68fda260b1120b016321bcc8bf3ef28f89282e37e13e0f", + "optimized": "f27c4a1aa915adb8e528c212d9f4ae7267a745d1b1a61cec1cdb4117f7d8d802" + } + }, + { + "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-trns-1", + "source_sha256": "f77a79729b8812cee847eb4e8f24ea7054bdba290087b658536fdc49a9aabf9e", + "version": 1, + "variants": { + "thumbnail": "f97926ce2a23c180ef435c7a44760e3a78b0a6fccb8da56ba84804718ec065f6", + "crop": "f0008cbf31cd8e901ffaeffd085b3226c3356a34bc5143b8a11d2dc24f8d9009", + "optimized": "906be6b3b50a816613d9f35d57cadfb3224b2a8dcf22a71cae4b384be6f50690" + } + }, + { + "fixture": "2-trns-1", + "source_sha256": "f77a79729b8812cee847eb4e8f24ea7054bdba290087b658536fdc49a9aabf9e", + "version": 2, + "variants": { + "thumbnail": "4cb4efdff1be45fb62f65b5eaaf3bb929d2ec960d0c776b83579b27bf4b95a49", + "crop": "0d2d6cc55a37f5ed0c6bea8e5eea1d33c7d1b9b2c7c9849053dc2c0574eabd1c", + "optimized": "2c3a81d1da03eaa1f385a4e5cb0135f47a7dd8f774689f1e10a3328e94556bde" + } + }, + { + "fixture": "2-no-trns-1", + "source_sha256": "4c459b32ed9d8206b607565244e6754d2a0a3c66116e3fe8cff79bac87c1b586", + "version": 1, + "variants": { + "thumbnail": "bc07132baec7c4d0f8de7ff11a99ca4f6de003f3986695961fa9c3bd02d8dea8", + "crop": "107581841c4bb80a9fc21632efcf35e3e730dec7f0d648db001b4066bed66060", + "optimized": "01cfedcbc7474e049b665658e0e079ccc473905f780585eb654629e38a6c4630" + } + }, + { + "fixture": "2-no-trns-1", + "source_sha256": "4c459b32ed9d8206b607565244e6754d2a0a3c66116e3fe8cff79bac87c1b586", + "version": 2, + "variants": { + "thumbnail": "c5e9673f5d469452fa622583f72fd488d20c7b914b781c1a2c749172714d97f2", + "crop": "c35d882664852625f66bc6c6df7023af020ac3d4017127c7a269788205bd343e", + "optimized": "7a1b4cdd0a43de69156853776a0e5cfc72cb246f437d31f34fe4d79581935747" + } + }, + { + "fixture": "4-trns-1", + "source_sha256": "dab823c38a70c9d01ccb87275a78205622a53fa4d2b94963657b3a3d7bfdbee6", + "version": 1, + "variants": { + "thumbnail": "5345d947f0272154cbe6d051cfe4e2bdd37837f87c324596513a3fe3e146b6bd", + "crop": "7136463e78708461bbcca6ec03b4cf232720d1ace0ddd7d9257ea2895ebb4ac0", + "optimized": "9460683257bee621eefe528262d3e51126fd8c4d1c758bc26d1829edb5910eab" + } + }, + { + "fixture": "4-trns-1", + "source_sha256": "dab823c38a70c9d01ccb87275a78205622a53fa4d2b94963657b3a3d7bfdbee6", + "version": 2, + "variants": { + "thumbnail": "2a232f985439417e336dfe783e42b6c3c0377f11cc353b2144f60b7457cedc35", + "crop": "4a5c1fa318eba36dde865a24c4c311a0b349f8c7a3dc58f6726d6fa77d76aa47", + "optimized": "fbbb1fe383135c4006c11f0549967c9fed8756be8a7734cf20c150be8f8d5027" + } + }, + { + "fixture": "4-no-trns-1", + "source_sha256": "ad468c44c943e4591aac74d5e6fa0c9f20f43a604cbea5a96e5881612ab03dce", + "version": 1, + "variants": { + "thumbnail": "ff015642b65614b601852b3f5d260ba88baf57dedc2cb16729309c279d8d148f", + "crop": "fb4a05fa7d9951c63b7ae4e0ac5ef2cab2cee1cdc4805fbcbbd59d2712fe14fc", + "optimized": "764effa3885b06a2937aa3305efc8d4ec134595562f972febc6d18dc0b720cdb" + } + }, + { + "fixture": "4-no-trns-1", + "source_sha256": "ad468c44c943e4591aac74d5e6fa0c9f20f43a604cbea5a96e5881612ab03dce", + "version": 2, + "variants": { + "thumbnail": "759d51e8d3d7f12bfbc0d0a30d628d17f1de7d4f5080a3d7aef44a32f6e843e4", + "crop": "e146b3da7a2f3b6d4b5a9c35263c04e1527c7481bf214992099109829a5964f3", + "optimized": "b54afe92fc212cbf3a6fd524baae94216594fa18db654c6bdbb89c5146d316e3" + } + }, + { + "fixture": "16-trns-3", + "source_sha256": "b55a8a5c744752708d189051d42cb6dcce5a97de2ec80c7298ecc5a8546d7a53", + "version": 1, + "variants": { + "thumbnail": "eca9198ccb92132ec82f43507321cb3a0ee5d8d3ea320bfa4766940dbe9dd135", + "crop": "1ae364d320387cc7c87cbee35ff43085c900bf0afb13d5ad3074851e988905e9", + "optimized": "8a28dc8a4cf1378af278059ea051bf5ddd93d0305e674831bc0bbe260ef43793" + } + }, + { + "fixture": "16-trns-3", + "source_sha256": "b55a8a5c744752708d189051d42cb6dcce5a97de2ec80c7298ecc5a8546d7a53", + "version": 2, + "variants": { + "thumbnail": "1ef5ddc2c2e6b4d7eb9e6d78d4a2c195b4ff77d7fb453ff51783619d466a5137", + "crop": "2be5d683dfd6ab26a44e5f9e802096bb975400720fbe72bf9be3903fbf270f85", + "optimized": "d7527322761a49f513c0f02659aaee9bafcd94c69228e55975f7bb54b285de96" + } + }, + { + "fixture": "16-no-trns-3", + "source_sha256": "21d53d58165f08972790b60e0d7b5b4b5f219055a5bf5b74b69ca3c6fe73411d", + "version": 1, + "variants": { + "thumbnail": "f17a03faf6a6c203deb891a6d7987da3bbca2dc2343c3e7aa5d9ed7493b986bf", + "crop": "db7a0c1b6a9861ca0636809534cf5f51abb12cc33f88ed74fd6c7cc96a459e15", + "optimized": "baecdfea6208731b391efbe43073220172b1661b652f3c8da79c919f771bb4b4" + } + }, + { + "fixture": "16-no-trns-3", + "source_sha256": "21d53d58165f08972790b60e0d7b5b4b5f219055a5bf5b74b69ca3c6fe73411d", + "version": 2, + "variants": { + "thumbnail": "434ad034488df895e773a88ce3b26c29464490daffc3830c113ccbbc8ceb9341", + "crop": "11349b0225339b420aa0cce2d798ef1bc706029a68761a4fdf55121a839bb986", + "optimized": "043826d5b8a9d04bd4ddf4f0752187e23320f9b2004c3b132f2cdf6fc8655b87" + } + } + ] +} diff --git a/evidence/review-png-memory-2026-11-07/validate.txt b/evidence/review-png-memory-2026-11-07/validate.txt new file mode 100644 index 00000000..37e81884 --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/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/fix-lab5-png-memory/tasks.md b/openspec/changes/fix-lab5-png-memory/tasks.md index 4a3f5a15..9557a7fd 100644 --- a/openspec/changes/fix-lab5-png-memory/tasks.md +++ b/openspec/changes/fix-lab5-png-memory/tasks.md @@ -1,13 +1,13 @@ ## 1. Адаптер attachments: уровни «3» и «4» -- [ ] 1.1 Ограничить временные изображения наложения прозрачности и RGB16-масок плитками, освободить core между проходами без изменения лимитов. -- [ ] 1.2 Проверить thumbnail/crop/optimized offline: точное tRNS, белый фон, границы плиток, EXIF, ошибки и обе версии pipeline. +- [x] 1.1 Ограничить временные изображения наложения прозрачности и RGB16-масок плитками, освободить core между проходами без изменения лимитов. +- [x] 1.2 Проверить thumbnail/crop/optimized offline: точное tRNS, белый фон, границы плиток, EXIF, ошибки и обе версии pipeline. ## 2. Регрессии и доказательства -- [ ] 2.1 Добавить тест освобождения памяти на малых данных и Linux-регрессию реальных четырёх 40 Мп fixtures с импортами worker для финальной фазы. -- [ ] 2.2 Выполнить целевые offline-тесты, границы зон, make check/validate/lint и OpenSpec strict; сохранить команды, результаты и хеши. -- [ ] 2.3 Сохранить список обязательных финальных Linux/HTTP PNG и ресурсных проверок, ограничения применимости evidence и прежние minor. +- [x] 2.1 Добавить тест освобождения памяти на малых данных и Linux-регрессию реальных четырёх 40 Мп fixtures с импортами worker для финальной фазы. +- [x] 2.2 Выполнить целевые offline-тесты, границы зон, make check/validate/lint и OpenSpec strict; сохранить команды, результаты и хеши. +- [x] 2.3 Сохранить список обязательных финальных Linux/HTTP PNG и ресурсных проверок, ограничения применимости evidence и прежние minor. ## 3. Завершение diff --git a/src/messenger/attachments/infrastructure/images.py b/src/messenger/attachments/infrastructure/images.py index fef1f456..5232977d 100644 --- a/src/messenger/attachments/infrastructure/images.py +++ b/src/messenger/attachments/infrastructure/images.py @@ -5,6 +5,7 @@ import warnings from collections.abc import Callable from concurrent.futures import ProcessPoolExecutor from concurrent.futures.process import BrokenProcessPool +from contextlib import closing from dataclasses import dataclass from io import BytesIO @@ -41,6 +42,7 @@ 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 +COLOR_TILE_SIDE = 256 @dataclass(frozen=True, slots=True) @@ -88,7 +90,28 @@ class PillowImageInspector: return ImageInfo(kind, width, height) +def map_tiles( + image: Image.Image, mode: str, transform: Callable[[Image.Image], Image.Image] +) -> Image.Image: + result = Image.new(mode, image.size) + for y in range(0, image.height, COLOR_TILE_SIDE): + for x in range(0, image.width, COLOR_TILE_SIDE): + box = ( + x, + y, + min(x + COLOR_TILE_SIDE, image.width), + min(y + COLOR_TILE_SIDE, image.height), + ) + with closing(image.crop(box)) as tile, closing(transform(tile)) as transformed: + result.paste(transformed, box) + return result + + def rgb_mask(image: Image.Image, color: tuple[int, ...]) -> Image.Image: + return map_tiles(image, "L", lambda tile: rgb_tile_mask(tile, color)) + + +def rgb_tile_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( @@ -104,17 +127,25 @@ def apply_png_transparency(image: PngImageFile, data: bytes) -> None: 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: + with closing(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) + with ( + closing(mask), + closing(rgb_mask(image, tuple(value >> 8 for value in transparent))) as high, + closing(ImageChops.multiply(mask, high)) as combined, + ): + image.paste((255, 255, 255), mask=combined) image.info.pop("transparency") def flatten(image: Image.Image) -> Image.Image: + if image.mode == "RGB" and "transparency" not in image.info: + return image + return map_tiles(image, "RGB", flatten_tile) + + +def flatten_tile(image: Image.Image) -> Image.Image: if image.mode in WIDE_MODES: image = image.convert("I") if (transparent := image.info.pop("transparency", None)) is not None: @@ -157,7 +188,10 @@ def decoded(data: bytes, max_pixels: int) -> tuple[Image.Image, int, int]: ImageOps.exif_transpose(image, in_place=True) if image.size != stored: width, height = height, width - return flatten(image), width, height + upright = flatten(image) + if upright is not image: + image.close() + return upright, width, height except UnreadableImage, MemoryError: raise except Exception as error: diff --git a/student-tests/unit/test_png_memory.py b/student-tests/unit/test_png_memory.py new file mode 100644 index 00000000..7d269721 --- /dev/null +++ b/student-tests/unit/test_png_memory.py @@ -0,0 +1,108 @@ +import json +import subprocess +import sys +import weakref +from pathlib import Path + +import pytest +from PIL import Image, ImageFile +from PIL._util import DeferredError + +from messenger.attachments.infrastructure.images import RenderLimits, render_variants +from png_trns_fixtures import png_with_trns + +CASES = [(2, (1,)), (4, (5,)), (16, (12345,)), (16, (12345, 23456, 34567))] +LIMITS = RenderLimits(10_485_760, 40_000_000) +FIXTURES = Path(__file__).parents[2] / "evidence/final-validation-2026-11-07/fixtures" + + +@pytest.mark.parametrize("depth,key", CASES) +def test_live_pixel_buffers_are_bounded( + monkeypatch: pytest.MonkeyPatch, depth: int, key: tuple[int, ...] +) -> None: + size = (1025, 769) + data, reference = png_with_trns(depth, key, size=size) + expected = render_variants(reference, LIMITS) + references: dict[int, weakref.ReferenceType[Image.Image]] = {} + peak = 0 + original_new = Image.Image._new + original_load = ImageFile.ImageFile.load_prepare + + def record(image: Image.Image) -> None: + nonlocal peak + references[id(image)] = weakref.ref(image) + buffers = {} + for ref in references.values(): + current = ref() + if current is None or current._im is None or isinstance(current._im, DeferredError): + continue + stride = 1 if current.mode in {"1", "L", "P"} else 4 + if current.mode.startswith("I;16"): + stride = 2 + buffers[id(current.im)] = current.width * current.height * stride + peak = max(peak, sum(buffers.values())) + + def allocated(image: Image.Image, core: Image.core.ImagingCore) -> Image.Image: + result = original_new(image, core) + record(result) + return result + + def loaded(image: ImageFile.ImageFile) -> None: + original_load(image) + record(image) + + monkeypatch.setattr(Image.Image, "_new", allocated) + monkeypatch.setattr(ImageFile.ImageFile, "load_prepare", loaded) + assert render_variants(data, LIMITS) == expected + assert peak < size[0] * size[1] * 8 + 2**20, peak + print(json.dumps({"depth": depth, "key": key, "pixel_buffer_peak_bytes": peak})) + + +@pytest.mark.skipif(sys.platform != "linux", reason="RLIMIT_AS проверяется в Linux") +def test_boundary_pngs_fit_worker_address_space() -> None: + script = """ +import json +from io import BytesIO +from pathlib import Path +import resource +import signal +import sys + +import messenger.worker +from PIL import Image +from messenger.attachments.infrastructure.images import RenderLimits, render_variants + +resource.setrlimit(resource.RLIMIT_AS, (448 << 20, 448 << 20)) +limits = RenderLimits(10_485_760, 40_000_000) +for version in (1, 2): + signal.alarm(30) + variants = render_variants(Path(sys.argv[1]).read_bytes(), limits, version) + signal.alarm(0) + assert [(v.name, v.width, v.height) for v in variants] == [ + ("thumbnail", 256, 160), ("crop", 128, 128), ("optimized", 1280, 800) + ] + for variant in variants: + with Image.open(BytesIO(variant.data)) as image: + assert image.getpixel((5, image.height // 2)) == (255, 255, 255) + assert image.getpixel((image.width - 6, image.height // 2)) != (255, 255, 255) +assert len(render_variants(Path(sys.argv[2]).read_bytes(), limits)) == 3 +print(json.dumps({ + "versions": [1, 2], "max_rss_kib": resource.getrusage(resource.RUSAGE_SELF).ru_maxrss +})) +""" + for name in ("gray2", "gray4", "gray16", "rgb16"): + result = subprocess.run( + [ + sys.executable, + "-c", + script, + str(FIXTURES / f"{name}-40mp.png"), + str(FIXTURES.parents[2] / "tests/fixtures/sample.png"), + ], + capture_output=True, + text=True, + timeout=65, + check=True, + ) + assert json.loads(result.stdout)["versions"] == [1, 2] + print(name, result.stdout.strip()) -- 2.54.0 From 6096aa7948b8b666aa3892397a96d044a55f02c6 Mon Sep 17 00:00:00 2001 From: Artyom Date: Sat, 7 Nov 2026 00:48:46 +0300 Subject: [PATCH 50/52] Archive the bounded PNG memory change --- .../review-png-memory-2026-11-07/RESULTS.md | 16 ++++++++++++ .../active-changes-after.json | 7 ++++++ .../active-changes-before-move.json | 15 +++++++++++ .../review-png-memory-2026-11-07/checks.json | 17 ++++++++++++- .../lint-archive.txt | 6 +++++ .../openspec-after-archive.txt | 24 ++++++++++++++++++ .../openspec-before-move.txt | 25 +++++++++++++++++++ .../specs-sync.txt | 24 ++++++++++++++++++ .../.openspec.yaml | 2 ++ .../2026-11-07-fix-lab5-png-memory}/design.md | 0 .../proposal.md | 0 .../specs/lab5-image-variants/spec.md | 0 .../2026-11-07-fix-lab5-png-memory}/tasks.md | 2 +- openspec/specs/lab5-image-variants/spec.md | 5 ++++ 14 files changed, 141 insertions(+), 2 deletions(-) create mode 100644 evidence/review-png-memory-2026-11-07/active-changes-after.json create mode 100644 evidence/review-png-memory-2026-11-07/active-changes-before-move.json create mode 100644 evidence/review-png-memory-2026-11-07/lint-archive.txt create mode 100644 evidence/review-png-memory-2026-11-07/openspec-after-archive.txt create mode 100644 evidence/review-png-memory-2026-11-07/openspec-before-move.txt create mode 100644 evidence/review-png-memory-2026-11-07/specs-sync.txt rename openspec/changes/{fix-lab5-png-memory => archive/2026-11-07-fix-lab5-png-memory}/.openspec.yaml (58%) rename openspec/changes/{fix-lab5-png-memory => archive/2026-11-07-fix-lab5-png-memory}/design.md (100%) rename openspec/changes/{fix-lab5-png-memory => archive/2026-11-07-fix-lab5-png-memory}/proposal.md (100%) rename openspec/changes/{fix-lab5-png-memory => archive/2026-11-07-fix-lab5-png-memory}/specs/lab5-image-variants/spec.md (100%) rename openspec/changes/{fix-lab5-png-memory => archive/2026-11-07-fix-lab5-png-memory}/tasks.md (95%) diff --git a/evidence/review-png-memory-2026-11-07/RESULTS.md b/evidence/review-png-memory-2026-11-07/RESULTS.md index 5e359ca5..5f746da9 100644 --- a/evidence/review-png-memory-2026-11-07/RESULTS.md +++ b/evidence/review-png-memory-2026-11-07/RESULTS.md @@ -41,6 +41,9 @@ Runtime изменён только в `src/messenger/attachments/infrastructure | `make validate` | PASS OpenAPI 3.1 и JSON Schema | [validate.txt](validate.txt) | | `make lint` перед коммитом реализации | PASS ruff check/format и ty | [lint-implementation.txt](lint-implementation.txt) | | `openspec validate --all --strict` до архивации | 23 passed | [openspec-before-archive.txt](openspec-before-archive.txt) | +| `openspec validate --specs --strict`, затем `openspec validate --all --strict` после архивации | 22 passed, дельта синхронизирована | [specs-sync.txt](specs-sync.txt), [openspec-after-archive.txt](openspec-after-archive.txt) | +| `openspec list --json` после архивации | Активных changes нет | [active-changes-after.json](active-changes-after.json) | +| `make lint` перед архивным коммитом | PASS | [lint-archive.txt](lint-archive.txt) | Регрессия на изображениях 1025×769 учитывает одновременно живущие Pillow core, уникальные по identity, через weakref и перехват выделений. Размер пиксельных буферов: @@ -109,3 +112,16 @@ FAIL приложения и не включены в итоговые PASS. расхождение часов прежних измерений и `201` в design-правиле config. Они уже отражены в REPORT. Закрытие назначенного major на уровне реализации не превращает исходные FAIL в PASS; итоговый вердикт требует Linux/HTTP evidence нового SHA. + +## Завершение OpenSpec + +Коммит реализации: `1a8020524909ebc5e2e43303436c9d1ce3c1a87b`. +Change архивирован в `openspec/changes/archive/2026-11-07-fix-lab5-png-memory`, +все шесть задач завершены в границах offline-фазы. Сценарий добавлен в основную +спецификацию без удаления прежних сценариев. Хеши файлов — [checks.json](checks.json). + +Первая попытка переноса архива остановилась до rename из-за обращения к `lab.json.lab` +вместо существующего `lab.json.number`. Проверки в этот момент показывали 23 элемента +и активный завершённый change: [openspec-before-move.txt](openspec-before-move.txt), +[active-changes-before-move.json](active-changes-before-move.json). После исправления +ключа архивирование выполнено, итог — 22 спецификации и пустой список changes. diff --git a/evidence/review-png-memory-2026-11-07/active-changes-after.json b/evidence/review-png-memory-2026-11-07/active-changes-after.json new file mode 100644 index 00000000..c1f7be3b --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/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-png-memory-2026-11-07/active-changes-before-move.json b/evidence/review-png-memory-2026-11-07/active-changes-before-move.json new file mode 100644 index 00000000..04f201d1 --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/active-changes-before-move.json @@ -0,0 +1,15 @@ +{ + "changes": [ + { + "name": "fix-lab5-png-memory", + "completedTasks": 6, + "totalTasks": 6, + "lastModified": "2026-11-06T21:47:57.394Z", + "status": "complete" + } + ], + "root": { + "path": "/Users/artemkostylev/projects/learning/HL/labs/mtusi2026lab5", + "source": "nearest" + } +} diff --git a/evidence/review-png-memory-2026-11-07/checks.json b/evidence/review-png-memory-2026-11-07/checks.json index 76d6c81e..ca6f532b 100644 --- a/evidence/review-png-memory-2026-11-07/checks.json +++ b/evidence/review-png-memory-2026-11-07/checks.json @@ -1,19 +1,34 @@ { "baseline_sha": "fb682bc38476d785d02d4611ba4913e5f37bed62", + "implementation_sha": "1a8020524909ebc5e2e43303436c9d1ce3c1a87b", + "local_links_verified": 18, + "delta_synced": true, "sha256": { "src/messenger/attachments/infrastructure/images.py": "97c6e9c1ef13c8854be9cd2cc11e4279d1d340ba3ab360dfa3e05772923ea743", "student-tests/unit/test_png_memory.py": "49d9fa001d82a2fd495e11da5793ec7f42dfdeb7b0929866e6a0ef94a35f440d", - "evidence/review-png-memory-2026-11-07/RESULTS.md": "2f4e5da18f110420170ad6adf97982797670775d62bb31fb549ab36804a99e01", + "openspec/specs/lab5-image-variants/spec.md": "5473601ca6d24a244e7c5023466a2bb5708ce16a46415bd81b35fe5e5baed578", + "openspec/changes/archive/2026-11-07-fix-lab5-png-memory/.openspec.yaml": "273fea3c6a19b7108aad9607468b03a0a122e03d8660eb157f3cd8c7e4a46737", + "openspec/changes/archive/2026-11-07-fix-lab5-png-memory/design.md": "bb5f6cbafcd3828d7e81ff14954d04bc22ac42668c71178ea5c62a6baa08f72e", + "openspec/changes/archive/2026-11-07-fix-lab5-png-memory/proposal.md": "d15889bf0f14b253009c072048b1822dbe8e08b8a230a0d1939f817939139a37", + "openspec/changes/archive/2026-11-07-fix-lab5-png-memory/specs/lab5-image-variants/spec.md": "8686927a82a34a2b40e948a6680d0f360b1748b8ce87f8d883ef2cca70bb9a72", + "openspec/changes/archive/2026-11-07-fix-lab5-png-memory/tasks.md": "67dd25059098324246d13204d36c553e4b91f32d6a7efc5da7abb5594fa8b040", + "evidence/review-png-memory-2026-11-07/RESULTS.md": "22ae535500e9aa2479851a139126a3e36143eda3e55022ba8df44a834eebc660", + "evidence/review-png-memory-2026-11-07/active-changes-after.json": "b00cf723b88fd2254414abeb7b15015c4fb94a28303b44b59ea542fc57bbdcda", + "evidence/review-png-memory-2026-11-07/active-changes-before-move.json": "99136b09ad0ffbbdddc938f0ec5ffab8b4e2b29b7311c44f55a5cbc72d0b7f1f", "evidence/review-png-memory-2026-11-07/boundaries.txt": "a4d0778a9ba058ff75b48cb3a145ac59e8c7ae9f3764db8fb6a0425c242bf8d2", "evidence/review-png-memory-2026-11-07/check.txt": "5f42d25d7cd8c1d2fb31ccf28a2872fbb91d38ed094024181e5ace9671667ee6", "evidence/review-png-memory-2026-11-07/compatibility-command.txt": "09d5bbe4568422aa69917031cf1e6ba8ccc3cf7f241ac88343812f8bf231176d", "evidence/review-png-memory-2026-11-07/compatibility.txt": "bd3bf1841e476fcc62d6266123bfcf21dc259bf89160a4dda31ba301f429c57d", "evidence/review-png-memory-2026-11-07/findings.json": "449ab0c9fc33060b54310c622684287525c5508204a47e7aacda1e44dc77b037", + "evidence/review-png-memory-2026-11-07/lint-archive.txt": "4d6c5ac9c907f1066911fd027b328c8d9038ef46ded69c392c54d9f8d27d4865", "evidence/review-png-memory-2026-11-07/lint-implementation.txt": "4d6c5ac9c907f1066911fd027b328c8d9038ef46ded69c392c54d9f8d27d4865", "evidence/review-png-memory-2026-11-07/offline-tests.txt": "9efe9e43fc7e9d7a2bde18e3d54efdeeb2387a1081457ef8b2615451f2583fe9", + "evidence/review-png-memory-2026-11-07/openspec-after-archive.txt": "b185f34cf979a6739249722b3df8000dcfbd0618b424dae99130e059d7cd20c7", "evidence/review-png-memory-2026-11-07/openspec-before-archive.txt": "360f59e3eb964da51f37ce7c00637e41e835670a5c657b2055a496f2f36a76f9", + "evidence/review-png-memory-2026-11-07/openspec-before-move.txt": "360f59e3eb964da51f37ce7c00637e41e835670a5c657b2055a496f2f36a76f9", "evidence/review-png-memory-2026-11-07/regression-before-command.txt": "b3a571ede4d8fe5239bb3a3f4bcb1a1d9ce257d1e580f4aac64cdcb178cc41be", "evidence/review-png-memory-2026-11-07/regression-before.txt": "02649ec20f6bbd4ec299d457f704d3c1473eda82b6da7b9808a733fdce947123", + "evidence/review-png-memory-2026-11-07/specs-sync.txt": "b185f34cf979a6739249722b3df8000dcfbd0618b424dae99130e059d7cd20c7", "evidence/review-png-memory-2026-11-07/static-audit.json": "4c6b5bb3e410c6df9a21037313828cea2b0393de610b94646f27bde3c22b9cf7", "evidence/review-png-memory-2026-11-07/unchanged-rendering.json": "f5bf484467198d9cec40affd97c42cfcd0a37c40c49a20ea604ce14babc292e8", "evidence/review-png-memory-2026-11-07/validate.txt": "422aec45ba93e5567e0de199fa32116a48c970ca3b82738b40f0ed7681ef621f" diff --git a/evidence/review-png-memory-2026-11-07/lint-archive.txt b/evidence/review-png-memory-2026-11-07/lint-archive.txt new file mode 100644 index 00000000..d8519183 --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/lint-archive.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 +198 files already formatted +.venv/bin/ty check src student-tests alembic +All checks passed! diff --git a/evidence/review-png-memory-2026-11-07/openspec-after-archive.txt b/evidence/review-png-memory-2026-11-07/openspec-after-archive.txt new file mode 100644 index 00000000..57b14b1f --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/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-png-memory-2026-11-07/openspec-before-move.txt b/evidence/review-png-memory-2026-11-07/openspec-before-move.txt new file mode 100644 index 00000000..6b536d1f --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/openspec-before-move.txt @@ -0,0 +1,25 @@ +- Validating... +✓ change/fix-lab5-png-memory +✓ 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-png-memory-2026-11-07/specs-sync.txt b/evidence/review-png-memory-2026-11-07/specs-sync.txt new file mode 100644 index 00000000..57b14b1f --- /dev/null +++ b/evidence/review-png-memory-2026-11-07/specs-sync.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/openspec/changes/fix-lab5-png-memory/.openspec.yaml b/openspec/changes/archive/2026-11-07-fix-lab5-png-memory/.openspec.yaml similarity index 58% rename from openspec/changes/fix-lab5-png-memory/.openspec.yaml rename to openspec/changes/archive/2026-11-07-fix-lab5-png-memory/.openspec.yaml index e582ee4a..ce752661 100644 --- a/openspec/changes/fix-lab5-png-memory/.openspec.yaml +++ b/openspec/changes/archive/2026-11-07-fix-lab5-png-memory/.openspec.yaml @@ -1,2 +1,4 @@ schema: spec-driven created: 2026-11-07 +archived: 2026-11-07 +lab: 5 diff --git a/openspec/changes/fix-lab5-png-memory/design.md b/openspec/changes/archive/2026-11-07-fix-lab5-png-memory/design.md similarity index 100% rename from openspec/changes/fix-lab5-png-memory/design.md rename to openspec/changes/archive/2026-11-07-fix-lab5-png-memory/design.md diff --git a/openspec/changes/fix-lab5-png-memory/proposal.md b/openspec/changes/archive/2026-11-07-fix-lab5-png-memory/proposal.md similarity index 100% rename from openspec/changes/fix-lab5-png-memory/proposal.md rename to openspec/changes/archive/2026-11-07-fix-lab5-png-memory/proposal.md diff --git a/openspec/changes/fix-lab5-png-memory/specs/lab5-image-variants/spec.md b/openspec/changes/archive/2026-11-07-fix-lab5-png-memory/specs/lab5-image-variants/spec.md similarity index 100% rename from openspec/changes/fix-lab5-png-memory/specs/lab5-image-variants/spec.md rename to openspec/changes/archive/2026-11-07-fix-lab5-png-memory/specs/lab5-image-variants/spec.md diff --git a/openspec/changes/fix-lab5-png-memory/tasks.md b/openspec/changes/archive/2026-11-07-fix-lab5-png-memory/tasks.md similarity index 95% rename from openspec/changes/fix-lab5-png-memory/tasks.md rename to openspec/changes/archive/2026-11-07-fix-lab5-png-memory/tasks.md index 9557a7fd..8b877e28 100644 --- a/openspec/changes/fix-lab5-png-memory/tasks.md +++ b/openspec/changes/archive/2026-11-07-fix-lab5-png-memory/tasks.md @@ -11,4 +11,4 @@ ## 3. Завершение -- [ ] 3.1 Синхронизировать спецификацию и архивировать change; проверить чистоту нормативных файлов и сделать английские коммиты после make lint. +- [x] 3.1 Синхронизировать спецификацию и архивировать change; проверить чистоту нормативных файлов и сделать английские коммиты после make lint. diff --git a/openspec/specs/lab5-image-variants/spec.md b/openspec/specs/lab5-image-variants/spec.md index bb254bf8..8f15a11d 100644 --- a/openspec/specs/lab5-image-variants/spec.md +++ b/openspec/specs/lab5-image-variants/spec.md @@ -51,6 +51,11 @@ Worker SHALL ограничивать обработку одного задан - **WHEN** со штатными пределами загружен PNG 8000×5000 - **THEN** вложение становится `ready` с тремя вариантами, пик памяти контейнера worker ниже его предела +#### Scenario: Прозрачный PNG на пределе пикселей + +- **WHEN** последовательно обработаны PNG 8000×5000 grayscale 2/4/16 и RGB16 с tRNS при штатных 448 MiB адресного пространства рендера и 30 с на задание, затем запрошена версия pipeline 2 +- **THEN** каждый upload отвечает `202 queued`, обе версии становятся `ready` с тремя вариантами и неизменным оригиналом; прозрачные области белые, соседний непрозрачный цвет сохраняется, worker остаётся работоспособным и обрабатывает следующее обычное задание + #### Scenario: Пиксели сверх предела по заголовку - **WHEN** worker получает задание на оригинал, у которого по заголовку больше `MAX_IMAGE_PIXELS` пикселей -- 2.54.0 From 74c33160ac01618f70e9e1c6a121a5e45c3c7155 Mon Sep 17 00:00:00 2001 From: Artyom Date: Sat, 7 Nov 2026 01:53:09 +0300 Subject: [PATCH 51/52] Update lab 5 report after PNG memory review --- AGENTS.md | 12 ++-- REPORT.md | 67 ++++++++++++++------ evidence/README.md | 20 +++--- evidence/report-memory-audit-2026-11-07.md | 71 ++++++++++++++++++++++ 4 files changed, 138 insertions(+), 32 deletions(-) create mode 100644 evidence/report-memory-audit-2026-11-07.md diff --git a/AGENTS.md b/AGENTS.md index 02e3df0d..b8e429c6 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -71,17 +71,19 @@ make down # остановка своего project без ## Состояние доказательств после ревью -Индекс — [evidence/README.md](evidence/README.md), отчёт — [REPORT.md](REPORT.md). Последняя полная динамическая квалификация — `0e921116610d289716af0a40ec823376eb8bbcbc`; успешное повторное review — `42575281b352d35bda17ee7601bae5548a996e91`. Между ними runtime изменён только в renderer PNG и policy RabbitMQ. Старые PASS не обозначать прогоном текущего кода. +Индекс — [evidence/README.md](evidence/README.md), отчёт — [REPORT.md](REPORT.md). Текущий код после исправления памяти и независимого re-review — `6096aa7948b8b666aa3892397a96d044a55f02c6` (M). Последняя полная динамическая квалификация — `0e921116610d289716af0a40ec823376eb8bbcbc` (D); предыдущее review — `42575281b352d35bda17ee7601bae5548a996e91` (R). От D к R менялись renderer PNG и policy RabbitMQ; от R к M из runtime изменён только renderer. Старые PASS не обозначать прогоном M. -Финальная validation на `b30e2f6a84419d1ca64525ffb40df92183cccaef` (runtime = reviewed R) завершила real PostgreSQL outage: 12 requeue → ready без replay, policy `delivery-limit=-1` на сохранённом volume, DLQ не выросла. HTTP PNG: 8 fixtures / 48 сравнений вариантов v1/v2 PASS. Delivery subset: 12 сценариев / 8 инвариантов PASS. Student-test: 980 passed / 1 Linux-only skip. Аудит повторного использования — [evidence/load-validation.md](evidence/load-validation.md), результаты — [evidence/final-validation-2026-11-07/RESULTS.md](evidence/final-validation-2026-11-07/RESULTS.md). +Validation на `b30e2f6a84419d1ca64525ffb40df92183cccaef` (V, runtime = R) завершила реальный PostgreSQL outage: 12 requeue → ready без replay, policy `delivery-limit=-1` на сохранённом volume, DLQ не выросла. HTTP PNG: 8 fixtures / 48 сравнений вариантов v1/v2 PASS. Delivery subset: 12 сценариев / 8 инвариантов PASS. Student-test: 980 passed / 1 Linux-only skip. Исторический аудит — [evidence/load-validation.md](evidence/load-validation.md), результаты V — [evidence/final-validation-2026-11-07/RESULTS.md](evidence/final-validation-2026-11-07/RESULTS.md). -**Новый major, validation blocked:** четыре PNG tRNS 8000×5000 (grayscale 2/4/16 и RGB16) получают 202 → failed/processing_failed при штатных 448 MiB/30 с вместо объявленного ready. Linux-пробник с импортами worker подтверждает MemoryError. Требуются отдельный fix/re-review и повтор только затронутых PNG/ресурсных сценариев. Реализация финальной фазой не менялась, исходные FAIL сохранены; полный track2 и пригодные серии автоматически не повторять. Свой стенд остановлен, четыре volume сохранены; push не выполнялся. +**Прежний major ожидает динамического закрытия:** на V четыре PNG tRNS 8000×5000 (grayscale 2/4/16 и RGB16) дали 202 → failed/processing_failed при штатных 448 MiB/30 с. В M преобразования ограничены плитками 256×256, pixel core явно освобождаются; конфигурация лимитов не увеличивалась. Сохранённые проверки: 440 offline passed / 2 Linux-only skipped + 20 границ; 132 варианта для 22 изображений побайтно совпали с V. Независимое review M не нашло major в статике/offline. Эти результаты не заменяют ещё не выполненные Linux/HTTP-проверки нового renderer, исходные FAIL сохранены. -Пять minor сохраняются: crash_publish_confirm фактически после confirm до COMMIT outbox; limits.py имеет ложный FAIL порядка secrets; reconcile_track.py ожидает upload 201 ЛР4; failed upgrade v2 нельзя отдельно повторить при ready v1; UTC/elapsed run2/3 расходятся и исключены из performance-выводов. Корневые старые evidence до SQLAlchemy — история; происхождение и неприменимость обозначены в индексе. +Следующая фаза проверяет прежние четыре 40 Мп PNG и grayscale16 без tRNS с импортами worker, обычную работу после отказа, concurrency=2, точный tRNS, HTTP subset 8/48, v1/v2, принудительные лимиты и cleanup после sweep. Точная процедура — [evidence/review-png-memory-2026-11-07/RESULTS.md](evidence/review-png-memory-2026-11-07/RESULTS.md). Полные track2, PostgreSQL outage и delivery subset без нового основания не повторять: соответствующий runtime не менялся. Последний наблюдавшийся стенд V остановлен, четыре volumes сохранены; исправление и отчёт Docker не запускали. + +Семь minor последнего review сохраняются в REPORT: crash_publish_confirm фактически после confirm до COMMIT outbox; limits.py имеет ложный FAIL порядка secrets; reconcile_track.py ожидает upload 201 ЛР4; failed upgrade v2 нельзя отдельно повторить при ready v1; UTC/elapsed run2/3 расходятся; design-правило config сохранило 201; JobMessage допускает преобразования типов и null вне jobs.schema.json. Последний minor воспроизведён reviewer в четырёх offline-пробах (bus/ack вместо reject); штатный relay формирует корректные сообщения, критичного последствия не установлено. Происхождение — [аудит обновления отчёта](evidence/report-memory-audit-2026-11-07.md). Корневые старые evidence до SQLAlchemy остаются историей. ## Уровни оценки -Цель — **«5»**, трек 2 «Доказанная идемпотентность pipeline». Полное подтверждение для текущего кода заявлять только после устранения major граничного PNG, review и адресной проверки; таблица доказательств и границы применимости — в `REPORT.md`. +Цель — **«5»**, трек 2 «Доказанная идемпотентность pipeline». Полное подтверждение для текущего кода заявлять только после адресного Linux/HTTP-подтверждения исправления M и окончательного закрытия прежнего major; таблица доказательств и границы применимости — в `REPORT.md`. - **3** — `202 queued` после staging и `COMMIT` задания с outbox; отдельные `broker`, `relay`, `worker` в стенде; durable quorum queue, publisher confirm, ручной `ack` после `COMMIT`; состояния `queued/processing/ready/failed`, оригинал в `originals/` и thumbnail; ограниченный retry (`JOB_MAX_ATTEMPTS=5`) и `failed` с `error_code`; повтор job без второго набора вариантов; worker остановлен → upload → сообщение → рестарт API и broker → worker → `ready`; минимум lab4 сохранён. - **4** — crop и optimized WebP, лимиты worker по байтам, пикселям, времени и памяти, crash между `COMMIT` и publish, backoff с jitter и классификация ошибок, DLQ и replay, crash после записи объекта до `ack`, lease и fencing для зависшего `processing`, prefetch, очистка staging. diff --git a/REPORT.md b/REPORT.md index 76caebcd..fdec9df7 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,22 +1,22 @@ # Отчёт — лабораторная работа 5 Автор: **Костылев Артём, БПИ2303**. Тема: «Очереди и асинхронная обработка изображений». -Цель — **«5», трек 2 «Доказанная идемпотентность pipeline»**. Финальная validation заблокирована одним major: новые PNG tRNS на границе 40 Мп получают `processing_failed` при штатных 448 MiB вместо заявленного ready. Остальные адресные проверки завершены. Нужны отдельный fix и review; полное подтверждение «5» и готовность к публикации не заявляются. +Цель — **«5», трек 2 «Доказанная идемпотентность pipeline»**. Причина major с памятью PNG исправлена, независимое повторное ревью не обнаружило major в статике/offline. Окончательное закрытие прежнего дефекта требует адресных Linux/HTTP-проверок нового renderer; они ещё не выполнены. Исходные четыре FAIL сохранены. Полное подтверждение «5» и готовность к публикации пока не заявляются. -Ветка: `solution/bpi2303-kostylev`. Проверенный ревью код: `42575281b352d35bda17ee7601bae5548a996e91` (далее **R**). Последняя полная динамическая квалификация: `0e921116610d289716af0a40ec823376eb8bbcbc` (далее **D**). Между D и R из runtime изменены только `infra/rabbitmq/definitions.json` и `src/messenger/attachments/infrastructure/images.py`; SQLAlchemy, Alembic, outbox, lease/fencing и публикация версий не изменились. Финальные проверки выполнены на `b30e2f6a84419d1ca64525ffb40df92183cccaef` (V), runtime которого побайтно совпадает с R. Документационные коммиты отчёта и evidence не меняют runtime. Публикация — отдельная фаза, только в private MTUCI-Labs; этот этап ничего не публикует. +Ветка: `solution/bpi2303-kostylev`. Предыдущее ревью: `42575281b352d35bda17ee7601bae5548a996e91` (далее **R**). Последняя полная динамическая квалификация: `0e921116610d289716af0a40ec823376eb8bbcbc` (далее **D**). Между D и R из runtime изменены только `infra/rabbitmq/definitions.json` и `src/messenger/attachments/infrastructure/images.py`; SQLAlchemy, Alembic, outbox, lease/fencing и публикация версий не изменились. Финальные проверки выполнены на `b30e2f6a84419d1ca64525ffb40df92183cccaef` (V), runtime которого побайтно совпадает с R. Текущий код после исправления памяти и повторного ревью — **`6096aa7948b8b666aa3892397a96d044a55f02c6` (M)**; реализация исправления — `1a8020524909ebc5e2e43303436c9d1ce3c1a87b`. От V из runtime изменён только `images.py`, настройки 448 MiB/30 с/concurrency=2 сохранены. Полный student-test и HTTP-результаты V не являются прогоном M. Документационные коммиты отчёта и evidence не меняют runtime. Публикация — отдельная фаза, только в private MTUCI-Labs; этот этап ничего не публикует. Индекс происхождения всех доказательств — [evidence/README.md](evidence/README.md). Источники решения: skeleton и контракт курса, собственная ЛР4 с поздними исправлениями до `4ed889c1e4008e3f6040ae2534bef99262d3b8ce`, документация библиотек; при подготовке использован Codex. Перенос 253 файлов разобран в [forward-port.md](evidence/forward-port.md). Нормативные `contracts/`, `tests/`, `README.md`, `COURSE.md` не изменены. ## Воспроизведение из чистого clone -Нужны доступ к приватному репозиторию, Git, Docker с Compose v2, make, системный Python 3.9+, uv и OpenSpec CLI для проверки спецификаций. Приложение использует Python 3.14. Команды ниже — инструкция, а не заявление о новом прогоне из clone: первый отчётный этап Docker не запускал; последующая validation использовала существующие volumes, а не чистый clone. +Нужны доступ к приватному репозиторию, Git, Docker с Compose v2, make, системный Python 3.9+, uv и OpenSpec CLI для проверки спецификаций. Приложение использует Python 3.14. Команды ниже — инструкция, а не заявление о новом прогоне из clone: отчётные этапы Docker не запускали; validation V использовала существующие volumes, а не чистый clone. Для воспроизведения выбран M. Вместо `` подставляется URL репозитория ЛР5 в MTUCI-Labs, доступный после публикации. На общей машине запуск разрешён только в выделенной фазе и своём project; занятые порты не освобождают остановкой чужих контейнеров. ```sh git clone mtusi2026lab5 cd mtusi2026lab5 -git checkout 42575281b352d35bda17ee7601bae5548a996e91 +git checkout 6096aa7948b8b666aa3892397a96d044a55f02c6 export COMPOSE_PROJECT_NAME=mtusi2026lab5 export COMPOSE_FILE=compose.yaml export API_IMAGE=mtusi-messenger:lab5-reviewed @@ -73,26 +73,29 @@ Python 3.14, FastAPI, gunicorn/uvicorn-worker, dishka и dishka-faststream, pyda **Worker и эффект.** FastStream использует `AckPolicy.MANUAL`, `RabbitMessage`, prefetch=2 при `WORKER_CONCURRENCY=2`. Worker берёт доверенные ключи S3 из БД, захватывает job арендой `lease_token`, продлевает её при работе и рендерит в отдельном процессе. После записи оригинала и всех трёх вариантов условный COMMIT проверяет актуальность аренды. Ключ эффекта — `(attachment_id, pipeline_version, name)`; уникальные ограничения, versioned S3-ключи с хешем и условие `published_version < new_version` предотвращают второй набор и откат новой публикации. `ack()` вызывается после завершения обработчика с COMMIT, включая фиксацию результата/noop. Ошибка БД приводит к задержке 1 с и `nack(requeue=True)`. -**Повторы.** После claim временная ошибка назначает новую outbox-попытку с equal jitter: половина экспоненциальной задержки плюс случайная половина; штатная база 2 с, максимум 5 попыток. Постоянные ошибки дают `invalid_image`/`processing_failed`, исчерпание — `retry_exhausted`. Просроченный processing возвращает relay через `jobs_lease_idx`; старый держатель не проходит fencing. Ready не откатывается при upgrade, ошибка v2 оставляет v1 доступной. Невалидное сообщение отвергается в DLQ; реестр failed и replay доступны через CLI. +**Повторы.** После claim временная ошибка назначает новую outbox-попытку с equal jitter: половина экспоненциальной задержки плюс случайная половина; штатная база 2 с, максимум 5 попыток. Постоянные ошибки дают `invalid_image`/`processing_failed`, исчерпание — `retry_exhausted`. Просроченный processing возвращает relay через `jobs_lease_idx`; старый держатель не проходит fencing. Ready не откатывается при upgrade, ошибка v2 оставляет v1 доступной. Сообщение, отвергнутое моделью `JobMessage`, отправляется в DLQ; модель не полностью эквивалентна `jobs.schema.json` из-за преобразования типов и nullable-поля (minor ниже). Реестр failed и replay доступны через CLI. В R policy `delivery-limit=-1` сохраняет инфраструктурные redelivery при длительном отказе БД; прикладной предел `JOB_MAX_ATTEMPTS=5` остаётся. Это исправляет прежний путь queued → DLQ после 10 nack без автоматического восстановления. На V policy подтверждена на существующем volume: 12 requeue после реальной остановки PostgreSQL, затем ready без replay и без роста DLQ — [evidence](evidence/final-validation-2026-11-07/postgres-outage-retry.json); уже лежащие в DLQ сообщения смена policy не возвращает. Произвольное удаление сообщения при уже опубликованном outbox также не исправляется автоматически: outbox/lease не равны универсальной сверке очереди. **Изображения и ресурсы.** Оригинал неизменен. EXIF orientation применяется, прозрачность накладывается на белый фон, EXIF/ICC/XMP не копируются в варианты. Thumbnail — JPEG в 256×256 без увеличения, округление вниз, минимум 1 px; crop — центральный JPEG 128×128; optimized — WebP в 1280×1280 без увеличения. JPEG quality v1/v2 = 85/90, optimize=True; WebP = 80/85, method=4; Lanczos, reducing_gap=3.0. R исправляет tRNS, включая grayscale 2/4/16 и сравнение полных RGB16 samples до потери младших битов. -Предел входа — 10 485 760 байт и 40 млн пикселей; renderer — 30 с, Linux `RLIMIT_AS=448 MiB` на процесс, до 100 задач на дочерний процесс. Контейнер worker ограничен 2 CPU / 1 GiB, API — 1 CPU / 512 MiB на реплику, relay — 0.5 CPU / 192 MiB, broker — 1 CPU / 512 MiB, PostgreSQL — 2 CPU / 1 GiB, S3 — 1 CPU / 512 MiB. Старое измерение 423 MiB относится к обычному PNG. На V четыре 40 Мп PNG tRNS дали `processing_failed` на первой попытке; Linux-пробник подтверждает `MemoryError` внутри RLIMIT_AS, несмотря на peak контейнера 640 196 608 байт < 1 GiB. Граничный сценарий остаётся major. +Предел входа — 10 485 760 байт и 40 млн пикселей; renderer — 30 с, Linux `RLIMIT_AS=448 MiB` на процесс, до 100 задач на дочерний процесс. Контейнер worker ограничен 2 CPU / 1 GiB, API — 1 CPU / 512 MiB на реплику, relay — 0.5 CPU / 192 MiB, broker — 1 CPU / 512 MiB, PostgreSQL — 2 CPU / 1 GiB, S3 — 1 CPU / 512 MiB. Старое измерение 423 MiB относится к обычному PNG. На V четыре 40 Мп PNG tRNS дали `processing_failed` на первой попытке; Linux-пробник подтверждает `MemoryError` внутри RLIMIT_AS, несмотря на peak контейнера 640 196 608 байт < 1 GiB. Это исходное доказательство major на V; исправление M ещё не подтверждено на той же Linux/HTTP-границе. + +**Исправление памяти M.** Преобразования цвета и RGB-маски вычисляются плитками 256×256; глобальные resize/fit остаются после сборки изображения, чтобы не создавать границы плиток. Low-byte core закрывается перед high-byte decode, маски — до EXIF/resize, grayscale-исходник — после сборки RGB. `Image.close()` уничтожает pixel core; обычный выход из контекста изображения закрывает файл, но сохраняет core — [Pillow 13.0.0](https://github.com/python-pillow/Pillow/blob/13.0.0/docs/reference/open_files.rst). Сохранённое сравнение 132 вариантов побайтно совпало с V, но новые затраты Linux-процесса этим не измерены. **Очистка.** Staging удаляется после безопасной публикации и завершения активных версий; у failed хранится 86400 с, затем replay возвращает expired. Проверка активных jobs и сериализация cleanup/reprocess защищают используемый исходник. Удаление выполняет relay; worker не получает право DeleteObject. Quarantine-миграция поддерживает унаследованную сверку S3, но демонстратор `reconcile_track.py` для квалификации ЛР5 непригоден. ## Проверки и таблица критериев -Исторические динамические PASS относятся к **D**, 2026-11-06 UTC; более ранняя топология и новые проверки V помечены явно. Это аудит сохранённых прогонов, не новый запуск на R. Новые tRNS и policy дополнительно проверены динамически на V в отдельном блоке ниже; эти результаты не смешиваются с D. Полные команды, environment, exit codes и SHA находятся в связанных файлах. +Исторические динамические PASS относятся к **D**, 2026-11-06 UTC; более ранняя топология и новые проверки V помечены явно. Это аудит сохранённых прогонов, не новый запуск на M. Новые tRNS и policy дополнительно проверены динамически на V в отдельном блоке ниже; эти результаты не смешиваются с D. Полные команды, environment, exit codes и SHA находятся в связанных файлах. | Критерий | Команда / сценарий | Наблюдение | Файл | | --- | --- | --- | --- | -| Контракт, синтаксис, типы | `make check validate lint` | PASS на R, повторены на этапе отчёта; приложение этим не проверяется | [Аудит отчёта](evidence/report-audit-2026-11-07.md) | -| Собственные интеграционные тесты | `make student-test PYTEST_ARGS='-q --tb=short'` | V: 980 passed, 1 Linux-only skip, 19 stack deselected; полный запуск с real-broker | [student-test.txt](evidence/final-validation-2026-11-07/student-test.txt) | -| Текущие исправления | Offline-команда с `--confcutdir`, шесть unit-модулей; отдельно `--noconftest` для границ | R: сохранённые 430 + 20 passed; 114 прежних вариантов побайтно совпали; Docker не участвовал | [Команды и результаты](evidence/review-trns-depth-2026-11-06/RESULTS.md) | -| OpenSpec | `openspec validate --all --strict`; `openspec list --json` | 22 спецификации PASS, активных changes нет | [Аудит отчёта](evidence/report-audit-2026-11-07.md) | +| Контракт, синтаксис, типы | `make check validate lint` | PASS на M в повторном отчётном этапе; приложение этим не проверяется | [Аудит обновления](evidence/report-memory-audit-2026-11-07.md) | +| Собственные интеграционные тесты | `make student-test PYTEST_ARGS='-q --tb=short'` | V: 980 passed, 1 Linux-only skip, 19 stack deselected; полный запуск с real-broker до M | [student-test.txt](evidence/final-validation-2026-11-07/student-test.txt) | +| Предыдущее исправление tRNS | Offline-команда с `--confcutdir`, шесть unit-модулей; отдельно `--noconftest` для границ | R: сохранённые 430 + 20 passed; 114 прежних вариантов побайтно совпали; Docker не участвовал | [Команды и результаты](evidence/review-trns-depth-2026-11-06/RESULTS.md) | +| Исправление памяти M | `make student-test` с `--confcutdir` и восемью unit-модулями; отдельно `--noconftest` для границ | Сохранённые 440 passed / 2 Linux-only skipped + 20 passed; 22 изображения / 132 идентичных варианта. Полный student-test и Linux/HTTP на M не запускались | [Команды](evidence/review-png-memory-2026-11-07/RESULTS.md), [offline](evidence/review-png-memory-2026-11-07/offline-tests.txt), [границы](evidence/review-png-memory-2026-11-07/boundaries.txt) | +| OpenSpec | `openspec validate --all --strict`; `openspec list --json` | M: 22 спецификации PASS, активных changes нет; цикл исправления памяти архивирован | [Аудит обновления](evidence/report-memory-audit-2026-11-07.md) | | 3: минимум lab1–4, 202 и thumbnail | `make test` | Публичный smoke PASS через LB | [final-smoke.txt](evidence/forward-final-2026-11-06/final-smoke.txt) | | 3: сессия, исходник и данные после рестарта | `make test-persistence ACTION_SCRIPT=scripts/restart.sh` | PASS; рестарты своих хранилищ и процессов подтверждены событиями | [persistence.txt](evidence/forward-final-2026-11-06/persistence.txt), [контейнеры](evidence/forward-final-2026-11-06/persistence-containers.txt) | | 3: отказ реплики | `make test-failover ACTION_SCRIPT=scripts/stop-one.sh`; `make restore` | 131 успешная запись, 0 ошибок, первая после отказа через 2.791 с; api-2 остановлен и восстановлен | [failover.txt](evidence/forward-final-2026-11-06/failover.txt), [контейнеры](evidence/forward-final-2026-11-06/failover-containers.txt), [restore.txt](evidence/forward-final-2026-11-06/restore.txt) | @@ -160,21 +163,23 @@ Python 3.14, FastAPI, gunicorn/uvicorn-worker, dishka и dishka-faststream, pyda ## Ограничения и незавершённые подтверждения -Пять minor успешного повторного ревью сохранены без исправления; они не блокируют отчёт или передачу следующей фазе: +Семь minor последнего независимого ревью M сохранены без исправления; они не блокируют отчёт или передачу следующей фазе. Новый minor JobMessage передан координатором в результате `lab5-release-load0-round1`; в отчётном этапе его offline-пробы не повторялись: | Файл | Ограничение / доказательство | | --- | --- | | `src/messenger/attachments/application/pipeline.py:230` | `after_publish_before_confirm` вызывается после `publish()`, уже получившего Basic.Ack. `crash_publish_confirm` проверяет окно после confirm до COMMIT outbox, а не потерю confirm. См. [findings.json](evidence/review-trns-depth-2026-11-06/findings.json). | | `scripts/limits.py:10` | Несортированный список secrets сравнивается с отсортированным и даёт два ложных FAIL. [Сохранённый запуск](evidence/sqlalchemy-2026-11-06/grade3/limits.txt) имеет exit_code=1; PASS ему не присваивается. | | `scripts/reconcile_track.py:396` | Демонстратор ждёт upload 201 и `attachments/` из ЛР4; для ЛР5 с 202 непригоден и в квалификации не используется. См. [findings.json](evidence/forward-final-2026-11-06/findings.json). | -| `src/messenger/attachments/application/pipeline.py:333` | Failed upgrade v2 при ready v1 нельзя отдельно повторить replay/reprocess; v1 остаётся доступной. Проверка `test_failed_new_version_keeps_ready_original` — [student-test.txt](evidence/forward-final-2026-11-06/student-test.txt). | +| `src/messenger/attachments/application/pipeline.py:304` | Failed upgrade v2 при ready v1 нельзя отдельно повторить replay/reprocess; v1 остаётся доступной. Проверка `test_failed_new_version_keeps_ready_original` — [student-test.txt](evidence/forward-final-2026-11-06/student-test.txt). | | `evidence/forward-final-2026-11-06/clock-observation.json` | Расхождение часов в run2/3; время не используется для performance-выводов. | +| `openspec/config.yaml:130` | Унаследованное design-правило указывает upload 201 вместо нормативного 202. Конфиг вне scope отчётной фазы. | +| `src/messenger/attachments/entrypoints/schemas.py:67` | Модель допускает `attempt="1"`, `pipeline_version=true`, числовой `created_at` и `traceparent=null` вне `jobs.schema.json`. В четырёх offline-пробах ревью вызваны bus/ack, reject=0. Штатный relay формирует корректные сообщения; критичного последствия не установлено. [Источник и границы проверки](evidence/report-memory-audit-2026-11-07.md). | Один host, один PostgreSQL, S3 и узел quorum RabbitMQ не обеспечивают HA. Инфраструктурные redelivery теперь не ограничены числом доставок и при долгом отказе создают повторные обращения/логи; прикладные ошибки после claim ограничены. SIGTERM во время обработки может задержать повтор до истечения аренды. Replay сбрасывает attempt с audit и не ограничивает число ручных запусков. Три повтора не покрывают все чередования событий. Уже опубликованные ready-объекты автоматически новым renderer не переписываются; RGB16+tRNS зависит от tile rawmode Pillow и требует регрессий при обновлении. `openspec/config.yaml` проверен, но не изменён: разрешённый scope отчётной фазы исключает конфиги и OpenSpec. Он уже содержит SQLAlchemy/Alembic и контекст ЛР5; в унаследованном правиле design осталось `201` для PostgreSQL+S3. Для upload ЛР5 нормативен `202` после staging и COMMIT, как в `contracts/`. Эта документационная неточность не меняет HTTP-реализацию. -## Финальная validation V: результат и оставшееся исправление +## Историческая validation V: завершённые проверки и исходный major Аудит по README, измеренному SHA, diff, конфигурации, ресурсам, dataset, повторам и сырью — [load-validation.md](evidence/load-validation.md). Три пригодных функциональных track2-повтора приняты, вся матрица повторно не запускалась. Изменение только документации не аннулирует эти свидетельства. Новых SLO/throughput-обещаний нет: выбран трек 2. @@ -182,20 +187,44 @@ Python 3.14, FastAPI, gunicorn/uvicorn-worker, dishka и dishka-faststream, pyda | --- | --- | --- | | `make check validate lint`, OpenSpec | PASS; 22 спецификации, changes=[] | [checks](evidence/final-validation-2026-11-07/checks.txt), [OpenSpec](evidence/final-validation-2026-11-07/openspec.txt) | | Сборка и публичный `make test` | PASS; образ содержит reviewed images.py, версии закреплены | [build](evidence/final-validation-2026-11-07/build.txt), [runtime](evidence/final-validation-2026-11-07/image-runtime.txt), [smoke](evidence/final-validation-2026-11-07/smoke.txt) | -| Policy на существующем volume и реальная остановка PostgreSQL | PostgreSQL `9f62ea9d176b` exited; 12 `job.requeued`; без replay ready с той же job и attempt=1; DLQ осталась 15; 8 инвариантов PASS | [команда](evidence/final-validation-2026-11-07/postgres-outage-retry.txt), [JSON](evidence/final-validation-2026-11-07/postgres-outage-retry.json) | +| Policy на существующем volume и реальная остановка PostgreSQL | PostgreSQL `9f62ea9d176b` exited; 12 `job.requeued`; без replay ready с той же job и attempt=1; DLQ осталась 15; 8 инвариантов PASS. Сценарий 21.815 с, вся команда 27.330 с; принятое вложение сохранено | [команда](evidence/final-validation-2026-11-07/postgres-outage-retry.txt), [JSON](evidence/final-validation-2026-11-07/postgres-outage-retry.json) | | tRNS HTTP v1/v2, exact neighbor, Adam7/filter/EXIF | 8 изображений, 48 побайтных сравнений вариантов с независимым белым эталоном; исходник, metadata/hash/размеры, stale/duplicate noop; 8 инвариантов PASS | [команда](evidence/final-validation-2026-11-07/png-http.txt), [JSON](evidence/final-validation-2026-11-07/png-http.json) | | Адресные duplicate/reorder/fencing, COMMIT/ack, malformed/DLQ, exhaustion/replay | 12 сценариев, 8 инвариантов PASS, 11 ID / 47 объектов; одна ожидаемая новая DLQ от malformed | [команда](evidence/final-validation-2026-11-07/delivery-targeted.txt), [JSON](evidence/final-validation-2026-11-07/delivery-targeted.json) | | PNG tRNS 8000×5000 при 448 MiB / 30 с | **4 FAIL**: grayscale 2/4/16 и RGB16 получили 202 → failed/processing_failed, attempt=1. Штатный ready-сценарий не пройден | [команда](evidence/final-validation-2026-11-07/png-limits.txt), [JSON](evidence/final-validation-2026-11-07/png-limits.json), [fixtures](evidence/final-validation-2026-11-07/fixtures) | | Принудительные timeout/memory и последующее обычное задание | PASS; worker остаётся жив, обычное задание ready. Это не отменяет четыре FAIL выше | [png-limits.json](evidence/final-validation-2026-11-07/png-limits.json) | | Повторная read-only сверка после staging sweep | PASS; нет pending outbox/staging/nonterminal/дублей, 10 объектов совпали с БД для 7 ID. Исходный ранний no_orphans FAIL сохранён | [cleanup-recheck](evidence/final-validation-2026-11-07/cleanup-recheck.json) | -**Major:** объявленный [OpenSpec-сценарий PNG на пределе пикселей](openspec/specs/lab5-image-variants/spec.md) требует ready при штатных пределах. Новые 40 Мп tRNS fixtures размером 35 759–385 445 байт его не проходят. [Linux-пробник с импортами worker](evidence/final-validation-2026-11-07/resource-probe-worker.txt) воспроизводит MemoryError в `images.py`: grayscale 2/4 — белый RGB-фон, grayscale16 — `I → L`, RGB16 — маски/повторное декодирование. Без tRNS gray2/gray4/RGB16 проходят; gray16 превышает память и без tRNS. Это провал конкретного граничного сценария; потери данных или падение сервиса не обнаружены. +**Исходный major на V:** объявленный [OpenSpec-сценарий PNG на пределе пикселей](openspec/specs/lab5-image-variants/spec.md) требует ready при штатных пределах. Новые 40 Мп tRNS fixtures размером 35 759–385 445 байт его не проходят. [Linux-пробник с импортами worker](evidence/final-validation-2026-11-07/resource-probe-worker.txt) воспроизводит MemoryError в `images.py`: grayscale 2/4 — белый RGB-фон, grayscale16 — `I → L`, RGB16 — маски/повторное декодирование. Без tRNS gray2/gray4/RGB16 проходят; gray16 превышает память и без tRNS. Это провал конкретного граничного сценария; потери данных или падение сервиса не обнаружены. -Требуется отдельный fix-агент: уложить обработку в ресурсную модель, сохранить точность tRNS и пройти review. Затем повторить только затронутые PNG/ресурсные проверки и сценарии, которые затронет фактический diff. В этой фазе реализация, конфигурация и OpenSpec не менялись. [Findings](evidence/final-validation-2026-11-07/findings.json): один новый major, пять прежних minor и одна документационная неточность. +Этот вывод относится к V. Причина исправлена отдельным агентом в M через OpenSpec, выполнено независимое re-review. Старый [findings.json](evidence/final-validation-2026-11-07/findings.json) сохраняет исходный major и шесть minor как историю; он не перезаписывается. Закрытие major на динамическом уровне ожидает перечисленных ниже повторов на M. Первый outage-прогон невалиден: `docker compose start worker` автоматически запустил БД; повторён только этот сценарий с точным container ID. Первая передача пробника через docker cp отклонена read-only rootfs, затем использован stdin/tmpfs. Эти ошибки обвязки и ранний cleanup FAIL сохранены отдельно и не объявлены успехом. Все команды, условия, ограничения и остановка — [RESULTS](evidence/final-validation-2026-11-07/RESULTS.md). -Запуск из чистого clone и отдельная throughput-матрица на V не выполнялись. Полный student-test, HTTP и реальный брокер выполнены. Публикация до fix/re-review и завершения адресной validation не готова; push и Telegram не выполнялись. +Запуск из чистого clone и отдельная throughput-матрица на V не выполнялись. Полный student-test, HTTP и реальный брокер выполнены именно на V. На M проверены только offline-пути и статика; публикация ожидает адресную validation. Push и Telegram не выполнялись. + +## Исправление M и оставшаяся адресная validation + +[Результаты исправления](evidence/review-png-memory-2026-11-07/RESULTS.md) сохраняют четыре ожидаемых FAIL регрессии на исходном renderer и PASS после изменения. Счётчик одновременно живущих pixel buffers на 1025×769 дал: + +| PNG tRNS | До, байт | После, байт | +| --- | ---: | ---: | +| grayscale 2 | 7 882 250 | 4 596 485 | +| grayscale 4 | 7 882 250 | 4 596 485 | +| grayscale 16 | 7 882 250 | 5 384 710 | +| RGB16 | 9 458 700 | 5 517 575 | + +Это модель pixel buffers, не RSS, виртуальная память процесса или проверка 40 Мп под Linux. До — [regression-before.txt](evidence/review-png-memory-2026-11-07/regression-before.txt), после — [offline-tests.txt](evidence/review-png-memory-2026-11-07/offline-tests.txt). Сохранённые 440 + 20 passed и 132 идентичных варианта подтверждают offline-часть. Независимое ревью M по данным координатора повторило 460 проверок с двумя Linux-only skips и не обнаружило major в доступной области. Его семь minor перечислены выше. + +Назначенному финальному агенту остаётся выполнить на M, сохраняя новые результаты отдельно от V: + +1. Linux-пробу с **импортами worker**, RLIMIT_AS=448 MiB и 30 с: четыре прежних 40 Мп tRNS fixtures в v1/v2, grayscale16 без tRNS и обычное задание после них. Команда — `PYTHONPATH=src:student-tests .venv/bin/python -m pytest --confcutdir=student-tests/unit student-tests/unit/test_png_memory.py::test_boundary_pngs_fit_worker_address_space -q -s`; эквивалентный контейнерный пробник допустим по процедуре исправления. +2. HTTP через LB: прежние `gray2/gray4/gray16/rgb16-40mp.png` должны пройти `202 → ready` при штатных лимитах, с неизменным оригиналом, точным tRNS, тремя вариантами и публикацией v2. Проверить одновременные рендеры при concurrency=2, память контейнера, отсутствие дубля эффекта и отката ready. +3. Повторить прежний PNG HTTP subset: восемь fixtures / 48 сравнений с независимым белым эталоном, Adam7/filter=4/EXIF=6, точный непрозрачный сосед. PASS V не выдавать за проверку изменённого renderer M. +4. Принудительные timeout и memory limit, затем обычное задание после каждого отказа. После штатного sweep проверить staging, outbox и дубли для новых ID; ранний no_orphans до sweep не повторять как методику. + +Полная инструкция — [обязательные проверки](evidence/review-png-memory-2026-11-07/RESULTS.md). Новые данные записываются в новый каталог: старый `targeted.py` защищён от перезаписи. От V изменён только renderer; поэтому прежние пригодные PostgreSQL outage, delivery subset и три полных track2-повтора автоматически не повторяются. Побайтная совместимость sample дополнительно подтверждена в [unchanged-rendering.json](evidence/review-png-memory-2026-11-07/unchanged-rendering.json). Если адресная проверка найдёт новую регрессию, область повторов уточняется по фактическому дефекту. + +На текущем отчётном этапе выполнены только лёгкие проверки и аудит сохранённого сырья — [report-memory-audit](evidence/report-memory-audit-2026-11-07.md). Docker, pytest, тяжёлые тесты и нагрузка не запускались. Полное подтверждение уровней 3/4 и «5» ожидает результатов этих проверок; прежние FAIL не объявлены PASS. ## Вопросы защиты @@ -204,6 +233,6 @@ Python 3.14, FastAPI, gunicorn/uvicorn-worker, dishka и dishka-faststream, pyda - **Почему дубль безопасен?** Job/версия идентифицируются в БД, lease сериализует работу, fencing отвергает старого держателя, уникальный ключ эффекта защищает варианты. - **Как отличить долгую работу от смерти?** Живая работа продлевает lease; истёкшую восстанавливает relay. Поздняя фиксация не проходит lease_token. - **Почему v1 не затирает v2?** Versioned ключи и условие монотонного published_version; ready v1 остаётся доступной до успешной публикации v2. -- **Что ещё не доказано?** Потеря confirm, все сбои диска/сети, производительность под изолированной нагрузкой. Граничные 40 Мп tRNS на штатной памяти проверены и не прошли, поэтому готовность к публикации не заявляется. +- **Что ещё не доказано?** Потеря confirm, все сбои диска/сети, производительность под изолированной нагрузкой. Граничные 40 Мп tRNS не прошли на V; исправление M проверено offline, но его Linux/HTTP-подтверждение отсутствует, поэтому готовность к публикации не заявляется. Документация сверена через Context7: [SQLAlchemy 2.0.45 async](https://github.com/sqlalchemy/sqlalchemy/blob/rel_2_0_45/doc/build/orm/extensions/asyncio.rst), [Alembic 1.16.5 async migrations](https://github.com/sqlalchemy/alembic/blob/rel_1_16_5/docs/build/cookbook.rst), [FastStream 0.7.2 manual ack](https://github.com/ag2ai/faststream/blob/0.7.2/docs/docs/en/getting-started/acknowledgement.md). API 0.7.2 сопоставлен с используемым FastStream 0.7.8; прикладной порядок COMMIT/ack проверяется кодом и evidence, а не одной документацией. diff --git a/evidence/README.md b/evidence/README.md index 1fccc0cc..ec28289f 100644 --- a/evidence/README.md +++ b/evidence/README.md @@ -1,13 +1,17 @@ # Индекс доказательств ЛР5 -Актуальный [REPORT.md](../REPORT.md) подготовлен после успешного повторного ревью кода **42575281b352d35bda17ee7601bae5548a996e91 (R)**. Последние полные динамические серии относятся к **0e921116610d289716af0a40ec823376eb8bbcbc (D)**. Они не являются прогоном R: после них изменены renderer PNG и policy RabbitMQ. Финальная validation на `b30e2f6a84419d1ca64525ffb40df92183cccaef` (V, runtime = R) проверила HTTP tRNS, реальный отказ БД с 12 requeue и адресные delivery-сценарии. **Новый major:** четыре 40 Мп tRNS PNG не достигают ready при штатной памяти. Validation заблокирована до fix/re-review; цель «5» не подменяет эти FAIL. Аудит применимости — [load-validation.md](load-validation.md), новые результаты — [RESULTS](final-validation-2026-11-07/RESULTS.md). +Актуальный [REPORT.md](../REPORT.md) обновлён после независимого ревью **6096aa7948b8b666aa3892397a96d044a55f02c6 (M)**. Предыдущее review — **42575281b352d35bda17ee7601bae5548a996e91 (R)**; полные динамические серии — **0e921116610d289716af0a40ec823376eb8bbcbc (D)**. Validation на `b30e2f6a84419d1ca64525ffb40df92183cccaef` (V, runtime = R) подтвердила PostgreSQL outage, delivery subset и HTTP tRNS, но выявила четыре FAIL на 40 Мп PNG при штатной памяти. + +В M изменён только renderer: плитки 256×256 и явное освобождение pixel core. 440 offline + 20 границ PASS, 2 Linux-only skips; 132 варианта совпали с V. Re-review не нашло major в статике/offline; **окончательное закрытие прежнего major требует Linux/HTTP evidence M**. Исходные FAIL V сохраняются и не становятся PASS. Аудит применимости V — [load-validation.md](load-validation.md), инструкция оставшихся проверок — [RESULTS исправления памяти](review-png-memory-2026-11-07/RESULTS.md). ## Как читать каталог | Файлы / каталог | Код и роль доказательства | Применимость | | --- | --- | --- | +| [Исправление памяти](review-png-memory-2026-11-07/RESULTS.md) | M; реализация `1a8020524909ebc5e2e43303436c9d1ce3c1a87b` | 440 + 20 passed / 2 skips, счётчик pixel buffers, 132 идентичных варианта; 28 хешей. Linux/HTTP отсутствуют | +| [Аудит обновления отчёта](report-memory-audit-2026-11-07.md) | M + только документация | Лёгкие проверки, аудит новых хешей/чисел/ссылок; семь minor последнего review, без новых динамических прогонов | | [Финальная validation](final-validation-2026-11-07/RESULTS.md), [аудит нагрузки](load-validation.md) | V, runtime = R | 980 tests, HTTP PNG и real DB outage; 12 адресных сценариев PASS; четыре 40 Мп PNG FAIL, один major; полный track2 не повторён | -| [Аудит отчёта](report-audit-2026-11-07.md) | R + изменения документации, 2026-11-07 | Реальные лёгкие проверки этого этапа, ссылки, хеши, арифметика; без Docker и новых динамических тестов | +| [Первый аудит отчёта](report-audit-2026-11-07.md) | R + изменения документации, до validation V и исправления M | Реальные лёгкие проверки того этапа, ссылки, хеши, арифметика; без Docker и новых динамических тестов | | [forward-final-2026-11-06/RESULTS.md](forward-final-2026-11-06/RESULTS.md) | D, полная динамическая квалификация после поздних исправлений ЛР4 | Основная измеренная база: 819 passed / 1 skip, smoke/persistence/failover, уровень 4 и три повтора трека 2; до исправлений R | | [review-trns-depth-2026-11-06/RESULTS.md](review-trns-depth-2026-11-06/RESULTS.md) | R, исправление глубины PNG tRNS | 430 unit + 20 границ, 114 совместимых вариантов, fixtures и 34 хеша; offline, не Linux/HTTP-квалификация | | [review-fixes-2026-11-06/RESULTS.md](review-fixes-2026-11-06/RESULTS.md) | Реализация `3fad49d6b913afb122d2c1348ea8d9f99e25cc27`, архив `6e97bdbe9638c5a53951337fce639a1a0db7f92e` | История первого исправления: policy сохранена в R, renderer затем дополнен. 57 тестов не доказывали все tRNS; поздние major и исправление описаны в следующем каталоге | @@ -16,18 +20,18 @@ | [sqlalchemy-2026-11-06/grade4/NOTES.md](sqlalchemy-2026-11-06/grade4/NOTES.md) | `e9ce6d0afacadc16f1666f4bb7d54d3d7377a269` | Исторический уровень 4; `level4-retry.json` — успешный повтор; исходные неуспешные результаты не переименовываются в PASS | | [sqlalchemy-2026-11-06/track2/NOTES.md](sqlalchemy-2026-11-06/track2/NOTES.md) | Несколько промежуточных SHA внутри логов | История диагностики и исправлений; для итоговых чисел используется qualified, затем D | | [sqlalchemy-2026-11-06/track2/qualified/RESULTS.md](sqlalchemy-2026-11-06/track2/qualified/RESULTS.md) | `9ba3076fa8ba707de932e053fc22f455d83b3210` | Старая квалификация 39/174 до позднего forward: run1, run2, run3-retry. Прерванный run3 исключён, повторена только эта серия | -| Все корневые `*.txt` и `*.json` в `evidence/` | Историческая реализация до SQLAlchemy/Alembic, даты/старые SHA — внутри файлов и истории Git | **Не подтверждают R или D.** Не использовать старые порты, asyncpg-мигратор, результаты и формулировки как текущие | +| Все корневые `*.txt` и `*.json` в `evidence/` | Историческая реализация до SQLAlchemy/Alembic, даты/старые SHA — внутри файлов и истории Git | **Не подтверждают R, D или M.** Не использовать старые порты, asyncpg-мигратор, результаты и формулировки как текущие | -Последняя строка включает `contract-checks.txt`, `environment.txt`, `failover-upload.json`, `failover.txt`, `level3.json`, `level4.json`, `limits.txt`, `operator.txt`, `persistence.txt`, `pipeline-stand.txt`, `s3-outage.json`, `s3-security.txt`, `smoke.txt`, `stack.txt`, `student-tests.txt`, `topology.txt`, `upload-faults.txt`. Эти файлы оставлены для истории, без изменения сырья. Старые Markdown-итоги также читаются в пределах указанного выше SHA; их прежние заявления о полноте не распространяются на R. +Последняя строка включает `contract-checks.txt`, `environment.txt`, `failover-upload.json`, `failover.txt`, `level3.json`, `level4.json`, `limits.txt`, `operator.txt`, `persistence.txt`, `pipeline-stand.txt`, `s3-outage.json`, `s3-security.txt`, `smoke.txt`, `stack.txt`, `student-tests.txt`, `topology.txt`, `upload-faults.txt`. Эти файлы оставлены для истории, без изменения сырья. Старые Markdown-итоги также читаются в пределах указанного выше SHA; их прежние заявления о полноте не распространяются на M. В частности, требования «нужен fix/review» в load-validation.md и RESULTS V описывают историческую остановку: fix и re-review M уже выполнены, Linux/HTTP-подтверждение ещё ожидается. ## Основные первичные данные D - [level4-command.txt](forward-final-2026-11-06/level4-command.txt), [level4.json](forward-final-2026-11-06/level4.json): 17 сценариев, 8 инвариантов; 33 ID, 28 ready, 5 ожидаемых failed, 116 объектов. - [track-run1.txt](forward-final-2026-11-06/track-run1.txt), [track-run1.json](forward-final-2026-11-06/track-run1.json); [track-run2.txt](forward-final-2026-11-06/track-run2.txt), [track-run2.json](forward-final-2026-11-06/track-run2.json); [track-run3.txt](forward-final-2026-11-06/track-run3.txt), [track-run3.json](forward-final-2026-11-06/track-run3.json): каждый 13 сценариев, 8 инвариантов, 13 ID, 58 объектов. [summary.json](forward-final-2026-11-06/summary.json): всего 39/24/39/174. - [final-smoke.txt](forward-final-2026-11-06/final-smoke.txt), [persistence.txt](forward-final-2026-11-06/persistence.txt), [failover.txt](forward-final-2026-11-06/failover.txt): публичные проверки. [persistence-containers.txt](forward-final-2026-11-06/persistence-containers.txt), [failover-containers.txt](forward-final-2026-11-06/failover-containers.txt), [restore.txt](forward-final-2026-11-06/restore.txt): фактические операции со своим стендом. -- [student-test.txt](forward-final-2026-11-06/student-test.txt): 819 passed / 1 skipped до последних двух исправлений. Текущие offline-результаты отдельно: [offline-tests.txt](review-trns-depth-2026-11-06/offline-tests.txt), [boundaries.txt](review-trns-depth-2026-11-06/boundaries.txt). +- [student-test.txt](forward-final-2026-11-06/student-test.txt): 819 passed / 1 skipped до последних двух исправлений. Предыдущие offline-результаты R: [offline-tests.txt](review-trns-depth-2026-11-06/offline-tests.txt), [boundaries.txt](review-trns-depth-2026-11-06/boundaries.txt). Текущие M: [offline-tests.txt](review-png-memory-2026-11-07/offline-tests.txt), [boundaries.txt](review-png-memory-2026-11-07/boundaries.txt). - [conditions-before.json](forward-final-2026-11-06/conditions-before.json), [conditions-track-start.json](forward-final-2026-11-06/conditions-track-start.json), остальные `conditions-*.json`: моментальные срезы общего Docker, не непрерывный контроль фоновой нагрузки. -- [down.txt](forward-final-2026-11-06/down.txt), [stopped-containers.txt](forward-final-2026-11-06/stopped-containers.txt), [retained-volumes.txt](forward-final-2026-11-06/retained-volumes.txt): последний наблюдённый остановленный стенд, четыре постоянных volume сохранены. Отчётный этап это состояние через Docker не перепроверял. +- [down.txt](forward-final-2026-11-06/down.txt), [stopped-containers.txt](forward-final-2026-11-06/stopped-containers.txt), [retained-volumes.txt](forward-final-2026-11-06/retained-volumes.txt): остановка стенда D. Более поздняя остановка V — [down.txt](final-validation-2026-11-07/down.txt), [stopped-containers.txt](final-validation-2026-11-07/stopped-containers.txt), [retained-volumes.txt](final-validation-2026-11-07/retained-volumes.txt): четыре volume сохранены. Исправление M и отчёт это состояние через Docker не перепроверяли. ## Не считать успехом или измерением производительности @@ -36,8 +40,8 @@ - [clock-observation.json](forward-final-2026-11-06/clock-observation.json): UTC/elapsed run2 = 1161.195/186.458 с, run3 = 571.513/180.259 с. Причина неизвестна; длительности исключены из RPS/SLO/сравнения разброса. Функциональные результаты пригодны. - `no_orphans` в итоговой серии проверяет выборку ID; 15 исторических/ожидаемых сообщений DLQ сохранены. Это не глобально пустые S3/DLQ. - `forward-final-2026-11-06/baseline.txt` — 0 тестов; `baseline-regressions.txt` — ожидаемые 29 FAIL до исправления. `review-fixes-2026-11-06/regressions-fixture-error.txt` — неуспешная промежуточная fixture; `review-trns-depth-2026-11-06/regressions-before.txt` — воспроизведённый дефект. Их сохраняют как диагностику, не суммируют с PASS. -- [findings.json](review-trns-depth-2026-11-06/findings.json) содержит пять minor: окно confirm, limits, legacy reconcile, отдельный replay failed v2 и часы. Дополнительная документационная неточность `201` в `openspec/config.yaml` отражена в REPORT; конфиг этой фазе менять запрещено. +- Исторический [findings.json](review-trns-depth-2026-11-06/findings.json) содержит пять minor: окно confirm, limits, legacy reconcile, отдельный replay failed v2 и часы. Дополнительная документационная неточность `201` в `openspec/config.yaml` отражена в REPORT; конфиг этой фазе менять запрещено. Седьмой minor из review M — JobMessage принимает четыре значения вне JSON Schema; источник и ограничения — [аудит отчёта](report-memory-audit-2026-11-07.md). Исторические findings.json с пятью/шестью minor не перезаписываются. -Нагрузочных RPS/p95 для R здесь не заявлено. Финальный агент выполнил только отсутствующие/затронутые проверки и сохранил пригодные серии. После fix повторяются только затронутые PNG/ресурсные проверки по новому diff. Исходное назначение адресных сценариев — разделы «Обязательные проверки финального этапа» в [PNG](review-trns-depth-2026-11-06/RESULTS.md) и [доставке](review-fixes-2026-11-06/RESULTS.md). +Нагрузочных RPS/p95 для M здесь не заявлено. Финальный агент выполнил только отсутствующие/затронутые проверки и сохранил пригодные серии. После re-review M повторяются только затронутые PNG/ресурсные проверки: четыре 40 Мп tRNS и grayscale16 без tRNS с импортами worker, HTTP subset 8/48, concurrency=2, v1/v2, принудительные лимиты и cleanup после sweep. Точная актуальная процедура — [исправление памяти](review-png-memory-2026-11-07/RESULTS.md). PostgreSQL outage, delivery subset и полный track2 повторно не нужны без нового основания. Сохранять только обезличенные команды, exit codes, SHA, условия и агрегаты. Секреты, `.env`, credentials, session tokens/cookies, реальные сообщения, дампы и signed URLs в evidence не входят. Существующие сырые измерения в отчётной фазе неизменны. diff --git a/evidence/report-memory-audit-2026-11-07.md b/evidence/report-memory-audit-2026-11-07.md new file mode 100644 index 00000000..bd8090ad --- /dev/null +++ b/evidence/report-memory-audit-2026-11-07.md @@ -0,0 +1,71 @@ +# Обновление отчёта после исправления памяти PNG + +Дата: 2026-11-07, Europe/Moscow. Автор работы: Костылев Артём, БПИ2303. +Исходный HEAD: `6096aa7948b8b666aa3892397a96d044a55f02c6` (M), ветка `solution/bpi2303-kostylev`; исходное дерево чистое. Это отдельный отчётный этап после re-review `lab5-release-load0-round1`, переданного координатором. + +Обновлены только `REPORT.md`, `AGENTS.md`, `evidence/README.md` и этот документ. Код, конфиги, OpenSpec и сырые измерения не меняются. `openspec/config.yaml` прочитан; унаследованное design-правило `201` остаётся minor, поскольку изменение конфигурации запрещено scope. Существующие OpenSpec propose/apply/archive исправления памяти завершены до этого этапа; здесь выполнена только валидация. + +## Выполнено отчётным агентом + +| Команда / проверка | Реальный результат | +| --- | --- | +| `git status --short`; `git branch --show-current`; `git rev-parse HEAD` | Чистое исходное дерево, назначенная ветка, HEAD=M | +| `make check validate BASE_URL=http://127.0.0.1:18085` | Exit 0: структура/синтаксис skeleton, OpenAPI 3.1 и JSON Schema PASS; приложение этим не тестируется | +| `make lint BASE_URL=http://127.0.0.1:18085` | Exit 0: ruff check PASS, 198 files already formatted, ty PASS | +| `openspec validate --all --strict`; `openspec list --json` | 22 passed, 0 failed; changes=[] | +| `git diff --name-only fb682bc38476d785d02d4611ba4913e5f37bed62 HEAD -- src infra compose.yaml Dockerfile pyproject.toml uv.lock alembic openspec/config.yaml` | Единственный изменённый runtime-файл — `src/messenger/attachments/infrastructure/images.py`; конфигурация лимитов и зависимостей прежняя | +| Python stdlib `hashlib.sha256` по manifest | 28 записей [checks.json](review-png-memory-2026-11-07/checks.json) + 53 записи [sha256.json](final-validation-2026-11-07/sha256.json) совпали с файлами; проверено 81 значение | +| Python stdlib, аудит JSON/txt | 22 fixtures / 132 варианта; 440 + 20 сохранённых passed / 2 skips; четыре значения pixel buffers совпали с таблицей REPORT | +| Аудит `postgres-outage-retry.json` | Сохранённый PASS V: 12 requeue, тот же job_id и attempt=1, replay=false, DLQ 15 до/после; восемь инвариантов | +| Аудит `png-http.json`, `delivery-targeted.json` | V: 8 fixtures / 48 вариантов и 12 delivery-сценариев / 11 ID / 47 объектов; по восемь инвариантов PASS | +| Аудит `png-limits.json`, `cleanup-recheck.json` | Сохранены четыре FAIL граничных PNG, три PASS прочих сценариев, ранний no_orphans FAIL; последующий read-only cleanup PASS для семи ID / десяти объектов | + +Проверка хешей воспроизводится без Docker: + +```sh +python3 - <<'PY' +import hashlib +import json +from pathlib import Path + +for manifest, key in [ + ('evidence/review-png-memory-2026-11-07/checks.json', 'sha256'), + ('evidence/final-validation-2026-11-07/sha256.json', None), +]: + data = json.loads(Path(manifest).read_text()) + entries = data[key] if key else data + for path, expected in entries.items(): + assert hashlib.sha256(Path(path).read_bytes()).hexdigest() == expected, path + print('PASS:', len(entries), manifest) +PY +``` + +Context7 разрешил библиотеку `/python-pillow/pillow/13.0.0`, но запрос документации вернул `Monthly quota exceeded`. Успешное получение документации через Context7 в этом этапе не заявляется. Различие между `Image.close()` и выходом из контекста изображения проверено по официальному исходнику документации закреплённой версии: [Pillow 13.0.0, Image lifecycle](https://github.com/python-pillow/Pillow/blob/13.0.0/docs/reference/open_files.rst). Источник подтверждает освобождение core через close; достаточность Linux 448 MiB из него не следует. + +## Данные независимого review и семь minor + +Источник этого блока — результат `lab5-release-load0-round1` на M, переданный координатором в назначении. Reviewer сообщил 460 offline passed (включая 20 проверок границ), два Linux-only skip, побайтное совпадение 132 вариантов и отсутствие major в проверенной статике/offline. Эти тесты не запускались заново отчётным агентом. Сохранённые логи fixer отдельно подтверждают 440 + 20 passed: [offline-tests.txt](review-png-memory-2026-11-07/offline-tests.txt), [boundaries.txt](review-png-memory-2026-11-07/boundaries.txt). + +| Severity | Файл | Наблюдение и происхождение | +| --- | --- | --- | +| minor | `src/messenger/attachments/entrypoints/schemas.py:67` | Новый: reviewer воспроизвёл четыре сообщения вне [jobs.schema.json](../contracts/jobs.schema.json): `attempt="1"`, `pipeline_version=true`, числовой `created_at`, `traceparent=null`. В offline-вызовах `handle_job` получены bus/ack, reject=0. [JobMessage](../src/messenger/attachments/entrypoints/schemas.py) допускает преобразования типов и nullable traceparent; штатный relay формирует корректные сообщения, критичного последствия не установлено. Это не real-broker/COMMIT-проверка; её исходный transcript не приложен к snapshot, поэтому источник наблюдения указан явно | +| minor | `src/messenger/attachments/application/pipeline.py:230` | Сохранено: crash_publish_confirm после Basic.Ack до COMMIT outbox, потеря confirm не проверена | +| minor | `scripts/limits.py:10` | Сохранено: порядок secrets вызывает ложный FAIL; [исторический exit 1](sqlalchemy-2026-11-06/grade3/limits.txt) не обозначен PASS | +| minor | `scripts/reconcile_track.py:396` | Сохранено: семантика 201 и attachments/ из ЛР4, демонстратор для ЛР5 непригоден | +| minor | `src/messenger/attachments/application/pipeline.py:304` | Сохранено: failed upgrade v2 отдельно не повторяется при ready v1, v1 остаётся доступной | +| minor | `evidence/forward-final-2026-11-06/clock-observation.json` | Сохранено: UTC/elapsed run2/3 расходятся; длительности исключены из performance-выводов | +| minor | `openspec/config.yaml:130` | Сохранено: design-правило upload 201 вместо нормативного 202; реализация возвращает 202 | + +Предыдущие шесть minor сохранены в [findings.json исправления](review-png-memory-2026-11-07/findings.json); исторические JSON не обновляются ради нового замечания. Все семь отражены в ограничениях REPORT и AGENTS. + +## Граница готовности + +Исходный major V доказан четырьмя HTTP FAIL и Linux MemoryError. M устраняет причину и прошёл offline/re-review, однако полное закрытие major требует повторения затронутого Linux/HTTP-сценария. Не присваиваем ему PASS по модели маленьких pixel buffers. Полное подтверждение «5» остаётся целевым результатом следующей фазы. + +Точная оставшаяся программа — [RESULTS исправления памяти](review-png-memory-2026-11-07/RESULTS.md): 40 Мп PNG с импортами worker, grayscale16 без tRNS, HTTP 8/48, concurrency=2, v1/v2, принудительные лимиты, обычное задание после отказа и cleanup после sweep. PostgreSQL outage, delivery subset и полные track2 без нового основания не повторяются. Измерения писать в новый каталог, старые FAIL и PASS не перезаписывать. + +На отчётном этапе Docker, pytest/полный student-test, HTTP, нагрузка, push и Telegram не запускались; агенты и фоновые процессы не создавались. Стенд не поднимался. Последняя сохранённая остановка V и четыре volumes подтверждены [stopped-containers.txt](final-validation-2026-11-07/stopped-containers.txt), [retained-volumes.txt](final-validation-2026-11-07/retained-volumes.txt); новое состояние Docker не проверялось. + +## Финальная проверка документации + +Python stdlib проверил 159 локальных Markdown-ссылок в четырёх изменённых документах: все цели существуют; блоки кода закрыты. `git diff --check` — exit 0. Список изменений и untracked-файлов содержит ровно четыре разрешённых Markdown-документа; runtime, конфиги, OpenSpec и сырые evidence не изменены этим этапом. -- 2.54.0 From c7b8feb805d151e878d77b0dff47320a9436b172 Mon Sep 17 00:00:00 2001 From: Artyom Date: Sat, 7 Nov 2026 02:25:23 +0300 Subject: [PATCH 52/52] Validate bounded PNG rendering and finalize lab 5 evidence --- AGENTS.md | 6 +- REPORT.md | 48 +- evidence/README.md | 15 +- .../RESULTS.md | 55 + .../active-changes.txt | 11 + .../audit-files.py | 153 +++ .../audit.json | 25 + .../build.txt | 90 ++ .../checks.txt | 14 + .../conditions-after.json | 11 + .../conditions.json | 166 +++ .../container-events.json | 151 +++ .../down.txt | 53 + .../final-memory-validation-2026-11-07/env.sh | 8 + .../final-audit.json | 100 ++ .../final-checks.txt | 14 + .../final-containers.txt | 15 + .../findings.json | 37 + .../linux-child.py | 58 + .../linux-runner.py | 89 ++ .../linux.json | 238 ++++ .../linux.txt | 10 + .../openspec.txt | 28 + .../png-boundary.json | 1129 +++++++++++++++++ .../png-boundary.txt | 12 + .../png-http.json | 742 +++++++++++ .../png-http.txt | 12 + .../reset-worker-peak.txt | 10 + .../retained-volumes.txt | 8 + .../running-containers-after.txt | 4 + .../runtime.txt | 7 + .../scan-secrets.py | 63 + .../secret-scan.json | 58 + .../sha256.json | 37 + .../smoke.txt | 6 + .../stopped-containers.txt | 4 + .../student-test.txt | 20 + .../targeted.py | 310 +++++ .../final-memory-validation-2026-11-07/up.txt | 94 ++ evidence/load-validation.md | 12 + 40 files changed, 3891 insertions(+), 32 deletions(-) create mode 100644 evidence/final-memory-validation-2026-11-07/RESULTS.md create mode 100644 evidence/final-memory-validation-2026-11-07/active-changes.txt create mode 100644 evidence/final-memory-validation-2026-11-07/audit-files.py create mode 100644 evidence/final-memory-validation-2026-11-07/audit.json create mode 100644 evidence/final-memory-validation-2026-11-07/build.txt create mode 100644 evidence/final-memory-validation-2026-11-07/checks.txt create mode 100644 evidence/final-memory-validation-2026-11-07/conditions-after.json create mode 100644 evidence/final-memory-validation-2026-11-07/conditions.json create mode 100644 evidence/final-memory-validation-2026-11-07/container-events.json create mode 100644 evidence/final-memory-validation-2026-11-07/down.txt create mode 100644 evidence/final-memory-validation-2026-11-07/env.sh create mode 100644 evidence/final-memory-validation-2026-11-07/final-audit.json create mode 100644 evidence/final-memory-validation-2026-11-07/final-checks.txt create mode 100644 evidence/final-memory-validation-2026-11-07/final-containers.txt create mode 100644 evidence/final-memory-validation-2026-11-07/findings.json create mode 100644 evidence/final-memory-validation-2026-11-07/linux-child.py create mode 100644 evidence/final-memory-validation-2026-11-07/linux-runner.py create mode 100644 evidence/final-memory-validation-2026-11-07/linux.json create mode 100644 evidence/final-memory-validation-2026-11-07/linux.txt create mode 100644 evidence/final-memory-validation-2026-11-07/openspec.txt create mode 100644 evidence/final-memory-validation-2026-11-07/png-boundary.json create mode 100644 evidence/final-memory-validation-2026-11-07/png-boundary.txt create mode 100644 evidence/final-memory-validation-2026-11-07/png-http.json create mode 100644 evidence/final-memory-validation-2026-11-07/png-http.txt create mode 100644 evidence/final-memory-validation-2026-11-07/reset-worker-peak.txt create mode 100644 evidence/final-memory-validation-2026-11-07/retained-volumes.txt create mode 100644 evidence/final-memory-validation-2026-11-07/running-containers-after.txt create mode 100644 evidence/final-memory-validation-2026-11-07/runtime.txt create mode 100644 evidence/final-memory-validation-2026-11-07/scan-secrets.py create mode 100644 evidence/final-memory-validation-2026-11-07/secret-scan.json create mode 100644 evidence/final-memory-validation-2026-11-07/sha256.json create mode 100644 evidence/final-memory-validation-2026-11-07/smoke.txt create mode 100644 evidence/final-memory-validation-2026-11-07/stopped-containers.txt create mode 100644 evidence/final-memory-validation-2026-11-07/student-test.txt create mode 100644 evidence/final-memory-validation-2026-11-07/targeted.py create mode 100644 evidence/final-memory-validation-2026-11-07/up.txt diff --git a/AGENTS.md b/AGENTS.md index b8e429c6..8605f17c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -75,15 +75,15 @@ make down # остановка своего project без Validation на `b30e2f6a84419d1ca64525ffb40df92183cccaef` (V, runtime = R) завершила реальный PostgreSQL outage: 12 requeue → ready без replay, policy `delivery-limit=-1` на сохранённом volume, DLQ не выросла. HTTP PNG: 8 fixtures / 48 сравнений вариантов v1/v2 PASS. Delivery subset: 12 сценариев / 8 инвариантов PASS. Student-test: 980 passed / 1 Linux-only skip. Исторический аудит — [evidence/load-validation.md](evidence/load-validation.md), результаты V — [evidence/final-validation-2026-11-07/RESULTS.md](evidence/final-validation-2026-11-07/RESULTS.md). -**Прежний major ожидает динамического закрытия:** на V четыре PNG tRNS 8000×5000 (grayscale 2/4/16 и RGB16) дали 202 → failed/processing_failed при штатных 448 MiB/30 с. В M преобразования ограничены плитками 256×256, pixel core явно освобождаются; конфигурация лимитов не увеличивалась. Сохранённые проверки: 440 offline passed / 2 Linux-only skipped + 20 границ; 132 варианта для 22 изображений побайтно совпали с V. Независимое review M не нашло major в статике/offline. Эти результаты не заменяют ещё не выполненные Linux/HTTP-проверки нового renderer, исходные FAIL сохранены. +**Прежний major закрыт динамически на F `74c33160ac01618f70e9e1c6a121a5e45c3c7155` (runtime = M).** Четыре исходных PNG 8000×5000 и grayscale16 без tRNS прошли Linux с импортами worker при 448 MiB/30 с и HTTP 202 → ready в v1/v2. Два одновременных HTTP jobs: peak 844.41 MiB / 1 GiB, OOM=0. Boundary: 8 сценариев / 8 инвариантов, 11 ID / 59 объектов; малая HTTP-матрица: 8 fixtures / 48 сравнений / 8 инвариантов, 8 ID / 56 объектов. Принудительные лимиты, обычное задание после каждого отказа и cleanup после sweep — PASS. Student-test: 984 passed / 2 Linux-only skipped / 19 deselected; Linux-эквивалент выполнен отдельно. Исходные FAIL V сохранены, лимиты не увеличивались. -Следующая фаза проверяет прежние четыре 40 Мп PNG и grayscale16 без tRNS с импортами worker, обычную работу после отказа, concurrency=2, точный tRNS, HTTP subset 8/48, v1/v2, принудительные лимиты и cleanup после sweep. Точная процедура — [evidence/review-png-memory-2026-11-07/RESULTS.md](evidence/review-png-memory-2026-11-07/RESULTS.md). Полные track2, PostgreSQL outage и delivery subset без нового основания не повторять: соответствующий runtime не менялся. Последний наблюдавшийся стенд V остановлен, четыре volumes сохранены; исправление и отчёт Docker не запускали. +Актуальные команды и сырьё — [evidence/final-memory-validation-2026-11-07/RESULTS.md](evidence/final-memory-validation-2026-11-07/RESULTS.md), аудит применимости — [evidence/load-validation.md](evidence/load-validation.md). Полные track2, PostgreSQL outage и delivery subset приняты без повторения: соответствующий runtime не менялся. Стенд F остановлен, четыре volumes сохранены. Validation завершена; push/Telegram не выполнялись, публикация требует отдельного сообщения координатора с точным SHA. Документационные коммиты после F не меняют измеренный runtime. Семь minor последнего review сохраняются в REPORT: crash_publish_confirm фактически после confirm до COMMIT outbox; limits.py имеет ложный FAIL порядка secrets; reconcile_track.py ожидает upload 201 ЛР4; failed upgrade v2 нельзя отдельно повторить при ready v1; UTC/elapsed run2/3 расходятся; design-правило config сохранило 201; JobMessage допускает преобразования типов и null вне jobs.schema.json. Последний minor воспроизведён reviewer в четырёх offline-пробах (bus/ack вместо reject); штатный relay формирует корректные сообщения, критичного последствия не установлено. Происхождение — [аудит обновления отчёта](evidence/report-memory-audit-2026-11-07.md). Корневые старые evidence до SQLAlchemy остаются историей. ## Уровни оценки -Цель — **«5»**, трек 2 «Доказанная идемпотентность pipeline». Полное подтверждение для текущего кода заявлять только после адресного Linux/HTTP-подтверждения исправления M и окончательного закрытия прежнего major; таблица доказательств и границы применимости — в `REPORT.md`. +Цель — **«5»**, трек 2 «Доказанная идемпотентность pipeline». Критерии подтверждены совокупностью сохранённых серий D/V и адресной validation F; прежний major закрыт, семь minor сохранены. Таблица доказательств и границы применимости — в `REPORT.md`. - **3** — `202 queued` после staging и `COMMIT` задания с outbox; отдельные `broker`, `relay`, `worker` в стенде; durable quorum queue, publisher confirm, ручной `ack` после `COMMIT`; состояния `queued/processing/ready/failed`, оригинал в `originals/` и thumbnail; ограниченный retry (`JOB_MAX_ATTEMPTS=5`) и `failed` с `error_code`; повтор job без второго набора вариантов; worker остановлен → upload → сообщение → рестарт API и broker → worker → `ready`; минимум lab4 сохранён. - **4** — crop и optimized WebP, лимиты worker по байтам, пикселям, времени и памяти, crash между `COMMIT` и publish, backoff с jitter и классификация ошибок, DLQ и replay, crash после записи объекта до `ack`, lease и fencing для зависшего `processing`, prefetch, очистка staging. diff --git a/REPORT.md b/REPORT.md index fdec9df7..76357af7 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,15 +1,15 @@ # Отчёт — лабораторная работа 5 Автор: **Костылев Артём, БПИ2303**. Тема: «Очереди и асинхронная обработка изображений». -Цель — **«5», трек 2 «Доказанная идемпотентность pipeline»**. Причина major с памятью PNG исправлена, независимое повторное ревью не обнаружило major в статике/offline. Окончательное закрытие прежнего дефекта требует адресных Linux/HTTP-проверок нового renderer; они ещё не выполнены. Исходные четыре FAIL сохранены. Полное подтверждение «5» и готовность к публикации пока не заявляются. +Цель — **«5», трек 2 «Доказанная идемпотентность pipeline»**. Критичный дефект памяти PNG закрыт после отдельного fix/re-review и адресной Linux/HTTP validation. Совокупность сохранённых серий D/V и новых проверок M подтверждает критерии выбранного трека в описанных условиях. Семь minor сохранены; исходные четыре FAIL остаются историей. Validation завершена, публикация требует отдельного разрешения координатора. -Ветка: `solution/bpi2303-kostylev`. Предыдущее ревью: `42575281b352d35bda17ee7601bae5548a996e91` (далее **R**). Последняя полная динамическая квалификация: `0e921116610d289716af0a40ec823376eb8bbcbc` (далее **D**). Между D и R из runtime изменены только `infra/rabbitmq/definitions.json` и `src/messenger/attachments/infrastructure/images.py`; SQLAlchemy, Alembic, outbox, lease/fencing и публикация версий не изменились. Финальные проверки выполнены на `b30e2f6a84419d1ca64525ffb40df92183cccaef` (V), runtime которого побайтно совпадает с R. Текущий код после исправления памяти и повторного ревью — **`6096aa7948b8b666aa3892397a96d044a55f02c6` (M)**; реализация исправления — `1a8020524909ebc5e2e43303436c9d1ce3c1a87b`. От V из runtime изменён только `images.py`, настройки 448 MiB/30 с/concurrency=2 сохранены. Полный student-test и HTTP-результаты V не являются прогоном M. Документационные коммиты отчёта и evidence не меняют runtime. Публикация — отдельная фаза, только в private MTUCI-Labs; этот этап ничего не публикует. +Ветка: `solution/bpi2303-kostylev`. Предыдущее ревью: `42575281b352d35bda17ee7601bae5548a996e91` (далее **R**). Последняя полная динамическая квалификация: `0e921116610d289716af0a40ec823376eb8bbcbc` (далее **D**). Между D и R из runtime изменены только `infra/rabbitmq/definitions.json` и `src/messenger/attachments/infrastructure/images.py`; SQLAlchemy, Alembic, outbox, lease/fencing и публикация версий не изменились. Финальные проверки выполнены на `b30e2f6a84419d1ca64525ffb40df92183cccaef` (V), runtime которого побайтно совпадает с R. Текущий код после исправления памяти и повторного ревью — **`6096aa7948b8b666aa3892397a96d044a55f02c6` (M)**; реализация исправления — `1a8020524909ebc5e2e43303436c9d1ce3c1a87b`. От V из runtime изменён только `images.py`, настройки 448 MiB/30 с/concurrency=2 сохранены. Новая validation выполнена на **`74c33160ac01618f70e9e1c6a121a5e45c3c7155` (F, runtime = M)**: 984 passed / 2 Linux-only skipped, Linux-пробник с импортами worker, граничные HTTP и 8 PNG / 48 сравнений PASS. Результаты V не являются прогоном M; новые результаты F сохранены отдельно. Документационные коммиты отчёта и evidence не меняют runtime. Публикация — отдельная фаза, только в private MTUCI-Labs; этот этап ничего не публикует. Индекс происхождения всех доказательств — [evidence/README.md](evidence/README.md). Источники решения: skeleton и контракт курса, собственная ЛР4 с поздними исправлениями до `4ed889c1e4008e3f6040ae2534bef99262d3b8ce`, документация библиотек; при подготовке использован Codex. Перенос 253 файлов разобран в [forward-port.md](evidence/forward-port.md). Нормативные `contracts/`, `tests/`, `README.md`, `COURSE.md` не изменены. ## Воспроизведение из чистого clone -Нужны доступ к приватному репозиторию, Git, Docker с Compose v2, make, системный Python 3.9+, uv и OpenSpec CLI для проверки спецификаций. Приложение использует Python 3.14. Команды ниже — инструкция, а не заявление о новом прогоне из clone: отчётные этапы Docker не запускали; validation V использовала существующие volumes, а не чистый clone. Для воспроизведения выбран M. +Нужны доступ к приватному репозиторию, Git, Docker с Compose v2, make, системный Python 3.9+, uv и OpenSpec CLI для проверки спецификаций. Приложение использует Python 3.14. Команды ниже — инструкция, а не заявление о новом прогоне из clone: отчётные этапы Docker не запускали; validation V и F использовали существующие volumes, а не чистый clone. Для воспроизведения выбран M. Вместо `` подставляется URL репозитория ЛР5 в MTUCI-Labs, доступный после публикации. На общей машине запуск разрешён только в выделенной фазе и своём project; занятые порты не освобождают остановкой чужих контейнеров. @@ -49,7 +49,7 @@ make down `make student-test` поднимает одноразовые Docker-зависимости; его нельзя считать offline-проверкой. Suite сам использует `infra/compose.faults.yaml`, временно меняет параметры своих relay/worker и восстанавливает их. Level 4 включает все шесть сценариев уровня 3. Новые JSON сохраняются отдельно от квалификационных файлов. Стенд останавливают `make down` без удаления постоянных volumes; `reset-data`, `down -v`, `reset/clean` в процедуру не входят. -Для защиты и оператора: `make worker-stop`, `make worker-start`, `make queues`, `make topology`, `make failed`, `make dlq`; `make replay ID=` возвращает failed в queued с audit, повтор для ready — noop. `make reprocess ID= PIPELINE_VERSION=2` создаёт новую версию при доступном исходнике. Результаты адресной validation и оставшееся исправление приведены ниже; полный повтор пригодных серий не требуется. +Для защиты и оператора: `make worker-stop`, `make worker-start`, `make queues`, `make topology`, `make failed`, `make dlq`; `make replay ID=` возвращает failed в queued с audit, повтор для ready — noop. `make reprocess ID= PIPELINE_VERSION=2` создаёт новую версию при доступном исходнике. Результаты завершённой адресной validation приведены ниже; полный повтор пригодных серий не требуется. ## Архитектура и решения @@ -91,18 +91,18 @@ Python 3.14, FastAPI, gunicorn/uvicorn-worker, dishka и dishka-faststream, pyda | Критерий | Команда / сценарий | Наблюдение | Файл | | --- | --- | --- | --- | -| Контракт, синтаксис, типы | `make check validate lint` | PASS на M в повторном отчётном этапе; приложение этим не проверяется | [Аудит обновления](evidence/report-memory-audit-2026-11-07.md) | -| Собственные интеграционные тесты | `make student-test PYTEST_ARGS='-q --tb=short'` | V: 980 passed, 1 Linux-only skip, 19 stack deselected; полный запуск с real-broker до M | [student-test.txt](evidence/final-validation-2026-11-07/student-test.txt) | +| Контракт, синтаксис, типы | `make check validate lint` | PASS на F; приложение этим не проверяется | [checks](evidence/final-memory-validation-2026-11-07/checks.txt) | +| Собственные интеграционные тесты | `make student-test PYTEST_ARGS='-q --tb=short'` | F: 984 passed, 2 Linux-only skips, 19 stack deselected; real-broker, Linux-эквивалент пропусков выполнен отдельно | [student-test.txt](evidence/final-memory-validation-2026-11-07/student-test.txt), [Linux](evidence/final-memory-validation-2026-11-07/linux.json) | | Предыдущее исправление tRNS | Offline-команда с `--confcutdir`, шесть unit-модулей; отдельно `--noconftest` для границ | R: сохранённые 430 + 20 passed; 114 прежних вариантов побайтно совпали; Docker не участвовал | [Команды и результаты](evidence/review-trns-depth-2026-11-06/RESULTS.md) | -| Исправление памяти M | `make student-test` с `--confcutdir` и восемью unit-модулями; отдельно `--noconftest` для границ | Сохранённые 440 passed / 2 Linux-only skipped + 20 passed; 22 изображения / 132 идентичных варианта. Полный student-test и Linux/HTTP на M не запускались | [Команды](evidence/review-png-memory-2026-11-07/RESULTS.md), [offline](evidence/review-png-memory-2026-11-07/offline-tests.txt), [границы](evidence/review-png-memory-2026-11-07/boundaries.txt) | -| OpenSpec | `openspec validate --all --strict`; `openspec list --json` | M: 22 спецификации PASS, активных changes нет; цикл исправления памяти архивирован | [Аудит обновления](evidence/report-memory-audit-2026-11-07.md) | -| 3: минимум lab1–4, 202 и thumbnail | `make test` | Публичный smoke PASS через LB | [final-smoke.txt](evidence/forward-final-2026-11-06/final-smoke.txt) | +| Исправление памяти M | `make student-test` с `--confcutdir` и восемью unit-модулями; отдельно `--noconftest` для границ | Сохранённые 440 passed / 2 Linux-only skipped + 20 passed; 22 изображения / 132 идентичных варианта. Это offline-результат исправления; новые Linux/HTTP на F приведены ниже | [Команды](evidence/review-png-memory-2026-11-07/RESULTS.md), [offline](evidence/review-png-memory-2026-11-07/offline-tests.txt), [границы](evidence/review-png-memory-2026-11-07/boundaries.txt) | +| OpenSpec | `openspec validate --all --strict`; `openspec list --json` | F: 22 спецификации PASS, активных changes нет; цикл исправления памяти архивирован | [OpenSpec](evidence/final-memory-validation-2026-11-07/openspec.txt) | +| 3: минимум lab1–4, 202 и thumbnail | `make test` | Публичный smoke PASS через LB на F | [smoke.txt](evidence/final-memory-validation-2026-11-07/smoke.txt) | | 3: сессия, исходник и данные после рестарта | `make test-persistence ACTION_SCRIPT=scripts/restart.sh` | PASS; рестарты своих хранилищ и процессов подтверждены событиями | [persistence.txt](evidence/forward-final-2026-11-06/persistence.txt), [контейнеры](evidence/forward-final-2026-11-06/persistence-containers.txt) | | 3: отказ реплики | `make test-failover ACTION_SCRIPT=scripts/stop-one.sh`; `make restore` | 131 успешная запись, 0 ошибок, первая после отказа через 2.791 с; api-2 остановлен и восстановлен | [failover.txt](evidence/forward-final-2026-11-06/failover.txt), [контейнеры](evidence/forward-final-2026-11-06/failover-containers.txt), [restore.txt](evidence/forward-final-2026-11-06/restore.txt) | | 3: отдельный broker/worker, quorum, confirm, manual ack, prefetch | `rabbitmqctl list_queues/list_consumers/list_permissions`; проверки падений suite | Топология и prefetch=2 зафиксированы до forward; COMMIT/ack повторно проверен на D. Старый delivery-limit не доказывает policy R | [queues.txt](evidence/sqlalchemy-2026-11-06/grade3/queues.txt), [consumers.txt](evidence/sqlalchemy-2026-11-06/grade3/consumers.txt), [permissions.txt](evidence/sqlalchemy-2026-11-06/grade3/permissions.txt), [level4.json](evidence/forward-final-2026-11-06/level4.json) | | 3: worker down, рестарт API/broker, затем ready | `pipeline_suite.py --level 4`, `worker_down_broker_restart` | 202 queued, content 409, сообщение 201; очередь [1,0] переживает рестарт; тот же ID становится ready | [level4.json](evidence/forward-final-2026-11-06/level4.json) | | 3: конечные состояния и повторы | `s3_outage_recovers`, `retry_exhausted`, `duplicate_after_ready` в suite | S3 восстановлен → done на попытке 2; failed на попытке 5; дубль ready → duplicate_noop | [level4.json](evidence/forward-final-2026-11-06/level4.json) | -| 4: варианты и Linux-лимиты | `image_matrix`, `worker_limits` в suite | 26 fixtures: 17 ready и 9 отклонённых; 40 Мп, 0.5 с / 200 MiB → контролируемый failed, worker жив; штатно ready, peak 423/1024 MiB. Новые tRNS на V не прошли граничный ready-сценарий, см. ниже | [level4.json](evidence/forward-final-2026-11-06/level4.json) | +| 4: варианты и Linux-лимиты | `image_matrix`, `worker_limits` в suite | 26 fixtures: 17 ready и 9 отклонённых; 40 Мп, 0.5 с / 200 MiB → контролируемый failed, worker жив; штатно ready, peak 423/1024 MiB. Новые tRNS на V не прошли границу; после исправления M адресная validation F проходит, см. ниже | [level4.json](evidence/forward-final-2026-11-06/level4.json) | | 4: outbox, crash COMMIT→publish | `crash_commit_publish` | Relay exit 137; outbox не опубликован; после восстановления ready без новой job | [level4.json](evidence/forward-final-2026-11-06/level4.json) | | 4: backoff, DLQ, replay | `retry_backoff_jitter`, `malformed_message_dead_lettered`, `replay_failed`, `failed_retention` | Задержки 0.722422/1.010937/2.240832/4.845013 с; DLQ +1; replay failed→ready, ready→noop, после retention→expired | [level4.json](evidence/forward-final-2026-11-06/level4.json) | | 4: S3→COMMIT→ack, lease/fencing, cleanup | `crash_after_s3_before_commit`, `crash_after_commit_before_ack`, `lease_expiry_fencing` | Exit 137 в заданных окнах; один набор вариантов; старая аренда fenced; staging ready очищен | [level4.json](evidence/forward-final-2026-11-06/level4.json) | @@ -161,7 +161,7 @@ Python 3.14, FastAPI, gunicorn/uvicorn-worker, dishka и dishka-faststream, pyda Предыдущие 39/174 на `9ba3076fa8ba707de932e053fc22f455d83b3210` — историческое сравнение сохранности инвариантов до позднего forward, не ускорения: [старые результаты](evidence/sqlalchemy-2026-11-06/track2/qualified/RESULTS.md). Прерванный старый run3 исключён и заменён только третьим повтором; 10 принятых до прерывания ID восстановились. Корневые `evidence/level3.json`, `level4.json` и старые логи относятся к коду до SQLAlchemy и не подтверждают R. -## Ограничения и незавершённые подтверждения +## Ограничения Семь minor последнего независимого ревью M сохранены без исправления; они не блокируют отчёт или передачу следующей фазе. Новый minor JobMessage передан координатором в результате `lab5-release-load0-round1`; в отчётном этапе его offline-пробы не повторялись: @@ -196,13 +196,13 @@ Python 3.14, FastAPI, gunicorn/uvicorn-worker, dishka и dishka-faststream, pyda **Исходный major на V:** объявленный [OpenSpec-сценарий PNG на пределе пикселей](openspec/specs/lab5-image-variants/spec.md) требует ready при штатных пределах. Новые 40 Мп tRNS fixtures размером 35 759–385 445 байт его не проходят. [Linux-пробник с импортами worker](evidence/final-validation-2026-11-07/resource-probe-worker.txt) воспроизводит MemoryError в `images.py`: grayscale 2/4 — белый RGB-фон, grayscale16 — `I → L`, RGB16 — маски/повторное декодирование. Без tRNS gray2/gray4/RGB16 проходят; gray16 превышает память и без tRNS. Это провал конкретного граничного сценария; потери данных или падение сервиса не обнаружены. -Этот вывод относится к V. Причина исправлена отдельным агентом в M через OpenSpec, выполнено независимое re-review. Старый [findings.json](evidence/final-validation-2026-11-07/findings.json) сохраняет исходный major и шесть minor как историю; он не перезаписывается. Закрытие major на динамическом уровне ожидает перечисленных ниже повторов на M. +Этот вывод относится к V. Причина исправлена отдельным агентом в M через OpenSpec, выполнено независимое re-review. Старый [findings.json](evidence/final-validation-2026-11-07/findings.json) сохраняет исходный major и шесть minor как историю; он не перезаписывается. Динамическое закрытие major подтверждено новым прогоном F ниже; исходные FAIL V сохранены. Первый outage-прогон невалиден: `docker compose start worker` автоматически запустил БД; повторён только этот сценарий с точным container ID. Первая передача пробника через docker cp отклонена read-only rootfs, затем использован stdin/tmpfs. Эти ошибки обвязки и ранний cleanup FAIL сохранены отдельно и не объявлены успехом. Все команды, условия, ограничения и остановка — [RESULTS](evidence/final-validation-2026-11-07/RESULTS.md). -Запуск из чистого clone и отдельная throughput-матрица на V не выполнялись. Полный student-test, HTTP и реальный брокер выполнены именно на V. На M проверены только offline-пути и статика; публикация ожидает адресную validation. Push и Telegram не выполнялись. +Запуск из чистого clone и отдельная throughput-матрица на V не выполнялись. Полный student-test, HTTP и реальный брокер выполнены именно на V. Runtime M дополнительно проверен динамически на F ниже; публикация остаётся отдельной фазой. Push и Telegram не выполнялись. -## Исправление M и оставшаяся адресная validation +## Исправление M и завершённая адресная validation F [Результаты исправления](evidence/review-png-memory-2026-11-07/RESULTS.md) сохраняют четыре ожидаемых FAIL регрессии на исходном renderer и PASS после изменения. Счётчик одновременно живущих pixel buffers на 1025×769 дал: @@ -215,16 +215,20 @@ Python 3.14, FastAPI, gunicorn/uvicorn-worker, dishka и dishka-faststream, pyda Это модель pixel buffers, не RSS, виртуальная память процесса или проверка 40 Мп под Linux. До — [regression-before.txt](evidence/review-png-memory-2026-11-07/regression-before.txt), после — [offline-tests.txt](evidence/review-png-memory-2026-11-07/offline-tests.txt). Сохранённые 440 + 20 passed и 132 идентичных варианта подтверждают offline-часть. Независимое ревью M по данным координатора повторило 460 проверок с двумя Linux-only skips и не обнаружило major в доступной области. Его семь minor перечислены выше. -Назначенному финальному агенту остаётся выполнить на M, сохраняя новые результаты отдельно от V: +Адресная validation F выполнена после независимого review M. Runtime совпадает с M; от V изменён только renderer, поэтому PostgreSQL outage, delivery subset и три полных track2-повтора приняты без повторения. Аудит применимости — [load-validation](evidence/load-validation.md), команды и методика — [RESULTS](evidence/final-memory-validation-2026-11-07/RESULTS.md). -1. Linux-пробу с **импортами worker**, RLIMIT_AS=448 MiB и 30 с: четыре прежних 40 Мп tRNS fixtures в v1/v2, grayscale16 без tRNS и обычное задание после них. Команда — `PYTHONPATH=src:student-tests .venv/bin/python -m pytest --confcutdir=student-tests/unit student-tests/unit/test_png_memory.py::test_boundary_pngs_fit_worker_address_space -q -s`; эквивалентный контейнерный пробник допустим по процедуре исправления. -2. HTTP через LB: прежние `gray2/gray4/gray16/rgb16-40mp.png` должны пройти `202 → ready` при штатных лимитах, с неизменным оригиналом, точным tRNS, тремя вариантами и публикацией v2. Проверить одновременные рендеры при concurrency=2, память контейнера, отсутствие дубля эффекта и отката ready. -3. Повторить прежний PNG HTTP subset: восемь fixtures / 48 сравнений с независимым белым эталоном, Adam7/filter=4/EXIF=6, точный непрозрачный сосед. PASS V не выдавать за проверку изменённого renderer M. -4. Принудительные timeout и memory limit, затем обычное задание после каждого отказа. После штатного sweep проверить staging, outbox и дубли для новых ID; ранний no_orphans до sweep не повторять как методику. +| Критерий / команда | Результат F | Доказательство | +| --- | --- | --- | +| `linux-runner.py`: импорты worker, RLIMIT_AS=448 MiB, 30 с | Четыре прежних 40 Мп tRNS и grayscale16 без tRNS, v1/v2, обычный render после каждого — PASS; два параллельных RGB16 render — PASS | [команда](evidence/final-memory-validation-2026-11-07/linux.txt), [JSON](evidence/final-memory-validation-2026-11-07/linux.json) | +| `targeted.py png-boundary`: LB/API/relay/broker/worker | 8 сценариев / 8 инвариантов PASS; 202 → ready, original/bytes/hash/геометрия/tRNS, v2, stale/duplicate noop; 11 ID / 59 объектов | [команда](evidence/final-memory-validation-2026-11-07/png-boundary.txt), [JSON](evidence/final-memory-validation-2026-11-07/png-boundary.json) | +| Два одновременных HTTP jobs, v1/v2 | Перекрытие claimed→done; peak worker 885 428 224 байт (844.41 MiB) / 1 GiB; OOM=0 | [concurrent-rgb16](evidence/final-memory-validation-2026-11-07/png-boundary.json) | +| Принудительные 0.01 с / 200 MiB и следующие обычные задания | Два ожидаемых failed/processing_failed, worker жив; после каждого обычная загрузка ready; штатные 448 MiB/30 с/concurrency=2 восстановлены | [JSON](evidence/final-memory-validation-2026-11-07/png-boundary.json), [условия после](evidence/final-memory-validation-2026-11-07/conditions-after.json) | +| `targeted.py png-http`: точный tRNS, Adam7/filter=4/EXIF=6 | 8 fixtures / 48 сравнений v1/v2 с независимым эталоном, 8 инвариантов PASS; 8 ID / 56 объектов | [команда](evidence/final-memory-validation-2026-11-07/png-http.txt), [JSON](evidence/final-memory-validation-2026-11-07/png-http.json) | +| Sweep и SQL/S3 inventory обеих серий | Нет pending outbox/staging/дублей для новых ID; 19 ID / 115 объектов согласованы. Историческая DLQ=16 не выросла | Инварианты в двух JSON выше | -Полная инструкция — [обязательные проверки](evidence/review-png-memory-2026-11-07/RESULTS.md). Новые данные записываются в новый каталог: старый `targeted.py` защищён от перезаписи. От V изменён только renderer; поэтому прежние пригодные PostgreSQL outage, delivery subset и три полных track2-повтора автоматически не повторяются. Побайтная совместимость sample дополнительно подтверждена в [unchanged-rendering.json](evidence/review-png-memory-2026-11-07/unchanged-rendering.json). Если адресная проверка найдёт новую регрессию, область повторов уточняется по фактическому дефекту. +Все 30 SHA пяти файлов × двух версий × трёх вариантов совпали между Linux и HTTP. Peak RSS Linux-процесса — 342 956–406 312 KiB; это не cgroup memory и не виртуальный адресный предел. Диагностический параллельный пробник с дополнительным управляющим процессом дал cgroup peak 1 026 285 568 байт; он отделён от штатных HTTP jobs. Все memory.events=0. Исходные четыре FAIL V закрыты новым динамическим PASS F при неизменных лимитах. -На текущем отчётном этапе выполнены только лёгкие проверки и аудит сохранённого сырья — [report-memory-audit](evidence/report-memory-audit-2026-11-07.md). Docker, pytest, тяжёлые тесты и нагрузка не запускались. Полное подтверждение уровней 3/4 и «5» ожидает результатов этих проверок; прежние FAIL не объявлены PASS. +Условия F: тот же project и сохранённые volumes, Docker VM 16 CPU / 8 217 190 400 байт, worker 2 CPU / 1 GiB. В снимках нет чужих контейнеров; специальный фон не запускался, непрерывного контроля хоста нет. Throughput/SLO не заявляются. [Начальные условия](evidence/final-memory-validation-2026-11-07/conditions.json), [итоговые](evidence/final-memory-validation-2026-11-07/conditions-after.json). Стенд F остановлен через `make down` без `-v`: [команда](evidence/final-memory-validation-2026-11-07/down.txt), [пустой project](evidence/final-memory-validation-2026-11-07/stopped-containers.txt), [четыре volumes](evidence/final-memory-validation-2026-11-07/retained-volumes.txt). Push и Telegram не выполнялись. ## Вопросы защиты @@ -233,6 +237,6 @@ Python 3.14, FastAPI, gunicorn/uvicorn-worker, dishka и dishka-faststream, pyda - **Почему дубль безопасен?** Job/версия идентифицируются в БД, lease сериализует работу, fencing отвергает старого держателя, уникальный ключ эффекта защищает варианты. - **Как отличить долгую работу от смерти?** Живая работа продлевает lease; истёкшую восстанавливает relay. Поздняя фиксация не проходит lease_token. - **Почему v1 не затирает v2?** Versioned ключи и условие монотонного published_version; ready v1 остаётся доступной до успешной публикации v2. -- **Что ещё не доказано?** Потеря confirm, все сбои диска/сети, производительность под изолированной нагрузкой. Граничные 40 Мп tRNS не прошли на V; исправление M проверено offline, но его Linux/HTTP-подтверждение отсутствует, поэтому готовность к публикации не заявляется. +- **Что ещё не доказано?** Потеря confirm, все сбои диска/сети, производительность под изолированной нагрузкой. Граничные 40 Мп tRNS не прошли на V; исправление M подтверждено Linux/HTTP на F. Validation завершена; публикация требует отдельной фазы. Документация сверена через Context7: [SQLAlchemy 2.0.45 async](https://github.com/sqlalchemy/sqlalchemy/blob/rel_2_0_45/doc/build/orm/extensions/asyncio.rst), [Alembic 1.16.5 async migrations](https://github.com/sqlalchemy/alembic/blob/rel_1_16_5/docs/build/cookbook.rst), [FastStream 0.7.2 manual ack](https://github.com/ag2ai/faststream/blob/0.7.2/docs/docs/en/getting-started/acknowledgement.md). API 0.7.2 сопоставлен с используемым FastStream 0.7.8; прикладной порядок COMMIT/ack проверяется кодом и evidence, а не одной документацией. diff --git a/evidence/README.md b/evidence/README.md index ec28289f..e4de126c 100644 --- a/evidence/README.md +++ b/evidence/README.md @@ -2,13 +2,14 @@ Актуальный [REPORT.md](../REPORT.md) обновлён после независимого ревью **6096aa7948b8b666aa3892397a96d044a55f02c6 (M)**. Предыдущее review — **42575281b352d35bda17ee7601bae5548a996e91 (R)**; полные динамические серии — **0e921116610d289716af0a40ec823376eb8bbcbc (D)**. Validation на `b30e2f6a84419d1ca64525ffb40df92183cccaef` (V, runtime = R) подтвердила PostgreSQL outage, delivery subset и HTTP tRNS, но выявила четыре FAIL на 40 Мп PNG при штатной памяти. -В M изменён только renderer: плитки 256×256 и явное освобождение pixel core. 440 offline + 20 границ PASS, 2 Linux-only skips; 132 варианта совпали с V. Re-review не нашло major в статике/offline; **окончательное закрытие прежнего major требует Linux/HTTP evidence M**. Исходные FAIL V сохраняются и не становятся PASS. Аудит применимости V — [load-validation.md](load-validation.md), инструкция оставшихся проверок — [RESULTS исправления памяти](review-png-memory-2026-11-07/RESULTS.md). +В M изменён только renderer: плитки 256×256 и явное освобождение pixel core. 440 offline + 20 границ PASS, 2 Linux-only skips; 132 варианта совпали с V. Re-review не нашло major в статике/offline; **прежний major закрыт Linux/HTTP validation F** (`74c33160ac01618f70e9e1c6a121a5e45c3c7155`, runtime = M): пять граничных PNG, concurrency=2, принудительные лимиты и HTTP 8/48 PASS. 984 student tests passed / 2 Linux-only skips; Linux-эквивалент выполнен отдельно. Исходные FAIL V сохраняются и не становятся PASS. Аудит применимости V — [load-validation.md](load-validation.md), исходная инструкция адресных проверок — [RESULTS исправления памяти](review-png-memory-2026-11-07/RESULTS.md). ## Как читать каталог | Файлы / каталог | Код и роль доказательства | Применимость | | --- | --- | --- | -| [Исправление памяти](review-png-memory-2026-11-07/RESULTS.md) | M; реализация `1a8020524909ebc5e2e43303436c9d1ce3c1a87b` | 440 + 20 passed / 2 skips, счётчик pixel buffers, 132 идентичных варианта; 28 хешей. Linux/HTTP отсутствуют | +| [Адресная validation M](final-memory-validation-2026-11-07/RESULTS.md) | F, runtime = M | Linux 448 MiB/30 с, пять 40 Мп PNG × v1/v2; HTTP boundary 8 сценариев / 8 инвариантов и малая матрица 8/48 / 8 инвариантов; 19 ID / 115 объектов; major закрыт, семь minor сохранены | +| [Исправление памяти](review-png-memory-2026-11-07/RESULTS.md) | M; реализация `1a8020524909ebc5e2e43303436c9d1ce3c1a87b` | 440 + 20 passed / 2 skips, счётчик pixel buffers, 132 идентичных варианта; 28 хешей. Linux/HTTP выполняет следующий каталог validation F | | [Аудит обновления отчёта](report-memory-audit-2026-11-07.md) | M + только документация | Лёгкие проверки, аудит новых хешей/чисел/ссылок; семь minor последнего review, без новых динамических прогонов | | [Финальная validation](final-validation-2026-11-07/RESULTS.md), [аудит нагрузки](load-validation.md) | V, runtime = R | 980 tests, HTTP PNG и real DB outage; 12 адресных сценариев PASS; четыре 40 Мп PNG FAIL, один major; полный track2 не повторён | | [Первый аудит отчёта](report-audit-2026-11-07.md) | R + изменения документации, до validation V и исправления M | Реальные лёгкие проверки того этапа, ссылки, хеши, арифметика; без Docker и новых динамических тестов | @@ -22,7 +23,7 @@ | [sqlalchemy-2026-11-06/track2/qualified/RESULTS.md](sqlalchemy-2026-11-06/track2/qualified/RESULTS.md) | `9ba3076fa8ba707de932e053fc22f455d83b3210` | Старая квалификация 39/174 до позднего forward: run1, run2, run3-retry. Прерванный run3 исключён, повторена только эта серия | | Все корневые `*.txt` и `*.json` в `evidence/` | Историческая реализация до SQLAlchemy/Alembic, даты/старые SHA — внутри файлов и истории Git | **Не подтверждают R, D или M.** Не использовать старые порты, asyncpg-мигратор, результаты и формулировки как текущие | -Последняя строка включает `contract-checks.txt`, `environment.txt`, `failover-upload.json`, `failover.txt`, `level3.json`, `level4.json`, `limits.txt`, `operator.txt`, `persistence.txt`, `pipeline-stand.txt`, `s3-outage.json`, `s3-security.txt`, `smoke.txt`, `stack.txt`, `student-tests.txt`, `topology.txt`, `upload-faults.txt`. Эти файлы оставлены для истории, без изменения сырья. Старые Markdown-итоги также читаются в пределах указанного выше SHA; их прежние заявления о полноте не распространяются на M. В частности, требования «нужен fix/review» в load-validation.md и RESULTS V описывают историческую остановку: fix и re-review M уже выполнены, Linux/HTTP-подтверждение ещё ожидается. +Последняя строка включает `contract-checks.txt`, `environment.txt`, `failover-upload.json`, `failover.txt`, `level3.json`, `level4.json`, `limits.txt`, `operator.txt`, `persistence.txt`, `pipeline-stand.txt`, `s3-outage.json`, `s3-security.txt`, `smoke.txt`, `stack.txt`, `student-tests.txt`, `topology.txt`, `upload-faults.txt`. Эти файлы оставлены для истории, без изменения сырья. Старые Markdown-итоги также читаются в пределах указанного выше SHA; их прежние заявления о полноте не распространяются на M. В частности, требования «нужен fix/review» в load-validation.md и RESULTS V описывают историческую остановку: fix и re-review M уже выполнены, Linux/HTTP-подтверждение завершено на F; старые документы не переписаны. ## Основные первичные данные D @@ -31,17 +32,17 @@ - [final-smoke.txt](forward-final-2026-11-06/final-smoke.txt), [persistence.txt](forward-final-2026-11-06/persistence.txt), [failover.txt](forward-final-2026-11-06/failover.txt): публичные проверки. [persistence-containers.txt](forward-final-2026-11-06/persistence-containers.txt), [failover-containers.txt](forward-final-2026-11-06/failover-containers.txt), [restore.txt](forward-final-2026-11-06/restore.txt): фактические операции со своим стендом. - [student-test.txt](forward-final-2026-11-06/student-test.txt): 819 passed / 1 skipped до последних двух исправлений. Предыдущие offline-результаты R: [offline-tests.txt](review-trns-depth-2026-11-06/offline-tests.txt), [boundaries.txt](review-trns-depth-2026-11-06/boundaries.txt). Текущие M: [offline-tests.txt](review-png-memory-2026-11-07/offline-tests.txt), [boundaries.txt](review-png-memory-2026-11-07/boundaries.txt). - [conditions-before.json](forward-final-2026-11-06/conditions-before.json), [conditions-track-start.json](forward-final-2026-11-06/conditions-track-start.json), остальные `conditions-*.json`: моментальные срезы общего Docker, не непрерывный контроль фоновой нагрузки. -- [down.txt](forward-final-2026-11-06/down.txt), [stopped-containers.txt](forward-final-2026-11-06/stopped-containers.txt), [retained-volumes.txt](forward-final-2026-11-06/retained-volumes.txt): остановка стенда D. Более поздняя остановка V — [down.txt](final-validation-2026-11-07/down.txt), [stopped-containers.txt](final-validation-2026-11-07/stopped-containers.txt), [retained-volumes.txt](final-validation-2026-11-07/retained-volumes.txt): четыре volume сохранены. Исправление M и отчёт это состояние через Docker не перепроверяли. +- [down.txt](forward-final-2026-11-06/down.txt), [stopped-containers.txt](forward-final-2026-11-06/stopped-containers.txt), [retained-volumes.txt](forward-final-2026-11-06/retained-volumes.txt): остановка стенда D. Более поздняя остановка V — [down.txt](final-validation-2026-11-07/down.txt), [stopped-containers.txt](final-validation-2026-11-07/stopped-containers.txt), [retained-volumes.txt](final-validation-2026-11-07/retained-volumes.txt): четыре volume сохранены. Исправление M и отчёт Docker не запускали. Последняя остановка F — [down.txt](final-memory-validation-2026-11-07/down.txt), [пустой project](final-memory-validation-2026-11-07/stopped-containers.txt), [четыре volumes](final-memory-validation-2026-11-07/retained-volumes.txt). ## Не считать успехом или измерением производительности - `crash_publish_confirm` и raw `window: after publish, before confirm` — историческое имя/описание; реальная точка находится **после Basic.Ack и до COMMIT outbox**. Потерю confirm данный сценарий не проверял. - [grade3/limits.txt](sqlalchemy-2026-11-06/grade3/limits.txt) имеет **exit_code=1**, два ложных FAIL из-за порядка secrets. Это не PASS. - [clock-observation.json](forward-final-2026-11-06/clock-observation.json): UTC/elapsed run2 = 1161.195/186.458 с, run3 = 571.513/180.259 с. Причина неизвестна; длительности исключены из RPS/SLO/сравнения разброса. Функциональные результаты пригодны. -- `no_orphans` в итоговой серии проверяет выборку ID; 15 исторических/ожидаемых сообщений DLQ сохранены. Это не глобально пустые S3/DLQ. +- `no_orphans` проверяет выборку ID; на D сохранены 15 исторических/ожидаемых сообщений DLQ, после malformed-сценария V их 16; в F это число не выросло. Это не глобально пустые S3/DLQ. - `forward-final-2026-11-06/baseline.txt` — 0 тестов; `baseline-regressions.txt` — ожидаемые 29 FAIL до исправления. `review-fixes-2026-11-06/regressions-fixture-error.txt` — неуспешная промежуточная fixture; `review-trns-depth-2026-11-06/regressions-before.txt` — воспроизведённый дефект. Их сохраняют как диагностику, не суммируют с PASS. - Исторический [findings.json](review-trns-depth-2026-11-06/findings.json) содержит пять minor: окно confirm, limits, legacy reconcile, отдельный replay failed v2 и часы. Дополнительная документационная неточность `201` в `openspec/config.yaml` отражена в REPORT; конфиг этой фазе менять запрещено. Седьмой minor из review M — JobMessage принимает четыре значения вне JSON Schema; источник и ограничения — [аудит отчёта](report-memory-audit-2026-11-07.md). Исторические findings.json с пятью/шестью minor не перезаписываются. -Нагрузочных RPS/p95 для M здесь не заявлено. Финальный агент выполнил только отсутствующие/затронутые проверки и сохранил пригодные серии. После re-review M повторяются только затронутые PNG/ресурсные проверки: четыре 40 Мп tRNS и grayscale16 без tRNS с импортами worker, HTTP subset 8/48, concurrency=2, v1/v2, принудительные лимиты и cleanup после sweep. Точная актуальная процедура — [исправление памяти](review-png-memory-2026-11-07/RESULTS.md). PostgreSQL outage, delivery subset и полный track2 повторно не нужны без нового основания. +Нагрузочных RPS/p95 для M здесь не заявлено. Финальный агент выполнил только отсутствующие/затронутые проверки и сохранил пригодные серии. После re-review M повторены только затронутые PNG/ресурсные проверки: четыре 40 Мп tRNS и grayscale16 без tRNS с импортами worker, HTTP subset 8/48, concurrency=2, v1/v2, принудительные лимиты и cleanup после sweep. Выполненная процедура и результаты — [validation F](final-memory-validation-2026-11-07/RESULTS.md). PostgreSQL outage, delivery subset и полный track2 повторно не нужны без нового основания. -Сохранять только обезличенные команды, exit codes, SHA, условия и агрегаты. Секреты, `.env`, credentials, session tokens/cookies, реальные сообщения, дампы и signed URLs в evidence не входят. Существующие сырые измерения в отчётной фазе неизменны. +Сохранять только обезличенные команды, exit codes, SHA, условия и агрегаты. Секреты, `.env`, credentials, session tokens/cookies, реальные сообщения, дампы и signed URLs в evidence не входят. Существующие сырые измерения неизменны; новые свидетельства записаны отдельно. Validation завершена, публикация не выполнялась и требует отдельной фазы. diff --git a/evidence/final-memory-validation-2026-11-07/RESULTS.md b/evidence/final-memory-validation-2026-11-07/RESULTS.md new file mode 100644 index 00000000..572631e9 --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/RESULTS.md @@ -0,0 +1,55 @@ +# Адресная validation исправления памяти PNG + +**PASS. Прежний major закрыт динамически.** Измерен HEAD `74c33160ac01618f70e9e1c6a121a5e45c3c7155`, runtime побайтно равен прошедшему review `6096aa7948b8b666aa3892397a96d044a55f02c6` (M). Реализация, конфигурация и нормативные файлы в этой фазе не менялись. Публикация не выполнялась и требует отдельной фазы. + +Исходные четыре HTTP FAIL и Linux MemoryError на V сохранены в [предыдущей validation](../final-validation-2026-11-07/RESULTS.md). Они не переименованы в PASS: здесь новый образ и новые результаты после отдельного fix/re-review. От V изменён только renderer, поэтому три пригодных повтора track2 на D, PostgreSQL outage и delivery subset на V приняты без повторения. Решения по каждой серии — [load-validation.md](../load-validation.md); SHA, diff, 53 прежних и 28 fix-хешей — [audit.json](audit.json). + +## Условия и методика + +2026-11-07 по локальной дате; UTC команд — 2026-11-06. Darwin arm64, Docker 28.3.2, Linux aarch64, VM 16 CPU / 8 217 190 400 байт. Project `mtusi2026lab5`, API 18085, stats/UI 25085/25086, все published ports на loopback. Использованы сохранённые volumes, не чистый clone. Worker: 2 CPU / 1 GiB; renderer RLIMIT_AS=448 MiB, 30 с, concurrency=2. Значения не повышались. Образ и закреплённые версии — [build.txt](build.txt), [runtime.txt](runtime.txt), [conditions.json](conditions.json). + +Снимки до/после и внутри серий не показывают чужих работающих контейнеров. Специальная фоновая нагрузка не запускалась. Load average хоста: 1.67/2.11/2.34 перед этапом, 2.62/2.65/2.53 перед проверками, 6.41/4.18/3.19 после. Непрерывного контроля хоста нет; throughput, RPS, p95 и новые SLO не заявляются. Длительности — диагностические монотонные интервалы конкретных команд/рендеров, не benchmark. [Условия после](conditions-after.json) подтверждают восстановленные 448 MiB/30 с/concurrency=2 и отсутствие OOM. + +Linux-пробник запускает новые процессы с **импортами messenger.worker**, настоящим RLIMIT_AS и alarm=30 с на каждый рендер. Пять файлов проходят v1/v2, затем обычное изображение в том же процессе. Два дополнительных процесса одновременно рендерят RGB16; пересечение измерено монотонными отметками внутри render. Пробник использует те же четыре сохранённые PNG 8000×5000; пятый получается удалением только tRNS из grayscale16. Входные SHA сохранены. Реальный HTTP использует LB/API/relay/broker/worker и ту же конфигурацию. При concurrency=2 журнал БД подтверждает перекрытие claimed→done в обеих версиях. + +После диагностических процессов worker пересоздан без изменения образа/лимитов для отдельного cgroup peak HTTP — [reset-worker-peak.txt](reset-worker-peak.txt). Это не повтор нагрузки. Ожидаемые отказы создаются только на двух новых заданиях: 0.01 с и 200 MiB. После каждого лимиты восстановлены и обычная загрузка достигает ready. Перед SQL/S3-инвариантами дождались штатного sweep. Старые данные и DLQ не удалялись. + +## Команды и результаты + +Команды выполнялись из корня репозитория. `source evidence/final-memory-validation-2026-11-07/env.sh` задаёт несекретные Compose-параметры. Обёртка `python3 scripts/capture_evidence.py <новый-файл> -- <команда>` сохраняет SHA, команду, exit code и elapsed; существующие результаты не перезаписывает. + +| Команда / проверка | Результат | Первичные данные | +| --- | --- | --- | +| `make check validate lint` | PASS | [checks.txt](checks.txt) | +| `openspec validate --all --strict`; `openspec list --json` | 22 PASS, changes=[] | [openspec.txt](openspec.txt), [active-changes.txt](active-changes.txt) | +| `make student-test PYTEST_ARGS='-q --tb=short'` | 984 passed, 2 Linux-only skipped, 19 stack deselected; 171.26 с pytest. Пропуски не названы PASS; Linux-эквивалент выполнен отдельно | [student-test.txt](student-test.txt) | +| `docker compose build`; `docker compose up -d --wait`; `make test` | Сборка, миграции/готовность и публичный smoke PASS | [build.txt](build.txt), [up.txt](up.txt), [smoke.txt](smoke.txt) | +| `.venv/bin/python evidence/final-memory-validation-2026-11-07/linux-runner.py` | Пять 40 Мп PNG × v1/v2 и обычный render после каждого PASS; два параллельных RGB16 × v1/v2 PASS | [linux.txt](linux.txt), [linux.json](linux.json), [child](linux-child.py), [runner](linux-runner.py) | +| `PYTHONPATH=src .venv/bin/python evidence/final-memory-validation-2026-11-07/targeted.py png-boundary` | 8 сценариев и 8 инвариантов PASS; 11 ID, 9 ready, 2 ожидаемых failed, 59 S3-объектов | [команда](png-boundary.txt), [JSON](png-boundary.json), [обвязка](targeted.py) | +| `PYTHONPATH=src .venv/bin/python evidence/final-memory-validation-2026-11-07/targeted.py png-http` | 8 fixtures, 48 сравнений вариантов v1/v2 с независимым белым эталоном; 8 инвариантов PASS, 8 ID / 56 объектов | [команда](png-http.txt), [JSON](png-http.json) | + +Граничные HTTP-проверки: четыре прежних tRNS и grayscale16 без tRNS достигают ready в v1/v2; исходник неизменен; SHA, длина, MIME и размеры вариантов согласованы с байтами. Белая область белая, соседний RGB16 с отличием младшего бита остаётся непрозрачным. Все 30 хешей пяти файлов × двух версий × трёх вариантов совпали между Linux и HTTP. Поздняя v1 и дубль v2 не изменили опубликованный снимок; по шесть строк вариантов на ID. Два одновременных HTTP-вложения также проходят обе версии. Малая матрица включает grayscale 1/2/4/8/16, RGB8/16 и RGB16 Adam7/filter=4/EXIF=6. + +| Linux-файл | Peak RSS процесса, KiB | HTTP: обе версии | +| --- | ---: | --- | +| grayscale2 tRNS | 343 076 | ready | +| grayscale4 tRNS | 342 956 | ready | +| grayscale16 tRNS | 365 508 | ready | +| grayscale16 без tRNS | 365 492 | ready | +| RGB16 tRNS | 406 312 | ready | + +При двух **реальных HTTP jobs** cgroup peak worker = **885 428 224 байт (844.41 MiB) / 1 GiB**, все memory.events=0. Диагностический Linux-запуск, включающий idle worker, управляющий процесс и два дополнительных дочерних процесса, дал другой peak: 1 026 285 568 байт / 1 GiB, также без OOM. Это разные условия; диагностический peak не выдаётся за память штатных HTTP jobs. RSS не равен RLIMIT_AS или cgroup memory. + +Инварианты обеих HTTP-серий проверяют terminal, single_effect, no_ready_rollback, monotonic_publication, bytes_match_metadata, bounded_attempts, no_orphans и no_lost_202. После sweep нет staging/pending outbox/дублирующих эффектов для новых ID; S3 inventory согласован с БД. DLQ осталась 16: это сохранённые исторические/ожидаемые записи, не новые ошибки этой серии. Проверка scoped, не глобальная очистка. + +## Завершение и ограничения + +Свои контейнеры остановлены через `make down` без `-v`: [до остановки](final-containers.txt), [down](down.txt), [пустой project](stopped-containers.txt), [четыре volumes](retained-volumes.txt), [пустой общий running list](running-containers-after.txt). [Ретроспективный срез Docker events](container-events.json) ограничен последними 256 событиями daemon и подтверждает финальную остановку; он не используется как полная история промежуточных worker-stop. + +Семь minor независимого review сохранены в [findings.json](findings.json) и ограничениях [REPORT](../../REPORT.md). Новых major не обнаружено. Потеря publisher confirm, все возможные отказы диска/сети и изолированная throughput-матрица не доказаны; выбран трек 2. Исходный major памяти закрывается только для проверенных сценариев и закреплённой версии Pillow. + +Context7 вызван для Pillow, но вернул исчерпание месячной квоты. Использован официальный [Pillow: Image lifecycle](https://pillow.readthedocs.io/en/stable/reference/open_files.html): `Image.close()` уничтожает image core, контекстный менеджер сам core не уничтожает. Эта справка не заменяет выполненные Linux-проверки. + +Перед коммитом проверены разрешённый scope, отсутствие секретов в tracked файлах, локальные ссылки и сохранность runtime/нормативных файлов; результаты — [final-audit.json](final-audit.json), [secret-scan.json](secret-scan.json), [final-checks.txt](final-checks.txt). Контрольные суммы новых артефактов — [sha256.json](sha256.json). Push и Telegram не выполнялись. + +Полный `git diff --cached --check` обнаружил 17 trailing-whitespace строк в сыром выводе smoke и двух HTTP-команд. Вывод сохранён без редактирования; отдельная проверка документов/обвязки проходит. Это формат console output, не результат сценария приложения. diff --git a/evidence/final-memory-validation-2026-11-07/active-changes.txt b/evidence/final-memory-validation-2026-11-07/active-changes.txt new file mode 100644 index 00000000..ca9a1016 --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/active-changes.txt @@ -0,0 +1,11 @@ +date: 2026-11-06T22:54:44Z commit: 74c33160ac01618f70e9e1c6a121a5e45c3c7155 +environment: {} +$ openspec list --json +{ + "changes": [], + "root": { + "path": "", + "source": "nearest" + } +} +exit_code: 0 elapsed_seconds: 0.974 diff --git a/evidence/final-memory-validation-2026-11-07/audit-files.py b/evidence/final-memory-validation-2026-11-07/audit-files.py new file mode 100644 index 00000000..954d9b7a --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/audit-files.py @@ -0,0 +1,153 @@ +import ast +import hashlib +import json +import re +import subprocess +from pathlib import Path + +ROOT = Path.cwd() +FOLDER = Path(__file__).resolve().parent.relative_to(ROOT) +MEASURED = "74c33160ac01618f70e9e1c6a121a5e45c3c7155" +REVIEWED = "6096aa7948b8b666aa3892397a96d044a55f02c6" + + +def git(*args): + return subprocess.check_output(["git", *args], text=True).strip() + + +assert git("rev-parse", "HEAD") == MEASURED +assert git("branch", "--show-current") == "solution/bpi2303-kostylev" +paths = git("diff", "--name-only", MEASURED).splitlines() +assert all(p in {"REPORT.md", "AGENTS.md"} or p.startswith("evidence/") for p in paths) +runtime_diff = git( + "diff", + "--name-only", + REVIEWED, + "--", + "src", + "infra", + "compose.yaml", + "Dockerfile", + "pyproject.toml", + "uv.lock", + "alembic", + "scripts", + "student-tests", + "openspec", +) +assert not runtime_diff +assert not git( + "diff", "--name-only", "upstream/main", "--", "contracts", "tests", "README.md", "COURSE.md" +) +subprocess.run(["git", "diff", "--check"], check=True) +whitespace = subprocess.run(["git", "diff", "--cached", "--check"], capture_output=True, text=True) +raw_whitespace = re.findall(r"^([^\n:]+):\d+: trailing whitespace\.$", whitespace.stdout, re.M) +assert whitespace.returncode in (0, 2) +assert set(raw_whitespace) <= { + str(FOLDER / "png-boundary.txt"), + str(FOLDER / "png-http.txt"), + str(FOLDER / "smoke.txt"), +} +subprocess.run( + ["git", "diff", "--cached", "--check", "--", ".", f":(exclude){FOLDER}/*.txt"], + check=True, +) +tracked = set(git("ls-files").splitlines()) +docs = [ + Path("REPORT.md"), + Path("AGENTS.md"), + Path("evidence/README.md"), + Path("evidence/load-validation.md"), + FOLDER / "RESULTS.md", +] +links = 0 +for doc in docs: + content = doc.read_text() + assert len(re.findall(r"^```", content, re.M)) % 2 == 0, doc + for target in re.findall(r"\]\(([^)]+)\)", content): + if re.match(r"(?:https?://|#)", target): + continue + destination = (doc.parent / target.split("#")[0]).resolve() + assert destination.exists(), (doc, target) + relative = str(destination.relative_to(ROOT)) + assert relative in tracked or any(p.startswith(relative + "/") for p in tracked), relative + links += 1 +json_files = 0 +for name in tracked: + if name.endswith(".json"): + json.loads(Path(name).read_text()) + json_files += 1 +for path in FOLDER.glob("*.py"): + ast.parse(path.read_text(), filename=str(path)) +hashes = 0 +for manifest, key in [ + ("evidence/final-validation-2026-11-07/sha256.json", None), + ("evidence/review-png-memory-2026-11-07/checks.json", "sha256"), +]: + entries = json.loads(Path(manifest).read_text()) + if key: + entries = entries[key] + for name, expected in entries.items(): + assert hashlib.sha256(Path(name).read_bytes()).hexdigest() == expected, name + hashes += 1 +accepted = [] +for name in [ + "evidence/forward-final-2026-11-06/level4.json", + *[f"evidence/forward-final-2026-11-06/track-run{n}.json" for n in (1, 2, 3)], + "evidence/final-validation-2026-11-07/postgres-outage-retry.json", + "evidence/final-validation-2026-11-07/delivery-targeted.json", +]: + data = json.loads(Path(name).read_text()) + scenarios = data.get("scenarios", data.get("cases")) + assert data["result"] == "PASS" + assert all(x["result"] == "PASS" for x in scenarios + data["invariants"]) + accepted.append( + { + "file": name, + "source_sha": data["source_sha"], + "scenarios": len(scenarios), + "invariants": len(data["invariants"]), + } + ) +own_containers = subprocess.check_output( + ["docker", "ps", "-aq", "--filter", "label=com.docker.compose.project=mtusi2026lab5"], text=True +).strip() +assert not own_containers +volumes = subprocess.check_output( + [ + "docker", + "volume", + "ls", + "--filter", + "label=com.docker.compose.project=mtusi2026lab5", + "--format", + "{{.Name}}", + ], + text=True, +).splitlines() +assert len(volumes) == 4 +report = { + "measured_sha": MEASURED, + "reviewed_runtime": REVIEWED, + "runtime_equal": True, + "normative_equal_to_upstream_main": True, + "changed_paths": paths, + "local_links_verified": links, + "tracked_json_parsed": json_files, + "previous_and_fix_hashes_verified": hashes, + "raw_diff_check_exit": whitespace.returncode, + "preserved_raw_trailing_whitespace_lines": len(raw_whitespace), + "docs_and_helpers_diff_check": "PASS", + "accepted_without_rerun": accepted, + "own_containers": [], + "retained_volumes": volumes, + "result": "PASS", +} +(FOLDER / "final-audit.json").write_text(json.dumps(report, ensure_ascii=False, indent=2) + "\n") +print( + json.dumps( + {k: v for k, v in report.items() if k not in {"changed_paths", "accepted_without_rerun"}}, + ensure_ascii=False, + indent=2, + ) +) diff --git a/evidence/final-memory-validation-2026-11-07/audit.json b/evidence/final-memory-validation-2026-11-07/audit.json new file mode 100644 index 00000000..4d9462aa --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/audit.json @@ -0,0 +1,25 @@ +{ + "head": "74c33160ac01618f70e9e1c6a121a5e45c3c7155", + "reviewed_runtime": "6096aa7948b8b666aa3892397a96d044a55f02c6", + "runtime_review_equal": true, + "runtime_diff_since_previous_validation": [ + "src/messenger/attachments/infrastructure/images.py" + ], + "previous_artifact_hashes_verified": 53, + "platform": "macOS-15.1-arm64-arm-64bit-Mach-O", + "host_load": [ + 1.66796875, + 2.11279296875, + 2.3447265625 + ], + "docker": "28.3.2 16 8217190400", + "running_containers_before": "", + "image_fixture_hashes": { + "rgb16-40mp.png": "3c4418a6f6a7676298b30b70ebbde9d12929f1345152f4fae979caf5ba1cb3f7", + "gray4-40mp.png": "64e665928c08ac3721324af4f8e2e9d2e98230dc1be389dde7bbf365650b08cd", + "gray2-40mp.png": "e1238de6a5be9dbce36abee904f7233f8ff7be59e405b528671940630cce11f6", + "gray16-40mp.png": "b59784ae916d50b41b15afa4bdd474a8699f099da55efd53580d3f97180f3800" + }, + "fix_hashes_verified": 28, + "linux_http_variant_hashes_equal": 30 +} diff --git a/evidence/final-memory-validation-2026-11-07/build.txt b/evidence/final-memory-validation-2026-11-07/build.txt new file mode 100644 index 00000000..6f594030 --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/build.txt @@ -0,0 +1,90 @@ +date: 2026-11-06T22:54:41Z commit: 74c33160ac01618f70e9e1c6a121a5e45c3c7155 +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-memory-validation"} +$ docker compose build +#1 [internal] load local bake definitions +#1 reading from stdin 441B done +#1 DONE 0.0s + +#2 [internal] load build definition from Dockerfile +#2 transferring dockerfile: 1.65kB done +#2 DONE 0.0s + +#3 [internal] load metadata for ghcr.io/astral-sh/uv:0.9.7@sha256:ba4857bf2a068e9bc0e64eed8563b065908a4cd6bfb66b531a9c424c8e25e142 +#3 DONE 0.0s + +#4 [internal] load metadata for docker.io/library/python:3.14-slim-trixie@sha256:51dafde81dbdb6ebde285137a295cf18a47ca95234fe388a343719cb97305b3d +#4 DONE 1.6s + +#5 [internal] load .dockerignore +#5 transferring context: 453B done +#5 DONE 0.0s + +#6 [builder 1/7] FROM docker.io/library/python:3.14-slim-trixie@sha256:51dafde81dbdb6ebde285137a295cf18a47ca95234fe388a343719cb97305b3d +#6 resolve docker.io/library/python:3.14-slim-trixie@sha256:51dafde81dbdb6ebde285137a295cf18a47ca95234fe388a343719cb97305b3d 0.0s done +#6 DONE 0.0s + +#7 FROM ghcr.io/astral-sh/uv:0.9.7@sha256:ba4857bf2a068e9bc0e64eed8563b065908a4cd6bfb66b531a9c424c8e25e142 +#7 resolve ghcr.io/astral-sh/uv:0.9.7@sha256:ba4857bf2a068e9bc0e64eed8563b065908a4cd6bfb66b531a9c424c8e25e142 0.0s done +#7 DONE 0.0s + +#8 [internal] load build context +#8 transferring context: 55.94kB 0.0s done +#8 DONE 0.0s + +#9 [builder 4/7] COPY pyproject.toml uv.lock README.md ./ +#9 CACHED + +#10 [builder 3/7] WORKDIR /build +#10 CACHED + +#11 [builder 2/7] COPY --from=ghcr.io/astral-sh/uv:0.9.7@sha256:ba4857bf2a068e9bc0e64eed8563b065908a4cd6bfb66b531a9c424c8e25e142 /uv /usr/local/bin/uv +#11 CACHED + +#12 [builder 5/7] RUN uv sync --locked --no-dev --no-install-project --no-editable +#12 CACHED + +#13 [builder 6/7] COPY src ./src +#13 DONE 0.1s + +#14 [builder 7/7] RUN uv sync --locked --no-dev --no-editable +#14 0.246 Resolved 84 packages in 9ms +#14 0.261 Building mtusi-messenger @ file:///build +#14 3.076 Built mtusi-messenger @ file:///build +#14 3.081 Prepared 1 package in 2.82s +#14 3.086 Installed 1 package in 4ms +#14 3.306 Bytecode compiled 2301 files in 220ms +#14 3.306 + mtusi-messenger==1.5.0 (from file:///build) +#14 DONE 3.3s + +#15 [runtime 2/6] RUN groupadd --system --gid 10001 messenger && useradd --system --uid 10001 --gid messenger --no-create-home --shell /usr/sbin/nologin messenger +#15 CACHED + +#16 [runtime 3/6] COPY --from=builder --chown=root:root /opt/venv /opt/venv +#16 DONE 0.7s + +#17 [runtime 4/6] WORKDIR /app +#17 DONE 0.0s + +#18 [runtime 5/6] COPY --chown=root:root alembic.ini ./ +#18 DONE 0.0s + +#19 [runtime 6/6] COPY --chown=root:root alembic ./alembic +#19 DONE 0.0s + +#20 exporting to image +#20 exporting layers +#20 exporting layers 3.1s done +#20 exporting manifest sha256:822ff6808de5ef24f7f560bfbf7d074f03882cf60f79ec17b72ec20b27fcb882 +#20 exporting manifest sha256:822ff6808de5ef24f7f560bfbf7d074f03882cf60f79ec17b72ec20b27fcb882 done +#20 exporting config sha256:9ad245995fe138e23bc22e352d3a77ee0bf65ae6979997c6da067bd8d5315782 done +#20 exporting attestation manifest sha256:cf7e1da74a249e6859a38405addb0350aab512b93f6e62e66405ae1936db4e38 done +#20 exporting manifest list sha256:9a4299f2f673c414d67c3cc1f1debf4a56d9358f4a1ae85703152d48e8ef1608 done +#20 naming to docker.io/library/mtusi-messenger:lab5-memory-validation done +#20 unpacking to docker.io/library/mtusi-messenger:lab5-memory-validation +#20 unpacking to docker.io/library/mtusi-messenger:lab5-memory-validation 0.6s done +#20 DONE 3.8s + +#21 resolving provenance for metadata file +#21 DONE 0.0s + api Built +exit_code: 0 elapsed_seconds: 14.282 diff --git a/evidence/final-memory-validation-2026-11-07/checks.txt b/evidence/final-memory-validation-2026-11-07/checks.txt new file mode 100644 index 00000000..798d90d9 --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/checks.txt @@ -0,0 +1,14 @@ +date: 2026-11-06T22:54:42Z commit: 74c33160ac01618f70e9e1c6a121a5e45c3c7155 +environment: {} +$ make check validate lint +python3 scripts/check_contract.py +PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. +.venv/bin/python scripts/validate_openapi.py +PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested. +.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 +198 files already formatted +.venv/bin/ty check src student-tests alembic +All checks passed! +exit_code: 0 elapsed_seconds: 0.650 diff --git a/evidence/final-memory-validation-2026-11-07/conditions-after.json b/evidence/final-memory-validation-2026-11-07/conditions-after.json new file mode 100644 index 00000000..9116b7ca --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/conditions-after.json @@ -0,0 +1,11 @@ +{ + "at": "2026-11-06T23:18:53.248018+00:00", + "host_load": [ + 6.40869140625, + 4.1806640625, + 3.1875 + ], + "running": "mtusi2026lab5-worker-1 Up About a minute (healthy)\nmtusi2026lab5-api-1 Up 6 minutes (healthy)\nmtusi2026lab5-api-2 Up 6 minutes (healthy)\nmtusi2026lab5-relay-1 Up 6 minutes (healthy)\nmtusi2026lab5-broker-1 Up 6 minutes (healthy)\nmtusi2026lab5-postgres-1 Up 6 minutes (healthy)\nmtusi2026lab5-lb-1 Up 6 minutes (healthy)\nmtusi2026lab5-s3-1 Up 6 minutes (healthy)\nmtusi2026lab5-valkey-1 Up 6 minutes (healthy)", + "worker_limits": "448\n30\n2", + "memory_events": "low 0\nhigh 0\nmax 0\noom 0\noom_kill 0\noom_group_kill 0" +} diff --git a/evidence/final-memory-validation-2026-11-07/conditions.json b/evidence/final-memory-validation-2026-11-07/conditions.json new file mode 100644 index 00000000..dc12f43e --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/conditions.json @@ -0,0 +1,166 @@ +{ + "platform": "macOS-15.1-arm64-arm-64bit-Mach-O", + "host_load": [ + 2.62109375, + 2.6455078125, + 2.53076171875 + ], + "running": "mtusi2026lab5-api-1 Up 2 minutes (healthy)\nmtusi2026lab5-api-2 Up 2 minutes (healthy)\nmtusi2026lab5-worker-1 Up 2 minutes (healthy)\nmtusi2026lab5-relay-1 Up 2 minutes (healthy)\nmtusi2026lab5-broker-1 Up 2 minutes (healthy)\nmtusi2026lab5-postgres-1 Up 2 minutes (healthy)\nmtusi2026lab5-lb-1 Up 2 minutes (healthy)\nmtusi2026lab5-s3-1 Up 2 minutes (healthy)\nmtusi2026lab5-valkey-1 Up 2 minutes (healthy)", + "containers": [ + { + "name": "/mtusi2026lab5-api-1", + "id": "d1dcbda238669764840b38a8b9cf22d889ffc356945e165f019c4814bb96553d", + "image": "sha256:9a4299f2f673c414d67c3cc1f1debf4a56d9358f4a1ae85703152d48e8ef1608", + "limits": { + "Memory": 536870912, + "NanoCpus": 1000000000, + "PortBindings": {} + }, + "volumes": [] + }, + { + "name": "/mtusi2026lab5-api-2", + "id": "1eaf0fe05de650a1c2f7ced3e360aabbf8ad59566f40beefc2d745fa5277688e", + "image": "sha256:9a4299f2f673c414d67c3cc1f1debf4a56d9358f4a1ae85703152d48e8ef1608", + "limits": { + "Memory": 536870912, + "NanoCpus": 1000000000, + "PortBindings": {} + }, + "volumes": [] + }, + { + "name": "/mtusi2026lab5-worker-1", + "id": "a9afb0e9cc245a54eb871ddd44fcf8661949789de59603ded5236b5f9e9f1d7c", + "image": "sha256:9a4299f2f673c414d67c3cc1f1debf4a56d9358f4a1ae85703152d48e8ef1608", + "limits": { + "Memory": 1073741824, + "NanoCpus": 2000000000, + "PortBindings": {} + }, + "volumes": [] + }, + { + "name": "/mtusi2026lab5-relay-1", + "id": "63225b5eff8e1eb2870376c487b8925f9dbbe9bb8a636f4e2cdc12a24becf577", + "image": "sha256:9a4299f2f673c414d67c3cc1f1debf4a56d9358f4a1ae85703152d48e8ef1608", + "limits": { + "Memory": 201326592, + "NanoCpus": 500000000, + "PortBindings": {} + }, + "volumes": [] + }, + { + "name": "/mtusi2026lab5-migrate-1", + "id": "34901a09ef7b837c6ce87116d2035d842762d2c86f8562cade96d3915a80e6f0", + "image": "sha256:9a4299f2f673c414d67c3cc1f1debf4a56d9358f4a1ae85703152d48e8ef1608", + "limits": { + "Memory": 268435456, + "NanoCpus": 500000000, + "PortBindings": {} + }, + "volumes": [] + }, + { + "name": "/mtusi2026lab5-s3-init-1", + "id": "6e80e83ed5c5470bf22c5a9cd7c835788fbdff94f1f28f8649df6b667c153f89", + "image": "sha256:ab024bfebee49a750ce886b4c70963ccd9ddaa03f491704a90710641d7a26699", + "limits": { + "Memory": 67108864, + "NanoCpus": 500000000, + "PortBindings": {} + }, + "volumes": [] + }, + { + "name": "/mtusi2026lab5-broker-1", + "id": "be1942ad69b426f8b7c9189b0209021b169c6c8d0ee633f302d6d659a4143377", + "image": "sha256:54ef5ff505352c1beef05a97ee9bd6ab95b3559a76629ba0119b1d63d8d6e4b2", + "limits": { + "Memory": 536870912, + "NanoCpus": 1000000000, + "PortBindings": { + "15672/tcp": [ + { + "HostIp": "127.0.0.1", + "HostPort": "25086" + } + ] + } + }, + "volumes": [ + "mtusi2026lab5_broker-data" + ] + }, + { + "name": "/mtusi2026lab5-postgres-1", + "id": "a0b9f2742b9737ac0e32423d767438cab12af55a00cc1d68515ca9f07c2758ed", + "image": "sha256:266d3c257594e195b309ae9d1805e54c788f1d7b375f56bf6c367aac6c917e7b", + "limits": { + "Memory": 1073741824, + "NanoCpus": 2000000000, + "PortBindings": {} + }, + "volumes": [ + "mtusi2026lab5_pgdata" + ] + }, + { + "name": "/mtusi2026lab5-lb-1", + "id": "4ddcc75182e6044288c7a8c7bddca7b8c5fc6dab9b18c429e61ab1d292680111", + "image": "sha256:5893840576071e6217cd52ebdcc14f454c6f7a631056fa6f4e0f40d3cac4215b", + "limits": { + "Memory": 134217728, + "NanoCpus": 1000000000, + "PortBindings": { + "8080/tcp": [ + { + "HostIp": "127.0.0.1", + "HostPort": "18085" + } + ], + "8404/tcp": [ + { + "HostIp": "127.0.0.1", + "HostPort": "25085" + } + ] + } + }, + "volumes": [] + }, + { + "name": "/mtusi2026lab5-s3-1", + "id": "29b3e7c3a260f035ba99f5ce5f3e8a8b7077c56377b17e25503f16fb7fbad7c3", + "image": "sha256:ed9210d6411d77ffceb70d94b964a3cb7d225983368bc25bebe01e995293dcc2", + "limits": { + "Memory": 536870912, + "NanoCpus": 1000000000, + "PortBindings": {} + }, + "volumes": [ + "mtusi2026lab5_s3data" + ] + }, + { + "name": "/mtusi2026lab5-valkey-1", + "id": "647882797ca28a7e07453f00bd198433c80d8a8b8e7013279bc8954eafe11db6", + "image": "sha256:2602ace2be6569bc2bbb06f873776516ab9089821525be34f4305c67eb9db02a", + "limits": { + "Memory": 134217728, + "NanoCpus": 500000000, + "PortBindings": {} + }, + "volumes": [ + "mtusi2026lab5_valkeydata" + ] + } + ], + "fixture_sha256": { + "rgb16-40mp.png": "3c4418a6f6a7676298b30b70ebbde9d12929f1345152f4fae979caf5ba1cb3f7", + "gray4-40mp.png": "64e665928c08ac3721324af4f8e2e9d2e98230dc1be389dde7bbf365650b08cd", + "gray2-40mp.png": "e1238de6a5be9dbce36abee904f7233f8ff7be59e405b528671940630cce11f6", + "gray16-40mp.png": "b59784ae916d50b41b15afa4bdd474a8699f099da55efd53580d3f97180f3800" + } +} diff --git a/evidence/final-memory-validation-2026-11-07/container-events.json b/evidence/final-memory-validation-2026-11-07/container-events.json new file mode 100644 index 00000000..905b6971 --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/container-events.json @@ -0,0 +1,151 @@ +{ + "command": [ + "docker", + "events", + "--since", + "2026-11-06T23:15:45Z", + "--until", + "2026-11-06T23:19:06.697928+00:00", + "--filter", + "type=container", + "--filter", + "label=com.docker.compose.project=mtusi2026lab5", + "--filter", + "event=stop", + "--filter", + "event=die", + "--filter", + "event=start", + "--format", + "{{json .}}" + ], + "events": [ + { + "timeNano": 1794007134212820139, + "id": "4ddcc75182e6044288c7a8c7bddca7b8c5fc6dab9b18c429e61ab1d292680111", + "action": "stop", + "name": "mtusi2026lab5-lb-1", + "exitCode": null + }, + { + "timeNano": 1794007134214724139, + "id": "4ddcc75182e6044288c7a8c7bddca7b8c5fc6dab9b18c429e61ab1d292680111", + "action": "die", + "name": "mtusi2026lab5-lb-1", + "exitCode": "0" + }, + { + "timeNano": 1794007134242785764, + "id": "63225b5eff8e1eb2870376c487b8925f9dbbe9bb8a636f4e2cdc12a24becf577", + "action": "stop", + "name": "mtusi2026lab5-relay-1", + "exitCode": null + }, + { + "timeNano": 1794007134243810347, + "id": "63225b5eff8e1eb2870376c487b8925f9dbbe9bb8a636f4e2cdc12a24becf577", + "action": "die", + "name": "mtusi2026lab5-relay-1", + "exitCode": "0" + }, + { + "timeNano": 1794007134261625889, + "id": "cb275ee9574b376bec77f26bdc24d2149568a272094f374b866d89d42b8067ce", + "action": "stop", + "name": "mtusi2026lab5-worker-1", + "exitCode": null + }, + { + "timeNano": 1794007134263340222, + "id": "cb275ee9574b376bec77f26bdc24d2149568a272094f374b866d89d42b8067ce", + "action": "die", + "name": "mtusi2026lab5-worker-1", + "exitCode": "0" + }, + { + "timeNano": 1794007135530081667, + "id": "be1942ad69b426f8b7c9189b0209021b169c6c8d0ee633f302d6d659a4143377", + "action": "stop", + "name": "mtusi2026lab5-broker-1", + "exitCode": null + }, + { + "timeNano": 1794007135532395875, + "id": "be1942ad69b426f8b7c9189b0209021b169c6c8d0ee633f302d6d659a4143377", + "action": "die", + "name": "mtusi2026lab5-broker-1", + "exitCode": "0" + }, + { + "timeNano": 1794007136578760167, + "id": "d1dcbda238669764840b38a8b9cf22d889ffc356945e165f019c4814bb96553d", + "action": "stop", + "name": "mtusi2026lab5-api-1", + "exitCode": null + }, + { + "timeNano": 1794007136581296250, + "id": "d1dcbda238669764840b38a8b9cf22d889ffc356945e165f019c4814bb96553d", + "action": "die", + "name": "mtusi2026lab5-api-1", + "exitCode": "0" + }, + { + "timeNano": 1794007136606883084, + "id": "1eaf0fe05de650a1c2f7ced3e360aabbf8ad59566f40beefc2d745fa5277688e", + "action": "stop", + "name": "mtusi2026lab5-api-2", + "exitCode": null + }, + { + "timeNano": 1794007136610714375, + "id": "1eaf0fe05de650a1c2f7ced3e360aabbf8ad59566f40beefc2d745fa5277688e", + "action": "die", + "name": "mtusi2026lab5-api-2", + "exitCode": "0" + }, + { + "timeNano": 1794007136730887167, + "id": "647882797ca28a7e07453f00bd198433c80d8a8b8e7013279bc8954eafe11db6", + "action": "stop", + "name": "mtusi2026lab5-valkey-1", + "exitCode": null + }, + { + "timeNano": 1794007136732779084, + "id": "647882797ca28a7e07453f00bd198433c80d8a8b8e7013279bc8954eafe11db6", + "action": "die", + "name": "mtusi2026lab5-valkey-1", + "exitCode": "0" + }, + { + "timeNano": 1794007136795874292, + "id": "a0b9f2742b9737ac0e32423d767438cab12af55a00cc1d68515ca9f07c2758ed", + "action": "stop", + "name": "mtusi2026lab5-postgres-1", + "exitCode": null + }, + { + "timeNano": 1794007136796859125, + "id": "a0b9f2742b9737ac0e32423d767438cab12af55a00cc1d68515ca9f07c2758ed", + "action": "die", + "name": "mtusi2026lab5-postgres-1", + "exitCode": "0" + }, + { + "timeNano": 1794007136819412875, + "id": "29b3e7c3a260f035ba99f5ce5f3e8a8b7077c56377b17e25503f16fb7fbad7c3", + "action": "stop", + "name": "mtusi2026lab5-s3-1", + "exitCode": null + }, + { + "timeNano": 1794007136823326750, + "id": "29b3e7c3a260f035ba99f5ce5f3e8a8b7077c56377b17e25503f16fb7fbad7c3", + "action": "die", + "name": "mtusi2026lab5-s3-1", + "exitCode": "0" + } + ], + "limitation": "Docker retains only the last 256 events; this is a partial retrospective snapshot." +} diff --git a/evidence/final-memory-validation-2026-11-07/down.txt b/evidence/final-memory-validation-2026-11-07/down.txt new file mode 100644 index 00000000..56286008 --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/down.txt @@ -0,0 +1,53 @@ +date: 2026-11-06T23:18:53Z commit: 74c33160ac01618f70e9e1c6a121a5e45c3c7155 +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-memory-validation"} +$ make down +docker compose --profile bench --profile tools --profile reconcile down + Container mtusi2026lab5-relay-1 Stopping + Container mtusi2026lab5-lb-1 Stopping + Container mtusi2026lab5-api-2 Stopping + Container mtusi2026lab5-api-1 Stopping + Container mtusi2026lab5-worker-1 Stopping + Container mtusi2026lab5-lb-1 Stopped + Container mtusi2026lab5-lb-1 Removing + Container mtusi2026lab5-relay-1 Stopped + Container mtusi2026lab5-relay-1 Removing + Container mtusi2026lab5-lb-1 Removed + Container mtusi2026lab5-worker-1 Stopped + Container mtusi2026lab5-worker-1 Removing + Container mtusi2026lab5-relay-1 Removed + Container mtusi2026lab5-worker-1 Removed + Container mtusi2026lab5-broker-1 Stopping + Container mtusi2026lab5-broker-1 Stopped + Container mtusi2026lab5-broker-1 Removing + Container mtusi2026lab5-broker-1 Removed + Container mtusi2026lab5-api-1 Stopped + Container mtusi2026lab5-api-1 Removing + Container mtusi2026lab5-api-2 Stopped + Container mtusi2026lab5-api-2 Removing + Container mtusi2026lab5-api-1 Removed + Container mtusi2026lab5-api-2 Removed + Container mtusi2026lab5-valkey-1 Stopping + Container mtusi2026lab5-migrate-1 Stopping + Container mtusi2026lab5-s3-init-1 Stopping + Container mtusi2026lab5-migrate-1 Stopped + Container mtusi2026lab5-migrate-1 Removing + Container mtusi2026lab5-s3-init-1 Stopped + Container mtusi2026lab5-s3-init-1 Removing + Container mtusi2026lab5-migrate-1 Removed + Container mtusi2026lab5-postgres-1 Stopping + Container mtusi2026lab5-s3-init-1 Removed + Container mtusi2026lab5-s3-1 Stopping + Container mtusi2026lab5-valkey-1 Stopped + Container mtusi2026lab5-valkey-1 Removing + Container mtusi2026lab5-valkey-1 Removed + Container mtusi2026lab5-postgres-1 Stopped + Container mtusi2026lab5-postgres-1 Removing + Container mtusi2026lab5-s3-1 Stopped + Container mtusi2026lab5-s3-1 Removing + Container mtusi2026lab5-postgres-1 Removed + Container mtusi2026lab5-s3-1 Removed + Network mtusi2026lab5_edge Removing + Network mtusi2026lab5_backend Removing + Network mtusi2026lab5_backend Removed + Network mtusi2026lab5_edge Removed +exit_code: 0 elapsed_seconds: 3.356 diff --git a/evidence/final-memory-validation-2026-11-07/env.sh b/evidence/final-memory-validation-2026-11-07/env.sh new file mode 100644 index 00000000..fd5d615d --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/env.sh @@ -0,0 +1,8 @@ +export COMPOSE_PROJECT_NAME=mtusi2026lab5 +export COMPOSE_FILE=compose.yaml +export API_IMAGE=mtusi-messenger:lab5-memory-validation +export LB_HTTP_PORT=18085 +export LB_STATS_PORT=25085 +export BROKER_MANAGEMENT_PORT=25086 +export BASE_URL=http://127.0.0.1:18085 +export NO_PROXY=localhost,127.0.0.1,::1 diff --git a/evidence/final-memory-validation-2026-11-07/final-audit.json b/evidence/final-memory-validation-2026-11-07/final-audit.json new file mode 100644 index 00000000..f7abd6c3 --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/final-audit.json @@ -0,0 +1,100 @@ +{ + "measured_sha": "74c33160ac01618f70e9e1c6a121a5e45c3c7155", + "reviewed_runtime": "6096aa7948b8b666aa3892397a96d044a55f02c6", + "runtime_equal": true, + "normative_equal_to_upstream_main": true, + "changed_paths": [ + "AGENTS.md", + "REPORT.md", + "evidence/README.md", + "evidence/final-memory-validation-2026-11-07/RESULTS.md", + "evidence/final-memory-validation-2026-11-07/active-changes.txt", + "evidence/final-memory-validation-2026-11-07/audit-files.py", + "evidence/final-memory-validation-2026-11-07/audit.json", + "evidence/final-memory-validation-2026-11-07/build.txt", + "evidence/final-memory-validation-2026-11-07/checks.txt", + "evidence/final-memory-validation-2026-11-07/conditions-after.json", + "evidence/final-memory-validation-2026-11-07/conditions.json", + "evidence/final-memory-validation-2026-11-07/container-events.json", + "evidence/final-memory-validation-2026-11-07/down.txt", + "evidence/final-memory-validation-2026-11-07/env.sh", + "evidence/final-memory-validation-2026-11-07/final-audit.json", + "evidence/final-memory-validation-2026-11-07/final-checks.txt", + "evidence/final-memory-validation-2026-11-07/final-containers.txt", + "evidence/final-memory-validation-2026-11-07/findings.json", + "evidence/final-memory-validation-2026-11-07/linux-child.py", + "evidence/final-memory-validation-2026-11-07/linux-runner.py", + "evidence/final-memory-validation-2026-11-07/linux.json", + "evidence/final-memory-validation-2026-11-07/linux.txt", + "evidence/final-memory-validation-2026-11-07/openspec.txt", + "evidence/final-memory-validation-2026-11-07/png-boundary.json", + "evidence/final-memory-validation-2026-11-07/png-boundary.txt", + "evidence/final-memory-validation-2026-11-07/png-http.json", + "evidence/final-memory-validation-2026-11-07/png-http.txt", + "evidence/final-memory-validation-2026-11-07/reset-worker-peak.txt", + "evidence/final-memory-validation-2026-11-07/retained-volumes.txt", + "evidence/final-memory-validation-2026-11-07/running-containers-after.txt", + "evidence/final-memory-validation-2026-11-07/runtime.txt", + "evidence/final-memory-validation-2026-11-07/scan-secrets.py", + "evidence/final-memory-validation-2026-11-07/secret-scan.json", + "evidence/final-memory-validation-2026-11-07/sha256.json", + "evidence/final-memory-validation-2026-11-07/smoke.txt", + "evidence/final-memory-validation-2026-11-07/stopped-containers.txt", + "evidence/final-memory-validation-2026-11-07/student-test.txt", + "evidence/final-memory-validation-2026-11-07/targeted.py", + "evidence/final-memory-validation-2026-11-07/up.txt", + "evidence/load-validation.md" + ], + "local_links_verified": 208, + "tracked_json_parsed": 111, + "previous_and_fix_hashes_verified": 81, + "raw_diff_check_exit": 2, + "preserved_raw_trailing_whitespace_lines": 17, + "docs_and_helpers_diff_check": "PASS", + "accepted_without_rerun": [ + { + "file": "evidence/forward-final-2026-11-06/level4.json", + "source_sha": "0e921116610d289716af0a40ec823376eb8bbcbc", + "scenarios": 17, + "invariants": 8 + }, + { + "file": "evidence/forward-final-2026-11-06/track-run1.json", + "source_sha": "0e921116610d289716af0a40ec823376eb8bbcbc", + "scenarios": 13, + "invariants": 8 + }, + { + "file": "evidence/forward-final-2026-11-06/track-run2.json", + "source_sha": "0e921116610d289716af0a40ec823376eb8bbcbc", + "scenarios": 13, + "invariants": 8 + }, + { + "file": "evidence/forward-final-2026-11-06/track-run3.json", + "source_sha": "0e921116610d289716af0a40ec823376eb8bbcbc", + "scenarios": 13, + "invariants": 8 + }, + { + "file": "evidence/final-validation-2026-11-07/postgres-outage-retry.json", + "source_sha": "b30e2f6a84419d1ca64525ffb40df92183cccaef", + "scenarios": 1, + "invariants": 8 + }, + { + "file": "evidence/final-validation-2026-11-07/delivery-targeted.json", + "source_sha": "b30e2f6a84419d1ca64525ffb40df92183cccaef", + "scenarios": 12, + "invariants": 8 + } + ], + "own_containers": [], + "retained_volumes": [ + "mtusi2026lab5_broker-data", + "mtusi2026lab5_pgdata", + "mtusi2026lab5_s3data", + "mtusi2026lab5_valkeydata" + ], + "result": "PASS" +} diff --git a/evidence/final-memory-validation-2026-11-07/final-checks.txt b/evidence/final-memory-validation-2026-11-07/final-checks.txt new file mode 100644 index 00000000..e7569af6 --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/final-checks.txt @@ -0,0 +1,14 @@ +date: 2026-11-06T23:23:20Z commit: 74c33160ac01618f70e9e1c6a121a5e45c3c7155 +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-memory-validation"} +$ make check validate lint +python3 scripts/check_contract.py +PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. +.venv/bin/python scripts/validate_openapi.py +PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested. +.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 +198 files already formatted +.venv/bin/ty check src student-tests alembic +All checks passed! +exit_code: 0 elapsed_seconds: 0.530 diff --git a/evidence/final-memory-validation-2026-11-07/final-containers.txt b/evidence/final-memory-validation-2026-11-07/final-containers.txt new file mode 100644 index 00000000..09a3967c --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/final-containers.txt @@ -0,0 +1,15 @@ +date: 2026-11-06T23:18:53Z commit: 74c33160ac01618f70e9e1c6a121a5e45c3c7155 +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-memory-validation"} +$ docker compose ps -a --format '{{.Name}} {{.ID}} {{.State}} {{.Status}}' +mtusi2026lab5-api-1 d1dcbda23866 running Up 6 minutes (healthy) +mtusi2026lab5-api-2 1eaf0fe05de6 running Up 6 minutes (healthy) +mtusi2026lab5-broker-1 be1942ad69b4 running Up 6 minutes (healthy) +mtusi2026lab5-lb-1 4ddcc75182e6 running Up 6 minutes (healthy) +mtusi2026lab5-migrate-1 34901a09ef7b exited Exited (0) 6 minutes ago +mtusi2026lab5-postgres-1 a0b9f2742b97 running Up 6 minutes (healthy) +mtusi2026lab5-relay-1 63225b5eff8e running Up 6 minutes (healthy) +mtusi2026lab5-s3-1 29b3e7c3a260 running Up 6 minutes (healthy) +mtusi2026lab5-s3-init-1 6e80e83ed5c5 exited Exited (0) 6 minutes ago +mtusi2026lab5-valkey-1 647882797ca2 running Up 6 minutes (healthy) +mtusi2026lab5-worker-1 cb275ee9574b running Up About a minute (healthy) +exit_code: 0 elapsed_seconds: 0.127 diff --git a/evidence/final-memory-validation-2026-11-07/findings.json b/evidence/final-memory-validation-2026-11-07/findings.json new file mode 100644 index 00000000..5ab9a6e9 --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/findings.json @@ -0,0 +1,37 @@ +[ + { + "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:304", + "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 с). Причина не установлена; длительности исключены из выводов о производительности." + }, + { + "severity": "minor", + "file": "openspec/config.yaml:130", + "problem": "Сохранена документационная неточность: design требует upload 201 вместо нормативного 202 ЛР5; конфиг вне scope validation." + }, + { + "severity": "minor", + "file": "src/messenger/attachments/entrypoints/schemas.py:67", + "problem": "Независимое review M: attempt=\"1\", pipeline_version=true, числовой created_at и traceparent=null принимаются вне jobs.schema.json с bus/ack вместо reject. Штатный relay формирует корректные сообщения; критичного последствия не установлено. Источник: evidence/report-memory-audit-2026-11-07.md; повторные пробы в validation не выполнялись." + } +] diff --git a/evidence/final-memory-validation-2026-11-07/linux-child.py b/evidence/final-memory-validation-2026-11-07/linux-child.py new file mode 100644 index 00000000..68009794 --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/linux-child.py @@ -0,0 +1,58 @@ +import hashlib +import json +import resource +import signal +import sys +import time +from io import BytesIO +from pathlib import Path + +import messenger.worker +from PIL import Image +from messenger.attachments.infrastructure.images import RenderLimits, render_variants + +resource.setrlimit(resource.RLIMIT_AS, (448 << 20, 448 << 20)) +data = Path(sys.argv[1]).read_bytes() +transparent = sys.argv[3] == "true" +limits = RenderLimits(10485760, 40000000) +versions = [] +for version in (1, 2): + signal.alarm(30) + began = time.monotonic() + variants = render_variants(data, limits, version) + ended = time.monotonic() + signal.alarm(0) + assert [(v.name, v.width, v.height) for v in variants] == [ + ("thumbnail", 256, 160), + ("crop", 128, 128), + ("optimized", 1280, 800), + ] + for variant in variants: + with Image.open(BytesIO(variant.data)) as image: + assert (image.getpixel((5, image.height // 2)) == (255, 255, 255)) == transparent + assert image.getpixel((image.width - 6, image.height // 2)) != (255, 255, 255) + versions.append( + { + "version": version, + "started_monotonic": began, + "finished_monotonic": ended, + "render_seconds": ended - began, + "variants": {v.name: hashlib.sha256(v.data).hexdigest() for v in variants}, + } + ) +signal.alarm(30) +assert len(render_variants(Path(sys.argv[2]).read_bytes(), limits)) == 3 +signal.alarm(0) +print( + json.dumps( + { + "file": Path(sys.argv[1]).name, + "input_sha256": hashlib.sha256(data).hexdigest(), + "versions": versions, + "ordinary_after": True, + "max_rss_kib": resource.getrusage(resource.RUSAGE_SELF).ru_maxrss, + "result": "PASS", + } + ), + flush=True, +) diff --git a/evidence/final-memory-validation-2026-11-07/linux-runner.py b/evidence/final-memory-validation-2026-11-07/linux-runner.py new file mode 100644 index 00000000..aa4be944 --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/linux-runner.py @@ -0,0 +1,89 @@ +import base64 +import hashlib +import json +import subprocess +from pathlib import Path + +folder = Path(__file__).parent +fixtures = { + p.name: p.read_bytes() + for p in Path("evidence/final-validation-2026-11-07/fixtures").glob("*.png") +} +data = fixtures["gray16-40mp.png"] +result, offset = data[:8], 8 +while offset < len(data): + size = int.from_bytes(data[offset : offset + 4], "big") + 12 + if data[offset + 4 : offset + 8] != b"tRNS": + result += data[offset : offset + size] + offset += size +fixtures["gray16-opaque-40mp.png"] = result +fixtures["sample.png"] = Path("tests/fixtures/sample.png").read_bytes() +bootstrap = """ +import base64,json,sys,subprocess,time +from pathlib import Path +p=json.load(sys.stdin) +d=Path('/tmp/png-memory-validation') +d.mkdir(exist_ok=True) +for name,data in p['fixtures'].items(): + (d/name).write_bytes(base64.b64decode(data)) +def command(name): + return [sys.executable,'-c',p['code'],str(d/name),str(d/'sample.png'),'false' if 'opaque' in name else 'true'] +results=[] +for name in sorted(p['fixtures']): + if name=='sample.png': + continue + output=subprocess.check_output(command(name),text=True,timeout=65) + row=json.loads(output) + results.append(row) + print(json.dumps({'case':row}),flush=True) +children=[subprocess.Popen(command('rgb16-40mp.png'),stdout=subprocess.PIPE,stderr=subprocess.PIPE,text=True) for _ in range(2)] +parallel=[] +try: + for child in children: + out,err=child.communicate(timeout=65) + assert child.returncode==0,(child.returncode,err) + parallel.append(json.loads(out)) +finally: + for child in children: + if child.poll() is None: + child.kill() + child.wait() +overlap=any(max(a['started_monotonic'],b['started_monotonic']):/]+:[^\s\"\'{}$<>@/]+@", + "secret_literal": r"""["'](?:password|secret|token|access_token|secret_access_key)["']\s*:\s*["'][A-Za-z0-9_+/=-]{24,}["']""", +} +allow = { + ("contracts/examples.json", 5, "secret_literal"): "unchanged skeleton example placeholder", + ("contracts/openapi.json", 3096, "secret_literal"): "unchanged skeleton example placeholder", + ("examples/requests.http", 20, "secret_literal"): "unchanged skeleton example placeholder", + ("scripts/broker-secrets.sh", 17, "credential_url"): "printf format; no credential literal", + ( + "student-tests/api/test_operability.py", + 131, + "credential_url", + ): "synthetic unavailable endpoint u:p", + ( + "student-tests/api/test_operability.py", + 143, + "credential_url", + ): "synthetic unavailable endpoint u:p", + ("student-tests/conftest.py", 141, "credential_url"): "ephemeral test database literal", +} +findings = [] +for name in sorted(files): + if re.search(r"(^|/)(?:\.env|secrets|volumes)(?:/|$)", name): + findings.append({"file": name, "rule": "forbidden_path"}) + try: + text = Path(name).read_text() + except UnicodeDecodeError, OSError: + continue + for rule, pattern in patterns.items(): + for match in re.finditer(pattern, text): + line = text.count("\n", 0, match.start()) + 1 + item = {"file": name, "line": line, "rule": rule} + if (name, line, rule) in allow: + item["reviewed_non_secret"] = allow[name, line, rule] + findings.append(item) +report = { + "files_scanned": len(files), + "patterns": list(patterns), + "candidates": findings, + "unresolved": sum("reviewed_non_secret" not in f for f in findings), +} +Path("evidence/final-memory-validation-2026-11-07/secret-scan.json").write_text( + json.dumps(report, indent=2) + "\n" +) +print(json.dumps(report, indent=2)) +raise SystemExit(bool(report["unresolved"])) diff --git a/evidence/final-memory-validation-2026-11-07/secret-scan.json b/evidence/final-memory-validation-2026-11-07/secret-scan.json new file mode 100644 index 00000000..ee32715b --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/secret-scan.json @@ -0,0 +1,58 @@ +{ + "files_scanned": 804, + "patterns": [ + "private_key", + "github_token", + "openai_token", + "aws_key", + "telegram_token", + "bearer_literal", + "credential_url", + "secret_literal" + ], + "candidates": [ + { + "file": "contracts/examples.json", + "line": 5, + "rule": "secret_literal", + "reviewed_non_secret": "unchanged skeleton example placeholder" + }, + { + "file": "contracts/openapi.json", + "line": 3096, + "rule": "secret_literal", + "reviewed_non_secret": "unchanged skeleton example placeholder" + }, + { + "file": "examples/requests.http", + "line": 20, + "rule": "secret_literal", + "reviewed_non_secret": "unchanged skeleton example placeholder" + }, + { + "file": "scripts/broker-secrets.sh", + "line": 17, + "rule": "credential_url", + "reviewed_non_secret": "printf format; no credential literal" + }, + { + "file": "student-tests/api/test_operability.py", + "line": 131, + "rule": "credential_url", + "reviewed_non_secret": "synthetic unavailable endpoint u:p" + }, + { + "file": "student-tests/api/test_operability.py", + "line": 143, + "rule": "credential_url", + "reviewed_non_secret": "synthetic unavailable endpoint u:p" + }, + { + "file": "student-tests/conftest.py", + "line": 141, + "rule": "credential_url", + "reviewed_non_secret": "ephemeral test database literal" + } + ], + "unresolved": 0 +} diff --git a/evidence/final-memory-validation-2026-11-07/sha256.json b/evidence/final-memory-validation-2026-11-07/sha256.json new file mode 100644 index 00000000..4488bef0 --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/sha256.json @@ -0,0 +1,37 @@ +{ + "evidence/final-memory-validation-2026-11-07/RESULTS.md": "e4dd4dfc47ae8095458028235b1e89373b815edeeceddbd09f116f9ad9f4450b", + "evidence/final-memory-validation-2026-11-07/active-changes.txt": "b817c4f054d652d43cc5b0059aa3808fe18d4a4582a3676c34f0d9418efa992d", + "evidence/final-memory-validation-2026-11-07/audit-files.py": "864e3a7032755da30afeef71431649e87c955cea4dc48021c14575b5ac243ded", + "evidence/final-memory-validation-2026-11-07/audit.json": "68e3f1a5806fe4b65f1e8e8efe0b66c5e55cccd4ce492b7a325d4cc89323ca69", + "evidence/final-memory-validation-2026-11-07/build.txt": "62ca4051248a5ba0c1d5380456dc972572da8c08e27b840992b24f500ab57bb7", + "evidence/final-memory-validation-2026-11-07/checks.txt": "6a1195478b3eb211d21352cb6ed00e690196ccc54e0db3a3fe3ac4e5f6b19336", + "evidence/final-memory-validation-2026-11-07/conditions-after.json": "e72877504561b2e4ab95ffa5ad2e616ff3599ba0887fd10b378f9425cf62376c", + "evidence/final-memory-validation-2026-11-07/conditions.json": "c970c484ad92ada00d33f4df86113928b0ef0321b1b7740441a8c1e10f4b5c30", + "evidence/final-memory-validation-2026-11-07/container-events.json": "bfce3b6295e23ea06f4f29beb1b83b4a5b2ec5e07c4230d3ba68d1dc0c241d39", + "evidence/final-memory-validation-2026-11-07/down.txt": "0b80c02939c9224df3e8f5f98ae6320b6ffc71a8a28c001e7b3ee9ae113a6f39", + "evidence/final-memory-validation-2026-11-07/env.sh": "fa41c289402a362827d3edc88bd0e8301e55d279df09f658f800a94bff96b05d", + "evidence/final-memory-validation-2026-11-07/final-audit.json": "2c6308899417e6da60875de9c262828fe7caccd30bffb223d8ce53635f5845ad", + "evidence/final-memory-validation-2026-11-07/final-checks.txt": "7405e049b92aa01667afe431a64e3c6d5ffc1827c03a4bed480a5158802a08d8", + "evidence/final-memory-validation-2026-11-07/final-containers.txt": "dd5432219d35baeee61392605910c2864b71b83e8972377254eff268670422c5", + "evidence/final-memory-validation-2026-11-07/findings.json": "a2b9cc2a425aa0326fd72c6bdab9a5dc69ea4d90fef2c3ce239fbbb514e978a1", + "evidence/final-memory-validation-2026-11-07/linux-child.py": "c293f49bd273fe7c3c6bb0ac90f2ccb28a02117a4fdae758d04e8c006d4e89ab", + "evidence/final-memory-validation-2026-11-07/linux-runner.py": "680052df464d87d97a9717469d53d27f4f2391f740b0aaa23fa52a77a52c9a83", + "evidence/final-memory-validation-2026-11-07/linux.json": "febd60518391e7d6f479908e48856a6c0a774fd5763f33cf02655e414d6b1fe3", + "evidence/final-memory-validation-2026-11-07/linux.txt": "51f31e560852514bdba1777db1ceade9284ff13610d60afaf7a128f171cd7b29", + "evidence/final-memory-validation-2026-11-07/openspec.txt": "dc82d21ab66012b5960a0f76e82eef10d7df082497119d18efb7aed5009efd3d", + "evidence/final-memory-validation-2026-11-07/png-boundary.json": "a6452fb7b502597058641878464ee383eab334b0d77377bfe54565aeb4279df1", + "evidence/final-memory-validation-2026-11-07/png-boundary.txt": "1aba30dc29b1bae3f7e1d8fb64a7e331effb85fa45a2f3a123ddbe7dd743c6ad", + "evidence/final-memory-validation-2026-11-07/png-http.json": "0dab50ef2d4ed22425d27ccdefaac316ed4b8c7b0a759c2c616eb9239ebba618", + "evidence/final-memory-validation-2026-11-07/png-http.txt": "68ae6e09e67a9df204f0346ebec3b9b185bcf2c67a0a0946aff620408ba867a2", + "evidence/final-memory-validation-2026-11-07/reset-worker-peak.txt": "97c9b5d430649b61f83fb7904414690f50e742b0b53e39c9b4324d60c1b6b2f9", + "evidence/final-memory-validation-2026-11-07/retained-volumes.txt": "27347d997d6f8466d94b0a5bb06350f183c5e30ef9ad2c3858cdc24a316bf5e4", + "evidence/final-memory-validation-2026-11-07/running-containers-after.txt": "44b284098615df613f91d9bc745f236f6ede62f1ea95a9de06e10ed712ffb799", + "evidence/final-memory-validation-2026-11-07/runtime.txt": "1f35a3f37a7e4d4689c8154384b08c9800077d4f77251d576f03921605a28b2e", + "evidence/final-memory-validation-2026-11-07/scan-secrets.py": "27130687bae2d636d9780759559524b347ec3733aa2df722c837378f2d2f39b1", + "evidence/final-memory-validation-2026-11-07/secret-scan.json": "27f7763fd6af6a10d3ddd0c8ae0a3f71dcad4eeb000afa5af5379bb646fb8e30", + "evidence/final-memory-validation-2026-11-07/smoke.txt": "ba0b81113210431ecfe0a085024efd650b4963e1eaf21b2837f6163523a70afc", + "evidence/final-memory-validation-2026-11-07/stopped-containers.txt": "f543710a6a0f639673d62148635409ecec6bea71c8987dc036017d4692505bed", + "evidence/final-memory-validation-2026-11-07/student-test.txt": "1cf669fbca4aee91e87e74089522325f7214ad6406c031013a73c8b935593ac1", + "evidence/final-memory-validation-2026-11-07/targeted.py": "cba7c461fded4eb88247f113a2328780fe985a3c1bdc27a26df47277a2374ffc", + "evidence/final-memory-validation-2026-11-07/up.txt": "1fd736cd42363f734649be3011f92abee46bc9210b4fd513aa2daba9d5f4a666" +} diff --git a/evidence/final-memory-validation-2026-11-07/smoke.txt b/evidence/final-memory-validation-2026-11-07/smoke.txt new file mode 100644 index 00000000..7f1aa6f3 --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/smoke.txt @@ -0,0 +1,6 @@ +date: 2026-11-06T23:15:03Z commit: 74c33160ac01618f70e9e1c6a121a5e45c3c7155 +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-memory-validation"} +$ make test +python3 tests/smoke.py --base-url "http://127.0.0.1:18085" +PASS: lab5 public API scenario; infrastructure and grading evidence remain separate. +exit_code: 0 elapsed_seconds: 1.706 diff --git a/evidence/final-memory-validation-2026-11-07/stopped-containers.txt b/evidence/final-memory-validation-2026-11-07/stopped-containers.txt new file mode 100644 index 00000000..016f7e6f --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/stopped-containers.txt @@ -0,0 +1,4 @@ +date: 2026-11-06T23:19:15Z commit: 74c33160ac01618f70e9e1c6a121a5e45c3c7155 +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-memory-validation"} +$ docker ps -a --filter label=com.docker.compose.project=mtusi2026lab5 --format '{{.Names}} {{.State}}' +exit_code: 0 elapsed_seconds: 0.028 diff --git a/evidence/final-memory-validation-2026-11-07/student-test.txt b/evidence/final-memory-validation-2026-11-07/student-test.txt new file mode 100644 index 00000000..b054ffd8 --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/student-test.txt @@ -0,0 +1,20 @@ +date: 2026-11-06T22:54:40Z commit: 74c33160ac01618f70e9e1c6a121a5e45c3c7155 +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-memory-validation"} +$ make student-test 'PYTEST_ARGS=-q --tb=short' +.venv/bin/pytest -q --tb=short +........................................................................ [ 7%] +........................................................................ [ 14%] +........................................................................ [ 21%] +........................................................................ [ 29%] +........................................................................ [ 36%] +........................................................................ [ 43%] +........................................................................ [ 51%] +........................................................................ [ 58%] +........................................................................ [ 65%] +........................................................................ [ 73%] +........................................s............................... [ 80%] +........................................................................ [ 87%] +......................................................................s. [ 94%] +.................................................. [100%] +984 passed, 2 skipped, 19 deselected in 171.26s (0:02:51) +exit_code: 0 elapsed_seconds: 172.902 diff --git a/evidence/final-memory-validation-2026-11-07/targeted.py b/evidence/final-memory-validation-2026-11-07/targeted.py new file mode 100644 index 00000000..f723b2d4 --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/targeted.py @@ -0,0 +1,310 @@ +import hashlib +import json +import os +import struct +import sys +import time +from io import BytesIO +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[2] +sys.path[:0] = [str(ROOT / "scripts"), str(ROOT / "student-tests")] +import pipeline_suite as ps +from PIL import Image +from messenger.attachments.infrastructure.images import RenderLimits, render_variants +from png_trns_fixtures import png_with_trns + +MODE = sys.argv.pop(1) +OUT = Path(__file__).parent / (MODE + ".json") +if OUT.exists(): + raise SystemExit("Result exists; do not repeat completed evidence") +SUITE = ps.Suite(ps.arguments()) +STACK = SUITE.stack +REPORT = { + "mode": MODE, + "source_sha": ps.run(["git", "rev-parse", "HEAD"]).strip(), + "started_at": ps.now(), + "cases": [], +} +LIMITS = RenderLimits(10485760, 40000000) + + +def save(): + REPORT["accepted_ids"] = SUITE.api.accepted if SUITE.api else [] + OUT.write_text(json.dumps(REPORT, ensure_ascii=False, indent=2) + "\n") + + +def case(name, function): + row = {"name": name, "started_at": ps.now()} + REPORT["cases"].append(row) + save() + began = time.monotonic() + try: + row["observed"] = function() + row["result"] = "PASS" + except Exception as error: + row.update(result="FAIL", error=str(error)) + row["elapsed_seconds"] = round(time.monotonic() - began, 3) + save() + print(name, row["result"], row.get("error", ""), flush=True) + + +def containers(): + return STACK.dc("ps", "-a", "--format", "{{.Name}} {{.ID}} {{.State}} {{.Status}}").splitlines() + + +def png(name, data, reference): + att = SUITE.api.upload(data, name=name + ".png") + ident = att["id"] + results = [] + for version in (1, 2): + if version == 2: + STACK.admin("reprocess", "--attachment-id", ident, "--pipeline-version", "2") + ps.poll(lambda: SUITE.record(ident)["published_version"] == 2, 90, "published v2") + ready = SUITE.api.wait(ident) + SUITE.verify(ready) + assert SUITE.api.content(ident)["bytes"] == data + expected = {r.name: r for r in render_variants(reference, LIMITS, version)} + variants = [] + for variant in ready["variants"]: + content = SUITE.api.content(ident, variant["name"])["bytes"] + assert content == expected[variant["name"]].data, ( + variant["name"] + " differs from independent white reference" + ) + with Image.open(BytesIO(content)) as image: + assert not image.getexif() + assert not any(key in image.info for key in ("icc_profile", "xmp", "transparency")) + variants.append( + { + "name": variant["name"], + "sha256": hashlib.sha256(content).hexdigest(), + "bytes": len(content), + "dimensions": [variant["width"], variant["height"]], + } + ) + results.append({"version": version, "variants": variants}) + before = SUITE.snapshot(ident) + STACK.publish(SUITE.payload(ident, 1)) + STACK.publish(SUITE.payload(ident, 2)) + SUITE.drained() + assert SUITE.snapshot(ident) == before + assert len(STACK.sql("variants", id=ident)) == 6 + return { + "attachment_id": ident, + "input_sha256": hashlib.sha256(data).hexdigest(), + "input_bytes": len(data), + "versions": results, + "stale_and_duplicate_noop": True, + } + + +FIXTURES = ROOT / "evidence/final-validation-2026-11-07/fixtures" +ps.SQL["timed_events"] = ( + "SELECT attachment_id,job_id,kind,at FROM job_events WHERE attachment_id = ANY(:'ids'::uuid[]) AND kind IN ('claimed','done') ORDER BY id" +) + + +def without_trns(data): + result, offset = data[:8], 8 + while offset < len(data): + size = struct.unpack(">I", data[offset : offset + 4])[0] + 12 + if data[offset + 4 : offset + 8] != b"tRNS": + result += data[offset : offset + size] + offset += size + return result + + +def verify_large(ident, data, transparent): + ready = SUITE.api.wait(ident) + SUITE.verify(ready) + assert SUITE.api.content(ident)["bytes"] == data + variants = [] + for variant in ready["variants"]: + content = SUITE.api.content(ident, variant["name"])["bytes"] + with Image.open(BytesIO(content)) as image: + left = image.getpixel((5, image.height // 2)) + right = image.getpixel((image.width - 6, image.height // 2)) + assert (left == (255, 255, 255)) == transparent + assert right != (255, 255, 255) + assert not image.getexif() + variants.append({**variant, "left_pixel": left, "right_pixel": right}) + return variants + + +def duplicate_check(ident): + before = SUITE.snapshot(ident) + STACK.publish(SUITE.payload(ident, 1)) + STACK.publish(SUITE.payload(ident, 2)) + SUITE.drained() + assert SUITE.snapshot(ident) == before + assert len(STACK.sql("variants", id=ident)) == 6 + + +def large(name, data, transparent=True): + att = SUITE.api.upload(data, name=name + ".png") + ident = att["id"] + versions = [{"version": 1, "variants": verify_large(ident, data, transparent)}] + STACK.admin("reprocess", "--attachment-id", ident, "--pipeline-version", "2") + ps.poll(lambda: SUITE.record(ident)["published_version"] == 2, 90, "v2 publication") + versions.append({"version": 2, "variants": verify_large(ident, data, transparent)}) + duplicate_check(ident) + return { + "attachment_id": ident, + "input_sha256": hashlib.sha256(data).hexdigest(), + "bytes": len(data), + "versions": versions, + "memory_peak": int(STACK.cgroup("worker", "memory.peak")), + "memory_max": int(STACK.cgroup("worker", "memory.max")), + } + + +def concurrent(): + data = (FIXTURES / "rgb16-40mp.png").read_bytes() + SUITE.drained() + STACK.stop("worker") + try: + ids = [SUITE.api.upload(data, name="concurrent-rgb16.png")["id"] for _ in range(2)] + SUITE.queued(2) + finally: + ps.run(["docker", "start", STACK.dc("ps", "-aq", "worker").strip()]) + versions = [] + for version in (1, 2): + if version == 2: + STACK.stop("worker") + try: + for ident in ids: + STACK.admin("reprocess", "--attachment-id", ident, "--pipeline-version", "2") + SUITE.queued(2) + finally: + ps.run(["docker", "start", STACK.dc("ps", "-aq", "worker").strip()]) + for ident in ids: + ps.poll( + lambda: SUITE.record(ident)["published_version"] == version, + 90, + "concurrent publication", + ) + variants = {ident: verify_large(ident, data, True) for ident in ids} + events = STACK.sql("timed_events", ids="{" + ",".join(ids) + "}") + job_ids = { + row["job_id"] + for ident in ids + for row in STACK.sql("jobs", id=ident) + if row["pipeline_version"] == version + } + selected = [e for e in events if e["job_id"] in job_ids] + claims = [e["at"] for e in selected if e["kind"] == "claimed"] + done = [e["at"] for e in selected if e["kind"] == "done"] + assert len(claims) == len(done) == 2 + assert max(claims) < min(done), selected + versions.append( + { + "version": version, + "events": selected, + "processing_overlapped": True, + "variants": variants, + } + ) + for ident in ids: + duplicate_check(ident) + peak, limit = (int(STACK.cgroup("worker", name)) for name in ("memory.peak", "memory.max")) + assert peak < limit + return { + "attachment_ids": ids, + "versions": versions, + "memory_peak": peak, + "memory_max": limit, + "memory_events": STACK.cgroup("worker", "memory.events"), + } + + +def forced(name, **overrides): + data = (FIXTURES / "rgb16-40mp.png").read_bytes() + result = SUITE.limited(data, **overrides) + STACK.restore() + result["next_normal"] = SUITE.smoke_pipeline() + return result + + +try: + SUITE.detect_api() + SUITE.api = ps.Api(SUITE.args) + dead_before = STACK.queues()[ps.DLQ][0] + REPORT["conditions"] = { + "host_load": os.getloadavg(), + "containers": containers(), + "running": ps.run(["docker", "ps", "--format", "{{.Names}} {{.Status}}"]), + "worker_limits": STACK.dc( + "exec", + "-T", + "worker", + "printenv", + "RENDER_MEMORY_MB", + "RENDER_TIMEOUT_SECONDS", + "WORKER_CONCURRENCY", + ), + } + save() + if MODE == "png-http": + folder = ROOT / "evidence/review-trns-depth-2026-11-06/fixtures" + for name in ("gray2", "gray4", "rgb16"): + case( + name, + lambda name=name: png( + name, + (folder / (name + ".png")).read_bytes(), + (folder / (name + "-white.png")).read_bytes(), + ), + ) + for name, depth, color in [ + ("gray1", 1, (0,)), + ("gray8", 8, (85,)), + ("gray16", 16, (12345,)), + ("rgb8", 8, (255, 0, 0)), + ]: + case( + name, + lambda name=name, depth=depth, color=color: png(name, *png_with_trns(depth, color)), + ) + case( + "rgb16-adam7-filter4-exif6", + lambda: png( + "adam7", + *png_with_trns( + 16, + (12345, 23456, 34567), + size=(65, 63), + interlace=1, + filtering=4, + orientation=6, + ), + ), + ) + elif MODE == "png-boundary": + for name in ("gray2", "gray4", "gray16", "rgb16"): + case( + name, lambda name=name: large(name, (FIXTURES / (name + "-40mp.png")).read_bytes()) + ) + case( + "gray16-without-trns", + lambda: large( + "gray16-opaque", without_trns((FIXTURES / "gray16-40mp.png").read_bytes()), False + ), + ) + case("concurrent-rgb16", concurrent) + case("forced-timeout", lambda: forced("timeout", FAULT_RENDER_TIMEOUT_SECONDS="0.01")) + case("forced-memory", lambda: forced("memory", FAULT_RENDER_MEMORY_MB="200")) + ids = "{" + ",".join(SUITE.api.accepted) + "}" + ps.poll(lambda: not STACK.sql("staging_left", ids=ids), 45, "staging sweep") + SUITE.drained() + REPORT["invariants"] = SUITE.invariants(dead_before) +finally: + STACK.restore() + REPORT["finished_at"] = ps.now() + REPORT["result"] = ( + "PASS" + if REPORT["cases"] + and all(x.get("result") == "PASS" for x in REPORT["cases"] + REPORT.get("invariants", [])) + else "FAIL" + ) + save() +raise SystemExit(0 if REPORT["result"] == "PASS" else 1) diff --git a/evidence/final-memory-validation-2026-11-07/up.txt b/evidence/final-memory-validation-2026-11-07/up.txt new file mode 100644 index 00000000..ceeef497 --- /dev/null +++ b/evidence/final-memory-validation-2026-11-07/up.txt @@ -0,0 +1,94 @@ +date: 2026-11-06T23:12:23Z commit: 74c33160ac01618f70e9e1c6a121a5e45c3c7155 +environment: {"COMPOSE_PROJECT_NAME": "mtusi2026lab5", "COMPOSE_FILE": "compose.yaml", "LB_HTTP_PORT": "18085", "LB_STATS_PORT": "25085", "BASE_URL": "http://127.0.0.1:18085", "NO_PROXY": "localhost,127.0.0.1,::1", "API_IMAGE": "mtusi-messenger:lab5-memory-validation"} +$ docker compose up -d --wait + Network mtusi2026lab5_backend Creating + Network mtusi2026lab5_backend Created + Network mtusi2026lab5_edge Creating + Network mtusi2026lab5_edge Created + Container mtusi2026lab5-valkey-1 Creating + Container mtusi2026lab5-broker-1 Creating + Container mtusi2026lab5-lb-1 Creating + Container mtusi2026lab5-postgres-1 Creating + Container mtusi2026lab5-s3-1 Creating + Container mtusi2026lab5-s3-1 Created + Container mtusi2026lab5-valkey-1 Created + Container mtusi2026lab5-s3-init-1 Creating + Container mtusi2026lab5-lb-1 Created + Container mtusi2026lab5-broker-1 Created + Container mtusi2026lab5-postgres-1 Created + Container mtusi2026lab5-migrate-1 Creating + Container mtusi2026lab5-s3-init-1 Created + Container mtusi2026lab5-migrate-1 Created + Container mtusi2026lab5-api-2 Creating + Container mtusi2026lab5-worker-1 Creating + Container mtusi2026lab5-api-1 Creating + Container mtusi2026lab5-relay-1 Creating + Container mtusi2026lab5-api-2 Created + Container mtusi2026lab5-relay-1 Created + Container mtusi2026lab5-api-1 Created + Container mtusi2026lab5-worker-1 Created + Container mtusi2026lab5-broker-1 Starting + Container mtusi2026lab5-valkey-1 Starting + Container mtusi2026lab5-postgres-1 Starting + Container mtusi2026lab5-s3-1 Starting + Container mtusi2026lab5-lb-1 Starting + Container mtusi2026lab5-s3-1 Started + Container mtusi2026lab5-s3-1 Waiting + Container mtusi2026lab5-postgres-1 Started + Container mtusi2026lab5-postgres-1 Waiting + Container mtusi2026lab5-valkey-1 Started + Container mtusi2026lab5-broker-1 Started + Container mtusi2026lab5-lb-1 Started + Container mtusi2026lab5-postgres-1 Healthy + Container mtusi2026lab5-migrate-1 Starting + Container mtusi2026lab5-migrate-1 Started + Container mtusi2026lab5-s3-1 Healthy + Container mtusi2026lab5-s3-init-1 Starting + Container mtusi2026lab5-s3-init-1 Started + Container mtusi2026lab5-s3-init-1 Waiting + Container mtusi2026lab5-migrate-1 Waiting + Container mtusi2026lab5-broker-1 Waiting + Container mtusi2026lab5-migrate-1 Waiting + Container mtusi2026lab5-s3-init-1 Waiting + Container mtusi2026lab5-broker-1 Waiting + Container mtusi2026lab5-migrate-1 Waiting + Container mtusi2026lab5-s3-init-1 Waiting + Container mtusi2026lab5-s3-init-1 Exited + Container mtusi2026lab5-migrate-1 Exited + Container mtusi2026lab5-s3-init-1 Exited + Container mtusi2026lab5-s3-init-1 Exited + Container mtusi2026lab5-migrate-1 Exited + Container mtusi2026lab5-migrate-1 Exited + Container mtusi2026lab5-api-1 Starting + Container mtusi2026lab5-broker-1 Healthy + Container mtusi2026lab5-relay-1 Starting + Container mtusi2026lab5-broker-1 Healthy + Container mtusi2026lab5-worker-1 Starting + Container mtusi2026lab5-api-1 Started + Container mtusi2026lab5-api-2 Starting + Container mtusi2026lab5-worker-1 Started + Container mtusi2026lab5-relay-1 Started + Container mtusi2026lab5-api-2 Started + Container mtusi2026lab5-relay-1 Waiting + Container mtusi2026lab5-postgres-1 Waiting + Container mtusi2026lab5-migrate-1 Waiting + Container mtusi2026lab5-s3-1 Waiting + Container mtusi2026lab5-lb-1 Waiting + Container mtusi2026lab5-worker-1 Waiting + Container mtusi2026lab5-broker-1 Waiting + Container mtusi2026lab5-valkey-1 Waiting + Container mtusi2026lab5-s3-init-1 Waiting + Container mtusi2026lab5-api-1 Waiting + Container mtusi2026lab5-api-2 Waiting + Container mtusi2026lab5-migrate-1 Exited + Container mtusi2026lab5-s3-1 Healthy + Container mtusi2026lab5-s3-init-1 Exited + Container mtusi2026lab5-broker-1 Healthy + Container mtusi2026lab5-postgres-1 Healthy + Container mtusi2026lab5-valkey-1 Healthy + Container mtusi2026lab5-api-1 Healthy + Container mtusi2026lab5-api-2 Healthy + Container mtusi2026lab5-worker-1 Healthy + Container mtusi2026lab5-relay-1 Healthy + Container mtusi2026lab5-lb-1 Healthy +exit_code: 0 elapsed_seconds: 11.284 diff --git a/evidence/load-validation.md b/evidence/load-validation.md index 67d7b22a..86925245 100644 --- a/evidence/load-validation.md +++ b/evidence/load-validation.md @@ -1,5 +1,17 @@ # Аудит применимости измерений ЛР5 +## Продолжение после исправления памяти + +Измеренный HEAD `74c33160ac01618f70e9e1c6a121a5e45c3c7155` содержит reviewed runtime M `6096aa7948b8b666aa3892397a96d044a55f02c6`. От предыдущей validation изменён только images.py; Compose, ресурсы, зависимости, dataset, API, SQL/outbox/lease/fencing и broker не менялись. Проверены 53 хеша прежних артефактов. Подробности — [audit.json](final-memory-validation-2026-11-07/audit.json). + +Принимаются три повтора track2 на D, PostgreSQL outage и 12 delivery-сценариев на V: повтор не нужен. Побайтная совместимость sample и 22 изображений подтверждена 132 вариантами в исправлении M. Прежний PNG HTTP PASS не переносится на M, а четыре граничных FAIL остаются историческими. + +Выполнены только затронутые проверки: Linux 448 MiB/30 с с импортами worker (четыре прежних 40 Мп tRNS и grayscale16 без tRNS, v1/v2); HTTP тех же PNG и одновременных jobs при concurrency=2; прежние 8 PNG/48 сравнений; принудительные лимиты и обычное задание после каждого отказа; cleanup после sweep. Полный student-test повторён из-за нового renderer и тестов, это не повтор нагрузочной матрицы. Новые SLO не вводятся. + +Новые результаты — `final-memory-validation-2026-11-07/`; старые файлы не перезаписываются. Статус: **validation PASS, прежний major закрыт динамически**. Пять граничных PNG × v1/v2 прошли Linux/HTTP; concurrency=2 без OOM; 8 малых PNG / 48 сравнений PASS. Обе HTTP-серии: по 8 сценариев и 8 инвариантов, 19 ID / 115 объектов. Student-test: 984 passed / 2 Linux-only skips, покрытых отдельным Linux-пробником. Свой стенд остановлен, четыре volumes сохранены. [Итог и команды](final-memory-validation-2026-11-07/RESULTS.md). Семь minor сохранены; публикация требует отдельной фазы. + +## Исторический аудит первой validation + Фаза validation, 2026-11-07. Исходный HEAD `b30e2f6a84419d1ca64525ffb40df92183cccaef`, runtime прошёл review на `42575281b352d35bda17ee7601bae5548a996e91` (R). Diff R → HEAD содержит только REPORT, AGENTS и два документа evidence. Реализация в этой фазе не меняется; push запрещён. Выбран трек 2 README — идемпотентность pipeline. Матрица throughput/prefetch и SLO относятся к невыбранному треку 1; новые SLO не вводятся. -- 2.54.0