Archive legacy status docs and canonicalize genesis entrypoints

docs/PROJECT_OPTIMIZATION_STATUS.md

@@ -1,7 +1,7 @@
 # Project Optimization Status
 
-**Last Updated**: 2025-11-18  
-**Status**: In Progress
+**Last Updated**: 2026-04-13  
+**Status**: Active
 
 ## Summary
 
@@ -12,8 +12,15 @@ This document tracks the ongoing optimization and cleanup of the smom-dbis-138 p
 ### ✅ Documentation Cleanup
 - **Archived 30+ status reports** from `terraform/phases/phase1/` to `docs/archive/status-reports/phase1/`
 - **Removed 4 genesis.json backup files** (moved to archive)
-- **Updated README.md**: All IBFT 2.0 references changed to QBFT
+- **Updated active entry points**: High-traffic README and operator docs now point at QBFT/current workflows
 - **Created archive structure** with proper organization
+- **Archived legacy status-report piles** from the active docs surface:
+  - `docs/operations/status-reports/` → `docs/archive/status-reports/operations-legacy/`
+  - report-style files from `docs/` → `docs/archive/status-reports/docs-root-legacy/`
+  - report-style files from the repository root → `docs/archive/status-reports/repo-root-legacy/`
+- **Repointed active indexes and runbooks** to current docs or archive collections
+- **Archived trustless bridge milestone stack** from `docs/bridge/trustless/` into `docs/archive/bridge-trustless-milestones/`
+- **Added active trustless bridge overview** at `docs/bridge/trustless/README.md`
 
 ### ✅ Configuration Consolidation
 - **Archived old IBFT2 config structure**: `config/validators/`, `config/sentries/`, `config/rpc/` → `docs/archive/old-configs/ibft2/`
@@ -29,6 +36,12 @@ This document tracks the ongoing optimization and cleanup of the smom-dbis-138 p
 - **Legacy**: `docker/besu-*/docker-compose.yml` (per-node-type, may still be used for reference)
 - **Phase2**: `docker/phase2/docker-compose.*.yml` (regional deployments)
 
+### ✅ Canonical Operator Paths
+- **Genesis generation**: `scripts/generate-genesis-proper.sh`
+- **Genesis validation**: `scripts/validation/validate-genesis.sh`
+- **Compatibility wrapper**: `scripts/generate-genesis.sh` now forwards to the canonical QBFT generator
+- **Docker Compose**: `docker-compose/docker-compose.template.yml` is the active template; older per-node compose files remain reference material
+
 ## Current Project Structure
 
 ### Active Configuration Files
@@ -56,13 +69,19 @@ docker-compose/
     └── vm5.env                     # VM5 configuration
 ```
 
-## Recent Cleanup Actions (2025-11-18)
+## Recent Cleanup Actions (2026-04-12)
+
+### Documentation Surface Cleanup
+- **Status Reports Archived**:
+  - `94` historical files moved to `docs/archive/status-reports/operations-legacy/`
+  - `33` report-style docs moved to `docs/archive/status-reports/docs-root-legacy/`
+  - `13` report-style root docs moved to `docs/archive/status-reports/repo-root-legacy/`
+- **Active status navigation slimmed down**: `docs/operations/status-reports/` now routes through `STATUS_REPORTS_INDEX.md`
+- **Deduplication Report**: Archived at `docs/archive/status-reports/docs-root-legacy/CLEANUP_DEDUPLICATION_REPORT.md`
 
 ### Script Deduplication
-- **Status Reports Archived**: 52 files total (22 new + 30 previous) moved to `docs/archive/status-reports/`
 - **Duplicate CCIP Scripts**: Archived 3 duplicate CCIP scripts from `terraform/phases/phase1/scripts/ccip/` to `scripts/archive/duplicate-ccip/`
 - **Unified WETH Script**: Created `scripts/deployment/deploy-weth-unified.sh` to consolidate WETH deployment methods
-- **Deduplication Report**: Created `docs/CLEANUP_DEDUPLICATION_REPORT.md` documenting cleanup efforts
 
 ### Script Analysis
 - **Total Shell Scripts**: 260
@@ -75,35 +94,37 @@ docker-compose/
 
 ### 🔄 In Progress
 - [ ] Continue script deduplication (82 deployment scripts to review)
-- [ ] Update remaining IBFT references in documentation (10+ files)
-- [ ] Create consolidated documentation index
+- [ ] Review remaining milestone-style docs that should be archived or explicitly marked historical
+- [ ] Keep archive indexes and active links aligned as legacy docs move
 
 ### ⏳ Pending
-- [ ] Document docker-compose file usage and migration path
 - [ ] Consolidate duplicate genesis generation scripts
 - [ ] Review and optimize script organization
+- [ ] Prune or archive remaining completion-style bridge and deployment reports outside `docs/archive/`
 
 ## Files Requiring IBFT → QBFT Updates
 
 The following files still contain IBFT references:
-- `scripts/configure-network-decision-tree.md`
-- `runbooks/parameter-change.md`
+- `docs/azure/QUOTA_ISSUE_RESOLUTION.md`
+- `docs/configuration/CONFIGURATION_FIXES_APPLIED.md`
+- `docs/governance/CHANGELOG.md`
 - `terraform/phases/phase1/CONTAINERS_AND_SERVICES_REPORT.md`
 - `terraform/phases/phase1/HIGH_PRIORITY_TASKS_COMPLETE.md`
-- `docs/guides/INTEGRATION_GUIDE.md`
-- `docs/operations/status-reports/*.md` (multiple files)
+- Historical files under `docs/archive/status-reports/` may still contain legacy IBFT-era wording and should stay archived unless refreshed
 
 ## Archive Location
 
 All archived files are in `docs/archive/`:
 - `status-reports/phase1/` - Historical status reports
+- `status-reports/operations-legacy/` - Historical files formerly in `docs/operations/status-reports/`
+- `status-reports/docs-root-legacy/` - Historical report-style docs formerly in `docs/`
+- `status-reports/repo-root-legacy/` - Historical report-style docs formerly in the repository root
 - `old-configs/ibft2/` - Previous IBFT2 configuration structure
 - `old-scripts/deprecated/` - Obsolete scripts (to be populated)
 
 ## Next Steps
 
 1. Complete script review and deduplication
-2. Update remaining IBFT references
-3. Create master documentation index
-4. Document migration paths for old configurations
-
+2. Finish the last active terminology cleanups and historical-status banners
+3. Keep archive routing and active index links synchronized
+4. Consolidate transitional genesis helpers around the canonical QBFT path