- Статус: Accepted — направление принято; фазы 1–2 реализованы (Runner-слой
#140, контракт результата #116). Дизайн-задачи #153/#154/#155 закрыты
(оформлено в ADR-0008/0009 +
server-*-design.md, PR #484); реализация полного server mode остаётся открытым v2.0-backlog (эпик #151). - Дата: 2026-07-08
- Связанные issue: #152 (этот ADR), #140 (Runner), #156 (API), #157 (sandbox)
- Связанный дизайн: server-mode.md, result-contract.md
Сегодня грейдер — локальный инструмент: CLI и веб-оболочка --serve
(127.0.0.1) исполняют доверенный код (свой или скачанный из Stepik as-is)
в subprocess без OS-sandbox — это осознанное by-design ограничение
(configuration.md § Ограничения и безопасность,
SECURITY.md). Есть регулярный запрос на «онлайн-проверку /
удалённый прогон / общий сервер», который подразумевает исполнение чужого
кода. Это принципиально другая threat model: без настоящей изоляции публичный
сервер, запускающий недоверенный код, — прямая RCE-поверхность.
Одновременно исполнение размазано по core/grader_core.py,
core/executor.py, core/microbench_runner.py — нет единой точки, где можно
сменить механизм запуска, не задев грейдинг.
Нужно зафиксировать направление, не начиная тяжёлую реализацию: снять неопределённость для будущих контрибьюторов и не дать случайно «включить сервер» без sandbox.
- Признать server mode отдельным продуктовым сдвигом, а не расширением
--serve. Он затрагивает MAJOR-границу проекта (выход за «локальный инструмент», см. политику версионирования). - Готовить архитектуру инкрементально через абстракцию
Runner(issue #140): выделить интерфейс запуска вcore/, обернуть текущий subprocess-путь вLocalRunnerбез изменения поведения. Это дешёвый, обратимый шаг, полезный и без server mode. - Спроектировать (но не реализовывать) контракт API удалённого исполнения (issue #156) и обязательные требования sandbox (issue #157) — сеть off, эфемерные tmp-каталоги, жёсткие квоты, изоляция клиентов. Детали — в server-mode.md.
- Не включать server mode с недоверенным кодом, пока требования #157 не обеспечены реальным механизмом изоляции. Механизм (Docker/nsjail/VM/сервис) этим ADR не выбирается — только требования к нему.
- Сохранить ядро библиотекой. Server mode — ещё один адаптер над
core/*(как CLI/Web), форма результата — result-contract.md; DAG остаётся ацикличным.
- A. Ничего не делать, остаться чисто локальными. Плюс: ноль риска и
затрат. Минус: повторяющийся запрос остаётся без ответа, а стихийные попытки
«пошарить
--serveнаружу» опасны без зафиксированного запрета. Отклонено в пользу явного, но отложенного направления. - B. Сразу строить сервер (напр. FastAPI + Docker). Плюс: быстрый продукт. Минус: тяжёлые зависимости и демоны против запретов CLAUDE.md; высокий риск RCE при недозревшем sandbox; переписывание исполнения без промежуточной абстракции. Отклонено как преждевременное и рискованное.
- C. Расширить
--serveдо сетевого доступа без sandbox. Отклонено безоговорочно: прямая RCE-поверхность, противоречит threat model (SECURITY.md). - D. Абстракция
Runner+ отложенная реализация (выбрано). Готовит почву минимальным обратимым рефактором, фиксирует контракты и требования безопасности, не создавая продукта и рисков раньше времени.
Положительные:
- Направление и границы зафиксированы; контрибьюторы не «включат сервер» случайно — запрет явный и обоснованный.
Runner-рефактор (#140) улучшает тестируемость исполнения уже сейчас.- Контракты (#156) и требования sandbox (#157) готовы к реализации без повторного разбора контекста.
Отрицательные / издержки:
- Вводится ещё одна абстракция в
core/— небольшой оверхед; митигируется тем, чтоLocalRunnerне меняет поведение. - Полноценный server mode остаётся не реализованным; онлайн-проверки пока нет (это осознанно).
Нейтральные:
- MAJOR-версия проекта сдвинется только при реальном включении server mode (фаза 4, server-mode.md § Фазовая миграция).
Кратко (полностью — server-mode.md § Фазовая миграция):
0 — сейчас (локально, без sandbox) → 1 — Runner/LocalRunner (#140) →
2 — SandboxRunner по требованиям #157 → 3 — API /api/v1/runs (#156) →
4 — публичный server mode. Каждая фаза обратно совместима с локальным
--serve//api/grade.