diff --git a/docs/orchestrator-norms-scratchpad.md b/docs/orchestrator-norms-scratchpad.md index 5a8f8eb4..8ce53495 100644 --- a/docs/orchestrator-norms-scratchpad.md +++ b/docs/orchestrator-norms-scratchpad.md @@ -669,3 +669,26 @@ HTTP-код, количество, номер строки кода. Никак занятой или свободной, спроси у найденных процессов ВРЕМЯ и КАТАЛОГ, а не только имя.** За смену этот класс поймал меня пять раз, и трюк с квадратной скобкой от него не спасает: в командной строке лежит весь текст скрипта целиком. + +## ⛔ ГЕЙТ ПЛАТФОРМЫ НА ЭТОМ ХОСТЕ ПАДАЕТ ОТ PATH, А ЧИТАЕТСЯ КАК «ИНСТРУМЕНТА НЕТ» (18.09, замер готовности) + +**Замер.** `make check` в зоне платформы даёт `CHECK_EXIT=2` и умирает на ПЕРВОЙ цели — `tools-check`, то есть +**до сборки, линтера и генератора**, и по правилу «цель, падающая первой, отменяет все последующие» зелени не +видел никто. Сообщение: «sqlc v1.31.1 required … got: none». + +⇒ **Инструмент на диске ЕСТЬ и ровно нужной версии** (`/home/ubuntu/go/bin/sqlc` → `v1.31.1`). Не хватает +только пути: `$HOME/go/bin` в `PATH` этой оболочки отсутствует при 44 элементах в нём. ⭐ И цель сама это +предсказала — её текст несёт оговорку «`got: none` с бинарём на диске есть проблема PATH». **Прибор сказал +правду о своём вопросе; прочиталось как факт о мире.** + +⚠ **Почему это readiness-находка, а не бытовая мелочь.** Сессия холодного прогона, увидев такое, заключила бы +одно из двух неверных: «платформа сломана» либо «инструментов на машине нет, ставлю сам» — и во втором случае +поставила бы другую версию, а генерируемый слой запросов **закоммичен**, то есть версия решает дифф. ⇒ в пак +прогона это идёт предстартовым условием: **перед `make check` в зоне платформы добавь `$HOME/go/bin` в PATH, +и не ставь инструмент заново, пока не посмотрел, нет ли его на диске.** + +⚠ И отдельно, для акта готовности: **у платформы цель `check` НЕ включает `test`** — она есть +`build vet fmt lint sqlc-check`. Её зелень означает сборку, стиль и свежесть генерации, **но не поведение**. +Комментарий самой цели честно говорит, что батарея несёт ВТОРУЮ, более слабую проверку того же свойства, +которая живёт на хосте без инструмента. ⇒ в акте это называется прямо, иначе «гейт зелен» прочтётся не тем, +чем является.