chore(docs): планы стендовых прогонов B и C

This commit is contained in:
Denozordec committed 2026-11-17 01:03:26 +07:00
1 parent 3d9d406192
commit 5e0bfd1fe4
2 files changed
+336

No files matched your search

+164
View File
@@ -0,0 +1,164 @@
# Прогон B этапа 3: план стендовой приёмки POLL на целевом Linux
Составлен 17 ноября 2026 года только чтением репозитория и `tmp/`. VPS, CHR и Gitea не затрагивались: SSH, Docker, REST и скрипты, включая режимы `check-only`, не запускались. Пункты плана взяты из [плана завершения](mcp-completion-plan.md), раздел «Этап 3», абзац «Прогон B». Форма документа повторяет [план прогона A](mcp-stand-run-a-plan.md).
Обозначения: **[ист.: файл]** означает, что факт прочитан в указанном файле; **[вывод]** означает вывод автора плана, на стенде он не проверен. Пароли, ключи и токены в документе отсутствуют намеренно.
**Главный вывод.** Прогон B в текущем виде запустить нельзя: готовых пакетов «как есть» нет. Все Linux-пакеты POLL закреплены одновременно тремя независимыми привязками. **Источник:** сборка CI2683 или CI2687 с 56 миграциями; сборка CI2683 на Linux остановилась на источнике 22. **Транспорт:** скрытый ввод пароля root, `look_for_keys=False` и закреплённый ключ хоста. **Базовый снимок VPS:** четыре контейнера `mmapp-test` по `id`, `imageId` и `pid`, который устарел после замены образов 16 ноября. Нужна локальная фаза адаптации (фаза 0) и решения владельца (раздел 2.3). Второе ограничение — время: 252 минуты являются нижней границей, реальная оценка составляет 12–30 часов [вывод, раздел 6]. Весь этот срок `mmapp-test` нельзя останавливать или перезапускать, поэтому прогон B исключает фазу 5 прогона A (ROUTING на VPS) и прогон C.
## 1. Цель и критерий «принято» по пунктам
Цель: на целевом Linux VPS `mm-vps` (Debian 13, 2 ГиБ) на сборке текущего HEAD закрыть два пункта POLL. Каждый пункт пишет отдельную квитанцию. Исходы `failed` и `unknown` не перекрашиваются **[ист.: mcp-completion-plan.md, этап 3]**. CHR в прогоне B не участвуют: оба профиля работают с синтетическим RouterOS (HTTP-стаб на loopback внутри собственного контейнера) **[ист.: tmp/mcp-poll-capacity336-full-ci2683-20261112/REVIEW.md: «1,348 synthetic RouterOS GETs»; fixture.ts]**.
Привязка пунктов. «POLL: deadline целевого Linux» — это строка «Target Linux cold deadline» реестра и ключ `targetLinuxColdPollAccepted=false` (холодный cold143) **[ист.: mcp-evidence-statistics-20261101.md, раздел POLL; mcp-current-progress.json]**. Фраза плана завершения «это один и тот же прогон» читается так: одна сессия на одной сборке и одном базовом снимке, B1 короткой фазой перед B2 [вывод]. Квитанции у B1 и B2 разные.
Срок 180 с задаёт сам продукт: окно каждого этапа (`current`, `execute`, `verify`) равно `min(expiresAt, now + 180000)` **[ист.: backend/src/modules/mcp/server-poll-actions.ts:83, 189–219; server-poll-http.sql-helper.ts:284]**. Если срок превышен, операция не получает `applied`. Поле `runtime.elapsedMs` (158–165 с) — это время всего публичного прогона, а `memory.elapsedMs` (176–179 с) включает ещё миграции и старт приложения. Сроком продукта оно не ограничено [вывод из `server-poll-memory.owned.test.ts:66–96`]. Какое из окон ближе всего к пределу, по квитанциям установить нельзя [вывод].
| # | Пункт | «Принято» означает | Квитанции |
| --- | --- | --- | --- |
| B1 | POLL: deadline целевого Linux (cold143) | Холодный опрос `servers.poll` (143 действия обслуживания, 22 публикации, 54 строки журнала, 4 GET, списание 151) завершается терминальной квитанцией `applied` в пределах исходного запечатанного срока 180 с на VPS, на сборке HEAD с 57 миграциями, с лимитами Node 192/16 МиБ (heap) и отдельными cgroup. Исходные четыре сервиса и базовый снимок не изменились, собственные ресурсы удалены. Входит ли в пункт ресурсный критерий (нулевой прирост swap хоста), решает владелец (D-B3) | `terminal.json` нового каталога cold143: `runtime.elapsedMs`, `runtime.maintenanceEffects=143`, `completedPublications=22`, `ownedResourcesRemoved`, `baselineUnchanged`, `accepted`. Образец формы: **[ист.: tmp/mcp-poll-linux-cold143-ci2683-swap-observation-20261112/terminal.json]** |
| B2 | POLL: 336 операций с естественным истечением на Linux | В профиле `capacity336` получено ровно 337 завершённых операций, 336 естественно сжатых и аутентифицированных архивов одного владельца и 1348 синтетических GET. Последняя (337-я) операция принята после истечения допусков с проверкой квоты и сохранения учёта архивов. Каждый архив прошёл исходный запечатанный срок и 60-секундный защитный интервал. Наблюдаемое завершение уложилось в жёсткий предел 72 ч от `startedAt`. Очистка подтверждена, базовый снимок не изменился | `<nonce>-status.json` (`status=terminal`, `phase=accepted`, `capacity336ActualAccepted=true`), `<nonce>-terminal.json`, `<nonce>-closed.json`, `<nonce>-retired.json`, `worker-observation.json` по схеме. Проверки счётчиков `(336,337,336,1348)`, 72 ч и 337 уникальных источников: **[ист.: tmp/mcp-poll-linux-capacity336-full-port-20261113/verify.py, стр. 28–76]** |
Нижняя граница длительности B2: 8 слотов полной записи владельца, каждая держит слот минимум 5 минут действия плана и минуту защитного интервала. Это 42 группы, то есть не меньше 252 минут даже при мгновенной публикации. Штатный воркер публикует не чаще одного раза за 30-секундный проход **[ист.: mcp-implementation-plan.md, «13 ноября — POLL336 после исправления воркера»; mcp-evidence-statistics-20261101.md, раздел POLL]**.
Что уже доказано и не повторяется: локальный SQL-тест 336 архивов на одноразовой PostgreSQL (`--poll-operation-retirement`, 45,5 с) **[ист.: mcp-server-poll-call-audit-20261114.md]**; Linux smoke из двух операций с естественным истечением и Linux-сценарий потери ACK двух COMMIT от 14 ноября **[ист.: mcp-evidence-statistics-20261101.md, POLL]**. Причина исторического `unknown` CI2713 остаётся неустановленной, прогон B её не перекрашивает **[ист.: mcp-completion-plan.md, стр. 48]**.
## 2. Предусловия и решения владельца
### 2.1. Факты о стенде на 17 ноября
- VPS `mm-vps` (тот же адрес, что `161.104.46.222` в прежних пакетах, [вывод по mcp-stand-run-a-plan.md, D5]): Debian 13, ядро 6.12, ОЗУ 2 ГиБ (доступно около 1,1 ГиБ), swap 4 ГиБ, диск 25 ГБ (свободно около 11 ГБ после очистки 16 ноября), Docker 29.8.2. Доступ по ключу через алиас `mm-vps` под `root` **[ист.: постановка задачи; mcp-stand-run-a-plan.md, 2.1 и D7]**.
- Установка `/opt/mmapp-test`, проект compose `mmapp-test`, четыре контейнера: `-backend`, `-frontend`, `-portal`, `-postgres`. Backend и frontend заменены на `mmapp-test/backend:mcp-5ec95a7c` и `mmapp-test/frontend:mcp-5ec95a7c`, база обновлена с 12 до 57 миграций по прежнему (legacy) пути **[ист.: mcp-completion-plan.md, журнал 2026-11-16; постановка задачи]**.
- Образ PostgreSQL установки по умолчанию `postgres:18-alpine` **[ист.: deploy/docker-compose.test.yml, стр. 5]**. Фактический тег на VPS не проверялся. Пакеты POLL требуют `PG_MAJOR=18` в образе **[ист.: durable.py, стр. 446–450; cold_docker.py, стр. 129]**.
- Пакеты POLL не скачивают образы. Они запускают собственный Node-контейнер из **образа backend установки** (`services['backend']['imageId']`) от пользователя `65534:65534`, а собственный PostgreSQL из **образа postgres установки** **[ист.: cold_docker.py, стр. 126–158; durable.py, стр. 446–467]**. После 16 ноября это образ `mcp-5ec95a7c` с Node 22 (`node:22-bookworm-slim` **[ист.: backend/Dockerfile]**).
### 2.2. Блокеры, найденные в файлах
| # | Блокер | Где видно |
| --- | --- | --- |
| BB1 | **Источник устарел.** Полный пакет capacity336 собран из CI2683 (56 миграций, профиль 13). На Linux он остановился на источнике 22: 28 операций, 21 архив **[ист.: mcp-implementation-plan.md, «13 ноября», последний абзац]**. Пакет diagnostic90-v3 — эксперимент на той же замороженной упавшей сборке. По его собственному обзору, приёмка текущего источника требует новых пинов, пересборки и нового ревью наложений | `tmp/mcp-poll-linux-capacity336-ci2683-20261112/REVIEW.md`; `tmp/mcp-poll-linux-capacity336-worker-observation-review/LOCAL-REVIEW.md`, раздел Verification |
| BB2 | **Цепочка заморозки требует предварительного smoke на той же сборке.** `prepare.mjs` сверяет исходники с source gate принятого локального smoke естественного истечения, `prior-smoke.mjs` проверяет его три квитанции. Для HEAD такого smoke нет | `tmp/mcp-poll-capacity336-full-ci2683-20261112/REVIEW.md` |
| BB3 | **Транспорт на пароле.** Все `transport.py` вызывают `getpass('Pinned VPS SSH password: ')`, требуют `isatty`, `look_for_keys=False`, `allow_agent=False`, `RejectPolicy` и `tmp/test-server-known-hosts` с `HOSTKEY_SHA`. Сейчас вход по ключу (`mm-vps`), пароль root в плане не используется [вывод] | `mcp-poll-current-linux-smoke-20261114/transport.py`, стр. 21–26, 362–375; `…diagnostic90-v3-review/transport.py`, стр. 339–352 |
| BB4 | **Базовый снимок устарел.** `read-readiness.py` и `durable.py` требуют ровно четыре контейнера с прежними `Id`, `Image`, `Pid`, `RestartPolicy` и тем же `daemonId`. Эталон закреплён `BASELINE_SHA` от 5 ноября. После замены образов 16 ноября эти значения другие [вывод] | `mcp-poll-capacity336-vps-systemd-readiness-20261105/read-readiness.py`, стр. 7–8, 49–58 |
| BB5 | **Пины и одноразовый допуск.** `ARCHIVE_SHA`, `STAGE_SHA`, `MANIFEST`, `OWNER_SHA`, `SOURCE_GATE` прошиты в коде. Запуск требует внешний файл `--approval` с новым nonce. Любая правка BB1–BB4 меняет хеши | `transport.py`, стр. 21–28; `durable.py`, стр. 30; `support.py` (`--nonce`, `--baseline`, `--baseline-sha256`) |
| BB6 | **Ресурсный критерий cold143.** Оба последних Linux-прогона cold143 функционально прошли за 165,3 и 158,0 с, то есть в пределах 180 с. Оба получили `accepted:false`, `failure: RuntimeError`, потому что во время замера на хосте был swap (`pswpinDelta 98–125`, `pswpoutDelta 1025`). OOM не было, swap собственных cgroup равен нулю. 30 октября на другой сборке было 180,766 с и отказ по сроку | `mcp-poll-linux-cold143-ci2683-20261112/terminal.json`; `…-swap-observation-20261112/terminal.json` (`summary.acceptancePassed=false`); mcp-implementation-plan.md, стр. 222, 777 |
| BB7 | **Пересечение с прогоном A по построению.** Базовый снимок B закрепляет `pid` контейнеров `mmapp-test` на всё окно, а фаза 5 прогона A (ROUTING V64) останавливает `mmapp-test` и запускает его снова (D5). Перезапуск ломает сверку B: `originals()` вернёт `False` [вывод из кода `read-readiness.py`, стр. 49–58]. Это **противоречит** формулировкам плана завершения «A независим от B и C» и «B в фоне». Фоновым B может быть только относительно фаз прогона A, которые идут с Windows напрямую на CHR | mcp-stand-run-a-plan.md, D5 и D7; mcp-completion-plan.md, стр. 63, 67 |
| BB8 | **Время.** Прежний полный прогон v5 (Windows) за 4 ч 8 мин (04:16:54–08:24:49) дал 106 операций и 99 архивов, то есть около 24 архивов в час [ист.: mcp-current-progress.json, `capacity336Profile`]. Для 336 архивов это около 14 ч [вывод]. Cold143 на Linux идёт примерно в 6 раз медленнее, чем на Windows (158 с против 27,8 с) [ист.: mcp-implementation-plan.md, стр. 218, 222], поэтому окно на Linux может быть ещё длиннее [вывод] | — |
### 2.3. Решения владельца (чек-лист)
- [ ] **D-B1. Какая сборка.** (а) Пересобрать пакеты из HEAD `5ec95a7c` (57 миграций) по образцу цепочки CI2683: smoke естественного истечения, заморозка, Linux-пакет. (б) Повторить замороженный CI2683 как есть. **Рекомендация: (а).** Вариант (б) проверяет устаревший код, который уже упал на источнике 22, и не закрывает пункт для текущего кода. Исправления воркера от 13 ноября (пропуск занятых строк, до 1000 планов за проход) должны быть в HEAD; это проверяется в шаге 0.1.
- [ ] **D-B2. Транспорт.** (а) Заменить в `transport.py` вход по паролю на ключ: `paramiko` с явным файлом ключа из `~/.ssh/config` для `mm-vps`, `RejectPolicy` и `known_hosts` с отпечатком текущего ключа хоста. (б) Оставить пароль root со скрытым вводом. **Рекомендация: (а),** так же, как D4 в прогоне A. Отпечаток ключа хоста снимается заново в шаге 1.1 и сверяется с `HOSTKEY_SHA`. Если он отличается, `tmp/test-server-known-hosts` не переписывается, создаётся новый файл.
- [ ] **D-B3. Критерий «deadline Linux».** (а) Пункт B1 — это срок и функциональность: `applied` в пределах 180 с плюс очистка. Замеры swap хоста сохраняются в квитанции, но относятся к RAM-1, который отложен владельцем **[ист.: mcp-completion-plan.md, этап 4]**. (б) Пункт B1 требует ещё и нулевого прироста swap хоста. **Рекомендация: (а).** При (б) пункт фактически зависит от отложенного RAM-1, а два предыдущих прогона упали именно на этом критерии. Решение меняет критерий приёмки, поэтому оно за владельцем. При (а) в верификаторе cold143 нужно развести `deadlineAccepted` и `resourceAccepted`: сейчас итог один, `accepted` (шаг 0.5).
- [ ] **D-B4. Совмещение с прогонами A и C.** **Рекомендация:** B2 запускать только в окне, где нет фазы 5 прогона A и нет прогона C. Фазы 2–3 прогона A (Windows → CHR напрямую) VPS не трогают и могут идти параллельно с B. Если фаза 5 прогона A ещё впереди, B2 запускать после неё. B1 короткий (≈15 мин), его можно выполнить сразу после фазы 1. Решение уточняет открытый D7 прогона A.
- [ ] **D-B5. Кто выдаёт одноразовый допуск (`--approval`, nonce).** **Рекомендация:** агент по цели владельца от 2026-11-17, по аналогии с D8 прогона A. В квитанции это указывается нейтрально, как условие прогона.
- [ ] **D-B6. Что делать при отказе B2 до 336.** **Рекомендация:** без автоматического повтора. Сохранить квитанции, выполнить штатный `recover` и `retire`, разобрать `worker-observation.json` (наблюдатель уже встроен в пакет diagnostic90-v3). Исправление делается в новом слое кода, затем новая сборка и новый nonce. Это соответствует цели владельца «запуск, диагностика, очистка, исправление в новом слое, повтор».
## 3. Порядок шагов
Фаза 0 стенд не затрагивает. Для каждого стендового шага указаны режим (**READ-ONLY** или **MUTATING**) и откат. Пути ниже относительно `tmp/`, если не сказано иное.
### Что переиспользуется
| Артефакт | Как есть? | Что адаптировать |
| --- | --- | --- |
| `mcp-poll-capacity336-full-ci2683-20261112/` (`prepare.mjs`, `prior-smoke.mjs`, `fixture.ts`, `control.ts`, `verify-full.mjs`, `run-owned.mjs`) | Нет, привязан к CI2683 и 56 миграциям | Новый source gate из HEAD, новый smoke, новая заморозка. Логику fixture (336/337/1348, 72 ч, 8 слотов) не менять |
| `mcp-poll-capacity336-natural-smoke-ci2683-20261112/` | Нет | Образец для нового smoke HEAD на Windows (шаг 0.3) |
| `mcp-poll-linux-capacity336-ci2683-20261112/` (`build.mjs`, `seal.py`, `stage.py`, `durable.py`, `cold_docker.py`, `verify.py`, 24 офлайн-теста) | Нет: `SOURCE_GATE`, `ARCHIVE_SHA` | Пересобрать пакет из HEAD, перевыпустить пины, прогнать те же 24 теста |
| `mcp-poll-linux-capacity336-diagnostic90-v3-review/` (`worker_observation_schema.py`, наблюдатель, `support.py`: pre-admission, monitor, retire) | Логику — да, байты — нет | Перенести наблюдатель воркера и `support.py` в новый пакет: квитанция ≤64 КиБ без секретов **[ист.: full-port-20261113/WORKER-OBSERVATION-REVIEW.md]** |
| `mcp-poll-capacity336-vps-systemd-readiness-20261105/read-readiness.py` | Нет: `BASELINE_SHA`, `HOSTKEY_SHA`, пароль | Новый базовый снимок (шаг 1.3), вход по ключу |
| `mcp-poll-current-linux-smoke-20261114/` (`read-baseline.py`, `seal-current.py`, `transport.py`, `watch-and-retire.py`) | Нет: пароль, `ARCHIVE_SHA` | Образец цепочки «снимок → печать → запуск → наблюдение → снятие» |
| `mcp-poll-linux-cold143-ci2683-20261112/` (`build-exact.py`, `prepare-linux-payload.py`, `run-operator.py`, `read-baseline.py`) | Нет: CI2683, пароль | Пересобрать cold143 из HEAD для B1; развести критерии срока и ресурсов (D-B3) |
| `mcp-current-preview-local-review-20261111/run-ci2713-poll-linux.py`, `ci2713-poll-linux-v2/` | Нет | Это публичный MCP-путь CI2713 (план → одобрение → apply → чтение), а не cold143. Для B1 не нужен; пригоден как третий, необязательный замер публичного пути (раздел 7). Привязан к паролю (`getpass`, стр. 169–187) |
### Фаза 0. Локальная адаптация (без стенда, до сессии)
| Шаг | Действие | Закрывает |
| --- | --- | --- |
| 0.1 | Получить решения D-B1…D-B6. Проверить, что в HEAD есть исправления воркера и компактора, которые в CI2687 были наложены локально: пропуск занятых строк, продолжение просмотра по сроку допуска и ID, восстановление при занятых строках. Сверить `server-poll-terminal-compaction.test.ts` и тесты воркера; это 12 тестов компактора **[ист.: mcp-server-poll-call-audit-20261114.md]** | BB1 |
| 0.2 | `npm --prefix backend run build`, затем `node backend/scripts/test-mcp-postgres.mjs --poll-operation-retirement` и `--server-poll-durable --restore` на HEAD (локальная одноразовая PostgreSQL) | — |
| 0.3 | Локальный smoke естественного истечения на HEAD по образцу `mcp-poll-capacity336-natural-smoke-ci2683-20261112`: одна операция, архив после 5 мин срока и 60 с интервала, затем новая операция. Записать source gate и три терминальные квитанции. Около 10 минут [вывод] | BB2 |
| 0.4 | Новая полная заморозка capacity336 на HEAD (`prepare.mjs` → `prior-smoke.mjs` → preflight, 17 офлайн-тестов верификатора), затем Linux-пакет (`build.mjs` → `seal.py` → `stage.py` проверяет все файлы архива). Перенести наблюдатель воркера и `support.py` из diagnostic90-v3. Прогнать 24 офлайн-теста владельца и стадии и 5 тестов пакета наблюдения. **Зависимости Linux:** пакет CI2683 берёт их «from the pinned hardened archive» с тем же `package-lock` **[ист.: mcp-poll-linux-capacity336-ci2683-20261112/REVIEW.md]**. Сверить `package-lock.json` HEAD с этим пином. Если lock изменился, нужен новый архив Linux-зависимостей. Локального контейнерного runtime нет, поэтому источником может быть производственный `node_modules` образа `mmapp-test/backend:mcp-5ec95a7c` (собран Gitea из того же lock) [вывод]. Без этого фаза 0 заблокирована | BB1, BB5 |
| 0.5 | Пакет cold143 на HEAD (`build-exact.py`, `prepare-linux-payload.py`). При D-B3 = (а) разделить в удалённом раннере и верификаторе cold143 (итог `accepted` формируется там, ср. `cold_docker.py:197–198` и `mcp-cold143-v6-terminal-review-20261105/verify-terminal.py`) итог на `deadlineAccepted` (срок, функциональность, очистка) и `resourceAccepted` (swap и память хоста). Значение `accepted` оставить строгим, чтобы не перекрашивать прежнюю семантику. Добавить офлайн-тест на сохранённой `swap-observation/terminal.json`: `deadlineAccepted=true`, `resourceAccepted=false` | BB6 |
| 0.6 | Транспорт по D-B2 во всех `transport.py` и `read-readiness.py`: вход по ключу, `RejectPolicy`, новый файл `known_hosts`. Перевыпустить пины и `OWNER_SHA`. Отказ при несовпадении ключа хоста сохранить | BB3, BB5 |
| 0.7 | Обновить `read-readiness.py` и общий снимок под текущие четыре контейнера: поле `BASELINE_SHA` указывает на новый файл из шага 1.3, его хеш записывается при снятии | BB4 |
| 0.8 | `python -B stage.py private-staged.tgz` и `transport.py check-only` локально (компиляция удалённых программ без выполнения). Записать новые хеши в README нового каталога `tmp/mcp-poll-linux-head-5ec95a7c-<дата>/` | — |
### Фаза 1. Предпусковая проверка и базовый снимок (≈20 мин)
| Шаг | Режим | Команда или действие | Откат |
| --- | --- | --- | --- |
| 1.1 | READ-ONLY | `ssh mm-vps 'ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub'` и сравнение с отпечатком из `known_hosts` на Windows. При расхождении с `HOSTKEY_SHA` прежних пакетов зафиксировать это и продолжать только с новым файлом (D-B2) | — |
| 1.2 | READ-ONLY | `free -m; df -h / /var/lib /tmp; swapon --show; cat /proc/vmstat | grep -E 'pswp|oom_kill'; docker info --format '{{.CgroupVersion}} {{.MemoryLimit}} {{.SwapLimit}}'; docker ps -a --format …; systemctl --version`. **Стоп**, если `MemAvailable` < 704 МиБ (порог `MEMORY` в `transport.py`) или свободно на диске < 2 ГиБ после стадии (`DISK`). Также стоп, если cgroup не v2 или нет memory/swap limit (требование `durable.py`, стр. 443) | — |
| 1.3 | READ-ONLY | `docker image inspect` образов `mmapp-test-backend` и `mmapp-test-postgres`: `Os/Architecture = linux/amd64`, `PG_MAJOR=18`, нет `Volumes` у backend. Новый базовый снимок через адаптированный `read-baseline.py`: `daemonId`, 4 × (`id`, `imageId`, `pid`, `restartPolicy`). Записать SHA-256 снимка | — |
| 1.4 | READ-ONLY | `ls /var/lib/ | grep mm-` и `systemctl list-units 'mm-*'`: собственных каталогов и transient unit прежних прогонов нет. Если найдены (`/var/lib/mm-poll-capacity336/<nonce>`, `/var/lib/mm-cold143-*`), сначала штатный `retire` по их квитанциям, не `rm -rf` | — |
| 1.5 | READ-ONLY | Убедиться у координатора, что фаза 5 прогона A не идёт и не начнётся в окне B (D-B4), а прогон C не запущен | — |
### Фаза 2. B1: deadline cold143 (≈15 мин)
| Шаг | Режим | Команда | Откат |
| --- | --- | --- | --- |
| 2.1 | MUTATING (VPS: загрузка пакета в `/var/lib/mm-cold143-<nonce>`, два собственных контейнера `mm-cold-node-*` и `mm-cold-pg-*`, том PGDATA) | `python run-operator.py --check-only`, затем режим исполнения нового пакета cold143. У прежнего пакета это `--execute-exact-linux-cold143-v6` с TTY и паролем **[ист.: run-operator.py:96–102]**; имя режима и аргументы нового пакета задаются в шаге 0.5 [вывод]. Пакет сам проверяет базовый снимок до и после, ограничивает ресурсы (1 CPU на контейнер, Node 192/16 МиБ) и удаляет свои ресурсы | Встроенная очистка (`ownedResourcesRemoved`, `baselineUnchanged`). Если очистка не подтверждена, удалить **только** контейнеры и тома с метками этого nonce после `docker inspect` меток |
| 2.2 | offline | Разбор `terminal.json`: `elapsedMs < 180000`, 143/22/54/4/151, `deadlineAccepted`, `resourceAccepted`, swap хоста. Квитанция B1 | — |
| 2.3 | READ-ONLY | Повтор 1.2–1.3: базовый снимок совпал, собственных ресурсов нет | — |
Если `elapsedMs ≥ 180000` или терминальной квитанции нет, B1 = `failed` или `unknown`. Повтор допускается только с новым nonce после разбора; прежний исход сохраняется.
### Фаза 3. B2: capacity336 (≥252 мин, оценка 12–30 ч [вывод])
| Шаг | Режим | Команда | Откат |
| --- | --- | --- | --- |
| 3.1 | READ-ONLY | `support.py pre-admission --nonce <новый> --baseline <абс. путь> --baseline-sha256 <…>`: исходные сервисы, пороги ресурсов, отсутствие общей резервации POLL336 и активного или стартующего transient unit **[ист.: full-port-20261113/SUPPORT-REVIEW.md]** | — |
| 3.2 | MUTATING (VPS: `/tmp/mm-capacity-smoke-<nonce>` → `/var/lib/mm-poll-capacity336/<nonce>`, transient unit systemd, контейнеры app и pg с лимитами 320 и 192 МиБ, резервация) | `transport.py launch --nonce … --approval <файл D-B5> --baseline … --baseline-sha256 …`. Unit запускается через `systemd-run`, `ExecStopPost` вызывает закреплённый `recover` | `recover` под блокировкой сверяет принадлежность контейнеров и очищает только ресурсы этого nonce |
| 3.3 | READ-ONLY, периодически | `transport.py observe --nonce …` или `support.py monitor`: только счётчики heartbeat (операции, архивы, GET, ошибки воркера) и `free -m`. Интервал опроса не чаще раза в 10–15 минут [вывод], чтобы не нагружать VPS | — |
| 3.4 | READ-ONLY | После `terminal`: локально сохранить исходные байты квитанций и `worker-observation.json` по контрольным суммам terminal. `verify.py`: 336/337/336/1348, 72 ч, 337 уникальных источников, учёт квот | — |
| 3.5 | MUTATING (удаление одного каталога package этого nonce) | `support.py retire --nonce …`: сверка привязки запуска, исходных сервисов, отсутствия unit, контейнеров и путей выполнения, контрольных сумм файлов пакета. Квитанции и записи запуска остаются | При неопределённом ответе повтор блокируется локальной записью, дальше только чтение |
**После перезагрузки VPS посреди B2.** Сначала независимо прочитать `boot_id`, привязку запуска, статус unit и контейнеров. Затем ручной `recover` с теми же хешами владельца, манифеста и Docker-помощника и тем же nonce, только при подтверждённом отсутствии живого прежнего владельца **[ист.: SUPPORT-REVIEW.md, «Восстановление после сбоя»]**. Исход B2 в этом случае `failed` или `unknown`, не `accepted`.
### Фаза 4. Завершающая сверка (≈10 мин)
| Шаг | Режим | Действие |
| --- | --- | --- |
| 4.1 | READ-ONLY | Повтор 1.2–1.4: четыре контейнера `mmapp-test` с теми же `id` и `pid`, нет `mm-*` каталогов и unit, свободное место и память вернулись к базовым ±5 % [вывод] |
| 4.2 | offline | Записать итог в `mcp-completion-plan.md` (журнал) и `mcp-current-progress.json` (новые ключи, прежние `capacity336Profile` и `targetLinuxColdPollAccepted` не переписывать задним числом) |
## 4. Базовый снимок до прогона и сверка после
1. **Что снимается.** `daemonId` Docker, идентичность `dockerd` (PID, время старта, inode сокета), четыре контейнера `mmapp-test` (`id`, `imageId`, `pid`, `restartPolicy`), `MemAvailable`, `/proc/vmstat` (`pswpin`, `pswpout`, `oom_kill`), свободное место и inode в `/var/lib`, `/tmp` и корне Docker, `boot_id`.
2. **Когда.** После решений D-B1…D-B6 и фазы 0, непосредственно перед 2.1, и повторно перед 3.1, если между ними было что-то ещё.
3. **Чем.** Адаптированным `read-baseline.py` и `read-readiness.py` (шаги 0.6–0.7). SHA-256 снимка передаётся в каждый MUTATING-шаг.
4. **Критерий.** После прогона четыре контейнера с теми же `id` и `pid`, `daemonId` и идентичность `dockerd` прежние, собственных контейнеров, томов, сетей, unit и каталогов нет. Пакеты проверяют это сами (`baselineUnchanged`, `retire`), шаг 4.1 повторяет проверку независимо.
5. **CHR.** Не снимаются: прогон B их не трогает. Пакеты обращаются только к синтетическому RouterOS на loopback [ист.: fixture.ts; REVIEW.md].
## 5. Риски, условия остановки и откат
**Остановить прогон немедленно, если:**
- Базовый снимок разошёлся (перезапуск `mmapp-test`, смена `dockerd`). Это означает пересечение с другим прогоном или вмешательство. Пакет сам перейдёт в `recover`.
- `MemAvailable` < 500 МиБ или зафиксирован OOM любого контейнера установки [вывод, тот же порог, что в плане A].
- Терминальная квитанция не получена в пределах 72 ч или ответ на запуск потерян. Дальше только `observe` и `recover`; повторный `launch` с тем же nonce запрещён.
- Ключ хоста VPS не совпал с проверенным в 1.1.
**Откат:** только штатными `recover` и `retire` по nonce. Удаления выполняются по меткам и путям, принадлежность проверена. `mmapp-test` не трогается.
**Прочие риски** [вывод]:
- Swap хоста. Cgroup пакетов запрещают swap собственным контейнерам, но хост 2 ГиБ уже свопит при работе установки. От D-B3 зависит, валит ли это B1.
- Деградация `mmapp-test` на 12–30 ч: общий CPU и диск. Тестовая установка при этом работает, Run A не может пользоваться VPS.
- Запас по сроку cold143 невелик: 158–165 с при пределе 180 с. HEAD содержит на одну миграцию больше и новые изменения.
- Исход до 336 (как на источнике 22) возможен и на HEAD. План это допускает (D-B6), но тогда B2 не закрывается в этот прогон.
## 6. Оценка длительности [вывод]
- Фаза 0: 0,5–1 рабочий день без стенда (smoke ~10 мин, сборка и офлайн-тесты пакетов, правка транспорта).
- Фаза 1: ~20 мин. Фаза 2 (B1): ~15 мин. Фаза 4: ~10 мин.
- Фаза 3 (B2): нижняя граница 252 мин. Ожидание 12–30 ч по темпу v5 (≈24 архива/ч на Windows) и замедлению Linux. Жёсткий предел 72 ч. Всё это время VPS занят прогоном B.
## 7. Что этим планом не проверяется
- Публичный MCP-путь CI2713 (`mm_server_poll_plan` → одобрение → `mm_change_apply` → `mm_operation_get`) на VPS. B1 проверяет cold143 через собранную fixture, а не через внешний SDK. Если владелец хочет закрыть и исторический `unknown` CI2713, нужен отдельный необязательный шаг с адаптированным `run-ci2713-poll-linux.py` (вход по ключу, сборка HEAD). Причина исторического `unknown` этим не устанавливается.
- RAM-1: вся установка ≤2 ГиБ под совместной нагрузкой (отложено владельцем).
- 14 суток календарного удержания (`fourteenDaysElapsedAccepted=false` остаётся).
- Конкурентные сборщики и бюджет задержки, оставшиеся crash/unknown переходы и границы политики удержания из списка POLL **[ист.: mcp-evidence-statistics-20261101.md, POLL]**. Прогон B закрывает только два пункта этапа 3.
- Реальный RouterOS: оба профиля используют синтетический стаб.
+172
View File
@@ -0,0 +1,172 @@
# Прогон C этапа 3: план стендовой приёмки внешнего интерфейса и БД на целевом Linux
Составлен 17 ноября 2026 года только чтением репозитория и `tmp/`. VPS, CHR и Gitea не затрагивались: SSH, Docker, REST и скрипты, включая режимы `--check`, не запускались. Пункты плана взяты из [плана завершения](mcp-completion-plan.md), раздел «Этап 3», абзац «Прогон C». Форма документа повторяет [план прогона A](mcp-stand-run-a-plan.md).
Обозначения: **[ист.: файл]** означает, что факт прочитан в указанном файле; **[вывод]** означает вывод автора плана, на стенде он не проверен. Пароли, ключи и токены в документе отсутствуют намеренно.
**Главный вывод.** Из четырёх пунктов прогона 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). **Рекомендация:** агент выпускает их тестовым ключом этого прогона, ключ создаётся и уничтожается внутри собственного каталога. В квитанции указывается, что независимость утверждающего не проверялась.
## 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|oom'; docker ps -a --format '{{.ID}} {{.Names}} {{.Image}} {{.Status}}'; docker inspect -f '{{.Id}} {{.State.Pid}} {{.State.StartedAt}}' mmapp-test-backend mmapp-test-frontend mmapp-test-portal mmapp-test-postgres`. Стоп, если идёт прогон B (есть `mm-poll-capacity336` unit или каталог) или фаза 5 прогона A | — |
| 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 не открывает.