Files
MikrotikManager/docs/mcp-stand-run-c-plan.md
T
DenozordecandClaude Opus 5.5 9ebbf036c8 chore(docs): исправления C2 — JIT, отметки попытки и maintenance-resolve после MCP
Решения владельца от 21.11 и порядок для оператора: после complete
MCP-восстановления с внешней контрольной точкой — maintenance-inspect и
maintenance-resolve; захваты каталога выключают JIT; квитанции без .used
не закрывают старт при отсутствующем журнале. Образ backend Gitea 2746.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-11-21 01:12:22 +07:00

67 KiB
Raw Blame History

Прогон C этапа 3: план стендовой приёмки внешнего интерфейса и БД на целевом Linux

Составлен 17 ноября 2026 года только чтением репозитория и tmp/. VPS, CHR и Gitea не затрагивались: SSH, Docker, REST и скрипты, включая режимы --check, не запускались. Пункты плана взяты из плана завершения, раздел «Этап 3», абзац «Прогон C». Форма документа повторяет план прогона A.

Обозначения: [ист.: файл] означает, что факт прочитан в указанном файле; [вывод] означает вывод автора плана, на стенде он не проверен. Пароли, ключи и токены в документе отсутствуют намеренно.

Главный вывод. Из четырёх пунктов прогона C готовый пакет есть только у одного: сквозного прогона на образах CI2736. Но он привязан к образам с 56 миграциями, которые на VPS, скорее всего, отсутствуют, а сам пакет ни разу не запускался. Приёмка подписанного защищённого восстановления и DB-4 сводятся к одному новому Linux-пакету на основе локального сценария --owned-restore58-ready, в котором подделка POSIX-проверки заменена реальной. DB-3 в текущем продукте выполнить нельзя. Единственный реальный legacy-артефакт — дамп с 12 миграциями. Контролируемый путь миграций отказывает непомеченной базе с префиксом 0. Цепочка legacy-* требует ровно 36 миграций и доступна только через тестовые раннеры. Нужно решение владельца (D-C4). Пункт «восстановить SSH к VPS» выполнен: вход по ключу через алиас mm-vps под root [ист.: постановка задачи].

1. Цель и критерий «принято» по пунктам

Цель: за одну или две сессии на mm-vps закрыть пункты прогона C. Каждый пункт пишет отдельную квитанцию; failed и unknown не перекрашиваются [ист.: mcp-completion-plan.md, этап 3]. Все сценарии работают в собственных изолированных проектах Docker и не меняют mmapp-test. CHR не затрагиваются: ни один сценарий не использует реальный маршрутизатор [ист.: ci2736-owned-portal-browser/README.md, шаг 4: «No real router or provider account is used»].

# Пункт «Принято» означает Квитанции
C0 EXTERNAL-UI: восстановить SSH к тестовому VPS Выполнено до плана: ssh mm-vps по ключу под root работает. В плане остаётся только сверка отпечатка ключа хоста в шаге 1.1 Отметка в mcp-completion-plan.md (владелец или координатор)
C1 EXTERNAL-UI: сквозной прогон на образах CI2736 (или преемнике по D-C1) Четыре сервиса (Manager backend и frontend, Portal, PostgreSQL) подняты из образов, привязанных к OCI-дайджестам, в новом пустом проекте; число миграций в базе равно заявленному. Браузер Edge через три SSH-проброса создаёт синтетического владельца Portal. Он подтверждает и исполняет одно глобальное изменение настроек логов, открывает шаг операции и перезагружает его URL. Затем отключение в Portal даёт подписанное HTTPS-событие. Проверяются точный HTTP 401 без деталей операции, одна навигация на вход Portal, отсутствие старого шага, аудит подписанного отзыва и отказ установленному SDK. Раннер подтвердил очистку проекта и томов, прежние контейнеры не изменились browser-result.json (неконфиденциальный), терминальная квитанция раннера. Сценарий: [ист.: ci2736-owned-portal-browser/README.md, шаги 1–6]
C2 EXTERNAL-UI: приёмка подписанного защищённого восстановления На целевом Linux, в собственном PostgreSQL 18 с TLS и пятью ролями (runtime, operator, capture, publisher, control), выполнена процедура «Подтверждённое восстановление с подписанным профилем source58». Утверждённые хеши архива и данных проходят через db:stage-restore-checkpoint, одноразовый допуск выдаётся через db:serve-restore-claims, одно восстановление доходит до applied-consumed. source-catalogue-inspect и upgrade (rebind) дают новую подписанную эпоху; затем выполняются db:seal-restore-checkpoint и db:complete-restore. Новый процесс отклоняется при consumed и до rebind; seal отклоняется до новой эпохи; запуск отклоняется до complete. После снятия карантина два новых процесса backend проходят штатный старт, и защищённая запись (PUT /api/logs/settings) возвращает новое значение. Подменённый архив отклоняется. Отличие от локальной приёмки: platformFilesVerified=true, то есть реальные POSIX-файлы вместо синтетического подтверждения. Плюс браузерная часть (по D-C8): само восстановление запускается из Edge (загрузка PGDMP, план с точным хешем, одно подтверждённое apply), как в принятой UI2-приёмке, но с заданными DATABASE_RESTORE_ARCHIVE_SHA256 и DATABASE_RESTORE_DATA_SHA256. Тогда служебный журнал database-maintenance.jsonl содержит записи с HMAC, и readMaintenanceRecoveryFacts(...).authenticated = true. Прежняя UI2-приёмка дала signedProtectedJournal:false, и передача прямо пишет, что «отдельная приёмка подписанного служебного журнала защищённого восстановления остаётся открытой» [ист.: tmp/mcp-ui2-restore-mounted-20261115/result-owned-Dt6pur.json; run.mjs:171–177; backend/src/services/database-maintenance-startup.ts:127–155; mcp-evidence-statistics-20261101.md, стр. 100] Новая квитанция по форме restore58-ready-verification.json с platformFilesVerified=true и fixtureSourceAttestor=false (если решено D-C3), плюс браузерная квитанция по форме result-owned-*.json с signedProtectedJournal:true, applySubmissions:1, automaticRetry:false. Процедура: [ист.: docs/mcp-database-maintenance.md, раздел «Подтверждённое восстановление…»]. Локальный образец и его ограничения: [ист.: tmp/mcp-writer-restore58-owned/restore58-ready-verification.json: platformFilesVerified:false, readyAuthorized:false, fixtureSourceAttestor:true]
C3 DB-3: перенос непустой legacy-базы По критерию DB-3: внутренний верификатор и операторская инспекция связаны с исходным поколением, подтверждённые записи переносятся под блокировками без фиктивных маркеров и MAC, остальные явно unresolved. Нужны положительное восстановление и отказ при подмене. Всё это на реальной непустой базе старой схемы, а не на тестовой fixture [ист.: mcp-remaining-work-20261026.md, таблица DB-1…DB-4]. Сейчас невыполнимо без решения D-C4, см. блокер CB5 Зависит от D-C4
C4 DB-4: настоящие POSIX-права целевой среды На той же Linux-среде образов, что в C2: операторские файлы (bootstrap.json, signing-private.pem, транспорт, CA, журнал, каталоги активации и реестра) созданы с правами 0600 и 0700 от фактического UID процесса. Отрицательные случаи отказывают до подключения к БД: группа или остальные имеют доступ, чужой владелец, символьная ссылка, существующий каталог при init. Ключи и журнал не восстанавливают прежний действующий доступ; архив с объектами mmapp_control отвергается; ошибка или перезапуск не запускают потребителей [ист.: mcp-remaining-work-20261026.md, DB-4; mcp-db-offline-bootstrap.md, «Файлы и повторный запуск»; backend/src/services/database-dump-connection.ts, стр. 169–184] Квитанция пакета C2/C4 (общий прогон) с отдельным разделом posix, плюс вывод database-writer-bootstrap-operator.mjs init (только публичный отпечаток)

2. Предусловия и решения владельца

2.1. Факты о стенде на 17 ноября

  • mm-vps: Debian 13, ядро 6.12, ОЗУ 2 ГиБ (доступно около 1,1 ГиБ), диск 25 ГБ (свободно около 11 ГБ), Docker 29.8.2. Установка /opt/mmapp-test на образах mcp-5ec95a7c (Gitea, запуск 2738). База обновлена с 12 до 57 миграций по legacy-пути, схема mmapp_control пуста. Дамп до обновления: /root/backups/mmapp-test-pre-mcp-20261116T032408Z.dump (46 МБ), копия .env в /root/backups [ист.: постановка задачи; mcp-completion-plan.md, журнал 2026-11-16].
  • 16 ноября на VPS удалены кэш сборки и неиспользуемые образы старше 7 дней [ист.: mcp-completion-plan.md, этап 3, D7 плана A]. Остались ли образы CI2736 и Portal CI2586, не проверялось [вывод: вероятно, удалены или никогда не загружались. Передача от 15.11 говорит «локально нет контейнерного runtime, последний строгий SSH BatchMode к тестовому VPS отклонил вход», ист.: mcp-handoff-20261115.md, строка Portal / EXTERNAL-UI].
  • В базе mmapp-test два сервера: оба CHR прогона A [ист.: постановка задачи]. Значит, дамп до обновления тоже содержит эти серверы и их зашифрованные учётные данные [вывод].
  • Образ backend не задаёт USER, а compose mmapp-test не задаёт user:. Значит, штатно backend работает от root внутри контейнера [вывод по backend/Dockerfile и deploy/docker-compose.test.yml; фактическое /opt/mmapp-test/docker-compose*.yml не читалось].
  • В образе backend есть только backend/dist, backend/dist-operator и производственные зависимости. tsx, src и embedded-postgres отсутствуют [ист.: backend/Dockerfile]. Скрипты db:* из package.json вызывают tsx src/scripts/… и в образе не запускаются. Скомпилированные аналоги ожидаются в dist/scripts/ [вывод].

2.2. Блокеры, найденные в файлах

# Блокер Где видно
CB1 Пакет CI2736 привязан к старому снимку. binding.json: Manager a3bf3574… и Portal ef7bb79d… (CI2586), 56 миграций, runtimeRun:false; закреплены дайджесты четырёх образов в git.shx.one/…. Раннер «never pull images»: если кэша нет, подготовка останавливается. Текущий HEAD 5ec95a7c собран в CI2738 с 57 миграциями ci2736-owned-portal-browser/binding.json, README.md, runner.py:119–124
CB2 Локальные требования браузера. browser.mjs требует ровно Node v22.23.4 и Edge (channel: 'msedge') с закреплёнными зависимостями Playwright и SDK; проверяется assert.equal(process.version,'v22.23.4'). Наличие этой версии Node на Windows не проверялось browser.mjs:13, 78
CB3 Память. Лимиты compose CI2736: postgres 384 МиБ, backend 512 МиБ, frontend 160 МиБ, portal 256 МиБ, в сумме 1312 МиБ. Это больше доступных ~1,1 ГиБ при работающем mmapp-test (≈565 МБ). Прежний похожий прогон CI2678 v5 на том же VPS дал минимум 870 МиБ доступной памяти при меньшем наборе [ист.: mcp-current-progress.json, currentWholeInstallationPreviewLocalReview] compose.json
CB4 Для C2 и C4 нет Linux-пакета. Локальный run-owned.mts --owned-restore58-ready использует EmbeddedPostgres, исходники через tsx и синтетическое подтверждение платформы (стр. 315–316: «Synthetic attestor for the Windows-only integration; no POSIX/source registry acceptance»). Режим --owned-linux-cli есть, но требует Linux, Node 22 и непривилегированного пользователя (getuid()>0, стр. 61). Он описан как «Local evidence builder against a disposable database and synthetic signing key» tmp/mcp-writer-restore58-owned/run-owned.mts, стр. 1–5, 56–61, 315; tmp/mcp-writer-current57-local-tls/run-owned.mts
CB5 DB-3: продуктового пути для реальной legacy-базы нет [вывод из кода]. (1) executeControlledSqlMigrations вызывается только тестовым legacy-probe-handoff-execute-owned.mjs; штатный старт (bootstrap.ts) использует legacy applySqlMigrations. (2) На пустой контрольной истории baseline(prefix 0) отказывает при любых объектах public: «Legacy or unmarked application state cannot be enrolled». (3) Цепочка legacy-handoff-* требует истории ровно 36 миграций (exactHistory(...) !== 36). Довести базу до 36 умеет только тестовая applyLegacyProbeFixtureMigrations, которая «Never imported by application startup; no caller-selected migration ceiling». (4) Реальный артефакт — дамп с 12 миграциями, а таблицы журнала проб (0035, 0036), которые переносит цепочка 0037, в нём отсутствуют [вывод: миграции 0035–0036 позже 0012]. Значит, при любом пути журнал проб пуст, и «подтверждённых записей» для переноса нет. (5) Сама установка mmapp-test уже обновлена до 57 по legacy-пути и тоже не может войти в контролируемый путь (та же причина (2)). Владелец уже принял пункт (2) этапа 2: существующая БД с маркерами и без контрольной истории контролируемым путём не принимается, «это уже открытый пункт DB-3 про перенос непустой legacy-БД» [ист.: mcp-completion-plan.md, стр. 23, вывод (5)] backend/src/db/controlled-migrations.ts:47–53, 75–105; controlled-migration-history.ts:8–12; database-schema-control.ts:64; legacy-probe-fixture.ts:7–15; db/bootstrap.ts:62
CB6 Цепочка подписанного профиля требует многих операторских входов. Ключи init с утверждённым запросом и хешем, пять ролей с OID, TLS (CA, SPKI), реестр источника, каталог активации, утверждённые определения и одобрения application-writer-upgrade57-to58-approval-v1 и …rebind58-after-restore-approval-v1. В локальном сценарии их выпускает тестовая fixture с синтетическим ключом. На стенде нужен выпуск теми же командами dist-operator, но с реальными файлами docs/mcp-database-maintenance.md, стр. 76–85; docs/mcp-db-offline-bootstrap.md; docs/mcp-db-connected-publisher.md
CB7 Дамп содержит действующие CHR. Если на восстановленной копии запустить backend с планировщиком, он начнёт опрашивать CHR1 и CHR2 и помешает прогону A [вывод] Факт о двух серверах (2.1)

2.3. Решения владельца (чек-лист)

  • D-C1. Какие образы для C1. (а) Буквально CI2736: a3bf3574, 56 миграций, Portal CI2586. Нужно загрузить четыре образа по дайджесту из git.shx.one, если реестр их ещё хранит. (б) Перепривязать тот же пакет к образам CI2738 (HEAD 5ec95a7c, 57 миграций). Backend и frontend уже есть на VPS; Portal взять по дайджесту установленного mmapp-test-portal или CI2586. Меняются binding.json, migrationCount и пины, сценарий браузера остаётся прежним. Рекомендация: (б). Приёмка нужна на финальном кандидате, а CI2736 уже устарел на одну миграцию и ряд исправлений. Решение меняет формулировку критерия, поэтому оно за владельцем. Если владелец выберет (а), загрузка образов — отдельный MUTATING-шаг с обращением к Gitea (шаг 1.4).

  • D-C2. Память на время C1 и C2. (а) Остановить mmapp-test (docker compose stop) на время каждого окна C и поднять после. (б) Не останавливать и принять риск OOM. Рекомендация: (а), с окном вне фаз прогона A, которые используют приложение на VPS, и вне прогона B (B закрепляет pid контейнеров mmapp-test, см. план B, BB7). Откат: docker compose up -d в /opt/mmapp-test и сверка четырёх сервисов как в 1.2.

  • D-C3. Каким путём выполнять C2 и C4. (а) Перенести run-owned.mts --owned-restore58-ready в Linux-пакет по образцу пакетов POLL: локальная компиляция в JS, загрузка, запуск в образе backend установки от UID 65534. Вместо EmbeddedPostgres использовать собственный контейнер PostgreSQL 18 с TLS, а синтетическое подтверждение платформы заменить реальной проверкой POSIX-метаданных. (б) Оркестровать производственные команды образа (dist-operator, dist/scripts/*) против собственного проекта compose. Рекомендация: (а) как основной путь, (б) как необязательное дополнение. Путь (а) повторяет уже принятый локальный сценарий и меняет только платформу, путь (б) потребует новый драйвер всей цепочки. Что (а) использует тестовую обвязку, а операторские команды остаются производственными, фиксируется в квитанции [вывод].

  • D-C4. DB-3. Варианты [вывод]:

    • (а) Признать, что текущий продукт не переносит legacy-базы старше 0036 по контролируемому пути. Записать DB-3 в этап 4 как ограничение: legacy-база обновляется прежним путём, контрольная история начинается пустой.
    • (б) Продуктовая доработка новым слоем: операторская команда, которая под блокировкой записей и с аттестацией исходного поколения поднимает реальную legacy-базу с N < 36 до 36 с проверкой маркеров, затем выполняет существующую цепочку legacy-* и контролируемый хвост 0038–0057. Затем приёмка на копии реального дампа (12 миграций) в собственном PostgreSQL на VPS. Нужны две продуктовые части: (1) шаг N → 36 и (2) производственная точка входа для хвоста 0038–0057. Сейчас executeControlledSqlMigrations вызывается только тестовым раннером, а в списке команд dist-operator команды миграции нет [ист.: backend/scripts/build-database-operator.test.mjs:84 — перечень команд; controlled-migrations.ts:75].
    • (в) Принять DB-3 по существующей цепочке legacy-* на тестовой 36-миграционной fixture, но на целевом Linux с реальными POSIX-файлами. Это не «реальная» legacy-база.

    Рекомендация: (б), если владелец считает перенос старых установок обязательным для релиза, иначе (а). Вариант (в) не выполняет критерий «реальный исторический артефакт» [ист.: mcp-db-remaining-blocks-20261031.md, «Источник, архив и legacy»]. При (б) нужно учесть: журнал проб в этом дампе пуст [вывод, CB5(4)], поэтому «подтверждённых записей» будет 0, а перенос проверяется на остальных данных (серверы, настройки, история). Решение меняет критерий и поведение продукта, это вопрос владельцу.

  • D-C5. Обращение с дампом mmapp-test. Рекомендация: использовать его только на VPS. Копию восстанавливать в собственный PostgreSQL во внутренней сети Docker без выхода наружу (internal: true). Backend на копии не запускать, либо запускать без планировщика и без маршрута к CHR (CB7). Дамп с VPS не выносить, содержимое строк не печатать; после шага копия удаляется. Нужна только при D-C4 = (б).

  • D-C6. Кто подтверждает в Portal и Manager. Рекомендация: агент по D8 прогона A. Учётные записи синтетические (@example.test), их генерирует runner.py --make-fixture [ист.: README.md, шаг 2].

  • D-C8. Что считать «приёмкой подписанного защищённого восстановления». (а) Только операторская цепочка source58 до READY (CLI). (б) Цепочка плюс запуск самого восстановления из Edge через UI/MCP с подписанным служебным журналом (signedProtectedJournal:true). Рекомендация: (б). Пункт стоит в разделе EXTERNAL-UI, а открытым остался именно подписанный журнал браузерного восстановления (стр. 100 реестра доказательств). Браузер работает через SSH-проброс к собственному стеку C2, как в C1. Харнесс tmp/mcp-ui2-restore-mounted-20261115/run.mjs локальный (remoteExecuted:false), его нужно перенести на проброшенные порты.

  • D-C7. Кто выпускает операторские одобрения C2 и C4 (approved-request.json и его SHA-256, одобрения upgrade и rebind). Рекомендация: агент выпускает их тестовым ключом этого прогона, ключ создаётся и уничтожается внутри собственного каталога. В квитанции указывается, что независимость утверждающего не проверялась.

2.4. Решения владельца 2026-11-20

  • D-C1 (б), решено 17.11: C1 перепривязывается к образам текущей сборки — 29998815 (Gitea 2745, 57 миграций, на VPS уже есть backend f928fda3… и frontend 921ba5e2…, frontend собран с origin портала http://127.0.0.1:55175).
  • Portal для C1: скачать на VPS Portal CI2586 auth-portal-portal-mcp-acceptance@sha256:376adc62…. Индекс OCI разрешается в реестре, ответ 200. Причина: у Portal mmapp-test (auth-portal@sha256:2bdf4240…) нет веб-хука отзыва MCP (MCP_REVOCATIONS_*), а сценарий C1 проверяет подписанный отзыв.
  • D-C8 (б): приёмка C2 — операторская цепочка source58 до READY плюс само восстановление из Edge через UI/MCP с подписанным служебным журналом (signedProtectedJournal). C2 и C4 требуют нового Linux-пакета (оценка 1–2 дня).
  • D-C2 (остановка mmapp-test на окна C), D-C3 (а), D-C6, D-C7 — решения оркестратора по цели от 17.11 (раздел решений в mcp-completion-plan.md).

2.5. C1 пройден (2026-11-20)

  • Пакет tmp/mcp-c1-owned-portal-browser-29998815-20261120/. Копия CI2736 перепривязана bind.py: backend f928fda3…, frontend 921ba5e2… (Gitea 2745), Portal CI2586 376adc62…, PostgreSQL 77f58511…, 57 миграций, дерево 99edfb40…. Перед запуском browser.mjs статически сверен с исходниками 29998815: все надписи UI, пути REST, инструменты MCP (mm_logs_settings_update_plan, mm_change_apply) и заголовки операций на месте.
  • Дефекты пакета, найденные на первом запуске (CI2736 ни разу не запускался, runtimeRun:false):
    • сервисы стоят только во внутренней сети owned (internal: true), а Docker не публикует порты таких контейнеров. Проверено пробой на VPS: опубликованный порт даёт 000, IP контейнера — 200; проба удалена. Раннер теперь проверяет готовность по внутренним адресам frontend/backend/Portal и печатает их в browser-ready, SSH-пробросы 127.0.0.1:5517x идут на эти адреса. Изоляция сети не ослаблена, origin браузера прежние;
    • раннер терял журналы при down --volumes. Теперь до очистки он пишет ci2736-evidence-<nonce>.json: состояние и последние 200 строк журнала каждого сервиса, хвост отбрасывается при совпадении с секретом фикстуры;
    • локальный запуск из Git Bash превращал /root/… в путь Windows, нужен MSYS_NO_PATHCONV=1.
  • Окно (c1-window.py; mmapp-test остановлен по D-C2 и поднят сразу после, тот же .env fa29fdbb…, backend healthy):
    • раннер: 4 сервиса из закреплённых образов, migration_count 57, browser-ready;
    • Edge: check-releases → portal-login → actual-owner-plan-approval → selected-operation-deep-link → actual-portal-patch-and-delivery → complete;
    • раннер: browserPassed=true, ownedRuntimeRemoved=true, priorRunningContainersUnchanged=true.
  • Квитанция браузера browser-result.json sha256 d3a1e862… (совпадает с записанной раннером): actualPortalBrowserLogin, managerUiIssuedApprovalToken, managerUiApprovedExactPlan, managerUiDisplayedVerifiedOperation, ownerApprovedAndSdkAppliedExactlyOnce, exactOperationRefusedWithoutDetails, portalSingleSigninAndNoStaleStep, realSignedOwnerCutoffAudited, establishedSdkOperationRefused — все true.
  • Доказательства раннера сохранены локально в runner-evidence.json, секретов в них нет. Фикстура удалена на обоих концах, пакет на VPS удалён. Образ Portal CI2586 оставлен на VPS для C2.

2.6. C2/C4: разбор перед пакетом (2026-11-20)

  • Регрессия Windows-сценария на HEAD не проходит. Копия tmp/mcp-writer-restore58-head-29998815-20261120/, режим --owned-restore58-ready. Сценарий подменяет издателю ./operator-files.mjs замороженной фикстурой от 12.11 (local-tls-journal.mjs). В продукте этот модуль с тех пор экспортирует ещё readProtected и protectedDirectory, поэтому импорт падает до восстановления. Это дрейф сценария, не продукта. Прежняя квитанция Windows и так была с fixtureJournal, fixtureSourceAttestor, platformFilesVerified=false, readyAuthorized=false, а Linux-приёмка должна получить эти признаки без подмен.
  • Точки входа в образе 29998815 (проверено ls/grep только для чтения в контейнере backend; от root там ничего не выполнялось):
Шаг процедуры Команда в образе
Ключи установки (init) backend/dist-operator/database-writer-bootstrap-operator.mjs init
Подготовка схемы ролью владельца node backend/dist/scripts/prepare-database.js
Реестр профиля, защита отметок миграций database-writer-profile-operator.mjs registry-enroll, marker-fence-enroll (+ registry-inspect)
Активация источника … source-activate / source-status / source-revoke
Первая голова Source57, допуск Source57 … publish, … source57-admission-enroll
Основа Source58, карантин … source58-foundation-enroll, … restore-profile-enroll, … upgrade (57→58)
Хеш схемы и данных node backend/dist/scripts/inspect-database-schema.js [--data]
Допуск восстановления node backend/dist/scripts/stage-database-restore-checkpoint.js, serve-restore-checkpoint-claims.js
Восстановление работающий backend (UI/MCP по D-C8 (б))
Проверка и завершение inspect-database-restore-checkpoint.js, … source-catalogue-inspect, … upgrade (rebind58), seal-database-restore-checkpoint.js, complete-database-restore.js
Сверка после сбоя … maintenance-inspect / maintenance-resolve
  • Вывод. У каждого шага есть штатная точка входа в образе. Поэтому вместо переноса 965-строчного сценария (D-C3 (а), моё решение 17.11) пакет C2/C4 будет вести собственные команды образа от UID 65534 против собственного контейнера PostgreSQL 18 с TLS (D-C3 (б)). Без tsx, исходников и Linux-сборки embedded-postgres, без подмены operator-files.mjs, и это реальный путь установки. Создание пяти ролей с OID — SQL суперпользователя собственной БД по документации. Для браузерной части D-C8 (б) нужен работающий backend, он есть в том же стеке.
  • Условия пакета:
    • отрицательные случаи C4 проверяют конкретную причину отказа и ноль подключений к БД (log_connections=on до и после каждого случая), всё от не-root UID;
    • пробросы идут на внутренние адреса;
    • доказательства сохраняются до очистки;
    • один стек на nonce, повтор — новый nonce;
    • восстановление в mmapp-test-postgres запрещено проверкой;
    • mmapp-test останавливается только на окно.
  • Оценка: сборка и офлайн-проверка пакета C2/C4 ~1 рабочий день, стендовое окно 1–2 ч.

2.7. C2/C4: диагностические прогоны пакета (2026-11-20/21)

Пакет tmp/mcp-c2c4-restore58-29998815-20261120/ (runner.py, driver.mjs, product-child.mjs, browser-c2.mjs) — образы 29998815: backend f928fda3…, frontend 921ba5e2…, PostgreSQL 77f58511…. Все шаги от UID 65534. Стенды 7777aaaa8888bbbb, f0fe2966cebfac2e, 0c2da6a462b71eb1 удалены по nonce. Доказательства лежат в /var/tmp/restore58-* на VPS. mmapp-test не останавливался. Это диагностика, не приёмка: приёмочный прогон ждёт решений владельца по двум находкам ниже.

Схема стенда.

  • PostgreSQL слушает только localhost, во внутренней сети у него псевдоним backend.
  • Backend работает в сетевом пространстве PostgreSQL (--network container:), потому что runtime подключается к tls.serverName = localhost. Корневая ФС backend только для чтения.
  • Frontend стоит во внутренней сети. В образе зашит BACKEND_INTERNAL_URL=http://backend:8000.
  • Операторская служба допусков работает в отдельном контейнере без сети. Каталог контрольной точки для backend только для чтения, сокет 0660.
  • Portal не нужен: вход по HS256 JWT, как в UI2. AUTH_PORTAL_URL равен origin менеджера.

Что проверено на Linux с реальным POSIX:

  • Подготовка источника: init → source-activate → foundation → admission → партиции → Source57 (эпохи 1–2) → restore-profile-enroll → upgrade 57→58 (эпоха 3). Оба source-preflight вернули platformProtectionVerified: true, права ключей 0700/0600.
  • Архив и B1: inspect-database-schema.js --data даёт одинаковые хеши до и после архива. Защищённый backend B1 стартует со сверкой схемы. stage переводит точку в pending, служба допусков работает.
  • Восстановление: одно восстановление прошло через REST POST /api/system/database/restore работающего B1, это вынужденная замена MCP, см. находку 2. Результат: dataVerified, карантин сохранён, точка consumed с claimId, signedProtectedJournal: true.
  • Проверка после восстановления: inspect-database-restore-checkpoint вернул applied-consumed. operationId совпадает с выданным stage, хеш журнала одинаков по трём источникам.
  • Отказы:
    • seal до rebind: «Публикация контрольной точки PostgreSQL не подтверждена…»;
    • новый backend при consumed: «Контрольная точка восстановления PostgreSQL не подтверждена»;
    • новый backend после seal: «Состояние базы после восстановления не подтверждено».
  • Завершение: source-catalogue-inspect показал, что каталог после восстановления изменился. Rebind58 подписан эпохой 4, seal записал голову эпохи 4, complete снял карантин.
  • Две реплики backend: обе отдают восстановленное значение. Подключение MCP, созданное после архива, исчезло. Защищённая запись PUT /api/logs/settings видна во второй реплике.
  • C4: пять отрицательных случаев на копиях входов: 0640, 0604, каталог чужого UID, символьная ссылка, init в существующий каталог. Каждый отклонён до подключения к БД: по журналу PostgreSQL 0 подключений. Причины:
    • 0640 и 0604: проверка файла (UID и биты group/other);
    • чужой UID: проверка владельца каталога;
    • ссылка: realpath(file) === file;
    • init: отказ, ключи не изменились.

Находка 1 (блокирует приёмку). JIT PostgreSQL против фиксированных 5 с захвата каталога.

  • Что происходит: на PostgreSQL 18 с настройками по умолчанию оценка стоимости секции unsupported (migration-schema-inventory.ts) выросла до 970 тыс. после создания партиций (292 дочерних, 11 тыс. строк pg_depend). Это выше порогов JIT. По EXPLAIN ANALYZE 5,4 с из 5,6 с уходит на компиляцию 540 функций, само выполнение занимает 0,3 с.
  • Последствия: withRuntimeCatalogSnapshot (database-runtime-schema.ts:31) ставит лимит 5s. Поэтому защищённые архив и сверка данных отказывают с DATABASE_RESTORE_DATA_REFUSED / DATABASE_RUNTIME_SCHEMA_REFUSED.
  • Проверка: при jit=off та же секция занимает 223 мс, остальные секции не меняются. Прежняя находка «ANALYZE перед foundation» — та же причина: статистика только сдвигала оценку относительно порога. С jit=off подготовка без ANALYZE проходит.
  • Масштаб: измерено на этом VPS, на граничном значении 5,0–5,4 с. Другое железо и mmapp-test не проверялись.
  • Конфигурация развёртывания: в deploy/ JIT не настроен, mmapp-test работает на postgres:18-alpine с настройками по умолчанию.
  • Как стенд продолжил работу: на диагностических стендах JIT выключен через ALTER SYSTEM SET jit = off. Строки каталога это не меняет, catalog58 после этого сверен.

Находка 2 (блокирует D-C8 (б)). MCP-восстановление в защищённом режиме на свежем журнале всегда блокируется.

  • Механизм: executeRestore (modules/mcp/database-restore.ts) до восстановления записывает в restore-vault квитанцию running. Затем restoreSystemDatabaseBackup → withDatabaseOperation при включённом карантине вызывает assertDatabaseRestoreJournalCurrent. Отметка в хранилище без журнала даёт JOURNAL_ABSENT_WITH_ATTEMPT_MARKERS, и квитанция становится blocked / RESTORE_UNCONFIRMED. Данные не затронуты, точка остаётся pending.
  • Почему не всплывало раньше: у новой установки журнала нет, так что первое MCP-восстановление под карантином невозможно. UI2 проходил без карантина, эталонный сценарий вызывал восстановление напрямую, а MCP-тест карантин не покрывает.
  • Побочный эффект: после такого отказа в хранилище остаётся отметка 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 при отказе печатает необработанный стек вместо одного сообщения.
  • После REST-восстановления под карантином событие system.database.restore не записывается (eventError).
  • Блокировка конфигурации неблокирующая. Сразу после старта реплик PUT может получить 409 «Глобальная конфигурация изменяется другой операцией», пока работает сборщик планировщика: здесь прошло со второй попытки. Эталонный сценарий работал без планировщика.

3. Порядок шагов

Фаза 0 стенд не затрагивает. Для каждого стендового шага указаны режим (READ-ONLY или MUTATING) и откат. Пути ниже относительно tmp/, если не сказано иное.

Что переиспользуется

Артефакт Как есть? Что адаптировать
mcp-current-preview-local-review-20261111/ci2736-owned-portal-browser/ (runner.py, browser.mjs, compose.json, tls-forwarder.mjs, bind.py) + архив .zip При D-C1 = (а) да, если образы в кэше. Транспорт уже на SSH-сессии оператора, пароля в раннере нет При (б): новый binding.json (дайджесты CI2738 и Portal, migrationCount=57), пересчёт assets и offline-verification.json, повторная офлайн-проверка. Локально Node v22.23.4
verified-ci2736-manager-portal-pair/ (OCI-квитанции, preview-ci-status.json) Только как доказательство происхождения CI2736 При (б) аналогичная сверка OCI для CI2738 (запуск 2738 уже успешен, ист.: план A, D6)
mcp-writer-restore58-owned/run-owned.mts (--owned-restore58-ready) и mcp-writer-current57-local-tls/run-owned.mts (--owned-linux-cli) Нет База для пакета C2/C4 (D-C3 (а)): убрать синтетический attestor, заменить EmbeddedPostgres на собственный PG-контейнер с TLS, скомпилировать, упаковать
mcp-linux-maintenance-v2-20261103/ (Linux-прогон maintenance-inspect/resolve, 16 сценариев, nativePosixProtection:true) Нет (44 миграции) Образец Linux-пакета с реальной POSIX-защитой, loopback и TLS [ист.: docs/mcp-linux-maintenance-resolution-acceptance-20261103.json]
Пакеты POLL (cold_docker.py, durable.py) Нет Образец запуска собственного Node в образе backend установки от 65534:65534 с собственным PG-контейнером и меткой nonce
backend/scripts/legacy-probe-*-owned.mjs, source5{7,8}-*-owned.mjs Нет: тестовые раннеры на fixture Только для D-C4 (в) или как образец драйвера для (б)

Фаза 0. Локальная адаптация (без стенда, до сессии)

Шаг Действие Закрывает
0.1 Получить решения D-C1…D-C8. При D-C8 (б) перенести tmp/mcp-ui2-restore-mounted-20261115/{run.mjs,browser.mjs} на проброшенные порты собственного стека C2 с заданными хешами архива и данных —
0.2 C1: при D-C1 = (б) перепривязать пакет (bind.py) к CI2738 и Portal, прогнать офлайн-проверку (runner.py --check локально не исполняет Docker). Проверить node --version = v22.23.4 и наличие Edge и зависимостей browser.mjs CB1, CB2
0.3 C2/C4: Linux-пакет по D-C3 (а). Владелец процесса — UID 65534. Создаются каталоги 0700 и файлы 0600, затем проверяются отрицательные случаи (0640, 0604, чужой UID, символьная ссылка, существующий каталог init) и отказ до подключения к БД. Собственный контейнер PG 18 с TLS (самоподписанный серверный сертификат без права CA, по mcp-database-maintenance.md), пять ролей. Два процесса backend для старта после complete CB4, CB6
0.4 C2/C4: дополнительные проверки DB-4 в пакете: архив с объектами mmapp_control отвергается; повторный старт после ошибки посреди восстановления не запускает потребителей (планировщик, NetFlow, MCP) до complete; ключи и журнал из архива не возвращают прежний доступ. Офлайн-тесты пакета и печать хешей DB-4
0.5 Локальный прогон пакета C2/C4 в Linux-контейнере невозможен (на Windows нет контейнерного runtime [ист.: mcp-handoff-20261115.md]). Поэтому до стенда проверить только --owned-restore58-ready на Windows на HEAD (регрессия) и офлайн-тесты пакета —
0.6 DB-3: только по решению D-C4. При (б) — продуктовая работа отдельным слоем с тестами на fixture N=12, после неё отдельный пакет приёмки CB5

Фаза 1. Предпусковая проверка и базовый снимок (≈20 мин)

Шаг Режим Команда или действие Откат
1.1 READ-ONLY Отпечаток ключа хоста VPS, как в плане B 1.1 —
1.2 READ-ONLY `free -m; df -h /; cat /proc/vmstat grep -E 'pswp
1.3 READ-ONLY docker image inspect <ref@digest> для каждого из четырёх образов C1 (по D-C1); docker image inspect образа mmapp-test-postgres (PG_MAJOR); docker exec mmapp-test-backend id (фактический UID); ss -ltn на 55173–55175 свободны —
1.4 MUTATING (только если 1.3 нашёл отсутствие образов и D-C1 = (а)) docker pull по дайджесту из git.shx.one (нужен вход в реестр на VPS, отдельное разрешение: скачивание около 0,5–1 ГБ). Срок хранения образов в реестре не проверялся docker image rm <digest> после прогона, если владелец не решит оставить
1.5 MUTATING (по D-C2) cd /opt/mmapp-test && docker compose stop. Перед этим записать docker compose ps и .env SHA-256 (без вывода значений) docker compose up -d, проверка четырёх сервисов healthy

Фаза 2. C1: сквозной прогон на образах (≈30–45 мин; жёсткий предел раннера 360 с на браузерную часть [ист.: runner.py:23])

Шаг Режим Команда Откат
2.1 MUTATING (VPS: новый приватный каталог загрузки) Загрузить пакет (scp) и сверить хеш архива на обоих концах, извлечь только перечисленные файлы. python runner.py --check на VPS (Docker не вызывается) Удалить каталог загрузки
2.2 локально python runner.py --make-fixture <новый приватный файл>. Передать его на VPS, chmod 0600. Локальную копию хранить до конца браузерной части Удалить оба файла после 2.5
2.3 MUTATING (VPS: проект mm-mcp-owned-<id>, четыре контейнера, тома, сеть, порты 127.0.0.1:55173–55175) В SSH-сессии с тремя пробросами (-L 55173:127.0.0.1:55173 и т. д., StrictHostKeyChecking=yes, ExitOnForwardFailure=yes): python runner.py --run <fixture>. Раннер генерирует собственный CA на сутки, сверяет imageIds с запущенными контейнерами и проверяет migration_count. Затем печатает browser-ready Раннер сам очищает проект и тома при таймауте или сигнале TERM/HUP. При отказе очистки остаётся точный путь для ограниченного восстановления
2.4 локально (браузер) node browser.mjs <локальная fixture> <новый browser-result.json> —
2.5 MUTATING (VPS: удаление собственного проекта) Атомарно загрузить browser-result.json (и квитанцию отказа, если есть) в каталог выполнения. Раннер проверяет поля, удаляет проект и тома, сверяет ID и время старта ранее работавших контейнеров Повторная проверка 5.2
2.6 локально Закрыть пробросы, удалить загруженный пакет и fixture на VPS после проверки владельца, удалить локальную fixture. Сохранить неконфиденциальные квитанции —

Фаза 3. C2 + C4: подписанное защищённое восстановление и POSIX (≈60–90 мин [вывод])

Шаг Режим Команда Откат
3.1 MUTATING (VPS: каталог /var/lib/mm-restore58-<nonce> с владельцем 65534, права 0700) Загрузка пакета 0.3 и сверка хешей Удаление каталога по nonce
3.2 MUTATING (VPS: собственный контейнер PG 18 с TLS во внутренней сети, том) Старт PG. Пять ролей, bootstrap init от UID 65534 (создаёт signing-private.pem, operator-public.pem, bootstrap.json с правами 0600). В вывод попадает только публичный отпечаток Удаление контейнера и тома по метке nonce
3.3 MUTATING Отрицательные POSIX-проверки C4: каждая запускается на отдельной копии входа и отказывает до подключения к БД (счётчик соединений 0, как в build-database-operator.test.mjs) —
3.4 MUTATING Цепочка C2 по mcp-database-maintenance.md, шаги 1–4: archive + data SHA-256 → stage-restore-checkpoint → serve-restore-claims → одно восстановление (по D-C8 (б) — из Edge через проброс: загрузка PGDMP, план, одно apply; затем проверка signedProtectedJournal) → inspect-restore-checkpoint (applied-consumed) → source-catalogue-inspect → upgrade (rebind) → seal → complete → два процесса backend → PUT /api/logs/settings. Отрицательные: новый процесс при consumed, seal до rebind, старт до complete, подменённый архив, архив с mmapp_control Неопределённый ответ на любом шаге: только inspect-restore-checkpoint и maintenance-inspect, без повтора действия [ист.: mcp-database-maintenance.md, «Не повторяйте прежнее действие автоматически»]
3.5 MUTATING (VPS: удаление собственных ресурсов) Остановить процессы, удалить контейнеры, тома, сеть, каталог nonce. Ключ теста уничтожается вместе с каталогом Сверка 5.2

Фаза 4. C3: DB-3 (только по решению D-C4)

Вариант Шаги
(а) ограничение Без стенда. Запись в mcp-completion-plan.md этапа 4 и в манифест этапа 5
(б) доработка 4.1 READ-ONLY: pg_restore --list дампа на VPS (без вывода данных), сверка числа маркеров schema_migrations = 12 в восстановленной копии. 4.2 MUTATING: собственный PG 18 во внутренней сети, pg_restore дампа в него (D-C5). 4.3 MUTATING: новая операторская команда из 0.6 → цепочка legacy-export … legacy-handoff-release → контролируемый хвост → legacy-control-reference → legacy-source58-preflight. 4.4 MUTATING: отказ при подмене архива и при конкурирующем писателе. 4.5 MUTATING: удаление копии, тома и каталога. Backend на копии не запускать (CB7)
(в) fixture на Linux Как (б), но источником служит applyLegacyProbeFixtureMigrations в собственном PG. В квитанции явно realLegacyArtifact=false

Фаза 5. Завершающая сверка (≈15 мин)

Шаг Режим Действие
5.1 MUTATING (только если делали 1.5) cd /opt/mmapp-test && docker compose up -d, ожидание healthy
5.2 READ-ONLY Повтор 1.2: четыре контейнера mmapp-test работают на тех же образах. Если делали 1.5, pid новые, это ожидаемо и записывается. Собственных проектов, томов, сетей и каталогов нет. Свободное место и память вернулись к базовым
5.3 READ-ONLY docker image ls — образы, загруженные в 1.4, удалены или оставлены по решению владельца

4. Базовый снимок до прогона и сверка после

  1. Что снимается. Четыре контейнера mmapp-test (id, image, pid, StartedAt), docker volume ls, docker network ls, docker image ls --digests, free -m, df -h, /proc/vmstat (swap, OOM), SHA-256 файла /opt/mmapp-test/.env (без вывода), список /var/lib/mm-*.
  2. Когда. В шаге 1.2 до первой MUTATING-операции. Повторно в 5.2.
  3. Критерий. Нет собственных ресурсов, mmapp-test работает на тех же образах и с тем же .env. Если mmapp-test останавливали (D-C2), отличаются только pid и StartedAt. Раннер C1 сам проверяет ID и время старта ранее работавших контейнеров (runner.py, стр. 90–93), поэтому остановка по D-C2 делается до снятия его эталона, то есть до 2.3.
  4. CHR. Не затрагиваются; базовый снимок CHR не снимается. Копия дампа (только D-C4 (б)) работает во внутренней сети без маршрута к CHR.

5. Риски, условия остановки и откат

Остановить прогон немедленно, если:

  • Идёт прогон B или фаза 5 прогона A (общий VPS; B закрепляет pid mmapp-test).
  • MemAvailable < 500 МиБ или OOM у любого контейнера [вывод].
  • Ответ на любой шаг восстановления потерян. Дальше только инспекция, без повтора.
  • Любой контейнер mmapp-test изменился без шага 1.5.
  • Ключ хоста VPS не совпал.

Откат: собственные проекты и тома удаляются по меткам и nonce. Если mmapp-test останавливали, он поднимается через docker compose up -d. Прод-база mmapp-test-postgres в прогоне C не изменяется ни на одном шаге: восстановление в неё запрещено. Дамп /root/backups/…dump используется только на чтение.

Прочие риски [вывод]:

  • Образы CI2736 могли не сохраниться в реестре Gitea, тогда D-C1 (а) невыполним.
  • Браузер работает с Windows через три SSH-проброса. Обрыв сети оставляет раннер до таймаута 360 с; раннер очищает сам.
  • --owned-linux-cli и пакет C2/C4 ни разу не запускались на Linux. Первая сессия, вероятно, выявит дефекты пакета. По цели владельца это разбирается и повторяется с новым nonce.
  • Backend штатно работает от root. Проверка POSIX от UID 65534 доказывает поведение кода, но не текущую конфигурацию установки. Нужно ли менять user: в compose, решает отдельный пункт (раздел 7).

6. Оценка длительности [вывод]

  • Фаза 0: 1–2 рабочих дня (пакет C2/C4 — критический путь). DB-3 (б) — отдельная продуктовая работа, ещё 2–4 дня.
  • Стендовая сессия: фаза 1 ~20 мин, C1 30–45 мин, C2 + C4 60–90 мин, фаза 5 ~15 мин. Итого 2–3 ч без DB-3. С DB-3 (б) — ещё 1–1,5 ч, можно отдельной сессией.
  • Запас на одну остановку и повтор: +1–2 ч.

7. Что этим планом не проверяется

  • RAM-1: вся установка ≤2 ГиБ (отложено владельцем). Если mmapp-test останавливается на время окна, совместная нагрузка не измеряется.
  • Настоящий внешний Portal владельца и реальные учётные записи: используются синтетические @example.test и собственный Portal.
  • Изменение конфигурации действующей установки mmapp-test на подписанный профиль (source57/58, пять ролей, TLS). Установка остаётся на legacy-пути с пустой mmapp_control (CB5(5)). Это вопрос включения (этап 5, инструкция), а не прогона C.
  • Работа backend установки от непривилегированного пользователя: в продукте сейчас root.
  • Устойчивость файлов к сбою питания (fsync проверяется, отключение питания нет [ист.: mcp-db-offline-bootstrap.md]).
  • UI-1 в полном объёме: выдача ограниченного доступа, отказы, фильтры, пагинация. Сценарий C1 покрывает один поток подтверждения и отзыв.
  • Причины прежних отказов CI2678 v5 (real-logs-flow-sse, 429 на flow): сценарий C1 потоки логов и flow не открывает.