Files
MikrotikManager/docs/mcp-vrf-production-executor-map-20261101.md
T

7.2 KiB
Raw Blame History

VRF production executor: implementation map

Полный final scope: human-approved CREATE / PATCH / DELETE VRF через существующий MCP runtime, с companion conservation и без заявления forwarding. Текущий product/package snapshot не меняется; кандидат и проверки размещаются в tmp/mcp-vrf-production-executor-20261101/.

Фактическая текущая граница

  1. actions.ts уже создаёт typed single-ROS VRF plans; productionAdmission:true добавляет private evidence flag. Existing interface/routing dependency snapshots и object protections сохраняются. Наличие флага само по себе execution не разрешает.
  2. runtime.ts:132 готовит настоящий ticket в той же plan transaction; security.ts:76 уже даёт durable purpose-separated key. Публично возвращаются ticketId/expiry, private sealed/raw payload не раскрывается.
  3. applyPlan устанавливает plan.state=executing, создаёт original-grant bound operation; executor работает с operation.state=running. Старые authoritativePlan/claim SQL принимают только draft/awaiting/approved — их нельзя просто расширить до произвольного executing plan без привязки к текущей операции и step intent.
  4. Generic execution использует createRosPrefix и verifyRosStepSnapshots; эти proofs не объясняют автоматические routes/table/virtual interface companions. Нельзя заменить их одним requested-primary-field match. Нужна отдельная VRF execution composition, сохраняющая остальные исходные dependency snapshots.
  5. classifyVrfProductionTransition действительно проверяет raw17+type-parent whole-catalog conservation, ACK identity/order и address/route effects. Но это pure postACK classifier, не executor. Его WeakMap checkpoint нельзя сериализовать/восстановить после restart. Enable-after-disable использует предыдущую active virtual/table provenance; member effect пока ограничен известным bridge shape. Это необходимо обработать явно, а не скрыть утверждением «classifier уже универсален».
  6. Ticket claim одноразовый, fresh connection; unknown commit уже имеет quarantine helper. Для нового executing-operation path надо проверить настоящий COMMIT acknowledgement и не допустить caller rollback/retry. Это продолжение существующего ticket/journal contract, не новый subsystem.

Последовательные закрываемые slices, без сокращения final CRUD

Slice Product patch area Конкретный результат и meaningful acceptance
S1 Новый services/vrf-production-execution.ts; existing admission/transition/read types Один executor для create/patch/delete: freeze request/binding; исходный fresh raw read; authentic claim; fresh authority/source и сохранение original dependencies; durable intent до command; одна native команда; exact ACK-owned full post-read classification. Known no-dispatch и sent-but-unconfirmed различаются; unknown не повторяется
S2 vrf-production-ticket-store.ts, modules/mcp/vrf-ticket-runtime.ts Private execution binding к exact running operation / original plan / connection / owner / typed step index. Старый read-only inspection contract остаётся closed. Find ticket по уникальному plan binding, не по caller-supplied reference; real encrypted envelope+HMAC и original expiry сохраняются. Genuine SQL: execution-state path, concurrent claim, wrong operation/owner/source/version, lost COMMIT и durable unknown latch
S3 vrf-production-transition.ts и ограниченное durable private checkpoint чтение/запись через существующий operation checkpoint Убрать reliance на процессный WeakMap между отдельными approved operations: проверяемая private provenance либо явная pre-dispatch unsupported shape. CREATE/PATCH/DELETE получают реальные companion checks; toggle/member-transfer/rename сохраняют unknown fields/order. Неподтверждённые interface/default shapes нельзя принимать только opt-in флагом
S4 actions.ts, runtime.ts, action evidence/types только при необходимости Guarded VRF branch использует S1/S2 вместо generic companion-blind verifier; остальные original dependency snapshots остаются перед intent и перед dispatch, после ACK проверяются без «adopt current». Legacy raw step/recovery не обходят новую ветку. Exact version fencing существующих планов сохраняется. Действующие guards для внешних static routes/protocol references не снимаются
S5 Новый bounded SQL/localhost RouterOS acceptance и нужные existing tests Настоящие migrations/SQL, encrypt/decrypt/HMAC, actual MCP token/auth/policy/human approval/runtime; HTTP stub моделирует реальные v5 raw companion effects, verifier не подменяется. Positive create→rename/update→delete и nonempty member cycle; faults: ignored/collateral write, wrong/reused ACK ID, post-intent source/dependency/grant drift, lost ACK, expired/claimed ticket, SQL journal failure. Read-back каждого успешного этапа и terminal cleanup. No CHR/remote

До S5 нельзя выдавать полный feature за accepted по одному unit executor. До отдельного разрешённого CHR report нельзя заявлять actual RouterOS interoperability либо forwarding. Если known native shape нельзя безопасно вывести из existing proofs, это фиксируется как конкретная оставшаяся capability, а не обходится weakening verifier. Весь CREATE/PATCH/DELETE final scope сохраняется в работе.

Staging/validation boundary

Только собственные tmp-копии/patch/tests/reports. Product source/package не apply во время root frozen1881 regression. Реальная SQL/localhost проверка — отдельный owned cluster и compiled overlay после review runner, без чтения настоящих .env, без production services. Package registration позже выполняет root. Не создаются новые permissions, endpoints, migration schema или autonomous recovery privilege: используются существующие human approval, original grant, mutation lock, operation intent/checkpoint и scoped source proof.