Document verified lab 5 grades and archive the versioned pipeline

This commit is contained in:
Artyom
2026-11-06 12:11:44 +03:00
parent 9ba3076fa8
commit f88e9ba43c
94 changed files with 13926 additions and 4 deletions
@@ -1,2 +1,4 @@
schema: spec-driven
created: 2026-11-06
archived: 2026-11-06
lab: 5
@@ -32,3 +32,7 @@ PostgreSQL — источник истины, RabbitMQ с FastStream/aio-pika
Регрессия воспроизводится в чистом процессе с графом импортов worker: первый UPDATE ORM в этом графе импортов возвращает UUID job_id как attempt; INSERT job_events затем падает с SQLSTATE 22000. Все UPDATE jobs используют SQLAlchemy Core table, без ORM synchronize_session и дополнительного RETURNING PK. Схема/данные не меняются. Регрессионный тест запускает два конкурентных claim в отдельных холодных процессах с разными hash seeds; исходный вариант падает, исправленный обязан пройти. В журнале остаётся только класс ошибки и SQLSTATE, без параметров.
Третий повтор verified-run3.json обнаружил гонку уборки staging и старого worker: v2 готова, v1 получила ObjectMissingError вместо superseded. Это критичный провал обязательного reorder; прежние два PASS не считаются завершённой серией. Регрессия задерживает держателя до/после side effect, публикует v2, запускает cleanup и требует сохранить staging до окончания активного держателя. После исправления повторяются локальные, публичные проверки, уровень 4 и три новые серии.
## Проверенный результат
Финальный код 9ba3076fa8ba707de932e053fc22f455d83b3210: 508 собственных тестов PASS, 1 macOS RLIMIT_AS skip компенсирован Linux worker_limits; публичные smoke/persistence/failover PASS; полный level4 17/17 и 8 инвариантов; track2 три пригодных повтора 13/13 и 8 инвариантов каждый, 39 IDs/174 объекта. Сводка — qualified/RESULTS.md и summary.json в evidence/sqlalchemy-2026-11-06/track2. Прерванный инфраструктурой третий запуск исключён и повторён без повторения пригодных серий. Docker общий, фон описан в evidence; времена не являются изолированным benchmark. Свой project остановлен без удаления четырёх volumes. На защите демонстрируются queued при остановленном worker, crash COMMIT→ack и v2→v1 с неизменным опубликованным снимком.
@@ -7,9 +7,13 @@
- [x] 2.2 Добавить recipe v1/v2 и передачу версии в отдельный render process.
- [x] 2.3 Связать операторский CLI, аудит и DI; проверить конкурентность, reorder, старого держателя и ошибки собственными тестами.
- [x] 2.4 Исправить доказанные критичные cold claim и cleanup race; подтвердить регрессиями до/после и финальной серией на 9ba3076.
## 3. Доказательства
- [x] 3.1 Усилить suite: принудительное v2→v1, snapshots/hashes, scoped S3 inventory, фактический SIGKILL; make track2.
- [ ] 3.2 make check/validate/lint/student-test, сборка и публичные smoke/persistence/failover/restore на финальном коде.
- [ ] 3.3 Полный level4 на финальном коде и три последовательных track2 с сырыми результатами.
- [ ] 3.4 Сохранить методику/гипотезу/сравнение/ограничения, синхронизировать specs, архивировать завершённый change после make lint.
- [ ] 3.5 Остановить свои стенды без удаления volumes и завершить с чистым деревом.
- [x] 3.2 make check/validate/lint/student-test, сборка и публичные smoke/persistence/failover/restore на финальном коде.
- [x] 3.3 Полный level4 на финальном коде и три последовательных track2 с сырыми результатами.
- [x] 3.4 Сохранить методику/гипотезу/сравнение/ограничения, синхронизировать specs, архивировать завершённый change после make lint.
- [x] 3.5 Остановить свои стенды без удаления volumes и завершить с чистым деревом.
Финальные доказательства: evidence/sqlalchemy-2026-11-06/track2/qualified/RESULTS.md, summary.json, run1.json, run2.json, run3-retry.json, level4.json, shutdown.json. Interrupted run3.json исключён; его 10 IDs восстановились без manual replay. Код проверок: 9ba3076fa8ba707de932e053fc22f455d83b3210. Финальный коммит архивирует только спецификацию/результаты; код после квалификации не менялся.
@@ -0,0 +1,51 @@
# lab5-versioned-pipeline Specification
## Purpose
Определяет наблюдаемые гарантии versioned pipeline и воспроизводимое доказательство идемпотентности для трека 2 оценки «5» README лабораторной 5.
## Requirements
### Requirement: Явная постановка версии
Оператор SHALL иметь команду reprocess с attachment-id и pipeline-version 1 или 2. Повтор той же версии SHALL возвращать noop без новой job или outbox. Для неизвестного вложения возвращается not_found, для pending/failed — conflict без изменения состояния; failed восстанавливается существующим replay. Успех queued SHALL означать durable job и outbox. Требование трассируется на README, трек 2.
#### Scenario: Одновременные операторские запросы
- **WHEN** несколько команд запрашивают версию 2 одного вложения
- **THEN** ровно одна получает queued, остальные noop; создаётся одна job версии 2 и одно намерение доставки
#### Scenario: Ошибочный запрос
- **WHEN** указана неподдерживаемая версия, неизвестный id или failed-вложение
- **THEN** новая работа не создаётся, оператор получает явную ошибку/результат отказа
### Requirement: Монотонная публикация различимых версий
Версии 1 и 2 SHALL давать детерминированные варианты с различимыми recipe при сохранении форматов/размеров контракта. API SHALL отдавать только опубликованную версию, published_version SHALL возрастать, а ready SHALL NOT откатываться. Работа или ошибка старой версии SHALL NOT перезаписывать новую. Ошибка одной версии SHALL NOT завершать всё вложение в failed, пока остаётся активная версия. Требование трассируется на README, трек 2 и contracts/attachment-states.md.
#### Scenario: Новая версия завершилась первой
- **WHEN** версия 2 достигла ready до доставки версии 1
- **THEN** последующая версия 1 не меняет опубликованные варианты; оригинал и байты версии 2 сохраняются
#### Scenario: Старый держатель завершился позже
- **WHEN** worker версии 1 задержан после записи объектов, а версия 2 опубликована
- **THEN** завершение версии 1 не перезаписывает опубликованный результат версии 2
#### Scenario: Уборка при активной версии
- **WHEN** новая версия уже готова, а старый worker задержан до или после side effect и запускается очистка staging
- **THEN** исходник активного worker сохраняется до его завершения; последующая обработка ready-вложения использует устойчивый опубликованный оригинал и не зависит от незавершённой уборки
#### Scenario: Ошибка при нескольких версиях
- **WHEN** одна версия завершилась ошибкой, другая ещё обрабатывается
- **THEN** вложение не становится failed до завершения оставшейся работы, а уже ready продолжает скачиваться
### Requirement: Воспроизводимые инварианты при отказах
Одна команда make track2 SHALL запускать контроль без отказа и автоматические duplicate, reorder, crash до/после эффекта, SIGKILL и stale job после версии 2. Результат SHALL включать UTC/SHA, фактические контейнеры, отсутствие потери подтверждённых 202, лишних эффектов и отката ready/версии, соответствие байтов метаданным и объектов собственных вложений ожидаемым ключам. Исследование SHALL содержать три последовательных повтора, сравнение, ограничения и объяснение at-least-once доставки. Требование трассируется на README, трек 2; унаследованные негативные сценарии остаются в спецификациях уровней 3/4.
#### Scenario: Повтор после эффекта
- **WHEN** worker падает после PUT либо после COMMIT до ack и получает ту же job снова
- **THEN** итоговое вложение доступно, лишнего набора вариантов нет, принятая job не потеряна
#### Scenario: Проверяемая серия
- **WHEN** три раза последовательно выполняется make track2 с разными output paths
- **THEN** каждый отчёт проверяет собственные принятые IDs, содержит реальные результаты и не удаляет данные предыдущих прогонов