diff --git a/docs/00-meta/OPERATOR_HANDOFF_2026-04-13_CLEANUP_AND_PLATFORM_SUMMARY.md b/docs/00-meta/OPERATOR_HANDOFF_2026-04-13_CLEANUP_AND_PLATFORM_SUMMARY.md new file mode 100644 index 00000000..f3e293b9 --- /dev/null +++ b/docs/00-meta/OPERATOR_HANDOFF_2026-04-13_CLEANUP_AND_PLATFORM_SUMMARY.md @@ -0,0 +1,114 @@ +# Operator Handoff — 2026-04-13 Cleanup And Platform Summary + +**Purpose:** Short release-note style handoff for the preservation, cleanup, and rollout work completed in the Proxmox workspace through `main` head `968d738`. + +## Scope + +This handoff captures the intentionally preserved work across: + +- MEV Control / `mev.defi-oracle.io` +- Sankofa consolidated hub and Phoenix API edge +- Besu validator operator helpers +- Solace portal container scaffold +- `smom-dbis-138` documentation and genesis-entrypoint cleanup + +## Current Repo State + +- Root workspace: clean +- `origin/main`: up to date at the time of handoff +- Tracked submodules now preserved at: + - `dbis_core` → `c80b2a5` + - `explorer-monorepo` → `02996c6` + - `smom-dbis-138` → `79750d9` + +## Key Preserved Parent Commits + +- `e86744e` `Track MEV multi-chain rollout validation and cutover` +- `13c85f5` `Ignore generated infra status snapshots` +- `04ca354` `Refresh tracked IT inventory snapshots` +- `fe7292d` `Track cleaned submodule updates` +- `49740f1` `Harden quote-push operator workflows` +- `b7eebb8` `Add Sankofa consolidated hub operator tooling` +- `ee1625a` `Add surgical Besu validator operator helpers` +- `d8b0dd0` `Add Solace portal container scaffold and entity tracker` +- `2cf2ef4` `Expand operator env examples and quote-push benchmarking` +- `6405006` `Record latest public E2E verification evidence` +- `968d738` `Track smom documentation and genesis cleanup` + +## MEV Control + +- Public GUI/API deployment, backend CT topology, readiness tooling, and rollout validation were preserved in the earlier MEV commit chain. +- The dedicated backend remains documented as CT `2421` on `192.168.11.223`, with public edge CT `2410` serving the GUI and `/api` proxy. +- Multi-chain and venue-foundation work, DODO PMM/D3MM scaffolding, lifecycle telemetry, and validation helpers are captured through the parent MEV commit and the `MEV_Bot/mev-platform` submodule pointer. + +Primary docs: + +- [MEV_CONTROL_DEFI_ORACLE_IO_DEPLOYMENT.md](../04-configuration/MEV_CONTROL_DEFI_ORACLE_IO_DEPLOYMENT.md) +- [MEV_CONTROL_LAN_BRINGUP_CHECKLIST.md](../04-configuration/MEV_CONTROL_LAN_BRINGUP_CHECKLIST.md) +- [MEV_CONTROL_COMPLETION_PUNCHLIST.md](../04-configuration/MEV_CONTROL_COMPLETION_PUNCHLIST.md) +- [MEV_EXECUTION_VALUE_SOURCES_AND_READINESS.md](../04-configuration/MEV_EXECUTION_VALUE_SOURCES_AND_READINESS.md) + +## Sankofa / Phoenix + +- Consolidated hub tooling, nginx examples, NPM fleet support, and Phoenix websocket/API operator helpers were preserved in `b7eebb8`. +- The active public Phoenix path assumes the hub nginx layer at `:8080` with Apollo bound to loopback `127.0.0.1:4000`. +- `get_host_for_vmid` now explicitly maps Sankofa VMIDs `7800–7806` to `r630-01`. + +Primary docs: + +- [SANKOFA_PHOENIX_CONSOLIDATED_FRONTEND_AND_API.md](../02-architecture/SANKOFA_PHOENIX_CONSOLIDATED_FRONTEND_AND_API.md) +- [SANKOFA_API_HUB_NPM_CUTOVER_AND_POST_CUTOVER_RUNBOOK.md](../03-deployment/SANKOFA_API_HUB_NPM_CUTOVER_AND_POST_CUTOVER_RUNBOOK.md) + +## Besu Operator Helpers + +- Validator restart, migration, cgroup rollback, and host CPU-load helpers were preserved in `ee1625a`. +- The staggered-restart maintenance path now follows real live placement instead of stale assumptions. + +Primary scripts: + +- `scripts/operator/restart-besu-validator-single.sh` +- `scripts/operator/migrate-besu-validator-r630-01-to-r630-04.sh` +- `scripts/operator/revert-besu-cgroup-caps-r630-01.sh` +- `scripts/verify/report-besu-host-cpu-load.sh` + +## Solace Portal + +- A minimal static nginx container scaffold for `solace-bank-group-portal/` was added and validated with a local Docker build. +- The entity completion tracker was added so Aseret, TAJ, and Solace surfaces have a single active checklist. + +Primary docs: + +- [ENTITY_INSTITUTIONS_WEB_PORTAL_COMPLETION.md](../03-deployment/ENTITY_INSTITUTIONS_WEB_PORTAL_COMPLETION.md) +- [solace-bank-group-portal/README.md](../../solace-bank-group-portal/README.md) + +## `smom-dbis-138` + +- The broad remaining dirty tree was intentionally preserved as a coherent archive-and-canonicalization pass in submodule commit `79750d9`. +- Legacy status-report piles were moved under `docs/archive/status-reports/`. +- Legacy trustless-bridge milestone docs were moved under `docs/archive/bridge-trustless-milestones/`. +- Active entrypoints were repointed toward current docs. +- Genesis generation entrypoints were simplified so transitional wrappers now forward to the canonical QBFT generator. + +Primary references: + +- [smom-dbis-138/README.md](../../smom-dbis-138/README.md) +- [smom-dbis-138/docs/archive/status-reports/README.md](../../smom-dbis-138/docs/archive/status-reports/README.md) +- [smom-dbis-138/docs/bridge/trustless/README.md](../../smom-dbis-138/docs/bridge/trustless/README.md) + +## Verification Record + +- The latest public routing/TLS verification snapshot is now committed at: + - [verification_report.md](../04-configuration/verification-evidence/e2e-verification-20260413_213757/verification_report.md) +- Active index references were updated in: + - [ALL_VMIDS_ENDPOINTS.md](../04-configuration/ALL_VMIDS_ENDPOINTS.md) + - [E2E_ENDPOINTS_LIST.md](../04-configuration/E2E_ENDPOINTS_LIST.md) + +## Recommended Next Moves + +1. Use this handoff plus [docs/MASTER_INDEX.md](../MASTER_INDEX.md) as the primary orientation point for the next operator. +2. If publishing externally, summarize the preserved commit chain rather than the pre-cleanup dirty history. +3. For future cleanup passes, prefer the same method used here: + - isolate the smallest coherent bucket + - validate locally + - commit intentionally + - avoid sweeping mixed submodule trees blindly diff --git a/docs/MASTER_INDEX.md b/docs/MASTER_INDEX.md index 6c4bb90a..7843d3c3 100644 --- a/docs/MASTER_INDEX.md +++ b/docs/MASTER_INDEX.md @@ -18,6 +18,7 @@ | **Git submodule hygiene + explorer remotes** | [00-meta/SUBMODULE_HYGIENE.md](00-meta/SUBMODULE_HYGIENE.md) — detached HEAD, push order, Gitea/GitHub, `submodules-clean.sh` | | **MEV intel + public GUI (`mev.defi-oracle.io`)** | Framing: [../MEV_Bot/docs/framing/README.md](../MEV_Bot/docs/framing/README.md); deploy: [04-configuration/MEV_CONTROL_DEFI_ORACLE_IO_DEPLOYMENT.md](04-configuration/MEV_CONTROL_DEFI_ORACLE_IO_DEPLOYMENT.md); LAN bring-up: [04-configuration/MEV_CONTROL_LAN_BRINGUP_CHECKLIST.md](04-configuration/MEV_CONTROL_LAN_BRINGUP_CHECKLIST.md) (dedicated backend CT on `r630-04`); completion list: [04-configuration/MEV_CONTROL_COMPLETION_PUNCHLIST.md](04-configuration/MEV_CONTROL_COMPLETION_PUNCHLIST.md); execution values/readiness: [04-configuration/MEV_EXECUTION_VALUE_SOURCES_AND_READINESS.md](04-configuration/MEV_EXECUTION_VALUE_SOURCES_AND_READINESS.md); specs: [../MEV_Bot/specs/README.md](../MEV_Bot/specs/README.md) | | **What to do next** | [00-meta/NEXT_STEPS_INDEX.md](00-meta/NEXT_STEPS_INDEX.md) — ordered actions, by audience, execution plan | +| **Recent cleanup / handoff summary** | [00-meta/OPERATOR_HANDOFF_2026-04-13_CLEANUP_AND_PLATFORM_SUMMARY.md](00-meta/OPERATOR_HANDOFF_2026-04-13_CLEANUP_AND_PLATFORM_SUMMARY.md) | | **Live verification evidence (dated)** | [00-meta/LIVE_VERIFICATION_LOG_2026-03-30.md](00-meta/LIVE_VERIFICATION_LOG_2026-03-30.md) | | **Your personal checklist** | [00-meta/NEXT_STEPS_FOR_YOU.md](00-meta/NEXT_STEPS_FOR_YOU.md) | | **Operator runbook (LAN/creds)** | [00-meta/NEXT_STEPS_OPERATOR.md](00-meta/NEXT_STEPS_OPERATOR.md) |