37 KiB
Tasks
Как строить — design.md (дальше «решение N»). Что должно получиться —
дельты specs/graceful-shutdown, specs/student-tests и
specs/load-benchmark. Номера коммитов — таблица решения 14.
Правила.
-
Правила слоёв. Перед первым файлом слоя — Read его правила (и одного файла из каталога, чтобы правило подгрузилось):
Что правим Правила bench/.claude/rules/bench.mdstudent-tests/student-tests.md,api-contract.mdsrc/infra/,src/main.py,src/__main__.pyinfra.md,logging.md,run-modes.md,api-layer.md,docker.mdscripts/rolling-update.shbalancer.md.claude/skills/run-mtusi-messenger/driver.pySKILL.mdтого же каталога -
Только Edit и Write. Файлы меняются только ими: не sed, не heredoc, не
python -c(глобальное правило пользователя). Перед правкой — Read файла. Запускатьuv run python -c …иpython3 -c …для проверок можно. -
Коммиты — без подтверждения (бриф основной сессии). Английский conventional style, сообщения — таблица решения 14, последняя строка
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>. Push, checkout, reset, stash, rebase нельзя;git revertв задаче 3.6 — можно. -
Стенды. Удалять и пересоздавать можно
mtusi-lab3(рабочий),mtusi-benchиmtusi-lab3-failures. Чужие проекты (mtusi-lab2и другие) не трогать. -
Упавший тест или прогон — сначала разбор и названная причина, потом правка (AGENTS.md). Правка кода — новый commit и повтор проверки.
-
Журнал этапа —
<scratchpad>/fix-known-issues/journal.md(scratchpad сессии apply): хэши, ключевые строки выводов, заметки для «Найдено в apply». Отметки задач до 8.8 тоже ведутся там: паспорт метокbench/пишетgit.dirty, и перед каждымmake bench_*git status --porcelainдолжен быть пуст. В файлы change отметки переносятся в 8.8. -
REPORT.mdможет править основная сессия. Перед каждой правкой — свежий Read. Чужие изменения не откатывать и от своего имени не коммитить: спросить основную сессию. -
Долгие команды — всё дольше пары минут — фоном, журнал в
<scratchpad>/fix-known-issues/<имя>.log:nohup make <цель> > <scratchpad>/fix-known-issues/<имя>.log 2>&1 &Ожидание — циклом (
until ! pgrep -f "[b]ench/run.py" >/dev/null; do sleep 15; done, Bash сrun_in_backgroundили Monitor), не дольше 30 мин на вызов. Ни один вызов инструмента не должен упереться в 10 минут. -
Проверка хоста — перед каждым прогоном
bench/(3.4, 3.5, 3.7, 7.8) и перед замерамиstop-at-start(5.2, 5.9). Вывод — в журнал:pmset -g batt | head -1—AC Power;memory_pressure | tail -1— давления нет, свободной памяти хватает на ВМ 7,7 GiB (ориентир прежних замеров — 50 % и больше);- для
bench/:make stop, затемdocker ps --format '{{.Names}}'— пусто; LC_ALL=C sysctl -n vm.loadavg— второе число (5 мин) < 8;pgrep -x zoom.us— пусто;vm_stat | grep Swapouts— до прогона и после.
Плохо хоть одно — прогон не запускать: остановиться и вернуть отчёт основной сессии с выводом команды.
-
Секреты. В evidence и журнале нет токенов, паролей, хэшей целиком,
.envи абсолютных путей домашнего каталога (evidence/README.md). -
Уведомления в Telegram — только если их поручает бриф apply, через скилл
telegram-send.
1. Подготовка
- 1.1 Исходное состояние:
git status --porcelainпуст;git log --oneline -1— commitdocs: propose fix-known-issues change. Его хэш —BASEв журнале;docker compose ps— пять контейнеровmtusi-lab3healthy,make lb_stats— обе репликиUP. Иначе —make run_docker.
- 1.2 Read правил из таблицы «Правила слоёв» и по одному файлу из
каждого затрагиваемого каталога:
bench/run.py,student-tests/run_failures.py,src/main.py,src/infra/logger.py,scripts/rolling-update.sh,.claude/skills/run-mtusi-messenger/driver.py. Проверка: список прочитанного — в журнале.
2. Паспорт метки — swapouts_delta (запись 5, решение 13)
-
2.1
bench/run.py:- функция
swapouts_delta(start, end) -> int | Noneрядом соswap_warning, с докстрингом:None, если одного счётчика нет; иначе разность, в том числе 0; swap_warningсчитает через неё, тексты предупреждений прежние;- конец
main()пишетmeta["host_state"]["swapouts_delta"], когда значение неNone; - код ячеек серий (
host_swapouts) не трогать.
Проверка:
git diff --stat— толькоbench/run.py. - функция
-
2.2 Самопроверка, вывод — в журнал:
uv run python -c "import sys; sys.path.insert(0, 'bench'); import run; d, w = run.swapouts_delta, run.swap_warning; assert d({'swapouts': 0}, {'swapouts': 0}) == 0; assert d({'swapouts': None}, {'swapouts': 3}) is None; assert d({'swapouts': 5}, {'swapouts': None}) is None; assert d({'swapouts': 5}, {'swapouts': 9}) == 4; assert w({'swapouts': 0}, {'swapouts': 0}) is None; assert w({'swapouts': 5}, {'swapouts': 9}) == 'host swapped out 4 pages during the run: rerun'; print('swapouts ok')"Ожидается
swapouts ok. Затемmake lint— код 0, других файлов он не меняет. -
2.3 Commit 1. Проверка:
git status --porcelainпуст.
3. События фазы failover — поток (запись 3, решения 9, 10)
-
3.1
bench/run.py(решение 9):- метод
Stand.container_events(container, path)— потокdocker eventsпо контейнеру в файл, тот же фильтр и формат, что у прежнегоStand.events; докстринг — почему поток (буфер демона, 256 событий); run_phase: поток — вwork_dir/<фаза>-events.log, запуск после выбора цели и доk6_console, остановкаterminate+waitпослеwait_readyпосле фазы, вfinally. События —failover.parse_eventsэтого файла, выбор действия и возврата прежний;- прежний
Stand.eventsудалить.
Проверка:
grep -n "def events\|stand.events(" bench/run.py— пусто;grep -n "container_events" bench/run.py— определение и вызов;- сообщение
docker events of … not foundосталось (сценарий «Событие не получено»); uv run python bench/scaling.py --selftestиuv run python bench/resources.py --selftest—selftest ok;make lint— код 0.
- метод
-
3.2 Commit 2. Проверка: дерево чистое, хэш — в журнал.
-
3.3 Временная сверка (решение 10):
- в
bench/run.py— метод запроса к буферу демона: копия прежнегоStand.eventsпод именемevents_from_buffer; - в
run_phaseпосле событий из потока — тот же разбор по буферу за окноstarted - 5…ended + 1:- TimeNano действия и возврата равны —
self.say«cross-check: stream = buffer», оба момента; - в буфере их нет — «cross-check: buffer lost the events»;
- различаются —
BenchError.
- TimeNano действия и возврата равны —
make lint, commit 3. Хэш — в журнал. - в
-
3.4 Прогон 1 без помех: проверка хоста (с
make stop), затемnohup make bench_failover_quick > <scratchpad>/fix-known-issues/failover-cross.log 2>&1 &, ожидание. Проверка:- код 0, 4 фазы;
- в журнале 4 строки «cross-check: stream = buffer»;
meta.jsonметкиevidence/failover/quick-failover-*(последней):statuscomplete,git.dirtyfalse,git.commit= commit 3;host_state.swapouts_deltaесть и равенend.swapouts − start.swapouts. Его нет — только еслиstart.swapoutsравенnull.
Чтение —
python3 -cсjson.load. Сбой — разбор. -
3.5 Прогон 2 под шумом
docker exec. Проверка хоста, затем:S=<scratchpad>/fix-known-issues; rm -f $S/noise.stop nohup sh -c 'n=0; s=$(date +%s); while [ ! -f "$1" ]; do if docker exec mtusi-bench-valkey true >/dev/null 2>&1; then n=$((n + 1)); else sleep 0.5; fi; done; echo "noise-execs=$n seconds=$(( $(date +%s) - s ))"' sh $S/noise.stop > $S/noise.log 2>&1 & nohup make bench_failover_quick > $S/failover-noise.log 2>&1 &После конца
run.py—touch $S/noise.stop, затемcat $S/noise.log. Проверка:- код 0, 4 фазы, строк «docker events … not found» нет;
- хотя бы в одной фазе «cross-check: buffer lost the events»;
- в журнал — частота шума (execs за секунды) и какие фазы потеряли события в буфере.
Ни одна фаза не потеряла — шума мало: повтор один раз с двумя такими циклами. Снова нет — записать как результат и идти дальше.
-
3.6 Откат сверки:
git revert --no-commit <commit 3>, затемgit commit, сообщение commit 4 с телом «This reverts commit <хэш>.» и строкойCo-Authored-By. Проверка:git diff <commit 2> HEAD -- benchпуст. -
3.7 Итоговый прогон на окончательном коде: проверка хоста,
make bench_failover_quick(фоном, журналfailover-final.log). Проверка:- код 0, 4 фазы, строк «cross-check» нет;
meta.json:git.commit= commit 4,git.dirtyfalse,swapouts_delta— как в 3.4.
Затем рабочий стенд снова:
make run_docker,make lb_stats— обе репликиUP.
4. PostgreSQL стенда отказов (запись 4, решения 11, 12)
-
4.1
student-tests/run_failures.py(решение 12):- константа признаков аварии;
- функция чтения журнала:
dc(project, "logs", "--no-log-prefix", "postgres", quiet=True); - сводка
postgres log: N lines, crash markers M; "too many clients" X, "administrator command" Y; - при M > 0 — строки признаков (не больше 20) и
results["postgres"] = 1; - вызов после pytest и до уборки, только если pytest запускался;
- строка в докстринге модуля.
make lint, commit 5. -
4.2 Красный прогон, то есть воспроизведение дефекта на закоммиченном коде (сценарий «PostgreSQL перезапустился аварийно»):
nohup make failure_checks > <scratchpad>/fix-known-issues/failure-red.log 2>&1 &, ожидание (~70 с). Ожидается:- 17 passed;
- сводка журнала с
crash markers> 0, среди строк —untracked child process … exited with exit code 2иreinitializing; resultsсодержит'postgres': 1, код выхода не 0;- стенд отказов удалён:
docker ps -a --filter label=com.docker.compose.project=mtusi-lab3-failures -qпусто.
Не воспроизвелось — повтор
make failure_checks FAULT_ARGS='-k connection_limit'до двух раз. Нет и тогда — остановиться, разобрать и вернуть отчёт основной сессии;init: trueвслепую не коммитить. -
4.3 Исправление (решение 11):
student-tests/failures.compose.yml:init: trueуpostgres; в шапке — зачем (сиротыpsqlизfill-connectionsподбирает init, а не postmaster);student-tests/fault_hook.py: комментарий уFILL_SHпро сирот и init стенда. Код hook не меняется.
make lint, commit 6. -
4.4 Зелёные прогоны (сценарий «Заполнение и освобождение слотов»):
make failure_checksдва раза. До и после —StartedAtконтейнеровmtusi-lab3(docker inspect). В каждом прогоне:- код 0, 17 passed;
- сводка
crash markers 0, а «too many clients» и «administrator command» > 0: заполнение и освобождение правда были; results: {'fault': 0, 'postgres': 0}, стенд отказов удалён.
Во время одного прогона, пока идёт pytest:
docker inspect -f '{{.HostConfig.Init}}' mtusi-lab3-failures-postgres-1→true.StartedAtрабочего стенда не изменился.
5. Ранний обработчик сигналов (запись 2, решения 3–8)
-
5.1 Команда
stop-at-startвdriver.py(решение 8): аргументы, контейнеры по метке, поток событий, классы попыток, «кто остановил», PASS, уборка вfinally. Плюс строка в докстринге драйвера. Проверка:/usr/bin/python3 -m py_compile .claude/skills/run-mtusi-messenger/driver.py— синтаксис 3.9;python3 .claude/skills/run-mtusi-messenger/driver.py stop-at-start --help;make lint— код 0.
Commit 7.
-
5.2 «До» (сценарии
graceful-shutdownна прежнем коде). Образ:git archive --format=tar HEAD | docker build -t mtusi-messenger:stop-before -— HEAD это commit 7, код приложения как вBASE. ID образа — в журнал. Проверка хоста, затемpython3 .claude/skills/run-mtusi-messenger/driver.py stop-at-start --image mtusi-messenger:stop-before > <scratchpad>/fix-known-issues/stop-before.log. Ожидается:- код 1;
- попытки
import:docker stop≈ 10 с, код 137, остановки в журнале нет, а «Uvicorn running on» появился уже после сигнала — дефект воспроизведён; - попытки
runningиserver-start: код 0, остановилuvicorn.
-
5.3 Код (решения 3–5):
- новый
src/infra/early_stop.py: только stdlib,install(),disarm(), обработчик — запись по решению 5 иos._exit(0)вfinally; докстринг со ссылкой на design; src/__main__.py— по решению 3, импорты внутриif __name__ == "__main__";src/main.py:early_stop.disarm()— первая строкаlifespan, комментарий зачем.
Проверка:
grep -nE "^(import|from) " src/infra/early_stop.py— только stdlib;.venv/bin/python -c "import src.infra.early_stop"— код 0;make lint— код 0.
- новый
-
5.4
scripts/rolling-update.sh,remove_new(решение 7):- слот есть →
maint→docker stop --timeout 10с временем и кодом выхода →docker rm -f→ адрес ушёл →ready; - слота нет →
docker rm -f; - строка
removed new …в формате решения 7; - комментарий без ссылки на
KNOWN_ISSUES.md.
Проверка:
sh -n scripts/rolling-update.sh;git diff— толькоremove_newи комментарии. - слот есть →
-
5.5
make lint,make check, commit 8. Хэш — в журнал. -
5.6 Консоль на commit 8 (решение 6, сценарий «Ctrl+C в консоли во время старта»), порт 18089 свободен (
lsof -nP -iTCP:18089 -sTCP:LISTENпусто):-
SIGTERM на импорте:
APP__RUN_MODE=console APP__PORT=18089 .venv/bin/python -m src > <scratchpad>/fix-known-issues/console-term.log 2>&1 & pid=$!; sleep 0.3; kill -TERM $pid; wait $pid; echo "exit=$?"Ожидается
exit=0. В журнале одна строка JSON «Stopped API before startup» сsignalSIGTERM,levelinfo,timestamp,instance_id, traceback нет. -
То же с
kill -INT—exit=0,signalSIGINT. -
После готовности: тот же запуск, ожидание
curl -sf http://127.0.0.1:18089/health/live, затемkill -TERM $pidиwait. Ожидаетсяexit=0: «Shutting down», «Stopped API», «Finished server process», записи «before startup» нет. -
Reload (
D=.claude/skills/run-mtusi-messenger/driver.py):python3 $D start(порт 18080),touch src/main.py, через 3 с в/tmp/mtusi-api-18080.log— «Reloading»,python3 $D status—ready: True,python3 $D stop.git status --porcelainпуст.
-
-
5.7 Новый код на рабочий стенд без простоя:
- до замены — ID и
.Imageреплик (docker compose ps -q api,docker inspect -f '{{.Image}}'); python3 tests/load.py --duration 45 --concurrency 4 > <scratchpad>/fix-known-issues/load-rollout.log 2>&1 &, затемmake rolling_update > <scratchpad>/fix-known-issues/rollout.log 2>&1, затем ожидание нагрузки.
Проверка:
- код скрипта 0, две строки
removed old … (stop Ns, exit 0); failed_requests0 в отчётеtests/load.py;make lb_stats— две репликиUP;- реплики с новыми ID на одном новом
.Image; - в журнале новых реплик — обычный старт.
- до замены — ID и
-
5.8 Ветка сбоя
rolling-update.sh(решение 7):ROLLOUT_READY_TIMEOUT=1 make rolling_update: код 1, строкиremoving new replica … that is not readyиremoved new … (no slot: docker rm -f)или(slot api-N: stop Ns, exit 0);ROLLOUT_READY_TIMEOUT=2 make rolling_update— ради пути со слотом. Записать, какой путь сработал. Если замена успела завершиться (код 0) — это тоже результат;- после каждого запуска:
make lb_stats— две репликиUP;docker compose exec -T haproxy bash -c 'exec 3<>/dev/tcp/127.0.0.1/9999 && echo "show servers state api" >&3 && cat <&3'— у слотовsrv_admin_state0 или 32, без флагов 1 и 8.
-
5.9 «После». Проверка хоста, затем
python3 .claude/skills/run-mtusi-messenger/driver.py stop-at-start --image mtusi-messenger:lab3 > <scratchpad>/fix-known-issues/stop-after.log. ID образа равен.Imageреплик рабочего стенда. Ожидается:- код 0, PASS;
- попытки
import: остановилearly,docker stop≤ 1 с, код 0; - хотя бы одна
server-start: остановилuvicorn, ≤ 1 с, код 0. Ни одной — повтор с--server-start 10; running: остановилuvicorn, код 0.
-
5.10 Регрессия консоли:
lsof -nP -iTCP:18080 -sTCP:LISTENпусто, затемpython3 .claude/skills/run-mtusi-messenger/driver.py all. Ожидается:FAILED: noneуflow,PASSу smoke, все тесты прошли, тесты реплик пропущены с причиной, код 0. -
5.11 Уборка:
docker image rm mtusi-messenger:stop-before;docker ps -a --filter label=mtusi.stop-at-start -qпусто.
6. Доказательства исключений сверки (запись 1, решения 1, 2)
-
6.1 Команды
cache-checkиauth-storageвdriver.py(решение 1), строки в докстринге. Проверка:/usr/bin/python3 -m py_compile .claude/skills/run-mtusi-messenger/driver.py;make lint— код 0;- пробный запуск обеих против рабочего стенда (
--port 8080): код 0, в выводе нет токена, пароля и хэшей.
Commit 9.
-
6.2
make test_isolated > <scratchpad>/fix-known-issues/test-isolated.log 2>&1при работающем рабочем стенде. Ожидается код 0, 4 теста реплик пропущены с причиной. Сразу после — 6.3: ключи тестового прогона нужны в Valkey. -
6.3 Снятие доказательств, ничего другого на стенде не идёт:
python3 .claude/skills/run-mtusi-messenger/driver.py --port 8080 cache-check > <scratchpad>/fix-known-issues/cache-check.log. Код 0. Ожидается (решение 1, шаги 5–8): чтенийchats1, hits +49, промахов +1; 60 ответов 200 (50 в окне счётчиков, 10 — для срока); TTL ≤ настроенного и чтениями не продлевается; ≥ 2X-Instance-Id; ключи обоих префиксов > 0;python3 .claude/skills/run-mtusi-messenger/driver.py --port 8080 auth-storage > <scratchpad>/fix-known-issues/auth-storage.log. Код 0, факты решения 1.
Проверка секретов:
grep -nE '/Users/|Bearer |\$argon2id\$[^ ]*\$[A-Za-z0-9+/]{8,}'по обоим журналам — пусто. -
6.4 Сверка ссылок (решение 2):
missing_evidenceвstudent-tests/spec_coverage.py;- два теста в
student-tests/test_coverage.py; - тексты
checkпяти исключений называют команды.
make lint, commit 10. Красная проверка на нём, до файлов доказательств (сценарий «Ссылка на отсутствующий файл»):uv run pytest student-tests/test_coverage.py. Тест на настоящих исключениях падает и называет пять сценариев и два пути, остальные проходят. Вывод — в журнал. -
6.5
evidence/cache/hits.mdиevidence/auth/passwords-and-tokens.mdпо образцу файлов лабы 2:- шапка: спеки и сценарии, change, дата, commit (код команд — commit 9, приложения — commit 8), стенд (LB, две реплики, лимиты), хост, команда;
- разделы с выводом команд; у
hits.md— ещё строкаmake test_isolated(итог и время); - вывод.
Проверка:
uv run pytest student-tests/test_coverage.py— зелёный; grep секретов из 6.3 по обоим файлам — пусто. -
6.6
make student_testчерез LB — все прошли (на 2 больше, чем до change: 131 → 133), строка сверки покрытия с прежними числами (137 / 125 / 12). Commit 11: оба файла.
7. Регрессия на итоговом коде
-
7.1 Статика:
make lint,make check,make validate PYTHON=.venv/bin/python;uv run python bench/scaling.py --selftest,uv run python bench/resources.py --selftest, однострочник 2.2;sh -n scripts/rolling-update.sh.
Все — код 0.
-
7.2
make test—PASS;make instances—instances: 2. -
7.3
make student_testчерез LB — все прошли, тесты реплик выполнены, строка сверки покрытия. -
7.4
make test-persistence ACTION_SCRIPT=scripts/restart.sh—PASS;StartedAtLB, реплик, PostgreSQL и Valkey до и после — новые, ID те же. -
7.5
make test-failoverпоevidence/tests/clean-clone-final.md, сSTOP_ONE_LOG:stopдля одной реплики,make replicas, сдвиг очереди одним запросом,stopдля другой;make replicas, затемSTOP_MODE=kill.
Все
PASS. ID остановленного контейнера =TARGET_INSTANCE_ID. Код выхода:Exited (0)уstop,Exited (137)уkill. В концеmake replicas. -
7.6
make test_isolated— код 0. -
7.7
make failure_checks— код 0, сводка журнала PostgreSQLcrash markers 0. -
7.8 Быстрые профили на итоговом коде. Проверка хоста (с
make stop), дерево чистое, затем цепочкой фоном:nohup sh -c 'make bench_failover_quick && make bench_rollout_quick; echo "chain-exit=$?"' > <scratchpad>/fix-known-issues/quick-final.log 2>&1 &Проверка:
chain-exit=0;failover— 4 фазы, сверка записей сошлась;rollout— замена завершена, сверка сошлась, вraw/rollout-script.logстрокиremoved old … exit 0;- у обеих меток
git.commit= HEAD,git.dirtyfalse,host_state.swapouts_deltaесть.
Затем
make run_docker,make lb_stats— две репликиUP.
8. Документы и evidence проверок
-
8.1
evidence/failover/stop-at-start.md:- шапка: сценарии
graceful-shutdown, change, дата, commit «до» (7) и «после» (8), ID образов, лимиты (1 CPU / 512 МиБ, без сети), хост; - вывод
stop-at-start«до» (5.2) и «после» (5.9), с пояснением классов; - строки
rolling-update.shветки сбоя (5.8) и коды выхода старых реплик при замене (5.7); - вывод: что исправлено и что осталось — окно 0.
- шапка: сценарии
-
8.2
evidence/tests/fix-known-issues-checks.md, в стилеrolling-update-checks.md. Шапка — change, даты, хэши коммитов 1–11, стенды, хост. Разделы:- самопроверка
swapouts_delta(2.2); - сверка событий: прогон без помех (3.4), под шумом с частотой
docker exec(3.5), итоговый (3.7),swapouts_deltaв паспортах; - стенд отказов: красный (4.2) и зелёные (4.4) прогоны со сводкой
журнала,
HostConfig.Init,StartedAtрабочего стенда; - консоль (5.6, 5.10);
- замена под нагрузкой (5.7);
- красная и зелёная сверка ссылок (6.4, 6.5);
- регрессия (7.x);
git diff --stat <BASE> HEAD -- src Dockerfile docker-compose.yml infra pyproject.toml uv.lock— толькоsrc/__main__.py,src/main.py,src/infra/early_stop.py.
- самопроверка
-
8.3
KNOWN_ISSUES.md: пять записей удалить, шапку оставить, плюс строка «Открытых записей нет: записи лабы 3 исправлены changefix-known-issues.» Проверка:grep -c '^## ' KNOWN_ISSUES.md→ 0. -
8.4 Правила — факты, которые меняет change:
docker.md, пунктCMD: сервер — PID 1, ранний обработчик до импорта приложения, почему безinitуapi;run-modes.md: «Точка входа» (src/__main__.py→early_stop→src.main:main()) и пункт SIGTERM — окна A–D и окно 0;logging.md: исключение для записи ранней остановки — JSON без structlog, поля и почему; строка в таблице «Где логировать»;infra.md: пункт проearly_stop.py— только stdlib, не клиент, импортируется до приложения,disarm()зовёт lifespan;balancer.md, «Сбой на середине»: путь со слотом и без слота;student-tests.md:- исключения ссылаются на существующие файлы, команды драйвера для пересъёмки;
- стенд отказов:
init: trueу PostgreSQL и проверка журнала;
bench.md: события фазыfailover— поток по контейнеру цели;host_state.swapouts_deltaпишется и при 0.
Проверка:
grep -n "KNOWN_ISSUES" .claude/rules/*.md— нет ссылок на удалённые записи; каждое изменённое утверждение сверено с кодом. -
8.5
.claude/skills/run-mtusi-messenger/SKILL.md: строки таблицы команд и примеры дляstop-at-start,cache-check,auth-storage. Проверка:python3 .claude/skills/run-mtusi-messenger/driver.py --helpперечисляет их, описания совпадают. -
8.6
AGENTS.md:- вступление: change
fix-known-issuesв перечне и что он исправил; число changes в архиве — по факту; - таблица команд:
make failure_checks— проверка журнала PostgreSQL; - карта кода:
src/__main__.py, новыйsrc/infra/early_stop.py,spec_coverage.py,run_failures.py,failures.compose.yml,bench/run.py(поток событий уfailoverтоже); - карта evidence:
evidence/cache/иevidence/auth/— новые описания,evidence/failover/—stop-at-start.md,evidence/tests/— файл проверок change; - «Переход в следующую лабу»: доказательства исключений снимаются
заново (
make test_isolated+cache-check,auth-storage,make test-persistence, повтор после рестарта API), иначе сверка красная.
Проверка:
grep -n "early_stop\|fix-known-issues\|cache-check" AGENTS.mdнаходит новые строки. - вступление: change
-
8.7
REPORT.md, свежий Read:-
шапка:
fix-known-issuesв списке «Сделано по changes». Абзац о проверке из чистого clone — в 9.3; -
таблица доказательств — новые строки с командой, наблюдением и файлом:
- остановка реплики во время старта (
stop-at-start.md); - исключения сверки на стенде лабы 3 (
hits.md,passwords-and-tokens.md); - регрессия
fix-known-issues(файл проверок).
В «Сверке с рубрикой» строку уровня 4 про SIGTERM дополнить;
- остановка реплики во время старта (
-
«Эксперименты и отказы»: в таблице ручных отказов строка «
docker stopстартующей реплики» с «до/после». Фразы оswapouts_deltaсо ссылкой наKNOWN_ISSUES.md(абзац о проверке хоста, раздел «Цена масштабирования») — «поле не записано, дефект паспорта исправлен changefix-known-issues, метки не правились»; -
«Ограничения и следующие шаги»:
- «Известные дефекты» — открытых нет, что исправлено;
- окно 0 — ограничение;
- «Следующие шаги» без исправленных пунктов;
- пункт «SIGTERM во время старта реплики теряется» в «Поочерёдная замена и миграции» — по решению 7;
-
«Использование ИИ»: восьмой change, решение автора исправить записи отдельным change (2026-10-13).
Проверка:
grep -n "не исправлены\|evidence лабы 2" REPORT.md— пусто;grep -n "теряется" REPORT.md— только про окно 0 (запуск интерпретатора). -
-
8.8 Файлы change: отметки задач из журнала в
tasks.md; раздел «Найдено в apply» вdesign.md, если было что найти. -
8.9 Финал документов:
make lint,make check,openspec validate fix-known-issues --strict— код 0;- grep секретов из 6.3 по новым и изменённым файлам
evidence/— пусто; - commit 12.
Проверка: дерево чистое.
9. Итоговая проверка из чистого clone
-
9.1 По разделу
REPORT.md«Запуск из чистого clone» и образцуevidence/tests/clean-clone-final.md, на commit 12:- рабочий стенд —
docker compose down -v; git clone --branch solution/bvt2301-safronov <репозиторий> <scratchpad>/fix-known-issues/clean-clone;.env,config.toml,.venvв клоне нет;- в клоне:
make env_setup,make run_docker,docker build --no-cache --pullпод отдельным тегом (потом удалить),make check,uv sync,make validate PYTHON=.venv/bin/python,make test,make instances(python3и/usr/bin/python3),make test-persistenceсоStartedAt,make test-failoverдля каждой реплики иkill,make student_test,make failure_checks(со сводкой журнала PostgreSQL),make test_isolated; - уборка:
docker compose down -vв клоне, хвостовfailuresиtest-apiнет; в рабочем репозиторииmake run_docker,make lb_stats,make instances.
Все команды — код 0 без правки файлов клона. Сбой — разбор: дефект кода или инструкции правится commit и проверка повторяется.
- рабочий стенд —
-
9.2
evidence/tests/clean-clone-final.md— переписать на commit 12: дата, результаты, «Прошлая такая проверка (commitdbb9150) — в истории этого файла». Пароли не выводить. -
9.3
REPORT.md, свежий Read:- шапка: проверенный из чистого clone commit и дата, что менялось после него — только документы;
- строка таблицы доказательств «Итоговая проверка из чистого clone».
-
9.4 Финал:
- отметки 9.x в
tasks.md; openspec validate fix-known-issues --strict;- commit 13, дерево чистое;
graphify update ..
Итог apply для основной сессии:
- хэши коммитов;
- числа «до/после»:
stop-at-start, красный и зелёныйfailure_checks, сверка событий; - проверки хоста;
- расхождения, если были.
- отметки 9.x в