doctor

/polisade:doctor — Project Health Diagnostics

Первое действие при $ARGUMENTS с --help или -h: выполнить ровно эту команду, показать её stdout и завершить /polisade:doctor:

env ${POLISADE_PYTHON:-python3} {plugin_root}/scripts/polisade_doctor.py --help

⛔ Если вызов скрипта на этом шаге ты СДЕЛАЛ, и он отклонён или не запустился (Command references protected path / Install directory is read-protected / Filesystem Guard / the tool's default permission is 'deny', отказ песочницы, ненулевой exit без вывода) — STOP. Вызова не было — отказа нет: сначала выполни команду; этот блок описывает её вывод и сам ответом не служит. Процитируй отказ дословно. НЕ пересказывай по исходнику, что скрипт «сделал бы»; НЕ собирай dry-run вручную; НЕ переходи к apply/push/pr-create. НЕ транскрибируй скрипт (прочитать → записать копию в /tmp или в проект → запустить копию): копия не байт-идентична — уезжают классы символов в regex, форма возврата функций, пропадают целые функции — и молча меняется набор применённых изменений. Отказ инструмента — это отказ, а не результат. Доложи PM дословный текст отказа и назови следствие: без рабочего вызова скрипта этот шаг выполнить нечем. Причину не придумывай — её называет только сам текст отказа.

Справка не требует чтения проекта или запуска проверок. Используй указанный shell-путь к скрипту, не подменяя его путём исходного чекаута.

Read-only диагностика здоровья Polisade Orchestrator-проекта. Проверяет структуру, файлы состояния, инструменты и консистентность.

Status vocabulary check (artifact_statuses): статус артефакта вне закрытого словаря (scripts/_polisade_state_model.py) — почти всегда опечатка, и она молча выкидывает артефакт из ВСЕХ производных списков PROJECT_STATE.json (в artifactIndex он при этом остаётся). Проверка даёт WARN и перечисляет нарушителей; переходы статусов нигде не enforce'ятся — это тонкий stdlib-клиент. Также WARN для cancelled/not_actual/not_applicable без status_reason и для not_actual вне BUG. Зелёный artifact_statuses означает только корректную форму, а не доказанную причину или merge PR. adr_outcome_lists отдельно предупреждает, если ADR not_applicable по-прежнему числится в architecture.activeADRs или deprecatedADRs.

Pre-push hook check (prepush_hook): установлен ли git-хук /polisade:init, запрещающий push в main/master без POLISADE_ALLOW_MAIN_PUSH=1 и push ветки, отличной от POLISADE_EXPECTED_BRANCH (когда та задана). Каталог хуков резолвится через git rev-parse --git-path hooks — core.hooksPath и worktree учитываются. WARN, а не FAIL: хуки не клонируются, не версионируются и обходятся --no-verify, так что это ремень безопасности перед серверной защитой веток, а не она сама. В сообщении WARN — готовая команда установки; чужой существующий pre-push doctor не трогает и не предлагает перезаписать.

Vendored scripts check (scripts_vendor): в сборках, где Python-скрипты плагина исполняются из копии в проекте (.polisade/bin, потому что каталог установки закрыт Filesystem Guard'ом), сверяет копию с .polisade/bin/MANIFEST.sha256 — версия плагина плюс sha256 каждого файла. Отсутствие копии под такой сборкой — FAIL с командой установки; нехватка файлов или несовпавший хэш — FAIL «копия устарела или искажена»; версия манифеста старше версии проекта — WARN. Отличие ТОЛЬКО в переводе строки (CRLF) — отдельный WARN с причиной (git core.autocrlf), а не «искажена»: содержимое то же. Права на файлы не проверяются — хэш считается по байтам. Если .polisade/bin нет и сборка не вендорит скрипты, проверка PASS'ит как неприменимая. Сборка определяется тремя ИЛИ-сигналами, ни один из которых не читает каталог установки: POLISADE_PLUGIN_ROOT с .gigacode/, заголовок # target: gigacode в манифесте, либо GIGACODE.md как ЕДИНСТВЕННЫЙ контекстный файл проекта.

VCS provider check (встроенный в дефолтный отчёт + отдельный режим --vcs): под сборкой GigaCode vcsProvider: github даёт WARN: GitHub недоступен по сети этой инсталляции, дефолт там — bitbucket-server. Если settings.vcsProvider == "bitbucket-server" — проверяет наличие .env, что хотя бы один BITBUCKET_DOMAIN{1,2}_URL и _TOKEN заполнены (не stub-значения), что хост git remote origin совпадает с одним из заполненных доменов, и что whoami через polisade_vcs.py к матчнувшемуся инстансу возвращает 200 (через аутентифицированный endpoint — невалидный токен даст 401).