diff --git a/docs/mcp-completion-plan.md b/docs/mcp-completion-plan.md index c9d0c031..4a9e144c 100644 --- a/docs/mcp-completion-plan.md +++ b/docs/mcp-completion-plan.md @@ -85,6 +85,7 @@ - [ ] EXTERNAL-UI: приёмка подписанного защищённого восстановления - 2026-11-21, диагностика на `29998815` (пакет `tmp/mcp-c2c4-restore58-29998815-20261120/`): операторская цепочка на Linux от `init` до двух реплик backend пройдена при двух отступлениях — JIT PostgreSQL выключен, восстановление через REST вместо MCP. - Ждёт решения владельца по двум находкам: JIT против лимита 5 с захвата каталога; MCP-восстановление под карантином на свежем журнале всегда `blocked`. Подробности в `mcp-stand-run-c-plan.md`, раздел 2.7. + - 2026-11-21: обе исправлены в продукте по решению владельца (`11537c99`, образ backend Gitea 2746 `fed349a6…`); после `complete` по MCP добавлен штатный `maintenance-resolve`. Приёмочный прогон ждёт доставки образа на VPS. - [x] DB-3: перенос непустой legacy-базы — **закрыто как ограничение (решение владельца 2026-11-17): контрольный путь не принимает старые установки, обновление идёт legacy-путём (проверено на `mmapp-test`, 12 → 57 миграций, данные целы).** Продуктовый путь не разрабатывается; см. раздел «Решения владельца 2026-11-17 по прогонам B и C» - [ ] DB-4: настоящие POSIX-права целевой среды - 2026-11-21, диагностика C4 на `29998815`: 0640, 0604, каталог чужого UID, символьная ссылка и `init` в существующий каталог отклонены до подключения к БД (0 подключений по журналу PostgreSQL), точные причины записаны. Засчитывается вместе с приёмочным прогоном C2 (`mcp-stand-run-c-plan.md`, раздел 2.7). diff --git a/docs/mcp-database-maintenance.md b/docs/mcp-database-maintenance.md index 7693c216..633e234c 100644 --- a/docs/mcp-database-maintenance.md +++ b/docs/mcp-database-maintenance.md @@ -81,5 +81,10 @@ node backend/dist-operator/database-writer-profile-operator.mjs maintenance-insp 2. Зафиксируйте допуск командой `db:stage-restore-checkpoint `. Операторский `db:serve-restore-claims` выдаёт одноразовый допуск уже работающему backend через локальный сокет. Выполните одно утверждённое восстановление. Проверьте `db:inspect-restore-checkpoint` и дождитесь состояния `applied-consumed` перед дальнейшими действиями. При неопределённом ответе начните с инспекции. 3. На остановленном backend выполните `source-catalogue-inspect` в защищённом операторском процессе. Используйте те же `--bootstrap`, `--transport` и `--definition` с соответствующими SHA-256, а также `--ca`, `--source-registry`, `--source-spki-sha256`, `--activation-directory` и `--activation-sha256`. Команда возвращает `headSha256`, `previousCatalogSha256` из подписанной записи и `catalogSha256` фактического каталога. Утвердите результаты отдельно. Передайте их в `upgrade` с разрешением `application-writer-rebind58-after-restore-approval-v1`, используя `headSha256` как `expectedHeadSha256`. Публикация создаёт новый подписанный head на том же источнике и сохраняет предыдущую запись. 4. С тем же UUID операции и SHA-256 применённого журнала выполните `db:seal-restore-checkpoint`, затем `db:complete-restore`. Запустите backend штатно и проверьте готовность. Сверка данных, новый подписанный head и завершение контрольной точки подтверждаются независимо. +5. Если восстановление выполнялось через MCP, после `db:complete-restore` старт backend остаётся закрытым (`EXTERNAL_OPERATION_UNRESOLVED`). Причина: внешняя квитанция `applied` содержит предупреждение `maintenanceError` о сохранённом до внешней записи карантине. На остановленном backend выполните `maintenance-inspect`, проверьте результат, оформите одобрение формата `database-maintenance-current-state-approval-v1` и выполните `maintenance-resolve`. Только после этого запускайте backend. Восстановление через REST внешней квитанции не создаёт, и этот шаг для него не нужен. + +Захваты каталога продукта (runtime и операторские команды) выключают JIT PostgreSQL на время своего сеанса. На PostgreSQL 18 с настройками по умолчанию одна компиляция запросов каталога могла превысить фиксированный лимит 5 с. Настраивать `jit` на сервере для этого не нужно. + +Первая отклонённая MCP-попытка восстановления (`blocked`) или прерванная до захвата архива (`running` без `.used`) не блокирует старт при отсутствующем журнале. Отметкой попытки при отсутствии журнала считаются только `.used` и квитанции `applied`/`unknown`. Локальная приёмка на одноразовой PostgreSQL подтверждает конкретные SQL- и TLS-проверки. Для рабочей установки отдельно сверяются источник, операторская активация, учётные записи и журнал. diff --git a/docs/mcp-stand-run-c-plan.md b/docs/mcp-stand-run-c-plan.md index e162381e..cc4c84b0 100644 --- a/docs/mcp-stand-run-c-plan.md +++ b/docs/mcp-stand-run-c-plan.md @@ -152,6 +152,22 @@ - **Побочный эффект:** после такого отказа в хранилище остаётся отметка `blocked`. Без инспекции (`maintenance-inspect`/`resolve`) повтор, в том числе через REST, тоже отказывает. - **Обхода через UI нет:** у UI нет восстановления в обход MCP, а маршрут `app/api/system/database/restore` ни один компонент не вызывает. +**Решения владельца (2026-11-21) и исправление.** + +- **Находка 1:** исправить в продукте. Захваты каталога выключают JIT: runtime ставит `SET LOCAL jit = off` в снимке каталога (`database-runtime-schema.ts`) и в контролируемой схеме, оператор передаёт `-c jit=off` в `STARTUP_OPTIONS` (все операторские сеансы, включая `maintenance-resolve`). +- **Находка 2:** исправить в продукте шире. На фикстуре подтвердилось, что одна квитанция `blocked` (или `running` после сбоя) без `.used` при отсутствующем журнале навсегда закрывает старт backend любой установки, и `maintenance-resolve` это не снимает. Теперь отметкой попытки при отсутствии журнала считаются только `.used` и квитанции `applied`/`unknown`. +- **После `complete` по MCP:** штатные `maintenance-inspect` и `maintenance-resolve`, без изменения продукта. Квитанция `applied` с `maintenanceError` по замыслу (есть тест) закрывает старт до принятия оператором. Порядок описан в `mcp-database-maintenance.md`, шаг 5. +- **Коммит и проверки:** `11537c99`. + - Тесты: стартовая инспекция 20/20 (новый случай), оператор 8/8, `maintenance-resolution` 17/17, новый тест снимка каталога, все 24 файла профиля `test:system-database` по отдельности. Зависающий на Windows `database-background-work.test.ts` к правке не относится. + - `tsc --noEmit` проходит. + - Сопровождаемый сценарий `--owned-source58-publication` даёт тот же каталог `4bac0202…`. +- **Образ:** Gitea 2746, backend `git.shx.one/denozord/mikrotikmanager-backend-mcp-acceptance@sha256:fed349a6…`. Frontend остаётся `921ba5e2`, он не менялся. +- **Пакет C2/C4 для приёмки:** + - на сервере PostgreSQL JIT по умолчанию, без фазы `jit-off`, `prepare` без `ANALYZE`; + - восстановление из Edge через MCP; + - три проверки отказа старта: `checkpoint`, `state`, `maintenance`; + - `maintenance-resolve`, затем две реплики и C4. + **Мелкие находки:** - `inspect-database-schema.js` при отказе печатает необработанный стек вместо одного сообщения.