Ошибки и восстановление
Коды ошибок выполнения и действия для восстановления.
Как читать ошибки
Ошибки Work Graph возвращаются MCP-инструментами и локальными проверками (workgraph:doctor, lint backlog). Код стабилен: его можно положить в runbook и автоматизировать recovery.
JSON для агентов: /api/docs/errors-context.
Коды P0
| Код | Что означает | Что делать |
|---|---|---|
duplicate_work_id | Задача с таким work.id уже в intent/ | Выберите новый id или обновите существующий .bvc |
invalid_bvc_section | В атоме нет Базиса, Вектора или Цели | Дополните секции; см. [BVC-спецификация](/docs/bvc-spec) |
missing_evidence | Задачу нельзя закрыть без proof | Запустите checks из контракта, приложите логи, повторите assert_task_ready_for_done |
Типичные ситуации
Агент создал задачу дважды — второй вызов create_work_item с тем же id → duplicate_work_id. Исправление: merge в один атом или новый suffix в id.
«Готово», но доска в verify — агент не вызвал assert_task_ready_for_done или получил ok: false. Читайте missing[]: там id проверки и недостающее поле evidence.
Линтер backlog падает в CI — часто invalid_bvc_section или битая иерархия intent/. Запустите npm run lint:backlog локально до push.
Политика восстановления
- Не меняйте
work.statusнаdoneвручную, обходя гейт — иначе память проекта и audit расходятся с контрактом. - Все исправления evidence и контракта — через git (как код).
- При неясности откройте drawer задачи в UI и сравните с выводом
get_work_contract.
Связанные инструменты
create_work_item,get_work_contract,assert_task_ready_for_done— см. [MCP-инструменты](/docs/mcp-tools)- Матрица tier — [Матрица проверок](/docs/verification-matrix)