Skip to content

panel: адреса страниц, список наборов, заголовки окна и переход в набор из рейла - #32

Merged
akrhin merged 34 commits into
masterfrom
fix/panel-acceptance
Nov 18, 2026
Merged

akrhin merged 34 commits into
masterfrom
fix/panel-acceptance

Conversation

@akrhin

@akrhin akrhin commented Nov 17, 2026 •

Copy link
Copy Markdown
Owner

What this fixes

Four findings from the acceptance pass on 0.6.5, plus the defect behind a user
complaint that the panel could not be configured at all.

  1. A route that names no set opens the list of sets. #/sets and any unknown
    route showed the set that was open last; there was no list at all, only the
    rail. #page-sets now has a table of sets (name with port, state, servers,
    keys; the row opens the set), #/sets and unknown routes land on the list,
    and "back" from a set returns to it.

  2. The window title follows the page: mcprig — Overview, — Sets,
    — Statistics, — set main · Keys (RU: mcprig — Обзор, … — набор main · Ключи).

  3. The demo fixture no longer lies about the version (web/mock/state.json
    carries 0.6.5, the footer used to say 0.6.4).

  4. The latest calls on the host overview read as cards on a phone — at
    ≤ 760 px each record is a card; at 768 and 1280 it stays a table. The rule is
    bound to #host-calls-table, so the Calls tab is untouched.

  5. Choosing a set in the rail opens it from any page. Own reproduction: on a
    clean install (MCPRIG_DATA_DIR empty, MCPRIG_AUTH=off) create the first
    set — the registry gets it, the rail shows lab :9115 · stopped, but the panel
    stays on the host overview: location.hash still #/, page still
    #page-host, tabs hidden. A click on the set in the rail changed only
    document.title. Root cause: select() wrote the address and switched the
    page only when the panel already stood on the sets page
    (if (st.page === 'sets' && id && (force || …)), web/app.js:1976), so an
    explicit choice (select(id, true) from the rail, from create, from the
    neighbour after delete) was dropped on the host overview. Now an explicit
    choice opens the set page itself; auto-selection of the first set still does
    not move the page, so #/ stays the host overview and #/sets stays the list.

Evidence

Clean installs, MCPRIG_AUTH=off, playwright:

Step Before After
create the first set #/, host page, 0 tabs #/set/lab, sets page, 6 tabs
click a set in the rail from #/ hash #/, 0 tabs, title only #/set/lab, 6 tabs
click a set in the rail from #/stats/today stays on statistics #/set/lab, 6 tabs
load #/ host overview host overview (no auto-jump)
#/sets set opened last list of sets
row of the list → set → back — set → list

End-to-end on the fixed build: set lab → server dap (stdio) → attach → Start
→ running, server Healthy, 13 tools approved → key issued → initialize on
http://127.0.0.1:9118/mcp → 200, tools/list returns the 9 meta-tools,
invoke_command({server:"dap",command_name:"debug_list_sessions"}) →
{"sessions":[]}.

Panel checks: node --check web/app.js, bash scripts/docs-check.sh (5/5),
scrollWidth === clientWidth at 375 on #/, #/sets, #/set/main/calls,
0 console messages, mock footer says mcprig 0.6.5. Screenshots in
design/ui/panel-pages/ (fix-*.png from the acceptance pass, nav-*.png from
the rail-click fix).

What was not checked

  • raven contrast audit on the new list blocks; the layout reuses existing tokens
    and components.
  • Colour schemes other than dark and the Win98 family (nothing is bound to them).
  • The live panel behind a password: the same routes were checked on a local
    instance with the release binary.

Risks

  • Routing is shared by every screen: select() runs on load, on rail clicks and
    after create/delete. The auto-select path is deliberately excluded from the new
    branch, which the #/ and #/sets checks above cover.
  • web/codemap.md was already behind PR Панель: адреса вкладок набора и обзор хоста (#7, #8) #31 in its line numbers; only the
    screens section this change touches is updated, the rest is left as a debt in
    the audit report.

Debts closed in this branch

docs/debts.md holds the debt list from the 2026-11-18 audit. This branch closes
D1–D13 (D9 was already a decision), each with a test that fails without the fix:

  • D10 — reload applied the new keys to the listener before the manager rolled
    back a half-applied config, so a key was accepted without its profile. Reload
    now comes first and SetAuth runs only when nothing needs a restart.
  • D12 — the upstream error text reached the model, the counters and
    raw-*.jsonl unmasked; it is now scrubbed like the response, with the secrets
    of every server of the set.
  • D11 — GET /stats handed the full snapshot to whoever held the set's key;
    now only the panel's own poll gets it (X-MCPRig-Caller: panel), a key gets
    counters with (аноним) labels and empty error texts.
  • D13 — the release tag was expanded into the text of run: blocks that hold
    a write token and the registry password; it now arrives through env: and is
    read as "$TAG", and the release checkout keeps no credentials. v* tags are
    protected on both hosts (GitHub ruleset protect release tags, Gitea tag
    protection, whitelist sintez).
  • D1 — the catalog throttle map sweeps marks older than its 5 s window.
  • D3 — deleting a set clears its webhook state, like runtime and health.
  • D5 — failed logins drop expired windows on every write and the map is
    capped at 1024 entries.
  • D2 — a panic inside the health probe no longer leaves the single-flight
    wait open forever: the leader recovers, closes the wait and logs once.
  • D4 — secrets are masked by value, not by field name: every env and
    header value from 8 bytes up is masked, GITHUB_PAT and CF_ACCESS included.
  • D6 — the 26-step panel acceptance runs in CI on a freshly built binary;
    ACC_DAP became optional and its 11 stdio steps are skipped with a line.
  • D7 — the statistics cache evicts the oldest quarter by mtime instead of
    dropping the whole map.
  • D8 — turned out to be a decision: the "— запуск —" mark belongs to a
    process start, and the only Writer call sits behind exec.Command, so a live
    session never reaches it.

Gates on the final tree: gofmt, go vet, go build clean;
go test ./... -race -count=1 -p 1 — 736 passed in 19 packages;
golangci-lint run — 0 issues; bash scripts/docs-check.sh — 5/5;
panel acceptance with ACC_DAP — 37 steps, failed: 0; CI job acceptance —
green on the runner in 5 min 21 s (26 steps, 11 skipped).


Что исправляет

Четыре находки приёмки 0.6.5 и дефект, стоящий за жалобой «через гуй настроить
ничего нельзя».

  1. Адрес без набора открывает список наборов. #/sets и неизвестный
    маршрут показывали набор, открытый последним; списка не было вовсе. Теперь в
    #page-sets таблица наборов (имя с портом, состояние, серверы, ключи; строка
    ведёт в набор), #/sets и неизвестный маршрут дают список, «назад» из набора
    возвращает к нему.
  2. Заголовок окна следует за страницей: mcprig — Overview, — Sets,
    — Statistics, — set main · Keys.
  3. Демо-фикстура больше не врёт про версию (web/mock/state.json — 0.6.5).
  4. Последние вызовы на обзоре хоста на телефоне — карточками при ≤ 760 px,
    таблицей на 768 и 1280; правило привязано к #host-calls-table, вкладку Calls
    не задевает.
  5. Выбор набора в рейле открывает его с любой страницы. Воспроизведение: на
    чистой установке создаём первый набор — запись в реестре есть, рельс показывает
    lab :9115 · stopped, а панель остаётся на обзоре хоста: адрес #/, страница
    #page-host, вкладки скрыты; клик по набору в рейле менял только заголовок.
    Корень — select() писал адрес и переключал страницу только когда панель уже
    стояла на странице наборов (web/app.js:1976), поэтому осознанный выбор
    (рейл, создание, сосед после удаления) терялся на обзоре хоста. Теперь
    осознанный выбор открывает страницу набора сам; автовыбор первого набора
    страницу не трогает, поэтому #/ остаётся обзором, а #/sets — списком.

Доказательства

Чистые установки, MCPRIG_AUTH=off, playwright — см. таблицу выше; сквозной
сценарий до работающего MCP-эндпоинта: набор → сервер → привязка → Start →
13 инструментов → ключ → initialize 200 → invoke_command вернул
{"sessions":[]}.

Проверки: node --check, docs-check 5/5, отсутствие горизонтального скролла на
375, 0 сообщений консоли, версия в подвале демо mcprig 0.6.5.

Что не проверено

  • контраст raven на новых блоках списка (разметка на готовых токенах);
  • схемы кроме dark и Win98;
  • боевая панель под паролем: те же маршруты проверены на локальном инстансе с
    релизным бинарём.

Риски

  • Маршрутизация общая для всех экранов; автовыбор первого набора из новой ветки
    исключён намеренно, это покрыто проверками #/ и #/sets.
  • web/codemap.md уже отставал от PR Панель: адреса вкладок набора и обзор хоста (#7, #8) #31 по номерам строк; обновлена только
    секция экранов, остальное записано в долги отчёта.

Долги, закрытые в ветке

docs/debts.md — список долгов из аудита 2026-11-18. Ветка закрывает D1–D13
(D9 был решением раньше), у каждой правки есть тест, падающий без неё:

  • D10 — reload отдавал слушателю новые ключи до того, как менеджер откатит
    наполовину применённый конфиг, и ключ принимался без профиля. Теперь reload
    идёт первым, SetAuth — только когда перезапуск никому не нужен.
  • D12 — текст ошибки апстрима уходил модели, в счётчики и raw-*.jsonl без
    маскировки; теперь он чистится так же, как ответ, секретами всех серверов
    набора.
  • D11 — GET /stats отдавал полный снимок всякому, у кого есть ключ
    набора; теперь его получает только опрос самой панели
    (X-MCPRig-Caller: panel), ключ — счётчики с метками (аноним) и пустыми
    текстами ошибок.
  • D13 — имя тега подставлялось в текст run:-блоков, где лежат write-токен
    и пароль реестра; теперь тег приходит через env: и читается как "$TAG",
    checkout релиза не оставляет учётных данных. Теги v* защищены на обоих
    хостах (ruleset protect release tags на GitHub, tag protection в Gitea,
    whitelist sintez).
  • D1 — карта троттлинга каталога выметает метки старше своего окна в 5 с.
  • D3 — удаление набора чистит его состояние вебхуков, как runtime и здоровье.
  • D5 — неудачные входы убирают просроченные окна при каждой записи, карта
    ограничена 1024 записями.
  • D2 — паника внутри пробы здоровья больше не оставляет single-flight
    ожидание открытым навсегда: лидер восстанавливается, закрывает ожидание и
    пишет одну строку в журнал.
  • D4 — секреты маскируются по значению, а не по имени поля: маскируется
    любое значение env и заголовков от 8 байт, GITHUB_PAT и CF_ACCESS тоже.
  • D6 — 26-шаговая приёмка панели идёт в CI на свежесобранном бинаре;
    ACC_DAP стал необязательным, 11 шагов со stdio-сервером пропускаются со
    строкой в выводе.
  • D7 — кэш статистики вытесняет старейшую четверть по mtime, а не
    сбрасывает карту целиком.
  • D8 — оказался решением: метка «— запуск —» относится к старту процесса,
    единственный вызов Writer стоит за exec.Command, живая сессия до него не
    доходит.

Ворота на итоговом дереве: gofmt, go vet, go build чисто;
go test ./... -race -count=1 -p 1 — 736 passed в 19 пакетах;
golangci-lint run — 0 issues; bash scripts/docs-check.sh — 5/5;
приёмка панели с ACC_DAP — 37 шагов, failed: 0; job acceptance в CI —
зелёный на раннере за 5 мин 21 с (26 шагов, 11 пропущены).

… вызовов

Приёмка 0.6.5 нашла четыре расхождения. Неизвестный маршрут и #/sets открывали
набор, выбранный последним: списка наборов в панели не было вовсе. Теперь #/sets —
настоящая страница списка (имя, порт, состояние, серверы, ключи), а шапка и
вкладки набора в ней скрыты. Заголовок окна называет страницу, а набор — только на
его странице, с добавкой вкладки. Mock отвечает version 0.6.5, как живой API.
«Latest calls» на обзоре хоста при ширине ≤ 760 px читается карточками: время и
статус, набор и сервер, инструмент и длительность.
Выбор набора — клик в рейле, создание набора, сосед после удаления — писал адрес
и переключал страницу только когда панель уже стояла на странице наборов. С
обзора хоста клик менял лишь заголовок окна, и на чистой установке вкладки набора
были недостижимы: нет вкладок — нет ни серверов, ни ключей, ни логов.

- web/app.js: осознанный выбор открывает страницу набора сам (applyPage('sets')
  и адрес #/set/<id>); автовыбор первого набора и загрузка на #/ страницу не
  трогают, поэтому обзор хоста и список #/sets остаются как были
- web/codemap.md: секция экранов приведена к текущему коду (pageOf/routeOf,
  applyPage, route с hashchange, select/setTab/setHash/setTitle)
- docs/history/audits/2026-11-17-panel-acceptance.md: разбор жалобы «через гуй
  настроить ничего нельзя, ничего не сохраняется» с воспроизведением на чистой
  установке, корнем и таблицей проверок
- CHANGELOG.md, CHANGELOG.ru.md: строка в [Unreleased]
setState отдаёт «ok|err|warn», badgeState — «badge-ok|badge-err|badge-unknown»,
а paintBadge склеивал «badge » + cls. Для setState получался класс «badge ok»,
которого в CSS нет, и состояние набора рисовалось чёрным кружком в списке
наборов, на обзоре хоста и в таблице серверов.

Теперь префикс badge- добавляется только если его нет; проверено на демо:
badge-ok зелёный (67,196,139), badge-err красный (242,119,110).
Диалог лога сервера в панели всегда отвечал «0 lines»: он фильтровал лог
набора по имени сервера, а stderr запущенного процесса жил только в
четырёхкилобайтном кольце в памяти.

Теперь хвост stdout+stderr пишется в sets/<id>/serverlogs/<имя>.log
(256 КиБ, стирается при остановке набора), а ServerLogs отдаёт его вместе
со строками набора. Тесты: кольцевой хвост, очистка при остановке, e2e с
живым stdio-сервером.
…ляются

Жалоба «через гуй настроить ничего нельзя» сведена к трём причинам, каждая
воспроизведена на чистой установке:

- клик по набору в рейле и создание набора меняли только заголовок окна,
  потому что select() писал адрес лишь со страницы наборов;
- после выдачи или отзыва ключа список не перерисовывался до такта: ветка
  loadState() без смены набора не трогала ни ключи, ни инструменты;
- ответы /api/state ходят внахлёст, и более старый откатывал состояние.

Плюс правки по приёмке каждый модуль: копирование адреса больше не вынимает
#endpoint из кнопки, удаление открытого набора возвращает к списку,
статистика по прямому адресу грузится сразу, фильтры переживают перезагрузку,
пустая задача в промте даёт отказ, выдача и отзыв ключа пишут, что идёт
работа.

Внешнее ревью GUI (18 замечаний): win98 держит цели 32 px на узких экранах,
nord --ok поднят до AA, границы полей через новый токен --field-line, плитки
и таблицы обзора приведены к одной иерархии, лог не рвётся посреди токена.
Отчёт приёмки дополнен разделами про гонку состояния, лог сервера, цели
нажатия и разбор 18 замечаний внешнего ревью; в отчёт полевого теста вписан
прогон набора ha на боевой панели (8 серверов, 969 инструментов, probe,
ключ, MCP по ключу). Руководства en/ru: страница статистики, удаление
набора, устройство лога сервера.
…хвоста

Ревью четырьмя полосами блокеров не нашло, но нашло регрессию и тихие сбои:

- прямая ссылка на #/set/<id>/<tab> и F5 оставляли страницу полупустой:
  пропала boot-ветка выбора набора, каталог и профили ключей ждали такта;
- причина провала и простоя была урезана прямо в разметке, поэтому нажатие
  на тач-экране не раскрывало ничего — текст целиком в DOM, режет только CSS;
- удаление открытого набора писало соседа в адрес до возврата к списку;
- ветка отзыва ключа наследовала стиль прошлой ошибки и молчала, если
  обновление состояния не удалось;
- хвост сервера: отказы открытия, записи и обрезки теперь видны в логе набора,
  запись больше лимита не выводит файл за потолок, путь на чтении проверяется
  так же, как на записи, длина чтения из ReadAt учитывается;
- mcprig logs больше не печатает управляющие последовательности сервера.

Добавлен тест прав хвоста (0600 файл, 0700 каталог). Ворота: build/vet, тесты
девятнадцати пакетов, golangci 0, docs-check 5/5, node --check.
Comment thread internal/downstream/serverlog.go Fixed
Comment thread internal/downstream/serverlog.go Fixed
Comment thread internal/manager/runtime.go Fixed
Первый loadState() без обработки отказа обрывал цепочку, и все таймеры
(состояние, здоровье, лог, переменные) не заводились вовсе: панель замирала
до перезагрузки. Отказ теперь показывается, а таймеры стартуют.

copyText больше не падает на пустой кнопке.
Лог сервера:
- каждый запуск процесса открывает метку «— запуск <время> —»: перезапуск
  после падения больше не выглядит первым стартом;
- нечитаемый хвост приходит полем error, панель печатает причину вместо
  тишины; тесты на маркер, отказ чтения и отбор строк по имени целиком.

Наборы:
- POST /api/sets больше не переименовывает набор молча: id берётся как есть,
  имя вне шаблона — 400 с правилом; панель приводит имя к виду в форме.

Панель:
- отказ первого /api/state не останавливает таймеры;
- клик в такт синхронизации показывает «идёт операция», а не молчит;
- статистика по прямому адресу добирается сама;
- copyText не падает на пустой кнопке;
- поведение stateSeq описано комментарием.
Comment thread internal/manager/setconfig.go Fixed
Запуск набора сразу после его создания попадал в общий такт: обработчик
видел st.busy и выходил, кнопка оставалась «Запустить». Теперь «Запустить»,
«Остановить», «Перезапустить» и привязка сервера ждут до 4 с и выполняются,
а если такт не кончился — плашка «идёт операция».

test(web): каждый id, который app.js берёт через $('…'), обязан быть в
index.html — опечатка в id раньше всплывала только живым кликом.
- `mcprig logs --panel 127.0.0.1:9091` больше не падает на разборе URL:
  схема добавляется, если её нет.
- хвост сервера: режим существующего файла доводится до 0600, а отказ чтения
  отдаёт имя файла внутри набора, не абсолютный путь каталога данных.
- приёмка панели переехала в репозиторий: `scripts/acceptance/panel.cjs`
  (37 шагов) и раздел в docs/en|ru/dev/development.md.
- `web/ids_test.go`: id, который app.js берёт через $('…'), обязан быть в
  index.html.
Comment thread scripts/acceptance/panel.cjs Fixed
Шаг Y3 создавал пустой набор на порту 9191; остатки прошлых прогонов держали
этот порт, набор не создавался, и шаг падал как «нет пустого состояния».
Порт больше не задаётся — панель берёт первый свободный. Четыре прогона
подряд: 37/37 каждый.
- clearServerLogs проверяет имя набора через safepath.Name и отказывает вне
  шаблона вместо склейки пути с неконтролируемой строкой.
- warn хвоста сервера и ошибка очистки идут через safelog.Value.
- приёмка пишет отчёт только по ACC_OUT и с правами 0600 вместо жёсткого
  /tmp/opencode/lane-a.json.
return
}
if err != nil {
l.log.Warn("хвост сервера: "+what, "server", safelog.Value(server), "err", safelog.Value(err.Error()))
l.log.Warn("хвост сервера: "+what, "server", safelog.Value(server), "err", safelog.Value(err.Error()))
return
}
l.log.Warn("хвост сервера: "+what, "server", safelog.Value(server))
Comment thread internal/manager/runtime.go Fixed
На 375 px подпись кнопки адреса занимает 67 px, а слова отклика — до 132,
и кнопка прыгала на глазах. Теперь на узком экране отклик — знак, а ширина
кнопки держится 74 px; подпись помечена aria-live, чтобы смена читалась
скринридером.
Прежний снимок показывал `12.5% ERROR RATE` и сервер `broken` в селекте —
для витрины README это приглашение к вопросам. Новый кадр снят с живой панели
на чистом наборе: три набора на своих портах, четыре healthy-сервера, 32
настоящих вызова за 7 дней и 0.0% ошибок, числа в шапке, таблице и футере
сходятся. Прежний кадр — в `design/ui/archive/panel-0.6.x.png`, подпись под
картинкой уточнена в обоих README.
Ревью старшего разработчика и аудит репозитория дали Must и Should; всё
закрыто в этом же коммите, без списка «потом».

Журнал сервера: метка «— запуск … —» пишется на каждый запуск и после обрезки
по лимиту, а не только в новый файл; хвосты чистятся на первом запуске набора,
а автоперезапуск после падения дописывает в тот же файл — иначе трейс падения
исчезал через секунду, то есть в самом частом случае. Журнал набора и CLI
теперь отдают и печатают причину нечитаемого файла вместо «журнал пуст».

Безопасность: X-Forwarded-* от loopback-пира принимались по одному лишь
MCPRIG_PROXY_SECRET, без сверки заголовка x-mcp-proxy-secret, — лимит попыток
входа обходился с того же хоста. Файл .owner выгрузки инструмента создаётся
эксклюзивно.

Панель: удалённый набор освобождает кольца, замки и нонсы; плитки показывают
прочерк там, где число неизвестно (а не ложный ноль); подпись диалога журнала
описывает формат верно; вкладка журнала показывает причину отказа чтения.

Прочее: общая грамматика ${VAR} (config.EnvRefs / ExpandEnvRefs) вместо трёх
регулярок, общая обрезка по границе руны (stats.cutRune), portFree ждёт до
секунды на TIME-WAIT вместо мгновенного «порт занят», safelog.Text сохраняет
табуляцию в выводе `mcprig logs`, восстановлены два выпавших теста панели,
id набора берётся как есть, приёмка требует ACC_DAP и не глушит таймауты.

Тесты: e2e проверяет контракт хвоста (после stop строки живы, после start одна
метка и одна строка процесса), TestAddSetTakesIDAsTyped, TestServerLogsMarkStart,
TestServerLogsReportReadFailure, TestServerLogsFileIsPrivate, TestTextKeepsTab.

Документация: docs/en|ru/panel.md (контракт хвостов, порядок слияния строк, поле
error, x-mcp-proxy-secret), раздел аудита про четвёртый проход, CHANGELOG EN+RU.
if w.log == nil {
return
}
w.log.Warn("хвост сервера: "+what, "server", w.server)
// через секунду после падения, то есть в самом частом случае.
if restarts == 0 {
if err := clearServerLogs(rt.dataDir, set.ID); err != nil {
rt.log.Warn("хвосты серверов не удалены", "set", safelog.Value(set.ID), "err", safelog.Value(err.Error()))
Карты разъехались после закрытия находок: `Logs`/`ServerLogs` теперь отдают
`error`, появился `Forget`, `portFree` ждёт TIME-WAIT, `x-mcp-proxy-secret`
сверяется до адреса пира, `clearServerLogs` живёт под `restarts == 0`, id набора
больше не слагифицируется, а у `safelog` есть `Text` для вывода с колонками.

Обновлены корневая карта, `cmd/mcprig`, `internal/{config,downstream,manager,
mcpserver,registry,safelog,stats}` и `web/`: пересчитаны ссылки file:line,
описано поведение хвостов сервера и выгрузки инструментов, из `web/codemap.md`
убран раздел о расхождениях с `panel.md` — их больше нет.
Record the ten findings of the manual repository audit as debts: three to close
before 0.6.6 (unbounded login-failure map, refresh throttle without TTL, pinned
release in README), seven to track afterwards. Add the audit to the archive index
and keep CURRENT-GOAL as the place where the next session picks them up.
- находки полного аудита и независимого свежего аудита 2026-11-18 сведены
  в один файл: D1-D9 открытые, закрытый README, два решения (кнопка ключа,
  loopback-приёмник OAuth)
- CURRENT-GOAL.md «Долги» теперь указатель на файл, а не второй список
- строка в docs/history/index.md ведёт на файл долгов
Тег подставлялся выражением внутрь run-блоков job релиза и job образов
Gitea — там, где лежат write-токен и пароль реестра. Теперь он приходит
через env (TAG, REF) и читается как "$TAG"/"$REF"; checkout релиза идёт с
persist-credentials: false.

Долг D13 (docs/debts.md). Права на пуш тегов v* остаются фактом хостинга:
правка применена, права не подтверждены.
Переполнение fileCache (4096 файлов) сбрасывало карту целиком, поэтому
страница статистики за архив платила полным перечитыванием. Теперь
вытесняются записи с самым старым mtime файла — четверть карты за раз,
как у корзин rate limit.

Долг D7 (docs/debts.md).
GET /stats набора отдавал полный снимок всякому валидному ключу: метки
клиентов и тексты ошибок апстрима читал любой держатель ключа набора.
Теперь полный снимок получает только служебный вызов панели
(X-MCPRig-Caller: panel, его ставит fetchSetStats), остальные — редакцию:
счётчики и задержки на месте, метки (аноним), тексты ошибок пусты.

Тесты: TestStatsRedactedPerCaller (ключ видит редакцию, панель — полный
снимок), TestStatsNeedsTokenAndNeverLeaksIt переведён на новый контракт.
access_test.go ходит за меткой подписи служебным вызовом — так же, как
панель.

Долг D11 (docs/debts.md).
@akrhin
akrhin force-pushed the fix/panel-acceptance branch 2 times, most recently from d8061c4 to 8f23b1c Compare November 18, 2026 14:01
…орка меток

D10. reloadOnce ставил SetAuth до mgr.Reload: при транспортных полях, которые
Reload откатывает, слушатель успевал принять новый ключ, а профиль оставался
старым — ключ без профиля. Теперь Reload первым, SetAuth только когда
RestartNeeded пуст, иначе одна строка Warn. Тесты:
TestReloadRejectsKeyWhileProfilesRolledBack (новый ключ получает 401),
TestReloadAppliesKeyAndProfileTogether (ключ сразу под своим профилем).

D12. Текст ошибки апстрима шёл мимо маскировки: scrubSecrets чистил только
результат, а ошибка попадала в errResult и в счётчики сырой. Теперь err
маскируется после решения о повторe, а recordMeta чистит мета-ошибку
объединением секретов всех серверов (allSecrets). Тесты:
TestInvokeCommandMasksSecretInProtocolError, TestMetaStatsMaskUpstreamSecret.

D1. refreshAt рос всю жизнь процесса: метки старше catalogRefreshEvery уже
ничего не подавляют. Теперь sweepRefresh выметает их каждые 1024 записи или
при потолке 4096. Тест: TestMayRefreshSweepsStaleMarks.

Долги D10, D12, D1 (docs/debts.md).
…без имён

D2. Паника в пробе здоровья оставляла single-flight открытым: лидер умирал до
close(wait), и каждое следующее обращение к набору висело до перезапуска
панели. Теперь пробу зовёт loadGuarded: recover, один Warn, wait закрыт, вид
пуст — следующий запрос повторит пробу. Тест:
TestHealthCachePanicDoesNotHang.

D3. Удаление набора не забывало переходы webhook'а (ключ «набор/сервер»):
новый набор с тем же id молча не получал предупреждений. notifier.clearSet
рядом с rt.Forget. Тест: TestNotifyStateClearedOnDelete.

D4. Маскирование опознавало секрет по имени поля, поэтому GITHUB_PAT и
CF_ACCESS уходили в каталог и в ответы открытым текстом. Фильтр имени снят:
маскируется любое значение env/headers от 8 байт (Bearer снимается).
Тест: TestSecretsMasksEveryValue.

D5. Карта неудачных входов чистила просроченные окна только после 1024
записей и не имела потолка по живым. Теперь просроченные убираются при каждой
записи, сверх loginFailsMax=1024 вытесняется запись с самым ранним окном.
Тесты: TestLoginFailsMapBounded, TestLoginFailsDropsExpired.

Долги D2, D3, D4, D5 (docs/debts.md).
Приёмка панели не запускалась в CI: без ACC_DAP скрипт падал с exit 2, а
stdio-сервера в раннере нет. Теперь DAP-шаги (U1–U5, V1–V3, W1–W3)
пропускаются с явной строкой, итог печатает skipped, остальные 26 шагов
выполняются.

Новый job acceptance (timeout 8 минут): свежесобранный бинарь, панель на
свободном порту 9100–9189 (9190 скрипт держит свободным для набора beta),
Playwright Chromium, ACC_BASE, снос панели по trap, лог панели при провале.

Проверено локально дословным прогоном блока: total 26, skipped 11, failed 0.
Сам раннер (playwright install --with-deps, sudo/apt) остаётся
needs_validation — первый настоящий прогон на PR.

Долг D6 (docs/debts.md).
docs/debts.md: D1–D7 и D10–D13 переехали в «Закрытые» со ссылками на
коммиты; D13 помечен «права не подтверждены» (protection rules живут на
хостинге), D6 — «needs_validation до первого прогона на PR» (сам раннер).

docs/en|ru/architecture.md: строка таблицы reload про токены описывает одно
поколение профилей и ключей; раздел транспорта — полный снимок /stats только
служебному вызову панели.

docs/en|ru/panel.md: /api/calls помечает свой опрос как служебный вызов.

docs/en|ru/dev/development.md: приёмка панели — 26 шагов в CI, 37 с ACC_DAP.

docs/history/index.md: #40 закрыт тестом, а не открыт.
docs/CURRENT-GOAL.md: волны долгов вместо старого порядка D2/D3.

CHANGELOG.md и CHANGELOG.ru.md: строки по D1–D7, D10, D12 (D11 и D13 — в
своих коммитах).
D6: job `acceptance` зелёный на реальном раннере — прогон 44316150632,
13:40:49 → 13:46:10Z (5 мин 21 с из 8), 26 шагов, `failed: 0`.

D13: по API обоих хостов protection rules не было (`tag_protections` и
`branch_protections` в Gitea — пусто, `rulesets` на GitHub — пусто), то
есть любой с правом записи мог запушить `v*`. Правила поставлены:
ruleset `protect release tags` (27553037, creation/update/deletion для
`refs/tags/v*`, обход — только admin) и tag protection Gitea (id 1, `v*`,
whitelist `sintez`).

Ссылки на коммиты после перезаписи истории: `93f82a2` → `cf8c130`,
`fd75b48` → `edebeb8`, `4eb30b4` → `63ae976`.
TestHealthLoopLogsWithoutAPI ждал 50 мс между тиками: под нагрузкой окно
«здоровья» проскакивало, и переход unhealthy→healthy не попадал в журнал.
Тест теперь ждёт, пока сама проба увидит сервер здоровым (счётчик в probe,
дедлайн 3 с), и только потом возвращает отказ.

Шаг X1 приёмки ждал роста количества строк в списке ключей: после
перезапуска набора sync перерисовывает список, и количество врёт. Теперь
шаг ждёт появления конкретного id ключа, которого не было до выдачи
(60 с), и сверяет его с состоянием набора.
@akrhin
akrhin force-pushed the fix/panel-acceptance branch from 8f23b1c to 7965063 Compare November 18, 2026 14:02
Перезапись нужна была из-за gitleaks: поддельный ключ в тесте редактора
принимался за настоящий. Итоговые номера: D10/D12/D1 — 0dfb26d, D2–D5 —
d9e1198, D6 — 04a607a; D13, D7, D11 не переписывались.
@akrhin
akrhin merged commit d3d518e into master Nov 18, 2026
12 checks passed
@akrhin
akrhin deleted the fix/panel-acceptance branch November 18, 2026 14:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants