[Epic] Гигиена и укрепление после v1.8.0 — аудит 2026-07-14 (8 ролей)

[ArtVsMark]

Цель

Закрыть дефекты, вскрытые мультиагентным аудитом состояния v1.8.0 + [Unreleased] от лица восьми ролей (8 независимых агентов прочитали ~14.8k строк кода и ~18.4k тестов; ключевые находки перепроверены вручную по file:line). Все дефекты — в уже смерженном коде, не видимы для зелёных гейтов (ruff/mypy чисто, 1420 passed, 87.55% покрытие).

Полный разбор по ролям, сквозные темы и доказательства — в docs/audit-2026-07-14.md (PR #391).

Сквозные темы

1. «Реализовано, но не подключено» — history пишется только из CLI (→ «Подучить» в web пуст), lint не пишет LintRecord, --sandbox не в web, TestResult обойдён, executor.py мёртв.
2. Web-слой — концентратор долга и риска — диффузная граница с core/, 3 security-бреши на стыках, перф горячего пути, монолит фронтенда, непокрытая конкурентность.
3. Тихие потери данных под конкуренцией — гонка миграции истории (воспроизведена), утечка соединения, неатомарные записи, перескачивание тестов.
4. Числовой дрейф доков — метрики 1317/93% устарели, разнобой числа карточек глоссария.

Child issues (по приоритету)

P1 (делать первыми):

• fix(history): устойчивость соединения и миграции SQLite под конкуренцией #393 — fix(history): устойчивость соединения и миграции SQLite под конкуренцией
• fix(downloader): перескачивание не чистит tests/ → тихий неверный вердикт #394 — fix(downloader): перескачивание не чистит tests/ → тихий неверный вердикт
• feat(web): писать историю из web-грейдинга → наполнить «Подучить» #395 — feat(web): писать историю из web-грейдинга → наполнить «Подучить»
• feat(web): пробросить --sandbox в --serve (исполнение чужого кода без изоляции) #396 — feat(web): пробросить --sandbox в --serve
• refactor(core): сервисный слой грейдинга + вернуть ранжирование в core #397 — refactor(core): сервисный слой грейдинга + вернуть ранжирование в core
• docs: синхронизировать метрики и число карточек глоссария #398 — docs: синхронизировать метрики и число карточек глоссария

P2 (security):

• fix(web): CSRF-guard не пропускать запрос без Origin И Referer #399 — fix(web): CSRF-guard не пропускать запрос без Origin И Referer
• fix(oauth): authorize_and_get_token писать токены через save_secrets (0600) #400 — fix(oauth): токены через save_secrets (0600)
• fix(web): конфайнить root в /api/download #401 — fix(web): конфайнить root в /api/download

P2 (продукт/онбординг):

• feat(web): браузерный OAuth в --serve (убрать CLI-стену онбординга) #402 — feat(web): браузерный OAuth в --serve
• feat(core): замкнуть lint → LintRecord → history (#346) #403 — feat(core): замкнуть lint → LintRecord → history (feat(lint): core/lint.py + opt-in extra [lint] (ruff) — PEP-проверка решения с мини-карточками нарушений #346)

P2 (perf/тесты/техдолг):

• perf(web): кеш производных структур глоссария + снять двойной retry #404 — perf(web): кеш производных структур глоссария + снять двойной retry
• test: закрыть слепые зоны (валидация rules, concurrency, реальный float, property-based) #405 — test: закрыть слепые зоны (валидация rules, concurrency, реальный float, property-based)
• refactor(core): убрать «двойник» executor.py + декомпозировать run_single_test #406 — refactor(core): убрать «двойник» executor.py + декомпозировать run_single_test
• style: issue #73 (Path|str) + типизация diagnostic_stepik + мелкие идиомы #407 — style: issue refactor(api): Path instead of str in public contracts #73 (Path|str) + типизация diagnostic_stepik

P2/P3:

• fix(web): TTL job'ов от завершения + атомарная запись JSON #408 — fix(web): TTL job'ов от завершения + атомарная запись JSON
• fix(ui): .hint CSS + a11y редакторов + адаптивность reporter/sidebar #409 — fix(ui): .hint CSS + a11y редакторов + адаптивность reporter/sidebar
• chore: мелкие корректности и доки (regex, parse, redaction, CONTRIBUTING, ADR, DAG-guard) #410 — chore: мелкие корректности и доки (regex, parse, redaction, CONTRIBUTING, ADR, DAG-guard)

Топ-3 приоритета

1. fix(history): устойчивость соединения и миграции SQLite под конкуренцией #393 — тихая потеря данных под конкуренцией (воспроизведена), ломает фундамент [Epic] Учебные инсайты: разделы «Правила/PEP» и «Подучить» на SQLite-истории #342, шумит ResourceWarning.
2. feat(web): писать историю из web-грейдинга → наполнить «Подучить» #395 + feat(web): пробросить --sandbox в --serve (исполнение чужого кода без изоляции) #396 — «Подучить» в web пуст + web исполняет чужой код без изоляции.
3. refactor(core): сервисный слой грейдинга + вернуть ранжирование в core #397 — корневое лекарство от диффузной границы web↔core; разблокирует remote-execution API (feat(api): описать API contract для удалённого запуска кода #156).

Acceptance criteria (эпика)

• Все дочерние закрыты или явно перенесены.
• Метрики в CLAUDE.md/CHECKPOINT/versions синхронизированы.
• pytest/ruff/mypy зелёные; ResourceWarning устранён.
• Обратная совместимость __all__ фасада grader.py сохранена.

Links

• Аудит: docs/audit-2026-07-14.md (PR docs(audit): глубокий аудит v1.8.0 — 8 ролей, эпик + 18 issue #391)
• Предыдущий аудит: docs/audit-2026-07.md
• Смыкается: [Epic] Анализ и развитие Stepik-Python-Grader: локальный CLI → WEB/Server IDE #97, [Epic][PR-7] SQLite persistence: история запусков и учебные данные #130, [Epic] feat(web): UX-оптимизация раздела «Проверка решений» (пункты владельца а–к) #362; ссылается на 💡 [Roadmap] Долгосрочные идеи: плагины платформ, дашборд-команда stats, серверная параковка #59, [Epic][PR-10] Diagnostic logging for downloader/client/oauth #146, [Epic][PR-11] Server mode: SandboxRunner + PostgreSQL + accounts #151/feat(server): спроектировать SandboxRunner с контейнерами и resource limits #153, feat(lint): core/lint.py + opt-in extra [lint] (ruff) — PEP-проверка решения с мини-карточками нарушений #346, [Epic] feat(glossary): довести 832 draft-карточки до ready — волны В1–В6 #363