Начинайте с read-only evidence. Не перезапускайте сервисы, не исправляйте state, не удаляйте данные и не меняйте project scope, пока профессиональный администратор не проверит диагноз и rollback path.
1. Соберите общую диагностику
Из release checkout:
python -m src.cli doctor --json
Сохраните результат вместе с revision CodeGraph, временем, environment, project и наблюдаемым симптомом. Перед передачей удалите токены, credentials, customer source и персональные данные.
2. Сузьте проблемную поверхность
python -m src.cli doctor config
python -m src.cli doctor project --help
python -m src.cli doctor cpg --help
python -m src.cli doctor openviking --help
python -m src.cli doctor temporal --help
Запустите нужный subcommand с документированным project selector. Не подменяйте project identity сырым storage file.
3. Проверьте локальный development stack
Только для явно локального source environment:
python scripts/run_app_stack.py status --local --with-mcp
python scripts/run_app_stack.py logs --local --with-mcp
Это не customer-процедура service manager. На Ubuntu-развёртывании заказчика используйте
systemctl, Compose и readiness-команды из руководства по установке.
4. Проверьте repair plan
Некоторые doctor surfaces поддерживают безопасное восстановление. Сначала выполните dry-run:
python -m src.cli doctor config --repair --dry-run
Применяйте repair после одобрения target, backup, expected postcondition и rollback. Успех мутации подтверждается записью изменения и проверкой postcondition; dry-run показывает план.
Маршрутизация симптомов
| Симптом | Первые evidence |
|---|---|
| Startup/config rejection | doctor config, service status, readiness output |
| Проект не виден | projects list, projects resolve-scope, access identity |
| Граф отсутствует или устарел | import job, doctor project, doctor cpg |
| MCP недоступен | API/MCP readiness, /status, project binding |
| Context degraded | doctor openviking, freshness warning, sync state |
| Workflow задерживается | doctor temporal, task/session identifier |
Не очищайте persistent volumes, не завершайте широкие группы процессов, не отключайте TLS verification и не печатайте environment secrets как первую меру диагностики.
Пакет для эскалации
Передайте поддержке:
- точный симптом и ожидаемое поведение;
- timestamp, environment, release ref и resolved commit;
- tenant/group/project, session или job identifier;
- очищенные doctor и readiness outputs;
- уже выполненные действия и факт изменения state.
Источники контракта
src/cli/governance_suite/doctor_commands.py— diagnostic parser;src/cli/doctor_commands.py— diagnostic execution routing;scripts/run_app_stack.py— lifecycle локального stack;scripts/run_app_stack_readiness.py— общая runtime readiness.
См. также: Установка · Конфигурация